@claudexor/schema 2.1.2 → 3.0.0

package/generated/TaskContract.schema.json

@@ -59,11 +59,9 @@
               "enum": [
                 "ask",
                 "plan",
-                "audit",
-                "agent",
-                "orchestrate"
+                "agent"
               ],
-              "description": "Canonical run mode: ask, plan, and audit are read-only; agent writes; orchestrate is the autonomous coordinator intent. Engine strategies (race, attempts, swarm, create) are flags on a mode, not modes."
+              "description": "Canonical run mode: ask and plan are read-only, agent writes. Engine strategies (race width, attempts, deep_scan, create, delegate) are flags on a mode, not modes."
             }
           },
           "required": [
@@ -144,136 +142,6 @@
           "default": null,
           "description": "Per-run turn cap (beats per-harness settings); null when the caller set none."
         },
-        "spec": {
-          "type": "object",
-          "properties": {
-            "id": {
-              "$ref": "#/definitions/TaskContract/properties/credential_profile_id/anyOf/0",
-              "description": "SpecPack id."
-            },
-            "hash": {
-              "type": "string",
-              "description": "Content hash of the frozen SpecPack."
-            },
-            "path": {
-              "type": "string",
-              "description": "On-disk path of the SpecPack artifact."
-            }
-          },
-          "additionalProperties": false,
-          "description": "Reference to the frozen SpecPack this contract was derived from, if any."
-        },
-        "success_criteria": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "properties": {
-              "id": {
-                "type": "string",
-                "minLength": 1,
-                "description": "Criterion id."
-              },
-              "text": {
-                "type": "string",
-                "description": "Human-readable statement of what must hold for the run to succeed."
-              },
-              "required": {
-                "type": "boolean",
-                "default": true,
-                "description": "Whether this criterion is required (vs advisory)."
-              }
-            },
-            "required": [
-              "id",
-              "text"
-            ],
-            "additionalProperties": false,
-            "description": "A single success criterion the run is held to."
-          },
-          "default": [],
-          "description": "Criteria the run must satisfy to succeed."
-        },
-        "non_goals": {
-          "type": "array",
-          "items": {
-            "type": "string"
-          },
-          "default": [],
-          "description": "Explicitly out-of-scope outcomes."
-        },
-        "forbidden_approaches": {
-          "type": "array",
-          "items": {
-            "type": "string"
-          },
-          "default": [],
-          "description": "Approaches the run must not take."
-        },
-        "decided_tradeoffs": {
-          "type": "array",
-          "items": {
-            "type": "string"
-          },
-          "default": [],
-          "description": "Tradeoffs already decided; reviewers must not re-litigate them."
-        },
-        "task_graph": {
-          "anyOf": [
-            {
-              "type": "object",
-              "properties": {
-                "nodes": {
-                  "type": "array",
-                  "items": {
-                    "type": "object",
-                    "properties": {
-                      "id": {
-                        "type": "string",
-                        "minLength": 1,
-                        "description": "Task node id."
-                      },
-                      "title": {
-                        "type": "string",
-                        "default": "",
-                        "description": "Human-readable task title."
-                      },
-                      "depends_on": {
-                        "type": "array",
-                        "items": {
-                          "$ref": "#/definitions/TaskContract/properties/credential_profile_id/anyOf/0"
-                        },
-                        "default": [],
-                        "description": "Ids of tasks this node depends on (graph edges)."
-                      }
-                    },
-                    "required": [
-                      "id"
-                    ],
-                    "additionalProperties": false,
-                    "description": "One node of the spec-derived task graph; edges are depends_on."
-                  },
-                  "default": [],
-                  "description": "Task nodes of the graph."
-                },
-                "order": {
-                  "type": "array",
-                  "items": {
-                    "$ref": "#/definitions/TaskContract/properties/credential_profile_id/anyOf/0"
-                  },
-                  "default": [],
-                  "description": "Topological execution order (node ids); empty when there are no tasks."
-                }
-              },
-              "additionalProperties": false,
-              "description": "A topologically-ordered task graph built from a frozen SpecPack's tasks."
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "Spec-derived task graph; null until a frozen SpecPack with tasks is resolved.",
-          "default": null
-        },
         "constraints": {
           "type": "object",
           "properties": {
@@ -283,7 +151,7 @@
                 "type": "string"
               },
               "default": [],
-              "description": "Spec/config-owned globs whose changes escalate risk to a human-approval gate; cannot be suppressed by per-run protected-path approvals."
+              "description": "Approval globs — path globs (e.g. `migrations/**`, `**/*.env`) whose changes escalate a run to a human-approval gate before it can be applied. Spec/config-owned and never suppressed by per-run protected-path approvals."
             },
             "deny_paths": {
               "type": "array",

package/generated/Thread.schema.json

@@ -64,9 +64,7 @@
           "enum": [
             "ask",
             "plan",
-            "audit",
-            "agent",
-            "orchestrate"
+            "agent"
           ],
           "description": "Default mode for new turns; individual turns may override.",
           "default": "agent"
@@ -81,6 +79,26 @@
           "description": "Preferred auth route: subscription (native/OAuth session), api_key (a stored API key), or auto (engine picks subscription-first with policy fallback). A preference, not a secret.",
           "default": "auto"
         },
+        "access": {
+          "anyOf": [
+            {
+              "type": "string",
+              "enum": [
+                "readonly",
+                "workspace_write",
+                "full",
+                "external_sandbox_full",
+                "inherit_native"
+              ],
+              "description": "Filesystem/command access profile for a run: readonly (no writes), workspace_write (writes inside the workspace only), full (unrestricted; requires the per-repo trust allow), external_sandbox_full (full access inside an external sandbox), inherit_native (defer to the harness's own native sandbox settings)."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Sticky write scope for write turns; per-turn selection wins, null = the repo trust default.",
+          "default": null
+        },
         "credential_profile_id": {
           "anyOf": [
             {

package/generated/ThreadTurn.schema.json

@@ -52,6 +52,19 @@
           "description": "Set when this turn implements an approved plan from an earlier plan run.",
           "default": null
         },
+        "plan_hash": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "default": null,
+          "description": "sha256 of the implemented plan at freeze time; null for non-implement turns."
+        },
+        "plan_readiness_overridden": {
+          "type": "boolean",
+          "default": false,
+          "description": "True when the user explicitly implemented a plan with open questions."
+        },
         "kind": {
           "type": "string",
           "enum": [
@@ -166,6 +179,81 @@
           "description": "Why this turn has no run (enqueue/preflight refusal); null once a run binds.",
           "default": null
         },
+        "continuity": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "kind": {
+                  "type": "string",
+                  "enum": [
+                    "native_resume",
+                    "packet",
+                    "fresh"
+                  ],
+                  "description": "How a turn's lane was continued: native_resume (the lane's own vendor session already held the delta), packet (a continuation packet hydrated a lane switch/gap), or fresh (nothing to carry — the thread's first turn on any lane)."
+                },
+                "packet_turns": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "default": 0,
+                  "description": "Number of delta turns carried in the continuation packet (0 for native_resume/fresh)."
+                },
+                "summarized": {
+                  "type": "boolean",
+                  "default": false,
+                  "description": "True when the packet collapsed an older prefix to one-line entries (mechanical fallback)."
+                },
+                "lane_switched_from": {
+                  "anyOf": [
+                    {
+                      "type": "object",
+                      "properties": {
+                        "harness_id": {
+                          "type": "string",
+                          "minLength": 1,
+                          "description": "Harness of the prior lane."
+                        },
+                        "profile_id": {
+                          "anyOf": [
+                            {
+                              "$ref": "#/definitions/ThreadTurn/properties/run_id/anyOf/0"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ],
+                          "description": "Credential profile of the prior lane (null = engine default).",
+                          "default": null
+                        }
+                      },
+                      "required": [
+                        "harness_id"
+                      ],
+                      "additionalProperties": false,
+                      "description": "A (harness, profile) lane reference; the null profile is the engine default."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "The lane this turn switched away from, when the continuation crossed lanes; null otherwise.",
+                  "default": null
+                }
+              },
+              "required": [
+                "kind"
+              ],
+              "additionalProperties": false,
+              "description": "How a turn's lane was continued from the conversation (native resume / continuation packet / fresh), disclosed visibly per INV-137."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "How this turn's lane was continued (native resume / packet / fresh); null until stamped.",
+          "default": null
+        },
         "created_at": {
           "type": "string",
           "minLength": 1,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claudexor/schema",
-  "version": "2.1.2",
+  "version": "3.0.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": "^3.24.1",
     "zod-to-json-schema": "^3.24.1",
-    "@claudexor/util": "2.1.2"
+    "@claudexor/util": "3.0.0"
   },
   "repository": {
     "type": "git",