eve 0.88.0 → 0.89.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +10 -21
- package/dist/src/channel/interaction-prompts.d.ts +0 -2
- package/dist/src/channel/interaction-prompts.js +1 -1
- package/dist/src/chunks/{use-eve-agent-BExXjBv6.js → use-eve-agent-Bbl4H5aA.js} +19 -2
- package/dist/src/chunks/{use-eve-agent-C0KHCyb9.js → use-eve-agent-CNpxgKEH.js} +19 -2
- package/dist/src/client/conversation.js +1 -1
- package/dist/src/client/transcript.d.ts +7 -4
- package/dist/src/client/transcript.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/extensions/git/extension/extension.d.ts +12 -9
- package/dist/src/extensions/git/extension/extension.js +1 -1
- package/dist/src/extensions/git/extension/lib/gh-tool.d.ts +4 -12
- package/dist/src/extensions/git/extension/lib/gh-tool.js +1 -1
- package/dist/src/extensions/git/extension/lib/github-guidance.js +4 -4
- package/dist/src/extensions/git/extension/lib/github-shell-schema.d.ts +3 -5
- package/dist/src/extensions/git/extension/lib/github-shell-schema.js +1 -1
- package/dist/src/extensions/git/extension/lib/github-shell.d.ts +31 -21
- package/dist/src/extensions/git/extension/lib/github-shell.js +1 -1
- package/dist/src/extensions/git/extension/lib/signed-commit.js +1 -1
- package/dist/src/extensions/git/tools.d.ts +2 -10
- 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-events/families/delivery.d.ts +3 -2
- 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/shared/session-history.d.ts +4 -2
- package/dist/src/shared/session-history.js +1 -1
- package/dist/src/svelte/index.js +1 -1
- package/dist/src/svelte/use-eve-agent.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/dist/src/vue/index.js +1 -1
- package/dist/src/vue/use-eve-agent.js +1 -1
- package/docs/channels/eve.mdx +1 -1
- package/docs/channels/mcp.mdx +1 -1
- package/docs/code-extension.mdx +17 -60
- package/docs/concepts/execution-model-and-durability.mdx +1 -1
- package/docs/concepts/sessions-runs-and-streaming.md +3 -1
- package/docs/guides/client/streaming.mdx +1 -1
- package/docs/guides/frontend/use-eve-agent.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
|
@@ -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.
|
|
1
|
+
const STAMPED_PACKAGE_VERSION=`0.89.0`;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};
|
|
@@ -20,13 +20,14 @@ export interface DeliveryAdmittedData {
|
|
|
20
20
|
readonly source?: DeliverySource;
|
|
21
21
|
}
|
|
22
22
|
/**
|
|
23
|
-
* A message from conversation eve did not run, such as a transcript an app stored. It
|
|
24
|
-
*
|
|
23
|
+
* A message from conversation eve did not run, such as a transcript an app stored. It names no
|
|
24
|
+
* turn or call, and records nothing eve ran.
|
|
25
25
|
*/
|
|
26
26
|
export interface ImportedMessage {
|
|
27
27
|
/** The app's own id for the message, when it gave one. eve never reads it. */
|
|
28
28
|
readonly id?: string;
|
|
29
29
|
readonly role: "user" | "assistant";
|
|
30
|
+
/** The message's plain text. */
|
|
30
31
|
readonly text: string;
|
|
31
32
|
}
|
|
32
33
|
export interface DeliveryConsumedData {
|
|
@@ -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.
|
|
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.89.0//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.
|
|
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.89.0`,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__",
|
|
@@ -16,7 +16,9 @@ export declare class InvalidSessionHistoryError extends Error {
|
|
|
16
16
|
readonly name = "InvalidSessionHistoryError";
|
|
17
17
|
}
|
|
18
18
|
/**
|
|
19
|
-
* Validates `history` at the send boundary and returns a normalized copy
|
|
20
|
-
*
|
|
19
|
+
* Validates `history` at the send boundary and returns a normalized copy.
|
|
20
|
+
* Returns `undefined` when `history` is omitted. An entry with a field outside
|
|
21
|
+
* the contract is rejected, not dropped, so no caller already sends a field a
|
|
22
|
+
* later release starts to read.
|
|
21
23
|
*/
|
|
22
24
|
export declare function validateSessionHistory(history: unknown): readonly SessionHistoryMessage[] | undefined;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
import{isObject}from"#shared/guards.js";var InvalidSessionHistoryError=class extends Error{name=`InvalidSessionHistoryError`};function validateSessionHistory(e){if(e===void 0)return;if(!Array.isArray(e))throw new InvalidSessionHistoryError(`history must be an array of messages.`);let t=new Set;return e.map((e,n)=>{let r=`history[${n}]`;if(!isObject(e))throw new InvalidSessionHistoryError(`${r} must be an object.`);let{id:i,role:a,text:o}=e;if(a!==`user`&&a!==`assistant`)throw new InvalidSessionHistoryError(`${r}.role must be "user" or "assistant".`);if(typeof o!=`string`||o.trim().length===0)throw new InvalidSessionHistoryError(`${r}.text must be a non-empty string.`);let s={role:a,text:o};if(i===void 0)return s;if(typeof i!=`string`||i.length===0)throw new InvalidSessionHistoryError(`${r}.id must be a non-empty string.`);if(t.has(i))throw new InvalidSessionHistoryError(`${r}.id "${i}" is not unique.`);return t.add(i),{...s,id:i}})}export{InvalidSessionHistoryError,validateSessionHistory};
|
|
1
|
+
import{isObject}from"#shared/guards.js";var InvalidSessionHistoryError=class extends Error{name=`InvalidSessionHistoryError`};const HISTORY_FIELDS=[`id`,`role`,`text`];function validateSessionHistory(e){if(e===void 0)return;if(!Array.isArray(e))throw new InvalidSessionHistoryError(`history must be an array of messages.`);let t=new Set;return e.map((e,n)=>{let r=`history[${n}]`;if(!isObject(e))throw new InvalidSessionHistoryError(`${r} must be an object.`);rejectUnknownFields(e,r);let{id:i,role:a,text:o}=e;if(a!==`user`&&a!==`assistant`)throw new InvalidSessionHistoryError(`${r}.role must be "user" or "assistant".`);if(typeof o!=`string`||o.trim().length===0)throw new InvalidSessionHistoryError(`${r}.text must be a non-empty string.`);let s={role:a,text:o};if(i===void 0)return s;if(typeof i!=`string`||i.length===0)throw new InvalidSessionHistoryError(`${r}.id must be a non-empty string.`);if(t.has(i))throw new InvalidSessionHistoryError(`${r}.id "${i}" is not unique.`);return t.add(i),{...s,id:i}})}function rejectUnknownFields(e,t){let n=Object.keys(e).filter(t=>!HISTORY_FIELDS.includes(t)&&e[t]!==void 0);if(n.length===0)return;let r=n.slice(0,8).sort().map(e=>JSON.stringify(e.length>128?`${e.slice(0,128)}…`:e)),i=n.length>8?` (and more)`:``;throw new InvalidSessionHistoryError(`${t} has unknown field${n.length===1?``:`s`} ${r.join(`, `)}${i}. Accepted fields: ${HISTORY_FIELDS.join(`, `)}.`)}export{InvalidSessionHistoryError,validateSessionHistory};
|
package/dist/src/svelte/index.js
CHANGED
|
@@ -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.
|
|
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.89.0//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.
|
|
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.89.0//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/dist/src/vue/index.js
CHANGED
package/docs/channels/eve.mdx
CHANGED
|
@@ -456,7 +456,7 @@ When the session at the address is [stranded](../guides/deployment/self-hosting#
|
|
|
456
456
|
|
|
457
457
|
`send()` accepts the same `history` option. The entries are added right before that message and its `context`, whether the send creates the session or continues it. The eve channel's `onMessage` can return `history` the same way. It applies to every message it is returned for, so return it only when the message should carry those turns.
|
|
458
458
|
|
|
459
|
-
Each entry has a `role` of `"user"` or `"assistant"`, non-empty `text`, and an optional `id` that is unique within the call. Invalid history throws an `InvalidSessionHistoryError`, exported from `eve/channels`, that names the entry and the rule it broke. eve doesn't cap how many entries or how much text one call carries. Your route decides how much stored conversation to load, so trim long conversations there, for example to the newest messages. Tool calls, files, and reasoning are not supported.
|
|
459
|
+
Each entry has a `role` of `"user"` or `"assistant"`, non-empty `text`, and an optional `id` that is unique within the call. An entry with any other field is rejected, not dropped, so map your stored messages to these fields. Invalid history throws an `InvalidSessionHistoryError`, exported from `eve/channels`, that names the entry and the rule it broke. eve doesn't cap how many entries or how much text one call carries. Your route decides how much stored conversation to load, so trim long conversations there, for example to the newest messages. Tool calls, files, and reasoning are not supported.
|
|
460
460
|
|
|
461
461
|
eve never accepts `history` from a client request body. Resolve it on the server and authorize the caller against the stored conversation.
|
|
462
462
|
|
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.
|