Start AI Execution
start_ai_executionStart a durable AI execution to process a previously delivered context package. Use after confirming context delivery and before recording consumption.
Instructions
Use when: Start the durable AIExecution that will consume an already delivered ContextPackage. The API, not MCP, owns authorization and may return a request-scoped execution grant; MCP must pass that result through without interpreting billing or payment state. Call this after confirm_context_delivery and before record_context_consumption. Do not retry automatically because this creates a new execution. Do not use when: a narrower tool better matches the intent, the project scope is unresolved, or the user has declined the action. Requires: authenticated API authority and an API-authorized selected Project. Effect: canonical mutation. This mutation has no client idempotency key in the current contract; do not retry it automatically after an unknown outcome. Human approval: not required for this read or staging action. Then: follow typed result state; review pending proposals/drafts before any canonical apply. On failure: login_required → login; project_not_selected → list_projects/select_project; permission_denied → stop; stale_version or conflict → read current state; projection_pending → report canonical success separately and wait.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model | No | ||
| status | No | ||
| taskId | Yes | ||
| provider | No | ||
| projectId | No | Optional project id. Defaults to the project chosen with select_project. If omitted and no project is selected, the call is rejected with instructions to select one. | |
| sessionId | No | ||
| connectionId | No | ||
| inputSyncReceiptIds | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | ||
| status | Yes | ||
| warnings | Yes | ||
| authority | Yes | ||
| projectId | Yes | ||
| reviewUrl | Yes | ||
| idempotency | Yes | ||
| nextActions | Yes | ||
| reviewRequired | Yes | ||
| canonicalVersion | Yes | ||
| projectionStatus | Yes |