eve 0.37.0 → 0.38.0

package/CHANGELOG.md

@@ -1,5 +1,37 @@
 # eve
 
+## 0.38.0
+
+### Minor Changes
+
+- 48c1105: Replace `stop()` on frontend agent bindings with `cancel()`. Cancellation now targets the exact durable turn through `MessageResponse.cancel()` while the binding stays attached through settlement.
+
+### Patch Changes
+
+- 8904392: Extensions can now contribute channels. Mounted channel IDs receive the extension namespace while their authored route paths remain unchanged.
+- 4c3c475: Built-in inbound hooks can now return `title` to set the workflow run title without changing the message sent to the model.
+- a7d34e5: Make Nitro-backed builds more reliable by preserving per-import conditional exports, keeping authored and vendored OpenTelemetry tracers on one registered provider, and running development worker close hooks during an explicit shutdown handshake. Workflow artifacts are now emitted directly instead of repaired through post-build string rewrites.
+- bdd5a9b: Suggest close registry matches when `eve add` cannot find the requested item.
+- ccc604c: Show `eve add` help and registry search guidance when no item is provided.
+- abcd06d: Resolve project-scoped CLI commands from the nearest enclosing eve application when run from a nested directory.
+- 775c061: Extensions can contribute schedules. Mounted schedule IDs use the extension namespace while cron expressions and handler behavior remain unchanged.
+
+## 0.37.1
+
+### Patch Changes
+
+- 8bf1e5b: Render background subagent activity in one persistent dev TUI section across parent turns. Idle task wakes render while the prompt remains active, remote child streams use the authenticated parent proxy, and child boundaries finalize sections without later-turn cancellation closing unrelated background work.
+- 046981e: Add experimental background tasks for local and remote subagents. With `experimental.tasks` enabled, subagent calls return durable task receipts; parents can inspect, continue, or cancel work while lifecycle notifications and human-input requests arrive asynchronously. Remote child streams are exposed through an authenticated parent-origin proxy so clients never receive remote credentials.
+- d8cef1a: Scope create-once operations to the effective forwarded principal so two forwarded users behind the same trusted forwarder cannot adopt each other's session.
+- 5d12328: Preserve a session-scoped dynamic model selection when the first turn is cancelled so later turns can reuse it without requiring a `turn.started` resolver.
+- 10a09a1: Make failed `eve init` runs recoverable: new targets are cleaned up, preexisting empty targets are restored, and existing projects receive clear dependency-install recovery guidance.
+- 8bf1e5b: The dev TUI now presents and routes approval or question prompts raised by background tasks while the parent session is idle, instead of leaving the task blocked.
+- 046981e: Preserve remote task HITL response routes for loopback HTTP children and Vercel deployments configured with Protection Bypass for Automation. HTTPS remains required for every non-loopback remote child.
+- 63726db: Polish the connection authorization completion page with a Vercel-styled success state.
+- d8cef1a: Add authenticated create-once session requests through `operationId`. Concurrent or retried creates adopt the active session that first claimed the operation without dispatching duplicate input.
+- 5ba9749: Add a secure MCP channel that reuses eve route auth and lets clients start, inspect, update, authorize, and cancel principal-bound durable agent invocations over MCP 2026-07-28 with a stateless 2025 compatibility path.
+- 60e87ef: Keep active client turns connected while they are paused for authorization so responses resume automatically after the callback completes.
+
 ## 0.37.0
 
 ### Minor Changes

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

@@ -149,9 +149,9 @@ export interface WebSocketRouteDefinition<TState = undefined> {
 }
 /**
  * A single channel route: either an {@link HttpRouteDefinition} or a
- * {@link WebSocketRouteDefinition}. Produced by the {@link GET}, {@link POST},
- * {@link PUT}, {@link PATCH}, {@link DELETE}, and {@link WS} helpers and listed
- * in a channel's `routes` array.
+ * {@link WebSocketRouteDefinition}. Produced by the {@link GET}, {@link HEAD},
+ * {@link POST}, {@link PUT}, {@link PATCH}, {@link DELETE}, {@link OPTIONS},
+ * and {@link WS} helpers and listed in a channel's `routes` array.
  */
 export type RouteDefinition<TState = undefined> = HttpRouteDefinition<TState> | WebSocketRouteDefinition<TState>;
 /**
@@ -159,6 +159,11 @@ export type RouteDefinition<TState = undefined> = HttpRouteDefinition<TState> |
  * receives the `Request` and {@link RouteHandlerArgs}.
  */
 export declare function GET<TState = undefined>(path: string, handler: RouteHandler<TState>): HttpRouteDefinition<TState>;
+/**
+ * Declares an HTTP `HEAD` route at `path`. See {@link GET} for the handler
+ * contract.
+ */
+export declare function HEAD<TState = undefined>(path: string, handler: RouteHandler<TState>): HttpRouteDefinition<TState>;
 /**
  * Declares an HTTP `POST` route at `path`. See {@link GET} for the handler
  * contract.
@@ -179,6 +184,11 @@ export declare function PATCH<TState = undefined>(path: string, handler: RouteHa
  * contract.
  */
 export declare function DELETE<TState = undefined>(path: string, handler: RouteHandler<TState>): HttpRouteDefinition<TState>;
+/**
+ * Declares an HTTP `OPTIONS` route at `path`. See {@link GET} for the handler
+ * contract.
+ */
+export declare function OPTIONS<TState = undefined>(path: string, handler: RouteHandler<TState>): HttpRouteDefinition<TState>;
 /**
  * Declares a WebSocket channel route.
  *

package/dist/src/channel/routes.js

@@ -1 +1 @@
-function GET(e,t){return{transport:`http`,method:`GET`,path:e,handler:t}}function POST(e,t){return{transport:`http`,method:`POST`,path:e,handler:t}}function PUT(e,t){return{transport:`http`,method:`PUT`,path:e,handler:t}}function PATCH(e,t){return{transport:`http`,method:`PATCH`,path:e,handler:t}}function DELETE(e,t){return{transport:`http`,method:`DELETE`,path:e,handler:t}}function WS(e,t){return{transport:`websocket`,method:`WEBSOCKET`,path:e,handler:t}}function isHttpRouteDefinition(e){return e.transport!==`websocket`}function isWebSocketRouteDefinition(e){return e.transport===`websocket`}export{DELETE,GET,PATCH,POST,PUT,WS,isHttpRouteDefinition,isWebSocketRouteDefinition};
+function GET(e,t){return{transport:`http`,method:`GET`,path:e,handler:t}}function HEAD(e,t){return{transport:`http`,method:`HEAD`,path:e,handler:t}}function POST(e,t){return{transport:`http`,method:`POST`,path:e,handler:t}}function PUT(e,t){return{transport:`http`,method:`PUT`,path:e,handler:t}}function PATCH(e,t){return{transport:`http`,method:`PATCH`,path:e,handler:t}}function DELETE(e,t){return{transport:`http`,method:`DELETE`,path:e,handler:t}}function OPTIONS(e,t){return{transport:`http`,method:`OPTIONS`,path:e,handler:t}}function WS(e,t){return{transport:`websocket`,method:`WEBSOCKET`,path:e,handler:t}}function isHttpRouteDefinition(e){return e.transport!==`websocket`}function isWebSocketRouteDefinition(e){return e.transport===`websocket`}export{DELETE,GET,HEAD,OPTIONS,PATCH,POST,PUT,WS,isHttpRouteDefinition,isWebSocketRouteDefinition};

package/dist/src/channel/session-callback.js

@@ -1 +1 @@
-import{z}from"#compiled/zod/index.js";import{createEveCallbackRoutePath}from"#protocol/routes.js";import{isReservedIpAddress}from"#shared/network-address.js";const sessionCallbackSchema=z.object({callId:z.string().min(1),subagentName:z.string().min(1),token:z.string().min(1),url:z.string().min(1)}).strict().superRefine((e,t)=>{let r;try{r=new URL(e.url)}catch{t.addIssue({code:`custom`,message:`Callback url must be absolute.`,path:[`url`]});return}readCallbackUrlToken(r)!==e.token&&t.addIssue({code:`custom`,message:`Callback url token must match callback token.`,path:[`url`]}),isReservedIpAddress(r.hostname)&&t.addIssue({code:`custom`,message:`Callback url host must not be a private or reserved address.`,path:[`url`]})});function parseSessionCallback(e){let t=sessionCallbackSchema.safeParse(e);return t.success?{callback:t.data,ok:!0}:{cause:t.error,message:formatSessionCallbackParseError(t.error),ok:!1}}function readCallbackUrlToken(e){let n=createEveCallbackRoutePath(``),r=e.pathname.lastIndexOf(n);if(r===-1)return null;let i=e.pathname.slice(r+n.length);if(i.length===0||i.includes(`/`))return null;try{return decodeURIComponent(i)}catch{return null}}function formatSessionCallbackParseError(e){return`Invalid callback metadata: ${e.issues.map(e=>`${e.path.length===0?`callback`:`callback.${e.path.join(`.`)}`}: ${e.message}`).join(`; `)}`}export{parseSessionCallback};
+import{z}from"#compiled/zod/index.js";import{createEveCallbackRoutePath}from"#protocol/routes.js";import{isReservedIpAddress}from"#shared/network-address.js";const sessionCallbackSchema=z.object({callId:z.string().min(1),subagentName:z.string().min(1),taskId:z.string().min(1).optional(),token:z.string().min(1),url:z.string().min(1)}).strict().superRefine((e,t)=>{let r;try{r=new URL(e.url)}catch{t.addIssue({code:`custom`,message:`Callback url must be absolute.`,path:[`url`]});return}readCallbackUrlToken(r)!==e.token&&t.addIssue({code:`custom`,message:`Callback url token must match callback token.`,path:[`url`]}),isReservedIpAddress(r.hostname)&&t.addIssue({code:`custom`,message:`Callback url host must not be a private or reserved address.`,path:[`url`]})});function parseSessionCallback(e){let t=sessionCallbackSchema.safeParse(e);return t.success?{callback:t.data,ok:!0}:{cause:t.error,message:formatSessionCallbackParseError(t.error),ok:!1}}function readCallbackUrlToken(e){let n=createEveCallbackRoutePath(``),r=e.pathname.lastIndexOf(n);if(r===-1)return null;let i=e.pathname.slice(r+n.length);if(i.length===0||i.includes(`/`))return null;try{return decodeURIComponent(i)}catch{return null}}function formatSessionCallbackParseError(e){return`Invalid callback metadata: ${e.issues.map(e=>`${e.path.length===0?`callback`:`callback.${e.path.join(`.`)}`}: ${e.message}`).join(`; `)}`}export{parseSessionCallback};

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

@@ -13,8 +13,9 @@ export interface Session {
     send(message: string | UserContent, options: SessionSendOptions): Promise<SessionSendCommandResult>;
     /** Answers pending input requests on this exact session ID. */
     respond(inputResponses: readonly InputResponse[], options: SessionRespondOptions): Promise<SessionSendCommandResult>;
-    /** Requests cancellation of this exact session's active turn. */
+    /** Requests cancellation of this exact session's active turn or one owned task. */
     cancel(options?: {
+        taskId?: string;
         turnId?: string;
     }): Promise<CancelTurnResult>;
     /** Queues compaction on this exact session ID. */

package/dist/src/channel/session.js

@@ -1 +1 @@
-import{createChannelDeliveryMetadata}from"#channel/delivery-metadata.js";import{serializeUrlFilePartsInMessage}from"#channel/send-input.js";import{DEFAULT_TURN_POLICY}from"#channel/types.js";import{AuthKey,ContinuationTokenKey,InitiatorAuthKey,SessionIdKey}from"#context/keys.js";import{toChannelLocalContinuationToken}from"#shared/continuation-token.js";function createSession(e,r,i={}){return{id:e,async send(a,o){let s=createDelivery(i),c=sessionCallbackToTurnCaller(o.callback),l={message:serializeUrlFilePartsInMessage(a)};o.context!==void 0&&(l.context=o.context),o.outputSchema!==void 0&&(l.outputSchema=o.outputSchema);let u={auth:o.auth,delivery:s,kind:`send`,payload:l,requestId:i.requestId,turnPolicy:o.turnPolicy??i.turnPolicy??DEFAULT_TURN_POLICY};return await r.dispatchSession({command:c===void 0?u:{...u,caller:c},sessionId:e})},async respond(t,n){if(t.length===0)throw Error(`respond() requires at least one input response.`);let a=sessionCallbackToTurnCaller(n.callback),o=createDelivery(i),s={inputResponses:t};n.context!==void 0&&(s.context=n.context),n.outputSchema!==void 0&&(s.outputSchema=n.outputSchema);let c={auth:n.auth,delivery:o,kind:`send`,payload:s,requestId:i.requestId};return await r.dispatchSession({command:a===void 0?c:{...c,caller:a},sessionId:e})},async cancel(t){return await r.dispatchSession({command:{kind:`cancel`,turnId:t?.turnId},sessionId:e})},async compact(){return await r.dispatchSession({command:{kind:`compact`},sessionId:e})},async clear(){return await r.dispatchSession({command:{kind:`clear`},sessionId:e})},async reset(t){return await r.dispatchSession({command:{kind:`reset`,reason:t?.reason},sessionId:e})},async getEventStream(t){return r.getEventStream(e,t)},async getStreamTailIndex(){return r.getStreamTailIndex(e)}}}function createAttachSessionFn(e,t={}){return n=>createSession(n,e,t)}function createDelivery(t){return t.channelKind!==void 0&&t.channelName!==void 0?createChannelDeliveryMetadata(t):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){return e===void 0?void 0:{callId:e.callId,replyTo:{kind:`callback`,url:e.url},subagentName:e.subagentName}}export{buildSessionHandle,createAttachSessionFn,createSession,sessionCallbackToTurnCaller};
+import{createChannelDeliveryMetadata}from"#channel/delivery-metadata.js";import{serializeUrlFilePartsInMessage}from"#channel/send-input.js";import{DEFAULT_TURN_POLICY}from"#channel/types.js";import{AuthKey,ContinuationTokenKey,InitiatorAuthKey,SessionIdKey}from"#context/keys.js";import{toChannelLocalContinuationToken}from"#shared/continuation-token.js";function createSession(e,r,i={}){return{id:e,async send(a,o){let s=createDelivery(i),c=sessionCallbackToTurnCaller(o.callback),l={message:serializeUrlFilePartsInMessage(a)};o.context!==void 0&&(l.context=o.context),o.outputSchema!==void 0&&(l.outputSchema=o.outputSchema);let u={auth:o.auth,delivery:s,kind:`send`,payload:l,requestId:i.requestId,turnPolicy:o.turnPolicy??i.turnPolicy??DEFAULT_TURN_POLICY};return await r.dispatchSession({command:c===void 0?u:{...u,caller:c},sessionId:e})},async respond(t,n){if(t.length===0)throw Error(`respond() requires at least one input response.`);let a=sessionCallbackToTurnCaller(n.callback),o=createDelivery(i),s={inputResponses:t};n.context!==void 0&&(s.context=n.context),n.outputSchema!==void 0&&(s.outputSchema=n.outputSchema);let c={auth:n.auth,delivery:o,kind:`send`,payload:s,requestId:i.requestId};return await r.dispatchSession({command:a===void 0?c:{...c,caller:a},sessionId:e})},async cancel(t){return await r.dispatchSession({command:{kind:`cancel`,taskId:t?.taskId,turnId:t?.turnId},sessionId:e})},async compact(){return await r.dispatchSession({command:{kind:`compact`},sessionId:e})},async clear(){return await r.dispatchSession({command:{kind:`clear`},sessionId:e})},async reset(t){return await r.dispatchSession({command:{kind:`reset`,reason:t?.reason},sessionId:e})},async getEventStream(t){return r.getEventStream(e,t)},async getStreamTailIndex(){return r.getStreamTailIndex(e)}}}function createAttachSessionFn(e,t={}){return n=>createSession(n,e,t)}function createDelivery(t){return t.channelKind!==void 0&&t.channelName!==void 0?createChannelDeliveryMetadata(t):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){return e===void 0?void 0:{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

@@ -7,6 +7,7 @@ import type { InputRequest, InputResponse } from "#runtime/input/types.js";
 import type { ChannelAdapter } from "#channel/adapter.js";
 import type { AgentLimitsDefinition } from "#shared/agent-definition.js";
 import type { JsonObject } from "#shared/json.js";
+import type { TaskView } from "#tasks/types.js";
 export type { ContextAccessor } from "#context/key.js";
 export type { ChannelInstrumentationProjection } from "#channel/instrumentation.js";
 import type { ChannelInstrumentationProjection } from "#channel/instrumentation.js";
@@ -14,6 +15,8 @@ export type RunSessionLimits = Pick<AgentLimitsDefinition, "maxInputTokensPerSes
 /** Identifies the session turn to cancel. */
 export interface CancelTurnInput {
     readonly sessionId: string;
+    /** Framework task whose queued child deliveries should be discarded. */
+    readonly taskId?: string;
     /** Limits the request to the turn the caller observed. */
     readonly turnId?: string;
 }
@@ -110,11 +113,14 @@ export type EventEmitFn = (event: UnstampedMessageStreamEvent) => Promise<void>;
 export interface TurnCaller {
     readonly callId: string;
     readonly subagentName: string;
+    /** Present when this turn is the executor for a durable background task. */
+    readonly taskId?: string;
     readonly replyTo: {
         readonly kind: "hook";
         readonly token: string;
     } | {
         readonly kind: "callback";
+        readonly token: string;
         readonly url: string;
     };
 }
@@ -135,6 +141,21 @@ export interface DeliverPayload {
     readonly message?: string | UserContent;
     readonly context?: readonly string[];
     readonly outputSchema?: JsonObject;
+    /** Framework-only task envelopes consumed before adapter/model delivery. */
+    readonly task?: {
+        /** Task HITL input-request batches for the parent's pre-model router. */
+        readonly inputRequests?: readonly {
+            readonly hookPayload: SubagentInputRequestHookPayload;
+            readonly taskId: string;
+        }[];
+        /** Task authorization events projected through the parent channel. */
+        readonly authorizationEvents?: readonly {
+            readonly hookPayload: SubagentAuthorizationEventHookPayload;
+            readonly taskId: string;
+        }[];
+        /** Terminal views cached before task-run retention expires. */
+        readonly views?: readonly TaskView[];
+    };
     readonly [key: string]: unknown;
 }
 /** Controls how a channel message interacts with an active turn. */
@@ -149,9 +170,16 @@ export type SessionCommand = {
     readonly payload: DeliverPayload;
     readonly delivery?: ChannelDeliveryMetadata;
     readonly requestId?: string;
+    /**
+     * Replay-stable identity for one task-owned child delivery; lets the
+     * parent inbox dedupe retried durable-step deliveries. See
+     * {@link DeliverHookPayload.taskDeliveryId}.
+     */
+    readonly taskDeliveryId?: string;
     readonly turnPolicy?: TurnPolicy;
 } | {
     readonly kind: "cancel";
+    readonly taskId?: string;
     readonly turnId?: string;
 } | {
     readonly kind: "compact";
@@ -205,6 +233,13 @@ export interface DeliverHookPayload {
     readonly deliveryMetadata?: readonly ChannelDeliveryMetadataEntry[];
     /** Inbound channel request id used only for workflow attributes. */
     readonly requestId?: string;
+    /**
+     * Replay-stable identity for one task-owned child delivery. Task-run steps
+     * derive it from deterministic inputs (task id, event kind, sequence) so the
+     * parent inbox can drop the duplicate when a durable step retries after
+     * `resumeHook` already succeeded.
+     */
+    readonly taskDeliveryId?: string;
     readonly kind: "deliver";
     readonly payloads: readonly DeliverPayload[];
     readonly turnPolicy?: TurnPolicy;
@@ -292,6 +327,7 @@ export type HookPayload = ClearSessionHookPayload | CompactSessionHookPayload |
 export interface SessionCallback {
     readonly callId: string;
     readonly subagentName: string;
+    readonly taskId?: string;
     readonly token: string;
     readonly url: string;
 }
@@ -402,6 +438,11 @@ export interface RunInput {
      * parent depth + 1.
      */
     readonly subagentDepth?: number;
+    /** Framework-owned metadata for a protocol-neutral external invocation. */
+    readonly externalInvocation?: {
+        readonly continuationToken: string;
+        readonly ownerKey: string;
+    };
 }
 export interface DeliverInput {
     /**

package/dist/src/chunks/{use-eve-agent-COmP-H8R.js → use-eve-agent-BbSsu99c.js}

@@ -13,6 +13,7 @@ const EVE_SESSION_COMPACT_ROUTE_PATTERN = `${EVE_SESSION_ROUTE_PATH}/:sessionId/
 const EVE_SESSION_CLEAR_ROUTE_PATTERN = `${EVE_SESSION_ROUTE_PATH}/:sessionId/clear`;
 const EVE_SESSION_RESET_ROUTE_PATTERN = `${EVE_SESSION_ROUTE_PATH}/:sessionId/reset`;
 const EVE_SESSION_STREAM_ROUTE_PATTERN = `${EVE_SESSION_ROUTE_PATH}/:sessionId/stream`;
+const EVE_SUBAGENT_STREAM_ROUTE_PATTERN = `${EVE_SESSION_ROUTE_PATH}/:parentSessionId/subagents/:callId/:childSessionId/stream`;
 const EVE_DEV_DISPATCH_SCHEDULE_ROUTE_PATTERN = `${EVE_ROUTE_PREFIX}/dev/schedules/:scheduleId`;
 const EVE_DEV_RUNTIME_ARTIFACTS_ROUTE_PATH = `${EVE_ROUTE_PREFIX}/dev/runtime-artifacts`;
 const EVE_DEV_RUNTIME_ARTIFACTS_REBUILD_ROUTE_PATH = `${EVE_DEV_RUNTIME_ARTIFACTS_ROUTE_PATH}/rebuild`;
@@ -21,6 +22,7 @@ const EVE_DEV_RUNTIME_ARTIFACTS_RESUME_ROUTE_PATH = `${EVE_DEV_RUNTIME_ARTIFACTS
 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`;
 function createEveSessionRoutePath(sessionId) {
 	return `${EVE_SESSION_ROUTE_PATH}/${encodeURIComponent(sessionId)}`;
 }
@@ -450,12 +452,27 @@ function isFinalMessageCompleted(event) {
 //#region src/client/message-response.ts
 var MessageResponse = class {
 	sessionId;
+	#cancelTurn;
+	#cancellation;
 	#consumed = false;
 	#createStream;
+	#settled = false;
+	#turnId = Promise.withResolvers();
 	constructor(input) {
+		this.#cancelTurn = input.cancelTurn;
 		this.sessionId = input.sessionId;
 		this.#createStream = input.createStream;
 	}
+	cancel() {
+		if (this.#settled) return Promise.resolve({ status: "no_active_turn" });
+		if (this.#cancellation !== void 0) return this.#cancellation;
+		const cancellation = this.#turnId.promise.then((turnId) => turnId === void 0 ? { status: "no_active_turn" } : this.#cancelTurn(turnId));
+		this.#cancellation = cancellation;
+		cancellation.catch(() => {
+			if (!this.#settled && this.#cancellation === cancellation) this.#cancellation = void 0;
+		});
+		return cancellation;
+	}
 	async result() {
 		const events = [];
 		for await (const event of this) events.push(event);
@@ -472,7 +489,21 @@ var MessageResponse = class {
 	[Symbol.asyncIterator]() {
 		if (this.#consumed) throw new Error("MessageResponse has already been consumed.");
 		this.#consumed = true;
-		return this.#createStream();
+		return this.#observeStream();
+	}
+	async *#observeStream() {
+		try {
+			for await (const event of this.#createStream()) {
+				if (event.type === "turn.started") this.#turnId.resolve(event.data.turnId);
+				else if (isCurrentTurnBoundaryEvent(event)) {
+					this.#settled = true;
+					this.#turnId.resolve(void 0);
+				}
+				yield event;
+			}
+		} finally {
+			this.#turnId.resolve(void 0);
+		}
 	}
 };
 
@@ -651,7 +682,7 @@ async function* followStreamIterable(input) {
 			if (!isStreamDisconnectError(error)) throw error;
 		}
 		if (input.signal?.aborted || input.startIndex < 0 || idleRetryPolicy.maxAttempts === 0) return;
-		if (!deliveredEvent && !initialConnection && (idleReconnects += 1) >= idleRetryPolicy.maxAttempts) return;
+		if (input.keepAlive !== true && !deliveredEvent && !initialConnection && (idleReconnects += 1) >= idleRetryPolicy.maxAttempts) return;
 		initialConnection = false;
 		await sleep(reconnectDelayMs, input.signal);
 		if (input.signal?.aborted) return;
@@ -1025,6 +1056,7 @@ var ClientSession = class ClientSession {
 	#messageResponse(response, input, initialStreamIndex) {
 		response.body?.cancel().catch(() => {});
 		return new MessageResponse({
+			cancelTurn: async (turnId) => await this.cancel({ turnId }),
 			createStream: () => this.#createEventStream(initialStreamIndex, input),
 			sessionId: this.#state.sessionId
 		});
@@ -1034,6 +1066,7 @@ var ClientSession = class ClientSession {
 		try {
 			for await (const event of this.#readStream({
 				headers: input.headers,
+				keepAlive: shouldKeepActiveTurnAlive(input.streamReconnectPolicy),
 				signal: input.signal,
 				startIndex: initialStreamIndex,
 				streamReconnectPolicy: input.streamReconnectPolicy
@@ -1073,6 +1106,7 @@ var ClientSession = class ClientSession {
 		return followStreamIterable({
 			follow: input.follow,
 			host: this.#context.host,
+			keepAlive: input.keepAlive,
 			resolveHeaders: () => this.#context.resolveHeaders(input.headers),
 			redirect: this.#context.redirect,
 			sessionId: this.#state.sessionId,
@@ -1082,6 +1116,10 @@ var ClientSession = class ClientSession {
 		});
 	}
 };
+function shouldKeepActiveTurnAlive(policy) {
+	if (policy && "reconnect" in policy) return false;
+	return policy?.streamIdleReconnectPolicy?.maxAttempts === void 0;
+}
 async function postTurn(context, path, input, requireMessage) {
 	const body = createMessageBody(input, requireMessage);
 	if (body === null) throw new Error(requireMessage ? "Creating a session requires a non-empty message." : "A session turn requires a non-empty message or inputResponses.");
@@ -1266,6 +1304,7 @@ function createEventDeduper() {
 
 //#endregion
 //#region src/client/eve-agent-store.ts
+const detachStore = Symbol("detachEveAgentStore");
 var EveAgentStore = class {
 	#client;
 	#externalSession;
@@ -1273,12 +1312,11 @@ var EveAgentStore = class {
 	#reducer;
 	#subscribers = /* @__PURE__ */ new Set();
 	#seenEvents = createEventDeduper();
-	#abortController;
+	#activeTurn;
 	#callbacks = {};
 	#data;
 	#error;
 	#events;
-	#operationId = 0;
 	#pendingMessageSubmission;
 	#projectionEvents;
 	#session;
@@ -1315,27 +1353,33 @@ var EveAgentStore = class {
 	}
 	async send(input) {
 		if (this.#status === "streaming" || this.#status === "submitted") throw new Error("eve session is already processing a turn.");
-		const operationId = this.#startOperation();
-		const abortController = new AbortController();
-		this.#abortController = abortController;
+		const response = Promise.withResolvers();
+		const turn = {
+			abortController: new AbortController(),
+			response: response.promise,
+			resolveResponse: response.resolve
+		};
+		this.#activeTurn = turn;
 		this.#error = void 0;
 		this.#status = "submitted";
 		this.#publish();
 		try {
 			const preparedInput = await this.#callbacks.prepareSend?.(input) ?? input;
 			assertExclusiveTurnInput(preparedInput);
-			if (!this.#isCurrentOperation(operationId)) return;
+			if (!this.#isActiveTurn(turn)) return;
 			this.#projectOptimisticMessage(preparedInput);
 			this.#projectInputResponses(preparedInput);
 			this.#publish();
 			const turnInput = {
 				...preparedInput,
-				signal: createAbortSignal(preparedInput.signal, abortController.signal)
+				signal: createAbortSignal(preparedInput.signal, turn.abortController.signal)
 			};
 			const response = await this.#dispatchTurn(turnInput);
+			if (!this.#isActiveTurn(turn)) return;
+			turn.resolveResponse(response);
 			let sawEvent = false;
 			for await (const event of response) {
-				if (!this.#isCurrentOperation(operationId)) return;
+				if (!this.#isActiveTurn(turn)) return;
 				if (!sawEvent) {
 					sawEvent = true;
 					this.#status = "streaming";
@@ -1347,10 +1391,10 @@ var EveAgentStore = class {
 				this.#applyTerminalStreamFailure(event);
 				this.#publish();
 			}
-			if (!this.#isCurrentOperation(operationId)) return;
+			if (!this.#isActiveTurn(turn)) return;
 			this.#status = this.#error === void 0 ? "ready" : "error";
 		} catch (error) {
-			if (!this.#isCurrentOperation(operationId)) return;
+			if (!this.#isActiveTurn(turn)) return;
 			if (isAbortError(error)) {
 				this.#status = "ready";
 				this.#failPendingMessageSubmission(toError(error));
@@ -1361,21 +1405,28 @@ var EveAgentStore = class {
 				this.#callbacks.onError?.(this.#error);
 			}
 		} finally {
-			if (this.#isCurrentOperation(operationId)) {
-				this.#abortController = void 0;
+			if (this.#isActiveTurn(turn)) {
+				turn.resolveResponse(void 0);
+				this.#activeTurn = void 0;
 				this.#callbacks.onSessionChange?.(this.#session?.state);
 				this.#publish();
 				this.#callbacks.onFinish?.(this.#snapshot);
 			}
 		}
 	}
-	stop() {
-		this.#abortController?.abort();
+	cancel() {
+		const turn = this.#activeTurn;
+		if (turn === void 0) return Promise.resolve({ status: "no_active_turn" });
+		return turn.response.then((response) => response === void 0 ? { status: "no_active_turn" } : response.cancel());
+	}
+	[detachStore]() {
+		this.#activeTurn?.abortController.abort();
 	}
 	reset() {
-		this.#invalidateOperation();
-		this.stop();
-		this.#abortController = void 0;
+		const turn = this.#activeTurn;
+		this.#activeTurn = void 0;
+		turn?.resolveResponse(void 0);
+		turn?.abortController.abort();
 		if (!this.#externalSession) this.#session = void 0;
 		this.#events = [];
 		this.#seenEvents = createEventDeduper();
@@ -1408,15 +1459,8 @@ var EveAgentStore = class {
 		const { inputResponses, ...options } = input;
 		return await this.#session.respond(inputResponses, options);
 	}
-	#startOperation() {
-		this.#operationId += 1;
-		return this.#operationId;
-	}
-	#invalidateOperation() {
-		this.#operationId += 1;
-	}
-	#isCurrentOperation(operationId) {
-		return this.#operationId === operationId;
+	#isActiveTurn(turn) {
+		return this.#activeTurn === turn;
 	}
 	#projectOptimisticMessage(input) {
 		if (!this.#optimistic || input.message === void 0) return;
@@ -1514,6 +1558,9 @@ var EveAgentStore = class {
 		for (const subscriber of this.#subscribers) subscriber();
 	}
 };
+function detachEveAgentStore(store) {
+	store[detachStore]();
+}
 function assertExclusiveTurnInput(input) {
 	if (input.message !== void 0 === (input.inputResponses !== void 0)) throw new Error("A turn requires exactly one of message or inputResponses.");
 }
@@ -2121,7 +2168,7 @@ var SvelteEveAgent = class {
 			});
 			return () => {
 				unsubscribe();
-				store.stop();
+				detachEveAgentStore(store);
 			};
 		});
 	}
@@ -2145,6 +2192,9 @@ var SvelteEveAgent = class {
 		this.#subscribe();
 		return this.#snapshot.status;
 	}
+	cancel = () => {
+		return this.#store.cancel();
+	};
 	reset = () => {
 		this.#store.reset();
 	};
@@ -2160,9 +2210,6 @@ var SvelteEveAgent = class {
 			message
 		});
 	};
-	stop = () => {
-		this.#store.stop();
-	};
 };
 function useEveAgent(options = {}) {
 	const reducer = options.reducer ?? defaultMessageReducer();