elanous 0.2.40 → 0.2.42

package/src/task-orchestrator/surfaces/self-implement.ts

@@ -123,6 +123,8 @@ export interface PodChildEvidence {
   /** Bounded, redacted diagnostics copied only from a failed child terminal result. */
   error?: string;
   detail?: string;
+  /** Tail of the child detail, retained separately so long reports keep their final diagnostic lines. */
+  detailTail?: string;
   stderr?: string;
   /** Bounded, redacted complete Pod log tail. Separate from child stderr to avoid replacing stronger child facts. */
   podLogTail?: string[];
@@ -130,6 +132,8 @@ export interface PodChildEvidence {
   podLogUnavailable?: string;
   exitCode?: number;
   classification?: string;
+  /** Why the child assigned its failure classification; independent from the label itself. */
+  classificationBasis?: string;
   scopeEscape?: true;
   outOfScopeEdits?: unknown;
   /** SCOPE-ESCAPE-AS-REFINE — why held out-of-scope edits stop the run (deletion · protected path · cap). Present only with scopeEscape. */
@@ -156,6 +160,14 @@ export interface PodChildEvidence {
   goalPlanRevision?: SelfDevJobResult['goalPlanRevision'];
 }
 
+function utf8Tail(value: string, maxBytes: number): string {
+  const bytes = Buffer.from(value, 'utf8');
+  let start = Math.max(0, bytes.length - maxBytes);
+  // Move past continuation bytes so decoding starts at a complete UTF-8 code point.
+  while (start < bytes.length && (bytes[start]! & 0xc0) === 0x80) start++;
+  return bytes.subarray(start).toString('utf8');
+}
+
 const SCOPE_STOP_REASON_ORDER: readonly ScopeStopReason[] = SCOPE_STOP_REASONS;
 
 /** Stop reasons for held out-of-scope edits: the child's own `scopeStopReasons` (orchestrator decideScopeExpansion) plus
@@ -218,12 +230,18 @@ export function podChildEvidenceFromResult(o: Record<string, unknown>): PodChild
   const classification = scopeEscape ? 'scope-escape'
     : typeof abandoned?.classification === 'string' ? redactSecretText(abandoned.classification)
       : typeof o.failureClassification === 'string' ? redactSecretText(o.failureClassification) : undefined;
+  const rawClassificationBasis = abandoned?.classificationBasis ?? o.classificationBasis;
+  const classificationBasis = typeof rawClassificationBasis === 'string' && rawClassificationBasis.trim()
+    ? redactSecretText(rawClassificationBasis).slice(0, 200) : undefined;
   const evidence: PodChildEvidence = {
     ...(failedText(o.error) ? { error: failedText(o.error) } : {}),
     ...(failedText(o.detail) ? { detail: failedText(o.detail) } : {}),
+    ...(o.ok === false && typeof o.detail === 'string' && o.detail.trim()
+      ? { detailTail: utf8Tail(redactSecretText(o.detail), 4_096) } : {}),
     ...(failedText(o.stderr) ? { stderr: failedText(o.stderr) } : {}),
     ...(failureExitCode !== undefined ? { exitCode: failureExitCode } : {}),
     ...(classification ? { classification } : {}),
+    ...(classificationBasis ? { classificationBasis } : {}),
     ...(scopeEscape ? { scopeEscape: true, scopeStopReasons } : {}),
     ...(outOfScopeEdits !== undefined ? { outOfScopeEdits } : {}),
     ...(newScope ? { newScope } : {}),

package/src/tokens.ts

@@ -33,7 +33,32 @@ export function estimateTokens(text: string): number {
   return Math.ceil(ascii / 4 + wide / 2);
 }
 
-export interface MessageLike { role: string; content: string | unknown[] }
+export interface MessageLike {
+  role: string;
+  content: string | unknown[];
+  /** Opaque reasoning replayed by the Codex Responses adapter. */
+  codexReasoningItems?: unknown[];
+}
+
+function estimateStructuredTokens(value: unknown, ancestors = new Set<object>()): number {
+  if (typeof value === 'string') return estimateTokens(value);
+  if (value === null || typeof value !== 'object') return 1;
+  if (ancestors.has(value)) return 200; // malformed cyclic extension: conservative block floor
+  ancestors.add(value);
+  let total = 2; // JSON brackets/braces
+  if (Array.isArray(value)) {
+    total += Math.ceil(value.length / 4); // commas
+    for (const item of value) total += estimateStructuredTokens(item, ancestors);
+  } else {
+    const entries = Object.entries(value);
+    total += Math.ceil(entries.length / 4); // commas
+    for (const [key, item] of entries) {
+      total += estimateTokens(key) + 1 + estimateStructuredTokens(item, ancestors);
+    }
+  }
+  ancestors.delete(value);
+  return total;
+}
 
 export function estimateMessagesTokens(messages: MessageLike[]): number {
   let total = 0;
@@ -44,7 +69,12 @@ export function estimateMessagesTokens(messages: MessageLike[]): number {
       for (const block of m.content) {
         if (!block || typeof block !== 'object') continue;
         const obj = block as Record<string, unknown>;
-        if (typeof obj.text === 'string') {
+        if (obj.type === 'tool_use' || obj.type === 'tool_result') {
+          // These payloads are replayed as structured JSON; fixed block cost
+          // misses large args/results. Retain the old 200-token floor for
+          // tiny blocks so many small calls cannot under-trigger compaction.
+          total += Math.max(200, estimateStructuredTokens(obj));
+        } else if (typeof obj.text === 'string') {
           total += estimateTokens(obj.text);
         } else if (typeof obj.content === 'string') {
           // Wave 2 (2026-05-04) · tool_result block content matters
@@ -58,6 +88,9 @@ export function estimateMessagesTokens(messages: MessageLike[]): number {
         }
       }
     }
+    if (m.role === 'assistant' && m.codexReasoningItems?.length) {
+      total += estimateStructuredTokens(m.codexReasoningItems);
+    }
   }
   return total;
 }

package/src/tool-runtime/agent-runtime.ts

@@ -10,6 +10,7 @@ export const agentRuntime: ToolRuntime<Record<string, unknown>, AgentToolResult>
   spec: buildAgentTool(),
   async run(req, ctx) {
     return await dispatchAgent(req, {
+      ...(ctx.parentSessionId ? { parentSessionId: ctx.parentSessionId } : {}),
       ...(ctx.agentCwd ? { cwd: ctx.agentCwd } : {}),
       hostTools: ctx.agentHostTools,
       dispatchTool: ctx.agentDispatchTool,

package/src/tool-runtime/elanous-skills-list-runtime.ts

@@ -15,6 +15,7 @@ import { join } from 'node:path';
 import { readdir, readFile } from 'node:fs/promises';
 import { defaultSkillDirs } from '../user-config.js';
 import { SKILLS_LIST_DESCRIPTION } from '../onboarding/entry-hints.js';
+import { normalizeSkillName } from '../skills/name-match.js';
 import type { LLMToolSpec } from '../llm.js';
 import type { ToolRuntime } from './types.js';
 
@@ -69,6 +70,7 @@ export async function dispatchElanousSkillsList(
   const skillsDir = dirs[0] ?? ''; // 단일 경로 계약 보존(첫 dir)·전체는 skillsDirs
   const label = dirs.join(', ');   // 표시용(다중 루트면 콤마 결합)
   const query = (args.query ?? '').toLowerCase();
+  const normalizedQuery = normalizeSkillName(query);
   const seen = new Set<string>();
   const entries: ElanousSkillsListEntry[] = [];
   const errors: string[] = [];
@@ -91,7 +93,9 @@ export async function dispatchElanousSkillsList(
     }
   }
   let filtered = entries;
-  if (query.length > 0) filtered = entries.filter((e) => e.name.toLowerCase().includes(query));
+  if (query.length > 0) filtered = entries.filter((e) =>
+    e.name.toLowerCase().includes(query)
+    || (normalizedQuery.length > 0 && normalizeSkillName(e.name).includes(normalizedQuery)));
   filtered.sort((a, b) => a.name.localeCompare(b.name));
   // 모든 dir 열거 실패(산출 0)면 실패 보고(단일 dir 부재 계약 보존).
   if (entries.length === 0 && errors.length > 0 && errors.length === dirs.length) {

package/src/tool-runtime/skill-exec-runtime.ts

@@ -3,6 +3,8 @@ import * as harnessSkillExec from '../harness/skill-exec.js';
 import { invokeResearch } from '../research-bridge/invoke.js';
 import * as skillIndex from '../skills/index.js';
 import type { SkillIndexEntry } from '../skills/index.js';
+import { dirname } from 'node:path';
+import { resolveSkillName } from '../skills/name-match.js';
 import { getUserConfig } from '../user-config.js';
 import type { LLMToolSpec } from '../llm.js';
 import type { ToolRuntime } from './types.js';
@@ -17,7 +19,7 @@ export interface SkillExecRunOptions {
 }
 
 export interface SkillExecArgs {
-  /** Exact name of the skill to execute. */
+  /** Installed skill name; spaces/punctuation may be omitted if the match is unique. */
   skill: string;
   /** Task text passed verbatim to the named skill. */
   task: string;
@@ -33,6 +35,8 @@ export interface SkillExecResult extends Record<string, unknown> {
 
 export interface SkillExecDiscoveryDeps {
   discoverPlugin?: (gap: string, deps?: { signal?: AbortSignal }) => Promise<{ card: string }>;
+  /** Test seam for the bounded plugin-discovery follow-up. */
+  discoveryTimeoutMs?: number;
 }
 
 export type SkillExecIndexProvider = () => readonly SkillIndexEntry[];
@@ -71,13 +75,13 @@ function obtainSkillIndex(): readonly SkillIndexEntry[] {
 export function buildSkillExecTool(): LLMToolSpec {
   return {
     name: 'skill_exec',
-    description: 'Execute one explicitly named allowlisted skill with the supplied task. If you do not know the exact skill name, call elanous_skills_list first. Does not infer a skill name.',
+    description: 'Execute one explicitly named allowlisted skill with the supplied task. Names may omit spaces or punctuation (for example, "krflow" resolves to "kr-flow") only when the installed match is unique. Call elanous_skills_list when uncertain.',
     parameters: {
       type: 'object',
       properties: {
         skill: {
           type: 'string',
-          description: 'Exact name of the skill to execute.',
+          description: 'Installed skill name; spaces and punctuation may be omitted when the match is unique.',
         },
         task: {
           type: 'string',
@@ -95,9 +99,19 @@ export async function dispatchSkillExec(
   deps: SkillExecDiscoveryDeps = {},
   options: SkillExecRunOptions = {},
 ): Promise<SkillExecResult> {
-  const { skill, task } = args;
+  const { skill: requestedSkill, task } = args;
+  if (requestedSkill !== requestedSkill.trim()) {
+    return { skill: requestedSkill, ok: false, output: REJECT_OUTPUT(requestedSkill) };
+  }
   const extra = getUserConfig().skillRouter.harnessExecAllowlist;
   const index = obtainSkillIndex();
+  const resolution = resolveSkillName(requestedSkill, index);
+  const skill = resolution.entry?.name ?? requestedSkill;
+  if (resolution.ambiguous.length > 0) {
+    const candidates = resolution.ambiguous.map((entry) => entry.name).sort().join(', ');
+    return { skill: requestedSkill, ok: false, output: `스킬 이름이 여러 항목과 일치합니다: ${candidates}. elanous_skills_list에서 정확한 이름을 골라 다시 호출하세요.` };
+  }
+  const selected = resolution.entry;
   const allowlist = harnessSkillExec.resolveHarnessExecAllowlist(
     extra,
     (rejected, reason) => observe('allowlist-reject', { skill: rejected, reason }),
@@ -163,13 +177,18 @@ export async function dispatchSkillExec(
   let interruption: 'skill-exec-timeout' | 'skill-exec-cancelled' | undefined;
   try {
     const outcome = await Promise.race([
-      invokeResearch(task, { skill, signal: child.signal, onProgress: (delta) => {
-        progressChunks += 1;
-        progressBytes += delta.length;
-        if (progressChunks === 1 || progressChunks % 32 === 0) {
-          observe('progress', { skill, progressChunks, progressBytes });
-        }
-      } }).then((value) => ({ result: value })),
+      invokeResearch(task, {
+        skill,
+        ...(selected ? { skillRootDir: dirname(selected.skillDir) } : {}),
+        signal: child.signal,
+        onProgress: (delta) => {
+          progressChunks += 1;
+          progressBytes += delta.length;
+          if (progressChunks === 1 || progressChunks % 32 === 0) {
+            observe('progress', { skill, progressChunks, progressBytes });
+          }
+        },
+      }).then((value) => ({ result: value })),
       interrupted.then((reason) => ({ interruption: reason })),
     ]);
     settled = true;
@@ -195,10 +214,11 @@ export async function dispatchSkillExec(
   // A low-quality research result is a capability gap. Keep the original failure,
   // and attach a bounded discovery card rather than silently switching tools.
   let discoveryCard: string | undefined;
-  if (!result.ok && /\b(?:no data|no evidence|missing|unavailable|not found|empty)\b|(?:자료가 없|데이터가 없|자료 부족|미확인|찾지 못)/i
+  const localSkillMissing = /not found under (?:~\/\.claude\/skills|\/)/i.test(result.error ?? '');
+  if (!result.ok && !localSkillMissing && /\b(?:no data|no evidence|missing|unavailable|not found|empty)\b|(?:자료가 없|데이터가 없|자료 부족|미확인|찾지 못)/i
     .test(`${result.output} ${result.error ?? ''}`)) {
     const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(new Error('plugin discovery time budget exhausted')), 10_000);
+    const timer = setTimeout(() => controller.abort(new Error('plugin discovery time budget exhausted')), deps.discoveryTimeoutMs ?? 10_000);
     try {
       const discovery = deps.discoverPlugin ?? (await import('../research/plugin-discovery.js')).discoverResearchPlugin;
       const found = await discovery(task, { signal: controller.signal });

package/src/tool-runtime/types.ts

@@ -56,6 +56,7 @@ export interface ToolRuntimeContext {
    *  supported (e.g. streaming fetch, long-running agent calls). */
   signal?: AbortSignal;
   /** Parent catalog and dispatcher inherited by an Agent runtime's child. */
+  parentSessionId?: string;
   agentHostTools?: LLMToolSpec[];
   /** Host-selected working directory for an Agent spawned through MCP. */
   agentCwd?: string;

package/src/tui/entry.ts

@@ -346,15 +346,23 @@ export async function showNextTui(options: NextTuiOptions = {}): Promise<void> {
     const sidetabLines = sidetabOpen
       ? sidetabApi!.formatSidetabLines(sidetabRows, sidetabSelected, sidetabWidth, Math.max(1, rows - 1), sidetabMode)
       : [];
-    const screenLines = sidetabOpen
-      ? lines.map((line, index) => `${sidetabLines[index] ?? ' '.repeat(sidetabWidth)}│${line}`)
-      : lines;
+    const screenLineCount = sidetabOpen ? Math.max(lines.length, sidetabLines.length) : lines.length;
+    const screenLines = Array.from({ length: screenLineCount }, (_, index) => {
+      const line = lines[index] ?? '';
+      return sidetabOpen ? `${sidetabLines[index] ?? ' '.repeat(sidetabWidth)}│${line}` : line;
+    });
     process.stdout.write(`\x1b[H\x1b[2J${screenLines.join('\n')}\x1b[${promptRow};${prompt.cursorCol + (sidetabOpen ? sidetabWidth + 1 : 0)}H\x1b[?25h`);
     if (sidetabAttachments?.hasModal() && !paintingCoordinatorFrame) sidetabAttachments.refresh();
   };
 
   const ensureSidetabAttachments = async (): Promise<void> => {
     if (sidetabAttachments) return;
+    const installer = await import('../agent-mission/tool-install.js') as unknown as {
+      detectAgentCli?: (agent: 'codex' | 'claude') => Promise<{
+        agent: 'codex' | 'claude'; installed: boolean; version: string | null;
+        login: 'ready' | 'needed' | 'unknown'; message: string;
+      }>;
+    };
     sidetabAttachments = (await import('./sidetab/attach.js')).createSidetabAttachmentController({
       drawBase: () => {
         paintingCoordinatorFrame = true;
@@ -362,6 +370,7 @@ export async function showNextTui(options: NextTuiOptions = {}): Promise<void> {
       },
       termSize: () => ({ cols: process.stdout.columns || 80, rows: process.stdout.rows || 24 }),
       setStatus: (message) => { status = safeStatusText(message); },
+      ...(installer.detectAgentCli ? { detectAgentCli: installer.detectAgentCli } : {}),
       drawRemoteFrame: (frame) => {
         sidetabRemoteFrame = frame || null;
         if (sidetabRemoteFrame !== null) {
@@ -573,7 +582,7 @@ export async function showNextTui(options: NextTuiOptions = {}): Promise<void> {
       .then(({ runLocalChatTurn, onLocalChatBackgroundStatus, onLocalChatSelfHealthStatus }) => {
         observeSession(turnSessionId, onLocalChatBackgroundStatus, onLocalChatSelfHealthStatus);
         let firstResponseSeen = false;
-        return runLocalChatTurn(turnSessionId, turnText, abort.signal, undefined, undefined, (delta) => {
+        return runLocalChatTurn(turnSessionId, turnText, abort.signal, undefined, undefined, (delta, replace = false) => {
           // 스트림 텍스트 = 진전 신호 — 마지막 진전 시각을 올린다(녹음기 없으면 아무 일도 안 한다).
           reportTuiProgress();
           // 첫 응답 경계: 첫 스트림 델타에서 턴 시작 트레이스를 닫는다(endedBy=stream-open).
@@ -583,7 +592,7 @@ export async function showNextTui(options: NextTuiOptions = {}): Promise<void> {
           }
           // The first model token is visible before the final JSONL frame. Keep only
           // a bounded tail until session history becomes the canonical display.
-          streamingReply = (streamingReply + delta).slice(-32_768);
+          streamingReply = replace ? delta.slice(-32_768) : (streamingReply + delta).slice(-32_768);
           activity = streamReplyLines(streamingReply, process.stdout.columns || 80);
           const now = performance.now();
           if (streamRenderAt === 0 || now - streamRenderAt >= 33) {
@@ -690,8 +699,9 @@ export async function showNextTui(options: NextTuiOptions = {}): Promise<void> {
   try {
     {
       const { createNextTuiWakeup, setNextTuiWakeupTool } = await import('../tui-client/next-wakeup.js');
-      const { setNextSidetabHandler } = await import('../tui-client/local-chat-turn.js');
+      const { setNextSidetabHandler, setNextSidetabIpcEnabled } = await import('../tui-client/local-chat-turn.js');
       const { createNextSidetabHostHandler } = await import('./sidetab/nl-tool.js');
+      setNextSidetabIpcEnabled(true);
       wakeup = createNextTuiWakeup({
         isTurnRunning: () => busy,
         getBufferText: () => editor.text,
@@ -720,6 +730,7 @@ export async function showNextTui(options: NextTuiOptions = {}): Promise<void> {
         attach: async (row) => { await ensureSidetabAttachments(); const ok = sidetabAttachments!.select(row); render(); return { ok, action: 'attach', target: row.id }; },
         detach: () => { if (sidetabAttachments?.hasRemoteView()) sidetabAttachments.showMain(); else if (sidetabAttachments?.hasModal()) { sidetabAttachments.handleKey({ name: '\\', ctrl: true, shift: false, raw: '' }); sidetabAttachments.handleKey({ name: 'd', ctrl: false, shift: false, raw: 'd' }); } render(); return { ok: true, action: 'detach' }; },
         spawn: async (character) => { await ensureSidetabAttachments(); const ok = sidetabAttachments!.spawn(character); refreshSidetabRows(); render(); return { ok, action: 'new', character }; },
+        runMission: async (agent, mission) => { await ensureSidetabAttachments(); const result = await sidetabAttachments!.runMission(agent, mission); refreshSidetabRows(); render(); return result; },
         kill: async (row) => { await ensureSidetabAttachments(); const ok = sidetabAttachments!.kill(row); refreshSidetabRows(); render(); return { ok, action: 'kill', target: row.id }; },
       }));
       const gate = wakeup.gate;
@@ -1258,10 +1269,15 @@ export async function showNextTui(options: NextTuiOptions = {}): Promise<void> {
         }
         if (submitted === '/help' || submitted === '/help next') {
           activity.push(
+            'Commands',
             'Next TUI: /side · /sidetab — 세션/PTY 목록',
             '사이드탭: Ctrl+\\ 토글 · ↑↓ 선택 · 빈 prompt Enter=attach · /side new · /side kill',
             '새 PTY: s shell · e elanous · c codex 구독 · l claude code 구독',
             'PTY 분리: Ctrl+\\ 후 d · /term help 는 읽기 전용 목록 명령',
+            '',
+            'Keys',
+            'Enter 전송 · Esc 취소 · PgUp/PgDn 대화 스크롤 · Ctrl+Q 종료',
+            'Ctrl+\\ 사이드탭 토글 · ↑/↓ 목록 이동 · Esc 입력으로 돌아오기',
           );
           status = 'Enter 전송';
           render();
@@ -1383,8 +1399,9 @@ export async function showNextTui(options: NextTuiOptions = {}): Promise<void> {
       const { setNextTuiWakeupTool } = await import('../tui-client/next-wakeup.js');
       setNextTuiWakeupTool(null);
     }
-    const { setNextSidetabHandler } = await import('../tui-client/local-chat-turn.js');
+    const { setNextSidetabHandler, setNextSidetabIpcEnabled } = await import('../tui-client/local-chat-turn.js');
     setNextSidetabHandler(null);
+    setNextSidetabIpcEnabled(false);
     turnAbort?.abort();
     await turnDone;
     backgroundSubscription.stop?.();

package/src/tui/sidetab/attach.ts

@@ -1,4 +1,5 @@
 import { randomUUID } from 'node:crypto';
+import { join } from 'node:path';
 import { resolveBackendSpawn, claudeBackend, codexBackend } from '../../agent-mission/driver.js';
 import { DisplayCoordinator } from '../../display/coordinator.js';
 import { createDisplayEventBus } from '../../display/events.js';
@@ -6,6 +7,7 @@ import { createTerminalModalRouter } from '../../terminal/terminal-modal-router.
 import { getSessionCwd } from '../../session/working-dir.js';
 import { TerminalSessionRegistry, type TerminalSession } from '../../terminal/session-registry.js';
 import { requestRemotePtyControl } from '../../pty-shell/pty-control-ipc.js';
+import { runVisibleAgentMission } from '../../sidetab-core/visible-agent-mission.js';
 import type { Key } from '../../tui.js';
 import type { SidetabRow } from './list.js';
 
@@ -16,6 +18,7 @@ export interface SidetabAttachmentController {
   select(row: SidetabRow): boolean;
   showMain(): void;
   spawn(character: SidetabCharacter): boolean;
+  runMission(agent: 'codex' | 'claude', mission: string): Promise<Awaited<ReturnType<typeof runVisibleAgentMission>>>;
   kill(row: SidetabRow): boolean;
   handleKey(key: Key): boolean;
   hasModal(): boolean;
@@ -24,11 +27,21 @@ export interface SidetabAttachmentController {
   close(): void;
 }
 
+export interface AgentCliDetection {
+  agent: 'codex' | 'claude';
+  installed: boolean;
+  version: string | null;
+  login: 'ready' | 'needed' | 'unknown';
+  message: string;
+}
+
 export function createSidetabAttachmentController(deps: {
   drawBase(): void;
   termSize(): { cols: number; rows: number };
   setStatus(message: string): void;
   drawRemoteFrame(frame: string): void;
+  /** Owned by OPT; a missing detector keeps the hook inert until its API lands. */
+  detectAgentCli?(agent: 'codex' | 'claude'): Promise<AgentCliDetection>;
 }): SidetabAttachmentController {
   const eventBus = createDisplayEventBus();
   const coordinator = new DisplayCoordinator({
@@ -45,6 +58,7 @@ export function createSidetabAttachmentController(deps: {
   let remoteFrameTimer: ReturnType<typeof setInterval> | null = null;
   let remoteFramePending = false;
   let remoteHasFrame = false;
+  let lastSpawnedSession: TerminalSession | null = null;
 
   const stopRemote = (): void => {
     if (remoteFrameTimer !== null) clearInterval(remoteFrameTimer);
@@ -164,6 +178,7 @@ export function createSidetabAttachmentController(deps: {
           }
         },
       }, { termCols: cols, termRows: rows });
+      lastSpawnedSession = session;
       if (character === 'codex' || character === 'claude') {
         deps.setStatus(`${character} 실행 · agent-mission 구독 경로 scrub 적용(${unsetEnv?.length ?? 0}개 env 제거)`);
       }
@@ -204,6 +219,38 @@ export function createSidetabAttachmentController(deps: {
     },
     showMain,
     spawn,
+    async runMission(agent, mission) {
+      if (deps.detectAgentCli) {
+        let detection: AgentCliDetection;
+        try { detection = await deps.detectAgentCli(agent); }
+        catch (error) {
+          const message = `${agent} CLI 확인에 실패했습니다: ${error instanceof Error ? error.message : String(error)}`;
+          deps.setStatus(message);
+          return { ok: false, path: '', promptReady: false, missionVisible: false, completionMarker: false, error: message };
+        }
+        if (!detection.installed) {
+          const message = `${detection.message} · 설치 확인 후 미션을 다시 요청하세요`;
+          deps.setStatus(message);
+          return { ok: false, path: '', promptReady: false, missionVisible: false, completionMarker: false, error: message };
+        }
+      }
+      lastSpawnedSession = null;
+      if (!spawn(agent) || !lastSpawnedSession?.modal) {
+        return { ok: false, path: '', promptReady: false, missionVisible: false, completionMarker: false, error: `${agent} side-tab PTY could not start` };
+      }
+      const session = lastSpawnedSession;
+      const outputPath = join(session.cwd, '.elanous', 'mission-results', `sidetab-${Date.now()}.md`);
+      const backend = agent === 'codex' ? codexBackend : claudeBackend;
+      const result = await runVisibleAgentMission({
+        pty: session.modal,
+        mission,
+        outputPath,
+        handleTrust: (screen, write) => backend.handleTrust?.(screen, write) ?? false,
+      });
+      showMain();
+      deps.setStatus(result.ok ? `미션 결과 확인 · ${result.path}` : `미션 확인 실패 · ${result.error}`);
+      return result;
+    },
     kill(row) {
       if (row.currentProcess) {
         deps.setStatus('현재 TUI 세션은 사이드탭에서 종료할 수 없습니다');

package/src/tui/sidetab/list.ts

@@ -1,2 +1,47 @@
 /** Compatibility entry point for existing Next TUI callers. Shared behavior lives in sidetab-core. */
 export * from '../../sidetab-core/model.js';
+import {
+  formatSidetabLines as formatCoreSidetabLines,
+  loadSidetabRows as loadCoreSidetabRows,
+  type SidetabRow,
+} from '../../sidetab-core/model.js';
+import { listPtyManifestRows } from '../../pty-shell/pty-manifest.js';
+import { formatSidetabPeekLines } from './peek.js';
+
+type PreviewSidetabRow = SidetabRow & { readonly previewSource?: string };
+
+/** Attach the latest manifest snapshot without changing the shared row contract. */
+export function loadSidetabRows(all = false, currentSessionId?: string): SidetabRow[] {
+  const snapshots = new Map<string, string>(listPtyManifestRows().map((row) => [row.id, row.snapshot || row.frame] as const));
+  return loadCoreSidetabRows(all, currentSessionId).map((row) => ({
+    ...row,
+    previewSource: snapshots.get(row.id) ?? '',
+  }));
+}
+
+/** Render the core list and reserve a bounded tail preview for the selected PTY row. */
+export function formatSidetabLines(
+  rows: readonly SidetabRow[],
+  selected: number,
+  width: number,
+  height = Number.POSITIVE_INFINITY,
+  mode: 'list' | 'new' = 'list',
+): string[] {
+  const selectedRow = rows[selected] as PreviewSidetabRow | undefined;
+  const peekLines = mode === 'list' && selectedRow
+    ? formatSidetabPeekLines(selectedRow.previewSource ?? '', width)
+    : [];
+  if (peekLines.length === 0) return formatCoreSidetabLines(rows, selected, width, height, mode);
+
+  const reservedRows = peekLines.length + 1;
+  const coreLines = formatCoreSidetabLines(rows, selected, width, Math.max(0, height - reservedRows), mode);
+  // The core formatter reserves the leading ` › ` token for selection; a
+  // session label may itself contain `›`, so searching anywhere in the line
+  // can place the preview under the wrong row.
+  const selectedLine = coreLines.findIndex((line) => line.startsWith(' › '));
+  if (selectedLine < 0) return coreLines;
+
+  const lines = [...coreLines];
+  lines.splice(selectedLine + 1, 0, ' '.repeat(width), ...peekLines);
+  return Number.isFinite(height) ? lines.slice(0, Math.max(0, Math.floor(height))) : lines;
+}

package/src/tui/sidetab/nl-tool.ts

@@ -1,136 +1,2 @@
-import type { LLMToolSpec } from '../../llm.js';
-import type { SidetabRow } from './list.js';
-
-export const NEXT_SIDETAB_TOOL_NAME = 'NextSidetab';
-const CALL = 'elanous.sidetab.call';
-const RESULT = 'elanous.sidetab.result';
-
-export type NextSidetabAction = 'list' | 'switch' | 'attach' | 'detach' | 'new' | 'kill';
-export interface NextSidetabRequest {
-  action: NextSidetabAction;
-  target?: string;
-  character?: 'shell' | 'elanous';
-  confirm?: boolean;
-}
-export interface NextSidetabCall { type: typeof CALL; callId: string; request: NextSidetabRequest }
-export interface NextSidetabResult { type: typeof RESULT; callId: string; result: unknown }
-export type NextSidetabHandler = (request: NextSidetabRequest) => Promise<unknown>;
-export interface NextSidetabHostDeps {
-  rows(): readonly SidetabRow[] | Promise<readonly SidetabRow[]>;
-  selected(): number;
-  switchSession(row: SidetabRow): Promise<unknown>;
-  attach(row: SidetabRow): Promise<unknown>;
-  detach(): unknown;
-  spawn(character: 'shell' | 'elanous'): unknown;
-  kill(row: SidetabRow): unknown;
-}
-export interface NextSidetabIpcProcess {
-  send?: (message: unknown) => boolean | void;
-  on(event: 'message', listener: (message: unknown) => void): unknown;
-}
-
-export const nextSidetabToolSpec: LLMToolSpec = {
-  name: NEXT_SIDETAB_TOOL_NAME,
-  description: 'Control the Next TUI side tab: list/view sessions and PTYs, switch sessions, attach or detach, start a local shell or elanous PTY, or kill a PTY. Ask the user to confirm before calling kill with confirm=true. Starting coding agents is not supported.',
-  parameters: {
-    type: 'object',
-    properties: {
-      action: { type: 'string', enum: ['list', 'switch', 'attach', 'detach', 'new', 'kill'] },
-      target: { type: 'string', description: 'Optional exact or partial row id/label; required for targeted actions.' },
-      character: { type: 'string', enum: ['shell', 'elanous'], description: 'Only used with action=new.' },
-      confirm: { type: 'boolean', description: 'Must be true only after the user explicitly confirmed killing the selected PTY.' },
-    },
-    required: ['action'],
-    additionalProperties: false,
-  },
-};
-
-export function isNextSidetabCall(value: unknown): value is NextSidetabCall {
-  const call = value as Partial<NextSidetabCall> | null;
-  return Boolean(call && call.type === CALL && typeof call.callId === 'string'
-    && call.request && typeof call.request === 'object');
-}
-
-export async function answerNextSidetabCall(handler: NextSidetabHandler, call: NextSidetabCall): Promise<NextSidetabResult> {
-  try { return { type: RESULT, callId: call.callId, result: await handler(call.request) }; }
-  catch (error) {
-    return { type: RESULT, callId: call.callId, result: { error: error instanceof Error ? error.message : String(error) } };
-  }
-}
-
-export function createNextSidetabHostHandler(deps: NextSidetabHostDeps): NextSidetabHandler {
-  return async (request) => {
-    if (!request || !['list', 'switch', 'attach', 'detach', 'new', 'kill'].includes(request.action)) {
-      return { error: '지원하지 않는 사이드탭 동작입니다' };
-    }
-    if (request.action === 'new') {
-      if (request.character !== 'shell' && request.character !== 'elanous') return { error: 'character는 shell 또는 elanous여야 합니다' };
-      return deps.spawn(request.character);
-    }
-    if (request.action === 'detach') return deps.detach();
-    const rows = await deps.rows();
-    if (request.action === 'list') return rows.map(({ id, label, kind, badge, sessionId }) => ({ id, label, kind, badge, ...(sessionId ? { sessionId } : {}) }));
-    const target = request.target?.trim();
-    const exact = target ? rows.find((item) => item.id === target)
-      ?? rows.find((item) => item.label.toLowerCase() === target.toLowerCase()) : undefined;
-    const partial = target && !exact ? rows.filter((item) => item.label.toLowerCase().includes(target.toLowerCase())) : [];
-    if (partial.length > 1) return { error: `사이드탭 항목이 여러 개 일치합니다: ${target}` };
-    const row = exact ?? partial[0] ?? (target ? undefined : rows[deps.selected()]);
-    if (!row) return { error: target ? `사이드탭 항목을 찾지 못했습니다: ${target}` : '선택된 사이드탭 항목이 없습니다' };
-    if (request.action === 'switch') return row.kind === 'tui' ? deps.switchSession(row) : { error: 'Next TUI 세션만 전환할 수 있습니다' };
-    if (request.action === 'attach') return deps.attach(row);
-    if (row.currentProcess) return { error: '현재 TUI 세션은 사이드탭에서 종료할 수 없습니다' };
-    if (request.confirm !== true) return { needsConfirmation: true, message: `PTY 종료 확인 필요: ${row.label}` };
-    return deps.kill(row);
-  };
-}
-
-export function createReplNextSidetabTool(
-  proc: NextSidetabIpcProcess,
-  env: NodeJS.ProcessEnv = process.env,
-  timeoutMs = 15_000,
-): { spec: LLMToolSpec; dispatch: (args: Record<string, unknown>) => Promise<unknown> } | null {
-  if (env.ELANOUS_NEXT_TUI_SIDETAB_IPC !== '1' || typeof proc.send !== 'function') return null;
-  const send = proc.send.bind(proc);
-  const waiting = new Map<string, (result: unknown) => void>();
-  let sequence = 0;
-  const listener = (message: unknown): void => {
-    const result = message as Partial<NextSidetabResult> | null;
-    if (!result || result.type !== RESULT || typeof result.callId !== 'string') return;
-    const resolve = waiting.get(result.callId);
-    if (!resolve) return;
-    waiting.delete(result.callId);
-    resolve(result.result);
-  };
-  proc.on('message', listener);
-  return {
-    spec: nextSidetabToolSpec,
-    dispatch: (args) => new Promise((resolve) => {
-      const callId = `s${++sequence}`;
-      const timer = setTimeout(() => {
-        if (!waiting.delete(callId)) return;
-        resolve({ error: 'Next TUI did not answer the side-tab request' });
-      }, timeoutMs);
-      waiting.set(callId, (result) => { clearTimeout(timer); resolve(result); });
-      try {
-        send({ type: CALL, callId, request: args as unknown as NextSidetabRequest } satisfies NextSidetabCall);
-      } catch (error) {
-        waiting.delete(callId);
-        clearTimeout(timer);
-        resolve({ error: `Next TUI IPC send failed: ${error instanceof Error ? error.message : String(error)}` });
-      }
-    }),
-  };
-}
-
-export function registerNextSidetabReplTool(
-  specs: LLMToolSpec[],
-  dispatchByName: Map<string, (args: Record<string, unknown>) => Promise<unknown>>,
-  proc: NextSidetabIpcProcess,
-  env: NodeJS.ProcessEnv = process.env,
-): void {
-  const tool = createReplNextSidetabTool(proc, env);
-  if (!tool) return;
-  specs.push(tool.spec);
-  dispatchByName.set(tool.spec.name, tool.dispatch);
-}
+/** Compatibility entry point for Next TUI callers. Shared contracts and policy live in sidetab-core. */
+export * from '../../sidetab-core/model.js';