eve 0.55.0 → 0.57.0

package/CHANGELOG.md

@@ -1,5 +1,63 @@
 # eve
 
+## 0.57.0
+
+### Minor Changes
+
+- 61d4097: Run every conversational turn directly inside the session's owning workflow instead of dispatching a child turn run per message. An idle session hands its settled state to the exact deployment that accepted a new delivery, whether the delivery arrives through the session ID or any channel continuation address, keeping the original session ID and event stream and renewing the session's configured timeout. Deliveries that land while a handoff is in progress wait for the successor instead of starting a replacement session.
+  
+  Steering a running turn applies at the next committed step boundary without cancelling in-flight model or tool work and preserves the turn's identity and usage; input that arrives after the model has answered starts the next turn. `continuation.rekey()` is replaced by `continuation.alias()`: every claimed address stays active, and the most recently selected alias is exposed as `continuation.token`.
+  
+  Sessions from the former driver/turn execution model are imported on their next turn, preserving identity, history, and the original stream while interrupting pending work; drivers started before eve 0.45 are reported inactive and their channel starts a fresh session. Retain the original deployment until imported sessions end, and retire sessions before rolling back across this boundary.
+
+### Patch Changes
+
+- 32aca9b: Restored `agent` tools now dispatch through the shared subagent workflow when framework defaults are disabled.
+- 7b17b27: Simplify the TUI footer by removing the local port and separating the model and connection with dots. Vercel account connections show the resolved team slug instead of a team ID.
+- f21e63f: Declare `.vercel/output` for generated eve services so Vercel consumes the Build Output API directory that their build commands produce instead of looking for the framework preset's `.output` default.
+- 7b17b27: Model login shares resolved credentials with the running agent, avoids rebuilds for account, team, and key changes, and refreshes agent information without delaying chat. Clear status messages show when to finish browser sign-in and what eve is waiting for, without flashing indicators for quick steps.
+- e1ae8eb: Flush the final activity snapshot when an activity stream closes during the render debounce window.
+- f21e63f: Make `withEve` discover a containing workspace when Vercel evaluates `vercel.ts` from its temporary `.vercel` directory.
+- fe6451c: Keep automatic prompt caching enabled when local model authentication resolves an AI Gateway model to a provider object. Anthropic models retain cache reuse after signing in through `eve dev`.
+- 032860c: Bound negotiated session stream responses with renewable leases so abandoned serverless invocations release their durable stream readers. The eve client renews these responses from its cursor without exposing transport heartbeats or lease records as session events; tail-relative reads and streams with reconnection disabled remain unleased.
+- 7b17b27: Fix a local workflow health-check failure after model or source changes. Capability probes no longer look up a run before it exists, avoiding a spurious queue error and startup delay.
+- 7b17b27: Allow switching Vercel teams through `/login` by always showing the team picker when multiple teams are available. The current team is highlighted rather than silently selected; automatic startup still reuses the saved connection.
+- 7b17b27: Match the Vercel label's color to the surrounding model and team text in the TUI footer.
+- ba0b866: When a self-modified tool or capability later fails or behaves incorrectly, the agent now offers to delegate a repair. It waits for your confirmation before sending the observed and expected behavior back to self-modification.
+- 7b17b27: Use the same full-size arrow for empty and populated TUI prompts, with the empty arrow in the terminal's default foreground color for better visibility.
+- 7b17b27: Open the TUI directly after init, connect models through `/login` without requiring a Vercel project, and store local credentials securely. Add direct OpenAI and Anthropic model helpers, apply model selections immediately, and simplify menus and `/add` to get to chat sooner. Vercel CLI installation and login now run during deployment instead of separate `/vc:install` and `/vc:login` commands.
+- 8bb62e2: Recognize AI Gateway credit-balance and project-budget refusals in semantic error summaries.
+- 7b17b27: Restore guided Trusted Sources setup when Deployment Protection blocks `eve dev --url`. eve reuses the existing Vercel CLI session, asks before changing project access, and verifies the connection before returning to chat.
+- 7b17b27: Use the base release version for default sandbox images when running commit or git-ref tarballs. Build metadata such as `+git.<sha>` no longer produces invalid image tags for Docker, microsandbox, or Vercel Sandbox.
+- 7b17b27: Search `/add` by capabilities such as iMessage or SMS, as well as item names and addresses. The picker now searches catalog titles and descriptions without adding extra text to menu rows.
+- a08e4bb: Prompt for and resolve the target Vercel project before configuring production self-modification, and scope GitHub connector creation and attachment to that project's owner.
+- 7b17b27: Keep the composer available while startup connects your model and prepares chat, with animated progress and prompts only when input is needed. Preserve drafts and queued messages through setup, and announce readiness only after the runtime refresh succeeds.
+- 61d4097: Batch closely spaced stream events on Vercel within a 10 ms window to reduce network writes. Explicit Workflow stream-flush overrides remain supported.
+- 53fad6c: Emits canonical GenAI cache-write tokens, reports the provider-confirmed response model, and adds the executing agent name to tool spans.
+- 7b17b27: Replace rotating TUI prompt suggestions with a stable “Send a message…” placeholder that does not assume agent capabilities.
+- fe6451c: Apply steering in the core runtime before a pending model request produces an answer, continuing the same turn with the correction across clients and channels. Preserve executing tools and their results, prevent duplicate in-process model execution on background wakeups, and keep boundary steering after assistant output begins.
+- 7b17b27: Pressing Enter during a TUI response now steers the active agent immediately instead of queuing the message until the turn finishes. Startup messages and sessions without steering support continue to queue.
+- 7b17b27: Distinguish steered TUI messages with a yellow left gutter instead of an extra arrow row. Queued messages also render without an arrow row.
+- 1e6437b: Announce when dynamic skills are withdrawn completely so agents do not retain stale skill lists.
+
+## 0.56.0
+
+### Minor Changes
+
+- 8bc931f: Add the `workflow` factory from `eve/tools/workflow` for running model-supplied JavaScript through durable `ctx.agent` calls. Remove the experimental uppercase `Workflow` tool and `experimental_workflow`; migrate its tool file to the new lowercase factory.
+- 6ce61cd: Remove aggregate registry packages and their component-selection flow. Install Linear integrations separately with `eve add channel/linear` and `eve add connection/linear`.
+
+### Patch Changes
+
+- 57d6be5: Add queryable metadata to activation spans, including run type, title when input capture permits, provenance, audience, schedule, and directional trace-content policy.
+- a63fb18: Keep background subagents bound to the authentication context of the turn that created their task, even when another caller starts a later turn first.
+- 51998ab: Automatically ignore the self-modification integration's known optional compression packages instead of prompting for its recommended pnpm build policy.
+- 56cde32: Include conversations classified as private in local `eve dev` traces, including sessions authenticated with the developer's Vercel OIDC token.
+- 7ea3b7a: Classify anonymous eve channel sessions as `unknown` by default, so their content is not recorded in preview or production traces unless you mark the audience public explicitly. Also add `credentialOwner` for raw getToken-only auth and `caller` for audience callbacks while preserving existing `principalType` APIs, and fix token cache keys so user identifiers containing separators or percent sequences cannot collide.
+- 23e2e7c: Allow submitting the initial TUI message while eve is still building the agent. The message is queued and sent automatically as soon as the agent is ready.
+- bca1b4a: Self-modification registry setup now asks whether to enable deployed draft pull requests or keep source editing local before collecting deployment configuration.
+- a7f2387: Improve development TUI Markdown with clearer headings, block spacing, clickable links, responsive bordered tables, and code panels. Set `EVE_TUI_RENDER_MARKDOWN=0` to show assistant and subagent responses without Markdown parsing or styling.
+
 ## 0.55.0
 
 ### Minor Changes

package/dist/src/channel/adapter-context.d.ts

@@ -6,6 +6,6 @@ import type { ChannelAdapter, ChannelAdapterContext } from "#channel/adapter.js"
  *
  * Populates `session` with a live {@link SessionHandle} backed by the
  * supplied accessor so handlers can read identity / auth and call
- * `session.continuation.rekey(...)` to re-key the parked session.
+ * `session.continuation.alias(...)` to add an address for the parked session.
  */
 export declare function buildAdapterContext<TCtx extends ChannelAdapterContext<any> = ChannelAdapterContext>(adapter: ChannelAdapter<TCtx>, accessor: ContextAccessor): TCtx;

package/dist/src/channel/adapter.d.ts

@@ -15,8 +15,8 @@ import type { ChannelAudienceProjector } from "#channel/audience.js";
  * {@link ContextAccessor} that tools and providers use).
  *
  * `session` is a live handle to the current session — id, auth,
- * optional channel continuation address, including an imperative `rekey()`
- * for channels that need to re-key the session mid-turn (e.g. Slack's
+ * optional channel continuation address, including an imperative `alias()`
+ * for channels that need to add an alias for the session mid-turn (e.g. Slack's
  * auto-anchor on first post).
  */
 export interface ChannelAdapterContext<TState = Record<string, unknown>> {

package/dist/src/channel/audience.d.ts

@@ -1,5 +1,5 @@
 import type { ChannelAudience } from "#shared/channel-audience.js";
-import type { AudienceInput } from "#shared/conversation-context.js";
+import type { AudienceContext } from "#shared/conversation-context.js";
 type ChannelAudienceSource = {
     readonly kind: string;
     readonly state?: Record<string, unknown> | undefined;
@@ -8,8 +8,8 @@ type ChannelAudienceSource = {
         readonly metadata?: (state: Record<string, unknown> | undefined) => unknown;
     };
 };
-export type ChannelAudienceProjector = (input: AudienceInput<Record<string, unknown> | undefined>) => ChannelAudience;
-export declare function resolveAudience(adapter: ChannelAudienceSource, input: AudienceInput<Record<string, unknown> | undefined>): ChannelAudience;
+export type ChannelAudienceProjector = (input: AudienceContext<Record<string, unknown> | undefined>) => ChannelAudience;
+export declare function resolveAudience(adapter: ChannelAudienceSource, input: AudienceContext<Record<string, unknown> | undefined>): ChannelAudience;
 export declare function createMetadataAudienceProjector(source: {
     readonly kind: string;
 }, metadata: (state: Record<string, unknown> | undefined) => unknown): ChannelAudienceProjector;

package/dist/src/channel/channel-address.js

@@ -1 +1 @@
-import{createSession,sessionCallbackToTurnCaller}from"#channel/session.js";import{copyChannelActivityPresentation}from"#channel/activity-renderer.js";import{createChannelDeliveryMetadata}from"#channel/delivery-metadata.js";import{normalizeSendInput,serializeUrlFilePartsInMessage}from"#channel/send-input.js";import{DEFAULT_TURN_POLICY}from"#channel/types.js";import{isReservedSessionCommandToken}from"#execution/session-command-token.js";function createChannelAddress(e){let t=e.metadata??{},n=`${e.channelName}:${e.continuationToken}`;if(isReservedSessionCommandToken(n))throw Error(`Channel address "${n}" uses eve's reserved session namespace.`);return{continuationToken:e.continuationToken,async deliver(r,i){let a=t.channelKind!==void 0&&t.channelName!==void 0?createChannelDeliveryMetadata(t):void 0,o=normalizeSendInput(r),s=sessionCallbackToTurnCaller(i.callback),c={auth:i.auth,delivery:a,kind:`send`,payload:{...o,message:serializeUrlFilePartsInMessage(o.message)},requestId:t.requestId,turnPolicy:o.message===void 0?void 0:i.turnPolicy??e.turnPolicy??DEFAULT_TURN_POLICY},l=s===void 0?c:{...c,caller:s},u=await(async()=>{let r=await e.runtime.dispatchContinuation({command:l,continuationToken:n});return r.status===`accepted`?createSession(r.sessionId,e.runtime,{...t,turnPolicy:e.turnPolicy}):void 0})();if(u!==void 0)return u;if(o.inputResponses&&o.inputResponses.length>0)throw Error(`Cannot deliver inputResponses — the target session was not found via continuation token.`);let d=i.state,f=d===void 0?e.adapter:{...e.adapter,state:{...e.adapter.state,...d}};f!==e.adapter&&copyChannelActivityPresentation(e.adapter,f);let p=i.mode===`task`?void 0:{requestInput:!0},m={adapter:f,auth:i.auth,capabilities:p,callback:i.callback,channelName:e.channelName,continuationConflictCommand:l,continuationToken:n,delivery:a,initiatorAuth:i.initiatorAuth,input:{context:o.context,message:serializeUrlFilePartsInMessage(o.message)??``,outputSchema:o.outputSchema},mode:i.mode??`conversation`,requestId:t.requestId,title:i.title},h=await e.runtime.createSession(m);return createSession(h.sessionId,e.runtime,{...t,turnPolicy:e.turnPolicy})},async send(e,t){return await this.deliver({message:e},t)},async respond(e,t){if(e===void 0||e.length===0)throw Error(`respond() requires at least one input response.`);return await this.deliver({inputResponses:e},t)},async cancel(t){return await e.runtime.dispatchContinuation({command:{kind:`cancel`,turnId:t?.turnId},continuationToken:n})},async compact(){return await e.runtime.dispatchContinuation({command:{kind:`compact`},continuationToken:n})},async clear(){return await e.runtime.dispatchContinuation({command:{kind:`clear`},continuationToken:n})},async reset(t){return await e.runtime.dispatchContinuation({command:{kind:`reset`,reason:t?.reason},continuationToken:n})},async resolveSession(){let r=await e.runtime.resolveContinuation(n);return r===void 0?void 0:createSession(r.sessionId,e.runtime,{...t,turnPolicy:e.turnPolicy})}}}function createChannelAddressFn(e){return t=>createChannelAddress({...e,continuationToken:t})}export{createChannelAddress,createChannelAddressFn};
+import{createSession,sessionCallbackToTurnCaller}from"#channel/session.js";import{copyChannelActivityPresentation}from"#channel/activity-renderer.js";import{createChannelDeliveryMetadata}from"#channel/delivery-metadata.js";import{normalizeSendInput,serializeUrlFilePartsInMessage}from"#channel/send-input.js";import{DEFAULT_TURN_POLICY}from"#channel/types.js";import{isReservedSessionCommandToken}from"#execution/session-inbox/address.js";function createChannelAddress(e){let t=e.metadata??{},n=`${e.channelName}:${e.continuationToken}`;if(isReservedSessionCommandToken(n))throw Error(`Channel address "${n}" uses eve's reserved session namespace.`);return{continuationToken:e.continuationToken,async deliver(r,i){let a=t.channelKind!==void 0&&t.channelName!==void 0?createChannelDeliveryMetadata(t):void 0,o=normalizeSendInput(r),s=sessionCallbackToTurnCaller(i.callback),c={auth:i.auth,delivery:a,kind:`send`,payload:{...o,message:serializeUrlFilePartsInMessage(o.message)},requestId:t.requestId,turnPolicy:o.message===void 0?void 0:i.turnPolicy??e.turnPolicy??DEFAULT_TURN_POLICY},l=s===void 0?c:{...c,caller:s},u=await(async()=>{let r=await e.runtime.dispatchContinuation({command:l,continuationToken:n});return r.status===`accepted`?createSession(r.sessionId,e.runtime,{...t,turnPolicy:e.turnPolicy}):void 0})();if(u!==void 0)return u;if(o.inputResponses&&o.inputResponses.length>0)throw Error(`Cannot deliver inputResponses — the target session was not found via continuation token.`);let d=i.state,f=d===void 0?e.adapter:{...e.adapter,state:{...e.adapter.state,...d}};f!==e.adapter&&copyChannelActivityPresentation(e.adapter,f);let p=i.mode===`task`?void 0:{requestInput:!0},m={adapter:f,auth:i.auth,capabilities:p,callback:i.callback,channelName:e.channelName,continuationConflictCommand:l,continuationToken:n,delivery:a,initiatorAuth:i.initiatorAuth,input:{context:o.context,message:serializeUrlFilePartsInMessage(o.message)??``,outputSchema:o.outputSchema},mode:i.mode??`conversation`,requestId:t.requestId,title:i.title},h=await e.runtime.createSession(m);return createSession(h.sessionId,e.runtime,{...t,turnPolicy:e.turnPolicy})},async send(e,t){return await this.deliver({message:e},t)},async respond(e,t){if(e===void 0||e.length===0)throw Error(`respond() requires at least one input response.`);return await this.deliver({inputResponses:e},t)},async cancel(t){return await e.runtime.dispatchContinuation({command:{kind:`cancel`,turnId:t?.turnId},continuationToken:n})},async compact(){return await e.runtime.dispatchContinuation({command:{kind:`compact`},continuationToken:n})},async clear(){return await e.runtime.dispatchContinuation({command:{kind:`clear`},continuationToken:n})},async reset(t){return await e.runtime.dispatchContinuation({command:{kind:`reset`,reason:t?.reason},continuationToken:n})},async resolveSession(){let r=await e.runtime.resolveContinuation(n);return r===void 0?void 0:createSession(r.sessionId,e.runtime,{...t,turnPolicy:e.turnPolicy})}}}function createChannelAddressFn(e){return t=>createChannelAddress({...e,continuationToken:t})}export{createChannelAddress,createChannelAddressFn};

package/dist/src/channel/conversation-context.d.ts

@@ -1,3 +1,5 @@
-import type { RunInput } from "#channel/types.js";
-import { type ConversationContext, type ConversationEnvironment } from "#shared/conversation-context.js";
+import type { RunInput, SessionAuthContext } from "#channel/types.js";
+import { type AudienceCaller, type ConversationContext, type ConversationEnvironment } from "#shared/conversation-context.js";
 export declare function buildConversationContext(run: RunInput, environment: ConversationEnvironment): ConversationContext;
+/** Projects route auth into the minimal identity audience classifiers need. */
+export declare function toAudienceCaller(auth: SessionAuthContext | null | undefined): AudienceCaller;

package/dist/src/channel/conversation-context.js

@@ -1 +1 @@
-import{resolveAudience}from"#channel/audience.js";import{buildChannelInstrumentationProjection}from"#channel/instrumentation.js";import{normalizeInstrumentationChannelKind}from"#shared/instrumentation-channel-kind.js";import{resolveConversationContext}from"#shared/conversation-context.js";import{readForwardedTraceAssertion}from"#shared/forwarded-trace-policy.js";function buildConversationContext(e,t){let n=Object.hasOwn(e,`audienceAuth`)?e.audienceAuth??null:e.auth,r=buildChannelInstrumentationProjection({adapter:e.adapter,channelName:e.channelName}),i={kind:normalizeInstrumentationChannelKind(r.kind),name:e.channelName},a=e.inheritedConversation,o=readForwardedTraceAssertion(e.parentTraceContext?.forwardedTracePolicy),s=o?.originAudience??a?.audience??resolveAudience(e.adapter,{state:e.adapter.state,auth:n,channel:i,mode:e.mode,environment:t});return{...resolveConversationContext(void 0,{channelKind:r.kind,environment:t,forwardedTracePolicy:o,mode:e.mode,principalType:n?.principalType}),audience:s,channel:i}}export{buildConversationContext};
+import{resolveAudience}from"#channel/audience.js";import{buildChannelInstrumentationProjection}from"#channel/instrumentation.js";import{normalizeInstrumentationChannelKind}from"#shared/instrumentation-channel-kind.js";import{resolveConversationContext}from"#shared/conversation-context.js";import{readForwardedTraceAssertion}from"#shared/forwarded-trace-policy.js";function buildConversationContext(e,t){let n=Object.hasOwn(e,`audienceAuth`)?e.audienceAuth??null:e.auth,r=buildChannelInstrumentationProjection({adapter:e.adapter,channelName:e.channelName}),i={kind:normalizeInstrumentationChannelKind(r.kind),name:e.channelName},a=e.inheritedConversation,o=readForwardedTraceAssertion(e.parentTraceContext?.forwardedTracePolicy),s=o?.originAudience??a?.audience??resolveAudience(e.adapter,{state:e.adapter.state,auth:n,caller:toAudienceCaller(n),channel:i,mode:e.mode,environment:t});return{...resolveConversationContext(void 0,{channelKind:r.kind,environment:t,forwardedTracePolicy:o,mode:e.mode,principalType:n?.principalType}),audience:s,channel:i}}function toAudienceCaller(e){return e==null||e.principalType===`anonymous`?{type:`anonymous`}:{type:`principal`,principal:{attributes:e.attributes,authenticator:e.authenticator,kind:e.principalType}}}export{buildConversationContext,toAudienceCaller};

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

@@ -50,15 +50,16 @@ export type SessionRespondOptions = SessionDeliveryOptions;
  * Live handle to the current session, exposed on `ctx.session` to
  * `deliver` and event handlers. The framework hydrates the read-only
  * fields from the active context at step start. A write through
- * `continuation.rekey()` updates the context so the
- * runtime can re-key the parked workflow hook at the next step boundary.
+ * `continuation.alias()` selects a new current address and records it so the
+ * runtime can add its hook to the session inbox at the next step boundary.
+ * Previously claimed addresses remain active.
  */
 export interface SessionHandle {
     readonly id: string;
     readonly auth: SessionAuth;
     readonly continuation?: {
         readonly token: string;
-        rekey(rawToken: string): void;
+        alias(rawToken: string): void;
     };
 }
 export declare function createSession(id: string, runtime: Runtime, metadata?: Partial<ChannelDeliverySource> & {

package/dist/src/channel/session.js

@@ -1 +1 @@
-import{attachClientContext,readClientContext}from"#internal/client-context.js";import{createChannelDeliveryMetadata}from"#channel/delivery-metadata.js";import{serializeUrlFilePartsInMessage}from"#channel/send-input.js";import{DEFAULT_TURN_POLICY}from"#channel/types.js";import{parseInputResponses}from"#shared/input.js";import{AuthKey,ContinuationTokenKey,InitiatorAuthKey,SessionIdKey}from"#context/keys.js";import{toChannelLocalContinuationToken}from"#shared/continuation-token.js";function createSession(e,t,n={}){return{id:e,async send(r,i){let a=createDelivery(n),o=sessionCallbackToTurnCaller(i.callback,i.activityObserver),s=attachClientContext({message:serializeUrlFilePartsInMessage(r)},readClientContext(i));i.context!==void 0&&(s.context=i.context),i.outputSchema!==void 0&&(s.outputSchema=i.outputSchema);let c={auth:i.auth,delivery:a,kind:`send`,payload:s,requestId:n.requestId,turnPolicy:i.turnPolicy??n.turnPolicy??DEFAULT_TURN_POLICY};return await t.dispatchSession({command:o===void 0?c:{...c,caller:o},sessionId:e})},async respond(r,i){if(r.length===0)throw Error(`respond() requires at least one input response.`);let a=parseInputResponses(r),o=sessionCallbackToTurnCaller(i.callback,i.activityObserver),s=createDelivery(n),c=attachClientContext({inputResponses:a},readClientContext(i));i.context!==void 0&&(c.context=i.context),i.outputSchema!==void 0&&(c.outputSchema=i.outputSchema);let l={auth:i.auth,delivery:s,kind:`send`,payload:c,requestId:n.requestId};return await t.dispatchSession({command:o===void 0?l:{...l,caller:o},sessionId:e})},async cancel(n){let r={kind:`cancel`};return n?.taskId!==void 0&&(r.taskId=n.taskId),n?.tasks!==void 0&&(r.tasks=n.tasks),n?.turnId!==void 0&&(r.turnId=n.turnId),await t.dispatchSession({command:r,sessionId:e})},async compact(){return await t.dispatchSession({command:{kind:`compact`},sessionId:e})},async clear(){return await t.dispatchSession({command:{kind:`clear`},sessionId:e})},async reset(n){return await t.dispatchSession({command:{kind:`reset`,reason:n?.reason},sessionId:e})},async getEventStream(n){return t.getEventStream(e,n)},async getStreamTailIndex(){return t.getStreamTailIndex(e)}}}function createAttachSessionFn(e,t={}){return n=>createSession(n,e,t)}function createDelivery(e){return e.channelKind!==void 0&&e.channelName!==void 0?createChannelDeliveryMetadata(e):void 0}function buildSessionHandle(e){return{get id(){return e.get(SessionIdKey)??``},get auth(){return{current:e.get(AuthKey)??null,initiator:e.get(InitiatorAuthKey)??null}},get continuation(){let t=e.get(ContinuationTokenKey);if(t!==void 0&&t.length!==0)return{token:toChannelLocalContinuationToken(t),rekey(n){let r=namespaceContinuationToken(t,n);t!==r&&e.set(ContinuationTokenKey,r)}}}}}function namespaceContinuationToken(e,t){let n=e.indexOf(`:`);if(n<=0)throw Error(`Cannot set session continuation token without an existing namespaced continuation token. Start the session with a placeholder continuationToken.`);return`${e.slice(0,n+1)}${t}`}function sessionCallbackToTurnCaller(e,t){return e===void 0?void 0:{activityObserver:t,callId:e.callId,replyTo:{kind:`callback`,token:e.token,url:e.url},subagentName:e.subagentName,taskId:e.taskId}}export{buildSessionHandle,createAttachSessionFn,createSession,sessionCallbackToTurnCaller};
+import{attachClientContext,readClientContext}from"#internal/client-context.js";import{createChannelDeliveryMetadata}from"#channel/delivery-metadata.js";import{serializeUrlFilePartsInMessage}from"#channel/send-input.js";import{DEFAULT_TURN_POLICY}from"#channel/types.js";import{parseInputResponses}from"#shared/input.js";import{AuthKey,ContinuationHookTokensKey,ContinuationTokenKey,InitiatorAuthKey,SessionIdKey}from"#context/keys.js";import{toChannelLocalContinuationToken}from"#shared/continuation-token.js";function createSession(e,t,n={}){return{id:e,async send(r,i){let a=createDelivery(n),o=sessionCallbackToTurnCaller(i.callback,i.activityObserver),s=attachClientContext({message:serializeUrlFilePartsInMessage(r)},readClientContext(i));i.context!==void 0&&(s.context=i.context),i.outputSchema!==void 0&&(s.outputSchema=i.outputSchema);let c={auth:i.auth,delivery:a,kind:`send`,payload:s,requestId:n.requestId,turnPolicy:i.turnPolicy??n.turnPolicy??DEFAULT_TURN_POLICY};return await t.dispatchSession({command:o===void 0?c:{...c,caller:o},sessionId:e})},async respond(r,i){if(r.length===0)throw Error(`respond() requires at least one input response.`);let a=parseInputResponses(r),o=sessionCallbackToTurnCaller(i.callback,i.activityObserver),s=createDelivery(n),c=attachClientContext({inputResponses:a},readClientContext(i));i.context!==void 0&&(c.context=i.context),i.outputSchema!==void 0&&(c.outputSchema=i.outputSchema);let l={auth:i.auth,delivery:s,kind:`send`,payload:c,requestId:n.requestId};return await t.dispatchSession({command:o===void 0?l:{...l,caller:o},sessionId:e})},async cancel(n){let r={kind:`cancel`};return n?.taskId!==void 0&&(r.taskId=n.taskId),n?.tasks!==void 0&&(r.tasks=n.tasks),n?.turnId!==void 0&&(r.turnId=n.turnId),await t.dispatchSession({command:r,sessionId:e})},async compact(){return await t.dispatchSession({command:{kind:`compact`},sessionId:e})},async clear(){return await t.dispatchSession({command:{kind:`clear`},sessionId:e})},async reset(n){return await t.dispatchSession({command:{kind:`reset`,reason:n?.reason},sessionId:e})},async getEventStream(n){return t.getEventStream(e,n)},async getStreamTailIndex(){return t.getStreamTailIndex(e)}}}function createAttachSessionFn(e,t={}){return n=>createSession(n,e,t)}function createDelivery(e){return e.channelKind!==void 0&&e.channelName!==void 0?createChannelDeliveryMetadata(e):void 0}function buildSessionHandle(e){return{get id(){return e.get(SessionIdKey)??``},get auth(){return{current:e.get(AuthKey)??null,initiator:e.get(InitiatorAuthKey)??null}},get continuation(){let t=e.get(ContinuationTokenKey);if(t!==void 0&&t.length!==0)return{token:toChannelLocalContinuationToken(t),alias(n){if(n.length===0)throw Error(`A session alias requires a nonempty token.`);let r=namespaceContinuationToken(t,n);t!==r&&(e.set(ContinuationHookTokensKey,e=>{let n=e??[t];return n.includes(r)?n:[...n,r]}),e.set(ContinuationTokenKey,r))}}}}}function namespaceContinuationToken(e,t){let n=e.indexOf(`:`);if(n<=0)throw Error(`Cannot set session continuation token without an existing namespaced continuation token. Start the session with a placeholder continuationToken.`);return`${e.slice(0,n+1)}${t}`}function sessionCallbackToTurnCaller(e,t){return e===void 0?void 0:{activityObserver:t,callId:e.callId,replyTo:{kind:`callback`,token:e.token,url:e.url},subagentName:e.subagentName,taskId:e.taskId}}export{buildSessionHandle,createAttachSessionFn,createSession,sessionCallbackToTurnCaller};

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

@@ -1,5 +1,5 @@
 import type { UserContent } from "ai";
-import type { SessionInboxAddress } from "#execution/wire/session-inbox-contract.js";
+import type { SessionInboxAddress } from "#execution/session-inbox/address.js";
 import type { MessageStreamEvent, UnstampedMessageStreamEvent } from "#protocol/message.js";
 import type { CancelTurnResult as ProtocolCancelTurnResult } from "#protocol/cancel-turn.js";
 import type { RunMode } from "#shared/run-mode.js";
@@ -255,6 +255,8 @@ export interface DeliverHookPayload {
 /** Internal deadline signal sent through the stable session command inbox. */
 export interface SessionTimeoutHookPayload {
     readonly kind: "session-timeout";
+    /** The owner run that armed this timer; a later owner ignores a predecessor's deadline. */
+    readonly ownerRunId: string;
 }
 /** Requests a context compaction without delivering model input. */
 export interface CompactSessionHookPayload {
@@ -428,10 +430,11 @@ export interface RunInput {
     readonly activityObserver?: ActivityObserverConfig;
     /**
      * Session continuation token for delivery and hook creation. Channels can
-     * re-key the session during the first turn via
-     * `ctx.session.continuation.rekey(...)` (e.g. Slack adopts its first
+     * add a continuation address during the first turn via
+     * `ctx.session.continuation.alias(...)` (e.g. Slack adopts its first
      * post's `ts` as the thread root), so an initial placeholder token is
-     * acceptable when full identity isn't known until the first message. ID-only
+     * acceptable when full identity isn't known until the first message. Earlier
+     * addresses remain valid after an alias. ID-only
      * transports omit this field.
      */
     readonly continuationToken?: string;

package/dist/src/chunks/{use-eve-agent-D-KQzzyW.js → use-eve-agent-C2APNCdP.js}

@@ -21,7 +21,6 @@ const EVE_DEV_RUNTIME_ARTIFACTS_REBUILD_ROUTE_PATH = `${EVE_DEV_RUNTIME_ARTIFACT
 const EVE_DEV_RUNTIME_ARTIFACTS_SUSPEND_ROUTE_PATH = `${EVE_DEV_RUNTIME_ARTIFACTS_ROUTE_PATH}/suspend`;
 const EVE_DEV_RUNTIME_ARTIFACTS_RESUME_ROUTE_PATH = `${EVE_DEV_RUNTIME_ARTIFACTS_ROUTE_PATH}/resume`;
 const EVE_CONNECTION_CALLBACK_ROUTE_PATTERN = `${EVE_ROUTE_PREFIX}/connections/:name/callback/:attemptId/:token`;
-const EVE_LEGACY_CONNECTION_CALLBACK_ROUTE_PATTERN = `${EVE_ROUTE_PREFIX}/connections/:name/callback/:token`;
 const EVE_CALLBACK_ROUTE_PATTERN = `${EVE_ROUTE_PREFIX}/callback/:token`;
 const EVE_TASK_INPUT_ROUTE_PATTERN = `${EVE_ROUTE_PREFIX}/task-input/:token`;
 const EVE_ACTIVITY_ROUTE_PATTERN = `${EVE_ROUTE_PREFIX}/activity/:token`;
@@ -164,7 +163,12 @@ const modelEndpoint = z.union([
 	z.object({
 		kind: z.literal("gateway"),
 		connected: z.literal(true),
-		credential: z.enum(["api-key", "oidc"])
+		credential: z.enum([
+			"api-key",
+			"oidc",
+			"oauth"
+		]),
+		team: z.optional(z.string())
 	}).strict(),
 	z.object({
 		kind: z.literal("gateway"),
@@ -337,14 +341,6 @@ const compositionDiagnostic = z.object({
 	sourceId: z.string(),
 	winnerSourceId: z.string().optional()
 }).strict();
-const workflow = z.discriminatedUnion("enabled", [z.object({
-	enabled: z.literal(false),
-	toolName: z.string()
-}).strict(), z.object({
-	enabled: z.literal(true),
-	source,
-	toolName: z.string()
-}).strict()]);
 const AgentInfoResultSchema = z.object({
 	agent: z.object({
 		agentRoot: z.string(),
@@ -399,7 +395,6 @@ const AgentInfoResultSchema = z.object({
 		static: z.array(tool)
 	}).strict(),
 	version: z.literal(4),
-	workflow,
 	workspace: z.object({
 		resourceRoot: z.unknown(),
 		rootEntries: z.array(z.string())
@@ -503,7 +498,6 @@ const AgentInfoResultSchema = z.object({
 			"static",
 			index
 		]]),
-		...value.workflow.enabled ? [[value.workflow.source, ["workflow", "source"]]] : [],
 		[value.sandbox, ["sandbox"]]
 	];
 	for (const [entry, path] of boundSources) {
@@ -679,6 +673,11 @@ function incrementRandom(bytes) {
 const EVE_SESSION_ID_HEADER = "x-eve-session-id";
 const EVE_STREAM_TAIL_INDEX_HEADER = "x-eve-stream-tail-index";
 const EVE_STREAM_VERSION_HEADER = "x-eve-stream-version";
+const EVE_STREAM_CONTROL_VERSION_QUERY = "streamControlVersion";
+const EVE_STREAM_LEASE_ENDED_CONTROL = {
+	$eve: "stream.lease-ended",
+	version: 1
+};
 const textEncoder = new TextEncoder();
 function isCurrentTurnBoundaryEvent(event) {
 	return event.type === "session.completed" || event.type === "session.failed" || event.type === "session.waiting";
@@ -907,20 +906,32 @@ async function* readNdjsonStream(body, options) {
 			while (newlineIndex !== -1) {
 				const line = buffer.slice(0, newlineIndex).trim();
 				buffer = buffer.slice(newlineIndex + 1);
-				if (line.length > 0) yield parseMessageStreamEvent(line, options.streamVersion);
+				if (line.length > 0) {
+					const value = JSON.parse(line);
+					if (options.controlVersion === "1" && isLeaseEndedControl(value)) options.onLeaseEnded?.();
+					else yield parseMessageStreamEvent(value, options.streamVersion);
+				}
 				newlineIndex = buffer.indexOf("\n");
 			}
 		}
 		const trailing = buffer.trim();
-		if (trailing.length > 0) yield parseMessageStreamEvent(trailing, options.streamVersion);
+		if (trailing.length > 0) {
+			const value = JSON.parse(trailing);
+			if (options.controlVersion === "1" && isLeaseEndedControl(value)) options.onLeaseEnded?.();
+			else yield parseMessageStreamEvent(value, options.streamVersion);
+		}
 	} finally {
 		if (!reachedEof) reader.cancel().catch(() => {});
 		reader.releaseLock();
 	}
 }
-function parseMessageStreamEvent(line, version) {
-	const event = JSON.parse(line);
-	return normalizeMessageStreamEvent(version, event);
+function isLeaseEndedControl(value) {
+	if (value === null || typeof value !== "object") return false;
+	const record = value;
+	return record.$eve === EVE_STREAM_LEASE_ENDED_CONTROL.$eve && record.version === EVE_STREAM_LEASE_ENDED_CONTROL.version;
+}
+function parseMessageStreamEvent(value, version) {
+	return normalizeMessageStreamEvent(version, value);
 }
 async function readWithIdleTimeout(reader, idleTimeoutMs) {
 	let timeout;
@@ -1078,9 +1089,14 @@ async function* followStreamIterable(input) {
 			return;
 		}
 		let deliveredEvent = false;
+		let leaseEnded = false;
 		try {
 			for await (const event of readNdjsonStream(connection.body, {
+				controlVersion: connection.controlVersion,
 				idleTimeoutMs: input.streamReadIdleTimeoutMs ?? DEFAULT_STREAM_READ_IDLE_TIMEOUT_MS,
+				onLeaseEnded: () => {
+					leaseEnded = true;
+				},
 				streamVersion: connection.streamVersion
 			})) {
 				startIndex += 1;
@@ -1096,6 +1112,7 @@ async function* followStreamIterable(input) {
 			connection.close();
 		}
 		if (input.signal?.aborted || input.startIndex < 0 || idleRetryPolicy.maxAttempts === 0) return;
+		if (leaseEnded) continue;
 		if (input.keepAlive !== true && !deliveredEvent && !initialConnection && (idleReconnects += 1) >= idleRetryPolicy.maxAttempts) return;
 		initialConnection = false;
 		await sleep(reconnectDelayMs, input.signal);
@@ -1104,13 +1121,15 @@ async function* followStreamIterable(input) {
 	}
 }
 async function openStreamBody(input) {
-	const retryPolicy = input.retryPolicy ?? DEFAULT_STREAM_RECONNECT_POLICY;
+	const retryPolicy = input.retryPolicy ?? resolveStreamReconnectPolicy(input.streamReconnectPolicy);
 	const openRetryPolicy = retryPolicy.streamOpenReconnectPolicy;
 	let lastStatus;
 	let lastBody;
 	let lastHeaders;
 	let retryDelayMs = openRetryPolicy.baseDelayMs;
+	const controlVersion = input.startIndex >= 0 && retryPolicy.streamIdleReconnectPolicy.maxAttempts > 0 ? "1" : void 0;
 	const searchParams = {};
+	if (controlVersion !== void 0) searchParams[EVE_STREAM_CONTROL_VERSION_QUERY] = controlVersion;
 	if (input.startIndex !== 0) searchParams.startIndex = String(input.startIndex);
 	if (input.requestTailIndex === true) searchParams.includeTailIndex = "1";
 	for (let attempt = 0; attempt < openRetryPolicy.maxAttempts; attempt += 1) {
@@ -1143,6 +1162,7 @@ async function openStreamBody(input) {
 					response.body?.cancel().catch(() => {});
 					connectionController.abort();
 				},
+				controlVersion,
 				streamVersion: readMessageStreamVersion(response.headers),
 				tailIndex: parseTailIndexHeader(response.headers)
 			};
@@ -1891,6 +1911,7 @@ var EveAgentStore = class {
 			completion: completion.promise,
 			followUpDispatches: /* @__PURE__ */ new Set(),
 			receivedFollowUps: 0,
+			followUpSubmissionIds: /* @__PURE__ */ new Set(),
 			resolveCompletion: completion.resolve,
 			response: response.promise,
 			resolveResponse: response.resolve
@@ -1966,6 +1987,7 @@ var EveAgentStore = class {
 			completion: completion.promise,
 			followUpDispatches: /* @__PURE__ */ new Set(),
 			receivedFollowUps: 0,
+			followUpSubmissionIds: /* @__PURE__ */ new Set(),
 			resolveCompletion: completion.resolve,
 			response: response.promise,
 			resolveResponse: response.resolve
@@ -2065,12 +2087,13 @@ var EveAgentStore = class {
 		this.#publish();
 	}
 	async #sendFollowUp(turn, input) {
-		if (input.message === void 0 || input.turnPolicy !== "steer") throw new Error("eve session is already processing a turn. Send a message with turnPolicy: \"steer\" to replace it.");
+		if (input.message === void 0 || input.turnPolicy !== "steer") throw new Error("eve session is already processing a turn. Send a message with turnPolicy: \"steer\" to guide it at the next boundary.");
 		const preparedInput = await this.#callbacks.prepareSend?.(input) ?? input;
 		assertExclusiveTurnInput(preparedInput);
 		if (preparedInput.message === void 0 || preparedInput.turnPolicy !== "steer") throw new Error("An in-flight follow-up requires a message with turnPolicy: \"steer\".");
 		if (!this.#isActiveTurn(turn)) return await this.send(preparedInput);
 		const submissionId = this.#projectOptimisticMessage(preparedInput);
+		if (submissionId !== void 0) turn.followUpSubmissionIds.add(submissionId);
 		this.#publish();
 		let dispatch;
 		dispatch = (async () => {
@@ -2097,7 +2120,6 @@ var EveAgentStore = class {
 		if (turn.receivedFollowUps >= turn.acceptedFollowUps || this.#session === void 0) return;
 		for await (const event of this.#session.stream({ signal: turn.abortController.signal })) {
 			if (!this.#isActiveTurn(turn)) return;
-			if (event.type === "message.received") turn.receivedFollowUps += 1;
 			this.#acceptServerEvent(event);
 			if (isCurrentTurnBoundaryEvent(event)) {
 				while (turn.followUpDispatches.size > 0) await Promise.allSettled(turn.followUpDispatches);
@@ -2130,7 +2152,7 @@ var EveAgentStore = class {
 		return this.#activeTurn === turn;
 	}
 	#projectOptimisticMessage(input) {
-		if (!this.#optimistic || input.message === void 0) return;
+		if (input.message === void 0) return;
 		const id = createSubmissionId();
 		const pending = {
 			createdAt: Date.now(),
@@ -2138,7 +2160,7 @@ var EveAgentStore = class {
 			message: summarizeUserContent(input.message)
 		};
 		this.#pendingMessageSubmissions = [...this.#pendingMessageSubmissions, pending];
-		this.#appendProjectionEvent({
+		if (this.#optimistic) this.#appendProjectionEvent({
 			data: {
 				createdAt: pending.createdAt,
 				message: pending.message,
@@ -2171,6 +2193,7 @@ var EveAgentStore = class {
 		const pendingSubmission = this.#pendingMessageSubmissions[0];
 		if (event.type === "message.received" && pendingSubmission !== void 0) {
 			const submissionId = pendingSubmission.id;
+			if (this.#activeTurn?.followUpSubmissionIds.delete(submissionId)) this.#activeTurn.receivedFollowUps += 1;
 			this.#pendingMessageSubmissions = this.#pendingMessageSubmissions.slice(1);
 			this.#replaceProjectionEvent((candidate) => candidate.type === "client.message.submitted" && candidate.data.submissionId === submissionId, event);
 			return;

package/dist/src/chunks/{use-eve-agent-CxPlg0KL.js → use-eve-agent-D0YnDLi_.js}

@@ -21,7 +21,6 @@ const EVE_DEV_RUNTIME_ARTIFACTS_REBUILD_ROUTE_PATH = `${EVE_DEV_RUNTIME_ARTIFACT
 const EVE_DEV_RUNTIME_ARTIFACTS_SUSPEND_ROUTE_PATH = `${EVE_DEV_RUNTIME_ARTIFACTS_ROUTE_PATH}/suspend`;
 const EVE_DEV_RUNTIME_ARTIFACTS_RESUME_ROUTE_PATH = `${EVE_DEV_RUNTIME_ARTIFACTS_ROUTE_PATH}/resume`;
 const EVE_CONNECTION_CALLBACK_ROUTE_PATTERN = `${EVE_ROUTE_PREFIX}/connections/:name/callback/:attemptId/:token`;
-const EVE_LEGACY_CONNECTION_CALLBACK_ROUTE_PATTERN = `${EVE_ROUTE_PREFIX}/connections/:name/callback/:token`;
 const EVE_CALLBACK_ROUTE_PATTERN = `${EVE_ROUTE_PREFIX}/callback/:token`;
 const EVE_TASK_INPUT_ROUTE_PATTERN = `${EVE_ROUTE_PREFIX}/task-input/:token`;
 const EVE_ACTIVITY_ROUTE_PATTERN = `${EVE_ROUTE_PREFIX}/activity/:token`;
@@ -164,7 +163,12 @@ const modelEndpoint = z.union([
 	z.object({
 		kind: z.literal("gateway"),
 		connected: z.literal(true),
-		credential: z.enum(["api-key", "oidc"])
+		credential: z.enum([
+			"api-key",
+			"oidc",
+			"oauth"
+		]),
+		team: z.optional(z.string())
 	}).strict(),
 	z.object({
 		kind: z.literal("gateway"),
@@ -337,14 +341,6 @@ const compositionDiagnostic = z.object({
 	sourceId: z.string(),
 	winnerSourceId: z.string().optional()
 }).strict();
-const workflow = z.discriminatedUnion("enabled", [z.object({
-	enabled: z.literal(false),
-	toolName: z.string()
-}).strict(), z.object({
-	enabled: z.literal(true),
-	source,
-	toolName: z.string()
-}).strict()]);
 const AgentInfoResultSchema = z.object({
 	agent: z.object({
 		agentRoot: z.string(),
@@ -399,7 +395,6 @@ const AgentInfoResultSchema = z.object({
 		static: z.array(tool)
 	}).strict(),
 	version: z.literal(4),
-	workflow,
 	workspace: z.object({
 		resourceRoot: z.unknown(),
 		rootEntries: z.array(z.string())
@@ -503,7 +498,6 @@ const AgentInfoResultSchema = z.object({
 			"static",
 			index
 		]]),
-		...value.workflow.enabled ? [[value.workflow.source, ["workflow", "source"]]] : [],
 		[value.sandbox, ["sandbox"]]
 	];
 	for (const [entry, path] of boundSources) {
@@ -679,6 +673,11 @@ function incrementRandom(bytes) {
 const EVE_SESSION_ID_HEADER = "x-eve-session-id";
 const EVE_STREAM_TAIL_INDEX_HEADER = "x-eve-stream-tail-index";
 const EVE_STREAM_VERSION_HEADER = "x-eve-stream-version";
+const EVE_STREAM_CONTROL_VERSION_QUERY = "streamControlVersion";
+const EVE_STREAM_LEASE_ENDED_CONTROL = {
+	$eve: "stream.lease-ended",
+	version: 1
+};
 const textEncoder = new TextEncoder();
 function isCurrentTurnBoundaryEvent(event) {
 	return event.type === "session.completed" || event.type === "session.failed" || event.type === "session.waiting";
@@ -907,20 +906,32 @@ async function* readNdjsonStream(body, options) {
 			while (newlineIndex !== -1) {
 				const line = buffer.slice(0, newlineIndex).trim();
 				buffer = buffer.slice(newlineIndex + 1);
-				if (line.length > 0) yield parseMessageStreamEvent(line, options.streamVersion);
+				if (line.length > 0) {
+					const value = JSON.parse(line);
+					if (options.controlVersion === "1" && isLeaseEndedControl(value)) options.onLeaseEnded?.();
+					else yield parseMessageStreamEvent(value, options.streamVersion);
+				}
 				newlineIndex = buffer.indexOf("\n");
 			}
 		}
 		const trailing = buffer.trim();
-		if (trailing.length > 0) yield parseMessageStreamEvent(trailing, options.streamVersion);
+		if (trailing.length > 0) {
+			const value = JSON.parse(trailing);
+			if (options.controlVersion === "1" && isLeaseEndedControl(value)) options.onLeaseEnded?.();
+			else yield parseMessageStreamEvent(value, options.streamVersion);
+		}
 	} finally {
 		if (!reachedEof) reader.cancel().catch(() => {});
 		reader.releaseLock();
 	}
 }
-function parseMessageStreamEvent(line, version) {
-	const event = JSON.parse(line);
-	return normalizeMessageStreamEvent(version, event);
+function isLeaseEndedControl(value) {
+	if (value === null || typeof value !== "object") return false;
+	const record = value;
+	return record.$eve === EVE_STREAM_LEASE_ENDED_CONTROL.$eve && record.version === EVE_STREAM_LEASE_ENDED_CONTROL.version;
+}
+function parseMessageStreamEvent(value, version) {
+	return normalizeMessageStreamEvent(version, value);
 }
 async function readWithIdleTimeout(reader, idleTimeoutMs) {
 	let timeout;
@@ -1078,9 +1089,14 @@ async function* followStreamIterable(input) {
 			return;
 		}
 		let deliveredEvent = false;
+		let leaseEnded = false;
 		try {
 			for await (const event of readNdjsonStream(connection.body, {
+				controlVersion: connection.controlVersion,
 				idleTimeoutMs: input.streamReadIdleTimeoutMs ?? DEFAULT_STREAM_READ_IDLE_TIMEOUT_MS,
+				onLeaseEnded: () => {
+					leaseEnded = true;
+				},
 				streamVersion: connection.streamVersion
 			})) {
 				startIndex += 1;
@@ -1096,6 +1112,7 @@ async function* followStreamIterable(input) {
 			connection.close();
 		}
 		if (input.signal?.aborted || input.startIndex < 0 || idleRetryPolicy.maxAttempts === 0) return;
+		if (leaseEnded) continue;
 		if (input.keepAlive !== true && !deliveredEvent && !initialConnection && (idleReconnects += 1) >= idleRetryPolicy.maxAttempts) return;
 		initialConnection = false;
 		await sleep(reconnectDelayMs, input.signal);
@@ -1104,13 +1121,15 @@ async function* followStreamIterable(input) {
 	}
 }
 async function openStreamBody(input) {
-	const retryPolicy = input.retryPolicy ?? DEFAULT_STREAM_RECONNECT_POLICY;
+	const retryPolicy = input.retryPolicy ?? resolveStreamReconnectPolicy(input.streamReconnectPolicy);
 	const openRetryPolicy = retryPolicy.streamOpenReconnectPolicy;
 	let lastStatus;
 	let lastBody;
 	let lastHeaders;
 	let retryDelayMs = openRetryPolicy.baseDelayMs;
+	const controlVersion = input.startIndex >= 0 && retryPolicy.streamIdleReconnectPolicy.maxAttempts > 0 ? "1" : void 0;
 	const searchParams = {};
+	if (controlVersion !== void 0) searchParams[EVE_STREAM_CONTROL_VERSION_QUERY] = controlVersion;
 	if (input.startIndex !== 0) searchParams.startIndex = String(input.startIndex);
 	if (input.requestTailIndex === true) searchParams.includeTailIndex = "1";
 	for (let attempt = 0; attempt < openRetryPolicy.maxAttempts; attempt += 1) {
@@ -1143,6 +1162,7 @@ async function openStreamBody(input) {
 					response.body?.cancel().catch(() => {});
 					connectionController.abort();
 				},
+				controlVersion,
 				streamVersion: readMessageStreamVersion(response.headers),
 				tailIndex: parseTailIndexHeader(response.headers)
 			};
@@ -1891,6 +1911,7 @@ var EveAgentStore = class {
 			completion: completion.promise,
 			followUpDispatches: /* @__PURE__ */ new Set(),
 			receivedFollowUps: 0,
+			followUpSubmissionIds: /* @__PURE__ */ new Set(),
 			resolveCompletion: completion.resolve,
 			response: response.promise,
 			resolveResponse: response.resolve
@@ -1966,6 +1987,7 @@ var EveAgentStore = class {
 			completion: completion.promise,
 			followUpDispatches: /* @__PURE__ */ new Set(),
 			receivedFollowUps: 0,
+			followUpSubmissionIds: /* @__PURE__ */ new Set(),
 			resolveCompletion: completion.resolve,
 			response: response.promise,
 			resolveResponse: response.resolve
@@ -2065,12 +2087,13 @@ var EveAgentStore = class {
 		this.#publish();
 	}
 	async #sendFollowUp(turn, input) {
-		if (input.message === void 0 || input.turnPolicy !== "steer") throw new Error("eve session is already processing a turn. Send a message with turnPolicy: \"steer\" to replace it.");
+		if (input.message === void 0 || input.turnPolicy !== "steer") throw new Error("eve session is already processing a turn. Send a message with turnPolicy: \"steer\" to guide it at the next boundary.");
 		const preparedInput = await this.#callbacks.prepareSend?.(input) ?? input;
 		assertExclusiveTurnInput(preparedInput);
 		if (preparedInput.message === void 0 || preparedInput.turnPolicy !== "steer") throw new Error("An in-flight follow-up requires a message with turnPolicy: \"steer\".");
 		if (!this.#isActiveTurn(turn)) return await this.send(preparedInput);
 		const submissionId = this.#projectOptimisticMessage(preparedInput);
+		if (submissionId !== void 0) turn.followUpSubmissionIds.add(submissionId);
 		this.#publish();
 		let dispatch;
 		dispatch = (async () => {
@@ -2097,7 +2120,6 @@ var EveAgentStore = class {
 		if (turn.receivedFollowUps >= turn.acceptedFollowUps || this.#session === void 0) return;
 		for await (const event of this.#session.stream({ signal: turn.abortController.signal })) {
 			if (!this.#isActiveTurn(turn)) return;
-			if (event.type === "message.received") turn.receivedFollowUps += 1;
 			this.#acceptServerEvent(event);
 			if (isCurrentTurnBoundaryEvent(event)) {
 				while (turn.followUpDispatches.size > 0) await Promise.allSettled(turn.followUpDispatches);
@@ -2130,7 +2152,7 @@ var EveAgentStore = class {
 		return this.#activeTurn === turn;
 	}
 	#projectOptimisticMessage(input) {
-		if (!this.#optimistic || input.message === void 0) return;
+		if (input.message === void 0) return;
 		const id = createSubmissionId();
 		const pending = {
 			createdAt: Date.now(),
@@ -2138,7 +2160,7 @@ var EveAgentStore = class {
 			message: summarizeUserContent(input.message)
 		};
 		this.#pendingMessageSubmissions = [...this.#pendingMessageSubmissions, pending];
-		this.#appendProjectionEvent({
+		if (this.#optimistic) this.#appendProjectionEvent({
 			data: {
 				createdAt: pending.createdAt,
 				message: pending.message,
@@ -2171,6 +2193,7 @@ var EveAgentStore = class {
 		const pendingSubmission = this.#pendingMessageSubmissions[0];
 		if (event.type === "message.received" && pendingSubmission !== void 0) {
 			const submissionId = pendingSubmission.id;
+			if (this.#activeTurn?.followUpSubmissionIds.delete(submissionId)) this.#activeTurn.receivedFollowUps += 1;
 			this.#pendingMessageSubmissions = this.#pendingMessageSubmissions.slice(1);
 			this.#replaceProjectionEvent((candidate) => candidate.type === "client.message.submitted" && candidate.data.submissionId === submissionId, event);
 			return;