eve 0.78.0 → 0.79.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # eve
 
+## 0.79.0
+
+### Minor Changes
+
+- bc2be45: Adds `t.score(evaluation)` for recording a score from 0 to 1, named with `.label(key)` and gated with `.gate()` or `.atLeast()`. `AssertionResult` gains `key`, and `score`, `threshold`, and `passed` are now optional: `score` is absent when the scorer threw, and `threshold` and `passed` are absent when no rule applies, so custom reporters should treat `passed === false` as the failure signal. `eve eval` warns when soft assertions in one eval share a name with different scores.
+
+### Patch Changes
+
+- 76f6854: eve's agent spans now come from the shared tracing library, and durable turns recover from one checkpoint per turn. Each tool call is still one `execute_tool` span, a local subagent's first turn still nests under its caller, and trace schema version 4 is unchanged.
+- f5e5183: Connection approval policies now receive `toolAnnotations`, the hints an MCP server declared for the called tool (such as `readOnlyHint` and `destructiveHint`), so a policy can skip approval for read-only tools. It is `undefined` when the server declares none.
+- 302a4d3: Tools can now define `approval.prompt` to show a human-readable, input-aware summary in approval requests. Slack keeps the complete tool input available in a collapsed block below the approval card.
+- 422b628: Extract reusable agent tracing with wrapped execution, model stream completion, remote delegation, and durable turns that save and resume themselves through a checkpointer. Preserve trace schema version 4 while sharing one span lifecycle with eve.
+- 485d0f5: The agent tracing library now writes schema 4's `agent.action.kind`, `agent.action.name`, and `agent.action.outcome` on tool and approval spans itself, so hosts other than eve render correctly in Agent Runs. eve's trace output is unchanged.
+
 ## 0.78.0
 
 ### Minor Changes

package/dist/src/approval/definition.d.ts

@@ -4,6 +4,17 @@ import type { ToolAuthOptions, ToolAuthProvider } from "#tools/auth.js";
 import type { SessionContext } from "#context/session-context.js";
 import type { TokenResult } from "#shared/connection-types.js";
 type ApprovalToolInput<TInput> = TInput extends object ? Readonly<TInput> : TInput;
+/** Context passed to an approval prompt callback. */
+export interface ApprovalPromptContext<TInput = Record<string, unknown>> {
+    /** Id of the tool call awaiting approval. */
+    readonly callId: string;
+    /** Validated input proposed for the tool call. */
+    readonly input: TInput;
+    /** Final runtime name of the tool. */
+    readonly toolName: string;
+}
+/** Builds the human-readable prompt shown when a tool call requires approval. */
+export type ApprovalPrompt<TInput = Record<string, unknown>> = (context: ApprovalPromptContext<TInput>) => string;
 /**
  * Context passed to an {@link ApprovalPolicy} function.
  *
@@ -15,9 +26,33 @@ export interface ApprovalContext<TInput = Record<string, unknown>> extends Sessi
     readonly abortSignal: AbortSignal;
     readonly approvedTools: ReadonlySet<string>;
     readonly callId: string;
+    /**
+     * Behavior hints the connection's server declared for this tool, such as
+     * MCP's `readOnlyHint` and `destructiveHint`. Absent for authored tools and
+     * for servers that declare none. Hints are only as trustworthy as the server.
+     */
+    readonly toolAnnotations?: ConnectionToolAnnotations;
     readonly toolInput?: ApprovalToolInput<TInput>;
     readonly toolName: string;
 }
+/**
+ * Behavior hints a connection's server declares for one of its tools. The
+ * named fields follow MCP's `ToolAnnotations`; other keys pass through as the
+ * server sent them.
+ */
+export interface ConnectionToolAnnotations {
+    /** Human-readable tool title. */
+    readonly title?: string;
+    /** The tool does not modify its environment. */
+    readonly readOnlyHint?: boolean;
+    /** The tool may perform destructive updates. Meaningful only when not read-only. */
+    readonly destructiveHint?: boolean;
+    /** Repeating a call with the same arguments has no additional effect. */
+    readonly idempotentHint?: boolean;
+    /** The tool may interact with an open world of external entities. */
+    readonly openWorldHint?: boolean;
+    readonly [key: string]: unknown;
+}
 /** Request-time approval decision returned by an {@link ApprovalPolicy}. */
 export type ApprovalStatus = undefined | boolean | "not-applicable" | "approved" | "denied" | "user-approval" | {
     readonly type: "not-applicable";
@@ -95,6 +130,13 @@ export interface ApprovalConfiguration<TInput = Record<string, unknown>> {
 }
 /** Shared approval definition used by authored tools and connections. */
 export type Approval<TInput = Record<string, unknown>> = ApprovalPolicy<TInput> | ApprovalConfiguration<TInput>;
+/** Approval configuration for a tool, including its optional presentation prompt. */
+export interface ToolApprovalConfiguration<TInput = Record<string, unknown>> extends ApprovalConfiguration<TInput> {
+    /** Optional human-readable prompt shown when this tool requires approval. */
+    readonly prompt?: ApprovalPrompt<TInput>;
+}
+/** Approval definition used by authored tools. */
+export type ToolApproval<TInput = Record<string, unknown>> = ApprovalPolicy<TInput> | ToolApprovalConfiguration<TInput>;
 /** Returns the request-time policy from either approval authoring shape. */
 export declare function resolveApprovalPolicy<TInput>(approval: Approval<TInput>): ApprovalPolicy<TInput>;
 export {};

package/dist/src/cli/commands/trace-detail.d.ts

@@ -3,8 +3,8 @@
  * module: the tree renderer stays compact while these helpers answer "what
  * does this span carry" — inline metric chips and the `--verbose` per-span block.
  */
-import type { LocalTraceSpan } from "#tracing/local-trace-reader.js";
-import { type LocalTraceSummary } from "#tracing/local-trace-summary.js";
+import type { LocalTraceSpan } from "#tracing/local/trace-reader.js";
+import { type LocalTraceSummary } from "#tracing/local/trace-summary.js";
 /**
  * Compact metrics for one tree row: token chips (`↑1.4K`/`↓213`), cost
  * (`$0.0031`). Only chips whose attributes the span actually carries — rows

package/dist/src/cli/commands/trace-detail.js

@@ -1 +1 @@
-import{sanitizeForTerminal}from"#cli/ui/output.js";import{formatElapsed}from"#cli/format-elapsed.js";import{formatCompactTokenCount}from"#cli/dev/tui/stream-format.js";import{formatAttributeContent}from"#cli/dev/tui/traces/trace-content.js";import{localTraceSpanCostUsd}from"#tracing/local-trace-summary.js";function spanMetricChips(e){let t=[],n=e.attributes[`gen_ai.operation.name`],r=n===`chat`||n===`invoke_agent`?`gen_ai.usage`:`agent.usage`,i=numberAttribute(e,`${r}.input_tokens`),a=numberAttribute(e,`${r}.output_tokens`);i!==void 0&&t.push(`↑${formatCompactTokenCount(i)}`),a!==void 0&&t.push(`↓${formatCompactTokenCount(a)}`);let o=localTraceSpanCostUsd(e);return o!==void 0&&t.push(formatCostUsd(o)),t}function formatTokenSummary(e){let t=[`↑${formatCompactTokenCount(e.inputTokens)} in`,`↓${formatCompactTokenCount(e.outputTokens)} out`];return e.cacheReadTokens>0&&t.push(`${formatCompactTokenCount(e.cacheReadTokens)} cached`),e.cacheWriteTokens>0&&t.push(`${formatCompactTokenCount(e.cacheWriteTokens)} cache write`),t.join(` · `)}function formatCostUsd(e){return e>=1?`$${e.toFixed(2)}`:`$${e.toFixed(4)}`}function renderSpanDetailTree(e,t){let n=spanDetailEntries(e,t.width-t.margin.length-3),r=[];return n.forEach((e,r)=>{let i=r===n.length-1&&!t.childrenFollow;emit(e,t.margin,i?`└─ `:`├─ `)}),r;function emit(e,n,i){r.push(t.mute(`${n}${i}${e.head}`));let a=`${n}${i===`└─ `?`   `:`│  `}`;for(let n of e.lines)r.push(t.mute(`${a}  ${n}`));e.entries.forEach((t,n)=>{emit(t,a,n===e.entries.length-1?`└─ `:`├─ `)})}}function spanDetailEntries(e,t){let dim=e=>e,n=Math.max(40,t),r=[],push=(e,t=[],n=[])=>{r.push({entries:n,head:e,lines:t})},i=e.statusCode===2;push(`status: ${i&&e.statusMessage!==void 0?`ERROR — ${sanitizeForTerminal(e.statusMessage)}`:i?`ERROR`:`ok`}`),push(`duration: ${formatElapsed(durationMs(e.startTimeNs,e.endTimeNs))}`),push(`started: ${new Date(Number(e.startTimeNs/1000000n)).toISOString()}`),push(`span: ${e.spanId}`),e.parentSpanId!==void 0&&push(`parent: ${e.parentSpanId}`),e.scope!==void 0&&push(`scope: ${sanitizeForTerminal(e.scope)}`),e.kind!==void 0&&e.kind!==1&&push(`kind: ${spanKind(e.kind)}`);for(let t of Object.keys(e.attributes).sort()){let r=formatAttributeContent(t,e.attributes[t],dim,n-2),i=sanitizeForTerminal(t);r.length===1?push(`${i}: ${r[0]}`):push(`${i}:`,r)}return e.events.length>0&&push(`events:`,[],e.events.map(t=>{let r=Math.max(0,durationMs(e.startTimeNs,t.timeNs)),i=[];for(let e of Object.keys(t.attributes).sort()){let r=formatAttributeContent(e,t.attributes[e],dim,n-6),a=sanitizeForTerminal(e);r.length===1?i.push(`${a}: ${r[0]}`):i.push(`${a}:`,...r.map(e=>`  ${e}`))}return{entries:[],head:`${sanitizeForTerminal(t.name)}  +${formatElapsed(r)}`,lines:i}})),r}function spanKind(e){switch(e){case 2:return`server`;case 3:return`client`;case 4:return`producer`;case 5:return`consumer`;default:return`unknown (${e})`}}function numberAttribute(e,t){let n=e.attributes[t];if(typeof n==`number`)return n;if(typeof n==`string`&&n!==``){let e=Number(n);return Number.isFinite(e)?e:void 0}}function durationMs(e,t){return Number(t-e)/1e6}export{formatCostUsd,formatTokenSummary,renderSpanDetailTree,spanMetricChips};
+import{sanitizeForTerminal}from"#cli/ui/output.js";import{formatElapsed}from"#cli/format-elapsed.js";import{formatCompactTokenCount}from"#cli/dev/tui/stream-format.js";import{formatAttributeContent}from"#cli/dev/tui/traces/trace-content.js";import{localTraceSpanCostUsd}from"#tracing/local/trace-summary.js";function spanMetricChips(e){let t=[],n=e.attributes[`gen_ai.operation.name`],r=n===`chat`||n===`invoke_agent`?`gen_ai.usage`:`agent.usage`,i=numberAttribute(e,`${r}.input_tokens`),a=numberAttribute(e,`${r}.output_tokens`);i!==void 0&&t.push(`↑${formatCompactTokenCount(i)}`),a!==void 0&&t.push(`↓${formatCompactTokenCount(a)}`);let o=localTraceSpanCostUsd(e);return o!==void 0&&t.push(formatCostUsd(o)),t}function formatTokenSummary(e){let t=[`↑${formatCompactTokenCount(e.inputTokens)} in`,`↓${formatCompactTokenCount(e.outputTokens)} out`];return e.cacheReadTokens>0&&t.push(`${formatCompactTokenCount(e.cacheReadTokens)} cached`),e.cacheWriteTokens>0&&t.push(`${formatCompactTokenCount(e.cacheWriteTokens)} cache write`),t.join(` · `)}function formatCostUsd(e){return e>=1?`$${e.toFixed(2)}`:`$${e.toFixed(4)}`}function renderSpanDetailTree(e,t){let n=spanDetailEntries(e,t.width-t.margin.length-3),r=[];return n.forEach((e,r)=>{let i=r===n.length-1&&!t.childrenFollow;emit(e,t.margin,i?`└─ `:`├─ `)}),r;function emit(e,n,i){r.push(t.mute(`${n}${i}${e.head}`));let a=`${n}${i===`└─ `?`   `:`│  `}`;for(let n of e.lines)r.push(t.mute(`${a}  ${n}`));e.entries.forEach((t,n)=>{emit(t,a,n===e.entries.length-1?`└─ `:`├─ `)})}}function spanDetailEntries(e,t){let dim=e=>e,n=Math.max(40,t),r=[],push=(e,t=[],n=[])=>{r.push({entries:n,head:e,lines:t})},i=e.statusCode===2;push(`status: ${i&&e.statusMessage!==void 0?`ERROR — ${sanitizeForTerminal(e.statusMessage)}`:i?`ERROR`:`ok`}`),push(`duration: ${formatElapsed(durationMs(e.startTimeNs,e.endTimeNs))}`),push(`started: ${new Date(Number(e.startTimeNs/1000000n)).toISOString()}`),push(`span: ${e.spanId}`),e.parentSpanId!==void 0&&push(`parent: ${e.parentSpanId}`),e.scope!==void 0&&push(`scope: ${sanitizeForTerminal(e.scope)}`),e.kind!==void 0&&e.kind!==1&&push(`kind: ${spanKind(e.kind)}`);for(let t of Object.keys(e.attributes).sort()){let r=formatAttributeContent(t,e.attributes[t],dim,n-2),i=sanitizeForTerminal(t);r.length===1?push(`${i}: ${r[0]}`):push(`${i}:`,r)}return e.events.length>0&&push(`events:`,[],e.events.map(t=>{let r=Math.max(0,durationMs(e.startTimeNs,t.timeNs)),i=[];for(let e of Object.keys(t.attributes).sort()){let r=formatAttributeContent(e,t.attributes[e],dim,n-6),a=sanitizeForTerminal(e);r.length===1?i.push(`${a}: ${r[0]}`):i.push(`${a}:`,...r.map(e=>`  ${e}`))}return{entries:[],head:`${sanitizeForTerminal(t.name)}  +${formatElapsed(r)}`,lines:i}})),r}function spanKind(e){switch(e){case 2:return`server`;case 3:return`client`;case 4:return`producer`;case 5:return`consumer`;default:return`unknown (${e})`}}function numberAttribute(e,t){let n=e.attributes[t];if(typeof n==`number`)return n;if(typeof n==`string`&&n!==``){let e=Number(n);return Number.isFinite(e)?e:void 0}}function durationMs(e,t){return Number(t-e)/1e6}export{formatCostUsd,formatTokenSummary,renderSpanDetailTree,spanMetricChips};

package/dist/src/cli/commands/trace.d.ts

@@ -1,4 +1,4 @@
-import type { LocalTrace } from "#tracing/local-trace-reader.js";
+import type { LocalTrace } from "#tracing/local/trace-reader.js";
 interface CliTraceLogger {
     error(message: string): void;
     log(message: string): void;

package/dist/src/cli/commands/trace.js

@@ -1,4 +1,4 @@
-import{basename}from"node:path";import{createCliTheme,renderCliSection,sanitizeForTerminal}from"#cli/ui/output.js";import{formatElapsed}from"#cli/format-elapsed.js";import{summarizeLocalTrace}from"#tracing/local-trace-summary.js";import{formatCostUsd,formatTokenSummary,renderSpanDetailTree,spanMetricChips}from"#cli/commands/trace-detail.js";import{compareLocalTraceSpans,describeLocalTraceSpan,listLocalTraces}from"#tracing/local-trace-reader.js";const TRACE_DISPLAY_DIRECTORY=`.eve/traces/v1`;function resolveLocalTraces(e,t){let n=t.replaceAll(`\\`,`/`),r=basename(n),i=n===r?[n]:[n,r],a=e.find(e=>i.includes(e.traceId));if(a!==void 0)return[a];let o=e.filter(e=>e.conversationIds.some(e=>i.includes(e)));if(o.length>0)return orderWindows(o);let s=e.filter(e=>i.some(t=>e.traceId.startsWith(t)||e.conversationIds.some(e=>e.startsWith(t))));if(s.length===0)throw Error(`No local trace matches "${sanitizeForTerminal(t)}". Run \`eve traces list\` to list traces.`);if(s.length===1)return s;if(new Set(s.map(e=>e.conversationId??e.traceId)).size>1)throw ambiguousTraceError(s,t);return orderWindows(s)}function orderWindows(e){return[...e].sort((e,t)=>e.startTimeNs===t.startTimeNs?e.traceId.localeCompare(t.traceId):e.startTimeNs<t.startTimeNs?-1:1)}async function runTraceListCommand(e,t,n={}){let r=await listLocalTraces(t);if(n.json===!0){e.log(JSON.stringify(r.map(e=>({agentName:e.agentName??null,durationMs:durationMs(e.startTimeNs,e.endTimeNs),conversationId:e.conversationId??null,spanCount:e.spans.length,startedAt:toDate(e.startTimeNs).toISOString(),traceId:e.traceId})),null,2));return}if(r.length===0){e.log(`No local traces found under ${TRACE_DISPLAY_DIRECTORY}.`);return}let i=r.map(e=>[e.traceId,sanitizeForTerminal(e.conversationId??`unknown`),sanitizeForTerminal(e.agentName??`unknown`),toDate(e.startTimeNs).toISOString(),formatElapsed(durationMs(e.startTimeNs,e.endTimeNs)),String(e.spans.length)]),a=[`TRACE`,`CONVERSATION`,`AGENT`,`STARTED`,`DURATION`,`SPANS`],o=a.map((e,t)=>Math.max(e.length,...i.map(e=>e[t].length)));e.log([a,...i].map(e=>e.map((e,t)=>e.padEnd(o[t])).join(`  `).trimEnd()).join(`
+import{basename}from"node:path";import{createCliTheme,renderCliSection,sanitizeForTerminal}from"#cli/ui/output.js";import{formatElapsed}from"#cli/format-elapsed.js";import{summarizeLocalTrace}from"#tracing/local/trace-summary.js";import{formatCostUsd,formatTokenSummary,renderSpanDetailTree,spanMetricChips}from"#cli/commands/trace-detail.js";import{compareLocalTraceSpans,describeLocalTraceSpan,listLocalTraces}from"#tracing/local/trace-reader.js";const TRACE_DISPLAY_DIRECTORY=`.eve/traces/v1`;function resolveLocalTraces(e,t){let n=t.replaceAll(`\\`,`/`),r=basename(n),i=n===r?[n]:[n,r],a=e.find(e=>i.includes(e.traceId));if(a!==void 0)return[a];let o=e.filter(e=>e.conversationIds.some(e=>i.includes(e)));if(o.length>0)return orderWindows(o);let s=e.filter(e=>i.some(t=>e.traceId.startsWith(t)||e.conversationIds.some(e=>e.startsWith(t))));if(s.length===0)throw Error(`No local trace matches "${sanitizeForTerminal(t)}". Run \`eve traces list\` to list traces.`);if(s.length===1)return s;if(new Set(s.map(e=>e.conversationId??e.traceId)).size>1)throw ambiguousTraceError(s,t);return orderWindows(s)}function orderWindows(e){return[...e].sort((e,t)=>e.startTimeNs===t.startTimeNs?e.traceId.localeCompare(t.traceId):e.startTimeNs<t.startTimeNs?-1:1)}async function runTraceListCommand(e,t,n={}){let r=await listLocalTraces(t);if(n.json===!0){e.log(JSON.stringify(r.map(e=>({agentName:e.agentName??null,durationMs:durationMs(e.startTimeNs,e.endTimeNs),conversationId:e.conversationId??null,spanCount:e.spans.length,startedAt:toDate(e.startTimeNs).toISOString(),traceId:e.traceId})),null,2));return}if(r.length===0){e.log(`No local traces found under ${TRACE_DISPLAY_DIRECTORY}.`);return}let i=r.map(e=>[e.traceId,sanitizeForTerminal(e.conversationId??`unknown`),sanitizeForTerminal(e.agentName??`unknown`),toDate(e.startTimeNs).toISOString(),formatElapsed(durationMs(e.startTimeNs,e.endTimeNs)),String(e.spans.length)]),a=[`TRACE`,`CONVERSATION`,`AGENT`,`STARTED`,`DURATION`,`SPANS`],o=a.map((e,t)=>Math.max(e.length,...i.map(e=>e[t].length)));e.log([a,...i].map(e=>e.map((e,t)=>e.padEnd(o[t])).join(`  `).trimEnd()).join(`
 `))}async function runTraceShowCommand(e,t,n,r={}){let i=await listLocalTraces(t);if(i.length===0){let t=`No local traces found under ${TRACE_DISPLAY_DIRECTORY}.`;if(n!==void 0)throw Error(t);e.log(t);return}let a=n===void 0?[i[0]]:resolveLocalTraces(i,n);if(r.json===!0){e.log(JSON.stringify(a.map(serializeTraceForJson),null,2));return}let o=createCliTheme();e.log(a.map(e=>[renderCliSection(o,{rows:traceHeaderRows(e),title:`Trace`}),`${o.accent(`Spans`)}\n${renderSpanTree(e.spans,{dim:o.muted,verbose:r.verbose===!0})}`].join(`
 
 `)).join(`

package/dist/src/cli/dev/tui/traces/trace-conversation.d.ts

@@ -4,7 +4,7 @@
  * latency waterfall. Activation and tool spans provide the user and tool
  * cards directly; model response spans provide assistant cards.
  */
-import type { LocalTrace, LocalTraceSpan } from "#tracing/local-trace-reader.js";
+import type { LocalTrace, LocalTraceSpan } from "#tracing/local/trace-reader.js";
 import type { Theme } from "../theme.js";
 import type { TraceViewerSurfaces } from "./trace-surfaces.js";
 export interface ConversationItem {

package/dist/src/cli/dev/tui/traces/trace-conversation.js

@@ -1,3 +1,3 @@
-import{formatCompactTokenCount}from"../stream-format.js";import{formatPayloadContent,wrapPlainText}from"./trace-content.js";import{SURFACE_CLOSE}from"./trace-surfaces.js";import{formatElapsed}from"#cli/format-elapsed.js";import{clipVisible,stripTerminalControls,visibleLength}from"#cli/ui/terminal-text.js";import{localTraceSpanCostUsd}from"#tracing/local-trace-summary.js";import{formatCostUsd}from"#cli/commands/trace-detail.js";import{compareLocalTraceSpans,isAgentTurnSpan}from"#tracing/local-trace-reader.js";import{agentTurnIdentity}from"#tracing/agent-span-contract.js";import{traceStringAttribute}from"#tracing/local-trace-operations.js";function buildConversationItems(e){let t=new Map(e.spans.map(e=>[e.spanId,e])),n=new Map;for(let r of e.spans){if(!isAgentTurnSpan(r))continue;let e=agentTurnIdentity(r),i=turnSubagent(r,t);e!==void 0&&i!==void 0&&n.set(e,i)}let r=[],i;for(let t of[...e.spans].sort(compareLocalTraceSpans)){let e=isModelSpan(t)?systemInstructionsText(t.attributes):void 0;if(e!==void 0){i={span:t,text:e};break}}i!==void 0&&r.push({item:{kind:`system`,durationMs:0,error:!1,span:i.span,subagent:subagentFor(i.span,n,t),text:i.text},order:0n});for(let i of e.spans){let e=subagentFor(i,n,t),a=stringAttribute(i,`agent.channel.delivery.input`);if(a!==void 0){let t=deliveryText(a);if(t===void 0)continue;r.push({item:{kind:`user`,durationMs:0,error:!1,span:i,subagent:e,text:t},order:i.startTimeNs});continue}if(isModelSpan(i)){let n=stringAttribute(i,`ai.response.text`),a=stringAttribute(i,`ai.response.reasoning`),o=numberAttribute(i,`gen_ai.usage.input_tokens`),s=numberAttribute(i,`gen_ai.usage.output_tokens`),c=o!==void 0||s!==void 0,l=i.attributes[`ai.response.tool_calls`]!==void 0;if((n===void 0||n.trim().length===0)&&(a===void 0||a.trim().length===0)&&!c&&!l&&i.statusCode!==2)continue;r.push({item:{kind:`assistant`,costUsd:stepCostUsd(i,t),durationMs:spanDurationMs(i),error:i.statusCode===2,inputTokens:o,model:stringAttribute(i,`gen_ai.request.model`),outputTokens:s,reasoning:a,span:i,subagent:e,text:n,toolCallNames:l?parseToolCallNames(stringAttribute(i,`ai.response.tool_calls`)):void 0},order:i.startTimeNs});for(let t of parseProviderToolResults(stringAttribute(i,`ai.response.tool_results`)))r.push({item:{kind:`tool`,args:t.args,durationMs:0,error:t.error,name:stripTerminalControls(t.name),result:t.result,span:i,subagent:e},order:i.startTimeNs});continue}(i.attributes[`gen_ai.operation.name`]===`execute_tool`||i.name===`agent.action`)&&r.push({item:{kind:`tool`,args:stringAttribute(i,`gen_ai.tool.call.arguments`),durationMs:spanDurationMs(i),error:i.statusCode===2,name:stripTerminalControls(stringAttribute(i,`gen_ai.tool.name`)??stringAttribute(i,`agent.action.name`)??`tool`),result:unwrapJsonString(stringAttribute(i,`gen_ai.tool.call.result`)),span:i,subagent:e},order:i.startTimeNs})}return r.sort((e,t)=>e.order===t.order?0:e.order<t.order?-1:1).map(e=>e.item)}function systemInstructionsText(e){let t=e[`gen_ai.system_instructions`];if(typeof t==`string`)try{let e=JSON.parse(t);if(!Array.isArray(e))return;let n=e.flatMap(e=>typeof e!=`object`||!e||!(`type`in e)||e.type!==`text`||!(`content`in e)||typeof e.content!=`string`?[]:[e.content]).join(`
+import{formatCompactTokenCount}from"../stream-format.js";import{formatPayloadContent,wrapPlainText}from"./trace-content.js";import{SURFACE_CLOSE}from"./trace-surfaces.js";import{formatElapsed}from"#cli/format-elapsed.js";import{clipVisible,stripTerminalControls,visibleLength}from"#cli/ui/terminal-text.js";import{localTraceSpanCostUsd}from"#tracing/local/trace-summary.js";import{formatCostUsd}from"#cli/commands/trace-detail.js";import{compareLocalTraceSpans,isAgentTurnSpan}from"#tracing/local/trace-reader.js";import{agentTurnIdentity}from"#tracing/local/inspection.js";import{traceStringAttribute}from"#tracing/local/trace-operations.js";function buildConversationItems(e){let t=new Map(e.spans.map(e=>[e.spanId,e])),n=new Map;for(let r of e.spans){if(!isAgentTurnSpan(r))continue;let e=agentTurnIdentity(r),i=turnSubagent(r,t);e!==void 0&&i!==void 0&&n.set(e,i)}let r=[],i;for(let t of[...e.spans].sort(compareLocalTraceSpans)){let e=isModelSpan(t)?systemInstructionsText(t.attributes):void 0;if(e!==void 0){i={span:t,text:e};break}}i!==void 0&&r.push({item:{kind:`system`,durationMs:0,error:!1,span:i.span,subagent:subagentFor(i.span,n,t),text:i.text},order:0n});for(let i of e.spans){let e=subagentFor(i,n,t),a=stringAttribute(i,`agent.channel.delivery.input`);if(a!==void 0){let t=deliveryText(a);if(t===void 0)continue;r.push({item:{kind:`user`,durationMs:0,error:!1,span:i,subagent:e,text:t},order:i.startTimeNs});continue}if(isModelSpan(i)){let n=stringAttribute(i,`ai.response.text`),a=stringAttribute(i,`ai.response.reasoning`),o=numberAttribute(i,`gen_ai.usage.input_tokens`),s=numberAttribute(i,`gen_ai.usage.output_tokens`),c=o!==void 0||s!==void 0,l=i.attributes[`ai.response.tool_calls`]!==void 0;if((n===void 0||n.trim().length===0)&&(a===void 0||a.trim().length===0)&&!c&&!l&&i.statusCode!==2)continue;r.push({item:{kind:`assistant`,costUsd:stepCostUsd(i,t),durationMs:spanDurationMs(i),error:i.statusCode===2,inputTokens:o,model:stringAttribute(i,`gen_ai.request.model`),outputTokens:s,reasoning:a,span:i,subagent:e,text:n,toolCallNames:l?parseToolCallNames(stringAttribute(i,`ai.response.tool_calls`)):void 0},order:i.startTimeNs});for(let t of parseProviderToolResults(stringAttribute(i,`ai.response.tool_results`)))r.push({item:{kind:`tool`,args:t.args,durationMs:0,error:t.error,name:stripTerminalControls(t.name),result:t.result,span:i,subagent:e},order:i.startTimeNs});continue}(i.attributes[`gen_ai.operation.name`]===`execute_tool`||i.name===`agent.action`)&&r.push({item:{kind:`tool`,args:stringAttribute(i,`gen_ai.tool.call.arguments`),durationMs:spanDurationMs(i),error:i.statusCode===2,name:stripTerminalControls(stringAttribute(i,`gen_ai.tool.name`)??stringAttribute(i,`agent.action.name`)??`tool`),result:unwrapJsonString(stringAttribute(i,`gen_ai.tool.call.result`)),span:i,subagent:e},order:i.startTimeNs})}return r.sort((e,t)=>e.order===t.order?0:e.order<t.order?-1:1).map(e=>e.item)}function systemInstructionsText(e){let t=e[`gen_ai.system_instructions`];if(typeof t==`string`)try{let e=JSON.parse(t);if(!Array.isArray(e))return;let n=e.flatMap(e=>typeof e!=`object`||!e||!(`type`in e)||e.type!==`text`||!(`content`in e)||typeof e.content!=`string`?[]:[e.content]).join(`
 
 `);return n.length>0?n:void 0}catch{return}}function subagentFor(e,t,n){let r=e;for(;r!==void 0;){let e=agentTurnIdentity(r);if(e!==void 0)return t.get(e);r=r.parentSpanId===void 0?void 0:n.get(r.parentSpanId)}}function turnSubagent(e,t){let n=stringAttribute(e,`agent.subagent.name`);if(n!==void 0){let t=n??stringAttribute(e,`gen_ai.agent.name`);return{name:t===void 0?void 0:stripTerminalControls(t)}}let r=e.parentSpanId===void 0?void 0:t.get(e.parentSpanId);if(r===void 0)return;let i=stringAttribute(r,`agent.action.kind`);if(i!==`subagent-call`&&i!==`remote-agent-call`)return;let a=stringAttribute(r,`agent.turn.id`);if(a===void 0)return;let o=stringAttribute(r,`agent.action.name`);return{name:o===void 0?void 0:stripTerminalControls(o),parentCallId:traceStringAttribute(r,`gen_ai.tool.call.id`),parentTurnId:a}}function renderConversationItem(e,t,n,r,i,a){let{colors:o,glyph:s}=n,c=Math.max(8,t-8),l=conversationItemExpandable(e,t),u=n.color?a:void 0,d=u?.primaryText??o.white,f,p,m=[];if(e.kind===`tool`){let t=o.bold(d(e.name??`tool`));f=`${foldMarker(i,l,n)}${t}`,p=e.durationMs>0?o.dim(formatElapsed(e.durationMs)):``;let r=e.args===void 0?[]:formatPayloadContent(e.args,c),a=e.result===void 0?[]:formatPayloadContent(e.result,c),s=i?r:capLines(r,c),u=i?a:capLines(a,c);s.length>0&&m.push(``,o.dim(`Input:`),``,...s),u.length>0&&m.push(``,o.dim(`Output:`),``,...u)}else if(e.kind===`system`){f=`${foldMarker(i,l,n)}${o.bold(d(`system`))}`,p=o.dim(`~${formatCompactTokenCount(estimateTokens(e.text??``))} tokens`);let t=wrapPlainText(e.text??``,c);m.push(...i?t:capLines(t,c))}else if(e.kind===`assistant`){f=`${foldMarker(i,l,n)}${o.bold(d(`assistant`))}${e.model===void 0?``:o.dim(` · ${stripTerminalControls(e.model)}`)}`,p=assistantMetrics(e,s,o);let t=e.reasoning===void 0||e.reasoning.trim().length===0?[]:wrapPlainText(e.reasoning,c),r=e.text===void 0||e.text.trim().length===0?[]:wrapPlainText(e.text,c),a=(i?t:capLines(t,c)).map(e=>o.dim(e)),u=i?r:capLines(r,c);if(a.length>0&&(m.push(o.dim(`Thought:`),``,...a),u.length>0&&m.push(``)),m.push(...u),(e.text===void 0||e.text.trim().length===0)&&e.toolCallNames!==void 0&&e.toolCallNames.length>0){a.length>0&&m.push(``);for(let t of e.toolCallNames)m.push(o.dim(`→ ${t}`))}}else{let t=e.kind===`user`&&e.subagent!==void 0?`task`:e.kind;f=`${foldMarker(i,l,n)}${o.bold(d(t))}`,p=``;let r=e.text===void 0||e.text.trim().length===0?[]:wrapPlainText(e.text,c);m.push(...i?r:capLines(r,c))}if(e.subagent!==void 0){let t=e.subagent.name===void 0?`subagent`:`subagent:${e.subagent.name}`;f+=o.dim(` · ${t}`)}e.error&&(f+=` ${o.red(s.error)}`),!i&&l?m.push(`…`,``,o.dim(`Click to expand`)):i&&l&&m.push(``,o.dim(`Click to collapse`));let h=u===void 0?void 0:e.error?u.errorHeader:u.header,g=u===void 0?void 0:e.error?u.errorBody:u.body,_=railCell(n,r,e.error,u);return[cardRow(``,t,n,_,h),cardSplitRow(f,p,t,n,_,h),cardRow(``,t,n,_,h),cardRow(``,t,n,_,g),...m.map(e=>cardRow(e,t,n,_,g)),cardRow(``,t,n,_,g)]}function cardRow(e,t,n,r,i){let a=clipVisible(e,Math.max(1,t-8)),o=` `.repeat(Math.max(0,t-8-visibleLength(a)));return i===void 0||!n.color?` ${r}  ${a}${o}    `:` ${r}${i}  ${a.replaceAll(`\x1B[0m`,`\x1b[0m${i}`)}\x1b[0m${i}${o}  ${SURFACE_CLOSE}  `}function railCell(e,t,n,r){let{colors:i,glyph:a}=e;if(t){let t=e.unicode?`▌`:a.rule;return r===void 0?i.white(t):r.primaryText(t)}return r===void 0?n?i.red(a.rule):i.dim(a.rule):` `}function cardSplitRow(e,t,n,r,i,a){if(visibleLength(t)===0)return cardRow(e,n,r,i,a);let o=Math.max(1,n-8),s=visibleLength(t),c=Math.max(1,o-s-2),l=clipVisible(e,c);return cardRow(`${l}${` `.repeat(Math.max(2,o-visibleLength(l)-s))}${t}`,n,r,i,a)}function assistantMetrics(e,t,n){let r=[];return e.durationMs>0&&r.push(formatElapsed(e.durationMs)),e.inputTokens!==void 0&&r.push(`${t.arrowUp}${formatCompactTokenCount(e.inputTokens)}`),e.outputTokens!==void 0&&r.push(`${t.arrowDown}${formatCompactTokenCount(e.outputTokens)}`),e.costUsd!==void 0&&r.push(formatCostUsd(e.costUsd)),r.length===0?``:n.dim(r.join(` · `))}function stepCostUsd(e,t){let n=e;for(;n.parentSpanId!==void 0;){if(n=t.get(n.parentSpanId),n===void 0)return;if(n.name===`agent.step`)return localTraceSpanCostUsd(n)}}function foldMarker(e,t,n){return e?`${n.colors.dim(`▾`)} `:t?`${n.colors.dim(`▸`)} `:``}function capLines(e,t){return e.length<=3?[...e]:[...e.slice(0,2),clipVisible(e[2],Math.max(1,t))]}function conversationItemLineCount(e,t,n,r){return renderConversationItem(e,t,n,!1,r).length}function conversationItemExpandable(e,t){let n=Math.max(8,t-8);if(e.kind===`tool`){let t=e.args===void 0?0:formatPayloadContent(e.args,n-2).length,r=e.result===void 0?0:formatPayloadContent(e.result,n-2).length;return t>3||r>3}if(e.kind===`system`)return wrapPlainText(e.text??``,n).length>3;if(e.kind===`user`)return(e.text===void 0||e.text.trim().length===0?0:wrapPlainText(e.text,n).length)>3;let r=e.reasoning===void 0||e.reasoning.trim().length===0?0:wrapPlainText(e.reasoning,n).length,i=e.text===void 0||e.text.trim().length===0?0:wrapPlainText(e.text,n).length;return r>3||i>3}function estimateTokens(e){return Math.ceil(e.length/4)}function deliveryText(e){if(e!==void 0)try{let t=JSON.parse(e);return isRecord(t)&&typeof t.message==`string`?t.message:void 0}catch{return e}}function unwrapJsonString(e){if(e!==void 0)try{let t=JSON.parse(e);return typeof t==`string`?t:e}catch{return e}}function isModelSpan(e){return e.name.startsWith(`ai.`)&&e.name.includes(`do`)||e.attributes[`gen_ai.operation.name`]===`chat`}function parseToolCallNames(e){if(e!==void 0)try{let t=JSON.parse(e);return Array.isArray(t)?t.filter(e=>isRecord(e)&&typeof e.toolName==`string`).map(e=>e.toolName):void 0}catch{return}}function parseProviderToolResults(e){if(e===void 0)return[];try{let t=JSON.parse(e);if(!Array.isArray(t))return[];let asText=e=>typeof e==`string`?e:e===void 0?void 0:JSON.stringify(e);return t.filter(isRecord).map(e=>{let t=`error`in e;return{args:asText(e.input),error:t,name:typeof e.toolName==`string`?e.toolName:`tool`,result:asText(t?e.error:e.output)}})}catch{return[]}}function stringAttribute(e,t){let n=e.attributes[t];return typeof n==`string`?n:void 0}function numberAttribute(e,t){let n=e.attributes[t];return typeof n==`number`?n:void 0}function spanDurationMs(e){return Math.max(0,Number(e.endTimeNs-e.startTimeNs)/1e6)}function isRecord(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}export{buildConversationItems,conversationItemExpandable,conversationItemLineCount,renderConversationItem};

package/dist/src/cli/dev/tui/traces/trace-store.d.ts

@@ -6,7 +6,7 @@
  * files that appeared since the last poll. Listing stats directories instead
  * of parsing spans, keeping a 1s poll cheap even with a large spool.
  */
-import type { LocalTrace } from "#tracing/local-trace-reader.js";
+import type { LocalTrace } from "#tracing/local/trace-reader.js";
 export interface TraceStoreEntry {
     readonly traceId: string;
     /** Mtime of the trace's segments directory — the instant it last received a span. */

package/dist/src/cli/dev/tui/traces/trace-store.js

@@ -1 +1 @@
-import{assembleLocalTrace,listLocalTraceIds,listLocalTraceSegments,readLocalTraceActivityMs,readLocalTraceSegment}from"#tracing/local-trace-reader.js";function createTraceStore(e){let t=new Map;return{async list(){let t=[];for(let n of await listLocalTraceIds(e.appRoot)){let r=await readLocalTraceActivityMs(e.appRoot,n);r!==void 0&&t.push({traceId:n,lastActivityMs:r})}return t.sort((e,t)=>t.lastActivityMs===e.lastActivityMs?e.traceId.localeCompare(t.traceId):t.lastActivityMs-e.lastActivityMs)},async read(n){let r=await listLocalTraceSegments(e.appRoot,n);if(r===void 0){t.delete(n);return}let i=t.get(n);i===void 0&&(i={seen:new Set,spans:new Map},t.set(n,i));let a=!1;for(let t of r)if(!i.seen.has(t)){i.seen.add(t);for(let r of await readLocalTraceSegment(e.appRoot,n,t))i.spans.has(r.spanId)||(i.spans.set(r.spanId,r),a=!0)}if(i.spans.size!==0)return(a||i.assembled===void 0)&&(i.assembled=assembleLocalTrace(n,[...i.spans.values()])),i.assembled}}}export{createTraceStore};
+import{assembleLocalTrace,listLocalTraceIds,listLocalTraceSegments,readLocalTraceActivityMs,readLocalTraceSegment}from"#tracing/local/trace-reader.js";function createTraceStore(e){let t=new Map;return{async list(){let t=[];for(let n of await listLocalTraceIds(e.appRoot)){let r=await readLocalTraceActivityMs(e.appRoot,n);r!==void 0&&t.push({traceId:n,lastActivityMs:r})}return t.sort((e,t)=>t.lastActivityMs===e.lastActivityMs?e.traceId.localeCompare(t.traceId):t.lastActivityMs-e.lastActivityMs)},async read(n){let r=await listLocalTraceSegments(e.appRoot,n);if(r===void 0){t.delete(n);return}let i=t.get(n);i===void 0&&(i={seen:new Set,spans:new Map},t.set(n,i));let a=!1;for(let t of r)if(!i.seen.has(t)){i.seen.add(t);for(let r of await readLocalTraceSegment(e.appRoot,n,t))i.spans.has(r.spanId)||(i.spans.set(r.spanId,r),a=!0)}if(i.spans.size!==0)return(a||i.assembled===void 0)&&(i.assembled=assembleLocalTrace(n,[...i.spans.values()])),i.assembled}}}export{createTraceStore};

package/dist/src/cli/dev/tui/traces/trace-view.d.ts

@@ -5,7 +5,7 @@
  * footer (key hints + position/notice). Every row is clipped to the
  * terminal width so the alt-screen painter can write rows verbatim.
  */
-import type { LocalTraceSpan } from "#tracing/local-trace-reader.js";
+import type { LocalTraceSpan } from "#tracing/local/trace-reader.js";
 import type { Theme } from "../theme.js";
 import type { TraceViewerSurfaces } from "./trace-surfaces.js";
 import type { TextSelectionRange, TraceViewerState } from "./trace-viewer-state.js";

package/dist/src/cli/dev/tui/traces/trace-view.js

@@ -1,2 +1,2 @@
-import{formatAttributeContent}from"./trace-content.js";import{renderConversationItem}from"./trace-conversation.js";import{orderedTextSelection,selectedTraceViewerSpan}from"./trace-viewer-state.js";import{formatElapsed}from"#cli/format-elapsed.js";import{clipVisible,sliceVisible,stripAnsi,stripTerminalControls,visibleLength,wrapVisibleLine}from"#cli/ui/terminal-text.js";import{describeLocalTraceSpan}from"#tracing/local-trace-reader.js";function renderTraceViewer(e,t){let{width:n,height:r,theme:i}=t,a=chromeStyles(i,t.surfaces),o=Math.max(1,r-3-3),s=e.panelOpen?panelWidthFor(n):0,c=Math.max(20,n-(s===0?0:s+1)),l=panelDetailLines(e,s,i,t.surfaces),u=o,d=[];if(d.push(...renderHeader(e,t)),e.traces.length===0)d.push(...renderEmptyState(t,i,o));else if(e.trace===void 0)d.push(...center(o,a.muted(`Loading trace…`)));else{let r=renderConversation(e,t,c,o);for(let t=0;t<o;t+=1){let i=r[t]??``;if(s===0){d.push(i);continue}let a=l[e.panelScroll+t]??``;e.textSelection!==void 0&&e.textSelection.region===`panel`&&(a=highlightSelection(a,e.panelScroll+t,e.textSelection,s)),d.push(joinPanels(i,c,a,n))}}return d.push(...renderFooter(e,n,i,t.surfaces)),t.toast!==void 0&&overlayToast(d,t.toast,n,i,t.surfaces),{rows:d,panelTotalRows:l.length,timelineViewportRows:o,panelViewportRows:u,contentWidth:c}}function chromeStyles(e,t){let n=e.color?t:void 0;return{muted:n?.mutedText??e.colors.dim,primary:n?.primaryText??(e=>e)}}function overlayToast(e,t,n,r,i){let a=`  ${stripTerminalControls(t)}  `,o=visibleLength(a),s=r.unicode?`▌`:r.glyph.rule,c=r.color?i:void 0,l=c===void 0?``:c.body,u=c?.primaryText??r.colors.white,d=r.color?`\x1B[0m`:``,f=[`${l}${u(s)}${` `.repeat(o)}${d}`,`${l}${u(s)}${u(a)}${d}`,`${l}${u(s)}${` `.repeat(o)}${d}`];for(let[t,r]of f.entries()){let i=2+t;if(i>=e.length)break;e[i]=overlayRight(e[i],r,n,1)}}function overlayRight(e,t,n,r){let i=Math.max(0,n-r-visibleLength(t)),a=visibleLength(e),o=a<i?e+` `.repeat(i-a):e;return`${sliceVisible(o,i)}\x1b[0m${t}`}const CONVERSATION_CONTENT_KEYS=new Set([`gen_ai.input.messages`,`gen_ai.system_instructions`,`ai.response.reasoning`,`ai.response.text`,`ai.response.tool_calls`,`ai.response.tool_results`,`gen_ai.tool.call.arguments`,`gen_ai.tool.call.result`]);function renderSpanDetail(e,t,n,r){let{colors:i}=n,{muted:a,primary:o}=chromeStyles(n,r?.surfaces),s=[],c=stripTerminalControls(e.name);s.push(...wrapVisibleLine(i.bold(o(c)),t));let l=describeLocalTraceSpan(e).map(stripTerminalControls);l.length>0&&s.push(a(l.join(`, `))),s.push(``);let fact=(e,t)=>`${a(e.padEnd(10))}${t}`,u=e.statusCode===2;s.push(fact(`status`,u?i.red(`ERROR`):i.green(`ok`))),s.push(fact(`duration`,formatElapsed(durationMs(e.startTimeNs,e.endTimeNs)))),s.push(fact(`started`,clockTime(e.startTimeNs))),s.push(fact(`span`,e.spanId)),e.parentSpanId!==void 0&&s.push(fact(`parent`,e.parentSpanId)),e.scope!==void 0&&s.push(fact(`scope`,stripTerminalControls(e.scope))),s.push(``);let d=Object.keys(e.attributes).filter(e=>r?.excludeKeys?.has(e)!==!0).sort();if(d.length===0)s.push(a(`no attributes`));else{s.push(a(`attributes (${d.length})`));for(let n of d){let r=formatAttributeContent(n,e.attributes[n],i.dim,t-2),o=stripTerminalControls(n);if(r.length===1)s.push(...wrapVisibleLine(`${a(o)} ${r[0]}`,t));else{s.push(a(o));for(let e of r)s.push(`  ${e}`)}}}return s.map(e=>clipVisible(e,t))}function renderHeader(e,t){let{theme:n,width:r}=t,{colors:i,glyph:a}=n,{muted:o,primary:s}=chromeStyles(n,t.surfaces),c=[];if(e.trace?.agentName!==void 0&&c.push(stripTerminalControls(e.trace.agentName)),e.trace?.conversationId!==void 0&&c.push(`conversation ${stripTerminalControls(e.trace.conversationId)}`),e.trace!==void 0){let n=t.activeWindowEndNs!==void 0&&t.activeWindowEndNs>e.trace.endTimeNs?t.activeWindowEndNs:e.trace.endTimeNs;c.push(clockTime(e.trace.startTimeNs),`${e.trace.spans.length} span${e.trace.spans.length===1?``:`s`}`,formatElapsed(durationMs(e.trace.startTimeNs,n)))}let l=`${i.bold(s(`${a.brand} traces`))}${c.length===0?``:o(` · ${c.join(` · `)}`)}`,u=e.traces.length===0?``:o(`[${e.traceIndex+1}/${e.traces.length}]`),d=[t.activeWindowEndNs===void 0?``:i.green(`● live`),u].filter(e=>e.length>0).join(` `),f=joinRight(` ${clipVisible(l,Math.max(0,r-visibleLength(d)-2))}`,d,r);return[``,clipVisible(f,r),``]}function renderConversation(e,t,n,r){let{theme:i}=t;if(e.conversationItems.length===0)return[chromeStyles(i,t.surfaces).muted(`  No conversation content in this trace; its export policy may have redacted it.`)];let a=conversationLines(e,n,i,t.surfaces).slice(e.scrollRow,e.scrollRow+r);return e.textSelection===void 0||e.textSelection.region!==`conversation`?a:a.map((t,r)=>highlightSelection(t,e.scrollRow+r,e.textSelection,n))}function conversationLines(e,t,n,r){let i=[];for(let a=0;a<e.conversationItems.length;a+=1)i.push(...renderConversationItem(e.conversationItems[a],t,n,a===e.selectedRow,e.expandedItems.has(a),r),``);return i}function panelDetailLines(e,t,n,r){let i=selectedTraceViewerSpan(e);return!e.panelOpen||t<=0||i===void 0?[]:[``,...renderSpanDetail(i,Math.max(16,t-3),n,{excludeKeys:CONVERSATION_CONTENT_KEYS,surfaces:r}).map(e=>` ${e}`)]}function conversationSelectionText(e,t,n,r,i){return selectionText(conversationLines(e,t,n,i),r)}function panelSelectionText(e,t,n,r){return selectionText(panelDetailLines(e,e.panelOpen?panelWidthFor(t):0,n),r)}function selectionText(e,t){let{start:n,end:r}=orderedTextSelection(t),i=[];for(let t=Math.max(0,n.line);t<=r.line&&t<e.length;t+=1){let a=stripAnsi(e[t]),o=t===n.line?n.column:0,s=t===r.line?r.column+1:1/0,c=s===1/0?a:sliceVisible(a,s),l=sliceVisible(a,o).length;i.push(c.slice(l).trimEnd())}return i.join(`
+import{formatAttributeContent}from"./trace-content.js";import{renderConversationItem}from"./trace-conversation.js";import{orderedTextSelection,selectedTraceViewerSpan}from"./trace-viewer-state.js";import{formatElapsed}from"#cli/format-elapsed.js";import{clipVisible,sliceVisible,stripAnsi,stripTerminalControls,visibleLength,wrapVisibleLine}from"#cli/ui/terminal-text.js";import{describeLocalTraceSpan}from"#tracing/local/trace-reader.js";function renderTraceViewer(e,t){let{width:n,height:r,theme:i}=t,a=chromeStyles(i,t.surfaces),o=Math.max(1,r-3-3),s=e.panelOpen?panelWidthFor(n):0,c=Math.max(20,n-(s===0?0:s+1)),l=panelDetailLines(e,s,i,t.surfaces),u=o,d=[];if(d.push(...renderHeader(e,t)),e.traces.length===0)d.push(...renderEmptyState(t,i,o));else if(e.trace===void 0)d.push(...center(o,a.muted(`Loading trace…`)));else{let r=renderConversation(e,t,c,o);for(let t=0;t<o;t+=1){let i=r[t]??``;if(s===0){d.push(i);continue}let a=l[e.panelScroll+t]??``;e.textSelection!==void 0&&e.textSelection.region===`panel`&&(a=highlightSelection(a,e.panelScroll+t,e.textSelection,s)),d.push(joinPanels(i,c,a,n))}}return d.push(...renderFooter(e,n,i,t.surfaces)),t.toast!==void 0&&overlayToast(d,t.toast,n,i,t.surfaces),{rows:d,panelTotalRows:l.length,timelineViewportRows:o,panelViewportRows:u,contentWidth:c}}function chromeStyles(e,t){let n=e.color?t:void 0;return{muted:n?.mutedText??e.colors.dim,primary:n?.primaryText??(e=>e)}}function overlayToast(e,t,n,r,i){let a=`  ${stripTerminalControls(t)}  `,o=visibleLength(a),s=r.unicode?`▌`:r.glyph.rule,c=r.color?i:void 0,l=c===void 0?``:c.body,u=c?.primaryText??r.colors.white,d=r.color?`\x1B[0m`:``,f=[`${l}${u(s)}${` `.repeat(o)}${d}`,`${l}${u(s)}${u(a)}${d}`,`${l}${u(s)}${` `.repeat(o)}${d}`];for(let[t,r]of f.entries()){let i=2+t;if(i>=e.length)break;e[i]=overlayRight(e[i],r,n,1)}}function overlayRight(e,t,n,r){let i=Math.max(0,n-r-visibleLength(t)),a=visibleLength(e),o=a<i?e+` `.repeat(i-a):e;return`${sliceVisible(o,i)}\x1b[0m${t}`}const CONVERSATION_CONTENT_KEYS=new Set([`gen_ai.input.messages`,`gen_ai.system_instructions`,`ai.response.reasoning`,`ai.response.text`,`ai.response.tool_calls`,`ai.response.tool_results`,`gen_ai.tool.call.arguments`,`gen_ai.tool.call.result`]);function renderSpanDetail(e,t,n,r){let{colors:i}=n,{muted:a,primary:o}=chromeStyles(n,r?.surfaces),s=[],c=stripTerminalControls(e.name);s.push(...wrapVisibleLine(i.bold(o(c)),t));let l=describeLocalTraceSpan(e).map(stripTerminalControls);l.length>0&&s.push(a(l.join(`, `))),s.push(``);let fact=(e,t)=>`${a(e.padEnd(10))}${t}`,u=e.statusCode===2;s.push(fact(`status`,u?i.red(`ERROR`):i.green(`ok`))),s.push(fact(`duration`,formatElapsed(durationMs(e.startTimeNs,e.endTimeNs)))),s.push(fact(`started`,clockTime(e.startTimeNs))),s.push(fact(`span`,e.spanId)),e.parentSpanId!==void 0&&s.push(fact(`parent`,e.parentSpanId)),e.scope!==void 0&&s.push(fact(`scope`,stripTerminalControls(e.scope))),s.push(``);let d=Object.keys(e.attributes).filter(e=>r?.excludeKeys?.has(e)!==!0).sort();if(d.length===0)s.push(a(`no attributes`));else{s.push(a(`attributes (${d.length})`));for(let n of d){let r=formatAttributeContent(n,e.attributes[n],i.dim,t-2),o=stripTerminalControls(n);if(r.length===1)s.push(...wrapVisibleLine(`${a(o)} ${r[0]}`,t));else{s.push(a(o));for(let e of r)s.push(`  ${e}`)}}}return s.map(e=>clipVisible(e,t))}function renderHeader(e,t){let{theme:n,width:r}=t,{colors:i,glyph:a}=n,{muted:o,primary:s}=chromeStyles(n,t.surfaces),c=[];if(e.trace?.agentName!==void 0&&c.push(stripTerminalControls(e.trace.agentName)),e.trace?.conversationId!==void 0&&c.push(`conversation ${stripTerminalControls(e.trace.conversationId)}`),e.trace!==void 0){let n=t.activeWindowEndNs!==void 0&&t.activeWindowEndNs>e.trace.endTimeNs?t.activeWindowEndNs:e.trace.endTimeNs;c.push(clockTime(e.trace.startTimeNs),`${e.trace.spans.length} span${e.trace.spans.length===1?``:`s`}`,formatElapsed(durationMs(e.trace.startTimeNs,n)))}let l=`${i.bold(s(`${a.brand} traces`))}${c.length===0?``:o(` · ${c.join(` · `)}`)}`,u=e.traces.length===0?``:o(`[${e.traceIndex+1}/${e.traces.length}]`),d=[t.activeWindowEndNs===void 0?``:i.green(`● live`),u].filter(e=>e.length>0).join(` `),f=joinRight(` ${clipVisible(l,Math.max(0,r-visibleLength(d)-2))}`,d,r);return[``,clipVisible(f,r),``]}function renderConversation(e,t,n,r){let{theme:i}=t;if(e.conversationItems.length===0)return[chromeStyles(i,t.surfaces).muted(`  No conversation content in this trace; its export policy may have redacted it.`)];let a=conversationLines(e,n,i,t.surfaces).slice(e.scrollRow,e.scrollRow+r);return e.textSelection===void 0||e.textSelection.region!==`conversation`?a:a.map((t,r)=>highlightSelection(t,e.scrollRow+r,e.textSelection,n))}function conversationLines(e,t,n,r){let i=[];for(let a=0;a<e.conversationItems.length;a+=1)i.push(...renderConversationItem(e.conversationItems[a],t,n,a===e.selectedRow,e.expandedItems.has(a),r),``);return i}function panelDetailLines(e,t,n,r){let i=selectedTraceViewerSpan(e);return!e.panelOpen||t<=0||i===void 0?[]:[``,...renderSpanDetail(i,Math.max(16,t-3),n,{excludeKeys:CONVERSATION_CONTENT_KEYS,surfaces:r}).map(e=>` ${e}`)]}function conversationSelectionText(e,t,n,r,i){return selectionText(conversationLines(e,t,n,i),r)}function panelSelectionText(e,t,n,r){return selectionText(panelDetailLines(e,e.panelOpen?panelWidthFor(t):0,n),r)}function selectionText(e,t){let{start:n,end:r}=orderedTextSelection(t),i=[];for(let t=Math.max(0,n.line);t<=r.line&&t<e.length;t+=1){let a=stripAnsi(e[t]),o=t===n.line?n.column:0,s=t===r.line?r.column+1:1/0,c=s===1/0?a:sliceVisible(a,s),l=sliceVisible(a,o).length;i.push(c.slice(l).trimEnd())}return i.join(`
 `)}function highlightSelection(e,t,n,r){let{start:i,end:a}=orderedTextSelection(n);if(t<i.line||t>a.line)return e;let o=t===i.line?i.column:0,s=t===a.line?a.column+1:r,c=visibleLength(e),l=c<s?e+` `.repeat(s-c):e,u=sliceVisible(l,o),d=sliceVisible(l,s),f=d.slice(u.length),p=l.slice(d.length);return f.length===0?e:`${u}\x1b[7m${f.replaceAll(`\x1B[0m`,`\x1B[0m\x1B[7m`)}\x1b[27m${p}`}function renderFooter(e,t,n,r){let{colors:i}=n,{muted:a}=chromeStyles(n,r),[o,s]=n.unicode?[`↑↓`,`←→`]:[`^/v`,`</>`],c=e.panelFocus?`${o} scroll · tab cards · esc back`:`${o} select · ${s} expand · enter attrs · tab focus · [ ] traces · q close`,l=e.conversationItems.length,u=l===0?``:a(`item ${e.selectedRow+1}/${l}`),d=[e.notice===void 0?``:i.yellow(e.notice),u].filter(e=>e.length>0).join(a(` · `));return[``,clipVisible(` ${a(c)}`,t),clipVisible(d.length===0?``:` ${d}`,t)]}function renderEmptyState(e,t,n){let{muted:r,primary:i}=chromeStyles(t,e.surfaces),[a,o]=e.tracingDisabled===!0?[`Tracing is disabled (EVE_TRACES=off).`,`Re-enable it and spans stream in live.`]:[`No local traces yet.`,`Chat with your agent — spans stream in live.`];return center(n,t.colors.bold(i(a)),r(o))}function center(e,...t){let n=Array.from({length:e},()=>``),r=Math.max(0,Math.floor(e/2)-1);return t.forEach((t,i)=>{r+i<e&&(n[r+i]=t)}),n}function joinPanels(e,t,n,r){let i=Math.max(0,r-t-1);return`${padTo(e,t)} ${clipVisible(n,i)}`}function joinRight(e,t,n){if(t.length===0)return e;let r=Math.max(1,n-visibleLength(e)-visibleLength(t));return`${e}${` `.repeat(r)}${t}`}function padTo(e,t){let n=visibleLength(e);return n>=t?clipVisible(e,t):e+` `.repeat(t-n)}function panelWidthFor(e){return e<42?0:Math.min(64,Math.max(20,Math.floor(e*.42)),e-20-1)}function durationMs(e,t){return Math.max(0,Number(t-e)/1e6)}function clockTime(e){let t=new Date(Number(e/1000000n)),pad=(e,t=2)=>String(e).padStart(t,`0`);return`${pad(t.getHours())}:${pad(t.getMinutes())}:${pad(t.getSeconds())}.${pad(t.getMilliseconds(),3)}`}export{conversationSelectionText,panelSelectionText,renderSpanDetail,renderTraceViewer};

package/dist/src/cli/dev/tui/traces/trace-viewer-state.d.ts

@@ -6,7 +6,7 @@
  * {@link applyLoadedTrace} so a live trace can grow underneath an open
  * viewer without losing the user's selection.
  */
-import type { LocalTrace, LocalTraceSpan } from "#tracing/local-trace-reader.js";
+import type { LocalTrace, LocalTraceSpan } from "#tracing/local/trace-reader.js";
 import type { ConversationItem } from "#cli/dev/tui/traces/trace-conversation.js";
 import type { TraceStoreEntry } from "#cli/dev/tui/traces/trace-store.js";
 import type { TerminalKey } from "#cli/dev/tui/stream-format.js";

package/dist/src/compiled/.vendor-stamp.json

@@ -1,6 +1,7 @@
 {
   "moduleFingerprints": {
     "@eve/catalog": "d5babf703f0f589f123ee2043b72bcb4823ccccbe5034315c3b70fbae7cd76a0",
+    "@eve/tracing": "a528cd9d20e2f2549eb986fdf03ba3352014d69aec709f9758482bc8d08bb5aa",
     "just-secrets": "1ce67d437d0bb06df02e4e99180a3c5f5edf0010314010226e97b96d462bba5d",
     "@workflow/world-local": "a10e78551f65fc607cf75261a569d852c40bc9cfac13a7fb6e15c88bf1ccf429"
   },
@@ -19,6 +20,7 @@
     "eventsource-parser": "3.1.0",
     "env-runner": "0.1.16",
     "@eve/catalog": "0.0.1",
+    "@eve/tracing": "0.0.0",
     "@ai-sdk/google": "4.0.93",
     "jose": "6.2.3",
     "js-yaml": "4.3.2",
@@ -59,7 +61,7 @@
     "zod": "4.5.4",
     "zod-validation-error": "5.0.0"
   },
-  "scriptHash": "f296c8787cbb975a01596e49048f5c4b1a1480c03754134647da5eff762b98ca",
+  "scriptHash": "3a19e7f59d4cf18dd0aec4272f4eba4e8a23cfe1682db5801421af4da6d37069",
   "toolVersions": {
     "rolldown": "1.2.9",
     "typescript": "7.0.2"

package/dist/src/compiled/@eve/tracing/adapters/agent-transport.d.ts

@@ -0,0 +1,8 @@
+import { type AgentHandoff } from "../core/delegation.js";
+/** Host boundary for durable dispatch and authenticated remote transport. */
+export declare function createAgentDelegationTransport(fetcher?: typeof fetch): {
+    fetch: typeof fetch;
+    transport: (fetcher: typeof fetch) => typeof fetch;
+    receive<T>(headers: Headers, trusted: (handoff: AgentHandoff) => boolean, execute: (handoff?: AgentHandoff) => T): T;
+    resume<T>(stored: AgentHandoff, execute: (handoff: AgentHandoff) => T): T;
+};

package/dist/src/compiled/@eve/tracing/adapters/ai-sdk-payload.d.ts

@@ -0,0 +1,15 @@
+import type { ContentPart, Usage } from "../core/types.js";
+interface Result {
+    usage: {
+        inputTokens?: number;
+        outputTokens?: number;
+        inputTokenDetails?: {
+            cacheReadTokens?: number;
+            cacheWriteTokens?: number;
+        };
+    };
+    content: readonly unknown[];
+}
+export declare function modelUsage(usage: Result["usage"]): Usage;
+export declare function modelContent(content: Result["content"]): readonly ContentPart[];
+export {};

package/dist/src/compiled/@eve/tracing/adapters/ai-sdk-telemetry.d.ts

@@ -0,0 +1,14 @@
+import type { Telemetry } from "ai";
+import type { AgentTracing, TurnInput } from "../agent-tracing.js";
+export interface AiSdkTelemetryOptions {
+    /** The turn a generation records. Called once per AI SDK call. */
+    readonly turn: TurnInput | ((call: {
+        readonly callId: string;
+    }) => TurnInput);
+}
+/**
+ * An AI SDK telemetry integration that records each generation as a turn.
+ * Pass it to `telemetry.integrations` of `generateText`, `streamText`, or an
+ * agent such as `HarnessAgent`.
+ */
+export declare function aiSdkTelemetry(tracing: AgentTracing, options: AiSdkTelemetryOptions): Telemetry;

package/dist/src/{tracing/agent-span-id-generator.d.ts → compiled/@eve/tracing/adapters/otel-ids.d.ts}

@@ -1,5 +1,5 @@
 /**
- * Id generator shared by `registerOTel` and the agent OTel provider. A span
+ * ID generator installed by the host OTel provider for reserved-ID emission. A span
  * whose lifetime crosses durable worker boundaries (`invoke_agent`) is emitted
  * at its terminal; priming the next span id lets that span carry the
  * pre-allocated id its descendants already parented to.

package/dist/src/compiled/@eve/tracing/adapters/otel.d.ts

@@ -0,0 +1,33 @@
+import { type Context as OtelContext, type TracerProvider } from "#compiled/@opentelemetry/api/index.js";
+import { AgentSpanIdGenerator } from "./otel-ids.js";
+import type { Attributes, AgentTelemetry, OutputMapping, ActiveOperation } from "../core/types.js";
+type Context = OtelContext;
+export declare function withErrorContent<T extends {
+    setValue(key: symbol, value: unknown): T;
+}>(context: T, allowed: boolean): T;
+export declare function activeTraceOperation(host?: Pick<Context, "getValue">): ActiveOperation | undefined;
+export interface OtelTelemetryOptions {
+    /** Defaults to the global tracer provider. */
+    readonly provider?: TracerProvider;
+    /**
+     * Generator installed on `provider`. Required for durable tracing so a span
+     * started in a later process carries the ID its children already reference.
+     */
+    readonly idGenerator?: AgentSpanIdGenerator;
+    /** Defaults to recording every trace. */
+    readonly samplesTrace?: (traceId: string, operation: {
+        name: string;
+        attributes: Attributes;
+    }) => boolean;
+    /** Replaces the default mapping, which adds `vercel.session_id` on Vercel. */
+    readonly mapping?: OutputMapping;
+    readonly tracerName?: string;
+    /** Recorded as the spans' instrumentation scope version. */
+    readonly tracerVersion?: string;
+    /** Override the provider's lifecycle, for example to flush metric readers too. */
+    readonly forceFlush?: () => Promise<void>;
+    readonly shutdown?: () => Promise<void>;
+}
+/** OpenTelemetry implementation of {@link AgentTelemetry}. */
+export declare function otelTelemetry(options?: OtelTelemetryOptions): AgentTelemetry;
+export {};

package/dist/src/{tracing/agent-otel-content.d.ts → compiled/@eve/tracing/adapters/serialization.d.ts}

@@ -7,14 +7,18 @@
  */
 /** Content attributes are capped so a giant payload cannot bloat a span segment. */
 export declare const CONTENT_ATTRIBUTE_LIMIT: number;
+import type { ContentSerializer } from "../core/types.js";
+export declare const aiSdkContentSerializer: ContentSerializer;
+export declare function telemetryByteLength(text: string): number;
+export declare function truncateTelemetryText(text: string, maxBytes: number): string;
+export declare function boundedPrincipalId(value: unknown): string | undefined;
+export declare function boundedTraceError(value: Error): Error;
 /** Serializes one payload value as capped JSON. */
 export declare function contentAttribute(value: unknown): string | undefined;
 /** Serializes model messages using the OpenTelemetry GenAI message schema. */
-export declare function genAiInputMessagesAttribute(messages: unknown): string | undefined;
+export declare function genAiInputMessagesAttribute(messages: unknown, messageKind?: (value: unknown) => string | undefined): string | undefined;
 /** Serializes the system prompt using the OpenTelemetry GenAI instruction schema. */
 export declare function genAiSystemInstructionsAttribute(instructions: unknown): string | undefined;
-/** Serializes tool definitions, dropping trailing entries to keep the JSON whole. */
-export declare function genAiToolDefinitionsAttribute(tools: unknown): string | undefined;
 /** Serializes one model response using the OpenTelemetry GenAI message schema. */
 export declare function genAiOutputMessagesAttribute(content: readonly unknown[], finishReason: string): string | undefined;
 /** Serializes memory records using the OpenTelemetry GenAI memory-records schema. */
@@ -26,5 +30,7 @@ export declare function genAiMemoryRecordsAttribute(records: readonly unknown[])
  * instead of cutting the JSON mid-string.
  */
 export declare function toolResultsContentAttribute(results: readonly Record<string, unknown>[]): string | undefined;
+/** Serializes tool definitions, dropping trailing entries to keep the JSON whole. */
+export declare function genAiToolDefinitionsAttribute(tools: unknown): string | undefined;
 /** Caps plain text, marking the cut. */
 export declare function textContentAttribute(text: string): string | undefined;

package/dist/src/compiled/@eve/tracing/agent-tracing.d.ts

@@ -0,0 +1,84 @@
+import { type TurnOperation } from "./operations.js";
+import type { AgentTelemetry, Attributes, CaptureDecision, ContentSerializer, ExecutionContext, FrameworkIdentity, RunIdentity, TraceCheckpointer, TraceErrorHandler, TraceLink, TraceReference } from "./core/types.js";
+export interface AgentTracingOptions {
+    /** Span output and context propagation. Defaults to the global OpenTelemetry provider. */
+    readonly telemetry?: AgentTelemetry;
+    /**
+     * Makes turns durable. Each in-flight turn is saved under a library-chosen
+     * key and removed when the turn and its open tool calls complete. Calling
+     * `turn()` again with the same identity, in this or a later process,
+     * continues the saved turn.
+     */
+    readonly checkpointer?: TraceCheckpointer;
+    /** Defaults to the AI SDK content serializer. */
+    readonly serializer?: ContentSerializer;
+    readonly onError?: TraceErrorHandler;
+}
+export interface TurnInput {
+    readonly identity: RunIdentity;
+    /** Names the invocation span. Omit for an anonymous agent. */
+    readonly agentName?: string;
+    readonly sequence: number;
+    readonly framework?: FrameworkIdentity;
+    readonly capture?: CaptureDecision;
+    readonly attributes?: Attributes;
+    /**
+     * Adopts a trace and span ID reserved before the turn started, such as one
+     * already returned to a caller. Requires telemetry with stable `ids`.
+     */
+    readonly reference?: TraceReference;
+    /**
+     * Nests the turn under a caller's span in the caller's trace. A local
+     * handoff sets this for the first turn; remote callees start their own trace.
+     */
+    readonly parent?: TraceReference;
+    readonly links?: readonly TraceLink[];
+    readonly startTimeMs?: number;
+    /** Delegation lineage recorded by the host, when it is not carried by a handoff. */
+    readonly lineage?: {
+        readonly parentRunId?: string;
+        readonly parentCallId?: string;
+        readonly agentName?: string;
+    };
+    readonly channel?: {
+        readonly kind?: string;
+        readonly origin?: string;
+    };
+    /** Host context for spans this process starts, such as OpenTelemetry baggage. */
+    readonly context?: ExecutionContext;
+}
+export interface ResumeInput {
+    readonly identity: RunIdentity;
+    readonly context?: ExecutionContext;
+}
+interface MemoryInput<T> {
+    identity: RunIdentity;
+    storeId: string;
+    slot: string;
+    phase: string;
+    capture?: CaptureDecision;
+    /** Defaults to the active operation. */
+    parent?: TraceReference;
+    context?: ExecutionContext;
+    describe?: (value: T) => {
+        recordCount?: number;
+        records?: readonly {
+            id?: string;
+            content: string;
+        }[];
+    };
+}
+export interface AgentTracing {
+    turn: import("./operations.js").WrappedOperation<TurnInput, TurnOperation>;
+    /** Returns a saved durable turn, without starting one. */
+    resume(input: ResumeInput): Promise<TurnOperation | undefined>;
+    memory: AgentMemoryTracing;
+    forceFlush(): Promise<void>;
+    shutdown(): Promise<void>;
+}
+export interface AgentMemoryTracing {
+    search<T>(data: MemoryInput<T>, execute: () => T | PromiseLike<T>): Promise<T>;
+    write<T>(data: MemoryInput<T>, execute: () => T | PromiseLike<T>): Promise<T>;
+}
+export declare function createAgentTracing(input: AgentTracingOptions): AgentTracing;
+export {};

package/dist/src/compiled/@eve/tracing/ai-sdk.d.ts

@@ -0,0 +1,7 @@
+/**
+ * AI SDK integration. `aiSdkTelemetry` records `generateText`, `streamText`,
+ * and AI SDK agents as turns; `modelUsage` and `modelContent` convert AI SDK
+ * payloads for hosts that record model calls themselves.
+ */
+export { aiSdkTelemetry, type AiSdkTelemetryOptions } from "./adapters/ai-sdk-telemetry.js";
+export { modelUsage, modelContent } from "./adapters/ai-sdk-payload.js";

package/dist/src/compiled/@eve/tracing/ai-sdk.js

@@ -0,0 +1 @@
+function e(e){return Object.freeze({inputTokens:e.inputTokens,outputTokens:e.outputTokens,inputTokenDetails:Object.freeze({cacheReadTokens:e.inputTokenDetails?.cacheReadTokens,cacheWriteTokens:e.inputTokenDetails?.cacheWriteTokens})})}function t(e){return e.flatMap(e=>{if(typeof e!=`object`||!e||!(`type`in e))return[];let t=e;if((t.type===`text`||t.type===`reasoning`)&&typeof t.text==`string`)return[{type:t.type,text:t.text}];if(typeof t.toolCallId!=`string`||typeof t.toolName!=`string`)return[];let n={callId:t.toolCallId,toolName:t.toolName,input:t.input};return t.type===`tool-call`?[{type:t.type,...n}]:t.type===`tool-result`?[{type:t.type,...n,output:t.output}]:t.type===`tool-error`?[{type:t.type,...n,error:t.error}]:[]})}const n={outcome:`abandoned`};function r(r,i){let a=new Map;function o(e){let t=a.get(e);return t===void 0&&(t={startTimeMs:Date.now(),tools:new Map},a.set(e,t)),t}async function s(e,t){let r=t===void 0?n:{outcome:`abandoned`,failed:!0,error:t};await(await e.model)?.complete(r);for(let t of e.tools.values())await(await t).complete(r);e.model=void 0,e.tools.clear();let i=await e.attempt;e.attempt=void 0,t===void 0?await i?.complete():await i?.fail(t)}async function c(e,t,n){let r=a.get(e);if(a.delete(e),r===void 0)return;await s(r,n);let i=await r.turn;i!==void 0&&await t(i)}return{onStart(e){o(e.callId)},async onStepStart(e){let t=o(e.callId);await s(t),t.turn??=r.turn({startTimeMs:t.startTimeMs,...typeof i.turn==`function`?i.turn({callId:e.callId}):i.turn}),t.attempt=(await t.turn).attempt({stepIndex:e.stepNumber,attempt:0})},async onLanguageModelCallStart(e){let t=await a.get(e.callId)?.attempt;t!==void 0&&(a.get(e.callId).model=t.modelCall({provider:e.provider,modelId:e.modelId,messages:e.messages,instructions:e.instructions,tools:e.tools}))},async executeLanguageModelCall({callId:e,execute:t}){let n=await a.get(e)?.model;if(n===void 0||n.finished)return t();try{return await n.run(t)}catch(e){throw await n.fail(e),e}},async onLanguageModelCallEnd(n){let r=a.get(n.callId),i=await r?.model;r!==void 0&&i!==void 0&&(r.model=void 0,await i.complete({outcome:`completed`,result:{finishReason:n.finishReason,usage:e(n.usage),responseId:n.responseId,responseModelId:n.modelId,content:t(n.content)}}))},async onToolExecutionStart(e){let t=a.get(e.callId),n=await t?.attempt;if(t===void 0||n===void 0)return;let r=e.toolCall;t.tools.set(r.toolCallId,n.tool({callId:r.toolCallId,name:r.toolName,arguments:r.input}))},async executeTool({callId:e,toolCallId:t,execute:n}){let r=await a.get(e)?.tools.get(t);return r===void 0||r.finished?n():r.run(n)},async onToolExecutionEnd(e){let t=a.get(e.callId),n=await t?.tools.get(e.toolCall.toolCallId);if(t===void 0||n===void 0)return;t.tools.delete(e.toolCall.toolCallId);let r=e.toolOutput,i=r.type===`tool-error`?{outcome:`failed`,errorType:r.error instanceof Error?r.error.name:`tool_error`,error:r.error}:{outcome:`completed`,output:`output`in r?r.output:void 0};await n.complete(i)},async onStepEnd(e){let t=a.get(e.callId);t!==void 0&&await s(t)},async onEnd(t){await c(t.callId,n=>n.complete({outcome:`completed`,usage:`totalUsage`in t?e(t.totalUsage):void 0}))},async onAbort(e){await c(e.callId,e=>e.complete({outcome:`cancelled`}))},async onError(e){let{callId:t,error:n}=typeof e==`object`&&e&&`callId`in e&&`error`in e?e:{callId:void 0,error:e};for(let e of t===void 0?[...a.keys()]:[t])await c(e,e=>e.fail(n),n)}}}export{r as aiSdkTelemetry,t as modelContent,e as modelUsage};

package/dist/src/compiled/@eve/tracing/capture.d.ts

@@ -0,0 +1,5 @@
+import type { CaptureDecision } from "./core/types.js";
+export declare function currentCapture(): CaptureDecision | undefined;
+export declare function withCapture<T extends {
+    setValue(key: symbol, value: unknown): T;
+}>(host: T, capture: CaptureDecision): T;

package/dist/src/compiled/@eve/tracing/core/activation.d.ts

@@ -0,0 +1,3 @@
+import type { ActiveOperation, CaptureDecision } from "./types.js";
+export declare function intersectCapture(capture: CaptureDecision, ceiling?: CaptureDecision): CaptureDecision;
+export declare function activeOperation(operation: ActiveOperation, capture: CaptureDecision): ActiveOperation;

package/dist/src/compiled/@eve/tracing/core/attributes.d.ts

@@ -0,0 +1,14 @@
+import type { Attributes, FrameworkIdentity, RunIdentity, Usage } from "./types.js";
+export declare const USAGE_FIELDS: {
+    readonly costUsd: "agent.usage.cost_usd";
+    readonly inputTokens: "agent.usage.input_tokens";
+    readonly outputTokens: "agent.usage.output_tokens";
+    readonly cacheReadTokens: "agent.usage.cache_read_tokens";
+    readonly cacheWriteTokens: "agent.usage.cache_write_tokens";
+};
+export declare function identityAttributes(identity: Pick<RunIdentity, "runId" | "conversationId">): Attributes;
+export declare function namingAttributes(name: string, operation?: string): Attributes;
+export declare function frameworkAttributes(framework?: FrameworkIdentity): Attributes;
+/** Invocation and model spans use GenAI token counts; structural spans use eve's. */
+export declare function usageAttributes(usage: Usage, genAi?: boolean): Attributes;
+export declare function runtimeContextAttributes(input: Readonly<Record<string, unknown>> | undefined): Attributes;

package/dist/src/{tracing/content-attributes.d.ts → compiled/@eve/tracing/core/content-policy.d.ts}

@@ -1,7 +1,7 @@
 /**
  * Which span attributes carry conversation content, and in which direction.
  *
- * Two vocabularies land on the same spans: the ones eve sets on its own
+ * Two vocabularies land on the same spans: the ones the library sets on its own
  * `agent.*` spans, and the ones the AI SDK's OpenTelemetry integration sets on
  * the model-call spans beneath them. A destination that declined content has to
  * be rid of both, so both are listed here rather than in the module that writes

package/dist/src/compiled/@eve/tracing/core/context.d.ts

@@ -0,0 +1,3 @@
+import type { ActiveOperation, AgentTelemetry, ExecutionContext } from "./types.js";
+/** Runs `execute` exactly once, even when the telemetry cannot enter the context. */
+export declare function runTraceContext<T>(telemetry: Pick<AgentTelemetry, "run" | "suppressed">, operation: ActiveOperation, execute: () => T, host?: ExecutionContext): T;

package/dist/src/compiled/@eve/tracing/core/delegation.d.ts

@@ -0,0 +1,13 @@
+import type { CaptureDecision, TraceReference } from "./types.js";
+export interface AgentHandoff {
+    readonly caller: TraceReference;
+    readonly conversationId: string;
+    readonly parentRunId: string;
+    readonly parentCallId: string;
+    readonly agentName: string;
+    readonly capture: CaptureDecision;
+    /** Set when the handoff crossed a process boundary; the callee then starts its own trace. */
+    readonly remote?: boolean;
+}
+export declare const currentAgentHandoff: () => AgentHandoff | undefined;
+export declare function withAgentHandoff<T>(handoff: AgentHandoff, execute: () => T): T;

package/dist/src/compiled/@eve/tracing/core/mcp.d.ts

@@ -0,0 +1,24 @@
+import type { Attributes } from "./types.js";
+import type { ContentSerializer } from "./types.js";
+export interface McpUpdate {
+    readonly connectionName?: string;
+    readonly method?: string;
+    readonly toolName?: string;
+    readonly protocolVersion?: string;
+    readonly requestId?: string;
+    readonly sessionId?: string;
+    readonly statusCode?: string | number;
+}
+export interface McpLifecycle {
+    update(input: McpUpdate): void;
+    error(error?: unknown, type?: string): void;
+    arguments(value: unknown): void;
+    result(value: unknown): void;
+}
+export declare function mcpLifecycle(input: {
+    readonly write: (attributes: Attributes) => void;
+    readonly error: (error?: unknown, type?: string) => void;
+    readonly serializer: ContentSerializer;
+    readonly recordInputs: boolean;
+    readonly recordOutputs: boolean;
+}): McpLifecycle;