pi-subagents 0.69.0 → 0.70.0

package/src/shared/fork-session-cwd.d.ts

@@ -0,0 +1,3 @@
+/** Keep Pi from restoring a forked session into the parent's cwd instead of the child launch cwd. */
+export declare function alignForkedSessionCwd(sessionFile: string, cwd: string): void;
+//# sourceMappingURL=fork-session-cwd.d.ts.map

package/src/shared/fork-session-cwd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fork-session-cwd.d.ts","sourceRoot":"","sources":["../../../src/shared/fork-session-cwd.ts"],"names":[],"mappings":"AASA,qGAAqG;AACrG,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAgB5E"}

package/src/shared/fork-session-cwd.js

@@ -0,0 +1,24 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+/** Keep Pi from restoring a forked session into the parent's cwd instead of the child launch cwd. */
+export function alignForkedSessionCwd(sessionFile, cwd) {
+    const lines = fs.readFileSync(sessionFile, "utf-8").split("\n").filter((line) => line.trim().length > 0);
+    const entries = lines.map((line, index) => {
+        try {
+            return JSON.parse(line);
+        }
+        catch (error) {
+            const cause = error instanceof Error ? error : new Error(String(error));
+            throw new Error(`Unable to inspect forked session ${sessionFile}: invalid JSONL on line ${index + 1}: ${cause.message}`, { cause });
+        }
+    });
+    const header = entries[0];
+    if (header?.type !== "session")
+        throw new Error(`Forked session ${sessionFile} does not start with a session header.`);
+    const effectiveCwd = fs.realpathSync.native(path.resolve(cwd));
+    if (header.cwd === effectiveCwd)
+        return;
+    header.cwd = effectiveCwd;
+    fs.writeFileSync(sessionFile, `${entries.map((entry) => JSON.stringify(entry)).join("\n")}\n`, "utf-8");
+}
+//# sourceMappingURL=fork-session-cwd.js.map

package/src/shared/fork-session-cwd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fork-session-cwd.js","sourceRoot":"","sources":["../../../src/shared/fork-session-cwd.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAQlC,qGAAqG;AACrG,MAAM,UAAU,qBAAqB,CAAC,WAAmB,EAAE,GAAW;IACrE,MAAM,KAAK,GAAG,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACzG,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QACzC,IAAI,CAAC;YACJ,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAiB,CAAC;QACzC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,KAAK,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACxE,MAAM,IAAI,KAAK,CAAC,oCAAoC,WAAW,2BAA2B,KAAK,GAAG,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACrI,CAAC;IACF,CAAC,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC1B,IAAI,MAAM,EAAE,IAAI,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,WAAW,wCAAwC,CAAC,CAAC;IACvH,MAAM,YAAY,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/D,IAAI,MAAM,CAAC,GAAG,KAAK,YAAY;QAAE,OAAO;IACxC,MAAM,CAAC,GAAG,GAAG,YAAY,CAAC;IAC1B,EAAE,CAAC,aAAa,CAAC,WAAW,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACzG,CAAC"}

package/src/shared/formatters.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Formatting utilities for display output
+ */
+import type { Usage, SingleResult, TokenUsage } from "./types.ts";
+import type { ChainStep } from "./settings.ts";
+/**
+ * Format token count for compact display.
+ */
+export declare function formatTokens(n: number): string;
+export declare function formatTokenUsage(usage: TokenUsage, legacyLabel?: string): string;
+export declare function formatContextUsage(usage: Pick<TokenUsage, "window" | "windowPeak">, contextLimit: number): string | undefined;
+export declare function formatModelThinking(model?: string, thinking?: string): string;
+/**
+ * Format usage statistics into a compact string
+ */
+export declare function formatUsage(u: Usage, model?: string): string;
+/**
+ * Format duration in human-readable form
+ */
+export declare function formatDuration(ms: number): string;
+/**
+ * Build a summary string for a completed/failed chain
+ */
+export declare function buildChainSummary(steps: ChainStep[], results: SingleResult[], chainDir: string, status: "completed" | "failed", failedStep?: {
+    index: number;
+    error: string;
+}): string;
+/**
+ * Format a tool call for display
+ */
+export declare function formatToolCall(name: string, args: Record<string, unknown>, expanded?: boolean): string;
+/**
+ * Shorten a path by replacing home directory with ~
+ */
+export declare function shortenPath(p: string): string;
+//# sourceMappingURL=formatters.d.ts.map

package/src/shared/formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../../../src/shared/formatters.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAK/C;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAK9C;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,WAAW,SAAQ,GAAG,MAAM,CAI/E;AACD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,QAAQ,GAAG,YAAY,CAAC,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAK7H;AAED,wBAAgB,mBAAmB,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAU7E;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAU5D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAIjD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAChC,KAAK,EAAE,SAAS,EAAE,EAClB,OAAO,EAAE,YAAY,EAAE,EACvB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,WAAW,GAAG,QAAQ,EAC9B,UAAU,CAAC,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC3C,MAAM,CA8BR;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,UAAQ,GAAG,MAAM,CAoBpG;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAM7C"}

package/src/shared/formatters.js

@@ -0,0 +1,143 @@
+/**
+ * Formatting utilities for display output
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { isDynamicParallelStep, isParallelStep } from "./settings.js";
+import { previewDisplayText, sanitizeDisplayText } from "./display-text.js";
+import { splitKnownThinkingSuffix, THINKING_LEVELS } from "./model-info.js";
+/**
+ * Format token count for compact display.
+ */
+export function formatTokens(n) {
+    if (n < 1000)
+        return String(n);
+    if (n < 10000)
+        return `${(n / 1000).toFixed(1)}k`;
+    if (n < 999_500)
+        return `${Math.round(n / 1000)}k`;
+    return `${Number((n / 1_000_000).toFixed(1))}M`;
+}
+export function formatTokenUsage(usage, legacyLabel = "tok") {
+    return usage.window !== undefined
+        ? `${formatTokens(usage.window)} window · ${formatTokens(usage.total)} spent`
+        : `${formatTokens(usage.total)} ${legacyLabel}`;
+}
+export function formatContextUsage(usage, contextLimit) {
+    if (usage.window === undefined || !Number.isFinite(usage.window) || !Number.isFinite(contextLimit) || contextLimit <= 0)
+        return undefined;
+    const peak = usage.windowPeak !== undefined && Number.isFinite(usage.windowPeak) ? usage.windowPeak : usage.window;
+    const used = Math.max(0, usage.window, peak);
+    return `ctx ${formatTokens(used)}/${formatTokens(contextLimit)} (${Math.round((used / contextLimit) * 100)}%)`;
+}
+export function formatModelThinking(model, thinking) {
+    const parsed = model ? splitKnownThinkingSuffix(model) : undefined;
+    let displayModel = parsed?.baseModel ?? model;
+    const explicitThinking = THINKING_LEVELS.find((level) => level === thinking?.trim());
+    const displayThinking = parsed?.thinkingSuffix ? parsed.thinkingSuffix.slice(1) : explicitThinking;
+    if (displayModel) {
+        const slashIdx = displayModel.lastIndexOf("/");
+        if (slashIdx !== -1)
+            displayModel = displayModel.slice(slashIdx + 1);
+    }
+    return [displayModel, displayThinking ? `thinking ${displayThinking}` : undefined].filter(Boolean).join(" · ");
+}
+/**
+ * Format usage statistics into a compact string
+ */
+export function formatUsage(u, model) {
+    const parts = [];
+    if (u.turns)
+        parts.push(`${u.turns} turn${u.turns > 1 ? "s" : ""}`);
+    if (u.input)
+        parts.push(`in:${formatTokens(u.input)}`);
+    if (u.output)
+        parts.push(`out:${formatTokens(u.output)}`);
+    if (u.cacheRead)
+        parts.push(`R${formatTokens(u.cacheRead)}`);
+    if (u.cacheWrite)
+        parts.push(`W${formatTokens(u.cacheWrite)}`);
+    if (u.cost)
+        parts.push(`$${u.cost.toFixed(4)}`);
+    if (model)
+        parts.push(model);
+    return parts.join(" ");
+}
+/**
+ * Format duration in human-readable form
+ */
+export function formatDuration(ms) {
+    if (ms < 1000)
+        return `${ms}ms`;
+    if (ms < 60000)
+        return `${(ms / 1000).toFixed(1)}s`;
+    return `${Math.floor(ms / 60000)}m${Math.floor((ms % 60000) / 1000)}s`;
+}
+/**
+ * Build a summary string for a completed/failed chain
+ */
+export function buildChainSummary(steps, results, chainDir, status, failedStep) {
+    const stepNames = steps
+        .map((step) => (isParallelStep(step) ? `parallel[${step.parallel.length}]` : isDynamicParallelStep(step) ? `expand:${step.parallel.agent}` : step.agent))
+        .join(" → ");
+    const totalDuration = results.reduce((sum, r) => sum + (r.progress?.durationMs || 0), 0);
+    const durationStr = formatDuration(totalDuration);
+    const progressPath = path.join(chainDir, "progress.md");
+    const hasProgress = fs.existsSync(progressPath);
+    const allSkills = new Set();
+    for (const r of results) {
+        if (r.skills)
+            r.skills.forEach((s) => allSkills.add(s));
+    }
+    const skillsLine = allSkills.size > 0 ? `🔧 Skills: ${[...allSkills].join(", ")}` : "";
+    if (status === "completed") {
+        const stepWord = results.length === 1 ? "step" : "steps";
+        return `✅ Chain completed: ${stepNames} (${results.length} ${stepWord}, ${durationStr})${skillsLine ? `\n${skillsLine}` : ""}
+
+📋 Progress: ${hasProgress ? progressPath : "(none)"}
+📁 Artifacts: ${chainDir}`;
+    }
+    else {
+        const stepInfo = failedStep ? ` at step ${failedStep.index + 1}` : "";
+        const errorInfo = failedStep?.error ? `: ${failedStep.error}` : "";
+        return `❌ Chain failed${stepInfo}${errorInfo}${skillsLine ? `\n${skillsLine}` : ""}
+
+📋 Progress: ${hasProgress ? progressPath : "(none)"}
+📁 Artifacts: ${chainDir}`;
+    }
+}
+/**
+ * Format a tool call for display
+ */
+export function formatToolCall(name, args, expanded = false) {
+    switch (name) {
+        case "bash": {
+            const command = typeof args.command === "string" ? args.command : "";
+            return `$ ${previewDisplayText(command, expanded ? 240 : 60)}`;
+        }
+        case "read":
+        case "write":
+        case "edit": {
+            const target = typeof args.path === "string"
+                ? args.path
+                : typeof args.file_path === "string"
+                    ? args.file_path
+                    : "";
+            return `${name} ${sanitizeDisplayText(shortenPath(target))}`;
+        }
+        default: {
+            return `${name} ${previewDisplayText(JSON.stringify(args), expanded ? 160 : 40)}`;
+        }
+    }
+}
+/**
+ * Shorten a path by replacing home directory with ~
+ */
+export function shortenPath(p) {
+    const home = process.env.HOME;
+    if (home && p.startsWith(home)) {
+        return `~${p.slice(home.length)}`;
+    }
+    return p;
+}
+//# sourceMappingURL=formatters.js.map

package/src/shared/formatters.js.map

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

package/src/shared/jsonl-writer.d.ts

@@ -0,0 +1,21 @@
+export interface DrainableSource {
+    pause(): void;
+    resume(): void;
+}
+export interface JsonlWriteStream {
+    write(chunk: string): boolean;
+    once(event: "drain", listener: () => void): JsonlWriteStream;
+    on?(event: "error", listener: (error: Error) => void): JsonlWriteStream;
+    end(callback?: () => void): void;
+}
+interface JsonlWriterDeps {
+    createWriteStream?: (filePath: string) => JsonlWriteStream;
+    maxBytes?: number;
+}
+interface JsonlWriter {
+    writeLine(line: string): void;
+    close(): Promise<void>;
+}
+export declare function createJsonlWriter(filePath: string | undefined, source: DrainableSource, deps?: JsonlWriterDeps): JsonlWriter;
+export {};
+//# sourceMappingURL=jsonl-writer.d.ts.map

package/src/shared/jsonl-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl-writer.d.ts","sourceRoot":"","sources":["../../../src/shared/jsonl-writer.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC/B,KAAK,IAAI,IAAI,CAAC;IACd,MAAM,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAChC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9B,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,gBAAgB,CAAC;IAC7D,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,gBAAgB,CAAC;IACxE,GAAG,CAAC,QAAQ,CAAC,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;CACjC;AAID,UAAU,eAAe;IACxB,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,gBAAgB,CAAC;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,WAAW;IACpB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,wBAAgB,iBAAiB,CAChC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,MAAM,EAAE,eAAe,EACvB,IAAI,GAAE,eAAoB,GACxB,WAAW,CA6Db"}

package/src/shared/jsonl-writer.js

@@ -0,0 +1,68 @@
+import * as fs from "node:fs";
+const DEFAULT_MAX_JSONL_BYTES = 50 * 1024 * 1024;
+export function createJsonlWriter(filePath, source, deps = {}) {
+    if (!filePath) {
+        return {
+            writeLine() { },
+            async close() { },
+        };
+    }
+    const createWriteStream = deps.createWriteStream ?? ((targetPath) => fs.createWriteStream(targetPath, { flags: "a" }));
+    let stream;
+    try {
+        stream = createWriteStream(filePath);
+    }
+    catch {
+        return {
+            writeLine() { },
+            async close() { },
+        };
+    }
+    let backpressured = false;
+    let closed = false;
+    let bytesWritten = 0;
+    const maxBytes = deps.maxBytes ?? DEFAULT_MAX_JSONL_BYTES;
+    // The mirror is best effort: a stream that cannot open or write (for example
+    // because its directory was removed) must not surface as an uncaught error.
+    stream.on?.("error", () => {
+        closed = true;
+        stream = undefined;
+        if (backpressured) {
+            backpressured = false;
+            source.resume();
+        }
+    });
+    return {
+        writeLine(line) {
+            if (!stream || closed || !line.trim())
+                return;
+            const chunk = `${line}\n`;
+            const chunkBytes = Buffer.byteLength(chunk, "utf-8");
+            if (bytesWritten + chunkBytes > maxBytes)
+                return;
+            try {
+                const ok = stream.write(chunk);
+                bytesWritten += chunkBytes;
+                if (!ok && !backpressured) {
+                    backpressured = true;
+                    source.pause();
+                    stream.once("drain", () => {
+                        backpressured = false;
+                        if (!closed)
+                            source.resume();
+                    });
+                }
+            }
+            catch { }
+        },
+        async close() {
+            if (!stream || closed)
+                return;
+            closed = true;
+            const current = stream;
+            stream = undefined;
+            await new Promise((resolve) => current.end(() => resolve()));
+        },
+    };
+}
+//# sourceMappingURL=jsonl-writer.js.map

package/src/shared/jsonl-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl-writer.js","sourceRoot":"","sources":["../../../src/shared/jsonl-writer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAc9B,MAAM,uBAAuB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAYjD,MAAM,UAAU,iBAAiB,CAChC,QAA4B,EAC5B,MAAuB,EACvB,OAAwB,EAAE;IAE1B,IAAI,CAAC,QAAQ,EAAE,CAAC;QACf,OAAO;YACN,SAAS,KAAI,CAAC;YACd,KAAK,CAAC,KAAK,KAAI,CAAC;SAChB,CAAC;IACH,CAAC;IAED,MAAM,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,IAAI,CAAC,CAAC,UAAkB,EAAE,EAAE,CAAC,EAAE,CAAC,iBAAiB,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;IAC/H,IAAI,MAAoC,CAAC;IACzC,IAAI,CAAC;QACJ,MAAM,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACR,OAAO;YACN,SAAS,KAAI,CAAC;YACd,KAAK,CAAC,KAAK,KAAI,CAAC;SAChB,CAAC;IACH,CAAC;IAED,IAAI,aAAa,GAAG,KAAK,CAAC;IAC1B,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,uBAAuB,CAAC;IAC1D,6EAA6E;IAC7E,4EAA4E;IAC5E,MAAM,CAAC,EAAE,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;QACzB,MAAM,GAAG,IAAI,CAAC;QACd,MAAM,GAAG,SAAS,CAAC;QACnB,IAAI,aAAa,EAAE,CAAC;YACnB,aAAa,GAAG,KAAK,CAAC;YACtB,MAAM,CAAC,MAAM,EAAE,CAAC;QACjB,CAAC;IACF,CAAC,CAAC,CAAC;IAEH,OAAO;QACN,SAAS,CAAC,IAAY;YACrB,IAAI,CAAC,MAAM,IAAI,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;gBAAE,OAAO;YAC9C,MAAM,KAAK,GAAG,GAAG,IAAI,IAAI,CAAC;YAC1B,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YACrD,IAAI,YAAY,GAAG,UAAU,GAAG,QAAQ;gBAAE,OAAO;YACjD,IAAI,CAAC;gBACJ,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBAC/B,YAAY,IAAI,UAAU,CAAC;gBAC3B,IAAI,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC;oBAC3B,aAAa,GAAG,IAAI,CAAC;oBACrB,MAAM,CAAC,KAAK,EAAE,CAAC;oBACf,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;wBACzB,aAAa,GAAG,KAAK,CAAC;wBACtB,IAAI,CAAC,MAAM;4BAAE,MAAM,CAAC,MAAM,EAAE,CAAC;oBAC9B,CAAC,CAAC,CAAC;gBACJ,CAAC;YACF,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;QACX,CAAC;QACD,KAAK,CAAC,KAAK;YACV,IAAI,CAAC,MAAM,IAAI,MAAM;gBAAE,OAAO;YAC9B,MAAM,GAAG,IAAI,CAAC;YACd,MAAM,OAAO,GAAG,MAAM,CAAC;YACvB,MAAM,GAAG,SAAS,CAAC;YACnB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QACpE,CAAC;KACD,CAAC;AACH,CAAC"}

package/src/shared/launch-contract.d.ts

@@ -0,0 +1,64 @@
+import type { AgentConfig } from "../agents/agents.ts";
+import type { PiLaunchToolPlan } from "../runs/shared/child-tool-plan.ts";
+import type { ExtensionBindings } from "../runs/shared/extension-bindings.ts";
+export declare const AGENT_DEFINITION_PROJECTION_VERSION: 2;
+export declare const LAUNCH_BINDING_PROJECTION_VERSION: 2;
+export declare function stableJsonDigest(value: unknown): string;
+/** Public-safe, deterministic evidence for the parsed launch-affecting agent definition. */
+export declare function projectAgentDefinition(agent: AgentConfig): Record<string, unknown>;
+/** Digest of the parsed definition; a runtime overlay that already captured it wins over re-hashing the overlaid copy. */
+export declare function agentDefinitionDigest(agent: AgentConfig): string;
+export interface LaunchBindingInput {
+    definitionDigest: string;
+    /** Caller task; runtime acceptance/output task annotations are explicitly outside the preflight-known subset. */
+    task?: string;
+    model?: string;
+    fast?: boolean;
+    thinking?: string;
+    systemPrompt?: string | null;
+    systemPromptMode?: AgentConfig["systemPromptMode"];
+    inheritProjectContext: boolean;
+    inheritGlobalContext: boolean;
+    inheritSkills: boolean;
+    skills?: string[];
+    tools?: string[];
+    excludeTools?: string[];
+    extensions?: string[];
+    subagentOnlyExtensions?: string[];
+    mcpDirectTools?: string[];
+    outputPath?: string;
+    outputMode?: string;
+    structuredOutputSchema?: unknown;
+    extensionBindings?: ExtensionBindings;
+}
+/** Canonical projection of the resolved inputs handed to the child. */
+export declare function projectLaunchBinding(input: LaunchBindingInput): Record<string, unknown>;
+export declare function launchBindingDigest(input: LaunchBindingInput): string;
+type LaunchBindingPromptMode = Pick<LaunchBindingInput, "systemPromptMode" | "inheritProjectContext" | "inheritGlobalContext" | "inheritSkills">;
+/**
+ * Who the child is: the launched agent, or the identity a persisted step
+ * already captured when a runner recomputes the binding per model attempt.
+ */
+export type LaunchBindingIdentity = {
+    agent: AgentConfig;
+} | ({
+    definitionDigest: string;
+} & LaunchBindingPromptMode);
+export type LaunchBindingSource = LaunchBindingIdentity & Pick<LaunchBindingInput, "fast" | "thinking" | "skills" | "outputPath" | "outputMode" | "structuredOutputSchema" | "extensionBindings"> & {
+    task: string;
+    model?: string;
+    /** Effective child system prompt before runtime acceptance prose. */
+    systemPrompt: string;
+    toolPlan: Pick<PiLaunchToolPlan, "effectiveToolAllowlist" | "excludeTools" | "extensionArgs" | "effectiveMcpTools">;
+};
+export interface LaunchBinding {
+    definitionDigest: string;
+    launchContractDigest: string;
+}
+/**
+ * Assemble launch identity from resolved preflight or execution inputs.
+ * The stable projection omits undefined optional fields.
+ */
+export declare function resolveLaunchBinding(source: LaunchBindingSource): LaunchBinding;
+export {};
+//# sourceMappingURL=launch-contract.d.ts.map

package/src/shared/launch-contract.d.ts.map

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

package/src/shared/launch-contract.js

@@ -0,0 +1,141 @@
+import { createHash } from "node:crypto";
+import * as fs from "node:fs";
+export const AGENT_DEFINITION_PROJECTION_VERSION = 2;
+// v2: the Intercom bridge prompt and tools are part of the binding on every
+// path, and the bridge text no longer names the parent session.
+export const LAUNCH_BINDING_PROJECTION_VERSION = 2;
+function stableJson(value) {
+    if (Array.isArray(value))
+        return `[${value.map(stableJson).join(",")}]`;
+    if (value && typeof value === "object") {
+        return `{${Object.entries(value)
+            .filter(([, entry]) => entry !== undefined)
+            .sort(([a], [b]) => a.localeCompare(b))
+            .map(([key, entry]) => `${JSON.stringify(key)}:${stableJson(entry)}`)
+            .join(",")}}`;
+    }
+    return JSON.stringify(value);
+}
+export function stableJsonDigest(value) {
+    return createHash("sha256").update(stableJson(value)).digest("hex");
+}
+function fileDigest(filePath) {
+    try {
+        return createHash("sha256").update(fs.readFileSync(filePath)).digest("hex");
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Public-safe, deterministic evidence for the parsed launch-affecting agent definition. */
+export function projectAgentDefinition(agent) {
+    return {
+        version: AGENT_DEFINITION_PROJECTION_VERSION,
+        name: agent.name,
+        localName: agent.localName,
+        packageName: agent.packageName,
+        filePath: agent.filePath,
+        fileContentDigest: fileDigest(agent.filePath),
+        runner: agent.runner,
+        systemPrompt: agent.systemPrompt,
+        systemPromptMode: agent.systemPromptMode,
+        inheritProjectContext: agent.inheritProjectContext,
+        inheritGlobalContext: agent.inheritGlobalContext,
+        inheritSkills: agent.inheritSkills,
+        model: agent.model,
+        modelProvider: agent.modelProvider,
+        fast: agent.fast,
+        thinking: agent.thinking,
+        tools: agent.tools,
+        excludeTools: agent.excludeTools,
+        allowNestedSubagents: agent.allowNestedSubagents,
+        allowedAgents: agent.allowedAgents,
+        mcpDirectTools: agent.mcpDirectTools,
+        extensions: agent.extensions,
+        subagentOnlyExtensions: agent.subagentOnlyExtensions,
+        mutationTools: agent.mutationTools,
+        skills: agent.skills,
+        skillPath: agent.skillPath,
+        output: agent.output,
+        outputSchema: agent.outputSchema,
+        defaultReads: agent.defaultReads,
+        defaultProgress: agent.defaultProgress,
+        defaultContext: agent.defaultContext,
+        defaultAsync: agent.defaultAsync,
+        defaultTimeoutMs: agent.defaultTimeoutMs,
+        defaultAcceptance: agent.defaultAcceptance,
+        acceptanceRole: agent.acceptanceRole,
+        interactive: agent.interactive,
+        maxSubagentDepth: agent.maxSubagentDepth,
+        completionGuard: agent.completionGuard,
+        toolBudget: agent.toolBudget,
+        memory: agent.memory,
+    };
+}
+/** Digest of the parsed definition; a runtime overlay that already captured it wins over re-hashing the overlaid copy. */
+export function agentDefinitionDigest(agent) {
+    return agent.definitionDigest ?? stableJsonDigest(projectAgentDefinition(agent));
+}
+/** Canonical projection of the resolved inputs handed to the child. */
+export function projectLaunchBinding(input) {
+    return {
+        version: LAUNCH_BINDING_PROJECTION_VERSION,
+        definitionDigest: input.definitionDigest,
+        taskDigest: input.task === undefined ? undefined : stableJsonDigest(input.task),
+        model: input.model,
+        fast: input.fast,
+        thinking: input.thinking,
+        systemPromptDigest: input.systemPrompt === undefined || input.systemPrompt === null ? undefined : stableJsonDigest(input.systemPrompt),
+        systemPromptMode: input.systemPromptMode,
+        inheritProjectContext: input.inheritProjectContext,
+        inheritGlobalContext: input.inheritGlobalContext,
+        inheritSkills: input.inheritSkills,
+        skills: input.skills,
+        tools: input.tools,
+        excludeTools: input.excludeTools,
+        extensions: input.extensions,
+        subagentOnlyExtensions: input.subagentOnlyExtensions,
+        mcpDirectTools: input.mcpDirectTools,
+        outputPath: input.outputPath,
+        outputMode: input.outputMode,
+        structuredOutputSchema: input.structuredOutputSchema,
+        extensionBindings: input.extensionBindings,
+    };
+}
+export function launchBindingDigest(input) {
+    return stableJsonDigest(projectLaunchBinding(input));
+}
+/**
+ * Assemble launch identity from resolved preflight or execution inputs.
+ * The stable projection omits undefined optional fields.
+ */
+export function resolveLaunchBinding(source) {
+    const identity = "agent" in source ? {
+        definitionDigest: agentDefinitionDigest(source.agent),
+        systemPromptMode: source.agent.systemPromptMode,
+        inheritProjectContext: source.agent.inheritProjectContext,
+        inheritGlobalContext: source.agent.inheritGlobalContext,
+        inheritSkills: source.agent.inheritSkills,
+    } : source;
+    return {
+        definitionDigest: identity.definitionDigest,
+        launchContractDigest: launchBindingDigest({
+            ...identity,
+            task: source.task,
+            model: source.model,
+            fast: source.fast,
+            thinking: source.thinking || undefined,
+            systemPrompt: source.systemPrompt,
+            skills: source.skills,
+            tools: source.toolPlan.effectiveToolAllowlist,
+            excludeTools: source.toolPlan.excludeTools.length > 0 ? source.toolPlan.excludeTools : undefined,
+            extensions: source.toolPlan.extensionArgs,
+            mcpDirectTools: source.toolPlan.effectiveMcpTools,
+            outputPath: source.outputPath || undefined,
+            outputMode: source.outputMode,
+            structuredOutputSchema: source.structuredOutputSchema,
+            extensionBindings: source.extensionBindings || undefined,
+        }),
+    };
+}
+//# sourceMappingURL=launch-contract.js.map

package/src/shared/launch-contract.js.map

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

package/src/shared/model-info.d.ts

@@ -0,0 +1,44 @@
+import type { ModelCost } from "@earendil-works/pi-ai";
+export declare const THINKING_LEVELS: readonly ["off", "minimal", "low", "medium", "high", "xhigh", "max"];
+export type ThinkingLevel = typeof THINKING_LEVELS[number];
+export type ThinkingLevelMap = Partial<Record<ThinkingLevel, string | null>>;
+export interface ModelInfo {
+    provider: string;
+    id: string;
+    fullId: string;
+    api?: string;
+    reasoning?: boolean;
+    thinkingLevelMap?: ThinkingLevelMap;
+    /** Context window in tokens, when the host model registry reports one. */
+    contextWindow?: number;
+    /** Maximum output tokens, when the host model registry reports one. */
+    maxTokens?: number;
+    /** Input modalities reported by the registry, e.g. ["text", "image"]. */
+    input?: string[];
+    /** Per-token pricing from the registry (USD per 1M tokens). */
+    cost?: ModelCost;
+}
+interface RegistryModelLike {
+    provider: string;
+    id: string;
+    api?: string;
+    reasoning?: boolean;
+    thinkingLevelMap?: ThinkingLevelMap;
+    contextWindow?: number;
+    maxTokens?: number;
+    input?: string[];
+    cost?: ModelCost;
+}
+export declare function toModelInfo(model: RegistryModelLike): ModelInfo;
+/** Resolve the effective thinking level from a model string (which may contain a known suffix like `:high`)
+ * and an explicit thinking config value. Returns `undefined` when no thinking is applicable
+ * (e.g. no model was specified, or the model has no suffix and no config was provided). */
+export declare function resolveEffectiveThinking(model: string | undefined, configThinking: string | false | undefined): string | undefined;
+export declare function splitKnownThinkingSuffix(model: string): {
+    baseModel: string;
+    thinkingSuffix: string;
+};
+export declare function findModelInfo(model: string | undefined, availableModels: ModelInfo[] | undefined, preferredProvider?: string): ModelInfo | undefined;
+export declare function getSupportedThinkingLevels(model: ModelInfo | undefined): ThinkingLevel[];
+export {};
+//# sourceMappingURL=model-info.d.ts.map

package/src/shared/model-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-info.d.ts","sourceRoot":"","sources":["../../../src/shared/model-info.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,eAAO,MAAM,eAAe,sEAAuE,CAAC;AACpG,MAAM,MAAM,aAAa,GAAG,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC;AAC3D,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;AAE7E,MAAM,WAAW,SAAS;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,0EAA0E;IAC1E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,+DAA+D;IAC/D,IAAI,CAAC,EAAE,SAAS,CAAC;CACjB;AAED,UAAU,iBAAiB;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,CAAC,EAAE,SAAS,CAAC;CACjB;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,iBAAiB,GAAG,SAAS,CAe/D;AAED;;2FAE2F;AAC3F,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,cAAc,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAKlI;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CASrG;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,eAAe,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAYpJ;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,aAAa,EAAE,CAaxF"}