@telora/daemon-core 0.2.5

package/dist/spawn.js

@@ -0,0 +1,82 @@
+/**
+ * Shared Claude Code process spawning utilities.
+ *
+ * Provides common building blocks for spawning Claude Code CLI processes:
+ * - CLI argument construction for stream-json mode
+ * - Environment variable stripping (remove inherited Claude Code session vars)
+ * - Log file creation with restrictive permissions
+ *
+ * Both the Telora daemon and factory engines use these primitives,
+ * appending their own engine-specific options on top.
+ */
+import { createWriteStream } from 'node:fs';
+import { resolve } from 'node:path';
+// ── CLI Argument Builder ──────────────────────────────────────────────────────
+/**
+ * Build the common Claude Code CLI arguments for stream-json I/O.
+ *
+ * Returns the base set of flags shared across all engines:
+ * - `--dangerously-skip-permissions`
+ * - `--input-format stream-json`
+ * - `--output-format stream-json`
+ * - `--verbose`
+ * - `--mcp-config <absolute-path>` (when mcpConfigPath is provided)
+ *
+ * Callers append engine-specific flags (e.g. `--teammate-mode`, `--setting-sources`).
+ */
+export function buildStreamJsonArgs(options = {}) {
+    const args = [
+        '--dangerously-skip-permissions',
+        '--input-format', 'stream-json',
+        '--output-format', 'stream-json',
+        '--verbose',
+    ];
+    if (options.mcpConfigPath) {
+        const absoluteMcpPath = resolve(options.mcpConfigPath);
+        args.push('--mcp-config', absoluteMcpPath);
+    }
+    return args;
+}
+// ── Environment Variable Stripping ────────────────────────────────────────────
+/**
+ * Strip inherited Claude Code session variables from an environment object.
+ *
+ * When a Claude Code process is spawned from within another Claude Code session,
+ * inherited env vars (CLAUDECODE, CLAUDE_CODE_*, CLAUDECODE_*) cause the child
+ * to detect a parent session and hang indefinitely. This function removes those
+ * markers while allowing specific keys to be preserved.
+ *
+ * Patterns stripped:
+ * - `CLAUDECODE` (exact match)
+ * - `CLAUDE_CODE_*` (prefix match)
+ * - `CLAUDECODE_*` (prefix match -- used by some versions)
+ *
+ * @param env - The environment object to clean (not mutated; a copy is returned).
+ * @param options - Optional settings (e.g. keys to preserve).
+ * @returns A new environment object with matching keys removed.
+ */
+export function stripClaudeCodeEnvVars(env, options = {}) {
+    const result = { ...env };
+    const preserveSet = new Set(options.preserve ?? []);
+    for (const key of Object.keys(result)) {
+        if (preserveSet.has(key))
+            continue;
+        if (key === 'CLAUDECODE' ||
+            key.startsWith('CLAUDE_CODE_') ||
+            key.startsWith('CLAUDECODE_')) {
+            delete result[key];
+        }
+    }
+    return result;
+}
+// ── Log File Creation ─────────────────────────────────────────────────────────
+/**
+ * Create a writable log stream with restrictive permissions (owner-only read/write).
+ *
+ * Used for stdout/stderr/jsonl log files for spawned agent processes.
+ * The file is created with mode 0o600 (rw-------).
+ */
+export function createLogStream(path) {
+    return createWriteStream(path, { mode: 0o600 });
+}
+//# sourceMappingURL=spawn.js.map

package/dist/spawn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.js","sourceRoot":"","sources":["../src/spawn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,iBAAiB,EAAoB,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA2BpC,iFAAiF;AAEjF;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAiC,EAAE;IACrE,MAAM,IAAI,GAAa;QACrB,gCAAgC;QAChC,gBAAgB,EAAE,aAAa;QAC/B,iBAAiB,EAAE,aAAa;QAChC,WAAW;KACZ,CAAC;IAEF,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;QAC1B,MAAM,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QACvD,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,iFAAiF;AAEjF;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,sBAAsB,CACpC,GAAuC,EACvC,UAA2B,EAAE;IAE7B,MAAM,MAAM,GAAuC,EAAE,GAAG,GAAG,EAAE,CAAC;IAC9D,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IAEpD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,IAAI,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAEnC,IACE,GAAG,KAAK,YAAY;YACpB,GAAG,CAAC,UAAU,CAAC,cAAc,CAAC;YAC9B,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,EAC7B,CAAC;YACD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,iFAAiF;AAEjF;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,iBAAiB,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AAClD,CAAC"}