@copilotkitnext/core 1.54.0 → 1.54.1-next.1

package/dist/index.mjs

@@ -1,33 +1,511 @@
-import { AbstractAgent, EventType, HttpAgent, runHttpRequest, transformHttpEventStream } from "@ag-ui/client";
-import { AG_UI_CHANNEL_EVENT, logger, partialJSONParse, phoenixExponentialBackoff, randomUUID, schemaToJsonSchema } from "@copilotkitnext/shared";
-import { EMPTY, Observable } from "rxjs";
-import { catchError } from "rxjs/operators";
-import { zodToJsonSchema } from "zod-to-json-schema";
+import { AbstractAgent, EventType, HttpAgent, randomUUID, runHttpRequest, structuredClone_, transformChunks, transformHttpEventStream } from "@ag-ui/client";
+import { RUNTIME_MODE_INTELLIGENCE, RUNTIME_MODE_SSE, logger, partialJSONParse, phoenixExponentialBackoff, randomUUID as randomUUID$1, schemaToJsonSchema } from "@copilotkitnext/shared";
+import { BehaviorSubject, EMPTY, NEVER, Notification, Observable, Subject, Subscription, asapScheduler, concat, defer, dematerialize, firstValueFrom, from, lastValueFrom, merge, of, switchMap, throwError } from "rxjs";
+import { catchError, distinctUntilChanged, endWith, filter, finalize, ignoreElements, map, mergeMap, observeOn, scan, share, shareReplay, switchMap as switchMap$1, take, takeUntil, tap, timeout, withLatestFrom } from "rxjs/operators";
 import { Socket } from "phoenix";
+import { zodToJsonSchema } from "zod-to-json-schema";
+import { fromFetch } from "rxjs/fetch";
 
-//#region src/agent.ts
+//#region src/utils/phoenix-observable.ts
 /**
-* Check if an error is a ZodError (validation error).
-* These can occur when the SSE stream is aborted/truncated mid-event.
+* Adapt Phoenix socket open/error callbacks into an observable signal stream.
+*
+* The returned observable is shared and replayable by the caller when needed,
+* but this helper itself does not own socket connection teardown.
 */
-function isZodError(error) {
-	return error !== null && typeof error === "object" && "name" in error && error.name === "ZodError";
+function ɵcreatePhoenixSocketSignals$(socket) {
+	return new Observable((observer) => {
+		socket.onOpen(() => observer.next({ type: "open" }));
+		socket.onError((error) => observer.next({
+			type: "error",
+			error
+		}));
+	});
+}
+/**
+* Adapt a Phoenix channel join attempt into a single-outcome observable.
+*/
+function ɵcreatePhoenixJoinOutcome$(channel) {
+	return new Observable((observer) => {
+		channel.join().receive("ok", () => {
+			observer.next({ type: "joined" });
+			observer.complete();
+		}).receive("error", (response) => {
+			observer.next({
+				type: "error",
+				response
+			});
+			observer.complete();
+		}).receive("timeout", () => {
+			observer.next({ type: "timeout" });
+			observer.complete();
+		});
+	});
+}
+/**
+* Create a cold Phoenix socket session.
+*
+* The socket is constructed and connected on subscription, and disconnected on
+* teardown. Each subscription creates an isolated socket instance.
+*/
+function ɵphoenixSocket$(options) {
+	return defer(() => {
+		const socket = new Socket(options.url, options.options);
+		const signals$ = ɵcreatePhoenixSocketSignals$(socket).pipe(shareReplay({
+			bufferSize: 1,
+			refCount: true
+		}));
+		socket.connect();
+		return concat(of({
+			socket,
+			signals$
+		}), NEVER).pipe(finalize(() => socket.disconnect()));
+	});
+}
+/**
+* Create a cold Phoenix channel session from a socket session stream.
+*
+* A channel is created and joined for each active socket session. If the
+* upstream socket session changes, the previous channel is left before the
+* next one becomes active.
+*/
+function ɵphoenixChannel$(options) {
+	return options.socket$.pipe(switchMap$1(({ socket }) => defer(() => {
+		const channel = socket.channel(options.topic, options.params);
+		return concat(of({
+			channel,
+			joinOutcome$: ɵcreatePhoenixJoinOutcome$(channel).pipe(shareReplay({
+				bufferSize: 1,
+				refCount: true
+			}))
+		}), NEVER).pipe(finalize(() => {
+			if (options.leaveOnUnsubscribe !== false) channel.leave();
+		}));
+	})));
 }
 /**
-* Wrap an Observable to catch and suppress ZodErrors that occur during stream abort.
-* These errors are expected when the connection is cancelled mid-stream.
+* Observe a named Phoenix channel event as an observable payload stream.
 */
+function ɵobservePhoenixEvent$(channel, eventName) {
+	return new Observable((observer) => {
+		const ref = channel.on(eventName, (payload) => observer.next(payload));
+		return () => {
+			channel.off(eventName, ref);
+		};
+	});
+}
+/**
+* Flatten channel sessions into their join-outcome stream.
+*/
+function ɵobservePhoenixJoinOutcome$(channel$) {
+	return channel$.pipe(switchMap$1((session) => session.joinOutcome$));
+}
+/**
+* Complete when a channel joins successfully, or error if the join fails.
+*/
+function ɵjoinPhoenixChannel$(channel$) {
+	return ɵobservePhoenixJoinOutcome$(channel$).pipe(take(1), mergeMap((outcome) => {
+		if (outcome.type === "joined") return EMPTY;
+		throw outcome.type === "timeout" ? /* @__PURE__ */ new Error("Timed out joining channel") : /* @__PURE__ */ new Error(`Failed to join channel: ${JSON.stringify(outcome.response)}`);
+	}));
+}
+/**
+* Flatten socket sessions into their lifecycle signal stream.
+*/
+function ɵobservePhoenixSocketSignals$(socket$) {
+	return socket$.pipe(switchMap$1((session) => session.signals$));
+}
+/**
+* Error after a socket emits the configured number of consecutive error
+* signals, resetting the counter after each successful open signal.
+*/
+function ɵobservePhoenixSocketHealth$(socketSignals$, maxConsecutiveErrors) {
+	return socketSignals$.pipe(scan((consecutiveErrors, signal) => signal.type === "open" ? 0 : consecutiveErrors + 1, 0), filter((consecutiveErrors) => consecutiveErrors >= maxConsecutiveErrors), take(1), mergeMap((consecutiveErrors) => throwError(() => /* @__PURE__ */ new Error(`WebSocket connection failed after ${consecutiveErrors} consecutive errors`))));
+}
+
+//#endregion
+//#region src/intelligence-agent.ts
+const CLIENT_AG_UI_EVENT = "ag_ui_event";
+const STOP_RUN_EVENT = "stop_run";
+var IntelligenceAgent = class IntelligenceAgent extends AbstractAgent {
+	config;
+	socket = null;
+	activeChannel = null;
+	runId = null;
+	sharedState;
+	constructor(config, sharedState = { lastSeenEventIds: /* @__PURE__ */ new Map() }) {
+		super();
+		this.config = config;
+		this.sharedState = sharedState;
+	}
+	clone() {
+		return new IntelligenceAgent(this.config, this.sharedState);
+	}
+	/**
+	* Override of AbstractAgent.connectAgent that removes the `verifyEvents` step.
+	*
+	* Background: AbstractAgent's connectAgent pipeline runs events through
+	* `verifyEvents`, which validates that the stream follows the AG-UI protocol
+	* lifecycle — specifically, it expects a RUN_STARTED event before any content
+	* events and a RUN_FINISHED/RUN_ERROR event to complete the stream.
+	*
+	* IntelligenceAgent uses long-lived WebSocket connections rather than
+	* request-scoped SSE streams. When connecting to replay historical messages
+	* for an existing thread, the connection semantics don't map to a single
+	* agent run start/stop cycle. The replayed events may not include
+	* RUN_STARTED/RUN_FINISHED bookends (or may contain events from multiple
+	* past runs), which causes verifyEvents to either never complete or to
+	* error out.
+	*
+	* This override replicates the base connectAgent implementation exactly,
+	* substituting only `transformChunks` (which is still needed for message
+	* reassembly) and omitting `verifyEvents`.
+	*
+	* TODO: Remove this override once AG-UI's AbstractAgent supports opting out
+	* of verifyEvents for transports with different connection life-cycles.
+	*/
+	async connectAgent(parameters, subscriber) {
+		const self = this;
+		try {
+			this.isRunning = true;
+			this.agentId = this.agentId ?? randomUUID();
+			const input = this.prepareRunAgentInput(parameters);
+			let result;
+			const previousMessageIds = new Set(this.messages.map((m) => m.id));
+			const subscribers = [
+				{ onRunFinishedEvent: (event) => {
+					result = event.result;
+				} },
+				...this.subscribers,
+				subscriber ?? {}
+			];
+			await this.onInitialize(input, subscribers);
+			self.activeRunDetach$ = new Subject();
+			let resolveCompletion;
+			self.activeRunCompletionPromise = new Promise((resolve) => {
+				resolveCompletion = resolve;
+			});
+			const source$ = defer(() => this.connect(input)).pipe(transformChunks(this.debug), takeUntil(self.activeRunDetach$));
+			const applied$ = this.apply(input, source$, subscribers);
+			await lastValueFrom(this.processApplyEvents(input, applied$, subscribers).pipe(catchError((error) => {
+				this.isRunning = false;
+				return this.onError(input, error, subscribers);
+			}), finalize(() => {
+				this.isRunning = false;
+				this.onFinalize(input, subscribers);
+				resolveCompletion?.();
+				resolveCompletion = void 0;
+				self.activeRunCompletionPromise = void 0;
+				self.activeRunDetach$ = void 0;
+			})), { defaultValue: void 0 });
+			const newMessages = structuredClone_(this.messages).filter((m) => !previousMessageIds.has(m.id));
+			return {
+				result,
+				newMessages
+			};
+		} finally {
+			this.isRunning = false;
+		}
+	}
+	abortRun() {
+		if (this.activeChannel && this.runId) {
+			const fallback = setTimeout(() => clear(), 5e3);
+			const clear = () => {
+				clearTimeout(fallback);
+				this.detachActiveRun();
+				this.cleanup();
+			};
+			this.activeChannel.push(STOP_RUN_EVENT, { run_id: this.runId }).receive("ok", clear).receive("error", clear).receive("timeout", clear);
+		} else {
+			this.detachActiveRun();
+			this.cleanup();
+		}
+	}
+	/**
+	* Trigger the run via REST, then join the realtime thread channel and relay
+	* server-pushed AG-UI events to the Observable subscriber.
+	*/
+	run(input) {
+		this.threadId = input.threadId;
+		this.runId = input.runId;
+		return defer(() => this.requestJoinCredentials$("run", input)).pipe(switchMap((credentials) => this.observeThread$(input, credentials, {
+			completeOnRunError: false,
+			streamMode: "run"
+		})));
+	}
+	/**
+	* Reconnect to an existing thread by fetching websocket credentials and
+	* joining the realtime thread channel.
+	*/
+	connect(input) {
+		this.threadId = input.threadId;
+		this.runId = input.runId;
+		return defer(() => this.requestConnectPlan$(input)).pipe(switchMap((plan) => {
+			if (plan === null) return EMPTY;
+			if (plan.mode === "bootstrap") {
+				this.setLastSeenEventId(input.threadId, plan.latestEventId);
+				for (const event of plan.events) this.updateRunIdFromEvent(event);
+				return from(plan.events);
+			}
+			this.setLastSeenEventId(input.threadId, plan.joinFromEventId);
+			for (const event of plan.events) this.updateRunIdFromEvent(event);
+			return concat(from(plan.events), this.observeThread$(input, { joinToken: plan.joinToken }, {
+				completeOnRunError: true,
+				streamMode: "connect",
+				replayCursor: plan.joinFromEventId
+			}));
+		}));
+	}
+	/**
+	* Tear down a specific channel + socket pair that belongs to one pipeline.
+	* Only nulls instance references when they still point to the owned resource,
+	* so a concurrent pipeline's resources are never clobbered.
+	*/
+	cleanupOwned(ownChannel, ownSocket) {
+		if (ownChannel) {
+			ownChannel.leave();
+			if (this.activeChannel === ownChannel) this.activeChannel = null;
+		}
+		if (ownSocket) {
+			ownSocket.disconnect();
+			if (this.socket === ownSocket) this.socket = null;
+		}
+		if (this.threadId) this.sharedState.lastSeenEventIds.delete(this.threadId);
+		this.runId = null;
+	}
+	cleanup() {
+		this.cleanupOwned(this.activeChannel, this.socket);
+	}
+	requestJoinCredentials$(mode, input) {
+		return defer(async () => {
+			try {
+				const response = await fetch(this.buildRuntimeUrl(mode), {
+					method: "POST",
+					headers: {
+						"Content-Type": "application/json",
+						...this.config.headers
+					},
+					body: JSON.stringify({
+						threadId: input.threadId,
+						runId: input.runId,
+						messages: input.messages,
+						tools: input.tools,
+						context: input.context,
+						state: input.state,
+						forwardedProps: input.forwardedProps
+					}),
+					...this.config.credentials ? { credentials: this.config.credentials } : {}
+				});
+				if (!response.ok) {
+					const text = await response.text().catch(() => "");
+					throw new Error(text || response.statusText || String(response.status));
+				}
+				const payload = await response.json();
+				if (!payload.joinToken) throw new Error("missing joinToken");
+				return { joinToken: payload.joinToken };
+			} catch (error) {
+				throw new Error(`REST ${mode} request failed: ${error instanceof Error ? error.message : String(error)}`);
+			}
+		});
+	}
+	requestConnectPlan$(input) {
+		return defer(async () => {
+			try {
+				const response = await fetch(this.buildRuntimeUrl("connect"), {
+					method: "POST",
+					headers: {
+						"Content-Type": "application/json",
+						...this.config.headers
+					},
+					body: JSON.stringify({
+						threadId: input.threadId,
+						runId: input.runId,
+						messages: input.messages,
+						tools: input.tools,
+						context: input.context,
+						state: input.state,
+						forwardedProps: input.forwardedProps,
+						lastSeenEventId: this.getReconnectCursor(input)
+					}),
+					...this.config.credentials ? { credentials: this.config.credentials } : {}
+				});
+				if (response.status === 204) return null;
+				if (!response.ok) {
+					const text = await response.text().catch(() => "");
+					throw new Error(text || response.statusText || String(response.status));
+				}
+				return this.normalizeConnectPlan(await response.json());
+			} catch (error) {
+				throw new Error(`REST connect request failed: ${error instanceof Error ? error.message : String(error)}`);
+			}
+		});
+	}
+	normalizeConnectPlan(payload) {
+		const envelope = payload && typeof payload === "object" ? payload : null;
+		if (envelope?.mode === "bootstrap") return {
+			mode: "bootstrap",
+			latestEventId: typeof envelope.latestEventId === "string" ? envelope.latestEventId : null,
+			events: Array.isArray(envelope.events) ? envelope.events : []
+		};
+		if (envelope?.mode === "live") {
+			if (typeof envelope.joinToken !== "string" || envelope.joinToken.length === 0) throw new Error("missing joinToken");
+			return {
+				mode: "live",
+				joinToken: envelope.joinToken,
+				joinFromEventId: typeof envelope.joinFromEventId === "string" ? envelope.joinFromEventId : null,
+				events: Array.isArray(envelope.events) ? envelope.events : []
+			};
+		}
+		throw new Error("invalid connect plan");
+	}
+	observeThread$(input, credentials, options) {
+		return defer(() => {
+			let ownSocket = null;
+			let ownChannel = null;
+			const socket$ = ɵphoenixSocket$({
+				url: this.config.url,
+				options: {
+					params: {
+						...this.config.socketParams ?? {},
+						join_token: credentials.joinToken
+					},
+					reconnectAfterMs: phoenixExponentialBackoff(100, 1e4),
+					rejoinAfterMs: phoenixExponentialBackoff(1e3, 3e4)
+				}
+			}).pipe(tap(({ socket }) => {
+				ownSocket = socket;
+				this.socket = ownSocket;
+			}), shareReplay({
+				bufferSize: 1,
+				refCount: true
+			}));
+			const { topic, params } = this.createThreadChannelDescriptor(input, options.streamMode, options.replayCursor);
+			const channel$ = ɵphoenixChannel$({
+				socket$,
+				topic,
+				params
+			}).pipe(tap(({ channel }) => {
+				ownChannel = channel;
+				this.activeChannel = ownChannel;
+			}), shareReplay({
+				bufferSize: 1,
+				refCount: true
+			}));
+			const threadEvents$ = this.observeThreadEvents$(input.threadId, channel$, options).pipe(share());
+			const threadCompleted$ = threadEvents$.pipe(ignoreElements(), endWith(null), take(1));
+			return merge(this.joinThreadChannel$(channel$), this.observeSocketHealth$(socket$).pipe(takeUntil(threadCompleted$)), threadEvents$).pipe(finalize(() => this.cleanupOwned(ownChannel, ownSocket)));
+		});
+	}
+	joinThreadChannel$(channel$) {
+		return ɵjoinPhoenixChannel$(channel$);
+	}
+	observeSocketHealth$(socket$) {
+		return ɵobservePhoenixSocketHealth$(ɵobservePhoenixSocketSignals$(socket$), 5);
+	}
+	observeThreadEvents$(threadId, channel$, options) {
+		return channel$.pipe(switchMap$1(({ channel }) => this.observeChannelEvent$(channel, CLIENT_AG_UI_EVENT)), tap((payload) => {
+			this.updateLastSeenEventId(threadId, payload);
+			this.updateRunIdFromEvent(payload);
+		}), mergeMap((payload) => from(this.createThreadNotifications(payload, options.completeOnRunError))), dematerialize());
+	}
+	observeChannelEvent$(channel, eventName) {
+		return ɵobservePhoenixEvent$(channel, eventName);
+	}
+	createThreadNotifications(payload, completeOnRunError) {
+		if (payload.type === EventType.RUN_FINISHED) return [Notification.createNext(payload), Notification.createComplete()];
+		if (payload.type === EventType.RUN_ERROR) {
+			const errorMessage = payload.message ?? "Run error";
+			return completeOnRunError ? [Notification.createNext(payload), Notification.createComplete()] : [Notification.createNext(payload), Notification.createError(new Error(errorMessage))];
+		}
+		return [Notification.createNext(payload)];
+	}
+	buildRuntimeUrl(mode) {
+		const path = `${this.config.runtimeUrl}/agent/${encodeURIComponent(this.config.agentId)}/${mode}`;
+		const origin = typeof window !== "undefined" && window.location ? window.location.origin : "http://localhost";
+		return new URL(path, new URL(this.config.runtimeUrl, origin)).toString();
+	}
+	createThreadChannelDescriptor(input, streamMode, replayCursor) {
+		const params = streamMode === "run" ? {
+			stream_mode: "run",
+			run_id: input.runId
+		} : {
+			stream_mode: "connect",
+			last_seen_event_id: replayCursor === void 0 ? this.getReconnectCursor(input) : replayCursor
+		};
+		return {
+			topic: `thread:${input.threadId}`,
+			params
+		};
+	}
+	getLastSeenEventId(threadId) {
+		return this.sharedState.lastSeenEventIds.get(threadId) ?? null;
+	}
+	getReconnectCursor(input) {
+		return this.hasLocalThreadMessages(input) ? this.getLastSeenEventId(input.threadId) : null;
+	}
+	hasLocalThreadMessages(input) {
+		return Array.isArray(input.messages) && input.messages.length > 0;
+	}
+	updateLastSeenEventId(threadId, payload) {
+		const eventId = this.readEventId(payload);
+		if (!eventId) return;
+		this.sharedState.lastSeenEventIds.set(threadId, eventId);
+	}
+	setLastSeenEventId(threadId, eventId) {
+		if (!eventId) return;
+		this.sharedState.lastSeenEventIds.set(threadId, eventId);
+	}
+	/**
+	* Keep `this.runId` in sync with the backend's actual run ID.
+	*
+	* During a `connect` (resume) flow the client generates a fresh `runId`
+	* via `prepareRunAgentInput`, but the backend is running under its own
+	* run ID.  If the client later sends `STOP_RUN_EVENT` with the wrong
+	* `runId`, the gateway's runner channel will not match it and the agent
+	* keeps running.  Extracting the run ID from live events fixes this.
+	*
+	* The runner normalises events to `run_id` (snake_case) before pushing
+	* to the gateway, so we check both `runId` and `run_id`.
+	*/
+	updateRunIdFromEvent(payload) {
+		const record = payload;
+		const eventRunId = record.runId ?? record.run_id;
+		if (typeof eventRunId === "string" && eventRunId.length > 0) this.runId = eventRunId;
+	}
+	readEventId(payload) {
+		const metadata = payload.metadata;
+		if (!metadata || typeof metadata !== "object") return null;
+		const runnerEventId = metadata.cpki_event_id;
+		return typeof runnerEventId === "string" ? runnerEventId : null;
+	}
+};
+
+//#endregion
+//#region src/agent.ts
+function hasHeaders(agent) {
+	return "headers" in agent;
+}
+function hasCredentials(agent) {
+	return "credentials" in agent;
+}
+function isZodError(error) {
+	return error !== null && typeof error === "object" && "name" in error && error.name === "ZodError";
+}
 function withAbortErrorHandling(observable) {
 	return observable.pipe(catchError((error) => {
 		if (isZodError(error)) return EMPTY;
 		throw error;
 	}));
 }
-var ProxiedCopilotRuntimeAgent = class extends HttpAgent {
+var ProxiedCopilotRuntimeAgent = class ProxiedCopilotRuntimeAgent extends HttpAgent {
 	runtimeUrl;
 	credentials;
 	transport;
 	singleEndpointUrl;
+	runtimeMode;
+	intelligence;
+	delegate;
+	runtimeInfoPromise;
 	constructor(config) {
 		const normalizedRuntimeUrl = config.runtimeUrl ? config.runtimeUrl.replace(/\/$/, "") : void 0;
 		const transport = config.transport ?? "rest";
@@ -40,9 +518,21 @@ var ProxiedCopilotRuntimeAgent = class extends HttpAgent {
 		this.runtimeUrl = normalizedRuntimeUrl ?? config.runtimeUrl;
 		this.credentials = config.credentials;
 		this.transport = transport;
+		this.runtimeMode = config.runtimeMode ?? RUNTIME_MODE_SSE;
+		this.intelligence = config.intelligence;
 		if (this.transport === "single") this.singleEndpointUrl = this.runtimeUrl;
 	}
+	async detachActiveRun() {
+		if (this.delegate) await this.delegate.detachActiveRun();
+		await super.detachActiveRun();
+	}
 	abortRun() {
+		if (this.delegate) {
+			this.syncDelegate(this.delegate);
+			this.delegate.abortRun();
+			this.detachActiveRun();
+			return;
+		}
 		if (!this.agentId || !this.threadId) return;
 		if (typeof fetch === "undefined") return;
 		if (this.transport === "single") {
@@ -83,7 +573,52 @@ var ProxiedCopilotRuntimeAgent = class extends HttpAgent {
 			console.error("ProxiedCopilotRuntimeAgent: stop request failed", error);
 		});
 	}
+	async connectAgent(parameters, subscriber) {
+		if (this.runtimeMode !== RUNTIME_MODE_INTELLIGENCE) return super.connectAgent(parameters, subscriber);
+		if (this.delegate) await this.delegate.detachActiveRun();
+		await this.resolveDelegate();
+		const delegate = this.delegate;
+		const bridgeSub = delegate.subscribe({
+			onMessagesChanged: () => {
+				this.setMessages([...delegate.messages]);
+			},
+			onStateChanged: () => {
+				this.setState({ ...delegate.state });
+			},
+			onRunInitialized: () => {
+				this.isRunning = true;
+			},
+			onRunFinalized: () => {
+				this.isRunning = false;
+			},
+			onRunFailed: () => {
+				this.isRunning = false;
+			}
+		});
+		const forwardedSubs = this.subscribers.map((s) => delegate.subscribe(s));
+		try {
+			const result = await delegate.connectAgent(parameters, subscriber);
+			this.setMessages([...delegate.messages]);
+			this.setState({ ...delegate.state });
+			return result;
+		} finally {
+			this.isRunning = false;
+			bridgeSub.unsubscribe();
+			for (const sub of forwardedSubs) sub.unsubscribe();
+		}
+	}
 	connect(input) {
+		if (this.runtimeMode === RUNTIME_MODE_INTELLIGENCE) return this.#connectViaDelegate(input);
+		return this.#connectViaHttp(input);
+	}
+	run(input) {
+		if (this.runtimeMode === RUNTIME_MODE_INTELLIGENCE) return this.#runViaDelegate(input);
+		return this.#runViaHttp(input);
+	}
+	#connectViaDelegate(input) {
+		return defer(() => from(this.resolveDelegate())).pipe(switchMap$1((delegate) => withAbortErrorHandling(delegate.connect(input))));
+	}
+	#connectViaHttp(input) {
 		if (this.transport === "single") {
 			if (!this.singleEndpointUrl) throw new Error("Single endpoint transport requires a runtimeUrl");
 			const requestInit = this.createSingleRouteRequestInit(input, "agent/connect", { agentId: this.agentId });
@@ -91,7 +626,10 @@ var ProxiedCopilotRuntimeAgent = class extends HttpAgent {
 		}
 		return withAbortErrorHandling(transformHttpEventStream(runHttpRequest(`${this.runtimeUrl}/agent/${this.agentId}/connect`, this.requestInit(input))));
 	}
-	run(input) {
+	#runViaDelegate(input) {
+		return defer(() => from(this.resolveDelegate())).pipe(switchMap$1((delegate) => withAbortErrorHandling(delegate.run(input))));
+	}
+	#runViaHttp(input) {
 		if (this.transport === "single") {
 			if (!this.singleEndpointUrl) throw new Error("Single endpoint transport requires a runtimeUrl");
 			const requestInit = this.createSingleRouteRequestInit(input, "agent/run", { agentId: this.agentId });
@@ -100,13 +638,67 @@ var ProxiedCopilotRuntimeAgent = class extends HttpAgent {
 		return withAbortErrorHandling(super.run(input));
 	}
 	clone() {
-		const cloned = super.clone();
-		cloned.runtimeUrl = this.runtimeUrl;
-		cloned.credentials = this.credentials;
-		cloned.transport = this.transport;
-		cloned.singleEndpointUrl = this.singleEndpointUrl;
+		const cloned = new ProxiedCopilotRuntimeAgent({
+			runtimeUrl: this.runtimeUrl,
+			agentId: this.agentId,
+			description: this.description,
+			headers: { ...this.headers },
+			credentials: this.credentials,
+			transport: this.transport,
+			runtimeMode: this.runtimeMode,
+			intelligence: this.intelligence
+		});
+		cloned.threadId = this.threadId;
+		cloned.setState(this.state);
+		cloned.setMessages(this.messages);
+		if (this.delegate) {
+			cloned.delegate = this.delegate.clone();
+			cloned.syncDelegate(cloned.delegate);
+		}
 		return cloned;
 	}
+	async resolveDelegate() {
+		await this.ensureRuntimeMode();
+		if (!this.delegate) {
+			if (this.runtimeMode !== RUNTIME_MODE_INTELLIGENCE) throw new Error("A delegate is only created for Intelligence mode");
+			this.delegate = this.createIntelligenceDelegate();
+		}
+		this.syncDelegate(this.delegate);
+		return this.delegate;
+	}
+	async ensureRuntimeMode() {
+		if (this.runtimeMode !== "pending") return;
+		if (!this.runtimeUrl) throw new Error("Runtime URL is not set");
+		this.runtimeInfoPromise ??= this.fetchRuntimeInfo().then((runtimeInfo) => {
+			this.runtimeMode = runtimeInfo.mode ?? RUNTIME_MODE_SSE;
+			this.intelligence = runtimeInfo.intelligence;
+		});
+		await this.runtimeInfoPromise;
+	}
+	async fetchRuntimeInfo() {
+		const headers = { ...this.headers };
+		let init;
+		let url;
+		if (this.transport === "single") {
+			if (!this.singleEndpointUrl) throw new Error("Single endpoint transport requires a runtimeUrl");
+			if (!headers["Content-Type"]) headers["Content-Type"] = "application/json";
+			url = this.runtimeUrl;
+			init = {
+				method: "POST",
+				body: JSON.stringify({ method: "info" })
+			};
+		} else {
+			url = `${this.runtimeUrl}/info`;
+			init = {};
+		}
+		const response = await fetch(url, {
+			...init,
+			headers,
+			...this.credentials ? { credentials: this.credentials } : {}
+		});
+		if (!response.ok) throw new Error(`Runtime info request failed with status ${response.status}`);
+		return await response.json();
+	}
 	createSingleRouteRequestInit(input, method, params) {
 		if (!this.agentId) throw new Error("ProxiedCopilotRuntimeAgent requires agentId to make runtime requests");
 		const baseInit = super.requestInit(input);
@@ -118,7 +710,6 @@ var ProxiedCopilotRuntimeAgent = class extends HttpAgent {
 			originalBody = JSON.parse(baseInit.body);
 		} catch (error) {
 			console.warn("ProxiedCopilotRuntimeAgent: failed to parse request body for single route transport", error);
-			originalBody = void 0;
 		}
 		const envelope = { method };
 		if (params && Object.keys(params).length > 0) envelope.params = params;
@@ -130,6 +721,25 @@ var ProxiedCopilotRuntimeAgent = class extends HttpAgent {
 			...this.credentials ? { credentials: this.credentials } : {}
 		};
 	}
+	createIntelligenceDelegate() {
+		if (!this.runtimeUrl || !this.agentId || !this.intelligence?.wsUrl) throw new Error("Intelligence mode requires runtimeUrl, agentId, and intelligence websocket metadata");
+		return new IntelligenceAgent({
+			url: this.intelligence.wsUrl,
+			runtimeUrl: this.runtimeUrl,
+			agentId: this.agentId,
+			headers: { ...this.headers },
+			credentials: this.credentials
+		});
+	}
+	syncDelegate(delegate) {
+		delegate.agentId = this.agentId;
+		delegate.description = this.description;
+		delegate.threadId = this.threadId;
+		delegate.setMessages(this.messages);
+		delegate.setState(this.state);
+		if (hasHeaders(delegate)) delegate.headers = { ...this.headers };
+		if (hasCredentials(delegate)) delegate.credentials = this.credentials;
+	}
 };
 
 //#endregion
@@ -147,6 +757,8 @@ var AgentRegistry = class {
 	_runtimeConnectionStatus = CopilotKitCoreRuntimeConnectionStatus.Disconnected;
 	_runtimeTransport = "rest";
 	_audioFileTranscriptionEnabled = false;
+	_runtimeMode = RUNTIME_MODE_SSE;
+	_intelligence;
 	_a2uiEnabled = false;
 	constructor(core) {
 		this.core = core;
@@ -172,6 +784,12 @@ var AgentRegistry = class {
 	get audioFileTranscriptionEnabled() {
 		return this._audioFileTranscriptionEnabled;
 	}
+	get runtimeMode() {
+		return this._runtimeMode;
+	}
+	get intelligence() {
+		return this._intelligence;
+	}
 	get a2uiEnabled() {
 		return this._a2uiEnabled;
 	}
@@ -281,6 +899,8 @@ var AgentRegistry = class {
 			this._runtimeConnectionStatus = CopilotKitCoreRuntimeConnectionStatus.Disconnected;
 			this._runtimeVersion = void 0;
 			this._audioFileTranscriptionEnabled = false;
+			this._runtimeMode = RUNTIME_MODE_SSE;
+			this._intelligence = void 0;
 			this._a2uiEnabled = false;
 			this.remoteAgents = {};
 			this._agents = this.localAgents;
@@ -300,7 +920,9 @@ var AgentRegistry = class {
 					agentId: id,
 					description,
 					transport: this._runtimeTransport,
-					credentials
+					credentials,
+					runtimeMode: runtimeInfoResponse.mode ?? RUNTIME_MODE_SSE,
+					intelligence: runtimeInfoResponse.intelligence
 				});
 				this.applyHeadersToAgent(agent);
 				return [id, agent];
@@ -312,6 +934,8 @@ var AgentRegistry = class {
 			this._runtimeConnectionStatus = CopilotKitCoreRuntimeConnectionStatus.Connected;
 			this._runtimeVersion = version;
 			this._audioFileTranscriptionEnabled = runtimeInfoResponse.audioFileTranscriptionEnabled ?? false;
+			this._runtimeMode = runtimeInfoResponse.mode ?? RUNTIME_MODE_SSE;
+			this._intelligence = runtimeInfoResponse.intelligence;
 			this._a2uiEnabled = runtimeInfoResponse.a2uiEnabled ?? false;
 			await this.notifyRuntimeStatusChanged(CopilotKitCoreRuntimeConnectionStatus.Connected);
 			await this.notifyAgentsChanged();
@@ -319,6 +943,8 @@ var AgentRegistry = class {
 			this._runtimeConnectionStatus = CopilotKitCoreRuntimeConnectionStatus.Error;
 			this._runtimeVersion = void 0;
 			this._audioFileTranscriptionEnabled = false;
+			this._runtimeMode = RUNTIME_MODE_SSE;
+			this._intelligence = void 0;
 			this._a2uiEnabled = false;
 			this.remoteAgents = {};
 			this._agents = this.localAgents;
@@ -415,7 +1041,7 @@ var ContextStore = class {
 	* @returns The ID of the created context entry
 	*/
 	addContext({ description, value }) {
-		const id = randomUUID();
+		const id = randomUUID$1();
 		this._context[id] = {
 			description,
 			value
@@ -458,14 +1084,14 @@ var SuggestionEngine = class {
 	* Initialize with suggestion configs
 	*/
 	initialize(suggestionsConfig) {
-		for (const config of suggestionsConfig) this._suggestionsConfig[randomUUID()] = config;
+		for (const config of suggestionsConfig) this._suggestionsConfig[randomUUID$1()] = config;
 	}
 	/**
 	* Add a suggestion configuration
 	* @returns The ID of the created config
 	*/
 	addSuggestionsConfig(config) {
-		const id = randomUUID();
+		const id = randomUUID$1();
 		this._suggestionsConfig[id] = config;
 		this.notifySuggestionsConfigChanged();
 		return id;
@@ -490,7 +1116,7 @@ var SuggestionEngine = class {
 		for (const config of Object.values(this._suggestionsConfig)) {
 			if (config.consumerAgentId !== void 0 && config.consumerAgentId !== "*" && config.consumerAgentId !== agentId) continue;
 			if (!this.shouldShowSuggestions(config, messageCount)) continue;
-			const suggestionId = randomUUID();
+			const suggestionId = randomUUID$1();
 			if (isDynamicSuggestionsConfig(config)) {
 				if (!hasAnySuggestions) {
 					hasAnySuggestions = true;
@@ -840,6 +1466,7 @@ var RunHandler = class {
 	async runAgent({ agent, forwardedProps }) {
 		if (agent.agentId) this._internal.suggestionEngine.clearSuggestions(agent.agentId);
 		if (agent instanceof HttpAgent) agent.headers = { ...this._internal.headers };
+		if (agent.detachActiveRun) agent.detachActiveRun();
 		try {
 			const runAgentResult = await agent.runAgent({
 				forwardedProps: {
@@ -909,7 +1536,7 @@ var RunHandler = class {
 		let isArgumentError = false;
 		let parsedArgs;
 		try {
-			parsedArgs = ensureObjectArgs(typeof handlerArgs === "string" ? JSON.parse(handlerArgs) : handlerArgs, toolCall.function.name);
+			parsedArgs = parseToolArguments(handlerArgs, toolCall.function.name);
 		} catch (error) {
 			const parseError = error instanceof Error ? error : new Error(String(error));
 			errorMessage = parseError.message;
@@ -996,7 +1623,7 @@ var RunHandler = class {
 			const messageIndex = agent.messages.findIndex((m) => m.id === message.id);
 			if (messageIndex === -1) return false;
 			const toolMessage = {
-				id: randomUUID(),
+				id: randomUUID$1(),
 				role: "tool",
 				toolCallId: toolCall.id,
 				content: handlerResult.result
@@ -1019,7 +1646,7 @@ var RunHandler = class {
 		if (wildcardTool?.handler) {
 			let parsedArgs;
 			try {
-				parsedArgs = ensureObjectArgs(JSON.parse(toolCall.function.arguments), toolCall.function.name);
+				parsedArgs = parseToolArguments(toolCall.function.arguments, toolCall.function.name);
 			} catch (error) {
 				const parseError = error instanceof Error ? error : new Error(String(error));
 				errorMessage = parseError.message;
@@ -1085,7 +1712,7 @@ var RunHandler = class {
 			const messageIndex = agent.messages.findIndex((m) => m.id === message.id);
 			if (messageIndex === -1) return false;
 			const toolMessage = {
-				id: randomUUID(),
+				id: randomUUID$1(),
 				role: "tool",
 				toolCallId: toolCall.id,
 				content: toolCallResult
@@ -1129,9 +1756,9 @@ var RunHandler = class {
 			});
 			throw error;
 		}
-		const toolCallId = randomUUID();
+		const toolCallId = randomUUID$1();
 		const assistantMessage = {
-			id: randomUUID(),
+			id: randomUUID$1(),
 			role: "assistant",
 			content: "",
 			toolCalls: [{
@@ -1158,7 +1785,7 @@ var RunHandler = class {
 			toolType: "runTool"
 		});
 		const toolResultMessage = {
-			id: randomUUID(),
+			id: randomUUID$1(),
 			role: "tool",
 			toolCallId,
 			content: handlerResult.result
@@ -1169,7 +1796,7 @@ var RunHandler = class {
 		if (!handlerResult.error && followUp !== false) {
 			if (typeof followUp === "string" && followUp !== "generate") {
 				const userMessage = {
-					id: randomUUID(),
+					id: randomUUID$1(),
 					role: "user",
 					content: followUp
 				};
@@ -1266,6 +1893,25 @@ function ensureObjectArgs(parsed, toolName) {
 	if (typeof parsed === "object" && parsed !== null && !Array.isArray(parsed)) return parsed;
 	throw new Error(`Tool arguments for ${toolName} parsed to non-object (${typeof parsed})`);
 }
+/**
+* Parses raw tool call arguments into a validated object.
+*
+* Some LLM providers (e.g. @ai-sdk/openai-compatible) may send empty string "",
+* null, or undefined instead of "{}". This function normalises those cases to an
+* empty object so callers don't crash on JSON.parse("").
+*
+* A debug-level warning is emitted when the fallback triggers so silent coercion
+* is observable in logs.
+*
+* @internal Exported for testing only.
+*/
+function parseToolArguments(rawArgs, toolName) {
+	if (rawArgs === "" || rawArgs === null || rawArgs === void 0) {
+		logger.debug(`[parseToolArguments] Tool "${toolName}" received empty/null/undefined arguments — defaulting to {}`);
+		return {};
+	}
+	return ensureObjectArgs(typeof rawArgs === "string" ? JSON.parse(rawArgs) : rawArgs, toolName);
+}
 
 //#endregion
 //#region src/core/state-manager.ts
@@ -1560,6 +2206,12 @@ var CopilotKitCore = class {
 	get audioFileTranscriptionEnabled() {
 		return this.agentRegistry.audioFileTranscriptionEnabled;
 	}
+	get runtimeMode() {
+		return this.agentRegistry.runtimeMode;
+	}
+	get intelligence() {
+		return this.agentRegistry.intelligence;
+	}
 	get a2uiEnabled() {
 		return this.agentRegistry.a2uiEnabled;
 	}
@@ -1890,180 +2542,631 @@ function completePartialMarkdown(input) {
 }
 
 //#endregion
-//#region src/intelligence-agent.ts
-var IntelligenceAgent = class IntelligenceAgent extends AbstractAgent {
-	config;
-	socket = null;
-	activeChannel = null;
-	threadId = null;
-	constructor(config) {
-		super();
-		this.config = config;
-	}
-	clone() {
-		return new IntelligenceAgent(this.config);
+//#region src/utils/micro-redux.ts
+const INTERNAL_ACTION_TYPES = {
+	boot: "@@micro-redux/boot",
+	init: "@@micro-redux/init",
+	stop: "@@micro-redux/stop"
+};
+const INTERNAL_BOOT_ACTION = { type: INTERNAL_ACTION_TYPES.boot };
+/**
+* Builds a typed action creator from a type string and payload factory.
+*/
+function createTypedActionCreator(type, factory) {
+	const creator = ((...args) => ({
+		...factory(...args),
+		type
+	}));
+	creator.type = type;
+	creator.match = (action) => action.type === type;
+	return creator;
+}
+/**
+* Declares a payload-based action config for `createActionGroup`.
+*
+* @example
+* ```ts
+* const actions = createActionGroup("User", {
+*   loaded: props<{ id: string }>(),
+* });
+* ```
+*/
+function props() {
+	return { kind: "props" };
+}
+/**
+* Declares a no-payload action config for `createActionGroup`.
+*
+* @example
+* ```ts
+* const actions = createActionGroup("User", {
+*   reset: empty(),
+* });
+* ```
+*/
+function empty() {
+	return { kind: "empty" };
+}
+/**
+* Creates a namespaced group of typed action creators.
+*
+* Action types are formatted as: `[Source] actionName`.
+*/
+function createActionGroup(source, config) {
+	const group = {};
+	for (const eventName of Object.keys(config)) {
+		const eventConfig = config[eventName];
+		if (!eventConfig) continue;
+		const actionType = `[${source}] ${eventName}`;
+		if (eventConfig.kind === "props") {
+			group[eventName] = createTypedActionCreator(actionType, (payload) => ({ ...payload }));
+			continue;
+		}
+		group[eventName] = createTypedActionCreator(actionType, () => ({}));
 	}
-	abortRun() {
-		if (this.activeChannel && this.threadId) {
-			const fallback = setTimeout(() => this.cleanup(), 5e3);
-			const clear = () => {
-				clearTimeout(fallback);
-				this.cleanup();
-			};
-			this.activeChannel.push(AG_UI_CHANNEL_EVENT, {
-				type: EventType.CUSTOM,
-				name: "stop",
-				value: { threadId: this.threadId }
-			}).receive("ok", clear).receive("error", clear).receive("timeout", clear);
-		} else this.cleanup();
+	return group;
+}
+/**
+* Registers one reducer handler for one or more action creators.
+*
+* @throws Error when called without at least one action creator and reducer.
+*/
+function on(...args) {
+	if (args.length < 2) throw new Error("on requires at least one action creator and one reducer");
+	const reducer = args[args.length - 1];
+	return {
+		creators: args.slice(0, -1),
+		reducer
+	};
+}
+/**
+* Creates a reducer from an initial state and `on(...)` handler entries.
+*
+* Unknown action types return the current state unchanged.
+*/
+function createReducer(initialState, ...entries) {
+	const reducerMap = /* @__PURE__ */ new Map();
+	for (const entry of entries) for (const creator of entry.creators) {
+		const handlers = reducerMap.get(creator.type) ?? [];
+		handlers.push(entry.reducer);
+		reducerMap.set(creator.type, handlers);
+	}
+	return (state, action) => {
+		const currentState = state ?? initialState;
+		const handlers = reducerMap.get(action.type);
+		if (!handlers || handlers.length === 0) return currentState;
+		let nextState = currentState;
+		for (const handler of handlers) nextState = handler(nextState, action);
+		return nextState;
+	};
+}
+/**
+* Creates a selector that caches and reuses the last computed result
+* when all input references are unchanged.
+*/
+function createSelector(...args) {
+	if (args.length === 1) {
+		const projector = args[0];
+		let hasCached = false;
+		let lastState;
+		let lastResult;
+		return (state) => {
+			if (hasCached && state === lastState) return lastResult;
+			lastState = state;
+			lastResult = projector(state);
+			hasCached = true;
+			return lastResult;
+		};
 	}
-	/**
-	* Connect to a Phoenix channel scoped to the thread, trigger the run via
-	* REST, and relay server-pushed AG-UI events to the Observable subscriber.
-	*
-	* The server pushes each AG-UI event using its EventType string as the
-	* Phoenix event name (e.g. "TEXT_MESSAGE_CHUNK", "TOOL_CALL_START"), with
-	* the full BaseEvent as payload. RUN_FINISHED and RUN_ERROR are terminal
-	* events that complete or error the Observable.
-	*/
-	run(input) {
-		return new Observable((observer) => {
-			this.threadId = input.threadId;
-			const socket = new Socket(this.config.url, {
-				params: this.config.socketParams ?? {},
-				reconnectAfterMs: phoenixExponentialBackoff(100, 1e4),
-				rejoinAfterMs: phoenixExponentialBackoff(1e3, 3e4)
-			});
-			this.socket = socket;
-			socket.connect();
-			const channel = socket.channel(`agent:${input.threadId}`, { runId: input.runId });
-			this.activeChannel = channel;
-			channel.on(AG_UI_CHANNEL_EVENT, (payload) => {
-				observer.next(payload);
-				if (payload.type === EventType.RUN_FINISHED) {
-					observer.complete();
-					this.cleanup();
-				} else if (payload.type === EventType.RUN_ERROR) {
-					observer.error(new Error(payload.message ?? "Run error"));
-					this.cleanup();
-				}
-			});
-			const MAX_CONSECUTIVE_ERRORS = 5;
-			let consecutiveErrors = 0;
-			socket.onError(() => {
-				consecutiveErrors++;
-				if (consecutiveErrors >= MAX_CONSECUTIVE_ERRORS) {
-					observer.error(/* @__PURE__ */ new Error(`WebSocket connection failed after ${MAX_CONSECUTIVE_ERRORS} consecutive errors`));
-					this.cleanup();
-				}
-			});
-			socket.onOpen(() => {
-				consecutiveErrors = 0;
-			});
-			channel.onError(() => {});
-			channel.join().receive("ok", () => {
-				const { runtimeUrl, agentId, headers, credentials } = this.config;
-				const runPath = `${runtimeUrl}/agent/${encodeURIComponent(agentId)}/run`;
-				const origin = typeof window !== "undefined" && window.location ? window.location.origin : "http://localhost";
-				const runUrl = new URL(runPath, new URL(runtimeUrl, origin));
-				fetch(runUrl.toString(), {
-					method: "POST",
-					headers: {
-						"Content-Type": "application/json",
-						...headers
+	const projector = args[args.length - 1];
+	const selectors = args.slice(0, -1);
+	let hasCached = false;
+	let lastInputs = [];
+	let lastResult;
+	return (state) => {
+		const inputs = selectors.map((selector) => selector(state));
+		if (hasCached && inputs.length === lastInputs.length && inputs.every((value, index) => value === lastInputs[index])) return lastResult;
+		lastInputs = inputs;
+		lastResult = projector(...inputs);
+		hasCached = true;
+		return lastResult;
+	};
+}
+/**
+* RxJS operator that maps state emissions through a selector and suppresses
+* unchanged projected values via reference equality.
+*/
+function select(selector) {
+	return (source$) => source$.pipe(map(selector), distinctUntilChanged());
+}
+/**
+* RxJS operator that filters an action stream by action creators and narrows
+* the output action type to the matched creator union.
+*
+* @throws Error when called without at least one action creator.
+*/
+function ofType(...creators) {
+	if (creators.length === 0) throw new Error("ofType requires at least one action creator");
+	const actionTypes = new Set(creators.map((creator) => creator.type));
+	return (source$) => {
+		return source$.pipe(filter((action) => {
+			return actionTypes.has(action.type);
+		}));
+	};
+}
+/**
+* Creates an effect descriptor consumed by `createStore`.
+*/
+function createEffect(factory, options = {}) {
+	if (options.dispatch === false) return {
+		run: factory,
+		dispatch: false
+	};
+	return {
+		run: factory,
+		dispatch: true
+	};
+}
+/**
+* Creates a small observable store with reducer + effects.
+*
+* Behavior:
+* - `init()` starts effects and dispatches `@@micro-redux/init`.
+* - `stop()` dispatches `@@micro-redux/stop` and unsubscribes all effects.
+* - Effect action observation is scheduled on `asapScheduler` to avoid
+*   synchronous re-entrancy in the effect loop.
+* - Any effect error triggers fail-fast teardown and errors both `actions$`
+*   and `state$`.
+*/
+function createStore(options) {
+	const reducer = options.reducer;
+	const effects = options.effects ?? [];
+	let hasFatalError = false;
+	let isRunning = false;
+	let effectSubscriptions = new Subscription();
+	let currentState = reducer(void 0, INTERNAL_BOOT_ACTION);
+	const stateSubject = new BehaviorSubject(currentState);
+	const actionsSubject = new Subject();
+	const dispatchInternal = (action) => {
+		if (hasFatalError) throw new Error("Store is in a failed state due to an effect error");
+		currentState = reducer(currentState, action);
+		stateSubject.next(currentState);
+		actionsSubject.next(action);
+	};
+	const failFast = (error) => {
+		if (hasFatalError) return;
+		hasFatalError = true;
+		isRunning = false;
+		effectSubscriptions.unsubscribe();
+		effectSubscriptions = new Subscription();
+		actionsSubject.error(error);
+		stateSubject.error(error);
+	};
+	const startEffects = () => {
+		for (const effect of effects) {
+			const scheduledActions$ = actionsSubject.asObservable().pipe(observeOn(asapScheduler));
+			const state$ = stateSubject.asObservable();
+			if (effect.dispatch) {
+				const subscription = effect.run(scheduledActions$, state$).subscribe({
+					next: (effectAction) => {
+						if (hasFatalError) return;
+						dispatchInternal(effectAction);
 					},
-					body: JSON.stringify({
-						threadId: input.threadId,
-						runId: input.runId,
-						messages: input.messages,
-						tools: input.tools,
-						context: input.context,
-						state: input.state,
-						forwardedProps: input.forwardedProps
-					}),
-					...credentials ? { credentials } : {}
-				}).catch((error) => {
-					observer.error(/* @__PURE__ */ new Error(`REST run request failed: ${error.message ?? error}`));
-					this.cleanup();
+					error: (error) => {
+						failFast(error);
+					}
 				});
-			}).receive("error", (resp) => {
-				observer.error(/* @__PURE__ */ new Error(`Failed to join channel: ${JSON.stringify(resp)}`));
-				this.cleanup();
-			}).receive("timeout", () => {
-				observer.error(/* @__PURE__ */ new Error("Timed out joining channel"));
-				this.cleanup();
-			});
-			return () => {
-				this.cleanup();
-			};
+				effectSubscriptions.add(subscription);
+				continue;
+			}
+			const subscription = effect.run(scheduledActions$, state$).subscribe({ error: (error) => {
+				failFast(error);
+			} });
+			effectSubscriptions.add(subscription);
+		}
+	};
+	return {
+		dispatch(action) {
+			dispatchInternal(action);
+		},
+		getState() {
+			return currentState;
+		},
+		get state$() {
+			return stateSubject.asObservable();
+		},
+		get actions$() {
+			return actionsSubject.asObservable();
+		},
+		select(selector) {
+			return stateSubject.asObservable().pipe(select(selector));
+		},
+		init() {
+			if (hasFatalError || isRunning) return;
+			isRunning = true;
+			startEffects();
+			if (hasFatalError) return;
+			dispatchInternal({ type: INTERNAL_ACTION_TYPES.init });
+		},
+		stop() {
+			if (hasFatalError || !isRunning) return;
+			dispatchInternal({ type: INTERNAL_ACTION_TYPES.stop });
+			effectSubscriptions.unsubscribe();
+			effectSubscriptions = new Subscription();
+			isRunning = false;
+		}
+	};
+}
+
+//#endregion
+//#region src/threads.ts
+const THREADS_CHANNEL_EVENT = "thread_metadata";
+const THREAD_SUBSCRIBE_PATH = "/threads/subscribe";
+const MAX_SOCKET_RETRIES = 5;
+const REQUEST_TIMEOUT_MS = 15e3;
+const initialThreadState = {
+	threads: [],
+	isLoading: false,
+	error: null,
+	context: null,
+	sessionId: 0,
+	metadataCredentialsRequested: false
+};
+const threadAdapterEvents = createActionGroup("Thread Adapter", {
+	started: empty(),
+	stopped: empty(),
+	contextChanged: props(),
+	renameRequested: props(),
+	archiveRequested: props(),
+	deleteRequested: props()
+});
+const threadRestEvents = createActionGroup("Thread REST", {
+	listRequested: props(),
+	listSucceeded: props(),
+	listFailed: props(),
+	metadataCredentialsRequested: props(),
+	metadataCredentialsSucceeded: props(),
+	metadataCredentialsFailed: props(),
+	mutationFinished: props()
+});
+const threadSocketEvents = createActionGroup("Thread Socket", {
+	opened: props(),
+	errored: props(),
+	joinFailed: props(),
+	joinTimedOut: props(),
+	metadataReceived: props()
+});
+const threadDomainEvents = createActionGroup("Thread Domain", {
+	threadUpserted: props(),
+	threadDeleted: props()
+});
+function sortThreadsByUpdatedAt(threads) {
+	return [...threads].sort((left, right) => right.updatedAt.localeCompare(left.updatedAt));
+}
+function upsertThread(threads, thread) {
+	const existingIndex = threads.findIndex((item) => item.id === thread.id);
+	if (existingIndex === -1) return sortThreadsByUpdatedAt([...threads, thread]);
+	const next = [...threads];
+	next[existingIndex] = thread;
+	return sortThreadsByUpdatedAt(next);
+}
+const threadReducer = createReducer(initialThreadState, on(threadAdapterEvents.contextChanged, (state, { context }) => ({
+	...state,
+	context,
+	sessionId: state.sessionId + 1,
+	threads: [],
+	isLoading: Boolean(context),
+	error: null,
+	metadataCredentialsRequested: false
+})), on(threadAdapterEvents.stopped, (state) => ({
+	...state,
+	threads: [],
+	isLoading: false,
+	error: null,
+	metadataCredentialsRequested: false
+})), on(threadRestEvents.listRequested, (state, { sessionId }) => {
+	if (sessionId !== state.sessionId || !state.context) return state;
+	return {
+		...state,
+		isLoading: true,
+		error: null
+	};
+}), on(threadRestEvents.listSucceeded, (state, { sessionId, threads }) => {
+	if (sessionId !== state.sessionId) return state;
+	return {
+		...state,
+		threads: sortThreadsByUpdatedAt(threads),
+		isLoading: false,
+		error: null
+	};
+}), on(threadRestEvents.listFailed, (state, { sessionId, error }) => {
+	if (sessionId !== state.sessionId) return state;
+	return {
+		...state,
+		isLoading: false,
+		error
+	};
+}), on(threadRestEvents.metadataCredentialsFailed, (state, { sessionId, error }) => {
+	if (sessionId !== state.sessionId) return state;
+	return {
+		...state,
+		error
+	};
+}), on(threadRestEvents.metadataCredentialsRequested, (state, { sessionId }) => {
+	if (sessionId !== state.sessionId) return state;
+	return {
+		...state,
+		metadataCredentialsRequested: true
+	};
+}), on(threadRestEvents.mutationFinished, (state, { outcome }) => ({
+	...state,
+	error: outcome.ok ? state.error : outcome.error
+})), on(threadDomainEvents.threadUpserted, (state, { sessionId, thread }) => {
+	if (sessionId !== state.sessionId) return state;
+	return {
+		...state,
+		threads: upsertThread(state.threads, thread)
+	};
+}), on(threadDomainEvents.threadDeleted, (state, { sessionId, threadId }) => {
+	if (sessionId !== state.sessionId) return state;
+	return {
+		...state,
+		threads: state.threads.filter((thread) => thread.id !== threadId)
+	};
+}));
+const selectThreads = createSelector((state) => state.threads);
+const selectThreadsIsLoading = createSelector((state) => state.isLoading);
+const selectThreadsError = createSelector((state) => state.error);
+let threadRequestId = 0;
+function createThreadRequestId() {
+	threadRequestId += 1;
+	return `thread-request-${threadRequestId}`;
+}
+function createThreadFetchObservable(environment, context, sessionId) {
+	return defer(() => {
+		const params = new URLSearchParams({
+			userId: context.userId,
+			agentId: context.agentId
 		});
-	}
-	/**
-	* Reconnect to an existing thread by joining the Phoenix channel in
-	* "connect" mode and requesting the server replay history.
-	*/
-	connect(input) {
-		return new Observable((observer) => {
-			this.threadId = input.threadId;
-			const socket = new Socket(this.config.url, {
-				params: this.config.socketParams ?? {},
-				reconnectAfterMs: phoenixExponentialBackoff(100, 1e4),
-				rejoinAfterMs: phoenixExponentialBackoff(1e3, 3e4)
-			});
-			this.socket = socket;
-			socket.connect();
-			const channel = socket.channel(`agent:${input.threadId}`, { mode: "connect" });
-			this.activeChannel = channel;
-			channel.on(AG_UI_CHANNEL_EVENT, (payload) => {
-				observer.next(payload);
-				if (payload.type === EventType.RUN_FINISHED || payload.type === EventType.RUN_ERROR) {
-					observer.complete();
-					this.cleanup();
-				}
+		return fromFetch(`${context.runtimeUrl}/threads?${params.toString()}`, {
+			selector: (response) => {
+				if (!response.ok) throw new Error(`Failed to fetch threads: ${response.status}`);
+				return response.json();
+			},
+			fetch: environment.fetch,
+			method: "GET",
+			headers: { ...context.headers }
+		}).pipe(timeout({
+			first: REQUEST_TIMEOUT_MS,
+			with: () => {
+				throw new Error("Request timed out");
+			}
+		}), map((data) => threadRestEvents.listSucceeded({
+			sessionId,
+			threads: data.threads
+		})), catchError((error) => {
+			return of(threadRestEvents.listFailed({
+				sessionId,
+				error: error instanceof Error ? error : new Error(String(error))
+			}));
+		}));
+	});
+}
+function createThreadMetadataCredentialsObservable(environment, context, sessionId) {
+	return defer(() => {
+		return fromFetch(`${context.runtimeUrl}${THREAD_SUBSCRIBE_PATH}`, {
+			selector: async (response) => {
+				if (!response.ok) throw new Error(`Failed to fetch thread metadata credentials: ${response.status}`);
+				return response.json();
+			},
+			fetch: environment.fetch,
+			method: "POST",
+			headers: {
+				...context.headers,
+				"Content-Type": "application/json"
+			},
+			body: JSON.stringify({ userId: context.userId })
+		}).pipe(timeout({
+			first: REQUEST_TIMEOUT_MS,
+			with: () => {
+				throw new Error("Request timed out");
+			}
+		}), map((data) => {
+			if (typeof data.joinToken !== "string" || data.joinToken.length === 0) throw new Error("missing joinToken");
+			return threadRestEvents.metadataCredentialsSucceeded({
+				sessionId,
+				joinToken: data.joinToken
 			});
-			const MAX_CONSECUTIVE_ERRORS = 5;
-			let consecutiveErrors = 0;
-			socket.onError(() => {
-				consecutiveErrors++;
-				if (consecutiveErrors >= MAX_CONSECUTIVE_ERRORS) {
-					observer.error(/* @__PURE__ */ new Error(`WebSocket connection failed after ${MAX_CONSECUTIVE_ERRORS} consecutive errors`));
-					this.cleanup();
+		}), catchError((error) => {
+			return of(threadRestEvents.metadataCredentialsFailed({
+				sessionId,
+				error: error instanceof Error ? error : new Error(String(error))
+			}));
+		}));
+	});
+}
+function createThreadMutationObservable(environment, context, request) {
+	return defer(() => {
+		return fromFetch(`${context.runtimeUrl}${request.path}`, {
+			selector: async (response) => {
+				if (!response.ok) throw new Error(`Request failed: ${response.status}`);
+				return null;
+			},
+			fetch: environment.fetch,
+			method: request.method,
+			headers: {
+				...context.headers,
+				"Content-Type": "application/json"
+			},
+			body: JSON.stringify(request.body)
+		}).pipe(map(() => threadRestEvents.mutationFinished({ outcome: {
+			requestId: request.requestId,
+			ok: true
+		} })), catchError((error) => {
+			return of(threadRestEvents.mutationFinished({ outcome: {
+				requestId: request.requestId,
+				ok: false,
+				error: error instanceof Error ? error : new Error(String(error))
+			} }));
+		}));
+	});
+}
+function createThreadStore(environment) {
+	const store = createStore({
+		reducer: threadReducer,
+		effects: [
+			createEffect((actions$, state$) => actions$.pipe(ofType(threadAdapterEvents.contextChanged), withLatestFrom(state$), filter(([, state]) => Boolean(state.context)), map(([, state]) => threadRestEvents.listRequested({ sessionId: state.sessionId })))),
+			createEffect((actions$, state$) => actions$.pipe(ofType(threadRestEvents.listRequested), switchMap$1((action) => state$.pipe(map((state) => state.context), filter((context) => Boolean(context)), take(1), map((context) => ({
+				action,
+				context
+			})), takeUntil(actions$.pipe(ofType(threadAdapterEvents.contextChanged, threadAdapterEvents.stopped))), switchMap$1(({ action: currentAction, context }) => createThreadFetchObservable(environment, context, currentAction.sessionId)))))),
+			createEffect((actions$, state$) => actions$.pipe(ofType(threadRestEvents.listSucceeded), withLatestFrom(state$), filter(([action, state]) => {
+				return action.sessionId === state.sessionId && !state.metadataCredentialsRequested && Boolean(state.context?.wsUrl);
+			}), map(([action]) => threadRestEvents.metadataCredentialsRequested({ sessionId: action.sessionId })))),
+			createEffect((actions$, state$) => actions$.pipe(ofType(threadRestEvents.metadataCredentialsRequested), switchMap$1((action) => state$.pipe(map((state) => state.context), filter((context) => Boolean(context)), take(1), map((context) => ({
+				action,
+				context
+			})), takeUntil(actions$.pipe(ofType(threadAdapterEvents.contextChanged, threadAdapterEvents.stopped))), switchMap$1(({ action: currentAction, context }) => createThreadMetadataCredentialsObservable(environment, context, currentAction.sessionId)))))),
+			createEffect((actions$, state$) => actions$.pipe(ofType(threadRestEvents.metadataCredentialsSucceeded), withLatestFrom(state$), filter(([action, state]) => {
+				return action.sessionId === state.sessionId && Boolean(state.context?.wsUrl);
+			}), switchMap$1(([action, state]) => {
+				const context = state.context;
+				const joinToken = action.joinToken;
+				const shutdown$ = actions$.pipe(ofType(threadAdapterEvents.contextChanged, threadAdapterEvents.stopped));
+				return defer(() => {
+					const socket$ = ɵphoenixSocket$({
+						url: context.wsUrl,
+						options: {
+							params: { join_token: joinToken },
+							reconnectAfterMs: phoenixExponentialBackoff(100, 1e4),
+							rejoinAfterMs: phoenixExponentialBackoff(1e3, 3e4)
+						}
+					}).pipe(shareReplay({
+						bufferSize: 1,
+						refCount: true
+					}));
+					const channel$ = ɵphoenixChannel$({
+						socket$,
+						topic: `user_meta:${context.userId}`
+					}).pipe(shareReplay({
+						bufferSize: 1,
+						refCount: true
+					}));
+					const socketSignals$ = ɵobservePhoenixSocketSignals$(socket$).pipe(share());
+					const fatalSocketShutdown$ = ɵobservePhoenixSocketHealth$(socketSignals$, MAX_SOCKET_RETRIES).pipe(catchError(() => {
+						console.warn(`[threads] WebSocket failed after ${MAX_SOCKET_RETRIES} attempts, giving up`);
+						return of(void 0);
+					}), share());
+					return merge(socketSignals$.pipe(map((signal) => signal.type === "open" ? threadSocketEvents.opened({ sessionId: action.sessionId }) : threadSocketEvents.errored({ sessionId: action.sessionId }))), channel$.pipe(switchMap$1(({ channel }) => ɵobservePhoenixEvent$(channel, THREADS_CHANNEL_EVENT)), map((payload) => threadSocketEvents.metadataReceived({
+						sessionId: action.sessionId,
+						payload
+					}))), ɵobservePhoenixJoinOutcome$(channel$).pipe(filter((outcome) => outcome.type !== "joined"), map((outcome) => outcome.type === "timeout" ? threadSocketEvents.joinTimedOut({ sessionId: action.sessionId }) : threadSocketEvents.joinFailed({ sessionId: action.sessionId })))).pipe(takeUntil(merge(shutdown$, fatalSocketShutdown$)));
+				});
+			}))),
+			createEffect((actions$, state$) => actions$.pipe(ofType(threadSocketEvents.metadataReceived), withLatestFrom(state$), filter(([action, state]) => {
+				return action.sessionId === state.sessionId && action.payload.userId === state.context?.userId;
+			}), map(([action]) => {
+				if (action.payload.operation === "deleted") return threadDomainEvents.threadDeleted({
+					sessionId: action.sessionId,
+					threadId: action.payload.deleted.id
+				});
+				return threadDomainEvents.threadUpserted({
+					sessionId: action.sessionId,
+					thread: action.payload.thread
+				});
+			}))),
+			createEffect((actions$, state$) => actions$.pipe(ofType(threadAdapterEvents.renameRequested, threadAdapterEvents.archiveRequested, threadAdapterEvents.deleteRequested), withLatestFrom(state$), mergeMap(([action, state]) => {
+				const context = state.context;
+				if (!context?.runtimeUrl) {
+					const requestId = action.requestId;
+					return of(threadRestEvents.mutationFinished({ outcome: {
+						requestId,
+						ok: false,
+						error: /* @__PURE__ */ new Error("Runtime URL is not configured")
+					} }));
 				}
-			});
-			socket.onOpen(() => {
-				consecutiveErrors = 0;
-			});
-			channel.onError(() => {});
-			channel.join().receive("ok", () => {
-				channel.push(EventType.CUSTOM, {
-					type: EventType.CUSTOM,
-					name: "connect",
-					value: { threadId: input.threadId }
+				const commonBody = {
+					userId: context.userId,
+					agentId: context.agentId
+				};
+				if (threadAdapterEvents.renameRequested.match(action)) return createThreadMutationObservable(environment, context, {
+					requestId: action.requestId,
+					method: "PATCH",
+					path: `/threads/${encodeURIComponent(action.threadId)}`,
+					body: {
+						...commonBody,
+						name: action.name
+					}
 				});
-			}).receive("error", (resp) => {
-				observer.error(/* @__PURE__ */ new Error(`Failed to join channel: ${JSON.stringify(resp)}`));
-				this.cleanup();
-			}).receive("timeout", () => {
-				observer.error(/* @__PURE__ */ new Error("Timed out joining channel"));
-				this.cleanup();
-			});
-			return () => {
-				this.cleanup();
-			};
+				if (threadAdapterEvents.archiveRequested.match(action)) return createThreadMutationObservable(environment, context, {
+					requestId: action.requestId,
+					method: "POST",
+					path: `/threads/${encodeURIComponent(action.threadId)}/archive`,
+					body: commonBody
+				});
+				return createThreadMutationObservable(environment, context, {
+					requestId: action.requestId,
+					method: "DELETE",
+					path: `/threads/${encodeURIComponent(action.threadId)}`,
+					body: commonBody
+				});
+			})))
+		]
+	});
+	function trackMutation(dispatchAction) {
+		const resultPromise = firstValueFrom(merge(store.actions$.pipe(ofType(threadRestEvents.mutationFinished), filter((action) => action.outcome.requestId === dispatchAction.requestId), map((action) => action.outcome)), store.actions$.pipe(ofType(threadAdapterEvents.stopped), map(() => ({
+			requestId: dispatchAction.requestId,
+			ok: false,
+			error: /* @__PURE__ */ new Error("Thread store stopped before mutation completed")
+		})))).pipe(take(1))).then((outcome) => {
+			if (outcome.ok) return;
+			throw outcome.error;
 		});
-	}
-	cleanup() {
-		if (this.activeChannel) {
-			this.activeChannel.leave();
-			this.activeChannel = null;
-		}
-		if (this.socket) {
-			this.socket.disconnect();
-			this.socket = null;
-		}
-	}
-};
+		store.dispatch(dispatchAction);
+		return resultPromise;
+	}
+	return {
+		start() {
+			store.init();
+			store.dispatch(threadAdapterEvents.started());
+		},
+		stop() {
+			store.dispatch(threadAdapterEvents.stopped());
+			store.stop();
+		},
+		setContext(context) {
+			store.dispatch(threadAdapterEvents.contextChanged({ context }));
+		},
+		renameThread(threadId, name) {
+			return trackMutation(threadAdapterEvents.renameRequested({
+				requestId: createThreadRequestId(),
+				threadId,
+				name
+			}));
+		},
+		archiveThread(threadId) {
+			return trackMutation(threadAdapterEvents.archiveRequested({
+				requestId: createThreadRequestId(),
+				threadId
+			}));
+		},
+		deleteThread(threadId) {
+			return trackMutation(threadAdapterEvents.deleteRequested({
+				requestId: createThreadRequestId(),
+				threadId
+			}));
+		},
+		getState() {
+			return store.getState();
+		},
+		select: store.select.bind(store)
+	};
+}
+const ɵthreadAdapterEvents = threadAdapterEvents;
+const ɵselectThreads = selectThreads;
+const ɵselectThreadsIsLoading = selectThreadsIsLoading;
+const ɵselectThreadsError = selectThreadsError;
 
 //#endregion
-export { AgentRegistry, ContextStore, CopilotKitCore, CopilotKitCoreErrorCode, CopilotKitCoreRuntimeConnectionStatus, IntelligenceAgent, ProxiedCopilotRuntimeAgent, RunHandler, StateManager, SuggestionEngine, ToolCallStatus, completePartialMarkdown, ensureObjectArgs };
+export { AgentRegistry, ContextStore, CopilotKitCore, CopilotKitCoreErrorCode, CopilotKitCoreRuntimeConnectionStatus, IntelligenceAgent, ProxiedCopilotRuntimeAgent, RunHandler, StateManager, SuggestionEngine, ToolCallStatus, completePartialMarkdown, createActionGroup, createEffect, createReducer, createSelector, createStore, empty, ensureObjectArgs, ofType, on, parseToolArguments, props, select, createThreadStore as ɵcreateThreadStore, ɵjoinPhoenixChannel$, ɵobservePhoenixEvent$, ɵobservePhoenixJoinOutcome$, ɵobservePhoenixSocketHealth$, ɵobservePhoenixSocketSignals$, ɵphoenixChannel$, ɵphoenixSocket$, ɵselectThreads, ɵselectThreadsError, ɵselectThreadsIsLoading, ɵthreadAdapterEvents };
 //# sourceMappingURL=index.mjs.map