@ashx-j/lunr 0.1.0

package/dist/builtin-extensions/pi-subagents/src/runs/shared/completion-guard.d.ts

@@ -0,0 +1,19 @@
+import type { Message } from "@earendil-works/pi-ai";
+import { expectsImplementationMutation } from "./task-intent.ts";
+export { expectsImplementationMutation };
+interface CompletionMutationGuardInput {
+    agent: string;
+    task: string;
+    messages: Message[];
+    tools?: string[];
+    mcpDirectTools?: string[];
+}
+interface CompletionMutationGuardResult {
+    expectedMutation: boolean;
+    attemptedMutation: boolean;
+    triggered: boolean;
+}
+export declare function hasMutationToolCapability(tools: string[] | undefined, mcpDirectTools: string[] | undefined): boolean;
+export declare function hasMutationToolCall(messages: Message[]): boolean;
+export declare function evaluateCompletionMutationGuard(input: CompletionMutationGuardInput): CompletionMutationGuardResult;
+//# sourceMappingURL=completion-guard.d.ts.map

package/dist/builtin-extensions/pi-subagents/src/runs/shared/completion-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion-guard.d.ts","sourceRoot":"","sources":["../../../../../../src/builtin-extensions/pi-subagents/src/runs/shared/completion-guard.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,EAAE,6BAA6B,EAAE,MAAM,kBAAkB,CAAC;AAEjE,OAAO,EAAE,6BAA6B,EAAE,CAAC;AAczC,UAAU,4BAA4B;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,UAAU,6BAA6B;IACtC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,SAAS,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,OAAO,CAGpH;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAchE;AAED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,4BAA4B,GAAG,6BAA6B,CAUlH","sourcesContent":["// @ts-nocheck\nimport type { Message } from \"@earendil-works/pi-ai\";\nimport { isMutatingBashCommand } from \"./long-running-guard.ts\";\nimport { expectsImplementationMutation } from \"./task-intent.ts\";\n\nexport { expectsImplementationMutation };\n\nconst READ_ONLY_BUILTIN_TOOLS = new Set([\n\t\"read\",\n\t\"grep\",\n\t\"find\",\n\t\"ls\",\n\t\"web_search\",\n\t\"fetch_content\",\n\t\"get_search_content\",\n\t\"intercom\",\n\t\"contact_supervisor\",\n]);\n\ninterface CompletionMutationGuardInput {\n\tagent: string;\n\ttask: string;\n\tmessages: Message[];\n\ttools?: string[];\n\tmcpDirectTools?: string[];\n}\n\ninterface CompletionMutationGuardResult {\n\texpectedMutation: boolean;\n\tattemptedMutation: boolean;\n\ttriggered: boolean;\n}\n\nexport function hasMutationToolCapability(tools: string[] | undefined, mcpDirectTools: string[] | undefined): boolean {\n\tif (tools === undefined || tools.length === 0 || (mcpDirectTools?.length ?? 0) > 0) return true;\n\treturn !tools.every((tool) => READ_ONLY_BUILTIN_TOOLS.has(tool));\n}\n\nexport function hasMutationToolCall(messages: Message[]): boolean {\n\tfor (const message of messages) {\n\t\tif (message.role !== \"assistant\") continue;\n\t\tfor (const part of message.content) {\n\t\t\tif (part.type !== \"toolCall\") continue;\n\t\t\tif (part.name === \"edit\" || part.name === \"write\") return true;\n\t\t\tif (part.name !== \"bash\") continue;\n\t\t\tconst args = typeof part.arguments === \"object\" && part.arguments !== null && !Array.isArray(part.arguments)\n\t\t\t\t? part.arguments as Record<string, unknown>\n\t\t\t\t: {};\n\t\t\tif (typeof args.command === \"string\" && isMutatingBashCommand(args.command)) return true;\n\t\t}\n\t}\n\treturn false;\n}\n\nexport function evaluateCompletionMutationGuard(input: CompletionMutationGuardInput): CompletionMutationGuardResult {\n\tconst expectedMutation = hasMutationToolCapability(input.tools, input.mcpDirectTools)\n\t\t? expectsImplementationMutation(input.agent, input.task)\n\t\t: false;\n\tconst attemptedMutation = hasMutationToolCall(input.messages);\n\treturn {\n\t\texpectedMutation,\n\t\tattemptedMutation,\n\t\ttriggered: expectedMutation && !attemptedMutation,\n\t};\n}\n"]}

package/dist/builtin-extensions/pi-subagents/src/runs/shared/completion-guard.js

@@ -0,0 +1,51 @@
+import { isMutatingBashCommand } from "./long-running-guard.js";
+import { expectsImplementationMutation } from "./task-intent.js";
+export { expectsImplementationMutation };
+const READ_ONLY_BUILTIN_TOOLS = new Set([
+    "read",
+    "grep",
+    "find",
+    "ls",
+    "web_search",
+    "fetch_content",
+    "get_search_content",
+    "intercom",
+    "contact_supervisor",
+]);
+export function hasMutationToolCapability(tools, mcpDirectTools) {
+    if (tools === undefined || tools.length === 0 || (mcpDirectTools?.length ?? 0) > 0)
+        return true;
+    return !tools.every((tool) => READ_ONLY_BUILTIN_TOOLS.has(tool));
+}
+export function hasMutationToolCall(messages) {
+    for (const message of messages) {
+        if (message.role !== "assistant")
+            continue;
+        for (const part of message.content) {
+            if (part.type !== "toolCall")
+                continue;
+            if (part.name === "edit" || part.name === "write")
+                return true;
+            if (part.name !== "bash")
+                continue;
+            const args = typeof part.arguments === "object" && part.arguments !== null && !Array.isArray(part.arguments)
+                ? part.arguments
+                : {};
+            if (typeof args.command === "string" && isMutatingBashCommand(args.command))
+                return true;
+        }
+    }
+    return false;
+}
+export function evaluateCompletionMutationGuard(input) {
+    const expectedMutation = hasMutationToolCapability(input.tools, input.mcpDirectTools)
+        ? expectsImplementationMutation(input.agent, input.task)
+        : false;
+    const attemptedMutation = hasMutationToolCall(input.messages);
+    return {
+        expectedMutation,
+        attemptedMutation,
+        triggered: expectedMutation && !attemptedMutation,
+    };
+}
+//# sourceMappingURL=completion-guard.js.map

package/dist/builtin-extensions/pi-subagents/src/runs/shared/completion-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion-guard.js","sourceRoot":"","sources":["../../../../../../src/builtin-extensions/pi-subagents/src/runs/shared/completion-guard.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,6BAA6B,EAAE,MAAM,kBAAkB,CAAC;AAEjE,OAAO,EAAE,6BAA6B,EAAE,CAAC;AAEzC,MAAM,uBAAuB,GAAG,IAAI,GAAG,CAAC;IACvC,MAAM;IACN,MAAM;IACN,MAAM;IACN,IAAI;IACJ,YAAY;IACZ,eAAe;IACf,oBAAoB;IACpB,UAAU;IACV,oBAAoB;CACpB,CAAC,CAAC;AAgBH,MAAM,UAAU,yBAAyB,CAAC,KAA2B,EAAE,cAAoC,EAAW;IACrH,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,cAAc,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAChG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,uBAAuB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;AAAA,CACjE;AAED,MAAM,UAAU,mBAAmB,CAAC,QAAmB,EAAW;IACjE,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAChC,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW;YAAE,SAAS;QAC3C,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpC,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU;gBAAE,SAAS;YACvC,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO;gBAAE,OAAO,IAAI,CAAC;YAC/D,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;gBAAE,SAAS;YACnC,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC;gBAC3G,CAAC,CAAC,IAAI,CAAC,SAAoC;gBAC3C,CAAC,CAAC,EAAE,CAAC;YACN,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,IAAI,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC;gBAAE,OAAO,IAAI,CAAC;QAC1F,CAAC;IACF,CAAC;IACD,OAAO,KAAK,CAAC;AAAA,CACb;AAED,MAAM,UAAU,+BAA+B,CAAC,KAAmC,EAAiC;IACnH,MAAM,gBAAgB,GAAG,yBAAyB,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,cAAc,CAAC;QACpF,CAAC,CAAC,6BAA6B,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC;QACxD,CAAC,CAAC,KAAK,CAAC;IACT,MAAM,iBAAiB,GAAG,mBAAmB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC9D,OAAO;QACN,gBAAgB;QAChB,iBAAiB;QACjB,SAAS,EAAE,gBAAgB,IAAI,CAAC,iBAAiB;KACjD,CAAC;AAAA,CACF","sourcesContent":["// @ts-nocheck\nimport type { Message } from \"@earendil-works/pi-ai\";\nimport { isMutatingBashCommand } from \"./long-running-guard.ts\";\nimport { expectsImplementationMutation } from \"./task-intent.ts\";\n\nexport { expectsImplementationMutation };\n\nconst READ_ONLY_BUILTIN_TOOLS = new Set([\n\t\"read\",\n\t\"grep\",\n\t\"find\",\n\t\"ls\",\n\t\"web_search\",\n\t\"fetch_content\",\n\t\"get_search_content\",\n\t\"intercom\",\n\t\"contact_supervisor\",\n]);\n\ninterface CompletionMutationGuardInput {\n\tagent: string;\n\ttask: string;\n\tmessages: Message[];\n\ttools?: string[];\n\tmcpDirectTools?: string[];\n}\n\ninterface CompletionMutationGuardResult {\n\texpectedMutation: boolean;\n\tattemptedMutation: boolean;\n\ttriggered: boolean;\n}\n\nexport function hasMutationToolCapability(tools: string[] | undefined, mcpDirectTools: string[] | undefined): boolean {\n\tif (tools === undefined || tools.length === 0 || (mcpDirectTools?.length ?? 0) > 0) return true;\n\treturn !tools.every((tool) => READ_ONLY_BUILTIN_TOOLS.has(tool));\n}\n\nexport function hasMutationToolCall(messages: Message[]): boolean {\n\tfor (const message of messages) {\n\t\tif (message.role !== \"assistant\") continue;\n\t\tfor (const part of message.content) {\n\t\t\tif (part.type !== \"toolCall\") continue;\n\t\t\tif (part.name === \"edit\" || part.name === \"write\") return true;\n\t\t\tif (part.name !== \"bash\") continue;\n\t\t\tconst args = typeof part.arguments === \"object\" && part.arguments !== null && !Array.isArray(part.arguments)\n\t\t\t\t? part.arguments as Record<string, unknown>\n\t\t\t\t: {};\n\t\t\tif (typeof args.command === \"string\" && isMutatingBashCommand(args.command)) return true;\n\t\t}\n\t}\n\treturn false;\n}\n\nexport function evaluateCompletionMutationGuard(input: CompletionMutationGuardInput): CompletionMutationGuardResult {\n\tconst expectedMutation = hasMutationToolCapability(input.tools, input.mcpDirectTools)\n\t\t? expectsImplementationMutation(input.agent, input.task)\n\t\t: false;\n\tconst attemptedMutation = hasMutationToolCall(input.messages);\n\treturn {\n\t\texpectedMutation,\n\t\tattemptedMutation,\n\t\ttriggered: expectedMutation && !attemptedMutation,\n\t};\n}\n"]}

package/dist/builtin-extensions/pi-subagents/src/runs/shared/dynamic-fanout.d.ts

@@ -0,0 +1,49 @@
+import type { DynamicParallelStep, ParallelTaskItem } from "../../shared/settings.ts";
+import type { ArtifactPaths, ChainOutputMap, JsonSchemaObject, SingleResult } from "../../shared/types.ts";
+export declare class DynamicFanoutError extends Error {
+}
+export interface DynamicFanoutConfig {
+    maxItems?: number;
+    allowRunnerFields?: boolean;
+}
+export interface DynamicMaterializedItem {
+    index: number;
+    key: string;
+    idKey: string;
+    item: unknown;
+}
+export interface DynamicCollectedResult {
+    key: string;
+    index: number;
+    item: unknown;
+    agent: string;
+    exitCode: number | null;
+    text: string;
+    structured?: unknown;
+    error?: string;
+    timedOut?: boolean;
+    stopped?: boolean;
+    outputPath?: string;
+    artifactPaths?: ArtifactPaths;
+}
+export interface DynamicMaterializedGroup {
+    items: DynamicMaterializedItem[];
+    parallel: ParallelTaskItem[];
+    collectedOnEmpty?: DynamicCollectedResult[];
+}
+export declare function isSafeOutputName(name: string): boolean;
+export declare function assertJsonPointer(pointer: string, label: string): void;
+export declare function resolveJsonPointer(value: unknown, pointer: string, label: string): unknown;
+export declare function normalizeItemKeyForId(key: string): string;
+export declare function resolveItemTemplate(template: string, itemName: string, item: unknown): string;
+export declare function assertNoUnresolvedItemReferences(template: string, itemName: string, label: string): void;
+export declare function hasDynamicFanoutFields(step: unknown): boolean;
+export declare function validateDynamicStepShape(step: DynamicParallelStep, stepIndex: number, config?: DynamicFanoutConfig): void;
+export declare function resolveDynamicFanoutItems(step: DynamicParallelStep, outputs: ChainOutputMap, stepIndex: number, config?: DynamicFanoutConfig): DynamicMaterializedItem[];
+export declare function materializeDynamicParallelStep(step: DynamicParallelStep, outputs: ChainOutputMap, stepIndex: number, config?: DynamicFanoutConfig): DynamicMaterializedGroup;
+export declare function collectDynamicResults(step: DynamicParallelStep, items: DynamicMaterializedItem[], results: Array<Pick<SingleResult, "agent" | "exitCode" | "error" | "timedOut" | "stopped" | "structuredOutput" | "artifactPaths" | "savedOutputPath"> & {
+    output?: string;
+    finalOutput?: string;
+}>): DynamicCollectedResult[];
+export declare function validateDynamicCollection(schema: JsonSchemaObject | undefined, value: DynamicCollectedResult[]): void;
+//# sourceMappingURL=dynamic-fanout.d.ts.map

package/dist/builtin-extensions/pi-subagents/src/runs/shared/dynamic-fanout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-fanout.d.ts","sourceRoot":"","sources":["../../../../../../src/builtin-extensions/pi-subagents/src/runs/shared/dynamic-fanout.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACtF,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAI3G,qBAAa,kBAAmB,SAAQ,KAAK;CAAG;AAEhD,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,uBAAuB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,sBAAsB;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,aAAa,CAAC;CAC9B;AAED,MAAM,WAAW,wBAAwB;IACxC,KAAK,EAAE,uBAAuB,EAAE,CAAC;IACjC,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,gBAAgB,CAAC,EAAE,sBAAsB,EAAE,CAAC;CAC5C;AAmBD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAUtE;AAMD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAyB1F;AAaD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAOzD;AAeD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAQ7F;AASD,wBAAgB,gCAAgC,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAqBxG;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAG7D;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAE,mBAAwB,GAAG,IAAI,CAgC7H;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAE,mBAAwB,GAAG,uBAAuB,EAAE,CAwB5K;AAED,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAE,mBAAwB,GAAG,wBAAwB,CAmBhL;AAED,wBAAgB,qBAAqB,CACpC,IAAI,EAAE,mBAAmB,EACzB,KAAK,EAAE,uBAAuB,EAAE,EAChC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,kBAAkB,GAAG,eAAe,GAAG,iBAAiB,CAAC,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAChM,sBAAsB,EAAE,CAqB1B;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,gBAAgB,GAAG,SAAS,EAAE,KAAK,EAAE,sBAAsB,EAAE,GAAG,IAAI,CAMrH","sourcesContent":["// @ts-nocheck\nimport type { DynamicParallelStep, ParallelTaskItem } from \"../../shared/settings.ts\";\nimport type { ArtifactPaths, ChainOutputMap, JsonSchemaObject, SingleResult } from \"../../shared/types.ts\";\nimport { getSingleResultOutput } from \"../../shared/utils.ts\";\nimport { validateStructuredOutputValue } from \"./structured-output.ts\";\n\nexport class DynamicFanoutError extends Error {}\n\nexport interface DynamicFanoutConfig {\n\tmaxItems?: number;\n\tallowRunnerFields?: boolean;\n}\n\nexport interface DynamicMaterializedItem {\n\tindex: number;\n\tkey: string;\n\tidKey: string;\n\titem: unknown;\n}\n\nexport interface DynamicCollectedResult {\n\tkey: string;\n\tindex: number;\n\titem: unknown;\n\tagent: string;\n\texitCode: number | null;\n\ttext: string;\n\tstructured?: unknown;\n\terror?: string;\n\ttimedOut?: boolean;\n\tstopped?: boolean;\n\toutputPath?: string;\n\tartifactPaths?: ArtifactPaths;\n}\n\nexport interface DynamicMaterializedGroup {\n\titems: DynamicMaterializedItem[];\n\tparallel: ParallelTaskItem[];\n\tcollectedOnEmpty?: DynamicCollectedResult[];\n}\n\nconst SAFE_OUTPUT_NAME_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;\nconst ITEM_NAME_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;\nconst ITEM_REF_PATTERN = /\\{([A-Za-z_][A-Za-z0-9_]*)(?:\\.([^{}]+))?\\}/g;\nconst RESERVED_TEMPLATE_NAMES = new Set([\"task\", \"previous\", \"chain_dir\", \"outputs\"]);\nconst DYNAMIC_STEP_KEYS = new Set([\"expand\", \"parallel\", \"collect\", \"concurrency\", \"failFast\", \"phase\", \"label\", \"acceptance\"]);\nconst RUNNER_DYNAMIC_STEP_KEYS = new Set([...DYNAMIC_STEP_KEYS, \"effectiveAcceptance\", \"acceptanceInput\", \"acceptanceRole\", \"sessionFiles\", \"thinkingOverrides\"]);\nconst DYNAMIC_EXPAND_KEYS = new Set([\"from\", \"item\", \"key\", \"maxItems\", \"onEmpty\"]);\nconst DYNAMIC_EXPAND_FROM_KEYS = new Set([\"output\", \"path\"]);\nconst DYNAMIC_PARALLEL_KEYS = new Set([\"agent\", \"task\", \"phase\", \"label\", \"outputSchema\", \"cwd\", \"output\", \"outputMode\", \"reads\", \"progress\", \"skill\", \"model\", \"toolBudget\", \"acceptance\"]);\nconst RUNNER_DYNAMIC_PARALLEL_KEYS = new Set([\n\t...DYNAMIC_PARALLEL_KEYS,\n\t\"outputName\", \"structured\", \"inheritProjectContext\", \"inheritSkills\", \"skills\", \"outputPath\", \"namespaceOutputPath\", \"maxSubagentDepth\", \"waitToolEnabled\",\n\t\"structuredOutput\", \"structuredOutputSchema\", \"tools\", \"extensions\", \"subagentOnlyExtensions\", \"mcpDirectTools\", \"completionGuard\", \"systemPrompt\",\n\t\"systemPromptMode\", \"thinking\", \"modelCandidates\", \"sessionFile\", \"effectiveAcceptance\", \"acceptanceInput\", \"acceptanceRole\", \"parentSessionId\",\n]);\nconst DYNAMIC_COLLECT_KEYS = new Set([\"as\", \"outputSchema\"]);\n\nexport function isSafeOutputName(name: string): boolean {\n\treturn SAFE_OUTPUT_NAME_PATTERN.test(name);\n}\n\nexport function assertJsonPointer(pointer: string, label: string): void {\n\tif (pointer === \"\") return;\n\tif (!pointer.startsWith(\"/\")) {\n\t\tthrow new DynamicFanoutError(`${label} must be a JSON Pointer starting with '/'.`);\n\t}\n\tfor (const segment of pointer.slice(1).split(\"/\")) {\n\t\tif (/~(?![01])/.test(segment)) {\n\t\t\tthrow new DynamicFanoutError(`${label} contains invalid JSON Pointer escape.`);\n\t\t}\n\t}\n}\n\nfunction decodePointerSegment(segment: string): string {\n\treturn segment.replace(/~1/g, \"/\").replace(/~0/g, \"~\");\n}\n\nexport function resolveJsonPointer(value: unknown, pointer: string, label: string): unknown {\n\tassertJsonPointer(pointer, label);\n\tif (pointer === \"\") return value;\n\tlet current = value;\n\tfor (const rawSegment of pointer.slice(1).split(\"/\")) {\n\t\tconst segment = decodePointerSegment(rawSegment);\n\t\tif (Array.isArray(current)) {\n\t\t\tif (!/^(0|[1-9][0-9]*)$/.test(segment)) {\n\t\t\t\tthrow new DynamicFanoutError(`${label} segment '${segment}' does not address an array index.`);\n\t\t\t}\n\t\t\tconst index = Number(segment);\n\t\t\tif (index >= current.length) throw new DynamicFanoutError(`${label} does not exist.`);\n\t\t\tcurrent = current[index];\n\t\t\tcontinue;\n\t\t}\n\t\tif (!current || typeof current !== \"object\") {\n\t\t\tthrow new DynamicFanoutError(`${label} does not exist.`);\n\t\t}\n\t\tconst record = current as Record<string, unknown>;\n\t\tif (!Object.prototype.hasOwnProperty.call(record, segment)) {\n\t\t\tthrow new DynamicFanoutError(`${label} does not exist.`);\n\t\t}\n\t\tcurrent = record[segment];\n\t}\n\treturn current;\n}\n\nfunction scalarToKey(value: unknown, label: string): string {\n\tif (typeof value === \"string\" || typeof value === \"number\" || typeof value === \"boolean\") {\n\t\tconst key = String(value);\n\t\tif (!key.trim()) throw new DynamicFanoutError(`${label} resolved to an empty key.`);\n\t\tif (/[\\u0000-\\u001F\\u007F]/.test(key)) throw new DynamicFanoutError(`${label} resolved to an unsafe key.`);\n\t\tif (key.length > 200) throw new DynamicFanoutError(`${label} resolved to a key longer than 200 characters.`);\n\t\treturn key;\n\t}\n\tthrow new DynamicFanoutError(`${label} must resolve to a string, number, or boolean.`);\n}\n\nexport function normalizeItemKeyForId(key: string): string {\n\tconst normalized = key\n\t\t.toLowerCase()\n\t\t.replace(/[^a-z0-9]+/g, \"-\")\n\t\t.replace(/^-+|-+$/g, \"\")\n\t\t.slice(0, 80);\n\treturn normalized || \"item\";\n}\n\nfunction valueToTemplateText(value: unknown, reference: string): string {\n\tif (value === undefined) throw new DynamicFanoutError(`Unresolved item reference '${reference}'.`);\n\tif (typeof value === \"string\") return value;\n\tif (typeof value === \"number\" || typeof value === \"boolean\" || value === null) return String(value);\n\treturn JSON.stringify(value);\n}\n\nfunction resolveItemPath(item: unknown, pathText: string | undefined, reference: string): unknown {\n\tif (!pathText) return item;\n\tconst pointer = `/${pathText.split(\".\").map((segment) => segment.replace(/~/g, \"~0\").replace(/\\//g, \"~1\")).join(\"/\")}`;\n\treturn resolveJsonPointer(item, pointer, reference);\n}\n\nexport function resolveItemTemplate(template: string, itemName: string, item: unknown): string {\n\treturn template.replace(ITEM_REF_PATTERN, (raw, name: string, pathText: string | undefined) => {\n\t\tif (name !== itemName) return raw;\n\t\tif (pathText !== undefined && (!pathText.trim() || pathText.includes(\"..\"))) {\n\t\t\tthrow new DynamicFanoutError(`Invalid item reference '${raw}'.`);\n\t\t}\n\t\treturn valueToTemplateText(resolveItemPath(item, pathText, raw), raw);\n\t});\n}\n\nfunction assertOnlyKeys(value: unknown, allowed: Set<string>, label: string): void {\n\tif (!value || typeof value !== \"object\" || Array.isArray(value)) throw new DynamicFanoutError(`${label} must be an object.`);\n\tfor (const key of Object.keys(value)) {\n\t\tif (!allowed.has(key)) throw new DynamicFanoutError(`${label} does not support field '${key}'.`);\n\t}\n}\n\nexport function assertNoUnresolvedItemReferences(template: string, itemName: string, label: string): void {\n\tfor (const match of template.matchAll(/\\{([^{}]*)\\}/g)) {\n\t\tconst raw = match[0]!;\n\t\tconst reference = match[1]!;\n\t\tif (reference === itemName || reference.startsWith(`${itemName}.`)) {\n\t\t\tif (!ITEM_REF_PATTERN.test(raw) || reference === `${itemName}.` || reference.includes(\"..\")) {\n\t\t\t\tthrow new DynamicFanoutError(`Invalid item reference '${raw}' in ${label}.`);\n\t\t\t}\n\t\t\tITEM_REF_PATTERN.lastIndex = 0;\n\t\t\tcontinue;\n\t\t}\n\t\tITEM_REF_PATTERN.lastIndex = 0;\n\t\tconst name = reference.match(/^[A-Za-z_][A-Za-z0-9_]*/)?.[0];\n\t\tif (name === itemName) throw new DynamicFanoutError(`Invalid item reference '${raw}' in ${label}.`);\n\t\tif (name && RESERVED_TEMPLATE_NAMES.has(name)) continue;\n\t\tif (name) throw new DynamicFanoutError(`Unsupported template reference '${raw}' in ${label}.`);\n\t}\n\tITEM_REF_PATTERN.lastIndex = 0;\n\tif (template.includes(`{${itemName}.}`) || new RegExp(`\\\\{${itemName}(?:\\\\.|$)[^}]*$`).test(template)) {\n\t\tthrow new DynamicFanoutError(`Invalid item reference in ${label}.`);\n\t}\n}\n\nexport function hasDynamicFanoutFields(step: unknown): boolean {\n\treturn !!step && typeof step === \"object\" && !Array.isArray(step)\n\t\t&& (Object.prototype.hasOwnProperty.call(step, \"expand\") || Object.prototype.hasOwnProperty.call(step, \"collect\"));\n}\n\nexport function validateDynamicStepShape(step: DynamicParallelStep, stepIndex: number, config: DynamicFanoutConfig = {}): void {\n\tconst prefix = `Dynamic chain step ${stepIndex + 1}`;\n\tassertOnlyKeys(step, config.allowRunnerFields ? RUNNER_DYNAMIC_STEP_KEYS : DYNAMIC_STEP_KEYS, prefix);\n\tif (!step.expand || !step.expand.from) throw new DynamicFanoutError(`${prefix} requires expand.from.`);\n\tassertOnlyKeys(step.expand, DYNAMIC_EXPAND_KEYS, `${prefix} expand`);\n\tassertOnlyKeys(step.expand.from, DYNAMIC_EXPAND_FROM_KEYS, `${prefix} expand.from`);\n\tif (!isSafeOutputName(step.expand.from.output)) throw new DynamicFanoutError(`${prefix} has invalid expand.from.output '${step.expand.from.output}'.`);\n\tassertJsonPointer(step.expand.from.path, `${prefix} expand.from.path`);\n\tif (step.expand.key !== undefined) assertJsonPointer(step.expand.key, `${prefix} expand.key`);\n\tconst itemName = step.expand.item ?? \"item\";\n\tif (!ITEM_NAME_PATTERN.test(itemName)) throw new DynamicFanoutError(`${prefix} has invalid expand.item '${itemName}'.`);\n\tif (step.expand.maxItems === undefined && config.maxItems === undefined) {\n\t\tthrow new DynamicFanoutError(`${prefix} requires expand.maxItems or config.chain.dynamicFanout.maxItems.`);\n\t}\n\tif (step.expand.maxItems !== undefined && (!Number.isInteger(step.expand.maxItems) || step.expand.maxItems < 0)) {\n\t\tthrow new DynamicFanoutError(`${prefix} expand.maxItems must be an integer >= 0.`);\n\t}\n\tif (config.maxItems !== undefined && (!Number.isInteger(config.maxItems) || config.maxItems < 0)) {\n\t\tthrow new DynamicFanoutError(\"config.chain.dynamicFanout.maxItems must be an integer >= 0.\");\n\t}\n\tif (!step.parallel || Array.isArray(step.parallel)) throw new DynamicFanoutError(`${prefix} requires a single parallel template object and cannot mix dynamic expand/collect with static parallel arrays.`);\n\tassertOnlyKeys(step.parallel, config.allowRunnerFields ? RUNNER_DYNAMIC_PARALLEL_KEYS : DYNAMIC_PARALLEL_KEYS, `${prefix} parallel`);\n\tif (\"expand\" in (step.parallel as object)) throw new DynamicFanoutError(`${prefix} does not support nested dynamic fanout.`);\n\tif (!step.parallel.agent) throw new DynamicFanoutError(`${prefix} parallel.agent is required.`);\n\tif (!step.collect?.as || !isSafeOutputName(step.collect.as)) throw new DynamicFanoutError(`${prefix} requires collect.as with a safe output name.`);\n\tassertOnlyKeys(step.collect, DYNAMIC_COLLECT_KEYS, `${prefix} collect`);\n\tfor (const [label, template] of [\n\t\t[\"parallel.task\", step.parallel.task],\n\t\t[\"parallel.label\", step.parallel.label],\n\t] as const) {\n\t\tif (template) assertNoUnresolvedItemReferences(template, itemName, `${prefix} ${label}`);\n\t}\n}\n\nexport function resolveDynamicFanoutItems(step: DynamicParallelStep, outputs: ChainOutputMap, stepIndex: number, config: DynamicFanoutConfig = {}): DynamicMaterializedItem[] {\n\tvalidateDynamicStepShape(step, stepIndex, config);\n\tconst sourceName = step.expand.from.output;\n\tconst source = outputs[sourceName];\n\tif (!source) throw new DynamicFanoutError(`Dynamic chain step ${stepIndex + 1} references unknown output '${sourceName}'.`);\n\tif (source.structured === undefined) throw new DynamicFanoutError(`Dynamic chain step ${stepIndex + 1} requires structured output '${sourceName}'.`);\n\tconst value = resolveJsonPointer(source.structured, step.expand.from.path, `Dynamic chain step ${stepIndex + 1} expand.from.path`);\n\tif (!Array.isArray(value)) throw new DynamicFanoutError(`Dynamic chain step ${stepIndex + 1} expand.from.path must resolve to an array.`);\n\tconst maxItems = step.expand.maxItems ?? config.maxItems;\n\tif (maxItems === undefined) throw new DynamicFanoutError(`Dynamic chain step ${stepIndex + 1} requires an effective maxItems.`);\n\tif (value.length > maxItems) throw new DynamicFanoutError(`Dynamic chain step ${stepIndex + 1} resolved ${value.length} items, exceeding maxItems ${maxItems}.`);\n\tconst seen = new Set<string>();\n\tconst seenIds = new Set<string>();\n\treturn value.map((item, index) => {\n\t\tconst key = step.expand.key === undefined\n\t\t\t? String(index)\n\t\t\t: scalarToKey(resolveJsonPointer(item, step.expand.key, `Dynamic chain step ${stepIndex + 1} expand.key`), `Dynamic chain step ${stepIndex + 1} expand.key`);\n\t\tif (seen.has(key)) throw new DynamicFanoutError(`Dynamic chain step ${stepIndex + 1} produced duplicate item key '${key}'.`);\n\t\tseen.add(key);\n\t\tconst idKey = normalizeItemKeyForId(key);\n\t\tif (seenIds.has(idKey)) throw new DynamicFanoutError(`Dynamic chain step ${stepIndex + 1} produced colliding item id '${idKey}'.`);\n\t\tseenIds.add(idKey);\n\t\treturn { index, key, idKey, item };\n\t});\n}\n\nexport function materializeDynamicParallelStep(step: DynamicParallelStep, outputs: ChainOutputMap, stepIndex: number, config: DynamicFanoutConfig = {}): DynamicMaterializedGroup {\n\tconst items = resolveDynamicFanoutItems(step, outputs, stepIndex, config);\n\tif (items.length === 0) {\n\t\tif ((step.expand.onEmpty ?? \"skip\") === \"fail\") {\n\t\t\tthrow new DynamicFanoutError(`Dynamic chain step ${stepIndex + 1} source array is empty.`);\n\t\t}\n\t\treturn { items, parallel: [], collectedOnEmpty: [] };\n\t}\n\tconst itemName = step.expand.item ?? \"item\";\n\tconst parallel = items.map((entry) => {\n\t\tconst task = resolveItemTemplate(step.parallel.task ?? \"{previous}\", itemName, entry.item);\n\t\tconst label = step.parallel.label ? resolveItemTemplate(step.parallel.label, itemName, entry.item) : undefined;\n\t\treturn {\n\t\t\t...step.parallel,\n\t\t\ttask,\n\t\t\t...(label !== undefined ? { label } : {}),\n\t\t};\n\t});\n\treturn { items, parallel };\n}\n\nexport function collectDynamicResults(\n\tstep: DynamicParallelStep,\n\titems: DynamicMaterializedItem[],\n\tresults: Array<Pick<SingleResult, \"agent\" | \"exitCode\" | \"error\" | \"timedOut\" | \"stopped\" | \"structuredOutput\" | \"artifactPaths\" | \"savedOutputPath\"> & { output?: string; finalOutput?: string }>,\n): DynamicCollectedResult[] {\n\treturn items.map((entry, index) => {\n\t\tconst result = results[index];\n\t\tconst text = result\n\t\t\t? (\"output\" in result && typeof result.output === \"string\" ? result.output : getSingleResultOutput(result as SingleResult))\n\t\t\t: \"\";\n\t\treturn {\n\t\t\tkey: entry.key,\n\t\t\tindex: entry.index,\n\t\t\titem: entry.item,\n\t\t\tagent: result?.agent ?? step.parallel.agent,\n\t\t\texitCode: result?.exitCode ?? null,\n\t\t\ttext,\n\t\t\t...(result?.structuredOutput !== undefined ? { structured: result.structuredOutput } : {}),\n\t\t\t...(result?.error ? { error: result.error } : {}),\n\t\t\t...(result?.timedOut ? { timedOut: true } : {}),\n\t\t\t...(result?.stopped ? { stopped: true } : {}),\n\t\t\t...(result?.savedOutputPath ? { outputPath: result.savedOutputPath } : {}),\n\t\t\t...(result?.artifactPaths ? { artifactPaths: result.artifactPaths } : {}),\n\t\t};\n\t});\n}\n\nexport function validateDynamicCollection(schema: JsonSchemaObject | undefined, value: DynamicCollectedResult[]): void {\n\tif (!schema) return;\n\tconst validation = validateStructuredOutputValue(schema, value);\n\tif (validation.status === \"invalid\") {\n\t\tthrow new DynamicFanoutError(`Collected output validation failed: ${validation.message}`);\n\t}\n}\n"]}

package/dist/builtin-extensions/pi-subagents/src/runs/shared/dynamic-fanout.js

@@ -0,0 +1,274 @@
+import { getSingleResultOutput } from "../../shared/utils.js";
+import { validateStructuredOutputValue } from "./structured-output.js";
+export class DynamicFanoutError extends Error {
+}
+const SAFE_OUTPUT_NAME_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;
+const ITEM_NAME_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;
+const ITEM_REF_PATTERN = /\{([A-Za-z_][A-Za-z0-9_]*)(?:\.([^{}]+))?\}/g;
+const RESERVED_TEMPLATE_NAMES = new Set(["task", "previous", "chain_dir", "outputs"]);
+const DYNAMIC_STEP_KEYS = new Set(["expand", "parallel", "collect", "concurrency", "failFast", "phase", "label", "acceptance"]);
+const RUNNER_DYNAMIC_STEP_KEYS = new Set([...DYNAMIC_STEP_KEYS, "effectiveAcceptance", "acceptanceInput", "acceptanceRole", "sessionFiles", "thinkingOverrides"]);
+const DYNAMIC_EXPAND_KEYS = new Set(["from", "item", "key", "maxItems", "onEmpty"]);
+const DYNAMIC_EXPAND_FROM_KEYS = new Set(["output", "path"]);
+const DYNAMIC_PARALLEL_KEYS = new Set(["agent", "task", "phase", "label", "outputSchema", "cwd", "output", "outputMode", "reads", "progress", "skill", "model", "toolBudget", "acceptance"]);
+const RUNNER_DYNAMIC_PARALLEL_KEYS = new Set([
+    ...DYNAMIC_PARALLEL_KEYS,
+    "outputName", "structured", "inheritProjectContext", "inheritSkills", "skills", "outputPath", "namespaceOutputPath", "maxSubagentDepth", "waitToolEnabled",
+    "structuredOutput", "structuredOutputSchema", "tools", "extensions", "subagentOnlyExtensions", "mcpDirectTools", "completionGuard", "systemPrompt",
+    "systemPromptMode", "thinking", "modelCandidates", "sessionFile", "effectiveAcceptance", "acceptanceInput", "acceptanceRole", "parentSessionId",
+]);
+const DYNAMIC_COLLECT_KEYS = new Set(["as", "outputSchema"]);
+export function isSafeOutputName(name) {
+    return SAFE_OUTPUT_NAME_PATTERN.test(name);
+}
+export function assertJsonPointer(pointer, label) {
+    if (pointer === "")
+        return;
+    if (!pointer.startsWith("/")) {
+        throw new DynamicFanoutError(`${label} must be a JSON Pointer starting with '/'.`);
+    }
+    for (const segment of pointer.slice(1).split("/")) {
+        if (/~(?![01])/.test(segment)) {
+            throw new DynamicFanoutError(`${label} contains invalid JSON Pointer escape.`);
+        }
+    }
+}
+function decodePointerSegment(segment) {
+    return segment.replace(/~1/g, "/").replace(/~0/g, "~");
+}
+export function resolveJsonPointer(value, pointer, label) {
+    assertJsonPointer(pointer, label);
+    if (pointer === "")
+        return value;
+    let current = value;
+    for (const rawSegment of pointer.slice(1).split("/")) {
+        const segment = decodePointerSegment(rawSegment);
+        if (Array.isArray(current)) {
+            if (!/^(0|[1-9][0-9]*)$/.test(segment)) {
+                throw new DynamicFanoutError(`${label} segment '${segment}' does not address an array index.`);
+            }
+            const index = Number(segment);
+            if (index >= current.length)
+                throw new DynamicFanoutError(`${label} does not exist.`);
+            current = current[index];
+            continue;
+        }
+        if (!current || typeof current !== "object") {
+            throw new DynamicFanoutError(`${label} does not exist.`);
+        }
+        const record = current;
+        if (!Object.prototype.hasOwnProperty.call(record, segment)) {
+            throw new DynamicFanoutError(`${label} does not exist.`);
+        }
+        current = record[segment];
+    }
+    return current;
+}
+function scalarToKey(value, label) {
+    if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+        const key = String(value);
+        if (!key.trim())
+            throw new DynamicFanoutError(`${label} resolved to an empty key.`);
+        if (/[\u0000-\u001F\u007F]/.test(key))
+            throw new DynamicFanoutError(`${label} resolved to an unsafe key.`);
+        if (key.length > 200)
+            throw new DynamicFanoutError(`${label} resolved to a key longer than 200 characters.`);
+        return key;
+    }
+    throw new DynamicFanoutError(`${label} must resolve to a string, number, or boolean.`);
+}
+export function normalizeItemKeyForId(key) {
+    const normalized = key
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 80);
+    return normalized || "item";
+}
+function valueToTemplateText(value, reference) {
+    if (value === undefined)
+        throw new DynamicFanoutError(`Unresolved item reference '${reference}'.`);
+    if (typeof value === "string")
+        return value;
+    if (typeof value === "number" || typeof value === "boolean" || value === null)
+        return String(value);
+    return JSON.stringify(value);
+}
+function resolveItemPath(item, pathText, reference) {
+    if (!pathText)
+        return item;
+    const pointer = `/${pathText.split(".").map((segment) => segment.replace(/~/g, "~0").replace(/\//g, "~1")).join("/")}`;
+    return resolveJsonPointer(item, pointer, reference);
+}
+export function resolveItemTemplate(template, itemName, item) {
+    return template.replace(ITEM_REF_PATTERN, (raw, name, pathText) => {
+        if (name !== itemName)
+            return raw;
+        if (pathText !== undefined && (!pathText.trim() || pathText.includes(".."))) {
+            throw new DynamicFanoutError(`Invalid item reference '${raw}'.`);
+        }
+        return valueToTemplateText(resolveItemPath(item, pathText, raw), raw);
+    });
+}
+function assertOnlyKeys(value, allowed, label) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new DynamicFanoutError(`${label} must be an object.`);
+    for (const key of Object.keys(value)) {
+        if (!allowed.has(key))
+            throw new DynamicFanoutError(`${label} does not support field '${key}'.`);
+    }
+}
+export function assertNoUnresolvedItemReferences(template, itemName, label) {
+    for (const match of template.matchAll(/\{([^{}]*)\}/g)) {
+        const raw = match[0];
+        const reference = match[1];
+        if (reference === itemName || reference.startsWith(`${itemName}.`)) {
+            if (!ITEM_REF_PATTERN.test(raw) || reference === `${itemName}.` || reference.includes("..")) {
+                throw new DynamicFanoutError(`Invalid item reference '${raw}' in ${label}.`);
+            }
+            ITEM_REF_PATTERN.lastIndex = 0;
+            continue;
+        }
+        ITEM_REF_PATTERN.lastIndex = 0;
+        const name = reference.match(/^[A-Za-z_][A-Za-z0-9_]*/)?.[0];
+        if (name === itemName)
+            throw new DynamicFanoutError(`Invalid item reference '${raw}' in ${label}.`);
+        if (name && RESERVED_TEMPLATE_NAMES.has(name))
+            continue;
+        if (name)
+            throw new DynamicFanoutError(`Unsupported template reference '${raw}' in ${label}.`);
+    }
+    ITEM_REF_PATTERN.lastIndex = 0;
+    if (template.includes(`{${itemName}.}`) || new RegExp(`\\{${itemName}(?:\\.|$)[^}]*$`).test(template)) {
+        throw new DynamicFanoutError(`Invalid item reference in ${label}.`);
+    }
+}
+export function hasDynamicFanoutFields(step) {
+    return !!step && typeof step === "object" && !Array.isArray(step)
+        && (Object.prototype.hasOwnProperty.call(step, "expand") || Object.prototype.hasOwnProperty.call(step, "collect"));
+}
+export function validateDynamicStepShape(step, stepIndex, config = {}) {
+    const prefix = `Dynamic chain step ${stepIndex + 1}`;
+    assertOnlyKeys(step, config.allowRunnerFields ? RUNNER_DYNAMIC_STEP_KEYS : DYNAMIC_STEP_KEYS, prefix);
+    if (!step.expand || !step.expand.from)
+        throw new DynamicFanoutError(`${prefix} requires expand.from.`);
+    assertOnlyKeys(step.expand, DYNAMIC_EXPAND_KEYS, `${prefix} expand`);
+    assertOnlyKeys(step.expand.from, DYNAMIC_EXPAND_FROM_KEYS, `${prefix} expand.from`);
+    if (!isSafeOutputName(step.expand.from.output))
+        throw new DynamicFanoutError(`${prefix} has invalid expand.from.output '${step.expand.from.output}'.`);
+    assertJsonPointer(step.expand.from.path, `${prefix} expand.from.path`);
+    if (step.expand.key !== undefined)
+        assertJsonPointer(step.expand.key, `${prefix} expand.key`);
+    const itemName = step.expand.item ?? "item";
+    if (!ITEM_NAME_PATTERN.test(itemName))
+        throw new DynamicFanoutError(`${prefix} has invalid expand.item '${itemName}'.`);
+    if (step.expand.maxItems === undefined && config.maxItems === undefined) {
+        throw new DynamicFanoutError(`${prefix} requires expand.maxItems or config.chain.dynamicFanout.maxItems.`);
+    }
+    if (step.expand.maxItems !== undefined && (!Number.isInteger(step.expand.maxItems) || step.expand.maxItems < 0)) {
+        throw new DynamicFanoutError(`${prefix} expand.maxItems must be an integer >= 0.`);
+    }
+    if (config.maxItems !== undefined && (!Number.isInteger(config.maxItems) || config.maxItems < 0)) {
+        throw new DynamicFanoutError("config.chain.dynamicFanout.maxItems must be an integer >= 0.");
+    }
+    if (!step.parallel || Array.isArray(step.parallel))
+        throw new DynamicFanoutError(`${prefix} requires a single parallel template object and cannot mix dynamic expand/collect with static parallel arrays.`);
+    assertOnlyKeys(step.parallel, config.allowRunnerFields ? RUNNER_DYNAMIC_PARALLEL_KEYS : DYNAMIC_PARALLEL_KEYS, `${prefix} parallel`);
+    if ("expand" in step.parallel)
+        throw new DynamicFanoutError(`${prefix} does not support nested dynamic fanout.`);
+    if (!step.parallel.agent)
+        throw new DynamicFanoutError(`${prefix} parallel.agent is required.`);
+    if (!step.collect?.as || !isSafeOutputName(step.collect.as))
+        throw new DynamicFanoutError(`${prefix} requires collect.as with a safe output name.`);
+    assertOnlyKeys(step.collect, DYNAMIC_COLLECT_KEYS, `${prefix} collect`);
+    for (const [label, template] of [
+        ["parallel.task", step.parallel.task],
+        ["parallel.label", step.parallel.label],
+    ]) {
+        if (template)
+            assertNoUnresolvedItemReferences(template, itemName, `${prefix} ${label}`);
+    }
+}
+export function resolveDynamicFanoutItems(step, outputs, stepIndex, config = {}) {
+    validateDynamicStepShape(step, stepIndex, config);
+    const sourceName = step.expand.from.output;
+    const source = outputs[sourceName];
+    if (!source)
+        throw new DynamicFanoutError(`Dynamic chain step ${stepIndex + 1} references unknown output '${sourceName}'.`);
+    if (source.structured === undefined)
+        throw new DynamicFanoutError(`Dynamic chain step ${stepIndex + 1} requires structured output '${sourceName}'.`);
+    const value = resolveJsonPointer(source.structured, step.expand.from.path, `Dynamic chain step ${stepIndex + 1} expand.from.path`);
+    if (!Array.isArray(value))
+        throw new DynamicFanoutError(`Dynamic chain step ${stepIndex + 1} expand.from.path must resolve to an array.`);
+    const maxItems = step.expand.maxItems ?? config.maxItems;
+    if (maxItems === undefined)
+        throw new DynamicFanoutError(`Dynamic chain step ${stepIndex + 1} requires an effective maxItems.`);
+    if (value.length > maxItems)
+        throw new DynamicFanoutError(`Dynamic chain step ${stepIndex + 1} resolved ${value.length} items, exceeding maxItems ${maxItems}.`);
+    const seen = new Set();
+    const seenIds = new Set();
+    return value.map((item, index) => {
+        const key = step.expand.key === undefined
+            ? String(index)
+            : scalarToKey(resolveJsonPointer(item, step.expand.key, `Dynamic chain step ${stepIndex + 1} expand.key`), `Dynamic chain step ${stepIndex + 1} expand.key`);
+        if (seen.has(key))
+            throw new DynamicFanoutError(`Dynamic chain step ${stepIndex + 1} produced duplicate item key '${key}'.`);
+        seen.add(key);
+        const idKey = normalizeItemKeyForId(key);
+        if (seenIds.has(idKey))
+            throw new DynamicFanoutError(`Dynamic chain step ${stepIndex + 1} produced colliding item id '${idKey}'.`);
+        seenIds.add(idKey);
+        return { index, key, idKey, item };
+    });
+}
+export function materializeDynamicParallelStep(step, outputs, stepIndex, config = {}) {
+    const items = resolveDynamicFanoutItems(step, outputs, stepIndex, config);
+    if (items.length === 0) {
+        if ((step.expand.onEmpty ?? "skip") === "fail") {
+            throw new DynamicFanoutError(`Dynamic chain step ${stepIndex + 1} source array is empty.`);
+        }
+        return { items, parallel: [], collectedOnEmpty: [] };
+    }
+    const itemName = step.expand.item ?? "item";
+    const parallel = items.map((entry) => {
+        const task = resolveItemTemplate(step.parallel.task ?? "{previous}", itemName, entry.item);
+        const label = step.parallel.label ? resolveItemTemplate(step.parallel.label, itemName, entry.item) : undefined;
+        return {
+            ...step.parallel,
+            task,
+            ...(label !== undefined ? { label } : {}),
+        };
+    });
+    return { items, parallel };
+}
+export function collectDynamicResults(step, items, results) {
+    return items.map((entry, index) => {
+        const result = results[index];
+        const text = result
+            ? ("output" in result && typeof result.output === "string" ? result.output : getSingleResultOutput(result))
+            : "";
+        return {
+            key: entry.key,
+            index: entry.index,
+            item: entry.item,
+            agent: result?.agent ?? step.parallel.agent,
+            exitCode: result?.exitCode ?? null,
+            text,
+            ...(result?.structuredOutput !== undefined ? { structured: result.structuredOutput } : {}),
+            ...(result?.error ? { error: result.error } : {}),
+            ...(result?.timedOut ? { timedOut: true } : {}),
+            ...(result?.stopped ? { stopped: true } : {}),
+            ...(result?.savedOutputPath ? { outputPath: result.savedOutputPath } : {}),
+            ...(result?.artifactPaths ? { artifactPaths: result.artifactPaths } : {}),
+        };
+    });
+}
+export function validateDynamicCollection(schema, value) {
+    if (!schema)
+        return;
+    const validation = validateStructuredOutputValue(schema, value);
+    if (validation.status === "invalid") {
+        throw new DynamicFanoutError(`Collected output validation failed: ${validation.message}`);
+    }
+}
+//# sourceMappingURL=dynamic-fanout.js.map

package/dist/builtin-extensions/pi-subagents/src/runs/shared/dynamic-fanout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-fanout.js","sourceRoot":"","sources":["../../../../../../src/builtin-extensions/pi-subagents/src/runs/shared/dynamic-fanout.ts"],"names":[],"mappings":"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","sourcesContent":["// @ts-nocheck\nimport type { DynamicParallelStep, ParallelTaskItem } from \"../../shared/settings.ts\";\nimport type { ArtifactPaths, ChainOutputMap, JsonSchemaObject, SingleResult } from \"../../shared/types.ts\";\nimport { getSingleResultOutput } from \"../../shared/utils.ts\";\nimport { validateStructuredOutputValue } from \"./structured-output.ts\";\n\nexport class DynamicFanoutError extends Error {}\n\nexport interface DynamicFanoutConfig {\n\tmaxItems?: number;\n\tallowRunnerFields?: boolean;\n}\n\nexport interface DynamicMaterializedItem {\n\tindex: number;\n\tkey: string;\n\tidKey: string;\n\titem: unknown;\n}\n\nexport interface DynamicCollectedResult {\n\tkey: string;\n\tindex: number;\n\titem: unknown;\n\tagent: string;\n\texitCode: number | null;\n\ttext: string;\n\tstructured?: unknown;\n\terror?: string;\n\ttimedOut?: boolean;\n\tstopped?: boolean;\n\toutputPath?: string;\n\tartifactPaths?: ArtifactPaths;\n}\n\nexport interface DynamicMaterializedGroup {\n\titems: DynamicMaterializedItem[];\n\tparallel: ParallelTaskItem[];\n\tcollectedOnEmpty?: DynamicCollectedResult[];\n}\n\nconst SAFE_OUTPUT_NAME_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;\nconst ITEM_NAME_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;\nconst ITEM_REF_PATTERN = /\\{([A-Za-z_][A-Za-z0-9_]*)(?:\\.([^{}]+))?\\}/g;\nconst RESERVED_TEMPLATE_NAMES = new Set([\"task\", \"previous\", \"chain_dir\", \"outputs\"]);\nconst DYNAMIC_STEP_KEYS = new Set([\"expand\", \"parallel\", \"collect\", \"concurrency\", \"failFast\", \"phase\", \"label\", \"acceptance\"]);\nconst RUNNER_DYNAMIC_STEP_KEYS = new Set([...DYNAMIC_STEP_KEYS, \"effectiveAcceptance\", \"acceptanceInput\", \"acceptanceRole\", \"sessionFiles\", \"thinkingOverrides\"]);\nconst DYNAMIC_EXPAND_KEYS = new Set([\"from\", \"item\", \"key\", \"maxItems\", \"onEmpty\"]);\nconst DYNAMIC_EXPAND_FROM_KEYS = new Set([\"output\", \"path\"]);\nconst DYNAMIC_PARALLEL_KEYS = new Set([\"agent\", \"task\", \"phase\", \"label\", \"outputSchema\", \"cwd\", \"output\", \"outputMode\", \"reads\", \"progress\", \"skill\", \"model\", \"toolBudget\", \"acceptance\"]);\nconst RUNNER_DYNAMIC_PARALLEL_KEYS = new Set([\n\t...DYNAMIC_PARALLEL_KEYS,\n\t\"outputName\", \"structured\", \"inheritProjectContext\", \"inheritSkills\", \"skills\", \"outputPath\", \"namespaceOutputPath\", \"maxSubagentDepth\", \"waitToolEnabled\",\n\t\"structuredOutput\", \"structuredOutputSchema\", \"tools\", \"extensions\", \"subagentOnlyExtensions\", \"mcpDirectTools\", \"completionGuard\", \"systemPrompt\",\n\t\"systemPromptMode\", \"thinking\", \"modelCandidates\", \"sessionFile\", \"effectiveAcceptance\", \"acceptanceInput\", \"acceptanceRole\", \"parentSessionId\",\n]);\nconst DYNAMIC_COLLECT_KEYS = new Set([\"as\", \"outputSchema\"]);\n\nexport function isSafeOutputName(name: string): boolean {\n\treturn SAFE_OUTPUT_NAME_PATTERN.test(name);\n}\n\nexport function assertJsonPointer(pointer: string, label: string): void {\n\tif (pointer === \"\") return;\n\tif (!pointer.startsWith(\"/\")) {\n\t\tthrow new DynamicFanoutError(`${label} must be a JSON Pointer starting with '/'.`);\n\t}\n\tfor (const segment of pointer.slice(1).split(\"/\")) {\n\t\tif (/~(?![01])/.test(segment)) {\n\t\t\tthrow new DynamicFanoutError(`${label} contains invalid JSON Pointer escape.`);\n\t\t}\n\t}\n}\n\nfunction decodePointerSegment(segment: string): string {\n\treturn segment.replace(/~1/g, \"/\").replace(/~0/g, \"~\");\n}\n\nexport function resolveJsonPointer(value: unknown, pointer: string, label: string): unknown {\n\tassertJsonPointer(pointer, label);\n\tif (pointer === \"\") return value;\n\tlet current = value;\n\tfor (const rawSegment of pointer.slice(1).split(\"/\")) {\n\t\tconst segment = decodePointerSegment(rawSegment);\n\t\tif (Array.isArray(current)) {\n\t\t\tif (!/^(0|[1-9][0-9]*)$/.test(segment)) {\n\t\t\t\tthrow new DynamicFanoutError(`${label} segment '${segment}' does not address an array index.`);\n\t\t\t}\n\t\t\tconst index = Number(segment);\n\t\t\tif (index >= current.length) throw new DynamicFanoutError(`${label} does not exist.`);\n\t\t\tcurrent = current[index];\n\t\t\tcontinue;\n\t\t}\n\t\tif (!current || typeof current !== \"object\") {\n\t\t\tthrow new DynamicFanoutError(`${label} does not exist.`);\n\t\t}\n\t\tconst record = current as Record<string, unknown>;\n\t\tif (!Object.prototype.hasOwnProperty.call(record, segment)) {\n\t\t\tthrow new DynamicFanoutError(`${label} does not exist.`);\n\t\t}\n\t\tcurrent = record[segment];\n\t}\n\treturn current;\n}\n\nfunction scalarToKey(value: unknown, label: string): string {\n\tif (typeof value === \"string\" || typeof value === \"number\" || typeof value === \"boolean\") {\n\t\tconst key = String(value);\n\t\tif (!key.trim()) throw new DynamicFanoutError(`${label} resolved to an empty key.`);\n\t\tif (/[\\u0000-\\u001F\\u007F]/.test(key)) throw new DynamicFanoutError(`${label} resolved to an unsafe key.`);\n\t\tif (key.length > 200) throw new DynamicFanoutError(`${label} resolved to a key longer than 200 characters.`);\n\t\treturn key;\n\t}\n\tthrow new DynamicFanoutError(`${label} must resolve to a string, number, or boolean.`);\n}\n\nexport function normalizeItemKeyForId(key: string): string {\n\tconst normalized = key\n\t\t.toLowerCase()\n\t\t.replace(/[^a-z0-9]+/g, \"-\")\n\t\t.replace(/^-+|-+$/g, \"\")\n\t\t.slice(0, 80);\n\treturn normalized || \"item\";\n}\n\nfunction valueToTemplateText(value: unknown, reference: string): string {\n\tif (value === undefined) throw new DynamicFanoutError(`Unresolved item reference '${reference}'.`);\n\tif (typeof value === \"string\") return value;\n\tif (typeof value === \"number\" || typeof value === \"boolean\" || value === null) return String(value);\n\treturn JSON.stringify(value);\n}\n\nfunction resolveItemPath(item: unknown, pathText: string | undefined, reference: string): unknown {\n\tif (!pathText) return item;\n\tconst pointer = `/${pathText.split(\".\").map((segment) => segment.replace(/~/g, \"~0\").replace(/\\//g, \"~1\")).join(\"/\")}`;\n\treturn resolveJsonPointer(item, pointer, reference);\n}\n\nexport function resolveItemTemplate(template: string, itemName: string, item: unknown): string {\n\treturn template.replace(ITEM_REF_PATTERN, (raw, name: string, pathText: string | undefined) => {\n\t\tif (name !== itemName) return raw;\n\t\tif (pathText !== undefined && (!pathText.trim() || pathText.includes(\"..\"))) {\n\t\t\tthrow new DynamicFanoutError(`Invalid item reference '${raw}'.`);\n\t\t}\n\t\treturn valueToTemplateText(resolveItemPath(item, pathText, raw), raw);\n\t});\n}\n\nfunction assertOnlyKeys(value: unknown, allowed: Set<string>, label: string): void {\n\tif (!value || typeof value !== \"object\" || Array.isArray(value)) throw new DynamicFanoutError(`${label} must be an object.`);\n\tfor (const key of Object.keys(value)) {\n\t\tif (!allowed.has(key)) throw new DynamicFanoutError(`${label} does not support field '${key}'.`);\n\t}\n}\n\nexport function assertNoUnresolvedItemReferences(template: string, itemName: string, label: string): void {\n\tfor (const match of template.matchAll(/\\{([^{}]*)\\}/g)) {\n\t\tconst raw = match[0]!;\n\t\tconst reference = match[1]!;\n\t\tif (reference === itemName || reference.startsWith(`${itemName}.`)) {\n\t\t\tif (!ITEM_REF_PATTERN.test(raw) || reference === `${itemName}.` || reference.includes(\"..\")) {\n\t\t\t\tthrow new DynamicFanoutError(`Invalid item reference '${raw}' in ${label}.`);\n\t\t\t}\n\t\t\tITEM_REF_PATTERN.lastIndex = 0;\n\t\t\tcontinue;\n\t\t}\n\t\tITEM_REF_PATTERN.lastIndex = 0;\n\t\tconst name = reference.match(/^[A-Za-z_][A-Za-z0-9_]*/)?.[0];\n\t\tif (name === itemName) throw new DynamicFanoutError(`Invalid item reference '${raw}' in ${label}.`);\n\t\tif (name && RESERVED_TEMPLATE_NAMES.has(name)) continue;\n\t\tif (name) throw new DynamicFanoutError(`Unsupported template reference '${raw}' in ${label}.`);\n\t}\n\tITEM_REF_PATTERN.lastIndex = 0;\n\tif (template.includes(`{${itemName}.}`) || new RegExp(`\\\\{${itemName}(?:\\\\.|$)[^}]*$`).test(template)) {\n\t\tthrow new DynamicFanoutError(`Invalid item reference in ${label}.`);\n\t}\n}\n\nexport function hasDynamicFanoutFields(step: unknown): boolean {\n\treturn !!step && typeof step === \"object\" && !Array.isArray(step)\n\t\t&& (Object.prototype.hasOwnProperty.call(step, \"expand\") || Object.prototype.hasOwnProperty.call(step, \"collect\"));\n}\n\nexport function validateDynamicStepShape(step: DynamicParallelStep, stepIndex: number, config: DynamicFanoutConfig = {}): void {\n\tconst prefix = `Dynamic chain step ${stepIndex + 1}`;\n\tassertOnlyKeys(step, config.allowRunnerFields ? RUNNER_DYNAMIC_STEP_KEYS : DYNAMIC_STEP_KEYS, prefix);\n\tif (!step.expand || !step.expand.from) throw new DynamicFanoutError(`${prefix} requires expand.from.`);\n\tassertOnlyKeys(step.expand, DYNAMIC_EXPAND_KEYS, `${prefix} expand`);\n\tassertOnlyKeys(step.expand.from, DYNAMIC_EXPAND_FROM_KEYS, `${prefix} expand.from`);\n\tif (!isSafeOutputName(step.expand.from.output)) throw new DynamicFanoutError(`${prefix} has invalid expand.from.output '${step.expand.from.output}'.`);\n\tassertJsonPointer(step.expand.from.path, `${prefix} expand.from.path`);\n\tif (step.expand.key !== undefined) assertJsonPointer(step.expand.key, `${prefix} expand.key`);\n\tconst itemName = step.expand.item ?? \"item\";\n\tif (!ITEM_NAME_PATTERN.test(itemName)) throw new DynamicFanoutError(`${prefix} has invalid expand.item '${itemName}'.`);\n\tif (step.expand.maxItems === undefined && config.maxItems === undefined) {\n\t\tthrow new DynamicFanoutError(`${prefix} requires expand.maxItems or config.chain.dynamicFanout.maxItems.`);\n\t}\n\tif (step.expand.maxItems !== undefined && (!Number.isInteger(step.expand.maxItems) || step.expand.maxItems < 0)) {\n\t\tthrow new DynamicFanoutError(`${prefix} expand.maxItems must be an integer >= 0.`);\n\t}\n\tif (config.maxItems !== undefined && (!Number.isInteger(config.maxItems) || config.maxItems < 0)) {\n\t\tthrow new DynamicFanoutError(\"config.chain.dynamicFanout.maxItems must be an integer >= 0.\");\n\t}\n\tif (!step.parallel || Array.isArray(step.parallel)) throw new DynamicFanoutError(`${prefix} requires a single parallel template object and cannot mix dynamic expand/collect with static parallel arrays.`);\n\tassertOnlyKeys(step.parallel, config.allowRunnerFields ? RUNNER_DYNAMIC_PARALLEL_KEYS : DYNAMIC_PARALLEL_KEYS, `${prefix} parallel`);\n\tif (\"expand\" in (step.parallel as object)) throw new DynamicFanoutError(`${prefix} does not support nested dynamic fanout.`);\n\tif (!step.parallel.agent) throw new DynamicFanoutError(`${prefix} parallel.agent is required.`);\n\tif (!step.collect?.as || !isSafeOutputName(step.collect.as)) throw new DynamicFanoutError(`${prefix} requires collect.as with a safe output name.`);\n\tassertOnlyKeys(step.collect, DYNAMIC_COLLECT_KEYS, `${prefix} collect`);\n\tfor (const [label, template] of [\n\t\t[\"parallel.task\", step.parallel.task],\n\t\t[\"parallel.label\", step.parallel.label],\n\t] as const) {\n\t\tif (template) assertNoUnresolvedItemReferences(template, itemName, `${prefix} ${label}`);\n\t}\n}\n\nexport function resolveDynamicFanoutItems(step: DynamicParallelStep, outputs: ChainOutputMap, stepIndex: number, config: DynamicFanoutConfig = {}): DynamicMaterializedItem[] {\n\tvalidateDynamicStepShape(step, stepIndex, config);\n\tconst sourceName = step.expand.from.output;\n\tconst source = outputs[sourceName];\n\tif (!source) throw new DynamicFanoutError(`Dynamic chain step ${stepIndex + 1} references unknown output '${sourceName}'.`);\n\tif (source.structured === undefined) throw new DynamicFanoutError(`Dynamic chain step ${stepIndex + 1} requires structured output '${sourceName}'.`);\n\tconst value = resolveJsonPointer(source.structured, step.expand.from.path, `Dynamic chain step ${stepIndex + 1} expand.from.path`);\n\tif (!Array.isArray(value)) throw new DynamicFanoutError(`Dynamic chain step ${stepIndex + 1} expand.from.path must resolve to an array.`);\n\tconst maxItems = step.expand.maxItems ?? config.maxItems;\n\tif (maxItems === undefined) throw new DynamicFanoutError(`Dynamic chain step ${stepIndex + 1} requires an effective maxItems.`);\n\tif (value.length > maxItems) throw new DynamicFanoutError(`Dynamic chain step ${stepIndex + 1} resolved ${value.length} items, exceeding maxItems ${maxItems}.`);\n\tconst seen = new Set<string>();\n\tconst seenIds = new Set<string>();\n\treturn value.map((item, index) => {\n\t\tconst key = step.expand.key === undefined\n\t\t\t? String(index)\n\t\t\t: scalarToKey(resolveJsonPointer(item, step.expand.key, `Dynamic chain step ${stepIndex + 1} expand.key`), `Dynamic chain step ${stepIndex + 1} expand.key`);\n\t\tif (seen.has(key)) throw new DynamicFanoutError(`Dynamic chain step ${stepIndex + 1} produced duplicate item key '${key}'.`);\n\t\tseen.add(key);\n\t\tconst idKey = normalizeItemKeyForId(key);\n\t\tif (seenIds.has(idKey)) throw new DynamicFanoutError(`Dynamic chain step ${stepIndex + 1} produced colliding item id '${idKey}'.`);\n\t\tseenIds.add(idKey);\n\t\treturn { index, key, idKey, item };\n\t});\n}\n\nexport function materializeDynamicParallelStep(step: DynamicParallelStep, outputs: ChainOutputMap, stepIndex: number, config: DynamicFanoutConfig = {}): DynamicMaterializedGroup {\n\tconst items = resolveDynamicFanoutItems(step, outputs, stepIndex, config);\n\tif (items.length === 0) {\n\t\tif ((step.expand.onEmpty ?? \"skip\") === \"fail\") {\n\t\t\tthrow new DynamicFanoutError(`Dynamic chain step ${stepIndex + 1} source array is empty.`);\n\t\t}\n\t\treturn { items, parallel: [], collectedOnEmpty: [] };\n\t}\n\tconst itemName = step.expand.item ?? \"item\";\n\tconst parallel = items.map((entry) => {\n\t\tconst task = resolveItemTemplate(step.parallel.task ?? \"{previous}\", itemName, entry.item);\n\t\tconst label = step.parallel.label ? resolveItemTemplate(step.parallel.label, itemName, entry.item) : undefined;\n\t\treturn {\n\t\t\t...step.parallel,\n\t\t\ttask,\n\t\t\t...(label !== undefined ? { label } : {}),\n\t\t};\n\t});\n\treturn { items, parallel };\n}\n\nexport function collectDynamicResults(\n\tstep: DynamicParallelStep,\n\titems: DynamicMaterializedItem[],\n\tresults: Array<Pick<SingleResult, \"agent\" | \"exitCode\" | \"error\" | \"timedOut\" | \"stopped\" | \"structuredOutput\" | \"artifactPaths\" | \"savedOutputPath\"> & { output?: string; finalOutput?: string }>,\n): DynamicCollectedResult[] {\n\treturn items.map((entry, index) => {\n\t\tconst result = results[index];\n\t\tconst text = result\n\t\t\t? (\"output\" in result && typeof result.output === \"string\" ? result.output : getSingleResultOutput(result as SingleResult))\n\t\t\t: \"\";\n\t\treturn {\n\t\t\tkey: entry.key,\n\t\t\tindex: entry.index,\n\t\t\titem: entry.item,\n\t\t\tagent: result?.agent ?? step.parallel.agent,\n\t\t\texitCode: result?.exitCode ?? null,\n\t\t\ttext,\n\t\t\t...(result?.structuredOutput !== undefined ? { structured: result.structuredOutput } : {}),\n\t\t\t...(result?.error ? { error: result.error } : {}),\n\t\t\t...(result?.timedOut ? { timedOut: true } : {}),\n\t\t\t...(result?.stopped ? { stopped: true } : {}),\n\t\t\t...(result?.savedOutputPath ? { outputPath: result.savedOutputPath } : {}),\n\t\t\t...(result?.artifactPaths ? { artifactPaths: result.artifactPaths } : {}),\n\t\t};\n\t});\n}\n\nexport function validateDynamicCollection(schema: JsonSchemaObject | undefined, value: DynamicCollectedResult[]): void {\n\tif (!schema) return;\n\tconst validation = validateStructuredOutputValue(schema, value);\n\tif (validation.status === \"invalid\") {\n\t\tthrow new DynamicFanoutError(`Collected output validation failed: ${validation.message}`);\n\t}\n}\n"]}

package/dist/builtin-extensions/pi-subagents/src/runs/shared/long-running-guard.d.ts

@@ -0,0 +1,33 @@
+import type { ResolvedControlConfig } from "../../shared/types.ts";
+interface LongRunningNoticeMetrics {
+    startedAt: number;
+    now: number;
+    turns: number;
+    tokens: number;
+}
+type LongRunningTriggerReason = "time_threshold" | "turn_threshold" | "token_threshold";
+interface FailedMutatingAttempt {
+    tool: string;
+    path?: string;
+    error: string;
+    ts: number;
+}
+interface MutatingFailureState {
+    consecutiveFailures: number;
+    lastFailureAt?: number;
+    recentFailures: FailedMutatingAttempt[];
+    lastMutatingPath?: string;
+    repeatedPathFailures: number;
+}
+export declare function resolveCurrentPath(toolName: string | undefined, args: Record<string, unknown> | undefined): string | undefined;
+export declare function isMutatingBashCommand(command: string): boolean;
+export declare function isMutatingTool(toolName: string | undefined, args: Record<string, unknown> | undefined): boolean;
+export declare function didMutatingToolFail(text: string): boolean;
+export declare function nextLongRunningTrigger(config: ResolvedControlConfig, metrics: LongRunningNoticeMetrics): LongRunningTriggerReason | undefined;
+export declare function resetMutatingFailureState(state: MutatingFailureState): void;
+export declare function createMutatingFailureState(): MutatingFailureState;
+export declare function recordMutatingFailure(state: MutatingFailureState, input: FailedMutatingAttempt, windowMs: number): void;
+export declare function shouldEscalateMutatingFailures(state: MutatingFailureState, threshold: number): boolean;
+export declare function summarizeRecentMutatingFailures(state: MutatingFailureState): string | undefined;
+export {};
+//# sourceMappingURL=long-running-guard.d.ts.map

package/dist/builtin-extensions/pi-subagents/src/runs/shared/long-running-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"long-running-guard.d.ts","sourceRoot":"","sources":["../../../../../../src/builtin-extensions/pi-subagents/src/runs/shared/long-running-guard.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEnE,UAAU,wBAAwB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CACf;AAED,KAAK,wBAAwB,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,iBAAiB,CAAC;AAExF,UAAU,qBAAqB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;CACX;AAED,UAAU,oBAAoB;IAC7B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,qBAAqB,EAAE,CAAC;IACxC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oBAAoB,EAAE,MAAM,CAAC;CAC7B;AA8BD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAc9H;AA8BD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,OAAO,CAO/G;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGzD;AAED,wBAAgB,sBAAsB,CACrC,MAAM,EAAE,qBAAqB,EAC7B,OAAO,EAAE,wBAAwB,GAC/B,wBAAwB,GAAG,SAAS,CAKtC;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAM3E;AAED,wBAAgB,0BAA0B,IAAI,oBAAoB,CAMjE;AAED,wBAAgB,qBAAqB,CACpC,KAAK,EAAE,oBAAoB,EAC3B,KAAK,EAAE,qBAAqB,EAC5B,QAAQ,EAAE,MAAM,GACd,IAAI,CAiBN;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAEtG;AAED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,GAAG,SAAS,CAK/F","sourcesContent":["// @ts-nocheck\nimport type { ResolvedControlConfig } from \"../../shared/types.ts\";\n\ninterface LongRunningNoticeMetrics {\n\tstartedAt: number;\n\tnow: number;\n\tturns: number;\n\ttokens: number;\n}\n\ntype LongRunningTriggerReason = \"time_threshold\" | \"turn_threshold\" | \"token_threshold\";\n\ninterface FailedMutatingAttempt {\n\ttool: string;\n\tpath?: string;\n\terror: string;\n\tts: number;\n}\n\ninterface MutatingFailureState {\n\tconsecutiveFailures: number;\n\tlastFailureAt?: number;\n\trecentFailures: FailedMutatingAttempt[];\n\tlastMutatingPath?: string;\n\trepeatedPathFailures: number;\n}\n\nconst MUTATING_BASH_PATTERNS = [\n\t/(^|[;&|()\\s])rm\\s+/,\n\t/(^|[;&|()\\s])mv\\s+/,\n\t/(^|[;&|()\\s])cp\\s+/,\n\t/(^|[;&|()\\s])mkdir\\s+/,\n\t/(^|[;&|()\\s])touch\\s+/,\n\t/(^|[;&|()\\s])git\\s+apply\\b/,\n\t/(^|[;&|()\\s])patch\\s+/,\n\t/(^|[;&|()\\s])sed\\s+[^\\n;&|]*\\s-i\\b/,\n\t/(^|[;&|()\\s])perl\\s+[^\\n;&|]*\\s-pi\\b/,\n\t/(^|[;&|()]|\\n)\\s*tee\\s+[^|&;]+/,\n\t/\\b(writeFile|writeFileSync|appendFile|appendFileSync)\\b/,\n\t/\\bwrite_text\\s*\\(/,\n\t/\\bopen\\s*\\([^)]*,\\s*[\"'][wa]/,\n];\n\nconst MUTATING_FAILURE_HINTS = [\n\t\"failed\",\n\t\"error\",\n\t\"no exact match\",\n\t\"did not match\",\n\t\"malformed\",\n\t\"rejected\",\n\t\"unable\",\n\t\"cannot\",\n\t\"could not\",\n];\n\nexport function resolveCurrentPath(toolName: string | undefined, args: Record<string, unknown> | undefined): string | undefined {\n\tif (!toolName || !args) return undefined;\n\tconst direct = [\"path\", \"file\", \"filename\", \"target\", \"cwd\"];\n\tfor (const key of direct) {\n\t\tconst value = args[key];\n\t\tif (typeof value === \"string\" && value.trim()) return value.trim();\n\t}\n\tif (toolName === \"bash\") {\n\t\tconst command = typeof args.command === \"string\" ? args.command : undefined;\n\t\tif (!command) return undefined;\n\t\tconst redirect = command.match(/(?:>|>>|tee\\s+)(\\S+)/);\n\t\tif (redirect?.[1]) return redirect[1];\n\t}\n\treturn undefined;\n}\n\nfunction hasUnquotedFileRedirection(command: string): boolean {\n\tlet inSingle = false;\n\tlet inDouble = false;\n\tfor (let i = 0; i < command.length; i++) {\n\t\tconst char = command[i]!;\n\t\tif (char === \"'\" && !inDouble) {\n\t\t\tinSingle = !inSingle;\n\t\t\tcontinue;\n\t\t}\n\t\tif (char === '\"' && !inSingle) {\n\t\t\tinDouble = !inDouble;\n\t\t\tcontinue;\n\t\t}\n\t\tif (inSingle || inDouble) continue;\n\t\tif (char !== \">\") continue;\n\t\tif (command[i - 1] === \"-\") continue;\n\t\tconst isDouble = command[i + 1] === \">\";\n\t\tlet cursor = i + (isDouble ? 2 : 1);\n\t\twhile (cursor < command.length && /\\s/.test(command[cursor]!)) cursor++;\n\t\tif (cursor >= command.length) continue;\n\t\tconst targetStart = command[cursor]!;\n\t\tif (targetStart === \"&\" || targetStart === \"|\" || targetStart === \";\") continue;\n\t\tif (targetStart === \"(\" || targetStart === \")\") continue;\n\t\treturn true;\n\t}\n\treturn false;\n}\n\nexport function isMutatingBashCommand(command: string): boolean {\n\treturn hasUnquotedFileRedirection(command) || MUTATING_BASH_PATTERNS.some((pattern) => pattern.test(command));\n}\n\nexport function isMutatingTool(toolName: string | undefined, args: Record<string, unknown> | undefined): boolean {\n\tif (!toolName) return false;\n\tif (toolName === \"edit\" || toolName === \"write\") return true;\n\tif (toolName !== \"bash\") return false;\n\tconst command = typeof args?.command === \"string\" ? args.command : \"\";\n\tif (!command.trim()) return false;\n\treturn isMutatingBashCommand(command);\n}\n\nexport function didMutatingToolFail(text: string): boolean {\n\tconst lowered = text.toLowerCase();\n\treturn MUTATING_FAILURE_HINTS.some((hint) => lowered.includes(hint));\n}\n\nexport function nextLongRunningTrigger(\n\tconfig: ResolvedControlConfig,\n\tmetrics: LongRunningNoticeMetrics,\n): LongRunningTriggerReason | undefined {\n\tif (metrics.now - metrics.startedAt >= config.activeNoticeAfterMs) return \"time_threshold\";\n\tif (config.activeNoticeAfterTurns !== undefined && metrics.turns >= config.activeNoticeAfterTurns) return \"turn_threshold\";\n\tif (config.activeNoticeAfterTokens !== undefined && metrics.tokens >= config.activeNoticeAfterTokens) return \"token_threshold\";\n\treturn undefined;\n}\n\nexport function resetMutatingFailureState(state: MutatingFailureState): void {\n\tstate.consecutiveFailures = 0;\n\tstate.lastFailureAt = undefined;\n\tstate.recentFailures = [];\n\tstate.lastMutatingPath = undefined;\n\tstate.repeatedPathFailures = 0;\n}\n\nexport function createMutatingFailureState(): MutatingFailureState {\n\treturn {\n\t\tconsecutiveFailures: 0,\n\t\trecentFailures: [],\n\t\trepeatedPathFailures: 0,\n\t};\n}\n\nexport function recordMutatingFailure(\n\tstate: MutatingFailureState,\n\tinput: FailedMutatingAttempt,\n\twindowMs: number,\n): void {\n\tif (state.lastFailureAt === undefined || input.ts - state.lastFailureAt > windowMs) {\n\t\tstate.consecutiveFailures = 0;\n\t\tstate.recentFailures = [];\n\t\tstate.repeatedPathFailures = 0;\n\t\tstate.lastMutatingPath = undefined;\n\t}\n\tstate.lastFailureAt = input.ts;\n\tstate.consecutiveFailures += 1;\n\tif (input.path && state.lastMutatingPath === input.path) {\n\t\tstate.repeatedPathFailures += 1;\n\t} else if (input.path) {\n\t\tstate.lastMutatingPath = input.path;\n\t\tstate.repeatedPathFailures = 1;\n\t}\n\tstate.recentFailures.push(input);\n\tif (state.recentFailures.length > 3) state.recentFailures.shift();\n}\n\nexport function shouldEscalateMutatingFailures(state: MutatingFailureState, threshold: number): boolean {\n\treturn state.consecutiveFailures >= threshold || state.repeatedPathFailures >= threshold;\n}\n\nexport function summarizeRecentMutatingFailures(state: MutatingFailureState): string | undefined {\n\tif (state.recentFailures.length === 0) return undefined;\n\treturn state.recentFailures\n\t\t.map((entry) => `${entry.tool}${entry.path ? `(${entry.path})` : \"\"}: ${entry.error}`)\n\t\t.join(\" | \");\n}\n"]}