@adhdev/session-host-core 1.0.28-rc.17 → 1.0.28-rc.19

package/dist/index.d.mts

@@ -495,7 +495,17 @@ interface SessionHostEndpoint {
     kind: 'unix' | 'pipe';
     path: string;
 }
-declare function getDefaultSessionHostEndpoint(appName?: string): SessionHostEndpoint;
+interface SessionHostEndpointOptions {
+    /**
+     * Instance IPC namespace key (see instance-key.ts). '' / omitted yields the
+     * legacy default-instance endpoint; a non-empty key suffixes the endpoint so
+     * each config-dir instance gets its own socket/pipe.
+     */
+    ipcKey?: string;
+    /** Test seam: override the platform the endpoint shape is derived for. */
+    platform?: NodeJS.Platform;
+}
+declare function getDefaultSessionHostEndpoint(appName?: string, options?: SessionHostEndpointOptions): SessionHostEndpoint;
 declare function createLineParser(onEnvelope: (envelope: SessionHostWireEnvelope) => void): (chunk: Buffer | string) => void;
 interface SessionHostClientOptions {
     endpoint?: SessionHostEndpoint;
@@ -515,6 +525,53 @@ declare class SessionHostClient {
 declare function createResponseEnvelope(requestId: string, response: SessionHostResponse): SessionHostResponseEnvelope;
 declare function writeEnvelope(socket: Pick<net.Socket, 'write'>, envelope: SessionHostWireEnvelope): void;
 
+/**
+ * Instance identity derivation for the session-host IPC namespace.
+ *
+ * One machine can host several ADHDev installs (stable `~/.adhdev`, preview
+ * `~/.adhdev-preview`, standalone `~/.adhdev-standalone`, or any explicit
+ * ADHDEV_CONFIG_DIR). Each install is an *instance*: it owns its config dir
+ * and everything mutable under it. The session-host socket/pipe must be
+ * namespaced by that identity so two simultaneous instances can never attach
+ * to, kill, or rebind each other's session host.
+ *
+ * This module is the single derivation rule, shared by:
+ * - the parent daemons (via @adhdev/daemon-core's InstanceContext),
+ * - the session-host-daemon child process (which only sees env vars),
+ * - CLI attach/list clients.
+ *
+ * All three compute the endpoint from the same inputs (appName +
+ * ADHDEV_CONFIG_DIR), so they always agree without extra plumbing.
+ *
+ * Compatibility contract: the DEFAULT instance (config dir canonicalizes to
+ * `<home>/.adhdev`) yields an EMPTY ipc key, so its socket/pipe path stays
+ * byte-for-byte identical to the pre-instance layout.
+ */
+declare const DEFAULT_CONFIG_DIR_NAME = ".adhdev";
+/**
+ * Resolve the instance config dir from the environment: ADHDEV_CONFIG_DIR
+ * when set (trimmed), else `<homeDir>/.adhdev`. Mirrors daemon-core's
+ * getConfigDir() source rule without the mkdir side effect.
+ */
+declare function resolveInstanceConfigDir(env?: NodeJS.ProcessEnv, homeDir?: string): string;
+/**
+ * Canonical form of an instance path for identity comparison/hashing:
+ * absolute, symlink-resolved (longest existing prefix), no trailing
+ * separator, case-folded on win32.
+ */
+declare function canonicalizeInstancePath(dir: string, platform?: NodeJS.Platform): string;
+/** True when `configDir` is canonically the default `<homeDir>/.adhdev`. */
+declare function isDefaultInstanceConfigDir(configDir: string, homeDir?: string, platform?: NodeJS.Platform): boolean;
+/**
+ * Derive the session-host IPC namespace key for an instance config dir.
+ *
+ * '' for the default instance (legacy-compatible endpoint), otherwise a
+ * 12-hex-char sha256 prefix of the canonical config dir — stable across
+ * processes/machines for the same dir, collision-resistant between dirs,
+ * and insensitive to symlink/spelling differences of the same dir.
+ */
+declare function resolveSessionHostIpcKey(configDir: string, homeDir?: string, platform?: NodeJS.Platform): string;
+
 /**
  * Shared PTY spawn environment utilities.
  *
@@ -588,4 +645,4 @@ interface SessionHostControlTransport {
  */
 declare function createSessionHostControlPlane(transport: SessionHostControlTransport): SessionHostControlPlane;
 
-export { type AcquireWritePayload, type AttachSessionPayload, type ClearSessionBufferPayload, type CreateSessionPayload, DEFAULT_SESSION_RING_BUFFER_MAX_BYTES, type DetachSessionPayload, type ForceDetachClientPayload, type GetHostDiagnosticsPayload, type GetSnapshotPayload, type GetTerminalSnapshotPayload, type PruneDuplicateSessionsPayload, type ReleaseWritePayload, type ResizeSessionPayload, type RestartSessionPayload, type ResumeSessionPayload, SESSION_HOST_SUPPORTED_REQUEST_TYPES, type SendInputPayload, type SendSignalPayload, type SessionAttachedClient, type SessionBufferSnapshot, type SessionClientType, type SessionHostCategory, SessionHostClient, type SessionHostClientOptions, type SessionHostControlPlane, type SessionHostControlTransport, type SessionHostDiagnostics, type SessionHostDuplicateSessionGroup, type SessionHostEndpoint, type SessionHostEvent, type SessionHostEventEnvelope, type SessionHostLogEntry, type SessionHostPruneDuplicatesResult, type SessionHostRecord, SessionHostRegistry, type SessionHostRequest, type SessionHostRequestEnvelope, type SessionHostRequestTrace, type SessionHostRequestType, type SessionHostResponse, type SessionHostResponseEnvelope, type SessionHostRuntimeTransition, type SessionHostSurfaceKind, type SessionHostSurfaceRecordLike, type SessionHostWireEnvelope, type SessionLaunchCommand, type SessionLifecycle, type SessionOwnerType, SessionRingBuffer, type SessionRingBufferOptions, type SessionTerminalSnapshot, type SessionTerminalState, type SessionTermination, type SessionTransport, type SessionWriteOwner, type StopSessionPayload, type UpdateSessionMetaPayload, applyTerminalColorEnv, buildRuntimeDisplayName, buildRuntimeKey, classifyTermination, createLineParser, createResponseEnvelope, createSessionHostControlPlane, ensureNodePtySpawnHelperPermissions, formatRuntimeOwner, getDefaultSessionHostEndpoint, getSessionHostRecoveryLabel, getSessionHostSurfaceKind, getWorkspaceLabel, isSessionHostLiveRuntime, isSessionHostRecoverySnapshot, partitionSessionHostDiagnosticsSessions, partitionSessionHostRecords, resolveAttachableRuntimeRecord, resolveRuntimeRecord, sanitizeSpawnEnv, writeEnvelope };
+export { type AcquireWritePayload, type AttachSessionPayload, type ClearSessionBufferPayload, type CreateSessionPayload, DEFAULT_CONFIG_DIR_NAME, DEFAULT_SESSION_RING_BUFFER_MAX_BYTES, type DetachSessionPayload, type ForceDetachClientPayload, type GetHostDiagnosticsPayload, type GetSnapshotPayload, type GetTerminalSnapshotPayload, type PruneDuplicateSessionsPayload, type ReleaseWritePayload, type ResizeSessionPayload, type RestartSessionPayload, type ResumeSessionPayload, SESSION_HOST_SUPPORTED_REQUEST_TYPES, type SendInputPayload, type SendSignalPayload, type SessionAttachedClient, type SessionBufferSnapshot, type SessionClientType, type SessionHostCategory, SessionHostClient, type SessionHostClientOptions, type SessionHostControlPlane, type SessionHostControlTransport, type SessionHostDiagnostics, type SessionHostDuplicateSessionGroup, type SessionHostEndpoint, type SessionHostEndpointOptions, type SessionHostEvent, type SessionHostEventEnvelope, type SessionHostLogEntry, type SessionHostPruneDuplicatesResult, type SessionHostRecord, SessionHostRegistry, type SessionHostRequest, type SessionHostRequestEnvelope, type SessionHostRequestTrace, type SessionHostRequestType, type SessionHostResponse, type SessionHostResponseEnvelope, type SessionHostRuntimeTransition, type SessionHostSurfaceKind, type SessionHostSurfaceRecordLike, type SessionHostWireEnvelope, type SessionLaunchCommand, type SessionLifecycle, type SessionOwnerType, SessionRingBuffer, type SessionRingBufferOptions, type SessionTerminalSnapshot, type SessionTerminalState, type SessionTermination, type SessionTransport, type SessionWriteOwner, type StopSessionPayload, type UpdateSessionMetaPayload, applyTerminalColorEnv, buildRuntimeDisplayName, buildRuntimeKey, canonicalizeInstancePath, classifyTermination, createLineParser, createResponseEnvelope, createSessionHostControlPlane, ensureNodePtySpawnHelperPermissions, formatRuntimeOwner, getDefaultSessionHostEndpoint, getSessionHostRecoveryLabel, getSessionHostSurfaceKind, getWorkspaceLabel, isDefaultInstanceConfigDir, isSessionHostLiveRuntime, isSessionHostRecoverySnapshot, partitionSessionHostDiagnosticsSessions, partitionSessionHostRecords, resolveAttachableRuntimeRecord, resolveInstanceConfigDir, resolveRuntimeRecord, resolveSessionHostIpcKey, sanitizeSpawnEnv, writeEnvelope };

package/dist/index.d.ts

@@ -495,7 +495,17 @@ interface SessionHostEndpoint {
     kind: 'unix' | 'pipe';
     path: string;
 }
-declare function getDefaultSessionHostEndpoint(appName?: string): SessionHostEndpoint;
+interface SessionHostEndpointOptions {
+    /**
+     * Instance IPC namespace key (see instance-key.ts). '' / omitted yields the
+     * legacy default-instance endpoint; a non-empty key suffixes the endpoint so
+     * each config-dir instance gets its own socket/pipe.
+     */
+    ipcKey?: string;
+    /** Test seam: override the platform the endpoint shape is derived for. */
+    platform?: NodeJS.Platform;
+}
+declare function getDefaultSessionHostEndpoint(appName?: string, options?: SessionHostEndpointOptions): SessionHostEndpoint;
 declare function createLineParser(onEnvelope: (envelope: SessionHostWireEnvelope) => void): (chunk: Buffer | string) => void;
 interface SessionHostClientOptions {
     endpoint?: SessionHostEndpoint;
@@ -515,6 +525,53 @@ declare class SessionHostClient {
 declare function createResponseEnvelope(requestId: string, response: SessionHostResponse): SessionHostResponseEnvelope;
 declare function writeEnvelope(socket: Pick<net.Socket, 'write'>, envelope: SessionHostWireEnvelope): void;
 
+/**
+ * Instance identity derivation for the session-host IPC namespace.
+ *
+ * One machine can host several ADHDev installs (stable `~/.adhdev`, preview
+ * `~/.adhdev-preview`, standalone `~/.adhdev-standalone`, or any explicit
+ * ADHDEV_CONFIG_DIR). Each install is an *instance*: it owns its config dir
+ * and everything mutable under it. The session-host socket/pipe must be
+ * namespaced by that identity so two simultaneous instances can never attach
+ * to, kill, or rebind each other's session host.
+ *
+ * This module is the single derivation rule, shared by:
+ * - the parent daemons (via @adhdev/daemon-core's InstanceContext),
+ * - the session-host-daemon child process (which only sees env vars),
+ * - CLI attach/list clients.
+ *
+ * All three compute the endpoint from the same inputs (appName +
+ * ADHDEV_CONFIG_DIR), so they always agree without extra plumbing.
+ *
+ * Compatibility contract: the DEFAULT instance (config dir canonicalizes to
+ * `<home>/.adhdev`) yields an EMPTY ipc key, so its socket/pipe path stays
+ * byte-for-byte identical to the pre-instance layout.
+ */
+declare const DEFAULT_CONFIG_DIR_NAME = ".adhdev";
+/**
+ * Resolve the instance config dir from the environment: ADHDEV_CONFIG_DIR
+ * when set (trimmed), else `<homeDir>/.adhdev`. Mirrors daemon-core's
+ * getConfigDir() source rule without the mkdir side effect.
+ */
+declare function resolveInstanceConfigDir(env?: NodeJS.ProcessEnv, homeDir?: string): string;
+/**
+ * Canonical form of an instance path for identity comparison/hashing:
+ * absolute, symlink-resolved (longest existing prefix), no trailing
+ * separator, case-folded on win32.
+ */
+declare function canonicalizeInstancePath(dir: string, platform?: NodeJS.Platform): string;
+/** True when `configDir` is canonically the default `<homeDir>/.adhdev`. */
+declare function isDefaultInstanceConfigDir(configDir: string, homeDir?: string, platform?: NodeJS.Platform): boolean;
+/**
+ * Derive the session-host IPC namespace key for an instance config dir.
+ *
+ * '' for the default instance (legacy-compatible endpoint), otherwise a
+ * 12-hex-char sha256 prefix of the canonical config dir — stable across
+ * processes/machines for the same dir, collision-resistant between dirs,
+ * and insensitive to symlink/spelling differences of the same dir.
+ */
+declare function resolveSessionHostIpcKey(configDir: string, homeDir?: string, platform?: NodeJS.Platform): string;
+
 /**
  * Shared PTY spawn environment utilities.
  *
@@ -588,4 +645,4 @@ interface SessionHostControlTransport {
  */
 declare function createSessionHostControlPlane(transport: SessionHostControlTransport): SessionHostControlPlane;
 
-export { type AcquireWritePayload, type AttachSessionPayload, type ClearSessionBufferPayload, type CreateSessionPayload, DEFAULT_SESSION_RING_BUFFER_MAX_BYTES, type DetachSessionPayload, type ForceDetachClientPayload, type GetHostDiagnosticsPayload, type GetSnapshotPayload, type GetTerminalSnapshotPayload, type PruneDuplicateSessionsPayload, type ReleaseWritePayload, type ResizeSessionPayload, type RestartSessionPayload, type ResumeSessionPayload, SESSION_HOST_SUPPORTED_REQUEST_TYPES, type SendInputPayload, type SendSignalPayload, type SessionAttachedClient, type SessionBufferSnapshot, type SessionClientType, type SessionHostCategory, SessionHostClient, type SessionHostClientOptions, type SessionHostControlPlane, type SessionHostControlTransport, type SessionHostDiagnostics, type SessionHostDuplicateSessionGroup, type SessionHostEndpoint, type SessionHostEvent, type SessionHostEventEnvelope, type SessionHostLogEntry, type SessionHostPruneDuplicatesResult, type SessionHostRecord, SessionHostRegistry, type SessionHostRequest, type SessionHostRequestEnvelope, type SessionHostRequestTrace, type SessionHostRequestType, type SessionHostResponse, type SessionHostResponseEnvelope, type SessionHostRuntimeTransition, type SessionHostSurfaceKind, type SessionHostSurfaceRecordLike, type SessionHostWireEnvelope, type SessionLaunchCommand, type SessionLifecycle, type SessionOwnerType, SessionRingBuffer, type SessionRingBufferOptions, type SessionTerminalSnapshot, type SessionTerminalState, type SessionTermination, type SessionTransport, type SessionWriteOwner, type StopSessionPayload, type UpdateSessionMetaPayload, applyTerminalColorEnv, buildRuntimeDisplayName, buildRuntimeKey, classifyTermination, createLineParser, createResponseEnvelope, createSessionHostControlPlane, ensureNodePtySpawnHelperPermissions, formatRuntimeOwner, getDefaultSessionHostEndpoint, getSessionHostRecoveryLabel, getSessionHostSurfaceKind, getWorkspaceLabel, isSessionHostLiveRuntime, isSessionHostRecoverySnapshot, partitionSessionHostDiagnosticsSessions, partitionSessionHostRecords, resolveAttachableRuntimeRecord, resolveRuntimeRecord, sanitizeSpawnEnv, writeEnvelope };
+export { type AcquireWritePayload, type AttachSessionPayload, type ClearSessionBufferPayload, type CreateSessionPayload, DEFAULT_CONFIG_DIR_NAME, DEFAULT_SESSION_RING_BUFFER_MAX_BYTES, type DetachSessionPayload, type ForceDetachClientPayload, type GetHostDiagnosticsPayload, type GetSnapshotPayload, type GetTerminalSnapshotPayload, type PruneDuplicateSessionsPayload, type ReleaseWritePayload, type ResizeSessionPayload, type RestartSessionPayload, type ResumeSessionPayload, SESSION_HOST_SUPPORTED_REQUEST_TYPES, type SendInputPayload, type SendSignalPayload, type SessionAttachedClient, type SessionBufferSnapshot, type SessionClientType, type SessionHostCategory, SessionHostClient, type SessionHostClientOptions, type SessionHostControlPlane, type SessionHostControlTransport, type SessionHostDiagnostics, type SessionHostDuplicateSessionGroup, type SessionHostEndpoint, type SessionHostEndpointOptions, type SessionHostEvent, type SessionHostEventEnvelope, type SessionHostLogEntry, type SessionHostPruneDuplicatesResult, type SessionHostRecord, SessionHostRegistry, type SessionHostRequest, type SessionHostRequestEnvelope, type SessionHostRequestTrace, type SessionHostRequestType, type SessionHostResponse, type SessionHostResponseEnvelope, type SessionHostRuntimeTransition, type SessionHostSurfaceKind, type SessionHostSurfaceRecordLike, type SessionHostWireEnvelope, type SessionLaunchCommand, type SessionLifecycle, type SessionOwnerType, SessionRingBuffer, type SessionRingBufferOptions, type SessionTerminalSnapshot, type SessionTerminalState, type SessionTermination, type SessionTransport, type SessionWriteOwner, type StopSessionPayload, type UpdateSessionMetaPayload, applyTerminalColorEnv, buildRuntimeDisplayName, buildRuntimeKey, canonicalizeInstancePath, classifyTermination, createLineParser, createResponseEnvelope, createSessionHostControlPlane, ensureNodePtySpawnHelperPermissions, formatRuntimeOwner, getDefaultSessionHostEndpoint, getSessionHostRecoveryLabel, getSessionHostSurfaceKind, getWorkspaceLabel, isDefaultInstanceConfigDir, isSessionHostLiveRuntime, isSessionHostRecoverySnapshot, partitionSessionHostDiagnosticsSessions, partitionSessionHostRecords, resolveAttachableRuntimeRecord, resolveInstanceConfigDir, resolveRuntimeRecord, resolveSessionHostIpcKey, sanitizeSpawnEnv, writeEnvelope };

package/dist/index.js

@@ -30,6 +30,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  DEFAULT_CONFIG_DIR_NAME: () => DEFAULT_CONFIG_DIR_NAME,
   DEFAULT_SESSION_HOST_COLS: () => DEFAULT_SESSION_HOST_COLS,
   DEFAULT_SESSION_HOST_ROWS: () => DEFAULT_SESSION_HOST_ROWS,
   DEFAULT_SESSION_RING_BUFFER_MAX_BYTES: () => DEFAULT_SESSION_RING_BUFFER_MAX_BYTES,
@@ -40,6 +41,7 @@ __export(index_exports, {
   applyTerminalColorEnv: () => applyTerminalColorEnv,
   buildRuntimeDisplayName: () => buildRuntimeDisplayName,
   buildRuntimeKey: () => buildRuntimeKey,
+  canonicalizeInstancePath: () => canonicalizeInstancePath,
   classifyTermination: () => classifyTermination,
   createLineParser: () => createLineParser,
   createResponseEnvelope: () => createResponseEnvelope,
@@ -50,13 +52,16 @@ __export(index_exports, {
   getSessionHostRecoveryLabel: () => getSessionHostRecoveryLabel,
   getSessionHostSurfaceKind: () => getSessionHostSurfaceKind,
   getWorkspaceLabel: () => getWorkspaceLabel,
+  isDefaultInstanceConfigDir: () => isDefaultInstanceConfigDir,
   isSessionHostLiveRuntime: () => isSessionHostLiveRuntime,
   isSessionHostRecoverySnapshot: () => isSessionHostRecoverySnapshot,
   partitionSessionHostDiagnosticsSessions: () => partitionSessionHostDiagnosticsSessions,
   partitionSessionHostRecords: () => partitionSessionHostRecords,
   resolveAttachableRuntimeRecord: () => resolveAttachableRuntimeRecord,
+  resolveInstanceConfigDir: () => resolveInstanceConfigDir,
   resolveRuntimeRecord: () => resolveRuntimeRecord,
   resolveSessionHostCols: () => resolveSessionHostCols,
+  resolveSessionHostIpcKey: () => resolveSessionHostIpcKey,
   resolveSessionHostRows: () => resolveSessionHostRows,
   sanitizeSpawnEnv: () => sanitizeSpawnEnv,
   writeEnvelope: () => writeEnvelope
@@ -577,16 +582,22 @@ function generateUUID2() {
     return v.toString(16);
   });
 }
-function getDefaultSessionHostEndpoint(appName = "adhdev") {
-  if (process.platform === "win32") {
+function getDefaultSessionHostEndpoint(appName = "adhdev", options = {}) {
+  const rawKey = typeof options.ipcKey === "string" ? options.ipcKey.trim() : "";
+  if (rawKey && !/^[0-9a-f]{12}$/.test(rawKey)) {
+    throw new Error(`Invalid session-host ipcKey "${rawKey}" \u2014 expected '' or a 12-hex-char instance key`);
+  }
+  const suffix = rawKey ? `-${rawKey}` : "";
+  const platform2 = options.platform || process.platform;
+  if (platform2 === "win32") {
     return {
       kind: "pipe",
-      path: `\\\\.\\pipe\\${appName}-session-host`
+      path: `\\\\.\\pipe\\${appName}-session-host${suffix}`
     };
   }
   return {
     kind: "unix",
-    path: path2.join(os.tmpdir(), `${appName}-session-host.sock`)
+    path: path2.join(os.tmpdir(), `${appName}-session-host${suffix}.sock`)
   };
 }
 function serializeEnvelope(envelope) {
@@ -653,8 +664,8 @@ var SessionHostClient = class {
       } catch {
       }
     });
-    await new Promise((resolve2, reject) => {
-      socket.once("connect", () => resolve2());
+    await new Promise((resolve3, reject) => {
+      socket.once("connect", () => resolve3());
       socket.once("error", reject);
     });
   }
@@ -673,7 +684,7 @@ var SessionHostClient = class {
       requestId,
       request
     };
-    const response = await new Promise((resolve2, reject) => {
+    const response = await new Promise((resolve3, reject) => {
       const timeout = setTimeout(() => {
         this.requestWaiters.delete(requestId);
         reject(new Error(`Session host request timed out after 30s (${request.type})`));
@@ -681,7 +692,7 @@ var SessionHostClient = class {
       this.requestWaiters.set(requestId, {
         resolve: (value) => {
           clearTimeout(timeout);
-          resolve2(value);
+          resolve3(value);
         },
         reject: (error) => {
           clearTimeout(timeout);
@@ -700,12 +711,12 @@ var SessionHostClient = class {
       waiter.reject(new Error("Session host client closed"));
     }
     this.requestWaiters.clear();
-    await new Promise((resolve2) => {
+    await new Promise((resolve3) => {
       let settled = false;
       const done = () => {
         if (settled) return;
         settled = true;
-        resolve2();
+        resolve3();
       };
       socket.once("close", done);
       socket.end();
@@ -725,9 +736,49 @@ function writeEnvelope(socket, envelope) {
   socket.write(serializeEnvelope(envelope));
 }
 
-// src/spawn-env.ts
+// src/instance-key.ts
+var crypto2 = __toESM(require("crypto"));
+var fs = __toESM(require("fs"));
 var os2 = __toESM(require("os"));
 var path3 = __toESM(require("path"));
+var DEFAULT_CONFIG_DIR_NAME = ".adhdev";
+function resolveInstanceConfigDir(env = process.env, homeDir = os2.homedir()) {
+  const override = typeof env.ADHDEV_CONFIG_DIR === "string" ? env.ADHDEV_CONFIG_DIR.trim() : "";
+  return override || path3.join(homeDir, DEFAULT_CONFIG_DIR_NAME);
+}
+function realpathLongestExistingPrefix(resolved) {
+  let current = resolved;
+  const remainder = [];
+  for (let depth = 0; depth < 256; depth++) {
+    try {
+      const real = fs.realpathSync.native(current);
+      return remainder.length === 0 ? real : path3.join(real, ...remainder);
+    } catch {
+      const parent = path3.dirname(current);
+      if (parent === current) return resolved;
+      remainder.unshift(path3.basename(current));
+      current = parent;
+    }
+  }
+  return resolved;
+}
+function canonicalizeInstancePath(dir, platform2 = process.platform) {
+  const resolved = path3.resolve(dir);
+  const real = realpathLongestExistingPrefix(resolved).replace(/[\\/]+$/, "");
+  return platform2 === "win32" ? real.toLowerCase() : real;
+}
+function isDefaultInstanceConfigDir(configDir, homeDir = os2.homedir(), platform2 = process.platform) {
+  return canonicalizeInstancePath(configDir, platform2) === canonicalizeInstancePath(path3.join(homeDir, DEFAULT_CONFIG_DIR_NAME), platform2);
+}
+function resolveSessionHostIpcKey(configDir, homeDir = os2.homedir(), platform2 = process.platform) {
+  if (isDefaultInstanceConfigDir(configDir, homeDir, platform2)) return "";
+  const canonical = canonicalizeInstancePath(configDir, platform2);
+  return crypto2.createHash("sha256").update(canonical, "utf8").digest("hex").slice(0, 12);
+}
+
+// src/spawn-env.ts
+var os3 = __toESM(require("os"));
+var path4 = __toESM(require("path"));
 function sanitizeSpawnEnv(baseEnv, overrides) {
   const env = {};
   const source = { ...baseEnv, ...overrides || {} };
@@ -767,16 +818,16 @@ function applyTerminalColorEnv(env) {
   }
 }
 function ensureNodePtySpawnHelperPermissions(logFn) {
-  if (os2.platform() === "win32") return;
+  if (os3.platform() === "win32") return;
   try {
-    const fs = require("fs");
-    const ptyDir = path3.resolve(path3.dirname(require.resolve("node-pty")), "..");
-    const platformArch = `${os2.platform()}-${os2.arch()}`;
-    const helper = path3.join(ptyDir, "prebuilds", platformArch, "spawn-helper");
-    if (fs.existsSync(helper)) {
-      const stat = fs.statSync(helper);
+    const fs2 = require("fs");
+    const ptyDir = path4.resolve(path4.dirname(require.resolve("node-pty")), "..");
+    const platformArch = `${os3.platform()}-${os3.arch()}`;
+    const helper = path4.join(ptyDir, "prebuilds", platformArch, "spawn-helper");
+    if (fs2.existsSync(helper)) {
+      const stat = fs2.statSync(helper);
       if (!(stat.mode & 73)) {
-        fs.chmodSync(helper, stat.mode | 493);
+        fs2.chmodSync(helper, stat.mode | 493);
         logFn?.(`Fixed spawn-helper permissions: ${helper}`);
       }
     }
@@ -824,6 +875,7 @@ function createSessionHostControlPlane(transport) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  DEFAULT_CONFIG_DIR_NAME,
   DEFAULT_SESSION_HOST_COLS,
   DEFAULT_SESSION_HOST_ROWS,
   DEFAULT_SESSION_RING_BUFFER_MAX_BYTES,
@@ -834,6 +886,7 @@ function createSessionHostControlPlane(transport) {
   applyTerminalColorEnv,
   buildRuntimeDisplayName,
   buildRuntimeKey,
+  canonicalizeInstancePath,
   classifyTermination,
   createLineParser,
   createResponseEnvelope,
@@ -844,13 +897,16 @@ function createSessionHostControlPlane(transport) {
   getSessionHostRecoveryLabel,
   getSessionHostSurfaceKind,
   getWorkspaceLabel,
+  isDefaultInstanceConfigDir,
   isSessionHostLiveRuntime,
   isSessionHostRecoverySnapshot,
   partitionSessionHostDiagnosticsSessions,
   partitionSessionHostRecords,
   resolveAttachableRuntimeRecord,
+  resolveInstanceConfigDir,
   resolveRuntimeRecord,
   resolveSessionHostCols,
+  resolveSessionHostIpcKey,
   resolveSessionHostRows,
   sanitizeSpawnEnv,
   writeEnvelope