@claudexor/schema 4.6.2 → 4.8.1

package/generated/McpRunToolResult.schema.json

@@ -4,18 +4,205 @@
     "McpRunToolResult": {
       "type": "object",
       "properties": {
+        "taskGroupId": {
+          "type": "string",
+          "format": "uuid",
+          "description": "Caller-generated UUID saved before launching the first member. Each job still needs its own idempotency key; the group grants no execution authority."
+        },
+        "storeId": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Identity of the durable engine store that accepted this group member, stable across restarts."
+        },
+        "deferredMessage": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "draftId": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "Non-empty identifier string."
+                },
+                "revision": {
+                  "type": "integer",
+                  "exclusiveMinimum": 0,
+                  "maximum": 9007199254740991
+                },
+                "state": {
+                  "type": "string",
+                  "enum": [
+                    "waiting",
+                    "held",
+                    "dispatched",
+                    "cleared"
+                  ]
+                },
+                "predecessorJobId": {
+                  "$ref": "#/definitions/McpRunToolResult/properties/deferredMessage/anyOf/0/properties/draftId"
+                },
+                "predecessorRunId": {
+                  "anyOf": [
+                    {
+                      "$ref": "#/definitions/McpRunToolResult/properties/deferredMessage/anyOf/0/properties/draftId"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Non-empty identifier string."
+                },
+                "predecessorResult": {
+                  "type": "string",
+                  "description": "Existing addressed run-detail/result path; no duplicate result store."
+                },
+                "hold": {
+                  "anyOf": [
+                    {
+                      "type": "object",
+                      "properties": {
+                        "code": {
+                          "type": "string",
+                          "enum": [
+                            "predecessor_failed",
+                            "predecessor_cancelled",
+                            "predecessor_interrupted",
+                            "predecessor_needs_input",
+                            "predecessor_incomplete",
+                            "predecessor_facts_unavailable",
+                            "predecessor_work_unverified",
+                            "predecessor_checks_failed",
+                            "predecessor_review_blocked",
+                            "predecessor_output_unavailable",
+                            "settlement_unknown",
+                            "stop_requested",
+                            "shutdown",
+                            "restart_requires_controller",
+                            "partition_retired",
+                            "admission_refused"
+                          ]
+                        },
+                        "problem": {
+                          "type": "object",
+                          "properties": {
+                            "message": {
+                              "type": "string",
+                              "description": "Human-readable refusal message."
+                            },
+                            "code": {
+                              "type": [
+                                "string",
+                                "null"
+                              ],
+                              "default": null,
+                              "description": "Machine-readable refusal code carried from the throwing gate; null when the failure had no typed code."
+                            },
+                            "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."
+                            },
+                            "required_actions": {
+                              "type": "array",
+                              "items": {
+                                "type": "string",
+                                "minLength": 1,
+                                "maxLength": 512
+                              },
+                              "maxItems": 16,
+                              "default": [],
+                              "description": "Bounded user actions that may make an exact retry succeed."
+                            },
+                            "context": {
+                              "type": "object",
+                              "additionalProperties": {},
+                              "default": {},
+                              "description": "Bounded typed recovery context; never arbitrary provider or environment output."
+                            }
+                          },
+                          "required": [
+                            "message"
+                          ],
+                          "additionalProperties": false,
+                          "description": "Typed, sanitized problem for a thread turn that could not start."
+                        }
+                      },
+                      "required": [
+                        "code"
+                      ],
+                      "additionalProperties": false,
+                      "description": "Stable hold. Editing, observation and readiness restoration never rearm it; inspect the predecessor result and clear before an ordinary continuation."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Stable hold. Editing, observation and readiness restoration never rearm it; inspect the predecessor result and clear before an ordinary continuation."
+                },
+                "dispatchedRevision": {
+                  "anyOf": [
+                    {
+                      "$ref": "#/definitions/McpRunToolResult/properties/deferredMessage/anyOf/0/properties/revision"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "successorJobId": {
+                  "anyOf": [
+                    {
+                      "$ref": "#/definitions/McpRunToolResult/properties/deferredMessage/anyOf/0/properties/draftId"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Non-empty identifier string."
+                },
+                "successorRunId": {
+                  "anyOf": [
+                    {
+                      "$ref": "#/definitions/McpRunToolResult/properties/deferredMessage/anyOf/0/properties/draftId"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Non-empty identifier string."
+                }
+              },
+              "required": [
+                "draftId",
+                "revision",
+                "state",
+                "predecessorJobId",
+                "predecessorRunId",
+                "predecessorResult",
+                "hold",
+                "dispatchedRevision",
+                "successorJobId",
+                "successorRunId"
+              ],
+              "additionalProperties": false,
+              "description": "Compact addressed draft state, with exact predecessor result and successor handles. A terminal predecessor does not imply the draft has resolved."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Compact addressed draft state, with exact predecessor result and successor handles. A terminal predecessor does not imply the draft has resolved."
+        },
         "attemptExecution": {
           "type": "array",
           "items": {
             "type": "object",
             "properties": {
               "attemptId": {
-                "type": "string",
-                "minLength": 1,
-                "description": "Non-empty identifier string."
+                "$ref": "#/definitions/McpRunToolResult/properties/deferredMessage/anyOf/0/properties/draftId"
               },
               "harnessId": {
-                "$ref": "#/definitions/McpRunToolResult/properties/attemptExecution/items/properties/attemptId"
+                "$ref": "#/definitions/McpRunToolResult/properties/deferredMessage/anyOf/0/properties/draftId"
               },
               "processing": {
                 "type": "object",
@@ -237,10 +424,10 @@
                   "description": "Schema version of the artifact; bumped on breaking ABI changes."
                 },
                 "run_id": {
-                  "$ref": "#/definitions/McpRunToolResult/properties/attemptExecution/items/properties/attemptId"
+                  "$ref": "#/definitions/McpRunToolResult/properties/deferredMessage/anyOf/0/properties/draftId"
                 },
                 "task_id": {
-                  "$ref": "#/definitions/McpRunToolResult/properties/attemptExecution/items/properties/attemptId"
+                  "$ref": "#/definitions/McpRunToolResult/properties/deferredMessage/anyOf/0/properties/draftId"
                 },
                 "mode": {
                   "type": "string",
@@ -462,7 +649,7 @@
                     "producer_attempt_id": {
                       "anyOf": [
                         {
-                          "$ref": "#/definitions/McpRunToolResult/properties/attemptExecution/items/properties/attemptId"
+                          "$ref": "#/definitions/McpRunToolResult/properties/deferredMessage/anyOf/0/properties/draftId"
                         },
                         {
                           "type": "null"
@@ -552,7 +739,7 @@
                           "attempt_id": {
                             "anyOf": [
                               {
-                                "$ref": "#/definitions/McpRunToolResult/properties/attemptExecution/items/properties/attemptId"
+                                "$ref": "#/definitions/McpRunToolResult/properties/deferredMessage/anyOf/0/properties/draftId"
                               },
                               {
                                 "type": "null"
@@ -654,7 +841,7 @@
                     "receipt_attempt_id": {
                       "anyOf": [
                         {
-                          "$ref": "#/definitions/McpRunToolResult/properties/attemptExecution/items/properties/attemptId"
+                          "$ref": "#/definitions/McpRunToolResult/properties/deferredMessage/anyOf/0/properties/draftId"
                         },
                         {
                           "type": "null"
@@ -683,7 +870,7 @@
                     "blocker_ids": {
                       "type": "array",
                       "items": {
-                        "$ref": "#/definitions/McpRunToolResult/properties/attemptExecution/items/properties/attemptId"
+                        "$ref": "#/definitions/McpRunToolResult/properties/deferredMessage/anyOf/0/properties/draftId"
                       },
                       "default": [],
                       "description": "Stable ids of accepted evidence-backed blocking findings."
@@ -946,9 +1133,38 @@
                         "installed_version"
                       ],
                       "additionalProperties": false
+                    },
+                    {
+                      "type": "object",
+                      "properties": {
+                        "kind": {
+                          "type": "string",
+                          "const": "credential_source_unconfirmed"
+                        },
+                        "native_code": {
+                          "type": "string",
+                          "const": "grok_credential_source_unconfirmed"
+                        },
+                        "source": {
+                          "type": "string",
+                          "const": "grok_init"
+                        },
+                        "reported_source": {
+                          "type": "string",
+                          "maxLength": 80,
+                          "description": "Redacted credential source the vendor's startup frame reported."
+                        }
+                      },
+                      "required": [
+                        "kind",
+                        "native_code",
+                        "source",
+                        "reported_source"
+                      ],
+                      "additionalProperties": false
                     }
                   ],
-                  "description": "Vendor-attested request refusal that another account cannot repair; input and executable 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 carry their own evidence."
                 },
                 "captureFailure": {
                   "type": "object",
@@ -1048,10 +1264,12 @@
                         "credential_pool_exhausted",
                         "input_too_large",
                         "vendor_cli_too_old",
+                        "credential_source_unconfirmed",
                         "delegated_home_unavailable",
                         "delegated_confinement_unavailable",
                         "delegated_evidence_incomplete",
                         "access_profile_incompatible",
+                        "auxiliary_writable_roots_unsupported",
                         "retired_access_profile"
                       ],
                       "description": "Machine-readable failure sub-code within a RunFailure category, including historical delegated-run failures and active access-profile refusals."

package/generated/McpRunWaitResult.schema.json

@@ -4,6 +4,185 @@
     "McpRunWaitResult": {
       "type": "object",
       "properties": {
+        "deferredMessage": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "draftId": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "Non-empty identifier string."
+                },
+                "revision": {
+                  "type": "integer",
+                  "exclusiveMinimum": 0,
+                  "maximum": 9007199254740991
+                },
+                "state": {
+                  "type": "string",
+                  "enum": [
+                    "waiting",
+                    "held",
+                    "dispatched",
+                    "cleared"
+                  ]
+                },
+                "predecessorJobId": {
+                  "$ref": "#/definitions/McpRunWaitResult/properties/deferredMessage/anyOf/0/properties/draftId"
+                },
+                "predecessorRunId": {
+                  "anyOf": [
+                    {
+                      "$ref": "#/definitions/McpRunWaitResult/properties/deferredMessage/anyOf/0/properties/draftId"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Non-empty identifier string."
+                },
+                "predecessorResult": {
+                  "type": "string",
+                  "description": "Existing addressed run-detail/result path; no duplicate result store."
+                },
+                "hold": {
+                  "anyOf": [
+                    {
+                      "type": "object",
+                      "properties": {
+                        "code": {
+                          "type": "string",
+                          "enum": [
+                            "predecessor_failed",
+                            "predecessor_cancelled",
+                            "predecessor_interrupted",
+                            "predecessor_needs_input",
+                            "predecessor_incomplete",
+                            "predecessor_facts_unavailable",
+                            "predecessor_work_unverified",
+                            "predecessor_checks_failed",
+                            "predecessor_review_blocked",
+                            "predecessor_output_unavailable",
+                            "settlement_unknown",
+                            "stop_requested",
+                            "shutdown",
+                            "restart_requires_controller",
+                            "partition_retired",
+                            "admission_refused"
+                          ]
+                        },
+                        "problem": {
+                          "type": "object",
+                          "properties": {
+                            "message": {
+                              "type": "string",
+                              "description": "Human-readable refusal message."
+                            },
+                            "code": {
+                              "type": [
+                                "string",
+                                "null"
+                              ],
+                              "default": null,
+                              "description": "Machine-readable refusal code carried from the throwing gate; null when the failure had no typed code."
+                            },
+                            "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."
+                            },
+                            "required_actions": {
+                              "type": "array",
+                              "items": {
+                                "type": "string",
+                                "minLength": 1,
+                                "maxLength": 512
+                              },
+                              "maxItems": 16,
+                              "default": [],
+                              "description": "Bounded user actions that may make an exact retry succeed."
+                            },
+                            "context": {
+                              "type": "object",
+                              "additionalProperties": {},
+                              "default": {},
+                              "description": "Bounded typed recovery context; never arbitrary provider or environment output."
+                            }
+                          },
+                          "required": [
+                            "message"
+                          ],
+                          "additionalProperties": false,
+                          "description": "Typed, sanitized problem for a thread turn that could not start."
+                        }
+                      },
+                      "required": [
+                        "code"
+                      ],
+                      "additionalProperties": false,
+                      "description": "Stable hold. Editing, observation and readiness restoration never rearm it; inspect the predecessor result and clear before an ordinary continuation."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Stable hold. Editing, observation and readiness restoration never rearm it; inspect the predecessor result and clear before an ordinary continuation."
+                },
+                "dispatchedRevision": {
+                  "anyOf": [
+                    {
+                      "$ref": "#/definitions/McpRunWaitResult/properties/deferredMessage/anyOf/0/properties/revision"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "successorJobId": {
+                  "anyOf": [
+                    {
+                      "$ref": "#/definitions/McpRunWaitResult/properties/deferredMessage/anyOf/0/properties/draftId"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Non-empty identifier string."
+                },
+                "successorRunId": {
+                  "anyOf": [
+                    {
+                      "$ref": "#/definitions/McpRunWaitResult/properties/deferredMessage/anyOf/0/properties/draftId"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Non-empty identifier string."
+                }
+              },
+              "required": [
+                "draftId",
+                "revision",
+                "state",
+                "predecessorJobId",
+                "predecessorRunId",
+                "predecessorResult",
+                "hold",
+                "dispatchedRevision",
+                "successorJobId",
+                "successorRunId"
+              ],
+              "additionalProperties": false,
+              "description": "Compact addressed draft state, with exact predecessor result and successor handles. A terminal predecessor does not imply the draft has resolved."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Snapshot only: terminal wakeReason refers to the predecessor, never proves draft resolution."
+        },
         "runId": {
           "type": "string",
           "description": "Canonical run id; a queued job id converges to its run id once the run binds."
@@ -86,8 +265,7 @@
                     "description": "Task the run belongs to."
                   },
                   "thread_id": {
-                    "type": "string",
-                    "minLength": 1,
+                    "$ref": "#/definitions/McpRunWaitResult/properties/deferredMessage/anyOf/0/properties/draftId",
                     "description": "Thread this run is a turn of, when any."
                   },
                   "type": {

package/generated/McpStoreIdentityInput.schema.json

@@ -0,0 +1,11 @@
+{
+  "$ref": "#/definitions/McpStoreIdentityInput",
+  "definitions": {
+    "McpStoreIdentityInput": {
+      "type": "object",
+      "properties": {},
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/McpUploadCreateInput.schema.json

@@ -0,0 +1,54 @@
+{
+  "$ref": "#/definitions/McpUploadCreateInput",
+  "definitions": {
+    "McpUploadCreateInput": {
+      "type": "object",
+      "properties": {
+        "request": {
+          "type": "object",
+          "properties": {
+            "kind": {
+              "type": "string",
+              "enum": [
+                "image",
+                "file"
+              ],
+              "description": "Kind of attached resource: image input or generic file bytes."
+            },
+            "mime": {
+              "type": "string",
+              "minLength": 1
+            },
+            "name": {
+              "type": "string",
+              "default": ""
+            },
+            "sizeBytes": {
+              "type": "integer",
+              "minimum": 0
+            }
+          },
+          "required": [
+            "kind",
+            "mime",
+            "sizeBytes"
+          ],
+          "additionalProperties": false
+        },
+        "idempotencyKey": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "\\S",
+          "maxLength": 256,
+          "description": "Caller-owned key for this exact stage. Save key and body before calling; replay both after an unknown response."
+        }
+      },
+      "required": [
+        "request",
+        "idempotencyKey"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/McpUploadFinalizeInput.schema.json

@@ -0,0 +1,40 @@
+{
+  "$ref": "#/definitions/McpUploadFinalizeInput",
+  "definitions": {
+    "McpUploadFinalizeInput": {
+      "type": "object",
+      "properties": {
+        "uploadId": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Non-empty identifier string."
+        },
+        "request": {
+          "type": "object",
+          "properties": {
+            "expectedSha256": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Content hash in algo:hex form, e.g. \"sha256:abcd...\"."
+            }
+          },
+          "additionalProperties": false
+        },
+        "idempotencyKey": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "\\S",
+          "maxLength": 256,
+          "description": "Caller-owned key for this exact stage. Save key and body before calling; replay both after an unknown response."
+        }
+      },
+      "required": [
+        "uploadId",
+        "request",
+        "idempotencyKey"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/McpUploadImportInput.schema.json

@@ -0,0 +1,52 @@
+{
+  "$ref": "#/definitions/McpUploadImportInput",
+  "definitions": {
+    "McpUploadImportInput": {
+      "type": "object",
+      "properties": {
+        "expectedStoreId": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Store UUID from the opt-in handshake, saved with the key BEFORE the first import and replayed unchanged; never replaced by the current store. A different store is refused before any effect."
+        },
+        "path": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "\\S",
+          "description": "Explicit absolute regular file on the MCP-server host, never the remote client's filesystem."
+        },
+        "idempotencyKey": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "\\S",
+          "maxLength": 256,
+          "description": "Caller-owned key for this one import. Save it with the exact arguments before calling and repeat both after any uncertainty; a completed import returns its original resource without reading the file again. A new edition of the file needs a new key."
+        },
+        "kind": {
+          "type": "string",
+          "enum": [
+            "image",
+            "file"
+          ],
+          "description": "Default: image when the effective MIME type starts with image/, otherwise file."
+        },
+        "mime": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Default from the file extension (unknown extensions are application/octet-stream)."
+        },
+        "name": {
+          "type": "string",
+          "description": "Display name. Default: the file's base name."
+        }
+      },
+      "required": [
+        "expectedStoreId",
+        "path",
+        "idempotencyKey"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}