eve 0.83.3 → 0.84.0

package/dist/src/harness/tools.d.ts

@@ -1,15 +1,13 @@
-import { type ToolApprovalConfiguration, type ToolSet } from "ai";
+import { type ToolSet } from "ai";
 import type { ModelProfile } from "#harness/model-profile.js";
 import type { HarnessToolDefinition } from "#harness/execute-tool.js";
-import type { CallResolver, HarnessToolMap } from "#harness/types.js";
+import type { HarnessToolMap } from "#harness/types.js";
+import { type ApprovalMemory } from "#approval/evaluation.js";
+import type { ApprovalDecision } from "#approval/status.js";
 import type { ToolExecuteOptions } from "#tools/definition.js";
 /**
- * Builds an AI SDK `ToolSet` from unified harness tool definitions, described
- * by `describe`. Each call's output is projected by the entry `resolve`
- * resolves it to.
- *
- * Tools without `execute` are surfaced to the model as client-side tools
- * (no server execution).
+ * Describes harness tools to the AI SDK, each as `describe` words it. The SDK only calls the
+ * model, so it gets no `execute`: eve runs every call itself (`#harness/call-executor.js`).
  *
  * Entries listed in `disabledProviderTools` are skipped entirely. Used
  * by the harness recovery path when a gateway fallback provider has
@@ -19,20 +17,19 @@ import type { ToolExecuteOptions } from "#tools/definition.js";
 export declare function buildToolSet(input: {
     readonly describe: (definition: HarnessToolDefinition) => string;
     readonly disabledProviderTools?: ReadonlySet<string>;
-    readonly resolve: CallResolver;
     readonly tools: HarnessToolMap;
 }): ToolSet;
+/** A tool eve runs inside the step, rather than the runtime or the provider. */
+export type RunnableTool = HarnessToolDefinition & {
+    readonly execute: NonNullable<HarnessToolDefinition["execute"]>;
+};
+export declare function isRunnableTool(definition: HarnessToolDefinition | undefined): definition is RunnableTool;
 /**
- * Wraps a tool's `execute` so a returned {@link AuthorizationSignal} is
- * stashed out-of-band ({@link stashToolInterrupt}) for the park detector while
- * the AI SDK records an opaque {@link AuthorizationPendingModelOutput} that
- * omits OAuth URLs, user codes, and hook URLs from model-facing history.
- * Returns `undefined` for client-side tools (no `execute`). With `resolve`,
- * output is normalized under the name of the entry each call resolves to, so
- * an error from a call through `execute` names the entry, and a tool stub
- * matches that entry and its input, as it would a direct call.
+ * Runs a tool's `execute` for one call, through its stub when an eval stubs it, as the caller who
+ * approved the call. Outputs are normalized to JSON, except an {@link AuthorizationSignal}, which
+ * the executor turns into a sign-in.
  */
-export declare function wrapToolExecute(definition: HarnessToolDefinition, resolve?: CallResolver): ((input: any, options: ToolExecuteOptions) => Promise<any> | AsyncIterable<any>) | undefined;
+export declare function invokeTool(definition: RunnableTool, input: unknown, options: ToolExecuteOptions): Promise<unknown> | AsyncIterable<unknown>;
 /**
  * Builds the AI SDK ToolSet for one harness step.
  *
@@ -56,28 +53,15 @@ export declare function buildToolSetWithProviderTools(input: {
     readonly describe: (definition: HarnessToolDefinition) => string;
     readonly disabledProviderTools?: ReadonlySet<string>;
     readonly profile: ModelProfile;
-    readonly resolve: CallResolver;
     readonly tools: HarnessToolMap;
 }): Promise<ToolSet>;
-/**
- * Builds the AI SDK 7 call-level approval policy: each call is approved by the
- * entry it runs, under that entry's name and with its own input.
- */
-export declare function buildToolApproval(input: {
-    readonly abortSignal?: AbortSignal;
-    readonly approvedTools: ReadonlySet<string>;
-    readonly resolve: CallResolver;
-}): ToolApprovalConfiguration<ToolSet, Record<string, unknown>>;
-/**
- * Re-runs a tool's approval policy for a call a person approved, just before eve runs it, so the
- * policy can still refuse it, as when the connection it was approved against changed.
- */
-export declare function recheckApprovedCall(definition: HarnessToolDefinition, call: {
+interface ApprovalCall {
     readonly callId: string;
     readonly input: unknown;
     readonly abortSignal?: AbortSignal;
-    readonly approvedTools?: ReadonlySet<string>;
-}): Promise<{
-    readonly denied: boolean;
-    readonly reason?: string;
-}>;
+    readonly approvalMemory?: ApprovalMemory;
+    readonly recheck?: boolean;
+}
+/** Decides whether a call runs, needs a person's approval, or is denied. */
+export declare function decideApproval(definition: HarnessToolDefinition, call: ApprovalCall): Promise<ApprovalDecision>;
+export {};

package/dist/src/harness/tools.js

@@ -1 +1 @@
-import{tool}from"ai";import{createLogger}from"#internal/logging.js";import{isObject}from"#shared/guards.js";import{loadContext}from"#context/container.js";import{toModelSchema}from"#tools/schema.js";import{buildCallbackContext}from"#context/build-callback-context.js";import{resolveApprovalPolicy}from"#approval/definition.js";import{isApprovedToolCall,markApprovalRecheck}from"#harness/approval-recheck.js";import{isAuthorizationSignal,modelFacingAuthorizationOutput}from"#harness/authorization.js";import{entryModelOutput,stubbedCall}from"#harness/execute-call.js";import{normalizeToolJsonOutput}from"#harness/tool-model-output.js";import{isAsyncIterable}from"#shared/async-iterable.js";import{executeWithToolStub}from"#tool-stubs/execute.js";import{stashToolInterrupt}from"#harness/tool-interrupts.js";import{resolveWebSearchBackend,resolveWebSearchProviderTool}from"#harness/provider-tools.js";const log=createLogger(`harness.tools`);function buildToolSet(e){let t={},n=e.disabledProviderTools;for(let r of e.tools.values())n?.has(r.name)||(t[r.name]=tool({description:e.describe(r),execute:wrapToolExecute(r,e.resolve),inputSchema:toModelSchema(r.inputSchema,`input`),strict:!1,outputSchema:toModelSchema(r.outputSchema,`output`),...r.execute!==void 0||r.toModelOutput!==void 0?{toModelOutput:({input:t,output:n,toolCallId:i})=>entryModelOutput(e.resolve({input:t,toolName:r.name})?.definition??r,n,i)}:{}}));return t}function wrapToolExecute(e,t){let n=e.execute;if(n!==void 0)return(r,i)=>{let a={input:r,toolName:e.name},o=t?.(a),s=o?.definition.name??e.name,c=stubbedCall(a,o),run=()=>n(r,i),l;try{l=c===void 0?run():executeWithToolStub(c.toolName,c.input,i,run)}catch(e){return Promise.reject(e)}return isAsyncIterable(l)?normalizeToolExecuteIterable(l,s,i):Promise.resolve(l).then(e=>normalizeToolExecuteOutput(e,s,i))}}async function*normalizeToolExecuteIterable(e,t,n){for await(let r of e)yield normalizeToolExecuteOutput(r,t,n)}function normalizeToolExecuteOutput(e,t,n){return isAuthorizationSignal(e)?(stashToolInterrupt(loadContext(),n.toolCallId,e),modelFacingAuthorizationOutput(e)):normalizeToolJsonOutput({boundary:`execute`,output:e,toolCallId:n.toolCallId,toolName:t})}async function buildToolSetWithProviderTools(e){let t=e.disabledProviderTools,n={...buildToolSet(e)};for(let r of e.tools.values()){let i=r.behavior?.handling;if(i?.kind===`provider-tool`&&r.execute===void 0&&!t?.has(r.name)){let t=resolveWebSearchBackend(e.profile,i);t===null?(log.debug(`model has no web search backend; leaving the tool out`,{gateway:e.profile.gateway,modelProvider:e.profile.provider,searchProvider:i.provider,tool:r.name}),delete n[r.name]):n[r.name]=await resolveWebSearchProviderTool(t)}}return n}function buildToolApproval(e){return async({toolCall:t,messages:n})=>{let r=e.resolve(t);if(r!==void 0)return await evaluateApproval(r.definition,{abortSignal:e.abortSignal,approvedTools:e.approvedTools,callId:t.toolCallId,input:r.call.input,recheck:isApprovedToolCall(n,t.toolCallId)})}}async function recheckApprovedCall(e,t){let n=await evaluateApproval(e,{...t,recheck:!0});return n===`denied`?{denied:!0}:typeof n==`object`&&n&&n.type===`denied`?{denied:!0,reason:n.reason}:{denied:!1}}async function evaluateApproval(e,t){if(e.approval===void 0)return;let n={...buildCallbackContext(),abortSignal:t.abortSignal??new AbortController().signal,approvedTools:t.approvedTools??new Set,callId:t.callId,toolInput:isObject(t.input)?t.input:void 0,toolName:e.name},r=await resolveApprovalPolicy(e.approval)(t.recheck?markApprovalRecheck(n):n);return typeof r==`boolean`?r?`user-approval`:`not-applicable`:r}export{buildToolApproval,buildToolSet,buildToolSetWithProviderTools,recheckApprovedCall,wrapToolExecute};
+import{tool}from"ai";import{createLogger}from"#internal/logging.js";import{isObject}from"#shared/guards.js";import{toModelSchema}from"#tools/schema.js";import{buildCallbackContext}from"#context/build-callback-context.js";import{evaluateApproval}from"#approval/evaluation.js";import{isAuthorizationSignal}from"#harness/authorization.js";import{resolveApprovalPolicy}from"#approval/definition.js";import{normalizeToolJsonOutput}from"#harness/tool-model-output.js";import{isAsyncIterable}from"#shared/async-iterable.js";import{executeWithToolStub}from"#tool-stubs/execute.js";import{resolveWebSearchBackend,resolveWebSearchProviderTool}from"#harness/provider-tools.js";const log=createLogger(`harness.tools`);function buildToolSet(e){let t={},n=e.disabledProviderTools;for(let r of e.tools.values())n?.has(r.name)||(t[r.name]=tool({description:e.describe(r),inputSchema:toModelSchema(r.inputSchema,`input`),strict:!1,outputSchema:toModelSchema(r.outputSchema,`output`)}));return t}function isRunnableTool(e){return e?.execute!==void 0}function invokeTool(e,t,n){let{execute:r}=e,i;try{i=executeWithToolStub(e.name,t,n,()=>r(t,n))}catch(e){return Promise.reject(e)}return isAsyncIterable(i)?normalizeToolExecuteIterable(i,e.name,n):Promise.resolve(i).then(t=>normalizeToolExecuteOutput(t,e.name,n))}async function*normalizeToolExecuteIterable(e,t,n){for await(let r of e)yield normalizeToolExecuteOutput(r,t,n)}function normalizeToolExecuteOutput(e,t,n){return isAuthorizationSignal(e)?e:normalizeToolJsonOutput({boundary:`execute`,output:e,toolCallId:n.toolCallId,toolName:t})}async function buildToolSetWithProviderTools(e){let t=e.disabledProviderTools,n={...buildToolSet(e)};for(let r of e.tools.values()){let i=r.behavior?.handling;if(i?.kind===`provider-tool`&&r.execute===void 0&&!t?.has(r.name)){let t=resolveWebSearchBackend(e.profile,i);t===null?(log.debug(`model has no web search backend; leaving the tool out`,{gateway:e.profile.gateway,modelProvider:e.profile.provider,searchProvider:i.provider,tool:r.name}),delete n[r.name]):n[r.name]=await resolveWebSearchProviderTool(t)}}return n}async function decideApproval(e,t){return e.approval===void 0?{denied:!1}:await evaluateApproval(resolveApprovalPolicy(e.approval),{...buildCallbackContext(),abortSignal:t.abortSignal??new AbortController().signal,callId:t.callId,toolInput:isObject(t.input)?t.input:void 0,toolName:e.name},{memory:t.approvalMemory,recheck:t.recheck})}export{buildToolSet,buildToolSetWithProviderTools,decideApproval,invokeTool,isRunnableTool};

package/dist/src/harness/types.d.ts

@@ -1,20 +1,22 @@
+import type { SessionEvent } from "#protocol/session-event.js";
+import type { ConsumedDelivery } from "#harness/session-machine/transitions.js";
 import type { AuthorizationChallenge } from "#harness/authorization.js";
-import type { LanguageModel, ModelMessage, UserContent } from "ai";
+import type { LanguageModel } from "ai";
+import type { MessageContent } from "#shared/message-content.js";
 import type { SessionAuthContext, SessionCapabilities } from "#channel/types.js";
-import type { AlsContext } from "#context/container.js";
-import type { RuntimeIdentity, StepStartedStreamEvent, UnstampedMessageStreamEvent } from "#protocol/message.js";
+import type { RuntimeIdentity } from "#protocol/session-events/families/session.js";
 import type { RuntimeActionResult } from "#shared/action-types.js";
 import type { RuntimeModelReference } from "#runtime/agent/bootstrap.js";
-import type { InputResponse } from "#shared/input.js";
+import type { Answer } from "#shared/input.js";
 import type { SandboxState } from "#sandbox/state.js";
 import type { JsonObject } from "#shared/json.js";
 import type { TokenUsage } from "#shared/token-usage.js";
+import type { Principal } from "#protocol/session-events/envelope.js";
 import type { InternalToolDefinition } from "#tools/definition.js";
 import type { AgentReasoningDefinition, SessionUsageLimit } from "#shared/agent-definition.js";
 import type { HarnessToolDefinition } from "#harness/execute-tool.js";
 import type { HarnessModelMessage } from "#harness/messages.js";
 import type { SessionInstrumentation } from "#instrumentation/runtime.js";
-import type { HistoryViewProjector, PreparedHistoryView } from "#shared/history-view.js";
 import type { SessionHistoryMessage } from "#shared/session-history.js";
 /**
  * Serializable tool definition stored on the session.
@@ -25,12 +27,15 @@ import type { SessionHistoryMessage } from "#shared/session-history.js";
 export type SessionToolDefinition = Readonly<InternalToolDefinition>;
 /** Authored-key → opaque-value map stored on `session.state`. */
 export type SessionStateMap = Readonly<Record<string, unknown>>;
-/**
- * Compaction configuration stored on the session.
- */
-export interface CompactionConfig {
+/** Prompt observations that survive rebuilding the agent's settings on each turn. */
+export interface CompactionState {
     readonly lastKnownInputTokens?: number;
     readonly lastKnownPromptMessageCount?: number;
+    /** The previous request's non-history estimate, also used before the next request is built. */
+    readonly requestEnvelopeTokens?: number;
+}
+/** Compaction configuration stored on the session. */
+export interface CompactionConfig extends CompactionState {
     readonly recentWindowSize: number;
     readonly threshold: number;
     readonly thresholdPercent?: number;
@@ -89,27 +94,19 @@ export interface HarnessSession extends HarnessSessionBase {
     readonly history: HarnessModelMessage[];
 }
 export declare function requireSessionModelReference(session: HarnessSession): RuntimeModelReference;
+/** The delivery a control arrived as: its id, and who sent it, as the wire names them. */
+export interface ControlDelivery {
+    readonly deliveryId: string;
+    readonly principal?: Principal;
+}
 /**
- * Input payload for a harness turn.
- *
- * Carries an optional message and/or structured input responses from the
- * channel emitter's `onDeliver`. The message may be a plain text string or
- * a structured AI SDK {@link UserContent} array (mixing `text`, `image`,
- * and `file` parts) to support multimodal attachments delivered by
- * channels. The harness resolves any pending input batch at the start of
- * `runStep` before the model call.
+ * What a channel's `deliver` hook makes of one payload: the input a turn receives. The message is
+ * {@link MessageContent}: plain text, or text and file parts.
  */
-export interface AttributedInputResponse {
-    readonly auth: SessionAuthContext | null;
-    readonly response: InputResponse;
-}
 export interface StepInput {
-    /** Internal responder-bound input produced at the delivery boundary. */
-    readonly attributedInputResponses?: readonly AttributedInputResponse[];
-    readonly inputResponses?: readonly InputResponse[];
-    readonly message?: string | UserContent;
-    /** Internal actor attribution for `message`. */
-    readonly messageAuth?: SessionAuthContext | null;
+    /** Answers to the session's open interactions. */
+    readonly answers?: readonly Answer[];
+    readonly message?: MessageContent;
     /**
      * Context strings from the channel delivery. Each entry is appended as a
      * synthetic user-role message to `session.history` before the
@@ -127,13 +124,35 @@ export interface StepInput {
      * present. Omitted continuations keep the existing schema.
      */
     readonly outputSchema?: JsonObject;
+}
+/**
+ * An answer as the session received it: the response it submits, the delivery it arrived in,
+ * and who gave it when that isn't the turn's caller.
+ */
+export interface SubmittedAnswer extends Answer {
+    readonly responseId: string;
+    readonly deliveryId: string;
     /**
-     * Runtime-owned action results being resumed into the current turn.
-     *
-     * This field is internal to the execution/harness boundary and is never
-     * produced by channels.
+     * Who answered an approval when a delivery only answered requests: the turn keeps its caller.
+     * `null` answers as no one; absent, the answer is the caller's.
      */
+    readonly responder?: SessionAuthContext | null;
+}
+/**
+ * A turn step's input inside the session: what `deliver` made, with each answer bound to the
+ * response it submits, and what the runtime resumes. Never produced by channels.
+ */
+export interface HarnessStepInput extends Omit<StepInput, "answers"> {
+    readonly answers?: readonly SubmittedAnswer[];
+    /** Runtime-owned action results being resumed into the current turn. */
     readonly runtimeActionResults?: readonly RuntimeActionResult[];
+    /**
+     * What the agents behind some of {@link runtimeActionResults} spent, by call id. Each call's
+     * settlement records it, so the session counts a child's usage once.
+     */
+    readonly delegatedUsage?: Readonly<Record<string, TokenUsage>>;
+    /** The deliveries this input carries, each with what its person sent, which the turn consumes. */
+    readonly deliveries?: readonly ConsumedDelivery[];
 }
 /**
  * Terminal result indicating the conversation is finished.
@@ -196,7 +215,7 @@ export type TurnHold = {
  * A single step of AI work. Takes the current session and optional user input,
  * returns the updated session and an instruction for the runtime.
  */
-export type StepFn = (session: HarnessSession, input?: StepInput) => Promise<StepResult>;
+export type StepFn = (session: HarnessSession, input?: HarnessStepInput) => Promise<StepResult>;
 /**
  * Map from tool name to its harness-owned definition.
  *
@@ -219,22 +238,24 @@ export interface ResolvedCall<T extends ToolCallLike> {
 /** Resolves a model tool call to the entry it runs, if it reaches one. */
 export type CallResolver = <T extends ToolCallLike>(toolCall: T) => ResolvedCall<T> | undefined;
 /**
- * Callback that writes one event to the event stream.
- *
- * Composed by the runtime from the underlying writable and the channel's
- * event handler, then injected into the harness so it can emit lifecycle
- * events without knowing about writables or handlers.
+ * What one publish writes: one event, or every event of one transition, which the writer commits
+ * as one line so readers never see half of it.
  */
-export type HarnessEmitFn = (event: UnstampedMessageStreamEvent, messages?: readonly import("ai").ModelMessage[]) => Promise<void>;
+export type SessionPublication = SessionEvent | readonly SessionEvent[];
+/** The sink the harness emits to: see {@link HandleEventFn}. */
+export type HarnessEmitFn = HandleEventFn;
+/** Where a model call stands: its turn and its step within the turn. */
+export interface StepCoordinates {
+    readonly sequence: number;
+    readonly stepIndex: number;
+    readonly turnId: string;
+}
 /**
- * Unified event handler: emits the event to the stream, then
- * dispatches to hook subscribers and dynamic tool resolvers.
- *
- * Same signature as {@link HarnessEmitFn} but semantically broader —
- * every event goes through channel adapter, stream write, hooks,
- * and dynamic tool dispatch in one call.
+ * Publishes one event or one commit to the session: the stream write, then the channel and the
+ * session's reactions. Composed by the runtime and injected into the harness, so the harness emits
+ * lifecycle without knowing about writables or handlers.
  */
-export type HandleEventFn = (event: UnstampedMessageStreamEvent, messages?: readonly import("ai").ModelMessage[]) => Promise<void>;
+export type HandleEventFn = (publication: SessionPublication, messages?: readonly import("ai").ModelMessage[]) => Promise<void>;
 /**
  * Dependencies injected into the tool-loop harness at construction time.
  */
@@ -248,15 +269,14 @@ export interface ToolLoopHarnessConfig {
      * continuation prompt may park the session.
      */
     readonly capabilities?: SessionCapabilities;
+    readonly sessionUsageLimit?: SessionUsageLimit;
     /** Clears model-message history without running a model turn. */
     readonly clearOnly?: boolean;
     /** Forces one context-compaction pass without running a model turn. */
     readonly compactOnly?: boolean;
+    /** The delivery a clear or compact control arrived as; its facts name it. */
+    readonly controlDelivery?: ControlDelivery;
     readonly handleEvent?: HandleEventFn;
-    /** Projects raw durable history before it crosses a message-bearing boundary. */
-    readonly historyProjector?: HistoryViewProjector;
-    /** Execution-prepared view of the history supplied to the first harness step. */
-    readonly historyView?: PreparedHistoryView;
     /**
      * Internal lifecycle hooks injected into each actual model attempt.
      * Omitted in production until an instrumentation runtime opts in.
@@ -275,22 +295,6 @@ export interface ToolLoopHarnessConfig {
      * routes structured answers down.
      */
     readonly typedAnswers?: boolean;
-    /** Restores runtime resources for the originating turn before approval work. */
-    readonly prepareApprovalTurn?: (event: {
-        readonly sequence: number;
-        readonly turnId: string;
-    }) => Promise<void>;
-    /** Resolves persisted step-scoped tools before an approval policy reads them. */
-    readonly resolveStepDynamicTools?: (input: {
-        readonly ctx: AlsContext;
-        readonly event: StepStartedStreamEvent;
-        readonly messages: readonly ModelMessage[];
-    }) => Promise<void>;
-    readonly dispatchDynamicModelEvent?: (input: {
-        readonly ctx: AlsContext;
-        readonly event: UnstampedMessageStreamEvent;
-        readonly messages: readonly ModelMessage[];
-    }) => Promise<void>;
     readonly resolveModel: (reference: RuntimeModelReference) => Promise<LanguageModel>;
     /**
      * Runtime identity metadata attached to the `session.started` event.
@@ -300,8 +304,6 @@ export interface ToolLoopHarnessConfig {
      * authoritative server-side metadata.
      */
     readonly runtimeIdentity?: RuntimeIdentity;
-    /** The agent's `limits.sessionUsage`; the default limit applies when absent. */
-    readonly sessionUsageLimit?: SessionUsageLimit;
     /**
      * Unified tool definitions for this harness step.
      *

package/dist/src/harness/user-parts.d.ts

@@ -0,0 +1,4 @@
+import type { UserPart } from "#protocol/session-events/envelope.js";
+import type { MessageContent } from "#shared/message-content.js";
+/** The parts of one message. */
+export declare function userPartsOf(message: MessageContent): readonly UserPart[];

package/dist/src/harness/user-parts.js

@@ -0,0 +1 @@
+import{deserializeUrlFilePart,hasInternalRefScheme,isSerializedUrlFilePart}from"#internal/attachments/url-refs.js";import{decodeSandboxRef,isSandboxRefUrl}from"#internal/attachments/sandbox-refs.js";import{getKnownByteLength}from"#internal/attachments/data.js";function userPartsOf(e){if(typeof e==`string`)return[{kind:`text`,text:e}];let t=[];for(let n of e)t.push(n.type===`text`?{kind:`text`,text:n.text}:filePart(n.data,n.mediaType,n.filename));return t}function filePart(e,t,n){if(isSandboxRefUrl(e)){let t=decodeSandboxRef(e);return file({filename:basenameOf(n??t.path),mediaType:t.mediaType,size:t.size})}if(isTaggedFileData(e))switch(e.type){case`data`:return file({filename:n,mediaType:t,size:byteLengthOf(e.data)});case`reference`:case`text`:return file({filename:n,mediaType:t});case`url`:return file({filename:n,mediaType:t,url:clientUrl(e.url)})}let r=byteLengthOf(e);return file(r===void 0?{filename:n,mediaType:t,url:clientUrl(e)}:{filename:n,mediaType:t,size:r})}function file(e){let t={kind:`file`,mediaType:e.mediaType};return e.filename!==void 0&&(t.filename=e.filename),e.size!==void 0&&(t.size=e.size),e.url===void 0?t.unavailable=!0:t.url=e.url,t}function isTaggedFileData(e){if(typeof e!=`object`||!e)return!1;let t=e.type;return t===`data`||t===`reference`||t===`text`||t===`url`}function byteLengthOf(e){return getKnownByteLength(e)??void 0}function clientUrl(e){if(isSerializedUrlFilePart(e))try{return httpUrl(deserializeUrlFilePart(e))}catch{return}if(e instanceof URL)return httpUrl(e);if(!(typeof e!=`string`||hasInternalRefScheme(e)||e.startsWith(`data:`)))try{return httpUrl(new URL(e))}catch{return}}function httpUrl(e){return e.protocol===`http:`||e.protocol===`https:`?e.href:void 0}function basenameOf(e){let t=e.replaceAll(`\\`,`/`),n=t.slice(t.lastIndexOf(`/`)+1);return n.length>0?n:e}export{userPartsOf};

package/dist/src/harness/workflow-tool-runs.d.ts

@@ -1,6 +1,5 @@
 import type { RuntimeToolResultActionResult } from "#shared/action-types.js";
 import type { SessionStateMap } from "#harness/types.js";
-export declare const WORKFLOW_TOOL_RUNS_STATE_KEY = "eve.workflowTool";
 /** One workflow tool call the originating turn waits on. */
 export interface BlockingWorkflowToolRun {
     readonly callId: string;

package/dist/src/harness/workflow-tool-runs.js

@@ -1 +1 @@
-import{isNonEmptyString,isObject}from"#shared/guards.js";const WORKFLOW_TOOL_RUNS_STATE_KEY=`eve.workflowTool`;function isWorkflowToolRun(e){return isObject(e)&&isNonEmptyString(e.callId)&&isNonEmptyString(e.toolName)&&isObject(e.origin)&&isNonEmptyString(e.origin.turnId)&&typeof e.origin.stepIndex==`number`&&Number.isSafeInteger(e.origin.stepIndex)&&e.origin.stepIndex>=0&&isObject(e.address)&&isNonEmptyString(e.address.runId)&&isNonEmptyString(e.address.hookToken)}function parseRegistry(e){if(!isObject(e)||e.version!==4||!Array.isArray(e.runs)||!Array.from(e.runs).every(isWorkflowToolRun))throw Error(`Corrupt workflow tool run registry: invalid version or run.`);let t=new Set;for(let n of e.runs){let e=JSON.stringify([n.origin.turnId,n.callId]);if(t.has(e))throw Error(`Corrupt workflow tool run registry: Run identities must be unique.`);t.add(e)}return{...e,version:4,runs:e.runs.map(copyWorkflowToolRun)}}function copyWorkflowToolRun(e){return{...e,origin:{...e.origin},address:{...e.address}}}function readRegistry(e){let t=e?.[WORKFLOW_TOOL_RUNS_STATE_KEY];if(isUnsupportedState(e,t))throw Error(`Unsupported workflow tool run state: start a new session or import its conversation.`);return t===void 0?{version:4,runs:[]}:parseRegistry(t)}function isUnsupportedState(e,t){let n=e?.[`eve.tasks`]!==void 0||e?.[`eve.runtime.workflowToolRuns`]!==void 0,r=isObject(t)&&t.version!==4;return n||r}function getBlockingWorkflowToolRuns(e,t){return readRegistry(e).runs.filter(e=>t===void 0||e.origin.turnId===t)}function writeRegistry(e,t){if(t.runs.length===0){let t={...e};return delete t[WORKFLOW_TOOL_RUNS_STATE_KEY],Object.keys(t).length===0?void 0:t}return{...e,[WORKFLOW_TOOL_RUNS_STATE_KEY]:parseRegistry(t)}}function registerWorkflowToolRun(e,t){let n=readRegistry(e.state),r=[...n.runs],i=r.findIndex(e=>e.origin.turnId===t.origin.turnId&&e.callId===t.callId),a=r[i];if(a!==void 0&&a.toolName!==t.toolName)throw Error(`Replayed invocation changed its tool identity.`);return a===void 0?r.push(t):r[i]={...a,...t,origin:a.origin,address:{...a.address,...t.address}},{...e,state:writeRegistry(e.state,{...n,runs:r})}}function removeBlockingWorkflowToolRuns(e,t,n){let r=readRegistry(e.state),i=r.runs,a=i.filter(e=>e.origin.turnId!==t||n!==void 0&&e.callId!==n);return a.length===i.length?e:{...e,state:writeRegistry(e.state,{...r,runs:a})}}function findBlockingWorkflowToolRun(e,t,n){let r=getBlockingWorkflowToolRuns(e,n).filter(e=>e.callId===t);return r.length===1?r[0]:void 0}function isInboxToolResultFromRecordedWorkflowToolRun(e,t){let n=findBlockingWorkflowToolRun(e,t.callId);return n!==void 0&&n.toolName===t.toolName}export{WORKFLOW_TOOL_RUNS_STATE_KEY,findBlockingWorkflowToolRun,getBlockingWorkflowToolRuns,isInboxToolResultFromRecordedWorkflowToolRun,registerWorkflowToolRun,removeBlockingWorkflowToolRuns};
+import{isNonEmptyString,isObject}from"#shared/guards.js";import{readRunningWork,writeRunningWork}from"#harness/running-work.js";function isWorkflowToolRun(e){return isObject(e)&&isNonEmptyString(e.callId)&&isNonEmptyString(e.toolName)&&isObject(e.origin)&&isNonEmptyString(e.origin.turnId)&&typeof e.origin.stepIndex==`number`&&Number.isSafeInteger(e.origin.stepIndex)&&e.origin.stepIndex>=0&&isObject(e.address)&&isNonEmptyString(e.address.runId)&&isNonEmptyString(e.address.hookToken)}function parseRuns(e){if(!e.every(isWorkflowToolRun))throw Error(`Corrupt workflow tool run registry: invalid run.`);let t=new Set;for(let n of e){let e=JSON.stringify([n.origin.turnId,n.callId]);if(t.has(e))throw Error(`Corrupt workflow tool run registry: Run identities must be unique.`);t.add(e)}return e.map(copyWorkflowToolRun)}function copyWorkflowToolRun(e){return{...e,origin:{...e.origin},address:{...e.address}}}function readRuns(e){return parseRuns(readRunningWork(e).calls)}function writeRuns(e,t){return writeRunningWork(e,{calls:parseRuns(t)})}function getBlockingWorkflowToolRuns(e,t){return readRuns(e).filter(e=>t===void 0||e.origin.turnId===t)}function registerWorkflowToolRun(e,t){let n=[...readRuns(e.state)],r=n.findIndex(e=>e.origin.turnId===t.origin.turnId&&e.callId===t.callId),i=n[r];if(i!==void 0&&i.toolName!==t.toolName)throw Error(`Replayed invocation changed its tool identity.`);return i===void 0?n.push(t):n[r]={...i,...t,origin:i.origin,address:{...i.address,...t.address}},{...e,state:writeRuns(e.state,n)}}function removeBlockingWorkflowToolRuns(e,t,n){let r=readRuns(e.state),i=r.filter(e=>e.origin.turnId!==t||n!==void 0&&e.callId!==n);return i.length===r.length?e:{...e,state:writeRuns(e.state,i)}}function findBlockingWorkflowToolRun(e,t,n){let r=getBlockingWorkflowToolRuns(e,n).filter(e=>e.callId===t);return r.length===1?r[0]:void 0}function isInboxToolResultFromRecordedWorkflowToolRun(e,t){let n=findBlockingWorkflowToolRun(e,t.callId);return n!==void 0&&n.toolName===t.toolName}export{findBlockingWorkflowToolRun,getBlockingWorkflowToolRuns,isInboxToolResultFromRecordedWorkflowToolRun,registerWorkflowToolRun,removeBlockingWorkflowToolRuns};

package/dist/src/instrumentation/ai-sdk-hook-bridge.d.ts

@@ -1,4 +1,4 @@
 import type { Telemetry } from "ai";
-import type { InstrumentationAttemptScope, InstrumentationContextRunner, InstrumentationHooks } from "#instrumentation/lifecycle.js";
+import type { InstrumentationScope, InstrumentationContextRunner, InstrumentationHooks } from "#instrumentation/lifecycle.js";
 /** Creates one provider-neutral AI SDK bridge for one actual model attempt. */
-export declare function createAiSdkHookBridge(scope: InstrumentationAttemptScope, hooks: InstrumentationHooks, runInContext?: InstrumentationContextRunner, runtimeContext?: Readonly<Record<string, unknown>>, isFrameworkTool?: (name: string) => boolean): Telemetry;
+export declare function createAiSdkHookBridge(scope: InstrumentationScope, hooks: InstrumentationHooks, runInContext?: InstrumentationContextRunner, runtimeContext?: Readonly<Record<string, unknown>>, isFrameworkTool?: (name: string) => boolean): Telemetry;

package/dist/src/instrumentation/ai-sdk-hook-bridge.js

@@ -1 +1 @@
-import{attemptIdempotencyKey,modelCallIdempotencyKey,toolCallIdempotencyKey}from"#instrumentation/lifecycle.js";import{structuralProviderMetadata}from"#instrumentation/content.js";import{modelContent,modelUsage}from"#compiled/@vercel/agent-runs/ai-sdk.js";function createAiSdkHookBridge(e,t,n=directRunInContext,r,i){let a={capturesInputs:t.capturesInputs??t.capturesContent,capturesOutputs:t.capturesOutputs??t.capturesContent,modelCallIndexes:new Map,modelCallStartEvents:new Map,modelKeys:new Map,runtimeContext:r!==void 0&&Object.keys(r).length>0?Object.freeze({...r}):void 0,scope:e,toolKeys:new Map,toolCalls:new Map,isFrameworkTool:i},nextModelCallKey=e=>{let t=a.modelCallIndexes.get(e)??0;return a.modelCallIndexes.set(e,t+1),modelCallIdempotencyKey(a.scope,e,t)};return{onStart(e){a.operation=Object.freeze({modelId:e.modelId,operationId:e.operationId,provider:e.provider})},async onStepStart(e){a.stepNumber=e.stepNumber;let n=toStepAttemptStarted(a);n!==void 0&&await t.publish(n)},async onLanguageModelCallStart(e){let n=a.stepNumber??0,r=nextModelCallKey(n);a.modelKeys.set(e.callId,r);let i=toModelCallStarted(a,r,e);a.modelCallStartEvents.set(e.callId,{event:i,stepNumber:n}),await t.publish(i)},async executeLanguageModelCall({callId:r,execute:i}){let o=a.modelKeys.get(r);if(o===void 0){let e=a.modelCallStartEvents.get(r);if(e===void 0)return i();o=nextModelCallKey(e.stepNumber),a.modelKeys.set(r,o),await t.publish(Object.freeze({...e.event,idempotencyKey:o}))}try{return await n({idempotencyKey:o,scope:e,type:`model.call`},i)}catch(n){throw a.modelKeys.get(r)===o&&a.modelKeys.delete(r),await t.publish(Object.freeze({error:n,idempotencyKey:o,scope:e,type:`model.call.failed`})),n}},async onLanguageModelCallEnd(e){let n=a.modelKeys.get(e.callId);if(n===void 0)return;a.modelKeys.delete(e.callId),a.modelCallStartEvents.delete(e.callId);let r=toModelCallCompleted(a,n,e);await t.publish(r)},async onStepEnd(e){if(e.providerMetadata===void 0)return;let n=a.capturesOutputs?e.providerMetadata:structuralProviderMetadata(e.providerMetadata);await t.publish(Object.freeze({idempotencyKey:attemptIdempotencyKey(a.scope),providerMetadata:n,scope:a.scope,type:`step.attempt.metadata`}))},onToolExecutionStart(e){let t=toolCallIdempotencyKey(a.scope,e.toolCall.toolCallId,a.stepNumber??0);a.toolKeys.set(e.toolCall.toolCallId,t);let n=toToolCallStarted(a,t,e);a.toolCalls.set(e.toolCall.toolCallId,n)},executeTool({toolCallId:e,execute:t}){let r=a.toolCalls.get(e);return r===void 0?t():n({...r,type:`tool.call`},t)},onToolExecutionEnd(e){let t=e.toolCall.toolCallId;a.toolKeys.get(t)!==void 0&&(a.toolKeys.delete(t),a.toolCalls.delete(t))},async onAbort(e){await failOpenOperations(e.reason)},async onError(e){await failOpenOperations(e.error)}};async function failOpenOperations(n){let r=[];for(let i of a.modelKeys.values())r.push(t.publish(Object.freeze({error:n,idempotencyKey:i,scope:e,type:`model.call.failed`})));a.modelKeys.clear(),a.modelCallStartEvents.clear(),a.toolKeys.clear(),a.toolCalls.clear(),await Promise.all(r)}}const directRunInContext=(e,t)=>t();function toStepAttemptStarted(e){if(e.operation!==void 0&&e.stepNumber!==void 0)return Object.freeze({idempotencyKey:attemptIdempotencyKey(e.scope),operation:e.operation,runtimeContext:e.runtimeContext,scope:e.scope,type:`step.attempt.started`})}function toModelCallStarted(e,t,n){return Object.freeze({idempotencyKey:t,input:e.capturesInputs?Object.freeze({instructions:n.instructions,messages:Object.freeze([...n.messages]),tools:n.tools===void 0?void 0:Object.freeze([...n.tools])}):void 0,model:Object.freeze({modelId:n.modelId,provider:n.provider}),runtimeContext:e.runtimeContext,scope:e.scope,type:`model.call.started`})}function toModelCallCompleted(e,t,n){return Object.freeze({content:e.capturesOutputs?Object.freeze(modelContent(n.content).map(e=>Object.freeze(e))):void 0,finishReason:n.finishReason,idempotencyKey:t,responseModelId:n.modelId,responseId:n.responseId,scope:e.scope,type:`model.call.completed`,usage:Object.freeze(modelUsage(n.usage))})}function toToolCallStarted(e,t,n){return Object.freeze({callId:n.toolCall.toolCallId,frameworkTool:e.isFrameworkTool?.(n.toolCall.toolName)===!0,idempotencyKey:t,input:e.capturesInputs?n.toolCall.input:void 0,scope:e.scope,toolName:n.toolCall.toolName,startedAtMs:Date.now(),type:`tool.call.started`})}export{createAiSdkHookBridge};
+import{attemptIdempotencyKey,modelCallIdempotencyKey,toolCallIdempotencyKey}from"#instrumentation/lifecycle.js";import{structuralProviderMetadata}from"#instrumentation/content.js";import{modelContent,modelUsage}from"#compiled/@vercel/agent-runs/ai-sdk.js";function createAiSdkHookBridge(e,t,n=directRunInContext,r,i){let a={capturesInputs:t.capturesInputs??t.capturesContent,capturesOutputs:t.capturesOutputs??t.capturesContent,modelCallIndexes:new Map,modelCallStartEvents:new Map,modelKeys:new Map,runtimeContext:r!==void 0&&Object.keys(r).length>0?Object.freeze({...r}):void 0,scope:e,toolKeys:new Map,toolCalls:new Map,isFrameworkTool:i},nextModelCallKey=e=>{let t=a.modelCallIndexes.get(e)??0;return a.modelCallIndexes.set(e,t+1),modelCallIdempotencyKey(a.scope,e,t)};return{onStart(e){a.operation=Object.freeze({modelId:e.modelId,operationId:e.operationId,provider:e.provider})},async onStepStart(e){a.stepNumber=e.stepNumber;let n=a.started?void 0:toModelStarted(a);n!==void 0&&(a.started=!0,await t.publish(n))},async onLanguageModelCallStart(e){let n=a.stepNumber??0,r=nextModelCallKey(n);a.modelKeys.set(e.callId,r);let i=toModelCallStarted(a,r,e);a.modelCallStartEvents.set(e.callId,{event:i,stepNumber:n}),await t.publish(i)},async executeLanguageModelCall({callId:r,execute:i}){let o=a.modelKeys.get(r);if(o===void 0){let e=a.modelCallStartEvents.get(r);if(e===void 0)return i();o=nextModelCallKey(e.stepNumber),a.modelKeys.set(r,o),await t.publish(Object.freeze({...e.event,idempotencyKey:o}))}try{return await n({idempotencyKey:o,scope:e,type:`model.call`},i)}catch(n){throw a.modelKeys.get(r)===o&&a.modelKeys.delete(r),await t.publish(Object.freeze({outcome:`failed`,error:n,idempotencyKey:o,scope:e,type:`model.call.settled`})),n}},async onLanguageModelCallEnd(e){let n=a.modelKeys.get(e.callId);if(n===void 0)return;a.modelKeys.delete(e.callId),a.modelCallStartEvents.delete(e.callId);let r=toModelCallCompleted(a,n,e);await t.publish(r)},onToolExecutionStart(e){let t=toolCallIdempotencyKey(a.scope,e.toolCall.toolCallId,a.stepNumber??0);a.toolKeys.set(e.toolCall.toolCallId,t);let n=toToolCallStarted(a,t,e);a.toolCalls.set(e.toolCall.toolCallId,n)},executeTool({toolCallId:e,execute:t}){let r=a.toolCalls.get(e);return r===void 0?t():n({...r,type:`tool.call`},t)},onToolExecutionEnd(e){let t=e.toolCall.toolCallId;a.toolKeys.get(t)!==void 0&&(a.toolKeys.delete(t),a.toolCalls.delete(t))},async onAbort(e){await failOpenOperations(e.reason)},async onError(e){await failOpenOperations(e.error)}};async function failOpenOperations(n){let r=[];for(let i of a.modelKeys.values())r.push(t.publish(Object.freeze({outcome:`failed`,error:n,idempotencyKey:i,scope:e,type:`model.call.settled`})));a.modelKeys.clear(),a.modelCallStartEvents.clear(),a.toolKeys.clear(),a.toolCalls.clear(),await Promise.all(r)}}const directRunInContext=(e,t)=>t();function toModelStarted(e){if(e.operation!==void 0&&e.stepNumber!==void 0)return Object.freeze({idempotencyKey:attemptIdempotencyKey(e.scope),operation:e.operation,runtimeContext:e.runtimeContext,scope:e.scope,type:`model.started`})}function toModelCallStarted(e,t,n){return Object.freeze({idempotencyKey:t,input:e.capturesInputs?Object.freeze({instructions:n.instructions,messages:Object.freeze([...n.messages]),tools:n.tools===void 0?void 0:Object.freeze([...n.tools])}):void 0,model:Object.freeze({modelId:n.modelId,provider:n.provider}),runtimeContext:e.runtimeContext,scope:e.scope,type:`model.call.started`})}function toModelCallCompleted(e,t,n){return Object.freeze({outcome:`completed`,content:e.capturesOutputs?Object.freeze(modelContent(n.content).map(e=>Object.freeze(e))):void 0,providerMetadata:n.providerMetadata===void 0?void 0:e.capturesOutputs?n.providerMetadata:structuralProviderMetadata(n.providerMetadata),finishReason:n.finishReason,idempotencyKey:t,responseModelId:n.modelId,responseId:n.responseId,scope:e.scope,type:`model.call.settled`,usage:Object.freeze(modelUsage(n.usage))})}function toToolCallStarted(e,t,n){return Object.freeze({capability:{kind:`tool`,name:n.toolCall.toolName},callId:n.toolCall.toolCallId,frameworkTool:e.isFrameworkTool?.(n.toolCall.toolName)===!0,idempotencyKey:t,input:e.capturesInputs?n.toolCall.input:void 0,scope:e.scope,toolName:n.toolCall.toolName,startedAtMs:Date.now(),type:`call.requested`})}export{createAiSdkHookBridge};

package/dist/src/instrumentation/channel-delivery.d.ts

@@ -1,24 +1,5 @@
-import type { DeliverHookPayload } from "#channel/types.js";
 import type { AlsContext } from "#context/container.js";
-import type { InstrumentationChannelDeliveryOutcome, InstrumentationHooks } from "#instrumentation/lifecycle.js";
-export interface ChannelDeliveryStartInstrumentation {
-    readonly traceSessionId: string;
-    readonly agentName?: string;
-    readonly ctx: AlsContext;
-    readonly delivery: DeliverHookPayload;
-    readonly hooks: InstrumentationHooks | undefined;
-    readonly policyAgentName: string;
-    readonly rootSessionId: string;
-    readonly sequence: number;
-    readonly sessionId: string;
-    readonly turnId: string;
-}
-export interface ChannelDeliveryTerminalInstrumentation {
-    readonly ctx: AlsContext;
-    readonly error?: unknown;
-    readonly errorCode?: string;
-    readonly hooks: InstrumentationHooks | undefined;
-    readonly includeTurn: boolean;
-    readonly outcome: InstrumentationChannelDeliveryOutcome;
-}
-export declare function instrumentChannelDelivery(input: ChannelDeliveryStartInstrumentation | ChannelDeliveryTerminalInstrumentation): Promise<void>;
+import type { CreateInstrumentationHandleEventInput } from "#instrumentation/native-events.js";
+import type { InstrumentationEvent } from "#instrumentation/lifecycle.js";
+import type { SessionEvent } from "#protocol/session-event.js";
+export declare function deliveryEvent(event: SessionEvent, ctx: AlsContext | undefined, session: CreateInstrumentationHandleEventInput): InstrumentationEvent | undefined;

package/dist/src/instrumentation/channel-delivery.js

@@ -1 +1 @@
-import{ConversationContextKey,UNKNOWN_CONVERSATION_CONTEXT}from"#shared/conversation-context.js";import{ActiveChannelDeliveriesKey,ChannelInstrumentationKey,ParentTraceContextKey,SessionTraceSeedKey}from"#context/keys.js";import{channelDeliveryIdempotencyKey}from"#instrumentation/lifecycle.js";async function instrumentChannelDelivery(e){if(!(`delivery`in e)){let t=e.ctx.get(ActiveChannelDeliveriesKey);if(t===void 0||e.hooks===void 0)return;let n=`channel.delivery.${e.outcome}`;for(let r of t){let t=r.policyAgentName??r.agentName;if(t===void 0)continue;let i=e.ctx.get(ConversationContextKey)??UNKNOWN_CONVERSATION_CONTEXT;await(e.hooks.forTrace?.({agentName:t,...i,audience:r.delivery.channelAudience??i.audience})??e.hooks).publish({agentName:r.agentName,delivery:r.delivery,error:e.error,errorCode:e.errorCode,idempotencyKey:channelDeliveryIdempotencyKey(r.sessionId,r.delivery.deliveryId),outcome:e.outcome,rootSessionId:r.rootSessionId,traceSessionId:r.traceSessionId,sequence:e.includeTurn?r.sequence:void 0,sessionId:r.sessionId,turnId:e.includeTurn?r.turnId:void 0,type:n})}e.ctx.delete(ActiveChannelDeliveriesKey);return}if(e.hooks===void 0||e.delivery.deliveryMetadata===void 0)return;let t=[...e.ctx.get(ActiveChannelDeliveriesKey)??[]],n=e.ctx.get(ConversationContextKey)??UNKNOWN_CONVERSATION_CONTEXT,r=n.audience,i=e.hooks.forTrace?.({agentName:e.policyAgentName,...n})??e.hooks;for(let n of e.delivery.deliveryMetadata){let a=e.delivery.payloads[n.payloadIndex],o={channelAudience:r,channelKind:n.channelKind,channelName:n.channelName,deliveryId:n.deliveryId,requestId:n.requestId,requestTraceContext:n.requestTraceContext},s=!(i.capturesInputs??i.capturesContent)||a===void 0?void 0:projectDeliveryInput(a),c={agentName:e.agentName,channelType:e.ctx.get(ChannelInstrumentationKey)?.channelType,delivery:o,policyAgentName:e.policyAgentName,rootSessionId:e.rootSessionId,traceSessionId:e.traceSessionId,sequence:e.sequence,sessionId:e.sessionId,turnId:e.turnId};t.some(e=>e.sessionId===c.sessionId&&e.delivery.deliveryId===c.delivery.deliveryId)||(t.push(c),await i?.publish({agentName:c.agentName,delivery:o,idempotencyKey:channelDeliveryIdempotencyKey(e.sessionId,o.deliveryId),input:s,parentTraceContext:e.ctx.get(ParentTraceContextKey),rootSessionId:e.rootSessionId,traceSessionId:e.traceSessionId,sequence:e.sequence,sessionId:e.sessionId,traceSeed:e.ctx.get(SessionTraceSeedKey),turnId:e.turnId,type:`channel.delivery.started`}))}t.length>0&&e.ctx.set(ActiveChannelDeliveriesKey,t)}function projectDeliveryInput(e){let t={};return e.context!==void 0&&(t.context=e.context),e.message!==void 0&&(t.message=e.message),e.outputSchema!==void 0&&(t.outputSchema=e.outputSchema),e.inputResponses!==void 0&&(t.inputResponses=e.inputResponses.map(e=>{let t={};return e.optionId!==void 0&&(t.optionId=e.optionId),e.text!==void 0&&(t.text=e.text),t})),t}export{instrumentChannelDelivery};
+import{ChannelDeliveryKey,SessionTraceSeedKey}from"#context/keys.js";import{channelDeliveryIdempotencyKey}from"#instrumentation/lifecycle.js";function deliveryEvent(e,t,n){if(e.type!==`delivery.consumed`&&e.type!==`delivery.settled`)return;let{deliveryId:r,turnId:i}=e.data,a=channelDeliveryIdempotencyKey(n.sessionId,r);if(e.type===`delivery.settled`)return{...e.data,idempotencyKey:a,sessionId:n.sessionId,type:e.type};let o=n.deliveryInput,s=o?.deliveryMetadata?.find(e=>e.deliveryId===r),c=t?.get(ChannelDeliveryKey),l=s??(c?.deliveryId===r?c:void 0),u=s===void 0?void 0:o?.payloads[s.payloadIndex];return{agentName:n.agentName,deliveryId:r,delivery:l===void 0?void 0:{channelAudience:n.channelAudience,channelKind:l.channelKind,channelName:l.channelName,deliveryId:r,requestId:l.requestId,requestTraceContext:l.requestTraceContext},idempotencyKey:a,input:n.hooks?.capturesInputs||n.hooks?.capturesContent?u===void 0?{message:e.data.parts}:projectDeliveryInput(u):void 0,rootSessionId:n.rootSessionId??n.sessionId,sessionId:n.sessionId,traceSeed:t?.get(SessionTraceSeedKey),traceSessionId:n.traceSessionId,turnId:i,type:`delivery.consumed`}}function projectDeliveryInput(e){return{context:e.context,message:e.message,outputSchema:e.outputSchema,answers:e.answers?.map(({optionId:e,text:t})=>({optionId:e,text:t}))}}export{deliveryEvent};

package/dist/src/instrumentation/content.d.ts

@@ -2,13 +2,7 @@ import type { InstrumentationEvent } from "#instrumentation/lifecycle.js";
 import type { InstrumentationDecision } from "#shared/instrumentation-decision.js";
 /** Returns an immutable event projection with conversation content removed. */
 export declare function withoutInstrumentationContent(event: InstrumentationEvent): InstrumentationEvent;
-/**
- * Projects lifecycle content by direction.
- *
- * Inputs are data entering the agent: delivery/action/tool/model starts and a
- * resolved user's response. Outputs are data produced by the agent: requests
- * for user input, action/tool/model terminals, provider metadata, and errors.
- */
+/** Inputs enter the agent; responses, requests for a person, metadata and errors leave it. */
 export declare function withInstrumentationDecision(event: InstrumentationEvent, decision: Extract<InstrumentationDecision, {
     action: "record";
 }>): InstrumentationEvent;

package/dist/src/instrumentation/content.js

@@ -1 +1 @@
-import{readGatewayRouting}from"#shared/gateway-routing.js";function withoutInstrumentationContent(e){return withInstrumentationDecision(e,{action:`record`,recordInputs:!1,recordOutputs:!1})}function withInstrumentationDecision(e,t){switch(e.type){case`session.started`:return t.recordInputs?e:Object.freeze({...e,title:void 0});case`channel.delivery.started`:return t.recordInputs?e:Object.freeze({...e,input:void 0});case`input.requested`:return t.recordOutputs?e:Object.freeze({...e,request:void 0});case`input.resolved`:return t.recordInputs&&t.recordOutputs?e:Object.freeze({...e,error:t.recordOutputs?e.error:void 0,response:t.recordInputs?e.response:void 0});case`tool.call.started`:return t.recordInputs?e:Object.freeze({...e,input:void 0});case`tool.call.completed`:return t.recordOutputs?e:Object.freeze({...e,output:Object.freeze({type:e.output.type})});case`model.call.started`:return t.recordInputs?e:Object.freeze({...e,input:void 0});case`model.call.completed`:return t.recordOutputs?e:Object.freeze({...e,content:void 0});case`memory.operation.completed`:return t.recordInputs?e:Object.freeze({...e,outputRecords:void 0});case`step.attempt.metadata`:return t.recordOutputs?e:Object.freeze({...e,providerMetadata:structuralProviderMetadata(e.providerMetadata)});case`model.call.failed`:case`memory.operation.failed`:case`session.failed`:case`step.attempt.failed`:case`tool.call.failed`:case`turn.failed`:case`channel.delivery.failed`:return t.recordOutputs?e:Object.freeze({...e,error:void 0});default:return e}}function structuralProviderMetadata(e){let t=e.gateway;if(typeof t!=`object`||!t||Array.isArray(t))return Object.freeze({});let n=t,r={};for(let e of[`cost`,`generationId`]){let t=n[e];(typeof t==`string`||typeof t==`number`)&&(r[e]=t)}let i=readGatewayRouting(n.routing);return i!==void 0&&(r.routing=i),Object.freeze(Object.keys(r).length===0?{}:{gateway:Object.freeze(r)})}export{structuralProviderMetadata,withInstrumentationDecision,withoutInstrumentationContent};
+import{readGatewayRouting}from"#shared/gateway-routing.js";function withoutInstrumentationContent(e){return withInstrumentationDecision(e,{action:`record`,recordInputs:!1,recordOutputs:!1})}function withInstrumentationDecision(e,t){switch(e.type){case`session.started`:return t.recordInputs?e:Object.freeze({...e,title:void 0});case`call.requested`:return t.recordInputs?e:Object.freeze({...e,input:void 0,capability:Object.freeze({...e.capability,label:void 0})});case`delivery.consumed`:case`model.call.started`:return t.recordInputs?e:Object.freeze({...e,input:void 0});case`interaction.opened`:return t.recordOutputs?e:Object.freeze({...e,request:void 0});case`interaction.settled`:return Object.freeze({...e,error:t.recordOutputs?e.error:void 0,answer:t.recordInputs?e.answer:void 0});case`call.settled`:return t.recordOutputs?e:Object.freeze({...e,error:void 0,output:void 0});case`model.call.settled`:return e.outcome===`failed`?t.recordOutputs?e:Object.freeze({...e,error:void 0}):t.recordOutputs?e:Object.freeze({...e,content:void 0,providerMetadata:e.providerMetadata===void 0?void 0:structuralProviderMetadata(e.providerMetadata)});case`memory.operation.settled`:return e.outcome===`failed`?t.recordOutputs?e:Object.freeze({...e,error:void 0}):t.recordInputs?e:Object.freeze({...e,outputRecords:void 0});case`model.retried`:case`model.settled`:case`session.ended`:case`turn.settled`:return t.recordOutputs?e:Object.freeze({...e,error:void 0});default:return e}}function structuralProviderMetadata(e){let t=e.gateway;if(typeof t!=`object`||!t||Array.isArray(t))return Object.freeze({});let n=t,r={};for(let e of[`cost`,`generationId`]){let t=n[e];(typeof t==`string`||typeof t==`number`)&&(r[e]=t)}let i=readGatewayRouting(n.routing);return i!==void 0&&(r.routing=i),Object.freeze(Object.keys(r).length===0?{}:{gateway:Object.freeze(r)})}export{structuralProviderMetadata,withInstrumentationDecision,withoutInstrumentationContent};

package/dist/src/instrumentation/dispatch.js

@@ -1 +1 @@
-import{createLogger,formatError}from"#internal/logging.js";import{abandonInstrumentationState,instrumentationStateSlot,isInstrumentationStateAbandoned,releaseAllInstrumentationAttemptState,releaseAllInstrumentationState,releaseAllInstrumentationTurnState,takeInstrumentationActionScopes}from"#instrumentation/state.js";import{resolveTracePolicy}from"#shared/trace-policy.js";import{withInstrumentationDecision,withoutInstrumentationContent}from"#instrumentation/content.js";const log=createLogger(`harness.instrumentation-dispatch`);function createInstrumentationDispatcher(e,t){let n=t.handlerTimeoutMs??5e3,r=normalizeDispatchGroups(e),i=[...r.serialBefore,...r.parallel,...r.serialAfter],a=new Set;function forTrace(e){let t=new WeakMap,o=new Map(i.map(t=>[t,resolveTracePolicy(t.tracePolicy,e,e=>{a.has(t)||(a.add(t),log.warn(`instrumentation provider trace policy failed`,{error:formatError(e),provider:t.name}))})])),s=[...o.values()].some(e=>e.action===`record`&&e.recordInputs),c=[...o.values()].some(e=>e.action===`record`&&e.recordOutputs),l=s||c,publish=async e=>{let i=snapshotInstrumentationEvent(withInstrumentationDecision(e,{action:`record`,recordInputs:s,recordOutputs:c}),t,e),a=i.type===`session.completed`||i.type===`session.failed`,l=i.type===`turn.cancelled`||i.type===`turn.failed`;if(a||l){let e=takeInstrumentationActionScopes(i.sessionId,l?i.turnId:void 0),t=terminalActionFailure(i);for(let n of e)await publish({...t,idempotencyKey:n.idempotencyKey,scope:n.scope,type:`tool.call.failed`})}let u=new Map,visibleEvent=e=>{let t=o.get(e);if(t===void 0||t.action===`drop`)return withoutInstrumentationContent(i);if(t.recordInputs&&t.recordOutputs)return i;let n=`${String(t.recordInputs)}:${String(t.recordOutputs)}`,r=u.get(n);return r===void 0&&(r=withInstrumentationDecision(i,t),u.set(n,r)),r},admitted=e=>o.get(e)?.action===`record`;try{try{for(let e of r.serialBefore)admitted(e)&&await dispatchToProvider(e,i,n,()=>visibleEvent(e));let e=r.parallel.filter(admitted);if(e.length===1){let t=e[0];await dispatchToProvider(t,i,n,()=>visibleEvent(t))}else if(e.length>1){let t=(await Promise.allSettled(e.map(e=>dispatchToProvider(e,i,n,()=>visibleEvent(e))))).find(e=>e.status===`rejected`);if(t!==void 0)throw t.reason}}finally{for(let e of r.serialAfter)admitted(e)&&await dispatchToProvider(e,i,n,()=>visibleEvent(e))}}finally{releaseTerminalState(i)}};return{capturesContent:l,capturesInputs:s,capturesOutputs:c,forTrace,publish}}let o=!1;return{capturesContent:!1,forTrace,async publish(e){o||(o=!0,log.debug(`instrumentation event published without trace binding`,{eventType:e.type}))}}}function snapshotInstrumentationEvent(e,t,n){let r=t.get(n);if(r!==void 0)return r;let i=snapshotPlainValue(e,t);return t.set(n,i),i}function snapshotPlainValue(e,t){if(Array.isArray(e)){let n=t.get(e);if(n!==void 0)return n;let r=[];t.set(e,r);for(let n of e)r.push(snapshotPlainValue(n,t));return Object.freeze(r)}if(typeof e!=`object`||!e)return e;let n;try{n=Object.getPrototypeOf(e)}catch{return e}if(n!==Object.prototype&&n!==null)return e;let r=t.get(e);if(r!==void 0)return r;let i={};t.set(e,i);for(let[n,r]of Object.entries(e))i[n]=snapshotPlainValue(r,t);return Object.freeze(i)}function normalizeDispatchGroups(e){if(!Array.isArray(e)){let t=e;return{parallel:t.parallel??[],serialAfter:t.serialAfter??[],serialBefore:t.serialBefore??[]}}return{parallel:[],serialAfter:[],serialBefore:e.map((e,t)=>({...e,name:e.name??`provider-${String(t)}`}))}}async function dispatchToProvider(e,t,n,r){let i=t.type.endsWith(`.started`)||t.type===`input.requested`,a=stateOwner(t),o=e.name,s=e.stateNamespace??o;if(isInstrumentationStateAbandoned(s,t.idempotencyKey))return;let c=e.events?.[t.type];if(c===void 0)return;let l=instrumentationStateSlot(s,t.idempotencyKey,a);try{await withTimeout(async()=>{let t=r();await c(e.projectEvent===void 0?t:await e.projectEvent(t),{state:l})},n,()=>{l.revoke(),i&&abandonInstrumentationState(s,t.idempotencyKey,a)})||log.warn(`instrumentation provider timed out`,{boundary:t.type,provider:o,timeoutMs:n})}catch(e){log.warn(`instrumentation provider failed`,{boundary:t.type,error:formatError(e),provider:o})}finally{l.revoke()}}async function withTimeout(e,t,n){let r;try{return await Promise.race([Promise.resolve(e()).then(()=>!0),new Promise(e=>{r=setTimeout(()=>{n(),e(!1)},t)})])}finally{clearTimeout(r)}}function stateOwner(e){return e.type===`channel.delivery.started`||e.type===`channel.delivery.cancelled`||e.type===`channel.delivery.completed`||e.type===`channel.delivery.failed`||e.type===`memory.operation.started`||e.type===`memory.operation.completed`||e.type===`memory.operation.failed`?{sessionId:e.sessionId,turnId:e.turnId}:`scope`in e?e.type.startsWith(`tool.call.`)||e.type.startsWith(`input.`)?{sessionId:e.scope.sessionId,turnId:e.scope.turnId}:e.type.startsWith(`model.call.`)||e.type.startsWith(`step.attempt.`)?{attemptId:e.scope.attemptId}:{}:{}}function releaseTerminalState(e){isTerminal(e.type)&&releaseAllInstrumentationState(e.idempotencyKey),(e.type===`step.attempt.completed`||e.type===`step.attempt.failed`)&&releaseAllInstrumentationAttemptState(e.scope.attemptId),(e.type===`session.completed`||e.type===`session.failed`)&&releaseAllInstrumentationTurnState(e.sessionId),(e.type===`turn.cancelled`||e.type===`turn.failed`)&&releaseAllInstrumentationTurnState(e.sessionId,e.turnId)}function terminalActionFailure(e){return e.type===`session.failed`||e.type===`turn.failed`?{error:e.error,outcome:`failed`}:e.type===`turn.cancelled`?{error:Error(`The action was cancelled with its turn.`),errorCode:`ACTION_CANCELLED`,outcome:`cancelled`}:{error:Error(`The session completed before the action settled.`),errorCode:`ACTION_ABANDONED`,outcome:`abandoned`}}function isTerminal(e){return e.endsWith(`.completed`)||e.endsWith(`.failed`)||e.endsWith(`.cancelled`)||e===`input.resolved`}export{createInstrumentationDispatcher};
+import{createLogger,formatError}from"#internal/logging.js";import{abandonInstrumentationState,instrumentationStateSlot,isInstrumentationStateAbandoned,releaseAllInstrumentationAttemptState,releaseAllInstrumentationState,releaseAllInstrumentationTurnState}from"#instrumentation/state.js";import{resolveTracePolicy}from"#shared/trace-policy.js";import{attemptIdempotencyKey}from"#instrumentation/lifecycle.js";import{withInstrumentationDecision,withoutInstrumentationContent}from"#instrumentation/content.js";import{instrumentationScope,traceStepIndex}from"#instrumentation/scope.js";const log=createLogger(`harness.instrumentation-dispatch`);function createInstrumentationDispatcher(e,t){let n=t.handlerTimeoutMs??5e3,r=normalizeDispatchGroups(e),i=[...r.serialBefore,...r.parallel,...r.serialAfter],a=new Set;function forTrace(e){let t=new WeakMap,o=new Map(i.map(t=>[t,resolveTracePolicy(t.tracePolicy,e,e=>{a.has(t)||(a.add(t),log.warn(`instrumentation provider trace policy failed`,{error:formatError(e),provider:t.name}))})])),s=[...o.values()].some(e=>e.action===`record`&&e.recordInputs),c=[...o.values()].some(e=>e.action===`record`&&e.recordOutputs);return{capturesContent:s||c,capturesInputs:s,capturesOutputs:c,forTrace,publish:async e=>{let i=snapshotInstrumentationEvent(withInstrumentationDecision(e,{action:`record`,recordInputs:s,recordOutputs:c}),t,e),a=new Map,visibleEvent=e=>{let t=o.get(e);if(t===void 0||t.action===`drop`)return withoutInstrumentationContent(i);if(t.recordInputs&&t.recordOutputs)return i;let n=`${String(t.recordInputs)}:${String(t.recordOutputs)}`,r=a.get(n);return r===void 0&&(r=withInstrumentationDecision(i,t),a.set(n,r)),r},admitted=e=>o.get(e)?.action===`record`;try{try{for(let e of r.serialBefore)admitted(e)&&await dispatchToProvider(e,i,n,()=>visibleEvent(e));let e=r.parallel.filter(admitted);if(e.length===1){let t=e[0];await dispatchToProvider(t,i,n,()=>visibleEvent(t))}else if(e.length>1){let t=(await Promise.allSettled(e.map(e=>dispatchToProvider(e,i,n,()=>visibleEvent(e))))).find(e=>e.status===`rejected`);if(t!==void 0)throw t.reason}}finally{for(let e of r.serialAfter)admitted(e)&&await dispatchToProvider(e,i,n,()=>visibleEvent(e))}}finally{releaseTerminalState(i)}}}}let o=!1;return{capturesContent:!1,forTrace,async publish(e){o||(o=!0,log.debug(`instrumentation event published without trace binding`,{eventType:e.type}))}}}function snapshotInstrumentationEvent(e,t,n){let r=t.get(n);if(r!==void 0)return r;let i=snapshotPlainValue(e,t);return`scope`in n&&`scope`in i&&instrumentationScope(i.scope,traceStepIndex(n.scope)),t.set(n,i),i}function snapshotPlainValue(e,t){if(Array.isArray(e)){let n=t.get(e);if(n!==void 0)return n;let r=[];t.set(e,r);for(let n of e)r.push(snapshotPlainValue(n,t));return Object.freeze(r)}if(typeof e!=`object`||!e)return e;let n;try{n=Object.getPrototypeOf(e)}catch{return e}if(n!==Object.prototype&&n!==null)return e;let r=t.get(e);if(r!==void 0)return r;let i={};t.set(e,i);for(let[n,r]of Object.entries(e))i[n]=snapshotPlainValue(r,t);return Object.freeze(i)}function normalizeDispatchGroups(e){if(!Array.isArray(e)){let t=e;return{parallel:t.parallel??[],serialAfter:t.serialAfter??[],serialBefore:t.serialBefore??[]}}return{parallel:[],serialAfter:[],serialBefore:e.map((e,t)=>({...e,name:e.name??`provider-${String(t)}`}))}}async function dispatchToProvider(e,t,n,r){let i=t.type.endsWith(`.started`)||t.type===`delivery.consumed`||t.type===`call.requested`||t.type===`interaction.opened`,a=stateOwner(t),o=e.name,s=e.stateNamespace??o;if(isInstrumentationStateAbandoned(s,t.idempotencyKey))return;let c=e.events?.[t.type];if(c===void 0)return;let l=instrumentationStateSlot(s,t.idempotencyKey,a);try{await withTimeout(async()=>{let t=r();await c(e.projectEvent===void 0?t:await e.projectEvent(t),{state:l})},n,()=>{l.revoke(),i&&abandonInstrumentationState(s,t.idempotencyKey,a)})||log.warn(`instrumentation provider timed out`,{boundary:t.type,provider:o,timeoutMs:n})}catch(e){log.warn(`instrumentation provider failed`,{boundary:t.type,error:formatError(e),provider:o})}finally{l.revoke()}}async function withTimeout(e,t,n){let r;try{return await Promise.race([Promise.resolve(e()).then(()=>!0),new Promise(e=>{r=setTimeout(()=>{n(),e(!1)},t)})])}finally{clearTimeout(r)}}function stateOwner(e){return e.type===`delivery.consumed`||e.type===`delivery.settled`&&e.outcome===`ignored`||e.type===`delivery.settled`&&e.outcome===`handled`||e.type===`delivery.settled`&&e.outcome===`failed`||e.type===`memory.operation.started`||e.type===`memory.operation.settled`&&e.outcome===`completed`||e.type===`memory.operation.settled`&&e.outcome===`failed`?{sessionId:e.sessionId,turnId:e.turnId}:`scope`in e?e.type.startsWith(`call.`)||e.type.startsWith(`interaction.`)?{sessionId:e.scope.sessionId,turnId:e.scope.turnId}:e.type.startsWith(`model.call.`)||e.type.startsWith(`model.`)?{attemptId:attemptIdempotencyKey(e.scope)}:{}:{}}function releaseTerminalState(e){isTerminal(e.type)&&releaseAllInstrumentationState(e.idempotencyKey),(e.type===`model.settled`||e.type===`model.retried`)&&releaseAllInstrumentationAttemptState(attemptIdempotencyKey(e.scope)),e.type===`session.ended`&&releaseAllInstrumentationTurnState(e.sessionId),e.type===`turn.settled`&&e.outcome!==`completed`&&releaseAllInstrumentationTurnState(e.sessionId,e.turnId)}function isTerminal(e){return e.endsWith(`.completed`)||e.endsWith(`.failed`)||e.endsWith(`.cancelled`)||e.endsWith(`.settled`)||e===`session.ended`||e===`model.retried`}export{createInstrumentationDispatcher};