react-websocket 3.6.0 → 4.18.0

package/README.md

@@ -12,15 +12,24 @@
 **[Documentation](https://mehmetkose.github.io/react-websocket/)** · [Getting started](https://mehmetkose.github.io/react-websocket/guide/getting-started) · [API](https://mehmetkose.github.io/react-websocket/api/) · [Recipes](https://mehmetkose.github.io/react-websocket/recipes) · [Changelog](CHANGELOG.md)
 
 - **Shared connections.** Components using the same URL share one socket. StrictMode, `<Activity>` and route transitions never open duplicates.
-- **Auto-reconnect.** Exponential backoff with jitter, plus an immediate retry when the browser comes back online or the tab becomes visible. Optional heartbeats detect dead links.
+- **Auto-reconnect.** Exponential backoff with full jitter, plus an immediate retry when the browser comes back online or the tab becomes visible. It backs off from a server that closes right after accepting, and stops on close codes that retrying can't fix. Optional heartbeats detect dead links.
 - **Send queue.** `send()` before the socket is open just works. The message goes out on connect. Mark input `volatile` so it's never replayed late, or `key` it so only the newest is sent. Put control messages first with `priority`, and drop stream data on a slow link with `maxBuffered`.
 - **Typed messages.** `json: true`, your own codec, or validation with any [Standard Schema](https://standardschema.dev) library (zod, valibot, arktype), with inferred types.
 - **Suspense.** `use(client.ready)` waits for the first connection, and reconnects never flash a fallback.
-- **Topic subscriptions.** Reference-counted `subscribe`/`unsubscribe` messages that are sent again after every reconnect, so feeds don't silently stop.
+- **Topic subscriptions.** Reference-counted `subscribe`/`unsubscribe` messages that are sent again after every reconnect, so feeds don't silently stop. With numbered messages, each arrives once and in order: duplicates are dropped, gaps are filled, and a reconnect resumes where it left off.
 - **Message state.** Reduce messages into a store, and let each component re-render only when its slice changes, at most once per frame if you like.
 - **Requests, streams and latency.** Await a reply, or iterate over streamed ones such as an LLM's tokens, with timeouts and a cancel that tells the server to stop. Measure round-trip time and the server's clock for ping displays and synchronized countdowns.
 - **Games.** Snapshot interpolation and client-side prediction with server reconciliation, from `react-websocket/timeline`, so other players move smoothly and your own controls respond at once. A send rate that adapts to the connection keeps players on a poor link from building up lag.
+- **Presence and live cursors.** Share per-peer state such as cursors: throttled, refreshed while idle, never replayed stale, and expired when a peer vanishes without saying goodbye.
+- **Offline outbox.** Messages kept in IndexedDB until the server acknowledges them, from `react-websocket/outbox`, so an order taken on flaky Wi-Fi survives reconnects and page reloads, and retries are safe with idempotency keys.
+- **Resumable runs.** An AI agent's streamed answer that survives a refresh, a network switch or a sleeping laptop: it resumes from the last event received, or is cancelled so the server stops spending.
+- **Voice.** Microphone frames that never replay stale or build up lag, control messages that jump the queue, and a [guide](https://mehmetkose.github.io/react-websocket/guide/voice) to interruptions that truncate the transcript to what the user heard.
+- **AG-UI.** Run [AG-UI](https://docs.ag-ui.com) agents over a WebSocket with `react-websocket/ag-ui`: messages, tool calls and JSON Patch shared state, with a snapshot when a patch fails, and runs that resume after a reconnect or a reload.
 - **Server requests.** Answer requests from the server, such as an AI agent's, in code for browser-only tools, or from a dialog for human approval. Every request gets exactly one reply, and none is sent to the wrong connection.
+- **WebTransport.** `react-websocket/webtransport` connects over WebTransport behind the same API, with `volatile` sends as datagrams and a WebSocket fallback where it can't connect.
+- **One connection across tabs.** `react-websocket/tabs` lets every tab of an app share one connection, with a leader tab elected over the Web Locks API, and topics that one tab can't unsubscribe from under another.
+- **Recording and replay.** Record a session to a file and replay it without a server, for bug reports, offline demos, and UI tests that don't call an AI model on every run. Add faults on top with `react-websocket/chaos`.
+- **Devtools.** A development panel, `react-websocket/devtools`, with each client's status, queue, send buffer, messages, round-trip time and topics.
 - **SSR-safe.** Never connects during a server render, hydrates cleanly, and ships a `'use client'` entry for Next.js and other Server Components frameworks.
 - **Small and typed.** Zero dependencies, ESM + CJS, TypeScript declarations with inline docs, plus a React-free `react-websocket/core` entry.
 
@@ -118,15 +127,31 @@ function Room() {
 | `useWebSocketLatency(latency)` | Round-trip time and server clock offset |
 | `useAgentApproval(responder, method)` | Requests from the server waiting for a person to answer |
 | `useWebSocketStream(rpc, options?)` | Stream the replies to a request into a value, e.g. tokens into an answer; returns `{ value, status, error, start, abort }` |
+| `useAgentRun(runs, runId)` | A resumable run's value and status, e.g. an AI answer that keeps streaming after a reconnect or a reload |
+| `useAgUiAgent(agent)` | An AG-UI agent's thread: messages, tool calls, shared state and status |
+| `useWebSocketPresence(presence)` | The other peers' shared state, such as live cursors |
+| `useInView(ref, options?)` | Whether an element is on screen, to pick a topic with: full detail only for what's visible |
+| `useWebSocketOutbox(outbox)` | The messages waiting in an outbox, for a "3 orders waiting to sync" banner |
 | `createWebSocket(url, options?)` | A shareable client: `send`, `on`, `connect`, `close`, `reconnect`, `ready`, `getSnapshot`, `subscribe` |
 | `createWebSocketTopics(client, { subscribe, unsubscribe })` | Topic subscription manager for `useWebSocketTopic` |
+| `createWebSocketFeeds(client, { subscribe, sequence, snapshot })` | Topics with numbered messages, each delivered once and in order across reconnects; pass it to `createWebSocketState` |
 | `createWebSocketState(client, { initialState, reduce })` | Message-state store for `useWebSocketState` |
 | `createWebSocketRequests(client, { send, reply })` | `request(message)` returns a promise of the reply, and `stream(message)` an async iterator of replies, with timeouts and `cancel` |
 | `createWebSocketLatency(client, { ping, pong })` | Ping tracker for `useWebSocketLatency`, plus `serverNow()` |
 | `createWebSocketSendRate(client, options?)` | `send(message, key)` coalesced per key at a rate that drops on a congested link |
+| `createWebSocketPresence(client, { send, receive })` | `set(state)` shares this client's state, throttled and refreshed; peers expire after `timeout` |
 | `createWebSocketResponder(client, { request, respond, error })` | Answer the server's requests: `onRequest(method, handler)`, or a person through `useAgentApproval` |
+| `createWebSocketRuns(client, { start, resume, event, reduce })` | Runs that resume after a reconnect or a reload: `start(request)`, `abort(runId)`, a `keep` or `cancel` policy |
 | `MessageError` | Reported to `onError` when a message fails `parse` or `schema` |
+| `retryableClose(close)` | The default `reconnect.shouldReconnect`: retries every close except `1002`, `1003` and `1008` |
+| `retryAfter(close)` | The default `reconnect.retryAfter`: the delay a `1012` (Service Restart) or `1013` (Try Again Later) close asks for, in seconds in its reason |
 | `createWebSocketTimeline(client, { snapshot, interpolate, input })` | From `react-websocket/timeline`: interpolated server snapshots (`at()`) and predicted inputs (`predicted()`, `input()`) for multiplayer games |
+| `createWebSocketOutbox(client, { name, send, ack })` | From `react-websocket/outbox`: `add(message)` keeps a message in IndexedDB and sends it until the server acknowledges it, across reconnects and reloads |
+| `createAgUiAgent(client, options?)` | From `react-websocket/ag-ui`: `run({ messages })` an AG-UI agent over a WebSocket; also `applyAgUiEvent` and `applyPatch` |
+| `createWebTransportSocket(options?)` | From `react-websocket/webtransport`: a `WebSocket` class over WebTransport, with datagrams for `volatile` sends and a WebSocket fallback |
+| `createTabsWebSocket(options?)` | From `react-websocket/tabs`: a `WebSocket` class that shares one connection between all the tabs of an app |
+| `createRecordingWebSocket()` / `createReplayWebSocket(recording)` | From `react-websocket/replay`: record sessions to JSON, and replay them without a server, at any speed |
+| `<WebSocketDevtools sources={…} />` | From `react-websocket/devtools`: a development panel showing every client's status, queue, buffer, messages, RTT and topics |
 | `createChaosWebSocket(options)` | From `react-websocket/chaos`: a `WebSocket` class that adds latency, lost messages and dropped connections in development |
 
 | Option | Default | |
@@ -136,9 +161,9 @@ function Room() {
 | `json` | `false` | `JSON.parse` incoming and `JSON.stringify` outgoing messages |
 | `parse(data)` / `serialize(message)` | | Custom codec; takes precedence over `json` |
 | `schema` | | Standard Schema validation; types are inferred |
-| `reconnect` | `true` | `false`, or `{ maxAttempts, minDelay, maxDelay, factor, jitter, shouldReconnect }` |
+| `reconnect` | `true` | `false`, or `{ maxAttempts, minDelay, maxDelay, factor, jitter, minUptime, shouldReconnect, retryAfter }` |
 | `heartbeat` | | `{ interval, message, pong, timeout }` |
-| `queue` | `true` | `false`, or `{ limit }` |
+| `queue` | `true` (100 messages) | `false`, or `{ limit, maxAge }` |
 | `logger` | | e.g. `console.debug` |
 | `WebSocket` | global | Custom implementation for tests, Node, or chaos testing |
 
@@ -149,7 +174,7 @@ function Room() {
 - [Shared clients](https://mehmetkose.github.io/react-websocket/guide/shared-clients) · [Messages and types](https://mehmetkose.github.io/react-websocket/guide/messages) · [Reconnecting and heartbeats](https://mehmetkose.github.io/react-websocket/guide/reconnecting)
 - [Suspense](https://mehmetkose.github.io/react-websocket/guide/suspense) · [Server rendering and Next.js](https://mehmetkose.github.io/react-websocket/guide/ssr) · [StrictMode, Activity and lifecycle](https://mehmetkose.github.io/react-websocket/guide/lifecycle)
 - [Authentication](https://mehmetkose.github.io/react-websocket/guide/authentication) · [Performance](https://mehmetkose.github.io/react-websocket/guide/performance) · [Real-time games](https://mehmetkose.github.io/react-websocket/guide/games) · [AI agents](https://mehmetkose.github.io/react-websocket/guide/agents) · [Testing](https://mehmetkose.github.io/react-websocket/guide/testing) · [Chaos testing](https://mehmetkose.github.io/react-websocket/guide/chaos) · [Without React](https://mehmetkose.github.io/react-websocket/guide/without-react)
-- [Recipes](https://mehmetkose.github.io/react-websocket/recipes) · [Troubleshooting](https://mehmetkose.github.io/react-websocket/troubleshooting) · [Migrating from v2](https://mehmetkose.github.io/react-websocket/migration)
+- [Recipes](https://mehmetkose.github.io/react-websocket/recipes) · [Troubleshooting](https://mehmetkose.github.io/react-websocket/troubleshooting) · [Migrating from v3](https://mehmetkose.github.io/react-websocket/migration-v3) · [Migrating from v2](https://mehmetkose.github.io/react-websocket/migration)
 
 The docs source lives in [`docs/`](docs). Run `npm run docs:dev` to browse it locally.
 
@@ -161,6 +186,10 @@ The docs source lives in [`docs/`](docs). Run `npm run docs:dev` to browse it lo
 | Runtimes | Modern browsers; Node via the `WebSocket` option |
 | Frameworks | Vite, Next.js (App and Pages Router), Remix/React Router, Astro islands, and any React setup |
 
+## Migrating from v3
+
+v4 changes no APIs, only four defaults: the backoff resets once a connection has stayed open for 5 seconds, close codes `1002`, `1003` and `1008` aren't retried, jitter is full, and the send queue holds 100 messages. Each has a one-line opt-out. See [Migrating from v3](https://mehmetkose.github.io/react-websocket/migration-v3).
+
 ## Migrating from v2
 
 v2 was a `<Websocket>` class component. v3 replaces it with hooks: `<Websocket url onMessage />` becomes `useWebSocket(url, { onMessage })`, and `ref.sendMessage(msg)` becomes `send(msg)`. See the [migration guide](https://mehmetkose.github.io/react-websocket/migration) for the full mapping.

package/dist/ag-ui.cjs

@@ -0,0 +1,421 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let __core_cjs = require("./core.cjs");
+//#region src/ag-ui.ts
+function unescape(token) {
+	return token.replace(/~1/g, "/").replace(/~0/g, "~");
+}
+function equal(a, b) {
+	if (a === b) return true;
+	if (typeof a !== "object" || typeof b !== "object" || !a || !b) return false;
+	if (Array.isArray(a) !== Array.isArray(b)) return false;
+	const keys = Object.keys(a);
+	return keys.length === Object.keys(b).length && keys.every((key) => equal(a[key], b[key]));
+}
+function fail(operation) {
+	throw new Error(`JSON Patch failed: ${operation.op} ${operation.path}`);
+}
+const INDEX = /^(0|[1-9]\d*)$/;
+/** A JSON Pointer's tokens. It's empty, for the whole document, or starts with `/`. */
+function tokens(pointer, operation) {
+	if (pointer !== "" && pointer[0] !== "/") fail(operation);
+	return pointer.split("/").slice(1).map(unescape);
+}
+/** Whether `node` has `token`: an index in range for an array, not `length`; an own key otherwise. */
+function has(node, token) {
+	return Array.isArray(node) ? INDEX.test(token) && +token < node.length : Object.hasOwn(node, token);
+}
+/** Set an own property, even `__proto__`, as JSON.parse would. */
+function put(object, key, value) {
+	Object.defineProperty(object, key, {
+		value,
+		writable: true,
+		enumerable: true,
+		configurable: true
+	});
+}
+/**
+* Apply a JSON Patch (RFC 6902) without changing `document`: what changes is copied, the rest is
+* shared. Throws, leaving `document` as it was, if an operation can't be applied: a missing path,
+* an index out of range, a pointer that doesn't start with `/`, or a failed `test`.
+*/
+function applyPatch(document, operations) {
+	let root = document;
+	function get(path, operation) {
+		let node = root;
+		for (const token of tokens(path, operation)) {
+			if (typeof node !== "object" || node === null || !has(node, token)) fail(operation);
+			node = node[token];
+		}
+		return node;
+	}
+	function edit(path, operation, change) {
+		const keys = tokens(path, operation);
+		if (!keys.length) fail(operation);
+		const walk = (node, depth) => {
+			if (typeof node !== "object" || node === null) fail(operation);
+			const copy = Array.isArray(node) ? [...node] : { ...node };
+			const key = keys[depth];
+			if (depth === keys.length - 1) change(copy, key);
+			else if (!has(node, key)) fail(operation);
+			else copy[key] = walk(node[key], depth + 1);
+			return copy;
+		};
+		root = walk(root, 0);
+	}
+	function index(parent, key, operation, adding) {
+		const i = key === "-" ? adding ? parent.length : -1 : INDEX.test(key) ? +key : -1;
+		if (i < 0 || i > parent.length - (adding ? 0 : 1)) fail(operation);
+		return i;
+	}
+	function add(path, value, operation) {
+		if (path === "") return void (root = value);
+		edit(path, operation, (parent, key) => {
+			if (Array.isArray(parent)) parent.splice(index(parent, key, operation, true), 0, value);
+			else put(parent, key, value);
+		});
+	}
+	function remove(path, operation) {
+		edit(path, operation, (parent, key) => {
+			if (Array.isArray(parent)) parent.splice(index(parent, key, operation, false), 1);
+			else if (Object.hasOwn(parent, key)) delete parent[key];
+			else fail(operation);
+		});
+	}
+	for (const operation of operations) {
+		const { op, path, from, value } = operation;
+		if (op === "add") add(path, value, operation);
+		else if (op === "remove") remove(path, operation);
+		else if (op === "replace") {
+			get(path, operation);
+			if (path === "") root = value;
+			else edit(path, operation, (parent, key) => {
+				if (Array.isArray(parent)) parent[key] = value;
+				else put(parent, key, value);
+			});
+		} else if (op === "move" || op === "copy") {
+			const moved = get(from ?? fail(operation), operation);
+			if (op === "move") remove(from, operation);
+			add(path, op === "copy" ? structuredClone(moved) : moved, operation);
+		} else if (op === "test") {
+			if (!equal(get(path, operation), value)) fail(operation);
+		} else fail(operation);
+	}
+	return root;
+}
+function updateMessage(thread, id, change) {
+	return thread.messages.map((message) => message.id === id ? change(message) : message);
+}
+function appendText(message, delta) {
+	return {
+		...message,
+		content: `${message.content ?? ""}${delta ?? ""}`
+	};
+}
+function updateToolCall(thread, id, change) {
+	return thread.messages.map((message) => message.toolCalls?.some((call) => call.id === id) ? {
+		...message,
+		toolCalls: message.toolCalls.map((call) => call.id === id ? change(call) : call)
+	} : message);
+}
+/** The last message with a tool call, for chunks that leave out `toolCallId`. */
+function lastToolCallId(thread) {
+	for (let i = thread.messages.length - 1; i >= 0; i--) {
+		const calls = thread.messages[i].toolCalls;
+		if (calls?.length) return calls.at(-1).id;
+	}
+}
+/**
+* Fold one AG-UI event into a thread, without changing it. Handles the run lifecycle, steps,
+* text, tool calls and their results, reasoning, activity, and message and state snapshots and
+* deltas. A `STATE_DELTA` that can't be applied marks the thread `stale` instead of throwing.
+* Other events, such as `CUSTOM` and `RAW`, return the thread unchanged.
+*
+* Use it as a `reduce` function, or wrap it to handle events of your own.
+*/
+function applyAgUiEvent(thread, event) {
+	const e = event;
+	const message = (role, extra) => ({
+		...thread,
+		messages: [...thread.messages, {
+			id: e.messageId,
+			role,
+			content: "",
+			...extra
+		}]
+	});
+	const known = (id) => thread.messages.some((m) => m.id === id);
+	switch (e.type) {
+		case "RUN_STARTED": return {
+			...thread,
+			status: "running",
+			error: void 0,
+			result: void 0
+		};
+		case "RUN_FINISHED": return {
+			...thread,
+			status: "finished",
+			step: void 0,
+			result: e.result
+		};
+		case "RUN_ERROR": return {
+			...thread,
+			status: "error",
+			step: void 0,
+			error: {
+				message: e.message,
+				code: e.code
+			}
+		};
+		case "STEP_STARTED": return {
+			...thread,
+			step: e.stepName
+		};
+		case "STEP_FINISHED": return {
+			...thread,
+			step: void 0
+		};
+		case "TEXT_MESSAGE_START": return message(e.role ?? "assistant");
+		case "REASONING_MESSAGE_START": return message("reasoning");
+		case "TEXT_MESSAGE_CONTENT":
+		case "REASONING_MESSAGE_CONTENT": return {
+			...thread,
+			messages: updateMessage(thread, e.messageId, (m) => appendText(m, e.delta))
+		};
+		case "TEXT_MESSAGE_CHUNK":
+		case "REASONING_MESSAGE_CHUNK": {
+			const id = e.messageId ?? thread.messages.at(-1)?.id;
+			const role = e.type === "TEXT_MESSAGE_CHUNK" ? e.role ?? "assistant" : "reasoning";
+			const next = known(id) ? thread : message(role);
+			return {
+				...next,
+				messages: updateMessage(next, id, (m) => appendText(m, e.delta))
+			};
+		}
+		case "TOOL_CALL_START":
+		case "TOOL_CALL_CHUNK": {
+			const id = e.toolCallId ?? lastToolCallId(thread);
+			let next = thread;
+			if (e.type === "TOOL_CALL_START" || !thread.messages.some((m) => m.toolCalls?.some((c) => c.id === id))) {
+				const call = {
+					id,
+					type: "function",
+					function: {
+						name: e.toolCallName,
+						arguments: ""
+					}
+				};
+				const parent = e.parentMessageId ?? id;
+				next = known(parent) ? thread : {
+					...thread,
+					messages: [...thread.messages, {
+						id: parent,
+						role: "assistant"
+					}]
+				};
+				next = {
+					...next,
+					messages: updateMessage(next, parent, (m) => ({
+						...m,
+						toolCalls: [...m.toolCalls ?? [], call]
+					}))
+				};
+			}
+			if (e.type === "TOOL_CALL_START") return next;
+			return toolArgs(next, id, e.delta);
+		}
+		case "TOOL_CALL_ARGS": return toolArgs(thread, e.toolCallId, e.delta);
+		case "TOOL_CALL_RESULT": return message(e.role ?? "tool", {
+			toolCallId: e.toolCallId,
+			content: e.content
+		});
+		case "STATE_SNAPSHOT": return {
+			...thread,
+			state: e.snapshot,
+			stale: false
+		};
+		case "STATE_DELTA":
+			if (thread.stale) return thread;
+			try {
+				return {
+					...thread,
+					state: applyPatch(thread.state, e.delta)
+				};
+			} catch {
+				return {
+					...thread,
+					stale: true
+				};
+			}
+		case "MESSAGES_SNAPSHOT": return {
+			...thread,
+			messages: e.messages
+		};
+		case "ACTIVITY_SNAPSHOT": {
+			if (known(e.messageId) && e.replace === false) return thread;
+			const next = known(e.messageId) ? thread : message("activity");
+			return {
+				...next,
+				messages: updateMessage(next, e.messageId, (m) => ({
+					...m,
+					activityType: e.activityType,
+					content: e.content
+				}))
+			};
+		}
+		case "ACTIVITY_DELTA": try {
+			return {
+				...thread,
+				messages: updateMessage(thread, e.messageId, (m) => ({
+					...m,
+					content: applyPatch(m.content, e.patch)
+				}))
+			};
+		} catch {
+			return thread;
+		}
+		default: return thread;
+	}
+}
+function toolArgs(thread, id, delta) {
+	return {
+		...thread,
+		messages: updateToolCall(thread, id, (call) => ({
+			...call,
+			function: {
+				...call.function,
+				arguments: call.function.arguments + (delta ?? "")
+			}
+		}))
+	};
+}
+function randomId() {
+	return globalThis.crypto?.randomUUID?.() ?? `${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`;
+}
+const isEnvelope = (message) => typeof message?.runId === "string" && typeof message.offset === "number" && typeof message.event?.type === "string" ? message : void 0;
+const ENDS = /* @__PURE__ */ new Set(["RUN_FINISHED", "RUN_ERROR"]);
+/**
+* Run an [AG-UI](https://docs.ag-ui.com) agent over a WebSocket. Each run streams AG-UI events,
+* which are folded into the thread's messages and shared state with {@link applyAgUiEvent}.
+* Runs come from `createWebSocketRuns`, so they resume after a reconnect or a reload, and a
+* state delta that can't be applied asks for a snapshot (`resync`).
+*
+* AG-UI doesn't define messages for WebSockets, so the defaults are small: the client sends
+* `{ type: 'run', runId, input }`, `{ type: 'resume', runId, after }` and
+* `{ type: 'cancel', runId }`, and the server sends `{ runId, offset, event }`, with `offset`
+* counting each run's events from 1. Each option replaces one of them.
+*
+* @example
+* ```ts
+* import { createAgUiAgent } from 'react-websocket/ag-ui';
+*
+* export const agent = createAgUiAgent(createWebSocket(url, { json: true }));
+*
+* agent.run({ messages: [{ id: crypto.randomUUID(), role: 'user', content: 'Plan my week' }] });
+* ```
+*/
+function createAgUiAgent(client, options = {}) {
+	const threadId = options.threadId ?? randomId();
+	const empty = {
+		messages: [],
+		state: options.state,
+		status: "idle",
+		stale: false
+	};
+	let base = empty;
+	let snapshot = empty;
+	const listeners = /* @__PURE__ */ new Set();
+	const resynced = /* @__PURE__ */ new Set();
+	const event = options.event ?? isEnvelope;
+	const send = (message) => client.socket?.readyState === 1 && client.send(message);
+	const runs = (0, __core_cjs.createWebSocketRuns)(client, {
+		name: options.name ?? "ag-ui",
+		start: options.run ?? ((input, runId) => ({
+			type: "run",
+			runId,
+			input
+		})),
+		resume: options.resume ?? ((runId, after) => ({
+			type: "resume",
+			runId,
+			after
+		})),
+		cancel: options.cancel ?? ((runId) => ({
+			type: "cancel",
+			runId
+		})),
+		event: (message) => event(message),
+		done: (message) => ENDS.has(event(message).event.type),
+		initial: empty,
+		reduce: (thread, message) => applyAgUiEvent(thread, event(message).event),
+		policy: options.policy,
+		storage: options.storage
+	});
+	function update() {
+		const latest = runs.list().at(-1);
+		let next = latest ? latest.value : base;
+		if (latest?.status === "aborted" && next.status === "running") next = {
+			...next,
+			status: "aborted"
+		};
+		if (latest && !latest.value.stale) resynced.delete(latest.runId);
+		else if (latest && options.resync && !resynced.has(latest.runId)) {
+			if (send(options.resync(latest.runId))) resynced.add(latest.runId);
+		}
+		if (next === snapshot) return;
+		snapshot = next;
+		for (const listener of [...listeners]) listener();
+	}
+	const off = runs.subscribe(update);
+	update();
+	function abort() {
+		for (const run of runs.list()) runs.abort(run.runId);
+	}
+	return {
+		client,
+		runs,
+		run(input = {}, runOptions) {
+			abort();
+			const runId = randomId();
+			base = {
+				...snapshot,
+				stale: false,
+				messages: [...snapshot.messages, ...input.messages ?? []]
+			};
+			runs.start({
+				threadId,
+				runId,
+				state: base.state,
+				messages: base.messages,
+				tools: input.tools ?? [],
+				context: input.context ?? [],
+				forwardedProps: input.forwardedProps ?? {}
+			}, {
+				runId,
+				initial: {
+					...base,
+					status: "running"
+				},
+				policy: runOptions?.policy
+			});
+			return runId;
+		},
+		abort,
+		getSnapshot: () => snapshot,
+		subscribe(listener) {
+			listeners.add(listener);
+			return () => {
+				listeners.delete(listener);
+			};
+		},
+		dispose() {
+			off();
+			runs.dispose();
+		}
+	};
+}
+//#endregion
+exports.applyAgUiEvent = applyAgUiEvent;
+exports.applyPatch = applyPatch;
+exports.createAgUiAgent = createAgUiAgent;
+
+//# sourceMappingURL=ag-ui.cjs.map

package/dist/ag-ui.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ag-ui.cjs","names":["createWebSocketRuns"],"sources":["../src/ag-ui.ts"],"sourcesContent":["// The build keeps `./core` external, so this entry shares the client with the others.\nimport {\n  createWebSocketRuns,\n  type RunPolicy,\n  type RunStorage,\n  type WebSocketClient,\n  type WebSocketRuns\n} from './core';\n\n/** A JSON Patch (RFC 6902) operation, as in AG-UI's `STATE_DELTA` and `ACTIVITY_DELTA`. */\nexport interface JsonPatchOperation {\n  readonly op: 'add' | 'remove' | 'replace' | 'move' | 'copy' | 'test';\n  /** A JSON Pointer (RFC 6901), such as `/items/0/name`. */\n  readonly path: string;\n  /** The source of `move` and `copy`. */\n  readonly from?: string;\n  /** The value to `add`, `replace` with or `test` for. */\n  readonly value?: unknown;\n}\n\n/** An AG-UI event: `type` is `'RUN_STARTED'`, `'TEXT_MESSAGE_CONTENT'`, `'STATE_DELTA'`, … */\nexport interface AgUiEvent {\n  readonly type: string;\n  readonly [field: string]: any;\n}\n\n/** A tool call on an assistant message, as in AG-UI. */\nexport interface AgUiToolCall {\n  readonly id: string;\n  readonly type: 'function';\n  readonly function: { readonly name: string; readonly arguments: string };\n}\n\n/** A message in an AG-UI thread. */\nexport interface AgUiMessage {\n  readonly id: string;\n  readonly role: 'developer' | 'system' | 'assistant' | 'user' | 'tool' | 'reasoning' | 'activity';\n  readonly content?: unknown;\n  readonly toolCalls?: readonly AgUiToolCall[];\n  /** For a `tool` message, the call it answers. */\n  readonly toolCallId?: string;\n  /** For an `activity` message. */\n  readonly activityType?: string;\n  readonly [field: string]: unknown;\n}\n\n/** AG-UI's `RunAgentInput`: what a run starts from. */\nexport interface RunAgentInput {\n  readonly threadId: string;\n  readonly runId: string;\n  readonly parentRunId?: string;\n  readonly state?: unknown;\n  readonly messages: readonly AgUiMessage[];\n  readonly tools: readonly unknown[];\n  readonly context: readonly unknown[];\n  readonly forwardedProps: unknown;\n}\n\n/** A thread's messages and shared state, reduced from AG-UI events. */\nexport interface AgUiThread<S = unknown> {\n  readonly messages: readonly AgUiMessage[];\n  /** The shared state, from `STATE_SNAPSHOT` and `STATE_DELTA`. */\n  readonly state: S;\n  /**\n   * `'running'` from `RUN_STARTED`, `'finished'` after `RUN_FINISHED`, `'error'` after\n   * `RUN_ERROR`, `'aborted'` when the run was stopped from this side.\n   */\n  readonly status: 'idle' | 'running' | 'finished' | 'error' | 'aborted';\n  /** The step in progress, between `STEP_STARTED` and `STEP_FINISHED`. */\n  readonly step?: string;\n  /** From `RUN_ERROR`. */\n  readonly error?: { readonly message: string; readonly code?: string };\n  /** From `RUN_FINISHED`. */\n  readonly result?: unknown;\n  /**\n   * A `STATE_DELTA` couldn't be applied. `state` is the last good one, and later deltas are\n   * skipped until a `STATE_SNAPSHOT` arrives.\n   */\n  readonly stale: boolean;\n}\n\ntype Json = any;\n\nfunction unescape(token: string) {\n  return token.replace(/~1/g, '/').replace(/~0/g, '~');\n}\n\nfunction equal(a: Json, b: Json): boolean {\n  if (a === b) return true;\n  if (typeof a !== 'object' || typeof b !== 'object' || !a || !b) return false;\n  if (Array.isArray(a) !== Array.isArray(b)) return false;\n  const keys = Object.keys(a);\n  return keys.length === Object.keys(b).length && keys.every(key => equal(a[key], b[key]));\n}\n\nfunction fail(operation: JsonPatchOperation): never {\n  throw new Error(`JSON Patch failed: ${operation.op} ${operation.path}`);\n}\n\nconst INDEX = /^(0|[1-9]\\d*)$/;\n\n/** A JSON Pointer's tokens. It's empty, for the whole document, or starts with `/`. */\nfunction tokens(pointer: string, operation: JsonPatchOperation) {\n  if (pointer !== '' && pointer[0] !== '/') fail(operation);\n  return pointer.split('/').slice(1).map(unescape);\n}\n\n/** Whether `node` has `token`: an index in range for an array, not `length`; an own key otherwise. */\nfunction has(node: Json, token: string) {\n  return Array.isArray(node)\n    ? INDEX.test(token) && +token < node.length\n    : Object.hasOwn(node, token);\n}\n\n/** Set an own property, even `__proto__`, as JSON.parse would. */\nfunction put(object: Json, key: string, value: Json) {\n  Object.defineProperty(object, key, {\n    value,\n    writable: true,\n    enumerable: true,\n    configurable: true\n  });\n}\n\n/**\n * Apply a JSON Patch (RFC 6902) without changing `document`: what changes is copied, the rest is\n * shared. Throws, leaving `document` as it was, if an operation can't be applied: a missing path,\n * an index out of range, a pointer that doesn't start with `/`, or a failed `test`.\n */\nexport function applyPatch<T>(document: T, operations: readonly JsonPatchOperation[]): T {\n  let root: Json = document;\n\n  function get(path: string, operation: JsonPatchOperation): Json {\n    let node = root;\n    for (const token of tokens(path, operation)) {\n      if (typeof node !== 'object' || node === null || !has(node, token)) fail(operation);\n      node = node[token];\n    }\n    return node;\n  }\n\n  // Replace the parent of `path` with a copy, change it with `change`, and copy its ancestors.\n  function edit(\n    path: string,\n    operation: JsonPatchOperation,\n    change: (parent: Json, key: string) => void\n  ) {\n    const keys = tokens(path, operation);\n    if (!keys.length) fail(operation);\n    const walk = (node: Json, depth: number): Json => {\n      if (typeof node !== 'object' || node === null) fail(operation);\n      const copy = Array.isArray(node) ? [...node] : { ...node };\n      const key = keys[depth]!;\n      if (depth === keys.length - 1) change(copy, key);\n      else if (!has(node, key)) fail(operation);\n      else copy[key] = walk(node[key], depth + 1);\n      return copy;\n    };\n    root = walk(root, 0);\n  }\n\n  function index(parent: Json[], key: string, operation: JsonPatchOperation, adding: boolean) {\n    // `-` is the end of the array, which only `add` can use.\n    const i = key === '-' ? (adding ? parent.length : -1) : INDEX.test(key) ? +key : -1;\n    if (i < 0 || i > parent.length - (adding ? 0 : 1)) fail(operation);\n    return i;\n  }\n\n  function add(path: string, value: Json, operation: JsonPatchOperation) {\n    if (path === '') return void (root = value);\n    edit(path, operation, (parent, key) => {\n      if (Array.isArray(parent)) parent.splice(index(parent, key, operation, true), 0, value);\n      else put(parent, key, value);\n    });\n  }\n\n  function remove(path: string, operation: JsonPatchOperation) {\n    edit(path, operation, (parent, key) => {\n      if (Array.isArray(parent)) parent.splice(index(parent, key, operation, false), 1);\n      else if (Object.hasOwn(parent, key)) delete parent[key];\n      else fail(operation);\n    });\n  }\n\n  for (const operation of operations) {\n    const { op, path, from, value } = operation;\n    if (op === 'add') add(path, value, operation);\n    else if (op === 'remove') remove(path, operation);\n    else if (op === 'replace') {\n      get(path, operation);\n      if (path === '') root = value;\n      else\n        edit(path, operation, (parent, key) => {\n          if (Array.isArray(parent)) parent[key as unknown as number] = value;\n          else put(parent, key, value);\n        });\n    } else if (op === 'move' || op === 'copy') {\n      const moved = get(from ?? fail(operation), operation);\n      if (op === 'move') remove(from!, operation);\n      add(path, op === 'copy' ? structuredClone(moved) : moved, operation);\n    } else if (op === 'test') {\n      if (!equal(get(path, operation), value)) fail(operation);\n    } else fail(operation);\n  }\n  return root;\n}\n\nfunction updateMessage(\n  thread: AgUiThread<any>,\n  id: string | undefined,\n  change: (message: AgUiMessage) => AgUiMessage\n) {\n  return thread.messages.map(message => (message.id === id ? change(message) : message));\n}\n\nfunction appendText(message: AgUiMessage, delta: string | undefined) {\n  return { ...message, content: `${(message.content as string | undefined) ?? ''}${delta ?? ''}` };\n}\n\nfunction updateToolCall(\n  thread: AgUiThread<any>,\n  id: string | undefined,\n  change: (call: AgUiToolCall) => AgUiToolCall\n) {\n  return thread.messages.map(message =>\n    message.toolCalls?.some(call => call.id === id)\n      ? {\n          ...message,\n          toolCalls: message.toolCalls.map(call => (call.id === id ? change(call) : call))\n        }\n      : message\n  );\n}\n\n/** The last message with a tool call, for chunks that leave out `toolCallId`. */\nfunction lastToolCallId(thread: AgUiThread<any>) {\n  for (let i = thread.messages.length - 1; i >= 0; i--) {\n    const calls = thread.messages[i]!.toolCalls;\n    if (calls?.length) return calls.at(-1)!.id;\n  }\n}\n\n/**\n * Fold one AG-UI event into a thread, without changing it. Handles the run lifecycle, steps,\n * text, tool calls and their results, reasoning, activity, and message and state snapshots and\n * deltas. A `STATE_DELTA` that can't be applied marks the thread `stale` instead of throwing.\n * Other events, such as `CUSTOM` and `RAW`, return the thread unchanged.\n *\n * Use it as a `reduce` function, or wrap it to handle events of your own.\n */\nexport function applyAgUiEvent<S>(thread: AgUiThread<S>, event: AgUiEvent): AgUiThread<S> {\n  const e = event;\n  const message = (role: AgUiMessage['role'], extra?: object): AgUiThread<S> => ({\n    ...thread,\n    messages: [...thread.messages, { id: e.messageId, role, content: '', ...extra }]\n  });\n  const known = (id: string | undefined) => thread.messages.some(m => m.id === id);\n  switch (e.type) {\n    case 'RUN_STARTED':\n      return { ...thread, status: 'running', error: undefined, result: undefined };\n    case 'RUN_FINISHED':\n      return { ...thread, status: 'finished', step: undefined, result: e.result };\n    case 'RUN_ERROR':\n      return {\n        ...thread,\n        status: 'error',\n        step: undefined,\n        error: { message: e.message, code: e.code }\n      };\n    case 'STEP_STARTED':\n      return { ...thread, step: e.stepName };\n    case 'STEP_FINISHED':\n      return { ...thread, step: undefined };\n    case 'TEXT_MESSAGE_START':\n      return message(e.role ?? 'assistant');\n    case 'REASONING_MESSAGE_START':\n      return message('reasoning');\n    case 'TEXT_MESSAGE_CONTENT':\n    case 'REASONING_MESSAGE_CONTENT':\n      return {\n        ...thread,\n        messages: updateMessage(thread, e.messageId, m => appendText(m, e.delta))\n      };\n    case 'TEXT_MESSAGE_CHUNK':\n    case 'REASONING_MESSAGE_CHUNK': {\n      // Only the first chunk of a message must carry its id.\n      const id = e.messageId ?? thread.messages.at(-1)?.id;\n      const role = e.type === 'TEXT_MESSAGE_CHUNK' ? (e.role ?? 'assistant') : 'reasoning';\n      const next = known(id) ? thread : message(role);\n      return { ...next, messages: updateMessage(next, id, m => appendText(m, e.delta)) };\n    }\n    case 'TOOL_CALL_START':\n    case 'TOOL_CALL_CHUNK': {\n      const id = e.toolCallId ?? lastToolCallId(thread);\n      let next = thread;\n      if (\n        e.type === 'TOOL_CALL_START' ||\n        !thread.messages.some(m => m.toolCalls?.some(c => c.id === id))\n      ) {\n        const call: AgUiToolCall = {\n          id,\n          type: 'function',\n          function: { name: e.toolCallName, arguments: '' }\n        };\n        const parent = e.parentMessageId ?? id;\n        next = known(parent)\n          ? thread\n          : { ...thread, messages: [...thread.messages, { id: parent, role: 'assistant' }] };\n        next = {\n          ...next,\n          messages: updateMessage(next, parent, m => ({\n            ...m,\n            toolCalls: [...(m.toolCalls ?? []), call]\n          }))\n        };\n      }\n      if (e.type === 'TOOL_CALL_START') return next;\n      return toolArgs(next, id, e.delta);\n    }\n    case 'TOOL_CALL_ARGS':\n      return toolArgs(thread, e.toolCallId, e.delta);\n    case 'TOOL_CALL_RESULT':\n      return message(e.role ?? 'tool', { toolCallId: e.toolCallId, content: e.content });\n    case 'STATE_SNAPSHOT':\n      return { ...thread, state: e.snapshot, stale: false };\n    case 'STATE_DELTA':\n      if (thread.stale) return thread;\n      try {\n        return { ...thread, state: applyPatch(thread.state, e.delta) };\n      } catch {\n        return { ...thread, stale: true };\n      }\n    case 'MESSAGES_SNAPSHOT':\n      return { ...thread, messages: e.messages };\n    case 'ACTIVITY_SNAPSHOT': {\n      if (known(e.messageId) && e.replace === false) return thread;\n      const next = known(e.messageId) ? thread : message('activity');\n      return {\n        ...next,\n        messages: updateMessage(next, e.messageId, m => ({\n          ...m,\n          activityType: e.activityType,\n          content: e.content\n        }))\n      };\n    }\n    case 'ACTIVITY_DELTA':\n      try {\n        return {\n          ...thread,\n          messages: updateMessage(thread, e.messageId, m => ({\n            ...m,\n            content: applyPatch(m.content, e.patch)\n          }))\n        };\n      } catch {\n        return thread;\n      }\n    default:\n      return thread;\n  }\n}\n\nfunction toolArgs<S>(thread: AgUiThread<S>, id: string | undefined, delta: string | undefined) {\n  return {\n    ...thread,\n    messages: updateToolCall(thread, id, call => ({\n      ...call,\n      function: { ...call.function, arguments: call.function.arguments + (delta ?? '') }\n    }))\n  };\n}\n\n/** What the server sends for each event of a run: its run, its offset (from 1), and the event. */\nexport interface AgUiEnvelope {\n  readonly runId: string;\n  readonly offset: number;\n  readonly event: AgUiEvent;\n}\n\n/** Options for {@link createAgUiAgent}. The message formats have defaults; see the guide. */\nexport interface AgUiAgentOptions<S, In, Out> {\n  /** The thread's id, sent in every `RunAgentInput`. A new random one by default. */\n  threadId?: string;\n  /** The shared state before the first `STATE_SNAPSHOT`, sent with the first run. */\n  state?: S;\n  /** Names where streaming runs are remembered across reloads. @default 'ag-ui' */\n  name?: string;\n  /** @default `{ type: 'run', runId, input }` */\n  run?: (input: RunAgentInput, runId: string) => Out;\n  /** @default `{ type: 'resume', runId, after }` */\n  resume?: (runId: string, after: number | undefined) => Out;\n  /** @default `{ type: 'cancel', runId }` */\n  cancel?: (runId: string) => Out;\n  /**\n   * The message that asks the server for a `STATE_SNAPSHOT`, sent when a `STATE_DELTA` can't\n   * be applied. Without it, the state stays `stale` until the server sends one by itself.\n   */\n  resync?: (runId: string) => Out;\n  /** Recognize a run's event. @default messages shaped like {@link AgUiEnvelope} */\n  event?: (message: In) => AgUiEnvelope | null | undefined;\n  /** What happens to a run when its connection drops. @default 'keep' */\n  policy?: RunPolicy;\n  /** Where streaming runs are remembered. @default sessionStorage */\n  storage?: RunStorage | null;\n}\n\n/** An AG-UI agent over a WebSocket. Create with {@link createAgUiAgent}. */\nexport interface AgUiAgent<S> {\n  /** The client the runs stream on. */\n  readonly client: WebSocketClient<any, any>;\n  /** The runs underneath, from `createWebSocketRuns`. */\n  readonly runs: WebSocketRuns<RunAgentInput, AgUiThread<S>>;\n  /**\n   * Start a run with the thread so far plus `input.messages`, which show up in the thread right\n   * away. A run that's still streaming is aborted first. Returns the run's id.\n   */\n  run(\n    input?: {\n      messages?: readonly AgUiMessage[];\n      tools?: readonly unknown[];\n      context?: readonly unknown[];\n      forwardedProps?: unknown;\n    },\n    options?: { policy?: RunPolicy }\n  ): string;\n  /** Stop the run that's streaming, if any. */\n  abort(): void;\n  /** The thread as of the latest run. The same object until it changes. */\n  getSnapshot(): AgUiThread<S>;\n  /** Get notified when the thread changes. Compatible with `useSyncExternalStore`. */\n  subscribe(listener: () => void): () => void;\n  /** Stop following runs, and release the connection. */\n  dispose(): void;\n}\n\nfunction randomId() {\n  return (\n    globalThis.crypto?.randomUUID?.() ??\n    `${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`\n  );\n}\n\nconst isEnvelope = (message: any): AgUiEnvelope | undefined =>\n  typeof message?.runId === 'string' &&\n  typeof message.offset === 'number' &&\n  typeof message.event?.type === 'string'\n    ? message\n    : undefined;\n\nconst ENDS = new Set(['RUN_FINISHED', 'RUN_ERROR']);\n\n/**\n * Run an [AG-UI](https://docs.ag-ui.com) agent over a WebSocket. Each run streams AG-UI events,\n * which are folded into the thread's messages and shared state with {@link applyAgUiEvent}.\n * Runs come from `createWebSocketRuns`, so they resume after a reconnect or a reload, and a\n * state delta that can't be applied asks for a snapshot (`resync`).\n *\n * AG-UI doesn't define messages for WebSockets, so the defaults are small: the client sends\n * `{ type: 'run', runId, input }`, `{ type: 'resume', runId, after }` and\n * `{ type: 'cancel', runId }`, and the server sends `{ runId, offset, event }`, with `offset`\n * counting each run's events from 1. Each option replaces one of them.\n *\n * @example\n * ```ts\n * import { createAgUiAgent } from 'react-websocket/ag-ui';\n *\n * export const agent = createAgUiAgent(createWebSocket(url, { json: true }));\n *\n * agent.run({ messages: [{ id: crypto.randomUUID(), role: 'user', content: 'Plan my week' }] });\n * ```\n */\nexport function createAgUiAgent<S = unknown, In = any, Out = any>(\n  client: WebSocketClient<In, Out>,\n  options: AgUiAgentOptions<S, NoInfer<In>, NoInfer<Out>> = {}\n): AgUiAgent<S> {\n  const threadId = options.threadId ?? randomId();\n  const empty: AgUiThread<S> = {\n    messages: [],\n    state: options.state as S,\n    status: 'idle',\n    stale: false\n  };\n  let base = empty;\n  let snapshot = empty;\n  const listeners = new Set<() => void>();\n  // Runs that asked for a snapshot after a failed delta, until one arrives.\n  const resynced = new Set<string>();\n  const event = options.event ?? isEnvelope;\n  // Now or never: not queued, and not `volatile`, which can be a datagram that never arrives.\n  const send = (message: unknown) => client.socket?.readyState === 1 && client.send(message as Out);\n\n  const runs = createWebSocketRuns<RunAgentInput, AgUiThread<S>, In, Out>(client, {\n    name: options.name ?? 'ag-ui',\n    start: options.run ?? ((input, runId) => ({ type: 'run', runId, input }) as Out),\n    resume: options.resume ?? ((runId, after) => ({ type: 'resume', runId, after }) as Out),\n    cancel: options.cancel ?? (runId => ({ type: 'cancel', runId }) as Out),\n    event: message => event(message),\n    done: message => ENDS.has(event(message)!.event.type),\n    initial: empty,\n    reduce: (thread, message) => applyAgUiEvent(thread, event(message)!.event),\n    policy: options.policy,\n    storage: options.storage\n  });\n\n  function update() {\n    const latest = runs.list().at(-1);\n    let next = latest ? latest.value : base;\n    if (latest?.status === 'aborted' && next.status === 'running')\n      next = { ...next, status: 'aborted' };\n    // Once each time the state goes stale, or on a later event if the socket wasn't open.\n    if (latest && !latest.value.stale) resynced.delete(latest.runId);\n    else if (latest && options.resync && !resynced.has(latest.runId)) {\n      if (send(options.resync(latest.runId))) resynced.add(latest.runId);\n    }\n    if (next === snapshot) return;\n    snapshot = next;\n    for (const listener of [...listeners]) listener();\n  }\n  const off = runs.subscribe(update);\n  update();\n\n  function abort() {\n    for (const run of runs.list()) runs.abort(run.runId);\n  }\n\n  return {\n    client,\n    runs,\n    run(input = {}, runOptions) {\n      abort();\n      const runId = randomId();\n      // The run starts from the state sent with it, the last good one: its deltas apply to it.\n      base = {\n        ...snapshot,\n        stale: false,\n        messages: [...snapshot.messages, ...(input.messages ?? [])]\n      };\n      runs.start(\n        {\n          threadId,\n          runId,\n          state: base.state,\n          messages: base.messages,\n          tools: input.tools ?? [],\n          context: input.context ?? [],\n          forwardedProps: input.forwardedProps ?? {}\n        },\n        { runId, initial: { ...base, status: 'running' }, policy: runOptions?.policy }\n      );\n      return runId;\n    },\n    abort,\n    getSnapshot: () => snapshot,\n    subscribe(listener) {\n      listeners.add(listener);\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n    dispose() {\n      off();\n      runs.dispose();\n    }\n  };\n}\n"],"mappings":"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"}