eve 0.69.0 → 0.70.0

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

@@ -0,0 +1,47 @@
+import { type ConversationState } from "#client/conversation-state.js";
+import type { Block } from "./blocks.js";
+import type { AgentTUIConversationView } from "./conversation-view.js";
+import { type TaskEntry } from "./task-activity.js";
+import type { SubagentDisplayMode, TerminalPartDisplayMode } from "./types.js";
+export interface TranscriptOptions {
+    readonly tools: TerminalPartDisplayMode;
+    readonly reasoning: TerminalPartDisplayMode;
+    readonly subagents: SubagentDisplayMode;
+    readonly connectionAuth: TerminalPartDisplayMode;
+    /** Names of the agent's local subagents, whose tools read as delegations. */
+    readonly subagentNames?: readonly string[];
+    /** Where full failure detail is recorded, shown instead of the raw dump. */
+    readonly diagnosticsPath?: string;
+    /** Separates a task end line's facts; the theme's `·`. */
+    readonly dot?: string;
+}
+/** How long a settled agent task waits for its own last events before writing its end line. */
+export declare const TASK_END_GRACE_MS = 2000;
+/**
+ * Projects one session's conversation into transcript blocks. Each block's
+ * `live` flag says whether its part can still change; the renderer commits a
+ * settled prefix to scrollback. Built blocks are reused while their inputs are
+ * unchanged, so file-diff bases observe each tool call once, in order.
+ *
+ * A task writes one line when it starts, at its call, and one when it ends, where the transcript
+ * had reached by then; what it does in between is {@link ConversationTranscript.tasks}, which the
+ * renderer shows in the task panel above the prompt.
+ */
+export declare class ConversationTranscript {
+    #private;
+    reset(): void;
+    /** The tasks between their start and end lines as of the last projection, in start order. */
+    get tasks(): readonly TaskEntry[];
+    /** Whether a settled agent task is waiting for its own last events. */
+    get finishing(): boolean;
+    /** How input requests name the task that asked: as its task lines do. */
+    taskLabel(conversation: ConversationState, taskId: string): string | undefined;
+    /** End lines for the tasks still working when their session ends; they read as stopped. */
+    stopWorking(options: TranscriptOptions): Block[];
+    project(view: AgentTUIConversationView, options: TranscriptOptions): Block[];
+}
+/**
+ * Running tools and the live turn's model activity, for the turn bar. A session parked on a
+ * sign-in names its connections, and a turn parked on its tasks names them.
+ */
+export declare function turnActivity(view: AgentTUIConversationView, tasks: readonly TaskEntry[]): string;

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

@@ -0,0 +1 @@
+import{FileContentCache}from"./file-content-cache.js";import{agentDisplayName,agentTaskLabel,isPanelRoutedTool,presentTool,readWriteFileInput,toolBaseName}from"./tool-presentation.js";import{isTerminalToolCallPart}from"./terminal-tool-part.js";import{activeToolSteps,agentTaskSummary,authorizationTerminalMessage,childToolCallIds,endLine,firstLine,formatAuthorization,isActive,isToolCallRow,labelContext,nestedTaskRecord,startLine,subagentSteps,taskCallsById,taskNeedsApproval,toolBlock,toolState,uniqueTaskName,userText,writeExistedFlag}from"./transcript-parts.js";import{signInLabel,waitingLabel}from"./task-activity.js";import{isTaskControlTool}from"#protocol/task-tools.js";import{stripTerminalControls}from"#cli/ui/terminal-text.js";import{agentCallTurns,agentToolSession,conversationAuthorizations,isAgentCallContentPending}from"#client/conversation-state.js";import{authorizationKey}from"#client/session-utils.js";const TASK_END_GRACE_MS=2e3;var ConversationTranscript=class{#e=new Map;#t=new FileContentCache;#n=new Map;#r=new Map;#i=new Set;#a=new Map;#o=new Map;#s=[];#c=new Set;#l=[];reset(){this.#e=new Map,this.#t.clear(),this.#n.clear(),this.#r=new Map,this.#i.clear(),this.#a.clear(),this.#o.clear(),this.#s=[],this.#c.clear(),this.#l=[]}get tasks(){return this.#l}get finishing(){return this.#l.some(e=>e.finishing===!0)}taskLabel(e,t){let n=e.tasks[t];if(n===void 0)return;let r=Object.values(n.calls),i=r.findLast(e=>e.status===`working`)??r.at(-1),a=i===void 0?void 0:this.#a.get(i.callId);return a===void 0?n.kind===`agent`?agentTaskLabel(agentDisplayName(stripTerminalControls(n.name))):stripTerminalControls(n.name):a.kind===`agent`?agentTaskLabel(a.name):a.name}stopWorking(e){let t=[];for(let n of this.#a.values())n.ended||(n.ended=!0,t.push(endLine(n,{status:`cancelled`},void 0,e.dot??`·`)));return this.#l=[],t}project(e,t){let{conversation:n,working:r}=e,i=Date.now(),a=[];this.#h(n.messages);let o=childToolCallIds(n),s=taskCallsById(n),c=new Set(e.data.withdrawnCallIds),l=e.data.toolLabels;for(let e of n.messages){if(e.role===`user`){let t=this.#g(e);t!==void 0&&a.push(t);continue}let u=e.parts.filter(e=>isToolCallRow(e)&&(e.state!==`input-streaming`||r)&&!isTaskControlTool(e.toolName)&&!c.has(e.toolCallId)&&e.toolMetadata?.eve?.inputRequest?.kind!==`session-limit`&&!s.has(e.toolCallId)&&!o.has(e.toolCallId)&&!isPanelRoutedTool(e.toolName)),d=new Map(u.map(e=>[e,toolState(e,n,r,!1)])),f=activeToolSteps(d);for(let[n,o]of e.parts.entries())if(o.type===`text`||o.type===`reasoning`){let i=this.#_(e,n,t,r);i!==void 0&&a.push(i)}else if(o.type===`authorization`)t.connectionAuth!==`hidden`&&a.push(this.#v(o));else if(o.type===`dynamic-tool`){let e=s.get(o.toolCallId);if(e!==void 0){let n=this.#d(o,e.task,l,t,i);n!==void 0&&a.push(n);continue}let n=d.get(o);if(n===void 0||t.tools===`hidden`)continue;let r=l[o.toolCallId];a.push(this.#y(o,n,f.has(o.stepIndex),r,t))}let p=e.metadata?.turnId;p!==void 0&&n.turns[p]?.status===`cancelled`&&a.push(this.#m(`cancelled:${p}`,[],()=>({kind:`notice`,body:`Cancelled.`,live:!1})))}for(let[n,r]of e.failures.entries())a.push(this.#b(n,r,t));let u=this.#u(a),d=this.#f(e,s,t,i);for(let e of d){let t=u.slice(-8).map(e=>e.id);this.#s.push({block:e,after:t}),this.#c.add(e.id),u.push(e)}return u}#u(e){let t=[...e];for(let{block:e,after:n}of this.#s){let r=t.length;for(let e=n.length-1;e>=0;--e){let i=t.findIndex(t=>t.id===n[e]);if(i!==-1){r=i+1;break}}t.splice(r,0,e)}return t}#d(e,t,n,r,i){if(!(t.kind===`agent`?r.subagents!==`hidden`:r.tools!==`hidden`))return;let a=e.toolCallId,o=n[a]?.start,s=this.#a.get(a),c=agentTaskSummary(e.input),l=agentDisplayName(stripTerminalControls(e.toolName));if(t.kind===`tool`){let t=presentTool(e.toolName,e.input,labelContext(o));l=stripTerminalControls(t.title),c=stripTerminalControls(t.subtitle)}return s===void 0&&(s={callId:a,kind:t.kind,name:uniqueTaskName(l,this.#a.values()),toolName:e.toolName,input:e.input,label:o,purpose:c||o,startedAtMs:i,ended:!1},this.#a.set(a,s)),this.#m(`task:${a}:start`,[s],()=>startLine(s))}#f(e,t,n,r){let{conversation:i,working:a}=e,o=Object.values(i.turns).at(-1),s=!a&&(e.data.sessionFailed||o?.status===`cancelled`||o?.status===`failed`),c=[],l=[],u={remaining:128};for(let e of this.#a.values()){if(e.ended)continue;let o=t.get(e.callId);if(o===void 0)continue;let{task:d,call:f}=o,p=this.#p(e,d,f,i,n,u);if(n.subagents===`full`)for(let e of p.rows)this.#c.has(e.id)||c.push(e);let m=f.status!==`working`;m&&(e.settledAtMs??=r);let h=m&&p.pending&&a&&r-(e.settledAtMs??r)<2e3;if(m&&!h||!m&&s){e.ended=!0,c.push(endLine(e,m?f:{status:`cancelled`},p.tools,n.dot??`·`));continue}let g={callId:e.callId,kind:e.kind,name:e.name,toolName:e.toolName,input:e.input,label:e.label,purpose:e.purpose,children:p.children,omittedTasks:p.omittedTasks,omittedAttention:p.omittedAttention,startedAtMs:e.startedAtMs,childTools:new Map(p.tools.map(e=>[e.id,e]))};p.step!==void 0&&(g.step=p.step),h&&(g.finishing=!0),l.push(g)}return this.#l=l,c}#p(e,t,n,r,i,a,o=0){let s=t.kind===`agent`?agentToolSession(r,t):void 0,c=s===void 0||s.observation.status===`not-followed`?void 0:s.observation.conversation;if(s===void 0||c===void 0)return{tools:[],rows:[],pending:!1};let l=s.observation.status===`following`&&isAgentCallContentPending(t,n,c),u=new Set(agentCallTurns(t,c).get(n.callId)??[]),d=c.messages.filter(e=>e.role===`assistant`&&e.metadata?.turnId!==void 0&&u.has(e.metadata.turnId)),f=n.status===`working`||l,p=taskCallsById(c),m=[],h=[],g=[],_=0,v=!1,y=0;for(let t of d)for(let n of t.parts){if(y+=1,!isToolCallRow(n)||isTaskControlTool(n.toolName))continue;let t=p.get(n.toolCallId),r=toolState(n,c,f,t?.call.status===`working`),s=`subagent:${e.callId}:tool:${n.toolCallId}`,l=this.#m(s,[n,r.status,e.name],()=>{let a=this.#x(n.toolCallId,n,r,i,{isSubagent:t?.task.kind===`agent`});return{...toolBlock(n,r,a),kind:`subagent-tool`,subagentCallId:e.callId,agentName:e.name,depth:1,live:!1}}),u=t?.task.kind===`agent`?i.subagents!==`hidden`:i.tools!==`hidden`;if(t?.call.status===`working`&&u){if(o>=8||a.remaining<=0){_+=1,v||=r.status===`approval`||taskNeedsApproval(c,t.task);continue}--a.remaining;let s=`${e.callId}/${n.toolCallId}`,u=this.#o.get(s);u===void 0&&(u=nestedTaskRecord(s,n,t.task,l),this.#o.set(s,u));let d=this.#p(u,t.task,t.call,c,i,a,o+1);g.push({...u,step:d.step,children:d.children,omittedTasks:d.omittedTasks,omittedAttention:d.omittedAttention,childTools:new Map(d.tools.map(e=>[e.id,e]))})}else h.push(l);m.push({order:y,block:l,settled:!isActive(r.status)})}let b=subagentSteps(d);for(let t of b){if(!t.finalized)continue;let n=`subagent:${e.callId}:step:${t.key}`,r=this.#m(n,[t.reasoning,t.message,e.name],()=>{let n={kind:`subagent-step`,subagentCallId:e.callId,agentName:e.name,depth:1,body:t.message,live:!1};return t.reasoning.length>0&&(n.reasoning=t.reasoning),n});m.push({order:t.order,block:r,settled:!0})}let x=m.filter(e=>e.settled).sort((e,t)=>e.order-t.order).map(e=>e.block),S=b.at(-1),C={tools:h,rows:x,children:g,omittedTasks:_,omittedAttention:v,pending:l};return S!==void 0&&(C.step=firstLine(S.message)??`Thinking`),C}#m(e,t,n){let r=this.#e.get(e);if(r!==void 0&&sameKey(r.key,t))return r.block;let i={...n(),id:e};return this.#e.set(e,{key:t,block:i}),i}#h(e){let t=new Map;for(let n of e)n.role===`user`&&n.metadata?.optimistic===!0&&t.set(n.id,userText(n));let n=[...this.#r].filter(([e])=>!t.has(e)),r=new Set(t.values());for(let t of e){if(t.role!==`user`||t.metadata?.optimistic===!0||this.#i.has(t.id))continue;let e=userText(t),i=n.findIndex(([,t])=>t===e);i===-1&&r.has(e)||(this.#i.add(t.id),i!==-1&&(this.#n.set(t.id,n[i][0]),n.splice(i,1)))}this.#r=t}#g(e){if(e.metadata?.optimistic!==!0&&!this.#i.has(e.id))return;let t=stripTerminalControls(userText(e));if(t.trim().length===0)return;let n=`user:${this.#n.get(e.id)??e.id}`;return this.#m(n,[t],()=>({kind:`user`,body:t,live:!1}))}#_(e,t,n,r){let i=e.parts[t];if(i?.type!==`text`&&i?.type!==`reasoning`||i.type===`reasoning`&&n.reasoning!==`full`)return;let a=stripTerminalControls(i.text).trim();if(a.length===0)return;let o=i.state===`streaming`&&r,s=`${i.type}:${i.id??`${e.id}:${t}`}`;return this.#m(s,[a,o],()=>i.type===`text`?{kind:`assistant`,body:a,live:o}:{kind:`reasoning`,body:a,collapsed:!1,live:o})}#v(e){return this.#m(`connection-auth:${authorizationKey(e)}`,[e],()=>{let t=e.state===`completed`?e.outcome:e.state,n=authorizationTerminalMessage(t);return{kind:`connection-auth`,title:`${stripTerminalControls(e.name)} · authorization · ${t}`,body:formatAuthorization(e,n),preformatted:!0,live:n===void 0}})}#y(e,t,n,r,i){let a=n||isActive(t.status);return this.#m(`tool:${e.toolCallId}`,[e,t.status,a,i.tools,i.subagentNames,r],()=>{let n=this.#x(e.toolCallId,e,t,i,{label:r?.start,completeLabel:r?.complete});return{...toolBlock(e,t,n),kind:`tool`,live:a,expanded:i.tools===`full`}})}#b(e,t,n){let{message:r,hint:i,detail:a}=t;return this.#m(`failure:${e}`,[r,i,a],()=>{let e={kind:`error`,title:`Error`,body:stripTerminalControls(r),live:!1};return i!==void 0&&(e.hint=stripTerminalControls(i)),a!==void 0&&(e.detail=n.diagnosticsPath===void 0?stripTerminalControls(a):`details: ${n.diagnosticsPath}`),e})}#x(e,t,n,r,i={}){n.output!==void 0&&this.#t.observeRead(n.output);let a={};(i.isSubagent===!0||r.subagentNames?.includes(toolBaseName(t.toolName))===!0)&&(a.isSubagent=!0),i.label!==void 0&&(a.label=i.label),i.completeLabel!==void 0&&(a.completeLabel=i.completeLabel);let o=readWriteFileInput(t.toolName,t.input);if(o!==void 0){let t=this.#t.observeWrite({...o,callId:e});t!==void 0&&(a.previousContent=t);let r=writeExistedFlag(n.output);r!==void 0&&(a.existed=r)}return Object.keys(a).length>0?a:void 0}};function turnActivity(e,t){let{conversation:n}=e,r=n.activeTurnId===void 0?void 0:n.turns[n.activeTurnId],i=e.conversation.messages.findLast(e=>e.role===`assistant`),a=taskCallsById(n);if(i?.parts.some(e=>isTerminalToolCallPart(e)&&!isTaskControlTool(e.toolName)&&!a.has(e.toolCallId)&&(e.state===`input-available`||e.state===`approval-responded`))===!0)return`Running`;if(r===void 0||r.waiting===!0){let e=conversationAuthorizations(n).filter(e=>e.state===`required`&&e.awaitsCallback===!0);if(e.length>0)return signInLabel(e.map(e=>e.displayName))}if(r?.waiting===!0&&t.length>0)return waitingLabel(t);if(i===void 0)return`Thinking`;let o=i.parts.findLast(e=>e.type!==`step-start`);return o?.type===`text`&&o.state===`streaming`||o?.type===`dynamic-tool`&&o.state===`input-streaming`?`Generating`:`Thinking`}function sameKey(e,t){return e.length===t.length&&e.every((e,n)=>e===t[n])}export{ConversationTranscript,TASK_END_GRACE_MS,turnActivity};

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

@@ -1 +1 @@
-import{remoteHost}from"./target.js";import{createDevDiagnostics}from"../diagnostics.js";import{promptCommandsFor}from"./prompt-commands.js";import{probeMcpConnection}from"./mcp-connection-status.js";import{createPromptCommandHandler}from"./prompt-command-handler.js";import{formatRemoteAuthChallengeMessage}from"./remote-auth-result.js";import{TerminalRenderer}from"./terminal-renderer.js";import{EveTUIRunner}from"./runner.js";import{Client}from"#client/index.js";import{resolveInstalledPackageInfo}from"#internal/application/package.js";import{LOGIN_CONNECTION_COMMAND_OPTIONS}from"#setup/flows/model-login-options.js";import{toErrorMessage}from"#shared/errors.js";import{resolveDevelopmentOidcToken,resolveLinkedDevelopmentOidcToken}from"#services/dev-client/request-headers.js";import{isVercelAuthChallenge}from"#services/dev-client/vercel-auth-error.js";import{resolveVercelDeployment}from"#setup/vercel-deployment.js";import{appendUserAgentProduct}from"#internal/user-agent.js";import{resolveLocalDevelopmentClientOptions,resolveRemoteDevelopmentClientOptions}from"#services/dev-client/client-options.js";import{createDevelopmentCredentialGate}from"#services/dev-client/credential-gate.js";function inlineArgumentSuggestions(e){return async t=>{if(t===`loglevel`)return[{value:`all`,label:`all`,hint:`Show all captured logs`},{value:`stderr`,label:`stderr`,hint:`Show stderr logs only`},{value:`sandbox`,label:`sandbox`,hint:`Show sandbox logs only`},{value:`none`,label:`none`,hint:`Hide captured logs`}];if(t===`login`)return LOGIN_CONNECTION_COMMAND_OPTIONS.map(e=>({value:e.command,label:e.label}));if(t===`model`){let{gatewayModelCapabilities:e}=await import(`#setup/boxes/model-capabilities.js`),{fetchGatewayCatalog:t,modelOptionsFromCatalog:n}=await import(`#setup/boxes/select-model.js`),r=await t().catch(()=>void 0);return n(r).map(t=>{let n=e(r,t.value);return{value:t.value,label:t.value,hint:t.hint,...n?.reasoning?{next:[{value:`default`,label:`default`},...n.reasoningLevels.map(e=>({value:e,label:e}))]}:{}}})}let{browseRegistryCatalog:n}=await import(`#cli/commands/registry.js`);return(await n(e)).items.map(e=>({value:e.address,label:e.name,hint:e.description??e.address}))}}async function startDevelopmentTuiStartup(e){let t=await createDevDiagnostics(e.appRoot).catch(()=>void 0),n=new TerminalRenderer({...e,diagnostics:t,argumentSuggestions:inlineArgumentSuggestions(e.appRoot),onExitRequest:e.onExitRequest});return n.beginStartupDraft({initialDraft:e.initialInput,title:e.name??`eve`}),{diagnostics:t,renderer:n,finish:()=>n.finishStartupDraft(),async shutdown(){n.shutdown(),await t?.close()}}}function prepareRemoteTarget(e){return{target:e,credentials:createDevelopmentCredentialGate(e.serverUrl),resolveOidcToken:resolveDevelopmentOidcToken,resolveDeployment:t=>resolveVercelDeployment({workspaceRoot:e.workspaceRoot,host:remoteHost(e),signal:t})}}function prepareDevelopmentTarget(e){return e.kind===`local`?{kind:`local`,target:e}:{kind:`remote`,target:e,remote:prepareRemoteTarget(e)}}function withTuiUserAgent(e){let t=new Headers(e);return appendUserAgentProduct(t,`eve-tui/${resolveInstalledPackageInfo().version}`),Object.fromEntries(t.entries())}async function runDevelopmentTui(e){let{target:t,headers:n,initialInput:r,onboard:i,onOnboardingStep:a,onOnboardingTerminal:o,onBootProgress:s,lifecycle:c,startup:l,withExclusiveTerminal:u,...d}=e,f=prepareDevelopmentTarget(t),{serverUrl:p}=t,m={headers:withTuiUserAgent(n)},h=new Client(f.kind===`local`?resolveLocalDevelopmentClientOptions({...m,interactiveClient:!0,serverUrl:p,token:()=>resolveLinkedDevelopmentOidcToken(f.target.workspaceRoot)}):resolveRemoteDevelopmentClientOptions({...m,serverUrl:p,credentials:f.remote.credentials})),g={...d,client:h,serverUrl:p,promptCommandHandler:createPromptCommandHandler({target:t}),availablePromptCommands:promptCommandsFor(t.kind),...t.kind===`local`?{argumentSuggestions:inlineArgumentSuggestions(t.workspaceRoot)}:{},formatTransportError:e=>isVercelAuthChallenge(e)?formatRemoteAuthChallengeMessage(p):toErrorMessage(e)};f.kind===`local`?(g.appRoot=f.target.workspaceRoot,g.probeMcpConnection=probeMcpConnection):g.remote=f.remote,r!==void 0&&(g.initialInput=r),l!==void 0&&(g.renderer=l.renderer,g.startup=l),i!==void 0&&(g.onboard=i),a!==void 0&&(g.onOnboardingStep=a),o!==void 0&&(g.onOnboardingTerminal=o),s!==void 0&&(g.onBootProgress=s),c!==void 0&&(g.lifecycle=c),u!==void 0&&(g.withExclusiveTerminal=u);let _=l?.diagnostics??(f.kind===`local`?await createDevDiagnostics(f.target.workspaceRoot).catch(()=>void 0):void 0);_!==void 0&&(g.diagnostics=_);try{await new EveTUIRunner(g).run()}finally{await _?.close()}}export{runDevelopmentTui,startDevelopmentTuiStartup};
+import{remoteHost}from"./target.js";import{createDevDiagnostics}from"../diagnostics.js";import{promptCommandsFor}from"./prompt-commands.js";import{probeMcpConnection}from"./mcp-connection-status.js";import{createPromptCommandHandler}from"./prompt-command-handler.js";import{formatRemoteAuthChallengeMessage}from"./remote-auth-result.js";import{TerminalRenderer}from"./terminal-renderer.js";import{EveTUIRunner}from"./runner.js";import{Client}from"#client/index.js";import{resolveInstalledPackageInfo}from"#internal/application/package.js";import{LOGIN_CONNECTION_COMMAND_OPTIONS}from"#setup/flows/model-login-options.js";import{toErrorMessage}from"#shared/errors.js";import{resolveDevelopmentOidcToken,resolveLinkedDevelopmentOidcToken}from"#services/dev-client/request-headers.js";import{isVercelAuthChallenge}from"#services/dev-client/vercel-auth-error.js";import{resolveVercelDeployment}from"#setup/vercel-deployment.js";import{appendUserAgentProduct}from"#internal/user-agent.js";import{resolveLocalDevelopmentClientOptions,resolveRemoteDevelopmentClientOptions}from"#services/dev-client/client-options.js";import{createDevelopmentCredentialGate}from"#services/dev-client/credential-gate.js";function inlineArgumentSuggestions(e){return async t=>{if(t===`loglevel`)return[{value:`none`,label:`none`,hint:`Hide logs`},{value:`error`,label:`error`,hint:`Errors only (default)`},{value:`warn`,label:`warn`,hint:`Warnings and errors`},{value:`debug`,label:`debug`,hint:`All severity-tagged logs`},{value:`all`,label:`all`,hint:`Include raw stdout and sandbox output`}];if(t===`login`)return LOGIN_CONNECTION_COMMAND_OPTIONS.map(e=>({value:e.command,label:e.label}));if(t===`model`){let{gatewayModelCapabilities:e}=await import(`#setup/boxes/model-capabilities.js`),{fetchGatewayCatalog:t,modelOptionsFromCatalog:n}=await import(`#setup/boxes/select-model.js`),r=await t().catch(()=>void 0);return n(r).map(t=>{let n=e(r,t.value);return{value:t.value,label:t.value,hint:t.hint,...n?.reasoning?{next:[{value:`default`,label:`default`},...n.reasoningLevels.map(e=>({value:e,label:e}))]}:{}}})}let{browseRegistryCatalog:n}=await import(`#cli/commands/registry.js`);return(await n(e)).items.map(e=>({value:e.address,label:e.name,hint:e.description??e.address}))}}async function startDevelopmentTuiStartup(e){let t=await createDevDiagnostics(e.appRoot).catch(()=>void 0),n=new TerminalRenderer({...e,diagnostics:t,argumentSuggestions:inlineArgumentSuggestions(e.appRoot),onExitRequest:e.onExitRequest});return n.beginStartupDraft({initialDraft:e.initialInput,title:e.name??`eve`}),{diagnostics:t,renderer:n,finish:()=>n.finishStartupDraft(),async shutdown(){n.shutdown(),await t?.close()}}}function prepareRemoteTarget(e){return{target:e,credentials:createDevelopmentCredentialGate(e.serverUrl),resolveOidcToken:resolveDevelopmentOidcToken,resolveDeployment:t=>resolveVercelDeployment({workspaceRoot:e.workspaceRoot,host:remoteHost(e),signal:t})}}function prepareDevelopmentTarget(e){return e.kind===`local`?{kind:`local`,target:e}:{kind:`remote`,target:e,remote:prepareRemoteTarget(e)}}function withTuiUserAgent(e){let t=new Headers(e);return appendUserAgentProduct(t,`eve-tui/${resolveInstalledPackageInfo().version}`),Object.fromEntries(t.entries())}async function runDevelopmentTui(e){let{target:t,headers:n,initialInput:r,onboard:i,onOnboardingStep:a,onOnboardingTerminal:o,onBootProgress:s,lifecycle:c,startup:l,withExclusiveTerminal:u,...d}=e,f=prepareDevelopmentTarget(t),{serverUrl:p}=t,m={headers:withTuiUserAgent(n)},h=new Client(f.kind===`local`?resolveLocalDevelopmentClientOptions({...m,interactiveClient:!0,serverUrl:p,token:()=>resolveLinkedDevelopmentOidcToken(f.target.workspaceRoot)}):resolveRemoteDevelopmentClientOptions({...m,serverUrl:p,credentials:f.remote.credentials})),g={...d,client:h,serverUrl:p,promptCommandHandler:createPromptCommandHandler({target:t}),availablePromptCommands:promptCommandsFor(t.kind),...t.kind===`local`?{argumentSuggestions:inlineArgumentSuggestions(t.workspaceRoot)}:{},formatTransportError:e=>isVercelAuthChallenge(e)?formatRemoteAuthChallengeMessage(p):toErrorMessage(e)};f.kind===`local`?(g.appRoot=f.target.workspaceRoot,g.probeMcpConnection=probeMcpConnection):g.remote=f.remote,r!==void 0&&(g.initialInput=r),l!==void 0&&(g.renderer=l.renderer,g.startup=l),i!==void 0&&(g.onboard=i),a!==void 0&&(g.onOnboardingStep=a),o!==void 0&&(g.onOnboardingTerminal=o),s!==void 0&&(g.onBootProgress=s),c!==void 0&&(g.lifecycle=c),u!==void 0&&(g.withExclusiveTerminal=u);let _=l?.diagnostics??(f.kind===`local`?await createDevDiagnostics(f.target.workspaceRoot).catch(()=>void 0):void 0);_!==void 0&&(g.diagnostics=_);try{await new EveTUIRunner(g).run()}finally{await _?.close()}}export{runDevelopmentTui,startDevelopmentTuiStartup};

package/dist/src/cli/dev/tui/turn-clock.d.ts

@@ -1,36 +1,21 @@
+import type { TokenUsage } from "./conversation-view.js";
 /**
- * One turn's wall clock and summed token flow. "When did this turn start"
- * is a single fact; this object is its single representation — armed once
- * per turn (a prompt submit, or an `--input` turn arming itself), fed by
- * step usage reports, and consumed exactly once by the end-of-turn coda.
- * Multi-pass turns (question answers, connection authorizations) re-stream
- * without re-arming, so one turn gets one coda.
+ * One turn's wall clock and token flow, measured against the session's summed
+ * step usage when work started. Armed when work starts and consumed once by
+ * the end-of-turn coda, so answering an approval or question mid-turn does
+ * not split the turn.
  */
 export declare class TurnClock {
     #private;
-    /** Starts the turn: resets the summed flow and stamps the clock. */
-    arm(): void;
+    arm(usage: TokenUsage): void;
     get armed(): boolean;
     get startedAtMs(): number | undefined;
-    get usage(): {
-        readonly inputTokens: number;
-        readonly outputTokens: number;
-    };
-    addUsage(usage: {
-        inputTokens?: number;
-        outputTokens?: number;
-    }): void;
-    /**
-     * Consumes the armed clock, returning the turn's elapsed time and summed
-     * flow — or `undefined` when no turn was armed (the coda's "already
-     * settled" signal). The flow survives the settle so a repaint between the
-     * coda and the next arm still reads the last turn's numbers.
-     */
-    settle(): {
+    /** Token flow since the clock was armed. */
+    usage(current: TokenUsage): TokenUsage;
+    /** Consumes the armed clock, or returns `undefined` when no turn was armed. */
+    settle(current: TokenUsage): ({
         elapsedMs: number;
-        inputTokens: number;
-        outputTokens: number;
-    } | undefined;
+    } & TokenUsage) | undefined;
     /** Drops the clock without a coda (conversation boundaries). */
     reset(): void;
 }

package/dist/src/cli/dev/tui/turn-clock.js

@@ -1 +1 @@
-var TurnClock=class{#e;#t={inputTokens:0,outputTokens:0};arm(){this.#e=Date.now(),this.#t={inputTokens:0,outputTokens:0}}get armed(){return this.#e!==void 0}get startedAtMs(){return this.#e}get usage(){return this.#t}addUsage(e){this.#t.inputTokens+=e.inputTokens??0,this.#t.outputTokens+=e.outputTokens??0}settle(){let e=this.#e;if(e!==void 0)return this.#e=void 0,{elapsedMs:Date.now()-e,...this.#t}}reset(){this.#e=void 0,this.#t={inputTokens:0,outputTokens:0}}};export{TurnClock};
+var TurnClock=class{#e;#t={inputTokens:0,outputTokens:0};arm(e){this.#e=Date.now(),this.#t=e}get armed(){return this.#e!==void 0}get startedAtMs(){return this.#e}usage(e){return{inputTokens:Math.max(0,e.inputTokens-this.#t.inputTokens),outputTokens:Math.max(0,e.outputTokens-this.#t.outputTokens)}}settle(e){let t=this.#e;if(t!==void 0)return this.#e=void 0,{elapsedMs:Date.now()-t,...this.usage(e)}}reset(){this.#e=void 0,this.#t={inputTokens:0,outputTokens:0}}};export{TurnClock};

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

@@ -61,12 +61,10 @@ export type TuiDisplayOptions = {
      */
     contextSize?: number;
     /**
-     * Which captured output (stdout, stderr, sandbox lifecycle lines) to
-     * surface as inline regions. Output is always captured and buffered so it
+     * Minimum log severity to surface as inline regions. Output is always captured and buffered so it
      * cannot corrupt the frame; this only controls what is rendered. The
      * `/loglevel` command switches the mode at runtime, retroactively hiding or
-     * restoring buffered lines. `TerminalRenderer` defaults to `none`; the
-     * `eve dev` CLI defaults to `stderr`.
+     * restoring buffered lines. Defaults to `error`. Only `all` includes unclassified raw output.
      */
     logs?: LogDisplayMode;
 };

package/dist/src/cli/dev/ui-options.js

@@ -1 +1 @@
-function resolveDevUiMode(e){return e.options.ui===!1||!e.interactive?`headless`:`tui`}function resolveTuiDisplayOptions(e){let t={logs:e.logs??`stderr`,reasoning:e.reasoning??`auto-collapsed`,tools:e.tools??`auto-collapsed`};return e.subagents!==void 0&&(t.subagents=e.subagents),e.connectionAuth!==void 0&&(t.connectionAuth=e.connectionAuth),e.assistantResponseStats!==void 0&&(t.assistantResponseStats=e.assistantResponseStats),e.contextSize!==void 0&&(t.contextSize=e.contextSize),t}export{resolveDevUiMode,resolveTuiDisplayOptions};
+function resolveDevUiMode(e){return e.options.ui===!1||!e.interactive?`headless`:`tui`}function resolveTuiDisplayOptions(e){let t={logs:e.logs??`error`,reasoning:e.reasoning??`auto-collapsed`,tools:e.tools??`auto-collapsed`};return e.subagents!==void 0&&(t.subagents=e.subagents),e.connectionAuth!==void 0&&(t.connectionAuth=e.connectionAuth),e.assistantResponseStats!==void 0&&(t.assistantResponseStats=e.assistantResponseStats),e.contextSize!==void 0&&(t.contextSize=e.contextSize),t}export{resolveDevUiMode,resolveTuiDisplayOptions};

package/dist/src/client/agent-stream-follower.d.ts

@@ -0,0 +1,26 @@
+import { type ConversationState } from "#client/conversation-state.js";
+import type { ClientSession } from "#client/session.js";
+import type { MessageStreamEvent } from "#protocol/message.js";
+export interface AgentStreamFollowerOptions {
+    /** The session whose stream announced the agents; reads use its host and credentials. */
+    readonly session: ClientSession;
+    readonly getState: () => ConversationState;
+    readonly onFollowing: (sessionId: string) => void;
+    readonly onEvent: (sessionId: string, event: MessageStreamEvent) => void;
+    readonly onIdle: (sessionId: string) => void;
+    readonly onUnavailable: (sessionId: string) => void;
+    /** Retained by the transport owner across detach and reattach. */
+    readonly cursors: Map<string, number>;
+}
+/**
+ * Follows each agent tool's session while its task has content the conversation has not shown.
+ * The conversation decides when a session is caught up; this class only owns transport.
+ */
+export declare class AgentStreamFollower {
+    #private;
+    constructor(options: AgentStreamFollowerOptions);
+    acceptParentEvent(event: MessageStreamEvent): void;
+    /** Starts, resumes, or pauses subscriptions to match the conversation. */
+    reconcile(): void;
+    abortAll(): void;
+}

package/dist/src/client/agent-stream-follower.js

@@ -0,0 +1 @@
+import{agentToolTask,isAgentSessionCaughtUp}from"#client/conversation-state.js";const agentStreamReconnectPolicy={streamIdleReconnectPolicy:{maxAttempts:1/0},streamOpenReconnectPolicy:{maxAttempts:1/0}};var AgentStreamFollower=class{#e;#t=new Map;#n=new Map;#r=new Set;#i=!1;constructor(e){this.#e=e}acceptParentEvent(e){e.type===`agent.started`&&this.#t.set(e.data.sessionId,e)}reconcile(){if(this.#i)return;let e=this.#e.getState();for(let t of Object.values(e.agents)){if(agentToolTask(e,t)===void 0)continue;let n=this.#n.get(t.sessionId),r=isAgentSessionCaughtUp(e,t);n!==void 0&&r?(this.#n.delete(t.sessionId),n.abort(),this.#e.onIdle(t.sessionId)):n===void 0&&!r&&!this.#r.has(t.sessionId)&&this.#a(t.sessionId)}}abortAll(){this.#i=!0;for(let e of this.#n.values())e.abort();this.#n.clear()}#a(e){let t=this.#t.get(e);if(t===void 0)return;let n=new AbortController;this.#n.set(e,n),this.#e.onFollowing(e);let{cursors:r}=this.#e;(async()=>{let i=r.get(e)??0;try{for await(let a of this.#e.session.agent(t).stream({signal:n.signal,startIndex:i,streamReconnectPolicy:agentStreamReconnectPolicy})){if(n.signal.aborted)return;r.set(e,++i),this.#e.onEvent(e,a),this.reconcile()}}catch{}n.signal.aborted||this.#n.get(e)!==n||(this.#n.delete(e),this.#r.add(e),this.#e.onUnavailable(e))})()}};export{AgentStreamFollower};

package/dist/src/client/authorization-message-parts.js

@@ -1 +1 @@
-function createAuthorizationRequiredPart(e){let t=e.data.authorization?.displayName??formatAuthorizationDisplayName(e.data.name);return{authorization:e.data.authorization,description:normalizeAuthorizationDescription(e.data.description,e.data.name,t),displayName:t,name:e.data.name,state:`required`,stepIndex:e.data.stepIndex,turnId:e.data.turnId,type:`authorization`}}function createAuthorizationCompletedPart(e,t){let n=e.data.authorization?.displayName??t?.displayName??formatAuthorizationDisplayName(e.data.name);return{authorization:t?.authorization||e.data.authorization?{...t?.authorization,...e.data.authorization}:void 0,description:t?.description??buildCompletedAuthorizationDescription(n,e.data.outcome,e.data.reason),displayName:n,name:e.data.name,outcome:e.data.outcome,reason:e.data.reason,state:`completed`,stepIndex:t?.stepIndex??e.data.stepIndex,turnId:t?.turnId??e.data.turnId,type:`authorization`}}function buildCompletedAuthorizationDescription(e,t,n){return t===`authorized`?`${e} connected.`:`${e} authorization ${t}${n===void 0?``:` (${n})`}.`}function normalizeAuthorizationDescription(e,t,n){return e===`Authorization required for ${t}`?`Authorization required for ${n}`:e}function formatAuthorizationDisplayName(e){return e.length===0?e:`${e.charAt(0).toUpperCase()}${e.slice(1)}`}export{createAuthorizationCompletedPart,createAuthorizationRequiredPart};
+function createAuthorizationRequiredPart(e){let t=e.data.authorization?.displayName??formatAuthorizationDisplayName(e.data.name),n={authorization:e.data.authorization,description:normalizeAuthorizationDescription(e.data.description,e.data.name,t),displayName:t,name:e.data.name,state:`required`,stepIndex:e.data.stepIndex,turnId:e.data.turnId,type:`authorization`};return e.data.attemptId!==void 0&&(n.attemptId=e.data.attemptId),e.data.webhookUrl!==void 0&&(n.awaitsCallback=!0),n}function createAuthorizationCompletedPart(e,t){let n=e.data.authorization?.displayName??t?.displayName??formatAuthorizationDisplayName(e.data.name),r={authorization:t?.authorization||e.data.authorization?{...t?.authorization,...e.data.authorization}:void 0,description:t?.description??buildCompletedAuthorizationDescription(n,e.data.outcome,e.data.reason),displayName:n,name:e.data.name,outcome:e.data.outcome,state:`completed`,stepIndex:t?.stepIndex??e.data.stepIndex,turnId:t?.turnId??e.data.turnId,type:`authorization`},i=e.data.attemptId??t?.attemptId;return i!==void 0&&(r.attemptId=i),t?.awaitsCallback&&(r.awaitsCallback=!0),e.data.reason!==void 0&&(r.reason=e.data.reason),r}function buildCompletedAuthorizationDescription(e,t,n){return t===`authorized`?`${e} connected.`:`${e} authorization ${t}${n===void 0?``:` (${n})`}.`}function normalizeAuthorizationDescription(e,t,n){return e===`Authorization required for ${t}`?`Authorization required for ${n}`:e}function formatAuthorizationDisplayName(e){return e.length===0?e:`${e.charAt(0).toUpperCase()}${e.slice(1)}`}export{createAuthorizationCompletedPart,createAuthorizationRequiredPart};

package/dist/src/client/conversation-client.d.ts

@@ -0,0 +1,40 @@
+import type { ConversationState } from "#client/conversation-state.js";
+import { EveAgentProjection, type EveAgentEventLog } from "#client/eve-agent-projection.js";
+import type { SendTurnPayload } from "#client/types.js";
+import type { EveAgentReducerEvent } from "#client/reducer.js";
+import type { MessageStreamEvent } from "#protocol/message.js";
+import type { InputResponse } from "#shared/input.js";
+import { SessionEventStream, type SessionEventStreamOptions } from "#client/session-event-stream.js";
+import type { ClientSession } from "#client/session.js";
+/** Owns the canonical conversation and its root and agent-session transports for one client session. */
+export declare class ConversationClient<TData = ConversationState> {
+    #private;
+    readonly projection: EveAgentProjection<TData>;
+    constructor(projection: EveAgentProjection<TData>, onChange: (data: TData, previous: TData) => void, onConversationChange?: (state: ConversationState, previous: ConversationState) => void);
+    get data(): TData;
+    get conversation(): ConversationState;
+    get projections(): readonly EveAgentEventLog[];
+    get following(): boolean;
+    append(event: EveAgentReducerEvent): void;
+    /** Projects submitted answers; the returned callback withdraws them if the server never accepts. */
+    projectResponses(responses: readonly InputResponse[] | undefined): (() => void) | undefined;
+    /** Swaps projected answers for a prepared payload's, which must still be answerable. */
+    replaceResponses(retract: (() => void) | undefined, input: SendTurnPayload): (() => void) | undefined;
+    /** Admit and project a root event before the agent sessions it announces are followed. */
+    observe(event: MessageStreamEvent, options?: {
+        /** The store reconciles optimistic messages instead of directly appending the event. */
+        project?: (event: MessageStreamEvent) => void;
+        /** Record the accepted event before projection or child notifications. */
+        onAccepted?: (event: MessageStreamEvent) => void;
+        /** The store publishes after updating its event log and status. */
+        notify?: boolean;
+    }): boolean;
+    /** Admit and project a hydrated root event without notifying subscribers. */
+    hydrate(event: MessageStreamEvent): boolean;
+    /** Start following the agent sessions the root stream has announced so far. */
+    follow(session: ClientSession, events?: readonly MessageStreamEvent[]): void;
+    /** Follows the root session continuously; operation readers subscribe to this one stream. */
+    stream(session: ClientSession, options: SessionEventStreamOptions): SessionEventStream;
+    stop(): void;
+    reset(): void;
+}

package/dist/src/client/conversation-client.js

@@ -0,0 +1 @@
+import{assertAnswerable}from"#client/eve-agent-store-helpers.js";import{AgentStreamFollower}from"#client/agent-stream-follower.js";import{canonicalConversationReducer,conversationReducer}from"#client/conversation-reducer.js";import{EveAgentProjection}from"#client/eve-agent-projection.js";import{createEventDeduper}from"#protocol/event-dedupe.js";import{SessionEventStream}from"#client/session-event-stream.js";var ConversationClient=class{projection;#e;#t=new Map;#n=createEventDeduper();#r;#i;#a;#o;constructor(e,t,n){this.projection=e,this.#e=e.reducer===conversationReducer?e:new EveAgentProjection(canonicalConversationReducer,[]),this.#a=t,this.#o=n}get data(){return this.projection.data}get conversation(){return this.#e.data}get projections(){return this.#e===this.projection?[this.projection]:[this.#e,this.projection]}get following(){return this.#r!==void 0}append(e){let t=this.data,n=this.conversation;this.#c(e),t===this.data?n!==this.conversation&&this.#o?.(this.conversation,n):this.#a(this.data,t)}projectResponses(e){if(!e?.length)return;let t={data:{createdAt:Date.now(),responses:e},type:`client.input.responded`};return this.append(t),()=>this.#s(t)}replaceResponses(e,t){return e?.(),assertAnswerable(t,this.conversation),this.projectResponses(t.inputResponses)}#s(e){let t=this.data,n=this.conversation;for(let t of this.projections)t.remove(t=>t===e);t===this.data?n!==this.conversation&&this.#o?.(this.conversation,n):this.#a(this.data,t)}observe(e,t={}){if(!this.#n.admit(e))return!1;t.onAccepted?.(e);let n=this.data,r=this.conversation;return t.project?t.project(e):this.#c(e),t.notify!==!1&&(n===this.data?r!==this.conversation&&this.#o?.(this.conversation,r):this.#a(this.data,n)),this.#r?.acceptParentEvent(e),this.#r?.reconcile(),!0}hydrate(e){return this.#n.admit(e)?(this.#c(e),!0):!1}follow(e,t=[]){this.#r?.abortAll();let n=new AgentStreamFollower({session:e,cursors:this.#t,getState:()=>this.conversation,onFollowing:e=>this.#l({type:`client.agent.following`,data:{sessionId:e}}),onEvent:(e,t)=>this.#l({type:`client.agent.observed`,data:{sessionId:e,event:t}}),onIdle:e=>this.#l({type:`client.agent.idle`,data:{sessionId:e}}),onUnavailable:e=>this.#l({type:`client.agent.unavailable`,data:{sessionId:e}})});this.#r=n;for(let e of t)n.acceptParentEvent(e);n.reconcile()}#c(e){for(let t of this.projections)t.append(e)}#l(e){let t=this.data,n=this.conversation;this.#e.append(e),t===this.data?n!==this.conversation&&this.#o?.(this.conversation,n):this.#a(this.data,t)}stream(e,t){return this.#i!==void 0&&!this.#i.ended?(this.#i.setOptions(t),this.#i):(this.#i=new SessionEventStream(e,t),this.#i)}stop(){this.#r?.abortAll(),this.#r=void 0,this.#i?.close(),this.#i=void 0}reset(){this.stop(),this.#t.clear(),this.#n=createEventDeduper();for(let e of this.projections)e.reset()}};export{ConversationClient};

package/dist/src/client/conversation-reducer.d.ts

@@ -0,0 +1,29 @@
+import type { ConversationState } from "#client/conversation-state.js";
+import type { EveAgentReducer, EveAgentReducerEvent } from "#client/reducer.js";
+import type { MessageStreamEvent } from "#protocol/message.js";
+/**
+ * Transport facts about followed agent sessions. Only the canonical conversation receives them;
+ * custom reducers see their results in `conversation.agents`.
+ */
+export type ClientAgentEvent = {
+    readonly data: {
+        readonly sessionId: string;
+    };
+    readonly type: "client.agent.following" | "client.agent.idle" | "client.agent.unavailable";
+} | {
+    readonly data: {
+        readonly event: MessageStreamEvent;
+        readonly sessionId: string;
+    };
+    readonly type: "client.agent.observed";
+};
+export type ConversationEvent = EveAgentReducerEvent | ClientAgentEvent;
+export declare function initialConversationState(): ConversationState;
+/** Pure reduction of accepted root and agent-session observations; followers own transport. */
+export declare function reduceConversation(state: ConversationState, event: ConversationEvent): ConversationState;
+/** The canonical conversation's reducer, which also folds in followed agent sessions. */
+export declare const canonicalConversationReducer: {
+    initial: typeof initialConversationState;
+    reduce: typeof reduceConversation;
+};
+export declare const conversationReducer: EveAgentReducer<ConversationState>;

package/dist/src/client/conversation-reducer.js

@@ -0,0 +1 @@
+import{defaultMessageReducer}from"#client/message-reducer.js";function initialConversationState(){return{messages:[],turns:{},inputs:{},tasks:{},agents:{}}}function updateTurn(e,t,n){let r=e.turns[t];if(r===void 0)return e;let i=n(r);return i===r?e:{...e,turns:{...e.turns,[t]:i}}}function updateTask(e,t,n){let r=e.tasks[t];if(r===void 0)return e;let i=n(r);return i===r?e:{...e,tasks:{...e.tasks,[t]:i}}}function updateObservation(e,t,n){let r=e.agents[t];if(r===void 0)return e;let i=n(r.observation);return i===r.observation?e:{...e,agents:{...e.agents,[t]:{...r,observation:i}}}}function observedConversation(e){return e.status===`not-followed`?void 0:e.conversation}function reduceConversationLifecycle(e,t){switch(t.type){case`turn.started`:return{...e,activeTurnId:t.data.turnId,turns:{...e.turns,[t.data.turnId]:{turnId:t.data.turnId,status:`active`}}};case`turn.waiting`:return updateTurn(e,t.data.turnId,e=>e.status===`active`&&!e.waiting?{...e,waiting:!0}:e);case`step.started`:return updateTurn(e,t.data.turnId,e=>e.waiting?{turnId:e.turnId,status:e.status}:e);case`turn.completed`:case`turn.cancelled`:case`turn.failed`:{let{turnId:n}=t.data;return{...e,activeTurnId:e.activeTurnId===n?void 0:e.activeTurnId,turns:{...e.turns,[n]:{turnId:n,status:t.type===`turn.completed`?`completed`:t.type===`turn.failed`?`failed`:`cancelled`}}}}case`session.waiting`:case`session.completed`:case`session.failed`:return e.activeTurnId===void 0?e:{...e,activeTurnId:void 0};case`task.started`:{let{callId:n,kind:r,name:i,taskId:a,turnId:o}=t.data,s=e.tasks[a]??{taskId:a,name:i,kind:r,calls:{}};return s.calls[n]===void 0?{...e,tasks:{...e.tasks,[a]:{...s,calls:{...s.calls,[n]:{callId:n,turnId:o,status:`working`}}}}}:e}case`task.settled`:{let{callId:n,error:r,output:i,status:a,taskId:o}=t.data;return updateTask(e,o,e=>{let t=e.calls[n];if(t===void 0||t.status!==`working`)return e;let o={callId:n,turnId:t.turnId,status:a};return{...e,calls:{...e.calls,[n]:a===`completed`&&i!==void 0?{...o,output:i}:a===`failed`&&r!==void 0?{...o,error:r}:o}}})}case`agent.started`:{let{callId:n,name:r,sessionId:i,taskId:a,turnId:o}=t.data;if(e.agents[i]!==void 0)return e;let s={sessionId:i,name:r,callId:n,turnId:o,observation:{status:`not-followed`}};return a!==void 0&&(s.taskId=a),{...e,agents:{...e.agents,[i]:s}}}case`input.requested`:{let n={...e.inputs};for(let e of t.data.requests){if(n[e.requestId]!==void 0)continue;let r={request:e,turnId:t.data.turnId,stepIndex:t.data.stepIndex,status:`open`};t.data.taskId!==void 0&&(r.taskId=t.data.taskId),n[e.requestId]=r}return{...e,inputs:n}}case`client.input.responded`:{let n={...e.inputs};for(let e of t.data.responses){let t=n[e.requestId];t?.status===`open`&&(n[e.requestId]={...t,response:e,status:`responded`})}return{...e,inputs:n}}case`approval.candidate`:{let n=e.inputs[t.data.requestId];return n===void 0||n.status===`settled`||t.data.outcome===`pending`?e:{...e,inputs:{...e.inputs,[t.data.requestId]:{...n,status:`open`,response:void 0}}}}case`approval.settled`:{let n=e.inputs[t.data.requestId];return n===void 0||n.status===`settled`?e:{...e,inputs:{...e.inputs,[t.data.requestId]:{...n,status:`settled`,outcome:t.data.outcome}}}}case`input.resolved`:{let n={...e.inputs};for(let e of t.data.resolutions){let t=n[e.requestId];t!==void 0&&t.status!==`settled`&&(n[e.requestId]={...t,status:`settled`,outcome:e.outcome,response:e.response??t.response})}return{...e,inputs:n}}default:return e}}const messageReducer=defaultMessageReducer();function reduceConversation(e,t){switch(t.type){case`client.agent.following`:return updateObservation(e,t.data.sessionId,e=>e.status===`following`?e:{status:`following`,conversation:observedConversation(e)??initialConversationState()});case`client.agent.observed`:return updateObservation(e,t.data.sessionId,e=>e.status===`following`?{status:`following`,conversation:reduceConversation(e.conversation,t.data.event)}:e);case`client.agent.idle`:return updateObservation(e,t.data.sessionId,e=>e.status===`following`?{status:`idle`,conversation:e.conversation}:e);case`client.agent.unavailable`:return updateObservation(e,t.data.sessionId,e=>{let t=observedConversation(e);return t===void 0?{status:`unavailable`}:{status:`unavailable`,conversation:t}});default:{let n=messageReducer.reduce(e,t);return reduceConversationLifecycle({...e,...n},t)}}}const canonicalConversationReducer={initial:initialConversationState,reduce:reduceConversation},conversationReducer=canonicalConversationReducer;export{canonicalConversationReducer,conversationReducer,initialConversationState,reduceConversation};

package/dist/src/client/conversation-state.d.ts

@@ -0,0 +1,110 @@
+import type { EveAuthorizationPart, EveMessageData } from "#client/message-reducer-types.js";
+import type { InputRequest, InputResponse } from "#shared/input.js";
+import type { JsonValue } from "#shared/json.js";
+export interface ConversationTurn {
+    readonly turnId: string;
+    readonly status: "active" | "completed" | "cancelled" | "failed";
+    /** The open turn is parked, holding on its tasks or on a question one of its calls asked. */
+    readonly waiting?: boolean;
+}
+export interface ConversationInput {
+    readonly request: InputRequest;
+    readonly turnId: string;
+    readonly stepIndex: number;
+    /** The task whose run asks, when a task asks. */
+    readonly taskId?: string;
+    readonly status: "open" | "responded" | "settled";
+    readonly response?: InputResponse;
+    readonly outcome?: string;
+}
+/** One call that started or reached a task, settled by its `task.settled`. */
+export interface ConversationTaskCall {
+    readonly callId: string;
+    readonly turnId: string;
+    readonly status: "working" | "completed" | "failed" | "cancelled";
+    /** The call's result; present only when `status` is `"completed"`. */
+    readonly output?: JsonValue;
+    /** Why the call failed; present only when `status` is `"failed"`. */
+    readonly error?: {
+        readonly message: string;
+    };
+}
+export interface ConversationTask {
+    readonly taskId: string;
+    /** The tool whose call started the task. */
+    readonly name: string;
+    /**
+     * `"agent"` when a subagent's tool, local or remote, started the task; `"tool"` for an authored
+     * tool, including one that opens sessions with `ctx.agent`.
+     */
+    readonly kind: "agent" | "tool";
+    /** Calls in the order they started or reached the task. */
+    readonly calls: Readonly<Record<string, ConversationTaskCall>>;
+}
+export type AgentObservation = {
+    readonly status: "not-followed";
+} | {
+    readonly status: "following";
+    readonly conversation: ConversationState;
+}
+/** Every call so far has shown its content; a later call to the task resumes following. */
+ | {
+    readonly status: "idle";
+    readonly conversation: ConversationState;
+} | {
+    /** The stream failed; this does not mean the agent failed. */
+    readonly status: "unavailable";
+    readonly conversation?: ConversationState;
+};
+/** A session a run opened with `ctx.agent`, as its `agent.started` announced it. */
+export interface ConversationAgentSession {
+    readonly sessionId: string;
+    readonly name: string;
+    /** The call whose invocation opened the session. */
+    readonly callId: string;
+    readonly turnId: string;
+    /** The task whose run opened the session; absent when an `execute` call opened it. */
+    readonly taskId?: string;
+    readonly observation: AgentObservation;
+}
+/** Renderable conversation state. Root and agent-session input IDs occupy separate scopes. */
+export interface ConversationState extends EveMessageData {
+    readonly activeTurnId?: string;
+    readonly turns: Readonly<Record<string, ConversationTurn>>;
+    readonly inputs: Readonly<Record<string, ConversationInput>>;
+    readonly tasks: Readonly<Record<string, ConversationTask>>;
+    /** Sessions opened by this session's runs, by session ID. */
+    readonly agents: Readonly<Record<string, ConversationAgentSession>>;
+}
+/** Inputs awaiting an answer, including requests introduced in earlier turns. */
+export declare function openConversationInputs(state: ConversationState): readonly ConversationInput[];
+/** Authorization attempts remain visible across turns, including parked callbacks. */
+export declare function conversationAuthorizations(state: ConversationState): readonly EveAuthorizationPart[];
+/** A sign-in the session still waits on, which resumes its work when the callback arrives. */
+export declare function hasPendingAuthorizations(state: ConversationState): boolean;
+/**
+ * The agent task whose calls a session receives, when the session is that agent's own. eve's agent
+ * tools send each call as one message, in call order, which is what lets a client attribute the
+ * session's turns to calls. A session an authored tool opens with `ctx.agent` has no such task.
+ */
+export declare function agentToolTask(state: ConversationState, agent: ConversationAgentSession): ConversationTask | undefined;
+/** The session an agent tool forwards its task's calls to. */
+export declare function agentToolSession(state: ConversationState, task: ConversationTask): ConversationAgentSession | undefined;
+/**
+ * Whether a followed agent tool session has shown everything its task's calls produced so far:
+ * no call is working, the session has no open turn, question, or sign-in, and every completed call's
+ * message has arrived. The last check covers a child stream that lags the root stream.
+ */
+export declare function isAgentSessionCaughtUp(state: ConversationState, agent: ConversationAgentSession): boolean;
+/**
+ * Attributes an agent tool session's turns to the calls that produced them. The k-th message the
+ * session received came from the task's k-th call; a turn without a message of its own, such as
+ * one resumed after an approval, continues the previous call. A call whose message joined a
+ * running turn owns no turn.
+ */
+export declare function agentCallTurns(task: ConversationTask, conversation: ConversationState): ReadonlyMap<string, readonly string[]>;
+/**
+ * Whether a call's content may still arrive on its agent tool session: one of the call's turns is
+ * still open there, or the call completed before its message reached the session.
+ */
+export declare function isAgentCallContentPending(task: ConversationTask, call: ConversationTaskCall, conversation: ConversationState): boolean;

package/dist/src/client/conversation-state.js

@@ -0,0 +1 @@
+function openConversationInputs(e){return Object.values(e.inputs).filter(e=>e.status===`open`)}function conversationAuthorizations(e){return e.messages.flatMap(e=>e.role===`assistant`?e.parts.filter(e=>e.type===`authorization`):[])}function hasPendingAuthorizations(e){return conversationAuthorizations(e).some(e=>e.state===`required`&&e.awaitsCallback===!0)}function agentToolTask(e,t){let n=t.taskId===void 0?void 0:e.tasks[t.taskId];return n?.kind===`agent`?n:void 0}function agentToolSession(e,t){return Object.values(e.agents).find(n=>agentToolTask(e,n)?.taskId===t.taskId)}function isAgentSessionCaughtUp(e,t){if(t.observation.status!==`following`&&t.observation.status!==`idle`)return!1;let n=agentToolTask(e,t);if(n===void 0)return!1;let r=Object.values(n.calls);if(r.some(e=>e.status===`working`))return!1;let i=t.observation.conversation;return i.activeTurnId!==void 0||Object.values(i.inputs).some(e=>e.status!==`settled`)||hasPendingAuthorizations(i)?!1:i.messages.filter(e=>e.role===`user`).length>=r.filter(e=>e.status===`completed`).length}function agentCallTurns(e,t){let n=Object.keys(e.calls),r=new Map,i=0;for(let e of t.messages){if(e.role!==`user`)continue;let t=n[i++],a=e.metadata?.turnId;t!==void 0&&a!==void 0&&!r.has(a)&&r.set(a,t)}let a=new Map(n.map(e=>[e,[]])),o;for(let e of Object.keys(t.turns))o=r.get(e)??o,o!==void 0&&a.get(o)?.push(e);return a}function isAgentCallContentPending(e,t,n){let r=agentCallTurns(e,n).get(t.callId)??[],{activeTurnId:i}=n;return i!==void 0&&r.includes(i)?!0:t.status===`completed`&&n.messages.filter(e=>e.role===`user`).length<=Object.keys(e.calls).indexOf(t.callId)}export{agentCallTurns,agentToolSession,agentToolTask,conversationAuthorizations,hasPendingAuthorizations,isAgentCallContentPending,isAgentSessionCaughtUp,openConversationInputs};

package/dist/src/client/eve-agent-projection.d.ts

@@ -1,11 +1,28 @@
-import type { EveAgentReducer, EveAgentReducerEvent } from "#client/reducer.js";
-/** Owns reducer replay when optimistic events are replaced by server events. */
-export declare class EveAgentProjection<TData> {
+import type { ConversationEvent } from "#client/conversation-reducer.js";
+import type { EveAgentReducerEvent } from "#client/reducer.js";
+interface ProjectionReducer<TData, TEvent> {
+    initial(): TData;
+    reduce(data: TData, event: TEvent): TData;
+}
+/**
+ * The part of a projection that root-stream bookkeeping writes. Its entries can include the
+ * canonical conversation's agent-session events, so predicates see the wider event type.
+ */
+export interface EveAgentEventLog {
+    append(event: EveAgentReducerEvent): void;
+    remove(predicate: (event: ConversationEvent) => boolean): void;
+    replace(predicate: (event: ConversationEvent) => boolean, replacement: EveAgentReducerEvent): void;
+    reset(): void;
+}
+/** Owns chronological reducer replay when optimistic events are replaced by server events. */
+export declare class EveAgentProjection<TData, TEvent = EveAgentReducerEvent> {
     #private;
-    constructor(reducer: EveAgentReducer<TData>, events: readonly EveAgentReducerEvent[]);
+    constructor(reducer: ProjectionReducer<TData, TEvent>, events: readonly TEvent[]);
     get data(): TData;
+    get reducer(): ProjectionReducer<TData, TEvent>;
     reset(): void;
-    append(event: EveAgentReducerEvent): void;
-    remove(predicate: (event: EveAgentReducerEvent) => boolean): void;
-    replace(predicate: (event: EveAgentReducerEvent) => boolean, replacement: EveAgentReducerEvent): void;
+    append(event: TEvent): void;
+    remove(predicate: (event: TEvent) => boolean): void;
+    replace(predicate: (event: TEvent) => boolean, replacement: TEvent): void;
 }
+export {};

package/dist/src/client/eve-agent-projection.js

@@ -1 +1 @@
-var EveAgentProjection=class{#e;#t;#n;constructor(e,t){this.#e=e,this.#t=t,this.#n=this.#r()}get data(){return this.#n}reset(){this.#t=[],this.#n=this.#e.initial()}append(e){this.#t=[...this.#t,e],this.#n=this.#e.reduce(this.#n,e)}remove(e){this.#t=this.#t.filter(t=>!e(t)),this.#n=this.#r()}replace(e,t){let n=this.#t.findIndex(e);this.#t=n===-1?[...this.#t,t]:this.#t.map((e,r)=>r===n?t:e),this.#n=this.#r()}#r(){let e=this.#e.initial();for(let t of this.#t)e=this.#e.reduce(e,t);return e}};export{EveAgentProjection};
+var EveAgentProjection=class{#e;#t;#n;constructor(e,t){this.#e=e,this.#t=[...t],this.#n=this.#r()}get data(){return this.#n}get reducer(){return this.#e}reset(){this.#t=[],this.#n=this.#e.initial()}append(e){this.#t.push(e),this.#n=this.#e.reduce(this.#n,e)}remove(e){this.#t=this.#t.filter(t=>!e(t)),this.#n=this.#r()}replace(e,t){let n=this.#t.findIndex(e);n===-1?this.#t.push(t):this.#t[n]=t,this.#n=this.#r()}#r(){let e=this.#e.initial();for(let t of this.#t)e=this.#e.reduce(e,t);return e}};export{EveAgentProjection};

package/dist/src/client/eve-agent-store-helpers.d.ts

@@ -1,8 +1,21 @@
+import { type ConversationState } from "#client/conversation-state.js";
 import type { ActiveTurn } from "#client/eve-agent-store-state.js";
 import type { CancelSessionResult, SendTurnPayload } from "#client/types.js";
-import type { MessageStreamEvent } from "#protocol/message.js";
+import { type MessageStreamEvent } from "#protocol/message.js";
 import type { UserContent } from "ai";
-export declare function isSettledSessionTail(events: readonly MessageStreamEvent[]): boolean;
+export declare function activeTurnForOptimisticFollowUp(events: readonly MessageStreamEvent[]): string | undefined;
+/**
+ * Where catch-up stops following and when an idle session counts as settled. These reads have no
+ * response to scope them, so the {@link endsTurnSegment} rule reads the whole conversation.
+ */
+export declare function isResponseBoundary(event: MessageStreamEvent, conversation: ConversationState): boolean;
+/** A turn parked on a question stays open, so its session is still streaming. */
+export declare function settledStatus(error: Error | undefined, conversation: ConversationState): "error" | "ready" | "streaming";
+export declare function isSettledSessionTail(events: readonly MessageStreamEvent[], conversation: ConversationState): boolean;
+/** A server ignores answers to requests it already settled, so the store never sends them. */
+export declare function assertAnswerable(input: SendTurnPayload, conversation: ConversationState): void;
+export declare function assertInFlightFollowUp(input: SendTurnPayload): void;
+export declare function validateFollowUp<T extends SendTurnPayload>(input: T): T;
 export declare function assertExclusiveTurnInput(input: SendTurnPayload): void;
 export declare function createSubmissionId(): string;
 export declare function createAbortSignal(first: AbortSignal | undefined, second: AbortSignal): AbortSignal;
@@ -10,6 +23,12 @@ export declare function summarizeUserContent(message: string | UserContent): str
 export declare function isAbortError(error: unknown): boolean;
 export declare function toTerminalStreamFailureError(event: MessageStreamEvent): Error | undefined;
 export declare function createActiveTurn(cancel: (turn: ActiveTurn) => Promise<CancelSessionResult>): ActiveTurn;
+/** Counts confirmed steered messages toward the active turn's accepted follow-ups. */
+export declare function countFollowUpDeliveries(turn: ActiveTurn, reconciliation: {
+    readonly alreadyProjected: boolean;
+    readonly event: MessageStreamEvent;
+    readonly ids: readonly string[];
+}): void;
 export declare function followSteeredTurns(turn: ActiveTurn, events: AsyncIterable<MessageStreamEvent>, isActive: () => boolean): Promise<void>;
 /** Aborts a caller's wait without cancelling shared work owned by the store. */
 export declare function waitWithSignal<T>(promise: Promise<T>, signal?: AbortSignal): Promise<T>;

package/dist/src/client/eve-agent-store-helpers.js

@@ -1,2 +1,2 @@
-import{isTurnSegmentBoundary,updatePendingAuthorizations,updatePendingInputRequests}from"#client/session-utils.js";function isSettledSessionTail(e){let t=e.at(-1);if(t===void 0)return!1;let n=new Set,r=new Set;for(let t of e)updatePendingAuthorizations(n,t),updatePendingInputRequests(r,t);return isTurnSegmentBoundary(t,r)&&(t.type!==`session.waiting`||n.size===0)}function assertExclusiveTurnInput(e){if(e.message!==void 0==(e.inputResponses!==void 0))throw Error(`A turn requires exactly one of message or inputResponses.`)}let submissionSequence=0;function createSubmissionId(){let e=globalThis.crypto?.randomUUID;return e===void 0?(submissionSequence+=1,`submission_${submissionSequence.toString()}`):e.call(globalThis.crypto)}function createAbortSignal(e,t){return e?AbortSignal.any([e,t]):t}function summarizeUserContent(e){if(typeof e==`string`)return e;let t=[];for(let n of e)n.type===`text`?t.push(n.text):n.type===`file`&&t.push(n.filename?`[file: ${n.filename}]`:`[file]`);return t.join(`
-`)}function isAbortError(e){return e instanceof Error&&e.name===`AbortError`}function toTerminalStreamFailureError(e){if(e.type!==`session.failed`)return;let t=Error(e.data.message);return t.name=e.data.code,t}function createActiveTurn(e){let t=Promise.withResolvers(),n=Promise.withResolvers(),r={abortController:new AbortController,acceptedFollowUps:0,cancel:()=>e(r),completion:n.promise,followUpDispatches:new Set,receivedFollowUps:0,receivedFollowUpEvents:new Map,followUpSubmissionIds:new Set,resolveCompletion:n.resolve,response:t.promise,resolveResponse:t.resolve};return r}async function followSteeredTurns(e,t,n){for(;e.followUpDispatches.size>0;)await Promise.allSettled(e.followUpDispatches);if(e.receivedFollowUps>=e.acceptedFollowUps)return;let r=new Set;for await(let i of t){if(!n())return;if(e.receivedFollowUps+=e.receivedFollowUpEvents.get(i)??0,e.receivedFollowUpEvents.delete(i),updatePendingInputRequests(r,i),isTurnSegmentBoundary(i,r)){for(;e.followUpDispatches.size>0;)await Promise.allSettled(e.followUpDispatches);if(e.receivedFollowUps>=e.acceptedFollowUps)return}}}async function waitWithSignal(e,t){if(t===void 0)return await e;let n=Promise.withResolvers(),onAbort=()=>n.reject(t.reason);t.addEventListener(`abort`,onAbort,{once:!0}),t.aborted&&onAbort();try{return await Promise.race([n.promise,e])}finally{t.removeEventListener(`abort`,onAbort)}}export{assertExclusiveTurnInput,createAbortSignal,createActiveTurn,createSubmissionId,followSteeredTurns,isAbortError,isSettledSessionTail,summarizeUserContent,toTerminalStreamFailureError,waitWithSignal};
+import{hasPendingAuthorizations}from"#client/conversation-state.js";import{TurnSegment,endsTurnSegment}from"#client/session-utils.js";import{isCurrentTurnBoundaryEvent}from"#protocol/message.js";function activeTurnForOptimisticFollowUp(e){let t=e.findLast(e=>e.type===`turn.started`||e.type===`turn.completed`||e.type===`turn.failed`||e.type===`turn.cancelled`||isCurrentTurnBoundaryEvent(e));return t?.type===`turn.started`?t.data.turnId:void 0}function isResponseBoundary(e,t){return endsTurnSegment(e,{callbacks:hasPendingAuthorizations(t),requests:Object.values(t.inputs).some(e=>e.status!==`settled`)})}function settledStatus(e,t){return e===void 0?t.activeTurnId===void 0?`ready`:`streaming`:`error`}function isSettledSessionTail(e,t){let n=e.at(-1);return n!==void 0&&isResponseBoundary(n,t)}function assertAnswerable(e,t){for(let{requestId:n}of e.inputResponses??[]){let e=t.inputs[n]?.status;if(e!==void 0&&e!==`open`)throw Error(`Input request ${n} was already answered.`)}}function assertInFlightFollowUp(e){if(e.inputResponses===void 0&&(e.message===void 0||e.turnPolicy!==`steer`))throw Error(`eve session is already processing a turn. Send a message with turnPolicy: "steer" to guide it at the next boundary, or answer an open input request.`)}function validateFollowUp(e){return assertExclusiveTurnInput(e),assertInFlightFollowUp(e),e}function assertExclusiveTurnInput(e){if(e.message!==void 0==(e.inputResponses!==void 0))throw Error(`A turn requires exactly one of message or inputResponses.`)}let submissionSequence=0;function createSubmissionId(){let e=globalThis.crypto?.randomUUID;return e===void 0?(submissionSequence+=1,`submission_${submissionSequence.toString()}`):e.call(globalThis.crypto)}function createAbortSignal(e,t){return e?AbortSignal.any([e,t]):t}function summarizeUserContent(e){if(typeof e==`string`)return e;let t=[];for(let n of e)n.type===`text`?t.push(n.text):n.type===`file`&&t.push(n.filename?`[file: ${n.filename}]`:`[file]`);return t.join(`
+`)}function isAbortError(e){return e instanceof Error&&e.name===`AbortError`}function toTerminalStreamFailureError(e){if(e.type!==`session.failed`)return;let t=Error(e.data.message);return t.name=e.data.code,t}function createActiveTurn(e){let t=Promise.withResolvers(),n=Promise.withResolvers(),r={abortController:new AbortController,acceptedFollowUps:0,cancel:()=>e(r),completion:n.promise,followUpDispatches:new Set,receivedFollowUps:0,receivedFollowUpEvents:new Map,followUpSubmissionIds:new Set,resolveCompletion:n.resolve,response:t.promise,resolveResponse:t.resolve};return r}function countFollowUpDeliveries(e,t){let n=0;for(let r of t.ids)e.followUpSubmissionIds.delete(r)&&(n+=1);if(n!==0){if(t.alreadyProjected)e.receivedFollowUps+=n;else{let r=e.receivedFollowUpEvents.get(t.event)??0;e.receivedFollowUpEvents.set(t.event,r+n)}}}async function followSteeredTurns(e,t,n){for(;e.followUpDispatches.size>0;)await Promise.allSettled(e.followUpDispatches);if(e.receivedFollowUps>=e.acceptedFollowUps)return;let r=new TurnSegment({followCallbacks:!0});for await(let i of t){if(!n())return;if(e.receivedFollowUps+=e.receivedFollowUpEvents.get(i)??0,e.receivedFollowUpEvents.delete(i),r.observe(i)){for(;e.followUpDispatches.size>0;)await Promise.allSettled(e.followUpDispatches);if(e.receivedFollowUps>=e.acceptedFollowUps)return}}}async function waitWithSignal(e,t){if(t===void 0)return await e;let n=Promise.withResolvers(),onAbort=()=>n.reject(t.reason);t.addEventListener(`abort`,onAbort,{once:!0}),t.aborted&&onAbort();try{return await Promise.race([n.promise,e])}finally{t.removeEventListener(`abort`,onAbort)}}export{activeTurnForOptimisticFollowUp,assertAnswerable,assertExclusiveTurnInput,assertInFlightFollowUp,countFollowUpDeliveries,createAbortSignal,createActiveTurn,createSubmissionId,followSteeredTurns,isAbortError,isResponseBoundary,isSettledSessionTail,settledStatus,summarizeUserContent,toTerminalStreamFailureError,validateFollowUp,waitWithSignal};

package/dist/src/client/eve-agent-store-state.d.ts

@@ -1,5 +1,7 @@
+import type { Client } from "#client/client.js";
 import type { MessageResponse } from "#client/message-response.js";
 import type { EveAgentReducer } from "#client/reducer.js";
+import type { ConversationState } from "#client/conversation-state.js";
 import type { ClientSession } from "#client/session.js";
 import type { MessageStreamEvent } from "#protocol/message.js";
 import type { CancelSessionResult, ClientAuth, ClientSessionState, HeadersValue, SendTurnPayload } from "#client/types.js";
@@ -18,6 +20,8 @@ export type PrepareSend = (input: SendTurnPayload) => SendTurnPayload | Promise<
 /** Immutable projected state of an eve frontend session store. */
 export interface EveAgentStoreSnapshot<TData> {
     readonly data: TData;
+    /** Canonical session facts, independent of the caller's data projection. */
+    readonly conversation: ConversationState;
     /** The latest session creation, stream, resume, or turn failure. */
     readonly error: Error | undefined;
     readonly events: readonly MessageStreamEvent[];
@@ -36,12 +40,14 @@ export interface EveAgentStoreCallbacks<TData> {
     readonly prepareSend?: PrepareSend;
 }
 /**
- * Configuration for constructing an eve frontend session store. Pass either
- * connection options for a store-owned session or an existing `ClientSession`.
- * Saved events must be an ordered prefix of the same session stream.
+ * Configuration for constructing an eve frontend session store. Pass connection
+ * options or a configured `Client` for store-owned sessions, or an existing
+ * `ClientSession`. Saved events must be an ordered prefix of the same session stream.
  */
 export interface EveAgentStoreInit<TData> {
     readonly prewarm?: boolean;
+    /** Configured client for store-owned sessions; replaces `host`, `auth`, and `headers`. */
+    readonly client?: Client;
     readonly auth?: ClientAuth;
     readonly headers?: HeadersValue;
     readonly host?: string;
@@ -49,6 +55,11 @@ export interface EveAgentStoreInit<TData> {
     readonly initialEvents?: readonly MessageStreamEvent[];
     readonly initialSession?: ClientSessionState;
     readonly optimistic?: boolean;
+    /**
+     * Follow each agent tool's session into `conversation.agents`, regardless of the data reducer,
+     * while the store streams its session or a framework binding has it mounted.
+     */
+    readonly followSubagents?: boolean;
     readonly reducer: EveAgentReducer<TData>;
     readonly session?: ClientSession;
 }
@@ -57,6 +68,7 @@ export interface PendingMessageSubmission {
     readonly eventStartIndex: number;
     readonly id: string;
     readonly message: string;
+    readonly turnId?: string;
     readonly requiresDeliveryId: boolean;
     readonly deliveryId?: string;
 }

package/dist/src/client/eve-agent-store.d.ts

@@ -1,5 +1,5 @@
 import type { EveAgentStoreCallbacks, EveAgentStoreInit, EveAgentStoreSnapshot } from "#client/eve-agent-store-state.js";
-import type { CancelSessionResult, SendTurnPayload } from "#client/types.js";
+import type { CancelSessionResult, ClearResult, CompactResult, ResetResult, SendTurnPayload } from "#client/types.js";
 export type { EveAgentStoreCallbacks, EveAgentStoreInit, EveAgentStoreSnapshot, EveAgentStoreStatus, PrepareSend, } from "#client/eve-agent-store-state.js";
 declare const detachStore: unique symbol;
 declare const attachStore: unique symbol;
@@ -26,6 +26,15 @@ export declare class EveAgentStore<TData> {
      * that turn ID. The event stream stays attached until the turn settles.
      */
     cancel(): Promise<CancelSessionResult>;
+    /** Queues server-side compaction of the current session's context. */
+    compact(): Promise<CompactResult>;
+    /** Clears the current session's model-message history on the server. */
+    clear(): Promise<ClearResult>;
+    /**
+     * Terminally retires the store-owned server session, then resets local state so the next
+     * send starts a fresh session. A failed request leaves both intact.
+     */
+    retire(): Promise<ResetResult>;
     [attachStore](): void;
     [detachStore](): void;
     reset(): void;