eve 0.47.6 → 0.48.0

package/dist/src/execution/wire/session-inbox-encoder.d.ts

@@ -1,10 +1,11 @@
 import type { DeliverHookPayload, SessionCommand, SessionTimeoutHookPayload } from "#channel/types.js";
 import { type SessionInboxWireV1 } from "#execution/wire/session-inbox-wire.v1.js";
 import { type SessionInboxWireV2 } from "#execution/wire/session-inbox-wire.v2.js";
+import { type SessionInboxWireV3 } from "#execution/wire/session-inbox-wire.v3.js";
 import { type SessionInboxWireTarget, type SessionInboxWireVersion } from "#execution/wire/session-inbox-contract.js";
 type SessionInboxCommand = DeliverHookPayload | SessionCommand | SessionTimeoutHookPayload;
 /** Current wire type consumed after migration. */
-export type SessionInboxWire = SessionInboxWireV2;
+export type SessionInboxWire = SessionInboxWireV3;
 type LegacySessionInboxWireTarget = Extract<SessionInboxWireTarget, {
     readonly version: 0;
 }>;
@@ -15,11 +16,14 @@ declare function encode(command: SessionInboxCommand, target: {
 declare function encode(command: SessionInboxCommand, target: {
     readonly version: 2;
 }): SessionInboxWireV2;
+declare function encode(command: SessionInboxCommand, target: {
+    readonly version: 3;
+}): SessionInboxWireV3;
 declare function encode(command: SessionInboxCommand, target: {
     readonly version: SessionInboxWireVersion;
 }): unknown;
 declare function encode(command: SessionInboxCommand, target: LegacySessionInboxWireTarget): Record<string, unknown>;
-declare function encode(command: SessionInboxCommand, target: SessionInboxWireTarget): SessionInboxWireV1 | SessionInboxWireV2 | Record<string, unknown>;
+declare function encode(command: SessionInboxCommand, target: SessionInboxWireTarget): SessionInboxWireV1 | SessionInboxWireV2 | SessionInboxWireV3 | Record<string, unknown>;
 /** Server/step-safe producer facade. */
 export declare const sessionInboxWire: {
     readonly encode: typeof encode;

package/dist/src/execution/wire/session-inbox-encoder.js

@@ -1 +1 @@
-import{SessionInboxWireError,isSessionInboxWireVersion}from"#execution/wire/session-inbox-contract.js";import{encodeSessionCommandV1}from"#execution/wire/session-inbox-wire.v1.js";import{encodeSessionCommandV2}from"#execution/wire/session-inbox-wire.v2.js";import{encodeSessionCommandV0}from"#execution/wire/session-inbox-wire.v0.js";const versionedEncoders={1:e=>encodeSessionCommandV1(withoutActivityObserver(e)),2:encodeSessionCommandV2};function encode(r,i){if(i.version===0)return encodeSessionCommandV0(encodeSessionCommandV1(withoutActivityObserver(r)),i.variant);if(isSessionInboxWireVersion(i.version))return versionedEncoders[i.version](r);throw new SessionInboxWireError(`Cannot encode session inbox payload for unknown wire version ${JSON.stringify(i.version)}.`)}function withoutActivityObserver(e){if(!(`caller`in e)||e.caller?.activityObserver===void 0)return e;let{activityObserver:t,...n}=e.caller;return{...e,caller:n}}const sessionInboxWire={encode};export{sessionInboxWire};
+import{SessionInboxWireError,isSessionInboxWireVersion}from"#execution/wire/session-inbox-contract.js";import{encodeSessionCommandV1}from"#execution/wire/session-inbox-wire.v1.js";import{encodeSessionCommandV2}from"#execution/wire/session-inbox-wire.v2.js";import{encodeSessionCommandV3}from"#execution/wire/session-inbox-wire.v3.js";import{encodeSessionCommandV0}from"#execution/wire/session-inbox-wire.v0.js";const versionedEncoders={1:e=>encodeSessionCommandV1(withoutAcceptedDeployment(e)),2:e=>encodeSessionCommandV2(withoutAcceptedDeployment(e)),3:encodeSessionCommandV3};function encode(r,i){if(i.version===0){let e=encodeSessionCommandV0(encodeSessionCommandV1(withoutAcceptedDeployment(r)),i.variant),t=e,a=t.delivery,o=readAcceptedDeploymentId(r);return i.variant!==`send`||o===void 0||t.kind!==`send`||typeof a!=`object`||!a?e:{...e,delivery:{...a,acceptedDeploymentId:o}}}if(isSessionInboxWireVersion(i.version))return versionedEncoders[i.version](r);throw new SessionInboxWireError(`Cannot encode session inbox payload for unknown wire version ${JSON.stringify(i.version)}.`)}function withoutAcceptedDeployment(e){if(e.kind===`send`&&e.delivery?.acceptedDeploymentId!==void 0){let{acceptedDeploymentId:t,...n}=e.delivery;return{...e,delivery:n}}return e.kind!==`deliver`||e.deliveryMetadata===void 0?e:{...e,deliveryMetadata:e.deliveryMetadata.map(e=>{let{acceptedDeploymentId:t,...n}=e;return n})}}function readAcceptedDeploymentId(e){if(e.kind===`send`)return e.delivery?.acceptedDeploymentId;if(e.kind===`deliver`)return e.deliveryMetadata?.find(e=>e.payloadIndex===0)?.acceptedDeploymentId}const sessionInboxWire={encode};export{sessionInboxWire};

package/dist/src/execution/wire/session-inbox-resume.js

@@ -1 +1 @@
-import{sessionCommandHookToken}from"#execution/session-command-token.js";import{isObject}from"#shared/guards.js";import{getHookByToken,resumeHook}from"#internal/workflow/runtime.js";import{HookNotFoundError}from"#compiled/@workflow/errors/index.js";import{SESSION_INBOX_WIRE_VERSION_METADATA_KEY,SessionInboxWireError,isSessionInboxWireVersion}from"#execution/wire/session-inbox-contract.js";import{sessionInboxWire}from"#execution/wire/session-inbox-encoder.js";async function resumeSessionInbox(e,t){let r=await getHookByToken(e),i=await resolveSessionInboxWireTarget(r);return await resumeHook(r,sessionInboxWire.encode(t,i))}async function resolveSessionInboxWireTarget(n){let a=isObject(n.metadata)?n.metadata:void 0;if(a!==void 0&&SESSION_INBOX_WIRE_VERSION_METADATA_KEY in a){let e=a[SESSION_INBOX_WIRE_VERSION_METADATA_KEY];if(isSessionInboxWireVersion(e))return{version:e};throw new SessionInboxWireError(`Session inbox target declares unsupported wire version ${JSON.stringify(e)}.`)}let o=sessionCommandHookToken(n.runId);if(n.token===o)return{variant:`send`,version:0};try{let e=await getHookByToken(o);if(e.runId!==n.runId)throw new SessionInboxWireError(`Stable session inbox ${JSON.stringify(o)} belongs to run ${JSON.stringify(e.runId)}, expected ${JSON.stringify(n.runId)}.`);return{variant:`send`,version:0}}catch(e){if(HookNotFoundError.is(e))return{variant:`deliver`,version:0};throw e}}export{resolveSessionInboxWireTarget,resumeSessionInbox};
+import{isSessionCommandHookToken,sessionCommandHookToken}from"#execution/session-command-token.js";import{isObject}from"#shared/guards.js";import{getHookByToken,resumeHook}from"#internal/workflow/runtime.js";import{HookNotFoundError}from"#compiled/@workflow/errors/index.js";import{SESSION_INBOX_WIRE_VERSION_METADATA_KEY,SessionInboxWireError,isSessionInboxWireVersion}from"#execution/wire/session-inbox-contract.js";import{sessionInboxWire}from"#execution/wire/session-inbox-encoder.js";async function resumeSessionInbox(e,t){if(isStableInboxFastPathCompatible(e,t))return await resumeHook(e,sessionInboxWire.encode(t,{variant:`send`,version:0}));let n=await getHookByToken(e),i=await resolveSessionInboxWireTarget(n);return await resumeHook(n,sessionInboxWire.encode(t,i))}function isStableInboxFastPathCompatible(t,n){return isSessionCommandHookToken(t)?!(`caller`in n&&n.caller?.activityObserver!==void 0):!1}async function resolveSessionInboxWireTarget(e){let r=isObject(e.metadata)?e.metadata:void 0;if(r!==void 0&&SESSION_INBOX_WIRE_VERSION_METADATA_KEY in r){let e=r[SESSION_INBOX_WIRE_VERSION_METADATA_KEY];if(isSessionInboxWireVersion(e))return{version:e};throw new SessionInboxWireError(`Session inbox target declares unsupported wire version ${JSON.stringify(e)}.`)}let a=sessionCommandHookToken(e.runId);if(e.token===a)return{variant:`send`,version:0};try{let t=await getHookByToken(a);if(t.runId!==e.runId)throw new SessionInboxWireError(`Stable session inbox ${JSON.stringify(a)} belongs to run ${JSON.stringify(t.runId)}, expected ${JSON.stringify(e.runId)}.`);return{variant:`send`,version:0}}catch(e){if(HookNotFoundError.is(e))return{variant:`deliver`,version:0};throw e}}export{resolveSessionInboxWireTarget,resumeSessionInbox};

package/dist/src/execution/wire/session-inbox-wire.js

@@ -1 +1 @@
-import{SESSION_INBOX_WIRE_VERSION,SessionInboxWireError,SessionInboxWireError as SessionInboxWireError$1}from"#execution/wire/session-inbox-contract.js";import{sessionInboxWireV0Migration}from"#execution/wire/session-inbox-wire.v0.js";import{runMigrationChain}from"#execution/durable-session-migrations/chain.js";import{normalizeSessionInboxWireV2,sessionInboxWireV1Migration}from"#execution/wire/session-inbox-wire.v2-migration.js";const WIRE_LABEL=`session inbox payload`,sessionInboxMigrations=[sessionInboxWireV0Migration,sessionInboxWireV1Migration];function decode(t){let n=typeof t==`object`&&t&&`version`in t?t.version:void 0,r;try{r=runMigrationChain({initialVersion:0,label:WIRE_LABEL,migrations:sessionInboxMigrations,targetVersion:SESSION_INBOX_WIRE_VERSION,value:t})}catch(e){throw new SessionInboxWireError$1(e instanceof Error?e.message:String(e))}let i=normalizeSessionInboxWireV2(r);if(i.version!==SESSION_INBOX_WIRE_VERSION)throw new SessionInboxWireError$1(`${WIRE_LABEL} declares version ${JSON.stringify(i.version)}, expected ${SESSION_INBOX_WIRE_VERSION}.`);if(n===2&&i.kind===`deliver`&&!(`payload`in i))throw new SessionInboxWireError$1(`${WIRE_LABEL} does not match wire version 2.`);return normalizeWire(i)}const sessionInboxWire={decode};function normalizeWire(e){switch(e.kind){case`deliver`:return{auth:e.auth,caller:e.caller,deliveryMetadata:e.deliveryMetadata,kind:`deliver`,payloads:e.payloads,requestId:e.requestId,taskDeliveryId:e.taskDeliveryId,turnPolicy:e.turnPolicy};case`session-timeout`:return{kind:`session-timeout`};case`clear`:return{kind:`clear`};case`compact`:return{kind:`compact`};case`reset`:return{kind:`reset`,reason:e.reason};case`cancel`:return{kind:`cancel`,taskId:e.taskId,turnId:e.turnId};default:throw new SessionInboxWireError$1(`${WIRE_LABEL} has an unrecognized kind ${JSON.stringify(e.kind)}.`)}}export{SessionInboxWireError,sessionInboxWire};
+import{SESSION_INBOX_WIRE_VERSION,SessionInboxWireError,SessionInboxWireError as SessionInboxWireError$1}from"#execution/wire/session-inbox-contract.js";import{sessionInboxWireV0Migration}from"#execution/wire/session-inbox-wire.v0.js";import{runMigrationChain}from"#execution/durable-session-migrations/chain.js";import{normalizeSessionInboxWireV2}from"#execution/wire/session-inbox-wire.v2-migration.js";import{sessionInboxWireV1Migration}from"#execution/wire/session-inbox-wire.v2.migration.js";import{sessionInboxWireV2Migration}from"#execution/wire/session-inbox-wire.v3.migration.js";const WIRE_LABEL=`session inbox payload`,sessionInboxMigrations=[sessionInboxWireV0Migration,sessionInboxWireV1Migration,sessionInboxWireV2Migration];function decode(t){let n=typeof t==`object`&&t&&`version`in t?t.version:void 0;if(typeof t==`object`&&t&&`version`in t&&typeof n!=`number`)throw new SessionInboxWireError$1(`${WIRE_LABEL}: value has no numeric "version" field.`);let r=normalizeSessionInboxWireV2(t),i;try{i=runMigrationChain({initialVersion:0,label:WIRE_LABEL,migrations:sessionInboxMigrations,targetVersion:SESSION_INBOX_WIRE_VERSION,value:r})}catch(e){throw new SessionInboxWireError$1(e instanceof Error?e.message:String(e))}let a=normalizeSessionInboxWireV2(i);if(a.version!==SESSION_INBOX_WIRE_VERSION)throw new SessionInboxWireError$1(`${WIRE_LABEL} declares version ${JSON.stringify(a.version)}, expected ${SESSION_INBOX_WIRE_VERSION}.`);if(typeof n==`number`&&n>=2&&a.kind===`deliver`&&!(`payload`in a))throw new SessionInboxWireError$1(`${WIRE_LABEL} does not match wire version ${n}.`);return normalizeWire(a)}const sessionInboxWire={decode};function normalizeWire(e){switch(e.kind){case`deliver`:return{auth:e.auth,caller:e.caller,deliveryMetadata:e.deliveryMetadata,kind:`deliver`,payloads:e.payloads,requestId:e.requestId,taskDeliveryId:e.taskDeliveryId,turnPolicy:e.turnPolicy};case`session-timeout`:return{kind:`session-timeout`};case`clear`:return{kind:`clear`};case`compact`:return{kind:`compact`};case`reset`:return{kind:`reset`,reason:e.reason};case`cancel`:return{kind:`cancel`,taskId:e.taskId,turnId:e.turnId};default:throw new SessionInboxWireError$1(`${WIRE_LABEL} has an unrecognized kind ${JSON.stringify(e.kind)}.`)}}export{SessionInboxWireError,sessionInboxWire};

package/dist/src/execution/wire/session-inbox-wire.v1.js

@@ -1 +1 @@
-import{z}from"#compiled/zod/index.js";import{inputRequestSchema,inputResponseSchema}from"#shared/input.js";import{formatValidationError}from"#runtime/validation.js";import{jsonObjectSchema,jsonValueSchema}from"#shared/json-schemas.js";import{coalesceDeliverPayloads}from"#execution/deliver-payloads.js";import{tokenUsageSchema}from"#shared/token-usage.js";import{SessionInboxWireError}from"#execution/wire/session-inbox-contract.js";const providerOptionsSchema=z.record(z.string(),jsonObjectSchema),textPartSchema=z.object({providerOptions:providerOptionsSchema.optional(),text:z.string(),type:z.literal(`text`)}).strict(),binaryDataSchema=z.custom(e=>typeof e==`string`||e instanceof Uint8Array||e instanceof ArrayBuffer||e instanceof URL,`Expected a string, URL, Uint8Array, or ArrayBuffer.`),imagePartSchema=z.object({image:binaryDataSchema,mediaType:z.string().optional(),providerOptions:providerOptionsSchema.optional(),type:z.literal(`image`)}).strict(),filePartSchema=z.object({data:binaryDataSchema,filename:z.string().optional(),mediaType:z.string(),providerOptions:providerOptionsSchema.optional(),type:z.literal(`file`)}).strict(),userContentSchema=z.union([z.string(),z.array(z.discriminatedUnion(`type`,[textPartSchema,imagePartSchema,filePartSchema]))]),eventCoordinateSchema=z.number().int().nonnegative(),opaqueObjectSchema=z.custom(e=>typeof e==`object`&&!!e&&!Array.isArray(e),`Expected an object.`),subagentInputRequestHookPayloadSchema=z.object({callId:z.string(),childContinuationToken:z.string(),childSessionId:z.string(),event:z.object({requests:z.array(inputRequestSchema),sequence:eventCoordinateSchema,stepIndex:eventCoordinateSchema,turnId:z.string()}).strict(),kind:z.literal(`subagent-input-request`),subagentName:z.string()}).strict(),subagentAuthorizationEventHookPayloadSchema=z.object({callId:z.string(),childSessionId:z.string(),event:opaqueObjectSchema,kind:z.literal(`subagent-authorization-event`),subagentName:z.string()}).strict(),taskMetadataSchema=z.union([z.object({agentId:z.string(),kind:z.literal(`subagent`),mode:z.enum([`local`,`remote`]),name:z.string()}).strict(),z.object({kind:z.string(),name:z.string()}).strict()]),taskViewBase={executor:z.object({binding:z.object({data:z.record(z.string(),jsonValueSchema),kind:z.string()}).strict().optional(),childSessionId:z.string().optional(),childTurnId:z.string().optional(),lifecycle:z.enum([`parked`,`terminal`]).optional()}).strict().optional(),metadata:taskMetadataSchema,taskId:z.string(),usage:tokenUsageSchema.optional()},taskViewSchema=z.discriminatedUnion(`status`,[z.object({...taskViewBase,status:z.literal(`working`)}).strict(),z.object({...taskViewBase,inputRequests:z.array(jsonValueSchema),status:z.literal(`input_required`)}).strict(),z.object({...taskViewBase,lastOutput:z.object({data:jsonValueSchema,type:z.literal(`result`)}).strict(),status:z.literal(`completed`)}).strict(),z.object({...taskViewBase,lastOutput:z.object({data:jsonValueSchema,type:z.literal(`error`)}).strict(),status:z.literal(`failed`)}).strict(),z.object({...taskViewBase,status:z.literal(`cancelled`)}).strict()]),taskPayloadSchema=z.object({authorizationEvents:z.array(z.object({hookPayload:subagentAuthorizationEventHookPayloadSchema,taskId:z.string()}).strict()).optional(),inputRequests:z.array(z.object({hookPayload:subagentInputRequestHookPayloadSchema,taskId:z.string()}).strict()).optional(),views:z.array(taskViewSchema).optional()}).strict(),deliverPayloadSchema=z.object({context:z.array(z.string()).optional(),inputResponses:z.array(inputResponseSchema).optional(),message:userContentSchema.optional(),outputSchema:jsonObjectSchema.optional(),task:taskPayloadSchema.optional()}).loose(),authSchema=z.object({attributes:z.record(z.string(),z.union([z.string(),z.array(z.string())])),authenticator:z.string(),issuer:z.string().optional(),principalId:z.string(),principalType:z.string(),subject:z.string().optional()}).strict(),callerSchema=z.object({callId:z.string(),replyTo:z.discriminatedUnion(`kind`,[z.object({kind:z.literal(`hook`),token:z.string()}).strict(),z.object({kind:z.literal(`callback`),token:z.string(),url:z.string()}).strict()]),subagentName:z.string(),taskId:z.string().optional()}).strict(),traceContextSchema=z.object({spanId:z.string(),traceFlags:z.number(),traceId:z.string()}).strict(),deliveryMetadataSchema=z.object({channelKind:z.string(),channelName:z.string(),deliveryId:z.string(),payloadIndex:z.number().int().nonnegative(),requestId:z.string().optional(),requestTraceContext:traceContextSchema.optional()}).strict(),version=z.literal(1),sessionInboxWireV1Schema=z.discriminatedUnion(`kind`,[z.object({auth:authSchema.nullable().optional(),caller:callerSchema.optional(),deliveryMetadata:z.array(deliveryMetadataSchema).optional(),kind:z.literal(`deliver`),payload:deliverPayloadSchema.optional(),payloads:z.array(deliverPayloadSchema),requestId:z.string().optional(),taskDeliveryId:z.string().optional(),turnPolicy:z.enum([`queue`,`steer`]).optional(),version}).strict(),z.object({kind:z.literal(`session-timeout`),version}).strict(),z.object({kind:z.literal(`clear`),version}).strict(),z.object({kind:z.literal(`compact`),version}).strict(),z.object({kind:z.literal(`reset`),reason:z.string().optional(),version}).strict(),z.object({kind:z.literal(`cancel`),taskId:z.string().optional(),turnId:z.string().optional(),version}).strict()]);function encodeSessionCommandV1(e){let t=e.kind===`send`?{auth:e.auth,caller:e.caller,deliveryMetadata:e.delivery===void 0?void 0:[{...e.delivery,payloadIndex:0}],kind:`deliver`,payload:e.payload,payloads:[e.payload],requestId:e.requestId,taskDeliveryId:e.taskDeliveryId,turnPolicy:e.turnPolicy,version:1}:e.kind===`deliver`?{...e,payload:coalesceDeliverPayloads(e.payloads),version:1}:{...e,version:1},n=sessionInboxWireV1Schema.safeParse(t);if(!n.success)throw new SessionInboxWireError(`Produced a session inbox payload that does not match wire version 1: ${formatValidationError(n.error)}`);return n.data}export{encodeSessionCommandV1,sessionInboxWireV1Schema};
+import{z}from"#compiled/zod/index.js";import{inputRequestSchema,inputResponseSchema}from"#shared/input.js";import{formatValidationError}from"#runtime/validation.js";import{jsonObjectSchema,jsonValueSchema}from"#shared/json-schemas.js";import{coalesceDeliverPayloads}from"#execution/deliver-payloads.js";import{tokenUsageSchema}from"#shared/token-usage.js";import{SessionInboxWireError}from"#execution/wire/session-inbox-contract.js";const providerOptionsSchema=z.record(z.string(),jsonObjectSchema),textPartSchema=z.object({providerOptions:providerOptionsSchema.optional(),text:z.string(),type:z.literal(`text`)}).strict(),binaryDataSchema=z.custom(e=>typeof e==`string`||e instanceof Uint8Array||e instanceof ArrayBuffer||e instanceof URL,`Expected a string, URL, Uint8Array, or ArrayBuffer.`),imagePartSchema=z.object({image:binaryDataSchema,mediaType:z.string().optional(),providerOptions:providerOptionsSchema.optional(),type:z.literal(`image`)}).strict(),filePartSchema=z.object({data:binaryDataSchema,filename:z.string().optional(),mediaType:z.string(),providerOptions:providerOptionsSchema.optional(),type:z.literal(`file`)}).strict(),userContentSchema=z.union([z.string(),z.array(z.discriminatedUnion(`type`,[textPartSchema,imagePartSchema,filePartSchema]))]),eventCoordinateSchema=z.number().int().nonnegative(),opaqueObjectSchema=z.custom(e=>typeof e==`object`&&!!e&&!Array.isArray(e),`Expected an object.`),subagentInputRequestHookPayloadSchema=z.object({callId:z.string(),childContinuationToken:z.string(),childSessionId:z.string(),event:z.object({requests:z.array(inputRequestSchema),sequence:eventCoordinateSchema,stepIndex:eventCoordinateSchema,turnId:z.string()}).strict(),kind:z.literal(`subagent-input-request`),subagentName:z.string()}).strict(),subagentAuthorizationEventHookPayloadSchema=z.object({callId:z.string(),childSessionId:z.string(),event:opaqueObjectSchema,kind:z.literal(`subagent-authorization-event`),subagentName:z.string()}).strict(),taskMetadataSchema=z.union([z.object({agentId:z.string(),kind:z.literal(`subagent`),mode:z.enum([`local`,`remote`]),name:z.string()}).strict(),z.object({kind:z.string(),name:z.string()}).strict()]),taskViewBase={executor:z.object({binding:z.object({data:z.record(z.string(),jsonValueSchema),kind:z.string()}).strict().optional(),childSessionId:z.string().optional(),childTurnId:z.string().optional(),lifecycle:z.enum([`parked`,`terminal`]).optional()}).strict().optional(),metadata:taskMetadataSchema,taskId:z.string(),usage:tokenUsageSchema.optional()},taskViewSchema=z.discriminatedUnion(`status`,[z.object({...taskViewBase,status:z.literal(`working`)}).strict(),z.object({...taskViewBase,inputRequests:z.array(jsonValueSchema),status:z.literal(`input_required`)}).strict(),z.object({...taskViewBase,lastOutput:z.object({data:jsonValueSchema,type:z.literal(`result`)}).strict(),status:z.literal(`completed`)}).strict(),z.object({...taskViewBase,lastOutput:z.object({data:jsonValueSchema,type:z.literal(`error`)}).strict(),status:z.literal(`failed`)}).strict(),z.object({...taskViewBase,status:z.literal(`cancelled`)}).strict()]),taskPayloadSchema=z.object({authorizationEvents:z.array(z.object({hookPayload:subagentAuthorizationEventHookPayloadSchema,taskId:z.string()}).strict()).optional(),inputRequests:z.array(z.object({hookPayload:subagentInputRequestHookPayloadSchema,taskId:z.string()}).strict()).optional(),views:z.array(taskViewSchema).optional()}).strict(),deliverPayloadSchema=z.object({context:z.array(z.string()).optional(),inputResponses:z.array(inputResponseSchema).optional(),message:userContentSchema.optional(),outputSchema:jsonObjectSchema.optional(),task:taskPayloadSchema.optional()}).loose(),authSchema=z.object({attributes:z.record(z.string(),z.union([z.string(),z.array(z.string())])),authenticator:z.string(),issuer:z.string().optional(),principalId:z.string(),principalType:z.string(),subject:z.string().optional()}).strict(),callerSchema=z.object({callId:z.string(),replyTo:z.discriminatedUnion(`kind`,[z.object({kind:z.literal(`hook`),token:z.string()}).strict(),z.object({kind:z.literal(`callback`),token:z.string(),url:z.string()}).strict()]),subagentName:z.string(),taskId:z.string().optional()}).strict(),callerProjectionSchema=callerSchema.strip(),traceContextSchema=z.object({spanId:z.string(),traceFlags:z.number(),traceId:z.string()}).strict(),deliveryMetadataSchema=z.object({channelKind:z.string(),channelName:z.string(),deliveryId:z.string(),payloadIndex:z.number().int().nonnegative(),requestId:z.string().optional(),requestTraceContext:traceContextSchema.optional()}).strict(),version=z.literal(1),sessionInboxWireV1Schema=z.discriminatedUnion(`kind`,[z.object({auth:authSchema.nullable().optional(),caller:callerSchema.optional(),deliveryMetadata:z.array(deliveryMetadataSchema).optional(),kind:z.literal(`deliver`),payload:deliverPayloadSchema.optional(),payloads:z.array(deliverPayloadSchema),requestId:z.string().optional(),taskDeliveryId:z.string().optional(),turnPolicy:z.enum([`queue`,`steer`]).optional(),version}).strict(),z.object({kind:z.literal(`session-timeout`),version}).strict(),z.object({kind:z.literal(`clear`),version}).strict(),z.object({kind:z.literal(`compact`),version}).strict(),z.object({kind:z.literal(`reset`),reason:z.string().optional(),version}).strict(),z.object({kind:z.literal(`cancel`),taskId:z.string().optional(),turnId:z.string().optional(),version}).strict()]);function encodeSessionCommandV1(e){let t=toV1Command(e),n=t.kind===`send`?{auth:t.auth,caller:t.caller,deliveryMetadata:t.delivery===void 0?void 0:[{...t.delivery,payloadIndex:0}],kind:`deliver`,payload:t.payload,payloads:[t.payload],requestId:t.requestId,taskDeliveryId:t.taskDeliveryId,turnPolicy:t.turnPolicy,version:1}:t.kind===`deliver`?{...t,payload:coalesceDeliverPayloads(t.payloads),version:1}:{...t,version:1},r=sessionInboxWireV1Schema.safeParse(n);if(!r.success)throw new SessionInboxWireError(`Produced a session inbox payload that does not match wire version 1: ${formatValidationError(r.error)}`);return r.data}function toV1Command(e){return!(`caller`in e)||e.caller===void 0?e:{...e,caller:toV1Caller(e.caller)}}function toV1Caller(e){let t=callerProjectionSchema.safeParse(e);if(!t.success)throw new SessionInboxWireError(`Produced a session inbox payload that does not match wire version 1: ${formatValidationError(t.error)}`);return t.data}export{encodeSessionCommandV1,sessionInboxWireV1Schema};

package/dist/src/execution/wire/session-inbox-wire.v2-migration.d.ts

@@ -1,4 +1,2 @@
-import type { VersionMigration } from "#execution/durable-session-migrations/chain.js";
-export declare const sessionInboxWireV1Migration: VersionMigration;
 /** Converts Workflow-VM records into this realm before wire consumption. */
 export declare function normalizeSessionInboxWireV2(value: unknown, arrayFallback?: boolean): unknown;

package/dist/src/execution/wire/session-inbox-wire.v2-migration.js

@@ -1 +1 @@
-import{isObject}from"#shared/guards.js";const sessionInboxWireV1Migration={from:1,migrate(e){let t=normalizeSessionInboxWireV2(e);return{...t,...t.kind===`deliver`&&!(`payload`in t)?{payload:{}}:{},version:2}},to:2};function normalizeSessionInboxWireV2(e,t=!1){return e===void 0?t?null:void 0:Array.isArray(e)?e.map(e=>normalizeSessionInboxWireV2(e,!0)):isPlainRecord$1(e)?Object.fromEntries(Object.entries(e).filter(e=>e[1]!==void 0).map(([e,t])=>[e,normalizeSessionInboxWireV2(t)])):e}function isPlainRecord$1(t){if(!isObject(t))return!1;let n=Object.getPrototypeOf(t);return n===null||n===Object.prototype||Object.getPrototypeOf(n)===null}export{normalizeSessionInboxWireV2,sessionInboxWireV1Migration};
+import{isObject}from"#shared/guards.js";function normalizeSessionInboxWireV2(e,t=!1){return e===void 0?t?null:void 0:Array.isArray(e)?e.map(e=>normalizeSessionInboxWireV2(e,!0)):isPlainRecord$1(e)?Object.fromEntries(Object.entries(e).filter(e=>e[1]!==void 0).map(([e,t])=>[e,normalizeSessionInboxWireV2(t)])):e}function isPlainRecord$1(t){if(!isObject(t))return!1;let n=Object.getPrototypeOf(t);return n===null||n===Object.prototype||Object.getPrototypeOf(n)===null}export{normalizeSessionInboxWireV2};

package/dist/src/execution/wire/session-inbox-wire.v2.migration.d.ts

@@ -0,0 +1,3 @@
+import type { VersionMigration } from "#execution/durable-session-migrations/chain.js";
+/** Pure shape migration from the immutable v1 wire contract to v2. */
+export declare const sessionInboxWireV1Migration: VersionMigration;

package/dist/src/execution/wire/session-inbox-wire.v2.migration.js

@@ -0,0 +1 @@
+const sessionInboxWireV1Migration={from:1,migrate(e){let t=e,n={...t,version:2};return t.kind===`deliver`&&!(`payload`in t)&&(n.payload={}),n},to:2};export{sessionInboxWireV1Migration};

package/dist/src/execution/wire/session-inbox-wire.v3.d.ts

@@ -0,0 +1,480 @@
+import { z } from "#compiled/zod/index.js";
+import type { DeliverHookPayload, SessionCommand, SessionTimeoutHookPayload } from "#channel/types.js";
+/** Version 3 adds the trusted deployment that accepted each channel delivery. */
+export declare const sessionInboxWireV3Schema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    auth: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        attributes: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+        authenticator: z.ZodString;
+        issuer: z.ZodOptional<z.ZodString>;
+        principalId: z.ZodString;
+        principalType: z.ZodString;
+        subject: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    kind: z.ZodLiteral<"deliver">;
+    payloads: z.ZodArray<z.ZodObject<{
+        context: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        inputResponses: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            optionId: z.ZodOptional<z.ZodString>;
+            requestId: z.ZodString;
+            text: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        message: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<import("../../shared/json.ts").JsonObject, unknown, z.core.$ZodTypeInternals<import("../../shared/json.ts").JsonObject, unknown>>>>;
+            text: z.ZodString;
+            type: z.ZodLiteral<"text">;
+        }, z.core.$strict>, z.ZodObject<{
+            image: z.ZodCustom<URL | import("ai").DataContent, URL | import("ai").DataContent>;
+            mediaType: z.ZodOptional<z.ZodString>;
+            providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<import("../../shared/json.ts").JsonObject, unknown, z.core.$ZodTypeInternals<import("../../shared/json.ts").JsonObject, unknown>>>>;
+            type: z.ZodLiteral<"image">;
+        }, z.core.$strict>, z.ZodObject<{
+            data: z.ZodCustom<URL | import("ai").DataContent, URL | import("ai").DataContent>;
+            filename: z.ZodOptional<z.ZodString>;
+            mediaType: z.ZodString;
+            providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<import("../../shared/json.ts").JsonObject, unknown, z.core.$ZodTypeInternals<import("../../shared/json.ts").JsonObject, unknown>>>>;
+            type: z.ZodLiteral<"file">;
+        }, z.core.$strict>], "type">>]>>;
+        outputSchema: z.ZodOptional<z.ZodType<import("../../shared/json.ts").JsonObject, unknown, z.core.$ZodTypeInternals<import("../../shared/json.ts").JsonObject, unknown>>>;
+        task: z.ZodOptional<z.ZodObject<{
+            authorizationEvents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                hookPayload: z.ZodObject<{
+                    callId: z.ZodString;
+                    childSessionId: z.ZodString;
+                    event: z.ZodCustom<Record<string, unknown>, Record<string, unknown>>;
+                    kind: z.ZodLiteral<"subagent-authorization-event">;
+                    subagentName: z.ZodString;
+                }, z.core.$strict>;
+                taskId: z.ZodString;
+            }, z.core.$strict>>>;
+            inputRequests: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                hookPayload: z.ZodObject<{
+                    callId: z.ZodString;
+                    childContinuationToken: z.ZodString;
+                    childSessionId: z.ZodString;
+                    event: z.ZodObject<{
+                        requests: z.ZodArray<z.ZodObject<{
+                            action: z.ZodObject<{
+                                callId: z.ZodString;
+                                input: z.ZodType<import("../../shared/json.ts").JsonObject, unknown, z.core.$ZodTypeInternals<import("../../shared/json.ts").JsonObject, unknown>>;
+                                kind: z.ZodLiteral<"tool-call">;
+                                toolName: z.ZodString;
+                            }, z.core.$strict>;
+                            allowFreeform: z.ZodOptional<z.ZodBoolean>;
+                            display: z.ZodOptional<z.ZodEnum<{
+                                confirmation: "confirmation";
+                                select: "select";
+                                text: "text";
+                            }>>;
+                            kind: z.ZodEnum<{
+                                question: "question";
+                                "session-limit": "session-limit";
+                                "tool-approval": "tool-approval";
+                            }>;
+                            options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                                description: z.ZodOptional<z.ZodString>;
+                                id: z.ZodString;
+                                label: z.ZodString;
+                                style: z.ZodOptional<z.ZodEnum<{
+                                    danger: "danger";
+                                    default: "default";
+                                    primary: "primary";
+                                }>>;
+                            }, z.core.$strict>>>;
+                            prompt: z.ZodString;
+                            requestId: z.ZodString;
+                        }, z.core.$strict>>;
+                        sequence: z.ZodNumber;
+                        stepIndex: z.ZodNumber;
+                        turnId: z.ZodString;
+                    }, z.core.$strict>;
+                    kind: z.ZodLiteral<"subagent-input-request">;
+                    subagentName: z.ZodString;
+                }, z.core.$strict>;
+                taskId: z.ZodString;
+            }, z.core.$strict>>>;
+            views: z.ZodOptional<z.ZodArray<z.ZodType<import("../../tasks/types.ts").TaskView, unknown, z.core.$ZodTypeInternals<import("../../tasks/types.ts").TaskView, unknown>>>>;
+        }, z.core.$strict>>;
+    }, z.core.$loose>>;
+    requestId: z.ZodOptional<z.ZodString>;
+    taskDeliveryId: z.ZodOptional<z.ZodString>;
+    turnPolicy: z.ZodOptional<z.ZodEnum<{
+        queue: "queue";
+        steer: "steer";
+    }>>;
+    caller: z.ZodOptional<z.ZodObject<{
+        callId: z.ZodString;
+        replyTo: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"hook">;
+            token: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"callback">;
+            token: z.ZodString;
+            url: z.ZodString;
+        }, z.core.$strict>], "kind">;
+        subagentName: z.ZodString;
+        taskId: z.ZodOptional<z.ZodString>;
+        activityObserver: z.ZodOptional<z.ZodObject<{
+            sink: z.ZodObject<{
+                url: z.ZodString;
+                version: z.ZodLiteral<1>;
+            }, z.core.$strict>;
+            workIdentity: z.ZodOptional<z.ZodObject<{
+                callId: z.ZodOptional<z.ZodString>;
+                id: z.ZodString;
+                kind: z.ZodEnum<{
+                    "remote-agent": "remote-agent";
+                    "root-turn": "root-turn";
+                    subagent: "subagent";
+                    task: "task";
+                }>;
+                name: z.ZodOptional<z.ZodString>;
+                parentId: z.ZodOptional<z.ZodString>;
+                rootSessionId: z.ZodString;
+                rootTurnId: z.ZodString;
+                sessionId: z.ZodOptional<z.ZodString>;
+                turnId: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    payload: z.ZodObject<{
+        context: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        inputResponses: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            optionId: z.ZodOptional<z.ZodString>;
+            requestId: z.ZodString;
+            text: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        message: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<import("../../shared/json.ts").JsonObject, unknown, z.core.$ZodTypeInternals<import("../../shared/json.ts").JsonObject, unknown>>>>;
+            text: z.ZodString;
+            type: z.ZodLiteral<"text">;
+        }, z.core.$strict>, z.ZodObject<{
+            image: z.ZodCustom<URL | import("ai").DataContent, URL | import("ai").DataContent>;
+            mediaType: z.ZodOptional<z.ZodString>;
+            providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<import("../../shared/json.ts").JsonObject, unknown, z.core.$ZodTypeInternals<import("../../shared/json.ts").JsonObject, unknown>>>>;
+            type: z.ZodLiteral<"image">;
+        }, z.core.$strict>, z.ZodObject<{
+            data: z.ZodCustom<URL | import("ai").DataContent, URL | import("ai").DataContent>;
+            filename: z.ZodOptional<z.ZodString>;
+            mediaType: z.ZodString;
+            providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<import("../../shared/json.ts").JsonObject, unknown, z.core.$ZodTypeInternals<import("../../shared/json.ts").JsonObject, unknown>>>>;
+            type: z.ZodLiteral<"file">;
+        }, z.core.$strict>], "type">>]>>;
+        outputSchema: z.ZodOptional<z.ZodType<import("../../shared/json.ts").JsonObject, unknown, z.core.$ZodTypeInternals<import("../../shared/json.ts").JsonObject, unknown>>>;
+        task: z.ZodOptional<z.ZodObject<{
+            authorizationEvents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                hookPayload: z.ZodObject<{
+                    callId: z.ZodString;
+                    childSessionId: z.ZodString;
+                    event: z.ZodCustom<Record<string, unknown>, Record<string, unknown>>;
+                    kind: z.ZodLiteral<"subagent-authorization-event">;
+                    subagentName: z.ZodString;
+                }, z.core.$strict>;
+                taskId: z.ZodString;
+            }, z.core.$strict>>>;
+            inputRequests: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                hookPayload: z.ZodObject<{
+                    callId: z.ZodString;
+                    childContinuationToken: z.ZodString;
+                    childSessionId: z.ZodString;
+                    event: z.ZodObject<{
+                        requests: z.ZodArray<z.ZodObject<{
+                            action: z.ZodObject<{
+                                callId: z.ZodString;
+                                input: z.ZodType<import("../../shared/json.ts").JsonObject, unknown, z.core.$ZodTypeInternals<import("../../shared/json.ts").JsonObject, unknown>>;
+                                kind: z.ZodLiteral<"tool-call">;
+                                toolName: z.ZodString;
+                            }, z.core.$strict>;
+                            allowFreeform: z.ZodOptional<z.ZodBoolean>;
+                            display: z.ZodOptional<z.ZodEnum<{
+                                confirmation: "confirmation";
+                                select: "select";
+                                text: "text";
+                            }>>;
+                            kind: z.ZodEnum<{
+                                question: "question";
+                                "session-limit": "session-limit";
+                                "tool-approval": "tool-approval";
+                            }>;
+                            options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                                description: z.ZodOptional<z.ZodString>;
+                                id: z.ZodString;
+                                label: z.ZodString;
+                                style: z.ZodOptional<z.ZodEnum<{
+                                    danger: "danger";
+                                    default: "default";
+                                    primary: "primary";
+                                }>>;
+                            }, z.core.$strict>>>;
+                            prompt: z.ZodString;
+                            requestId: z.ZodString;
+                        }, z.core.$strict>>;
+                        sequence: z.ZodNumber;
+                        stepIndex: z.ZodNumber;
+                        turnId: z.ZodString;
+                    }, z.core.$strict>;
+                    kind: z.ZodLiteral<"subagent-input-request">;
+                    subagentName: z.ZodString;
+                }, z.core.$strict>;
+                taskId: z.ZodString;
+            }, z.core.$strict>>>;
+            views: z.ZodOptional<z.ZodArray<z.ZodType<import("../../tasks/types.ts").TaskView, unknown, z.core.$ZodTypeInternals<import("../../tasks/types.ts").TaskView, unknown>>>>;
+        }, z.core.$strict>>;
+    }, z.core.$loose>;
+    deliveryMetadata: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        channelKind: z.ZodString;
+        channelName: z.ZodString;
+        deliveryId: z.ZodString;
+        payloadIndex: z.ZodNumber;
+        requestId: z.ZodOptional<z.ZodString>;
+        requestTraceContext: z.ZodOptional<z.ZodObject<{
+            spanId: z.ZodString;
+            traceFlags: z.ZodNumber;
+            traceId: z.ZodString;
+        }, z.core.$strict>>;
+        acceptedDeploymentId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    version: z.ZodLiteral<3>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"session-timeout">;
+    version: z.ZodLiteral<3>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"clear">;
+    version: z.ZodLiteral<3>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"compact">;
+    version: z.ZodLiteral<3>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"reset">;
+    reason: z.ZodOptional<z.ZodString>;
+    version: z.ZodLiteral<3>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"cancel">;
+    taskId: z.ZodOptional<z.ZodString>;
+    turnId: z.ZodOptional<z.ZodString>;
+    version: z.ZodLiteral<3>;
+}, z.core.$strict>], "kind">;
+export type SessionInboxWireV3 = z.infer<typeof sessionInboxWireV3Schema>;
+export declare function parseSessionInboxWireV3(value: unknown): z.ZodSafeParseResult<{
+    auth?: {
+        attributes: Record<string, string | string[]>;
+        authenticator: string;
+        issuer?: string | undefined;
+        principalId: string;
+        principalType: string;
+        subject?: string | undefined;
+    } | null | undefined;
+    kind: "deliver";
+    payloads: {
+        [x: string]: unknown;
+        context?: string[] | undefined;
+        inputResponses?: {
+            optionId?: string | undefined;
+            requestId: string;
+            text?: string | undefined;
+        }[] | undefined;
+        message?: string | ({
+            providerOptions?: Record<string, import("../../shared/json.ts").JsonObject> | undefined;
+            text: string;
+            type: "text";
+        } | {
+            image: URL | import("ai").DataContent;
+            mediaType?: string | undefined;
+            providerOptions?: Record<string, import("../../shared/json.ts").JsonObject> | undefined;
+            type: "image";
+        } | {
+            data: URL | import("ai").DataContent;
+            filename?: string | undefined;
+            mediaType: string;
+            providerOptions?: Record<string, import("../../shared/json.ts").JsonObject> | undefined;
+            type: "file";
+        })[] | undefined;
+        outputSchema?: import("../../shared/json.ts").JsonObject | undefined;
+        task?: {
+            authorizationEvents?: {
+                hookPayload: {
+                    callId: string;
+                    childSessionId: string;
+                    event: Record<string, unknown>;
+                    kind: "subagent-authorization-event";
+                    subagentName: string;
+                };
+                taskId: string;
+            }[] | undefined;
+            inputRequests?: {
+                hookPayload: {
+                    callId: string;
+                    childContinuationToken: string;
+                    childSessionId: string;
+                    event: {
+                        requests: {
+                            action: {
+                                callId: string;
+                                input: import("../../shared/json.ts").JsonObject;
+                                kind: "tool-call";
+                                toolName: string;
+                            };
+                            allowFreeform?: boolean | undefined;
+                            display?: "confirmation" | "select" | "text" | undefined;
+                            kind: "question" | "session-limit" | "tool-approval";
+                            options?: {
+                                description?: string | undefined;
+                                id: string;
+                                label: string;
+                                style?: "danger" | "default" | "primary" | undefined;
+                            }[] | undefined;
+                            prompt: string;
+                            requestId: string;
+                        }[];
+                        sequence: number;
+                        stepIndex: number;
+                        turnId: string;
+                    };
+                    kind: "subagent-input-request";
+                    subagentName: string;
+                };
+                taskId: string;
+            }[] | undefined;
+            views?: import("../../tasks/types.ts").TaskView[] | undefined;
+        } | undefined;
+    }[];
+    requestId?: string | undefined;
+    taskDeliveryId?: string | undefined;
+    turnPolicy?: "queue" | "steer" | undefined;
+    caller?: {
+        callId: string;
+        replyTo: {
+            kind: "hook";
+            token: string;
+        } | {
+            kind: "callback";
+            token: string;
+            url: string;
+        };
+        subagentName: string;
+        taskId?: string | undefined;
+        activityObserver?: {
+            sink: {
+                url: string;
+                version: 1;
+            };
+            workIdentity?: {
+                callId?: string | undefined;
+                id: string;
+                kind: "remote-agent" | "root-turn" | "subagent" | "task";
+                name?: string | undefined;
+                parentId?: string | undefined;
+                rootSessionId: string;
+                rootTurnId: string;
+                sessionId?: string | undefined;
+                turnId?: string | undefined;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+    payload: {
+        [x: string]: unknown;
+        context?: string[] | undefined;
+        inputResponses?: {
+            optionId?: string | undefined;
+            requestId: string;
+            text?: string | undefined;
+        }[] | undefined;
+        message?: string | ({
+            providerOptions?: Record<string, import("../../shared/json.ts").JsonObject> | undefined;
+            text: string;
+            type: "text";
+        } | {
+            image: URL | import("ai").DataContent;
+            mediaType?: string | undefined;
+            providerOptions?: Record<string, import("../../shared/json.ts").JsonObject> | undefined;
+            type: "image";
+        } | {
+            data: URL | import("ai").DataContent;
+            filename?: string | undefined;
+            mediaType: string;
+            providerOptions?: Record<string, import("../../shared/json.ts").JsonObject> | undefined;
+            type: "file";
+        })[] | undefined;
+        outputSchema?: import("../../shared/json.ts").JsonObject | undefined;
+        task?: {
+            authorizationEvents?: {
+                hookPayload: {
+                    callId: string;
+                    childSessionId: string;
+                    event: Record<string, unknown>;
+                    kind: "subagent-authorization-event";
+                    subagentName: string;
+                };
+                taskId: string;
+            }[] | undefined;
+            inputRequests?: {
+                hookPayload: {
+                    callId: string;
+                    childContinuationToken: string;
+                    childSessionId: string;
+                    event: {
+                        requests: {
+                            action: {
+                                callId: string;
+                                input: import("../../shared/json.ts").JsonObject;
+                                kind: "tool-call";
+                                toolName: string;
+                            };
+                            allowFreeform?: boolean | undefined;
+                            display?: "confirmation" | "select" | "text" | undefined;
+                            kind: "question" | "session-limit" | "tool-approval";
+                            options?: {
+                                description?: string | undefined;
+                                id: string;
+                                label: string;
+                                style?: "danger" | "default" | "primary" | undefined;
+                            }[] | undefined;
+                            prompt: string;
+                            requestId: string;
+                        }[];
+                        sequence: number;
+                        stepIndex: number;
+                        turnId: string;
+                    };
+                    kind: "subagent-input-request";
+                    subagentName: string;
+                };
+                taskId: string;
+            }[] | undefined;
+            views?: import("../../tasks/types.ts").TaskView[] | undefined;
+        } | undefined;
+    };
+    deliveryMetadata?: {
+        channelKind: string;
+        channelName: string;
+        deliveryId: string;
+        payloadIndex: number;
+        requestId?: string | undefined;
+        requestTraceContext?: {
+            spanId: string;
+            traceFlags: number;
+            traceId: string;
+        } | undefined;
+        acceptedDeploymentId?: string | undefined;
+    }[] | undefined;
+    version: 3;
+} | {
+    kind: "session-timeout";
+    version: 3;
+} | {
+    kind: "clear";
+    version: 3;
+} | {
+    kind: "compact";
+    version: 3;
+} | {
+    kind: "reset";
+    reason?: string | undefined;
+    version: 3;
+} | {
+    kind: "cancel";
+    taskId?: string | undefined;
+    turnId?: string | undefined;
+    version: 3;
+}>;
+/** Builds and validates one complete version-3 wire value. */
+export declare function encodeSessionCommandV3(command: DeliverHookPayload | SessionCommand | SessionTimeoutHookPayload): SessionInboxWireV3;

package/dist/src/execution/wire/session-inbox-wire.v3.js

@@ -0,0 +1 @@
+import{z}from"#compiled/zod/index.js";import{formatValidationError}from"#runtime/validation.js";import{coalesceDeliverPayloads}from"#execution/deliver-payloads.js";import{SessionInboxWireError}from"#execution/wire/session-inbox-contract.js";import{sessionInboxWireV2Schema}from"#execution/wire/session-inbox-wire.v2.js";import{normalizeSessionInboxWireV2}from"#execution/wire/session-inbox-wire.v2-migration.js";const v2=sessionInboxWireV2Schema.options,v2Deliver=v2[0],v2DeliveryMetadata=v2Deliver.shape.deliveryMetadata.unwrap().element,version=z.literal(3),sessionInboxWireV3Schema=z.discriminatedUnion(`kind`,[v2Deliver.extend({deliveryMetadata:z.array(v2DeliveryMetadata.extend({acceptedDeploymentId:z.string().optional()})).optional(),version}),v2[1].extend({version}),v2[2].extend({version}),v2[3].extend({version}),v2[4].extend({version}),v2[5].extend({version})]);function parseSessionInboxWireV3(e){return sessionInboxWireV3Schema.safeParse(normalizeSessionInboxWireV2(e))}function encodeSessionCommandV3(e){let t=parseSessionInboxWireV3(e.kind===`send`?{auth:e.auth,caller:e.caller,deliveryMetadata:e.delivery===void 0?void 0:[{...e.delivery,payloadIndex:0}],kind:`deliver`,payload:e.payload,payloads:[e.payload],requestId:e.requestId,taskDeliveryId:e.taskDeliveryId,turnPolicy:e.turnPolicy,version:3}:e.kind===`deliver`?{...e,payload:coalesceDeliverPayloads(e.payloads),version:3}:{...e,version:3});if(!t.success)throw new SessionInboxWireError(`Produced a session inbox payload that does not match wire version 3: ${formatValidationError(t.error)}`);return t.data}export{encodeSessionCommandV3,parseSessionInboxWireV3,sessionInboxWireV3Schema};

package/dist/src/execution/wire/session-inbox-wire.v3.migration.d.ts

@@ -0,0 +1,3 @@
+import type { VersionMigration } from "#execution/durable-session-migrations/chain.js";
+/** Pure shape migration from the immutable v2 wire contract to v3. */
+export declare const sessionInboxWireV2Migration: VersionMigration;

package/dist/src/execution/wire/session-inbox-wire.v3.migration.js

@@ -0,0 +1 @@
+const sessionInboxWireV2Migration={from:2,migrate(e){return{...e,version:3}},to:3};export{sessionInboxWireV2Migration};

package/dist/src/execution/workflow-entry-finalization.d.ts

@@ -0,0 +1,22 @@
+import type { TurnCaller } from "#channel/types.js";
+import type { DurableSessionState } from "#execution/durable-session-store.js";
+import type { NextDriverAction } from "#execution/next-driver-action.js";
+import type { RunMode } from "#shared/run-mode.js";
+export declare function finalizeExpiredSession(input: {
+    readonly caller: TurnCaller | undefined;
+    readonly driverWritable: WritableStream<Uint8Array>;
+    readonly mode: RunMode;
+    readonly serializedContext: Record<string, unknown>;
+    readonly sessionState: DurableSessionState;
+}): Promise<{
+    readonly output: unknown;
+}>;
+export declare function finalizeDone(input: {
+    readonly action: NextDriverAction & {
+        readonly kind: "done";
+    };
+    readonly caller: TurnCaller | undefined;
+    readonly mode: RunMode;
+}): Promise<{
+    readonly output: unknown;
+}>;

package/dist/src/execution/workflow-entry-finalization.js

@@ -0,0 +1 @@
+import{notifyDelegatedParentStep,notifyTurnCallerStep}from"#execution/delegated-parent-notification.js";import{createDelegatedSubagentErrorResult,createDelegatedSubagentSuccessResult}from"#execution/delegated-parent-result.js";import{fireSessionCallbackStep}from"#execution/session-callback-step.js";import{emitTerminalSessionCompletionStep}from"#execution/terminal-session-completion-step.js";import{terminateChildSessionsStep}from"#execution/terminate-child-sessions-step.js";async function finalizeExpiredSession(t){return await terminateChildSessionsStep({serializedContext:t.serializedContext,sessionState:t.sessionState}),await emitTerminalSessionCompletionStep({parentWritable:t.driverWritable,serializedContext:t.serializedContext}),t.mode===`task`?(await fireSessionCallbackStep({output:``,serializedContext:t.serializedContext,status:`completed`}),await notifyDelegatedParentStep({result:createDelegatedSubagentSuccessResult(t.serializedContext,``),serializedContext:t.serializedContext})):t.caller!==void 0&&await notifyTurnCallerStep({caller:t.caller,lifecycle:`terminal`,sessionId:t.sessionState.sessionId,settled:{output:``}}),{output:``}}async function finalizeDone(n){let{output:r,serializedContext:i}=n.action,a=n.action.isError===!0;if(await terminateChildSessionsStep({serializedContext:i,sessionState:n.action.sessionState}),n.mode===`task`)await fireSessionCallbackStep({error:a?r:void 0,output:a?void 0:r,serializedContext:i,status:a?`failed`:`completed`,usage:n.action.usage}),await notifyDelegatedParentStep({result:a?createDelegatedSubagentErrorResult(i,r):createDelegatedSubagentSuccessResult(i,r),serializedContext:i,usage:n.action.usage});else{let e={output:r,usage:n.action.usageDelta};a&&(e.isError=!0),n.caller!==void 0&&await notifyTurnCallerStep({caller:n.caller,lifecycle:`terminal`,sessionId:n.action.sessionState.sessionId,settled:e})}return{output:r}}export{finalizeDone,finalizeExpiredSession};