eve 0.84.1 → 0.86.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (186) hide show
  1. package/README.md +7 -4
  2. package/dist/CHANGELOG.md +38 -0
  3. package/dist/src/channel/channel-operations.d.ts +2 -18
  4. package/dist/src/channel/compiled-channel.d.ts +3 -7
  5. package/dist/src/channel/cross-channel-receive.d.ts +9 -10
  6. package/dist/src/channel/cross-channel-receive.js +1 -1
  7. package/dist/src/channel/schedule.js +1 -1
  8. package/dist/src/channel/session.d.ts +26 -4
  9. package/dist/src/channel/session.js +1 -1
  10. package/dist/src/chunks/{use-eve-agent-DMeP0JOF.js → use-eve-agent-B2jCfcnG.js} +3 -2
  11. package/dist/src/chunks/{use-eve-agent-DP5Rso9C.js → use-eve-agent-DCLFi26P.js} +3 -2
  12. package/dist/src/cli/commands/agent-prompt/collect-intent.md +2 -1
  13. package/dist/src/cli/commands/agent-prompt/scaffold.md +1 -2
  14. package/dist/src/cli/dev/tui/runner.d.ts +1 -1
  15. package/dist/src/cli/dev/tui/runner.js +1 -1
  16. package/dist/src/cli/run.js +1 -1
  17. package/dist/src/client/client.js +1 -1
  18. package/dist/src/client/open-stream.js +1 -1
  19. package/dist/src/client/types.d.ts +5 -4
  20. package/dist/src/compiled/.vendor-stamp.json +4 -4
  21. package/dist/src/compiled/@vercel/schedules/index.d.ts +45 -6
  22. package/dist/src/compiled/@vercel/schedules/index.js +2 -2
  23. package/dist/src/context/keys.d.ts +7 -0
  24. package/dist/src/context/keys.js +1 -1
  25. package/dist/src/execution/agent-sessions/context.d.ts +5 -1
  26. package/dist/src/execution/agent-sessions/context.js +1 -1
  27. package/dist/src/execution/dynamic-workflow/tool.js +1 -1
  28. package/dist/src/execution/legacy-session/snapshot.d.ts +1 -2
  29. package/dist/src/execution/legacy-session/snapshot.js +1 -1
  30. package/dist/src/execution/proxied-deliver-step.js +1 -1
  31. package/dist/src/execution/public-destination.d.ts +3 -0
  32. package/dist/src/execution/public-destination.js +1 -1
  33. package/dist/src/execution/publish-session-events.js +1 -1
  34. package/dist/src/execution/session/active-turn.js +1 -1
  35. package/dist/src/execution/session/answer-caller.d.ts +9 -5
  36. package/dist/src/execution/session/answer-caller.js +1 -1
  37. package/dist/src/execution/session/checkpoint-migrations.d.ts +16 -5
  38. package/dist/src/execution/session/checkpoint-migrations.js +1 -1
  39. package/dist/src/execution/session/checkpoint-refusal.d.ts +4 -0
  40. package/dist/src/execution/session/checkpoint-refusal.js +1 -0
  41. package/dist/src/execution/session/entry.js +1 -1
  42. package/dist/src/execution/session/handoff-steps.d.ts +7 -1
  43. package/dist/src/execution/session/handoff-steps.js +1 -1
  44. package/dist/src/execution/session/imported-conversation.d.ts +2 -0
  45. package/dist/src/execution/session/imported-conversation.js +1 -0
  46. package/dist/src/execution/session/interrupted-step.js +1 -1
  47. package/dist/src/execution/session/pre-v27-checkpoint.d.ts +36 -0
  48. package/dist/src/execution/session/pre-v27-checkpoint.js +1 -0
  49. package/dist/src/execution/session/principal.d.ts +8 -0
  50. package/dist/src/execution/session/principal.js +1 -1
  51. package/dist/src/execution/session/program.d.ts +2 -0
  52. package/dist/src/execution/session/program.js +1 -1
  53. package/dist/src/execution/session/turn-step.js +1 -1
  54. package/dist/src/execution/session/turn.js +1 -1
  55. package/dist/src/execution/session-callback-request.js +1 -1
  56. package/dist/src/execution/tool-auth.js +1 -1
  57. package/dist/src/execution/tools/agent-router-workflow.js +1 -1
  58. package/dist/src/execution/tools/channel-to.d.ts +12 -0
  59. package/dist/src/execution/tools/channel-to.js +1 -0
  60. package/dist/src/execution/tools/workflow/body.d.ts +3 -0
  61. package/dist/src/execution/tools/workflow/body.js +1 -1
  62. package/dist/src/execution/tools/workflow/step-context.d.ts +5 -0
  63. package/dist/src/execution/tools/workflow/step-execution.js +1 -1
  64. package/dist/src/execution/tools/workflow/step.js +1 -1
  65. package/dist/src/execution/workflow-callback-url.d.ts +2 -3
  66. package/dist/src/execution/workflow-callback-url.js +1 -1
  67. package/dist/src/execution/workflow-runtime.js +1 -1
  68. package/dist/src/harness/attachment-staging.d.ts +2 -2
  69. package/dist/src/harness/attachment-staging.js +1 -1
  70. package/dist/src/harness/compaction/step.js +1 -1
  71. package/dist/src/harness/model-call/call.js +1 -1
  72. package/dist/src/harness/model-call/run.js +1 -1
  73. package/dist/src/harness/session-machine/transitions.js +1 -1
  74. package/dist/src/internal/application/stamped-package-version.js +1 -1
  75. package/dist/src/internal/attachments/limited-read.d.ts +2 -0
  76. package/dist/src/internal/attachments/limited-read.js +1 -1
  77. package/dist/src/internal/attachments/url-refs.js +1 -1
  78. package/dist/src/internal/capability-error.d.ts +3 -0
  79. package/dist/src/internal/capability-error.js +1 -0
  80. package/dist/src/internal/nitro/routes/schedule-collection-consumer.js +1 -1
  81. package/dist/src/public/channels/chat-sdk/chatSdkChannel.js +1 -1
  82. package/dist/src/public/channels/discord/discordChannel.js +1 -1
  83. package/dist/src/public/channels/github/githubChannel.js +1 -1
  84. package/dist/src/public/channels/linear/linearChannel.js +1 -1
  85. package/dist/src/public/channels/linq/inboundContent.js +1 -1
  86. package/dist/src/public/channels/slack/answers.d.ts +2 -3
  87. package/dist/src/public/channels/slack/answers.js +1 -1
  88. package/dist/src/public/channels/slack/api.d.ts +23 -3
  89. package/dist/src/public/channels/slack/api.js +1 -1
  90. package/dist/src/public/channels/slack/app-manifest.d.ts +2 -0
  91. package/dist/src/public/channels/slack/app-manifest.js +1 -1
  92. package/dist/src/public/channels/slack/auth.d.ts +2 -1
  93. package/dist/src/public/channels/slack/auth.js +1 -1
  94. package/dist/src/public/channels/slack/code-channel.d.ts +42 -0
  95. package/dist/src/public/channels/slack/code-channel.js +1 -0
  96. package/dist/src/public/channels/slack/defaults.d.ts +7 -3
  97. package/dist/src/public/channels/slack/defaults.js +3 -3
  98. package/dist/src/public/channels/slack/hitl.d.ts +7 -17
  99. package/dist/src/public/channels/slack/hitl.js +1 -1
  100. package/dist/src/public/channels/slack/index.d.ts +4 -3
  101. package/dist/src/public/channels/slack/index.js +1 -1
  102. package/dist/src/public/channels/slack/interaction-cards.d.ts +0 -2
  103. package/dist/src/public/channels/slack/interaction-cards.js +1 -1
  104. package/dist/src/public/channels/slack/interactions.js +1 -1
  105. package/dist/src/public/channels/slack/open-code-channel.d.ts +30 -0
  106. package/dist/src/public/channels/slack/open-code-channel.js +1 -0
  107. package/dist/src/public/channels/slack/private-approval-delivery.d.ts +16 -4
  108. package/dist/src/public/channels/slack/private-approval-delivery.js +1 -1
  109. package/dist/src/public/channels/slack/renderers.d.ts +58 -6
  110. package/dist/src/public/channels/slack/renderers.js +1 -1
  111. package/dist/src/public/channels/slack/reply-delivery.d.ts +4 -0
  112. package/dist/src/public/channels/slack/reply-delivery.js +1 -1
  113. package/dist/src/public/channels/slack/request-card-render.d.ts +45 -0
  114. package/dist/src/public/channels/slack/request-card-render.js +1 -0
  115. package/dist/src/public/channels/slack/request-cards.d.ts +35 -0
  116. package/dist/src/public/channels/slack/request-cards.js +3 -0
  117. package/dist/src/public/channels/slack/sign-in-cancel.d.ts +3 -5
  118. package/dist/src/public/channels/slack/sign-in-cancel.js +1 -1
  119. package/dist/src/public/channels/slack/slackChannel.d.ts +109 -22
  120. package/dist/src/public/channels/slack/slackChannel.js +1 -1
  121. package/dist/src/public/channels/slack/task-card.d.ts +3 -3
  122. package/dist/src/public/channels/slack/task-card.js +1 -1
  123. package/dist/src/public/channels/slack/thread-status.js +1 -1
  124. package/dist/src/public/channels/teams/api.js +1 -1
  125. package/dist/src/public/channels/teams/defaults.js +1 -1
  126. package/dist/src/public/channels/teams/teamsChannel.js +1 -1
  127. package/dist/src/public/channels/teams/verify.d.ts +9 -5
  128. package/dist/src/public/channels/teams/verify.js +1 -1
  129. package/dist/src/public/channels/telegram/telegramChannel.js +1 -1
  130. package/dist/src/public/channels/twilio/twilioChannel.js +1 -1
  131. package/dist/src/public/schedules/providers/vercel.d.ts +2 -0
  132. package/dist/src/public/schedules/providers/vercel.js +1 -1
  133. package/dist/src/public/schedules/subscription.d.ts +10 -1
  134. package/dist/src/runtime/subagents/workflow.js +1 -1
  135. package/dist/src/setup/index.d.ts +1 -1
  136. package/dist/src/setup/primitives/index.d.ts +1 -1
  137. package/dist/src/setup/primitives/pm/run.d.ts +0 -2
  138. package/dist/src/setup/scaffold/create/project.js +1 -1
  139. package/dist/src/shared/channel-definition.d.ts +4 -4
  140. package/dist/src/subagents/adapter.js +1 -1
  141. package/dist/src/subagents/parent-notification.js +1 -1
  142. package/dist/src/svelte/index.js +1 -1
  143. package/dist/src/svelte/use-eve-agent.js +1 -1
  144. package/dist/src/tools/definition.d.ts +21 -0
  145. package/dist/src/tools/provided/ask-question-workflow.js +1 -1
  146. package/dist/src/tools/provided/sleep-workflow.js +1 -1
  147. package/dist/src/tools/workflow-definition.d.ts +4 -4
  148. package/dist/src/vue/index.js +1 -1
  149. package/dist/src/vue/use-eve-agent.js +1 -1
  150. package/docs/channels/custom.mdx +16 -3
  151. package/docs/channels/eve.mdx +3 -5
  152. package/docs/channels/linq.mdx +1 -1
  153. package/docs/channels/slack.mdx +185 -18
  154. package/docs/channels/teams.mdx +6 -2
  155. package/docs/concepts/project-structure.mdx +1 -1
  156. package/docs/concepts/security-model.md +4 -0
  157. package/docs/concepts/upgrade-to-v27-events.md +70 -2
  158. package/docs/experimental/dynamic-schedules.mdx +2 -2
  159. package/docs/getting-started.mdx +2 -0
  160. package/docs/guides/auth-and-route-protection.md +1 -0
  161. package/docs/guides/client/overview.mdx +1 -1
  162. package/docs/guides/client/streaming.mdx +1 -1
  163. package/docs/guides/deployment/self-hosting.md +1 -1
  164. package/docs/guides/frontend/meta.json +1 -0
  165. package/docs/guides/frontend/nextjs.mdx +329 -121
  166. package/docs/guides/frontend/overview.mdx +115 -335
  167. package/docs/guides/frontend/tanstack.mdx +1 -1
  168. package/docs/guides/frontend/use-eve-agent-svelte.mdx +5 -5
  169. package/docs/guides/frontend/use-eve-agent-vue.mdx +5 -5
  170. package/docs/guides/frontend/use-eve-agent.mdx +385 -0
  171. package/docs/guides/hooks.md +1 -1
  172. package/docs/guides/remote-agents.md +10 -0
  173. package/docs/guides/self-modification.md +6 -0
  174. package/docs/patterns/fork-conversations-into-new-threads.md +159 -0
  175. package/docs/patterns/meta.json +1 -0
  176. package/docs/reference/cli.md +1 -2
  177. package/docs/sandbox/index.mdx +1 -1
  178. package/docs/schedules.mdx +1 -1
  179. package/docs/tools/overview.mdx +34 -0
  180. package/docs/tools/workflows.mdx +47 -5
  181. package/package.json +13 -21
  182. package/CHANGELOG.md +0 -3076
  183. package/dist/src/public/channels/slack/approval-cards.d.ts +0 -25
  184. package/dist/src/public/channels/slack/approval-cards.js +0 -2
  185. package/dist/src/self-modification/agent.d.ts +0 -12
  186. package/dist/src/self-modification/agent.js +0 -1
@@ -10,6 +10,8 @@ import { ContextKey } from "#context/key.js";
10
10
  import { type StubScope } from "#tool-stubs/types.js";
11
11
  import { type SessionInboxAddress } from "#execution/session-inbox/address.js";
12
12
  import type { HandleEventFn } from "#harness/types.js";
13
+ import type { CrossChannelToFn } from "#channel/cross-channel-receive.js";
14
+ import type { InstrumentationChannel } from "#shared/instrumentation-channel.js";
13
15
  import type { DynamicSubagentAgentConfig } from "#runtime/subagents/dynamic-agent-config.js";
14
16
  import type { DynamicRemoteAgentConfig } from "#runtime/subagents/dynamic-remote-agent-config.js";
15
17
  import type { DynamicRemoteBinding } from "#reactions/remote.js";
@@ -125,6 +127,11 @@ export declare const SessionKey: ContextKey<Session>;
125
127
  export declare const SandboxKey: ContextKey<SandboxAccess>;
126
128
  export declare const SandboxTerminalCleanupKey: ContextKey<(reason: SandboxSessionEndReason) => Promise<void>>;
127
129
  export declare const HandleEventKey: ContextKey<HandleEventFn>;
130
+ /** A tool's `ctx.channel` and `ctx.to()`, which the turn running the tool provides. */
131
+ export declare const ToolChannelKey: ContextKey<{
132
+ readonly channel: InstrumentationChannel;
133
+ readonly to: CrossChannelToFn;
134
+ }>;
128
135
  /** Static model configured for the effective turn agent, or `null` for a dynamic-only agent. */
129
136
  export declare const StaticModelReferenceKey: ContextKey<Readonly<import("../shared/agent-definition.ts").InternalAgentModelDefinition & {
130
137
  reasoning?: import("../index.ts").AgentReasoningDefinition;
@@ -1 +1 @@
1
- import{SESSION_INBOX_CONTEXT_KEY}from"#execution/session-inbox/address.js";import{ContextKey}from"#context/key.js";import{STUB_CONTEXT_KEY}from"#tool-stubs/types.js";import{EARLIER_REMOTE_CALLER_CONTEXT_KEY_NAME,SESSION_CALLBACK_CONTEXT_KEY_NAME}from"#context/key-names.js";const AuthKey=new ContextKey(`eve.auth`),ToolStubsKey=new ContextKey(STUB_CONTEXT_KEY),InitiatorAuthKey=new ContextKey(`eve.initiatorAuth`),SessionIdKey=new ContextKey(`eve.sessionId`),ConversationIdKey=new ContextKey(`eve.conversationId`),SessionInboxKey=new ContextKey(SESSION_INBOX_CONTEXT_KEY),ContinuationTokenKey=new ContextKey(`eve.continuationToken`),ContinuationHookTokensKey=new ContextKey(`eve.continuationHookTokens`),ChannelRequestIdKey=new ContextKey(`eve.channelRequestId`),LocalDevRequestKey=new ContextKey(`eve.internal.localDevRequest`),OccurrenceIdKey=new ContextKey(`eve.scheduleOccurrenceId`),ScheduleIdKey=new ContextKey(`eve.scheduleId`),ScheduleInstanceKey=new ContextKey(`eve.scheduleInstance`),SessionTitleKey=new ContextKey(`eve.sessionTitle`),ChannelDeliveryKey=new ContextKey(`eve.channelDelivery`),TurnDeliveryIdsKey=new ContextKey(`eve.turnDeliveryIds`),HistoryStateKey=new ContextKey(`eve.historyState`),OfferedCatalogToolsKey=new ContextKey(`eve.offeredCatalogTools`),ChannelInstrumentationKey=new ContextKey(`eve.channelInstrumentation`),ParentSessionKey=new ContextKey(`eve.parentSession`),SessionPredecessorKey=new ContextKey(`eve.sessionPredecessor`),TraceRootKey=new ContextKey(`eve.traceRoot`),ParentTraceContextKey=new ContextKey(`eve.parentTraceContext`),SessionTraceSeedKey=new ContextKey(`eve.sessionTraceSeed`),OtelTraceEnabledKey=new ContextKey(`eve.otelTraceEnabled`),CapabilitiesKey=new ContextKey(`eve.capabilities`),SessionCallbackKey=new ContextKey(SESSION_CALLBACK_CONTEXT_KEY_NAME),EarlierRemoteCallerKey=new ContextKey(EARLIER_REMOTE_CALLER_CONTEXT_KEY_NAME),SessionKey=new ContextKey(`eve.session`),SandboxKey=new ContextKey(`eve.sandbox`),SandboxTerminalCleanupKey=new ContextKey(`eve.internal.sandboxTerminalCleanup`),HandleEventKey=new ContextKey(`eve.internal.handleEvent`),StaticModelReferenceKey=new ContextKey(`eve.staticModelReference`),DynamicSubagentAgentConfigKey=new ContextKey(`eve.dynamicSubagentAgentConfig`),AgentSessionRuntimeOverridesKey=new ContextKey(`eve.agentSessionRuntimeOverrides`),DynamicSkillSandboxKey=new ContextKey(`eve.dynamicSkillSandbox`);export{AgentSessionRuntimeOverridesKey,AuthKey,CapabilitiesKey,ChannelDeliveryKey,ChannelInstrumentationKey,ChannelRequestIdKey,ContinuationHookTokensKey,ContinuationTokenKey,ConversationIdKey,DynamicSkillSandboxKey,DynamicSubagentAgentConfigKey,EarlierRemoteCallerKey,HandleEventKey,HistoryStateKey,InitiatorAuthKey,LocalDevRequestKey,OccurrenceIdKey,OfferedCatalogToolsKey,OtelTraceEnabledKey,ParentSessionKey,ParentTraceContextKey,SandboxKey,SandboxTerminalCleanupKey,ScheduleIdKey,ScheduleInstanceKey,SessionCallbackKey,SessionIdKey,SessionInboxKey,SessionKey,SessionPredecessorKey,SessionTitleKey,SessionTraceSeedKey,StaticModelReferenceKey,ToolStubsKey,TraceRootKey,TurnDeliveryIdsKey};
1
+ import{SESSION_INBOX_CONTEXT_KEY}from"#execution/session-inbox/address.js";import{ContextKey}from"#context/key.js";import{STUB_CONTEXT_KEY}from"#tool-stubs/types.js";import{EARLIER_REMOTE_CALLER_CONTEXT_KEY_NAME,SESSION_CALLBACK_CONTEXT_KEY_NAME}from"#context/key-names.js";const AuthKey=new ContextKey(`eve.auth`),ToolStubsKey=new ContextKey(STUB_CONTEXT_KEY),InitiatorAuthKey=new ContextKey(`eve.initiatorAuth`),SessionIdKey=new ContextKey(`eve.sessionId`),ConversationIdKey=new ContextKey(`eve.conversationId`),SessionInboxKey=new ContextKey(SESSION_INBOX_CONTEXT_KEY),ContinuationTokenKey=new ContextKey(`eve.continuationToken`),ContinuationHookTokensKey=new ContextKey(`eve.continuationHookTokens`),ChannelRequestIdKey=new ContextKey(`eve.channelRequestId`),LocalDevRequestKey=new ContextKey(`eve.internal.localDevRequest`),OccurrenceIdKey=new ContextKey(`eve.scheduleOccurrenceId`),ScheduleIdKey=new ContextKey(`eve.scheduleId`),ScheduleInstanceKey=new ContextKey(`eve.scheduleInstance`),SessionTitleKey=new ContextKey(`eve.sessionTitle`),ChannelDeliveryKey=new ContextKey(`eve.channelDelivery`),TurnDeliveryIdsKey=new ContextKey(`eve.turnDeliveryIds`),HistoryStateKey=new ContextKey(`eve.historyState`),OfferedCatalogToolsKey=new ContextKey(`eve.offeredCatalogTools`),ChannelInstrumentationKey=new ContextKey(`eve.channelInstrumentation`),ParentSessionKey=new ContextKey(`eve.parentSession`),SessionPredecessorKey=new ContextKey(`eve.sessionPredecessor`),TraceRootKey=new ContextKey(`eve.traceRoot`),ParentTraceContextKey=new ContextKey(`eve.parentTraceContext`),SessionTraceSeedKey=new ContextKey(`eve.sessionTraceSeed`),OtelTraceEnabledKey=new ContextKey(`eve.otelTraceEnabled`),CapabilitiesKey=new ContextKey(`eve.capabilities`),SessionCallbackKey=new ContextKey(SESSION_CALLBACK_CONTEXT_KEY_NAME),EarlierRemoteCallerKey=new ContextKey(EARLIER_REMOTE_CALLER_CONTEXT_KEY_NAME),SessionKey=new ContextKey(`eve.session`),SandboxKey=new ContextKey(`eve.sandbox`),SandboxTerminalCleanupKey=new ContextKey(`eve.internal.sandboxTerminalCleanup`),HandleEventKey=new ContextKey(`eve.internal.handleEvent`),ToolChannelKey=new ContextKey(`eve.internal.toolChannel`),StaticModelReferenceKey=new ContextKey(`eve.staticModelReference`),DynamicSubagentAgentConfigKey=new ContextKey(`eve.dynamicSubagentAgentConfig`),AgentSessionRuntimeOverridesKey=new ContextKey(`eve.agentSessionRuntimeOverrides`),DynamicSkillSandboxKey=new ContextKey(`eve.dynamicSkillSandbox`);export{AgentSessionRuntimeOverridesKey,AuthKey,CapabilitiesKey,ChannelDeliveryKey,ChannelInstrumentationKey,ChannelRequestIdKey,ContinuationHookTokensKey,ContinuationTokenKey,ConversationIdKey,DynamicSkillSandboxKey,DynamicSubagentAgentConfigKey,EarlierRemoteCallerKey,HandleEventKey,HistoryStateKey,InitiatorAuthKey,LocalDevRequestKey,OccurrenceIdKey,OfferedCatalogToolsKey,OtelTraceEnabledKey,ParentSessionKey,ParentTraceContextKey,SandboxKey,SandboxTerminalCleanupKey,ScheduleIdKey,ScheduleInstanceKey,SessionCallbackKey,SessionIdKey,SessionInboxKey,SessionKey,SessionPredecessorKey,SessionTitleKey,SessionTraceSeedKey,StaticModelReferenceKey,ToolChannelKey,ToolStubsKey,TraceRootKey,TurnDeliveryIdsKey};
@@ -1,5 +1,5 @@
1
1
  import type { ChannelInstrumentationProjection, SessionCapabilities, SessionParent, SessionTraceRoot } from "#channel/types.js";
2
- import type { LocalDevRequestProvenance } from "#context/keys.js";
2
+ import { type LocalDevRequestProvenance } from "#context/keys.js";
3
3
  import { type StubScope } from "#tool-stubs/types.js";
4
4
  import { type SessionSchedule } from "#context/session-schedule.js";
5
5
  import type { DynamicSubagentSelections } from "#execution/agent-sessions/target.js";
@@ -28,9 +28,13 @@ export interface AgentSessionContext {
28
28
  readonly capabilities?: SessionCapabilities;
29
29
  readonly schedule?: SessionSchedule;
30
30
  readonly channelMetadata?: ChannelInstrumentationProjection;
31
+ /** The calling session's address on its channel, which `ctx.channel.continuationToken` reads. */
32
+ readonly continuationToken?: string;
31
33
  readonly conversation?: ConversationContext;
32
34
  /** Dynamic agents the calling turn selected, by node id. */
33
35
  readonly dynamicSelections: DynamicSubagentSelections;
36
+ /** Whether a parent, local or remote, delegated the calling session. */
37
+ readonly delegated?: boolean;
34
38
  readonly localDevRequest?: LocalDevRequestProvenance;
35
39
  /** The calling session, turn, and tool call, recorded as each session's lineage. */
36
40
  readonly parent: SessionParent;
@@ -1 +1 @@
1
- import{readSerializedSessionSchedule}from"#context/session-schedule.js";import{STUB_CONTEXT_KEY}from"#tool-stubs/types.js";import{serializeDurableCompiledArtifactsSource}from"#runtime/durable-compiled-artifacts-source.js";import{resolveToolCallAgentTrace}from"#tracing/eve/agent-invocation-coordinator.js";function captureAgentSessionContext(e,t){let{batch:n,session:r}=e;return{agents:e.workflowAgents,toolStubs:e.serializedContext[STUB_CONTEXT_KEY],bundle:{nodeId:e.bundle.nodeId,source:serializeDurableCompiledArtifactsSource(e.bundle.compiledArtifactsSource)},capabilities:e.capabilities,schedule:readSerializedSessionSchedule(e.serializedContext),channelMetadata:e.channelMetadata,conversation:e.inheritedConversation,dynamicSelections:e.dynamicSubagentSelections,localDevRequest:e.localDevRequest,parent:{callId:t,rootSessionId:r.rootSessionId??r.sessionId,sessionId:r.sessionId,turn:{id:n.event.turnId,sequence:n.event.sequence}},sandbox:{sessionId:e.sandboxSessionId,state:e.sandboxState},traceRoot:e.traceRoot,trace:resolveToolCallAgentTrace({callId:t,conversation:e.inheritedConversation,serializedContext:e.serializedContext,sessionId:r.sessionId,turnId:n.event.turnId})}}export{captureAgentSessionContext};
1
+ import{ContinuationTokenKey}from"#context/keys.js";import{readSerializedSessionSchedule}from"#context/session-schedule.js";import{STUB_CONTEXT_KEY}from"#tool-stubs/types.js";import{hasDelegatedSessionContext}from"#execution/delegated-session-context.js";import{serializeDurableCompiledArtifactsSource}from"#runtime/durable-compiled-artifacts-source.js";import{resolveToolCallAgentTrace}from"#tracing/eve/agent-invocation-coordinator.js";function captureAgentSessionContext(e,t){let{batch:n,session:r}=e;return{agents:e.workflowAgents,toolStubs:e.serializedContext[STUB_CONTEXT_KEY],bundle:{nodeId:e.bundle.nodeId,source:serializeDurableCompiledArtifactsSource(e.bundle.compiledArtifactsSource)},capabilities:e.capabilities,schedule:readSerializedSessionSchedule(e.serializedContext),channelMetadata:e.channelMetadata,continuationToken:e.serializedContext[ContinuationTokenKey.name],conversation:e.inheritedConversation,dynamicSelections:e.dynamicSubagentSelections,delegated:hasDelegatedSessionContext(e.serializedContext),localDevRequest:e.localDevRequest,parent:{callId:t,rootSessionId:r.rootSessionId??r.sessionId,sessionId:r.sessionId,turn:{id:n.event.turnId,sequence:n.event.sequence}},sandbox:{sessionId:e.sandboxSessionId,state:e.sandboxState},traceRoot:e.traceRoot,trace:resolveToolCallAgentTrace({callId:t,conversation:e.inheritedConversation,serializedContext:e.serializedContext,sessionId:r.sessionId,turnId:n.event.turnId})}}export{captureAgentSessionContext};
@@ -1 +1 @@
1
- import{runJsProgram}from"#execution/dynamic-workflow/workflow.js";async function runWorkflowProgramTask(e,t){"use workflow";return runJsProgram(e.js,t,{maxSubagents:e.maxSubagents??0})}runWorkflowProgramTask.workflowId=`workflow//eve@0.84.1//runWorkflowProgramTask`;export{runWorkflowProgramTask};
1
+ import{runJsProgram}from"#execution/dynamic-workflow/workflow.js";async function runWorkflowProgramTask(e,t){"use workflow";return runJsProgram(e.js,t,{maxSubagents:e.maxSubagents??0})}runWorkflowProgramTask.workflowId=`workflow//eve@0.86.0//runWorkflowProgramTask`;export{runWorkflowProgramTask};
@@ -1,6 +1,6 @@
1
1
  import type { ModelMessage } from "ai";
2
2
  import { type SessionProjection } from "#protocol/session-projection.js";
3
- import { type DurableSession, type DurableSessionState } from "#execution/durable-session-store.js";
3
+ import type { DurableSession, DurableSessionState } from "#execution/durable-session-store.js";
4
4
  import type { HarnessModelMessage } from "#harness/messages.js";
5
5
  export type LegacySession = DurableSession & {
6
6
  readonly history: ModelMessage[];
@@ -19,4 +19,3 @@ export declare function importConversation(session: LegacySession): {
19
19
  * counted the session spent as the view's usage, so the session's limits keep counting.
20
20
  */
21
21
  export declare function importProjection(session: LegacySession): SessionProjection;
22
- export declare function normalizeHistory(messages: readonly ModelMessage[]): HarnessModelMessage[];
@@ -1 +1 @@
1
- import{isObject}from"#shared/guards.js";import{SESSION_PROJECTION_STATE_KEY}from"#harness/session-machine/view.js";import{DURABLE_SESSION_VERSION}from"#execution/durable-session-store.js";import{isUserMessageKind,validateHarnessModelMessages}from"#harness/messages.js";import{usageOf}from"#harness/facts.js";import{withModelUsage}from"#harness/session-usage.js";import{initialSessionProjection}from"#protocol/session-projection.js";const PRESERVED_FRAMEWORK_STATE=new Set([`eve.harness.sessionRuntimeTokenLimit`]),LEGACY_USAGE_KEY=`eve.harness.turnUsage`,REPORTED_USAGE_KEY=`eve.harness.reportedSessionUsage`;function readLegacySnapshot(e){let t=e.snapshot;if(!isObject(t)||t.version!==1||!isObject(t.session)||t.session.sessionId!==e.sessionId||!Array.isArray(t.session.history))throw Error(`Unsupported legacy session snapshot.`);return t.session}function importConversation(e){let{history:t,...n}=e,r=Object.fromEntries(Object.entries(e.state??{}).filter(([e])=>!e.startsWith(`eve.`)||PRESERVED_FRAMEWORK_STATE.has(e))),i=legacyUsage(e.state?.[REPORTED_USAGE_KEY]);return i!==void 0&&(r[REPORTED_USAGE_KEY]=i),{history:normalizeHistory(t),sessionState:{version:DURABLE_SESSION_VERSION,sessionId:e.sessionId,continuationToken:e.continuationToken,hasProxyInputRequests:!1,snapshot:{session:{...n,state:{...r,[SESSION_PROJECTION_STATE_KEY]:importProjection(e)}}}}}}function importProjection(e){let t=e.state?.[`eve.harness.emission`],n=initialSessionProjection(),r=legacyUsage(isObject(e.state?.[LEGACY_USAGE_KEY])?e.state[LEGACY_USAGE_KEY].session:void 0),i=r===void 0?n:{...n,view:withModelUsage(n.view,r)};if(!isObject(t)||typeof t.sequence!=`number`)return i;let{view:a}=i,o=t.sessionStarted===!0?`open`:`new`,s=typeof t.turnId==`string`?t.turnId:``;if(s===``)return{...i,view:{...a,session:{status:o,turnCount:t.sequence}}};let c=typeof t.stepIndex==`number`?t.stepIndex:0,l={cause:{hook:`legacy`},follows:null,introducedAt:0,startedAt:new Date(0).toISOString(),status:`running`,turnId:s,...c>0&&{runs:c}};return{...i,view:{...a,session:{latestTurnId:s,status:o,turnCount:t.sequence+1},turns:{[s]:l}}}}function legacyUsage(e){if(!isObject(e))return;let count=t=>typeof e[t]==`number`?e[t]:0;return usageOf({cacheReadTokens:count(`cacheReadTokens`),cacheWriteTokens:count(`cacheWriteTokens`),costUsd:e.sawCost===!0&&typeof e.costUsd==`number`?e.costUsd:void 0,inputTokens:count(`inputTokens`),outputTokens:count(`outputTokens`)})}function normalizeHistory(e){let t=[],n=new Map,settle=()=>{n.size!==0&&(t.push({role:`tool`,content:[...n].map(([e,t])=>({type:`tool-result`,toolCallId:e,toolName:t,output:{type:`error-text`,value:`Interrupted by the session upgrade. Start this work again if it is still needed.`}}))}),n.clear())};for(let r of e){let e=r;if(e.role===`assistant`&&Array.isArray(e.content))e={...e,content:e.content.filter(e=>e.type!==`tool-approval-request`)};else if(e.role===`tool`&&(e={...e,content:e.content.filter(e=>e.type!==`tool-approval-response`)},e.content.length===0))continue;if(e.role!==`tool`&&settle(),e.role===`assistant`&&Array.isArray(e.content))for(let t of e.content)t.type===`tool-call`&&n.set(t.toolCallId,t.toolName);if(e.role===`tool`)for(let t of e.content)t.type===`tool-result`&&n.delete(t.toolCallId);let i=e.kind;t.push(e.role===`user`&&!isUserMessageKind(i)?{...e,kind:`user`}:e)}return settle(),validateHarnessModelMessages(t)}export{importConversation,importProjection,normalizeHistory,readLegacySnapshot};
1
+ import{isObject}from"#shared/guards.js";import{SESSION_PROJECTION_STATE_KEY}from"#harness/session-machine/view.js";import{DURABLE_SESSION_VERSION}from"#execution/durable-session-read.js";import{withModelUsage}from"#harness/session-usage.js";import{initialSessionProjection}from"#protocol/session-projection.js";import{normalizeHistory}from"#execution/session/imported-conversation.js";import{usageOf}from"#harness/facts.js";const PRESERVED_FRAMEWORK_STATE=new Set([`eve.harness.sessionRuntimeTokenLimit`]),LEGACY_USAGE_KEY=`eve.harness.turnUsage`,REPORTED_USAGE_KEY=`eve.harness.reportedSessionUsage`;function readLegacySnapshot(e){let t=e.snapshot;if(!isObject(t)||t.version!==1||!isObject(t.session)||t.session.sessionId!==e.sessionId||!Array.isArray(t.session.history))throw Error(`Unsupported legacy session snapshot.`);return t.session}function importConversation(e){let{history:t,...n}=e,r=Object.fromEntries(Object.entries(e.state??{}).filter(([e])=>!e.startsWith(`eve.`)||PRESERVED_FRAMEWORK_STATE.has(e))),i=legacyUsage(e.state?.[REPORTED_USAGE_KEY]);return i!==void 0&&(r[REPORTED_USAGE_KEY]=i),{history:normalizeHistory(t),sessionState:{version:DURABLE_SESSION_VERSION,sessionId:e.sessionId,continuationToken:e.continuationToken,hasProxyInputRequests:!1,snapshot:{session:{...n,state:{...r,[SESSION_PROJECTION_STATE_KEY]:importProjection(e)}}}}}}function importProjection(e){let t=e.state?.[`eve.harness.emission`],n=initialSessionProjection(),r=legacyUsage(isObject(e.state?.[LEGACY_USAGE_KEY])?e.state[LEGACY_USAGE_KEY].session:void 0),i=r===void 0?n:{...n,view:withModelUsage(n.view,r)};if(!isObject(t)||typeof t.sequence!=`number`)return i;let{view:a}=i,o=t.sessionStarted===!0?`open`:`new`,s=typeof t.turnId==`string`?t.turnId:``;if(s===``)return{...i,view:{...a,session:{status:o,turnCount:t.sequence}}};let c=typeof t.stepIndex==`number`?t.stepIndex:0,l={cause:{hook:`legacy`},follows:null,introducedAt:0,startedAt:new Date(0).toISOString(),status:`running`,turnId:s,...c>0&&{runs:c}};return{...i,view:{...a,session:{latestTurnId:s,status:o,turnCount:t.sequence+1},turns:{[s]:l}}}}function legacyUsage(e){if(!isObject(e))return;let count=t=>typeof e[t]==`number`?e[t]:0;return usageOf({cacheReadTokens:count(`cacheReadTokens`),cacheWriteTokens:count(`cacheWriteTokens`),costUsd:e.sawCost===!0&&typeof e.costUsd==`number`?e.costUsd:void 0,inputTokens:count(`inputTokens`),outputTokens:count(`outputTokens`)})}export{importConversation,importProjection,readLegacySnapshot};
@@ -1 +1 @@
1
- import{activeTurn,interactionOwner,waiting}from"#protocol/session-projection/selectors.js";import{AuthKey,TurnDeliveryIdsKey}from"#context/keys.js";import{BundleKey,ChannelKey}from"#runtime/sessions/runtime-context-keys.js";import{storedProjection}from"#harness/session-machine/view.js";import{V26_INPUT_REMOTE_AGENT_PROTOCOL}from"#protocol/remote-agent-protocol.js";import{resolveRemoteAgentStreamHeaders,respondToRemoteAgentSession}from"#execution/agent-sessions/remote.js";import{deserializeContext,serializeContext}from"#context/serialize.js";import{readDurableSession}from"#execution/durable-session-store.js";import{readHitlState}from"#harness/hitl/index.js";import{selectDeliveryPayloads}from"#harness/messages.js";import{resumeSessionInbox}from"#execution/session-inbox/resume.js";import{buildAdapterContext}from"#channel/adapter-context.js";import{commitSessionStep,publishSessionEvents}from"#execution/publish-session-events.js";import"#execution/session/state-delta.js";import{withSessionStateDelta}from"#execution/session/step-state-delta.js";import{routeAnswer}from"#harness/session-machine/transitions.js";import{coalesceDeliverPayloads}from"#execution/deliver-payloads.js";import{fact}from"#harness/facts.js";import{userPartsOf}from"#harness/user-parts.js";import{principalOf}from"#execution/session/delivery-facts.js";import{hasDelegatedSessionContext}from"#execution/delegated-session-context.js";import{setChannelContext}from"#execution/channel-context.js";import{routeDeliverPayload}from"#subagents/hitl-proxy.js";import{protocolTwoAnswersSettledOnForward}from"#subagents/protocol-two-callback.js";import{sendWorkflowAskAnswers}from"#execution/tools/workflow/answer.js";async function routeProxiedDeliverStep(e){"use step";return await withSessionStateDelta(e,routeProxiedDeliver)}async function routeProxiedDeliver(e){let t=readHitlState(readDurableSession(e.sessionState).state).relays,{delivery:n,serializedContext:r}=await deliverChannelAnswers({...e,routable:e=>t.has(e.interactionId)}),i=readDurableSession(e.sessionState),a=new Map,o=new Map,s,c=!hasDelegatedSessionContext(r)&&n.caller===void 0,l=new Set,u=[],d=storedProjection(i.state).view,f=activeTurn(d),p=f===void 0?void 0:waiting(d,f.turnId),askedTurn=e=>{let t=interactionOwner(d,e).turnId;return t!==void 0&&d.turns[t]?.status===`running`?t:p?.on===`interaction`&&p.interactions.some(t=>t.interactionId===e.interactionId)?f?.turnId:void 0},m=[],h=[];for(let[e,t]of n.payloads.entries()){let r=routeDeliverPayload({allowRoute:e=>!l.has(e),payload:t,resolveMessage:c,state:i.state});s??=r.parentAction,r.forSelf!==void 0&&a.set(e,r.forSelf);let f=(n.deliveryMetadata??[]).filter(t=>t.payloadIndex===e),p=f[0]?.deliveryId;if(r.forChildren.length>0&&p!==void 0){let e=r.forChildren.find(e=>e.message!==void 0),i=r.forChildren.flatMap(e=>e.payload.answers).map(e=>d.interactions[e.interactionId]).find(e=>e!==void 0&&askedTurn(e)!==void 0),a=i===void 0?void 0:askedTurn(i);r.forSelf===void 0&&a!==void 0&&u.push(...f.map(e=>e.deliveryId));for(let t of f)m.push({consumed:r.forSelf===void 0&&a!==void 0?{parts:e?.message===void 0?[]:userPartsOf(e.message),turnId:a}:void 0,continues:r.forSelf!==void 0||void 0,deliveryId:t.deliveryId,principal:principalOf(n.auth),source:t.channelKind===void 0?void 0:{channel:t.channelKind}});for(let e of r.forChildren)for(let n of e.payload.answers){let e=(t.answers??[]).indexOf(n),r={};n.optionId!==void 0&&(r.optionId=n.optionId),n.text!==void 0&&(r.text=n.text),h.push({deliveryId:p,interactionId:n.interactionId,responseId:`response_${p}_forwarded_${e===-1?`typed_0`:String(e)}`,value:r})}}for(let[t,i]of r.forChildren.entries()){if(i.workflowAsk!==void 0||i.message!==void 0)for(let{interactionId:e}of i.payload.answers)l.add(e);let a=JSON.stringify([i.childContinuationToken,i.childSessionInbox?.sessionId??``,i.remote?.sessionId??``,i.inputSource??null,i.workflowAsk?.control??null]),s=o.get(a)??{workflowAsk:i.workflowAsk,remote:i.remote,childContinuationToken:i.childContinuationToken,childSessionInbox:i.childSessionInbox,metadata:[],payloads:[]},c=s.payloads.length;if(s.payloads.push(i.payload),r.forSelf===void 0&&t===0)for(let t of n.deliveryMetadata??[])t.payloadIndex===e&&s.metadata.push({...t,payloadIndex:c});o.set(a,s)}}let g={serializedContext:joinTurnDeliveryIds(r,u),sessionState:e.sessionState},_=!1,v=m.filter(e=>e.consumed!==void 0),y=v.length===0?g:await commitSessionStep({...g,sessionWritable:e.sessionWritable},e=>[routeAnswer(e,{deliveries:v,forwarded:[],decided:[]})],{origin:`own`,cancelTurn:()=>{_=!0}});if(_){let t=storedProjection(readDurableSession(y.sessionState).state).view,r=(n.deliveryMetadata??[]).filter(({deliveryId:e,payloadIndex:n})=>a.has(n)&&t.deliveries[e]?.status!==`settled`);if(r.length===0)return{...y,kind:`cancel-turn`};let i=await publishSessionEvents({...y,sessionWritable:e.sessionWritable},r.flatMap(({channelKind:e,deliveryId:r})=>[...t.deliveries[r]===void 0?[fact(`delivery.admitted`,{deliveryId:r,principal:principalOf(n.auth),source:e===void 0?void 0:{channel:e}})]:[],fact(`delivery.settled`,{deliveryId:r,outcome:`ignored`})]));return{kind:`cancel-turn`,serializedContext:i.serializedContext,sessionState:i.sessionState}}let b=[];for(let[e,t]of o)if(t.workflowAsk!==void 0){let e=coalesceDeliverPayloads(t.payloads).answers??[];b.push(...e.map(e=>({answer:e,outcome:`accepted`}))),await sendWorkflowAskAnswers(t.workflowAsk,e,principalOf(n.auth))}else{let i={...n,deliveryMetadata:t.metadata.length===0?void 0:t.metadata,payloads:t.payloads},a=t.remote;if(a!==void 0){let i=await deserializeContext(r),o=await resolveRemoteAgentStreamHeaders({bundle:i.require(BundleKey),name:a.name,dynamicBinding:a.dynamicBinding,resolverId:a.resolverId,url:a.url}),c=coalesceDeliverPayloads(t.payloads).answers??[];if(await respondToRemoteAgentSession({remote:a,headers:o,auth:n.auth,idempotencyKey:await answersIdempotencyKey(n,e),responses:c}),a.earlierProtocol===V26_INPUT_REMOTE_AGENT_PROTOCOL)for(let e of protocolTwoAnswersSettledOnForward({answers:c,decidedHere:s?.answer.interactionId,kindOf:e=>d.interactions[e]?.request.kind}))b.push({answer:e,outcome:`accepted`})}else await resumeSessionInbox(t.childSessionInbox??t.childContinuationToken,i)}let x=await commitSessionStep({...y,sessionWritable:e.sessionWritable},e=>[routeAnswer(e,{decided:s===void 0?b:[...b,{answer:s.answer,outcome:`declined`}],deliveries:m,forwarded:h})],{origin:`relayed`});if(s!==void 0)return{...x,kind:s.kind};let S=[...a].sort(([e],[t])=>e-t),C=S.length===0?void 0:selectDeliveryPayloads(n,S.map(([e,t])=>({index:e,payload:t})));return{...x,kind:`continue`,remainder:C}}async function answersIdempotencyKey(e,t){let n=(e.deliveryMetadata??[]).map(e=>e.deliveryId);if(n.length===0)return;let r=JSON.stringify([n,t]),i=await crypto.subtle.digest(`SHA-256`,new TextEncoder().encode(r));return`eve-answers:${Array.from(new Uint8Array(i),e=>e.toString(16).padStart(2,`0`)).join(``)}`}function joinTurnDeliveryIds(e,t){if(t.length===0)return e;let n=e[TurnDeliveryIdsKey.name]??[];return{...e,[TurnDeliveryIdsKey.name]:[...new Set([...n,...t])]}}async function mapHeldAnswersStep(e){"use step";return await withSessionStateDelta(e,async()=>{let t=new Set(e.requestIds),n=await deliverChannelAnswers({...e,routable:e=>t.has(e.interactionId)});return n.delivery===e.delivery?{delivery:void 0}:{delivery:n.delivery,serializedContext:n.serializedContext}})}async function deliverChannelAnswers(e){let{routable:t}=e;if(!e.delivery.payloads.some(e=>e.answers?.some(e=>!t(e))===!0))return e;let n=await deserializeContext(e.serializedContext),r=n.require(ChannelKey);if(r.deliver===void 0)return e;e.delivery.auth!==void 0&&n.set(AuthKey,e.delivery.auth??null);let i=r.state??{},a=!1,o=[];for(let s of e.delivery.payloads){if(s.answers===void 0){o.push(s);continue}let e=[];for(let o of s.answers){if(t(o)){e.push(o);continue}let c=buildAdapterContext({...r,state:structuredClone(i)},n),l=(await r.deliver({...s,answers:[o],message:void 0},c))?.answers?.filter(t)??[];if(l.length===0){e.push(o);continue}a=!0,i=c.state,e.push(...l)}o.push({...s,answers:e})}if(!a)return e;let s=await deserializeContext(e.serializedContext);return setChannelContext(s,{...r,state:i}),{delivery:{...e.delivery,payloads:o},serializedContext:serializeContext(s)}}export{answersIdempotencyKey,mapHeldAnswersStep,routeProxiedDeliverStep};
1
+ import{activeTurn,interactionOwner,waiting}from"#protocol/session-projection/selectors.js";import{AuthKey,TurnDeliveryIdsKey}from"#context/keys.js";import{BundleKey,ChannelKey}from"#runtime/sessions/runtime-context-keys.js";import{storedProjection}from"#harness/session-machine/view.js";import{V26_INPUT_REMOTE_AGENT_PROTOCOL}from"#protocol/remote-agent-protocol.js";import{hasDelegatedSessionContext}from"#execution/delegated-session-context.js";import{resolveRemoteAgentStreamHeaders,respondToRemoteAgentSession}from"#execution/agent-sessions/remote.js";import{deserializeContext,serializeContext}from"#context/serialize.js";import{readDurableSession}from"#execution/durable-session-store.js";import{readHitlState}from"#harness/hitl/index.js";import{selectDeliveryPayloads}from"#harness/messages.js";import{resumeSessionInbox}from"#execution/session-inbox/resume.js";import{buildAdapterContext}from"#channel/adapter-context.js";import{commitSessionStep,publishSessionEvents}from"#execution/publish-session-events.js";import"#execution/session/state-delta.js";import{withSessionStateDelta}from"#execution/session/step-state-delta.js";import{routeAnswer}from"#harness/session-machine/transitions.js";import{coalesceDeliverPayloads}from"#execution/deliver-payloads.js";import{fact}from"#harness/facts.js";import{userPartsOf}from"#harness/user-parts.js";import{principalOf}from"#execution/session/delivery-facts.js";import{setChannelContext}from"#execution/channel-context.js";import{isSteeringDelivery}from"#execution/session/input-queue.js";import{continueTurnAuth,resolveTurnPrincipal}from"#execution/session/principal.js";import{routeDeliverPayload}from"#subagents/hitl-proxy.js";import{protocolTwoAnswersSettledOnForward}from"#subagents/protocol-two-callback.js";import{sendWorkflowAskAnswers}from"#execution/tools/workflow/answer.js";async function routeProxiedDeliverStep(e){"use step";return await withSessionStateDelta(e,routeProxiedDeliver)}async function routeProxiedDeliver(e){let t=readHitlState(readDurableSession(e.sessionState).state).relays,{delivery:n,serializedContext:r}=await deliverChannelAnswers({...e,routable:e=>t.has(e.interactionId)}),i=readDurableSession(e.sessionState),a=new Map,o=new Map,s,c=!hasDelegatedSessionContext(r)&&isSteeringDelivery(n,{callerCallId:void 0,principal:resolveTurnPrincipal(void 0,r)},{heldOnPerson:!0}),l=new Set,u=[],d=!1,f=storedProjection(i.state).view,p=activeTurn(f),m=p===void 0?void 0:waiting(f,p.turnId),askedTurn=e=>{let t=interactionOwner(f,e).turnId;return t!==void 0&&f.turns[t]?.status===`running`?t:m?.on===`interaction`&&m.interactions.some(t=>t.interactionId===e.interactionId)?p?.turnId:void 0},h=[],g=[];for(let[e,t]of n.payloads.entries()){let r=routeDeliverPayload({allowRoute:e=>!l.has(e),payload:t,resolveMessage:c,state:i.state});s??=r.parentAction,r.forSelf!==void 0&&a.set(e,r.forSelf);let p=(n.deliveryMetadata??[]).filter(t=>t.payloadIndex===e),m=p[0]?.deliveryId;if(r.forChildren.length>0&&m!==void 0){let e=r.forChildren.find(e=>e.message!==void 0),i=r.forChildren.flatMap(e=>e.payload.answers).map(e=>f.interactions[e.interactionId]).find(e=>e!==void 0&&askedTurn(e)!==void 0),a=i===void 0?void 0:askedTurn(i);e!==void 0&&a!==void 0&&(d=!0),r.forSelf===void 0&&a!==void 0&&u.push(...p.map(e=>e.deliveryId));for(let t of p)h.push({consumed:r.forSelf===void 0&&a!==void 0?{parts:e?.message===void 0?[]:userPartsOf(e.message),turnId:a}:void 0,continues:r.forSelf!==void 0||void 0,deliveryId:t.deliveryId,principal:principalOf(n.auth),source:t.channelKind===void 0?void 0:{channel:t.channelKind}});for(let e of r.forChildren)for(let n of e.payload.answers){let e=(t.answers??[]).indexOf(n),r={};n.optionId!==void 0&&(r.optionId=n.optionId),n.text!==void 0&&(r.text=n.text),g.push({deliveryId:m,interactionId:n.interactionId,responseId:`response_${m}_forwarded_${e===-1?`typed_0`:String(e)}`,value:r})}}for(let[t,i]of r.forChildren.entries()){if(i.workflowAsk!==void 0||i.message!==void 0)for(let{interactionId:e}of i.payload.answers)l.add(e);let a=JSON.stringify([i.childContinuationToken,i.childSessionInbox?.sessionId??``,i.remote?.sessionId??``,i.inputSource??null,i.workflowAsk?.control??null]),s=o.get(a)??{workflowAsk:i.workflowAsk,remote:i.remote,childContinuationToken:i.childContinuationToken,childSessionInbox:i.childSessionInbox,metadata:[],payloads:[]},c=s.payloads.length;if(s.payloads.push(i.payload),r.forSelf===void 0&&t===0)for(let t of n.deliveryMetadata??[])t.payloadIndex===e&&s.metadata.push({...t,payloadIndex:c});o.set(a,s)}}let _={serializedContext:joinAnswerToTurn(r,{auth:d?n.auth:void 0,deliveryIds:u}),sessionState:e.sessionState},v=!1,y=h.filter(e=>e.consumed!==void 0),b=y.length===0?_:await commitSessionStep({..._,sessionWritable:e.sessionWritable},e=>[routeAnswer(e,{deliveries:y,forwarded:[],decided:[]})],{origin:`own`,cancelTurn:()=>{v=!0}});if(v){let t=storedProjection(readDurableSession(b.sessionState).state).view,r=(n.deliveryMetadata??[]).filter(({deliveryId:e,payloadIndex:n})=>a.has(n)&&t.deliveries[e]?.status!==`settled`);if(r.length===0)return{...b,kind:`cancel-turn`};let i=await publishSessionEvents({...b,sessionWritable:e.sessionWritable},r.flatMap(({channelKind:e,deliveryId:r})=>[...t.deliveries[r]===void 0?[fact(`delivery.admitted`,{deliveryId:r,principal:principalOf(n.auth),source:e===void 0?void 0:{channel:e}})]:[],fact(`delivery.settled`,{deliveryId:r,outcome:`ignored`})]));return{kind:`cancel-turn`,serializedContext:i.serializedContext,sessionState:i.sessionState}}let x=[];for(let[e,t]of o)if(t.workflowAsk!==void 0){let e=coalesceDeliverPayloads(t.payloads).answers??[];x.push(...e.map(e=>({answer:e,outcome:`accepted`}))),await sendWorkflowAskAnswers(t.workflowAsk,e,principalOf(n.auth))}else{let i={...n,deliveryMetadata:t.metadata.length===0?void 0:t.metadata,payloads:t.payloads},a=t.remote;if(a!==void 0){let i=await deserializeContext(r),o=await resolveRemoteAgentStreamHeaders({bundle:i.require(BundleKey),name:a.name,dynamicBinding:a.dynamicBinding,resolverId:a.resolverId,url:a.url}),c=coalesceDeliverPayloads(t.payloads).answers??[];if(await respondToRemoteAgentSession({remote:a,headers:o,auth:n.auth,idempotencyKey:await answersIdempotencyKey(n,e),responses:c}),a.earlierProtocol===V26_INPUT_REMOTE_AGENT_PROTOCOL)for(let e of protocolTwoAnswersSettledOnForward({answers:c,decidedHere:s?.answer.interactionId,kindOf:e=>f.interactions[e]?.request.kind}))x.push({answer:e,outcome:`accepted`})}else await resumeSessionInbox(t.childSessionInbox??t.childContinuationToken,i)}let S=await commitSessionStep({...b,sessionWritable:e.sessionWritable},e=>[routeAnswer(e,{decided:s===void 0?x:[...x,{answer:s.answer,outcome:`declined`}],deliveries:h,forwarded:g})],{origin:`relayed`});if(s!==void 0)return{...S,kind:s.kind};let C=[...a].sort(([e],[t])=>e-t),w=C.length===0?void 0:selectDeliveryPayloads(n,C.map(([e,t])=>({index:e,payload:t})));return{...S,kind:`continue`,remainder:w}}async function answersIdempotencyKey(e,t){let n=(e.deliveryMetadata??[]).map(e=>e.deliveryId);if(n.length===0)return;let r=JSON.stringify([n,t]),i=await crypto.subtle.digest(`SHA-256`,new TextEncoder().encode(r));return`eve-answers:${Array.from(new Uint8Array(i),e=>e.toString(16).padStart(2,`0`)).join(``)}`}function joinAnswerToTurn(e,t){let n={...e};if(t.auth!==void 0&&(n[AuthKey.name]=continueTurnAuth(e[AuthKey.name],t.auth)),t.deliveryIds.length>0){let e=n[TurnDeliveryIdsKey.name]??[];n[TurnDeliveryIdsKey.name]=[...new Set([...e,...t.deliveryIds])]}return n}async function mapHeldAnswersStep(e){"use step";return await withSessionStateDelta(e,async()=>{let t=new Set(e.requestIds),n=await deliverChannelAnswers({...e,routable:e=>t.has(e.interactionId)});return n.delivery===e.delivery?{delivery:void 0}:{delivery:n.delivery,serializedContext:n.serializedContext}})}async function deliverChannelAnswers(e){let{routable:t}=e;if(!e.delivery.payloads.some(e=>e.answers?.some(e=>!t(e))===!0))return e;let n=await deserializeContext(e.serializedContext),r=n.require(ChannelKey);if(r.deliver===void 0)return e;e.delivery.auth!==void 0&&n.set(AuthKey,e.delivery.auth??null);let i=r.state??{},a=!1,o=[];for(let s of e.delivery.payloads){if(s.answers===void 0){o.push(s);continue}let e=[];for(let o of s.answers){if(t(o)){e.push(o);continue}let c=buildAdapterContext({...r,state:structuredClone(i)},n),l=(await r.deliver({...s,answers:[o],message:void 0},c))?.answers?.filter(t)??[];if(l.length===0){e.push(o);continue}a=!0,i=c.state,e.push(...l)}o.push({...s,answers:e})}if(!a)return e;let s=await deserializeContext(e.serializedContext);return setChannelContext(s,{...r,state:i}),{delivery:{...e.delivery,payloads:o},serializedContext:serializeContext(s)}}export{answersIdempotencyKey,mapHeldAnswersStep,routeProxiedDeliverStep};
@@ -31,4 +31,7 @@ export declare function fetchWithDispatcher(url: string | URL, init: DispatcherR
31
31
  */
32
32
  export declare function readBoundedResponse(response: Response, maxResponseSize: number): Promise<Response>;
33
33
  export declare function cancelResponseBody(response: Response): Promise<void>;
34
+ export declare class ResponseTooLargeError extends Error {
35
+ constructor(maxResponseSize: number);
36
+ }
34
37
  export {};
@@ -1 +1 @@
1
- import{isBlockedDestinationHost}from"#shared/network-address.js";import{lookup}from"node:dns";var UnsafeDestinationError=class extends Error{constructor(e=`URL must not target localhost, private, link-local, or reserved IP addresses.`){super(e),this.name=`UnsafeDestinationError`}};function assertPublicHostname(e,t){if(isBlockedDestinationHost(e,t))throw new UnsafeDestinationError}async function createPublicDispatcher(e){let{Agent:t,Dispatcher1Wrapper:n}=await import(`undici`);return new n(new t({connect:{lookup:createPublicLookup(e)}}))}function findUnsafeDestinationError(e){return e instanceof UnsafeDestinationError?e:e instanceof Error&&e.cause instanceof UnsafeDestinationError?e.cause:void 0}function fetchWithDispatcher(e,t){return fetch(e,t)}function createPublicLookup(e){return(t,n,r)=>{lookup(t,{all:!0,verbatim:!0},(i,a)=>{if(i!==null){r(i,``,0);return}if(a.some(({address:t})=>isBlockedDestinationHost(t,e))){r(new UnsafeDestinationError,``,0);return}let o=n.family===void 0||n.family===0?a:a.filter(({family:e})=>e===n.family);if(o.length===0){let e=Error(`Unable to resolve URL hostname "${t}" in the requested IP family.`);Object.assign(e,{code:`ENOTFOUND`}),r(e,``,0);return}if(n.all===!0){r(null,o);return}let s=o[0];r(null,s.address,s.family)})}}async function readBoundedResponse(e,t){let n=parseContentLength(e.headers.get(`content-length`));if(n!==void 0&&n>t)throw await cancelResponseBody(e),createResponseTooLargeError(t);let r=await readBoundedBody(e,t),i=r.byteLength===0?null:Uint8Array.from(r).buffer;return new Response(i,{headers:e.headers,status:e.status,statusText:e.statusText})}function parseContentLength(e){if(e===null)return;let t=Number.parseInt(e,10);return Number.isFinite(t)&&t>=0?t:void 0}async function readBoundedBody(e,t){if(e.body===null)return new Uint8Array;let n=e.body.getReader(),r=[],i=0;try{for(;;){let{done:e,value:a}=await n.read();if(e)break;if(i+=a.byteLength,i>t)throw await n.cancel(),createResponseTooLargeError(t);r.push(a)}}finally{n.releaseLock()}let a=new Uint8Array(i),o=0;for(let e of r)a.set(e,o),o+=e.byteLength;return a}async function cancelResponseBody(e){try{await e.body?.cancel()}catch{}}function createResponseTooLargeError(e){return Error(`Response too large (exceeds ${e} bytes).`)}export{UnsafeDestinationError,assertPublicHostname,cancelResponseBody,createPublicDispatcher,fetchWithDispatcher,findUnsafeDestinationError,readBoundedResponse};
1
+ import{isBlockedDestinationHost}from"#shared/network-address.js";import{lookup}from"node:dns";var UnsafeDestinationError=class extends Error{constructor(e=`URL must not target localhost, private, link-local, or reserved IP addresses.`){super(e),this.name=`UnsafeDestinationError`}};function assertPublicHostname(e,t){if(isBlockedDestinationHost(e,t))throw new UnsafeDestinationError}async function createPublicDispatcher(e){let{Agent:t,Dispatcher1Wrapper:n}=await import(`undici`);return new n(new t({connect:{lookup:createPublicLookup(e)}}))}function findUnsafeDestinationError(e){return e instanceof UnsafeDestinationError?e:e instanceof Error&&e.cause instanceof UnsafeDestinationError?e.cause:void 0}function fetchWithDispatcher(e,t){return fetch(e,t)}function createPublicLookup(e){return(t,n,r)=>{lookup(t,{all:!0,verbatim:!0},(i,a)=>{if(i!==null){r(i,``,0);return}if(a.some(({address:t})=>isBlockedDestinationHost(t,e))){r(new UnsafeDestinationError,``,0);return}let o=n.family===void 0||n.family===0?a:a.filter(({family:e})=>e===n.family);if(o.length===0){let e=Error(`Unable to resolve URL hostname "${t}" in the requested IP family.`);Object.assign(e,{code:`ENOTFOUND`}),r(e,``,0);return}if(n.all===!0){r(null,o);return}let s=o[0];r(null,s.address,s.family)})}}async function readBoundedResponse(e,t){let n=parseContentLength(e.headers.get(`content-length`));if(n!==void 0&&n>t)throw await cancelResponseBody(e),new ResponseTooLargeError(t);let r=await readBoundedBody(e,t),i=r.byteLength===0?null:Uint8Array.from(r).buffer;return new Response(i,{headers:e.headers,status:e.status,statusText:e.statusText})}function parseContentLength(e){if(e===null)return;let t=Number.parseInt(e,10);return Number.isFinite(t)&&t>=0?t:void 0}async function readBoundedBody(e,t){if(e.body===null)return new Uint8Array;let n=e.body.getReader(),r=[],i=0;try{for(;;){let{done:e,value:a}=await n.read();if(e)break;if(i+=a.byteLength,i>t)throw await n.cancel(),new ResponseTooLargeError(t);r.push(a)}}finally{n.releaseLock()}let a=new Uint8Array(i),o=0;for(let e of r)a.set(e,o),o+=e.byteLength;return a}async function cancelResponseBody(e){try{await e.body?.cancel()}catch{}}var ResponseTooLargeError=class extends Error{constructor(e){super(`Response too large (exceeds ${e} bytes).`),this.name=`ResponseTooLargeError`}};export{ResponseTooLargeError,UnsafeDestinationError,assertPublicHostname,cancelResponseBody,createPublicDispatcher,fetchWithDispatcher,findUnsafeDestinationError,readBoundedResponse};
@@ -1 +1 @@
1
- import{FACT_CATALOG,isFactType}from"#protocol/session-events/catalog.js";import{copyView}from"#protocol/session-projection/fold.js";import{createLogger}from"#internal/logging.js";import{callAdapterEventHandler}from"#channel/adapter.js";import{contextStorage}from"#context/container.js";import{AuthKey,InitiatorAuthKey,ParentSessionKey,SessionKey}from"#context/keys.js";import{encodeLineBytes}from"#protocol/session-events/envelope.js";import{eventsOfLine,linesOf}from"#protocol/session-lines.js";import{BundleKey,ChannelKey}from"#runtime/sessions/runtime-context-keys.js";import{SESSION_PROJECTION_STATE_KEY,storedProjection}from"#harness/session-machine/view.js";import{advance,currentProjection,currentView,enterSessionProjection,enterSessionProjectionAt,nextLinePosition,recordPublishedLine,saveSessionProjection}from"#harness/session-machine/current.js";import{readSessionStreamTailIndex,streamSessionLines}from"#execution/session-event-stream.js";import{getStepMetadata}from"#compiled/@workflow/core/index.js";import{withContextScope}from"#context/run-step.js";import{deserializeContext,serializeContext}from"#context/serialize.js";import{createDurableSessionState,readDurableSession,replaceDurableSessionSnapshot}from"#execution/durable-session-store.js";import{validateHarnessModelMessages}from"#harness/messages.js";import{buildAdapterContext}from"#channel/adapter-context.js";import{hydrateDurableSession}from"#execution/session.js";import{resolveEffectiveAgentRuntime}from"#execution/effective-agent-config.js";import{dropClosedRecords,saveTransition,sessionView}from"#harness/session-machine/commit.js";import{sessionEndedFacts}from"#harness/facts.js";import{initialSessionProjection}from"#protocol/session-projection.js";import{setChannelContext}from"#execution/channel-context.js";import{runReactions}from"#reactions/runner.js";import{forwardSessionInput}from"#execution/forward-session-input.js";import{reconcileSessionContinuationToken}from"#execution/reconcile-session-continuation-token.js";import{announceWaiting}from"#harness/session-machine/waiting.js";import{cascade}from"#harness/session-machine/cascade.js";import{eventsOf}from"#harness/publication.js";import{bindSessionInstrumentation}from"#instrumentation/runtime.js";import{createStreamChecker}from"#protocol/session-events/checker.js";const log=createLogger(`execution.publish-session-events`);async function publishSessionEvents(e,t,n){let r=!1;return{...await publishEventsFromStep(e,`own`,t,n?.canCancelTurn?()=>{r=!0}:void 0),cancelled:r}}async function publishEventsFromStep(e,t,n,r){if(n.length===0)return{serializedContext:e.serializedContext,sessionState:e.sessionState};let{published:i}=await publishFromSessionStep(await restoreSessionStep(e),{cancelTurn:r,origin:t,async publish(e){await e(n)}});return i}async function restoreSessionStep(e){return{ctx:await deserializeContext(e.serializedContext),durableSession:readDurableSession(e.sessionState),sessionWritable:e.sessionWritable}}async function publishFromSessionStep(e,t){let{ctx:n}=e,r=await publishInSessionScope(e,t),i=t.updateSession?.(r.session,r.result)??{session:r.session},a=readSessionProjection(n),o=reconcileSessionContinuationToken(n,saveSessionProjection(dropClosedRecords(i.session,a),n));return{published:{serializedContext:serializeContext(n),sessionState:createDurableSessionState({session:o}),...`history`in o&&{history:o.history}},result:i.result}}async function publishInSessionScope(e,t){let{ctx:n}=e;enterSessionProjection(n,e.durableSession.state);let r=await readOrphanedLines({sessionId:e.durableSession.sessionId,position:nextLinePosition(n),sessionWritable:e.sessionWritable}),i=resolveEffectiveAgentRuntime(n.require(BundleKey),n),a=hydrateDurableSession({compactionOverrides:{thresholdPercent:i.thresholdPercent},durable:e.durableSession,turnAgent:i.turnAgent}),o=e.history===void 0?a:{...a,history:validateHarnessModelMessages(e.history)},s=t.origin===`own`?bindSessionInstrumentation({agentName:i.turnAgent.id,ctx:n,rootSessionId:o.rootSessionId??o.sessionId,sessionId:o.sessionId}):void 0,c=openSessionEventPublisher({cancelTurn:t.cancelTurn,ctx:n,inputSource:t.inputSource,orphaned:r,origin:t.origin,sessionWritable:e.sessionWritable});try{return await withContextScope(n,o,async e=>{let n=s?.createHandleEvent({handleEvent:c.publish})??c.publish,r=await t.publish(n,e);return await c.finish(),{result:r,session:e}})}finally{await s?.flush(),c.writer.release()}}function checksSessionEvents(){let e=process.env.EVE_CHECK_SESSION_EVENTS;return e===`1`||e!==`0`&&process.env.EVE_DEV===`1`}const interruptedAttempts=new WeakMap;async function readOrphanedLines(e){if(e.always!==!0&&!isRetriedStep())return[];let{sessionId:t,sessionWritable:n,position:r}=e,i=interruptedAttempts.get(n);return i===void 0&&(i=await readLinesFrom(t,r),interruptedAttempts.set(n,i)),i.filter(({position:e})=>e>=r)}function followInterruptedAttempt(e,t){let n=readDurableSession(t),r=storedProjection(n.state),i=(interruptedAttempts.get(e)??[]).filter(({position:e})=>e>=r.view.position);return i.length===0?t:(log.error(`a retried step wrote less than its interrupted attempt; the session follows the stream`,{lines:i.length,sessionId:t.sessionId}),replaceDurableSessionSnapshot({session:{...n,state:{...n.state,[SESSION_PROJECTION_STATE_KEY]:foldOrphanedLines(r,i)}},state:t}))}function isRetriedStep(){try{return getStepMetadata().attempt>1}catch(e){if(e instanceof Error&&e.name===`NotInStepContextError`)return!1;throw e}}async function readLinesFrom(e,t){let n=await readSessionStreamTailIndex(e);if(n+1<t)throw Error(`Session checkpoint is ahead of its stream.`);let r=[];if(n<t)return r;let i=t;for await(let a of streamSessionLines(e,{follow:!1,startIndex:t})){if(a.position>n)break;if(a.line===void 0||a.position!==i)throw Error(`Cannot reconcile an unreadable or missing session line.`);r.push({line:a.line,position:i++})}if(i!==n+1)throw Error(`Session stream ended before its reported tail.`);return r}function foldOrphanedLines(e,t){let n=e;for(let{line:e,position:r}of t){let t=`facts`in e?eventsOfLine(e,r,e.at):[];n=advance(n,e,r,t)}return n}async function reconcilePublishedSessionLines(e,t){let n=e??initialSessionProjection();return foldOrphanedLines(n,await readLinesFrom(t,n.view.position))}function sameLine(e,t){if(`progress`in t||`progress`in e)return`progress`in t&&`progress`in e&&JSON.stringify(e.progress)===JSON.stringify(t.progress);let identity=e=>{let{data:t,type:n}=e;if(!isFactType(n))return String(n);let r=t[FACT_CATALOG[n].idField];return`${n}:${String(r)}`};return e.facts.length===t.facts.length&&e.facts.every((e,n)=>identity(e)===identity(t.facts[n]))}function openSessionEventPublisher(e){let{ctx:t}=e,n=[...e.orphaned??[]],r=createSessionEventDispatcher(e),i=openSessionEventWriter(e.sessionWritable),a,o,emitOne=async e=>{if(a===void 0&&checksSessionEvents()){let{schemaViolation:e}=await import(`#protocol/session-events/schemas.js`);a=createStreamChecker({seed:currentProjection(t).view,validate:e})}o===void 0&&(o=copyView(currentView(t)));let s=cascade(currentView(t),eventsOf(e)),c=new Date().toISOString(),l=[],u=linesOf(s,c).map(e=>({line:e,bytes:encodeLineBytes(e)}));u.forEach(({line:e},n)=>{let r=a?.check(e,nextLinePosition(t)+n);if(r!==void 0&&r.length>0)throw a=void 0,Error(`Session event contract: ${r.map(e=>`${e.rule} at ${e.position}:${e.index??`progress`}: ${e.message}`).join(`; `)}`)});for(let{line:e,bytes:r}of u){let o=nextLinePosition(t),s=n[0];if(s!==void 0){if(s.position!==o||!sameLine(s.line,e))throw Error(`A retried step published differently from its interrupted attempt.`);n.shift();let r=`facts`in s.line?s.line.at:c;recordPublishedLine(t,s.line,o,eventsOfLine(s.line,o,r));continue}await i.write(r).catch(e=>{throw a=void 0,e});let u=eventsOfLine(e,o,c);recordPublishedLine(t,e,o,u);let d=`progress`in e,f=currentView(t);u.forEach(e=>l.push({event:e,position:e.meta.position,progress:d,view:f}))}return await r.deliver(l),l},s=Promise.resolve(),emit=e=>{let t=s.then(()=>emitOne(e));return s=t.then(()=>void 0,()=>void 0),t},publish=async t=>{let n=e.cancelTurn;await r.react(await emit(t),n===void 0?void 0:{cancelTurn:()=>n()})};return{dispatcher:r,writer:i,emit,publish,async finish(e){if(o===void 0)return;let n=e?.announce===!1?[]:announceWaiting(o,currentView(t));o=void 0,n.length>0&&await publish(n)}}}function createSessionEventDispatcher(e){let{ctx:t,inputSource:n}=e,r=t.require(ChannelKey),i=buildAdapterContext(r,t),a=n===void 0?i:{...i,inputSource:n},o=Promise.resolve();return{adapterCtx:i,async deliver(e){if(e.length===0)return;let o,committed=async()=>{if(o===void 0)return;let{facts:e,position:t,view:n}=o;o=void 0,await callAdapterEventHandler(r,{facts:e,position:t.line},{...a,position:t,scope:void 0,view:n})};for(let{event:i,position:s,progress:c,view:l}of e){if(o!==void 0&&o.position.line!==s.line&&await committed(),await forwardSessionInput(t,i,n))continue;c||(o??={facts:[],position:s,view:l}).facts.push(i);let e=`scope`in i?i.scope:void 0;await callAdapterEventHandler(r,i,{...a,position:s,scope:e,view:l})}await committed(),setChannelContext(t,{...r,state:{...i.state}})},react(e,n){if(e.length===0)return Promise.resolve();let r=o.then(()=>runReactions(t,{...n,written:e}));return o=r.catch(()=>void 0),r}}}function openSessionEventWriter(e){let t=e.getWriter(),n=!1,release=()=>{n||(n=!0,t.releaseLock())};return{async write(e){await t.write(e)},close:async()=>{try{await t.close()}finally{release()}},release}}function readSessionProjection(e){return currentProjection(e)}async function publishTerminalSessionEvent(e){let t=e.serializedContext[`eve.sessionId`]??``,n={errorId:e.errorId,sessionId:t},r=`session.ended`,i=e.projection??(e.sessionState===void 0?void 0:storedProjection(readDurableSession(e.sessionState).state));try{i=await reconcilePublishedSessionLines(i,t)}catch(e){throw log.error(`failed to fold the published tail for terminal ${r} event`,{...n,error:e}),e}let a,o;try{a=await deserializeContext(e.serializedContext),enterSessionProjectionAt(a,i),o=openSessionEventPublisher({ctx:a,origin:`own`,sessionWritable:e.sessionWritable})}catch(t){if(log.error(`failed to restore context for terminal ${r} event`,{...n,error:t}),i.view.session.status===`ended`){try{await openSessionEventWriter(e.sessionWritable).close()}catch{}return}let a=cascade(i.view,sessionEndedFacts(i,e.ending));await writeUnroutedSessionEvent(e.sessionWritable,a).catch(e=>log.error(`failed to write terminal ${r} event`,{...n,error:e}));return}if(i.view.session.status===`ended`){try{await o.writer.close()}catch{}finally{o.writer.release()}return}let s=a.get(AuthKey)??null;a.setVirtualContext(SessionKey,{auth:{current:s,initiator:a.get(InitiatorAuthKey)??s},parent:a.get(ParentSessionKey),sessionId:t,turn:e.turn??{id:`turn_0`,sequence:0}});let publish=async e=>{await o.emit(e),await o.writer.close()},c;try{c=bindSessionInstrumentation({agentName:a.require(BundleKey).turnAgent.id,ctx:a,rootSessionId:a.get(ParentSessionKey)?.rootSessionId??t,sessionId:t})}catch(e){log.error(`failed to bind instrumentation for terminal ${r} event`,{...n,error:e})}let l=c?.createHandleEvent({handleEvent:publish})??publish;try{await contextStorage.run(a,()=>l(sessionEndedFacts(i,e.ending)))}catch(e){log.error(`failed to publish terminal ${r} event`,{...n,error:e})}finally{o.writer.release();try{await c?.flush()}catch(e){log.error(`failed to flush instrumentation after terminal ${r} event`,{...n,error:e})}}}async function writeUnroutedSessionEvent(e,t){let n=openSessionEventWriter(e);try{let e=linesOf(t,new Date().toISOString()).map(encodeLineBytes);for(let t of e)await n.write(t);await n.close()}finally{n.release()}}async function commitSessionStep(e,t,n){let{state:r}=`ctx`in e?e.durableSession:readDurableSession(e.sessionState),i=sessionView(storedProjection(r),r),a=t(i);if(a.length>1&&a.some(e=>e.turn!==i.turn)||a.filter(e=>e.signIns!==void 0).length>1)throw Error(`A transition batch must not overlap turn or sign-in snapshots.`);return`ctx`in e?await commit(e,a,n):a.every(e=>changesNothing(i,e))?{serializedContext:e.serializedContext,sessionState:e.sessionState}:await commit(await restoreSessionStep(e),a,n)}async function commit(e,t,n){let{published:r}=await publishFromSessionStep(e,{inputSource:n.inputSource,cancelTurn:n.cancelTurn,origin:n.origin,async publish(e){let n=t.flatMap(e=>e.events);n.length>0&&await e(n)},updateSession:e=>({session:t.reduce((e,t)=>saveTransition(e,t),e)})});return r}function changesNothing(e,t){return t.turn===e.turn&&t.events.length===0&&t.signIns===void 0&&t.relays===void 0&&t.commit===void 0&&t.clearsHistory===void 0}export{checksSessionEvents,commitSessionStep,foldOrphanedLines,followInterruptedAttempt,openSessionEventPublisher,publishFromSessionStep,publishSessionEvents,publishTerminalSessionEvent,readOrphanedLines,readSessionProjection,restoreSessionStep};
1
+ import{FACT_CATALOG,isFactType}from"#protocol/session-events/catalog.js";import{copyView}from"#protocol/session-projection/fold.js";import{createLogger}from"#internal/logging.js";import{callAdapterEventHandler}from"#channel/adapter.js";import{contextStorage}from"#context/container.js";import{AuthKey,InitiatorAuthKey,ParentSessionKey,SessionKey}from"#context/keys.js";import{encodeLineBytes}from"#protocol/session-events/envelope.js";import{eventsOfLine,linesOf}from"#protocol/session-lines.js";import{BundleKey,ChannelKey}from"#runtime/sessions/runtime-context-keys.js";import{SESSION_PROJECTION_STATE_KEY,storedProjection}from"#harness/session-machine/view.js";import{advance,currentProjection,currentView,enterSessionProjection,enterSessionProjectionAt,nextLinePosition,recordPublishedLine,saveSessionProjection}from"#harness/session-machine/current.js";import{readSessionStreamTailIndex,streamSessionLines}from"#execution/session-event-stream.js";import{getStepMetadata}from"#compiled/@workflow/core/index.js";import{withContextScope}from"#context/run-step.js";import{deserializeContext,serializeContext}from"#context/serialize.js";import{createDurableSessionState,readDurableSession,replaceDurableSessionSnapshot}from"#execution/durable-session-store.js";import{validateHarnessModelMessages}from"#harness/messages.js";import{buildAdapterContext}from"#channel/adapter-context.js";import{hydrateDurableSession}from"#execution/session.js";import{resolveEffectiveAgentRuntime}from"#execution/effective-agent-config.js";import{dropClosedRecords,saveTransition,sessionView}from"#harness/session-machine/commit.js";import{initialSessionProjection}from"#protocol/session-projection.js";import{sessionEndedFacts}from"#harness/facts.js";import{setChannelContext}from"#execution/channel-context.js";import{runReactions}from"#reactions/runner.js";import{forwardSessionInput}from"#execution/forward-session-input.js";import{reconcileSessionContinuationToken}from"#execution/reconcile-session-continuation-token.js";import{announceWaiting}from"#harness/session-machine/waiting.js";import{cascade}from"#harness/session-machine/cascade.js";import{eventsOf}from"#harness/publication.js";import{bindSessionInstrumentation}from"#instrumentation/runtime.js";import{createStreamChecker}from"#protocol/session-events/checker.js";const log=createLogger(`execution.publish-session-events`);async function publishSessionEvents(e,t,n){let r=!1;return{...await publishEventsFromStep(e,`own`,t,n?.canCancelTurn?()=>{r=!0}:void 0),cancelled:r}}async function publishEventsFromStep(e,t,n,r){if(n.length===0)return{serializedContext:e.serializedContext,sessionState:e.sessionState};let{published:i}=await publishFromSessionStep(await restoreSessionStep(e),{cancelTurn:r,origin:t,async publish(e){await e(n)}});return i}async function restoreSessionStep(e){return{ctx:await deserializeContext(e.serializedContext),durableSession:readDurableSession(e.sessionState),sessionWritable:e.sessionWritable}}async function publishFromSessionStep(e,t){let{ctx:n}=e,r=await publishInSessionScope(e,t),i=t.updateSession?.(r.session,r.result)??{session:r.session},a=readSessionProjection(n),o=reconcileSessionContinuationToken(n,saveSessionProjection(dropClosedRecords(i.session,a),n));return{published:{serializedContext:serializeContext(n),sessionState:createDurableSessionState({session:o}),...`history`in o&&{history:o.history}},result:i.result}}async function publishInSessionScope(e,t){let{ctx:n}=e;enterSessionProjection(n,e.durableSession.state);let r=await readOrphanedLines({sessionId:e.durableSession.sessionId,position:nextLinePosition(n),sessionWritable:e.sessionWritable}),i=resolveEffectiveAgentRuntime(n.require(BundleKey),n),a=hydrateDurableSession({compactionOverrides:{thresholdPercent:i.thresholdPercent},durable:e.durableSession,turnAgent:i.turnAgent}),o=e.history===void 0?a:{...a,history:validateHarnessModelMessages(e.history)},s=t.origin===`own`?bindSessionInstrumentation({agentName:i.turnAgent.id,ctx:n,rootSessionId:o.rootSessionId??o.sessionId,sessionId:o.sessionId}):void 0,c=openSessionEventPublisher({cancelTurn:t.cancelTurn,ctx:n,inputSource:t.inputSource,orphaned:r,origin:t.origin,sessionWritable:e.sessionWritable});try{return await withContextScope(n,o,async e=>{let n=s?.createHandleEvent({handleEvent:c.publish})??c.publish,r=await t.publish(n,e);return await c.finish(),{result:r,session:e}})}finally{await s?.flush(),c.writer.release()}}function checksSessionEvents(){let e=process.env.EVE_CHECK_SESSION_EVENTS;return e===`1`||e!==`0`&&process.env.EVE_DEV===`1`}const interruptedAttempts=new WeakMap;async function readOrphanedLines(e){if(e.always!==!0&&!isRetriedStep())return[];let{sessionId:t,sessionWritable:n,position:r}=e,i=interruptedAttempts.get(n);return i===void 0&&(i=await readLinesFrom(t,r),interruptedAttempts.set(n,i)),i.filter(({position:e})=>e>=r)}function followInterruptedAttempt(e,t){let n=readDurableSession(t),r=storedProjection(n.state),i=(interruptedAttempts.get(e)??[]).filter(({position:e})=>e>=r.view.position);return i.length===0?t:(log.error(`a retried step wrote less than its interrupted attempt; the session follows the stream`,{lines:i.length,sessionId:t.sessionId}),replaceDurableSessionSnapshot({session:{...n,state:{...n.state,[SESSION_PROJECTION_STATE_KEY]:foldOrphanedLines(r,i)}},state:t}))}function isRetriedStep(){try{return getStepMetadata().attempt>1}catch(e){if(e instanceof Error&&e.name===`NotInStepContextError`)return!1;throw e}}async function readLinesFrom(e,t){let n=await readSessionStreamTailIndex(e);if(n+1<t)throw Error(`Session checkpoint is ahead of its stream.`);let r=[];if(n<t)return r;let i=t;for await(let a of streamSessionLines(e,{follow:!1,startIndex:t})){if(a.position>n)break;if(a.line===void 0||a.position!==i)throw Error(`Cannot reconcile an unreadable or missing session line.`);r.push({line:a.line,position:i++})}if(i!==n+1)throw Error(`Session stream ended before its reported tail.`);return r}function foldOrphanedLines(e,t){let n=e;for(let{line:e,position:r}of t){let t=`facts`in e?eventsOfLine(e,r,e.at):[];n=advance(n,e,r,t)}return n}async function reconcilePublishedSessionLines(e,t){let n=e??initialSessionProjection();return foldOrphanedLines(n,await readLinesFrom(t,n.view.position))}function sameLine(e,t){if(`progress`in t||`progress`in e)return`progress`in t&&`progress`in e&&JSON.stringify(e.progress)===JSON.stringify(t.progress);let identity=e=>{let{data:t,type:n}=e;if(!isFactType(n))return String(n);let r=t[FACT_CATALOG[n].idField];return`${n}:${String(r)}`};return e.facts.length===t.facts.length&&e.facts.every((e,n)=>identity(e)===identity(t.facts[n]))}function openSessionEventPublisher(e){let{ctx:t}=e,n=[...e.orphaned??[]],r=createSessionEventDispatcher(e),i=openSessionEventWriter(e.sessionWritable),a,o,emitOne=async e=>{if(a===void 0&&checksSessionEvents()){let{schemaViolation:e}=await import(`#protocol/session-events/schemas.js`);a=createStreamChecker({seed:currentProjection(t).view,validate:e})}o===void 0&&(o=copyView(currentView(t)));let s=cascade(currentView(t),eventsOf(e)),c=new Date().toISOString(),l=[],u=linesOf(s,c).map(e=>({line:e,bytes:encodeLineBytes(e)}));u.forEach(({line:e},n)=>{let r=a?.check(e,nextLinePosition(t)+n);if(r!==void 0&&r.length>0)throw a=void 0,Error(`Session event contract: ${r.map(e=>`${e.rule} at ${e.position}:${e.index??`progress`}: ${e.message}`).join(`; `)}`)});for(let{line:e,bytes:r}of u){let o=nextLinePosition(t),s=n[0];if(s!==void 0){if(s.position!==o||!sameLine(s.line,e))throw Error(`A retried step published differently from its interrupted attempt.`);n.shift();let r=`facts`in s.line?s.line.at:c;recordPublishedLine(t,s.line,o,eventsOfLine(s.line,o,r));continue}await i.write(r).catch(e=>{throw a=void 0,e});let u=eventsOfLine(e,o,c);recordPublishedLine(t,e,o,u);let d=`progress`in e,f=currentView(t);u.forEach(e=>l.push({event:e,position:e.meta.position,progress:d,view:f}))}return await r.deliver(l),l},s=Promise.resolve(),emit=e=>{let t=s.then(()=>emitOne(e));return s=t.then(()=>void 0,()=>void 0),t},publish=async t=>{let n=e.cancelTurn;await r.react(await emit(t),n===void 0?void 0:{cancelTurn:()=>n()})};return{dispatcher:r,writer:i,emit,publish,async finish(e){if(o===void 0)return;let n=e?.announce===!1?[]:announceWaiting(o,currentView(t));o=void 0,n.length>0&&await publish(n)}}}function createSessionEventDispatcher(e){let{ctx:t,inputSource:n}=e,r=t.require(ChannelKey),i=buildAdapterContext(r,t),a=n===void 0?i:{...i,inputSource:n},o=Promise.resolve();return{adapterCtx:i,async deliver(e){if(e.length===0)return;let o,committed=async()=>{if(o===void 0)return;let{facts:e,position:t,view:n}=o;o=void 0,await callAdapterEventHandler(r,{facts:e,position:t.line},{...a,position:t,scope:void 0,view:n})};for(let{event:i,position:s,progress:c,view:l}of e){if(o!==void 0&&o.position.line!==s.line&&await committed(),await forwardSessionInput(t,i,n))continue;c||(o??={facts:[],position:s,view:l}).facts.push(i);let e=`scope`in i?i.scope:void 0;await callAdapterEventHandler(r,i,{...a,position:s,scope:e,view:l})}await committed(),setChannelContext(t,{...r,state:{...i.state}})},react(e,n){if(e.length===0)return Promise.resolve();let r=o.then(()=>runReactions(t,{...n,written:e}));return o=r.catch(()=>void 0),r}}}function openSessionEventWriter(e){let t=e.getWriter(),n=!1,release=()=>{n||(n=!0,t.releaseLock())};return{async write(e){await t.write(e)},close:async()=>{try{await t.close()}finally{release()}},release}}function readSessionProjection(e){return currentProjection(e)}async function publishTerminalSessionEvent(e){let t=e.serializedContext[`eve.sessionId`]??``,n={errorId:e.errorId,sessionId:t},r=`session.ended`,i=e.projection??(e.sessionState===void 0?void 0:storedProjection(readDurableSession(e.sessionState).state));try{i=await reconcilePublishedSessionLines(i,t)}catch(e){throw log.error(`failed to fold the published tail for terminal ${r} event`,{...n,error:e}),e}let a,o;try{a=await deserializeContext(e.serializedContext),enterSessionProjectionAt(a,i),o=openSessionEventPublisher({ctx:a,origin:`own`,sessionWritable:e.sessionWritable})}catch(t){if(log.error(`failed to restore context for terminal ${r} event`,{...n,error:t}),i.view.session.status===`ended`){try{await openSessionEventWriter(e.sessionWritable).close()}catch{}return}let a=cascade(i.view,sessionEndedFacts(i,e.ending));await writeUnroutedSessionEvent(e.sessionWritable,a).catch(e=>log.error(`failed to write terminal ${r} event`,{...n,error:e}));return}if(i.view.session.status===`ended`){try{await o.writer.close()}catch{}finally{o.writer.release()}return}let s=a.get(AuthKey)??null;a.setVirtualContext(SessionKey,{auth:{current:s,initiator:a.get(InitiatorAuthKey)??s},parent:a.get(ParentSessionKey),sessionId:t,turn:e.turn??{id:`turn_0`,sequence:0}});let publish=async e=>{await o.emit(e),await o.writer.close()},c;try{c=bindSessionInstrumentation({agentName:a.require(BundleKey).turnAgent.id,ctx:a,rootSessionId:a.get(ParentSessionKey)?.rootSessionId??t,sessionId:t})}catch(e){log.error(`failed to bind instrumentation for terminal ${r} event`,{...n,error:e})}let l=c?.createHandleEvent({handleEvent:publish})??publish;try{await contextStorage.run(a,()=>l(sessionEndedFacts(i,e.ending)))}catch(e){log.error(`failed to publish terminal ${r} event`,{...n,error:e})}finally{o.writer.release();try{await c?.flush()}catch(e){log.error(`failed to flush instrumentation after terminal ${r} event`,{...n,error:e})}}}async function writeUnroutedSessionEvent(e,t){let n=openSessionEventWriter(e);try{let e=linesOf(t,new Date().toISOString()).map(encodeLineBytes);for(let t of e)await n.write(t);await n.close()}finally{n.release()}}async function commitSessionStep(e,t,n){let{state:r}=`ctx`in e?e.durableSession:readDurableSession(e.sessionState),i=sessionView(storedProjection(r),r),a=t(i);if(a.length>1&&a.some(e=>e.turn!==i.turn)||a.filter(e=>e.signIns!==void 0).length>1)throw Error(`A transition batch must not overlap turn or sign-in snapshots.`);return`ctx`in e?await commit(e,a,n):a.every(e=>changesNothing(i,e))?{serializedContext:e.serializedContext,sessionState:e.sessionState}:await commit(await restoreSessionStep(e),a,n)}async function commit(e,t,n){let{published:r}=await publishFromSessionStep(e,{inputSource:n.inputSource,cancelTurn:n.cancelTurn,origin:n.origin,async publish(e){let n=t.flatMap(e=>e.events);n.length>0&&await e(n)},updateSession:e=>({session:t.reduce((e,t)=>saveTransition(e,t),e)})});return r}function changesNothing(e,t){return t.turn===e.turn&&t.events.length===0&&t.signIns===void 0&&t.relays===void 0&&t.commit===void 0&&t.clearsHistory===void 0}export{checksSessionEvents,commitSessionStep,foldOrphanedLines,followInterruptedAttempt,openSessionEventPublisher,publishFromSessionStep,publishSessionEvents,publishTerminalSessionEvent,readOrphanedLines,readSessionProjection,restoreSessionStep};
@@ -1 +1 @@
1
- import{answersDeliveryId}from"#shared/answers-delivery-id.js";import{activeTurnId,storedProjection,turnPosition}from"#harness/session-machine/view.js";import{coalesceDeliveries,selectDeliveryPayloads}from"#harness/messages.js";import{readDurableSession}from"#execution/durable-session-read.js";import{mapHeldAnswersStep}from"#execution/proxied-deliver-step.js";import{controlDeliveryOf}from"#execution/session/control-delivery.js";import{settleControlDeliveryStep}from"#execution/session/settle-control-delivery-step.js";import{routeDeliverToChildren}from"#execution/route-child-delivery.js";import{admitSessionInboxPayload}from"#execution/session/admission.js";import{isSteeringDelivery,isSteeringMessage}from"#execution/session/input-queue.js";import{routeSelectedDelivery}from"#execution/session/route-selected-delivery.js";import{createTurnControl}from"#execution/session/turn-control.js";import{decodeSessionInboxPayload}from"#execution/session-inbox/protocol.js";import{isAgentSessionMessage,runMessageBatchBudget}from"#execution/tools/workflow/messages.js";import{isAppliedRunMessage,takeLeadingAppliedRunMessages}from"#execution/session-workflow-tool-run.js";import{TurnCancelledError}from"#harness/turn-cancellation.js";var ActiveTurn=class{admitted=new Set;routedToChildren=new Set;mappedForHeldRequest=new Set;runtimeResults=[];controller;#e;#t;expectedTurnId;input;identity;unsubscribe;unsubscribeDelivery;steeringController;caller;compacted=!1;constructor(e,t,n=createTurnControl()){this.controller=n.cancellation,this.steeringController=n.steering,this.input=e,this.caller=t.caller,this.#t=t.control===!0,this.identity={callerCallId:t.caller?.callId,principal:t.principal},this.expectedTurnId=activeTurnId(turnPosition(storedProjection(readDurableSession(e.cursor.sessionState).state))),this.unsubscribe=e.inbox.onInterrupt(e=>{this.cancelsThisTurn(e)&&this.abort()}),this.unsubscribeDelivery=e.inbox.onDelivery(this.signalSteering)}signalSteering=e=>{let t;try{t=decodeSessionInboxPayload(e)}catch{return}t.kind===`deliver`&&!this.input.queue.isDuplicate(t)&&isSteeringMessage(t,this.identity)&&!this.input.cursor.sessionState.hasProxyInputRequests&&this.steeringController.abort()};get signal(){return this.controller.signal}dispose(){this.unsubscribe(),this.unsubscribeDelivery()}get steeringSignal(){return this.steeringController.signal}resetSteering(){this.steeringController.signal.aborted&&(this.unsubscribeDelivery(),this.steeringController=new AbortController,this.unsubscribeDelivery=this.input.inbox.onDelivery(this.signalSteering))}async admitBoundary(e=!1){let t=this.input.inbox.drain();for(let n of t)await this.admit(n,e)}async takeSteering(e){let t=[];for(;;){let n=this.input.queue.takeSteering(this.admitted,this.identity,e);if(n===void 0)break;for(let e of n.sequences)this.admitted.delete(e);let r=await routeSelectedDelivery(n,this.input.cursor);if(r.kind===`cancel-turn`){this.abort();break}r.kind===`turn`&&t.push(r.delivery)}if(this.resetSteering(),t.length===0)return;let n=t.length===1?t[0]:coalesceDeliveries(t);return n.caller!==void 0&&(this.caller=n.caller),n}takeBoundaryMessages(e){let t=[],n=[];for(let r of this.runtimeResults){let i=asBoundaryMessage(r);i===void 0||e!==void 0&&!e(i)?n.push(r):t.push(i)}return this.runtimeResults.splice(0,this.runtimeResults.length,...n),t}takeAppliedRunMessages(){let e=runMessageBatchBudget(),t=[];for(let n=this.runtimeResults[0];n!==void 0;n=this.runtimeResults[0]){if(n===`cancelled`||n.kind!==`workflow`||!isAppliedRunMessage(n.message)||!e(n.message))return t;t.push(n.message),this.runtimeResults.shift()}return[...t,...takeLeadingAppliedRunMessages(this.input.inbox,e)]}async nextRuntimeEvent(e){for(;;){let t=await this.routeAdmittedToChildren();if(this.signal.aborted)return`cancelled`;if(t)return{kind:`steering`};let n=this.runtimeResults.shift();if(n!==void 0)return n;let r=await this.waitForInboxOrTimer(e);if(r!==void 0)return{callId:r,kind:`timeout`};let i=await this.input.inbox.next();if(i===void 0)throw Error(`Session inbox closed before runtime actions completed.`);if(await this.admit(i))return{kind:`input`}}}async takeAnswers(e){for(let t of this.admitted){let n=this.input.queue.delivery(t);if(n===void 0)continue;let r=n.payloads.flatMap(e=>e.answers??[]);if(r.length===0)continue;if(!r.some(t=>e.has(t.interactionId))){if(this.mappedForHeldRequest.has(t))continue;this.mappedForHeldRequest.add(t);let r=n,i=await this.input.cursor.advance(t=>mapHeldAnswersStep({delivery:r,requestIds:[...e],...t}));if(i.delivery===void 0)continue;n=i.delivery}this.admitted.delete(t);let i=isSteeringDelivery(n,this.identity,{heldOnPerson:!0})?void 0:splitAnswers(n);return this.input.queue.replaceDelivery(t,i?.rest),i?.answers??n}}async waitForInboxOrTimer(e){if(e.length===0||this.input.inbox.hasPending())return;let t=this.input.inbox.whenPending().then(()=>void 0);return await Promise.race([t,...e])}cancelsThisTurn(e){return e.kind===`reset`||e.kind===`session-failure`?!0:e.kind!==`cancel`||this.#t?!1:e.turnId===void 0||e.turnId===this.expectedTurnId}async admit(e,t=!1){let n=await admitSessionInboxPayload(e,this.input);switch(n.kind){case`delivery`:return this.admitted.add(n.admission.sequence),!0;case`runtime-action-result`:return this.runtimeResults.push({kind:`runtime-action-result`,results:n.payload.results}),!1;case`workflow`:return this.runtimeResults.push({kind:`workflow`,message:n.message}),!1;case`cancel`:if((!t||e.kind!==`cancel`)&&this.cancelsThisTurn(e)&&this.#e===void 0)this.#e??=n.origin,this.abort();else if(n.origin!==void 0){let e=controlDeliveryOf(n.origin);await this.input.cursor.advance(t=>settleControlDeliveryStep({...t,settlement:{control:e,outcome:`ignored`,source:`cancel`}}))}return!1;case`consumed`:return e.kind===`authorization-callback`}}async routeAdmittedToChildren(){let e=!1;for(let t of this.admitted){if(this.routedToChildren.has(t))continue;let n=this.input.queue.delivery(t);if(n===void 0){this.admitted.delete(t);continue}this.routedToChildren.add(t);let r=await this.input.cursor.advance(e=>routeDeliverToChildren({delivery:n,...e}));if(r.kind===`cancel-turn`)return this.input.queue.replaceDelivery(t,void 0),this.admitted.delete(t),this.abort(),!1;if(this.input.queue.replaceDelivery(t,r.remainder),r.remainder===void 0){this.admitted.delete(t);continue}isSteeringMessage(r.remainder,this.identity)&&(e=!0)}return e}get cancelledBy(){return this.#e}abort(){this.controller.signal.aborted||this.controller.abort(new TurnCancelledError)}};function asBoundaryMessage(e){if(e!==`cancelled`&&e.kind===`workflow`&&(e.message.from.taskId!==void 0||isAgentSessionMessage(e.message)))return e.message}function splitAnswers(e){let t=e.payloads.flatMap((e,t)=>e.answers===void 0?[]:[{index:t,payload:{answers:e.answers}}]),n=e.payloads.flatMap((e,t)=>{if(e.message===void 0)return[];let{answers:n,...r}=e;return[{index:t,payload:r}]}),r=selectDeliveryPayloads(e,t),i=new Set(n.map(({index:e})=>e));return{answers:{...r,deliveryMetadata:r.deliveryMetadata?.map(e=>({...e,deliveryId:i.has(t[e.payloadIndex].index)?answersDeliveryId(e.deliveryId):e.deliveryId}))},rest:n.length===0?void 0:selectDeliveryPayloads(e,n)}}export{ActiveTurn};
1
+ import{answersDeliveryId}from"#shared/answers-delivery-id.js";import{activeTurnId,storedProjection,turnPosition}from"#harness/session-machine/view.js";import{coalesceDeliveries,selectDeliveryPayloads}from"#harness/messages.js";import{readDurableSession}from"#execution/durable-session-read.js";import{isSteeringDelivery,isSteeringMessage}from"#execution/session/input-queue.js";import{mapHeldAnswersStep}from"#execution/proxied-deliver-step.js";import{controlDeliveryOf}from"#execution/session/control-delivery.js";import{settleControlDeliveryStep}from"#execution/session/settle-control-delivery-step.js";import{routeDeliverToChildren}from"#execution/route-child-delivery.js";import{admitSessionInboxPayload}from"#execution/session/admission.js";import{routeSelectedDelivery}from"#execution/session/route-selected-delivery.js";import{createTurnControl}from"#execution/session/turn-control.js";import{decodeSessionInboxPayload}from"#execution/session-inbox/protocol.js";import{isAgentSessionMessage,runMessageBatchBudget}from"#execution/tools/workflow/messages.js";import{isAppliedRunMessage,takeLeadingAppliedRunMessages}from"#execution/session-workflow-tool-run.js";import{TurnCancelledError}from"#harness/turn-cancellation.js";var ActiveTurn=class{admitted=new Set;routedToChildren=new Set;mappedForHeldRequest=new Set;runtimeResults=[];controller;#e;#t;expectedTurnId;input;identity;unsubscribe;unsubscribeDelivery;steeringController;caller;compacted=!1;constructor(e,t,n=createTurnControl()){this.controller=n.cancellation,this.steeringController=n.steering,this.input=e,this.caller=t.caller,this.#t=t.control===!0,this.identity={callerCallId:t.caller?.callId,principal:t.principal},this.expectedTurnId=activeTurnId(turnPosition(storedProjection(readDurableSession(e.cursor.sessionState).state))),this.unsubscribe=e.inbox.onInterrupt(e=>{this.cancelsThisTurn(e)&&this.abort()}),this.unsubscribeDelivery=e.inbox.onDelivery(this.signalSteering)}signalSteering=e=>{let t;try{t=decodeSessionInboxPayload(e)}catch{return}t.kind===`deliver`&&!this.input.queue.isDuplicate(t)&&isSteeringMessage(t,this.identity)&&!this.input.cursor.sessionState.hasProxyInputRequests&&this.steeringController.abort()};get signal(){return this.controller.signal}dispose(){this.unsubscribe(),this.unsubscribeDelivery()}get steeringSignal(){return this.steeringController.signal}resetSteering(){this.steeringController.signal.aborted&&(this.unsubscribeDelivery(),this.steeringController=new AbortController,this.unsubscribeDelivery=this.input.inbox.onDelivery(this.signalSteering))}async admitBoundary(e=!1){let t=this.input.inbox.drain();for(let n of t)await this.admit(n,e)}async takeSteering(e){let t=[];for(;;){let n=this.input.queue.takeSteering(this.admitted,this.identity,e);if(n===void 0)break;for(let e of n.sequences)this.admitted.delete(e);let r=await routeSelectedDelivery(n,this.input.cursor);if(r.kind===`cancel-turn`){this.abort();break}r.kind===`turn`&&t.push(r.delivery)}if(this.resetSteering(),t.length===0)return;let n=t.length===1?t[0]:coalesceDeliveries(t);return n.caller!==void 0&&(this.caller=n.caller),n}takeBoundaryMessages(e){let t=[],n=[];for(let r of this.runtimeResults){let i=asBoundaryMessage(r);i===void 0||e!==void 0&&!e(i)?n.push(r):t.push(i)}return this.runtimeResults.splice(0,this.runtimeResults.length,...n),t}takeAppliedRunMessages(){let e=runMessageBatchBudget(),t=[];for(let n=this.runtimeResults[0];n!==void 0;n=this.runtimeResults[0]){if(n===`cancelled`||n.kind!==`workflow`||!isAppliedRunMessage(n.message)||!e(n.message))return t;t.push(n.message),this.runtimeResults.shift()}return[...t,...takeLeadingAppliedRunMessages(this.input.inbox,e)]}async nextRuntimeEvent(e){for(;;){let t=await this.routeAdmittedToChildren();if(this.signal.aborted)return`cancelled`;if(t)return{kind:`steering`};let n=this.runtimeResults.shift();if(n!==void 0)return n;let r=await this.waitForInboxOrTimer(e);if(r!==void 0)return{callId:r,kind:`timeout`};let i=await this.input.inbox.next();if(i===void 0)throw Error(`Session inbox closed before runtime actions completed.`);if(await this.admit(i))return{kind:`input`}}}async takeAnswers(e){for(let t of this.admitted){let n=this.input.queue.delivery(t);if(n===void 0)continue;let r=n.payloads.flatMap(e=>e.answers??[]);if(r.length===0)continue;if(!r.some(t=>e.has(t.interactionId))){if(this.mappedForHeldRequest.has(t))continue;this.mappedForHeldRequest.add(t);let r=n,i=await this.input.cursor.advance(t=>mapHeldAnswersStep({delivery:r,requestIds:[...e],...t}));if(i.delivery===void 0)continue;n=i.delivery}this.admitted.delete(t);let i=isSteeringDelivery(n,this.identity,{heldOnPerson:!0})?void 0:splitAnswers(n);return this.input.queue.replaceDelivery(t,i?.rest),i?.answers??n}}async waitForInboxOrTimer(e){if(e.length===0||this.input.inbox.hasPending())return;let t=this.input.inbox.whenPending().then(()=>void 0);return await Promise.race([t,...e])}cancelsThisTurn(e){return e.kind===`reset`||e.kind===`session-failure`?!0:e.kind!==`cancel`||this.#t?!1:e.turnId===void 0||e.turnId===this.expectedTurnId}async admit(e,t=!1){let n=await admitSessionInboxPayload(e,this.input);switch(n.kind){case`delivery`:return this.admitted.add(n.admission.sequence),!0;case`runtime-action-result`:return this.runtimeResults.push({kind:`runtime-action-result`,results:n.payload.results}),!1;case`workflow`:return this.runtimeResults.push({kind:`workflow`,message:n.message}),!1;case`cancel`:if((!t||e.kind!==`cancel`)&&this.cancelsThisTurn(e)&&this.#e===void 0)this.#e??=n.origin,this.abort();else if(n.origin!==void 0){let e=controlDeliveryOf(n.origin);await this.input.cursor.advance(t=>settleControlDeliveryStep({...t,settlement:{control:e,outcome:`ignored`,source:`cancel`}}))}return!1;case`consumed`:return e.kind===`authorization-callback`}}async routeAdmittedToChildren(){let e=!1;for(let t of this.admitted){if(this.routedToChildren.has(t))continue;let n=this.input.queue.delivery(t);if(n===void 0){this.admitted.delete(t);continue}this.routedToChildren.add(t);let r=await this.input.cursor.advance(e=>routeDeliverToChildren({delivery:n,...e}));if(r.kind===`cancel-turn`)return this.input.queue.replaceDelivery(t,void 0),this.admitted.delete(t),this.abort(),!1;if(this.input.queue.replaceDelivery(t,r.remainder),r.remainder===void 0){this.admitted.delete(t);continue}isSteeringMessage(r.remainder,this.identity)&&(e=!0)}return e}get cancelledBy(){return this.#e}abort(){this.controller.signal.aborted||this.controller.abort(new TurnCancelledError)}};function asBoundaryMessage(e){if(e!==`cancelled`&&e.kind===`workflow`&&(e.message.from.taskId!==void 0||isAgentSessionMessage(e.message)))return e.message}function splitAnswers(e){let t=e.payloads.flatMap((e,t)=>e.answers===void 0?[]:[{index:t,payload:{answers:e.answers}}]),n=e.payloads.flatMap((e,t)=>{if(e.message===void 0)return[];let{answers:n,...r}=e;return[{index:t,payload:r}]}),r=selectDeliveryPayloads(e,t),i=new Set(n.map(({index:e})=>e));return{answers:{...r,deliveryMetadata:r.deliveryMetadata?.map(e=>({...e,deliveryId:i.has(t[e.payloadIndex].index)?answersDeliveryId(e.deliveryId):e.deliveryId}))},rest:n.length===0?void 0:selectDeliveryPayloads(e,n)}}export{ActiveTurn};
@@ -2,13 +2,17 @@ import type { SessionAuthContext } from "#channel/types.js";
2
2
  import type { SessionStateMap, HarnessStepInput } from "#harness/types.js";
3
3
  /**
4
4
  * Answering a request does not make the responder the turn's caller. When
5
- * `stepInput` only answers pending requests, returns it with each approval
6
- * answer naming its responder, so approval policies and the approved call
7
- * see the responder while the turn keeps its caller. Returns `undefined` when
8
- * the input carries anything else, such as a message or a stale answer; its
9
- * sender becomes the caller.
5
+ * `stepInput` only answers requests, returns it with each answer to an open
6
+ * approval naming its responder, so approval policies and the approved call
7
+ * see the responder while the turn keeps its caller. Another principal's
8
+ * answer to a request that is no longer open settles nothing, and as text it
9
+ * would steer the open turn, so it is dropped. Returns `undefined` when the
10
+ * input carries a message, or only stale answers the sender may turn into
11
+ * text; its sender becomes the caller.
10
12
  */
11
13
  export declare function attributeAnswers(input: {
14
+ /** The open turn's caller; `undefined` when the delivery starts a turn. */
15
+ readonly owner?: SessionAuthContext | null;
12
16
  readonly responder: SessionAuthContext | null;
13
17
  readonly state: SessionStateMap | undefined;
14
18
  readonly stepInput: HarnessStepInput | undefined;
@@ -1 +1 @@
1
- import{openRequests}from"#protocol/session-projection/reader.js";import{interactionOwner}from"#protocol/session-projection/selectors.js";import{storedProjection}from"#harness/session-machine/view.js";function attributeAnswers(e){let{stepInput:t}=e,n=t?.answers??[];if(t===void 0||t.message!==void 0||n.length===0)return;let r=storedProjection(e.state).view,i=new Map(openRequests(r).flatMap(e=>e.origin===void 0&&interactionOwner(r,e).taskId===void 0?[[e.interactionId,e.request.kind]]:[]));if(n.every(e=>i.has(e.interactionId)))return{...t,answers:n.map(t=>i.get(t.interactionId)===`approval`?{...t,responder:e.responder}:t)}}export{attributeAnswers};
1
+ import{openRequests}from"#protocol/session-projection/reader.js";import{interactionOwner}from"#protocol/session-projection/selectors.js";import{storedProjection}from"#harness/session-machine/view.js";import{principalOf}from"#execution/session/principal.js";function attributeAnswers(e){let{stepInput:t}=e,n=t?.answers??[];if(t===void 0||t.message!==void 0||n.length===0)return;let r=storedProjection(e.state).view,i=openRequests(r),a=new Map(i.flatMap(e=>e.origin===void 0&&interactionOwner(r,e).taskId===void 0?[[e.interactionId,e.request.kind]]:[])),o=new Set(i.map(e=>e.interactionId)),s=e.owner!==void 0&&principalOf(e.owner)!==principalOf(e.responder),c=n.filter(e=>!s||o.has(e.interactionId));if(c.length!==n.length||c.some(e=>a.has(e.interactionId)))return{...t,answers:c.map(t=>a.get(t.interactionId)===`approval`?{...t,responder:e.responder}:t)}}export{attributeAnswers};
@@ -1,13 +1,25 @@
1
1
  import { type SessionCheckpoint } from "#execution/session/handoff.js";
2
+ import { type PreV27Checkpoint } from "#execution/session/pre-v27-checkpoint.js";
2
3
  /**
3
- * Oldest checkpoint a successor accepts: the first that writes v27 session events. A session
4
- * whose stream began in the earlier shape stays on the deployment that owns it, since its
5
- * stream's lines, projection, and private records of running work changed shape together.
4
+ * Oldest checkpoint a successor upgrades in place: the first that writes v27 session events.
5
+ * Older ones, from an owner before v27, are imported instead (`pre-v27-checkpoint.ts`): their
6
+ * stream's lines, projection, and private records of running work changed shape together, so the
7
+ * successor also folds their stream before it continues.
6
8
  */
7
9
  export declare const MIN_SESSION_CHECKPOINT_VERSION = 18;
8
10
  export type SessionCheckpointMigration = {
9
11
  readonly kind: "current";
10
12
  readonly checkpoint: SessionCheckpoint;
13
+ }
14
+ /** A checkpoint from an owner before v27, still without the projection its stream holds. */
15
+ | {
16
+ readonly kind: "pre-v27";
17
+ readonly imported: PreV27Checkpoint;
18
+ }
19
+ /** An owner before v27 still runs work for the session; a later delivery can move it. */
20
+ | {
21
+ readonly kind: "busy";
22
+ readonly detail: string;
11
23
  } | {
12
24
  readonly kind: "incompatible";
13
25
  readonly detail: string;
@@ -15,7 +27,6 @@ export type SessionCheckpointMigration = {
15
27
  /**
16
28
  * Upgrades a checkpoint written by an older eve build to the current shape.
17
29
  * Pure, so the session workflow can run it before validation. Newer
18
- * checkpoints and those older than {@link MIN_SESSION_CHECKPOINT_VERSION} are
19
- * incompatible.
30
+ * checkpoints and those older than eve 0.69 are incompatible.
20
31
  */
21
32
  export declare function migrateSessionCheckpoint(checkpoint: unknown): SessionCheckpointMigration;
@@ -1 +1 @@
1
- import{isObject}from"#shared/guards.js";import{DELIVERY_IDEMPOTENCY_WINDOW,MAX_DELIVERY_IDEMPOTENCY_KEY_LENGTH}from"#channel/delivery-idempotency.js";import{SESSION_CHECKPOINT_VERSION}from"#execution/session/handoff.js";const MIN_SESSION_CHECKPOINT_VERSION=18,CHECKPOINT_UPGRADES={};function migrateSessionCheckpoint(e){if(!isObject(e))return{kind:`incompatible`,detail:`checkpoint is not an object`};let{version:t}=e;if(typeof t==`number`&&t<18)return{kind:`incompatible`,detail:`checkpoint version ${t} predates v27 session events; the session continues on the deployment that owns it`};if(typeof t!=`number`||!Number.isSafeInteger(t)||t>SESSION_CHECKPOINT_VERSION)return{kind:`incompatible`,detail:`checkpoint version ${JSON.stringify(t)} is outside the supported range 18-${SESSION_CHECKPOINT_VERSION}`};let n=e;try{for(let e=t;e<SESSION_CHECKPOINT_VERSION;e++){let t=CHECKPOINT_UPGRADES[e];t===void 0&&refuse(`no upgrade from checkpoint version ${e}`),n={...t(n),version:e+1}}}catch(e){if(!(e instanceof CheckpointRefusal))throw e;return{kind:`incompatible`,detail:`checkpoint version ${t}: ${e.message}`}}return isCurrentCheckpoint(n)?{kind:`current`,checkpoint:n}:{kind:`incompatible`,detail:`checkpoint version ${t} is incomplete`}}function isCurrentCheckpoint(e){return isObject(e)&&e.version===SESSION_CHECKPOINT_VERSION&&Array.isArray(e.admittedDeliveryKeys)&&e.admittedDeliveryKeys.length<=DELIVERY_IDEMPOTENCY_WINDOW&&e.admittedDeliveryKeys.every(e=>typeof e==`string`&&e.length>0&&e.length<=MAX_DELIVERY_IDEMPOTENCY_KEY_LENGTH)&&Array.isArray(e.history)&&isObject(e.serializedContext)&&isObject(e.sessionState)}var CheckpointRefusal=class extends Error{};function refuse(e){throw new CheckpointRefusal(e)}export{MIN_SESSION_CHECKPOINT_VERSION,migrateSessionCheckpoint};
1
+ import{isObject}from"#shared/guards.js";import{DELIVERY_IDEMPOTENCY_WINDOW,MAX_DELIVERY_IDEMPOTENCY_KEY_LENGTH}from"#channel/delivery-idempotency.js";import{SESSION_CHECKPOINT_VERSION}from"#execution/session/handoff.js";import{importPreV27Checkpoint,isPreV27CheckpointVersion}from"#execution/session/pre-v27-checkpoint.js";import{CheckpointRefusal,refuse}from"#execution/session/checkpoint-refusal.js";const MIN_SESSION_CHECKPOINT_VERSION=18,CHECKPOINT_UPGRADES={};function migrateSessionCheckpoint(e){if(!isObject(e))return{kind:`incompatible`,detail:`checkpoint is not an object`};let{version:t}=e;if(isPreV27CheckpointVersion(t)){let n=importPreV27Checkpoint({...e,version:t});if(n.kind!==`pre-v27`)return n;let{imported:r}=n;return isCurrentCheckpoint(r.checkpoint)?{kind:`pre-v27`,imported:{...r,checkpoint:r.checkpoint}}:{kind:`incompatible`,detail:`checkpoint version ${t} is incomplete`}}if(typeof t!=`number`||!Number.isSafeInteger(t)||t<18||t>SESSION_CHECKPOINT_VERSION)return{kind:`incompatible`,detail:`checkpoint version ${JSON.stringify(t)} is outside the supported ranges: 10-17 import, 18-${SESSION_CHECKPOINT_VERSION} upgrade`};let n=e;try{for(let e=t;e<SESSION_CHECKPOINT_VERSION;e++){let t=CHECKPOINT_UPGRADES[e];t===void 0&&refuse(`no upgrade from checkpoint version ${e}`),n={...t(n),version:e+1}}}catch(e){if(!(e instanceof CheckpointRefusal))throw e;return{kind:`incompatible`,detail:`checkpoint version ${t}: ${e.message}`}}return isCurrentCheckpoint(n)?{kind:`current`,checkpoint:n}:{kind:`incompatible`,detail:`checkpoint version ${t} is incomplete`}}function isCurrentCheckpoint(e){return isObject(e)&&e.version===SESSION_CHECKPOINT_VERSION&&Array.isArray(e.admittedDeliveryKeys)&&e.admittedDeliveryKeys.length<=DELIVERY_IDEMPOTENCY_WINDOW&&e.admittedDeliveryKeys.every(e=>typeof e==`string`&&e.length>0&&e.length<=MAX_DELIVERY_IDEMPOTENCY_KEY_LENGTH)&&Array.isArray(e.history)&&isObject(e.serializedContext)&&isObject(e.sessionState)}export{MIN_SESSION_CHECKPOINT_VERSION,migrateSessionCheckpoint};
@@ -0,0 +1,4 @@
1
+ /** State a checkpoint holds that this build cannot continue; the owner that wrote it keeps the session. */
2
+ export declare class CheckpointRefusal extends Error {
3
+ }
4
+ export declare function refuse(detail: string): never;
@@ -0,0 +1 @@
1
+ var CheckpointRefusal=class extends Error{};function refuse(e){throw new CheckpointRefusal(e)}export{CheckpointRefusal,refuse};
@@ -1 +1 @@
1
- import{attachClientContext,readClientContext}from"#internal/client-context.js";import{SESSION_INBOX_CONTEXT_KEY,sessionCommandHookToken}from"#execution/session-inbox/address.js";import{readSerializedSessionSchedule}from"#context/session-schedule.js";import{storedProjection}from"#harness/session-machine/view.js";import{createHook,getWorkflowMetadata,getWritable}from"#compiled/@workflow/core/index.js";import{claimHookOwnership,isHookConflictError}from"#execution/hook-ownership.js";import{DEFAULT_SESSION_TIMEOUT_MS}from"#execution/session/timeout.js";import{sessionHookTokens}from"#execution/session/hook-tokens.js";import{createSessionInbox}from"#execution/session-inbox/inbox.js";import{failSession,runPreparedSession}from"#execution/session/program.js";import{createSessionTimeoutControl}from"#execution/session/timeout-control.js";import{prepareSuccessorStep,signalSessionOwnerActivationStep}from"#execution/session/handoff-steps.js";import{hasDelegatedSessionContext}from"#execution/delegated-session-context.js";import{readChannelRequestId,readRootSessionId}from"#execution/eve-workflow-attributes.js";import{createTurnControl}from"#execution/session/turn-control.js";import{HANDOFF_LEASE_RETENTION,handoffLeaseToken,sendSessionHandover}from"#execution/session/handoff.js";import{resolveInitialTurnCallerStep}from"#subagents/parent-notification.js";import{normalizeSerializableError}from"#execution/workflow-errors.js";import{createSessionStep}from"#execution/create-session-step.js";import{closeSessionStreamStep}from"#execution/close-session-stream-step.js";import{settleContinuationConflictStep}from"#execution/continuation-conflict-step.js";import{migrateSessionCheckpoint}from"#execution/session/checkpoint-migrations.js";import{abandonHandoverIfRunEnds,watchRunEnd}from"#execution/session/run-watch.js";async function workflowEntry(e){"use workflow";let t=e.kind===`initial`?await bootInitialOwner(e,getWorkflowMetadata().workflowRunId):(e.handoffVersion??0)>=3?await bootForcedHandoffOwner(e):await bootReleasedHandoffOwner(e);return t===void 0?{output:``}:{output:(await runPreparedSession(t.session,t.inbox)).output}}function stampSessionIdentity(e,t){return{...e,"eve.sessionId":t,[SESSION_INBOX_CONTEXT_KEY]:{sessionId:t}}}async function prepareInitialOwner(e,t){let n={kind:`owned`,timeoutControl:createSessionTimeoutControl({sessionId:t.sessionId,timeoutMs:t.sessionTimeoutMs}),turnControl:createTurnControl()},r={confirmAfter:t.sessionCreation},[i,a]=await Promise.allSettled([e.claimSessionHook(sessionCommandHookToken(t.sessionId),r),t.continuationToken===``?Promise.resolve():e.claimSessionHook(t.continuationToken,r)]);if(i.status===`rejected`)throw i.reason;if(a.status===`rejected`){if(isHookConflictError(a.reason))return{kind:`alias-conflict`};throw a.reason}return n}function unwrapSettled(e){if(e.status===`rejected`)throw e.reason;return e.value}async function bootInitialOwner(e,t){let n=stampSessionIdentity(e.serializedContext,t),r=getWritable(),i=createSessionInbox(t),a=e.sessionTimeoutMs??DEFAULT_SESSION_TIMEOUT_MS,o=n[`eve.continuationToken`]||``,s=n[`eve.bundle`];try{let c=createSessionStep({agentSessionRuntimeOverrides:n[`eve.agentSessionRuntimeOverrides`],compiledArtifactsSource:s.source,continuationToken:o,dynamicSubagentAgentConfig:n[`eve.dynamicSubagentAgentConfig`],history:e.input.message===void 0?e.input.history:void 0,nodeId:s.nodeId,outputSchema:e.input.outputSchema,rootSessionId:readRootSessionId(n),sessionId:t}),l=prepareInitialOwner(i,{continuationToken:o,sessionCreation:c,sessionId:t,sessionTimeoutMs:a}),u=hasDelegatedSessionContext(n)?resolveInitialTurnCallerStep({serializedContext:n}):Promise.resolve(void 0),[d,f,p]=await Promise.allSettled([c,l,u]),m=unwrapSettled(d),h=unwrapSettled(f);if(h.kind===`alias-conflict`){e.continuationConflictCommand!==void 0&&await settleContinuationConflictStep({command:e.continuationConflictCommand,continuationToken:o}),await i.dispose(),await closeSessionStreamStep({sessionWritable:r});return}let g=unwrapSettled(p);return{inbox:i,session:{admittedDeliveryKeys:e.idempotencyKey===void 0?[]:[e.idempotencyKey],anchor:{kind:`self`},caller:g,capabilities:n[`eve.capabilities`],deploymentId:e.ownerDeploymentId,history:m.history,start:e.input.message===void 0?{kind:`first-message`}:{input:createInitialDelivery(e,n),kind:`turn`},initialTurnControl:h.turnControl,retention:e.retention,serializedContext:n,sessionId:t,sessionState:m.state,sessionTimeoutControl:h.timeoutControl,sessionTimeoutMs:a,sessionWritable:r}}}catch(e){return await i.dispose(),await failSession({error:e,serializedContext:n,sessionId:t,sessionState:void 0,sessionWritable:r})}}async function prepareSuccessor(e,t){let{sessionId:n}=e,r=migrateSessionCheckpoint(e.checkpoint),i=await prepareSuccessorStep({handoffVersion:e.handoffVersion,migration:r,sessionId:n,...t!==void 0&&{source:t}});if(r.kind===`incompatible`||i.kind===`incompatible`){await signalSessionOwnerActivationStep({activation:{kind:`incompatible`,payloads:[],reason:`checkpoint-version`,runId:getWorkflowMetadata().workflowRunId},token:e.activationToken});return}if(i.kind===`source-gone`){await signalFailedActivation(e,Error(`The session's previous owner no longer holds all of its addresses.`),{payloads:[]});return}let{checkpoint:a}=r;return{checkpoint:a,serializedContext:stampSessionIdentity(a.serializedContext,n)}}async function signalFailedActivation(e,t,n){await signalSessionOwnerActivationStep({activation:{error:normalizeSerializableError(t),kind:`failed`,runId:getWorkflowMetadata().workflowRunId,...n},token:e.activationToken})}async function bootForcedHandoffOwner(e){let{attemptKey:t,hookTokens:n,sessionId:r,sourceRunId:i}=e;if(t===void 0||n===void 0||i===void 0){await signalFailedActivation(e,Error(`Session handoff version 3 input is missing attemptKey, hookTokens, or sourceRunId.`),{payloads:[]});return}try{let e=createHook({experimental_minRetention:HANDOFF_LEASE_RETENTION,token:handoffLeaseToken(t)});await claimHookOwnership(e)}catch(t){if(isHookConflictError(t))return;await signalFailedActivation(e,t,{payloads:[]});return}let a;try{a=await prepareSuccessor(e,{hookTokens:n,runId:i})}catch(t){await signalFailedActivation(e,t,{payloads:[]});return}if(a===void 0)return;let o=createSessionInbox(r);try{await o.claimSessionHooks(n,{force:!0,handover:t})}catch(n){let a=o.claimedTokens.length>0;await signalFailedActivation(e,n,{claimedHooks:a,payloads:[]}),a&&await handBack(o,{attemptKey:t,sessionId:r,sourceRunId:i}),await o.dispose();return}return abandonHandoverIfRunEnds(o,{attemptKey:t,sourceRunId:i}),await startSuccessor(e,o,a)}async function handBack(e,t){let n=watchRunEnd(t.sourceRunId),r=new AbortController;try{if(await Promise.race([e.whenTakenOver(r.signal).then(()=>`taken-back`),n.ended.then(()=>`source-ended`)])===`source-ended`)return}finally{n.stop(),r.abort()}await sendSessionHandover({attemptKey:t.attemptKey,payloads:e.drain(),sessionId:t.sessionId})}async function bootReleasedHandoffOwner(e){let t=createSessionInbox(e.sessionId),n;try{if(n=await prepareSuccessor(e),n===void 0)return;await t.claimSessionHooks(sessionHookTokens({serializedContext:n.serializedContext,sessionState:n.checkpoint.sessionState})),await signalSessionOwnerActivationStep({activation:{kind:`active`},token:e.activationToken})}catch(n){await signalFailedActivation(e,n,{payloads:await t.release()});return}return await startSuccessor(e,t,n)}async function startSuccessor(e,t,n){let{sessionId:r}=e,{checkpoint:i,serializedContext:a}=n;return{inbox:t,session:{anchor:{kind:`successor`},admittedDeliveryKeys:i.admittedDeliveryKeys,caller:e.delivery?.caller,capabilities:i.capabilities,deploymentId:e.ownerDeploymentId,history:i.history,start:e.delivery===void 0?storedProjection(i.sessionState.snapshot.session.state).view.session.status===`new`?{kind:`first-message`}:{kind:`parked`}:{input:e.delivery,kind:`turn`},retention:i.retention,serializedContext:a,sessionId:r,sessionState:i.sessionState,sessionTimeoutControl:createSessionTimeoutControl({deadline:e.reason===`prewarm`?e.sessionTimeoutDeadline:void 0,sessionId:r,timeoutMs:i.sessionTimeoutMs}),sessionTimeoutMs:i.sessionTimeoutMs,sessionWritable:e.sessionWritable}}}function createInitialDelivery(e,t){if(e.input.message!==void 0)return{auth:t[`eve.auth`],idempotencyKey:e.idempotencyKey,schedule:readSerializedSessionSchedule(t),deliveryMetadata:t[`eve.channelDelivery`]===void 0?void 0:[{...t[`eve.channelDelivery`],payloadIndex:0}],kind:`deliver`,payloads:[attachClientContext({message:e.input.message,context:e.input.context,history:e.input.history,outputSchema:e.input.outputSchema,state:e.input.state},readClientContext(e.input))],requestId:readChannelRequestId(t)}}workflowEntry.workflowId=`workflow//eve//workflowEntry`;export{bootInitialOwner,workflowEntry};
1
+ import{attachClientContext,readClientContext}from"#internal/client-context.js";import{SESSION_INBOX_CONTEXT_KEY,sessionCommandHookToken}from"#execution/session-inbox/address.js";import{readSerializedSessionSchedule}from"#context/session-schedule.js";import{storedProjection}from"#harness/session-machine/view.js";import{hasDelegatedSessionContext}from"#execution/delegated-session-context.js";import{createHook,getWorkflowMetadata,getWritable}from"#compiled/@workflow/core/index.js";import{claimHookOwnership,isHookConflictError}from"#execution/hook-ownership.js";import{DEFAULT_SESSION_TIMEOUT_MS}from"#execution/session/timeout.js";import{sessionHookTokens}from"#execution/session/hook-tokens.js";import{createSessionInbox}from"#execution/session-inbox/inbox.js";import{failSession,runPreparedSession}from"#execution/session/program.js";import{createSessionTimeoutControl}from"#execution/session/timeout-control.js";import{prepareSuccessorStep,readSessionStreamTailStep,signalSessionOwnerActivationStep}from"#execution/session/handoff-steps.js";import{readChannelRequestId,readRootSessionId}from"#execution/eve-workflow-attributes.js";import{createTurnControl}from"#execution/session/turn-control.js";import{HANDOFF_LEASE_RETENTION,handoffLeaseToken,sendSessionHandover}from"#execution/session/handoff.js";import{preV27Projection,withProjection}from"#execution/session/pre-v27-checkpoint.js";import{resolveInitialTurnCallerStep}from"#subagents/parent-notification.js";import{normalizeSerializableError}from"#execution/workflow-errors.js";import{createSessionStep}from"#execution/create-session-step.js";import{closeSessionStreamStep}from"#execution/close-session-stream-step.js";import{settleContinuationConflictStep}from"#execution/continuation-conflict-step.js";import{migrateSessionCheckpoint}from"#execution/session/checkpoint-migrations.js";import{abandonHandoverIfRunEnds,watchRunEnd}from"#execution/session/run-watch.js";async function workflowEntry(e){"use workflow";let t=e.kind===`initial`?await bootInitialOwner(e,getWorkflowMetadata().workflowRunId):(e.handoffVersion??0)>=3?await bootForcedHandoffOwner(e):await bootReleasedHandoffOwner(e);return t===void 0?{output:``}:{output:(await runPreparedSession(t.session,t.inbox)).output}}function stampSessionIdentity(e,t){return{...e,"eve.sessionId":t,[SESSION_INBOX_CONTEXT_KEY]:{sessionId:t}}}async function prepareInitialOwner(e,t){let n={kind:`owned`,timeoutControl:createSessionTimeoutControl({sessionId:t.sessionId,timeoutMs:t.sessionTimeoutMs}),turnControl:createTurnControl()},r={confirmAfter:t.sessionCreation},[i,a]=await Promise.allSettled([e.claimSessionHook(sessionCommandHookToken(t.sessionId),r),t.continuationToken===``?Promise.resolve():e.claimSessionHook(t.continuationToken,r)]);if(i.status===`rejected`)throw i.reason;if(a.status===`rejected`){if(isHookConflictError(a.reason))return{kind:`alias-conflict`};throw a.reason}return n}function unwrapSettled(e){if(e.status===`rejected`)throw e.reason;return e.value}async function bootInitialOwner(e,t){let n=stampSessionIdentity(e.serializedContext,t),r=getWritable(),i=createSessionInbox(t),a=e.sessionTimeoutMs??DEFAULT_SESSION_TIMEOUT_MS,o=n[`eve.continuationToken`]||``,s=n[`eve.bundle`];try{let c=createSessionStep({agentSessionRuntimeOverrides:n[`eve.agentSessionRuntimeOverrides`],compiledArtifactsSource:s.source,continuationToken:o,dynamicSubagentAgentConfig:n[`eve.dynamicSubagentAgentConfig`],history:e.input.message===void 0?e.input.history:void 0,nodeId:s.nodeId,outputSchema:e.input.outputSchema,rootSessionId:readRootSessionId(n),sessionId:t}),l=prepareInitialOwner(i,{continuationToken:o,sessionCreation:c,sessionId:t,sessionTimeoutMs:a}),u=hasDelegatedSessionContext(n)?resolveInitialTurnCallerStep({serializedContext:n}):Promise.resolve(void 0),[d,f,p]=await Promise.allSettled([c,l,u]),m=unwrapSettled(d),h=unwrapSettled(f);if(h.kind===`alias-conflict`){e.continuationConflictCommand!==void 0&&await settleContinuationConflictStep({command:e.continuationConflictCommand,continuationToken:o}),await i.dispose(),await closeSessionStreamStep({sessionWritable:r});return}let g=unwrapSettled(p);return{inbox:i,session:{admittedDeliveryKeys:e.idempotencyKey===void 0?[]:[e.idempotencyKey],anchor:{kind:`self`},caller:g,capabilities:n[`eve.capabilities`],deploymentId:e.ownerDeploymentId,history:m.history,start:e.input.message===void 0?{kind:`first-message`}:{input:createInitialDelivery(e,n),kind:`turn`},initialTurnControl:h.turnControl,retention:e.retention,serializedContext:n,sessionId:t,sessionState:m.state,sessionTimeoutControl:h.timeoutControl,sessionTimeoutMs:a,sessionWritable:r}}}catch(e){return await i.dispose(),await failSession({error:e,serializedContext:n,sessionId:t,sessionState:void 0,sessionWritable:r})}}async function prepareSuccessor(e,t){let{sessionId:n}=e,r=migrateSessionCheckpoint(e.checkpoint);if(r.kind===`busy`){await signalFailedActivation(e,Error(r.detail),{payloads:[]});return}let i=await prepareSuccessorStep({handoffVersion:e.handoffVersion,migration:r,sessionId:n,...t!==void 0&&{source:t}});if(r.kind===`incompatible`||i.kind===`incompatible`){await signalSessionOwnerActivationStep({activation:{kind:`incompatible`,payloads:[],reason:`checkpoint-version`,runId:getWorkflowMetadata().workflowRunId},token:e.activationToken});return}if(i.kind===`source-gone`){await signalFailedActivation(e,Error(`The session's previous owner no longer holds all of its addresses.`),{payloads:[]});return}if(r.kind===`current`){let{checkpoint:e}=r;return{checkpoint:e,serializedContext:stampSessionIdentity(e.serializedContext,n)}}let{checkpoint:a,turnCount:o}=r.imported;return{checkpoint:a,importedTurnCount:o,serializedContext:stampSessionIdentity(a.serializedContext,n)}}async function placeImportedSession(e,t){if(t.importedTurnCount===void 0)return t;let n=await readSessionStreamTailStep({sessionId:e}),r=preV27Projection(n,t.importedTurnCount);return{...t,checkpoint:withProjection(t.checkpoint,r)}}async function signalFailedActivation(e,t,n){await signalSessionOwnerActivationStep({activation:{error:normalizeSerializableError(t),kind:`failed`,runId:getWorkflowMetadata().workflowRunId,...n},token:e.activationToken})}async function bootForcedHandoffOwner(e){let{attemptKey:t,hookTokens:n,sessionId:r,sourceRunId:i}=e;if(t===void 0||n===void 0||i===void 0){await signalFailedActivation(e,Error(`Session handoff version 3 input is missing attemptKey, hookTokens, or sourceRunId.`),{payloads:[]});return}try{let e=createHook({experimental_minRetention:HANDOFF_LEASE_RETENTION,token:handoffLeaseToken(t)});await claimHookOwnership(e)}catch(t){if(isHookConflictError(t))return;await signalFailedActivation(e,t,{payloads:[]});return}let a;try{a=await prepareSuccessor(e,{hookTokens:n,runId:i})}catch(t){await signalFailedActivation(e,t,{payloads:[]});return}if(a===void 0)return;let o=createSessionInbox(r);try{await o.claimSessionHooks(n,{force:!0,handover:t}),a=await placeImportedSession(r,a)}catch(n){let a=o.claimedTokens.length>0;await signalFailedActivation(e,n,{claimedHooks:a,payloads:[]}),a&&await handBack(o,{attemptKey:t,sessionId:r,sourceRunId:i}),await o.dispose();return}return abandonHandoverIfRunEnds(o,{attemptKey:t,sourceRunId:i}),await startSuccessor(e,o,a)}async function handBack(e,t){let n=watchRunEnd(t.sourceRunId),r=new AbortController;try{if(await Promise.race([e.whenTakenOver(r.signal).then(()=>`taken-back`),n.ended.then(()=>`source-ended`)])===`source-ended`)return}finally{n.stop(),r.abort()}await sendSessionHandover({attemptKey:t.attemptKey,payloads:e.drain(),sessionId:t.sessionId})}async function bootReleasedHandoffOwner(e){let t=createSessionInbox(e.sessionId),n;try{if(n=await prepareSuccessor(e),n===void 0)return;await t.claimSessionHooks(sessionHookTokens({serializedContext:n.serializedContext,sessionState:n.checkpoint.sessionState})),n=await placeImportedSession(e.sessionId,n),await signalSessionOwnerActivationStep({activation:{kind:`active`},token:e.activationToken})}catch(n){await signalFailedActivation(e,n,{payloads:await t.release()});return}return await startSuccessor(e,t,n)}async function startSuccessor(e,t,n){let{sessionId:r}=e,{checkpoint:i,serializedContext:a}=n;return{inbox:t,session:{anchor:{kind:`successor`},admittedDeliveryKeys:i.admittedDeliveryKeys,caller:e.delivery?.caller,capabilities:i.capabilities,compactFirst:n.importedTurnCount!==void 0&&i.history.length>0,deploymentId:e.ownerDeploymentId,history:i.history,start:e.delivery===void 0?storedProjection(i.sessionState.snapshot.session.state).view.session.status===`new`?{kind:`first-message`}:{kind:`parked`}:{input:e.delivery,kind:`turn`},retention:i.retention,serializedContext:a,sessionId:r,sessionState:i.sessionState,sessionTimeoutControl:createSessionTimeoutControl({deadline:e.reason===`prewarm`?e.sessionTimeoutDeadline:void 0,sessionId:r,timeoutMs:i.sessionTimeoutMs}),sessionTimeoutMs:i.sessionTimeoutMs,sessionWritable:e.sessionWritable}}}function createInitialDelivery(e,t){if(e.input.message!==void 0)return{auth:t[`eve.auth`],idempotencyKey:e.idempotencyKey,schedule:readSerializedSessionSchedule(t),deliveryMetadata:t[`eve.channelDelivery`]===void 0?void 0:[{...t[`eve.channelDelivery`],payloadIndex:0}],kind:`deliver`,payloads:[attachClientContext({message:e.input.message,context:e.input.context,history:e.input.history,outputSchema:e.input.outputSchema,state:e.input.state},readClientContext(e.input))],requestId:readChannelRequestId(t)}}workflowEntry.workflowId=`workflow//eve//workflowEntry`;export{bootInitialOwner,workflowEntry};
@@ -52,7 +52,9 @@ export type SessionCheckpointValidation = {
52
52
  export declare function prepareSuccessorStep(input: {
53
53
  /** Absent for version 1 sources, which predate the field. */
54
54
  readonly handoffVersion: number | undefined;
55
- readonly migration: SessionCheckpointMigration;
55
+ readonly migration: Exclude<SessionCheckpointMigration, {
56
+ readonly kind: "busy";
57
+ }>;
56
58
  readonly sessionId: string;
57
59
  /** Version 3: the run that still holds the session and the addresses it hands over. */
58
60
  readonly source?: {
@@ -114,3 +116,7 @@ export declare function signalSessionAnchorStep(input: {
114
116
  };
115
117
  readonly token: string;
116
118
  }): Promise<void>;
119
+ /** The position of the session stream's last line, or `-1` before the first. */
120
+ export declare function readSessionStreamTailStep(input: {
121
+ readonly sessionId: string;
122
+ }): Promise<number>;
@@ -1 +1 @@
1
- import{createLogger}from"#internal/logging.js";import{sessionCommandHookToken,sessionInboxHookToken}from"#execution/session-inbox/address.js";import{resolveInstalledPackageInfo}from"#internal/application/package.js";import{getSandboxEnvironmentRuntime}from"#shared/sandbox-environment.js";import{BundleKey}from"#runtime/sessions/runtime-context-keys.js";import{getWorld,resumeHook}from"#internal/workflow/runtime.js";import{hasRunEnded,startWorkflowOnDeployment,workflowEntryReference}from"#execution/workflow-runtime.js";import{getResolvedRuntimeAgentNode}from"#runtime/graph.js";import{IncompatibleStateLayoutError,deserializeContext}from"#context/serialize.js";import{readDurableSession}from"#execution/durable-session-read.js";import{HookNotFoundError}from"#compiled/@workflow/errors/index.js";import{findSessionHookHolder}from"#execution/session-inbox/owner.js";import{EVE_PREWARM_ATTRIBUTE,EVE_SESSION_ATTRIBUTE,EVE_VERSION_ATTRIBUTE}from"#execution/eve-workflow-attributes.js";import{owningSandboxDefinition}from"#runtime/sandbox/registry.js";import{isRetiredSandboxSessionState,resolvePersistedSandboxSessionState}from"#sandbox/state.js";import{SESSION_CHECKPOINT_VERSION}from"#execution/session/handoff.js";import{mapWithConcurrency}from"#shared/map-with-concurrency.js";import{isSessionStateIdleForHandoff}from"#execution/session/handoff-state.js";import{SESSION_HANDOFF_VERSION}from"#execution/session/entry-input.js";import{traceSessionHandover}from"#execution/session/handover-tracing.js";const log=createLogger(`execution.handoff`);async function startSuccessorStep(e){"use step";let{activationToken:t,anchorRunId:n,checkpoint:r,sessionWritable:i,targetDeploymentId:a,...o}=e,{capabilities:s}=await getWorld();if(s?.hookForceClaim!==!0||s.hookRetention?.active!==!0)return log.warn(`session handoff unavailable: the Workflow world cannot force-claim hooks`,{sessionId:n}),{kind:`unsupported`};if(!isSessionStateIdleForHandoff(r))return{kind:`not-idle`};let c={...o,activationToken:t,checkpoint:r,handoffVersion:SESSION_HANDOFF_VERSION,kind:`handoff`,ownerDeploymentId:a,sessionWritable:i,sessionId:n};return{kind:`started`,runId:(await startWorkflowOnDeployment(workflowEntryReference,[c],a,r.retention===void 0?void 0:{experimental_retention:r.retention})).runId}}async function hasRunEndedStep(e){"use step";return await hasRunEnded(e.runId)}async function prepareSuccessorStep(e){"use step";let{migration:t}=e,unreadable=t=>(log.warn(`session handoff refused: this deployment cannot read the checkpoint`,{detail:t,readableCheckpointVersion:SESSION_CHECKPOINT_VERSION,sessionId:e.sessionId}),{kind:`incompatible`,reason:`checkpoint-version`});if(t.kind===`incompatible`)return unreadable(t.detail);let{checkpoint:n}=t,r=n.sessionTimeoutMs;if(r!==!1&&(typeof r!=`number`||!Number.isFinite(r)||r<0))throw Error(`Session checkpoint contains an invalid timeout duration.`);let i;try{i=await deserializeContext(n.serializedContext)}catch(e){if(e instanceof IncompatibleStateLayoutError)return unreadable(e.message);throw e}let a=i.require(BundleKey),o=readDurableSession(n.sessionState).sandboxState?.session;if(o!=null&&!isRetiredSandboxSessionState(o)){let e=owningSandboxDefinition(getResolvedRuntimeAgentNode(a.graph,a.nodeId).sandboxRegistry.sandbox);if(e.kind!==`independent`)throw Error(`Session checkpoint sandbox has no resolved provider.`);let t=getSandboxEnvironmentRuntime(e.environment),n=resolvePersistedSandboxSessionState(o,t);if(n?.providerName!==t.providerName||n.stateProtocolVersion!==t.stateProtocolVersion)throw Error(`Session checkpoint sandbox provider state is incompatible.`)}if(!isSessionStateIdleForHandoff(n))throw Error(`Session checkpoint contains pending work and cannot be handed off.`);return e.source!==void 0&&!await holdsEveryAddress(e.source)?{kind:`source-gone`}:(await recordSessionOwner(e.sessionId),(e.handoffVersion??1)<SESSION_HANDOFF_VERSION&&log.info(`session moved from an owner that releases its addresses first`,{handoffVersion:e.handoffVersion??1,sessionId:e.sessionId}),{kind:`valid`})}async function holdsEveryAddress(e){return(await mapWithConcurrency(e.hookTokens,16,e=>findSessionHookHolder(sessionInboxHookToken(e)))).every(t=>t?.runId===e.runId)}async function reportSessionHandoffRetainedStep(e){"use step";log.warn(`session handoff failed; the current owner keeps the session`,{...e,checkpointVersion:SESSION_CHECKPOINT_VERSION})}async function recordSessionOwnerStep(e){"use step";await recordSessionOwner(e.sessionId)}async function recordSessionOwner(e){let{setAttributes:t}=await import(`#compiled/@workflow/core/index.js`);await t({[EVE_SESSION_ATTRIBUTE]:e,[EVE_PREWARM_ATTRIBUTE]:`1`,[EVE_VERSION_ATTRIBUTE]:resolveInstalledPackageInfo().version},{allowReservedAttributes:!0})}async function signalSessionOwnerActivationStep(e){"use step";try{await resumeHook(e.token,e.activation)}catch(e){if(!HookNotFoundError.is(e))throw e}}async function reportSessionTakenOverOutsideAttemptStep(e){"use step";log.error(`session taken over with no handoff attempt open; this run leaves without finalizing`,{sessionId:e.sessionId})}async function reportHandoverPartStuckStep(e){"use step";log.warn(`session handover part keeps failing; the previous owner keeps retrying`,e)}async function sendSessionHandoverPartStep(e){"use step";let t={"eve.handoff.buffered_payload_count":e.bufferedPayloadCount,"eve.handoff.part_index":e.part.index};e.part.index===0&&traceSessionHandover(`forwarding_started`,e.sessionId,e.part.attemptKey,t);try{let n=await resumeHook(sessionInboxHookToken(sessionCommandHookToken(e.sessionId)),{...e.part,kind:`handover`});return traceSessionHandover(e.part.final===!0?`final_submitted`:`part_submitted`,e.sessionId,e.part.attemptKey,{...t,"eve.handoff.destination_run_id":n.runId}),`delivered`}catch(e){if(HookNotFoundError.is(e))return`session-ended`;throw e}}async function signalSessionAnchorStep(e){"use step";await resumeHook(e.token,e.result)}export{hasRunEndedStep,prepareSuccessorStep,recordSessionOwnerStep,reportHandoverPartStuckStep,reportSessionHandoffRetainedStep,reportSessionTakenOverOutsideAttemptStep,sendSessionHandoverPartStep,signalSessionAnchorStep,signalSessionOwnerActivationStep,startSuccessorStep};
1
+ import{createLogger}from"#internal/logging.js";import{sessionCommandHookToken,sessionInboxHookToken}from"#execution/session-inbox/address.js";import{resolveInstalledPackageInfo}from"#internal/application/package.js";import{getSandboxEnvironmentRuntime}from"#shared/sandbox-environment.js";import{BundleKey}from"#runtime/sessions/runtime-context-keys.js";import{getWorld,resumeHook}from"#internal/workflow/runtime.js";import{hasRunEnded,startWorkflowOnDeployment,workflowEntryReference}from"#execution/workflow-runtime.js";import{readSessionStreamTailIndex}from"#execution/session-event-stream.js";import{getResolvedRuntimeAgentNode}from"#runtime/graph.js";import{IncompatibleStateLayoutError,deserializeContext}from"#context/serialize.js";import{readDurableSession}from"#execution/durable-session-read.js";import{HookNotFoundError}from"#compiled/@workflow/errors/index.js";import{findSessionHookHolder}from"#execution/session-inbox/owner.js";import{EVE_PREWARM_ATTRIBUTE,EVE_SESSION_ATTRIBUTE,EVE_VERSION_ATTRIBUTE}from"#execution/eve-workflow-attributes.js";import{owningSandboxDefinition}from"#runtime/sandbox/registry.js";import{isRetiredSandboxSessionState,resolvePersistedSandboxSessionState}from"#sandbox/state.js";import{SESSION_CHECKPOINT_VERSION}from"#execution/session/handoff.js";import{mapWithConcurrency}from"#shared/map-with-concurrency.js";import{isSessionStateIdleForHandoff}from"#execution/session/handoff-state.js";import{SESSION_HANDOFF_VERSION}from"#execution/session/entry-input.js";import{traceSessionHandover}from"#execution/session/handover-tracing.js";const log=createLogger(`execution.handoff`);async function startSuccessorStep(e){"use step";let{activationToken:t,anchorRunId:n,checkpoint:r,sessionWritable:i,targetDeploymentId:a,...o}=e,{capabilities:s}=await getWorld();if(s?.hookForceClaim!==!0||s.hookRetention?.active!==!0)return log.warn(`session handoff unavailable: the Workflow world cannot force-claim hooks`,{sessionId:n}),{kind:`unsupported`};if(!isSessionStateIdleForHandoff(r))return{kind:`not-idle`};let c={...o,activationToken:t,checkpoint:r,handoffVersion:SESSION_HANDOFF_VERSION,kind:`handoff`,ownerDeploymentId:a,sessionWritable:i,sessionId:n};return{kind:`started`,runId:(await startWorkflowOnDeployment(workflowEntryReference,[c],a,r.retention===void 0?void 0:{experimental_retention:r.retention})).runId}}async function hasRunEndedStep(e){"use step";return await hasRunEnded(e.runId)}async function prepareSuccessorStep(e){"use step";let{migration:t}=e,unreadable=t=>(log.warn(`session handoff refused: this deployment cannot read the checkpoint`,{detail:t,readableCheckpointVersion:SESSION_CHECKPOINT_VERSION,sessionId:e.sessionId}),{kind:`incompatible`,reason:`checkpoint-version`});if(t.kind===`incompatible`)return unreadable(t.detail);let refuse=e=>{if(t.kind===`pre-v27`)return unreadable(e);throw Error(e)},n=t.kind===`pre-v27`?t.imported.checkpoint:t.checkpoint,r=n.sessionTimeoutMs;if(r!==!1&&(typeof r!=`number`||!Number.isFinite(r)||r<0))return refuse(`Session checkpoint contains an invalid timeout duration.`);let i;try{i=await deserializeContext(n.serializedContext)}catch(e){if(e instanceof IncompatibleStateLayoutError)return unreadable(e.message);throw e}let a=i.require(BundleKey),o=readDurableSession(n.sessionState).sandboxState?.session;if(o!=null&&!isRetiredSandboxSessionState(o)){let e=owningSandboxDefinition(getResolvedRuntimeAgentNode(a.graph,a.nodeId).sandboxRegistry.sandbox);if(e.kind!==`independent`)return refuse(`Session checkpoint sandbox has no resolved provider.`);let t=getSandboxEnvironmentRuntime(e.environment),n=resolvePersistedSandboxSessionState(o,t);if(n?.providerName!==t.providerName||n.stateProtocolVersion!==t.stateProtocolVersion)return refuse(`Session checkpoint sandbox provider state is incompatible.`)}return isSessionStateIdleForHandoff(n)?e.source!==void 0&&!await holdsEveryAddress(e.source)?{kind:`source-gone`}:(await recordSessionOwner(e.sessionId),(e.handoffVersion??1)<SESSION_HANDOFF_VERSION&&log.info(`session moved from an owner that releases its addresses first`,{handoffVersion:e.handoffVersion??1,sessionId:e.sessionId}),t.kind===`pre-v27`&&log.info(`session handoff accepted from an owner before v27`,{sessionId:e.sessionId}),{kind:`valid`}):refuse(`Session checkpoint contains pending work and cannot be handed off.`)}async function holdsEveryAddress(e){return(await mapWithConcurrency(e.hookTokens,16,e=>findSessionHookHolder(sessionInboxHookToken(e)))).every(t=>t?.runId===e.runId)}async function reportSessionHandoffRetainedStep(e){"use step";log.warn(`session handoff failed; the current owner keeps the session`,{...e,checkpointVersion:SESSION_CHECKPOINT_VERSION})}async function recordSessionOwnerStep(e){"use step";await recordSessionOwner(e.sessionId)}async function recordSessionOwner(e){let{setAttributes:t}=await import(`#compiled/@workflow/core/index.js`);await t({[EVE_SESSION_ATTRIBUTE]:e,[EVE_PREWARM_ATTRIBUTE]:`1`,[EVE_VERSION_ATTRIBUTE]:resolveInstalledPackageInfo().version},{allowReservedAttributes:!0})}async function signalSessionOwnerActivationStep(e){"use step";try{await resumeHook(e.token,e.activation)}catch(e){if(!HookNotFoundError.is(e))throw e}}async function reportSessionTakenOverOutsideAttemptStep(e){"use step";log.error(`session taken over with no handoff attempt open; this run leaves without finalizing`,{sessionId:e.sessionId})}async function reportHandoverPartStuckStep(e){"use step";log.warn(`session handover part keeps failing; the previous owner keeps retrying`,e)}async function sendSessionHandoverPartStep(e){"use step";let t={"eve.handoff.buffered_payload_count":e.bufferedPayloadCount,"eve.handoff.part_index":e.part.index};e.part.index===0&&traceSessionHandover(`forwarding_started`,e.sessionId,e.part.attemptKey,t);try{let n=await resumeHook(sessionInboxHookToken(sessionCommandHookToken(e.sessionId)),{...e.part,kind:`handover`});return traceSessionHandover(e.part.final===!0?`final_submitted`:`part_submitted`,e.sessionId,e.part.attemptKey,{...t,"eve.handoff.destination_run_id":n.runId}),`delivered`}catch(e){if(HookNotFoundError.is(e))return`session-ended`;throw e}}async function signalSessionAnchorStep(e){"use step";await resumeHook(e.token,e.result)}async function readSessionStreamTailStep(e){"use step";return await readSessionStreamTailIndex(e.sessionId)}export{hasRunEndedStep,prepareSuccessorStep,readSessionStreamTailStep,recordSessionOwnerStep,reportHandoverPartStuckStep,reportSessionHandoffRetainedStep,reportSessionTakenOverOutsideAttemptStep,sendSessionHandoverPartStep,signalSessionAnchorStep,signalSessionOwnerActivationStep,startSuccessorStep};
@@ -0,0 +1,2 @@
1
+ import type { ModelMessage } from "ai";
2
+ export declare function normalizeHistory(messages: readonly ModelMessage[]): import("#harness/messages.js").HarnessModelMessage[];
@@ -0,0 +1 @@
1
+ import{isUserMessageKind,validateHarnessModelMessages}from"#harness/messages.js";function normalizeHistory(e){let t=[],n=new Map,settle=()=>{n.size!==0&&(t.push({role:`tool`,content:[...n].map(([e,t])=>({type:`tool-result`,toolCallId:e,toolName:t,output:{type:`error-text`,value:`Interrupted by the session upgrade. Start this work again if it is still needed.`}}))}),n.clear())};for(let r of e){let e=r;if(e.role===`assistant`&&Array.isArray(e.content))e={...e,content:e.content.filter(e=>e.type!==`tool-approval-request`)};else if(e.role===`tool`&&(e={...e,content:e.content.filter(e=>e.type!==`tool-approval-response`)},e.content.length===0))continue;if(e.role!==`tool`&&settle(),e.role===`assistant`&&Array.isArray(e.content))for(let t of e.content)t.type===`tool-call`&&n.set(t.toolCallId,t.toolName);if(e.role===`tool`)for(let t of e.content)t.type===`tool-result`&&n.delete(t.toolCallId);let i=e.kind;t.push(e.role===`user`&&!isUserMessageKind(i)?{...e,kind:`user`}:e)}return settle(),validateHarnessModelMessages(t)}export{normalizeHistory};
@@ -1,3 +1,3 @@
1
- import{createErrorId,createLogger}from"#internal/logging.js";import{eventsOfLine}from"#protocol/session-lines.js";import{currentProjection,saveSessionProjection}from"#harness/session-machine/current.js";import{rowOf}from"#protocol/session-projection/tree.js";import{serializeContext}from"#context/serialize.js";import{createImportedHistoryMessages}from"#harness/messages.js";import{applyTransition,dropClosedRecords,saveTransition,sessionView}from"#harness/session-machine/commit.js";import{fail,receive,stopInterruptedSteps}from"#harness/session-machine/transitions.js";import{controlAdmitted,fact}from"#harness/facts.js";import{activeTurnIdOf}from"#protocol/session-projection.js";import{reconcileSessionContinuationToken}from"#execution/reconcile-session-continuation-token.js";import{supersede}from"#harness/session-machine/cascade.js";import{preserveStoppedTurnMessage}from"#execution/cancelled-model-call-batch.js";import{resolveSessionStepResult}from"#execution/session/turn-step-result.js";import{interruptedAttemptNote}from"#harness/interrupted-attempt.js";import{replaceSessionHistory}from"#harness/compaction/step.js";import{summarizeFailure}from"#execution/failure-summary.js";const log=createLogger(`execution.interrupted-step`);function readInterruptedAttempt(e,t){let n=new Map,r=new Map,i=new Set,a,o=!1,s,call=e=>{let t=n.get(e);return t===void 0&&n.set(e,t={name:``,started:!1}),t};for(let{line:e,position:n}of t)if(`facts`in e)for(let t of eventsOfLine(e,n,e.at))switch(t.type){case`call.requested`:Object.assign(call(t.data.callId),{input:t.data.input,name:t.data.capability.name});break;case`call.started`:call(t.data.callId).started=!0;break;case`call.settled`:call(t.data.callId).outcome=t.data.outcome;break;case`interaction.settled`:i.add(t.data.interactionId);break;case`content.completed`:t.data.kind===`text`&&typeof t.data.value==`string`&&r.set(t.data.partId,t.data.value);break;case`turn.settled`:{let e=(t.data.reply??[]).flatMap(e=>r.get(e)??[]);s={failed:t.data.outcome===`failed`,...e.length>0&&{text:e.join(`
1
+ import{createErrorId,createLogger}from"#internal/logging.js";import{eventsOfLine}from"#protocol/session-lines.js";import{currentProjection,saveSessionProjection}from"#harness/session-machine/current.js";import{rowOf}from"#protocol/session-projection/tree.js";import{serializeContext}from"#context/serialize.js";import{createImportedHistoryMessages}from"#harness/messages.js";import{applyTransition,dropClosedRecords,saveTransition,sessionView}from"#harness/session-machine/commit.js";import{fail,receive,stopInterruptedSteps}from"#harness/session-machine/transitions.js";import{activeTurnIdOf}from"#protocol/session-projection.js";import{controlAdmitted,fact}from"#harness/facts.js";import{reconcileSessionContinuationToken}from"#execution/reconcile-session-continuation-token.js";import{supersede}from"#harness/session-machine/cascade.js";import{preserveStoppedTurnMessage}from"#execution/cancelled-model-call-batch.js";import{resolveSessionStepResult}from"#execution/session/turn-step-result.js";import{interruptedAttemptNote}from"#harness/interrupted-attempt.js";import{replaceSessionHistory}from"#harness/compaction/step.js";import{summarizeFailure}from"#execution/failure-summary.js";const log=createLogger(`execution.interrupted-step`);function readInterruptedAttempt(e,t){let n=new Map,r=new Map,i=new Set,a,o=!1,s,call=e=>{let t=n.get(e);return t===void 0&&n.set(e,t={name:``,started:!1}),t};for(let{line:e,position:n}of t)if(`facts`in e)for(let t of eventsOfLine(e,n,e.at))switch(t.type){case`call.requested`:Object.assign(call(t.data.callId),{input:t.data.input,name:t.data.capability.name});break;case`call.started`:call(t.data.callId).started=!0;break;case`call.settled`:call(t.data.callId).outcome=t.data.outcome;break;case`interaction.settled`:i.add(t.data.interactionId);break;case`content.completed`:t.data.kind===`text`&&typeof t.data.value==`string`&&r.set(t.data.partId,t.data.value);break;case`turn.settled`:{let e=(t.data.reply??[]).flatMap(e=>r.get(e)??[]);s={failed:t.data.outcome===`failed`,...e.length>0&&{text:e.join(`
2
2
 
3
3
  `)}};break}case`session.ended`:a=t.data.outcome;break;case`context.settled`:t.data.kind===`clear`&&t.data.outcome===`completed`&&(o=!0)}return{calls:n,cleared:o,sessionEnded:a,settledInteractions:i,settledTurn:s,since:e}}async function recoverInterruptedStep(e){let{attempt:t,ctx:n}=e,r=e.session,publish=async t=>{r=await e.publish(t,r)},view=()=>sessionView(currentProjection(n),r.state),closeAttempt=async e=>{let t=currentProjection(n).view,r=supersede(t,n=>{let r=rowOf(t,n.family,n.id);return r!==void 0&&e(n,r)},`step-interrupted`);r.length>0&&await publish(r)},introduced=e=>e.introducedAt>=t.since,finish=e=>{let t=saveSessionProjection(dropClosedRecords(reconcileSessionContinuationToken(n,e.session),currentProjection(n)),n);return{result:resolveSessionStepResult({...e,session:t},serializeContext(n))}};if(t.sessionEnded!==void 0)return finish({next:{done:!0,isError:t.sessionEnded===`failed`,output:t.settledTurn?.text??``},session:r});if(e.control!==void 0){if(await closeAttempt(({family:e},t)=>(e===`run`||e===`change`)&&introduced(t)),t.cleared){let e=saveTransition(r,{clearsHistory:!0,events:[],signIns:[],turn:{remembered:view().turn.remembered,suspended:[]}});r=replaceSessionHistory(e,[])}let{delivery:i,kind:a}=e.control,o=i===void 0?void 0:currentProjection(n).view.deliveries[i.deliveryId]?.status;return i!==void 0&&o!==`settled`&&await publish([...o===void 0?[controlAdmitted(i,a)]:[],fact(`delivery.settled`,{deliveryId:i.deliveryId,outcome:`failed`,reason:`${a}-interrupted`})]),finish({next:null,session:r})}let{settledTurn:i}=t;if(i!==void 0&&activeTurnIdOf(currentProjection(n))===void 0)return r={...r,history:[...r.history,...createImportedHistoryMessages(e.stepInput?.history??[])]},r=await preserveStoppedTurnMessage(n,r,e.stepInput),i.text!==void 0&&(r={...r,history:[...r.history,{content:i.text,role:`assistant`}]}),finish({next:null,session:r,settledTurn:{isError:i.failed,output:i.text??``}});let a=stopInterruptedSteps(view(),t),o=new Set(view().turn.suspended.filter(e=>!a.turn.suspended.includes(e)).flatMap(e=>e.requests.map(e=>e.interactionId)));await closeAttempt(({family:e,id:n},r)=>{switch(e){case`run`:case`change`:return introduced(r);case`call`:return r.taskId===void 0&&(introduced(r)||t.calls.get(n)?.started===!0);case`interaction`:return!view().relayedRequestIds.has(n)&&(introduced(r)||o.has(n));default:return!1}});let s=activeTurnIdOf(currentProjection(n)),c=s===void 0?0:turnInterruptions(r.state,s)+1;r=saveTransition(r,a);let l=interruptedAttemptNote(t.calls);if(l!==void 0&&(r={...r,history:[...r.history,l]}),e.failed===void 0&&c<=3){let{settledInteractions:n}=t,i=e.stepInput?.answers?.filter(e=>!n.has(e.interactionId));return{session:s===void 0?r:withTurnInterruptions(r,s,c),stepInput:e.stepInput===void 0?void 0:{...e.stepInput,answers:i}}}e.admission.length>0&&await publish(e.admission);let u=(e.stepInput?.deliveries??[]).filter(({deliveryId:e})=>currentProjection(n).view.deliveries[e]?.status===`admitted`);u.length>0&&await publish(receive(view(),{deliveries:u}).events);let d=activeTurnIdOf(currentProjection(n));if(d===void 0)return finish({next:null,session:r});r=await preserveStoppedTurnMessage(n,r,e.stepInput);let f=e.failed===void 0?{code:`STEP_INTERRUPTED`,details:{errorId:createErrorId()},message:`This turn was interrupted too many times to continue.`}:summarizeFailure(e.failed.error,`STEP_FAILED`);return log.error(`turn failed`,{code:f.code,errorId:f.details.errorId,sessionId:r.sessionId,turnId:d}),r=await applyTransition(r,fail(view(),f),publish),finish({next:null,session:r,settledTurn:{isError:!0,output:f.message}})}const INTERRUPTIONS_STATE_KEY=`eve.turn-interruptions`,MAX_TURN_INTERRUPTIONS=3;function turnInterruptions(e,t){let n=e?.[INTERRUPTIONS_STATE_KEY];return n?.turnId===t?n.count:0}function withTurnInterruptions(e,t,n){return{...e,state:{...e.state,[INTERRUPTIONS_STATE_KEY]:{count:n,turnId:t}}}}export{MAX_TURN_INTERRUPTIONS,readInterruptedAttempt,recoverInterruptedStep};
@@ -0,0 +1,36 @@
1
+ import { type SessionCheckpoint } from "#execution/session/handoff.js";
2
+ import { type SessionProjection } from "#protocol/session-projection.js";
3
+ export interface PreV27Checkpoint<C = SessionCheckpoint> {
4
+ /** The checkpoint in v27's shape, without its session projection. */
5
+ readonly checkpoint: C;
6
+ /** Turns the earlier owner numbered: the next turn takes the next number. */
7
+ readonly turnCount: number;
8
+ }
9
+ export type PreV27CheckpointImport =
10
+ /** Its checkpoint still unchecked against the current shape. */
11
+ {
12
+ readonly kind: "pre-v27";
13
+ readonly imported: PreV27Checkpoint<Record<string, unknown>>;
14
+ }
15
+ /** Work the earlier owner runs will finish; a later delivery can move the session. */
16
+ | {
17
+ readonly kind: "busy";
18
+ readonly detail: string;
19
+ } | {
20
+ readonly kind: "incompatible";
21
+ readonly detail: string;
22
+ };
23
+ export declare function isPreV27CheckpointVersion(version: unknown): version is number;
24
+ /**
25
+ * Reads a pre-v27 checkpoint in v27's shape. Pure, so the session workflow can run it before
26
+ * validation. The earlier owner only hands off an idle session; a task it still tracks keeps the
27
+ * session on that owner.
28
+ */
29
+ export declare function importPreV27Checkpoint(checkpoint: Readonly<Record<string, unknown>>): PreV27CheckpointImport;
30
+ /**
31
+ * The projection of a session whose earlier lines a v27 writer never folded: it writes after
32
+ * `tailIndex`, and its next turn follows the earlier owner's last. An empty stream has not opened.
33
+ */
34
+ export declare function preV27Projection(tailIndex: number, turnCount: number): SessionProjection;
35
+ /** The imported checkpoint with its session projection. */
36
+ export declare function withProjection(checkpoint: SessionCheckpoint, projection: SessionProjection): SessionCheckpoint;
@@ -0,0 +1 @@
1
+ import{isObject}from"#shared/guards.js";import{EARLIER_REMOTE_CALLER_CONTEXT_KEY_NAME,SESSION_CALLBACK_CONTEXT_KEY_NAME}from"#context/key-names.js";import{SESSION_PROJECTION_STATE_KEY}from"#harness/session-machine/view.js";import{DURABLE_SESSION_VERSION}from"#execution/durable-session-read.js";import{initialSessionProjection}from"#protocol/session-projection.js";import{normalizeHistory}from"#execution/session/imported-conversation.js";import{SESSION_CHECKPOINT_VERSION}from"#execution/session/handoff.js";import{CheckpointRefusal,refuse}from"#execution/session/checkpoint-refusal.js";function isPreV27CheckpointVersion(e){return typeof e==`number`&&Number.isSafeInteger(e)&&e>=10&&e<=17}function importPreV27Checkpoint(e){try{return{kind:`pre-v27`,imported:importCheckpoint(e)}}catch(t){if(!(t instanceof CheckpointRefusal)&&!(t instanceof SessionBusy))throw t;return{kind:t instanceof SessionBusy?`busy`:`incompatible`,detail:`checkpoint version ${String(e.version)}: ${t.message}`}}}function preV27Projection(e,t){let n=initialSessionProjection();return{...n,view:{...n.view,position:e+1,session:{status:e<0?`new`:`open`,turnCount:t,...t>0&&{latestTurnId:`turn_${String(t-1)}`}}}}}function withProjection(e,t){let{sessionState:n}=e,{session:r}=n.snapshot;return{...e,sessionState:{...n,snapshot:{...n.snapshot,session:{...r,state:{...r.state,[SESSION_PROJECTION_STATE_KEY]:t}}}}}}function importCheckpoint(e){let t=readRecord(e,`sessionState`),n=readRecord(readRecord(t,`snapshot`),`session`);typeof t.sessionId!=`string`&&refuse(`session id is missing`);let r=n.state===void 0?{}:readRecord(n,`state`),i=readTurnCount(t,r);if(holdsRunningTask(r[`eve.taskTable`]))throw new SessionBusy(`session holds a running task`);let a=Array.isArray(e.history)?e.history:n.history;Array.isArray(a)||refuse(`session history is missing`);let o=readRecord(e,`serializedContext`),s=o[SESSION_CALLBACK_CONTEXT_KEY_NAME],c=isObject(s)?o[`eve.legacyRemoteAgentCaller`]===void 0?2:1:void 0;return{checkpoint:{admittedDeliveryKeys:Array.isArray(e.admittedDeliveryKeys)?e.admittedDeliveryKeys:[],...c===void 0?e.capabilities!==void 0&&{capabilities:e.capabilities}:{capabilities:{requestInput:!1}},history:importHistory(a),...e.retention!==void 0&&{retention:e.retention},serializedContext:c===void 0?o:{...o,"eve.capabilities":{requestInput:!1},[EARLIER_REMOTE_CALLER_CONTEXT_KEY_NAME]:c},sessionState:{continuationToken:t.continuationToken,hasProxyInputRequests:!1,sessionId:t.sessionId,snapshot:{session:{agent:isObject(n.agent)?n.agent:{system:``},continuationToken:n.continuationToken,sessionId:n.sessionId,...pick(n,[`outputSchema`,`rootSessionId`,`sandboxState`]),state:Object.fromEntries(Object.entries(r).filter(([e])=>!e.startsWith(`eve.`)))}},version:DURABLE_SESSION_VERSION},sessionTimeoutMs:e.sessionTimeoutMs,version:SESSION_CHECKPOINT_VERSION},turnCount:i}}function readTurnCount(e,t){let n=t[SESSION_PROJECTION_STATE_KEY];if(isObject(n))return n.activeTurnId!==void 0&&refuse(`a turn is still open`),readCount(n.nextSequence);let r=t[`eve.harness.emission`]??e.emissionState;return isObject(r)||refuse(`the session's turn position is missing`),r.turnId!==``&&refuse(`a turn is still open`),readCount(r.sequence)}function readCount(e){return(typeof e!=`number`||!Number.isSafeInteger(e)||e<0)&&refuse(`the session's turn position is malformed`),e}function holdsRunningTask(e){return e!==void 0&&((!isObject(e)||!Array.isArray(e.tasks))&&refuse(`task table is malformed`),e.tasks.some(e=>!isObject(e)||e.run!==void 0||Array.isArray(e.held)&&e.held.length>0||Array.isArray(e.calls)&&e.calls.length>0))}var SessionBusy=class extends Error{};function importHistory(e){try{return normalizeHistory(e)}catch(e){refuse(`session history is malformed: ${e instanceof Error?e.message:`unknown`}`)}}function pick(e,t){return Object.fromEntries(t.flatMap(t=>e[t]===void 0?[]:[[t,e[t]]]))}function readRecord(e,t){let n=e[t];return isObject(n)||refuse(`${t} is not an object`),n}export{importPreV27Checkpoint,isPreV27CheckpointVersion,preV27Projection,withProjection};
@@ -12,3 +12,11 @@ export declare function principalOf(auth: SessionAuthContext | null | undefined)
12
12
  * without auth keeps the session's current identity, as the turn step does.
13
13
  */
14
14
  export declare function resolveTurnPrincipal(payload: TurnStepPayload | undefined, serializedContext: Record<string, unknown>): string;
15
+ /**
16
+ * The identity a running turn continues under once a message sent as `auth`
17
+ * joins it. Within a turn the principal is fixed and only its claims may
18
+ * update, so only the turn's own principal may join it; input without auth
19
+ * acts as the turn's identity. Anyone else's answers settle requests as their
20
+ * responder without joining the turn.
21
+ */
22
+ export declare function continueTurnAuth<T extends SessionAuthContext | null | undefined>(turnAuth: T, auth: SessionAuthContext | null | undefined): T | SessionAuthContext | null;
@@ -1 +1 @@
1
- import{AuthKey}from"#context/keys.js";const ANONYMOUS_PRINCIPAL=`anonymous`;function principalOf(e){return e==null||e.principalType===`anonymous`?ANONYMOUS_PRINCIPAL:JSON.stringify([e.authenticator,e.issuer??null,e.principalType,e.principalId])}function resolveTurnPrincipal(e,t){let n=e?.delivery?.auth;return principalOf(n===void 0?t[AuthKey.name]:n)}export{ANONYMOUS_PRINCIPAL,principalOf,resolveTurnPrincipal};
1
+ import{AuthKey}from"#context/keys.js";const ANONYMOUS_PRINCIPAL=`anonymous`;function principalOf(e){return e==null||e.principalType===`anonymous`?ANONYMOUS_PRINCIPAL:JSON.stringify([e.authenticator,e.issuer??null,e.principalType,e.principalId])}function resolveTurnPrincipal(e,t){let n=e?.delivery?.auth;return principalOf(n===void 0?t[AuthKey.name]:n)}function continueTurnAuth(e,t){if(t===void 0)return e;if(principalOf(t)!==principalOf(e))throw Error(`A message from another principal cannot join a running turn. Gate it with isSteeringDelivery so it waits for the turn to end.`);return t}export{ANONYMOUS_PRINCIPAL,continueTurnAuth,principalOf,resolveTurnPrincipal};