elanous 0.2.0 → 0.2.4

package/src/chat/index.ts

@@ -413,12 +413,13 @@ export interface SlashCommand {
 
 // Default commands available in the input
 export const SLASH_COMMANDS: SlashCommand[] = [
+  { name: 'directive', aliases: [], description: 'Record a directive as a Linear issue' },
   { name: 'run-skill', aliases: ['rs', 'run'], description: 'Execute a skill via its SKILL.md prompt' },
   { name: 'ad', aliases: [], description: 'Create an advertising plan from a URL, brief, or attached image' },
   // B4 — craft rulebook verdict, same resolution as `elanous repo design-check`
   //   and the PWA `/design-check` panel. Listed (not baselined as hidden) on
   //   purpose: a surface nobody can discover is not a surface.
-  { name: 'design',    aliases: ['design-check'], description: 'Craft rulebooks — 이 저장소 DESIGN.md 가 선언한 규칙집 · 못 찾은 것 · elanous 가 주는데 선언 안 된 것. /design [--declared]', subcommands: ['--declared'] },
+  { name: 'design',    aliases: ['design-check'], description: 'Craft rulebooks — 이 저장소 DESIGN.md 가 선언한 규칙집 · 못 찾은 것 · elanous 가 주는데 선언 안 된 것. /design [--declared] · /design pick [번호|id] 디자인 방향 선택', subcommands: ['--declared', 'pick'] },
   { name: 'provider',  aliases: ['p'],          description: 'LLM providers — /provider (list) · next (cycle, also Alt+M / pill click) · use <name> · pick (visual picker) · reset', subcommands: ['next', 'use', 'pick', 'picker', 'menu', 'reset', 'list'] },
   { name: 'reasoning', aliases: ['r', 'think'],  description: 'Reasoning level (codex effort + summary, anthropic extended-thinking budget) — /reasoning [off|low|medium|high|xhigh] (cycle when no arg · xhigh 는 모델 상한이 xhigh 이상일 때만 wire 에 실린다, 아니면 high 로 깎인다)', subcommands: ['off', 'low', 'medium', 'high', 'xhigh'] },
   { name: 'model',     aliases: ['m'],           description: 'Switch active model — /model <codex|terra|sol|luna|opus|sonnet|grok> (list + current when no arg). OpenAI 는 Codex(Responses API)만. effort 는 /reasoning.', subcommands: ['codex', 'terra', 'sol', 'luna', 'opus', 'sonnet', 'grok'] },
@@ -431,72 +432,42 @@ export const SLASH_COMMANDS: SlashCommand[] = [
   { name: 'mission',   aliases: [],             description: 'Autopilot 미션 — list(+헬스) · trace <id> 계보 · arm <id> 승인 (구체화/종료는 CLI)', subcommands: ['list', 'trace', 'arm'] },
   { name: 'resume-turn', aliases: [],           description: 'Resume a paused turn checkpoint (/pause 짝 · 구 /resume)', subcommands: ['list'] },
   { name: 'context',   aliases: ['ctx'],        description: 'Show / clear / drop attached files', subcommands: ['clear', 'drop'] },
-  { name: 'paste', aliases: ['v'],          description: 'Attach clipboard image (macOS)' },
+  { name: 'paste', aliases: [],             description: 'Attach clipboard image (macOS)' },
   { name: 'sync',  aliases: ['s'],         description: 'Enter sync mode' },
   { name: 'plugin', aliases: ['plugins'], description: 'Manage plugins', subcommands: ['list', 'activate', 'deactivate', 'reload'] },
   { name: 'widget', aliases: ['widgets'], description: 'Manage widgets', subcommands: ['list', 'reload', 'instances'] },
   { name: 'clear', aliases: ['cls'],       description: 'Clear chat log' },
   { name: 'log',   aliases: [],             description: 'Chat Log controls — size / clear / filter / search / freeze / solo / turn / fold / help', subcommands: ['size', 'clear', 'filter', 'search', 'freeze', 'solo', 'turn', 'fold', 'help'] },
-  { name: 'media', aliases: ['mv'],         description: 'Last assistant media preview — status / open / sample / clear', subcommands: ['status', 'open', 'sample', 'clear', 'help'] },
-  { name: 'browser-cdp', aliases: ['bcdp'], description: 'Browser CDP status / smoke / stop', subcommands: ['status', 'smoke', 'stop', 'help'] },
   { name: 'help',  aliases: ['?'],         description: 'Show help overlay' },
-  { name: 'codex-setup', aliases: ['codex-init'], description: 'Codex 1-point setup — OAuth login + model pick + save config' },
   { name: 'setup', aliases: [], description: 'Onboarding wizard guide — /setup (anchor) · /setup reset (re-run wizard on next boot)', subcommands: ['help', 'reset'] },
   { name: 'memory', aliases: ['mem'], description: 'Memory ops — list / show / search / add / delete (see `elanous memory --help`)', subcommands: ['list', 'show', 'search', 'add', 'delete', 'index'] },
   { name: 'status', aliases: ['st'], description: 'Print the claude-code-style status pills (working dir + git + model)' },
   { name: 'export', aliases: [], description: 'Export this conversation transcript to a markdown file — /export [path] (default ~/temp/elanous-transcript-<stamp>.md)' },
-  { name: 'cache', aliases: [], description: 'Prompt-cache metrics — show session totals / reset', subcommands: ['show', 'reset'] },
   { name: 'delta', aliases: ['diffs'], description: 'Source delta browser — open the latest turn-scoped file diff popup', subcommands: ['open', 'help'] },
   { name: 'theme', aliases: [], description: 'Theme controls — list / switch / use / reset / preview / export', subcommands: ['list', 'switch', 'use', 'reset', 'preview', 'export'] },
   { name: 'debug', aliases: [], description: 'Runtime tracer + surfaces — /debug on (mirror+file) · off · file (quiet trail) · diag (loud trail) · render on|off (렌더 무음, 레벨과 직교); surfaces: window / popup / workbench / promote', subcommands: ['on', 'off', 'file', 'diag', 'mirror', 'verbose', 'render', 'level', 'toggle', 'tail', 'clear', 'path', 'view', 'status', 'window', 'popup', 'workbench'] },
-  { name: 'audit', aliases: [], description: 'Tail control-audit log (default: input policy changes; last 20 entries)', subcommands: ['input', 'all'] },
   { name: 'rebind', aliases: [], description: 'Manage runtime input bindings — list / show / add / reset / export / import', subcommands: ['actions', 'reset', 'export', 'import', 'help'] },
-  { name: 'perf',  aliases: [], description: 'Perf counters: draw latency + debug.log calls + stdout writes', subcommands: ['on', 'off', 'report', 'reset', 'status'] },
-  { name: 'substrate-stats', aliases: ['sst'], description: 'Substrate observability — paint cache hits/misses · overlay skip/write · mount churn · F8 generation bumps' },
-  { name: 'playground', aliases: ['pg'], description: 'IUL playground lab — list / run <id> [-v] / parse <path> / edit <id> / save <id> <path>.', subcommands: ['list', 'run', 'parse', 'edit', 'save'] },
-  { name: 'hint',  aliases: [], description: 'Tool hints — prefer/avoid/enable/disable/list/reset/show', subcommands: ['prefer', 'avoid', 'enable', 'disable', 'list', 'reset', 'show'] },
   { name: 'api-allow', aliases: ['api'], description: 'api_call allowlist — add/remove/list hosts the model may call', subcommands: ['add', 'remove', 'list', 'clear'] },
   { name: 'prompt', aliases: ['prompts'], description: 'Prompt Bank — list / show / search / select / inject / explain / enable / disable / config', subcommands: ['list', 'show', 'search', 'select', 'inject', 'explain', 'enable', 'disable', 'config'] },
   { name: 'history', aliases: ['hist', 'inputs'], description: 'Input history — list / find / show / clear', subcommands: ['list', 'find', 'show', 'clear'] },
   { name: 'research', aliases: ['rsh'],    description: 'Autonomous research loop — start / status / stop / tail / replan (PFC-S4)', subcommands: ['start', 'status', 'stop', 'tail', 'replan'] },
   // /harness is the dashboard's sole harness-launching entry. Its first
-  // positional token selects plan, ask, implement, goal, runs, stop, or memo;
+  // positional token selects plan, ask, dev, goal, runs, stop, or memo;
   // otherwise the complete sentence follows the former /dev dispatch.
-  { name: 'harness', aliases: [], description: 'Harness — /harness <goal> (self-dev) · plan <goal> · ask <sentence> · implement <feature> · goal <goal-file> · runs · stop <space-id> · memo <space-id> <note>', subcommands: ['plan', 'ask', 'implement', 'goal', 'runs', 'stop', 'memo'] },
+  { name: 'harness', aliases: [], description: 'Harness — /harness <goal> (self-dev) · plan <goal> · ask <sentence> · dev <goal> · goal <goal-file> · runs · stop <space-id> · memo <space-id> <note>', subcommands: ['plan', 'ask', 'dev', 'goal', 'runs', 'stop', 'memo'] },
   { name: 'plan',  aliases: [],            description: 'Toggle plan mode — read-only planning posture (slash alias for EnterPlanMode tool)', subcommands: ['enter', 'exit', 'status'] },
   { name: 'chat',  aliases: [],            description: 'Toggle LLM-only layout (hide 3-pane grid)' },
   { name: 'dashboard', aliases: ['dash'],  description: 'Return to 3-pane dashboard layout' },
-  // TUI 부활 T2 (2026-07-12): 단일 UI 모드 축 — essential(chat 전체화면 ·
-  // 기본) ↔ rich(full dashboard). config persist 포함.
-  { name: 'ui',    aliases: [],            description: 'UI mode — essential (chat 전체화면 · 기본) ↔ rich (full dashboard) · config 저장', subcommands: ['essential', 'rich'] },
-  // Q2 (substrate Occam, 2026-05-03): the legacy `/workspace`
-  // (working-dir | skill view switch) entry was vestigial — declared
-  // in the catalog but never wired to a handler. Removed so the new
-  // `/workspace` (virtual window management) below can take the name.
-  // Use `/view` for view switching instead.
   { name: 'telegram',  aliases: ['tg'],    description: 'Telegram bot — status / pair / send / pause / stop / attach / detach / sessions', subcommands: ['status', 'pair', 'setup', 'send', 'pause', 'stop', 'attach', 'detach', 'sessions'] },
-  { name: 'view',      aliases: [],        description: 'Switch or manage dashboard views', subcommands: ['list', 'next', 'prev', 'reload', 'save', 'restore', 'reset', 'export', '1', '2', '3', '4', '5', '6'] },
-  // Q2 (substrate Occam, 2026-05-03): renamed `/window` → `/workspace`
-  // per PLAN §4. `/window` `/win` `/ws` preserved as muscle-memory
-  // aliases. Implementation directory rename + symbol rename
-  // (`VirtualWindow` → `Workspace`, etc.) deferred to a follow-up PR
-  // — slash-command rename is the user-facing first step.
-  { name: 'workspace', aliases: ['ws', 'window', 'win'], description: 'Workspaces (formerly virtual windows) — list / new / browser / preview / browser-preview / iul / acp / sim / switch / close / picker / companion', subcommands: ['list', 'new', 'browser', 'preview', 'browser-preview', 'iul', 'acp', 'sim', 'switch', 'close', 'closeall', 'picker', 'companion'] },
-  { name: 'sim',       aliases: ['simulator'], description: 'Simulator shell — open / list / run <scenario>', subcommands: ['open', 'list', 'run'] },
-  { name: 'tablet',    aliases: [],        description: 'Tablet mode — collapse layout to log + input (Ctrl+M <pane> for others)', subcommands: ['on', 'off', 'toggle', 'auto', 'status', 'browser-preview', 'bp'] },
-  { name: 'surface',   aliases: ['surf'],  description: 'Surface control — open a pane/catalog launcher (/surface catalog · browser · preview · log · scratch · obsidian · skill) OR set a preferred LLM surface (/surface coding-agent · research-agent · control-agent · ops-agent · … · clear · status)', subcommands: ['catalog', 'browser', 'preview', 'browser-preview', 'log', 'scratch', 'obsidian', 'skill', 'skill-file', 'agents', 'coding-agent', 'coding-chat', 'research-agent', 'research-chat', 'control-agent', 'ops-ui-agent', 'ops-fleet-agent', 'ops-agent', 'clear', 'status'] },
-  { name: 'scratch',   aliases: ['sc'],    description: 'Scratchpad ops (text body / memo / clear / dump-log / popup)', subcommands: ['memo', 'clear', 'dump', 'popup'] },
+  { name: 'tablet',    aliases: [],        description: 'Tablet mode — collapse layout to log + input', subcommands: ['on', 'off', 'toggle', 'auto', 'status', 'browser-preview', 'bp'] },
+  { name: 'surface',   aliases: [], description: 'Surface control — open a pane/catalog launcher (/surface catalog · browser · preview · log · scratch · obsidian · skill) OR set a preferred LLM surface (/surface coding-agent · research-agent · control-agent · ops-agent · … · clear · status)', subcommands: ['catalog', 'browser', 'preview', 'browser-preview', 'log', 'scratch', 'obsidian', 'skill', 'skill-file', 'agents', 'coding-agent', 'coding-chat', 'research-agent', 'research-chat', 'control-agent', 'ops-ui-agent', 'ops-fleet-agent', 'ops-agent', 'clear', 'status'] },
   { name: 'term',  aliases: ['terminal'], description: 'Interactive terminal modal — spawn / list / attach / detach / switch / kill / snapshot / resume', subcommands: ['spawn', 'list', 'attach', 'detach', 'switch', 'kill', 'snapshot', 'resume'] },
-  { name: 'pty-list', aliases: ['ptys'], description: 'List PTY shell processes started from this dashboard session' },
-  { name: 'pty-pane', aliases: ['pty-view'], description: 'Open a virtual-window pane tailing a PTY shell (auto-picks the only live one, else specify id)' },
   { name: 'claude', aliases: [], description: 'Spawn claude-code CLI in a terminal modal' },
   { name: 'codex',  aliases: [], description: 'Spawn codex CLI in a terminal modal' },
   { name: 'gemini', aliases: [], description: 'Spawn gemini CLI in a terminal modal' },
   { name: 'acp',    aliases: [], description: 'ACP chat — stream claude-code / codex / gemini replies into the chat pane (not a VW spawn). /acp codex points at the canonical codex app-server path; /acp cas is a synonym.', subcommands: ['claude', 'codex', 'gemini', 'cas', 'cancel', 'status', 'drop'] },
-  { name: 'acp-vw', aliases: [], description: 'Spawn claude-code/codex/gemini/local-llm inside a new virtual window pane. /acp-vw clc (claude-code) · /acp-vw gem (gemini) · /acp-vw lll <node>:<model> (local-llm via lms chat · local node only) route through the H5 Embodied Agent Bus.', subcommands: ['claude', 'codex', 'clc', 'gem', 'lll'] },
   { name: 'conv', aliases: [], description: 'Conversation widget/popup host — /conv list · /conv open <session-id> · /conv layout <cascade|tile|stack> · /conv focus <next|prev>.', subcommands: ['list', 'ls', 'open', 'layout', 'focus'] },
   { name: 'handoff', aliases: [], description: 'H5 P3 cross-agent context handoff: /handoff <from_session_id> <to_brand> [--channels r,p,m] [--prompt "prefix"]. Takes source session snapshot (filtered by channels if observer present) and launches target via adapter registry. Brands: codex · claude · claude-code · gemini · elanous.' },
-  { name: 'budget',  aliases: ['b'], description: 'H6 P1 budget tracker — /budget [brand] · /budget remaining · /budget set <b> <w> <q> · /budget refresh · /budget forecast · /budget help', subcommands: ['set', 'refresh', 'forecast', 'status', 'remaining', 'help'] },
   { name: 'remaining', aliases: [], description: '계정마다 행으로 「지금 쓸 수 있는 것이 얼마나 남았나」를 본다 — 크레딧 축과 구독 축을 갈라 낸다. 화면은 명령 산출을 그대로 읽는다.' },
   { name: 'agent-room', aliases: [], description: 'H6 P4 VW agent-room — /agent-room <N> <brands...> · /agent-room list · /agent-room close <id> · N ∈ {2,3,4} · brands: codex/claude/gemini/elanous/auto/lll:<m>', subcommands: ['list', 'close', 'preset', 'help'] },
   { name: 'showroom', aliases: ['sr'], description: 'Showroom v2 multi-LLM lane composer — /showroom (default 2-pane) · /showroom <lane1> <lane2> [<lane3> [<lane4>]] · lane = role:provider[:transport] · roles plan/build/exec/review/reflect · pair with /lane and /relay for cross-lane handoffs.', subcommands: ['help'] },
@@ -505,18 +476,13 @@ export const SLASH_COMMANDS: SlashCommand[] = [
   { name: 'inject',    aliases: [], description: 'H6 P7 InjectCaptureToContext — /inject <sourceId> <targetId> · inject capture snapshot into target session · --as user-message|system-note|attached-block · HITL approver gated · non-revocable v1', subcommands: ['help'] },
   { name: 'relay',     aliases: [], description: 'Showroom v2 multi-lane handoff macros — /relay plan-build-review · /relay broadcast [--from <lane>] · /relay <from> -> <toA>,<toB> · HITL approver gates each step · failed steps non-aborting', subcommands: ['plan-build-review', 'broadcast', 'help'] },
   { name: 'lane',      aliases: [], description: 'Showroom v2 cross-lane context inject — /lane <from> <to> · address by pane index | role (plan/build/exec/review/reflect) | brand · --as user-message|system-note|attached-block · HITL approver gated · /lane list · /lane help', subcommands: ['list', 'help'] },
-  { name: 'llm',       aliases: [], description: 'H6 P2 Bundle 1 local LLM fleet — /llm nodes · /llm models [--node <id>] · /llm refresh · enumerate Tailscale hosts + LM Studio inventory · model spec = local-llm:<node>:<model>', subcommands: ['nodes', 'models', 'refresh', 'help'] },
-  { name: 'claude-vw', aliases: [], description: 'Spawn claude-code CLI in a new virtual window (fullscreen-by-default, single pane).' },
-  { name: 'codex-vw',  aliases: [], description: 'Spawn codex CLI in a new virtual window (fullscreen-by-default, single pane).' },
-  { name: 'control', aliases: ['dm'],      description: 'Enter control mode — the LLM treats every message as a dashboard command. /control off to exit.' },
+  { name: 'control', aliases: [],      description: 'Enter control mode — the LLM treats every message as a dashboard command. /control off to exit.' },
   { name: 'default', aliases: [],          description: 'Exit control mode back to default chat.' },
   // NOTE: the preferred-LLM-surface command (/surface coding-agent · … · clear · status)
   // shares the '/surface' name with the pane/catalog launcher above — both handlers
   // dispatch by argument (immediate slash-executor for panes, registry for LLM surfaces).
   // They are documented in the single merged '/surface' entry to keep names unique.
   { name: 'qc',      aliases: [],          description: 'Quick-control — arm one-shot control mode; next message runs as control, then auto-return to chat.' },
-  { name: 'ctoggle', aliases: [],          description: 'Toggle persistent control mode (alternative to /control ↔ /default).' },
-  { name: 'fullscreen', aliases: ['fs'], description: 'Toggle fullscreen mode for the current terminal modal' },
   { name: 'voice-chat', aliases: ['vc'], description: 'Continuous voice chat mode — speak, elanous replies in voice (Phase 4-5). Subcommands: start / stop / cancel / status. Chord: Alt+R toggles enter/exit anywhere.', subcommands: ['start', 'stop', 'cancel', 'status'] },
   { name: 'auto-tts', aliases: ['tts', 'autotts'], description: 'Auto-TTS for chat responses (Phase 2) — speaks LLM replies sentence-by-sentence. Subcommands: on / off / toggle / status.', subcommands: ['on', 'off', 'toggle', 'status'] },
   { name: 'quit',  aliases: ['q', 'exit'], description: 'Exit application' },
@@ -1771,10 +1737,20 @@ export async function textInput(opts: {
     }
     // ── Arrow keys (non-slash mode) ──
     else if (editAction.kind === 'move-left') {
-      applyMultilineEditorState(multilineEditorMoveLeft(multilineEditorState()));
+      if (key.ctrl) {
+        const action = resolveTextInputTextAction(currentLineEditorState(), key);
+        if (action.kind === 'insert') applyCurrentLineEditorState(action.next);
+      } else {
+        applyMultilineEditorState(multilineEditorMoveLeft(multilineEditorState()));
+      }
     }
     else if (editAction.kind === 'move-right') {
-      applyMultilineEditorState(multilineEditorMoveRight(multilineEditorState()));
+      if (key.ctrl) {
+        const action = resolveTextInputTextAction(currentLineEditorState(), key);
+        if (action.kind === 'insert') applyCurrentLineEditorState(action.next);
+      } else {
+        applyMultilineEditorState(multilineEditorMoveRight(multilineEditorState()));
+      }
     }
     else if (editAction.kind === 'history-older') {
       applyHistoryState(navigateSingleLineHistory(historyState(), history, 'older'));
@@ -2064,7 +2040,7 @@ export function buildContext(ctx: DashboardContext): string {
 export function formatResponse(
   text: string,
   maxWidth: number,
-  wrapOpts: { urlAware?: boolean; preserveOsc8?: boolean } = {},
+  wrapOpts: { urlAware?: boolean } = {},
 ): string[] {
   // Apply markdown styling first
   const rendered = renderMarkdown(text);

package/src/chat/input-text-key.ts

@@ -26,10 +26,10 @@ export function resolveTextInputTextAction(
   state: InlineEditorState,
   key: Pick<Key, 'name' | 'ctrl' | 'shift'>,
 ): TextInputTextAction {
-  if (key.ctrl) {
+  if (key.ctrl && key.name !== 'w' && key.name !== 'left' && key.name !== 'right') {
     return { kind: 'none' };
   }
-  if (NON_TEXT_NAMED_KEYS.has(key.name)) {
+  if (!key.ctrl && NON_TEXT_NAMED_KEYS.has(key.name)) {
     return { kind: 'none' };
   }
 

package/src/chat/mode/manual.ts

@@ -144,10 +144,8 @@ export function buildDashboardControlManual(opts: BuildControlManualOpts = {}):
     '- **Approval**: mutating tools (PaneInject, BroadcastPanes, TerminalModalInject,',
     '  DashboardConfigSet) pop a Y/N modal before write. Tell the user what you will do;',
     '  they confirm.',
-    '- **References**: embed `@term:<id>` / `@pane:<id>` / `@win:<N>` in your response',
-    '  to have the expander inline the referenced session/pane output for the LLM.',
-    '- **Virtual windows**: `WindowCreate` spawns a new VW; `PaneSplit` carves it. `^B 0`',
-    '  is the picker. Use `SpawnCodingAgentInVW` for a one-call claude-code/codex setup.',
+    '- **References**: embed `@term:<id>` in your response to have the expander',
+    '  inline the referenced session output for the LLM.',
     '- **Terminal sessions**: `/term spawn <cmd>` + `TerminalModalInject` + OSC 9/99/777',
     '  drive long-running CLI workflows.',
     '- **SSH remote mode**: Ctrl+K host picker; the browser pane then reads/writes over',

package/src/chat/pickers/state.ts

@@ -629,10 +629,12 @@ export function createPickerState(deps: PickerDeps): PickerState {
 
     if (key.name === 'up' || (key.ctrl && key.name === 'p')) {
       cmdPickerIdx = (cmdPickerIdx - 1 + currentArgItems.length) % currentArgItems.length;
+      pickerNavigated = true;
       return { consumed: true, action: null };
     }
     if (key.name === 'down' || (key.ctrl && key.name === 'n')) {
       cmdPickerIdx = (cmdPickerIdx + 1) % currentArgItems.length;
+      pickerNavigated = true;
       return { consumed: true, action: null };
     }
     if (key.name === 'tab') {
@@ -660,7 +662,7 @@ export function createPickerState(deps: PickerDeps): PickerState {
       const ctx = parseArgContext(buf, deps.commands);
       const selected = currentArgItems[cmdPickerIdx];
       let submitText = buf.lines[0] ?? '';
-      if (ctx && ctx.currentArg === '' && selected) {
+      if (ctx && ctx.currentArg === '' && selected && pickerNavigated) {
         submitText = submitText.slice(0, ctx.currentArgStart) + selected.value;
       }
       return {
@@ -707,32 +709,13 @@ export function createPickerState(deps: PickerDeps): PickerState {
     }
     if (key.name === 'enter' && !key.shift) {
       const selected = filtered[cmdPickerIdx];
-      const typed = (buf.lines[0] ?? '').slice(1).toLowerCase();
-      const exactMatch = selected
-        ? typed === selected.name || (selected.aliases?.includes(typed) ?? false)
-        : false;
-      if (selected && (pickerNavigated || exactMatch)) {
-        return {
-          consumed: true,
-          action: { kind: 'submit', text: '/' + selected.name },
-        };
-      }
-      // Autofill-only: rewrite the line to the full name, stay open.
-      if (selected) {
-        const newLine0 = '/' + selected.name;
-        return {
-          consumed: true,
-          action: {
-            kind: 'splice',
-            lineIdx: 0,
-            start: 0,
-            end: (buf.lines[0] ?? '').length,
-            text: newLine0,
-            newColIdx: newLine0.length,
-          },
-        };
-      }
-      return { consumed: true, action: null };
+      return {
+        consumed: true,
+        action: {
+          kind: 'submit',
+          text: pickerNavigated && selected ? '/' + selected.name : (buf.lines[0] ?? ''),
+        },
+      };
     }
     return { consumed: false };
   };

package/src/chat/search/modal.ts

@@ -157,6 +157,7 @@ export function createSearchModal(spec: SearchModalSpec): SearchModalHandle {
   const submitCurrent = (): void => {
     const item = items[cursor];
     if (item) spec.onAccept(item, query);
+    else spec.onCancel?.();
   };
 
   // SelectView as the paint engine. Filtering stays with the caller
@@ -255,8 +256,19 @@ export function createSearchModal(spec: SearchModalSpec): SearchModalHandle {
 
   // KX3 — coordinator.routeKey drives this directly. Unknown keys
   // still return 'consumed' so the modal behaves as a keyboard trap
-  // (matches legacy router contract).
-  const onKey = (ev: KeyEvent): 'consumed' | 'passthrough' => routeSearchModalKeyInput(ev, handle);
+  // (matches legacy router contract). Accept alternate terminal key names
+  // before delegating the ordinary keys to the shared router.
+  const onKey = (ev: KeyEvent): 'consumed' | 'passthrough' => {
+    if (ev.name === 'esc' || ev.name === '\x1b' || ev.sequence === '\x1b') {
+      handle.cancel();
+      return 'consumed';
+    }
+    if (ev.name === 'return') {
+      handle.accept();
+      return 'consumed';
+    }
+    return routeSearchModalKeyInput(ev, handle);
+  };
 
   const onMouse = (ev: DisplayMouseEvent): Action => {
     const localX = ev.col - spec.bounds.col;

package/src/chat/tool-render/types.ts

@@ -30,7 +30,7 @@ export interface ToolRenderConfig {
   foldMode?: FoldMode;
   /** When true, collapsed foldHint keeps the rich-mode "press f to expand"
    *  suffix. Omitted/false = count-only (essential/unknown). Expanded
-   *  rendering ignores this. Producers that know DashboardUiMode pass
+   *  rendering ignores this. Dashboard producers pass
    *  `mode === 'rich'`. */
   expandHint?: boolean;
 }

package/src/chat/turn-typeahead.ts

@@ -247,7 +247,8 @@ export function renderTurnTypeaheadQueueRow(
   if (count === 0) return null;
   const head = state.queuedSubmissions[0] ?? '';
   const label = count === 1 ? '⏳ 대기 1건' : `⏳ 대기 ${count}건`;
-  const tail = ' · 턴 종료 시 전송';
+  // 되꺼내기 키를 화면에 적는다 — 안내가 없어 대기 발화를 취소·수정할 길을 몰랐다(2026-09-26 베어 VM 실측 · UX 12).
+  const tail = ' · 턴 종료 시 전송 · Ctrl+↑ 되꺼내기';
   const budget = Math.max(8, width - [...label].length - [...tail].length - 5);
   const cps = [...head];
   const shown = cps.length > budget ? `${cps.slice(0, budget).join('')}…` : head;

package/src/chat/wrap.ts

@@ -2,7 +2,6 @@ import { visibleWidth } from '../tui.js';
 
 export interface WrapOptions {
   urlAware?: boolean;
-  preserveOsc8?: boolean;
 }
 
 interface Unit {
@@ -18,7 +17,7 @@ function isOsc8Sequence(raw: string): boolean {
   return raw.startsWith('\x1b]8;;');
 }
 
-function readEscapeSequence(input: string, start: number, preserveOsc8: boolean): { raw: string; next: number } {
+function readEscapeSequence(input: string, start: number): { raw: string; next: number } {
   if (input[start] !== '\x1b') return { raw: input[start] ?? '', next: start + 1 };
   const next = input[start + 1];
   if (next === '[') {
@@ -30,7 +29,7 @@ function readEscapeSequence(input: string, start: number, preserveOsc8: boolean)
     }
     return { raw: input.slice(start, i), next: i };
   }
-  if (next === ']' && preserveOsc8) {
+  if (next === ']') {
     const bel = input.indexOf('\x07', start + 2);
     const st = input.indexOf(OSC_TERMINATOR, start + 2);
     if (bel >= 0 && (st < 0 || bel < st)) return { raw: input.slice(start, bel + 1), next: bel + 1 };
@@ -39,14 +38,14 @@ function readEscapeSequence(input: string, start: number, preserveOsc8: boolean)
   return { raw: input.slice(start, Math.min(input.length, start + 2)), next: Math.min(input.length, start + 2) };
 }
 
-function toUnits(input: string, preserveOsc8: boolean): Unit[] {
+function toUnits(input: string): Unit[] {
   const units: Unit[] = [];
   let pendingEsc = '';
   for (let i = 0; i < input.length; i++) {
     const ch = input[i]!;
     if (ch === '\x1b') {
-      const esc = readEscapeSequence(input, i, preserveOsc8);
-      if (preserveOsc8 && isOsc8Sequence(esc.raw)) units.push({ raw: esc.raw, plain: '', width: 0 });
+      const esc = readEscapeSequence(input, i);
+      if (isOsc8Sequence(esc.raw)) units.push({ raw: esc.raw, plain: '', width: 0 });
       else pendingEsc += esc.raw;
       i = esc.next - 1;
       continue;
@@ -145,11 +144,10 @@ function splitTokenByWidth(token: Unit[], maxWidth: number): Unit[][] {
 
 export function urlAwareWrap(text: string, cols: number, opts: WrapOptions = {}): string[] {
   const width = Math.max(1, cols);
-  const preserveOsc8 = opts.preserveOsc8 !== false;
   const urlAware = opts.urlAware === true;
   const lines: string[] = [];
   for (const paragraph of text.split('\n')) {
-    const tokens = splitTokens(toUnits(paragraph, preserveOsc8));
+    const tokens = splitTokens(toUnits(paragraph));
     if (tokens.length === 0) {
       lines.push('');
       continue;

package/src/cli/__fixtures__/agent-help-before/agent.txt

@@ -0,0 +1,18 @@
+Usage: elanous agent [options] [command] [text...]
+
+Single-turn agent — same as `chat` but with the tool loop on by default
+(Read/Grep/Glob/ListDir/Edit/Write + Bash). Use this when the LLM needs to
+inspect files / run commands / debug itself.
+
+Arguments:
+  text                                            Prompt text for the single-turn agent.
+
+Options:
+  --new                                           Force a new session instead of using the active one
+  --session <id>                                  Continue an explicit session (id or unique prefix). Overrides --new and active session.
+  --json                                          Emit a single JSON line {sessionId, provider, model, reply, logPath, budget} instead of streaming text + ui.info trailer. Stable shape for LLM self-spawn.
+  --no-tools                                      Disable the tool loop and fall back to text-only chat (for benchmarking / parity with `chat`).
+  -h, --help                                      display help for command
+
+Commands:
+  dispatch [options] <subagent_type> <prompt...>  Spawn one sub-agent from the terminal and print its final message. Observe with `elanous logs --category agent.spawn` / `--category agent.done` — the printed cid pairs the two.

package/src/cli/__fixtures__/agent-help-before/registry.txt

@@ -0,0 +1,13 @@
+Usage: elanous registry [options] [command]
+
+모델 카탈로그(catalog/=SSoT) 관측 — 라우팅 맵 drift 감사
+
+Options:
+  -h, --help          display help for command
+
+Commands:
+  drift [options]     라우팅 핀(alias·tier-map·mission-router)이 catalog active id 와
+                      정합인지 감사 — HITL 역제안(자동 집행 없음)
+  discover [options]  발견 소스를 골라 돌리고 기존 스냅숏에 병합 — 기본 드라이런 · --write 로 기록 · S3 푸시
+                      없음
+  help [command]      display help for command

package/src/cli/__fixtures__/agent-help-before/root.txt

@@ -0,0 +1,100 @@
+Usage: elanous [options] [command]
+
+TUI skill runner — Yazi-style 3-pane + multi-LLM, with remote sync, smart diff,
+and SQLite logging
+
+Options:
+  -V, --version                                output the version number
+  --config-dir <dir>                           Override the elanous config / daemon root directory (default ~/.elanous). Pass at any position — works at the global or subcommand level. Replaces the legacy ELANOUS_DAEMON_DIR env var.
+  -r, --remote [name]                          원격 북마크로 붙는다. `-r` 만 쓰면 default 북마크(값을 받지 않는다), 이름을 대려면 `--remote <name>`. 처음 1회 `elanous nexus connect <host> --default`.
+  --test                                       격리 테스트 인스턴스로 실행 — cwd 의 git 트리(worktree 포함)에서 `<트리>/.elanous-test` 를 루트로 잡고 state·config 두 축을 함께 격리한다. config 사본이 없으면 자동 물질화. `--test=<dir>` 로 루트 직접 지정 가능(값 문법은 `=` 형태 하나 — 모호함 없음). ELANOUS_STATE_DIR/--config-dir 을 손으로 줄 필요가 없다.
+  -h, --help                                   display help for command
+
+Commands:
+  pty                                          PTY control — <ref> is an id, nickname, or unique prefix (see 'pty list')
+  pr                                           PR landing commands
+  repo                                         명시적 로컬 저장소 GitHub 비공개 발행
+  role                                         관제부 Primary 임대 조회 및 수동 넘김
+  machine                                      기계 식별자 · 맡은 일 · 자리 후보 순위
+  where [options]                              지금 이 프로세스가 어느 인스턴스(prod/test)에 속하는지와 그 이유를 보여준다 (READ-ONLY)
+  shadow                                       git 아닌 폴더의 이력을 인스턴스 밖 그림자 저장소에 남긴다
+  leader                                       은퇴한 리더 트리 명령
+  pod                                          Pod 명령 Job — 하니스 없이 명령 하나를 돌리고 산출을 돌려받는다
+  browser                                      🎨 봇이 모는 브라우저 페이지 «안»에 그린다 — 도형 · 캔들 차트 · 지우기
+  questions                                    AskUserQuestion 대기를 조회하고 파일 답을 기록한다
+  usage [options]                              계정마다 행으로 「지금 쓸 수 있는 것이 얼마나 남았나」를 본다 (크레딧 축 ≠ 구독 축)
+  release                                      공개 배포 한 판 — prepare(로컬) → publish(--yes) → verify (docs/manual/MANUAL-versioning-and-release-2026-09-25.md)
+  model-watch [options]                        제공자 문서에서 카탈로그 변경 제안을 만든다; 자동 적용하지 않는다
+  doctor [options]                             Reports whether credentials resolve and where each resolution comes from
+  control                                      독립 관제부
+  resources                                    관제부 자원 조회
+  hooks                                        외부 웹훅 수신·재전송
+  setup [options]                              Check OpenAI Codex setup and guide each missing credential step
+  grounding                                    그라운딩 출처 레지스트리
+  graph                                        Run a declared command graph or inspect its latest run
+  launch-head                                  발사 앞 머리 — 골이 Pod 로 가도 되는지 판정
+  connector                                    External task connectors
+  python                                       elanous 가 쓰는 파이썬(해석 · 점검 · elanous venv 셋업) — RFC-doctor-fix-build-toolchain-and-python-by-distro
+  self-update|update [options]                 설치본은 릴리스로, 체크아웃은 깨끗한 체크아웃으로 갱신하고 승인 시 넥서스 재시작 · `elanous update` 와 같다 · `--auto on` 이면 매일 자동
+  measure-fabric-arc-ab                        Fabric 분해 아크의 축소/전체 그라운딩 A/B를 관측하고 표와 JSON 결과를 낸다
+  mcp                                          MCP (Model Context Protocol) server / client integration
+  telegram-test [options]                      Standalone TEST telegram bot (separate token) — full Q&A/HITL/delegate path with ISOLATED state, WITHOUT touching the production daemon. Restart THIS process to test code changes; the live daemon stays up.
+  telegram                                     텔레그램 봇 — 넥서스 밖에서 도는 정식 Q&A 폴러
+  discord-test [options]                       Standalone TEST discord session (SAME app/token, scoped to discord.testChannel.channelId) with ISOLATED state, WITHOUT touching the production daemon. Restart THIS process to test code changes; the live daemon stays up.
+  sync [options]                               Sync skills to local or remote machines
+  status                                       Show current sync status and detect changes since last sync
+  git <args...>                                Run git through the git-fs gateway and append a pipe-visible exit status
+  gh <args...>                                 Run gh with retry-safe reads and append a pipe-visible outcome
+  theme                                        Inspect and configure dashboard themes
+  history [options]                            Show sync history
+  inspect [options]                            Inspect remote targets without syncing
+  autopilot                                    Mission-driven autopilot — runs an ACP agent against a single mission with safety + budget guards
+  memory                                       Persistent memories injected into every chat turn (user / feedback / project / reference)
+  decide [options] <question>                  Jev(System One)에게 «확률이 붙은» 판정 하나를 묻는다 — 기본 예/아니오. 📚 docs/manual/MANUAL-typesafe-jev-system-one-2026-09-20.md
+  ax-screen [options] <tasks.json>             업무 목록을 Jev 로 스크리닝해 자동화 후보 순위를 낸다. 📚 docs/manual/MANUAL-ax-task-screening-2026-09-20.md
+  decide-recipe [options] <name> <state.json>  이름 붙은 레시피로 판정한다. 질문은 recipes/<name>.json 에 «고정»되어 있다 — 매번 짓지 않는다.
+  signals [options]                            신호 파이프라인 퍼널(READ-ONLY) — 유입→분류→critical→2차→확정→집행 각 단계 수·통과율·갭. 게이트 튜닝 판단 근거.
+  loops [options]                              루프 에이전트 자산 원장(READ-ONLY) — 목표까지 반복하는 실행 주체(계약/자율/코디네이터)를 미션연관·독립·라이프사이클별로. 좀비(TTL 초과) 감지.
+  buzz [options]                               커뮤니티 버즈 온디맨드 브리핑 — 수집분 조회 + stale(밤/주말)이면 실시간 그랩 폴백. 매매 아님(정성 신호).
+  harness                                      dev-harness worktree 수명 — 워크트리 생성(worktree add)·조회(worktrees)·정리(clean)·프로세스 관찰(processes)
+  self                                         Self-awareness memory — 외부 도구(Claude Code/Codex)가 구현/변경 이력을 elanous 기억에 주입·회상
+  factcheck [options] <query...>               팩트체크 — 내부(발송 리포트/대화) 먼저 검색 → 없으면 외부(X/레딧/웹) 에스컬레이션
+  provider|providers                           Show the currently active LLM provider + model + auth status
+  provider:set [options] <name>                Swap active LLM provider in config.json (auto-backs-up the previous config to its `.bak` sibling — ⛔ the path is the ACTIVE config, not a fixed one: run `elanous where` to see it). Useful for A/B testing model behaviour — e.g. `elanous provider:set anthropic` to force-switch to Claude, then `elanous provider:set restore` (or `elanous provider:restore`) to roll back.
+  provider:restore                             Restore config.json from the automatic backup written by `elanous provider:set`.
+  provider:rotate [options] [sub] [target]     Cycle through the rotation list. With no argument: advance one step. Sub-commands: `list` (print list), `reset` (jump to first entry), `add <provider> [-m model] [-l label]` (append), `remove <label>`, `clear` (wipe rotation).
+  provider:use <needle>                        Jump to a specific rotation entry by label / provider name / model substring. Auto-backs-up config.json before the switch (restore with `elanous provider:restore`). Example: `elanous provider:use opus`, `elanous provider:use grok`, `elanous provider:use gpt-5`.
+  status-bar [options]                         Print the status pills (working dir + git + model) — pipe into shell prompt or preview
+  schedule                                     스케줄/크론 CRUD (registry·crontab·기억 정합). --json 으로 프로그래매틱 소비.
+  intake                                       바깥 사실·문서를 elanous 현재와 대조하거나 태스크로 받는다
+  logs [options]                               전 서피스 로그 조회/실시간 tail (adb logcat 동형) — level/surface/category/grep 필터
+  ad [options] [input...]                      판매 URL, 텍스트 브리프 또는 실사 이미지로 광고 제작 파이프라인을 시작
+  docs                                         문서 지식 검색/관리 — knowledge.db 벡터+BM25 하이브리드 (DocOps)
+  fleet                                        멀티 elanous 인스턴스 통합 뷰(READ-ONLY 연합) — 등록 인스턴스·보유 스토어 매트릭스. `logs instances` 일반화(kubectl get nodes 등가). 연합 조회는 `session list --all-instances` 등.
+  ops                                          운영 관측(READ-ONLY) — 미션·태스크·계약 루프·오케스트레이터 현재 상태·이상·전이. --json 프로그래매틱.
+  publish                                      external-markdown 게시 라이프사이클 — 만료 게시물 GC(S3 콜드 백업·삭제 아님)
+  agent-mission|codex                          Agent-mission CLI — 외부 에이전트 backend(codex[디폴트]·claude·gemini·grok·aside) 미션·리뷰 워치·셋업. `codex` 는 deprecated alias(하위호환).
+  dev|drive [options] [text...]                ⛔ `drive` 별칭으로 부르면 옵션은 여덟뿐 (--goal · --attach · --max-steps · --poll-ms · --model · --cwd · --worktree · --json) — `--attach <ref>` 는 이미 있는 PTY 를 몬다(생략하면 셸 명령을 새로 띄운다). 나머지는 전부 `dev` 전용이고 `drive` 에서는 거부된다. dev 와 drive 는 한 명령이라 이 도움말을 공유하므로, 아래 목록은 `dev` 기준이다. ⚠️ 실험 — 통합 self-dev 파이프라인 runDevPipeline. --backend self(디폴트·elanous-chat 자체구현)|codex/claude/gemini/grok(외부). --transport pty(디폴트·worktree·--branch 필수)|acp(cwd 세션·U6·capability 미검증). 미배선 조합은 NotYetUnified 명시 거부. ★self 는 무인 완결이 기본(PR 개설→auto-review 라벨→리뷰 clean 시 병합) — 끄려면 --no-open-pr/--no-auto-review/--no-auto-merge. 관측=elanous logs --category dev-pipeline · 상세=docs/manual/MANUAL-frontdoor-selfdev-dogfood-mechanism-2026-07-25.md
+  keys [options] [context]                     Print all keybindings + slash commands. Optional context filter.
+  finance                                      Native finance/investment logic (SSOT) — skill thin-client 진입점
+  config                                       Inspect and edit ~/.config/elanous/config.json
+  tasks|task                                   TOX 태스크 조회 및 승인
+  labels                                       PR 라벨 등록표 조회·GitHub 동기화
+  ask [options] <text...>                      Alias for `elanous chat --new`: send one query and print the reply
+  onboarding [options] [step]                  Run the first-run wizard. Pass a step name (llm|skills|obsidian|telegram|discord|voice-ai) to run only that step.
+  login                                        Authenticate to an LLM provider via OAuth
+  session                                      Manage conversation sessions
+  chat [options] <text...>                     Send one message in the active session (or a new one) and print the reply
+  repl [options]                               Sticky multi-turn REPL — same session across turns, no per-turn process boot. Drives chat / agent / scenario from one shell. Uses --new for a fresh session, --session <id> to resume, --scenario <yaml> for a scripted run, JSONL on stdin for piped automation.
+  agent [options] [text...]                    Single-turn agent — same as `chat` but with the tool loop on by default (Read/Grep/Glob/ListDir/Edit/Write + Bash). Use this when the LLM needs to inspect files / run commands / debug itself.
+  registry                                     모델 카탈로그(catalog/=SSoT) 관측 — 라우팅 맵 drift 감사
+  tier                                         LLM tier→모델 SSOT 조회 — provider별 budget/balanced/better/best/loaded 사다리(llm-tier-map). "grok low" 같은 별칭 흡수.
+  local                                        Local OpenAI-compatible LLM — ping, list, test, setup
+  scheduler|sched [args...]                    Retired — scheduling is now a workflow-runtime Schedule Trigger node (`elanous wf`)
+  attach [options]                             ACP client for the running elanous daemon. Three modes: handshake-only (default), one-shot (--message), interactive REPL (--interactive). Local (unix socket) or remote (--host / --url) over Tailscale.
+  wf|workflows                                 Run YAML DAG workflows (workflow-runtime · prompt|bash|skill|cft|approval|if|switch|iteration|classify|extract|set|filter|template|http|showroom|task|scheduleTrigger|webhookTrigger|discordTrigger|telegramTrigger|manualTrigger|chatTrigger nodes). Aliases: `workflows` (plural) · `workflow` (singular).
+  nexus                                        NEXUS — unified TUI shell + supervisor + meta-api (Phase N-1, opt-in)
+  token                                        Manage the ACP admin token
+  acp                                          Agent Client Protocol — spawn ACP agents (claude-code, codex, gemini)
+  voice                                        Voice tier + identity helpers (STT slider · TTS voice id · cost preview)
+  help [command]                               display help for command

package/src/cli/__fixtures__/agent-help-before/tier.txt

@@ -0,0 +1,15 @@
+Usage: elanous tier [options] [command]
+
+LLM tier→모델 SSOT 조회 — provider별 budget/balanced/better/best/loaded
+사다리(llm-tier-map). "grok low" 같은 별칭 흡수.
+
+Options:
+  -h, --help                           display help for command
+
+Commands:
+  resolve [options] <provider> [tier]  provider(+tier) → 모델 해석. tier 생략 시 5단 전부.
+                                       별칭 low/mid/high/max 허용.
+  list|ls [options] [provider]         전체 매트릭스(provider × 5 tier) 또는 한 provider.
+                                       tier 헷갈림 방지용 한눈 표.
+  providers                            tier ladder 가 정의된 provider 목록.
+  help [command]                       display help for command

package/src/cli/a2a-cli.ts

@@ -0,0 +1,52 @@
+import type { Command } from 'commander';
+import { createAgentCard } from '../a2a/agent-card.js';
+// ⛔ `../a2a/server.js` pulls `@a2a-js/sdk` — import it lazily. `src/index.ts` registers this module on every CLI start,
+//    so a static import made every elanous command fail where that dependency was not installed yet
+//    (2026-09-28 05:00–05:10: the ops checkout synced the source before `bun install` · `Cannot find module '@a2a-js/sdk/server'`).
+const loadServer = () => import('../a2a/server.js');
+
+const DEFAULT_HOST = '127.0.0.1';
+const DEFAULT_PORT = '31490';
+
+function parsePort(value: string): number {
+  const port = Number(value);
+  if (!/^\d+$/.test(value) || !Number.isSafeInteger(port) || port < 1 || port > 65535) {
+    throw new Error('invalid A2A port');
+  }
+  return port;
+}
+
+export function registerA2ACommands(program: Command): void {
+  const a2a = program.command('a2a').description('A2A 에이전트 서버와 공개 카드');
+  a2a.command('serve').description('A2A JSON-RPC 서버를 포그라운드에서 실행')
+    .option('--host <host>', '리스닝 주소', DEFAULT_HOST)
+    .option('--port <port>', '리스닝 포트', DEFAULT_PORT)
+    .option('--public-url <url>', '외부에 공개할 /a2a RPC URL')
+    .requiredOption('--tool-cwd <directory>', '도구 실행용 절대 작업 디렉터리')
+    .action(async (opts: { host: string; port: string; publicUrl?: string; toolCwd: string }) => {
+      const { startA2AServer } = await loadServer();
+      const server = startA2AServer({ host: opts.host, port: parsePort(opts.port), publicUrl: opts.publicUrl, toolCwd: opts.toolCwd });
+      console.log(`a2a listening ${new URL(server.url).host}`);
+      await new Promise<void>(resolve => {
+        const stop = () => {
+          process.removeListener('SIGINT', stop);
+          process.removeListener('SIGTERM', stop);
+          server.stop();
+          resolve();
+        };
+        process.once('SIGINT', stop);
+        process.once('SIGTERM', stop);
+      });
+    });
+  a2a.command('card').description('A2A 카드 JSON과 Gemini 원격 에이전트 설정 예시 출력')
+    .option('--host <host>', '카드에 사용할 주소', DEFAULT_HOST)
+    .option('--port <port>', '카드에 사용할 포트', DEFAULT_PORT)
+    .option('--public-url <url>', '외부에 공개할 /a2a RPC URL')
+    .action(async (opts: { host: string; port: string; publicUrl?: string }) => {
+      const { advertisedRpcUrl } = await loadServer();
+      const rpcUrl = advertisedRpcUrl(opts.publicUrl, opts.host, parsePort(opts.port));
+      const agentCardUrl = new URL('/.well-known/agent-card.json', rpcUrl).href;
+      console.log(JSON.stringify(createAgentCard(rpcUrl), null, 2));
+      console.log(`gemini:\n${JSON.stringify({ kind: 'remote', agent_card_url: agentCardUrl }, null, 2)}`);
+    });
+}