@kb-labs/host-agent-transport 0.2.0

package/dist/index.d.ts

@@ -0,0 +1,107 @@
+/**
+ * ILocalTransport — abstraction over the IPC channel between
+ * CLI/Studio (client) and Host Agent daemon (server).
+ *
+ * Both sides use the same interface:
+ * - Server: listen() + onMessage()
+ * - Client: connect() + send()
+ */
+interface ILocalTransport {
+    /** Server side: start accepting connections */
+    listen(): Promise<void>;
+    /** Client side: connect to the server */
+    connect(): Promise<void>;
+    /** Send a message (both sides) */
+    send(msg: unknown): void;
+    /** Register a handler for incoming messages */
+    onMessage(handler: (msg: unknown) => void): void;
+    /** Close the connection / server */
+    close(): void;
+}
+type TransportMode = 'unix' | 'named-pipe' | 'tcp' | 'auto';
+interface TransportConfig {
+    mode: TransportMode;
+    /** Unix socket path (unix mode). Default: ~/.kb/agent.sock */
+    socketPath?: string;
+    /** Named pipe name (named-pipe mode). Default: kb-agent */
+    pipeName?: string;
+    /** TCP port (tcp mode). Default: 7779 */
+    port?: number;
+    /** TCP host (tcp mode). Default: 127.0.0.1 */
+    host?: string;
+}
+
+/**
+ * UnixSocketTransport — ILocalTransport over Unix domain socket.
+ * Default on Linux/macOS.
+ */
+
+declare class UnixSocketTransport implements ILocalTransport {
+    private readonly socketPath;
+    private server;
+    private socket;
+    private messageHandler;
+    constructor(socketPath: string);
+    listen(): Promise<void>;
+    connect(): Promise<void>;
+    send(msg: unknown): void;
+    onMessage(handler: (msg: unknown) => void): void;
+    close(): void;
+    private handleConnection;
+    private setupSocket;
+}
+
+/**
+ * NamedPipeTransport — ILocalTransport over Windows named pipe.
+ * Default on Windows. Uses the same net.createServer API — Node.js
+ * treats \\.\pipe\<name> paths as named pipes automatically.
+ */
+
+declare class NamedPipeTransport implements ILocalTransport {
+    private server;
+    private socket;
+    private messageHandler;
+    private readonly path;
+    constructor(pipeName: string);
+    listen(): Promise<void>;
+    connect(): Promise<void>;
+    send(msg: unknown): void;
+    onMessage(handler: (msg: unknown) => void): void;
+    close(): void;
+    private handleConnection;
+    private setupSocket;
+}
+
+/**
+ * TcpTransport — ILocalTransport over TCP localhost.
+ * Universal fallback: works on Linux, macOS, Windows without special paths.
+ */
+
+declare class TcpTransport implements ILocalTransport {
+    private readonly port;
+    private readonly host;
+    private server;
+    private socket;
+    private messageHandler;
+    constructor(port: number, host?: string);
+    listen(): Promise<void>;
+    connect(): Promise<void>;
+    send(msg: unknown): void;
+    onMessage(handler: (msg: unknown) => void): void;
+    close(): void;
+    private handleConnection;
+    private setupSocket;
+}
+
+/**
+ * createTransport — factory that picks the right ILocalTransport
+ * based on config.mode (or platform when mode === 'auto').
+ *
+ * auto resolution:
+ *   Windows  → NamedPipeTransport
+ *   Linux/Mac → UnixSocketTransport
+ */
+
+declare function createTransport(config: TransportConfig): ILocalTransport;
+
+export { type ILocalTransport, NamedPipeTransport, TcpTransport, type TransportConfig, type TransportMode, UnixSocketTransport, createTransport };

package/dist/index.js

@@ -0,0 +1,241 @@
+import net from 'net';
+import { homedir } from 'os';
+import { join } from 'path';
+
+// src/unix-socket.ts
+
+// src/ndjson-framer.ts
+var MAX_BUFFER_BYTES = 1024 * 1024;
+var NdjsonFramer = class {
+  constructor(onMessage) {
+    this.onMessage = onMessage;
+  }
+  buffer = "";
+  /** Feed raw data from socket. Returns false if buffer limit exceeded (socket is closed). */
+  feed(socket, chunk) {
+    if (Buffer.byteLength(this.buffer) + Buffer.byteLength(chunk) > MAX_BUFFER_BYTES) {
+      console.warn("[transport] Buffer limit exceeded \u2014 closing socket to prevent DoS");
+      socket.destroy(new Error("Buffer limit exceeded"));
+      return false;
+    }
+    this.buffer += chunk.toString();
+    const lines = this.buffer.split("\n");
+    this.buffer = lines.pop() ?? "";
+    for (const line of lines) {
+      if (!line.trim()) {
+        continue;
+      }
+      let parsed;
+      try {
+        parsed = JSON.parse(line);
+      } catch {
+        console.warn("[transport] Malformed JSON, ignoring line");
+        continue;
+      }
+      this.onMessage(parsed);
+    }
+    return true;
+  }
+  reset() {
+    this.buffer = "";
+  }
+};
+function writeNdjson(socket, msg) {
+  if (!socket.destroyed) {
+    socket.write(JSON.stringify(msg) + "\n");
+  }
+}
+
+// src/unix-socket.ts
+var UnixSocketTransport = class {
+  constructor(socketPath) {
+    this.socketPath = socketPath;
+  }
+  server = null;
+  socket = null;
+  messageHandler = null;
+  async listen() {
+    try {
+      const { unlink } = await import('fs/promises');
+      await unlink(this.socketPath);
+    } catch {
+    }
+    this.server = net.createServer((conn) => this.handleConnection(conn));
+    await new Promise((resolve, reject) => {
+      this.server.listen(this.socketPath, resolve);
+      this.server.once("error", reject);
+    });
+    const { chmod } = await import('fs/promises');
+    await chmod(this.socketPath, 384);
+  }
+  async connect() {
+    await new Promise((resolve, reject) => {
+      this.socket = net.createConnection(this.socketPath, resolve);
+      this.socket.once("error", reject);
+      this.setupSocket(this.socket);
+    });
+  }
+  send(msg) {
+    if (this.socket) {
+      writeNdjson(this.socket, msg);
+    }
+  }
+  onMessage(handler) {
+    this.messageHandler = handler;
+  }
+  close() {
+    this.socket?.destroy();
+    this.socket = null;
+    this.server?.close();
+    this.server = null;
+  }
+  handleConnection(conn) {
+    this.socket = conn;
+    this.setupSocket(conn);
+  }
+  setupSocket(socket) {
+    const framer = new NdjsonFramer((msg) => this.messageHandler?.(msg));
+    socket.on("data", (chunk) => {
+      if (!framer.feed(socket, chunk)) {
+        socket.destroy();
+      }
+    });
+    socket.on("error", () => socket.destroy());
+    socket.on("close", () => {
+      framer.reset();
+    });
+  }
+};
+function pipePath(name) {
+  return `\\\\.\\pipe\\${name}`;
+}
+var NamedPipeTransport = class {
+  server = null;
+  socket = null;
+  messageHandler = null;
+  path;
+  constructor(pipeName) {
+    this.path = pipePath(pipeName);
+  }
+  async listen() {
+    this.server = net.createServer((conn) => this.handleConnection(conn));
+    await new Promise((resolve, reject) => {
+      this.server.listen(this.path, resolve);
+      this.server.once("error", reject);
+    });
+  }
+  async connect() {
+    await new Promise((resolve, reject) => {
+      this.socket = net.createConnection(this.path, resolve);
+      this.socket.once("error", reject);
+      this.setupSocket(this.socket);
+    });
+  }
+  send(msg) {
+    if (this.socket) {
+      writeNdjson(this.socket, msg);
+    }
+  }
+  onMessage(handler) {
+    this.messageHandler = handler;
+  }
+  close() {
+    this.socket?.destroy();
+    this.socket = null;
+    this.server?.close();
+    this.server = null;
+  }
+  handleConnection(conn) {
+    this.socket = conn;
+    this.setupSocket(conn);
+  }
+  setupSocket(socket) {
+    const framer = new NdjsonFramer((msg) => this.messageHandler?.(msg));
+    socket.on("data", (chunk) => {
+      if (!framer.feed(socket, chunk)) {
+        socket.destroy();
+      }
+    });
+    socket.on("error", () => socket.destroy());
+    socket.on("close", () => {
+      framer.reset();
+    });
+  }
+};
+var TcpTransport = class {
+  constructor(port, host = "127.0.0.1") {
+    this.port = port;
+    this.host = host;
+  }
+  server = null;
+  socket = null;
+  messageHandler = null;
+  async listen() {
+    this.server = net.createServer((conn) => this.handleConnection(conn));
+    await new Promise((resolve, reject) => {
+      this.server.listen(this.port, this.host, resolve);
+      this.server.once("error", reject);
+    });
+  }
+  async connect() {
+    await new Promise((resolve, reject) => {
+      this.socket = net.createConnection(this.port, this.host, resolve);
+      this.socket.once("error", reject);
+      this.setupSocket(this.socket);
+    });
+  }
+  send(msg) {
+    if (this.socket) {
+      writeNdjson(this.socket, msg);
+    }
+  }
+  onMessage(handler) {
+    this.messageHandler = handler;
+  }
+  close() {
+    this.socket?.destroy();
+    this.socket = null;
+    this.server?.close();
+    this.server = null;
+  }
+  handleConnection(conn) {
+    this.socket = conn;
+    this.setupSocket(conn);
+  }
+  setupSocket(socket) {
+    const framer = new NdjsonFramer((msg) => this.messageHandler?.(msg));
+    socket.on("data", (chunk) => {
+      if (!framer.feed(socket, chunk)) {
+        socket.destroy();
+      }
+    });
+    socket.on("error", () => socket.destroy());
+    socket.on("close", () => {
+      framer.reset();
+    });
+  }
+};
+var DEFAULT_SOCKET_PATH = join(homedir(), ".kb", "agent.sock");
+var DEFAULT_PIPE_NAME = "kb-agent";
+var DEFAULT_TCP_PORT = 7779;
+var DEFAULT_TCP_HOST = "127.0.0.1";
+function createTransport(config) {
+  const mode = config.mode === "auto" ? process.platform === "win32" ? "named-pipe" : "unix" : config.mode;
+  switch (mode) {
+    case "unix":
+      return new UnixSocketTransport(config.socketPath ?? DEFAULT_SOCKET_PATH);
+    case "named-pipe":
+      return new NamedPipeTransport(config.pipeName ?? DEFAULT_PIPE_NAME);
+    case "tcp":
+      return new TcpTransport(
+        config.port ?? DEFAULT_TCP_PORT,
+        config.host ?? DEFAULT_TCP_HOST
+      );
+    default:
+      throw new Error(`Unknown transport mode: ${String(mode)}`);
+  }
+}
+
+export { NamedPipeTransport, TcpTransport, UnixSocketTransport, createTransport };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/ndjson-framer.ts","../src/unix-socket.ts","../src/named-pipe.ts","../src/tcp.ts","../src/auto.ts"],"names":["net"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * NdjsonFramer — shared NDJSON framing logic for all transport implementations.\n *\n * Accumulates chunks, splits on newlines, emits complete JSON messages.\n * Guards against oversized buffers (DoS protection).\n */\n\nimport type net from 'node:net';\n\nconst MAX_BUFFER_BYTES = 1024 * 1024; // 1 MB\n\nexport class NdjsonFramer {\n  private buffer = '';\n\n  constructor(private readonly onMessage: (msg: unknown) => void) {}\n\n  /** Feed raw data from socket. Returns false if buffer limit exceeded (socket is closed). */\n  feed(socket: net.Socket, chunk: Buffer | string): boolean {\n    if (Buffer.byteLength(this.buffer) + Buffer.byteLength(chunk as string) > MAX_BUFFER_BYTES) {\n      console.warn('[transport] Buffer limit exceeded — closing socket to prevent DoS');\n      socket.destroy(new Error('Buffer limit exceeded'));\n      return false;\n    }\n    this.buffer += chunk.toString();\n\n    const lines = this.buffer.split('\\n');\n    this.buffer = lines.pop() ?? '';\n\n    for (const line of lines) {\n      if (!line.trim()) { continue; }\n      let parsed: unknown;\n      try {\n        parsed = JSON.parse(line);\n      } catch {\n        console.warn('[transport] Malformed JSON, ignoring line');\n        continue;\n      }\n      this.onMessage(parsed);\n    }\n    return true;\n  }\n\n  reset(): void {\n    this.buffer = '';\n  }\n}\n\nexport function writeNdjson(socket: net.Socket, msg: unknown): void {\n  if (!socket.destroyed) {\n    socket.write(JSON.stringify(msg) + '\\n');\n  }\n}\n","/**\n * UnixSocketTransport — ILocalTransport over Unix domain socket.\n * Default on Linux/macOS.\n */\n\nimport net from 'node:net';\nimport { NdjsonFramer, writeNdjson } from './ndjson-framer.js';\nimport type { ILocalTransport } from './transport.js';\n\nexport class UnixSocketTransport implements ILocalTransport {\n  private server: net.Server | null = null;\n  private socket: net.Socket | null = null;\n  private messageHandler: ((msg: unknown) => void) | null = null;\n\n  constructor(private readonly socketPath: string) {}\n\n  async listen(): Promise<void> {\n    try {\n      const { unlink } = await import('node:fs/promises');\n      await unlink(this.socketPath);\n    } catch { /* stale socket — fine */ }\n\n    this.server = net.createServer((conn) => this.handleConnection(conn));\n    await new Promise<void>((resolve, reject) => {\n      this.server!.listen(this.socketPath, resolve);\n      this.server!.once('error', reject);\n    });\n\n    const { chmod } = await import('node:fs/promises');\n    await chmod(this.socketPath, 0o600);\n  }\n\n  async connect(): Promise<void> {\n    await new Promise<void>((resolve, reject) => {\n      this.socket = net.createConnection(this.socketPath, resolve);\n      this.socket.once('error', reject);\n      this.setupSocket(this.socket);\n    });\n  }\n\n  send(msg: unknown): void {\n    if (this.socket) { writeNdjson(this.socket, msg); }\n  }\n\n  onMessage(handler: (msg: unknown) => void): void {\n    this.messageHandler = handler;\n  }\n\n  close(): void {\n    this.socket?.destroy();\n    this.socket = null;\n    this.server?.close();\n    this.server = null;\n  }\n\n  private handleConnection(conn: net.Socket): void {\n    this.socket = conn;\n    this.setupSocket(conn);\n  }\n\n  private setupSocket(socket: net.Socket): void {\n    const framer = new NdjsonFramer((msg) => this.messageHandler?.(msg));\n    socket.on('data', (chunk) => {\n      if (!framer.feed(socket, chunk)) { socket.destroy(); }\n    });\n    socket.on('error', () => socket.destroy());\n    socket.on('close', () => { framer.reset(); });\n  }\n}\n","/**\n * NamedPipeTransport — ILocalTransport over Windows named pipe.\n * Default on Windows. Uses the same net.createServer API — Node.js\n * treats \\\\.\\pipe\\<name> paths as named pipes automatically.\n */\n\nimport net from 'node:net';\nimport { NdjsonFramer, writeNdjson } from './ndjson-framer.js';\nimport type { ILocalTransport } from './transport.js';\n\nfunction pipePath(name: string): string {\n  return `\\\\\\\\.\\\\pipe\\\\${name}`;\n}\n\nexport class NamedPipeTransport implements ILocalTransport {\n  private server: net.Server | null = null;\n  private socket: net.Socket | null = null;\n  private messageHandler: ((msg: unknown) => void) | null = null;\n  private readonly path: string;\n\n  constructor(pipeName: string) {\n    this.path = pipePath(pipeName);\n  }\n\n  async listen(): Promise<void> {\n    this.server = net.createServer((conn) => this.handleConnection(conn));\n    await new Promise<void>((resolve, reject) => {\n      this.server!.listen(this.path, resolve);\n      this.server!.once('error', reject);\n    });\n  }\n\n  async connect(): Promise<void> {\n    await new Promise<void>((resolve, reject) => {\n      this.socket = net.createConnection(this.path, resolve);\n      this.socket.once('error', reject);\n      this.setupSocket(this.socket);\n    });\n  }\n\n  send(msg: unknown): void {\n    if (this.socket) { writeNdjson(this.socket, msg); }\n  }\n\n  onMessage(handler: (msg: unknown) => void): void {\n    this.messageHandler = handler;\n  }\n\n  close(): void {\n    this.socket?.destroy();\n    this.socket = null;\n    this.server?.close();\n    this.server = null;\n  }\n\n  private handleConnection(conn: net.Socket): void {\n    this.socket = conn;\n    this.setupSocket(conn);\n  }\n\n  private setupSocket(socket: net.Socket): void {\n    const framer = new NdjsonFramer((msg) => this.messageHandler?.(msg));\n    socket.on('data', (chunk) => {\n      if (!framer.feed(socket, chunk)) { socket.destroy(); }\n    });\n    socket.on('error', () => socket.destroy());\n    socket.on('close', () => { framer.reset(); });\n  }\n}\n","/**\n * TcpTransport — ILocalTransport over TCP localhost.\n * Universal fallback: works on Linux, macOS, Windows without special paths.\n */\n\nimport net from 'node:net';\nimport { NdjsonFramer, writeNdjson } from './ndjson-framer.js';\nimport type { ILocalTransport } from './transport.js';\n\nexport class TcpTransport implements ILocalTransport {\n  private server: net.Server | null = null;\n  private socket: net.Socket | null = null;\n  private messageHandler: ((msg: unknown) => void) | null = null;\n\n  constructor(\n    private readonly port: number,\n    private readonly host = '127.0.0.1',\n  ) {}\n\n  async listen(): Promise<void> {\n    this.server = net.createServer((conn) => this.handleConnection(conn));\n    await new Promise<void>((resolve, reject) => {\n      this.server!.listen(this.port, this.host, resolve);\n      this.server!.once('error', reject);\n    });\n  }\n\n  async connect(): Promise<void> {\n    await new Promise<void>((resolve, reject) => {\n      this.socket = net.createConnection(this.port, this.host, resolve);\n      this.socket.once('error', reject);\n      this.setupSocket(this.socket);\n    });\n  }\n\n  send(msg: unknown): void {\n    if (this.socket) { writeNdjson(this.socket, msg); }\n  }\n\n  onMessage(handler: (msg: unknown) => void): void {\n    this.messageHandler = handler;\n  }\n\n  close(): void {\n    this.socket?.destroy();\n    this.socket = null;\n    this.server?.close();\n    this.server = null;\n  }\n\n  private handleConnection(conn: net.Socket): void {\n    this.socket = conn;\n    this.setupSocket(conn);\n  }\n\n  private setupSocket(socket: net.Socket): void {\n    const framer = new NdjsonFramer((msg) => this.messageHandler?.(msg));\n    socket.on('data', (chunk) => {\n      if (!framer.feed(socket, chunk)) { socket.destroy(); }\n    });\n    socket.on('error', () => socket.destroy());\n    socket.on('close', () => { framer.reset(); });\n  }\n}\n","/**\n * createTransport — factory that picks the right ILocalTransport\n * based on config.mode (or platform when mode === 'auto').\n *\n * auto resolution:\n *   Windows  → NamedPipeTransport\n *   Linux/Mac → UnixSocketTransport\n */\n\nimport { homedir } from 'node:os';\nimport { join } from 'node:path';\nimport type { ILocalTransport, TransportConfig } from './transport.js';\nimport { UnixSocketTransport } from './unix-socket.js';\nimport { NamedPipeTransport } from './named-pipe.js';\nimport { TcpTransport } from './tcp.js';\n\nconst DEFAULT_SOCKET_PATH = join(homedir(), '.kb', 'agent.sock');\nconst DEFAULT_PIPE_NAME = 'kb-agent';\nconst DEFAULT_TCP_PORT = 7779;\nconst DEFAULT_TCP_HOST = '127.0.0.1';\n\nexport function createTransport(config: TransportConfig): ILocalTransport {\n  const mode = config.mode === 'auto'\n    ? (process.platform === 'win32' ? 'named-pipe' : 'unix')\n    : config.mode;\n\n  switch (mode) {\n    case 'unix':\n      return new UnixSocketTransport(config.socketPath ?? DEFAULT_SOCKET_PATH);\n    case 'named-pipe':\n      return new NamedPipeTransport(config.pipeName ?? DEFAULT_PIPE_NAME);\n    case 'tcp':\n      return new TcpTransport(\n        config.port ?? DEFAULT_TCP_PORT,\n        config.host ?? DEFAULT_TCP_HOST,\n      );\n    default:\n      throw new Error(`Unknown transport mode: ${String(mode)}`);\n  }\n}\n"]}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@kb-labs/host-agent-transport",
+  "version": "0.2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "clean": "rimraf dist",
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "type-check": "tsc --noEmit",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "test": "vitest run -c ../../vitest.config.ts",
+    "test:watch": "vitest -c ../../vitest.config.ts"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@kb-labs/devkit": "link:../../../kb-labs-devkit",
+    "@types/node": "^20",
+    "rimraf": "^6",
+    "tsup": "^8.5.0",
+    "vitest": "^3.2.4"
+  }
+}