@hwip/cli 0.1.9 → 0.1.10

package/dist/wrapper.d.ts

@@ -32,6 +32,8 @@ export declare const herdrSessionArgs: (session: string, env?: NodeJS.ProcessEnv
  * an older tmux gets none, as before.
  */
 export declare const herdrEnvArgs: (agentKind: string | undefined, env: NodeJS.ProcessEnv, tmuxVersion: string) => string[];
+export declare const agentLaunchEnv: (agentKind: string | undefined, env: NodeJS.ProcessEnv) => Record<string, string>;
+export declare const agentLaunchArgs: (agentKind: string | undefined, extra: string[]) => string[];
 /** `tmux -V`, read once per process; empty when tmux does not answer. */
 export declare const installedTmuxVersion: () => string;
 /**
@@ -91,6 +93,8 @@ export interface SpawnTarget {
     args: string[];
     /** The tmux session name for the two tmux kinds — carried, not re-read off argv. */
     session?: string;
+    /** Variables the agent runs with on top of this process's env (`direct`); the tmux kinds carry them as `-e`. */
+    env?: Record<string, string>;
 }
 /**
  * `hwip <agent> --detach --label <x> --wt <name> …` — the wrapper-owned flags. They

package/dist/wrapper.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.handleShellSession = exports.shellTargets = exports.readShellSessionState = exports.planShellSession = exports.handleAgentSession = exports.tmuxMissingMessage = exports.inPaneNote = exports.handOffExec = exports.ensureListenerRunning = exports.takeListenerLaunchMarker = exports.listenerVersionDrifted = exports.targetForAgent = exports.splitAgentOptions = exports.sanitizeLabel = exports.findAvailableSession = exports.familyNames = exports.firstFreeSession = exports.tmuxSessionName = exports.installedTmuxVersion = exports.herdrEnvArgs = exports.herdrSessionArgs = exports.sessionSidecarArgs = exports.detectProjectName = exports.detectProjectDir = exports.safeBasename = void 0;
+exports.handleShellSession = exports.shellTargets = exports.readShellSessionState = exports.planShellSession = exports.handleAgentSession = exports.tmuxMissingMessage = exports.inPaneNote = exports.handOffExec = exports.ensureListenerRunning = exports.takeListenerLaunchMarker = exports.listenerVersionDrifted = exports.targetForAgent = exports.splitAgentOptions = exports.sanitizeLabel = exports.findAvailableSession = exports.familyNames = exports.firstFreeSession = exports.tmuxSessionName = exports.installedTmuxVersion = exports.agentLaunchArgs = exports.agentLaunchEnv = exports.herdrEnvArgs = exports.herdrSessionArgs = exports.sessionSidecarArgs = exports.detectProjectName = exports.detectProjectDir = exports.safeBasename = void 0;
 /**
  * `hwip cc` / `hwip codex` / `hwip gemini` — spawn an agent inside a named
  * tmux session so the resident listener (`hwip listener`) can address it
@@ -106,6 +106,36 @@ const herdrEnvArgs = (agentKind, env, tmuxVersion) => {
     return config_js_1.HERDR_ENV_VARS.flatMap((name) => ['-e', `${name}=${native ? env[name] ?? '' : ''}`]);
 };
 exports.herdrEnvArgs = herdrEnvArgs;
+/**
+ * Env that keeps an agent's transcript in tmux scrollback, by kind. A
+ * full-screen renderer draws on the alternate screen, where tmux keeps no
+ * history, so the phone cannot page back. Claude Code's fullscreen renderer
+ * is a user setting (`/tui fullscreen`); this forces the classic one. A value
+ * the launching shell already sets wins.
+ */
+const AGENT_LAUNCH_ENV = {
+    claude: { CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN: '1' },
+};
+const agentLaunchEnv = (agentKind, env) => Object.fromEntries(Object.entries(AGENT_LAUNCH_ENV[agentKind ?? ''] ?? {}).map(([name, value]) => [name, env[name] ?? value]));
+exports.agentLaunchEnv = agentLaunchEnv;
+/**
+ * Leading flags with the same aim, by kind, for an agent whose renderer is a
+ * flag: pi defaults to `--tui-mode fullscreen`. Left off when the caller
+ * passes the flag itself.
+ */
+const AGENT_LAUNCH_ARGS = {
+    pi: ['--tui-mode', 'regular'],
+};
+const agentLaunchArgs = (agentKind, extra) => {
+    const lead = AGENT_LAUNCH_ARGS[agentKind ?? ''] ?? [];
+    const flag = lead[0];
+    if (flag === undefined || extra.some((a) => a === flag || a.startsWith(`${flag}=`)))
+        return extra;
+    return [...lead, ...extra];
+};
+exports.agentLaunchArgs = agentLaunchArgs;
+/** `new-session -e` flags for `agentLaunchEnv`; none before tmux 3.2, as for herdr. */
+const launchEnvArgs = (launchEnv, tmuxVersion) => sessionEnvSupported(tmuxVersion) ? Object.entries(launchEnv).flatMap(([name, value]) => ['-e', `${name}=${value}`]) : [];
 /** `tmux -V` says 3.2 or later (`new-session -e`); a development build (`next-3.7`, `master`) is newer. */
 const sessionEnvSupported = (version) => {
     if (/\b(master|next-)/.test(version))
@@ -310,8 +340,10 @@ const targetForAgent = (agent, extra, agentKind, opts = {}) => {
     // is exactly where it runs from.
     // A label asks for a tmux session by name; running in the current pane
     // would drop that silently, so a label is the other exception.
+    const launchEnv = (0, exports.agentLaunchEnv)(agentKind, process.env);
+    extra = (0, exports.agentLaunchArgs)(agentKind, extra);
     if (process.env.TMUX && !opts.detach && !opts.label) {
-        return { kind: 'direct', cmd: agent, args: extra };
+        return { kind: 'direct', cmd: agent, args: extra, ...(Object.keys(launchEnv).length ? { env: launchEnv } : {}) };
     }
     const projectDir = opts.projectDir ?? (0, exports.detectProjectDir)();
     const base = (0, exports.tmuxSessionName)((0, exports.safeBasename)(projectDir));
@@ -342,11 +374,13 @@ const targetForAgent = (agent, extra, agentKind, opts = {}) => {
     if (opts.detach) {
         // Attached to no herdr pane: blank, whatever pane this command was typed in.
         const herdrEnv = (0, exports.herdrEnvArgs)(agentKind, {}, (0, exports.installedTmuxVersion)());
-        return { kind: 'tmux-detached', cmd: 'tmux', args: ['new', '-d', '-s', session, '-c', projectDir, ...herdrEnv, shellCmd, ...sidecar], session };
+        const agentEnv = launchEnvArgs(launchEnv, (0, exports.installedTmuxVersion)());
+        return { kind: 'tmux-detached', cmd: 'tmux', args: ['new', '-d', '-s', session, '-c', projectDir, ...herdrEnv, ...agentEnv, shellCmd, ...sidecar], session };
     }
     // `tmux new -A`: attach if the named session exists, else create it. `-e` applies only when it creates.
     const herdrEnv = (0, exports.herdrEnvArgs)(agentKind, process.env, (0, exports.installedTmuxVersion)());
-    return { kind: 'tmux-new', cmd: 'tmux', args: ['new', '-A', '-s', session, ...herdrEnv, shellCmd, ...sidecar, ...(0, exports.herdrSessionArgs)(session)], session };
+    const agentEnv = launchEnvArgs(launchEnv, (0, exports.installedTmuxVersion)());
+    return { kind: 'tmux-new', cmd: 'tmux', args: ['new', '-A', '-s', session, ...herdrEnv, ...agentEnv, shellCmd, ...sidecar, ...(0, exports.herdrSessionArgs)(session)], session };
 };
 exports.targetForAgent = targetForAgent;
 // ── Background listener auto-start ────────────────────────────────────
@@ -561,7 +595,7 @@ const handleAgentSession = async (agent, extra = [], opts = {}, deps = {}) => {
     // spawned from here would inherit the worktree as its cwd, and it is the one that later removes the directory.
     if (opts.worktree && opts.projectDir)
         process.chdir(opts.projectDir);
-    const { kind, cmd, args, session } = (0, exports.targetForAgent)(agent.binary, extra, agent.kind, opts);
+    const { kind, cmd, args, session, env } = (0, exports.targetForAgent)(agent.binary, extra, agent.kind, opts);
     const note = kind === 'direct' ? (0, exports.inPaneNote)(agent.subcommands[0], currentTmuxSession()) : undefined;
     if (note)
         console.error(note);
@@ -575,7 +609,7 @@ const handleAgentSession = async (agent, extra = [], opts = {}, deps = {}) => {
             return 1;
         }
     }
-    return (deps.launch ?? launchTarget)({ kind, cmd, args, session }, agent.binary);
+    return (deps.launch ?? launchTarget)({ kind, cmd, args, session, env }, agent.binary);
 };
 exports.handleAgentSession = handleAgentSession;
 /**
@@ -583,7 +617,8 @@ exports.handleAgentSession = handleAgentSession;
  * hands the terminal over (execve where it can, a waited child where not) and
  * forwards the exit code. `what` names the program in the detached message.
  */
-const launchTarget = async ({ kind, cmd, args, session }, what) => {
+const launchTarget = async ({ kind, cmd, args, session, env: agentEnv }, what) => {
+    const env = agentEnv ? { ...process.env, ...agentEnv } : process.env;
     if (kind === 'tmux-detached' && session) {
         const r = (0, child_process_1.spawnSync)(cmd, args, { encoding: 'utf-8', stdio: ['ignore', 'pipe', 'pipe'] });
         if (r.error || r.status !== 0) {
@@ -601,7 +636,7 @@ const launchTarget = async ({ kind, cmd, args, session }, what) => {
     // exit code that execve gives us for free by being the same process.
     const handOff = (0, exports.handOffExec)({
         execve: process.execve,
-        env: process.env,
+        env,
         kind,
         stdinTTY: process.stdin.isTTY,
         stdoutTTY: process.stdout.isTTY,
@@ -621,7 +656,7 @@ const launchTarget = async ({ kind, cmd, args, session }, what) => {
     }
     return new Promise((resolve) => {
         const start = Date.now();
-        const child = (0, child_process_1.spawn)(cmd, args, { stdio: 'inherit' });
+        const child = (0, child_process_1.spawn)(cmd, args, { stdio: 'inherit', env });
         child.on('exit', (code) => {
             const dur = Date.now() - start;
             // Short-lived non-zero exits are the symptom of "ran from a

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hwip/cli",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "description": "Hwip CLI + push notification SDK for AI agents",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",