eve 0.83.3 → 0.84.0

package/dist/src/channel/send-input.d.ts

@@ -1,10 +1,10 @@
-import type { UserContent } from "ai";
+import type { MessageContent } from "#shared/message-content.js";
 import type { SendPayload } from "#channel/routes.js";
 /** Normalizes the shorthand input forms accepted by channel and session sends. */
-export declare function normalizeSendInput(input: string | UserContent | SendPayload): SendPayload;
+export declare function normalizeSendInput(input: MessageContent | SendPayload): SendPayload;
 /**
  * Serializes file parts before input crosses the durable boundary: `URL`s
  * become `eve-url:` markers and bytes become `data:` URLs, so no world
  * serializer has to round-trip a `URL` or a typed array.
  */
-export declare function serializeFilePartsInMessage(message: string | UserContent | undefined): string | UserContent | undefined;
+export declare function serializeFilePartsInMessage(message: MessageContent | undefined): MessageContent | undefined;

package/dist/src/channel/send-input.js

@@ -1 +1 @@
-import{serializeUrlFilePart}from"#internal/attachments/url-refs.js";function normalizeSendInput(e){return typeof e==`string`||Array.isArray(e)?{message:e}:e}function serializeFilePartsInMessage(e){if(e===void 0||typeof e==`string`)return e;let t=!1,n=e.map(e=>{if(e.type!==`file`)return e;if(e.data instanceof URL&&e.data.protocol!==`data:`)return t=!0,{...e,data:serializeUrlFilePart(e.data)};if(e.data instanceof Uint8Array||e.data instanceof ArrayBuffer){t=!0;let n=Buffer.from(new Uint8Array(e.data)).toString(`base64`);return{...e,data:`data:${e.mediaType};base64,${n}`}}return e});return t?n:e}export{normalizeSendInput,serializeFilePartsInMessage};
+import{serializeUrlFilePart}from"#internal/attachments/url-refs.js";function normalizeSendInput(e){return isMessageContent(e)?{message:e}:e}function isMessageContent(e){return typeof e==`string`||Array.isArray(e)}function serializeFilePartsInMessage(e){if(e===void 0||typeof e==`string`)return e;let t=!1,n=e.map(e=>{if(e.type!==`file`)return e;if(e.data instanceof URL&&e.data.protocol!==`data:`)return t=!0,{...e,data:serializeUrlFilePart(e.data)};if(e.data instanceof Uint8Array||e.data instanceof ArrayBuffer){t=!0;let n=Buffer.from(new Uint8Array(e.data)).toString(`base64`);return{...e,data:`data:${e.mediaType};base64,${n}`}}return e});return t?n:e}export{normalizeSendInput,serializeFilePartsInMessage};

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

@@ -1 +1 @@
-import{z}from"#compiled/zod/index.js";import{createEveCallbackRoutePath}from"#protocol/routes.js";import{normalizePublicEveRoutePath}from"#shared/eve-route-path.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 n;try{n=new URL(e.url)}catch{t.addIssue({code:`custom`,message:`Callback url must be absolute.`,path:[`url`]});return}readCallbackUrlToken(n)!==e.token&&t.addIssue({code:`custom`,message:`Callback url token must match callback token.`,path:[`url`]}),isReservedIpAddress(n.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 t=createEveCallbackRoutePath(``),n=normalizePublicEveRoutePath(e.pathname),r=n.lastIndexOf(t);if(r===-1)return null;let i=n.slice(r+t.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{isLocalDevelopmentServer}from"#internal/application/dev-environment.js";import{isBlockedDestinationHost}from"#shared/network-address.js";import{z}from"#compiled/zod/index.js";import{createEveCallbackRoutePath}from"#protocol/routes.js";import{normalizePublicEveRoutePath}from"#shared/eve-route-path.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 n;try{n=new URL(e.url)}catch{t.addIssue({code:`custom`,message:`Callback url must be absolute.`,path:[`url`]});return}readCallbackUrlToken(n)!==e.token&&t.addIssue({code:`custom`,message:`Callback url token must match callback token.`,path:[`url`]}),n.protocol!==`http:`&&n.protocol!==`https:`&&t.addIssue({code:`custom`,message:`Callback url must use http or https.`,path:[`url`]}),isBlockedDestinationHost(n.hostname,{allowLoopback:isLocalDevelopmentServer()})&&t.addIssue({code:`custom`,message:`Callback url host must not be a loopback, private, link-local, or reserved address. Loopback is allowed only on local development servers.`,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 t=createEveCallbackRoutePath(``),n=normalizePublicEveRoutePath(e.pathname),r=n.lastIndexOf(t);if(r===-1)return null;let i=n.slice(r+t.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-not-active-error.d.ts

@@ -1,16 +1,12 @@
-/**
- * Thrown by `respond()` when no session holds the address it answers, such as
- * after the session's run was cancelled outside eve, so the requests being
- * answered no longer exist. Nothing is delivered. Narrow with
- * {@link SessionNotActiveError.is}.
- */
+/** A session could not accept a command. No delivery was accepted. */
 export declare class SessionNotActiveError extends Error {
-    constructor();
-    /** Narrows not-active-session errors across bundle boundaries, where `instanceof` can miss. */
+    readonly code = "EVE_SESSION_NOT_ACTIVE";
+    readonly retryable: boolean;
+    constructor(options?: {
+        readonly retryable?: boolean;
+    });
+    /** Recognizes errors across bundles without depending on constructor identity. */
     static is(error: unknown): error is SessionNotActiveError;
 }
-/**
- * Whether a failed `respond()` can never succeed: no session holds the
- * requests, or the session holding them is stranded and can run no code.
- */
+/** Whether an answer targets a session that cannot run or no longer exists. */
 export declare function isUnanswerableResponseError(error: unknown): boolean;

package/dist/src/channel/session-not-active-error.js

@@ -1 +1 @@
-import{SessionStrandedError}from"#channel/session-stranded-error.js";var SessionNotActiveError=class SessionNotActiveError extends Error{constructor(){super(`Cannot deliver inputResponses — the target session was not found via continuation token.`),this.name=`SessionNotActiveError`}static is(e){return e instanceof SessionNotActiveError||typeof e==`object`&&!!e&&Reflect.get(e,`name`)===`SessionNotActiveError`}};function isUnanswerableResponseError(e){return SessionNotActiveError.is(e)||SessionStrandedError.is(e)}export{SessionNotActiveError,isUnanswerableResponseError};
+import{SessionStrandedError}from"#channel/session-stranded-error.js";const CODE=`EVE_SESSION_NOT_ACTIVE`;var SessionNotActiveError=class extends Error{code=CODE;retryable;constructor(e={}){super(e.retryable===!0?`The session is not ready to accept commands. Retry shortly.`:`The session is no longer active. Start a new session.`),this.name=`SessionNotActiveError`,this.retryable=e.retryable===!0}static is(e){return typeof e==`object`&&!!e&&Reflect.get(e,`code`)===CODE&&typeof Reflect.get(e,`retryable`)==`boolean`}};function isUnanswerableResponseError(e){return SessionNotActiveError.is(e)||SessionStrandedError.is(e)}export{SessionNotActiveError,isUnanswerableResponseError};

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

@@ -1,51 +1,50 @@
+import type { RemoteChildBinding } from "#execution/child-binding.js";
+import type { SessionReader } from "#shared/session.js";
+import type { Delivery } from "#shared/delivery.js";
+import type { SessionStreamEvent } from "#protocol/session-event.js";
+import type { PrewarmSessionResult } from "#protocol/prewarm-session.js";
 import type { ContextAccessor } from "#context/key.js";
 import { type ChannelDeliverySource } from "#channel/delivery-metadata.js";
-import type { MessageStreamEvent } from "#protocol/message.js";
-import type { UserContent } from "ai";
-import type { CancelTurnResult, ClearSessionResult, CompactSessionResult, GetEventStreamOptions, ResetSessionResult, Runtime, SessionAuthContext, SessionCallback, SessionSendCommandResult, TurnPolicy, TurnCaller } from "#channel/types.js";
-import type { SessionAuth } from "#context/keys.js";
-import { type InputResponse, type StrictInputResponses } from "#shared/input.js";
+import type { MessageContent } from "#shared/message-content.js";
+import type { SessionStreamOptions, SessionControlOptions, Runtime, SessionAuthContext, SessionCallback, TurnPolicy, TurnCaller } from "#channel/types.js";
+import type { ChannelContext } from "#shared/channel-context.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";
 /** Immutable-ID handle for one exact durable session. */
-export interface Session {
-    readonly id: string;
-    /**
-     * Sends a message to this exact session ID without creating or following a
-     * replacement. Throws `SessionStrandedError` when the session's owner cannot
-     * execute here; nothing is delivered. Call {@link reset} to end it.
-     */
-    send(message: string | UserContent, options: SessionSendOptions): Promise<SessionSendCommandResult>;
-    /** Answers pending input requests on this exact session ID. Throws `SessionStrandedError` like {@link send}. */
-    respond<const TResponses extends readonly InputResponse[]>(inputResponses: StrictInputResponses<TResponses>, options: SessionRespondOptions): Promise<SessionSendCommandResult>;
-    /** Requests cancellation of this exact session's active turn. */
-    cancel(options?: {
-        turnId?: string;
-    }): Promise<CancelTurnResult>;
+export interface Session extends SessionReader {
+    send(message: MessageContent, options: SessionSendOptions): Promise<Delivery>;
+    respond<const TAnswers extends readonly Answer[]>(answers: StrictAnswers<TAnswers>, options: SessionRespondOptions): Promise<Delivery>;
+    cancel(options?: SessionControlOptions & {
+        readonly turnId?: string | null;
+    }): Promise<Delivery>;
     /** Prepares an idle session on the deployment accepting this request, without a model turn. */
-    prewarm(): Promise<import("#protocol/prewarm-session.js").PrewarmSessionResult>;
-    /** Queues compaction on this exact session ID. */
-    compact(): Promise<CompactSessionResult>;
-    /** Queues a context clear on this exact session ID. */
-    clear(): Promise<ClearSessionResult>;
-    /** Terminally retires this exact session ID. */
-    reset(options?: {
-        reason?: string;
-    }): Promise<ResetSessionResult>;
+    prewarm(): Promise<PrewarmSessionResult>;
+    clear(options?: SessionControlOptions): Promise<Delivery>;
+    compact(options?: SessionControlOptions): Promise<Delivery>;
+    reset(options?: SessionControlOptions & {
+        readonly reason?: string;
+    }): Promise<Delivery>;
     /**
      * Opens the recorded stream. Following it throws `SessionStrandedError`
      * while its owner is stranded; `follow: false` reads recorded history up to
      * the current tail without inspecting or changing the session.
      */
-    getEventStream(options?: GetEventStreamOptions): Promise<ReadableStream<MessageStreamEvent>>;
+    stream(options?: SessionStreamOptions): AsyncIterable<SessionStreamEvent>;
+}
+export interface InternalSession extends Session {
+    getChildBinding?(childSessionId: string): Promise<RemoteChildBinding | undefined>;
+    getLineStream(options?: SessionStreamOptions): Promise<ReadableStream<unknown>>;
     getStreamTailIndex(): Promise<number>;
+    /** Whether a run that can still execute owns the session; `true` when the runtime can't tell. */
+    hasRunnableOwner(): Promise<boolean>;
 }
+/** HTTP framing and conformance readers operate on framework-created handles. */
+export declare function internalSession(session: Session): InternalSession;
 interface SessionDeliveryOptions {
     /** Stable delivery identity, deduplicated within this session's recent-key window. */
     readonly idempotencyKey?: string;
     readonly auth: SessionAuthContext | null;
-    /** Public callback destination for a delegated continuation turn. */
-    readonly callback?: SessionCallback;
     readonly context?: readonly string[];
     readonly outputSchema?: JsonObject;
 }
@@ -59,40 +58,15 @@ export type SessionSendOptions = SessionDeliveryOptions & {
 };
 /** Options for answering pending input requests through a fixed session handle. */
 export type SessionRespondOptions = SessionDeliveryOptions;
-/**
- * Live handle to the current session, exposed on `ctx.session` to
- * `deliver` and event handlers. The framework hydrates the read-only
- * fields from the active context at step start. A write through
- * `continuation.alias()` selects a new current address and records it so the
- * runtime can add its hook to the session inbox at the next step boundary.
- * Previously claimed addresses remain active.
- */
-export interface SessionHandle {
-    readonly id: string;
-    readonly auth: SessionAuth;
-    readonly continuation?: {
-        readonly token: string;
-        alias(rawToken: string): void;
-    };
-}
 export declare function createSession(id: string, runtime: Runtime, metadata?: Partial<ChannelDeliverySource> & {
     readonly turnPolicy?: TurnPolicy;
-}): Session;
+}): InternalSession;
 /** Builds an I/O-free factory for fixed session-ID handles. */
 export declare function createAttachSessionFn(runtime: Runtime, metadata?: Partial<ChannelDeliverySource> & {
     readonly turnPolicy?: TurnPolicy;
 }): (sessionId: string) => Session;
-/**
- * Builds a live {@link SessionHandle} backed by the active context
- * accessor. Read-only fields resolve through getters so they reflect
- * any updates made by other handlers within the same step (e.g. the
- * `deliver` hook seeding `AuthKey` before an event handler reads
- * `session.auth`).
- *
- * Used by {@link buildAdapterContext} to populate `ctx.session` on
- * every adapter handler invocation.
- */
-export declare function buildSessionHandle(accessor: ContextAccessor): SessionHandle;
+/** Live metadata and routing authority stay separate, including when auth changes mid-step. */
+export declare function buildChannelContext(accessor: ContextAccessor): ChannelContext;
 /** @internal Converts validated public callback metadata into runtime turn routing. */
 export declare function sessionCallbackToTurnCaller(callback: SessionCallback | undefined): TurnCaller | undefined;
 export {};

package/dist/src/channel/session.js

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

package/dist/src/channel/sign-in.d.ts

@@ -0,0 +1,61 @@
+import type { SessionView } from "#protocol/session-projection/tables.js";
+import type { InteractionOutcome, InteractionSettledData } from "#protocol/session-events/families/interaction.js";
+/** A sign-in as a channel shows it. */
+export interface SignIn {
+    readonly interactionId: string;
+    /** The connection's name, which keys what a channel posted for it. */
+    readonly name: string;
+    readonly displayName: string;
+    readonly url?: string;
+    readonly userCode?: string;
+    readonly instructions?: string;
+    /** The principal that must sign in. */
+    readonly principalId?: string;
+    /** The approval response whose responder signs in; such a sign-in has its own prompt. */
+    readonly responseId?: string;
+    /** The turn the sign-in holds. */
+    readonly turnId?: string;
+}
+/** The sign-in an interaction is, or `undefined` for any other interaction. */
+export declare function signInOf(view: SessionView, interactionId: string): SignIn | undefined;
+/** The challenge as text: what to open or enter. Only its person may read it. */
+export declare function signInChallengeText(signIn: SignIn): string;
+/** How a sign-in ended, for the conversation. */
+export declare function signInEndedText(input: {
+    readonly displayName: string;
+    readonly outcome: InteractionOutcome;
+    readonly reason?: string;
+}): string;
+/** What a channel can do for a sign-in. */
+export interface SignInSurface {
+    /** Only the person signing in reads the conversation, so the challenge can go in it. */
+    readonly private: boolean;
+    /** Posts the challenge in a private conversation; the posted message's id, if it can edit it. */
+    postChallenge(signIn: SignIn): Promise<string | undefined>;
+    /** Shows the challenge to its person alone, outside the conversation; false when it can't. */
+    deliverPrivately?(signIn: SignIn): Promise<boolean>;
+    /** Posts text in the conversation; the posted message's id, if it can edit it. */
+    post(text: string): Promise<string | undefined>;
+    /** Posts the link-free status its own way, instead of as the default text. */
+    postStatus?(signIn: SignIn, delivered: boolean): Promise<string | undefined>;
+    /** Replaces a posted message's text. Without it, an ending posts as a new message. */
+    edit?(messageId: string, text: string): Promise<void>;
+    /** Shows the turn working again. */
+    typing?(status: string): Promise<void>;
+    /**
+     * What the channel posted for each open sign-in, by connection name, kept in its state: the
+     * message to edit, or `""` for one it can't.
+     */
+    readonly posted: {
+        get(name: string): string | undefined;
+        set(name: string, messageId: string | undefined): void;
+    };
+}
+/** Shows a sign-in once, where its challenge stays with its person. */
+export declare function showSignIn(view: SessionView, interactionId: string, surface: SignInSurface): Promise<void>;
+/** Shows how a sign-in the channel showed ended, and the turn resuming once it's accepted. */
+export declare function settleSignIn(view: SessionView, data: InteractionSettledData, surface: SignInSurface): Promise<void>;
+/** A `posted` record over a map of message ids by connection name in a channel's state. */
+export declare function postedIn<K extends string>(state: {
+    [P in K]?: Record<string, string> | undefined;
+}, key: K): SignInSurface["posted"];

package/dist/src/channel/sign-in.js

@@ -0,0 +1,3 @@
+import{signInEnding}from"#protocol/session-projection/reader.js";import{interactionOwner}from"#protocol/session-projection/selectors.js";import{displayProperName}from"#protocol/session-projection/display-name.js";function signInOf(e,t){let n=e.interactions[t];if(n===void 0||n.request.kind!==`sign-in`)return;let r=n.request.signIn,i=r?.name??t,a=n.audience?.principalIds[0],o=interactionOwner(e,n).turnId;return{displayName:r?.displayName??displayProperName(i),interactionId:t,name:i,...r?.url!==void 0&&{url:r.url},...r?.userCode!==void 0&&{userCode:r.userCode},...r?.instructions!==void 0&&{instructions:r.instructions},...a!==void 0&&{principalId:a},...`responseId`in n.subject&&{responseId:n.subject.responseId},...o!==void 0&&{turnId:o}}}function signInChallengeText(e){return[`Authorization required for ${e.displayName}.`,e.instructions,e.userCode===void 0?void 0:`Code: ${e.userCode}`,e.url].filter(e=>e!==void 0&&e.length>0).join(`
+
+`)}function signInEndedText(e){if(e.outcome===`accepted`)return`${e.displayName} connected.`;if(e.outcome===`declined`)return`${e.displayName} sign-in cancelled.`;let t=e.reason===void 0?``:` (${e.reason})`;return`${e.displayName} sign-in ${signInEnding(e.outcome)}${t}.`}async function showSignIn(e,t,n){let r=signInOf(e,t);if(r===void 0||r.responseId!==void 0||n.posted.get(r.name)!==void 0)return;let i;if(n.private)i=await n.postChallenge(r);else{let e=await n.deliverPrivately?.(r)===!0;i=n.postStatus===void 0?await n.post(e?`Authorization required for ${r.displayName}. I sent you the sign-in details privately.`:`Authorization required for ${r.displayName}. Continue in a direct message with this agent.`):await n.postStatus(r,e)}n.posted.set(r.name,i??``)}async function settleSignIn(e,t,n){let r=signInOf(e,t.interactionId);if(r===void 0||r.responseId!==void 0)return;let i=n.posted.get(r.name);if(i===void 0)return;n.posted.set(r.name,void 0);let a=signInEndedText({...r,outcome:t.outcome,reason:t.reason});i!==``&&n.edit!==void 0?await n.edit(i,a):await n.post(a),t.outcome===`accepted`&&await n.typing?.(`Connected. Resuming...`)}function postedIn(e,t){return{get:n=>e[t]?.[n],set(n,r){let{[n]:i,...a}=e[t]??{};e[t]=r===void 0?a:{...a,[n]:r}}}}export{postedIn,settleSignIn,showSignIn,signInChallengeText,signInEndedText,signInOf};

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

@@ -0,0 +1,44 @@
+import { type Interaction, type RequestBatch, type RequestSettlement } from "#channel/interaction-prompts.js";
+import { type SignInSurface } from "#channel/sign-in.js";
+import type { SessionEvent } from "#protocol/session-event.js";
+import type { ChannelEventContext, ChannelEventOf, CommittedLine } from "#public/definitions/channel.js";
+/** What a channel can do in its conversation, in its platform's terms. */
+export interface ChannelSurface<TChannel> {
+    /** Shows the agent working. */
+    typing?(channel: TChannel): Promise<void>;
+    /** Posts text in the conversation: a reply, or a failure notice. */
+    post(channel: TChannel, text: string): Promise<unknown>;
+    /** What a person starts after the session fails: "message", "comment". */
+    readonly restart: string;
+    /** How the platform asks people. */
+    readonly requests: ButtonRequests<TChannel> | TextRequests<TChannel>;
+    signIns(channel: TChannel): SignInSurface;
+}
+/** A platform with buttons: it shows a commit's requests at once, and marks each as it settles. */
+export interface ButtonRequests<TChannel> {
+    show(channel: TChannel, request: Interaction, batch: RequestBatch): Promise<void>;
+    /** Called for every request that settles; one the channel didn't show it ignores. */
+    settle(channel: TChannel, settlement: RequestSettlement): Promise<void>;
+}
+/** A platform with text alone: a reply answers the request it sees, so it sees one at a time. */
+export interface TextRequests<TChannel> {
+    /** Shows the request a typed reply answers now; `false` when it couldn't, to try again. */
+    showOne(channel: TChannel, request: Interaction): Promise<boolean | void>;
+}
+type Handler<T extends SessionEvent["type"], TChannel> = (event: ChannelEventOf<T>, ctx: ChannelEventContext<TChannel>) => Promise<void>;
+export interface SurfaceEvents<TChannel> {
+    /** A text channel's: shows the request a typed reply answers now, as it changes. */
+    readonly committed?: (line: CommittedLine, ctx: ChannelEventContext<TChannel>) => Promise<void>;
+    readonly "turn.started"?: Handler<"turn.started", TChannel>;
+    readonly "call.requested"?: Handler<"call.requested", TChannel>;
+    readonly "interaction.opened": Handler<"interaction.opened", TChannel>;
+    readonly "interaction.settled": Handler<"interaction.settled", TChannel>;
+    readonly "content.completed": Handler<"content.completed", TChannel>;
+    readonly "turn.settled": Handler<"turn.settled", TChannel>;
+    readonly "session.ended": Handler<"session.ended", TChannel>;
+}
+/** The event handlers that show a session on `surface`. */
+export declare function surfaceEvents<TChannel extends {
+    readonly state: object;
+}>(surface: ChannelSurface<TChannel>): SurfaceEvents<TChannel>;
+export {};

package/dist/src/channel/surface.js

@@ -0,0 +1 @@
+import{settleSignIn,showSignIn}from"#channel/sign-in.js";import{requestBatchOf,requestSettlementOf}from"#channel/interaction-prompts.js";import{sessionTables}from"#protocol/session-projection/session-view.js";import{promptQueue}from"#channel/prompt-queue.js";import{failureNotice,replyTextOf}from"#public/channels/reply.js";function surfaceEvents(e){let{requests:t}=e,n=`showOne`in t?promptQueue(t.showOne):void 0,{typing:r}=e,i=r===void 0?void 0:async(e,{channel:t})=>r(t),post=async(t,n)=>{n!==void 0&&await e.post(t,n)};return{...i!==void 0&&{"call.requested":i,"turn.started":i},...n!==void 0&&{committed:n},async"interaction.opened"(n,r){let{channel:i}=r,a=sessionTables(r.view);if(`show`in t){let e=requestBatchOf(a,n.data);for(let n of e?.requests??[])await t.show(i,n,e)}await showSignIn(a,n.data.interactionId,e.signIns(i))},async"interaction.settled"(n,r){let{channel:i}=r,a=sessionTables(r.view);if(`settle`in t){let e=requestSettlementOf(a,n.data);e!==void 0&&await t.settle(i,e)}await settleSignIn(a,n.data,e.signIns(i))},async"content.completed"({data:e},{channel:t}){await post(t,replyTextOf(e))},async"turn.settled"({data:e},{channel:t}){await post(t,failureNotice(e,`turn`))},async"session.ended"({data:t},{channel:n}){await post(n,failureNotice(t,{restart:e.restart}))}}}export{surfaceEvents};

package/dist/src/channel/task-card.d.ts

@@ -1,121 +1,31 @@
-import type { TaskCancelReason, UnstampedMessageStreamEvent } from "#protocol/message.js";
+import type { SessionView as SessionTables } from "#protocol/session-projection/tables.js";
+import { type SessionView } from "#protocol/session-projection/session-view.js";
+import { type CallObservation } from "#protocol/session-projection/public-view.js";
 import type { ChannelAudience } from "#shared/channel-audience.js";
-import type { JsonObject } from "#shared/json.js";
-/** How one of the turn's calls stands. */
-export type TaskCardStatus = "working" | "completed" | "failed" | "cancelled";
-/** What a blocked task waits on: a person's approval, answer, or sign-in. */
-export interface TaskCardBlocker {
-    readonly kind: "approval" | "authorization" | "input";
-    /**
-     * The request's prompt or the connection's name. Only in a private
-     * conversation, since a request can be sent to one person alone.
-     */
-    readonly label?: string;
-}
-/** One task call in a turn's task card. */
-export interface TaskCardTask {
-    /** The call's id; a resumable task called twice in a turn has two rows. */
-    readonly id: string;
-    readonly taskId: string;
-    readonly kind: "agent" | "tool";
-    /** The tool or agent name. */
-    readonly name: string;
-    /**
-     * The tool's start label, or the name's display title. An agent's is
-     * `Researcher: brief`, or the brief alone for a call to the agent's own copy.
-     */
-    readonly title: string;
-    /** `blocked` while the task waits on a person; see {@link TaskCardTask.blockedOn}. */
-    readonly status: TaskCardStatus | "blocked";
-    readonly blockedOn?: TaskCardBlocker;
-    /**
-     * The first sentence of the result once settled. A failure's line appears
-     * only in a private conversation, since error text can carry internals.
-     */
-    readonly summary?: string;
-    /**
-     * Why a cancelled task stopped: `task_cancel` when the model no longer
-     * needed it. Absent when the task's run stopped on its own.
-     */
-    readonly cancelReason?: TaskCancelReason;
-    readonly startedAt: string;
-    readonly settledAt?: string;
-}
-/**
- * One of the turn's own tool calls that doesn't run as a task, such as a call
- * to an app's `plan` tool whose input a renderer shows as rows.
- */
-export interface TaskCardAction {
-    /** The call's id. */
-    readonly id: string;
-    /** The tool name. */
-    readonly name: string;
-    /** The tool's start label, or the name's display title. */
-    readonly title: string;
-    readonly status: TaskCardStatus;
-    /** The call's input, when its JSON is at most 4,096 characters. */
-    readonly input?: Readonly<Record<string, unknown>>;
-    readonly startedAt: string;
-    readonly settledAt?: string;
-}
 /**
- * One turn's own tool calls: the tasks it started, and its other actions,
- * each in call order. `blocked` while any task waits on a person, `working`
- * while the turn or any other task works, then `finished`.
+ * One card of a turn. A turn keeps one card unless it starts a task after every task on its card
+ * ended, as a turn its caller keeps talking to does: that card is finished, and the next begins.
  */
-export interface TaskCardView {
+export interface TaskCard {
     readonly turnId: string;
+    /** Where the card begins on the stream: `0` for a turn's first card. */
+    readonly since: number;
+    /**
+     * `blocked` while any of its tasks waits on an interaction, `working` while one works, or, for the
+     * turn's latest card, while the turn does; then `finished`.
+     */
     readonly state: "working" | "blocked" | "finished";
-    readonly tasks: readonly TaskCardTask[];
-    readonly actions: readonly TaskCardAction[];
-}
-/** One call as a channel tracks it: plain JSON, kept in the channel's state. */
-interface TrackedCall {
-    readonly callId: string;
-    readonly name: string;
-    readonly title: string;
-    readonly status: TaskCardStatus;
-    readonly startedAt: string;
-    readonly input?: JsonObject;
-    readonly settledAt?: string;
-    readonly task?: {
-        readonly id: string;
-        readonly kind: "agent" | "tool";
-        readonly summary?: string;
-        readonly cancelReason?: TaskCancelReason;
-        /** Open requests and sign-ins the task waits on, oldest first. */
-        readonly blockers?: readonly (TaskCardBlocker & {
-            readonly id: string;
-        })[];
-    };
-}
-/** One turn's calls as a channel tracks them from its session's own events. */
-export interface TaskCardTurn {
-    readonly calls: readonly TrackedCall[];
-    readonly ended: boolean;
-}
-type TurnChanges = Readonly<Record<string, TaskCardTurn>>;
-/**
- * Folds one of the session's events into the turns' tracked calls, including
- * the requests a task's run relays through the session. Returns each turn it
- * changed, by turn id; none when the event changes no card.
- */
-export declare function trackTaskCardEvent(turns: Readonly<Record<string, TaskCardTurn>>, event: UnstampedMessageStreamEvent, at: string): TurnChanges;
-/**
- * Splits a turn's card when the turn starts a task after every task on the
- * card settled, which happens when the turn's caller keeps talking to an open
- * turn. The settled calls end as their own finished card; the calls still
- * working, including the one starting, open a new card. Returns nothing while
- * any of the card's tasks works.
- */
-export declare function closeSettledTasks(turn: TaskCardTurn, callId: string): {
-    readonly closed: TaskCardTurn;
-    readonly open: TaskCardTurn;
-} | undefined;
-/** The view a renderer draws one turn's card from. */
-export declare function taskCardView(turnId: string, turn: TaskCardTurn, options: {
+    /**
+     * The turn's calls the card shows, in call order. A task's call has a `taskId`. A call that
+     * isn't a task belongs to the card open when it ended, or to the latest card while it runs.
+     */
+    readonly calls: readonly CallObservation[];
+    /** The immutable observation snapshot used to build the card. */
+    readonly view: SessionView;
+    /** Who reads the card. A failed task's error and a request's prompt are for `private` only. */
     readonly audience: ChannelAudience;
-}): TaskCardView;
+}
+/** A turn's cards, oldest first; every card but the latest is finished. */
+export declare function taskCards(view: SessionTables, turnId: string, audience: ChannelAudience): readonly TaskCard[];
 /** The names of a turn's working tasks, for a status such as `Waiting on researcher...`. */
-export declare function workingTaskNames(turn: TaskCardTurn | undefined): readonly string[];
-export {};
+export declare function workingTaskNames(view: SessionTables, turnId: string): readonly string[];

package/dist/src/channel/task-card.js

@@ -1 +1 @@
-import{actionLabel,visibleActions}from"#shared/action-label.js";import{actionRequestName}from"#shared/action-request-name.js";import{displayTitle}from"#shared/display-name.js";import{firstSentence,normalizePresentationText}from"#shared/presentation-text.js";function trackTaskCardEvent(e,t,n){switch(t.type){case`input.requested`:{let{requests:n,taskId:r}=t.data;if(r===void 0)return{};let i=n.map(e=>blocker(e.requestId,e.kind===`question`?`input`:`approval`,e.prompt));return updateBlockers(e,r,e=>[...e,...i])}case`input.resolved`:{let n=new Set(t.data.resolutions.map(e=>e.requestId));return updateBlockers(e,void 0,e=>e.filter(e=>!n.has(e.id)))}case`authorization.required`:{let{taskId:n}=t.data;if(n===void 0)return{};let r=authorizationId(t.data),i=t.data.authorization?.displayName??t.data.name;return updateBlockers(e,n,e=>[...e.filter(e=>e.id!==r),blocker(r,`authorization`,i)])}case`authorization.completed`:{let n=authorizationId(t.data);return updateBlockers(e,t.data.taskId,e=>e.filter(e=>e.id!==n))}default:{let r=trackTurnEvent(e,t,n);return r===void 0?{}:{[r.turnId]:r.turn}}}}function blocker(e,t,n){let r=presentationText(n)?.slice(0,200);return r===void 0?{id:e,kind:t}:{id:e,kind:t,label:r}}function authorizationId(e){return e.attemptId??e.candidateId??e.name}function updateBlockers(e,t,n){let r={};for(let[i,a]of Object.entries(e))for(let e of a.calls){if(e.task===void 0||e.status!==`working`||t!==void 0&&e.task.id!==t)continue;let o=e.task.blockers??[],s=n(o);if(s.length===o.length&&s.every((e,t)=>e.id===o[t].id))continue;let c={...e.task,blockers:s};r[i]=replaceCall(r[i]??a,{...e,task:c})}return r}function trackTurnEvent(e,t,n){switch(t.type){case`actions.requested`:{let{turnId:r}=t.data,i=e[r]??{calls:[],ended:!1},a=new Set(i.calls.map(e=>e.callId)),o=visibleActions(t.data.actions).filter(e=>!a.has(e.callId));if(o.length===0)return;let s=o.map(e=>requestedCall(e,t.data.presentation,n));return{turn:{...i,calls:bounded([...i.calls,...s])},turnId:r}}case`action.result`:{let{turnId:r}=t.data,i=e[r],a=i?.calls.find(e=>e.callId===t.data.result.callId);if(i===void 0||a===void 0||a.task!==void 0)return;let o=actionStatus(t.data.status);return{turn:replaceCall(i,{...a,settledAt:n,status:o}),turnId:r}}case`task.started`:{let{callId:r,kind:i,name:a,taskId:o,turnId:s}=t.data,c=e[s]??{calls:[],ended:!1},l=c.calls.find(e=>e.callId===r)??{callId:r,name:a,startedAt:n,status:`working`,title:displayTitle(a)};return{turn:replaceCall(c,{callId:l.callId,name:l.name,startedAt:l.startedAt,status:`working`,task:{id:o,kind:i},title:l.title}),turnId:s}}case`task.settled`:{let{callId:r,status:i,turnId:a}=t.data,o=e[a],s=o?.calls.find(e=>e.callId===r);if(o===void 0||s?.task===void 0)return;let c={id:s.task.id,kind:s.task.kind},l=taskSummary(t.data);l!==void 0&&(c.summary=l);let u=t.data.cancel?.reason;return u!==void 0&&(c.cancelReason=u),{turn:replaceCall(o,{...s,settledAt:n,status:i,task:c}),turnId:a}}case`turn.completed`:case`turn.failed`:case`turn.cancelled`:{let n=e[t.data.turnId];return n===void 0||n.ended?void 0:{turn:{...n,ended:!0},turnId:t.data.turnId}}default:return}}function closeSettledTasks(e,t){let n=e.calls.filter(e=>e.task!==void 0&&e.callId!==t);if(!(n.length===0||n.some(e=>e.status===`working`)))return{closed:{calls:e.calls.filter(e=>e.status!==`working`),ended:!0},open:{calls:e.calls.filter(e=>e.status===`working`),ended:!1}}}function taskCardView(e,t,n){let r=[],i=[];for(let e of t.calls)e.task===void 0?i.push(toAction(e)):r.push(toTask(e,e.task,n.audience));return{actions:i,state:r.some(e=>e.status===`blocked`)?`blocked`:!t.ended||r.some(e=>e.status===`working`)?`working`:`finished`,tasks:r,turnId:e}}function workingTaskNames(e){return(e?.calls??[]).filter(e=>e.task!==void 0&&e.status===`working`).map(e=>e.name)}function requestedCall(e,t,n){let r=actionRequestName(e),i={callId:e.callId,name:r,startedAt:n,status:`working`,title:actionLabel(e,t)},a=boundedInput(e.input);return a!==void 0&&(i.input=a),i}function toAction(e){let t={id:e.callId,name:e.name,startedAt:e.startedAt,status:e.status,title:e.title};return e.input!==void 0&&(t.input=e.input),e.settledAt!==void 0&&(t.settledAt=e.settledAt),t}function toTask(e,t,n){let r={id:e.callId,kind:t.kind,name:e.name,startedAt:e.startedAt,status:e.status,taskId:t.id,title:e.title},i=n===`private`,a=e.status===`working`?t.blockers?.at(-1):void 0;a!==void 0&&(r.status=`blocked`,r.blockedOn=i&&a.label!==void 0?{kind:a.kind,label:a.label}:{kind:a.kind});let o=e.status!==`failed`||i;return t.summary!==void 0&&o&&(r.summary=t.summary),t.cancelReason!==void 0&&(r.cancelReason=t.cancelReason),e.settledAt!==void 0&&(r.settledAt=e.settledAt),r}function replaceCall(e,t){let n=e.calls.some(e=>e.callId===t.callId)?e.calls.map(e=>e.callId===t.callId?t:e):[...e.calls,t];return{...e,calls:bounded(n)}}function bounded(e){let t=e.length-100;return t<=0?e:e.filter(e=>t>0&&e.status!==`working`?(--t,!1):!0)}function actionStatus(e){switch(e){case`completed`:case`cancelled`:return e;default:return`failed`}}function boundedInput(e){if(typeof e==`object`&&e&&!Array.isArray(e))return JSON.stringify(e).length<=4096?e:void 0}function taskSummary(e){switch(e.status){case`completed`:return brief(resultText(e.output));case`failed`:return brief(e.error?.message);default:return}}function resultText(e){if(typeof e==`string`)return e;if(typeof e!=`object`||!e||Array.isArray(e))return;let t=e;return t.message??t.text??t.summary}function brief(e){return typeof e==`string`?firstSentence(e):void 0}function presentationText(e){if(e===void 0)return;let t=normalizePresentationText(e);return t===``?void 0:t}export{closeSettledTasks,taskCardView,trackTaskCardEvent,workingTaskNames};
+import{callTurn,openInteractions}from"#protocol/session-projection/selectors.js";import{snapshotOf}from"#protocol/session-projection/session-view.js";import{call}from"#protocol/session-projection/public-view.js";function taskCards(e,t,n){let r=turnCalls(e,t),i=[0],a=[];for(let e of r)e.taskId!==void 0&&(a.length>0&&a.every(t=>t.closedAt!==void 0&&t.closedAt<e.introducedAt)&&(i.push(e.introducedAt),a=[]),a.push(e));let cardOf=e=>{let t=e.taskId===void 0?e.closedAt??1/0:e.introducedAt;return i.findLastIndex(e=>e<=t)},o=e.turns[t]?.status!==`settled`,s=snapshotOf(e);return i.map((a,c)=>{let l=bounded(r.filter(e=>cardOf(e)===c)),u=l.filter(e=>e.taskId!==void 0&&e.status!==`settled`),d=c===i.length-1,f=u.some(t=>openInteractions(e,{about:{callId:t.callId}}).length>0)?`blocked`:u.length>0||d&&o?`working`:`finished`;return{audience:n,calls:l.flatMap(e=>call(s,e.callId)??[]),since:a,state:f,turnId:t,view:s}})}function workingTaskNames(e,t){return turnCalls(e,t).filter(e=>e.taskId!==void 0&&e.status!==`settled`).map(e=>e.capability.name)}function turnCalls(e,t){return Object.values(e.calls).filter(n=>n.capability.kind!==`control`&&!(`callId`in n.owner)&&callTurn(e,n)===t).sort((e,t)=>e.introducedAt-t.introducedAt)}function bounded(e){let t=e.length-100;return t<=0?e:e.filter(e=>t>0&&e.status===`settled`?(--t,!1):!0)}export{taskCards,workingTaskNames};