electric-ax 0.2.8 → 0.2.9

package/dist/{completions-BeohCOLD.cjs → completions-BJ1fys8I.cjs}

@@ -2,6 +2,7 @@
 const require_chunk = require('./chunk-BCwAaXi7.cjs');
 const omelette = require_chunk.__toESM(require("omelette"));
 const __electric_sql_client = require_chunk.__toESM(require("@electric-sql/client"));
+const __electric_ax_agents_runtime = require_chunk.__toESM(require("@electric-ax/agents-runtime"));
 
 //#region src/shape-fetch.ts
 /**
@@ -11,7 +12,7 @@ const __electric_sql_client = require_chunk.__toESM(require("@electric-sql/clien
 */
 async function fetchShapeRows(baseUrl, table, options) {
 	const stream = new __electric_sql_client.ShapeStream({
-		url: `${baseUrl}/_electric/electric/v1/shape`,
+		url: (0, __electric_ax_agents_runtime.appendPathToUrl)(baseUrl, `/_electric/electric/v1/shape`),
 		params: { table },
 		subscribe: false,
 		signal: options?.signal
@@ -30,6 +31,7 @@ const AGENTS_COMMANDS = [
 	`spawn`,
 	`send`,
 	`observe`,
+	`view`,
 	`inspect`,
 	`ps`,
 	`signal`,
@@ -46,6 +48,7 @@ const COMMAND_FLAGS = {
 	spawn: [`--args`],
 	send: [`--type`, `--json`],
 	observe: [`--from`],
+	view: [`--from`],
 	signal: [`--reason`, `--payload`],
 	ps: [
 		`--type`,
@@ -77,6 +80,7 @@ function fetchEntityUrls(env) {
 const ENTITY_URL_COMMANDS = new Set([
 	`send`,
 	`observe`,
+	`view`,
 	`inspect`,
 	`signal`,
 	`kill`

package/dist/{completions-3RE2mC2p.js → completions-BkhbBSPI.js}

@@ -1,5 +1,6 @@
 import omelette from "omelette";
 import { Shape, ShapeStream } from "@electric-sql/client";
+import { appendPathToUrl } from "@electric-ax/agents-runtime";
 
 //#region src/shape-fetch.ts
 /**
@@ -9,7 +10,7 @@ import { Shape, ShapeStream } from "@electric-sql/client";
 */
 async function fetchShapeRows(baseUrl, table, options) {
 	const stream = new ShapeStream({
-		url: `${baseUrl}/_electric/electric/v1/shape`,
+		url: appendPathToUrl(baseUrl, `/_electric/electric/v1/shape`),
 		params: { table },
 		subscribe: false,
 		signal: options?.signal
@@ -28,6 +29,7 @@ const AGENTS_COMMANDS = [
 	`spawn`,
 	`send`,
 	`observe`,
+	`view`,
 	`inspect`,
 	`ps`,
 	`signal`,
@@ -44,6 +46,7 @@ const COMMAND_FLAGS = {
 	spawn: [`--args`],
 	send: [`--type`, `--json`],
 	observe: [`--from`],
+	view: [`--from`],
 	signal: [`--reason`, `--payload`],
 	ps: [
 		`--type`,
@@ -75,6 +78,7 @@ function fetchEntityUrls(env) {
 const ENTITY_URL_COMMANDS = new Set([
 	`send`,
 	`observe`,
+	`view`,
 	`inspect`,
 	`signal`,
 	`kill`

package/dist/completions.cjs

@@ -1,4 +1,4 @@
-const require_completions = require('./completions-BeohCOLD.cjs');
+const require_completions = require('./completions-BJ1fys8I.cjs');
 
 exports.fetchEntityTypeNames = require_completions.fetchEntityTypeNames
 exports.fetchEntityUrls = require_completions.fetchEntityUrls

package/dist/completions.d.cts

@@ -1,4 +1,4 @@
-import { ElectricCliEnv } from "./index-DmR3DeFk.cjs";
+import { ElectricCliEnv } from "./index-_AHIJdEA.cjs";
 
 //#region src/completions.d.ts
 declare function fetchEntityTypeNames(env: ElectricCliEnv): Promise<Array<string>>;

package/dist/completions.d.ts

@@ -1,4 +1,4 @@
-import { ElectricCliEnv } from "./index-BsITLCxF.js";
+import { ElectricCliEnv } from "./index-CQN8S3b9.js";
 
 //#region src/completions.d.ts
 declare function fetchEntityTypeNames(env: ElectricCliEnv): Promise<Array<string>>;

package/dist/completions.js

@@ -1,3 +1,3 @@
-import { fetchEntityTypeNames, fetchEntityUrls, installCompletions, setupCompletions } from "./completions-3RE2mC2p.js";
+import { fetchEntityTypeNames, fetchEntityUrls, installCompletions, setupCompletions } from "./completions-BkhbBSPI.js";
 
 export { fetchEntityTypeNames, fetchEntityUrls, installCompletions, setupCompletions };

package/dist/{entity-stream-db-CDOlZYc2.js → entity-stream-db-58-SuPa4.js}

@@ -1,14 +1,24 @@
-import { entityApiUrl } from "./entity-api-DWMhkYbl.js";
-import { createStreamDB } from "@durable-streams/state";
 import { appendPathToUrl, entityStateSchema } from "@electric-ax/agents-runtime";
+import { createStreamDB } from "@durable-streams/state";
 
+//#region src/entity-api.ts
+function withLeadingSlash(path) {
+	return path.startsWith(`/`) ? path : `/${path}`;
+}
+function entityApiPath(entityUrl, suffix = ``) {
+	return `/_electric/entities${withLeadingSlash(entityUrl)}${suffix}`;
+}
+function entityApiUrl(baseUrl, entityUrl, suffix = ``) {
+	return appendPathToUrl(baseUrl, entityApiPath(entityUrl, suffix));
+}
+
+//#endregion
 //#region src/entity-stream-db.ts
 function getMainStreamPath(entityUrl, entity) {
 	return entity.streams?.main ?? `${entityUrl}/main`;
 }
 async function createEntityStreamDB(opts) {
 	const { baseUrl, entityUrl, initialOffset, headers: serverHeaders } = opts;
-	console.log(`[createEntityStreamDB] Creating entity stream DB for ${baseUrl}${entityUrl}`);
 	const requestHeaders = {
 		"content-type": `application/json`,
 		...serverHeaders
@@ -40,4 +50,4 @@ async function createEntityStreamDB(opts) {
 }
 
 //#endregion
-export { createEntityStreamDB };
+export { createEntityStreamDB, entityApiPath, entityApiUrl };

package/dist/{entity-stream-db-CIv6uC2d.cjs → entity-stream-db-DHcwosd1.cjs}

@@ -1,23 +1,33 @@
 "use strict";
 const require_chunk = require('./chunk-BCwAaXi7.cjs');
-const require_entity_api = require('./entity-api-Cvo55yZx.cjs');
-const __durable_streams_state = require_chunk.__toESM(require("@durable-streams/state"));
 const __electric_ax_agents_runtime = require_chunk.__toESM(require("@electric-ax/agents-runtime"));
+const __durable_streams_state = require_chunk.__toESM(require("@durable-streams/state"));
 
+//#region src/entity-api.ts
+function withLeadingSlash(path) {
+	return path.startsWith(`/`) ? path : `/${path}`;
+}
+function entityApiPath(entityUrl, suffix = ``) {
+	return `/_electric/entities${withLeadingSlash(entityUrl)}${suffix}`;
+}
+function entityApiUrl(baseUrl, entityUrl, suffix = ``) {
+	return (0, __electric_ax_agents_runtime.appendPathToUrl)(baseUrl, entityApiPath(entityUrl, suffix));
+}
+
+//#endregion
 //#region src/entity-stream-db.ts
 function getMainStreamPath(entityUrl, entity) {
 	return entity.streams?.main ?? `${entityUrl}/main`;
 }
 async function createEntityStreamDB(opts) {
 	const { baseUrl, entityUrl, initialOffset, headers: serverHeaders } = opts;
-	console.log(`[createEntityStreamDB] Creating entity stream DB for ${baseUrl}${entityUrl}`);
 	const requestHeaders = {
 		"content-type": `application/json`,
 		...serverHeaders
 	};
 	let res;
 	try {
-		res = await fetch(require_entity_api.entityApiUrl(baseUrl, entityUrl), { headers: requestHeaders });
+		res = await fetch(entityApiUrl(baseUrl, entityUrl), { headers: requestHeaders });
 	} catch (err) {
 		throw new Error(`Could not connect to the Electric Agents server at ${baseUrl} — is it running?\n  ${err instanceof Error ? err.message : String(err)}`);
 	}
@@ -47,4 +57,16 @@ Object.defineProperty(exports, 'createEntityStreamDB', {
   get: function () {
     return createEntityStreamDB;
   }
+});
+Object.defineProperty(exports, 'entityApiPath', {
+  enumerable: true,
+  get: function () {
+    return entityApiPath;
+  }
+});
+Object.defineProperty(exports, 'entityApiUrl', {
+  enumerable: true,
+  get: function () {
+    return entityApiUrl;
+  }
 });

package/dist/entity-stream-db.cjs

@@ -1,4 +1,3 @@
-require('./entity-api-Cvo55yZx.cjs');
-const require_entity_stream_db = require('./entity-stream-db-CIv6uC2d.cjs');
+const require_entity_stream_db = require('./entity-stream-db-DHcwosd1.cjs');
 
 exports.createEntityStreamDB = require_entity_stream_db.createEntityStreamDB

package/dist/entity-stream-db.d.ts

@@ -1,2 +1,2 @@
-import { EntityStreamDB, createEntityStreamDB$1 as createEntityStreamDB } from "./entity-stream-db-Bl6AT5hR.js";
+import { EntityStreamDB, createEntityStreamDB$1 as createEntityStreamDB } from "./entity-stream-db-BROzlu7p.js";
 export { EntityStreamDB, createEntityStreamDB };

package/dist/entity-stream-db.js

@@ -1,4 +1,3 @@
-import "./entity-api-DWMhkYbl.js";
-import { createEntityStreamDB } from "./entity-stream-db-CDOlZYc2.js";
+import { createEntityStreamDB } from "./entity-stream-db-58-SuPa4.js";
 
 export { createEntityStreamDB };

package/dist/{index-BsITLCxF.d.ts → index-CQN8S3b9.d.ts}

@@ -88,6 +88,7 @@ interface ElectricCliHandlers {
   spawn: (urlPath: string, options: SpawnCommandOptions) => Promise<void>;
   send: (url: string, message: string, options: SendCommandOptions) => Promise<void>;
   observe: (url: string, options: ObserveCommandOptions) => Promise<void>;
+  view: (url: string, options: ObserveCommandOptions) => Promise<void>;
   inspect: (url: string) => Promise<void>;
   ps: (options: PsCommandOptions) => Promise<void>;
   signal: (url: string, signal: string, options: SignalCommandOptions) => Promise<void>;

package/dist/{index-DmR3DeFk.d.cts → index-_AHIJdEA.d.cts}

@@ -88,6 +88,7 @@ interface ElectricCliHandlers {
   spawn: (urlPath: string, options: SpawnCommandOptions) => Promise<void>;
   send: (url: string, message: string, options: SendCommandOptions) => Promise<void>;
   observe: (url: string, options: ObserveCommandOptions) => Promise<void>;
+  view: (url: string, options: ObserveCommandOptions) => Promise<void>;
   inspect: (url: string) => Promise<void>;
   ps: (options: PsCommandOptions) => Promise<void>;
   signal: (url: string, signal: string, options: SignalCommandOptions) => Promise<void>;

package/dist/index.cjs

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 "use strict";
 const require_chunk = require('./chunk-BCwAaXi7.cjs');
-const require_completions = require('./completions-BeohCOLD.cjs');
-const require_entity_api = require('./entity-api-Cvo55yZx.cjs');
-const require_env = require('./env-CFKgT8o2.cjs');
+const require_completions = require('./completions-BJ1fys8I.cjs');
+const require_entity_stream_db = require('./entity-stream-db-DHcwosd1.cjs');
+const require_env = require('./env-BXUgom_C.cjs');
 const __electric_ax_agents_runtime = require_chunk.__toESM(require("@electric-ax/agents-runtime"));
 const node_fs = require_chunk.__toESM(require("node:fs"));
 const node_os = require_chunk.__toESM(require("node:os"));
@@ -136,6 +136,73 @@ function writeApiKeyToDotEnv(key, cwd) {
 	return envPath;
 }
 
+//#endregion
+//#region src/view.ts
+const TOOL_RESULT_MAX_LINES = 5;
+const TOOL_RESULT_MAX_COLUMNS = 120;
+function truncate(value, max) {
+	return value.length > max ? `${value.slice(0, max - 3)}...` : value;
+}
+function appendIndented(lines, text, prefix) {
+	const textLines = text.split(/\r?\n/);
+	for (const line of textLines) lines.push(`${prefix}${line}`);
+}
+function appendTextBlock(blocks, label, text) {
+	const lines = [`${label}:`];
+	appendIndented(lines, text, `  `);
+	blocks.push(lines.join(`\n`));
+}
+function wakeReason(section) {
+	const { payload } = section;
+	if (payload.timeout) return `timeout`;
+	if (payload.finished_child) return `child ${payload.finished_child.run_status}`;
+	if (payload.changes.length > 0) return `${payload.changes.length} ${payload.changes.length === 1 ? `change` : `changes`}`;
+	if (payload.other_children && payload.other_children.length > 0) return `${payload.other_children.length} child ${payload.other_children.length === 1 ? `update` : `updates`}`;
+	return payload.source;
+}
+function appendToolCall(lines, item) {
+	const status = item.isError ? `failed` : item.status;
+	lines.push(`  [tool:${item.toolName}] ${status}`);
+	if (item.result === void 0) return;
+	const resultLines = item.result.split(/\r?\n/);
+	for (const line of resultLines.slice(0, TOOL_RESULT_MAX_LINES)) lines.push(`    ${truncate(line, TOOL_RESULT_MAX_COLUMNS)}`);
+	const remaining = resultLines.length - TOOL_RESULT_MAX_LINES;
+	if (remaining > 0) lines.push(`    ... ${remaining} more lines`);
+}
+function appendAgentResponse(blocks, section, label) {
+	const lines = [`${label}:`];
+	for (const item of section.items) {
+		if (item.kind === `text`) {
+			appendIndented(lines, item.text, `  `);
+			continue;
+		}
+		appendToolCall(lines, item);
+	}
+	if (section.error) appendIndented(lines, `[error] ${section.error}`, `  `);
+	if (lines.length === 1) lines.push(`  (no output)`);
+	blocks.push(lines.join(`\n`));
+}
+function formatEntityConversationView(data, options) {
+	const sections = (0, __electric_ax_agents_runtime.buildSections)(data.runs, data.inbox, data.wakes);
+	if (sections.length === 0) return `No conversation events found`;
+	const blocks = [];
+	for (const section of sections) {
+		if (section.kind === `user_message`) {
+			appendTextBlock(blocks, section.from ?? `user`, section.text);
+			continue;
+		}
+		if (section.kind === `wake`) {
+			appendTextBlock(blocks, `wake`, `${wakeReason(section)} from ${section.payload.source}`);
+			continue;
+		}
+		appendAgentResponse(blocks, section, options.entityUrl);
+	}
+	return blocks.join(`\n\n`);
+}
+function formatEntityConversationViewFromDB(db, options) {
+	return formatEntityConversationView((0, __electric_ax_agents_runtime.buildEntityTimelineData)(db), options);
+}
+
 //#endregion
 //#region src/index.ts
 const DEFAULT_ELECTRIC_AGENTS_URL = `http://localhost:4437`;
@@ -414,7 +481,7 @@ async function spawnEntity(env, urlPath, options) {
 	} catch (error) {
 		fail(`--args must be valid JSON: ${getErrorMessage(error)}`);
 	}
-	const res = await electricAgentsFetch(env, require_entity_api.entityApiPath(urlPath), {
+	const res = await electricAgentsFetch(env, require_entity_stream_db.entityApiPath(urlPath), {
 		method: `PUT`,
 		body: JSON.stringify({ args: spawnArgs })
 	});
@@ -431,7 +498,7 @@ async function sendMessage(env, url, message, options) {
 		payload
 	};
 	if (options.type) body.type = options.type;
-	const res = await electricAgentsFetch(env, require_entity_api.entityApiPath(url, `/send`), {
+	const res = await electricAgentsFetch(env, require_entity_stream_db.entityApiPath(url, `/send`), {
 		method: `POST`,
 		body: JSON.stringify(body)
 	});
@@ -452,8 +519,21 @@ async function observeEntity(env, url, options) {
 		initialOffset: options.from
 	});
 }
+async function viewEntity(env, url, options) {
+	const { db, close } = await require_entity_stream_db.createEntityStreamDB({
+		entityUrl: url,
+		baseUrl: env.electricAgentsUrl,
+		headers: env.electricAgentsHeaders,
+		initialOffset: options.from
+	});
+	try {
+		console.log(formatEntityConversationViewFromDB(db, { entityUrl: url }));
+	} finally {
+		close();
+	}
+}
 async function inspectEntity(env, url) {
-	const res = await electricAgentsFetch(env, require_entity_api.entityApiPath(url));
+	const res = await electricAgentsFetch(env, require_entity_stream_db.entityApiPath(url));
 	const data = await parseJsonResponse(res);
 	if (!res.ok) failFromResponse(data, res);
 	console.log(JSON.stringify(data, null, 2));
@@ -478,7 +558,7 @@ async function listEntities(env, options) {
 	}
 }
 async function killEntity(env, url) {
-	const res = await electricAgentsFetch(env, require_entity_api.entityApiPath(url, `/signal`), {
+	const res = await electricAgentsFetch(env, require_entity_stream_db.entityApiPath(url, `/signal`), {
 		method: `POST`,
 		body: JSON.stringify({
 			signal: `SIGKILL`,
@@ -496,7 +576,7 @@ async function signalEntity(env, url, rawSignal, options) {
 	const body = { signal };
 	if (options.reason !== void 0) body.reason = options.reason;
 	if (options.payload !== void 0) body.payload = parseJsonOption(`--payload`, options.payload);
-	const res = await electricAgentsFetch(env, require_entity_api.entityApiPath(url, `/signal`), {
+	const res = await electricAgentsFetch(env, require_entity_stream_db.entityApiPath(url, `/signal`), {
 		method: `POST`,
 		body: JSON.stringify(body)
 	});
@@ -533,6 +613,7 @@ function createElectricCliHandlers(env, commandPrefix = commandExample(`electric
 		spawn: (urlPath, options) => spawnEntity(env, urlPath, options),
 		send: (url, message, options) => sendMessage(env, url, message, options),
 		observe: (url, options) => observeEntity(env, url, options),
+		view: (url, options) => viewEntity(env, url, options),
 		inspect: (url) => inspectEntity(env, url),
 		ps: (options) => listEntities(env, options),
 		signal: (url, signal, options) => signalEntity(env, url, signal, options),
@@ -635,6 +716,11 @@ function createElectricProgram({ env = getElectricCliEnv(), commandName = `elect
 		const command = getCommandActionArg(actionArgs);
 		await handlers.observe(url, command.opts());
 	});
+	agentsCommand.command(`view <url>`).description(`Print an entity conversation once`).option(`--from <offset>`, `Initial offset`).action(async (...actionArgs) => {
+		const url = actionArgs[0];
+		const command = getCommandActionArg(actionArgs);
+		await handlers.view(url, command.opts());
+	});
 	agentsCommand.command(`signal <url> <signal>`).description(`Send a lifecycle signal to an entity`).option(`--reason <text>`, `Human-readable signal reason`).option(`--payload <json>`, `JSON payload to attach to the signal`).action(async (...actionArgs) => {
 		const url = actionArgs[0];
 		const signal = actionArgs[1];

package/dist/index.d.cts

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
-import { DEFAULT_ELECTRIC_AGENTS_URL, ElectricCliEnv, ElectricCliHandlers, EntitySignal, ObserveCommandOptions, PsCommandOptions, SendCommandOptions, SignalCommandOptions, SpawnCommandOptions, StartBuiltinCommandOptions, StartCommandOptions, StartedBuiltinAgentsEnvironment, StartedDevEnvironment, StopCommandOptions, StoppedDevEnvironment, createElectricCliHandlers, createElectricProgram, formatQuickstartBackendStartedMessage, getElectricCliEnv, resolveCommandPrefix, run } from "./index-DmR3DeFk.cjs";
+import { DEFAULT_ELECTRIC_AGENTS_URL, ElectricCliEnv, ElectricCliHandlers, EntitySignal, ObserveCommandOptions, PsCommandOptions, SendCommandOptions, SignalCommandOptions, SpawnCommandOptions, StartBuiltinCommandOptions, StartCommandOptions, StartedBuiltinAgentsEnvironment, StartedDevEnvironment, StopCommandOptions, StoppedDevEnvironment, createElectricCliHandlers, createElectricProgram, formatQuickstartBackendStartedMessage, getElectricCliEnv, resolveCommandPrefix, run } from "./index-_AHIJdEA.cjs";
 export { DEFAULT_ELECTRIC_AGENTS_URL, ElectricCliEnv, ElectricCliHandlers, EntitySignal, ObserveCommandOptions, PsCommandOptions, SendCommandOptions, SignalCommandOptions, SpawnCommandOptions, StartBuiltinCommandOptions, StartCommandOptions, StartedBuiltinAgentsEnvironment, StartedDevEnvironment, StopCommandOptions, StoppedDevEnvironment, createElectricCliHandlers, createElectricProgram, formatQuickstartBackendStartedMessage, getElectricCliEnv, resolveCommandPrefix, run };

package/dist/index.d.ts

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
-import { DEFAULT_ELECTRIC_AGENTS_URL, ElectricCliEnv, ElectricCliHandlers, EntitySignal, ObserveCommandOptions, PsCommandOptions, SendCommandOptions, SignalCommandOptions, SpawnCommandOptions, StartBuiltinCommandOptions, StartCommandOptions, StartedBuiltinAgentsEnvironment, StartedDevEnvironment, StopCommandOptions, StoppedDevEnvironment, createElectricCliHandlers, createElectricProgram, formatQuickstartBackendStartedMessage, getElectricCliEnv, resolveCommandPrefix, run } from "./index-BsITLCxF.js";
+import { DEFAULT_ELECTRIC_AGENTS_URL, ElectricCliEnv, ElectricCliHandlers, EntitySignal, ObserveCommandOptions, PsCommandOptions, SendCommandOptions, SignalCommandOptions, SpawnCommandOptions, StartBuiltinCommandOptions, StartCommandOptions, StartedBuiltinAgentsEnvironment, StartedDevEnvironment, StopCommandOptions, StoppedDevEnvironment, createElectricCliHandlers, createElectricProgram, formatQuickstartBackendStartedMessage, getElectricCliEnv, resolveCommandPrefix, run } from "./index-CQN8S3b9.js";
 export { DEFAULT_ELECTRIC_AGENTS_URL, ElectricCliEnv, ElectricCliHandlers, EntitySignal, ObserveCommandOptions, PsCommandOptions, SendCommandOptions, SignalCommandOptions, SpawnCommandOptions, StartBuiltinCommandOptions, StartCommandOptions, StartedBuiltinAgentsEnvironment, StartedDevEnvironment, StopCommandOptions, StoppedDevEnvironment, createElectricCliHandlers, createElectricProgram, formatQuickstartBackendStartedMessage, getElectricCliEnv, resolveCommandPrefix, run };

package/dist/index.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
-import { installCompletions, setupCompletions } from "./completions-3RE2mC2p.js";
-import { entityApiPath } from "./entity-api-DWMhkYbl.js";
-import { resolveAnthropicApiKey$1 as resolveAnthropicApiKey } from "./env-DIhTv987.js";
-import { appendPathToUrl } from "@electric-ax/agents-runtime";
+import { installCompletions, setupCompletions } from "./completions-BkhbBSPI.js";
+import { createEntityStreamDB, entityApiPath } from "./entity-stream-db-58-SuPa4.js";
+import { resolveAnthropicApiKey$1 as resolveAnthropicApiKey } from "./env-LZtIfFz1.js";
+import { appendPathToUrl, buildEntityTimelineData, buildSections } from "@electric-ax/agents-runtime";
 import { existsSync, readFileSync, realpathSync, writeFileSync } from "node:fs";
 import { hostname, userInfo } from "node:os";
 import { basename, resolve } from "node:path";
@@ -134,6 +134,73 @@ function writeApiKeyToDotEnv(key, cwd) {
 	return envPath;
 }
 
+//#endregion
+//#region src/view.ts
+const TOOL_RESULT_MAX_LINES = 5;
+const TOOL_RESULT_MAX_COLUMNS = 120;
+function truncate(value, max) {
+	return value.length > max ? `${value.slice(0, max - 3)}...` : value;
+}
+function appendIndented(lines, text, prefix) {
+	const textLines = text.split(/\r?\n/);
+	for (const line of textLines) lines.push(`${prefix}${line}`);
+}
+function appendTextBlock(blocks, label, text) {
+	const lines = [`${label}:`];
+	appendIndented(lines, text, `  `);
+	blocks.push(lines.join(`\n`));
+}
+function wakeReason(section) {
+	const { payload } = section;
+	if (payload.timeout) return `timeout`;
+	if (payload.finished_child) return `child ${payload.finished_child.run_status}`;
+	if (payload.changes.length > 0) return `${payload.changes.length} ${payload.changes.length === 1 ? `change` : `changes`}`;
+	if (payload.other_children && payload.other_children.length > 0) return `${payload.other_children.length} child ${payload.other_children.length === 1 ? `update` : `updates`}`;
+	return payload.source;
+}
+function appendToolCall(lines, item) {
+	const status = item.isError ? `failed` : item.status;
+	lines.push(`  [tool:${item.toolName}] ${status}`);
+	if (item.result === void 0) return;
+	const resultLines = item.result.split(/\r?\n/);
+	for (const line of resultLines.slice(0, TOOL_RESULT_MAX_LINES)) lines.push(`    ${truncate(line, TOOL_RESULT_MAX_COLUMNS)}`);
+	const remaining = resultLines.length - TOOL_RESULT_MAX_LINES;
+	if (remaining > 0) lines.push(`    ... ${remaining} more lines`);
+}
+function appendAgentResponse(blocks, section, label) {
+	const lines = [`${label}:`];
+	for (const item of section.items) {
+		if (item.kind === `text`) {
+			appendIndented(lines, item.text, `  `);
+			continue;
+		}
+		appendToolCall(lines, item);
+	}
+	if (section.error) appendIndented(lines, `[error] ${section.error}`, `  `);
+	if (lines.length === 1) lines.push(`  (no output)`);
+	blocks.push(lines.join(`\n`));
+}
+function formatEntityConversationView(data, options) {
+	const sections = buildSections(data.runs, data.inbox, data.wakes);
+	if (sections.length === 0) return `No conversation events found`;
+	const blocks = [];
+	for (const section of sections) {
+		if (section.kind === `user_message`) {
+			appendTextBlock(blocks, section.from ?? `user`, section.text);
+			continue;
+		}
+		if (section.kind === `wake`) {
+			appendTextBlock(blocks, `wake`, `${wakeReason(section)} from ${section.payload.source}`);
+			continue;
+		}
+		appendAgentResponse(blocks, section, options.entityUrl);
+	}
+	return blocks.join(`\n\n`);
+}
+function formatEntityConversationViewFromDB(db, options) {
+	return formatEntityConversationView(buildEntityTimelineData(db), options);
+}
+
 //#endregion
 //#region src/index.ts
 const DEFAULT_ELECTRIC_AGENTS_URL = `http://localhost:4437`;
@@ -450,6 +517,19 @@ async function observeEntity(env, url, options) {
 		initialOffset: options.from
 	});
 }
+async function viewEntity(env, url, options) {
+	const { db, close } = await createEntityStreamDB({
+		entityUrl: url,
+		baseUrl: env.electricAgentsUrl,
+		headers: env.electricAgentsHeaders,
+		initialOffset: options.from
+	});
+	try {
+		console.log(formatEntityConversationViewFromDB(db, { entityUrl: url }));
+	} finally {
+		close();
+	}
+}
 async function inspectEntity(env, url) {
 	const res = await electricAgentsFetch(env, entityApiPath(url));
 	const data = await parseJsonResponse(res);
@@ -531,6 +611,7 @@ function createElectricCliHandlers(env, commandPrefix = commandExample(`electric
 		spawn: (urlPath, options) => spawnEntity(env, urlPath, options),
 		send: (url, message, options) => sendMessage(env, url, message, options),
 		observe: (url, options) => observeEntity(env, url, options),
+		view: (url, options) => viewEntity(env, url, options),
 		inspect: (url) => inspectEntity(env, url),
 		ps: (options) => listEntities(env, options),
 		signal: (url, signal, options) => signalEntity(env, url, signal, options),
@@ -633,6 +714,11 @@ function createElectricProgram({ env = getElectricCliEnv(), commandName = `elect
 		const command = getCommandActionArg(actionArgs);
 		await handlers.observe(url, command.opts());
 	});
+	agentsCommand.command(`view <url>`).description(`Print an entity conversation once`).option(`--from <offset>`, `Initial offset`).action(async (...actionArgs) => {
+		const url = actionArgs[0];
+		const command = getCommandActionArg(actionArgs);
+		await handlers.view(url, command.opts());
+	});
 	agentsCommand.command(`signal <url> <signal>`).description(`Send a lifecycle signal to an entity`).option(`--reason <text>`, `Human-readable signal reason`).option(`--payload <json>`, `JSON payload to attach to the signal`).action(async (...actionArgs) => {
 		const url = actionArgs[0];
 		const signal = actionArgs[1];

package/dist/observe-ui.cjs

@@ -1,9 +1,8 @@
 "use strict";
 const require_chunk = require('./chunk-BCwAaXi7.cjs');
-const require_entity_api = require('./entity-api-Cvo55yZx.cjs');
-const require_entity_stream_db = require('./entity-stream-db-CIv6uC2d.cjs');
-const __durable_streams_state = require_chunk.__toESM(require("@durable-streams/state"));
+const require_entity_stream_db = require('./entity-stream-db-DHcwosd1.cjs');
 const __electric_ax_agents_runtime = require_chunk.__toESM(require("@electric-ax/agents-runtime"));
+const __durable_streams_state = require_chunk.__toESM(require("@durable-streams/state"));
 const react = require_chunk.__toESM(require("react"));
 const ink = require_chunk.__toESM(require("ink"));
 const __tanstack_react_db = require_chunk.__toESM(require("@tanstack/react-db"));
@@ -132,7 +131,7 @@ function MessageInput({ db, baseUrl, entityUrl, identity, headers, disabled }) {
 			});
 		},
 		mutationFn: async ({ text }) => {
-			const res = await fetch(require_entity_api.entityApiUrl(baseUrl, entityUrl, `/send`), {
+			const res = await fetch(require_entity_stream_db.entityApiUrl(baseUrl, entityUrl, `/send`), {
 				method: `POST`,
 				headers: {
 					"content-type": `application/json`,
@@ -281,7 +280,12 @@ function ObserveView({ db, entityUrl, baseUrl, identity, headers }) {
 	});
 	const typedRuns = timelineData.runs;
 	const typedInbox = timelineData.inbox;
-	const timeline = (0, react.useMemo)(() => (0, __electric_ax_agents_runtime.buildSections)(typedRuns, typedInbox), [typedRuns, typedInbox]);
+	const typedWakes = timelineData.wakes;
+	const timeline = (0, react.useMemo)(() => (0, __electric_ax_agents_runtime.buildSections)(typedRuns, typedInbox, typedWakes), [
+		typedRuns,
+		typedInbox,
+		typedWakes
+	]);
 	const { data: stopped = [] } = (0, __tanstack_react_db.useLiveQuery)((q) => q.from({ entityStopped: db.collections.entityStopped }), [db]);
 	const closed = stopped.length > 0;
 	const lastAgentIndex = (0, react.useMemo)(() => {

package/dist/observe-ui.d.ts

@@ -1,4 +1,4 @@
-import { EntityStreamDB } from "./entity-stream-db-Bl6AT5hR.js";
+import { EntityStreamDB } from "./entity-stream-db-BROzlu7p.js";
 import { EntityTimelineContentItem, MessageReceived } from "@electric-ax/agents-runtime";
 import React from "react";
 

package/dist/observe-ui.js

@@ -1,7 +1,6 @@
-import { entityApiUrl } from "./entity-api-DWMhkYbl.js";
-import { createEntityStreamDB } from "./entity-stream-db-CDOlZYc2.js";
-import { createOptimisticAction } from "@durable-streams/state";
+import { createEntityStreamDB, entityApiUrl } from "./entity-stream-db-58-SuPa4.js";
 import { buildSections, createEntityIncludesQuery, normalizeEntityTimelineData } from "@electric-ax/agents-runtime";
+import { createOptimisticAction } from "@durable-streams/state";
 import React, { useEffect, useMemo, useRef, useState } from "react";
 import { Box, Newline, Text, render, useInput } from "ink";
 import { useLiveQuery } from "@tanstack/react-db";
@@ -279,7 +278,12 @@ function ObserveView({ db, entityUrl, baseUrl, identity, headers }) {
 	});
 	const typedRuns = timelineData.runs;
 	const typedInbox = timelineData.inbox;
-	const timeline = useMemo(() => buildSections(typedRuns, typedInbox), [typedRuns, typedInbox]);
+	const typedWakes = timelineData.wakes;
+	const timeline = useMemo(() => buildSections(typedRuns, typedInbox, typedWakes), [
+		typedRuns,
+		typedInbox,
+		typedWakes
+	]);
 	const { data: stopped = [] } = useLiveQuery((q) => q.from({ entityStopped: db.collections.entityStopped }), [db]);
 	const closed = stopped.length > 0;
 	const lastAgentIndex = useMemo(() => {

package/dist/start.cjs

@@ -1,6 +1,6 @@
 "use strict";
 const require_chunk = require('./chunk-BCwAaXi7.cjs');
-const require_env = require('./env-CFKgT8o2.cjs');
+const require_env = require('./env-BXUgom_C.cjs');
 const __electric_ax_agents_runtime = require_chunk.__toESM(require("@electric-ax/agents-runtime"));
 const node_url = require_chunk.__toESM(require("node:url"));
 const __electric_ax_agents_server_headers = require_chunk.__toESM(require("@electric-ax/agents/server-headers"));

package/dist/start.d.cts

@@ -1,2 +1,2 @@
-import { StartedBuiltinAgentsEnvironment, StartedDevEnvironment, StoppedDevEnvironment, getStartedBuiltinAgentsMessage, getStartedEnvironmentMessage, getStoppedEnvironmentMessage, readDotEnvFile, resolveAnthropicApiKey, resolveComposeProjectName, resolveElectricAgentsPort, resolvePullWakeOwnerPrincipal, resolvePullWakeRunnerId, startBuiltinAgentsServer, startElectricAgentsDevEnvironment, stopElectricAgentsDevEnvironment, waitForElectricAgentsServer } from "./index-DmR3DeFk.cjs";
+import { StartedBuiltinAgentsEnvironment, StartedDevEnvironment, StoppedDevEnvironment, getStartedBuiltinAgentsMessage, getStartedEnvironmentMessage, getStoppedEnvironmentMessage, readDotEnvFile, resolveAnthropicApiKey, resolveComposeProjectName, resolveElectricAgentsPort, resolvePullWakeOwnerPrincipal, resolvePullWakeRunnerId, startBuiltinAgentsServer, startElectricAgentsDevEnvironment, stopElectricAgentsDevEnvironment, waitForElectricAgentsServer } from "./index-_AHIJdEA.cjs";
 export { StartedBuiltinAgentsEnvironment, StartedDevEnvironment, StoppedDevEnvironment, getStartedBuiltinAgentsMessage, getStartedEnvironmentMessage, getStoppedEnvironmentMessage, readDotEnvFile, resolveAnthropicApiKey, resolveComposeProjectName, resolveElectricAgentsPort, resolvePullWakeOwnerPrincipal, resolvePullWakeRunnerId, startBuiltinAgentsServer, startElectricAgentsDevEnvironment, stopElectricAgentsDevEnvironment, waitForElectricAgentsServer };

package/dist/start.d.ts

@@ -1,2 +1,2 @@
-import { StartedBuiltinAgentsEnvironment, StartedDevEnvironment, StoppedDevEnvironment, getStartedBuiltinAgentsMessage, getStartedEnvironmentMessage, getStoppedEnvironmentMessage, readDotEnvFile, resolveAnthropicApiKey, resolveComposeProjectName, resolveElectricAgentsPort, resolvePullWakeOwnerPrincipal, resolvePullWakeRunnerId, startBuiltinAgentsServer, startElectricAgentsDevEnvironment, stopElectricAgentsDevEnvironment, waitForElectricAgentsServer } from "./index-BsITLCxF.js";
+import { StartedBuiltinAgentsEnvironment, StartedDevEnvironment, StoppedDevEnvironment, getStartedBuiltinAgentsMessage, getStartedEnvironmentMessage, getStoppedEnvironmentMessage, readDotEnvFile, resolveAnthropicApiKey, resolveComposeProjectName, resolveElectricAgentsPort, resolvePullWakeOwnerPrincipal, resolvePullWakeRunnerId, startBuiltinAgentsServer, startElectricAgentsDevEnvironment, stopElectricAgentsDevEnvironment, waitForElectricAgentsServer } from "./index-CQN8S3b9.js";
 export { StartedBuiltinAgentsEnvironment, StartedDevEnvironment, StoppedDevEnvironment, getStartedBuiltinAgentsMessage, getStartedEnvironmentMessage, getStoppedEnvironmentMessage, readDotEnvFile, resolveAnthropicApiKey, resolveComposeProjectName, resolveElectricAgentsPort, resolvePullWakeOwnerPrincipal, resolvePullWakeRunnerId, startBuiltinAgentsServer, startElectricAgentsDevEnvironment, stopElectricAgentsDevEnvironment, waitForElectricAgentsServer };

package/dist/start.js

@@ -1,4 +1,4 @@
-import { readDotEnvFile$1 as readDotEnvFile, resolveAnthropicApiKey$1 as resolveAnthropicApiKey } from "./env-DIhTv987.js";
+import { readDotEnvFile$1 as readDotEnvFile, resolveAnthropicApiKey$1 as resolveAnthropicApiKey } from "./env-LZtIfFz1.js";
 import { appendPathToUrl } from "@electric-ax/agents-runtime";
 import { fileURLToPath } from "node:url";
 import { mergeElectricPrincipalHeader } from "@electric-ax/agents/server-headers";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "electric-ax",
-  "version": "0.2.8",
+  "version": "0.2.9",
   "description": "CLI for Electric Agents",
   "author": "ElectricSQL team and contributors",
   "license": "Apache-2.0",
@@ -46,8 +46,8 @@
     "ink": "^6.8.0",
     "omelette": "^0.4.17",
     "react": "^19.2.0",
-    "@electric-ax/agents": "0.4.8",
-    "@electric-ax/agents-runtime": "0.3.4"
+    "@electric-ax/agents": "0.4.9",
+    "@electric-ax/agents-runtime": "0.3.5"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^4.1.0",

package/dist/entity-api-Cvo55yZx.cjs

@@ -1,28 +0,0 @@
-"use strict";
-const require_chunk = require('./chunk-BCwAaXi7.cjs');
-const __electric_ax_agents_runtime = require_chunk.__toESM(require("@electric-ax/agents-runtime"));
-
-//#region src/entity-api.ts
-function withLeadingSlash(path) {
-	return path.startsWith(`/`) ? path : `/${path}`;
-}
-function entityApiPath(entityUrl, suffix = ``) {
-	return `/_electric/entities${withLeadingSlash(entityUrl)}${suffix}`;
-}
-function entityApiUrl(baseUrl, entityUrl, suffix = ``) {
-	return (0, __electric_ax_agents_runtime.appendPathToUrl)(baseUrl, entityApiPath(entityUrl, suffix));
-}
-
-//#endregion
-Object.defineProperty(exports, 'entityApiPath', {
-  enumerable: true,
-  get: function () {
-    return entityApiPath;
-  }
-});
-Object.defineProperty(exports, 'entityApiUrl', {
-  enumerable: true,
-  get: function () {
-    return entityApiUrl;
-  }
-});

package/dist/entity-api-DWMhkYbl.js

@@ -1,15 +0,0 @@
-import { appendPathToUrl } from "@electric-ax/agents-runtime";
-
-//#region src/entity-api.ts
-function withLeadingSlash(path) {
-	return path.startsWith(`/`) ? path : `/${path}`;
-}
-function entityApiPath(entityUrl, suffix = ``) {
-	return `/_electric/entities${withLeadingSlash(entityUrl)}${suffix}`;
-}
-function entityApiUrl(baseUrl, entityUrl, suffix = ``) {
-	return appendPathToUrl(baseUrl, entityApiPath(entityUrl, suffix));
-}
-
-//#endregion
-export { entityApiPath, entityApiUrl };