@claudexor/schema 4.3.1 → 4.5.0

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#"
+}

package/generated/McpRunWaitResult.schema.json

@@ -0,0 +1,411 @@
+{
+  "$ref": "#/definitions/McpRunWaitResult",
+  "definitions": {
+    "McpRunWaitResult": {
+      "type": "object",
+      "properties": {
+        "runId": {
+          "type": "string",
+          "description": "Canonical run id; a queued job id converges to its run id once the run binds."
+        },
+        "status": {
+          "type": "string",
+          "enum": [
+            "queued",
+            "running",
+            "succeeded",
+            "failed",
+            "cancelled",
+            "interrupted"
+          ],
+          "description": "Control-plane run state = the run LIFECYCLE (D8): queued/running while live, then exactly one of succeeded / failed / cancelled / interrupted. Outcome quality (checks/review/delivery) is orthogonal — see outcomeFacts."
+        },
+        "snapshotSeq": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991,
+          "description": "Last event seq at the latest snapshot: a fence, not a cursor. nextSeq below it means events are already written; eventOmission stream_ended reports when the stream cannot serve them."
+        },
+        "snapshotPhase": {
+          "type": "string",
+          "enum": [
+            "before_wait",
+            "after_wait"
+          ]
+        },
+        "snapshotProblem": {
+          "anyOf": [
+            {
+              "type": "string",
+              "enum": [
+                "snapshot_unavailable"
+              ]
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A failed final read leaves the explicitly labelled initial snapshot, never invented current state."
+        },
+        "nextSeq": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991,
+          "description": "Last returned event seq, or afterSeq when none was returned. It never advances over an unreturned event."
+        },
+        "events": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "seq": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 9007199254740991
+              },
+              "event": {
+                "type": "object",
+                "properties": {
+                  "seq": {
+                    "type": "integer",
+                    "exclusiveMinimum": 0,
+                    "description": "Monotonic per-run sequence stamped at emit time; the durable SSE cursor and snapshot fence. Optional only for pre-v0.8.0 artifacts."
+                  },
+                  "ts": {
+                    "type": "string",
+                    "description": "Event timestamp."
+                  },
+                  "run_id": {
+                    "type": "string",
+                    "minLength": 1,
+                    "description": "Run the event belongs to."
+                  },
+                  "task_id": {
+                    "type": "string",
+                    "minLength": 1,
+                    "description": "Task the run belongs to."
+                  },
+                  "thread_id": {
+                    "type": "string",
+                    "minLength": 1,
+                    "description": "Thread this run is a turn of, when any."
+                  },
+                  "type": {
+                    "type": "string",
+                    "enum": [
+                      "run.created",
+                      "task.contract.created",
+                      "context.pack.created",
+                      "project.git.initialized",
+                      "project.claude_bridge.created",
+                      "budget.lease.created",
+                      "budget.observation",
+                      "budget.cash",
+                      "policy.web.upgraded",
+                      "harness.started",
+                      "harness.event",
+                      "harness.completed",
+                      "route.fallback.started",
+                      "route.fallback.completed",
+                      "route.fallback.exhausted",
+                      "route.transient.detected",
+                      "route.transient.retry_scheduled",
+                      "route.profile.headroom_exceeded",
+                      "route.profile.rotated",
+                      "route.profile.rotation_exhausted",
+                      "route.profile.credential_unusable",
+                      "route.account.pool_selected",
+                      "route.account.lane_switch",
+                      "route.account.pool_exhausted",
+                      "route.transient.exhausted",
+                      "route.fallback.auth_switched",
+                      "route.primary.diverged",
+                      "route.pool.degraded",
+                      "session.continuity",
+                      "interaction.requested",
+                      "interaction.answered",
+                      "interaction.timeout",
+                      "interaction.answer_discarded",
+                      "interaction.withdrawn",
+                      "message.accepted",
+                      "message.delivered",
+                      "message.refused",
+                      "plan.progress",
+                      "plan.questions",
+                      "plan.brief.materialized",
+                      "council.started",
+                      "council.draft",
+                      "council.member.failed",
+                      "council.merged",
+                      "budget.quota_pressure",
+                      "delegation.belt.unavailable",
+                      "delegation.belt.degraded",
+                      "output.ready",
+                      "gate.started",
+                      "gate.completed",
+                      "review.preflight",
+                      "review.started",
+                      "review.skipped",
+                      "reviewer.started",
+                      "reviewer.first_event",
+                      "reviewer.auth_switched",
+                      "reviewer.completed",
+                      "reviewer.timed_out",
+                      "reviewer.failed",
+                      "finding.revalidated",
+                      "synthesis.started",
+                      "arbitration.completed",
+                      "work_product.emitted",
+                      "work_product.adopted",
+                      "control.requested",
+                      "control.applied",
+                      "control.rejected",
+                      "run.blocked",
+                      "run.completed",
+                      "run.failed",
+                      "run.continuation",
+                      "run.continuation.denied",
+                      "run.continuity",
+                      "workspace.retained"
+                    ],
+                    "description": "Type of an append-only run event, covering run lifecycle, contract/context creation, budget, routing fallbacks, harness activity, interactions, gates, review, arbitration, work products, and control verbs."
+                  },
+                  "payload": {
+                    "type": "object",
+                    "additionalProperties": {},
+                    "default": {},
+                    "description": "Event-type-specific payload."
+                  }
+                },
+                "required": [
+                  "ts",
+                  "run_id",
+                  "task_id",
+                  "type"
+                ],
+                "additionalProperties": false,
+                "description": "Append-only run event record (one JSONL line in the run's event log)."
+              }
+            },
+            "required": [
+              "seq",
+              "event"
+            ],
+            "additionalProperties": false
+          },
+          "maxItems": 200,
+          "description": "Ordered new events, at most 65536 UTF-8 JSON bytes including envelopes. Legacy events retain their body and use the stream id as seq."
+        },
+        "eventOmission": {
+          "anyOf": [
+            {
+              "type": "string",
+              "enum": [
+                "event_limit",
+                "byte_limit",
+                "oversized_frame",
+                "invalid_event",
+                "stream_ended"
+              ]
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Why the page stopped early: event_limit or byte_limit (more events may follow; resume with nextSeq), oversized_frame (the next frame exceeds the 131072-byte stream frame cap), invalid_event (the next frame failed validation and is never skipped), stream_ended (the stream, which ends only for a terminal run, served nothing after nextSeq although snapshotSeq is higher, such as a last line left unterminated by a crash; nothing was skipped, and the same call returns the same page until the log changes, so stop there). Null means no limit was reached, not that replay is exhausted."
+        },
+        "oversizedEvent": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "seq": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 9007199254740991,
+                  "description": "Durable seq of the next unread event."
+                },
+                "type": {
+                  "type": "string",
+                  "description": "Event type the daemon stream names for it."
+                }
+              },
+              "required": [
+                "seq",
+                "type"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "The next unread event after nextSeq cannot fit one page. Read its exact bytes in parts with claudexor_run_event_read, then resume with afterSeq set to its seq. Null otherwise."
+        },
+        "pendingInteractions": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "interactionId": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Interaction id used to answer."
+              },
+              "runId": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Run the interaction belongs to."
+              },
+              "attemptId": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "default": null,
+                "description": "Attempt the interaction was raised in, when known."
+              },
+              "harnessId": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "default": null,
+                "description": "Harness that raised the interaction."
+              },
+              "sourceTool": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "default": null,
+                "description": "Native tool that raised the request."
+              },
+              "questions": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "type": "string",
+                      "minLength": 1,
+                      "description": "Question id."
+                    },
+                    "question": {
+                      "type": "string",
+                      "description": "The question text."
+                    },
+                    "header": {
+                      "type": [
+                        "string",
+                        "null"
+                      ],
+                      "default": null,
+                      "description": "Short chip/header text some harnesses attach to a question."
+                    },
+                    "options": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "label": {
+                            "type": "string",
+                            "description": "Option label shown to the user."
+                          },
+                          "description": {
+                            "type": [
+                              "string",
+                              "null"
+                            ],
+                            "default": null,
+                            "description": "Optional longer explanation of the option."
+                          }
+                        },
+                        "required": [
+                          "label"
+                        ],
+                        "additionalProperties": false,
+                        "description": "One multiple-choice option of an interactive question."
+                      },
+                      "default": [],
+                      "description": "Selectable options; empty for free-text-only questions."
+                    },
+                    "multi_select": {
+                      "type": "boolean",
+                      "default": false,
+                      "description": "Whether multiple options may be selected."
+                    }
+                  },
+                  "required": [
+                    "id",
+                    "question"
+                  ],
+                  "additionalProperties": false,
+                  "description": "One question of an interactive user-input request."
+                },
+                "default": [],
+                "description": "Questions awaiting answers."
+              },
+              "requestedAt": {
+                "type": "string",
+                "description": "When the interaction was requested."
+              },
+              "timeoutAt": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "default": null,
+                "description": "When the interaction times out into a benign decline; null = no timeout."
+              }
+            },
+            "required": [
+              "interactionId",
+              "runId",
+              "requestedAt"
+            ],
+            "additionalProperties": false,
+            "description": "A live interactive question awaiting the user's answer (snapshot projection)."
+          },
+          "description": "Current snapshot's pending questions, bounded to 32768 UTF-8 JSON bytes; claudexor_run_interactions returns complete bodies. They never hold back events."
+        },
+        "pendingInteractionCount": {
+          "$ref": "#/definitions/McpRunWaitResult/properties/events/items/properties/seq"
+        },
+        "omittedInteractions": {
+          "$ref": "#/definitions/McpRunWaitResult/properties/events/items/properties/seq"
+        },
+        "wakeReason": {
+          "type": "string",
+          "enum": [
+            "events",
+            "interactions",
+            "terminal",
+            "timeout",
+            "aborted",
+            "disconnected"
+          ],
+          "description": "Why this observation returned, by precedence: aborted (this read was cancelled; the worker continues), terminal (the run is terminal; events may still follow nextSeq unless eventOmission is stream_ended), interactions (this page includes a question event), events (event mode, a completed zero-wait page, or a page, even an empty one, stopped by event_limit, byte_limit, oversized_frame or invalid_event), timeout (waitMs elapsed, possibly with a partial batch), disconnected (the stream ended early; never completion)."
+        }
+      },
+      "required": [
+        "runId",
+        "status",
+        "snapshotSeq",
+        "snapshotPhase",
+        "snapshotProblem",
+        "nextSeq",
+        "events",
+        "eventOmission",
+        "oversizedEvent",
+        "pendingInteractions",
+        "pendingInteractionCount",
+        "omittedInteractions",
+        "wakeReason"
+      ],
+      "additionalProperties": false,
+      "description": "Read-only run observation, at most 131072 UTF-8 JSON bytes: at most two snapshot reads and one stream subscription, no automatic reconnect or worker cancellation. Events already available at the snapshot fence are returned before any wait, whether or not a question is pending. Resume with nextSeq."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ModelCallRequest.schema.json

@@ -52,7 +52,11 @@
               "additionalProperties": false
             }
           ],
-          "description": "Auto keeps a usable prior account; pin never selects another account."
+          "description": "Auto text operations prefer preferredProfileId among unmarked accounts of the same catalog tier (listed before unlisted); a listed alternative, a mark or a recent refusal outranks it. History bound to that account keeps it first over a catalog miss only while it has neither a mark nor a recent refusal. Image operations order accounts by the pool alone. Pin never selects another account."
+        },
+        "retryOfOperationId": {
+          "$ref": "#/definitions/ModelCallRequest/properties/source",
+          "description": "One host-owned capability retry of a failed auto operation with otherwise identical generation input. No engine re-dispatch; unavailable after daemon restart or four hours."
         },
         "messages": {
           "type": "array",

package/generated/ModelCallResult.schema.json

@@ -4,6 +4,61 @@
     "ModelCallResult": {
       "type": "object",
       "properties": {
+        "routing": {
+          "type": "object",
+          "properties": {
+            "selectionReason": {
+              "type": "string",
+              "enum": [
+                "listed",
+                "unlisted_fallback",
+                "marked_fallback",
+                "preferred",
+                "pinned",
+                "probe"
+              ]
+            },
+            "retryOfOperationId": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Non-empty identifier string."
+            },
+            "differentialOutcome": {
+              "type": "string",
+              "enum": [
+                "provisional",
+                "confirmed",
+                "equivalent_refusal",
+                "inconclusive"
+              ]
+            },
+            "poolEvents": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "type": {
+                    "type": "string"
+                  },
+                  "payload": {
+                    "type": "object",
+                    "additionalProperties": {}
+                  }
+                },
+                "required": [
+                  "type",
+                  "payload"
+                ],
+                "additionalProperties": false
+              }
+            }
+          },
+          "required": [
+            "selectionReason",
+            "poolEvents"
+          ],
+          "additionalProperties": false
+        },
         "outcome": {
           "type": "string",
           "enum": [
@@ -53,8 +108,7 @@
                   "type": "string"
                 },
                 "tool_call_id": {
-                  "type": "string",
-                  "minLength": 1,
+                  "$ref": "#/definitions/ModelCallResult/properties/routing/properties/retryOfOperationId",
                   "description": "Non-empty identifier string."
                 },
                 "tool_calls": {
@@ -63,7 +117,7 @@
                     "type": "object",
                     "properties": {
                       "id": {
-                        "$ref": "#/definitions/ModelCallResult/properties/message/anyOf/0/properties/tool_call_id"
+                        "$ref": "#/definitions/ModelCallResult/properties/routing/properties/retryOfOperationId"
                       },
                       "type": {
                         "type": "string",
@@ -104,10 +158,10 @@
                       "type": "object",
                       "properties": {
                         "source": {
-                          "$ref": "#/definitions/ModelCallResult/properties/message/anyOf/0/properties/tool_call_id"
+                          "$ref": "#/definitions/ModelCallResult/properties/routing/properties/retryOfOperationId"
                         },
                         "credentialProfileId": {
-                          "$ref": "#/definitions/ModelCallResult/properties/message/anyOf/0/properties/tool_call_id"
+                          "$ref": "#/definitions/ModelCallResult/properties/routing/properties/retryOfOperationId"
                         },
                         "accountFingerprint": {
                           "type": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claudexor/schema",
-  "version": "4.3.1",
+  "version": "4.5.0",
   "license": "MIT",
   "description": "Single source of truth for all Claudexor data shapes (Zod + generated JSON Schema).",
   "type": "module",
@@ -20,7 +20,7 @@
   "dependencies": {
     "zod": "^4.6.5",
     "zod-to-json-schema": "^3.24.1",
-    "@claudexor/util": "4.3.1"
+    "@claudexor/util": "4.5.0"
   },
   "repository": {
     "type": "git",