eve 0.83.2 → 0.84.0

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

@@ -1 +1 @@
-import{createSession,sessionCallbackToTurnCaller}from"#channel/session.js";import{validateDeliveryIdempotencyKey}from"#channel/delivery-idempotency.js";import{createChannelDeliveryMetadata}from"#channel/delivery-metadata.js";import{normalizeSendInput,serializeFilePartsInMessage}from"#channel/send-input.js";import{SessionNotActiveError}from"#channel/session-not-active-error.js";import{SessionStrandedError,describeStrandedSession}from"#channel/session-stranded-error.js";import{DEFAULT_TURN_POLICY}from"#channel/types.js";import{isReservedSessionCommandToken}from"#execution/session-inbox/address.js";import{validateSessionHistory}from"#shared/session-history.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){validateDeliveryIdempotencyKey(i.idempotencyKey);let a=t.channelKind!==void 0&&t.channelName!==void 0?createChannelDeliveryMetadata(t):void 0,o=withValidatedHistory(normalizeSendInput(r)),s=sessionCallbackToTurnCaller(i.callback),c={idempotencyKey:i.idempotencyKey,auth:i.auth,delivery:a,kind:`send`,payload:{...o,message:serializeFilePartsInMessage(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=i.state,d=u===void 0?e.adapter:{...e.adapter,state:{...e.adapter.state,...u}},f={idempotencyKey:i.idempotencyKey,adapter:d,auth:i.auth,capabilities:{requestInput:!0},callback:i.callback,channelName:e.channelName,continuationConflictCommand:l,continuationToken:n,delivery:a,initiatorAuth:i.initiatorAuth,input:{context:o.context,history:o.history,message:serializeFilePartsInMessage(o.message)??``,outputSchema:o.outputSchema,state:o.state},requestId:t.requestId,title:i.title},toSession=n=>createSession(n,e.runtime,{...t,turnPolicy:e.turnPolicy}),p=await e.runtime.dispatchContinuation({command:l,continuationToken:n,successor:f});if(p.status===`accepted`)return toSession(p.sessionId);if(o.inputResponses&&o.inputResponses.length>0)throw new SessionNotActiveError;return toSession((await e.runtime.createSession(f)).sessionId)},async create(r){let i=validateSessionHistory(r.history),toSession=n=>createSession(n,e.runtime,{...t,turnPolicy:e.turnPolicy}),a;try{a=await e.runtime.resolveContinuation(n,{runnable:!0})}catch(e){throw SessionStrandedError.is(e)?new SessionStrandedError(e.owner,describeStrandedSession(e.owner,`Call reset() on the address, then create() again to start a session from your history.`)):e}if(a!==void 0)return{created:!1,session:toSession(a.sessionId)};let o=r.state,s=await e.runtime.createSession({adapter:o===void 0?e.adapter:{...e.adapter,state:{...e.adapter.state,...o}},auth:r.auth,capabilities:{requestInput:!0},channelName:e.channelName,continuationToken:n,initiatorAuth:r.initiatorAuth,input:i===void 0?{}:{history:i},requestId:t.requestId,title:r.title}),c=await waitForContinuationOwner(e.runtime,n,s.sessionId);return{created:c.sessionId===s.sessionId,session:toSession(c.sessionId)}},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})}function withValidatedHistory(e){let{history:t,...n}=e,r=validateSessionHistory(t);return r===void 0?n:{...n,history:r}}const CREATE_CLAIM_TIMEOUT_MS=15e3;async function waitForContinuationOwner(e,t,n){let r=Date.now()+CREATE_CLAIM_TIMEOUT_MS;for(let i=25;;i=Math.min(i*2,500)){let a=await e.resolveContinuation(t);if(a!==void 0)return a;if(Date.now()+i>r)throw Error(`create() started session "${n}" for "${t}", but no session claimed the address within ${CREATE_CLAIM_TIMEOUT_MS/1e3}s. Call resolveSession() on the address to find its owner once one does.`);await new Promise(e=>setTimeout(e,i))}}export{createChannelAddress,createChannelAddressFn};
+import{createSession,sessionCallbackToTurnCaller}from"#channel/session.js";import{commandDelivery}from"#channel/delivery.js";import{validateDeliveryIdempotencyKey}from"#channel/delivery-idempotency.js";import{createChannelDeliveryMetadata}from"#channel/delivery-metadata.js";import{normalizeSendInput,serializeFilePartsInMessage}from"#channel/send-input.js";import{SessionNotActiveError}from"#channel/session-not-active-error.js";import{SessionStrandedError,describeStrandedSession}from"#channel/session-stranded-error.js";import{DEFAULT_TURN_POLICY,controlCommand}from"#channel/types.js";import{isReservedSessionCommandToken}from"#execution/session-inbox/address.js";import{validateSessionHistory}from"#shared/session-history.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){validateDeliveryIdempotencyKey(i.idempotencyKey);let a=createChannelDeliveryMetadata({channelKind:`channel:${e.channelName}`,channelName:e.channelName,...t}),o=withValidatedHistory(normalizeSendInput(r)),s=sessionCallbackToTurnCaller(i.callback),c={idempotencyKey:i.idempotencyKey,auth:i.auth,delivery:a,kind:`send`,payload:{...o,message:serializeFilePartsInMessage(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=i.state,d=u===void 0?e.adapter:{...e.adapter,state:{...e.adapter.state,...u}},f={idempotencyKey:i.idempotencyKey,adapter:d,auth:i.auth,capabilities:{requestInput:!0},callback:i.callback,channelName:e.channelName,continuationConflictCommand:l,continuationToken:n,delivery:a,initiatorAuth:i.initiatorAuth,input:{context:o.context,history:o.history,message:serializeFilePartsInMessage(o.message)??``,outputSchema:o.outputSchema,state:o.state},requestId:t.requestId,title:i.title},p=await e.runtime.dispatchContinuation({command:l,continuationToken:n,successor:f});if(p.status===`accepted`)return commandDelivery(e.runtime,p,a.deliveryId);if(p.retryable===!0)throw new SessionNotActiveError({retryable:!0});if(o.answers&&o.answers.length>0)throw new SessionNotActiveError;let m=await e.runtime.createSession(f);return commandDelivery(e.runtime,{status:`accepted`,sessionId:m.sessionId},a.deliveryId)},async create(r){let i=validateSessionHistory(r.history),toSession=n=>createSession(n,e.runtime,{...t,turnPolicy:e.turnPolicy}),a;try{a=await e.runtime.resolveContinuation(n,{runnable:!0})}catch(e){throw SessionStrandedError.is(e)?new SessionStrandedError(e.owner,describeStrandedSession(e.owner,`Call reset() on the address, then create() again to start a session from your history.`)):e}if(a!==void 0)return{created:!1,session:toSession(a.sessionId)};let o=r.state,s=await e.runtime.createSession({adapter:o===void 0?e.adapter:{...e.adapter,state:{...e.adapter.state,...o}},auth:r.auth,capabilities:{requestInput:!0},channelName:e.channelName,continuationToken:n,initiatorAuth:r.initiatorAuth,input:i===void 0?{}:{history:i},requestId:t.requestId,title:r.title}),c=await waitForContinuationOwner(e.runtime,n,s.sessionId);return{created:c.sessionId===s.sessionId,session:toSession(c.sessionId)}},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 answer.`);return await this.deliver({answers:e},t)},async cancel(t){let r=controlCommand({kind:`cancel`,turnId:t?.turnId},t),i=await e.runtime.dispatchContinuation({command:r,continuationToken:n});return commandDelivery(e.runtime,i,r.deliveryId)},async compact(t){let r=controlCommand({kind:`compact`},t),i=await e.runtime.dispatchContinuation({command:r,continuationToken:n});return commandDelivery(e.runtime,i,r.deliveryId)},async clear(t){let r=controlCommand({kind:`clear`},t),i=await e.runtime.dispatchContinuation({command:r,continuationToken:n});return commandDelivery(e.runtime,i,r.deliveryId)},async reset(t){let r=controlCommand({kind:`reset`,reason:t?.reason},t),i=await e.runtime.dispatchContinuation({command:r,continuationToken:n});return commandDelivery(e.runtime,i,r.deliveryId,{follow:!1})},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})}function withValidatedHistory(e){let{history:t,...n}=e,r=validateSessionHistory(t);return r===void 0?n:{...n,history:r}}const CREATE_CLAIM_TIMEOUT_MS=15e3;async function waitForContinuationOwner(e,t,n){let r=Date.now()+CREATE_CLAIM_TIMEOUT_MS;for(let i=25;;i=Math.min(i*2,500)){let a=await e.resolveContinuation(t);if(a!==void 0)return a;if(Date.now()+i>r)throw Error(`create() started session "${n}" for "${t}", but no session claimed the address within ${CREATE_CLAIM_TIMEOUT_MS/1e3}s. Call resolveSession() on the address to find its owner once one does.`);await new Promise(e=>setTimeout(e,i))}}export{createChannelAddress,createChannelAddressFn};

package/dist/src/channel/channel-operations.d.ts

@@ -1,59 +1,56 @@
-import type { UserContent } from "ai";
+import type { MessageContent } from "#shared/message-content.js";
+import type { Delivery } from "#shared/delivery.js";
 import type { ChannelAdapter } from "#channel/adapter.js";
 import type { ChannelDeliverySource } from "#channel/delivery-metadata.js";
 import { type ChannelCreateResult } from "#channel/channel-address.js";
 export type { ChannelCreateResult } from "#channel/channel-address.js";
 import type { Session } from "#channel/session.js";
-import type { CancelTurnResult, ClearSessionResult, CompactSessionResult, ResetSessionResult, Runtime, SessionAuthContext, SessionCallback, TurnPolicy } from "#channel/types.js";
-import { type InputResponse, type StrictInputResponses } from "#shared/input.js";
+import type { Runtime, SessionAuthContext, TurnPolicy, SessionControlOptions } from "#channel/types.js";
+import { type Answer, type StrictAnswers } from "#shared/input.js";
 import type { JsonObject } from "#shared/json.js";
 import type { SessionHistoryMessage } from "#shared/session-history.js";
 interface BaseChannelSendOptions {
     /** Stable delivery identity, deduplicated within this session's recent-key window. */
     readonly idempotencyKey?: string;
-    readonly auth: SessionAuthContext | null;
-    readonly callback?: SessionCallback;
-    readonly context?: readonly string[];
     /**
      * Prior conversation added as user and assistant turns before this
      * message and its `context`. Seeds a session this send creates, or
      * extends the history of the session that owns the address.
      */
     readonly history?: readonly SessionHistoryMessage[];
-    readonly initiatorAuth?: SessionAuthContext | null;
+    readonly auth: SessionAuthContext | null;
+    readonly context?: readonly string[];
     /** JSON Schema for a structured final answer, as on `Session.send()`. */
     readonly outputSchema?: JsonObject;
     readonly title?: string;
     readonly turnPolicy?: TurnPolicy;
 }
 /** Options for sending a message from a channel-local continuation address. */
-export type ChannelSendOptions<TState = undefined> = [TState] extends [undefined] ? BaseChannelSendOptions : BaseChannelSendOptions & {
-    readonly state: TState;
+export type ChannelSendOptions<TState = undefined> = BaseChannelSendOptions & {
+    readonly state?: Partial<TState>;
 };
 interface BaseChannelRespondOptions<TState = undefined> {
     /** Stable delivery identity, with the same scope and retention as `send()`. */
     readonly idempotencyKey?: string;
     readonly auth: SessionAuthContext | null;
+    readonly outputSchema?: JsonObject;
     readonly context?: readonly string[];
     readonly state?: Partial<TState>;
 }
 /** Options for answering pending input requests at an existing continuation address. */
 export type ChannelRespondOptions<TState = undefined> = BaseChannelRespondOptions<TState>;
-interface BaseChannelCreateOptions {
+/** Options for creating a session at a channel-local address without running a turn. */
+export type ChannelCreateOptions<TState = undefined> = {
     readonly auth: SessionAuthContext | null;
     /** Prior conversation the session starts with; it joins history with the first message. */
     readonly history?: readonly SessionHistoryMessage[];
     readonly initiatorAuth?: SessionAuthContext | null;
     readonly title?: string;
-}
-/** Options for creating a session at a channel-local address without running a turn. */
-export type ChannelCreateOptions<TState = undefined> = [TState] extends [undefined] ? BaseChannelCreateOptions : BaseChannelCreateOptions & {
+} & ([TState] extends [undefined] ? unknown : {
     readonly state: TState;
-};
+});
 /** Dynamic handle for whichever session currently owns one channel-local address. */
 export interface ChannelSource<TState = undefined> {
-    /** Starts or resumes a turn with a user message. May create a session. */
-    send(message: string | UserContent, options: ChannelSendOptions<TState>): Promise<Session>;
     /**
      * Creates a session that waits for its first message, without running a
      * turn. When another session owns the address, or claims it concurrently,
@@ -62,20 +59,22 @@ export interface ChannelSource<TState = undefined> {
      * address, then create again.
      */
     create(options: ChannelCreateOptions<TState>): Promise<ChannelCreateResult>;
+    /** Starts or resumes a turn with a user message. May create a session. */
+    send(message: MessageContent, options: ChannelSendOptions<TState>): Promise<Delivery>;
     /** Answers pending input requests. Never creates a session. */
-    respond<const TResponses extends readonly InputResponse[]>(inputResponses: StrictInputResponses<TResponses>, options: ChannelRespondOptions<TState>): Promise<Session>;
+    respond<const TResponses extends readonly Answer[]>(answers: StrictAnswers<TResponses>, options: ChannelRespondOptions<TState>): Promise<Delivery>;
     /** Cooperatively cancels the active turn without creating a session. */
     cancel(options?: {
-        readonly turnId?: string;
-    }): Promise<CancelTurnResult>;
+        readonly turnId?: string | null;
+    } & SessionControlOptions): Promise<Delivery>;
     /** Queues context compaction without creating a session. */
-    compact(): Promise<CompactSessionResult>;
+    compact(options?: SessionControlOptions): Promise<Delivery>;
     /** Clears model-message history without creating a session. */
-    clear(): Promise<ClearSessionResult>;
+    clear(options?: SessionControlOptions): Promise<Delivery>;
     /** Retires the current owner without creating a replacement. */
     reset(options?: {
         readonly reason?: string;
-    }): Promise<ResetSessionResult>;
+    } & SessionControlOptions): Promise<Delivery>;
 }
 /** Binds a raw channel-local continuation address to its current-owner operations. */
 export type ChannelFrom<TState = undefined> = (address: string) => ChannelSource<TState>;

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

@@ -1 +1 @@
-import{attachInputText,readInputText}from"#internal/input-text.js";import{createChannelAddressFn}from"#channel/channel-address.js";import{parseInputResponses}from"#shared/input.js";function createChannelOperations(e){let t=createChannelAddressFn(e);return{from(e){let n=t(e);return{async send(e,t){return await n.deliver(attachInputText({context:t.context,history:t.history,message:e,outputSchema:t.outputSchema,state:t.state},readInputText(t)),t)},async create(e){return await n.create(e)},async respond(e,t){if(e.length===0)throw Error(`respond() requires at least one input response.`);let r=parseInputResponses(e);return await n.deliver({context:t.context,inputResponses:r,state:t.state},t)},async cancel(e){return await n.cancel(e)},async compact(){return await n.compact()},async clear(){return await n.clear()},async reset(e){return await n.reset(e)}}},async resolveSession(e){return await t(e).resolveSession()}}}export{createChannelOperations};
+import{attachInputText,readInputText}from"#internal/input-text.js";import{createChannelAddressFn}from"#channel/channel-address.js";import{parseAnswers}from"#shared/input.js";function createChannelOperations(e){let t=createChannelAddressFn(e);return{from(e){let n=t(e);return{async send(e,t){return await n.deliver(attachInputText({context:t.context,history:t.history,message:e,outputSchema:t.outputSchema,state:t.state},readInputText(t)),t)},async create(e){return await n.create(e)},async respond(e,t){if(e.length===0)throw Error(`respond() requires at least one answer.`);let r=parseAnswers(e);return await n.deliver({context:t.context,outputSchema:t.outputSchema,answers:r,state:t.state},t)},async cancel(e){return await n.cancel(e)},async compact(e){return await n.compact(e)},async clear(e){return await n.clear(e)},async reset(e){return await n.reset(e)}}},async resolveSession(e){return await t(e).resolveSession()}}}export{createChannelOperations};

package/dist/src/channel/compiled-channel.d.ts

@@ -1,10 +1,10 @@
 import type { ChannelAdapter } from "#channel/adapter.js";
-import type { UserContent } from "ai";
+import type { MessageContent } from "#shared/message-content.js";
 import type { ChannelReceiveContext } from "#channel/channel-operations.js";
 import type { NormalizedChannelCorsOptions } from "#channel/cors.js";
 import type { TypedReceiveTarget } from "#channel/receive-target.js";
 import type { RouteDefinition } from "#channel/routes.js";
-import type { Session } from "#channel/session.js";
+import type { Delivery } from "#shared/delivery.js";
 import type { SessionAuthContext, TurnPolicy } from "#channel/types.js";
 import type { JsonObject } from "#shared/json.js";
 export declare const CHANNEL_SENTINEL: "eve:channel";
@@ -23,10 +23,10 @@ export interface CompiledChannel<TState = undefined, TReceiveTarget = Record<str
     readonly cors?: NormalizedChannelCorsOptions;
     readonly __metadata?: TMetadata;
     readonly receive?: (input: {
-        readonly message: string | UserContent;
+        readonly message: MessageContent;
         readonly target: Readonly<TReceiveTarget>;
         readonly auth: SessionAuthContext | null;
-    }, ctx: ChannelReceiveContext<TState>) => Promise<Session>;
+    }, ctx: ChannelReceiveContext<TState>) => Promise<Delivery>;
     readonly turnPolicy?: TurnPolicy;
 }
 export declare function isCompiledChannel(value: unknown): value is CompiledChannel;

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,caller:toAudienceCaller(n),channel:i,environment:t});return{...resolveConversationContext(void 0,{channelKind:r.kind,environment:t,forwardedTracePolicy:o,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};
+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,caller:toAudienceCaller(n),channel:i,environment:t});return{...resolveConversationContext(void 0,{channelKind:r.kind,environment:t,forwardedTracePolicy:o,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/cors.d.ts

@@ -7,9 +7,9 @@
 export interface ChannelCorsOptions {
     /**
      * Allowed request origins. Omit or pass `"*"` for all origins, pass
-     * `"null"` for the literal `null` origin, or pass an array of exact origins.
+     * `"null"` for the literal `null` origin, or pass one exact origin or an array of exact origins.
      */
-    readonly origin?: "*" | "null" | readonly string[];
+    readonly origin?: string | readonly string[];
     /** Methods emitted on preflight responses. Omit or pass `"*"` for all methods. */
     readonly methods?: "*" | readonly string[];
     /**

package/dist/src/channel/cors.js

@@ -1 +1 @@
-function normalizeChannelCors(e){if(e===void 0||e===!1)return;if(e===!0)return{};if(typeof e!=`object`||!e||Array.isArray(e))throw Error(`Expected channel cors to be a boolean or a serializable CORS options object.`);let t={};if(e.origin!==void 0&&(t.origin=normalizeOrigin(e.origin)),e.methods!==void 0&&(t.methods=normalizeWildcardOrStringList(e.methods,`methods`)),e.allowHeaders!==void 0&&(t.allowHeaders=normalizeWildcardOrStringList(e.allowHeaders,`allowHeaders`)),e.exposeHeaders!==void 0&&(t.exposeHeaders=normalizeWildcardOrStringList(e.exposeHeaders,`exposeHeaders`)),e.credentials!==void 0){if(typeof e.credentials!=`boolean`)throw Error(`Expected channel cors.credentials to be a boolean.`);t.credentials=e.credentials}return e.maxAge!==void 0&&(t.maxAge=normalizeMaxAge(e.maxAge)),e.preflight!==void 0&&(t.preflight=normalizePreflight(e.preflight)),t}function normalizeOrigin(e){if(e===`*`||e===`null`)return e;if(!Array.isArray(e))throw Error(`Expected channel cors.origin to be "*", "null", or an array of origins.`);return e.map(e=>{if(typeof e!=`string`||e.length===0)throw Error(`Expected channel cors.origin entries to be non-empty strings.`);return e})}function normalizeWildcardOrStringList(e,t){if(e===`*`)return e;if(!Array.isArray(e))throw Error(`Expected channel cors.${t} to be "*" or an array of strings.`);return e.map(e=>{if(typeof e!=`string`||e.length===0)throw Error(`Expected channel cors.${t} entries to be non-empty strings.`);return e})}function normalizeMaxAge(e){if(e===!1)return!1;if(typeof e==`number`){if(!Number.isFinite(e)||e<0)throw Error(`Expected channel cors.maxAge to be a non-negative finite number.`);return String(e)}if(typeof e==`string`&&e.length>0)return e;throw Error(`Expected channel cors.maxAge to be false, a string, or a number.`)}function normalizePreflight(e){if(typeof e!=`object`||!e||Array.isArray(e))throw Error(`Expected channel cors.preflight to be an object.`);let t=e.statusCode;if(t===void 0)return{};if(!Number.isInteger(t)||t<100||t>599)throw Error(`Expected channel cors.preflight.statusCode to be an HTTP status code.`);return{statusCode:t}}export{normalizeChannelCors};
+function normalizeChannelCors(e){if(e===void 0||e===!1)return;if(e===!0)return{};if(typeof e!=`object`||!e||Array.isArray(e))throw Error(`Expected channel cors to be a boolean or a serializable CORS options object.`);assertSupportedCorsKeys(e);let t={};if(e.origin!==void 0&&(t.origin=normalizeOrigin(e.origin)),e.methods!==void 0&&(t.methods=normalizeWildcardOrStringList(e.methods,`methods`)),e.allowHeaders!==void 0&&(t.allowHeaders=normalizeWildcardOrStringList(e.allowHeaders,`allowHeaders`)),e.exposeHeaders!==void 0&&(t.exposeHeaders=normalizeWildcardOrStringList(e.exposeHeaders,`exposeHeaders`)),e.credentials!==void 0){if(typeof e.credentials!=`boolean`)throw Error(`Expected channel cors.credentials to be a boolean.`);t.credentials=e.credentials}return e.maxAge!==void 0&&(t.maxAge=normalizeMaxAge(e.maxAge)),e.preflight!==void 0&&(t.preflight=normalizePreflight(e.preflight)),t}const SUPPORTED_CORS_KEYS=new Set([`origin`,`methods`,`allowHeaders`,`exposeHeaders`,`credentials`,`maxAge`,`preflight`]),RENAMED_CORS_KEYS={allowedHeaders:`allowHeaders`,exposedHeaders:`exposeHeaders`,preflightStatus:`preflight.statusCode`};function assertSupportedCorsKeys(e){for(let t of Object.keys(e)){if(SUPPORTED_CORS_KEYS.has(t))continue;let e=Object.hasOwn(RENAMED_CORS_KEYS,t)?RENAMED_CORS_KEYS[t]:void 0;throw Error(e===void 0?`Unknown channel cors option "${t}". Supported options: ${[...SUPPORTED_CORS_KEYS].join(`, `)}.`:`The channel cors option "${t}" is no longer supported. Use "${e}".`)}}function normalizeOrigin(e){if(e===`*`||e===`null`)return e;if(typeof e==`string`&&e.length>0)return[e];if(!Array.isArray(e))throw Error(`Expected channel cors.origin to be a non-empty origin string or an array of origins.`);return e.map(e=>{if(typeof e!=`string`||e.length===0)throw Error(`Expected channel cors.origin entries to be non-empty strings.`);return e})}function normalizeWildcardOrStringList(e,t){if(e===`*`)return e;if(!Array.isArray(e))throw Error(`Expected channel cors.${t} to be "*" or an array of strings.`);return e.map(e=>{if(typeof e!=`string`||e.length===0)throw Error(`Expected channel cors.${t} entries to be non-empty strings.`);return e})}function normalizeMaxAge(e){if(e===!1)return!1;if(typeof e==`number`){if(!Number.isFinite(e)||e<0)throw Error(`Expected channel cors.maxAge to be a non-negative finite number.`);return String(e)}if(typeof e==`string`&&e.length>0)return e;throw Error(`Expected channel cors.maxAge to be false, a string, or a number.`)}function normalizePreflight(e){if(typeof e!=`object`||!e||Array.isArray(e))throw Error(`Expected channel cors.preflight to be an object.`);let t=e.statusCode;if(t===void 0)return{};if(!Number.isInteger(t)||t<100||t>599)throw Error(`Expected channel cors.preflight.statusCode to be an HTTP status code.`);return{statusCode:t}}export{normalizeChannelCors};

package/dist/src/channel/cross-channel-receive.d.ts

@@ -1,8 +1,8 @@
-import type { UserContent } from "ai";
+import type { MessageContent } from "#shared/message-content.js";
 import type { ChannelAdapter } from "#channel/adapter.js";
 import { type ChannelReference, type CompiledChannel } from "#channel/compiled-channel.js";
 import type { InferReceiveTarget } from "#channel/receive-target.js";
-import type { Session } from "#channel/session.js";
+import type { Delivery } from "#shared/delivery.js";
 import type { Runtime, SessionAuthContext, TurnPolicy } from "#channel/types.js";
 import type { ResolvedChannelDefinition } from "#runtime/types.js";
 /**
@@ -14,7 +14,7 @@ interface CrossChannelSendOptions {
 }
 /** Message delivery bound to one channel-specific proactive target. */
 export interface CrossChannelTargetHandle {
-    send(message: string | UserContent, options: CrossChannelSendOptions): Promise<Session>;
+    send(message: MessageContent, options: CrossChannelSendOptions): Promise<Delivery>;
 }
 /** Selects another authored channel and one of its proactive targets. */
 export type CrossChannelToFn = <TChannel extends ChannelReference<unknown>>(channel: TChannel, target: InferReceiveTarget<TChannel>) => CrossChannelTargetHandle;

package/dist/src/channel/delivery-idempotency.d.ts

@@ -2,3 +2,9 @@
 export declare const DELIVERY_IDEMPOTENCY_WINDOW = 1024;
 export declare const MAX_DELIVERY_IDEMPOTENCY_KEY_LENGTH = 256;
 export declare function validateDeliveryIdempotencyKey(key: unknown): asserts key is string | undefined;
+/**
+ * The delivery id a caller's idempotency key names, so a repeated request is the same delivery
+ * with the same receipt. UUID-shaped, like the ids the framework mints; within one session, keys
+ * name distinct deliveries.
+ */
+export declare function deliveryIdForIdempotencyKey(key: string): Promise<string>;

package/dist/src/channel/delivery-idempotency.js

@@ -1 +1 @@
-const DELIVERY_IDEMPOTENCY_WINDOW=1024,MAX_DELIVERY_IDEMPOTENCY_KEY_LENGTH=256;function validateDeliveryIdempotencyKey(e){if(e!==void 0&&(typeof e!=`string`||e.length===0||e.length>256))throw Error(`idempotencyKey must be a nonempty string of at most 256 characters.`)}export{DELIVERY_IDEMPOTENCY_WINDOW,MAX_DELIVERY_IDEMPOTENCY_KEY_LENGTH,validateDeliveryIdempotencyKey};
+const DELIVERY_IDEMPOTENCY_WINDOW=1024,MAX_DELIVERY_IDEMPOTENCY_KEY_LENGTH=256;function validateDeliveryIdempotencyKey(e){if(e!==void 0&&(typeof e!=`string`||e.length===0||e.length>256))throw Error(`idempotencyKey must be a nonempty string of at most 256 characters.`)}async function deliveryIdForIdempotencyKey(e){let t=new Uint8Array(await crypto.subtle.digest(`SHA-256`,new TextEncoder().encode(`eve:delivery:${e}`)));t[6]=t[6]&15|128,t[8]=t[8]&63|128;let n=Array.from(t.subarray(0,16),e=>e.toString(16).padStart(2,`0`)).join(``);return`${n.slice(0,8)}-${n.slice(8,12)}-${n.slice(12,16)}-${n.slice(16,20)}-${n.slice(20,32)}`}export{DELIVERY_IDEMPOTENCY_WINDOW,MAX_DELIVERY_IDEMPOTENCY_KEY_LENGTH,deliveryIdForIdempotencyKey,validateDeliveryIdempotencyKey};

package/dist/src/channel/delivery-metadata.d.ts

@@ -1,10 +1,10 @@
-import type { ChannelDeliveryMetadata, SessionTraceContext } from "#channel/types.js";
+import type { ChannelDeliveryMetadata, SessionTraceSeed } from "#channel/types.js";
 export interface ChannelDeliverySource {
     readonly acceptedDeploymentId?: string;
     readonly channelKind: string;
     readonly channelName: string;
     readonly requestId?: string;
-    readonly requestTraceContext?: SessionTraceContext;
+    readonly requestTraceContext?: SessionTraceSeed;
 }
 /** Mints the opaque identity for one inbound channel operation. */
 export declare function createChannelDeliveryMetadata(source: ChannelDeliverySource): ChannelDeliveryMetadata;

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

@@ -0,0 +1,8 @@
+import type { Runtime, SessionCommand, SessionCommandResult } from "#channel/types.js";
+import type { Delivery } from "#shared/delivery.js";
+/** Turns an accepted internal dispatch into its public, followable receipt. */
+export declare function commandDelivery(runtime: Runtime, result: SessionCommandResult<Exclude<SessionCommand, {
+    readonly kind: "prewarm";
+}>>, deliveryId: string, options?: {
+    readonly follow?: boolean;
+}): Delivery;

package/dist/src/channel/delivery.js

@@ -0,0 +1 @@
+import{SessionNotActiveError}from"#channel/session-not-active-error.js";import{StreamDelivery}from"#client/delivery.js";import{deliveryEvents}from"#client/delivery-events.js";function commandDelivery(e,t,n,r={}){if(t.status!==`accepted`&&t.status!==`reset`)throw new SessionNotActiveError({retryable:`retryable`in t&&t.retryable===!0});let i=t.status===`reset`?t.previousSessionId:t.sessionId;return new StreamDelivery({sessionId:i,deliveryId:n,createStream:async function*(t){yield*deliveryEvents(await e.getEventStream(i,{...r,signal:t?.signal}),n,t?.signal)}})}export{commandDelivery};

package/dist/src/channel/interaction-prompts.d.ts

@@ -0,0 +1,54 @@
+import type { Principal } from "#protocol/session-events/envelope.js";
+import type { InteractionOpenedData, InteractionOutcome, InteractionRequest, InteractionSettledData } from "#protocol/session-events/families/interaction.js";
+import type { ResponseSettledData } from "#protocol/session-events/families/response.js";
+import type { SessionView } from "#protocol/session-projection/tables.js";
+import { type Interaction } from "#protocol/session-projection/reader.js";
+import type { Answer } from "#shared/input.js";
+export { interaction, signInEnding, type Interaction, } from "#protocol/session-projection/reader.js";
+/** One commit's requests: what a person is asked at once. */
+export interface RequestBatch {
+    readonly requests: readonly Interaction[];
+    readonly turnId: string;
+    /** The task whose run asks. */
+    readonly taskId?: string;
+    /** The call a relayed request serves. */
+    readonly callId?: string;
+}
+/** How a request ended, with the answer that decided it and who gave it. */
+export interface RequestSettlement {
+    readonly interactionId: string;
+    readonly kind: InteractionRequest["kind"];
+    readonly outcome: InteractionOutcome;
+    readonly reason?: string;
+    readonly answer?: Answer;
+    /** Who gave the deciding answer, through its delivery. */
+    readonly responder?: Principal;
+}
+/** An answer a check or policy refused, for telling its responder privately. */
+export interface RefusedAnswer {
+    readonly interactionId: string;
+    readonly outcome: "refused" | "failed";
+    readonly reason?: string;
+    readonly responder?: Principal;
+}
+/**
+ * The batch an `interaction.opened` begins: every request its commit opened. The batch's other
+ * facts return `undefined`, so a channel renders it once.
+ */
+export declare function requestBatchOf(view: SessionView, data: InteractionOpenedData): RequestBatch | undefined;
+/**
+ * The request a typed reply answers: the first open one. A budget prompt comes first, since the
+ * session settles it before anything else; the rest follow the order they opened. Channels that
+ * can only show text show this request alone, so a reply answers the request the person sees.
+ */
+export declare function firstOpenRequest(view: SessionView): Interaction | undefined;
+/** How a request ended, from its `interaction.settled`. */
+export declare function requestSettlementOf(view: SessionView, data: InteractionSettledData): RequestSettlement | undefined;
+/** An answer a check or policy refused, from its `response.settled`. */
+export declare function refusedAnswerOf(view: SessionView, data: ResponseSettledData): RefusedAnswer | undefined;
+/** Who gave an answer: the principal of the delivery it arrived in. */
+export declare function responderOf(view: SessionView, responseId: string): Principal | undefined;
+/** An option's style a channel can render: a style a newer eve added reads as none. */
+export declare function optionStyle(option: {
+    readonly style?: string;
+}): "primary" | "danger" | "default" | undefined;

package/dist/src/channel/interaction-prompts.js

@@ -0,0 +1 @@
+import{decidingAnswer,interaction,interaction as interaction$1,promptQueueHead,signInEnding}from"#protocol/session-projection/reader.js";import{interactionBatches,interactionOwner}from"#protocol/session-projection/selectors.js";function requestBatchOf(e,t){let n=e.interactions[t.interactionId],r=interactionBatches(e).find(e=>e[0]===n);if(n===void 0||r===void 0)return;let i=r.flatMap(t=>interaction$1(e,t.interactionId)??[]);if(i.length===0)return;let a=interactionOwner(e,n),o={requests:i,turnId:a.turnId??``};return a.taskId!==void 0&&(o.taskId=a.taskId),(n.origin!==void 0||n.request.kind===`question`)&&`callId`in n.subject&&(o.callId=n.subject.callId),o}function firstOpenRequest(e){let t=promptQueueHead(e);return t===void 0?void 0:interaction$1(e,t.interactionId)}function requestSettlementOf(e,t){let n=e.interactions[t.interactionId];if(n===void 0||n.request.kind===`sign-in`)return;let r={interactionId:n.interactionId,kind:n.request.kind,outcome:t.outcome},i=decidingAnswer({...n,response:t.response});i!==void 0&&(r.answer=i),t.reason!==void 0&&(r.reason=t.reason);let a=t.cause!==void 0&&`responseId`in t.cause?responderOf(e,t.cause.responseId):void 0;return a!==void 0&&(r.responder=a),r}function refusedAnswerOf(e,t){if(t.outcome!==`refused`&&t.outcome!==`failed`)return;let n=e.responses[t.responseId];if(n===void 0)return;let r={interactionId:n.interactionId,outcome:t.outcome};t.reason!==void 0&&(r.reason=t.reason);let i=responderOf(e,t.responseId);return i!==void 0&&(r.responder=i),r}function responderOf(e,t){let n=e.responses[t];return n===void 0?void 0:e.deliveries[n.deliveryId]?.principal}function optionStyle(e){let{style:t}=e;return t===`primary`||t===`danger`||t==="default"?t:void 0}export{firstOpenRequest,interaction,optionStyle,refusedAnswerOf,requestBatchOf,requestSettlementOf,responderOf,signInEnding};

package/dist/src/channel/invoke-tool.d.ts

@@ -1,5 +1,6 @@
 import type { SessionAuthContext } from "#channel/types.js";
 import type { ToolModelOutput } from "#tools/model-output.js";
+import type { ErrorInfo } from "#protocol/session-events/envelope.js";
 /** Longest {@link InvokeToolOptions.key} `invokeTool` accepts. */
 export declare const TOOL_SESSION_KEY_MAX_LENGTH = 512;
 /** Options for one {@link InvokeToolFn} call. */
@@ -28,28 +29,20 @@ export interface InvokeToolOptions {
 }
 /** Outcome of one {@link InvokeToolFn} call. */
 export type InvokeToolResult = {
-    readonly status: "completed";
+    readonly outcome: "completed";
     readonly output: unknown;
     readonly modelOutput: ToolModelOutput;
 } | {
-    readonly status: "failed";
-    readonly message: string;
-    readonly errorId?: string;
+    readonly outcome: "failed";
+    readonly error: ErrorInfo;
 } | {
-    readonly status: "invalid-input";
-    readonly message: string;
-} | {
-    readonly status: "denied";
-    readonly reason?: string;
-}
-/** The tool's approval policy asks a person. A call has no one to ask, so the tool did not run. */
- | {
-    readonly status: "approval-required";
-}
-/** The tool needs a sign-in to these connections first. The tool stopped where it needed them. */
- | {
-    readonly status: "authorization-required";
-    readonly connections: readonly string[];
+    readonly outcome: "rejected";
+    /** `approval-required`, `sign-in-required`, or the reason a policy refused the call. */
+    readonly reason: string;
+    readonly connections?: readonly string[];
+    readonly cause?: {
+        readonly policy: string;
+    };
 };
 /**
  * Runs one of the agent's tools outside a conversation. No model, turn, or

package/dist/src/channel/pending-authorization.d.ts

@@ -1,15 +1,4 @@
 import type { Session } from "#channel/session.js";
-import type { AuthorizationRequiredStreamEvent } from "#protocol/message.js";
-type AuthorizationRequired = AuthorizationRequiredStreamEvent["data"];
-/**
- * The newest sign-in that `matches` and hasn't completed yet, from the
- * session's recent events. Attempts are keyed by connection name and
- * `attemptId`, so one attempt completing never hides another still pending.
- */
-export declare function findPendingAuthorization(session: Pick<Session, "getEventStream">, matches: (event: AuthorizationRequired) => boolean): Promise<AuthorizationRequired | undefined>;
-/** Identifies one sign-in attempt: a connection name and its `attemptId`. */
-export declare function attemptKey(event: {
-    readonly attemptId?: string;
-    readonly name: string;
-}): string;
-export {};
+import { type SignIn } from "#channel/sign-in.js";
+/** The latest matching sign-in still open in the recent durable stream. */
+export declare function findPendingAuthorization(session: Pick<Session, "stream">, matches: (signIn: SignIn) => boolean): Promise<SignIn | undefined>;

package/dist/src/channel/pending-authorization.js

@@ -1 +1 @@
-async function findPendingAuthorization(e,t){let n=new Map,r=(await e.getEventStream({follow:!1,startIndex:-500})).getReader();try{for(;;){let e=await r.read();if(e.done)break;let i=e.value;if(i.type===`authorization.required`&&t(i.data)){let e=attemptKey(i.data);n.delete(e),n.set(e,i.data)}else i.type===`authorization.completed`&&n.delete(attemptKey(i.data))}}finally{await r.cancel().catch(()=>{})}return[...n.values()].at(-1)}function attemptKey(e){return JSON.stringify([e.name,e.attemptId??null])}export{attemptKey,findPendingAuthorization};
+import{emptySessionView,foldReceivedEvent}from"#protocol/session-projection/fold.js";import{openSignIns}from"#protocol/session-projection/reader.js";import{signInOf}from"#channel/sign-in.js";async function findPendingAuthorization(e,t){let n=emptySessionView();for await(let t of e.stream({follow:!1,startIndex:-500}))foldReceivedEvent(n,t);return openSignIns(n).map(e=>signInOf(n,e.interactionId)).findLast(t)}export{findPendingAuthorization};

package/dist/src/channel/prompt-queue.d.ts

@@ -1,5 +1,5 @@
-import type { UnstampedMessageStreamEvent } from "#protocol/message.js";
-import type { InputRequest } from "#shared/input.js";
+import { type SessionView } from "#protocol/session-projection/session-view.js";
+import type { Interaction } from "#channel/interaction-prompts.js";
 /**
  * Channel state for showing a session's open requests one at a time. A typed
  * reply answers the first open request, so a channel that can only show text
@@ -10,22 +10,14 @@ export interface PromptQueueState {
     shownPromptId?: string;
 }
 /**
- * Event handlers that call `show` with the request a typed reply answers now,
- * each time that request changes. They read which requests are open from the
- * session's own record of the events it published, so a request that closed
- * never shows, and one the channel failed to show is tried again on the next
- * event. `show` returns `false` when it could not show the request.
+ * A `committed` handler that calls `show` with the request a typed reply answers now, each time
+ * that request changes. It reads which requests are open from the tables as of the commit, so a
+ * request that closed never shows, and one the channel failed to show is tried again at the next
+ * commit. `show` returns `false` when it could not show the request.
  */
-export declare function promptQueueEvents<TChannel extends {
+export declare function promptQueue<TChannel extends {
     state: PromptQueueState;
-}>(show: (channel: TChannel, request: InputRequest) => Promise<boolean | void>): {
-    "input.requested"(data: Extract<UnstampedMessageStreamEvent, {
-        type: "input.requested";
-    }>["data"], channel: TChannel): Promise<void>;
-    "input.resolved"(data: Extract<UnstampedMessageStreamEvent, {
-        type: "input.resolved";
-    }>["data"], channel: TChannel): Promise<void>;
-    "approval.settled"(data: Extract<UnstampedMessageStreamEvent, {
-        type: "approval.settled";
-    }>["data"], channel: TChannel): Promise<void>;
-};
+}>(show: (channel: TChannel, request: Interaction) => Promise<boolean | void>): (_line: unknown, { channel, view }: {
+    readonly channel: TChannel;
+    readonly view: SessionView;
+}) => Promise<void>;

package/dist/src/channel/prompt-queue.js

@@ -1 +1 @@
-import{foldSession}from"#protocol/session-projection.js";import{contextStorage}from"#context/container.js";import{firstOpenInput}from"#harness/open-input-request.js";import{currentProjection}from"#harness/session-machine/current.js";function promptQueueEvents(e){async function refresh(t,n){let r=firstOpenInput(foldSession(publishedProjection(t),n))?.request;if(r===void 0){delete t.state.shownPromptId;return}r.requestId!==t.state.shownPromptId&&await e(t,r)!==!1&&(t.state.shownPromptId=r.requestId)}return{async"input.requested"(e,t){await refresh(t,{data:e,type:`input.requested`})},async"input.resolved"(e,t){await refresh(t,{data:e,type:`input.resolved`})},async"approval.settled"(e,t){await refresh(t,{data:e,type:`approval.settled`})}}}function publishedProjection(e){let t=e.ctx??contextStorage.getStore();return currentProjection(t)}export{promptQueueEvents};
+import{firstOpenRequest}from"#channel/interaction-prompts.js";import{sessionTables}from"#protocol/session-projection/session-view.js";function promptQueue(e){return async(t,{channel:n,view:r})=>{let i=firstOpenRequest(sessionTables(r));if(i===void 0){delete n.state.shownPromptId;return}i.interactionId!==n.state.shownPromptId&&await e(n,i)!==!1&&(n.state.shownPromptId=i.interactionId)}}export{promptQueue};

package/dist/src/channel/resolve-text.d.ts

@@ -1,32 +1,25 @@
-import type { InputOption, InputResponse } from "#shared/input.js";
-/** The request fields plain text is resolved against. */
-interface TextResolvableRequest {
-    readonly allowFreeform?: boolean;
-    readonly options?: readonly InputOption[];
-    readonly requestId: string;
+import type { InteractionRequest } from "#protocol/session-events/families/interaction.js";
+import type { Answer } from "#shared/input.js";
+/** An interaction plain text answers: an interaction row, or an approval the session asked. */
+interface TextResolvable {
+    readonly interactionId: string;
+    readonly request: Pick<InteractionRequest, "allowFreeform" | "options">;
 }
 /**
  * Renders a request's prompt and numbered options as the plain text that
- * {@link resolveTextToResponse} parses, so a reply with the number, label, or
+ * {@link answerFromText} parses, so a reply with the number, label, or
  * id answers it. Channels append their own reply instructions.
  */
-export declare function renderTextInputRequest(request: TextResolvableRequest & {
-    readonly prompt: string;
-}): string;
+export declare function renderTextInteraction(request: Pick<InteractionRequest, "options" | "prompt">): string;
 /**
- * Maps freeform text to an {@link InputResponse} for a single request.
+ * Maps freeform text to an {@link Answer} to one interaction.
  *
  * Resolution order:
  * 1. Exact option ID (case-insensitive)
  * 2. Exact option label (case-insensitive)
  * 3. 1-based numeric index into the options array
- * 4. Freeform text when {@link InputRequest.allowFreeform} is `true` or the
+ * 4. Freeform text when the request allows freeform answers or the
  *    request has no options
  */
-export declare function resolveTextToResponse(text: string, request: TextResolvableRequest): InputResponse | undefined;
-/**
- * Resolves text against all pending requests, returning one
- * {@link InputResponse} for each request that could be matched.
- */
-export declare function resolveTextToResponses(text: string, requests: readonly TextResolvableRequest[]): readonly InputResponse[];
+export declare function answerFromText(text: string, interaction: TextResolvable): Answer | undefined;
 export {};

package/dist/src/channel/resolve-text.js

@@ -1,2 +1,2 @@
-function renderTextInputRequest(e){let t=[e.prompt];return e.options!==void 0&&e.options.length>0&&t.push(``,...e.options.map((e,t)=>{let n=e.description?` - ${e.description}`:``;return`${t+1}. ${e.label}${n}`})),t.join(`
-`)}function resolveTextToResponse(e,t){let n=e.trim();if(n.length===0)return;let r=n.toLowerCase();if(t.options!==void 0&&t.options.length>0){let e=matchOption(r,t.options);if(e!==void 0)return{requestId:t.requestId,optionId:e.id}}if(t.allowFreeform===!0||t.options===void 0||t.options.length===0)return{requestId:t.requestId,text:n}}function resolveTextToResponses(e,t){let n=[];for(let r of t){let t=resolveTextToResponse(e,r);t!==void 0&&n.push(t)}return n}function matchOption(e,t){let n=t.find(t=>t.id.toLowerCase()===e);if(n!==void 0)return n;let r=t.find(t=>t.label.toLowerCase()===e);if(r!==void 0)return r;let i=Number(e);if(Number.isInteger(i)&&i>0&&i<=t.length)return t[i-1]}export{renderTextInputRequest,resolveTextToResponse,resolveTextToResponses};
+function renderTextInteraction(e){let t=[e.prompt];return e.options!==void 0&&e.options.length>0&&t.push(``,...e.options.map((e,t)=>{let n=e.description?` - ${e.description}`:``;return`${t+1}. ${e.label}${n}`})),t.join(`
+`)}function answerFromText(e,t){let{interactionId:n,request:r}=t,i=e.trim();if(i.length===0)return;let a=i.toLowerCase();if(r.options!==void 0&&r.options.length>0){let e=matchOption(a,r.options);if(e!==void 0)return{interactionId:n,optionId:e.id}}if(r.allowFreeform===!0||r.options===void 0||r.options.length===0)return{interactionId:n,text:i}}function matchOption(e,t){let n=t.find(t=>t.id.toLowerCase()===e);if(n!==void 0)return n;let r=t.find(t=>t.label.toLowerCase()===e);if(r!==void 0)return r;let i=Number(e);if(Number.isInteger(i)&&i>0&&i<=t.length)return t[i-1]}export{answerFromText,renderTextInteraction};

package/dist/src/channel/resolved-prompt.d.ts

@@ -1,12 +1,14 @@
-import type { InputResolution } from "#protocol/message.js";
-import type { InputOption } from "#shared/input.js";
-type PromptOption = Pick<InputOption, "id" | "label">;
+import type { RequestSettlement } from "#channel/interaction-prompts.js";
+import type { InteractionOption } from "#protocol/session-events/families/interaction.js";
+type PromptOption = Pick<InteractionOption, "id" | "label">;
 /**
  * How eve resolved a posted prompt, such as `Approved` or a chosen option's
  * label. A request that ends without an answer, such as one withdrawn when its
  * turn is cancelled, is no longer needed.
  */
-export declare function resolvedPromptAnswer(resolution: InputResolution, options?: readonly PromptOption[]): string | undefined;
+export declare function resolvedPromptAnswer(resolution: RequestSettlement, options?: readonly PromptOption[]): string | undefined;
 /** The line a prompt shows once resolved, such as `Approved` or `Answered: Saturday`. */
-export declare function resolvedPromptLabel(resolution: InputResolution, options?: readonly PromptOption[]): string;
+export declare function resolvedPromptLabel(resolution: RequestSettlement, options?: readonly PromptOption[]): string;
+/** A question or budget prompt someone answered. */
+export declare function isAnswered(resolution: RequestSettlement): boolean;
 export {};

package/dist/src/channel/resolved-prompt.js

@@ -1 +1 @@
-function resolvedPromptAnswer(e,t=[]){switch(e.outcome){case`approved`:return`Approved`;case`denied`:return`Cancelled`;case`answered`:{let n=e.response;return t.find(e=>e.id===n?.optionId)?.label??n?.text}default:return`No longer needed`}}function resolvedPromptLabel(e,t=[]){let n=resolvedPromptAnswer(e,t);return e.outcome===`answered`?n===void 0?`Answered`:`Answered: ${n}`:n??``}export{resolvedPromptAnswer,resolvedPromptLabel};
+function resolvedPromptAnswer(e,t=[]){if(e.outcome!==`accepted`&&e.outcome!==`declined`)return`No longer needed`;if(e.kind===`approval`)return e.outcome===`accepted`?`Approved`:`Cancelled`;let{answer:n}=e;return t.find(e=>e.id===n?.optionId)?.label??n?.text}function resolvedPromptLabel(e,t=[]){let n=resolvedPromptAnswer(e,t);return isAnswered(e)?n===void 0?`Answered`:`Answered: ${n}`:n??``}function isAnswered(e){return e.kind!==`approval`&&(e.outcome===`accepted`||e.outcome===`declined`)}export{isAnswered,resolvedPromptAnswer,resolvedPromptLabel};

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

@@ -1,8 +1,8 @@
-import type { UserContent } from "ai";
+import type { MessageContent } from "#shared/message-content.js";
 import type { CrossChannelToFn } from "#channel/cross-channel-receive.js";
 import type { ChannelFrom, ChannelResolveSession } from "#channel/channel-operations.js";
 import type { InvokeToolFn } from "#channel/invoke-tool.js";
-import type { InputResponse } from "#shared/input.js";
+import type { Answer } from "#shared/input.js";
 import type { Session } from "#channel/session.js";
 import type { JsonObject } from "#shared/json.js";
 import type { SessionHistoryMessage } from "#shared/session-history.js";
@@ -57,9 +57,9 @@ export interface RouteHandlerArgs<TState = undefined> {
     readonly invokeTool: InvokeToolFn;
 }
 export interface SendPayload {
-    readonly message?: string | UserContent;
+    readonly message?: MessageContent;
     readonly [key: string]: unknown;
-    readonly inputResponses?: readonly InputResponse[];
+    readonly answers?: readonly Answer[];
     /**
      * Context strings contributed by the channel. eve appends each entry
      * as a `role: "user"` message to `session.history` before the delivery

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

@@ -1,5 +1,5 @@
 import type { ChannelAdapter } from "#channel/adapter.js";
-import { type Session } from "#channel/session.js";
+import type { Delivery } from "#shared/delivery.js";
 import type { Runtime } from "#channel/types.js";
 import type { ScheduleRunHandler } from "#public/definitions/schedule.js";
 import type { DynamicSchedulesDefinition, ScheduleOccurrenceIdentity } from "#public/schedules/subscription.js";
@@ -27,7 +27,7 @@ export interface ScheduleDispatchInput {
 }
 /** Sessions started by dispatch and background work registered by the handler. */
 export interface ScheduleDispatchResult {
-    readonly sessions: readonly Session[];
+    readonly sessions: readonly Delivery[];
     readonly waitUntilTasks: readonly Promise<unknown>[];
 }
 export interface ScheduleCollectionDispatchInput {

package/dist/src/channel/schedule.js

@@ -1 +1 @@
-import{randomUUID}from"node:crypto";import{createSession}from"#channel/session.js";import{ContextContainer,contextStorage}from"#context/container.js";import{scheduleDisplayName}from"#runtime/schedules/record.js";import{SCHEDULE_APP_AUTH,SCHEDULE_APP_AUTH as SCHEDULE_APP_AUTH$1}from"#channel/schedule-auth.js";import{createCrossChannelToFn,toCrossChannelTargets}from"#channel/cross-channel-receive.js";import{AuthKey,OccurrenceIdKey,ScheduleIdKey,ScheduleInstanceKey}from"#context/keys.js";import{expectFunction}from"#internal/authored-module.js";import{parseSchedulePayload,validateSchedulePayload}from"#runtime/schedules/payload.js";const SCHEDULE_ADAPTER_KIND=`schedule`,SCHEDULE_ADAPTER={kind:SCHEDULE_ADAPTER_KIND};var ScheduleDispatcher=class{runtime;channels;constructor(e){this.runtime=e.runtime,this.channels=e.channels}async trigger(e){let t=new ContextContainer;return t.set(ScheduleIdKey,e.scheduleId),await contextStorage.run(t,()=>this.triggerInScope(e))}async triggerCollection(e){let{envelope:t}=parseSchedulePayload(e.payload,{application:e.payload.eve.application,collection:e.collectionId}),{definition:n}=e,r={...e.occurrence,displayName:scheduleDisplayName(e.occurrence.name)},i=n.preparePayload===void 0?await validateSchedulePayload(n.inputSchema,t.payload):t.payload;await e.verifyDelivery?.();let a=await n.auth({principal:t.principal,payload:i,occurrence:r});if(a===null)throw Error(`Scheduled execution is no longer authorized.`);if(a.principalId!==t.principal.principalId||a.principalType!==t.principal.type||a.authenticator!==t.principal.authenticator||a.issuer!==t.principal.issuer||a.subject!==t.principal.subject)throw Error(`Scheduled execution auth must resolve the schedule creator.`);let o=a,s=new ContextContainer;return s.set(ScheduleIdKey,e.collectionId),s.set(AuthKey,o),s.set(OccurrenceIdKey,r.executionId),s.set(ScheduleInstanceKey,r.name),await contextStorage.run(s,async()=>{let e={...this.runtime,resolveContinuation:async()=>void 0,dispatchContinuation:async e=>{if(e.command.kind!==`send`)throw Error(`Scheduled channel receive can only start a fresh session.`);return{status:`session_not_active`}},createSession:async e=>await this.runtime.createSession({...e,auth:o,initiatorAuth:o,capabilities:{requestInput:!1},continuationToken:`eve-scheduled-send:${randomUUID()}`,continuationConflictCommand:void 0})},{args:t,sessions:a,waitUntilTasks:s}=this.createHandlerContext(e);return await n.run({payload:i,occurrence:r,auth:o,to:(e,n)=>({send:r=>t.to(e,n).send(r,{auth:o})}),waitUntil:t.waitUntil}),await Promise.all(s),{sessions:a,waitUntilTasks:s}})}async triggerInScope(e){let{args:t,sessions:n,waitUntilTasks:r}=this.createHandlerContext();if(e.run)await e.run(t);else if(e.markdown!==void 0)n.push(await this.runMarkdown(e.markdown));else throw Error(`Schedule "${e.scheduleId}" has neither "run" nor "markdown" — at least one must be set.`);return{sessions:n,waitUntilTasks:r}}createHandlerContext(e=this.runtime){let t=[],n=[],r=createCrossChannelToFn(e,toCrossChannelTargets(this.channels));return{args:{appAuth:SCHEDULE_APP_AUTH$1,to(e,n){let i=r(e,n);return{async send(e,n){let r=await i.send(e,n);return t.push(r),r}}},waitUntil(e){n.push(e)}},sessions:t,waitUntilTasks:n}}async runMarkdown(e){let t=await this.runtime.createSession({adapter:SCHEDULE_ADAPTER,auth:SCHEDULE_APP_AUTH$1,input:{message:e}});return createSession(t.sessionId,this.runtime)}};function expectScheduleRun(e,t,n){let r=e;if(typeof r!=`object`||!r)throw Error(`Schedule export "${n??`default`}" from "${t}" must be an object.`);return expectFunction(r.run,`Expected the schedule export "${n??`default`}" from "${t}" to export a \`run\` handler function.`)}export{SCHEDULE_ADAPTER,SCHEDULE_ADAPTER_KIND,SCHEDULE_APP_AUTH,ScheduleDispatcher,expectScheduleRun};
+import{randomUUID}from"node:crypto";import{commandDelivery}from"#channel/delivery.js";import{createChannelDeliveryMetadata}from"#channel/delivery-metadata.js";import{scheduleDisplayName}from"#runtime/schedules/record.js";import{SCHEDULE_APP_AUTH,SCHEDULE_APP_AUTH as SCHEDULE_APP_AUTH$1}from"#channel/schedule-auth.js";import{createCrossChannelToFn,toCrossChannelTargets}from"#channel/cross-channel-receive.js";import{ContextContainer,contextStorage}from"#context/container.js";import{AuthKey,OccurrenceIdKey,ScheduleIdKey,ScheduleInstanceKey}from"#context/keys.js";import{expectFunction}from"#internal/authored-module.js";import{parseSchedulePayload,validateSchedulePayload}from"#runtime/schedules/payload.js";const SCHEDULE_ADAPTER_KIND=`schedule`,SCHEDULE_ADAPTER={kind:SCHEDULE_ADAPTER_KIND};var ScheduleDispatcher=class{runtime;channels;constructor(e){this.runtime=e.runtime,this.channels=e.channels}async trigger(e){let t=new ContextContainer;return t.set(ScheduleIdKey,e.scheduleId),await contextStorage.run(t,()=>this.triggerInScope(e))}async triggerCollection(e){let{envelope:t}=parseSchedulePayload(e.payload,{application:e.payload.eve.application,collection:e.collectionId}),{definition:n}=e,r={...e.occurrence,displayName:scheduleDisplayName(e.occurrence.name)},i=n.preparePayload===void 0?await validateSchedulePayload(n.inputSchema,t.payload):t.payload;await e.verifyDelivery?.();let a=await n.auth({principal:t.principal,payload:i,occurrence:r});if(a===null)throw Error(`Scheduled execution is no longer authorized.`);if(a.principalId!==t.principal.principalId||a.principalType!==t.principal.type||a.authenticator!==t.principal.authenticator||a.issuer!==t.principal.issuer||a.subject!==t.principal.subject)throw Error(`Scheduled execution auth must resolve the schedule creator.`);let o=a,s=new ContextContainer;return s.set(ScheduleIdKey,e.collectionId),s.set(AuthKey,o),s.set(OccurrenceIdKey,r.executionId),s.set(ScheduleInstanceKey,r.name),await contextStorage.run(s,async()=>{let e={...this.runtime,resolveContinuation:async()=>void 0,dispatchContinuation:async e=>{if(e.command.kind!==`send`)throw Error(`Scheduled channel receive can only start a fresh session.`);return{status:`session_not_active`}},createSession:async e=>await this.runtime.createSession({...e,auth:o,initiatorAuth:o,capabilities:{requestInput:!1},continuationToken:`eve-scheduled-send:${randomUUID()}`,continuationConflictCommand:void 0})},{args:t,sessions:a,waitUntilTasks:s}=this.createHandlerContext(e);return await n.run({payload:i,occurrence:r,auth:o,to:(e,n)=>({send:r=>t.to(e,n).send(r,{auth:o})}),waitUntil:t.waitUntil}),await Promise.all(s),{sessions:a,waitUntilTasks:s}})}async triggerInScope(e){let{args:t,sessions:n,waitUntilTasks:r}=this.createHandlerContext();if(e.run)await e.run(t);else if(e.markdown!==void 0)n.push(await this.runMarkdown(e.markdown));else throw Error(`Schedule "${e.scheduleId}" has neither "run" nor "markdown" — at least one must be set.`);return{sessions:n,waitUntilTasks:r}}createHandlerContext(e=this.runtime){let t=[],n=[],r=createCrossChannelToFn(e,toCrossChannelTargets(this.channels));return{args:{appAuth:SCHEDULE_APP_AUTH$1,to(e,n){let i=r(e,n);return{async send(e,n){let r=await i.send(e,n);return t.push(r),r}}},waitUntil(e){n.push(e)}},sessions:t,waitUntilTasks:n}}async runMarkdown(e){let t=createChannelDeliveryMetadata({channelKind:`schedule`,channelName:`schedule`}),n=await this.runtime.createSession({delivery:t,adapter:SCHEDULE_ADAPTER,auth:SCHEDULE_APP_AUTH$1,input:{message:e}});return commandDelivery(this.runtime,{status:`accepted`,sessionId:n.sessionId},t.deliveryId)}};function expectScheduleRun(e,t,n){let r=e;if(typeof r!=`object`||!r)throw Error(`Schedule export "${n??`default`}" from "${t}" must be an object.`);return expectFunction(r.run,`Expected the schedule export "${n??`default`}" from "${t}" to export a \`run\` handler function.`)}export{SCHEDULE_ADAPTER,SCHEDULE_ADAPTER_KIND,SCHEDULE_APP_AUTH,ScheduleDispatcher,expectScheduleRun};