Darwin

Approve, reject, or request changes to the exact persisted review payload. The revision and SHA-256 digest prevent stale or altered approvals.

Get the truthful current state, required next step, supported operations, and any secure connection or payment interaction for one action.

List the caller’s current nonterminal Darwin actions with bounded pagination.

Find executable public Darwin capabilities. Provide a natural-language query, an aiId to browse one AI, or a capabilityId for an exact lookup. Ranked results return the exact capabilityId and capabilityRevision used by start_action. Before calling start_action, call search with the selected capabilityId to obtain inputContract with every permitted field name, scalar type, constraint, meaning, and required state. Preserve canonical result order and never invent confidence scores.

Dispatch the exact capability the user selected from a Search result. The selected result and its inputContract define the external operation, receiving AI or provider, possible side effects, and whether connection, payment, or approval may be required. Invoke only after the user explicitly asks to run that selected capability. Supply its exact capability ID and revision plus an idempotent request ID; Darwin never reruns Search from prose. The returned action may remain pending or require a secure next step, so never report completion until its status is completed.

Stop the action’s identified queued or running turn. This does not claim that an entire transaction, offer, or delivery was canceled.

Give one action additional information or clarification. This never approves a pending decision implicitly.