@adhdev/session-host-core 1.0.82-rc.22 → 1.0.82-rc.24

package/dist/index.d.mts

@@ -1,3 +1,5 @@
+import * as os from 'node:os';
+import { SpawnOptions, ChildProcess } from 'node:child_process';
 import * as net from 'net';
 export { DEFAULT_SESSION_HOST_COLS, DEFAULT_SESSION_HOST_ROWS, resolveSessionHostCols, resolveSessionHostRows } from './defaults.mjs';
 
@@ -10,6 +12,8 @@ interface SessionLaunchCommand {
     command: string;
     args: string[];
     env?: Record<string, string>;
+    /** Unmarked older daemon records contained the full inherited environment. */
+    envMode?: 'launch_overrides';
 }
 interface SessionWriteOwner {
     clientId: string;
@@ -449,6 +453,43 @@ interface ClassifyTerminationInput {
  */
 declare function classifyTermination(input: ClassifyTerminationInput): SessionTermination;
 
+/** Relative POSIX niceness adjustment for newly spawned agent workloads. */
+declare const CLI_CHILD_NICE_INCREMENT = 10;
+/** Set to "0" in the daemon environment (or launch env) to disable lowering. */
+declare const CLI_CHILD_NICE_ENV = "ADHDEV_CLI_CHILD_NICE";
+/** Optional Darwin CPU + I/O background policy, in addition to baseline nice. */
+declare const CLI_CHILD_SCHEDULING_ENV = "ADHDEV_CLI_CHILD_SCHEDULING";
+declare function setDarwinBackground(pid: number, onFailure: (error: unknown) => void): void;
+interface PriorityDependencies {
+    platform: NodeJS.Platform;
+    getPriority: typeof os.getPriority;
+    setPriority: typeof os.setPriority;
+    setDarwinBackground?: typeof setDarwinBackground;
+}
+/** Separate policy instances are useful for platform/error tests. */
+declare function createCliChildPriorityPolicy(deps?: PriorityDependencies): <T extends {
+    readonly pid?: number;
+}>(spawnChild: () => T, env?: NodeJS.ProcessEnv, logInfo?: (message: string) => void) => T;
+/**
+ * Only wrap agent workload spawns. Keep daemon, session-host IPC, P2P signal
+ * workers, version probes and git helpers at their existing priority.
+ *
+ * node-pty has no pre-spawn priority hook. Apply immediately on return, before
+ * registering listeners/doing other work. There is a spawn-to-setPriority race:
+ * a child can run (and fork) before this call. Later descendants inherit nice
+ * on POSIX; early descendants are not retroactively changed. Windows creation
+ * and ConPTY inheritance require verification on the MainPC.
+ * Optional darwin-bg is applied asynchronously by taskpolicy after nice; the
+ * extra helper startup adds a further race before the background class takes
+ * effect. It also throttles I/O, so nice alone remains the default.
+ */
+declare const spawnCliChild: <T extends {
+    readonly pid?: number;
+}>(spawnChild: () => T, env?: NodeJS.ProcessEnv, logInfo?: (message: string) => void) => T;
+
+/** Shared hidden-window primitive for daemon and session-host process helpers. */
+declare function hiddenSpawn(command: string, args?: readonly string[], options?: SpawnOptions): ChildProcess;
+
 interface SessionRingBufferOptions {
     maxBytes?: number;
 }
@@ -749,6 +790,12 @@ declare function resolveSessionHostIpcKey(configDir: string, homeDir?: string, p
  * with child CLI processes and apply terminal colour defaults.
  */
 declare function sanitizeSpawnEnv(baseEnv: NodeJS.ProcessEnv, overrides?: Record<string, string>): Record<string, string>;
+/** Recover only role bindings from legacy full-environment snapshots.
+ * New records distinguish explicit overrides, including intentional custom keys. */
+declare function replayLaunchEnv(command: {
+    env?: Record<string, string>;
+    envMode?: 'launch_overrides';
+}): Record<string, string>;
 /**
  * Apply preferred terminal colour environment variables.
  * Ensures TERM is set to xterm-256color and enables colour on Windows.
@@ -824,4 +871,4 @@ interface SessionHostControlTransport {
  */
 declare function createSessionHostControlPlane(transport: SessionHostControlTransport): SessionHostControlPlane;
 
-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 HostUpgradeLeasePayload, 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 SessionHostDisconnectInfo, type SessionHostDisconnectReason, 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 SessionHostSnapshot, 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, isTerminalRecord, partitionSessionHostDiagnosticsSessions, partitionSessionHostRecords, resolveAttachableRuntimeRecord, resolveInstanceConfigDir, resolveRuntimeRecord, resolveSessionHostIpcKey, sanitizeSpawnEnv, writeEnvelope };
+export { type AcquireWritePayload, type AttachSessionPayload, CLI_CHILD_NICE_ENV, CLI_CHILD_NICE_INCREMENT, CLI_CHILD_SCHEDULING_ENV, 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 HostUpgradeLeasePayload, 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 SessionHostDisconnectInfo, type SessionHostDisconnectReason, 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 SessionHostSnapshot, 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, createCliChildPriorityPolicy, createLineParser, createResponseEnvelope, createSessionHostControlPlane, ensureNodePtySpawnHelperPermissions, formatRuntimeOwner, getDefaultSessionHostEndpoint, getSessionHostRecoveryLabel, getSessionHostSurfaceKind, getWorkspaceLabel, hiddenSpawn as hiddenSpawnProcess, isDefaultInstanceConfigDir, isSessionHostLiveRuntime, isSessionHostRecoverySnapshot, isTerminalRecord, partitionSessionHostDiagnosticsSessions, partitionSessionHostRecords, replayLaunchEnv, resolveAttachableRuntimeRecord, resolveInstanceConfigDir, resolveRuntimeRecord, resolveSessionHostIpcKey, sanitizeSpawnEnv, spawnCliChild, writeEnvelope };

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+import * as os from 'node:os';
+import { SpawnOptions, ChildProcess } from 'node:child_process';
 import * as net from 'net';
 export { DEFAULT_SESSION_HOST_COLS, DEFAULT_SESSION_HOST_ROWS, resolveSessionHostCols, resolveSessionHostRows } from './defaults.js';
 
@@ -10,6 +12,8 @@ interface SessionLaunchCommand {
     command: string;
     args: string[];
     env?: Record<string, string>;
+    /** Unmarked older daemon records contained the full inherited environment. */
+    envMode?: 'launch_overrides';
 }
 interface SessionWriteOwner {
     clientId: string;
@@ -449,6 +453,43 @@ interface ClassifyTerminationInput {
  */
 declare function classifyTermination(input: ClassifyTerminationInput): SessionTermination;
 
+/** Relative POSIX niceness adjustment for newly spawned agent workloads. */
+declare const CLI_CHILD_NICE_INCREMENT = 10;
+/** Set to "0" in the daemon environment (or launch env) to disable lowering. */
+declare const CLI_CHILD_NICE_ENV = "ADHDEV_CLI_CHILD_NICE";
+/** Optional Darwin CPU + I/O background policy, in addition to baseline nice. */
+declare const CLI_CHILD_SCHEDULING_ENV = "ADHDEV_CLI_CHILD_SCHEDULING";
+declare function setDarwinBackground(pid: number, onFailure: (error: unknown) => void): void;
+interface PriorityDependencies {
+    platform: NodeJS.Platform;
+    getPriority: typeof os.getPriority;
+    setPriority: typeof os.setPriority;
+    setDarwinBackground?: typeof setDarwinBackground;
+}
+/** Separate policy instances are useful for platform/error tests. */
+declare function createCliChildPriorityPolicy(deps?: PriorityDependencies): <T extends {
+    readonly pid?: number;
+}>(spawnChild: () => T, env?: NodeJS.ProcessEnv, logInfo?: (message: string) => void) => T;
+/**
+ * Only wrap agent workload spawns. Keep daemon, session-host IPC, P2P signal
+ * workers, version probes and git helpers at their existing priority.
+ *
+ * node-pty has no pre-spawn priority hook. Apply immediately on return, before
+ * registering listeners/doing other work. There is a spawn-to-setPriority race:
+ * a child can run (and fork) before this call. Later descendants inherit nice
+ * on POSIX; early descendants are not retroactively changed. Windows creation
+ * and ConPTY inheritance require verification on the MainPC.
+ * Optional darwin-bg is applied asynchronously by taskpolicy after nice; the
+ * extra helper startup adds a further race before the background class takes
+ * effect. It also throttles I/O, so nice alone remains the default.
+ */
+declare const spawnCliChild: <T extends {
+    readonly pid?: number;
+}>(spawnChild: () => T, env?: NodeJS.ProcessEnv, logInfo?: (message: string) => void) => T;
+
+/** Shared hidden-window primitive for daemon and session-host process helpers. */
+declare function hiddenSpawn(command: string, args?: readonly string[], options?: SpawnOptions): ChildProcess;
+
 interface SessionRingBufferOptions {
     maxBytes?: number;
 }
@@ -749,6 +790,12 @@ declare function resolveSessionHostIpcKey(configDir: string, homeDir?: string, p
  * with child CLI processes and apply terminal colour defaults.
  */
 declare function sanitizeSpawnEnv(baseEnv: NodeJS.ProcessEnv, overrides?: Record<string, string>): Record<string, string>;
+/** Recover only role bindings from legacy full-environment snapshots.
+ * New records distinguish explicit overrides, including intentional custom keys. */
+declare function replayLaunchEnv(command: {
+    env?: Record<string, string>;
+    envMode?: 'launch_overrides';
+}): Record<string, string>;
 /**
  * Apply preferred terminal colour environment variables.
  * Ensures TERM is set to xterm-256color and enables colour on Windows.
@@ -824,4 +871,4 @@ interface SessionHostControlTransport {
  */
 declare function createSessionHostControlPlane(transport: SessionHostControlTransport): SessionHostControlPlane;
 
-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 HostUpgradeLeasePayload, 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 SessionHostDisconnectInfo, type SessionHostDisconnectReason, 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 SessionHostSnapshot, 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, isTerminalRecord, partitionSessionHostDiagnosticsSessions, partitionSessionHostRecords, resolveAttachableRuntimeRecord, resolveInstanceConfigDir, resolveRuntimeRecord, resolveSessionHostIpcKey, sanitizeSpawnEnv, writeEnvelope };
+export { type AcquireWritePayload, type AttachSessionPayload, CLI_CHILD_NICE_ENV, CLI_CHILD_NICE_INCREMENT, CLI_CHILD_SCHEDULING_ENV, 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 HostUpgradeLeasePayload, 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 SessionHostDisconnectInfo, type SessionHostDisconnectReason, 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 SessionHostSnapshot, 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, createCliChildPriorityPolicy, createLineParser, createResponseEnvelope, createSessionHostControlPlane, ensureNodePtySpawnHelperPermissions, formatRuntimeOwner, getDefaultSessionHostEndpoint, getSessionHostRecoveryLabel, getSessionHostSurfaceKind, getWorkspaceLabel, hiddenSpawn as hiddenSpawnProcess, isDefaultInstanceConfigDir, isSessionHostLiveRuntime, isSessionHostRecoverySnapshot, isTerminalRecord, partitionSessionHostDiagnosticsSessions, partitionSessionHostRecords, replayLaunchEnv, resolveAttachableRuntimeRecord, resolveInstanceConfigDir, resolveRuntimeRecord, resolveSessionHostIpcKey, sanitizeSpawnEnv, spawnCliChild, writeEnvelope };

package/dist/index.js

@@ -30,6 +30,9 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  CLI_CHILD_NICE_ENV: () => CLI_CHILD_NICE_ENV,
+  CLI_CHILD_NICE_INCREMENT: () => CLI_CHILD_NICE_INCREMENT,
+  CLI_CHILD_SCHEDULING_ENV: () => CLI_CHILD_SCHEDULING_ENV,
   DEFAULT_CONFIG_DIR_NAME: () => DEFAULT_CONFIG_DIR_NAME,
   DEFAULT_SESSION_HOST_COLS: () => DEFAULT_SESSION_HOST_COLS,
   DEFAULT_SESSION_HOST_ROWS: () => DEFAULT_SESSION_HOST_ROWS,
@@ -43,6 +46,7 @@ __export(index_exports, {
   buildRuntimeKey: () => buildRuntimeKey,
   canonicalizeInstancePath: () => canonicalizeInstancePath,
   classifyTermination: () => classifyTermination,
+  createCliChildPriorityPolicy: () => createCliChildPriorityPolicy,
   createLineParser: () => createLineParser,
   createResponseEnvelope: () => createResponseEnvelope,
   createSessionHostControlPlane: () => createSessionHostControlPlane,
@@ -52,12 +56,14 @@ __export(index_exports, {
   getSessionHostRecoveryLabel: () => getSessionHostRecoveryLabel,
   getSessionHostSurfaceKind: () => getSessionHostSurfaceKind,
   getWorkspaceLabel: () => getWorkspaceLabel,
+  hiddenSpawnProcess: () => hiddenSpawn,
   isDefaultInstanceConfigDir: () => isDefaultInstanceConfigDir,
   isSessionHostLiveRuntime: () => isSessionHostLiveRuntime,
   isSessionHostRecoverySnapshot: () => isSessionHostRecoverySnapshot,
   isTerminalRecord: () => isTerminalRecord,
   partitionSessionHostDiagnosticsSessions: () => partitionSessionHostDiagnosticsSessions,
   partitionSessionHostRecords: () => partitionSessionHostRecords,
+  replayLaunchEnv: () => replayLaunchEnv,
   resolveAttachableRuntimeRecord: () => resolveAttachableRuntimeRecord,
   resolveInstanceConfigDir: () => resolveInstanceConfigDir,
   resolveRuntimeRecord: () => resolveRuntimeRecord,
@@ -65,6 +71,7 @@ __export(index_exports, {
   resolveSessionHostIpcKey: () => resolveSessionHostIpcKey,
   resolveSessionHostRows: () => resolveSessionHostRows,
   sanitizeSpawnEnv: () => sanitizeSpawnEnv,
+  spawnCliChild: () => spawnCliChild,
   writeEnvelope: () => writeEnvelope
 });
 module.exports = __toCommonJS(index_exports);
@@ -129,6 +136,62 @@ function classifyTermination(input) {
   return termination;
 }
 
+// src/cli-child-priority.ts
+var os = __toESM(require("os"));
+
+// src/process/hidden-spawn.ts
+var import_node_child_process = require("child_process");
+function hiddenSpawn(command, args = [], options = {}) {
+  return (0, import_node_child_process.spawn)(command, args, { windowsHide: true, ...options });
+}
+
+// src/cli-child-priority.ts
+var CLI_CHILD_NICE_INCREMENT = 10;
+var CLI_CHILD_NICE_ENV = "ADHDEV_CLI_CHILD_NICE";
+var CLI_CHILD_SCHEDULING_ENV = "ADHDEV_CLI_CHILD_SCHEDULING";
+function setDarwinBackground(pid, onFailure) {
+  const task = hiddenSpawn("/usr/sbin/taskpolicy", ["-b", "-p", String(pid)], { stdio: "ignore" });
+  task.once("error", onFailure);
+  task.once("exit", (code, signal) => {
+    if (code !== 0) onFailure(new Error(`taskpolicy exited with ${signal ?? code}`));
+  });
+}
+function createCliChildPriorityPolicy(deps = {
+  platform: process.platform,
+  getPriority: os.getPriority,
+  setPriority: os.setPriority,
+  setDarwinBackground
+}) {
+  let failureLogged = false;
+  return function spawnCliChild2(spawnChild, env = process.env, logInfo = console.info) {
+    const child = spawnChild();
+    const pid = child.pid;
+    if (env[CLI_CHILD_NICE_ENV] === "0" || typeof pid !== "number" || !Number.isInteger(pid) || pid <= 0) return child;
+    const onFailure = (error) => {
+      if (!failureLogged) {
+        failureLogged = true;
+        const detail = error instanceof Error ? error.message : String(error);
+        logInfo(`[cli-child-priority] Could not apply CLI child scheduling (pid ${pid}); continuing: ${detail}`);
+      }
+    };
+    try {
+      const priority = deps.platform === "win32" ? os.constants.priority.PRIORITY_BELOW_NORMAL : Math.min(19, deps.getPriority(pid) + CLI_CHILD_NICE_INCREMENT);
+      deps.setPriority(pid, priority);
+    } catch (error) {
+      onFailure(error);
+    }
+    if (deps.platform === "darwin" && env[CLI_CHILD_SCHEDULING_ENV] === "darwin-bg") {
+      try {
+        deps.setDarwinBackground?.(pid, onFailure);
+      } catch (error) {
+        onFailure(error);
+      }
+    }
+    return child;
+  };
+}
+var spawnCliChild = createCliChildPriorityPolicy();
+
 // src/buffer.ts
 var DEFAULT_SESSION_RING_BUFFER_MAX_BYTES = 4 * 1024 * 1024;
 var SessionRingBuffer = class {
@@ -692,7 +755,7 @@ function cloneMeta(meta) {
 }
 
 // src/ipc.ts
-var os = __toESM(require("os"));
+var os2 = __toESM(require("os"));
 var path2 = __toESM(require("path"));
 var net = __toESM(require("net"));
 var import_string_decoder = require("string_decoder");
@@ -711,7 +774,7 @@ function getDefaultSessionHostEndpoint(appName = "adhdev", options = {}) {
   }
   return {
     kind: "unix",
-    path: path2.join(os.tmpdir(), `${appName}-session-host${suffix}.sock`)
+    path: path2.join(os2.tmpdir(), `${appName}-session-host${suffix}.sock`)
   };
 }
 function serializeEnvelope(envelope) {
@@ -933,10 +996,10 @@ function writeEnvelope(socket, envelope) {
 // src/instance-key.ts
 var crypto2 = __toESM(require("crypto"));
 var fs = __toESM(require("fs"));
-var os2 = __toESM(require("os"));
+var os3 = __toESM(require("os"));
 var path3 = __toESM(require("path"));
 var DEFAULT_CONFIG_DIR_NAME = ".adhdev";
-function resolveInstanceConfigDir(env = process.env, homeDir = os2.homedir()) {
+function resolveInstanceConfigDir(env = process.env, homeDir = os3.homedir()) {
   const override = typeof env.ADHDEV_CONFIG_DIR === "string" ? env.ADHDEV_CONFIG_DIR.trim() : "";
   return override || path3.join(homeDir, DEFAULT_CONFIG_DIR_NAME);
 }
@@ -961,17 +1024,17 @@ function canonicalizeInstancePath(dir, platform2 = process.platform) {
   const real = realpathLongestExistingPrefix(resolved).replace(/[\\/]+$/, "");
   return platform2 === "win32" ? real.toLowerCase() : real;
 }
-function isDefaultInstanceConfigDir(configDir, homeDir = os2.homedir(), platform2 = process.platform) {
+function isDefaultInstanceConfigDir(configDir, homeDir = os3.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) {
+function resolveSessionHostIpcKey(configDir, homeDir = os3.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 os4 = __toESM(require("os"));
 var path4 = __toESM(require("path"));
 function sanitizeSpawnEnv(baseEnv, overrides) {
   const env = {};
@@ -1001,6 +1064,27 @@ function sanitizeSpawnEnv(baseEnv, overrides) {
   applyTerminalColorEnv(env);
   return env;
 }
+function replayLaunchEnv(command) {
+  if (command.envMode === "launch_overrides") return { ...command.env };
+  const roleKeys = /* @__PURE__ */ new Set([
+    "HOME",
+    "USERPROFILE",
+    "XDG_CONFIG_HOME",
+    "CLAUDE_CONFIG_DIR",
+    "CODEX_HOME",
+    "KIMI_CODE_HOME",
+    "GEMINI_CLI_HOME",
+    "OPENCODE_CONFIG",
+    "OPENCODE_CONFIG_CONTENT",
+    "CLAUDE_CODE_DISABLE_AUTO_MEMORY",
+    "TERMINAL_CWD",
+    "ADHDEV_INLINE_MESH",
+    "ADHDEV_ASSISTANT_SESSION_ID",
+    "ADHDEV_COORDINATOR_SESSION_ID",
+    "ADHDEV_CONFIG_DIR"
+  ]);
+  return Object.fromEntries(Object.entries(command.env ?? {}).filter(([key]) => roleKeys.has(key)));
+}
 function applyTerminalColorEnv(env) {
   if (env.NO_COLOR) return;
   if (!env.TERM || env.TERM === "xterm-color") {
@@ -1013,11 +1097,11 @@ function applyTerminalColorEnv(env) {
   }
 }
 function ensureNodePtySpawnHelperPermissions(logFn) {
-  if (os3.platform() === "win32") return;
+  if (os4.platform() === "win32") return;
   try {
     const fs2 = require("fs");
     const ptyDir = path4.resolve(path4.dirname(require.resolve("node-pty")), "..");
-    const platformArch = `${os3.platform()}-${os3.arch()}`;
+    const platformArch = `${os4.platform()}-${os4.arch()}`;
     const helper = path4.join(ptyDir, "prebuilds", platformArch, "spawn-helper");
     if (fs2.existsSync(helper)) {
       const stat = fs2.statSync(helper);
@@ -1073,6 +1157,9 @@ function createSessionHostControlPlane(transport) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  CLI_CHILD_NICE_ENV,
+  CLI_CHILD_NICE_INCREMENT,
+  CLI_CHILD_SCHEDULING_ENV,
   DEFAULT_CONFIG_DIR_NAME,
   DEFAULT_SESSION_HOST_COLS,
   DEFAULT_SESSION_HOST_ROWS,
@@ -1086,6 +1173,7 @@ function createSessionHostControlPlane(transport) {
   buildRuntimeKey,
   canonicalizeInstancePath,
   classifyTermination,
+  createCliChildPriorityPolicy,
   createLineParser,
   createResponseEnvelope,
   createSessionHostControlPlane,
@@ -1095,12 +1183,14 @@ function createSessionHostControlPlane(transport) {
   getSessionHostRecoveryLabel,
   getSessionHostSurfaceKind,
   getWorkspaceLabel,
+  hiddenSpawnProcess,
   isDefaultInstanceConfigDir,
   isSessionHostLiveRuntime,
   isSessionHostRecoverySnapshot,
   isTerminalRecord,
   partitionSessionHostDiagnosticsSessions,
   partitionSessionHostRecords,
+  replayLaunchEnv,
   resolveAttachableRuntimeRecord,
   resolveInstanceConfigDir,
   resolveRuntimeRecord,
@@ -1108,6 +1198,7 @@ function createSessionHostControlPlane(transport) {
   resolveSessionHostIpcKey,
   resolveSessionHostRows,
   sanitizeSpawnEnv,
+  spawnCliChild,
   writeEnvelope
 });
 //# sourceMappingURL=index.js.map