eve 0.83.2 → 0.84.0

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

@@ -1,89 +1,86 @@
-import type { EveAuthorizationPart, EveMessageData } from "#client/message-reducer-types.js";
-import type { InputRequest, InputResponse } from "#shared/input.js";
-import { type ConversationTask, type ConversationTaskCall } from "#protocol/session-projection.js";
-export type { ConversationTask, ConversationTaskCall };
-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;
+import type { EveMessage } from "#client/message-types.js";
+import type { DeliveryOutcome } from "#protocol/session-events/families/delivery.js";
+import type { CallRow, DeliveryRow, TaskRow } from "#protocol/session-projection/tables.js";
+import { type SessionView } from "#protocol/session-projection/session-view.js";
+export interface FollowedChild {
+    /** Root depth is zero; its immediate children have depth one. */
+    readonly depth: number;
+    readonly name: string;
+    readonly sessionId: string;
+    readonly owner: {
+        readonly callId: string;
+    } | {
+        readonly taskId: string;
+    };
 }
+/** A synchronous selection policy, evaluated once per relationship at each known reachable depth. */
+export type FollowAgents = boolean | ((child: FollowedChild) => boolean);
+export type AgentObservationReason = "predicate" | "depth-limit" | "session-limit" | "cycle" | "unauthorized" | "expired" | "unsupported" | "transport" | "detached";
 export type AgentObservation = {
     readonly status: "not-followed";
+    readonly reason?: AgentObservationReason;
 } | {
-    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 status: "queued" | "following" | "caught-up" | "interrupted" | "unavailable";
+    /** Identity in this store's authorized reader scope, established by the server. */
+    readonly key?: string;
     readonly conversation: ConversationState;
-} | {
-    /** The stream failed; this does not mean the agent failed. */
-    readonly status: "unavailable";
-    readonly conversation?: ConversationState;
+    /** Committed source-line position, coherent with conversation. */
+    readonly position: number;
+    /** Reached the tail captured when this read opened, not execution completion. */
+    readonly caughtUp: boolean;
+    readonly reason?: AgentObservationReason;
 };
-/** A session a run opened with `ctx.agent`, as its `agent.started` announced it. */
+/** A child session linked by the root's `child.opened`, with its independent observation state. */
 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 owner: FollowedChild["owner"];
+    readonly callId?: string;
+    readonly turnId?: string;
     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. */
+/** Immutable lifecycle observations, with renderable messages and local answers. */
+export interface ConversationState {
+    readonly view: SessionView;
+    readonly messages: readonly EveMessage[];
     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[]>;
+export declare function agentToolTask(state: ConversationState, agent: ConversationAgentSession): TaskRow | undefined;
+export declare function agentToolSession(state: ConversationState, task: TaskRow): ConversationAgentSession | undefined;
+/** Direct model calls served by this task, in call order. */
+export declare function taskCalls(view: SessionView, taskId: string): readonly CallRow[];
+/** A delivery a call sent, as this reader has seen it on the child's stream. */
+export interface AgentCallDelivery {
+    readonly deliveryId: string;
+    /** `unseen` until this reader reads the child's admission, including when it follows none. */
+    readonly status: "unseen" | DeliveryRow["status"];
+    /** The child turn that consumed it. */
+    readonly turnId?: string;
+    readonly outcome?: DeliveryOutcome;
+}
+/** One child session's part in a call: what the call sent it, and the turns that read it. */
+export interface AgentCallSession {
+    readonly sessionId: string;
+    readonly deliveries: readonly AgentCallDelivery[];
+    /**
+     * Child turns that consumed the call's deliveries, oldest first. `sharedWith` names the other
+     * calls whose deliveries the same turn consumed, so its content answers them together.
+     */
+    readonly turns: readonly {
+        readonly turnId: string;
+        readonly sharedWith: 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.
+ * The child activity a call caused, from the `child.sent` links its session recorded: `unlinked`
+ * when it recorded none, as for a call that sent nothing or reached an earlier-protocol remote
+ * agent.
  */
-export declare function isAgentCallContentPending(task: ConversationTask, call: ConversationTaskCall, conversation: ConversationState): boolean;
+export type AgentCallActivity = {
+    readonly status: "unlinked";
+} | {
+    readonly status: "linked";
+    readonly sessions: readonly AgentCallSession[];
+};
+export declare function agentCallActivity(state: ConversationState, callId: string): AgentCallActivity;

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

@@ -1 +1 @@
-import{openSignIns}from"#protocol/session-projection.js";import{conversationProjection}from"#client/conversation-projection.js";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 openSignIns(conversationProjection(e)).some(e=>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};
+import{sessionTables}from"#protocol/session-projection/session-view.js";function agentToolTask(e,t){let n=t.taskId===void 0?void 0:sessionTables(e.view).tasks[t.taskId];return n?.kind===`agent`?n:void 0}function agentToolSession(e,t){return Object.values(e.agents).findLast(n=>agentToolTask(e,n)?.taskId===t.taskId)}function taskCalls(e,t){return Object.values(sessionTables(e).calls).filter(e=>e.taskId===t)}function agentCallActivity(e,t){let n=Object.values(sessionTables(e.view).children).flatMap(n=>{let r=n.deliveries??[];if(!r.some(e=>e.callId===t))return[];let i=new Map(r.map(e=>[e.deliveryId,e.callId])),a=e.agents[n.sessionId]?.observation,o=a===void 0||a.status===`not-followed`?void 0:sessionTables(a.conversation.view),s=r.flatMap(e=>{if(e.callId!==t)return[];let n=o?.deliveries[e.deliveryId];return n===void 0?[{deliveryId:e.deliveryId,status:`unseen`}]:[{deliveryId:e.deliveryId,status:n.status,...n.turnId!==void 0&&{turnId:n.turnId},...n.outcome!==void 0&&{outcome:n.outcome}}]}),c=new Set(s.flatMap(({turnId:e})=>e===void 0?[]:[e])),l=Object.values(o?.turns??{}).filter(e=>c.has(e.turnId)).sort((e,t)=>e.introducedAt-t.introducedAt).map(e=>({turnId:e.turnId,sharedWith:[...new Set(Object.values(o.deliveries).flatMap(n=>{let r=n.turnId===e.turnId?i.get(n.deliveryId):void 0;return r===void 0||r===t?[]:[r]}))]}));return[{sessionId:n.sessionId,deliveries:s,turns:l}]});return n.length===0?{status:`unlinked`}:{status:`linked`,sessions:n}}export{agentCallActivity,agentToolSession,agentToolTask,taskCalls};

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

@@ -0,0 +1,51 @@
+import type { AgentObservation, ConversationState } from "#client/conversation-state.js";
+import type { SessionStreamEvent } from "#protocol/session-event.js";
+import type { SessionPreviews, SessionView } from "#protocol/session-projection/tables.js";
+import type { Answer } from "#shared/input.js";
+/** A message this client sent that eve hasn't consumed yet, or that failed to send. */
+export interface LocalSubmission {
+    readonly id: string;
+    readonly message: string;
+    /** The open turn a steering message joins, when known. */
+    readonly turnId?: string;
+    readonly error?: {
+        readonly message: string;
+    };
+}
+/**
+ * One session as a client shows it: the shared tables its stream folds into, with the previews
+ * of what is still streaming, and what this client did that the stream hasn't confirmed yet (the
+ * messages it sent and the answers it gave). `state` derives the conversation from them.
+ *
+ * The tables fold in place, so a long session costs each event only what it changes, and `state`
+ * rebuilds only the messages of the turns that changed since it was last read.
+ */
+export declare class Conversation {
+    #private;
+    readonly view: SessionView;
+    readonly previews: SessionPreviews;
+    /** Folds one event of the session's stream; false when the tables already hold it. */
+    observe(event: SessionStreamEvent): boolean;
+    /** Advances over source lines without recognized facts, after the reader commits the whole line. */
+    advancePosition(position: number): void;
+    /** Forgets a partly received line so a reader replaying from the folded cursor admits it again. */
+    discardUncommitted(): void;
+    /** Projects an answer only until its accepted delivery appears in the view. */
+    answer(answers: readonly Answer[]): {
+        (): void;
+        accept: (deliveryId: string) => void;
+    };
+    /** Keeps the local echo's identity when its durable delivery replaces it. */
+    confirmSubmission(id: string, deliveryId: string): void;
+    /** A pending receipt has not yet identified which durable user row replaces its echo. */
+    holdUnconfirmedMessages(hold: boolean): void;
+    /** Shows, replaces, or removes the messages this client sent that eve hasn't consumed. */
+    setSubmissions(submissions: readonly LocalSubmission[]): void;
+    get submissions(): readonly LocalSubmission[];
+    /** Updates a child observation without mixing its facts into this session's projection. */
+    observeAgent(sessionId: string, observation: AgentObservation): void;
+    /** The conversation as the tables and this client's own state now show it. */
+    get state(): ConversationState;
+}
+/** The conversation a complete read of a session's stream shows. */
+export declare function conversationOf(events: Iterable<SessionStreamEvent>): ConversationState;

package/dist/src/client/conversation.js

@@ -0,0 +1 @@
+import{isFactType}from"#protocol/session-events/catalog.js";import{emptyPreviews,emptySessionView,foldReceivedEvent}from"#protocol/session-projection/fold.js";import{callPlace,interaction,interactionPlace}from"#protocol/session-projection/reader.js";import{runTurn}from"#protocol/session-projection/selectors.js";import{snapshotOf}from"#protocol/session-projection/session-view.js";import{assistantMessages,importedMessages,userMessage}from"#client/messages.js";import{answersDeliveryId}from"#shared/answers-delivery-id.js";var Conversation=class{view=emptySessionView();previews=emptyPreviews();#e;#t;#n=[];#r=new Map;#i=[];#a=!1;#o=new Map;#s=new Map;#c=new Map;#l=new Map;#u=new Map;#d=`all`;#f;#p;#m=-1;observe(e){let t=e.meta?.position,n=this.#e;if(t!==void 0&&n!==void 0&&(t.line<n.line||t.line===n.line&&t.index<=n.index))return!1;if(t!==void 0&&(this.#e=t),this.#n.push(e),e.meta?.endOfLine===!1)return!0;let r=this.#n;this.#n=[],this.#t=this.#e;for(let e of r){foldReceivedEvent(this.view,e,this.previews),e.type===`delivery.consumed`&&(e.data.history?.length??0)>0&&this.#l.set(e.data.deliveryId,importedMessages(e.data.deliveryId,e.data.history)),isFactType(e.type)&&(this.#p=void 0);for(let t of touchedTurns(this.view,this.previews,e))this.#g(t)}return this.#x(),this.#f=void 0,!0}advancePosition(e){this.#n.length!==0||e<=this.view.position||(this.view.position=e,this.#f=void 0,this.#p=void 0)}discardUncommitted(){this.#n=[],this.#e=this.#t}answer(e){let t=e.map(e=>({answer:e,deliveryId:void 0}));for(let e of t)this.view.interactions[e.answer.interactionId]?.status===`open`&&this.#r.set(e.answer.interactionId,e);this.#_();let retract=()=>{for(let e of t){let t=e.answer.interactionId;this.#r.get(t)===e&&this.#r.delete(t)}this.#_()};return retract.accept=e=>{for(let n of t)n.deliveryId=e;this.#x(),this.#_()},retract}confirmSubmission(e,t){this.#u.set(t,e),this.#f=void 0}holdUnconfirmedMessages(e){this.#a!==e&&(this.#a=e,this.#f=void 0)}setSubmissions(e){this.#i=e,this.#f=void 0}get submissions(){return this.#i}observeAgent(e,t){this.#o.set(e,t),this.#f=void 0}get state(){if(this.#f!==void 0)return this.#f;let{previews:e,view:t}=this,n=this.#v(),r=this.#d===`all`?void 0:new Set([...this.#d,...Object.values(t.turns).flatMap(e=>e.status===`running`?[e.turnId]:[])]),i=assistantMessages({interactions:n,previews:e,view:t},r);r===void 0&&(this.#s=new Map);for(let[e,t]of i)t.length===0?this.#s.delete(e):this.#s.set(e,t);this.#d=new Set;let a={agents:this.#b(),view:this.#h,messages:this.#y()};return this.#f=a,a}get#h(){return this.#p!==void 0&&this.#m===this.view.position?this.#p:(this.#m=this.view.position,this.#p=snapshotOf(this.view,this.previews))}#g(e){this.#d!==`all`&&this.#d.add(e)}#_(){this.#d=`all`,this.#f=void 0}#v(){let e={};for(let t of Object.keys(this.view.interactions)){let n=interaction(this.view,t);if(n===void 0)continue;let r=this.#r.get(t)?.answer;e[t]=r!==void 0&&n.status===`open`?{...n,answer:r}:n}return e}#y(){let e=new Map,t=new Map;for(let n of Object.values(this.view.deliveries)){if(n.consumedAt===void 0||n.turnId===void 0)continue;let r=n.consumedAt,i=(this.#l.get(n.deliveryId)??[]).map(e=>({at:r,message:e}));i.length>0&&t.set(n.turnId,[...t.get(n.turnId)??[],...i]);let a=this.#u.get(n.deliveryId),o=this.#c.get(n.deliveryId);if(this.#a&&o===void 0&&a===void 0)continue;if(o===void 0){if(o=userMessage(n),o===void 0)continue;this.#c.set(n.deliveryId,o)}let s=a===void 0?o:{...o,id:`optimistic:${a}:user`},c={at:n.consumedAt,message:s},l=e.get(n.turnId);l===void 0?e.set(n.turnId,[c]):l.push(c)}let n=new Map;for(let e of this.#i){let t=e.turnId!==void 0&&this.view.turns[e.turnId]!==void 0?e.turnId:void 0,r={id:`optimistic:${e.id}:user`,metadata:{optimistic:!0,status:e.error===void 0?`submitted`:`failed`},parts:[{text:e.message,type:`text`}],role:`user`},i=n.get(t);i===void 0?n.set(t,[r]):i.push(r)}let r=[];for(let i of Object.keys(this.view.turns)){let a=[...(t.get(i)??[]).map(e=>({...e,rank:-1})),...(e.get(i)??[]).map(e=>({...e,rank:0})),...(this.#s.get(i)??[]).map(e=>({...e,rank:1}))].sort((e,t)=>e.at-t.at||e.rank-t.rank);r.push(...a.map(e=>e.message),...n.get(i)??[])}return r.push(...n.get(void 0)??[]),r}#b(){let e={};for(let t of Object.values(this.view.children)){let n=`callId`in t.owner?t.owner.callId:void 0,r={owner:t.owner,name:t.name,observation:this.#o.get(t.sessionId)??{status:`not-followed`},sessionId:t.sessionId};n===void 0?`taskId`in t.owner&&(r.taskId=t.owner.taskId):(r.callId=n,r.turnId=callPlace(this.view,n)?.turnId,r.taskId=this.view.calls[n]?.taskId),e[t.sessionId]=r}return e}#x(){for(let[e,t]of this.#r)t.deliveryId!==void 0&&(this.view.deliveries[t.deliveryId]!==void 0||this.view.deliveries[answersDeliveryId(t.deliveryId)]!==void 0)&&(this.#r.delete(e),this.#_())}};function conversationOf(e){let t=new Conversation;for(let n of e)t.observe(n);return t.state}function touchedTurns(e,t,n){let r=n.scope,i=n.data??{},a=new Set,add=e=>{e!==void 0&&a.add(e)};add(r?.turnId),typeof i.turnId==`string`&&add(i.turnId);let o=typeof i.runId==`string`?i.runId:typeof i.partId==`string`?e.parts[i.partId]?.runId??t.parts[i.partId]?.runId:void 0;o!==void 0&&add(runTurn(e,o)),typeof i.callId==`string`&&add(callPlace(e,i.callId)?.turnId);let s=typeof i.interactionId==`string`?i.interactionId:typeof i.responseId==`string`?e.responses[i.responseId]?.interactionId:void 0,c=s===void 0?void 0:e.interactions[s];return c!==void 0&&(add(interactionPlace(e,c).turnId),`callId`in c.subject&&add(callPlace(e,c.subject.callId)?.turnId)),[...a]}export{Conversation,conversationOf};

package/dist/src/client/delivery-events.d.ts

@@ -0,0 +1,3 @@
+import type { SessionStreamEvent } from "#protocol/session-event.js";
+/** Reads the commit that admits this delivery through its settlement's whole commit. */
+export declare function deliveryEvents(source: AsyncIterable<SessionStreamEvent>, deliveryId: string, signal?: AbortSignal, beforeAdmission?: (event: SessionStreamEvent) => void): AsyncGenerator<SessionStreamEvent>;

package/dist/src/client/delivery-events.js

@@ -0,0 +1 @@
+import{ResponseSegment}from"#client/session-utils.js";async function*deliveryEvents(e,t,n,r){let i=new ResponseSegment({deliveryId:t}),a=!1,o=[];for await(let n of e){if(!a){if(n.type===`session.ended`)throw Error(`The session ended before admitting the accepted delivery.`);if(o[0]?.meta.position.line!==n.meta.position.line){for(let e of o)r?.(e);o=[]}if(o.push(n),n.type!==`delivery.admitted`||n.data.deliveryId!==t)continue;a=!0}let e=o.length>0?o:[n];o=[];for(let t of e){let e=i.observe(t);if(yield t,e)return}}if(!n?.aborted)throw Error(`The stream ended before the accepted delivery settled.`)}export{deliveryEvents};

package/dist/src/client/delivery.d.ts

@@ -0,0 +1,36 @@
+import type { SessionStreamEvent } from "#protocol/session-event.js";
+import type { Delivery, DeliveryReadOptions, DeliveryResult } from "#shared/delivery.js";
+export type { Delivery } from "#shared/delivery.js";
+/**
+ * @internal When the client sent an accepted message or answer, in epoch
+ * milliseconds on the client's clock.
+ */
+export interface ClientSendReceipt {
+    readonly deliveryId?: string;
+    /** The first attempt was issued. */
+    readonly startedAt: number;
+    /** Retrying `409 session_not_ready` before the accepted attempt was issued. */
+    readonly notReadyMs: number;
+    /** The accepted response arrived. */
+    readonly acceptedAt: number;
+}
+interface DeliveryInput {
+    readonly createStream: (options?: DeliveryReadOptions) => AsyncIterable<SessionStreamEvent>;
+    readonly deliveryId: string;
+    readonly receipt?: ClientSendReceipt;
+    readonly sessionId: string;
+}
+/** An accepted command: its receipt and independent reads through its own settlement. */
+export declare class StreamDelivery<TOutput = unknown> implements Delivery<TOutput> {
+    #private;
+    readonly sessionId: string;
+    readonly deliveryId: string;
+    /** @internal */
+    constructor(input: DeliveryInput);
+    /** Independent, replayable read; exiting it never consumes the handle. */
+    stream(options?: DeliveryReadOptions): AsyncGenerator<SessionStreamEvent>;
+    /** Caches only a completed summary; failed/aborted reads can be retried. */
+    result(options?: DeliveryReadOptions): Promise<DeliveryResult<TOutput>>;
+}
+/** @internal Returns when the client sent the delivery's request, if it sent it. */
+export declare function getDeliveryReceipt(delivery: Delivery): ClientSendReceipt | undefined;

package/dist/src/client/delivery.js

@@ -0,0 +1 @@
+import{turnSummary}from"#client/session-utils.js";import{throwIfAborted}from"#client/abort-signal.js";const sendReceipts=new WeakMap;var StreamDelivery=class{sessionId;deliveryId;#e;#t;constructor(e){this.sessionId=e.sessionId,this.deliveryId=e.deliveryId,e.receipt!==void 0&&sendReceipts.set(this,e.receipt),this.#e=e.createStream}async*stream(e){throwIfAborted(e?.signal);for await(let t of this.#e(e))throwIfAborted(e?.signal),yield t;throwIfAborted(e?.signal)}async result(e){if(throwIfAborted(e?.signal),this.#t!==void 0)return this.#t;let t=turnSummary(this.deliveryId);for await(let n of this.stream(e))t.observe(n);let n=t.result();if(n.status===`working`||n.outcome===void 0)throw Error(`The stream ended before the accepted delivery settled.`);let r={data:n.result,deliveryId:this.deliveryId,interactions:n.interactions,outcome:n.outcome,reply:n.message,sessionEnded:n.sessionEnded,sessionId:this.sessionId},i=n.status===`failed`?{...r,status:`failed`,error:n.failure??{code:`DELIVERY_FAILED`,message:`The delivery failed.`}}:{...r,status:n.status};return this.#t=i,i}};function getDeliveryReceipt(e){return sendReceipts.get(e)}export{StreamDelivery,getDeliveryReceipt};

package/dist/src/client/file-parts.d.ts

@@ -1,12 +1,12 @@
-import type { FilePart, UserContent } from "ai";
+import type { MessageContent, MessageFilePart, MessagePart } from "#shared/message-content.js";
 /**
- * Creates an AI SDK `FilePart` whose data is an inline `data:` URL.
+ * Creates a `MessageFilePart` whose data is an inline `data:` URL.
  */
 export declare function createDataUrlFilePart(input: {
     readonly bytes: Uint8Array;
     readonly filename?: string;
     readonly mediaType: string;
-}): FilePart;
+}): MessageFilePart;
 /**
  * Builds one user turn containing text plus an inline file attachment.
  */
@@ -15,4 +15,9 @@ export declare function createTextWithFileContent(input: {
     readonly filename?: string;
     readonly mediaType: string;
     readonly text: string;
-}): UserContent;
+}): MessagePart[];
+/**
+ * A message as a request body carries it: a file part's bytes become a `data:` URL, since JSON
+ * can't carry a `Uint8Array` or `ArrayBuffer`. A `URL` serializes as its string already.
+ */
+export declare function messageForRequest(message: MessageContent): MessageContent;

package/dist/src/client/file-parts.js

@@ -1 +1 @@
-const BASE64_CHUNK_SIZE=32768;function createDataUrlFilePart(e){let t={data:`data:${e.mediaType};base64,${bytesToBase64(e.bytes)}`,mediaType:e.mediaType,type:`file`};return e.filename!==void 0&&e.filename.length>0&&(t.filename=e.filename),t}function createTextWithFileContent(e){return[{text:e.text,type:`text`},createDataUrlFilePart(e)]}function bytesToBase64(e){let t=``;for(let n=0;n<e.length;n+=BASE64_CHUNK_SIZE){let r=e.subarray(n,n+BASE64_CHUNK_SIZE);t+=String.fromCodePoint(...r)}return btoa(t)}export{createDataUrlFilePart,createTextWithFileContent};
+const BASE64_CHUNK_SIZE=32768;function createDataUrlFilePart(e){let t={data:`data:${e.mediaType};base64,${bytesToBase64(e.bytes)}`,mediaType:e.mediaType,type:`file`};return e.filename===void 0||e.filename.length===0?t:{...t,filename:e.filename}}function createTextWithFileContent(e){return[{text:e.text,type:`text`},createDataUrlFilePart(e)]}function messageForRequest(e){return typeof e==`string`?e:e.map(e=>{if(e.type!==`file`||!(e.data instanceof Uint8Array||e.data instanceof ArrayBuffer))return e;let t=bytesToBase64(new Uint8Array(e.data));return{...e,data:`data:${e.mediaType};base64,${t}`}})}function bytesToBase64(e){let t=``;for(let n=0;n<e.length;n+=BASE64_CHUNK_SIZE){let r=e.subarray(n,n+BASE64_CHUNK_SIZE);t+=String.fromCodePoint(...r)}return btoa(t)}export{createDataUrlFilePart,createTextWithFileContent,messageForRequest};

package/dist/src/client/health-schema.d.ts

@@ -4,4 +4,4 @@ export declare const HealthResultSchema: z.ZodObject<{
     status: z.ZodLiteral<"ready">;
     workflowId: z.ZodString;
 }, z.core.$strict>;
-export type HealthResult = z.infer<typeof HealthResultSchema>;
+export type { HealthResult } from "./health-types.js";

package/dist/src/client/health-types.d.ts

@@ -0,0 +1,6 @@
+/** Ready response from the workflow health endpoint. */
+export interface HealthResult {
+    ok: true;
+    status: "ready";
+    workflowId: string;
+}

package/dist/src/client/index.d.ts

@@ -1,27 +1,21 @@
-export { EveAgentStore } from "#client/eve-agent-store.js";
+export { SessionStore } from "#client/session-store.js";
 export { Client } from "#client/client.js";
 export { AgentInfoResponseError } from "#client/agent-info-error.js";
 export { HealthResponseError } from "#client/health-response-error.js";
 export { ClientError, ClientSessionStrandedError } from "#client/client-error.js";
-export { defaultMessageReducer } from "#client/message-reducer.js";
-export { conversationReducer } from "#client/conversation-reducer.js";
-export { transcriptReducer, type TranscriptData, type TranscriptMessage, type TranscriptReducerOptions, } from "#client/transcript-reducer.js";
-export { openConversationInputs } from "#client/conversation-state.js";
-export { toolCallState, type ToolCallState, type ToolCallStatus } from "#client/tool-call-state.js";
-export type { AgentObservation, ConversationAgentSession, ConversationInput, ConversationState, ConversationTask, ConversationTaskCall, ConversationTurn, } from "#client/conversation-state.js";
-export { createDataUrlFilePart, createTextWithFileContent } from "#client/file-parts.js";
-export { MessageResponse } from "#client/message-response.js";
-export { ClientAgentSession } from "#client/agent-session.js";
-export type { PrewarmSessionResult } from "#protocol/prewarm-session.js";
-export { ClientSession } from "#client/session.js";
-export { ClientSessions, type CreatedClientSession, type CreatedIdleClientSession, } from "#client/sessions.js";
-export type { EveAgentStoreCallbacks, EveAgentStoreInit, EveAgentStoreSnapshot, EveAgentStoreStatus, PrepareSend, } from "#client/eve-agent-store.js";
-export type { AgentInfoEntry, AgentInfoChannelEntry, AgentInfoChannels, AgentInfoConnectionEntry, AgentInfoDynamicResolverEntry, AgentInfoHookEntry, AgentInfoInstructions, AgentInfoInstructionsEntry, AgentInfoResult, AgentInfoRemoteAgentEntry, AgentInfoSandboxEntry, AgentInfoScheduleEntry, AgentInfoSkillEntry, AgentInfoSource, AgentInfoSubagentEntry, AgentInfoToolEntry, AgentInfoTools, CancelSessionResult, ClearResult, CompactResult, ClientAuth, ClientOptions, ClientRedirectPolicy, CreateSessionOptions, HeadersValue, HealthResult, MessageResult, RespondTurnOptions, ResetResult, ResolvedStreamReconnectPolicy, SendTurnInput, SendTurnOptions, SessionSnapshot, ClientSessionState, StreamOptions, StreamReconnectPolicy, StreamReconnectRetryPolicy, TokenValue, } from "#client/types.js";
-export type { EveAgentReducer, EveAgentReducerEvent, ClientInputRespondedEvent, ClientMessageFailedEvent, ClientMessageSubmittedEvent, } from "#client/reducer.js";
-export type { EveAuthorizationChallenge, EveAuthorizationOutcome, EveAuthorizationPart, EveMessageData, EveDynamicToolPart, EveMessageInputRequest, EveMessage, EveMessageMetadata, EveMessagePart, EveMessageToolMetadata, } from "#client/message-reducer.js";
-export type { ActionPartialStreamEvent, ActionResultStreamEvent, ActionsRequestedStreamEvent, AgentStartedStreamEvent, AssistantStepFinishReason, AuthorizationOutcome, CompactionCompletedStreamEvent, CompactionRequestedStreamEvent, AuthorizationCompletedStreamEvent, ConnectionAuthorizationOutcome, AuthorizationRequiredStreamEvent, HandleMessageStreamEvent, HistoryImportedMessage, HistoryImportedStreamEvent, MessageStreamEventMeta, InputResolution, InputResolutionOutcome, InputResolvedStreamEvent, InputRequestedStreamEvent, MessageAppendedStreamEvent, MessageCompletedStreamEvent, MessageReceivedPart, MessageReceivedStreamEvent, ReasoningAppendedStreamEvent, ReasoningCompletedStreamEvent, ResultCompletedStreamEvent, RuntimeTraceContext, SessionCompletedStreamEvent, SessionFailedStreamEvent, SessionPredecessor, SessionStartedStreamEvent, SessionWaitingStreamEvent, MessageStreamEvent, StepCompletedStreamEvent, StepFailedStreamEvent, StepStartedStreamEvent, TaskSettledStreamEvent, TaskStartedStreamEvent, TurnCancelledStreamEvent, TurnCompletedStreamEvent, TurnFailedStreamEvent, TurnStartedStreamEvent, TurnFailureStreamEvent, TurnWaitingOn, TurnWaitingStreamEvent, } from "#protocol/message.js";
-export { isCurrentTurnBoundaryEvent, isTurnFailureEvent } from "#protocol/message.js";
-export type { InputOption, InputRequest, InputRequestKind, InputResponse } from "#shared/input.js";
-export { isInputRequest, isInputResponse, parseInputResponse, parseInputResponses, } from "#shared/input.js";
-export { resolveTextToResponse, resolveTextToResponses } from "#channel/resolve-text.js";
-export type { ToolStub, ToolStubOutcome } from "#tool-stubs/types.js";
+export { conversationOf } from "#client/conversation.js";
+export { agentCallActivity } from "#client/conversation-state.js";
+export { transcriptOf, type TranscriptData, type TranscriptMessage, type TranscriptOptions, } from "#client/transcript.js";
+export type { AgentCallActivity, AgentCallDelivery, AgentCallSession, AgentObservation, AgentObservationReason, FollowAgents, FollowedChild, ConversationAgentSession, ConversationState, } from "#client/conversation-state.js";
+export type { MessageContent, MessageFilePart, MessagePart, MessageTextPart, } from "#shared/message-content.js";
+export type { ClientAgentSession } from "#client/agent-session.js";
+export type { ClientSession } from "#client/session.js";
+export type { ClientSessions, CreatedClientSession, CreatedIdleClientSession, } from "#client/sessions.js";
+export type { SessionStoreCallbacks, SessionStoreInit, SessionStoreSnapshot, SessionStoreStatus, PrepareSend, } from "#client/session-store.js";
+export type { AgentInfoEntry, AgentInfoChannelEntry, AgentInfoChannels, AgentInfoConnectionEntry, AgentInfoDynamicResolverEntry, AgentInfoHookEntry, AgentInfoInstructions, AgentInfoInstructionsEntry, AgentInfoResult, AgentInfoRemoteAgentEntry, AgentInfoSandboxEntry, AgentInfoScheduleEntry, AgentInfoSkillEntry, AgentInfoSource, AgentInfoSubagentEntry, AgentInfoToolEntry, AgentInfoTools, ClientAuth, ClientOptions, ClientRedirectPolicy, CreateSessionOptions, HeadersValue, HealthResult, RespondTurnOptions, SendTurnInput, SendTurnOptions, SessionSnapshot, ClientSessionState, StreamReconnectPolicy, StreamReconnectRetryPolicy, TokenValue, } from "#client/types.js";
+export type { EveInteractionPart, EveMessage, EveMessageMetadata, EveMessagePart, EveToolPart, } from "#client/message-types.js";
+export type { SessionEvent, SessionEventMeta, SessionStreamEvent, } from "#protocol/session-event.js";
+export { endsTurn, failureOf } from "#client/session-utils.js";
+export type { AskedCall } from "#protocol/session-projection/reader.js";
+export { isAnswer, parseAnswer, parseAnswers } from "#shared/input.js";
+export type { AgentInfoMemoryEntry } from "#client/types.js";

package/dist/src/client/index.js

@@ -1 +1 @@
-import{isInputRequest,isInputResponse,parseInputResponse,parseInputResponses}from"#shared/input.js";import{openConversationInputs}from"#client/conversation-state.js";import{EveAgentStore}from"#client/eve-agent-store.js";import{ClientError,ClientSessionStrandedError}from"#client/client-error.js";import{toolCallState}from"#client/tool-call-state.js";import{isCurrentTurnBoundaryEvent,isTurnFailureEvent}from"#protocol/message.js";import{AgentInfoResponseError}from"#client/agent-info-error.js";import{HealthResponseError}from"#client/health-response-error.js";import{ClientSessions}from"#client/sessions.js";import{conversationReducer}from"#client/conversation-reducer.js";import{defaultMessageReducer}from"#client/message-reducer.js";import{Client}from"#client/client.js";import{MessageResponse}from"#client/message-response.js";import{transcriptReducer}from"#client/transcript-reducer.js";import{createDataUrlFilePart,createTextWithFileContent}from"#client/file-parts.js";import{ClientAgentSession}from"#client/agent-session.js";import{ClientSession}from"#client/session.js";import{resolveTextToResponse,resolveTextToResponses}from"#channel/resolve-text.js";export{AgentInfoResponseError,Client,ClientAgentSession,ClientError,ClientSession,ClientSessionStrandedError,ClientSessions,EveAgentStore,HealthResponseError,MessageResponse,conversationReducer,createDataUrlFilePart,createTextWithFileContent,defaultMessageReducer,isCurrentTurnBoundaryEvent,isInputRequest,isInputResponse,isTurnFailureEvent,openConversationInputs,parseInputResponse,parseInputResponses,resolveTextToResponse,resolveTextToResponses,toolCallState,transcriptReducer};
+import{endsTurn,failureOf}from"#client/session-utils.js";import{isAnswer,parseAnswer,parseAnswers}from"#shared/input.js";import{agentCallActivity}from"#client/conversation-state.js";import{SessionStore}from"#client/session-store.js";import{ClientError,ClientSessionStrandedError}from"#client/client-error.js";import{conversationOf}from"#client/conversation.js";import{AgentInfoResponseError}from"#client/agent-info-error.js";import{HealthResponseError}from"#client/health-response-error.js";import{Client}from"#client/client.js";import{transcriptOf}from"#client/transcript.js";export{AgentInfoResponseError,Client,ClientError,ClientSessionStrandedError,HealthResponseError,SessionStore,agentCallActivity,conversationOf,endsTurn,failureOf,isAnswer,parseAnswer,parseAnswers,transcriptOf};

package/dist/src/client/message-types.d.ts

@@ -0,0 +1,92 @@
+import type { CallState } from "#protocol/session-projection/selectors.js";
+import type { Interaction } from "#protocol/session-projection/reader.js";
+import type { CapabilityKind } from "#protocol/session-events/families/call.js";
+import type { ErrorInfo } from "#protocol/session-events/envelope.js";
+/**
+ * One message of a conversation: what a person sent, or what the agent's turn produced.
+ *
+ * `metadata.status` is the message's own state: a person's message is `"submitted"` while this
+ * client waits for eve to consume it, `"failed"` if sending failed, and `"complete"` once its turn
+ * consumed it; the agent's message is `"streaming"` while its turn runs and `"complete"` after.
+ * `optimistic` marks a message this client shows before eve consumed it. `turnId` names the turn,
+ * and `result` holds the turn's structured result once it completed, on the turn's last message.
+ *
+ * A turn can show as several agent messages: a message a person sent while it worked splits it,
+ * so what the agent did before shows above the person's message and the rest below. Group by
+ * `metadata.turnId` to read a turn as one.
+ */
+export interface EveMessage {
+    readonly id: string;
+    readonly metadata?: EveMessageMetadata;
+    readonly parts: readonly EveMessagePart[];
+    readonly role: "assistant" | "user";
+}
+export interface EveMessageMetadata {
+    /** App-owned identifier on a message imported through session history. */
+    readonly historyId?: string;
+    readonly imported?: true;
+    readonly optimistic?: true;
+    readonly result?: unknown;
+    readonly status?: "complete" | "failed" | "streaming" | "submitted";
+    readonly turnId?: string;
+}
+/**
+ * One renderable part of an {@link EveMessage}, discriminated by `type`.
+ *
+ * `text` and `reasoning` carry the model's text, `"streaming"` until the part completes; `file`
+ * is an attachment a person sent; `tool` ({@link EveToolPart}) is a call the turn made; and
+ * `interaction` ({@link EveInteractionPart}) is something the turn asked a person that no call
+ * carries. `stepIndex` is the turn's step that produced the part. Assistant text and reasoning
+ * keep the `id` of their content part as they stream and complete.
+ */
+export type EveMessagePart = {
+    readonly id?: string;
+    readonly state?: "done" | "streaming";
+    readonly stepIndex?: number;
+    readonly text: string;
+    readonly type: "text";
+} | {
+    readonly id?: string;
+    readonly state?: "done" | "streaming";
+    readonly stepIndex?: number;
+    readonly text: string;
+    readonly type: "reasoning";
+} | {
+    readonly filename?: string;
+    readonly mediaType: string;
+    readonly size?: number;
+    readonly stepIndex?: number;
+    readonly type: "file";
+    readonly url?: string;
+} | EveInteractionPart | EveToolPart;
+/**
+ * An interaction no call carries, where its turn asked it: a sign-in, the budget prompt, or a
+ * question about no call of this session's. `request` is what it asks (a sign-in's challenge is
+ * `request.signIn`), and `status`, `outcome`, and `answer` how it stands. An approval or a
+ * question about one of the session's calls shows on that call's {@link EveToolPart} instead.
+ */
+export type EveInteractionPart = Interaction & {
+    readonly type: "interaction";
+};
+/** A renderable call: partial input while streaming, then the shared call state. */
+export type EveToolPart = {
+    readonly type: "tool";
+    readonly callId: string;
+    readonly stepIndex: number;
+    readonly kind: CapabilityKind;
+    readonly name: string;
+    readonly label: string;
+    readonly interaction?: Interaction;
+} & ({
+    readonly state: "streaming";
+    readonly inputText: string;
+    readonly input?: never;
+    readonly output?: never;
+    readonly error?: never;
+} | {
+    readonly state: CallState;
+    readonly inputText?: never;
+    readonly input?: unknown;
+    readonly output?: unknown;
+    readonly error?: ErrorInfo;
+});

package/dist/src/client/message-types.js

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

package/dist/src/client/messages.d.ts

@@ -0,0 +1,30 @@
+import type { Interaction } from "#protocol/session-projection/reader.js";
+import type { EveMessage } from "#client/message-types.js";
+import type { ImportedMessage } from "#protocol/session-events/families/delivery.js";
+import type { DeliveryRow, SessionPreviews, SessionView } from "#protocol/session-projection/tables.js";
+/** What a turn's message derives from: the tables, their previews, and the interactions shown. */
+export interface MessageSources {
+    readonly view: SessionView;
+    readonly previews: SessionPreviews;
+    readonly interactions: Readonly<Record<string, Interaction>>;
+}
+/** A message and the stream position it sorts at among its turn's messages. */
+export interface PlacedMessage {
+    readonly at: number;
+    readonly message: EveMessage;
+}
+/**
+ * The agent's messages for each of `turnIds` (every turn when absent): what its runs wrote and
+ * called, and what it asked that no call carries, in the order the stream introduced them. A
+ * message a person sent while the turn worked splits it, so what the agent did before it reads
+ * above it and the rest below; each piece sorts at its first part, the last at the end. A turn
+ * that has requested no run and shows nothing has no message.
+ */
+export declare function assistantMessages(sources: MessageSources, turnIds?: ReadonlySet<string>): ReadonlyMap<string, readonly PlacedMessage[]>;
+/** What a person sent, as the turn that consumed it received it. An answer sends no message. */
+export declare function userMessage(row: DeliveryRow): EveMessage | undefined;
+/**
+ * The earlier conversation a delivery imported, as messages. They name no turn, so a turn's reply
+ * never streams into an imported assistant message.
+ */
+export declare function importedMessages(deliveryId: string, history: readonly ImportedMessage[]): readonly EveMessage[];

package/dist/src/client/messages.js

@@ -0,0 +1 @@
+import{callPlace,runPlace}from"#protocol/session-projection/reader.js";import{callLabel,callOutputSource,callState}from"#protocol/session-projection/selectors.js";import{displayTitle}from"#protocol/session-projection/display-name.js";function assistantMessages(e,t){let{interactions:n,previews:r,view:i}=e,shows=e=>e!==void 0&&(t===void 0||t.has(e)),a=new Map,o=new Map,place=(e,t)=>{let n=a.get(e);n===void 0?a.set(e,[t]):n.push(t)},s=new Map;for(let e of Object.values(n)){let t=i.interactions[e.interactionId],n=t!==void 0&&`callId`in t.subject?t.subject.callId:void 0,r=e.request.kind;n!==void 0&&i.calls[n]!==void 0&&(r===`approval`||r===`question`)?s.set(n,e):t!==void 0&&shows(e.turnId)&&place(e.turnId,{at:t.introducedAt,part:{...e,type:`interaction`},rank:2})}for(let e of Object.values(i.parts)){let t=runPlace(i,e.runId);if(!shows(t?.turnId))continue;e.kind===`result`&&o.set(t.turnId,e.value);let n=textKind(e.kind);n!==void 0&&typeof e.value==`string`&&place(t.turnId,{at:e.introducedAt,part:{id:e.partId,state:`done`,stepIndex:t.stepIndex,text:e.value,type:n},rank:0})}for(let e of Object.values(i.calls)){if(e.outcome===`abandoned`)continue;let t=callPlace(i,e.callId);if(!shows(t?.turnId))continue;let n=toolPart(i,e,r.calls[e.callId],s.get(e.callId),t.stepIndex);place(t.turnId,{at:e.introducedAt,part:{...n,stepIndex:t.stepIndex},rank:1})}for(let e of Object.values(r.parts)){let t=runPlace(i,e.runId),n=textKind(e.kind);shows(t?.turnId)&&n!==void 0&&place(t.turnId,{at:1/0,part:{id:e.partId,state:`streaming`,stepIndex:t.stepIndex,text:e.text,type:n},rank:0})}for(let e of Object.values(r.calls)){let t=runPlace(i,e.runId);shows(t?.turnId)&&e.kind!==void 0&&i.calls[e.callId]===void 0&&place(t.turnId,{at:1/0,part:{callId:e.callId,inputText:e.input,kind:e.kind,label:displayTitle(e.name),name:e.name,state:`streaming`,stepIndex:t.stepIndex,type:`tool`},rank:1})}let c=new Map;for(let e of Object.values(i.deliveries)){if(!shows(e.turnId)||e.consumedAt===void 0||!sendsMessage(e))continue;let t={at:e.consumedAt,deliveryId:e.deliveryId},n=c.get(e.turnId);n===void 0?c.set(e.turnId,[t]):n.push(t)}let l=new Map;for(let e of Object.values(i.turns)){if(!shows(e.turnId))continue;let t=a.get(e.turnId)??[];if(t.length===0&&(e.runs??0)===0){l.set(e.turnId,[]);continue}t.sort((e,t)=>e.at-t.at||e.rank-t.rank);let n=t[0]?.at??1/0,r=(c.get(e.turnId)??[]).filter(e=>e.at>n).sort((e,t)=>e.at-t.at),i=[[],...r.map(()=>[])];for(let e of t)i[r.filter(t=>t.at<e.at).length]?.push(e);let s=e.status!==`settled`,u=s?i.length-1:Math.max(0,i.findLastIndex(e=>e.length>0)),d=[];i.forEach((t,n)=>{if(t.length===0&&(n!==u||!s&&u!==0))return;let i={status:n===u&&s?`streaming`:`complete`,turnId:e.turnId};n===u&&o.has(e.turnId)&&(i.result=o.get(e.turnId));let a=n===0?void 0:r[n-1]?.deliveryId;d.push({at:t[0]?.at??1/0,message:{id:a===void 0?`${e.turnId}:assistant`:`${e.turnId}:${a}:assistant`,metadata:i,parts:t.map(e=>e.part),role:`assistant`}})}),l.set(e.turnId,d)}return l}function textKind(e){return e===`text`||e===`reasoning`?e:void 0}function toolPart(e,t,n,r,i){let{kind:a,name:o}=t.capability,s=t.status!==`settled`,c={callId:t.callId,kind:a,label:callLabel(t,n),name:o,state:callState(e,t.callId),stepIndex:i,type:`tool`};t.input!==void 0&&(c.input=t.input);let l=s?n?.output:t.outcome===`completed`?callOutputSource(e,t.callId)?.output:void 0;l!==void 0&&(c.output=l);let u=t.error??t.inputError;return u!==void 0&&(c.error=u),r!==void 0&&(c.interaction=r),c}function sendsMessage(e){return e.parts!==void 0&&e.parts.length>0}function userMessage(e){if(e.turnId!==void 0&&sendsMessage(e))return{id:`${e.deliveryId}:user`,metadata:{status:`complete`,turnId:e.turnId},parts:receivedParts(e.parts),role:`user`}}function importedMessages(e,t){return t.map((t,n)=>({id:`${e}:imported:${String(n)}`,metadata:t.id===void 0?{imported:!0,status:`complete`}:{historyId:t.id,imported:!0,status:`complete`},parts:[{state:`done`,text:t.text,type:`text`}],role:t.role}))}function receivedParts(e){return e.map(e=>e.kind===`text`?{state:`done`,text:e.text,type:`text`}:{filename:e.filename,mediaType:e.mediaType,size:e.size,type:`file`,url:e.url})}export{assistantMessages,importedMessages,userMessage};

package/dist/src/client/ndjson.d.ts

@@ -1,23 +1,18 @@
-import { type MessageStreamEvent } from "#protocol/message.js";
-import { type MessageStreamVersion } from "#protocol/message-version.js";
+import { type ReadRecord } from "#protocol/session-events/envelope.js";
 /**
  * Returns true when an error looks like a stream socket disconnection that
  * can be recovered via reconnection.
  */
 export declare function isStreamDisconnectError(error: unknown): boolean;
 /**
- * Reads newline-delimited JSON events from a `ReadableStream<Uint8Array>`.
- *
- * Yields one parsed {@link MessageStreamEvent} per complete NDJSON line.
- * Handles partial lines across chunks via an internal buffer.
+ * Reads the records of one stream response: stored lines (commits and progress records),
+ * transport records (`$eve`), and lines this version can't read, each classified by key. Blank
+ * lines are skipped. Handles partial lines across chunks via an internal buffer.
  *
  * All read errors — including socket disconnections — propagate to the caller.
  * Use {@link isStreamDisconnectError} to classify them.
  */
-export declare function readNdjsonStream(body: ReadableStream<Uint8Array>, options: {
-    readonly controlVersion?: "1";
+export declare function readNdjsonStream(body: ReadableStream<Uint8Array>, options?: {
     readonly idleTimeoutMs?: number;
-    readonly onLeaseEnded?: () => void;
     readonly signal?: AbortSignal;
-    readonly streamVersion: MessageStreamVersion;
-}): AsyncGenerator<MessageStreamEvent>;
+}): AsyncGenerator<ReadRecord>;

package/dist/src/client/ndjson.js

@@ -1,3 +1,3 @@
-import{EVE_STREAM_LEASE_ENDED_CONTROL}from"#protocol/message.js";import{throwIfAborted}from"#client/abort-signal.js";import{normalizeMessageStreamEvent}from"#protocol/message-version.js";function isStreamDisconnectError(e){if(e instanceof DOMException)return e.name===`AbortError`;if(!(e instanceof Error))return!1;let t=`code`in e&&typeof e.code==`string`?e.code:void 0;return e.name===`AbortError`||e.message===`terminated`||t===`UND_ERR_SOCKET`||e instanceof TypeError&&/^(?:failed to fetch|fetch failed|load failed|networkerror when attempting to fetch resource\.)$/i.test(e.message)||/abort|cancel|disconnect|premature close|socket|terminated/i.test(e.message)}async function*readNdjsonStream(e,t){let n=e.getReader(),r=new TextDecoder,i=``,a=!1,abort=()=>{n.cancel().catch(()=>{})};t.signal?.addEventListener(`abort`,abort,{once:!0});try{for(;;){throwIfAborted(t.signal);let e=await readWithIdleTimeout(n,t?.idleTimeoutMs);if(throwIfAborted(t.signal),e.done){a=!0,i+=r.decode();break}e.value&&(i+=r.decode(e.value,{stream:!0}));let o=i.indexOf(`
-`);for(;o!==-1;){let e=i.slice(0,o).trim();if(i=i.slice(o+1),e.length>0){let n=JSON.parse(e);t.controlVersion===`1`&&isLeaseEndedControl(n)?t.onLeaseEnded?.():yield parseMessageStreamEvent(n,t.streamVersion)}o=i.indexOf(`
-`)}}let e=i.trim();if(e.length>0){let n=JSON.parse(e);t.controlVersion===`1`&&isLeaseEndedControl(n)?t.onLeaseEnded?.():yield parseMessageStreamEvent(n,t.streamVersion)}}finally{t.signal?.removeEventListener(`abort`,abort),a||n.cancel().catch(()=>{}),n.releaseLock()}}function isLeaseEndedControl(e){if(typeof e!=`object`||!e)return!1;let t=e;return t.$eve===EVE_STREAM_LEASE_ENDED_CONTROL.$eve&&t.version===EVE_STREAM_LEASE_ENDED_CONTROL.version}function parseMessageStreamEvent(e,t){return normalizeMessageStreamEvent(t,e)}async function readWithIdleTimeout(e,t){let n;try{return t===void 0?await e.read():await Promise.race([e.read(),new Promise((e,r)=>{n=setTimeout(()=>r(new DOMException(`Session stream was idle.`,`AbortError`)),t)})])}catch(e){throw e instanceof TypeError?Error(`Session stream disconnected.`,{cause:e}):e}finally{n!==void 0&&clearTimeout(n)}}export{isStreamDisconnectError,readNdjsonStream};
+import{classifyRecord}from"#protocol/session-events/envelope.js";import{throwIfAborted}from"#client/abort-signal.js";function isStreamDisconnectError(e){if(e instanceof DOMException)return e.name===`AbortError`;if(!(e instanceof Error))return!1;let t=`code`in e&&typeof e.code==`string`?e.code:void 0;return e.name===`AbortError`||e.message===`terminated`||t===`UND_ERR_SOCKET`||e instanceof TypeError&&/^(?:failed to fetch|fetch failed|load failed|networkerror when attempting to fetch resource\.)$/i.test(e.message)||/abort|cancel|disconnect|premature close|socket|terminated/i.test(e.message)}async function*readNdjsonStream(e,t={}){let n=e.getReader(),r=new TextDecoder,i=``,a=!1,abort=()=>{n.cancel().catch(()=>{})};t.signal?.addEventListener(`abort`,abort,{once:!0});try{for(;;){throwIfAborted(t.signal);let e=await readWithIdleTimeout(n,t.idleTimeoutMs);if(throwIfAborted(t.signal),e.done){a=!0,i+=r.decode();break}e.value&&(i+=r.decode(e.value,{stream:!0}));let o=i.indexOf(`
+`);for(;o!==-1;){let e=i.slice(0,o).trim();i=i.slice(o+1),e.length>0&&(yield parseRecord(e)),o=i.indexOf(`
+`)}}let e=i.trim();e.length>0&&(yield parseRecord(e))}finally{t.signal?.removeEventListener(`abort`,abort),a||n.cancel().catch(()=>{}),n.releaseLock()}}function parseRecord(e){let t;try{t=JSON.parse(e)}catch{return{kind:`invalid`,value:e}}return classifyRecord(t)}async function readWithIdleTimeout(e,t){let n;try{return t===void 0?await e.read():await Promise.race([e.read(),new Promise((e,r)=>{n=setTimeout(()=>r(new DOMException(`Session stream was idle.`,`AbortError`)),t)})])}catch(e){throw e instanceof TypeError?Error(`Session stream disconnected.`,{cause:e}):e}finally{n!==void 0&&clearTimeout(n)}}export{isStreamDisconnectError,readNdjsonStream};