eve 0.83.2 → 0.84.0

package/dist/src/client/session-utils.js

@@ -1 +1,2 @@
-import{foldSession,initialSessionProjection,openInputs,openSignIns}from"#protocol/session-projection.js";import{isCurrentTurnBoundaryEvent,isTurnFailureEvent}from"#protocol/message.js";function summarizeTurnEvents(e){let t=new TurnSegment,n,r,i;for(let a of e)t.observe(a)&&(n=a),isTurnFailureEvent(a)&&(r=a),isFinalMessageCompleted(a)&&(i=a.data.message??void 0);return{boundary:n,failure:r,inputRequests:t.inputRequests,message:i,pendingAuthorizations:t.pendingAuthorizations,status:summarizeBoundaryStatus(n)}}function summarizeBoundaryStatus(e){return e?.type===`session.waiting`||e?.type===`turn.waiting`?`waiting`:e?.type===`session.failed`?`failed`:`completed`}async function collectTurnEvents(e){let t=[],n=new TurnSegment;for await(let r of e)if(t.push(r),n.observe(r))break;return t}function endsTurnSegment(e,t){return e.type===`turn.waiting`?t.requests||e.data.on===`input`&&!t.callbacks:isCurrentTurnBoundaryEvent(e)&&(e.type!==`session.waiting`||!t.callbacks)}var TurnSegment=class{#e=initialSessionProjection();#t=new Map;#n;constructor(e={}){this.#n=e.followCallbacks===!0}get inputRequests(){return openInputs(this.#e).map(e=>e.request)}get pendingAuthorizations(){return openSignIns(this.#e).flatMap(e=>this.#t.get(e.attemptId)??[])}observe(e){return this.#e=foldSession(this.#e,e),e.type===`authorization.required`&&this.#t.set(e.data.attemptId??e.data.name,e.data),endsTurnSegment(e,{callbacks:this.#n&&openSignIns(this.#e).some(e=>e.awaitsCallback===!0),requests:openInputs(this.#e).length>0})}};function isFinalMessageCompleted(e){return e.type===`message.completed`&&e.data.finishReason!==`tool-calls`}function authorizationKey(e){return e.attemptId===void 0?`name:${e.name}`:`attempt:${e.attemptId}`}export{TurnSegment,authorizationKey,collectTurnEvents,endsTurnSegment,summarizeTurnEvents};
+import{emptySessionView,foldReceivedEvent}from"#protocol/session-projection/fold.js";import{interaction}from"#protocol/session-projection/reader.js";import{openInteractions}from"#protocol/session-projection/selectors.js";import{deliveryStatus}from"#protocol/session-projection/request-status.js";function summarizeTurnEvents(e,t){let n=turnSummary(t);for(let t of e)n.observe(t);return n.result()}function turnSummary(e){let t=new ResponseSegment({deliveryId:e}),n,r,i=!1,a=new Map,o=new Map,s=new Map,c=new Map,l,u=new Map,d,f,p,m;function observe(h){h.type===`session.ended`&&(i=!0),h.type===`delivery.consumed`&&h.data.deliveryId===e&&(r=h.data.turnId),h.type===`delivery.settled`&&h.data.deliveryId===e&&(n=h.data),h.type===`turn.settled`&&a.set(h.data.turnId,h.data.outcome),t.observe(h)&&(d=t.boundary);let g=failureOf(h);if(f=g??f,g!==void 0&&(h.type===`turn.settled`&&c.set(h.data.turnId,g),h.type===`session.ended`&&(l=g)),h.type===`content.completed`&&(u.set(h.data.partId,{kind:h.data.kind,value:h.data.value}),h.data.kind===`result`&&(m=h.data.value,h.scope?.turnId!==void 0&&s.set(h.scope.turnId,m))),h.type===`turn.settled`){let e=(h.data.reply??[]).flatMap(e=>{let t=u.get(e);return t?.kind===`text`&&typeof t.value==`string`?[t.value]:[]});p=e.length===0?void 0:e.join(`
+`),o.set(h.data.turnId,p);for(let e of h.data.reply??[]){let t=u.get(e);t?.kind===`result`&&s.set(h.data.turnId,t.value)}}}function summarize(){let u=n?.turnId??r,h=e===void 0?summarizeBoundaryStatus(d,f):deliveryStatus(n?.outcome,a.get(u??``),l===void 0?void 0:`failed`);if(e!==void 0){let e=n?.outcome===`handled`||n?.outcome===`awaiting-input`;p=e&&u!==void 0?o.get(u):void 0,m=e&&u!==void 0?s.get(u):void 0,f=h===`failed`?c.get(u??``)??l:void 0,h===`failed`&&f===void 0&&(f={code:n?.outcome===`refused`?`DELIVERY_REFUSED`:`DELIVERY_FAILED`,message:n?.reason??(n?.outcome===`refused`?`The delivery was refused.`:`The delivery failed.`)})}return{boundary:d,failure:f,interactions:t.interactions,message:p,result:m,sessionEnded:i,status:h,outcome:n?.outcome}}return{observe,result:summarize}}function summarizeBoundaryStatus(e,t){return t===void 0?e?.type===`turn.settled`||e?.type===`session.ended`?e.data.outcome:e?.type===`turn.paused`?`awaiting-input`:`working`:`failed`}function failureOf(e){if(e.type===`turn.settled`&&e.data.outcome===`failed`)return e.data.error??{code:`TURN_FAILED`,message:`The turn failed.`};if(e.type===`session.ended`&&e.data.outcome===`failed`)return e.data.error??{code:`SESSION_FAILED`,message:`The session failed.`}}async function collectTurnEvents(e,t){let n=[],r=new ResponseSegment({deliveryId:t});for await(let t of e)if(n.push(t),r.observe(t))break;return n}function endsTurn(e){return e.type===`turn.settled`||e.type===`session.ended`||e.type===`turn.paused`&&e.data.awaiting.some(e=>`interactionId`in e)}var ResponseSegment=class{#e=emptySessionView();#t;#n;constructor(e={}){this.#t=e.deliveryId}get interactions(){return openInteractions(this.#e).flatMap(e=>interaction(this.#e,e.interactionId)??[])}get boundary(){return this.#n}observe(e){foldReceivedEvent(this.#e,e),(this.#t===void 0?endsTurn(e):e.type===`session.ended`||e.type===`delivery.settled`&&e.data.deliveryId===this.#t)&&(this.#n=e);let t=`meta`in e?e.meta:void 0,n=typeof t==`object`&&t&&`endOfLine`in t?t.endOfLine:void 0;return this.#n!==void 0&&n!==!1}};export{ResponseSegment,collectTurnEvents,endsTurn,failureOf,summarizeTurnEvents,turnSummary};

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

@@ -1,13 +1,14 @@
-import type { AgentStartedStreamEvent, MessageStreamEvent } from "#protocol/message.js";
+import type { SessionStreamEvent } from "#protocol/session-event.js";
 import { ClientAgentSession } from "#client/agent-session.js";
-import { MessageResponse } from "#client/message-response.js";
-import type { InputResponse } from "#shared/input.js";
-import type { CancelSessionResult, ClearResult, ClientSessionState, CompactResult, ClientRedirectPolicy, CreateSessionOptions, RespondTurnOptions, ResetResult, SendTurnInput, SendTurnOptions, SessionSnapshot, StreamOptions } from "#client/types.js";
+import { type Delivery } from "#client/delivery.js";
+import type { PrewarmSessionResult } from "#protocol/prewarm-session.js";
+import type { Answer } from "#shared/input.js";
+import type { ClientSessionState, ClientRedirectPolicy, CreateSessionOptions, RespondTurnOptions, SendTurnInput, SendTurnOptions, SessionSnapshot, SessionStreamOptions } from "#client/types.js";
 declare const followSession: unique symbol;
-interface FollowSessionOptions extends StreamOptions {
+interface FollowSessionOptions extends SessionStreamOptions {
     readonly headers?: Readonly<Record<string, string>>;
     readonly onCaughtUp?: () => void;
-    readonly resolveReconnectPolicy?: () => StreamOptions["streamReconnectPolicy"];
+    readonly resolveReconnectPolicy?: () => SessionStreamOptions["streamReconnectPolicy"];
     readonly resolveHeaders?: () => Readonly<Record<string, string>> | undefined;
 }
 /**
@@ -15,7 +16,7 @@ interface FollowSessionOptions extends StreamOptions {
  * configuration without depending on the full {@link Client} class.
  */
 export interface ClientSessionContext {
-    readonly host: string;
+    readonly baseUrl: string;
     readonly redirect?: ClientRedirectPolicy;
     resolveHeaders(perRequest?: Readonly<Record<string, string>>): Promise<Headers>;
 }
@@ -26,11 +27,13 @@ export declare class ClientSession {
     constructor(context: ClientSessionContext, state: ClientSessionState);
     /** @internal */
     static create<TOutput = unknown>(context: ClientSessionContext, input: SendTurnInput<TOutput> & CreateSessionOptions): Promise<{
-        readonly response: MessageResponse<TOutput>;
+        readonly delivery: Delivery<TOutput>;
         readonly session: ClientSession;
     }>;
     /** @internal */
     static prewarm(context: ClientSessionContext, options?: CreateSessionOptions): Promise<ClientSession>;
+    /** The fixed session ID; reading it performs no I/O. */
+    get id(): string;
     /** Current fixed session identity and durable stream cursor. */
     get state(): ClientSessionState;
     /** Reads a finite prefix through the durable tail without advancing this handle. */
@@ -38,38 +41,44 @@ export declare class ClientSession {
         readonly signal?: AbortSignal;
     }): Promise<SessionSnapshot>;
     /** Sends a message to this exact session ID. */
-    send<TOutput = unknown>(message: SendTurnInput<TOutput>["message"], options?: SendTurnOptions<TOutput>): Promise<MessageResponse<TOutput>>;
+    send<TOutput = unknown>(message: SendTurnInput<TOutput>["message"], options?: SendTurnOptions<TOutput>): Promise<Delivery<TOutput>>;
     /** Answers pending input requests on this exact session ID. */
-    respond<TOutput = unknown>(inputResponses: readonly InputResponse[], options?: RespondTurnOptions<TOutput>): Promise<MessageResponse<TOutput>>;
+    respond<TOutput = unknown>(answers: readonly Answer[], options?: RespondTurnOptions<TOutput>): Promise<Delivery<TOutput>>;
     /** Requests preparation of an existing idle session; never starts a model turn. */
     prewarm(options?: {
         readonly signal?: AbortSignal;
-    }): Promise<import("#protocol/prewarm-session.js").PrewarmSessionResult>;
+    }): Promise<PrewarmSessionResult>;
     /** Requests cooperative cancellation of this session's active turn. */
     cancel(options?: {
         readonly signal?: AbortSignal;
-        readonly turnId?: string;
-    }): Promise<CancelSessionResult>;
+        readonly turnId?: string | null;
+    }): Promise<Delivery>;
     /** Queues removal of this session's durable model-message history. */
-    clear(): Promise<ClearResult>;
+    clear(options?: {
+        readonly signal?: AbortSignal;
+    }): Promise<Delivery>;
     /** Queues context compaction without sending model input. */
-    compact(): Promise<CompactResult>;
+    compact(options?: {
+        readonly signal?: AbortSignal;
+    }): Promise<Delivery>;
     /** Terminally retires this exact session ID. The handle remains pinned to it. */
     reset(options?: {
         readonly reason?: string;
         readonly signal?: AbortSignal;
-    }): Promise<ResetResult>;
+    }): Promise<Delivery>;
     /** Opens this session's durable event stream from its stored cursor. */
-    stream(options?: StreamOptions): AsyncIterable<MessageStreamEvent>;
+    stream(options?: SessionStreamOptions): AsyncIterable<SessionStreamEvent>;
     /**
-     * The session an agent run opened, as this session's stream announced it.
-     * Pass an `agent.started` event from this session, then follow the child
-     * with `stream()`; reads use this session's host and credentials, for local
+     * The session an agent run opened, as this session's stream linked it.
+     * Pass a `child.opened` event from this session, then follow the child
+     * with `stream()`; reads use this session's base URL and credentials, for local
      * and remote agents alike.
      */
-    agent(started: AgentStartedStreamEvent): ClientAgentSession;
-    [followSession](options: FollowSessionOptions): AsyncIterable<MessageStreamEvent>;
+    agent(opened: Extract<SessionStreamEvent, {
+        type: "child.opened";
+    }>): ClientAgentSession;
+    [followSession](options: FollowSessionOptions): AsyncIterable<SessionStreamEvent>;
 }
 /** @internal Follow continuously while the frontend owns the session. */
-export declare function followClientSession(session: ClientSession, options: FollowSessionOptions): AsyncIterable<MessageStreamEvent>;
+export declare function followClientSession(session: ClientSession, options: FollowSessionOptions): AsyncIterable<SessionStreamEvent>;
 export {};

package/dist/src/client/session.js

@@ -1 +1 @@
-import{EVE_SESSION_ROUTE_PATH,createEveSessionRoutePath,createEveSessionStreamRoutePath}from"#protocol/routes.js";import{ClientError,createClientError}from"#client/client-error.js";import{TurnSegment}from"#client/session-utils.js";import{EVE_SESSION_ID_HEADER}from"#protocol/message.js";import{followStreamIterable,sleep}from"#client/open-stream.js";import{createClientUrl}from"#client/url.js";import{throwIfAborted}from"#client/abort-signal.js";import{MessageResponse}from"#client/message-response.js";import{ClientAgentSession}from"#client/agent-session.js";import{cancelClientSession,clearClientSession,compactClientSession,prewarmClientSession,resetClientSession}from"#client/session-controls.js";import{serializeOutputSchema}from"#tools/schema.js";const followSession=Symbol(`followClientSession`);var ClientSession=class ClientSession{#e;#t;constructor(e,t){this.#e=e,this.#t=t}static async create(e,t){let n=Date.now(),r=await postTurn(e,EVE_SESSION_ROUTE_PATH,t,!0,t.stubs),i=Date.now(),{sessionId:a,deliveryId:o}=await readAcceptedMessage(r),s=new ClientSession(e,{sessionId:a,streamIndex:0}),c={deliveryId:o,startedAt:n,notReadyMs:0,acceptedAt:i};return{response:s.#r(r,t,0,void 0,c),session:s}}static async prewarm(e,t={}){let{sessionId:n}=await readAcceptedMessage(await postCreateSession(e,t));return new ClientSession(e,{sessionId:n,streamIndex:0})}get state(){return this.#t}async snapshot(e){throwIfAborted(e?.signal);let t=[];for await(let n of this.#s({follow:!1,signal:e?.signal,startIndex:0}))t.push(n);return throwIfAborted(e?.signal),{events:t,session:{sessionId:this.#t.sessionId,streamIndex:t.length}}}async send(e,t={}){return await this.#n({...t,message:e},!0)}async respond(e,t={}){if(e.length===0)throw Error(`ClientSession.respond() requires at least one input response.`);return await this.#n({...t,inputResponses:e},!1)}async#n(e,t){let n=this.#t.streamIndex,r=createEveSessionRoutePath(this.#t.sessionId),{response:i,timing:a}=await postSessionSend(this.#e,r,e,t),{sessionId:o,deliveryId:s}=await readAcceptedMessage(i,this.#t.sessionId);if(o!==this.#t.sessionId)throw Error(`Message route returned a different session id.`);if(e.message!==void 0&&s===void 0)throw Error(`Message route did not return a delivery id. Update the server before sending with this client.`);return this.#r(i,e,n,e.message===void 0?void 0:s,{...a,deliveryId:s})}async prewarm(e){return await prewarmClientSession({context:this.#e,sessionId:this.#t.sessionId,signal:e?.signal})}async cancel(e){return await cancelClientSession({context:this.#e,options:e,sessionId:this.#t.sessionId})}async clear(){return await clearClientSession({context:this.#e,sessionId:this.#t.sessionId})}async compact(){return await compactClientSession({context:this.#e,sessionId:this.#t.sessionId})}async reset(e){return await resetClientSession({context:this.#e,options:e,sessionId:this.#t.sessionId})}stream(e){if(e?.follow===!1&&(e.startIndex??this.#t.streamIndex)<0)throw Error(`stream({ follow: false }) requires a nonnegative startIndex; a tail-relative cursor cannot be bounded.`);return this.#a(e)}agent(e){return new ClientAgentSession(this.#e,e)}[followSession](e){return this.#a({...e,keepAlive:!0})}#r(e,t,n,r,i){return e.body?.cancel().catch(()=>{}),new MessageResponse({cancelTurn:async e=>await this.cancel({turnId:e}),createStream:e=>this.#i(n,t,r,e),deliveryId:r,receipt:i,resumesTurn:t.inputResponses!==void 0,sessionId:this.#t.sessionId})}async*#i(e,t,n,r){let i=0,a=n===void 0,o=!1,s=new TurnSegment({followCallbacks:!0});try{for await(let c of r??this.#s({headers:t.headers,keepAlive:!0,signal:t.signal,startIndex:e,streamReconnectPolicy:t.streamReconnectPolicy})){if(i+=1,n!==void 0){let e=c.meta?.deliveryIds?.includes(n)===!0,t=c.type===`session.failed`||c.type===`session.completed`;if(!e&&t&&(!a||c.type===`session.completed`))throw Error(`The session ended before the accepted message reached its turn boundary.`);if(!a&&!e)continue;let r=c.meta?.deliveryIds!==void 0;if(!t&&r&&!e)continue;a=!0}if(o=s.observe(c),yield c,o)break}if(n!==void 0&&!o&&!t.signal?.aborted)throw Error(`The response stream ended before the accepted message reached its turn boundary.`)}finally{this.#o(e+i)}}async*#a(e){let t=e?.startIndex??this.#t.streamIndex,n=0;for await(let r of this.#s({follow:e?.follow,headers:e?.headers,keepAlive:e?.keepAlive,onCaughtUp:e?.onCaughtUp,resolveHeaders:e?.resolveHeaders,resolveReconnectPolicy:e?.resolveReconnectPolicy,signal:e?.signal,startIndex:t,streamReconnectPolicy:e?.streamReconnectPolicy}))n+=1,t>=0&&this.#o(t+n),yield r}#o(e){this.#t={sessionId:this.#t.sessionId,streamIndex:Math.max(this.#t.streamIndex,e)}}#s(e){return followStreamIterable({onCaughtUp:e.onCaughtUp,follow:e.follow,host:this.#e.host,keepAlive:e.keepAlive,resolveHeaders:()=>this.#e.resolveHeaders(e.resolveHeaders?.()??e.headers),path:createEveSessionStreamRoutePath(this.#t.sessionId),redirect:this.#e.redirect,signal:e.signal,startIndex:e.startIndex,streamReconnectPolicy:e.streamReconnectPolicy,resolveReconnectPolicy:e.resolveReconnectPolicy})}};function followClientSession(e,t){return e[followSession](t)}async function postSessionSend(e,t,n,r){let i=Date.now(),a=i+2e4,o=250;for(;;){let s=Date.now();try{return{response:await postTurn(e,t,n,!1),timing:{startedAt:i,notReadyMs:s-i,acceptedAt:Date.now()}}}catch(e){if(!r||!isSessionNotReady(e))throw e;let t=a-Date.now();if(t<=0)throw e;await sleep(Math.min(o,t),n.signal)}throwIfAborted(n.signal),o=Math.min(o*2,2e3)}}async function postCreateSession(e,t){let n=await e.resolveHeaders(t.headers),r=t.stubs===void 0?void 0:JSON.stringify({stubs:t.stubs});r!==void 0&&n.set(`content-type`,`application/json`);let i=await fetch(createClientUrl(e.host,EVE_SESSION_ROUTE_PATH),{body:r,headers:n,method:`POST`,redirect:e.redirect,signal:t.signal??null});if(!i.ok){let e=await i.text();throw new ClientError(i.status,e,i.headers)}return i}function isSessionNotReady(e){return e instanceof ClientError&&e.status===409&&e.code===`session_not_ready`}async function postTurn(e,t,n,r,i){let a=createMessageBody(n,r);if(a===null)throw Error(r?`Creating a session requires a non-empty message.`:`A session turn requires a non-empty message or inputResponses.`);i!==void 0&&(a.stubs=i);let o=await e.resolveHeaders(n.headers);o.set(`content-type`,`application/json`);let s=await fetch(createClientUrl(e.host,t),{body:JSON.stringify(a),headers:o,method:`POST`,redirect:e.redirect,signal:n.signal??null});if(!s.ok){let e=await s.text();throw createClientError(s.status,e,s.headers)}return s}async function readAcceptedMessage(e,t){let n=await e.json(),r=(typeof n.sessionId==`string`?n.sessionId:void 0)??e.headers.get(EVE_SESSION_ID_HEADER)?.trim()??t;if(!r)throw Error(`Message route did not return a session id.`);return{sessionId:r,deliveryId:typeof n.deliveryId==`string`&&n.deliveryId.length>0?n.deliveryId:void 0}}function createMessageBody(e,t){let n={};e.message!==void 0&&(n.message=e.message),e.inputResponses!==void 0&&e.inputResponses.length>0&&(n.inputResponses=e.inputResponses),!t&&e.message!==void 0&&e.turnPolicy!==void 0&&(n.turnPolicy=e.turnPolicy),e.clientContext!==void 0&&(n.clientContext=e.clientContext);let r=serializeOutputSchema(e.outputSchema);return r!==void 0&&(n.outputSchema=r),t&&n.message===void 0||n.message===void 0&&n.inputResponses===void 0?null:n}export{ClientSession,followClientSession};
+import{SessionNotActiveError}from"#channel/session-not-active-error.js";import{StreamDelivery}from"#client/delivery.js";import{deliveryEvents}from"#client/delivery-events.js";import{EVE_SESSION_ROUTE_PATH,createEveSessionRoutePath,createEveSessionStreamRoutePath}from"#protocol/routes.js";import{ClientError,createClientError}from"#client/client-error.js";import{EVE_SESSION_ID_HEADER}from"#protocol/session-http.js";import{followStreamIterable,sleep}from"#client/open-stream.js";import{createClientUrl}from"#client/url.js";import{throwIfAborted}from"#client/abort-signal.js";import{ClientAgentSession}from"#client/agent-session.js";import{messageForRequest}from"#client/file-parts.js";import{prewarmClientSession,sendClientControl}from"#client/session-controls.js";import{serializeOutputSchema}from"#tools/schema.js";const followSession=Symbol(`followClientSession`);var ClientSession=class ClientSession{#e;#t;constructor(e,t){this.#e=e,this.#t=t}static async create(e,t){let n=Date.now(),r=await postTurn(e,EVE_SESSION_ROUTE_PATH,t,!0,t.stubs),i=Date.now(),{sessionId:a,deliveryId:o}=await readAcceptedMessage(r),s=new ClientSession(e,{sessionId:a,streamIndex:0}),c={deliveryId:o,startedAt:n,notReadyMs:0,acceptedAt:i};return{delivery:s.#i(r,t,0,o,c),session:s}}static async prewarm(e,t={}){let{sessionId:n}=await readAcceptedMessage(await postCreateSession(e,t));return new ClientSession(e,{sessionId:n,streamIndex:0})}get id(){return this.#t.sessionId}get state(){return this.#t}async snapshot(e){throwIfAborted(e?.signal);let t=[],n=0;for await(let{cursor:r,event:i}of this.#c({follow:!1,signal:e?.signal,startIndex:0}))t.push(i),n=r;return throwIfAborted(e?.signal),{events:t,session:{sessionId:this.#t.sessionId,streamIndex:n}}}async send(e,t={}){return await this.#n({...t,message:e},!0)}async respond(e,t={}){if(e.length===0)throw Error(`ClientSession.respond() requires at least one answer.`);return await this.#n({...t,answers:e},!1)}async#n(e,t){let n=this.#t.streamIndex,r=createEveSessionRoutePath(this.#t.sessionId),{response:i,timing:a}=await postSessionSend(this.#e,r,e,t),{sessionId:o,deliveryId:s}=await readAcceptedMessage(i,this.#t.sessionId);if(o!==this.#t.sessionId)throw Error(`Message route returned a different session id.`);if(s===void 0)throw Error(`Message route did not return a delivery id. Update the server before sending with this client.`);return this.#i(i,e,n,s,{...a,deliveryId:s})}async prewarm(e){return await prewarmClientSession({context:this.#e,sessionId:this.#t.sessionId,signal:e?.signal})}async cancel(e){return this.#r(`cancel`,e)}async clear(e){return this.#r(`clear`,e)}async compact(e){return this.#r(`compact`,e)}async reset(e){return this.#r(`reset`,e)}async#r(e,t){let n=this.#t.streamIndex,r=await sendClientControl({context:this.#e,kind:e,options:t,sessionId:this.#t.sessionId});return new StreamDelivery({...r,createStream:t=>this.#a(n,{signal:t?.signal},r.deliveryId,e!==`reset`)})}stream(e){return this.#o(e)}agent(e){return new ClientAgentSession(this.#e,this.id,e)}[followSession](e){return this.#o(e)}#i(e,t,n,r,i){if(e.body?.cancel().catch(()=>{}),r===void 0)throw Error(`Message route did not return a delivery id.`);return new StreamDelivery({createStream:e=>this.#a(n,{...t,signal:e?.signal},r),deliveryId:r,receipt:i,sessionId:this.#t.sessionId})}#a(e,t,n,r=!0){return deliveryEvents(this.#o({follow:r,headers:t.headers,signal:t.signal,startIndex:e,streamReconnectPolicy:t.streamReconnectPolicy}),n,t.signal)}async*#o(e){let t=e?.startIndex??this.#t.streamIndex;for await(let{cursor:n,event:r}of this.#c({follow:e?.follow,headers:e?.headers,onCaughtUp:e?.onCaughtUp,resolveHeaders:e?.resolveHeaders,resolveReconnectPolicy:e?.resolveReconnectPolicy,signal:e?.signal,startIndex:t,streamReconnectPolicy:e?.streamReconnectPolicy}))this.#s(n),yield r}#s(e){this.#t={sessionId:this.#t.sessionId,streamIndex:Math.max(this.#t.streamIndex,e)}}#c(e){return followStreamIterable({onCaughtUp:e.onCaughtUp,follow:e.follow,baseUrl:this.#e.baseUrl,resolveHeaders:()=>this.#e.resolveHeaders(e.resolveHeaders?.()??e.headers),path:createEveSessionStreamRoutePath(this.#t.sessionId),redirect:this.#e.redirect,signal:e.signal,startIndex:e.startIndex,streamReconnectPolicy:e.streamReconnectPolicy,resolveReconnectPolicy:e.resolveReconnectPolicy})}};function followClientSession(e,t){return e[followSession](t)}async function postSessionSend(e,t,n,r){let i=Date.now(),a=i+2e4,o=250;for(;;){let s=Date.now();try{return{response:await postTurn(e,t,n,!1),timing:{startedAt:i,notReadyMs:s-i,acceptedAt:Date.now()}}}catch(e){if(!r||!isSessionNotReady(e))throw e;let t=a-Date.now();if(t<=0)throw e;await sleep(Math.min(o,t),n.signal)}throwIfAborted(n.signal),o=Math.min(o*2,2e3)}}async function postCreateSession(e,t){let n=await e.resolveHeaders(t.headers),r=t.stubs===void 0?void 0:JSON.stringify({stubs:t.stubs});r!==void 0&&n.set(`content-type`,`application/json`);let i=await fetch(createClientUrl(e.baseUrl,EVE_SESSION_ROUTE_PATH),{body:r,headers:n,method:`POST`,redirect:e.redirect,signal:t.signal??null});if(!i.ok){let e=await i.text();throw new ClientError(i.status,e,i.headers)}return i}function isSessionNotReady(e){return SessionNotActiveError.is(e)&&e.retryable}async function postTurn(e,t,n,r,i){let a=createMessageBody(n,r);if(a===null)throw Error(r?`Creating a session requires a non-empty message.`:`A session turn requires a non-empty message or answers.`);i!==void 0&&(a.stubs=i);let o=await e.resolveHeaders(n.headers);o.set(`content-type`,`application/json`);let s=await fetch(createClientUrl(e.baseUrl,t),{body:JSON.stringify(a),headers:o,method:`POST`,redirect:e.redirect,signal:n.signal??null});if(!s.ok){let e=await s.text();throw createClientError(s.status,e,s.headers)}return s}async function readAcceptedMessage(e,t){let n=await e.json(),r=(typeof n.sessionId==`string`?n.sessionId:void 0)??e.headers.get(EVE_SESSION_ID_HEADER)?.trim()??t;if(!r)throw Error(`Message route did not return a session id.`);return{sessionId:r,deliveryId:typeof n.deliveryId==`string`&&n.deliveryId.length>0?n.deliveryId:void 0}}function createMessageBody(e,t){let n={};e.message!==void 0&&(n.message=messageForRequest(e.message)),e.answers!==void 0&&e.answers.length>0&&(n.answers=e.answers),!t&&e.message!==void 0&&e.turnPolicy!==void 0&&(n.turnPolicy=e.turnPolicy),e.clientContext!==void 0&&(n.clientContext=e.clientContext);let r=serializeOutputSchema(e.outputSchema);return r!==void 0&&(n.outputSchema=r),t&&n.message===void 0||n.message===void 0&&n.answers===void 0?null:n}export{ClientSession,followClientSession};

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

@@ -1,9 +1,9 @@
 import { ClientSession, type ClientSessionContext } from "#client/session.js";
-import type { MessageResponse } from "#client/message-response.js";
+import type { Delivery } from "#client/delivery.js";
 import type { CreateSessionOptions, SendTurnInput } from "#client/types.js";
 /** Result of explicitly creating an ID-addressed client session. */
 export interface CreatedClientSession<TOutput = unknown> {
-    readonly response: MessageResponse<TOutput>;
+    readonly delivery: Delivery<TOutput>;
     readonly session: ClientSession;
 }
 /** Result of creating a session before its first turn. */

package/dist/src/client/stream-version.d.ts

@@ -1,3 +1,5 @@
-import type { MessageStreamVersion } from "#protocol/message-version.js";
+import { EVE_MESSAGE_STREAM_VERSION } from "#protocol/session-http.js";
+/** The one stream version this client reads. Sessions don't cross a major version. */
+export type MessageStreamVersion = typeof EVE_MESSAGE_STREAM_VERSION;
 /** Reads and validates the schema version declared by a message stream response. */
 export declare function readMessageStreamVersion(headers: Headers): MessageStreamVersion;

package/dist/src/client/stream-version.js

@@ -1 +1 @@
-import{EVE_STREAM_VERSION_HEADER}from"#protocol/message.js";const supportedMessageStreamVersions={21:!0,22:!0,23:!0,24:!0,25:!0,26:!0};function readMessageStreamVersion(e){let t=e.get(EVE_STREAM_VERSION_HEADER);if(t!==null&&Object.hasOwn(supportedMessageStreamVersions,t))return t;throw TypeError(t===null?`Missing ${EVE_STREAM_VERSION_HEADER} response header.`:`Unsupported message stream version: ${t}.`)}export{readMessageStreamVersion};
+import{EVE_MESSAGE_STREAM_VERSION,EVE_STREAM_VERSION_HEADER}from"#protocol/session-http.js";function readMessageStreamVersion(e){let t=e.get(EVE_STREAM_VERSION_HEADER);if(t===EVE_MESSAGE_STREAM_VERSION)return t;throw TypeError(t===null?`Missing ${EVE_STREAM_VERSION_HEADER} response header.`:`Unsupported message stream version: ${t}.`)}export{readMessageStreamVersion};

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

@@ -0,0 +1,43 @@
+import type { SessionStreamEvent } from "#protocol/session-event.js";
+/** One user message or completed assistant message in a {@link TranscriptData}. */
+export interface TranscriptMessage {
+    readonly role: "assistant" | "user";
+    readonly text: string;
+}
+/** A session's text conversation, as {@link transcriptOf} reads it. */
+export interface TranscriptData {
+    /** Messages since the session's last clear, oldest first. */
+    readonly messages: readonly TranscriptMessage[];
+}
+/** Options for {@link transcriptOf}. */
+export interface TranscriptOptions {
+    /**
+     * Most recent messages kept; older ones are dropped as new ones arrive.
+     * A positive integer. Unbounded when omitted.
+     */
+    readonly maxMessages?: number;
+}
+/**
+ * A session's text conversation, from its stream: imported history, user message text, and
+ * completed assistant text, oldest first.
+ *
+ * The user's text is what each consumed delivery carries, after the history it imported; the
+ * assistant's is each completed reply part. When one line consumes several deliveries, their
+ * history comes before their messages, as the model reads them. Reasoning, narration, tool calls
+ * and results, attachments, interactions, and interrupted or unfinished output are left out. A completed clear (`context.settled` selecting
+ * nothing), or a reset that ended a stranded session, starts the transcript over, so text the
+ * session no longer holds is never returned.
+ *
+ * @example
+ * ```ts
+ * import { transcriptOf } from "eve/client";
+ * import { sessions } from "eve/server";
+ *
+ * const events = [];
+ * for await (const event of sessions.attach(sessionId).stream({ follow: false })) events.push(event);
+ * const { messages } = transcriptOf(events, { maxMessages: 40 });
+ * ```
+ *
+ * @throws When `maxMessages` is not a positive integer.
+ */
+export declare function transcriptOf(events: Iterable<SessionStreamEvent>, options?: TranscriptOptions): TranscriptData;

package/dist/src/client/transcript.js

@@ -0,0 +1,2 @@
+function transcriptOf(e,t={}){let{maxMessages:n}=t;if(n!==void 0&&(!Number.isSafeInteger(n)||n<=0))throw TypeError(`transcriptOf: "maxMessages" must be a positive integer; received ${String(n)}.`);let r=[],i,a,append=e=>{e.text.trim().length>0&&r.push(e)};for(let t of e){let e=t.meta?.position?.line;switch((t.type!==`delivery.consumed`||a?.line!==e)&&(a=void 0),t.type){case`delivery.admitted`:t.data.source!==void 0&&`control`in t.data.source&&t.data.source.control===`reset`&&(i=t.data.deliveryId);break;case`delivery.consumed`:{a??={at:r.length,line:e};let n=(t.data.history??[]).filter(({text:e})=>e.trim().length>0).map(({role:e,text:t})=>({role:e,text:t}));r.splice(a.at,0,...n),a.at+=n.length,append({role:`user`,text:textOf(t.data.parts)});break}case`content.completed`:t.data.kind===`text`&&t.data.phase===`reply`&&t.data.interrupted!==!0&&typeof t.data.value==`string`&&append({role:`assistant`,text:t.data.value});break;case`context.settled`:t.data.selects===null&&(r=[]);break;case`session.ended`:t.data.cause!==void 0&&`deliveryId`in t.data.cause&&t.data.cause.deliveryId===i&&(r=[])}}return{messages:n===void 0?r:r.slice(-n)}}function textOf(e){return e.flatMap(e=>e.kind===`text`?[e.text]:[]).join(`
+`)}export{transcriptOf};

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

@@ -1,16 +1,16 @@
-import type { UserContent } from "ai";
+import type { SessionStreamEvent } from "#protocol/session-event.js";
+import type { MessageContent } from "#shared/message-content.js";
 import type { StandardJSONSchemaV1 } from "#compiled/@standard-schema/spec/index.js";
-import type { MessageStreamEvent } from "#protocol/message.js";
 import type { CancelTurnResult } from "#protocol/cancel-turn.js";
 import type { ClearStatus } from "#protocol/clear-session.js";
 import type { CompactStatus } from "#protocol/compact-session.js";
 import type { ResetStatus } from "#protocol/reset-session.js";
 import type { TurnPolicy } from "#channel/types.js";
-import type { InputRequest, InputResponse } from "#shared/input.js";
+import type { Answer } from "#shared/input.js";
 import type { JsonObject } from "#shared/json.js";
 import type { ToolStub } from "#tool-stubs/types.js";
-export type { HealthResult } from "#client/health-schema.js";
-export type { AgentInfoChannelEntry, AgentInfoChannels, AgentInfoConnectionEntry, AgentInfoDynamicResolverEntry, AgentInfoEntry, AgentInfoHookEntry, AgentInfoInstructions, AgentInfoInstructionsEntry, AgentInfoMemoryEntry, AgentInfoResult, AgentInfoRemoteAgentEntry, AgentInfoSandboxEntry, AgentInfoScheduleEntry, AgentInfoSkillEntry, AgentInfoSource, AgentInfoSubagentEntry, AgentInfoToolEntry, AgentInfoTools, } from "./agent-info-schema.js";
+export type { HealthResult } from "#client/health-types.js";
+export type { AgentInfoChannelEntry, AgentInfoChannels, AgentInfoConnectionEntry, AgentInfoDynamicResolverEntry, AgentInfoEntry, AgentInfoHookEntry, AgentInfoInstructions, AgentInfoInstructionsEntry, AgentInfoMemoryEntry, AgentInfoResult, AgentInfoRemoteAgentEntry, AgentInfoSandboxEntry, AgentInfoScheduleEntry, AgentInfoSkillEntry, AgentInfoSource, AgentInfoSubagentEntry, AgentInfoToolEntry, AgentInfoTools, } from "./agent-info-types.js";
 /**
  * Static credential value or per-request credential resolver.
  */
@@ -54,7 +54,7 @@ export interface ClientOptions {
      * Base URL of the eve agent server. Query parameters are included on every
      * request; request-specific parameters override parameters with the same name.
      */
-    readonly host: string;
+    readonly baseUrl: string;
     /**
      * Authentication configuration. The client resolves credentials before each
      * request, so token-refresh callbacks are called on every HTTP call.
@@ -78,7 +78,7 @@ export interface ClientOptions {
  * Input object for creating a client session. The first message is required.
  */
 export interface SendTurnInput<TOutput = unknown> extends SendTurnOptions<TOutput> {
-    readonly message: string | UserContent;
+    readonly message: MessageContent;
 }
 /** Request options for creating a conversation session before its first turn. */
 export interface CreateSessionOptions {
@@ -111,7 +111,7 @@ export interface SendTurnOptions<TOutput = unknown> {
      *
      * The client lowers Standard Schema implementations (Zod, Valibot,
      * ArkType, etc.) to JSON Schema before sending the request. The server is
-     * authoritative for validation; {@link MessageResult.data} is typed to this
+     * authoritative for validation; {@link DeliveryResult.data} is typed to this
      * schema's output type and is not revalidated client-side.
      */
     readonly outputSchema?: StandardJSONSchemaV1<unknown, TOutput> | JsonObject;
@@ -131,13 +131,14 @@ export interface SendTurnOptions<TOutput = unknown> {
     readonly headers?: Readonly<Record<string, string>>;
 }
 /** Options for answering pending HITL input requests on a client session. */
-export type RespondTurnOptions<TOutput = unknown> = SendTurnOptions<TOutput>;
+export type RespondTurnOptions<TOutput = unknown> = Omit<SendTurnOptions<TOutput>, "turnPolicy">;
 /** @internal Transport envelope used by stores and command adapters. */
 export type SendTurnPayload<TOutput = unknown> = (SendTurnOptions<TOutput> & {
-    readonly inputResponses?: never;
-    readonly message: string | UserContent;
+    readonly answers?: never;
+    readonly message: MessageContent;
 }) | (RespondTurnOptions<TOutput> & {
-    readonly inputResponses: readonly InputResponse[];
+    readonly answers: readonly Answer[];
+    readonly turnPolicy?: never;
     readonly message?: never;
 });
 /** Retry and backoff settings for one kind of stream reconnection. */
@@ -151,10 +152,12 @@ export interface StreamReconnectRetryPolicy {
 }
 /** Configurable policy used when automatic stream reconnection is enabled. */
 export interface ResolvedStreamReconnectPolicy {
-    /** Retry policy for opening an HTTP stream connection. */
+    /**
+     * Retry policy for opening an HTTP stream connection. Its `maxAttempts` also bounds how many
+     * consecutive transport failures a bounded read (`follow: false`) retries. A read that follows
+     * retries failures for as long as it runs, and stops on what it reads.
+     */
     readonly streamOpenReconnectPolicy?: StreamReconnectRetryPolicy;
-    /** Retry policy for reconnecting streams that make no progress. */
-    readonly streamIdleReconnectPolicy?: StreamReconnectRetryPolicy;
     /** HTTP response statuses that may be retried while opening a stream. */
     readonly retryableErrorStatuses?: readonly number[];
 }
@@ -162,33 +165,7 @@ export interface ResolvedStreamReconnectPolicy {
 export type StreamReconnectPolicy = ResolvedStreamReconnectPolicy | {
     readonly reconnect: false;
 };
-/**
- * Options for {@link ClientSession.stream}.
- */
-export interface StreamOptions {
-    /**
-     * Reconnection policy for the event stream. Omit to use the default policy,
-     * or pass `{ reconnect: false }` when the caller owns cursor recovery.
-     */
-    readonly streamReconnectPolicy?: StreamReconnectPolicy;
-    /**
-     * Absolute event index to start from. Negative values read relative to the
-     * current tail (`-1` starts at the latest event). Relative-tail streams do
-     * not reconnect automatically because their absolute cursor is unknown.
-     */
-    readonly startIndex?: number;
-    /**
-     * Follow the live stream after the durable tail (default). Pass `false`
-     * for a bounded catch-up read: yields events until the cursor passes the
-     * tail observed when the stream opened, then returns instead of
-     * following. Requires a nonnegative start cursor.
-     */
-    readonly follow?: boolean;
-    /**
-     * Abort signal for cancelling the stream.
-     */
-    readonly signal?: AbortSignal;
-}
+export type { SessionStreamOptions } from "#shared/session.js";
 /** Result of requesting cancellation for a client session's active turn. */
 export type CancelSessionResult = CancelTurnResult;
 /** Result of requesting a context clear for a client session. */
@@ -218,45 +195,7 @@ export type ResetResult = {
     /** The fixed session ID was unknown or no longer active. */
     readonly status: Extract<ResetStatus, "no_active_session">;
 };
-/**
- * Aggregated result of one message turn, returned by
- * {@link MessageResponse.result}.
- */
-export interface MessageResult<TOutput = unknown> {
-    /**
-     * Final structured result emitted by the harness, when this turn requested
-     * an output schema and the server fulfilled it.
-     */
-    readonly data: TOutput | undefined;
-    /**
-     * The final completed assistant message text, or `undefined` if no terminal
-     * `message.completed` event was observed.
-     */
-    readonly message: string | undefined;
-    /**
-     * All events received during this turn.
-     */
-    readonly events: MessageStreamEvent[];
-    /**
-     * HITL input requests emitted in this response and still open at its boundary.
-     * Earlier requests may remain open in the same session.
-     */
-    readonly inputRequests: readonly InputRequest[];
-    /**
-     * The session ID for this turn. Always populated; the post-turn handler
-     * rejects responses that do not assign a session id.
-     */
-    readonly sessionId: string;
-    /**
-     * How the turn ended.
-     *
-     * - `"completed"`: the session finished (`session.completed`).
-     * - `"waiting"`: the session is parked for the next user message
-     *   (`session.waiting`).
-     * - `"failed"`: the session ended in a terminal failure (`session.failed`).
-     */
-    readonly status: "completed" | "failed" | "waiting";
-}
+export type { Delivery, DeliveryResult } from "#shared/delivery.js";
 /**
  * Response from the health endpoint.
  */
@@ -272,7 +211,7 @@ export interface ClientSessionState {
  */
 export interface SessionSnapshot {
     /** Events from the start of the session through the durable tail observed when the read opened. */
-    readonly events: readonly MessageStreamEvent[];
+    readonly events: readonly SessionStreamEvent[];
     /** Session cursor advanced exactly past {@link events}. */
     readonly session: ClientSessionState;
 }

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

@@ -1,7 +1,7 @@
 /**
- * Builds a fetchable URL from a caller-provided host and an eve route path.
+ * Builds a fetchable URL from a caller-provided base URL and an eve route path.
  *
- * `host` may be an absolute origin (`https://agent.example.com`) or a
+ * `baseUrl` may be an absolute origin (`https://agent.example.com`) or a
  * same-origin prefix (`/api`). Prefixes are important for browser clients that
  * talk to an app-owned proxy instead of the eve deployment directly.
  *
@@ -10,4 +10,4 @@
  * encode the `?` into the final path segment. Explicit `searchParams` win
  * over same-named embedded query params.
  */
-export declare function createClientUrl(host: string, routePath: string, searchParams?: Readonly<Record<string, string>>): string;
+export declare function createClientUrl(baseUrl: string, routePath: string, searchParams?: Readonly<Record<string, string>>): string;

package/dist/src/compiled/.vendor-stamp.json

@@ -61,7 +61,7 @@
     "zod": "4.5.4",
     "zod-validation-error": "5.0.0"
   },
-  "scriptHash": "b350dbbe6a6621651989fdd64f1028d7339f90c15bb60f8fa0afc90e97d33db3",
+  "scriptHash": "21318c9917122e081230b6faa90b38b521dcca8709046aabefd5782edd0ddf2f",
   "toolVersions": {
     "rolldown": "1.2.9",
     "typescript": "7.0.2"