eve 0.83.2 → 0.84.0

package/dist/src/tracing/eve/policy.js

@@ -1 +1 @@
-import{normalizeChannelAudience}from"#shared/channel-audience.js";import{ConversationContextKey}from"#shared/conversation-context.js";import{applyLiveDeliveryAudienceCeiling,resolveForwardedTraceSeed}from"#shared/forwarded-trace-policy.js";import{contextStorage}from"#context/container.js";import{SessionTraceSeedKey}from"#context/keys.js";import{isSampledTrace,resolveTracePolicyDecision}from"#shared/trace-policy.js";import{withoutInstrumentationContent}from"#instrumentation/content.js";import{readInstrumentationDecision}from"#shared/instrumentation-decision.js";import{instrumentationEventForTraceDecision}from"#instrumentation/content-policy.js";function createEveCapturePolicy(e){return{async projectEvent(t){let n=await e.stateStore.get(`session`,`scope`in t?t.scope.sessionId:t.sessionId),r=audienceForEvent(t,n?.channelAudience),i=`traceSeed`in t?t.traceSeed:void 0,a=contextStorage.getStore()?.get(SessionTraceSeedKey),o=resolveForwardedTraceSeed(a),s=resolveForwardedTraceSeed(i,o?.forwardedTracePolicy),decisionForTrace=t=>t===void 0?void 0:resolveTracePolicyDecision(isSampledTrace(t),{audience:r,environment:e.environment}),c=s?.decision??o?.decision??readInstrumentationDecision(n?.decision)??decisionForTrace(i)??decisionForTrace(a)??decisionForTrace(n?.context);if(c===void 0)return withoutInstrumentationContent(t);let l=s===void 0||!(`traceSeed`in t)||t.traceSeed===void 0?t:{...t,traceSeed:{...t.traceSeed,decision:s.decision,traceFlags:s.traceFlags}};return instrumentationEventForTraceDecision(l,applyLiveDeliveryAudienceCeiling(c.action===`drop`?c:{...c,recordInputs:e.recordInputs&&c.recordInputs,recordOutputs:e.recordOutputs&&c.recordOutputs},r,s?.forwardedTracePolicy??o?.forwardedTracePolicy,e.environment),{audience:r,environment:e.environment},{applyAudienceCeiling:!1})},async forOperation(t){let n=await e.stateStore.get(`session`,t.sessionId),r=contextStorage.getStore(),i=resolveForwardedTraceSeed(r?.get(SessionTraceSeedKey)),a=i?.decision??n?.decision,o=a===void 0?void 0:applyLiveDeliveryAudienceCeiling(a,normalizeChannelAudience(t.channelAudience??r?.get(ConversationContextKey)?.audience??n?.channelAudience),i?.forwardedTracePolicy,e.environment);return{recordInputs:e.recordInputs&&o?.action===`record`&&o.recordInputs,recordOutputs:e.recordOutputs&&o?.action===`record`&&o.recordOutputs}}}}function audienceForEvent(e,t){return`delivery`in e?normalizeChannelAudience(e.delivery.channelAudience):`scope`in e&&e.scope.channelAudience!==void 0?normalizeChannelAudience(e.scope.channelAudience):e.type===`session.started`?normalizeChannelAudience(e.channelAudience):normalizeChannelAudience(t)}export{createEveCapturePolicy};
+import{normalizeChannelAudience}from"#shared/channel-audience.js";import{ConversationContextKey}from"#shared/conversation-context.js";import{applyLiveDeliveryAudienceCeiling,resolveForwardedTraceSeed}from"#shared/forwarded-trace-policy.js";import{contextStorage}from"#context/container.js";import{SessionTraceSeedKey}from"#context/keys.js";import{isSampledTrace,resolveTracePolicyDecision}from"#shared/trace-policy.js";import{withoutInstrumentationContent}from"#instrumentation/content.js";import{readInstrumentationDecision}from"#shared/instrumentation-decision.js";import{instrumentationEventForTraceDecision}from"#instrumentation/content-policy.js";function createEveCapturePolicy(e){return{async projectEvent(t){let n=await e.stateStore.get(`session`,`scope`in t?t.scope.sessionId:t.sessionId),r=audienceForEvent(t,n?.channelAudience),i=`traceSeed`in t?t.traceSeed:void 0,a=contextStorage.getStore()?.get(SessionTraceSeedKey),o=resolveForwardedTraceSeed(a),s=resolveForwardedTraceSeed(i,o?.forwardedTracePolicy),decisionForTrace=t=>t===void 0?void 0:resolveTracePolicyDecision(isSampledTrace(t),{audience:r,environment:e.environment}),c=s?.decision??o?.decision??readInstrumentationDecision(n?.decision)??decisionForTrace(i)??decisionForTrace(a)??decisionForTrace(n?.context);if(c===void 0)return withoutInstrumentationContent(t);let l=s===void 0||!(`traceSeed`in t)||t.traceSeed===void 0?t:{...t,traceSeed:{...t.traceSeed,decision:s.decision,traceFlags:s.traceFlags}};return instrumentationEventForTraceDecision(l,applyLiveDeliveryAudienceCeiling(c.action===`drop`?c:{...c,recordInputs:e.recordInputs&&c.recordInputs,recordOutputs:e.recordOutputs&&c.recordOutputs},r,s?.forwardedTracePolicy??o?.forwardedTracePolicy,e.environment),{audience:r,environment:e.environment},{applyAudienceCeiling:!1})},async forOperation(t){let n=await e.stateStore.get(`session`,t.sessionId),r=contextStorage.getStore(),i=resolveForwardedTraceSeed(r?.get(SessionTraceSeedKey)),a=i?.decision??n?.decision,o=a===void 0?void 0:applyLiveDeliveryAudienceCeiling(a,normalizeChannelAudience(t.channelAudience??r?.get(ConversationContextKey)?.audience??n?.channelAudience),i?.forwardedTracePolicy,e.environment);return{recordInputs:e.recordInputs&&o?.action===`record`&&o.recordInputs,recordOutputs:e.recordOutputs&&o?.action===`record`&&o.recordOutputs}}}}function audienceForEvent(e,t){return`delivery`in e?normalizeChannelAudience(e.delivery?.channelAudience):`scope`in e&&e.scope.channelAudience!==void 0?normalizeChannelAudience(e.scope.channelAudience):e.type===`session.started`?normalizeChannelAudience(e.channelAudience):normalizeChannelAudience(t)}export{createEveCapturePolicy};

package/dist/src/tracing/eve/session.d.ts

@@ -1,5 +1,5 @@
 import type { Context } from "#compiled/@opentelemetry/api/index.js";
-import { type InstrumentationSessionStartedEvent, type InstrumentationTraceSeed, type InstrumentationTurnStartedEvent, type InstrumentationTurnTerminalEvent, type InstrumentationSessionTransitionEvent } from "#instrumentation/lifecycle.js";
+import { type InstrumentationSessionStartedEvent, type InstrumentationTraceSeed, type InstrumentationTurnStartedEvent, type InstrumentationTurnSettledEvent, type InstrumentationSessionEndedEvent } from "#instrumentation/lifecycle.js";
 import type { TraceCapturePolicy } from "#tracing/eve/otel-declaration.js";
 import type { AgentSessionTraceState, AgentTraceStateStore } from "#tracing/eve/agent-trace-state.js";
 import type { createEveCapturePolicy } from "#tracing/eve/policy.js";
@@ -23,8 +23,9 @@ interface EveSessionTracing {
     turnFor(sessionId: string, turnId: string, context?: Context): Promise<TurnOperation | undefined>;
     /** Whether the trace policy dropped this turn, so its work must not record spans. */
     dropped(sessionId: string, turnId: string): Promise<boolean>;
-    turnTerminal(event: InstrumentationTurnTerminalEvent): Promise<void>;
-    sessionTransition(event: InstrumentationSessionTransitionEvent): Promise<void>;
+    turnSettled(event: InstrumentationTurnSettledEvent): Promise<void>;
+    /** Ends a turn the session's end left open, failed when the session failed. */
+    sessionEnded(event: InstrumentationSessionEndedEvent): Promise<void>;
 }
 export declare function createEveSessionTracing(input: EveSessionTracingInput): EveSessionTracing;
 export {};

package/dist/src/tracing/eve/session.js

@@ -1 +1 @@
-import{normalizeChannelAudience}from"#shared/channel-audience.js";import{normalizeInstrumentationChannelKind}from"#internal/instrumentation.js";import{traceSessionIdOf,withOperationTraceContext}from"#tracing/eve/conversation-context.js";import{isSampledTrace,resolveTracePolicy,resolveTracePolicyDecision}from"#shared/trace-policy.js";import{ROOT_CONTEXT}from"#compiled/@opentelemetry/api/index.js";import"#instrumentation/lifecycle.js";import{readInstrumentationDecision}from"#shared/instrumentation-decision.js";import{applyPrincipalTraceDecision}from"#instrumentation/principal-summary.js";import{withChannelAudience}from"#tracing/eve/channel-audience-context.js";import{eveTurnIdentity}from"#tracing/eve/operation-input.js";import{eveActivationMetadata}from"#tracing/eve/metadata.js";function createEveSessionTracing(e){let ensureSessionContext=async t=>{let n=await e.stateStore.get(`session`,t.sessionId);if(n===void 0){let r=normalizeChannelAudience(t.channelAudience),i=resolveSessionTraceDecision(t,r,e.environment,e.tracePolicy);n={agentName:t.agentName,channelAudience:r,channelKind:t.channelKind,channelType:t.channelType,decision:i,context:initialSessionContext(e,t,i),parentLineage:t.parentLineage,rootSessionId:t.rootSessionId,traceSessionId:traceSessionIdOf(t),scheduleId:t.scheduleId,title:t.title},await e.stateStore.set(`session`,t.sessionId,n)}return n},prepareSessionTrace=async e=>{let t=await ensureSessionContext(e);return portableSpanContext(t.context,t.decision)},turnKey=(e,t)=>JSON.stringify([e,t]);async function turnFor(t,n,r){let i=await e.stateStore.get(`turn`,turnKey(t,n));if(i===void 0||!isSampledTrace(i.context))return;let a=await e.stateStore.get(`session`,t);return e.tracing.resume({identity:eveTurnIdentity({sessionId:t,rootSessionId:i.rootSessionId,turnId:n}),context:withOperationTraceContext(r??withChannelAudience(ROOT_CONTEXT,a?.channelAudience),{sessionId:t,...i})})}async function dropped(t,n){let r=await e.stateStore.get(`turn`,turnKey(t,n));return r!==void 0&&!isSampledTrace(r.context)}let prepareTurnTrace=async t=>{let n=await e.stateStore.get(`turn`,turnKey(t.sessionId,t.turnId));if(n!==void 0){let r=await e.stateStore.get(`session`,t.sessionId);return portableSpanContext(n.context,r?.decision)}let r=await ensureSessionContext(t),i=t.sequence===0,a=i?t.parentTraceContext:void 0,o=r.decision?.action===`record`,s=a!==void 0&&!(`isRemote`in a&&a.isRemote===!0),c=i?{...r.context,traceId:s?a.traceId:r.context.traceId,isRemote:!1}:{traceId:e.idGenerator.deriveTraceId(`turn:${t.idempotencyKey}`),spanId:e.idGenerator.deriveSpanId(`turn:${t.idempotencyKey}`),traceFlags:+!!o,isRemote:!1},l=r.agentName??(t.parentLineage??r.parentLineage)?.subagentName,u={agentName:l,caller:a===void 0?void 0:adoptedSpanContext(a),context:c,currentPrincipal:applyPrincipalTraceDecision(t.currentPrincipal,r.decision),initiatorPrincipal:applyPrincipalTraceDecision(t.initiatorPrincipal,r.decision),parentLineage:t.parentLineage??r.parentLineage,rootSessionId:t.rootSessionId,traceSessionId:traceSessionIdOf(t),sequence:t.sequence,startTimeMs:Date.now(),subagentName:(t.parentLineage??r.parentLineage)?.subagentName};if(isSampledTrace(c)){let n=await e.tracing.turn({...eveActivationMetadata({session:r,turn:u,sessionId:t.sessionId}),agentName:l,identity:eveTurnIdentity({...t,sessionId:t.sessionId}),framework:{name:`eve`,version:e.frameworkVersion},capture:{emit:!0,...await e.capturePolicy.forOperation(t)},reference:c,parent:s?adoptedSpanContext(a):void 0,links:activationLinks(u),startTimeMs:u.startTimeMs,context:hostContext(r.channelAudience,t)});u={...u,context:{...c,traceFlags:n.reference.traceFlags}}}return await e.stateStore.set(`turn`,turnKey(t.sessionId,t.turnId),u),portableSpanContext(u.context,r.decision)};async function recordTerminal(t,n,r,i){await e.stateStore.update(`turn`,turnKey(t,n),e=>({...e,terminal:r.outcome===`failed`?{outcome:`failed`,errorName:i instanceof Error?i.name:void 0,errorMessage:i instanceof Error?i.message:void 0}:r}))}return{ensureSessionContext,prepareSessionTrace,prepareTurnTrace,turnFor,dropped,async turnTerminal(e){await recordTerminal(e.sessionId,e.turnId,{outcome:e.type===`turn.failed`?`failed`:e.type===`turn.cancelled`?`cancelled`:`completed`},e.type===`turn.failed`?e.error:void 0)},async sessionTransition(t){if(t.turnId===void 0)return;t.type===`session.failed`&&await recordTerminal(t.sessionId,t.turnId,{outcome:`failed`},t.error);let n=await e.stateStore.get(`turn`,turnKey(t.sessionId,t.turnId));if(n===void 0)return;let r=await e.stateStore.get(`session`,t.sessionId),i=await turnFor(t.sessionId,t.turnId);if(i!==void 0){let e=eveActivationMetadata({session:r,turn:n,sessionId:t.sessionId});i.attributes(e.attributes??{}),i.links(activationLinks(n)??[]);let a=n.terminal;if(a===void 0)await i.complete({outcomeUnknown:!0});else if(a.outcome===`failed`){let e=Error(a.errorMessage);e.name=a.errorName??`Error`,await i.complete({outcome:`failed`,failed:!0,error:e,errorType:a.errorName})}else await i.complete({outcome:a.outcome})}await e.stateStore.delete(`turn`,turnKey(t.sessionId,t.turnId))}}}function hostContext(e,t){return withOperationTraceContext(withChannelAudience(ROOT_CONTEXT,e),t)}function activationLinks(e){let t=[];return e.caller?.isRemote===!0&&t.push({context:e.caller,relationship:`agent.dispatch`}),e.channelDelivery?.requestTraceContext!==void 0&&t.push({context:e.channelDelivery.requestTraceContext,relationship:`channel.request`}),t.length===0?void 0:t}function portableSpanContext(e,t){return{decision:t,spanId:e.spanId,traceFlags:e.traceFlags,traceId:e.traceId}}function adoptedSpanContext(e){return{isRemote:`isRemote`in e&&e.isRemote===!0,spanId:e.spanId,traceFlags:e.traceFlags,traceId:e.traceId}}function initialSessionContext(e,t,n){let r=t.traceSeed;if(r!==void 0)return{...adoptedSpanContext(r),traceFlags:n.action===`drop`?0:r.traceFlags};let i=`session:${t.sessionId}`,a=t.parentTraceContext;return{traceId:a!==void 0&&!(`isRemote`in a&&a.isRemote===!0)?a.traceId:e.idGenerator.deriveTraceId(i),spanId:e.idGenerator.deriveSpanId(i),traceFlags:+(n.action===`record`)}}function resolveSessionTraceDecision(e,t,n,r){let i={audience:t,environment:n};return e.parentTraceContext!==void 0&&!isSampledTrace(e.parentTraceContext)?{action:`drop`}:e.traceSeed?.decision===void 0?e.traceSeed===void 0?e.parentTraceContext===void 0?e.agentName===void 0?r===void 0?resolveTracePolicyDecision(!0,i):{action:`drop`}:resolveTracePolicy(r,{agentName:e.agentName,audience:t,channel:{kind:normalizeInstrumentationChannelKind(e.channelKind??e.channelType)},environment:n,principalType:`unknown`}):resolveTracePolicyDecision(isSampledTrace(e.parentTraceContext),i):resolveTracePolicyDecision(isSampledTrace(e.traceSeed),i):readInstrumentationDecision(e.traceSeed.decision)??{action:`drop`}}export{createEveSessionTracing};
+import{normalizeChannelAudience}from"#shared/channel-audience.js";import{normalizeInstrumentationChannelKind}from"#internal/instrumentation.js";import{contextStorage}from"#context/container.js";import{enteredView}from"#harness/session-machine/current.js";import{traceSessionIdOf,withOperationTraceContext}from"#tracing/eve/conversation-context.js";import{isSampledTrace,resolveTracePolicy,resolveTracePolicyDecision}from"#shared/trace-policy.js";import{ROOT_CONTEXT}from"#compiled/@opentelemetry/api/index.js";import"#instrumentation/lifecycle.js";import{readInstrumentationDecision}from"#shared/instrumentation-decision.js";import{applyPrincipalTraceDecision}from"#instrumentation/principal-summary.js";import{withChannelAudience}from"#tracing/eve/channel-audience-context.js";import{eveTurnIdentity}from"#tracing/eve/operation-input.js";import{eveActivationMetadata}from"#tracing/eve/metadata.js";function createEveSessionTracing(e){let ensureSessionContext=async t=>{let n=await e.stateStore.get(`session`,t.sessionId);if(n===void 0){let r=normalizeChannelAudience(t.channelAudience),i=resolveSessionTraceDecision(t,r,e.environment,e.tracePolicy);n={agentName:t.agentName,channelAudience:r,channelKind:t.channelKind,channelType:t.channelType,decision:i,context:initialSessionContext(e,t,i),parentLineage:t.parentLineage,rootSessionId:t.rootSessionId,traceSessionId:traceSessionIdOf(t),scheduleId:t.scheduleId,title:t.title},await e.stateStore.set(`session`,t.sessionId,n)}return n},prepareSessionTrace=async e=>{let t=await ensureSessionContext(e);return portableSpanContext(t.context,t.decision)},turnKey=(e,t)=>JSON.stringify([e,t]);async function turnFor(t,n,r){let i=await e.stateStore.get(`turn`,turnKey(t,n));if(i===void 0||!isSampledTrace(i.context))return;let a=await e.stateStore.get(`session`,t);return e.tracing.resume({identity:eveTurnIdentity({sessionId:t,rootSessionId:i.rootSessionId,turnId:n}),context:withOperationTraceContext(r??withChannelAudience(ROOT_CONTEXT,a?.channelAudience),{sessionId:t,...i})})}async function dropped(t,n){let r=await e.stateStore.get(`turn`,turnKey(t,n));return r!==void 0&&!isSampledTrace(r.context)}let prepareTurnTrace=async t=>{let n=await e.stateStore.get(`turn`,turnKey(t.sessionId,t.turnId));if(n!==void 0){let r=await e.stateStore.get(`session`,t.sessionId);return portableSpanContext(n.context,r?.decision)}let r=await ensureSessionContext(t),i=t.sequence===0,a=i?t.parentTraceContext:void 0,o=r.decision?.action===`record`,s=a!==void 0&&!(`isRemote`in a&&a.isRemote===!0),c=i?{...r.context,traceId:s?a.traceId:r.context.traceId,isRemote:!1}:{traceId:e.idGenerator.deriveTraceId(`turn:${t.idempotencyKey}`),spanId:e.idGenerator.deriveSpanId(`turn:${t.idempotencyKey}`),traceFlags:+!!o,isRemote:!1},l=r.agentName??(t.parentLineage??r.parentLineage)?.subagentName,u={agentName:l,caller:a===void 0?void 0:adoptedSpanContext(a),context:c,currentPrincipal:applyPrincipalTraceDecision(t.currentPrincipal,r.decision),initiatorPrincipal:applyPrincipalTraceDecision(t.initiatorPrincipal,r.decision),parentLineage:t.parentLineage??r.parentLineage,rootSessionId:t.rootSessionId,traceSessionId:traceSessionIdOf(t),sequence:t.sequence,startTimeMs:Date.now(),subagentName:(t.parentLineage??r.parentLineage)?.subagentName};if(isSampledTrace(c)){let n=await e.tracing.turn({...eveActivationMetadata({session:r,turn:u,sessionId:t.sessionId}),agentName:l,identity:eveTurnIdentity({...t,sessionId:t.sessionId}),framework:{name:`eve`,version:e.frameworkVersion},capture:{emit:!0,...await e.capturePolicy.forOperation(t)},reference:c,parent:s?adoptedSpanContext(a):void 0,links:activationLinks(u),startTimeMs:u.startTimeMs,context:hostContext(r.channelAudience,t)});u={...u,context:{...c,traceFlags:n.reference.traceFlags}}}return await e.stateStore.set(`turn`,turnKey(t.sessionId,t.turnId),u),portableSpanContext(u.context,r.decision)};async function endTurn(t,n,r){let i=await e.stateStore.get(`turn`,turnKey(t,n));if(i===void 0)return;let a=await e.stateStore.get(`session`,t),o=await turnFor(t,n);if(o!==void 0){let e=eveActivationMetadata({session:a,turn:i,sessionId:t});if(o.attributes(e.attributes??{}),o.links(activationLinks(i)??[]),r===void 0)await o.complete({outcomeUnknown:!0});else if(r.outcome===`failed`){let e=r.error;await o.complete({outcome:`failed`,failed:!0,error:e,errorType:e instanceof Error?e.name:void 0})}else await o.complete({outcome:r.outcome})}await e.stateStore.delete(`turn`,turnKey(t,n))}return{ensureSessionContext,prepareSessionTrace,prepareTurnTrace,turnFor,dropped,async turnSettled(e){let t=contextStorage.getStore(),n=t===void 0?void 0:enteredView(t);(n?.session.status!==`ended`||n.session.outcome!==`failed`||n.session.closedAt!==n.turns[e.turnId]?.closedAt)&&await endTurn(e.sessionId,e.turnId,{outcome:e.outcome,error:e.error})},async sessionEnded(e){e.turnId!==void 0&&await endTurn(e.sessionId,e.turnId,e.outcome===`failed`?{outcome:`failed`,error:e.error}:void 0)}}}function hostContext(e,t){return withOperationTraceContext(withChannelAudience(ROOT_CONTEXT,e),t)}function activationLinks(e){let t=[];return e.caller?.isRemote===!0&&t.push({context:e.caller,relationship:`agent.dispatch`}),e.channelDelivery?.requestTraceContext!==void 0&&t.push({context:e.channelDelivery.requestTraceContext,relationship:`channel.request`}),t.length===0?void 0:t}function portableSpanContext(e,t){return{decision:t,spanId:e.spanId,traceFlags:e.traceFlags,traceId:e.traceId}}function adoptedSpanContext(e){return{isRemote:`isRemote`in e&&e.isRemote===!0,spanId:e.spanId,traceFlags:e.traceFlags,traceId:e.traceId}}function initialSessionContext(e,t,n){let r=t.traceSeed;if(r!==void 0)return{...adoptedSpanContext(r),traceFlags:n.action===`drop`?0:r.traceFlags};let i=`session:${t.sessionId}`,a=t.parentTraceContext;return{traceId:a!==void 0&&!(`isRemote`in a&&a.isRemote===!0)?a.traceId:e.idGenerator.deriveTraceId(i),spanId:e.idGenerator.deriveSpanId(i),traceFlags:+(n.action===`record`)}}function resolveSessionTraceDecision(e,t,n,r){let i={audience:t,environment:n};return e.parentTraceContext!==void 0&&!isSampledTrace(e.parentTraceContext)?{action:`drop`}:e.traceSeed?.decision===void 0?e.traceSeed===void 0?e.parentTraceContext===void 0?e.agentName===void 0?r===void 0?resolveTracePolicyDecision(!0,i):{action:`drop`}:resolveTracePolicy(r,{agentName:e.agentName,audience:t,channel:{kind:normalizeInstrumentationChannelKind(e.channelKind??e.channelType)},environment:n,principalType:`unknown`}):resolveTracePolicyDecision(isSampledTrace(e.parentTraceContext),i):resolveTracePolicyDecision(isSampledTrace(e.traceSeed),i):readInstrumentationDecision(e.traceSeed.decision)??{action:`drop`}}export{createEveSessionTracing};

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

@@ -1,7 +1,4 @@
 export { useEveAgent, type PrepareSend, type UseEveAgentOptions, type UseEveAgentReturn, type UseEveAgentSnapshot, type UseEveAgentStatus, } from "#vue/use-eve-agent.js";
-export { type EveAgentReducer, type EveAgentReducerEvent, type ClientInputRespondedEvent, type ClientMessageFailedEvent, type ClientMessageSubmittedEvent, } from "#client/reducer.js";
-export { conversationReducer } from "#client/conversation-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 { defaultMessageReducer, type EveAuthorizationChallenge, type EveAuthorizationOutcome, type EveAuthorizationPart, type EveMessageData, type EveDynamicToolPart, type EveMessageInputRequest, type EveMessage, type EveMessageMetadata, type EveMessagePart, type EveMessageToolMetadata, } from "#client/message-reducer.js";
+export { signInEnding, type AskedCall, type Interaction, } from "#protocol/session-projection/reader.js";
+export type { AgentObservation, AgentObservationReason, FollowAgents, FollowedChild, ConversationAgentSession, ConversationState, } from "#client/conversation-state.js";
+export type { EveInteractionPart, EveMessage, EveMessageMetadata, EveMessagePart, EveToolPart, } from "#client/message-types.js";

package/dist/src/vue/index.js

@@ -1,40 +1,3 @@
-import { a as conversationProjection, i as openConversationInputs, n as conversationReducer, o as callStatus, r as defaultMessageReducer, t as useEveAgent } from "../chunks/use-eve-agent-DnbG9c7c.js";
+import { n as signInEnding, t as useEveAgent } from "../chunks/use-eve-agent-BbbguIdB.js";
 
-//#region src/client/tool-call-state.ts
-function toolCallState(conversation, callId, options = {}) {
-	const part = findToolPart(conversation, callId);
-	const projection = conversationProjection(conversation);
-	const call = projection.calls[callId];
-	const status = callStatus(projection, callId, options) ?? partStatus(part, options);
-	if (status === void 0) return void 0;
-	const taskCall = (call?.taskId === void 0 ? void 0 : conversation.tasks[call.taskId])?.calls[callId];
-	const output = taskCall?.output ?? part?.output;
-	const errorText = taskCall?.error?.message ?? part?.errorText ?? call?.error?.message ?? (part?.state === "output-denied" ? part.approval.reason : void 0);
-	const state = { status: respondedStatus(conversation, part, status) };
-	if (output !== void 0) state.output = output;
-	if (errorText !== void 0) state.errorText = errorText;
-	if (call?.error?.code !== void 0) state.errorCode = call.error.code;
-	return state;
-}
-function respondedStatus(conversation, part, status) {
-	if (status !== "awaiting-input" || part?.state !== "approval-requested") return status;
-	const input = conversation.inputs[part.approval.id];
-	if (input?.status !== "responded") return status;
-	return input.response?.optionId === "approve" ? "running" : "rejected";
-}
-function partStatus(part, options) {
-	if (part === void 0) return void 0;
-	switch (part.state) {
-		case "output-available": return part.partial === true ? "running" : "completed";
-		case "output-error": return "failed";
-		case "output-denied": return "rejected";
-		case "approval-requested": return "awaiting-input";
-		default: return options.streaming === false ? "interrupted" : "running";
-	}
-}
-function findToolPart(conversation, callId) {
-	for (let index = conversation.messages.length - 1; index >= 0; index -= 1) for (const part of conversation.messages[index].parts) if (part.type === "dynamic-tool" && part.toolCallId === callId) return part;
-}
-
-//#endregion
-export { conversationReducer, defaultMessageReducer, openConversationInputs, toolCallState, useEveAgent };
+export { signInEnding, useEveAgent };

package/dist/src/vue/use-eve-agent.d.ts

@@ -1,56 +1,70 @@
+import type { Delivery } from "#shared/delivery.js";
+import type { SessionStreamEvent } from "#protocol/session-event.js";
 import { type ComputedRef } from "vue";
-import type { UserContent } from "ai";
-import { type EveAgentStoreCallbacks, type EveAgentStoreSnapshot, type EveAgentStoreStatus, type PrepareSend } from "#client/eve-agent-store.js";
-import type { EveAgentReducer } from "#client/reducer.js";
+import type { MessageContent } from "#shared/message-content.js";
+import { type SessionStoreCallbacks, type SessionStoreInit, type SessionStoreSnapshot, type SessionStoreStatus, type PrepareSend } from "#client/session-store.js";
 import type { ClientSession } from "#client/session.js";
-import type { ConversationState } from "#client/conversation-state.js";
-import type { MessageStreamEvent } from "#protocol/message.js";
-import type { CancelSessionResult, ClientAuth, HeadersValue, RespondTurnOptions, SendTurnOptions, ClientSessionState } from "#client/types.js";
+import type { ClientAuth, HeadersValue, RespondTurnOptions, SendTurnOptions, ClientSessionState } from "#client/types.js";
 export type { PrepareSend };
 /**
- * Lifecycle phase of a `useEveAgent` session: `"ready"` (idle), `"resuming"`
- * (checking an attached session), `"submitted"` (request sent, awaiting first
- * event), `"streaming"` (events arriving), or `"error"`.
+ * Outstanding work this binding has observed or still owes. Failures are reported separately in
+ * `error`.
+ *
+ * - `"idle"`: no command, answer, or followed receipt is pending, and the last observed view is
+ *   idle. A turn waiting only on a person can still be open; read `activeTurn(view)`.
+ * - `"resuming"`: catching up on an attached session; submission is disabled.
+ * - `"busy"`: a send, answer, or control command is pending, a followed receipt has not settled,
+ *   or the session has running or queued work.
+ *
+ * After `followWhile` closes the stream, `status` reflects the last observed view, not the
+ * current server state.
  */
-export type UseEveAgentStatus = EveAgentStoreStatus;
+export type UseEveAgentStatus = SessionStoreStatus;
 /**
- * Point-in-time projected state for an eve agent session (`data`, `error`,
- * `events`, `session`, `status`).
+ * Point-in-time projected state for an eve agent session: the conversation (`messages`,
+ * `agents`, `view`), `error`, `events`, `session`, and `status`.
  *
  * `useEveAgent` passes this shape to callbacks such as `onFinish`, but exposes
  * the same fields as individual reactive refs on its return value.
  */
-export type UseEveAgentSnapshot<TData> = EveAgentStoreSnapshot<TData>;
+export type UseEveAgentSnapshot = SessionStoreSnapshot;
 /**
  * Reactive return value from `useEveAgent`.
  */
-export interface UseEveAgentReturn<TData> {
-    /** Request durable cancellation of the active turn while continuing to receive its events. */
-    readonly cancel: () => Promise<CancelSessionResult>;
-    /** Projected state: the reducer folds every stream event into this value. */
-    readonly data: ComputedRef<TData>;
-    /** Canonical session state, regardless of the chosen data reducer. */
-    readonly conversation: ComputedRef<ConversationState>;
+export interface UseEveAgentReturn {
+    /**
+     * Request durable cancellation of the active turn while continuing to receive its events.
+     * Offer it while `activeTurn(view)` returns a turn, including one waiting on a person.
+     */
+    readonly cancel: () => Promise<Delivery>;
+    /** Rendered messages, local answers, native lifecycle tables, and followed agents. */
+    readonly messages: ComputedRef<SessionStoreSnapshot["messages"]>;
+    readonly agents: ComputedRef<SessionStoreSnapshot["agents"]>;
     /** Last transport-level error, or `undefined` when healthy. */
     readonly error: ComputedRef<Error | undefined>;
+    readonly view: ComputedRef<SessionStoreSnapshot["view"]>;
     /** Raw server events from this session (authoritative stream). */
-    readonly events: ComputedRef<readonly MessageStreamEvent[]>;
-    /** Replay the attached durable session and follow its in-flight turn, if any. */
+    readonly events: ComputedRef<readonly SessionStreamEvent[]>;
+    /** Follow a same-session delivery receipt until settlement. */
+    readonly follow: (receipt: Pick<Delivery, "sessionId" | "deliveryId">) => void;
+    /** Resolves at the durable tail; subsequent following obeys `followWhile`. */
     readonly resume: () => Promise<void>;
     /** Create the session without starting its first turn. */
     readonly prewarm: () => Promise<void>;
     /** Clear all state and start a new session. */
-    readonly reset: () => void;
-    /** Send a message with optional turn settings. */
-    readonly send: <TOutput = unknown>(message: string | UserContent, options?: SendTurnOptions<TOutput>) => Promise<void>;
-    /** Answer pending HITL input requests. */
-    readonly respond: <TOutput = unknown>(inputResponses: Parameters<ClientSession["respond"]>[0], options?: RespondTurnOptions<TOutput>) => Promise<void>;
+    readonly newSession: () => void;
+    readonly reset: () => Promise<Delivery>;
+    readonly clear: () => Promise<Delivery>;
+    readonly compact: () => Promise<Delivery>;
+    /** Submits a message and resolves on acceptance, not execution. */
+    readonly send: <TOutput = unknown>(message: MessageContent, options?: SendTurnOptions<TOutput>) => Promise<Delivery<TOutput>>;
+    /** Submits answers and resolves on acceptance, not execution. */
+    readonly respond: <TOutput = unknown>(answers: Parameters<ClientSession["respond"]>[0], options?: RespondTurnOptions<TOutput>) => Promise<Delivery<TOutput>>;
     /** Current session identity and stream cursor. */
     readonly session: ComputedRef<ClientSessionState | undefined>;
     /**
-     * Lifecycle phase: `"ready"` (idle), `"resuming"` (checking an attached
-     * session), `"submitted"` (request sent, awaiting first event), `"streaming"`
-     * (events arriving), or `"error"`.
+     * Outstanding work: `"idle"`, `"resuming"` (catching up on an attached session), or `"busy"`.
+     * Read `activeTurn(view)` for turn openness. Failures are reported separately in `error`.
      */
     readonly status: ComputedRef<UseEveAgentStatus>;
 }
@@ -58,20 +72,20 @@ export interface UseEveAgentReturn<TData> {
  * Configuration for creating or binding a Vue eve agent session.
  *
  * Session configuration is read once when the composable creates its internal
- * store; to change the host, reducer, or session, remount the component. For
+ * store; to change the base URL or session, remount the component. For
  * credentials or headers that must change without remounting, pass function
  * values to `auth` or `headers`; the client resolves those before each request.
  *
  * Lifecycle callbacks (`onError`, `onEvent`, `onFinish`, `onSessionChange`,
- * `prepareSend`) are inherited from {@link EveAgentStoreCallbacks} and synced on
+ * `prepareSend`) are inherited from {@link SessionStoreCallbacks} and synced on
  * every render.
  */
-export interface UseEveAgentOptions<TData> extends EveAgentStoreCallbacks<TData> {
+export interface UseEveAgentOptions extends SessionStoreCallbacks {
     /**
      * Named agent mounted by a framework integration such as `withEve({ agents })`.
      *
      * `agent: "support"` targets same-origin routes under
-     * `/eve/support/v1/...`. Do not combine with `host`.
+     * `/eve/support/v1/...`. Do not combine with `baseUrl`.
      */
     readonly agent?: string;
     /** Authentication configuration; a function value is resolved per request. */
@@ -87,47 +101,44 @@ export interface UseEveAgentOptions<TData> extends EveAgentStoreCallbacks<TData>
      *
      * @default ""
      */
-    readonly host?: string;
+    readonly baseUrl?: string;
     /** Ordered prefix of the session stream used to rehydrate projected state. */
-    readonly initialEvents?: readonly MessageStreamEvent[];
+    readonly initialEvents?: readonly SessionStreamEvent[];
     /** Prior session cursor to resume from on mount. */
     readonly initialSession?: ClientSessionState;
     /**
      * Project submitted user messages before eve confirms them with a
-     * `message.received` stream event.
+     * `delivery.consumed` fact.
      *
-     * Optimistic events are reducer-facing projection events only. They are not
-     * exposed through `events`, which remains the authoritative eve stream.
+     * Such a message shows in `messages` only; `events` remains the
+     * authoritative eve stream.
      *
      * @default true
      */
     readonly optimistic?: boolean;
-    /** Follow each subagent call's session into `conversation.agents` while mounted. @default false */
-    readonly followSubagents?: boolean;
-    /**
-     * Keep the session stream open between turns to show events that arrive from schedules,
-     * channels, or other clients. Set to false to close it once the session is idle and reopen it
-     * on the next send, answer, or resume. @default true
-     */
-    readonly followIdle?: boolean;
-    /** Create a session or prepare its existing idle owner on mount and after reset. @default false */
+    /** Recursively observe recorded children, or select relationships with a predicate, within store safety limits. @default false */
+    readonly followAgents?: SessionStoreInit["followAgents"];
+    /** Keep following while the committed view matches; local obligations take priority. @default () => true */
+    readonly followWhile?: (view: SessionStoreSnapshot["view"]) => boolean;
+    /** Create a session or prepare its existing idle owner on mount and after `newSession()`. @default false */
     readonly prewarm?: boolean;
-    /**
-     * Projects stream events into `TData`.
-     *
-     * @default conversationReducer
-     */
-    readonly reducer?: EveAgentReducer<TData>;
     /** Replay the attached durable session after mount. Requires `initialSession` or `session`. */
     readonly resume?: boolean;
     /**
      * Externally owned {@link ClientSession} to bind instead of creating one.
      *
-     * When set, `reset()` reuses this session rather than constructing a new one.
+     * When set, `newSession()` reuses this session rather than constructing a new one.
      */
     readonly session?: ClientSession;
 }
-export declare function useEveAgent(options?: UseEveAgentOptions<ConversationState>): UseEveAgentReturn<ConversationState>;
-export declare function useEveAgent<TData>(options: UseEveAgentOptions<TData> & {
-    readonly reducer: EveAgentReducer<TData>;
-}): UseEveAgentReturn<TData>;
+/**
+ * Vue composable that drives one eve session and projects its event stream into
+ * reactive UI state.
+ *
+ * Returns reactive refs for the conversation (`messages`, `agents`, `view`) and for `error`,
+ * `events`, `session`, and `status`, plus `prewarm`, `send`, `respond`, `resume`, `cancel`,
+ * `newSession`, and `reset`. Configuration is read once on store creation;
+ * remount to change it. On scope dispose, the in-flight request is detached and
+ * the store unsubscribed.
+ */
+export declare function useEveAgent(options?: UseEveAgentOptions): UseEveAgentReturn;

package/dist/src/vue/use-eve-agent.js

@@ -1,3 +1,3 @@
-import { t as useEveAgent } from "../chunks/use-eve-agent-DnbG9c7c.js";
+import { t as useEveAgent } from "../chunks/use-eve-agent-BbbguIdB.js";
 
 export { useEveAgent };

package/docs/agent-config.md

@@ -150,53 +150,40 @@ provider model when you deploy.
 To select a model from the incoming prompt with an AI SDK decision model, use
 [`auto` from `eve/models`](./guides/decide).
 
-`model` also accepts `defineDynamic({ events })`. Each matching handler must
-return the concrete model for its scope; a dynamic model has no compiled
-default.
+`model` also accepts `defineDynamic(fn)` from `eve/models` or `eve`. The function returns the
+model; a dynamic model has no compiled default.
 
 ```ts title="agent/agent.ts"
-import { defineAgent, defineDynamic } from "eve";
+import { defineAgent } from "eve";
+import { defineDynamic } from "eve/models";
 
 export default defineAgent({
-  model: defineDynamic({
-    events: {
-      "session.started": (_event, ctx) => {
-        if (ctx.session.auth.initiator?.attributes.plan === "enterprise") {
-          return "anthropic/claude-opus-5.5";
-        }
-
-        return "anthropic/claude-sonnet-5";
-      },
-    },
-  }),
+  model: defineDynamic((ctx) =>
+    ctx.session.auth.initiator?.attributes.plan === "enterprise"
+      ? "anthropic/claude-opus-5.5"
+      : "anthropic/claude-sonnet-5",
+  ),
 });
 ```
 
-Handlers receive the shared [dynamic resolver
-context](./guides/dynamic-capabilities) and return a gateway model id, an AI
-SDK `LanguageModel`, or a selection object. Returning `null` or `undefined`
-fails the turn.
-
-- **Scopes.** `session.started` (once per session), `turn.started` (once per
-  turn), `step.started` (every model step). Precedence: step > turn >
-  session. Prefer `session.started`: prompt caches are per model, so every
-  switch re-ingests the conversation at uncached prices. If no active
-  selection exists before model-dependent work begins, the turn fails.
-- **Failures stop the turn.** A resolver that throws, returns no model, or
-  returns an invalid selection fails before the provider call. A selected
-  model without valid credentials fails at request time.
-- **Serialization.** Session/turn selections must be model id strings; return
-  live `LanguageModel` objects only from `step.started`.
+The function returns a Gateway model ID, an AI SDK `LanguageModel`, or a selection object. See
+[Dynamic capabilities](./guides/dynamic-capabilities) for the context and memo rules.
+
+- **When it changes.** eve evaluates before each ordinary model call. A memo keyed by
+  `ctx.turn?.id ?? null` keeps a choice for the turn; `ctx.session.id` keeps it until a deployment
+  change. Switching models can reduce prompt-cache reuse.
+- **Failures stop the turn.** A thrown error or invalid selection fails the turn before the
+  provider call. `null` is not a model. Missing credentials fail at request time.
+- **Serialization.** Only memo results must be JSON. The function can return a live provider
+  instance built from those results. `ctx.model` is unavailable during model selection.
 - **Selection object.** `{ model, reasoning?, modelContextWindowTokens?, modelOptions? }`.
-  When `modelContextWindowTokens` is omitted, eve resolves it from the AI
-  Gateway catalog and caches successful metadata in durable session state for
-  24 hours. Set it explicitly for an unlisted or custom model. Dynamic agents
-  cannot set sibling `modelContextWindowTokens` or `modelOptions` fields;
-  return per-model values from the handler.
+  When `modelContextWindowTokens` is omitted, eve resolves it from the AI Gateway catalog and caches
+  successful metadata in durable session state for 24 hours. Set it explicitly for an unlisted or
+  custom model. Dynamic agents cannot set sibling `modelContextWindowTokens` or `modelOptions`
+  fields; return per-model values from the function.
 
-The `session.started` runtime identity does not include a model id for a
-dynamic agent. Each public `step.started` event reports the concrete `modelId`
-selected for that model call.
+The `session.started` runtime identity does not include a model ID for a dynamic agent. Each public
+`model.started` event reports the concrete model selected for that model call.
 
 ## Reasoning effort
 
@@ -286,7 +273,7 @@ turns that answer a message, clear or compact the context, or end in
 cancellation. A session never expires while a turn is open, including a turn
 held open while its [tasks](./tools/tasks) work or while it waits for a person
 to answer; the window restarts when that turn settles. Process restarts do not
-change the window. When the window elapses, eve emits `session.completed` and
+change the window. When the window elapses, eve emits `session.ended` with `outcome: "completed"` and
 releases every continuation address; the next qualifying channel message starts
 fresh. To carry an earlier conversation into the fresh session, pass it as
 [prior history](./channels/eve#start-from-prior-history). Set it to `false` to
@@ -303,6 +290,13 @@ provider replays from its prompt cache on every step. `costUsd` is the model
 token cost in US dollars that AI Gateway reports with each step, not tool or
 infrastructure spend; it is unset when no step reported a cost.
 
+A window starts when the session's own budget prompt is accepted: `window` is
+`total` minus the session's
+[total](./concepts/sessions-runs-and-streaming#replies-and-narration) at that point. Before
+the first approval, `window` equals `total`. Accepting a budget prompt that a
+subagent relayed starts the subagent's window, not the parent's. The window
+stays the same across deployment handoffs and replays.
+
 When `sessionUsage` is omitted, the limit is `40_000_000` new input tokens per
 window:
 
@@ -334,18 +328,18 @@ Set `sessionUsage: () => false` to leave sessions uncapped; `sessionUsage:
 false` is not accepted. eve calls `sessionUsage` before each model call once
 the window has usage. The model call that crosses a limit is allowed to finish
 because exact usage arrives after the call completes. Before the next model
-call, eve pauses the turn (`turn.waiting`) and sends a deterministic
+call, eve pauses the turn (`turn.paused`) and sends a deterministic
 continuation prompt with two options: **Continue** starts a new window and
 resumes the same turn, and **Stop** cancels the in-flight turn through the
-standard cancellation path (`turn.cancelled` → `session.waiting`). Stop is a
+standard cancellation path (`turn.settled` with `outcome: "cancelled"`). Stop is a
 user decision, not an error. The session stays resumable; because it is still
 over budget after Stop, the next message raises a new prompt. Declining a
 delegated child's prompt cancels the root turn, which cascades to the whole
 delegation tree, so the delegating parent never receives an error result it
 could retry. A reply that answers neither option is queued while the existing
 prompt stays pending; eve does not raise another
-copy or start another turn. The reply is received (`message.received`) and
-processed in the held turn once the budget is granted.
+copy or start another turn. The reply waits unconsumed, and the held turn consumes it
+(`delivery.consumed`) once the budget is granted.
 
 For sessions already waiting on a continuation prompt from an older deployment,
 the previous turn has completed. A non-answer message still queues behind the
@@ -376,7 +370,9 @@ Some delegated usage doesn't count against the parent: a `ctx.agent` turn
 still running when its workflow tool finishes or is cancelled; the `ctx.agent`
 usage of an `execute` tool whose parent turn is cancelled while it waits; and
 what a cancelled agent task's own subagents spend after the task reports its
-cancelled turn, until the task's next reply.
+cancelled turn. A cancelled agent task ends and sends no further reply. Usage
+reported by the cancelled run up to that point still counts against the parent
+when its usage report or final outcome arrives.
 
 ## Workflow world
 

package/docs/channels/chat-sdk.mdx

@@ -51,7 +51,7 @@ bot.onSubscribedMessage(async (thread: Thread, message: Message) => {
 export default channel;
 ```
 
-`adapters` is a map of adapter name to adapter instance; each entry mounts its own webhook (see below). `state` takes any Chat SDK state adapter: `createMemoryState()` is fine for local development, but use a durable adapter (Redis, Upstash, etc.) in production so thread subscriptions and inbound deduplication survive restarts. `send` accepts a plain string or an AI SDK `UserContent` array, and must be called from inside a Chat SDK handler — it dispatches the turn on the webhook that is currently running.
+`adapters` is a map of adapter name to adapter instance; each entry mounts its own webhook (see below). `state` takes any Chat SDK state adapter: `createMemoryState()` is fine for local development, but use a durable adapter (Redis, Upstash, etc.) in production so thread subscriptions and inbound deduplication survive restarts. `send` accepts a plain string or an array of message parts, and must be called from inside a Chat SDK handler — it dispatches the turn on the webhook that is currently running.
 
 Pass `idempotencyKey: message.id` to `send` to prevent duplicate agent input
 within the session's [recent-key window](./custom#retried-deliveries). Chat SDK's
@@ -111,14 +111,14 @@ bot.onNewMention(async (thread, message) => {
 
 `options` accepts `thread` and `adapterName`, plus the channel send options `auth`, `context`, `outputSchema`, `title`, `callback`, `turnPolicy`, and `idempotencyKey`. `title` sets the eve session's display title without changing the model message; `auth` attaches an authenticated principal to the turn. `auth` defaults to `null`.
 
-To answer pending input requests from a handler you render yourself, call `respond(inputResponses, { thread, auth?, context? })`. Like a channel's `respond()`, it never creates a session. This example answers a custom button whose `value` carries the eve request id:
+To answer pending input requests from a handler you render yourself, call `respond(answers, { thread, auth?, context? })`. Like a channel's `respond()`, it never creates a session. This example answers a custom button whose `value` carries the interaction id:
 
 ```ts
 export const { bot, channel, send, respond } = chatSdkChannel({/* ... */});
 
 bot.onAction("approve_deploy", async (event) => {
   if (!event.thread || !event.value) return;
-  await respond([{ requestId: event.value, optionId: "approve" }], { thread: event.thread });
+  await respond([{ interactionId: event.value, optionId: "approve" }], { thread: event.thread });
 });
 ```
 
@@ -145,7 +145,11 @@ This policy controls overlapping eve turns. Chat SDK's separate `concurrency` op
 
 The default handlers post the agent's reply back to the thread — no `events` override required. Completed assistant messages are posted as markdown (`{ markdown: … }`) so adapters render rich text and email HTML rather than a raw string.
 
-Streaming is on by default: the channel posts an initial message and edits it as tokens arrive (`message.appended`), throttled by `streamingEditIntervalMs` (default `1000`). Set `streaming: false` for surfaces that deliver one message per turn or can't edit sent messages — email and WhatsApp, for example — so the reply posts once on completion instead of editing:
+Streaming is on by default: the channel posts an initial message and edits it as text arrives (`content.delta`), throttled by `streamingEditIntervalMs` (default `1000`). On completion it edits the message once more to show the full text, skipping that edit when the message already shows it.
+
+The streamed message is the reply, so the channel never posts the reply a second time. When the final reply edit fails, it logs the error, posts a short notice with the error id, and tells the model on the next message that the user hasn't seen its reply.
+
+Set `streaming: false` for surfaces that deliver one message per turn or can't edit sent messages — email and WhatsApp, for example — so the reply posts once on completion instead of editing:
 
 ```ts
 chatSdkChannel({
@@ -156,17 +160,17 @@ chatSdkChannel({
 });
 ```
 
-Typing indicators post automatically where the adapter supports them: `Working…` on `turn.started`, and on `actions.requested`, each call's [label](/docs/tools#label-tool-activity) or a readable form of its name. They leave out the model's own `eve__task_wait` and `eve__task_cancel` calls.
+Typing indicators post automatically where the adapter supports them: `Working…` on `turn.started`, and on `call.requested`, each call's [label](/docs/tools#label-tool-activity) or a readable form of its name. They leave out the model's own `eve__task_wait` and `eve__task_cancel` calls.
 
 ### Optional capabilities degrade gracefully
 
-Adapters do not all implement every operation. When an adapter's `startTyping` or `editMessage` throws a `NotImplementedError` (or an error with code `NOT_IMPLEMENTED`), the channel swallows it: typing indicators are skipped, and a streaming edit falls back to a single final post for the rest of the session. You never have to guard optional capabilities in your own handlers. The same predicate is exported as `isNotImplemented` if you want it in custom `events`:
+Adapters do not all implement every operation. When an adapter's `startTyping` throws a `NotImplementedError` (or an error with code `NOT_IMPLEMENTED`), typing indicators are skipped. An unsupported `editMessage` disables streaming edits for the rest of the session, so later replies post once on completion. If a reply already has a streamed message, eve still attempts the final edit and reports a failure as described above; it never posts the reply again beside that message. The same predicate is exported as `isNotImplemented` if you want it in custom `events`:
 
 ```ts
 import { isNotImplemented } from "eve/channels/chat-sdk";
 ```
 
-Override any default by passing `events`. Handlers receive `(eventData, channel, ctx)`, with the rebuilt Chat SDK thread on `channel.thread`:
+Override any default by passing `events`. Handlers receive `(event, ctx)`, with the rebuilt Chat SDK thread on `ctx.channel.thread`:
 
 ```ts
 chatSdkChannel({
@@ -174,9 +178,11 @@ chatSdkChannel({
   adapters: { resend: createResendAdapter({ fromAddress: "hello@example.com" }) },
   state: createMemoryState(),
   events: {
-    "message.completed"(eventData, channel) {
-      if (eventData.finishReason === "tool-calls" || !eventData.message || !channel.thread) return;
-      return channel.thread.post({ markdown: eventData.message });
+    "content.completed"(event, ctx) {
+      const { kind, phase, value } = event.data;
+      if (kind !== "text" || phase !== "reply" || typeof value !== "string" || !ctx.channel.thread)
+        return;
+      return ctx.channel.thread.post({ markdown: value });
     },
   },
 });
@@ -240,13 +246,13 @@ await to(channel, { adapterName: "resend", threadId: "resend:user@example.com" }
 
 ### Attachments
 
-`send` takes plain text or an AI SDK `UserContent` array. To forward a Chat SDK message's attachments, convert it with `messageToUserContent`. It returns `message.text` when there are no attachments, and a `UserContent` array (the text plus one part per attachment) when there are:
+`send` takes plain text or an array of message parts. To forward a Chat SDK message's attachments, convert it with `messageContentOf`. It returns `message.text` when there are no attachments, and message parts (the text plus one part per attachment) when there are:
 
 ```ts
-import { messageToUserContent } from "eve/channels/chat-sdk";
+import { messageContentOf } from "eve/channels/chat-sdk";
 
 bot.onNewMention(async (thread, message) => {
-  await send(messageToUserContent(message), { thread });
+  await send(messageContentOf(message), { thread });
 });
 ```