@claudexor/schema 2.1.3 → 3.0.0

package/dist/output-schema.js

@@ -0,0 +1,109 @@
+/**
+ * Caller-supplied per-run output-schema normalization/transport helpers. A
+ * run's final ANSWER may be constrained to a JSON Schema (agent race/ask):
+ * the ORIGINAL validated schema stays the conformance authority, while the
+ * vendor transport gets a strict (all-required + additionalProperties:false)
+ * form. Shared owner for both transforms, harness-agnostic.
+ */
+/** A caller-supplied output schema the structured-output routes cannot carry. */
+export class UnsupportedOutputSchemaError extends Error {
+}
+/**
+ * Validate a CALLER-supplied per-run output schema and return it UNCHANGED —
+ * it stays the CONFORMANCE AUTHORITY (the engine validates the final answer
+ * against exactly what the caller asked for). The vendor transport separately
+ * strictifies via `strictifyOutputSchema`; NEVER validate the answer against
+ * the strictified form — strictify turns an optional string into a required
+ * `string|null`, so `{"field":null}` would falsely pass a schema that forbids it.
+ *
+ * Refuses — typed, at the boundary — the shapes the native routes are
+ * LIVE-VERIFIED to reject rather than let a vendor 400 surface mid-run: the
+ * root must be an inline `type: "object"` (claude materializes --json-schema as
+ * a StructuredOutput tool whose input_schema needs a top-level type; a
+ * $ref-wrapped root 400s), `$ref` is refused anywhere, and `format` is refused
+ * while the pinned claude (<2.1.205) silently drops a format-bearing schema.
+ */
+export function normalizeUserOutputSchema(schema) {
+    if (schema["type"] !== "object" || typeof schema["properties"] !== "object") {
+        throw new UnsupportedOutputSchemaError('outputSchema root must be an inline object schema ({"type":"object","properties":{...}}); $ref-wrapped or non-object roots are rejected by the native structured-output routes');
+    }
+    const hasRef = (value) => {
+        if (Array.isArray(value))
+            return value.some(hasRef);
+        if (!value || typeof value !== "object")
+            return false;
+        const obj = value;
+        if ("$ref" in obj)
+            return true;
+        return Object.values(obj).some(hasRef);
+    };
+    if (hasRef(schema)) {
+        throw new UnsupportedOutputSchemaError("outputSchema must not contain $ref (native structured-output routes do not resolve references); inline the referenced shapes");
+    }
+    const hasFormat = (value) => {
+        if (Array.isArray(value))
+            return value.some(hasFormat);
+        if (!value || typeof value !== "object")
+            return false;
+        const obj = value;
+        if (typeof obj["format"] === "string")
+            return true;
+        return Object.values(obj).some(hasFormat);
+    };
+    if (hasFormat(schema)) {
+        throw new UnsupportedOutputSchemaError("outputSchema must not use `format`: the pinned claude CLI (<2.1.205) silently drops the whole schema when format is present; express the constraint with pattern/enum instead");
+    }
+    return schema;
+}
+/** Vendor-strict transport form of a validated output schema (all keys
+ *  required, additionalProperties:false, optionals nullable). Used ONLY to
+ *  constrain the harness — NEVER to judge conformance (see normalizeUserOutputSchema). */
+export function strictifyOutputSchema(schema) {
+    return strictifyForStructuredOutput(schema);
+}
+/**
+ * Vendor STRICT structured-output mode (LIVE-VERIFIED against codex 0.137 /
+ * the OpenAI Responses API): every object must list ALL property keys in
+ * `required` and set `additionalProperties: false` — optional-with-default
+ * fields become always-emitted (their Zod defaults make explicit values
+ * equivalent). One owner for the transform; a schema that violates this is
+ * rejected by the vendor with invalid_json_schema.
+ */
+export function strictifyForStructuredOutput(node) {
+    const walk = (value) => {
+        if (Array.isArray(value))
+            return value.map(walk);
+        if (!value || typeof value !== "object")
+            return value;
+        const obj = { ...value };
+        for (const key of Object.keys(obj))
+            obj[key] = walk(obj[key]);
+        if (obj["type"] === "object" && obj["properties"] && typeof obj["properties"] === "object") {
+            const props = obj["properties"];
+            const originallyRequired = new Set(Array.isArray(obj["required"]) ? obj["required"] : []);
+            // Vendor strict mode demands required = ALL keys; fields that were
+            // OPTIONAL in the source schema stay expressible by becoming NULLABLE
+            // (the OpenAI strict-mode recipe) — otherwise the model would be FORCED
+            // to invent values on every call.
+            for (const key of Object.keys(props)) {
+                if (originallyRequired.has(key))
+                    continue;
+                const prop = props[key];
+                if (prop && typeof prop === "object" && !Array.isArray(prop)) {
+                    const p = prop;
+                    if (typeof p["type"] === "string" && p["type"] !== "null") {
+                        p["type"] = [p["type"], "null"];
+                    }
+                    else if (Array.isArray(p["type"]) && !p["type"].includes("null")) {
+                        p["type"].push("null");
+                    }
+                }
+            }
+            obj["required"] = Object.keys(props);
+            obj["additionalProperties"] = false;
+        }
+        return obj;
+    };
+    return walk(node);
+}
+//# sourceMappingURL=output-schema.js.map

package/dist/output-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-schema.js","sourceRoot":"","sources":["../src/output-schema.ts"],"names":[],"mappings":"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"}

package/dist/plan.d.ts

@@ -0,0 +1,206 @@
+import { z } from "zod";
+/**
+ * Typed plan-question artifacts (v3 plan lifecycle, D17/D31): the planner's
+ * tagged `## Open Questions` block is parsed by the ENGINE into
+ * `final/questions.json`, and readiness is DERIVED from that artifact by one
+ * server-side projection — surfaces consume the projection, never re-parse.
+ */
+export declare const PlanQuestionKind: z.ZodEnum<["single", "multi", "text"]>;
+export type PlanQuestionKind = z.infer<typeof PlanQuestionKind>;
+export declare const PlanQuestionOption: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    id: string;
+    label: string;
+}, {
+    id: string;
+    label: string;
+}>;
+export type PlanQuestionOption = z.infer<typeof PlanQuestionOption>;
+export declare const PlanQuestion: z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodEnum<["single", "multi", "text"]>;
+    prompt: z.ZodString;
+    options: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        label: string;
+    }, {
+        id: string;
+        label: string;
+    }>, "many">>;
+    allow_text: z.ZodDefault<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    options: {
+        id: string;
+        label: string;
+    }[];
+    kind: "text" | "single" | "multi";
+    id: string;
+    prompt: string;
+    allow_text: boolean;
+}, {
+    kind: "text" | "single" | "multi";
+    id: string;
+    prompt: string;
+    options?: {
+        id: string;
+        label: string;
+    }[] | undefined;
+    allow_text?: boolean | undefined;
+}>;
+export type PlanQuestion = z.infer<typeof PlanQuestion>;
+export declare const PlanQuestionsArtifact: z.ZodObject<{
+    /** Whether a tagged Open Questions block was found at all. `none_found`
+     * is DISCLOSED, never silently equated with "ready" (zen: honest states). */
+    parse: z.ZodEnum<["found", "none_found"]>;
+    questions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<["single", "multi", "text"]>;
+        prompt: z.ZodString;
+        options: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            id: string;
+            label: string;
+        }, {
+            id: string;
+            label: string;
+        }>, "many">>;
+        allow_text: z.ZodDefault<z.ZodBoolean>;
+    }, "strict", z.ZodTypeAny, {
+        options: {
+            id: string;
+            label: string;
+        }[];
+        kind: "text" | "single" | "multi";
+        id: string;
+        prompt: string;
+        allow_text: boolean;
+    }, {
+        kind: "text" | "single" | "multi";
+        id: string;
+        prompt: string;
+        options?: {
+            id: string;
+            label: string;
+        }[] | undefined;
+        allow_text?: boolean | undefined;
+    }>, "many">>;
+}, "strict", z.ZodTypeAny, {
+    questions: {
+        options: {
+            id: string;
+            label: string;
+        }[];
+        kind: "text" | "single" | "multi";
+        id: string;
+        prompt: string;
+        allow_text: boolean;
+    }[];
+    parse: "found" | "none_found";
+}, {
+    parse: "found" | "none_found";
+    questions?: {
+        kind: "text" | "single" | "multi";
+        id: string;
+        prompt: string;
+        options?: {
+            id: string;
+            label: string;
+        }[] | undefined;
+        allow_text?: boolean | undefined;
+    }[] | undefined;
+}>;
+export type PlanQuestionsArtifact = z.infer<typeof PlanQuestionsArtifact>;
+export declare const PlanReadinessState: z.ZodEnum<["ready", "needs_answers", "unverified"]>;
+export type PlanReadinessState = z.infer<typeof PlanReadinessState>;
+export declare const PlanReadiness: z.ZodObject<{
+    state: z.ZodEnum<["ready", "needs_answers", "unverified"]>;
+    questionCount: z.ZodDefault<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    state: "ready" | "needs_answers" | "unverified";
+    questionCount: number;
+}, {
+    state: "ready" | "needs_answers" | "unverified";
+    questionCount?: number | undefined;
+}>;
+export type PlanReadiness = z.infer<typeof PlanReadiness>;
+/** One council member's role and outcome (INV-031). `primary` is the merger;
+ * `member` is a draft-only participant. A council with one surviving member
+ * still merges (the primary normalizes the format + extracts questions). */
+export declare const CouncilMember: z.ZodObject<{
+    harnessId: z.ZodString;
+    role: z.ZodEnum<["primary", "member"]>;
+    status: z.ZodEnum<["drafted", "failed", "merged"]>;
+    error: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, "strict", z.ZodTypeAny, {
+    status: "failed" | "drafted" | "merged";
+    harnessId: string;
+    error: string | null;
+    role: "primary" | "member";
+}, {
+    status: "failed" | "drafted" | "merged";
+    harnessId: string;
+    role: "primary" | "member";
+    error?: string | null | undefined;
+}>;
+export type CouncilMember = z.infer<typeof CouncilMember>;
+/** Council membership + merge projection (INV-031), projected from
+ * `council/membership.yaml`. Present only for `--council` plan runs; the
+ * downstream plan artifacts (final/plan.md, questions.json, readiness) are
+ * shape-identical to a solo plan, so this field is purely additive disclosure. */
+export declare const CouncilProjection: z.ZodObject<{
+    requested: z.ZodNumber;
+    drafted: z.ZodNumber;
+    degraded: z.ZodDefault<z.ZodBoolean>;
+    mergedBy: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    members: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        harnessId: z.ZodString;
+        role: z.ZodEnum<["primary", "member"]>;
+        status: z.ZodEnum<["drafted", "failed", "merged"]>;
+        error: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, "strict", z.ZodTypeAny, {
+        status: "failed" | "drafted" | "merged";
+        harnessId: string;
+        error: string | null;
+        role: "primary" | "member";
+    }, {
+        status: "failed" | "drafted" | "merged";
+        harnessId: string;
+        role: "primary" | "member";
+        error?: string | null | undefined;
+    }>, "many">>;
+}, "strict", z.ZodTypeAny, {
+    requested: number;
+    degraded: boolean;
+    drafted: number;
+    mergedBy: string | null;
+    members: {
+        status: "failed" | "drafted" | "merged";
+        harnessId: string;
+        error: string | null;
+        role: "primary" | "member";
+    }[];
+}, {
+    requested: number;
+    drafted: number;
+    degraded?: boolean | undefined;
+    mergedBy?: string | null | undefined;
+    members?: {
+        status: "failed" | "drafted" | "merged";
+        harnessId: string;
+        role: "primary" | "member";
+        error?: string | null | undefined;
+    }[] | undefined;
+}>;
+export type CouncilProjection = z.infer<typeof CouncilProjection>;
+/** THE single derivation authority for plan readiness (declared per the v3
+ * plan-lifecycle decision): every surface consumes this projection of
+ * final/questions.json; nothing re-parses plan text. */
+export declare function derivePlanReadiness(artifact: PlanQuestionsArtifact): PlanReadiness;
+//# sourceMappingURL=plan.d.ts.map

package/dist/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../src/plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;GAKG;AAEH,eAAO,MAAM,gBAAgB,wCAEkD,CAAC;AAChF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEhE,eAAO,MAAM,kBAAkB;;;;;;;;;EAMyB,CAAC;AACzD,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEpE,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAeoC,CAAC;AAC9D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD,eAAO,MAAM,qBAAqB;IAE9B;iFAC6E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOE,CAAC;AACpF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE1E,eAAO,MAAM,kBAAkB,qDAI5B,CAAC;AACJ,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEpE,eAAO,MAAM,aAAa;;;;;;;;;EAMwD,CAAC;AACnF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D;;4EAE4E;AAC5E,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;EAgBuC,CAAC;AAClE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D;;;kFAGkF;AAClF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgBgD,CAAC;AAC/E,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE;;wDAEwD;AACxD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,aAAa,CAOlF"}

package/dist/plan.js

@@ -0,0 +1,107 @@
+import { z } from "zod";
+/**
+ * Typed plan-question artifacts (v3 plan lifecycle, D17/D31): the planner's
+ * tagged `## Open Questions` block is parsed by the ENGINE into
+ * `final/questions.json`, and readiness is DERIVED from that artifact by one
+ * server-side projection — surfaces consume the projection, never re-parse.
+ */
+export const PlanQuestionKind = z
+    .enum(["single", "multi", "text"])
+    .describe("Question kind: pick exactly one, pick one or more, or free text.");
+export const PlanQuestionOption = z
+    .object({
+    id: z.string().min(1).describe("Stable option id within the question."),
+    label: z.string().min(1).describe("Option label shown to the user."),
+})
+    .strict()
+    .describe("One selectable option of a plan question.");
+export const PlanQuestion = z
+    .object({
+    id: z.string().min(1).describe("Stable question id within the plan revision."),
+    kind: PlanQuestionKind,
+    prompt: z.string().min(1).describe("The question text."),
+    options: z
+        .array(PlanQuestionOption)
+        .default([])
+        .describe("Options for single/multi questions; empty for free text."),
+    allow_text: z
+        .boolean()
+        .default(false)
+        .describe("True when a free-text answer is accepted (text questions)."),
+})
+    .strict()
+    .describe("One open question surfaced by a plan revision.");
+export const PlanQuestionsArtifact = z
+    .object({
+    /** Whether a tagged Open Questions block was found at all. `none_found`
+     * is DISCLOSED, never silently equated with "ready" (zen: honest states). */
+    parse: z
+        .enum(["found", "none_found"])
+        .describe("Whether the planner emitted a parseable Open Questions block."),
+    questions: z.array(PlanQuestion).default([]).describe("Open questions of this plan revision."),
+})
+    .strict()
+    .describe("Engine-parsed open questions of one plan run (final/questions.json).");
+export const PlanReadinessState = z
+    .enum(["ready", "needs_answers", "unverified"])
+    .describe("Derived plan readiness: ready (block parsed, zero open questions), needs_answers (open questions remain), unverified (no parseable block — the planner ignored the format).");
+export const PlanReadiness = z
+    .object({
+    state: PlanReadinessState,
+    questionCount: z.number().int().nonnegative().default(0),
+})
+    .strict()
+    .describe("Server-derived readiness of a plan run (one derivation owner; D17).");
+/** One council member's role and outcome (INV-031). `primary` is the merger;
+ * `member` is a draft-only participant. A council with one surviving member
+ * still merges (the primary normalizes the format + extracts questions). */
+export const CouncilMember = z
+    .object({
+    harnessId: z.string().min(1).describe("Harness that drafted (or merged) this member's plan."),
+    role: z
+        .enum(["primary", "member"])
+        .describe("primary = the merger that synthesizes the unified plan; member = draft only."),
+    status: z
+        .enum(["drafted", "failed", "merged"])
+        .describe("drafted = draft landed; merged = this member produced the unified plan; failed."),
+    error: z
+        .string()
+        .nullable()
+        .default(null)
+        .describe("First redacted draft error; null unless the member failed."),
+})
+    .strict()
+    .describe("One council member's role and draft/merge outcome.");
+/** Council membership + merge projection (INV-031), projected from
+ * `council/membership.yaml`. Present only for `--council` plan runs; the
+ * downstream plan artifacts (final/plan.md, questions.json, readiness) are
+ * shape-identical to a solo plan, so this field is purely additive disclosure. */
+export const CouncilProjection = z
+    .object({
+    requested: z.number().int().positive().describe("Requested member count (n; 2..4)."),
+    drafted: z.number().int().nonnegative().describe("Members whose draft survived to the merge."),
+    degraded: z
+        .boolean()
+        .default(false)
+        .describe("True when fewer members drafted than requested (failures disclosed per member)."),
+    mergedBy: z
+        .string()
+        .nullable()
+        .default(null)
+        .describe("Harness that produced the unified plan (the primary); null if the merge failed."),
+    members: z.array(CouncilMember).default([]).describe("Per-member role and outcome."),
+})
+    .strict()
+    .describe("Council membership + merge disclosure for a --council plan run.");
+/** THE single derivation authority for plan readiness (declared per the v3
+ * plan-lifecycle decision): every surface consumes this projection of
+ * final/questions.json; nothing re-parses plan text. */
+export function derivePlanReadiness(artifact) {
+    if (artifact.parse === "none_found") {
+        return { state: "unverified", questionCount: 0 };
+    }
+    return artifact.questions.length === 0
+        ? { state: "ready", questionCount: 0 }
+        : { state: "needs_answers", questionCount: artifact.questions.length };
+}
+//# sourceMappingURL=plan.js.map

package/dist/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../src/plan.ts"],"names":[],"mappings":"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"}

package/dist/primitives.d.ts

@@ -28,21 +28,25 @@ export type OutputReadyState = z.infer<typeof OutputReadyState>;
 export declare const ProviderFamily: z.ZodEnum<["openai", "anthropic", "google", "cursor", "opencode", "xai", "local", "unknown"]>;
 export type ProviderFamily = z.infer<typeof ProviderFamily>;
 /**
- * Canonical modes (v0.9 collapse, BREAKING): the 9 v0.8 ids shrank to 5
- * intents-on-a-thread. The old engine strategies became FLAGS, not modes:
- * `best_of_n` -> agent + n, `max_attempts` -> agent + attempts,
- * `until_clean` -> agent + until_clean, `create` -> agent + create,
- * `explore` -> audit + swarm, `readonly_audit` -> audit. Old ids hard-error
- * at every wire boundary (Bible: modes are canonical and breaking, never
- * silent aliases). `orchestrate` is the autonomous coordinator intent.
+ * Canonical modes (v3.0.0 collapse, BREAKING): three conversation intents —
+ * ask (read-only answer; `deep_scan` widens it into the bounded multi-scout
+ * research sweep that used to be `audit --swarm`/`explore`), plan
+ * (read-only planning), agent (writes). Engine strategies remain FLAGS on a
+ * mode, never modes: `n` (best-of race width / deep-scan width), `attempts`
+ * / `until_clean` (agent convergence), `create` (agent from-scratch),
+ * `deep_scan` (ask sweep). Retired ids (`audit`, `explore`,
+ * `readonly_audit`, `best_of_n`, …) hard-error at every wire boundary
+ * (Bible: modes are canonical and breaking, never silent aliases). The former
+ * `orchestrate` mode was deleted once its delegation replacement landed
+ * (`agent --delegate`, INV-030); the retired verb hard-errors naming it.
  */
-export declare const ModeKind: z.ZodEnum<["ask", "plan", "audit", "agent", "orchestrate"]>;
+export declare const ModeKind: z.ZodEnum<["ask", "plan", "agent"]>;
 export type ModeKind = z.infer<typeof ModeKind>;
 /** Canonical intents a harness can be assigned. Roles are intents, never fixed
  * classes. (`compare`/`arbitrate` were retired in the v0.15 triage: no run
  * site ever requested them — comparison/arbitration are engine phases, not
  * harness assignments. `verify` stays for the FinalVerifier.) */
-export declare const Intent: z.ZodEnum<["plan", "spec", "implement", "create_from_scratch", "repair", "review", "verify", "synthesize", "explain", "audit", "orchestrate"]>;
+export declare const Intent: z.ZodEnum<["plan", "spec", "implement", "create_from_scratch", "repair", "review", "verify", "synthesize", "explain", "audit"]>;
 export type Intent = z.infer<typeof Intent>;
 /**
  * How a dirty working tree is handled when creating an envelope: `snapshot`
@@ -54,7 +58,7 @@ export type Intent = z.infer<typeof Intent>;
 export declare const DirtyPolicy: z.ZodEnum<["refuse", "snapshot"]>;
 export type DirtyPolicy = z.infer<typeof DirtyPolicy>;
 /**
- * A user's preferred auth route for a harness, thread, or the orchestrate planner.
+ * A user's preferred auth route for a harness or thread.
  * `subscription` = native/OAuth session; `api_key` = a stored API key; `auto`
  * lets the engine pick subscription-first and fall back per policy. This is a
  * preference, not a secret — the actual key refs live in global/trust config.

package/dist/primitives.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../src/primitives.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,oFAAoF;AACpF,eAAO,MAAM,cAAc,EAAG,CAAU,CAAC;AAEzC,eAAO,MAAM,aAAa,iBAEoD,CAAC;AAE/E,qCAAqC;AACrC,eAAO,MAAM,EAAE,aAA6D,CAAC;AAC7E,MAAM,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;AAEpC,iFAAiF;AACjF,eAAO,MAAM,cAAc,aAIgE,CAAC;AAC5F,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D,iCAAiC;AACjC,eAAO,MAAM,YAAY,aAA2D,CAAC;AACrF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD,wDAAwD;AACxD,eAAO,MAAM,WAAW,aAG4C,CAAC;AACrE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD,eAAO,MAAM,SAAS,kDAE0D,CAAC;AACjF,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAElD,eAAO,MAAM,aAAa,+FAIvB,CAAC;AACJ,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D,2EAA2E;AAC3E,eAAO,MAAM,qBAAqB,8CAI/B,CAAC;AACJ,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE1E,4EAA4E;AAC5E,eAAO,MAAM,gBAAgB,6DAI1B,CAAC;AACJ,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEhE,sFAAsF;AACtF,eAAO,MAAM,cAAc,+FAIxB,CAAC;AACJ,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D;;;;;;;;GAQG;AACH,eAAO,MAAM,QAAQ,6DAIlB,CAAC;AACJ,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEhD;;;iEAGiE;AACjE,eAAO,MAAM,MAAM,gJAgBhB,CAAC;AACJ,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,CAAC;AAE5C;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,mCAIrB,CAAC;AACJ,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD;;;;;GAKG;AACH,eAAO,MAAM,cAAc,gDAIxB,CAAC;AACJ,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D;;;;GAIG;AACH,eAAO,MAAM,cAAc,0OAuBxB,CAAC;AACJ,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../src/primitives.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,oFAAoF;AACpF,eAAO,MAAM,cAAc,EAAG,CAAU,CAAC;AAEzC,eAAO,MAAM,aAAa,iBAEoD,CAAC;AAE/E,qCAAqC;AACrC,eAAO,MAAM,EAAE,aAA6D,CAAC;AAC7E,MAAM,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;AAEpC,iFAAiF;AACjF,eAAO,MAAM,cAAc,aAIgE,CAAC;AAC5F,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D,iCAAiC;AACjC,eAAO,MAAM,YAAY,aAA2D,CAAC;AACrF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD,wDAAwD;AACxD,eAAO,MAAM,WAAW,aAG4C,CAAC;AACrE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD,eAAO,MAAM,SAAS,kDAE0D,CAAC;AACjF,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAElD,eAAO,MAAM,aAAa,+FAIvB,CAAC;AACJ,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D,2EAA2E;AAC3E,eAAO,MAAM,qBAAqB,8CAI/B,CAAC;AACJ,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE1E,4EAA4E;AAC5E,eAAO,MAAM,gBAAgB,6DAI1B,CAAC;AACJ,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEhE,sFAAsF;AACtF,eAAO,MAAM,cAAc,+FAIxB,CAAC;AACJ,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,QAAQ,qCAIlB,CAAC;AACJ,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEhD;;;iEAGiE;AACjE,eAAO,MAAM,MAAM,iIAehB,CAAC;AACJ,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,CAAC;AAE5C;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,mCAIrB,CAAC;AACJ,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD;;;;;GAKG;AACH,eAAO,MAAM,cAAc,gDAIxB,CAAC;AACJ,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D;;;;GAIG;AACH,eAAO,MAAM,cAAc,0OAuBxB,CAAC;AACJ,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/dist/primitives.js

@@ -38,17 +38,21 @@ export const ProviderFamily = z
     .enum(["openai", "anthropic", "google", "cursor", "opencode", "xai", "local", "unknown"])
     .describe('Vendor/provider family a harness routes to, used for route-diversity reasoning; open-ended via "unknown".');
 /**
- * Canonical modes (v0.9 collapse, BREAKING): the 9 v0.8 ids shrank to 5
- * intents-on-a-thread. The old engine strategies became FLAGS, not modes:
- * `best_of_n` -> agent + n, `max_attempts` -> agent + attempts,
- * `until_clean` -> agent + until_clean, `create` -> agent + create,
- * `explore` -> audit + swarm, `readonly_audit` -> audit. Old ids hard-error
- * at every wire boundary (Bible: modes are canonical and breaking, never
- * silent aliases). `orchestrate` is the autonomous coordinator intent.
+ * Canonical modes (v3.0.0 collapse, BREAKING): three conversation intents —
+ * ask (read-only answer; `deep_scan` widens it into the bounded multi-scout
+ * research sweep that used to be `audit --swarm`/`explore`), plan
+ * (read-only planning), agent (writes). Engine strategies remain FLAGS on a
+ * mode, never modes: `n` (best-of race width / deep-scan width), `attempts`
+ * / `until_clean` (agent convergence), `create` (agent from-scratch),
+ * `deep_scan` (ask sweep). Retired ids (`audit`, `explore`,
+ * `readonly_audit`, `best_of_n`, …) hard-error at every wire boundary
+ * (Bible: modes are canonical and breaking, never silent aliases). The former
+ * `orchestrate` mode was deleted once its delegation replacement landed
+ * (`agent --delegate`, INV-030); the retired verb hard-errors naming it.
  */
 export const ModeKind = z
-    .enum(["ask", "plan", "audit", "agent", "orchestrate"])
-    .describe("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.");
+    .enum(["ask", "plan", "agent"])
+    .describe("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.");
 /** Canonical intents a harness can be assigned. Roles are intents, never fixed
  * classes. (`compare`/`arbitrate` were retired in the v0.15 triage: no run
  * site ever requested them — comparison/arbitration are engine phases, not
@@ -65,7 +69,6 @@ export const Intent = z
     "synthesize",
     "explain",
     "audit",
-    "orchestrate",
 ])
     .describe("Canonical intent a harness can be assigned for a session (roles are intents, never fixed classes).");
 /**
@@ -79,7 +82,7 @@ export const DirtyPolicy = z
     .enum(["refuse", "snapshot"])
     .describe("How a dirty working tree is handled when creating an envelope: snapshot captures the dirty state as the base SHA without touching the live tree; refuse fails loudly.");
 /**
- * A user's preferred auth route for a harness, thread, or the orchestrate planner.
+ * A user's preferred auth route for a harness or thread.
  * `subscription` = native/OAuth session; `api_key` = a stored API key; `auto`
  * lets the engine pick subscription-first and fall back per policy. This is a
  * preference, not a secret — the actual key refs live in global/trust config.

package/dist/primitives.js.map

@@ -1 +1 @@
-{"version":3,"file":"primitives.js","sourceRoot":"","sources":["../src/primitives.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"primitives.js","sourceRoot":"","sources":["../src/primitives.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,oFAAoF;AACpF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAU,CAAC;AAEzC,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC;KAC3B,OAAO,CAAC,cAAc,CAAC;KACvB,QAAQ,CAAC,iEAAiE,CAAC,CAAC;AAE/E,qCAAqC;AACrC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,8BAA8B,CAAC,CAAC;AAG7E,iFAAiF;AACjF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC;KAC5B,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,KAAK,CAAC,IAAI,EAAE,6BAA6B,CAAC;KAC1C,QAAQ,CAAC,8EAA8E,CAAC,CAAC;AAG5F,iCAAiC;AACjC,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,4BAA4B,CAAC,CAAC;AAGrF,wDAAwD;AACxD,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC;KACzB,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,QAAQ,CAAC,uDAAuD,CAAC,CAAC;AAGrE,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC;KACvB,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;KAC3C,QAAQ,CAAC,mEAAmE,CAAC,CAAC;AAGjF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC;KAC3B,IAAI,CAAC,CAAC,UAAU,EAAE,iBAAiB,EAAE,MAAM,EAAE,uBAAuB,EAAE,gBAAgB,CAAC,CAAC;KACxF,QAAQ,CACP,qTAAqT,CACtT,CAAC;AAGJ,2EAA2E;AAC3E,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC;KACnC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;KACvC,QAAQ,CACP,0LAA0L,CAC3L,CAAC;AAGJ,4EAA4E;AAC5E,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC;KAC9B,IAAI,CAAC,CAAC,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;KACtD,QAAQ,CACP,4KAA4K,CAC7K,CAAC;AAGJ,sFAAsF;AACtF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC;KAC5B,IAAI,CAAC,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;KACxF,QAAQ,CACP,2GAA2G,CAC5G,CAAC;AAGJ;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC;KACtB,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;KAC9B,QAAQ,CACP,qKAAqK,CACtK,CAAC;AAGJ;;;iEAGiE;AACjE,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC;KACpB,IAAI,CAAC;IACJ,MAAM;IACN,MAAM;IACN,WAAW;IACX,qBAAqB;IACrB,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,YAAY;IACZ,SAAS;IACT,OAAO;CACR,CAAC;KACD,QAAQ,CACP,oGAAoG,CACrG,CAAC;AAGJ;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC;KACzB,IAAI,CAAC,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;KAC5B,QAAQ,CACP,uKAAuK,CACxK,CAAC;AAGJ;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC;KAC5B,IAAI,CAAC,CAAC,cAAc,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;KACzC,QAAQ,CACP,oLAAoL,CACrL,CAAC;AAGJ;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC;KAC5B,IAAI,CAAC;IACJ,iBAAiB;IACjB,iBAAiB;IACjB,wBAAwB;IACxB,cAAc;IACd,eAAe;IACf,OAAO;IACP,0BAA0B;IAC1B,gBAAgB;IAChB;+EAC2E;IAC3E,cAAc;IACd,kFAAkF;IAClF,kBAAkB;IAClB;;mCAE+B;IAC/B,qBAAqB;IACrB,QAAQ;CACT,CAAC;KACD,QAAQ,CACP,4JAA4J,CAC7J,CAAC"}