eve 0.88.0 โ 0.88.1
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.
- package/CHANGELOG.md +13 -19
- package/dist/src/channel/interaction-prompts.d.ts +0 -2
- package/dist/src/channel/interaction-prompts.js +1 -1
- package/dist/src/compiled/.vendor-stamp.json +3 -3
- package/dist/src/execution/dynamic-workflow/tool.js +1 -1
- package/dist/src/execution/tools/agent-router-workflow.js +1 -1
- package/dist/src/instrumentation/content.js +1 -1
- package/dist/src/instrumentation/lifecycle.d.ts +5 -0
- package/dist/src/instrumentation/native-events.d.ts +4 -1
- package/dist/src/instrumentation/native-events.js +1 -1
- package/dist/src/instrumentation/principal-summary.d.ts +2 -0
- package/dist/src/instrumentation/principal-summary.js +1 -1
- package/dist/src/instrumentation/runtime.js +1 -1
- package/dist/src/instrumentation/session-context.js +1 -1
- package/dist/src/internal/application/stamped-package-version.js +1 -1
- package/dist/src/internal/invocation/agent-invocation.d.ts +2 -0
- package/dist/src/internal/invocation/workflow-execution.js +1 -1
- package/dist/src/protocol/session-projection/reader.d.ts +3 -1
- package/dist/src/protocol/session-projection/reader.js +1 -1
- package/dist/src/public/channels/mcp.js +1 -1
- package/dist/src/public/channels/slack/request-cards.js +2 -2
- package/dist/src/runtime/subagents/workflow.js +1 -1
- package/dist/src/setup/scaffold/create/project.js +1 -1
- package/dist/src/tools/provided/ask-question-workflow.js +1 -1
- package/dist/src/tools/provided/sleep-workflow.js +1 -1
- package/dist/src/tracing/eve/agent-approval-instrumentation.js +1 -1
- package/dist/src/tracing/eve/session.js +1 -1
- package/docs/channels/mcp.mdx +1 -1
- package/docs/guides/instrumentation/instrumentation.mdx +1 -1
- package/docs/tools/human-in-the-loop.md +2 -0
- package/package.json +3 -3
package/CHANGELOG.md
CHANGED
|
@@ -1,25 +1,19 @@
|
|
|
1
|
-
#
|
|
1
|
+
# eve 0.88.1
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Released 2026-10-29 ยท [Compare with 0.88.0](https://github.com/vercel/eve/compare/eve%400.88.0...eve%400.88.1)
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
## Features
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
- Approval spans now record who approved or denied the call as `agent.approval.responder.type` and `agent.approval.responder.id`, an approved call's tool span records its approver as `agent.tool.approver.type` and `agent.tool.approver.id`, and the `interaction.settled` instrumentation event carries the same `responder`.
|
|
8
|
+
An approved call runs as the requester, so until now traces showed only the requester and an audit had to read the session stream to find the approver. The responder's id follows the same rule as the turn's principal ids: it is recorded only when the trace policy records both inputs and outputs and the conversation is public or running in development. ([#5596](https://github.com/vercel/eve/pull/5596))
|
|
9
|
+
- The MCP channel's `agent_get` now returns an optional `statusMessage` while an invocation is `working`.
|
|
10
|
+
It names the tool call that is running, using the tool's activity label when it has one, so MCP clients can show progress instead of a bare `working`. ([#5314](https://github.com/vercel/eve/pull/5314))
|
|
8
11
|
|
|
9
|
-
|
|
12
|
+
## Bug Fixes
|
|
10
13
|
|
|
11
|
-
-
|
|
14
|
+
- Release notes now list breaking changes first and use plain headings, one paragraph per change, and a single compare link.
|
|
15
|
+
A `minor` changeset always appears under Breaking Changes, so breaking changes merged with an internal PR title are no longer left out. The 0.86.0 and 0.87.0 notes now include the two breaking changes they missed. ([#5588](https://github.com/vercel/eve/pull/5588))
|
|
16
|
+
- Upgrade `undici` to `8.12.3` for the security fixes published in `8.12.2`.
|
|
17
|
+
A TLS 1.2 server that renegotiates to a certificate for another host now fails the `web_fetch` request instead of crashing the process. Thanks @pedro757 for reporting this in #5589. ([#5591](https://github.com/vercel/eve/pull/5591))
|
|
12
18
|
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
Slack message metadata is now grouped into `<sender>`, `<bot>`, and `<thread>` blocks. `sender_type` and `sender_id` become `type` and `id` inside `<sender>`, `bot_user_id` and `is_mentioned` become `id` and `mentioned` inside `<bot>`, and the team, channel, and timestamp fields move into `<thread>`.
|
|
16
|
-
|
|
17
|
-
## Other Changes
|
|
18
|
-
|
|
19
|
-
See the [full list of changes](https://github.com/vercel/eve/compare/eve%400.87.0...eve%400.88.0).
|
|
20
|
-
|
|
21
|
-
## Contributors
|
|
22
|
-
|
|
23
|
-
- [@ruiconti](https://github.com/ruiconti)
|
|
24
|
-
|
|
25
|
-
For an upgrade across multiple releases, review each version between the installed and target versions in the [target version's changelog](https://raw.githubusercontent.com/vercel/eve/refs/tags/eve%400.88.0/packages/eve/CHANGELOG.md).
|
|
19
|
+
For an upgrade across multiple releases, review each version between the installed and target versions in the [target version's changelog](https://raw.githubusercontent.com/vercel/eve/refs/tags/eve%400.88.1/packages/eve/CHANGELOG.md).
|
|
@@ -46,8 +46,6 @@ export declare function firstOpenRequest(view: SessionView): Interaction | undef
|
|
|
46
46
|
export declare function requestSettlementOf(view: SessionView, data: InteractionSettledData): RequestSettlement | undefined;
|
|
47
47
|
/** An answer a check or policy refused, from its `response.settled`. */
|
|
48
48
|
export declare function refusedAnswerOf(view: SessionView, data: ResponseSettledData): RefusedAnswer | undefined;
|
|
49
|
-
/** Who gave an answer: the principal of the delivery it arrived in. */
|
|
50
|
-
export declare function responderOf(view: SessionView, responseId: string): Principal | undefined;
|
|
51
49
|
/** An option's style a channel can render: a style a newer eve added reads as none. */
|
|
52
50
|
export declare function optionStyle(option: {
|
|
53
51
|
readonly style?: string;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
import{decidingAnswer,interaction,interaction as interaction$1,promptQueueHead,signInEnding}from"#protocol/session-projection/reader.js";import{interactionBatches,interactionOwner}from"#protocol/session-projection/selectors.js";function requestBatchOf(e,t){let n=e.interactions[t.interactionId],r=interactionBatches(e).find(e=>e[0]===n);if(n===void 0||r===void 0)return;let i=r.flatMap(t=>interaction$1(e,t.interactionId)??[]);if(i.length===0)return;let a=interactionOwner(e,n),o={requests:i,turnId:a.turnId??``};return a.taskId!==void 0&&(o.taskId=a.taskId),(n.origin!==void 0||n.request.kind===`question`)&&`callId`in n.subject&&(o.callId=n.subject.callId),o}function firstOpenRequest(e){let t=promptQueueHead(e);return t===void 0?void 0:interaction$1(e,t.interactionId)}function requestSettlementOf(e,t){let n=e.interactions[t.interactionId];if(n===void 0||n.request.kind===`sign-in`)return;let r={interactionId:n.interactionId,kind:n.request.kind,outcome:t.outcome},i=decidingAnswer({...n,response:t.response});i!==void 0&&(r.answer=i),t.reason!==void 0&&(r.reason=t.reason);let a=t.cause!==void 0&&`responseId`in t.cause?responderOf(e,t.cause.responseId):void 0;return a!==void 0&&(r.responder=a),r}function refusedAnswerOf(e,t){if(t.outcome!==`refused`&&t.outcome!==`failed`)return;let n=e.responses[t.responseId];if(n===void 0)return;let r={interactionId:n.interactionId,outcome:t.outcome};t.reason!==void 0&&(r.reason=t.reason);let i=responderOf(e,t.responseId);return i!==void 0&&(r.responder=i),r}function
|
|
1
|
+
import{decidingAnswer,interaction,interaction as interaction$1,promptQueueHead,responderOf,signInEnding}from"#protocol/session-projection/reader.js";import{interactionBatches,interactionOwner}from"#protocol/session-projection/selectors.js";function requestBatchOf(e,t){let n=e.interactions[t.interactionId],r=interactionBatches(e).find(e=>e[0]===n);if(n===void 0||r===void 0)return;let i=r.flatMap(t=>interaction$1(e,t.interactionId)??[]);if(i.length===0)return;let a=interactionOwner(e,n),o={requests:i,turnId:a.turnId??``};return a.taskId!==void 0&&(o.taskId=a.taskId),(n.origin!==void 0||n.request.kind===`question`)&&`callId`in n.subject&&(o.callId=n.subject.callId),o}function firstOpenRequest(e){let t=promptQueueHead(e);return t===void 0?void 0:interaction$1(e,t.interactionId)}function requestSettlementOf(e,t){let n=e.interactions[t.interactionId];if(n===void 0||n.request.kind===`sign-in`)return;let r={interactionId:n.interactionId,kind:n.request.kind,outcome:t.outcome},i=decidingAnswer({...n,response:t.response});i!==void 0&&(r.answer=i),t.reason!==void 0&&(r.reason=t.reason);let a=t.cause!==void 0&&`responseId`in t.cause?responderOf(e,t.cause.responseId):void 0;return a!==void 0&&(r.responder=a),r}function refusedAnswerOf(e,t){if(t.outcome!==`refused`&&t.outcome!==`failed`)return;let n=e.responses[t.responseId];if(n===void 0)return;let r={interactionId:n.interactionId,outcome:t.outcome};t.reason!==void 0&&(r.reason=t.reason);let i=responderOf(e,t.responseId);return i!==void 0&&(r.responder=i),r}function optionStyle(e){let{style:t}=e;return t===`primary`||t===`danger`||t==="default"?t:void 0}export{firstOpenRequest,interaction,optionStyle,refusedAnswerOf,requestBatchOf,requestSettlementOf,signInEnding};
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
"moduleFingerprints": {
|
|
3
3
|
"@eve/catalog": "29b7529f6044427c750e4c27fe91da792014c60c660db31b7ca1fff0afe7f603",
|
|
4
4
|
"just-secrets": "1ce67d437d0bb06df02e4e99180a3c5f5edf0010314010226e97b96d462bba5d",
|
|
5
|
-
"@vercel/agent-runs": "
|
|
5
|
+
"@vercel/agent-runs": "8a64c66bdfa39999f05321865b37e84aba509ff993db76e7fe988e8630d756b0",
|
|
6
6
|
"@workflow/world-local": "a10e78551f65fc607cf75261a569d852c40bc9cfac13a7fb6e15c88bf1ccf429"
|
|
7
7
|
},
|
|
8
8
|
"moduleVersions": {
|
|
@@ -42,7 +42,7 @@
|
|
|
42
42
|
"@shadcn/registry": "0.1.3",
|
|
43
43
|
"@standard-schema/spec": "1.1.0",
|
|
44
44
|
"turndown": "7.2.4",
|
|
45
|
-
"@vercel/agent-runs": "0.0.
|
|
45
|
+
"@vercel/agent-runs": "0.0.4",
|
|
46
46
|
"@vercel/blob": "2.8.0",
|
|
47
47
|
"@vercel/connect": "2.5.2",
|
|
48
48
|
"@vercel/detect-agent": "1.2.3",
|
|
@@ -61,7 +61,7 @@
|
|
|
61
61
|
"zod": "4.5.4",
|
|
62
62
|
"zod-validation-error": "5.0.0"
|
|
63
63
|
},
|
|
64
|
-
"scriptHash": "
|
|
64
|
+
"scriptHash": "8d606c6729fcbfca8be615a4186723cebba6b9e35208bf6c160be584417b2928",
|
|
65
65
|
"toolVersions": {
|
|
66
66
|
"rolldown": "1.2.9",
|
|
67
67
|
"typescript": "7.0.2"
|
|
@@ -1 +1 @@
|
|
|
1
|
-
import{runJsProgram}from"#execution/dynamic-workflow/workflow.js";async function runWorkflowProgramTask(e,t){"use workflow";return runJsProgram(e.js,t,{maxSubagents:e.maxSubagents??0})}runWorkflowProgramTask.workflowId=`workflow//eve@0.88.
|
|
1
|
+
import{runJsProgram}from"#execution/dynamic-workflow/workflow.js";async function runWorkflowProgramTask(e,t){"use workflow";return runJsProgram(e.js,t,{maxSubagents:e.maxSubagents??0})}runWorkflowProgramTask.workflowId=`workflow//eve@0.88.1//runWorkflowProgramTask`;export{runWorkflowProgramTask};
|
|
@@ -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.88.
|
|
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.88.1//runAgentRouterTask`;export{runAgentRouterTask};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
import{readGatewayRouting}from"#shared/gateway-routing.js";function withoutInstrumentationContent(e){return withInstrumentationDecision(e,{action:`record`,recordInputs:!1,recordOutputs:!1})}function withInstrumentationDecision(e,t){switch(e.type){case`session.started`:return t.recordInputs?e:Object.freeze({...e,title:void 0});case`call.requested`:return t.recordInputs?e:Object.freeze({...e,input:void 0,capability:Object.freeze({...e.capability,label:void 0})});case`delivery.consumed`:case`model.call.started`:return t.recordInputs?e:Object.freeze({...e,input:void 0});case`interaction.opened`:return t.recordOutputs?e:Object.freeze({...e,request:void 0});case`interaction.settled`:return Object.freeze({...e,error:t.recordOutputs?e.error:void 0,answer:t.recordInputs?e.answer:void 0});case`call.settled`:return t.recordOutputs?e:Object.freeze({...e,error:void 0,output:void 0});case`model.call.settled`:return e.outcome===`failed`?t.recordOutputs?e:Object.freeze({...e,error:void 0}):t.recordOutputs?e:Object.freeze({...e,content:void 0,providerMetadata:e.providerMetadata===void 0?void 0:structuralProviderMetadata(e.providerMetadata)});case`memory.operation.settled`:return e.outcome===`failed`?t.recordOutputs?e:Object.freeze({...e,error:void 0}):t.recordInputs?e:Object.freeze({...e,outputRecords:void 0});case`model.retried`:case`model.settled`:case`session.ended`:case`turn.settled`:return t.recordOutputs?e:Object.freeze({...e,error:void 0});default:return e}}function structuralProviderMetadata(e){let t=e.gateway;if(typeof t!=`object`||!t||Array.isArray(t))return Object.freeze({});let n=t,r={};for(let e of[`cost`,`generationId`]){let t=n[e];(typeof t==`string`||typeof t==`number`)&&(r[e]=t)}let i=readGatewayRouting(n.routing);return i!==void 0&&(r.routing=i),Object.freeze(Object.keys(r).length===0?{}:{gateway:Object.freeze(r)})}export{structuralProviderMetadata,withInstrumentationDecision,withoutInstrumentationContent};
|
|
1
|
+
import{applyPrincipalTraceDecision}from"#instrumentation/principal-summary.js";import{readGatewayRouting}from"#shared/gateway-routing.js";function withoutInstrumentationContent(e){return withInstrumentationDecision(e,{action:`record`,recordInputs:!1,recordOutputs:!1})}function withInstrumentationDecision(e,t){switch(e.type){case`session.started`:return t.recordInputs?e:Object.freeze({...e,title:void 0});case`call.requested`:return t.recordInputs?e:Object.freeze({...e,input:void 0,capability:Object.freeze({...e.capability,label:void 0})});case`delivery.consumed`:case`model.call.started`:return t.recordInputs?e:Object.freeze({...e,input:void 0});case`interaction.opened`:return t.recordOutputs?e:Object.freeze({...e,request:void 0});case`interaction.settled`:return Object.freeze({...e,error:t.recordOutputs?e.error:void 0,answer:t.recordInputs?e.answer:void 0,responder:applyPrincipalTraceDecision(e.responder,t)});case`call.settled`:return t.recordOutputs?e:Object.freeze({...e,error:void 0,output:void 0});case`model.call.settled`:return e.outcome===`failed`?t.recordOutputs?e:Object.freeze({...e,error:void 0}):t.recordOutputs?e:Object.freeze({...e,content:void 0,providerMetadata:e.providerMetadata===void 0?void 0:structuralProviderMetadata(e.providerMetadata)});case`memory.operation.settled`:return e.outcome===`failed`?t.recordOutputs?e:Object.freeze({...e,error:void 0}):t.recordInputs?e:Object.freeze({...e,outputRecords:void 0});case`model.retried`:case`model.settled`:case`session.ended`:case`turn.settled`:return t.recordOutputs?e:Object.freeze({...e,error:void 0});default:return e}}function structuralProviderMetadata(e){let t=e.gateway;if(typeof t!=`object`||!t||Array.isArray(t))return Object.freeze({});let n=t,r={};for(let e of[`cost`,`generationId`]){let t=n[e];(typeof t==`string`||typeof t==`number`)&&(r[e]=t)}let i=readGatewayRouting(n.routing);return i!==void 0&&(r.routing=i),Object.freeze(Object.keys(r).length===0?{}:{gateway:Object.freeze(r)})}export{structuralProviderMetadata,withInstrumentationDecision,withoutInstrumentationContent};
|
|
@@ -169,6 +169,11 @@ export interface InstrumentationInteractionSettledEvent {
|
|
|
169
169
|
readonly outcome: InstrumentationInteractionOutcome;
|
|
170
170
|
/** Content. Absent unless this provider's trace policy records this direction. */
|
|
171
171
|
readonly answer?: InstrumentationAnswer;
|
|
172
|
+
/**
|
|
173
|
+
* Who decided the request, as their response's delivery was admitted. Absent when no response
|
|
174
|
+
* decided it. Its `id` is absent unless this provider's trace policy records both directions.
|
|
175
|
+
*/
|
|
176
|
+
readonly responder?: InstrumentationPrincipalSummary;
|
|
172
177
|
readonly scope: InstrumentationScope;
|
|
173
178
|
}
|
|
174
179
|
/** Runtime action call IDs are durable and unique within one session. */
|
|
@@ -1,7 +1,8 @@
|
|
|
1
1
|
import type { DeliverHookPayload } from "#channel/types.js";
|
|
2
2
|
import type { InstrumentationScope, InstrumentationHooks, InstrumentationParentLineage, InstrumentationTraceContext } from "#instrumentation/lifecycle.js";
|
|
3
3
|
import type { HandleEventFn } from "#harness/types.js";
|
|
4
|
-
import type
|
|
4
|
+
import { type ChannelAudience } from "#shared/channel-audience.js";
|
|
5
|
+
import type { ConversationEnvironment } from "#shared/conversation-context.js";
|
|
5
6
|
export interface CreateInstrumentationHandleEventInput {
|
|
6
7
|
readonly deliveryInput?: DeliverHookPayload;
|
|
7
8
|
readonly isFrameworkTool?: (name: string) => boolean;
|
|
@@ -10,6 +11,8 @@ export interface CreateInstrumentationHandleEventInput {
|
|
|
10
11
|
readonly agentName?: string;
|
|
11
12
|
readonly channelKind?: string;
|
|
12
13
|
readonly channelAudience?: ChannelAudience;
|
|
14
|
+
/** With `channelAudience`, whether principal ids may be recorded; absent counts as production. */
|
|
15
|
+
readonly environment?: ConversationEnvironment;
|
|
13
16
|
readonly handleEvent?: HandleEventFn;
|
|
14
17
|
readonly hooks?: InstrumentationHooks;
|
|
15
18
|
readonly parentLineage?: InstrumentationParentLineage;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
import{isTerminalType}from"#protocol/session-events/catalog.js";import{copyView,foldReceivedEvent}from"#protocol/session-projection/fold.js";import{askedCall,decidingAnswer}from"#protocol/session-projection/reader.js";import{callRun,runTurn}from"#protocol/session-projection/selectors.js";import{contextStorage}from"#context/container.js";import{currentView,enteredView}from"#harness/session-machine/current.js";import{cascade}from"#harness/session-machine/cascade.js";import{eventsOf}from"#harness/publication.js";import{isTurnCancellation}from"#harness/turn-cancellation.js";import{RuntimeActionSettlementTimesKey}from"#harness/runtime-action-settlement-state.js";import{actionIdempotencyKey,attemptIdempotencyKey,inputIdempotencyKey,sessionIdempotencyKey,turnIdempotencyKey}from"#instrumentation/lifecycle.js";import{instrumentationScope}from"#instrumentation/scope.js";import{deliveryEvent}from"#instrumentation/channel-delivery.js";function attemptScopeOf(e,{runId:t,attempt:n,stepIndex:r,turnId:i}){return instrumentationScope({runId:t,attempt:n,channelAudience:e.channelAudience,functionId:e.functionId,rootSessionId:e.rootSessionId,sessionId:e.sessionId,traceSessionId:e.traceSessionId,turnId:i},r)}function createInstrumentationHandleEvent(e){if(e.hooks===void 0)return e.handleEvent;if(e.handleEvent===void 0)return;let{handleEvent:t,hooks:n}=e;return async(r,i)=>{let a=Date.now(),o=contextStorage.getStore(),s=o===void 0?void 0:enteredView(o),c;try{await t(r,i)}catch(e){if(!isTurnCancellation(e)||s===void 0||o===void 0||currentView(o).position<=s.position)throw e;c={error:e}}let l=eventsOf(r),u=s!==void 0&&l.some(e=>isTerminalType(e.type))?cascade(s,l):l,d=s===void 0?void 0:copyView(s);if(d!==void 0)for(let e of u)foldReceivedEvent(d,{...e,meta:{endOfLine:!1}});let f=
|
|
1
|
+
import{isTerminalType}from"#protocol/session-events/catalog.js";import{copyView,foldReceivedEvent}from"#protocol/session-projection/fold.js";import{askedCall,decidingAnswer,responderOf}from"#protocol/session-projection/reader.js";import{callRun,runTurn}from"#protocol/session-projection/selectors.js";import{normalizeChannelAudience}from"#shared/channel-audience.js";import{contextStorage}from"#context/container.js";import{currentView,enteredView}from"#harness/session-machine/current.js";import{shouldCaptureInstrumentationContent}from"#shared/instrumentation-content.js";import{cascade}from"#harness/session-machine/cascade.js";import{eventsOf}from"#harness/publication.js";import{isTurnCancellation}from"#harness/turn-cancellation.js";import{RuntimeActionSettlementTimesKey}from"#harness/runtime-action-settlement-state.js";import{actionIdempotencyKey,attemptIdempotencyKey,inputIdempotencyKey,sessionIdempotencyKey,turnIdempotencyKey}from"#instrumentation/lifecycle.js";import{instrumentationPrincipal}from"#instrumentation/principal-summary.js";import{instrumentationScope}from"#instrumentation/scope.js";import{deliveryEvent}from"#instrumentation/channel-delivery.js";function attemptScopeOf(e,{runId:t,attempt:n,stepIndex:r,turnId:i}){return instrumentationScope({runId:t,attempt:n,channelAudience:e.channelAudience,functionId:e.functionId,rootSessionId:e.rootSessionId,sessionId:e.sessionId,traceSessionId:e.traceSessionId,turnId:i},r)}function createInstrumentationHandleEvent(e){if(e.hooks===void 0)return e.handleEvent;if(e.handleEvent===void 0)return;let{handleEvent:t,hooks:n}=e;return async(r,i)=>{let a=Date.now(),o=contextStorage.getStore(),s=o===void 0?void 0:enteredView(o),c;try{await t(r,i)}catch(e){if(!isTurnCancellation(e)||s===void 0||o===void 0||currentView(o).position<=s.position)throw e;c={error:e}}let l=eventsOf(r),u=s!==void 0&&l.some(e=>isTerminalType(e.type))?cascade(s,l):l,d=s===void 0?void 0:copyView(s);if(d!==void 0)for(let e of u)foldReceivedEvent(d,{...e,meta:{endOfLine:!1}});let f=n.capturesInputs??n.capturesContent??!1,p=n.capturesOutputs??n.capturesContent??!1,m={attemptScope:t=>attemptScopeOf(e,t),capturesInputs:f,capturesOutputs:p,capturesPrincipalIds:f&&p&&shouldCaptureInstrumentationContent({audience:normalizeChannelAudience(e.channelAudience),environment:e.environment??`production`}),settledAtMs:o?.get(RuntimeActionSettlementTimesKey),startedAtMs:a,view:d??(o===void 0?void 0:currentView(o))};for(let t of u){let r=deliveryEvent(t,o,e);r!==void 0&&await n.publish(Object.freeze(r));for(let r of instrumentationEventsOf(t,m,e))await n.publish(Object.freeze(r))}if(c!==void 0)throw c.error}}function instrumentationEventsOf(e,t,n){let{sessionId:r}=n,i=sessionIdempotencyKey(r);switch(e.type){case`session.started`:return[{agentName:n.agentName,channelAudience:n.channelAudience,channelKind:n.channelKind,idempotencyKey:i,parentLineage:n.parentLineage,parentTraceContext:n.parentTraceContext,rootSessionId:n.rootSessionId??r,traceSessionId:n.traceSessionId,scheduleId:n.scheduleId,sessionId:r,title:n.title,type:`session.started`}];case`session.ended`:{let{cause:n}=e.data,a=n!==void 0&&`turnId`in n?n.turnId:latestTurnId(t.view),{outcome:o}=e.data;return[{error:o===`failed`?Error(e.data.error?.message??`The session failed.`):void 0,idempotencyKey:i,outcome:o,sessionId:r,turnId:a,type:`session.ended`}]}case`turn.started`:return[{idempotencyKey:turnIdempotencyKey(r,e.data.turnId),parentLineage:n.parentLineage,parentTraceContext:n.parentTraceContext,rootSessionId:n.rootSessionId??r,traceSessionId:n.traceSessionId,sequence:turnSequence(e.data.turnId),sessionId:r,turnId:e.data.turnId,type:`turn.started`}];case`turn.settled`:{let{outcome:t,turnId:n}=e.data;return[{error:t===`failed`?Error(e.data.error?.message??`The turn failed.`):void 0,idempotencyKey:turnIdempotencyKey(r,n),outcome:t,sessionId:r,turnId:n,type:`turn.settled`}]}case`model.retried`:{let n=runAttempt(t,e.data.runId);return n===void 0?[]:[{error:Error(e.data.error.message),idempotencyKey:attemptIdempotencyKey(n),scope:n,type:`model.retried`}]}case`model.settled`:{let n=runAttempt(t,e.data.runId);if(n===void 0)return[];let{error:r,outcome:i}=e.data,a=attemptIdempotencyKey(n),o=i===`interrupted`&&n.turnId!==void 0&&t.view?.turns[n.turnId]?.outcome===`cancelled`;return[{error:r===void 0?void 0:Error(r.message),idempotencyKey:a,scope:n,outcome:o?`cancelled`:i,type:`model.settled`}]}case`call.requested`:{let i=t.view?.calls[e.data.callId],a=i===void 0?void 0:runAttempt(t,callRun(t.view,i));if(a===void 0)return[];let{callId:o,capability:s}=e.data,c=s.name;return[{callId:o,frameworkTool:s.kind===`skill`||n.isFrameworkTool?.(c)===!0,idempotencyKey:actionIdempotencyKey(r,a.turnId,o),input:t.capturesInputs?e.data.input:void 0,capability:s,scope:a,startedAtMs:t.startedAtMs,toolName:c,type:`call.requested`}]}case`call.settled`:{let{callId:n,outcome:i}=e.data,a=t.view?.calls[n],o=a===void 0?void 0:runAttempt(t,callRun(t.view,a));if(o===void 0)return[];let s=actionIdempotencyKey(r,o.turnId,n),c=i===`completed`?e.data.output:void 0,l=i===`completed`?void 0:e.data.error===void 0?e.data.output:Object.assign(Error(e.data.error.message),{code:e.data.error.code,name:e.data.error.name??`Error`});return[{acceptedAtMs:t.settledAtMs?.[n],cause:e.data.cause,error:t.capturesOutputs?l:void 0,errorCode:e.data.error?.code,idempotencyKey:s,outcome:i,reason:e.data.reason,output:t.capturesOutputs?c:void 0,scope:o,type:`call.settled`,usage:a?.usage}]}case`interaction.opened`:{let n=t.view?.interactions[e.data.interactionId],i=n===void 0?void 0:interactionAttempt(t,n);if(n===void 0||i===void 0)return[];let{request:a}=n,o=askedCall(t.view,n);return[{call:o===void 0?void 0:{callId:o.callId,name:o.name},idempotencyKey:inputIdempotencyKey(r,i.turnId,n.interactionId),interactionId:n.interactionId,kind:a.kind,request:t.capturesOutputs?{allowFreeform:a.allowFreeform,display:a.display,options:a.options,prompt:a.prompt,title:a.title}:void 0,scope:i,type:`interaction.opened`}]}case`interaction.settled`:{let n=t.view?.interactions[e.data.interactionId],i=n===void 0?void 0:interactionAttempt(t,n);if(n===void 0||i===void 0)return[];let a=decidingAnswer(n);return[{answer:!t.capturesInputs||a===void 0?void 0:{optionId:a.optionId,text:a.text},idempotencyKey:inputIdempotencyKey(r,i.turnId,n.interactionId),interactionId:n.interactionId,kind:n.request.kind,outcome:e.data.outcome,responder:responderSummary(t.view,e.data.cause,t.capturesPrincipalIds),scope:i,type:`interaction.settled`}]}default:return[]}}function responderSummary(e,t,n){if(t===void 0||!(`responseId`in t))return;let r=responderOf(e,t.responseId);return r===void 0?void 0:instrumentationPrincipal(r.type,n?r.id:void 0)}function runAttempt(e,t){let n=t===void 0?void 0:e.view?.runs[t];if(n?.attempt===void 0)return;let r=runTurn(e.view,n.runId);return e.attemptScope({runId:n.runId,attempt:n.attempt,stepIndex:n.step,turnId:r})}function interactionAttempt(e,t){let n=e.view;if(t.request.kind===`sign-in`)return;let{subject:r}=t;if(`callId`in r){let t=n.calls[r.callId];return t===void 0?void 0:runAttempt(e,callRun(n,t))}if(`taskId`in r){let t=n.tasks[r.taskId],i=t===void 0?void 0:n.calls[t.startedBy.callId];return i===void 0?void 0:runAttempt(e,callRun(n,i))}return`turnId`in r?runAttempt(e,Object.values(n.runs).filter(e=>e.attempt!==void 0&&runTurn(n,e.runId)===r.turnId).at(-1)?.runId):void 0}function latestTurnId(e){return(e===void 0?[]:Object.keys(e.turns)).at(-1)}function turnSequence(e){let t=/^turn_(\d+)$/.exec(e);return t===null?0:Number(t[1])}export{attemptScopeOf,createInstrumentationHandleEvent};
|
|
@@ -4,6 +4,8 @@ import { type InstrumentationPrincipalSummary } from "#instrumentation/lifecycle
|
|
|
4
4
|
import { type InstrumentationContentContext } from "#shared/instrumentation-content.js";
|
|
5
5
|
import type { InstrumentationDecision } from "#shared/instrumentation-decision.js";
|
|
6
6
|
export declare function summarizeInstrumentationPrincipal(principal: SessionAuthContext | null | undefined, content: InstrumentationContentContext): InstrumentationPrincipalSummary | undefined;
|
|
7
|
+
/** A principal as instrumentation records it: a known type, plus its id when given and bounded. */
|
|
8
|
+
export declare function instrumentationPrincipal(principalType: string, principalId: string | undefined): InstrumentationPrincipalSummary;
|
|
7
9
|
export declare function applyPrincipalTraceDecision(principal: InstrumentationPrincipalSummary | undefined, decision: InstrumentationDecision | undefined): InstrumentationPrincipalSummary | undefined;
|
|
8
10
|
export declare function readInstrumentationPrincipals(context: ContextReader, content: InstrumentationContentContext, decision?: InstrumentationDecision): {
|
|
9
11
|
readonly currentPrincipal?: InstrumentationPrincipalSummary;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
import{AuthKey,InitiatorAuthKey}from"#context/keys.js";import{shouldCaptureInstrumentationContent}from"#shared/instrumentation-content.js";import{resolveTracePolicyDecision}from"#shared/trace-policy.js";import{isInstrumentationPrincipalType}from"#instrumentation/lifecycle.js";import{boundedPrincipalId}from"#compiled/@vercel/agent-runs/otel.js";function summarizeInstrumentationPrincipal(e,t){if(e
|
|
1
|
+
import{AuthKey,InitiatorAuthKey}from"#context/keys.js";import{shouldCaptureInstrumentationContent}from"#shared/instrumentation-content.js";import{resolveTracePolicyDecision}from"#shared/trace-policy.js";import{isInstrumentationPrincipalType}from"#instrumentation/lifecycle.js";import{boundedPrincipalId}from"#compiled/@vercel/agent-runs/otel.js";function summarizeInstrumentationPrincipal(e,t){if(e!==void 0)return e===null?{type:`none`}:instrumentationPrincipal(e.principalType,shouldCaptureInstrumentationContent(t)?e.principalId:void 0)}function instrumentationPrincipal(e,t){let n=isInstrumentationPrincipalType(e)&&e!==`none`?e:`other`,r=boundedPrincipalId(t);return r===void 0?{type:n}:{id:r,type:n}}function applyPrincipalTraceDecision(e,t){if(e!==void 0)return e.type!==`none`&&t?.action===`record`&&t.recordInputs&&t.recordOutputs?e:{type:e.type}}function readInstrumentationPrincipals(e,t,n=resolveTracePolicyDecision(!0,t)){return{currentPrincipal:applyPrincipalTraceDecision(summarizeInstrumentationPrincipal(e.get(AuthKey),t),n),initiatorPrincipal:applyPrincipalTraceDecision(summarizeInstrumentationPrincipal(e.get(InitiatorAuthKey),t),n)}}export{applyPrincipalTraceDecision,instrumentationPrincipal,readInstrumentationPrincipals,summarizeInstrumentationPrincipal};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
import{ensureAiSdkWarningLogger}from"#instrumentation/ai-sdk-warnings.js";import{recordErrorOnSpan}from"#internal/logging.js";import{applyLiveDeliveryAudienceCeiling}from"#shared/forwarded-trace-policy.js";import{contextStorage}from"#context/container.js";import{ConversationIdKey,ParentSessionKey}from"#context/keys.js";import{readConversationId}from"#shared/conversation-identity.js";import{readSessionTraceDecision}from"#tracing/eve/agent-trace-context-store.js";import{resolveTraceRootSessionId}from"#shared/trace-root.js";import{shouldCaptureInstrumentationContent}from"#shared/instrumentation-content.js";import{isSampledTrace,resolveTracePolicy,resolveTracePolicyDecision}from"#shared/trace-policy.js";import{context,trace}from"#compiled/@opentelemetry/api/index.js";import{withCapture}from"#compiled/@vercel/agent-runs/otel.js";import{buildTelemetryRuntimeContext,snapshotInstrumentationRuntimeContext}from"#instrumentation/runtime-context.js";import{ensureOtelIntegration,getRegisteredTelemetryIntegrations}from"#instrumentation/ai-sdk-telemetry.js";import{createAiSdkHookBridge}from"#instrumentation/ai-sdk-hook-bridge.js";import{attemptScopeOf,createInstrumentationHandleEvent}from"#instrumentation/native-events.js";import{prepareTurnTraceContext}from"#instrumentation/prepare-trace-context.js";import"#compiled/@vercel/agent-runs/index.js";import{createMemoryInstrumentation}from"#instrumentation/memory.js";import{readInstrumentationSessionContext}from"#instrumentation/session-context.js";import{readInstrumentationDecision}from"#shared/instrumentation-decision.js";import{getInstrumentationRuntime,registerInstrumentationRuntime}from"#instrumentation/runtime-global.js";import{initializeSessionInstrumentation}from"#instrumentation/session-init.js";import{createGatewayTraceContextHeaders}from"#tracing/eve/gateway.js";const TURN_TRACE_STATE_KEY=`eve.harness.turnTrace`;function bindInstrumentationRuntime(e,t,n){let r={...n,traceSessionId:resolveTraceRootSessionId(t,n.sessionId)};if(readConversationId(t.get(ConversationIdKey))===void 0&&t.set(ConversationIdKey,t.get(ParentSessionKey)?.rootSessionId??r.rootSessionId),e===void 0)return;let i,a=e.hooks,o=r.traceSessionId,readSessionContext=()=>{let e=readInstrumentationSessionContext(contextStorage.getStore()??t);return{...e,rootSessionId:e.parent?.rootSessionId??r.rootSessionId,traceSessionId:o}},bindHooks=e=>a.forTrace?.({agentName:r.agentName,...e.conversation})??a,captureExecutionRuntime=()=>{let t=e.otelSettings,n=e.ownsAgentSpans===!0;return t!==void 0&&!n&&ensureOtelIntegration(),{ownsAgentSpans:n,otelSettings:t,runtimeContextResolvers:e.runtimeContextResolvers,tracer:t===void 0?void 0:trace.getTracer(`eve`)}},preparePreamble=(t,n)=>prepareTurnTraceContext({...t,instrumentation:e,principals:n.principals,session:{agentName:r.agentName,channelAudience:n.conversation.audience,channelKind:n.conversation.channel.kind,channelType:n.instrumentation?.channelType,parentLineage:n.parentLineage,parentTraceContext:n.parentTraceContext,rootSessionId:n.rootSessionId,traceSessionId:n.traceSessionId,scheduleId:n.scheduleId,sessionId:r.sessionId,title:n.title,traceSeed:n.traceSeed}}),s=e.memoryOperations===!0?createMemoryInstrumentation({resolveContext:()=>{let e=readSessionContext();return{hooks:bindHooks(e),rootSessionId:e.rootSessionId,traceSessionId:e.traceSessionId}},runInContext:e.runInContext,sessionId:r.sessionId}):void 0;return{prepareDelivery:e=>{i=e},createHandleEvent:e=>{let t=readSessionContext();return createInstrumentationHandleEvent({agentName:r.agentName,channelAudience:t.conversation.audience,channelKind:t.conversation.channel.kind,functionId:captureExecutionRuntime().otelSettings?.functionId??r.agentName,handleEvent:e.handleEvent,deliveryInput:i,hooks:bindHooks(t),rootSessionId:t.rootSessionId,traceSessionId:t.traceSessionId,parentLineage:t.parentLineage,parentTraceContext:t.parentTraceContext,scheduleId:t.scheduleId,sessionId:r.sessionId,title:t.title})},flush:e.forceFlush,memory:s,prepareExecution:()=>{let t=captureExecutionRuntime();return{installAiSdkWarningLogger:ensureAiSdkWarningLogger,runStep:async(n,a)=>{let o=readSessionContext(),s=bindHooks(o),c=t.otelSettings,l=resolveStepInstrumentationDecision(c,r.agentName,o.conversation,o.traceSeed,readSessionTraceDecision(o.context,r.sessionId)),u=t.tracer,d={"eve.environment":n.environment,"eve.session.id":n.session.sessionId,"eve.version":n.eveVersion},f=c?.functionId??r.agentName;f&&(d[`ai.telemetry.functionId`]=f);let p=u!==void 0&&!t.ownsAgentSpans&&l?.action!==`drop`&&n.hasInput?u.startSpan(`ai.eve.turn`,{attributes:d}):void 0,m=p?.spanContext(),h=m===void 0?n.session:{...n.session,state:{...n.session.state,[TURN_TRACE_STATE_KEY]:{spanId:m.spanId,traceFlags:m.traceFlags,traceId:m.traceId}}},g=p===void 0?void 0:trace.setSpan(context.active(),p);if(g===void 0&&u!==void 0){let e=n.session.state?.[TURN_TRACE_STATE_KEY];e!==void 0&&(g=trace.setSpan(context.active(),trace.wrapSpanContext({...e,isRemote:!0})))}let _=readSessionContext(),v=snapshotInstrumentationRuntimeContext(_.context),y=_.conversation,b=y.audience,x=shouldCaptureInstrumentationContent(y),S=l===void 0?l:applyLiveDeliveryAudienceCeiling(l,b,_.forwardedTracePolicy,y.environment),C=S===void 0?x:S.action===`record`&&S.recordInputs,w=l?.action===`drop`,T={recordInputs:!w&&(S?.action===`record`?S.recordInputs:x)&&(c?.recordInputs??!1),recordOutputs:!w&&(S?.action===`record`?S.recordOutputs:x)&&(c?.recordOutputs??!1)},telemetry=e=>{if(c===void 0&&e.bridgeIntegration===void 0)return;let n={};for(let t of Object.keys(e.runtimeContext??{}))n[t]=!0;let i=c!==void 0&&!(T.recordInputs&&T.recordOutputs),integrations=()=>getRegisteredTelemetryIntegrations({...t.ownsAgentSpans?{excludeEveOtelIntegration:!0}:void 0,sanitizeEveOtelErrors:i});return{functionId:c?.functionId??r.agentName,includeRuntimeContext:n,integrations:e.bridgeIntegration===void 0?i?[...integrations()]:void 0:[e.bridgeIntegration,...integrations()],isEnabled:!0,recordInputs:T.recordInputs,recordOutputs:T.recordOutputs}},E={channelAudience:b,functionId:c?.functionId??r.agentName,rootSessionId:_.rootSessionId,sessionId:r.sessionId,traceSessionId:_.traceSessionId},run=()=>a({gatewayTraceContextHeaders:createGatewayTraceContextHeaders,createHandleEvent:e=>createInstrumentationHandleEvent({...e,...E,deliveryInput:i,agentName:r.agentName,channelKind:y.channel.kind,hooks:s,parentLineage:_.parentLineage,parentTraceContext:_.parentTraceContext,scheduleId:_.scheduleId,title:_.title}),prepareAttempt:t=>{let n=attemptScopeOf(E,t),r=createAiSdkHookBridge(n,s,e.runInContext,t.runtimeContext,t.isFrameworkTool);return{scope:n,telemetry:telemetry({bridgeIntegration:r,runtimeContext:t.runtimeContext})}},preparePreamble:e=>preparePreamble(e,_),recordError:e=>{p!==void 0&&recordErrorOnSpan(p,e)},resolveRuntimeContext:e=>buildTelemetryRuntimeContext({...e,capturesContent:C,context:v,providerResolvers:t.runtimeContextResolvers}),session:h,setTurnId:e=>p?.setAttribute(`eve.turn.id`,e),telemetry:()=>telemetry({}),traceContext:m===void 0||!isValidSpanContext(m)?void 0:{spanId:m.spanId,traceFlags:m.traceFlags,traceId:m.traceId}});try{return await context.with(withCapture(g??context.active(),{emit:!0,recordInputs:T.recordInputs,recordOutputs:T.recordOutputs}),run)}finally{p?.end(),p=void 0}}}},preparePreamble:e=>preparePreamble(e,readSessionContext())}}function bindSessionInstrumentation(e){let t={agentName:e.agentName,rootSessionId:e.rootSessionId,traceSessionId:resolveTraceRootSessionId(e.ctx,e.sessionId),sessionId:e.sessionId};return bindInstrumentationRuntime(getInstrumentationRuntime(),e.ctx,t)}function resolveStepInstrumentationDecision(e,t,n,r,i){if(e!==void 0)return r?.decision===void 0?i===void 0?r===void 0?resolveTracePolicy(e.tracePolicy,{agentName:t,...n}):resolveTracePolicyDecision(isSampledTrace(r),n):i:readInstrumentationDecision(r.decision)}function isValidSpanContext(e){return/^[0-9a-f]{32}$/u.test(e.traceId)&&e.traceId!==`00000000000000000000000000000000`&&/^[0-9a-f]{16}$/u.test(e.spanId)&&e.spanId!==`0000000000000000`}export{bindInstrumentationRuntime,bindSessionInstrumentation,getInstrumentationRuntime,initializeSessionInstrumentation,registerInstrumentationRuntime};
|
|
1
|
+
import{ensureAiSdkWarningLogger}from"#instrumentation/ai-sdk-warnings.js";import{recordErrorOnSpan}from"#internal/logging.js";import{applyLiveDeliveryAudienceCeiling}from"#shared/forwarded-trace-policy.js";import{contextStorage}from"#context/container.js";import{ConversationIdKey,ParentSessionKey}from"#context/keys.js";import{readConversationId}from"#shared/conversation-identity.js";import{readSessionTraceDecision}from"#tracing/eve/agent-trace-context-store.js";import{resolveTraceRootSessionId}from"#shared/trace-root.js";import{shouldCaptureInstrumentationContent}from"#shared/instrumentation-content.js";import{isSampledTrace,resolveTracePolicy,resolveTracePolicyDecision}from"#shared/trace-policy.js";import{context,trace}from"#compiled/@opentelemetry/api/index.js";import{withCapture}from"#compiled/@vercel/agent-runs/otel.js";import{buildTelemetryRuntimeContext,snapshotInstrumentationRuntimeContext}from"#instrumentation/runtime-context.js";import{ensureOtelIntegration,getRegisteredTelemetryIntegrations}from"#instrumentation/ai-sdk-telemetry.js";import{createAiSdkHookBridge}from"#instrumentation/ai-sdk-hook-bridge.js";import{attemptScopeOf,createInstrumentationHandleEvent}from"#instrumentation/native-events.js";import{prepareTurnTraceContext}from"#instrumentation/prepare-trace-context.js";import"#compiled/@vercel/agent-runs/index.js";import{createMemoryInstrumentation}from"#instrumentation/memory.js";import{readInstrumentationSessionContext}from"#instrumentation/session-context.js";import{readInstrumentationDecision}from"#shared/instrumentation-decision.js";import{getInstrumentationRuntime,registerInstrumentationRuntime}from"#instrumentation/runtime-global.js";import{initializeSessionInstrumentation}from"#instrumentation/session-init.js";import{createGatewayTraceContextHeaders}from"#tracing/eve/gateway.js";const TURN_TRACE_STATE_KEY=`eve.harness.turnTrace`;function bindInstrumentationRuntime(e,t,n){let r={...n,traceSessionId:resolveTraceRootSessionId(t,n.sessionId)};if(readConversationId(t.get(ConversationIdKey))===void 0&&t.set(ConversationIdKey,t.get(ParentSessionKey)?.rootSessionId??r.rootSessionId),e===void 0)return;let i,a=e.hooks,o=r.traceSessionId,readSessionContext=()=>{let e=readInstrumentationSessionContext(contextStorage.getStore()??t);return{...e,rootSessionId:e.parent?.rootSessionId??r.rootSessionId,traceSessionId:o}},bindHooks=e=>a.forTrace?.({agentName:r.agentName,...e.conversation})??a,captureExecutionRuntime=()=>{let t=e.otelSettings,n=e.ownsAgentSpans===!0;return t!==void 0&&!n&&ensureOtelIntegration(),{ownsAgentSpans:n,otelSettings:t,runtimeContextResolvers:e.runtimeContextResolvers,tracer:t===void 0?void 0:trace.getTracer(`eve`)}},preparePreamble=(t,n)=>prepareTurnTraceContext({...t,instrumentation:e,principals:n.principals,session:{agentName:r.agentName,channelAudience:n.conversation.audience,channelKind:n.conversation.channel.kind,channelType:n.instrumentation?.channelType,parentLineage:n.parentLineage,parentTraceContext:n.parentTraceContext,rootSessionId:n.rootSessionId,traceSessionId:n.traceSessionId,scheduleId:n.scheduleId,sessionId:r.sessionId,title:n.title,traceSeed:n.traceSeed}}),s=e.memoryOperations===!0?createMemoryInstrumentation({resolveContext:()=>{let e=readSessionContext();return{hooks:bindHooks(e),rootSessionId:e.rootSessionId,traceSessionId:e.traceSessionId}},runInContext:e.runInContext,sessionId:r.sessionId}):void 0;return{prepareDelivery:e=>{i=e},createHandleEvent:e=>{let t=readSessionContext();return createInstrumentationHandleEvent({agentName:r.agentName,channelAudience:t.conversation.audience,channelKind:t.conversation.channel.kind,environment:t.conversation.environment,functionId:captureExecutionRuntime().otelSettings?.functionId??r.agentName,handleEvent:e.handleEvent,deliveryInput:i,hooks:bindHooks(t),rootSessionId:t.rootSessionId,traceSessionId:t.traceSessionId,parentLineage:t.parentLineage,parentTraceContext:t.parentTraceContext,scheduleId:t.scheduleId,sessionId:r.sessionId,title:t.title})},flush:e.forceFlush,memory:s,prepareExecution:()=>{let t=captureExecutionRuntime();return{installAiSdkWarningLogger:ensureAiSdkWarningLogger,runStep:async(n,a)=>{let o=readSessionContext(),s=bindHooks(o),c=t.otelSettings,l=resolveStepInstrumentationDecision(c,r.agentName,o.conversation,o.traceSeed,readSessionTraceDecision(o.context,r.sessionId)),u=t.tracer,d={"eve.environment":n.environment,"eve.session.id":n.session.sessionId,"eve.version":n.eveVersion},f=c?.functionId??r.agentName;f&&(d[`ai.telemetry.functionId`]=f);let p=u!==void 0&&!t.ownsAgentSpans&&l?.action!==`drop`&&n.hasInput?u.startSpan(`ai.eve.turn`,{attributes:d}):void 0,m=p?.spanContext(),h=m===void 0?n.session:{...n.session,state:{...n.session.state,[TURN_TRACE_STATE_KEY]:{spanId:m.spanId,traceFlags:m.traceFlags,traceId:m.traceId}}},g=p===void 0?void 0:trace.setSpan(context.active(),p);if(g===void 0&&u!==void 0){let e=n.session.state?.[TURN_TRACE_STATE_KEY];e!==void 0&&(g=trace.setSpan(context.active(),trace.wrapSpanContext({...e,isRemote:!0})))}let _=readSessionContext(),v=snapshotInstrumentationRuntimeContext(_.context),y=_.conversation,b=y.audience,x=shouldCaptureInstrumentationContent(y),S=l===void 0?l:applyLiveDeliveryAudienceCeiling(l,b,_.forwardedTracePolicy,y.environment),C=S===void 0?x:S.action===`record`&&S.recordInputs,w=l?.action===`drop`,T={recordInputs:!w&&(S?.action===`record`?S.recordInputs:x)&&(c?.recordInputs??!1),recordOutputs:!w&&(S?.action===`record`?S.recordOutputs:x)&&(c?.recordOutputs??!1)},telemetry=e=>{if(c===void 0&&e.bridgeIntegration===void 0)return;let n={};for(let t of Object.keys(e.runtimeContext??{}))n[t]=!0;let i=c!==void 0&&!(T.recordInputs&&T.recordOutputs),integrations=()=>getRegisteredTelemetryIntegrations({...t.ownsAgentSpans?{excludeEveOtelIntegration:!0}:void 0,sanitizeEveOtelErrors:i});return{functionId:c?.functionId??r.agentName,includeRuntimeContext:n,integrations:e.bridgeIntegration===void 0?i?[...integrations()]:void 0:[e.bridgeIntegration,...integrations()],isEnabled:!0,recordInputs:T.recordInputs,recordOutputs:T.recordOutputs}},E={channelAudience:b,functionId:c?.functionId??r.agentName,rootSessionId:_.rootSessionId,sessionId:r.sessionId,traceSessionId:_.traceSessionId},run=()=>a({gatewayTraceContextHeaders:createGatewayTraceContextHeaders,createHandleEvent:e=>createInstrumentationHandleEvent({...e,...E,deliveryInput:i,agentName:r.agentName,channelKind:y.channel.kind,environment:y.environment,hooks:s,parentLineage:_.parentLineage,parentTraceContext:_.parentTraceContext,scheduleId:_.scheduleId,title:_.title}),prepareAttempt:t=>{let n=attemptScopeOf(E,t),r=createAiSdkHookBridge(n,s,e.runInContext,t.runtimeContext,t.isFrameworkTool);return{scope:n,telemetry:telemetry({bridgeIntegration:r,runtimeContext:t.runtimeContext})}},preparePreamble:e=>preparePreamble(e,_),recordError:e=>{p!==void 0&&recordErrorOnSpan(p,e)},resolveRuntimeContext:e=>buildTelemetryRuntimeContext({...e,capturesContent:C,context:v,providerResolvers:t.runtimeContextResolvers}),session:h,setTurnId:e=>p?.setAttribute(`eve.turn.id`,e),telemetry:()=>telemetry({}),traceContext:m===void 0||!isValidSpanContext(m)?void 0:{spanId:m.spanId,traceFlags:m.traceFlags,traceId:m.traceId}});try{return await context.with(withCapture(g??context.active(),{emit:!0,recordInputs:T.recordInputs,recordOutputs:T.recordOutputs}),run)}finally{p?.end(),p=void 0}}}},preparePreamble:e=>preparePreamble(e,readSessionContext())}}function bindSessionInstrumentation(e){let t={agentName:e.agentName,rootSessionId:e.rootSessionId,traceSessionId:resolveTraceRootSessionId(e.ctx,e.sessionId),sessionId:e.sessionId};return bindInstrumentationRuntime(getInstrumentationRuntime(),e.ctx,t)}function resolveStepInstrumentationDecision(e,t,n,r,i){if(e!==void 0)return r?.decision===void 0?i===void 0?r===void 0?resolveTracePolicy(e.tracePolicy,{agentName:t,...n}):resolveTracePolicyDecision(isSampledTrace(r),n):i:readInstrumentationDecision(r.decision)}function isValidSpanContext(e){return/^[0-9a-f]{32}$/u.test(e.traceId)&&e.traceId!==`00000000000000000000000000000000`&&/^[0-9a-f]{16}$/u.test(e.spanId)&&e.spanId!==`0000000000000000`}export{bindInstrumentationRuntime,bindSessionInstrumentation,getInstrumentationRuntime,initializeSessionInstrumentation,registerInstrumentationRuntime};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
import{resolveInstrumentationEnvironment}from"#internal/application/dev-environment.js";import{ConversationContextKey,resolveConversationContext}from"#shared/conversation-context.js";import{readForwardedTraceAssertion,resolveForwardedTraceSeed}from"#shared/forwarded-trace-policy.js";import{AuthKey,ChannelInstrumentationKey,ParentSessionKey,ParentTraceContextKey,ScheduleIdKey,SessionCallbackKey,SessionTitleKey,SessionTraceSeedKey}from"#context/keys.js";import{ChannelKey}from"#runtime/sessions/runtime-context-keys.js";import{
|
|
1
|
+
import{resolveInstrumentationEnvironment}from"#internal/application/dev-environment.js";import{ConversationContextKey,resolveConversationContext}from"#shared/conversation-context.js";import{readForwardedTraceAssertion,resolveForwardedTraceSeed}from"#shared/forwarded-trace-policy.js";import{AuthKey,ChannelInstrumentationKey,ParentSessionKey,ParentTraceContextKey,ScheduleIdKey,SessionCallbackKey,SessionTitleKey,SessionTraceSeedKey}from"#context/keys.js";import{ChannelKey}from"#runtime/sessions/runtime-context-keys.js";import{readInstrumentationPrincipals}from"#instrumentation/principal-summary.js";import{resolveParentLineage}from"#instrumentation/parent-lineage.js";function readInstrumentationSessionContext(e){let t=e.get(SessionTraceSeedKey),n=resolveForwardedTraceSeed(t),r=t===void 0||n===void 0?void 0:{...t,...n},i=e.get(ParentSessionKey),a=e.get(ChannelKey),o=e.get(ChannelInstrumentationKey),s=readForwardedTraceAssertion(r?.forwardedTracePolicy),c=resolveConversationContext(e.get(ConversationContextKey),{channelKind:o?.kind,environment:resolveInstrumentationEnvironment(),forwardedTracePolicy:s,principalType:e.get(AuthKey)?.principalType});return{audience:c.audience,channel:a,conversation:c,context:e,forwardedTracePolicy:s,instrumentation:o,parent:i,parentLineage:resolveParentLineage(i,a,e.get(SessionCallbackKey)),parentTraceContext:e.get(ParentTraceContextKey),principals:readInstrumentationPrincipals(e,c,r?.decision),scheduleId:e.get(ScheduleIdKey),title:e.get(SessionTitleKey),traceSeed:r}}export{readInstrumentationSessionContext};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
const STAMPED_PACKAGE_VERSION=`0.88.
|
|
1
|
+
const STAMPED_PACKAGE_VERSION=`0.88.1`;function readStampedPackageVersion(){return STAMPED_PACKAGE_VERSION.startsWith(`__`)?void 0:STAMPED_PACKAGE_VERSION}export{readStampedPackageVersion};
|
|
@@ -19,6 +19,8 @@ export type AgentInvocation = (AgentInvocationBase & {
|
|
|
19
19
|
readonly status: "working";
|
|
20
20
|
readonly pollAfterMs: number;
|
|
21
21
|
readonly result?: JsonValue;
|
|
22
|
+
/** What the agent is doing right now, such as the label of a running tool call. */
|
|
23
|
+
readonly statusMessage?: string;
|
|
22
24
|
}) | (AgentInvocationBase & {
|
|
23
25
|
readonly status: "awaiting-input";
|
|
24
26
|
readonly interactions: AgentInvocationInteractions;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
import{emptySessionView,foldReceivedEvent}from"#protocol/session-projection/fold.js";import{interaction,openRequests,openSignIns}from"#protocol/session-projection/reader.js";import{failure,interactionBatches,reply,replyText}from"#protocol/session-projection/selectors.js";import{parseAnswers}from"#shared/input.js";import{createEventReader}from"#protocol/session-lines.js";import{isV26Line}from"#protocol/v26-lines.js";import{getWorld}from"#internal/workflow/runtime.js";import{streamSessionLines}from"#execution/session-event-stream.js";import{RunExpiredError,WorkflowRunNotFoundError}from"#compiled/@workflow/errors/index.js";import{INVOCATION_OWNER_ATTRIBUTE,INVOCATION_TOKEN_ATTRIBUTE,invocationOwnerKey}from"#internal/invocation/metadata.js";import{interactionJson}from"#protocol/interaction-json.js";var WorkflowAgentInvocationExecution=class{#e;#t;constructor(e){this.#e=e.createSession,this.#t=e.from}async create(e){let t=`invocation:${crypto.randomUUID()}`,n=await this.#e({auth:e.auth,capabilities:{requestInput:!0},continuationToken:t,externalInvocation:{continuationToken:t,ownerKey:invocationOwnerKey(e.auth)},input:{message:e.message}}),r=await this.#r(n.sessionId,e.auth);if(r===void 0)throw Error(`Invocation run was unavailable after durable creation.`);return workingInvocation(n.sessionId,r.createdAt.toISOString(),r.expiredAt?.toISOString())}async read(e){return(await this.#n(e))?.invocation}async update(e){let t=await this.#n(e);if(t===void 0)return{type:`not_found`};let{invocation:n,stream:r,token:i}=t,a=r?.pending;if(n.status!==`awaiting-input`||a===void 0)return r!==void 0&&replaysSettledBatch(r,e.responses)?{invocation:n,type:`success`}:conflict(`Invocation is not waiting for input.`);let o=new Set,s=[];for(let t of e.responses){if(a.get(t.interactionId)===void 0)return conflict(`Unknown input request: ${t.interactionId}`);o.add(t.interactionId),s.push(t)}if(o.size!==e.responses.length||o.size!==a.size)return conflict(`Responses must answer the complete pending input batch exactly once.`);if(i===void 0)return{type:`not_found`};try{await this.#t(i).respond(parseAnswers(s),{auth:e.auth})}catch(e){if(RunExpiredError.is(e))return{type:`not_found`};throw e}return{invocation:workingInvocation(e.invocationId,n.createdAt,n.expiresAt),type:`success`}}async cancel(e){let t=await this.#n(e);if(t!==void 0){if(isTerminal(t.invocation.status))return t.invocation;if(t.token!==void 0){try{await this.#t(t.token).cancel({auth:e.auth})}catch(e){if(WorkflowRunNotFoundError.is(e)||RunExpiredError.is(e))return;throw e}return await this.read(e)}}}async#n(e){let t=await this.#r(e.invocationId,e.auth);if(t===void 0)return;let n={createdAt:t.createdAt.toISOString(),expiresAt:t.expiredAt?.toISOString(),invocationId:t.runId};if(t.status===`cancelled`)return{invocation:{...n,sessionEnded:!0,status:`cancelled`}};let r=await readInvocationStream(e.invocationId);return{invocation:projectInvocation(n,t.status,r),stream:r,token:t.attributes[INVOCATION_TOKEN_ATTRIBUTE]}}async#r(e,t){let n=await getWorld();try{let r=await n.runs.get(e);return r.attributes[INVOCATION_TOKEN_ATTRIBUTE]===void 0?void 0:r.attributes[INVOCATION_OWNER_ATTRIBUTE]===invocationOwnerKey(t)?r:void 0}catch(e){if(WorkflowRunNotFoundError.is(e)||RunExpiredError.is(e))return;throw e}}};async function readInvocationStream(e){let t=emptySessionView(),n=createEventReader();for await(let{line:r,position:i,record:a}of streamSessionLines(e,{follow:!1})){if(r===void 0){if(i===0&&isV26Line(a))return startedOnEarlierEve(t);continue}for(let e of n.read(r,i))foldReceivedEvent(t,e)}let r=interactionBatches(t).map(e=>new Map(e.flatMap(e=>{let n=interaction(t,e.interactionId);return n===void 0?[]:[[e.interactionId,n]]}))),i=new Set(openRequests(t).map(e=>e.interactionId));return{batches:r,pending:r.map(e=>new Map([...e].filter(([e])=>i.has(e)))).findLast(e=>e.size>0),result:latestResult(t),settled:howItSettled(t),signIns:openSignIns(t),view:t}}function startedOnEarlierEve(e){return{batches:[],pending:void 0,result:void 0,settled:{error:{code:`session_version_unsupported`,hint:`Start a new invocation.`,message:`This invocation was started on an earlier eve version, and this deployment can't read it.`},terminal:!0},signIns:[],view:e}}function howItSettled(e){let{session:t}=e,n=t.outcome===`failed`?failure(e):void 0;if(n!==void 0)return{error:n,terminal:!0};let r=t.latestTurnId===void 0?void 0:e.turns[t.latestTurnId],i=r?.closedAt??1/0,a=t.status!==`ended`&&Object.values(e.interactions).some(e=>(e.closedAt??-1)>i);if(r?.status===`settled`&&!a){let t=r.outcome===`failed`?failure(e,r.turnId):void 0;return t===void 0?r.outcome===`cancelled`?`cancelled`:`completed`:{error:t,terminal:!1}}return t.status===`ended`?`completed`:void 0}function latestResult(e){let t=e.session.latestTurnId;if(t===void 0||e.turns[t]?.status!==`settled`)return;let n=reply(e,t).find(e=>e.kind===`result`);return n===void 0?replyText(e,t):n.value}function invocationInteractions(e){let t={};for(let[n,r]of e)r!==void 0&&(t[n]=interactionJson(r));return t}function replaysSettledBatch(e,t){let n=e.batches.at(-1);if(n===void 0||t.length!==n.size)return!1;let r=new Set;for(let i of t){let{interactionId:t}=i;if(!n.has(t)||r.has(t))return!1;r.add(t);let a=interaction(e.view,t);if(a?.status!==`settled`||a.answer===void 0||a.answer.optionId!==i.optionId||a.answer.text!==i.text)return!1}return!0}function projectInvocation(e,t,n){let{result:r,settled:i}=n,a={...e,sessionEnded:n.view.session.status===`ended`||t===`completed`||t===`failed`},o=typeof i==`object`?i:void 0,failed=()=>({...a,error:publicInvocationFailure(e.invocationId,o?.error),status:`failed`});if(t===`failed`||o?.terminal===!0)return failed();if(a.sessionEnded)return o===void 0?{...a,result:r,status:i===`cancelled`?`cancelled`:`completed`}:failed();if(n.pending!==void 0||n.signIns.length>0){let e=invocationInteractions([...n.pending??[],...n.signIns.map(e=>[e.interactionId,interaction(n.view,e.interactionId)])]);return{...a,interactions:e,pollAfterMs:1e3,result:r,status:`awaiting-input`}}return o===void 0?i===`cancelled`?{...a,status:`cancelled`}:i===`completed`?{...a,result:r,status:`completed`}:{...a,pollAfterMs:1e3,result:r,status:`working
|
|
1
|
+
import{emptySessionView,foldReceivedEvent}from"#protocol/session-projection/fold.js";import{interaction,openRequests,openSignIns}from"#protocol/session-projection/reader.js";import{activity,failure,interactionBatches,reply,replyText}from"#protocol/session-projection/selectors.js";import{parseAnswers}from"#shared/input.js";import{createEventReader}from"#protocol/session-lines.js";import{isV26Line}from"#protocol/v26-lines.js";import{getWorld}from"#internal/workflow/runtime.js";import{streamSessionLines}from"#execution/session-event-stream.js";import{RunExpiredError,WorkflowRunNotFoundError}from"#compiled/@workflow/errors/index.js";import{INVOCATION_OWNER_ATTRIBUTE,INVOCATION_TOKEN_ATTRIBUTE,invocationOwnerKey}from"#internal/invocation/metadata.js";import{interactionJson}from"#protocol/interaction-json.js";var WorkflowAgentInvocationExecution=class{#e;#t;constructor(e){this.#e=e.createSession,this.#t=e.from}async create(e){let t=`invocation:${crypto.randomUUID()}`,n=await this.#e({auth:e.auth,capabilities:{requestInput:!0},continuationToken:t,externalInvocation:{continuationToken:t,ownerKey:invocationOwnerKey(e.auth)},input:{message:e.message}}),r=await this.#r(n.sessionId,e.auth);if(r===void 0)throw Error(`Invocation run was unavailable after durable creation.`);return workingInvocation(n.sessionId,r.createdAt.toISOString(),r.expiredAt?.toISOString())}async read(e){return(await this.#n(e))?.invocation}async update(e){let t=await this.#n(e);if(t===void 0)return{type:`not_found`};let{invocation:n,stream:r,token:i}=t,a=r?.pending;if(n.status!==`awaiting-input`||a===void 0)return r!==void 0&&replaysSettledBatch(r,e.responses)?{invocation:n,type:`success`}:conflict(`Invocation is not waiting for input.`);let o=new Set,s=[];for(let t of e.responses){if(a.get(t.interactionId)===void 0)return conflict(`Unknown input request: ${t.interactionId}`);o.add(t.interactionId),s.push(t)}if(o.size!==e.responses.length||o.size!==a.size)return conflict(`Responses must answer the complete pending input batch exactly once.`);if(i===void 0)return{type:`not_found`};try{await this.#t(i).respond(parseAnswers(s),{auth:e.auth})}catch(e){if(RunExpiredError.is(e))return{type:`not_found`};throw e}return{invocation:workingInvocation(e.invocationId,n.createdAt,n.expiresAt),type:`success`}}async cancel(e){let t=await this.#n(e);if(t!==void 0){if(isTerminal(t.invocation.status))return t.invocation;if(t.token!==void 0){try{await this.#t(t.token).cancel({auth:e.auth})}catch(e){if(WorkflowRunNotFoundError.is(e)||RunExpiredError.is(e))return;throw e}return await this.read(e)}}}async#n(e){let t=await this.#r(e.invocationId,e.auth);if(t===void 0)return;let n={createdAt:t.createdAt.toISOString(),expiresAt:t.expiredAt?.toISOString(),invocationId:t.runId};if(t.status===`cancelled`)return{invocation:{...n,sessionEnded:!0,status:`cancelled`}};let r=await readInvocationStream(e.invocationId);return{invocation:projectInvocation(n,t.status,r),stream:r,token:t.attributes[INVOCATION_TOKEN_ATTRIBUTE]}}async#r(e,t){let n=await getWorld();try{let r=await n.runs.get(e);return r.attributes[INVOCATION_TOKEN_ATTRIBUTE]===void 0?void 0:r.attributes[INVOCATION_OWNER_ATTRIBUTE]===invocationOwnerKey(t)?r:void 0}catch(e){if(WorkflowRunNotFoundError.is(e)||RunExpiredError.is(e))return;throw e}}};async function readInvocationStream(e){let t=emptySessionView(),n=createEventReader();for await(let{line:r,position:i,record:a}of streamSessionLines(e,{follow:!1})){if(r===void 0){if(i===0&&isV26Line(a))return startedOnEarlierEve(t);continue}for(let e of n.read(r,i))foldReceivedEvent(t,e)}let r=interactionBatches(t).map(e=>new Map(e.flatMap(e=>{let n=interaction(t,e.interactionId);return n===void 0?[]:[[e.interactionId,n]]}))),i=new Set(openRequests(t).map(e=>e.interactionId));return{batches:r,pending:r.map(e=>new Map([...e].filter(([e])=>i.has(e)))).findLast(e=>e.size>0),result:latestResult(t),settled:howItSettled(t),signIns:openSignIns(t),view:t}}function startedOnEarlierEve(e){return{batches:[],pending:void 0,result:void 0,settled:{error:{code:`session_version_unsupported`,hint:`Start a new invocation.`,message:`This invocation was started on an earlier eve version, and this deployment can't read it.`},terminal:!0},signIns:[],view:e}}function howItSettled(e){let{session:t}=e,n=t.outcome===`failed`?failure(e):void 0;if(n!==void 0)return{error:n,terminal:!0};let r=t.latestTurnId===void 0?void 0:e.turns[t.latestTurnId],i=r?.closedAt??1/0,a=t.status!==`ended`&&Object.values(e.interactions).some(e=>(e.closedAt??-1)>i);if(r?.status===`settled`&&!a){let t=r.outcome===`failed`?failure(e,r.turnId):void 0;return t===void 0?r.outcome===`cancelled`?`cancelled`:`completed`:{error:t,terminal:!1}}return t.status===`ended`?`completed`:void 0}function latestResult(e){let t=e.session.latestTurnId;if(t===void 0||e.turns[t]?.status!==`settled`)return;let n=reply(e,t).find(e=>e.kind===`result`);return n===void 0?replyText(e,t):n.value}function invocationInteractions(e){let t={};for(let[n,r]of e)r!==void 0&&(t[n]=interactionJson(r));return t}function replaysSettledBatch(e,t){let n=e.batches.at(-1);if(n===void 0||t.length!==n.size)return!1;let r=new Set;for(let i of t){let{interactionId:t}=i;if(!n.has(t)||r.has(t))return!1;r.add(t);let a=interaction(e.view,t);if(a?.status!==`settled`||a.answer===void 0||a.answer.optionId!==i.optionId||a.answer.text!==i.text)return!1}return!0}function projectInvocation(e,t,n){let{result:r,settled:i}=n,a={...e,sessionEnded:n.view.session.status===`ended`||t===`completed`||t===`failed`},o=typeof i==`object`?i:void 0,failed=()=>({...a,error:publicInvocationFailure(e.invocationId,o?.error),status:`failed`});if(t===`failed`||o?.terminal===!0)return failed();if(a.sessionEnded)return o===void 0?{...a,result:r,status:i===`cancelled`?`cancelled`:`completed`}:failed();if(n.pending!==void 0||n.signIns.length>0){let e=invocationInteractions([...n.pending??[],...n.signIns.map(e=>[e.interactionId,interaction(n.view,e.interactionId)])]);return{...a,interactions:e,pollAfterMs:1e3,result:r,status:`awaiting-input`}}return o===void 0?i===`cancelled`?{...a,status:`cancelled`}:i===`completed`?{...a,result:r,status:`completed`}:{...a,pollAfterMs:1e3,result:r,status:`working`,statusMessage:statusMessage(activity(n.view))}:failed()}function statusMessage(e){let t=e.kind===`calling`?e.names:e.kind===`waiting-on-tasks`?e.tasks.map(e=>e.name):[],n=t.at(-1);if(n!==void 0)return t.length===1?n:`${n} (+${String(t.length-1)} more)`}function workingInvocation(e,t,n){return{createdAt:t,expiresAt:n,invocationId:e,sessionEnded:!1,pollAfterMs:1e3,status:`working`}}function publicInvocationFailure(e,t){let n={runId:e},r=vercelDeploymentId();return r!==void 0&&(n.vercelDeploymentId=r),t!==void 0&&(n.eveCode=t.code,t.id!==void 0&&(n.errorId=t.id),t.hint!==void 0&&(n.hint=t.hint)),{code:-32603,data:n,message:t?.message??`Invocation failed.`}}function vercelDeploymentId(){if(process.env.VERCEL!==`1`)return;let e=process.env.VERCEL_DEPLOYMENT_ID?.trim();return e&&e.length>0?e:void 0}function conflict(e){return{message:e,type:`conflict`}}function isTerminal(e){return e===`completed`||e===`failed`||e===`cancelled`}export{WorkflowAgentInvocationExecution};
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import type { InteractionOutcome, InteractionRequest, SignInChallenge } from "#protocol/session-events/families/interaction.js";
|
|
2
2
|
import type { Answer } from "#protocol/session-events/families/response.js";
|
|
3
|
-
import type { JsonValue } from "#protocol/session-events/envelope.js";
|
|
3
|
+
import type { JsonValue, Principal } from "#protocol/session-events/envelope.js";
|
|
4
4
|
import type { InteractionRow, SessionView } from "#protocol/session-projection/tables.js";
|
|
5
5
|
/** Where a model run's output goes: its turn, and its step, the run's place among its turn's. */
|
|
6
6
|
export interface RunPlace {
|
|
@@ -47,6 +47,8 @@ export interface Interaction {
|
|
|
47
47
|
export declare function interaction(view: SessionView, interactionId: string): Interaction | undefined;
|
|
48
48
|
/** The answer that decided a settled interaction, as it was given. */
|
|
49
49
|
export declare function decidingAnswer(row: InteractionRow): Answer | undefined;
|
|
50
|
+
/** Who gave an answer: the principal of the delivery it arrived in. */
|
|
51
|
+
export declare function responderOf(view: SessionView, responseId: string): Principal | undefined;
|
|
50
52
|
/**
|
|
51
53
|
* The approvals, questions, and budget prompts the session still waits on an answer to, oldest
|
|
52
54
|
* first: the server's one source for whether a request is open. A sign-in completes by its
|
|
@@ -1 +1 @@
|
|
|
1
|
-
import{answeredInteractionIds,callRun,callTurn,interactionOwner,openInteractions}from"#protocol/session-projection/selectors.js";function runPlace(e,t){let n=t===void 0?void 0:e.runs[t];if(n!==void 0&&n.step!==void 0&&`turnId`in n.owner)return{stepIndex:n.step,turnId:n.owner.turnId}}function turnStepAt(e,t,n=1/0){let r=0;for(let i of Object.values(e.runs))i.step===void 0||i.introducedAt>n||`turnId`in i.owner&&i.owner.turnId===t&&(r=Math.max(r,i.step));return r}function callPlace(e,t){let n=e.calls[t];if(n===void 0)return;let r=runPlace(e,callRun(e,n));if(r!==void 0)return r;let i=callTurn(e,n)??e.session.latestTurnId;return i===void 0?void 0:{stepIndex:turnStepAt(e,i,n.introducedAt),turnId:i}}const SUPERSEDED_BY_MESSAGE=`superseded-by-message`;function askedCall(e,t){if(t.origin!==void 0)return t.origin.call;if(!(`callId`in t.subject))return;let n=e.calls[t.subject.callId];if(n!==void 0)return n.input===void 0?{callId:n.callId,name:n.capability.name}:{callId:n.callId,input:n.input,name:n.capability.name}}function interactionPlace(e,t){let n=interactionOwner(e,t),r=n.turnId??e.session.latestTurnId??`turn_0`,i={stepIndex:turnStepAt(e,r,t.introducedAt),turnId:r},a=n.taskId??(`taskId`in t.subject?t.subject.taskId:void 0);return a!==void 0&&(i.taskId=a),i}function interaction(e,t){let n=e.interactions[t];if(n===void 0)return;let r=n.request;if(n.request.signIn!==void 0){let{callbackUrl:e,...t}=n.request.signIn;r={...n.request,signIn:t}}let i={...interactionPlace(e,n),interactionId:t,request:r,status:n.status},a=askedCall(e,n);a!==void 0&&(i.call=a),n.outcome!==void 0&&(i.outcome=n.outcome),n.reason!==void 0&&(i.reason=n.reason);let o=decidingAnswer(n);if(n.status===`open`)for(let n of Object.values(e.responses))n.interactionId===t&&n.status!==`settled`&&n.value!==void 0&&(o={...n.value,interactionId:t});return o!==void 0&&(i.answer=o),i}function decidingAnswer(e){let t=e.response;if(t===void 0)return;let n={interactionId:e.interactionId};return typeof t.optionId==`string`&&(n.optionId=t.optionId),typeof t.text==`string`&&(n.text=t.text),n.optionId===void 0&&n.text===void 0?void 0:n}function openRequests(e){return e===void 0?[]:openInteractions(e).filter(e=>e.request.kind!==`sign-in`)}function openSignIns(e){return e===void 0?[]:openInteractions(e,{kind:`sign-in`})}function signInEnding(e){switch(e){case`accepted`:return`connected`;case`declined`:case`invalid`:return`declined`;case`failed`:return`failed`;case`expired`:return`timed out`;default:return`cancelled`}}function promptQueueHead(e,t=()=>!1){let n=answeredInteractionIds(e),r=openRequests(e).filter(e=>!t(e.interactionId)&&!n.has(e.interactionId));return r.find(e=>e.request.kind===`budget`)??r[0]}export{SUPERSEDED_BY_MESSAGE,askedCall,callPlace,decidingAnswer,interaction,interactionPlace,openRequests,openSignIns,promptQueueHead,runPlace,signInEnding,turnStepAt};
|
|
1
|
+
import{answeredInteractionIds,callRun,callTurn,interactionOwner,openInteractions}from"#protocol/session-projection/selectors.js";function runPlace(e,t){let n=t===void 0?void 0:e.runs[t];if(n!==void 0&&n.step!==void 0&&`turnId`in n.owner)return{stepIndex:n.step,turnId:n.owner.turnId}}function turnStepAt(e,t,n=1/0){let r=0;for(let i of Object.values(e.runs))i.step===void 0||i.introducedAt>n||`turnId`in i.owner&&i.owner.turnId===t&&(r=Math.max(r,i.step));return r}function callPlace(e,t){let n=e.calls[t];if(n===void 0)return;let r=runPlace(e,callRun(e,n));if(r!==void 0)return r;let i=callTurn(e,n)??e.session.latestTurnId;return i===void 0?void 0:{stepIndex:turnStepAt(e,i,n.introducedAt),turnId:i}}const SUPERSEDED_BY_MESSAGE=`superseded-by-message`;function askedCall(e,t){if(t.origin!==void 0)return t.origin.call;if(!(`callId`in t.subject))return;let n=e.calls[t.subject.callId];if(n!==void 0)return n.input===void 0?{callId:n.callId,name:n.capability.name}:{callId:n.callId,input:n.input,name:n.capability.name}}function interactionPlace(e,t){let n=interactionOwner(e,t),r=n.turnId??e.session.latestTurnId??`turn_0`,i={stepIndex:turnStepAt(e,r,t.introducedAt),turnId:r},a=n.taskId??(`taskId`in t.subject?t.subject.taskId:void 0);return a!==void 0&&(i.taskId=a),i}function interaction(e,t){let n=e.interactions[t];if(n===void 0)return;let r=n.request;if(n.request.signIn!==void 0){let{callbackUrl:e,...t}=n.request.signIn;r={...n.request,signIn:t}}let i={...interactionPlace(e,n),interactionId:t,request:r,status:n.status},a=askedCall(e,n);a!==void 0&&(i.call=a),n.outcome!==void 0&&(i.outcome=n.outcome),n.reason!==void 0&&(i.reason=n.reason);let o=decidingAnswer(n);if(n.status===`open`)for(let n of Object.values(e.responses))n.interactionId===t&&n.status!==`settled`&&n.value!==void 0&&(o={...n.value,interactionId:t});return o!==void 0&&(i.answer=o),i}function decidingAnswer(e){let t=e.response;if(t===void 0)return;let n={interactionId:e.interactionId};return typeof t.optionId==`string`&&(n.optionId=t.optionId),typeof t.text==`string`&&(n.text=t.text),n.optionId===void 0&&n.text===void 0?void 0:n}function responderOf(e,t){let n=e.responses[t];return n===void 0?void 0:e.deliveries[n.deliveryId]?.principal}function openRequests(e){return e===void 0?[]:openInteractions(e).filter(e=>e.request.kind!==`sign-in`)}function openSignIns(e){return e===void 0?[]:openInteractions(e,{kind:`sign-in`})}function signInEnding(e){switch(e){case`accepted`:return`connected`;case`declined`:case`invalid`:return`declined`;case`failed`:return`failed`;case`expired`:return`timed out`;default:return`cancelled`}}function promptQueueHead(e,t=()=>!1){let n=answeredInteractionIds(e),r=openRequests(e).filter(e=>!t(e.interactionId)&&!n.has(e.interactionId));return r.find(e=>e.request.kind===`budget`)??r[0]}export{SUPERSEDED_BY_MESSAGE,askedCall,callPlace,decidingAnswer,interaction,interactionPlace,openRequests,openSignIns,promptQueueHead,responderOf,runPlace,signInEnding,turnStepAt};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
import{z}from"#compiled/zod/index.js";import{answerSchema}from"#shared/input.js";import{resolveInstalledPackageInfo}from"#internal/application/package.js";import{parseJsonObject}from"#shared/json.js";import{DELETE,GET,HEAD,OPTIONS,POST,defineChannel}from"#public/definitions/channel.js";import{readAgentInfoRouteResponse,readRouteChannelName,readRouteSessionCreator,readSkillFileSource}from"#internal/nitro/routes/channel-route-context.js";import{sessionAuthFromResult}from"#channel/auth/result.js";import{routeAuth}from"#public/channels/auth.js";import{interactionJsonSchema}from"#protocol/interaction-json.js";import{escapeAuthChallengeParameter,readOAuthResourceOptions}from"#channel/auth/definitions.js";import{McpToolOperationError,createMcpStreamableHttpServer,defineMcpTool}from"#internal/mcp/streamable-http-server.js";import{WorkflowAgentInvocationExecution}from"#internal/invocation/workflow-execution.js";import{MCP_TOOL_SESSIONS_EXTENSION,createPublishedTools}from"#internal/mcp/published-tools.js";import{resolveMcpRequestPrincipals}from"#internal/mcp/forwarded-principal-header.js";import{createMcpSkillsFeature}from"#internal/mcp/skills.js";import{validateMcpHttpRequest,validateMcpMetadataRequest}from"#internal/mcp/http-security.js";import{createMcpProtectedResourceMetadata,createMcpResourceChallenge}from"#internal/mcp/protected-resource.js";function mcpChannel(e){if(e?.auth===void 0)throw Error(`mcpChannel requires auth. Use none() for explicit public access.`);let t={agent:e.agent??!0,skills:e.skills??!1,tools:e.tools??!1};if(!t.agent&&!t.tools&&!t.skills)throw Error(`mcpChannel publishes nothing with agent, tools, and skills all false. Enable one.`);let n=e.route??`/eve/v1/mcp`,r=readOAuthResourceOptions(e.auth),handle=async(n,i)=>await authenticateMcpRequest(n,i,e,r,t),i=[GET(n,handle),POST(n,handle),DELETE(n,handle)];return r!==void 0&&i.unshift(...protectedResourceMetadataRoutes(r,n)),defineChannel({routes:i})}function protectedResourceMetadataRoutes(e,t){let n=protectedResourceMetadataPath(e,t);return[GET(n,async n=>protectedResourceMetadataResponse(n,e,t,!1)),HEAD(n,async n=>protectedResourceMetadataResponse(n,e,t,!0)),OPTIONS(n,async e=>protectedResourceMetadataOptionsResponse(e))]}function protectedResourceMetadataPath(e,t){if(e.metadataPath!==void 0)return e.metadataPath;let n=e.resource===void 0?t:new URL(e.resource).pathname;return n===`/`?`/.well-known/oauth-protected-resource`:`/.well-known/oauth-protected-resource${n}`}function protectedResourceMetadataResponse(e,t,n,r){let i=validateMcpMetadataRequest(e);if(i!==void 0)return i;let a=t.resource??new URL(n,new URL(e.url).origin).toString(),o=t.issuer===void 0?t.authorizationServers:[t.issuer],s=Response.json(createMcpProtectedResourceMetadata({authorizationServers:o,resource:a,scopesSupported:t.scopes}),{headers:{"access-control-allow-origin":`*`,"cache-control":`no-store`}});return r?new Response(null,{headers:s.headers,status:s.status}):s}function protectedResourceMetadataOptionsResponse(e){let t=validateMcpMetadataRequest(e);if(t!==void 0)return t;let n=new Headers({"access-control-allow-methods":`GET, HEAD, OPTIONS`,"access-control-allow-origin":`*`,"cache-control":`no-store`}),r=e.headers.get(`access-control-request-headers`);return r!==null&&(n.set(`access-control-allow-headers`,r),n.set(`vary`,`Access-Control-Request-Headers`)),new Response(null,{headers:n,status:204})}function addResourceChallenge(e,t,n){if(e.status!==401&&e.status!==403)return e;let r=protectedResourceMetadataPath(n,new URL(t.url).pathname),i=n.resource??new URL(t.url).origin,a=new URL(r,i).toString(),o=new Headers(e.headers),s=o.get(`www-authenticate`);if(e.status===401)o.set(`www-authenticate`,mergeMcpBearerChallenge(s,a,n.scopes));else{let t=augmentInsufficientScopeChallenge(s,a);if(t===void 0)return e;o.set(`www-authenticate`,t)}return new Response(e.body,{headers:o,status:e.status,statusText:e.statusText})}function mergeMcpBearerChallenge(e,t,n){let r=parseAuthChallenges(e),i=r.find(e=>e.scheme.toLowerCase()===`bearer`&&hasAuthParameter(e.value,`error`))??r.find(e=>e.scheme.toLowerCase()===`bearer`);return replaceBearerChallenges(r,i,i===void 0?createMcpResourceChallenge(t,n):augmentBearerChallenge(i.value,t,n))}function augmentInsufficientScopeChallenge(e,t){let n=parseAuthChallenges(e),r=n.find(e=>e.scheme.toLowerCase()===`bearer`&&hasAuthParameter(e.value,`error`,`insufficient_scope`));if(r!==void 0)return replaceBearerChallenges(n,r,augmentBearerChallenge(r.value,t))}function replaceBearerChallenges(e,t,n){let r=[],i=!1;for(let a of e){if(a.scheme.toLowerCase()!==`bearer`){r.push(a.value);continue}!i&&a===t&&(r.push(n),i=!0)}return i||r.push(n),r.join(`, `)}function augmentBearerChallenge(e,t,n){let r=e;return hasAuthParameter(r,`resource_metadata`)||(r=appendAuthParameter(r,`resource_metadata`,t)),n?.length&&!hasAuthParameter(r,`scope`)&&(r=appendAuthParameter(r,`scope`,n.join(` `))),r}function appendAuthParameter(e,t,n){return`${e}${e.trim().toLowerCase()===`bearer`?` `:`, `}${t}="${escapeAuthChallengeParameter(n)}"`}function hasAuthParameter(e,t,n){let r=t.replaceAll(/[.*+?^${}()|[\]\\]/g,`\\$&`);if(n===void 0)return RegExp(`(?:^|[\\s,])${r}\\s*=`,`i`).test(e);let i=n.replaceAll(/[.*+?^${}()|[\]\\]/g,`\\$&`);return RegExp(`(?:^|[\\s,])${r}\\s*=\\s*(?:"${i}"|${i})(?=$|[\\s,])`,`i`).test(e)}function parseAuthChallenges(e){if(e===null)return[];let t=[];for(let n of splitQuotedHeaderList(e)){let e=readChallengeScheme(n);if(e!==void 0){t.push({scheme:e,value:n});continue}let r=t.at(-1);r!==void 0&&(r.value+=`, ${n}`)}return t}function splitQuotedHeaderList(e){let t=[],n=!1,r=!1,i=0;for(let a=0;a<e.length;a++){let o=e[a];if(n)n=!1;else if(o===`\\`)n=!0;else if(o===`"`)r=!r;else if(o===`,`&&!r){let n=e.slice(i,a).trim();n.length>0&&t.push(n),i=a+1}}let a=e.slice(i).trim();return a.length>0&&t.push(a),t}function readChallengeScheme(e){let t=/^([!#$%&'*+\-.^_`|~0-9A-Za-z]+)(?:\s+|$)/.exec(e);if(t===null)return;let n=t[1];if(n!==void 0)return e.slice(n.length).trimStart().startsWith(`=`)?void 0:n}async function authenticateMcpRequest(e,t,n,r,i){let a=validateMcpHttpRequest(e);if(a!==void 0)return a;let o=await routeAuth(e,n.auth);if(o instanceof Response)return r===void 0?o:addResourceChallenge(o,e,r);let s=sessionAuthFromResult(o),c=await resolveMcpRequestPrincipals(e,s,n.trustedForwarders);return c instanceof Response?c:await handleMcpRequest(e,t,s,c,i)}async function handleMcpRequest(e,t,n,r,i){let a=readRouteSessionCreator(t),o=readRouteChannelName(t),s=readAgentInfoRouteResponse(t);if(o===void 0||a===void 0||s===void 0)return Response.json({error:`MCP requires agent route context.`},{status:500});let c=await s();if(!c.ok)return c;let l=await c.json();if(typeof l.agent?.name!=`string`)return Response.json({error:`MCP requires compiled agent metadata.`},{status:500});let u=typeof l.agent.description==`string`?l.agent.description:void 0,d=new WorkflowAgentInvocationExecution({createSession:a,from:t.from}),f=i.agent?createInvocationTools(d,u,n.authenticator===`none`&&n.principalType===`anonymous`):[],p=i.tools||i.skills?await t.describe():void 0,m=i.tools&&p!==void 0?createPublishedTools({invokeTool:t.invokeTool,principals:r,reserved:new Set(f.map(e=>e.name)),tools:p.tools}):[],h=[];if(i.tools&&h.push({capabilities:{extensions:{[MCP_TOOL_SESSIONS_EXTENSION]:{}}},register(){}}),i.skills&&p!==void 0){let e=readSkillFileSource(t);if(e===void 0)return Response.json({error:`MCP requires agent route context.`},{status:500});h.push(createMcpSkillsFeature({files:e,skills:p.skills}))}return await createMcpStreamableHttpServer({authenticate:async()=>n,features:h,instructions:i.agent?MCP_SERVER_INSTRUCTIONS:void 0,name:l.agent.name,tools:i.agent||i.tools?[...f,...m]:void 0,version:resolveInstalledPackageInfo().version})(e)}const MCP_SERVER_INSTRUCTIONS=[`Each invocation is one durable agent task.`,`Call agent_start once per task and keep the returned invocationId.`,`Poll agent_get, waiting at least pollAfterMs between calls, until status is completed, failed, or cancelled.`,`If status is input_required, answer all non-sign-in interactions in one agent_update by interactionId; repeating accepted answers is safe.`,`For sign-in interactions, follow signIn instructions outside agent_update and keep polling.`,`isError on a tool result means your call was rejected; a failed status means the task failed.`,`agent_start is not idempotent and a lost response leaves no invocationId, so ask the user before starting again.`,`Work continues after your connection drops; agent_cancel stops it, then poll until any terminal status.`].join(` `);function createInvocationTools(e,t,n){let r=n?` On this public channel, the invocation ID is a bearer capability until workflow retention expires.`:``,i=`Starts durable work and returns an invocation handle immediately. Call once per task; keep invocationId and poll agent_get. Not idempotent: if the response is lost, ask the user before starting again rather than retrying.${r}`;return[defineMcpTool({definition:{annotations:{destructiveHint:!0,idempotentHint:!1,openWorldHint:!0,readOnlyHint:!1},description:t===void 0?i:`${t} ${i}`,inputSchema:z.strictObject({message:utf8Bounded(MAX_MESSAGE_BYTES).min(1)}),name:`agent_start`,outputSchema:AGENT_INVOCATION_OUTPUT_SCHEMA},async call(t,n){return invocationResult(await e.create({auth:n.auth,message:t.message}))}}),defineMcpTool({definition:{annotations:{destructiveHint:!1,idempotentHint:!0,openWorldHint:!1,readOnlyHint:!0},description:`Reads complete durable invocation state. Wait at least pollAfterMs between calls. Terminal statuses are completed, failed, and cancelled. input_required includes questions, approvals, and sign-ins. Answer questions and approvals with agent_update; follow sign-in instructions and poll for sign-ins.${r}`,inputSchema:z.strictObject({invocationId:z.string().min(1).max(MAX_ID_CHARS)}),name:`agent_get`,outputSchema:AGENT_INVOCATION_OUTPUT_SCHEMA},async call(t,n){return invocationResult(requiredInvocation(await e.read({auth:n.auth,invocationId:t.invocationId})))}}),defineMcpTool({definition:{annotations:{destructiveHint:!0,idempotentHint:!1,openWorldHint:!0,readOnlyHint:!1},description:`Answers the pending input batch on an input_required invocation. Include one response per entry in interactions, naming it by its key as interactionId, in a single call; partial batches are rejected. Returns the current invocation state; repeating the same accepted answers is safe.`,inputSchema:z.strictObject({invocationId:z.string().min(1).max(MAX_ID_CHARS),responses:z.array(MCP_INPUT_RESPONSE_SCHEMA).min(1).max(MAX_RESPONSES_PER_UPDATE)}),name:`agent_update`,outputSchema:AGENT_INVOCATION_OUTPUT_SCHEMA},async call(t,n){return invocationResult(requiredMutation(await e.update({auth:n.auth,invocationId:t.invocationId,responses:t.responses})))}}),defineMcpTool({definition:{annotations:{destructiveHint:!0,idempotentHint:!0,openWorldHint:!1,readOnlyHint:!1},description:`Requests cooperative cancellation of a non-terminal invocation. Cancellation is asynchronous and can race with completion: poll agent_get until status is terminal (cancelled, completed, or failed). Safe to call repeatedly.`,inputSchema:z.strictObject({invocationId:z.string().min(1).max(MAX_ID_CHARS)}),name:`agent_cancel`,outputSchema:AGENT_INVOCATION_OUTPUT_SCHEMA},async call(t,n){return invocationResult(requiredInvocation(await e.cancel({auth:n.auth,invocationId:t.invocationId})))}})]}const INVOCATION_NOT_FOUND=`Invocation not found. It may have expired or belong to another caller.`;function requiredInvocation(e){if(e===void 0)throw new McpToolOperationError(`not_found`,INVOCATION_NOT_FOUND);return e}function requiredMutation(e){switch(e.type){case`success`:return e.invocation;case`conflict`:throw new McpToolOperationError(`conflict`,`${e.message} Call agent_get to read the current state before answering again.`);case`not_found`:throw new McpToolOperationError(`not_found`,INVOCATION_NOT_FOUND)}}function invocationResult(e){let t=parseJsonObject({...e,status:e.status===`awaiting-input`?`input_required`:e.status});return{content:[{text:JSON.stringify(t),type:`text`}],structuredContent:t}}const MAX_MESSAGE_BYTES=65536,MAX_ID_CHARS=256,MAX_RESPONSES_PER_UPDATE=64;function utf8Bounded(e){let t=new TextEncoder;return z.string().refine(n=>t.encode(n).byteLength<=e,{message:`must be at most ${String(e)} bytes when UTF-8 encoded`})}const MCP_INPUT_RESPONSE_SCHEMA=answerSchema.safeExtend({optionId:z.string().max(256).optional(),interactionId:z.string().min(1).max(256),text:utf8Bounded(16384).optional()}),AGENT_INVOCATION_BASE_SCHEMA=z.strictObject({sessionEnded:z.boolean(),createdAt:z.iso.datetime(),expiresAt:z.iso.datetime().optional(),invocationId:z.string()}),AGENT_INVOCATION_OUTPUT_SCHEMA=z.discriminatedUnion(`status`,[AGENT_INVOCATION_BASE_SCHEMA.extend({pollAfterMs:z.number().int().nonnegative(),result:z.json().optional(),status:z.literal(`working`)}),AGENT_INVOCATION_BASE_SCHEMA.extend({interactions:z.record(z.string(),interactionJsonSchema),pollAfterMs:z.number().int().nonnegative().optional(),result:z.json().optional(),status:z.literal(`input_required`)}),AGENT_INVOCATION_BASE_SCHEMA.extend({result:z.json().optional(),status:z.literal(`completed`)}),AGENT_INVOCATION_BASE_SCHEMA.extend({error:z.strictObject({code:z.number().int(),data:z.json().optional(),message:z.string()}),status:z.literal(`failed`)}),AGENT_INVOCATION_BASE_SCHEMA.extend({status:z.literal(`cancelled`)})]);export{mcpChannel};
|
|
1
|
+
import{z}from"#compiled/zod/index.js";import{answerSchema}from"#shared/input.js";import{resolveInstalledPackageInfo}from"#internal/application/package.js";import{parseJsonObject}from"#shared/json.js";import{DELETE,GET,HEAD,OPTIONS,POST,defineChannel}from"#public/definitions/channel.js";import{readAgentInfoRouteResponse,readRouteChannelName,readRouteSessionCreator,readSkillFileSource}from"#internal/nitro/routes/channel-route-context.js";import{sessionAuthFromResult}from"#channel/auth/result.js";import{routeAuth}from"#public/channels/auth.js";import{interactionJsonSchema}from"#protocol/interaction-json.js";import{escapeAuthChallengeParameter,readOAuthResourceOptions}from"#channel/auth/definitions.js";import{McpToolOperationError,createMcpStreamableHttpServer,defineMcpTool}from"#internal/mcp/streamable-http-server.js";import{WorkflowAgentInvocationExecution}from"#internal/invocation/workflow-execution.js";import{MCP_TOOL_SESSIONS_EXTENSION,createPublishedTools}from"#internal/mcp/published-tools.js";import{resolveMcpRequestPrincipals}from"#internal/mcp/forwarded-principal-header.js";import{createMcpSkillsFeature}from"#internal/mcp/skills.js";import{validateMcpHttpRequest,validateMcpMetadataRequest}from"#internal/mcp/http-security.js";import{createMcpProtectedResourceMetadata,createMcpResourceChallenge}from"#internal/mcp/protected-resource.js";function mcpChannel(e){if(e?.auth===void 0)throw Error(`mcpChannel requires auth. Use none() for explicit public access.`);let t={agent:e.agent??!0,skills:e.skills??!1,tools:e.tools??!1};if(!t.agent&&!t.tools&&!t.skills)throw Error(`mcpChannel publishes nothing with agent, tools, and skills all false. Enable one.`);let n=e.route??`/eve/v1/mcp`,r=readOAuthResourceOptions(e.auth),handle=async(n,i)=>await authenticateMcpRequest(n,i,e,r,t),i=[GET(n,handle),POST(n,handle),DELETE(n,handle)];return r!==void 0&&i.unshift(...protectedResourceMetadataRoutes(r,n)),defineChannel({routes:i})}function protectedResourceMetadataRoutes(e,t){let n=protectedResourceMetadataPath(e,t);return[GET(n,async n=>protectedResourceMetadataResponse(n,e,t,!1)),HEAD(n,async n=>protectedResourceMetadataResponse(n,e,t,!0)),OPTIONS(n,async e=>protectedResourceMetadataOptionsResponse(e))]}function protectedResourceMetadataPath(e,t){if(e.metadataPath!==void 0)return e.metadataPath;let n=e.resource===void 0?t:new URL(e.resource).pathname;return n===`/`?`/.well-known/oauth-protected-resource`:`/.well-known/oauth-protected-resource${n}`}function protectedResourceMetadataResponse(e,t,n,r){let i=validateMcpMetadataRequest(e);if(i!==void 0)return i;let a=t.resource??new URL(n,new URL(e.url).origin).toString(),o=t.issuer===void 0?t.authorizationServers:[t.issuer],s=Response.json(createMcpProtectedResourceMetadata({authorizationServers:o,resource:a,scopesSupported:t.scopes}),{headers:{"access-control-allow-origin":`*`,"cache-control":`no-store`}});return r?new Response(null,{headers:s.headers,status:s.status}):s}function protectedResourceMetadataOptionsResponse(e){let t=validateMcpMetadataRequest(e);if(t!==void 0)return t;let n=new Headers({"access-control-allow-methods":`GET, HEAD, OPTIONS`,"access-control-allow-origin":`*`,"cache-control":`no-store`}),r=e.headers.get(`access-control-request-headers`);return r!==null&&(n.set(`access-control-allow-headers`,r),n.set(`vary`,`Access-Control-Request-Headers`)),new Response(null,{headers:n,status:204})}function addResourceChallenge(e,t,n){if(e.status!==401&&e.status!==403)return e;let r=protectedResourceMetadataPath(n,new URL(t.url).pathname),i=n.resource??new URL(t.url).origin,a=new URL(r,i).toString(),o=new Headers(e.headers),s=o.get(`www-authenticate`);if(e.status===401)o.set(`www-authenticate`,mergeMcpBearerChallenge(s,a,n.scopes));else{let t=augmentInsufficientScopeChallenge(s,a);if(t===void 0)return e;o.set(`www-authenticate`,t)}return new Response(e.body,{headers:o,status:e.status,statusText:e.statusText})}function mergeMcpBearerChallenge(e,t,n){let r=parseAuthChallenges(e),i=r.find(e=>e.scheme.toLowerCase()===`bearer`&&hasAuthParameter(e.value,`error`))??r.find(e=>e.scheme.toLowerCase()===`bearer`);return replaceBearerChallenges(r,i,i===void 0?createMcpResourceChallenge(t,n):augmentBearerChallenge(i.value,t,n))}function augmentInsufficientScopeChallenge(e,t){let n=parseAuthChallenges(e),r=n.find(e=>e.scheme.toLowerCase()===`bearer`&&hasAuthParameter(e.value,`error`,`insufficient_scope`));if(r!==void 0)return replaceBearerChallenges(n,r,augmentBearerChallenge(r.value,t))}function replaceBearerChallenges(e,t,n){let r=[],i=!1;for(let a of e){if(a.scheme.toLowerCase()!==`bearer`){r.push(a.value);continue}!i&&a===t&&(r.push(n),i=!0)}return i||r.push(n),r.join(`, `)}function augmentBearerChallenge(e,t,n){let r=e;return hasAuthParameter(r,`resource_metadata`)||(r=appendAuthParameter(r,`resource_metadata`,t)),n?.length&&!hasAuthParameter(r,`scope`)&&(r=appendAuthParameter(r,`scope`,n.join(` `))),r}function appendAuthParameter(e,t,n){return`${e}${e.trim().toLowerCase()===`bearer`?` `:`, `}${t}="${escapeAuthChallengeParameter(n)}"`}function hasAuthParameter(e,t,n){let r=t.replaceAll(/[.*+?^${}()|[\]\\]/g,`\\$&`);if(n===void 0)return RegExp(`(?:^|[\\s,])${r}\\s*=`,`i`).test(e);let i=n.replaceAll(/[.*+?^${}()|[\]\\]/g,`\\$&`);return RegExp(`(?:^|[\\s,])${r}\\s*=\\s*(?:"${i}"|${i})(?=$|[\\s,])`,`i`).test(e)}function parseAuthChallenges(e){if(e===null)return[];let t=[];for(let n of splitQuotedHeaderList(e)){let e=readChallengeScheme(n);if(e!==void 0){t.push({scheme:e,value:n});continue}let r=t.at(-1);r!==void 0&&(r.value+=`, ${n}`)}return t}function splitQuotedHeaderList(e){let t=[],n=!1,r=!1,i=0;for(let a=0;a<e.length;a++){let o=e[a];if(n)n=!1;else if(o===`\\`)n=!0;else if(o===`"`)r=!r;else if(o===`,`&&!r){let n=e.slice(i,a).trim();n.length>0&&t.push(n),i=a+1}}let a=e.slice(i).trim();return a.length>0&&t.push(a),t}function readChallengeScheme(e){let t=/^([!#$%&'*+\-.^_`|~0-9A-Za-z]+)(?:\s+|$)/.exec(e);if(t===null)return;let n=t[1];if(n!==void 0)return e.slice(n.length).trimStart().startsWith(`=`)?void 0:n}async function authenticateMcpRequest(e,t,n,r,i){let a=validateMcpHttpRequest(e);if(a!==void 0)return a;let o=await routeAuth(e,n.auth);if(o instanceof Response)return r===void 0?o:addResourceChallenge(o,e,r);let s=sessionAuthFromResult(o),c=await resolveMcpRequestPrincipals(e,s,n.trustedForwarders);return c instanceof Response?c:await handleMcpRequest(e,t,s,c,i)}async function handleMcpRequest(e,t,n,r,i){let a=readRouteSessionCreator(t),o=readRouteChannelName(t),s=readAgentInfoRouteResponse(t);if(o===void 0||a===void 0||s===void 0)return Response.json({error:`MCP requires agent route context.`},{status:500});let c=await s();if(!c.ok)return c;let l=await c.json();if(typeof l.agent?.name!=`string`)return Response.json({error:`MCP requires compiled agent metadata.`},{status:500});let u=typeof l.agent.description==`string`?l.agent.description:void 0,d=new WorkflowAgentInvocationExecution({createSession:a,from:t.from}),f=i.agent?createInvocationTools(d,u,n.authenticator===`none`&&n.principalType===`anonymous`):[],p=i.tools||i.skills?await t.describe():void 0,m=i.tools&&p!==void 0?createPublishedTools({invokeTool:t.invokeTool,principals:r,reserved:new Set(f.map(e=>e.name)),tools:p.tools}):[],h=[];if(i.tools&&h.push({capabilities:{extensions:{[MCP_TOOL_SESSIONS_EXTENSION]:{}}},register(){}}),i.skills&&p!==void 0){let e=readSkillFileSource(t);if(e===void 0)return Response.json({error:`MCP requires agent route context.`},{status:500});h.push(createMcpSkillsFeature({files:e,skills:p.skills}))}return await createMcpStreamableHttpServer({authenticate:async()=>n,features:h,instructions:i.agent?MCP_SERVER_INSTRUCTIONS:void 0,name:l.agent.name,tools:i.agent||i.tools?[...f,...m]:void 0,version:resolveInstalledPackageInfo().version})(e)}const MCP_SERVER_INSTRUCTIONS=[`Each invocation is one durable agent task.`,`Call agent_start once per task and keep the returned invocationId.`,`Poll agent_get, waiting at least pollAfterMs between calls, until status is completed, failed, or cancelled.`,`If status is input_required, answer all non-sign-in interactions in one agent_update by interactionId; repeating accepted answers is safe.`,`For sign-in interactions, follow signIn instructions outside agent_update and keep polling.`,`isError on a tool result means your call was rejected; a failed status means the task failed.`,`agent_start is not idempotent and a lost response leaves no invocationId, so ask the user before starting again.`,`Work continues after your connection drops; agent_cancel stops it, then poll until any terminal status.`].join(` `);function createInvocationTools(e,t,n){let r=n?` On this public channel, the invocation ID is a bearer capability until workflow retention expires.`:``,i=`Starts durable work and returns an invocation handle immediately. Call once per task; keep invocationId and poll agent_get. Not idempotent: if the response is lost, ask the user before starting again rather than retrying.${r}`;return[defineMcpTool({definition:{annotations:{destructiveHint:!0,idempotentHint:!1,openWorldHint:!0,readOnlyHint:!1},description:t===void 0?i:`${t} ${i}`,inputSchema:z.strictObject({message:utf8Bounded(MAX_MESSAGE_BYTES).min(1)}),name:`agent_start`,outputSchema:AGENT_INVOCATION_OUTPUT_SCHEMA},async call(t,n){return invocationResult(await e.create({auth:n.auth,message:t.message}))}}),defineMcpTool({definition:{annotations:{destructiveHint:!1,idempotentHint:!0,openWorldHint:!1,readOnlyHint:!0},description:`Reads complete durable invocation state. Wait at least pollAfterMs between calls. While working, statusMessage, when present, describes the current activity. Terminal statuses are completed, failed, and cancelled. input_required includes questions, approvals, and sign-ins. Answer questions and approvals with agent_update; follow sign-in instructions and poll for sign-ins.${r}`,inputSchema:z.strictObject({invocationId:z.string().min(1).max(MAX_ID_CHARS)}),name:`agent_get`,outputSchema:AGENT_INVOCATION_OUTPUT_SCHEMA},async call(t,n){return invocationResult(requiredInvocation(await e.read({auth:n.auth,invocationId:t.invocationId})))}}),defineMcpTool({definition:{annotations:{destructiveHint:!0,idempotentHint:!1,openWorldHint:!0,readOnlyHint:!1},description:`Answers the pending input batch on an input_required invocation. Include one response per entry in interactions, naming it by its key as interactionId, in a single call; partial batches are rejected. Returns the current invocation state; repeating the same accepted answers is safe.`,inputSchema:z.strictObject({invocationId:z.string().min(1).max(MAX_ID_CHARS),responses:z.array(MCP_INPUT_RESPONSE_SCHEMA).min(1).max(MAX_RESPONSES_PER_UPDATE)}),name:`agent_update`,outputSchema:AGENT_INVOCATION_OUTPUT_SCHEMA},async call(t,n){return invocationResult(requiredMutation(await e.update({auth:n.auth,invocationId:t.invocationId,responses:t.responses})))}}),defineMcpTool({definition:{annotations:{destructiveHint:!0,idempotentHint:!0,openWorldHint:!1,readOnlyHint:!1},description:`Requests cooperative cancellation of a non-terminal invocation. Cancellation is asynchronous and can race with completion: poll agent_get until status is terminal (cancelled, completed, or failed). Safe to call repeatedly.`,inputSchema:z.strictObject({invocationId:z.string().min(1).max(MAX_ID_CHARS)}),name:`agent_cancel`,outputSchema:AGENT_INVOCATION_OUTPUT_SCHEMA},async call(t,n){return invocationResult(requiredInvocation(await e.cancel({auth:n.auth,invocationId:t.invocationId})))}})]}const INVOCATION_NOT_FOUND=`Invocation not found. It may have expired or belong to another caller.`;function requiredInvocation(e){if(e===void 0)throw new McpToolOperationError(`not_found`,INVOCATION_NOT_FOUND);return e}function requiredMutation(e){switch(e.type){case`success`:return e.invocation;case`conflict`:throw new McpToolOperationError(`conflict`,`${e.message} Call agent_get to read the current state before answering again.`);case`not_found`:throw new McpToolOperationError(`not_found`,INVOCATION_NOT_FOUND)}}function invocationResult(e){let t=parseJsonObject({...e,status:e.status===`awaiting-input`?`input_required`:e.status});return{content:[{text:JSON.stringify(t),type:`text`}],structuredContent:t}}const MAX_MESSAGE_BYTES=65536,MAX_ID_CHARS=256,MAX_RESPONSES_PER_UPDATE=64;function utf8Bounded(e){let t=new TextEncoder;return z.string().refine(n=>t.encode(n).byteLength<=e,{message:`must be at most ${String(e)} bytes when UTF-8 encoded`})}const MCP_INPUT_RESPONSE_SCHEMA=answerSchema.safeExtend({optionId:z.string().max(256).optional(),interactionId:z.string().min(1).max(256),text:utf8Bounded(16384).optional()}),AGENT_INVOCATION_BASE_SCHEMA=z.strictObject({sessionEnded:z.boolean(),createdAt:z.iso.datetime(),expiresAt:z.iso.datetime().optional(),invocationId:z.string()}),AGENT_INVOCATION_OUTPUT_SCHEMA=z.discriminatedUnion(`status`,[AGENT_INVOCATION_BASE_SCHEMA.extend({pollAfterMs:z.number().int().nonnegative(),result:z.json().optional(),status:z.literal(`working`),statusMessage:z.string().optional()}),AGENT_INVOCATION_BASE_SCHEMA.extend({interactions:z.record(z.string(),interactionJsonSchema),pollAfterMs:z.number().int().nonnegative().optional(),result:z.json().optional(),status:z.literal(`input_required`)}),AGENT_INVOCATION_BASE_SCHEMA.extend({result:z.json().optional(),status:z.literal(`completed`)}),AGENT_INVOCATION_BASE_SCHEMA.extend({error:z.strictObject({code:z.number().int(),data:z.json().optional(),message:z.string()}),status:z.literal(`failed`)}),AGENT_INVOCATION_BASE_SCHEMA.extend({status:z.literal(`cancelled`)})]);export{mcpChannel};
|
|
@@ -1,3 +1,3 @@
|
|
|
1
|
-
import{createLogger,logError}from"#internal/logging.js";import{normalizeChannelAudience}from"#shared/channel-audience.js";import{interaction
|
|
2
|
-
`))}}async function postDirectMessageCard(e,t,n){let{channel:r}=t,i=slackUserIdFromAuthContext(t.session.auth.current)??r.state.triggeringUserId;if(!i){log.warn(`direct-message input request not delivered because no reviewer was resolved`,{requestId:e.interactionId,sessionId:t.session.id});return}let a=slackSessionTargetOf(r.slack),o=await deliverPrivateInteraction({card:renderRequestCard(n,cardOf(e,`direct-message`,t),a),previewMessageTs:r.state.triggeringMessageTs??r.slack.threadTs,reviewer:i,slack:r.slack}),s={channelId:o.channelId,destination:`direct-message`,requests:[cardRequest(e.interactionId,o.blocks,o.detailsTs)],route:a,ts:o.ts};remember(r.state,s);try{let t=await r.thread.post(`Waiting on ${e.request.kind===`approval`?`approval`:`a response`} from <@${i}>โฆ`);t.id&&replace(r.state,s,{...s,announcementTs:t.id})}catch(n){logError(log,`failed to announce private input request`,n,{requestId:e.interactionId,sessionId:t.session.id})}}async function showAnswerChange(e,t,n){forgetSettledCards(t);let r=recordOf(t.channel.state,e);r!==void 0&&sessionTables(t.view).interactions[e]?.status===`open`&&replace(t.channel.state,r,await writeRequests(t,n,r,[e]))}async function settleRequestCard(e,t,n){let{channel:r}=t;forgetSettledCards(t);let i=recordOf(r.state,e),a=sessionTables(t.view),o=(i?.requests??[]).filter(e=>e.settled!==!0&&a.interactions[e.interactionId]?.status===`settled`);if(i===void 0||o.length===0)return;let s=o.map(e=>e.interactionId),c=await writeRequests(t,n,i,s),l={...c,requests:c.requests.map(e=>s.includes(e.interactionId)?{...e,settled:!0}:e)};if(replace(r.state,i,l),l.announcementTs!==void 0&&r.state.channelId!==null)for(let e of s){let n=interaction(a,e);if(n===void 0)continue;let i=cardOf(n,l.destination,t),o=i.answeredBy===void 0?``:` by <@${i.answeredBy}>`;await callSlack(r,`chat.update`,e,{channel:r.state.channelId,text:`${endingOf(i.interaction).text}${o}.`,ts:l.announcementTs})}for(let e of o)e.detailsTs!==void 0&&await retireDetails(r,l,e.detailsTs);l.requests.every(e=>e.settled===!0)&&replace(r.state,l,void 0)}async function writeRequests(e,t,n,r){let i=sessionTables(e.view),a=r.flatMap(r=>{let a=interaction(i,r);if(a===void 0)return[];let o=renderRequestCard(t,cardOf(a,n.destination,e),n.route),s=o.fallback.controls;return[{compact:compactDefault(s),fallback:s,interactionId:r,rendered:o.parts.controls}]}),blocksOf=e=>e.flatMap(e=>e.blocks),[o,...s]=[`rendered`,`fallback`,`compact`].map(e=>{let t=[];return{kind:e,requests:n.requests.map(n=>{let r=a.find(e=>e.interactionId===n.interactionId);return r===void 0?n:(t.push(r[e].text),{...n,blocks:r[e].blocks})}),text:truncateMessageText(t.join(`
|
|
1
|
+
import{responderOf}from"#protocol/session-projection/reader.js";import{createLogger,logError}from"#internal/logging.js";import{normalizeChannelAudience}from"#shared/channel-audience.js";import{interaction as interaction$1}from"#channel/interaction-prompts.js";import{sessionTables}from"#protocol/session-projection/session-view.js";import{slackSessionTargetOf}from"#public/channels/slack/api.js";import{slackUserIdForPrincipal,slackUserIdFromAuthContext}from"#public/channels/slack/auth.js";import{SLACK_MAX_BLOCKS_PER_MESSAGE,truncateMessageText}from"#public/channels/slack/limits.js";import{isRefusedPayloadCode,refusedPayloadError}from"#public/channels/slack/reply-delivery.js";import{compactDefault,endingOf,renderRequestCard,sameJson}from"#public/channels/slack/request-card-render.js";import{deliverPrivateInteraction}from"#public/channels/slack/private-approval-delivery.js";const log=createLogger(`slack.request-cards`);async function postRequestCards(e,t,n,r){forgetSettledCards(t);let i=[],a=[];for(let n of e.requests)((r===void 0?`thread`:await r(n,t))===`direct-message`?i:a).push(n);await postThreadCards(a,t,n);for(let e of i)await postDirectMessageCard(e,t,n)}async function postThreadCards(e,t,n){let{channel:r}=t,i=r.state.channelId;if(e.length===0)return;if(i===null){log.warn(`thread input requests not delivered because the session has no Slack channel`,{requestIds:e.map(e=>e.interactionId),sessionId:t.session.id});return}let a=r.slack.codeChannel?slackSessionTargetOf(r.slack):void 0,o=e.map(e=>({interactionId:e.interactionId,...renderRequestCard(n,cardOf(e,`thread`,t),a)})),post=async e=>(await r.thread.post({blocks:[...e.blocks],text:e.text})).id,s=new Map;await postGroups(o,`details`,post,(e,t)=>{for(let n of e)s.set(n.interactionId,t)}),await postGroups(o,`controls`,post,(e,t)=>{let n={channelId:i,destination:`thread`,requests:e.map(({interactionId:e,message:t})=>cardRequest(e,t.blocks,s.get(e))),ts:t};a!==void 0&&(n.route=a),remember(r.state,n)})}async function postGroups(e,t,n,r){let send=async e=>{let t=await n(joinParts(e));t&&r(e,t)};for(let n of groupParts(e,e=>e.parts[t]))try{await send(n)}catch(r){let i=e.filter(e=>n.some(t=>t.interactionId===e.interactionId)),a=i.every(e=>sameJson(e.parts[t],e.fallback[t]));if(refusedPayloadError(r)===void 0||a)throw r;logError(log,`Slack refused rendered input requests; posting eve's defaults`,r);for(let e of groupParts(i,e=>e.fallback[t]))await send(e)}}function groupParts(e,t){let n=[],r=0;for(let i of e){let e=t(i);if(e===void 0)continue;let a=n.at(-1);a&&r+e.blocks.length<=SLACK_MAX_BLOCKS_PER_MESSAGE?(a.push({interactionId:i.interactionId,message:e}),r+=e.blocks.length):(n.push([{interactionId:i.interactionId,message:e}]),r=e.blocks.length)}return n}function joinParts(e){return{blocks:e.flatMap(e=>e.message.blocks),text:truncateMessageText(e.map(e=>e.message.text).join(`
|
|
2
|
+
`))}}async function postDirectMessageCard(e,t,n){let{channel:r}=t,i=slackUserIdFromAuthContext(t.session.auth.current)??r.state.triggeringUserId;if(!i){log.warn(`direct-message input request not delivered because no reviewer was resolved`,{requestId:e.interactionId,sessionId:t.session.id});return}let a=slackSessionTargetOf(r.slack),o=await deliverPrivateInteraction({card:renderRequestCard(n,cardOf(e,`direct-message`,t),a),previewMessageTs:r.state.triggeringMessageTs??r.slack.threadTs,reviewer:i,slack:r.slack}),s={channelId:o.channelId,destination:`direct-message`,requests:[cardRequest(e.interactionId,o.blocks,o.detailsTs)],route:a,ts:o.ts};remember(r.state,s);try{let t=await r.thread.post(`Waiting on ${e.request.kind===`approval`?`approval`:`a response`} from <@${i}>โฆ`);t.id&&replace(r.state,s,{...s,announcementTs:t.id})}catch(n){logError(log,`failed to announce private input request`,n,{requestId:e.interactionId,sessionId:t.session.id})}}async function showAnswerChange(e,t,n){forgetSettledCards(t);let r=recordOf(t.channel.state,e);r!==void 0&&sessionTables(t.view).interactions[e]?.status===`open`&&replace(t.channel.state,r,await writeRequests(t,n,r,[e]))}async function settleRequestCard(e,t,n){let{channel:r}=t;forgetSettledCards(t);let i=recordOf(r.state,e),a=sessionTables(t.view),o=(i?.requests??[]).filter(e=>e.settled!==!0&&a.interactions[e.interactionId]?.status===`settled`);if(i===void 0||o.length===0)return;let s=o.map(e=>e.interactionId),c=await writeRequests(t,n,i,s),l={...c,requests:c.requests.map(e=>s.includes(e.interactionId)?{...e,settled:!0}:e)};if(replace(r.state,i,l),l.announcementTs!==void 0&&r.state.channelId!==null)for(let e of s){let n=interaction$1(a,e);if(n===void 0)continue;let i=cardOf(n,l.destination,t),o=i.answeredBy===void 0?``:` by <@${i.answeredBy}>`;await callSlack(r,`chat.update`,e,{channel:r.state.channelId,text:`${endingOf(i.interaction).text}${o}.`,ts:l.announcementTs})}for(let e of o)e.detailsTs!==void 0&&await retireDetails(r,l,e.detailsTs);l.requests.every(e=>e.settled===!0)&&replace(r.state,l,void 0)}async function writeRequests(e,t,n,r){let i=sessionTables(e.view),a=r.flatMap(r=>{let a=interaction$1(i,r);if(a===void 0)return[];let o=renderRequestCard(t,cardOf(a,n.destination,e),n.route),s=o.fallback.controls;return[{compact:compactDefault(s),fallback:s,interactionId:r,rendered:o.parts.controls}]}),blocksOf=e=>e.flatMap(e=>e.blocks),[o,...s]=[`rendered`,`fallback`,`compact`].map(e=>{let t=[];return{kind:e,requests:n.requests.map(n=>{let r=a.find(e=>e.interactionId===n.interactionId);return r===void 0?n:(t.push(r[e].text),{...n,blocks:r[e].blocks})}),text:truncateMessageText(t.join(`
|
|
3
3
|
`))}}).filter(e=>blocksOf(e.requests).length<=SLACK_MAX_BLOCKS_PER_MESSAGE);if(o===void 0||(o.kind!==`rendered`&&log.warn(`input request card would pass Slack's 50 blocks; using eve's default`,{fallback:o.kind,requestIds:r}),sameJson(blocksOf(o.requests),blocksOf(n.requests))))return n;let update=async t=>await callSlack(e.channel,`chat.update`,r.join(`,`),{blocks:blocksOf(t.requests),channel:n.channelId,text:t.text,ts:n.ts}),c=await update(o);if(c===`ok`)return{...n,requests:o.requests};let l=s.find(e=>!sameJson(blocksOf(e.requests),blocksOf(o.requests)));return c!==`refused`||l===void 0||sameJson(blocksOf(l.requests),blocksOf(n.requests))?n:await update(l)===`ok`?{...n,requests:l.requests}:n}async function retireDetails(e,t,n){let r=e.state.interactionCards??[],i=r.flatMap(e=>e.requests.filter(e=>e.detailsTs===n));i.length===0||i.some(e=>e.settled!==!0)||(await callSlack(e,`chat.delete`,n,{channel:t.channelId,ts:n}),e.state.interactionCards=r.map(e=>({...e,requests:e.requests.map(e=>{if(e.detailsTs!==n)return e;let{detailsTs:t,...r}=e;return r})})))}async function callSlack(e,t,n,r){try{let i=await e.slack.request(t,r);return i.ok===!0?`ok`:(log.warn(`failed to update input request message`,{error:i.error,operation:t,requestId:n}),isRefusedPayloadCode(i.error)?`refused`:`failed`)}catch(e){return logError(log,`failed to update input request message`,e,{operation:t,requestId:n}),`failed`}}function cardOf(e,t,n){let r=sessionTables(n.view),i=standingOf(r,e),a={audience:t===`direct-message`?`private`:normalizeChannelAudience(n.channel.state.audience),destination:t,interaction:i.interaction,view:n.view},o=i.responseId===void 0?void 0:slackUserIdForPrincipal(n.channel.state,responderOf(r,i.responseId)?.id);return o!==void 0&&(a.answeredBy=o),a}function cardRequest(e,t,n){let r={blocks:t,interactionId:e};return n!==void 0&&(r.detailsTs=n),r}function standingOf(e,t){let{interactionId:n}=t;if(t.status===`settled`){let r=e.interactions[n]?.cause;return{interaction:t,responseId:t.answer!==void 0&&r!==void 0&&`responseId`in r?r.responseId:void 0}}let{answer:r,...i}=t,a=Object.values(e.responses).findLast(e=>e.interactionId===n&&e.status===`admitted`&&e.value!==void 0);return a?.value===void 0?{interaction:i,responseId:void 0}:{interaction:{...i,answer:{...a.value,interactionId:n}},responseId:a.responseId}}function forgetSettledCards(e){let{state:t}=e.channel,n=t.interactionCards;if(n===void 0||n.length===0)return;let r=sessionTables(e.view),i=e.position.line,a=n.filter(e=>e.requests.some(e=>{let t=r.interactions[e.interactionId];return t!==void 0&&(t.status===`open`||(t.closedAt??i)>=i)}));a.length!==n.length&&(t.interactionCards=a)}function recordOf(e,t){return e.interactionCards?.find(e=>e.requests.some(e=>e.interactionId===t))}function remember(e,t){e.interactionCards=[...e.interactionCards??[],t]}function replace(e,t,n){e.interactionCards=(e.interactionCards??[]).flatMap(e=>e.ts!==t.ts||e.channelId!==t.channelId?[e]:n===void 0?[]:[n])}async function notifyRefusedResponder(e,t){let n=slackUserIdForPrincipal(t.state,e.responder?.id);n!==void 0&&await t.thread.postEphemeral(n,e.reason??`We couldnโt verify your response. Please try again.`)}export{notifyRefusedResponder,postRequestCards,settleRequestCard,showAnswerChange};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
async function agentToolServeWorkflow(e,t){"use workflow";let n=t.agent(t.toolName),r=sendToAgent(n,await e()),i=e();for(;;){let a=await nextCallOrResult(i,r);if(a.kind===`call`){r=await forwardCall(n,r,a.call),i=e();continue}if(!r.signal.aborted){if(a.result.status===`failed`)throw Error(`The agent's turn failed: ${a.result.error.message}\nThis task has ended; to retry, call ${t.toolName} without taskId.`);let o=e();if(o!==i){r=sendToAgent(n,await i),i=o;continue}t.reply(a.result.reply??``)}r=sendToAgent(n,await i),i=e()}}async function agentWithModelServeWorkflow(e,t){"use workflow";let n=await e(),r=n.input.model.trim();if(r===``)throw TypeError(`agent model must not be empty.`);let i=t.agent(`agent`,{model:r}),a=sendToModelAgent(i,n,r),o=e();for(;;){let n=await nextModelCallOrResult(o,a);if(n.kind===`call`){a=await forwardModelCall(i,a,n.call,r),o=e();continue}if(!a.signal.aborted){if(n.result.status===`failed`)throw Error(`The agent's turn failed: ${n.result.error.message}\nThis task has ended; to retry, call ${t.toolName} without taskId.`);let s=e();if(s!==o){a=sendToModelAgent(i,await o,r),o=s;continue}t.reply(n.result.reply??``)}a=sendToModelAgent(i,await o,r),o=e()}}function sendToAgent(e,t){return{result:e.send(t.input.message,{signal:t.abortSignal}).then(e=>e.result()),signal:t.abortSignal}}function sendToModelAgent(e,t,n){if(t.input.model!==n)throw Error(`An agent task keeps the model it started with. This task has ended; start a new task to use another model.`);return{result:e.send(t.input.message,{signal:t.abortSignal}).then(e=>e.result()),signal:t.abortSignal}}async function nextCallOrResult(e,t){return await Promise.race([t.result.then(e=>({kind:`result`,result:e})),e.then(e=>({call:e,kind:`call`}))])}async function nextModelCallOrResult(e,t){return await Promise.race([t.result.then(e=>({kind:`result`,result:e})),e.then(e=>({call:e,kind:`call`}))])}async function forwardCall(e,t,n){return t.signal.aborted&&await t.result.catch(()=>void 0),sendToAgent(e,n)}async function forwardModelCall(e,t,n,r){return t.signal.aborted&&await t.result.catch(()=>void 0),sendToModelAgent(e,n,r)}agentToolServeWorkflow.workflowId=`workflow//eve//agentToolServeWorkflow`,agentWithModelServeWorkflow.workflowId=`workflow//eve@0.88.
|
|
1
|
+
async function agentToolServeWorkflow(e,t){"use workflow";let n=t.agent(t.toolName),r=sendToAgent(n,await e()),i=e();for(;;){let a=await nextCallOrResult(i,r);if(a.kind===`call`){r=await forwardCall(n,r,a.call),i=e();continue}if(!r.signal.aborted){if(a.result.status===`failed`)throw Error(`The agent's turn failed: ${a.result.error.message}\nThis task has ended; to retry, call ${t.toolName} without taskId.`);let o=e();if(o!==i){r=sendToAgent(n,await i),i=o;continue}t.reply(a.result.reply??``)}r=sendToAgent(n,await i),i=e()}}async function agentWithModelServeWorkflow(e,t){"use workflow";let n=await e(),r=n.input.model.trim();if(r===``)throw TypeError(`agent model must not be empty.`);let i=t.agent(`agent`,{model:r}),a=sendToModelAgent(i,n,r),o=e();for(;;){let n=await nextModelCallOrResult(o,a);if(n.kind===`call`){a=await forwardModelCall(i,a,n.call,r),o=e();continue}if(!a.signal.aborted){if(n.result.status===`failed`)throw Error(`The agent's turn failed: ${n.result.error.message}\nThis task has ended; to retry, call ${t.toolName} without taskId.`);let s=e();if(s!==o){a=sendToModelAgent(i,await o,r),o=s;continue}t.reply(n.result.reply??``)}a=sendToModelAgent(i,await o,r),o=e()}}function sendToAgent(e,t){return{result:e.send(t.input.message,{signal:t.abortSignal}).then(e=>e.result()),signal:t.abortSignal}}function sendToModelAgent(e,t,n){if(t.input.model!==n)throw Error(`An agent task keeps the model it started with. This task has ended; start a new task to use another model.`);return{result:e.send(t.input.message,{signal:t.abortSignal}).then(e=>e.result()),signal:t.abortSignal}}async function nextCallOrResult(e,t){return await Promise.race([t.result.then(e=>({kind:`result`,result:e})),e.then(e=>({call:e,kind:`call`}))])}async function nextModelCallOrResult(e,t){return await Promise.race([t.result.then(e=>({kind:`result`,result:e})),e.then(e=>({call:e,kind:`call`}))])}async function forwardCall(e,t,n){return t.signal.aborted&&await t.result.catch(()=>void 0),sendToAgent(e,n)}async function forwardModelCall(e,t,n,r){return t.signal.aborted&&await t.result.catch(()=>void 0),sendToModelAgent(e,n,r)}agentToolServeWorkflow.workflowId=`workflow//eve//agentToolServeWorkflow`,agentWithModelServeWorkflow.workflowId=`workflow//eve@0.88.1//agentWithModelServeWorkflow`;export{agentToolServeWorkflow,agentWithModelServeWorkflow};
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import{pinnedNodeEngineMajor}from"../../node-engine.js";import{parseChatGptModelSelection}from"../../../shared/chatgpt-model.js";import{SUPPORTED_AUTHORED_MODULE_FILE_EXTENSIONS}from"../update/module-files.js";import{pathExists,writeTextFile}from"../files.js";import{blockingCreateInPlaceEntries}from"../create-in-place.js";import{DEFAULT_CONNECT_PACKAGE_VERSION,resolveVersionToken}from"../version-tokens.js";import{applyPackageManagerWorkspaceConfiguration,isPackageManagerWorkspaceMember,patchWorkspaceRootPackageJson}from"../workspace-root.js";import{WEB_CHANNEL_TEMPLATES}from"./web-template.js";import{AGENT_INSTRUCTIONS_TEMPLATE}from"./instructions-template.js";import{SCAFFOLDED_AGENT_PATHS}from"./agent-paths.js";import{mkdir,readdir,stat}from"node:fs/promises";import{basename,join,resolve}from"node:path";const CURRENT_DIRECTORY_PROJECT_NAME=`.`,DEFAULT_AI_PACKAGE_VERSION=`^7.0.137`,DEFAULT_ZOD_PACKAGE_VERSION=`4.5.4`,DEFAULT_EVE_PACKAGE_CONTRACT={version:`0.88.
|
|
1
|
+
import{pinnedNodeEngineMajor}from"../../node-engine.js";import{parseChatGptModelSelection}from"../../../shared/chatgpt-model.js";import{SUPPORTED_AUTHORED_MODULE_FILE_EXTENSIONS}from"../update/module-files.js";import{pathExists,writeTextFile}from"../files.js";import{blockingCreateInPlaceEntries}from"../create-in-place.js";import{DEFAULT_CONNECT_PACKAGE_VERSION,resolveVersionToken}from"../version-tokens.js";import{applyPackageManagerWorkspaceConfiguration,isPackageManagerWorkspaceMember,patchWorkspaceRootPackageJson}from"../workspace-root.js";import{WEB_CHANNEL_TEMPLATES}from"./web-template.js";import{AGENT_INSTRUCTIONS_TEMPLATE}from"./instructions-template.js";import{SCAFFOLDED_AGENT_PATHS}from"./agent-paths.js";import{mkdir,readdir,stat}from"node:fs/promises";import{basename,join,resolve}from"node:path";const CURRENT_DIRECTORY_PROJECT_NAME=`.`,DEFAULT_AI_PACKAGE_VERSION=`^7.0.137`,DEFAULT_ZOD_PACKAGE_VERSION=`4.5.4`,DEFAULT_EVE_PACKAGE_CONTRACT={version:`0.88.1`,nodeEngine:`>=24`};function resolveEvePackageContract(e=DEFAULT_EVE_PACKAGE_CONTRACT){return{version:resolveVersionToken(`evePackage.version`,e.version),nodeEngine:resolveVersionToken(`evePackage.nodeEngine`,e.nodeEngine)}}function modelProviderSlug(e){let t=(e.split(`/`)[0]??``).replaceAll(/[^A-Za-z0-9._-]/gu,``);return t.length>0?t:`anthropic`}function byokProviderEnvVar(e){let t=modelProviderSlug(e).toUpperCase().replaceAll(/[^A-Z0-9]/gu,`_`);return`${/^[0-9]/.test(t)?`_`:``}${t}_API_KEY`}function agentTemplateFiles(e,t){return{[SCAFFOLDED_AGENT_PATHS.config]:renderAgentTemplate(e,t),[SCAFFOLDED_AGENT_PATHS.channel]:WEB_CHANNEL_TEMPLATES.default,[SCAFFOLDED_AGENT_PATHS.instructions]:AGENT_INSTRUCTIONS_TEMPLATE}}function renderAgentTemplate(e,t){let n=parseChatGptModelSelection(e);return n===void 0?BASE_AGENT_TEMPLATE.replaceAll(`__EVE_INIT_MODEL__`,e).replaceAll(`__EVE_INIT_REASONING__`,reasoningTemplateLine(t)):`import { defineAgent } from "eve";\nimport { chatgpt } from "eve/models/openai";\n\nexport default defineAgent({\n model: chatgpt(${JSON.stringify(n)}),\n${reasoningTemplateLine(t)}});\n`}function reasoningTemplateLine(e){return e===void 0||e===`provider-default`?``:` reasoning: "${e}",\n`}function renderTemplate(e,t){return e===BASE_AGENT_TEMPLATE&&parseChatGptModelSelection(t.model)!==void 0?renderAgentTemplate(t.model,t.reasoning):e.replaceAll(`__EVE_INIT_APP_NAME__`,t.appName).replaceAll(`__EVE_INIT_MODEL__`,t.model).replaceAll(`__EVE_INIT_REASONING__`,reasoningTemplateLine(t.reasoning)).replaceAll(`__EVE_INIT_BYOK_PROVIDER__`,modelProviderSlug(t.model)).replaceAll(`__EVE_INIT_BYOK_ENV_VAR__`,byokProviderEnvVar(t.model)).replaceAll(`__EVE_INIT_PACKAGE_VERSION__`,formatEveDependencySpecifier(t.eveVersion)).replaceAll(`__EVE_INIT_AI_SDK_VERSION__`,t.aiPackageVersion).replaceAll(`__EVE_INIT_CONNECT_VERSION__`,t.connectPackageVersion).replaceAll(`__EVE_INIT_ZOD_VERSION__`,t.zodPackageVersion).replaceAll(`__EVE_INIT_TYPESCRIPT_VERSION__`,t.typescriptPackageVersion).replaceAll(`__EVE_INIT_TYPES_NODE_VERSION__`,t.nodeTypesVersion).replaceAll(`__EVE_INIT_NODE_ENGINE__`,t.nodeEngine)}function formatEveDependencySpecifier(e){return/^\d+\.\d+\.\d+(?:[-+][0-9A-Za-z-.]+)?$/.test(e)?`^${e}`:e}const BASE_AGENT_TEMPLATE=`import { defineAgent } from "eve";
|
|
2
2
|
|
|
3
3
|
export default defineAgent({
|
|
4
4
|
model: "__EVE_INIT_MODEL__",
|
|
@@ -1 +1 @@
|
|
|
1
|
-
async function executeAskQuestionTool(e,t){"use workflow";return toAskQuestionOutput(await t.ask(toAskQuestionRequest(e)))}function toAskQuestionRequest(e){let t=e.options?.map(e=>({description:e.description,id:e.label,label:e.label}));return{allowFreeform:!0,display:t===void 0?`text`:`select`,prompt:e.question,...t!==void 0&&{options:t}}}function toAskQuestionOutput(e){switch(e.status){case`answered`:return{answer:e.optionId??e.text??``,status:`answered`};case`cancelled`:return{interrupted:!0};case`unavailable`:return{status:`unavailable`}}}executeAskQuestionTool.workflowId=`workflow//eve@0.88.
|
|
1
|
+
async function executeAskQuestionTool(e,t){"use workflow";return toAskQuestionOutput(await t.ask(toAskQuestionRequest(e)))}function toAskQuestionRequest(e){let t=e.options?.map(e=>({description:e.description,id:e.label,label:e.label}));return{allowFreeform:!0,display:t===void 0?`text`:`select`,prompt:e.question,...t!==void 0&&{options:t}}}function toAskQuestionOutput(e){switch(e.status){case`answered`:return{answer:e.optionId??e.text??``,status:`answered`};case`cancelled`:return{interrupted:!0};case`unavailable`:return{status:`unavailable`}}}executeAskQuestionTool.workflowId=`workflow//eve@0.88.1//executeAskQuestionTool`;export{executeAskQuestionTool,toAskQuestionOutput,toAskQuestionRequest};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
import{sleep}from"#compiled/@workflow/core/index.js";async function executeSleepTool(e,t){"use workflow";if(t.abortSignal.aborted)return{interrupted:!0};let n=new Promise(e=>t.abortSignal.addEventListener(`abort`,()=>e(`interrupted`),{once:!0})),r=sleep(Math.ceil(e.seconds*1e3)).then(()=>`elapsed`);return await Promise.race([r,n])===`elapsed`?{waitedSeconds:e.seconds}:{interrupted:!0}}executeSleepTool.workflowId=`workflow//eve@0.88.
|
|
1
|
+
import{sleep}from"#compiled/@workflow/core/index.js";async function executeSleepTool(e,t){"use workflow";if(t.abortSignal.aborted)return{interrupted:!0};let n=new Promise(e=>t.abortSignal.addEventListener(`abort`,()=>e(`interrupted`),{once:!0})),r=sleep(Math.ceil(e.seconds*1e3)).then(()=>`elapsed`);return await Promise.race([r,n])===`elapsed`?{waitedSeconds:e.seconds}:{interrupted:!0}}executeSleepTool.workflowId=`workflow//eve@0.88.1//executeSleepTool`;export{executeSleepTool};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
import{resumeTool}from"#tracing/eve/agent-tool-instrumentation.js";function createAgentApprovalInstrumentation(e){async function toolFor(t,n,r){let i=await e.actionStateFor(t,n,r);return i===void 0?void 0:resumeTool(e.tracing,i)}async function onRequested(e,t){let{call:n}=e;e.scope.turnId!==void 0&&e.kind===`approval`&&n!==void 0&&t.state.get()===void 0&&await(await toolFor(e.scope.sessionId,e.scope.turnId,n.callId))?.approval({requestId:e.interactionId,request:e.request})!==void 0&&t.state.set({callId:n.callId,sessionId:e.scope.sessionId,turnId:e.scope.turnId})}async function onResolved(e,t){let n=t.state.get();if(typeof n!=`object`||!n||Array.isArray(n))return;let{callId:r,sessionId:i,turnId:a}=n;if(typeof r!=`string`||typeof i!=`string`||typeof a!=`string`)return;let o=
|
|
1
|
+
import{resumeTool}from"#tracing/eve/agent-tool-instrumentation.js";function createAgentApprovalInstrumentation(e){async function toolFor(t,n,r){let i=await e.actionStateFor(t,n,r);return i===void 0?void 0:resumeTool(e.tracing,i)}async function onRequested(e,t){let{call:n}=e;e.scope.turnId!==void 0&&e.kind===`approval`&&n!==void 0&&t.state.get()===void 0&&await(await toolFor(e.scope.sessionId,e.scope.turnId,n.callId))?.approval({requestId:e.interactionId,request:e.request})!==void 0&&t.state.set({callId:n.callId,sessionId:e.scope.sessionId,turnId:e.scope.turnId})}async function onResolved(e,t){let n=t.state.get();if(typeof n!=`object`||!n||Array.isArray(n))return;let{callId:r,sessionId:i,turnId:a}=n;if(typeof r!=`string`||typeof i!=`string`||typeof a!=`string`)return;let o=await toolFor(i,a,r),s=o?.findApproval(e.interactionId);o!==void 0&&s!==void 0&&(e.responder!==void 0&&(s.attributes({"agent.approval.responder.type":e.responder.type,"agent.approval.responder.id":e.responder.id}),e.outcome===`accepted`&&o.attributes({"agent.tool.approver.type":e.responder.type,"agent.tool.approver.id":e.responder.id})),e.outcome===`failed`?await s.fail(e.error):await s.complete({outcome:APPROVAL_OUTCOMES[e.outcome]??`invalid`,response:e.answer}))}return{"interaction.opened":onRequested,"interaction.settled":onResolved}}const APPROVAL_OUTCOMES={abandoned:`cancelled`,accepted:`approved`,declined:`denied`,expired:`cancelled`,interrupted:`cancelled`,withdrawn:`ignored`};export{createAgentApprovalInstrumentation};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
import{normalizeChannelAudience}from"#shared/channel-audience.js";import{normalizeInstrumentationChannelKind}from"#internal/instrumentation.js";import{contextStorage}from"#context/container.js";import{enteredView}from"#harness/session-machine/current.js";import{traceSessionIdOf,withOperationTraceContext}from"#tracing/eve/conversation-context.js";import{isSampledTrace,resolveTracePolicy,resolveTracePolicyDecision}from"#shared/trace-policy.js";import{ROOT_CONTEXT}from"#compiled/@opentelemetry/api/index.js";import"#instrumentation/lifecycle.js";import{
|
|
1
|
+
import{normalizeChannelAudience}from"#shared/channel-audience.js";import{normalizeInstrumentationChannelKind}from"#internal/instrumentation.js";import{contextStorage}from"#context/container.js";import{enteredView}from"#harness/session-machine/current.js";import{traceSessionIdOf,withOperationTraceContext}from"#tracing/eve/conversation-context.js";import{isSampledTrace,resolveTracePolicy,resolveTracePolicyDecision}from"#shared/trace-policy.js";import{ROOT_CONTEXT}from"#compiled/@opentelemetry/api/index.js";import"#instrumentation/lifecycle.js";import{applyPrincipalTraceDecision}from"#instrumentation/principal-summary.js";import{readInstrumentationDecision}from"#shared/instrumentation-decision.js";import{withChannelAudience}from"#tracing/eve/channel-audience-context.js";import{eveTurnIdentity}from"#tracing/eve/operation-input.js";import{eveActivationMetadata}from"#tracing/eve/metadata.js";function createEveSessionTracing(e){let ensureSessionContext=async t=>{let n=await e.stateStore.get(`session`,t.sessionId);if(n===void 0){let r=normalizeChannelAudience(t.channelAudience),i=resolveSessionTraceDecision(t,r,e.environment,e.tracePolicy);n={agentName:t.agentName,channelAudience:r,channelKind:t.channelKind,channelType:t.channelType,decision:i,context:initialSessionContext(e,t,i),parentLineage:t.parentLineage,rootSessionId:t.rootSessionId,traceSessionId:traceSessionIdOf(t),scheduleId:t.scheduleId,title:t.title},await e.stateStore.set(`session`,t.sessionId,n)}return n},prepareSessionTrace=async e=>{let t=await ensureSessionContext(e);return portableSpanContext(t.context,t.decision)},turnKey=(e,t)=>JSON.stringify([e,t]);async function turnFor(t,n,r){let i=await e.stateStore.get(`turn`,turnKey(t,n));if(i===void 0||!isSampledTrace(i.context))return;let a=await e.stateStore.get(`session`,t);return e.tracing.resume({identity:eveTurnIdentity({sessionId:t,rootSessionId:i.rootSessionId,turnId:n}),context:withOperationTraceContext(r??withChannelAudience(ROOT_CONTEXT,a?.channelAudience),{sessionId:t,...i})})}async function dropped(t,n){let r=await e.stateStore.get(`turn`,turnKey(t,n));return r!==void 0&&!isSampledTrace(r.context)}let prepareTurnTrace=async t=>{let n=await e.stateStore.get(`turn`,turnKey(t.sessionId,t.turnId));if(n!==void 0){let r=await e.stateStore.get(`session`,t.sessionId);return portableSpanContext(n.context,r?.decision)}let r=await ensureSessionContext(t),i=t.sequence===0,a=i?t.parentTraceContext:void 0,o=r.decision?.action===`record`,s=a!==void 0&&!(`isRemote`in a&&a.isRemote===!0),c=i?{...r.context,traceId:s?a.traceId:r.context.traceId,isRemote:!1}:{traceId:e.idGenerator.deriveTraceId(`turn:${t.idempotencyKey}`),spanId:e.idGenerator.deriveSpanId(`turn:${t.idempotencyKey}`),traceFlags:+!!o,isRemote:!1},l=r.agentName??(t.parentLineage??r.parentLineage)?.subagentName,u={agentName:l,caller:a===void 0?void 0:adoptedSpanContext(a),context:c,currentPrincipal:applyPrincipalTraceDecision(t.currentPrincipal,r.decision),initiatorPrincipal:applyPrincipalTraceDecision(t.initiatorPrincipal,r.decision),parentLineage:t.parentLineage??r.parentLineage,rootSessionId:t.rootSessionId,traceSessionId:traceSessionIdOf(t),sequence:t.sequence,startTimeMs:Date.now(),subagentName:(t.parentLineage??r.parentLineage)?.subagentName};if(isSampledTrace(c)){let n=await e.tracing.turn({...eveActivationMetadata({session:r,turn:u,sessionId:t.sessionId}),agentName:l,identity:eveTurnIdentity({...t,sessionId:t.sessionId}),framework:{name:`eve`,version:e.frameworkVersion},capture:{emit:!0,...await e.capturePolicy.forOperation(t)},reference:c,parent:s?adoptedSpanContext(a):void 0,links:activationLinks(u),startTimeMs:u.startTimeMs,context:hostContext(r.channelAudience,t)});u={...u,context:{...c,traceFlags:n.reference.traceFlags}}}return await e.stateStore.set(`turn`,turnKey(t.sessionId,t.turnId),u),portableSpanContext(u.context,r.decision)};async function endTurn(t,n,r){let i=await e.stateStore.get(`turn`,turnKey(t,n));if(i===void 0)return;let a=await e.stateStore.get(`session`,t),o=await turnFor(t,n);if(o!==void 0){let e=eveActivationMetadata({session:a,turn:i,sessionId:t});if(o.attributes(e.attributes??{}),o.links(activationLinks(i)??[]),r===void 0)await o.complete({outcomeUnknown:!0});else if(r.outcome===`failed`){let e=r.error;await o.complete({outcome:`failed`,failed:!0,error:e,errorType:e instanceof Error?e.name:void 0})}else await o.complete({outcome:r.outcome})}await e.stateStore.delete(`turn`,turnKey(t,n))}return{ensureSessionContext,prepareSessionTrace,prepareTurnTrace,turnFor,dropped,async turnSettled(e){let t=contextStorage.getStore(),n=t===void 0?void 0:enteredView(t);(n?.session.status!==`ended`||n.session.outcome!==`failed`||n.session.closedAt!==n.turns[e.turnId]?.closedAt)&&await endTurn(e.sessionId,e.turnId,{outcome:e.outcome,error:e.error})},async sessionEnded(e){e.turnId!==void 0&&await endTurn(e.sessionId,e.turnId,e.outcome===`failed`?{outcome:`failed`,error:e.error}:void 0)}}}function hostContext(e,t){return withOperationTraceContext(withChannelAudience(ROOT_CONTEXT,e),t)}function activationLinks(e){let t=[];return e.caller?.isRemote===!0&&t.push({context:e.caller,relationship:`agent.dispatch`}),e.channelDelivery?.requestTraceContext!==void 0&&t.push({context:e.channelDelivery.requestTraceContext,relationship:`channel.request`}),t.length===0?void 0:t}function portableSpanContext(e,t){return{decision:t,spanId:e.spanId,traceFlags:e.traceFlags,traceId:e.traceId}}function adoptedSpanContext(e){return{isRemote:`isRemote`in e&&e.isRemote===!0,spanId:e.spanId,traceFlags:e.traceFlags,traceId:e.traceId}}function initialSessionContext(e,t,n){let r=t.traceSeed;if(r!==void 0)return{...adoptedSpanContext(r),traceFlags:n.action===`drop`?0:r.traceFlags};let i=`session:${t.sessionId}`,a=t.parentTraceContext;return{traceId:a!==void 0&&!(`isRemote`in a&&a.isRemote===!0)?a.traceId:e.idGenerator.deriveTraceId(i),spanId:e.idGenerator.deriveSpanId(i),traceFlags:+(n.action===`record`)}}function resolveSessionTraceDecision(e,t,n,r){let i={audience:t,environment:n};return e.parentTraceContext!==void 0&&!isSampledTrace(e.parentTraceContext)?{action:`drop`}:e.traceSeed?.decision===void 0?e.traceSeed===void 0?e.parentTraceContext===void 0?e.agentName===void 0?r===void 0?resolveTracePolicyDecision(!0,i):{action:`drop`}:resolveTracePolicy(r,{agentName:e.agentName,audience:t,channel:{kind:normalizeInstrumentationChannelKind(e.channelKind??e.channelType)},environment:n,principalType:`unknown`}):resolveTracePolicyDecision(isSampledTrace(e.parentTraceContext),i):resolveTracePolicyDecision(isSampledTrace(e.traceSeed),i):readInstrumentationDecision(e.traceSeed.decision)??{action:`drop`}}export{createEveSessionTracing};
|
package/docs/channels/mcp.mdx
CHANGED
|
@@ -184,7 +184,7 @@ least `pollAfterMs` before polling again.
|
|
|
184
184
|
|
|
185
185
|
The invocation response is discriminated by `status`:
|
|
186
186
|
|
|
187
|
-
- `working`: work is active; continue polling according to `pollAfterMs`.
|
|
187
|
+
- `working`: work is active; continue polling according to `pollAfterMs`. The optional `statusMessage` describes what the agent is doing right now, such as a running tool call's [activity label](/docs/tools#label-tool-activity) or its tool name, so a client can show progress.
|
|
188
188
|
- `input_required`: present `interactions`, keyed by `interactionId`, then send the complete answer batch through `agent_update`, one `{ interactionId, optionId?, text? }` response per entry. A successful update returns the current invocation state.
|
|
189
189
|
- `authorization_required`: present each sign-in in `interactions`: its `signIn` URL, user code, or instructions. The connection callback resumes the invocation automatically; continue polling.
|
|
190
190
|
- `completed`: the agent's turn settled, after any [tasks](/docs/tools/workflows#run-calls-as-tasks-task) it started finished. Consume the optional `result`: the final assistant message.
|
|
@@ -165,7 +165,7 @@ upserting records across replays.
|
|
|
165
165
|
| Model run | `model.started`, `model.retried`, `model.settled` | Each attempt of a model run. `model.retried` ends a failed attempt before another try; `model.settled.outcome` is `completed`, `failed`, `interrupted`, `abandoned`, or `cancelled` when the turn was cancelled. |
|
|
166
166
|
| Provider call | `model.call.started`, `model.call.settled` | An individual provider call; one model attempt can make several. Settlement has `outcome: "completed"` or `"failed"`; completion carries usage, finish reason, and optional `providerMetadata`. |
|
|
167
167
|
| Call | `call.requested`, `call.settled` | A tool, skill, or agent call, including direct `invokeTool` calls. `capability` identifies its kind and name. Settlement carries `completed`, `failed`, `rejected`, `interrupted`, or `abandoned`. |
|
|
168
|
-
| User input | `interaction.opened`, `interaction.settled` | A question, approval, or budget prompt, keyed by `interactionId`. Settlement includes the interaction's `outcome` and, when recorded, its `answer`.
|
|
168
|
+
| User input | `interaction.opened`, `interaction.settled` | A question, approval, or budget prompt, keyed by `interactionId`. Settlement includes the interaction's `outcome`, `responder` (who decided it), and, when recorded, its `answer`. |
|
|
169
169
|
| Memory operation | `memory.operation.started`, `memory.operation.settled` | A memory search or write, with operation name, phase, and slot. Settlement has `outcome: "completed"` or `"failed"`. |
|
|
170
170
|
|
|
171
171
|
A delivery that pauses for a person settles `awaiting-input`; resumed work belongs to the answer's delivery. OTel attributes a turn to a delivery only when exactly one delivery was consumed. Event `scope` includes session and run coordinates; `turnId` can be absent for compaction or direct calls. Treat `idempotencyKey` as opaque.
|
|
@@ -266,6 +266,8 @@ A message from the parent agent to a subagent never answers the subagent's tool
|
|
|
266
266
|
|
|
267
267
|
Approval is consent only. An approved tool call runs with the requesting user's identity, connections, and credentials, including its policy recheck. The approver's access is never lent to the call. Subsequent tool calls in the turn also stay with the original owner.
|
|
268
268
|
|
|
269
|
+
For auditing, traces record both people: the turn span's `agent.principal.current.*` attributes name the requester, and the approval span's `agent.approval.responder.type` and `agent.approval.responder.id` name who approved or denied the call. An approved call's tool span also records its approver as `agent.tool.approver.type` and `agent.tool.approver.id`, since the tool can act on the approver's behalf. All of these ids follow one rule: they are recorded only when the trace policy records both inputs and outputs and the conversation is public or running in development. Otherwise only the type is recorded.
|
|
270
|
+
|
|
269
271
|
A `defineTool` tool can still act on the approver's behalf when it chooses to. While an approved `defineTool` call runs, `ctx.approval.responder` is the principal who approved it, and `ctx.approval.responder.getToken(provider)` resolves that person's token for an inline provider, as `ctx.getToken(provider)` does for the requester. `ctx.session.auth.current` stays the requester. `ctx.approval` is absent for calls that needed no approval, and workflow tools don't receive it. `ctx.approval.responder.getToken(provider)` never starts a sign-in: when the approver has no token, it throws a `ConnectionAuthorizationFailedError` with `reason: "approver_authorization_required"`.
|
|
270
272
|
|
|
271
273
|
```ts
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "eve",
|
|
3
|
-
"version": "0.88.
|
|
3
|
+
"version": "0.88.1",
|
|
4
4
|
"private": false,
|
|
5
5
|
"description": "Filesystem-first framework for durable backend AI agents that run anywhere.",
|
|
6
6
|
"keywords": [
|
|
@@ -598,7 +598,7 @@
|
|
|
598
598
|
},
|
|
599
599
|
"dependencies": {
|
|
600
600
|
"nitro": "3.0.260903-beta",
|
|
601
|
-
"undici": "8.
|
|
601
|
+
"undici": "8.12.3"
|
|
602
602
|
},
|
|
603
603
|
"devDependencies": {
|
|
604
604
|
"@agentclientprotocol/sdk": "1.3.0",
|
|
@@ -631,7 +631,7 @@
|
|
|
631
631
|
"@types/json-schema": "7.0.15",
|
|
632
632
|
"@types/react": "19.2.15",
|
|
633
633
|
"@types/react-test-renderer": "19.1.0",
|
|
634
|
-
"@vercel/agent-runs": "0.0.
|
|
634
|
+
"@vercel/agent-runs": "0.0.4",
|
|
635
635
|
"@vercel/blob": "2.8.0",
|
|
636
636
|
"@vercel/connect": "2.5.2",
|
|
637
637
|
"@vercel/detect-agent": "1.2.3",
|