@draht/coding-agent 2026.3.5 → 2026.3.11-1

package/dist/core/socket-server/socket-client.js

@@ -0,0 +1,197 @@
+/**
+ * SocketClient - Client for attaching to a draht socket session
+ *
+ * Connects to a Unix domain socket, sends input, and receives output.
+ * Used when running `draht --attach <session-id>`.
+ */
+import { connect } from "node:net";
+/**
+ * SocketClient connects to a socket-based draht session.
+ *
+ * Provides callbacks for output, metadata, and connection events.
+ */
+export class SocketClient {
+    #socketPath;
+    #clientId;
+    #mode;
+    #socket = null;
+    #buffer = "";
+    /** Callbacks */
+    #onOutput = null;
+    #onMetadata = null;
+    #onClientJoined = null;
+    #onClientLeft = null;
+    #onInputEcho = null;
+    #onError = null;
+    #onDisconnect = null;
+    constructor(options) {
+        this.#socketPath = options.socketPath;
+        this.#clientId = options.clientId ?? `client-${crypto.randomUUID().slice(0, 8)}`;
+        this.#mode = options.mode ?? "read-write";
+    }
+    /**
+     * Connect to the socket server.
+     */
+    async connect() {
+        return new Promise((resolve, reject) => {
+            this.#socket = connect(this.#socketPath);
+            this.#socket.on("connect", () => {
+                // Send attach message
+                const attach = {
+                    type: "attach",
+                    clientId: this.#clientId,
+                    mode: this.#mode,
+                };
+                this.#send(attach);
+                resolve();
+            });
+            this.#socket.on("data", (data) => {
+                this.#handleData(data);
+            });
+            this.#socket.on("close", () => {
+                if (this.#onDisconnect) {
+                    this.#onDisconnect();
+                }
+            });
+            this.#socket.on("error", (err) => {
+                reject(err);
+            });
+        });
+    }
+    /**
+     * Disconnect from the socket server.
+     */
+    disconnect() {
+        if (this.#socket) {
+            const detach = {
+                type: "detach",
+                clientId: this.#clientId,
+            };
+            this.#send(detach);
+            this.#socket.end();
+            this.#socket = null;
+        }
+    }
+    /**
+     * Send input to the session.
+     */
+    sendInput(data) {
+        if (!this.#socket) {
+            throw new Error("Not connected");
+        }
+        const input = {
+            type: "input",
+            data,
+            clientId: this.#clientId,
+        };
+        this.#send(input);
+    }
+    /**
+     * Set callback for output received from session.
+     */
+    onOutput(callback) {
+        this.#onOutput = callback;
+    }
+    /**
+     * Set callback for session metadata (received on attach).
+     */
+    onMetadata(callback) {
+        this.#onMetadata = callback;
+    }
+    /**
+     * Set callback for when another client joins.
+     */
+    onClientJoined(callback) {
+        this.#onClientJoined = callback;
+    }
+    /**
+     * Set callback for when another client leaves.
+     */
+    onClientLeft(callback) {
+        this.#onClientLeft = callback;
+    }
+    /**
+     * Set callback for input echo from other clients.
+     */
+    onInputEcho(callback) {
+        this.#onInputEcho = callback;
+    }
+    /**
+     * Set callback for errors.
+     */
+    onError(callback) {
+        this.#onError = callback;
+    }
+    /**
+     * Set callback for disconnect.
+     */
+    onDisconnect(callback) {
+        this.#onDisconnect = callback;
+    }
+    /**
+     * Handle incoming data from server.
+     */
+    #handleData(data) {
+        this.#buffer += data.toString();
+        const lines = this.#buffer.split("\n");
+        this.#buffer = lines.pop() || "";
+        for (const line of lines) {
+            if (!line.trim())
+                continue;
+            try {
+                const message = JSON.parse(line);
+                this.#handleServerMessage(message);
+            }
+            catch {
+                // Ignore malformed messages
+            }
+        }
+    }
+    /**
+     * Handle a server message.
+     */
+    #handleServerMessage(message) {
+        switch (message.type) {
+            case "output":
+                if (this.#onOutput) {
+                    this.#onOutput(message.data, message.stream);
+                }
+                break;
+            case "input_echo":
+                if (this.#onInputEcho) {
+                    this.#onInputEcho(message.data, message.clientId);
+                }
+                break;
+            case "client_joined":
+                if (this.#onClientJoined) {
+                    this.#onClientJoined(message.clientId, message.mode);
+                }
+                break;
+            case "client_left":
+                if (this.#onClientLeft) {
+                    this.#onClientLeft(message.clientId);
+                }
+                break;
+            case "session_metadata":
+                if (this.#onMetadata) {
+                    this.#onMetadata(message.sessionId, message.cwd, new Date(message.createdAt));
+                }
+                break;
+            case "error":
+                if (this.#onError) {
+                    this.#onError(message.message);
+                }
+                break;
+        }
+    }
+    /**
+     * Send a message to the server.
+     */
+    #send(message) {
+        if (!this.#socket)
+            return;
+        const json = `${JSON.stringify(message)}\n`;
+        this.#socket.write(json);
+    }
+}
+//# sourceMappingURL=socket-client.js.map

package/dist/core/socket-server/socket-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket-client.js","sourceRoot":"","sources":["../../../src/core/socket-server/socket-client.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * SocketClient - Client for attaching to a draht socket session\n *\n * Connects to a Unix domain socket, sends input, and receives output.\n * Used when running `draht --attach <session-id>`.\n */\n\nimport { connect, type Socket } from \"node:net\";\nimport type { ClientMessage, ClientMode, ServerMessage } from \"./types.js\";\n\nexport interface SocketClientOptions {\n\t/** Path to the Unix socket */\n\tsocketPath: string;\n\t/** Client identifier (defaults to random ID) */\n\tclientId?: string;\n\t/** Connection mode */\n\tmode?: ClientMode;\n}\n\n/**\n * SocketClient connects to a socket-based draht session.\n *\n * Provides callbacks for output, metadata, and connection events.\n */\nexport class SocketClient {\n\treadonly #socketPath: string;\n\treadonly #clientId: string;\n\treadonly #mode: ClientMode;\n\n\t#socket: Socket | null = null;\n\t#buffer = \"\";\n\n\t/** Callbacks */\n\t#onOutput: ((data: string, stream: \"stdout\" | \"stderr\") => void) | null = null;\n\t#onMetadata: ((sessionId: string, cwd: string, createdAt: Date) => void) | null = null;\n\t#onClientJoined: ((clientId: string, mode: ClientMode) => void) | null = null;\n\t#onClientLeft: ((clientId: string) => void) | null = null;\n\t#onInputEcho: ((data: string, clientId: string) => void) | null = null;\n\t#onError: ((message: string) => void) | null = null;\n\t#onDisconnect: (() => void) | null = null;\n\n\tconstructor(options: SocketClientOptions) {\n\t\tthis.#socketPath = options.socketPath;\n\t\tthis.#clientId = options.clientId ?? `client-${crypto.randomUUID().slice(0, 8)}`;\n\t\tthis.#mode = options.mode ?? \"read-write\";\n\t}\n\n\t/**\n\t * Connect to the socket server.\n\t */\n\tasync connect(): Promise<void> {\n\t\treturn new Promise((resolve, reject) => {\n\t\t\tthis.#socket = connect(this.#socketPath);\n\n\t\t\tthis.#socket.on(\"connect\", () => {\n\t\t\t\t// Send attach message\n\t\t\t\tconst attach: ClientMessage = {\n\t\t\t\t\ttype: \"attach\",\n\t\t\t\t\tclientId: this.#clientId,\n\t\t\t\t\tmode: this.#mode,\n\t\t\t\t};\n\t\t\t\tthis.#send(attach);\n\t\t\t\tresolve();\n\t\t\t});\n\n\t\t\tthis.#socket.on(\"data\", (data) => {\n\t\t\t\tthis.#handleData(data);\n\t\t\t});\n\n\t\t\tthis.#socket.on(\"close\", () => {\n\t\t\t\tif (this.#onDisconnect) {\n\t\t\t\t\tthis.#onDisconnect();\n\t\t\t\t}\n\t\t\t});\n\n\t\t\tthis.#socket.on(\"error\", (err) => {\n\t\t\t\treject(err);\n\t\t\t});\n\t\t});\n\t}\n\n\t/**\n\t * Disconnect from the socket server.\n\t */\n\tdisconnect(): void {\n\t\tif (this.#socket) {\n\t\t\tconst detach: ClientMessage = {\n\t\t\t\ttype: \"detach\",\n\t\t\t\tclientId: this.#clientId,\n\t\t\t};\n\t\t\tthis.#send(detach);\n\t\t\tthis.#socket.end();\n\t\t\tthis.#socket = null;\n\t\t}\n\t}\n\n\t/**\n\t * Send input to the session.\n\t */\n\tsendInput(data: string): void {\n\t\tif (!this.#socket) {\n\t\t\tthrow new Error(\"Not connected\");\n\t\t}\n\n\t\tconst input: ClientMessage = {\n\t\t\ttype: \"input\",\n\t\t\tdata,\n\t\t\tclientId: this.#clientId,\n\t\t};\n\t\tthis.#send(input);\n\t}\n\n\t/**\n\t * Set callback for output received from session.\n\t */\n\tonOutput(callback: (data: string, stream: \"stdout\" | \"stderr\") => void): void {\n\t\tthis.#onOutput = callback;\n\t}\n\n\t/**\n\t * Set callback for session metadata (received on attach).\n\t */\n\tonMetadata(callback: (sessionId: string, cwd: string, createdAt: Date) => void): void {\n\t\tthis.#onMetadata = callback;\n\t}\n\n\t/**\n\t * Set callback for when another client joins.\n\t */\n\tonClientJoined(callback: (clientId: string, mode: ClientMode) => void): void {\n\t\tthis.#onClientJoined = callback;\n\t}\n\n\t/**\n\t * Set callback for when another client leaves.\n\t */\n\tonClientLeft(callback: (clientId: string) => void): void {\n\t\tthis.#onClientLeft = callback;\n\t}\n\n\t/**\n\t * Set callback for input echo from other clients.\n\t */\n\tonInputEcho(callback: (data: string, clientId: string) => void): void {\n\t\tthis.#onInputEcho = callback;\n\t}\n\n\t/**\n\t * Set callback for errors.\n\t */\n\tonError(callback: (message: string) => void): void {\n\t\tthis.#onError = callback;\n\t}\n\n\t/**\n\t * Set callback for disconnect.\n\t */\n\tonDisconnect(callback: () => void): void {\n\t\tthis.#onDisconnect = callback;\n\t}\n\n\t/**\n\t * Handle incoming data from server.\n\t */\n\t#handleData(data: Buffer): void {\n\t\tthis.#buffer += data.toString();\n\t\tconst lines = this.#buffer.split(\"\\n\");\n\t\tthis.#buffer = lines.pop() || \"\";\n\n\t\tfor (const line of lines) {\n\t\t\tif (!line.trim()) continue;\n\n\t\t\ttry {\n\t\t\t\tconst message = JSON.parse(line) as ServerMessage;\n\t\t\t\tthis.#handleServerMessage(message);\n\t\t\t} catch {\n\t\t\t\t// Ignore malformed messages\n\t\t\t}\n\t\t}\n\t}\n\n\t/**\n\t * Handle a server message.\n\t */\n\t#handleServerMessage(message: ServerMessage): void {\n\t\tswitch (message.type) {\n\t\t\tcase \"output\":\n\t\t\t\tif (this.#onOutput) {\n\t\t\t\t\tthis.#onOutput(message.data, message.stream);\n\t\t\t\t}\n\t\t\t\tbreak;\n\n\t\t\tcase \"input_echo\":\n\t\t\t\tif (this.#onInputEcho) {\n\t\t\t\t\tthis.#onInputEcho(message.data, message.clientId);\n\t\t\t\t}\n\t\t\t\tbreak;\n\n\t\t\tcase \"client_joined\":\n\t\t\t\tif (this.#onClientJoined) {\n\t\t\t\t\tthis.#onClientJoined(message.clientId, message.mode);\n\t\t\t\t}\n\t\t\t\tbreak;\n\n\t\t\tcase \"client_left\":\n\t\t\t\tif (this.#onClientLeft) {\n\t\t\t\t\tthis.#onClientLeft(message.clientId);\n\t\t\t\t}\n\t\t\t\tbreak;\n\n\t\t\tcase \"session_metadata\":\n\t\t\t\tif (this.#onMetadata) {\n\t\t\t\t\tthis.#onMetadata(message.sessionId, message.cwd, new Date(message.createdAt));\n\t\t\t\t}\n\t\t\t\tbreak;\n\n\t\t\tcase \"error\":\n\t\t\t\tif (this.#onError) {\n\t\t\t\t\tthis.#onError(message.message);\n\t\t\t\t}\n\t\t\t\tbreak;\n\t\t}\n\t}\n\n\t/**\n\t * Send a message to the server.\n\t */\n\t#send(message: ClientMessage): void {\n\t\tif (!this.#socket) return;\n\t\tconst json = `${JSON.stringify(message)}\\n`;\n\t\tthis.#socket.write(json);\n\t}\n}\n"]}

package/dist/core/socket-server/socket-server.d.ts

@@ -0,0 +1,60 @@
+/**
+ * SocketServer - Unix domain socket server for attachable draht sessions
+ *
+ * Enables tmux-style multi-client attachment:
+ * - Multiple readers/writers can connect simultaneously
+ * - All clients see the same output
+ * - Input from any client is echoed to all others
+ * - Clients can join/leave without disrupting the session
+ */
+export interface SocketServerOptions {
+    /** Session ID (used for socket filename) */
+    sessionId: string;
+    /** Directory for socket files (default: ~/.draht/agent/sockets) */
+    socketDir: string;
+    /** Current working directory (included in metadata) */
+    cwd: string;
+    /** Maximum number of concurrent clients */
+    maxClients?: number;
+    /** Whether to echo input to all clients (tmux-style) */
+    broadcastInputEcho?: boolean;
+}
+/**
+ * SocketServer manages a Unix domain socket for a single draht session.
+ *
+ * Clients connect, send input, and receive output in real-time.
+ * All communication uses JSON-over-socket with newline framing.
+ */
+export declare class SocketServer {
+    #private;
+    constructor(options: SocketServerOptions);
+    /**
+     * Start the socket server.
+     * Creates socket directory, binds Unix socket, and starts listening.
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the socket server and clean up.
+     */
+    stop(): Promise<void>;
+    /**
+     * Broadcast output to all connected clients.
+     *
+     * @param data - Output text
+     * @param stream - Output stream (stdout or stderr)
+     */
+    broadcastOutput(data: string, stream?: "stdout" | "stderr"): void;
+    /**
+     * Set callback for input received from clients.
+     */
+    onInput(callback: (data: string, clientId: string) => void): void;
+    /**
+     * Get socket path for this session.
+     */
+    get socketPath(): string;
+    /**
+     * Get number of connected clients.
+     */
+    get clientCount(): number;
+}
+//# sourceMappingURL=socket-server.d.ts.map

package/dist/core/socket-server/socket-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket-server.d.ts","sourceRoot":"","sources":["../../../src/core/socket-server/socket-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,MAAM,WAAW,mBAAmB;IACnC,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,GAAG,EAAE,MAAM,CAAC;IACZ,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;GAKG;AACH,qBAAa,YAAY;;IAexB,YAAY,OAAO,EAAE,mBAAmB,EAQvC;IAED;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAwB3B;IAED;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAkB1B;IAED;;;;;OAKG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,QAAQ,GAAG,QAAmB,GAAG,IAAI,CAO1E;IAED;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAEhE;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,CAExB;CAmLD","sourcesContent":["/**\n * SocketServer - Unix domain socket server for attachable draht sessions\n *\n * Enables tmux-style multi-client attachment:\n * - Multiple readers/writers can connect simultaneously\n * - All clients see the same output\n * - Input from any client is echoed to all others\n * - Clients can join/leave without disrupting the session\n */\n\nimport { existsSync } from \"node:fs\";\nimport { mkdir, rm, writeFile } from \"node:fs/promises\";\nimport { createServer, type Server, type Socket } from \"node:net\";\nimport path from \"node:path\";\nimport type { ClientMessage, ClientMode, ConnectedClient, ServerMessage } from \"./types.js\";\n\nexport interface SocketServerOptions {\n\t/** Session ID (used for socket filename) */\n\tsessionId: string;\n\t/** Directory for socket files (default: ~/.draht/agent/sockets) */\n\tsocketDir: string;\n\t/** Current working directory (included in metadata) */\n\tcwd: string;\n\t/** Maximum number of concurrent clients */\n\tmaxClients?: number;\n\t/** Whether to echo input to all clients (tmux-style) */\n\tbroadcastInputEcho?: boolean;\n}\n\n/**\n * SocketServer manages a Unix domain socket for a single draht session.\n *\n * Clients connect, send input, and receive output in real-time.\n * All communication uses JSON-over-socket with newline framing.\n */\nexport class SocketServer {\n\treadonly #sessionId: string;\n\treadonly #socketPath: string;\n\treadonly #lockPath: string;\n\treadonly #cwd: string;\n\treadonly #maxClients: number;\n\treadonly #broadcastInputEcho: boolean;\n\n\t#server: Server | null = null;\n\t#clients = new Map<string, ConnectedClient>();\n\t#createdAt = new Date();\n\n\t/** Callback for input received from any client */\n\t#onInput: ((data: string, clientId: string) => void) | null = null;\n\n\tconstructor(options: SocketServerOptions) {\n\t\tthis.#sessionId = options.sessionId;\n\t\tthis.#cwd = options.cwd;\n\t\tthis.#maxClients = options.maxClients ?? 10;\n\t\tthis.#broadcastInputEcho = options.broadcastInputEcho ?? true;\n\n\t\tthis.#socketPath = path.join(options.socketDir, `${options.sessionId}.sock`);\n\t\tthis.#lockPath = path.join(options.socketDir, `${options.sessionId}.lock`);\n\t}\n\n\t/**\n\t * Start the socket server.\n\t * Creates socket directory, binds Unix socket, and starts listening.\n\t */\n\tasync start(): Promise<void> {\n\t\t// Ensure socket directory exists\n\t\tconst socketDir = path.dirname(this.#socketPath);\n\t\tawait mkdir(socketDir, { recursive: true, mode: 0o700 });\n\n\t\t// Clean up stale socket if it exists\n\t\tif (existsSync(this.#socketPath)) {\n\t\t\tawait rm(this.#socketPath, { force: true });\n\t\t}\n\n\t\t// Write PID lock file for cleanup on crash\n\t\tawait writeFile(this.#lockPath, `${process.pid}\\n${this.#cwd}\\n${this.#createdAt.toISOString()}`);\n\n\t\t// Create Unix domain socket server\n\t\tthis.#server = createServer((socket) => this.#handleConnection(socket));\n\n\t\t// Bind to socket path\n\t\tawait new Promise<void>((resolve, reject) => {\n\t\t\tthis.#server!.listen(this.#socketPath, () => resolve());\n\t\t\tthis.#server!.on(\"error\", reject);\n\t\t});\n\n\t\t// Set socket permissions (owner-only)\n\t\tawait import(\"node:fs/promises\").then((fs) => fs.chmod(this.#socketPath, 0o600));\n\t}\n\n\t/**\n\t * Stop the socket server and clean up.\n\t */\n\tasync stop(): Promise<void> {\n\t\t// Disconnect all clients\n\t\tfor (const client of this.#clients.values()) {\n\t\t\tclient.socket.end();\n\t\t}\n\t\tthis.#clients.clear();\n\n\t\t// Close server\n\t\tif (this.#server) {\n\t\t\tawait new Promise<void>((resolve) => {\n\t\t\t\tthis.#server!.close(() => resolve());\n\t\t\t});\n\t\t\tthis.#server = null;\n\t\t}\n\n\t\t// Clean up socket and lock files\n\t\tawait rm(this.#socketPath, { force: true });\n\t\tawait rm(this.#lockPath, { force: true });\n\t}\n\n\t/**\n\t * Broadcast output to all connected clients.\n\t *\n\t * @param data - Output text\n\t * @param stream - Output stream (stdout or stderr)\n\t */\n\tbroadcastOutput(data: string, stream: \"stdout\" | \"stderr\" = \"stdout\"): void {\n\t\tconst message: ServerMessage = {\n\t\t\ttype: \"output\",\n\t\t\tdata,\n\t\t\tstream,\n\t\t};\n\t\tthis.#broadcast(message);\n\t}\n\n\t/**\n\t * Set callback for input received from clients.\n\t */\n\tonInput(callback: (data: string, clientId: string) => void): void {\n\t\tthis.#onInput = callback;\n\t}\n\n\t/**\n\t * Get socket path for this session.\n\t */\n\tget socketPath(): string {\n\t\treturn this.#socketPath;\n\t}\n\n\t/**\n\t * Get number of connected clients.\n\t */\n\tget clientCount(): number {\n\t\treturn this.#clients.size;\n\t}\n\n\t/**\n\t * Handle new client connection.\n\t */\n\t#handleConnection(socket: Socket): void {\n\t\tlet clientId: string | null = null;\n\t\tlet _mode: ClientMode = \"read-write\";\n\t\tlet buffer = \"\";\n\n\t\t// Handle incoming data (JSON messages)\n\t\tsocket.on(\"data\", (data) => {\n\t\t\tbuffer += data.toString();\n\t\t\tconst lines = buffer.split(\"\\n\");\n\t\t\tbuffer = lines.pop() || \"\";\n\n\t\t\tfor (const line of lines) {\n\t\t\t\tif (!line.trim()) continue;\n\n\t\t\t\ttry {\n\t\t\t\t\tconst message = JSON.parse(line) as ClientMessage;\n\t\t\t\t\tthis.#handleClientMessage(message, socket, (id, m) => {\n\t\t\t\t\t\tclientId = id;\n\t\t\t\t\t\t_mode = m;\n\t\t\t\t\t});\n\t\t\t\t} catch (_err) {\n\t\t\t\t\tthis.#sendError(socket, \"Invalid JSON message\");\n\t\t\t\t}\n\t\t\t}\n\t\t});\n\n\t\t// Handle client disconnect\n\t\tsocket.on(\"close\", () => {\n\t\t\tif (clientId) {\n\t\t\t\tthis.#handleClientDisconnect(clientId);\n\t\t\t}\n\t\t});\n\n\t\tsocket.on(\"error\", () => {\n\t\t\tif (clientId) {\n\t\t\t\tthis.#handleClientDisconnect(clientId);\n\t\t\t}\n\t\t});\n\t}\n\n\t/**\n\t * Handle a client message.\n\t */\n\t#handleClientMessage(\n\t\tmessage: ClientMessage,\n\t\tsocket: Socket,\n\t\tonAttach: (id: string, mode: ClientMode) => void,\n\t): void {\n\t\tswitch (message.type) {\n\t\t\tcase \"attach\": {\n\t\t\t\t// Check max clients\n\t\t\t\tif (this.#clients.size >= this.#maxClients) {\n\t\t\t\t\tthis.#sendError(socket, \"Maximum clients reached\");\n\t\t\t\t\tsocket.end();\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\t// Check for duplicate client ID\n\t\t\t\tif (this.#clients.has(message.clientId)) {\n\t\t\t\t\tthis.#sendError(socket, \"Client ID already connected\");\n\t\t\t\t\tsocket.end();\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\t// Register client\n\t\t\t\tconst client: ConnectedClient = {\n\t\t\t\t\tid: message.clientId,\n\t\t\t\t\tmode: message.mode,\n\t\t\t\t\tsocket,\n\t\t\t\t\tconnectedAt: new Date(),\n\t\t\t\t};\n\t\t\t\tthis.#clients.set(message.clientId, client);\n\t\t\t\tonAttach(message.clientId, message.mode);\n\n\t\t\t\t// Send session metadata\n\t\t\t\tconst metadata: ServerMessage = {\n\t\t\t\t\ttype: \"session_metadata\",\n\t\t\t\t\tsessionId: this.#sessionId,\n\t\t\t\t\tcwd: this.#cwd,\n\t\t\t\t\tcreatedAt: this.#createdAt.toISOString(),\n\t\t\t\t};\n\t\t\t\tthis.#send(socket, metadata);\n\n\t\t\t\t// Notify other clients\n\t\t\t\tconst joined: ServerMessage = {\n\t\t\t\t\ttype: \"client_joined\",\n\t\t\t\t\tclientId: message.clientId,\n\t\t\t\t\tmode: message.mode,\n\t\t\t\t};\n\t\t\t\tthis.#broadcast(joined, message.clientId);\n\t\t\t\tbreak;\n\t\t\t}\n\n\t\t\tcase \"input\": {\n\t\t\t\t// Check if client is in read-write mode\n\t\t\t\tconst client = this.#clients.get(message.clientId);\n\t\t\t\tif (!client || client.mode === \"read-only\") {\n\t\t\t\t\tthis.#sendError(socket, \"Read-only clients cannot send input\");\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\t// Forward input to session\n\t\t\t\tif (this.#onInput) {\n\t\t\t\t\tthis.#onInput(message.data, message.clientId);\n\t\t\t\t}\n\n\t\t\t\t// Echo input to all other clients (tmux-style)\n\t\t\t\tif (this.#broadcastInputEcho) {\n\t\t\t\t\tconst echo: ServerMessage = {\n\t\t\t\t\t\ttype: \"input_echo\",\n\t\t\t\t\t\tdata: message.data,\n\t\t\t\t\t\tclientId: message.clientId,\n\t\t\t\t\t};\n\t\t\t\t\tthis.#broadcast(echo, message.clientId);\n\t\t\t\t}\n\t\t\t\tbreak;\n\t\t\t}\n\n\t\t\tcase \"detach\": {\n\t\t\t\tthis.#handleClientDisconnect(message.clientId);\n\t\t\t\tsocket.end();\n\t\t\t\tbreak;\n\t\t\t}\n\t\t}\n\t}\n\n\t/**\n\t * Handle client disconnect.\n\t */\n\t#handleClientDisconnect(clientId: string): void {\n\t\tconst client = this.#clients.get(clientId);\n\t\tif (!client) return;\n\n\t\tthis.#clients.delete(clientId);\n\n\t\t// Notify other clients\n\t\tconst left: ServerMessage = {\n\t\t\ttype: \"client_left\",\n\t\t\tclientId,\n\t\t};\n\t\tthis.#broadcast(left);\n\t}\n\n\t/**\n\t * Broadcast a message to all clients (or all except one).\n\t */\n\t#broadcast(message: ServerMessage, excludeClientId?: string): void {\n\t\tconst json = `${JSON.stringify(message)}\\n`;\n\t\tfor (const client of this.#clients.values()) {\n\t\t\tif (client.id !== excludeClientId) {\n\t\t\t\tclient.socket.write(json);\n\t\t\t}\n\t\t}\n\t}\n\n\t/**\n\t * Send a message to a specific socket.\n\t */\n\t#send(socket: Socket, message: ServerMessage): void {\n\t\tconst json = `${JSON.stringify(message)}\\n`;\n\t\tsocket.write(json);\n\t}\n\n\t/**\n\t * Send an error message to a specific socket.\n\t */\n\t#sendError(socket: Socket, message: string, code?: string): void {\n\t\tconst error: ServerMessage = {\n\t\t\ttype: \"error\",\n\t\t\tmessage,\n\t\t\tcode,\n\t\t};\n\t\tthis.#send(socket, error);\n\t}\n}\n"]}

package/dist/core/socket-server/socket-server.js

@@ -0,0 +1,273 @@
+/**
+ * SocketServer - Unix domain socket server for attachable draht sessions
+ *
+ * Enables tmux-style multi-client attachment:
+ * - Multiple readers/writers can connect simultaneously
+ * - All clients see the same output
+ * - Input from any client is echoed to all others
+ * - Clients can join/leave without disrupting the session
+ */
+import { existsSync } from "node:fs";
+import { mkdir, rm, writeFile } from "node:fs/promises";
+import { createServer } from "node:net";
+import path from "node:path";
+/**
+ * SocketServer manages a Unix domain socket for a single draht session.
+ *
+ * Clients connect, send input, and receive output in real-time.
+ * All communication uses JSON-over-socket with newline framing.
+ */
+export class SocketServer {
+    #sessionId;
+    #socketPath;
+    #lockPath;
+    #cwd;
+    #maxClients;
+    #broadcastInputEcho;
+    #server = null;
+    #clients = new Map();
+    #createdAt = new Date();
+    /** Callback for input received from any client */
+    #onInput = null;
+    constructor(options) {
+        this.#sessionId = options.sessionId;
+        this.#cwd = options.cwd;
+        this.#maxClients = options.maxClients ?? 10;
+        this.#broadcastInputEcho = options.broadcastInputEcho ?? true;
+        this.#socketPath = path.join(options.socketDir, `${options.sessionId}.sock`);
+        this.#lockPath = path.join(options.socketDir, `${options.sessionId}.lock`);
+    }
+    /**
+     * Start the socket server.
+     * Creates socket directory, binds Unix socket, and starts listening.
+     */
+    async start() {
+        // Ensure socket directory exists
+        const socketDir = path.dirname(this.#socketPath);
+        await mkdir(socketDir, { recursive: true, mode: 0o700 });
+        // Clean up stale socket if it exists
+        if (existsSync(this.#socketPath)) {
+            await rm(this.#socketPath, { force: true });
+        }
+        // Write PID lock file for cleanup on crash
+        await writeFile(this.#lockPath, `${process.pid}\n${this.#cwd}\n${this.#createdAt.toISOString()}`);
+        // Create Unix domain socket server
+        this.#server = createServer((socket) => this.#handleConnection(socket));
+        // Bind to socket path
+        await new Promise((resolve, reject) => {
+            this.#server.listen(this.#socketPath, () => resolve());
+            this.#server.on("error", reject);
+        });
+        // Set socket permissions (owner-only)
+        await import("node:fs/promises").then((fs) => fs.chmod(this.#socketPath, 0o600));
+    }
+    /**
+     * Stop the socket server and clean up.
+     */
+    async stop() {
+        // Disconnect all clients
+        for (const client of this.#clients.values()) {
+            client.socket.end();
+        }
+        this.#clients.clear();
+        // Close server
+        if (this.#server) {
+            await new Promise((resolve) => {
+                this.#server.close(() => resolve());
+            });
+            this.#server = null;
+        }
+        // Clean up socket and lock files
+        await rm(this.#socketPath, { force: true });
+        await rm(this.#lockPath, { force: true });
+    }
+    /**
+     * Broadcast output to all connected clients.
+     *
+     * @param data - Output text
+     * @param stream - Output stream (stdout or stderr)
+     */
+    broadcastOutput(data, stream = "stdout") {
+        const message = {
+            type: "output",
+            data,
+            stream,
+        };
+        this.#broadcast(message);
+    }
+    /**
+     * Set callback for input received from clients.
+     */
+    onInput(callback) {
+        this.#onInput = callback;
+    }
+    /**
+     * Get socket path for this session.
+     */
+    get socketPath() {
+        return this.#socketPath;
+    }
+    /**
+     * Get number of connected clients.
+     */
+    get clientCount() {
+        return this.#clients.size;
+    }
+    /**
+     * Handle new client connection.
+     */
+    #handleConnection(socket) {
+        let clientId = null;
+        let _mode = "read-write";
+        let buffer = "";
+        // Handle incoming data (JSON messages)
+        socket.on("data", (data) => {
+            buffer += data.toString();
+            const lines = buffer.split("\n");
+            buffer = lines.pop() || "";
+            for (const line of lines) {
+                if (!line.trim())
+                    continue;
+                try {
+                    const message = JSON.parse(line);
+                    this.#handleClientMessage(message, socket, (id, m) => {
+                        clientId = id;
+                        _mode = m;
+                    });
+                }
+                catch (_err) {
+                    this.#sendError(socket, "Invalid JSON message");
+                }
+            }
+        });
+        // Handle client disconnect
+        socket.on("close", () => {
+            if (clientId) {
+                this.#handleClientDisconnect(clientId);
+            }
+        });
+        socket.on("error", () => {
+            if (clientId) {
+                this.#handleClientDisconnect(clientId);
+            }
+        });
+    }
+    /**
+     * Handle a client message.
+     */
+    #handleClientMessage(message, socket, onAttach) {
+        switch (message.type) {
+            case "attach": {
+                // Check max clients
+                if (this.#clients.size >= this.#maxClients) {
+                    this.#sendError(socket, "Maximum clients reached");
+                    socket.end();
+                    return;
+                }
+                // Check for duplicate client ID
+                if (this.#clients.has(message.clientId)) {
+                    this.#sendError(socket, "Client ID already connected");
+                    socket.end();
+                    return;
+                }
+                // Register client
+                const client = {
+                    id: message.clientId,
+                    mode: message.mode,
+                    socket,
+                    connectedAt: new Date(),
+                };
+                this.#clients.set(message.clientId, client);
+                onAttach(message.clientId, message.mode);
+                // Send session metadata
+                const metadata = {
+                    type: "session_metadata",
+                    sessionId: this.#sessionId,
+                    cwd: this.#cwd,
+                    createdAt: this.#createdAt.toISOString(),
+                };
+                this.#send(socket, metadata);
+                // Notify other clients
+                const joined = {
+                    type: "client_joined",
+                    clientId: message.clientId,
+                    mode: message.mode,
+                };
+                this.#broadcast(joined, message.clientId);
+                break;
+            }
+            case "input": {
+                // Check if client is in read-write mode
+                const client = this.#clients.get(message.clientId);
+                if (!client || client.mode === "read-only") {
+                    this.#sendError(socket, "Read-only clients cannot send input");
+                    return;
+                }
+                // Forward input to session
+                if (this.#onInput) {
+                    this.#onInput(message.data, message.clientId);
+                }
+                // Echo input to all other clients (tmux-style)
+                if (this.#broadcastInputEcho) {
+                    const echo = {
+                        type: "input_echo",
+                        data: message.data,
+                        clientId: message.clientId,
+                    };
+                    this.#broadcast(echo, message.clientId);
+                }
+                break;
+            }
+            case "detach": {
+                this.#handleClientDisconnect(message.clientId);
+                socket.end();
+                break;
+            }
+        }
+    }
+    /**
+     * Handle client disconnect.
+     */
+    #handleClientDisconnect(clientId) {
+        const client = this.#clients.get(clientId);
+        if (!client)
+            return;
+        this.#clients.delete(clientId);
+        // Notify other clients
+        const left = {
+            type: "client_left",
+            clientId,
+        };
+        this.#broadcast(left);
+    }
+    /**
+     * Broadcast a message to all clients (or all except one).
+     */
+    #broadcast(message, excludeClientId) {
+        const json = `${JSON.stringify(message)}\n`;
+        for (const client of this.#clients.values()) {
+            if (client.id !== excludeClientId) {
+                client.socket.write(json);
+            }
+        }
+    }
+    /**
+     * Send a message to a specific socket.
+     */
+    #send(socket, message) {
+        const json = `${JSON.stringify(message)}\n`;
+        socket.write(json);
+    }
+    /**
+     * Send an error message to a specific socket.
+     */
+    #sendError(socket, message, code) {
+        const error = {
+            type: "error",
+            message,
+            code,
+        };
+        this.#send(socket, error);
+    }
+}
+//# sourceMappingURL=socket-server.js.map

package/dist/core/socket-server/socket-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket-server.js","sourceRoot":"","sources":["../../../src/core/socket-server/socket-server.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * SocketServer - Unix domain socket server for attachable draht sessions\n *\n * Enables tmux-style multi-client attachment:\n * - Multiple readers/writers can connect simultaneously\n * - All clients see the same output\n * - Input from any client is echoed to all others\n * - Clients can join/leave without disrupting the session\n */\n\nimport { existsSync } from \"node:fs\";\nimport { mkdir, rm, writeFile } from \"node:fs/promises\";\nimport { createServer, type Server, type Socket } from \"node:net\";\nimport path from \"node:path\";\nimport type { ClientMessage, ClientMode, ConnectedClient, ServerMessage } from \"./types.js\";\n\nexport interface SocketServerOptions {\n\t/** Session ID (used for socket filename) */\n\tsessionId: string;\n\t/** Directory for socket files (default: ~/.draht/agent/sockets) */\n\tsocketDir: string;\n\t/** Current working directory (included in metadata) */\n\tcwd: string;\n\t/** Maximum number of concurrent clients */\n\tmaxClients?: number;\n\t/** Whether to echo input to all clients (tmux-style) */\n\tbroadcastInputEcho?: boolean;\n}\n\n/**\n * SocketServer manages a Unix domain socket for a single draht session.\n *\n * Clients connect, send input, and receive output in real-time.\n * All communication uses JSON-over-socket with newline framing.\n */\nexport class SocketServer {\n\treadonly #sessionId: string;\n\treadonly #socketPath: string;\n\treadonly #lockPath: string;\n\treadonly #cwd: string;\n\treadonly #maxClients: number;\n\treadonly #broadcastInputEcho: boolean;\n\n\t#server: Server | null = null;\n\t#clients = new Map<string, ConnectedClient>();\n\t#createdAt = new Date();\n\n\t/** Callback for input received from any client */\n\t#onInput: ((data: string, clientId: string) => void) | null = null;\n\n\tconstructor(options: SocketServerOptions) {\n\t\tthis.#sessionId = options.sessionId;\n\t\tthis.#cwd = options.cwd;\n\t\tthis.#maxClients = options.maxClients ?? 10;\n\t\tthis.#broadcastInputEcho = options.broadcastInputEcho ?? true;\n\n\t\tthis.#socketPath = path.join(options.socketDir, `${options.sessionId}.sock`);\n\t\tthis.#lockPath = path.join(options.socketDir, `${options.sessionId}.lock`);\n\t}\n\n\t/**\n\t * Start the socket server.\n\t * Creates socket directory, binds Unix socket, and starts listening.\n\t */\n\tasync start(): Promise<void> {\n\t\t// Ensure socket directory exists\n\t\tconst socketDir = path.dirname(this.#socketPath);\n\t\tawait mkdir(socketDir, { recursive: true, mode: 0o700 });\n\n\t\t// Clean up stale socket if it exists\n\t\tif (existsSync(this.#socketPath)) {\n\t\t\tawait rm(this.#socketPath, { force: true });\n\t\t}\n\n\t\t// Write PID lock file for cleanup on crash\n\t\tawait writeFile(this.#lockPath, `${process.pid}\\n${this.#cwd}\\n${this.#createdAt.toISOString()}`);\n\n\t\t// Create Unix domain socket server\n\t\tthis.#server = createServer((socket) => this.#handleConnection(socket));\n\n\t\t// Bind to socket path\n\t\tawait new Promise<void>((resolve, reject) => {\n\t\t\tthis.#server!.listen(this.#socketPath, () => resolve());\n\t\t\tthis.#server!.on(\"error\", reject);\n\t\t});\n\n\t\t// Set socket permissions (owner-only)\n\t\tawait import(\"node:fs/promises\").then((fs) => fs.chmod(this.#socketPath, 0o600));\n\t}\n\n\t/**\n\t * Stop the socket server and clean up.\n\t */\n\tasync stop(): Promise<void> {\n\t\t// Disconnect all clients\n\t\tfor (const client of this.#clients.values()) {\n\t\t\tclient.socket.end();\n\t\t}\n\t\tthis.#clients.clear();\n\n\t\t// Close server\n\t\tif (this.#server) {\n\t\t\tawait new Promise<void>((resolve) => {\n\t\t\t\tthis.#server!.close(() => resolve());\n\t\t\t});\n\t\t\tthis.#server = null;\n\t\t}\n\n\t\t// Clean up socket and lock files\n\t\tawait rm(this.#socketPath, { force: true });\n\t\tawait rm(this.#lockPath, { force: true });\n\t}\n\n\t/**\n\t * Broadcast output to all connected clients.\n\t *\n\t * @param data - Output text\n\t * @param stream - Output stream (stdout or stderr)\n\t */\n\tbroadcastOutput(data: string, stream: \"stdout\" | \"stderr\" = \"stdout\"): void {\n\t\tconst message: ServerMessage = {\n\t\t\ttype: \"output\",\n\t\t\tdata,\n\t\t\tstream,\n\t\t};\n\t\tthis.#broadcast(message);\n\t}\n\n\t/**\n\t * Set callback for input received from clients.\n\t */\n\tonInput(callback: (data: string, clientId: string) => void): void {\n\t\tthis.#onInput = callback;\n\t}\n\n\t/**\n\t * Get socket path for this session.\n\t */\n\tget socketPath(): string {\n\t\treturn this.#socketPath;\n\t}\n\n\t/**\n\t * Get number of connected clients.\n\t */\n\tget clientCount(): number {\n\t\treturn this.#clients.size;\n\t}\n\n\t/**\n\t * Handle new client connection.\n\t */\n\t#handleConnection(socket: Socket): void {\n\t\tlet clientId: string | null = null;\n\t\tlet _mode: ClientMode = \"read-write\";\n\t\tlet buffer = \"\";\n\n\t\t// Handle incoming data (JSON messages)\n\t\tsocket.on(\"data\", (data) => {\n\t\t\tbuffer += data.toString();\n\t\t\tconst lines = buffer.split(\"\\n\");\n\t\t\tbuffer = lines.pop() || \"\";\n\n\t\t\tfor (const line of lines) {\n\t\t\t\tif (!line.trim()) continue;\n\n\t\t\t\ttry {\n\t\t\t\t\tconst message = JSON.parse(line) as ClientMessage;\n\t\t\t\t\tthis.#handleClientMessage(message, socket, (id, m) => {\n\t\t\t\t\t\tclientId = id;\n\t\t\t\t\t\t_mode = m;\n\t\t\t\t\t});\n\t\t\t\t} catch (_err) {\n\t\t\t\t\tthis.#sendError(socket, \"Invalid JSON message\");\n\t\t\t\t}\n\t\t\t}\n\t\t});\n\n\t\t// Handle client disconnect\n\t\tsocket.on(\"close\", () => {\n\t\t\tif (clientId) {\n\t\t\t\tthis.#handleClientDisconnect(clientId);\n\t\t\t}\n\t\t});\n\n\t\tsocket.on(\"error\", () => {\n\t\t\tif (clientId) {\n\t\t\t\tthis.#handleClientDisconnect(clientId);\n\t\t\t}\n\t\t});\n\t}\n\n\t/**\n\t * Handle a client message.\n\t */\n\t#handleClientMessage(\n\t\tmessage: ClientMessage,\n\t\tsocket: Socket,\n\t\tonAttach: (id: string, mode: ClientMode) => void,\n\t): void {\n\t\tswitch (message.type) {\n\t\t\tcase \"attach\": {\n\t\t\t\t// Check max clients\n\t\t\t\tif (this.#clients.size >= this.#maxClients) {\n\t\t\t\t\tthis.#sendError(socket, \"Maximum clients reached\");\n\t\t\t\t\tsocket.end();\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\t// Check for duplicate client ID\n\t\t\t\tif (this.#clients.has(message.clientId)) {\n\t\t\t\t\tthis.#sendError(socket, \"Client ID already connected\");\n\t\t\t\t\tsocket.end();\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\t// Register client\n\t\t\t\tconst client: ConnectedClient = {\n\t\t\t\t\tid: message.clientId,\n\t\t\t\t\tmode: message.mode,\n\t\t\t\t\tsocket,\n\t\t\t\t\tconnectedAt: new Date(),\n\t\t\t\t};\n\t\t\t\tthis.#clients.set(message.clientId, client);\n\t\t\t\tonAttach(message.clientId, message.mode);\n\n\t\t\t\t// Send session metadata\n\t\t\t\tconst metadata: ServerMessage = {\n\t\t\t\t\ttype: \"session_metadata\",\n\t\t\t\t\tsessionId: this.#sessionId,\n\t\t\t\t\tcwd: this.#cwd,\n\t\t\t\t\tcreatedAt: this.#createdAt.toISOString(),\n\t\t\t\t};\n\t\t\t\tthis.#send(socket, metadata);\n\n\t\t\t\t// Notify other clients\n\t\t\t\tconst joined: ServerMessage = {\n\t\t\t\t\ttype: \"client_joined\",\n\t\t\t\t\tclientId: message.clientId,\n\t\t\t\t\tmode: message.mode,\n\t\t\t\t};\n\t\t\t\tthis.#broadcast(joined, message.clientId);\n\t\t\t\tbreak;\n\t\t\t}\n\n\t\t\tcase \"input\": {\n\t\t\t\t// Check if client is in read-write mode\n\t\t\t\tconst client = this.#clients.get(message.clientId);\n\t\t\t\tif (!client || client.mode === \"read-only\") {\n\t\t\t\t\tthis.#sendError(socket, \"Read-only clients cannot send input\");\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\t// Forward input to session\n\t\t\t\tif (this.#onInput) {\n\t\t\t\t\tthis.#onInput(message.data, message.clientId);\n\t\t\t\t}\n\n\t\t\t\t// Echo input to all other clients (tmux-style)\n\t\t\t\tif (this.#broadcastInputEcho) {\n\t\t\t\t\tconst echo: ServerMessage = {\n\t\t\t\t\t\ttype: \"input_echo\",\n\t\t\t\t\t\tdata: message.data,\n\t\t\t\t\t\tclientId: message.clientId,\n\t\t\t\t\t};\n\t\t\t\t\tthis.#broadcast(echo, message.clientId);\n\t\t\t\t}\n\t\t\t\tbreak;\n\t\t\t}\n\n\t\t\tcase \"detach\": {\n\t\t\t\tthis.#handleClientDisconnect(message.clientId);\n\t\t\t\tsocket.end();\n\t\t\t\tbreak;\n\t\t\t}\n\t\t}\n\t}\n\n\t/**\n\t * Handle client disconnect.\n\t */\n\t#handleClientDisconnect(clientId: string): void {\n\t\tconst client = this.#clients.get(clientId);\n\t\tif (!client) return;\n\n\t\tthis.#clients.delete(clientId);\n\n\t\t// Notify other clients\n\t\tconst left: ServerMessage = {\n\t\t\ttype: \"client_left\",\n\t\t\tclientId,\n\t\t};\n\t\tthis.#broadcast(left);\n\t}\n\n\t/**\n\t * Broadcast a message to all clients (or all except one).\n\t */\n\t#broadcast(message: ServerMessage, excludeClientId?: string): void {\n\t\tconst json = `${JSON.stringify(message)}\\n`;\n\t\tfor (const client of this.#clients.values()) {\n\t\t\tif (client.id !== excludeClientId) {\n\t\t\t\tclient.socket.write(json);\n\t\t\t}\n\t\t}\n\t}\n\n\t/**\n\t * Send a message to a specific socket.\n\t */\n\t#send(socket: Socket, message: ServerMessage): void {\n\t\tconst json = `${JSON.stringify(message)}\\n`;\n\t\tsocket.write(json);\n\t}\n\n\t/**\n\t * Send an error message to a specific socket.\n\t */\n\t#sendError(socket: Socket, message: string, code?: string): void {\n\t\tconst error: ServerMessage = {\n\t\t\ttype: \"error\",\n\t\t\tmessage,\n\t\t\tcode,\n\t\t};\n\t\tthis.#send(socket, error);\n\t}\n}\n"]}