@tyvm/knowhow 0.0.138 → 0.0.141

package/ts_build/tests/agents/tools/observe.test.js

@@ -0,0 +1,148 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const observe_1 = require("../../../src/agents/tools/observe");
+describe("observe / stopObserving", () => {
+    const delay = (ms) => new Promise((r) => setTimeout(r, ms));
+    function makeCaller() {
+        const messages = [];
+        const observations = new Map();
+        let seq = 0;
+        const done = "done";
+        const caller = {
+            currentTaskId: "task-x",
+            name: "Tester",
+            status: "in_progress",
+            getEnabledToolNames: () => ["fakeTool"],
+            addPendingMessage: (m) => messages.push(m),
+            observe(source, opts = {}) {
+                const { onlyOnChange = true, maxUpdates = 20, maxDurationMs = 10 * 60 * 1000, } = opts;
+                seq += 1;
+                const safeLabel = source.label.replace(/[^A-Za-z0-9]+/g, "_").slice(0, 24);
+                const id = `obs_${safeLabel}_${Date.now()}_${seq}`;
+                let last;
+                const emit = (datum) => {
+                    if (caller.status === done) {
+                        caller.stopObserving(id);
+                        return;
+                    }
+                    const str = typeof datum === "string" ? datum : JSON.stringify(datum);
+                    if (onlyOnChange && str === last)
+                        return;
+                    last = str;
+                    const obs = observations.get(id);
+                    if (!obs)
+                        return;
+                    obs.updates += 1;
+                    caller.addPendingMessage({
+                        role: "user",
+                        content: `[observe:${id}] ${source.label} (update ${obs.updates}/${maxUpdates}):\n${str}`,
+                    });
+                    if (obs.updates >= maxUpdates)
+                        caller.stopObserving(id, "max updates reached");
+                };
+                const teardownPromise = Promise.resolve(source.start(emit));
+                const expiry = maxDurationMs
+                    ? setTimeout(() => caller.stopObserving(id, "max duration reached"), maxDurationMs)
+                    : undefined;
+                expiry?.unref?.();
+                observations.set(id, { id, label: source.label, updates: 0, teardownPromise, expiry });
+                return id;
+            },
+            stopObserving(id, reason = "stopped") {
+                const ids = id ? [id] : [...observations.keys()];
+                let stopped = 0;
+                for (const oid of ids) {
+                    const obs = observations.get(oid);
+                    if (!obs)
+                        continue;
+                    if (obs.expiry)
+                        clearTimeout(obs.expiry);
+                    Promise.resolve(obs.teardownPromise).then((fn) => typeof fn === "function" && fn());
+                    observations.delete(oid);
+                    stopped += 1;
+                }
+                return id
+                    ? stopped
+                        ? `Stopped observer ${id} (${reason}).`
+                        : `No active observer found with id: ${id}.`
+                    : `Stopped ${stopped} active observer(s) (${reason}).`;
+            },
+        };
+        return { caller, messages };
+    }
+    function makeCtx(toolResults) {
+        const { caller, messages } = makeCaller();
+        let call = 0;
+        const Tools = {
+            callTool: jest.fn(async () => {
+                const r = toolResults[Math.min(call, toolResults.length - 1)];
+                call++;
+                return r;
+            }),
+        };
+        return { _ctx: { caller, Tools }, messages, Tools, caller };
+    }
+    it("requires toolName", async () => {
+        const res = await (0, observe_1.observe)({ toolName: "" });
+        expect(res).toMatch(/toolName is required/);
+    });
+    it("errors without a ToolsService on _ctx", async () => {
+        const res = await (0, observe_1.observe)({ toolName: "fakeTool", _ctx: { caller: {} } });
+        expect(res).toMatch(/no ToolsService/);
+    });
+    it("errors without a caller on _ctx", async () => {
+        const res = await (0, observe_1.observe)({
+            toolName: "fakeTool",
+            _ctx: { Tools: { callTool: jest.fn() } },
+        });
+        expect(res).toMatch(/no calling agent/);
+    });
+    it("polls the tool and delivers changed results to the caller", async () => {
+        const { _ctx, messages, Tools } = makeCtx(["a", "b", "b", "c"]);
+        const res = await (0, observe_1.observe)({
+            toolName: "fakeTool",
+            intervalMs: 500,
+            maxUpdates: 4,
+            _ctx: _ctx,
+        });
+        expect(res).toMatch(/Started observing/);
+        await delay(2400);
+        expect(Tools.callTool).toHaveBeenCalled();
+        const updateMsgs = messages.filter((m) => String(m.content).includes("[observe:"));
+        expect(updateMsgs.length).toBeGreaterThanOrEqual(3);
+    });
+    it("can be stopped early via stopObserving with the returned id", async () => {
+        const { _ctx, messages } = makeCtx(["x", "y", "z"]);
+        const res = await (0, observe_1.observe)({
+            toolName: "fakeTool",
+            intervalMs: 500,
+            maxUpdates: 20,
+            _ctx: _ctx,
+        });
+        const idMatch = res.match(/id: (obs_[^)]+)\)/);
+        expect(idMatch).toBeTruthy();
+        const id = idMatch[1];
+        await delay(600);
+        const stopRes = await (0, observe_1.stopObserving)({ id, _ctx: _ctx });
+        expect(stopRes).toContain(`Stopped observer ${id}`);
+        const before = messages.length;
+        await delay(1000);
+        expect(messages.length).toBe(before);
+    });
+    it("stopObserving with no id stops all observers on that agent", async () => {
+        const { _ctx } = makeCtx(["1"]);
+        await (0, observe_1.observe)({ toolName: "fakeTool", intervalMs: 1000, _ctx: _ctx });
+        const res = await (0, observe_1.stopObserving)({ _ctx: _ctx });
+        expect(res).toMatch(/Stopped \d+ active observer/);
+    });
+    it("stopObserving on an unknown id returns a helpful message", async () => {
+        const { _ctx } = makeCtx(["1"]);
+        const res = await (0, observe_1.stopObserving)({ id: "obs_does_not_exist", _ctx: _ctx });
+        expect(res).toMatch(/No active observer found/);
+    });
+    it("errors without a caller on _ctx for stopObserving", async () => {
+        const res = await (0, observe_1.stopObserving)({ id: "x" });
+        expect(res).toMatch(/no calling agent/);
+    });
+});
+//# sourceMappingURL=observe.test.js.map

package/ts_build/tests/agents/tools/observe.test.js.map

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

package/ts_build/tests/agents/tools/replyToParent.test.d.ts

@@ -0,0 +1 @@
+export {};

package/ts_build/tests/agents/tools/replyToParent.test.js

@@ -0,0 +1,116 @@
+"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 });
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const replyToParent_1 = require("../../../src/agents/tools/replyToParent");
+describe("replyToParent (_ctx self-referential tool)", () => {
+    let tmpCwd;
+    let originalCwd;
+    let agentsDir;
+    beforeEach(() => {
+        originalCwd = process.cwd();
+        tmpCwd = fs.mkdtempSync(path.join(os.tmpdir(), "reply-parent-"));
+        process.chdir(tmpCwd);
+        agentsDir = path.join(tmpCwd, ".knowhow", "processes", "agents");
+        fs.mkdirSync(agentsDir, { recursive: true });
+    });
+    afterEach(() => {
+        process.chdir(originalCwd);
+        fs.rmSync(tmpCwd, { recursive: true, force: true });
+    });
+    function makeTask(taskId, meta = {}) {
+        const dir = path.join(agentsDir, taskId);
+        fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(path.join(dir, "input.txt"), "", "utf8");
+        fs.writeFileSync(path.join(dir, "metadata.json"), JSON.stringify({ taskId, ...meta }, null, 2), "utf8");
+        return dir;
+    }
+    it("returns a helpful message when there is no parent", async () => {
+        makeTask("child-1");
+        const result = await (0, replyToParent_1.replyToParent)("hi", { taskId: "child-1" });
+        expect(result).toMatch(/No parent task found/);
+    });
+    it("uses parentTaskId directly from _ctx when provided", async () => {
+        const parentDir = makeTask("parent-1");
+        makeTask("child-2", { parentTaskId: "parent-1" });
+        const result = await (0, replyToParent_1.replyToParent)("progress update", {
+            taskId: "child-2",
+            parentTaskId: "parent-1",
+        });
+        expect(result).toMatch(/Sent message to parent task parent-1/);
+        const parentInput = fs.readFileSync(path.join(parentDir, "input.txt"), "utf8");
+        expect(parentInput).toContain("progress update");
+        expect(parentInput).toContain("[from:child-2]");
+    });
+    it("falls back to reading parentTaskId from the caller's metadata.json", async () => {
+        const parentDir = makeTask("parent-2");
+        makeTask("child-3", { parentTaskId: "parent-2" });
+        const result = await (0, replyToParent_1.replyToParent)("need help", { taskId: "child-3" });
+        expect(result).toMatch(/Sent message to parent task parent-2/);
+        const parentInput = fs.readFileSync(path.join(parentDir, "input.txt"), "utf8");
+        expect(parentInput).toContain("need help");
+    });
+    it("reads taskId/name off _ctx.caller when taskId not set directly", async () => {
+        const parentDir = makeTask("parent-3");
+        makeTask("child-4", { parentTaskId: "parent-3" });
+        const fakeAgent = { currentTaskId: "child-4", name: "Researcher" };
+        const result = await (0, replyToParent_1.replyToParent)("done researching", {
+            caller: fakeAgent,
+        });
+        expect(result).toMatch(/Sent message to parent task parent-3/);
+        const parentInput = fs.readFileSync(path.join(parentDir, "input.txt"), "utf8");
+        expect(parentInput).toContain("[agent:Researcher]");
+        expect(parentInput).toContain("done researching");
+    });
+    it("appends rather than clobbers existing parent input", async () => {
+        const parentDir = makeTask("parent-4");
+        fs.writeFileSync(path.join(parentDir, "input.txt"), "existing message\n", "utf8");
+        makeTask("child-5", { parentTaskId: "parent-4" });
+        await (0, replyToParent_1.replyToParent)("second message", {
+            taskId: "child-5",
+            parentTaskId: "parent-4",
+        });
+        const parentInput = fs.readFileSync(path.join(parentDir, "input.txt"), "utf8");
+        expect(parentInput).toContain("existing message");
+        expect(parentInput).toContain("second message");
+    });
+    it("returns error for empty message", async () => {
+        const result = await (0, replyToParent_1.replyToParent)("   ", { taskId: "whatever" });
+        expect(result).toMatch(/No message provided/);
+    });
+});
+//# sourceMappingURL=replyToParent.test.js.map

package/ts_build/tests/agents/tools/replyToParent.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replyToParent.test.js","sourceRoot":"","sources":["../../../../tests/agents/tools/replyToParent.test.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uCAAyB;AACzB,uCAAyB;AACzB,2CAA6B;AAC7B,2EAAwE;AAQxE,QAAQ,CAAC,4CAA4C,EAAE,GAAG,EAAE;IAC1D,IAAI,MAAc,CAAC;IACnB,IAAI,WAAmB,CAAC;IACxB,IAAI,SAAiB,CAAC;IAEtB,UAAU,CAAC,GAAG,EAAE;QACd,WAAW,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAC5B,MAAM,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,eAAe,CAAC,CAAC,CAAC;QACjE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACtB,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;QACjE,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAC3B,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,SAAS,QAAQ,CAAC,MAAc,EAAE,OAA4B,EAAE;QAC9D,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QACzC,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvC,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;QAC1D,EAAE,CAAC,aAAa,CACd,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,EAC/B,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAC5C,MAAM,CACP,CAAC;QACF,OAAO,GAAG,CAAC;IACb,CAAC;IAED,EAAE,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;QACjE,QAAQ,CAAC,SAAS,CAAC,CAAC;QACpB,MAAM,MAAM,GAAG,MAAM,IAAA,6BAAa,EAAC,IAAI,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QAChE,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;QAClE,MAAM,SAAS,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;QACvC,QAAQ,CAAC,SAAS,EAAE,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC,CAAC;QAElD,MAAM,MAAM,GAAG,MAAM,IAAA,6BAAa,EAAC,iBAAiB,EAAE;YACpD,MAAM,EAAE,SAAS;YACjB,YAAY,EAAE,UAAU;SACzB,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,sCAAsC,CAAC,CAAC;QAC/D,MAAM,WAAW,GAAG,EAAE,CAAC,YAAY,CACjC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,EACjC,MAAM,CACP,CAAC;QACF,MAAM,CAAC,WAAW,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;QACjD,MAAM,CAAC,WAAW,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oEAAoE,EAAE,KAAK,IAAI,EAAE;QAClF,MAAM,SAAS,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;QACvC,QAAQ,CAAC,SAAS,EAAE,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC,CAAC;QAGlD,MAAM,MAAM,GAAG,MAAM,IAAA,6BAAa,EAAC,WAAW,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QAEvE,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,sCAAsC,CAAC,CAAC;QAC/D,MAAM,WAAW,GAAG,EAAE,CAAC,YAAY,CACjC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,EACjC,MAAM,CACP,CAAC;QACF,MAAM,CAAC,WAAW,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gEAAgE,EAAE,KAAK,IAAI,EAAE;QAC9E,MAAM,SAAS,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;QACvC,QAAQ,CAAC,SAAS,EAAE,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC,CAAC;QAElD,MAAM,SAAS,GAAG,EAAE,aAAa,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;QACnE,MAAM,MAAM,GAAG,MAAM,IAAA,6BAAa,EAAC,kBAAkB,EAAE;YACrD,MAAM,EAAE,SAAS;SAClB,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,sCAAsC,CAAC,CAAC;QAC/D,MAAM,WAAW,GAAG,EAAE,CAAC,YAAY,CACjC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,EACjC,MAAM,CACP,CAAC;QACF,MAAM,CAAC,WAAW,CAAC,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;QACpD,MAAM,CAAC,WAAW,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;QAClE,MAAM,SAAS,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;QACvC,EAAE,CAAC,aAAa,CACd,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,EACjC,oBAAoB,EACpB,MAAM,CACP,CAAC;QACF,QAAQ,CAAC,SAAS,EAAE,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC,CAAC;QAElD,MAAM,IAAA,6BAAa,EAAC,gBAAgB,EAAE;YACpC,MAAM,EAAE,SAAS;YACjB,YAAY,EAAE,UAAU;SACzB,CAAC,CAAC;QAEH,MAAM,WAAW,GAAG,EAAE,CAAC,YAAY,CACjC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,EACjC,MAAM,CACP,CAAC;QACF,MAAM,CAAC,WAAW,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;QAClD,MAAM,CAAC,WAAW,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,KAAK,IAAI,EAAE;QAC/C,MAAM,MAAM,GAAG,MAAM,IAAA,6BAAa,EAAC,KAAK,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;QAClE,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/ts_build/tests/agents/tools/sendAgentMessage.test.d.ts

@@ -0,0 +1 @@
+export {};

package/ts_build/tests/agents/tools/sendAgentMessage.test.js

@@ -0,0 +1,112 @@
+"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 });
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const sendAgentMessage_1 = require("../../../src/agents/tools/sendAgentMessage");
+describe("sendAgentMessage", () => {
+    let tmpCwd;
+    let originalCwd;
+    let agentsDir;
+    beforeEach(() => {
+        originalCwd = process.cwd();
+        tmpCwd = fs.mkdtempSync(path.join(os.tmpdir(), "send-msg-"));
+        process.chdir(tmpCwd);
+        agentsDir = path.join(tmpCwd, ".knowhow", "processes", "agents");
+        fs.mkdirSync(agentsDir, { recursive: true });
+    });
+    afterEach(() => {
+        process.chdir(originalCwd);
+        fs.rmSync(tmpCwd, { recursive: true, force: true });
+    });
+    function makeTask(taskId) {
+        const dir = path.join(agentsDir, taskId);
+        fs.mkdirSync(dir, { recursive: true });
+        return dir;
+    }
+    it("requires taskId and message", async () => {
+        expect(await (0, sendAgentMessage_1.sendAgentMessage)({ taskId: "", message: "hi" })).toMatch(/taskId is required/);
+        expect(await (0, sendAgentMessage_1.sendAgentMessage)({ taskId: "x", message: "" })).toMatch(/message is required/);
+    });
+    it("errors when the target task dir doesn't exist", async () => {
+        const res = await (0, sendAgentMessage_1.sendAgentMessage)({ taskId: "nope", message: "hi" });
+        expect(res).toMatch(/target task directory not found/);
+    });
+    it("appends an envelope with sender identity from _ctx", async () => {
+        makeTask("child-1");
+        const res = await (0, sendAgentMessage_1.sendAgentMessage)({
+            taskId: "child-1",
+            message: "do the thing",
+            _ctx: { taskId: "parent-1", caller: { name: "Developer" } },
+        });
+        expect(res).toMatch(/Sent message to task child-1/);
+        const input = fs.readFileSync(path.join(agentsDir, "child-1", "input.txt"), "utf8");
+        expect(input).toContain("[from:parent-1/Developer] do the thing");
+    });
+    it("uses explicit from when provided", async () => {
+        makeTask("child-2");
+        await (0, sendAgentMessage_1.sendAgentMessage)({
+            taskId: "child-2",
+            message: "msg",
+            from: "orchestrator",
+        });
+        const input = fs.readFileSync(path.join(agentsDir, "child-2", "input.txt"), "utf8");
+        expect(input).toContain("[from:orchestrator] msg");
+    });
+    it("delivers as /poke when poke:true (interrupts recipient)", async () => {
+        makeTask("child-3");
+        await (0, sendAgentMessage_1.sendAgentMessage)({
+            taskId: "child-3",
+            message: "stop and reconsider",
+            from: "boss",
+            poke: true,
+        });
+        const input = fs.readFileSync(path.join(agentsDir, "child-3", "input.txt"), "utf8");
+        expect(input).toMatch(/^\/poke \[from:boss\] stop and reconsider/);
+    });
+    it("appends without clobbering existing pending messages", async () => {
+        const dir = makeTask("child-4");
+        fs.writeFileSync(path.join(dir, "input.txt"), "existing line\n", "utf8");
+        await (0, sendAgentMessage_1.sendAgentMessage)({
+            taskId: "child-4",
+            message: "second",
+            from: "a",
+        });
+        const input = fs.readFileSync(path.join(dir, "input.txt"), "utf8");
+        expect(input).toBe("existing line\n[from:a] second\n");
+    });
+});
+//# sourceMappingURL=sendAgentMessage.test.js.map

package/ts_build/tests/agents/tools/sendAgentMessage.test.js.map

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

package/ts_build/tests/agents/tools/waitForAgentCompleted.test.d.ts

@@ -0,0 +1 @@
+export {};

package/ts_build/tests/agents/tools/waitForAgentCompleted.test.js

@@ -0,0 +1,147 @@
+"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 });
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const waitForAgentCompleted_1 = require("../../../src/agents/tools/waitForAgentCompleted");
+describe("waitForAgentCompleted", () => {
+    let tmpCwd;
+    let originalCwd;
+    let agentsDir;
+    beforeEach(() => {
+        originalCwd = process.cwd();
+        tmpCwd = fs.mkdtempSync(path.join(os.tmpdir(), "wait-agent-"));
+        process.chdir(tmpCwd);
+        agentsDir = path.join(tmpCwd, ".knowhow", "processes", "agents");
+        fs.mkdirSync(agentsDir, { recursive: true });
+    });
+    afterEach(() => {
+        process.chdir(originalCwd);
+        fs.rmSync(tmpCwd, { recursive: true, force: true });
+    });
+    function makeTask(taskId, meta = {}, status) {
+        const dir = path.join(agentsDir, taskId);
+        fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(path.join(dir, "metadata.json"), JSON.stringify({ taskId, ...meta }, null, 2), "utf8");
+        if (status !== undefined) {
+            fs.writeFileSync(path.join(dir, "status.txt"), status, "utf8");
+        }
+        return dir;
+    }
+    it("returns error when taskId missing", async () => {
+        const res = JSON.parse(await (0, waitForAgentCompleted_1.waitForAgentCompleted)({ taskId: "" }));
+        expect(res.status).toBe("error");
+        expect(res.error).toMatch(/taskId is required/);
+    });
+    it("returns error when task directory does not exist", async () => {
+        const res = JSON.parse(await (0, waitForAgentCompleted_1.waitForAgentCompleted)({ taskId: "nope" }));
+        expect(res.status).toBe("error");
+        expect(res.error).toMatch(/No agent task directory/);
+    });
+    it("returns immediately with structured result for a completed task", async () => {
+        makeTask("done-1", {
+            status: "completed",
+            totalCostUsd: 1.23,
+            result: "the final answer",
+            artifacts: ["a.txt"],
+        });
+        const res = JSON.parse(await (0, waitForAgentCompleted_1.waitForAgentCompleted)({ taskId: "done-1" }));
+        expect(res.status).toBe("completed");
+        expect(res.costUsd).toBe(1.23);
+        expect(res.finalAnswer).toBe("the final answer");
+        expect(res.artifacts).toEqual(["a.txt"]);
+    });
+    it("falls back to last assistant message when no result field", async () => {
+        makeTask("done-2", {
+            status: "completed",
+            totalCostUsd: 0.5,
+            threads: [
+                [
+                    { role: "user", content: "do it" },
+                    { role: "assistant", content: "I did it" },
+                ],
+            ],
+        });
+        const res = JSON.parse(await (0, waitForAgentCompleted_1.waitForAgentCompleted)({ taskId: "done-2" }));
+        expect(res.finalAnswer).toBe("I did it");
+    });
+    it("treats inProgress:false with no status as completed", async () => {
+        makeTask("done-3", { inProgress: false, totalCostUsd: 0.1, result: "ok" });
+        const res = JSON.parse(await (0, waitForAgentCompleted_1.waitForAgentCompleted)({ taskId: "done-3" }));
+        expect(res.status).toBe("completed");
+    });
+    it("times out on a still-running task", async () => {
+        makeTask("running-1", { status: "running", totalCostUsd: 0.2 });
+        const res = JSON.parse(await (0, waitForAgentCompleted_1.waitForAgentCompleted)({
+            taskId: "running-1",
+            timeoutMs: 300,
+            pollIntervalMs: 100,
+        }));
+        expect(res.timedOut).toBe(true);
+        expect(res.status).toBe("running");
+        expect(res.costUsd).toBe(0.2);
+    });
+    it("resolves when a running task transitions to completed mid-poll", async () => {
+        const dir = makeTask("running-2", { status: "running", totalCostUsd: 0 });
+        setTimeout(() => {
+            fs.writeFileSync(path.join(dir, "metadata.json"), JSON.stringify({
+                taskId: "running-2",
+                status: "completed",
+                totalCostUsd: 2.0,
+                result: "eventually done",
+            }, null, 2), "utf8");
+        }, 150);
+        const res = JSON.parse(await (0, waitForAgentCompleted_1.waitForAgentCompleted)({
+            taskId: "running-2",
+            timeoutMs: 3000,
+            pollIntervalMs: 100,
+        }));
+        expect(res.status).toBe("completed");
+        expect(res.finalAnswer).toBe("eventually done");
+        expect(res.costUsd).toBe(2.0);
+    });
+    it("fails a task whose pid is dead without a terminal status", async () => {
+        makeTask("crashed-1", { status: "running", totalCostUsd: 0.3, pid: 999999 });
+        const res = JSON.parse(await (0, waitForAgentCompleted_1.waitForAgentCompleted)({
+            taskId: "crashed-1",
+            timeoutMs: 5000,
+            pollIntervalMs: 100,
+        }));
+        expect(res.status).toBe("failed");
+        expect(res.error).toMatch(/exited without writing a terminal status/);
+    });
+});
+//# sourceMappingURL=waitForAgentCompleted.test.js.map

package/ts_build/tests/agents/tools/waitForAgentCompleted.test.js.map

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

package/ts_build/tests/chat/detach-attach-rendering.test.d.ts

@@ -0,0 +1 @@
+export {};