@claudexor/schema 3.20.1 → 3.22.0

package/generated/ControlRunListResponse.schema.json

@@ -98,6 +98,390 @@
                 "description": "Durable Delegate requested/effective/used receipt projected from engine telemetry; null when legacy telemetry has no receipt.",
                 "default": null
               },
+              "continueFrom": {
+                "anyOf": [
+                  {
+                    "$ref": "#/definitions/ControlRunListResponse/properties/runs/items/properties/parentRunId/anyOf/0"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "Predecessor run this run continues (continueFrom); null for ordinary runs.",
+                "default": null
+              },
+              "resumable": {
+                "anyOf": [
+                  {
+                    "type": "object",
+                    "properties": {
+                      "cause": {
+                        "type": "string",
+                        "enum": [
+                          "vendor_limit",
+                          "pool_exhausted",
+                          "pinned_limit",
+                          "transport",
+                          "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), 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/ControlRunListResponse/properties/runs/items/properties/parentRunId/anyOf/0"
+                              },
+                              "nativeSessionId": {
+                                "type": "string",
+                                "minLength": 1
+                              },
+                              "holderProfileId": {
+                                "anyOf": [
+                                  {
+                                    "$ref": "#/definitions/ControlRunListResponse/properties/runs/items/properties/parentRunId/anyOf/0"
+                                  },
+                                  {
+                                    "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 unfinished work that continueFrom can continue; null when the work finished or the run is not terminal.",
+                "default": null
+              },
+              "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/ControlRunListResponse/properties/runs/items/properties/parentRunId/anyOf/0"
+                    },
+                    "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/ControlRunListResponse/properties/runs/items/properties/resumable/anyOf/0/properties/cause"
+                    },
+                    "from": {
+                      "type": "object",
+                      "properties": {
+                        "runId": {
+                          "$ref": "#/definitions/ControlRunListResponse/properties/runs/items/properties/parentRunId/anyOf/0"
+                        },
+                        "attemptId": {
+                          "$ref": "#/definitions/ControlRunListResponse/properties/runs/items/properties/parentRunId/anyOf/0"
+                        },
+                        "profileId": {
+                          "anyOf": [
+                            {
+                              "$ref": "#/definitions/ControlRunListResponse/properties/runs/items/properties/parentRunId/anyOf/0"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ],
+                          "description": "Non-empty identifier string."
+                        }
+                      },
+                      "required": [
+                        "runId",
+                        "attemptId",
+                        "profileId"
+                      ],
+                      "additionalProperties": false
+                    },
+                    "to": {
+                      "type": "object",
+                      "properties": {
+                        "profileId": {
+                          "anyOf": [
+                            {
+                              "$ref": "#/definitions/ControlRunListResponse/properties/runs/items/properties/parentRunId/anyOf/0"
+                            },
+                            {
+                              "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": "One receipt per continued try (carrier, cause, accounts, memory, model), from the run's event log: projected on run detail (GET /runs/:id), omitted from list rows."
+              },
+              "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/ControlRunListResponse/properties/runs/items/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 continuation (disk use visible); null when none.",
+                "default": null
+              },
               "taskId": {
                 "type": "string",
                 "description": "Task id, when allocated."
@@ -1279,7 +1663,7 @@
                               "incomplete",
                               "unverified"
                             ],
-                            "description": "Folded work state: the WorkReport state, or unverified when no report was obtainable (transport unsupported / lane gated)."
+                            "description": "Folded work state: the WorkReport state, or unverified when no valid report was obtained (transport unsupported / lane gated, or an instructed footer missing or broken)."
                           },
                           "source": {
                             "type": "string",
@@ -1335,6 +1719,19 @@
                             },
                             "maxItems": 16,
                             "description": "Carried through from a needs_input/incomplete WorkReport for honest disclosure."
+                          },
+                          "unverified_reason": {
+                            "type": "string",
+                            "enum": [
+                              "footer_missing",
+                              "footer_not_json",
+                              "footer_not_object",
+                              "report_missing",
+                              "report_malformed",
+                              "report_contradictory",
+                              "legacy_output_invalid"
+                            ],
+                            "description": "Present only with state unverified on a validated (instructed footer) source: the disclosed cause of the missing report."
                           }
                         },
                         "required": [

package/generated/ControlRunStartRequest.schema.json

@@ -440,6 +440,22 @@
           "$ref": "#/definitions/ControlRunStartRequest/properties/threadId",
           "description": "Server-owned Exact Retry lineage; direct POST /runs rejects it."
         },
+        "continueFrom": {
+          "$ref": "#/definitions/ControlRunStartRequest/properties/threadId",
+          "description": "Continue a terminal predecessor run owned by this daemon; one accepted successor per predecessor. Omitted mode, scope, execution, harness and model come from the predecessor; prompt is the continuation text and may be empty."
+        },
+        "continueCarrier": {
+          "type": "string",
+          "enum": [
+            "auto",
+            "packet"
+          ],
+          "description": "Carrier preference for continueFrom; omitted = auto."
+        },
+        "continueModelInherited": {
+          "type": "boolean",
+          "description": "Internal continuation model provenance; direct POST /runs rejects it."
+        },
         "planRunId": {
           "$ref": "#/definitions/ControlRunStartRequest/properties/threadId",
           "description": "Internal daemon handoff only; rejected (400) on POST /runs. When set, the turn implements an approved plan from that run."