@copilotkit/core 1.70.0 → 1.70.2

package/dist/index.umd.js

@@ -1,10 +1,88 @@
 (function(global, factory) {
-  typeof exports === 'object' && typeof module !== 'undefined' ?  factory(exports, require('@tanstack/pacer'), require('@ag-ui/client'), require('@copilotkit/shared'), require('rxjs'), require('rxjs/operators'), require('phoenix'), require('zod-to-json-schema'), require('rxjs/fetch')) :
-  typeof define === 'function' && define.amd ? define(['exports', '@tanstack/pacer', '@ag-ui/client', '@copilotkit/shared', 'rxjs', 'rxjs/operators', 'phoenix', 'zod-to-json-schema', 'rxjs/fetch'], factory) :
-  (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory((global.CopilotKitCore = {}), global._tanstack_pacer,global.AgUIClient,global.CopilotKitShared,global.rxjs,global.rxjs.operators,global.phoenix,global.zodToJsonSchema,global.rxjs_fetch));
-})(this, function(exports, _tanstack_pacer, _ag_ui_client, _copilotkit_shared, rxjs, rxjs_operators, phoenix, zod_to_json_schema, rxjs_fetch) {
+  typeof exports === 'object' && typeof module !== 'undefined' ?  factory(exports, require('@tanstack/pacer'), require('@ag-ui/client'), require('@copilotkit/shared'), require('rxjs'), require('rxjs/operators'), require('phoenix'), require('zod-to-json-schema')) :
+  typeof define === 'function' && define.amd ? define(['exports', '@tanstack/pacer', '@ag-ui/client', '@copilotkit/shared', 'rxjs', 'rxjs/operators', 'phoenix', 'zod-to-json-schema'], factory) :
+  (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory((global.CopilotKitCore = {}), global._tanstack_pacer,global.AgUIClient,global.CopilotKitShared,global.rxjs,global.rxjs.operators,global.phoenix,global.zodToJsonSchema));
+})(this, function(exports, _tanstack_pacer, _ag_ui_client, _copilotkit_shared, rxjs, rxjs_operators, phoenix, zod_to_json_schema) {
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
+//#region src/utils/connect-replay.ts
+/**
+	* Runs an agent's `connect()` stream through the AbstractAgent apply pipeline
+	* with the `verifyEvents` step omitted.
+	*
+	* `verifyEvents` enforces AG-UI's *single run* lifecycle rules: exactly one
+	* RUN_STARTED opening the stream, no events after a terminal RUN_FINISHED /
+	* RUN_ERROR. Those rules are correct for `/run`, but a `/connect` response is a
+	* replay of a thread's history and can legitimately carry several past runs
+	* back to back — including a run that ended in RUN_ERROR followed by a later
+	* RUN_STARTED. Verifying a replay against single-run rules makes hydration of
+	* an existing thread fail outright:
+	*
+	*   Cannot send event type 'RUN_STARTED': The run has already errored with
+	*   'RUN_ERROR'. No further events can be sent.
+	*
+	* `transformChunks` is still applied — message reassembly is needed either way.
+	*
+	* This mirrors the base `AbstractAgent.connectAgent` implementation exactly
+	* apart from that omission, so callers keep the same subscriber notifications,
+	* detach semantics, and `{ result, newMessages }` return shape.
+	*
+	* TODO: Remove this in favour of the base implementation once AG-UI's
+	* AbstractAgent supports opting out of `verifyEvents` for transports whose
+	* connection life-cycle isn't a single run. As of `@ag-ui/client@0.0.57`
+	* `connectAgent(parameters?, subscriber?)` takes no such option.
+	*
+	* @param agent - The agent whose `connect()` stream should be consumed.
+	* @param parameters - Run parameters, forwarded to `prepareRunAgentInput`.
+	* @param subscriber - Optional one-shot subscriber for this connect call.
+	*/
+	async function ɵconnectWithoutEventVerification(agent, parameters, subscriber) {
+		const self = agent;
+		try {
+			var _agent$agentId;
+			agent.isRunning = true;
+			agent.agentId = (_agent$agentId = agent.agentId) !== null && _agent$agentId !== void 0 ? _agent$agentId : (0, _ag_ui_client.randomUUID)();
+			const input = self.prepareRunAgentInput(parameters);
+			let result;
+			const previousMessageIds = new Set(agent.messages.map((m) => m.id));
+			const subscribers = [
+				{ onRunFinishedEvent: (event) => {
+					if (event.outcome === "success") result = event.result;
+				} },
+				...agent.subscribers,
+				subscriber !== null && subscriber !== void 0 ? subscriber : {}
+			];
+			await self.onInitialize(input, subscribers);
+			self.activeRunDetach$ = new rxjs.Subject();
+			let resolveCompletion;
+			self.activeRunCompletionPromise = new Promise((resolve) => {
+				resolveCompletion = resolve;
+			});
+			const source$ = (0, rxjs.defer)(() => self.connect(input)).pipe((0, _ag_ui_client.transformChunks)(self.debugLogger), (0, rxjs_operators.takeUntil)(self.activeRunDetach$));
+			const applied$ = self.apply(input, source$, subscribers);
+			await (0, rxjs.lastValueFrom)(self.processApplyEvents(input, applied$, subscribers).pipe((0, rxjs_operators.catchError)((error) => {
+				agent.isRunning = false;
+				if (error instanceof _ag_ui_client.AGUIConnectNotImplementedError) return rxjs.EMPTY;
+				return self.onError(input, error, subscribers);
+			}), (0, rxjs_operators.finalize)(() => {
+				agent.isRunning = false;
+				self.onFinalize(input, subscribers);
+				resolveCompletion === null || resolveCompletion === void 0 || resolveCompletion();
+				resolveCompletion = void 0;
+				self.activeRunCompletionPromise = void 0;
+				self.activeRunDetach$ = void 0;
+			})), { defaultValue: void 0 });
+			const newMessages = (0, _ag_ui_client.structuredClone_)(agent.messages).filter((m) => !previousMessageIds.has(m.id));
+			return {
+				result,
+				newMessages
+			};
+		} finally {
+			agent.isRunning = false;
+		}
+	}
+
+//#endregion
 //#region src/utils/phoenix-observable.ts
 /**
 	* Adapt Phoenix socket open/error callbacks into an observable signal stream.
@@ -243,73 +321,22 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		/**
 		* 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.
+		* agent run start/stop cycle: the replayed events may omit the
+		* RUN_STARTED/RUN_FINISHED bookends, or carry events from several past runs,
+		* either of which makes `verifyEvents` stall or 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.
+		* See {@link ɵconnectWithoutEventVerification} for the pipeline itself, which
+		* the self-hosted `/connect` path shares for the same reason.
 		*/
 		async connectAgent(parameters, subscriber) {
-			const self = this;
-			try {
-				var _this$agentId;
-				this.isRunning = true;
-				this.agentId = (_this$agentId = this.agentId) !== null && _this$agentId !== void 0 ? _this$agentId : (0, _ag_ui_client.randomUUID)();
-				const effectiveParameters = (parameters === null || parameters === void 0 ? void 0 : parameters.runId) || !this.canonicalRunId ? parameters : {
-					...parameters,
-					runId: this.canonicalRunId
-				};
-				const input = this.prepareRunAgentInput(effectiveParameters);
-				let result;
-				const previousMessageIds = new Set(this.messages.map((m) => m.id));
-				const subscribers = [
-					{ onRunFinishedEvent: (event) => {
-						if (event.outcome === "success") result = event.result;
-					} },
-					...this.subscribers,
-					subscriber !== null && subscriber !== void 0 ? subscriber : {}
-				];
-				await this.onInitialize(input, subscribers);
-				self.activeRunDetach$ = new rxjs.Subject();
-				let resolveCompletion;
-				self.activeRunCompletionPromise = new Promise((resolve) => {
-					resolveCompletion = resolve;
-				});
-				const source$ = (0, rxjs.defer)(() => this.connect(input)).pipe((0, _ag_ui_client.transformChunks)(this.debugLogger), (0, rxjs_operators.takeUntil)(self.activeRunDetach$));
-				const applied$ = this.apply(input, source$, subscribers);
-				await (0, rxjs.lastValueFrom)(this.processApplyEvents(input, applied$, subscribers).pipe((0, rxjs_operators.catchError)((error) => {
-					this.isRunning = false;
-					return this.onError(input, error, subscribers);
-				}), (0, rxjs_operators.finalize)(() => {
-					this.isRunning = false;
-					this.onFinalize(input, subscribers);
-					resolveCompletion === null || resolveCompletion === void 0 || resolveCompletion();
-					resolveCompletion = void 0;
-					self.activeRunCompletionPromise = void 0;
-					self.activeRunDetach$ = void 0;
-				})), { defaultValue: void 0 });
-				const newMessages = (0, _ag_ui_client.structuredClone_)(this.messages).filter((m) => !previousMessageIds.has(m.id));
-				return {
-					result,
-					newMessages
-				};
-			} finally {
-				this.isRunning = false;
-			}
+			const effectiveParameters = (parameters === null || parameters === void 0 ? void 0 : parameters.runId) || !this.canonicalRunId ? parameters : {
+				...parameters,
+				runId: this.canonicalRunId
+			};
+			return ɵconnectWithoutEventVerification(this, effectiveParameters, subscriber);
 		}
 		abortRun() {
 			if (this.activeChannel && this.canonicalRunId) {
@@ -402,13 +429,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 							...this.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,
+							...input,
 							...mode === "connect" ? { lastSeenEventId: replayCursor === void 0 ? this.getReconnectCursor(input) : replayCursor } : {}
 						}),
 						...this.credentials ? { credentials: this.credentials } : {}
@@ -843,7 +864,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			});
 		}
 		async connectAgent(parameters, subscriber) {
-			if (this.runtimeMode !== _copilotkit_shared.RUNTIME_MODE_INTELLIGENCE) return super.connectAgent(parameters, subscriber);
+			if (this.runtimeMode !== _copilotkit_shared.RUNTIME_MODE_INTELLIGENCE) return ɵconnectWithoutEventVerification(this, parameters, subscriber);
 			if (this.delegate) await this.delegate.detachActiveRun();
 			await this.resolveDelegate();
 			const delegate = this.delegate;
@@ -1102,6 +1123,76 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		return init === null || init === void 0 ? void 0 : init.ɵruntimeRequest;
 	}
 
+//#endregion
+//#region src/utils/single-route-resource-request.ts
+/** Returns true when a path belongs to an Intelligence resource API. */
+	function isIntelligenceResourcePath(path) {
+		return path === "/threads" || path.startsWith("/threads/") || path === "/memories" || path.startsWith("/memories/") || path === "/annotate";
+	}
+	/** Reads a JSON resource body without changing invalid JSON error behavior. */
+	async function readResourceBody(input, init, headers, method) {
+		var _headers$get;
+		if (method === "GET" || method === "HEAD") return void 0;
+		let text;
+		if ((init === null || init === void 0 ? void 0 : init.body) != null) text = await new Response(init.body).text();
+		else if (input instanceof Request) text = await input.clone().text();
+		if (!text) return void 0;
+		if ((_headers$get = headers.get("content-type")) === null || _headers$get === void 0 ? void 0 : _headers$get.toLowerCase().includes("application/json")) try {
+			return JSON.parse(text);
+		} catch (_unused) {
+			return text;
+		}
+		return text;
+	}
+	/**
+	* Converts one Runtime resource fetch into a single-route JSON envelope.
+	* Requests outside the mounted Runtime or outside its resource APIs pass
+	* through unchanged.
+	*/
+	async function createSingleRouteResourceRequest(input, init, runtimeUrl) {
+		var _init$method, _init$headers;
+		const runtime = new URL(runtimeUrl);
+		const inputUrl = input instanceof Request ? input.url : input instanceof URL ? input.href : input;
+		const target = new URL(inputUrl, runtime);
+		const runtimePath = runtime.pathname.replace(/\/$/, "");
+		if (target.origin !== runtime.origin) return null;
+		if (!target.pathname.startsWith(`${runtimePath}/`)) return null;
+		const resourcePath = target.pathname.slice(runtimePath.length);
+		if (!isIntelligenceResourcePath(resourcePath)) return null;
+		const method = ((_init$method = init === null || init === void 0 ? void 0 : init.method) !== null && _init$method !== void 0 ? _init$method : input instanceof Request ? input.method : "GET").toUpperCase();
+		const headers = new Headers((_init$headers = init === null || init === void 0 ? void 0 : init.headers) !== null && _init$headers !== void 0 ? _init$headers : input instanceof Request ? input.headers : void 0);
+		const body = await readResourceBody(input, init, headers, method);
+		headers.set("content-type", "application/json");
+		headers.delete("content-length");
+		return {
+			input: runtimeUrl,
+			init: {
+				...input instanceof Request ? {
+					cache: input.cache,
+					credentials: input.credentials,
+					integrity: input.integrity,
+					keepalive: input.keepalive,
+					mode: input.mode,
+					redirect: input.redirect,
+					referrer: input.referrer,
+					referrerPolicy: input.referrerPolicy,
+					signal: input.signal
+				} : {},
+				...init,
+				method: "POST",
+				headers,
+				body: JSON.stringify({
+					method: "resource/request",
+					params: {
+						path: `${resourcePath}${target.search}`,
+						httpMethod: method
+					},
+					...body === void 0 ? {} : { body }
+				})
+			}
+		};
+	}
+
 //#endregion
 //#region src/core/agent-registry.ts
 /** Maximum wait for optional Inspector metadata before degrading to absence. */
@@ -1145,7 +1236,9 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			_defineProperty(this, "_runtimeMode", _copilotkit_shared.RUNTIME_MODE_SSE);
 			_defineProperty(this, "_intelligence", void 0);
 			_defineProperty(this, "_threadEndpoints", void 0);
+			_defineProperty(this, "_singleRouteResourceOperations", false);
 			_defineProperty(this, "_suggestions", void 0);
+			_defineProperty(this, "_inspectorLearning", false);
 			_defineProperty(this, "_inspectorMetadata", void 0);
 			_defineProperty(this, "_inspectorMetadataSupported", false);
 			_defineProperty(this, "inspectorMetadataRefreshReady", false);
@@ -1204,6 +1297,9 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		get suggestions() {
 			return this._suggestions;
 		}
+		get inspectorLearning() {
+			return this._inspectorLearning;
+		}
 		get inspectorMetadata() {
 			return this._inspectorMetadata;
 		}
@@ -1254,6 +1350,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			this.resetRuntimeEntitlementRetry();
 			this._licenseStatus = void 0;
 			this._runtimeEntitlements = void 0;
+			this._singleRouteResourceOperations = false;
 			this._runtimeUrl = normalizedRuntimeUrl;
 			if (options === null || options === void 0 ? void 0 : options.deferConnection) return;
 			this.updateRuntimeConnection({ preserveOnFailure: this.hasLiveRuntimeKnowledgeToProtect() });
@@ -1282,6 +1379,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			this.resetRuntimeEntitlementRetry();
 			this._requestedTransport = runtimeTransport;
 			this._runtimeTransport = runtimeTransport;
+			this._singleRouteResourceOperations = false;
 			this.updateRuntimeConnection({ preserveOnFailure: this.hasLiveRuntimeKnowledgeToProtect() });
 		}
 		hasLiveRuntimeKnowledgeToProtect() {
@@ -1455,7 +1553,8 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 				const watchdog = this.armRuntimeRequestWatchdog(meta());
 				try {
 					var _meta;
-					const response = await fetch(input, init);
+					const singleRouteRequest = this._runtimeTransport === "single" && this._singleRouteResourceOperations && this._runtimeUrl ? await createSingleRouteResourceRequest(input, init, this._runtimeUrl) : null;
+					const response = singleRouteRequest ? await fetch(singleRouteRequest.input, singleRouteRequest.init) : await fetch(input, init);
 					watchdog.clear();
 					this.handleRuntimeRequestOutcome(response.ok ? "ok" : ((_meta = meta()) === null || _meta === void 0 ? void 0 : _meta.nonCritical) ? "ignored" : "failed", watchdog.checked);
 					return response;
@@ -1606,6 +1705,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		invalidateInspectorMetadataConnection() {
 			var _this$inspectorMetada2;
 			this._inspectorMetadataSupported = false;
+			this._inspectorLearning = false;
 			this.inspectorMetadataRefreshReady = false;
 			this.inspectorMetadataConnectionGeneration += 1;
 			this.inspectorMetadataGeneration += 1;
@@ -1807,7 +1907,9 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 				this._runtimeMode = _copilotkit_shared.RUNTIME_MODE_SSE;
 				this._intelligence = void 0;
 				this._threadEndpoints = void 0;
+				this._singleRouteResourceOperations = false;
 				this._suggestions = void 0;
+				this._inspectorLearning = false;
 				this._a2uiEnabled = false;
 				this._a2uiAgents = void 0;
 				this._openGenerativeUIEnabled = false;
@@ -1826,7 +1928,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			await this.notifyRuntimeStatusChanged(CopilotKitCoreRuntimeConnectionStatus.Connecting);
 			if (!this.isCurrentRuntimeConnection(attempt)) return;
 			try {
-				var _runtimeInfoResponse$2, _runtimeInfoResponse$3, _ref, _a2uiInfo$enabled, _runtimeInfoResponse$4, _runtimeInfoResponse$5;
+				var _runtimeInfoResponse$2, _runtimeInfoResponse$3, _runtimeInfoResponse$4, _runtimeInfoResponse$5, _ref, _a2uiInfo$enabled, _runtimeInfoResponse$6, _runtimeInfoResponse$7;
 				if (inspectorMetadataConnectionGeneration !== this.inspectorMetadataConnectionGeneration) return;
 				const { runtimeInfo: runtimeInfoResponse, resolvedTransport } = (options === null || options === void 0 ? void 0 : options.recovery) ? await this.fetchRuntimeInfoWithTimeout(new AbortController(), runtimeUrl, transport) : await this.fetchRuntimeInfo(runtimeUrl, transport);
 				if (!this.isCurrentRuntimeConnection(attempt) || inspectorMetadataConnectionGeneration !== this.inspectorMetadataConnectionGeneration) return;
@@ -1878,19 +1980,21 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 				this._audioFileTranscriptionEnabled = (_runtimeInfoResponse$2 = runtimeInfoResponse.audioFileTranscriptionEnabled) !== null && _runtimeInfoResponse$2 !== void 0 ? _runtimeInfoResponse$2 : false;
 				this._runtimeMode = (_runtimeInfoResponse$3 = runtimeInfoResponse.mode) !== null && _runtimeInfoResponse$3 !== void 0 ? _runtimeInfoResponse$3 : _copilotkit_shared.RUNTIME_MODE_SSE;
 				this._intelligence = runtimeInfoResponse.intelligence;
-				this._threadEndpoints = runtimeInfoResponse.threadEndpoints;
+				this._singleRouteResourceOperations = resolvedTransport === "single" && ((_runtimeInfoResponse$4 = runtimeInfoResponse.singleRoute) === null || _runtimeInfoResponse$4 === void 0 ? void 0 : _runtimeInfoResponse$4.resourceOperations) === true;
+				this._threadEndpoints = this._singleRouteResourceOperations ? (_runtimeInfoResponse$5 = runtimeInfoResponse.singleRoute) === null || _runtimeInfoResponse$5 === void 0 ? void 0 : _runtimeInfoResponse$5.threadEndpoints : runtimeInfoResponse.threadEndpoints;
 				this._suggestions = runtimeInfoResponse.suggestions;
+				this._inspectorLearning = runtimeInfoResponse.inspectorLearning === true;
 				this._inspectorMetadataSupported = runtimeInfoResponse.inspectorMetadata === true;
 				this.inspectorMetadataRefreshReady = false;
 				if (!this._inspectorMetadataSupported) this.setInspectorMetadata(void 0);
 				const a2uiInfo = runtimeInfoResponse.a2ui;
 				this._a2uiEnabled = (_ref = (_a2uiInfo$enabled = a2uiInfo === null || a2uiInfo === void 0 ? void 0 : a2uiInfo.enabled) !== null && _a2uiInfo$enabled !== void 0 ? _a2uiInfo$enabled : runtimeInfoResponse.a2uiEnabled) !== null && _ref !== void 0 ? _ref : false;
 				this._a2uiAgents = (a2uiInfo === null || a2uiInfo === void 0 ? void 0 : a2uiInfo.enabled) ? a2uiInfo.agents : void 0;
-				this._openGenerativeUIEnabled = (_runtimeInfoResponse$4 = runtimeInfoResponse.openGenerativeUIEnabled) !== null && _runtimeInfoResponse$4 !== void 0 ? _runtimeInfoResponse$4 : false;
+				this._openGenerativeUIEnabled = (_runtimeInfoResponse$6 = runtimeInfoResponse.openGenerativeUIEnabled) !== null && _runtimeInfoResponse$6 !== void 0 ? _runtimeInfoResponse$6 : false;
 				this._licenseStatus = runtimeInfoResponse.licenseStatus;
 				this._runtimeEntitlements = runtimeInfoResponse.runtimeEntitlements;
 				this.updateRuntimeEntitlementRetry(runtimeInfoResponse.runtimeEntitlements, attempt);
-				this._telemetryDisabled = (_runtimeInfoResponse$5 = runtimeInfoResponse.telemetryDisabled) !== null && _runtimeInfoResponse$5 !== void 0 ? _runtimeInfoResponse$5 : false;
+				this._telemetryDisabled = (_runtimeInfoResponse$7 = runtimeInfoResponse.telemetryDisabled) !== null && _runtimeInfoResponse$7 !== void 0 ? _runtimeInfoResponse$7 : false;
 				await this.notifyRuntimeStatusChanged(CopilotKitCoreRuntimeConnectionStatus.Connected);
 				if (!this.isCurrentRuntimeConnection(attempt)) return;
 				await this.notifyAgentsChanged();
@@ -1913,7 +2017,9 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 					this._runtimeMode = _copilotkit_shared.RUNTIME_MODE_SSE;
 					this._intelligence = void 0;
 					this._threadEndpoints = void 0;
+					this._singleRouteResourceOperations = false;
 					this._suggestions = void 0;
+					this._inspectorLearning = false;
 					this._a2uiEnabled = false;
 					this._a2uiAgents = void 0;
 					this._openGenerativeUIEnabled = false;
@@ -2491,6 +2597,141 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		return normalizeToolResultContent(content) === FORWARDED_TO_CLIENT;
 	}
 
+//#endregion
+//#region src/core/tool-schema.ts
+/**
+	* Empty tool schema constant
+	*/
+	const EMPTY_TOOL_SCHEMA = {
+		type: "object",
+		properties: {}
+	};
+	/**
+	* Create a JSON schema from a tool's parameters
+	*/
+	function createToolSchema(tool) {
+		if (!tool.parameters) return { ...EMPTY_TOOL_SCHEMA };
+		const rawSchema = (0, _copilotkit_shared.schemaToJsonSchema)(tool.parameters, { zodToJsonSchema: (schema, options) => (0, zod_to_json_schema.zodToJsonSchema)(schema, options) });
+		if (!rawSchema || typeof rawSchema !== "object") return { ...EMPTY_TOOL_SCHEMA };
+		const { $schema: _$schema, ...schema } = rawSchema;
+		if (typeof schema.type !== "string") schema.type = "object";
+		if (typeof schema.properties !== "object" || schema.properties === null) schema.properties = {};
+		stripAdditionalProperties(schema);
+		return schema;
+	}
+	/**
+	* Remove every `additionalProperties` key from a JSON schema tree, in place.
+	* Some LLM providers reject schemas that carry it.
+	*/
+	function stripAdditionalProperties(schema) {
+		if (!schema || typeof schema !== "object") return;
+		if (Array.isArray(schema)) {
+			schema.forEach(stripAdditionalProperties);
+			return;
+		}
+		const record = schema;
+		if (record.additionalProperties !== void 0) delete record.additionalProperties;
+		for (const value of Object.values(record)) stripAdditionalProperties(value);
+	}
+
+//#endregion
+//#region src/core/webmcp.ts
+/**
+	* Return the page's `document.modelContext`, or null when WebMCP is not
+	* available (SSR, React Native, browsers without the API enabled).
+	*/
+	function getWebMCPModelContext() {
+		if (typeof document === "undefined") return null;
+		const modelContext = document.modelContext;
+		return modelContext !== null && modelContext !== void 0 ? modelContext : null;
+	}
+	/**
+	* Keeps a set of frontend tools registered on the page's WebMCP model context.
+	*
+	* `sync(desired)` reconciles the registrations with the desired set: tools that
+	* are gone (or were re-registered with a new tool object) are unregistered by
+	* aborting their registration signal, and new tools are registered with an
+	* `execute` that delegates to the frontend tool's own handler.
+	*
+	* All WebMCP-API constraints live here so callers only supply the desired set:
+	* a tool without a description is skipped with a warning (the spec rejects
+	* empty descriptions), and failures from `registerTool` (duplicate name,
+	* unsupported context, ...) are warned rather than thrown.
+	*/
+	var WebMCPRegistry = class {
+		constructor() {
+			_defineProperty(this, "entries", /* @__PURE__ */ new Map());
+			_defineProperty(this, "warnedNames", /* @__PURE__ */ new Set());
+		}
+		/** Names currently kept registered on the model context. */
+		get registeredNames() {
+			return [...this.entries.keys()];
+		}
+		/** Reconcile the registered tools with the desired set. */
+		sync(desired) {
+			const modelContext = getWebMCPModelContext();
+			if (!modelContext) return;
+			for (const [name, entry] of [...this.entries]) if (desired.get(name) !== entry.tool) {
+				entry.controller.abort();
+				this.entries.delete(name);
+			}
+			for (const [name, tool] of desired) {
+				if (this.entries.has(name)) continue;
+				if (!tool.description) {
+					this.warnOnce(name, `Skipping WebMCP registration for tool '${name}': WebMCP requires a description.`);
+					continue;
+				}
+				const controller = new AbortController();
+				this.entries.set(name, {
+					tool,
+					controller
+				});
+				modelContext.registerTool(this.buildModelContextTool(tool), { signal: controller.signal }).catch((error) => {
+					var _this$entries$get;
+					if (((_this$entries$get = this.entries.get(name)) === null || _this$entries$get === void 0 ? void 0 : _this$entries$get.controller) !== controller) return;
+					this.entries.delete(name);
+					const message = error instanceof Error ? error.message : String(error);
+					this.warnOnce(name, `WebMCP registration failed for tool '${name}': ${message}`);
+				});
+			}
+		}
+		/**
+		* Build the WebMCP model-context tool for a frontend tool. The `execute`
+		* callback delegates to the frontend tool's own handler, so a browser agent
+		* call runs the same application code as an agent call.
+		*/
+		buildModelContextTool(tool) {
+			const annotations = typeof tool.webmcp === "object" ? tool.webmcp.annotations : void 0;
+			return {
+				name: tool.name,
+				description: tool.description,
+				inputSchema: createToolSchema(tool),
+				execute: async (args, options) => {
+					if (!tool.handler) return "";
+					const toolCall = {
+						id: (0, _copilotkit_shared.randomUUID)(),
+						type: "function",
+						function: {
+							name: tool.name,
+							arguments: JSON.stringify(args !== null && args !== void 0 ? args : {})
+						}
+					};
+					return await tool.handler(args, {
+						toolCall,
+						signal: options === null || options === void 0 ? void 0 : options.signal
+					});
+				},
+				...annotations ? { annotations } : {}
+			};
+		}
+		/** Log `message` once per tool name. Repeated syncs must not spam the log. */
+		warnOnce(name, message) {
+			if (this.warnedNames.has(name)) return;
+			this.warnedNames.add(name);
+			_copilotkit_shared.logger.warn(`[CopilotKit] ${message}`);
+		}
+	};
+
 //#endregion
 //#region src/core/run-handler.ts
 /**
@@ -2527,6 +2768,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			_defineProperty(this, "_disabledToolKeys", /* @__PURE__ */ new Set());
 			_defineProperty(this, "_runAbortController", null);
 			_defineProperty(this, "_runDepth", 0);
+			_defineProperty(this, "_webmcpRegistry", new WebMCPRegistry());
 			_defineProperty(this, "_lastConnectedThreadIdsByAgent", /* @__PURE__ */ new Map());
 			_defineProperty(this, "_anonymousAgentIds", /* @__PURE__ */ new WeakMap());
 			_defineProperty(this, "_nextAnonymousAgentId", 0);
@@ -2581,6 +2823,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		initialize(tools) {
 			this._propTools = [...tools];
 			this._cachedMergedTools = null;
+			this.syncWebMCP();
 		}
 		/**
 		* Add a tool to the registry. Survives provider re-syncs ({@link setTools}),
@@ -2594,6 +2837,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			}
 			this._hookTools.set(key, tool);
 			this._cachedMergedTools = null;
+			this.syncWebMCP();
 		}
 		/**
 		* Remove a tool by name and optionally by agentId
@@ -2605,6 +2849,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 				return !(tool.name === id && !tool.agentId);
 			});
 			this._cachedMergedTools = null;
+			this.syncWebMCP();
 		}
 		/**
 		* Get a tool by name and optionally by agentId.
@@ -2627,6 +2872,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		setTools(tools) {
 			this._propTools = [...tools];
 			this._cachedMergedTools = null;
+			this.syncWebMCP();
 		}
 		/**
 		* Return the registered A2UI catalog components (readonly).
@@ -3172,6 +3418,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			const key = this.capabilityKey(name, agentId);
 			if (enabled) this._disabledToolKeys.delete(key);
 			else this._disabledToolKeys.add(key);
+			this.syncWebMCP();
 		}
 		/** Whether a tool is currently enabled (not overridden off). Defaults true. */
 		isToolEnabled(name, agentId) {
@@ -3191,6 +3438,32 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			});
 		}
 		/**
+		* Reconcile the WebMCP registrations with the current tool registry. Tools
+		* opt in via `webmcp: true` or `webmcp: { annotations }`; the same
+		* availability rules as `buildFrontendTools` apply. WebMCP tools are
+		* page-level, so unlike the agent tool list they are not filtered by
+		* agentId — a name collision across agentIds keeps the first registration.
+		*/
+		syncWebMCP() {
+			const desired = /* @__PURE__ */ new Map();
+			const warnedCollisions = /* @__PURE__ */ new Set();
+			for (const tool of this.tools) {
+				if (!tool.webmcp) continue;
+				if (tool.name === WILDCARD_TOOL_NAME) continue;
+				if (tool.available === false || tool.available === "disabled") continue;
+				if (!this.isToolEnabled(tool.name, tool.agentId)) continue;
+				if (desired.has(tool.name)) {
+					if (!warnedCollisions.has(tool.name)) {
+						warnedCollisions.add(tool.name);
+						_copilotkit_shared.logger.warn(`[CopilotKit] Multiple WebMCP tools share the name '${tool.name}'. Only the first registration is exposed to browser agents.`);
+					}
+					continue;
+				}
+				desired.set(tool.name, tool);
+			}
+			this._webmcpRegistry.sync(desired);
+		}
+		/**
 		* Create an agent error subscriber
 		*/
 		createAgentErrorSubscriber(agent) {
@@ -3224,36 +3497,6 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		}
 	};
 	/**
-	* Empty tool schema constant
-	*/
-	const EMPTY_TOOL_SCHEMA = {
-		type: "object",
-		properties: {}
-	};
-	/**
-	* Create a JSON schema from a tool's parameters
-	*/
-	function createToolSchema(tool) {
-		if (!tool.parameters) return { ...EMPTY_TOOL_SCHEMA };
-		const rawSchema = (0, _copilotkit_shared.schemaToJsonSchema)(tool.parameters, { zodToJsonSchema: (schema, options) => (0, zod_to_json_schema.zodToJsonSchema)(schema, options) });
-		if (!rawSchema || typeof rawSchema !== "object") return { ...EMPTY_TOOL_SCHEMA };
-		const { $schema: _$schema, ...schema } = rawSchema;
-		if (typeof schema.type !== "string") schema.type = "object";
-		if (typeof schema.properties !== "object" || schema.properties === null) schema.properties = {};
-		stripAdditionalProperties(schema);
-		return schema;
-	}
-	function stripAdditionalProperties(schema) {
-		if (!schema || typeof schema !== "object") return;
-		if (Array.isArray(schema)) {
-			schema.forEach(stripAdditionalProperties);
-			return;
-		}
-		const record = schema;
-		if (record.additionalProperties !== void 0) delete record.additionalProperties;
-		for (const value of Object.values(record)) stripAdditionalProperties(value);
-	}
-	/**
 	* Ensures parsed tool arguments are a plain object.
 	* Throws for non-object values so the caller's catch block can emit
 	* a structured TOOL_ARGUMENT_PARSE_FAILED error.
@@ -4319,8 +4562,24 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 	*/
 	const selectMemoriesRealtimeStatus = createSelector((state) => state.realtimeStatus);
 	const MEMORY_METADATA_EVENT = "memory_metadata";
+	/** Runs a memory request through the injected fetch and aborts on unsubscribe. */
 	function memoryFromFetch(input, init) {
-		return (0, rxjs_fetch.fromFetch)(input, init);
+		const { selector, fetch: fetchImplementation, signal: outerSignal, ...requestInit } = init;
+		return new rxjs.Observable((subscriber) => {
+			const controller = new AbortController();
+			const abort = () => controller.abort();
+			if (outerSignal === null || outerSignal === void 0 ? void 0 : outerSignal.aborted) controller.abort();
+			else outerSignal === null || outerSignal === void 0 || outerSignal.addEventListener("abort", abort);
+			const subscription = (0, rxjs.from)(fetchImplementation(input, {
+				...requestInit,
+				signal: controller.signal
+			})).pipe((0, rxjs_operators.mergeMap)((response) => (0, rxjs.from)(selector(response)))).subscribe(subscriber);
+			return () => {
+				outerSignal === null || outerSignal === void 0 || outerSignal.removeEventListener("abort", abort);
+				controller.abort();
+				subscription.unsubscribe();
+			};
+		});
 	}
 	/**
 	* Fetches the memory snapshot and maps it to a success/failure action. Both
@@ -5074,6 +5333,10 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		get suggestions() {
 			return this.agentRegistry.suggestions;
 		}
+		/** Whether the connected Runtime exposes debug-authorized Learning data. */
+		get inspectorLearning() {
+			return this.agentRegistry.inspectorLearning;
+		}
 		/** Trusted, optional metadata advertised by the connected runtime. */
 		get inspectorMetadata() {
 			return this.agentRegistry.inspectorMetadata;
@@ -5269,12 +5532,12 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		/**
 		* Lazily creates, starts, and context-syncs the core-owned memory store on
 		* first access, then returns it. Subsequent calls return the existing store.
-		* The store is constructed with a bound `globalThis.fetch` and immediately
-		* has its runtime context synced from the current connection state.
+		* The store uses the Core Runtime fetch so REST and single-route transports
+		* share the same resource behavior. Its Runtime context is synced at once.
 		*/
 		ensureMemoryStore() {
 			if (!this._memoryStore) {
-				this._memoryStore = createMemoryStore({ fetch: globalThis.fetch.bind(globalThis) });
+				this._memoryStore = createMemoryStore({ fetch: this.ɵruntimeFetch });
 				this._memoryStore.start();
 				this.syncMemoryContext();
 			}
@@ -6781,6 +7044,7 @@ exports.RunHandler = RunHandler;
 exports.StateManager = StateManager;
 exports.SuggestionEngine = SuggestionEngine;
 exports.ToolCallStatus = ToolCallStatus;
+exports.WebMCPRegistry = WebMCPRegistry;
 exports.completePartialMarkdown = completePartialMarkdown;
 exports.createActionGroup = createActionGroup;
 exports.createEffect = createEffect;
@@ -6794,6 +7058,7 @@ exports.emitInspectorViewThread = emitInspectorViewThread;
 exports.emitInspectorViewThreadResult = emitInspectorViewThreadResult;
 exports.empty = empty;
 exports.ensureObjectArgs = ensureObjectArgs;
+exports.getWebMCPModelContext = getWebMCPModelContext;
 exports.isAbortError = isAbortError;
 exports.isInspectorThreadBridgeEnabled = isInspectorThreadBridgeEnabled;
 exports.isRunCompletionAware = isRunCompletionAware;