pty-manager 1.9.0 → 1.9.1

package/dist/index.d.mts

@@ -52,6 +52,17 @@ interface SpawnConfig {
      *  are emitted as autoResponded=false instead of being auto-responded.
      *  Auto-response rules (ruleOverrides) are unaffected. */
     skipAdapterAutoResponse?: boolean;
+    /**
+     * Whether to inherit the parent process environment variables.
+     * When `true` (default), `process.env` is spread as the base of the spawned
+     * process environment. When `false`, only `adapter.getEnv()` output and
+     * `config.env` are used — the caller is responsible for providing any
+     * necessary system vars (PATH, HOME, etc.) via `config.env`.
+     *
+     * Set to `false` for security-sensitive contexts where the host process has
+     * secrets that spawned agents should not access.
+     */
+    inheritProcessEnv?: boolean;
 }
 /**
  * Handle to a running session
@@ -693,6 +704,12 @@ declare class PTYSession extends EventEmitter {
      * @param keys - Key name(s) to send, e.g. "ctrl+c" or ["up", "up", "enter"]
      */
     sendKeys(keys: string | string[]): void;
+    /**
+     * Build the environment object for spawning a PTY process.
+     * Merges base env (process.env unless opted out), adapter env, and config env,
+     * with TERM/COLORTERM always forced.
+     */
+    static buildSpawnEnv(config: SpawnConfig, adapterEnv: Record<string, string>): Record<string, string>;
     /**
      * Normalize a list of key names for SPECIAL_KEYS lookup.
      *

package/dist/index.d.ts

@@ -52,6 +52,17 @@ interface SpawnConfig {
      *  are emitted as autoResponded=false instead of being auto-responded.
      *  Auto-response rules (ruleOverrides) are unaffected. */
     skipAdapterAutoResponse?: boolean;
+    /**
+     * Whether to inherit the parent process environment variables.
+     * When `true` (default), `process.env` is spread as the base of the spawned
+     * process environment. When `false`, only `adapter.getEnv()` output and
+     * `config.env` are used — the caller is responsible for providing any
+     * necessary system vars (PATH, HOME, etc.) via `config.env`.
+     *
+     * Set to `false` for security-sensitive contexts where the host process has
+     * secrets that spawned agents should not access.
+     */
+    inheritProcessEnv?: boolean;
 }
 /**
  * Handle to a running session
@@ -693,6 +704,12 @@ declare class PTYSession extends EventEmitter {
      * @param keys - Key name(s) to send, e.g. "ctrl+c" or ["up", "up", "enter"]
      */
     sendKeys(keys: string | string[]): void;
+    /**
+     * Build the environment object for spawning a PTY process.
+     * Merges base env (process.env unless opted out), adapter env, and config env,
+     * with TERM/COLORTERM always forced.
+     */
+    static buildSpawnEnv(config: SpawnConfig, adapterEnv: Record<string, string>): Record<string, string>;
     /**
      * Normalize a list of key names for SPECIAL_KEYS lookup.
      *

package/dist/index.js

@@ -900,14 +900,7 @@ var PTYSession = class _PTYSession extends import_events.EventEmitter {
     const command = this.adapter.getCommand();
     const args = this.adapter.getArgs(this.config);
     const adapterEnv = this.adapter.getEnv(this.config);
-    const env = {
-      ...process.env,
-      ...adapterEnv,
-      ...this.config.env,
-      // Force terminal settings
-      TERM: "xterm-256color",
-      COLORTERM: "truecolor"
-    };
+    const env = _PTYSession.buildSpawnEnv(this.config, adapterEnv);
     this.logger.info(
       { sessionId: this.id, command, args: args.join(" ") },
       "Starting PTY session"
@@ -1289,6 +1282,21 @@ var PTYSession = class _PTYSession extends import_events.EventEmitter {
       }
     }
   }
+  /**
+   * Build the environment object for spawning a PTY process.
+   * Merges base env (process.env unless opted out), adapter env, and config env,
+   * with TERM/COLORTERM always forced.
+   */
+  static buildSpawnEnv(config, adapterEnv) {
+    const baseEnv = config.inheritProcessEnv !== false ? process.env : {};
+    return {
+      ...baseEnv,
+      ...adapterEnv,
+      ...config.env,
+      TERM: "xterm-256color",
+      COLORTERM: "truecolor"
+    };
+  }
   /**
    * Normalize a list of key names for SPECIAL_KEYS lookup.
    *