@ashx-j/lunr 0.1.0

package/dist/builtin-extensions/pi-subagents/src/agents/chain-serializer.js

@@ -0,0 +1,307 @@
+import { buildRuntimeName, frontmatterNameForConfig, parsePackageName } from "./identity.js";
+import { parseFrontmatter } from "./frontmatter.js";
+import { ChainOutputValidationError, validateChainOutputBindings } from "../runs/shared/chain-outputs.js";
+import { validateAcceptanceInput } from "../runs/shared/acceptance.js";
+import { validateToolBudgetConfig } from "../runs/shared/tool-budget.js";
+function parseStepBody(agent, sectionBody) {
+    const lines = sectionBody.split("\n");
+    const blankIndex = lines.findIndex((line) => line.trim() === "");
+    const configLines = blankIndex === -1 ? lines : lines.slice(0, blankIndex);
+    const task = (blankIndex === -1 ? "" : lines.slice(blankIndex + 1).join("\n")).trim();
+    const step = { agent, task };
+    for (const line of configLines) {
+        const match = line.match(/^([\w-]+):\s*(.*)$/);
+        if (!match)
+            continue;
+        const key = match[1].trim().toLowerCase();
+        const rawValue = match[2].trim();
+        if (key === "output") {
+            if (rawValue === "false")
+                step.output = false;
+            else if (rawValue)
+                step.output = rawValue;
+            continue;
+        }
+        if (key === "phase") {
+            if (rawValue)
+                step.phase = rawValue;
+            continue;
+        }
+        if (key === "label") {
+            if (rawValue)
+                step.label = rawValue;
+            continue;
+        }
+        if (key === "as") {
+            if (rawValue)
+                step.as = rawValue;
+            continue;
+        }
+        if (key === "outputschema") {
+            if (rawValue.startsWith("{") || rawValue.startsWith("[")) {
+                throw new Error("Inline outputSchema values are not supported in .chain.md files; use a schema file path.");
+            }
+            if (rawValue)
+                step.outputSchema = rawValue;
+            continue;
+        }
+        if (key === "outputmode") {
+            if (rawValue === "inline" || rawValue === "file-only")
+                step.outputMode = rawValue;
+            continue;
+        }
+        if (key === "reads") {
+            if (rawValue === "false") {
+                step.reads = false;
+            }
+            else {
+                const reads = rawValue
+                    .split(",")
+                    .map((v) => v.trim())
+                    .filter(Boolean);
+                step.reads = reads.length > 0 ? reads : false;
+            }
+            continue;
+        }
+        if (key === "model") {
+            if (rawValue)
+                step.model = rawValue;
+            continue;
+        }
+        if (key === "skills") {
+            if (rawValue === "false") {
+                step.skills = false;
+            }
+            else {
+                const skills = rawValue
+                    .split(",")
+                    .map((v) => v.trim())
+                    .filter(Boolean);
+                step.skills = skills.length > 0 ? skills : false;
+            }
+            continue;
+        }
+        if (key === "progress") {
+            if (rawValue === "true")
+                step.progress = true;
+            else if (rawValue === "false")
+                step.progress = false;
+            continue;
+        }
+        if (key === "toolbudget") {
+            let parsed;
+            try {
+                parsed = JSON.parse(rawValue);
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                throw new Error(`Invalid toolBudget in .chain.md step '${agent}': ${message}`);
+            }
+            const validation = validateToolBudgetConfig(parsed, `toolBudget for step '${agent}'`);
+            if (validation.error)
+                throw new Error(validation.error);
+            step.toolBudget = parsed;
+        }
+    }
+    return step;
+}
+export function parseChain(content, source, filePath) {
+    const { frontmatter, body } = parseFrontmatter(content);
+    if (!frontmatter.name || !frontmatter.description) {
+        throw new Error("Chain frontmatter must include name and description");
+    }
+    const matches = [...body.matchAll(/^##\s+(.+)[^\S\n]*$/gm)];
+    const steps = [];
+    for (let i = 0; i < matches.length; i++) {
+        const match = matches[i];
+        const agent = match[1].trim();
+        const lineEndOffset = body[match.index + match[0].length] === "\n" ? 1 : 0;
+        const sectionStart = match.index + match[0].length + lineEndOffset;
+        const sectionEnd = i + 1 < matches.length ? matches[i + 1].index : body.length;
+        const sectionBody = body.slice(sectionStart, sectionEnd).trimEnd();
+        steps.push(parseStepBody(agent, sectionBody));
+    }
+    const localName = frontmatter.name;
+    const parsedPackage = parsePackageName(frontmatter.package, `Chain '${localName}' package`);
+    if (parsedPackage.error)
+        throw new Error(parsedPackage.error);
+    const packageName = parsedPackage.packageName;
+    const extraFields = {};
+    for (const [key, value] of Object.entries(frontmatter)) {
+        if (key === "name" || key === "package" || key === "description")
+            continue;
+        extraFields[key] = value;
+    }
+    return {
+        name: buildRuntimeName(localName, packageName),
+        localName,
+        packageName,
+        description: frontmatter.description,
+        source,
+        filePath,
+        steps,
+        extraFields: Object.keys(extraFields).length > 0 ? extraFields : undefined,
+    };
+}
+function validateJsonChainToolBudget(value, label) {
+    const validation = validateToolBudgetConfig(value, label);
+    if (validation.error)
+        throw new Error(validation.error);
+}
+export function parseJsonChain(content, source, filePath) {
+    let parsed;
+    try {
+        parsed = JSON.parse(content);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Invalid JSON chain '${filePath}': ${message}`);
+    }
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new Error(`JSON chain '${filePath}' must contain an object root.`);
+    }
+    const input = parsed;
+    if (typeof input.name !== "string" || !input.name.trim()) {
+        throw new Error(`JSON chain '${filePath}' must include string name.`);
+    }
+    if (typeof input.description !== "string" || !input.description.trim()) {
+        throw new Error(`JSON chain '${filePath}' must include string description.`);
+    }
+    if (!Array.isArray(input.chain)) {
+        throw new Error(`JSON chain '${filePath}' must include array chain.`);
+    }
+    for (let i = 0; i < input.chain.length; i++) {
+        const step = input.chain[i];
+        if (!step || typeof step !== "object" || Array.isArray(step)) {
+            throw new Error(`JSON chain '${filePath}' step ${i + 1} must be an object.`);
+        }
+        const stepRecord = step;
+        if (stepRecord.toolBudget !== undefined)
+            validateJsonChainToolBudget(stepRecord.toolBudget, `step ${i + 1} toolBudget`);
+        const acceptanceErrors = validateAcceptanceInput(stepRecord.acceptance, `step ${i + 1} acceptance`);
+        if (acceptanceErrors.length > 0) {
+            throw new Error(`Invalid JSON chain '${filePath}': ${acceptanceErrors.join(" ")}`);
+        }
+        const parallel = stepRecord.parallel;
+        if (Array.isArray(parallel)) {
+            for (let taskIndex = 0; taskIndex < parallel.length; taskIndex++) {
+                const task = parallel[taskIndex];
+                if (!task || typeof task !== "object" || Array.isArray(task))
+                    continue;
+                const taskRecord = task;
+                if (taskRecord.toolBudget !== undefined)
+                    validateJsonChainToolBudget(taskRecord.toolBudget, `step ${i + 1} parallel task ${taskIndex + 1} toolBudget`);
+                const taskErrors = validateAcceptanceInput(taskRecord.acceptance, `step ${i + 1} parallel task ${taskIndex + 1} acceptance`);
+                if (taskErrors.length > 0) {
+                    throw new Error(`Invalid JSON chain '${filePath}': ${taskErrors.join(" ")}`);
+                }
+            }
+        }
+        else if (parallel && typeof parallel === "object") {
+            const parallelRecord = parallel;
+            if (parallelRecord.toolBudget !== undefined)
+                validateJsonChainToolBudget(parallelRecord.toolBudget, `step ${i + 1} dynamic template toolBudget`);
+            const templateErrors = validateAcceptanceInput(parallelRecord.acceptance, `step ${i + 1} dynamic template acceptance`);
+            if (templateErrors.length > 0) {
+                throw new Error(`Invalid JSON chain '${filePath}': ${templateErrors.join(" ")}`);
+            }
+        }
+    }
+    try {
+        validateChainOutputBindings(input.chain, { maxItems: Number.MAX_SAFE_INTEGER });
+    }
+    catch (error) {
+        if (error instanceof ChainOutputValidationError)
+            throw new Error(`Invalid JSON chain '${filePath}': ${error.message}`);
+        throw error;
+    }
+    const parsedPackage = parsePackageName(typeof input.package === "string" ? input.package : undefined, `Chain '${input.name}' package`);
+    if (parsedPackage.error)
+        throw new Error(parsedPackage.error);
+    const extraFields = {};
+    for (const [key, value] of Object.entries(input)) {
+        if (key === "name" || key === "package" || key === "description" || key === "chain")
+            continue;
+        if (typeof value === "string")
+            extraFields[key] = value;
+    }
+    return {
+        name: buildRuntimeName(input.name.trim(), parsedPackage.packageName),
+        localName: input.name.trim(),
+        packageName: parsedPackage.packageName,
+        description: input.description.trim(),
+        source,
+        filePath,
+        steps: input.chain,
+        extraFields: Object.keys(extraFields).length > 0 ? extraFields : undefined,
+    };
+}
+export function serializeJsonChain(config) {
+    const root = {
+        name: frontmatterNameForConfig(config),
+        description: config.description,
+        chain: config.steps,
+    };
+    if (config.packageName)
+        root.package = config.packageName;
+    if (config.extraFields) {
+        for (const [key, value] of Object.entries(config.extraFields)) {
+            if (key !== "name" && key !== "description" && key !== "package" && key !== "chain")
+                root[key] = value;
+        }
+    }
+    return `${JSON.stringify(root, null, 2)}\n`;
+}
+export function serializeChain(config) {
+    const lines = [];
+    lines.push("---");
+    lines.push(`name: ${frontmatterNameForConfig(config)}`);
+    if (config.packageName)
+        lines.push(`package: ${config.packageName}`);
+    lines.push(`description: ${config.description}`);
+    if (config.extraFields) {
+        for (const [key, value] of Object.entries(config.extraFields)) {
+            lines.push(`${key}: ${value}`);
+        }
+    }
+    lines.push("---");
+    lines.push("");
+    for (let i = 0; i < config.steps.length; i++) {
+        const step = config.steps[i];
+        lines.push(`## ${step.agent}`);
+        if (step.output === false)
+            lines.push("output: false");
+        else if (step.output)
+            lines.push(`output: ${step.output}`);
+        if (step.phase)
+            lines.push(`phase: ${step.phase}`);
+        if (step.label)
+            lines.push(`label: ${step.label}`);
+        if (step.as)
+            lines.push(`as: ${step.as}`);
+        if (step.outputSchema)
+            lines.push(`outputSchema: ${step.outputSchema}`);
+        if (step.outputMode)
+            lines.push(`outputMode: ${step.outputMode}`);
+        if (step.reads === false)
+            lines.push("reads: false");
+        else if (Array.isArray(step.reads) && step.reads.length > 0)
+            lines.push(`reads: ${step.reads.join(", ")}`);
+        if (step.model)
+            lines.push(`model: ${step.model}`);
+        if (step.skills === false)
+            lines.push("skills: false");
+        else if (Array.isArray(step.skills) && step.skills.length > 0)
+            lines.push(`skills: ${step.skills.join(", ")}`);
+        if (step.progress !== undefined)
+            lines.push(`progress: ${step.progress ? "true" : "false"}`);
+        if (step.toolBudget !== undefined)
+            lines.push(`toolBudget: ${JSON.stringify(step.toolBudget)}`);
+        lines.push("");
+        lines.push(step.task ?? "");
+        if (i < config.steps.length - 1)
+            lines.push("");
+    }
+    return `${lines.join("\n")}\n`;
+}
+//# sourceMappingURL=chain-serializer.js.map

package/dist/builtin-extensions/pi-subagents/src/agents/chain-serializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-serializer.js","sourceRoot":"","sources":["../../../../../src/builtin-extensions/pi-subagents/src/agents/chain-serializer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC7F,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AAC1G,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAIzE,SAAS,aAAa,CAAC,KAAa,EAAE,WAAmB,EAAmB;IAC3E,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACjE,MAAM,WAAW,GAAG,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IAC3E,MAAM,IAAI,GAAG,CAAC,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAEtF,MAAM,IAAI,GAAoB,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAC9C,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;QAC/C,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC1C,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAEjC,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YACtB,IAAI,QAAQ,KAAK,OAAO;gBAAE,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;iBACzC,IAAI,QAAQ;gBAAE,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC;YAC1C,SAAS;QACV,CAAC;QACD,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;YACrB,IAAI,QAAQ;gBAAE,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC;YACpC,SAAS;QACV,CAAC;QACD,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;YACrB,IAAI,QAAQ;gBAAE,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC;YACpC,SAAS;QACV,CAAC;QACD,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YAClB,IAAI,QAAQ;gBAAE,IAAI,CAAC,EAAE,GAAG,QAAQ,CAAC;YACjC,SAAS;QACV,CAAC;QACD,IAAI,GAAG,KAAK,cAAc,EAAE,CAAC;YAC5B,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC1D,MAAM,IAAI,KAAK,CAAC,0FAA0F,CAAC,CAAC;YAC7G,CAAC;YACD,IAAI,QAAQ;gBAAE,IAAI,CAAC,YAAY,GAAG,QAAQ,CAAC;YAC3C,SAAS;QACV,CAAC;QACD,IAAI,GAAG,KAAK,YAAY,EAAE,CAAC;YAC1B,IAAI,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,WAAW;gBAAE,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAC;YAClF,SAAS;QACV,CAAC;QACD,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;YACrB,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;gBAC1B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;YACpB,CAAC;iBAAM,CAAC;gBACP,MAAM,KAAK,GAAG,QAAQ;qBACpB,KAAK,CAAC,GAAG,CAAC;qBACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;qBACpB,MAAM,CAAC,OAAO,CAAC,CAAC;gBAClB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;YAC/C,CAAC;YACD,SAAS;QACV,CAAC;QACD,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;YACrB,IAAI,QAAQ;gBAAE,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC;YACpC,SAAS;QACV,CAAC;QACD,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YACtB,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;gBAC1B,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;YACrB,CAAC;iBAAM,CAAC;gBACP,MAAM,MAAM,GAAG,QAAQ;qBACrB,KAAK,CAAC,GAAG,CAAC;qBACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;qBACpB,MAAM,CAAC,OAAO,CAAC,CAAC;gBAClB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;YAClD,CAAC;YACD,SAAS;QACV,CAAC;QACD,IAAI,GAAG,KAAK,UAAU,EAAE,CAAC;YACxB,IAAI,QAAQ,KAAK,MAAM;gBAAE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;iBACzC,IAAI,QAAQ,KAAK,OAAO;gBAAE,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;YACrD,SAAS;QACV,CAAC;QACD,IAAI,GAAG,KAAK,YAAY,EAAE,CAAC;YAC1B,IAAI,MAAe,CAAC;YACpB,IAAI,CAAC;gBACJ,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAC/B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACvE,MAAM,IAAI,KAAK,CAAC,yCAAyC,KAAK,MAAM,OAAO,EAAE,CAAC,CAAC;YAChF,CAAC;YACD,MAAM,UAAU,GAAG,wBAAwB,CAAC,MAAM,EAAE,wBAAwB,KAAK,GAAG,CAAC,CAAC;YACtF,IAAI,UAAU,CAAC,KAAK;gBAAE,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YACxD,IAAI,CAAC,UAAU,GAAG,MAAuC,CAAC;QAC3D,CAAC;IACF,CAAC;IAED,OAAO,IAAI,CAAC;AAAA,CACZ;AAED,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,MAAmB,EAAE,QAAgB,EAAe;IAC/F,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACxD,IAAI,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,uBAAuB,CAAC,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAsB,EAAE,CAAC;IAEpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC;QAC/B,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,KAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5E,MAAM,YAAY,GAAG,KAAK,CAAC,KAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,aAAa,CAAC;QACpE,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC,KAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;QACjF,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC;QACnE,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC;IACnC,MAAM,aAAa,GAAG,gBAAgB,CAAC,WAAW,CAAC,OAAO,EAAE,UAAU,SAAS,WAAW,CAAC,CAAC;IAC5F,IAAI,aAAa,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IAC9D,MAAM,WAAW,GAAG,aAAa,CAAC,WAAW,CAAC;IAC9C,MAAM,WAAW,GAA2B,EAAE,CAAC;IAC/C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QACxD,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,aAAa;YAAE,SAAS;QAC3E,WAAW,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAC1B,CAAC;IAED,OAAO;QACN,IAAI,EAAE,gBAAgB,CAAC,SAAS,EAAE,WAAW,CAAC;QAC9C,SAAS;QACT,WAAW;QACX,WAAW,EAAE,WAAW,CAAC,WAAW;QACpC,MAAM;QACN,QAAQ;QACR,KAAK;QACL,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;KAC1E,CAAC;AAAA,CACF;AAED,SAAS,2BAA2B,CAAC,KAAc,EAAE,KAAa,EAAQ;IACzE,MAAM,UAAU,GAAG,wBAAwB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC1D,IAAI,UAAU,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;AAAA,CACxD;AAED,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,MAAmB,EAAE,QAAgB,EAAe;IACnG,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACJ,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,MAAM,IAAI,KAAK,CAAC,uBAAuB,QAAQ,MAAM,OAAO,EAAE,CAAC,CAAC;IACjE,CAAC;IACD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,KAAK,CAAC,eAAe,QAAQ,gCAAgC,CAAC,CAAC;IAC1E,CAAC;IACD,MAAM,KAAK,GAAG,MAAiC,CAAC;IAChD,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,eAAe,QAAQ,6BAA6B,CAAC,CAAC;IACvE,CAAC;IACD,IAAI,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC;QACxE,MAAM,IAAI,KAAK,CAAC,eAAe,QAAQ,oCAAoC,CAAC,CAAC;IAC9E,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,eAAe,QAAQ,6BAA6B,CAAC,CAAC;IACvE,CAAC;IACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7C,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9D,MAAM,IAAI,KAAK,CAAC,eAAe,QAAQ,UAAU,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;QAC9E,CAAC;QACD,MAAM,UAAU,GAAG,IAA+B,CAAC;QACnD,IAAI,UAAU,CAAC,UAAU,KAAK,SAAS;YAAE,2BAA2B,CAAC,UAAU,CAAC,UAAU,EAAE,QAAQ,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QACxH,MAAM,gBAAgB,GAAG,uBAAuB,CAAC,UAAU,CAAC,UAAU,EAAE,QAAQ,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QACpG,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,uBAAuB,QAAQ,MAAM,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACpF,CAAC;QACD,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC;QACrC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,KAAK,IAAI,SAAS,GAAG,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,CAAC;gBAClE,MAAM,IAAI,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;gBACjC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;oBAAE,SAAS;gBACvE,MAAM,UAAU,GAAG,IAA+B,CAAC;gBACnD,IAAI,UAAU,CAAC,UAAU,KAAK,SAAS;oBAAE,2BAA2B,CAAC,UAAU,CAAC,UAAU,EAAE,QAAQ,CAAC,GAAG,CAAC,kBAAkB,SAAS,GAAG,CAAC,aAAa,CAAC,CAAC;gBACvJ,MAAM,UAAU,GAAG,uBAAuB,CAAC,UAAU,CAAC,UAAU,EAAE,QAAQ,CAAC,GAAG,CAAC,kBAAkB,SAAS,GAAG,CAAC,aAAa,CAAC,CAAC;gBAC7H,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC3B,MAAM,IAAI,KAAK,CAAC,uBAAuB,QAAQ,MAAM,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAC9E,CAAC;YACF,CAAC;QACF,CAAC;aAAM,IAAI,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACrD,MAAM,cAAc,GAAG,QAAmC,CAAC;YAC3D,IAAI,cAAc,CAAC,UAAU,KAAK,SAAS;gBAAE,2BAA2B,CAAC,cAAc,CAAC,UAAU,EAAE,QAAQ,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;YACjJ,MAAM,cAAc,GAAG,uBAAuB,CAAC,cAAc,CAAC,UAAU,EAAE,QAAQ,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;YACvH,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC/B,MAAM,IAAI,KAAK,CAAC,uBAAuB,QAAQ,MAAM,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAClF,CAAC;QACF,CAAC;IACF,CAAC;IACD,IAAI,CAAC;QACJ,2BAA2B,CAAC,KAAK,CAAC,KAAoB,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAChG,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,IAAI,KAAK,YAAY,0BAA0B;YAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,QAAQ,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACvH,MAAM,KAAK,CAAC;IACb,CAAC;IACD,MAAM,aAAa,GAAG,gBAAgB,CAAC,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,UAAU,KAAK,CAAC,IAAI,WAAW,CAAC,CAAC;IACvI,IAAI,aAAa,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IAC9D,MAAM,WAAW,GAA2B,EAAE,CAAC;IAC/C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAClD,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,aAAa,IAAI,GAAG,KAAK,OAAO;YAAE,SAAS;QAC9F,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,WAAW,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACzD,CAAC;IACD,OAAO;QACN,IAAI,EAAE,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,aAAa,CAAC,WAAW,CAAC;QACpE,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE;QAC5B,WAAW,EAAE,aAAa,CAAC,WAAW;QACtC,WAAW,EAAE,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE;QACrC,MAAM;QACN,QAAQ;QACR,KAAK,EAAE,KAAK,CAAC,KAA0B;QACvC,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;KAC1E,CAAC;AAAA,CACF;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAmB,EAAU;IAC/D,MAAM,IAAI,GAA4B;QACrC,IAAI,EAAE,wBAAwB,CAAC,MAAM,CAAC;QACtC,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,KAAK,EAAE,MAAM,CAAC,KAAK;KACnB,CAAC;IACF,IAAI,MAAM,CAAC,WAAW;QAAE,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,WAAW,CAAC;IAC1D,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QACxB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;YAC/D,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,aAAa,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,OAAO;gBAAE,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACxG,CAAC;IACF,CAAC;IACD,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AAAA,CAC5C;AAED,MAAM,UAAU,cAAc,CAAC,MAAmB,EAAU;IAC3D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,SAAS,wBAAwB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACxD,IAAI,MAAM,CAAC,WAAW;QAAE,KAAK,CAAC,IAAI,CAAC,YAAY,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;IACrE,KAAK,CAAC,IAAI,CAAC,gBAAgB,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;IACjD,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QACxB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;YAC/D,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,KAAK,KAAK,EAAE,CAAC,CAAC;QAChC,CAAC;IACF,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9C,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAC/B,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK;YAAE,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;aAClD,IAAI,IAAI,CAAC,MAAM;YAAE,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3D,IAAI,IAAI,CAAC,KAAK;YAAE,KAAK,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QACnD,IAAI,IAAI,CAAC,KAAK;YAAE,KAAK,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QACnD,IAAI,IAAI,CAAC,EAAE;YAAE,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QAC1C,IAAI,IAAI,CAAC,YAAY;YAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;QACxE,IAAI,IAAI,CAAC,UAAU;YAAE,KAAK,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QAClE,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK;YAAE,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;aAChD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC3G,IAAI,IAAI,CAAC,KAAK;YAAE,KAAK,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QACnD,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK;YAAE,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;aAClD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC/G,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS;YAAE,KAAK,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7F,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS;YAAE,KAAK,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAChG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QAC5B,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AAAA,CAC/B","sourcesContent":["// @ts-nocheck\nimport type { ChainConfig, ChainStepConfig } from \"./agents.ts\";\nimport { buildRuntimeName, frontmatterNameForConfig, parsePackageName } from \"./identity.ts\";\nimport { parseFrontmatter } from \"./frontmatter.ts\";\nimport { ChainOutputValidationError, validateChainOutputBindings } from \"../runs/shared/chain-outputs.ts\";\nimport { validateAcceptanceInput } from \"../runs/shared/acceptance.ts\";\nimport { validateToolBudgetConfig } from \"../runs/shared/tool-budget.ts\";\nimport type { ChainStep } from \"../shared/settings.ts\";\nimport type { AgentSource } from \"./agents.ts\";\n\nfunction parseStepBody(agent: string, sectionBody: string): ChainStepConfig {\n\tconst lines = sectionBody.split(\"\\n\");\n\tconst blankIndex = lines.findIndex((line) => line.trim() === \"\");\n\tconst configLines = blankIndex === -1 ? lines : lines.slice(0, blankIndex);\n\tconst task = (blankIndex === -1 ? \"\" : lines.slice(blankIndex + 1).join(\"\\n\")).trim();\n\n\tconst step: ChainStepConfig = { agent, task };\n\tfor (const line of configLines) {\n\t\tconst match = line.match(/^([\\w-]+):\\s*(.*)$/);\n\t\tif (!match) continue;\n\t\tconst key = match[1].trim().toLowerCase();\n\t\tconst rawValue = match[2].trim();\n\n\t\tif (key === \"output\") {\n\t\t\tif (rawValue === \"false\") step.output = false;\n\t\t\telse if (rawValue) step.output = rawValue;\n\t\t\tcontinue;\n\t\t}\n\t\tif (key === \"phase\") {\n\t\t\tif (rawValue) step.phase = rawValue;\n\t\t\tcontinue;\n\t\t}\n\t\tif (key === \"label\") {\n\t\t\tif (rawValue) step.label = rawValue;\n\t\t\tcontinue;\n\t\t}\n\t\tif (key === \"as\") {\n\t\t\tif (rawValue) step.as = rawValue;\n\t\t\tcontinue;\n\t\t}\n\t\tif (key === \"outputschema\") {\n\t\t\tif (rawValue.startsWith(\"{\") || rawValue.startsWith(\"[\")) {\n\t\t\t\tthrow new Error(\"Inline outputSchema values are not supported in .chain.md files; use a schema file path.\");\n\t\t\t}\n\t\t\tif (rawValue) step.outputSchema = rawValue;\n\t\t\tcontinue;\n\t\t}\n\t\tif (key === \"outputmode\") {\n\t\t\tif (rawValue === \"inline\" || rawValue === \"file-only\") step.outputMode = rawValue;\n\t\t\tcontinue;\n\t\t}\n\t\tif (key === \"reads\") {\n\t\t\tif (rawValue === \"false\") {\n\t\t\t\tstep.reads = false;\n\t\t\t} else {\n\t\t\t\tconst reads = rawValue\n\t\t\t\t\t.split(\",\")\n\t\t\t\t\t.map((v) => v.trim())\n\t\t\t\t\t.filter(Boolean);\n\t\t\t\tstep.reads = reads.length > 0 ? reads : false;\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\t\tif (key === \"model\") {\n\t\t\tif (rawValue) step.model = rawValue;\n\t\t\tcontinue;\n\t\t}\n\t\tif (key === \"skills\") {\n\t\t\tif (rawValue === \"false\") {\n\t\t\t\tstep.skills = false;\n\t\t\t} else {\n\t\t\t\tconst skills = rawValue\n\t\t\t\t\t.split(\",\")\n\t\t\t\t\t.map((v) => v.trim())\n\t\t\t\t\t.filter(Boolean);\n\t\t\t\tstep.skills = skills.length > 0 ? skills : false;\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\t\tif (key === \"progress\") {\n\t\t\tif (rawValue === \"true\") step.progress = true;\n\t\t\telse if (rawValue === \"false\") step.progress = false;\n\t\t\tcontinue;\n\t\t}\n\t\tif (key === \"toolbudget\") {\n\t\t\tlet parsed: unknown;\n\t\t\ttry {\n\t\t\t\tparsed = JSON.parse(rawValue);\n\t\t\t} catch (error) {\n\t\t\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\t\t\tthrow new Error(`Invalid toolBudget in .chain.md step '${agent}': ${message}`);\n\t\t\t}\n\t\t\tconst validation = validateToolBudgetConfig(parsed, `toolBudget for step '${agent}'`);\n\t\t\tif (validation.error) throw new Error(validation.error);\n\t\t\tstep.toolBudget = parsed as ChainStepConfig[\"toolBudget\"];\n\t\t}\n\t}\n\n\treturn step;\n}\n\nexport function parseChain(content: string, source: AgentSource, filePath: string): ChainConfig {\n\tconst { frontmatter, body } = parseFrontmatter(content);\n\tif (!frontmatter.name || !frontmatter.description) {\n\t\tthrow new Error(\"Chain frontmatter must include name and description\");\n\t}\n\n\tconst matches = [...body.matchAll(/^##\\s+(.+)[^\\S\\n]*$/gm)];\n\tconst steps: ChainStepConfig[] = [];\n\n\tfor (let i = 0; i < matches.length; i++) {\n\t\tconst match = matches[i]!;\n\t\tconst agent = match[1]!.trim();\n\t\tconst lineEndOffset = body[match.index! + match[0].length] === \"\\n\" ? 1 : 0;\n\t\tconst sectionStart = match.index! + match[0].length + lineEndOffset;\n\t\tconst sectionEnd = i + 1 < matches.length ? matches[i + 1]!.index! : body.length;\n\t\tconst sectionBody = body.slice(sectionStart, sectionEnd).trimEnd();\n\t\tsteps.push(parseStepBody(agent, sectionBody));\n\t}\n\n\tconst localName = frontmatter.name;\n\tconst parsedPackage = parsePackageName(frontmatter.package, `Chain '${localName}' package`);\n\tif (parsedPackage.error) throw new Error(parsedPackage.error);\n\tconst packageName = parsedPackage.packageName;\n\tconst extraFields: Record<string, string> = {};\n\tfor (const [key, value] of Object.entries(frontmatter)) {\n\t\tif (key === \"name\" || key === \"package\" || key === \"description\") continue;\n\t\textraFields[key] = value;\n\t}\n\n\treturn {\n\t\tname: buildRuntimeName(localName, packageName),\n\t\tlocalName,\n\t\tpackageName,\n\t\tdescription: frontmatter.description,\n\t\tsource,\n\t\tfilePath,\n\t\tsteps,\n\t\textraFields: Object.keys(extraFields).length > 0 ? extraFields : undefined,\n\t};\n}\n\nfunction validateJsonChainToolBudget(value: unknown, label: string): void {\n\tconst validation = validateToolBudgetConfig(value, label);\n\tif (validation.error) throw new Error(validation.error);\n}\n\nexport function parseJsonChain(content: string, source: AgentSource, filePath: string): ChainConfig {\n\tlet parsed: unknown;\n\ttry {\n\t\tparsed = JSON.parse(content);\n\t} catch (error) {\n\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\tthrow new Error(`Invalid JSON chain '${filePath}': ${message}`);\n\t}\n\tif (!parsed || typeof parsed !== \"object\" || Array.isArray(parsed)) {\n\t\tthrow new Error(`JSON chain '${filePath}' must contain an object root.`);\n\t}\n\tconst input = parsed as Record<string, unknown>;\n\tif (typeof input.name !== \"string\" || !input.name.trim()) {\n\t\tthrow new Error(`JSON chain '${filePath}' must include string name.`);\n\t}\n\tif (typeof input.description !== \"string\" || !input.description.trim()) {\n\t\tthrow new Error(`JSON chain '${filePath}' must include string description.`);\n\t}\n\tif (!Array.isArray(input.chain)) {\n\t\tthrow new Error(`JSON chain '${filePath}' must include array chain.`);\n\t}\n\tfor (let i = 0; i < input.chain.length; i++) {\n\t\tconst step = input.chain[i];\n\t\tif (!step || typeof step !== \"object\" || Array.isArray(step)) {\n\t\t\tthrow new Error(`JSON chain '${filePath}' step ${i + 1} must be an object.`);\n\t\t}\n\t\tconst stepRecord = step as Record<string, unknown>;\n\t\tif (stepRecord.toolBudget !== undefined) validateJsonChainToolBudget(stepRecord.toolBudget, `step ${i + 1} toolBudget`);\n\t\tconst acceptanceErrors = validateAcceptanceInput(stepRecord.acceptance, `step ${i + 1} acceptance`);\n\t\tif (acceptanceErrors.length > 0) {\n\t\t\tthrow new Error(`Invalid JSON chain '${filePath}': ${acceptanceErrors.join(\" \")}`);\n\t\t}\n\t\tconst parallel = stepRecord.parallel;\n\t\tif (Array.isArray(parallel)) {\n\t\t\tfor (let taskIndex = 0; taskIndex < parallel.length; taskIndex++) {\n\t\t\t\tconst task = parallel[taskIndex];\n\t\t\t\tif (!task || typeof task !== \"object\" || Array.isArray(task)) continue;\n\t\t\t\tconst taskRecord = task as Record<string, unknown>;\n\t\t\t\tif (taskRecord.toolBudget !== undefined) validateJsonChainToolBudget(taskRecord.toolBudget, `step ${i + 1} parallel task ${taskIndex + 1} toolBudget`);\n\t\t\t\tconst taskErrors = validateAcceptanceInput(taskRecord.acceptance, `step ${i + 1} parallel task ${taskIndex + 1} acceptance`);\n\t\t\t\tif (taskErrors.length > 0) {\n\t\t\t\t\tthrow new Error(`Invalid JSON chain '${filePath}': ${taskErrors.join(\" \")}`);\n\t\t\t\t}\n\t\t\t}\n\t\t} else if (parallel && typeof parallel === \"object\") {\n\t\t\tconst parallelRecord = parallel as Record<string, unknown>;\n\t\t\tif (parallelRecord.toolBudget !== undefined) validateJsonChainToolBudget(parallelRecord.toolBudget, `step ${i + 1} dynamic template toolBudget`);\n\t\t\tconst templateErrors = validateAcceptanceInput(parallelRecord.acceptance, `step ${i + 1} dynamic template acceptance`);\n\t\t\tif (templateErrors.length > 0) {\n\t\t\t\tthrow new Error(`Invalid JSON chain '${filePath}': ${templateErrors.join(\" \")}`);\n\t\t\t}\n\t\t}\n\t}\n\ttry {\n\t\tvalidateChainOutputBindings(input.chain as ChainStep[], { maxItems: Number.MAX_SAFE_INTEGER });\n\t} catch (error) {\n\t\tif (error instanceof ChainOutputValidationError) throw new Error(`Invalid JSON chain '${filePath}': ${error.message}`);\n\t\tthrow error;\n\t}\n\tconst parsedPackage = parsePackageName(typeof input.package === \"string\" ? input.package : undefined, `Chain '${input.name}' package`);\n\tif (parsedPackage.error) throw new Error(parsedPackage.error);\n\tconst extraFields: Record<string, string> = {};\n\tfor (const [key, value] of Object.entries(input)) {\n\t\tif (key === \"name\" || key === \"package\" || key === \"description\" || key === \"chain\") continue;\n\t\tif (typeof value === \"string\") extraFields[key] = value;\n\t}\n\treturn {\n\t\tname: buildRuntimeName(input.name.trim(), parsedPackage.packageName),\n\t\tlocalName: input.name.trim(),\n\t\tpackageName: parsedPackage.packageName,\n\t\tdescription: input.description.trim(),\n\t\tsource,\n\t\tfilePath,\n\t\tsteps: input.chain as ChainStepConfig[],\n\t\textraFields: Object.keys(extraFields).length > 0 ? extraFields : undefined,\n\t};\n}\n\nexport function serializeJsonChain(config: ChainConfig): string {\n\tconst root: Record<string, unknown> = {\n\t\tname: frontmatterNameForConfig(config),\n\t\tdescription: config.description,\n\t\tchain: config.steps,\n\t};\n\tif (config.packageName) root.package = config.packageName;\n\tif (config.extraFields) {\n\t\tfor (const [key, value] of Object.entries(config.extraFields)) {\n\t\t\tif (key !== \"name\" && key !== \"description\" && key !== \"package\" && key !== \"chain\") root[key] = value;\n\t\t}\n\t}\n\treturn `${JSON.stringify(root, null, 2)}\\n`;\n}\n\nexport function serializeChain(config: ChainConfig): string {\n\tconst lines: string[] = [];\n\tlines.push(\"---\");\n\tlines.push(`name: ${frontmatterNameForConfig(config)}`);\n\tif (config.packageName) lines.push(`package: ${config.packageName}`);\n\tlines.push(`description: ${config.description}`);\n\tif (config.extraFields) {\n\t\tfor (const [key, value] of Object.entries(config.extraFields)) {\n\t\t\tlines.push(`${key}: ${value}`);\n\t\t}\n\t}\n\tlines.push(\"---\");\n\tlines.push(\"\");\n\n\tfor (let i = 0; i < config.steps.length; i++) {\n\t\tconst step = config.steps[i]!;\n\t\tlines.push(`## ${step.agent}`);\n\t\tif (step.output === false) lines.push(\"output: false\");\n\t\telse if (step.output) lines.push(`output: ${step.output}`);\n\t\tif (step.phase) lines.push(`phase: ${step.phase}`);\n\t\tif (step.label) lines.push(`label: ${step.label}`);\n\t\tif (step.as) lines.push(`as: ${step.as}`);\n\t\tif (step.outputSchema) lines.push(`outputSchema: ${step.outputSchema}`);\n\t\tif (step.outputMode) lines.push(`outputMode: ${step.outputMode}`);\n\t\tif (step.reads === false) lines.push(\"reads: false\");\n\t\telse if (Array.isArray(step.reads) && step.reads.length > 0) lines.push(`reads: ${step.reads.join(\", \")}`);\n\t\tif (step.model) lines.push(`model: ${step.model}`);\n\t\tif (step.skills === false) lines.push(\"skills: false\");\n\t\telse if (Array.isArray(step.skills) && step.skills.length > 0) lines.push(`skills: ${step.skills.join(\", \")}`);\n\t\tif (step.progress !== undefined) lines.push(`progress: ${step.progress ? \"true\" : \"false\"}`);\n\t\tif (step.toolBudget !== undefined) lines.push(`toolBudget: ${JSON.stringify(step.toolBudget)}`);\n\t\tlines.push(\"\");\n\t\tlines.push(step.task ?? \"\");\n\t\tif (i < config.steps.length - 1) lines.push(\"\");\n\t}\n\n\treturn `${lines.join(\"\\n\")}\\n`;\n}\n"]}

package/dist/builtin-extensions/pi-subagents/src/agents/frontmatter.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Parse YAML frontmatter from agent/chain files.
+ * Handles both flat (key: value) and nested block (key: \n  sub: val) values.
+ * Block values are stored as single strings with embedded newlines.
+ * The indentation of the block content is preserved relative to the key.
+ */
+export declare function parseFrontmatter(content: string): {
+    frontmatter: Record<string, string>;
+    body: string;
+};
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/builtin-extensions/pi-subagents/src/agents/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../../../../src/builtin-extensions/pi-subagents/src/agents/frontmatter.ts"],"names":[],"mappings":"AAQA;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CA+EvG","sourcesContent":["// @ts-nocheck\n/**\n * Escape regex special characters for use in a RegExp constructor.\n */\nfunction escapeRegex(s: string): string {\n\treturn s.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n}\n\n/**\n * Parse YAML frontmatter from agent/chain files.\n * Handles both flat (key: value) and nested block (key: \\n  sub: val) values.\n * Block values are stored as single strings with embedded newlines.\n * The indentation of the block content is preserved relative to the key.\n */\nexport function parseFrontmatter(content: string): { frontmatter: Record<string, string>; body: string } {\n\tconst frontmatter: Record<string, string> = {};\n\tconst normalized = content.replace(/\\r\\n/g, \"\\n\");\n\n\tif (!normalized.startsWith(\"---\")) {\n\t\treturn { frontmatter, body: normalized };\n\t}\n\n\tconst endIndex = normalized.indexOf(\"\\n---\", 3);\n\tif (endIndex === -1) {\n\t\treturn { frontmatter, body: normalized };\n\t}\n\n\tconst frontmatterBlock = normalized.slice(4, endIndex);\n\tconst body = normalized.slice(endIndex + 4).trim();\n\n\tconst lines = frontmatterBlock.split(\"\\n\");\n\tlet currentKey: string | null = null;\n\tlet currentBlockLines: string[] | null = null;\n\tlet currentIndent: number | null = null;\n\n\tfor (const line of lines) {\n\t\tconst indent = line.search(/\\S|$/); // position of first non-whitespace char\n\t\tconst trimmed = line.trim();\n\n\t\tif (currentKey !== null && currentBlockLines !== null && indent > (currentIndent ?? 0)) {\n\t\t\t// This line is part of the current block value\n\t\t\tcurrentBlockLines.push(line);\n\t\t\tcontinue;\n\t\t}\n\n\t\t// Flush any pending block value\n\t\tif (currentKey !== null && currentBlockLines !== null) {\n\t\t\t// Strip the common leading whitespace from the block so the\n\t\t\t// serializer can add its own indentation level.\n\t\t\tconst rawBlock = currentBlockLines.join(\"\\n\");\n\t\t\tconst leadingSpaces = rawBlock.match(/^([ \\t]+)/m);\n\t\t\tconst prefix = leadingSpaces?.[1] ?? \"\";\n\t\t\tconst stripped = prefix\n\t\t\t\t? rawBlock.replace(new RegExp(`^${escapeRegex(prefix)}`, \"gm\"), \"\").replace(/^\\n/, \"\")\n\t\t\t\t: rawBlock;\n\t\t\tfrontmatter[currentKey] = stripped;\n\t\t\tcurrentKey = null;\n\t\t\tcurrentBlockLines = null;\n\t\t\tcurrentIndent = null;\n\t\t}\n\n\t\tconst match = line.match(/^([\\w-]+):\\s*(.*)$/);\n\t\tif (match) {\n\t\t\tlet value = match[2].trim();\n\t\t\tif ((value.startsWith('\"') && value.endsWith('\"')) || (value.startsWith(\"'\") && value.endsWith(\"'\"))) {\n\t\t\t\tvalue = value.slice(1, -1);\n\t\t\t}\n\n\t\t\tif (value === \"\") {\n\t\t\t\t// Key with empty value — might start a block; defer storing until we see indent\n\t\t\t\tcurrentKey = match[1];\n\t\t\t\tcurrentBlockLines = [];\n\t\t\t\tcurrentIndent = indent;\n\t\t\t} else {\n\t\t\t\t// Simple key: value\n\t\t\t\tfrontmatter[match[1]] = value;\n\t\t\t}\n\t\t}\n\t\t// Lines that don't match a key pattern (e.g., comments, empty lines) are ignored\n\t}\n\n\t// Flush final block value\n\tif (currentKey !== null && currentBlockLines !== null) {\n\t\tconst rawBlock = currentBlockLines.join(\"\\n\");\n\t\tconst leadingSpaces = rawBlock.match(/^([ \\t]+)/m);\n\t\tconst prefix = leadingSpaces?.[1] ?? \"\";\n\t\tconst stripped = prefix\n\t\t\t? rawBlock.replace(new RegExp(`^${escapeRegex(prefix)}`, \"gm\"), \"\").replace(/^\\n/, \"\")\n\t\t\t: rawBlock;\n\t\tfrontmatter[currentKey] = stripped;\n\t}\n\n\treturn { frontmatter, body };\n}\n"]}

package/dist/builtin-extensions/pi-subagents/src/agents/frontmatter.js

@@ -0,0 +1,84 @@
+// @ts-nocheck
+/**
+ * Escape regex special characters for use in a RegExp constructor.
+ */
+function escapeRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/**
+ * Parse YAML frontmatter from agent/chain files.
+ * Handles both flat (key: value) and nested block (key: \n  sub: val) values.
+ * Block values are stored as single strings with embedded newlines.
+ * The indentation of the block content is preserved relative to the key.
+ */
+export function parseFrontmatter(content) {
+    const frontmatter = {};
+    const normalized = content.replace(/\r\n/g, "\n");
+    if (!normalized.startsWith("---")) {
+        return { frontmatter, body: normalized };
+    }
+    const endIndex = normalized.indexOf("\n---", 3);
+    if (endIndex === -1) {
+        return { frontmatter, body: normalized };
+    }
+    const frontmatterBlock = normalized.slice(4, endIndex);
+    const body = normalized.slice(endIndex + 4).trim();
+    const lines = frontmatterBlock.split("\n");
+    let currentKey = null;
+    let currentBlockLines = null;
+    let currentIndent = null;
+    for (const line of lines) {
+        const indent = line.search(/\S|$/); // position of first non-whitespace char
+        const trimmed = line.trim();
+        if (currentKey !== null && currentBlockLines !== null && indent > (currentIndent ?? 0)) {
+            // This line is part of the current block value
+            currentBlockLines.push(line);
+            continue;
+        }
+        // Flush any pending block value
+        if (currentKey !== null && currentBlockLines !== null) {
+            // Strip the common leading whitespace from the block so the
+            // serializer can add its own indentation level.
+            const rawBlock = currentBlockLines.join("\n");
+            const leadingSpaces = rawBlock.match(/^([ \t]+)/m);
+            const prefix = leadingSpaces?.[1] ?? "";
+            const stripped = prefix
+                ? rawBlock.replace(new RegExp(`^${escapeRegex(prefix)}`, "gm"), "").replace(/^\n/, "")
+                : rawBlock;
+            frontmatter[currentKey] = stripped;
+            currentKey = null;
+            currentBlockLines = null;
+            currentIndent = null;
+        }
+        const match = line.match(/^([\w-]+):\s*(.*)$/);
+        if (match) {
+            let value = match[2].trim();
+            if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
+                value = value.slice(1, -1);
+            }
+            if (value === "") {
+                // Key with empty value — might start a block; defer storing until we see indent
+                currentKey = match[1];
+                currentBlockLines = [];
+                currentIndent = indent;
+            }
+            else {
+                // Simple key: value
+                frontmatter[match[1]] = value;
+            }
+        }
+        // Lines that don't match a key pattern (e.g., comments, empty lines) are ignored
+    }
+    // Flush final block value
+    if (currentKey !== null && currentBlockLines !== null) {
+        const rawBlock = currentBlockLines.join("\n");
+        const leadingSpaces = rawBlock.match(/^([ \t]+)/m);
+        const prefix = leadingSpaces?.[1] ?? "";
+        const stripped = prefix
+            ? rawBlock.replace(new RegExp(`^${escapeRegex(prefix)}`, "gm"), "").replace(/^\n/, "")
+            : rawBlock;
+        frontmatter[currentKey] = stripped;
+    }
+    return { frontmatter, body };
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/builtin-extensions/pi-subagents/src/agents/frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../../../../src/builtin-extensions/pi-subagents/src/agents/frontmatter.ts"],"names":[],"mappings":"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","sourcesContent":["// @ts-nocheck\n/**\n * Escape regex special characters for use in a RegExp constructor.\n */\nfunction escapeRegex(s: string): string {\n\treturn s.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n}\n\n/**\n * Parse YAML frontmatter from agent/chain files.\n * Handles both flat (key: value) and nested block (key: \\n  sub: val) values.\n * Block values are stored as single strings with embedded newlines.\n * The indentation of the block content is preserved relative to the key.\n */\nexport function parseFrontmatter(content: string): { frontmatter: Record<string, string>; body: string } {\n\tconst frontmatter: Record<string, string> = {};\n\tconst normalized = content.replace(/\\r\\n/g, \"\\n\");\n\n\tif (!normalized.startsWith(\"---\")) {\n\t\treturn { frontmatter, body: normalized };\n\t}\n\n\tconst endIndex = normalized.indexOf(\"\\n---\", 3);\n\tif (endIndex === -1) {\n\t\treturn { frontmatter, body: normalized };\n\t}\n\n\tconst frontmatterBlock = normalized.slice(4, endIndex);\n\tconst body = normalized.slice(endIndex + 4).trim();\n\n\tconst lines = frontmatterBlock.split(\"\\n\");\n\tlet currentKey: string | null = null;\n\tlet currentBlockLines: string[] | null = null;\n\tlet currentIndent: number | null = null;\n\n\tfor (const line of lines) {\n\t\tconst indent = line.search(/\\S|$/); // position of first non-whitespace char\n\t\tconst trimmed = line.trim();\n\n\t\tif (currentKey !== null && currentBlockLines !== null && indent > (currentIndent ?? 0)) {\n\t\t\t// This line is part of the current block value\n\t\t\tcurrentBlockLines.push(line);\n\t\t\tcontinue;\n\t\t}\n\n\t\t// Flush any pending block value\n\t\tif (currentKey !== null && currentBlockLines !== null) {\n\t\t\t// Strip the common leading whitespace from the block so the\n\t\t\t// serializer can add its own indentation level.\n\t\t\tconst rawBlock = currentBlockLines.join(\"\\n\");\n\t\t\tconst leadingSpaces = rawBlock.match(/^([ \\t]+)/m);\n\t\t\tconst prefix = leadingSpaces?.[1] ?? \"\";\n\t\t\tconst stripped = prefix\n\t\t\t\t? rawBlock.replace(new RegExp(`^${escapeRegex(prefix)}`, \"gm\"), \"\").replace(/^\\n/, \"\")\n\t\t\t\t: rawBlock;\n\t\t\tfrontmatter[currentKey] = stripped;\n\t\t\tcurrentKey = null;\n\t\t\tcurrentBlockLines = null;\n\t\t\tcurrentIndent = null;\n\t\t}\n\n\t\tconst match = line.match(/^([\\w-]+):\\s*(.*)$/);\n\t\tif (match) {\n\t\t\tlet value = match[2].trim();\n\t\t\tif ((value.startsWith('\"') && value.endsWith('\"')) || (value.startsWith(\"'\") && value.endsWith(\"'\"))) {\n\t\t\t\tvalue = value.slice(1, -1);\n\t\t\t}\n\n\t\t\tif (value === \"\") {\n\t\t\t\t// Key with empty value — might start a block; defer storing until we see indent\n\t\t\t\tcurrentKey = match[1];\n\t\t\t\tcurrentBlockLines = [];\n\t\t\t\tcurrentIndent = indent;\n\t\t\t} else {\n\t\t\t\t// Simple key: value\n\t\t\t\tfrontmatter[match[1]] = value;\n\t\t\t}\n\t\t}\n\t\t// Lines that don't match a key pattern (e.g., comments, empty lines) are ignored\n\t}\n\n\t// Flush final block value\n\tif (currentKey !== null && currentBlockLines !== null) {\n\t\tconst rawBlock = currentBlockLines.join(\"\\n\");\n\t\tconst leadingSpaces = rawBlock.match(/^([ \\t]+)/m);\n\t\tconst prefix = leadingSpaces?.[1] ?? \"\";\n\t\tconst stripped = prefix\n\t\t\t? rawBlock.replace(new RegExp(`^${escapeRegex(prefix)}`, \"gm\"), \"\").replace(/^\\n/, \"\")\n\t\t\t: rawBlock;\n\t\tfrontmatter[currentKey] = stripped;\n\t}\n\n\treturn { frontmatter, body };\n}\n"]}

package/dist/builtin-extensions/pi-subagents/src/agents/identity.d.ts

@@ -0,0 +1,8 @@
+import type { AgentConfig, ChainConfig } from "./agents.ts";
+export declare function parsePackageName(value: unknown, label?: string): {
+    packageName?: string;
+    error?: string;
+};
+export declare function buildRuntimeName(localName: string, packageName?: string): string;
+export declare function frontmatterNameForConfig(config: Pick<AgentConfig | ChainConfig, "name" | "localName" | "packageName">): string;
+//# sourceMappingURL=identity.d.ts.map

package/dist/builtin-extensions/pi-subagents/src/agents/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../../../../src/builtin-extensions/pi-subagents/src/agents/identity.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAU5D,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,SAAY,GAAG;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAM5G;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAGhF;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,GAAG,WAAW,EAAE,MAAM,GAAG,WAAW,GAAG,aAAa,CAAC,GAAG,MAAM,CAM9H","sourcesContent":["// @ts-nocheck\nimport type { AgentConfig, ChainConfig } from \"./agents.ts\";\n\nconst IDENTIFIER_PATTERN = /^[a-z0-9][a-z0-9-]*(?:\\.[a-z0-9][a-z0-9-]*)*$/;\n\nfunction normalizePackageName(value: string | undefined): string | undefined {\n\tconst trimmed = value?.trim();\n\tif (!trimmed) return undefined;\n\treturn trimmed.toLowerCase().replace(/\\s+/g, \"-\").replace(/[^a-z0-9.-]/g, \"\").replace(/-+/g, \"-\").replace(/\\.+/g, \".\").replace(/(?:^[-.]+|[-.]+$)/g, \"\");\n}\n\nexport function parsePackageName(value: unknown, label = \"package\"): { packageName?: string; error?: string } {\n\tif (value === undefined || value === false || value === \"\") return { packageName: undefined };\n\tif (typeof value !== \"string\") return { error: `${label} must be a string or false when provided.` };\n\tconst packageName = normalizePackageName(value);\n\tif (!packageName || !IDENTIFIER_PATTERN.test(packageName)) return { error: `${label} is invalid after sanitization.` };\n\treturn { packageName };\n}\n\nexport function buildRuntimeName(localName: string, packageName?: string): string {\n\tconst trimmedPackage = packageName?.trim();\n\treturn trimmedPackage ? `${trimmedPackage}.${localName}` : localName;\n}\n\nexport function frontmatterNameForConfig(config: Pick<AgentConfig | ChainConfig, \"name\" | \"localName\" | \"packageName\">): string {\n\tif (config.localName) return config.localName;\n\tif (config.packageName && config.name.startsWith(`${config.packageName}.`)) {\n\t\treturn config.name.slice(config.packageName.length + 1);\n\t}\n\treturn config.name;\n}\n"]}

package/dist/builtin-extensions/pi-subagents/src/agents/identity.js

@@ -0,0 +1,30 @@
+const IDENTIFIER_PATTERN = /^[a-z0-9][a-z0-9-]*(?:\.[a-z0-9][a-z0-9-]*)*$/;
+function normalizePackageName(value) {
+    const trimmed = value?.trim();
+    if (!trimmed)
+        return undefined;
+    return trimmed.toLowerCase().replace(/\s+/g, "-").replace(/[^a-z0-9.-]/g, "").replace(/-+/g, "-").replace(/\.+/g, ".").replace(/(?:^[-.]+|[-.]+$)/g, "");
+}
+export function parsePackageName(value, label = "package") {
+    if (value === undefined || value === false || value === "")
+        return { packageName: undefined };
+    if (typeof value !== "string")
+        return { error: `${label} must be a string or false when provided.` };
+    const packageName = normalizePackageName(value);
+    if (!packageName || !IDENTIFIER_PATTERN.test(packageName))
+        return { error: `${label} is invalid after sanitization.` };
+    return { packageName };
+}
+export function buildRuntimeName(localName, packageName) {
+    const trimmedPackage = packageName?.trim();
+    return trimmedPackage ? `${trimmedPackage}.${localName}` : localName;
+}
+export function frontmatterNameForConfig(config) {
+    if (config.localName)
+        return config.localName;
+    if (config.packageName && config.name.startsWith(`${config.packageName}.`)) {
+        return config.name.slice(config.packageName.length + 1);
+    }
+    return config.name;
+}
+//# sourceMappingURL=identity.js.map

package/dist/builtin-extensions/pi-subagents/src/agents/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../../../../src/builtin-extensions/pi-subagents/src/agents/identity.ts"],"names":[],"mappings":"AAGA,MAAM,kBAAkB,GAAG,+CAA+C,CAAC;AAE3E,SAAS,oBAAoB,CAAC,KAAyB,EAAsB;IAC5E,MAAM,OAAO,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,OAAO,OAAO,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;AAAA,CACzJ;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc,EAAE,KAAK,GAAG,SAAS,EAA4C;IAC7G,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;IAC9F,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,EAAE,KAAK,EAAE,GAAG,KAAK,2CAA2C,EAAE,CAAC;IACrG,MAAM,WAAW,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAChD,IAAI,CAAC,WAAW,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,WAAW,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,GAAG,KAAK,iCAAiC,EAAE,CAAC;IACvH,OAAO,EAAE,WAAW,EAAE,CAAC;AAAA,CACvB;AAED,MAAM,UAAU,gBAAgB,CAAC,SAAiB,EAAE,WAAoB,EAAU;IACjF,MAAM,cAAc,GAAG,WAAW,EAAE,IAAI,EAAE,CAAC;IAC3C,OAAO,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAAA,CACrE;AAED,MAAM,UAAU,wBAAwB,CAAC,MAA6E,EAAU;IAC/H,IAAI,MAAM,CAAC,SAAS;QAAE,OAAO,MAAM,CAAC,SAAS,CAAC;IAC9C,IAAI,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC;QAC5E,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AAAA,CACnB","sourcesContent":["// @ts-nocheck\nimport type { AgentConfig, ChainConfig } from \"./agents.ts\";\n\nconst IDENTIFIER_PATTERN = /^[a-z0-9][a-z0-9-]*(?:\\.[a-z0-9][a-z0-9-]*)*$/;\n\nfunction normalizePackageName(value: string | undefined): string | undefined {\n\tconst trimmed = value?.trim();\n\tif (!trimmed) return undefined;\n\treturn trimmed.toLowerCase().replace(/\\s+/g, \"-\").replace(/[^a-z0-9.-]/g, \"\").replace(/-+/g, \"-\").replace(/\\.+/g, \".\").replace(/(?:^[-.]+|[-.]+$)/g, \"\");\n}\n\nexport function parsePackageName(value: unknown, label = \"package\"): { packageName?: string; error?: string } {\n\tif (value === undefined || value === false || value === \"\") return { packageName: undefined };\n\tif (typeof value !== \"string\") return { error: `${label} must be a string or false when provided.` };\n\tconst packageName = normalizePackageName(value);\n\tif (!packageName || !IDENTIFIER_PATTERN.test(packageName)) return { error: `${label} is invalid after sanitization.` };\n\treturn { packageName };\n}\n\nexport function buildRuntimeName(localName: string, packageName?: string): string {\n\tconst trimmedPackage = packageName?.trim();\n\treturn trimmedPackage ? `${trimmedPackage}.${localName}` : localName;\n}\n\nexport function frontmatterNameForConfig(config: Pick<AgentConfig | ChainConfig, \"name\" | \"localName\" | \"packageName\">): string {\n\tif (config.localName) return config.localName;\n\tif (config.packageName && config.name.startsWith(`${config.packageName}.`)) {\n\t\treturn config.name.slice(config.packageName.length + 1);\n\t}\n\treturn config.name;\n}\n"]}

package/dist/builtin-extensions/pi-subagents/src/agents/proactive-skills.d.ts

@@ -0,0 +1,35 @@
+import type { AgentConfig, ChainConfig } from "./agents.ts";
+import type { ProactiveSkillSubagentsConfig } from "../shared/types.ts";
+export interface ResolvedProactiveSkillSubagentsConfig {
+    enabled: boolean;
+    minReferences: number;
+    maxRecommendations: number;
+    preferredAgent: string;
+}
+export interface ProactiveSkillSubagentRecommendation {
+    skill: string;
+    agent: string;
+    references: number;
+    sources: string[];
+    description?: string;
+    reason: string;
+}
+export interface AvailableSkill {
+    name: string;
+    description?: string;
+}
+export declare function resolveProactiveSkillSubagentsConfig(config?: ProactiveSkillSubagentsConfig | false): ResolvedProactiveSkillSubagentsConfig;
+export declare function recommendProactiveSkillSubagents(input: {
+    agents: AgentConfig[];
+    chains?: ChainConfig[];
+    availableSkills?: AvailableSkill[];
+    config?: ProactiveSkillSubagentsConfig | false;
+}): ProactiveSkillSubagentRecommendation[];
+export declare function formatProactiveSkillSubagentRecommendations(recommendations: ProactiveSkillSubagentRecommendation[]): string[];
+export declare function buildProactiveSkillSubagentRecommendationLines(input: {
+    agents: AgentConfig[];
+    chains?: ChainConfig[];
+    config?: ProactiveSkillSubagentsConfig | false;
+    discoverAvailableSkills: () => AvailableSkill[];
+}): string[];
+//# sourceMappingURL=proactive-skills.d.ts.map

package/dist/builtin-extensions/pi-subagents/src/agents/proactive-skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proactive-skills.d.ts","sourceRoot":"","sources":["../../../../../src/builtin-extensions/pi-subagents/src/agents/proactive-skills.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAmB,MAAM,aAAa,CAAC;AAC7E,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,oBAAoB,CAAC;AASxE,MAAM,WAAW,qCAAqC;IACrD,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,oCAAoC;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAQD,wBAAgB,oCAAoC,CACnD,MAAM,CAAC,EAAE,6BAA6B,GAAG,KAAK,GAC5C,qCAAqC,CAmBvC;AAiDD,wBAAgB,gCAAgC,CAAC,KAAK,EAAE;IACvD,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;IACvB,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;IACnC,MAAM,CAAC,EAAE,6BAA6B,GAAG,KAAK,CAAC;CAC/C,GAAG,oCAAoC,EAAE,CAyCzC;AAED,wBAAgB,2CAA2C,CAC1D,eAAe,EAAE,oCAAoC,EAAE,GACrD,MAAM,EAAE,CAYV;AAED,wBAAgB,8CAA8C,CAAC,KAAK,EAAE;IACrE,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;IACvB,MAAM,CAAC,EAAE,6BAA6B,GAAG,KAAK,CAAC;IAC/C,uBAAuB,EAAE,MAAM,cAAc,EAAE,CAAC;CAChD,GAAG,MAAM,EAAE,CAcX","sourcesContent":["// @ts-nocheck\nimport type { AgentConfig, ChainConfig, ChainStepConfig } from \"./agents.ts\";\nimport type { ProactiveSkillSubagentsConfig } from \"../shared/types.ts\";\n\nconst SUBAGENT_ORCHESTRATION_SKILL = \"pi-subagents\";\nconst DEFAULT_MIN_REFERENCES = 2;\nconst DEFAULT_MAX_RECOMMENDATIONS = 3;\nconst DEFAULT_PREFERRED_AGENT = \"reviewer\";\nconst FALLBACK_AGENT_ORDER = [\"reviewer\", \"context-builder\", \"delegate\"];\nconst MAX_RECOMMENDATION_CAP = 5;\n\nexport interface ResolvedProactiveSkillSubagentsConfig {\n\tenabled: boolean;\n\tminReferences: number;\n\tmaxRecommendations: number;\n\tpreferredAgent: string;\n}\n\nexport interface ProactiveSkillSubagentRecommendation {\n\tskill: string;\n\tagent: string;\n\treferences: number;\n\tsources: string[];\n\tdescription?: string;\n\treason: string;\n}\n\nexport interface AvailableSkill {\n\tname: string;\n\tdescription?: string;\n}\n\nfunction positiveInteger(value: unknown): number | undefined {\n\tif (typeof value !== \"number\") return undefined;\n\tif (!Number.isInteger(value) || !Number.isFinite(value) || value < 1) return undefined;\n\treturn value;\n}\n\nexport function resolveProactiveSkillSubagentsConfig(\n\tconfig?: ProactiveSkillSubagentsConfig | false,\n): ResolvedProactiveSkillSubagentsConfig {\n\tif (config === false) {\n\t\treturn {\n\t\t\tenabled: false,\n\t\t\tminReferences: DEFAULT_MIN_REFERENCES,\n\t\t\tmaxRecommendations: DEFAULT_MAX_RECOMMENDATIONS,\n\t\t\tpreferredAgent: DEFAULT_PREFERRED_AGENT,\n\t\t};\n\t}\n\n\tconst maxRecommendations = positiveInteger(config?.maxRecommendations) ?? DEFAULT_MAX_RECOMMENDATIONS;\n\treturn {\n\t\tenabled: config?.enabled ?? true,\n\t\tminReferences: positiveInteger(config?.minReferences) ?? DEFAULT_MIN_REFERENCES,\n\t\tmaxRecommendations: Math.min(maxRecommendations, MAX_RECOMMENDATION_CAP),\n\t\tpreferredAgent: typeof config?.preferredAgent === \"string\" && config.preferredAgent.trim()\n\t\t\t? config.preferredAgent.trim()\n\t\t\t: DEFAULT_PREFERRED_AGENT,\n\t};\n}\n\nfunction normalizeSkillNames(value: unknown): string[] {\n\tif (value === false || value === true || value === undefined || value === null) return [];\n\tif (Array.isArray(value)) {\n\t\treturn [...new Set(value.filter((entry): entry is string => typeof entry === \"string\").map((entry) => entry.trim()).filter(Boolean))];\n\t}\n\tif (typeof value === \"string\") {\n\t\treturn [...new Set(value.split(\",\").map((entry) => entry.trim()).filter(Boolean))];\n\t}\n\treturn [];\n}\n\nfunction collectStepSkills(step: ChainStepConfig, out: Set<string>): void {\n\tfor (const skill of normalizeSkillNames(step.skills ?? (step as { skill?: unknown }).skill)) {\n\t\tout.add(skill);\n\t}\n\n\tconst parallel = step.parallel;\n\tif (!parallel) return;\n\tif (Array.isArray(parallel)) {\n\t\tfor (const child of parallel) {\n\t\t\tif (child && typeof child === \"object\" && !Array.isArray(child)) {\n\t\t\t\tcollectStepSkills(child as ChainStepConfig, out);\n\t\t\t}\n\t\t}\n\t\treturn;\n\t}\n\tif (typeof parallel === \"object\") {\n\t\tcollectStepSkills(parallel as ChainStepConfig, out);\n\t}\n}\n\nfunction chooseRecommendationAgent(agents: AgentConfig[], preferredAgent: string): string | undefined {\n\tconst enabled = agents.filter((agent) => !agent.disabled);\n\tif (enabled.some((agent) => agent.name === preferredAgent)) return preferredAgent;\n\tfor (const name of FALLBACK_AGENT_ORDER) {\n\t\tif (enabled.some((agent) => agent.name === name)) return name;\n\t}\n\treturn enabled[0]?.name;\n}\n\nfunction addSource(counts: Map<string, Set<string>>, skill: string, source: string): void {\n\tif (skill === SUBAGENT_ORCHESTRATION_SKILL) return;\n\tconst sources = counts.get(skill) ?? new Set<string>();\n\tsources.add(source);\n\tcounts.set(skill, sources);\n}\n\nexport function recommendProactiveSkillSubagents(input: {\n\tagents: AgentConfig[];\n\tchains?: ChainConfig[];\n\tavailableSkills?: AvailableSkill[];\n\tconfig?: ProactiveSkillSubagentsConfig | false;\n}): ProactiveSkillSubagentRecommendation[] {\n\tconst config = resolveProactiveSkillSubagentsConfig(input.config);\n\tif (!config.enabled) return [];\n\n\tconst agent = chooseRecommendationAgent(input.agents, config.preferredAgent);\n\tif (!agent) return [];\n\n\tconst availableByName = input.availableSkills\n\t\t? new Map(input.availableSkills.map((skill) => [skill.name, skill]))\n\t\t: undefined;\n\tconst counts = new Map<string, Set<string>>();\n\n\tfor (const candidate of input.agents) {\n\t\tif (candidate.disabled) continue;\n\t\tfor (const skill of candidate.skills ?? []) {\n\t\t\taddSource(counts, skill, `agent:${candidate.name}`);\n\t\t}\n\t}\n\n\tfor (const chain of input.chains ?? []) {\n\t\tconst chainSkills = new Set<string>();\n\t\tfor (const step of chain.steps) {\n\t\t\tcollectStepSkills(step, chainSkills);\n\t\t}\n\t\tfor (const skill of chainSkills) {\n\t\t\taddSource(counts, skill, `chain:${chain.name}`);\n\t\t}\n\t}\n\n\treturn [...counts.entries()]\n\t\t.filter(([skill, sources]) => sources.size >= config.minReferences && (!availableByName || availableByName.has(skill)))\n\t\t.map(([skill, sources]) => ({\n\t\t\tskill,\n\t\t\tagent,\n\t\t\treferences: sources.size,\n\t\t\tsources: [...sources].sort((a, b) => a.localeCompare(b)),\n\t\t\tdescription: availableByName?.get(skill)?.description,\n\t\t\treason: `referenced by ${sources.size} configured agents/chains`,\n\t\t}))\n\t\t.sort((a, b) => b.references - a.references || a.skill.localeCompare(b.skill))\n\t\t.slice(0, config.maxRecommendations);\n}\n\nexport function formatProactiveSkillSubagentRecommendations(\n\trecommendations: ProactiveSkillSubagentRecommendation[],\n): string[] {\n\tif (recommendations.length === 0) return [];\n\treturn [\n\t\t\"Proactive skill subagent suggestions:\",\n\t\t...recommendations.map((recommendation) => {\n\t\t\tconst sampleSources = recommendation.sources.slice(0, 3).join(\", \");\n\t\t\tconst extra = recommendation.sources.length > 3 ? `, +${recommendation.sources.length - 3} more` : \"\";\n\t\t\tconst description = recommendation.description ? ` - ${recommendation.description}` : \"\";\n\t\t\treturn `- ${recommendation.skill} via ${recommendation.agent} (${recommendation.reason}; ${sampleSources}${extra})${description}`;\n\t\t}),\n\t\t\"Guardrails: use these for broad tasks where a skill-specialist pass is useful; keep fanout small, use fresh context unless private/session context is explicitly needed, and skip when the user asks for a direct answer.\",\n\t];\n}\n\nexport function buildProactiveSkillSubagentRecommendationLines(input: {\n\tagents: AgentConfig[];\n\tchains?: ChainConfig[];\n\tconfig?: ProactiveSkillSubagentsConfig | false;\n\tdiscoverAvailableSkills: () => AvailableSkill[];\n}): string[] {\n\tif (!resolveProactiveSkillSubagentsConfig(input.config).enabled) return [];\n\tlet availableSkills: AvailableSkill[];\n\ttry {\n\t\tavailableSkills = input.discoverAvailableSkills();\n\t} catch {\n\t\tavailableSkills = [];\n\t}\n\treturn formatProactiveSkillSubagentRecommendations(recommendProactiveSkillSubagents({\n\t\tagents: input.agents,\n\t\tchains: input.chains,\n\t\tavailableSkills,\n\t\tconfig: input.config,\n\t}));\n}\n"]}