eve 0.78.0 → 0.79.1

package/CHANGELOG.md

@@ -1,5 +1,48 @@
 # eve
 
+## 0.79.1
+
+### Patch Changes
+
+- 68b9d58: Approved `defineTool` calls can read who approved them: `ctx.approval.responder` is the approver and `ctx.approval.responder.getToken(provider)` resolves their token, while the call still runs as the requester.
+- 620022b: The Braintrust eval reporter no longer aborts the run when an eval produces no agent output. Those evals are now logged with an empty output.
+- 2e45423: Allow `eve/client` to use an `AbortSignal` that does not implement `throwIfAborted`, including the signal provided by React Native.
+- afa7741: Sync dynamic skill files to the sandbox about 7× faster by writing them concurrently.
+- 70f75ed: Connection sign-in callback URLs no longer include `VERCEL_AUTOMATION_BYPASS_SECRET`, so the secret stays out of the links shown to users and the `redirect_uri` sent to providers. On a deployment behind Deployment Protection, the person signing in now passes protection on their own, for example through Vercel Authentication or a Deployment Protection Exception.
+- 4c6fc60: Record `agent.input.messages.omitted` on model spans when the oldest prompt messages are dropped to fit the 32 KB content cap, so a long conversation no longer looks like it starts partway through.
+- 7f5a5e6: Reading a session stream whose history passed the World's retention now returns `410` with `code: "session_expired"` instead of a retryable `503` or `404`. The TypeScript client fails on the first response instead of retrying for about 38 seconds.
+- 624be47: Pass `followIdle: false` to `useEveAgent()` (React, Vue, and Svelte) or `EveAgentStore` to close the session stream while the session is idle instead of reconnecting it indefinitely. The stream reopens from its cursor on the next send, answer, or resume, and a prewarmed session opens no stream until its first message.
+- 4bf1efa: Propagate configured trace context at each AI Gateway model request.
+- 7921fb0: Self-modification now rejects target branch names Git rejects: path components starting with `.` (such as `.hidden` or `feature/.hidden`) and names containing the DEL character.
+- 71479ce: Let a message sent with `turnPolicy: "queue"` right after a tool approval or sign-in appears steer the held turn again. A message that arrived while the step raising the request was still finishing was treated as sent before the request, so it stayed queued behind a turn that could not end until the person acted.
+- 0fd4240: Honor explicit OpenTelemetry trace policies that enable inputs or outputs for DMs, private channels, and unknown audiences. Default capture remains audience-aware, and inherited capture limits and destination redaction still apply.
+- 3aa9a3a: Expose the live Vercel Sandbox name on `VercelSandboxSession` so tools can create Vercel git-credential-broker grants scoped to their session sandbox.
+- 9d046f8: Memory provider tools are now offered on a turn whose message carries a file attachment. Before, the agent lost its memory tools on exactly that turn.
+- 8d5b75f: `eve build` now works for apps with mounted extensions on filesystems without hard-link support, such as some NFS and FUSE mounts. It no longer fails with `Unknown system error -524` while writing the authored module map.
+- d8414ad: OpenAPI connections whose operation names collide at 64 characters now keep the suffixed tool names within the 64-character provider limit.
+- 8f336b8: Prewarm new Web Chat sessions when the user starts typing, so durable session startup overlaps with composing the first message.
+- 0dea0de: Keep a message sent with `turnPolicy: "queue"` before a tool approval or sign-in was requested in the queue, so it can no longer answer a prompt the person had not seen. Messages sent after the prompt still steer the held turn.
+- d7fef87: Import skills with structured or non-string metadata without failing, treating metadata outside eve's modeled shape like other unmodeled frontmatter.
+- f2e0f67: Vercel sandbox creation now reads `VERCEL_TOKEN`, `VERCEL_TEAM_ID`/`VERCEL_ORG_ID`, and `VERCEL_PROJECT_ID` from the environment, like sandbox lookup and deletion already do. A CI runner without a linked project can now create sandboxes.
+- a4af301: Labeled assertions now report to Braintrust and Datadog under their label, so `t.score(x).label("grounding")` logs as `grounding` instead of `score [grounding]` or `score_grounding`. Display names in the console and run artifacts are unchanged, and labeled metrics start a new series under the bare label.
+- d91d27c: Keep the answer a turn already wrote when it waits on tasks and resumes without new text, so `MessageResponse` results, `eve invoke`, and eval turns no longer report an empty message.
+- 57d4272: Connections that share a host, such as Jira and Confluence on one Atlassian domain, no longer trigger the "could not assign a unique toolResultFrom identity" warning, and `toolResultFrom` now accepts OpenAPI connections, including ones without a `baseUrl`.
+- 0e6bc96: `eve build` now reports why an extension mount failed to resolve, for example an extension that requires an unsupported tool contract or a package that isn't installed. Before, the build stopped with `Selected module binding "extensions/<name>.ts" has no compile or runtime usage.` and hid the cause.
+
+## 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/chunks/{use-eve-agent-BSYe_Re7.js → use-eve-agent-Ch-Q-s12.js}

@@ -4,6 +4,22 @@ import { z } from "#compiled/zod/index.js";
 import "ai";
 import { Validator } from "#compiled/@cfworker/json-schema/index.js";
 
+//#region src/client/abort-signal.ts
+function throwIfAborted(signal) {
+	if (signal === void 0) return;
+	const nativeThrowIfAborted = signal.throwIfAborted;
+	if (typeof nativeThrowIfAborted === "function") {
+		nativeThrowIfAborted.call(signal);
+		return;
+	}
+	if (!signal.aborted) return;
+	if (signal.reason !== void 0) throw signal.reason;
+	const error = /* @__PURE__ */ new Error("The operation was aborted.");
+	error.name = "AbortError";
+	throw error;
+}
+
+//#endregion
 //#region src/protocol/routes.ts
 const EVE_ROUTE_PREFIX = "/eve/v1";
 const EVE_PRODUCTION_CRON_ROUTE_PATTERN = `${EVE_ROUTE_PREFIX}/cron/:token`;
@@ -1152,7 +1168,6 @@ function summarizeTurnEvents(events) {
 		if (segment.observe(event)) boundary = event;
 		if (isTurnFailureEvent(event)) failure = event;
 		if (isFinalMessageCompleted(event)) message = event.data.message ?? void 0;
-		if (event.type === "turn.waiting") message = void 0;
 	}
 	return {
 		boundary,
@@ -1336,9 +1351,9 @@ async function* readNdjsonStream(body, options) {
 	options.signal?.addEventListener("abort", abort, { once: true });
 	try {
 		while (true) {
-			options.signal?.throwIfAborted();
+			throwIfAborted(options.signal);
 			const result = await readWithIdleTimeout(reader, options?.idleTimeoutMs);
-			options.signal?.throwIfAborted();
+			throwIfAborted(options.signal);
 			if (result.done) {
 				reachedEof = true;
 				buffer += decoder.decode();
@@ -1616,10 +1631,10 @@ async function openStreamBody(input) {
 	if (input.requestTailIndex === true) searchParams.includeTailIndex = "1";
 	if (input.follow === false) searchParams.follow = "false";
 	for (let attempt = 0; attempt < openRetryPolicy.maxAttempts; attempt += 1) {
-		input.signal?.throwIfAborted();
+		throwIfAborted(input.signal);
 		const url = createClientUrl(input.host, input.path, Object.keys(searchParams).length > 0 ? searchParams : void 0);
 		const headers = await input.resolveHeaders();
-		input.signal?.throwIfAborted();
+		throwIfAborted(input.signal);
 		const connectionController = new AbortController();
 		const signal = input.signal ? AbortSignal.any([input.signal, connectionController.signal]) : connectionController.signal;
 		let response;
@@ -2325,14 +2340,14 @@ var ClientSession = class ClientSession {
 		return this.#state;
 	}
 	async snapshot(options) {
-		options?.signal?.throwIfAborted();
+		throwIfAborted(options?.signal);
 		const events = [];
 		for await (const event of this.#readStream({
 			follow: false,
 			signal: options?.signal,
 			startIndex: 0
 		})) events.push(event);
-		options?.signal?.throwIfAborted();
+		throwIfAborted(options?.signal);
 		return {
 			events,
 			session: {
@@ -2500,7 +2515,7 @@ async function postSessionSend(context, path, input) {
 			if (remainingMs <= 0) throw error;
 			await sleep(Math.min(retryDelayMs, remainingMs), input.signal);
 		}
-		input.signal?.throwIfAborted();
+		throwIfAborted(input.signal);
 		retryDelayMs = Math.min(retryDelayMs * 2, SESSION_SEND_RETRY_MAX_DELAY_MS);
 	}
 }
@@ -4198,11 +4213,14 @@ var ConversationClient = class {
 		this.#stream = new SessionEventStream(session, options);
 		return this.#stream;
 	}
+	closeStream() {
+		this.#stream?.close();
+		this.#stream = void 0;
+	}
 	stop() {
 		this.#follower?.abortAll();
 		this.#follower = void 0;
-		this.#stream?.close();
-		this.#stream = void 0;
+		this.closeStream();
 	}
 	reset() {
 		this.stop();
@@ -4223,7 +4241,7 @@ async function dispatchSessionTurn(input) {
 			...turn,
 			message: turn.message
 		});
-		turn.signal?.throwIfAborted();
+		throwIfAborted(turn.signal);
 		return {
 			...created,
 			created: true
@@ -4256,6 +4274,7 @@ var EveAgentStore = class {
 	#attached = false;
 	#conversationClient;
 	#followChildStreams;
+	#followIdle;
 	#externalSession;
 	#subscribers = /* @__PURE__ */ new Set();
 	#activeTurn;
@@ -4273,6 +4292,7 @@ var EveAgentStore = class {
 	constructor(init) {
 		this.#autoPrewarm = init.prewarm ?? false;
 		this.#followChildStreams = init.followSubagents ?? false;
+		this.#followIdle = init.followIdle ?? true;
 		this.#externalSession = init.session !== void 0;
 		this.#client = this.#externalSession ? void 0 : init.client ?? new Client({
 			auth: init.auth,
@@ -4313,7 +4333,7 @@ var EveAgentStore = class {
 				this.#error = void 0;
 				if (this.#status === "error") this.#status = "ready";
 				this.#adoptSession(created.session);
-				this.#ensureStream();
+				if (this.#followIdle) this.#ensureStream();
 			} catch (error) {
 				if (generation === this.#prewarmGeneration && this.#activeTurn === void 0 && this.#error === void 0) this.#fail(error);
 				throw error;
@@ -4569,7 +4589,7 @@ var EveAgentStore = class {
 			await waitWithSignal(this.#prewarmPromise.catch((error) => {
 				if (this.#session !== void 0) throw error;
 			}), input.signal);
-			input.signal?.throwIfAborted();
+			throwIfAborted(input.signal);
 		}
 		const session = this.#session;
 		let reader;
@@ -4635,6 +4655,7 @@ var EveAgentStore = class {
 		if (!this.#isActiveTurn(turn)) return;
 		turn.resolveResponse(void 0);
 		this.#activeTurn = void 0;
+		this.#closeStreamWhenIdle();
 		try {
 			this.#callbacks.onSessionChange?.(this.#session?.state);
 			this.#publish();
@@ -4668,8 +4689,16 @@ var EveAgentStore = class {
 		this.#callbacks.onSessionChange?.(this.#session?.state);
 		if (this.#status !== "resuming") this.#publish();
 		if (this.#activeTurn === void 0 && wasStreaming && settled) this.#callbacks.onFinish?.(this.#snapshot);
+		if (this.#activeTurn === void 0) this.#closeStreamWhenIdle();
 		return true;
 	}
+	#closeStreamWhenIdle() {
+		if (this.#followIdle) return;
+		const { conversation } = this.#conversationClient;
+		if (conversation.activeTurnId !== void 0) return;
+		if (this.#events.length > 0 && !isSettledSessionTail(this.#events, conversation)) return;
+		if (!Object.values(conversation.tasks).some((task) => Object.values(task.calls).some((call) => call.status === "working"))) this.#conversationClient.closeStream();
+	}
 	#correlate(submissionId, response) {
 		const deliveryId = getMessageResponseDeliveryId(response);
 		const reconciled = this.#messageSubmissions.correlate(submissionId, deliveryId, this.#events);
@@ -4809,6 +4838,7 @@ function useEveAgent(options = {}) {
 		initialSession: options.initialSession,
 		optimistic: options.optimistic,
 		followSubagents: options.followSubagents,
+		followIdle: options.followIdle,
 		prewarm: options.prewarm,
 		reducer,
 		session: options.session

package/dist/src/chunks/{use-eve-agent-B8brxCk-.js → use-eve-agent-Vsl-S0yI.js}

@@ -3,6 +3,22 @@ import { z } from "#compiled/zod/index.js";
 import "ai";
 import { Validator } from "#compiled/@cfworker/json-schema/index.js";
 
+//#region src/client/abort-signal.ts
+function throwIfAborted(signal) {
+	if (signal === void 0) return;
+	const nativeThrowIfAborted = signal.throwIfAborted;
+	if (typeof nativeThrowIfAborted === "function") {
+		nativeThrowIfAborted.call(signal);
+		return;
+	}
+	if (!signal.aborted) return;
+	if (signal.reason !== void 0) throw signal.reason;
+	const error = /* @__PURE__ */ new Error("The operation was aborted.");
+	error.name = "AbortError";
+	throw error;
+}
+
+//#endregion
 //#region src/protocol/routes.ts
 const EVE_ROUTE_PREFIX = "/eve/v1";
 const EVE_PRODUCTION_CRON_ROUTE_PATTERN = `${EVE_ROUTE_PREFIX}/cron/:token`;
@@ -1151,7 +1167,6 @@ function summarizeTurnEvents(events) {
 		if (segment.observe(event)) boundary = event;
 		if (isTurnFailureEvent(event)) failure = event;
 		if (isFinalMessageCompleted(event)) message = event.data.message ?? void 0;
-		if (event.type === "turn.waiting") message = void 0;
 	}
 	return {
 		boundary,
@@ -1335,9 +1350,9 @@ async function* readNdjsonStream(body, options) {
 	options.signal?.addEventListener("abort", abort, { once: true });
 	try {
 		while (true) {
-			options.signal?.throwIfAborted();
+			throwIfAborted(options.signal);
 			const result = await readWithIdleTimeout(reader, options?.idleTimeoutMs);
-			options.signal?.throwIfAborted();
+			throwIfAborted(options.signal);
 			if (result.done) {
 				reachedEof = true;
 				buffer += decoder.decode();
@@ -1615,10 +1630,10 @@ async function openStreamBody(input) {
 	if (input.requestTailIndex === true) searchParams.includeTailIndex = "1";
 	if (input.follow === false) searchParams.follow = "false";
 	for (let attempt = 0; attempt < openRetryPolicy.maxAttempts; attempt += 1) {
-		input.signal?.throwIfAborted();
+		throwIfAborted(input.signal);
 		const url = createClientUrl(input.host, input.path, Object.keys(searchParams).length > 0 ? searchParams : void 0);
 		const headers = await input.resolveHeaders();
-		input.signal?.throwIfAborted();
+		throwIfAborted(input.signal);
 		const connectionController = new AbortController();
 		const signal = input.signal ? AbortSignal.any([input.signal, connectionController.signal]) : connectionController.signal;
 		let response;
@@ -2324,14 +2339,14 @@ var ClientSession = class ClientSession {
 		return this.#state;
 	}
 	async snapshot(options) {
-		options?.signal?.throwIfAborted();
+		throwIfAborted(options?.signal);
 		const events = [];
 		for await (const event of this.#readStream({
 			follow: false,
 			signal: options?.signal,
 			startIndex: 0
 		})) events.push(event);
-		options?.signal?.throwIfAborted();
+		throwIfAborted(options?.signal);
 		return {
 			events,
 			session: {
@@ -2499,7 +2514,7 @@ async function postSessionSend(context, path, input) {
 			if (remainingMs <= 0) throw error;
 			await sleep(Math.min(retryDelayMs, remainingMs), input.signal);
 		}
-		input.signal?.throwIfAborted();
+		throwIfAborted(input.signal);
 		retryDelayMs = Math.min(retryDelayMs * 2, SESSION_SEND_RETRY_MAX_DELAY_MS);
 	}
 }
@@ -4197,11 +4212,14 @@ var ConversationClient = class {
 		this.#stream = new SessionEventStream(session, options);
 		return this.#stream;
 	}
+	closeStream() {
+		this.#stream?.close();
+		this.#stream = void 0;
+	}
 	stop() {
 		this.#follower?.abortAll();
 		this.#follower = void 0;
-		this.#stream?.close();
-		this.#stream = void 0;
+		this.closeStream();
 	}
 	reset() {
 		this.stop();
@@ -4222,7 +4240,7 @@ async function dispatchSessionTurn(input) {
 			...turn,
 			message: turn.message
 		});
-		turn.signal?.throwIfAborted();
+		throwIfAborted(turn.signal);
 		return {
 			...created,
 			created: true
@@ -4255,6 +4273,7 @@ var EveAgentStore = class {
 	#attached = false;
 	#conversationClient;
 	#followChildStreams;
+	#followIdle;
 	#externalSession;
 	#subscribers = /* @__PURE__ */ new Set();
 	#activeTurn;
@@ -4272,6 +4291,7 @@ var EveAgentStore = class {
 	constructor(init) {
 		this.#autoPrewarm = init.prewarm ?? false;
 		this.#followChildStreams = init.followSubagents ?? false;
+		this.#followIdle = init.followIdle ?? true;
 		this.#externalSession = init.session !== void 0;
 		this.#client = this.#externalSession ? void 0 : init.client ?? new Client({
 			auth: init.auth,
@@ -4312,7 +4332,7 @@ var EveAgentStore = class {
 				this.#error = void 0;
 				if (this.#status === "error") this.#status = "ready";
 				this.#adoptSession(created.session);
-				this.#ensureStream();
+				if (this.#followIdle) this.#ensureStream();
 			} catch (error) {
 				if (generation === this.#prewarmGeneration && this.#activeTurn === void 0 && this.#error === void 0) this.#fail(error);
 				throw error;
@@ -4568,7 +4588,7 @@ var EveAgentStore = class {
 			await waitWithSignal(this.#prewarmPromise.catch((error) => {
 				if (this.#session !== void 0) throw error;
 			}), input.signal);
-			input.signal?.throwIfAborted();
+			throwIfAborted(input.signal);
 		}
 		const session = this.#session;
 		let reader;
@@ -4634,6 +4654,7 @@ var EveAgentStore = class {
 		if (!this.#isActiveTurn(turn)) return;
 		turn.resolveResponse(void 0);
 		this.#activeTurn = void 0;
+		this.#closeStreamWhenIdle();
 		try {
 			this.#callbacks.onSessionChange?.(this.#session?.state);
 			this.#publish();
@@ -4667,8 +4688,16 @@ var EveAgentStore = class {
 		this.#callbacks.onSessionChange?.(this.#session?.state);
 		if (this.#status !== "resuming") this.#publish();
 		if (this.#activeTurn === void 0 && wasStreaming && settled) this.#callbacks.onFinish?.(this.#snapshot);
+		if (this.#activeTurn === void 0) this.#closeStreamWhenIdle();
 		return true;
 	}
+	#closeStreamWhenIdle() {
+		if (this.#followIdle) return;
+		const { conversation } = this.#conversationClient;
+		if (conversation.activeTurnId !== void 0) return;
+		if (this.#events.length > 0 && !isSettledSessionTail(this.#events, conversation)) return;
+		if (!Object.values(conversation.tasks).some((task) => Object.values(task.calls).some((call) => call.status === "working"))) this.#conversationClient.closeStream();
+	}
 	#correlate(submissionId, response) {
 		const deliveryId = getMessageResponseDeliveryId(response);
 		const reconciled = this.#messageSubmissions.correlate(submissionId, deliveryId, this.#events);
@@ -4741,6 +4770,7 @@ function useEveAgent(options = {}) {
 		initialSession: options.initialSession,
 		optimistic: options.optimistic,
 		followSubagents: options.followSubagents,
+		followIdle: options.followIdle,
 		prewarm: options.prewarm,
 		reducer,
 		session: options.session

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/client/abort-signal.d.ts

@@ -0,0 +1,2 @@
+/** Throws the signal's abort reason without requiring AbortSignal#throwIfAborted support. */
+export declare function throwIfAborted(signal: AbortSignal | undefined): void;

package/dist/src/client/abort-signal.js

@@ -0,0 +1 @@
+function throwIfAborted(e){if(e===void 0)return;let t=e.throwIfAborted;if(typeof t==`function`){t.call(e);return}if(!e.aborted)return;if(e.reason!==void 0)throw e.reason;let n=Error(`The operation was aborted.`);throw n.name=`AbortError`,n}export{throwIfAborted};