pi-agent-flow 1.8.1 → 1.8.3

package/README.md

@@ -45,7 +45,7 @@ pi install .
 - **Flow-state delegation** — six bundled specialist flows (`scout`, `debug`, `build`, `craft`, `audit`, `ideas`) plus custom flows via Markdown front-matter
 - **Isolated forked context** — each flow runs as an isolated `pi` child process with a session snapshot (or clean slate when configured)
 - **Parallel execution** — batch independent flows into one call with bounded concurrency
-- **Structured reports** — every flow returns `[Summary]`, `[Done]`, `[Not Done]`, `[Next Steps]`; optional JSON schema with files, actions, commands, and reasoning
+- **Structured reports** — every flow returns structured output with `summary`, `files`, `actions`, `commands`, `notDone`, `nextSteps`, `reasoning`, and `notes`; optional JSON schema for machine-readable results
 - **Mechanically enriched commands** — bash commands in structured output are replaced with exact verbatim tool-call strings and annotated with `executionTime`
 - **Depth guards** — configurable max delegation depth (default: `3`)
 - **Session timeout modes** — child flows use controlled budgets: `fast` (300s), `default` (600s), `long` (900s), or `extreme_long` (1200s)
@@ -55,14 +55,12 @@ pi install .
 - **Model tiering & failover** — flows map to `lite` / `flash` / `full` tiers with primary + failover model chains
 - **Persistent flow mode** — switch global model strategies with `--flow-mode`; written to `settings.json` and remembered across sessions
 - **Flow-mode notification** — concise (`mode: name | lite: model · flash: model · full: model`) or verbose (with per-tier flow-name labels) startup message
-- **Auto-transition** — opt-in automatic queuing of follow-up flows based on the declarative transition matrix
 - **Unified batch tools** — `batch` (read/write/edit/delete) and `batch_read` replace separate file tools for cross-cutting work
 - **Web tool** — built-in `web` search (Brave + DuckDuckGo) and page fetch with HTML→Markdown conversion
 - **Sliding system prompt** — lightweight routing reminder injected before each user message, stripped from child snapshots to avoid duplication
 - **Session snapshot sanitization** — removes sliding prompts, reasoning/thinking artifacts, and non-inheritable content before forking; compresses prior flow results into compact context maps
 - **Shared context inheritance** — child flows receive the parent's sanitized session automatically; write forward-looking intents and let the child pick up context from its inherited snapshot
 - **Project flow confirmation** — prompts before running project-local flows from `.pi/agents/` for security
-- **Post-flow hooks** — automatic advisory messages suggesting follow-up flows (e.g., `build → audit`)
 - **Rich TUI rendering** — collapsed activity-panel view with per-flow stats, live countdowns, and expanded view with full reports and tool traces
 - **Smooth streaming metrics** — token counters and smoothed TPS increment tick-by-tick during active streaming
 
@@ -76,7 +74,7 @@ This approach delivers four concrete benefits:
 
 1. **Avoid duplicate tool calls** — every sub-agent launch no longer re-runs the same `read`, `grep`, or `bash` probes that the parent already performed.
 2. **Prevent context bloat** — long transcripts with repeated file listings and command outputs are kept out of the main conversation thread.
-3. **Eliminate unnecessary noise** — the parent agent sees only structured results (`[Summary]`, `[Done]`, `[Not Done]`, `[Next Steps]`) instead of pages of intermediate reasoning.
+3. **Eliminate unnecessary noise** — the parent agent sees only structured results (`summary`, `notDone`, `nextSteps`, etc.) instead of pages of intermediate reasoning.
 4. **Preserve focus** — each flow stays locked on its intent because it isn't distracted by unrelated earlier messages.
 
 The result is faster, cheaper, and cleaner delegation: the main agent remains uncluttered while specialized flows do the heavy lifting in isolated contexts.
@@ -254,7 +252,7 @@ Only include fields that have data. Omit empty arrays; missing array fields are
 
 ---
 
-## Post-Flow Hooks & Auto-Transitions
+## Post-Flow Advisory Messages
 
 When certain flows complete, the system injects advisory messages suggesting follow-up flows. This keeps the agent on the optimal path without requiring the user to manually chain flows.
 
@@ -273,28 +271,7 @@ When certain flows complete, the system injects advisory messages suggesting fol
 | `craft` | `build` | success | Plan ready. Consider running a [build] flow to implement the design. |
 | `ideas` | `craft` | success | Ideas explored. Consider running a [craft] flow to design the approach, or [build] to implement directly. |
 
-Hooks are smart: if the agent already included the suggested flow in the same batch, the advisory is suppressed to avoid redundancy.
-
-### Auto-transition
-
-Enable `autoTransition: true` in `flowSettings` (or `--auto-transition`) to automatically queue follow-up flows without manual intervention. The system checks that the target flow exists, was not already requested, and would not create a cycle before queuing it.
-
-### Extending hooks
-
-Hooks are registered via `registerHook()` in `hooks.ts`. Each hook defines a trigger (flow type + success requirement) and an action that returns advisory text.
-
-Example — a custom `scout → craft` hook:
-
-```ts
-registerHook({
-  name: "my/scout-to-craft",
-  trigger: { flowTypes: ["scout"], onlyOnSuccess: true },
-  action: (ctx) => ({
-    content: "Consider running a [craft] flow to design a solution.",
-    priority: 10,
-  }),
-});
-```
+Advisories are smart: if the agent already included the suggested flow in the same batch, the advisory is suppressed to avoid redundancy.
 
 ---
 
@@ -429,7 +406,6 @@ You can also set flow runtime defaults under `flowSettings`:
     "maxConcurrency": 4,
     "toolOptimize": true,
     "structuredOutput": true,
-    "autoTransition": false
   }
 }
 ```
@@ -440,7 +416,6 @@ You can also set flow runtime defaults under `flowSettings`:
 | `maxConcurrency` | `4` | Maximum parallel flows (capped to CPU count) |
 | `toolOptimize` | `true` | Use unified `batch`/`batch_read` instead of separate read/write/edit |
 | `structuredOutput` | `true` | Inject JSON structured-output instructions into flow prompts |
-| `autoTransition` | `false` | Automatically queue follow-up flows based on the transition matrix |
 
 Session mode precedence is:
 
@@ -464,7 +439,6 @@ per-flow sessionMode > --flow-session-mode > PI_FLOW_SESSION_MODE > flowSettings
 | `--flow-max-concurrency [n]` | Maximum parallel flows | `4` |
 | `--tool-optimize` | Use unified `batch`/`batch_read` | `true` |
 | `--no-tool-optimize` | Disable tool optimization; use legacy read/write/edit | — |
-| `--auto-transition` | Automatically queue follow-up flows | `false` |
 | `--structured-output` | Inject structured JSON output instructions | `true` |
 | `--no-structured-output` | Disable structured output injection | — |
 

package/agents/audit.md

@@ -3,6 +3,7 @@ name: audit
 description: Audit security, quality, correctness, and apply fixes
 tools: batch, bash, find, grep, ls
 maxDepth: 0
+tier: flash
 ---
 
 ## Mission
@@ -27,5 +28,3 @@ During this audit flow — your mission is to verify and remediate quality, secu
 - If a fix requires broader redesign, recommend [craft] in [Next Steps].
 - If root cause is unclear, recommend [debug] rather than guessing.
 
-## Note
-Treat this as a clean-slate system rewrite, unless explicitly mentioned in the requirements. Perform a comprehensive migration with zero requirements for backwards compatibility. You must ensure that all residual code, variable names, test suites, and documentation are fully refactored and perfectly aligned with the new architecture.

package/agents/build.md

@@ -3,6 +3,7 @@ name: build
 description: Implement features, fix bugs, write tests, deploy, and ship
 tools: batch, bash, find, grep, ls
 maxDepth: 0
+tier: flash
 ---
 
 ## Mission

package/agents/craft.md

@@ -3,27 +3,31 @@ name: craft
 description: Plan structure, break down requirements, design solutions
 tools: batch, bash, find, grep, ls
 maxDepth: 0
+tier: full
 ---
 
 ## Mission
 
-During this craft flow — your mission is to design a clear plan. Be conservative: prefer existing patterns and proven conventions over novelty, and treat the conversation history above as background reference only.
+During this craft flow — your mission is to design a clear, well-structured plan for implementation. Think architecturally: evaluate the full landscape, design for clean migration, and treat the conversation history above as background reference only.
 
 ## Workflow
 
 1. Understand — define the problem, constraints, existing behavior, and success criteria.
-2. Explore — map relevant patterns and dependencies. Use `batch` with `o: "read"`, `s: <offset>`, and `l: <limit>` for targeted file reading instead of bash `sed`/`head`/`tail`.
-3. Design — choose the simplest solution that works and fits existing patterns.
-4. Plan — produce concrete ordered tasks and identify parallel vs sequential work.
-5. Review — check risks, edge cases, test strategy, and handoff path before build.
+2. Explore — map relevant patterns, dependencies, and existing architecture. Use `batch` with `o: "read"`, `s: <offset>`, and `l: <limit>` for targeted file reading instead of bash `sed`/`head`/`tail`.
+3. Evaluate — assess whether the change fits existing patterns or requires a clean migration. Prefer incremental improvement when safe; endorse full-cut redesign when the architecture demands it.
+4. Design — produce a concrete plan with ordered tasks, data flow, module boundaries, and interface contracts.
+5. Review — check risks, edge cases, test strategy, migration path, and handoff to build.
 
 ## Rules
 
 - Follow SOLID, DRY, and KISS.
 - Design for 10x, build for 1x.
-- Avoid tech debt; choose a maintainable approach or explain the trade-off.
-- Prefer explicit assumptions and constraints over hidden decisions.
+- Prefer explicit assumptions and constraints over hidden decisions — state what you assume and why.
+- When redesigning, preserve data integrity and migration paths; never orphan existing consumers.
+- Favor clean migration: if a redesign is warranted, cut fully rather than leaving half-measures.
+- Document trade-offs explicitly when the optimal path is unclear.
 - Do not implement changes from this flow unless explicitly requested.
 
 ## Note
-Treat this as a clean-slate system rewrite, unless explicitly mentioned in the requirements. Perform a comprehensive migration with zero requirements for backwards compatibility. You must ensure that all residual code, variable names, test suites, and documentation are fully refactored and perfectly aligned with the new architecture.
+
+This flow operates in design mode — produce plans and specifications, not implementations. When a clean-slate redesign is warranted by the requirements, embrace it fully: define the target architecture, migration steps, and rollback strategy. When incremental change suffices, prefer it. The key principle is intentional design over accidental complexity.

package/agents/debug.md

@@ -3,6 +3,7 @@ name: debug
 description: Investigate logs, errors, stack traces, root causes
 tools: batch, bash, find, grep, ls
 maxDepth: 0
+tier: lite
 ---
 
 ## Mission
@@ -28,5 +29,4 @@ During this debug flow — your mission is to investigate root cause. Be forensi
 - Documentation-only updates are required after finishing the work when relevant and safe; if no docs changed, explain why in the final report.
 - Do not implement product-code changes from this flow unless explicitly requested.
 
-## Note
-Treat this as a clean-slate system rewrite, unless explicitly mentioned in the requirements. Perform a comprehensive migration with zero requirements for backwards compatibility. You must ensure that all residual code, variable names, test suites, and documentation are fully refactored and perfectly aligned with the new architecture.
+

package/agents/ideas.md

@@ -3,6 +3,7 @@ name: ideas
 description: Generate ideas, explore possibilities, and think creatively using inherited context as background
 tools: batch, bash
 maxDepth: 0
+tier: full
 ---
 
 ## Mission

package/agents/scout.md

@@ -3,6 +3,7 @@ name: scout
 description: Discover files, trace code paths, map architecture
 tools: batch, bash, find, grep, ls
 maxDepth: 0
+tier: lite
 ---
 
 ## Mission

package/dist/agents.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Flow discovery and configuration.
+ *
+ * Flows are Markdown files with YAML frontmatter that define name, description,
+ * optional model/tools, and a system prompt body.
+ *
+ * Lookup locations:
+ *   - User flows:    ~/.pi/agent/agents/*.md by default, or
+ *                    $PI_CODING_AGENT_DIR/agents/*.md when the env var is set
+ *   - Project flows: .pi/agents/*.md  (walks up from cwd)
+ */
+export type FlowScope = "user" | "project" | "both" | "bundled" | "all";
+export type FlowTier = "lite" | "flash" | "full";
+export interface FlowConfig {
+    name: string;
+    description: string;
+    tools?: string[];
+    model?: string;
+    thinking?: string;
+    maxDepth?: number;
+    inheritContext?: boolean;
+    tier?: FlowTier;
+    systemPrompt: string;
+    source: "user" | "project" | "bundled";
+    filePath: string;
+}
+export interface FlowDiscoveryResult {
+    flows: FlowConfig[];
+    projectFlowsDir: string | null;
+}
+/** Determine the model tier for a given flow name. */
+export declare function getFlowTier(flowName: string): FlowTier;
+/** Return the bundled flow names associated with a given tier. */
+export declare function getTierFlowNames(tier: FlowTier): string[];
+/**
+ * Discover all available flows according to the requested scope.
+ *
+ * Precedence is: bundled < user < project.
+ */
+export declare function discoverFlows(cwd: string, scope: FlowScope): FlowDiscoveryResult;
+//# sourceMappingURL=agents.d.ts.map

package/dist/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,KAAK,CAAC;AAExE,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAEjD,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IACvC,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IACnC,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,sDAAsD;AACtD,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAetD;AAED,kEAAkE;AAClE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,EAAE,CASzD;AA2MD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,mBAAmB,CAsBhF"}

package/dist/agents.js

@@ -0,0 +1,283 @@
+/**
+ * Flow discovery and configuration.
+ *
+ * Flows are Markdown files with YAML frontmatter that define name, description,
+ * optional model/tools, and a system prompt body.
+ *
+ * Lookup locations:
+ *   - User flows:    ~/.pi/agent/agents/*.md by default, or
+ *                    $PI_CODING_AGENT_DIR/agents/*.md when the env var is set
+ *   - Project flows: .pi/agents/*.md  (walks up from cwd)
+ */
+import { parseFrontmatter } from "@mariozechner/pi-coding-agent";
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+/** Determine the model tier for a given flow name. */
+export function getFlowTier(flowName) {
+    const normalized = flowName.toLowerCase().trim();
+    switch (normalized) {
+        case "scout":
+        case "debug":
+            return "lite";
+        case "build":
+        case "audit":
+            return "flash";
+        case "ideas":
+        case "craft":
+            return "full";
+        default:
+            return "flash";
+    }
+}
+/** Return the bundled flow names associated with a given tier. */
+export function getTierFlowNames(tier) {
+    switch (tier) {
+        case "lite":
+            return ["scout", "debug"];
+        case "flash":
+            return ["build", "audit"];
+        case "full":
+            return ["ideas", "craft"];
+    }
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+function isDirectory(p) {
+    try {
+        return fs.statSync(p).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+function getUserFlowsDir() {
+    const configDir = process.env["PI_CODING_AGENT_DIR"]?.trim() || path.join(os.homedir(), ".pi", "agent");
+    return path.join(configDir, "agents");
+}
+/** Get the bundled flows directory from the plugin's location. */
+function getBundledFlowsDir() {
+    // Method 1: import.meta.url (ESM)
+    // When source lives in src/, agents/ is one level up at the package root.
+    try {
+        if (import.meta.url) {
+            const pluginDir = path.dirname(new URL(import.meta.url).pathname);
+            // Check same directory first, then parent (for src/ layout)
+            for (const base of [pluginDir, path.dirname(pluginDir)]) {
+                const dir = path.join(base, "agents");
+                if (fs.existsSync(dir))
+                    return dir;
+            }
+        }
+    }
+    catch { }
+    // Method 2: __dirname (CommonJS / jiti)
+    try {
+        if (typeof __dirname !== "undefined") {
+            for (const base of [__dirname, path.dirname(__dirname)]) {
+                const dir = path.join(base, "agents");
+                if (fs.existsSync(dir))
+                    return dir;
+            }
+        }
+    }
+    catch { }
+    // Method 3: Find from require.resolve
+    try {
+        const resolved = require.resolve("pi-agent-flow/package.json");
+        const dir = path.join(path.dirname(resolved), "agents");
+        if (fs.existsSync(dir))
+            return dir;
+    }
+    catch { }
+    // Fallback: cwd
+    return path.join(process.cwd(), "agents");
+}
+/** Walk up from `cwd` looking for a `.pi/agents` directory. */
+function findNearestProjectFlowsDir(cwd) {
+    let dir = cwd;
+    while (true) {
+        const candidate = path.join(dir, ".pi", "agents");
+        if (isDirectory(candidate))
+            return candidate;
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+}
+/** Parse a single flow markdown file into a FlowConfig. Returns null on skip. */
+function parseFlowFile(filePath, source) {
+    let content;
+    try {
+        content = fs.readFileSync(filePath, "utf-8");
+    }
+    catch {
+        return null;
+    }
+    let parsed;
+    try {
+        parsed = parseFrontmatter(content);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.warn(`[pi-agent-flow] Skipping invalid flow file "${filePath}": ${message}`);
+        return null;
+    }
+    const frontmatter = parsed.frontmatter ?? {};
+    const body = parsed.body ?? "";
+    const name = typeof frontmatter.name === "string" ? frontmatter.name.trim().toLowerCase() : "";
+    const description = typeof frontmatter.description === "string" ? frontmatter.description.trim() : "";
+    if (!name || !description) {
+        if (!name)
+            console.warn(`[pi-agent-flow] Skipping flow file "${filePath}": missing or empty 'name' field.`);
+        if (!description)
+            console.warn(`[pi-agent-flow] Skipping flow file "${filePath}": missing or empty 'description' field.`);
+        return null;
+    }
+    // Warn about unknown frontmatter keys
+    const knownKeys = new Set([
+        "name", "description", "tools", "model", "thinking",
+        "maxDepth", "inheritContext", "tier",
+    ]);
+    for (const key of Object.keys(frontmatter)) {
+        if (!knownKeys.has(key)) {
+            console.warn(`[pi-agent-flow] Unknown frontmatter key "${key}" in "${filePath}". This field will be ignored.`);
+        }
+    }
+    let tools;
+    if (typeof frontmatter.tools === "string") {
+        const parsedTools = frontmatter.tools
+            .split(",")
+            .map((t) => t.trim())
+            .filter(Boolean);
+        if (parsedTools.length > 0)
+            tools = parsedTools;
+    }
+    else if (Array.isArray(frontmatter.tools)) {
+        const parsedTools = frontmatter.tools
+            .filter((t) => typeof t === "string")
+            .map((t) => t.trim())
+            .filter(Boolean);
+        if (parsedTools.length > 0)
+            tools = parsedTools;
+    }
+    else if (frontmatter.tools !== undefined) {
+        console.warn(`[pi-agent-flow] Ignoring invalid tools field in "${filePath}". Expected a comma-separated string or string array.`);
+    }
+    let maxDepth;
+    if (typeof frontmatter.maxDepth === "number") {
+        maxDepth = frontmatter.maxDepth;
+    }
+    else if (typeof frontmatter.maxDepth === "string") {
+        const parsed = Number(frontmatter.maxDepth);
+        if (Number.isFinite(parsed) && parsed >= 0)
+            maxDepth = parsed;
+    }
+    let inheritContext;
+    if (typeof frontmatter.inheritContext === "boolean") {
+        inheritContext = frontmatter.inheritContext;
+    }
+    else if (typeof frontmatter.inheritContext === "string") {
+        const normalized = frontmatter.inheritContext.trim().toLowerCase();
+        if (normalized === "true" || normalized === "yes" || normalized === "1") {
+            inheritContext = true;
+        }
+        else if (normalized === "false" || normalized === "no" || normalized === "0") {
+            inheritContext = false;
+        }
+        else {
+            console.warn(`[pi-agent-flow] Ignoring invalid inheritContext value "${frontmatter.inheritContext}" in "${filePath}". Expected true/false.`);
+        }
+    }
+    else if (frontmatter.inheritContext !== undefined) {
+        console.warn(`[pi-agent-flow] Ignoring invalid inheritContext field in "${filePath}". Expected boolean or string.`);
+    }
+    // Tier: prefer explicit frontmatter, fall back to name-based inference
+    let tier;
+    if (typeof frontmatter.tier === "string") {
+        const normalized = frontmatter.tier.trim().toLowerCase();
+        if (normalized === "lite" || normalized === "flash" || normalized === "full") {
+            tier = normalized;
+        }
+        else {
+            console.warn(`[pi-agent-flow] Ignoring invalid tier "${frontmatter.tier}" in "${filePath}". Expected lite, flash, or full.`);
+        }
+    }
+    return {
+        name,
+        description,
+        tools,
+        model: typeof frontmatter.model === "string" ? frontmatter.model : undefined,
+        thinking: typeof frontmatter.thinking === "string" ? frontmatter.thinking : undefined,
+        maxDepth,
+        inheritContext,
+        tier: tier ?? getFlowTier(name),
+        systemPrompt: body,
+        source,
+        filePath,
+    };
+}
+/** Load all flow definitions from a directory. */
+function loadFlowsFromDir(dir, source) {
+    if (!fs.existsSync(dir))
+        return [];
+    let entries;
+    try {
+        entries = fs.readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    entries.sort((a, b) => a.name.localeCompare(b.name));
+    const flows = [];
+    for (const entry of entries) {
+        if (!entry.name.endsWith(".md"))
+            continue;
+        if (!entry.isFile() && !entry.isSymbolicLink())
+            continue;
+        const flow = parseFlowFile(path.join(dir, entry.name), source);
+        if (flow)
+            flows.push(flow);
+    }
+    return flows;
+}
+function mergeFlows(...groups) {
+    const flowMap = new Map();
+    for (const group of groups) {
+        for (const flow of group)
+            flowMap.set(flow.name.toLowerCase(), flow);
+    }
+    return Array.from(flowMap.values());
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Discover all available flows according to the requested scope.
+ *
+ * Precedence is: bundled < user < project.
+ */
+export function discoverFlows(cwd, scope) {
+    const bundledFlowsDir = getBundledFlowsDir();
+    const userFlowsDir = getUserFlowsDir();
+    const projectFlowsDir = findNearestProjectFlowsDir(cwd);
+    const bundledFlows = scope === "user" || scope === "project" ? [] : loadFlowsFromDir(bundledFlowsDir, "bundled");
+    const userFlows = scope === "project" || scope === "bundled" ? [] : loadFlowsFromDir(userFlowsDir, "user");
+    const projectFlows = scope === "user" || scope === "bundled" || !projectFlowsDir ? [] : loadFlowsFromDir(projectFlowsDir, "project");
+    if (scope === "bundled") {
+        return { flows: bundledFlows, projectFlowsDir };
+    }
+    if (scope === "user") {
+        return { flows: mergeFlows(bundledFlows, userFlows), projectFlowsDir };
+    }
+    if (scope === "project") {
+        return { flows: mergeFlows(projectFlows), projectFlowsDir };
+    }
+    return {
+        flows: mergeFlows(bundledFlows, userFlows, projectFlows),
+        projectFlowsDir,
+    };
+}
+//# sourceMappingURL=agents.js.map

package/dist/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAyBlC,sDAAsD;AACtD,MAAM,UAAU,WAAW,CAAC,QAAgB;IAC3C,MAAM,UAAU,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;IACjD,QAAQ,UAAU,EAAE,CAAC;QACpB,KAAK,OAAO,CAAC;QACb,KAAK,OAAO;YACX,OAAO,MAAM,CAAC;QACf,KAAK,OAAO,CAAC;QACb,KAAK,OAAO;YACX,OAAO,OAAO,CAAC;QAChB,KAAK,OAAO,CAAC;QACb,KAAK,OAAO;YACX,OAAO,MAAM,CAAC;QACf;YACC,OAAO,OAAO,CAAC;IACjB,CAAC;AACF,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,gBAAgB,CAAC,IAAc;IAC9C,QAAQ,IAAI,EAAE,CAAC;QACd,KAAK,MAAM;YACV,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC3B,KAAK,OAAO;YACX,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC3B,KAAK,MAAM;YACV,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC5B,CAAC;AACF,CAAC;AAED,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,SAAS,WAAW,CAAC,CAAS;IAC7B,IAAI,CAAC;QAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,KAAK,CAAC;IAAC,CAAC;AACrE,CAAC;AAED,SAAS,eAAe;IACvB,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACxG,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AACvC,CAAC;AAED,kEAAkE;AAClE,SAAS,kBAAkB;IAC1B,kCAAkC;IAClC,0EAA0E;IAC1E,IAAI,CAAC;QACJ,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;YACrB,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;YAClE,4DAA4D;YAC5D,KAAK,MAAM,IAAI,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;gBACzD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;gBACtC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;oBAAE,OAAO,GAAG,CAAC;YACpC,CAAC;QACF,CAAC;IACF,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;IAEV,wCAAwC;IACxC,IAAI,CAAC;QACJ,IAAI,OAAO,SAAS,KAAK,WAAW,EAAE,CAAC;YACtC,KAAK,MAAM,IAAI,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;gBACzD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;gBACtC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;oBAAE,OAAO,GAAG,CAAC;YACpC,CAAC;QACF,CAAC;IACF,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;IAEV,sCAAsC;IACtC,IAAI,CAAC;QACJ,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,4BAA4B,CAAC,CAAC;QAC/D,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAC;QACxD,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,GAAG,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;IAEV,gBAAgB;IAChB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC;AAC3C,CAAC;AAED,+DAA+D;AAC/D,SAAS,0BAA0B,CAAC,GAAW;IAC9C,IAAI,GAAG,GAAG,GAAG,CAAC;IACd,OAAO,IAAI,EAAE,CAAC;QACb,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;QAClD,IAAI,WAAW,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC;QAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,MAAM,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC;QAChC,GAAG,GAAG,MAAM,CAAC;IACd,CAAC;AACF,CAAC;AAED,iFAAiF;AACjF,SAAS,aAAa,CAAC,QAAgB,EAAE,MAAsC;IAC9E,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,IAAI,CAAC;IAAC,CAAC;IAE5E,IAAI,MAA8D,CAAC;IACnE,IAAI,CAAC;QACJ,MAAM,GAAG,gBAAgB,CAA0B,OAAO,CAAC,CAAC;IAC7D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,CAAC,IAAI,CAAC,+CAA+C,QAAQ,MAAM,OAAO,EAAE,CAAC,CAAC;QACrF,OAAO,IAAI,CAAC;IACb,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC;IAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;IAE/B,MAAM,IAAI,GAAG,OAAO,WAAW,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/F,MAAM,WAAW,GAAG,OAAO,WAAW,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACtG,IAAI,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QAC3B,IAAI,CAAC,IAAI;YAAE,OAAO,CAAC,IAAI,CAAC,uCAAuC,QAAQ,mCAAmC,CAAC,CAAC;QAC5G,IAAI,CAAC,WAAW;YAAE,OAAO,CAAC,IAAI,CAAC,uCAAuC,QAAQ,0CAA0C,CAAC,CAAC;QAC1H,OAAO,IAAI,CAAC;IACb,CAAC;IAED,sCAAsC;IACtC,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC;QACzB,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU;QACnD,UAAU,EAAE,gBAAgB,EAAE,MAAM;KACpC,CAAC,CAAC;IACH,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;QAC5C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,IAAI,CAAC,4CAA4C,GAAG,SAAS,QAAQ,gCAAgC,CAAC,CAAC;QAChH,CAAC;IACF,CAAC;IAED,IAAI,KAA2B,CAAC;IAChC,IAAI,OAAO,WAAW,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC3C,MAAM,WAAW,GAAG,WAAW,CAAC,KAAK;aACnC,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;aACpB,MAAM,CAAC,OAAO,CAAC,CAAC;QAClB,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC;YAAE,KAAK,GAAG,WAAW,CAAC;IACjD,CAAC;SAAM,IAAI,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7C,MAAM,WAAW,GAAG,WAAW,CAAC,KAAK;aACnC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC;aACjD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;aACpB,MAAM,CAAC,OAAO,CAAC,CAAC;QAClB,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC;YAAE,KAAK,GAAG,WAAW,CAAC;IACjD,CAAC;SAAM,IAAI,WAAW,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC5C,OAAO,CAAC,IAAI,CACX,oDAAoD,QAAQ,uDAAuD,CACnH,CAAC;IACH,CAAC;IAED,IAAI,QAA4B,CAAC;IACjC,IAAI,OAAO,WAAW,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC9C,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC;IACjC,CAAC;SAAM,IAAI,OAAO,WAAW,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACrD,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QAC5C,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC;YAAE,QAAQ,GAAG,MAAM,CAAC;IAC/D,CAAC;IAED,IAAI,cAAmC,CAAC;IACxC,IAAI,OAAO,WAAW,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;QACrD,cAAc,GAAG,WAAW,CAAC,cAAc,CAAC;IAC7C,CAAC;SAAM,IAAI,OAAO,WAAW,CAAC,cAAc,KAAK,QAAQ,EAAE,CAAC;QAC3D,MAAM,UAAU,GAAG,WAAW,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACnE,IAAI,UAAU,KAAK,MAAM,IAAI,UAAU,KAAK,KAAK,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;YACzE,cAAc,GAAG,IAAI,CAAC;QACvB,CAAC;aAAM,IAAI,UAAU,KAAK,OAAO,IAAI,UAAU,KAAK,IAAI,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;YAChF,cAAc,GAAG,KAAK,CAAC;QACxB,CAAC;aAAM,CAAC;YACP,OAAO,CAAC,IAAI,CACX,0DAA0D,WAAW,CAAC,cAAc,SAAS,QAAQ,yBAAyB,CAC9H,CAAC;QACH,CAAC;IACF,CAAC;SAAM,IAAI,WAAW,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;QACrD,OAAO,CAAC,IAAI,CACX,6DAA6D,QAAQ,gCAAgC,CACrG,CAAC;IACH,CAAC;IAED,uEAAuE;IACvE,IAAI,IAA0B,CAAC;IAC/B,IAAI,OAAO,WAAW,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC1C,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACzD,IAAI,UAAU,KAAK,MAAM,IAAI,UAAU,KAAK,OAAO,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;YAC9E,IAAI,GAAG,UAAU,CAAC;QACnB,CAAC;aAAM,CAAC;YACP,OAAO,CAAC,IAAI,CAAC,0CAA0C,WAAW,CAAC,IAAI,SAAS,QAAQ,mCAAmC,CAAC,CAAC;QAC9H,CAAC;IACF,CAAC;IAED,OAAO;QACN,IAAI;QACJ,WAAW;QACX,KAAK;QACL,KAAK,EAAE,OAAO,WAAW,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;QAC5E,QAAQ,EAAE,OAAO,WAAW,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;QACrF,QAAQ;QACR,cAAc;QACd,IAAI,EAAE,IAAI,IAAI,WAAW,CAAC,IAAI,CAAC;QAC/B,YAAY,EAAE,IAAI;QAClB,MAAM;QACN,QAAQ;KACR,CAAC;AACH,CAAC;AAED,kDAAkD;AAClD,SAAS,gBAAgB,CAAC,GAAW,EAAE,MAAsC;IAC5E,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAEnC,IAAI,OAAoB,CAAC;IACzB,IAAI,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,EAAE,CAAC;IAAC,CAAC;IACpF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAErD,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,SAAS;QAC1C,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE;YAAE,SAAS;QAEzD,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;QAC/D,IAAI,IAAI;YAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC;AAED,SAAS,UAAU,CAAC,GAAG,MAAsB;IAC5C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC9C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC5B,KAAK,MAAM,IAAI,IAAI,KAAK;YAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AACrC,CAAC;AAED,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW,EAAE,KAAgB;IAC1D,MAAM,eAAe,GAAG,kBAAkB,EAAE,CAAC;IAC7C,MAAM,YAAY,GAAG,eAAe,EAAE,CAAC;IACvC,MAAM,eAAe,GAAG,0BAA0B,CAAC,GAAG,CAAC,CAAC;IAExD,MAAM,YAAY,GAAG,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC;IACjH,MAAM,SAAS,GAAG,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAC3G,MAAM,YAAY,GAAG,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC;IAErI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,CAAC;IACjD,CAAC;IACD,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QACtB,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,YAAY,EAAE,SAAS,CAAC,EAAE,eAAe,EAAE,CAAC;IACxE,CAAC;IACD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,YAAY,CAAC,EAAE,eAAe,EAAE,CAAC;IAC7D,CAAC;IACD,OAAO;QACN,KAAK,EAAE,UAAU,CAAC,YAAY,EAAE,SAAS,EAAE,YAAY,CAAC;QACxD,eAAe;KACf,CAAC;AACH,CAAC"}

package/dist/batch/batch-bash.d.ts

@@ -0,0 +1,87 @@
+import { type BashOpResult, type PendingBashResult } from "./constants.js";
+export interface TrackedBashResult {
+    id: string;
+    command: string;
+    status: "ok" | "error" | "aborted";
+    exitCode?: number;
+    stdout: string;
+    stderr: string;
+    duration: number;
+    timingTier: string;
+}
+/**
+ * Process tracker for batch bash operations.
+ * Both the `batch` tool (launch side) and `batch_bash_poll` tool (read side)
+ * share the same instance.
+ */
+export declare class BashProcessTracker {
+    private running;
+    private completed;
+    /** Launch a bash command. Returns immediately; the process runs in the background. */
+    launch(id: string, command: string, cwd: string, signal?: AbortSignal): void;
+    /** Check if a command is still running. */
+    isRunning(id: string): boolean;
+    /** Get the last N lines of a running process's stdout. */
+    getRunningTail(id: string): string;
+    /** Get the command of a running process. */
+    getRunningCommand(id: string): string | undefined;
+    /** Get the result of a completed/aborted command. Does NOT remove from cache. */
+    peekCompleted(id: string): TrackedBashResult | undefined;
+    /** Get the result of a completed/aborted command. Removes from completed cache. */
+    popCompleted(id: string): TrackedBashResult | undefined;
+    /** Get the start time of a running process. */
+    getStartedAt(id: string): number | undefined;
+    /** Check if a command has completed. */
+    hasCompleted(id: string): boolean;
+    /** Abort a running process by id. */
+    private abortById;
+    /** Abort all running processes (cleanup). */
+    abortAll(): void;
+}
+/** Generate a short random ID for bash ops that don't provide one. */
+export declare function generateBashId(): string;
+/** Normalize a bash op from prepareArguments into a canonical form. */
+export declare function normalizeBashOp(raw: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Execute a batch of bash ops concurrently.
+ *
+ * Launches all commands in parallel, then waits until all finish or the
+ * soft timeout expires. The soft timeout is the max of per-op `t` values
+ * (if any), or the global default. Commands that haven't finished within
+ * the timeout are returned as "pending" with the last N lines of output.
+ * They continue running in the background and can be polled via batch_bash_poll.
+ */
+export declare function executeBatchBash(ops: Array<{
+    i: string;
+    c: string;
+    t?: number;
+    h?: string;
+}>, defaultCwd: string, tracker: BashProcessTracker, signal?: AbortSignal, softTimeoutMs?: number): Promise<BashOpResult[]>;
+/** Poll for completed bash results. */
+export declare function pollBatchBashResults(ids: string[], tracker: BashProcessTracker): PendingBashResult[];
+export declare const BatchBashPollParams: any;
+export declare function createBatchBashPollTool(tracker: BashProcessTracker): {
+    name: string;
+    label: string;
+    description: string;
+    promptSnippet: string;
+    promptGuidelines: string[];
+    parameters: any;
+    prepareArguments(input: unknown): unknown;
+    execute(_toolCallId: string, input: unknown, _signal?: AbortSignal, _onUpdate?: unknown): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+        details: {
+            results: PendingBashResult[];
+        };
+    } | {
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError: boolean;
+    }>;
+};
+//# sourceMappingURL=batch-bash.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"batch-bash.d.ts","sourceRoot":"","sources":["../../src/batch/batch-bash.ts"],"names":[],"mappings":"AAiBA,OAAO,EACN,KAAK,YAAY,EACjB,KAAK,iBAAiB,EAGtB,MAAM,gBAAgB,CAAC;AAgBxB,MAAM,WAAW,iBAAiB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,IAAI,GAAG,OAAO,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,qBAAa,kBAAkB;IAC9B,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,SAAS,CAAwC;IAEzD,sFAAsF;IACtF,MAAM,CACL,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,WAAW,GAClB,IAAI;IAoFP,2CAA2C;IAC3C,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI9B,0DAA0D;IAC1D,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;IAOlC,4CAA4C;IAC5C,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIjD,iFAAiF;IACjF,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAIxD,mFAAmF;IACnF,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAMvD,+CAA+C;IAC/C,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI5C,wCAAwC;IACxC,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIjC,qCAAqC;IACrC,OAAO,CAAC,SAAS;IAWjB,6CAA6C;IAC7C,QAAQ,IAAI,IAAI;CAKhB;AAWD,sEAAsE;AACtE,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,uEAAuE;AACvE,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASrF;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACrC,GAAG,EAAE,KAAK,CAAC;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EAC5D,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,kBAAkB,EAC3B,MAAM,CAAC,EAAE,WAAW,EACpB,aAAa,GAAE,MAA6B,GAC1C,OAAO,CAAC,YAAY,EAAE,CAAC,CAqDzB;AAoCD,uCAAuC;AACvC,wBAAgB,oBAAoB,CACnC,GAAG,EAAE,MAAM,EAAE,EACb,OAAO,EAAE,kBAAkB,GACzB,iBAAiB,EAAE,CAgCrB;AAMD,eAAO,MAAM,mBAAmB,KAK9B,CAAC;AAEH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,kBAAkB;;;;;;;4BAgBzC,OAAO,GAAG,OAAO;yBAS3B,MAAM,SACZ,OAAO,YACJ,WAAW,cACT,OAAO;;;;;;;;;;;;;;;EAqCrB"}