@claudexor/schema 4.7.0 → 4.8.1

package/generated/ControlRunDetail.schema.json

@@ -806,9 +806,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",
@@ -908,6 +937,7 @@
                             "credential_pool_exhausted",
                             "input_too_large",
                             "vendor_cli_too_old",
+                            "credential_source_unconfirmed",
                             "delegated_home_unavailable",
                             "delegated_confinement_unavailable",
                             "delegated_evidence_incomplete",
@@ -2389,6 +2419,183 @@
           "additionalProperties": false,
           "description": "Run summary row served by GET /runs and embedded in run detail: state, routing, budget, policies, and honest outcome."
         },
+        "deferredMessage": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "draftId": {
+                  "$ref": "#/definitions/ControlRunDetail/properties/attemptExecution/items/properties/attemptId"
+                },
+                "revision": {
+                  "type": "integer",
+                  "exclusiveMinimum": 0,
+                  "maximum": 9007199254740991
+                },
+                "state": {
+                  "type": "string",
+                  "enum": [
+                    "waiting",
+                    "held",
+                    "dispatched",
+                    "cleared"
+                  ]
+                },
+                "predecessorJobId": {
+                  "$ref": "#/definitions/ControlRunDetail/properties/attemptExecution/items/properties/attemptId"
+                },
+                "predecessorRunId": {
+                  "anyOf": [
+                    {
+                      "$ref": "#/definitions/ControlRunDetail/properties/attemptExecution/items/properties/attemptId"
+                    },
+                    {
+                      "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/ControlRunDetail/properties/deferredMessage/anyOf/0/properties/revision"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "successorJobId": {
+                  "anyOf": [
+                    {
+                      "$ref": "#/definitions/ControlRunDetail/properties/attemptExecution/items/properties/attemptId"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Non-empty identifier string."
+                },
+                "successorRunId": {
+                  "anyOf": [
+                    {
+                      "$ref": "#/definitions/ControlRunDetail/properties/attemptExecution/items/properties/attemptId"
+                    },
+                    {
+                      "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."
+        },
         "children": {
           "type": "array",
           "items": {

package/generated/ControlRunListResponse.schema.json

@@ -621,9 +621,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",
@@ -723,6 +752,7 @@
                               "credential_pool_exhausted",
                               "input_too_large",
                               "vendor_cli_too_old",
+                              "credential_source_unconfirmed",
                               "delegated_home_unavailable",
                               "delegated_confinement_unavailable",
                               "delegated_evidence_incomplete",

package/generated/ControlRunRetryResponse.schema.json

@@ -4,6 +4,16 @@
     "ControlRunRetryResponse": {
       "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."
+        },
         "retryOf": {
           "type": "string",
           "minLength": 1,

package/generated/ControlRunStartInfo.schema.json

@@ -4,6 +4,16 @@
     "ControlRunStartInfo": {
       "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."
+        },
         "jobId": {
           "type": "string",
           "description": "Daemon job id backing the run."

package/generated/ControlRunStartRequest.schema.json

@@ -42,6 +42,11 @@
           "description": "Canonical run mode: ask and plan are read-only, agent writes. Strategy controls are separate schema-owned fields, never modes.",
           "default": "agent"
         },
+        "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."
+        },
         "scope": {
           "anyOf": [
             {

package/generated/ControlRunStartResponse.schema.json

@@ -6,6 +6,16 @@
         {
           "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."
+            },
             "jobId": {
               "type": "string",
               "description": "Daemon job id backing the run."
@@ -33,6 +43,14 @@
         {
           "type": "object",
           "properties": {
+            "taskGroupId": {
+              "$ref": "#/definitions/ControlRunStartResponse/anyOf/0/properties/taskGroupId",
+              "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": {
+              "$ref": "#/definitions/ControlRunStartResponse/anyOf/0/properties/storeId",
+              "description": "Identity of the durable engine store that accepted this group member, stable across restarts."
+            },
             "jobId": {
               "type": "string",
               "description": "Daemon job id."

package/generated/ControlRunSummary.schema.json

@@ -616,9 +616,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",
@@ -718,6 +747,7 @@
                         "credential_pool_exhausted",
                         "input_too_large",
                         "vendor_cli_too_old",
+                        "credential_source_unconfirmed",
                         "delegated_home_unavailable",
                         "delegated_confinement_unavailable",
                         "delegated_evidence_incomplete",

package/generated/ControlSetupJob.schema.json

@@ -15,7 +15,8 @@
             "codex",
             "claude",
             "cursor",
-            "agy"
+            "agy",
+            "grok"
           ],
           "description": "Harness ids with a managed native-login flow."
         },

package/generated/ControlSetupJobCreateRequest.schema.json

@@ -10,7 +10,8 @@
             "codex",
             "claude",
             "cursor",
-            "agy"
+            "agy",
+            "grok"
           ],
           "description": "Harness ids with a managed native-login flow."
         },

package/generated/ControlSetupJobEvent.schema.json

@@ -82,7 +82,8 @@
                     "codex",
                     "claude",
                     "cursor",
-                    "agy"
+                    "agy",
+                    "grok"
                   ],
                   "description": "Harness ids with a managed native-login flow."
                 },

package/generated/ControlSetupJobListFilter.schema.json

@@ -10,7 +10,8 @@
             "codex",
             "claude",
             "cursor",
-            "agy"
+            "agy",
+            "grok"
           ],
           "description": "Harness ids with a managed native-login flow."
         },

package/generated/ControlSetupJobListResponse.schema.json

@@ -20,7 +20,8 @@
                   "codex",
                   "claude",
                   "cursor",
-                  "agy"
+                  "agy",
+                  "grok"
                 ],
                 "description": "Harness ids with a managed native-login flow."
               },

package/generated/ControlSetupJobSnapshot.schema.json

@@ -20,7 +20,8 @@
                     "codex",
                     "claude",
                     "cursor",
-                    "agy"
+                    "agy",
+                    "grok"
                   ],
                   "description": "Harness ids with a managed native-login flow."
                 },

package/generated/ControlUploadImport.schema.json

@@ -0,0 +1,124 @@
+{
+  "$ref": "#/definitions/ControlUploadImport",
+  "definitions": {
+    "ControlUploadImport": {
+      "type": "object",
+      "properties": {
+        "storeId": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Durable store that owns this import key and its resource."
+        },
+        "state": {
+          "type": "string",
+          "enum": [
+            "open",
+            "uploading",
+            "ready",
+            "cancelled"
+          ],
+          "description": "open: send the bound bytes; uploading: a transfer is in flight; ready: resource is published; cancelled: finished without a resource, a new attempt needs a new key."
+        },
+        "uploadId": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Upload that receives this import's bytes."
+        },
+        "content": {
+          "type": "object",
+          "properties": {
+            "sizeBytes": {
+              "type": "integer",
+              "minimum": 0,
+              "description": "Exact byte length."
+            },
+            "sha256": {
+              "type": "string",
+              "pattern": "^sha256:[a-f0-9]{64}$",
+              "description": "Exact digest of the bytes: \"sha256:\" and 64 lowercase hex digits."
+            }
+          },
+          "required": [
+            "sizeBytes",
+            "sha256"
+          ],
+          "additionalProperties": false,
+          "description": "Exact bytes a keyed import owns, bound by its first accepted declaration."
+        },
+        "receivedBytes": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "resource": {
+          "type": "object",
+          "properties": {
+            "resourceId": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Non-empty identifier string."
+            },
+            "purpose": {
+              "type": "string",
+              "const": "model",
+              "description": "Immutable model-operation purpose; absent means a legacy or ordinary attachment."
+            },
+            "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"
+            },
+            "sha256": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Content hash in algo:hex form, e.g. \"sha256:abcd...\"."
+            },
+            "sizeBytes": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "createdAt": {
+              "type": "string",
+              "minLength": 1,
+              "description": "ISO-8601 timestamp string."
+            },
+            "deduplicated": {
+              "type": "boolean"
+            }
+          },
+          "required": [
+            "resourceId",
+            "kind",
+            "mime",
+            "name",
+            "sha256",
+            "sizeBytes",
+            "createdAt",
+            "deduplicated"
+          ],
+          "additionalProperties": false,
+          "description": "The immutable resource, present exactly when state is ready."
+        }
+      },
+      "required": [
+        "storeId",
+        "state",
+        "uploadId",
+        "content",
+        "receivedBytes"
+      ],
+      "additionalProperties": false,
+      "description": "Current state of one keyed import, identical for its first call and every replay."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlUploadImportRequest.schema.json

@@ -0,0 +1,66 @@
+{
+  "$ref": "#/definitions/ControlUploadImportRequest",
+  "definitions": {
+    "ControlUploadImportRequest": {
+      "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."
+        },
+        "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": ""
+        },
+        "source": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 4096,
+          "description": "Opaque caller identity of the selected source, such as the absolute path a local client read or a task artifact id. Bound into the key only; the daemon never reads, resolves, stores or returns it."
+        },
+        "content": {
+          "type": "object",
+          "properties": {
+            "sizeBytes": {
+              "type": "integer",
+              "minimum": 0,
+              "description": "Exact byte length."
+            },
+            "sha256": {
+              "type": "string",
+              "pattern": "^sha256:[a-f0-9]{64}$",
+              "description": "Exact digest of the bytes: \"sha256:\" and 64 lowercase hex digits."
+            }
+          },
+          "required": [
+            "sizeBytes",
+            "sha256"
+          ],
+          "additionalProperties": false,
+          "description": "Required to begin an import. Omit it to read or replay an already bound key without touching the source."
+        }
+      },
+      "required": [
+        "expectedStoreId",
+        "kind",
+        "mime"
+      ],
+      "additionalProperties": false,
+      "description": "Keyed import of one ordinary attachment through the upload owner."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}