Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
375 changes: 375 additions & 0 deletions content/docs/contracts/context-typed-errors-pending.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,375 @@
{
"availability": "pending",
"apiSourceCommit": "46a0ae73cf6d96941394b45bc04bd572274ee665",
"evidence": "Exact pure API source only; no application handlers, services, hosted calls, authentication or provider execution.",
"sourceHashes": {
"lib/context/ContextOperationError.ts": "f5681cbf4c1d46d14e83b94df52ca45395ebf02e2cdfae174c4984341484ab6f",
"lib/context/classifyContextOperationError.ts": "36c10e51834e42464c12e63eea4e1782573ee48fdd370d52c60b1d065f8f64c5",
"lib/context/formatContextOperationError.ts": "d2cbddd275d01a83199b71c66c8b662c53555cc4fb21439c8c580a50b1837f8b",
"lib/context/getContextFailureMessage.ts": "af012ace560183470216d6e9f7d04ba09d1d5b50fbc861cb25090af5c90530a8",
"lib/mcp/getCallToolResult.ts": "508f772fa23be88601699f66ee92d91c19ca6d018dad95c76f6cc71a3d1850e6",
"lib/mcp/tools/context/getContextToolResultError.ts": "255187e08ac81fbab896094050591ecffdfceac2b5c302f7f7e5ef14520d9430"
},
"codes": [
{
"code": "permission_denied",
"http": {
"status": 403,
"body": {
"error": "Access denied to the selected context owner.",
"code": "permission_denied",
"retryable": false,
"guidance": "Check the authenticated account and current organization access before retrying."
}
},
"mcp": {
"isError": true,
"body": {
"success": false,
"code": "permission_denied",
"message": "Access denied to the selected context owner.",
"retryable": false,
"guidance": "Check the authenticated account and current organization access before retrying."
}
}
},
{
"code": "not_found",
"http": {
"status": 404,
"body": {
"error": "Context record not found in the selected workspace.",
"code": "not_found",
"retryable": false,
"guidance": "Check the record ID and workspace scope. This response does not distinguish a missing record from one outside your access."
}
},
"mcp": {
"isError": true,
"body": {
"success": false,
"code": "not_found",
"message": "Context record not found in the selected workspace.",
"retryable": false,
"guidance": "Check the record ID and workspace scope. This response does not distinguish a missing record from one outside your access."
}
}
},
{
"code": "conflict",
"http": {
"status": 409,
"body": {
"error": "The operation conflicts with saved state.",
"code": "conflict",
"retryable": false,
"guidance": "Read the current record and resolve the conflict before changing input."
}
},
"mcp": {
"isError": true,
"body": {
"success": false,
"code": "conflict",
"message": "The operation conflicts with saved state.",
"retryable": false,
"guidance": "Read the current record and resolve the conflict before changing input."
}
}
},
{
"code": "unsupported_input",
"http": {
"status": 422,
"body": {
"error": "The input is not supported by this operation.",
"code": "unsupported_input",
"retryable": false,
"guidance": "Check the action's documented fields, supported sources and limits before retrying."
}
},
"mcp": {
"isError": true,
"body": {
"success": false,
"code": "unsupported_input",
"message": "The input is not supported by this operation.",
"retryable": false,
"guidance": "Check the action's documented fields, supported sources and limits before retrying."
}
}
},
{
"code": "not_ready",
"http": {
"status": 409,
"body": {
"error": "The context request is not ready for this action.",
"code": "not_ready",
"retryable": true,
"guidance": "Read the request and retry only after the required state is reached. Inspect partial results and coverage gaps before using them."
}
},
"mcp": {
"isError": true,
"body": {
"success": false,
"code": "not_ready",
"message": "The context request is not ready for this action.",
"retryable": true,
"guidance": "Read the request and retry only after the required state is reached. Inspect partial results and coverage gaps before using them."
}
}
},
{
"code": "unavailable",
"http": {
"status": 503,
"body": {
"error": "A required dependency or capability is unavailable.",
"code": "unavailable",
"retryable": true,
"guidance": "Retry later with unchanged input after the dependency recovers or the capability becomes available. Retry eligibility is not a guarantee of recovery."
}
},
"mcp": {
"isError": true,
"body": {
"success": false,
"code": "unavailable",
"message": "A required dependency or capability is unavailable.",
"retryable": true,
"guidance": "Retry later with unchanged input after the dependency recovers or the capability becomes available. Retry eligibility is not a guarantee of recovery."
}
}
},
{
"code": "budget_exhausted",
"http": {
"status": 402,
"body": {
"error": "The authorized budget for this operation is exhausted.",
"code": "budget_exhausted",
"retryable": false,
"guidance": "Check the operation's authorized budget and saved state before proceeding. This reserved code does not establish whether work has run or charges occurred."
}
},
"mcp": {
"isError": true,
"body": {
"success": false,
"code": "budget_exhausted",
"message": "The authorized budget for this operation is exhausted.",
"retryable": false,
"guidance": "Check the operation's authorized budget and saved state before proceeding. This reserved code does not establish whether work has run or charges occurred."
}
}
},
{
"code": "storage_failed",
"http": {
"status": 409,
"body": {
"error": "Context storage could not complete the operation.",
"code": "storage_failed",
"retryable": false,
"guidance": "Check the saved state before changing input. The storage failure is not recognized as transient; do not automatically retry it."
}
},
"mcp": {
"isError": true,
"body": {
"success": false,
"code": "storage_failed",
"message": "Context storage could not complete the operation.",
"retryable": false,
"guidance": "Check the saved state before changing input. The storage failure is not recognized as transient; do not automatically retry it."
}
}
},
{
"code": "internal",
"http": {
"status": 500,
"body": {
"error": "Context operation failed.",
"code": "internal",
"retryable": false,
"guidance": "Check the saved state before changing input. Do not automatically retry an unclassified failure."
}
},
"mcp": {
"isError": true,
"body": {
"success": false,
"code": "internal",
"message": "Context operation failed.",
"retryable": false,
"guidance": "Check the saved state before changing input. Do not automatically retry an unclassified failure."
}
}
}
],
"actionExamples": [
{
"code": "unavailable",
"action": "read",
"http": {
"status": 503,
"body": {
"error": "A required dependency or capability is unavailable.",
"code": "unavailable",
"retryable": true,
"guidance": "Retry later with unchanged input after the dependency recovers or the capability becomes available. Retry eligibility is not a guarantee of recovery."
}
},
"mcp": {
"isError": true,
"body": {
"success": false,
"code": "unavailable",
"message": "A required dependency or capability is unavailable.",
"retryable": true,
"guidance": "Retry later with unchanged input after the dependency recovers or the capability becomes available. Retry eligibility is not a guarantee of recovery."
}
}
},
{
"code": "unavailable",
"action": "plan",
"http": {
"status": 503,
"body": {
"error": "A required dependency or capability is unavailable.",
"code": "unavailable",
"retryable": true,
"guidance": "Retry later with unchanged input after the dependency recovers or the capability becomes available. Retry eligibility is not a guarantee of recovery."
}
},
"mcp": {
"isError": true,
"body": {
"success": false,
"code": "unavailable",
"message": "A required dependency or capability is unavailable.",
"retryable": true,
"guidance": "Retry later with unchanged input after the dependency recovers or the capability becomes available. Retry eligibility is not a guarantee of recovery."
}
}
},
{
"code": "unavailable",
"action": "verify_release",
"http": {
"status": 503,
"body": {
"error": "A required dependency or capability is unavailable.",
"code": "unavailable",
"retryable": true,
"guidance": "Retry later with unchanged input after the dependency recovers or the capability becomes available. Retry eligibility is not a guarantee of recovery."
}
},
"mcp": {
"isError": true,
"body": {
"success": false,
"code": "unavailable",
"message": "A required dependency or capability is unavailable.",
"retryable": true,
"guidance": "Retry later with unchanged input after the dependency recovers or the capability becomes available. Retry eligibility is not a guarantee of recovery."
}
}
},
{
"code": "unavailable",
"action": "ingest",
"http": {
"status": 503,
"body": {
"error": "A required dependency or capability is unavailable.",
"code": "unavailable",
"retryable": true,
"guidance": "Retry later with unchanged input after the dependency recovers or the capability becomes available. Retry eligibility is not a guarantee of recovery. For an uncertain write, reuse the same idempotency key and unchanged input. Check saved state first; a new key is a new request, not a safe retry."
}
},
"mcp": {
"isError": true,
"body": {
"success": false,
"code": "unavailable",
"message": "A required dependency or capability is unavailable.",
"retryable": true,
"guidance": "Retry later with unchanged input after the dependency recovers or the capability becomes available. Retry eligibility is not a guarantee of recovery. For an uncertain write, reuse the same idempotency key and unchanged input. Check saved state first; a new key is a new request, not a safe retry."
}
}
},
{
"code": "unavailable",
"action": "attach_evidence",
"http": {
"status": 503,
"body": {
"error": "A required dependency or capability is unavailable.",
"code": "unavailable",
"retryable": true,
"guidance": "Retry later with unchanged input after the dependency recovers or the capability becomes available. Retry eligibility is not a guarantee of recovery. Evidence attachment could not complete. Check workspace, source retention and target access. Retry only the same source version, targets and idempotency key."
}
},
"mcp": {
"isError": true,
"body": {
"success": false,
"code": "unavailable",
"message": "A required dependency or capability is unavailable.",
"retryable": true,
"guidance": "Retry later with unchanged input after the dependency recovers or the capability becomes available. Retry eligibility is not a guarantee of recovery. Evidence attachment could not complete. Check workspace, source retention and target access. Retry only the same source version, targets and idempotency key."
}
}
},
{
"code": "unavailable",
"action": "save_catalog_case",
"http": {
"status": 503,
"body": {
"error": "A required dependency or capability is unavailable.",
"code": "unavailable",
"retryable": true,
"guidance": "Retry later with unchanged input after the dependency recovers or the capability becomes available. Retry eligibility is not a guarantee of recovery. Catalog case save could not complete. Check workspace, retained sources and expected revision. Retry an uncertain save only with the same idempotency key and unchanged payload; read the current revision before editing."
}
},
"mcp": {
"isError": true,
"body": {
"success": false,
"code": "unavailable",
"message": "A required dependency or capability is unavailable.",
"retryable": true,
"guidance": "Retry later with unchanged input after the dependency recovers or the capability becomes available. Retry eligibility is not a guarantee of recovery. Catalog case save could not complete. Check workspace, retained sources and expected revision. Retry an uncertain save only with the same idempotency key and unchanged payload; read the current revision before editing."
}
}
}
],
"classificationExamples": [
{
"input": "Context request not found",
"code": "not_found"
},
{
"input": "Access denied to context owner",
"code": "permission_denied"
},
{
"input": "Context storage operation failed: query returned no rows",
"code": "storage_failed"
},
{
"input": "Context storage operation failed: Catalog revision conflict",
"code": "conflict"
},
{
"input": "private-record unavailable",
"code": "internal"
}
]
}
1 change: 1 addition & 0 deletions content/docs/contracts/operation-inventory.json
Original file line number Diff line number Diff line change
Expand Up @@ -3838,6 +3838,7 @@
"content/docs/source/api-reference/openapi/ai.json": "678f649fff58a1c49c81002ea2cbe66636ad5da1044ea66261e6ab4084600687",
"content/docs/source/api-reference/openapi/applications.json": "07cf7c630ca81816d73e9198b863dc0a9c8e987f4e0794375951ead06e498ad6",
"content/docs/source/api-reference/openapi/content.json": "877afed1e0fb5c95afab8c5e294bae38fabdf48f50f226e0089b9ff50438870d",
"content/docs/source/api-reference/openapi/context-errors-pending.json": "108f6f9bbe0146fb35b21ff0c218decce3de540d2ac14162bd7562b0550eb6fa",
"content/docs/source/api-reference/openapi/context.json": "10b243ab1098a7428fb935dfb0780ff0f9a1c8885b96feda8e453acff4a1df17",
"content/docs/source/api-reference/openapi/players.json": "4a4c90583fe1de6487444581b293a32b1cc04622fc929965ab90f365feb8bc94",
"content/docs/source/api-reference/openapi/projects.json": "b059cf8baa83a7f73a3c15db19f54fa56e46a3840e91bd42979b83550f543ace",
Expand Down
1 change: 1 addition & 0 deletions content/docs/inventory.json
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,7 @@
"ai.json",
"applications.json",
"content.json",
"context-errors-pending.json",
"context.json",
"players.json",
"projects.json",
Expand Down
2 changes: 1 addition & 1 deletion content/docs/manifest.json

Large diffs are not rendered by default.

Loading
Loading