Confirm Context Delivery
confirm_context_deliveryRecord authenticated transport acknowledgement and advance the cursor for valid delivered context packages, handling gaps, stale deliveries, and replays.
Instructions
Use when: Record authenticated transport acknowledgement and advance the cursor only for a valid delivered package. Handles gap, stale delivery, and replay explicitly. 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. For the same logical mutation retry, reuse the same idempotencyKey. If the payload or user intent changes, use a new key. Replay returns the first canonical result ID and version; the key never bypasses authorization or expected-version checks. 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.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"connectionId": "<connectionId>",
"scopeType": "<scopeType>",
"scopeId": "<scopeId>",
"contextPackageId": "<contextPackageId>",
"clientEventId": "<clientEventId>",
"status": "<status>",
"expectedCursorVersion": "<expectedCursorVersion>",
"fromVersion": "<fromVersion>",
"toVersion": "<toVersion>",
"idempotencyKey": "<idempotencyKey>"
},
"name": "confirm_context_delivery"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | Yes | ||
| scopeId | Yes | ||
| 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. | |
| scopeType | Yes | ||
| toVersion | Yes | ||
| failureCode | No | ||
| fromVersion | Yes | ||
| connectionId | Yes | ||
| clientEventId | Yes | ||
| idempotencyKey | Yes | ||
| contextPackageId | Yes | ||
| expectedCursorVersion | Yes | ||
| transportAcknowledgementHash | No |
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 |