pi-agent-flow 1.8.1 → 1.8.3

package/dist/snapshot.js

@@ -0,0 +1,199 @@
+/**
+ * Session snapshot building, sanitization, and flow result compression.
+ *
+ * Extracted from index.ts for single-responsibility and testability.
+ */
+import { stripReasoningFromAssistantMessage } from "./reasoning-strip.js";
+import { stripSlidingPromptFromContent, contentContainsSlidingTag, isJsonEqual, } from "./sliding-prompt.js";
+// ---------------------------------------------------------------------------
+// Session snapshot serialization
+// ---------------------------------------------------------------------------
+export function buildForkSessionSnapshotJsonl(sessionManager) {
+    const header = sessionManager.getHeader();
+    if (!header || typeof header !== "object")
+        return null;
+    const branchEntries = sessionManager.getBranch();
+    const lines = [JSON.stringify(header)];
+    for (const entry of branchEntries)
+        lines.push(JSON.stringify(entry));
+    return `${lines.join("\n")}\n`;
+}
+// ---------------------------------------------------------------------------
+// Flow result compression
+// ---------------------------------------------------------------------------
+/**
+ * Render a compressed flow result as compact text for child context.
+ */
+export function renderCompressedFlowResult(r) {
+    const parts = [`[Flow: ${r.type} ${r.status}]`];
+    if (r.files?.length) {
+        const fileLines = r.files.map((f) => {
+            const role = f.role ? ` (${f.role})` : "";
+            const desc = f.description ? ` — ${f.description}` : "";
+            return `  ${f.path}${role}${desc}`;
+        });
+        parts.push(`Files:\n${fileLines.join("\n")}`);
+    }
+    if (r.commands?.length) {
+        const cmdLines = r.commands.map((c) => `  ${c.tool ?? "cmd"}: ${c.command}`);
+        parts.push(`Commands:\n${cmdLines.join("\n")}`);
+    }
+    if (r.error)
+        parts.push(`Error: ${r.error}`);
+    return parts.join("\n");
+}
+/**
+ * Compress flow tool results in a sanitized session snapshot.
+ *
+ * Scans for tool result messages that correspond to flow invocations
+ * and replaces their content with compact compressed output.
+ */
+export function compressFlowToolResults(snapshot, cache) {
+    if (cache.size === 0)
+        return snapshot;
+    const lines = snapshot.trimEnd().split("\n");
+    const result = [];
+    // First pass: map toolCallId → tool name from assistant messages
+    const toolCallIdToName = new Map();
+    for (const line of lines) {
+        let entry;
+        try {
+            entry = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        if (entry?.type !== "message" || entry.message?.role !== "assistant")
+            continue;
+        const content = entry.message.content;
+        if (!Array.isArray(content))
+            continue;
+        for (const part of content) {
+            if (part.type === "toolCall" && part.toolCallId && part.name) {
+                toolCallIdToName.set(part.toolCallId, part.name);
+            }
+        }
+    }
+    // Second pass: compress flow tool results
+    for (const line of lines) {
+        let entry;
+        try {
+            entry = JSON.parse(line);
+        }
+        catch {
+            result.push(line);
+            continue;
+        }
+        if (entry?.type !== "message" || entry.message?.role !== "tool") {
+            result.push(line);
+            continue;
+        }
+        // Extract toolCallId — either from message-level or content-level toolResult
+        let toolCallId;
+        if (typeof entry.message.toolCallId === "string") {
+            toolCallId = entry.message.toolCallId;
+        }
+        else if (Array.isArray(entry.message.content)) {
+            for (const part of entry.message.content) {
+                if (part.type === "toolResult" && part.toolCallId) {
+                    toolCallId = part.toolCallId;
+                    break;
+                }
+            }
+        }
+        if (!toolCallId) {
+            result.push(line);
+            continue;
+        }
+        const toolName = toolCallIdToName.get(toolCallId);
+        if (toolName !== "flow") {
+            result.push(line);
+            continue;
+        }
+        const compressed = cache.get(toolCallId);
+        if (!compressed || compressed.length === 0) {
+            result.push(line);
+            continue;
+        }
+        const rendered = compressed.map(renderCompressedFlowResult).join("\n\n");
+        // Replace content in the tool result message
+        if (typeof entry.message.toolCallId === "string") {
+            // Format 1: toolCallId at message level, content is text array
+            entry = {
+                ...entry,
+                message: {
+                    ...entry.message,
+                    content: [{ type: "text", text: rendered }],
+                },
+            };
+        }
+        else {
+            // Format 2: toolCallId inside content array
+            entry = {
+                ...entry,
+                message: {
+                    ...entry.message,
+                    content: entry.message.content.map((part) => part.type === "toolResult" && part.toolCallId === toolCallId
+                        ? { ...part, content: rendered }
+                        : part),
+                },
+            };
+        }
+        result.push(JSON.stringify(entry));
+    }
+    return `${result.join("\n")}\n`;
+}
+/**
+ * Sanitize a fork session snapshot JSONL to remove only non-inheritable
+ * artifacts before passing full parent context to child flows: sliding system
+ * prompts, legacy reminders, and assistant reasoning/thinking.
+ */
+export function sanitizeForkSnapshot(snapshot, cache = new Map()) {
+    if (!snapshot)
+        return snapshot;
+    const lines = snapshot.trimEnd().split("\n");
+    const sanitizedLines = [];
+    for (const line of lines) {
+        let entry;
+        try {
+            entry = JSON.parse(line);
+        }
+        catch {
+            sanitizedLines.push(line);
+            continue;
+        }
+        let changed = false;
+        // Drop sliding system prompt messages entirely.
+        if (entry?.type === "message" &&
+            entry.message?.role === "system" &&
+            contentContainsSlidingTag(entry.message?.content)) {
+            continue;
+        }
+        if (entry?.type === "message" && entry.message) {
+            let message = entry.message;
+            if (message.role === "assistant") {
+                const stripped = stripReasoningFromAssistantMessage(message);
+                message = stripped.message;
+                changed ||= stripped.changed;
+            }
+            if ("content" in message) {
+                const originalContent = message.content;
+                const strippedContent = stripSlidingPromptFromContent(originalContent);
+                if (!isJsonEqual(strippedContent, originalContent)) {
+                    message = {
+                        ...message,
+                        content: strippedContent,
+                    };
+                    changed = true;
+                }
+            }
+            if (changed) {
+                entry = { ...entry, message };
+            }
+        }
+        sanitizedLines.push(changed ? JSON.stringify(entry) : line);
+    }
+    const sanitized = `${sanitizedLines.join("\n")}\n`;
+    return compressFlowToolResults(sanitized, cache);
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/snapshot.js.map

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

package/dist/structured-output.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Structured JSON output extraction from flow responses.
+ *
+ * Parses a JSON code block from the end of the flow's final assistant text
+ * and validates it against the FlowStructuredOutput schema.
+ */
+import type { Message } from "@mariozechner/pi-ai";
+import type { CommandEntry, FlowStructuredOutput } from "./types.js";
+/**
+ * Extract a structured JSON output block from the end of an assistant's text.
+ *
+ * Looks for a final ```json ... ``` code block, parses it, and validates
+ * against the FlowStructuredOutput schema. Returns undefined when the block
+ * is missing, malformed, or fails validation.
+ */
+export declare function extractStructuredOutput(text: string): FlowStructuredOutput | undefined;
+/**
+ * Walk the message history and mechanically generate a commands array
+ * from all bash tool calls (standalone, batch-nested, and batch_bash_poll).
+ *
+ * This replaces the old enrichStructuredOutputCommands approach which relied
+ * on the LLM generating a paraphrased commands array that was then replaced
+ * with verbatim versions. Now commands are generated purely from tool call
+ * history — no LLM involvement required.
+ *
+ * Deduplication strategy:
+ * - Batch-nested bash ops that completed within the batch call are emitted
+ *   immediately with their timing.
+ * - Batch-nested bash ops that were still pending when the batch returned
+ *   (no timing available) are deferred to batch_bash_poll.
+ * - batch_bash_poll only emits entries for IDs that were deferred AND have
+ *   completed (with timing). Still-pending poll results are skipped.
+ * - Once an ID is emitted (from batch or poll), subsequent encounters skip it.
+ */
+export declare function generateCommandsFromHistory(messages: Message[]): CommandEntry[];
+//# sourceMappingURL=structured-output.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"structured-output.d.ts","sourceRoot":"","sources":["../src/structured-output.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAU,YAAY,EAAa,oBAAoB,EAAe,MAAM,YAAY,CAAC;AA8CrG;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,CAoCtF;AAyCD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,YAAY,EAAE,CAuH/E"}

package/dist/structured-output.js

@@ -0,0 +1,244 @@
+/**
+ * Structured JSON output extraction from flow responses.
+ *
+ * Parses a JSON code block from the end of the flow's final assistant text
+ * and validates it against the FlowStructuredOutput schema.
+ */
+const VALID_STATUSES = ["complete", "partial", "blocked", "failed"];
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isOptionalArray(record, key) {
+    return record[key] === undefined || Array.isArray(record[key]);
+}
+/** Minimum required fields to consider parsed JSON a valid structured output. */
+function isValidStructuredOutput(obj) {
+    if (!isRecord(obj))
+        return false;
+    return (typeof obj.version === "string" &&
+        typeof obj.status === "string" &&
+        VALID_STATUSES.includes(obj.status) &&
+        typeof obj.summary === "string" &&
+        isOptionalArray(obj, "files") &&
+        isOptionalArray(obj, "actions") &&
+        isOptionalArray(obj, "commands") &&
+        isOptionalArray(obj, "notDone") &&
+        isOptionalArray(obj, "nextSteps") &&
+        isOptionalArray(obj, "reasoning") &&
+        isOptionalArray(obj, "notes"));
+}
+/**
+ * Extract a structured JSON output block from the end of an assistant's text.
+ *
+ * Looks for a final ```json ... ``` code block, parses it, and validates
+ * against the FlowStructuredOutput schema. Returns undefined when the block
+ * is missing, malformed, or fails validation.
+ */
+export function extractStructuredOutput(text) {
+    if (!text)
+        return undefined;
+    // Find the last ```json ... ``` block in the text.
+    // Scan backward from the end to handle multiple blocks.
+    const allMatches = [...text.matchAll(/```json\s*([\s\S]*?)\s*```/g)];
+    const match = allMatches.length > 0 ? allMatches[allMatches.length - 1] : null;
+    if (!match || !match[1])
+        return undefined;
+    const jsonStr = match[1].trim();
+    if (!jsonStr)
+        return undefined;
+    let parsed;
+    try {
+        parsed = JSON.parse(jsonStr);
+    }
+    catch {
+        return undefined;
+    }
+    if (!isValidStructuredOutput(parsed))
+        return undefined;
+    // Sanitize: trim string fields and normalize omitted arrays to [] for
+    // backward compatibility with earlier structured-output prompts.
+    return {
+        version: parsed.version.trim(),
+        status: parsed.status,
+        summary: parsed.summary.trim(),
+        files: parsed.files ?? [],
+        actions: parsed.actions ?? [],
+        commands: parsed.commands ?? [],
+        notDone: parsed.notDone ?? [],
+        nextSteps: parsed.nextSteps ?? [],
+        reasoning: parsed.reasoning ?? [],
+        notes: parsed.notes ?? [],
+        ...(parsed.extensions !== undefined ? { extensions: parsed.extensions } : {}),
+    };
+}
+// ---------------------------------------------------------------------------
+// Mechanical command generation from tool call history
+// ---------------------------------------------------------------------------
+/**
+ * Extract [Execution time: ...] markers keyed by bash-op-ID from batch
+ * result text. Uses the `--- bash [ID]` delimiter to split sections.
+ * Pending sections (no timing marker) are not included in the result.
+ */
+function extractBatchTimingsById(text) {
+    const result = new Map();
+    const sections = text.split(/^--- bash \[([^\]]+)\]/m);
+    // sections: [preamble, id1, body1, id2, body2, ...]
+    for (let i = 1; i < sections.length - 1; i += 2) {
+        const id = sections[i].trim();
+        const body = sections[i + 1] || "";
+        const match = body.match(/\[Execution time: ([^\]]+)\]/);
+        if (match)
+            result.set(id, match[1]);
+    }
+    return result;
+}
+/**
+ * Extract [Execution time: ...] markers keyed by bash-op-ID from poll
+ * result text. Uses the `--- [ID]` delimiter to split sections.
+ */
+function extractPollTimingsById(text) {
+    const result = new Map();
+    const sections = text.split(/^--- \[([^\]]+)\]/m);
+    // sections: [preamble, id1, body1, id2, body2, ...]
+    for (let i = 1; i < sections.length - 1; i += 2) {
+        const id = sections[i].trim();
+        const body = sections[i + 1] || "";
+        const match = body.match(/\[Execution time: ([^\]]+)\]/);
+        if (match)
+            result.set(id, match[1]);
+    }
+    return result;
+}
+/**
+ * Walk the message history and mechanically generate a commands array
+ * from all bash tool calls (standalone, batch-nested, and batch_bash_poll).
+ *
+ * This replaces the old enrichStructuredOutputCommands approach which relied
+ * on the LLM generating a paraphrased commands array that was then replaced
+ * with verbatim versions. Now commands are generated purely from tool call
+ * history — no LLM involvement required.
+ *
+ * Deduplication strategy:
+ * - Batch-nested bash ops that completed within the batch call are emitted
+ *   immediately with their timing.
+ * - Batch-nested bash ops that were still pending when the batch returned
+ *   (no timing available) are deferred to batch_bash_poll.
+ * - batch_bash_poll only emits entries for IDs that were deferred AND have
+ *   completed (with timing). Still-pending poll results are skipped.
+ * - Once an ID is emitted (from batch or poll), subsequent encounters skip it.
+ */
+export function generateCommandsFromHistory(messages) {
+    const commands = [];
+    // ── Phase 1: Build lookup maps ──
+    // Map toolCallId → concatenated text from tool result messages
+    const toolResultTexts = new Map();
+    for (const msg of messages) {
+        if (msg.role !== "tool" || !Array.isArray(msg.content))
+            continue;
+        const id = msg.toolCallId ||
+            msg.tool_call_id ||
+            "";
+        if (!id)
+            continue;
+        const text = msg.content
+            .filter((c) => c.type === "text" && typeof c.text === "string")
+            .map((c) => c.text)
+            .join("");
+        toolResultTexts.set(id, text);
+    }
+    // Map toolCallId → execution time (from [Execution time: ...] markers)
+    const timingMap = new Map();
+    for (const [id, text] of toolResultTexts) {
+        const match = text.match(/\[Execution time: ([^\]]+)\]/);
+        if (match)
+            timingMap.set(id, match[1]);
+    }
+    // Map bash-op-ID → command string (from all batch calls, for poll lookback)
+    const bashIdToCommand = new Map();
+    // Track which bash-op IDs have already been emitted (with timing).
+    // Prevents duplicates from poll calls.
+    const emittedBashIds = new Set();
+    // ── Phase 2: Walk tool calls ──
+    for (const msg of messages) {
+        if (msg.role !== "assistant" || !Array.isArray(msg.content))
+            continue;
+        for (const part of msg.content) {
+            if (part.type !== "toolCall")
+                continue;
+            const name = part.name || part.toolName || "";
+            const args = part.arguments || part.input || {};
+            const toolCallId = part.toolCallId || part.tool_call_id || "";
+            switch (name) {
+                case "bash": {
+                    const cmd = args.command || "";
+                    if (cmd) {
+                        commands.push({
+                            command: cmd,
+                            tool: "bash",
+                            ...(timingMap.has(toolCallId) ? { executionTime: timingMap.get(toolCallId) } : {}),
+                        });
+                    }
+                    break;
+                }
+                case "batch": {
+                    const ops = Array.isArray(args.o)
+                        ? args.o
+                        : Array.isArray(args.op)
+                            ? args.op
+                            : Array.isArray(args.operations)
+                                ? args.operations
+                                : [];
+                    const resultText = toolResultTexts.get(toolCallId) || "";
+                    const batchTimings = extractBatchTimingsById(resultText);
+                    for (const op of ops) {
+                        if (!op)
+                            continue;
+                        const opType = (op.o ?? op.op);
+                        if (opType === "bash" && op.command) {
+                            const id = (op.i ?? op.id);
+                            if (id)
+                                bashIdToCommand.set(id, op.command);
+                            const timing = id ? batchTimings.get(id) : undefined;
+                            if (timing) {
+                                // Completed within batch — emit immediately with timing
+                                commands.push({
+                                    command: op.command,
+                                    tool: "bash",
+                                    executionTime: timing,
+                                });
+                                if (id)
+                                    emittedBashIds.add(id);
+                            }
+                            // Pending ops (no timing) are deferred to batch_bash_poll
+                        }
+                    }
+                    break;
+                }
+                case "batch_bash_poll": {
+                    const ids = Array.isArray(args.i) ? args.i : [];
+                    const resultText = toolResultTexts.get(toolCallId) || "";
+                    const pollTimings = extractPollTimingsById(resultText);
+                    for (const id of ids) {
+                        if (emittedBashIds.has(id))
+                            continue; // already emitted
+                        const command = bashIdToCommand.get(id);
+                        if (!command)
+                            continue; // unknown ID — skip
+                        const timing = pollTimings.get(id);
+                        if (!timing)
+                            continue; // still pending — skip, defer to next poll
+                        commands.push({
+                            command,
+                            tool: "bash",
+                            executionTime: timing,
+                        });
+                        emittedBashIds.add(id);
+                    }
+                    break;
+                }
+            }
+        }
+    }
+    return commands;
+}
+//# sourceMappingURL=structured-output.js.map

package/dist/structured-output.js.map

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

package/dist/timed-bash.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Timed Bash Tool Wrapper
+ *
+ * Wraps the built-in bash tool to append execution-time classification
+ * to every result. This gives the LLM concrete feedback to self-correct
+ * strategy (e.g. switch from bash grep to grep tool, batch commands, etc.).
+ *
+ * Child flows also receive a hard deadline from the parent runner. When a
+ * bash command is still running near that deadline, this wrapper aborts just
+ * the bash tool and returns an explicit instruction to stop using tools and
+ * summarize. That preserves the child agent process long enough to produce
+ * its final structured report instead of being killed while a shell command is
+ * still active.
+ */
+export type TimingTier = "normal" | "avg" | "long" | "extreme_long" | "very_long";
+export interface TimingReport {
+    tier: TimingTier;
+    seconds: number;
+    label: string;
+}
+/** Classify duration into user-defined tiers with actionable feedback. */
+export declare function classifyDuration(ms: number): TimingReport;
+/** Format the timing appendix that gets appended to bash output. */
+export declare function formatTimingAppendix(report: TimingReport): string;
+/**
+ * Read any pending reminder from the reminder file set by the parent runner.
+ * Returns the reminder text (without trailing newline), or null if no reminder exists.
+ * Clears the file after reading so the agent only sees each reminder once.
+ */
+export declare function readAndClearReminderFile(): string | null;
+/**
+ * Create a timed bash tool definition that wraps the built-in one.
+ * Extensions override built-in tools by name, so this replaces the
+ * default `bash` tool transparently.
+ *
+ * Returns `null` if the underlying `createBashToolDefinition` is not
+ * available (e.g. test environment or incompatible CLI version).
+ */
+export declare function createTimedBashToolDefinition(cwd: string, options?: {
+    shellPath?: string;
+    commandPrefix?: string;
+    operations?: any;
+    spawnHook?: any;
+}): any;
+//# sourceMappingURL=timed-bash.d.ts.map

package/dist/timed-bash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timed-bash.d.ts","sourceRoot":"","sources":["../src/timed-bash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,MAAM,MAAM,UAAU,GACnB,QAAQ,GACR,KAAK,GACL,MAAM,GACN,cAAc,GACd,WAAW,CAAC;AAEf,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACd;AAOD,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,CA2BzD;AAED,oEAAoE;AACpE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAEjE;AA2BD;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,GAAG,IAAI,CAYxD;AA2DD;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAC5C,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;IACT,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,GAAG,CAAC;IACjB,SAAS,CAAC,EAAE,GAAG,CAAC;CAChB,GACC,GAAG,CA4EL"}