experimental-ash 0.54.0 → 0.55.1

package/dist/src/cli/dev/tui/runner.d.ts

@@ -0,0 +1,205 @@
+import { type ConnectionAuthorizationOutcome, Client, ClientSession } from "#client/index.js";
+import { type UIMessage, type UIMessageChunk } from "ai";
+import type { AssistantResponseStatsMode, TerminalPartDisplayMode, TuiDisplayOptions } from "./types.js";
+import { type TerminalInput, type TerminalOutput } from "./terminal-renderer.js";
+export type AgentTUIStreamResult = {
+    uiMessageStream: AsyncIterable<UIMessageChunk> | ReadableStream<UIMessageChunk>;
+    message?: UIMessage;
+    abort?: () => void;
+};
+export type AgentTUIStreamOptions = {
+    messages: UIMessage[];
+};
+export type AgentTUISessionOptions = {
+    title?: string;
+    initialPrompt?: string;
+    submittedPrompt?: string;
+    waitForExit?: boolean;
+    continueSession?: boolean;
+    tools?: TerminalPartDisplayMode;
+    reasoning?: TerminalPartDisplayMode;
+    subagents?: TerminalPartDisplayMode;
+    connectionAuth?: TerminalPartDisplayMode;
+    assistantResponseStats?: AssistantResponseStatsMode;
+    contextSize?: number;
+};
+export type AgentTUIToolApprovalRequest = {
+    approvalId: string;
+    toolCallId: string;
+    toolName: string;
+    title?: string;
+    input: unknown;
+    providerExecuted?: boolean;
+    messageId: string;
+    partIndex: number;
+};
+export type AgentTUIToolApprovalResponse = {
+    approved: boolean;
+    reason?: string;
+};
+export type AgentTUIInputOption = {
+    id: string;
+    label: string;
+    description?: string;
+    style?: "primary" | "danger" | "default";
+};
+export type AgentTUIInputQuestion = {
+    requestId: string;
+    prompt: string;
+    display: "select" | "text";
+    options?: ReadonlyArray<AgentTUIInputOption>;
+    allowFreeform?: boolean;
+};
+export type AgentTUIInputQuestionResponse = {
+    optionId?: string;
+    text?: string;
+};
+export type AgentTUIRenderer = {
+    readPrompt?(options?: AgentTUISessionOptions): Promise<string | undefined>;
+    readToolApproval?(request: AgentTUIToolApprovalRequest, options?: AgentTUISessionOptions): Promise<AgentTUIToolApprovalResponse>;
+    readInputQuestion?(question: AgentTUIInputQuestion, options?: AgentTUISessionOptions): Promise<AgentTUIInputQuestionResponse | undefined>;
+    renderStream(result: AgentTUIStreamResult, options?: AgentTUISessionOptions): Promise<UIMessage | undefined>;
+    /**
+     * Out-of-band update for one child step (reasoning + message text) of a
+     * subagent dispatch. Called by the runner as child-session stream events
+     * arrive. The renderer renders this as a body section colored by the
+     * subagent palette.
+     */
+    upsertSubagentStep?(update: SubagentStepUpdate): void;
+    /**
+     * Out-of-band update for one child tool call of a subagent dispatch.
+     */
+    upsertSubagentTool?(update: SubagentToolUpdate): void;
+    /**
+     * Registers a tool call id as originating from a subagent's child
+     * session. The renderer must skip rendering parent UIMessage tool parts
+     * for these ids — they are surfaced via {@link upsertSubagentTool}
+     * instead.
+     */
+    markChildToolCallId?(callId: string): void;
+    /**
+     * Out-of-band update for one MCP connection authorization lifecycle.
+     * Called by the runner as `authorization.*` events arrive.
+     * The renderer renders this as a persistent body section per
+     * connection that transitions through `required` → `pending` →
+     * one of the terminal `ConnectionAuthorizationOutcome` states.
+     */
+    upsertConnectionAuth?(update: ConnectionAuthUpdate): void;
+    /**
+     * Sets the number of connections currently awaiting an OAuth
+     * callback. The renderer overrides its bottom status bar with a
+     * "waiting for connection authorization" hint while this is > 0,
+     * so the user understands the agent is parked, not hung.
+     */
+    setConnectionAuthPendingCount?(count: number): void;
+    /**
+     * Clears the rendered transcript and resets per-conversation display
+     * state, leaving the UI interactive on a fresh screen. Used by the
+     * `/new` command to start a new session with a clean slate.
+     */
+    reset?(): void;
+    /**
+     * Tears down interactive mode and restores the terminal, as if the user
+     * pressed Ctrl+C. Used by the `/exit` command.
+     */
+    shutdown?(): void;
+};
+export type AshTUIRunnerOptions = TuiDisplayOptions & {
+    session: ClientSession;
+    /**
+     * Optional client used to attach to child sessions for live subagent
+     * stream observation. When omitted, the TUI still shows the subagent
+     * section but cannot surface the subagent's reasoning / response /
+     * intermediate events — only the parent-stream `called` and
+     * `completed` transitions.
+     */
+    client?: Client;
+    renderer?: AgentTUIRenderer;
+    screen?: TerminalOutput;
+    userInput?: TerminalInput;
+    /**
+     * Formats an error thrown while dispatching a turn (the initial
+     * `session.send()` POST — e.g. a transport failure or a Vercel
+     * Deployment Protection challenge) into the text rendered in the
+     * inline error region. Defaults to the error's message. Callers that
+     * know about transport-specific challenges (the `ash dev` glue) inject
+     * a richer formatter here.
+     */
+    formatTransportError?: (error: unknown) => string;
+};
+export declare class AshTUIRunner {
+    #private;
+    constructor(options: AshTUIRunnerOptions);
+    run(): Promise<void>;
+}
+type ResponseMetadata = {
+    usage?: {
+        totalTokens?: number;
+        outputTokens?: number;
+    };
+};
+type SubagentChildStep = {
+    reasoning: string;
+    message: string;
+    finalized: boolean;
+};
+type SubagentToolState = {
+    toolName: string;
+    input: unknown;
+    status: "approval-requested" | "executing" | "done" | "failed";
+    output?: unknown;
+    errorText?: string;
+};
+export type SubagentRun = {
+    name: string;
+    /**
+     * One entry per logical "child message" — independent of the child's
+     * `stepIndex` field, which the harness can reuse across multiple
+     * assistant messages within a turn (e.g. a message before a tool call
+     * and another message after the tool result both arrive under
+     * `stepIndex: 0`). The key is a monotonic counter so each
+     * `message.completed` opens a new box on the next inbound delta.
+     */
+    steps: Map<number, SubagentChildStep>;
+    /**
+     * Section currently accepting reasoning/message deltas. `null` means
+     * the next delta opens a new section.
+     */
+    currentSectionKey: number | null;
+    /** Monotonic counter for new section keys. */
+    nextSectionKey: number;
+    tools: Map<string, SubagentToolState>;
+};
+export type SubagentStepUpdate = {
+    callId: string;
+    subagentName: string;
+    sectionKey: number;
+    reasoning: string;
+    message: string;
+    finalized: boolean;
+};
+export type SubagentToolUpdate = {
+    callId: string;
+    subagentName: string;
+    childCallId: string;
+    toolName: string;
+    input: unknown;
+    status: "approval-requested" | "executing" | "done" | "failed";
+    output?: unknown;
+    errorText?: string;
+};
+export type ConnectionAuthChallenge = {
+    url?: string;
+    userCode?: string;
+    expiresAt?: string;
+    instructions?: string;
+};
+export type ConnectionAuthState = "required" | "pending" | ConnectionAuthorizationOutcome;
+export type ConnectionAuthUpdate = {
+    name: string;
+    description: string;
+    state: ConnectionAuthState;
+    challenge?: ConnectionAuthChallenge;
+    reason?: string;
+};
+export type { ResponseMetadata as _ResponseMetadata };

package/dist/src/cli/dev/tui/runner.js

@@ -0,0 +1 @@
+import{TerminalRenderer}from"./terminal-renderer.js";import{isCurrentTurnBoundaryEvent}from"#client/index.js";import{getToolName,isToolUIPart}from"ai";var AshTUIRunner=class{#e;#t;#n;#r;#i;#a;#o;#s;#c;#l;#u;#d=new Map;#f=new Map;#p=new Map;#m=new Map;#h=new Set;constructor(e){this.#e=e.session,e.client!==void 0&&(this.#t=e.client),this.#n=createRenderer(e)??createDefaultRenderer(e),this.#r=e.name??`Ash`,this.#i=e.tools??`full`,this.#a=e.reasoning??`full`,this.#o=e.subagents??`full`,this.#s=e.connectionAuth??`full`,this.#c=e.assistantResponseStats??`tokensPerSecond`,this.#l=e.contextSize,this.#u=e.formatTransportError??formatErrorMessage}async run(){let e=this.#r,t=[],n=0,generateMessageId=()=>`message-${++n}`,r,i,a=!1,o=!1;for(;;){if(!o){if(r==null){if(!this.#n.readPrompt){if(a)return;throw Error(`No prompt was provided and the renderer does not support prompt input.`)}try{r=await this.#n.readPrompt({title:e})}catch(e){if(isInterruptedError(e))return;throw e}if(r==null)return}let s=parsePromptCommand(r);if(s===`exit`){this.#n.shutdown?.();return}if(s===`new`){this.#g(),t.length=0,n=0,i=void 0,o=!1,r=void 0,this.#n.reset?.();continue}t.push(createUserMessage(generateMessageId(),r)),a=!0}let s=await this.#_({prompt:o?void 0:r,inputResponses:i,messages:t,generateMessageId});try{let n=await this.#n.renderStream(s,{title:e,submittedPrompt:r,continueSession:!!this.#n.readPrompt,tools:this.#i,reasoning:this.#a,subagents:this.#o,connectionAuth:this.#s,assistantResponseStats:this.#c,contextSize:this.#l,waitForExit:!1});if(n&&n.parts.length>0){let a=findPendingToolApprovalRequests(n),s=findPendingQuestionRequests(this.#d);if(a.length>0||s.length>0){let c=[];if(a.length>0){if(!this.#n.readToolApproval)throw Error(`Tool approval was requested, but the renderer does not support tool approval input.`);for(let t of a){let r=await this.#n.readToolApproval(t,{title:e});applyToolApprovalResponse(n,t,r);let i=this.#d.get(t.approvalId);i&&(c.push({requestId:i.requestId,optionId:r.approved?`approve`:`deny`}),this.#d.delete(t.approvalId))}}if(s.length>0){if(!this.#n.readInputQuestion)throw Error(`An interactive question was requested, but the renderer does not support input questions.`);for(let t of s){let n=toAgentTUIInputQuestion(t),r=await this.#n.readInputQuestion(n,{title:e});if(r===void 0)continue;let i={requestId:t.requestId};r.optionId!==void 0&&(i.optionId=r.optionId),r.text!==void 0&&(i.text=r.text),c.push(i),this.#d.delete(t.requestId)}}upsertResponseMessage(t,n,o),o=!0,i=c,r=void 0;continue}upsertResponseMessage(t,n,o)}}catch(e){if(isInterruptedError(e))return;throw e}o=!1,i=void 0,r=void 0}}#g(){for(let e of this.#p.values())e.abort();this.#p.clear(),this.#f.clear(),this.#d.clear(),this.#m.clear(),this.#h.clear(),this.#t&&(this.#e=this.#t.session())}async#_(e){let t={};e.prompt!==void 0&&(t.message=e.prompt),e.inputResponses!==void 0&&e.inputResponses.length>0&&(t.inputResponses=e.inputResponses);let n;try{n=await this.#e.send(t)}catch(t){if(isInterruptedError(t))throw t;return{uiMessageStream:errorOnlyUIMessageStream({errorText:this.#u(t),generateMessageId:e.generateMessageId,originalMessages:e.messages}),message:lastAssistantMessage(e.messages)}}return{uiMessageStream:ashEventsToUIMessageStream({events:n,generateMessageId:e.generateMessageId,originalMessages:e.messages,pendingInputRequests:this.#d,subagentRuns:this.#f,onSubagentCalled:e=>this.#x(e),onSubagentCompleted:e=>this.#C(e),onConnectionAuthRequired:e=>this.#v(e),onConnectionAuthCompleted:e=>this.#y(e)}),message:lastAssistantMessage(e.messages)}}#v(e){let t={name:e.data.name,description:e.data.description,state:`required`};e.data.authorization!==void 0&&(t.challenge=e.data.authorization),e.data.webhookUrl!==void 0&&(t.webhookUrl=e.data.webhookUrl),this.#m.set(e.data.name,t),this.#b(t)}#y(e){let t=this.#m.get(e.data.name)??{name:e.data.name,description:``,state:e.data.outcome};t.state=e.data.outcome,e.data.reason!==void 0&&(t.reason=e.data.reason),this.#m.set(e.data.name,t),this.#h.delete(e.data.name),this.#b(t),this.#n.setConnectionAuthPendingCount?.(this.#h.size)}#b(e){let t={name:e.name,description:e.description,state:e.state};e.challenge!==void 0&&(t.challenge=e.challenge),e.reason!==void 0&&(t.reason=e.reason),this.#n.upsertConnectionAuth?.(t)}#x(e){let n=e.data.callId;if(this.#p.has(n))return;let r=this.#t;if(!r)return;let i=new AbortController;this.#p.set(n,i),(async()=>{try{let a=r.session({sessionId:e.data.childSessionId,streamIndex:0}).openStream({signal:i.signal});for await(let e of a)if(i.signal.aborted||(this.#w(n,e),isCurrentTurnBoundaryEvent(e)))break}catch(e){if(!isAbortLikeError(e)){let t=formatErrorMessage(e),r=this.#f.get(n);if(r){let{key:e,step:i}=openCurrentSubagentSection(r);i.message=i.message?`${i.message}\n\nstream error: ${t}`:`stream error: ${t}`,i.finalized=!0,r.currentSectionKey=null,this.#n.upsertSubagentStep?.({callId:n,subagentName:r.name,sectionKey:e,reasoning:i.reasoning,message:i.message,finalized:!0})}}}finally{this.#p.delete(n)}})()}#S(e,t,n){let r=t.tools.get(n.childCallId),i=r??{toolName:n.toolName,input:n.input,status:n.status};if(r){let e={"approval-requested":0,executing:1,done:2,failed:2};e[n.status]>e[r.status]&&(r.status=n.status),r.input=n.input}else t.tools.set(n.childCallId,i);this.#n.markChildToolCallId?.(n.childCallId),this.#n.upsertSubagentTool?.({callId:e,subagentName:t.name,childCallId:n.childCallId,toolName:i.toolName,input:i.input,status:i.status})}#C(e){let t=this.#f.get(e);if(t){for(let[n,r]of t.steps)r.finalized||(r.finalized=!0,this.#n.upsertSubagentStep?.({callId:e,subagentName:t.name,sectionKey:n,reasoning:r.reasoning,message:r.message,finalized:!0}));t.currentSectionKey=null}}#w(e,t){let n=this.#f.get(e);if(!n)return;let r=this.#n,emit=(t,i)=>{r.upsertSubagentStep?.({callId:e,subagentName:n.name,sectionKey:t,reasoning:i.reasoning,message:i.message,finalized:i.finalized})},finalizeCurrent=()=>{if(n.currentSectionKey===null)return;let e=n.steps.get(n.currentSectionKey);e&&(e.finalized=!0,emit(n.currentSectionKey,e)),n.currentSectionKey=null};switch(t.type){case`reasoning.appended`:{let{key:e,step:r}=openCurrentSubagentSection(n);r.reasoning+=t.data.reasoningDelta,emit(e,r);break}case`reasoning.completed`:break;case`message.appended`:{let{key:e,step:r}=openCurrentSubagentSection(n);r.message+=t.data.messageDelta,emit(e,r);break}case`message.completed`:{let{key:e,step:r}=openCurrentSubagentSection(n);t.data.message!==null&&r.message.length===0&&(r.message=t.data.message),r.finalized=!0,emit(e,r),n.currentSectionKey=null;break}case`step.completed`:finalizeCurrent();break;case`actions.requested`:finalizeCurrent();for(let r of t.data.actions)r.kind===`tool-call`&&this.#S(e,n,{childCallId:r.callId,toolName:r.toolName,input:r.input,status:`executing`});break;case`input.requested`:finalizeCurrent();for(let r of t.data.requests)r.action.kind===`tool-call`&&this.#S(e,n,{childCallId:r.action.callId,toolName:r.action.toolName,input:r.action.input,status:`approval-requested`});break;case`action.result`:{let i=t.data.result;if(i.kind!==`tool-result`)break;let a=n.tools.get(i.callId);if(!a)break;t.data.status===`failed`?(a.status=`failed`,a.errorText=formatActionResultError(t)):(a.status=`done`,a.output=i.output);let o={callId:e,subagentName:n.name,childCallId:i.callId,toolName:a.toolName,input:a.input,status:a.status};a.output!==void 0&&(o.output=a.output),a.errorText!==void 0&&(o.errorText=a.errorText),r.upsertSubagentTool?.(o);break}default:break}}};function createDefaultRenderer(t){return t.tools===void 0&&t.reasoning===void 0&&t.subagents===void 0&&t.connectionAuth===void 0&&t.assistantResponseStats===void 0&&t.contextSize===void 0&&t.logs===void 0?new TerminalRenderer:new TerminalRenderer({tools:t.tools,reasoning:t.reasoning,subagents:t.subagents,connectionAuth:t.connectionAuth,assistantResponseStats:t.assistantResponseStats,contextSize:t.contextSize,logs:t.logs})}function createRenderer(t){if(t.renderer)return t.renderer;if(!(!t.screen&&!t.userInput))return new TerminalRenderer({tools:t.tools,reasoning:t.reasoning,subagents:t.subagents,connectionAuth:t.connectionAuth,assistantResponseStats:t.assistantResponseStats,contextSize:t.contextSize,logs:t.logs,input:t.userInput,output:t.screen})}async function*ashEventsToUIMessageStream(e){let{events:t,generateMessageId:n,originalMessages:r,pendingInputRequests:i,subagentRuns:a,onSubagentCalled:o,onSubagentCompleted:s,onConnectionAuthRequired:c,onConnectionAuthCompleted:l}=e,u=new Set,d=new Set,f=new Set,p=!1,m=!1,h,ensureStart=()=>{if(!p)return p=!0,{type:`start`,messageId:lastAssistantMessage(r)?.id??n()}};for await(let e of t){let t=ensureStart();switch(t&&(yield t),e.type){case`session.started`:case`turn.started`:case`message.received`:break;case`step.started`:yield{type:`start-step`};break;case`step.completed`:h=e.data.usage,yield*closeOpenTextParts(u),yield*closeOpenReasoningParts(d),yield{type:`finish-step`};break;case`message.appended`:{let t=e,n=textPartId(t.data.turnId,t.data.stepIndex);u.has(n)||(u.add(n),yield{type:`text-start`,id:n}),yield{type:`text-delta`,id:n,delta:t.data.messageDelta};break}case`message.completed`:{let t=textPartId(e.data.turnId,e.data.stepIndex);u.delete(t)&&(yield{type:`text-end`,id:t});break}case`reasoning.appended`:{let t=e,n=reasoningPartId(t.data.turnId,t.data.stepIndex);d.has(n)||(d.add(n),yield{type:`reasoning-start`,id:n}),yield{type:`reasoning-delta`,id:n,delta:t.data.reasoningDelta};break}case`reasoning.completed`:{let t=reasoningPartId(e.data.turnId,e.data.stepIndex);d.delete(t)&&(yield{type:`reasoning-end`,id:t});break}case`actions.requested`:{let t=e.data.actions;for(let e of t)e.kind===`tool-call`&&(f.add(e.callId),yield{type:`tool-input-available`,toolCallId:e.callId,toolName:e.toolName,input:e.input});break}case`input.requested`:{let t=e.data.requests;for(let e of t){if(e.action.kind!==`tool-call`)continue;let t=e.action.callId;f.has(t)||(f.add(t),yield{type:`tool-input-available`,toolCallId:t,toolName:e.action.toolName,input:e.action.input}),i.set(e.requestId,e),!isQuestionRequest(e)&&(yield{type:`tool-approval-request`,approvalId:e.requestId,toolCallId:t})}break}case`action.result`:{let t=e,n=t.data.result.callId;if(!f.has(n))break;t.data.status===`failed`?yield{type:`tool-output-error`,toolCallId:n,errorText:formatActionResultError(t)}:yield{type:`tool-output-available`,toolCallId:n,output:t.data.result.output};break}case`step.failed`:case`turn.failed`:case`session.failed`:yield{type:`error`,errorText:formatFailureMessage(e)};break;case`session.waiting`:case`session.completed`:case`turn.completed`:yield*closeOpenTextParts(u),yield*closeOpenReasoningParts(d),yield{type:`finish`,messageMetadata:createResponseMetadata(h)},m=!0;break;case`subagent.called`:{let t=e;if(!a.has(t.data.callId))a.set(t.data.callId,{name:t.data.name,steps:new Map,currentSectionKey:null,nextSectionKey:0,tools:new Map});else{let e=a.get(t.data.callId);e&&(e.name=t.data.name)}o?.(t);break}case`subagent.started`:case`subagent.event`:break;case`subagent.completed`:s?.(e.data.callId);break;case`authorization.required`:c?.(e);break;case`authorization.completed`:l?.(e);break;default:break}}p||(yield{type:`start`,messageId:n()}),m||(yield*closeOpenTextParts(u),yield*closeOpenReasoningParts(d),yield{type:`finish`,messageMetadata:createResponseMetadata(h)})}async function*errorOnlyUIMessageStream(e){yield{type:`start`,messageId:lastAssistantMessage(e.originalMessages)?.id??e.generateMessageId()},yield{type:`error`,errorText:e.errorText},yield{type:`finish`}}function textPartId(e,t){return`text:${e}:${t}`}function reasoningPartId(e,t){return`reasoning:${e}:${t}`}function*closeOpenTextParts(e){for(let t of e)yield{type:`text-end`,id:t};e.clear()}function*closeOpenReasoningParts(e){for(let t of e)yield{type:`reasoning-end`,id:t};e.clear()}function createResponseMetadata(e){if(!e)return;let{inputTokens:t,outputTokens:n}=e,r=t!=null||n!=null?(t??0)+(n??0):void 0;if(r==null&&n==null)return;let i={};return r!=null&&(i.totalTokens=r),n!=null&&(i.outputTokens=n),{usage:i}}function formatActionResultError(e){if(e.data.error?.message)return e.data.error.message;let t=e.data.result.output;if(typeof t==`string`)return t;try{return JSON.stringify(t)}catch{return`Tool execution failed.`}}function formatFailureMessage(e){let{code:t,message:n}=e.data;return t?`${t}: ${n}`:n}function createUserMessage(e,t){return{id:e,role:`user`,parts:[{type:`text`,text:t}]}}function upsertResponseMessage(e,t,n){if(n&&e.at(-1)?.role===`assistant`){e[e.length-1]=t;return}e.push(t)}function lastAssistantMessage(e){let t=e.at(-1);return t?.role===`assistant`?t:void 0}function isQuestionRequest(e){return e.display===`select`||e.display===`text`?!0:e.display===`confirmation`?!1:e.options!==void 0&&e.options.length>0}function findPendingQuestionRequests(e){let t=[];for(let n of e.values())isQuestionRequest(n)&&t.push(n);return t}function toAgentTUIInputQuestion(e){let t=e.display===`text`?`text`:e.display===`select`||e.options!==void 0&&e.options.length>0?`select`:`text`,n={requestId:e.requestId,prompt:e.prompt,display:t};return e.options!==void 0&&(n.options=e.options.map(e=>{let t={id:e.id,label:e.label};return e.description!==void 0&&(t.description=e.description),e.style!==void 0&&(t.style=e.style),t})),e.allowFreeform!==void 0&&(n.allowFreeform=e.allowFreeform),n}function findPendingToolApprovalRequests(e){let t=[];for(let[i,a]of e.parts.entries()){if(!isToolUIPart(a)||a.state!==`approval-requested`||a.approval.isAutomatic===!0)continue;let o={approvalId:a.approval.id,toolCallId:a.toolCallId,toolName:getToolName(a),input:a.input,messageId:e.id,partIndex:i};a.title!==void 0&&(o.title=a.title),a.providerExecuted!==void 0&&(o.providerExecuted=a.providerExecuted),t.push(o)}return t}function applyToolApprovalResponse(e,t,n){let i=e.parts[t.partIndex];if(!i||!isToolUIPart(i)||i.toolCallId!==t.toolCallId)throw Error(`Could not find tool approval request ${t.approvalId}.`);i.state=`approval-responded`;let a={id:t.approvalId,approved:n.approved};n.reason&&(a.reason=n.reason),i.approval=a}function isInterruptedError(e){return e instanceof Error&&e.message===`Interrupted`}function parsePromptCommand(e){let t=e.trim();return t===`/new`?`new`:t===`/exit`||t===`/quit`?`exit`:null}function isAbortLikeError(e){return!!(e instanceof Error&&(e.name===`AbortError`||e.message.toLowerCase().includes(`abort`)))}function formatErrorMessage(e){if(e instanceof Error)return e.message;if(typeof e==`string`)return e;try{return JSON.stringify(e)}catch{return String(e)}}function openCurrentSubagentSection(e){e.currentSectionKey===null&&(e.currentSectionKey=e.nextSectionKey++,e.steps.set(e.currentSectionKey,{reasoning:``,message:``,finalized:!1}));let t=e.steps.get(e.currentSectionKey);if(!t)throw Error(`invariant: subagent section state missing for current key`);return{key:e.currentSectionKey,step:t}}export{AshTUIRunner};

package/dist/src/cli/dev/tui/terminal-frame-buffer.d.ts

@@ -0,0 +1,21 @@
+export type TerminalFrameOutput = {
+    write(chunk: string | Uint8Array, encodingOrCallback?: BufferEncoding | ((error?: Error | null) => void), callback?: (error?: Error | null) => void): boolean;
+};
+export type TerminalFrameBufferOptions = {
+    useSynchronizedUpdates?: boolean;
+};
+export declare class TerminalFrameBuffer {
+    #private;
+    constructor(output: TerminalFrameOutput, options?: TerminalFrameBufferOptions);
+    present(frame: string): void;
+    reset(): void;
+    /**
+     * Writes a control sequence (e.g. alt-screen enter/exit, cursor
+     * show/hide) straight to the underlying terminal via the original
+     * write captured at construction. This bypasses any later monkey-patch
+     * of the output's `write` — notably the renderer's foreign-output log
+     * capture — so the renderer's own terminal control writes are never
+     * mistaken for captured log output.
+     */
+    writeControl(sequence: string): void;
+}

package/dist/src/cli/dev/tui/terminal-frame-buffer.js

@@ -0,0 +1,2 @@
+var TerminalFrameBuffer=class{#e;#t;#n;#r=!1;#i=!1;constructor(e,t){this.#t=e.write.bind(e),this.#e=t?.useSynchronizedUpdates??!0,e.write=((e,t,n)=>(this.#r||(this.#i=!0),this.#t(e,t,n)))}present(e){let t=snapshotFrame(e),n=this.#n&&!this.#i?diffFrame(this.#n,t):`${e}`;this.#n=t,this.#i=!1,n.length!==0&&this.#a(n)}reset(){this.#n=void 0}writeControl(e){this.#t(e)}#a(e){this.#r=!0;try{if(!this.#e){this.#t(e);return}this.#t(`[?2026h${e}[?2026l`)}finally{this.#r=!1}}};function snapshotFrame(e){return{lines:e.split(`
+`)}}function diffFrame(e,t){let n=``,r=Math.max(e.lines.length,t.lines.length);for(let i=0;i<r;i++){let r=t.lines[i];e.lines[i]!==r&&(n+=`[${i+1};1H${r??``}`)}return n}export{TerminalFrameBuffer};

package/dist/src/cli/dev/tui/terminal-renderer.d.ts

@@ -0,0 +1,111 @@
+import type { AgentTUIInputQuestion, AgentTUIInputQuestionResponse, AgentTUIStreamResult, AgentTUIToolApprovalRequest, AgentTUIToolApprovalResponse, ConnectionAuthUpdate, SubagentStepUpdate, SubagentToolUpdate } from "./runner.js";
+import type { AssistantResponseStatsMode, LogDisplayMode, TerminalPartDisplayMode } from "./types.js";
+import { TerminalFrameBuffer } from "./terminal-frame-buffer.js";
+import { type UIMessage } from "ai";
+export type TerminalInput = {
+    isTTY?: boolean;
+    on(event: "data", listener: (chunk: Buffer) => void): TerminalInput;
+    off(event: "data", listener: (chunk: Buffer) => void): TerminalInput;
+    resume(): TerminalInput;
+    pause(): TerminalInput;
+    setRawMode?: (mode: boolean) => TerminalInput;
+};
+export type TerminalOutput = {
+    columns?: number;
+    rows?: number;
+    write(chunk: string | Uint8Array, encodingOrCallback?: BufferEncoding | ((error?: Error | null) => void), callback?: (error?: Error | null) => void): boolean;
+    on(event: "resize", listener: () => void): TerminalOutput;
+    off(event: "resize", listener: () => void): TerminalOutput;
+};
+export type TerminalRendererOptions = {
+    input?: TerminalInput;
+    output?: TerminalOutput;
+    frameBuffer?: TerminalFrameBuffer;
+    tools?: TerminalPartDisplayMode;
+    reasoning?: TerminalPartDisplayMode;
+    subagents?: TerminalPartDisplayMode;
+    connectionAuth?: TerminalPartDisplayMode;
+    assistantResponseStats?: AssistantResponseStatsMode;
+    contextSize?: number;
+    /**
+     * Whether to capture foreign `process.stdout` / `process.stderr` writes
+     * (from the in-process dev server and agent code) and render them as
+     * inline log regions. Defaults to `true` only when the renderer is bound
+     * to the real `process.stdout`; tests can force it on with an injected
+     * screen.
+     */
+    captureForeignOutput?: boolean;
+    logs?: LogDisplayMode;
+};
+export type TerminalSessionOptions = {
+    title?: string;
+    initialPrompt?: string;
+    submittedPrompt?: string;
+    waitForExit?: boolean;
+    continueSession?: boolean;
+    tools?: TerminalPartDisplayMode;
+    reasoning?: TerminalPartDisplayMode;
+    subagents?: TerminalPartDisplayMode;
+    connectionAuth?: TerminalPartDisplayMode;
+    assistantResponseStats?: AssistantResponseStatsMode;
+    contextSize?: number;
+};
+export type TerminalKey = {
+    type: "character";
+    value: string;
+} | {
+    type: "backspace";
+} | {
+    type: "enter";
+} | {
+    type: "up";
+} | {
+    type: "down";
+} | {
+    type: "left";
+} | {
+    type: "right";
+} | {
+    type: "tab";
+} | {
+    type: "escape";
+} | {
+    type: "ctrl-r";
+} | {
+    type: "ctrl-c";
+} | {
+    type: "ignore";
+};
+export declare class TerminalRenderer {
+    #private;
+    constructor(options?: TerminalRendererOptions);
+    readPrompt(options?: TerminalSessionOptions): Promise<string>;
+    renderStream(result: AgentTUIStreamResult, options?: TerminalSessionOptions): Promise<UIMessage | undefined>;
+    readToolApproval(request: AgentTUIToolApprovalRequest, options?: TerminalSessionOptions): Promise<AgentTUIToolApprovalResponse>;
+    readInputQuestion(question: AgentTUIInputQuestion, options?: TerminalSessionOptions): Promise<AgentTUIInputQuestionResponse | undefined>;
+    upsertSubagentStep(update: SubagentStepUpdate): void;
+    upsertSubagentTool(update: SubagentToolUpdate): void;
+    markChildToolCallId(callId: string): void;
+    isChildToolCallId(callId: string): boolean;
+    upsertConnectionAuth(update: ConnectionAuthUpdate): void;
+    /**
+     * Sets the count of connections currently awaiting an OAuth
+     * callback. While the count is > 0, the bottom status bar shows a
+     * "waiting for connection authorization" hint that overrides the
+     * default streaming / processing message. The runner calls this on
+     * `authorization.required` (incrementing) and
+     * `authorization.completed` (decrementing) transitions.
+     */
+    setConnectionAuthPendingCount(count: number): void;
+    /**
+     * Clears the rendered transcript and per-conversation display state,
+     * leaving the UI interactive on a fresh screen. Backs the `/new` command.
+     */
+    reset(): void;
+    /**
+     * Tears down interactive mode and restores the terminal. Backs the
+     * `/exit` command, matching the Ctrl+C teardown.
+     */
+    shutdown(): void;
+}
+export declare function parseKey(chunk: Buffer): TerminalKey;

package/dist/src/cli/dev/tui/terminal-renderer.js

@@ -0,0 +1,12 @@
+import{sliceVisible,stripAnsi,visibleLength}from"./terminal-text.js";import{renderMarkdown}from"./markdown.js";import{renderScreenViewport}from"./layout.js";import{TerminalFrameBuffer}from"./terminal-frame-buffer.js";import{getToolName,isToolUIPart,readUIMessageStream}from"ai";const colors={reset:`\x1B[0m`,dim:`\x1B[2m`,user:`\x1B[96m`,assistant:`\x1B[92m`,reasoning:`\x1B[94m`,tool:`\x1B[95m`,error:`\x1B[91m`,question:`\x1B[93m`,subagent:`\x1B[38;5;208m`,connectionAuth:`\x1B[35m`,log:`\x1B[90m`},sectionStyles={user:{color:colors.user,border:`─`},assistant:{color:colors.assistant,border:`─`},reasoning:{color:colors.reasoning,border:`·`},tool:{color:colors.tool,border:`─`},error:{color:colors.error,border:`─`},question:{color:colors.question,border:`─`},"subagent-step":{color:colors.subagent,border:`─`},"subagent-tool":{color:colors.subagent,border:`─`},"connection-auth":{color:colors.connectionAuth,border:`─`},log:{color:colors.log,border:`·`}},processingStatus=`Processing input... ↑/↓ scroll · Ctrl+C quit`,processingToolResultsStatus=`Processing tool results... ↑/↓ scroll · Ctrl+C quit`,streamingStatus=`Streaming... ↑/↓ scroll · Ctrl+C quit`,executingToolsStatus=`Executing tools... ↑/↓ scroll · Ctrl+C quit`;var TerminalRenderer=class{#e;#t;#n;#r;#i;#a;#o;#s;#c;#l=[];#u=new Set;#d=new Map;#f=0;#p=``;#m=!1;#h=0;#g=`Agent TUI`;#_=streamingStatus;#v=!1;#y=!1;#b;#x;#S;#C;#w=!0;#T;#E;#D;#O;#k;#A=``;#j=``;#M;#N;#P;constructor(e){this.#e=e?.input??process.stdin,this.#t=e?.output??process.stdout,this.#n=e?.frameBuffer??new TerminalFrameBuffer(this.#t),this.#r=e?.tools??`full`,this.#i=e?.reasoning??`full`,this.#a=e?.subagents??`full`,this.#o=e?.connectionAuth??`full`,this.#s=e?.assistantResponseStats??`tokensPerSecond`,this.#c=e?.contextSize,this.#x=e?.contextSize,this.#M=e?.captureForeignOutput??this.#t===process.stdout,this.#N=e?.logs??`all`}async readPrompt(e){return this.#F(e),this.#m=!0,this.#p=e?.initialPrompt??``,this.#_=`Type a prompt and press Enter · ↑/↓ scroll · Ctrl+C quit`,this.#V(),this.#ne(),await new Promise((e,t)=>{this.#E=n=>{let r=parseKey(n);switch(r.type){case`character`:this.#p+=r.value,this.#U(),this.#ne();break;case`backspace`:this.#p=this.#p.slice(0,-1),this.#U(),this.#ne();break;case`enter`:{let t=this.#p;this.#m=!1,this.#H(),this.#_=processingStatus,this.#G(t),this.#P=t,this.#p=``,this.#ne(),this.#R(),e(t);break}case`up`:case`down`:this.#B(r.type);break;case`ctrl-r`:this.#re();break;case`ctrl-c`:this.#H(),this.#I(),t(interruptedError());break;case`ignore`:break}},this.#L()})}async renderStream(e,t){this.#F(t),this.#m=!1,this.#_=processingStatus,this.#W(t?.submittedPrompt),this.#y=!1,this.#b=void 0,this.#S=void 0,this.#C=void 0;let n={tools:t?.tools??this.#r,reasoning:t?.reasoning??this.#i,assistantResponseStats:t?.assistantResponseStats??this.#s};this.#ne();let r=new Promise(e=>{this.#O=e});this.#E=e=>this.#z(e),this.#L();let i,a=toReadableStream(this.#Y(e.uiMessageStream));try{let t=readUIMessageStream({message:e.message,stream:a,onError:e=>this.#X(`Error`,formatStreamError(e))});for await(let e of takeUntil(t,r)){if(this.#y)break;i=e,this.#K(e,n)}!this.#y&&i&&this.#S!=null&&this.#K(i,n)}finally{this.#O=void 0,this.#y&&e.abort?.(),this.#R(),this.#_=this.#y?`Interrupted`:t?.continueSession?`Done · Enter another prompt · ↑/↓ scroll · Ctrl+C quit`:`Done · ↑/↓ scroll · q/Ctrl+C quit`,this.#ne(),await this.#ue(t),(this.#y||!t?.continueSession)&&this.#I()}if(this.#y)throw interruptedError();return i}async readToolApproval(e,t){return this.#F(t),this.#m=!1,this.#_=`Approve ${formatToolApprovalTitle(e)}? y/n · ↑/↓ scroll · Ctrl+C quit`,this.#y=!1,this.#ne(),await new Promise((e,t)=>{this.#E=n=>{let r=parseKey(n);switch(r.type){case`character`:{let t=r.value.toLowerCase();t===`y`?(this.#_=`Approved · Processing input... ↑/↓ scroll · Ctrl+C quit`,this.#R(),this.#ne(),e({approved:!0})):t===`n`&&(this.#_=`Denied · Processing input... ↑/↓ scroll · Ctrl+C quit`,this.#R(),this.#ne(),e({approved:!1,reason:`Denied by user.`}));break}case`up`:case`down`:this.#B(r.type);break;case`ctrl-r`:this.#re();break;case`ctrl-c`:this.#y=!0,this.#I(),t(interruptedError());break;default:break}},this.#L()})}async readInputQuestion(e,t){this.#F(t),this.#m=!1,this.#y=!1;let n=e.options??[],r=n.length>0,i=(e.allowFreeform===!0||!r)&&r,a=n.length+ +!!i,o=questionSectionId(e.requestId),s=r?`select`:`text`,c=r?0:n.length,l=``,isOnFreeformRow=()=>i&&c===n.length,renderSection=()=>{let t=this.#oe();this.#q({id:o,kind:`question`,title:`Question`,rightTitle:`pending`,content:formatQuestionSectionContent(e,c)}),this.#te(t)};renderSection();let repaintStatus=()=>{if(s===`select`){let e=[`↑/↓ select`];e.push(isOnFreeformRow()?`enter type`:`enter confirm`),e.push(`Ctrl+C quit`),this.#_=e.join(` · `)}else{let e=this.#w?`_`:` `,t=[`enter send`];t.push(r?`esc back`:`esc clear`),t.push(`Ctrl+C quit`),this.#_=`> ${l}${e}   ${t.join(` · `)}`}this.#ne()};s===`text`&&this.#V(),repaintStatus();let finalize=t=>{let n=this.#oe();this.#q({id:o,kind:`question`,title:`Question`,rightTitle:`answered`,content:formatAnsweredQuestionContent(e,t.label)}),this.#_=`Answered · Processing input... ↑/↓ scroll · Ctrl+C quit`,this.#H(),this.#R(),this.#te(n);let r={};return t.optionId!==void 0&&(r.optionId=t.optionId),t.text!==void 0&&(r.text=t.text),r};return await new Promise((t,i)=>{this.#E=o=>{let u=parseKey(o);if(u.type===`ctrl-c`){this.#y=!0,this.#H(),this.#I(),i(interruptedError());return}if(u.type===`ctrl-r`){this.#re();return}if(s===`select`){switch(u.type){case`up`:a>0&&(c=(c-1+a)%a,renderSection(),repaintStatus());break;case`down`:a>0&&(c=(c+1)%a,renderSection(),repaintStatus());break;case`enter`:{if(isOnFreeformRow()){s=`text`,l=``,this.#V(),repaintStatus();break}let e=n[c];e&&t(finalize({optionId:e.id,label:e.label}));break}default:break}return}switch(u.type){case`character`:l+=u.value,this.#U(),repaintStatus();break;case`backspace`:l=l.slice(0,-1),this.#U(),repaintStatus();break;case`enter`:{let n=resolveQuestionText(l,e);if(n===void 0)break;t(finalize(n));break}case`escape`:if(r){if(l.length>0){l=``,this.#U(),repaintStatus();break}s=`select`,l=``,this.#H(),repaintStatus();break}l=``,this.#U(),repaintStatus();break;default:break}},this.#L()})}#F(e){this.#g=e?.title??this.#g,this.#x=e?.contextSize??this.#c,!this.#v&&(this.#v=!0,this.#n.reset(),this.#n.writeControl(`\x1B[?1049h\x1B[?25l`),this.#Z(),this.#e.isTTY&&(this.#e.setRawMode?.(!0),this.#e.resume()),this.#D=()=>this.#re(),this.#t.on(`resize`,this.#D))}#I(){this.#R(),this.#H(),this.#v&&=(this.#e.isTTY&&(this.#e.setRawMode?.(!1),this.#e.pause()),this.#D&&=(this.#t.off(`resize`,this.#D),void 0),this.#Q(),this.#n.writeControl(`\x1B[?25h\x1B[?1049l`),this.#n.reset(),!1)}#L(){this.#E&&this.#e.on(`data`,this.#E)}#R(){this.#E&&=(this.#e.off(`data`,this.#E),void 0)}#z(e){let t=parseKey(e);switch(t.type){case`up`:case`down`:this.#B(t.type);break;case`ctrl-r`:this.#re();break;case`ctrl-c`:this.#y=!0,this.#O?.();break;default:break}}#B(e){let t=e===`up`?1:-1;this.#h=this.#ae(this.#h+t),this.#ne()}#V(){this.#H(),this.#U(),this.#T=setInterval(()=>{this.#w=!this.#w,this.#ne()},500),this.#T.unref?.()}#H(){this.#T&&=(clearInterval(this.#T),void 0),this.#w=!0}#U(){this.#w=!0}#W(e){if(e!=null){if(this.#P===e){this.#P=void 0;return}this.#G(e)}}#G(e){let t=this.#oe();this.#l.push({kind:`user`,title:`User`,content:e}),this.#te(t)}#K(e,t){let n=this.#oe(),r=new Set,i=extractAssistantResponseStatsFromMetadata(e.metadata);this.#b=i.totalTokens??this.#b,this.#S=i.outputTokens??this.#S,this.#C=i.tokensPerSecond??this.#C;for(let[n,i]of e.parts.entries()){let a=sectionId(e.id,n);switch(i.type){case`text`:{let e=i.text.trim();if(e.length===0)break;r.add(a),this.#q({id:a,kind:`assistant`,title:`Assistant`,rightTitle:formatAssistantResponseStats({totalTokens:this.#b,outputTokens:this.#S,tokensPerSecond:this.#C},t.assistantResponseStats),content:e});break}case`reasoning`:{let o=i.text.trim();if(t.reasoning===`hidden`||o.length===0)break;r.add(a),this.#q({id:a,kind:`reasoning`,title:`Reasoning`,content:o,collapsed:shouldCollapsePart(e,n,t.reasoning,t)});break}default:if(isToolUIPart(i)){if(t.tools===`hidden`||this.#u.has(i.toolCallId))break;r.add(a),this.#d.set(i.toolCallId,a),this.#q({id:a,...renderToolInvocation(i,{mode:t.tools,collapsed:shouldCollapsePart(e,n,t.tools,t)})})}break}}this.#J(e.id,r),this.#te(n)}#q(e){let t=e.id?this.#l.find(t=>t.id===e.id):void 0;if(t){let n=t.cache;t.kind=e.kind,t.title=e.title,t.rightTitle=e.rightTitle,t.content=e.content,t.collapsed=e.collapsed,t.cache=n&&sectionMatchesCache(e,n)?n:void 0;return}this.#l.push(e)}#J(e,t){let n=`${e}:`;this.#l=this.#l.filter(e=>e.id==null||!e.id.startsWith(n)||t.has(e.id))}async*#Y(e){let t=!1;for await(let n of iterateUIMessageStream(e)){let e=statusForStreamChunk(n,{hasPendingToolResults:t});if(n.type===`start-step`?t=!1:finishesToolExecution(n)&&(t=!0),e&&this.#_!==e?(this.#_=e,this.#ne()):startsVisibleAssistantStream(n)&&this.#_!==streamingStatus&&(this.#_=streamingStatus,this.#ne()),n.type===`finish`){let e=extractAssistantResponseStats(n);this.#b=e.totalTokens,this.#S=e.outputTokens,this.#C=e.tokensPerSecond}yield n}}upsertSubagentStep(e){if(this.#a===`hidden`)return;let t=this.#oe(),n=e.reasoning?.trim()??``,r=e.message?.trim()??``;if(n.length===0&&r.length===0){this.#te(t);return}let i=this.#a===`collapsed`||this.#a===`auto-collapsed`&&e.finalized,a=[];if(n.length>0){let e=n.split(`
+`).map(e=>`${colors.dim}  ${e}${colors.reset}`).join(`
+`);a.push(e)}r.length>0&&a.push(r);let o={id:subagentStepSectionId(e.callId,e.sectionKey),kind:`subagent-step`,title:`Subagent · ${e.subagentName}`,content:a.join(`
+
+`)};e.finalized||(o.rightTitle=`streaming`),i&&(o.collapsed=!0),this.#q(o),this.#te(t)}upsertSubagentTool(e){if(this.#a===`hidden`)return;let t=this.#oe(),n=this.#a===`collapsed`||this.#a===`auto-collapsed`&&e.status!==`executing`,r=[];e.input!==void 0&&r.push(`Input:\n${formatValue(e.input)}`),e.output===void 0?e.errorText!==void 0&&r.push(`Error:\n${e.errorText}`):r.push(`Output:\n${formatValue(e.output)}`);let i={id:subagentToolSectionId(e.callId,e.childCallId),kind:`subagent-tool`,title:`Subagent · ${e.subagentName} · Tool · ${e.toolName}`,rightTitle:e.status,content:r.join(`
+
+`)};n&&(i.collapsed=!0),this.#q(i),this.#te(t)}markChildToolCallId(e){this.#u.add(e);let t=this.#d.get(e);if(t===void 0)return;let n=this.#oe();this.#l=this.#l.filter(e=>e.id!==t),this.#d.delete(e),this.#te(n)}isChildToolCallId(e){return this.#u.has(e)}upsertConnectionAuth(e){if(this.#o===`hidden`)return;let t=this.#oe(),n=e.state===`authorized`||e.state===`declined`||e.state===`failed`||e.state===`timed-out`,r=this.#o===`collapsed`||this.#o===`auto-collapsed`&&n,i={id:connectionAuthSectionId(e.name),kind:`connection-auth`,title:`Connection · ${e.name} · Auth`,rightTitle:e.state,content:formatConnectionAuthSectionContent(e)};r&&(i.collapsed=!0),this.#q(i),this.#te(t)}setConnectionAuthPendingCount(e){let t=Math.max(0,e);if(t===this.#f)return;let n=this.#f>0;this.#f=t,t>0?(this.#_=`Waiting for connection authorization — visit the URL above · Ctrl+C quit`,this.#ne()):n&&(this.#_=processingStatus,this.#ne())}reset(){this.#l=[],this.#u.clear(),this.#d.clear(),this.#P=void 0,this.#f=0,this.#h=0,this.#b=void 0,this.#S=void 0,this.#C=void 0,this.#v&&this.#re()}shutdown(){this.#I()}#X(e,t){let n=this.#oe();this.#l.push({kind:`error`,title:e,content:t}),this.#te(n)}#Z(){if(this.#k!==void 0||!this.#M)return;this.#A=``,this.#j=``;let capture=(e,t)=>{let n=e.write.bind(e);return e.write=((e,n,r)=>{let i=typeof n==`string`?n:void 0,a=typeof n==`function`?n:r;return this.#$(t,chunkToString(e,i)),a?.(),!0}),()=>{e.write=n}},e=capture(process.stdout,`stdout`),t=capture(process.stderr,`stderr`);this.#k=()=>{e(),t()}}#Q(){let e=this.#k;e!==void 0&&(this.#k=void 0,e(),this.#A.length>0&&(this.#ee(`stdout`)&&process.stdout.write(`${this.#A}\n`),this.#A=``),this.#j.length>0&&(this.#ee(`stderr`)&&process.stderr.write(`${this.#j}\n`),this.#j=``))}#$(e,n){let r=(e===`stdout`?this.#A:this.#j)+n,i=r.lastIndexOf(`
+`),a=i===-1?r:r.slice(i+1);if(e===`stdout`?this.#A=a:this.#j=a,i===-1||!this.#ee(e))return;let o=stripAnsi(r.slice(0,i)).replace(/\s+$/u,``);if(o.trim().length===0)return;let s=this.#oe();this.#l.push({kind:`log`,title:`Log · ${e}`,content:o}),this.#te(s)}#ee(e){switch(this.#N){case`none`:return!1;case`stderr`:return e===`stderr`;case`all`:return!0}}#te(e){if(this.#h!==0){let t=this.#oe()-e;this.#h=this.#ae(this.#h+t)}this.#ne()}#ne(){let e=renderScreenViewport({width:this.#ce(),height:this.#le(),title:this.#g,rightTitle:formatTokenCount(this.#b,this.#x),visibleBodyLines:this.#ie(),input:this.#p,inputActive:this.#m,inputCursorVisible:this.#w,status:this.#_});this.#n.present(e)}#re(){this.#n.reset(),this.#ne()}#ie(){if(this.#l.length===0)return[`Waiting for input...`];let e=this.#se(),t=this.#oe(),n=Math.max(0,t-e-this.#h),r=n+e,i=[],a=0;for(let t of this.#l){let o=renderSectionLines(t,this.#ce()-4),s=a+o.length;if(s>n&&a<r&&i.push(...o.slice(Math.max(0,n-a),r-a)),i.length>=e)break;a=s}return i}#ae(e){let t=Math.max(0,this.#oe()-this.#se());return Math.min(Math.max(0,e),t)}#oe(){if(this.#l.length===0)return 1;let e=0;for(let t of this.#l)e+=renderSectionLines(t,this.#ce()-4).length;return e}#se(){return Math.max(1,this.#le()-5)}#ce(){return Math.max(20,this.#t.columns??80)}#le(){return Math.max(8,this.#t.rows??24)}async#ue(e){e?.waitForExit===!1||!this.#e.isTTY||this.#y||await new Promise(e=>{this.#E=t=>{let n=parseKey(t);switch(n.type){case`up`:case`down`:this.#B(n.type);break;case`ctrl-r`:this.#re();break;case`character`:n.value===`q`&&(this.#R(),e());break;case`ctrl-c`:this.#R(),process.exitCode=130,e();break;default:break}},this.#L()})}};function interruptedError(){return Error(`Interrupted`)}function chunkToString(e,t){return typeof e==`string`?e:Buffer.from(e).toString(t)}async function*takeUntil(e,t){let n=e[Symbol.asyncIterator](),r=t.then(()=>({done:!0,value:void 0}));for(;;){let e=await Promise.race([n.next(),r]);if(e.done)break;yield e.value}}function formatStreamError(e){return e instanceof Error?e.message:typeof e==`string`?e:JSON.stringify(e)}function renderToolInvocation(e,t){let n=getToolName(e),r=`Tool · ${e.title??n}`,i=`input`in e?e.input:void 0,a=i===void 0?`Input: (streaming...)`:`Input:\n${formatValue(i)}`,s=toolStatus(e);if(t.collapsed)return{kind:`tool`,title:r,rightTitle:s,content:``,collapsed:!0};switch(e.state){case`input-streaming`:return{kind:`tool`,title:r,rightTitle:s,content:a};case`input-available`:return{kind:`tool`,title:r,rightTitle:s,content:a};case`approval-requested`:return{kind:`tool`,title:r,rightTitle:s,content:a};case`approval-responded`:return{kind:`tool`,title:r,rightTitle:s,content:a};case`output-available`:return{kind:`tool`,title:r,rightTitle:s,content:`${a}\n\nOutput:\n${formatValue(e.output)}`};case`output-error`:return{kind:`error`,title:`Tool Error · ${e.title??n}`,rightTitle:s,content:`${a}\n\nError:\n${e.errorText}`};case`output-denied`:return{kind:`error`,title:`Tool Denied · ${e.title??n}`,rightTitle:s,content:`${a}\n\nReason: ${e.approval.reason??`denied`}`}}}function shouldCollapsePart(e,t,n,r){switch(n){case`collapsed`:return!0;case`auto-collapsed`:return e.parts.slice(t+1).some(e=>isVisibleAssistantPart(e,r));case`full`:case`hidden`:return!1}}function isVisibleAssistantPart(e,t){switch(e.type){case`text`:return e.text.trim().length>0;case`reasoning`:return t.reasoning!==`hidden`&&e.text.trim().length>0;default:return isToolUIPart(e)&&t.tools!==`hidden`}}function startsVisibleAssistantStream(e){switch(e.type){case`text-start`:case`text-delta`:case`reasoning-start`:case`reasoning-delta`:case`tool-input-start`:case`tool-input-delta`:return!0;default:return!1}}function statusForStreamChunk(e,{hasPendingToolResults:t}){switch(e.type){case`start-step`:return t?processingToolResultsStatus:processingStatus;case`tool-output-available`:case`tool-output-error`:case`tool-output-denied`:return processingToolResultsStatus;case`tool-input-available`:return executingToolsStatus;case`tool-approval-response`:return e.approved?executingToolsStatus:void 0;default:return}}function finishesToolExecution(e){switch(e.type){case`tool-output-available`:case`tool-output-error`:case`tool-output-denied`:return!0;default:return!1}}function toolStatus(e){switch(e.state){case`input-streaming`:return`waiting`;case`approval-requested`:return`approval requested`;case`input-available`:return`executing`;case`approval-responded`:return e.approval.approved?`executing`:`denied`;case`output-available`:case`output-error`:return`done`;case`output-denied`:return`denied`}}function formatValue(e){return typeof e==`string`?e:JSON.stringify(e,null,2)}function formatToolApprovalTitle(e){return`tool ${e.title??e.toolName}`}function sectionId(e,t){return`${e}:${t}`}function questionSectionId(e){return`question:${e}`}function subagentStepSectionId(e,t){return`subagent:${e}:step:${t}`}function subagentToolSectionId(e,t){return`subagent:${e}:tool:${t}`}function connectionAuthSectionId(e){return`connection-auth:${e}`}function formatConnectionAuthSectionContent(e){let t=[];e.description.length>0&&t.push(e.description);let n=e.challenge;return n?.url&&t.push(`URL: ${n.url}`),n?.userCode&&t.push(`Code: ${n.userCode}`),n?.expiresAt&&t.push(`Expires: ${n.expiresAt}`),n?.instructions&&t.push(n.instructions),e.reason!==void 0&&e.reason.length>0&&t.push(`Reason: ${e.reason}`),t.join(`
+`)}function formatQuestionSectionContent(e,t){let n=[];n.push(e.prompt),n.push(``);let r=e.options??[];if(r.length>0){for(let[e,i]of r.entries()){let r=i.description?`  — ${i.description}`:``,a=t===e,o=a?`▸ `:`  `,s=`${i.label}${r}`,c=a?`${colors.question}${o}${s}${colors.reset}`:`${o}${s}`;n.push(c)}if(e.allowFreeform===!0){let e=t===r.length,i=e?`▸ `:`  `,a=`Type your own answer`;n.push(e?`${colors.question}${i}${a}${colors.reset}`:`${colors.dim}${i}${a}${colors.reset}`)}}else n.push(`${colors.dim}  (type your answer)${colors.reset}`);return n.join(`
+`)}function formatAnsweredQuestionContent(e,t){return`${e.prompt}\n\n  ✓ ${t}`}function resolveQuestionText(e,t){let n=e.trim();if(n.length===0)return;let r=n.toLowerCase(),i=t.options??[];if(i.length>0){let e=matchQuestionOption(r,i);if(e!==void 0)return{optionId:e.id,label:e.label}}if(t.allowFreeform===!0||i.length===0)return{text:n,label:n}}function matchQuestionOption(e,t){let n=t.find(t=>t.id.toLowerCase()===e);if(n!==void 0)return n;let r=t.find(t=>t.label.toLowerCase()===e);if(r!==void 0)return r;let i=Number(e);if(Number.isInteger(i)&&i>0&&i<=t.length)return t[i-1]}function toReadableStream(e){return e instanceof ReadableStream?e:new ReadableStream({async start(t){try{for await(let n of e)t.enqueue(n);t.close()}catch(e){t.error(e)}}})}async function*iterateUIMessageStream(e){if(e instanceof ReadableStream){let t=e.getReader();try{for(;;){let{done:e,value:n}=await t.read();if(e)return;yield n}}finally{t.releaseLock()}return}yield*e}function renderSectionLines(e,t){if(e.cache&&sectionMatchesCache(e,e.cache,t))return e.cache.lines;let n=createSectionLines(e,t);return e.cache={width:t,kind:e.kind,title:e.title,rightTitle:e.rightTitle,content:e.content,collapsed:e.collapsed===!0,lines:n},n}function sectionMatchesCache(e,t,n=t.width){return t.width===n&&t.kind===e.kind&&t.title===e.title&&t.rightTitle===e.rightTitle&&t.content===e.content&&t.collapsed===(e.collapsed===!0)}function createSectionLines(e,t){let n=sectionStyles[e.kind],i=Math.max(1,t-4),a=` ${e.title} `,o=e.rightTitle?` ${e.rightTitle} `:``;if(e.collapsed){let e=Math.max(0,t-2-a.length-o.length);return[`${n.color}╭${a}${n.border.repeat(e)}${o}╮${colors.reset}`,`${n.color}╰${n.border.repeat(Math.max(0,t-2))}╯${colors.reset}`]}let s=Math.max(0,t-2-a.length-o.length),c=`${n.color}╭${a}${n.border.repeat(s)}${o}╮${colors.reset}`,d=`${n.color}╰${n.border.repeat(Math.max(0,t-2))}╯${colors.reset}`;return[c,...(e.content.length===0?colors.dim+`(streaming...)`+colors.reset:e.kind===`log`?e.content:renderMarkdown(e.content)).split(`
+`).flatMap(e=>wrapVisibleLine(e,i)).map(e=>sectionLine(e,i,n.color)),d]}function sectionLine(t,r,i){let a=sliceVisible(t,r),o=` `.repeat(Math.max(0,r-visibleLength(a)));return`${i}│${colors.reset} ${a}${o} ${i}│${colors.reset}`}function wrapVisibleLine(e,t){if(e.length===0)return[``];let r=[],i=e;for(;visibleLength(i)>t;){let e=findVisibleBreakPoint(i,t);r.push(i.slice(0,e).trimEnd()),i=i.slice(e).trimStart()}return r.push(i),r}function findVisibleBreakPoint(t,n){let r=sliceVisible(t,n+1).lastIndexOf(` `);return r>0?r:sliceVisible(t,n).length}function extractAssistantResponseStats(e){let t=`usage`in e?e.usage:void 0,n=`messageMetadata`in e?e.messageMetadata?.usage:void 0,r=`messageMetadata`in e?e.messageMetadata?.performance:void 0;return{totalTokens:extractTotalTokenCountFromUsage(t??n),outputTokens:extractOutputTokenCountFromUsage(t??n),tokensPerSecond:r?.outputTokensPerSecond}}function extractAssistantResponseStatsFromMetadata(e){let t=e;return{totalTokens:extractTotalTokenCountFromUsage(t?.usage),outputTokens:extractOutputTokenCountFromUsage(t?.usage),tokensPerSecond:t?.performance?.outputTokensPerSecond}}function extractTotalTokenCountFromUsage(e){let t=e?.totalTokens;if(typeof t==`number`)return t;if(typeof t?.total==`number`)return t.total;let n=extractInputTokenCountFromUsage(e),r=extractOutputTokenCountFromUsage(e);if(n!=null&&r!=null)return n+r}function extractInputTokenCountFromUsage(e){let t=e?.inputTokens;return typeof t==`number`?t:typeof t?.total==`number`?t.total:e?.promptTokens}function extractOutputTokenCountFromUsage(e){let t=e?.outputTokens;return typeof t==`number`?t:typeof t?.total==`number`?t.total:e?.completionTokens}function formatTokenCount(e,t){if(e==null)return;let n=`${e.toLocaleString()} ${e===1?`token`:`tokens`}`,r=formatContextPercentage(e,t);return r==null?n:`${n} ${r}`}function formatContextPercentage(e,t){if(!(t==null||t<=0||!Number.isFinite(t)))return`${Math.round(e/t*100).toLocaleString()}%`}function formatAssistantResponseStats(e,t){return t===`tokensPerSecond`?formatTokensPerSecond(e.tokensPerSecond):formatTokenCount(e.outputTokens)}function formatTokensPerSecond(e){if(e!=null)return`${formatNumber(e)} tok/s`}function formatNumber(e){return Number.isInteger(e)?e.toLocaleString():e.toLocaleString(void 0,{maximumFractionDigits:1})}function parseKey(e){let t=e.toString(`utf8`);switch(t){case``:return{type:`ctrl-r`};case``:return{type:`ctrl-c`};case`\r`:case`
+`:return{type:`enter`};case``:case`\b`:return{type:`backspace`};case`\x1B[A`:return{type:`up`};case`\x1B[B`:return{type:`down`};case`\x1B[C`:return{type:`right`};case`\x1B[D`:return{type:`left`};case`	`:return{type:`tab`};case`\x1B`:return{type:`escape`};default:return t>=` `&&t!==``?{type:`character`,value:t}:{type:`ignore`}}}export{TerminalRenderer,parseKey};

package/dist/src/cli/dev/tui/terminal-text.d.ts

@@ -0,0 +1,6 @@
+export declare const ansiPattern: RegExp;
+export declare const ansiPrefixPattern: RegExp;
+export declare function stripAnsi(input: string): string;
+export declare function visibleLength(input: string): number;
+export declare function sliceVisible(input: string, width: number): string;
+export declare function codePointWidth(codePoint: number): number;

package/dist/src/cli/dev/tui/terminal-text.js

@@ -0,0 +1 @@
+const ansiPattern=RegExp(`\x1B\\[[0-?]*[ -/]*[@-~]`,`g`),ansiPrefixPattern=RegExp(`^\x1B\\[[0-?]*[ -/]*[@-~]`);function stripAnsi(t){return t.replaceAll(ansiPattern,``)}function visibleLength(e){let n=0,r=0;for(;r<e.length;){let i=e.slice(r).match(ansiPrefixPattern);if(i){r+=i[0].length;continue}let a=e.codePointAt(r);if(a==null)break;let o=String.fromCodePoint(a);n+=codePointWidth(a),r+=o.length}return n}function sliceVisible(e,n){if(n<=0)return``;let r=``,i=0,a=0;for(;a<e.length&&i<n;){let o=e.slice(a).match(ansiPrefixPattern);if(o){r+=o[0],a+=o[0].length;continue}let s=e.codePointAt(a);if(s==null)break;let c=String.fromCodePoint(s),l=codePointWidth(s);if(l>0&&i+l>n)break;r+=c,a+=c.length,i+=l}for(;a<e.length;){let n=e.slice(a).match(ansiPrefixPattern);if(!n)break;r+=n[0],a+=n[0].length}return r}function codePointWidth(e){return e===9?4:e<32||e>=127&&e<160||isZeroWidthCodePoint(e)?0:isWideCodePoint(e)?2:1}function isZeroWidthCodePoint(e){return e>=768&&e<=879||e>=1155&&e<=1161||e>=1425&&e<=1469||e===1471||e>=1473&&e<=1474||e>=1476&&e<=1477||e===1479||e>=1552&&e<=1562||e>=1611&&e<=1631||e===1648||e>=1750&&e<=1756||e>=1759&&e<=1764||e>=1767&&e<=1768||e>=1770&&e<=1773||e===1809||e>=1840&&e<=1866||e>=1958&&e<=1968||e>=2027&&e<=2035||e>=2070&&e<=2073||e>=2075&&e<=2083||e>=2085&&e<=2087||e>=2089&&e<=2093||e>=2137&&e<=2139||e>=2259&&e<=2306||e===2362||e===2364||e>=2369&&e<=2376||e===2381||e>=2385&&e<=2391||e===8205||e>=65024&&e<=65039||e>=917760&&e<=917999}function isWideCodePoint(e){return e>=4352&&(e<=4447||e===9001||e===9002||e>=11904&&e<=42191&&e!==12351||e>=44032&&e<=55203||e>=63744&&e<=64255||e>=65040&&e<=65049||e>=65072&&e<=65135||e>=65280&&e<=65376||e>=65504&&e<=65510||e>=127744&&e<=128591||e>=129280&&e<=129535||e>=131072&&e<=262141)}export{ansiPattern,ansiPrefixPattern,codePointWidth,sliceVisible,stripAnsi,visibleLength};

package/dist/src/cli/dev/tui/test/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Test-only entrypoint for driving the `ash dev` terminal UI from
+ * end-to-end smoke tests. Exposed via the `experimental-ash/dev-tui-test`
+ * subpath export. Not part of the supported public API — production code
+ * reaches the TUI through the internal `#cli/dev/tui/*` modules instead.
+ */
+export { AshTUIRunner } from "../runner.js";
+export type { AshTUIRunnerOptions } from "../runner.js";
+export { TerminalRenderer } from "../terminal-renderer.js";
+export { MockScreen, MockUserInput } from "./mock-terminal.js";

package/dist/src/cli/dev/tui/test/index.js

@@ -0,0 +1 @@
+import{TerminalRenderer}from"../terminal-renderer.js";import{AshTUIRunner}from"../runner.js";import{MockScreen,MockUserInput}from"./mock-terminal.js";export{AshTUIRunner,MockScreen,MockUserInput,TerminalRenderer};

package/dist/src/cli/dev/tui/test/mock-terminal.d.ts

@@ -0,0 +1,28 @@
+import { EventEmitter } from "node:events";
+import type { TerminalInput, TerminalOutput } from "../terminal-renderer.js";
+export declare class MockUserInput extends EventEmitter implements TerminalInput {
+    isTTY: boolean;
+    rawModes: boolean[];
+    resumeCalls: number;
+    pauseCalls: number;
+    setRawMode(mode: boolean): this;
+    resume(): this;
+    pause(): this;
+    type(text: string): void;
+    enter(): void;
+    ctrlC(): void;
+}
+export declare class MockScreen extends EventEmitter implements TerminalOutput {
+    #private;
+    columns: number;
+    rows: number;
+    constructor({ columns, rows }: {
+        columns: number;
+        rows: number;
+    });
+    write(chunk: string | Uint8Array, encodingOrCallback?: BufferEncoding | ((error?: Error | null) => void), callback?: (error?: Error | null) => void): boolean;
+    resize(columns: number, rows: number): void;
+    snapshot(): string;
+    rawOutput(): string;
+    waitForText(text: string, timeoutMs?: number, getDebugOutput?: () => string): Promise<void>;
+}

package/dist/src/cli/dev/tui/test/mock-terminal.js

@@ -0,0 +1,3 @@
+import{EventEmitter}from"node:events";const ansiControlSequencePattern=RegExp(`^\x1B\\[([0-9?;]*)([ -/]*)([@-~])`);var MockUserInput=class extends EventEmitter{isTTY=!0;rawModes=[];resumeCalls=0;pauseCalls=0;setRawMode(e){return this.rawModes.push(e),this}resume(){return this.resumeCalls+=1,this}pause(){return this.pauseCalls+=1,this}type(e){this.emit(`data`,Buffer.from(e))}enter(){this.emit(`data`,Buffer.from(`\r`))}ctrlC(){this.emit(`data`,Buffer.from(``))}},MockScreen=class extends EventEmitter{columns;rows;#e=``;#t=[];#n=0;#r=0;#i=[];constructor({columns:e,rows:t}){super(),this.columns=e,this.rows=t}write(e,t,n){let r=String(e);return this.#e+=r,this.#o(r),typeof t==`function`&&t(),n?.(),this.#a(),!0}resize(e,t){this.columns=e,this.rows=t,this.emit(`resize`)}snapshot(){return this.#t.join(`
+`)}rawOutput(){return this.#e}async waitForText(e,t=1e3,n=()=>this.snapshot()){this.snapshot().includes(e)||await new Promise((r,i)=>{let a={text:e,resolve:r,reject:i,timeout:setTimeout(()=>{this.#i=this.#i.filter(e=>e!==a),i(Error(`Timed out waiting for screen text: ${e}\n\nScreen:\n${n()}`))},t)};this.#i.push(a)})}#a(){let e=this.snapshot();for(let t of this.#i.slice())e.includes(t.text)&&(clearTimeout(t.timeout),this.#i=this.#i.filter(e=>e!==t),t.resolve())}#o(e){let t=0;for(;t<e.length;){if(e[t]===`\x1B`){let n=this.#s(e,t);if(n>t){t=n;continue}}let n=e[t];if(t+=1,n!==void 0){if(n===`
+`){this.#n+=1,this.#r=0;continue}if(n===`\r`){this.#r=0;continue}this.#c(n)}}}#s(e,n){let r=e.slice(n).match(ansiControlSequencePattern);if(!r)return n;let[i,a,,o]=r,s=a?a.split(`;`):[];return o===`H`&&s.length===0?(this.#n=0,this.#r=0):o===`J`&&s[0]===`2`?this.#t=[]:o===`K`&&s[0]===`2`?(this.#t[this.#n]=``,this.#r=0):o===`H`&&(this.#n=Number(s[0]??1)-1,this.#r=Number(s[1]??1)-1),n+i.length}#c(e){let t=this.#t[this.#n]??``,n=t.slice(0,this.#r)+e+t.slice(this.#r+e.length);this.#t[this.#n]=n,this.#r+=e.length}};export{MockScreen,MockUserInput};

package/dist/src/cli/dev/tui/tui.d.ts

@@ -0,0 +1,32 @@
+import type { ClientOptions } from "#client/index.js";
+import type { TuiDisplayOptions } from "./types.js";
+/**
+ * Options for running the `ash dev` terminal UI against a server URL.
+ */
+export interface RunDevelopmentTuiInput extends TuiDisplayOptions {
+    /**
+     * The Ash server URL the TUI connects to — either the in-process dev
+     * server started by `ash dev`, or a remote `--url` target.
+     */
+    readonly serverUrl: string;
+}
+/**
+ * Runs the `ash dev` terminal UI against the given server URL until the
+ * user exits.
+ *
+ * Builds the client with the same development auth/header resolution the
+ * REPL's dev client uses (`#services/dev-client`): local hosts skip the
+ * Vercel OIDC bearer, remote hosts attach it alongside any protection
+ * bypass headers. The configured client is handed to the runner so its
+ * subagent child-session streams inherit the same auth. Turn-dispatch
+ * failures — including the Vercel Deployment Protection challenge — are
+ * formatted into the inline error region rather than crashing the command.
+ */
+/**
+ * Builds the client options the `ash dev` TUI connects with, matching the
+ * REPL's dev client: local hosts skip the Vercel OIDC bearer (the framework's
+ * `localDev()` channel auth accepts unauthenticated calls); remote hosts
+ * attach it alongside any protection-bypass headers resolved per request.
+ */
+export declare function resolveDevTuiClientOptions(serverUrl: string): ClientOptions;
+export declare function runDevelopmentTui(input: RunDevelopmentTuiInput): Promise<void>;

package/dist/src/cli/dev/tui/tui.js

@@ -0,0 +1 @@
+import{AshTUIRunner}from"./runner.js";import{toErrorMessage}from"#shared/errors.js";import{isLocalDevelopmentServerUrl,resolveDevelopmentClientHeaders,resolveDevelopmentOidcToken}from"#services/dev-client/request-headers.js";import{formatVercelAuthChallengeMessage,isVercelAuthChallenge}from"#services/dev-client/vercel-auth-error.js";import{Client}from"#client/index.js";function resolveDevTuiClientOptions(e){let t={headers:()=>resolveDevelopmentClientHeaders({serverUrl:e}),host:e};return isLocalDevelopmentServerUrl(e)?t:{...t,auth:{bearer:resolveDevelopmentOidcToken}}}async function runDevelopmentTui(n){let{serverUrl:r,...i}=n,a=new Client(resolveDevTuiClientOptions(r));await new AshTUIRunner({...i,session:a.session(),client:a,formatTransportError:e=>isVercelAuthChallenge(e)?formatVercelAuthChallengeMessage({serverUrl:r}):toErrorMessage(e)}).run()}export{resolveDevTuiClientOptions,runDevelopmentTui};

package/dist/src/cli/dev/tui/types.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Controls how terminal UI sections for stream parts are displayed.
+ */
+export type TerminalPartDisplayMode = "full" | "collapsed" | "auto-collapsed" | "hidden";
+/**
+ * Controls which usage statistic is shown for assistant responses.
+ */
+export type AssistantResponseStatsMode = "tokens" | "tokensPerSecond";
+/**
+ * Controls which in-process server/agent logs the TUI surfaces as inline
+ * regions. `all` shows both stdout and stderr; `stderr` shows only stderr;
+ * `none` suppresses log regions entirely.
+ */
+export type LogDisplayMode = "all" | "stderr" | "none";
+/**
+ * Display options shared by the terminal UI runner and renderer.
+ */
+export type TuiDisplayOptions = {
+    /**
+     * The title shown in the terminal UI.
+     */
+    name?: string;
+    /**
+     * How tool calls should render.
+     */
+    tools?: TerminalPartDisplayMode;
+    /**
+     * How reasoning parts should render.
+     */
+    reasoning?: TerminalPartDisplayMode;
+    /**
+     * How subagent sections should render. `full` shows every nested child
+     * event line and the subagent's output; `auto-collapsed` collapses the
+     * section once the subagent reaches `done`; `collapsed` always shows
+     * only the header; `hidden` skips the section entirely.
+     */
+    subagents?: TerminalPartDisplayMode;
+    /**
+     * How MCP connection authorization sections should render. `full`
+     * shows the challenge URL and any user code; `auto-collapsed`
+     * collapses the section once authorization reaches a terminal
+     * outcome (`authorized`, `declined`, `failed`, `timed-out`);
+     * `collapsed` always shows only the header. `hidden` is supported
+     * but strongly discouraged: a hidden auth challenge looks identical
+     * to a hung turn from the user's perspective.
+     */
+    connectionAuth?: TerminalPartDisplayMode;
+    /**
+     * Which statistic to show in assistant response headers.
+     *
+     * @default "tokensPerSecond"
+     */
+    assistantResponseStats?: AssistantResponseStatsMode;
+    /**
+     * The model context window size in tokens.
+     *
+     * When provided, the terminal UI shows the current total token usage as a
+     * percentage of this context window.
+     */
+    contextSize?: number;
+    /**
+     * Which in-process server/agent logs to surface as inline regions.
+     * Output is always captured so it cannot corrupt the frame; this only
+     * controls what is rendered. Defaults to `all` — the TUI is primarily a
+     * development tool.
+     */
+    logs?: LogDisplayMode;
+};

package/dist/src/cli/dev/tui/types.js

@@ -0,0 +1 @@
+export{};