eve 0.25.3 → 0.26.0

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # eve
 
+## 0.26.0
+
+### Minor Changes
+
+- 26504e9: The client now reconnects durable event streams from their last cursor, so long turns continue across transient connection cuts without replaying events. Stream retries are now managed internally, interrupted sessions remain resumable, and `maxReconnectAttempts` has been removed from `ClientOptions`, `EveAgentStoreInit`, and the React, Svelte, and Vue `UseEveAgentOptions` APIs.
+
+### Patch Changes
+
+- 82fba04: Provide dynamic tools with the full auth-capable `ToolContext`, including `ctx.getToken(provider)` and `ctx.requireAuth(provider)`, across live execution and durable replay.
+- 82fba04: Canonicalize Windows publication-lock watcher paths to avoid Node/libuv crashes when temporary directories use 8.3 short names.
+- 51beea7: Workflow now keeps sandbox bridge capacity aligned with its configured `maxSubagents` budget, so large `Promise.all` fan-outs park and dispatch child sessions instead of failing at code mode's lower internal concurrency limit.
+- 9a1800f: Fix `experimental_chatgpt` sending requests in an improper format that the
+  Codex backend rejected with a 400 Bad Request: system instructions are now sent
+  in the top-level `instructions` field and the unsupported `max_output_tokens`
+  parameter is dropped.
+- 65a7823: `eve dev` now writes a private per-process diagnostic log under `.eve/logs/` capturing stderr, stdout (including sandbox and rebuild lines), tool failures, workflow errors, and eve framework log records (stored structured, with level, namespace, and JSON fields). The file is JSON Lines: every line is one JSON record with `at` and `source` fields. Long stderr output collapses in the transcript to a one-line summary pointing at the log file (the raw text stays available in the `all` log mode), and error details reference the log instead of flooding the transcript.
+- 65a7823: `eve dev` now writes an environment dump next to each diagnostic log (`.eve/logs/dev-<instance>.dump`): one JSON document capturing eve, Node.js, and Vercel CLI versions, the Vercel CLI path, local session-store size, and running session stats (prompts, token usage, tool calls by name, subagent dispatches). `eve logs --dump` prints the dump and its JSONL log together as one parseable report.
+- 65a7823: The dev TUI's `/model` "Change model" row now opens a value menu — Model, Reasoning effort, Service tier, Done. Reasoning and tier adjust inline with `←`/`→` (Tab acts as `→`, both wrap as a ring): a `●─◉─○` track slides over the model's supported effort levels — snapping to the closest supported level when a pick changes what the model serves — and the tier flips between `fast ↯` and `normal`; the tier row disappears when the catalog prices no priority tier for the model. Enter on Model opens the searchable catalog as model ids on a `▏` rail — the same railed list component the team and project pickers now render with. All drafted changes commit through one atomic `agent.ts` edit. The provider picker marks and describes the currently-active provider and reports an accepted key as `AI_GATEWAY_API_KEY set.`. Linking an existing project now suggests the team project named after the agent, searching for it when it is not among the recents. Command cancellations now read "dismissed". The status line drops its `·` separators and shows the model as `slug@level ↯`.
+- 65a7823: New `eve logs` command for reading the diagnostic logs `eve dev` writes under `.eve/logs/`: `eve logs` prints the most recent log, `eve logs ls [--json]` lists them, and `eve logs <logid>` prints a specific log by id, file name, transcript path, or unambiguous prefix.
+- 65a7823: `eve logs --events` interleaves session events (session/turn/step lifecycle, message deltas) into the diagnostic-log output, resolved at query time from the local workflow store — nothing extra is written while `eve dev` runs.
+- b53d713: Fixed transient TUI and CLI output rendering by standardizing spinners and progress rows on the shared `LiveRegion`. Streamed command output now stays aligned beneath active spinners, while failed operations preserve their command transcript for diagnostics.
+- 65a7823: Errors that escape a session — not just model-call failures — now pass through a semantic-error catalog: declarative, linter-style rules applied to any thrown error. Rules cover AI Gateway (auth, model-not-found, rate limits, upstream availability), model providers (missing API keys, unsupported capabilities), the durable workflow runtime (store version/access, replay divergence, corrupted event logs), sandbox backends (Docker CLI/daemon, provisioning), and system failures (port in use, disk full, network dials). Matched failures render a stable, actionable summary in the transcript with the raw error routed to the `eve dev` diagnostic log, and failure events carry a stable `semanticErrorId` for correlation.
+
 ## 0.25.3
 
 ### Patch Changes

package/dist/src/chunks/{use-eve-agent-Cy73lgA6.js → use-eve-agent-BkztZA0v.js}

@@ -176,6 +176,15 @@ const AgentInfoResultSchema = z.object({
 			contextWindowTokens: z.number().optional(),
 			id: z.string(),
 			providerOptions: z.unknown().optional(),
+			reasoning: z.enum([
+				"provider-default",
+				"none",
+				"minimal",
+				"low",
+				"medium",
+				"high",
+				"xhigh"
+			]).optional().catch(void 0),
 			source: source.optional(),
 			routing: modelRouting.optional(),
 			endpoint: modelEndpoint.optional()
@@ -326,6 +335,11 @@ function advanceSession(input) {
 		sessionId: input.sessionId,
 		streamIndex
 	};
+	if (boundaryEvent === void 0) return {
+		continuationToken: input.continuationToken ?? input.session.continuationToken,
+		sessionId: input.sessionId,
+		streamIndex
+	};
 	return createInitialSessionState();
 }
 function extractCompletedMessage(events) {
@@ -458,7 +472,8 @@ function formatSearch(searchParams) {
 //#endregion
 //#region src/client/open-stream.ts
 const STREAM_OPEN_RETRY_ATTEMPTS = 12;
-const STREAM_OPEN_RETRY_DELAY_MS = 250;
+const STREAM_OPEN_RETRY_BASE_DELAY_MS = 250;
+const STREAM_OPEN_RETRY_MAX_DELAY_MS = 5e3;
 const STREAM_OPEN_RETRYABLE_STATUS = new Set([
 	404,
 	409,
@@ -468,32 +483,50 @@ const STREAM_OPEN_RETRYABLE_STATUS = new Set([
 	503,
 	504
 ]);
-async function* openStreamIterable(input) {
+const STREAM_RECONNECT_BASE_DELAY_MS = 250;
+const STREAM_RECONNECT_MAX_DELAY_MS = 4e3;
+const STREAM_MAX_IDLE_RECONNECTS = 5;
+async function* followStreamIterable(input) {
 	let startIndex = input.startIndex;
-	let remainingReconnectAttempts = input.startIndex < 0 ? 0 : input.maxReconnectAttempts;
+	let reconnectDelayMs = STREAM_RECONNECT_BASE_DELAY_MS;
+	let idleReconnects = 0;
+	let initialConnection = true;
 	while (true) {
-		const body = await openStreamBody({
-			...input,
-			startIndex
-		});
-		let disconnected = false;
+		let body;
+		try {
+			body = await openStreamBody({
+				...input,
+				startIndex
+			});
+		} catch (error) {
+			if (input.signal?.aborted) return;
+			throw error;
+		}
+		let deliveredEvent = false;
 		try {
 			for await (const event of readNdjsonStream(body)) {
 				startIndex += 1;
+				deliveredEvent = true;
+				reconnectDelayMs = STREAM_RECONNECT_BASE_DELAY_MS;
+				idleReconnects = 0;
 				yield event;
 			}
 		} catch (error) {
 			if (!isStreamDisconnectError(error)) throw error;
-			disconnected = true;
 		}
-		if (!disconnected || input.signal?.aborted || remainingReconnectAttempts <= 0) return;
-		remainingReconnectAttempts -= 1;
+		if (input.signal?.aborted || input.startIndex < 0) return;
+		if (!deliveredEvent && !initialConnection && (idleReconnects += 1) >= STREAM_MAX_IDLE_RECONNECTS) return;
+		initialConnection = false;
+		await sleep$1(reconnectDelayMs, input.signal);
+		if (input.signal?.aborted) return;
+		reconnectDelayMs = Math.min(reconnectDelayMs * 2, STREAM_RECONNECT_MAX_DELAY_MS);
 	}
 }
 async function openStreamBody(input) {
 	let lastStatus;
 	let lastBody;
 	let lastHeaders;
+	let retryDelayMs = STREAM_OPEN_RETRY_BASE_DELAY_MS;
 	for (let attempt = 0; attempt < STREAM_OPEN_RETRY_ATTEMPTS; attempt += 1) {
 		const url = createClientUrl(input.host, createEveMessageStreamRoutePath(input.sessionId), input.startIndex !== 0 ? { startIndex: String(input.startIndex) } : void 0);
 		const headers = await input.resolveHeaders();
@@ -506,7 +539,8 @@ async function openStreamBody(input) {
 			});
 		} catch (error) {
 			if (input.signal?.aborted || !isStreamDisconnectError(error) || attempt === STREAM_OPEN_RETRY_ATTEMPTS - 1) throw error;
-			await sleep$1(STREAM_OPEN_RETRY_DELAY_MS);
+			await sleep$1(retryDelayMs, input.signal);
+			retryDelayMs = Math.min(retryDelayMs * 2, STREAM_OPEN_RETRY_MAX_DELAY_MS);
 			continue;
 		}
 		if (response.ok) {
@@ -517,12 +551,26 @@ async function openStreamBody(input) {
 		lastBody = await response.text();
 		lastHeaders = response.headers;
 		if (!STREAM_OPEN_RETRYABLE_STATUS.has(response.status)) throw new ClientError(response.status, lastBody, response.headers);
-		if (attempt < STREAM_OPEN_RETRY_ATTEMPTS - 1) await sleep$1(STREAM_OPEN_RETRY_DELAY_MS);
+		if (attempt < STREAM_OPEN_RETRY_ATTEMPTS - 1) {
+			await sleep$1(retryDelayMs, input.signal);
+			retryDelayMs = Math.min(retryDelayMs * 2, STREAM_OPEN_RETRY_MAX_DELAY_MS);
+		}
 	}
 	throw new ClientError(lastStatus ?? 0, lastBody ?? "Failed to open message stream.", lastHeaders);
 }
-async function sleep$1(ms) {
-	await new Promise((resolve) => setTimeout(resolve, ms));
+async function sleep$1(ms, signal) {
+	if (signal?.aborted) return;
+	await new Promise((resolve) => {
+		const onAbort = () => {
+			clearTimeout(timer);
+			resolve();
+		};
+		const timer = setTimeout(() => {
+			signal?.removeEventListener("abort", onAbort);
+			resolve();
+		}, ms);
+		signal?.addEventListener("abort", onAbort, { once: true });
+	});
 }
 
 //#endregion
@@ -682,28 +730,17 @@ var ClientSession = class {
 	async *#createEventStream(sessionId, continuationToken, initialState, input) {
 		const events = [];
 		try {
-			let currentStreamIndex = initialState.sessionId === sessionId ? initialState.streamIndex : 0;
-			let remainingReconnectAttempts = this.#context.maxReconnectAttempts;
-			while (true) {
-				const body = await this.#openStreamBody(sessionId, currentStreamIndex, input.signal, input.headers);
-				let foundBoundary = false;
-				try {
-					for await (const event of readNdjsonStream(body)) {
-						events.push(event);
-						currentStreamIndex += 1;
-						yield event;
-						if (isCurrentTurnBoundaryEvent(event)) {
-							foundBoundary = true;
-							break;
-						}
-					}
-				} catch (error) {
-					if (!isStreamDisconnectError(error)) throw error;
-				}
-				if (foundBoundary) break;
-				if (input.signal?.aborted) break;
-				if (remainingReconnectAttempts <= 0) break;
-				remainingReconnectAttempts -= 1;
+			for await (const event of followStreamIterable({
+				host: this.#context.host,
+				resolveHeaders: () => this.#context.resolveHeaders(input.headers),
+				redirect: this.#context.redirect,
+				sessionId,
+				signal: input.signal,
+				startIndex: initialState.sessionId === sessionId ? initialState.streamIndex : 0
+			})) {
+				events.push(event);
+				yield event;
+				if (isCurrentTurnBoundaryEvent(event)) break;
 			}
 		} finally {
 			this.#state = advanceSession({
@@ -715,24 +752,13 @@ var ClientSession = class {
 			});
 		}
 	}
-	async #openStreamBody(sessionId, startIndex, signal, headers) {
-		return await openStreamBody({
-			host: this.#context.host,
-			resolveHeaders: () => this.#context.resolveHeaders(headers),
-			redirect: this.#context.redirect,
-			sessionId,
-			signal,
-			startIndex
-		});
-	}
 	async *#streamAndAdvance(sessionId, options) {
 		const initialState = this.#state;
 		const streamIndex = options?.startIndex ?? initialState.streamIndex;
 		const events = [];
 		try {
-			for await (const event of openStreamIterable({
+			for await (const event of followStreamIterable({
 				host: this.#context.host,
-				maxReconnectAttempts: this.#context.maxReconnectAttempts,
 				resolveHeaders: () => this.#context.resolveHeaders(),
 				redirect: this.#context.redirect,
 				sessionId,
@@ -817,14 +843,12 @@ var Client = class {
 	#auth;
 	#headers;
 	#host;
-	#maxReconnectAttempts;
 	#preserveCompletedSessions;
 	#redirect;
 	constructor(options) {
 		this.#host = options.host;
 		this.#auth = options.auth;
 		this.#headers = options.headers;
-		this.#maxReconnectAttempts = options.maxReconnectAttempts ?? 3;
 		this.#preserveCompletedSessions = options.preserveCompletedSessions ?? false;
 		this.#redirect = options.redirect;
 	}
@@ -875,7 +899,6 @@ var Client = class {
 		else resolved = createInitialSessionState();
 		return new ClientSession({
 			host: this.#host,
-			maxReconnectAttempts: this.#maxReconnectAttempts,
 			preserveCompletedSessions: this.#preserveCompletedSessions,
 			redirect: this.#redirect,
 			resolveHeaders: (perRequest) => this.#resolveHeaders(perRequest)
@@ -951,8 +974,7 @@ var EveAgentStore = class {
 		this.#createSession = init.session ? void 0 : () => new Client({
 			auth: init.auth,
 			headers: init.headers,
-			host: init.host ?? "",
-			maxReconnectAttempts: init.maxReconnectAttempts
+			host: init.host ?? ""
 		}).session(init.initialSession);
 		this.#events = [...init.initialEvents ?? []];
 		this.#projectionEvents = [...this.#events];
@@ -1672,7 +1694,6 @@ function useEveAgent(options = {}) {
 		}),
 		initialEvents: options.initialEvents,
 		initialSession: options.initialSession,
-		maxReconnectAttempts: options.maxReconnectAttempts,
 		optimistic: options.optimistic,
 		reducer,
 		session: options.session

package/dist/src/chunks/{use-eve-agent-CQIeqmKc.js → use-eve-agent-CruinZmd.js}

@@ -176,6 +176,15 @@ const AgentInfoResultSchema = z.object({
 			contextWindowTokens: z.number().optional(),
 			id: z.string(),
 			providerOptions: z.unknown().optional(),
+			reasoning: z.enum([
+				"provider-default",
+				"none",
+				"minimal",
+				"low",
+				"medium",
+				"high",
+				"xhigh"
+			]).optional().catch(void 0),
 			source: source.optional(),
 			routing: modelRouting.optional(),
 			endpoint: modelEndpoint.optional()
@@ -326,6 +335,11 @@ function advanceSession(input) {
 		sessionId: input.sessionId,
 		streamIndex
 	};
+	if (boundaryEvent === void 0) return {
+		continuationToken: input.continuationToken ?? input.session.continuationToken,
+		sessionId: input.sessionId,
+		streamIndex
+	};
 	return createInitialSessionState();
 }
 function extractCompletedMessage(events) {
@@ -458,7 +472,8 @@ function formatSearch(searchParams) {
 //#endregion
 //#region src/client/open-stream.ts
 const STREAM_OPEN_RETRY_ATTEMPTS = 12;
-const STREAM_OPEN_RETRY_DELAY_MS = 250;
+const STREAM_OPEN_RETRY_BASE_DELAY_MS = 250;
+const STREAM_OPEN_RETRY_MAX_DELAY_MS = 5e3;
 const STREAM_OPEN_RETRYABLE_STATUS = new Set([
 	404,
 	409,
@@ -468,32 +483,50 @@ const STREAM_OPEN_RETRYABLE_STATUS = new Set([
 	503,
 	504
 ]);
-async function* openStreamIterable(input) {
+const STREAM_RECONNECT_BASE_DELAY_MS = 250;
+const STREAM_RECONNECT_MAX_DELAY_MS = 4e3;
+const STREAM_MAX_IDLE_RECONNECTS = 5;
+async function* followStreamIterable(input) {
 	let startIndex = input.startIndex;
-	let remainingReconnectAttempts = input.startIndex < 0 ? 0 : input.maxReconnectAttempts;
+	let reconnectDelayMs = STREAM_RECONNECT_BASE_DELAY_MS;
+	let idleReconnects = 0;
+	let initialConnection = true;
 	while (true) {
-		const body = await openStreamBody({
-			...input,
-			startIndex
-		});
-		let disconnected = false;
+		let body;
+		try {
+			body = await openStreamBody({
+				...input,
+				startIndex
+			});
+		} catch (error) {
+			if (input.signal?.aborted) return;
+			throw error;
+		}
+		let deliveredEvent = false;
 		try {
 			for await (const event of readNdjsonStream(body)) {
 				startIndex += 1;
+				deliveredEvent = true;
+				reconnectDelayMs = STREAM_RECONNECT_BASE_DELAY_MS;
+				idleReconnects = 0;
 				yield event;
 			}
 		} catch (error) {
 			if (!isStreamDisconnectError(error)) throw error;
-			disconnected = true;
 		}
-		if (!disconnected || input.signal?.aborted || remainingReconnectAttempts <= 0) return;
-		remainingReconnectAttempts -= 1;
+		if (input.signal?.aborted || input.startIndex < 0) return;
+		if (!deliveredEvent && !initialConnection && (idleReconnects += 1) >= STREAM_MAX_IDLE_RECONNECTS) return;
+		initialConnection = false;
+		await sleep$1(reconnectDelayMs, input.signal);
+		if (input.signal?.aborted) return;
+		reconnectDelayMs = Math.min(reconnectDelayMs * 2, STREAM_RECONNECT_MAX_DELAY_MS);
 	}
 }
 async function openStreamBody(input) {
 	let lastStatus;
 	let lastBody;
 	let lastHeaders;
+	let retryDelayMs = STREAM_OPEN_RETRY_BASE_DELAY_MS;
 	for (let attempt = 0; attempt < STREAM_OPEN_RETRY_ATTEMPTS; attempt += 1) {
 		const url = createClientUrl(input.host, createEveMessageStreamRoutePath(input.sessionId), input.startIndex !== 0 ? { startIndex: String(input.startIndex) } : void 0);
 		const headers = await input.resolveHeaders();
@@ -506,7 +539,8 @@ async function openStreamBody(input) {
 			});
 		} catch (error) {
 			if (input.signal?.aborted || !isStreamDisconnectError(error) || attempt === STREAM_OPEN_RETRY_ATTEMPTS - 1) throw error;
-			await sleep$1(STREAM_OPEN_RETRY_DELAY_MS);
+			await sleep$1(retryDelayMs, input.signal);
+			retryDelayMs = Math.min(retryDelayMs * 2, STREAM_OPEN_RETRY_MAX_DELAY_MS);
 			continue;
 		}
 		if (response.ok) {
@@ -517,12 +551,26 @@ async function openStreamBody(input) {
 		lastBody = await response.text();
 		lastHeaders = response.headers;
 		if (!STREAM_OPEN_RETRYABLE_STATUS.has(response.status)) throw new ClientError(response.status, lastBody, response.headers);
-		if (attempt < STREAM_OPEN_RETRY_ATTEMPTS - 1) await sleep$1(STREAM_OPEN_RETRY_DELAY_MS);
+		if (attempt < STREAM_OPEN_RETRY_ATTEMPTS - 1) {
+			await sleep$1(retryDelayMs, input.signal);
+			retryDelayMs = Math.min(retryDelayMs * 2, STREAM_OPEN_RETRY_MAX_DELAY_MS);
+		}
 	}
 	throw new ClientError(lastStatus ?? 0, lastBody ?? "Failed to open message stream.", lastHeaders);
 }
-async function sleep$1(ms) {
-	await new Promise((resolve) => setTimeout(resolve, ms));
+async function sleep$1(ms, signal) {
+	if (signal?.aborted) return;
+	await new Promise((resolve) => {
+		const onAbort = () => {
+			clearTimeout(timer);
+			resolve();
+		};
+		const timer = setTimeout(() => {
+			signal?.removeEventListener("abort", onAbort);
+			resolve();
+		}, ms);
+		signal?.addEventListener("abort", onAbort, { once: true });
+	});
 }
 
 //#endregion
@@ -682,28 +730,17 @@ var ClientSession = class {
 	async *#createEventStream(sessionId, continuationToken, initialState, input) {
 		const events = [];
 		try {
-			let currentStreamIndex = initialState.sessionId === sessionId ? initialState.streamIndex : 0;
-			let remainingReconnectAttempts = this.#context.maxReconnectAttempts;
-			while (true) {
-				const body = await this.#openStreamBody(sessionId, currentStreamIndex, input.signal, input.headers);
-				let foundBoundary = false;
-				try {
-					for await (const event of readNdjsonStream(body)) {
-						events.push(event);
-						currentStreamIndex += 1;
-						yield event;
-						if (isCurrentTurnBoundaryEvent(event)) {
-							foundBoundary = true;
-							break;
-						}
-					}
-				} catch (error) {
-					if (!isStreamDisconnectError(error)) throw error;
-				}
-				if (foundBoundary) break;
-				if (input.signal?.aborted) break;
-				if (remainingReconnectAttempts <= 0) break;
-				remainingReconnectAttempts -= 1;
+			for await (const event of followStreamIterable({
+				host: this.#context.host,
+				resolveHeaders: () => this.#context.resolveHeaders(input.headers),
+				redirect: this.#context.redirect,
+				sessionId,
+				signal: input.signal,
+				startIndex: initialState.sessionId === sessionId ? initialState.streamIndex : 0
+			})) {
+				events.push(event);
+				yield event;
+				if (isCurrentTurnBoundaryEvent(event)) break;
 			}
 		} finally {
 			this.#state = advanceSession({
@@ -715,24 +752,13 @@ var ClientSession = class {
 			});
 		}
 	}
-	async #openStreamBody(sessionId, startIndex, signal, headers) {
-		return await openStreamBody({
-			host: this.#context.host,
-			resolveHeaders: () => this.#context.resolveHeaders(headers),
-			redirect: this.#context.redirect,
-			sessionId,
-			signal,
-			startIndex
-		});
-	}
 	async *#streamAndAdvance(sessionId, options) {
 		const initialState = this.#state;
 		const streamIndex = options?.startIndex ?? initialState.streamIndex;
 		const events = [];
 		try {
-			for await (const event of openStreamIterable({
+			for await (const event of followStreamIterable({
 				host: this.#context.host,
-				maxReconnectAttempts: this.#context.maxReconnectAttempts,
 				resolveHeaders: () => this.#context.resolveHeaders(),
 				redirect: this.#context.redirect,
 				sessionId,
@@ -817,14 +843,12 @@ var Client = class {
 	#auth;
 	#headers;
 	#host;
-	#maxReconnectAttempts;
 	#preserveCompletedSessions;
 	#redirect;
 	constructor(options) {
 		this.#host = options.host;
 		this.#auth = options.auth;
 		this.#headers = options.headers;
-		this.#maxReconnectAttempts = options.maxReconnectAttempts ?? 3;
 		this.#preserveCompletedSessions = options.preserveCompletedSessions ?? false;
 		this.#redirect = options.redirect;
 	}
@@ -875,7 +899,6 @@ var Client = class {
 		else resolved = createInitialSessionState();
 		return new ClientSession({
 			host: this.#host,
-			maxReconnectAttempts: this.#maxReconnectAttempts,
 			preserveCompletedSessions: this.#preserveCompletedSessions,
 			redirect: this.#redirect,
 			resolveHeaders: (perRequest) => this.#resolveHeaders(perRequest)
@@ -951,8 +974,7 @@ var EveAgentStore = class {
 		this.#createSession = init.session ? void 0 : () => new Client({
 			auth: init.auth,
 			headers: init.headers,
-			host: init.host ?? "",
-			maxReconnectAttempts: init.maxReconnectAttempts
+			host: init.host ?? ""
 		}).session(init.initialSession);
 		this.#events = [...init.initialEvents ?? []];
 		this.#projectionEvents = [...this.#events];
@@ -1721,7 +1743,6 @@ function useEveAgent(options = {}) {
 		}),
 		initialEvents: options.initialEvents,
 		initialSession: options.initialSession,
-		maxReconnectAttempts: options.maxReconnectAttempts,
 		optimistic: options.optimistic,
 		reducer,
 		session: options.session

package/dist/src/cli/commands/logs-events.d.ts

@@ -0,0 +1,36 @@
+/**
+ * One session event read back from the local workflow store, shaped like a
+ * diagnostic-log line so `eve logs --events` output stays one uniform JSONL
+ * stream: `at` and `source` first, then the event identity and payload.
+ */
+export interface DevSessionEventLine {
+    readonly at: string;
+    readonly source: "event";
+    readonly runId: string;
+    readonly type: string;
+    readonly data?: unknown;
+}
+/** Time window (inclusive) of events to resolve, in wall-clock event time. */
+export interface DevSessionEventWindow {
+    readonly from: Date;
+    readonly to: Date;
+}
+/**
+ * Reads session events for one diagnostic-log window from the local
+ * workflow store (`.eve/.workflow-data`), at query time — nothing is
+ * duplicated at capture time.
+ *
+ * Runs are enumerated through the vendored Workflow World API and each
+ * run's default stream is decoded through `Run.getReadable()` — the same
+ * vendored read path the dev server uses to serve session streams over
+ * HTTP — never by touching the store's private chunk encoding. The world
+ * is opened for storage reads only: `start()` is never called, so queue
+ * redelivery cannot be triggered by a CLI read, and unclosed streams
+ * (crashed processes) are drained with an idle-timeout cancel instead of
+ * waiting for chunks that will never arrive.
+ *
+ * Returns an empty list when the store does not exist. Selection is by
+ * time window: events from any `eve dev` process in the window are
+ * included, since the store does not attribute runs to processes.
+ */
+export declare function readDevSessionEvents(appRoot: string, window: DevSessionEventWindow): Promise<DevSessionEventLine[]>;

package/dist/src/cli/commands/logs-events.js

@@ -0,0 +1,2 @@
+import{access}from"node:fs/promises";import{resolveLocalWorkflowWorldDataDirectory}from"#internal/workflow/local-world-data-directory.js";async function readDevSessionEvents(n,r){let i=resolveLocalWorkflowWorldDataDirectory(n);try{await access(i)}catch{return[]}let{createWorld:a}=await import(`#compiled/@workflow/world-local/index.js`),o=await import(`#internal/workflow/runtime.js`),s=a({dataDir:i});o.setWorld(s);let c=[];for(let e of await listRunsOverlappingWindow(s,r)){let t=await drainRunStream(o,s,e.runId);c.push(...parseSessionEventLines(t,e,r))}return c.sort((e,t)=>e.at.localeCompare(t.at))}async function listRunsOverlappingWindow(e,t){let n=[],r;do{let i=await e.runs.list({resolveData:`none`,pagination:r===void 0?{limit:100}:{cursor:r,limit:100}});for(let e of i.data)e.createdAt<=t.to&&e.updatedAt>=t.from&&n.push({runId:e.runId,createdAt:e.createdAt,updatedAt:e.updatedAt});r=i.hasMore&&i.cursor!==null?i.cursor:void 0}while(r!==void 0);return n}async function drainRunStream(e,t,n){let r=``,i=new TextDecoder;try{if(!(await e.listStreams(t,n)).some(e=>e===`user`||e.endsWith(`_user`)))return``;let a=e.getRun(n).getReadable({startIndex:0}).getReader();for(;;){let e=await Promise.race([a.read(),new Promise(e=>{setTimeout(()=>e(`idle`),1e3)})]);if(e===`idle`){await a.cancel();break}if(e.done)break;r+=typeof e.value==`string`?e.value:i.decode(e.value,{stream:!0})}}catch{return``}return r}function parseSessionEventLines(e,t,n){let r=[];for(let i of e.split(`
+`)){let e=parseSessionEvent(i);if(e===void 0)continue;let a=e.at??t.createdAt.toISOString();if(a<n.from.toISOString()||a>n.to.toISOString())continue;let o={at:a,source:`event`,runId:t.runId,type:e.type};e.data!==void 0&&(o.data=e.data),r.push(o)}return r}function parseSessionEvent(e){if(e.trim().length!==0)try{let t=JSON.parse(e);if(typeof t!=`object`||!t)return;let{type:n,data:r,meta:i}=t;if(typeof n!=`string`)return;let a=typeof i==`object`&&i&&typeof i.at==`string`?i.at:void 0,o={type:n};return a!==void 0&&(o.at=a),r!==void 0&&(o.data=r),o}catch{return}}export{readDevSessionEvents};

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

@@ -0,0 +1,64 @@
+import { type DevSessionEventLine, type DevSessionEventWindow } from "./logs-events.js";
+interface CliLogsLogger {
+    error(message: string): void;
+    log(message: string): void;
+}
+/** One `eve dev` diagnostic log file under `.eve/logs`. */
+export interface DevDiagnosticLogEntry {
+    /** Stable reference: the file name without the `.log` extension. */
+    readonly id: string;
+    readonly path: string;
+    /** Process start time encoded in the file name, when parseable. */
+    readonly startedAt: Date | undefined;
+    readonly sizeBytes: number;
+}
+/**
+ * Lists `eve dev` diagnostic logs for an app root, most recent first. The
+ * sortable timestamp prefix in each file name provides the ordering; a missing
+ * log directory yields an empty list.
+ */
+export declare function listDevDiagnosticLogs(appRoot: string): Promise<DevDiagnosticLogEntry[]>;
+/**
+ * Resolves a user-supplied log reference to one entry. Accepts the full id,
+ * the file name, the transcript's `.eve/logs/...` path, or any unambiguous
+ * prefix of the id (with or without the `dev-` lead).
+ */
+export declare function resolveDevDiagnosticLog(logs: readonly DevDiagnosticLogEntry[], reference: string): DevDiagnosticLogEntry;
+/** Options accepted by {@link runLogsShowCommand}. */
+export interface LogsShowCommandOptions {
+    /** Prepend the log's environment dump (the same-instance `.dump` sibling). */
+    dump?: boolean;
+    /** Interleave session events resolved from the local workflow store. */
+    events?: boolean;
+    /** Injectable event reader and clock; defaults to the real store and `Date.now`. */
+    readEvents?: (appRoot: string, window: DevSessionEventWindow) => Promise<DevSessionEventLine[]>;
+    now?: () => Date;
+}
+/**
+ * `eve logs [logid]`: prints one diagnostic log to stdout — the most recent
+ * when `logid` is omitted. The output carries nothing but records (no
+ * resolved-path banner, no progress notes on either stream), so
+ * `eve logs 2>&1 | jq` always parses; discover ids and paths with
+ * `eve logs ls`. With `--dump`, the log's environment dump (a JSON
+ * document) is prepended to the JSONL log body, forming one
+ * self-contained, parseable report. With `--events`, session events are
+ * resolved from the local workflow store at query time — never duplicated
+ * into the log at capture time — and interleaved by timestamp as
+ * `source: "event"` records.
+ */
+export declare function runLogsShowCommand(logger: CliLogsLogger, appRoot: string, logId?: string, options?: LogsShowCommandOptions): Promise<void>;
+/** Options accepted by {@link runLogsListCommand}. */
+export interface LogsListCommandOptions {
+    /** Emit a machine-readable JSON array instead of the human listing. */
+    json?: boolean;
+}
+/** Machine-readable row emitted by `eve logs ls --json`. */
+export interface DevDiagnosticLogJson {
+    id: string;
+    path: string;
+    startedAt: string | null;
+    sizeBytes: number;
+}
+/** `eve logs ls`: lists diagnostic logs, most recent first. */
+export declare function runLogsListCommand(logger: CliLogsLogger, appRoot: string, options?: LogsListCommandOptions): Promise<void>;
+export {};

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

@@ -0,0 +1,4 @@
+import{readDevSessionEvents}from"./logs-events.js";import{basename,join}from"node:path";import{readFile,readdir,stat}from"node:fs/promises";const LOG_DIRECTORY_SEGMENTS=[`.eve`,`logs`],LOG_DISPLAY_DIRECTORY=LOG_DIRECTORY_SEGMENTS.join(`/`),LOG_ID_PATTERN=/^dev-(\d{4}-\d{2}-\d{2}T\d{2}-\d{2}-\d{2}\.\d{3}Z)-\d+\.log$/;async function listDevDiagnosticLogs(e){let t=join(e,...LOG_DIRECTORY_SEGMENTS),r;try{r=await readdir(t)}catch(e){if(e.code===`ENOENT`)return[];throw e}let s=r.filter(e=>LOG_ID_PATTERN.test(e)).sort().reverse();return Promise.all(s.map(async e=>{let r=join(t,e);return{id:e.slice(0,-4),path:r,startedAt:parseStartedAt(e),sizeBytes:(await stat(r)).size}}))}function parseStartedAt(e){let t=LOG_ID_PATTERN.exec(e);if(t===null)return;let n=t[1].replace(/T(\d{2})-(\d{2})-(\d{2})/,`T$1:$2:$3`),r=new Date(n);return Number.isNaN(r.getTime())?void 0:r}function resolveDevDiagnosticLog(e,n){let r=basename(n.replaceAll(`\\`,`/`)),i=r.endsWith(`.log`)?r.slice(0,-4):r,a=e.find(e=>e.id===i);if(a!==void 0)return a;let o=e.filter(e=>e.id.startsWith(i)||e.id.startsWith(`dev-${i}`));if(o.length===1)return o[0];throw o.length===0?Error(`No diagnostic log matches "${n}". Run \`eve logs ls\` to see available logs.`):Error([`"${n}" matches ${o.length} diagnostic logs:`,...o.map(e=>`  ${e.id}`),`Pass a longer prefix or the full id.`].join(`
+`))}async function runLogsShowCommand(t,n,i,a={}){let o=await listDevDiagnosticLogs(n);if(o.length===0){let e=`No dev diagnostic logs found under ${LOG_DISPLAY_DIRECTORY}.`;if(i!==void 0)throw Error(e);t.log(e);return}let c=i===void 0?o[0]:resolveDevDiagnosticLog(o,i),l=await readFile(c.path,`utf8`);if(a.events===!0){let t=eventWindowForLog(o,c,a.now??(()=>new Date)),r=await(a.readEvents??readDevSessionEvents)(n,t);r.length>0&&(l=mergeLogWithEvents(l,r))}if(a.dump!==!0){t.log(l.trimEnd());return}let u=c.path.slice(0,-4)+`.dump`,d;try{d=await readFile(u,`utf8`)}catch(e){if(e.code!==`ENOENT`)throw e}if(d===void 0){t.log(l.trimEnd());return}t.log(`${d.trimEnd()}\n${l.trimEnd()}`)}function eventWindowForLog(e,t,n){let r=e.findIndex(e=>e.id===t.id),i=r>0?e[r-1].startedAt:void 0;return{from:t.startedAt??new Date(0),to:i??n()}}function mergeLogWithEvents(e,t){let n=[],r=``;for(let t of e.split(`
+`))if(t.trim().length!==0){try{let e=JSON.parse(t).at;typeof e==`string`&&(r=e)}catch{}n.push({at:r,line:t})}let i=t.map(e=>({at:e.at,line:JSON.stringify(e)})),a=[],o=0,s=0;for(;o<n.length||s<i.length;){let e=n[o],t=i[s];t===void 0||e!==void 0&&e.at<=t.at?(a.push(e.line),o+=1):(a.push(t.line),s+=1)}return`${a.join(`
+`)}\n`}async function runLogsListCommand(e,t,n={}){let r=await listDevDiagnosticLogs(t);if(n.json){let t=r.map(e=>({id:e.id,path:e.path,startedAt:e.startedAt?.toISOString()??null,sizeBytes:e.sizeBytes}));e.log(JSON.stringify(t,null,2));return}if(r.length===0){e.log(`No dev diagnostic logs found under ${LOG_DISPLAY_DIRECTORY}.`);return}for(let t of r){let n=t.startedAt?.toISOString()??`unknown start`;e.log(`${t.id}  ${n}  ${formatSize(t.sizeBytes)}`)}}function formatSize(e){if(e<1024)return`${e} B`;let t=e/1024;return t<1024?`${t.toFixed(1)} KiB`:`${(t/1024).toFixed(1)} MiB`}export{listDevDiagnosticLogs,resolveDevDiagnosticLog,runLogsListCommand,runLogsShowCommand};