pi-subagents 0.68.0 → 0.70.0

package/src/runs/shared/cursor-agent-adapter.js

@@ -0,0 +1,100 @@
+import * as path from "node:path";
+import { parseExternalCliJsonlEvent } from "./external-cli-runner.js";
+const MAX_EVENT_TYPE_LENGTH = 128;
+const MAX_ERROR_LENGTH = 4_096;
+const MAX_OVERSIZED_TOOL_CALL_BYTES = 1024 * 1024;
+export const CURSOR_AGENT_ADAPTER_ID = "cursor-agent";
+export const CURSOR_AGENT_WRITER_ADAPTER_ID = "cursor-agent-writer";
+export const CURSOR_AGENT_ENV_ALLOWLIST = [
+    "PATH",
+    "HOME",
+    "USERPROFILE",
+    "CURSOR_API_KEY",
+    "HTTP_PROXY",
+    "HTTPS_PROXY",
+    "NO_PROXY",
+    "http_proxy",
+    "https_proxy",
+    "no_proxy",
+    "SSL_CERT_FILE",
+    "SSL_CERT_DIR",
+];
+function terminalError(event) {
+    for (const value of [event.result, event.error, event.message]) {
+        if (typeof value === "string" && value.trim())
+            return value.trim().slice(0, MAX_ERROR_LENGTH);
+    }
+    const subtype = typeof event.subtype === "string" && event.subtype ? event.subtype : "unknown";
+    return `Cursor Agent reported terminal result ${subtype}.`;
+}
+export function createCursorAgentJsonlParser() {
+    let eventCount = 0;
+    let terminal;
+    return {
+        parseLine(line) {
+            const event = parseExternalCliJsonlEvent(line, "Cursor Agent", MAX_EVENT_TYPE_LENGTH);
+            if (terminal)
+                throw new Error("Cursor Agent emitted an event after its terminal state.");
+            eventCount += 1;
+            if (event.type === "error")
+                terminal = { state: "failed", error: terminalError(event) };
+            else if (event.type === "result") {
+                if (event.subtype === "success" && event.is_error === false && typeof event.result === "string" && event.result.trim()) {
+                    terminal = { state: "completed", output: event.result.trim() };
+                }
+                else
+                    terminal = { state: "failed", error: terminalError(event) };
+            }
+            return { phase: terminal ? terminal.state : "streaming", eventCount };
+        },
+        skipOversizedLine(prefix, byteLength) {
+            if (terminal || byteLength > MAX_OVERSIZED_TOOL_CALL_BYTES || !/^\s*\{\s*"type"\s*:\s*"tool_call"\s*,/.test(prefix))
+                return undefined;
+            eventCount += 1;
+            return { phase: "streaming", eventCount };
+        },
+        finish() {
+            return terminal;
+        },
+    };
+}
+export function resolveCursorAgentLaunch(input) {
+    const writer = input.adapter === CURSOR_AGENT_WRITER_ADAPTER_ID;
+    const promptDirectory = path.join(input.asyncDir, `external-${input.stepIndex}.cursor-prompt`);
+    const promptFilePath = path.join(promptDirectory, "handoff.txt");
+    const promptRelative = path.relative(input.cwd, promptDirectory);
+    const promptOutsideWorkspace = promptRelative.startsWith("..") || path.isAbsolute(promptRelative);
+    const prefix = [...(input.commandPrefixArgs ?? [])];
+    const args = [
+        ...prefix,
+        "-p",
+        "--output-format", "stream-json",
+        ...(writer ? [] : ["--mode", "ask"]),
+        "--sandbox", "enabled",
+        "--workspace", input.cwd,
+        ...(promptOutsideWorkspace ? ["--add-dir", promptDirectory] : []),
+        `Read the complete handoff from the private file at ${promptFilePath}. Follow it and return only the final answer.`,
+    ];
+    return {
+        command: input.command,
+        args,
+        promptFilePath,
+        temporaryDirectories: [promptDirectory],
+        environment: { allowlist: CURSOR_AGENT_ENV_ALLOWLIST },
+        preflight: {
+            id: input.adapter,
+            versionArgs: [...prefix, "--version"],
+            helpArgs: [...prefix, "--help"],
+            validate(result) {
+                if (!/^\d{4}\.\d{2}\.\d{2}-[0-9a-f]+$/.test(result.version))
+                    throw new Error(`Unsupported Cursor Agent version response: ${JSON.stringify(result.version)}.`);
+                for (const required of ["Start the Cursor Agent", "--print", "stream-json", "--sandbox <mode>", "enabled", "--workspace <path-or-name>", "--add-dir <path>", ...(writer ? ["all tools", "including write and shell"] : ["--mode <mode>", "ask:", "read-only"])]) {
+                    if (!result.help.includes(required))
+                        throw new Error(`Cursor Agent help does not document required option ${JSON.stringify(required)}.`);
+                }
+            },
+        },
+        parser: createCursorAgentJsonlParser(),
+    };
+}
+//# sourceMappingURL=cursor-agent-adapter.js.map

package/src/runs/shared/cursor-agent-adapter.js.map

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

package/src/runs/shared/dynamic-fanout.d.ts

@@ -0,0 +1,50 @@
+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" | "error" | "timedOut" | "stopped" | "structuredOutput" | "artifactPaths" | "savedOutputPath"> & {
+    exitCode: number | null;
+    output?: string;
+    finalOutput?: string;
+}>): DynamicCollectedResult[];
+export declare function validateDynamicCollection(schema: JsonSchemaObject | undefined, value: DynamicCollectedResult[]): Promise<void>;
+//# sourceMappingURL=dynamic-fanout.d.ts.map

package/src/runs/shared/dynamic-fanout.d.ts.map

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

package/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", "agentContract", "gateOn"]);
+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", "machine", "output", "outputMode", "reads", "progress", "skill", "model", "fast", "toolBudget", "acceptance", "agentContract", "gateOn"]);
+const RUNNER_DYNAMIC_PARALLEL_KEYS = new Set([
+    ...DYNAMIC_PARALLEL_KEYS,
+    "outputName", "structured", "inheritProjectContext", "inheritGlobalContext", "inheritSkills", "skills", "outputPath", "namespaceOutputPath", "maxSubagentDepth", "timeoutMs", "waitToolEnabled", "waitToolDefaultTimeoutMs",
+    "structuredOutput", "structuredOutputSchema", "tools", "excludeTools", "allowNestedSubagents", "extensions", "subagentOnlyExtensions", "mcpDirectTools", "mutationTools", "capabilityCeiling", "completionGuard", "systemPrompt",
+    "systemPromptMode", "thinking", "requestedModel", "sessionFile", "effectiveAcceptance", "acceptanceInput", "acceptanceRole", "parentSessionId", "requiredExtensions", "launchResolvedExtensions", "requestedCwd", "machineEnv",
+]);
+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 async function validateDynamicCollection(schema, value) {
+    if (!schema)
+        return;
+    const validation = await validateStructuredOutputValue(schema, value);
+    if (validation.status === "invalid") {
+        throw new DynamicFanoutError(`Collected output validation failed: ${validation.message}`);
+    }
+}
+//# sourceMappingURL=dynamic-fanout.js.map

package/src/runs/shared/dynamic-fanout.js.map

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

package/src/runs/shared/effective-system-prompt.d.ts

@@ -0,0 +1,18 @@
+import type { AgentConfig } from "../../agents/agents.ts";
+import { buildSkillInjection } from "../../agents/skills.ts";
+export interface EffectiveSystemPromptInput {
+    /** Agent as handed to the child, including runtime-declared overlays such as the Intercom bridge. */
+    agent: AgentConfig;
+    resolvedSkills: Parameters<typeof buildSkillInjection>[0];
+    /** Directory that scopes memory and refinement lookups. */
+    cwd: string;
+    /** Omit when the caller injects the output path through another channel. */
+    outputPath?: string;
+}
+/**
+ * Child system prompt in the order preflight and every execution path hash:
+ * base prompt, skills, memory, refinement overlay, output path. Runtime
+ * acceptance prose is appended later and stays outside launch identity.
+ */
+export declare function buildEffectiveSystemPrompt(input: EffectiveSystemPromptInput): string;
+//# sourceMappingURL=effective-system-prompt.d.ts.map

package/src/runs/shared/effective-system-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effective-system-prompt.d.ts","sourceRoot":"","sources":["../../../../src/runs/shared/effective-system-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAG1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAG7D,MAAM,WAAW,0BAA0B;IAC1C,qGAAqG;IACrG,KAAK,EAAE,WAAW,CAAC;IACnB,cAAc,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1D,2DAA2D;IAC3D,GAAG,EAAE,MAAM,CAAC;IACZ,4EAA4E;IAC5E,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAMD;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,0BAA0B,GAAG,MAAM,CAOpF"}

package/src/runs/shared/effective-system-prompt.js

@@ -0,0 +1,23 @@
+import { buildAgentMemoryInjection } from "../../agents/agent-memory.js";
+import { appendAgentRefinementOverlay } from "../../agents/agent-refinements.js";
+import { buildSkillInjection } from "../../agents/skills.js";
+import { injectOutputPathSystemPrompt } from "./single-output.js";
+function appendSection(prompt, section) {
+    return prompt ? `${prompt}\n\n${section}` : section;
+}
+/**
+ * Child system prompt in the order preflight and every execution path hash:
+ * base prompt, skills, memory, refinement overlay, output path. Runtime
+ * acceptance prose is appended later and stays outside launch identity.
+ */
+export function buildEffectiveSystemPrompt(input) {
+    let prompt = input.agent.systemPrompt?.trim() ?? "";
+    if (input.resolvedSkills.length > 0)
+        prompt = appendSection(prompt, buildSkillInjection(input.resolvedSkills));
+    const memoryInjection = buildAgentMemoryInjection(input.agent, input.cwd);
+    if (memoryInjection)
+        prompt = appendSection(prompt, memoryInjection);
+    prompt = appendAgentRefinementOverlay(prompt, { cwd: input.cwd, agentName: input.agent.name });
+    return injectOutputPathSystemPrompt(prompt, input.outputPath, input.agent);
+}
+//# sourceMappingURL=effective-system-prompt.js.map

package/src/runs/shared/effective-system-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effective-system-prompt.js","sourceRoot":"","sources":["../../../../src/runs/shared/effective-system-prompt.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AAYlE,SAAS,aAAa,CAAC,MAAc,EAAE,OAAe;IACrD,OAAO,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,OAAO,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;AACrD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CAAC,KAAiC;IAC3E,IAAI,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACpD,IAAI,KAAK,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,GAAG,aAAa,CAAC,MAAM,EAAE,mBAAmB,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC;IAC/G,MAAM,eAAe,GAAG,yBAAyB,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAC1E,IAAI,eAAe;QAAE,MAAM,GAAG,aAAa,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACrE,MAAM,GAAG,4BAA4B,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/F,OAAO,4BAA4B,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;AAC5E,CAAC"}

package/src/runs/shared/extension-bindings.d.ts

@@ -0,0 +1,17 @@
+export declare const PI_SUBAGENT_EXTENSION_BINDINGS_ENV = "PI_SUBAGENT_EXTENSION_BINDINGS";
+export declare const MAX_EXTENSION_BINDING_NAMESPACES = 16;
+export declare const MAX_EXTENSION_BINDINGS_BYTES: number;
+export declare const MAX_EXTENSION_BINDINGS_DEPTH = 16;
+export declare const MAX_EXTENSION_BINDINGS_PROPERTIES = 256;
+export type ExtensionBindingJson = null | boolean | number | string | ReadonlyArray<ExtensionBindingJson> | {
+    readonly [key: string]: ExtensionBindingJson;
+};
+export type ExtensionBindings = Readonly<Record<string, ExtensionBindingJson>>;
+export interface NormalizedExtensionBindings {
+    value: ExtensionBindings;
+    json: string;
+}
+export declare function normalizeExtensionBindings(input: unknown): NormalizedExtensionBindings | undefined;
+export declare function encodeExtensionBindings(input: ExtensionBindings | undefined): string | undefined;
+export declare function omitExtensionBindingsEnv(env: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+//# sourceMappingURL=extension-bindings.d.ts.map

package/src/runs/shared/extension-bindings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-bindings.d.ts","sourceRoot":"","sources":["../../../../src/runs/shared/extension-bindings.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kCAAkC,mCAAmC,CAAC;AACnF,eAAO,MAAM,gCAAgC,KAAK,CAAC;AACnD,eAAO,MAAM,4BAA4B,QAAY,CAAC;AACtD,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAC/C,eAAO,MAAM,iCAAiC,MAAM,CAAC;AAIrD,MAAM,MAAM,oBAAoB,GAAG,IAAI,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,aAAa,CAAC,oBAAoB,CAAC,GAAG;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,oBAAoB,CAAA;CAAE,CAAC;AAC7J,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC;AAE/E,MAAM,WAAW,2BAA2B;IAC3C,KAAK,EAAE,iBAAiB,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;CACb;AAuCD,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,2BAA2B,GAAG,SAAS,CAelG;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,iBAAiB,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAEhG;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAGlF"}

package/src/runs/shared/extension-bindings.js

@@ -0,0 +1,83 @@
+export const PI_SUBAGENT_EXTENSION_BINDINGS_ENV = "PI_SUBAGENT_EXTENSION_BINDINGS";
+export const MAX_EXTENSION_BINDING_NAMESPACES = 16;
+export const MAX_EXTENSION_BINDINGS_BYTES = 16 * 1024;
+export const MAX_EXTENSION_BINDINGS_DEPTH = 16;
+export const MAX_EXTENSION_BINDINGS_PROPERTIES = 256;
+const EXTENSION_BINDING_NAMESPACE = /^[A-Za-z0-9](?:[A-Za-z0-9._-]{0,62})\/[1-9][0-9]{0,8}$/;
+function canonicalizeJson(value, path, depth, seen, propertyCount) {
+    if (value === null || typeof value === "string" || typeof value === "boolean")
+        return value;
+    if (typeof value === "number") {
+        if (!Number.isFinite(value))
+            throw new Error(`${path} must contain only finite JSON numbers.`);
+        return value;
+    }
+    if (typeof value !== "object")
+        throw new Error(`${path} must contain only plain JSON values.`);
+    if (depth > MAX_EXTENSION_BINDINGS_DEPTH)
+        throw new Error(`${path} exceeds the maximum nesting depth of ${MAX_EXTENSION_BINDINGS_DEPTH}.`);
+    if (seen.has(value))
+        throw new Error(`${path} must not contain cycles.`);
+    seen.add(value);
+    try {
+        if (Array.isArray(value)) {
+            const output = [];
+            for (let index = 0; index < value.length; index++) {
+                if (!Object.prototype.hasOwnProperty.call(value, index))
+                    throw new Error(`${path} must not contain sparse arrays.`);
+                output.push(canonicalizeJson(value[index], `${path}[${index}]`, depth + 1, seen, propertyCount));
+            }
+            return Object.freeze(output);
+        }
+        const prototype = Object.getPrototypeOf(value);
+        if (prototype !== Object.prototype && prototype !== null)
+            throw new Error(`${path} must contain only plain JSON objects.`);
+        if (Object.getOwnPropertySymbols(value).length > 0)
+            throw new Error(`${path} must not contain symbol keys.`);
+        const descriptors = Object.getOwnPropertyDescriptors(value);
+        const output = {};
+        for (const key of Object.keys(descriptors).sort()) {
+            const descriptor = descriptors[key];
+            if (!descriptor.enumerable || !("value" in descriptor))
+                throw new Error(`${path}.${key} must be an enumerable data property.`);
+            propertyCount.value += 1;
+            if (propertyCount.value > MAX_EXTENSION_BINDINGS_PROPERTIES)
+                throw new Error(`extensionBindings exceeds ${MAX_EXTENSION_BINDINGS_PROPERTIES} total properties.`);
+            Object.defineProperty(output, key, { value: canonicalizeJson(descriptor.value, `${path}.${key}`, depth + 1, seen, propertyCount), enumerable: true, writable: false, configurable: false });
+        }
+        return Object.freeze(output);
+    }
+    finally {
+        seen.delete(value);
+    }
+}
+export function normalizeExtensionBindings(input) {
+    if (input === undefined)
+        return undefined;
+    if (!input || typeof input !== "object" || Array.isArray(input))
+        throw new Error("extensionBindings must be a plain JSON object.");
+    const prototype = Object.getPrototypeOf(input);
+    if (prototype !== Object.prototype && prototype !== null)
+        throw new Error("extensionBindings must be a plain JSON object.");
+    const keys = Object.keys(input);
+    if (keys.length > MAX_EXTENSION_BINDING_NAMESPACES)
+        throw new Error(`extensionBindings supports at most ${MAX_EXTENSION_BINDING_NAMESPACES} namespaces.`);
+    for (const key of keys) {
+        if (!EXTENSION_BINDING_NAMESPACE.test(key))
+            throw new Error(`extensionBindings namespace '${key}' must use a package-like name followed by '/<positive-version>'.`);
+    }
+    const value = canonicalizeJson(input, "extensionBindings", 0, new Set(), { value: 0 });
+    const json = JSON.stringify(value);
+    const bytes = Buffer.byteLength(json, "utf8");
+    if (bytes > MAX_EXTENSION_BINDINGS_BYTES)
+        throw new Error(`extensionBindings canonical JSON is ${bytes} bytes; maximum is ${MAX_EXTENSION_BINDINGS_BYTES}.`);
+    return { value, json };
+}
+export function encodeExtensionBindings(input) {
+    return input === undefined ? undefined : normalizeExtensionBindings(input).json;
+}
+export function omitExtensionBindingsEnv(env) {
+    const { [PI_SUBAGENT_EXTENSION_BINDINGS_ENV]: _extensionBindings, ...sanitized } = env;
+    return sanitized;
+}
+//# sourceMappingURL=extension-bindings.js.map