@caelo-cms/shared 0.10.21 → 0.10.23

package/dist/skills.js

@@ -1,127 +1,33 @@
 // SPDX-License-Identifier: MPL-2.0
 /**
- * P10A — skill auto-matcher (pure function).
+ * Skill metadata shapes shared across the Query API + chat-runner.
  *
- * Scores site-active skills against the current chat turn's user
- * message + element-reference chips. Top-K matches go into
- * `auto`-source engagements; pinned defaults + manual overrides
- * compose with the matcher output in the chat-runner.
+ * Skills use PROGRESSIVE DISCLOSURE (the Anthropic Agent Skills shape): a
+ * static `## Skills` index (slug + description) sits in the cached system
+ * prompt, and the model pulls a skill's full body into the conversation on
+ * demand via the `load_skill` tool (its body then lives in the append-only
+ * message history for the rest of the chat).
  *
- * Scoring is intentionally simple — keyword + chip-trigger + always-on
- * — to keep this layer LLM-free. The matcher runs every turn; an
- * LLM-based matcher would double provider cost without obvious gain.
+ * `skillAutoEngagementHints` no longer drives SELECTION — the model
+ * self-selects from the descriptions. The hints now only shape how prominently
+ * a skill is presented in the index: `alwaysOn` skills get an "always applies"
+ * callout, `chipTrigger` skills a "when element chips are attached" callout.
+ * (The old keyword/chip/always-on MATCHER + engagement resolver were removed
+ * once progressive disclosure replaced them.)
  */
 import { z } from "zod";
 export const skillAutoEngagementHints = z
     .object({
-    /** Lowercase substrings that boost the score when present in the user message. */
+    /**
+     * Lowercase substrings that once boosted the auto-matcher. The matcher is
+     * gone (progressive disclosure); retained in the schema so seeded rows that
+     * still carry keywords parse under `.strict()`. No runtime effect today.
+     */
     keywords: z.array(z.string().min(1).max(80)).default([]),
-    /** When true, engage automatically whenever element-ref chips are attached. */
+    /** Listed under the index's "when element chips are attached" callout. */
     chipTrigger: z.boolean().default(false),
-    /** When true, always engage on every call (e.g. brand-voice-guard). */
+    /** Listed under the index's "always applies" callout (e.g. brand-voice-guard). */
     alwaysOn: z.boolean().default(false),
 })
     .strict();
-/**
- * Score every candidate skill against the turn context. Returns the
- * top-K matches sorted by score (descending). `alwaysOn` skills always
- * score at least 1; `chipTrigger` skills score 100 when chips present;
- * keywords add 1 per matching keyword (case-insensitive substring).
- *
- * Skills with score 0 are dropped — they never engage automatically.
- */
-export function matchSkills(input) {
-    const topK = input.topK ?? 5;
-    const lowered = input.userMessage.toLowerCase();
-    const matches = [];
-    for (const s of input.skills) {
-        let score = 0;
-        const reasons = [];
-        if (s.hints.alwaysOn) {
-            score += 1;
-            reasons.push("always-on");
-        }
-        if (s.hints.chipTrigger && input.chipCount > 0) {
-            score += 100;
-            reasons.push(`element chips (${input.chipCount})`);
-        }
-        const matchedKeywords = [];
-        for (const k of s.hints.keywords) {
-            const needle = k.toLowerCase();
-            if (needle.length > 0 && lowered.includes(needle)) {
-                matchedKeywords.push(k);
-            }
-        }
-        if (matchedKeywords.length > 0) {
-            score += matchedKeywords.length;
-            const sample = matchedKeywords.slice(0, 3).join(", ");
-            reasons.push(matchedKeywords.length > 3
-                ? `keywords: ${sample}, +${matchedKeywords.length - 3}`
-                : `keywords: ${sample}`);
-        }
-        if (score > 0) {
-            matches.push({
-                skillId: s.id,
-                slug: s.slug,
-                displayName: s.displayName,
-                score,
-                rationale: reasons.join("; "),
-            });
-        }
-    }
-    matches.sort((a, b) => b.score - a.score || a.slug.localeCompare(b.slug));
-    return matches.slice(0, topK);
-}
-export function resolveEngagements(input) {
-    const disengaged = new Set();
-    const engagedManual = new Map();
-    if (input.manualOverrides) {
-        for (const m of input.manualOverrides) {
-            if (m.intent === "disengage") {
-                disengaged.add(m.skillId);
-            }
-            else {
-                engagedManual.set(m.skillId, {
-                    skillId: m.skillId,
-                    slug: m.slug,
-                    displayName: m.displayName,
-                    source: "manual",
-                    rationale: "manually engaged",
-                });
-            }
-        }
-    }
-    const out = new Map();
-    // Pinned defaults first (lowest priority among engaged).
-    for (const p of input.pinnedSkills) {
-        if (disengaged.has(p.skillId))
-            continue;
-        out.set(p.skillId, {
-            skillId: p.skillId,
-            slug: p.slug,
-            displayName: p.displayName,
-            source: "pinned",
-            rationale: "pinned default",
-        });
-    }
-    // Auto matches — overwrite pinned label only if not already in out.
-    for (const a of input.autoMatches) {
-        if (disengaged.has(a.skillId))
-            continue;
-        if (out.has(a.skillId))
-            continue;
-        out.set(a.skillId, {
-            skillId: a.skillId,
-            slug: a.slug,
-            displayName: a.displayName,
-            source: "auto",
-            rationale: a.rationale,
-        });
-    }
-    // Manual engages always win — always overwrite.
-    for (const m of engagedManual.values()) {
-        out.set(m.skillId, m);
-    }
-    return [...out.values()];
-}
 //# sourceMappingURL=skills.js.map

package/dist/skills.js.map

@@ -1 +1 @@
-{"version":3,"file":"skills.js","sourceRoot":"","sources":["../src/skills.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../src/skills.ts"],"names":[],"mappings":"AAAA,mCAAmC;AAEnC;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC;KACtC,MAAM,CAAC;IACN;;;;OAIG;IACH,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACxD,0EAA0E;IAC1E,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACvC,kFAAkF;IAClF,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CACrC,CAAC;KACD,MAAM,EAAE,CAAC"}

package/dist/strip-cdata.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Strip XHTML-style CDATA-section guard delimiters from module HTML,
+ * preserving the content they wrapped. Returns the input unchanged when
+ * no guard is present (fast path for the overwhelming clean-HTML case).
+ */
+export declare function stripCdataGuards(html: string): string;
+//# sourceMappingURL=strip-cdata.d.ts.map

package/dist/strip-cdata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strip-cdata.d.ts","sourceRoot":"","sources":["../src/strip-cdata.ts"],"names":[],"mappings":"AAyCA;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGrD"}

package/dist/strip-cdata.js

@@ -0,0 +1,48 @@
+// SPDX-License-Identifier: MPL-2.0
+/**
+ * CDATA-guard normalization for module HTML.
+ *
+ * The AI sometimes authors chrome/layout module HTML with XHTML-style
+ * CDATA guards wrapping inline `<style>`/`<script>` content — e.g.
+ *
+ *   <script>
+ *   //<![CDATA[
+ *     doStuff();
+ *   //]]>
+ *   </script>
+ *
+ * or the block-comment / bare forms (`/*<![CDATA[* /`, `<![CDATA[`).
+ * These are legal in XHTML but MEANINGLESS in HTML5: the compose
+ * pipeline is byte-preserving by design (see `preview-scanner.ts`), so
+ * the guards survive verbatim into the rendered page. Chrome/layout
+ * modules render straight from their stored HTML (no content_instance
+ * indirection), so a bare `<![CDATA[` in the body is parsed by the
+ * browser as a bogus comment up to the first `>`, leaving a stray,
+ * visible `]]>` in the header/footer/nav.
+ *
+ * We normalize at the module-HTML write boundary (canonical) and again
+ * defensively at render, so both freshly-authored and already-stored
+ * modules stay clean. Only the DELIMITERS are removed — the wrapped
+ * CSS/JS/markup content is preserved.
+ *
+ * This is normalization of malformed authored markup, not a data
+ * fallback (CLAUDE.md §2): there is no "missing" data to point at, and
+ * the inner content is kept intact.
+ */
+/**
+ * Matches every CDATA-guard delimiter form the model emits. The
+ * comment-wrapped variants come first so they're consumed as a unit
+ * before the bare `<![CDATA[` / `]]>` alternatives can match a subset.
+ */
+const CDATA_GUARDS = /\/\*\s*<!\[CDATA\[\s*\*\/|\/\*\s*\]\]>\s*\*\/|\/\/[ \t]*<!\[CDATA\[|\/\/[ \t]*\]\]>|<!\[CDATA\[|\]\]>/g;
+/**
+ * Strip XHTML-style CDATA-section guard delimiters from module HTML,
+ * preserving the content they wrapped. Returns the input unchanged when
+ * no guard is present (fast path for the overwhelming clean-HTML case).
+ */
+export function stripCdataGuards(html) {
+    if (!html.includes("CDATA") && !html.includes("]]>"))
+        return html;
+    return html.replace(CDATA_GUARDS, "");
+}
+//# sourceMappingURL=strip-cdata.js.map

package/dist/strip-cdata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strip-cdata.js","sourceRoot":"","sources":["../src/strip-cdata.ts"],"names":[],"mappings":"AAAA,mCAAmC;AAEnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH;;;;GAIG;AACH,MAAM,YAAY,GAChB,wGAAwG,CAAC;AAE3G;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAClE,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;AACxC,CAAC"}

package/dist/structured-sets.d.ts

@@ -35,18 +35,6 @@ export declare const taxonomyItem: z.ZodObject<{
     parentSlug: z.ZodOptional<z.ZodString>;
     description: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
-/** One CSS variable. Renderer emits `<style>:root{--<token>: <value>;…}</style>`. */
-export declare const themeToken: z.ZodObject<{
-    token: z.ZodString;
-    value: z.ZodString;
-    scope: z.ZodOptional<z.ZodEnum<{
-        color: "color";
-        font: "font";
-        space: "space";
-        radius: "radius";
-        shadow: "shadow";
-    }>>;
-}, z.core.$strict>;
 /** Flat tag — used by post taxonomies, content filtering. */
 export declare const tagItem: z.ZodObject<{
     slug: z.ZodString;
@@ -73,13 +61,16 @@ export declare const languageSelectorOverride: z.ZodObject<{
     hidden: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>;
 /** Discriminated kind → items array. The Query API op picks the
- *  validator at runtime by reading `kind` first. */
+ *  validator at runtime by reading `kind` first.
+ *
+ *  v0.11.0 (#45) — `theme` is no longer a structured-set kind. The
+ *  theme primitive moved to its own `themes` table with DTCG-shaped
+ *  jsonb tokens; see `themes.ts` + `theme-render.ts`. */
 export declare const structuredSetKind: z.ZodEnum<{
+    "link-list": "link-list";
     "nav-menu": "nav-menu";
     taxonomy: "taxonomy";
-    theme: "theme";
     tags: "tags";
-    "link-list": "link-list";
     "language-selector": "language-selector";
 }>;
 export type StructuredSetKind = z.infer<typeof structuredSetKind>;
@@ -88,7 +79,6 @@ export type StructuredSetKind = z.infer<typeof structuredSetKind>;
 export declare function validateStructuredSetItems(kind: StructuredSetKind, items: unknown): unknown[];
 export type NavMenuItem = z.infer<typeof navMenuItem>;
 export type TaxonomyItem = z.infer<typeof taxonomyItem>;
-export type ThemeToken = z.infer<typeof themeToken>;
 export type TagItem = z.infer<typeof tagItem>;
 export type LinkListItem = z.infer<typeof linkListItem>;
 export type LanguageSelectorOverride = z.infer<typeof languageSelectorOverride>;

package/dist/structured-sets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"structured-sets.d.ts","sourceRoot":"","sources":["../src/structured-sets.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,+DAA+D;AAC/D,eAAO,MAAM,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC5B,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC7C,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAUA,CAAC;AAEF,2EAA2E;AAC3E,eAAO,MAAM,YAAY;;;;;kBAOd,CAAC;AAEZ,qFAAqF;AACrF,eAAO,MAAM,UAAU;;;;;;;;;;kBAUZ,CAAC;AAEZ,6DAA6D;AAC7D,eAAO,MAAM,OAAO;;;;kBAaT,CAAC;AAEZ,gDAAgD;AAChD,eAAO,MAAM,YAAY;;;;kBAMd,CAAC;AAEZ;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB;;;;kBAS1B,CAAC;AAEZ;oDACoD;AACpD,eAAO,MAAM,iBAAiB;;;;;;;EAO5B,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE;8EAC8E;AAC9E,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,EAAE,CAwB7F;AAED,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AACtD,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AACxD,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AACpD,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,OAAO,CAAC,CAAC;AAC9C,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AACxD,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEhF;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,oEAAoE;IACpE,QAAQ,CAAC,gBAAgB,EAAE,aAAa,CAAC;QACvC,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,OAAO,CAAC;KACpB,CAAC,CAAC;IACH,6DAA6D;IAC7D,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC,wBAAwB,CAAC,CAAC;CAC9D,GAAG,MAAM,CAgBT"}
+{"version":3,"file":"structured-sets.d.ts","sourceRoot":"","sources":["../src/structured-sets.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,+DAA+D;AAC/D,eAAO,MAAM,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC5B,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC7C,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAUA,CAAC;AAEF,2EAA2E;AAC3E,eAAO,MAAM,YAAY;;;;;kBAOd,CAAC;AAEZ,6DAA6D;AAC7D,eAAO,MAAM,OAAO;;;;kBAaT,CAAC;AAEZ,gDAAgD;AAChD,eAAO,MAAM,YAAY;;;;kBAMd,CAAC;AAEZ;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB;;;;kBAS1B,CAAC;AAEZ;;;;;yDAKyD;AACzD,eAAO,MAAM,iBAAiB;;;;;;EAM5B,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE;8EAC8E;AAC9E,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,EAAE,CAsB7F;AAED,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AACtD,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AACxD,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,OAAO,CAAC,CAAC;AAC9C,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AACxD,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEhF;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,oEAAoE;IACpE,QAAQ,CAAC,gBAAgB,EAAE,aAAa,CAAC;QACvC,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,OAAO,CAAC;KACpB,CAAC,CAAC;IACH,6DAA6D;IAC7D,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC,wBAAwB,CAAC,CAAC;CAC9D,GAAG,MAAM,CAgBT"}

package/dist/structured-sets.js

@@ -36,18 +36,6 @@ export const taxonomyItem = z
     description: z.string().max(2000).optional(),
 })
     .strict();
-/** One CSS variable. Renderer emits `<style>:root{--<token>: <value>;…}</style>`. */
-export const themeToken = z
-    .object({
-    token: z
-        .string()
-        .min(1)
-        .max(80)
-        .regex(/^[a-z][a-z0-9-]*$/, "lowercase kebab-case"),
-    value: z.string().min(1).max(500),
-    scope: z.enum(["color", "font", "space", "radius", "shadow"]).optional(),
-})
-    .strict();
 /** Flat tag — used by post taxonomies, content filtering. */
 export const tagItem = z
     .object({
@@ -90,11 +78,14 @@ export const languageSelectorOverride = z
 })
     .strict();
 /** Discriminated kind → items array. The Query API op picks the
- *  validator at runtime by reading `kind` first. */
+ *  validator at runtime by reading `kind` first.
+ *
+ *  v0.11.0 (#45) — `theme` is no longer a structured-set kind. The
+ *  theme primitive moved to its own `themes` table with DTCG-shaped
+ *  jsonb tokens; see `themes.ts` + `theme-render.ts`. */
 export const structuredSetKind = z.enum([
     "nav-menu",
     "taxonomy",
-    "theme",
     "tags",
     "link-list",
     "language-selector",
@@ -116,8 +107,6 @@ export function validateStructuredSetItems(kind, items) {
             return items.map((it) => navMenuItem.parse(it));
         case "taxonomy":
             return items.map((it) => taxonomyItem.parse(it));
-        case "theme":
-            return items.map((it) => themeToken.parse(it));
         case "tags":
             return items.map((it) => tagItem.parse(it));
         case "link-list":

package/dist/structured-sets.js.map

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

package/dist/subagents.d.ts

@@ -15,6 +15,7 @@
  *       verdict ({pass, issues[], suggestions[]})
  *       tree    ({tree: [...], rationale})
  *       freeform ({text})
+ *       rebuild ({pages[], contentNotes[], skipped[], summary})
  *   - parseSubagentResult — pulls JSON out of the subagent's final
  *     assistant message (handles ```json fences) and validates against
  *     the requested shape.
@@ -24,8 +25,41 @@ declare const expectedReturnShape: z.ZodEnum<{
     verdict: "verdict";
     tree: "tree";
     freeform: "freeform";
+    rebuild: "rebuild";
 }>;
 export type ExpectedReturnShape = z.infer<typeof expectedReturnShape>;
+/**
+ * Run #8 R2a — the SINGLE source of truth for the return-shape enum.
+ *
+ * The spawn tools' hand-written provider `inputSchema` (JSON Schema) must
+ * carry the same enum values as this Zod schema; in run #8 the live
+ * validator rejected `"rebuild"` because the runtime resolved a stale
+ * pre-#266 build of this module while the provider schema advertised the
+ * new value (issue #251 drift class, resolution flavour). Tool files
+ * derive their JSON-Schema enums from this array instead of re-typing the
+ * literals, and a unit test asserts the tool schema accepts every shape
+ * this parser knows.
+ */
+export declare const EXPECTED_RETURN_SHAPES: readonly ExpectedReturnShape[];
+/**
+ * issue #306 — model tier a subagent runs at. `inherit` (the default) is
+ * today's behaviour: the child reuses the parent chat's provider+model.
+ * `mid` / `small` route the child onto a cheaper model the Owner mapped
+ * in the active provider's config (`ai_providers.config.modelTiers`).
+ * The tier VOCABULARY is deliberately abstract — tool results and
+ * editor-facing text never name the underlying model (CLAUDE.md §2:
+ * provider brand never surfaces in the editor chat UI); concrete model
+ * ids appear only on Owner surfaces (security panel, cost dashboard).
+ */
+export declare const subagentModelTier: z.ZodEnum<{
+    small: "small";
+    inherit: "inherit";
+    mid: "mid";
+}>;
+export type SubagentModelTier = z.infer<typeof subagentModelTier>;
+/** Single source of truth for the tier enum (same #251 drift-guard pattern
+ *  as EXPECTED_RETURN_SHAPES — tool JSON schemas derive from this array). */
+export declare const SUBAGENT_MODEL_TIERS: readonly SubagentModelTier[];
 /**
  * One subagent spec. The parent supplies role + task + optional
  * narrowing. The handler creates the ephemeral chat session, appends
@@ -41,9 +75,15 @@ export declare const subagentSpec: z.ZodObject<{
         verdict: "verdict";
         tree: "tree";
         freeform: "freeform";
+        rebuild: "rebuild";
     }>>;
-    maxCostMicrocents: z.ZodDefault<z.ZodNumber>;
+    maxCostMicrocents: z.ZodOptional<z.ZodNumber>;
     timeoutMs: z.ZodDefault<z.ZodNumber>;
+    tier: z.ZodDefault<z.ZodEnum<{
+        small: "small";
+        inherit: "inherit";
+        mid: "mid";
+    }>>;
     activePageId: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export type SubagentSpec = z.infer<typeof subagentSpec>;
@@ -55,9 +95,15 @@ export declare const spawnSubagentToolInput: z.ZodObject<{
         verdict: "verdict";
         tree: "tree";
         freeform: "freeform";
+        rebuild: "rebuild";
     }>>;
-    maxCostMicrocents: z.ZodDefault<z.ZodNumber>;
+    maxCostMicrocents: z.ZodOptional<z.ZodNumber>;
     timeoutMs: z.ZodDefault<z.ZodNumber>;
+    tier: z.ZodDefault<z.ZodEnum<{
+        small: "small";
+        inherit: "inherit";
+        mid: "mid";
+    }>>;
     activePageId: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export type SpawnSubagentToolInput = SubagentSpec;
@@ -70,9 +116,15 @@ export declare const spawnSubagentsToolInput: z.ZodObject<{
             verdict: "verdict";
             tree: "tree";
             freeform: "freeform";
+            rebuild: "rebuild";
         }>>;
-        maxCostMicrocents: z.ZodDefault<z.ZodNumber>;
+        maxCostMicrocents: z.ZodOptional<z.ZodNumber>;
         timeoutMs: z.ZodDefault<z.ZodNumber>;
+        tier: z.ZodDefault<z.ZodEnum<{
+            small: "small";
+            inherit: "inherit";
+            mid: "mid";
+        }>>;
         activePageId: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>;
 }, z.core.$strict>;
@@ -92,6 +144,35 @@ export declare const freeformReturnShape: z.ZodObject<{
     text: z.ZodString;
 }, z.core.$strict>;
 export type FreeformReturn = z.infer<typeof freeformReturnShape>;
+/**
+ * issue #264 — compact per-page rebuild summary for migration fan-out
+ * subagents. The orchestrator chat's context grows by THIS shape only
+ * (never by the subagent's full transcript), so it is deliberately
+ * bounded: per-page status + short notes, deliberate omissions with a
+ * reason, and a one-paragraph summary. `pageId`/`slug` are both
+ * optional because a subagent that failed before resolving a page can
+ * still report the slug it was briefed with (or vice versa).
+ */
+export declare const rebuildReturnShape: z.ZodObject<{
+    pages: z.ZodArray<z.ZodObject<{
+        pageId: z.ZodOptional<z.ZodString>;
+        slug: z.ZodOptional<z.ZodString>;
+        status: z.ZodEnum<{
+            rebuilt: "rebuilt";
+            skipped: "skipped";
+            failed: "failed";
+            needs_escalation: "needs_escalation";
+        }>;
+        notes: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    contentNotes: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    skipped: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        item: z.ZodString;
+        reason: z.ZodString;
+    }, z.core.$strict>>>;
+    summary: z.ZodDefault<z.ZodString>;
+}, z.core.$strict>;
+export type RebuildReturn = z.infer<typeof rebuildReturnShape>;
 export type ParseSuccess = {
     ok: true;
     shape: "verdict";
@@ -104,11 +185,28 @@ export type ParseSuccess = {
     ok: true;
     shape: "freeform";
     value: FreeformReturn;
+} | {
+    ok: true;
+    shape: "rebuild";
+    value: RebuildReturn;
 };
 export type ParseResult = ParseSuccess | {
     ok: false;
     error: string;
 };
+/**
+ * Run #10 D2 — validate an ALREADY-PARSED value against the requested
+ * return shape. This is the structured half of the result channel: the
+ * `submit_result` tool hands the payload straight from the tool-call
+ * arguments (already JSON — no fence-stripping, no brace-balancing),
+ * so the "response is not valid JSON" failure class cannot occur.
+ * `parseSubagentResult` (final-text fallback) delegates here after its
+ * JSON extraction.
+ *
+ * For `freeform`, accepts `{text: "..."}` OR a bare string (wrapped as
+ * `{text}`) so the model can pass its prose directly.
+ */
+export declare function validateSubagentResultValue(value: unknown, shape: ExpectedReturnShape): ParseResult;
 /**
  * Pull JSON out of the subagent's final assistant text and validate
  * against the requested shape. On schema mismatch, returns
@@ -117,6 +215,10 @@ export type ParseResult = ParseSuccess | {
  * For `freeform`, accepts EITHER `{text: "..."}` JSON or raw text;
  * raw text is wrapped as `{text: rawText}` so the caller always gets
  * the same shape.
+ *
+ * Run #10 D2 — this is now the FALLBACK channel; the canonical path is
+ * the child calling `submit_result`, whose payload is validated by
+ * `validateSubagentResultValue` without any text extraction.
  */
 export declare function parseSubagentResult(text: string, shape: ExpectedReturnShape): ParseResult;
 export {};

package/dist/subagents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subagents.d.ts","sourceRoot":"","sources":["../src/subagents.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,QAAA,MAAM,mBAAmB;;;;EAA0C,CAAC;AACpE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEtE;;;;;;GAMG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;kBA4Bd,CAAC;AACZ,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;kBAAe,CAAC;AACnD,MAAM,MAAM,sBAAsB,GAAG,YAAY,CAAC;AAElD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;kBAIzB,CAAC;AACZ,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAM9E,eAAO,MAAM,kBAAkB;;;;kBAQpB,CAAC;AACZ,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE/D,eAAO,MAAM,eAAe;;;kBAKjB,CAAC;AACZ,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAEzD,eAAO,MAAM,mBAAmB;;kBAIrB,CAAC;AACZ,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAiDjE,MAAM,MAAM,YAAY,GACpB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,aAAa,CAAA;CAAE,GACpD;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GAC9C;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,cAAc,CAAA;CAAE,CAAC;AAE3D,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtE;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,GAAG,WAAW,CA8DzF"}
+{"version":3,"file":"subagents.d.ts","sourceRoot":"","sources":["../src/subagents.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,QAAA,MAAM,mBAAmB;;;;;EAAqD,CAAC;AAC/E,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEtE;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,sBAAsB,EAAE,SAAS,mBAAmB,EAAgC,CAAC;AAElG;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB;;;;EAAsC,CAAC;AACrE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAClE;6EAC6E;AAC7E,eAAO,MAAM,oBAAoB,EAAE,SAAS,iBAAiB,EAA8B,CAAC;AAE5F;;;;;;GAMG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;kBAwDd,CAAC;AACZ,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;kBAAe,CAAC;AACnD,MAAM,MAAM,sBAAsB,GAAG,YAAY,CAAC;AAElD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;kBAUzB,CAAC;AACZ,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAM9E,eAAO,MAAM,kBAAkB;;;;kBAQpB,CAAC;AACZ,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE/D,eAAO,MAAM,eAAe;;;kBAKjB,CAAC;AACZ,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAEzD,eAAO,MAAM,mBAAmB;;kBAIrB,CAAC;AACZ,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEjE;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;kBAuDpB,CAAC;AACZ,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAiD/D,MAAM,MAAM,YAAY,GACpB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,aAAa,CAAA;CAAE,GACpD;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GAC9C;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,cAAc,CAAA;CAAE,GACtD;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,aAAa,CAAA;CAAE,CAAC;AAEzD,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtE;;;;;;;;;;;GAWG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,mBAAmB,GACzB,WAAW,CAiFb;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,GAAG,WAAW,CA0BzF"}