eve 0.83.2 → 0.84.0

package/dist/src/tools/provided/no-reply.d.ts

@@ -10,7 +10,7 @@ export interface NoReplyToolInput {
  * ```ts
  * import { noReply } from "eve/tools/no_reply";
  *
- * export default noReply();
+ * export default noReply;
  * ```
  *
  * A turn that ends with `no_reply` completes without a final message, so
@@ -21,4 +21,4 @@ export interface NoReplyToolInput {
  * This tool records an explicit choice to stay quiet and an optional reason
  * instead of relying on blank model output.
  */
-export declare function noReply(): ToolDefinition<NoReplyToolInput, string>;
+export declare const noReply: ToolDefinition<NoReplyToolInput, string>;

package/dist/src/tools/provided/no-reply.js

@@ -1 +1 @@
-import{frameworkTool}from"./framework-tool.js";import{defineTool}from"#public/tools/index.js";function noReply(){return frameworkTool(defineTool({availableInSubagents:!1,description:`End your turn without sending a reply. Use this when nothing needs to be said, such as when a scheduled check finds nothing to report or an action you already took is the whole answer.`,endsTurn:!0,execute:()=>`No reply was sent.`,inputSchema:{type:`object`,properties:{reason:{type:`string`,description:`Why no reply is needed. Kept in the session history and traces; never sent.`}},additionalProperties:!1}}))}export{noReply};
+import{frameworkTool}from"./framework-tool.js";import{defineTool}from"#public/tools/index.js";const noReply=frameworkTool(defineTool({availableInSubagents:!1,description:`End your turn without sending a reply. Use this when nothing needs to be said, such as when a scheduled check finds nothing to report or an action you already took is the whole answer.`,endsTurn:!0,execute:()=>`No reply was sent.`,inputSchema:{type:`object`,properties:{reason:{type:`string`,description:`Why no reply is needed. Kept in the session history and traces; never sent.`}},additionalProperties:!1}}));export{noReply};

package/dist/src/tools/provided/sleep-workflow.js

@@ -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.83.2//executeSleepTool`;export{executeSleepTool};
+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.84.0//executeSleepTool`;export{executeSleepTool};

package/dist/src/tools/provided/sleep.d.ts

@@ -15,10 +15,10 @@ export declare const SLEEP_INPUT_SCHEMA: import("#tools/schema.js").ToolSchema<S
  * ```ts
  * import { sleep } from "eve/tools/sleep";
  *
- * export default sleep();
+ * export default sleep;
  * ```
  *
  * Each call runs as a durable workflow, so the wait does not hold an
  * application runtime open. A new message ends the wait early.
  */
-export declare function sleep(): WorkflowExecuteToolDefinition<SleepToolInput, SleepToolOutput>;
+export declare const sleep: WorkflowExecuteToolDefinition<SleepToolInput, SleepToolOutput>;

package/dist/src/tools/provided/sleep.js

@@ -1 +1 @@
-import{frameworkTool}from"./framework-tool.js";import{defineJsonSchema}from"#tools/schema.js";import{defineWorkflowTool}from"#public/tools/index.js";import{INTERRUPTED_OUTPUT_SCHEMA,toInterruptibleModelOutput}from"#tools/provided/interrupted.js";import{executeSleepTool}from"#tools/provided/sleep-workflow.js";const SLEEP_INPUT_SCHEMA=defineJsonSchema({type:`object`,properties:{seconds:{type:`number`,exclusiveMinimum:0,maximum:Math.floor((2**53-1)/1e3),description:`How long to wait, in seconds.`}},required:[`seconds`],additionalProperties:!1}),SLEEP_OUTPUT_SCHEMA=defineJsonSchema({oneOf:[{type:`object`,properties:{waitedSeconds:{type:`number`,exclusiveMinimum:0}},required:[`waitedSeconds`],additionalProperties:!1},INTERRUPTED_OUTPUT_SCHEMA]});function sleep(){return frameworkTool(defineWorkflowTool({description:`Wait for a specified amount of time before continuing. Use this when a process or condition needs time to change before it is useful to check its progress or status again.`,execute:executeSleepTool,inputSchema:SLEEP_INPUT_SCHEMA,outputSchema:SLEEP_OUTPUT_SCHEMA,toModelOutput:toInterruptibleModelOutput}))}export{SLEEP_INPUT_SCHEMA,sleep};
+import{frameworkTool}from"./framework-tool.js";import{defineJsonSchema}from"#tools/schema.js";import{defineWorkflowTool}from"#public/tools/index.js";import{INTERRUPTED_OUTPUT_SCHEMA,toInterruptibleModelOutput}from"#tools/provided/interrupted.js";import{executeSleepTool}from"#tools/provided/sleep-workflow.js";const SLEEP_INPUT_SCHEMA=defineJsonSchema({type:`object`,properties:{seconds:{type:`number`,exclusiveMinimum:0,maximum:Math.floor((2**53-1)/1e3),description:`How long to wait, in seconds.`}},required:[`seconds`],additionalProperties:!1}),SLEEP_OUTPUT_SCHEMA=defineJsonSchema({oneOf:[{type:`object`,properties:{waitedSeconds:{type:`number`,exclusiveMinimum:0}},required:[`waitedSeconds`],additionalProperties:!1},INTERRUPTED_OUTPUT_SCHEMA]}),sleep=frameworkTool(defineWorkflowTool({description:`Wait for a specified amount of time before continuing. Use this when a process or condition needs time to change before it is useful to check its progress or status again.`,execute:executeSleepTool,inputSchema:SLEEP_INPUT_SCHEMA,outputSchema:SLEEP_OUTPUT_SCHEMA,toModelOutput:toInterruptibleModelOutput}));export{SLEEP_INPUT_SCHEMA,sleep};

package/dist/src/tools/provided/workflow.js

@@ -1 +1 @@
-import{frameworkTool}from"./framework-tool.js";import{defineJsonSchema}from"#tools/schema.js";import{defineWorkflowTool}from"#tools/workflow-definition.js";import{DEFAULT_WORKFLOW_PROGRAM_MAX_SUBAGENTS,parseWorkflowProgramOptions}from"#execution/dynamic-workflow/schema.js";import{attachWorkflowProgramOptions}from"#tools/workflow-program-input.js";import{runWorkflowProgramTask}from"#execution/dynamic-workflow/tool.js";const workflowProgramAgentContract=`Call ctx.agent(name, { message: string, outputSchema?: object }). Each call starts a new agent that does not see this conversation, so put everything it needs in message. It resolves directly to the agent's reply; when outputSchema is provided, the reply matches that schema. It does not return an agent metadata wrapper. The owning agent resolves the target and applies its existing availability and authorization checks.`,workflowInputSchema=defineJsonSchema({type:`object`,properties:{js:{type:`string`,description:`JavaScript statements executed inside an async function. Supply only the body, without a surrounding function declaration or arrow function. ${workflowProgramAgentContract} Return one JSON-serializable value.`}},required:[`js`],additionalProperties:!1});function workflow(e={}){let t=normalizeWorkflowToolOptions(e),n=[`Run an async JavaScript function body that invokes agents and returns one JSON-serializable value.`,workflowProgramAgentContract,`Supply the body directly, for example: return await ctx.agent("researcher", { message: "Describe the task" });`,`Await every ctx.agent call before returning.`,`The program may invoke at most ${String(t.maxSubagents)} agents.`].join(` `);return attachWorkflowProgramOptions(frameworkTool(defineWorkflowTool({description:n,inputSchema:workflowInputSchema,task:runWorkflowProgramTask})),t)}function normalizeWorkflowToolOptions(e){if(typeof e!=`object`||!e)throw TypeError(`workflow options must be an object.`);return parseWorkflowProgramOptions({maxSubagents:e.maxSubagents??DEFAULT_WORKFLOW_PROGRAM_MAX_SUBAGENTS})}export{workflow};
+import{frameworkTool}from"./framework-tool.js";import{defineJsonSchema}from"#tools/schema.js";import{DEFAULT_WORKFLOW_PROGRAM_MAX_SUBAGENTS,parseWorkflowProgramOptions}from"#execution/dynamic-workflow/schema.js";import{defineWorkflowTool}from"#tools/workflow-definition.js";import{attachWorkflowProgramOptions}from"#tools/workflow-program-input.js";import{runWorkflowProgramTask}from"#execution/dynamic-workflow/tool.js";const workflowProgramAgentContract=`Call ctx.agent(name, { message: string, outputSchema?: object }). Each call starts a new agent that does not see this conversation, so put everything it needs in message. It resolves directly to the agent's reply; when outputSchema is provided, the reply matches that schema. It does not return an agent metadata wrapper. The owning agent resolves the target and applies its existing availability and authorization checks.`,workflowInputSchema=defineJsonSchema({type:`object`,properties:{js:{type:`string`,description:`JavaScript statements executed inside an async function. Supply only the body, without a surrounding function declaration or arrow function. ${workflowProgramAgentContract} Return one JSON-serializable value.`}},required:[`js`],additionalProperties:!1});function workflow(e={}){let t=normalizeWorkflowToolOptions(e),n=[`Run an async JavaScript function body that invokes agents and returns one JSON-serializable value.`,workflowProgramAgentContract,`Supply the body directly, for example: return await ctx.agent("researcher", { message: "Describe the task" });`,`Await every ctx.agent call before returning.`,`The program may invoke at most ${String(t.maxSubagents)} agents.`].join(` `);return attachWorkflowProgramOptions(frameworkTool(defineWorkflowTool({description:n,inputSchema:workflowInputSchema,task:runWorkflowProgramTask})),t)}function normalizeWorkflowToolOptions(e){if(typeof e!=`object`||!e)throw TypeError(`workflow options must be an object.`);return parseWorkflowProgramOptions({maxSubagents:e.maxSubagents??DEFAULT_WORKFLOW_PROGRAM_MAX_SUBAGENTS})}export{workflow};

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

@@ -104,3 +104,5 @@ export declare const UNSPECIFIED_INPUT_SCHEMA: ToolSchema;
  */
 export declare function toModelSchema(schema: FlexibleSchema, direction: SchemaDirection): FlexibleSchema;
 export declare function toModelSchema(schema: FlexibleSchema | undefined, direction: SchemaDirection): FlexibleSchema | undefined;
+/** Yields a subschema, then each local `$ref` target it chains through. */
+export declare function followRefs(root: JsonObject, schema: unknown): Generator<Record<string, unknown>>;

package/dist/src/tools/schema.js

@@ -1 +1 @@
-import{TypeValidationError,asSchema,jsonSchema}from"ai";import{isObject}from"#shared/guards.js";import{toErrorMessage}from"#shared/errors.js";import{parseJsonObject}from"#shared/json.js";import{emitJsonSchema,getStandardSchemaProperties,readJsonSchemaEmitter,serializeOutputSchema}from"#tools/schema-emission.js";import{Validator}from"#compiled/@cfworker/json-schema/index.js";function toInputSchema(e){return toSchema(e,`input`)}function toOutputSchema(e){return toSchema(e,`output`)}function serializeInputSchema(e){return serializeSchema(e,`input`)}function serializeModelInputSchema(e){let t=toSchema(e,`input`);return t==null?t:toModelJsonSchema(t,`input`)}function isToolSchema(e){let t=getStandardSchemaProperties(e);if(t===void 0)return!1;let n=t.jsonSchema;return typeof t.validate==`function`&&typeof n==`object`&&!!n&&typeof n.input==`function`&&typeof n.output==`function`}function defineJsonSchema(e,t){let emit=()=>structuredClone(e),n={"~standard":{version:1,vendor:`eve`,validate:createJsonSchemaValidator(e,t),jsonSchema:{input:emit,output:emit}}};return plainJsonSchemas.add(n),n}const plainJsonSchemas=new WeakSet;function refineJsonSchema(e,t){let n=defineJsonSchema(e),r={"~standard":{...n[`~standard`],validate:async e=>{let r=await n[`~standard`].validate(e);return r.issues===void 0?await t(r.value):r}}};return plainJsonSchemas.add(r),r}function withOptionalStringProperty(e,t){let emit=()=>addOptionalStringProperty(serializeInputSchema(e),t),n={"~standard":{version:1,vendor:`eve`,validate:n=>validateWithProperty(e,t.name,n),jsonSchema:{input:emit,output:emit}}};return plainJsonSchemas.has(e)&&plainJsonSchemas.add(n),n}function addOptionalStringProperty(e,t){let n=isObject(e.properties)?e.properties:{};return{...e,type:e.type??`object`,properties:{...n,[t.name]:{description:t.description,type:`string`}}}}async function validateWithProperty(e,t,n){if(!isObject(n)||!(t in n))return await e[`~standard`].validate(n);let{[t]:r,...i}=n;if(typeof r!=`string`)return{issues:[{message:`Expected "${t}" to be a string.`,path:[t]}]};let a=await e[`~standard`].validate(i);return a.issues!==void 0||!isObject(a.value)?a:{value:{...a.value,[t]:r}}}const UNSPECIFIED_INPUT_SCHEMA=defineJsonSchema({});function toModelSchema(e,t){if(e===void 0||typeof e==`function`||!(`~standard`in e))return e;let n=e;return jsonSchema(()=>toModelJsonSchema(n,t),{validate:async e=>{let t=await n[`~standard`].validate(e);return t.issues===void 0?{success:!0,value:t.value}:{success:!1,error:new TypeValidationError({value:e,cause:t.issues})}}})}function toModelJsonSchema(e,t){let n=serializeSchema(e,t);return plainJsonSchemas.has(e)?n:closeObjectSchemas(n)}function closeObjectSchemas(e){if(!isObject(e))return e;let t={...e},{type:n}=t;(n===`object`||Array.isArray(n)&&n.includes(`object`))&&(t.additionalProperties=isObject(t.additionalProperties)?closeObjectSchemas(t.additionalProperties):!1,isObject(t.properties)&&(t.properties=mapValues(t.properties,closeObjectSchemas))),Array.isArray(t.items)?t.items=t.items.map(closeObjectSchemas):isObject(t.items)&&(t.items=closeObjectSchemas(t.items));for(let e of[`allOf`,`anyOf`,`oneOf`]){let n=t[e];Array.isArray(n)&&(t[e]=n.map(closeObjectSchemas))}return isObject(t.definitions)&&(t.definitions=mapValues(t.definitions,closeObjectSchemas)),t}function mapValues(e,t){return Object.fromEntries(Object.entries(e).map(([e,n])=>[e,t(n)]))}function toSchema(e,t){return e==null||isToolSchema(e)?e:defineJsonSchema(toJsonObject(e,t))}function serializeSchema(e,t){return e==null?e:toJsonObject(e,t)}function toJsonObject(e,t){if(t===`input`&&isLegacyZodSchema(e)){let t=asSchema(e),{$schema:n,...r}=parseJsonObject(t.jsonSchema);return r}return emitJsonSchema(e,t)}function isLegacyZodSchema(e){let t=getStandardSchemaProperties(e);return t!==void 0&&t.vendor===`zod`&&readJsonSchemaEmitter(t,`input`)===void 0}function createJsonSchemaValidator(e,t){let n,r=!1,passThrough=(e,t)=>(r||(r=!0,console.warn(`[eve] Tool schema cannot validate values locally; passing them through unvalidated: ${t}`)),{value:e});return r=>{if(n===void 0){let t=buildValidator(e);if(typeof t==`string`)return n=null,passThrough(r,t);n=t}if(n===null)return{value:r};let i;try{i=n.validate(r)}catch(e){return r===void 0?{issues:[{message:`Expected a JSON value.`}]}:passThrough(r,toErrorMessage(e))}if(!i.valid)return{issues:toIssues(i.errors)};let a=applyDefaults(e,e,r),o=t?.(a);return o===void 0?{value:a}:{issues:[{message:o}]}}}function applyDefaults(e,t,n){let r=n;for(let n of followRefs(e,t)){let{items:t,properties:i}=n;if(isObject(r)&&isObject(i))r=fillProperties(e,i,r);else if(Array.isArray(r)&&isObject(t)){let n=r,i=n.map(n=>applyDefaults(e,t,n));i.some((e,t)=>e!==n[t])&&(r=i)}}return r}function fillProperties(e,t,n){let r=n;for(let[i,a]of Object.entries(t)){let t=Object.hasOwn(n,i)?n[i]:void 0,o=t===void 0?findDefault(e,a):applyDefaults(e,a,t);o!==t&&(r===n&&(r={...n}),r[i]=o)}return r}function findDefault(e,t){for(let n of followRefs(e,t))if(`default`in n)return structuredClone(n.default)}function*followRefs(e,t){let n=new Set,r=t;for(;isObject(r)&&!n.has(r);)n.add(r),yield r,r=resolveLocalRef(e,r.$ref)}function resolveLocalRef(e,t){if(typeof t!=`string`||t!==`#`&&!t.startsWith(`#/`))return;let n=e;for(let e of decodePointer(t)){if(typeof n!=`object`||!n||!Object.hasOwn(n,e))return;n=n[e]}return n}function buildValidator(e){try{let t=structuredClone(e);return prepareForValidation(t)??new Validator(t,`2020-12`,!1)}catch(e){return toErrorMessage(e)}}const JSON_TYPES=new Set([`array`,`boolean`,`integer`,`null`,`number`,`object`,`string`]),EXCLUSIVE_BOUNDS=[[`exclusiveMinimum`,`minimum`],[`exclusiveMaximum`,`maximum`]],SUBSCHEMA_KEYWORDS=[`additionalItems`,`additionalProperties`,`contains`,`else`,`if`,`not`,`propertyNames`,`then`,`unevaluatedItems`,`unevaluatedProperties`],SUBSCHEMA_LIST_KEYWORDS=[`allOf`,`anyOf`,`oneOf`,`prefixItems`],SUBSCHEMA_MAP_KEYWORDS=[`$defs`,`definitions`,`dependencies`,`dependentSchemas`,`patternProperties`,`properties`];function prepareForValidation(e){if(typeof e==`boolean`)return;if(typeof e!=`object`||!e||Array.isArray(e))return`a subschema is neither an object nor a boolean`;let t=e;delete t.format;for(let[e,n]of EXCLUSIVE_BOUNDS)typeof t[e]==`boolean`&&(t[e]&&typeof t[n]==`number`?(t[e]=t[n],delete t[n]):delete t[e]);let{enum:n,pattern:r,required:i,type:a}=t;if(a!==void 0&&!(Array.isArray(a)?a.every(isJsonType):isJsonType(a)))return`unsupported type ${JSON.stringify(a)}`;if(n!==void 0&&!Array.isArray(n))return"`enum` is not an array";if(i!==void 0&&!(Array.isArray(i)&&i.every(e=>typeof e==`string`)))return"`required` is not an array of strings";if(r!==void 0&&!isRegExpSource(r))return`invalid pattern ${JSON.stringify(r)}`;for(let e of SUBSCHEMA_KEYWORDS)if(e in t){let n=prepareForValidation(t[e]);if(n!==void 0)return n}let o=t.items;for(let e of Array.isArray(o)?o:o===void 0?[]:[o]){let t=prepareForValidation(e);if(t!==void 0)return t}for(let e of SUBSCHEMA_LIST_KEYWORDS){let n=t[e];if(n!==void 0){if(!Array.isArray(n))return`\`${e}\` is not an array`;for(let e of n){let t=prepareForValidation(e);if(t!==void 0)return t}}}for(let e of SUBSCHEMA_MAP_KEYWORDS){let n=t[e];if(n!==void 0){if(typeof n!=`object`||!n||Array.isArray(n))return`\`${e}\` is not an object`;for(let[t,r]of Object.entries(n)){if(e===`patternProperties`&&!isRegExpSource(t))return`invalid pattern ${JSON.stringify(t)}`;if(e===`dependencies`&&Array.isArray(r))continue;let n=prepareForValidation(r);if(n!==void 0)return n}}}}function isJsonType(e){return typeof e==`string`&&JSON_TYPES.has(e)}function isRegExpSource(e){if(typeof e!=`string`)return!1;try{return new RegExp(e,`u`),!0}catch{return!1}}const CLOSED_OBJECT_KEYWORD=/\/(?:additional|unevaluated)Properties$/;function toIssues(e){let t=[];for(let n=0;n<e.length;n++){let r=e[n],i=e[n+1];if(CLOSED_OBJECT_KEYWORD.test(r.keywordLocation)&&i?.keyword===`false`){let e=decodePointer(i.instanceLocation).at(-1);t.push({keyword:`false`,location:i.instanceLocation,message:`Unrecognized key: ${JSON.stringify(e)}`,object:r.instanceLocation}),n++}else t.push({keyword:r.keyword,location:r.instanceLocation,message:r.error})}let n=t.filter(e=>e.object===void 0||!t.some(t=>t.object===void 0&&(t.location===e.location||t.location.startsWith(`${e.location}/`))));return n.filter((e,t)=>{let r=n[t+1];return r===void 0?!0:r.location.startsWith(`${e.location}/`)?!1:e.keyword!==`$ref`||r.location!==e.location}).map(({location:e,message:t,object:n})=>{let r=decodePointer(n??e);return r.length===0?{message:t}:{message:t,path:r}})}function decodePointer(e){return e.split(`/`).slice(1).map(e=>{let t=e;try{t=decodeURIComponent(e)}catch{}return t.replaceAll(`~1`,`/`).replaceAll(`~0`,`~`)})}export{UNSPECIFIED_INPUT_SCHEMA,defineJsonSchema,isToolSchema,refineJsonSchema,serializeInputSchema,serializeModelInputSchema,serializeOutputSchema,toInputSchema,toModelSchema,toOutputSchema,withOptionalStringProperty};
+import{TypeValidationError,asSchema,jsonSchema}from"ai";import{isObject}from"#shared/guards.js";import{toErrorMessage}from"#shared/errors.js";import{parseJsonObject}from"#shared/json.js";import{emitJsonSchema,getStandardSchemaProperties,readJsonSchemaEmitter,serializeOutputSchema}from"#tools/schema-emission.js";import{Validator}from"#compiled/@cfworker/json-schema/index.js";function toInputSchema(e){return toSchema(e,`input`)}function toOutputSchema(e){return toSchema(e,`output`)}function serializeInputSchema(e){return serializeSchema(e,`input`)}function serializeModelInputSchema(e){let t=toSchema(e,`input`);return t==null?t:toModelJsonSchema(t,`input`)}function isToolSchema(e){let t=getStandardSchemaProperties(e);if(t===void 0)return!1;let n=t.jsonSchema;return typeof t.validate==`function`&&typeof n==`object`&&!!n&&typeof n.input==`function`&&typeof n.output==`function`}function defineJsonSchema(e,t){let emit=()=>structuredClone(e),n={"~standard":{version:1,vendor:`eve`,validate:createJsonSchemaValidator(e,t),jsonSchema:{input:emit,output:emit}}};return plainJsonSchemas.add(n),n}const plainJsonSchemas=new WeakSet;function refineJsonSchema(e,t){let n=defineJsonSchema(e),r={"~standard":{...n[`~standard`],validate:async e=>{let r=await n[`~standard`].validate(e);return r.issues===void 0?await t(r.value):r}}};return plainJsonSchemas.add(r),r}function withOptionalStringProperty(e,t){let emit=()=>addOptionalStringProperty(serializeInputSchema(e),t),n={"~standard":{version:1,vendor:`eve`,validate:n=>validateWithProperty(e,t.name,n),jsonSchema:{input:emit,output:emit}}};return plainJsonSchemas.has(e)&&plainJsonSchemas.add(n),n}function addOptionalStringProperty(e,t){let n=isObject(e.properties)?e.properties:{};return{...e,type:e.type??`object`,properties:{...n,[t.name]:{description:t.description,type:`string`}}}}async function validateWithProperty(e,t,n){if(!isObject(n)||!(t in n))return await e[`~standard`].validate(n);let{[t]:r,...i}=n;if(typeof r!=`string`)return{issues:[{message:`Expected "${t}" to be a string.`,path:[t]}]};let a=await e[`~standard`].validate(i);return a.issues!==void 0||!isObject(a.value)?a:{value:{...a.value,[t]:r}}}const UNSPECIFIED_INPUT_SCHEMA=defineJsonSchema({});function toModelSchema(e,t){if(e===void 0||typeof e==`function`||!(`~standard`in e))return e;let n=e;return jsonSchema(()=>toModelJsonSchema(n,t),{validate:async e=>{let t=await n[`~standard`].validate(e);return t.issues===void 0?{success:!0,value:t.value}:{success:!1,error:new TypeValidationError({value:e,cause:t.issues})}}})}function toModelJsonSchema(e,t){let n=serializeSchema(e,t);return plainJsonSchemas.has(e)?n:closeObjectSchemas(n)}function closeObjectSchemas(e){if(!isObject(e))return e;let t={...e},{type:n}=t;(n===`object`||Array.isArray(n)&&n.includes(`object`))&&(t.additionalProperties=isObject(t.additionalProperties)?closeObjectSchemas(t.additionalProperties):!1,isObject(t.properties)&&(t.properties=mapValues(t.properties,closeObjectSchemas))),Array.isArray(t.items)?t.items=t.items.map(closeObjectSchemas):isObject(t.items)&&(t.items=closeObjectSchemas(t.items));for(let e of[`allOf`,`anyOf`,`oneOf`]){let n=t[e];Array.isArray(n)&&(t[e]=n.map(closeObjectSchemas))}return isObject(t.definitions)&&(t.definitions=mapValues(t.definitions,closeObjectSchemas)),t}function mapValues(e,t){return Object.fromEntries(Object.entries(e).map(([e,n])=>[e,t(n)]))}function toSchema(e,t){return e==null||isToolSchema(e)?e:defineJsonSchema(toJsonObject(e,t))}function serializeSchema(e,t){return e==null?e:toJsonObject(e,t)}function toJsonObject(e,t){if(t===`input`&&isLegacyZodSchema(e)){let t=asSchema(e),{$schema:n,...r}=parseJsonObject(t.jsonSchema);return r}return emitJsonSchema(e,t)}function isLegacyZodSchema(e){let t=getStandardSchemaProperties(e);return t!==void 0&&t.vendor===`zod`&&readJsonSchemaEmitter(t,`input`)===void 0}function createJsonSchemaValidator(e,t){let n,r=!1,passThrough=(e,t)=>(r||(r=!0,console.warn(`[eve] Tool schema cannot validate values locally; passing them through unvalidated: ${t}`)),{value:e});return r=>{if(n===void 0){let t=buildValidator(e);if(typeof t==`string`)return n=null,passThrough(r,t);n=t}if(n===null)return{value:r};let i;try{i=n.validate(r)}catch(e){return r===void 0?{issues:[{message:`Expected a JSON value.`}]}:passThrough(r,toErrorMessage(e))}if(!i.valid)return{issues:toIssues(i.errors)};let a=applyDefaults(e,e,r),o=t?.(a);return o===void 0?{value:a}:{issues:[{message:o}]}}}function applyDefaults(e,t,n){let r=n;for(let n of followRefs(e,t)){let{items:t,properties:i}=n;if(isObject(r)&&isObject(i))r=fillProperties(e,i,r);else if(Array.isArray(r)&&isObject(t)){let n=r,i=n.map(n=>applyDefaults(e,t,n));i.some((e,t)=>e!==n[t])&&(r=i)}}return r}function fillProperties(e,t,n){let r=n;for(let[i,a]of Object.entries(t)){let t=Object.hasOwn(n,i)?n[i]:void 0,o=t===void 0?findDefault(e,a):applyDefaults(e,a,t);o!==t&&(r===n&&(r={...n}),r[i]=o)}return r}function findDefault(e,t){for(let n of followRefs(e,t))if(`default`in n)return structuredClone(n.default)}function*followRefs(e,t){let n=new Set,r=t;for(;isObject(r)&&!n.has(r);)n.add(r),yield r,r=resolveLocalRef(e,r.$ref)}function resolveLocalRef(e,t){if(typeof t!=`string`||t!==`#`&&!t.startsWith(`#/`))return;let n=e;for(let e of decodePointer(t)){if(typeof n!=`object`||!n||!Object.hasOwn(n,e))return;n=n[e]}return n}function buildValidator(e){try{let t=structuredClone(e);return prepareForValidation(t)??new Validator(t,`2020-12`,!1)}catch(e){return toErrorMessage(e)}}const JSON_TYPES=new Set([`array`,`boolean`,`integer`,`null`,`number`,`object`,`string`]),EXCLUSIVE_BOUNDS=[[`exclusiveMinimum`,`minimum`],[`exclusiveMaximum`,`maximum`]],SUBSCHEMA_KEYWORDS=[`additionalItems`,`additionalProperties`,`contains`,`else`,`if`,`not`,`propertyNames`,`then`,`unevaluatedItems`,`unevaluatedProperties`],SUBSCHEMA_LIST_KEYWORDS=[`allOf`,`anyOf`,`oneOf`,`prefixItems`],SUBSCHEMA_MAP_KEYWORDS=[`$defs`,`definitions`,`dependencies`,`dependentSchemas`,`patternProperties`,`properties`];function prepareForValidation(e){if(typeof e==`boolean`)return;if(typeof e!=`object`||!e||Array.isArray(e))return`a subschema is neither an object nor a boolean`;let t=e;delete t.format;for(let[e,n]of EXCLUSIVE_BOUNDS)typeof t[e]==`boolean`&&(t[e]&&typeof t[n]==`number`?(t[e]=t[n],delete t[n]):delete t[e]);let{enum:n,pattern:r,required:i,type:a}=t;if(a!==void 0&&!(Array.isArray(a)?a.every(isJsonType):isJsonType(a)))return`unsupported type ${JSON.stringify(a)}`;if(n!==void 0&&!Array.isArray(n))return"`enum` is not an array";if(i!==void 0&&!(Array.isArray(i)&&i.every(e=>typeof e==`string`)))return"`required` is not an array of strings";if(r!==void 0&&!isRegExpSource(r))return`invalid pattern ${JSON.stringify(r)}`;for(let e of SUBSCHEMA_KEYWORDS)if(e in t){let n=prepareForValidation(t[e]);if(n!==void 0)return n}let o=t.items;for(let e of Array.isArray(o)?o:o===void 0?[]:[o]){let t=prepareForValidation(e);if(t!==void 0)return t}for(let e of SUBSCHEMA_LIST_KEYWORDS){let n=t[e];if(n!==void 0){if(!Array.isArray(n))return`\`${e}\` is not an array`;for(let e of n){let t=prepareForValidation(e);if(t!==void 0)return t}}}for(let e of SUBSCHEMA_MAP_KEYWORDS){let n=t[e];if(n!==void 0){if(typeof n!=`object`||!n||Array.isArray(n))return`\`${e}\` is not an object`;for(let[t,r]of Object.entries(n)){if(e===`patternProperties`&&!isRegExpSource(t))return`invalid pattern ${JSON.stringify(t)}`;if(e===`dependencies`&&Array.isArray(r))continue;let n=prepareForValidation(r);if(n!==void 0)return n}}}}function isJsonType(e){return typeof e==`string`&&JSON_TYPES.has(e)}function isRegExpSource(e){if(typeof e!=`string`)return!1;try{return new RegExp(e,`u`),!0}catch{return!1}}const CLOSED_OBJECT_KEYWORD=/\/(?:additional|unevaluated)Properties$/;function toIssues(e){let t=[];for(let n=0;n<e.length;n++){let r=e[n],i=e[n+1];if(CLOSED_OBJECT_KEYWORD.test(r.keywordLocation)&&i?.keyword===`false`){let e=decodePointer(i.instanceLocation).at(-1);t.push({keyword:`false`,location:i.instanceLocation,message:`Unrecognized key: ${JSON.stringify(e)}`,object:r.instanceLocation}),n++}else t.push({keyword:r.keyword,location:r.instanceLocation,message:r.error})}let n=t.filter(e=>e.object===void 0||!t.some(t=>t.object===void 0&&(t.location===e.location||t.location.startsWith(`${e.location}/`))));return n.filter((e,t)=>{let r=n[t+1];return r===void 0?!0:r.location.startsWith(`${e.location}/`)?!1:e.keyword!==`$ref`||r.location!==e.location}).map(({location:e,message:t,object:n})=>{let r=decodePointer(n??e);return r.length===0?{message:t}:{message:t,path:r}})}function decodePointer(e){return e.split(`/`).slice(1).map(e=>{let t=e;try{t=decodeURIComponent(e)}catch{}return t.replaceAll(`~1`,`/`).replaceAll(`~0`,`~`)})}export{UNSPECIFIED_INPUT_SCHEMA,defineJsonSchema,followRefs,isToolSchema,refineJsonSchema,serializeInputSchema,serializeModelInputSchema,serializeOutputSchema,toInputSchema,toModelSchema,toOutputSchema,withOptionalStringProperty};

package/dist/src/tools/signature.js

@@ -1 +1 @@
-import{isObject}from"#shared/guards.js";const MAX_SIGNATURE_LENGTH=4e3,CONSTRAINT_KEYS=[`format`,`pattern`,`minimum`,`maximum`,`exclusiveMinimum`,`exclusiveMaximum`,`minLength`,`maxLength`,`minItems`,`maxItems`,`default`],IDENTIFIER=/^[A-Za-z_$][\w$]*$/u;function renderToolSignature(e){let t=renderSignature(e,!0);if(t.length<=MAX_SIGNATURE_LENGTH)return t;let n=renderSignature(e,!1);return n.length>MAX_SIGNATURE_LENGTH?`${n.slice(0,3997)}...`:n}function renderSignature(e,t){let render=e=>renderType(e,{budget:{remaining:1e3},depth:0,descriptions:t,refs:new Set,root:e}),n=e.inputSchema===void 0?`{}`:render(e.inputSchema),r=e.outputSchema===void 0?`unknown`:render(e.outputSchema);return`${e.name}(input: ${n}): Promise<${r}>`}function renderType(e,t){if(e===!0||!isObject(e)||t.depth>6||t.budget.remaining<=0)return`unknown`;if(--t.budget.remaining,typeof e.$ref==`string`){let n=resolveRef(e.$ref,t);return n===void 0?`unknown`:renderType(n,{...t,refs:new Set([...t.refs,e.$ref])})}if(`const`in e)return literal(e.const);if(Array.isArray(e.enum))return union(e.enum.map(literal));let n=Array.isArray(e.anyOf)?e.anyOf:Array.isArray(e.oneOf)?e.oneOf:void 0;if(n!==void 0)return union(n.map(e=>renderType(e,next(t))));if(Array.isArray(e.allOf))return e.allOf.map(e=>wrap(renderType(e,next(t)))).join(` & `);let r=(Array.isArray(e.type)?e.type:[e.type]).filter(e=>typeof e==`string`).map(n=>renderPrimitive(n,e,t));return r.length>0?union(r):isObject(e.properties)||e.additionalProperties!==void 0?renderObject(e,t):e.items===void 0?`unknown`:renderPrimitive(`array`,e,t)}function renderPrimitive(e,t,n){switch(e){case`string`:return`string`;case`number`:case`integer`:return`number`;case`boolean`:return`boolean`;case`null`:return`null`;case`array`:return`${wrap(renderType(t.items,next(n)))}[]`;case`object`:return renderObject(t,n);default:return`unknown`}}function renderObject(e,t){let n=isObject(e.properties)?e.properties:{},r=new Set(Array.isArray(e.required)?e.required.filter(e=>typeof e==`string`):[]),i=Object.entries(n).map(([e,n])=>{let i=IDENTIFIER.test(e)?e:JSON.stringify(e),a=r.has(e)?``:`?`,o=isObject(n)?propertyComment(n,t.descriptions):``;return`${i}${a}: ${renderType(n,next(t))}${o}`}),a=e.additionalProperties;return isObject(a)&&i.push(`[key: string]: ${renderType(a,next(t))}`),i.length===0?a===!1?`{}`:`Record<string, unknown>`:`{ ${i.join(`; `)} }`}function propertyComment(e,t){let n=[],r=t&&typeof e.description==`string`?e.description.replaceAll(/\s+/gu,` `).replace(/[\s.;,:]+$/u,``).trim():``;r.length>0&&n.push(truncate(r));for(let t of CONSTRAINT_KEYS)e[t]!==void 0&&n.push(`${t}: ${JSON.stringify(e[t])}`);return n.length===0?``:` /* ${n.join(`; `).replaceAll(`*/`,`* /`)} */`}function resolveRef(e,t){if(t.refs.has(e)||!e.startsWith(`#`))return;let n=t.root;for(let t of e.slice(1).split(`/`).filter(Boolean)){if(!isObject(n))return;n=n[t.replaceAll(`~1`,`/`).replaceAll(`~0`,`~`)]}return n}function next(e){return{...e,depth:e.depth+1}}function literal(e){return e===void 0?`undefined`:JSON.stringify(e)}function union(e){let t=[...new Set(e)];return t.length===0?`never`:t.join(` | `)}function wrap(e){return e.includes(` | `)||e.includes(` & `)?`(${e})`:e}function truncate(e){return e.length>120?`${e.slice(0,117)}...`:e}export{renderToolSignature};
+import{isObject}from"#shared/guards.js";const MAX_SIGNATURE_LENGTH=4e3,CONSTRAINT_KEYS=[`format`,`pattern`,`minimum`,`maximum`,`exclusiveMinimum`,`exclusiveMaximum`,`minLength`,`maxLength`,`minItems`,`maxItems`,`default`],IDENTIFIER=/^[A-Za-z_$][\w$]*$/u;function renderToolSignature(e){let t=renderSignature(e,!0);if(t.length<=MAX_SIGNATURE_LENGTH)return t;let n=renderSignature(e,!1);return n.length>MAX_SIGNATURE_LENGTH?`${n.slice(0,3997)}...`:n}function renderSignature(e,t){let render=e=>renderType(e,{budget:{remaining:1e3},depth:0,descriptions:t,refs:new Set,root:e}),n=e.inputSchema===void 0?`{}`:render(e.inputSchema),r=e.outputSchema===void 0?`unknown`:render(e.outputSchema);return`${e.name}(input: ${n}): Promise<${r}>`}function renderType(e,t){if(e===!0||!isObject(e)||t.depth>6||t.budget.remaining<=0)return`unknown`;if(--t.budget.remaining,typeof e.$ref==`string`){let n=resolveRef(e.$ref,t);return n===void 0?`unknown`:renderType(n,{...t,refs:new Set([...t.refs,e.$ref])})}if(`const`in e)return literal(e.const);if(Array.isArray(e.enum))return union(e.enum.map(literal));let n=Array.isArray(e.anyOf)?e.anyOf:Array.isArray(e.oneOf)?e.oneOf:void 0;if(n!==void 0)return union(n.map(e=>renderType(e,next(t))));if(Array.isArray(e.allOf))return e.allOf.map(e=>wrap(renderType(e,next(t)))).join(` & `);let r=(Array.isArray(e.type)?e.type:[e.type]).filter(e=>typeof e==`string`).map(n=>renderPrimitive(n,e,t));return r.length>0?union(r):isObject(e.properties)||e.additionalProperties!==void 0?renderObject(e,t):e.items===void 0?`unknown`:renderPrimitive(`array`,e,t)}function renderPrimitive(e,t,n){switch(e){case`string`:return`string`;case`number`:case`integer`:return`number`;case`boolean`:return`boolean`;case`null`:return`null`;case`array`:return`${wrap(renderType(t.items,next(n)))}[]`;case`object`:return renderObject(t,n);default:return`unknown`}}function renderObject(e,t){let n=isObject(e.properties)?e.properties:{},r=new Set(Array.isArray(e.required)?e.required.filter(e=>typeof e==`string`):[]),i=Object.entries(n).map(([e,n])=>{let i=IDENTIFIER.test(e)?e:JSON.stringify(e),a=r.has(e)?``:`?`,o=isObject(n)?propertyComment(n,t):``;return`${i}${a}: ${renderType(n,next(t))}${o}`}),a=e.additionalProperties;return isObject(a)&&i.push(`[key: string]: ${renderType(a,next(t))}`),i.length===0?a===!1?`{}`:`Record<string, unknown>`:`{ ${i.join(`; `)} }`}function propertyComment(e,t){let n=describedSchema(e,t),r=[],i=t.descriptions&&typeof n.description==`string`?n.description.replaceAll(/\s+/gu,` `).replace(/[\s.;,:]+$/u,``).trim():``;i.length>0&&r.push(truncate(i));for(let e of CONSTRAINT_KEYS)n[e]!==void 0&&r.push(`${e}: ${JSON.stringify(n[e])}`);return r.length===0?``:` /* ${r.join(`; `).replaceAll(`*/`,`* /`)} */`}function describedSchema(e,t){let n=e,r=new Set(t.refs);for(let e=n.$ref;typeof e==`string`&&!r.has(e);e=n.$ref){r.add(e);let i=resolveRef(e,t);if(!isObject(i))break;let{$ref:a,...o}=n;n={...i,...o}}return n}function resolveRef(e,t){if(t.refs.has(e)||!e.startsWith(`#`))return;let n=t.root;for(let t of e.slice(1).split(`/`).filter(Boolean)){if(!isObject(n))return;n=n[t.replaceAll(`~1`,`/`).replaceAll(`~0`,`~`)]}return n}function next(e){return{...e,depth:e.depth+1}}function literal(e){return e===void 0?`undefined`:JSON.stringify(e)}function union(e){let t=[...new Set(e)];return t.length===0?`never`:t.join(` | `)}function wrap(e){return e.includes(` | `)||e.includes(` & `)?`(${e})`:e}function truncate(e){return e.length>120?`${e.slice(0,117)}...`:e}export{renderToolSignature};

package/dist/src/tools/workflow-definition.d.ts

@@ -1,9 +1,10 @@
+import type { MessageContent } from "#shared/message-content.js";
 import type { StandardJSONSchemaV1, StandardSchemaV1 } from "#compiled/@standard-schema/spec/index.js";
-import type { ToolApproval } from "#approval/definition.js";
-import type { MessageResult, SendTurnOptions } from "#client/types.js";
+import type { Approval } from "#approval/definition.js";
+import type { DeliveryResult, SendTurnOptions } from "#client/types.js";
 import type { AgentModelOptionsDefinition, AgentReasoningDefinition } from "#shared/agent-definition.js";
 import type { JsonObject } from "#shared/json.js";
-import { type PublicToolDefinition, type ToolContext, type ToolInputRequest, type ToolInputRequestOptions, type ToolInputResponse } from "#tools/definition.js";
+import { type PublicToolDefinition, type ToolContext, type ToolQuestion, type ToolAskOptions, type ToolAnswer } from "#tools/definition.js";
 import type { ToolModelOutput } from "#tools/model-output.js";
 import { type WorkflowToolEntryPoint } from "#tools/workflow-entry-point.js";
 export type { WorkflowToolEntryPoint };
@@ -43,18 +44,19 @@ export interface AgentSendOptions<TOutput = unknown> {
     readonly signal?: AbortSignal;
 }
 /**
- * How one agent turn ended, as the client's `MessageResult` reports it:
- * `"waiting"` when the session waits for its next message, including after a
- * cancelled turn, which carries neither `data` nor `message`; `"completed"`
- * when the session ended with the turn; and `"failed"` when the turn failed,
- * with the reason in `error`.
+ * How one delegated turn ended. Questions relay to the parent while this result waits for the
+ * final reply; session termination is separate from request completion.
  */
-export type AgentMessageResult<TOutput = unknown> = Pick<MessageResult<TOutput>, "data" | "message" | "status"> & {
-    /** Why the turn failed, present only when `status` is `"failed"`. */
-    readonly error?: {
+export type AgentMessageResult<TOutput = unknown> = Pick<DeliveryResult<TOutput>, "data" | "reply" | "sessionEnded"> & ({
+    readonly status: "completed" | "cancelled";
+    readonly error?: never;
+} | {
+    readonly status: "failed";
+    /** Why the turn failed. */
+    readonly error: {
         readonly message: string;
     };
-};
+});
 /** The response to one message sent to a `ctx.agent` session. */
 export interface AgentResponse<TOutput = unknown> {
     /** Resolves when the turn the message started or joined ends. */
@@ -70,7 +72,7 @@ export interface AgentSession {
      * response resolves, or starts the next turn when the session is idle or the
      * running turn ends before the agent reads it.
      */
-    send<TOutput = unknown>(message: string, options?: AgentSendOptions<TOutput>): Promise<AgentResponse<TOutput>>;
+    send<TOutput = unknown>(message: MessageContent<string | URL>, options?: AgentSendOptions<TOutput>): Promise<AgentResponse<TOutput>>;
 }
 /**
  * Members the context of every workflow tool entry point shares.
@@ -90,7 +92,7 @@ export type WorkflowSharedContext = Pick<ToolContext, "session" | "toolName" | "
      * run. The request is withdrawn, resolving as `cancelled`, when
      * `options.signal` or the call's `abortSignal` aborts.
      */
-    ask(request: ToolInputRequest, options?: ToolInputRequestOptions): PromiseLike<ToolInputResponse>;
+    ask(request: ToolQuestion, options?: ToolAskOptions): PromiseLike<ToolAnswer>;
 };
 /**
  * Context of an `execute(input, ctx)` or `task(input, ctx)` call. When passed
@@ -156,7 +158,7 @@ export type WorkflowServeContext<TOutput = unknown> = WorkflowSharedContext & {
 declare const WORKFLOW_TOOL_BRAND: unique symbol;
 interface WorkflowToolDefinitionBase<TInput, TOutput> extends PublicToolDefinition<TInput, TOutput> {
     readonly [WORKFLOW_TOOL_BRAND]: true;
-    approval?: ToolApproval<unknown extends TInput ? Record<string, unknown> : TInput>;
+    approval?: Approval<unknown extends TInput ? Record<string, unknown> : TInput>;
     toModelOutput?: (output: TOutput) => ToolModelOutput | Promise<ToolModelOutput>;
 }
 /** A workflow tool whose calls are ordinary tool calls: the turn waits until each settles. */

package/dist/src/tracing/eve/agent-approval-instrumentation.d.ts

@@ -5,4 +5,4 @@ import type { AgentRun } from "#compiled/@vercel/agent-runs/index.js";
 export declare function createAgentApprovalInstrumentation(input: {
     readonly tracing: AgentRun;
     readonly actionStateFor: (sessionId: string, turnId: string, callId: string) => Promise<AgentActionTraceState | undefined>;
-}): Pick<NonNullable<InstrumentationProviderDefinition["events"]>, "input.requested" | "input.resolved">;
+}): Pick<NonNullable<InstrumentationProviderDefinition["events"]>, "interaction.opened" | "interaction.settled">;

package/dist/src/tracing/eve/agent-approval-instrumentation.js

@@ -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){e.kind===`tool-approval`&&t.state.get()===void 0&&await(await toolFor(e.scope.sessionId,e.scope.turnId,e.action.callId))?.approval({requestId:e.requestId,request:e.request})!==void 0&&t.state.set({callId:e.action.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))?.findApproval(e.requestId);o!==void 0&&(e.outcome===`failed`?await o.fail(e.error):await o.complete({outcome:e.outcome,response:e.response}))}return{"input.requested":onRequested,"input.resolved":onResolved}}export{createAgentApprovalInstrumentation};
+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))?.findApproval(e.interactionId);o!==void 0&&(e.outcome===`failed`?await o.fail(e.error):await o.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};

package/dist/src/tracing/eve/agent-channel-delivery-instrumentation.d.ts

@@ -1,7 +1,7 @@
 import type { InstrumentationProviderDefinition } from "#instrumentation/lifecycle.js";
 import type { AgentTraceStateStore } from "#tracing/eve/agent-trace-state.js";
-/** Captures one-to-one channel delivery metadata on the activation that consumes it. */
+/** Attribute a turn only when exactly one message delivery was consumed, across workers. */
 export declare function createAgentChannelDeliveryInstrumentation(input: {
     readonly recordInputs: boolean;
     readonly stateStore: AgentTraceStateStore;
-}): Pick<NonNullable<InstrumentationProviderDefinition["events"]>, "channel.delivery.cancelled" | "channel.delivery.completed" | "channel.delivery.failed" | "channel.delivery.started">;
+}): Pick<NonNullable<InstrumentationProviderDefinition["events"]>, "delivery.consumed">;

package/dist/src/tracing/eve/agent-channel-delivery-instrumentation.js

@@ -1 +1 @@
-import{contextStorage}from"#context/container.js";import{ActiveChannelDeliveriesKey}from"#context/keys.js";import{isSampledTrace}from"#shared/trace-policy.js";import{contentAttribute}from"#compiled/@vercel/agent-runs/otel.js";function createAgentChannelDeliveryInstrumentation(e){let onStarted=async(t,n)=>{let r=await e.stateStore.get(`session`,t.sessionId),i=(t.turnId===void 0||t.sequence===void 0?void 0:await e.stateStore.get(`turn`,JSON.stringify([t.sessionId,t.turnId])))?.context??r?.context;if(i===void 0||!isSampledTrace(i))return;let a=e.recordInputs?contentAttribute(t.input):void 0,o={};a!==void 0&&(o.inputAttribute=a),t.delivery.requestTraceContext!==void 0&&(o.requestTraceContext={spanId:t.delivery.requestTraceContext.spanId,traceFlags:t.delivery.requestTraceContext.traceFlags,traceId:t.delivery.requestTraceContext.traceId}),n.state.set(o)},onTerminal=async(t,n)=>{let r=readState(n.state.get());if(r===void 0||t.turnId===void 0)return;let i=await e.stateStore.get(`turn`,JSON.stringify([t.sessionId,t.turnId]));i!==void 0&&isSampledTrace(i.context)&&isOnlyActiveDelivery(t.sessionId,t.turnId,t.delivery.deliveryId)&&await e.stateStore.update(`turn`,JSON.stringify([t.sessionId,t.turnId]),e=>({...e,channelDelivery:{channelKind:t.delivery.channelKind,channelName:t.delivery.channelName,deliveryId:t.delivery.deliveryId,...r.inputAttribute===void 0?void 0:{inputAttribute:r.inputAttribute},...t.delivery.requestId===void 0?void 0:{requestId:t.delivery.requestId},...r.requestTraceContext===void 0?void 0:{requestTraceContext:r.requestTraceContext}}}))};return{"channel.delivery.cancelled":onTerminal,"channel.delivery.completed":onTerminal,"channel.delivery.failed":onTerminal,"channel.delivery.started":onStarted}}function isOnlyActiveDelivery(e,t,n){let r=contextStorage.getStore()?.get(ActiveChannelDeliveriesKey),i=r?.[0];return r?.length===1&&i?.sessionId===e&&i.turnId===t&&i.delivery.deliveryId===n}function readState(e){if(!isRecord(e))return;let t=isSpanContext(e.requestTraceContext)?e.requestTraceContext:void 0;return{inputAttribute:typeof e.inputAttribute==`string`?e.inputAttribute:void 0,requestTraceContext:t}}function isSpanContext(e){return isRecord(e)&&typeof e.spanId==`string`&&typeof e.traceFlags==`number`&&typeof e.traceId==`string`}function isRecord(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}export{createAgentChannelDeliveryInstrumentation};
+import{contextStorage}from"#context/container.js";import{enteredView}from"#harness/session-machine/current.js";import{isSampledTrace}from"#shared/trace-policy.js";import{contentAttribute}from"#compiled/@vercel/agent-runs/otel.js";function createAgentChannelDeliveryInstrumentation(e){return{async"delivery.consumed"(t){if(t.turnId===void 0)return;let n=contextStorage.getStore();(n===void 0||enteredView(n)?.deliveries[t.deliveryId]?.parts?.length!==0)&&await e.stateStore.update(`turn`,JSON.stringify([t.sessionId,t.turnId]),n=>!isSampledTrace(n.context)||n.consumedDeliveryId===null?n:n.consumedDeliveryId!==void 0&&n.consumedDeliveryId!==t.deliveryId?{...n,channelDelivery:void 0,consumedDeliveryId:null}:{...n,consumedDeliveryId:t.deliveryId,channelDelivery:t.delivery===void 0?void 0:{...t.delivery,inputAttribute:e.recordInputs?contentAttribute(t.input):void 0}})}}}export{createAgentChannelDeliveryInstrumentation};

package/dist/src/tracing/eve/agent-invocation-coordinator.d.ts

@@ -1,10 +1,10 @@
-import type { SessionTraceContext } from "#channel/types.js";
+import type { SessionTraceSeed } from "#channel/types.js";
 import type { ChannelAudience } from "#shared/channel-audience.js";
 import type { ConversationContext } from "#shared/conversation-context.js";
 export interface AgentChildTraceDispatch {
     readonly conversationId?: string;
     readonly originAudience: ChannelAudience;
-    readonly parentTraceContext?: SessionTraceContext;
+    readonly parentTraceContext?: SessionTraceSeed;
 }
 /**
  * The trace dispatch for sessions opened with `ctx.agent` while a run serves

package/dist/src/tracing/eve/agent-otel-provider.js

@@ -1 +1 @@
-import{isObject}from"#shared/guards.js";import{isUserMessageKind}from"#harness/messages.js";import{resolveInstrumentationEnvironment}from"#internal/application/dev-environment.js";import{isSampledTrace}from"#shared/trace-policy.js";import{ROOT_CONTEXT,context,trace}from"#compiled/@opentelemetry/api/index.js";import{gatewayCostAttributes,gatewayRoutingAttributes,readGatewayCostData}from"#tracing/eve/gateway.js";import{createAgentToolInstrumentation}from"#tracing/eve/agent-tool-instrumentation.js";import{withChannelAudience}from"#tracing/eve/channel-audience-context.js";import{createEveTracing}from"#tracing/eve/operation-input.js";import{createAgentApprovalInstrumentation}from"#tracing/eve/agent-approval-instrumentation.js";import{createAgentChannelDeliveryInstrumentation}from"#tracing/eve/agent-channel-delivery-instrumentation.js";import{eveActivationMetadata}from"#tracing/eve/metadata.js";import{createAgentMemoryInstrumentation}from"#tracing/eve/agent-memory-instrumentation.js";import{createEveSessionTracing}from"#tracing/eve/session.js";import{createEveCapturePolicy}from"#tracing/eve/policy.js";function createAgentOtelInstrumentation(e){let t=e.environment??resolveInstrumentationEnvironment(),n=e.recordInputs??!1,r=e.recordOutputs??!1,i=createEveTracing(e),a=createEveCapturePolicy({stateStore:e.stateStore,environment:t,recordInputs:n,recordOutputs:r}),o=new Map,s=new Map,c=createEveSessionTracing({...e,environment:t,tracing:i,capturePolicy:a}),{prepareSessionTrace:l,prepareTurnTrace:u}=c;async function attemptFor(e){let t=o.get(e.attemptId);if(t!==void 0)return t;let n=await c.turnFor(e.sessionId,e.turnId,withChannelAudience(ROOT_CONTEXT,e.channelAudience)),r={stepIndex:e.stepIndex,attempt:e.attemptIndex};return n?.findAttempt(r)??(n?.finished===!1?n.attempt(r):void 0)}let d=createAgentToolInstrumentation({tracing:i,attemptFor,stepFor:e=>o.get(e.attemptId),recordInputs:n,recordOutputs:r,stateStore:e.stateStore}),f=createAgentApprovalInstrumentation({tracing:i,actionStateFor:d.stateFor}),p=createAgentMemoryInstrumentation({...e,environment:t,tracing:i});function turnState(t){return e.stateStore.get(`turn`,JSON.stringify([t.sessionId,t.turnId]))}let onSessionStarted=async e=>{await l(e)},onTurnStarted=async e=>{await u(e)},onStepStarted=async t=>{let n=await turnState(t.scope);if(n===void 0||!isSampledTrace(n.context))return;let r=await e.stateStore.get(`session`,t.scope.sessionId),i=await c.turnFor(t.scope.sessionId,t.scope.turnId,withChannelAudience(ROOT_CONTEXT,t.scope.channelAudience));if(i===void 0||i.finished)return;let a=trace.getSpan(context.active())?.spanContext(),s=await i.attempt({stepIndex:t.scope.stepIndex,attempt:t.scope.attemptIndex,runtimeContext:t.runtimeContext,channel:eveActivationMetadata({session:r,turn:n,sessionId:t.scope.sessionId}).channel,links:a===void 0||a.traceId===n.context.traceId?void 0:[{relationship:`execution.delivery`,context:a}]});o.set(t.scope.attemptId,s)},onStepTerminal=async e=>{let t=e.type===`step.attempt.failed`?{error:e.error}:void 0;await drainOpenSpans(e),await d.drain(e.scope.attemptId,t);let n=o.get(e.scope.attemptId)??await attemptFor(e.scope);o.delete(e.scope.attemptId),t===void 0?await n?.complete():(await n?.fail(t.error),await d.forgetAttempt(e.scope))},onSessionTransition=async t=>{await c.sessionTransition(t),(t.type===`session.completed`||t.type===`session.failed`)&&(await d.deleteForSession(t.sessionId),await e.stateStore.delete(`session`,t.sessionId))},onModelCallStarted=async e=>{let t=o.get(e.scope.attemptId);if(t===void 0)return;let r=await t.modelCall({provider:e.model.provider,modelId:e.model.modelId,messages:n?e.input?.messages.map(e=>isObject(e)&&e.role===`user`?{...e,kind:isUserMessageKind(e.kind)?e.kind:void 0}:e):void 0,instructions:n?e.input?.instructions:void 0,tools:n?e.input?.tools:void 0,runtimeContext:e.runtimeContext},e.idempotencyKey),i=s.get(e.scope.attemptId);i===void 0&&s.set(e.scope.attemptId,i=new Map),i.set(e.idempotencyKey,r)},onModelCallTerminal=async e=>{let t=s.get(e.scope.attemptId),n=t?.get(e.idempotencyKey);t?.delete(e.idempotencyKey),n!==void 0&&(e.type===`model.call.failed`?await n.fail(e.error):await n.complete({outcome:`completed`,result:{...e,content:r?e.content:void 0}}))},m=createAgentChannelDeliveryInstrumentation({recordInputs:n,stateStore:e.stateStore}),onStepMetadata=e=>{let t=o.get(e.scope.attemptId);if(t===void 0)return;let n=readGatewayCostData(e.providerMetadata);n!==void 0&&t.attributes(gatewayCostAttributes(n));let r=gatewayRoutingAttributes(e.providerMetadata);r!==void 0&&t.attributes(r)};return{hook:{events:{...m,...f,"step.attempt.completed":onStepTerminal,"step.attempt.failed":onStepTerminal,"step.attempt.metadata":onStepMetadata,"step.attempt.started":onStepStarted,"model.call.completed":onModelCallTerminal,"model.call.failed":onModelCallTerminal,"model.call.started":onModelCallStarted,"session.completed":onSessionTransition,"session.failed":onSessionTransition,"session.started":onSessionStarted,"session.waiting":onSessionTransition,...d.events,"turn.cancelled":c.turnTerminal,"turn.completed":c.turnTerminal,"turn.failed":c.turnTerminal,"turn.started":onTurnStarted},name:`eve.otel`,projectEvent:a.projectEvent,tracePolicy:()=>({emit:!0,recordInputs:n,recordOutputs:r})},prepareSessionTrace:l,prepareTurnTrace:u,async runInContext(t,n){if(t.type===`memory.operation`)return p.runInContext(t,n);let r={emit:!0,...await a.forOperation(t.scope)},inTurn=async()=>{let i=await c.turnFor(t.scope.sessionId,t.scope.turnId,withChannelAudience(ROOT_CONTEXT,t.scope.channelAudience));if(i!==void 0&&!i.finished)return i.run(n,r);let{sessionId:a,turnId:o}=t.scope;return e.telemetry.suppressed!==void 0&&await c.dropped(a,o)?e.telemetry.suppressed(n):n()};if(t.type===`tool.call`)return d.runInContext(t,n,r,inTurn);let i=s.get(t.scope.attemptId)?.get(t.idempotencyKey);return i!==void 0&&!i.finished?i.run(n,r):inTurn()}};async function drainOpenSpans(e){for(let t of s.get(e.scope.attemptId)?.values()??[])e.type===`step.attempt.failed`?await t.fail(e.error):await t.complete({outcome:`completed`,result:{finishReason:`unknown`,usage:{}}});s.delete(e.scope.attemptId)}}export{createAgentOtelInstrumentation};
+import{isObject}from"#shared/guards.js";import{resolveInstrumentationEnvironment}from"#internal/application/dev-environment.js";import{isUserMessageKind}from"#harness/messages.js";import{isSampledTrace}from"#shared/trace-policy.js";import{ROOT_CONTEXT,context,trace}from"#compiled/@opentelemetry/api/index.js";import{attemptIdempotencyKey}from"#instrumentation/lifecycle.js";import{traceStepIndex}from"#instrumentation/scope.js";import{gatewayCostAttributes,gatewayRoutingAttributes,readGatewayCostData}from"#tracing/eve/gateway.js";import{createAgentToolInstrumentation}from"#tracing/eve/agent-tool-instrumentation.js";import{withChannelAudience}from"#tracing/eve/channel-audience-context.js";import{createEveTracing}from"#tracing/eve/operation-input.js";import{createAgentApprovalInstrumentation}from"#tracing/eve/agent-approval-instrumentation.js";import{createAgentChannelDeliveryInstrumentation}from"#tracing/eve/agent-channel-delivery-instrumentation.js";import{eveActivationMetadata}from"#tracing/eve/metadata.js";import{createAgentMemoryInstrumentation}from"#tracing/eve/agent-memory-instrumentation.js";import{createEveSessionTracing}from"#tracing/eve/session.js";import{createEveCapturePolicy}from"#tracing/eve/policy.js";function createAgentOtelInstrumentation(e){let t=e.environment??resolveInstrumentationEnvironment(),n=e.recordInputs??!1,r=e.recordOutputs??!1,i=createEveTracing(e),a=createEveCapturePolicy({stateStore:e.stateStore,environment:t,recordInputs:n,recordOutputs:r}),o=new Map,s=new Map,c=createEveSessionTracing({...e,environment:t,tracing:i,capturePolicy:a}),{prepareSessionTrace:l,prepareTurnTrace:u}=c;async function attemptFor(e){let t=o.get(attemptIdempotencyKey(e));if(t!==void 0)return t;let n=traceStepIndex(e);if(e.turnId===void 0||n===void 0)return;let r=await c.turnFor(e.sessionId,e.turnId,withChannelAudience(ROOT_CONTEXT,e.channelAudience)),i={stepIndex:n,attempt:e.attempt};return r?.findAttempt(i)??(r?.finished===!1?r.attempt(i):void 0)}let d=createAgentToolInstrumentation({tracing:i,attemptFor,stepFor:e=>o.get(attemptIdempotencyKey(e)),recordInputs:n,recordOutputs:r,stateStore:e.stateStore}),f=createAgentApprovalInstrumentation({tracing:i,actionStateFor:d.stateFor}),p=createAgentMemoryInstrumentation({...e,environment:t,tracing:i});function turnState(t){return e.stateStore.get(`turn`,JSON.stringify([t.sessionId,t.turnId]))}let onSessionStarted=async e=>{await l(e)},onTurnStarted=async e=>{await u(e)},onStepStarted=async t=>{let n=traceStepIndex(t.scope);if(t.scope.turnId===void 0||n===void 0)return;let r=await turnState({sessionId:t.scope.sessionId,turnId:t.scope.turnId});if(r===void 0||!isSampledTrace(r.context))return;let i=await e.stateStore.get(`session`,t.scope.sessionId),a=await c.turnFor(t.scope.sessionId,t.scope.turnId,withChannelAudience(ROOT_CONTEXT,t.scope.channelAudience));if(a===void 0||a.finished)return;let s=trace.getSpan(context.active())?.spanContext(),l=await a.attempt({stepIndex:n,attempt:t.scope.attempt,runtimeContext:t.runtimeContext,channel:eveActivationMetadata({session:i,turn:r,sessionId:t.scope.sessionId}).channel,links:s===void 0||s.traceId===r.context.traceId?void 0:[{relationship:`execution.delivery`,context:s}]});o.set(attemptIdempotencyKey(t.scope),l)},onStepTerminal=async e=>{let t=attemptFailed(e)?{error:e.error}:void 0;await drainOpenSpans(e),await d.drain(attemptIdempotencyKey(e.scope),t);let n=o.get(attemptIdempotencyKey(e.scope))??await attemptFor(e.scope);o.delete(attemptIdempotencyKey(e.scope)),t===void 0?await n?.complete():(await n?.fail(t.error),await d.forgetAttempt(e.scope))},onSessionEnded=async t=>{await c.sessionEnded(t),await d.deleteForSession(t.sessionId),await e.stateStore.delete(`session`,t.sessionId)},onModelCallStarted=async e=>{let t=o.get(attemptIdempotencyKey(e.scope));if(t===void 0)return;let r=await t.modelCall({provider:e.model.provider,modelId:e.model.modelId,messages:n?e.input?.messages.map(e=>isObject(e)&&e.role===`user`?{...e,kind:isUserMessageKind(e.kind)?e.kind:void 0}:e):void 0,instructions:n?e.input?.instructions:void 0,tools:n?e.input?.tools:void 0,runtimeContext:e.runtimeContext},e.idempotencyKey),i=s.get(attemptIdempotencyKey(e.scope));i===void 0&&s.set(attemptIdempotencyKey(e.scope),i=new Map),i.set(e.idempotencyKey,r)},onModelCallTerminal=async e=>{let t=o.get(attemptIdempotencyKey(e.scope));if(e.outcome===`completed`&&t!==void 0){let n=readGatewayCostData(e.providerMetadata);n!==void 0&&t.attributes(gatewayCostAttributes(n));let r=gatewayRoutingAttributes(e.providerMetadata);r!==void 0&&t.attributes(r)}let n=s.get(attemptIdempotencyKey(e.scope)),i=n?.get(e.idempotencyKey);n?.delete(e.idempotencyKey),i!==void 0&&(e.outcome===`failed`?await i.fail(e.error):await i.complete({outcome:`completed`,result:{...e,content:r?e.content:void 0}}))};return{hook:{events:{...createAgentChannelDeliveryInstrumentation({recordInputs:n,stateStore:e.stateStore}),...f,"model.settled":onStepTerminal,"model.retried":onStepTerminal,"model.started":onStepStarted,"model.call.settled":onModelCallTerminal,"model.call.started":onModelCallStarted,"session.ended":onSessionEnded,"session.started":onSessionStarted,...d.events,"turn.settled":c.turnSettled,"turn.started":onTurnStarted},name:`eve.otel`,projectEvent:a.projectEvent,tracePolicy:()=>({emit:!0,recordInputs:n,recordOutputs:r})},prepareSessionTrace:l,prepareTurnTrace:u,async runInContext(t,n){if(t.type===`memory.operation`)return p.runInContext(t,n);let r={emit:!0,...await a.forOperation(t.scope)},inTurn=async()=>{if(t.scope.turnId===void 0)return n();let i=await c.turnFor(t.scope.sessionId,t.scope.turnId,withChannelAudience(ROOT_CONTEXT,t.scope.channelAudience));if(i!==void 0&&!i.finished)return i.run(n,r);let{sessionId:a,turnId:o}=t.scope;return e.telemetry.suppressed!==void 0&&await c.dropped(a,o)?e.telemetry.suppressed(n):n()};if(t.type===`tool.call`)return d.runInContext(t,n,r,inTurn);let i=s.get(attemptIdempotencyKey(t.scope))?.get(t.idempotencyKey);return i!==void 0&&!i.finished?i.run(n,r):inTurn()}};async function drainOpenSpans(e){for(let t of s.get(attemptIdempotencyKey(e.scope))?.values()??[])attemptFailed(e)?await t.fail(e.error):await t.complete({outcome:`completed`,result:{finishReason:`unknown`,usage:{}}});s.delete(attemptIdempotencyKey(e.scope))}}function attemptFailed(e){return e.type===`model.retried`||e.outcome!==`completed`&&e.outcome!==`cancelled`}export{createAgentOtelInstrumentation};

package/dist/src/tracing/eve/agent-tool-instrumentation.d.ts

@@ -1,5 +1,5 @@
 import { type Context, type SpanContext } from "#compiled/@opentelemetry/api/index.js";
-import type { InstrumentationAttemptScope, InstrumentationExecutionOperation, InstrumentationToolCallStartedEvent, InstrumentationToolCallTerminalEvent } from "#instrumentation/lifecycle.js";
+import type { InstrumentationScope, InstrumentationExecutionOperation, InstrumentationCallRequestedEvent, InstrumentationCallSettledEvent } from "#instrumentation/lifecycle.js";
 import type { AgentActionTraceState, AgentTraceStateStore } from "#tracing/eve/agent-trace-state.js";
 import type { AgentRun, AttemptOperation, CaptureDecision, ToolOperation } from "#compiled/@vercel/agent-runs/index.js";
 export interface AgentToolContext {
@@ -19,8 +19,8 @@ export declare function resumeTool(tracing: AgentRun, state: AgentActionTraceSta
  */
 export declare function createAgentToolInstrumentation(input: {
     readonly tracing: AgentRun;
-    readonly attemptFor: (scope: InstrumentationAttemptScope) => Promise<AttemptOperation | undefined>;
-    readonly stepFor: (scope: InstrumentationAttemptScope) => AttemptOperation | undefined;
+    readonly attemptFor: (scope: InstrumentationScope) => Promise<AttemptOperation | undefined>;
+    readonly stepFor: (scope: InstrumentationScope) => AttemptOperation | undefined;
     readonly recordInputs: boolean;
     readonly recordOutputs: boolean;
     readonly stateStore: AgentTraceStateStore;
@@ -28,7 +28,7 @@ export declare function createAgentToolInstrumentation(input: {
     stateFor: (sessionId: string, turnId: string, callId: string) => Promise<AgentActionTraceState | undefined>;
     contextFor(sessionId: string, turnId: string, callId: string): Promise<AgentToolContext | undefined>;
     deleteForSession(sessionId: string): Promise<void>;
-    forgetAttempt(scope: InstrumentationAttemptScope): Promise<void>;
+    forgetAttempt(scope: InstrumentationScope): Promise<void>;
     /** Closes SDK runs that no dispatch claimed before their step ended. */
     drain(attemptId: string, failure?: {
         readonly error: unknown;
@@ -36,9 +36,8 @@ export declare function createAgentToolInstrumentation(input: {
     /** Runs the SDK's tool call inside its span, or calls `fallback` when it has none. */
     runInContext<T>(operation: ToolExecution, execute: () => PromiseLike<T>, ceiling: CaptureDecision, fallback: () => Promise<T>): Promise<T>;
     events: {
-        "tool.call.completed": (event: InstrumentationToolCallTerminalEvent) => Promise<void>;
-        "tool.call.failed": (event: InstrumentationToolCallTerminalEvent) => Promise<void>;
-        "tool.call.started": (event: InstrumentationToolCallStartedEvent) => Promise<void>;
+        "call.requested": (event: InstrumentationCallRequestedEvent) => Promise<void>;
+        "call.settled": (event: InstrumentationCallSettledEvent) => Promise<void>;
     };
 };
 export {};

package/dist/src/tracing/eve/agent-tool-instrumentation.js

@@ -1 +1 @@
-import{normalizeChannelAudience}from"#shared/channel-audience.js";import{ROOT_CONTEXT,trace}from"#compiled/@opentelemetry/api/index.js";import{actionIdempotencyKey}from"#instrumentation/lifecycle.js";import{withChannelAudience}from"#tracing/eve/channel-audience-context.js";import{eveTurnIdentity}from"#tracing/eve/operation-input.js";async function resumeTool(e,t){return(await e.resume({identity:eveTurnIdentity(t),context:withChannelAudience(ROOT_CONTEXT,t.channelAudience)}))?.findTool(t.callId)}function createAgentToolInstrumentation(e){let t=new Map,callKey=(e,t)=>actionIdempotencyKey(e.sessionId,e.turnId,t);async function stateFor(t,n,r){let i=await e.stateStore.get(`action`,actionIdempotencyKey(t,n,r));return i===void 0?(await e.stateStore.entries(`action`)).find(([,e])=>e.sessionId===t&&e.callId===r)?.[1]:i}async function reenter(t,n){let r=await e.tracing.resume({identity:eveTurnIdentity(t),context:withChannelAudience(ROOT_CONTEXT,t.channelAudience)});if(r?.findTool(t.callId)===void 0)return;let i=r.findAttempt({stepIndex:t.stepIndex,attempt:t.attemptIndex});return i===void 0?r.findTool(t.callId):i.tool(n)}async function settleExecution(n,r){let i=n.terminal;i!==void 0&&(t.delete(n.idempotencyKey),i.failed?n.tool.recordError(i.error):i.durationMs!==void 0&&n.tool.attributes({"gen_ai.execute_tool.duration":i.durationMs/1e3}),await e.stateStore.set(`action`,n.idempotencyKey,{...r,toolEndTimeMs:i.completedAtMs}))}async function onDispatchStarted(n){let r=await e.stateStore.get(`action`,n.idempotencyKey);if(r===void 0){let i=await e.attemptFor(n.scope);if(i===void 0)return;let a=await i.tool({callId:n.callId,name:n.toolName,kind:n.kind??`tool-call`,arguments:e.recordInputs?n.input:void 0,startTimeMs:n.startedAtMs});a.attributes({"agent.tool.is_framework":n.frameworkTool===!0}),r={attemptId:n.scope.attemptId,attemptIndex:n.scope.attemptIndex,callId:n.callId,channelAudience:normalizeChannelAudience(n.scope.channelAudience),context:{...a.reference,isRemote:!1},rootSessionId:n.scope.rootSessionId,sessionId:n.scope.sessionId,stepIndex:n.scope.stepIndex,turnId:n.scope.turnId},await e.stateStore.set(`action`,n.idempotencyKey,r);let o=t.get(n.idempotencyKey);o!==void 0&&await settleExecution(o,r)}n.isWorkflowTool===!0&&await e.stateStore.set(`anchor`,n.idempotencyKey,r)}async function onDispatchTerminal(t){let n=await e.stateStore.get(`action`,t.idempotencyKey);if(n!==void 0)try{let r=await resumeTool(e.tracing,n),i=t.type===`tool.call.failed`?t.error:t.output.type===`error`?t.output.error:void 0;await r?.complete({outcome:t.outcome??(t.type===`tool.call.failed`?`failed`:`completed`),failed:t.type===`tool.call.failed`||t.output.type===`error`,errorType:t.type===`tool.call.failed`?t.errorCode:void 0,error:i,output:e.recordOutputs&&t.type===`tool.call.completed`&&t.output.type===`result`?t.output.output:void 0,usage:t.usage,endTimeMs:t.acceptedAtMs??n.toolEndTimeMs})}finally{await e.stateStore.delete(`action`,t.idempotencyKey)}}async function executionFor(n,r){let i=callKey(n.scope,n.callId),a=t.get(i);if(a!==void 0)return a;let o=await stateFor(n.scope.sessionId,n.scope.turnId,n.callId),s={callId:n.callId,name:n.toolName,arguments:e.recordInputs&&r.recordInputs?n.input:void 0,startTimeMs:n.startedAtMs},c=o===void 0?await e.stepFor(n.scope)?.tool(s):await reenter(o,s);if(c===void 0||t.size>=1e4)return;let l={attemptId:n.scope.attemptId,idempotencyKey:i,tool:c};return t.set(i,l),l}async function finishExecution(t,n){t.terminal=n;let r=t.idempotencyKey,i=await e.stateStore.get(`action`,r);i!==void 0&&await settleExecution(t,i)}return{stateFor,async contextFor(e,t,n){let r=await stateFor(e,t,n);return r===void 0?void 0:toolContext(r)},async deleteForSession(t){for(let n of[`action`,`anchor`])for(let[r,i]of await e.stateStore.entries(n))i.sessionId===t&&await e.stateStore.delete(n,r)},async forgetAttempt(t){for(let[n,r]of await e.stateStore.entries(`action`))r.attemptId===t.attemptId&&await e.stateStore.delete(`action`,n)},async drain(n,r){for(let[i,a]of t){if(a.attemptId!==n||(t.delete(i),await e.stateStore.get(`action`,i)!==void 0))continue;let o=a.terminal;if(r!==void 0){await a.tool.fail(r.error);continue}o?.durationMs!==void 0&&!o.failed&&a.tool.attributes({"gen_ai.execute_tool.duration":o.durationMs/1e3}),await a.tool.complete({failed:o?.failed,error:o?.error,output:o?.output,endTimeMs:o?.completedAtMs})}},async runInContext(t,n,r,i){if(t.callId===void 0||t.toolName===void 0)return i();let a=await executionFor({...t,callId:t.callId,toolName:t.toolName},r);if(a===void 0||a.tool.finished)return i();a.tool.attributes({"agent.tool.is_framework":t.frameworkTool===!0});let o=t.startedAtMs??Date.now();try{let i=await a.tool.run(n,r),s=t.completedAtMs??Date.now();return await finishExecution(a,{completedAtMs:s,durationMs:s-o,failed:t.failed===!0,output:e.recordOutputs&&r.recordOutputs?i:void 0}),i}catch(e){throw await finishExecution(a,{completedAtMs:Date.now(),failed:!0,error:r.recordOutputs?e:void 0}),e}},events:{"tool.call.completed":onDispatchTerminal,"tool.call.failed":onDispatchTerminal,"tool.call.started":onDispatchStarted}}}function toolContext(e){return{context:withChannelAudience(trace.setSpan(ROOT_CONTEXT,trace.wrapSpanContext(e.context)),e.channelAudience),spanContext:e.context}}export{createAgentToolInstrumentation,resumeTool};
+import{normalizeChannelAudience}from"#shared/channel-audience.js";import{ROOT_CONTEXT,trace}from"#compiled/@opentelemetry/api/index.js";import{actionIdempotencyKey,attemptIdempotencyKey}from"#instrumentation/lifecycle.js";import{traceStepIndex}from"#instrumentation/scope.js";import{withChannelAudience}from"#tracing/eve/channel-audience-context.js";import{eveTurnIdentity}from"#tracing/eve/operation-input.js";async function resumeTool(e,t){return(await e.resume({identity:eveTurnIdentity(t),context:withChannelAudience(ROOT_CONTEXT,t.channelAudience)}))?.findTool(t.callId)}function createAgentToolInstrumentation(e){let t=new Map,callKey=(e,t)=>actionIdempotencyKey(e.sessionId,e.turnId,t);async function stateFor(t,n,r){let i=await e.stateStore.get(`action`,actionIdempotencyKey(t,n,r));return i===void 0?(await e.stateStore.entries(`action`)).find(([,e])=>e.sessionId===t&&e.callId===r)?.[1]:i}async function reenter(t,n){let r=await e.tracing.resume({identity:eveTurnIdentity(t),context:withChannelAudience(ROOT_CONTEXT,t.channelAudience)});if(r?.findTool(t.callId)===void 0)return;let i=r.findAttempt({stepIndex:t.stepIndex,attempt:t.attemptIndex});return i===void 0?r.findTool(t.callId):i.tool(n)}async function settleExecution(n,r){let i=n.terminal;i!==void 0&&(t.delete(n.idempotencyKey),i.failed?n.tool.recordError(i.error):i.durationMs!==void 0&&n.tool.attributes({"gen_ai.execute_tool.duration":i.durationMs/1e3}),await e.stateStore.set(`action`,n.idempotencyKey,{...r,toolEndTimeMs:i.completedAtMs}))}async function onDispatchStarted(n){let r=traceStepIndex(n.scope);if(n.scope.turnId===void 0||r===void 0)return;let i=await e.stateStore.get(`action`,n.idempotencyKey);if(i===void 0){let a=await e.attemptFor(n.scope);if(a===void 0)return;let o=await a.tool({callId:n.callId,name:n.toolName,kind:n.capability.kind===`agent`?n.capability.remote?`remote-agent-call`:`subagent-call`:n.capability.kind===`skill`?`load-skill`:`tool-call`,arguments:e.recordInputs?n.input:void 0,startTimeMs:n.startedAtMs});o.attributes({"agent.tool.is_framework":n.frameworkTool===!0}),i={attemptId:attemptIdempotencyKey(n.scope),attemptIndex:n.scope.attempt,callId:n.callId,channelAudience:normalizeChannelAudience(n.scope.channelAudience),context:{...o.reference,isRemote:!1},rootSessionId:n.scope.rootSessionId,sessionId:n.scope.sessionId,stepIndex:r,turnId:n.scope.turnId},await e.stateStore.set(`action`,n.idempotencyKey,i);let s=t.get(n.idempotencyKey);s!==void 0&&await settleExecution(s,i)}n.capability.kind===`agent`&&await e.stateStore.set(`anchor`,n.idempotencyKey,i)}async function onDispatchTerminal(t){let n=await e.stateStore.get(`action`,t.idempotencyKey);if(n!==void 0)try{let r=await resumeTool(e.tracing,n),i=t.outcome!==`completed`;await r?.complete({outcome:t.outcome===`interrupted`?`cancelled`:t.outcome,failed:i,errorType:i?t.errorCode:void 0,error:i?t.error:void 0,output:e.recordOutputs&&!i?t.output:void 0,usage:t.usage,endTimeMs:t.acceptedAtMs??n.toolEndTimeMs})}finally{await e.stateStore.delete(`action`,t.idempotencyKey)}}async function executionFor(n,r){if(n.scope.turnId===void 0)return;let i=callKey({sessionId:n.scope.sessionId,turnId:n.scope.turnId},n.callId),a=t.get(i);if(a!==void 0)return a;let o=await stateFor(n.scope.sessionId,n.scope.turnId,n.callId),s={callId:n.callId,name:n.toolName,arguments:e.recordInputs&&r.recordInputs?n.input:void 0,startTimeMs:n.startedAtMs},c=o===void 0?await e.stepFor(n.scope)?.tool(s):await reenter(o,s);if(c===void 0||t.size>=1e4)return;let l={attemptId:attemptIdempotencyKey(n.scope),idempotencyKey:i,tool:c};return t.set(i,l),l}async function finishExecution(t,n){t.terminal=n;let r=t.idempotencyKey,i=await e.stateStore.get(`action`,r);i!==void 0&&await settleExecution(t,i)}return{stateFor,async contextFor(e,t,n){let r=await stateFor(e,t,n);return r===void 0?void 0:toolContext(r)},async deleteForSession(t){for(let n of[`action`,`anchor`])for(let[r,i]of await e.stateStore.entries(n))i.sessionId===t&&await e.stateStore.delete(n,r)},async forgetAttempt(t){for(let[n,r]of await e.stateStore.entries(`action`))r.attemptId===attemptIdempotencyKey(t)&&await e.stateStore.delete(`action`,n)},async drain(n,r){for(let[i,a]of t){if(a.attemptId!==n||(t.delete(i),await e.stateStore.get(`action`,i)!==void 0))continue;let o=a.terminal;if(r!==void 0){await a.tool.fail(r.error);continue}o?.durationMs!==void 0&&!o.failed&&a.tool.attributes({"gen_ai.execute_tool.duration":o.durationMs/1e3}),await a.tool.complete({failed:o?.failed,error:o?.error,output:o?.output,endTimeMs:o?.completedAtMs})}},async runInContext(t,n,r,i){if(t.callId===void 0||t.toolName===void 0)return i();let a=await executionFor({...t,callId:t.callId,toolName:t.toolName},r);if(a===void 0||a.tool.finished)return i();a.tool.attributes({"agent.tool.is_framework":t.frameworkTool===!0});let o=t.startedAtMs??Date.now();try{let i=await a.tool.run(n,r),s=t.completedAtMs??Date.now();return await finishExecution(a,{completedAtMs:s,durationMs:s-o,failed:t.failed===!0,output:e.recordOutputs&&r.recordOutputs?i:void 0}),i}catch(e){throw await finishExecution(a,{completedAtMs:Date.now(),failed:!0,error:r.recordOutputs?e:void 0}),e}},events:{"call.requested":onDispatchStarted,"call.settled":onDispatchTerminal}}}function toolContext(e){return{context:withChannelAudience(trace.setSpan(ROOT_CONTEXT,trace.wrapSpanContext(e.context)),e.channelAudience),spanContext:e.context}}export{createAgentToolInstrumentation,resumeTool};

package/dist/src/tracing/eve/agent-trace-context-store.d.ts

@@ -1,5 +1,5 @@
-import type { SessionTraceContext } from "#channel/types.js";
 import type { ContextAccessor } from "#context/key.js";
+import { type SessionTraceSeed } from "#context/keys.js";
 import type { AgentTraceStateStore, AgentTraceValues } from "#tracing/eve/agent-trace-state.js";
 import type { SessionStateMap } from "#harness/types.js";
 import type { InstrumentationDecision } from "#shared/instrumentation-decision.js";
@@ -11,9 +11,9 @@ export declare function readSessionTraceDecision(context: ContextAccessor, sessi
 /** Keeps only framework trace state from an interrupted step's context changes. */
 export declare function preserveSerializedAgentTraceState(original: Record<string, unknown>, interrupted: Record<string, unknown>): Record<string, unknown>;
 /** Reads the active turn context straight out of a serialized Workflow context. */
-export declare function readTurnTraceContext(serializedContext: Readonly<Record<string, unknown>>, sessionId: string, turnId: string): SessionTraceContext | undefined;
+export declare function readTurnTraceContext(serializedContext: Readonly<Record<string, unknown>>, sessionId: string, turnId: string): SessionTraceSeed | undefined;
 /** Reads the durable action span that should parent a dispatched child agent. */
-export declare function readActionTraceContext(serializedContext: Readonly<Record<string, unknown>>, sessionId: string, turnId: string, callId: string): SessionTraceContext | undefined;
+export declare function readActionTraceContext(serializedContext: Readonly<Record<string, unknown>>, sessionId: string, turnId: string, callId: string): SessionTraceSeed | undefined;
 /** Durable trace state backed by eve's serialized Workflow context. */
 export declare class ContextAgentTraceStateStore implements AgentTraceStateStore {
     get<K extends keyof AgentTraceValues>(kind: K, key: string): AgentTraceValues[K] | undefined;

package/dist/src/tracing/eve/agent-trace-state.d.ts

@@ -18,15 +18,10 @@ export interface AgentSessionTraceState {
 }
 export interface AgentTurnTraceState {
     readonly agentName?: string;
-    /** Recorded at the turn's terminal event; the span ends at the session transition. */
-    readonly terminal?: {
-        readonly outcome: "cancelled" | "completed" | "failed";
-        readonly errorName?: string;
-        readonly errorMessage?: string;
-    };
     readonly traceSessionId: string;
     readonly caller?: SpanContext;
     readonly channelDelivery?: AgentTurnChannelDeliveryTraceState;
+    readonly consumedDeliveryId?: string | null;
     readonly context: SpanContext;
     readonly currentPrincipal?: InstrumentationPrincipalSummary;
     readonly initiatorPrincipal?: InstrumentationPrincipalSummary;

package/dist/src/tracing/eve/delegation.d.ts

@@ -1,5 +1,5 @@
 import type { AgentSessionContext } from "#execution/agent-sessions/context.js";
-import type { SessionParent, SessionTraceContext } from "#channel/types.js";
+import type { SessionParent, SessionTraceSeed } from "#channel/types.js";
 export declare const agentDelegation: {
     fetch: typeof fetch;
     resume<T>(input: {
@@ -11,10 +11,10 @@ export declare const agentDelegation: {
         delegated: boolean;
         trusted: boolean;
         parent?: SessionParent;
-        callerTrace?: SessionTraceContext;
-        parentTraceContext?: SessionTraceContext;
+        callerTrace?: SessionTraceSeed;
+        parentTraceContext?: SessionTraceSeed;
     }, execute: (context: {
         conversationId?: string;
-        parentTraceContext?: SessionTraceContext;
+        parentTraceContext?: SessionTraceSeed;
     }) => T): T;
 };

package/dist/src/tracing/eve/install-instrumentation-runtime.js

@@ -1 +1 @@
-import{createLogger,formatError}from"#internal/logging.js";import{contextStorage}from"#context/container.js";import{ConversationIdKey}from"#context/keys.js";import{resolveInstrumentationEnvironment}from"#internal/application/dev-environment.js";import{readConversationId}from"#shared/conversation-identity.js";import{ContextAgentTraceStateStore}from"#tracing/eve/agent-trace-context-store.js";import{registerInstrumentationRuntime}from"#instrumentation/runtime.js";import{createInstrumentationHooks}from"#instrumentation/lifecycle.js";import{AgentSpanIdGenerator,otelTelemetry}from"#compiled/@vercel/agent-runs/index.js";import{hasConversationRelease}from"#tracing/local/traces.js";import{eveOutputMapping}from"#tracing/eve/profile.js";import{createAgentOtelInstrumentation}from"#tracing/eve/agent-otel-provider.js";import{registerOtel}from"#tracing/eve/otel-registration.js";const log=createLogger(`tracing.install-instrumentation-runtime`);function installInstrumentationRuntime(e){let t=[],n=[],r,i,a,runInContext=(e,t)=>t(),o;if(e.collected.declared){r=registerOtel({serviceName:e.serviceName,otel:e.collected.configuration}),o=r.idGenerator;let s=createAgentOtelInstrumentation({environment:resolveInstrumentationEnvironment(),frameworkVersion:e.frameworkVersion,telemetry:otelTelemetry({provider:r.provider,tracerName:`eve.agent`,tracerVersion:e.frameworkVersion,idGenerator:o,samplesTrace:r.samplesTrace,mapping:eveOutputMapping()}),idGenerator:o,recordInputs:e.collected.settings.recordInputs,recordOutputs:e.collected.settings.recordOutputs,stateStore:new ContextAgentTraceStateStore,tracePolicy:e.collected.settings.tracePolicy});t.push({...s.hook,stateNamespace:`internal:otel`}),i=s.prepareSessionTrace,a=s.prepareTurnTrace,runInContext=s.runInContext;let c=e.collected.configuration.spanProcessors.filter(isSpanProcessor).filter(hasConversationRelease);c.length>0&&n.push(sessionReleaseProvider(c))}else o=new AgentSpanIdGenerator;let s=[...t,...e.providers,...n],c;return registerInstrumentationRuntime({forceFlush:async()=>{await settleAll(s.map(e=>()=>e.flush?.())),await settleAll(r===void 0?[]:[r.forceFlush])},hooks:createInstrumentationHooks({parallel:e.providers,serialAfter:n,serialBefore:t}),idGenerator:o,memoryOperations:r!==void 0||e.providers.some(hasMemoryOperationHandler),otelSettings:e.collected.declared?e.collected.settings:void 0,ownsAgentSpans:r!==void 0,prepareSessionTrace:i,prepareTurnTrace:a,runtimeContextResolvers:e.runtimeContextResolvers,runInContext,samplesTrace:r?.samplesTrace,shutdown:()=>(c??=(async()=>{await settleAll(s.map(e=>()=>e.shutdown?.())),await settleAll(r===void 0?[]:[r.shutdown])})(),c)})}function hasMemoryOperationHandler(e){return e.events?.[`memory.operation.started`]!==void 0||e.events?.[`memory.operation.completed`]!==void 0||e.events?.[`memory.operation.failed`]!==void 0}function isSpanProcessor(e){return e!==`auto`}function sessionReleaseProvider(e){let release=async t=>{let n=readConversationId(contextStorage.getStore()?.get(ConversationIdKey))??t.sessionId;n===t.sessionId&&await Promise.all(e.map(e=>e.releaseConversation(n)))};return{events:{"session.completed":release,"session.failed":release},name:`eve.conversation-release`,stateNamespace:`internal:conversation-release`}}async function settleAll(e){let t=await Promise.allSettled(e.map(async e=>e()));for(let e of t)e.status===`rejected`&&log.warn(`instrumentation drain failed`,{error:formatError(e.reason)})}export{installInstrumentationRuntime};
+import{createLogger,formatError}from"#internal/logging.js";import{resolveInstrumentationEnvironment}from"#internal/application/dev-environment.js";import{contextStorage}from"#context/container.js";import{ConversationIdKey}from"#context/keys.js";import{readConversationId}from"#shared/conversation-identity.js";import{ContextAgentTraceStateStore}from"#tracing/eve/agent-trace-context-store.js";import{registerInstrumentationRuntime}from"#instrumentation/runtime.js";import{createInstrumentationHooks}from"#instrumentation/lifecycle.js";import{AgentSpanIdGenerator,otelTelemetry}from"#compiled/@vercel/agent-runs/index.js";import{hasConversationRelease}from"#tracing/local/traces.js";import{eveOutputMapping}from"#tracing/eve/profile.js";import{createAgentOtelInstrumentation}from"#tracing/eve/agent-otel-provider.js";import{registerOtel}from"#tracing/eve/otel-registration.js";const log=createLogger(`tracing.install-instrumentation-runtime`);function installInstrumentationRuntime(e){let t=[],n=[],r,i,a,runInContext=(e,t)=>t(),o;if(e.collected.declared){r=registerOtel({serviceName:e.serviceName,otel:e.collected.configuration}),o=r.idGenerator;let s=createAgentOtelInstrumentation({environment:resolveInstrumentationEnvironment(),frameworkVersion:e.frameworkVersion,telemetry:otelTelemetry({provider:r.provider,tracerName:`eve.agent`,tracerVersion:e.frameworkVersion,idGenerator:o,samplesTrace:r.samplesTrace,mapping:eveOutputMapping()}),idGenerator:o,recordInputs:e.collected.settings.recordInputs,recordOutputs:e.collected.settings.recordOutputs,stateStore:new ContextAgentTraceStateStore,tracePolicy:e.collected.settings.tracePolicy});t.push({...s.hook,stateNamespace:`internal:otel`}),i=s.prepareSessionTrace,a=s.prepareTurnTrace,runInContext=s.runInContext;let c=e.collected.configuration.spanProcessors.filter(isSpanProcessor).filter(hasConversationRelease);c.length>0&&n.push(sessionReleaseProvider(c))}else o=new AgentSpanIdGenerator;let s=[...t,...e.providers,...n],c;return registerInstrumentationRuntime({forceFlush:async()=>{await settleAll(s.map(e=>()=>e.flush?.())),await settleAll(r===void 0?[]:[r.forceFlush])},hooks:createInstrumentationHooks({parallel:e.providers,serialAfter:n,serialBefore:t}),idGenerator:o,memoryOperations:r!==void 0||e.providers.some(hasMemoryOperationHandler),otelSettings:e.collected.declared?e.collected.settings:void 0,ownsAgentSpans:r!==void 0,prepareSessionTrace:i,prepareTurnTrace:a,runtimeContextResolvers:e.runtimeContextResolvers,runInContext,samplesTrace:r?.samplesTrace,shutdown:()=>(c??=(async()=>{await settleAll(s.map(e=>()=>e.shutdown?.())),await settleAll(r===void 0?[]:[r.shutdown])})(),c)})}function hasMemoryOperationHandler(e){return e.events?.[`memory.operation.started`]!==void 0||e.events?.[`memory.operation.settled`]!==void 0}function isSpanProcessor(e){return e!==`auto`}function sessionReleaseProvider(e){return{events:{"session.ended":async t=>{let n=readConversationId(contextStorage.getStore()?.get(ConversationIdKey))??t.sessionId;n===t.sessionId&&await Promise.all(e.map(e=>e.releaseConversation(n)))}},name:`eve.conversation-release`,stateNamespace:`internal:conversation-release`}}async function settleAll(e){let t=await Promise.allSettled(e.map(async e=>e()));for(let e of t)e.status===`rejected`&&log.warn(`instrumentation drain failed`,{error:formatError(e.reason)})}export{installInstrumentationRuntime};

package/dist/src/tracing/eve/invoke-tool-span.d.ts

@@ -11,8 +11,8 @@ export interface InvokeToolTraceOrigin {
  * Runs one direct tool call the way a conversation runs a model-issued one,
  * minus the turn around it.
  *
- * Instrumentation providers get the same `tool.call.started` and
- * `tool.call.completed` events, and the `execute_tool` span carries the same
+ * Instrumentation providers get the same `call.requested` and
+ * `call.settled` events, and the `execute_tool` span carries the same
  * attributes. Content follows the same decision: the OpenTelemetry
  * declaration's content setting, the trace policy, and the channel audience
  * ceiling. Arguments, the result, and error text are recorded only when that
@@ -30,6 +30,7 @@ export declare function withInvokeToolSpan(input: {
     /** The agent's name, on the span whether or not the call has a channel origin. */
     readonly agentName: string;
     readonly auth: SessionAuthContext;
+    readonly input: unknown;
     readonly callId: string;
     readonly origin: InvokeToolTraceOrigin | undefined;
     /** The call's own run id, never a tool session's: traces see each call as one run. */

package/dist/src/tracing/eve/invoke-tool-span.js

@@ -1 +1 @@
-import{createLogger,formatError}from"#internal/logging.js";import{applyLiveDeliveryAudienceCeiling}from"#shared/forwarded-trace-policy.js";import{DIRECT_TOOL_CALL_ATTRIBUTE,DIRECT_TOOL_CALL_VALUE}from"#tracing/local/inspection.js";import{resolveInstrumentationEnvironment}from"#internal/application/dev-environment.js";import{operationConversationId,withOperationTraceContext}from"#tracing/eve/conversation-context.js";import{resolveTracePolicy}from"#shared/trace-policy.js";import{context}from"#compiled/@opentelemetry/api/index.js";import{buildConversationContext}from"#channel/conversation-context.js";import{markAgentTraceContext}from"#tracing/eve/agent-trace-context.js";import{toolCallIdempotencyKey}from"#instrumentation/lifecycle.js";import{contentAttribute,mcpLifecycle,withErrorContent}from"#compiled/@vercel/agent-runs/otel.js";import{otelTelemetry}from"#compiled/@vercel/agent-runs/index.js";import{getInstrumentationRuntime}from"#instrumentation/runtime-global.js";import{MCP_SERIALIZER}from"#tracing/eve/mcp.js";import{withChannelAudience}from"#tracing/eve/channel-audience-context.js";import{eveOutputMapping}from"#tracing/eve/profile.js";const log=createLogger(`invoke-tool`),agentTelemetry=()=>otelTelemetry({tracerName:`eve.agent`,mapping:eveOutputMapping()});async function withInvokeToolSpan(e,t){let n=withErrorContent(context.active(),!1);return await context.with(n,()=>traced(e,n,t))}async function traced(e,t,n){let r=getInstrumentationRuntime();if(r===void 0)return await n(silentObserver);let i=agentTelemetry(),a=buildConversationContext({adapter:e.origin?.adapter??{kind:`channel`},auth:e.auth,channelName:e.origin?.channelName},resolveInstrumentationEnvironment()),o=r.hooks.forTrace?.({agentName:e.agentName,...a})??r.hooks,s={attemptId:e.callId,attemptIndex:0,channelAudience:a.audience,functionId:e.agentName,rootSessionId:e.sessionId,sessionId:e.sessionId,stepIndex:0,traceSessionId:e.sessionId,turnId:e.callId},c=toolCallEvents(o,s,e),l=r.otelSettings;if(l===void 0)return await n(c.observer(void 0));let u=resolveTracePolicy(l.tracePolicy,{agentName:e.agentName,...a},e=>log.warn(`tracePolicy threw; dropping the tool call's trace`,{error:formatError(e)}));if(u.action===`drop`)return await i.suppressed(()=>n(c.observer(void 0)));let d=applyLiveDeliveryAudienceCeiling({...u,recordInputs:l.recordInputs&&u.recordInputs,recordOutputs:l.recordOutputs&&u.recordOutputs},a.audience,void 0,a.environment),f=d.action===`record`&&d.recordInputs,p=d.action===`record`&&d.recordOutputs,m=`execute_tool ${e.toolName}`,h=withOperationTraceContext(withChannelAudience(t,a.audience),s),g={"agent.tool.is_framework":!1,"gen_ai.agent.name":e.agentName,"gen_ai.operation.name":`execute_tool`,"gen_ai.tool.call.id":e.callId,"gen_ai.tool.name":e.toolName,"gen_ai.tool.type":`function`,[DIRECT_TOOL_CALL_ATTRIBUTE]:DIRECT_TOOL_CALL_VALUE,"operation.name":`execute_tool`,"resource.name":m,"agent.run.id":e.sessionId,"agent.trace.schema.version":4,"gen_ai.conversation.id":operationConversationId({sessionId:e.sessionId})};process.env.VERCEL_ENV!==void 0&&(g[`vercel.session_id`]=e.sessionId),e.origin!==void 0&&(g[`eve.channel.kind`]=a.channel.kind,g[`eve.channel.name`]=e.origin.channelName);let _=i.startSpan({type:`tool`,operationId:e.callId,name:m,kind:`INTERNAL`,attributes:g},{context:h}),v={emit:!0,recordInputs:f,recordOutputs:p},y=markAgentTraceContext(withErrorContent(h,p)),b=mcpLifecycle({serializer:MCP_SERIALIZER,...v,write:e=>setDefined(_,e),error:(e,t)=>_.fail(p?e:void 0,t)}),x,S=c.observer({failedWith:e=>{x={error:e}},recordInputs:f,span:_});try{let e=await i.run({type:`tool`,reference:_.reference,capture:v,mcp:b},()=>n(S),y);if(_.setAttribute(`eve.tool.outcome`,e.status),e.status===`completed`&&p){let t=contentAttribute(e.output);t!==void 0&&_.setAttribute(`gen_ai.tool.call.result`,t)}return e.status===`invalid-input`?_.fail(void 0,e.status):e.status===`failed`&&_.fail(p?x?.error:void 0,x===void 0?e.status:void 0),e}catch(e){throw _.fail(p?e:void 0),e}finally{_.end(),await r.forceFlush().catch(e=>{log.warn(`flushing a tool call's trace failed`,{error:formatError(e)})})}}const silentObserver={executed:async()=>{},executing:async()=>{},failedWith:()=>{}};function toolCallEvents(e,t,n){let r=e.capturesInputs??e.capturesContent,i=e.capturesOutputs??e.capturesContent,a=toolCallIdempotencyKey(t,n.callId,0);return{observer(o){return{async executing(i){if(o?.recordInputs){let e=contentAttribute(i);e!==void 0&&o.span.setAttribute(`gen_ai.tool.call.arguments`,e)}await e.publish(Object.freeze({callId:n.callId,idempotencyKey:a,input:r?i:void 0,scope:t,toolName:n.toolName,type:`tool.call.started`}))},async executed(n){o?.span.setAttribute(`gen_ai.execute_tool.duration`,n.durationMs/1e3);let r=n.type===`result`?i?{output:n.output,type:`result`}:{type:`result`}:i?{error:n.error,type:`error`}:{type:`error`};await e.publish(Object.freeze({durationMs:n.durationMs,idempotencyKey:a,output:Object.freeze(r),scope:t,type:`tool.call.completed`,outcome:n.type===`result`?`completed`:`failed`}))},failedWith(e){o?.failedWith(e)}}}}}function setDefined(e,t){for(let[n,r]of Object.entries(t))r!==void 0&&e.setAttribute(n,r)}export{withInvokeToolSpan};
+import{createLogger,formatError}from"#internal/logging.js";import{resolveInstrumentationEnvironment}from"#internal/application/dev-environment.js";import{applyLiveDeliveryAudienceCeiling}from"#shared/forwarded-trace-policy.js";import{DIRECT_TOOL_CALL_ATTRIBUTE,DIRECT_TOOL_CALL_VALUE}from"#tracing/local/inspection.js";import{operationConversationId,withOperationTraceContext}from"#tracing/eve/conversation-context.js";import{resolveTracePolicy}from"#shared/trace-policy.js";import{context}from"#compiled/@opentelemetry/api/index.js";import{buildConversationContext}from"#channel/conversation-context.js";import{markAgentTraceContext}from"#tracing/eve/agent-trace-context.js";import{toolCallIdempotencyKey}from"#instrumentation/lifecycle.js";import{instrumentationScope}from"#instrumentation/scope.js";import{contentAttribute,mcpLifecycle,withErrorContent}from"#compiled/@vercel/agent-runs/otel.js";import{otelTelemetry}from"#compiled/@vercel/agent-runs/index.js";import{getInstrumentationRuntime}from"#instrumentation/runtime-global.js";import{MCP_SERIALIZER}from"#tracing/eve/mcp.js";import{withChannelAudience}from"#tracing/eve/channel-audience-context.js";import{eveOutputMapping}from"#tracing/eve/profile.js";const log=createLogger(`invoke-tool`),agentTelemetry=()=>otelTelemetry({tracerName:`eve.agent`,mapping:eveOutputMapping()});async function withInvokeToolSpan(e,t){let n=withErrorContent(context.active(),!1),r=getInstrumentationRuntime();try{return await context.with(n,()=>traced(e,n,t))}finally{await r?.forceFlush().catch(e=>{log.warn(`flushing a tool call's trace failed`,{error:formatError(e)})})}}async function traced(e,t,n){let r=getInstrumentationRuntime();if(r===void 0)return await n(silentObserver);let i=agentTelemetry(),a=buildConversationContext({adapter:e.origin?.adapter??{kind:`channel`},auth:e.auth,channelName:e.origin?.channelName},resolveInstrumentationEnvironment()),o=r.hooks.forTrace?.({agentName:e.agentName,...a})??r.hooks,s=instrumentationScope({runId:e.callId,attempt:0,channelAudience:a.audience,functionId:e.agentName,rootSessionId:e.sessionId,sessionId:e.sessionId,traceSessionId:e.sessionId},0),c=toolCallEvents(o,s,e),l=r.otelSettings;if(l===void 0)return await c.run(n,void 0);let u=resolveTracePolicy(l.tracePolicy,{agentName:e.agentName,...a},e=>log.warn(`tracePolicy threw; dropping the tool call's trace`,{error:formatError(e)}));if(u.action===`drop`)return await i.suppressed(()=>c.run(n,void 0));let d=applyLiveDeliveryAudienceCeiling({...u,recordInputs:l.recordInputs&&u.recordInputs,recordOutputs:l.recordOutputs&&u.recordOutputs},a.audience,void 0,a.environment),f=d.action===`record`&&d.recordInputs,p=d.action===`record`&&d.recordOutputs,m=`execute_tool ${e.toolName}`,h=withOperationTraceContext(withChannelAudience(t,a.audience),s),g={"agent.tool.is_framework":!1,"gen_ai.agent.name":e.agentName,"gen_ai.operation.name":`execute_tool`,"gen_ai.tool.call.id":e.callId,"gen_ai.tool.name":e.toolName,"gen_ai.tool.type":`function`,[DIRECT_TOOL_CALL_ATTRIBUTE]:DIRECT_TOOL_CALL_VALUE,"operation.name":`execute_tool`,"resource.name":m,"agent.run.id":e.sessionId,"agent.trace.schema.version":4,"gen_ai.conversation.id":operationConversationId({sessionId:e.sessionId})};process.env.VERCEL_ENV!==void 0&&(g[`vercel.session_id`]=e.sessionId),e.origin!==void 0&&(g[`eve.channel.kind`]=a.channel.kind,g[`eve.channel.name`]=e.origin.channelName);let _=i.startSpan({type:`tool`,operationId:e.callId,name:m,kind:`INTERNAL`,attributes:g},{context:h}),v={emit:!0,recordInputs:f,recordOutputs:p},y=markAgentTraceContext(withErrorContent(h,p)),b=mcpLifecycle({serializer:MCP_SERIALIZER,...v,write:e=>setDefined(_,e),error:(e,t)=>_.fail(p?e:void 0,t)}),x,S={failedWith:e=>{x={error:e}},recordInputs:f,span:_};try{let e=await i.run({type:`tool`,reference:_.reference,capture:v,mcp:b},()=>c.run(n,S),y);if(_.setAttribute(`eve.tool.outcome`,e.outcome),e.outcome===`completed`&&p){let t=contentAttribute(e.output);t!==void 0&&_.setAttribute(`gen_ai.tool.call.result`,t)}return e.outcome===`failed`&&e.error.code===`INVALID_INPUT`?_.fail(void 0,`invalid-input`):e.outcome===`failed`&&_.fail(p?x?.error:void 0,x===void 0?e.outcome:void 0),e}catch(e){throw _.fail(p?e:void 0),e}finally{_.end()}}const silentObserver={executed:async()=>{},executing:async()=>{},failedWith:()=>{}};function toolCallEvents(e,t,n){let r=e.capturesInputs??e.capturesContent,i=e.capturesOutputs??e.capturesContent,a=toolCallIdempotencyKey(t,n.callId,0);return{async run(o,s){let c,l,u={async executing(e){if(s?.recordInputs){let t=contentAttribute(e);t!==void 0&&s.span.setAttribute(`gen_ai.tool.call.arguments`,t)}},async executed(e){c=e.durationMs,s?.span.setAttribute(`gen_ai.execute_tool.duration`,c/1e3)},failedWith(e){l=e,s?.failedWith(e)}};await e.publish({capability:{kind:`tool`,name:n.toolName},callId:n.callId,frameworkTool:!1,idempotencyKey:a,input:r?n.input:void 0,scope:t,toolName:n.toolName,type:`call.requested`});let d;try{d=await o(u)}catch(n){throw await e.publish({durationMs:c,error:i?n:void 0,idempotencyKey:a,outcome:`failed`,scope:t,type:`call.settled`}),n}return await e.publish({durationMs:c,idempotencyKey:a,outcome:d.outcome,scope:t,type:`call.settled`,reason:d.outcome===`rejected`?d.reason:void 0,cause:d.outcome===`rejected`?d.cause:void 0,error:i&&d.outcome===`failed`?l??d.error:void 0,output:i&&d.outcome===`completed`?d.output:void 0}),d}}}function setDefined(e,t){for(let[n,r]of Object.entries(t))r!==void 0&&e.setAttribute(n,r)}export{withInvokeToolSpan};

package/dist/src/tracing/eve/otel-declaration.d.ts

@@ -1,8 +1,7 @@
-import type { MetricReader, PropagatorOrName, SamplerOrName, SpanExporter, SpanProcessor, SpanProcessorOrName } from "#compiled/@vercel/otel/index.js";
-import { type InstrumentationProvider } from "#public/instrumentation/provider.js";
-import type { InstrumentationRuntimeContextInput } from "#public/instrumentation/index.js";
+import { type InstrumentationProvider } from "#instrumentation/provider.js";
+import type { InstrumentationModelStartedInput } from "#public/instrumentation/index.js";
 import type { JsonObject } from "#shared/json.js";
-import type { OtelConfiguration } from "#tracing/eve/otel-configuration.js";
+import type { MetricReader, SpanExporter, SpanProcessor, OtelConfiguration, PropagatorOrName as PropagatorSetting, SamplerOrName as SamplerSetting, SpanProcessorOrName as SpanProcessorSetting } from "#tracing/eve/otel-configuration.js";
 import type { TraceCapturePolicy } from "#shared/trace-policy.js";
 export type { TraceCaptureContext, TraceCapturePolicy, TracePolicyDecision, } from "#shared/trace-policy.js";
 import type { SpanExportPolicy } from "#tracing/eve/span-export-policy.js";
@@ -62,9 +61,9 @@ export interface OtelOptions {
      * along with your exporters. To thin one backend only, drop spans in a
      * processor.
      */
-    readonly sampler?: SamplerOrName;
+    readonly sampler?: SamplerSetting;
     /** Composed into one propagator. All inject; the first to extract wins. Defaults to `auto`. */
-    readonly propagators?: readonly PropagatorOrName[];
+    readonly propagators?: readonly PropagatorSetting[];
     /**
      * OpenTelemetry `Instrumentation` instances passed through to
      * `registerOTel` before the server entry loads. Disabled by default.
@@ -101,7 +100,7 @@ export interface OtelIntegrationOptions extends ManagedTraceOptions {
      * Keys beginning with `eve.` are reserved and dropped. Return `undefined`
      * to contribute nothing.
      */
-    readonly runtimeContext?: (input: InstrumentationRuntimeContextInput) => JsonObject | undefined;
+    readonly runtimeContext?: (input: InstrumentationModelStartedInput) => JsonObject | undefined;
 }
 declare const OTEL_DECLARATION: unique symbol;
 declare const OTEL_INTEGRATION: unique symbol;
@@ -117,8 +116,8 @@ export interface OtelDeclaration extends InstrumentationProvider {
 export interface OtelIntegration extends InstrumentationProvider {
     readonly [OTEL_INTEGRATION]: true;
     readonly metricReaders: readonly MetricReader[];
-    readonly runtimeContext?: (input: InstrumentationRuntimeContextInput) => JsonObject | undefined;
-    readonly spanProcessors: readonly SpanProcessorOrName[];
+    readonly runtimeContext?: (input: InstrumentationModelStartedInput) => JsonObject | undefined;
+    readonly spanProcessors: readonly SpanProcessorSetting[];
 }
 /**
  * Declares the process-wide OpenTelemetry settings.
@@ -157,7 +156,7 @@ export interface OtelHarnessSettings {
     readonly recordOutputs: boolean;
 }
 /** @internal */
-export type RuntimeContextResolver = (input: InstrumentationRuntimeContextInput) => JsonObject | undefined;
+export type RuntimeContextResolver = (input: InstrumentationModelStartedInput) => JsonObject | undefined;
 /** @internal */
 export interface CollectedOtel {
     /**

package/dist/src/tracing/eve/otel-declaration.js

@@ -1 +1 @@
-import{createLogger,formatError}from"#internal/logging.js";import{PROVIDER}from"#public/instrumentation/provider.js";import{batchSpanProcessor}from"#tracing/eve/batch-span-processor.js";import{contentFilteringProcessor}from"#tracing/eve/content-span-processor.js";import{vercelRuntimeSpanProcessor}from"#tracing/eve/vercel-runtime-span-exporter.js";const log=createLogger(`tracing.export`),OTEL_DECLARATION=Symbol.for(`eve.instrumentation.otel`),OTEL_INTEGRATION=Symbol.for(`eve.instrumentation.otel-integration`);function otel(e={}){return{[OTEL_DECLARATION]:!0,[PROVIDER]:!0,options:e}}function otelIntegration(e={}){return createOtelIntegration(e)}function managedOtelIntegration(e={}){return createOtelIntegration(e)}function createOtelIntegration(e){assertNoRemovedContentOptions(e);let t=e.spanProcessors??[],n=e.traceExporter===void 0?t:[...t,batchSpanProcessor(e.traceExporter,{diagnostic:(e,t)=>log.warn(e,{...t,error:t.error===void 0?void 0:formatError(t.error)})})];return{[OTEL_INTEGRATION]:!0,[PROVIDER]:!0,metricReaders:e.metricReaders??[],runtimeContext:e.runtimeContext,spanProcessors:n.map(t=>contentFilteringProcessor(t,e.exportPolicy))}}function agentRunsIntegration(e={}){return assertNoRemovedContentOptions(e),{[OTEL_INTEGRATION]:!0,[PROVIDER]:!0,metricReaders:[],spanProcessors:[contentFilteringProcessor(vercelRuntimeSpanProcessor(),e.exportPolicy)]}}function assertNoRemovedContentOptions(e){if(Object.hasOwn(e,`recordInputs`)||Object.hasOwn(e,`recordOutputs`))throw Error("OpenTelemetry destination options no longer support `recordInputs` or `recordOutputs`. Use an `exportPolicy` span decision with `{ redact: true, inputs: true }`, `{ redact: true, outputs: true }`, or both.")}function isOtelDeclaration(e){return typeof e==`object`&&!!e&&e[OTEL_DECLARATION]===!0}function isOtelIntegration(e){return typeof e==`object`&&!!e&&e[OTEL_INTEGRATION]===!0}function collectOtelPipeline(e){let t=[],n=[],r=[],i,a=!1,o=!1;for(let s of e){if(isOtelIntegration(s)){a=!0,o=!0,t.push(...s.spanProcessors),n.push(...s.metricReaders),s.runtimeContext!==void 0&&r.push(s.runtimeContext);continue}if(isOtelDeclaration(s)){if(i!==void 0)throw Error("Instrumentation declares `otel()` more than once. One process has one OpenTelemetry tracer provider, so it has one resource, one sampler, and one propagator set — declare them in a single `otel()`.");a=!0,i=s}}let s=i?.options??{},c={functionId:s.functionId,recordInputs:o,recordOutputs:o,traceChannelRequests:s.traceChannelRequests===!0};return s.tracePolicy!==void 0&&Object.assign(c,{tracePolicy:s.tracePolicy}),{declared:a,configuration:{instrumentations:s.instrumentations,metricReaders:n.length>0?n:void 0,propagators:s.propagators,resource:s.resource,sampler:s.sampler,spanProcessors:t},runtimeContextResolvers:r,settings:c}}export{agentRunsIntegration,collectOtelPipeline,isOtelDeclaration,isOtelIntegration,managedOtelIntegration,otel,otelIntegration};
+import{createLogger,formatError}from"#internal/logging.js";import{PROVIDER}from"#instrumentation/provider.js";import{batchSpanProcessor}from"#tracing/eve/batch-span-processor.js";import{contentFilteringProcessor}from"#tracing/eve/content-span-processor.js";import{vercelRuntimeSpanProcessor}from"#tracing/eve/vercel-runtime-span-exporter.js";const log=createLogger(`tracing.export`),OTEL_DECLARATION=Symbol.for(`eve.instrumentation.otel`),OTEL_INTEGRATION=Symbol.for(`eve.instrumentation.otel-integration`);function otel(e={}){return{[OTEL_DECLARATION]:!0,[PROVIDER]:!0,options:e}}function otelIntegration(e={}){return createOtelIntegration(e)}function managedOtelIntegration(e={}){return createOtelIntegration(e)}function createOtelIntegration(e){assertNoRemovedContentOptions(e);let t=e.spanProcessors??[],n=e.traceExporter===void 0?t:[...t,batchSpanProcessor(e.traceExporter,{diagnostic:(e,t)=>log.warn(e,{...t,error:t.error===void 0?void 0:formatError(t.error)})})];return{[OTEL_INTEGRATION]:!0,[PROVIDER]:!0,metricReaders:e.metricReaders??[],runtimeContext:e.runtimeContext,spanProcessors:n.map(t=>contentFilteringProcessor(t,e.exportPolicy))}}function agentRunsIntegration(e={}){return assertNoRemovedContentOptions(e),{[OTEL_INTEGRATION]:!0,[PROVIDER]:!0,metricReaders:[],spanProcessors:[contentFilteringProcessor(vercelRuntimeSpanProcessor(),e.exportPolicy)]}}function assertNoRemovedContentOptions(e){if(Object.hasOwn(e,`recordInputs`)||Object.hasOwn(e,`recordOutputs`))throw Error("OpenTelemetry destination options no longer support `recordInputs` or `recordOutputs`. Use an `exportPolicy` span decision with `{ redact: true, inputs: true }`, `{ redact: true, outputs: true }`, or both.")}function isOtelDeclaration(e){return typeof e==`object`&&!!e&&e[OTEL_DECLARATION]===!0}function isOtelIntegration(e){return typeof e==`object`&&!!e&&e[OTEL_INTEGRATION]===!0}function collectOtelPipeline(e){let t=[],n=[],r=[],i,a=!1,o=!1;for(let s of e){if(isOtelIntegration(s)){a=!0,o=!0,t.push(...s.spanProcessors),n.push(...s.metricReaders),s.runtimeContext!==void 0&&r.push(s.runtimeContext);continue}if(isOtelDeclaration(s)){if(i!==void 0)throw Error("Instrumentation declares `otel()` more than once. One process has one OpenTelemetry tracer provider, so it has one resource, one sampler, and one propagator set — declare them in a single `otel()`.");a=!0,i=s}}let s=i?.options??{},c={functionId:s.functionId,recordInputs:o,recordOutputs:o,traceChannelRequests:s.traceChannelRequests===!0};return s.tracePolicy!==void 0&&Object.assign(c,{tracePolicy:s.tracePolicy}),{declared:a,configuration:{instrumentations:s.instrumentations,metricReaders:n.length>0?n:void 0,propagators:s.propagators,resource:s.resource,sampler:s.sampler,spanProcessors:t},runtimeContextResolvers:r,settings:c}}export{agentRunsIntegration,collectOtelPipeline,isOtelDeclaration,isOtelIntegration,managedOtelIntegration,otel,otelIntegration};

package/dist/src/tracing/eve/policy.d.ts

@@ -1,4 +1,4 @@
-import type { InstrumentationEvent, InstrumentationAttemptScope } from "#instrumentation/lifecycle.js";
+import type { InstrumentationEvent, InstrumentationScope } from "#instrumentation/lifecycle.js";
 import type { AgentTraceStateStore } from "#tracing/eve/agent-trace-state.js";
 import type { ConversationEnvironment } from "#shared/conversation-context.js";
 export declare function createEveCapturePolicy(input: {
@@ -8,7 +8,7 @@ export declare function createEveCapturePolicy(input: {
     readonly recordOutputs: boolean;
 }): {
     projectEvent(event: InstrumentationEvent): Promise<InstrumentationEvent>;
-    forOperation(scope: Pick<InstrumentationAttemptScope, "sessionId" | "channelAudience">): Promise<{
+    forOperation(scope: Pick<InstrumentationScope, "sessionId" | "channelAudience">): Promise<{
         recordInputs: boolean;
         recordOutputs: boolean;
     }>;