pty-manager 1.9.0 → 1.9.2

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
@@ -101,7 +112,7 @@ interface ParsedOutput {
  */
 interface LoginDetection {
     required: boolean;
-    type?: 'api_key' | 'oauth' | 'browser' | 'device_code';
+    type?: 'api_key' | 'oauth' | 'browser' | 'device_code' | 'cli_auth';
     url?: string;
     deviceCode?: string;
     instructions?: string;
@@ -109,7 +120,7 @@ interface LoginDetection {
 /**
  * Normalized authentication methods for runtime event consumers.
  */
-type AuthRequiredMethod = 'api_key' | 'oauth_browser' | 'device_code' | 'unknown';
+type AuthRequiredMethod = 'api_key' | 'cli_auth' | 'oauth_browser' | 'device_code' | 'unknown';
 /**
  * Structured authentication-required payload emitted by PTY session/manager.
  */
@@ -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
@@ -101,7 +112,7 @@ interface ParsedOutput {
  */
 interface LoginDetection {
     required: boolean;
-    type?: 'api_key' | 'oauth' | 'browser' | 'device_code';
+    type?: 'api_key' | 'oauth' | 'browser' | 'device_code' | 'cli_auth';
     url?: string;
     deviceCode?: string;
     instructions?: string;
@@ -109,7 +120,7 @@ interface LoginDetection {
 /**
  * Normalized authentication methods for runtime event consumers.
  */
-type AuthRequiredMethod = 'api_key' | 'oauth_browser' | 'device_code' | 'unknown';
+type AuthRequiredMethod = 'api_key' | 'cli_auth' | 'oauth_browser' | 'device_code' | 'unknown';
 /**
  * Structured authentication-required payload emitted by PTY session/manager.
  */
@@ -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

@@ -601,6 +601,8 @@ var PTYSession = class _PTYSession extends import_events.EventEmitter {
     switch (type) {
       case "api_key":
         return "api_key";
+      case "cli_auth":
+        return "cli_auth";
       case "device_code":
         return "device_code";
       case "oauth":
@@ -900,14 +902,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 +1284,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.
    *