@copilotkit/core 1.70.0 → 1.70.2

package/dist/index.cjs

@@ -6,8 +6,84 @@ let rxjs = require("rxjs");
 let rxjs_operators = require("rxjs/operators");
 let phoenix = require("phoenix");
 let zod_to_json_schema = require("zod-to-json-schema");
-let rxjs_fetch = require("rxjs/fetch");
 
+//#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 {
+		agent.isRunning = true;
+		agent.agentId = 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 ?? {}
+		];
+		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?.();
+			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.
@@ -204,72 +280,22 @@ var IntelligenceAgent = class IntelligenceAgent extends _ag_ui_client.AbstractAg
 	/**
 	* 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 {
-			this.isRunning = true;
-			this.agentId = this.agentId ?? (0, _ag_ui_client.randomUUID)();
-			const effectiveParameters = 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 ?? {}
-			];
-			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?.();
-				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?.runId || !this.canonicalRunId ? parameters : {
+			...parameters,
+			runId: this.canonicalRunId
+		};
+		return ɵconnectWithoutEventVerification(this, effectiveParameters, subscriber);
 	}
 	abortRun() {
 		if (this.activeChannel && this.canonicalRunId) {
@@ -361,13 +387,7 @@ var IntelligenceAgent = class IntelligenceAgent extends _ag_ui_client.AbstractAg
 						...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 } : {}
@@ -734,7 +754,7 @@ var ProxiedCopilotRuntimeAgent = class ProxiedCopilotRuntimeAgent extends _ag_ui
 		});
 	}
 	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;
@@ -986,6 +1006,74 @@ function runtimeRequestMeta(init) {
 	return 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) {
+	if (method === "GET" || method === "HEAD") return void 0;
+	let text;
+	if (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("content-type")?.toLowerCase().includes("application/json")) try {
+		return JSON.parse(text);
+	} catch {
+		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) {
+	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 ?? (input instanceof Request ? input.method : "GET")).toUpperCase();
+	const headers = new Headers(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. */
@@ -1027,7 +1115,9 @@ var AgentRegistry = class {
 	_runtimeMode = _copilotkit_shared.RUNTIME_MODE_SSE;
 	_intelligence;
 	_threadEndpoints;
+	_singleRouteResourceOperations = false;
 	_suggestions;
+	_inspectorLearning = false;
 	_inspectorMetadata;
 	_inspectorMetadataSupported = false;
 	inspectorMetadataRefreshReady = false;
@@ -1098,6 +1188,9 @@ var AgentRegistry = class {
 	get suggestions() {
 		return this._suggestions;
 	}
+	get inspectorLearning() {
+		return this._inspectorLearning;
+	}
 	get inspectorMetadata() {
 		return this._inspectorMetadata;
 	}
@@ -1148,6 +1241,7 @@ var AgentRegistry = class {
 		this.resetRuntimeEntitlementRetry();
 		this._licenseStatus = void 0;
 		this._runtimeEntitlements = void 0;
+		this._singleRouteResourceOperations = false;
 		this._runtimeUrl = normalizedRuntimeUrl;
 		if (options?.deferConnection) return;
 		this.updateRuntimeConnection({ preserveOnFailure: this.hasLiveRuntimeKnowledgeToProtect() });
@@ -1176,6 +1270,7 @@ var AgentRegistry = class {
 		this.resetRuntimeEntitlementRetry();
 		this._requestedTransport = runtimeTransport;
 		this._runtimeTransport = runtimeTransport;
+		this._singleRouteResourceOperations = false;
 		this.updateRuntimeConnection({ preserveOnFailure: this.hasLiveRuntimeKnowledgeToProtect() });
 	}
 	hasLiveRuntimeKnowledgeToProtect() {
@@ -1347,7 +1442,8 @@ var AgentRegistry = class {
 			const meta = () => runtimeRequestMeta(init);
 			const watchdog = this.armRuntimeRequestWatchdog(meta());
 			try {
-				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()?.nonCritical ? "ignored" : "failed", watchdog.checked);
 				return response;
@@ -1496,6 +1592,7 @@ var AgentRegistry = class {
 	}
 	invalidateInspectorMetadataConnection() {
 		this._inspectorMetadataSupported = false;
+		this._inspectorLearning = false;
 		this.inspectorMetadataRefreshReady = false;
 		this.inspectorMetadataConnectionGeneration += 1;
 		this.inspectorMetadataGeneration += 1;
@@ -1694,7 +1791,9 @@ var AgentRegistry = class {
 			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;
@@ -1763,8 +1862,10 @@ var AgentRegistry = class {
 			this._audioFileTranscriptionEnabled = runtimeInfoResponse.audioFileTranscriptionEnabled ?? false;
 			this._runtimeMode = runtimeInfoResponse.mode ?? _copilotkit_shared.RUNTIME_MODE_SSE;
 			this._intelligence = runtimeInfoResponse.intelligence;
-			this._threadEndpoints = runtimeInfoResponse.threadEndpoints;
+			this._singleRouteResourceOperations = resolvedTransport === "single" && runtimeInfoResponse.singleRoute?.resourceOperations === true;
+			this._threadEndpoints = this._singleRouteResourceOperations ? runtimeInfoResponse.singleRoute?.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);
@@ -1798,7 +1899,9 @@ var AgentRegistry = class {
 				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;
@@ -2343,6 +2446,137 @@ function isForwardedToClientPlaceholder(content) {
 	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;
+	return document.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 {
+	entries = /* @__PURE__ */ new Map();
+	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) => {
+				if (this.entries.get(name)?.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 ?? {})
+					}
+				};
+				return await tool.handler(args, {
+					toolCall,
+					signal: 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
 /**
@@ -2425,6 +2659,12 @@ var RunHandler = class {
 	*/
 	_runDepth = 0;
 	/**
+	* Keeps tools that opt in via `webmcp` registered on the page's WebMCP model
+	* context (`document.modelContext`), in addition to the normal agent
+	* registration. Reconciled on every tool registry mutation.
+	*/
+	_webmcpRegistry = new WebMCPRegistry();
+	/**
 	* Tracks the threadId of the most recent `connectAgent` call so we
 	* can distinguish a fresh thread restore (different threadId than
 	* last time — chat is rebuilding state from scratch, must clear
@@ -2495,6 +2735,7 @@ var RunHandler = class {
 	initialize(tools) {
 		this._propTools = [...tools];
 		this._cachedMergedTools = null;
+		this.syncWebMCP();
 	}
 	/**
 	* Add a tool to the registry. Survives provider re-syncs ({@link setTools}),
@@ -2508,6 +2749,7 @@ var RunHandler = class {
 		}
 		this._hookTools.set(key, tool);
 		this._cachedMergedTools = null;
+		this.syncWebMCP();
 	}
 	/**
 	* Remove a tool by name and optionally by agentId
@@ -2519,6 +2761,7 @@ var RunHandler = class {
 			return !(tool.name === id && !tool.agentId);
 		});
 		this._cachedMergedTools = null;
+		this.syncWebMCP();
 	}
 	/**
 	* Get a tool by name and optionally by agentId.
@@ -2541,6 +2784,7 @@ var RunHandler = class {
 	setTools(tools) {
 		this._propTools = [...tools];
 		this._cachedMergedTools = null;
+		this.syncWebMCP();
 	}
 	/**
 	* Return the registered A2UI catalog components (readonly).
@@ -3062,6 +3306,7 @@ var RunHandler = class {
 		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) {
@@ -3078,6 +3323,32 @@ var RunHandler = class {
 		}));
 	}
 	/**
+	* 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) {
@@ -3110,36 +3381,6 @@ var RunHandler = class {
 	}
 };
 /**
-* 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.
@@ -4162,8 +4403,24 @@ const selectMemoriesAvailable = createSelector((state) => state.available);
 */
 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?.aborted) controller.abort();
+		else 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?.removeEventListener("abort", abort);
+			controller.abort();
+			subscription.unsubscribe();
+		};
+	});
 }
 /**
 * Fetches the memory snapshot and maps it to a success/failure action. Both
@@ -4921,6 +5178,10 @@ var CopilotKitCore = class {
 	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;
@@ -5110,12 +5371,12 @@ var CopilotKitCore = class {
 	/**
 	* 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();
 		}
@@ -6568,6 +6829,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;
@@ -6581,6 +6843,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;