opensquid 0.5.441 → 0.5.449

package/dist/chat/daemon/lifecycle.js

@@ -1,221 +0,0 @@
-/**
- * Chat-daemon lifecycle — start / stop / status (v0.7.1 Phase A).
- *
- * The daemon owns the single long-poll connection per chat platform so
- * multiple Claude Code projects sharing the same machine can run their
- * own opensquid MCP servers without colliding on the bot token (Telegram
- * returns 409 Conflict when two consumers long-poll the same token —
- * the v0.7 cause of "last-connected wins" behavior).
- *
- * Lifecycle is single-instance per machine: PID file at
- * ~/.opensquid/chat-daemon.pid, log at ~/.opensquid/chat-daemon.log.
- * A `start` call against a running daemon is a no-op (idempotent);
- * `stop` is also idempotent. `status` is read-only.
- *
- * Outbound RPC (Unix socket) lands in Phase B; routing config + inbox
- * write-out in Phase C; auto-spawn from MCP server in Phase D.
- */
-import { spawn } from "node:child_process";
-import { promises as fs } from "node:fs";
-import { existsSync } from "node:fs";
-import * as os from "node:os";
-import * as path from "node:path";
-import { resolveDataRoot } from "../../codex/store.js";
-export function daemonPaths(dataRoot) {
-    const root = resolveDataRoot(dataRoot);
-    return {
-        pidFile: path.join(root, "chat-daemon.pid"),
-        logFile: path.join(root, "chat-daemon.log"),
-        sockFile: path.join(root, "chat-daemon.sock"),
-    };
-}
-/**
- * Read the pidfile and check whether the recorded process is alive.
- * A pidfile that points at a dead pid is treated as not-running (the
- * caller should clean it up if they want; status itself is read-only).
- */
-export async function status(dataRoot) {
-    const paths = daemonPaths(dataRoot);
-    if (!existsSync(paths.pidFile))
-        return { running: false };
-    let raw;
-    try {
-        raw = await fs.readFile(paths.pidFile, "utf8");
-    }
-    catch {
-        return { running: false };
-    }
-    const pid = parseInt(raw.trim(), 10);
-    if (!Number.isFinite(pid) || pid <= 0)
-        return { running: false };
-    if (!isProcessAlive(pid))
-        return { running: false, stale_pid: pid };
-    let uptime_ms = null;
-    try {
-        const stat = await fs.stat(paths.pidFile);
-        uptime_ms = Date.now() - stat.mtimeMs;
-    }
-    catch {
-        /* keep null */
-    }
-    return { running: true, pid, uptime_ms };
-}
-/** `kill -0 <pid>` portable check — throws ESRCH if dead, EPERM if alive-but-foreign. */
-function isProcessAlive(pid) {
-    try {
-        process.kill(pid, 0);
-        return true;
-    }
-    catch (err) {
-        const code = err.code;
-        return code === "EPERM"; // alive but owned by another user (still counts)
-    }
-}
-/**
- * Start the daemon by spawning a detached child that runs
- * `node dist/index.js chat-daemon-worker` (the actual long-poll loop
- * lives in worker.ts). Returns immediately once the child has either
- * forked successfully or failed.
- *
- * Idempotent: a start against an already-running daemon returns
- * `{ already_running: true, pid }` without launching a second process.
- *
- * Stale pidfile handling: if the pidfile points at a dead pid, it's
- * silently removed so this call can succeed.
- */
-export async function startDaemon(options = {}) {
-    const cur = await status(options.dataRoot);
-    if (cur.running)
-        return { already_running: true, pid: cur.pid };
-    const paths = daemonPaths(options.dataRoot);
-    if (cur.stale_pid !== undefined) {
-        await fs.unlink(paths.pidFile).catch(() => {
-            /* race-tolerant */
-        });
-    }
-    // The log file is opened append-mode by both the parent (header
-    // line) and the child (stdout/stderr). fs.open with 'a' is atomic
-    // append on POSIX, which is what we want here — no race between
-    // start runs.
-    await fs.mkdir(path.dirname(paths.logFile), { recursive: true });
-    const logFd = await fs.open(paths.logFile, "a");
-    try {
-        await logFd.write(`\n=== chat-daemon start @ ${new Date().toISOString()} ===\n` +
-            `host=${os.hostname()} node=${process.version} platform=${process.platform}\n`);
-    }
-    finally {
-        await logFd.close();
-    }
-    // Reopen the log file for the child's stdio. spawn() wants raw FDs,
-    // not FileHandles, so we open via the sync API.
-    const fsSync = await import("node:fs");
-    const childLogFd = fsSync.openSync(paths.logFile, "a");
-    const nodeBin = options.nodeBin ?? process.execPath;
-    const entrypoint = options.entrypoint ?? defaultEntrypoint();
-    // Pass dataRoot through to the worker via OPENSQUID_HOME so the
-    // worker's resolveDataRoot() lands in the same tree the parent
-    // selected. Tests pass a tmpdir here; production uses the default
-    // ~/.opensquid resolution.
-    const childEnv = {
-        ...process.env,
-        OPENSQUID_CHAT_DAEMON: "1",
-    };
-    if (options.dataRoot)
-        childEnv.OPENSQUID_HOME = options.dataRoot;
-    const child = spawn(nodeBin, [entrypoint, "chat-daemon-worker"], {
-        detached: true,
-        stdio: ["ignore", childLogFd, childLogFd],
-        env: childEnv,
-    });
-    // unref so the parent (this process) can exit without waiting for the
-    // child. The child is now an independent process group leader because
-    // of detached:true.
-    child.unref();
-    fsSync.closeSync(childLogFd);
-    if (!child.pid) {
-        throw new Error("chat-daemon: spawn returned no pid");
-    }
-    // The worker writes its OWN pidfile on startup (so the recorded pid
-    // is the worker's, not a stale spawn-only value). Wait briefly for
-    // the pidfile to appear; if it doesn't, the worker died on startup.
-    // The timeout is generous (8s) because a cold-start of `node
-    // dist/index.js chat-daemon-worker` with the optional grammy /
-    // discord.js / @slack/* SDKs in the import graph can exceed 3s on
-    // first invocation. Subsequent starts hit OS file cache and complete
-    // in <500ms.
-    const workerPid = await waitForPidfile(paths.pidFile, 8000);
-    return { already_running: false, pid: workerPid };
-}
-/**
- * Stop a running daemon by sending SIGTERM, then waiting briefly for
- * the process to exit and the pidfile to disappear. Falls back to
- * SIGKILL after the grace period. Idempotent — a stop against a
- * not-running daemon returns `{ stopped: false }` without error.
- */
-export async function stopDaemon(options = {}) {
-    const cur = await status(options.dataRoot);
-    if (!cur.running) {
-        // Clean up stale pidfile if present.
-        if (cur.stale_pid !== undefined) {
-            await fs.unlink(daemonPaths(options.dataRoot).pidFile).catch(() => {
-                /* race-tolerant */
-            });
-        }
-        return { stopped: false };
-    }
-    const grace = options.graceMs ?? 3000;
-    try {
-        process.kill(cur.pid, "SIGTERM");
-    }
-    catch {
-        /* already gone */
-    }
-    const deadline = Date.now() + grace;
-    while (Date.now() < deadline) {
-        if (!isProcessAlive(cur.pid))
-            break;
-        await sleep(100);
-    }
-    if (isProcessAlive(cur.pid)) {
-        try {
-            process.kill(cur.pid, "SIGKILL");
-        }
-        catch {
-            /* already gone */
-        }
-    }
-    // Pidfile cleanup is the worker's job on graceful shutdown — but
-    // best-effort here for the SIGKILL path.
-    await fs.unlink(daemonPaths(options.dataRoot).pidFile).catch(() => {
-        /* race-tolerant */
-    });
-    return { stopped: true, pid: cur.pid };
-}
-function sleep(ms) {
-    return new Promise((r) => setTimeout(r, ms));
-}
-async function waitForPidfile(pidFile, timeoutMs) {
-    const deadline = Date.now() + timeoutMs;
-    while (Date.now() < deadline) {
-        try {
-            const raw = await fs.readFile(pidFile, "utf8");
-            const pid = parseInt(raw.trim(), 10);
-            if (Number.isFinite(pid) && pid > 0 && isProcessAlive(pid))
-                return pid;
-        }
-        catch {
-            /* not yet written */
-        }
-        await sleep(50);
-    }
-    throw new Error(`chat-daemon: worker did not write pidfile within ${timeoutMs}ms`);
-}
-/**
- * Find the on-disk path of the running opensquid binary so the child
- * can re-invoke the same module. Defaults to argv[1] (the script Node
- * was invoked with) which is `dist/index.js` for normal usage.
- */
-function defaultEntrypoint() {
-    // process.argv[1] may be a relative path when launched via npx; resolve.
-    return path.resolve(process.argv[1] ?? "dist/index.js");
-}

package/dist/chat/daemon/lifecycle.js.map

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

package/dist/chat/daemon/lifecycle.test.js

@@ -1,163 +0,0 @@
-/**
- * chat-daemon lifecycle tests (v0.7.1 Phase A).
- *
- * Exercise the start/stop/status surface against REAL detached child
- * processes — the lifecycle logic IS the contract (fork-detach +
- * pidfile + signal handling), so synthetic stubs would prove nothing.
- *
- * Each test uses a tmpdir as the data root so multiple test runs don't
- * collide on the shared ~/.opensquid/chat-daemon.pid path, and so a
- * crashed test doesn't poison a real chat-daemon install.
- */
-import { promises as fs } from "node:fs";
-import * as os from "node:os";
-import * as path from "node:path";
-import { afterEach, beforeEach, describe, expect, it } from "vitest";
-import { daemonPaths, startDaemon, status, stopDaemon } from "./lifecycle.js";
-// Resolve to a real on-disk dist/index.js so the spawned worker can
-// actually run. Tests assume `npm run build` has been done; vitest's
-// suite runner triggers tsc when the build step is wired upstream.
-const REPO_ROOT = path.resolve(__dirname, "../../..");
-const ENTRYPOINT = path.join(REPO_ROOT, "dist", "index.js");
-let tmpDataRoot;
-beforeEach(async () => {
-    tmpDataRoot = await fs.mkdtemp(path.join(os.tmpdir(), "opensquid-daemon-test-"));
-});
-afterEach(async (ctx) => {
-    // On failure, dump the log + tmpdir contents before cleanup so we can
-    // see what the daemon was up to. Vitest exposes the task state on ctx.
-    if (ctx.task.result?.state === "fail") {
-        try {
-            const entries = await fs.readdir(tmpDataRoot);
-            // eslint-disable-next-line no-console
-            console.log(`[test debug] ${tmpDataRoot} entries: ${JSON.stringify(entries)}`);
-        }
-        catch {
-            // eslint-disable-next-line no-console
-            console.log(`[test debug] tmpDataRoot ${tmpDataRoot} missing`);
-        }
-        try {
-            const log = await fs.readFile(path.join(tmpDataRoot, "chat-daemon.log"), "utf8");
-            // eslint-disable-next-line no-console
-            console.log(`[test debug] ${tmpDataRoot}/chat-daemon.log:\n${log}`);
-        }
-        catch {
-            // eslint-disable-next-line no-console
-            console.log(`[test debug] no chat-daemon.log in ${tmpDataRoot}`);
-        }
-    }
-    // Best-effort: stop any daemon that's still running from a failed
-    // test, then rm the tmp root.
-    try {
-        await stopDaemon({ dataRoot: tmpDataRoot });
-    }
-    catch {
-        /* ignore */
-    }
-    await fs.rm(tmpDataRoot, { recursive: true, force: true });
-});
-function dataRootEnv() {
-    return { dataRoot: tmpDataRoot, entrypoint: ENTRYPOINT };
-}
-describe("daemonPaths", () => {
-    it("derives pid/log/sock paths from the data root", () => {
-        const p = daemonPaths(tmpDataRoot);
-        expect(p.pidFile).toBe(path.join(tmpDataRoot, "chat-daemon.pid"));
-        expect(p.logFile).toBe(path.join(tmpDataRoot, "chat-daemon.log"));
-        expect(p.sockFile).toBe(path.join(tmpDataRoot, "chat-daemon.sock"));
-    });
-});
-describe("status (before any start)", () => {
-    it("reports not-running when pidfile is absent", async () => {
-        const s = await status(tmpDataRoot);
-        expect(s.running).toBe(false);
-        expect("stale_pid" in s ? s.stale_pid : undefined).toBeUndefined();
-    });
-    it("reports stale_pid when pidfile points at a dead pid", async () => {
-        // pid 999999 is overwhelmingly unlikely to be a live process.
-        const paths = daemonPaths(tmpDataRoot);
-        await fs.mkdir(path.dirname(paths.pidFile), { recursive: true });
-        await fs.writeFile(paths.pidFile, "999999\n");
-        const s = await status(tmpDataRoot);
-        expect(s.running).toBe(false);
-        expect("stale_pid" in s ? s.stale_pid : undefined).toBe(999999);
-    });
-    it("reports not-running on a malformed pidfile (not a number)", async () => {
-        const paths = daemonPaths(tmpDataRoot);
-        await fs.mkdir(path.dirname(paths.pidFile), { recursive: true });
-        await fs.writeFile(paths.pidFile, "garbage\n");
-        const s = await status(tmpDataRoot);
-        expect(s.running).toBe(false);
-    });
-});
-describe("stopDaemon (idempotency)", () => {
-    it("returns stopped:false when no daemon is running", async () => {
-        const res = await stopDaemon({ dataRoot: tmpDataRoot });
-        expect(res.stopped).toBe(false);
-    });
-    it("cleans up a stale pidfile during stop()", async () => {
-        const paths = daemonPaths(tmpDataRoot);
-        await fs.mkdir(path.dirname(paths.pidFile), { recursive: true });
-        await fs.writeFile(paths.pidFile, "999999\n");
-        await stopDaemon({ dataRoot: tmpDataRoot });
-        // Pidfile should be gone.
-        await expect(fs.access(paths.pidFile)).rejects.toThrow();
-    });
-});
-describe("startDaemon + stopDaemon (end-to-end)", () => {
-    it("starts, reports running, then stops cleanly", async () => {
-        const env = dataRootEnv();
-        const startRes = await startDaemon(env);
-        expect(startRes.already_running).toBe(false);
-        expect(startRes.pid).toBeGreaterThan(0);
-        const s = await status(env.dataRoot);
-        expect(s.running).toBe(true);
-        if (s.running) {
-            expect(s.pid).toBe(startRes.pid);
-        }
-        const stopRes = await stopDaemon({ dataRoot: env.dataRoot });
-        expect(stopRes.stopped).toBe(true);
-        expect(stopRes.pid).toBe(startRes.pid);
-        // Pidfile cleaned up.
-        const after = await status(env.dataRoot);
-        expect(after.running).toBe(false);
-    }, 15000);
-    it("is idempotent: a second start() returns already_running:true with the same pid", async () => {
-        const env = dataRootEnv();
-        const first = await startDaemon(env);
-        expect(first.already_running).toBe(false);
-        const second = await startDaemon(env);
-        expect(second.already_running).toBe(true);
-        expect(second.pid).toBe(first.pid);
-        await stopDaemon({ dataRoot: env.dataRoot });
-    }, 15000);
-    it("writes daemon boot lines to the log file", async () => {
-        const env = dataRootEnv();
-        await startDaemon(env);
-        // Give the worker a beat to emit its boot lines.
-        await new Promise((r) => setTimeout(r, 600));
-        const log = await fs.readFile(daemonPaths(env.dataRoot).logFile, "utf8");
-        expect(log).toContain("=== chat-daemon start @");
-        expect(log).toContain("worker booted pid=");
-        await stopDaemon({ dataRoot: env.dataRoot });
-    }, 15000);
-    it("survives a stop on a daemon spawned from a different test (stale handling)", async () => {
-        const env = dataRootEnv();
-        // First start, then kill the process behind status's back so the
-        // pidfile becomes stale. Real-world: daemon crashed.
-        const first = await startDaemon(env);
-        try {
-            process.kill(first.pid, "SIGKILL");
-        }
-        catch {
-            /* race */
-        }
-        // Wait briefly for the kill to take effect.
-        await new Promise((r) => setTimeout(r, 200));
-        const s = await status(env.dataRoot);
-        expect(s.running).toBe(false);
-        // Should NOT throw and should report not-stopped (since it wasn't).
-        const stopRes = await stopDaemon({ dataRoot: env.dataRoot });
-        expect(stopRes.stopped).toBe(false);
-    }, 15000);
-});

package/dist/chat/daemon/protocol.d.ts

@@ -1,107 +0,0 @@
-/**
- * chat-daemon ↔ MCP server wire protocol (v0.7.1 Phase B).
- *
- * Shape: JSON-RPC 2.0 over newline-delimited JSON. One JSON object per
- * line; both directions use the same framing. Stateless — the daemon
- * doesn't track client connections beyond the lifetime of a single
- * request/response pair.
- *
- * Transport address (set by `daemonPaths().sockFile`):
- *   - macOS/Linux: ~/.opensquid/chat-daemon.sock (AF_UNIX)
- *   - Windows:     \\.\pipe\opensquid-chat-daemon (named pipe)
- * Node's `net.createServer({path})` accepts both shapes transparently;
- * `daemonSockAddress()` below returns the right form for the host OS.
- *
- * Why not gRPC / HTTP / MCP-style stdio? gRPC drags in a 3 MB grpc-js
- * dependency that we already explicitly avoided in the engine's
- * subprocess design. HTTP needs port allocation + firewall coordination.
- * MCP stdio needs a parent-child relationship — but the daemon is
- * grandparent / orphan to the MCP servers (it outlives them). Local
- * socket + JSON-RPC is the smallest correct surface.
- */
-/** Send a chat message via the daemon's owned adapter. */
-export interface SendParams {
-    channel: string;
-    text: string;
-    replyTo?: string;
-    /** Telegram forum topic id (v0.7.2). Ignored by adapters that don't support threading. */
-    threadId?: string;
-}
-/** v0.7.2 — Create a Telegram forum topic via the daemon's owned bot. */
-export interface CreateTopicParams {
-    platform: "telegram";
-    chat_id: string;
-    name: string;
-    icon_color?: number;
-    icon_custom_emoji_id?: string;
-}
-export interface CreateTopicResult {
-    message_thread_id: number;
-    name: string;
-}
-export interface SendResult {
-    ok: boolean;
-    platform: string;
-    message_id: string;
-    delivered_at: string;
-}
-/** List the platforms the daemon currently has active adapters for. */
-export interface ListChannelsParams {
-}
-export interface ListChannelsResult {
-    active_platforms: string[];
-    uptime_ms: number | null;
-    /**
-     * 0.7.4 (#147): platforms whose long-poll lost to a 409 Conflict
-     * and degraded to outbound-only mode. Surfaced via
-     * `chat_daemon_status` so operators can diagnose "where did my
-     * inbound message go?"
-     */
-    outbound_only_platforms?: string[];
-}
-/** Liveness probe for the auto-spawn path. */
-export interface PingParams {
-}
-export interface PingResult {
-    pong: true;
-    pid: number;
-    version: string;
-}
-export type DaemonMethod = "send" | "list_channels" | "ping" | "create_topic";
-export interface JsonRpcRequest<P = unknown> {
-    jsonrpc: "2.0";
-    id: number | string;
-    method: DaemonMethod;
-    params?: P;
-}
-export interface JsonRpcSuccess<R = unknown> {
-    jsonrpc: "2.0";
-    id: number | string;
-    result: R;
-}
-export interface JsonRpcFailure {
-    jsonrpc: "2.0";
-    id: number | string | null;
-    error: {
-        code: number;
-        message: string;
-        data?: unknown;
-    };
-}
-export type JsonRpcResponse<R = unknown> = JsonRpcSuccess<R> | JsonRpcFailure;
-export declare const JSON_RPC_PARSE_ERROR = -32700;
-export declare const JSON_RPC_INVALID_REQUEST = -32600;
-export declare const JSON_RPC_METHOD_NOT_FOUND = -32601;
-export declare const JSON_RPC_INVALID_PARAMS = -32602;
-export declare const JSON_RPC_INTERNAL_ERROR = -32603;
-/**
- * Return the platform-correct socket address for `net.createServer` /
- * `net.connect`. On Unix this is a path on disk; on Windows this is a
- * named-pipe path. Node accepts both behind the same `{path}` API.
- *
- * On Windows we don't actually have a filesystem path to use, so the
- * pidfile name (without the .pid suffix) drives the pipe name to keep
- * dataRoot isolation working across multiple installs.
- */
-export declare function daemonSockAddress(dataRoot?: string): string;
-//# sourceMappingURL=protocol.d.ts.map

package/dist/chat/daemon/protocol.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../../src.legacy/chat/daemon/protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAWH,0DAA0D;AAC1D,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,yEAAyE;AACzE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,UAAU,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,uEAAuE;AACvE,MAAM,WAAW,kBAAkB;CAElC;AAED,MAAM,WAAW,kBAAkB;IACjC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB;;;;;OAKG;IACH,uBAAuB,CAAC,EAAE,MAAM,EAAE,CAAC;CACpC;AAED,8CAA8C;AAC9C,MAAM,WAAW,UAAU;CAE1B;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,IAAI,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,eAAe,GAAG,MAAM,GAAG,cAAc,CAAC;AAM9E,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO;IACzC,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,CAAC,EAAE,CAAC,CAAC;CACZ;AAED,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO;IACzC,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,MAAM,EAAE,CAAC,CAAC;CACX;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC1D;AAED,MAAM,MAAM,eAAe,CAAC,CAAC,GAAG,OAAO,IAAI,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC;AAG9E,eAAO,MAAM,oBAAoB,SAAS,CAAC;AAC3C,eAAO,MAAM,wBAAwB,SAAS,CAAC;AAC/C,eAAO,MAAM,yBAAyB,SAAS,CAAC;AAChD,eAAO,MAAM,uBAAuB,SAAS,CAAC;AAC9C,eAAO,MAAM,uBAAuB,SAAS,CAAC;AAM9C;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAW3D"}

package/dist/chat/daemon/protocol.js

@@ -1,54 +0,0 @@
-/**
- * chat-daemon ↔ MCP server wire protocol (v0.7.1 Phase B).
- *
- * Shape: JSON-RPC 2.0 over newline-delimited JSON. One JSON object per
- * line; both directions use the same framing. Stateless — the daemon
- * doesn't track client connections beyond the lifetime of a single
- * request/response pair.
- *
- * Transport address (set by `daemonPaths().sockFile`):
- *   - macOS/Linux: ~/.opensquid/chat-daemon.sock (AF_UNIX)
- *   - Windows:     \\.\pipe\opensquid-chat-daemon (named pipe)
- * Node's `net.createServer({path})` accepts both shapes transparently;
- * `daemonSockAddress()` below returns the right form for the host OS.
- *
- * Why not gRPC / HTTP / MCP-style stdio? gRPC drags in a 3 MB grpc-js
- * dependency that we already explicitly avoided in the engine's
- * subprocess design. HTTP needs port allocation + firewall coordination.
- * MCP stdio needs a parent-child relationship — but the daemon is
- * grandparent / orphan to the MCP servers (it outlives them). Local
- * socket + JSON-RPC is the smallest correct surface.
- */
-import * as os from "node:os";
-import * as path from "node:path";
-import { daemonPaths } from "./lifecycle.js";
-// Standard JSON-RPC error codes (we use the public-rage subset).
-export const JSON_RPC_PARSE_ERROR = -32700;
-export const JSON_RPC_INVALID_REQUEST = -32600;
-export const JSON_RPC_METHOD_NOT_FOUND = -32601;
-export const JSON_RPC_INVALID_PARAMS = -32602;
-export const JSON_RPC_INTERNAL_ERROR = -32603;
-// ---------------------------------------------------------------------
-// Socket address — cross-platform
-// ---------------------------------------------------------------------
-/**
- * Return the platform-correct socket address for `net.createServer` /
- * `net.connect`. On Unix this is a path on disk; on Windows this is a
- * named-pipe path. Node accepts both behind the same `{path}` API.
- *
- * On Windows we don't actually have a filesystem path to use, so the
- * pidfile name (without the .pid suffix) drives the pipe name to keep
- * dataRoot isolation working across multiple installs.
- */
-export function daemonSockAddress(dataRoot) {
-    const paths = daemonPaths(dataRoot);
-    if (os.platform() === "win32") {
-        // Windows named pipe — derive a stable name from the data root so
-        // tests with tmpdirs and prod with ~/.opensquid don't collide.
-        // Pipe names live in a flat namespace; hash the dataRoot to a
-        // short suffix.
-        const fingerprint = path.basename(path.dirname(paths.sockFile));
-        return `\\\\.\\pipe\\opensquid-chat-daemon-${fingerprint}`;
-    }
-    return paths.sockFile;
-}

package/dist/chat/daemon/protocol.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../../src.legacy/chat/daemon/protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AA2F7C,iEAAiE;AACjE,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,KAAK,CAAC;AAC3C,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,KAAK,CAAC;AAC/C,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,KAAK,CAAC;AAChD,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,KAAK,CAAC;AAC9C,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,KAAK,CAAC;AAE9C,wEAAwE;AACxE,kCAAkC;AAClC,wEAAwE;AAExE;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAiB;IACjD,MAAM,KAAK,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IACpC,IAAI,EAAE,CAAC,QAAQ,EAAE,KAAK,OAAO,EAAE,CAAC;QAC9B,kEAAkE;QAClE,+DAA+D;QAC/D,8DAA8D;QAC9D,gBAAgB;QAChB,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;QAChE,OAAO,sCAAsC,WAAW,EAAE,CAAC;IAC7D,CAAC;IACD,OAAO,KAAK,CAAC,QAAQ,CAAC;AACxB,CAAC"}