@duetso/agent 0.1.34 → 0.1.36

package/dist/src/tui/history.js

@@ -0,0 +1,132 @@
+import { formatCompactJson } from "../lib/compact-json.js";
+/**
+ * Convert a persisted agent transcript into transcript-ready blocks.
+ *
+ * Tool calls and their tool results are stitched back together by id so the
+ * resumed view matches what the live runner renders during a turn — running
+ * spinner first, then `✓`/`✗` plus result body once the result arrives.
+ */
+export function historyDisplayBlocks(history) {
+    const blocks = [];
+    const activeToolBlockIndexes = new Map();
+    for (const message of history) {
+        if (!("role" in message))
+            continue;
+        if (message.role === "user") {
+            const text = userMessageText(message.content);
+            if (text)
+                blocks.push({ kind: "user", content: `you:\n${text}` });
+        }
+        else if (message.role === "assistant") {
+            for (const block of message.content) {
+                if (block.type === "text") {
+                    blocks.push({ kind: "agent", content: block.text });
+                }
+                else if (block.type === "thinking") {
+                    const trimmed = block.thinking.trim();
+                    if (trimmed)
+                        blocks.push({ kind: "reasoning", content: `[reasoning]\n${trimmed}` });
+                }
+                else if (block.type === "toolCall") {
+                    const input = block.arguments === undefined ? "" : `\n${formatCompactJson(block.arguments)}`;
+                    activeToolBlockIndexes.set(block.id, blocks.length);
+                    blocks.push({ kind: "tool", content: `[tool ${block.name}] ⏳${input}` });
+                }
+            }
+            if (message.errorMessage) {
+                blocks.push({ kind: "error", content: `[error]\n${message.errorMessage}` });
+            }
+        }
+        else if (message.role === "toolResult") {
+            const text = textFromHistoryContent(message.content);
+            const existingIndex = activeToolBlockIndexes.get(message.toolCallId);
+            const marker = message.isError ? "✗" : "✓";
+            const label = message.isError ? "[error]" : "[result]";
+            if (existingIndex !== undefined) {
+                const existing = blocks[existingIndex];
+                const [, ...inputLines] = existing.content.split("\n");
+                const input = inputLines.length > 0 ? `\n${inputLines.join("\n")}` : "";
+                existing.kind = message.isError ? "error" : "tool";
+                existing.content = text
+                    ? `[tool ${message.toolName}] ${marker}${input}\n${label}\n${text}`
+                    : `[tool ${message.toolName}] ${marker}${input}`;
+                activeToolBlockIndexes.delete(message.toolCallId);
+            }
+            else {
+                const content = text
+                    ? `[tool ${message.toolName}] ${marker}\n${label}\n${text}`
+                    : `[tool ${message.toolName}] ${marker}`;
+                blocks.push({ kind: message.isError ? "error" : "tool", content });
+            }
+        }
+    }
+    return blocks;
+}
+/** Compose the duet startup banner for the TUI header. */
+export function startupHeaderLines(input) {
+    const lines = [
+        `[duet] v${input.packageVersion}`,
+        `[cwd] ${input.workDir}`,
+        `[session] ${input.sessionId}`,
+        input.modelSource
+            ? `[model] ${input.modelName} — ${input.modelSource}`
+            : `[model] ${input.modelName}`,
+        input.memoryModelSource
+            ? `[memory model] ${input.memoryModelName} — ${input.memoryModelSource}`
+            : `[memory model] ${input.memoryModelName}`,
+    ];
+    if (input.newVersionNotice)
+        lines.push(input.newVersionNotice);
+    return lines;
+}
+/**
+ * Trim a sequence of display blocks to fit `maxLines` total rendered lines.
+ *
+ * Walks back-to-front so the most recent context is kept; when the budget
+ * lands mid-block, the trailing portion of that block is preserved and the
+ * dropped line count is reported so the caller can render a "showing last N"
+ * notice.
+ */
+export function limitHistoryDisplayBlocks(blocks, maxLines) {
+    if (maxLines <= 0)
+        return { blocks: [], omittedLines: countHistoryLines(blocks) };
+    const selected = [];
+    let remaining = maxLines;
+    let omittedLines = 0;
+    for (let index = blocks.length - 1; index >= 0; index--) {
+        const block = blocks[index];
+        const lines = block.content.split("\n");
+        if (lines.length <= remaining) {
+            selected.unshift(block);
+            remaining -= lines.length;
+            continue;
+        }
+        if (remaining > 0) {
+            selected.unshift({ ...block, content: lines.slice(-remaining).join("\n") });
+            omittedLines += lines.length - remaining;
+            remaining = 0;
+        }
+        else {
+            omittedLines += lines.length;
+        }
+    }
+    return { blocks: selected, omittedLines };
+}
+function countHistoryLines(blocks) {
+    return blocks.reduce((count, block) => count + block.content.split("\n").length, 0);
+}
+function userMessageText(content) {
+    if (typeof content === "string")
+        return content;
+    return content
+        .filter((block) => block.type === "text" && typeof block.text === "string")
+        .map((block) => block.text)
+        .join("");
+}
+function textFromHistoryContent(content) {
+    return content
+        .filter((block) => block.type === "text")
+        .map((block) => block.text)
+        .join("\n");
+}
+//# sourceMappingURL=history.js.map

package/dist/src/tui/history.js.map

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

package/dist/src/tui/sidebar.d.ts

@@ -0,0 +1,20 @@
+import { BoxRenderable, type CliRenderer } from "@opentui/core";
+import type { TurnContextUsageEvent, TurnTodo } from "../types/protocol.js";
+import type { StateMachineSession } from "../types/state-machine.js";
+/**
+ * Right-hand sidebar that surfaces the runner's todos, active state machine,
+ * and most recent context-window usage. Three stacked panels share the same
+ * width and bordering so the column has a consistent visual rhythm.
+ */
+export interface Sidebar {
+    /** Outer container; caller adds this to the root row. */
+    readonly view: BoxRenderable;
+    /** Replace the rendered todo list with the runner's current todos. */
+    setTodos(todos: readonly TurnTodo[]): void;
+    /** Mirror the active state-machine pipeline; pass undefined to clear. */
+    setStateMachine(session: StateMachineSession | undefined): void;
+    /** Render the latest context-usage progress bar; pass undefined to clear. */
+    setContextUsage(usage: TurnContextUsageEvent | undefined): void;
+}
+export declare function createSidebar(renderer: CliRenderer): Sidebar;
+//# sourceMappingURL=sidebar.d.ts.map

package/dist/src/tui/sidebar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidebar.d.ts","sourceRoot":"","sources":["../../../src/tui/sidebar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,KAAK,WAAW,EAAkB,MAAM,eAAe,CAAC;AAChF,OAAO,KAAK,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAGrE;;;;GAIG;AACH,MAAM,WAAW,OAAO;IACtB,yDAAyD;IACzD,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,sEAAsE;IACtE,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,GAAG,IAAI,CAAC;IAC3C,yEAAyE;IACzE,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,SAAS,GAAG,IAAI,CAAC;IAChE,6EAA6E;IAC7E,eAAe,CAAC,KAAK,EAAE,qBAAqB,GAAG,SAAS,GAAG,IAAI,CAAC;CACjE;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO,CAoE5D"}

package/dist/src/tui/sidebar.js

@@ -0,0 +1,118 @@
+import { BoxRenderable, TextRenderable } from "@opentui/core";
+import { COLORS } from "./theme.js";
+export function createSidebar(renderer) {
+    // Fixed width keeps the sidebar legible on narrow terminals without
+    // squashing the transcript. The three panels stack vertically inside.
+    const view = new BoxRenderable(renderer, {
+        flexDirection: "column",
+        width: 36,
+        height: "100%",
+        flexShrink: 0,
+    });
+    const { panel: todoPanel, body: todoBody } = createPanel(renderer, "todos", "(none)");
+    const { panel: smPanel, body: smBody } = createPanel(renderer, "state machine", "(inactive)");
+    const { panel: contextPanel, body: contextBody } = createPanel(renderer, "context", "(waiting for usage)", { fixedHeight: 5, grow: false });
+    view.add(todoPanel);
+    view.add(smPanel);
+    view.add(contextPanel);
+    return {
+        view,
+        setTodos(todos) {
+            if (todos.length === 0) {
+                todoBody.content = "(none)";
+                todoBody.fg = COLORS.hint;
+                return;
+            }
+            todoBody.content = todos
+                .map((todo) => `${todoStatusGlyph(todo.status)} ${todo.content}`)
+                .join("\n");
+            todoBody.fg = COLORS.agent;
+        },
+        setStateMachine(session) {
+            if (!session) {
+                smBody.content = "(inactive)";
+                smBody.fg = COLORS.hint;
+                return;
+            }
+            const current = session.currentState;
+            const lines = session.definition.states.map((state) => {
+                const marker = state.name === current ? "▶" : " ";
+                return `${marker} ${state.name}`;
+            });
+            if (session.terminal) {
+                lines.push("", `terminal: ${session.terminal.status}`);
+            }
+            smBody.content = lines.join("\n");
+            smBody.fg = COLORS.agent;
+        },
+        setContextUsage(usage) {
+            if (!usage) {
+                contextBody.content = "(waiting for usage)";
+                contextBody.fg = COLORS.hint;
+                return;
+            }
+            const usedTokens = usage.usage.totalTokens;
+            const percent = Math.min(1, usedTokens / usage.contextWindow);
+            contextBody.content = [
+                progressBar(percent, 25),
+                `${formatTokenCount(usedTokens)} / ${formatTokenCount(usage.contextWindow)}`,
+            ].join("\n");
+            contextBody.fg = usedTokens >= usage.contextWindow ? COLORS.error : COLORS.agent;
+        },
+    };
+}
+function createPanel(renderer, title, initialBody, options = {}) {
+    const grow = options.grow ?? true;
+    const panel = new BoxRenderable(renderer, {
+        flexDirection: "column",
+        border: true,
+        borderColor: COLORS.border,
+        paddingLeft: 1,
+        paddingRight: 1,
+        padding: options.fixedHeight ? undefined : 1,
+        ...(options.fixedHeight ? { height: options.fixedHeight } : {}),
+        ...(grow ? { flexGrow: 1, flexShrink: 1 } : { flexShrink: 0 }),
+    });
+    const titleNode = new TextRenderable(renderer, {
+        content: title,
+        fg: COLORS.status,
+        height: 1,
+        flexShrink: 0,
+    });
+    const body = new TextRenderable(renderer, {
+        content: initialBody,
+        fg: COLORS.hint,
+        flexGrow: grow ? 1 : 0,
+        flexShrink: 1,
+    });
+    panel.add(titleNode);
+    panel.add(body);
+    return { panel, body };
+}
+function todoStatusGlyph(status) {
+    if (status === "completed")
+        return "✓";
+    if (status === "in_progress")
+        return "●";
+    if (status === "failed")
+        return "✗";
+    return "○";
+}
+function progressBar(value, width) {
+    const clamped = Math.max(0, Math.min(1, value));
+    const filled = Math.round(clamped * width);
+    const empty = width - filled;
+    return `[${"█".repeat(filled)}${"░".repeat(empty)}] ${`${Math.round(clamped * 100)}%`.padStart(4)}`;
+}
+function formatTokenCount(tokens) {
+    if (tokens >= 1_000_000)
+        return `${formatCompactNumber(tokens / 1_000_000)}m`;
+    if (tokens >= 1_000)
+        return `${formatCompactNumber(tokens / 1_000)}k`;
+    return String(tokens);
+}
+function formatCompactNumber(value) {
+    const rounded = value >= 10 ? Math.round(value) : Math.round(value * 10) / 10;
+    return Number.isInteger(rounded) ? String(rounded) : rounded.toFixed(1);
+}
+//# sourceMappingURL=sidebar.js.map

package/dist/src/tui/sidebar.js.map

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

package/dist/src/tui/theme.d.ts

@@ -0,0 +1,15 @@
+export declare const COLORS: {
+    readonly user: "#7DD3FC";
+    readonly agent: "#FFFFFF";
+    readonly reasoning: "#9CA3AF";
+    readonly tool: "#A78BFA";
+    readonly system: "#FBBF24";
+    readonly error: "#F87171";
+    readonly hint: "#6B7280";
+    readonly memory: "#6B7280";
+    readonly status: "#34D399";
+    readonly border: "#374151";
+};
+export declare const HINT_IDLE = "Enter: send \u00B7 Esc: quit \u00B7 Ctrl+C: force quit";
+export declare const HINT_RUNNING = "Enter: steer \u00B7 Shift+Enter: queue follow-up \u00B7 Esc: interrupt and quit \u00B7 Ctrl+C: force quit";
+//# sourceMappingURL=theme.d.ts.map

package/dist/src/tui/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../../src/tui/theme.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,MAAM;;;;;;;;;;;CAWT,CAAC;AAEX,eAAO,MAAM,SAAS,2DAAiD,CAAC;AACxE,eAAO,MAAM,YAAY,8GACqE,CAAC"}

package/dist/src/tui/theme.js

@@ -0,0 +1,18 @@
+// Shared TUI palette and footer hints. Kept in one place so individual
+// renderers stay focused on layout and the color story stays consistent
+// across the transcript, sidebar, and autocomplete panels.
+export const COLORS = {
+    user: "#7DD3FC",
+    agent: "#FFFFFF",
+    reasoning: "#9CA3AF",
+    tool: "#A78BFA",
+    system: "#FBBF24",
+    error: "#F87171",
+    hint: "#6B7280",
+    memory: "#6B7280",
+    status: "#34D399",
+    border: "#374151",
+};
+export const HINT_IDLE = "Enter: send · Esc: quit · Ctrl+C: force quit";
+export const HINT_RUNNING = "Enter: steer · Shift+Enter: queue follow-up · Esc: interrupt and quit · Ctrl+C: force quit";
+//# sourceMappingURL=theme.js.map

package/dist/src/tui/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../../src/tui/theme.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,wEAAwE;AACxE,2DAA2D;AAC3D,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,SAAS;IAChB,SAAS,EAAE,SAAS;IACpB,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,SAAS;IACjB,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,SAAS;IACjB,MAAM,EAAE,SAAS;IACjB,MAAM,EAAE,SAAS;CACT,CAAC;AAEX,MAAM,CAAC,MAAM,SAAS,GAAG,8CAA8C,CAAC;AACxE,MAAM,CAAC,MAAM,YAAY,GACvB,4FAA4F,CAAC"}

package/dist/src/turn-runner/prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../src/turn-runner/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAC;AAG7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAoBhE,wBAAgB,oCAAoC,CAAC,KAAK,EAAE;IAC1D,MAAM,EAAE,gBAAgB,CAAC;IACzB,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC;IACzB,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CACnC,GAAG,MAAM,CAIT;AAED,wBAAgB,mCAAmC,CAAC,KAAK,EAAE;IACzD,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB,GAAG,MAAM,CAkCT"}
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../src/turn-runner/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAC;AAG7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAyBhE,wBAAgB,oCAAoC,CAAC,KAAK,EAAE;IAC1D,MAAM,EAAE,gBAAgB,CAAC;IACzB,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC;IACzB,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CACnC,GAAG,MAAM,CAIT;AAED,wBAAgB,mCAAmC,CAAC,KAAK,EAAE;IACzD,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB,GAAG,MAAM,CAsCT"}

package/dist/src/turn-runner/prompts.js

@@ -1,5 +1,6 @@
 import dedent from "dedent";
 import { toXML } from "../lib/xml.js";
+import { DEFAULT_BASH_TIMEOUT_SECONDS } from "./tools.js";
 function currentDateSystemPrompt() {
     // Day-level resolution keeps the prompt stable for the whole UTC day so prompt
     // caching is not invalidated on every turn. Agents that need finer-grained
@@ -15,6 +16,10 @@ const TOOL_EXECUTION_SYSTEM_PROMPT = dedent `
   <use_parallel_tool_calls>
   For maximum efficiency, whenever you perform multiple independent operations, invoke all relevant tools simultaneously rather than sequentially. Prioritize calling tools in parallel whenever possible. For example, when reading 3 files, run 3 tool calls in parallel to read all 3 files into context at the same time. When running multiple read-only commands like \`ls\` or \`list_dir\`, always run all of the commands in parallel. Err on the side of maximizing parallel tool calls rather than running too many tools sequentially.
   </use_parallel_tool_calls>
+
+  <bash_timeout>
+  Bash commands run with a default timeout of ${DEFAULT_BASH_TIMEOUT_SECONDS} seconds (${Math.round(DEFAULT_BASH_TIMEOUT_SECONDS / 60)} minutes); commands that exceed it are killed and reported as timed out. Scope commands so they finish well under that — prefer narrow searches (e.g. \`rg\` inside the repo) over filesystem-wide walks like \`find /\`. When a command genuinely needs longer (long builds, test suites, package installs), pass an explicit \`timeout\` argument in seconds sized to the expected runtime.
+  </bash_timeout>
 `;
 export function createSystemPromptWithAppendedLayers(input) {
     return [createBaseSystemPrompt(input.config, input.skills), ...input.append]
@@ -40,10 +45,14 @@ export function createStateMachineSystemPromptLayer(input) {
     // state instead of relying on the parent transcript.
     return [
         "Route durable business-process work through state-machine tools whenever possible.",
+        'Also reach for a state machine whenever the work breaks down into well-scoped steps that a sub-agent or script can complete on its own ("do X with these inputs and return the result"). Each state runs outside this conversation: agent states get a fresh sub-agent context, and only a compact result returns to you. Their tool calls, file reads, and script output never enter this transcript, so using a state machine is the main way to keep the parent context clean on multi-step work. The definition and current progress are rendered to the user in real time, so it also serves as a visible plan. Prefer this over doing the steps yourself with todo_write whenever you do not need to keep reasoning over the intermediate output.',
+        'State-machine work also keeps the user unblocked. While states run in the background the user can still send messages and you (the parent) respond without waiting for the state machine to finish. State-machine progress continues regardless of what you do here — by default just answer the user. Only call select_state_machine_state if the user explicitly wants to redirect or change the running work; questions, status checks, and side conversations should be answered with plain replies. A "steer" message reaches you immediately as an interruption (right shape for redirects or anything time-sensitive); a "follow_up" message is queued and delivered when your current turn settles (right shape for context that does not need to interrupt). Doing the same multi-step work via todo_write would block the user behind your own tool calls instead.',
         "If the request is simple or unrelated, answer normally without calling a turn-runner control tool.",
-        "After you select a state-machine state, the runner executes that state outside your current assistant message and may later sleep, wake, or continue in the background.",
+        "After you select a state-machine state, the runner executes that state outside your current assistant message and may later sleep, wake, or continue in the background. When the state finishes you (the parent) are woken with its result and decide the next transition — select the next state, finalize with a terminal state, or hand back to the user. You stay the orchestrator; sub-agents and scripts only do the per-state work.",
         "State prompts and script commands may use template strings like {{ input.email }}. Add inputSchema to states that need template input, and pass matching input when selecting that state.",
         'Poll states run recurring script checks and must set intervalMs. Timer states are separate: use kind "timer" with wakeAt to pause until one absolute Unix epoch millisecond timestamp. Poll states fail the state machine when timeoutMs is exceeded.',
+        "Poll intervalMs must be at least 15 minutes and timer wakeAt must be at least 15 minutes in the future. If the work needs anything shorter-term, run it directly in your turn instead of through a state machine — orchestration overhead is not worth it for sub-15-minute waits.",
+        'Every state-machine definition must include at least one terminal state with status "completed" for the happy-path exit. The runner auto-injects "failed" and "cancelled" terminal states when missing, so you always have escape hatches without writing boilerplate terminals.',
         "Use allowedSkills on agent states only when that sub-agent should receive a restricted skill set.",
         'When resuming after an interruption, an agent ask, or uncertainty about progress, call get_current_state_machine_state before selecting the next state. Also call it before answering user questions about current state-machine progress, background work, poll/wake status, what has already happened, or why the session is waiting. If currentState is "interrupted", use the history to identify the interrupted state and rerun it when appropriate.',
         "When the user changes direction during state-machine work, select the same state again with updated input or select a different state. Selecting a state while another state is running replaces the active state work.",

package/dist/src/turn-runner/prompts.js.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../../src/turn-runner/prompts.ts"],"names":[],"mappings":"AACA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAItC,SAAS,uBAAuB;IAC9B,+EAA+E;IAC/E,2EAA2E;IAC3E,gDAAgD;IAChD,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACpD,OAAO,MAAM,CAAA;;0BAEW,KAAK;;GAE5B,CAAC;AACJ,CAAC;AAED,MAAM,4BAA4B,GAAG,MAAM,CAAA;;;;CAI1C,CAAC;AAEF,MAAM,UAAU,oCAAoC,CAAC,KAIpD;IACC,OAAO,CAAC,sBAAsB,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC;SACzE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,mCAAmC,CAAC,KAGnD;IACC,MAAM,UAAU,GACd,KAAK,CAAC,IAAI,KAAK,MAAM;QACnB,CAAC,CAAC,uFAAuF;QACzF,CAAC,CAAC,0FAA0F,CAAC;IACjG,MAAM,UAAU,GACd,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,CAAC;IACxF,MAAM,gBAAgB,GAAG,UAAU;QACjC,CAAC,CAAC,MAAM,CAAA;;;UAGF,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;;;OAGtC;QACH,CAAC,CAAC,SAAS,CAAC;IAEd,0EAA0E;IAC1E,2EAA2E;IAC3E,qDAAqD;IACrD,OAAO;QACL,oFAAoF;QACpF,oGAAoG;QACpG,yKAAyK;QACzK,2LAA2L;QAC3L,uPAAuP;QACvP,mGAAmG;QACnG,4bAA4b;QAC5b,yNAAyN;QACzN,UAAU;QACV,gBAAgB;KACjB;SACE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC;AAED,SAAS,sBAAsB,CAAC,MAAwB,EAAE,MAAwB;IAChF,OAAO;QACL,MAAM,CAAC,kBAAkB;QACzB,uBAAuB,EAAE;QACzB,4BAA4B;QAC5B,wBAAwB,CAAC,MAAM,CAAC;KACjC;SACE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC;AAED,SAAS,wBAAwB,CAAC,MAAwB;IACxD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,MAAM,CAAA;;MAET,KAAK,CAAC;QACN,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC7B,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE;SACxE,CAAC,CAAC;KACJ,CAAC;GACH,CAAC;AACJ,CAAC"}
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../../src/turn-runner/prompts.ts"],"names":[],"mappings":"AACA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAGtC,OAAO,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAE1D,SAAS,uBAAuB;IAC9B,+EAA+E;IAC/E,2EAA2E;IAC3E,gDAAgD;IAChD,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACpD,OAAO,MAAM,CAAA;;0BAEW,KAAK;;GAE5B,CAAC;AACJ,CAAC;AAED,MAAM,4BAA4B,GAAG,MAAM,CAAA;;;;;;gDAMK,4BAA4B,aAAa,IAAI,CAAC,KAAK,CAAC,4BAA4B,GAAG,EAAE,CAAC;;CAErI,CAAC;AAEF,MAAM,UAAU,oCAAoC,CAAC,KAIpD;IACC,OAAO,CAAC,sBAAsB,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC;SACzE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,mCAAmC,CAAC,KAGnD;IACC,MAAM,UAAU,GACd,KAAK,CAAC,IAAI,KAAK,MAAM;QACnB,CAAC,CAAC,uFAAuF;QACzF,CAAC,CAAC,0FAA0F,CAAC;IACjG,MAAM,UAAU,GACd,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,CAAC;IACxF,MAAM,gBAAgB,GAAG,UAAU;QACjC,CAAC,CAAC,MAAM,CAAA;;;UAGF,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;;;OAGtC;QACH,CAAC,CAAC,SAAS,CAAC;IAEd,0EAA0E;IAC1E,2EAA2E;IAC3E,qDAAqD;IACrD,OAAO;QACL,oFAAoF;QACpF,ytBAAytB;QACztB,80BAA80B;QAC90B,oGAAoG;QACpG,4aAA4a;QAC5a,2LAA2L;QAC3L,uPAAuP;QACvP,oRAAoR;QACpR,kRAAkR;QAClR,mGAAmG;QACnG,4bAA4b;QAC5b,yNAAyN;QACzN,UAAU;QACV,gBAAgB;KACjB;SACE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC;AAED,SAAS,sBAAsB,CAAC,MAAwB,EAAE,MAAwB;IAChF,OAAO;QACL,MAAM,CAAC,kBAAkB;QACzB,uBAAuB,EAAE;QACzB,4BAA4B;QAC5B,wBAAwB,CAAC,MAAM,CAAC;KACjC;SACE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC;AAED,SAAS,wBAAwB,CAAC,MAAwB;IACxD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,MAAM,CAAA;;MAET,KAAK,CAAC;QACN,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC7B,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE;SACxE,CAAC,CAAC;KACJ,CAAC;GACH,CAAC;AACJ,CAAC"}

package/dist/src/turn-runner/tools.d.ts

@@ -1,9 +1,23 @@
 import type { AgentTool } from "@earendil-works/pi-agent-core";
-import { type Skill } from "@earendil-works/pi-coding-agent";
+import { type BashOperations, type Skill } from "@earendil-works/pi-coding-agent";
 import { Type, type Static } from "typebox";
 import type { TurnMode, TurnQuestion, TurnTodo } from "../types/protocol.js";
 import type { StateMachineSession, StateMachineSessionEvent, StateMachineAgentState, StateMachineDefinition, StateMachinePollState, StateMachineProgress, StateMachineScriptState, StateMachineState, StateMachineTimerState, StateMachineTerminalResult } from "../types/state-machine.js";
 import type { ActiveStateOutput } from "./state-machine-controller.js";
+/**
+ * Default cap (in seconds) applied to bash tool invocations that omit an
+ * explicit timeout. Upstream's bash tool ships with no default timeout, so
+ * stray commands like `find /` could otherwise run for many minutes before
+ * anything intervenes. The model can still pass a larger `timeout` argument
+ * for legitimate long-running work.
+ */
+export declare const DEFAULT_BASH_TIMEOUT_SECONDS = 300;
+/**
+ * Wrap a `BashOperations` implementation so any `exec` call without an
+ * explicit `timeout` uses `defaultTimeoutSeconds`. Calls that already specify
+ * a timeout (the model passed one) are forwarded unchanged.
+ */
+export declare function withDefaultBashTimeout(base: BashOperations, defaultTimeoutSeconds?: number): BashOperations;
 declare const askUserQuestionSchema: Type.TObject<{
     questions: Type.TArray<Type.TObject<{
         question: Type.TString;

package/dist/src/turn-runner/tools.d.ts.map

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

package/dist/src/turn-runner/tools.js

@@ -1,4 +1,4 @@
-import { createCodingTools } from "@earendil-works/pi-coding-agent";
+import { createCodingTools, createLocalBashOperations, } from "@earendil-works/pi-coding-agent";
 import { Ajv } from "ajv";
 import dedent from "dedent";
 import { Type } from "typebox";
@@ -6,6 +6,27 @@ import { Value } from "typebox/value";
 import { INTERRUPTED_STATE_MACHINE_STATE } from "../types/state-machine.js";
 import { readSkillInstructions } from "./skills.js";
 const jsonSchemaValidator = new Ajv({ strictSchema: false });
+/**
+ * Default cap (in seconds) applied to bash tool invocations that omit an
+ * explicit timeout. Upstream's bash tool ships with no default timeout, so
+ * stray commands like `find /` could otherwise run for many minutes before
+ * anything intervenes. The model can still pass a larger `timeout` argument
+ * for legitimate long-running work.
+ */
+export const DEFAULT_BASH_TIMEOUT_SECONDS = 300;
+/**
+ * Wrap a `BashOperations` implementation so any `exec` call without an
+ * explicit `timeout` uses `defaultTimeoutSeconds`. Calls that already specify
+ * a timeout (the model passed one) are forwarded unchanged.
+ */
+export function withDefaultBashTimeout(base, defaultTimeoutSeconds = DEFAULT_BASH_TIMEOUT_SECONDS) {
+    return {
+        exec: (command, cwd, options) => base.exec(command, cwd, {
+            ...options,
+            timeout: options.timeout ?? defaultTimeoutSeconds,
+        }),
+    };
+}
 const questionOptionSchema = Type.Object({
     label: Type.String({ description: "Answer text shown to the user." }),
     description: Type.Optional(Type.String({ description: "Optional context explaining this choice." })),
@@ -216,7 +237,9 @@ export function isTurnRunnerControlResult(value) {
 }
 export function createDefaultTurnRunnerTools(cwd, todoStorage, skills = []) {
     return [
-        ...createCodingTools(cwd),
+        ...createCodingTools(cwd, {
+            bash: { operations: withDefaultBashTimeout(createLocalBashOperations()) },
+        }),
         createTodoWriteTool(todoStorage),
         createAskUserQuestionTool(),
         createReadSkillTool(skills),
@@ -299,21 +322,23 @@ export function createTodoWriteTool(storage) {
         name: "todo_write",
         label: "Write todos",
         description: dedent `
-      Track multi-step work as a structured, visible todo list. The list is shown to the user in real time — it is your shared scratchpad of "what we agreed to do" and "where we are."
+      Track multi-step work that you are doing yourself in this conversation, as a structured, visible todo list. The list is shown to the user in real time — it is your shared scratchpad of "what we agreed to do" and "where we are."
 
-      Reach for this tool whenever any of these are true:
-      - The user's message contains more than one independent task ("do X, also Y, and don't forget Z").
-      - The work needs three or more non-trivial steps to finish (research, edit, test, commit, etc.).
+      Reach for this tool when the steps require *your* ongoing reasoning and tool use in this transcript: edits you need to review, search results you need to keep referencing, or work where the user wants to see your moves as you make them. Use it whenever any of these are true:
+      - The user's message contains more than one independent task ("do X, also Y, and don't forget Z") and you will handle them yourself.
+      - The work needs three or more non-trivial steps to finish (research, edit, test, commit, etc.) that you will execute in this conversation.
       - You are about to spend several tool calls on something — write the plan first so the user can see and correct it.
       - You are resuming or interrupting work and want to make state explicit.
 
+      Prefer a state machine over this tool when the steps are well-scoped enough that a sub-agent or script could complete each one on its own ("do X with these inputs and return the result"). State-machine states run outside this transcript, so their intermediate output does not consume your context — using todo_write for that kind of work pollutes the parent context with tool output you do not actually need to keep.
+
       How to use it well:
       - Lay out the full plan up front with merge=false. Mark exactly one item in_progress at a time.
       - As you finish each item, call again with merge=true and just that item flipped to completed; advance the next one to in_progress in the same call.
       - If the plan changes (user redirects, you discover new work), update the list immediately so it stays honest.
-      - Skip the tool only for genuinely single-step requests — a one-shot answer or a single file edit doesn't need a list.
+      - Skip the tool for genuinely single-step requests — a one-shot answer or a single file edit doesn't need a list.
 
-      Treat "the user gave me a list of asks" as an automatic cue to call this tool before doing anything else.
+      Treat "the user gave me a list of asks I will handle myself" as an automatic cue to call this tool before doing anything else.
     `,
         parameters: todoWriteSchema,
         async execute(_toolCallId, params) {
@@ -357,15 +382,29 @@ function createStateMachineDefinitionTool() {
         name: "create_state_machine_definition",
         label: "Create state machine definition",
         description: dedent `
-      Create a state-machine definition for durable business-process work. State prompts and script commands may use template strings such as {{ input.email }}; define inputSchema on those states and pass matching input when selecting them. Agent states may set allowedSkills to restrict which skills are injected into that sub-agent.
+      Create a state-machine definition for durable business-process work, or for any multi-step task whose steps are well-scoped enough that a sub-agent or script can complete each one on its own.
+
+      Reach for this tool — not todo_write — whenever a step can be described as "do X with these inputs and return the result." Each agent state runs in a fresh sub-agent context, and each script/poll/timer state runs without an agent at all. Only a compact result returns to you, so the sub-agent's tool calls, file reads, and script output never pollute this transcript. That makes a state machine the primary way to keep the parent context clean on multi-step work. The definition, current state, and progress are also rendered to the user in real time, so it doubles as a visible plan — they can see which state is running, what came before, and what is waiting.
+
+      You stay the orchestrator: when each state finishes, the runner wakes you with its result so you can inspect the output and decide the next transition (select the next state, finalize with a terminal state, or hand back to the user). Sub-agents and scripts only do the per-state work; they do not pick what comes next.
+
+      State-machine work also keeps the user unblocked. While states execute in the background the user can keep sending messages and you (the parent) will respond without waiting for the state machine to finish. State-machine progress continues regardless of what you do in that side reply — by default just answer the user. Only call select_state_machine_state if the user actually wants to redirect or change the running work; questions, status checks, and side conversations should be answered with plain replies. A "steer" message arrives immediately as an interruption (right shape for redirects or anything time-sensitive); a "follow_up" message is queued and delivered when your current turn settles (right shape for context that does not need to interrupt). Doing the same multi-step work via todo_write would block the user behind your own tool calls instead.
+
+      Use todo_write instead only when you need to do the steps yourself in this conversation because you will keep reasoning over the intermediate output.
+
+      State prompts and script commands may use template strings such as {{ input.email }}; define inputSchema on those states and pass matching input when selecting them. Agent states may set allowedSkills to restrict which skills are injected into that sub-agent.
 
       Poll states always run script attempts on a recurring intervalMs and fail the state machine when timeoutMs is exceeded. Timer states are separate: set kind "timer" with wakeAt as an absolute Unix epoch millisecond timestamp, and the state completes at that time so the parent can choose the next state.
 
+      Poll intervalMs must be at least 15 minutes (900000 ms), and timer wakeAt must be at least 15 minutes in the future. State machines are for long-running lifecycle work that benefits from sleep/wake/background execution. Anything shorter-term should run directly in your turn rather than through a state machine — the orchestration overhead is not worth it for sub-15-minute waits.
+
+      Every definition must include at least one terminal state with status "completed" representing the happy-path exit (success). The runner automatically adds terminal states named "failed" (status "failed") and "cancelled" (status "cancelled") if you do not define them, so you always have escape hatches for unrecoverable failure and user cancellation without specifying boilerplate terminals. You may still define your own "failed" or "cancelled" states (with reasons or different names) to override or supplement the auto-injected ones.
+
       Use this only when no state machine is active or the previous state machine has reached a terminal state; otherwise use select_state_machine_state.
     `,
         parameters: createDefinitionSchema,
         async execute(_toolCallId, params) {
-            assertValidDefinitionInputSchemas(params.definition);
+            assertValidDefinition(params.definition);
             const result = {
                 type: "create_state_machine_definition",
                 definition: params.definition,
@@ -475,13 +514,39 @@ function assertValidStateInput(state, input) {
     const message = first?.message ?? "does not match schema";
     throw new Error(`Invalid input for state "${state.name}" at ${path}: ${message}`);
 }
-function assertValidDefinitionInputSchemas(definition) {
+// Minimum poll/timer cadence. State machines are for long-running lifecycle
+// work that survives sleeps, wakes, and background execution; anything shorter
+// than this should be performed directly in the parent turn rather than paid
+// for with the orchestration overhead of a state machine.
+const MINIMUM_STATE_MACHINE_DELAY_MS = 15 * 60 * 1000;
+function assertValidDefinition(definition) {
     for (const state of definition.states) {
         if (state.name === INTERRUPTED_STATE_MACHINE_STATE) {
             throw new Error(`State name "${INTERRUPTED_STATE_MACHINE_STATE}" is reserved.`);
         }
         assertValidStateInputSchema(state);
         assertValidStateSchedule(state);
+        assertValidStateScheduleMinimum(state);
+    }
+    injectMissingTerminalEscapeHatches(definition);
+    assertHasCompletedTerminal(definition);
+}
+// The author defines the happy-path exit; failed/cancelled escape hatches are
+// added automatically so every definition can always be aborted or finalized
+// without forcing the caller to remember boilerplate terminal states.
+function injectMissingTerminalEscapeHatches(definition) {
+    const existingNames = new Set(definition.states.map((state) => state.name));
+    if (!existingNames.has("failed")) {
+        definition.states.push({ kind: "terminal", name: "failed", status: "failed" });
+    }
+    if (!existingNames.has("cancelled")) {
+        definition.states.push({ kind: "terminal", name: "cancelled", status: "cancelled" });
+    }
+}
+function assertHasCompletedTerminal(definition) {
+    const hasCompletedTerminal = definition.states.some((state) => state.kind === "terminal" && state.status === "completed");
+    if (!hasCompletedTerminal) {
+        throw new Error('State-machine definition must include at least one terminal state with status "completed" representing successful completion of the lifecycle.');
     }
 }
 function assertValidStateInputSchema(state) {
@@ -494,6 +559,9 @@ function assertValidStateInputSchema(state) {
     });
     throw new Error(`Invalid inputSchema for state "${state.name}": ${message}`);
 }
+// Shape validation: intervalMs / wakeAt must be present and finite. Runs at
+// both definition creation and state selection so malformed overrides are
+// rejected too.
 function assertValidStateSchedule(state) {
     if (state.kind === "poll" &&
         (typeof state.intervalMs !== "number" ||
@@ -506,4 +574,21 @@ function assertValidStateSchedule(state) {
         throw new Error(`Invalid timer schedule for state "${state.name}": wakeAt must be finite.`);
     }
 }
+// Minimum-cadence guidance: enforced only when a new definition is being
+// created. Existing definitions handed to the runner via `mode:` may legitimately
+// have shorter cadences from configuration the agent did not author, and the
+// runtime should run them as-is rather than re-litigating the boundary.
+function assertValidStateScheduleMinimum(state) {
+    if (state.kind === "poll" && typeof state.intervalMs === "number") {
+        if (state.intervalMs < MINIMUM_STATE_MACHINE_DELAY_MS) {
+            throw new Error(`Invalid poll schedule for state "${state.name}": intervalMs must be at least 15 minutes (${MINIMUM_STATE_MACHINE_DELAY_MS} ms). Anything shorter should run directly in the parent turn instead of through a state machine.`);
+        }
+    }
+    if (state.kind === "timer" && typeof state.wakeAt === "number") {
+        const minWakeAt = Date.now() + MINIMUM_STATE_MACHINE_DELAY_MS;
+        if (state.wakeAt < minWakeAt) {
+            throw new Error(`Invalid timer schedule for state "${state.name}": wakeAt must be at least 15 minutes in the future. Anything shorter should run directly in the parent turn instead of through a state machine.`);
+        }
+    }
+}
 //# sourceMappingURL=tools.js.map