@claudexor/schema 4.3.1 → 4.4.0

package/generated/McpRunHandleResult.schema.json

@@ -1667,6 +1667,388 @@
           "description": "Typed Delegate receipt; null when unavailable or legacy.",
           "default": null
         },
+        "continueFrom": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/McpRunHandleResult/properties/attemptExecution/items/properties/attemptId"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Predecessor run this run continues; null for an ordinary run, omitted when the detail did not project it."
+        },
+        "resumable": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "cause": {
+                  "type": "string",
+                  "enum": [
+                    "vendor_limit",
+                    "pool_exhausted",
+                    "pinned_limit",
+                    "transport",
+                    "permission_denied",
+                    "context_exhausted",
+                    "wall_clock",
+                    "cancelled",
+                    "host_restart",
+                    "input_required",
+                    "other"
+                  ],
+                  "description": "Typed reason the previous process stopped: a vendor limit (next account eligible), the whole pool spent, a pinned account's limit, a transport death (crash, timeout, watchdog), a confirmed native tool permission refusal, context exhaustion, the wall-clock deadline, a cancel, a daemon/host restart, a model that asked for input, or another typed cause."
+                },
+                "resetsAt": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "description": "When the spent vendor window reopens, only from a vendor signal; never fabricated."
+                },
+                "limitWindow": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "description": "The vendor's own name for the spent window (e.g. five_hour, seven_day_opus), when known."
+                },
+                "limitEvidence": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "enum": [
+                        "window",
+                        "unspecified"
+                      ],
+                      "description": "window: the vendor named the spent window (a reset instant or a constraint id); unspecified: a typed limit without a window — a bare backoff frame is transport, not a limit."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "window: the vendor named the spent window (a reset instant or a constraint id); unspecified: a typed limit without a window — a bare backoff frame is transport, not a limit."
+                },
+                "carriers": {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "enum": [
+                      "native",
+                      "native_moved",
+                      "packet"
+                    ],
+                    "description": "A continuity representation still available for a stopped run."
+                  },
+                  "description": "Continuity representations still available (NOT quota readiness; readiness is described by the limit facts)."
+                },
+                "limitCode": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "description": "The typed vendor limit code that ended the work, when any."
+                },
+                "session": {
+                  "anyOf": [
+                    {
+                      "type": "object",
+                      "properties": {
+                        "harness": {
+                          "$ref": "#/definitions/McpRunHandleResult/properties/attemptExecution/items/properties/attemptId"
+                        },
+                        "nativeSessionId": {
+                          "type": "string",
+                          "minLength": 1
+                        },
+                        "holderProfileId": {
+                          "anyOf": [
+                            {
+                              "$ref": "#/definitions/McpRunHandleResult/properties/attemptExecution/items/properties/attemptId"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ],
+                          "description": "Non-empty identifier string."
+                        }
+                      },
+                      "required": [
+                        "harness",
+                        "nativeSessionId",
+                        "holderProfileId"
+                      ],
+                      "additionalProperties": false
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "The native session a continuation can resume, when one exists."
+                },
+                "workspace": {
+                  "type": "object",
+                  "properties": {
+                    "kind": {
+                      "type": "string",
+                      "enum": [
+                        "in_place",
+                        "retained_envelope",
+                        "none"
+                      ]
+                    },
+                    "root": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "kind",
+                    "root"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Where the stopped work's tree is: the live root, a retained envelope, or gone."
+                }
+              },
+              "required": [
+                "cause",
+                "resetsAt",
+                "limitWindow",
+                "limitEvidence",
+                "carriers",
+                "limitCode",
+                "session",
+                "workspace"
+              ],
+              "additionalProperties": false,
+              "description": "Terminal facts of a stopped run that can be continued: cause, limit evidence, available carriers, the native session and the workspace."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Terminal facts of stopped unfinished work that claudexor_run_continue can continue (cause, resetsAt, carriers, session, workspace); null when the work finished or the run is not terminal, omitted when not projected."
+        },
+        "continuity": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "tryIndex": {
+                "type": "integer",
+                "minimum": 0,
+                "description": "Native try within the attempt; joins the receipt to its try."
+              },
+              "attemptId": {
+                "$ref": "#/definitions/McpRunHandleResult/properties/attemptExecution/items/properties/attemptId"
+              },
+              "carrier": {
+                "type": "string",
+                "enum": [
+                  "native",
+                  "native_moved",
+                  "packet",
+                  "fresh"
+                ],
+                "description": "Carrier of a continued try: native (the vendor's own session, same account), native_moved (the session file made visible in the next account's store, then resumed there), packet (a fresh session re-grounded by an evidence index), or fresh (nothing to carry — a replay of the original prompt)."
+              },
+              "cause": {
+                "$ref": "#/definitions/McpRunHandleResult/properties/resumable/anyOf/0/properties/cause"
+              },
+              "from": {
+                "type": "object",
+                "properties": {
+                  "runId": {
+                    "$ref": "#/definitions/McpRunHandleResult/properties/attemptExecution/items/properties/attemptId"
+                  },
+                  "attemptId": {
+                    "$ref": "#/definitions/McpRunHandleResult/properties/attemptExecution/items/properties/attemptId"
+                  },
+                  "profileId": {
+                    "anyOf": [
+                      {
+                        "$ref": "#/definitions/McpRunHandleResult/properties/attemptExecution/items/properties/attemptId"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ],
+                    "description": "Non-empty identifier string."
+                  }
+                },
+                "required": [
+                  "runId",
+                  "attemptId",
+                  "profileId"
+                ],
+                "additionalProperties": false
+              },
+              "to": {
+                "type": "object",
+                "properties": {
+                  "profileId": {
+                    "anyOf": [
+                      {
+                        "$ref": "#/definitions/McpRunHandleResult/properties/attemptExecution/items/properties/attemptId"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ],
+                    "description": "Non-empty identifier string."
+                  }
+                },
+                "required": [
+                  "profileId"
+                ],
+                "additionalProperties": false
+              },
+              "workspace": {
+                "type": "string",
+                "enum": [
+                  "same_root",
+                  "different_root"
+                ],
+                "description": "Whether the continued try runs in the predecessor's execution root."
+              },
+              "memory": {
+                "type": "string",
+                "enum": [
+                  "full",
+                  "partial",
+                  "unknown"
+                ],
+                "description": "Its own fact: a native resume carries the whole history (full); a packet re-brief is partial; a native resume that lost history (e.g. a rejected compacted item) is partial/unknown."
+              },
+              "instructions": {
+                "type": "string",
+                "enum": [
+                  "as_sent",
+                  "vendor_snapshot"
+                ],
+                "description": "as_sent: the successor's instructions equal the predecessor's; vendor_snapshot: they differ, and the vendor may resend its recorded system prompt instead (claude records it on the first request)."
+              },
+              "reingestedTokens": {
+                "anyOf": [
+                  {
+                    "type": "integer",
+                    "minimum": 0
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "Input + cache-creation tokens of the first resumed request, when known."
+              },
+              "observedModel": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "description": "THIS try's attested model (never borrowed from another try)."
+              },
+              "modelMismatch": {
+                "type": [
+                  "boolean",
+                  "null"
+                ]
+              },
+              "identityCheck": {
+                "type": "string",
+                "enum": [
+                  "matched_before_effects",
+                  "mismatch_before_effects",
+                  "mismatch_after_possible_effects",
+                  "not_applicable"
+                ],
+                "description": "Whether the resumed vendor session was the one requested, judged at the earliest handshake (codex thread/resume before turn/start; claude system/init): matched, mismatch caught before the child could act, mismatch caught after it may have acted, or not applicable (no resume was requested, or a harness without the continuity capability answered with another session id, which is recorded as before)."
+              },
+              "inputDelivery": {
+                "type": "string",
+                "enum": [
+                  "confirmed",
+                  "uncertain",
+                  "not_applicable"
+                ],
+                "description": "Whether the predecessor's last input (its turn prompt or an admitted steering message) is known to be in the vendor history: confirmed, uncertain (carried in the notice as a reference to reconcile, never replayed blindly), or not applicable."
+              }
+            },
+            "required": [
+              "tryIndex",
+              "attemptId",
+              "carrier",
+              "cause",
+              "from",
+              "to",
+              "workspace",
+              "memory",
+              "instructions",
+              "reingestedTokens",
+              "observedModel",
+              "modelMismatch",
+              "identityCheck",
+              "inputDelivery"
+            ],
+            "additionalProperties": false,
+            "description": "Receipt of one continued try: carrier, cause, accounts, memory, model attestation."
+          },
+          "description": "Per-try continuation receipts (carrier, cause, accounts, model) from the run's event log; omitted when not projected."
+        },
+        "retainedEnvelope": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "root": {
+                  "type": "string",
+                  "description": "Absolute path of the kept working tree."
+                },
+                "bytes": {
+                  "anyOf": [
+                    {
+                      "type": "integer",
+                      "minimum": 0
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Disk use of the kept envelope (tree + scoped home); null when not measured."
+                },
+                "retainedAt": {
+                  "type": "string",
+                  "description": "When the envelope was kept."
+                },
+                "cause": {
+                  "anyOf": [
+                    {
+                      "$ref": "#/definitions/McpRunHandleResult/properties/resumable/anyOf/0/properties/cause"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Why the run stopped, when recorded."
+                }
+              },
+              "required": [
+                "root",
+                "bytes",
+                "retainedAt",
+                "cause"
+              ],
+              "additionalProperties": false,
+              "description": "An isolated envelope kept for continuation: continue it with continueFrom, or release it with the discard decision."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Isolated envelope kept for a successor (disk use visible); null when none, omitted when not projected."
+        },
         "detailProblem": {
           "anyOf": [
             {

package/generated/McpRunToolResult.schema.json

@@ -202,7 +202,15 @@
             "string",
             "null"
           ],
-          "description": "Daemon run id (recovery handle for inspect/follow/apply/decision); null for in-process read-only runs."
+          "description": "Daemon run id once the accepted job started a run (recovery handle for inspect/follow/apply/decision); null while the job is still queued or after it failed before a run started."
+        },
+        "jobId": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "default": null,
+          "description": "Daemon job id of the accepted launch. While runId is null, pass it as runId to the status, wait and result tools; they report the canonical runId once the run binds."
         },
         "runDir": {
           "type": [
@@ -216,7 +224,7 @@
             "string",
             "null"
           ],
-          "description": "Terminal run LIFECYCLE (succeeded | failed | cancelled | interrupted)."
+          "description": "Run lifecycle state (queued | running | succeeded | failed | cancelled | interrupted); null when an accepted job's state could not be read."
         },
         "runFacts": {
           "anyOf": [

package/generated/McpRunWaitInput.schema.json

@@ -0,0 +1,50 @@
+{
+  "$ref": "#/definitions/McpRunWaitInput",
+  "definitions": {
+    "McpRunWaitInput": {
+      "type": "object",
+      "properties": {
+        "runId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256,
+          "description": "Run id, or the job id of an accepted launch that may still be queued."
+        },
+        "afterSeq": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991,
+          "default": 0,
+          "description": "Last durable event seq already consumed (the previous nextSeq), never snapshotSeq."
+        },
+        "waitMs": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 50000,
+          "default": 25000,
+          "description": "Bound of the event stage. Zero never waits for new events: it returns the bounded page already available at the snapshot fence, read within a separate 5s budget. Daemon discovery and each snapshot read have their own 5s budgets, so one call can take up to waitMs plus about 15s."
+        },
+        "maxEvents": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 200,
+          "default": 50
+        },
+        "wake": {
+          "type": "string",
+          "enum": [
+            "batch",
+            "event"
+          ],
+          "default": "batch",
+          "description": "batch (default): collect events until the page fills, it includes a question event (interaction.requested, also one written before the wait), the run ends, or waitMs elapses. event: return as soon as any event is available. A pending question whose event is not in the page is reported in both modes but never ends a wait by itself."
+        }
+      },
+      "required": [
+        "runId"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}