loadtoagent 1.3.3 → 1.3.5

package/src/agentMonitor/genericParser.js

@@ -60,19 +60,20 @@ function createGenericParser(dependencies) {
     return out;
   }
 
-  function readSessionFile(fileInfo) {
+  function readSessionFile(fileInfo, options = {}) {
     const isJsonl = /\.jsonl$/i.test(fileInfo.file);
     return isJsonl
-      ? readJsonLines(fileInfo.file)
+      ? readJsonLines(fileInfo.file, options.fullHistory ? Math.max(1, Number(fileInfo.size || 0) + 1) : undefined)
       : { rows: [readJson(fileInfo.file, {})], truncated: false };
   }
 
-  function initializeSession(fileInfo, provider, parsed) {
+  function initializeSession(fileInfo, provider, parsed, options = {}) {
     const rows = parsed.rows.filter(Boolean);
     const root = rows.length === 1 ? rows[0] : { events: rows };
     const externalId = root.session_id || root.sessionId || root.id
       || path.basename(fileInfo.file).replace(/\.(jsonl?|ndjson)$/i, '');
     const session = baseSession(provider, externalId, fileInfo.file, fileInfo);
+    session.fullHistory = Boolean(options.fullHistory);
     session.truncated = parsed.truncated;
     session.cwd = root.cwd || root.projectPath || root.project_path || '';
     session.originCwd = session.cwd;
@@ -264,9 +265,9 @@ function createGenericParser(dependencies) {
     return session;
   }
 
-  return function parseGeneric(fileInfo, provider) {
-    const parsed = readSessionFile(fileInfo);
-    const initialized = initializeSession(fileInfo, provider, parsed);
+  return function parseGeneric(fileInfo, provider, options = {}) {
+    const parsed = readSessionFile(fileInfo, options);
+    const initialized = initializeSession(fileInfo, provider, parsed, options);
     if (!initialized.rows.length) return null;
     const events = initialized.rows.length === 1 && Array.isArray(initialized.root.events)
       ? initialized.root.events

package/src/agentMonitor.js

@@ -56,7 +56,7 @@ function timestamp(value, fallback = null) {
 }
 
 function addMessage(session, message) {
-  const text = compactText(message.text, message.type === 'tool' ? 1600 : 6000);
+  const text = compactText(message.text, session.fullHistory ? Number.MAX_SAFE_INTEGER : (message.type === 'tool' ? 1600 : 6000));
   if (!text && message.type !== 'tool') return;
   const row = {
     id: String(message.id || `${session.id}:m:${session.messages.length}`),
@@ -353,6 +353,13 @@ function contextInfo(used, windowInfo) {
 }
 
 function trimSession(session) {
+  if (session.fullHistory) {
+    session.omittedMessages = 0;
+    session.omittedLifecycle = 0;
+    session.truncated = false;
+    if (!session.messages.length) addMessage(session, { id: `${session.id}:empty`, role: 'system', text: '표시할 대화 메시지가 아직 없습니다.', timestamp: session.updatedAt });
+    return;
+  }
   session.omittedMessages = Math.max(0, session.messages.length - MAX_MESSAGES);
   session.omittedLifecycle = Math.max(0, session.lifecycle.length - MAX_LIFECYCLE);
   session.messages = session.messages.slice(-MAX_MESSAGES);
@@ -360,7 +367,7 @@ function trimSession(session) {
   if (!session.messages.length) addMessage(session, { id: `${session.id}:empty`, role: 'system', text: '표시할 대화 메시지가 아직 없습니다.', timestamp: session.updatedAt });
 }
 
-function parseManagedSession(runDir) {
+function parseManagedSession(runDir, options = {}) {
   const meta = readJson(path.join(runDir, 'meta.json'));
   const live = readJson(path.join(runDir, 'session.json'));
   if (!meta || !live) return null;
@@ -373,6 +380,7 @@ function parseManagedSession(runDir) {
     source: 'loadtoagent',
     sourceLabel: 'LoadToAgent 실행',
     statusObserved: true,
+    fullHistory: Boolean(options.fullHistory),
   };
   session.originCwd = session.originCwd || meta.cwd || session.cwd || '';
   session.usage = finalizeUsage(session.usage);
@@ -482,8 +490,8 @@ class AgentMonitor extends EventEmitter {
     }).filter(Boolean).sort((a, b) => b.mtimeMs - a.mtimeMs).slice(0, max);
   }
 
-  parseFile(info, parser) {
-    const key = `${info.file}|${info.mtimeMs}|${info.size}`;
+  parseFile(info, parser, variant = '') {
+    const key = `${info.file}|${info.mtimeMs}|${info.size}|${variant}`;
     const cached = this.parseCache.get(key);
     if (cached) return cached;
     const value = parser(info);
@@ -495,6 +503,38 @@ class AgentMonitor extends EventEmitter {
     return value;
   }
 
+  detailSession(sessionId) {
+    const stored = (this.lastSnapshot.sessions || []).find(session => session.id === String(sessionId || '')) || null;
+    if (!stored) return null;
+    let detailed = null;
+    if (stored.source === 'loadtoagent' && stored.runId && this.runsDir) {
+      detailed = parseManagedSession(path.join(this.runsDir, stored.runId), { fullHistory: true });
+    } else if (stored.file) {
+      const stat = safeStat(stored.file);
+      if (stat && stat.isFile()) {
+        const info = { file: stored.file, mtimeMs: stat.mtimeMs, size: stat.size };
+        const parser = stored.provider === 'claude'
+          ? item => parseClaude(item, { fullHistory: true })
+          : stored.provider === 'codex'
+            ? item => parseCodex(item, { fullHistory: true })
+            : item => parseGeneric(item, stored.provider, { fullHistory: true });
+        detailed = this.parseFile(info, parser, 'full-history');
+      }
+    }
+    if (!detailed) return stored;
+    return {
+      ...stored,
+      ...detailed,
+      environment: stored.environment,
+      delegation: stored.delegation || detailed.delegation,
+      childIds: stored.childIds || detailed.childIds || [],
+      fullHistory: true,
+      truncated: false,
+      omittedMessages: 0,
+      omittedLifecycle: 0,
+    };
+  }
+
   hintedFiles(paths, max) {
     return (paths || []).map(value => {
       if (value && typeof value === 'object' && value.file && Number.isFinite(value.mtimeMs) && Number.isFinite(value.size)) {

package/src/attentionNotifier.js

@@ -2,6 +2,7 @@
 
 class AttentionNotifier {
   constructor(options = {}) {
+    this.enabled = options.enabled !== false;
     this.Notification = options.Notification;
     this.isSupported = options.isSupported || (() => Boolean(this.Notification));
     this.copy = options.copy || (() => ({ title: '내 확인이 필요합니다', body: '응답이나 선택을 기다리는 AI 세션이 있습니다.' }));
@@ -12,6 +13,7 @@ class AttentionNotifier {
   }
 
   sync(snapshot) {
+    if (!this.enabled) return [];
     const needsAttention = (snapshot && Array.isArray(snapshot.sessions) ? snapshot.sessions : [])
       .filter(session => session && session.id && (
         session.attention?.required
@@ -32,6 +34,7 @@ class AttentionNotifier {
   }
 
   notify(session) {
+    if (!this.enabled) return null;
     let supported = false;
     try {
       supported = Boolean(this.Notification && this.isSupported());

package/src/ipc/registerTerminalIpc.js

@@ -3,7 +3,7 @@
 function registerTerminalIpc({ ipcMain, requireTrustedSender, trustedSender, manager, isProviderVisible = () => true, listWslDistros, sendError }) {
   ipcMain.handle('terminals:list', event => {
     requireTrustedSender(event);
-    return manager() ? manager().list().filter(session => session.type !== 'agent' || isProviderVisible(session.provider)) : [];
+    return manager() ? manager().list().filter(session => !session.transient && (session.type !== 'agent' || isProviderVisible(session.provider))) : [];
   });
   ipcMain.handle('wsl:list-distros', event => {
     requireTrustedSender(event);
@@ -12,7 +12,7 @@ function registerTerminalIpc({ ipcMain, requireTrustedSender, trustedSender, man
   ipcMain.handle('terminals:get', async (event, id) => {
     requireTrustedSender(event);
     const session = manager() ? await manager().get(id, true) : null;
-    return session && session.type === 'agent' && !isProviderVisible(session.provider) ? null : session;
+    return session && (session.transient || (session.type === 'agent' && !isProviderVisible(session.provider))) ? null : session;
   });
   ipcMain.handle('terminals:create', (event, options) => {
     requireTrustedSender(event);

package/src/monitorWorker.js

@@ -317,7 +317,7 @@ parentPort.on('message', message => {
   }
   if (message.type === 'detail') {
     const runtime = lastPublishedSessions.find(item => item.id === message.sessionId) || null;
-    const stored = (monitor.lastSnapshot.sessions || []).find(item => item.id === message.sessionId) || null;
+    const stored = monitor.detailSession(message.sessionId);
     const merged = stored && runtime
       ? { ...stored, status: runtime.status, statusDetail: runtime.statusDetail, statusObserved: runtime.statusObserved, runtimePresence: runtime.runtimePresence || [] }
       : (stored || runtime);

package/src/nodePtyRuntime.js

@@ -0,0 +1,58 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+function unpackedAsarPath(file) {
+  return String(file || '')
+    .replace(/([\\/])app\.asar(?=[\\/])/g, '$1app.asar.unpacked')
+    .replace(/([\\/])node_modules\.asar(?=[\\/])/g, '$1node_modules.asar.unpacked');
+}
+
+function macNodePtyRuntimeFiles(options = {}) {
+  const platform = options.platform || process.platform;
+  if (platform !== 'darwin') return null;
+  const arch = String(options.arch || process.arch);
+  if (!/^(?:arm64|x64)$/.test(arch)) throw new Error(`지원하지 않는 macOS 아키텍처입니다: ${arch}`);
+  const resolvePackage = options.resolvePackage || (() => require.resolve('node-pty/package.json'));
+  const packageRoot = path.dirname(unpackedAsarPath(resolvePackage()));
+  const prebuild = path.join(packageRoot, 'prebuilds', `darwin-${arch}`);
+  return {
+    packageRoot,
+    helper: path.join(prebuild, 'spawn-helper'),
+    addon: path.join(prebuild, 'pty.node'),
+  };
+}
+
+function ensureMacNodePtyRuntime(options = {}) {
+  const files = macNodePtyRuntimeFiles(options);
+  if (!files) return { repaired: false, files: null };
+  const fileSystem = options.fileSystem || fs;
+  const executableMode = fileSystem.constants?.X_OK ?? fs.constants.X_OK;
+  for (const file of [files.addon, files.helper]) {
+    let stat;
+    try {
+      stat = fileSystem.statSync(file);
+    } catch (error) {
+      throw new Error(`macOS 터미널 구성 요소를 찾을 수 없습니다: ${file}`, { cause: error });
+    }
+    if (!stat.isFile()) throw new Error(`macOS 터미널 구성 요소가 파일이 아닙니다: ${file}`);
+  }
+
+  let repaired = false;
+  try {
+    fileSystem.accessSync(files.helper, executableMode);
+  } catch (_notExecutable) {
+    const mode = fileSystem.statSync(files.helper).mode;
+    try {
+      fileSystem.chmodSync(files.helper, mode | 0o111);
+      fileSystem.accessSync(files.helper, executableMode);
+      repaired = true;
+    } catch (error) {
+      throw new Error(`macOS 터미널 실행 권한을 복구할 수 없습니다: ${files.helper}`, { cause: error });
+    }
+  }
+  return { repaired, files };
+}
+
+module.exports = { ensureMacNodePtyRuntime, macNodePtyRuntimeFiles, unpackedAsarPath };

package/src/processMonitor.js

@@ -5,6 +5,18 @@ const { blankUsage } = require('./providerRegistry');
 
 const DEFAULT_SCAN_TTL_MS = 12_000;
 const WMIC_QUERY = "Name='claude.exe' or Name='codex.exe' or Name='node.exe' or Name='gemini.exe' or Name='grok.exe'";
+const WINDOWS_PROCESS_SCRIPT = [
+  "$ProgressPreference = 'SilentlyContinue'",
+  "$ErrorActionPreference = 'Stop'",
+  '[Console]::OutputEncoding = [System.Text.UTF8Encoding]::new($false)',
+  "$names = @('claude.exe','codex.exe','node.exe','gemini.exe','grok.exe')",
+  '$rows = Get-CimInstance Win32_Process | Where-Object { $names -contains $_.Name } | ForEach-Object {',
+  "  $started = if ($_.CreationDate) { $_.CreationDate.ToUniversalTime().ToString('o') } else { $null }",
+  '  [pscustomobject]@{ pid = [int]$_.ProcessId; parentPid = [int]$_.ParentProcessId; name = [string]$_.Name; commandLine = [string]$_.CommandLine; startedAt = $started }',
+  '}',
+  '@($rows) | ConvertTo-Json -Compress',
+].join('; ');
+const WINDOWS_PROCESS_SCRIPT_BASE64 = Buffer.from(WINDOWS_PROCESS_SCRIPT, 'utf16le').toString('base64');
 
 function parseCsvRows(value) {
   const text = Buffer.isBuffer(value) ? value.toString('utf8') : String(value || '');
@@ -131,6 +143,42 @@ function processRows(value) {
   })).filter(item => item.pid > 0);
 }
 
+function powershellProcessRows(value) {
+  const text = (Buffer.isBuffer(value) ? value.toString('utf8') : String(value || '')).replace(/^\uFEFF/, '').trim();
+  if (!text) return [];
+  const parsed = JSON.parse(text);
+  return (Array.isArray(parsed) ? parsed : [parsed]).map(row => {
+    const timestamp = Date.parse(row.startedAt || '');
+    return {
+      pid: Number(row.pid || 0),
+      parentPid: Number(row.parentPid || 0),
+      name: String(row.name || ''),
+      commandLine: String(row.commandLine || ''),
+      startedAt: Number.isFinite(timestamp) ? new Date(timestamp).toISOString() : null,
+    };
+  }).filter(item => item.pid > 0);
+}
+
+function windowsProcessRows(run = execFileSync) {
+  try {
+    const output = run('powershell.exe', ['-NoLogo', '-NoProfile', '-NonInteractive', '-EncodedCommand', WINDOWS_PROCESS_SCRIPT_BASE64], {
+      encoding: 'utf8', windowsHide: true, timeout: 8_000, maxBuffer: 4 * 1024 * 1024,
+    });
+    return powershellProcessRows(output);
+  } catch (powershellError) {
+    try {
+      const output = run('wmic.exe', ['process', 'where', WMIC_QUERY, 'get', 'ProcessId,ParentProcessId,CreationDate,Name,CommandLine', '/format:csv'], {
+        encoding: 'utf8', windowsHide: true, timeout: 8_000, maxBuffer: 2 * 1024 * 1024,
+      });
+      return processRows(output);
+    } catch (wmicError) {
+      const error = new Error(`Windows 프로세스 조회 실패: ${powershellError.message || powershellError}; ${wmicError.message || wmicError}`);
+      error.cause = powershellError;
+      throw error;
+    }
+  }
+}
+
 function commandArgument(commandLine, name) {
   const escaped = String(name || '').replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
   const match = String(commandLine || '').match(new RegExp(`(?:^|\\s)${escaped}\\s+(?:"([^"]+)"|'([^']+)'|(\\S+))`, 'i'));
@@ -151,6 +199,14 @@ function processSessionExternalId(processInfo = {}, provider = '') {
   return '';
 }
 
+function processInteractionMode(processInfo = {}, provider = '') {
+  const commandLine = String(processInfo.commandLine || processInfo.CommandLine || '');
+  if (provider === 'claude' && /(?:^|\s)(?:-p|--print)(?:\s|$)/i.test(commandLine)) return 'batch';
+  if (provider === 'codex' && /(?:^|\s)exec(?:\s|$)/i.test(commandLine)) return 'batch';
+  if (provider === 'gemini' && /(?:^|\s)(?:-p|--prompt)(?:\s|$)/i.test(commandLine)) return 'batch';
+  return 'interactive';
+}
+
 function pathlessSessionId(value) {
   const text = String(value || '').trim().replace(/^"|"$/g, '');
   if (!text) return '';
@@ -192,14 +248,13 @@ function selectAgentProcesses(rows, options = {}) {
     command: String(item.name || '').replace(/\.exe$/i, '').split(/[\\/]/).pop(),
     startedAt: item.startedAt,
     externalId: processSessionExternalId(item, item.provider),
+    interactionMode: processInteractionMode(item, item.provider),
   })).sort((a, b) => a.provider.localeCompare(b.provider) || a.pid - b.pid);
 }
 
 function utilityProcess(processInfo = {}) {
   const commandLine = String(processInfo.commandLine || processInfo.args || '');
-  return /Extract durable memory candidates from this Claude Code transcript tail/i.test(commandLine)
-    || /Reply with exactly OK\. Do not use tools\.?/i.test(commandLine)
-    || /You are a memory extraction/i.test(commandLine);
+  return /(?:^|\s)(?:-p|--print)\s+["']?(?:Extract durable memory candidates from this Claude Code transcript tail|Reply with exactly OK\. Do not use tools\.?|You are a memory extraction)/i.test(commandLine);
 }
 
 function utilitySession(session) {
@@ -230,6 +285,12 @@ function markRuntime(session, presence) {
   const existing = Array.isArray(session.runtimePresence) ? session.runtimePresence : [];
   if (!existing.some(item => item.id === presence.id)) existing.push(presence);
   session.runtimePresence = existing;
+  if (presence.interactionMode === 'batch') {
+    session.conversationStatus = session.status;
+    session.status = 'running';
+    session.statusDetail = `백그라운드 자율 실행 중 · PID ${presence.pid || '--'}`;
+    session.statusObserved = true;
+  }
   return session;
 }
 
@@ -417,10 +478,7 @@ class ProcessMonitor {
     try {
       let processes;
       if (this.platform === 'win32') {
-        const output = this.execFileSync('wmic.exe', ['process', 'where', WMIC_QUERY, 'get', 'ProcessId,ParentProcessId,CreationDate,Name,CommandLine', '/format:csv'], {
-          encoding: 'utf8', windowsHide: true, timeout: 8_000, maxBuffer: 2 * 1024 * 1024,
-        });
-        processes = selectAgentProcesses(processRows(output));
+        processes = selectAgentProcesses(windowsProcessRows(this.execFileSync));
       } else {
         const output = this.execFileSync('ps', ['-axo', 'pid=,ppid=,etime=,comm=,args='], { encoding: 'utf8', timeout: 8_000, maxBuffer: 2 * 1024 * 1024 });
         const environment = this.platform === 'darwin' ? 'macos' : 'linux';
@@ -438,6 +496,8 @@ module.exports = {
   ProcessMonitor,
   parseCsvRows,
   processRows,
+  powershellProcessRows,
+  windowsProcessRows,
   wmiDateToIso,
   providerFromWindowsProcess,
   providerFromPosixProcess,
@@ -445,6 +505,7 @@ module.exports = {
   elapsedSeconds,
   selectAgentProcesses,
   processSessionExternalId,
+  processInteractionMode,
   utilityProcess,
   runtimeLinkScore,
   bridgeLinkScore,

package/src/terminalHost.js

@@ -10,7 +10,8 @@ const { spawn } = require('child_process');
 const { endpointFor, safeWriteJson } = require('./bridgeServer');
 const { runBestEffort } = require('./diagnostics');
 
-const TERMINAL_HOST_PROTOCOL = 1;
+const TERMINAL_HOST_PROTOCOL = 2;
+const TERMINAL_HOST_RUNTIME = `node-pty-${require('node-pty/package.json').version}`;
 const MAX_FRAME_CHARS = 4 * 1024 * 1024;
 const AUTH_TIMEOUT_MS = 5_000;
 const REQUEST_TIMEOUT_MS = 15_000;
@@ -21,14 +22,94 @@ function sendFrame(socket, payload) {
   socket.write(`${JSON.stringify(payload)}\n`, 'utf8');
 }
 
-function readHostDiscovery(file, fileSystem = fs) {
+function incompatibleHostError(message, discovery) {
+  const error = new Error(message);
+  error.code = 'LOADTOAGENT_INCOMPATIBLE_TERMINAL_HOST';
+  error.discovery = discovery;
+  return error;
+}
+
+function readHostDiscovery(file, fileSystem = fs, expectedRuntime = TERMINAL_HOST_RUNTIME) {
   const parsed = JSON.parse(fileSystem.readFileSync(file, 'utf8'));
-  if (parsed?.protocol !== TERMINAL_HOST_PROTOCOL || !parsed.endpoint || !parsed.token) {
+  if (!parsed?.endpoint || !parsed.token || !Number.isSafeInteger(Number(parsed.pid)) || Number(parsed.pid) <= 0) {
     throw new Error('터미널 호스트 연결 정보가 올바르지 않습니다.');
   }
+  if (parsed.protocol !== TERMINAL_HOST_PROTOCOL || parsed.runtime !== expectedRuntime) {
+    throw incompatibleHostError('현재 앱과 호환되지 않는 터미널 호스트입니다.', parsed);
+  }
   return parsed;
 }
 
+function verifyHostDiscovery(discovery, timeoutMs = 1_500) {
+  return new Promise((resolve, reject) => {
+    const socket = net.createConnection(discovery.endpoint);
+    let buffer = '';
+    let settled = false;
+    const finish = error => {
+      if (settled) return;
+      settled = true;
+      clearTimeout(timer);
+      socket.destroy();
+      if (error) reject(error);
+      else resolve();
+    };
+    const timer = setTimeout(() => finish(new Error('이전 터미널 호스트 인증 시간이 초과되었습니다.')), timeoutMs);
+    socket.setNoDelay(true);
+    socket.on('connect', () => sendFrame(socket, { type: 'authenticate', token: discovery.token }));
+    socket.on('data', chunk => {
+      buffer += chunk.toString('utf8');
+      if (buffer.length > MAX_FRAME_CHARS) {
+        finish(new Error('이전 터미널 호스트 응답이 너무 큽니다.'));
+        return;
+      }
+      let newline;
+      while ((newline = buffer.indexOf('\n')) >= 0) {
+        const line = buffer.slice(0, newline).trim();
+        buffer = buffer.slice(newline + 1);
+        if (!line) continue;
+        try {
+          if (JSON.parse(line).type === 'ready') {
+            finish();
+            return;
+          }
+        } catch (_invalidFrame) {}
+      }
+    });
+    socket.on('error', finish);
+    socket.on('close', () => {
+      if (!settled) finish(new Error('이전 터미널 호스트 인증 연결이 닫혔습니다.'));
+    });
+  });
+}
+
+function processExists(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch (error) {
+    if (error?.code === 'ESRCH') return false;
+    if (error?.code === 'EPERM') return true;
+    throw error;
+  }
+}
+
+async function terminateHostProcess(discovery) {
+  const pid = Number(discovery?.pid);
+  if (!Number.isSafeInteger(pid) || pid <= 0 || pid === process.pid) {
+    throw new Error('교체할 터미널 호스트 프로세스 정보가 올바르지 않습니다.');
+  }
+  try {
+    process.kill(pid, 'SIGTERM');
+  } catch (error) {
+    if (error?.code !== 'ESRCH') throw error;
+  }
+  const deadline = Date.now() + 3_000;
+  while (processExists(pid)) {
+    if (Date.now() >= deadline) throw new Error(`이전 터미널 호스트가 종료되지 않았습니다: PID ${pid}`);
+    await new Promise(resolve => setTimeout(resolve, 50));
+  }
+}
+
 function activeSessions(manager) {
   return manager.list().filter(session => session.status === 'running' || session.status === 'starting');
 }
@@ -40,6 +121,7 @@ class TerminalHostServer {
     this.discoveryFile = path.resolve(options.discoveryFile || path.join(os.tmpdir(), 'loadtoagent-terminal-host.json'));
     this.endpoint = options.endpoint || endpointFor(this.platform, `${path.dirname(this.discoveryFile)}:terminal-host`);
     this.token = options.token || crypto.randomBytes(32).toString('hex');
+    this.runtime = String(options.runtime || TERMINAL_HOST_RUNTIME);
     this.server = null;
     this.clients = new Set();
     this.shutdownTimer = null;
@@ -57,6 +139,7 @@ class TerminalHostServer {
   info() {
     return {
       protocol: TERMINAL_HOST_PROTOCOL,
+      runtime: this.runtime,
       endpoint: this.endpoint,
       token: this.token,
       pid: process.pid,
@@ -207,7 +290,7 @@ class TerminalHostServer {
     if (this.server) runBestEffort('terminal-host-server-close', () => this.server.close());
     this.server = null;
     try {
-      const current = readHostDiscovery(this.discoveryFile);
+      const current = readHostDiscovery(this.discoveryFile, fs, this.runtime);
       if (current.pid === process.pid && current.token === this.token) fs.unlinkSync(this.discoveryFile);
     } catch (_missingOrReplacedDiscovery) {}
     if (this.platform !== 'win32' && fs.existsSync(this.endpoint)) {
@@ -263,6 +346,9 @@ class TerminalHostClient extends EventEmitter {
     this.discoveryFile = path.resolve(options.discoveryFile);
     this.spawnHost = typeof options.spawnHost === 'function' ? options.spawnHost : null;
     this.connectTimeoutMs = Number(options.connectTimeoutMs || 12_000);
+    this.expectedRuntime = String(options.expectedRuntime || TERMINAL_HOST_RUNTIME);
+    this.verifyHost = typeof options.verifyHost === 'function' ? options.verifyHost : verifyHostDiscovery;
+    this.terminateHost = typeof options.terminateHost === 'function' ? options.terminateHost : terminateHostProcess;
     this.socket = null;
     this.buffer = '';
     this.connected = false;
@@ -300,6 +386,16 @@ class TerminalHostClient extends EventEmitter {
       } catch (error) {
         lastError = error;
         this.resetSocket();
+        if (error?.code === 'LOADTOAGENT_INCOMPATIBLE_TERMINAL_HOST') {
+          let verified = false;
+          try {
+            await Promise.resolve(this.verifyHost(error.discovery));
+            verified = true;
+          } catch (verificationError) {
+            lastError = verificationError;
+          }
+          if (verified) await Promise.resolve(this.terminateHost(error.discovery));
+        }
       }
       if (!launched) {
         if (!this.spawnHost) throw lastError;
@@ -313,7 +409,7 @@ class TerminalHostClient extends EventEmitter {
   }
 
   connectExisting() {
-    const discovery = readHostDiscovery(this.discoveryFile);
+    const discovery = readHostDiscovery(this.discoveryFile, fs, this.expectedRuntime);
     return new Promise((resolve, reject) => {
       const socket = net.createConnection(discovery.endpoint);
       const timer = setTimeout(() => {
@@ -449,7 +545,10 @@ module.exports = {
   TerminalHostServer,
   TerminalHostClient,
   TERMINAL_HOST_PROTOCOL,
+  TERMINAL_HOST_RUNTIME,
   readHostDiscovery,
+  verifyHostDiscovery,
+  terminateHostProcess,
   launchTerminalHost,
   resolveTerminalHostExecutable,
 };

package/src/terminalManager.js

@@ -7,6 +7,7 @@ const crypto = require('crypto');
 const { EventEmitter } = require('events');
 const { spawn: spawnChild } = require('child_process');
 const { runBestEffort } = require('./diagnostics');
+const { ensureMacNodePtyRuntime } = require('./nodePtyRuntime');
 
 const MAX_SESSIONS = 24;
 const MAX_INPUT_CHARS = 128 * 1024;
@@ -40,7 +41,7 @@ function terminalEnvironment(extra = {}) {
   for (const [key, value] of Object.entries({ ...process.env, ...extra })) {
     if (value != null) env[key] = String(value);
   }
-  env.TERM = env.TERM || 'xterm-256color';
+  env.TERM = !env.TERM || String(env.TERM).toLowerCase() === 'dumb' ? 'xterm-256color' : env.TERM;
   env.COLORTERM = env.COLORTERM || 'truecolor';
   return env;
 }
@@ -142,6 +143,7 @@ function normalizeLaunchOptions(options = {}, platform = process.platform) {
     args,
     bridgeId: cleanText(options.bridgeId, 100),
     title: cleanText(options.title, 100),
+    transient: Boolean(options.transient),
     cols: numericDimension(options.cols, 120, 20, 500),
     rows: numericDimension(options.rows, 32, 5, 200),
   };
@@ -207,6 +209,7 @@ function publicSession(session, includeReplay = false) {
     tmuxPane: session.options.tmuxPane,
     provider: session.options.provider,
     bridgeId: session.options.bridgeId,
+    transient: Boolean(session.options.transient),
     background: session.options.type === 'agent',
     recoveredAfterHostRestart: Boolean(session.recoveredAfterHostRestart),
     recoverySkippedReason: session.recoverySkippedReason || '',
@@ -243,6 +246,7 @@ function restoredOptions(value = {}, platform = process.platform) {
     args: Array.isArray(value.args) ? value.args.slice(0, 80).map(item => cleanText(item, 2_000)) : [],
     bridgeId: cleanText(value.bridgeId, 100),
     title: cleanText(value.title, 100),
+    transient: Boolean(value.transient),
     cols: numericDimension(value.cols, 120, 20, 500),
     rows: numericDimension(value.rows, 32, 5, 200),
   };
@@ -356,7 +360,7 @@ class TerminalManager extends EventEmitter {
       this.fileSystem.mkdirSync(path.dirname(this.storeFile), { recursive: true });
       const payload = {
         version: STORE_VERSION,
-        sessions: [...this.sessions.values()].map(persistedSession),
+        sessions: [...this.sessions.values()].filter(session => !session.options.transient).map(persistedSession),
       };
       this.fileSystem.writeFileSync(temporary, JSON.stringify(payload), 'utf8');
       this.fileSystem.renameSync(temporary, this.storeFile);
@@ -367,7 +371,10 @@ class TerminalManager extends EventEmitter {
   }
 
   pty() {
-    if (!this.ptyModule) this.ptyModule = require('node-pty');
+    if (!this.ptyModule) {
+      ensureMacNodePtyRuntime({ platform: this.platform });
+      this.ptyModule = require('node-pty');
+    }
     return this.ptyModule;
   }
 
@@ -376,6 +383,11 @@ class TerminalManager extends EventEmitter {
     for (const session of this.sessions.values()) {
       if (!session.recoveryPending) continue;
       session.recoveryPending = false;
+      if (session.options.type === 'agent'
+        && /TERM is set to ["']?dumb["']?[\s\S]{0,500}Continue anyway\?/i.test(session.replay)) {
+        this.sessions.delete(session.id);
+        continue;
+      }
       if (!hasSafeAgentResume(session.options)) {
         session.status = 'exited';
         session.pid = null;
@@ -485,6 +497,12 @@ class TerminalManager extends EventEmitter {
         session.exitCode = Number.isFinite(event.exitCode) ? event.exitCode : null;
         session.signal = Number.isFinite(event.signal) ? event.signal : null;
         session.updatedAt = new Date().toISOString();
+        if (session.options.transient) {
+          this.sessions.delete(session.id);
+          this.emit('state', { change: 'removed', session: publicSession(session, false), sessions: this.list() });
+          this.persistNow();
+          return;
+        }
         this.persistNow();
         this.emitState('updated', session);
       });