farming-code 2.2.29 → 2.2.32

package/backend/{local-session-engine.js → local-session-engine.cjs}

@@ -1,183 +1,217 @@
-const path = require('path');
-const SessionEngine = require('./session-engine');
-const TerminalScreenWorkerPool = require('./terminal-screen-worker-pool');
+// Generated by scripts/build-backend-runtime.ts. Do not edit.
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var local_session_engine_exports = {};
+__export(local_session_engine_exports, {
+  LocalSessionEngine: () => LocalSessionEngine,
+  createPtyProcess: () => createPtyProcess,
+  extractLatestTerminalTitle: () => extractLatestTerminalTitle,
+  normalizeShellSessionOptions: () => normalizeShellSessionOptions
+});
+module.exports = __toCommonJS(local_session_engine_exports);
+var path = __toESM(require("path"));
+var import_terminal_screen_worker_pool = require("./terminal-screen-worker-pool.cjs");
+var sessionEngineModule = __toESM(require("./session-engine.cjs"));
+var shellBusyIntegrationModule = __toESM(require("./shell-busy-integration.cjs"));
+var inputPartsModule = __toESM(require("./input-parts.cjs"));
+var terminalStatusModule = __toESM(require("./terminal-status.cjs"));
+var agentEnvModule = __toESM(require("./agent-env.cjs"));
+var runtimeGenerationModule = __toESM(require("./native-pty-controller-generation.cjs"));
+var storageLayout = __toESM(require("./storage-layout.cjs"));
+var reducerFlowControlModule = __toESM(require("./terminal-reducer-flow-control.cjs"));
+var terminalAttachCheckpointModule = __toESM(require("./terminal-attach-checkpoint.cjs"));
+var terminalExitQuiescenceModule = __toESM(require("./terminal-exit-quiescence.cjs"));
+const { SessionEngine } = sessionEngineModule;
 const {
   applyShellBusyIntegration,
   cleanupShellBusyIntegration,
-  parseShellBusyMarkers,
-} = require('./shell-busy-integration');
-const { terminalInputToPtyString } = require('./input-parts');
-const { deriveTerminalStatus } = require('./terminal-status');
-const { normalizeInteractiveTerminalEnv } = require('./agent-env');
+  parseShellBusyMarkers
+} = shellBusyIntegrationModule;
+const { terminalInputToPtyString } = inputPartsModule;
+const { deriveTerminalStatus } = terminalStatusModule;
+const { normalizeInteractiveTerminalEnv } = agentEnvModule;
 const {
   allocateNativePtyRuntimeGeneration,
-  formatNativePtyRuntimeEpoch,
-} = require('./native-pty-controller-generation');
-const storageLayout = require('./storage-layout');
+  formatNativePtyRuntimeEpoch
+} = runtimeGenerationModule;
 const {
   acknowledgeTerminalReducerData,
   createTerminalReducerFlowControl,
   ensureTerminalReducerFlowControl,
   enqueueTerminalReducerData,
-  resetTerminalReducerFlowControl,
-} = require('./terminal-reducer-flow-control');
-const {
-  captureTerminalAttachCheckpoint,
-} = require('./terminal-attach-checkpoint');
+  resetTerminalReducerFlowControl
+} = reducerFlowControlModule;
+const { captureTerminalAttachCheckpoint } = terminalAttachCheckpointModule;
 const {
   acceptTerminalExitData,
-  waitForTerminalExitDataQuiescence,
-} = require('./terminal-exit-quiescence');
-
+  waitForTerminalExitDataQuiescence
+} = terminalExitQuiescenceModule;
 const CONTROLLED_BASH_PROMPT = [
-  '\\[\\e[90m\\]│\\[\\e[0m\\] ',
-  '\\[\\e[34m\\]\\W',
-  '\\[\\e[90m\\] \\$ ',
-  '\\[\\e[0m\\]',
-].join('');
-
+  "\\[\\e[90m\\]\u2502\\[\\e[0m\\] ",
+  "\\[\\e[34m\\]\\W",
+  "\\[\\e[90m\\] \\$ ",
+  "\\[\\e[0m\\]"
+].join("");
 const CONTROLLED_ZSH_PROMPT = [
-  '%F{8}│%f ',
-  '%F{4}%1~',
-  '%F{8} %# ',
-  '%f',
-].join('');
-
-const CONTROLLED_ANON_BASH_PROMPT = '\\[\\e[90m\\]│ \\$ \\[\\e[0m\\]';
-const CONTROLLED_ANON_ZSH_PROMPT = '%F{8}│ %# %f';
+  "%F{8}\u2502%f ",
+  "%F{4}%1~",
+  "%F{8} %# ",
+  "%f"
+].join("");
+const CONTROLLED_ANON_BASH_PROMPT = "\\[\\e[90m\\]\u2502 \\$ \\[\\e[0m\\]";
+const CONTROLLED_ANON_ZSH_PROMPT = "%F{8}\u2502 %# %f";
 const INHERITED_PROMPT_ENV_KEYS = [
-  'PS1',
-  'PS2',
-  'PS3',
-  'PS4',
-  'PROMPT',
-  'RPROMPT',
-  'RPS1',
-  'PROMPT_COMMAND',
+  "PS1",
+  "PS2",
+  "PS3",
+  "PS4",
+  "PROMPT",
+  "RPROMPT",
+  "RPS1",
+  "PROMPT_COMMAND"
 ];
-
 function stripInheritedPromptEnv(env) {
   for (const key of INHERITED_PROMPT_ENV_KEYS) {
     delete env[key];
   }
 }
-
 function extractLatestTerminalTitle(data) {
   if (!data) return null;
-
+  const text = String(data);
   const TITLE_PATTERN = /\x1b\]([012]);([^\x07\x1b]*?)(?:\x07|\x1b\\)/g;
   let match = null;
   let latestTitle = null;
-
-  while ((match = TITLE_PATTERN.exec(data)) !== null) {
+  while ((match = TITLE_PATTERN.exec(text)) !== null) {
     const mode = match[1];
-    const title = match[2] ? match[2].trim() : '';
-    if ((mode === '0' || mode === '2') && title) {
+    const title = match[2] ? match[2].trim() : "";
+    if ((mode === "0" || mode === "2") && title) {
       latestTitle = title;
     }
   }
-
   return latestTitle;
 }
-
 let cachedPty = null;
 let cachedPtyError = null;
-
 function loadPtyModule() {
   if (cachedPty) return cachedPty;
   if (cachedPtyError) throw cachedPtyError;
   try {
-    cachedPty = require('./packaged-node-pty');
-    return cachedPty;
+    const packagedNodePtyModule = require("./packaged-node-pty.cjs");
+    cachedPty = packagedNodePtyModule.nodePty;
+    return packagedNodePtyModule.nodePty;
   } catch (error) {
     cachedPtyError = error;
     throw error;
   }
 }
-
+function errorMessage(error) {
+  if (error instanceof Error) return error.message;
+  if (typeof error === "object" && error !== null && "message" in error) {
+    return String(error.message || "");
+  }
+  return String(error || "");
+}
 function createPtyProcess(command, args, options) {
   try {
     return loadPtyModule().spawn(command, args || [], options);
   } catch (error) {
-    const wrapped = new Error(`Farming requires node-pty to start interactive agents. Native PTY is unavailable: ${error.message}`);
+    const wrapped = new Error(`Farming requires node-pty to start interactive agents. Native PTY is unavailable: ${errorMessage(error)}`);
     wrapped.cause = error;
     throw wrapped;
   }
 }
-
 function normalizeShellSessionOptions(options) {
   const normalized = {
     ...options,
-    args: [...(options.args || [])],
+    args: [...options.args || []],
     env: {
-      ...(options.env || process.env)
+      ...options.env || process.env
     }
   };
-
   normalizeInteractiveTerminalEnv(normalized.env, {
     stripRuntimeShims: false,
-    stripNodeOptions: false,
+    stripNodeOptions: false
   });
-
-  if (options.category === 'coding') {
-    // Run coding agents directly to avoid user shell init side effects
-    // (aliases, prompts, startup scripts, TERM mutations) that can break
-    // interactive TUI bootstrapping on specific local machines.
+  if (options.category === "coding") {
     normalized.command = options.command;
-    normalized.args = [...(options.args || [])];
+    normalized.args = [...options.args || []];
     return normalized;
   }
-
-  if (options.category !== 'other') {
+  if (options.category !== "other") {
     return normalized;
   }
-
-  const shellName = path.basename(options.command || '');
-  // Match VS Code's terminal contract: a normal shell starts as the user's
-  // interactive shell. Farming's OSC markers observe it without owning PS1.
-  // The compact prompt remains an explicit privacy / screenshot mode only.
-  const useControlledPrompt = normalized.env.FARMING_SHELL_CONTROLLED_PROMPT === '1'
-    || normalized.env.FARMING_ANONYMIZE_SHELL_PROMPT === '1';
-  const useAnonymousPrompt = normalized.env.FARMING_ANONYMIZE_SHELL_PROMPT === '1';
-
+  const shellName = path.basename(options.command || "");
+  const useControlledPrompt = normalized.env.FARMING_SHELL_CONTROLLED_PROMPT === "1" || normalized.env.FARMING_ANONYMIZE_SHELL_PROMPT === "1";
+  const useAnonymousPrompt = normalized.env.FARMING_ANONYMIZE_SHELL_PROMPT === "1";
   if (useControlledPrompt) stripInheritedPromptEnv(normalized.env);
-
-  if (shellName === 'bash') {
+  if (shellName === "bash") {
     normalized.args = normalized.args.length > 0 ? normalized.args : [];
     if (useControlledPrompt) {
-      normalized.env.FARMING_SHELL_CONTROLLED_PROMPT = '1';
+      normalized.env.FARMING_SHELL_CONTROLLED_PROMPT = "1";
       normalized.env.PS1 = useAnonymousPrompt ? CONTROLLED_ANON_BASH_PROMPT : CONTROLLED_BASH_PROMPT;
     }
-    normalized.env.BASH_SILENCE_DEPRECATION_WARNING = normalized.env.BASH_SILENCE_DEPRECATION_WARNING || '1';
-  } else if (shellName === 'zsh') {
+    normalized.env.BASH_SILENCE_DEPRECATION_WARNING = normalized.env.BASH_SILENCE_DEPRECATION_WARNING || "1";
+  } else if (shellName === "zsh") {
     normalized.args = normalized.args.length > 0 ? normalized.args : [];
     if (useControlledPrompt) {
-      normalized.env.FARMING_SHELL_CONTROLLED_PROMPT = '1';
+      normalized.env.FARMING_SHELL_CONTROLLED_PROMPT = "1";
       normalized.env.PROMPT = useAnonymousPrompt ? CONTROLLED_ANON_ZSH_PROMPT : CONTROLLED_ZSH_PROMPT;
       normalized.env.PS1 = normalized.env.PROMPT;
     }
   }
-
   normalized.env.SHELL = normalized.env.SHELL || options.command || shellName;
-
-  return applyShellBusyIntegration(normalized);
+  return {
+    ...normalized,
+    ...applyShellBusyIntegration(normalized),
+    agentId: normalized.agentId,
+    command: normalized.command
+  };
 }
-
 class LocalSessionEngine extends SessionEngine {
+  configDir;
+  terminalExitDataFlushMs;
+  sessions;
+  screenWorkerPool;
   constructor(options = {}) {
     super();
     this.configDir = options.configDir || storageLayout.farmingConfigDir();
-    this.sessions = new Map();
-    this.screenWorkerPool = new TerminalScreenWorkerPool({
+    this.terminalExitDataFlushMs = options.terminalExitDataFlushMs;
+    this.sessions = /* @__PURE__ */ new Map();
+    this.screenWorkerPool = new import_terminal_screen_worker_pool.TerminalScreenWorkerPool({
       size: 3,
       workerOptions: {
         cols: 80,
         rows: 30,
-        previewSnapshot: false,
-      },
+        previewSnapshot: false
+      }
     });
   }
-
   async createSession(options) {
     const normalized = normalizeShellSessionOptions(options);
     const previewCols = normalized.cols || 80;
@@ -188,13 +222,12 @@ class LocalSessionEngine extends SessionEngine {
       cols: previewCols,
       rows: previewRows,
       runtimeEpoch,
-      runtimeGeneration,
+      runtimeGeneration
     });
-
     let ptyProcess;
     try {
       ptyProcess = createPtyProcess(normalized.command, normalized.args || [], {
-        name: 'xterm-256color',
+        name: "xterm-256color",
         cols: previewCols,
         rows: previewRows,
         cwd: normalized.cwd,
@@ -202,81 +235,75 @@ class LocalSessionEngine extends SessionEngine {
       });
     } catch (error) {
       cleanupShellBusyIntegration(normalized.shellBusyIntegration);
-      await screenWorker.dispose().catch(() => {});
+      await screenWorker.dispose().catch(() => {
+      });
       throw error;
     }
-
     const session = {
       id: normalized.agentId,
       command: normalized.command,
       args: normalized.args || [],
       cwd: normalized.cwd,
       process: ptyProcess,
-      output: '',
+      output: "",
       outputSeq: 0,
       stateRevision: 0,
       runtimeEpoch,
       stateProofAvailable: true,
       reducerFlowControl: createTerminalReducerFlowControl(),
       reducerCommitQueue: Promise.resolve(),
-      renderOutput: '',
-      previewText: '',
+      renderOutput: "",
+      previewText: "",
       previewSnapshot: null,
       previewCols,
       previewRows,
-      title: '',
-      status: 'running',
+      title: "",
+      status: "running",
       terminalBusy: null,
-      shellCwd: '',
+      shellCwd: "",
       shellLastExitCode: null,
-      shellLastEvent: '',
-      shellCommand: '',
-      shellLastCommand: '',
+      shellLastEvent: "",
+      shellCommand: "",
+      shellLastCommand: "",
       shellCommandStartedAt: null,
       shellLastCommandStartedAt: null,
       shellLastCommandFinishedAt: null,
       shellLastCommandDurationMs: null,
-      shellBusyMarkerPending: '',
+      shellBusyMarkerPending: "",
       shellBusyIntegration: normalized.shellBusyIntegration || null,
       startedAt: Date.now(),
       lastActivityAt: Date.now(),
       screenWorker
     };
-
-    session.screenWorker.on('preview', ({ previewText, title, cols, rows, previewSnapshot }) => {
+    screenWorker.on("preview", ({ previewText, title, cols, rows, previewSnapshot }) => {
       const current = this.sessions.get(session.id);
       if (current !== session) return;
-
-      current.previewText = previewText || '';
+      current.previewText = previewText || "";
       current.previewSnapshot = previewSnapshot || null;
       current.previewCols = cols || current.previewCols;
       current.previewRows = rows || current.previewRows;
-
       if (title && title !== current.title) {
         current.title = title;
-        this.emit('session-title', {
+        this.emit("session-title", {
           sessionId: current.id,
           title: current.title,
-          runtimeEpoch: current.runtimeEpoch,
+          runtimeEpoch: current.runtimeEpoch
         });
       }
-
-      this.emit('session-preview', {
+      this.emit("session-preview", {
         sessionId: current.id,
         previewText: current.previewText,
         cols: current.previewCols,
         rows: current.previewRows,
         previewSnapshot: current.previewSnapshot,
-        runtimeEpoch: current.runtimeEpoch,
+        runtimeEpoch: current.runtimeEpoch
       });
     });
-
-    session.screenWorker.on('error', (error) => {
+    screenWorker.on("error", (error) => {
       this.failSessionScreenState(session, error);
     });
-
     this.sessions.set(session.id, session);
-    this.emit('session-started', {
+    this.emit("session-started", {
       sessionId: session.id,
       status: session.status,
       startedAt: session.startedAt,
@@ -284,21 +311,17 @@ class LocalSessionEngine extends SessionEngine {
       outputSeq: session.outputSeq,
       stateRevision: session.stateRevision
     });
-
-    ptyProcess.onData(data => this.handleSessionData(session.id, data, session));
-
+    ptyProcess.onData((data) => this.handleSessionData(session.id, data, session));
     ptyProcess.onExit(({ code }) => {
       void this.handleSessionExit(session, code);
     });
-
     return {
       sessionId: session.id,
       status: session.status
     };
   }
-
   handleSessionExit(session, code) {
-    if (this.sessions.get(session.id) !== session || session.status === 'exited') {
+    if (this.sessions.get(session.id) !== session || session.status === "exited") {
       return Promise.resolve();
     }
     if (session.exitFinalizationPromise) return session.exitFinalizationPromise;
@@ -306,23 +329,22 @@ class LocalSessionEngine extends SessionEngine {
     session.exitFinalizationPromise = finalization;
     return finalization;
   }
-
   async finalizeSessionExit(session, code) {
     const quiesced = await waitForTerminalExitDataQuiescence(session, {
       flushMs: this.terminalExitDataFlushMs,
-      isCurrent: () => this.sessions.get(session.id) === session,
+      isCurrent: () => this.sessions.get(session.id) === session
     });
     if (!quiesced) return;
-    await Promise.resolve(session.reducerCommitQueue).catch(() => {});
+    await Promise.resolve(session.reducerCommitQueue).catch(() => {
+    });
     if (this.sessions.get(session.id) !== session) return;
     const finalCheckpoint = await captureTerminalAttachCheckpoint(session, { requireCurrentCut: true });
     if (this.sessions.get(session.id) !== session) return;
-
-    session.status = 'exited';
+    session.status = "exited";
     session.exitedAt = Date.now();
     resetTerminalReducerFlowControl(
       ensureTerminalReducerFlowControl(session),
-      session.process,
+      session.process
     );
     if (finalCheckpoint) {
       session.finalCheckpoint = Object.freeze({ ...finalCheckpoint });
@@ -333,48 +355,46 @@ class LocalSessionEngine extends SessionEngine {
       session.previewRows = finalCheckpoint.rows;
       session.title = finalCheckpoint.title || session.title;
     } else {
-      this.failSessionScreenState(session, new Error('Unable to capture the exact final Terminal checkpoint'));
+      this.failSessionScreenState(session, new Error("Unable to capture the exact final Terminal checkpoint"));
     }
     if (session.screenWorker) {
-      await session.screenWorker.dispose().catch(() => {});
+      await session.screenWorker.dispose().catch(() => {
+      });
       session.screenWorker = null;
     }
     cleanupShellBusyIntegration(session.shellBusyIntegration);
-
-    this.emit('session-exited', {
+    this.emit("session-exited", {
       sessionId: session.id,
       code,
       exitedAt: session.exitedAt,
       runtimeEpoch: session.runtimeEpoch,
       outputSeq: session.outputSeq,
       stateRevision: session.stateRevision,
-      stateProofAvailable: session.stateProofAvailable !== false,
+      stateProofAvailable: session.stateProofAvailable !== false
     });
     if (finalCheckpoint) {
-      this.emit('session-preview', {
+      this.emit("session-preview", {
         sessionId: session.id,
         previewText: session.previewText,
         cols: session.previewCols,
         rows: session.previewRows,
         previewSnapshot: session.previewSnapshot,
-        runtimeEpoch: session.runtimeEpoch,
+        runtimeEpoch: session.runtimeEpoch
       });
     }
   }
-
   handleSessionData(sessionId, rawData, expectedSession = null) {
     const current = this.sessions.get(sessionId);
-    if (!current || (expectedSession && current !== expectedSession) || current.stateProofAvailable === false) return;
+    if (!current || expectedSession && current !== expectedSession || current.stateProofAvailable === false) return;
     if (!acceptTerminalExitData(current)) {
       current.finalCheckpoint = null;
-      this.failSessionScreenState(current, new Error('PTY emitted data after its final checkpoint cut'));
+      this.failSessionScreenState(current, new Error("PTY emitted data after its final checkpoint cut"));
       return;
     }
-
     const busyState = parseShellBusyMarkers(
       rawData,
       current.terminalBusy,
-      current.shellBusyMarkerPending,
+      current.shellBusyMarkerPending
     );
     current.shellBusyMarkerPending = busyState.pending;
     if (busyState.markerSeen) {
@@ -383,20 +403,20 @@ class LocalSessionEngine extends SessionEngine {
       if (busyState.cwd) current.shellCwd = busyState.cwd;
       if (busyState.exitCodeSeen) current.shellLastExitCode = busyState.lastExitCode;
       if (busyState.shellEvent) current.shellLastEvent = busyState.shellEvent;
-      if (busyState.shellEvent === 'start') current.shellCommandStartedAt = markerAt;
-      if (busyState.commandTextSeen) current.shellCommand = busyState.shellCommand || '';
-      if (busyState.shellEvent === 'finish') {
+      if (busyState.shellEvent === "start") current.shellCommandStartedAt = markerAt;
+      if (busyState.commandTextSeen) current.shellCommand = busyState.shellCommand || "";
+      if (busyState.shellEvent === "finish") {
         const commandStartedAt = current.shellCommandStartedAt;
         if (current.shellCommand) current.shellLastCommand = current.shellCommand;
-        if (typeof commandStartedAt === 'number') {
+        if (typeof commandStartedAt === "number") {
           current.shellLastCommandStartedAt = commandStartedAt;
           current.shellLastCommandFinishedAt = markerAt;
           current.shellLastCommandDurationMs = Math.max(0, markerAt - commandStartedAt);
         }
-        current.shellCommand = '';
+        current.shellCommand = "";
         current.shellCommandStartedAt = null;
       }
-      this.emit('session-busy-state', {
+      this.emit("session-busy-state", {
         sessionId: current.id,
         terminalBusy: current.terminalBusy,
         cwd: current.shellCwd || current.cwd,
@@ -410,16 +430,15 @@ class LocalSessionEngine extends SessionEngine {
         shellLastCommandDurationMs: current.shellLastCommandDurationMs,
         statusMarkerSeen: busyState.statusMarkerSeen,
         busyMarkerSeen: busyState.busyMarkerSeen,
-        runtimeEpoch: current.runtimeEpoch,
+        runtimeEpoch: current.runtimeEpoch
       });
     }
-
     const data = busyState.data;
     if (!data) return;
     const reducerDelivery = enqueueTerminalReducerData(
       ensureTerminalReducerFlowControl(current),
       current.process,
-      data,
+      data
     );
     if (reducerDelivery.error) {
       this.failSessionScreenState(current, reducerDelivery.error);
@@ -429,19 +448,18 @@ class LocalSessionEngine extends SessionEngine {
     current.stateRevision += 1;
     const outputSeq = current.outputSeq;
     const stateRevision = current.stateRevision;
-    current.output = `${current.output}${data}`.slice(-10000);
+    current.output = `${current.output}${data}`.slice(-1e4);
     current.lastActivityAt = Date.now();
-
     const fallbackTitle = extractLatestTerminalTitle(data);
     if (fallbackTitle && fallbackTitle !== current.title) {
       current.title = fallbackTitle;
-      this.emit('session-title', {
+      this.emit("session-title", {
         sessionId: current.id,
         title: current.title,
-        runtimeEpoch: current.runtimeEpoch,
+        runtimeEpoch: current.runtimeEpoch
       });
     }
-
+    if (!current.screenWorker) throw new TypeError("Terminal screen worker is unavailable");
     const commit = current.screenWorker.append(data, stateRevision, outputSeq);
     current.reducerCommitQueue = current.reducerCommitQueue.then(() => commit).then(() => {
       const latest = this.sessions.get(current.id);
@@ -449,112 +467,104 @@ class LocalSessionEngine extends SessionEngine {
       const flowError = acknowledgeTerminalReducerData(
         ensureTerminalReducerFlowControl(latest),
         latest.process,
-        reducerDelivery.bytes,
+        reducerDelivery.bytes
       );
       if (flowError) {
         this.failSessionScreenState(latest, flowError);
         return;
       }
-      this.emit('session-output', {
+      this.emit("session-output", {
         sessionId: latest.id,
         data,
         runtimeEpoch: latest.runtimeEpoch,
         outputSeq,
-        stateRevision,
+        stateRevision
       });
-      this.emit('session-activity', {
+      this.emit("session-activity", {
         sessionId: latest.id,
         lastActivityAt: latest.lastActivityAt,
-        runtimeEpoch: latest.runtimeEpoch,
+        runtimeEpoch: latest.runtimeEpoch
       });
-    }).catch(error => this.failSessionScreenState(current, error));
+    }).catch((error) => this.failSessionScreenState(current, error));
   }
-
   failSessionScreenState(session, error) {
     const current = this.sessions.get(session.id);
     if (current !== session || current.stateProofAvailable === false) return;
     current.stateProofAvailable = false;
-    const message = error instanceof Error ? error.message : String(error || 'unknown reducer failure');
-    this.emit('session-error', {
+    const message = error instanceof Error ? error.message : String(error || "unknown reducer failure");
+    this.emit("session-error", {
       sessionId: current.id,
       error: `Terminal state reducer failed: ${message}`,
       fatal: true,
-      runtimeEpoch: current.runtimeEpoch,
+      runtimeEpoch: current.runtimeEpoch
     });
     try {
       current.process?.kill();
     } catch {
-      // The runtime cannot continue safely without its authoritative reducer.
     }
   }
-
   async sendInput(sessionId, input, options = {}) {
     const session = this.sessions.get(sessionId);
-    if (!session || !session.process || session.status === 'exited' || session.exitFinalizing === true) {
-      throw new Error('Session not available');
+    if (!session || !session.process || session.status === "exited" || session.exitFinalizing === true) {
+      throw new Error("Session not available");
     }
-
     if (options.expectedRuntimeEpoch && options.expectedRuntimeEpoch !== session.runtimeEpoch) {
-      return { status: 'input-rejected', reason: 'runtime-epoch-mismatch' };
+      return { status: "input-rejected", reason: "runtime-epoch-mismatch" };
     }
     session.process.write(terminalInputToPtyString(input));
     session.lastActivityAt = Date.now();
-    this.emit('session-activity', {
+    this.emit("session-activity", {
       sessionId,
       lastActivityAt: session.lastActivityAt,
-      runtimeEpoch: session.runtimeEpoch,
+      runtimeEpoch: session.runtimeEpoch
     });
     return { sent: true };
   }
-
-  async interruptSession(sessionId, input = '\x03', options = {}) {
+  async interruptSession(sessionId, input = "", options = {}) {
     return this.sendInput(sessionId, input, options);
   }
-
   async getSessionAttachCheckpoint(sessionId) {
     const session = this.sessions.get(sessionId);
     if (!session) return null;
     const checkpoint = await captureTerminalAttachCheckpoint(session);
     return this.sessions.get(sessionId) === session ? checkpoint : null;
   }
-
   async resizeSession(sessionId, cols, rows) {
     const session = this.sessions.get(sessionId);
     if (!session || !session.process || !session.process.resize) {
-      return { status: 'resize-rejected', reason: 'session-unavailable', resized: false };
+      return { status: "resize-rejected", reason: "session-unavailable", resized: false };
     }
-    if (session.status === 'exited' || session.exitFinalizing === true) {
-      return { status: 'resize-rejected', reason: 'session-unavailable', resized: false };
+    if (session.status === "exited" || session.exitFinalizing === true) {
+      return { status: "resize-rejected", reason: "session-unavailable", resized: false };
     }
-
     if (cols === session.previewCols && rows === session.previewRows) {
       if (this.sessions.get(sessionId) !== session) {
-        return { status: 'resize-rejected', reason: 'session-replaced', resized: false };
+        return { status: "resize-rejected", reason: "session-replaced", resized: false };
       }
       return {
-        status: 'resize-committed',
+        status: "resize-committed",
         resized: true,
-        unchanged: true,
+        unchanged: true
       };
     }
-
+    const resize = session.process.resize;
     try {
-      session.process.resize(cols, rows);
+      resize.call(session.process, cols, rows);
     } catch (error) {
-      if (error && String(error.message || '').includes('EBADF')) {
-        session.status = 'exited';
+      if (errorMessage(error).includes("EBADF")) {
+        session.status = "exited";
         session.exitedAt = session.exitedAt || Date.now();
-        return { status: 'resize-rejected', reason: 'session-unavailable', resized: false };
+        return { status: "resize-rejected", reason: "session-unavailable", resized: false };
       }
       return {
-        status: 'resize-rejected',
-        reason: 'pty-resize-failed',
+        status: "resize-rejected",
+        reason: "pty-resize-failed",
         resized: false,
-        error: error instanceof Error ? error.message : String(error || 'unknown PTY resize failure'),
+        error: error instanceof Error ? error.message : String(error || "unknown PTY resize failure")
       };
     }
     if (this.sessions.get(sessionId) !== session) {
-      return { status: 'resize-rejected', reason: 'session-replaced', resized: false };
+      return { status: "resize-rejected", reason: "session-replaced", resized: false };
     }
     session.stateRevision += 1;
     const stateRevision = session.stateRevision;
@@ -564,46 +574,39 @@ class LocalSessionEngine extends SessionEngine {
     session.previewRows = rows || session.previewRows;
     if (!session.screenWorker) {
       if (this.sessions.get(sessionId) !== session) {
-        return { status: 'resize-rejected', reason: 'session-replaced', resized: false };
+        return { status: "resize-rejected", reason: "session-replaced", resized: false };
       }
       return {
-        status: 'resize-committed',
+        status: "resize-committed",
         resized: true,
-        unchanged: false,
+        unchanged: false
       };
     }
-
     const reducerCommit = session.screenWorker.resize(cols, rows, stateRevision);
     const publishedCommit = session.reducerCommitQueue.then(() => reducerCommit).then((screenState) => {
       if (this.sessions.get(sessionId) !== session) {
-        throw new Error('Terminal session was replaced during resize');
+        throw new Error("Terminal session was replaced during resize");
       }
-      if (
-        screenState.runtimeEpoch !== runtimeEpoch ||
-        screenState.outputSeq !== outputSeq ||
-        screenState.stateRevision !== stateRevision
-      ) {
-        throw new Error('Terminal screen resize returned a non-authoritative state cut');
+      if (screenState.runtimeEpoch !== runtimeEpoch || screenState.outputSeq !== outputSeq || screenState.stateRevision !== stateRevision) {
+        throw new Error("Terminal screen resize returned a non-authoritative state cut");
       }
-      session.previewText = screenState.previewText || '';
+      session.previewText = screenState.previewText || "";
       session.previewSnapshot = screenState.previewSnapshot || session.previewSnapshot;
-      session.renderOutput = typeof screenState.renderOutput === 'string'
-        ? screenState.renderOutput
-        : session.renderOutput;
+      session.renderOutput = typeof screenState.renderOutput === "string" ? screenState.renderOutput : session.renderOutput;
       session.previewCols = screenState.cols || cols || session.previewCols;
       session.previewRows = screenState.rows || rows || session.previewRows;
       if (screenState.title && screenState.title !== session.title) {
         session.title = screenState.title;
-        this.emit('session-title', {
+        this.emit("session-title", {
           sessionId,
           title: session.title,
-          runtimeEpoch: session.runtimeEpoch,
+          runtimeEpoch: session.runtimeEpoch
         });
       }
-      this.emit('session-transition', {
+      this.emit("session-transition", {
         sessionId,
-        kind: 'resize',
-        data: '',
+        kind: "resize",
+        data: "",
         runtimeEpoch: screenState.runtimeEpoch,
         outputSeq: screenState.outputSeq,
         stateRevision: screenState.stateRevision,
@@ -612,83 +615,76 @@ class LocalSessionEngine extends SessionEngine {
       });
       return screenState;
     });
-    session.reducerCommitQueue = publishedCommit.catch(error => {
+    session.reducerCommitQueue = publishedCommit.catch((error) => {
       this.failSessionScreenState(session, error);
     });
     try {
       await publishedCommit;
     } catch {
-      return { status: 'resize-rejected', reason: 'screen-reducer-failed', resized: false };
+      return { status: "resize-rejected", reason: "screen-reducer-failed", resized: false };
     }
     if (this.sessions.get(sessionId) !== session) {
-      return { status: 'resize-rejected', reason: 'session-replaced', resized: false };
+      return { status: "resize-rejected", reason: "session-replaced", resized: false };
     }
     return {
-      status: 'resize-committed',
+      status: "resize-committed",
       resized: true,
       unchanged: false,
       runtimeEpoch,
       outputSeq,
       stateRevision,
       cols,
-      rows,
+      rows
     };
   }
-
   async clearBuffer(sessionId, options = {}) {
     const session = this.sessions.get(sessionId);
-    if (!session || session.status === 'exited' || session.exitFinalizing === true) {
+    if (!session || session.status === "exited" || session.exitFinalizing === true) {
       return { cleared: false };
     }
     if (options.expectedRuntimeEpoch && options.expectedRuntimeEpoch !== session.runtimeEpoch) {
-      return { cleared: false, reason: 'runtime-epoch-mismatch' };
+      return { cleared: false, reason: "runtime-epoch-mismatch" };
     }
-
-    session.output = '';
+    session.output = "";
     session.stateRevision += 1;
     const stateRevision = session.stateRevision;
     const outputSeq = session.outputSeq;
     const runtimeEpoch = session.runtimeEpoch;
-    session.renderOutput = '';
-    session.previewText = '';
+    session.renderOutput = "";
+    session.previewText = "";
     session.previewSnapshot = null;
     session.lastActivityAt = Date.now();
-
     let exactState = {
-      renderOutput: '',
+      renderOutput: "",
       runtimeEpoch,
       outputSeq,
       stateRevision,
       cols: session.previewCols,
-      rows: session.previewRows,
+      rows: session.previewRows
     };
     if (session.screenWorker) {
       const reducerCommit = session.screenWorker.clear(stateRevision, outputSeq);
       const publishedCommit = session.reducerCommitQueue.then(() => reducerCommit).then((screenState) => {
         if (this.sessions.get(sessionId) !== session) {
-          throw new Error('Terminal session was replaced during clear');
+          throw new Error("Terminal session was replaced during clear");
         }
-        if (
-          screenState.runtimeEpoch !== runtimeEpoch ||
-          screenState.outputSeq !== outputSeq ||
-          screenState.stateRevision !== stateRevision
-        ) {
-          throw new Error('Terminal screen clear returned a non-authoritative state cut');
+        if (screenState.runtimeEpoch !== runtimeEpoch || screenState.outputSeq !== outputSeq || screenState.stateRevision !== stateRevision) {
+          throw new Error("Terminal screen clear returned a non-authoritative state cut");
         }
-        session.renderOutput = typeof screenState.renderOutput === 'string' ? screenState.renderOutput : '';
-        session.previewText = screenState.previewText || '';
+        session.renderOutput = typeof screenState.renderOutput === "string" ? screenState.renderOutput : "";
+        session.previewText = screenState.previewText || "";
         session.previewSnapshot = screenState.previewSnapshot || null;
         session.previewCols = screenState.cols || session.previewCols;
         session.previewRows = screenState.rows || session.previewRows;
         exactState = screenState;
         if (screenState.title && screenState.title !== session.title) {
           session.title = screenState.title;
-          this.emit('session-title', { sessionId, title: session.title, runtimeEpoch: session.runtimeEpoch });
+          this.emit("session-title", { sessionId, title: session.title, runtimeEpoch: session.runtimeEpoch });
         }
-        this.emit('session-transition', {
+        this.emit("session-transition", {
           sessionId,
-          kind: 'clear',
-          data: '\x1b[2J\x1b[3J\x1b[H',
+          kind: "clear",
+          data: "\x1B[2J\x1B[3J\x1B[H",
           runtimeEpoch: screenState.runtimeEpoch,
           outputSeq: screenState.outputSeq,
           stateRevision: screenState.stateRevision,
@@ -697,7 +693,7 @@ class LocalSessionEngine extends SessionEngine {
         });
         return screenState;
       });
-      session.reducerCommitQueue = publishedCommit.catch(error => {
+      session.reducerCommitQueue = publishedCommit.catch((error) => {
         this.failSessionScreenState(session, error);
       });
       try {
@@ -706,20 +702,20 @@ class LocalSessionEngine extends SessionEngine {
         return { cleared: false };
       }
     }
-    if (this.sessions.get(sessionId) !== session) return { cleared: false, reason: 'session-replaced' };
-    this.emit('session-preview', {
+    if (this.sessions.get(sessionId) !== session) return { cleared: false, reason: "session-replaced" };
+    this.emit("session-preview", {
       sessionId,
       previewText: session.previewText,
       cols: session.previewCols,
       rows: session.previewRows,
       previewSnapshot: session.previewSnapshot,
       title: session.title,
-      runtimeEpoch: session.runtimeEpoch,
+      runtimeEpoch: session.runtimeEpoch
     });
-    this.emit('session-activity', {
+    this.emit("session-activity", {
       sessionId,
       lastActivityAt: session.lastActivityAt,
-      runtimeEpoch: session.runtimeEpoch,
+      runtimeEpoch: session.runtimeEpoch
     });
     return {
       cleared: true,
@@ -727,30 +723,26 @@ class LocalSessionEngine extends SessionEngine {
       outputSeq: exactState.outputSeq,
       stateRevision: exactState.stateRevision,
       cols: exactState.cols,
-      rows: exactState.rows,
+      rows: exactState.rows
     };
   }
-
   async killSession(sessionId) {
     const session = this.sessions.get(sessionId);
     if (!session || !session.process) {
       return;
     }
-
-    session.status = 'stopping';
+    session.status = "stopping";
     session.killRequestedAt = Date.now();
-    session.process.kill('SIGTERM');
-
+    session.process.kill("SIGTERM");
     const killTimer = setTimeout(() => {
       const latest = this.sessions.get(sessionId);
-      if (latest !== session || latest.status === 'exited' || !latest.process) {
+      if (latest !== session || latest.status === "exited" || !latest.process) {
         return;
       }
-      latest.process.kill('SIGKILL');
+      latest.process.kill("SIGKILL");
     }, 1500);
-    if (typeof killTimer.unref === 'function') killTimer.unref();
+    if (typeof killTimer.unref === "function") killTimer.unref();
   }
-
   async getSessionState(sessionId) {
     const session = this.sessions.get(sessionId);
     if (!session) return null;
@@ -764,8 +756,7 @@ class LocalSessionEngine extends SessionEngine {
     const checkpoint = stateProofAvailable ? await captureTerminalAttachCheckpoint(session) : null;
     if (this.sessions.get(sessionId) !== session) return null;
     const title = checkpoint ? checkpoint.title : fallbackTitle;
-    const previewText = checkpoint ? checkpoint.previewText : (stateProofAvailable ? fallbackPreviewText : '');
-
+    const previewText = checkpoint ? checkpoint.previewText : stateProofAvailable ? fallbackPreviewText : "";
     return {
       sessionId: session.id,
       status: session.status,
@@ -774,9 +765,9 @@ class LocalSessionEngine extends SessionEngine {
       outputSeq: checkpoint?.outputSeq ?? null,
       stateRevision: checkpoint?.stateRevision ?? null,
       stateProofAvailable,
-      renderOutput: checkpoint ? checkpoint.renderOutput : (stateProofAvailable ? snapshotOutput : ''),
+      renderOutput: checkpoint ? checkpoint.renderOutput : stateProofAvailable ? snapshotOutput : "",
       previewText,
-      previewSnapshot: checkpoint ? checkpoint.previewSnapshot : (stateProofAvailable ? fallbackPreviewSnapshot : null),
+      previewSnapshot: checkpoint ? checkpoint.previewSnapshot : stateProofAvailable ? fallbackPreviewSnapshot : null,
       previewCols: checkpoint ? checkpoint.cols : fallbackPreviewCols,
       previewRows: checkpoint ? checkpoint.rows : fallbackPreviewRows,
       title,
@@ -784,8 +775,11 @@ class LocalSessionEngine extends SessionEngine {
       startedAt: session.startedAt,
       exitedAt: session.exitedAt || null,
       terminalBusy: session.terminalBusy,
-      shellCommand: session.shellCommand || '',
-      shellLastCommand: session.shellLastCommand || '',
+      shellCommand: session.shellCommand || "",
+      shellLastCommand: session.shellLastCommand || "",
+      shellCwd: session.shellCwd || "",
+      shellLastEvent: session.shellLastEvent || "",
+      shellLastExitCode: session.shellLastExitCode ?? null,
       shellCommandStartedAt: session.shellCommandStartedAt ?? null,
       shellLastCommandStartedAt: session.shellLastCommandStartedAt ?? null,
       shellLastCommandFinishedAt: session.shellLastCommandFinishedAt ?? null,
@@ -804,23 +798,22 @@ class LocalSessionEngine extends SessionEngine {
         shellCommandStartedAt: session.shellCommandStartedAt,
         shellLastCommandStartedAt: session.shellLastCommandStartedAt,
         shellLastCommandFinishedAt: session.shellLastCommandFinishedAt,
-        shellLastCommandDurationMs: session.shellLastCommandDurationMs,
+        shellLastCommandDurationMs: session.shellLastCommandDurationMs
       })
     };
   }
-
   async getSessionPreview(sessionId) {
     const session = this.sessions.get(sessionId);
     if (!session) {
-      return '';
+      return "";
     }
-    const screenState = session.screenWorker
-      ? await session.screenWorker.getState({ includeRenderOutput: false }).catch(() => null)
-      : null;
-    if (this.sessions.get(sessionId) !== session) return '';
-    return (screenState && screenState.previewText) || session.previewText;
+    const screenState = session.screenWorker ? await session.screenWorker.getState({ includeRenderOutput: false }).catch(() => null) : null;
+    if (this.sessions.get(sessionId) !== session) return "";
+    return screenState && screenState.previewText || session.previewText;
+  }
+  consumeRuntimeRotation() {
+    return null;
   }
-
   dispose() {
     const disposals = [];
     this.sessions.forEach((session) => {
@@ -830,7 +823,6 @@ class LocalSessionEngine extends SessionEngine {
         }
         cleanupShellBusyIntegration(session.shellBusyIntegration);
       } catch {
-        // best effort
       }
     });
     this.sessions.clear();
@@ -838,8 +830,10 @@ class LocalSessionEngine extends SessionEngine {
     return Promise.allSettled(disposals);
   }
 }
-
-module.exports = LocalSessionEngine;
-module.exports.normalizeShellSessionOptions = normalizeShellSessionOptions;
-module.exports.extractLatestTerminalTitle = extractLatestTerminalTitle;
-module.exports.createPtyProcess = createPtyProcess;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  LocalSessionEngine,
+  createPtyProcess,
+  extractLatestTerminalTitle,
+  normalizeShellSessionOptions
+});