@sumicom/quicksave 0.4.0 → 0.5.1

package/dist/service/ensureDaemon.js

@@ -0,0 +1,143 @@
+/**
+ * ensureDaemon — connect to an existing daemon or auto-start one.
+ *
+ * Flow:
+ * 1. Read service.json for socket path. Quick pre-check: if PID is dead, skip to step 4.
+ * 2. Connect to socket, send hello (both liveness check and version exchange).
+ * 3. Inspect HelloResult for version compatibility. If compatible, attach.
+ *    If restart needed, proceed to step 4.
+ * 4. If stale or version mismatch, remove stale runtime files and start a new daemon.
+ * 5. If lock acquisition fails, retry attach with backoff (up to 3 attempts, 500ms base delay).
+ */
+import { fork } from 'child_process';
+import { openSync, mkdirSync } from 'fs';
+import { join, resolve } from 'path';
+import { fileURLToPath } from 'url';
+import { IpcClient } from './ipcClient.js';
+import { readServiceState } from './stateStore.js';
+import { isProcessAlive, cleanStaleRuntime, getRunDir } from './singleton.js';
+import { shouldRestartDaemon, IPC_VERSION, BUILD_ID } from './types.js';
+const MAX_ATTACH_RETRIES = 3;
+const BASE_RETRY_DELAY_MS = 500;
+const DAEMON_READY_TIMEOUT_MS = 10_000;
+const DAEMON_READY_POLL_MS = 200;
+/**
+ * Ensure the daemon is running and return a connected IPC client.
+ * Auto-starts a new daemon if needed.
+ */
+export async function ensureDaemon() {
+    for (let attempt = 0; attempt <= MAX_ATTACH_RETRIES; attempt++) {
+        // Step 1: Read service.json
+        const state = readServiceState();
+        if (state) {
+            // Quick pre-check: is the PID alive?
+            if (!isProcessAlive(state.pid)) {
+                cleanStaleRuntime();
+                return startAndConnect();
+            }
+            // Step 2: Try connecting
+            try {
+                const client = new IpcClient();
+                const hello = await client.connect(state.socketPath);
+                // Step 3: Check version compatibility
+                const check = shouldRestartDaemon(hello, { ipcVersion: IPC_VERSION, buildId: BUILD_ID });
+                if (check.action === 'ok') {
+                    return { client, hello };
+                }
+                if (check.action === 'warn_outdated') {
+                    console.warn('Warning: CLI is outdated. Please update quicksave.');
+                    return { client, hello };
+                }
+                // action === 'restart'
+                client.close();
+                await requestShutdownAndWait(state.socketPath);
+                cleanStaleRuntime();
+                return startAndConnect();
+            }
+            catch {
+                // Connection failed — daemon might be stale or starting
+                if (attempt < MAX_ATTACH_RETRIES) {
+                    await sleep(BASE_RETRY_DELAY_MS * (attempt + 1));
+                    continue;
+                }
+                // Last attempt — clean up and start fresh
+                cleanStaleRuntime();
+                return startAndConnect();
+            }
+        }
+        else {
+            // No service.json — start a new daemon
+            return startAndConnect();
+        }
+    }
+    // Should not reach here, but just in case
+    throw new Error('Failed to connect to daemon after retries');
+}
+/**
+ * Spawn a new daemon process in detached mode and wait for it to be ready.
+ */
+async function startAndConnect() {
+    spawnDaemon();
+    return waitForDaemon();
+}
+/**
+ * Spawn `quicksave service run` as a detached background process.
+ */
+function spawnDaemon() {
+    const thisFile = fileURLToPath(import.meta.url);
+    const isTs = thisFile.endsWith('.ts');
+    const entryPath = resolve(thisFile, isTs ? '../../index.ts' : '../../index.js');
+    // Ensure run directory exists before opening log file (daemon hasn't started yet)
+    const runDir = getRunDir();
+    mkdirSync(runDir, { recursive: true });
+    const logFd = openSync(join(runDir, 'daemon.log'), 'a');
+    const child = fork(entryPath, ['service', 'run'], {
+        detached: true,
+        stdio: ['ignore', logFd, logFd, 'ipc'],
+        execArgv: isTs ? ['--import', 'tsx'] : [],
+    });
+    // Disconnect IPC so parent can exit immediately
+    child.disconnect();
+    child.unref();
+}
+/**
+ * Poll until the daemon is ready (service.json exists and IPC responds).
+ */
+async function waitForDaemon() {
+    const deadline = Date.now() + DAEMON_READY_TIMEOUT_MS;
+    while (Date.now() < deadline) {
+        const state = readServiceState();
+        if (state && isProcessAlive(state.pid)) {
+            try {
+                const client = new IpcClient();
+                const hello = await client.connect(state.socketPath);
+                return { client, hello };
+            }
+            catch {
+                // Not ready yet
+            }
+        }
+        await sleep(DAEMON_READY_POLL_MS);
+    }
+    throw new Error('Timed out waiting for daemon to start');
+}
+/**
+ * Send shutdown to the daemon and wait for the process to exit.
+ */
+async function requestShutdownAndWait(socketPath) {
+    try {
+        const client = new IpcClient();
+        await client.connect(socketPath);
+        await client.request('shutdown');
+        client.close();
+    }
+    catch {
+        // If we can't connect, the daemon is already gone
+    }
+    // Wait briefly for the process to exit
+    await sleep(500);
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=ensureDaemon.js.map

package/dist/service/ensureDaemon.js.map

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

package/dist/service/index.d.ts

@@ -0,0 +1,8 @@
+export { runDaemon } from './run.js';
+export { ensureDaemon } from './ensureDaemon.js';
+export { IpcClient, IpcDisconnectedError, RpcError } from './ipcClient.js';
+export { IpcServer } from './ipcServer.js';
+export { readServiceState, writeServiceState, removeServiceState } from './stateStore.js';
+export { acquireLock, cleanStaleRuntime, isProcessAlive, getSocketPath, getRunDir, getStateDir, getSessionsDir, getLogsDir, ensureDirectories, } from './singleton.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/service/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/service/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1F,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,SAAS,EACT,WAAW,EACX,cAAc,EACd,UAAU,EACV,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AACxB,cAAc,YAAY,CAAC"}

package/dist/service/index.js

@@ -0,0 +1,8 @@
+export { runDaemon } from './run.js';
+export { ensureDaemon } from './ensureDaemon.js';
+export { IpcClient, IpcDisconnectedError, RpcError } from './ipcClient.js';
+export { IpcServer } from './ipcServer.js';
+export { readServiceState, writeServiceState, removeServiceState } from './stateStore.js';
+export { acquireLock, cleanStaleRuntime, isProcessAlive, getSocketPath, getRunDir, getStateDir, getSessionsDir, getLogsDir, ensureDirectories, } from './singleton.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/service/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/service/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1F,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,SAAS,EACT,WAAW,EACX,cAAc,EACd,UAAU,EACV,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AACxB,cAAc,YAAY,CAAC"}

package/dist/service/ipc.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ipc.test.d.ts.map

package/dist/service/ipc.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipc.test.d.ts","sourceRoot":"","sources":["../../src/service/ipc.test.ts"],"names":[],"mappings":""}

package/dist/service/ipc.test.js

@@ -0,0 +1,140 @@
+import { describe, it, expect, afterEach } from 'vitest';
+import { join } from 'path';
+import { tmpdir } from 'os';
+import { mkdtempSync, rmSync } from 'fs';
+import { IpcServer } from './ipcServer.js';
+import { IpcClient } from './ipcClient.js';
+function makeTmpDir() {
+    return mkdtempSync(join(tmpdir(), 'qs-ipc-test-'));
+}
+describe('IPC Server + Client', () => {
+    let tmpDir;
+    let server;
+    const clients = [];
+    afterEach(async () => {
+        for (const c of clients)
+            c.close();
+        clients.length = 0;
+        if (server)
+            await server.close();
+        if (tmpDir) {
+            try {
+                rmSync(tmpDir, { recursive: true, force: true });
+            }
+            catch { /* ignore */ }
+        }
+    });
+    function socketPath() {
+        tmpDir = makeTmpDir();
+        return join(tmpDir, 'test.sock');
+    }
+    async function createServer() {
+        const sock = socketPath();
+        server = new IpcServer({ version: '0.5.1' });
+        await server.listen(sock);
+        return sock;
+    }
+    async function createClient(sock) {
+        const client = new IpcClient();
+        const hello = await client.connect(sock);
+        clients.push(client);
+        return { client, hello };
+    }
+    it('hello handshake returns daemon version info', async () => {
+        const sock = await createServer();
+        const { hello } = await createClient(sock);
+        expect(hello.daemonVersion).toBe('0.5.1');
+        expect(hello.daemonIpcVersion).toBe(1);
+        expect(hello.daemonPid).toBe(process.pid);
+        expect(typeof hello.daemonBuildId).toBe('string');
+    });
+    it('ping returns uptime and version', async () => {
+        const sock = await createServer();
+        const { client } = await createClient(sock);
+        const result = await client.request('ping');
+        expect(result.version).toBe('0.5.1');
+        expect(result.ipcVersion).toBe(1);
+        expect(typeof result.uptime).toBe('number');
+        expect(result.uptime).toBeGreaterThanOrEqual(0);
+    });
+    it('status returns daemon status summary', async () => {
+        const sock = await createServer();
+        const { client } = await createClient(sock);
+        const result = await client.request('status');
+        expect(result.pid).toBe(process.pid);
+        expect(result.version).toBe('0.5.1');
+        expect(typeof result.uptime).toBe('number');
+        expect(result.connectionState).toBe('disconnected');
+        expect(result.peerCount).toBe(0);
+    });
+    it('unknown method returns error', async () => {
+        const sock = await createServer();
+        const { client } = await createClient(sock);
+        await expect(client.request('nonexistent')).rejects.toThrow('Method not found');
+    });
+    it('custom method handler works', async () => {
+        const sock = await createServer();
+        server.registerMethod('echo', (params) => ({ echoed: params }));
+        const { client } = await createClient(sock);
+        const result = await client.request('echo', { message: 'hello' });
+        expect(result.echoed).toEqual({ message: 'hello' });
+    });
+    it('multiple clients can connect', async () => {
+        const sock = await createServer();
+        const { client: c1 } = await createClient(sock);
+        const { client: c2 } = await createClient(sock);
+        const r1 = await c1.request('ping');
+        const r2 = await c2.request('ping');
+        expect(r1.version).toBe('0.5.1');
+        expect(r2.version).toBe('0.5.1');
+        expect(server.getClientCount()).toBe(2);
+    });
+    it('subscribe-events enables notifications', async () => {
+        const sock = await createServer();
+        const { client } = await createClient(sock);
+        const received = [];
+        client.onNotification((method, params) => {
+            received.push({ method, params });
+        });
+        await client.request('subscribe-events');
+        // Broadcast a notification
+        server.broadcast({
+            jsonrpc: '2.0',
+            method: 'event.test',
+            params: { foo: 'bar' },
+        });
+        // Give the event a moment to arrive
+        await new Promise((r) => setTimeout(r, 50));
+        expect(received.length).toBe(1);
+        expect(received[0].method).toBe('event.test');
+        expect(received[0].params).toEqual({ foo: 'bar' });
+    });
+    it('shutdown request triggers shutdown event', async () => {
+        const sock = await createServer();
+        const { client } = await createClient(sock);
+        let shutdownRequested = false;
+        server.on('shutdown-requested', () => {
+            shutdownRequested = true;
+        });
+        const result = await client.request('shutdown');
+        expect(result.ok).toBe(true);
+        // Wait for nextTick
+        await new Promise((r) => setTimeout(r, 10));
+        expect(shutdownRequested).toBe(true);
+    });
+    it('client disconnect is detected by server', async () => {
+        const sock = await createServer();
+        const { client } = await createClient(sock);
+        expect(server.getClientCount()).toBe(1);
+        let disconnected = false;
+        server.on('client-disconnected', () => {
+            disconnected = true;
+        });
+        client.close();
+        // Wait for the close event to propagate
+        await new Promise((r) => setTimeout(r, 50));
+        expect(server.getClientCount()).toBe(0);
+        expect(disconnected).toBe(true);
+    });
+});
+//# sourceMappingURL=ipc.test.js.map

package/dist/service/ipc.test.js.map

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

package/dist/service/ipcClient.d.ts

@@ -0,0 +1,36 @@
+/**
+ * IPC client — connects to the daemon's Unix domain socket
+ * and speaks JSON-RPC 2.0 over newline-delimited transport.
+ *
+ * Used by CLI attach clients and (later) session workers.
+ */
+import type { HelloResult } from './types.js';
+export declare class IpcClient {
+    private socket;
+    private nextId;
+    private pending;
+    private notificationHandler?;
+    private buffer;
+    /** Connect to the daemon socket and perform the hello handshake. */
+    connect(socketPath: string): Promise<HelloResult>;
+    /** Send a JSON-RPC request and wait for the response. */
+    request<T = unknown>(method: string, params?: Record<string, unknown>, timeoutMs?: number): Promise<T>;
+    /** Send a JSON-RPC notification (fire-and-forget, no response expected). */
+    notify(method: string, params?: Record<string, unknown>): void;
+    /** Register a handler for server-pushed notifications. */
+    onNotification(handler: (method: string, params: Record<string, unknown>) => void): void;
+    /** Close the connection. */
+    close(): void;
+    get isConnected(): boolean;
+    private setupDataHandler;
+    private handleLine;
+}
+export declare class IpcDisconnectedError extends Error {
+    code: string;
+    constructor(message: string);
+}
+export declare class RpcError extends Error {
+    rpcCode: number;
+    constructor(message: string, rpcCode: number);
+}
+//# sourceMappingURL=ipcClient.d.ts.map

package/dist/service/ipcClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipcClient.d.ts","sourceRoot":"","sources":["../../src/service/ipcClient.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAIV,WAAW,EACZ,MAAM,YAAY,CAAC;AAYpB,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,OAAO,CAA8C;IAC7D,OAAO,CAAC,mBAAmB,CAAC,CAA4D;IACxF,OAAO,CAAC,MAAM,CAAM;IAEpB,oEAAoE;IAC9D,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAuCvD,yDAAyD;IACnD,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC;IA6B5G,4EAA4E;IAC5E,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAY9D,0DAA0D;IAC1D,cAAc,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG,IAAI;IAIxF,4BAA4B;IAC5B,KAAK,IAAI,IAAI;IAOb,IAAI,WAAW,IAAI,OAAO,CAEzB;IAMD,OAAO,CAAC,gBAAgB;IAcxB,OAAO,CAAC,UAAU;CA8BnB;AAMD,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,IAAI,SAAsB;gBACd,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,QAAS,SAAQ,KAAK;IAGxB,OAAO,EAAE,MAAM;gBADtB,OAAO,EAAE,MAAM,EACR,OAAO,EAAE,MAAM;CAKzB"}

package/dist/service/ipcClient.js

@@ -0,0 +1,167 @@
+/**
+ * IPC client — connects to the daemon's Unix domain socket
+ * and speaks JSON-RPC 2.0 over newline-delimited transport.
+ *
+ * Used by CLI attach clients and (later) session workers.
+ */
+import { connect } from 'net';
+import { IPC_VERSION, BUILD_ID } from './types.js';
+// Package version — matches package.json
+const PACKAGE_VERSION = '0.5.1';
+export class IpcClient {
+    socket = null;
+    nextId = 1;
+    pending = new Map();
+    notificationHandler;
+    buffer = '';
+    /** Connect to the daemon socket and perform the hello handshake. */
+    async connect(socketPath) {
+        return new Promise((resolve, reject) => {
+            const socket = connect(socketPath);
+            let connected = false;
+            socket.on('connect', () => {
+                connected = true;
+                this.socket = socket;
+                this.setupDataHandler(socket);
+                // Perform hello handshake
+                this.request('hello', {
+                    role: 'cli',
+                    version: PACKAGE_VERSION,
+                    ipcVersion: IPC_VERSION,
+                    buildId: BUILD_ID,
+                })
+                    .then(resolve)
+                    .catch(reject);
+            });
+            socket.on('error', (err) => {
+                if (!connected) {
+                    reject(err);
+                }
+            });
+            socket.on('close', () => {
+                // Reject all pending requests
+                for (const [, pending] of this.pending) {
+                    clearTimeout(pending.timer);
+                    pending.reject(new IpcDisconnectedError('IPC connection closed'));
+                }
+                this.pending.clear();
+                this.socket = null;
+            });
+        });
+    }
+    /** Send a JSON-RPC request and wait for the response. */
+    async request(method, params, timeoutMs = 10_000) {
+        if (!this.socket) {
+            throw new IpcDisconnectedError('Not connected');
+        }
+        const id = this.nextId++;
+        const request = {
+            jsonrpc: '2.0',
+            id,
+            method,
+            params: params ?? {},
+        };
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new Error(`RPC timeout: ${method}`));
+            }, timeoutMs);
+            this.pending.set(id, {
+                resolve: resolve,
+                reject,
+                timer,
+            });
+            this.socket.write(JSON.stringify(request) + '\n');
+        });
+    }
+    /** Send a JSON-RPC notification (fire-and-forget, no response expected). */
+    notify(method, params) {
+        if (!this.socket)
+            return;
+        const notification = {
+            jsonrpc: '2.0',
+            method,
+            params: params ?? {},
+        };
+        this.socket.write(JSON.stringify(notification) + '\n');
+    }
+    /** Register a handler for server-pushed notifications. */
+    onNotification(handler) {
+        this.notificationHandler = handler;
+    }
+    /** Close the connection. */
+    close() {
+        if (this.socket) {
+            this.socket.destroy();
+            this.socket = null;
+        }
+    }
+    get isConnected() {
+        return this.socket !== null && !this.socket.destroyed;
+    }
+    // -----------------------------------------------------------------------
+    // Data parsing
+    // -----------------------------------------------------------------------
+    setupDataHandler(socket) {
+        socket.on('data', (data) => {
+            this.buffer += data.toString();
+            let newlineIndex;
+            while ((newlineIndex = this.buffer.indexOf('\n')) !== -1) {
+                const line = this.buffer.slice(0, newlineIndex);
+                this.buffer = this.buffer.slice(newlineIndex + 1);
+                if (line.trim()) {
+                    this.handleLine(line);
+                }
+            }
+        });
+    }
+    handleLine(line) {
+        let msg;
+        try {
+            msg = JSON.parse(line);
+        }
+        catch {
+            return; // Ignore malformed messages
+        }
+        // JSON-RPC response (has id + result/error)
+        if (msg.id != null && ('result' in msg || 'error' in msg)) {
+            const pending = this.pending.get(msg.id);
+            if (pending) {
+                this.pending.delete(msg.id);
+                clearTimeout(pending.timer);
+                if (msg.error) {
+                    const err = new RpcError(msg.error.message, msg.error.code);
+                    pending.reject(err);
+                }
+                else {
+                    pending.resolve(msg.result);
+                }
+            }
+            return;
+        }
+        // JSON-RPC notification (has method, no id)
+        if (msg.method && msg.id == null) {
+            this.notificationHandler?.(msg.method, msg.params ?? {});
+            return;
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Custom errors
+// ---------------------------------------------------------------------------
+export class IpcDisconnectedError extends Error {
+    code = 'IPC_DISCONNECTED';
+    constructor(message) {
+        super(message);
+        this.name = 'IpcDisconnectedError';
+    }
+}
+export class RpcError extends Error {
+    rpcCode;
+    constructor(message, rpcCode) {
+        super(message);
+        this.rpcCode = rpcCode;
+        this.name = 'RpcError';
+    }
+}
+//# sourceMappingURL=ipcClient.js.map

package/dist/service/ipcClient.js.map

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

package/dist/service/ipcServer.d.ts

@@ -0,0 +1,53 @@
+/**
+ * IPC server — JSON-RPC 2.0 over newline-delimited Unix domain socket.
+ *
+ * The daemon creates this server on startup. CLI clients and session workers
+ * connect to it as JSON-RPC clients.
+ */
+import { type Socket } from 'net';
+import { EventEmitter } from 'events';
+import type { JsonRpcNotification, StatusResult } from './types.js';
+export interface IpcClient {
+    id: string;
+    role?: 'cli' | 'worker';
+    sessionId?: string;
+    subscribed: boolean;
+    socket: Socket;
+}
+export type MethodHandler = (params: Record<string, unknown>, client: IpcClient) => Promise<unknown> | unknown;
+export declare class IpcServer extends EventEmitter {
+    private server;
+    private clients;
+    private methods;
+    private nextClientId;
+    private startedAt;
+    private version;
+    private statusProvider?;
+    constructor(opts: {
+        version: string;
+    });
+    /** Register a JSON-RPC method handler. */
+    registerMethod(method: string, handler: MethodHandler): void;
+    /** Set a provider for live status data (wired after AgentConnection starts). */
+    setStatusProvider(fn: () => StatusResult): void;
+    /** Start listening on the given Unix socket path. */
+    listen(socketPath: string): Promise<void>;
+    /** Gracefully close the server and all client connections. */
+    close(): Promise<void>;
+    /** Get the number of connected clients. */
+    getClientCount(): number;
+    /** Broadcast a JSON-RPC notification to all subscribed CLI clients. */
+    broadcast(notification: JsonRpcNotification): void;
+    /** Send a JSON-RPC request to a specific client (for daemon→worker commands). */
+    sendRequest(clientId: string, method: string, params: Record<string, unknown>, id: number | string): boolean;
+    private onConnection;
+    private handleLine;
+    private handleHello;
+    private handlePing;
+    private handleStatus;
+    private handleShutdown;
+    private handleSubscribe;
+    private sendMessage;
+    private sendError;
+}
+//# sourceMappingURL=ipcServer.d.ts.map

package/dist/service/ipcServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipcServer.d.ts","sourceRoot":"","sources":["../../src/service/ipcServer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAA6B,KAAK,MAAM,EAAE,MAAM,KAAK,CAAC;AAE7D,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAGV,mBAAmB,EAKnB,YAAY,EACb,MAAM,YAAY,CAAC;AAOpB,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD,MAAM,MAAM,aAAa,GAAG,CAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,SAAS,KACd,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;AAMhC,qBAAa,SAAU,SAAQ,YAAY;IACzC,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,OAAO,CAAoC;IACnD,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,SAAS,CAAO;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,cAAc,CAAC,CAAqB;gBAEhC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE;IAarC,0CAA0C;IAC1C,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI;IAI5D,gFAAgF;IAChF,iBAAiB,CAAC,EAAE,EAAE,MAAM,YAAY,GAAG,IAAI;IAI/C,qDAAqD;IAC/C,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA2B/C,8DAA8D;IACxD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB5B,2CAA2C;IAC3C,cAAc,IAAI,MAAM;IAIxB,uEAAuE;IACvE,SAAS,CAAC,YAAY,EAAE,mBAAmB,GAAG,IAAI;IAQlD,iFAAiF;IACjF,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO;IAY5G,OAAO,CAAC,YAAY;YAiCN,UAAU;IAkDxB,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,SAAS;CAQlB"}