@claudexor/schema 5.1.0 → 6.1.1

package/generated/ControlRunDetail.schema.json

@@ -9,6 +9,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": {
                 "type": "string",
                 "minLength": 1,
@@ -706,6 +741,17 @@
                 {
                   "type": "object",
                   "properties": {
+                    "lastVendorError": {
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "maxLength": 1000
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
                     "requestRefusal": {
                       "anyOf": [
                         {
@@ -1330,6 +1376,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,
@@ -2587,6 +2638,11 @@
               "default": false,
               "description": "True while at least one interactive question awaits answer, timeout, run-terminal, or interruption release."
             },
+            "asyncQuestionsOnly": {
+              "type": "boolean",
+              "default": false,
+              "description": "True while questions are pending and every one is async: the agent keeps working and the questions are attention only. False when none is pending or any pending question is blocking."
+            },
             "processScope": {
               "anyOf": [
                 {
@@ -5030,7 +5086,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": [

package/generated/ControlRunListResponse.schema.json

@@ -521,6 +521,17 @@
                   {
                     "type": "object",
                     "properties": {
+                      "lastVendorError": {
+                        "anyOf": [
+                          {
+                            "type": "string",
+                            "maxLength": 1000
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ]
+                      },
                       "requestRefusal": {
                         "anyOf": [
                           {
@@ -1145,6 +1156,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,
@@ -2409,6 +2425,11 @@
                 "default": false,
                 "description": "True while at least one interactive question awaits answer, timeout, run-terminal, or interruption release."
               },
+              "asyncQuestionsOnly": {
+                "type": "boolean",
+                "default": false,
+                "description": "True while questions are pending and every one is async: the agent keeps working and the questions are attention only. False when none is pending or any pending question is blocking."
+              },
               "processScope": {
                 "anyOf": [
                   {

package/generated/ControlRunMessageResponse.schema.json

@@ -35,7 +35,7 @@
             "transport_lost",
             "response_timeout"
           ],
-          "description": "Why the outcome is not delivered: no_active_turn (the harness has no active native turn), run_terminal, attempt_mismatch (expectedAttemptId is not the live attempt), no_live_session (no registered live attempt, no adapter channel, or no native session yet), multi_attempt (several live attempts and no expectedAttemptId), thread_bound (thread turns are not steerable in v1), interaction_pending (a question is open; the message was not sent), rpc_refused (the vendor refused the steer on a still-active turn), admission_persist_failed (the daemon could not journal admission; nothing was sent), transport_lost, response_timeout."
+          "description": "Why the outcome is not delivered: no_active_turn (the harness has no active native turn), run_terminal, attempt_mismatch (expectedAttemptId is not the live attempt), no_live_session (no registered live attempt, no adapter channel, or no native session yet), multi_attempt (several live attempts and no expectedAttemptId), thread_bound (thread turns are not steerable in v1), interaction_pending (a blocking question is open; the message was not sent), rpc_refused (the vendor refused the steer on a still-active turn), admission_persist_failed (the daemon could not journal admission; nothing was sent), transport_lost, response_timeout."
         },
         "runId": {
           "type": "string",

package/generated/ControlRunSummary.schema.json

@@ -516,6 +516,17 @@
             {
               "type": "object",
               "properties": {
+                "lastVendorError": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "maxLength": 1000
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
                 "requestRefusal": {
                   "anyOf": [
                     {
@@ -1140,6 +1151,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,
@@ -2404,6 +2420,11 @@
           "default": false,
           "description": "True while at least one interactive question awaits answer, timeout, run-terminal, or interruption release."
         },
+        "asyncQuestionsOnly": {
+          "type": "boolean",
+          "default": false,
+          "description": "True while questions are pending and every one is async: the agent keeps working and the questions are attention only. False when none is pending or any pending question is blocking."
+        },
         "processScope": {
           "anyOf": [
             {

package/generated/ControlStartLookupResponse.schema.json

@@ -0,0 +1,278 @@
+{
+  "$ref": "#/definitions/ControlStartLookupResponse",
+  "definitions": {
+    "ControlStartLookupResponse": {
+      "anyOf": [
+        {
+          "type": "object",
+          "properties": {
+            "status": {
+              "type": "string",
+              "const": "found"
+            },
+            "storeId": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Identity of the durable engine store this read answered from, stable across restarts. A lookup without a store identity is refused as unavailable instead of answering."
+            },
+            "handle": {
+              "type": "object",
+              "properties": {
+                "jobId": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "The accepted daemon job."
+                },
+                "runId": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "minLength": 1,
+                      "description": "Non-empty identifier string."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Run bound to the job at this read; null while none is bound, or for a job that ended before a run."
+                },
+                "state": {
+                  "type": "string",
+                  "enum": [
+                    "queued",
+                    "running",
+                    "succeeded",
+                    "failed",
+                    "cancelled",
+                    "interrupted"
+                  ],
+                  "description": "The job's lifecycle state at this read."
+                },
+                "runDir": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "description": "Run artifact directory; null before a run."
+                },
+                "taskId": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "description": "Task id; null before it is allocated."
+                },
+                "threadId": {
+                  "$ref": "#/definitions/ControlStartLookupResponse/anyOf/0/properties/handle/properties/runId/anyOf/0",
+                  "description": "Thread of an accepted turn."
+                },
+                "turnId": {
+                  "$ref": "#/definitions/ControlStartLookupResponse/anyOf/0/properties/handle/properties/runId/anyOf/0",
+                  "description": "The accepted turn."
+                },
+                "problem": {
+                  "type": "object",
+                  "properties": {
+                    "message": {
+                      "type": [
+                        "string",
+                        "null"
+                      ],
+                      "description": "Recorded failure message; null when none was kept."
+                    },
+                    "code": {
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "minLength": 1
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "description": "Recorded machine code; null for an untyped failure."
+                    },
+                    "status": {
+                      "anyOf": [
+                        {
+                          "type": "integer",
+                          "minimum": 400,
+                          "maximum": 599
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "description": "HTTP status the start route answers for this failure; null when none is recorded."
+                    },
+                    "retryable": {
+                      "type": [
+                        "boolean",
+                        "null"
+                      ],
+                      "description": "The recorded retryability; null when the producer made no claim."
+                    },
+                    "requiredActions": {
+                      "type": "array",
+                      "items": {
+                        "type": "string",
+                        "minLength": 1
+                      },
+                      "description": "Bounded actions recorded with the failure."
+                    },
+                    "context": {
+                      "type": "object",
+                      "additionalProperties": {},
+                      "description": "Bounded recorded context; store and task-group identity are not repeated here."
+                    }
+                  },
+                  "required": [
+                    "message",
+                    "code",
+                    "status",
+                    "retryable",
+                    "requiredActions",
+                    "context"
+                  ],
+                  "additionalProperties": false,
+                  "description": "The refusal or failure an accepted job records. A lookup returns it with HTTP 200; it is the job's outcome, not a failure of the read."
+                }
+              },
+              "required": [
+                "jobId",
+                "runId",
+                "state"
+              ],
+              "additionalProperties": false,
+              "description": "Durable handle of the job a start request created, read without waiting for it."
+            }
+          },
+          "required": [
+            "status",
+            "storeId",
+            "handle"
+          ],
+          "additionalProperties": false,
+          "description": "The store retains the job this exact key and request created."
+        },
+        {
+          "type": "object",
+          "properties": {
+            "status": {
+              "type": "string",
+              "const": "turn_only"
+            },
+            "storeId": {
+              "$ref": "#/definitions/ControlStartLookupResponse/anyOf/0/properties/storeId"
+            },
+            "threadId": {
+              "$ref": "#/definitions/ControlStartLookupResponse/anyOf/0/properties/handle/properties/runId/anyOf/0"
+            },
+            "turnId": {
+              "type": "string",
+              "minLength": 1,
+              "description": "The turn this exact key and request recorded."
+            },
+            "runId": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/ControlStartLookupResponse/anyOf/0/properties/handle/properties/runId/anyOf/0"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Run bound to the turn; observe exactly this run. Null when no run is bound."
+            },
+            "enqueueError": {
+              "anyOf": [
+                {
+                  "type": "object",
+                  "properties": {
+                    "message": {
+                      "type": "string",
+                      "description": "Human-readable refusal message."
+                    },
+                    "code": {
+                      "type": [
+                        "string",
+                        "null"
+                      ],
+                      "default": null,
+                      "description": "Machine-readable refusal code; remedies key on it, never on the message text."
+                    },
+                    "retryable": {
+                      "type": "boolean",
+                      "default": true,
+                      "description": "False when no recorded job exists to replay — surfaces offer a new message instead of a doomed retry."
+                    },
+                    "requiredActions": {
+                      "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 for exact retry."
+                    },
+                    "failedAt": {
+                      "type": "string",
+                      "description": "When the enqueue failed."
+                    }
+                  },
+                  "required": [
+                    "message",
+                    "failedAt"
+                  ],
+                  "additionalProperties": false
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "description": "Why this turn has no run (enqueue/preflight refusal); null once a run binds."
+            }
+          },
+          "required": [
+            "status",
+            "storeId",
+            "threadId",
+            "turnId",
+            "runId"
+          ],
+          "additionalProperties": false,
+          "description": "The store retains the turn this exact key and request recorded, but no command bound to them: the enqueue failed or never happened, or retention removed the command. Nothing is enqueued for it."
+        },
+        {
+          "type": "object",
+          "properties": {
+            "status": {
+              "type": "string",
+              "const": "not_found"
+            },
+            "storeId": {
+              "$ref": "#/definitions/ControlStartLookupResponse/anyOf/0/properties/storeId"
+            }
+          },
+          "required": [
+            "status",
+            "storeId"
+          ],
+          "additionalProperties": false,
+          "description": "This store's current partition retains no binding for this key and request. It never proves that the original request was not accepted and never authorizes a new start."
+        }
+      ],
+      "description": "Read-only lookup of an accepted run or thread-turn start by its original request and Idempotency-Key."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlThreadDetail.schema.json

@@ -723,6 +723,11 @@
                         "default": false,
                         "description": "True while an interactive question is awaiting the user's answer."
                       },
+                      "asyncQuestionsOnly": {
+                        "type": "boolean",
+                        "default": false,
+                        "description": "True while questions are pending and every one is async (the agent keeps working); false when none is pending or any is blocking."
+                      },
                       "finishedAt": {
                         "type": [
                           "string",

package/generated/HarnessEvent.schema.json

@@ -4,6 +4,38 @@
     "HarnessEvent": {
       "type": "object",
       "properties": {
+        "program": {
+          "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
+        },
         "request_refusal": {
           "anyOf": [
             {
@@ -821,6 +853,15 @@
               ],
               "default": null,
               "description": "Native tool that raised the request (e.g. \"AskUserQuestion\")."
+            },
+            "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": [
@@ -1492,7 +1533,7 @@
               "enum": [
                 "unknown"
               ],
-              "description": "unknown: the vendor's own typed code refused further usage on this account and named no reopening time, and the refusal is not known to be a timed window (Codex usage_limit_exceeded also covers a workspace out of credits). No reset is derived from it and the same account is never retried for it. Absent: resets_at, retry_delay_ms and the vendor's window say when to come back, as before."
+              "description": "unknown: the vendor's own typed code refused further usage on this account and named no reopening time, and the refusal is not known to be a timed window (Codex usage_limit_exceeded and AGY's structured `Individual quota reached` also cover refusals whose scope is not a timed window). No reset is derived from it; the vendor's original failure evidence remains alongside the signal. Admission/continuation consumers decide whether the account is retried, and a typed refusal must not be mistaken for a transport failure. Absent: resets_at, retry_delay_ms and the vendor's window say when to come back, as before."
             }
           },
           "additionalProperties": false,

package/generated/HarnessManifest.schema.json

@@ -4,6 +4,32 @@
     "HarnessManifest": {
       "type": "object",
       "properties": {
+        "sourceProgram": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "path": {
+                  "type": "string"
+                },
+                "version": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                }
+              },
+              "required": [
+                "path",
+                "version"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
         "id": {
           "type": "string",
           "minLength": 1,