@hivemind-os/collective-shim 0.2.0

package/.turbo/turbo-build.log

@@ -0,0 +1,14 @@
+$ tsup
+CLI Building entry: src/index.ts
+CLI Using tsconfig: tsconfig.json
+CLI tsup v8.5.1
+CLI Using tsup config: /home/runner/work/collective/collective/packages/shim/tsup.config.ts
+CLI Target: es2022
+CLI Cleaning output folder
+ESM Build start
+ESM dist/index.js     10.91 KB
+ESM dist/index.js.map 21.04 KB
+ESM ⚡️ Build success in 22ms
+DTS Build start
+DTS ⚡️ Build success in 1711ms
+DTS dist/index.d.ts 20.00 B

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.js

@@ -0,0 +1,383 @@
+#!/usr/bin/env node
+
+// src/bridge.ts
+import { execFile } from "child_process";
+import { basename } from "path";
+import { setTimeout as delay2 } from "timers/promises";
+import { promisify } from "util";
+
+// src/daemon-launcher.ts
+import { spawn, spawnSync } from "child_process";
+import { createRequire } from "module";
+import net from "net";
+import { homedir, userInfo } from "os";
+import { resolve } from "path";
+import { setTimeout as delay } from "timers/promises";
+import { fileURLToPath } from "url";
+var require2 = createRequire(import.meta.url);
+var LEGACY_WINDOWS_PIPE_PATH = "\\\\.\\pipe\\hivemind-collective";
+function getDefaultIpcPath() {
+  return process.env.COLLECTIVE_IPC_PATH ?? (process.platform === "win32" ? `${LEGACY_WINDOWS_PIPE_PATH}-${sanitizePipeSegment(getCurrentUsername())}` : resolve(homedir(), ".hivemind-os/collective", "mesh.sock"));
+}
+function getDefaultPidFile() {
+  return process.env.COLLECTIVE_PID_FILE ?? resolve(homedir(), ".hivemind-os/collective", "daemon.pid");
+}
+function resolveDaemonBin() {
+  if (process.env.COLLECTIVE_DAEMON_BIN) {
+    return process.env.COLLECTIVE_DAEMON_BIN;
+  }
+  try {
+    return require2.resolve("@hivemind-os/collective-daemon");
+  } catch {
+    if (commandExists("mesh-daemon")) {
+      return "mesh-daemon";
+    }
+    return fileURLToPath(new URL("../../daemon/dist/index.js", import.meta.url));
+  }
+}
+async function isDaemonRunning(ipcPath) {
+  return new Promise((resolvePromise) => {
+    const socket = net.connect(ipcPath);
+    const finish = (running) => {
+      socket.removeAllListeners();
+      socket.destroy();
+      resolvePromise(running);
+    };
+    socket.once("connect", () => {
+      finish(true);
+    });
+    socket.once("error", () => {
+      finish(false);
+    });
+  });
+}
+async function ensureDaemonRunning(options) {
+  if (await isDaemonRunning(options.ipcPath)) {
+    return;
+  }
+  const command = options.daemonBin.endsWith(".js") ? process.execPath : options.daemonBin;
+  const args = options.daemonBin.endsWith(".js") ? [options.daemonBin] : [];
+  const child = spawn(command, args, { detached: true, stdio: "ignore" });
+  child.unref();
+  const deadline = Date.now() + options.startupTimeoutMs;
+  while (Date.now() < deadline) {
+    await delay(200);
+    if (await isDaemonRunning(options.ipcPath)) {
+      return;
+    }
+  }
+  throw new Error(`Timed out waiting for daemon IPC at ${options.ipcPath} (pid file: ${options.pidFile})`);
+}
+function commandExists(command) {
+  const probe = process.platform === "win32" ? "where" : "which";
+  return spawnSync(probe, [command], { stdio: "ignore" }).status === 0;
+}
+function getCurrentUsername() {
+  try {
+    return userInfo().username;
+  } catch {
+    return process.env.USERNAME ?? process.env.USER ?? "unknown-user";
+  }
+}
+function sanitizePipeSegment(value) {
+  const leaf = value.split(/[\\/]+/).filter(Boolean).at(-1) ?? value;
+  const sanitized = leaf.trim().toLowerCase().replace(/[^a-z0-9_.-]+/g, "-").replace(/^-+|-+$/g, "");
+  return sanitized || "unknown-user";
+}
+
+// src/ipc-client.ts
+import { randomUUID } from "crypto";
+import net2 from "net";
+var IpcClient = class {
+  constructor(ipcPath) {
+    this.ipcPath = ipcPath;
+  }
+  ipcPath;
+  socket;
+  buffer = "";
+  messageHandlers = /* @__PURE__ */ new Set();
+  closeHandlers = /* @__PURE__ */ new Set();
+  helloId;
+  helloWaiter;
+  async connect(appName = "unknown") {
+    this.close();
+    const socket = await new Promise((resolve2, reject) => {
+      const client = net2.connect(this.ipcPath, () => {
+        client.off("error", reject);
+        resolve2(client);
+      });
+      client.once("error", reject);
+    });
+    this.socket = socket;
+    socket.setEncoding("utf8");
+    socket.setNoDelay(true);
+    socket.on("data", (chunk) => {
+      this.buffer += chunk.toString();
+      this.drainBuffer();
+    });
+    socket.on("close", () => {
+      this.handleClose();
+    });
+    socket.on("end", () => {
+      this.handleClose();
+    });
+    socket.on("error", () => void 0);
+    this.helloId = `shim-hello-${randomUUID()}`;
+    await new Promise((resolve2, reject) => {
+      this.helloWaiter = { resolve: resolve2, reject };
+      this.send({
+        jsonrpc: "2.0",
+        id: this.helloId,
+        method: "shim_hello",
+        params: {
+          appName,
+          pid: process.pid,
+          ...process.env.COLLECTIVE_PROFILE ? { profile: process.env.COLLECTIVE_PROFILE } : {}
+        }
+      });
+    });
+  }
+  send(message) {
+    this.sendRaw(JSON.stringify(message));
+  }
+  sendRaw(line) {
+    const socket = this.socket;
+    if (!socket || socket.destroyed) {
+      throw new Error("IPC client is not connected");
+    }
+    socket.write(`${line.trimEnd()}
+`);
+  }
+  onMessage(handler) {
+    this.messageHandlers.add(handler);
+  }
+  onClose(handler) {
+    this.closeHandlers.add(handler);
+  }
+  close() {
+    const socket = this.socket;
+    this.socket = void 0;
+    this.buffer = "";
+    this.rejectHello(new Error("IPC connection closed"));
+    if (socket && !socket.destroyed) {
+      socket.destroy();
+    }
+  }
+  drainBuffer() {
+    let newlineIndex = this.buffer.indexOf("\n");
+    while (newlineIndex >= 0) {
+      const line = this.buffer.slice(0, newlineIndex).trim();
+      this.buffer = this.buffer.slice(newlineIndex + 1);
+      if (line) {
+        const message = JSON.parse(line);
+        if (this.helloWaiter && message.id === this.helloId) {
+          const waiter = this.helloWaiter;
+          this.helloWaiter = void 0;
+          this.helloId = void 0;
+          if (message.error && typeof message.error === "object") {
+            waiter.reject(new Error(String(message.error.message ?? "shim_hello failed")));
+          } else {
+            waiter.resolve();
+          }
+        } else {
+          for (const handler of this.messageHandlers) {
+            handler(message);
+          }
+        }
+      }
+      newlineIndex = this.buffer.indexOf("\n");
+    }
+  }
+  handleClose() {
+    if (!this.socket && !this.helloWaiter) {
+      return;
+    }
+    this.socket = void 0;
+    this.buffer = "";
+    this.rejectHello(new Error("IPC connection closed"));
+    for (const handler of this.closeHandlers) {
+      handler();
+    }
+  }
+  rejectHello(error) {
+    if (!this.helloWaiter) {
+      return;
+    }
+    const waiter = this.helloWaiter;
+    this.helloWaiter = void 0;
+    this.helloId = void 0;
+    waiter.reject(error);
+  }
+};
+
+// src/bridge.ts
+var execFileAsync = promisify(execFile);
+async function startShim() {
+  await createBridge();
+}
+async function createBridge(options = {}) {
+  const stdin = options.stdin ?? process.stdin;
+  const stdout = options.stdout ?? process.stdout;
+  const stderr = options.stderr ?? process.stderr;
+  const exit = options.exit ?? ((code) => process.exit(code));
+  const ensureDaemon = options.ensureDaemon ?? ensureDaemonRunning;
+  const launcherOptions = {
+    ipcPath: options.ipcPath ?? getDefaultIpcPath(),
+    pidFile: options.pidFile ?? getDefaultPidFile(),
+    daemonBin: options.daemonBin ?? resolveDaemonBin(),
+    startupTimeoutMs: options.startupTimeoutMs ?? 5e3
+  };
+  const appName = options.appName ?? await guessAppName();
+  let client;
+  let stdinBuffer = "";
+  let closing = false;
+  let reconnecting;
+  const pending = [];
+  const writeError = (message) => {
+    stdout.write(`${JSON.stringify({ jsonrpc: "2.0", id: null, error: { code: -32e3, message } })}
+`);
+    stderr.write(`mesh-shim: ${message}
+`);
+  };
+  const flushPending = () => {
+    if (!client) {
+      return;
+    }
+    while (pending.length > 0) {
+      try {
+        client.sendRaw(pending[0]);
+        pending.shift();
+      } catch {
+        return;
+      }
+    }
+  };
+  const connect = async () => {
+    await ensureDaemon(launcherOptions);
+    const deadline = Date.now() + launcherOptions.startupTimeoutMs;
+    while (true) {
+      const next = new IpcClient(launcherOptions.ipcPath);
+      next.onMessage((message) => {
+        stdout.write(`${JSON.stringify(message)}
+`);
+      });
+      next.onClose(() => {
+        if (!closing && client === next) {
+          client = void 0;
+          void reconnect();
+        }
+      });
+      try {
+        await next.connect(appName);
+        client = next;
+        flushPending();
+        return;
+      } catch (error) {
+        next.close();
+        if (Date.now() >= deadline) {
+          throw error;
+        }
+        await delay2(200);
+      }
+    }
+  };
+  const reconnect = async () => {
+    if (reconnecting) {
+      return reconnecting;
+    }
+    reconnecting = (async () => {
+      try {
+        await connect();
+      } catch (error) {
+        if (!closing) {
+          closing = true;
+          client?.close();
+          writeError(`Unable to reach mesh daemon: ${error.message}`);
+          exit(1);
+        }
+      } finally {
+        reconnecting = void 0;
+      }
+    })();
+    return reconnecting;
+  };
+  try {
+    await connect();
+  } catch (error) {
+    closing = true;
+    writeError(`Unable to start mesh daemon: ${error.message}`);
+    exit(1);
+    return { close: () => void 0 };
+  }
+  if ("setEncoding" in stdin && typeof stdin.setEncoding === "function") {
+    stdin.setEncoding("utf8");
+  }
+  const handleChunk = (chunk) => {
+    stdinBuffer += chunk.toString();
+    let newlineIndex = stdinBuffer.indexOf("\n");
+    while (newlineIndex >= 0) {
+      const line = stdinBuffer.slice(0, newlineIndex).trim();
+      stdinBuffer = stdinBuffer.slice(newlineIndex + 1);
+      if (line) {
+        if (client) {
+          try {
+            client.sendRaw(line);
+          } catch {
+            pending.push(line);
+            void reconnect();
+          }
+        } else {
+          pending.push(line);
+          void reconnect();
+        }
+      }
+      newlineIndex = stdinBuffer.indexOf("\n");
+    }
+  };
+  const shutdown = () => {
+    if (closing) {
+      return;
+    }
+    closing = true;
+    stdin.off("data", handleChunk);
+    stdin.off("end", shutdown);
+    stdin.off("close", shutdown);
+    client?.close();
+    exit(0);
+  };
+  stdin.on("data", handleChunk);
+  stdin.on("end", shutdown);
+  stdin.on("close", shutdown);
+  if ("resume" in stdin && typeof stdin.resume === "function") {
+    stdin.resume();
+  }
+  return { close: shutdown };
+}
+async function guessAppName() {
+  if (process.env.COLLECTIVE_APP_NAME) {
+    return process.env.COLLECTIVE_APP_NAME;
+  }
+  const arg = process.argv.map((value) => basename(value).toLowerCase()).find((value) => value && !["node", "node.exe", "mesh-shim", "index.js"].includes(value));
+  if (arg) {
+    return arg.replace(/\.(cmd|exe)$/i, "");
+  }
+  try {
+    const result = process.platform === "win32" ? await execFileAsync(
+      "powershell",
+      ["-NoProfile", "-Command", `(Get-CimInstance Win32_Process -Filter "ProcessId = ${process.ppid}").Name`],
+      { windowsHide: true }
+    ) : await execFileAsync("ps", ["-o", "comm=", "-p", String(process.ppid)]);
+    const name = basename(result.stdout.trim()).replace(/\.(cmd|exe)$/i, "").toLowerCase();
+    return name || "unknown";
+  } catch {
+    return "unknown";
+  }
+}
+
+// src/index.ts
+startShim().catch((err) => {
+  process.stderr.write(`mesh-shim fatal: ${err.message}
+`);
+  process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/bridge.ts","../src/daemon-launcher.ts","../src/ipc-client.ts","../src/index.ts"],"sourcesContent":["import { execFile } from 'node:child_process';\nimport { basename } from 'node:path';\nimport { setTimeout as delay } from 'node:timers/promises';\nimport { promisify } from 'node:util';\n\nimport {\n  ensureDaemonRunning,\n  getDefaultIpcPath,\n  getDefaultPidFile,\n  resolveDaemonBin,\n  type LauncherOptions,\n} from './daemon-launcher.js';\nimport { IpcClient } from './ipc-client.js';\n\nconst execFileAsync = promisify(execFile);\n\nexport interface BridgeOptions {\n  ipcPath?: string;\n  pidFile?: string;\n  daemonBin?: string;\n  startupTimeoutMs?: number;\n  appName?: string;\n  stdin?: NodeJS.ReadableStream;\n  stdout?: NodeJS.WritableStream;\n  stderr?: NodeJS.WritableStream;\n  exit?: (code: number) => void;\n  ensureDaemon?: (options: LauncherOptions) => Promise<void>;\n}\n\nexport interface BridgeHandle {\n  close(): void;\n}\n\nexport async function startShim(): Promise<void> {\n  await createBridge();\n}\n\nexport async function createBridge(options: BridgeOptions = {}): Promise<BridgeHandle> {\n  const stdin = options.stdin ?? process.stdin;\n  const stdout = options.stdout ?? process.stdout;\n  const stderr = options.stderr ?? process.stderr;\n  const exit = options.exit ?? ((code: number) => process.exit(code));\n  const ensureDaemon = options.ensureDaemon ?? ensureDaemonRunning;\n  const launcherOptions: LauncherOptions = {\n    ipcPath: options.ipcPath ?? getDefaultIpcPath(),\n    pidFile: options.pidFile ?? getDefaultPidFile(),\n    daemonBin: options.daemonBin ?? resolveDaemonBin(),\n    startupTimeoutMs: options.startupTimeoutMs ?? 5_000,\n  };\n  const appName = options.appName ?? (await guessAppName());\n\n  let client: IpcClient | undefined;\n  let stdinBuffer = '';\n  let closing = false;\n  let reconnecting: Promise<void> | undefined;\n  const pending: string[] = [];\n\n  const writeError = (message: string) => {\n    stdout.write(`${JSON.stringify({ jsonrpc: '2.0', id: null, error: { code: -32000, message } })}\\n`);\n    stderr.write(`mesh-shim: ${message}\\n`);\n  };\n\n  const flushPending = () => {\n    if (!client) {\n      return;\n    }\n\n    while (pending.length > 0) {\n      try {\n        client.sendRaw(pending[0] as string);\n        pending.shift();\n      } catch {\n        return;\n      }\n    }\n  };\n\n  const connect = async () => {\n    await ensureDaemon(launcherOptions);\n    const deadline = Date.now() + launcherOptions.startupTimeoutMs;\n    while (true) {\n      const next = new IpcClient(launcherOptions.ipcPath);\n      next.onMessage((message) => {\n        stdout.write(`${JSON.stringify(message)}\\n`);\n      });\n      next.onClose(() => {\n        if (!closing && client === next) {\n          client = undefined;\n          void reconnect();\n        }\n      });\n\n      try {\n        await next.connect(appName);\n        client = next;\n        flushPending();\n        return;\n      } catch (error) {\n        next.close();\n        if (Date.now() >= deadline) {\n          throw error;\n        }\n        await delay(200);\n      }\n    }\n  };\n\n  const reconnect = async () => {\n    if (reconnecting) {\n      return reconnecting;\n    }\n\n    reconnecting = (async () => {\n      try {\n        await connect();\n      } catch (error) {\n        if (!closing) {\n          closing = true;\n          client?.close();\n          writeError(`Unable to reach mesh daemon: ${(error as Error).message}`);\n          exit(1);\n        }\n      } finally {\n        reconnecting = undefined;\n      }\n    })();\n\n    return reconnecting;\n  };\n\n  try {\n    await connect();\n  } catch (error) {\n    closing = true;\n    writeError(`Unable to start mesh daemon: ${(error as Error).message}`);\n    exit(1);\n    return { close: () => undefined };\n  }\n\n  if ('setEncoding' in stdin && typeof stdin.setEncoding === 'function') {\n    stdin.setEncoding('utf8');\n  }\n\n  const handleChunk = (chunk: string | Buffer) => {\n    stdinBuffer += chunk.toString();\n    let newlineIndex = stdinBuffer.indexOf('\\n');\n    while (newlineIndex >= 0) {\n      const line = stdinBuffer.slice(0, newlineIndex).trim();\n      stdinBuffer = stdinBuffer.slice(newlineIndex + 1);\n      if (line) {\n        if (client) {\n          try {\n            client.sendRaw(line);\n          } catch {\n            pending.push(line);\n            void reconnect();\n          }\n        } else {\n          pending.push(line);\n          void reconnect();\n        }\n      }\n      newlineIndex = stdinBuffer.indexOf('\\n');\n    }\n  };\n\n  const shutdown = () => {\n    if (closing) {\n      return;\n    }\n\n    closing = true;\n    stdin.off('data', handleChunk);\n    stdin.off('end', shutdown);\n    stdin.off('close', shutdown);\n    client?.close();\n    exit(0);\n  };\n\n  stdin.on('data', handleChunk);\n  stdin.on('end', shutdown);\n  stdin.on('close', shutdown);\n  if ('resume' in stdin && typeof stdin.resume === 'function') {\n    stdin.resume();\n  }\n\n  return { close: shutdown };\n}\n\nasync function guessAppName(): Promise<string> {\n  if (process.env.COLLECTIVE_APP_NAME) {\n    return process.env.COLLECTIVE_APP_NAME;\n  }\n\n  const arg = process.argv\n    .map((value) => basename(value).toLowerCase())\n    .find((value) => value && !['node', 'node.exe', 'mesh-shim', 'index.js'].includes(value));\n  if (arg) {\n    return arg.replace(/\\.(cmd|exe)$/i, '');\n  }\n\n  try {\n    const result =\n      process.platform === 'win32'\n        ? await execFileAsync(\n            'powershell',\n            ['-NoProfile', '-Command', `(Get-CimInstance Win32_Process -Filter \"ProcessId = ${process.ppid}\").Name`],\n            { windowsHide: true },\n          )\n        : await execFileAsync('ps', ['-o', 'comm=', '-p', String(process.ppid)]);\n    const name = basename(result.stdout.trim()).replace(/\\.(cmd|exe)$/i, '').toLowerCase();\n    return name || 'unknown';\n  } catch {\n    return 'unknown';\n  }\n}\n","import { spawn, spawnSync } from 'node:child_process';\nimport { createRequire } from 'node:module';\nimport net from 'node:net';\nimport { homedir, userInfo } from 'node:os';\nimport { resolve } from 'node:path';\nimport { setTimeout as delay } from 'node:timers/promises';\nimport { fileURLToPath } from 'node:url';\n\nconst require = createRequire(import.meta.url);\n\nexport interface LauncherOptions {\n  ipcPath: string;\n  pidFile: string;\n  daemonBin: string;\n  startupTimeoutMs: number;\n}\n\nconst LEGACY_WINDOWS_PIPE_PATH = '\\\\\\\\.\\\\pipe\\\\hivemind-collective';\n\nexport function getDefaultIpcPath(): string {\n  return process.env.COLLECTIVE_IPC_PATH ??\n    (process.platform === 'win32'\n      ? `${LEGACY_WINDOWS_PIPE_PATH}-${sanitizePipeSegment(getCurrentUsername())}`\n      : resolve(homedir(), '.hivemind-os/collective', 'mesh.sock'));\n}\n\nexport function getDefaultPidFile(): string {\n  return process.env.COLLECTIVE_PID_FILE ?? resolve(homedir(), '.hivemind-os/collective', 'daemon.pid');\n}\n\nexport function resolveDaemonBin(): string {\n  if (process.env.COLLECTIVE_DAEMON_BIN) {\n    return process.env.COLLECTIVE_DAEMON_BIN;\n  }\n\n  try {\n    return require.resolve('@hivemind-os/collective-daemon');\n  } catch {\n    if (commandExists('mesh-daemon')) {\n      return 'mesh-daemon';\n    }\n\n    return fileURLToPath(new URL('../../daemon/dist/index.js', import.meta.url));\n  }\n}\n\nexport async function isDaemonRunning(ipcPath: string): Promise<boolean> {\n  return new Promise((resolvePromise) => {\n    const socket = net.connect(ipcPath);\n    const finish = (running: boolean) => {\n      socket.removeAllListeners();\n      socket.destroy();\n      resolvePromise(running);\n    };\n\n    socket.once('connect', () => {\n      finish(true);\n    });\n    socket.once('error', () => {\n      finish(false);\n    });\n  });\n}\n\nexport async function ensureDaemonRunning(options: LauncherOptions): Promise<void> {\n  if (await isDaemonRunning(options.ipcPath)) {\n    return;\n  }\n\n  const command = options.daemonBin.endsWith('.js') ? process.execPath : options.daemonBin;\n  const args = options.daemonBin.endsWith('.js') ? [options.daemonBin] : [];\n  const child = spawn(command, args, { detached: true, stdio: 'ignore' });\n  child.unref();\n\n  const deadline = Date.now() + options.startupTimeoutMs;\n  while (Date.now() < deadline) {\n    await delay(200);\n    if (await isDaemonRunning(options.ipcPath)) {\n      return;\n    }\n  }\n\n  throw new Error(`Timed out waiting for daemon IPC at ${options.ipcPath} (pid file: ${options.pidFile})`);\n}\n\nfunction commandExists(command: string): boolean {\n  const probe = process.platform === 'win32' ? 'where' : 'which';\n  return spawnSync(probe, [command], { stdio: 'ignore' }).status === 0;\n}\n\nfunction getCurrentUsername(): string {\n  try {\n    return userInfo().username;\n  } catch {\n    return process.env.USERNAME ?? process.env.USER ?? 'unknown-user';\n  }\n}\n\nfunction sanitizePipeSegment(value: string): string {\n  const leaf = value.split(/[\\\\/]+/).filter(Boolean).at(-1) ?? value;\n  const sanitized = leaf.trim().toLowerCase().replace(/[^a-z0-9_.-]+/g, '-').replace(/^-+|-+$/g, '');\n  return sanitized || 'unknown-user';\n}\n","import { randomUUID } from 'node:crypto';\nimport net from 'node:net';\n\ntype MessageHandler = (message: object) => void;\ntype CloseHandler = () => void;\n\nexport class IpcClient {\n  private socket?: net.Socket;\n  private buffer = '';\n  private readonly messageHandlers = new Set<MessageHandler>();\n  private readonly closeHandlers = new Set<CloseHandler>();\n  private helloId?: string;\n  private helloWaiter?: { resolve: () => void; reject: (error: Error) => void };\n\n  constructor(private readonly ipcPath: string) {}\n\n  async connect(appName = 'unknown'): Promise<void> {\n    this.close();\n    const socket = await new Promise<net.Socket>((resolve, reject) => {\n      const client = net.connect(this.ipcPath, () => {\n        client.off('error', reject);\n        resolve(client);\n      });\n      client.once('error', reject);\n    });\n\n    this.socket = socket;\n    socket.setEncoding('utf8');\n    socket.setNoDelay(true);\n    socket.on('data', (chunk: string | Buffer) => {\n      this.buffer += chunk.toString();\n      this.drainBuffer();\n    });\n    socket.on('close', () => {\n      this.handleClose();\n    });\n    socket.on('end', () => {\n      this.handleClose();\n    });\n    socket.on('error', () => undefined);\n\n    this.helloId = `shim-hello-${randomUUID()}`;\n    await new Promise<void>((resolve, reject) => {\n      this.helloWaiter = { resolve, reject };\n      this.send({\n        jsonrpc: '2.0',\n        id: this.helloId as string,\n        method: 'shim_hello',\n        params: {\n          appName,\n          pid: process.pid,\n          ...(process.env.COLLECTIVE_PROFILE ? { profile: process.env.COLLECTIVE_PROFILE } : {}),\n        },\n      });\n    });\n  }\n\n  send(message: object): void {\n    this.sendRaw(JSON.stringify(message));\n  }\n\n  sendRaw(line: string): void {\n    const socket = this.socket;\n    if (!socket || socket.destroyed) {\n      throw new Error('IPC client is not connected');\n    }\n\n    socket.write(`${line.trimEnd()}\\n`);\n  }\n\n  onMessage(handler: (message: object) => void): void {\n    this.messageHandlers.add(handler);\n  }\n\n  onClose(handler: () => void): void {\n    this.closeHandlers.add(handler);\n  }\n\n  close(): void {\n    const socket = this.socket;\n    this.socket = undefined;\n    this.buffer = '';\n    this.rejectHello(new Error('IPC connection closed'));\n    if (socket && !socket.destroyed) {\n      socket.destroy();\n    }\n  }\n\n  private drainBuffer(): void {\n    let newlineIndex = this.buffer.indexOf('\\n');\n    while (newlineIndex >= 0) {\n      const line = this.buffer.slice(0, newlineIndex).trim();\n      this.buffer = this.buffer.slice(newlineIndex + 1);\n      if (line) {\n        const message = JSON.parse(line) as Record<string, unknown>;\n        if (this.helloWaiter && message.id === this.helloId) {\n          const waiter = this.helloWaiter;\n          this.helloWaiter = undefined;\n          this.helloId = undefined;\n          if (message.error && typeof message.error === 'object') {\n            waiter.reject(new Error(String((message.error as { message?: unknown }).message ?? 'shim_hello failed')));\n          } else {\n            waiter.resolve();\n          }\n        } else {\n          for (const handler of this.messageHandlers) {\n            handler(message);\n          }\n        }\n      }\n      newlineIndex = this.buffer.indexOf('\\n');\n    }\n  }\n\n  private handleClose(): void {\n    if (!this.socket && !this.helloWaiter) {\n      return;\n    }\n\n    this.socket = undefined;\n    this.buffer = '';\n    this.rejectHello(new Error('IPC connection closed'));\n    for (const handler of this.closeHandlers) {\n      handler();\n    }\n  }\n\n  private rejectHello(error: Error): void {\n    if (!this.helloWaiter) {\n      return;\n    }\n\n    const waiter = this.helloWaiter;\n    this.helloWaiter = undefined;\n    this.helloId = undefined;\n    waiter.reject(error);\n  }\n}\n","#!/usr/bin/env node\n\nimport { startShim } from './bridge.js';\n\nstartShim().catch((err) => {\n  process.stderr.write(`mesh-shim fatal: ${err.message}\\n`);\n  process.exit(1);\n});\n"],"mappings":"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","names":["delay","require","net","resolve","delay"]}

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@hivemind-os/collective-shim",
+  "version": "0.2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "collective-shim": "./dist/index.js"
+  },
+  "dependencies": {
+    "pino": "^9.0.0"
+  },
+  "devDependencies": {
+    "vitest": "^3.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.7.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest",
+    "lint": "eslint src/"
+  }
+}

package/src/bridge.ts

@@ -0,0 +1,216 @@
+import { execFile } from 'node:child_process';
+import { basename } from 'node:path';
+import { setTimeout as delay } from 'node:timers/promises';
+import { promisify } from 'node:util';
+
+import {
+  ensureDaemonRunning,
+  getDefaultIpcPath,
+  getDefaultPidFile,
+  resolveDaemonBin,
+  type LauncherOptions,
+} from './daemon-launcher.js';
+import { IpcClient } from './ipc-client.js';
+
+const execFileAsync = promisify(execFile);
+
+export interface BridgeOptions {
+  ipcPath?: string;
+  pidFile?: string;
+  daemonBin?: string;
+  startupTimeoutMs?: number;
+  appName?: string;
+  stdin?: NodeJS.ReadableStream;
+  stdout?: NodeJS.WritableStream;
+  stderr?: NodeJS.WritableStream;
+  exit?: (code: number) => void;
+  ensureDaemon?: (options: LauncherOptions) => Promise<void>;
+}
+
+export interface BridgeHandle {
+  close(): void;
+}
+
+export async function startShim(): Promise<void> {
+  await createBridge();
+}
+
+export async function createBridge(options: BridgeOptions = {}): Promise<BridgeHandle> {
+  const stdin = options.stdin ?? process.stdin;
+  const stdout = options.stdout ?? process.stdout;
+  const stderr = options.stderr ?? process.stderr;
+  const exit = options.exit ?? ((code: number) => process.exit(code));
+  const ensureDaemon = options.ensureDaemon ?? ensureDaemonRunning;
+  const launcherOptions: LauncherOptions = {
+    ipcPath: options.ipcPath ?? getDefaultIpcPath(),
+    pidFile: options.pidFile ?? getDefaultPidFile(),
+    daemonBin: options.daemonBin ?? resolveDaemonBin(),
+    startupTimeoutMs: options.startupTimeoutMs ?? 5_000,
+  };
+  const appName = options.appName ?? (await guessAppName());
+
+  let client: IpcClient | undefined;
+  let stdinBuffer = '';
+  let closing = false;
+  let reconnecting: Promise<void> | undefined;
+  const pending: string[] = [];
+
+  const writeError = (message: string) => {
+    stdout.write(`${JSON.stringify({ jsonrpc: '2.0', id: null, error: { code: -32000, message } })}\n`);
+    stderr.write(`mesh-shim: ${message}\n`);
+  };
+
+  const flushPending = () => {
+    if (!client) {
+      return;
+    }
+
+    while (pending.length > 0) {
+      try {
+        client.sendRaw(pending[0] as string);
+        pending.shift();
+      } catch {
+        return;
+      }
+    }
+  };
+
+  const connect = async () => {
+    await ensureDaemon(launcherOptions);
+    const deadline = Date.now() + launcherOptions.startupTimeoutMs;
+    while (true) {
+      const next = new IpcClient(launcherOptions.ipcPath);
+      next.onMessage((message) => {
+        stdout.write(`${JSON.stringify(message)}\n`);
+      });
+      next.onClose(() => {
+        if (!closing && client === next) {
+          client = undefined;
+          void reconnect();
+        }
+      });
+
+      try {
+        await next.connect(appName);
+        client = next;
+        flushPending();
+        return;
+      } catch (error) {
+        next.close();
+        if (Date.now() >= deadline) {
+          throw error;
+        }
+        await delay(200);
+      }
+    }
+  };
+
+  const reconnect = async () => {
+    if (reconnecting) {
+      return reconnecting;
+    }
+
+    reconnecting = (async () => {
+      try {
+        await connect();
+      } catch (error) {
+        if (!closing) {
+          closing = true;
+          client?.close();
+          writeError(`Unable to reach mesh daemon: ${(error as Error).message}`);
+          exit(1);
+        }
+      } finally {
+        reconnecting = undefined;
+      }
+    })();
+
+    return reconnecting;
+  };
+
+  try {
+    await connect();
+  } catch (error) {
+    closing = true;
+    writeError(`Unable to start mesh daemon: ${(error as Error).message}`);
+    exit(1);
+    return { close: () => undefined };
+  }
+
+  if ('setEncoding' in stdin && typeof stdin.setEncoding === 'function') {
+    stdin.setEncoding('utf8');
+  }
+
+  const handleChunk = (chunk: string | Buffer) => {
+    stdinBuffer += chunk.toString();
+    let newlineIndex = stdinBuffer.indexOf('\n');
+    while (newlineIndex >= 0) {
+      const line = stdinBuffer.slice(0, newlineIndex).trim();
+      stdinBuffer = stdinBuffer.slice(newlineIndex + 1);
+      if (line) {
+        if (client) {
+          try {
+            client.sendRaw(line);
+          } catch {
+            pending.push(line);
+            void reconnect();
+          }
+        } else {
+          pending.push(line);
+          void reconnect();
+        }
+      }
+      newlineIndex = stdinBuffer.indexOf('\n');
+    }
+  };
+
+  const shutdown = () => {
+    if (closing) {
+      return;
+    }
+
+    closing = true;
+    stdin.off('data', handleChunk);
+    stdin.off('end', shutdown);
+    stdin.off('close', shutdown);
+    client?.close();
+    exit(0);
+  };
+
+  stdin.on('data', handleChunk);
+  stdin.on('end', shutdown);
+  stdin.on('close', shutdown);
+  if ('resume' in stdin && typeof stdin.resume === 'function') {
+    stdin.resume();
+  }
+
+  return { close: shutdown };
+}
+
+async function guessAppName(): Promise<string> {
+  if (process.env.COLLECTIVE_APP_NAME) {
+    return process.env.COLLECTIVE_APP_NAME;
+  }
+
+  const arg = process.argv
+    .map((value) => basename(value).toLowerCase())
+    .find((value) => value && !['node', 'node.exe', 'mesh-shim', 'index.js'].includes(value));
+  if (arg) {
+    return arg.replace(/\.(cmd|exe)$/i, '');
+  }
+
+  try {
+    const result =
+      process.platform === 'win32'
+        ? await execFileAsync(
+            'powershell',
+            ['-NoProfile', '-Command', `(Get-CimInstance Win32_Process -Filter "ProcessId = ${process.ppid}").Name`],
+            { windowsHide: true },
+          )
+        : await execFileAsync('ps', ['-o', 'comm=', '-p', String(process.ppid)]);
+    const name = basename(result.stdout.trim()).replace(/\.(cmd|exe)$/i, '').toLowerCase();
+    return name || 'unknown';
+  } catch {
+    return 'unknown';
+  }
+}

package/src/daemon-launcher.ts

@@ -0,0 +1,103 @@
+import { spawn, spawnSync } from 'node:child_process';
+import { createRequire } from 'node:module';
+import net from 'node:net';
+import { homedir, userInfo } from 'node:os';
+import { resolve } from 'node:path';
+import { setTimeout as delay } from 'node:timers/promises';
+import { fileURLToPath } from 'node:url';
+
+const require = createRequire(import.meta.url);
+
+export interface LauncherOptions {
+  ipcPath: string;
+  pidFile: string;
+  daemonBin: string;
+  startupTimeoutMs: number;
+}
+
+const LEGACY_WINDOWS_PIPE_PATH = '\\\\.\\pipe\\hivemind-collective';
+
+export function getDefaultIpcPath(): string {
+  return process.env.COLLECTIVE_IPC_PATH ??
+    (process.platform === 'win32'
+      ? `${LEGACY_WINDOWS_PIPE_PATH}-${sanitizePipeSegment(getCurrentUsername())}`
+      : resolve(homedir(), '.hivemind-os/collective', 'mesh.sock'));
+}
+
+export function getDefaultPidFile(): string {
+  return process.env.COLLECTIVE_PID_FILE ?? resolve(homedir(), '.hivemind-os/collective', 'daemon.pid');
+}
+
+export function resolveDaemonBin(): string {
+  if (process.env.COLLECTIVE_DAEMON_BIN) {
+    return process.env.COLLECTIVE_DAEMON_BIN;
+  }
+
+  try {
+    return require.resolve('@hivemind-os/collective-daemon');
+  } catch {
+    if (commandExists('mesh-daemon')) {
+      return 'mesh-daemon';
+    }
+
+    return fileURLToPath(new URL('../../daemon/dist/index.js', import.meta.url));
+  }
+}
+
+export async function isDaemonRunning(ipcPath: string): Promise<boolean> {
+  return new Promise((resolvePromise) => {
+    const socket = net.connect(ipcPath);
+    const finish = (running: boolean) => {
+      socket.removeAllListeners();
+      socket.destroy();
+      resolvePromise(running);
+    };
+
+    socket.once('connect', () => {
+      finish(true);
+    });
+    socket.once('error', () => {
+      finish(false);
+    });
+  });
+}
+
+export async function ensureDaemonRunning(options: LauncherOptions): Promise<void> {
+  if (await isDaemonRunning(options.ipcPath)) {
+    return;
+  }
+
+  const command = options.daemonBin.endsWith('.js') ? process.execPath : options.daemonBin;
+  const args = options.daemonBin.endsWith('.js') ? [options.daemonBin] : [];
+  const child = spawn(command, args, { detached: true, stdio: 'ignore' });
+  child.unref();
+
+  const deadline = Date.now() + options.startupTimeoutMs;
+  while (Date.now() < deadline) {
+    await delay(200);
+    if (await isDaemonRunning(options.ipcPath)) {
+      return;
+    }
+  }
+
+  throw new Error(`Timed out waiting for daemon IPC at ${options.ipcPath} (pid file: ${options.pidFile})`);
+}
+
+function commandExists(command: string): boolean {
+  const probe = process.platform === 'win32' ? 'where' : 'which';
+  return spawnSync(probe, [command], { stdio: 'ignore' }).status === 0;
+}
+
+function getCurrentUsername(): string {
+  try {
+    return userInfo().username;
+  } catch {
+    return process.env.USERNAME ?? process.env.USER ?? 'unknown-user';
+  }
+}
+
+function sanitizePipeSegment(value: string): string {
+  const leaf = value.split(/[\\/]+/).filter(Boolean).at(-1) ?? value;
+  const sanitized = leaf.trim().toLowerCase().replace(/[^a-z0-9_.-]+/g, '-').replace(/^-+|-+$/g, '');
+  return sanitized || 'unknown-user';
+}

package/src/index.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+
+import { startShim } from './bridge.js';
+
+startShim().catch((err) => {
+  process.stderr.write(`mesh-shim fatal: ${err.message}\n`);
+  process.exit(1);
+});

package/src/ipc-client.ts

@@ -0,0 +1,138 @@
+import { randomUUID } from 'node:crypto';
+import net from 'node:net';
+
+type MessageHandler = (message: object) => void;
+type CloseHandler = () => void;
+
+export class IpcClient {
+  private socket?: net.Socket;
+  private buffer = '';
+  private readonly messageHandlers = new Set<MessageHandler>();
+  private readonly closeHandlers = new Set<CloseHandler>();
+  private helloId?: string;
+  private helloWaiter?: { resolve: () => void; reject: (error: Error) => void };
+
+  constructor(private readonly ipcPath: string) {}
+
+  async connect(appName = 'unknown'): Promise<void> {
+    this.close();
+    const socket = await new Promise<net.Socket>((resolve, reject) => {
+      const client = net.connect(this.ipcPath, () => {
+        client.off('error', reject);
+        resolve(client);
+      });
+      client.once('error', reject);
+    });
+
+    this.socket = socket;
+    socket.setEncoding('utf8');
+    socket.setNoDelay(true);
+    socket.on('data', (chunk: string | Buffer) => {
+      this.buffer += chunk.toString();
+      this.drainBuffer();
+    });
+    socket.on('close', () => {
+      this.handleClose();
+    });
+    socket.on('end', () => {
+      this.handleClose();
+    });
+    socket.on('error', () => undefined);
+
+    this.helloId = `shim-hello-${randomUUID()}`;
+    await new Promise<void>((resolve, reject) => {
+      this.helloWaiter = { resolve, reject };
+      this.send({
+        jsonrpc: '2.0',
+        id: this.helloId as string,
+        method: 'shim_hello',
+        params: {
+          appName,
+          pid: process.pid,
+          ...(process.env.COLLECTIVE_PROFILE ? { profile: process.env.COLLECTIVE_PROFILE } : {}),
+        },
+      });
+    });
+  }
+
+  send(message: object): void {
+    this.sendRaw(JSON.stringify(message));
+  }
+
+  sendRaw(line: string): void {
+    const socket = this.socket;
+    if (!socket || socket.destroyed) {
+      throw new Error('IPC client is not connected');
+    }
+
+    socket.write(`${line.trimEnd()}\n`);
+  }
+
+  onMessage(handler: (message: object) => void): void {
+    this.messageHandlers.add(handler);
+  }
+
+  onClose(handler: () => void): void {
+    this.closeHandlers.add(handler);
+  }
+
+  close(): void {
+    const socket = this.socket;
+    this.socket = undefined;
+    this.buffer = '';
+    this.rejectHello(new Error('IPC connection closed'));
+    if (socket && !socket.destroyed) {
+      socket.destroy();
+    }
+  }
+
+  private drainBuffer(): void {
+    let newlineIndex = this.buffer.indexOf('\n');
+    while (newlineIndex >= 0) {
+      const line = this.buffer.slice(0, newlineIndex).trim();
+      this.buffer = this.buffer.slice(newlineIndex + 1);
+      if (line) {
+        const message = JSON.parse(line) as Record<string, unknown>;
+        if (this.helloWaiter && message.id === this.helloId) {
+          const waiter = this.helloWaiter;
+          this.helloWaiter = undefined;
+          this.helloId = undefined;
+          if (message.error && typeof message.error === 'object') {
+            waiter.reject(new Error(String((message.error as { message?: unknown }).message ?? 'shim_hello failed')));
+          } else {
+            waiter.resolve();
+          }
+        } else {
+          for (const handler of this.messageHandlers) {
+            handler(message);
+          }
+        }
+      }
+      newlineIndex = this.buffer.indexOf('\n');
+    }
+  }
+
+  private handleClose(): void {
+    if (!this.socket && !this.helloWaiter) {
+      return;
+    }
+
+    this.socket = undefined;
+    this.buffer = '';
+    this.rejectHello(new Error('IPC connection closed'));
+    for (const handler of this.closeHandlers) {
+      handler();
+    }
+  }
+
+  private rejectHello(error: Error): void {
+    if (!this.helloWaiter) {
+      return;
+    }
+
+    const waiter = this.helloWaiter;
+    this.helloWaiter = undefined;
+    this.helloId = undefined;
+    waiter.reject(error);
+  }
+}

package/tests/bridge.test.ts

@@ -0,0 +1,287 @@
+import { randomUUID } from 'node:crypto';
+import { mkdir, rm } from 'node:fs/promises';
+import net from 'node:net';
+import { resolve } from 'node:path';
+import { PassThrough } from 'node:stream';
+
+import { afterEach, describe, expect, it, vi } from 'vitest';
+
+import { createBridge } from '../src/bridge.js';
+
+const createdPaths: string[] = [];
+const servers = new Set<net.Server>();
+const sockets = new Set<net.Socket>();
+
+afterEach(async () => {
+  for (const socket of [...sockets]) {
+    socket.destroy();
+  }
+
+  await Promise.all(
+    [...servers].map(
+      (server) =>
+        new Promise<void>((resolvePromise) => {
+          server.close(() => {
+            resolvePromise();
+          });
+        }),
+    ),
+  );
+  servers.clear();
+  await Promise.all(createdPaths.splice(0).map((path) => rm(path, { recursive: true, force: true })));
+});
+
+class NdjsonReader {
+  private buffer = '';
+  private readonly messages: unknown[] = [];
+  private readonly waiters: Array<(message: unknown) => void> = [];
+
+  constructor(stream: NodeJS.ReadableStream) {
+    if ('setEncoding' in stream && typeof stream.setEncoding === 'function') {
+      stream.setEncoding('utf8');
+    }
+
+    stream.on('data', (chunk: string | Buffer) => {
+      this.buffer += chunk.toString();
+      this.drainBuffer();
+    });
+  }
+
+  async nextMessage(): Promise<any> {
+    if (this.messages.length > 0) {
+      return this.messages.shift();
+    }
+
+    return new Promise((resolvePromise) => {
+      this.waiters.push(resolvePromise);
+    });
+  }
+
+  collected(): unknown[] {
+    return [...this.messages];
+  }
+
+  private drainBuffer(): void {
+    let newlineIndex = this.buffer.indexOf('\n');
+    while (newlineIndex >= 0) {
+      const line = this.buffer.slice(0, newlineIndex).trim();
+      this.buffer = this.buffer.slice(newlineIndex + 1);
+      if (line) {
+        const message = JSON.parse(line) as unknown;
+        const waiter = this.waiters.shift();
+        if (waiter) {
+          waiter(message);
+        } else {
+          this.messages.push(message);
+        }
+      }
+      newlineIndex = this.buffer.indexOf('\n');
+    }
+  }
+}
+
+class MockIpcServer {
+  private server?: net.Server;
+  private socket?: net.Socket;
+  private reader?: NdjsonReader;
+
+  constructor(private readonly ipcPath: string) {}
+
+  async start(): Promise<void> {
+    this.server = net.createServer((socket) => {
+      this.socket = socket;
+      this.reader = new NdjsonReader(socket);
+      sockets.add(socket);
+      socket.once('close', () => {
+        sockets.delete(socket);
+        if (this.socket === socket) {
+          this.socket = undefined;
+          this.reader = undefined;
+        }
+      });
+    });
+
+    servers.add(this.server);
+    await new Promise<void>((resolvePromise, reject) => {
+      this.server?.once('error', reject);
+      this.server?.listen(this.ipcPath, () => {
+        this.server?.off('error', reject);
+        resolvePromise();
+      });
+    });
+  }
+
+  async stop(): Promise<void> {
+    this.socket?.destroy();
+    if (!this.server) {
+      return;
+    }
+
+    const server = this.server;
+    this.server = undefined;
+    servers.delete(server);
+    await new Promise<void>((resolvePromise) => {
+      server.close(() => {
+        resolvePromise();
+      });
+    });
+  }
+
+  async nextMessage(): Promise<any> {
+    while (!this.reader) {
+      await new Promise((resolvePromise) => setTimeout(resolvePromise, 10));
+    }
+
+    return this.reader.nextMessage();
+  }
+
+  send(message: object): void {
+    this.socket?.write(`${JSON.stringify(message)}\n`);
+  }
+}
+
+async function createTestDir(): Promise<string> {
+  const dir = resolve(process.cwd(), '.test-data', randomUUID());
+  createdPaths.push(dir);
+  await mkdir(dir, { recursive: true });
+  return dir;
+}
+
+function createIpcPath(dir: string): string {
+  if (process.platform === 'win32') {
+    return `\\\\.\\pipe\\hivemind-collective-shim-${randomUUID()}`;
+  }
+  // Unix socket paths have a 108-char limit; use /tmp with a short name
+  const short = randomUUID().slice(0, 8);
+  return `/tmp/hm-shim-${short}.sock`;
+}
+
+describe('bridge', () => {
+  it('sends shim_hello and bridges stdin/stdout messages', async () => {
+    const dir = await createTestDir();
+    const ipcPath = createIpcPath(dir);
+    const server = new MockIpcServer(ipcPath);
+    await server.start();
+
+    const stdin = new PassThrough();
+    const stdout = new PassThrough();
+    const stderr = new PassThrough();
+    const output = new NdjsonReader(stdout);
+    const exit = vi.fn();
+
+    const bridgePromise = createBridge({
+      ipcPath,
+      pidFile: resolve(dir, 'daemon.pid'),
+      daemonBin: 'mesh-daemon',
+      appName: 'claude-desktop',
+      stdin,
+      stdout,
+      stderr,
+      exit,
+      ensureDaemon: async () => undefined,
+    });
+
+    const hello = await server.nextMessage();
+    expect(hello).toMatchObject({
+      jsonrpc: '2.0',
+      method: 'shim_hello',
+      params: {
+        appName: 'claude-desktop',
+        pid: process.pid,
+      },
+    });
+
+    server.send({
+      jsonrpc: '2.0',
+      id: hello.id,
+      result: { acknowledged: true, connectionId: 'test-connection' },
+    });
+    const bridge = await bridgePromise;
+
+    await new Promise((resolvePromise) => setTimeout(resolvePromise, 25));
+    expect(output.collected()).toEqual([]);
+
+    stdin.write('{"jsonrpc":"2.0","id":"ping","method":"ping"}\n');
+    const forwarded = await server.nextMessage();
+    expect(forwarded).toEqual({ jsonrpc: '2.0', id: 'ping', method: 'ping' });
+
+    server.send({ jsonrpc: '2.0', id: 'pong', result: { ok: true } });
+    await expect(output.nextMessage()).resolves.toEqual({ jsonrpc: '2.0', id: 'pong', result: { ok: true } });
+
+    bridge.close();
+    expect(exit).toHaveBeenCalledWith(0);
+  });
+
+  it('reconnects and sends shim_hello again after the IPC connection drops', async () => {
+    const dir = await createTestDir();
+    const ipcPath = createIpcPath(dir);
+    const firstServer = new MockIpcServer(ipcPath);
+    await firstServer.start();
+
+    let releaseReconnect = () => undefined;
+    const reconnectGate = new Promise<void>((resolvePromise) => {
+      releaseReconnect = resolvePromise;
+    });
+    const ensureDaemon = vi.fn(async () => {
+      if (ensureDaemon.mock.calls.length > 1) {
+        await reconnectGate;
+      }
+    });
+
+    const stdin = new PassThrough();
+    const stdout = new PassThrough();
+    const stderr = new PassThrough();
+    const exit = vi.fn();
+
+    const bridgePromise = createBridge({
+      ipcPath,
+      pidFile: resolve(dir, 'daemon.pid'),
+      daemonBin: 'mesh-daemon',
+      appName: 'vscode',
+      stdin,
+      stdout,
+      stderr,
+      exit,
+      ensureDaemon,
+      startupTimeoutMs: 1_000,
+    });
+
+    const firstHello = await firstServer.nextMessage();
+    firstServer.send({
+      jsonrpc: '2.0',
+      id: firstHello.id,
+      result: { acknowledged: true, connectionId: 'first' },
+    });
+    const bridge = await bridgePromise;
+
+    await firstServer.stop();
+
+    const secondServer = new MockIpcServer(ipcPath);
+    await secondServer.start();
+    releaseReconnect();
+
+    const secondHello = await secondServer.nextMessage();
+    expect(secondHello).toMatchObject({
+      jsonrpc: '2.0',
+      method: 'shim_hello',
+      params: { appName: 'vscode', pid: process.pid },
+    });
+
+    secondServer.send({
+      jsonrpc: '2.0',
+      id: secondHello.id,
+      result: { acknowledged: true, connectionId: 'second' },
+    });
+
+    stdin.write('{"jsonrpc":"2.0","id":"after-reconnect","method":"ping"}\n');
+    await expect(secondServer.nextMessage()).resolves.toEqual({
+      jsonrpc: '2.0',
+      id: 'after-reconnect',
+      method: 'ping',
+    });
+
+    bridge.close();
+    expect(exit).toHaveBeenCalledWith(0);
+    expect(ensureDaemon).toHaveBeenCalledTimes(2);
+  });
+});

package/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "rootDir": ".",
+    "outDir": "dist",
+    "types": ["node", "vitest/globals"]
+  },
+  "include": ["src/**/*.ts", "tests/**/*.ts", "vitest.config.ts", "tsup.config.ts"]
+}

package/tsup.config.ts

@@ -0,0 +1,10 @@
+import { defineConfig } from 'tsup';
+
+export default defineConfig({
+  entry: ['src/index.ts'],
+  format: ['esm'],
+  dts: true,
+  clean: true,
+  sourcemap: true,
+  target: 'es2022',
+});

package/vitest.config.ts

@@ -0,0 +1,8 @@
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    environment: 'node',
+    passWithNoTests: false,
+  },
+});