@claudexor/schema 5.0.2 → 6.0.0

package/generated/McpRunHandleResult.schema.json

@@ -90,7 +90,7 @@
                             "retryable": {
                               "type": "boolean",
                               "default": true,
-                              "description": "True when retry can replay this turn (a job was recorded before the failure); false when no job exists to replay."
+                              "description": "True when retry can replay this turn (a job was recorded before the failure); false when no job exists to replay or a managed resource it names was released."
                             },
                             "required_actions": {
                               "type": "array",
@@ -121,13 +121,51 @@
                         "code"
                       ],
                       "additionalProperties": false,
-                      "description": "Stable hold. Editing, observation and readiness restoration never rearm it; inspect the predecessor result and clear before an ordinary continuation."
+                      "description": "Stable hold. Editing, observation and readiness restoration never rearm it; inspect the predecessor result and clear before an ordinary continuation. One exception: an unchanged settlement_unknown draft returns by itself when a later settlement of the predecessor's run, by the live daemon that ran it, proves its processes gone (see resumed); a Stop first keeps it held."
                     },
                     {
                       "type": "null"
                     }
                   ],
-                  "description": "Stable hold. Editing, observation and readiness restoration never rearm it; inspect the predecessor result and clear before an ordinary continuation."
+                  "description": "Stable hold. Editing, observation and readiness restoration never rearm it; inspect the predecessor result and clear before an ordinary continuation. One exception: an unchanged settlement_unknown draft returns by itself when a later settlement of the predecessor's run, by the live daemon that ran it, proves its processes gone (see resumed); a Stop first keeps it held."
+                },
+                "resumed": {
+                  "type": "object",
+                  "properties": {
+                    "from": {
+                      "type": "object",
+                      "properties": {
+                        "code": {
+                          "$ref": "#/definitions/McpRunHandleResult/properties/deferredMessage/anyOf/0/properties/hold/anyOf/0/properties/code"
+                        },
+                        "problem": {
+                          "$ref": "#/definitions/McpRunHandleResult/properties/deferredMessage/anyOf/0/properties/hold/anyOf/0/properties/problem"
+                        }
+                      },
+                      "required": [
+                        "code"
+                      ],
+                      "additionalProperties": false,
+                      "description": "The hold the draft was returned from."
+                    },
+                    "reason": {
+                      "type": "string",
+                      "const": "process_scope_settled",
+                      "description": "A later settlement of the predecessor's run proved its processes gone; the draft was unchanged, not cleared, replaced or stopped."
+                    },
+                    "at": {
+                      "type": "string",
+                      "minLength": 1,
+                      "description": "ISO-8601 timestamp string."
+                    }
+                  },
+                  "required": [
+                    "from",
+                    "reason",
+                    "at"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Why this draft left its hold automatically. It then took the existing revision and admission path; any other reason holds it again."
                 },
                 "dispatchedRevision": {
                   "anyOf": [
@@ -188,6 +226,41 @@
           "items": {
             "type": "object",
             "properties": {
+              "programs": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "path": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "version": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "versionSource": {
+                      "type": "string",
+                      "enum": [
+                        "vendor_stream",
+                        "version_probe",
+                        "remembered",
+                        "unknown"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "path",
+                    "version",
+                    "versionSource"
+                  ],
+                  "additionalProperties": false
+                }
+              },
               "attemptId": {
                 "$ref": "#/definitions/McpRunHandleResult/properties/deferredMessage/anyOf/0/properties/draftId"
               },
@@ -492,6 +565,7 @@
                             "input_required",
                             "work_incomplete",
                             "context_capacity_exhausted",
+                            "turn_limit_reached",
                             "work_report_contract"
                           ],
                           "description": "Typed reason qualifying a non-clean terminal; null on a clean success."
@@ -1031,6 +1105,17 @@
             {
               "type": "object",
               "properties": {
+                "lastVendorError": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "maxLength": 1000
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
                 "requestRefusal": {
                   "anyOf": [
                     {
@@ -1169,9 +1254,41 @@
                         "reported_source"
                       ],
                       "additionalProperties": false
+                    },
+                    {
+                      "type": "object",
+                      "properties": {
+                        "kind": {
+                          "type": "string",
+                          "const": "vendor_not_retryable"
+                        },
+                        "source": {
+                          "type": "string",
+                          "const": "agy_stderr"
+                        },
+                        "error_id": {
+                          "anyOf": [
+                            {
+                              "type": "string",
+                              "minLength": 1,
+                              "maxLength": 128
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ],
+                          "description": "The vendor's own error id from the same record, verbatim; null when absent."
+                        }
+                      },
+                      "required": [
+                        "kind",
+                        "source",
+                        "error_id"
+                      ],
+                      "additionalProperties": false
                     }
                   ],
-                  "description": "Vendor-attested request refusal that stops retries and account rotation on its harness; input, executable and credential-source causes carry their own evidence."
+                  "description": "Vendor-attested request refusal that stops retries and account rotation on its harness; input, executable and credential-source causes and an explicit vendor not-retryable verdict carry their own evidence."
                 },
                 "rawContextShortfall": {
                   "type": "object",
@@ -1422,8 +1539,20 @@
                         "raw_context_mandatory_unavailable",
                         "raw_context_exceeds_window",
                         "model_catalog_unavailable",
+                        "model_selection_required",
+                        "raw_patch_requires_isolation",
+                        "raw_patch_missing_evidence",
+                        "raw_patch_digest_mismatch",
+                        "raw_patch_base_mismatch",
+                        "raw_patch_path_traversal",
+                        "raw_patch_outside_scope",
+                        "raw_patch_stale_preimage",
+                        "raw_patch_binary_unsupported",
+                        "raw_patch_truncated",
+                        "raw_patch_apply_failed",
                         "vendor_cli_too_old",
                         "credential_source_unconfirmed",
+                        "vendor_not_retryable",
                         "delegated_home_unavailable",
                         "delegated_confinement_unavailable",
                         "delegated_evidence_incomplete",
@@ -1552,7 +1681,7 @@
                     "threshold"
                   ],
                   "additionalProperties": false,
-                  "description": "Present when quota admission refused the account (code subscription_window_exhausted): separates the owner's saved reserve from provider exhaustion. Absent on other failures and on records written before this field existed."
+                  "description": "Present when quota admission or a typed provider limit refused the account: with code subscription_window_exhausted it separates the owner's saved reserve from provider exhaustion; with a null code the provider refused usage and no reopening time is known, so no timer is implied. Absent on other failures and on records written before this field existed."
                 },
                 "vendorFailure": {
                   "anyOf": [
@@ -1611,6 +1740,11 @@
                   "items": {
                     "type": "object",
                     "properties": {
+                      "lastVendorError": {
+                        "type": "string",
+                        "maxLength": 1000,
+                        "description": "Last vendor diagnostic line, bounded and redacted; never classified."
+                      },
                       "harnessId": {
                         "type": "string",
                         "minLength": 1,
@@ -2102,13 +2236,14 @@
                     "transport",
                     "permission_denied",
                     "context_exhausted",
+                    "turn_limit",
                     "wall_clock",
                     "cancelled",
                     "host_restart",
                     "input_required",
                     "other"
                   ],
-                  "description": "Typed reason the previous process stopped: a vendor limit (next account eligible), the whole pool spent, a pinned account's limit, a transport death (crash, timeout, watchdog), a confirmed native tool permission refusal, context exhaustion, the wall-clock deadline, a cancel, a daemon/host restart, a model that asked for input, or another typed cause."
+                  "description": "Typed reason the previous process stopped: a vendor limit (next account eligible), the whole pool spent, a pinned account's limit, an error without a typed cause (`transport`: a crash, an inactivity timeout or a harness-reported error; not proof that a process died or the network failed), a confirmed native tool permission refusal, context exhaustion, the run's max-turns cap, the wall-clock deadline, a cancel, a daemon/host restart, a model that asked for input, or another typed cause."
                 },
                 "resetsAt": {
                   "type": [

package/generated/McpRunToolResult.schema.json

@@ -12,7 +12,7 @@
         "storeId": {
           "type": "string",
           "minLength": 1,
-          "description": "Identity of the durable engine store that accepted this group member, stable across restarts."
+          "description": "Identity of the durable engine store that accepted this command, stable across restarts. A group member always carries it; an ordinary receipt carries it only for a request sending `X-Claudexor-Store-Identity: 1`, and it stays absent, meaning unknown, when the store has no identity to give."
         },
         "deferredMessage": {
           "anyOf": [
@@ -100,7 +100,7 @@
                             "retryable": {
                               "type": "boolean",
                               "default": true,
-                              "description": "True when retry can replay this turn (a job was recorded before the failure); false when no job exists to replay."
+                              "description": "True when retry can replay this turn (a job was recorded before the failure); false when no job exists to replay or a managed resource it names was released."
                             },
                             "required_actions": {
                               "type": "array",
@@ -131,13 +131,51 @@
                         "code"
                       ],
                       "additionalProperties": false,
-                      "description": "Stable hold. Editing, observation and readiness restoration never rearm it; inspect the predecessor result and clear before an ordinary continuation."
+                      "description": "Stable hold. Editing, observation and readiness restoration never rearm it; inspect the predecessor result and clear before an ordinary continuation. One exception: an unchanged settlement_unknown draft returns by itself when a later settlement of the predecessor's run, by the live daemon that ran it, proves its processes gone (see resumed); a Stop first keeps it held."
                     },
                     {
                       "type": "null"
                     }
                   ],
-                  "description": "Stable hold. Editing, observation and readiness restoration never rearm it; inspect the predecessor result and clear before an ordinary continuation."
+                  "description": "Stable hold. Editing, observation and readiness restoration never rearm it; inspect the predecessor result and clear before an ordinary continuation. One exception: an unchanged settlement_unknown draft returns by itself when a later settlement of the predecessor's run, by the live daemon that ran it, proves its processes gone (see resumed); a Stop first keeps it held."
+                },
+                "resumed": {
+                  "type": "object",
+                  "properties": {
+                    "from": {
+                      "type": "object",
+                      "properties": {
+                        "code": {
+                          "$ref": "#/definitions/McpRunToolResult/properties/deferredMessage/anyOf/0/properties/hold/anyOf/0/properties/code"
+                        },
+                        "problem": {
+                          "$ref": "#/definitions/McpRunToolResult/properties/deferredMessage/anyOf/0/properties/hold/anyOf/0/properties/problem"
+                        }
+                      },
+                      "required": [
+                        "code"
+                      ],
+                      "additionalProperties": false,
+                      "description": "The hold the draft was returned from."
+                    },
+                    "reason": {
+                      "type": "string",
+                      "const": "process_scope_settled",
+                      "description": "A later settlement of the predecessor's run proved its processes gone; the draft was unchanged, not cleared, replaced or stopped."
+                    },
+                    "at": {
+                      "type": "string",
+                      "minLength": 1,
+                      "description": "ISO-8601 timestamp string."
+                    }
+                  },
+                  "required": [
+                    "from",
+                    "reason",
+                    "at"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Why this draft left its hold automatically. It then took the existing revision and admission path; any other reason holds it again."
                 },
                 "dispatchedRevision": {
                   "anyOf": [
@@ -198,6 +236,41 @@
           "items": {
             "type": "object",
             "properties": {
+              "programs": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "path": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "version": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "versionSource": {
+                      "type": "string",
+                      "enum": [
+                        "vendor_stream",
+                        "version_probe",
+                        "remembered",
+                        "unknown"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "path",
+                    "version",
+                    "versionSource"
+                  ],
+                  "additionalProperties": false
+                }
+              },
               "attemptId": {
                 "$ref": "#/definitions/McpRunToolResult/properties/deferredMessage/anyOf/0/properties/draftId"
               },
@@ -507,6 +580,7 @@
                             "input_required",
                             "work_incomplete",
                             "context_capacity_exhausted",
+                            "turn_limit_reached",
                             "work_report_contract"
                           ],
                           "description": "Typed reason qualifying a non-clean terminal; null on a clean success."
@@ -1025,6 +1099,17 @@
             {
               "type": "object",
               "properties": {
+                "lastVendorError": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "maxLength": 1000
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
                 "requestRefusal": {
                   "anyOf": [
                     {
@@ -1163,9 +1248,41 @@
                         "reported_source"
                       ],
                       "additionalProperties": false
+                    },
+                    {
+                      "type": "object",
+                      "properties": {
+                        "kind": {
+                          "type": "string",
+                          "const": "vendor_not_retryable"
+                        },
+                        "source": {
+                          "type": "string",
+                          "const": "agy_stderr"
+                        },
+                        "error_id": {
+                          "anyOf": [
+                            {
+                              "type": "string",
+                              "minLength": 1,
+                              "maxLength": 128
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ],
+                          "description": "The vendor's own error id from the same record, verbatim; null when absent."
+                        }
+                      },
+                      "required": [
+                        "kind",
+                        "source",
+                        "error_id"
+                      ],
+                      "additionalProperties": false
                     }
                   ],
-                  "description": "Vendor-attested request refusal that stops retries and account rotation on its harness; input, executable and credential-source causes carry their own evidence."
+                  "description": "Vendor-attested request refusal that stops retries and account rotation on its harness; input, executable and credential-source causes and an explicit vendor not-retryable verdict carry their own evidence."
                 },
                 "rawContextShortfall": {
                   "type": "object",
@@ -1416,8 +1533,20 @@
                         "raw_context_mandatory_unavailable",
                         "raw_context_exceeds_window",
                         "model_catalog_unavailable",
+                        "model_selection_required",
+                        "raw_patch_requires_isolation",
+                        "raw_patch_missing_evidence",
+                        "raw_patch_digest_mismatch",
+                        "raw_patch_base_mismatch",
+                        "raw_patch_path_traversal",
+                        "raw_patch_outside_scope",
+                        "raw_patch_stale_preimage",
+                        "raw_patch_binary_unsupported",
+                        "raw_patch_truncated",
+                        "raw_patch_apply_failed",
                         "vendor_cli_too_old",
                         "credential_source_unconfirmed",
+                        "vendor_not_retryable",
                         "delegated_home_unavailable",
                         "delegated_confinement_unavailable",
                         "delegated_evidence_incomplete",
@@ -1546,7 +1675,7 @@
                     "threshold"
                   ],
                   "additionalProperties": false,
-                  "description": "Present when quota admission refused the account (code subscription_window_exhausted): separates the owner's saved reserve from provider exhaustion. Absent on other failures and on records written before this field existed."
+                  "description": "Present when quota admission or a typed provider limit refused the account: with code subscription_window_exhausted it separates the owner's saved reserve from provider exhaustion; with a null code the provider refused usage and no reopening time is known, so no timer is implied. Absent on other failures and on records written before this field existed."
                 },
                 "vendorFailure": {
                   "anyOf": [
@@ -1605,6 +1734,11 @@
                   "items": {
                     "type": "object",
                     "properties": {
+                      "lastVendorError": {
+                        "type": "string",
+                        "maxLength": 1000,
+                        "description": "Last vendor diagnostic line, bounded and redacted; never classified."
+                      },
                       "harnessId": {
                         "type": "string",
                         "minLength": 1,

package/generated/McpRunWaitResult.schema.json

@@ -90,7 +90,7 @@
                             "retryable": {
                               "type": "boolean",
                               "default": true,
-                              "description": "True when retry can replay this turn (a job was recorded before the failure); false when no job exists to replay."
+                              "description": "True when retry can replay this turn (a job was recorded before the failure); false when no job exists to replay or a managed resource it names was released."
                             },
                             "required_actions": {
                               "type": "array",
@@ -121,13 +121,51 @@
                         "code"
                       ],
                       "additionalProperties": false,
-                      "description": "Stable hold. Editing, observation and readiness restoration never rearm it; inspect the predecessor result and clear before an ordinary continuation."
+                      "description": "Stable hold. Editing, observation and readiness restoration never rearm it; inspect the predecessor result and clear before an ordinary continuation. One exception: an unchanged settlement_unknown draft returns by itself when a later settlement of the predecessor's run, by the live daemon that ran it, proves its processes gone (see resumed); a Stop first keeps it held."
                     },
                     {
                       "type": "null"
                     }
                   ],
-                  "description": "Stable hold. Editing, observation and readiness restoration never rearm it; inspect the predecessor result and clear before an ordinary continuation."
+                  "description": "Stable hold. Editing, observation and readiness restoration never rearm it; inspect the predecessor result and clear before an ordinary continuation. One exception: an unchanged settlement_unknown draft returns by itself when a later settlement of the predecessor's run, by the live daemon that ran it, proves its processes gone (see resumed); a Stop first keeps it held."
+                },
+                "resumed": {
+                  "type": "object",
+                  "properties": {
+                    "from": {
+                      "type": "object",
+                      "properties": {
+                        "code": {
+                          "$ref": "#/definitions/McpRunWaitResult/properties/deferredMessage/anyOf/0/properties/hold/anyOf/0/properties/code"
+                        },
+                        "problem": {
+                          "$ref": "#/definitions/McpRunWaitResult/properties/deferredMessage/anyOf/0/properties/hold/anyOf/0/properties/problem"
+                        }
+                      },
+                      "required": [
+                        "code"
+                      ],
+                      "additionalProperties": false,
+                      "description": "The hold the draft was returned from."
+                    },
+                    "reason": {
+                      "type": "string",
+                      "const": "process_scope_settled",
+                      "description": "A later settlement of the predecessor's run proved its processes gone; the draft was unchanged, not cleared, replaced or stopped."
+                    },
+                    "at": {
+                      "type": "string",
+                      "minLength": 1,
+                      "description": "ISO-8601 timestamp string."
+                    }
+                  },
+                  "required": [
+                    "from",
+                    "reason",
+                    "at"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Why this draft left its hold automatically. It then took the existing revision and admission path; any other reason holds it again."
                 },
                 "dispatchedRevision": {
                   "anyOf": [
@@ -536,7 +574,16 @@
                   "null"
                 ],
                 "default": null,
-                "description": "When the interaction times out into a benign decline; null = no timeout."
+                "description": "When the interaction expires unanswered; null = no automatic expiry. A blocking question then declines benignly; an async one closes and nothing is sent."
+              },
+              "delivery": {
+                "type": "string",
+                "enum": [
+                  "blocking",
+                  "async"
+                ],
+                "description": "How the asking agent waits for the answer: blocking (its native tool call waits until the question is answered, declined, expired or released) or async (the agent keeps working and an answer reaches it later as its next user message). Silence, expiry and the run's end never answer either kind.",
+                "default": "blocking"
               }
             },
             "required": [
@@ -565,7 +612,7 @@
             "aborted",
             "disconnected"
           ],
-          "description": "Why this observation returned, by precedence: aborted (this read was cancelled; the worker continues), terminal (the run is terminal; events may still follow nextSeq unless eventOmission is stream_ended), interactions (this page includes a question event), events (event mode, a completed zero-wait page, or a page, even an empty one, stopped by event_limit, byte_limit, oversized_frame or invalid_event), timeout (waitMs elapsed, possibly with a partial batch), disconnected (the stream ended early; never completion)."
+          "description": "Why this observation returned, by precedence: aborted (this read was cancelled; the worker continues), terminal (the run is terminal; events may still follow nextSeq unless eventOmission is stream_ended), interactions (this page includes a question event, or oversizedEvent is a question too large for any page; claudexor_run_interactions returns it complete), events (event mode, a completed zero-wait page, or a page, even an empty one, stopped by event_limit, byte_limit, oversized_frame or invalid_event), timeout (waitMs elapsed, possibly with a partial batch), disconnected (the stream ended early; never completion)."
         }
       },
       "required": [

package/generated/McpThreadTurnResult.schema.json

@@ -6,6 +6,11 @@
         {
           "type": "object",
           "properties": {
+            "storeId": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Identity of the durable engine store that accepted this command, stable across restarts. A group member always carries it; an ordinary receipt carries it only for a request sending `X-Claudexor-Store-Identity: 1`, and it stays absent, meaning unknown, when the store has no identity to give."
+            },
             "jobId": {
               "type": "string",
               "description": "Daemon job id backing the run."
@@ -48,6 +53,10 @@
         {
           "type": "object",
           "properties": {
+            "storeId": {
+              "$ref": "#/definitions/McpThreadTurnResult/anyOf/0/properties/storeId",
+              "description": "Identity of the durable engine store that accepted this command, stable across restarts. A group member always carries it; an ordinary receipt carries it only for a request sending `X-Claudexor-Store-Identity: 1`, and it stays absent, meaning unknown, when the store has no identity to give."
+            },
             "jobId": {
               "$ref": "#/definitions/McpThreadTurnResult/anyOf/0/properties/threadId"
             },

package/generated/NativeProgramEvidence.schema.json

@@ -0,0 +1,38 @@
+{
+  "$ref": "#/definitions/NativeProgramEvidence",
+  "definitions": {
+    "NativeProgramEvidence": {
+      "type": "object",
+      "properties": {
+        "path": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "version": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "versionSource": {
+          "type": "string",
+          "enum": [
+            "vendor_stream",
+            "version_probe",
+            "remembered",
+            "unknown"
+          ]
+        }
+      },
+      "required": [
+        "path",
+        "version",
+        "versionSource"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/RawContextPacket.schema.json

@@ -113,11 +113,13 @@
         },
         "base_commit_sha": {
           "type": "string",
-          "minLength": 1
+          "minLength": 1,
+          "description": "The run's delivery base commit; every round of a run names the same one."
         },
         "base_tree_sha": {
           "type": "string",
-          "minLength": 1
+          "minLength": 1,
+          "description": "The exact tree this request describes and its patch applies to: the delivery base's tree on a first round, afterwards the candidate an earlier round left."
         },
         "readable_files": {
           "type": "array",
@@ -131,12 +133,12 @@
               },
               "mode": {
                 "type": "string",
-                "description": "Git object mode at the bound base tree."
+                "description": "Git object mode in the packet's exact tree."
               },
               "blob_oid": {
                 "type": "string",
                 "minLength": 1,
-                "description": "Git blob oid at the bound base tree."
+                "description": "Git blob oid in the packet's exact tree."
               },
               "content_hash": {
                 "$ref": "#/definitions/RawContextPacket/properties/packet_hash"

package/generated/RawGitPatchEnvelope.schema.json

@@ -43,7 +43,7 @@
                     "type": "null"
                   }
                 ],
-                "description": "Base-tree blob oid, or null only when the path is absent in the base tree."
+                "description": "Blob oid in the packet's exact tree, or null only when that tree lacks the path."
               }
             },
             "required": [