@a5c-ai/agent-mux-tui 0.4.1 → 0.4.10-staging.89ec25ae

package/README.md

@@ -12,6 +12,38 @@ npm i -g @a5c-ai/agent-mux-tui
 amux-tui
 ```
 
+## Development
+
+Package-level `build` and `test` scripts are routed through the repo-root
+`scripts/agent-mux-build.cjs` helper so `@a5c-ai/agent-mux-tui` runs with its
+agent-mux prerequisites built in dependency order and its tests executed from
+the repo root. Use `npm run build:local --workspace=@a5c-ai/agent-mux-tui`
+when you only want the package-local TypeScript compile.
+
+Run `npm run verify:release --workspace=@a5c-ai/agent-mux-tui` after a build to
+confirm the packed package surface still includes the README-linked kanban/workspaces
+planning artifacts.
+
+## Kanban/workspaces surface
+
+The package now ships first-phase `kanban` and `workspaces` views backed by the
+shared kanban/workspace control plane.
+
+- Runtime today: `kanban` view (list-first issue browsing, issue detail,
+  keyboard-driven backlog actions through an injected control plane, and linked
+  workspace/session handoff)
+- Runtime today: `workspaces` view (workspace inventory, linked issue/session/run
+  context, lifecycle actions routed through the injected control plane, and
+  issue/session handoff back into the rest of the TUI)
+
+- Spec: [`specs/kanban-workspaces-spec.md`](specs/kanban-workspaces-spec.md)
+- Backlog decomposition: [`specs/kanban-workspaces-subtasks.md`](specs/kanban-workspaces-subtasks.md)
+- Cross-package design note:
+  [`../../docs/agent-mux/archive/design/20-tui-kanban-workspaces.md`](../../docs/agent-mux/archive/design/20-tui-kanban-workspaces.md)
+
+The planning documents remain useful design references for follow-on expansion
+of both surfaces.
+
 ## Writing a plugin
 
 ```ts
@@ -70,6 +102,12 @@ The built-in plugins (`text-delta`, `thinking-delta`, `tool-call`,
 `tool-error`, `cost`, `chat-view`, `sessions-view`, `fallback`) are all
 implemented through these same extension points — use them as references.
 
+The logs / observability view is part of the supported built-in surface. Press
+`l` to open it. The metrics header aggregates the full buffered `EventStream`,
+the global `/` filter only narrows the visible log rows, and pressing `e`
+exports the full buffered stream to `session-log-<timestamp>.json` in the
+current working directory.
+
 ## View hotkeys
 
 | Key | View       | Purpose                                       |
@@ -81,15 +119,37 @@ implemented through these same extension points — use them as references.
 | `5` | models     | model registry per adapter                    |
 | `6` | profiles   | run-options profiles                          |
 | `7` | plugins    | native plugins per adapter                    |
-| `8` | runs       | active/recent runs                            |
+| `8` | kanban     | backlog/board browsing + issue actions        |
+| `W` | workspaces | workspace lifecycle inventory + actions       |
 | `9` | help       | keybindings + tips                            |
 | `0` | mcp        | registered MCP servers                        |
 | `-` | doctor     | capability matrix / diagnostics               |
-| `a` | auth       | auth status per adapter                       |
-| `c` | config     | config view                                   |
-| `k` | skills     | installed skills (d: delete, r: refresh)      |
-| `g` | agents     | installed sub-agents (d: delete, r: refresh)  |
-| `h` | hooks      | registered hooks (d: remove, r: refresh)      |
-
-Global: `p` prompt, `/` filter, `:` / Ctrl-K palette, `m` model picker,
-`P` profile picker, `i` interrupt, `y`/`n` approval, `q` quit.
+| `l` | logs       | observability metrics + filtered log stream   |
+| `A` | auth       | auth status per adapter                       |
+| `C` | config     | config view                                   |
+| `K` | skills     | installed skills (d: delete, r: refresh)      |
+| `G` | agents     | installed sub-agents (d: delete, r: refresh)  |
+| `H` | hooks      | registered hooks (d: remove, r: refresh)      |
+
+Global: chat composer auto-focuses in `chat`; `Esc` temporarily dismisses it;
+`/` filter, `:` / Ctrl-K palette, `m` model picker, `N` agent picker, `P`
+profile picker, `i` interrupt, `y`/`n` approval, `q` quit.
+
+Inside `kanban`, press `w` to jump to the linked workspace for the selected
+issue. Inside `workspaces`, press `g` to jump back to the linked issue. If you
+open `session-detail` from either view, `b`/`Esc` returns to the originating
+surface instead of always falling back to `sessions`.
+
+## Logs / Observability View
+
+The `logs` view is a built-in tab registered as `builtin:observability-view`.
+
+- Hotkey: `l`
+- Purpose: show aggregated tokens, cost, latency, error count, and tool-call
+  count for the buffered event stream.
+- Filtering: the global `/` filter applies to the log rows in this view,
+  including `type:<prefix>` filters. Metrics continue to reflect the full
+  buffered stream so you can inspect a subset without losing session totals.
+- Export: press `e` while the view is active to write the full buffered event
+  stream as pretty-printed JSON to `session-log-<timestamp>.json` in the
+  current working directory.

package/dist/app.d.ts

@@ -1,9 +1,27 @@
-import type { AgentMuxClient } from '@a5c-ai/agent-mux';
+import type { AgentMuxClient, DeferredPromptTarget, RunHandle } from '@a5c-ai/agent-mux';
 import type { TuiPlugin } from './plugin.js';
+import type { KanbanControlPlane } from './kanban-control-plane.js';
 export interface AppProps {
     client: AgentMuxClient;
     plugins: TuiPlugin[];
+    kanban?: KanbanControlPlane;
     defaultAgent?: string;
+    initialViewId?: string;
+    disableChatAutoPrompt?: boolean;
 }
-export declare function App({ client, plugins, defaultAgent }: AppProps): import("react/jsx-runtime").JSX.Element;
-//# sourceMappingURL=app.d.ts.map
+type ActiveRunCommand = {
+    kind: 'send';
+    prompt: string;
+} | {
+    kind: 'queue';
+    prompt: string;
+    when: DeferredPromptTarget;
+} | {
+    kind: 'steer';
+    prompt: string;
+    when: DeferredPromptTarget;
+};
+export declare function parseActiveRunCommand(prompt: string): ActiveRunCommand | null;
+export declare function dispatchPromptToActiveRun(handle: RunHandle, prompt: string): Promise<string>;
+export declare function App({ client, plugins, kanban, defaultAgent, initialViewId, disableChatAutoPrompt, }: AppProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAyB,MAAM,mBAAmB,CAAC;AAE/E,OAAO,KAAK,EAAE,SAAS,EAA+B,MAAM,aAAa,CAAC;AAO1E,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAQD,wBAAgB,GAAG,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,YAAuB,EAAE,EAAE,QAAQ,2CA2iBzE"}
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAc,oBAAoB,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAErG,OAAO,KAAK,EAAE,SAAS,EAA+B,MAAM,aAAa,CAAC;AAa1E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,KAAK,gBAAgB,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,oBAAoB,CAAA;CAAE,GAC7D;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,oBAAoB,CAAA;CAAE,CAAC;AAElE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAc7E;AAeD,wBAAsB,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAelG;AA6BD,wBAAgB,GAAG,CAAC,EAClB,MAAM,EACN,OAAO,EACP,MAAM,EACN,YAAuB,EACvB,aAAsB,EACtB,qBAA6B,GAC9B,EAAE,QAAQ,2CA4rBV"}

package/dist/app.js

@@ -1,24 +1,96 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
 import React, { useEffect, useMemo, useState } from 'react';
-import { Box, Text, useInput, useApp } from 'ink';
+import { Box, Text, useApp, useInput, useStdout } from 'ink';
 import { logger } from '@a5c-ai/agent-mux-observability';
 import { createRegistry, createContext, loadPlugins } from './registry.js';
 import { EventStream } from './event-stream.js';
-import { PromptInput } from './prompt-input.js';
+import { PromptInput, createEmptyPromptInputState, insertPromptInput, } from './prompt-input.js';
 import { CommandPalette } from './command-palette.js';
 import { ModelPicker } from './model-picker.js';
 import { loadHistory, appendHistory } from './prompt-history-store.js';
+import { resolveSessionDispatchPlan } from './session-dispatch.js';
+import { createViewport, packSegments } from './layout.js';
+export function parseActiveRunCommand(prompt) {
+    if (prompt.startsWith('/queue ')) {
+        const body = prompt.slice('/queue '.length).trim();
+        return body ? { kind: 'queue', prompt: body, when: 'next-turn' } : null;
+    }
+    if (prompt.startsWith('/steer-tool ')) {
+        const body = prompt.slice('/steer-tool '.length).trim();
+        return body ? { kind: 'steer', prompt: body, when: 'after-tool' } : null;
+    }
+    if (prompt.startsWith('/steer ')) {
+        const body = prompt.slice('/steer '.length).trim();
+        return body ? { kind: 'steer', prompt: body, when: 'after-response' } : null;
+    }
+    return { kind: 'send', prompt };
+}
+function describeDeferredTarget(target) {
+    switch (target) {
+        case 'after-tool':
+            return 'the next tool result';
+        case 'after-response':
+            return 'the next agent response';
+        case 'next-turn':
+            return 'the next turn';
+        default:
+            return 'a later event';
+    }
+}
+export async function dispatchPromptToActiveRun(handle, prompt) {
+    const command = parseActiveRunCommand(prompt);
+    if (!command) {
+        return 'Active-run command requires a message.';
+    }
+    if (command.kind === 'queue') {
+        await handle.queue(command.prompt, { when: command.when });
+        return `Queued for ${describeDeferredTarget(command.when)}…`;
+    }
+    if (command.kind === 'steer') {
+        await handle.steer(command.prompt, { when: command.when });
+        return `Steering after ${describeDeferredTarget(command.when)}…`;
+    }
+    await handle.send(command.prompt);
+    return 'Sending to active run…';
+}
 function pickRenderers(renderers, ev) {
     const specific = renderers.find((r) => r.id !== 'fallback' && r.match(ev));
     if (specific)
         return specific;
     return renderers.find((r) => r.id === 'fallback');
 }
-export function App({ client, plugins, defaultAgent = 'claude' }) {
+function SegmentLines({ lines }) {
+    return (_jsx(Box, { flexDirection: "column", children: lines.map((line, lineIndex) => (_jsx(Box, { children: line.map((segment, segmentIndex) => (_jsxs(Text, { color: segment.color, dimColor: segment.dimColor, children: [segmentIndex > 0 ? ' · ' : '', segment.text] }, segment.key))) }, `line:${lineIndex}`))) }));
+}
+export function App({ client, plugins, kanban, defaultAgent = 'claude', initialViewId = 'chat', disableChatAutoPrompt = false, }) {
     const { exit } = useApp();
+    const { stdout } = useStdout();
+    const [stdoutDimensions, setStdoutDimensions] = useState(() => ({
+        width: stdout?.columns ?? 80,
+        height: stdout?.rows ?? 24,
+    }));
+    useEffect(() => {
+        if (!stdout)
+            return;
+        const sync = () => {
+            setStdoutDimensions({
+                width: stdout.columns ?? 80,
+                height: stdout.rows ?? 24,
+            });
+        };
+        sync();
+        stdout.on('resize', sync);
+        return () => {
+            stdout.off('resize', sync);
+        };
+    }, [stdout]);
+    const viewport = useMemo(() => createViewport(stdoutDimensions.width, stdoutDimensions.height), [stdoutDimensions.height, stdoutDimensions.width]);
     const [status, setStatus] = useState('');
-    const [activeId, setActiveId] = useState('chat');
+    const [pluginLoadVersion, setPluginLoadVersion] = useState(0);
+    const [activeId, setActiveId] = useState(initialViewId);
     const [promptMode, setPromptMode] = useState(false);
+    const [chatPromptDismissed, setChatPromptDismissed] = useState(false);
+    const [chatPromptState, setChatPromptState] = useState(() => createEmptyPromptInputState());
     const [pendingResume, setPendingResume] = useState(null);
     const currentHandleRef = React.useRef(null);
     const pendingApprovalRef = React.useRef(null);
@@ -27,6 +99,9 @@ export function App({ client, plugins, defaultAgent = 'claude' }) {
     const [filter, setFilter] = useState('');
     const [paletteMode, setPaletteMode] = useState(false);
     const [selection, setSelection] = useState(undefined);
+    const [issueSelection, setIssueSelection] = useState(undefined);
+    const [workspaceSelection, setWorkspaceSelection] = useState(undefined);
+    const [returnViewId, setReturnViewId] = useState('sessions');
     const [modelPickerMode, setModelPickerMode] = useState(false);
     const [currentModel, setCurrentModel] = useState(undefined);
     const [agentPickerMode, setAgentPickerMode] = useState(false);
@@ -59,6 +134,7 @@ export function App({ client, plugins, defaultAgent = 'claude' }) {
         deny: 'magenta',
     };
     const [execMode, setExecMode] = useState('normal');
+    const activeViewIdRef = React.useRef(initialViewId);
     function cycleExecMode() {
         setExecMode((m) => {
             const i = EXEC_MODES.indexOf(m);
@@ -85,28 +161,35 @@ export function App({ client, plugins, defaultAgent = 'claude' }) {
         const r = createRegistry();
         const s = new EventStream();
         const ctx = createContext(client, r, (ev) => {
-            if (ev.type === 'status')
-                setStatus(ev.message);
-            if (ev.type === 'view:switch')
-                setActiveId(ev.id);
-            if (ev.type === 'session:select') {
-                setPendingResume({ agent: ev.agent, sessionId: ev.sessionId });
-                setStatus(`Resuming ${ev.agent}/${ev.sessionId} — type to send next message`);
-                void loadSessionTranscript(ev.agent, ev.sessionId);
-            }
-            if (ev.type === 'session:detail') {
-                setSelection({ agent: ev.agent, sessionId: ev.sessionId });
-            }
-            if (ev.type === 'session:diff') {
-                void handleSessionDiff(ev.agent, ev.sessionId);
-            }
-        }, s);
-        void loadPlugins(plugins, ctx);
+            void handleInternalEvent(ev, activeViewIdRef.current);
+        }, s, kanban);
+        void loadPlugins(plugins, ctx).then(() => {
+            setPluginLoadVersion((version) => version + 1);
+        });
         return { registry: r, stream: s };
     }, [client, plugins]);
+    const active = registry.views.find((v) => v.id === activeId) ?? registry.views[0];
+    activeViewIdRef.current = active?.id ?? activeId;
     useInput((input, key) => {
         if (promptMode || filterMode || paletteMode || modelPickerMode || profilePickerMode || agentPickerMode)
             return; // child input owns keys while open
+        if (active?.id === 'chat' && chatPromptDismissed) {
+            if (key.escape) {
+                setChatPromptDismissed(false);
+                setChatPromptState(createEmptyPromptInputState());
+                const fallbackView = registry.views.find((view) => view.id !== 'chat');
+                if (fallbackView) {
+                    setActiveId(fallbackView.id);
+                }
+                return;
+            }
+            if (input && !key.ctrl && !key.meta) {
+                setChatPromptState((current) => insertPromptInput(current, input));
+                setChatPromptDismissed(false);
+                setPromptMode(true);
+                return;
+            }
+        }
         if (input === 'q' || (key.ctrl && input === 'c')) {
             exit();
             return;
@@ -175,24 +258,24 @@ export function App({ client, plugins, defaultAgent = 'claude' }) {
                     registerEventRenderer: () => { },
                     registerCommand: () => { },
                     registerPromptHandler: () => { },
-                    emit: (e) => {
-                        if (e.type === 'status')
-                            setStatus(e.message);
-                        if (e.type === 'event')
-                            stream.push(e.event);
-                    },
+                    emit: (e) => void handleInternalEvent(e, activeViewIdRef.current),
                 });
             }
         }
     });
-    const active = registry.views.find((v) => v.id === activeId) ?? registry.views[0];
+    const navLines = useMemo(() => packSegments(registry.views.map((v) => ({
+        key: v.id,
+        text: `[${v.hotkey ?? '?'}] ${v.title}`,
+        color: v.id === active?.id ? 'green' : 'gray',
+    })), viewport.width), [active?.id, registry.views, viewport.width]);
     // Chat view has an always-on inline prompt. Auto-focus when entering chat
-    // and no modal is open. Esc inside PromptInput flips promptMode off, which
-    // re-enables global hotkeys; any hotkey that switches away from chat also
-    // clears it. This is the simplest model that keeps global navigation working.
+    // and no modal is open. The draft itself lives at the app level so Esc can
+    // temporarily dismiss the composer without losing the current prompt.
     useEffect(() => {
-        if (active?.id === 'chat' &&
+        if (!disableChatAutoPrompt &&
+            active?.id === 'chat' &&
             !promptMode &&
+            !chatPromptDismissed &&
             !filterMode &&
             !paletteMode &&
             !modelPickerMode &&
@@ -200,31 +283,59 @@ export function App({ client, plugins, defaultAgent = 'claude' }) {
             !agentPickerMode) {
             setPromptMode(true);
         }
-        if (active?.id !== 'chat' && promptMode) {
-            setPromptMode(false);
+        if (active?.id !== 'chat') {
+            if (promptMode) {
+                setPromptMode(false);
+            }
+            if (chatPromptDismissed) {
+                setChatPromptDismissed(false);
+            }
         }
-    }, [active?.id, filterMode, paletteMode, modelPickerMode, profilePickerMode, agentPickerMode, promptMode]);
+    }, [active?.id, chatPromptDismissed, disableChatAutoPrompt, filterMode, paletteMode, modelPickerMode, profilePickerMode, agentPickerMode, promptMode]);
     const ActiveView = active?.component;
     const viewEmit = (ev) => {
-        if (ev.type === 'status')
+        void handleInternalEvent(ev, active?.id);
+    };
+    async function handleInternalEvent(ev, sourceViewId) {
+        if (ev.type === 'status') {
             setStatus(ev.message);
-        else if (ev.type === 'view:switch')
+            return;
+        }
+        if (ev.type === 'event') {
+            stream.push(ev.event);
+            return;
+        }
+        if (ev.type === 'view:switch') {
             setActiveId(ev.id);
-        else if (ev.type === 'session:select') {
+            return;
+        }
+        if (ev.type === 'issue:select') {
+            setIssueSelection({ issueId: ev.issueId, projectId: ev.projectId });
+            setActiveId(ev.viewId ?? 'kanban');
+            return;
+        }
+        if (ev.type === 'workspace:select') {
+            setWorkspaceSelection({ workspacePath: ev.workspacePath });
+            setActiveId(ev.viewId ?? 'workspaces');
+            return;
+        }
+        if (ev.type === 'session:select') {
             setPendingResume({ agent: ev.agent, sessionId: ev.sessionId });
             setStatus(`Resuming ${ev.agent}/${ev.sessionId} — type to send next message`);
-            void loadSessionTranscript(ev.agent, ev.sessionId);
+            await loadSessionTranscript(ev.agent, ev.sessionId);
             setActiveId('chat');
+            return;
         }
-        else if (ev.type === 'session:detail') {
+        if (ev.type === 'session:detail') {
+            const nextReturnViewId = sourceViewId && sourceViewId !== 'session-detail' ? sourceViewId : activeViewIdRef.current;
             setSelection({ agent: ev.agent, sessionId: ev.sessionId });
+            setReturnViewId(nextReturnViewId && nextReturnViewId !== 'session-detail' ? nextReturnViewId : 'sessions');
+            return;
         }
-        else if (ev.type === 'session:diff') {
-            void handleSessionDiff(ev.agent, ev.sessionId);
+        if (ev.type === 'session:diff') {
+            await handleSessionDiff(ev.agent, ev.sessionId);
         }
-        else if (ev.type === 'event')
-            stream.push(ev.event);
-    };
+    }
     async function loadSessionTranscript(agent, sessionId) {
         try {
             const full = await client.sessions.get(agent, sessionId);
@@ -235,7 +346,7 @@ export function App({ client, plugins, defaultAgent = 'claude' }) {
                 stream.push({
                     runId: 'transcript',
                     agent,
-                    timestamp: (m.timestamp ?? new Date()).toISOString(),
+                    timestamp: new Date(m.timestamp ?? Date.now()).toISOString(),
                     type: 'text_delta',
                     delta: `[${m.role}] ${m.content}\n`,
                 });
@@ -260,7 +371,7 @@ export function App({ client, plugins, defaultAgent = 'claude' }) {
             const sum = result.summary;
             const head = result.operations
                 .slice(0, 30)
-                .map((o, i) => `${i + 1}. ${o.kind ?? 'op'}`)
+                .map((o, i) => `${i + 1}. ${o.type}`)
                 .join('\n');
             const text = `\n--- session diff ---\n` +
                 `A: ${left.agent}/${left.sessionId}\n` +
@@ -293,6 +404,7 @@ export function App({ client, plugins, defaultAgent = 'claude' }) {
     async function handlePromptSubmit(prompt) {
         if (!prompt.trim())
             return;
+        setChatPromptDismissed(false);
         setPromptHistory((h) => {
             const next = h.filter((p) => p !== prompt);
             next.push(prompt);
@@ -309,8 +421,7 @@ export function App({ client, plugins, defaultAgent = 'claude' }) {
         // fresh process — keeps follow-ups inside the same session & context.
         if (currentHandleRef.current) {
             try {
-                setStatus('Sending to active run…');
-                await currentHandleRef.current.send(prompt);
+                setStatus(await dispatchPromptToActiveRun(currentHandleRef.current, prompt));
             }
             catch (e) {
                 setStatus(`send failed: ${e.message}`);
@@ -323,19 +434,20 @@ export function App({ client, plugins, defaultAgent = 'claude' }) {
                 ? (await client.profiles.apply(currentProfile))
                 : {};
             const selectedAgent = currentModel?.agent ?? currentAgent ?? baseOpts.agent ?? defaultAgent;
-            // TODO: cross-harness resume/fork — if the user picked a different
-            // agent than the session's origin we'd need a transcript-export /
-            // re-import path. For now, refuse explicitly.
-            if (pendingResume && pendingResume.agent !== selectedAgent && (currentModel || currentAgent)) {
-                setStatus(`Cannot resume ${pendingResume.agent} session with ${selectedAgent}: cross-harness resume not implemented yet.`);
-                return;
-            }
-            const runOpts = {
-                agent: pendingResume?.agent ?? selectedAgent,
+            const explicitHarnessSelection = Boolean(currentModel || currentAgent);
+            const requestedAgent = pendingResume && !explicitHarnessSelection ? pendingResume.agent : selectedAgent;
+            const sessionPlan = await resolveSessionDispatchPlan({
+                sessions: client.sessions,
+                pendingResume,
+                requestedAgent,
                 prompt,
+            });
+            const runOpts = {
+                agent: sessionPlan.agent,
+                prompt: sessionPlan.prompt,
             };
-            if (pendingResume)
-                runOpts.sessionId = pendingResume.sessionId;
+            if (sessionPlan.sessionId)
+                runOpts.sessionId = sessionPlan.sessionId;
             if (currentModel)
                 runOpts.model = currentModel.modelId;
             else if (baseOpts.model)
@@ -354,6 +466,9 @@ export function App({ client, plugins, defaultAgent = 'claude' }) {
             }
             else
                 runOpts.approvalMode = 'prompt';
+            if (sessionPlan.migration) {
+                setStatus(`Forking ${sessionPlan.migration.sourceAgent}/${sessionPlan.migration.sourceSessionId} into ${sessionPlan.agent} via transcript import…`);
+            }
             const resumedAgent = runOpts.agent;
             let resumedSessionId = runOpts.sessionId;
             const handle = client.run(runOpts);
@@ -406,31 +521,91 @@ export function App({ client, plugins, defaultAgent = 'claude' }) {
             }
         }
     }
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { children: registry.views.map((v) => (_jsxs(Text, { color: v.id === active?.id ? 'green' : 'gray', children: ["[", v.hotkey ?? '?', "] ", v.title, '  '] }, v.id))) }), _jsx(Box, { borderStyle: "single", flexDirection: "column", paddingX: 1, children: ViewWithRenderers ? (_jsx(ViewWithRenderers, { client: client, active: true, eventStream: stream, emit: viewEmit, filter: filter || undefined, selection: selection, activeSessions: activeSessions })) : (_jsx(Text, { dimColor: true, children: "No views registered." })) }), pendingApproval ? (_jsx(Box, { children: _jsxs(Text, { color: pendingApproval.riskLevel === 'high' ? 'red' : 'yellow', children: ["[approval ", pendingApproval.riskLevel, "] ", pendingApproval.action, " \u2014 y: approve \u00B7 n: deny"] }) })) : null, filterMode ? (_jsx(PromptInput, { label: "filter (substring or `type:<prefix>`)> ", onSubmit: (v) => {
+    const footerSegments = [
+        {
+            key: 'controls',
+            text: viewport.isVeryNarrow
+                ? '/ filter, : palette'
+                : 'shift+tab: mode, /: filter, :: palette',
+            dimColor: true,
+        },
+        { key: 'mode', text: `mode=${execMode}`, color: EXEC_MODE_COLORS[execMode] },
+        { key: 'agent', text: `agent=${currentAgent ?? defaultAgent}`, color: 'cyan' },
+    ];
+    if (filter) {
+        footerSegments.push({
+            key: 'filter',
+            text: viewport.isVeryNarrow ? `filter=${filter}` : `filter="${filter}"`,
+            color: 'cyan',
+        });
+    }
+    if (currentModel) {
+        footerSegments.push({
+            key: 'model',
+            text: `model=${currentModel.agent}/${currentModel.modelId}`,
+            color: 'magenta',
+        });
+    }
+    if (currentProfile) {
+        footerSegments.push({ key: 'profile', text: `profile=${currentProfile}`, color: 'blue' });
+    }
+    if (currentHandleRef.current) {
+        footerSegments.push({ key: 'interrupt', text: 'i: interrupt', color: 'yellow' });
+        if (!viewport.isVeryNarrow) {
+            footerSegments.push({
+                key: 'deferred',
+                text: '/queue, /steer, /steer-tool',
+                color: 'yellow',
+            });
+        }
+    }
+    if (pendingApproval) {
+        footerSegments.push({ key: 'approval', text: 'y/n: approve', color: 'yellow' });
+    }
+    footerSegments.push({ key: 'quit', text: 'q: quit', dimColor: true });
+    if (!viewport.isVeryNarrow && registry.views.length > 1) {
+        footerSegments.push({
+            key: 'views',
+            text: registry.views
+                .filter((v) => v.hotkey)
+                .map((v) => `${v.hotkey}:${v.title.toLowerCase()}`)
+                .join(' '),
+            dimColor: true,
+        });
+    }
+    if (!viewport.isShort && !viewport.isVeryNarrow && registry.commands.length > 0) {
+        footerSegments.push({
+            key: 'commands',
+            text: registry.commands.map((c) => `${c.hotkey}:${c.label}`).join(' '),
+            dimColor: true,
+        });
+    }
+    const footerLines = packSegments(footerSegments, viewport.width);
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(SegmentLines, { lines: navLines }), _jsx(Box, { borderStyle: "single", flexDirection: "column", paddingX: 1, children: ViewWithRenderers ? (_jsx(ViewWithRenderers, { client: client, kanban: kanban, active: true, eventStream: stream, emit: viewEmit, pluginEpoch: pluginLoadVersion, viewport: viewport, filter: filter || undefined, selection: selection, issueSelection: issueSelection, workspaceSelection: workspaceSelection, returnViewId: returnViewId, activeSessions: activeSessions })) : (_jsx(Text, { dimColor: true, children: "No views registered." })) }), pendingApproval ? (_jsx(Box, { children: _jsxs(Text, { color: pendingApproval.riskLevel === 'high' ? 'red' : 'yellow', children: ["[approval ", pendingApproval.riskLevel, "] ", pendingApproval.action, " \u2014 y: approve \u00B7 n: deny"] }) })) : null, filterMode ? (_jsx(PromptInput, { label: "filter (substring or `type:<prefix>`)> ", onSubmit: (v) => {
                     setFilter(v);
                     setFilterMode(false);
                     setStatus(v ? `Filter: ${v}` : 'Filter cleared.');
-                }, onCancel: () => setFilterMode(false) })) : null, profilePickerMode ? (_jsx(ModelPicker, { models: availableProfiles.map((n) => ({ agent: 'profile', modelId: n })), onCancel: () => setProfilePickerMode(false), onPick: (m) => {
+                }, onCancel: () => setFilterMode(false) })) : null, profilePickerMode ? (_jsx(ModelPicker, { models: availableProfiles.map((n) => ({ agent: 'profile', modelId: n })), maxItems: viewport.overlayRowLimit, width: viewport.contentWidth, title: "profile", onCancel: () => setProfilePickerMode(false), onPick: (m) => {
                     setCurrentProfile(m.modelId);
                     setProfilePickerMode(false);
                     setStatus(`Profile: ${m.modelId}`);
-                } })) : null, modelPickerMode ? (_jsx(ModelPicker, { models: availableModels, onCancel: () => setModelPickerMode(false), onPick: (m) => {
+                } })) : null, modelPickerMode ? (_jsx(ModelPicker, { models: availableModels, maxItems: viewport.overlayRowLimit, width: viewport.contentWidth, onCancel: () => setModelPickerMode(false), onPick: (m) => {
                     setCurrentModel(m);
                     setModelPickerMode(false);
                     setStatus(`Model: ${m.agent}/${m.modelId}`);
-                } })) : null, agentPickerMode ? (_jsx(ModelPicker, { models: (() => {
+                } })) : null, agentPickerMode ? (_jsx(ModelPicker, { title: "agent", models: (() => {
                     try {
                         return client.adapters.list().map((a) => ({ agent: a.agent, modelId: a.displayName }));
                     }
                     catch {
                         return [];
                     }
-                })(), onCancel: () => setAgentPickerMode(false), onPick: (m) => {
+                })(), maxItems: viewport.overlayRowLimit, width: viewport.contentWidth, onCancel: () => setAgentPickerMode(false), onPick: (m) => {
                     setCurrentAgent(m.agent);
                     setCurrentModel(undefined);
                     setAgentPickerMode(false);
                     setStatus(`Agent: ${m.agent}`);
-                } })) : null, paletteMode ? (_jsx(CommandPalette, { views: registry.views, commands: registry.commands, onCancel: () => setPaletteMode(false), onPick: (a) => {
+                } })) : null, paletteMode ? (_jsx(CommandPalette, { views: registry.views, commands: registry.commands, maxItems: viewport.overlayRowLimit, width: viewport.contentWidth, onCancel: () => setPaletteMode(false), onPick: (a) => {
                     setPaletteMode(false);
                     if (a.id.startsWith('view:')) {
                         setActiveId(a.id.slice('view:'.length));
@@ -446,18 +621,15 @@ export function App({ client, plugins, defaultAgent = 'claude' }) {
                                 registerEventRenderer: () => { },
                                 registerCommand: () => { },
                                 registerPromptHandler: () => { },
-                                emit: (e) => {
-                                    if (e.type === 'status')
-                                        setStatus(e.message);
-                                    if (e.type === 'event')
-                                        stream.push(e.event);
-                                },
+                                emit: (e) => void handleInternalEvent(e, activeViewIdRef.current),
                             });
                         }
                     }
-                } })) : null, _jsxs(Box, { flexDirection: "column", children: [status ? _jsx(Text, { dimColor: true, children: status }) : null, _jsxs(Box, { children: [_jsx(Text, { dimColor: true, children: "shift+tab: mode \u00B7 /: filter \u00B7 :: palette \u00B7 m: model \u00B7 N: agent \u00B7 P: profile" }), _jsxs(Text, { color: EXEC_MODE_COLORS[execMode], children: [" \u00B7 mode=", execMode] }), _jsxs(Text, { color: "cyan", children: [" \u00B7 agent=", currentAgent ?? defaultAgent] }), filter ? _jsxs(Text, { color: "cyan", children: [" \u00B7 filter=\"", filter, "\""] }) : null, currentModel ? (_jsxs(Text, { color: "magenta", children: [" \u00B7 model=", currentModel.agent, "/", currentModel.modelId] })) : null, currentProfile ? (_jsxs(Text, { color: "blue", children: [" \u00B7 profile=", currentProfile] })) : null, currentHandleRef.current ? _jsx(Text, { color: "yellow", children: " \u00B7 i: interrupt" }) : null, pendingApproval ? _jsx(Text, { color: "yellow", children: " \u00B7 y/n: approve/deny" }) : null, _jsx(Text, { dimColor: true, children: " \u00B7 q: quit" }), registry.views.length > 1 ? (_jsxs(Text, { dimColor: true, children: [' · ', registry.views
-                                        .filter((v) => v.hotkey)
-                                        .map((v) => `${v.hotkey}:${v.title.toLowerCase()}`)
-                                        .join(' ')] })) : null, registry.commands.length > 0 ? (_jsxs(Text, { dimColor: true, children: [' · ', registry.commands.map((c) => `${c.hotkey}:${c.label}`).join(' ')] })) : null] }), promptMode ? (_jsx(PromptInput, { label: "> ", labelColor: EXEC_MODE_COLORS[execMode], onSubmit: handlePromptSubmit, onCancel: () => setPromptMode(false), onShiftTab: cycleExecMode, history: promptHistory })) : null] })] }));
+                } })) : null, _jsxs(Box, { flexDirection: "column", children: [status ? _jsx(Text, { dimColor: true, children: status }) : null, _jsx(SegmentLines, { lines: footerLines }), promptMode ? (_jsx(PromptInput, { label: "> ", labelColor: EXEC_MODE_COLORS[execMode], onSubmit: handlePromptSubmit, initialState: chatPromptState, onStateChange: setChatPromptState, onCancel: () => {
+                            setPromptMode(false);
+                            if (active?.id === 'chat') {
+                                setChatPromptDismissed(true);
+                            }
+                        }, onShiftTab: cycleExecMode, history: promptHistory })) : null] })] }));
 }
 //# sourceMappingURL=app.js.map