@tyvm/knowhow 0.0.137 → 0.0.140

package/ts_build/src/agents/tools/replyToParent.js

@@ -0,0 +1,118 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.replyToParentDefinition = void 0;
+exports.replyToParent = replyToParent;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+function agentsDir() {
+    return path.join(process.cwd(), ".knowhow", "processes", "agents");
+}
+function resolveParentTaskId(ctx) {
+    if (!ctx)
+        return undefined;
+    if (ctx.parentTaskId)
+        return ctx.parentTaskId;
+    const callerParent = ctx.caller?.parentTaskId;
+    if (callerParent)
+        return callerParent;
+    const ownTaskId = ctx.taskId ?? ctx.caller?.currentTaskId;
+    if (!ownTaskId)
+        return undefined;
+    try {
+        const metaPath = path.join(agentsDir(), ownTaskId, "metadata.json");
+        if (fs.existsSync(metaPath)) {
+            const meta = JSON.parse(fs.readFileSync(metaPath, "utf8"));
+            return meta.parentTaskId;
+        }
+    }
+    catch {
+    }
+    return undefined;
+}
+async function replyToParent(message, _ctx) {
+    if (!message || !message.trim()) {
+        return "No message provided to replyToParent.";
+    }
+    const parentTaskId = resolveParentTaskId(_ctx);
+    if (!parentTaskId) {
+        return ("No parent task found — this agent was not spawned with a parent taskId, " +
+            "so there is no one to reply to.");
+    }
+    const parentDir = path.join(agentsDir(), parentTaskId);
+    const parentInputPath = path.join(parentDir, "input.txt");
+    if (!fs.existsSync(parentDir)) {
+        return `Parent task directory not found: ${parentDir}`;
+    }
+    const fromTaskId = _ctx?.taskId ?? _ctx?.caller?.currentTaskId ?? "unknown";
+    const fromAgent = _ctx?.caller?.name ?? "child";
+    const envelope = `[from:${fromTaskId}] [agent:${fromAgent}] ${message}`;
+    try {
+        const existing = fs.existsSync(parentInputPath)
+            ? fs.readFileSync(parentInputPath, "utf8")
+            : "";
+        const next = existing && !existing.endsWith("\n")
+            ? `${existing}\n${envelope}\n`
+            : `${existing}${envelope}\n`;
+        fs.writeFileSync(parentInputPath, next, "utf8");
+    }
+    catch (e) {
+        return `Failed to write to parent input.txt: ${e?.message ?? String(e)}`;
+    }
+    return `Sent message to parent task ${parentTaskId}.`;
+}
+exports.replyToParentDefinition = {
+    type: "function",
+    function: {
+        name: "replyToParent",
+        description: "Send a message back to the parent agent that spawned this task. Use this " +
+            "to report progress, ask a question, or alert the parent to something. The " +
+            "message is delivered to the parent's input queue and picked up on its next " +
+            "sync cycle. Only works when this agent was spawned by another agent (i.e. " +
+            "it has a parent taskId).",
+        parameters: {
+            type: "object",
+            positional: true,
+            properties: {
+                message: {
+                    type: "string",
+                    description: "The message to send back to the parent agent",
+                },
+            },
+            required: ["message"],
+        },
+    },
+};
+//# sourceMappingURL=replyToParent.js.map

package/ts_build/src/agents/tools/replyToParent.js.map

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

package/ts_build/src/agents/tools/runGenerate.d.ts

@@ -0,0 +1,19 @@
+import { Tool } from "../../clients/types";
+import { GenerationSource } from "../../types";
+export interface RunGenerateParams {
+    sources?: GenerationSource[];
+    name?: string;
+    filter?: string;
+    force?: boolean;
+    concurrency?: number;
+    syncFs?: boolean;
+    syncRemote?: boolean;
+    planOnly?: boolean;
+    _ctx?: {
+        caller?: any;
+        taskId?: string;
+        [key: string]: any;
+    };
+}
+export declare function runGenerate(params: RunGenerateParams): Promise<string>;
+export declare const runGenerateDefinition: Tool;

package/ts_build/src/agents/tools/runGenerate.js

@@ -0,0 +1,138 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runGenerateDefinition = void 0;
+exports.runGenerate = runGenerate;
+const generate_1 = require("../../generate");
+async function runGenerate(params) {
+    const { sources, name, filter, force, concurrency, syncFs, syncRemote, planOnly, } = params ?? {};
+    const effectiveSyncFs = syncFs !== false;
+    const options = {
+        sources,
+        name,
+        filter,
+        force,
+        concurrency,
+        syncFs: effectiveSyncFs,
+        syncRemote,
+    };
+    const effectiveSources = sources ?? [];
+    if (planOnly) {
+        if (effectiveSources.length === 0) {
+            return ("planOnly requires in-memory `sources` to build a plan. " +
+                "Provide sources to see how they'd be grouped into dependency waves.");
+        }
+        const filtered = effectiveSources.filter((s) => {
+            if (name)
+                return s.name === name;
+            if (filter) {
+                const needle = filter.toLowerCase();
+                return [s.name, s.input, s.output]
+                    .filter(Boolean)
+                    .some((v) => v.toLowerCase().includes(needle));
+            }
+            return true;
+        });
+        const waves = (0, generate_1.buildWaves)(filtered);
+        const lines = [];
+        lines.push(`📋 Generation Plan (concurrency: ${concurrency ?? 3}, ${filtered.length} sources, ${waves.length} wave${waves.length !== 1 ? "s" : ""})`);
+        waves.forEach((wave, i) => {
+            lines.push(`\n┌─ Wave ${i + 1}/${waves.length} (${wave.length} in parallel)`);
+            for (const s of wave) {
+                const label = s.name || "(unnamed)";
+                const io = `${s.input || "-"} → ${s.output || "-"}`;
+                const agentPart = s.agent ? `  [agent: ${s.agent}]` : "";
+                lines.push(`│  • ${label}  ${io}${agentPart}`);
+            }
+            lines.push("└────────────────────────────────────────────────");
+        });
+        return lines.join("\n");
+    }
+    try {
+        await (0, generate_1.generate)(options);
+    }
+    catch (e) {
+        return `Generation failed: ${e?.message ?? String(e)}`;
+    }
+    const count = effectiveSources.length;
+    const mode = count > 0 ? `${count} in-memory source(s)` : "config sources";
+    return (`Generation complete for ${mode}` +
+        (name ? ` (name="${name}")` : filter ? ` (filter="${filter}")` : "") +
+        `. Outputs written to their configured paths. ` +
+        `If agent-driven sources used syncFs, inspect them with \`knowhow agents list\`.`);
+}
+exports.runGenerateDefinition = {
+    type: "function",
+    function: {
+        name: "runGenerate",
+        description: "Run the `knowhow generate` pipeline. Accepts in-memory `sources` so you can define arbitrary " +
+            "task orchestration at runtime WITHOUT editing the config file. Supports dependency ordering via " +
+            "`dependsOn`, automatic I/O overlap detection (a source reading another's output runs after it), " +
+            "per-source `agent` for agent-driven generation (map/reduce fan-out — one agent per input), " +
+            "concurrency control within each dependency wave, and plain summarization/analysis sources. " +
+            "Use `planOnly: true` to preview how sources group into concurrent dependency waves before running. " +
+            "When `sources` is omitted, it runs the sources defined in .knowhow/knowhow.json (optionally scoped by name/filter).",
+        parameters: {
+            type: "object",
+            properties: {
+                sources: {
+                    type: "array",
+                    description: "In-memory generation sources. Each item: { name?, input, output, prompt, agent?, model?, " +
+                        "kind?, outputExt?, outputName?, dependsOn?: string[], syncFs?, maxTimeLimit?, maxSpendLimit? }. " +
+                        "`input` is a glob or comma-separated file list; `output` is the target file/dir; `prompt` is the " +
+                        "generation instruction; `agent` (optional) runs an agent per input instead of a summarization call; " +
+                        "`dependsOn` lists names of sources that must finish first.",
+                    items: {
+                        type: "object",
+                        properties: {
+                            name: { type: "string" },
+                            input: { type: "string" },
+                            output: { type: "string" },
+                            prompt: { type: "string" },
+                            agent: { type: "string" },
+                            model: { type: "string" },
+                            kind: { type: "string" },
+                            outputExt: { type: "string" },
+                            outputName: { type: "string" },
+                            dependsOn: { type: "array", items: { type: "string" } },
+                            syncFs: { type: "boolean" },
+                            maxTimeLimit: { type: "number" },
+                            maxSpendLimit: { type: "number" },
+                        },
+                    },
+                },
+                name: {
+                    type: "string",
+                    description: "Only run sources whose `name` matches exactly (config mode).",
+                },
+                filter: {
+                    type: "string",
+                    description: "Only run sources whose name/input/output contains this substring.",
+                },
+                force: {
+                    type: "boolean",
+                    description: "Skip hash checks and regenerate all matching sources.",
+                },
+                concurrency: {
+                    type: "number",
+                    description: "Max sources to run in parallel within a dependency wave. Default: 3.",
+                },
+                syncFs: {
+                    type: "boolean",
+                    description: "For agent-driven sources, create .knowhow/processes/agents/<taskId>/ so they appear in `knowhow agents list`. " +
+                        "Defaults to true (enabled). Pass false to opt out.",
+                },
+                syncRemote: {
+                    type: "boolean",
+                    description: "For agent-driven sources, push their work to a remote Knowhow task (identified by the source's taskId), " +
+                        "in addition to fs sync.",
+                },
+                planOnly: {
+                    type: "boolean",
+                    description: "Return the wave execution plan without running anything (requires `sources`).",
+                },
+            },
+            required: [],
+        },
+    },
+};
+//# sourceMappingURL=runGenerate.js.map

package/ts_build/src/agents/tools/runGenerate.js.map

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

package/ts_build/src/agents/tools/sendAgentMessage.d.ts

@@ -0,0 +1,11 @@
+import { Tool } from "../../clients/types";
+import { ToolCallContext } from "../../services/Tools";
+export interface SendAgentMessageParams {
+    taskId: string;
+    message: string;
+    from?: string;
+    poke?: boolean;
+    _ctx?: ToolCallContext;
+}
+export declare function sendAgentMessage(params: SendAgentMessageParams): Promise<string>;
+export declare const sendAgentMessageDefinition: Tool;

package/ts_build/src/agents/tools/sendAgentMessage.js

@@ -0,0 +1,118 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sendAgentMessageDefinition = void 0;
+exports.sendAgentMessage = sendAgentMessage;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+function agentsDir() {
+    return path.join(process.cwd(), ".knowhow", "processes", "agents");
+}
+function appendToInput(inputPath, line) {
+    const existing = fs.existsSync(inputPath)
+        ? fs.readFileSync(inputPath, "utf8")
+        : "";
+    const next = existing && !existing.endsWith("\n")
+        ? `${existing}\n${line}\n`
+        : `${existing}${line}\n`;
+    fs.writeFileSync(inputPath, next, "utf8");
+}
+async function sendAgentMessage(params) {
+    const { taskId, message, from, poke = false, _ctx } = params;
+    if (!taskId) {
+        return "sendAgentMessage: taskId is required.";
+    }
+    if (!message || !message.trim()) {
+        return "sendAgentMessage: message is required.";
+    }
+    const targetDir = path.join(agentsDir(), taskId);
+    const inputPath = path.join(targetDir, "input.txt");
+    if (!fs.existsSync(targetDir)) {
+        return `sendAgentMessage: target task directory not found: ${targetDir}`;
+    }
+    const fromId = from ??
+        _ctx?.taskId ??
+        _ctx?.caller?.currentTaskId ??
+        "unknown";
+    const fromAgent = _ctx?.caller?.name;
+    const fromLabel = fromAgent ? `${fromId}/${fromAgent}` : fromId;
+    try {
+        if (poke) {
+            appendToInput(inputPath, `/poke [from:${fromLabel}] ${message}`);
+        }
+        else {
+            appendToInput(inputPath, `[from:${fromLabel}] ${message}`);
+        }
+    }
+    catch (e) {
+        return `sendAgentMessage: failed to write to ${inputPath}: ${e?.message ?? String(e)}`;
+    }
+    return `Sent message to task ${taskId}${poke ? " (as /poke)" : ""}.`;
+}
+exports.sendAgentMessageDefinition = {
+    type: "function",
+    function: {
+        name: "sendAgentMessage",
+        description: "Send a message to another running agent (a child you spawned, a peer, or your parent) by " +
+            "appending it to that agent's input queue. The recipient picks it up on its next sync cycle " +
+            "as a user message. This is the down/lateral communication edge (complement to replyToParent). " +
+            "Set poke:true to interrupt the recipient's current step (delivered as /poke). Your sender " +
+            "identity is attached automatically so the recipient can reply back to you.",
+        parameters: {
+            type: "object",
+            positional: false,
+            properties: {
+                taskId: {
+                    type: "string",
+                    description: "The taskId of the agent to send the message to.",
+                },
+                message: {
+                    type: "string",
+                    description: "The message to deliver to the recipient agent.",
+                },
+                from: {
+                    type: "string",
+                    description: "Optional sender id. Defaults to the calling agent's own taskId.",
+                },
+                poke: {
+                    type: "boolean",
+                    description: "When true, deliver as a /poke that interrupts the recipient's current step. Default false.",
+                },
+            },
+            required: ["taskId", "message"],
+        },
+    },
+};
+//# sourceMappingURL=sendAgentMessage.js.map

package/ts_build/src/agents/tools/sendAgentMessage.js.map

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

package/ts_build/src/agents/tools/startAgentTask.d.ts

@@ -5,12 +5,19 @@ export interface StartAgentTaskParams {
     taskId?: string;
     resume?: boolean;
     prompt: string;
+    syncRemote?: boolean;
     provider?: string;
     model?: string;
     agentName?: string;
     maxTimeLimit?: number;
     maxSpendLimit?: number;
     waitForCompletion?: boolean;
+    parentTaskId?: string;
+    _ctx?: {
+        caller?: any;
+        taskId?: string;
+        [key: string]: any;
+    };
 }
 export declare function startAgentTask(params: StartAgentTaskParams): Promise<string>;
 export declare const startAgentTaskDefinition: Tool;

package/ts_build/src/agents/tools/startAgentTask.js

@@ -52,21 +52,50 @@ function generateTaskId(prompt) {
     const fullId = `${epochSeconds}-${wordPart}`;
     return fullId.slice(0, 80);
 }
+function subagentCapabilitiesNote() {
+    const lines = [
+        "",
+        "---",
+        "SUBAGENT ORCHESTRATION CAPABILITIES:",
+        "You are running as a knowhow agent with a synchronized task directory. In addition to your tools,",
+        "you can shell out (via execCommand) to the `knowhow agents` CLI to coordinate and inspect other agents:",
+        "  • knowhow agents list                 — list running/recent agent tasks (with row indexes)",
+        "  • knowhow agents status <id|-i N>      — status, cost, last tool/message for a task",
+        "  • knowhow agents tail <id|-i N> [-f]   — read recent messages (read-only; -f to follow live)",
+        "  • knowhow agents answer <id|-i N>      — print the final answer of a COMPLETED task",
+        "  • knowhow agents attach <id|-i N>      — open the interactive chat attached to a running task",
+        "You can spawn more subagents with the startAgentTask tool, or run whole pipelines with the runGenerate tool",
+        "(supports dependsOn ordering, per-source agents, and concurrency for map/reduce fan-out).",
+        "To coordinate spawned subagents from your tools: use waitForAgentCompleted (join a subagent and",
+        "get a structured { status, costUsd, finalAnswer } result) and observe (stream a tool's results",
+        "back to yourself on an interval, e.g. observe waitForAgentCompleted or `agents status`).",
+        "To communicate with running agents: use sendAgentMessage (send a message or /poke to a child/peer/parent),",
+        "replyToParent (report back to whoever spawned you), and connectAgent (wire agents together with an ARRAY",
+        "of { listener, speaker } connections — enables bidirectional, pipeline, star, and mesh topologies in one call).",
+    ];
+    lines.push("---", "");
+    return lines.join("\n");
+}
 async function startAgentTask(params) {
-    const { messageId, prompt, taskId: providedTaskId, resume, syncFs, provider, model, agentName, maxTimeLimit, maxSpendLimit, waitForCompletion, } = params;
+    const { messageId, prompt, taskId: providedTaskId, resume, syncFs, syncRemote, provider, model, agentName, maxTimeLimit, maxSpendLimit, waitForCompletion, parentTaskId: explicitParentTaskId, _ctx, } = params;
     if (!prompt) {
         throw new Error("prompt is required to create a chat task");
     }
+    const useSyncFs = syncFs !== false && !messageId;
     const taskId = providedTaskId ?? generateTaskId(prompt);
     const agentTaskDir = path.join(AGENTS_DIR, taskId);
+    const parentTaskId = explicitParentTaskId ?? _ctx?.taskId ?? _ctx?.caller?.currentTaskId;
     const args = ["agent"];
     if (messageId) {
         args.push("--message-id", messageId);
     }
-    else if (syncFs) {
+    else if (useSyncFs) {
         args.push("--sync-fs");
     }
-    if (syncFs || providedTaskId) {
+    if (syncRemote) {
+        args.push("--sync-remote");
+    }
+    if (useSyncFs || providedTaskId) {
         args.push("--task-id", taskId);
     }
     if (provider) {
@@ -84,6 +113,9 @@ async function startAgentTask(params) {
     if (maxSpendLimit !== undefined) {
         args.push("--max-spend-limit", String(maxSpendLimit));
     }
+    if (parentTaskId) {
+        args.push("--parent-task-id", parentTaskId);
+    }
     if (resume) {
         args.push("--resume");
     }
@@ -102,7 +134,10 @@ async function startAgentTask(params) {
     });
     const pid = child.pid;
     fs.writeSync(fd, `PID: ${pid}\n`);
-    child.stdin.write(prompt, "utf8");
+    const promptWithCaps = resume
+        ? prompt
+        : prompt + subagentCapabilitiesNote();
+    child.stdin.write(promptWithCaps, "utf8");
     child.stdin.end();
     return new Promise((resolve) => {
         let settled = false;
@@ -119,7 +154,7 @@ async function startAgentTask(params) {
         child.once("error", (e) => {
             done(`Failed to start agent: ${String(e)}\nLogs: ${logPath}`);
         });
-        const syncFsNote = syncFs
+        const syncFsNote = useSyncFs
             ? `\nTask ID: ${taskId}\nAgent dir: ${agentTaskDir}\n` +
                 `To send agent messages, write to: ${agentTaskDir}/input.txt\n` +
                 `To check status, read: ${agentTaskDir}/status.txt\n`
@@ -159,7 +194,14 @@ exports.startAgentTaskDefinition = {
                 },
                 syncFs: {
                     type: "boolean",
-                    description: "Enable filesystem-based synchronization for the task. Use this when no messageId is available.",
+                    description: "Filesystem-based synchronization for the task. Defaults to true (enabled) when no messageId is given, " +
+                        "so the spawned agent always appears in `knowhow agents list` and can be attached/tailed. Pass false to opt out.",
+                },
+                syncRemote: {
+                    type: "boolean",
+                    description: "Push this agent's work to a remote Knowhow task identified by taskId (in addition to fs sync). " +
+                        "Use this to sync a spawned subagent's progress to an already-created remote task. " +
+                        "If messageId is given instead, a fresh remote task is created from that message.",
                 },
                 prompt: {
                     type: "string",
@@ -193,6 +235,11 @@ exports.startAgentTaskDefinition = {
                     type: "boolean",
                     description: "Resume a previously started task from where it left off. Must be used together with taskId which identifies the task to resume.",
                 },
+                parentTaskId: {
+                    type: "string",
+                    description: "The taskId of the parent that should be notified by this child (e.g. via replyToParent). " +
+                        "If omitted, it is auto-populated from the spawning agent's own taskId.",
+                },
             },
             required: ["prompt"],
         },

package/ts_build/src/agents/tools/startAgentTask.js.map

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

package/ts_build/src/agents/tools/waitForAgentCompleted.d.ts

@@ -0,0 +1,10 @@
+import { Tool } from "../../clients/types";
+import { ToolCallContext } from "../../services/Tools";
+export interface WaitForAgentCompletedParams {
+    taskId: string;
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+    _ctx?: ToolCallContext;
+}
+export declare function waitForAgentCompleted(params: WaitForAgentCompletedParams): Promise<string>;
+export declare const waitForAgentCompletedDefinition: Tool;