@claudexor/schema 4.6.2 → 4.8.1

package/generated/ControlRunControlResponse.schema.json

@@ -35,6 +35,175 @@
         "message": {
           "type": "string",
           "description": "Human-readable detail."
+        },
+        "deferredMessage": {
+          "type": "object",
+          "properties": {
+            "draftId": {
+              "$ref": "#/definitions/ControlRunControlResponse/properties/runId"
+            },
+            "revision": {
+              "type": "integer",
+              "exclusiveMinimum": 0,
+              "maximum": 9007199254740991
+            },
+            "state": {
+              "type": "string",
+              "enum": [
+                "waiting",
+                "held",
+                "dispatched",
+                "cleared"
+              ]
+            },
+            "predecessorJobId": {
+              "$ref": "#/definitions/ControlRunControlResponse/properties/runId"
+            },
+            "predecessorRunId": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/ControlRunControlResponse/properties/runId"
+                },
+                {
+                  "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/ControlRunControlResponse/properties/deferredMessage/properties/revision"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "successorJobId": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/ControlRunControlResponse/properties/runId"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Non-empty identifier string."
+            },
+            "successorRunId": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/ControlRunControlResponse/properties/runId"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Non-empty identifier string."
+            }
+          },
+          "required": [
+            "draftId",
+            "revision",
+            "state",
+            "predecessorJobId",
+            "predecessorRunId",
+            "predecessorResult",
+            "hold",
+            "dispatchedRevision",
+            "successorJobId",
+            "successorRunId"
+          ],
+          "additionalProperties": false,
+          "description": "The run's latest next-message draft after this cancel: a waiting draft is held by the same call; an already accepted successor is named, not cancelled."
         }
       },
       "required": [

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,10 +937,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."
@@ -2388,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,10 +752,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/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": [
             {
@@ -132,6 +137,14 @@
                 "minLength": 1
               },
               "description": "Agent-selected input footprint. Directory copies materialize this entire selection; direct runs need no whole-tree baseline."
+            },
+            "auxiliaryWritableRoots": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1
+              },
+              "description": "Exact existing absolute directories, created by the caller, that an Agent run with effective workspace_write may also write (service caches or scratch outside the execution tree). [] grants nothing extra; so does omission, except that a continueFrom successor omitting execution inherits its predecessor's whole execution group. Requires a lane whose capability_profile.access_control.auxiliary_writable_roots is true; the files are never part of the project result."
             }
           },
           "additionalProperties": false,

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,10 +747,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/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."
         },