@sumicom/quicksave 0.4.0 → 0.5.0

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.0' });
+        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.0');
+        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.0');
+        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.0');
+        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.0');
+        expect(r2.version).toBe('0.5.0');
+        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.0';
+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"}

package/dist/service/ipcServer.js

@@ -0,0 +1,245 @@
+/**
+ * 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 { createServer } from 'net';
+import { unlinkSync, chmodSync } from 'fs';
+import { EventEmitter } from 'events';
+import { IPC_VERSION, BUILD_ID, RpcErrorCode } from './types.js';
+// ---------------------------------------------------------------------------
+// IpcServer
+// ---------------------------------------------------------------------------
+export class IpcServer extends EventEmitter {
+    server = null;
+    clients = new Map();
+    methods = new Map();
+    nextClientId = 1;
+    startedAt;
+    version;
+    statusProvider;
+    constructor(opts) {
+        super();
+        this.version = opts.version;
+        this.startedAt = new Date();
+        // Register built-in methods
+        this.registerMethod('hello', (params) => this.handleHello(params));
+        this.registerMethod('ping', () => this.handlePing());
+        this.registerMethod('status', () => this.handleStatus());
+        this.registerMethod('shutdown', (_params, client) => this.handleShutdown(client));
+        this.registerMethod('subscribe-events', (_params, client) => this.handleSubscribe(client));
+    }
+    /** Register a JSON-RPC method handler. */
+    registerMethod(method, handler) {
+        this.methods.set(method, handler);
+    }
+    /** Set a provider for live status data (wired after AgentConnection starts). */
+    setStatusProvider(fn) {
+        this.statusProvider = fn;
+    }
+    /** Start listening on the given Unix socket path. */
+    async listen(socketPath) {
+        // Remove stale socket file if present
+        try {
+            unlinkSync(socketPath);
+        }
+        catch (err) {
+            if (err.code !== 'ENOENT')
+                throw err;
+        }
+        return new Promise((resolve, reject) => {
+            this.server = createServer((socket) => this.onConnection(socket));
+            this.server.on('error', (err) => {
+                reject(err);
+            });
+            this.server.listen(socketPath, () => {
+                // Set socket permissions to owner-only
+                try {
+                    chmodSync(socketPath, 0o600);
+                }
+                catch {
+                    // Best effort — may fail on some systems
+                }
+                resolve();
+            });
+        });
+    }
+    /** Gracefully close the server and all client connections. */
+    async close() {
+        // Notify subscribed clients
+        this.broadcast({
+            jsonrpc: '2.0',
+            method: 'event.daemonStatus',
+            params: { shutting_down: true },
+        });
+        // Close all client sockets
+        for (const client of this.clients.values()) {
+            client.socket.destroy();
+        }
+        this.clients.clear();
+        return new Promise((resolve) => {
+            if (this.server) {
+                this.server.close(() => resolve());
+            }
+            else {
+                resolve();
+            }
+        });
+    }
+    /** Get the number of connected clients. */
+    getClientCount() {
+        return this.clients.size;
+    }
+    /** Broadcast a JSON-RPC notification to all subscribed CLI clients. */
+    broadcast(notification) {
+        for (const client of this.clients.values()) {
+            if (client.subscribed) {
+                this.sendMessage(client.socket, notification);
+            }
+        }
+    }
+    /** Send a JSON-RPC request to a specific client (for daemon→worker commands). */
+    sendRequest(clientId, method, params, id) {
+        const client = this.clients.get(clientId);
+        if (!client)
+            return false;
+        const request = { jsonrpc: '2.0', id, method, params };
+        this.sendMessage(client.socket, request);
+        return true;
+    }
+    // -----------------------------------------------------------------------
+    // Connection handling
+    // -----------------------------------------------------------------------
+    onConnection(socket) {
+        const clientId = `c${this.nextClientId++}`;
+        const client = {
+            id: clientId,
+            subscribed: false,
+            socket,
+        };
+        this.clients.set(clientId, client);
+        let buffer = '';
+        socket.on('data', (data) => {
+            buffer += data.toString();
+            let newlineIndex;
+            while ((newlineIndex = buffer.indexOf('\n')) !== -1) {
+                const line = buffer.slice(0, newlineIndex);
+                buffer = buffer.slice(newlineIndex + 1);
+                if (line.trim()) {
+                    this.handleLine(line, client);
+                }
+            }
+        });
+        socket.on('close', () => {
+            this.clients.delete(clientId);
+            this.emit('client-disconnected', client);
+        });
+        socket.on('error', () => {
+            this.clients.delete(clientId);
+        });
+    }
+    async handleLine(line, client) {
+        let msg;
+        try {
+            msg = JSON.parse(line);
+        }
+        catch {
+            this.sendError(client.socket, null, RpcErrorCode.PARSE_ERROR, 'Parse error');
+            return;
+        }
+        // Ignore responses (we don't expect them from clients in this direction, but workers may ack)
+        if ('result' in msg || 'error' in msg) {
+            this.emit('response', msg, client);
+            return;
+        }
+        // Must have a method
+        if (!('method' in msg) || typeof msg.method !== 'string') {
+            this.sendError(client.socket, msg.id ?? null, RpcErrorCode.INVALID_REQUEST, 'Invalid request');
+            return;
+        }
+        const handler = this.methods.get(msg.method);
+        if (!handler) {
+            if ('id' in msg && msg.id != null) {
+                this.sendError(client.socket, msg.id, RpcErrorCode.METHOD_NOT_FOUND, `Method not found: ${msg.method}`);
+            }
+            return;
+        }
+        const params = ('params' in msg ? msg.params : {});
+        try {
+            const result = await handler(params, client);
+            // Only send response if it's a request (has id), not a notification
+            if ('id' in msg && msg.id != null) {
+                const response = { jsonrpc: '2.0', id: msg.id, result };
+                this.sendMessage(client.socket, response);
+            }
+        }
+        catch (err) {
+            if ('id' in msg && msg.id != null) {
+                const code = err.rpcCode ?? RpcErrorCode.INVALID_PARAMS;
+                this.sendError(client.socket, msg.id, code, err.message ?? 'Internal error');
+            }
+        }
+    }
+    // -----------------------------------------------------------------------
+    // Built-in method handlers
+    // -----------------------------------------------------------------------
+    handleHello(_params) {
+        // hello always succeeds — client decides based on version fields
+        return {
+            daemonVersion: this.version,
+            daemonIpcVersion: IPC_VERSION,
+            daemonBuildId: BUILD_ID,
+            daemonPid: process.pid,
+        };
+    }
+    handlePing() {
+        const uptimeMs = Date.now() - this.startedAt.getTime();
+        return {
+            version: this.version,
+            ipcVersion: IPC_VERSION,
+            buildId: BUILD_ID,
+            uptime: Math.floor(uptimeMs / 1000),
+        };
+    }
+    handleStatus() {
+        if (this.statusProvider)
+            return this.statusProvider();
+        const uptimeMs = Date.now() - this.startedAt.getTime();
+        return {
+            version: this.version,
+            pid: process.pid,
+            uptime: Math.floor(uptimeMs / 1000),
+            connectionState: 'disconnected',
+            peerCount: 0,
+            activeSessions: 0,
+            managedRepos: 0,
+        };
+    }
+    handleShutdown(_client) {
+        // Schedule shutdown on next tick so the response gets sent first
+        process.nextTick(() => this.emit('shutdown-requested'));
+        return { ok: true };
+    }
+    handleSubscribe(client) {
+        client.subscribed = true;
+        return { subscribed: true };
+    }
+    // -----------------------------------------------------------------------
+    // Wire helpers
+    // -----------------------------------------------------------------------
+    sendMessage(socket, msg) {
+        if (!socket.destroyed) {
+            socket.write(JSON.stringify(msg) + '\n');
+        }
+    }
+    sendError(socket, id, code, message) {
+        const response = {
+            jsonrpc: '2.0',
+            id: id ?? 0,
+            error: { code, message },
+        };
+        this.sendMessage(socket, response);
+    }
+}
+//# sourceMappingURL=ipcServer.js.map