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
@@ -41,6 +41,8 @@ export interface SessionBoot {
41
41
  readonly anchor: SessionAnchor;
42
42
  readonly caller: TurnCaller | undefined;
43
43
  readonly capabilities?: SessionCapabilities;
44
+ /** Compacts the history before the first action, for a session an earlier build recorded. */
45
+ readonly compactFirst?: boolean;
44
46
  readonly deploymentId: string;
45
47
  readonly history: HarnessModelMessage[];
46
48
  readonly initialTurnControl?: TurnControl;
@@ -1 +1 @@
1
- import{STUB_CONTEXT_KEY}from"#tool-stubs/types.js";import{storedProjection}from"#harness/session-machine/view.js";import{workingTasks}from"#execution/tasks/table.js";import{settleCancelledTurnStep}from"#execution/settle-cancelled-turn-step.js";import{turnCoordinates}from"#protocol/session-projection.js";import"#execution/session-inbox/inbox.js";import{signalSessionAnchorStep}from"#execution/session/handoff-steps.js";import{controlDeliveryOf}from"#execution/session/control-delivery.js";import{settleControlDeliveryStep}from"#execution/session/settle-control-delivery-step.js";import{SessionInputQueue}from"#execution/session/input-queue.js";import{createTurnControl}from"#execution/session/turn-control.js";import{SessionHandoff,sessionAnchorToken}from"#execution/session/handoff.js";import{notifyCancelledTaskCallerStep,notifyTurnCallerStep,resolveInitialTurnCallerStep}from"#subagents/parent-notification.js";import{withStubPlayback}from"#execution/tool-stubs/playback.js";import{nextTurnDelivery}from"#execution/session/next-input.js";import{SessionExecution}from"#execution/session/turn.js";import{SessionStateCursor}from"#execution/session/state-cursor.js";import{cancelWorkingTasks,sessionTaskTable}from"#execution/tasks/session.js";import{finalizeSession}from"#execution/session/finalization.js";import{prewarmSessionStep}from"#execution/session/prewarm-step.js";function createSafeOuterWorkflowError(){let e=Error(`Agent workflow failed. Inspect the private session trace for details.`);return e.name=`EveWorkflowFailure`,e}async function runPreparedSession(e,t){let n=e.serializedContext[STUB_CONTEXT_KEY];n!==void 0&&n.rootSessionId===void 0&&(e.serializedContext[STUB_CONTEXT_KEY]={...n,rootSessionId:e.sessionId});let r=new SessionStateCursor({history:e.history,inbox:t,sessionWritable:e.sessionWritable,serializedContext:e.serializedContext,sessionState:e.sessionState}),i={caller:e.caller},a=new SessionHandoff({checkpoint:{capabilities:e.capabilities,retention:e.retention,sessionTimeoutMs:e.sessionTimeoutMs},deploymentId:e.deploymentId,inbox:t,isInitialOwner:e.anchor.kind===`self`,sessionId:e.sessionId,sessionWritable:e.sessionWritable}),o={output:``,isError:!0},s,c=!1;try{return o=await withStubPlayback(n,e.sessionId,async()=>{try{s=await runSessionLoop(e,{cursor:r,handoff:a,inbox:t,progress:i})}finally{await t.dispose()}return s.kind===`transferred`?e.anchor.kind===`self`?(o=await a.awaitAnchoredResult(),o):{output:``}:(c=!0,o=await finalizeSession(s.outcome,{caller:i.caller,cursor:r,sessionWritable:e.sessionWritable}),o)}),o}catch(t){throw c||await finalizeSession({error:t,kind:`failed`,turnId:i.turnId},{caller:i.caller,cursor:r,sessionWritable:e.sessionWritable}),createSafeOuterWorkflowError()}finally{await t.dispose(),await reportResultToAnchor(e,o,a,s)}}async function failSession(e){let t;try{t=await resolveInitialTurnCallerStep({serializedContext:e.serializedContext})}catch{}throw await finalizeSession({error:e.error,kind:`failed`},{caller:t,cursor:{serializedContext:e.serializedContext,sessionState:e.sessionState},sessionWritable:e.sessionWritable}),createSafeOuterWorkflowError()}async function reportResultToAnchor(e,t,n,r){switch(e.anchor.kind){case`self`:await n.disposeAnchor(),await e.anchor.notify?.(t);return;case`successor`:if(r?.kind===`transferred`)return;await signalSessionAnchorStep({result:t,token:sessionAnchorToken(e.sessionId)});return}}async function runSessionLoop(e,t){let{cursor:n,handoff:r,inbox:i,progress:a}=t,o=new SessionInputQueue(e.admittedDeliveryKeys),s=new SessionExecution({capabilities:e.capabilities,cursor:n,inbox:i,queue:o,sessionId:e.sessionId}),c=e.sessionTimeoutControl,l=Promise.resolve(),u=!0,d=!1,f=[],started=()=>storedProjection(n.sessionState.snapshot.session.state).view.session.status!==`new`,ignore=async e=>{if(!started()){f.push(e);return}await n.advance(t=>settleControlDeliveryStep({...t,settlement:e}))},settleUnstarted=async()=>{if(started())for(let e of f.splice(0))await n.advance(t=>settleControlDeliveryStep({...t,settlement:e}))},expired=e=>({kind:`expired`,...e&&{control:e},...f.length>0&&{settles:f.splice(0)}}),nextParkedActivity=async()=>{for(;;){let e=await nextTurnDelivery({cursor:n,hasWorkingTasks:()=>workingTasks(sessionTaskTable(n)).length>0,ignore,inbox:i,queue:o});if(e.kind===`prewarm`){if(u&&a.caller===void 0&&workingTasks(sessionTaskTable(n)).length===0&&o.pendingCount===0&&!i.hasPending()){let t=c?.getDeadline(),n=await r.tryPrewarmTransfer(transferState(),e.targetDeploymentId,t);if(n.kind===`transferred`)return n}continue}if(e.kind===`workflow`){await s.handleWorkflowMessage(e.message);continue}if(e.kind===`cancel-working-tasks`){if(await cancelWorkingTasks(n,`turn-cancelled`),e.origin!==void 0){let t=controlDeliveryOf(e.origin);await n.advance(e=>settleControlDeliveryStep({...e,settlement:{control:t,outcome:`applied`,source:`cancel`}}))}continue}if(!(e.kind===`expired`&&c!==void 0&&((o.pendingCount>0||i.hasPending())&&c.recordActivity(),await c.handleTimerElapsed()===`extended`)))return e}},p=e.initialTurnControl??(e.anchor.kind===`self`?createTurnControl():void 0),m=!1,runTurn=async e=>{let t=a.caller,r=p;p=void 0,a.turnId=e?.control===void 0?turnCoordinates(storedProjection(n.sessionState.snapshot.session.state)).turnId:void 0;let i=await s.runTurn(e,{caller:t,control:r});return a.turnId=void 0,c?.recordActivity(),i.caller!==void 0&&(a.caller=i.caller),i.compacted===!0&&(m=!0),i},transferState=()=>({admittedDeliveryKeys:o.admittedDeliveryKeys,history:n.history,serializedContext:n.serializedContext,sessionState:n.sessionState}),compactionHandoffReady=()=>m&&a.caller===void 0&&workingTasks(sessionTaskTable(n)).length===0,tryCompactionHandoff=async()=>{if(!compactionHandoffReady()||o.pendingCount>0||i.hasPending())return;let e=await r.tryCompactionTransfer(transferState());return e.kind===`transferred`?e:void 0},runDeliveredTurn=async e=>{let t=await r.tryTransfer(e,transferState());return t.kind===`transferred`?t:(e.delivery.caller!==void 0&&(a.caller=e.delivery.caller),{action:await runTurn({delivery:e.delivery}),kind:`action`})},settleCancelledTurn=async(e,t)=>{let r=await n.advanceWithHistory(n=>settleCancelledTurnStep({...n,control:t,reportUsage:e}));return a.caller=void 0,r},awaitPrewarmedAction=async()=>{for(;;){let e=await nextParkedActivity();switch(d=!1,e.kind){case`reset`:return{kind:`terminal`,outcome:expired(e.origin&&controlDeliveryOf(e.origin))};case`closed`:return i.takenOver?await r.adoptTakeover():{kind:`terminal`,outcome:expired()};case`transferred`:return e;case`expired`:return{kind:`terminal`,outcome:expired()};case`clear`:case`compact`:e.origin!==void 0&&await ignore({control:controlDeliveryOf(e.origin),outcome:`ignored`,source:e.kind});continue;case`turn`:return await runDeliveredTurn(e);case`cancel-turn`:continue}}},runInitialAction=async()=>{switch(e.start.kind){case`first-message`:return d=!0,u=!1,l=n.advanceBeside(({serializedContext:e,sessionState:t})=>prewarmSessionStep({serializedContext:e,sessionState:t}),()=>d).then(()=>void 0,()=>void 0).finally(()=>{u=!0}),await awaitPrewarmedAction();case`parked`:return{action:{kind:`park`},kind:`action`};case`turn`:{let{input:t}=e.start;return{action:await runTurn(t===void 0?void 0:{delivery:t}),kind:`action`}}}};try{let[t,n]=await Promise.allSettled([runInitialAction(),c?.start()]);if(n.status===`rejected`)throw n.reason;if(t.status===`rejected`)throw t.reason;let o=t.value;if(o.kind!==`action`)return o;let l=o.action;for(;;){if(l.kind===`done`)return{kind:`terminal`,outcome:{action:l,kind:`done`}};if(await settleUnstarted(),l.cancelled===!0){let{caller:t}=a,n=await settleCancelledTurn(t!==void 0,l.cancelledBy);if(t!==void 0){let r={caller:t,sessionId:e.sessionId};await notifyCancelledTaskCallerStep(n.usage===void 0?r:{...r,usage:n.usage})}}else l.settled!==void 0&&(a.caller!==void 0&&await notifyTurnCallerStep({caller:a.caller,lifecycle:`parked`,sessionId:e.sessionId,settled:l.settled}),a.caller=void 0);let t=await tryCompactionHandoff();if(t!==void 0)return t;p??=createTurnControl();let n=await nextParkedActivity();switch(n.kind){case`reset`:return{kind:`terminal`,outcome:resetOutcome(n.origin)};case`closed`:return i.takenOver?await r.adoptTakeover():{kind:`terminal`,outcome:{kind:`expired`}};case`transferred`:return n;case`expired`:return{kind:`terminal`,outcome:{kind:`expired`}};case`clear`:case`compact`:l=await runTurn(n.origin===void 0?{control:n.kind}:{control:n.kind,controlDelivery:controlDeliveryOf(n.origin)});continue;case`cancel-turn`:await s.cancelTurnWork(),await settleCancelledTurn(!1,n.origin===void 0?void 0:controlDeliveryOf(n.origin)),c?.recordActivity(),l={...l,settled:void 0};continue;case`turn`:{let e=await runDeliveredTurn(n);if(e.kind!==`action`)return e;l=e.action;continue}}}}finally{d=!1,await l,await c?.dispose()}}function resetOutcome(e){return e===void 0?{kind:`expired`}:{control:controlDeliveryOf(e),kind:`expired`}}export{failSession,runPreparedSession};
1
+ import{STUB_CONTEXT_KEY}from"#tool-stubs/types.js";import{storedProjection}from"#harness/session-machine/view.js";import{workingTasks}from"#execution/tasks/table.js";import{settleCancelledTurnStep}from"#execution/settle-cancelled-turn-step.js";import{turnCoordinates}from"#protocol/session-projection.js";import"#execution/session-inbox/inbox.js";import{signalSessionAnchorStep}from"#execution/session/handoff-steps.js";import{SessionInputQueue}from"#execution/session/input-queue.js";import{controlDeliveryOf}from"#execution/session/control-delivery.js";import{settleControlDeliveryStep}from"#execution/session/settle-control-delivery-step.js";import{createTurnControl}from"#execution/session/turn-control.js";import{SessionHandoff,sessionAnchorToken}from"#execution/session/handoff.js";import{notifyCancelledTaskCallerStep,notifyTurnCallerStep,resolveInitialTurnCallerStep}from"#subagents/parent-notification.js";import{withStubPlayback}from"#execution/tool-stubs/playback.js";import{nextTurnDelivery}from"#execution/session/next-input.js";import{SessionExecution}from"#execution/session/turn.js";import{SessionStateCursor}from"#execution/session/state-cursor.js";import{cancelWorkingTasks,sessionTaskTable}from"#execution/tasks/session.js";import{finalizeSession}from"#execution/session/finalization.js";import{prewarmSessionStep}from"#execution/session/prewarm-step.js";function createSafeOuterWorkflowError(){let e=Error(`Agent workflow failed. Inspect the private session trace for details.`);return e.name=`EveWorkflowFailure`,e}async function runPreparedSession(e,t){let n=e.serializedContext[STUB_CONTEXT_KEY];n!==void 0&&n.rootSessionId===void 0&&(e.serializedContext[STUB_CONTEXT_KEY]={...n,rootSessionId:e.sessionId});let r=new SessionStateCursor({history:e.history,inbox:t,sessionWritable:e.sessionWritable,serializedContext:e.serializedContext,sessionState:e.sessionState}),i={caller:e.caller},a=new SessionHandoff({checkpoint:{capabilities:e.capabilities,retention:e.retention,sessionTimeoutMs:e.sessionTimeoutMs},deploymentId:e.deploymentId,inbox:t,isInitialOwner:e.anchor.kind===`self`,sessionId:e.sessionId,sessionWritable:e.sessionWritable}),o={output:``,isError:!0},s,c=!1;try{return o=await withStubPlayback(n,e.sessionId,async()=>{try{s=await runSessionLoop(e,{cursor:r,handoff:a,inbox:t,progress:i})}finally{await t.dispose()}return s.kind===`transferred`?e.anchor.kind===`self`?(o=await a.awaitAnchoredResult(),o):{output:``}:(c=!0,o=await finalizeSession(s.outcome,{caller:i.caller,cursor:r,sessionWritable:e.sessionWritable}),o)}),o}catch(t){throw c||await finalizeSession({error:t,kind:`failed`,turnId:i.turnId},{caller:i.caller,cursor:r,sessionWritable:e.sessionWritable}),createSafeOuterWorkflowError()}finally{await t.dispose(),await reportResultToAnchor(e,o,a,s)}}async function failSession(e){let t;try{t=await resolveInitialTurnCallerStep({serializedContext:e.serializedContext})}catch{}throw await finalizeSession({error:e.error,kind:`failed`},{caller:t,cursor:{serializedContext:e.serializedContext,sessionState:e.sessionState},sessionWritable:e.sessionWritable}),createSafeOuterWorkflowError()}async function reportResultToAnchor(e,t,n,r){switch(e.anchor.kind){case`self`:await n.disposeAnchor(),await e.anchor.notify?.(t);return;case`successor`:if(r?.kind===`transferred`)return;await signalSessionAnchorStep({result:t,token:sessionAnchorToken(e.sessionId)});return}}async function runSessionLoop(e,t){let{cursor:n,handoff:r,inbox:i,progress:a}=t,o=new SessionInputQueue(e.admittedDeliveryKeys),s=new SessionExecution({capabilities:e.capabilities,cursor:n,inbox:i,queue:o,sessionId:e.sessionId}),c=e.sessionTimeoutControl,l=Promise.resolve(),u=!0,d=!1,f=[],started=()=>storedProjection(n.sessionState.snapshot.session.state).view.session.status!==`new`,ignore=async e=>{if(!started()){f.push(e);return}await n.advance(t=>settleControlDeliveryStep({...t,settlement:e}))},settleUnstarted=async()=>{if(started())for(let e of f.splice(0))await n.advance(t=>settleControlDeliveryStep({...t,settlement:e}))},expired=e=>({kind:`expired`,...e&&{control:e},...f.length>0&&{settles:f.splice(0)}}),nextParkedActivity=async()=>{for(;;){let e=await nextTurnDelivery({cursor:n,hasWorkingTasks:()=>workingTasks(sessionTaskTable(n)).length>0,ignore,inbox:i,queue:o});if(e.kind===`prewarm`){if(u&&a.caller===void 0&&workingTasks(sessionTaskTable(n)).length===0&&o.pendingCount===0&&!i.hasPending()){let t=c?.getDeadline(),n=await r.tryPrewarmTransfer(transferState(),e.targetDeploymentId,t);if(n.kind===`transferred`)return n}continue}if(e.kind===`workflow`){await s.handleWorkflowMessage(e.message);continue}if(e.kind===`cancel-working-tasks`){if(await cancelWorkingTasks(n,`turn-cancelled`),e.origin!==void 0){let t=controlDeliveryOf(e.origin);await n.advance(e=>settleControlDeliveryStep({...e,settlement:{control:t,outcome:`applied`,source:`cancel`}}))}continue}if(!(e.kind===`expired`&&c!==void 0&&((o.pendingCount>0||i.hasPending())&&c.recordActivity(),await c.handleTimerElapsed()===`extended`)))return e}},p=e.initialTurnControl??(e.anchor.kind===`self`?createTurnControl():void 0),m=!1,runTurn=async e=>{let t=a.caller,r=p;p=void 0,a.turnId=e?.control===void 0?turnCoordinates(storedProjection(n.sessionState.snapshot.session.state)).turnId:void 0;let i=await s.runTurn(e,{caller:t,control:r});return a.turnId=void 0,c?.recordActivity(),i.caller!==void 0&&(a.caller=i.caller),i.compacted===!0&&(m=!0),i},transferState=()=>({admittedDeliveryKeys:o.admittedDeliveryKeys,history:n.history,serializedContext:n.serializedContext,sessionState:n.sessionState}),compactionHandoffReady=()=>m&&a.caller===void 0&&workingTasks(sessionTaskTable(n)).length===0,tryCompactionHandoff=async()=>{if(!compactionHandoffReady()||o.pendingCount>0||i.hasPending())return;let e=await r.tryCompactionTransfer(transferState());return e.kind===`transferred`?e:void 0},runDeliveredTurn=async e=>{let t=await r.tryTransfer(e,transferState());return t.kind===`transferred`?t:(e.delivery.caller!==void 0&&(a.caller=e.delivery.caller),{action:await runTurn({delivery:e.delivery}),kind:`action`})},settleCancelledTurn=async(e,t)=>{let r=await n.advanceWithHistory(n=>settleCancelledTurnStep({...n,control:t,reportUsage:e}));return a.caller=void 0,r},awaitPrewarmedAction=async()=>{for(;;){let e=await nextParkedActivity();switch(d=!1,e.kind){case`reset`:return{kind:`terminal`,outcome:expired(e.origin&&controlDeliveryOf(e.origin))};case`closed`:return i.takenOver?await r.adoptTakeover():{kind:`terminal`,outcome:expired()};case`transferred`:return e;case`expired`:return{kind:`terminal`,outcome:expired()};case`clear`:case`compact`:e.origin!==void 0&&await ignore({control:controlDeliveryOf(e.origin),outcome:`ignored`,source:e.kind});continue;case`turn`:return await runDeliveredTurn(e);case`cancel-turn`:continue}}},runInitialAction=async()=>{switch(e.compactFirst===!0&&(await runTurn({control:`compact`}),m=!1),e.start.kind){case`first-message`:return d=!0,u=!1,l=n.advanceBeside(({serializedContext:e,sessionState:t})=>prewarmSessionStep({serializedContext:e,sessionState:t}),()=>d).then(()=>void 0,()=>void 0).finally(()=>{u=!0}),await awaitPrewarmedAction();case`parked`:return{action:{kind:`park`},kind:`action`};case`turn`:{let{input:t}=e.start;return{action:await runTurn(t===void 0?void 0:{delivery:t}),kind:`action`}}}};try{let[t,n]=await Promise.allSettled([runInitialAction(),c?.start()]);if(n.status===`rejected`)throw n.reason;if(t.status===`rejected`)throw t.reason;let o=t.value;if(o.kind!==`action`)return o;let l=o.action;for(;;){if(l.kind===`done`)return{kind:`terminal`,outcome:{action:l,kind:`done`}};if(await settleUnstarted(),l.cancelled===!0){let{caller:t}=a,n=await settleCancelledTurn(t!==void 0,l.cancelledBy);if(t!==void 0){let r={caller:t,sessionId:e.sessionId};await notifyCancelledTaskCallerStep(n.usage===void 0?r:{...r,usage:n.usage})}}else l.settled!==void 0&&(a.caller!==void 0&&await notifyTurnCallerStep({caller:a.caller,lifecycle:`parked`,sessionId:e.sessionId,settled:l.settled}),a.caller=void 0);let t=await tryCompactionHandoff();if(t!==void 0)return t;p??=createTurnControl();let n=await nextParkedActivity();switch(n.kind){case`reset`:return{kind:`terminal`,outcome:resetOutcome(n.origin)};case`closed`:return i.takenOver?await r.adoptTakeover():{kind:`terminal`,outcome:{kind:`expired`}};case`transferred`:return n;case`expired`:return{kind:`terminal`,outcome:{kind:`expired`}};case`clear`:case`compact`:l=await runTurn(n.origin===void 0?{control:n.kind}:{control:n.kind,controlDelivery:controlDeliveryOf(n.origin)});continue;case`cancel-turn`:await s.cancelTurnWork(),await settleCancelledTurn(!1,n.origin===void 0?void 0:controlDeliveryOf(n.origin)),c?.recordActivity(),l={...l,settled:void 0};continue;case`turn`:{let e=await runDeliveredTurn(n);if(e.kind!==`action`)return e;l=e.action;continue}}}}finally{d=!1,await l,await c?.dispose()}}function resetOutcome(e){return e===void 0?{kind:`expired`}:{control:controlDeliveryOf(e),kind:`expired`}}export{failSession,runPreparedSession};
@@ -1 +1 @@
1
- import{createLogger}from"#internal/logging.js";import{resolveRuntimeCompiledArtifactsVersionedCacheKey}from"#runtime/cache-key.js";import{defaultDeliverResult,getAdapterKind}from"#channel/adapter.js";import{contextStorage}from"#context/container.js";import{AuthKey,CapabilitiesKey,ChannelDeliveryKey,ChannelInstrumentationKey,HandleEventKey,InitiatorAuthKey,OccurrenceIdKey,ParentSessionKey,SandboxKey,ScheduleIdKey,ScheduleInstanceKey,SessionKey,SessionPredecessorKey,SessionTitleKey,StaticModelReferenceKey,TurnDeliveryIdsKey}from"#context/keys.js";import{bindMemoryInstrumentation}from"#reactions/kinds/memory.js";import{BundleKey,ChannelKey}from"#runtime/sessions/runtime-context-keys.js";import{sandboxProvider}from"#context/providers/sandbox.js";import{isBetweenTurns,storedProjection,turnPosition}from"#harness/session-machine/view.js";import{currentProjection,enterSessionProjection,enterSessionProjectionAt,nextLinePosition,recordAppliedSession,saveSessionProjection}from"#harness/session-machine/current.js";import{ConnectionRegistryKey,connectionProvider}from"#context/providers/connection.js";import{sessionProvider}from"#context/providers/session.js";import{createWorkflowRuntime}from"#execution/workflow-runtime.js";import{resolveWorkflowCallbackBaseUrl}from"#execution/workflow-callback-url.js";import{runStep,withContextScope}from"#context/run-step.js";import{deserializeContext,serializeContext}from"#context/serialize.js";import{createDurableSessionValues,readDurableSession}from"#execution/durable-session-store.js";import{readHitlState}from"#harness/hitl/index.js";import*as agentTraceState from"#tracing/eve/agent-trace-context-store.js";import{coalesceTurnInputs,validateHarnessModelMessages}from"#harness/messages.js";import{CallbackBaseUrlKey,PendingAuthorizationResultKey}from"#harness/authorization.js";import{hydrateDurableSession,refreshSessionFromTurnAgent}from"#execution/session.js";import{resolveEffectiveAgentRuntime,resolveSessionUsageLimit}from"#execution/effective-agent-config.js";import{checksSessionEvents,foldOrphanedLines,openSessionEventPublisher,readOrphanedLines}from"#execution/publish-session-events.js";import{withSessionStateDelta}from"#execution/session/step-state-delta.js";import{dropClosedRecords,saveTransition,sessionView}from"#harness/session-machine/commit.js";import{matchSignIns,receive}from"#harness/session-machine/transitions.js";import{readPendingHistory,withoutPendingHistory}from"#execution/session/pending-history.js";import{fact}from"#harness/facts.js";import{admitDeliveries}from"#execution/session/delivery-facts.js";import{hasDelegatedSessionContext}from"#execution/delegated-session-context.js";import{setChannelContext}from"#execution/channel-context.js";import{applyReactionEffects,restoreReactions}from"#reactions/runner.js";import{reconcileSessionContinuationToken}from"#execution/reconcile-session-continuation-token.js";import{eventsOf}from"#harness/publication.js";import{bindSessionInstrumentation}from"#instrumentation/runtime.js";import{deriveSessionTitle}from"#execution/eve-workflow-attributes.js";import{isTurnCancellation,throwIfTurnAborted}from"#harness/turn-cancellation.js";import{bindTurnCallerContext}from"#subagents/parent-notification.js";import{traceSessionHandover}from"#execution/session/handover-tracing.js";import{createCancelledModelCallBatchResult}from"#execution/cancelled-model-call-batch.js";import{pausedOrParked,resolveSessionStepResult}from"#execution/session/turn-step-result.js";import{startSessionPrewarmers}from"#context/prewarm.js";import{setEveAttributes}from"#runtime/attributes/emit.js";import{RuntimeActionSettlementTimesKey}from"#harness/runtime-action-settlement-state.js";import{matchAuthorizationCallbacks}from"#execution/authorization-callback-match.js";import{attributeAnswers}from"#execution/session/answer-caller.js";import{readInterruptedAttempt,recoverInterruptedStep}from"#execution/session/interrupted-step.js";import{stepDisagreement}from"#execution/session/step-decision-check.js";import{createTurnEventHandler}from"#execution/session/turn-event-handler.js";import{buildRuntimeIdentity,createExecutionNodeStep}from"#execution/node-step.js";import{runModelCallBatch}from"#execution/model-call-batching.js";const log=createLogger(`execution.turn-step`);async function turnStep(e){"use step";return e.handover!==void 0&&traceSessionHandover(`inbox_unblocked`,e.sessionState.sessionId,e.handover.attemptKey,{"eve.handoff.buffered_payload_count":e.handover.payloadCount,"eve.handoff.applied_at_ms":e.handover.appliedAtMs,"eve.handoff.applied_at_clock":`workflow`}),await withSessionStateDelta(e,e=>runSessionStep({...e,serializedContext:bindTurnCallerContext(e.caller,e.serializedContext)}))}async function runSessionStep(e){let t={};try{return await runSessionStepBody(e,t)}finally{await t.title}}async function runSessionStepBody(e,t){let n=e.input?.delivery,r=n,i=e.input?.runtimeResults,a=readDurableSession(e.sessionState),o=await deserializeContext(e.serializedContext);enterSessionProjection(o,a.state);let s=await readOrphanedLines({sessionId:a.sessionId,position:nextLinePosition(o),sessionWritable:e.sessionWritable,always:e.recover!==void 0}),c=s.length>0||e.recover!==void 0?readInterruptedAttempt(nextLinePosition(o),s):void 0;s.length>0&&enterSessionProjectionAt(o,foldOrphanedLines(currentProjection(o),s));let l=o.require(ChannelKey),u=o.require(BundleKey),d=resolveEffectiveAgentRuntime(u,o);try{let{getWorkflowMetadata:e}=await import(`#compiled/@workflow/core/index.js`),t=e();typeof t.url==`string`&&o.set(CallbackBaseUrlKey,resolveWorkflowCallbackBaseUrl(t.url))}catch{}let{signIns:f}=readHitlState(a.state),p;if(f.length>0&&r!==void 0){let{matches:e,remainingPayloads:t}=matchAuthorizationCallbacks(f,r.payloads);if(r={...r,payloads:t},e.length>0){let n=e.map(e=>e.result.attemptId),i=e.map(e=>e.result);o.set(PendingAuthorizationResultKey,i);let s=sessionView(storedProjection(a.state),a.state),c=matchSignIns(s,{attemptIds:n});if(c.events.length!==0)throw Error(`matchSignIns must not emit events.`);a=saveTransition(a,c),p=e,t.length===0&&(r=void 0)}}r?.payloads.some(e=>e.message!==void 0)&&(o.delete(ScheduleIdKey),o.delete(ScheduleInstanceKey),o.delete(OccurrenceIdKey),r.schedule!==void 0&&(o.set(ScheduleIdKey,r.schedule.definition),r.schedule.instance!==void 0&&o.set(ScheduleInstanceKey,r.schedule.instance),r.schedule.occurrenceId!==void 0&&o.set(OccurrenceIdKey,r.schedule.occurrenceId)));let m=o.get(AuthKey),h=o.has(InitiatorAuthKey);r?.auth!==void 0&&(o.set(AuthKey,r.auth??null),o.has(InitiatorAuthKey)||o.set(InitiatorAuthKey,r.auth??null));let g=r===void 0?p?.find(({challenge:e})=>e.candidateId===void 0)?.challenge.requester:void 0;g!==void 0&&o.set(AuthKey,g);let _={...hydrateDurableSession({compactionOverrides:{thresholdPercent:d.thresholdPercent},durable:a,turnAgent:d.turnAgent}),history:validateHarnessModelMessages(e.history)},v=bindSessionInstrumentation({agentName:d.turnAgent.id,ctx:o,rootSessionId:_.rootSessionId??_.sessionId,sessionId:_.sessionId});bindMemoryInstrumentation(o,v?.memory);let y=turnPosition(currentProjection(o)),b=isBetweenTurns(currentProjection(o));if(!y.sessionStarted&&!o.has(SessionTitleKey)&&!o.has(ParentSessionKey)){let e=n?.payloads.find(e=>e.message!==void 0)?.message,r=deriveSessionTitle(n?.title??e);r!==void 0&&(o.set(SessionTitleKey,r),t.title=setEveAttributes({"$eve.title":r}))}n!==void 0&&(await contextStorage.run(o,()=>v?.preparePreamble({sequence:y.sequence,sessionStarted:y.sessionStarted})),v?.prepareDelivery(n));let x=openSessionEventPublisher({ctx:o,origin:`own`,sessionWritable:e.sessionWritable}),{adapterCtx:S}=x.dispatcher,C=new AbortController,w=e.abortSignal===void 0?C.signal:AbortSignal.any([e.abortSignal,C.signal]);try{let s={...u.graph.root,turnAgent:d.turnAgent},f=resolveSessionUsageLimit(u),g=!1,T=createTurnEventHandler({abortSignal:w,canCancelTurn:e.input?.control===void 0,conversation:_.history,hookCancellation:C,publisher:x}),handleEvent=async(e,t)=>{eventsOf(e).some(e=>e.type===`context.settled`&&e.data.kind===`compaction`&&e.data.outcome===`completed`)&&(g=!0),await T(e,t)},E=r!==void 0&&!b?structuredClone(S.state):void 0,D,O;if(r!==void 0){let e=[],t=r.payloads.some(e=>e.message!==void 0)?readPendingHistory(a.state):[],i=0;try{for(let n of r.payloads){let r=l.deliver?await l.deliver(n,S):defaultDeliverResult(n);if(r==null){e.push({input:void 0,payload:n});continue}let a=[...i===0?t:[],...n.history??[]];i+=1,e.push({input:a.length===0?r:{...r,history:a},payload:n})}}catch(e){throw await v?.flush(),e}O=admitDeliveries({channelKind:o.get(ChannelInstrumentationKey)?.kind??getAdapterKind(l),delivery:n??r,status:e=>currentProjection(o).view.deliveries[e]?.status,payloads:e}),i>0&&t.length>0&&(_={..._,state:withoutPendingHistory(_.state)}),D=O.inputs.length===0?void 0:O.inputs.reduce(coalesceTurnInputs)}let k=r?.auth===void 0?void 0:attributeAnswers({responder:r.auth,state:a.state,stepInput:D});if(k!==void 0&&(D=k,m===void 0?o.delete(AuthKey):o.set(AuthKey,m),h||o.delete(InitiatorAuthKey)),r!==void 0&&D===void 0&&!b)m===void 0?o.delete(AuthKey):o.set(AuthKey,m),S.state=E;else if(n?.payloads.some(e=>e.message!==void 0)){let e=n.deliveryMetadata?.map(e=>e.deliveryId)??[];o.set(TurnDeliveryIdsKey,y.turnId?[...new Set([...o.get(TurnDeliveryIdsKey)??[],...e])]:e)}else!y.sessionStarted&&o.get(ChannelDeliveryKey)!==void 0&&o.set(TurnDeliveryIdsKey,[o.require(ChannelDeliveryKey).deliveryId]);if(i!==void 0&&(i.acceptedAtMsByCallId!==void 0&&o.set(RuntimeActionSettlementTimesKey,i.acceptedAtMsByCallId),D={...D,delegatedUsage:i.delegatedUsage,runtimeActionResults:i.results}),n!==void 0){let e={...l,state:{...S.state}};setChannelContext(o,e)}let A=!1,admissionFacts=e=>{if(O===void 0||O.facts.length===0)return[];let t=[];if(!turnPosition(currentProjection(o)).sessionStarted){let n=o.get(ParentSessionKey),r=o.get(SessionPredecessorKey);t.push(fact(`session.started`,{parent:n===void 0?void 0:{callId:n.callId,sessionId:n.sessionId},predecessor:r,runtime:e}))}return[...t,...O.facts]},publishAdmission=async e=>{let t=admissionFacts(e);if(t.length===0)return;let n=sessionProvider.create(o,_);o.setVirtualContext(SessionKey,n.value);let r=await connectionProvider.create(o,_);r!==void 0&&o.setVirtualContext(ConnectionRegistryKey,r.value);let i=await sandboxProvider.create(o,_);i!==void 0&&o.setVirtualContext(SandboxKey,i.value);let a=v?.createHandleEvent({handleEvent})??handleEvent;try{await contextStorage.run(o,()=>a(t))}finally{if(i!==void 0){let e=await i.value.captureState();JSON.stringify(e)!==JSON.stringify(_.sandboxState??null)&&(A=!0,_={..._,sandboxState:e})}}},consumeCancelledInput=async()=>{let e=currentProjection(o),t=(D?.deliveries??[]).filter(({deliveryId:t})=>e.view.deliveries[t]?.status===`admitted`);if(t.length===0)return;let{events:n}=receive(sessionView(e,_.state),{deliveries:t}),r=createTurnEventHandler({abortSignal:w,canCancelTurn:!1,conversation:_.history,hookCancellation:new AbortController,publisher:x}),i=v?.createHandleEvent({handleEvent:r})??r;await contextStorage.run(o,()=>i(n))};if(r!==void 0&&D===void 0&&b){await publishAdmission(buildRuntimeIdentity(s)).catch(ignoreTurnCancellation),await v?.flush();let t=saveSessionProjection(reconcileSessionContinuationToken(o,_),o),n=serializeContext(o),r=t===_&&!A?{history:e.history,sessionState:e.sessionState}:createDurableSessionValues(t);return pausedOrParked(t,{serializedContext:n,...r})}let j=buildRuntimeIdentity(s),M,prepareReactions=e=>(o.setVirtualContext(StaticModelReferenceKey,d.turnAgent.model??null),M??=(async()=>{try{let t=process.env.VERCEL_DEPLOYMENT_ID?.trim(),n=t?`deployment:${t}`:await resolveRuntimeCompiledArtifactsVersionedCacheKey(u.compiledArtifactsSource);await contextStorage.run(o,()=>restoreReactions(o,{abortSignal:w,conversation:e.history,revision:n}))}catch(e){throw await v?.flush(),e}})());if(c!==void 0){let t=await recoverInterruptedStep({admission:admissionFacts(j),attempt:c,control:e.input?.control===void 0?void 0:{delivery:e.input.controlDelivery,kind:e.input.control},ctx:o,failed:e.recover,publish:async(e,t)=>(await withContextScope(o,t,async t=>{await prepareReactions(t);let n=createTurnEventHandler({abortSignal:w,canCancelTurn:!1,conversation:t.history,hookCancellation:new AbortController,publisher:x});return await(v?.createHandleEvent({handleEvent:n})??n)(e),{result:void 0,session:t}})).session,session:_,stepInput:D}).catch(async e=>{throw await v?.flush(),e});if(`result`in t)return await v?.flush(),t.result.action===`done`&&await x.writer.close().catch(()=>{}),t.result;_=t.session,D=t.stepInput}await prepareReactions(_);try{await publishAdmission(j)}catch(e){if(!isTurnCancellation(e))throw await v?.flush(),e}let N=u.resolvedAgent.config?.experimental?.workflow?.modelCallsPerStep??1,P=o.get(CapabilitiesKey),runHarnessStep=async(n,r,i)=>{let a=refreshSessionFromTurnAgent({compactionOverrides:{thresholdPercent:d.thresholdPercent},session:n,turnAgent:d.turnAgent});return createExecutionNodeStep({steeringSignal:e.steeringSignal,abortSignal:w,capabilities:P,clearOnly:e.input?.control===`clear`,compactOnly:e.input?.control===`compact`,controlDelivery:e.input?.controlDelivery,createRuntime:createWorkflowRuntime,handleEvent,signInCompletions:i,typedAnswers:!hasDelegatedSessionContext(e.serializedContext),instrumentation:v,modelResolutionScope:{moduleMap:u.moduleMap,nodeId:u.nodeId},node:s,sessionUsageLimit:f,titleAttributeWrite:t.title})(a,r)},F,I;try{throwIfTurnAborted(w),I=await runModelCallBatch({steeringSignal:e.steeringSignal,initialInput:D,initialSession:_,modelCallsPerStep:N,runStep:async({firstCall:t,session:n,stepInput:r})=>{let i=await runStep(o,n,async n=>{t&&e.input?.control===void 0&&startSessionPrewarmers(o,`turn`),o.setVirtualContext(HandleEventKey,handleEvent),o.setVirtualContext(StaticModelReferenceKey,d.turnAgent.model??null);let i=t&&D?.outputSchema!==void 0?{...n,outputSchema:D.outputSchema}:n;await applyReactionEffects(o);let a=t&&p!==void 0?p.map(({challenge:e})=>e):void 0,s=await runHarnessStep(i,r,a);return await x.finish({announce:stoppedForPerson(s)}),s});i.settledTurn===void 0&&throwIfTurnAborted(w);let a={...i,session:saveSessionProjection(i.session,o)};return recordAppliedSession(o,a.session),F={result:a,serializedContext:serializeContext(o)},a}})}catch(t){if(!isTurnCancellation(t)&&!w.aborted)throw await v?.flush(),t;return F===void 0&&await consumeCancelledInput(),createCancelledModelCallBatchResult({beforeBatchContext:e.serializedContext,checkpoint:F,ctx:o,initialSession:_,stepInput:D})}let L=saveSessionProjection(dropClosedRecords(reconcileSessionContinuationToken(o,I.session),currentProjection(o)),o);agentTraceState.pruneAgentTraceState(o,L.sessionId,L.state);let R=serializeContext(o);I={...I,session:L};let z=resolveSessionStepResult(I,R);if(checksSessionEvents()){let e=stepDisagreement(z,currentProjection(o).view);e!==void 0&&e!==`dispatch-deferred`&&log.warn(`a turn step's decision disagrees with the session's tables`,{disagreement:e})}return z.action===`done`&&await x.writer.close(),g?{...z,compacted:!0}:z}finally{x.writer.release()}}function stoppedForPerson(e){return e.held===void 0?e.next===null&&e.settledTurn===void 0:e.held.kind===`request`}function ignoreTurnCancellation(e){if(!isTurnCancellation(e))throw e}export{turnStep};
1
+ import{createLogger}from"#internal/logging.js";import{resolveRuntimeCompiledArtifactsVersionedCacheKey}from"#runtime/cache-key.js";import{defaultDeliverResult,getAdapterKind}from"#channel/adapter.js";import{contextStorage}from"#context/container.js";import{AuthKey,CapabilitiesKey,ChannelDeliveryKey,ChannelInstrumentationKey,HandleEventKey,InitiatorAuthKey,OccurrenceIdKey,ParentSessionKey,SandboxKey,ScheduleIdKey,ScheduleInstanceKey,SessionKey,SessionPredecessorKey,SessionTitleKey,StaticModelReferenceKey,ToolChannelKey,TurnDeliveryIdsKey}from"#context/keys.js";import{bindMemoryInstrumentation}from"#reactions/kinds/memory.js";import{BundleKey,ChannelKey}from"#runtime/sessions/runtime-context-keys.js";import{sandboxProvider}from"#context/providers/sandbox.js";import{isBetweenTurns,storedProjection,turnPosition}from"#harness/session-machine/view.js";import{currentProjection,enterSessionProjection,enterSessionProjectionAt,nextLinePosition,recordAppliedSession,saveSessionProjection}from"#harness/session-machine/current.js";import{ConnectionRegistryKey,connectionProvider}from"#context/providers/connection.js";import{sessionProvider}from"#context/providers/session.js";import{createWorkflowRuntime}from"#execution/workflow-runtime.js";import{hasDelegatedSessionContext}from"#execution/delegated-session-context.js";import{resolveWorkflowCallbackBaseUrl}from"#execution/workflow-callback-url.js";import{runStep,withContextScope}from"#context/run-step.js";import{deserializeContext,serializeContext}from"#context/serialize.js";import{createDurableSessionValues,readDurableSession}from"#execution/durable-session-store.js";import{readHitlState}from"#harness/hitl/index.js";import*as agentTraceState from"#tracing/eve/agent-trace-context-store.js";import{coalesceTurnInputs,validateHarnessModelMessages}from"#harness/messages.js";import{CallbackBaseUrlKey,PendingAuthorizationResultKey}from"#harness/authorization.js";import{hydrateDurableSession,refreshSessionFromTurnAgent}from"#execution/session.js";import{resolveEffectiveAgentRuntime,resolveSessionUsageLimit}from"#execution/effective-agent-config.js";import{checksSessionEvents,foldOrphanedLines,openSessionEventPublisher,readOrphanedLines}from"#execution/publish-session-events.js";import{withSessionStateDelta}from"#execution/session/step-state-delta.js";import{dropClosedRecords,saveTransition,sessionView}from"#harness/session-machine/commit.js";import{matchSignIns,receive}from"#harness/session-machine/transitions.js";import{readPendingHistory,withoutPendingHistory}from"#execution/session/pending-history.js";import{fact}from"#harness/facts.js";import{admitDeliveries}from"#execution/session/delivery-facts.js";import{setChannelContext}from"#execution/channel-context.js";import{continueTurnAuth}from"#execution/session/principal.js";import{applyReactionEffects,restoreReactions}from"#reactions/runner.js";import{reconcileSessionContinuationToken}from"#execution/reconcile-session-continuation-token.js";import{eventsOf}from"#harness/publication.js";import{bindSessionInstrumentation}from"#instrumentation/runtime.js";import{deriveSessionTitle}from"#execution/eve-workflow-attributes.js";import{isTurnCancellation,throwIfTurnAborted}from"#harness/turn-cancellation.js";import{bindTurnCallerContext}from"#subagents/parent-notification.js";import{traceSessionHandover}from"#execution/session/handover-tracing.js";import{createCancelledModelCallBatchResult}from"#execution/cancelled-model-call-batch.js";import{pausedOrParked,resolveSessionStepResult}from"#execution/session/turn-step-result.js";import{startSessionPrewarmers}from"#context/prewarm.js";import{createToolChannelTo}from"#execution/tools/channel-to.js";import{channelOf}from"#reactions/frame.js";import{setEveAttributes}from"#runtime/attributes/emit.js";import{RuntimeActionSettlementTimesKey}from"#harness/runtime-action-settlement-state.js";import{matchAuthorizationCallbacks}from"#execution/authorization-callback-match.js";import{attributeAnswers}from"#execution/session/answer-caller.js";import{readInterruptedAttempt,recoverInterruptedStep}from"#execution/session/interrupted-step.js";import{stepDisagreement}from"#execution/session/step-decision-check.js";import{createTurnEventHandler}from"#execution/session/turn-event-handler.js";import{buildRuntimeIdentity,createExecutionNodeStep}from"#execution/node-step.js";import{runModelCallBatch}from"#execution/model-call-batching.js";const log=createLogger(`execution.turn-step`);async function turnStep(e){"use step";return e.handover!==void 0&&traceSessionHandover(`inbox_unblocked`,e.sessionState.sessionId,e.handover.attemptKey,{"eve.handoff.buffered_payload_count":e.handover.payloadCount,"eve.handoff.applied_at_ms":e.handover.appliedAtMs,"eve.handoff.applied_at_clock":`workflow`}),await withSessionStateDelta(e,e=>runSessionStep({...e,serializedContext:bindTurnCallerContext(e.caller,e.serializedContext)}))}async function runSessionStep(e){let t={};try{return await runSessionStepBody(e,t)}finally{await t.title}}async function runSessionStepBody(e,t){let n=e.input?.delivery,r=n,i=e.input?.runtimeResults,a=readDurableSession(e.sessionState),o=await deserializeContext(e.serializedContext);enterSessionProjection(o,a.state);let s=await readOrphanedLines({sessionId:a.sessionId,position:nextLinePosition(o),sessionWritable:e.sessionWritable,always:e.recover!==void 0}),c=s.length>0||e.recover!==void 0?readInterruptedAttempt(nextLinePosition(o),s):void 0;s.length>0&&enterSessionProjectionAt(o,foldOrphanedLines(currentProjection(o),s));let l=o.require(ChannelKey),u=o.require(BundleKey),d=resolveEffectiveAgentRuntime(u,o);try{let{getWorkflowMetadata:e}=await import(`#compiled/@workflow/core/index.js`),t=e();typeof t.url==`string`&&o.set(CallbackBaseUrlKey,resolveWorkflowCallbackBaseUrl(t.url))}catch{}let{signIns:f}=readHitlState(a.state),p;if(f.length>0&&r!==void 0){let{matches:e,remainingPayloads:t}=matchAuthorizationCallbacks(f,r.payloads);if(r={...r,payloads:t},e.length>0){let n=e.map(e=>e.result.attemptId),i=e.map(e=>e.result);o.set(PendingAuthorizationResultKey,i);let s=sessionView(storedProjection(a.state),a.state),c=matchSignIns(s,{attemptIds:n});if(c.events.length!==0)throw Error(`matchSignIns must not emit events.`);a=saveTransition(a,c),p=e,t.length===0&&(r=void 0)}}r?.payloads.some(e=>e.message!==void 0)&&(o.delete(ScheduleIdKey),o.delete(ScheduleInstanceKey),o.delete(OccurrenceIdKey),r.schedule!==void 0&&(o.set(ScheduleIdKey,r.schedule.definition),r.schedule.instance!==void 0&&o.set(ScheduleInstanceKey,r.schedule.instance),r.schedule.occurrenceId!==void 0&&o.set(OccurrenceIdKey,r.schedule.occurrenceId)));let m=o.get(AuthKey),h=o.has(InitiatorAuthKey);r?.auth!==void 0&&(o.set(AuthKey,r.auth??null),o.has(InitiatorAuthKey)||o.set(InitiatorAuthKey,r.auth??null));let g=r===void 0?p?.find(({challenge:e})=>e.candidateId===void 0)?.challenge.requester:void 0;g!==void 0&&o.set(AuthKey,g);let _={...hydrateDurableSession({compactionOverrides:{thresholdPercent:d.thresholdPercent},durable:a,turnAgent:d.turnAgent}),history:validateHarnessModelMessages(e.history)},v=bindSessionInstrumentation({agentName:d.turnAgent.id,ctx:o,rootSessionId:_.rootSessionId??_.sessionId,sessionId:_.sessionId});bindMemoryInstrumentation(o,v?.memory);let y=turnPosition(currentProjection(o)),b=isBetweenTurns(currentProjection(o));if(!y.sessionStarted&&!o.has(SessionTitleKey)&&!o.has(ParentSessionKey)){let e=n?.payloads.find(e=>e.message!==void 0)?.message,r=deriveSessionTitle(n?.title??e);r!==void 0&&(o.set(SessionTitleKey,r),t.title=setEveAttributes({"$eve.title":r}))}n!==void 0&&(await contextStorage.run(o,()=>v?.preparePreamble({sequence:y.sequence,sessionStarted:y.sessionStarted})),v?.prepareDelivery(n));let x=openSessionEventPublisher({ctx:o,origin:`own`,sessionWritable:e.sessionWritable}),{adapterCtx:S}=x.dispatcher,C=new AbortController,w=e.abortSignal===void 0?C.signal:AbortSignal.any([e.abortSignal,C.signal]);try{let s={...u.graph.root,turnAgent:d.turnAgent},f=resolveSessionUsageLimit(u),g=!1,T=createTurnEventHandler({abortSignal:w,canCancelTurn:e.input?.control===void 0,conversation:_.history,hookCancellation:C,publisher:x}),handleEvent=async(e,t)=>{eventsOf(e).some(e=>e.type===`context.settled`&&e.data.kind===`compaction`&&e.data.outcome===`completed`)&&(g=!0),await T(e,t)},E=r!==void 0&&!b?structuredClone(S.state):void 0,D,O;if(r!==void 0){let e=[],t=r.payloads.some(e=>e.message!==void 0)?readPendingHistory(a.state):[],i=0;try{for(let n of r.payloads){let r=l.deliver?await l.deliver(n,S):defaultDeliverResult(n);if(r==null){e.push({input:void 0,payload:n});continue}let a=[...i===0?t:[],...n.history??[]];i+=1,e.push({input:a.length===0?r:{...r,history:a},payload:n})}}catch(e){throw await v?.flush(),e}O=admitDeliveries({channelKind:o.get(ChannelInstrumentationKey)?.kind??getAdapterKind(l),delivery:n??r,status:e=>currentProjection(o).view.deliveries[e]?.status,payloads:e}),i>0&&t.length>0&&(_={..._,state:withoutPendingHistory(_.state)}),D=O.inputs.length===0?void 0:O.inputs.reduce(coalesceTurnInputs)}let k=r?.auth===void 0?void 0:attributeAnswers({owner:b?void 0:m??null,responder:r.auth,state:a.state,stepInput:D});k!==void 0&&(D=k,h||o.delete(InitiatorAuthKey));let A=r!==void 0&&D===void 0&&!b,j=o.get(AuthKey);if(k!==void 0||A?j=m:r!==void 0&&!b&&(j=D?.message===void 0?m:continueTurnAuth(m,j)),j===void 0?o.delete(AuthKey):o.set(AuthKey,j),A)S.state=E;else if(n?.payloads.some(e=>e.message!==void 0)){let e=n.deliveryMetadata?.map(e=>e.deliveryId)??[];o.set(TurnDeliveryIdsKey,y.turnId?[...new Set([...o.get(TurnDeliveryIdsKey)??[],...e])]:e)}else!y.sessionStarted&&o.get(ChannelDeliveryKey)!==void 0&&o.set(TurnDeliveryIdsKey,[o.require(ChannelDeliveryKey).deliveryId]);if(i!==void 0&&(i.acceptedAtMsByCallId!==void 0&&o.set(RuntimeActionSettlementTimesKey,i.acceptedAtMsByCallId),D={...D,delegatedUsage:i.delegatedUsage,runtimeActionResults:i.results}),n!==void 0){let e={...l,state:{...S.state}};setChannelContext(o,e)}let M=!1,admissionFacts=e=>{if(O===void 0||O.facts.length===0)return[];let t=[];if(!turnPosition(currentProjection(o)).sessionStarted){let n=o.get(ParentSessionKey),r=o.get(SessionPredecessorKey);t.push(fact(`session.started`,{parent:n===void 0?void 0:{callId:n.callId,sessionId:n.sessionId},predecessor:r,runtime:e}))}return[...t,...O.facts]},publishAdmission=async e=>{let t=admissionFacts(e);if(t.length===0)return;let n=sessionProvider.create(o,_);o.setVirtualContext(SessionKey,n.value);let r=await connectionProvider.create(o,_);r!==void 0&&o.setVirtualContext(ConnectionRegistryKey,r.value);let i=await sandboxProvider.create(o,_);i!==void 0&&o.setVirtualContext(SandboxKey,i.value);let a=v?.createHandleEvent({handleEvent})??handleEvent;try{await contextStorage.run(o,()=>a(t))}finally{if(i!==void 0){let e=await i.value.captureState();JSON.stringify(e)!==JSON.stringify(_.sandboxState??null)&&(M=!0,_={..._,sandboxState:e})}}},consumeCancelledInput=async()=>{let e=currentProjection(o),t=(D?.deliveries??[]).filter(({deliveryId:t})=>e.view.deliveries[t]?.status===`admitted`);if(t.length===0)return;let{events:n}=receive(sessionView(e,_.state),{deliveries:t}),r=createTurnEventHandler({abortSignal:w,canCancelTurn:!1,conversation:_.history,hookCancellation:new AbortController,publisher:x}),i=v?.createHandleEvent({handleEvent:r})??r;await contextStorage.run(o,()=>i(n))};if(r!==void 0&&D===void 0&&b){await publishAdmission(buildRuntimeIdentity(s)).catch(ignoreTurnCancellation),await v?.flush();let t=saveSessionProjection(reconcileSessionContinuationToken(o,_),o),n=serializeContext(o),r=t===_&&!M?{history:e.history,sessionState:e.sessionState}:createDurableSessionValues(t);return pausedOrParked(t,{serializedContext:n,...r})}let N=buildRuntimeIdentity(s),P,prepareReactions=e=>(o.setVirtualContext(StaticModelReferenceKey,d.turnAgent.model??null),P??=(async()=>{try{let t=process.env.VERCEL_DEPLOYMENT_ID?.trim(),n=t?`deployment:${t}`:await resolveRuntimeCompiledArtifactsVersionedCacheKey(u.compiledArtifactsSource);await contextStorage.run(o,()=>restoreReactions(o,{abortSignal:w,conversation:e.history,revision:n}))}catch(e){throw await v?.flush(),e}})());if(c!==void 0){let t=await recoverInterruptedStep({admission:admissionFacts(N),attempt:c,control:e.input?.control===void 0?void 0:{delivery:e.input.controlDelivery,kind:e.input.control},ctx:o,failed:e.recover,publish:async(e,t)=>(await withContextScope(o,t,async t=>{await prepareReactions(t);let n=createTurnEventHandler({abortSignal:w,canCancelTurn:!1,conversation:t.history,hookCancellation:new AbortController,publisher:x});return await(v?.createHandleEvent({handleEvent:n})??n)(e),{result:void 0,session:t}})).session,session:_,stepInput:D}).catch(async e=>{throw await v?.flush(),e});if(`result`in t)return await v?.flush(),t.result.action===`done`&&await x.writer.close().catch(()=>{}),t.result;_=t.session,D=t.stepInput}await prepareReactions(_);try{await publishAdmission(N)}catch(e){if(!isTurnCancellation(e))throw await v?.flush(),e}let F=u.resolvedAgent.config?.experimental?.workflow?.modelCallsPerStep??1,I=o.get(CapabilitiesKey),runHarnessStep=async(n,r,i)=>{let a=refreshSessionFromTurnAgent({compactionOverrides:{thresholdPercent:d.thresholdPercent},session:n,turnAgent:d.turnAgent});return createExecutionNodeStep({steeringSignal:e.steeringSignal,abortSignal:w,capabilities:I,clearOnly:e.input?.control===`clear`,compactOnly:e.input?.control===`compact`,controlDelivery:e.input?.controlDelivery,createRuntime:createWorkflowRuntime,handleEvent,signInCompletions:i,typedAnswers:!hasDelegatedSessionContext(e.serializedContext),instrumentation:v,modelResolutionScope:{moduleMap:u.moduleMap,nodeId:u.nodeId},node:s,sessionUsageLimit:f,titleAttributeWrite:t.title})(a,r)},L,R;try{throwIfTurnAborted(w),R=await runModelCallBatch({steeringSignal:e.steeringSignal,initialInput:D,initialSession:_,modelCallsPerStep:F,runStep:async({firstCall:t,session:n,stepInput:r})=>{let i=await runStep(o,n,async n=>{t&&e.input?.control===void 0&&startSessionPrewarmers(o,`turn`),o.setVirtualContext(HandleEventKey,handleEvent),o.setVirtualContext(StaticModelReferenceKey,d.turnAgent.model??null),o.setVirtualContext(ToolChannelKey,{channel:channelOf(o),to:createToolChannelTo({delegated:hasDelegatedSessionContext(e.serializedContext),loadBundle:()=>o.require(BundleKey)})});let i=t&&D?.outputSchema!==void 0?{...n,outputSchema:D.outputSchema}:n;await applyReactionEffects(o);let a=t&&p!==void 0?p.map(({challenge:e})=>e):void 0,s=await runHarnessStep(i,r,a);return await x.finish({announce:stoppedForPerson(s)}),s});i.settledTurn===void 0&&throwIfTurnAborted(w);let a={...i,session:saveSessionProjection(i.session,o)};return recordAppliedSession(o,a.session),L={result:a,serializedContext:serializeContext(o)},a}})}catch(t){if(!isTurnCancellation(t)&&!w.aborted)throw await v?.flush(),t;return L===void 0&&await consumeCancelledInput(),createCancelledModelCallBatchResult({beforeBatchContext:e.serializedContext,checkpoint:L,ctx:o,initialSession:_,stepInput:D})}let z=saveSessionProjection(dropClosedRecords(reconcileSessionContinuationToken(o,R.session),currentProjection(o)),o);agentTraceState.pruneAgentTraceState(o,z.sessionId,z.state);let B=serializeContext(o);R={...R,session:z};let V=resolveSessionStepResult(R,B);if(checksSessionEvents()){let e=stepDisagreement(V,currentProjection(o).view);e!==void 0&&e!==`dispatch-deferred`&&log.warn(`a turn step's decision disagrees with the session's tables`,{disagreement:e})}return V.action===`done`&&await x.writer.close(),g?{...V,compacted:!0}:V}finally{x.writer.release()}}function stoppedForPerson(e){return e.held===void 0?e.next===null&&e.settledTurn===void 0:e.held.kind===`request`}function ignoreTurnCancellation(e){if(!isTurnCancellation(e))throw e}export{turnStep};
@@ -1 +1 @@
1
- import{sessionCommandHookToken,sessionInboxHookToken}from"#execution/session-inbox/address.js";import{TASK_WAIT_TOOL_NAME}from"#protocol/task-tools.js";import{EARLIER_REMOTE_CALLER_CONTEXT_KEY_NAME}from"#context/key-names.js";import{renderTaskWaitResult}from"#execution/tasks/render.js";import{formatEarlierRemoteCallerInputError}from"#protocol/remote-agent-protocol.js";import{sleep}from"#compiled/@workflow/core/index.js";import{taskWaitResult}from"#execution/tasks/table.js";import{controlDeliveryOf}from"#execution/session/control-delivery.js";import{isAgentSessionMessage}from"#execution/tools/workflow/messages.js";import{handleWorkflowToolRunMessage,isAppliedRunMessage,takeLeadingAppliedRunMessages}from"#execution/session-workflow-tool-run.js";import{exhaustedStepError,normalizeSerializableError}from"#execution/workflow-errors.js";import{findBlockingWorkflowToolRun,isInboxToolResultFromRecordedWorkflowToolRun}from"#harness/workflow-tool-runs.js";import{resolveTurnPrincipal}from"#execution/session/principal.js";import{answerTaskCancel,cancelWorkingTasks,sessionTaskTable}from"#execution/tasks/session.js";import{dispatchCoordinationStep,publishDispatchedCallsStep}from"#execution/coordination-dispatch-step.js";import{taskToolResult}from"#execution/tasks/calls.js";import{applyRunMessagesStep}from"#execution/tools/workflow/apply-run-messages-step.js";import{interruptWorkflowToolRun}from"#execution/tools/workflow/interrupt.js";import{turnStep}from"#execution/session/turn-step.js";import{ActiveTurn}from"#execution/session/active-turn.js";import{resolveRuntimeActionResultsForCallIds}from"#runtime/actions/results.js";import{startTaskToolCallsStep}from"#execution/session/task-tool-tracing-step.js";function hasDelegatedCallerContext(e){if(earlierRemoteCaller(e)!==void 0)return!1;if(e[`eve.sessionCallback`]!==void 0)return!0;let t=e[`eve.channel`];return typeof t==`object`&&!!t&&Reflect.get(t,`kind`)===`subagent`}function earlierRemoteCaller(e){let t=e[EARLIER_REMOTE_CALLER_CONTEXT_KEY_NAME];return typeof t==`number`?t:void 0}var SessionExecution=class{input;observedHandoverAttemptKey;constructor(e){this.input=e}get cursor(){return this.input.cursor}async runTurn(e,t={}){let n=new ActiveTurn(this.input,{caller:t.caller,control:e?.control!==void 0,principal:resolveTurnPrincipal(e,this.input.cursor.serializedContext)},t.control);try{let t=await this.runTurnSteps(n,e);return await this.handleBoundaryMessages(n.takeBoundaryMessages(),t.kind===`done`),t.kind===`park`&&t.settled!==void 0&&await cancelWorkingTasks(this.input.cursor,`turn-ended`),{...t,...n.caller!==void 0&&{caller:n.caller},...n.compacted&&{compacted:!0}}}finally{n.dispose()}}async handleBoundaryMessages(e,t=!1,n){let r=[];for(let i of e)isAppliedRunMessage(i)?(!t||!isAgentSessionMessage(i))&&r.push(i):(await this.applyRunMessages(r,n),r=[],await handleWorkflowToolRunMessage({cursor:this.input.cursor,message:i}));await this.applyRunMessages(r,n)}async applyRunMessages(e,t){if(e.length===0)return;let{cancelled:n}=await this.input.cursor.advance(n=>applyRunMessagesStep({...n,canCancelTurn:t!==void 0,messages:e}));n&&t?.abort()}async runTurnSteps(e,t){let n=t,r=e.caller;for(;;){let{cursor:t}=this.input,i=r;r=void 0;let a=this.input.inbox.handoverObservation,o=a?.attemptKey===this.observedHandoverAttemptKey?void 0:a,s=await t.advanceWithHistory(t=>{let run=r=>turnStep({...t,handover:o,abortSignal:e.signal,caller:i,input:n,recover:r,steeringSignal:e.steeringSignal});return run().catch(e=>run({error:normalizeSerializableError(exhaustedStepError(e))}))});o!==void 0&&(this.observedHandoverAttemptKey=o.attemptKey),s.compacted===!0&&(e.compacted=!0);let c=this.input.queue.nextAdmission,l=s.action===`parked`&&s.settled!==void 0;await e.admitBoundary(l);let u=s.action===`done`;if(await this.handleBoundaryMessages(e.takeBoundaryMessages(),u,u?void 0:e),s.action===`cancelled`)return await this.finishCancelledTurn(e);let d=s.action===`paused`&&s.on===`calls`;if(!l&&!d&&e.signal.aborted)return await this.finishCancelledTurn(e);switch(s.action){case`done`:return{isError:s.isError,kind:`done`,output:s.output??``,usage:s.usage,usageDelta:s.usageDelta};case`parked`:return{kind:`park`,settled:s.settled};case`paused`:{let t=await this.resume(e,s,c);if(t===`cancelled`)return await this.finishCancelledTurn(e);n=t;continue}case`continue`:n=await this.withSteering(e,{});continue}}}async withSteering(e,t){let n=await e.takeSteering();if(n!==void 0||t.runtimeResults!==void 0)return{...t,...n!==void 0&&{delivery:n}}}async resume(e,t,n){let r=earlierRemoteCaller(this.input.cursor.serializedContext);if(t.on===`interaction`&&r!==void 0)throw Error(formatEarlierRemoteCallerInputError(r));if(t.on===`interaction`&&t.requestIds.length>0&&this.input.capabilities?.requestInput!==!0&&!hasDelegatedCallerContext(this.input.cursor.serializedContext))throw Error(`This session cannot request human input, so it cannot wait for a tool approval or question. Configure unattended tools with an approval policy that does not require human input.`);let i=t.on===`interaction`?{attemptIds:new Set(t.attemptIds),requestIds:new Set(t.requestIds)}:void 0,a=t.on===`calls`?await this.startCallWait(t):void 0,o=!1;for(;;){if(i!==void 0){let t=this.input.queue.takeAuthorizations(i.attemptIds);if(t!==void 0)return{delivery:{kind:`deliver`,payloads:t}};let r=await e.takeAnswers(i.requestIds);if(r!==void 0)return{delivery:r};let a=await e.takeSteering({heldSince:n});if(a!==void 0)return{delivery:a}}if(t.on===`tasks`&&taskWaitResult(sessionTaskTable(this.input.cursor),{interrupted:o,timedOut:!1})!==void 0)return await this.withSteering(e,{});let r=await a?.ready(o);if(r!==void 0)return await this.withSteering(e,{runtimeResults:r});let s=await e.nextRuntimeEvent(a?.timers()??[]);if(s===`cancelled`)return s;switch(s.kind){case`steering`:o||await a?.interrupt(),o=!0;continue;case`timeout`:a?.timedOut(s.callId);continue;case`runtime-action-result`:a?.acceptInbox(s.results);continue;case`workflow`:{let t=await this.handleWorkflowMessage(s.message,e);t!==void 0&&a?.acceptRun(t,s.message);continue}case`input`:continue}}}async startCallWait(e){let t=e.dispatch?await this.dispatchRuns():[],n=new CallWait(this.input.cursor,e.callIds,t);return await n.answerTaskToolCalls(e.taskToolCalls),n}async dispatchRuns(){let{cursor:e}=this.input,t=await e.advance(({serializedContext:e,sessionState:t})=>dispatchCoordinationStep({serializedContext:e,sessionState:t,workflowToolRunOwner:{inbox:sessionInboxHookToken(sessionCommandHookToken(this.input.sessionId))}})),{executing:n,refused:r,started:i}=t.pending;return(n.length>0||i.length>0||r.length>0)&&await e.advance(e=>publishDispatchedCallsStep({...e,pending:t.pending})),t.results}async handleWorkflowMessage(e,t){if(isAppliedRunMessage(e)){let n=t?.takeAppliedRunMessages()??takeLeadingAppliedRunMessages(this.input.inbox);await this.applyRunMessages([e,...n],t);return}return await handleWorkflowToolRunMessage({cursor:this.input.cursor,message:e})}async cancelTurnWork(){await cancelWorkingTasks(this.input.cursor,`turn-cancelled`,{turnCalls:!0})}async finishCancelledTurn(e){await this.handleBoundaryMessages(e.takeBoundaryMessages(isAgentSessionMessage)),await this.cancelTurnWork();let t=e.cancelledBy;return t===void 0?{cancelled:!0,kind:`park`}:{cancelled:!0,cancelledBy:controlDeliveryOf(t),kind:`park`}}},CallWait=class{cursor;callIds;results=[];acceptedAtMs=new Map;delegatedUsage=new Map;taskWaits=[];constructor(e,t,n){this.cursor=e,this.callIds=t;let r=Date.now();for(let e of n)this.accept(e,r)}async ready(e){this.taskWaits=await this.resolveTaskWaits(e);let t=resolveRuntimeActionResultsForCallIds({pendingCallIds:this.callIds,results:this.results});if(t===void 0)return;let n=t.flatMap(e=>{let t=this.delegatedUsage.get(e.callId);return t===void 0?[]:[[e.callId,t]]});return{acceptedAtMsByCallId:Object.fromEntries(t.map(e=>[e.callId,this.acceptedAtMs.get(e.callId)])),...n.length>0&&{delegatedUsage:Object.fromEntries(n)},results:t}}timers(){return this.taskWaits.flatMap(e=>e.timer===void 0?[]:[e.timer])}timedOut(e){for(let t of this.taskWaits)t.callId===e&&(t.timedOut=!0)}acceptInbox(e){let t=this.cursor.sessionState.snapshot.session.state,n=Date.now();for(let r of e)r.kind===`tool-result`&&isInboxToolResultFromRecordedWorkflowToolRun(t,r)&&this.accept(r,n)}acceptRun(e,t){this.accept(e),t.kind===`outcome`&&t.usage!==void 0&&this.delegatedUsage.set(e.callId,t.usage)}async interrupt(){let e=this.cursor.sessionState.snapshot.session.state,t=this.callIds.flatMap(t=>{if(this.acceptedAtMs.has(t))return[];let n=findBlockingWorkflowToolRun(e,t);return n===void 0?[]:[n.address]});await Promise.all(t.map(e=>interruptWorkflowToolRun(e)))}async answerTaskToolCalls(e){let t=[],n=e.length===0?0:await startTaskToolCallsStep();for(let r of e){if(r.kind===TASK_WAIT_TOOL_NAME){t.push(startTaskWait(r,n));continue}this.accept(await answerTaskCancel(this.cursor,r))}this.taskWaits=t,this.taskWaits=await this.resolveTaskWaits(!1)}accept(e,t=Date.now()){this.results.push(e),this.acceptedAtMs.set(e.callId,t)}async resolveTaskWaits(e){let t=sessionTaskTable(this.cursor),n=[];for(let r of this.taskWaits){let i=taskWaitResult(t,{interrupted:e,timedOut:r.timedOut});if(i===void 0){n.push(r);continue}let a=renderTaskWaitResult(i,Date.now()-r.startedAtMs);this.accept(taskToolResult(r.callId,TASK_WAIT_TOOL_NAME,a))}return n}};function startTaskWait(e,t){let{callId:n,timeoutMs:r}=e,i=r===void 0?void 0:sleep(r).then(()=>n);return{callId:n,startedAtMs:t,timedOut:r===0,timer:i}}export{SessionExecution,hasDelegatedCallerContext};
1
+ import{sessionCommandHookToken,sessionInboxHookToken}from"#execution/session-inbox/address.js";import{TASK_WAIT_TOOL_NAME}from"#protocol/task-tools.js";import{EARLIER_REMOTE_CALLER_CONTEXT_KEY_NAME}from"#context/key-names.js";import{isBetweenTurns,storedProjection}from"#harness/session-machine/view.js";import{renderTaskWaitResult}from"#execution/tasks/render.js";import{formatEarlierRemoteCallerInputError}from"#protocol/remote-agent-protocol.js";import{sleep}from"#compiled/@workflow/core/index.js";import{taskWaitResult}from"#execution/tasks/table.js";import{resolveTurnPrincipal}from"#execution/session/principal.js";import{controlDeliveryOf}from"#execution/session/control-delivery.js";import{isAgentSessionMessage}from"#execution/tools/workflow/messages.js";import{handleWorkflowToolRunMessage,isAppliedRunMessage,takeLeadingAppliedRunMessages}from"#execution/session-workflow-tool-run.js";import{exhaustedStepError,normalizeSerializableError}from"#execution/workflow-errors.js";import{findBlockingWorkflowToolRun,isInboxToolResultFromRecordedWorkflowToolRun}from"#harness/workflow-tool-runs.js";import{answerTaskCancel,cancelWorkingTasks,sessionTaskTable}from"#execution/tasks/session.js";import{dispatchCoordinationStep,publishDispatchedCallsStep}from"#execution/coordination-dispatch-step.js";import{taskToolResult}from"#execution/tasks/calls.js";import{applyRunMessagesStep}from"#execution/tools/workflow/apply-run-messages-step.js";import{interruptWorkflowToolRun}from"#execution/tools/workflow/interrupt.js";import{turnStep}from"#execution/session/turn-step.js";import{ActiveTurn}from"#execution/session/active-turn.js";import{resolveRuntimeActionResultsForCallIds}from"#runtime/actions/results.js";import{startTaskToolCallsStep}from"#execution/session/task-tool-tracing-step.js";function hasDelegatedCallerContext(e){if(earlierRemoteCaller(e)!==void 0)return!1;if(e[`eve.sessionCallback`]!==void 0)return!0;let t=e[`eve.channel`];return typeof t==`object`&&!!t&&Reflect.get(t,`kind`)===`subagent`}function earlierRemoteCaller(e){let t=e[EARLIER_REMOTE_CALLER_CONTEXT_KEY_NAME];return typeof t==`number`?t:void 0}var SessionExecution=class{input;observedHandoverAttemptKey;constructor(e){this.input=e}get cursor(){return this.input.cursor}async runTurn(e,t={}){let{cursor:n}=this.input,r=isBetweenTurns(storedProjection(n.sessionState.snapshot.session.state)),i=new ActiveTurn(this.input,{caller:t.caller,control:e?.control!==void 0,principal:resolveTurnPrincipal(r?e:void 0,n.serializedContext)},t.control);try{let t=await this.runTurnSteps(i,e);return await this.handleBoundaryMessages(i.takeBoundaryMessages(),t.kind===`done`),t.kind===`park`&&t.settled!==void 0&&await cancelWorkingTasks(this.input.cursor,`turn-ended`),{...t,...i.caller!==void 0&&{caller:i.caller},...i.compacted&&{compacted:!0}}}finally{i.dispose()}}async handleBoundaryMessages(e,t=!1,n){let r=[];for(let i of e)isAppliedRunMessage(i)?(!t||!isAgentSessionMessage(i))&&r.push(i):(await this.applyRunMessages(r,n),r=[],await handleWorkflowToolRunMessage({cursor:this.input.cursor,message:i}));await this.applyRunMessages(r,n)}async applyRunMessages(e,t){if(e.length===0)return;let{cancelled:n}=await this.input.cursor.advance(n=>applyRunMessagesStep({...n,canCancelTurn:t!==void 0,messages:e}));n&&t?.abort()}async runTurnSteps(e,t){let n=t,r=e.caller;for(;;){let{cursor:t}=this.input,i=r;r=void 0;let a=this.input.inbox.handoverObservation,o=a?.attemptKey===this.observedHandoverAttemptKey?void 0:a,s=await t.advanceWithHistory(t=>{let run=r=>turnStep({...t,handover:o,abortSignal:e.signal,caller:i,input:n,recover:r,steeringSignal:e.steeringSignal});return run().catch(e=>run({error:normalizeSerializableError(exhaustedStepError(e))}))});o!==void 0&&(this.observedHandoverAttemptKey=o.attemptKey),s.compacted===!0&&(e.compacted=!0);let c=this.input.queue.nextAdmission,l=s.action===`parked`&&s.settled!==void 0;await e.admitBoundary(l);let u=s.action===`done`;if(await this.handleBoundaryMessages(e.takeBoundaryMessages(),u,u?void 0:e),s.action===`cancelled`)return await this.finishCancelledTurn(e);let d=s.action===`paused`&&s.on===`calls`;if(!l&&!d&&e.signal.aborted)return await this.finishCancelledTurn(e);switch(s.action){case`done`:return{isError:s.isError,kind:`done`,output:s.output??``,usage:s.usage,usageDelta:s.usageDelta};case`parked`:return{kind:`park`,settled:s.settled};case`paused`:{let t=await this.resume(e,s,c);if(t===`cancelled`)return await this.finishCancelledTurn(e);n=t;continue}case`continue`:n=await this.withSteering(e,{});continue}}}async withSteering(e,t){let n=await e.takeSteering();if(n!==void 0||t.runtimeResults!==void 0)return{...t,...n!==void 0&&{delivery:n}}}async resume(e,t,n){let r=earlierRemoteCaller(this.input.cursor.serializedContext);if(t.on===`interaction`&&r!==void 0)throw Error(formatEarlierRemoteCallerInputError(r));if(t.on===`interaction`&&t.requestIds.length>0&&this.input.capabilities?.requestInput!==!0&&!hasDelegatedCallerContext(this.input.cursor.serializedContext))throw Error(`This session cannot request human input, so it cannot wait for a tool approval or question. Configure unattended tools with an approval policy that does not require human input.`);let i=t.on===`interaction`?{attemptIds:new Set(t.attemptIds),requestIds:new Set(t.requestIds)}:void 0,a=t.on===`calls`?await this.startCallWait(t):void 0,o=!1;for(;;){if(i!==void 0){let t=this.input.queue.takeAuthorizations(i.attemptIds);if(t!==void 0)return{delivery:{kind:`deliver`,payloads:t}};let r=await e.takeAnswers(i.requestIds);if(r!==void 0)return{delivery:r};let a=await e.takeSteering({heldSince:n});if(a!==void 0)return{delivery:a}}if(t.on===`tasks`&&taskWaitResult(sessionTaskTable(this.input.cursor),{interrupted:o,timedOut:!1})!==void 0)return await this.withSteering(e,{});let r=await a?.ready(o);if(r!==void 0)return await this.withSteering(e,{runtimeResults:r});let s=await e.nextRuntimeEvent(a?.timers()??[]);if(s===`cancelled`)return s;switch(s.kind){case`steering`:o||await a?.interrupt(),o=!0;continue;case`timeout`:a?.timedOut(s.callId);continue;case`runtime-action-result`:a?.acceptInbox(s.results);continue;case`workflow`:{let t=await this.handleWorkflowMessage(s.message,e);t!==void 0&&a?.acceptRun(t,s.message);continue}case`input`:continue}}}async startCallWait(e){let t=e.dispatch?await this.dispatchRuns():[],n=new CallWait(this.input.cursor,e.callIds,t);return await n.answerTaskToolCalls(e.taskToolCalls),n}async dispatchRuns(){let{cursor:e}=this.input,t=await e.advance(({serializedContext:e,sessionState:t})=>dispatchCoordinationStep({serializedContext:e,sessionState:t,workflowToolRunOwner:{inbox:sessionInboxHookToken(sessionCommandHookToken(this.input.sessionId))}})),{executing:n,refused:r,started:i}=t.pending;return(n.length>0||i.length>0||r.length>0)&&await e.advance(e=>publishDispatchedCallsStep({...e,pending:t.pending})),t.results}async handleWorkflowMessage(e,t){if(isAppliedRunMessage(e)){let n=t?.takeAppliedRunMessages()??takeLeadingAppliedRunMessages(this.input.inbox);await this.applyRunMessages([e,...n],t);return}return await handleWorkflowToolRunMessage({cursor:this.input.cursor,message:e})}async cancelTurnWork(){await cancelWorkingTasks(this.input.cursor,`turn-cancelled`,{turnCalls:!0})}async finishCancelledTurn(e){await this.handleBoundaryMessages(e.takeBoundaryMessages(isAgentSessionMessage)),await this.cancelTurnWork();let t=e.cancelledBy;return t===void 0?{cancelled:!0,kind:`park`}:{cancelled:!0,cancelledBy:controlDeliveryOf(t),kind:`park`}}},CallWait=class{cursor;callIds;results=[];acceptedAtMs=new Map;delegatedUsage=new Map;taskWaits=[];constructor(e,t,n){this.cursor=e,this.callIds=t;let r=Date.now();for(let e of n)this.accept(e,r)}async ready(e){this.taskWaits=await this.resolveTaskWaits(e);let t=resolveRuntimeActionResultsForCallIds({pendingCallIds:this.callIds,results:this.results});if(t===void 0)return;let n=t.flatMap(e=>{let t=this.delegatedUsage.get(e.callId);return t===void 0?[]:[[e.callId,t]]});return{acceptedAtMsByCallId:Object.fromEntries(t.map(e=>[e.callId,this.acceptedAtMs.get(e.callId)])),...n.length>0&&{delegatedUsage:Object.fromEntries(n)},results:t}}timers(){return this.taskWaits.flatMap(e=>e.timer===void 0?[]:[e.timer])}timedOut(e){for(let t of this.taskWaits)t.callId===e&&(t.timedOut=!0)}acceptInbox(e){let t=this.cursor.sessionState.snapshot.session.state,n=Date.now();for(let r of e)r.kind===`tool-result`&&isInboxToolResultFromRecordedWorkflowToolRun(t,r)&&this.accept(r,n)}acceptRun(e,t){this.accept(e),t.kind===`outcome`&&t.usage!==void 0&&this.delegatedUsage.set(e.callId,t.usage)}async interrupt(){let e=this.cursor.sessionState.snapshot.session.state,t=this.callIds.flatMap(t=>{if(this.acceptedAtMs.has(t))return[];let n=findBlockingWorkflowToolRun(e,t);return n===void 0?[]:[n.address]});await Promise.all(t.map(e=>interruptWorkflowToolRun(e)))}async answerTaskToolCalls(e){let t=[],n=e.length===0?0:await startTaskToolCallsStep();for(let r of e){if(r.kind===TASK_WAIT_TOOL_NAME){t.push(startTaskWait(r,n));continue}this.accept(await answerTaskCancel(this.cursor,r))}this.taskWaits=t,this.taskWaits=await this.resolveTaskWaits(!1)}accept(e,t=Date.now()){this.results.push(e),this.acceptedAtMs.set(e.callId,t)}async resolveTaskWaits(e){let t=sessionTaskTable(this.cursor),n=[];for(let r of this.taskWaits){let i=taskWaitResult(t,{interrupted:e,timedOut:r.timedOut});if(i===void 0){n.push(r);continue}let a=renderTaskWaitResult(i,Date.now()-r.startedAtMs);this.accept(taskToolResult(r.callId,TASK_WAIT_TOOL_NAME,a))}return n}};function startTaskWait(e,t){let{callId:n,timeoutMs:r}=e,i=r===void 0?void 0:sleep(r).then(()=>n);return{callId:n,startedAtMs:t,timedOut:r===0,timer:i}}export{SessionExecution,hasDelegatedCallerContext};
@@ -1 +1 @@
1
- import{createLogger}from"#internal/logging.js";import{isObject}from"#shared/guards.js";import{isLocalDevelopmentServer}from"#internal/application/dev-environment.js";import{FatalError}from"#compiled/@workflow/core/index.js";import{UnsafeDestinationError,assertPublicHostname,createPublicDispatcher,fetchWithDispatcher,findUnsafeDestinationError,readBoundedResponse}from"#execution/public-destination.js";const log=createLogger(`execution.session-callback`),VERCEL_CALLBACK_HOST_ENVS=[`VERCEL_URL`,`VERCEL_BRANCH_URL`,`VERCEL_PROJECT_PRODUCTION_URL`],VERCEL_REQUEST_CONTEXT=Symbol.for(`@vercel/request-context`);async function postSessionCallbackRequest(e){let t=e.timeoutMs??3e4,n=AbortSignal.timeout(t),r;try{r=await requestCallback(e.url,{body:JSON.stringify(e.body),headers:await resolveSessionCallbackHeaders(e.url),signal:n})}catch(r){let i=findUnsafeDestinationError(r);throw i===void 0?(e.logFailures!==!1&&log.error(`callback delivery failed`,{...callbackLogFields(e),failure:n.aborted?`timeout`:`transport`,timeoutMs:t,error:Error(`Callback request failed before receiving a response.`)}),r):(e.logFailures!==!1&&log.error(`callback delivery failed`,{...callbackLogFields(e),failure:`blocked-destination`,error:Error(i.message)}),new FatalError(`Callback delivery refused: ${i.message}`))}return!r.ok&&e.logFailures!==!1&&log.error(`callback delivery failed`,{...callbackLogFields(e),failure:`http`,statusCode:r.status,error:Error(`Callback request failed with HTTP ${r.status}.`)}),r}async function requestCallback(e,t){let n=new URL(e);if(n.protocol!==`http:`&&n.protocol!==`https:`)throw new UnsafeDestinationError(`Callback URL must use http or https.`);let r={allowLoopback:isLocalDevelopmentServer()};assertPublicHostname(n.hostname,r);let i=await createPublicDispatcher(r);try{let n=await fetchWithDispatcher(e,{...t,dispatcher:i,method:`POST`,redirect:`error`});return await readBoundedResponse(n,65536)}finally{await i.close()}}function callbackLogFields(e){let t=URL.parse(e.url),n=t?.pathname.match(/^(.*?\/(?:callback|activity))\//)?.[1],r={callbackOrigin:t?.origin,callbackPath:n===void 0?`[redacted]`:`${n}/[redacted]`};if(isObject(e.body)){for(let t of[`kind`,`callId`,`sessionId`,`childSessionId`,`subagentName`,`updateEpoch`])typeof e.body[t]==`string`&&(r[t]=e.body[t]);typeof e.body.updateIndex==`number`&&(r.updateIndex=e.body.updateIndex)}return r}async function resolveSessionCallbackHeaders(e){let t={"content-type":`application/json`};if(process.env.VERCEL!==`1`)return t;let n;try{n=new URL(e)}catch{return t}let r=VERCEL_CALLBACK_HOST_ENVS.some(e=>process.env[e]?.trim().toLowerCase()===n.hostname.toLowerCase());if(n.protocol!==`https:`||!r)return t;let i=readAmbientVercelOidcToken();return i!==void 0&&(t[`x-vercel-trusted-oidc-idp-token`]=i),t}function readAmbientVercelOidcToken(){let e=(globalThis[VERCEL_REQUEST_CONTEXT]?.get?.().headers?.[`x-vercel-oidc-token`]??process.env.VERCEL_OIDC_TOKEN)?.trim();return e===``?void 0:e}export{postSessionCallbackRequest};
1
+ import{createLogger}from"#internal/logging.js";import{isObject}from"#shared/guards.js";import{isLocalDevelopmentServer}from"#internal/application/dev-environment.js";import{FatalError}from"#compiled/@workflow/core/index.js";import{UnsafeDestinationError,assertPublicHostname,createPublicDispatcher,fetchWithDispatcher,findUnsafeDestinationError,readBoundedResponse}from"#execution/public-destination.js";const log=createLogger(`execution.session-callback`),VERCEL_CALLBACK_HOST_ENVS=[`VERCEL_URL`,`VERCEL_BRANCH_URL`,`VERCEL_PROJECT_PRODUCTION_URL`],VERCEL_REQUEST_CONTEXT=Symbol.for(`@vercel/request-context`);async function postSessionCallbackRequest(e){let t=e.timeoutMs??3e4,n=AbortSignal.timeout(t),r=await resolveSessionCallbackHeaders(e.url),i;try{i=await requestCallback(e.url,{body:JSON.stringify(e.body),headers:r,signal:n})}catch(r){let i=findUnsafeDestinationError(r);throw i===void 0?(e.logFailures!==!1&&log.error(`callback delivery failed`,{...callbackLogFields(e),failure:n.aborted?`timeout`:`transport`,timeoutMs:t,error:Error(`Callback request failed before receiving a response.`)}),r):(e.logFailures!==!1&&log.error(`callback delivery failed`,{...callbackLogFields(e),failure:`blocked-destination`,error:Error(i.message)}),new FatalError(`Callback delivery refused: ${i.message}`))}return!i.ok&&e.logFailures!==!1&&log.error(`callback delivery failed`,{...callbackLogFields(e),failure:`http`,statusCode:i.status,error:Error(`Callback request failed with HTTP ${i.status}.`)}),i}async function requestCallback(e,t){let n=new URL(e);if(n.protocol!==`http:`&&n.protocol!==`https:`)throw new UnsafeDestinationError(`Callback URL must use http or https.`);let r={allowLoopback:isLocalDevelopmentServer()};assertPublicHostname(n.hostname,r);let i=await createPublicDispatcher(r);try{let n=await fetchWithDispatcher(e,{...t,dispatcher:i,method:`POST`,redirect:`error`});return await readBoundedResponse(n,65536)}finally{await i.close()}}function callbackLogFields(e){let t=URL.parse(e.url),n=t?.pathname.match(/^(.*?\/(?:callback|activity))\//)?.[1],r={callbackOrigin:t?.origin,callbackPath:n===void 0?`[redacted]`:`${n}/[redacted]`};if(isObject(e.body)){for(let t of[`kind`,`callId`,`sessionId`,`childSessionId`,`subagentName`,`updateEpoch`])typeof e.body[t]==`string`&&(r[t]=e.body[t]);typeof e.body.updateIndex==`number`&&(r.updateIndex=e.body.updateIndex)}return r}async function resolveSessionCallbackHeaders(e){let t={"content-type":`application/json`};if(process.env.VERCEL!==`1`)return t;let n;try{n=new URL(e)}catch{return t}let r=VERCEL_CALLBACK_HOST_ENVS.some(e=>{let t=process.env[e]?.trim();return t!==void 0&&t!==``&&URL.parse(`https://${t}`)?.origin===n.origin});if(n.protocol!==`https:`||!r&&!configuredCallbackOrigins().some(e=>e(n)))return t;let i=readAmbientVercelOidcToken();return i!==void 0&&(t[`x-vercel-trusted-oidc-idp-token`]=i),t}function configuredCallbackOrigins(){let e=process.env.EVE_CALLBACK_TRUSTED_ORIGINS?.trim();return e?e.split(`,`).map(e=>{let t=URL.parse(e.trim());if(t===null||t.protocol!==`https:`||t.username!==``||t.password!==``||t.pathname!==`/`||t.search!==``||t.hash!==``)throw invalidCallbackOriginsError();if(!t.hostname.includes(`*`))return e=>e.origin===t.origin;let n=t.hostname.slice(2);if(!t.hostname.startsWith(`*.`)||n.includes(`*`)||n.endsWith(`.`)||n.split(`.`).length<2||n===`vercel.app`)throw invalidCallbackOriginsError();return e=>{let r=e.hostname.slice(0,-(n.length+1));return e.port===t.port&&e.hostname.endsWith(`.${n}`)&&r!==``&&!r.includes(`.`)}}):[]}function invalidCallbackOriginsError(){return new FatalError("EVE_CALLBACK_TRUSTED_ORIGINS must be a comma-separated list of HTTPS origins without credentials, paths, queries, or fragments. A leading `*.` label (e.g. `https://*.preview.example.com`) matches exactly one subdomain label and needs at least two labels after it; `*.vercel.app` and trailing dots are not allowed.")}function readAmbientVercelOidcToken(){let e=(globalThis[VERCEL_REQUEST_CONTEXT]?.get?.().headers?.[`x-vercel-oidc-token`]??process.env.VERCEL_OIDC_TOKEN)?.trim();return e===``?void 0:e}export{postSessionCallbackRequest};
@@ -1 +1 @@
1
- import{handleAuthorizationError}from"#runtime/connections/scoped-authorization.js";import{buildBaseToolContext}from"#context/build-base-tool-context.js";import{createAuthorizationContext}from"#runtime/authorization-context.js";function createToolExecuteWithAuth(e){return(t,n)=>{let r=createAuthorizationContext({scope:e.scope}),i={...buildBaseToolContext({options:n,toolName:e.scope}),messages:n.messages,getToken:r.getToken,requireAuth:r.requireAuth,...n.approval!==void 0&&{approval:approvalOf(n.approval.responder,r)}};return r.run(()=>e.execute(t,i))}}function approvalOf(e,t){return{responder:{...e,getToken:(n,r)=>t.getResponderToken(e,n,r)}}}function buildApprovalResponseAuth(e){let t=createAuthorizationContext({scope:e.scope,boundResponder:e.responder});return{getToken:(n,r)=>t.getToken(n,namespaceApprovalAuthOptions(e.scope,r)),requireAuth:(n,r)=>t.requireAuth(n,namespaceApprovalAuthOptions(e.scope,r))}}function namespaceApprovalAuthOptions(e,t){return t?.authKey===void 0?t:{...t,authKey:`${e}:${t.authKey}`}}async function handleApprovalResponsePolicyError(e){return await handleAuthorizationError(e)}export{buildApprovalResponseAuth,createToolExecuteWithAuth,handleApprovalResponsePolicyError};
1
+ import{contextStorage}from"#context/container.js";import{ToolChannelKey}from"#context/keys.js";import{handleAuthorizationError}from"#runtime/connections/scoped-authorization.js";import{buildBaseToolContext}from"#context/build-base-tool-context.js";import{createAuthorizationContext}from"#runtime/authorization-context.js";function createToolExecuteWithAuth(e){return(t,n)=>{let r=createAuthorizationContext({scope:e.scope}),i={...buildBaseToolContext({options:n,toolName:e.scope}),messages:n.messages,...contextStorage.getStore()?.get(ToolChannelKey)??{channel:{kind:`unknown`,metadata:{}},to:unavailableChannelTo},getToken:r.getToken,requireAuth:r.requireAuth,...n.approval!==void 0&&{approval:approvalOf(n.approval.responder,r)}};return r.run(()=>e.execute(t,i))}}const unavailableChannelTo=()=>{throw Error(`ctx.to() is only available while a session's turn runs the tool.`)};function approvalOf(e,t){return{responder:{...e,getToken:(n,r)=>t.getResponderToken(e,n,r)}}}function buildApprovalResponseAuth(e){let t=createAuthorizationContext({scope:e.scope,boundResponder:e.responder});return{getToken:(n,r)=>t.getToken(n,namespaceApprovalAuthOptions(e.scope,r)),requireAuth:(n,r)=>t.requireAuth(n,namespaceApprovalAuthOptions(e.scope,r))}}function namespaceApprovalAuthOptions(e,t){return t?.authKey===void 0?t:{...t,authKey:`${e}:${t.authKey}`}}async function handleApprovalResponsePolicyError(e){return await handleAuthorizationError(e)}export{buildApprovalResponseAuth,createToolExecuteWithAuth,handleApprovalResponsePolicyError};
@@ -1 +1 @@
1
- import{decide}from"#ai/decide.js";async function runAgentRouterTask(e,t){"use workflow";let n=await chooseTarget(e.message,descriptions(t),t.abortSignal),{reply:r,status:i}=await(await t.agent(n).send(e.message,{signal:t.abortSignal})).result();if(i===`failed`)throw Error(`Agent "${n}" failed to handle the task.`);return r??null}async function chooseTarget(e,t,n){"use step";let r=Object.keys(t);if(r.length===0)throw Error(`agentRouter requires at least one available agent with a description.`);return r.length===1?r[0]:(await decide({signal:n,state:{message:e},questions:{route:{type:`choice`,instructions:`Which subagent should handle this task?`,criteria:t}}})).answers.route.choice}function descriptions(e){return Object.fromEntries(Object.entries(e.agents).flatMap(([e,t])=>{let n=t.description.trim();return n.length===0?[]:[[e,n]]}))}runAgentRouterTask.workflowId=`workflow//eve@0.84.1//runAgentRouterTask`;export{runAgentRouterTask};
1
+ import{decide}from"#ai/decide.js";async function runAgentRouterTask(e,t){"use workflow";let n=await chooseTarget(e.message,descriptions(t),t.abortSignal),{reply:r,status:i}=await(await t.agent(n).send(e.message,{signal:t.abortSignal})).result();if(i===`failed`)throw Error(`Agent "${n}" failed to handle the task.`);return r??null}async function chooseTarget(e,t,n){"use step";let r=Object.keys(t);if(r.length===0)throw Error(`agentRouter requires at least one available agent with a description.`);return r.length===1?r[0]:(await decide({signal:n,state:{message:e},questions:{route:{type:`choice`,instructions:`Which subagent should handle this task?`,criteria:t}}})).answers.route.choice}function descriptions(e){return Object.fromEntries(Object.entries(e.agents).flatMap(([e,t])=>{let n=t.description.trim();return n.length===0?[]:[[e,n]]}))}runAgentRouterTask.workflowId=`workflow//eve@0.86.0//runAgentRouterTask`;export{runAgentRouterTask};
@@ -0,0 +1,12 @@
1
+ import { type CrossChannelToFn } from "#channel/cross-channel-receive.js";
2
+ import type { CompiledRuntimeAgentBundle } from "#runtime/sessions/compiled-agent-cache.js";
3
+ /**
4
+ * `ctx.to()` for a tool or a workflow tool's step: the root agent's channels,
5
+ * reached through their `receive()` hooks as a route's `ctx.to()` reaches them.
6
+ */
7
+ export declare function createToolChannelTo(input: {
8
+ /** Whether a parent, local or remote, delegated the session running the tool. */
9
+ readonly delegated: boolean;
10
+ /** The compiled agent that owns the tool. */
11
+ readonly loadBundle: () => CompiledRuntimeAgentBundle | Promise<CompiledRuntimeAgentBundle>;
12
+ }): CrossChannelToFn;
@@ -0,0 +1 @@
1
+ import{createCrossChannelToFn,toCrossChannelTargets}from"#channel/cross-channel-receive.js";import{ContextContainer,contextStorage}from"#context/container.js";import{createWorkflowRuntime}from"#execution/workflow-runtime.js";function createToolChannelTo(e){return(t,n)=>{if(e.delegated)throw Error(`ctx.to() isn't available in a delegated session (a subagent, a root copy, or a remote agent call): a session it started would outlive the delegation and act for the caller. Return the result to the caller, and send from a tool on the root agent.`);return{async send(r,i){let a=await e.loadBundle(),o=createCrossChannelToFn(createWorkflowRuntime({compiledArtifactsSource:a.compiledArtifactsSource}),toCrossChannelTargets(a.graph.root.channels));return await contextStorage.run(new ContextContainer,()=>o(t,n).send(r,i))}}}}export{createToolChannelTo};
@@ -1,6 +1,7 @@
1
1
  import type { SessionContext } from "#context/session-context.js";
2
2
  import type { AgentSessionContext } from "#execution/agent-sessions/context.js";
3
3
  import { type RunUsageTally } from "#execution/agent-sessions/usage.js";
4
+ import type { InstrumentationChannel } from "#shared/instrumentation-channel.js";
4
5
  import type { WorkflowSharedContext } from "#tools/workflow-definition.js";
5
6
  import { WorkflowToolRunAsks } from "#execution/tools/workflow/ask.js";
6
7
  import type { WorkflowBodyCommand, WorkflowToolRunOutcome, WorkflowToolRunRef } from "#execution/tools/workflow/messages.js";
@@ -75,6 +76,8 @@ export declare function resolveWorkflowEntryPoint<TEntryPoint>(input: WorkflowBo
75
76
  * knows its calls.
76
77
  */
77
78
  export declare function createSharedContext(input: WorkflowBodyInput, agent: WorkflowSharedContext["agent"], askPerson: WorkflowSharedContext["ask"]): Omit<ToolContext & WorkflowSharedContext, "abortSignal" | "agents" | "callId" | "messages" | "session">;
79
+ /** `ctx.channel` for a call: the channel that serves the calling session. */
80
+ export declare function workflowToolChannel(context: AgentSessionContext): InstrumentationChannel;
78
81
  /** `ctx.agents` for a call: the agents its context lists, frozen. */
79
82
  export declare function createAgentsView(context: AgentSessionContext): WorkflowSharedContext["agents"];
80
83
  export declare class WorkflowToolRunCancelledError extends Error {
@@ -1 +1 @@
1
- import{parseJsonValue}from"#shared/json.js";import{callToolStubStep}from"#execution/tool-stubs/steps.js";import{getWorkflowMetadata}from"#compiled/@workflow/core/index.js";import{findStubTarget,stubCallId}from"#tool-stubs/target.js";import{normalizeSerializableError}from"#execution/workflow-errors.js";import{toolStubOutput}from"#tool-stubs/output.js";import{createAgentSessions}from"#execution/agent-sessions/session.js";import{createRunUsageTally}from"#execution/agent-sessions/usage.js";import{WorkflowToolRunAsks,ask,attachWorkflowToolRunContext}from"#execution/tools/workflow/ask.js";import{readRegisteredWorkflow}from"#execution/workflow-registry.js";import{withToolOutputSerializationError}from"#harness/tool-output-serialization.js";const INTERRUPTED_OUTPUT={interrupted:!0};var WorkflowCallSignals=class{body=new AbortController;run=new AbortController;asks;constructor(e){this.asks=e}get abortSignal(){return this.body.signal}get runSignal(){return this.run.signal}get interrupted(){return this.body.signal.aborted&&!this.run.signal.aborted}get unwinding(){return this.run.signal.aborted}apply(e){switch(e.kind){case`cancel`:case`end`:this.asks.cancelAll(),this.run.abort(new WorkflowToolRunCancelledError(e.reason)),this.body.abort(this.run.signal.reason);return;case`interrupt`:this.body.abort(new WorkflowToolRunInterruptedError);return;case`call`:return}}};function startCallBody(e){let t=createWorkflowBodyRef(e),n=new WorkflowToolRunAsks(t.runId),r=new WorkflowCallSignals(n),i={agentContext:e.agentContext,asks:n,auth:e.session.auth,control:e.hookToken,from:t,owner:e.owner},a=createRunUsageTally(),o=createAgentSessions(i,a),s=createCallContext(e,r,o.open);return attachWorkflowToolRunContext(s,i),{asks:n,close:o.close,control:r,outcome:executeCallBody(e,s,r,t),usage:a}}async function executeCallBody(e,t,n,r){try{let n=findStubTarget(e.agentContext.toolStubs,e.toolName);if(n!==void 0){let t=await callToolStubStep(n.scope,{callId:stubCallId(e.session.id,e.session.turn.id,e.callId),tool:n.tool,input:e.input});if(t.kind===`error`)throw Error(t.error);if(t.kind===`stub`)return{output:toolStubOutput(t.outcome),status:`completed`}}let i=resolveWorkflowEntryPoint(e)(e.executeInput??e.input,t),a;if(!isAsyncIterable(i))a=await i;else{let t=i[Symbol.asyncIterator](),n,o=await t.next();for(;o.done!==!0;)n=o.value,await e.owner.send({from:r,kind:`report`,update:o.value}),o=await t.next();a=o.value??n}return{output:toWorkflowOutput(e,a),status:`completed`}}catch(e){return n.interrupted?{output:INTERRUPTED_OUTPUT,status:`completed`}:toFailedOutcome(e,n.runSignal)}}function toWorkflowOutput(e,t){return withToolOutputSerializationError({boundary:`execute`,toolCallId:e.callId,toolName:e.toolName},()=>parseJsonValue(t??null))}function toFailedOutcome(e,t){if(t.aborted){let{reason:e}=t;return{reason:e instanceof Error?e.message:String(e??``),status:`cancelled`}}return{error:normalizeSerializableError(e),status:`failed`}}function createWorkflowBodyRef(e){let t={callId:e.callId,input:e.input,runId:e.runId??getWorkflowMetadata().workflowRunId,sequence:e.session.turn.sequence,stepIndex:e.stepIndex,toolName:e.toolName,turnId:e.session.turn.id};return e.entry.entryPoint===`execute`?t:{...t,taskId:e.entry.taskId}}function resolveWorkflowEntryPoint(e){let t=readRegisteredWorkflow(e.workflowId);if(typeof t!=`function`)throw Error(`Tool "${e.toolName}" is not registered as a workflow in this deployment (${e.workflowId}). The tool was renamed or removed after this run started.`);return t}function createSharedContext(e,t,n){let unavailable=(t,n)=>{throw Error(`ctx.${t} is not available inside a workflow tool; ${n}. Tool "${e.toolName}" runs as a durable workflow body, which only replays deterministic code.`)};return{agent:t,ask:n,getSandbox:()=>unavailable(`getSandbox()`,`pass ctx directly to a "use step" helper to open the session's sandbox`),getToken:()=>unavailable(`getToken()`,`pass ctx directly to a "use step" helper to resolve credentials`),requireAuth:()=>unavailable(`requireAuth()`,`pass ctx directly to a "use step" helper to request authorization`),toolName:e.toolName}}function createAgentsView(e){return Object.freeze(Object.fromEntries(Object.entries(e.agents).map(([e,t])=>[e,Object.freeze({...t})])))}function createCallContext(e,t,n){let r={...createSharedContext(e,n,(e,t)=>ask(r,e,t)),abortSignal:t.abortSignal,agents:createAgentsView(e.agentContext),callId:e.callId,session:e.session};return r}function isAsyncIterable(e){return typeof e==`object`&&!!e&&typeof e[Symbol.asyncIterator]==`function`}var WorkflowToolRunCancelledError=class extends Error{constructor(e){super(e),this.name=`WorkflowToolRunCancelledError`}},WorkflowToolRunInterruptedError=class extends Error{constructor(){super(`A new message arrived while the turn waited on this call.`),this.name=`WorkflowToolRunInterruptedError`}};export{WorkflowToolRunCancelledError,WorkflowToolRunInterruptedError,createAgentsView,createSharedContext,createWorkflowBodyRef,resolveWorkflowEntryPoint,startCallBody,toFailedOutcome,toWorkflowOutput};
1
+ import{normalizeInstrumentationChannelKind}from"#shared/instrumentation-channel-kind.js";import{parseJsonValue}from"#shared/json.js";import{callToolStubStep}from"#execution/tool-stubs/steps.js";import{getWorkflowMetadata}from"#compiled/@workflow/core/index.js";import{findStubTarget,stubCallId}from"#tool-stubs/target.js";import{normalizeSerializableError}from"#execution/workflow-errors.js";import{toolStubOutput}from"#tool-stubs/output.js";import{createAgentSessions}from"#execution/agent-sessions/session.js";import{createRunUsageTally}from"#execution/agent-sessions/usage.js";import{WorkflowToolRunAsks,ask,attachWorkflowToolRunContext}from"#execution/tools/workflow/ask.js";import{readRegisteredWorkflow}from"#execution/workflow-registry.js";import{withToolOutputSerializationError}from"#harness/tool-output-serialization.js";const INTERRUPTED_OUTPUT={interrupted:!0};var WorkflowCallSignals=class{body=new AbortController;run=new AbortController;asks;constructor(e){this.asks=e}get abortSignal(){return this.body.signal}get runSignal(){return this.run.signal}get interrupted(){return this.body.signal.aborted&&!this.run.signal.aborted}get unwinding(){return this.run.signal.aborted}apply(e){switch(e.kind){case`cancel`:case`end`:this.asks.cancelAll(),this.run.abort(new WorkflowToolRunCancelledError(e.reason)),this.body.abort(this.run.signal.reason);return;case`interrupt`:this.body.abort(new WorkflowToolRunInterruptedError);return;case`call`:return}}};function startCallBody(e){let t=createWorkflowBodyRef(e),n=new WorkflowToolRunAsks(t.runId),r=new WorkflowCallSignals(n),i={agentContext:e.agentContext,asks:n,auth:e.session.auth,control:e.hookToken,from:t,owner:e.owner},a=createRunUsageTally(),o=createAgentSessions(i,a),s=createCallContext(e,r,o.open);return attachWorkflowToolRunContext(s,i),{asks:n,close:o.close,control:r,outcome:executeCallBody(e,s,r,t),usage:a}}async function executeCallBody(e,t,n,r){try{let n=findStubTarget(e.agentContext.toolStubs,e.toolName);if(n!==void 0){let t=await callToolStubStep(n.scope,{callId:stubCallId(e.session.id,e.session.turn.id,e.callId),tool:n.tool,input:e.input});if(t.kind===`error`)throw Error(t.error);if(t.kind===`stub`)return{output:toolStubOutput(t.outcome),status:`completed`}}let i=resolveWorkflowEntryPoint(e)(e.executeInput??e.input,t),a;if(!isAsyncIterable(i))a=await i;else{let t=i[Symbol.asyncIterator](),n,o=await t.next();for(;o.done!==!0;)n=o.value,await e.owner.send({from:r,kind:`report`,update:o.value}),o=await t.next();a=o.value??n}return{output:toWorkflowOutput(e,a),status:`completed`}}catch(e){return n.interrupted?{output:INTERRUPTED_OUTPUT,status:`completed`}:toFailedOutcome(e,n.runSignal)}}function toWorkflowOutput(e,t){return withToolOutputSerializationError({boundary:`execute`,toolCallId:e.callId,toolName:e.toolName},()=>parseJsonValue(t??null))}function toFailedOutcome(e,t){if(t.aborted){let{reason:e}=t;return{reason:e instanceof Error?e.message:String(e??``),status:`cancelled`}}return{error:normalizeSerializableError(e),status:`failed`}}function createWorkflowBodyRef(e){let t={callId:e.callId,input:e.input,runId:e.runId??getWorkflowMetadata().workflowRunId,sequence:e.session.turn.sequence,stepIndex:e.stepIndex,toolName:e.toolName,turnId:e.session.turn.id};return e.entry.entryPoint===`execute`?t:{...t,taskId:e.entry.taskId}}function resolveWorkflowEntryPoint(e){let t=readRegisteredWorkflow(e.workflowId);if(typeof t!=`function`)throw Error(`Tool "${e.toolName}" is not registered as a workflow in this deployment (${e.workflowId}). The tool was renamed or removed after this run started.`);return t}function createSharedContext(e,t,n){let unavailable=(t,n)=>{throw Error(`ctx.${t} is not available inside a workflow tool; ${n}. Tool "${e.toolName}" runs as a durable workflow body, which only replays deterministic code.`)};return{agent:t,ask:n,getSandbox:()=>unavailable(`getSandbox()`,`pass ctx directly to a "use step" helper to open the session's sandbox`),getToken:()=>unavailable(`getToken()`,`pass ctx directly to a "use step" helper to resolve credentials`),requireAuth:()=>unavailable(`requireAuth()`,`pass ctx directly to a "use step" helper to request authorization`),to:()=>unavailable(`to()`,`pass ctx directly to a "use step" helper to send to a channel`),channel:workflowToolChannel(e.agentContext),toolName:e.toolName}}function workflowToolChannel(e){let t=e.channelMetadata;return{continuationToken:e.continuationToken,kind:normalizeInstrumentationChannelKind(t?.kind),metadata:t?.metadata??{}}}function createAgentsView(e){return Object.freeze(Object.fromEntries(Object.entries(e.agents).map(([e,t])=>[e,Object.freeze({...t})])))}function createCallContext(e,t,n){let r={...createSharedContext(e,n,(e,t)=>ask(r,e,t)),abortSignal:t.abortSignal,agents:createAgentsView(e.agentContext),callId:e.callId,session:e.session};return r}function isAsyncIterable(e){return typeof e==`object`&&!!e&&typeof e[Symbol.asyncIterator]==`function`}var WorkflowToolRunCancelledError=class extends Error{constructor(e){super(e),this.name=`WorkflowToolRunCancelledError`}},WorkflowToolRunInterruptedError=class extends Error{constructor(){super(`A new message arrived while the turn waited on this call.`),this.name=`WorkflowToolRunInterruptedError`}};export{WorkflowToolRunCancelledError,WorkflowToolRunInterruptedError,createAgentsView,createSharedContext,createWorkflowBodyRef,resolveWorkflowEntryPoint,startCallBody,toFailedOutcome,toWorkflowOutput,workflowToolChannel};
@@ -1,4 +1,5 @@
1
1
  import type { SessionContext } from "#context/session-context.js";
2
+ import type { InstrumentationChannel } from "#shared/instrumentation-channel.js";
2
3
  import type { AgentSessionBundle } from "#execution/agent-sessions/context.js";
3
4
  import type { AuthorizationResult, AuthorizationSignal } from "#harness/authorization.js";
4
5
  import type { SandboxState } from "#sandbox/state.js";
@@ -15,6 +16,10 @@ export interface WorkflowStepContext {
15
16
  readonly token: string;
16
17
  readonly authorizationResults: readonly WorkflowStepAuthorizationResult[];
17
18
  readonly sandbox: WorkflowStepSandbox;
19
+ /** Whether a parent, local or remote, delegated the calling session, which `ctx.to()` refuses. */
20
+ readonly delegated: boolean;
21
+ /** The calling session's channel, which `ctx.channel` holds. */
22
+ readonly channel: InstrumentationChannel;
18
23
  }
19
24
  /** Where `ctx.getSandbox()` finds the calling session's sandbox: its agent and sandbox key. */
20
25
  export interface WorkflowStepSandbox {
@@ -1 +1 @@
1
- import{createLogger,logError}from"#internal/logging.js";import{ContextContainer,contextStorage}from"#context/container.js";import{AuthKey,InitiatorAuthKey,SandboxKey,SessionIdKey,SessionKey}from"#context/keys.js";import{ensureSandboxAccess}from"#execution/sandbox/ensure.js";import{resolveDurableCompiledArtifactsSource}from"#runtime/durable-compiled-artifacts-source.js";import{getStepMetadata}from"#compiled/@workflow/core/index.js";import{resolveWorkflowCallbackBaseUrl}from"#execution/workflow-callback-url.js";import{getCompiledRuntimeAgentBundle}from"#runtime/sessions/compiled-agent-cache.js";import{isConnectionAuthorizationFailedError}from"#connections/errors.js";import{AuthorizationHookKey,CallbackBaseUrlKey,PendingAuthorizationResultKey,isAuthorizationSignal}from"#harness/authorization.js";import{buildBaseToolContext}from"#context/build-base-tool-context.js";import{createAuthorizationContext}from"#runtime/authorization-context.js";import{completeWorkflowStepAuthorization}from"#execution/tools/workflow/authorization-completion.js";import"#execution/tools/workflow/step-context.js";const log=createLogger(`workflow-step`);function withWorkflowStepAuthorization(e){let wrapped=async function(t){let{args:n,context:r}=t;getStepMetadata();let i=new ContextContainer;i.set(AuthKey,r.session.auth.current),i.set(InitiatorAuthKey,r.session.auth.initiator),i.set(SessionIdKey,r.session.id),i.setVirtualContext(SessionKey,{...r.session,sessionId:r.session.id}),i.set(CallbackBaseUrlKey,resolveWorkflowCallbackBaseUrl(r.baseUrl)),i.setVirtualContext(AuthorizationHookKey,r.token),i.setVirtualContext(PendingAuthorizationResultKey,r.authorizationResults);let a=openStepSandbox(r);return contextStorage.run(i,async()=>{let o=createAuthorizationContext({scope:r.toolName,completeAuthorization:completeWorkflowStepAuthorization}),s=buildBaseToolContext({toolName:r.toolName,options:{abortSignal:r.abortSignal,toolCallId:r.callId}}),c={...s,agent:()=>unavailableInStep(`ctx.agent()`,`Call ctx.agent() in the workflow body.`),ask:()=>unavailableInStep(`ctx.ask()`,`Call ctx.ask() in the workflow body.`),getSandbox:(async e=>{let t=await a.open();if(e!==void 0&&t.environment?.provider!==e.provider)throw fatal(`ctx.getSandbox() in a "use step" function received a sandbox environment the session's sandbox does not use. Pass the environment the agent's sandbox definition opens, or call ctx.getSandbox() without one.`);return i.setVirtualContext(SandboxKey,t),await s.getSandbox()}),getToken:o.getToken,requireAuth:o.requireAuth};Object.defineProperty(c,"agents",{get:()=>unavailableInStep(`ctx.agents`,`Read ctx.agents in the workflow body and pass the required serializable metadata into the step.`)});let l;try{l=await o.run(()=>Reflect.apply(e,this,n.map((e,n)=>t.contextIndexes.includes(n)?c:e)))}catch(e){throw isConnectionAuthorizationFailedError(e)&&!e.retryable&&Object.assign(e,{fatal:!0}),e}finally{await a.release()}let u=i.get(PendingAuthorizationResultKey)??[],d=r.authorizationResults.filter(e=>!u.includes(e)).map(e=>e.attemptId);return isAuthorizationSignal(l)?{kind:`authorization-required`,signal:l,authorized:d}:{kind:`result`,output:l,authorized:d}})};return Object.defineProperty(wrapped,"maxRetries",{get:()=>Reflect.get(e,`maxRetries`)}),wrapped}function openStepSandbox(e){let{bundle:t,sessionId:n,state:r}=e.sandbox,i=contextStorage.getStore(),resolveSource=()=>resolveDurableCompiledArtifactsSource(t.source),a,o=!1,open=async()=>{let e=await getCompiledRuntimeAgentBundle({compiledArtifactsSource:i===void 0?resolveSource():contextStorage.run(i,resolveSource),nodeId:t.nodeId}),a=e.graph.root;return await ensureSandboxAccess({compiledArtifactsSource:e.compiledArtifactsSource,nodeId:a.nodeId,ownsSandbox:!1,registry:a.sandboxRegistry,sessionId:n,state:r??null,shutdownTracking:`none`})},openOnce=()=>(a??=open().catch(e=>{throw a=void 0,e}),a);return{async open(){if(o)throw fatal(`ctx.getSandbox() was called after the "use step" function of tool "${e.toolName}" returned. Call it inside the step, which lets go of the sandbox when it ends.`);return{...await openOnce(),delete:()=>unavailableInStep(`sandbox.delete()`,`The step borrows the session's sandbox, and only the session can delete it.`),stop:()=>unavailableInStep(`sandbox.stop()`,`The session's turns may be using the sandbox; eve closes the step's connection when the step ends.`)}},async release(){o=!0;let t=await a?.catch(()=>void 0);try{await t?.release()}catch(t){logError(log,`failed to release a workflow step's sandbox`,t,{sessionId:n,toolName:e.toolName})}}}}function unavailableInStep(e,t){throw fatal(`${e} is unavailable inside a "use step" function. ${t}`)}function fatal(e){return Object.assign(Error(e),{fatal:!0})}export{withWorkflowStepAuthorization};
1
+ import{createLogger,logError}from"#internal/logging.js";import{ContextContainer,contextStorage}from"#context/container.js";import{AuthKey,InitiatorAuthKey,SandboxKey,SessionIdKey,SessionKey}from"#context/keys.js";import{ensureSandboxAccess}from"#execution/sandbox/ensure.js";import{resolveDurableCompiledArtifactsSource}from"#runtime/durable-compiled-artifacts-source.js";import{getStepMetadata}from"#compiled/@workflow/core/index.js";import{resolveWorkflowCallbackBaseUrl}from"#execution/workflow-callback-url.js";import{getCompiledRuntimeAgentBundle}from"#runtime/sessions/compiled-agent-cache.js";import{isConnectionAuthorizationFailedError}from"#connections/errors.js";import{AuthorizationHookKey,CallbackBaseUrlKey,PendingAuthorizationResultKey,isAuthorizationSignal}from"#harness/authorization.js";import{createToolChannelTo}from"#execution/tools/channel-to.js";import{buildBaseToolContext}from"#context/build-base-tool-context.js";import{createAuthorizationContext}from"#runtime/authorization-context.js";import{completeWorkflowStepAuthorization}from"#execution/tools/workflow/authorization-completion.js";import"#execution/tools/workflow/step-context.js";const log=createLogger(`workflow-step`);function withWorkflowStepAuthorization(e){let wrapped=async function(t){let{args:n,context:r}=t;getStepMetadata();let i=new ContextContainer;i.set(AuthKey,r.session.auth.current),i.set(InitiatorAuthKey,r.session.auth.initiator),i.set(SessionIdKey,r.session.id),i.setVirtualContext(SessionKey,{...r.session,sessionId:r.session.id}),i.set(CallbackBaseUrlKey,resolveWorkflowCallbackBaseUrl(r.baseUrl)),i.setVirtualContext(AuthorizationHookKey,r.token),i.setVirtualContext(PendingAuthorizationResultKey,r.authorizationResults);let a=stepAgentLoader(r),o=openStepSandbox(r,a);return contextStorage.run(i,async()=>{let s=createAuthorizationContext({scope:r.toolName,completeAuthorization:completeWorkflowStepAuthorization}),c=buildBaseToolContext({toolName:r.toolName,options:{abortSignal:r.abortSignal,toolCallId:r.callId}}),l={...c,agent:()=>unavailableInStep(`ctx.agent()`,`Call ctx.agent() in the workflow body.`),ask:()=>unavailableInStep(`ctx.ask()`,`Call ctx.ask() in the workflow body.`),getSandbox:(async e=>{let t=await o.open();if(e!==void 0&&t.environment?.provider!==e.provider)throw fatal(`ctx.getSandbox() in a "use step" function received a sandbox environment the session's sandbox does not use. Pass the environment the agent's sandbox definition opens, or call ctx.getSandbox() without one.`);return i.setVirtualContext(SandboxKey,t),await c.getSandbox()}),getToken:s.getToken,requireAuth:s.requireAuth,channel:r.channel,to:createToolChannelTo({delegated:r.delegated,loadBundle:a})};Object.defineProperty(l,"agents",{get:()=>unavailableInStep(`ctx.agents`,`Read ctx.agents in the workflow body and pass the required serializable metadata into the step.`)});let u;try{u=await s.run(()=>Reflect.apply(e,this,n.map((e,n)=>t.contextIndexes.includes(n)?l:e)))}catch(e){throw isConnectionAuthorizationFailedError(e)&&!e.retryable&&Object.assign(e,{fatal:!0}),e}finally{await o.release()}let d=i.get(PendingAuthorizationResultKey)??[],f=r.authorizationResults.filter(e=>!d.includes(e)).map(e=>e.attemptId);return isAuthorizationSignal(u)?{kind:`authorization-required`,signal:u,authorized:f}:{kind:`result`,output:u,authorized:f}})};return Object.defineProperty(wrapped,"maxRetries",{get:()=>Reflect.get(e,`maxRetries`)}),wrapped}function stepAgentLoader(e){let{bundle:t}=e.sandbox,n=contextStorage.getStore(),resolveSource=()=>resolveDurableCompiledArtifactsSource(t.source);return async()=>await getCompiledRuntimeAgentBundle({compiledArtifactsSource:n===void 0?resolveSource():contextStorage.run(n,resolveSource),nodeId:t.nodeId})}function openStepSandbox(e,t){let{sessionId:n,state:r}=e.sandbox,i,a=!1,open=async()=>{let e=await t(),i=e.graph.root;return await ensureSandboxAccess({compiledArtifactsSource:e.compiledArtifactsSource,nodeId:i.nodeId,ownsSandbox:!1,registry:i.sandboxRegistry,sessionId:n,state:r??null,shutdownTracking:`none`})},openOnce=()=>(i??=open().catch(e=>{throw i=void 0,e}),i);return{async open(){if(a)throw fatal(`ctx.getSandbox() was called after the "use step" function of tool "${e.toolName}" returned. Call it inside the step, which lets go of the sandbox when it ends.`);return{...await openOnce(),delete:()=>unavailableInStep(`sandbox.delete()`,`The step borrows the session's sandbox, and only the session can delete it.`),stop:()=>unavailableInStep(`sandbox.stop()`,`The session's turns may be using the sandbox; eve closes the step's connection when the step ends.`)}},async release(){a=!0;let t=await i?.catch(()=>void 0);try{await t?.release()}catch(t){logError(log,`failed to release a workflow step's sandbox`,t,{sessionId:n,toolName:e.toolName})}}}}function unavailableInStep(e,t){throw fatal(`${e} is unavailable inside a "use step" function. ${t}`)}function fatal(e){return Object.assign(Error(e),{fatal:!0})}export{withWorkflowStepAuthorization};
@@ -1 +1 @@
1
- import{createHook,getWorkflowMetadata}from"#compiled/@workflow/core/index.js";import{disposeHook}from"#execution/hook-ownership.js";import{findWorkflowToolRunContext}from"#execution/tools/workflow/ask.js";import{signInInteractionId,signInOpened}from"#harness/interaction-facts.js";function workflowToolStep(e,t){return new Proxy(e,{apply(e,n,r){let i=findWorkflowContextArgument(r);return i===void 0?Reflect.apply(e,n,r):executeAuthorizedStep(t,n,r,i)}})}function findWorkflowContextArgument(e){for(let t of e){let e=findWorkflowToolRunContext(t);if(e!==void 0)return{ctx:t,run:e}}}async function executeAuthorizedStep(e,t,n,r){let{ctx:i,run:a}=r,o=[],s=new Map;for(;;){let r=createHook();try{let c;try{c=await invokeAuthorizedStep({args:n,authorizationResults:o,callbackToken:r.token,ctx:i,execute:e,receiver:t,run:a})}catch(e){throw i.abortSignal.aborted||await reportPendingAsFailed(a,i.abortSignal,s),e}if(await reconcileCompletedAuthorizations(a,i.abortSignal,s,o,c.authorized),c.kind===`result`)return await reportPendingAsFailed(a,i.abortSignal,s),c.output;await collectAuthorizationCallbacks({authorizationResults:o,callback:r,challenges:c.signal.challenges,ctx:i,pending:s,run:a})}finally{await disposeHook(r)}}}async function invokeAuthorizedStep(e){let{args:t,authorizationResults:n,callbackToken:r,ctx:i,execute:a,receiver:o,run:s}=e,c={callId:i.callId,toolName:i.toolName,session:i.session,abortSignal:i.abortSignal,baseUrl:getWorkflowMetadata().url,token:r,authorizationResults:n,sandbox:{bundle:s.agentContext.bundle,sessionId:s.agentContext.sandbox.sessionId,state:s.agentContext.sandbox.state}},l={args:t.map(e=>e===i?null:e),context:c,contextIndexes:t.flatMap((e,t)=>e===i?[t]:[])};return await a.call(o,l)}async function reconcileCompletedAuthorizations(e,t,n,r,i){let a=new Set(i);for(let r of a){let i=n.get(r);i!==void 0&&await reportAuthorization(e,t,i,`accepted`),n.delete(r)}for(let e=r.length-1;e>=0;e--){let t=r[e];t!==void 0&&a.has(t.attemptId)&&r.splice(e,1)}}async function collectAuthorizationCallbacks(e){let{authorizationResults:t,callback:n,challenges:r,ctx:i,pending:a,run:o}=e;for(let e of r){let r=requireAttemptId(e);a.set(r.attemptId,r),await reportAuthorization(o,i.abortSignal,r);try{let e=await waitForCallback(n,r,i.abortSignal);t.push({name:r.name,instanceId:r.instanceId,attemptId:r.attemptId,hookUrl:r.hookUrl,principal:r.principal,resume:r.resume,callback:e})}catch(e){throw i.abortSignal.aborted||await reportAuthorization(o,i.abortSignal,r,`failed`),e}}}function requireAttemptId(e){if(e.attemptId===void 0)throw Error(`Workflow authorization challenge "${e.name}" has no attempt id.`);return e}async function reportPendingAsFailed(e,t,n){for(let r of n.values())await reportAuthorization(e,t,r,`failed`)}async function reportAuthorization(e,t,n,r){let i=runSignIn(e.from,n,r),a=createHook();try{await a.getConflict(),await withAbort(e.owner.send({kind:`request`,from:e.from,replyTo:a.token,request:{kind:`relay`,event:{kind:`subagent-interaction`,callId:e.from.callId,childSessionId:e.from.runId,subagentName:e.from.toolName,events:[i]}}}),t),await withAbort(a,t)}finally{await disposeHook(a)}}async function waitForCallback(e,t,n){let r=e[Symbol.asyncIterator]();for(;;){let e=await withAbort(r.next(),n);if(e.done)throw Error(`Authorization callback closed before sign-in completed.`);let i=readCallback(e.value,t);if(i!==void 0)return i}}async function withAbort(e,t){let abort,n=new Promise((e,n)=>{abort=()=>n(t.reason??Error(`Workflow authorization cancelled.`)),t.addEventListener(`abort`,abort,{once:!0}),t.aborted&&abort()});try{return await Promise.race([e,n])}finally{t.removeEventListener(`abort`,abort)}}function readCallback(e,t){if(typeof e==`object`&&e&&`payloads`in e&&Array.isArray(e.payloads))for(let n of e.payloads){let e=n?.authorizationCallback;if(e?.attemptId!==t.attemptId||e?.connectionName!==t.name)continue;let r=e.callback;if(!(typeof r?.method!=`string`||typeof r.params!=`object`||r.params===null||Array.isArray(r.params))&&Object.values(r.params).every(e=>typeof e==`string`)&&(r.body===void 0||typeof r.body==`string`))return r}}function runSignIn(e,t,n){return n===void 0?{data:signInOpened(t,{prompt:`Sign in to ${t.name} to continue.`,subject:e.taskId===void 0?{turnId:e.turnId}:{taskId:e.taskId}}).data,type:`interaction.opened`}:{data:{interactionId:signInInteractionId(t),outcome:n},type:`interaction.settled`}}export{workflowToolStep};
1
+ import{createHook,getWorkflowMetadata}from"#compiled/@workflow/core/index.js";import{disposeHook}from"#execution/hook-ownership.js";import{findWorkflowToolRunContext}from"#execution/tools/workflow/ask.js";import{workflowToolChannel}from"#execution/tools/workflow/body.js";import{signInInteractionId,signInOpened}from"#harness/interaction-facts.js";function workflowToolStep(e,t){return new Proxy(e,{apply(e,n,r){let i=findWorkflowContextArgument(r);return i===void 0?Reflect.apply(e,n,r):executeAuthorizedStep(t,n,r,i)}})}function findWorkflowContextArgument(e){for(let t of e){let e=findWorkflowToolRunContext(t);if(e!==void 0)return{ctx:t,run:e}}}async function executeAuthorizedStep(e,t,n,r){let{ctx:i,run:a}=r,o=[],s=new Map;for(;;){let r=createHook();try{let c;try{c=await invokeAuthorizedStep({args:n,authorizationResults:o,callbackToken:r.token,ctx:i,execute:e,receiver:t,run:a})}catch(e){throw i.abortSignal.aborted||await reportPendingAsFailed(a,i.abortSignal,s),e}if(await reconcileCompletedAuthorizations(a,i.abortSignal,s,o,c.authorized),c.kind===`result`)return await reportPendingAsFailed(a,i.abortSignal,s),c.output;await collectAuthorizationCallbacks({authorizationResults:o,callback:r,challenges:c.signal.challenges,ctx:i,pending:s,run:a})}finally{await disposeHook(r)}}}async function invokeAuthorizedStep(e){let{args:t,authorizationResults:n,callbackToken:r,ctx:i,execute:a,receiver:o,run:s}=e,c={callId:i.callId,toolName:i.toolName,session:i.session,abortSignal:i.abortSignal,baseUrl:getWorkflowMetadata().url,token:r,authorizationResults:n,delegated:s.agentContext.delegated===!0,channel:workflowToolChannel(s.agentContext),sandbox:{bundle:s.agentContext.bundle,sessionId:s.agentContext.sandbox.sessionId,state:s.agentContext.sandbox.state}},l={args:t.map(e=>e===i?null:e),context:c,contextIndexes:t.flatMap((e,t)=>e===i?[t]:[])};return await a.call(o,l)}async function reconcileCompletedAuthorizations(e,t,n,r,i){let a=new Set(i);for(let r of a){let i=n.get(r);i!==void 0&&await reportAuthorization(e,t,i,`accepted`),n.delete(r)}for(let e=r.length-1;e>=0;e--){let t=r[e];t!==void 0&&a.has(t.attemptId)&&r.splice(e,1)}}async function collectAuthorizationCallbacks(e){let{authorizationResults:t,callback:n,challenges:r,ctx:i,pending:a,run:o}=e;for(let e of r){let r=requireAttemptId(e);a.set(r.attemptId,r),await reportAuthorization(o,i.abortSignal,r);try{let e=await waitForCallback(n,r,i.abortSignal);t.push({name:r.name,instanceId:r.instanceId,attemptId:r.attemptId,hookUrl:r.hookUrl,principal:r.principal,resume:r.resume,callback:e})}catch(e){throw i.abortSignal.aborted||await reportAuthorization(o,i.abortSignal,r,`failed`),e}}}function requireAttemptId(e){if(e.attemptId===void 0)throw Error(`Workflow authorization challenge "${e.name}" has no attempt id.`);return e}async function reportPendingAsFailed(e,t,n){for(let r of n.values())await reportAuthorization(e,t,r,`failed`)}async function reportAuthorization(e,t,n,r){let i=runSignIn(e.from,n,r),a=createHook();try{await a.getConflict(),await withAbort(e.owner.send({kind:`request`,from:e.from,replyTo:a.token,request:{kind:`relay`,event:{kind:`subagent-interaction`,callId:e.from.callId,childSessionId:e.from.runId,subagentName:e.from.toolName,events:[i]}}}),t),await withAbort(a,t)}finally{await disposeHook(a)}}async function waitForCallback(e,t,n){let r=e[Symbol.asyncIterator]();for(;;){let e=await withAbort(r.next(),n);if(e.done)throw Error(`Authorization callback closed before sign-in completed.`);let i=readCallback(e.value,t);if(i!==void 0)return i}}async function withAbort(e,t){let abort,n=new Promise((e,n)=>{abort=()=>n(t.reason??Error(`Workflow authorization cancelled.`)),t.addEventListener(`abort`,abort,{once:!0}),t.aborted&&abort()});try{return await Promise.race([e,n])}finally{t.removeEventListener(`abort`,abort)}}function readCallback(e,t){if(typeof e==`object`&&e&&`payloads`in e&&Array.isArray(e.payloads))for(let n of e.payloads){let e=n?.authorizationCallback;if(e?.attemptId!==t.attemptId||e?.connectionName!==t.name)continue;let r=e.callback;if(!(typeof r?.method!=`string`||typeof r.params!=`object`||r.params===null||Array.isArray(r.params))&&Object.values(r.params).every(e=>typeof e==`string`)&&(r.body===void 0||typeof r.body==`string`))return r}}function runSignIn(e,t,n){return n===void 0?{data:signInOpened(t,{prompt:`Sign in to ${t.name} to continue.`,subject:e.taskId===void 0?{turnId:e.turnId}:{taskId:e.taskId}}).data,type:`interaction.opened`}:{data:{interactionId:signInInteractionId(t),outcome:n},type:`interaction.settled`}}export{workflowToolStep};
@@ -32,8 +32,7 @@ export declare function createBrowserCallbackUrl(baseUrl: string, callbackPath:
32
32
  /**
33
33
  * Builds a framework-owned callback URL for server-to-server delivery.
34
34
  *
35
- * Unlike {@link createBrowserCallbackUrl}, it carries the deployment's
36
- * Protection Bypass for Automation secret so the caller can reach a
37
- * protected deployment.
35
+ * The URL carries only the callback's scoped capability. Deployment protection
36
+ * credentials belong to the delivering deployment's trusted-origin transport.
38
37
  */
39
38
  export declare function createWorkflowCallbackUrl(baseUrl: string, callbackPath: string): string;
@@ -1 +1 @@
1
- import{joinEveRoutePath}from"#shared/eve-route-path.js";import{EVE_PUBLIC_ROUTE_PREFIX_ENV,normalizePublicRoutePrefix}from"#shared/public-route-prefix.js";function resolveVercelProductionCallbackBaseUrl(){return process.env.VERCEL_ENV===`production`&&process.env.VERCEL_PROJECT_PRODUCTION_URL?`https://${process.env.VERCEL_PROJECT_PRODUCTION_URL}`:null}function resolveWorkflowCallbackBaseUrl(e){let t=process.env.WORKFLOW_LOCAL_BASE_URL?.trim()||void 0,n=(resolveVercelProductionCallbackBaseUrl()??t??e).replace(/\/$/,``),r=normalizePublicRoutePrefix(process.env[EVE_PUBLIC_ROUTE_PREFIX_ENV]);return r===void 0?n:`${n}${r}`}function createBrowserCallbackUrl(e,t){let n=new URL(t,`http://eve.local`),r=new URL(e);return r.pathname=joinEveRoutePath(r.pathname,n.pathname),r.search=n.search,r.toString()}function createWorkflowCallbackUrl(e,t){let n=new URL(createBrowserCallbackUrl(e,t)),r=process.env.VERCEL_AUTOMATION_BYPASS_SECRET?.trim();return r&&n.searchParams.set(`x-vercel-protection-bypass`,r),n.toString()}export{createBrowserCallbackUrl,createWorkflowCallbackUrl,resolveVercelProductionCallbackBaseUrl,resolveWorkflowCallbackBaseUrl};
1
+ import{joinEveRoutePath}from"#shared/eve-route-path.js";import{EVE_PUBLIC_ROUTE_PREFIX_ENV,normalizePublicRoutePrefix}from"#shared/public-route-prefix.js";function resolveVercelProductionCallbackBaseUrl(){return process.env.VERCEL_ENV===`production`&&process.env.VERCEL_PROJECT_PRODUCTION_URL?`https://${process.env.VERCEL_PROJECT_PRODUCTION_URL}`:null}function resolveWorkflowCallbackBaseUrl(e){let t=process.env.WORKFLOW_LOCAL_BASE_URL?.trim()||void 0,n=(resolveVercelProductionCallbackBaseUrl()??t??e).replace(/\/$/,``),r=normalizePublicRoutePrefix(process.env[EVE_PUBLIC_ROUTE_PREFIX_ENV]);return r===void 0?n:`${n}${r}`}function createBrowserCallbackUrl(e,t){let n=new URL(t,`http://eve.local`),r=new URL(e);return r.pathname=joinEveRoutePath(r.pathname,n.pathname),r.search=n.search,r.toString()}function createWorkflowCallbackUrl(e,t){return createBrowserCallbackUrl(e,t)}export{createBrowserCallbackUrl,createWorkflowCallbackUrl,resolveVercelProductionCallbackBaseUrl,resolveWorkflowCallbackBaseUrl};
@@ -1 +1 @@
1
- import{createLogger,logError}from"#internal/logging.js";import{validateDeliveryIdempotencyKey}from"#channel/delivery-idempotency.js";import{createChannelDeliveryMetadata}from"#channel/delivery-metadata.js";import{SessionStrandedError,describeStrandedSession}from"#channel/session-stranded-error.js";import{sessionCommandHookToken,sessionInboxHookToken}from"#execution/session-inbox/address.js";import{SessionPredecessorKey}from"#context/keys.js";import{resolveInstalledPackageInfo}from"#internal/application/package.js";import{walkCauseChain}from"#shared/errors.js";import{validateToolStubTargets}from"#tool-stubs/validate-targets.js";import{getHookByToken,getRun,getWorld,start}from"#internal/workflow/runtime.js";import{assertSessionHistoryReadable,readSessionEventHistory,readSessionEventStream,readSessionRecordHistory,readSessionRecords,readSessionStreamTailIndex}from"#execution/session-event-stream.js";import{getCompiledRuntimeAgentBundle}from"#runtime/sessions/compiled-agent-cache.js";import{ROOT_RUNTIME_AGENT_NODE_ID}from"#runtime/graph.js";import{serializeContext}from"#context/serialize.js";import{AcceptedSessionIdentityError,SessionHandoffPendingError,logicalSessionToken,resolveSessionInbox,resumeSessionInbox}from"#execution/session-inbox/resume.js";import{resolveEffectiveAgentRuntime}from"#execution/effective-agent-config.js";import{context,trace}from"#compiled/@opentelemetry/api/index.js";import{EntityConflictError,HookNotFoundError,RunExpiredError,WorkflowRunNotFoundError}from"#compiled/@workflow/errors/index.js";import{StrandedSessionOwnerError,assertRunnableSessionInbox,assertRunnableSessionOwner,findSessionHookHolder}from"#execution/session-inbox/owner.js";import{initializeSessionInstrumentation}from"#instrumentation/runtime.js";import{EVE_PREWARM_ATTRIBUTE,EVE_VERSION_ATTRIBUTE,buildSessionAttributes,buildSubagentRootAttributes,readParentLineage}from"#execution/eve-workflow-attributes.js";import{endStrandedSession}from"#execution/session-inbox/end-stranded-session.js";import{SESSION_HOOK_HANDOVER_TIMEOUT_MS,waitForSessionHooksRelease}from"#execution/session-inbox/hook-release.js";import{CONNECTION_EVENT_DELIVERY_WORKFLOW_NAME,CONNECTION_EVENT_WORKFLOW_NAME,SESSION_TIMEOUT_WORKFLOW_NAME,WORKFLOW_ENTRY_NAME,WORKFLOW_TOOL_RUN_WORKFLOW_NAME}from"#execution/stable-workflow-names.js";import{readRemoteChildBinding}from"#execution/child-binding.js";import{prewarmWorkflowSession}from"#execution/session-prewarm.js";import{normalizeEveAttributes}from"#runtime/attributes/normalize.js";import{buildRunContext}from"#execution/runtime-context.js";import{buildInvocationAttributes}from"#internal/invocation/metadata.js";import{isAgentTraceContext}from"#tracing/eve/agent-trace-context.js";const EVE_PACKAGE_INFO=resolveInstalledPackageInfo(),STABLE_ID_BASE=EVE_PACKAGE_INFO.name,log=createLogger(`execution.workflow-runtime`),workflowEntryReference={workflowId:`workflow//${STABLE_ID_BASE}//${WORKFLOW_ENTRY_NAME}`},sessionTimeoutWorkflowReference={workflowId:`workflow//${STABLE_ID_BASE}//${SESSION_TIMEOUT_WORKFLOW_NAME}`},workflowToolRunWorkflowReference={workflowId:`workflow//${STABLE_ID_BASE}//${WORKFLOW_TOOL_RUN_WORKFLOW_NAME}`},connectionEventWorkflowReference={workflowId:`workflow//${STABLE_ID_BASE}//${CONNECTION_EVENT_WORKFLOW_NAME}`},connectionEventDeliveryWorkflowReference={workflowId:`workflow//${STABLE_ID_BASE}//${CONNECTION_EVENT_DELIVERY_WORKFLOW_NAME}`};function createWorkflowRuntime(e){let startSession=async(t,n)=>{validateDeliveryIdempotencyKey(t.idempotencyKey),t.input.message!==void 0&&t.delivery===void 0&&(t={...t,delivery:createChannelDeliveryMetadata({channelKind:t.adapter.kind,channelName:t.channelName??t.adapter.kind,requestId:t.requestId})});let r=t.continuationConflictCommand;r!==void 0&&r.delivery===void 0&&(t={...t,continuationConflictCommand:{...r,delivery:t.delivery}});let i=await getCompiledRuntimeAgentBundle({compiledArtifactsSource:e.compiledArtifactsSource,nodeId:e.nodeId});t.toolStubs!==void 0&&t.toolStubs.rootSessionId===void 0&&validateToolStubTargets(t.toolStubs.rules,i.graph);let a=buildRunContext({agentSessionRuntimeOverrides:e.agentSessionRuntimeOverrides,bundle:i,dynamicSubagentAgentConfig:e.dynamicSubagentAgentConfig,run:t});n!==void 0&&a.set(SessionPredecessorKey,n);let o=resolveEffectiveAgentRuntime(i,a),s=initializeSessionInstrumentation({agentName:o.turnAgent.id,ctx:a}),c=o.limits?.sessionTimeoutMs,l=i.resolvedAgent.config?.experimental?.workflow?.retention??(s.action===`record`&&s.recordInputs&&s.recordOutputs?void 0:0),u=serializeContext(a),d=readParentLineage(u),f={idempotencyKey:t.idempotencyKey,kind:`initial`,input:t.input,ownerDeploymentId:await resolveCurrentWorkflowDeploymentId(),serializedContext:u};t.continuationConflictCommand!==void 0&&(f.continuationConflictCommand=t.continuationConflictCommand),c!==void 0&&(f.sessionTimeoutMs=c),l!==void 0&&(f.retention=l);let p={...d.sessionId===void 0?buildSessionAttributes({serializedContext:u}):buildSubagentRootAttributes({identity:{nodeId:i.nodeId??ROOT_RUNTIME_AGENT_NODE_ID},parentCallId:d.callId,parentSessionId:d.sessionId,parentTurnId:d.turnId,rootSessionId:d.rootSessionId??d.sessionId,serializedContext:u}),[EVE_PREWARM_ATTRIBUTE]:`1`,...t.externalInvocation===void 0?{}:buildInvocationAttributes(t.externalInvocation)},m;try{let e={allowReservedAttributes:!0,attributes:normalizeEveAttributes(p)};l!==void 0&&(e.experimental_retention=l),m=await startWorkflowOnDeployment(workflowEntryReference,[f],f.ownerDeploymentId,e)}catch(e){throw logError(log,`failed to start workflow run`,e,{continuationToken:t.continuationToken}),e}let h=m.runId;if(t.idempotencyKey!==void 0&&t.continuationToken!==void 0){let e=await pollUntil(()=>resolveContinuation(t.continuationToken),SESSION_HOOK_HANDOVER_TIMEOUT_MS);if(e===void 0)throw Error(`Delivery accepted, but its session identity is not ready. Retry with the same idempotencyKey.`);h=e.sessionId}let g,getEvents=()=>(g??=readSessionEventStream(h),g);return{get events(){return getEvents()},sessionId:h,...t.delivery!==void 0&&{deliveryId:t.delivery.deliveryId}}};return{async createSession(e){return await startSession(e)},async dispatchContinuation(e){let{continuationToken:t,successor:n}=e,r=identifyCommand(e.command);try{return await dispatchWorkflowCommand(t,r)}catch(e){if(!(e instanceof StrandedSessionOwnerError))throw e;if(r.kind!==`send`||n===void 0)return await settleStrandedCommand(t,r,e);if((r.payload.answers?.length??0)>0)throw sessionStrandedError(e,`Its pending requests can no longer be answered; send a new message to start a fresh session.`);let i=await endStrandedSession(e,t,`message`);return{sessionId:(await startSession({...n,delivery:r.delivery},{sessionId:i})).sessionId,deliveryId:r.delivery?.deliveryId,status:`accepted`}}},async dispatchSession(e){return await dispatchWorkflowSessionCommand(e)},async getEventStream(e,t){return t?.follow===!1?readSessionEventHistory(e,t.startIndex,t.signal):(await assertFollowableSession(e),readSessionEventStream(e,t?.startIndex,t?.signal))},async getLineStream(e,t){return t?.follow===!1?readSessionRecordHistory(e,t.startIndex):(await assertFollowableSession(e),readSessionRecords(e,t?.startIndex))},async getStreamTailIndex(e){return await readSessionStreamTailIndex(e)},async readChildBinding(e,t){return await readRemoteChildBinding(e,t)},async hasRunnableOwner(e){let t=sessionInboxHookToken(sessionCommandHookToken(e)),n=await findSessionHookHolder(t);if(n===void 0)return!1;try{return await assertRunnableSessionOwner(n),!0}catch(e){if(e instanceof StrandedSessionOwnerError)return!1;throw e}},resolveContinuation}}async function dispatchWorkflowCommand(e,t){if(t.kind===`prewarm`)return typeof e==`string`?{status:`unsupported`}:await prewarmWorkflowSession(e.sessionId,t.targetDeploymentId);let n,r;try{let i=await resumeSessionInbox(e,t);r=i.inbox,n={runId:i.ownerRunId,sessionId:await i.sessionId}}catch(n){if(n instanceof StrandedSessionOwnerError)throw n;let r=t.kind===`send`&&typeof e!=`string`,i={status:`session_not_active`,retryable:!0};if(n instanceof SessionHandoffPendingError){if(r)return i;throw n}if(isInactiveCommandTarget(n))return r&&await isRunActive(e.sessionId)?i:inactiveCommandResult(t);throw logError(log,`failed to dispatch session command`,n,{command:t.kind,token:e}),n}t.kind===`reset`&&await waitForSessionHooksRelease([sessionCommandHookToken(n.sessionId),logicalSessionToken(e)],{ownerRunId:n.runId,sessionId:n.sessionId});let i=activeCommandResult(t,n.sessionId);return i.status===`accepted`?{...i,inbox:r}:i}async function settleStrandedCommand(e,t,n){switch(t.kind){case`reset`:return{previousSessionId:await endStrandedSession(n,e,`reset`,t),status:`reset`};case`send`:case`clear`:throw sessionStrandedError(n);default:return inactiveCommandResult(t)}}async function assertFollowableSession(e){try{await Promise.all([assertRunnableSessionInbox(sessionInboxHookToken(sessionCommandHookToken(e))),assertSessionHistoryReadable(e)])}catch(e){throw e instanceof StrandedSessionOwnerError?sessionStrandedError(e):e}}function sessionStrandedError(e,t){let n=e.eveVersion===void 0?{}:{eveVersion:e.eveVersion};return new SessionStrandedError(n,describeStrandedSession(n,t))}function activeCommandResult(e,t){return e.kind===`reset`?{previousSessionId:t,status:`reset`}:e.kind===`send`&&e.delivery!==void 0?{sessionId:t,status:`accepted`,deliveryId:e.delivery.deliveryId}:{sessionId:t,status:`accepted`}}function inactiveCommandResult(e){return e.kind===`send`?{status:`session_not_active`}:e.kind===`cancel`?{status:`no_active_turn`}:{status:`no_active_session`}}async function dispatchWorkflowSessionCommand(e){let t={sessionId:e.sessionId,inbox:e.inbox},n=identifyCommand(e.command);try{return await dispatchWorkflowCommand(t,n)}catch(e){if(!(e instanceof StrandedSessionOwnerError))throw e;return await settleStrandedCommand(t,n,e)}}async function isRunActive(e){try{let t=await getRun(e).status;return t===`pending`||t===`running`}catch(e){if(isInactiveCommandTarget(e))return!1;throw e}}function isInactiveCommandTarget(e){if(e instanceof AcceptedSessionIdentityError)return!1;if(HookNotFoundError.is(e))return!0;for(let t of walkCauseChain(e))if(WorkflowRunNotFoundError.is(t)||RunExpiredError.is(t)||EntityConflictError.is(t))return!0;return!1}async function resolveContinuation(e,t){let n;try{n=await resolveSessionInbox(e)}catch(t){if(HookNotFoundError.is(t))return;throw logError(log,`failed to resolve session by continuation token`,t,{continuationToken:e}),t}if(t?.runnable!==!0)return n;try{await assertRunnableSessionInbox(sessionInboxHookToken(sessionCommandHookToken(n.sessionId)))}catch(e){throw e instanceof StrandedSessionOwnerError?sessionStrandedError(e):e}return n}async function waitForCommandHookOwner(e){let t=await pollUntil(async()=>{try{return normalizeWorkflowHook(await getHookByToken(e))}catch(e){if(!HookNotFoundError.is(e))throw e;return}},SESSION_HOOK_HANDOVER_TIMEOUT_MS);if(t===void 0)throw new HookNotFoundError(e);return t}async function waitForSessionInbox(e){let t=sessionInboxHookToken(sessionCommandHookToken(e)),n=await pollUntil(async()=>await findSessionHookHolder(t)!==void 0||!await hasRunEnded(e)&&void 0,SESSION_HOOK_HANDOVER_TIMEOUT_MS);if(n===void 0)throw Error(`Session "${e}" did not start taking commands within ${SESSION_HOOK_HANDOVER_TIMEOUT_MS/1e3} seconds.`);return n}async function pollUntil(e,t){let n=Date.now()+t;for(let t=20;;t=Math.min(t*2,200)){let r=await e();if(r!==void 0||Date.now()>=n)return r;await new Promise(e=>setTimeout(e,t))}}async function hasRunEnded(e){try{let t=await getRun(e).status;return t!==`pending`&&t!==`running`}catch(e){for(let t of walkCauseChain(e))if(WorkflowRunNotFoundError.is(t))return!1;if(isInactiveCommandTarget(e))return!0;throw e}}async function startWorkflowOnCurrentDeployment(e,t,n){return await startWorkflowOnDeployment(e,t,await resolveCurrentWorkflowDeploymentId(),n)}async function startWorkflowOnDeployment(e,t,n,r){return await withWorkflowStartContext(async()=>{if(n.length===0||n===`latest`)throw Error(`Workflow starts require an exact deployment id.`);return await start(e,t,{...r,allowReservedAttributes:!0,attributes:{...r?.attributes,[EVE_VERSION_ATTRIBUTE]:EVE_PACKAGE_INFO.version},deploymentId:n})})}async function resolveCurrentWorkflowDeploymentId(){let e=process.env.VERCEL_DEPLOYMENT_ID?.trim()||await(await getWorld()).getDeploymentId();if(e.length===0||e===`latest`)throw Error(`Workflow runtime could not resolve an exact deployment id.`);return e}async function withWorkflowStartContext(e){let t=context.active(),n=isAgentTraceContext(t)?trace.deleteSpan(t):t;return await context.with(n,e)}function normalizeWorkflowHook(e){if(typeof e!=`object`||!e||!(`runId`in e))throw Error(`Workflow hook did not include a run id.`);let t=e.runId;if(typeof t!=`string`||t.length===0)throw Error(`Workflow hook did not include a run id.`);return{runId:t}}function identifyCommand(e){if(e.kind!==`send`||e.delivery!==void 0)return e;let t=e.caller===void 0?e.schedule===void 0?`http`:`schedule`:`subagent`;return{...e,delivery:createChannelDeliveryMetadata({channelKind:t,channelName:t,requestId:e.requestId})}}export{connectionEventDeliveryWorkflowReference,connectionEventWorkflowReference,createWorkflowRuntime,dispatchWorkflowSessionCommand,hasRunEnded,pollUntil,resolveContinuation,sessionTimeoutWorkflowReference,startWorkflowOnCurrentDeployment,startWorkflowOnDeployment,waitForCommandHookOwner,waitForSessionInbox,workflowEntryReference,workflowToolRunWorkflowReference};
1
+ import{createLogger}from"#internal/logging.js";import{validateDeliveryIdempotencyKey}from"#channel/delivery-idempotency.js";import{createChannelDeliveryMetadata}from"#channel/delivery-metadata.js";import{SessionStrandedError,describeStrandedSession}from"#channel/session-stranded-error.js";import{sessionCommandHookToken,sessionInboxHookToken}from"#execution/session-inbox/address.js";import{SessionPredecessorKey}from"#context/keys.js";import{resolveInstalledPackageInfo}from"#internal/application/package.js";import{walkCauseChain}from"#shared/errors.js";import{validateToolStubTargets}from"#tool-stubs/validate-targets.js";import{getHookByToken,getRun,getWorld,start}from"#internal/workflow/runtime.js";import{assertSessionHistoryReadable,readSessionEventHistory,readSessionEventStream,readSessionRecordHistory,readSessionRecords,readSessionStreamTailIndex}from"#execution/session-event-stream.js";import{getCompiledRuntimeAgentBundle}from"#runtime/sessions/compiled-agent-cache.js";import{ROOT_RUNTIME_AGENT_NODE_ID}from"#runtime/graph.js";import{serializeContext}from"#context/serialize.js";import{AcceptedSessionIdentityError,SessionHandoffPendingError,logicalSessionToken,resolveSessionInbox,resumeSessionInbox}from"#execution/session-inbox/resume.js";import{resolveEffectiveAgentRuntime}from"#execution/effective-agent-config.js";import{context,trace}from"#compiled/@opentelemetry/api/index.js";import{EntityConflictError,HookNotFoundError,RunExpiredError,WorkflowRunNotFoundError}from"#compiled/@workflow/errors/index.js";import{StrandedSessionOwnerError,assertRunnableSessionInbox,assertRunnableSessionOwner,findSessionHookHolder}from"#execution/session-inbox/owner.js";import{initializeSessionInstrumentation}from"#instrumentation/runtime.js";import{EVE_PREWARM_ATTRIBUTE,EVE_VERSION_ATTRIBUTE,buildSessionAttributes,buildSubagentRootAttributes,readParentLineage}from"#execution/eve-workflow-attributes.js";import{endStrandedSession}from"#execution/session-inbox/end-stranded-session.js";import{SESSION_HOOK_HANDOVER_TIMEOUT_MS,waitForSessionHooksRelease}from"#execution/session-inbox/hook-release.js";import{CONNECTION_EVENT_DELIVERY_WORKFLOW_NAME,CONNECTION_EVENT_WORKFLOW_NAME,SESSION_TIMEOUT_WORKFLOW_NAME,WORKFLOW_ENTRY_NAME,WORKFLOW_TOOL_RUN_WORKFLOW_NAME}from"#execution/stable-workflow-names.js";import{readRemoteChildBinding}from"#execution/child-binding.js";import{prewarmWorkflowSession}from"#execution/session-prewarm.js";import{formatCapabilityError}from"#internal/capability-error.js";import{normalizeEveAttributes}from"#runtime/attributes/normalize.js";import{buildRunContext}from"#execution/runtime-context.js";import{buildInvocationAttributes}from"#internal/invocation/metadata.js";import{isAgentTraceContext}from"#tracing/eve/agent-trace-context.js";const EVE_PACKAGE_INFO=resolveInstalledPackageInfo(),STABLE_ID_BASE=EVE_PACKAGE_INFO.name,log=createLogger(`execution.workflow-runtime`),workflowEntryReference={workflowId:`workflow//${STABLE_ID_BASE}//${WORKFLOW_ENTRY_NAME}`},sessionTimeoutWorkflowReference={workflowId:`workflow//${STABLE_ID_BASE}//${SESSION_TIMEOUT_WORKFLOW_NAME}`},workflowToolRunWorkflowReference={workflowId:`workflow//${STABLE_ID_BASE}//${WORKFLOW_TOOL_RUN_WORKFLOW_NAME}`},connectionEventWorkflowReference={workflowId:`workflow//${STABLE_ID_BASE}//${CONNECTION_EVENT_WORKFLOW_NAME}`},connectionEventDeliveryWorkflowReference={workflowId:`workflow//${STABLE_ID_BASE}//${CONNECTION_EVENT_DELIVERY_WORKFLOW_NAME}`};function createWorkflowRuntime(e){let startSession=async(t,n)=>{validateDeliveryIdempotencyKey(t.idempotencyKey),t.input.message!==void 0&&t.delivery===void 0&&(t={...t,delivery:createChannelDeliveryMetadata({channelKind:t.adapter.kind,channelName:t.channelName??t.adapter.kind,requestId:t.requestId})});let r=t.continuationConflictCommand;r!==void 0&&r.delivery===void 0&&(t={...t,continuationConflictCommand:{...r,delivery:t.delivery}});let i=await getCompiledRuntimeAgentBundle({compiledArtifactsSource:e.compiledArtifactsSource,nodeId:e.nodeId});t.toolStubs!==void 0&&t.toolStubs.rootSessionId===void 0&&validateToolStubTargets(t.toolStubs.rules,i.graph);let a=buildRunContext({agentSessionRuntimeOverrides:e.agentSessionRuntimeOverrides,bundle:i,dynamicSubagentAgentConfig:e.dynamicSubagentAgentConfig,run:t});n!==void 0&&a.set(SessionPredecessorKey,n);let o=resolveEffectiveAgentRuntime(i,a),s=initializeSessionInstrumentation({agentName:o.turnAgent.id,ctx:a}),c=o.limits?.sessionTimeoutMs,l=i.resolvedAgent.config?.experimental?.workflow?.retention??(s.action===`record`&&s.recordInputs&&s.recordOutputs?void 0:0),u=serializeContext(a),d=readParentLineage(u),f={idempotencyKey:t.idempotencyKey,kind:`initial`,input:t.input,ownerDeploymentId:await resolveCurrentWorkflowDeploymentId(),serializedContext:u};t.continuationConflictCommand!==void 0&&(f.continuationConflictCommand=t.continuationConflictCommand),c!==void 0&&(f.sessionTimeoutMs=c),l!==void 0&&(f.retention=l);let p={...d.sessionId===void 0?buildSessionAttributes({serializedContext:u}):buildSubagentRootAttributes({identity:{nodeId:i.nodeId??ROOT_RUNTIME_AGENT_NODE_ID},parentCallId:d.callId,parentSessionId:d.sessionId,parentTurnId:d.turnId,rootSessionId:d.rootSessionId??d.sessionId,serializedContext:u}),[EVE_PREWARM_ATTRIBUTE]:`1`,...t.externalInvocation===void 0?{}:buildInvocationAttributes(t.externalInvocation)},m;try{let e={allowReservedAttributes:!0,attributes:normalizeEveAttributes(p)};l!==void 0&&(e.experimental_retention=l),m=await startWorkflowOnDeployment(workflowEntryReference,[f],f.ownerDeploymentId,e)}catch(e){throw log.error(`failed to start workflow run`,{error:formatCapabilityError(e,[t.continuationToken])}),e}let h=m.runId;if(t.idempotencyKey!==void 0&&t.continuationToken!==void 0){let e=await pollUntil(()=>resolveContinuation(t.continuationToken),SESSION_HOOK_HANDOVER_TIMEOUT_MS);if(e===void 0)throw Error(`Delivery accepted, but its session identity is not ready. Retry with the same idempotencyKey.`);h=e.sessionId}let g,getEvents=()=>(g??=readSessionEventStream(h),g);return{get events(){return getEvents()},sessionId:h,...t.delivery!==void 0&&{deliveryId:t.delivery.deliveryId}}};return{async createSession(e){return await startSession(e)},async dispatchContinuation(e){let{continuationToken:t,successor:n}=e,r=identifyCommand(e.command);try{return await dispatchWorkflowCommand(t,r)}catch(e){if(!(e instanceof StrandedSessionOwnerError))throw e;if(r.kind!==`send`||n===void 0)return await settleStrandedCommand(t,r,e);if((r.payload.answers?.length??0)>0)throw sessionStrandedError(e,`Its pending requests can no longer be answered; send a new message to start a fresh session.`);let i=await endStrandedSession(e,t,`message`);return{sessionId:(await startSession({...n,delivery:r.delivery},{sessionId:i})).sessionId,deliveryId:r.delivery?.deliveryId,status:`accepted`}}},async dispatchSession(e){return await dispatchWorkflowSessionCommand(e)},async getEventStream(e,t){return t?.follow===!1?readSessionEventHistory(e,t.startIndex,t.signal):(await assertFollowableSession(e),readSessionEventStream(e,t?.startIndex,t?.signal))},async getLineStream(e,t){return t?.follow===!1?readSessionRecordHistory(e,t.startIndex):(await assertFollowableSession(e),readSessionRecords(e,t?.startIndex))},async getStreamTailIndex(e){return await readSessionStreamTailIndex(e)},async readChildBinding(e,t){return await readRemoteChildBinding(e,t)},async hasRunnableOwner(e){let t=sessionInboxHookToken(sessionCommandHookToken(e)),n=await findSessionHookHolder(t);if(n===void 0)return!1;try{return await assertRunnableSessionOwner(n),!0}catch(e){if(e instanceof StrandedSessionOwnerError)return!1;throw e}},resolveContinuation}}async function dispatchWorkflowCommand(e,t){if(t.kind===`prewarm`)return typeof e==`string`?{status:`unsupported`}:await prewarmWorkflowSession(e.sessionId,t.targetDeploymentId);let n,r;try{let i=await resumeSessionInbox(e,t);r=i.inbox,n={runId:i.ownerRunId,sessionId:await i.sessionId}}catch(n){if(n instanceof StrandedSessionOwnerError)throw n;let r=t.kind===`send`&&typeof e!=`string`,i={status:`session_not_active`,retryable:!0};if(n instanceof SessionHandoffPendingError){if(r)return i;throw n}if(isInactiveCommandTarget(n))return r&&await isRunActive(e.sessionId)?i:inactiveCommandResult(t);let a=logicalSessionToken(e);throw log.error(`failed to dispatch session command`,{command:t.kind,error:formatCapabilityError(n,[a,sessionInboxHookToken(a)])}),n}t.kind===`reset`&&await waitForSessionHooksRelease([sessionCommandHookToken(n.sessionId),logicalSessionToken(e)],{ownerRunId:n.runId,sessionId:n.sessionId});let i=activeCommandResult(t,n.sessionId);return i.status===`accepted`?{...i,inbox:r}:i}async function settleStrandedCommand(e,t,n){switch(t.kind){case`reset`:return{previousSessionId:await endStrandedSession(n,e,`reset`,t),status:`reset`};case`send`:case`clear`:throw sessionStrandedError(n);default:return inactiveCommandResult(t)}}async function assertFollowableSession(e){try{await Promise.all([assertRunnableSessionInbox(sessionInboxHookToken(sessionCommandHookToken(e))),assertSessionHistoryReadable(e)])}catch(e){throw e instanceof StrandedSessionOwnerError?sessionStrandedError(e):e}}function sessionStrandedError(e,t){let n=e.eveVersion===void 0?{}:{eveVersion:e.eveVersion};return new SessionStrandedError(n,describeStrandedSession(n,t))}function activeCommandResult(e,t){return e.kind===`reset`?{previousSessionId:t,status:`reset`}:e.kind===`send`&&e.delivery!==void 0?{sessionId:t,status:`accepted`,deliveryId:e.delivery.deliveryId}:{sessionId:t,status:`accepted`}}function inactiveCommandResult(e){return e.kind===`send`?{status:`session_not_active`}:e.kind===`cancel`?{status:`no_active_turn`}:{status:`no_active_session`}}async function dispatchWorkflowSessionCommand(e){let t={sessionId:e.sessionId,inbox:e.inbox},n=identifyCommand(e.command);try{return await dispatchWorkflowCommand(t,n)}catch(e){if(!(e instanceof StrandedSessionOwnerError))throw e;return await settleStrandedCommand(t,n,e)}}async function isRunActive(e){try{let t=await getRun(e).status;return t===`pending`||t===`running`}catch(e){if(isInactiveCommandTarget(e))return!1;throw e}}function isInactiveCommandTarget(e){if(e instanceof AcceptedSessionIdentityError)return!1;if(HookNotFoundError.is(e))return!0;for(let t of walkCauseChain(e))if(WorkflowRunNotFoundError.is(t)||RunExpiredError.is(t)||EntityConflictError.is(t))return!0;return!1}async function resolveContinuation(e,t){let n;try{n=await resolveSessionInbox(e)}catch(t){if(HookNotFoundError.is(t))return;throw log.error(`failed to resolve session by continuation token`,{error:formatCapabilityError(t,[e])}),t}if(t?.runnable!==!0)return n;try{await assertRunnableSessionInbox(sessionInboxHookToken(sessionCommandHookToken(n.sessionId)))}catch(e){throw e instanceof StrandedSessionOwnerError?sessionStrandedError(e):e}return n}async function waitForCommandHookOwner(e){let t=await pollUntil(async()=>{try{return normalizeWorkflowHook(await getHookByToken(e))}catch(e){if(!HookNotFoundError.is(e))throw e;return}},SESSION_HOOK_HANDOVER_TIMEOUT_MS);if(t===void 0)throw new HookNotFoundError(e);return t}async function waitForSessionInbox(e){let t=sessionInboxHookToken(sessionCommandHookToken(e)),n=await pollUntil(async()=>await findSessionHookHolder(t)!==void 0||!await hasRunEnded(e)&&void 0,SESSION_HOOK_HANDOVER_TIMEOUT_MS);if(n===void 0)throw Error(`Session "${e}" did not start taking commands within ${SESSION_HOOK_HANDOVER_TIMEOUT_MS/1e3} seconds.`);return n}async function pollUntil(e,t){let n=Date.now()+t;for(let t=20;;t=Math.min(t*2,200)){let r=await e();if(r!==void 0||Date.now()>=n)return r;await new Promise(e=>setTimeout(e,t))}}async function hasRunEnded(e){try{let t=await getRun(e).status;return t!==`pending`&&t!==`running`}catch(e){for(let t of walkCauseChain(e))if(WorkflowRunNotFoundError.is(t))return!1;if(isInactiveCommandTarget(e))return!0;throw e}}async function startWorkflowOnCurrentDeployment(e,t,n){return await startWorkflowOnDeployment(e,t,await resolveCurrentWorkflowDeploymentId(),n)}async function startWorkflowOnDeployment(e,t,n,r){return await withWorkflowStartContext(async()=>{if(n.length===0||n===`latest`)throw Error(`Workflow starts require an exact deployment id.`);return await start(e,t,{...r,allowReservedAttributes:!0,attributes:{...r?.attributes,[EVE_VERSION_ATTRIBUTE]:EVE_PACKAGE_INFO.version},deploymentId:n})})}async function resolveCurrentWorkflowDeploymentId(){let e=process.env.VERCEL_DEPLOYMENT_ID?.trim()||await(await getWorld()).getDeploymentId();if(e.length===0||e===`latest`)throw Error(`Workflow runtime could not resolve an exact deployment id.`);return e}async function withWorkflowStartContext(e){let t=context.active(),n=isAgentTraceContext(t)?trace.deleteSpan(t):t;return await context.with(n,e)}function normalizeWorkflowHook(e){if(typeof e!=`object`||!e||!(`runId`in e))throw Error(`Workflow hook did not include a run id.`);let t=e.runId;if(typeof t!=`string`||t.length===0)throw Error(`Workflow hook did not include a run id.`);return{runId:t}}function identifyCommand(e){if(e.kind!==`send`||e.delivery!==void 0)return e;let t=e.caller===void 0?e.schedule===void 0?`http`:`schedule`:`subagent`;return{...e,delivery:createChannelDeliveryMetadata({channelKind:t,channelName:t,requestId:e.requestId})}}export{connectionEventDeliveryWorkflowReference,connectionEventWorkflowReference,createWorkflowRuntime,dispatchWorkflowSessionCommand,hasRunEnded,pollUntil,resolveContinuation,sessionTimeoutWorkflowReference,startWorkflowOnCurrentDeployment,startWorkflowOnDeployment,waitForCommandHookOwner,waitForSessionInbox,workflowEntryReference,workflowToolRunWorkflowReference};
@@ -19,8 +19,8 @@ export declare function stageAttachmentsToSandbox(message: string | UserContent)
19
19
  * Moves inline file payloads in `content` tool outputs into the sandbox and
20
20
  * leaves `eve-sandbox:` refs in their place, so durable history never
21
21
  * carries tool-result bytes. {@link hydrateSandboxAttachments} restores the
22
- * bytes on every model call. Without an active sandbox, each file becomes a
23
- * note instead.
22
+ * bytes on every model call. Without an active sandbox, or when it rejects
23
+ * the write, each file becomes a note instead.
24
24
  */
25
25
  export declare function stageToolResultMedia<T extends ModelMessage>(messages: readonly T[]): Promise<T[]>;
26
26
  /**
@@ -1 +1 @@
1
- import{createHash}from"node:crypto";import{buildChannelContext}from"#channel/session.js";import{createLogger}from"#internal/logging.js";import{getAdapterKind}from"#channel/adapter.js";import{contextStorage,loadContext}from"#context/container.js";import{SandboxKey,SessionIdKey}from"#context/keys.js";import{deserializeUrlFilePart,isSerializedUrlFilePart}from"#internal/attachments/url-refs.js";import{basename,dirname,extname}from"node:path";import{ChannelKey}from"#runtime/sessions/runtime-context-keys.js";import{DEFAULT_UPLOAD_POLICY,isMediaTypeAllowed}from"#public/channels/upload-policy.js";import{createFrameworkUserMessage}from"#harness/messages.js";import{buildAdapterContext}from"#channel/adapter-context.js";import{verifyMediaType}from"#internal/attachments/media-metadata.js";import{readMediaMetadata}from"#internal/attachments/read-media-metadata.js";import{decodeSandboxRef,encodeSandboxRef,inlinesSandboxRefAsBytes,isSandboxRefUrl}from"#internal/attachments/sandbox-refs.js";import{isUnresolvedFileData,readFileData}from"#internal/attachments/data.js";import{EveAttachmentError}from"#internal/attachments/errors.js";import{maxBytesOf}from"#internal/attachments/limited-read.js";import{createPublicDownloads}from"#internal/attachments/public-link.js";const log=createLogger(`harness.attachment-staging`),UNSAFE_FILENAME_CHARS=/[^\w.-]+/g,CACHED_REF_BYTES_LIMIT=67108864,cachedRefBytes=new Map;let cachedRefBytesTotal=0;const MEDIA_TYPE_EXTENSIONS={"application/pdf":`.pdf`,"image/gif":`.gif`,"image/jpeg":`.jpg`,"image/png":`.png`,"image/webp":`.webp`};async function stageAttachmentsForAdapter(e,t,n){if(typeof e==`string`)return e;let r=reconstitueFilePartUrls(e),i=n.ctx.get(ChannelKey)?.uploadPolicy,a=createPublicDownloads(maxBytesOf(i??DEFAULT_UPLOAD_POLICY));return Promise.all(r.map(async e=>e.type===`file`?stageFilePart(e,t,n,a,i):e))}async function stageAttachmentsToSandbox(e){if(typeof e==`string`||!Array.isArray(e)||!hasFileParts(e))return e;let t=loadContext(),n=await activeSandbox(t.get(SandboxKey));if(n===null)return e.map(e=>e.type===`file`&&!isSandboxRefUrl(e.data)&&readFileData(e.data).kind!==`reference`?attachmentNote(e,`could not be stored: no sandbox is available.`):e);let r=t.get(ChannelKey);return stageAttachmentsForAdapter(e,n,r?buildAdapterContext(r,t):{ctx:t,state:{},session:buildChannelContext(t).session})}async function stageToolResultMedia(e){if(!e.some(hasInlineToolResultFile))return[...e];let t=await activeSandbox(contextStorage.getStore()?.get(SandboxKey));return Promise.all(e.map(async e=>{if(e.role!==`tool`||!hasInlineToolResultFile(e))return e;let n=await Promise.all(e.content.map(async e=>e.type===`tool-result`?{...e,output:await stageToolOutputFiles(e.output,t)}:e));return{...e,content:n}}))}async function hydrateSandboxAttachments(e){let t=replaceUnresolvedFileParts(e);if(!messagesContainSandboxRef(t))return t;let n=loadContext(),r=sandboxRefReader(n.get(SandboxKey),n.get(SessionIdKey));return Promise.all(t.map(async e=>{if(!messageContainsSandboxRef(e))return e;let t=await hydrateMessageContent(e.content,r);return{...e,content:t}}))}function sandboxRefReader(e,t){let n;return async r=>{let i=cacheKey(t,r),a=i===void 0?void 0:readCachedRefBytes(i);if(a!==void 0)return a;if(e===void 0)throw Error(`Cannot hydrate attachment ${r.path}: no SandboxKey is bound on the active eve context. Hydration must run inside a step scope with the framework sandbox provider installed.`);n??=activeSandbox(e);let o=await readSandboxRefBytes(r,await n);return o!==null&&i!==void 0&&cacheRefBytes(i,o),o}}function cacheKey(e,t){if(e!==void 0)return JSON.stringify([e,t.path,t.size,t.mediaType])}function readCachedRefBytes(e){let t=cachedRefBytes.get(e);return t!==void 0&&(cachedRefBytes.delete(e),cachedRefBytes.set(e,t)),t}function cacheRefBytes(e,t){if(!(t.byteLength>CACHED_REF_BYTES_LIMIT||cachedRefBytes.has(e))){cachedRefBytes.set(e,Buffer.from(t)),cachedRefBytesTotal+=t.byteLength;for(let[e,t]of cachedRefBytes){if(cachedRefBytesTotal<=CACHED_REF_BYTES_LIMIT)break;cachedRefBytes.delete(e),cachedRefBytesTotal-=t.byteLength}}}async function activeSandbox(e){if(e===void 0)return null;try{return await e.open()}catch(e){return log.warn(`session sandbox unavailable, degrading attachments to text`,{error:e}),null}}function replaceUnresolvedFileParts(e){let t=!1,n=e.map(e=>{if(e.role!==`user`||!Array.isArray(e.content)||!e.content.some(isUnresolvedFilePart))return e;t=!0;let n=e.content.map(e=>isUnresolvedFilePart(e)?attachmentNote(e,`could not be retrieved.`):e);return{...e,content:n}});return t?n:e}function isUnresolvedFilePart(e){return e.type===`file`&&!isSandboxRefUrl(e.data)&&isUnresolvedFileData(e.data)}function hasFileParts(e){for(let t of e)if(t.type===`file`)return!0;return!1}function messagesContainSandboxRef(e){for(let t of e)if(messageContainsSandboxRef(t))return!0;return!1}function messageContainsSandboxRef(e){let t=e.content;if(!Array.isArray(t))return!1;for(let e of t)if(isSandboxRefFilePart(e)||e.type===`tool-result`&&contentOutputParts(e.output).some(isToolOutputRefFile))return!0;return!1}function contentOutputParts(e){return e.type===`content`?e.value:[]}function hasInlineToolResultFile(e){return e.role===`tool`&&e.content.some(e=>e.type===`tool-result`&&contentOutputParts(e.output).some(isInlineToolOutputFile))}function isInlineToolOutputFile(e){return e.type===`file`&&e.data.type===`data`}function isToolOutputRefFile(e){return e.type===`file`&&e.data.type===`url`&&isSandboxRefUrl(e.data.url)}async function stageToolOutputFiles(e,t){if(e.type!==`content`||!e.value.some(isInlineToolOutputFile))return e;let n=await Promise.all(e.value.map(async e=>{if(!isInlineToolOutputFile(e)||e.data.type!==`data`)return e;let n=readFileData(e.data.data);if(n.kind===`link`)return e;if(t===null||n.kind!==`bytes`)return{text:`Returned file ${e.filename??`file`} (${e.mediaType}) could not be stored.`,type:`text`};let r=await writeSandboxRef(n.bytes,e.mediaType,e.filename,t);return{...e,data:{type:`url`,url:encodeSandboxRef(r)},mediaType:r.mediaType}}));return{...e,value:n}}function isSandboxRefFilePart(e){return typeof e==`object`&&!!e&&e.type===`file`&&isSandboxRefUrl(e.data)}async function hydrateMessageContent(e,t){return Array.isArray(e)?(await Promise.all(e.map(async e=>{if(isSandboxRefFilePart(e)){let n=decodeSandboxRef(e.data),r=renderSandboxRefAsTextPart(n);if(!inlinesSandboxRefAsBytes(n))return[r];let i=await t(n);return i===null?[renderMissingSandboxRef(n)]:[r,{...e,data:i,mediaType:n.mediaType}]}if(e.type===`tool-result`){let n=e;return[{...n,output:await hydrateToolOutput(n.output,t)}]}return[e]}))).flat():e}async function hydrateToolOutput(e,t){if(e.type!==`content`||!e.value.some(isToolOutputRefFile))return e;let n=await Promise.all(e.value.map(async e=>{if(!isToolOutputRefFile(e)||e.data.type!==`url`)return[e];let n=decodeSandboxRef(e.data.url),r=renderSandboxRefAsTextPart(n);if(!inlinesSandboxRefAsBytes(n))return[r];let i=await t(n);return i===null?[renderMissingSandboxRef(n)]:[r,{...e,data:{data:Buffer.from(i).toString(`base64`),type:`data`}}]}));return{...e,value:n.flat()}}async function readSandboxRefBytes(e,t){if(t===null)return null;let n=await t.readBinaryFile({path:e.path});return n===null?(log.warn(`sandbox-ref attachment bytes missing on hydration — degrading to text reference`,{mediaType:e.mediaType,path:e.path,size:e.size}),null):n.byteLength!==e.size||sha256Prefix(n)!==basename(dirname(e.path))?(log.warn(`sandbox-ref attachment bytes changed since staging — degrading to text reference`,{mediaType:e.mediaType,path:e.path,size:e.size}),null):n}function renderMissingSandboxRef(e){return{text:`FileNotFound: Current snapshot may be newer and does not contain ${e.path}.`,type:`text`}}function moveToolResultFilesToUserMessages(e){let t=[],n=[];for(let r of e){if(r.role!==`tool`&&n.length>0&&(t.push(createReturnedFilesMessage(n)),n=[]),r.role!==`tool`){t.push(r);continue}let e=r.content.map(e=>{if(e.type!==`tool-result`||e.output.type!==`content`)return e;let t=e.output.value.map(e=>{if(e.type!==`file`)return e;let t={data:e.data,mediaType:e.mediaType,type:`file`};return e.filename!==void 0&&(t.filename=e.filename),n.push(t),{text:`Attached file ${e.filename??`file`} (${e.mediaType}) follows this tool result.`,type:`text`}});return{...e,output:{...e.output,value:t}}});t.push({...r,content:e})}return n.length>0&&t.push(createReturnedFilesMessage(n)),t}function createReturnedFilesMessage(e){return createFrameworkUserMessage(`context.state`,[{text:`Files returned by the preceding tool results:`,type:`text`},...e])}function renderSandboxRefAsTextPart(e){return{text:`Attached file ${e.path} (${e.mediaType})`,type:`text`}}async function stageFilePart(e,t,n,r,i){if(isSandboxRefUrl(e.data))return e;let a=readFileData(e.data);if(a.kind===`bytes`)return stageResolvedBytes(e,{bytes:a.bytes},t,i);if(a.kind===`reference`)return e;if(a.kind===`unreadable`)return log.warn(`attachment data is not bytes, base64, or a URL — degrading to text part`,{filename:e.filename,mediaType:e.mediaType}),attachmentNote(e,`could not be read.`);let o;try{o=await resolveLink(a.url,n,r)}catch(t){if(!(t instanceof EveAttachmentError))throw t;return log.warn(`attachment resolver failed — degrading to text part`,{adapterKind:t.adapterKind,error:t.cause,filename:e.filename,kind:t.kind}),attachmentNote(e,`could not be retrieved: ${t.message}`)}return stageResolvedBytes(e,o,t,i)}function attachmentNote(e,t){return{text:`Attachment ${e.filename?.trim()||`file`} ${t}`,type:`text`}}async function stageResolvedBytes(e,t,n,r){let i=verifyMediaType(t.bytes,t.mediaType??e.mediaType??`application/octet-stream`);if(r!==void 0){let n=maxBytesOf(r);if(t.bytes.byteLength>n)return attachmentNote(e,`was not accepted: it is ${t.bytes.byteLength} bytes, over this channel's ${n}-byte upload limit.`);if(!isMediaTypeAllowed(i,r))return attachmentNote(e,`was not accepted: this channel doesn't accept ${i} files.`)}let a=await writeSandboxRef(t.bytes,i,t.filename??e.filename,n);return{...e,data:encodeSandboxRef(a),filename:a.path,mediaType:a.mediaType}}async function writeSandboxRef(e,t,n,r){let i=verifyMediaType(e,t),a=sha256Prefix(e),o=`.eve/attachments/${a}/${safeFilename(n,a,i)}`;await r.writeBinaryFile({content:e,path:o});let s={...readMediaMetadata(e,i),path:r.resolvePath(o)},c=cacheKey(contextStorage.getStore()?.get(SessionIdKey),s);return c!==void 0&&inlinesSandboxRefAsBytes(s)&&cacheRefBytes(c,e),s}async function resolveLink(e,t,n){let r=t.ctx.get(ChannelKey),i=r===void 0?`none`:getAdapterKind(r);if(r?.fetchFile!==void 0){let n;try{n=await r.fetchFile(e.href,t)}catch(e){throw e instanceof EveAttachmentError?new EveAttachmentError({adapterKind:i,cause:e.cause,kind:e.kind,message:e.message}):new EveAttachmentError({adapterKind:i,cause:e,kind:`resolver-threw`,message:`Attachment retrieval failed in the "${i}" channel.`})}if(n!==null)return Buffer.isBuffer(n)?{bytes:n}:n}return n(e,i)}function reconstitueFilePartUrls(e){let t=!1,n=e.map(e=>e.type===`file`&&isSerializedUrlFilePart(e.data)?(t=!0,{...e,data:deserializeUrlFilePart(e.data)}):e);return t?n:e}function sha256Prefix(e){return createHash(`sha256`).update(e).digest(`hex`).slice(0,16)}function safeFilename(e,t,n){let r=e===void 0?``:basename(e).replace(UNSAFE_FILENAME_CHARS,`_`),i=r.length>0?r:`file-${t}`,a=MEDIA_TYPE_EXTENSIONS[n];return a===void 0||extname(i)!==``?i:`${i}${a}`}export{hydrateSandboxAttachments,moveToolResultFilesToUserMessages,stageAttachmentsForAdapter,stageAttachmentsToSandbox,stageToolResultMedia};
1
+ import{createHash}from"node:crypto";import{buildChannelContext}from"#channel/session.js";import{createLogger}from"#internal/logging.js";import{getAdapterKind}from"#channel/adapter.js";import{contextStorage,loadContext}from"#context/container.js";import{SandboxKey,SessionIdKey}from"#context/keys.js";import{deserializeUrlFilePart,isSerializedUrlFilePart}from"#internal/attachments/url-refs.js";import{basename,dirname,extname}from"node:path";import{ChannelKey}from"#runtime/sessions/runtime-context-keys.js";import{DEFAULT_UPLOAD_POLICY,isMediaTypeAllowed}from"#public/channels/upload-policy.js";import{createFrameworkUserMessage}from"#harness/messages.js";import{buildAdapterContext}from"#channel/adapter-context.js";import{verifyMediaType}from"#internal/attachments/media-metadata.js";import{readMediaMetadata}from"#internal/attachments/read-media-metadata.js";import{decodeSandboxRef,encodeSandboxRef,inlinesSandboxRefAsBytes,isSandboxRefUrl}from"#internal/attachments/sandbox-refs.js";import{isUnresolvedFileData,readFileData}from"#internal/attachments/data.js";import{EveAttachmentError}from"#internal/attachments/errors.js";import{maxBytesOf}from"#internal/attachments/limited-read.js";import{createPublicDownloads}from"#internal/attachments/public-link.js";const log=createLogger(`harness.attachment-staging`),UNSAFE_FILENAME_CHARS=/[^\w.-]+/g,CACHED_REF_BYTES_LIMIT=67108864,cachedRefBytes=new Map;let cachedRefBytesTotal=0;const MEDIA_TYPE_EXTENSIONS={"application/pdf":`.pdf`,"image/gif":`.gif`,"image/jpeg":`.jpg`,"image/png":`.png`,"image/webp":`.webp`};async function stageAttachmentsForAdapter(e,t,n){if(typeof e==`string`)return e;let r=reconstitueFilePartUrls(e),i=n.ctx.get(ChannelKey)?.uploadPolicy,a=createPublicDownloads(maxBytesOf(i??DEFAULT_UPLOAD_POLICY));return Promise.all(r.map(async e=>e.type===`file`?stageFilePart(e,t,n,a,i):e))}async function stageAttachmentsToSandbox(e){if(typeof e==`string`||!Array.isArray(e)||!hasFileParts(e))return e;let t=loadContext(),n=await activeSandbox(t.get(SandboxKey));if(n===null)return e.map(e=>e.type===`file`&&!isSandboxRefUrl(e.data)&&readFileData(e.data).kind!==`reference`?attachmentNote(e,`could not be stored: no sandbox is available.`):e);let r=t.get(ChannelKey);return stageAttachmentsForAdapter(e,n,r?buildAdapterContext(r,t):{ctx:t,state:{},session:buildChannelContext(t).session})}async function stageToolResultMedia(e){if(!e.some(hasInlineToolResultFile))return[...e];let t=await activeSandbox(contextStorage.getStore()?.get(SandboxKey));return Promise.all(e.map(async e=>{if(e.role!==`tool`||!hasInlineToolResultFile(e))return e;let n=await Promise.all(e.content.map(async e=>e.type===`tool-result`?{...e,output:await stageToolOutputFiles(e.output,t)}:e));return{...e,content:n}}))}async function hydrateSandboxAttachments(e){let t=replaceUnresolvedFileParts(e);if(!messagesContainSandboxRef(t))return t;let n=loadContext(),r=sandboxRefReader(n.get(SandboxKey),n.get(SessionIdKey));return Promise.all(t.map(async e=>{if(!messageContainsSandboxRef(e))return e;let t=await hydrateMessageContent(e.content,r);return{...e,content:t}}))}function sandboxRefReader(e,t){let n;return async r=>{let i=cacheKey(t,r),a=i===void 0?void 0:readCachedRefBytes(i);if(a!==void 0)return a;if(e===void 0)throw Error(`Cannot hydrate attachment ${r.path}: no SandboxKey is bound on the active eve context. Hydration must run inside a step scope with the framework sandbox provider installed.`);n??=activeSandbox(e);let o=await readSandboxRefBytes(r,await n);return o!==null&&i!==void 0&&cacheRefBytes(i,o),o}}function cacheKey(e,t){if(e!==void 0)return JSON.stringify([e,t.path,t.size,t.mediaType])}function readCachedRefBytes(e){let t=cachedRefBytes.get(e);return t!==void 0&&(cachedRefBytes.delete(e),cachedRefBytes.set(e,t)),t}function cacheRefBytes(e,t){if(!(t.byteLength>CACHED_REF_BYTES_LIMIT||cachedRefBytes.has(e))){cachedRefBytes.set(e,Buffer.from(t)),cachedRefBytesTotal+=t.byteLength;for(let[e,t]of cachedRefBytes){if(cachedRefBytesTotal<=CACHED_REF_BYTES_LIMIT)break;cachedRefBytes.delete(e),cachedRefBytesTotal-=t.byteLength}}}async function activeSandbox(e){if(e===void 0)return null;try{return await e.open()}catch(e){return log.warn(`session sandbox unavailable, degrading attachments to text`,{error:e}),null}}function replaceUnresolvedFileParts(e){let t=!1,n=e.map(e=>{if(e.role!==`user`||!Array.isArray(e.content)||!e.content.some(isUnresolvedFilePart))return e;t=!0;let n=e.content.map(e=>isUnresolvedFilePart(e)?attachmentNote(e,`could not be retrieved.`):e);return{...e,content:n}});return t?n:e}function isUnresolvedFilePart(e){return e.type===`file`&&!isSandboxRefUrl(e.data)&&isUnresolvedFileData(e.data)}function hasFileParts(e){for(let t of e)if(t.type===`file`)return!0;return!1}function messagesContainSandboxRef(e){for(let t of e)if(messageContainsSandboxRef(t))return!0;return!1}function messageContainsSandboxRef(e){let t=e.content;if(!Array.isArray(t))return!1;for(let e of t)if(isSandboxRefFilePart(e)||e.type===`tool-result`&&contentOutputParts(e.output).some(isToolOutputRefFile))return!0;return!1}function contentOutputParts(e){return e.type===`content`?e.value:[]}function hasInlineToolResultFile(e){return e.role===`tool`&&e.content.some(e=>e.type===`tool-result`&&contentOutputParts(e.output).some(isInlineToolOutputFile))}function isInlineToolOutputFile(e){return e.type===`file`&&e.data.type===`data`}function isToolOutputRefFile(e){return e.type===`file`&&e.data.type===`url`&&isSandboxRefUrl(e.data.url)}async function stageToolOutputFiles(e,t){if(e.type!==`content`||!e.value.some(isInlineToolOutputFile))return e;let n=await Promise.all(e.value.map(async e=>{if(!isInlineToolOutputFile(e)||e.data.type!==`data`)return e;let n=readFileData(e.data.data);if(n.kind===`link`)return e;if(t===null||n.kind!==`bytes`)return unstoredFileNote(e);try{let r=await writeSandboxRef(n.bytes,e.mediaType,e.filename,t);return{...e,data:{type:`url`,url:encodeSandboxRef(r)},mediaType:r.mediaType}}catch(t){return log.warn(`sandbox write failed for a tool-result file, degrading it to text`,{error:t}),unstoredFileNote(e)}}));return{...e,value:n}}function unstoredFileNote(e){return{text:`Returned file ${e.filename??`file`} (${e.mediaType}) could not be stored.`,type:`text`}}function isSandboxRefFilePart(e){return typeof e==`object`&&!!e&&e.type===`file`&&isSandboxRefUrl(e.data)}async function hydrateMessageContent(e,t){return Array.isArray(e)?(await Promise.all(e.map(async e=>{if(isSandboxRefFilePart(e)){let n=decodeSandboxRef(e.data),r=renderSandboxRefAsTextPart(n);if(!inlinesSandboxRefAsBytes(n))return[r];let i=await t(n);return i===null?[renderMissingSandboxRef(n)]:[r,{...e,data:i,mediaType:n.mediaType}]}if(e.type===`tool-result`){let n=e;return[{...n,output:await hydrateToolOutput(n.output,t)}]}return[e]}))).flat():e}async function hydrateToolOutput(e,t){if(e.type!==`content`||!e.value.some(isToolOutputRefFile))return e;let n=await Promise.all(e.value.map(async e=>{if(!isToolOutputRefFile(e)||e.data.type!==`url`)return[e];let n=decodeSandboxRef(e.data.url),r=renderSandboxRefAsTextPart(n);if(!inlinesSandboxRefAsBytes(n))return[r];let i=await t(n);return i===null?[renderMissingSandboxRef(n)]:[r,{...e,data:{data:Buffer.from(i).toString(`base64`),type:`data`}}]}));return{...e,value:n.flat()}}async function readSandboxRefBytes(e,t){if(t===null)return null;let n=await t.readBinaryFile({path:e.path});return n===null?(log.warn(`sandbox-ref attachment bytes missing on hydration — degrading to text reference`,{mediaType:e.mediaType,path:e.path,size:e.size}),null):n.byteLength!==e.size||sha256Prefix(n)!==basename(dirname(e.path))?(log.warn(`sandbox-ref attachment bytes changed since staging — degrading to text reference`,{mediaType:e.mediaType,path:e.path,size:e.size}),null):n}function renderMissingSandboxRef(e){return{text:`FileNotFound: Current snapshot may be newer and does not contain ${e.path}.`,type:`text`}}function moveToolResultFilesToUserMessages(e){let t=[],n=[];for(let r of e){if(r.role!==`tool`&&n.length>0&&(t.push(createReturnedFilesMessage(n)),n=[]),r.role!==`tool`){t.push(r);continue}let e=r.content.map(e=>{if(e.type!==`tool-result`||e.output.type!==`content`)return e;let t=e.output.value.map(e=>{if(e.type!==`file`)return e;let t={data:e.data,mediaType:e.mediaType,type:`file`};return e.filename!==void 0&&(t.filename=e.filename),n.push(t),{text:`Attached file ${e.filename??`file`} (${e.mediaType}) follows this tool result.`,type:`text`}});return{...e,output:{...e.output,value:t}}});t.push({...r,content:e})}return n.length>0&&t.push(createReturnedFilesMessage(n)),t}function createReturnedFilesMessage(e){return createFrameworkUserMessage(`context.state`,[{text:`Files returned by the preceding tool results:`,type:`text`},...e])}function renderSandboxRefAsTextPart(e){return{text:`Attached file ${e.path} (${e.mediaType})`,type:`text`}}async function stageFilePart(e,t,n,r,i){if(isSandboxRefUrl(e.data))return e;let a=readFileData(e.data);if(a.kind===`bytes`)return stageResolvedBytes(e,{bytes:a.bytes},t,i);if(a.kind===`reference`)return e;if(a.kind===`unreadable`)return log.warn(`attachment data is not bytes, base64, or a URL — degrading to text part`,{filename:e.filename,mediaType:e.mediaType}),attachmentNote(e,`could not be read.`);let o;try{o=await resolveLink(a.url,n,r)}catch(t){if(!(t instanceof EveAttachmentError))throw t;return log.warn(`attachment resolver failed — degrading to text part`,{adapterKind:t.adapterKind,error:t.cause,filename:e.filename,kind:t.kind}),attachmentNote(e,`could not be retrieved: ${t.message}`)}return stageResolvedBytes(e,o,t,i)}function attachmentNote(e,t){return{text:`Attachment ${e.filename?.trim()||`file`} ${t}`,type:`text`}}async function stageResolvedBytes(e,t,n,r){let i=verifyMediaType(t.bytes,t.mediaType??e.mediaType??`application/octet-stream`);if(r!==void 0){let n=maxBytesOf(r);if(t.bytes.byteLength>n)return attachmentNote(e,`was not accepted: it is ${t.bytes.byteLength} bytes, over this channel's ${n}-byte upload limit.`);if(!isMediaTypeAllowed(i,r))return attachmentNote(e,`was not accepted: this channel doesn't accept ${i} files.`)}let a=await writeSandboxRef(t.bytes,i,t.filename??e.filename,n);return{...e,data:encodeSandboxRef(a),filename:a.path,mediaType:a.mediaType}}async function writeSandboxRef(e,t,n,r){let i=verifyMediaType(e,t),a=sha256Prefix(e),o=`.eve/attachments/${a}/${safeFilename(n,a,i)}`;await r.writeBinaryFile({content:e,path:o});let s={...readMediaMetadata(e,i),path:r.resolvePath(o)},c=cacheKey(contextStorage.getStore()?.get(SessionIdKey),s);return c!==void 0&&inlinesSandboxRefAsBytes(s)&&cacheRefBytes(c,e),s}async function resolveLink(e,t,n){let r=t.ctx.get(ChannelKey),i=r===void 0?`none`:getAdapterKind(r);if(r?.fetchFile!==void 0){let n;try{n=await r.fetchFile(e.href,t)}catch(e){throw e instanceof EveAttachmentError?new EveAttachmentError({adapterKind:i,cause:e.cause,kind:e.kind,message:e.message}):new EveAttachmentError({adapterKind:i,cause:e,kind:`resolver-threw`,message:`Attachment retrieval failed in the "${i}" channel.`})}if(n!==null)return Buffer.isBuffer(n)?{bytes:n}:n}return n(e,i)}function reconstitueFilePartUrls(e){let t=!1,n=e.map(e=>e.type===`file`&&isSerializedUrlFilePart(e.data)?(t=!0,{...e,data:deserializeUrlFilePart(e.data)}):e);return t?n:e}function sha256Prefix(e){return createHash(`sha256`).update(e).digest(`hex`).slice(0,16)}function safeFilename(e,t,n){let r=e===void 0?``:basename(e).replace(UNSAFE_FILENAME_CHARS,`_`),i=r.length>0?r:`file-${t}`,a=MEDIA_TYPE_EXTENSIONS[n];return a===void 0||extname(i)!==``?i:`${i}${a}`}export{hydrateSandboxAttachments,moveToolResultFilesToUserMessages,stageAttachmentsForAdapter,stageAttachmentsToSandbox,stageToolResultMedia};
@@ -1 +1 @@
1
- import{openWork}from"#protocol/session-projection/selectors.js";import{streamText}from"ai";import{createLogger,logError}from"#internal/logging.js";import{contextStorage}from"#context/container.js";import{AuthKey,HistoryStateKey}from"#context/keys.js";import{toErrorMessage}from"#shared/errors.js";import{takeCompactionCaptureFailure}from"#reactions/kinds/memory.js";import{addTokenUsage}from"#shared/token-usage-math.js";import{isUserModelMessage,validateHarnessModelMessages}from"#harness/messages.js";import{controlDeliveryFor}from"#harness/session-machine/transitions.js";import{contextStarted,controlAdmitted,deliveryApplied,fact,runRequested,runSettledFacts,runStarted,usageOf}from"#harness/facts.js";import{NO_USAGE,markUsageReported}from"#harness/session-usage.js";import{nextChangeId,nextRunId}from"#protocol/session-projection.js";import{CompactionOverLimitError}from"#harness/compaction/over-limit-error.js";import{estimateTokens}from"#harness/token-estimate.js";import{compactMessages,getInputTokenCount,shouldCompact,withoutPromptMeasurement}from"#harness/compaction/engine.js";import{requireSessionModelReference}from"#harness/types.js";import{buildGatewayAttributionHeaders,resolveEffectiveRuntimeModel,withGatewayTraceContext}from"#harness/model-call/model.js";import{normalizeModelStreamError}from"#harness/model-call/errors.js";import{runModelCallWithRetries}from"#harness/model-call/retry.js";import{extractGatewayCostUsd,extractTokenUsageDelta,gatewayModelId}from"#harness/model-call/usage.js";import{resolveModelProfile}from"#harness/model-profile.js";import{resolveCallProviderOptions}from"#harness/provider-safety.js";const log=createLogger(`harness.tool-loop`);function assertFixedPartFits(e){let t=e.requestEnvelopeTokens+e.protectedTokens;if(t>=e.threshold)throw new CompactionOverLimitError(`The agent's system prompt, tools, memory and context take ~${Math.round(t)} tokens, over this model's ~${e.threshold}-token compaction limit. Shorten the instructions, remove tools or trim memory.`)}async function compactHistory(e){let{config:t}=e,{projection:n}=e.view(),r=controlDeliveryFor(e.view(),t.controlDelivery),{deliveryId:i}=r,a=nextChangeId(n);if(e.session.history.length===0)return await e.apply([controlAdmitted(r,`compact`),deliveryApplied(i)]),{next:null,session:e.session};let o=validateHarnessModelMessages(e.session.history);await e.apply([controlAdmitted(r,`compact`),contextStarted({cause:{deliveryId:i},changeId:a,kind:`compaction`})],o);let s=nextRunId(e.view().projection),c=`applied`;try{await e.apply([runRequested({changeId:a},s)],o);let n=await resolveEffectiveRuntimeModel({config:t,ctx:e.ctx,session:e.session});e.session=n.session;let r=e.session.agent.compactionModelReference??requireSessionModelReference(e.session);await e.publish(runStarted({attempt:0,modelId:r.id,runId:s}));let i=await maybeCompact({abortSignal:t.abortSignal,auth:e.ctx?.get(AuthKey)??null,betweenTurns:!0,change:{announced:!0,changeId:a,summaryRunId:s},ctx:e.ctx,emissionState:e.position(),force:!0,messages:[...e.session.history],model:n.model,publish:e.publish,view:()=>e.view().projection.view,requestEnvelopeTokens:e.session.compaction.requestEnvelopeTokens,resolveModel:t.resolveModel,runtimeIdentity:t.runtimeIdentity,session:e.session,prepareTelemetry:t=>e.instrumentation?.prepareAttempt({runId:t,attempt:0}).telemetry,traceContextHeaders:e.instrumentation?.gatewayTraceContextHeaders});if(e.session=i.session,i.failure!==void 0)throw i.failure.error}catch(t){c=`failed`;let n=summaryFailed(e.view().projection.view,{changeId:a,error:t});n.length>0&&await e.publish(n),logError(log,`manual session compaction failed`,t,{sessionId:e.session.sessionId})}let l=c===`failed`?`compaction-failed`:void 0;return await e.apply([fact(`delivery.settled`,{deliveryId:i,outcome:c,reason:l})]),{next:null,session:e.session}}function summaryUsageOf(e){let t=e.filter(e=>e!==void 0);if(t.length!==0)return t.reduce((e,t)=>addTokenUsage(e,usageOf(t)),NO_USAGE)}function summaryFailed(e,t){if(e.changes[t.changeId]?.status!==`running`)return[];let n={code:`COMPACTION_FAILED`,message:toErrorMessage(t.error)},r=openWork(e,{changeId:t.changeId}).runs,{spent:i}=t;return[...r.flatMap(({runId:e})=>runSettledFacts({error:n,outcome:`failed`,runId:e,...i?.runId===e&&{usage:i.usage}})),{data:{changeId:t.changeId,error:n,kind:e.changes[t.changeId]?.kind??`compaction`,outcome:`failed`},type:`context.settled`}]}function replaceSessionHistory(e,t){return contextStorage.getStore()?.delete(HistoryStateKey),{...e,history:t,compaction:withoutPromptMeasurement(e.compaction)}}async function maybeCompact(e){try{return await compactOnce(e)}catch(t){let n=summaryFailed(e.view(),{changeId:e.change.changeId,error:t});throw n.length>0&&await e.publish(n),t}}async function compactOnce(e){let{emissionState:t,publish:n}=e,r=e.messages,i=e.session,a=e.promptMessages??r,o=validateHarnessModelMessages(a),s=e.force===!0||shouldCompact(o,i.compaction,e.requestEnvelopeTokens,i.compaction.requestEnvelopeTokens);if(!s)return{compacted:!1,messages:r,session:i};let c=requireSessionModelReference(i),l=i.agent.compactionModelReference??c,u=l===c?e.model:await e.resolveModel(l),d=resolveModelProfile(u),f=resolveCallProviderOptions({auth:e.auth,profile:d,providerOptions:l.providerOptions,session:i}),p={abortSignal:e.abortSignal,headers:buildGatewayAttributionHeaders(d,e.runtimeIdentity),model:withGatewayTraceContext(u,d,e.traceContextHeaders),providerOptions:f,telemetry:e.telemetry&&{...e.telemetry,functionId:`eve.compaction`}},m,h=[],{change:g}=e,_=g.announced===!0,summarize=async r=>{_||(_=!0,await n([runRequested({changeId:g.changeId},g.summaryRunId),runStarted({attempt:0,modelId:gatewayModelId(u)??`unknown`,runId:g.summaryRunId})]));let a=await runModelCallWithRetries(()=>streamCompactionSummary({...p,telemetry:m??p.telemetry,...r}),{sessionId:i.sessionId,turnId:t.turnId},e.abortSignal);if(h.push(a.usage),a.text.trim().length===0)throw Error(`The compaction model returned an empty summary. Finish reason: ${a.finishReason}.`);return a.text};if(g.announced!==!0){let t=getInputTokenCount(o,i.compaction,e.requestEnvelopeTokens,i.compaction.requestEnvelopeTokens);await n(contextStarted({cause:g.cause,changeId:g.changeId,kind:`compaction`,trigger:e.force===!0||t===null?void 0:{inputTokens:t},turnId:g.turnId}),o)}s&&(m=e.prepareTelemetry?.(g.summaryRunId));let v=validateHarnessModelMessages(r),y=e.requestEnvelopeTokens??0,b=Math.max(0,estimateTokens(o)-estimateTokens(v)),x={...i.compaction,threshold:Math.max(1,i.compaction.threshold-y-b),lastKnownInputTokens:i.compaction.lastKnownInputTokens===void 0?void 0:Math.max(0,i.compaction.lastKnownInputTokens-Math.min(i.compaction.requestEnvelopeTokens??0,y))},S=[...v],C=takeCompactionCaptureFailure(e.ctx),w=C===void 0?void 0:{error:C};try{s&&w===void 0&&(assertFixedPartFits({protectedTokens:b,requestEnvelopeTokens:y,threshold:i.compaction.threshold}),S=await compactMessages([...v],x,summarize,e.force===!0,e.requestEnvelopeTokens===void 0?void 0:Math.max(0,getInputTokenCount(o,i.compaction,y,i.compaction.requestEnvelopeTokens)-y-b)))}catch(e){w={error:e}}let T=s?summaryUsageOf(h):void 0;T!==void 0&&e.betweenTurns===!0&&(i=markUsageReported(i,T));let E=g.summaryRunId;if(w!==void 0)return await n(summaryFailed(e.view(),{changeId:g.changeId,error:w.error,...T!==void 0&&{spent:{runId:E,usage:T}}})),{compacted:!1,failure:w,messages:e.messages,session:i};r=validateHarnessModelMessages(S);{let e=h.length>0?runSettledFacts({finishReason:`stop`,outcome:`completed`,runId:E,usage:T}):_?runSettledFacts({outcome:`abandoned`,runId:E}):[];e.push({data:{changeId:g.changeId,kind:`compaction`,outcome:`completed`},type:`context.settled`}),await n(e,r)}return{compacted:!0,messages:r,session:replaceSessionHistory(i,r)}}function compactedTurnInput(e){return e.findLast(e=>isUserModelMessage(e)&&e.kind===`user`)}async function streamCompactionSummary(e){let t=streamText({...e,onError:()=>{}});for await(let e of t.fullStream)if(e.type===`error`)throw normalizeModelStreamError(e.error);let[n,r,i,a]=await Promise.all([t.text,t.finishReason,t.usage,t.providerMetadata]);return{finishReason:r,text:n,usage:extractTokenUsageDelta({costUsd:extractGatewayCostUsd(a),usage:i})}}export{assertFixedPartFits,compactHistory,compactedTurnInput,maybeCompact,replaceSessionHistory};
1
+ import{openWork}from"#protocol/session-projection/selectors.js";import{streamText}from"ai";import{createLogger,logError}from"#internal/logging.js";import{contextStorage}from"#context/container.js";import{AuthKey,HistoryStateKey}from"#context/keys.js";import{toErrorMessage}from"#shared/errors.js";import{takeCompactionCaptureFailure}from"#reactions/kinds/memory.js";import{addTokenUsage}from"#shared/token-usage-math.js";import{isUserModelMessage,validateHarnessModelMessages}from"#harness/messages.js";import{controlDeliveryFor}from"#harness/session-machine/transitions.js";import{NO_USAGE,markUsageReported}from"#harness/session-usage.js";import{nextChangeId,nextRunId}from"#protocol/session-projection.js";import{contextStarted,controlAdmitted,deliveryApplied,fact,runRequested,runSettledFacts,runStarted,usageOf}from"#harness/facts.js";import{CompactionOverLimitError}from"#harness/compaction/over-limit-error.js";import{estimateTokens}from"#harness/token-estimate.js";import{compactMessages,getInputTokenCount,shouldCompact,withoutPromptMeasurement}from"#harness/compaction/engine.js";import{requireSessionModelReference}from"#harness/types.js";import{buildGatewayAttributionHeaders,resolveEffectiveRuntimeModel,withGatewayTraceContext}from"#harness/model-call/model.js";import{normalizeModelStreamError}from"#harness/model-call/errors.js";import{runModelCallWithRetries}from"#harness/model-call/retry.js";import{extractGatewayCostUsd,extractTokenUsageDelta,gatewayModelId}from"#harness/model-call/usage.js";import{resolveModelProfile}from"#harness/model-profile.js";import{resolveCallProviderOptions}from"#harness/provider-safety.js";const log=createLogger(`harness.tool-loop`);function assertFixedPartFits(e){let t=e.requestEnvelopeTokens+e.protectedTokens;if(t>=e.threshold)throw new CompactionOverLimitError(`The agent's system prompt, tools, memory and context take ~${Math.round(t)} tokens, over this model's ~${e.threshold}-token compaction limit. Shorten the instructions, remove tools or trim memory.`)}async function compactHistory(e){let{config:t}=e,{projection:n}=e.view(),r=controlDeliveryFor(e.view(),t.controlDelivery),{deliveryId:i}=r,a=nextChangeId(n);if(e.session.history.length===0)return await e.apply([controlAdmitted(r,`compact`),deliveryApplied(i)]),{next:null,session:e.session};let o=validateHarnessModelMessages(e.session.history);await e.apply([controlAdmitted(r,`compact`),contextStarted({cause:{deliveryId:i},changeId:a,kind:`compaction`})],o);let s=nextRunId(e.view().projection),c=`applied`;try{await e.apply([runRequested({changeId:a},s)],o);let n=await resolveEffectiveRuntimeModel({config:t,ctx:e.ctx,session:e.session});e.session=n.session;let r=e.session.agent.compactionModelReference??requireSessionModelReference(e.session);await e.publish(runStarted({attempt:0,modelId:r.id,runId:s}));let i=await maybeCompact({abortSignal:t.abortSignal,auth:e.ctx?.get(AuthKey)??null,betweenTurns:!0,change:{announced:!0,changeId:a,summaryRunId:s},ctx:e.ctx,emissionState:e.position(),force:!0,messages:[...e.session.history],model:n.model,publish:e.publish,view:()=>e.view().projection.view,requestEnvelopeTokens:e.session.compaction.requestEnvelopeTokens,resolveModel:t.resolveModel,runtimeIdentity:t.runtimeIdentity,session:e.session,prepareTelemetry:t=>e.instrumentation?.prepareAttempt({runId:t,attempt:0}).telemetry,traceContextHeaders:e.instrumentation?.gatewayTraceContextHeaders});if(e.session=i.session,i.failure!==void 0)throw i.failure.error}catch(t){c=`failed`;let n=summaryFailed(e.view().projection.view,{changeId:a,error:t});n.length>0&&await e.publish(n),logError(log,`manual session compaction failed`,t,{sessionId:e.session.sessionId})}let l=c===`failed`?`compaction-failed`:void 0;return await e.apply([fact(`delivery.settled`,{deliveryId:i,outcome:c,reason:l})]),{next:null,session:e.session}}function summaryUsageOf(e){let t=e.filter(e=>e!==void 0);if(t.length!==0)return t.reduce((e,t)=>addTokenUsage(e,usageOf(t)),NO_USAGE)}function summaryFailed(e,t){if(e.changes[t.changeId]?.status!==`running`)return[];let n={code:`COMPACTION_FAILED`,message:toErrorMessage(t.error)},r=openWork(e,{changeId:t.changeId}).runs,{spent:i}=t;return[...r.flatMap(({runId:e})=>runSettledFacts({error:n,outcome:`failed`,runId:e,...i?.runId===e&&{usage:i.usage}})),{data:{changeId:t.changeId,error:n,kind:e.changes[t.changeId]?.kind??`compaction`,outcome:`failed`},type:`context.settled`}]}function replaceSessionHistory(e,t){return contextStorage.getStore()?.delete(HistoryStateKey),{...e,history:t,compaction:withoutPromptMeasurement(e.compaction)}}async function maybeCompact(e){try{return await compactOnce(e)}catch(t){let n=summaryFailed(e.view(),{changeId:e.change.changeId,error:t});throw n.length>0&&await e.publish(n),t}}async function compactOnce(e){let{emissionState:t,publish:n}=e,r=e.messages,i=e.session,a=e.promptMessages??r,o=validateHarnessModelMessages(a),s=e.force===!0||shouldCompact(o,i.compaction,e.requestEnvelopeTokens,i.compaction.requestEnvelopeTokens);if(!s)return{compacted:!1,messages:r,session:i};let c=requireSessionModelReference(i),l=i.agent.compactionModelReference??c,u=l===c?e.model:await e.resolveModel(l),d=resolveModelProfile(u),f=resolveCallProviderOptions({auth:e.auth,profile:d,providerOptions:l.providerOptions,session:i}),p={abortSignal:e.abortSignal,headers:buildGatewayAttributionHeaders(d,e.runtimeIdentity),model:withGatewayTraceContext(u,d,e.traceContextHeaders),providerOptions:f,telemetry:e.telemetry&&{...e.telemetry,functionId:`eve.compaction`}},m,h=[],{change:g}=e,_=g.announced===!0,summarize=async r=>{_||(_=!0,await n([runRequested({changeId:g.changeId},g.summaryRunId),runStarted({attempt:0,modelId:gatewayModelId(u)??`unknown`,runId:g.summaryRunId})]));let a=await runModelCallWithRetries(()=>streamCompactionSummary({...p,telemetry:m??p.telemetry,...r}),{sessionId:i.sessionId,turnId:t.turnId},e.abortSignal);if(h.push(a.usage),a.text.trim().length===0)throw Error(`The compaction model returned an empty summary. Finish reason: ${a.finishReason}.`);return a.text};if(g.announced!==!0){let t=getInputTokenCount(o,i.compaction,e.requestEnvelopeTokens,i.compaction.requestEnvelopeTokens);await n(contextStarted({cause:g.cause,changeId:g.changeId,kind:`compaction`,trigger:e.force===!0||t===null?void 0:{inputTokens:t},turnId:g.turnId}),o)}s&&(m=e.prepareTelemetry?.(g.summaryRunId));let v=validateHarnessModelMessages(r),y=e.requestEnvelopeTokens??0,b=Math.max(0,estimateTokens(o)-estimateTokens(v)),x={...i.compaction,threshold:Math.max(1,i.compaction.threshold-y-b),lastKnownInputTokens:i.compaction.lastKnownInputTokens===void 0?void 0:Math.max(0,i.compaction.lastKnownInputTokens-Math.min(i.compaction.requestEnvelopeTokens??0,y))},S=[...v],C=takeCompactionCaptureFailure(e.ctx),w=C===void 0?void 0:{error:C};try{s&&w===void 0&&(assertFixedPartFits({protectedTokens:b,requestEnvelopeTokens:y,threshold:i.compaction.threshold}),S=await compactMessages([...v],x,summarize,e.force===!0,e.requestEnvelopeTokens===void 0?void 0:Math.max(0,getInputTokenCount(o,i.compaction,y,i.compaction.requestEnvelopeTokens)-y-b)))}catch(e){w={error:e}}let T=s?summaryUsageOf(h):void 0;T!==void 0&&e.betweenTurns===!0&&(i=markUsageReported(i,T));let E=g.summaryRunId;if(w!==void 0)return await n(summaryFailed(e.view(),{changeId:g.changeId,error:w.error,...T!==void 0&&{spent:{runId:E,usage:T}}})),{compacted:!1,failure:w,messages:e.messages,session:i};r=validateHarnessModelMessages(S);{let e=h.length>0?runSettledFacts({finishReason:`stop`,outcome:`completed`,runId:E,usage:T}):_?runSettledFacts({outcome:`abandoned`,runId:E}):[];e.push({data:{changeId:g.changeId,kind:`compaction`,outcome:`completed`},type:`context.settled`}),await n(e,r)}return{compacted:!0,messages:r,session:replaceSessionHistory(i,r)}}function compactedTurnInput(e){return e.findLast(e=>isUserModelMessage(e)&&e.kind===`user`)}async function streamCompactionSummary(e){let t=streamText({...e,onError:()=>{}});for await(let e of t.fullStream)if(e.type===`error`)throw normalizeModelStreamError(e.error);let[n,r,i,a]=await Promise.all([t.text,t.finishReason,t.usage,t.providerMetadata]);return{finishReason:r,text:n,usage:extractTokenUsageDelta({costUsd:extractGatewayCostUsd(a),usage:i})}}export{assertFixedPartFits,compactHistory,compactedTurnInput,maybeCompact,replaceSessionHistory};