iterate 0.2.5 → 0.2.7

package/dist/stream-tui/agent-chat-terminal.mjs

@@ -0,0 +1,933 @@
+#!/usr/bin/env bun
+import { c as connectItx, r as readConfig } from "../config-DtnR7Lv7.mjs";
+import { StyledText, bg, createCliRenderer, fg } from "@opentui/core";
+import { createRoot, useKeyboard } from "@opentui/react";
+import { useCallback, useState, useSyncExternalStore } from "react";
+import { jsx, jsxs } from "@opentui/react/jsx-runtime";
+//#region ../ui/src/components/events/agent-ui-reducer.ts
+function initialAgentUiState() {
+	return {
+		live: null,
+		queuedUserMessages: [],
+		eventCount: 0,
+		presence: [],
+		nextLocalIndex: 0
+	};
+}
+/**
+* Fold a batch of events into settled-item ops + the resulting state.
+* Idempotent by construction: replaying the same events from the same entry
+* state yields the same ops, and the processor upserts by local_index.
+*/
+function planAgentUiOps(start, events) {
+	const ops = [];
+	let state = start;
+	for (const event of events) state = reduceAgentUiEvent(state, event, ops);
+	return {
+		endState: state,
+		ops
+	};
+}
+/** Append a settled item op at the next dense position. */
+function emitItem(state, ops, item) {
+	ops.push({
+		localIndex: state.nextLocalIndex,
+		item
+	});
+	return {
+		...state,
+		nextLocalIndex: state.nextLocalIndex + 1
+	};
+}
+const AGENT_LLM_REQUEST_REQUESTED = "events.iterate.com/agent/llm-request-requested";
+const AGENT_LLM_REQUEST_COMPLETED = "events.iterate.com/agent/llm-request-completed";
+const AGENT_LLM_REQUEST_CANCELLED = "events.iterate.com/agent/llm-request-cancelled";
+const AGENT_OUTPUT_ADDED = "events.iterate.com/agent/output-added";
+const AGENT_STATUS_UPDATED = "events.iterate.com/agent/status-updated";
+const OPENAI_WS_REQUEST_STARTED = "events.iterate.com/openai-ws/llm-request-started";
+const OPENAI_WS_RESPONSE_CHUNK = "events.iterate.com/openai-ws/llm-response-chunk";
+const CLOUDFLARE_AI_REQUEST_STARTED = "events.iterate.com/cloudflare-ai/llm-request-started";
+const CLOUDFLARE_AI_RESPONSE_CHUNK = "events.iterate.com/cloudflare-ai/llm-response-chunk";
+const SCRIPT_EXECUTION_REQUESTED = "events.iterate.com/capability-host/script-execution-requested";
+const SCRIPT_EXECUTION_COMPLETED = "events.iterate.com/capability-host/script-execution-completed";
+const CODEMODE_SCRIPT_EXECUTION_REQUESTED = "events.iterate.com/codemode/script-execution-requested";
+const CODEMODE_SCRIPT_EXECUTION_COMPLETED = "events.iterate.com/codemode/script-execution-completed";
+const STREAM_SUBSCRIBER_CONNECTED = "events.iterate.com/stream/subscriber-connected";
+const STREAM_SUBSCRIBER_DISCONNECTED = "events.iterate.com/stream/subscriber-disconnected";
+const STREAM_WOKEN = "events.iterate.com/stream/woken";
+function reduceAgentUiEvent(previous, event, ops) {
+	const state = {
+		...previous,
+		queuedUserMessages: previous.queuedUserMessages ?? [],
+		eventCount: previous.eventCount + 1
+	};
+	const timestampMs = Date.parse(event.createdAt);
+	switch (event.type) {
+		case "events.iterate.com/agents/user-message-received": {
+			const text = readString(event, "content");
+			if (text == null) return state;
+			const hasRunningStep = state.live?.steps.some((step) => step.status === "running") ?? false;
+			const item = {
+				kind: "user",
+				id: `user-${event.offset}`,
+				text,
+				timestampMs
+			};
+			if (hasRunningStep) return {
+				...state,
+				queuedUserMessages: [...state.queuedUserMessages, item]
+			};
+			return emitItem(hasRunningStep ? state : settleLive(state, timestampMs, ops), ops, item);
+		}
+		case "events.iterate.com/agents/web-message-sent":
+		case "events.iterate.com/agents/tui-message-sent": {
+			const text = readString(event, "message");
+			if (text == null) return state;
+			return emitItem(settleLive(state, timestampMs, ops), ops, {
+				kind: "assistant",
+				id: `assistant-${event.offset}`,
+				text,
+				timestampMs
+			});
+		}
+		case AGENT_LLM_REQUEST_REQUESTED: {
+			const base = state.queuedUserMessages.length === 0 ? state : flushQueuedUserMessages(settleLive(state, timestampMs, ops), ops);
+			const live = ensureLive(base, event.offset, timestampMs);
+			const model = readString(event, "model");
+			const step = {
+				kind: "llm",
+				id: `llm-${event.offset}`,
+				llmRequestId: event.offset,
+				status: "running",
+				...model == null ? {} : { model },
+				thinkingText: "",
+				responseText: "",
+				startedAtMs: timestampMs
+			};
+			return {
+				...base,
+				live: {
+					...live,
+					steps: [...live.steps, step]
+				}
+			};
+		}
+		case OPENAI_WS_REQUEST_STARTED:
+		case CLOUDFLARE_AI_REQUEST_STARTED: {
+			const llmRequestId = readNumber(event, "llmRequestId");
+			const model = readString(event, "model");
+			if (llmRequestId == null || model == null) return state;
+			return updateLlmStep(state, llmRequestId, (step) => ({
+				...step,
+				model
+			}));
+		}
+		case OPENAI_WS_RESPONSE_CHUNK: {
+			const llmRequestId = readNumber(event, "llmRequestId");
+			const message = readRecord(event, "chunk");
+			if (llmRequestId == null || message == null) return state;
+			const frameType = typeof message.type === "string" ? message.type : "";
+			const delta = typeof message.delta === "string" ? message.delta : "";
+			if (frameType === "response.output_text.delta" && delta !== "") return updateLlmStep(state, llmRequestId, (step) => ({
+				...step,
+				responseText: step.status === "running" ? step.responseText + delta : step.responseText
+			}));
+			if ((frameType === "response.reasoning_summary_text.delta" || frameType === "response.reasoning_text.delta") && delta !== "") return updateLlmStep(state, llmRequestId, (step) => ({
+				...step,
+				thinkingText: step.status === "running" ? step.thinkingText + delta : step.thinkingText
+			}));
+			if (frameType === "response.reasoning_summary_part.added") return updateLlmStep(state, llmRequestId, (step) => ({
+				...step,
+				thinkingText: step.status !== "running" || step.thinkingText === "" ? step.thinkingText : `${step.thinkingText}\n\n`
+			}));
+			return state;
+		}
+		case CLOUDFLARE_AI_RESPONSE_CHUNK: {
+			const llmRequestId = readNumber(event, "llmRequestId");
+			const chunk = readPayloadRecord(event)?.chunk;
+			if (llmRequestId == null) return state;
+			const { responseDelta, thinkingDelta } = extractCloudflareChunkDeltas(chunk);
+			if (responseDelta === "" && thinkingDelta === "") return state;
+			return updateLlmStep(state, llmRequestId, (step) => ({
+				...step,
+				responseText: step.status === "running" ? step.responseText + responseDelta : step.responseText,
+				thinkingText: step.status === "running" ? step.thinkingText + thinkingDelta : step.thinkingText
+			}));
+		}
+		case AGENT_OUTPUT_ADDED: {
+			const llmRequestId = readNumber(event, "llmRequestId");
+			const content = readString(event, "content");
+			if (llmRequestId == null || content == null) return state;
+			return updateLlmStep(state, llmRequestId, (step) => step.status === "running" ? {
+				...step,
+				responseText: content
+			} : step);
+		}
+		case AGENT_LLM_REQUEST_COMPLETED: {
+			const llmRequestId = readNumber(event, "llmRequestId");
+			if (llmRequestId == null) return state;
+			const payload = readPayloadRecord(event);
+			const result = isRecord(payload?.result) ? payload.result : void 0;
+			const status = typeof result?.status === "string" ? result.status : "success";
+			const usage = readUsageTokens(result?.usage);
+			const errorMessage = isRecord(result?.error) && typeof result.error.message === "string" ? result.error.message : void 0;
+			return updateLlmStep(state, llmRequestId, (step) => step.outcome === "cancelled" ? step : {
+				...step,
+				status: "done",
+				outcome: status === "success" ? "completed" : "failed",
+				...typeof payload?.provider === "string" ? { provider: payload.provider } : {},
+				...typeof payload?.durationMs === "number" ? { durationMs: payload.durationMs } : {},
+				...usage.input == null ? {} : { inputTokens: usage.input },
+				...usage.output == null ? {} : { outputTokens: usage.output },
+				...errorMessage == null ? {} : { errorMessage },
+				...typeof result?.providerResponseId === "string" ? { providerResponseId: result.providerResponseId } : {}
+			});
+		}
+		case AGENT_LLM_REQUEST_CANCELLED: {
+			const llmRequestId = readNumber(event, "llmRequestId");
+			if (llmRequestId == null) return state;
+			return updateLlmStep(state, llmRequestId, (step) => ({
+				...step,
+				status: "done",
+				outcome: "cancelled"
+			}));
+		}
+		case SCRIPT_EXECUTION_REQUESTED:
+		case CODEMODE_SCRIPT_EXECUTION_REQUESTED: {
+			const payload = readPayloadRecord(event);
+			const executionId = typeof payload?.executionId === "string" ? payload.executionId : `exec-${event.offset}`;
+			const live = ensureLive(state, event.offset, timestampMs);
+			const step = {
+				kind: "code",
+				id: `code-${executionId}`,
+				executionId,
+				status: "running",
+				code: typeof payload?.code === "string" ? payload.code : "",
+				startedAtMs: timestampMs
+			};
+			return {
+				...state,
+				live: {
+					...live,
+					steps: [...live.steps, step]
+				}
+			};
+		}
+		case SCRIPT_EXECUTION_COMPLETED:
+		case CODEMODE_SCRIPT_EXECUTION_COMPLETED: {
+			const payload = readPayloadRecord(event);
+			if (payload == null || state.live == null) return state;
+			const executionId = typeof payload.executionId === "string" ? payload.executionId : null;
+			const outcome = readCodeOutcome(payload);
+			const steps = [...state.live.steps];
+			const index = executionId == null ? steps.findLastIndex((step) => step.kind === "code" && step.status === "running") : steps.findIndex((step) => step.kind === "code" && step.executionId === executionId);
+			const step = steps[index];
+			if (step == null || step.kind !== "code") return state;
+			steps[index] = {
+				...step,
+				status: "done",
+				...outcome
+			};
+			return {
+				...state,
+				live: {
+					...state.live,
+					steps
+				}
+			};
+		}
+		case AGENT_STATUS_UPDATED:
+			if (readString(event, "status") !== "idle") return state;
+			if (state.live == null) return state;
+			return {
+				...state,
+				live: {
+					...state.live,
+					status: "waiting"
+				}
+			};
+		case STREAM_SUBSCRIBER_CONNECTED: {
+			const payload = readPayloadRecord(event);
+			if (payload == null) return state;
+			const subscriptionKey = typeof payload.subscriptionKey === "string" ? payload.subscriptionKey : null;
+			if (subscriptionKey == null) return state;
+			const direction = payload.direction === "inbound" ? "inbound" : "outbound";
+			const subscriber = isRecord(payload.subscriber) ? payload.subscriber : void 0;
+			const announcement = readProcessorAnnouncement(subscriber?.processor);
+			const entry = {
+				subscriptionKey,
+				direction,
+				connected: true,
+				...typeof subscriber?.description === "string" ? { description: subscriber.description } : {},
+				...announcement == null ? {} : { processor: announcement }
+			};
+			const existingIndex = state.presence.findIndex((candidate) => candidate.subscriptionKey === subscriptionKey);
+			const presence = existingIndex === -1 ? [...state.presence, entry] : state.presence.map((candidate, index) => index === existingIndex ? {
+				...candidate,
+				...entry
+			} : candidate);
+			return {
+				...state,
+				presence
+			};
+		}
+		case STREAM_SUBSCRIBER_DISCONNECTED: {
+			const subscriptionKey = readString(event, "subscriptionKey");
+			if (subscriptionKey == null) return state;
+			return {
+				...state,
+				presence: state.presence.map((entry) => entry.subscriptionKey === subscriptionKey ? {
+					...entry,
+					connected: false
+				} : entry)
+			};
+		}
+		case STREAM_WOKEN: return {
+			...state,
+			presence: state.presence.map((entry) => entry.connected ? {
+				...entry,
+				connected: false
+			} : entry)
+		};
+		default: return state;
+	}
+}
+function ensureLive(state, offset, startedAtMs) {
+	if (state.live != null) return {
+		...state.live,
+		status: "running"
+	};
+	return {
+		kind: "activity",
+		id: `activity-${offset}`,
+		status: "running",
+		steps: [],
+		startedAtMs
+	};
+}
+/** Closes the live activity (if any) and emits it as a settled item. */
+function settleLive(state, endedAtMs, ops) {
+	if (state.live == null) return state;
+	if (state.live.steps.length === 0) return {
+		...state,
+		live: null
+	};
+	const settled = {
+		...state.live,
+		status: "done",
+		endedAtMs,
+		steps: state.live.steps.map((step) => step.status === "running" ? {
+			...step,
+			status: "done"
+		} : step)
+	};
+	return emitItem({
+		...state,
+		live: null
+	}, ops, settled);
+}
+function flushQueuedUserMessages(state, ops) {
+	let next = {
+		...state,
+		queuedUserMessages: []
+	};
+	for (const item of state.queuedUserMessages) next = emitItem(next, ops, item);
+	return next;
+}
+function updateLlmStep(state, llmRequestId, update) {
+	if (state.live == null) return state;
+	const index = state.live.steps.findIndex((step) => step.kind === "llm" && step.llmRequestId === llmRequestId);
+	const step = state.live.steps[index];
+	if (step == null || step.kind !== "llm") return state;
+	const steps = [...state.live.steps];
+	steps[index] = update(step);
+	return {
+		...state,
+		live: {
+			...state.live,
+			steps
+		}
+	};
+}
+function extractCloudflareChunkDeltas(chunk) {
+	if (typeof chunk === "string") return {
+		responseDelta: chunk,
+		thinkingDelta: ""
+	};
+	if (!isRecord(chunk)) return {
+		responseDelta: "",
+		thinkingDelta: ""
+	};
+	if (typeof chunk.response === "string") return {
+		responseDelta: chunk.response,
+		thinkingDelta: ""
+	};
+	if (Array.isArray(chunk.choices) && isRecord(chunk.choices[0])) {
+		const delta = isRecord(chunk.choices[0].delta) ? chunk.choices[0].delta : void 0;
+		return {
+			responseDelta: typeof delta?.content === "string" ? delta.content : "",
+			thinkingDelta: typeof delta?.reasoning_content === "string" ? delta.reasoning_content : ""
+		};
+	}
+	if (isRecord(chunk.delta)) return {
+		responseDelta: typeof chunk.delta.text === "string" ? chunk.delta.text : "",
+		thinkingDelta: typeof chunk.delta.thinking === "string" ? chunk.delta.thinking : ""
+	};
+	return {
+		responseDelta: "",
+		thinkingDelta: ""
+	};
+}
+function readCodeOutcome(payload) {
+	const outcome = isRecord(payload.outcome) ? payload.outcome : void 0;
+	const success = payload.ok !== false && payload.error == null && outcome?.status !== "threw";
+	const result = "result" in payload ? payload.result : outcome?.value;
+	const error = typeof payload.error === "string" ? payload.error : outcome?.status === "threw" ? stringifyUnknown(outcome.error) : void 0;
+	const logs = Array.isArray(payload.logs) ? payload.logs.filter((line) => typeof line === "string") : void 0;
+	return {
+		success,
+		...result === void 0 ? {} : { result },
+		...error == null ? {} : { errorMessage: error },
+		...logs == null ? {} : { logs },
+		...typeof payload.durationMs === "number" ? { durationMs: payload.durationMs } : {}
+	};
+}
+function readUsageTokens(usage) {
+	if (!isRecord(usage)) return {};
+	const input = usage.input_tokens ?? usage.prompt_tokens;
+	const output = usage.output_tokens ?? usage.completion_tokens;
+	return {
+		...typeof input === "number" ? { input } : {},
+		...typeof output === "number" ? { output } : {}
+	};
+}
+function readProcessorAnnouncement(value) {
+	if (!isRecord(value)) return null;
+	const announcement = isRecord(value.announcement) ? value.announcement : value;
+	if (typeof announcement.slug !== "string" || typeof announcement.version !== "string") return null;
+	return {
+		slug: announcement.slug,
+		version: announcement.version,
+		description: typeof announcement.description === "string" ? announcement.description : "",
+		consumes: readStringArray(announcement.consumes),
+		emits: readStringArray(announcement.emits),
+		ownedEvents: Array.isArray(announcement.ownedEvents) ? announcement.ownedEvents.filter((owned) => isRecord(owned)).filter((owned) => typeof owned.type === "string").map((owned) => ({
+			type: owned.type,
+			...typeof owned.description === "string" ? { description: owned.description } : {}
+		})) : []
+	};
+}
+function readStringArray(value) {
+	return Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
+}
+function readString(event, key) {
+	const value = readPayloadRecord(event)?.[key];
+	return typeof value === "string" ? value : null;
+}
+function readNumber(event, key) {
+	const value = readPayloadRecord(event)?.[key];
+	return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+function readRecord(event, key) {
+	const value = readPayloadRecord(event)?.[key];
+	return isRecord(value) ? value : null;
+}
+function readPayloadRecord(event) {
+	return isRecord(event.payload) ? event.payload : null;
+}
+function isRecord(value) {
+	return value != null && typeof value === "object" && !Array.isArray(value);
+}
+function stringifyUnknown(value) {
+	if (typeof value === "string") return value;
+	try {
+		return JSON.stringify(value);
+	} catch {
+		return String(value);
+	}
+}
+//#endregion
+//#region src/stream-tui/agent-feed-model.ts
+/**
+* In-memory agent conversation feed for the chat TUI.
+*
+* This is the node-side sibling of the browser mirror's agent-ui processor
+* (apps/os/src/domains/streams/client-libraries/processors/agent-ui-processor.ts):
+* both fold the SAME shared reducer (`planAgentUiOps` from @iterate-com/ui)
+* over agent stream events. The browser persists settled items into SQLite for
+* a virtual list; a terminal session is ephemeral and small, so this model
+* keeps the settled items in a plain array and the streaming live activity in
+* the reduced state — no database, no processor host.
+*/
+function createAgentFeedModel() {
+	let state = initialAgentUiState();
+	let items = [];
+	let lastOffset = 0;
+	let snapshot = {
+		items,
+		live: null,
+		eventCount: 0,
+		lastOffset
+	};
+	return {
+		snapshot: () => snapshot,
+		applyEvents(events) {
+			const fresh = events.filter((event) => event.offset > lastOffset);
+			if (fresh.length === 0) return false;
+			lastOffset = fresh[fresh.length - 1].offset;
+			const { endState, ops } = planAgentUiOps(state, fresh);
+			if (ops.length > 0) {
+				items = [...items];
+				for (const op of ops) items[op.localIndex] = op.item;
+			}
+			state = endState;
+			snapshot = {
+				items,
+				live: state.live,
+				eventCount: state.eventCount,
+				lastOffset
+			};
+			return true;
+		}
+	};
+}
+//#endregion
+//#region src/stream-tui/agent-connection.ts
+const RECONNECT_DELAY_MS = 1e3;
+const MAX_RECONNECT_DELAY_MS = 15e3;
+/**
+* Resolve itx credentials for the TUI, in priority order: an admin API secret
+* from the environment (doppler / e2e lanes), an explicit bearer token, then
+* the stored `iterate login` session for the named config. The launcher
+* (`iterate chat`) refreshes the stored session before spawning the TUI, so a
+* plain bearer read is enough here.
+*/
+function resolveItxAuth(input) {
+	const adminSecret = readEnv("APP_CONFIG_ADMIN_API_SECRET");
+	if (adminSecret) return {
+		type: "admin-secret",
+		secret: adminSecret
+	};
+	const bearerToken = readEnv("ITERATE_BEARER_TOKEN");
+	if (bearerToken) return {
+		type: "bearer",
+		token: bearerToken
+	};
+	if (input.configName) {
+		const config = readConfig(input.configName, { throw: true });
+		if (config.session?.token) return {
+			type: "bearer",
+			token: config.session.token
+		};
+	}
+	throw new Error("No credentials: run `iterate login`, or set an admin API secret (APP_CONFIG_ADMIN_API_SECRET) or a bearer token (ITERATE_BEARER_TOKEN).");
+}
+function connectAgentFeed(input) {
+	let disposed = false;
+	let agent;
+	let subscription;
+	let consecutiveFailures = 0;
+	const disposeAgent = () => {
+		try {
+			subscription?.[Symbol.dispose]?.();
+			agent?.[Symbol.dispose]?.();
+		} catch {}
+		subscription = void 0;
+		agent = void 0;
+	};
+	const scheduleReconnect = (detail) => {
+		if (disposed) return;
+		disposeAgent();
+		consecutiveFailures += 1;
+		const delay = Math.min(RECONNECT_DELAY_MS * consecutiveFailures, MAX_RECONNECT_DELAY_MS);
+		input.onStatus({
+			kind: "reconnecting",
+			detail
+		});
+		setTimeout(() => void establish(), delay);
+	};
+	async function establish() {
+		if (disposed) return;
+		input.onStatus({ kind: "connecting" });
+		const nextAgent = connectItx({
+			auth: input.auth,
+			baseUrl: input.baseUrl,
+			projectId: input.projectId,
+			agentPath: input.agentPath
+		});
+		agent = nextAgent;
+		nextAgent.onRpcBroken?.((error) => {
+			if (agent !== nextAgent) return;
+			scheduleReconnect(errorMessage(error));
+		});
+		try {
+			subscription = await nextAgent.stream.subscribe({
+				processEventBatch: (batch) => input.onEvents(batch.events),
+				replayAfterOffset: input.replayAfterOffset(),
+				subscriber: { description: "iterate chat TUI" }
+			});
+			if (disposed) {
+				disposeAgent();
+				return;
+			}
+			consecutiveFailures = 0;
+			input.onStatus({ kind: "live" });
+		} catch (error) {
+			if (agent === nextAgent) scheduleReconnect(errorMessage(error));
+		}
+	}
+	establish();
+	return {
+		async sendMessage(text) {
+			if (agent === void 0) throw new Error("not connected");
+			await agent.sendMessage(text);
+		},
+		dispose() {
+			disposed = true;
+			disposeAgent();
+		}
+	};
+}
+function errorMessage(error) {
+	return error instanceof Error ? error.message : String(error);
+}
+function readEnv(name) {
+	const value = process.env[name]?.trim();
+	return value ? value : void 0;
+}
+//#endregion
+//#region src/stream-tui/feed-format.ts
+function formatActivitySummary(activity) {
+	const codeCount = activity.steps.filter((step) => step.kind === "code").length;
+	const requestCount = activity.steps.filter((step) => step.kind === "llm").length;
+	const interrupted = activity.steps.some((step) => step.kind === "llm" && step.outcome === "cancelled");
+	const parts = [];
+	if (codeCount > 0) parts.push(`Ran code ${codeCount}×`);
+	parts.push(`${requestCount} request${requestCount === 1 ? "" : "s"}`);
+	if (interrupted) parts.push("interrupted");
+	const totalMs = activity.endedAtMs == null ? null : Math.max(0, activity.endedAtMs - activity.startedAtMs);
+	if (totalMs != null && totalMs > 0) parts.push(formatSeconds(totalMs));
+	return parts.join(" · ");
+}
+function formatStepLine(step) {
+	const parts = [step.kind === "code" ? "Ran code" : step.model ?? step.provider ?? "LLM request"];
+	if (step.kind === "llm") {
+		if (step.inputTokens != null || step.outputTokens != null) parts.push(`${formatTokens(step.inputTokens)} → ${formatTokens(step.outputTokens)} tok`);
+		if (step.outcome === "failed") parts.push("failed");
+		if (step.outcome === "cancelled") parts.push("interrupted");
+	} else if (step.success === false) parts.push("failed");
+	if (step.durationMs != null) parts.push(formatSeconds(step.durationMs));
+	if (step.status === "running") parts.push("running");
+	return parts.join(" · ");
+}
+function formatSeconds(ms) {
+	return `${(ms / 1e3).toFixed(1)}s`;
+}
+function formatTokens(count) {
+	if (count == null) return "?";
+	if (count < 1e3) return String(count);
+	return `${(count / 1e3).toFixed(1)}k`;
+}
+/** The last `maxChars` of streamed text, trimmed to whole lines where possible. */
+function streamingTail(text, maxChars = 600) {
+	const trimmed = text.trimEnd();
+	if (trimmed.length <= maxChars) return trimmed;
+	const tail = trimmed.slice(-maxChars);
+	const firstNewline = tail.indexOf("\n");
+	return `…${firstNewline === -1 ? tail : tail.slice(firstNewline)}`;
+}
+//#endregion
+//#region src/stream-tui/agent-chat-terminal.tsx
+/** @jsxImportSource @opentui/react */
+/**
+* React/OpenTUI terminal chat with one project agent.
+*
+* The data layer is the shared client stack, not a bespoke stream client:
+* `connectItx` (apps/os/src/itx-client.ts) hands us the same `Agent`
+* capability the web app uses, a live `stream.subscribe` pumps events into
+* the shared agent-ui reducer (@iterate-com/ui), and sends go through
+* `agent.sendMessage`. This file owns only terminal runtime state and
+* rendering.
+*/
+if (!process.stdin.isTTY || !process.stdout.isTTY) throw new Error("iterate chat requires an interactive terminal.");
+const COLORS = {
+	bg: "#0b0f14",
+	surface: "#27272a",
+	border: "#3f3f46",
+	accent: "#22c55e",
+	warning: "#facc15",
+	danger: "#ef4444",
+	text: "#e5e7eb",
+	textSecondary: "#9ca3af",
+	textBody: "#d1d5db",
+	textMuted: "#6b7280",
+	agent: "#a78bfa"
+};
+const args = parseArgs(process.argv.slice(2));
+const model = createAgentFeedModel();
+let appState = {
+	feed: model.snapshot(),
+	status: { kind: "connecting" },
+	notice: ""
+};
+const listeners = /* @__PURE__ */ new Set();
+function patchAppState(patch) {
+	appState = {
+		...appState,
+		...patch
+	};
+	for (const listener of listeners) listener();
+}
+const connection = connectAgentFeed({
+	auth: resolveItxAuth({ configName: process.env.ITERATE_CONFIG_NAME }),
+	baseUrl: args.baseUrl,
+	projectId: args.projectId,
+	agentPath: args.agentPath,
+	replayAfterOffset: () => model.snapshot().lastOffset,
+	onEvents: (events) => {
+		if (model.applyEvents(events)) patchAppState({ feed: model.snapshot() });
+	},
+	onStatus: (status) => patchAppState({ status })
+});
+function AgentChatApp() {
+	const state = useSyncExternalStore(useCallback((listener) => {
+		listeners.add(listener);
+		return () => listeners.delete(listener);
+	}, []), () => appState);
+	const [composerValue, setComposerValue] = useState("");
+	const [composerRevision, setComposerRevision] = useState(0);
+	const clearComposer = useCallback(() => {
+		setComposerValue("");
+		setComposerRevision((previous) => previous + 1);
+	}, []);
+	useKeyboard((key) => {
+		if (key.name === "escape") clearComposer();
+	});
+	const submit = useCallback((value) => {
+		const message = value.trim();
+		if (message === "") return;
+		clearComposer();
+		patchAppState({ notice: "sending…" });
+		connection.sendMessage(message).then(() => patchAppState({ notice: "" })).catch((error) => {
+			patchAppState({ notice: `send failed: ${error instanceof Error ? error.message : String(error)}` });
+		});
+	}, [clearComposer]);
+	return /* @__PURE__ */ jsxs("box", {
+		width: "100%",
+		height: "100%",
+		flexDirection: "column",
+		backgroundColor: COLORS.bg,
+		children: [
+			/* @__PURE__ */ jsx(ChatHeader, {
+				status: state.status,
+				notice: state.notice,
+				eventCount: state.feed.eventCount
+			}),
+			/* @__PURE__ */ jsxs("scrollbox", {
+				width: "100%",
+				flexGrow: 1,
+				border: true,
+				borderStyle: "single",
+				borderColor: COLORS.border,
+				backgroundColor: COLORS.bg,
+				stickyScroll: true,
+				stickyStart: "bottom",
+				contentOptions: {
+					flexDirection: "column",
+					paddingLeft: 1,
+					paddingRight: 1,
+					gap: 1
+				},
+				children: [
+					state.feed.items.length === 0 && state.feed.live == null ? /* @__PURE__ */ jsxs("text", {
+						fg: COLORS.textMuted,
+						children: [
+							"No messages yet — say something to ",
+							args.agentPath.slice(8),
+							"."
+						]
+					}) : null,
+					state.feed.items.map((item) => /* @__PURE__ */ jsx(FeedItem, { item }, item.id)),
+					state.feed.live == null ? null : /* @__PURE__ */ jsx(LiveActivity, { activity: state.feed.live })
+				]
+			}),
+			/* @__PURE__ */ jsx("box", {
+				width: "100%",
+				height: 3,
+				border: true,
+				borderStyle: "single",
+				borderColor: COLORS.accent,
+				backgroundColor: COLORS.bg,
+				paddingLeft: 1,
+				paddingRight: 1,
+				children: /* @__PURE__ */ jsx("input", {
+					width: "100%",
+					value: composerValue,
+					placeholder: "Message the agent (Enter to send, Ctrl+C to quit)",
+					focused: true,
+					backgroundColor: "transparent",
+					focusedBackgroundColor: "transparent",
+					textColor: COLORS.text,
+					focusedTextColor: COLORS.text,
+					placeholderColor: COLORS.textMuted,
+					cursorColor: COLORS.accent,
+					onInput: setComposerValue,
+					onSubmit: (value) => {
+						if (typeof value === "string") submit(value);
+					}
+				}, composerRevision)
+			})
+		]
+	});
+}
+function ChatHeader(props) {
+	const statusLabel = props.status.kind === "live" ? "live" : props.status.kind === "connecting" ? "connecting" : `reconnecting (${props.status.detail})`;
+	const statusColor = props.status.kind === "live" ? COLORS.accent : props.status.kind === "connecting" ? COLORS.warning : COLORS.danger;
+	const meta = [
+		`${props.eventCount} event${props.eventCount === 1 ? "" : "s"}`,
+		statusLabel,
+		props.notice
+	].filter(Boolean).join(" · ");
+	return /* @__PURE__ */ jsxs("box", {
+		width: "100%",
+		height: 3,
+		border: true,
+		borderStyle: "single",
+		borderColor: COLORS.border,
+		backgroundColor: COLORS.surface,
+		flexDirection: "row",
+		paddingLeft: 1,
+		paddingRight: 1,
+		gap: 1,
+		children: [
+			/* @__PURE__ */ jsx("text", {
+				width: 6,
+				content: getBrandMarkText()
+			}),
+			/* @__PURE__ */ jsx("text", {
+				flexGrow: 1,
+				fg: COLORS.text,
+				content: `${args.projectId} ${args.agentPath}`
+			}),
+			/* @__PURE__ */ jsx("text", {
+				fg: COLORS.textSecondary,
+				content: meta
+			}),
+			/* @__PURE__ */ jsx("text", {
+				width: 2,
+				fg: statusColor,
+				children: "●"
+			})
+		]
+	});
+}
+function FeedItem(props) {
+	if (props.item.kind === "activity") return /* @__PURE__ */ jsx(SettledActivity, { activity: props.item });
+	return /* @__PURE__ */ jsx(Message, { item: props.item });
+}
+function Message(props) {
+	const isUser = props.item.kind === "user";
+	return /* @__PURE__ */ jsxs("box", {
+		flexDirection: "column",
+		children: [/* @__PURE__ */ jsxs("text", {
+			fg: isUser ? COLORS.accent : COLORS.agent,
+			children: [isUser ? "you ›" : "agent ›", /* @__PURE__ */ jsxs("span", {
+				fg: COLORS.textMuted,
+				children: [" ", formatClock(props.item.timestampMs)]
+			})]
+		}), /* @__PURE__ */ jsx("text", {
+			fg: COLORS.textBody,
+			children: props.item.text
+		})]
+	});
+}
+function SettledActivity(props) {
+	return /* @__PURE__ */ jsxs("box", {
+		flexDirection: "column",
+		children: [/* @__PURE__ */ jsxs("text", {
+			fg: COLORS.textMuted,
+			children: ["✦ ", formatActivitySummary(props.activity)]
+		}), props.activity.steps.map((step) => /* @__PURE__ */ jsxs("text", {
+			fg: COLORS.textMuted,
+			children: [
+				"  ",
+				"· ",
+				formatStepLine(step)
+			]
+		}, step.id))]
+	});
+}
+function LiveActivity(props) {
+	const lastStep = props.activity.steps[props.activity.steps.length - 1];
+	const thinking = lastStep?.kind === "llm" ? streamingTail(lastStep.thinkingText) : "";
+	const streamed = lastStep?.kind === "llm" ? streamingTail(lastStep.responseText) : lastStep?.kind === "code" ? streamingTail(lastStep.code) : "";
+	return /* @__PURE__ */ jsxs("box", {
+		flexDirection: "column",
+		children: [
+			/* @__PURE__ */ jsxs("text", {
+				fg: props.activity.status === "waiting" ? COLORS.textMuted : COLORS.warning,
+				children: ["✦ ", props.activity.status === "waiting" ? "waiting" : "working…"]
+			}),
+			props.activity.steps.map((step) => /* @__PURE__ */ jsxs("text", {
+				fg: COLORS.textMuted,
+				children: [
+					"  ",
+					"· ",
+					formatStepLine(step)
+				]
+			}, step.id)),
+			thinking === "" ? null : /* @__PURE__ */ jsx("text", {
+				fg: COLORS.textMuted,
+				children: thinking
+			}),
+			streamed === "" ? null : /* @__PURE__ */ jsx("text", {
+				fg: COLORS.textSecondary,
+				children: streamed
+			})
+		]
+	});
+}
+function getBrandMarkText() {
+	return new StyledText([
+		fg("#000000")(bg(COLORS.surface)("▐")),
+		bg("#000000")(fg("#ffffff")(" 𝑖 ")),
+		fg("#000000")(bg(COLORS.surface)("▌"))
+	]);
+}
+function formatClock(timestampMs) {
+	return new Date(timestampMs).toLocaleTimeString(void 0, {
+		hour: "2-digit",
+		minute: "2-digit"
+	});
+}
+function parseArgs(argv) {
+	const baseUrl = readFlag(argv, "--base-url");
+	const projectId = readFlag(argv, "--project-id");
+	const agentPath = readFlag(argv, "--agent-path");
+	if (baseUrl == null || projectId == null || agentPath == null) throw new Error("Usage: bun agent-chat-terminal.tsx --base-url <url> --project-id <prj_id> --agent-path </agents/name>");
+	if (!agentPath.startsWith("/agents/")) throw new Error(`--agent-path must start with "/agents/", got "${agentPath}".`);
+	return {
+		baseUrl: baseUrl.replace(/\/+$/, ""),
+		projectId,
+		agentPath
+	};
+}
+function readFlag(argv, flagName) {
+	const index = argv.indexOf(flagName);
+	if (index === -1) return void 0;
+	const value = argv[index + 1];
+	if (value == null || value.startsWith("--")) throw new Error(`${flagName} requires a value.`);
+	return value;
+}
+const renderer = await createCliRenderer({
+	exitOnCtrlC: true,
+	targetFps: 30,
+	screenMode: "alternate-screen",
+	consoleMode: "disabled"
+});
+process.on("exit", () => connection.dispose());
+createRoot(renderer).render(/* @__PURE__ */ jsx(AgentChatApp, {}));
+//#endregion
+export {};
+
+//# sourceMappingURL=agent-chat-terminal.mjs.map