daycare-cli 0.0.0-canary.08d0b9e

package/dist/engine/heartbeat/ops/heartbeatScheduler.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeatScheduler.spec.d.ts","sourceRoot":"","sources":["../../../../sources/engine/heartbeat/ops/heartbeatScheduler.spec.ts"],"names":[],"mappings":""}

package/dist/engine/heartbeat/ops/heartbeatScheduler.spec.js

@@ -0,0 +1,255 @@
+import { mkdtemp, rm } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { configResolve } from "../../../config/configResolve.js";
+import { Storage } from "../../../storage/storage.js";
+import { ConfigModule } from "../../config/configModule.js";
+import { HeartbeatScheduler } from "./heartbeatScheduler.js";
+async function createTempScheduler() {
+    const dir = await mkdtemp(path.join(os.tmpdir(), "daycare-heartbeat-"));
+    const storage = Storage.open(":memory:");
+    return { dir, storage };
+}
+describe("HeartbeatScheduler", () => {
+    const temps = [];
+    const storages = [];
+    const configModule = (workingDir) => new ConfigModule(configResolve({ engine: { dataDir: workingDir } }, path.join(workingDir, "settings.json")));
+    afterEach(async () => {
+        await Promise.all(temps.map((dir) => rm(dir, { recursive: true, force: true })));
+        temps.length = 0;
+        for (const storage of storages) {
+            storage.close();
+        }
+        storages.length = 0;
+    });
+    it("runs all tasks in a single batch", async () => {
+        const { dir, storage } = await createTempScheduler();
+        temps.push(dir);
+        storages.push(storage);
+        const onRun = vi.fn();
+        const onTaskComplete = vi.fn();
+        const scheduler = new HeartbeatScheduler({
+            config: configModule(dir),
+            repository: storage.heartbeatTasks,
+            onRun,
+            onTaskComplete,
+            defaultPermissions: defaultPermissions(dir)
+        });
+        const taskA = await scheduler.createTask(contextBuild("user-1"), { title: "Alpha", prompt: "Check alpha." });
+        const taskB = await scheduler.createTask(contextBuild("user-1"), { title: "Beta", prompt: "Check beta." });
+        const result = await scheduler.runNow();
+        expect(result.ran).toBe(2);
+        expect(result.taskIds.sort()).toEqual([taskA.id, taskB.id].sort());
+        expect(onRun).toHaveBeenCalledTimes(1);
+        const [runTasks, runAt] = onRun.mock.calls[0];
+        expect(Array.isArray(runTasks)).toBe(true);
+        expect(runAt).toBeInstanceOf(Date);
+        expect(onTaskComplete).toHaveBeenCalledTimes(2);
+        const refreshed = await scheduler.listTasks();
+        expect(refreshed.every((task) => typeof task.lastRunAt === "number")).toBe(true);
+        const [first, ...rest] = refreshed;
+        expect(rest.every((task) => task.lastRunAt === first?.lastRunAt)).toBe(true);
+    });
+    it("filters tasks by id while keeping a single run", async () => {
+        const { dir, storage } = await createTempScheduler();
+        temps.push(dir);
+        storages.push(storage);
+        const onRun = vi.fn();
+        const scheduler = new HeartbeatScheduler({
+            config: configModule(dir),
+            repository: storage.heartbeatTasks,
+            onRun,
+            defaultPermissions: defaultPermissions(dir)
+        });
+        const taskA = await scheduler.createTask(contextBuild("user-1"), { title: "Alpha", prompt: "Check alpha." });
+        await scheduler.createTask(contextBuild("user-1"), { title: "Beta", prompt: "Check beta." });
+        const result = await scheduler.runNow([taskA.id]);
+        expect(result.ran).toBe(1);
+        expect(result.taskIds).toEqual([taskA.id]);
+        expect(onRun).toHaveBeenCalledTimes(1);
+        const [runTasks] = onRun.mock.calls[0];
+        expect(Array.isArray(runTasks)).toBe(true);
+        expect(runTasks.map((task) => task.id)).toEqual([taskA.id]);
+    });
+    it("skips gated tasks when gate check denies", async () => {
+        const { dir, storage } = await createTempScheduler();
+        temps.push(dir);
+        storages.push(storage);
+        const onRun = vi.fn();
+        const gateCheck = vi.fn().mockResolvedValue({
+            shouldRun: false,
+            exitCode: 1,
+            stdout: "",
+            stderr: ""
+        });
+        const scheduler = new HeartbeatScheduler({
+            config: configModule(dir),
+            repository: storage.heartbeatTasks,
+            onRun,
+            gateCheck,
+            defaultPermissions: defaultPermissions(dir)
+        });
+        await scheduler.createTask(contextBuild("user-1"), {
+            title: "Alpha",
+            prompt: "Check alpha.",
+            gate: { command: "echo gate" }
+        });
+        await scheduler.createTask(contextBuild("user-1"), { title: "Beta", prompt: "Check beta." });
+        const result = await scheduler.runNow();
+        expect(gateCheck).toHaveBeenCalledTimes(1);
+        expect(result.ran).toBe(1);
+        expect(result.taskIds).toEqual(["beta"]);
+        expect(onRun).toHaveBeenCalledTimes(1);
+    });
+    it("appends gate output to the prompt", async () => {
+        const { dir, storage } = await createTempScheduler();
+        temps.push(dir);
+        storages.push(storage);
+        const onRun = vi.fn();
+        const gateCheck = vi.fn().mockResolvedValue({
+            shouldRun: true,
+            exitCode: 0,
+            stdout: " ok ",
+            stderr: ""
+        });
+        const scheduler = new HeartbeatScheduler({
+            config: configModule(dir),
+            repository: storage.heartbeatTasks,
+            onRun,
+            gateCheck,
+            defaultPermissions: defaultPermissions(dir)
+        });
+        await scheduler.createTask(contextBuild("user-1"), {
+            title: "Alpha",
+            prompt: "Base prompt",
+            gate: { command: "echo gate" }
+        });
+        const result = await scheduler.runNow();
+        expect(result.ran).toBe(1);
+        const [runTasks] = onRun.mock.calls[0];
+        expect(Array.isArray(runTasks)).toBe(true);
+        const task = runTasks[0];
+        expect(task?.prompt).toBe("Base prompt\n\n[Gate output]\nok");
+    });
+    it("requests missing gate permissions and runs gate after approval", async () => {
+        const { dir, storage } = await createTempScheduler();
+        temps.push(dir);
+        storages.push(storage);
+        const onRun = vi.fn();
+        const gateCheck = vi.fn().mockResolvedValue({
+            shouldRun: true,
+            exitCode: 0,
+            stdout: "",
+            stderr: ""
+        });
+        let networkGranted = false;
+        const resolvePermissions = vi.fn(async () => defaultPermissions(dir, { network: networkGranted }));
+        const onGatePermissionRequest = vi.fn(async () => {
+            networkGranted = true;
+            return true;
+        });
+        const scheduler = new HeartbeatScheduler({
+            config: configModule(dir),
+            repository: storage.heartbeatTasks,
+            onRun,
+            gateCheck,
+            resolvePermissions,
+            onGatePermissionRequest,
+            defaultPermissions: defaultPermissions(dir)
+        });
+        await scheduler.createTask(contextBuild("user-1"), {
+            title: "Needs network",
+            prompt: "Check network.",
+            gate: { command: "echo gate", permissions: ["@network"] }
+        });
+        const result = await scheduler.runNow();
+        expect(result.ran).toBe(1);
+        expect(onGatePermissionRequest).toHaveBeenCalledWith(expect.objectContaining({ title: "Needs network" }), [
+            "@network"
+        ]);
+        expect(resolvePermissions).toHaveBeenCalledTimes(2);
+        expect(gateCheck).toHaveBeenCalledTimes(1);
+        expect(onRun).toHaveBeenCalledTimes(1);
+    });
+    it("skips task when missing gate permissions are denied", async () => {
+        const { dir, storage } = await createTempScheduler();
+        temps.push(dir);
+        storages.push(storage);
+        const onRun = vi.fn();
+        const gateCheck = vi.fn().mockResolvedValue({
+            shouldRun: true,
+            exitCode: 0,
+            stdout: "",
+            stderr: ""
+        });
+        const scheduler = new HeartbeatScheduler({
+            config: configModule(dir),
+            repository: storage.heartbeatTasks,
+            onRun,
+            gateCheck,
+            onGatePermissionRequest: vi.fn(async () => false),
+            defaultPermissions: defaultPermissions(dir)
+        });
+        await scheduler.createTask(contextBuild("user-1"), {
+            title: "Needs network",
+            prompt: "Check network.",
+            gate: { command: "echo gate", permissions: ["@network"] }
+        });
+        const result = await scheduler.runNow();
+        expect(result.ran).toBe(0);
+        expect(result.taskIds).toEqual([]);
+        expect(gateCheck).not.toHaveBeenCalled();
+        expect(onRun).not.toHaveBeenCalled();
+    });
+    it("deletes tasks only for the same ctx user", async () => {
+        const { dir, storage } = await createTempScheduler();
+        temps.push(dir);
+        storages.push(storage);
+        const scheduler = new HeartbeatScheduler({
+            config: configModule(dir),
+            repository: storage.heartbeatTasks,
+            onRun: vi.fn(),
+            defaultPermissions: defaultPermissions(dir)
+        });
+        const task = await scheduler.createTask(contextBuild("user-1"), {
+            title: "Owned task",
+            prompt: "Owned prompt"
+        });
+        await expect(scheduler.deleteTask(contextBuild("user-2"), task.id)).resolves.toBe(false);
+        await expect(scheduler.deleteTask(contextBuild("user-1"), task.id)).resolves.toBe(true);
+    });
+    it("normalizes ctx userId when deleting tasks", async () => {
+        const { dir, storage } = await createTempScheduler();
+        temps.push(dir);
+        storages.push(storage);
+        const scheduler = new HeartbeatScheduler({
+            config: configModule(dir),
+            repository: storage.heartbeatTasks,
+            onRun: vi.fn(),
+            defaultPermissions: defaultPermissions(dir)
+        });
+        const task = await scheduler.createTask(contextBuild("user-1"), {
+            title: "Trim user id",
+            prompt: "Delete using padded ctx user id"
+        });
+        await expect(scheduler.deleteTask(contextBuild("  user-1  "), task.id)).resolves.toBe(true);
+    });
+});
+function defaultPermissions(workingDir, overrides = {}) {
+    return {
+        workingDir,
+        writeDirs: [],
+        readDirs: [],
+        network: false,
+        events: false,
+        ...overrides
+    };
+}
+function contextBuild(userId) {
+    return {
+        agentId: "agent-1",
+        userId
+    };
+}
+//# sourceMappingURL=heartbeatScheduler.spec.js.map

package/dist/engine/heartbeat/ops/heartbeatScheduler.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeatScheduler.spec.js","sourceRoot":"","sources":["../../../../sources/engine/heartbeat/ops/heartbeatScheduler.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE7D,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,KAAK,UAAU,mBAAmB;IAC9B,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,oBAAoB,CAAC,CAAC,CAAC;IACxE,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACzC,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;AAC5B,CAAC;AAED,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAChC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,QAAQ,GAAc,EAAE,CAAC;IAC/B,MAAM,YAAY,GAAG,CAAC,UAAkB,EAAgB,EAAE,CACtD,IAAI,YAAY,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;IAEjH,SAAS,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACjF,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;QACjB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC7B,OAAO,CAAC,KAAK,EAAE,CAAC;QACpB,CAAC;QACD,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IACxB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;QAC9C,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,MAAM,mBAAmB,EAAE,CAAC;QACrD,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChB,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEvB,MAAM,KAAK,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QACtB,MAAM,cAAc,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC/B,MAAM,SAAS,GAAG,IAAI,kBAAkB,CAAC;YACrC,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC;YACzB,UAAU,EAAE,OAAO,CAAC,cAAc;YAClC,KAAK;YACL,cAAc;YACd,kBAAkB,EAAE,kBAAkB,CAAC,GAAG,CAAC;SAC9C,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,UAAU,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;QAC7G,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,UAAU,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;QAE3G,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,CAAC;QAExC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3B,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACnE,MAAM,CAAC,KAAK,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QACvC,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAuB,CAAC;QACpE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,CAAC,cAAc,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAEhD,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,SAAS,EAAE,CAAC;QAC9C,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjF,MAAM,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,GAAG,SAAS,CAAC;QACnC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,KAAK,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;QAC5D,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,MAAM,mBAAmB,EAAE,CAAC;QACrD,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChB,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEvB,MAAM,KAAK,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QACtB,MAAM,SAAS,GAAG,IAAI,kBAAkB,CAAC;YACrC,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC;YACzB,UAAU,EAAE,OAAO,CAAC,cAAc;YAClC,KAAK;YACL,kBAAkB,EAAE,kBAAkB,CAAC,GAAG,CAAC;SAC9C,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,UAAU,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;QAC7G,MAAM,SAAS,CAAC,UAAU,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;QAE7F,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;QAElD,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3B,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;QAC3C,MAAM,CAAC,KAAK,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QACvC,MAAM,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAc,CAAC;QACpD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,CAAE,QAA6B,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IACtF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QACtD,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,MAAM,mBAAmB,EAAE,CAAC;QACrD,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChB,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEvB,MAAM,KAAK,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QACtB,MAAM,SAAS,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;YACxC,SAAS,EAAE,KAAK;YAChB,QAAQ,EAAE,CAAC;YACX,MAAM,EAAE,EAAE;YACV,MAAM,EAAE,EAAE;SACb,CAAC,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,kBAAkB,CAAC;YACrC,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC;YACzB,UAAU,EAAE,OAAO,CAAC,cAAc;YAClC,KAAK;YACL,SAAS;YACT,kBAAkB,EAAE,kBAAkB,CAAC,GAAG,CAAC;SAC9C,CAAC,CAAC;QAEH,MAAM,SAAS,CAAC,UAAU,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE;YAC/C,KAAK,EAAE,OAAO;YACd,MAAM,EAAE,cAAc;YACtB,IAAI,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE;SACjC,CAAC,CAAC;QACH,MAAM,SAAS,CAAC,UAAU,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;QAE7F,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,CAAC;QAExC,MAAM,CAAC,SAAS,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3B,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;QACzC,MAAM,CAAC,KAAK,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;QAC/C,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,MAAM,mBAAmB,EAAE,CAAC;QACrD,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChB,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEvB,MAAM,KAAK,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QACtB,MAAM,SAAS,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;YACxC,SAAS,EAAE,IAAI;YACf,QAAQ,EAAE,CAAC;YACX,MAAM,EAAE,MAAM;YACd,MAAM,EAAE,EAAE;SACb,CAAC,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,kBAAkB,CAAC;YACrC,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC;YACzB,UAAU,EAAE,OAAO,CAAC,cAAc;YAClC,KAAK;YACL,SAAS;YACT,kBAAkB,EAAE,kBAAkB,CAAC,GAAG,CAAC;SAC9C,CAAC,CAAC;QAEH,MAAM,SAAS,CAAC,UAAU,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE;YAC/C,KAAK,EAAE,OAAO;YACd,MAAM,EAAE,aAAa;YACrB,IAAI,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE;SACjC,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,CAAC;QAExC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3B,MAAM,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAc,CAAC;QACpD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,IAAI,GAAI,QAAiC,CAAC,CAAC,CAAC,CAAC;QACnD,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gEAAgE,EAAE,KAAK,IAAI,EAAE;QAC5E,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,MAAM,mBAAmB,EAAE,CAAC;QACrD,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChB,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEvB,MAAM,KAAK,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QACtB,MAAM,SAAS,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;YACxC,SAAS,EAAE,IAAI;YACf,QAAQ,EAAE,CAAC;YACX,MAAM,EAAE,EAAE;YACV,MAAM,EAAE,EAAE;SACb,CAAC,CAAC;QACH,IAAI,cAAc,GAAG,KAAK,CAAC;QAC3B,MAAM,kBAAkB,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,kBAAkB,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC;QACnG,MAAM,uBAAuB,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE;YAC7C,cAAc,GAAG,IAAI,CAAC;YACtB,OAAO,IAAI,CAAC;QAChB,CAAC,CAAC,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,kBAAkB,CAAC;YACrC,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC;YACzB,UAAU,EAAE,OAAO,CAAC,cAAc;YAClC,KAAK;YACL,SAAS;YACT,kBAAkB;YAClB,uBAAuB;YACvB,kBAAkB,EAAE,kBAAkB,CAAC,GAAG,CAAC;SAC9C,CAAC,CAAC;QAEH,MAAM,SAAS,CAAC,UAAU,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE;YAC/C,KAAK,EAAE,eAAe;YACtB,MAAM,EAAE,gBAAgB;YACxB,IAAI,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,UAAU,CAAC,EAAE;SAC5D,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,CAAC;QAExC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3B,MAAM,CAAC,uBAAuB,CAAC,CAAC,oBAAoB,CAAC,MAAM,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC,EAAE;YACtG,UAAU;SACb,CAAC,CAAC;QACH,MAAM,CAAC,kBAAkB,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QACpD,MAAM,CAAC,SAAS,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAC3C,MAAM,CAAC,KAAK,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;QACjE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,MAAM,mBAAmB,EAAE,CAAC;QACrD,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChB,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEvB,MAAM,KAAK,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QACtB,MAAM,SAAS,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;YACxC,SAAS,EAAE,IAAI;YACf,QAAQ,EAAE,CAAC;YACX,MAAM,EAAE,EAAE;YACV,MAAM,EAAE,EAAE;SACb,CAAC,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,kBAAkB,CAAC;YACrC,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC;YACzB,UAAU,EAAE,OAAO,CAAC,cAAc;YAClC,KAAK;YACL,SAAS;YACT,uBAAuB,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,KAAK,CAAC;YACjD,kBAAkB,EAAE,kBAAkB,CAAC,GAAG,CAAC;SAC9C,CAAC,CAAC;QAEH,MAAM,SAAS,CAAC,UAAU,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE;YAC/C,KAAK,EAAE,eAAe;YACtB,MAAM,EAAE,gBAAgB;YACxB,IAAI,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,UAAU,CAAC,EAAE;SAC5D,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,CAAC;QAExC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3B,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACnC,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QACzC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QACtD,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,MAAM,mBAAmB,EAAE,CAAC;QACrD,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChB,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEvB,MAAM,SAAS,GAAG,IAAI,kBAAkB,CAAC;YACrC,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC;YACzB,UAAU,EAAE,OAAO,CAAC,cAAc;YAClC,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE;YACd,kBAAkB,EAAE,kBAAkB,CAAC,GAAG,CAAC;SAC9C,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,UAAU,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE;YAC5D,KAAK,EAAE,YAAY;YACnB,MAAM,EAAE,cAAc;SACzB,CAAC,CAAC;QAEH,MAAM,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzF,MAAM,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;QACvD,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,MAAM,mBAAmB,EAAE,CAAC;QACrD,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChB,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEvB,MAAM,SAAS,GAAG,IAAI,kBAAkB,CAAC;YACrC,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC;YACzB,UAAU,EAAE,OAAO,CAAC,cAAc;YAClC,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE;YACd,kBAAkB,EAAE,kBAAkB,CAAC,GAAG,CAAC;SAC9C,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,UAAU,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE;YAC5D,KAAK,EAAE,cAAc;YACrB,MAAM,EAAE,iCAAiC;SAC5C,CAAC,CAAC;QAEH,MAAM,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChG,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,SAAS,kBAAkB,CAAC,UAAkB,EAAE,YAAyC,EAAE;IACvF,OAAO;QACH,UAAU;QACV,SAAS,EAAE,EAAE;QACb,QAAQ,EAAE,EAAE;QACZ,OAAO,EAAE,KAAK;QACd,MAAM,EAAE,KAAK;QACb,GAAG,SAAS;KACf,CAAC;AACN,CAAC;AAED,SAAS,YAAY,CAAC,MAAc;IAChC,OAAO;QACH,OAAO,EAAE,SAAS;QAClB,MAAM;KACT,CAAC;AACN,CAAC"}

package/dist/engine/ipc/client.d.ts

@@ -0,0 +1,34 @@
+import type { Channel, ChannelMessage, SignalSource } from "@/types";
+export type SocketResponse = {
+    statusCode: number;
+    body: string;
+};
+export type SocketRequestOptions = {
+    socketPath: string;
+    path: string;
+    method?: "GET" | "POST";
+    body?: string;
+    headers?: Record<string, string>;
+};
+export declare function requestSocket(options: SocketRequestOptions): Promise<SocketResponse>;
+type LoadPluginOptions = {
+    pluginId?: string;
+    instanceId?: string;
+    settings?: Record<string, unknown>;
+};
+export declare function setAuth(id: string, key: string, value: string): Promise<void>;
+export declare function loadPlugin(options: LoadPluginOptions): Promise<void>;
+export declare function unloadPlugin(instanceId: string): Promise<void>;
+export declare function reloadEngine(socketPathOverride?: string): Promise<void>;
+export declare function sendEngineEvent(type: string, payload?: unknown, socketPathOverride?: string): Promise<void>;
+export declare function sendEngineSignal(type: string, data?: unknown, source?: SignalSource, socketPathOverride?: string): Promise<void>;
+export declare function listEngineChannels(socketPathOverride?: string): Promise<Channel[]>;
+export declare function createEngineChannel(name: string, leaderAgentId: string, socketPathOverride?: string): Promise<Channel>;
+export declare function addEngineChannelMember(channelName: string, agentId: string, username: string, socketPathOverride?: string): Promise<Channel>;
+export declare function removeEngineChannelMember(channelName: string, agentId: string, socketPathOverride?: string): Promise<boolean>;
+export declare function sendEngineChannelMessage(channelName: string, senderUsername: string, text: string, mentions?: string[], socketPathOverride?: string): Promise<{
+    message: ChannelMessage;
+    deliveredAgentIds: string[];
+}>;
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/engine/ipc/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../sources/engine/ipc/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAIrE,MAAM,MAAM,cAAc,GAAG;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC,CAAC;AAEF,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,CA+BpF;AAED,KAAK,iBAAiB,GAAG;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC,CAAC;AAEF,wBAAsB,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAYnF;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAY1E;AAED,wBAAsB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAYpE;AAED,wBAAsB,YAAY,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAU7E;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,kBAAkB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAYjH;AAED,wBAAsB,gBAAgB,CAClC,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,YAAY,EACrB,kBAAkB,CAAC,EAAE,MAAM,GAC5B,OAAO,CAAC,IAAI,CAAC,CAYf;AAED,wBAAsB,kBAAkB,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAWxF;AAED,wBAAsB,mBAAmB,CACrC,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,MAAM,EACrB,kBAAkB,CAAC,EAAE,MAAM,GAC5B,OAAO,CAAC,OAAO,CAAC,CAiBlB;AAED,wBAAsB,sBAAsB,CACxC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,kBAAkB,CAAC,EAAE,MAAM,GAC5B,OAAO,CAAC,OAAO,CAAC,CAiBlB;AAED,wBAAsB,yBAAyB,CAC3C,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,kBAAkB,CAAC,EAAE,MAAM,GAC5B,OAAO,CAAC,OAAO,CAAC,CAclB;AAED,wBAAsB,wBAAwB,CAC1C,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,MAAM,EAAO,EACvB,kBAAkB,CAAC,EAAE,MAAM,GAC5B,OAAO,CAAC;IAAE,OAAO,EAAE,cAAc,CAAC;IAAC,iBAAiB,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAuBnE"}

package/dist/engine/ipc/client.js

@@ -0,0 +1,189 @@
+import http from "node:http";
+import { resolveEngineSocketPath } from "./socket.js";
+export function requestSocket(options) {
+    return new Promise((resolve, reject) => {
+        const request = http.request({
+            socketPath: options.socketPath,
+            path: options.path,
+            method: options.method ?? "GET",
+            headers: options.headers
+        }, (response) => {
+            const chunks = [];
+            response.on("data", (chunk) => chunks.push(Buffer.from(chunk)));
+            response.on("end", () => {
+                resolve({
+                    statusCode: response.statusCode ?? 0,
+                    body: Buffer.concat(chunks).toString("utf8")
+                });
+            });
+        });
+        request.on("error", (error) => {
+            reject(error);
+        });
+        if (options.body) {
+            request.write(options.body);
+        }
+        request.end();
+    });
+}
+export async function setAuth(id, key, value) {
+    const socketPath = resolveEngineSocketPath();
+    const response = await requestSocket({
+        socketPath,
+        path: "/v1/engine/auth",
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ id, key, value })
+    });
+    if (response.statusCode < 200 || response.statusCode >= 300) {
+        throw new Error(response.body);
+    }
+}
+export async function loadPlugin(options) {
+    const socketPath = resolveEngineSocketPath();
+    const response = await requestSocket({
+        socketPath,
+        path: "/v1/engine/plugins/load",
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(options)
+    });
+    if (response.statusCode < 200 || response.statusCode >= 300) {
+        throw new Error(response.body);
+    }
+}
+export async function unloadPlugin(instanceId) {
+    const socketPath = resolveEngineSocketPath();
+    const response = await requestSocket({
+        socketPath,
+        path: "/v1/engine/plugins/unload",
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ instanceId })
+    });
+    if (response.statusCode < 200 || response.statusCode >= 300) {
+        throw new Error(response.body);
+    }
+}
+export async function reloadEngine(socketPathOverride) {
+    const socketPath = resolveEngineSocketPath(socketPathOverride);
+    const response = await requestSocket({
+        socketPath,
+        path: "/v1/engine/reload",
+        method: "POST"
+    });
+    if (response.statusCode < 200 || response.statusCode >= 300) {
+        throw new Error(response.body || "Engine reload failed.");
+    }
+}
+export async function sendEngineEvent(type, payload, socketPathOverride) {
+    const socketPath = resolveEngineSocketPath(socketPathOverride);
+    const response = await requestSocket({
+        socketPath,
+        path: "/v1/engine/events",
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ type, payload })
+    });
+    if (response.statusCode < 200 || response.statusCode >= 300) {
+        throw new Error(response.body || "Engine event send failed.");
+    }
+}
+export async function sendEngineSignal(type, data, source, socketPathOverride) {
+    const socketPath = resolveEngineSocketPath(socketPathOverride);
+    const response = await requestSocket({
+        socketPath,
+        path: "/v1/engine/signals/generate",
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ type, data, source })
+    });
+    if (response.statusCode < 200 || response.statusCode >= 300) {
+        throw new Error(response.body || "Signal send failed.");
+    }
+}
+export async function listEngineChannels(socketPathOverride) {
+    const socketPath = resolveEngineSocketPath(socketPathOverride);
+    const response = await requestSocket({
+        socketPath,
+        path: "/v1/engine/channels"
+    });
+    if (response.statusCode < 200 || response.statusCode >= 300) {
+        throw new Error(response.body || "Channel list failed.");
+    }
+    const payload = JSON.parse(response.body);
+    return payload.channels ?? [];
+}
+export async function createEngineChannel(name, leaderAgentId, socketPathOverride) {
+    const socketPath = resolveEngineSocketPath(socketPathOverride);
+    const response = await requestSocket({
+        socketPath,
+        path: "/v1/engine/channels",
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ name, leaderAgentId })
+    });
+    if (response.statusCode < 200 || response.statusCode >= 300) {
+        throw new Error(response.body || "Channel create failed.");
+    }
+    const payload = JSON.parse(response.body);
+    if (!payload.channel) {
+        throw new Error("Channel create failed.");
+    }
+    return payload.channel;
+}
+export async function addEngineChannelMember(channelName, agentId, username, socketPathOverride) {
+    const socketPath = resolveEngineSocketPath(socketPathOverride);
+    const response = await requestSocket({
+        socketPath,
+        path: `/v1/engine/channels/${encodeURIComponent(channelName)}/members`,
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ agentId, username })
+    });
+    if (response.statusCode < 200 || response.statusCode >= 300) {
+        throw new Error(response.body || "Channel add member failed.");
+    }
+    const payload = JSON.parse(response.body);
+    if (!payload.channel) {
+        throw new Error("Channel add member failed.");
+    }
+    return payload.channel;
+}
+export async function removeEngineChannelMember(channelName, agentId, socketPathOverride) {
+    const socketPath = resolveEngineSocketPath(socketPathOverride);
+    const response = await requestSocket({
+        socketPath,
+        path: `/v1/engine/channels/${encodeURIComponent(channelName)}/members/remove`,
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ agentId })
+    });
+    if (response.statusCode < 200 || response.statusCode >= 300) {
+        throw new Error(response.body || "Channel remove member failed.");
+    }
+    const payload = JSON.parse(response.body);
+    return payload.removed === true;
+}
+export async function sendEngineChannelMessage(channelName, senderUsername, text, mentions = [], socketPathOverride) {
+    const socketPath = resolveEngineSocketPath(socketPathOverride);
+    const response = await requestSocket({
+        socketPath,
+        path: `/v1/engine/channels/${encodeURIComponent(channelName)}/send`,
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ senderUsername, text, mentions })
+    });
+    if (response.statusCode < 200 || response.statusCode >= 300) {
+        throw new Error(response.body || "Channel send failed.");
+    }
+    const payload = JSON.parse(response.body);
+    if (!payload.message) {
+        throw new Error("Channel send failed.");
+    }
+    return {
+        message: payload.message,
+        deliveredAgentIds: payload.deliveredAgentIds ?? []
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/engine/ipc/client.js.map

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

package/dist/engine/ipc/events.d.ts

@@ -0,0 +1,13 @@
+export type EngineEvent = {
+    type: string;
+    payload: unknown;
+    timestamp: string;
+};
+type EngineEventListener = (event: EngineEvent) => void;
+export declare class EngineEventBus {
+    private emitter;
+    emit(type: string, payload: unknown): void;
+    onEvent(listener: EngineEventListener): () => void;
+}
+export {};
+//# sourceMappingURL=events.d.ts.map

package/dist/engine/ipc/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../sources/engine/ipc/events.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,WAAW,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,KAAK,mBAAmB,GAAG,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;AAExD,qBAAa,cAAc;IACvB,OAAO,CAAC,OAAO,CAAsB;IAErC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAS1C,OAAO,CAAC,QAAQ,EAAE,mBAAmB,GAAG,MAAM,IAAI;CAIrD"}

package/dist/engine/ipc/events.js

@@ -0,0 +1,17 @@
+import { EventEmitter } from "node:events";
+export class EngineEventBus {
+    emitter = new EventEmitter();
+    emit(type, payload) {
+        const event = {
+            type,
+            payload,
+            timestamp: new Date().toISOString()
+        };
+        this.emitter.emit("event", event);
+    }
+    onEvent(listener) {
+        this.emitter.on("event", listener);
+        return () => this.emitter.off("event", listener);
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/engine/ipc/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../sources/engine/ipc/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAU3C,MAAM,OAAO,cAAc;IACf,OAAO,GAAG,IAAI,YAAY,EAAE,CAAC;IAErC,IAAI,CAAC,IAAY,EAAE,OAAgB;QAC/B,MAAM,KAAK,GAAgB;YACvB,IAAI;YACJ,OAAO;YACP,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACtC,CAAC;QACF,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,CAAC,QAA6B;QACjC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACnC,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACrD,CAAC;CACJ"}

package/dist/engine/ipc/server.d.ts

@@ -0,0 +1,14 @@
+import type { Engine } from "../engine.js";
+import type { EngineEventBus } from "./events.js";
+export type EngineServerOptions = {
+    socketPath?: string;
+    settingsPath: string;
+    runtime: Engine;
+    eventBus: EngineEventBus;
+};
+export type EngineServer = {
+    socketPath: string;
+    close: () => Promise<void>;
+};
+export declare function startEngineServer(options: EngineServerOptions): Promise<EngineServer>;
+//# sourceMappingURL=server.d.ts.map

package/dist/engine/ipc/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../sources/engine/ipc/server.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAI3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,MAAM,MAAM,mBAAmB,GAAG;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,cAAc,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B,CAAC;AAmDF,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,CAmd3F"}