@copilotkit/core 1.72.0 → 1.73.0

package/dist/index.umd.js

@@ -751,11 +751,11 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 	var _ProxiedCopilotRuntimeAgent_brand = /* @__PURE__ */ new WeakSet();
 	var ProxiedCopilotRuntimeAgent = class ProxiedCopilotRuntimeAgent extends _ag_ui_client.HttpAgent {
 		constructor(config) {
-			var _config$transport, _ref, _config$runtimeAgentI, _ref2, _config$runtimeMode;
+			var _config$transport, _ref, _config$runtimeAgentI, _config$runtimeUrl, _config$runtimeMode;
 			const normalizedRuntimeUrl = config.runtimeUrl ? config.runtimeUrl.replace(/\/$/, "") : void 0;
 			const transport = (_config$transport = config.transport) !== null && _config$transport !== void 0 ? _config$transport : "auto";
 			const routedId = (_ref = (_config$runtimeAgentI = config.runtimeAgentId) !== null && _config$runtimeAgentI !== void 0 ? _config$runtimeAgentI : config.agentId) !== null && _ref !== void 0 ? _ref : "";
-			const runUrl = transport === "single" ? (_ref2 = normalizedRuntimeUrl !== null && normalizedRuntimeUrl !== void 0 ? normalizedRuntimeUrl : config.runtimeUrl) !== null && _ref2 !== void 0 ? _ref2 : "" : `${normalizedRuntimeUrl !== null && normalizedRuntimeUrl !== void 0 ? normalizedRuntimeUrl : config.runtimeUrl}/agent/${encodeURIComponent(routedId)}/run`;
+			const runUrl = transport === "single" ? (_config$runtimeUrl = config.runtimeUrl) !== null && _config$runtimeUrl !== void 0 ? _config$runtimeUrl : "" : `${normalizedRuntimeUrl !== null && normalizedRuntimeUrl !== void 0 ? normalizedRuntimeUrl : config.runtimeUrl}/agent/${encodeURIComponent(routedId)}/run`;
 			if (!runUrl) throw new Error("ProxiedCopilotRuntimeAgent requires a runtimeUrl when transport is set to 'single'.");
 			super({
 				...config,
@@ -766,6 +766,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			_defineProperty(this, "credentials", void 0);
 			_defineProperty(this, "runtimeAgentId", void 0);
 			_defineProperty(this, "transport", void 0);
+			_defineProperty(this, "runtimeEndpointUrl", void 0);
 			_defineProperty(this, "singleEndpointUrl", void 0);
 			_defineProperty(this, "runtimeMode", void 0);
 			_defineProperty(this, "intelligence", void 0);
@@ -773,6 +774,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			_defineProperty(this, "delegate", void 0);
 			_defineProperty(this, "runtimeInfoPromise", void 0);
 			this.runtimeUrl = normalizedRuntimeUrl !== null && normalizedRuntimeUrl !== void 0 ? normalizedRuntimeUrl : config.runtimeUrl;
+			this.runtimeEndpointUrl = config.runtimeUrl;
 			this.credentials = config.credentials;
 			this.runtimeAgentId = config.runtimeAgentId;
 			this.transport = transport;
@@ -780,7 +782,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			this.intelligence = config.intelligence;
 			this._capabilities = config.capabilities;
 			if (config.debug) this.debug = config.debug;
-			if (this.transport === "single") this.singleEndpointUrl = this.runtimeUrl;
+			if (this.transport === "single") this.singleEndpointUrl = this.runtimeEndpointUrl;
 		}
 		/**
 		* The agent id used for outbound runtime requests — `runtimeAgentId` when
@@ -911,8 +913,9 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			return _assertClassBrand(_ProxiedCopilotRuntimeAgent_brand, this, _runViaHttp).call(this, input);
 		}
 		clone() {
+			var _this$runtimeEndpoint;
 			const cloned = new ProxiedCopilotRuntimeAgent({
-				runtimeUrl: this.runtimeUrl,
+				runtimeUrl: (_this$runtimeEndpoint = this.runtimeEndpointUrl) !== null && _this$runtimeEndpoint !== void 0 ? _this$runtimeEndpoint : this.runtimeUrl,
 				agentId: this.agentId,
 				runtimeAgentId: this.runtimeAgentId,
 				description: this.description,
@@ -988,7 +991,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			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;
+				url = this.singleEndpointUrl;
 				init = {
 					method: "POST",
 					body: JSON.stringify({ method: "info" })
@@ -1006,6 +1009,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			return await response.json();
 		}
 		async fetchRuntimeInfoAutoDetect(headers) {
+			var _this$runtimeEndpoint2;
 			try {
 				const response = await this.fetch(`${this.runtimeUrl}/info`, {
 					headers: { ...headers },
@@ -1018,7 +1022,8 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			} catch (_unused) {}
 			const singleHeaders = { ...headers };
 			if (!singleHeaders["Content-Type"]) singleHeaders["Content-Type"] = "application/json";
-			const response = await this.fetch(this.runtimeUrl, {
+			const endpointUrl = (_this$runtimeEndpoint2 = this.runtimeEndpointUrl) !== null && _this$runtimeEndpoint2 !== void 0 ? _this$runtimeEndpoint2 : this.runtimeUrl;
+			const response = await this.fetch(endpointUrl, {
 				method: "POST",
 				headers: singleHeaders,
 				body: JSON.stringify({ method: "info" }),
@@ -1026,7 +1031,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			});
 			if (!response.ok) throw await runtimeInfoError(response);
 			this.transport = "single";
-			this.singleEndpointUrl = this.runtimeUrl;
+			this.singleEndpointUrl = endpointUrl;
 			return await response.json();
 		}
 		createSingleRouteRequestInit(input, method, params) {
@@ -1223,6 +1228,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			_defineProperty(this, "remoteAgents", {});
 			_defineProperty(this, "mintedThreadIds", /* @__PURE__ */ new WeakMap());
 			_defineProperty(this, "_runtimeUrl", void 0);
+			_defineProperty(this, "_runtimeEndpointUrl", void 0);
 			_defineProperty(this, "_connectionInFlight", void 0);
 			_defineProperty(this, "_runtimeConnectionGeneration", 0);
 			_defineProperty(this, "_activeRuntimeConnectionAttempt", void 0);
@@ -1345,7 +1351,8 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		*/
 		setRuntimeUrl(runtimeUrl, options) {
 			const normalizedRuntimeUrl = runtimeUrl ? runtimeUrl.replace(/\/$/, "") : void 0;
-			if (this._runtimeUrl === normalizedRuntimeUrl) return;
+			const runtimeEndpointUrl = runtimeUrl || void 0;
+			if (this._runtimeUrl === normalizedRuntimeUrl && this._runtimeEndpointUrl === runtimeEndpointUrl) return;
 			this.invalidateInspectorMetadataConnection();
 			this.abandonRuntimeHealthProbe();
 			this.resetRuntimeEntitlementRetry();
@@ -1353,6 +1360,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			this._runtimeEntitlements = void 0;
 			this._singleRouteResourceOperations = false;
 			this._runtimeUrl = normalizedRuntimeUrl;
+			this._runtimeEndpointUrl = runtimeEndpointUrl;
 			if (options === null || options === void 0 ? void 0 : options.deferConnection) return;
 			this.updateRuntimeConnection({ preserveOnFailure: this.hasLiveRuntimeKnowledgeToProtect() });
 		}
@@ -1468,11 +1476,12 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		* from the registry and emits `onAgentsChanged`.
 		*/
 		registerProxiedAgent({ agentId, runtimeAgentId }) {
+			var _this$_runtimeEndpoin;
 			if (Object.prototype.hasOwnProperty.call(this._agents, agentId)) throw new Error(`CopilotKitCore.registerProxiedAgent: agentId "${agentId}" is already registered. Pick a different agentId, or unregister the existing agent first.`);
 			const friends = this.core;
 			const debug = friends.debug;
 			const agent = new ProxiedCopilotRuntimeAgent({
-				runtimeUrl: this._runtimeUrl,
+				runtimeUrl: (_this$_runtimeEndpoin = this._runtimeEndpointUrl) !== null && _this$_runtimeEndpoin !== void 0 ? _this$_runtimeEndpoin : this._runtimeUrl,
 				agentId,
 				runtimeAgentId,
 				transport: this._runtimeTransport,
@@ -1553,8 +1562,8 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 				const meta = () => runtimeRequestMeta(init);
 				const watchdog = this.armRuntimeRequestWatchdog(meta());
 				try {
-					var _meta;
-					const singleRouteRequest = this._runtimeTransport === "single" && this._singleRouteResourceOperations && this._runtimeUrl ? await createSingleRouteResourceRequest(input, init, this._runtimeUrl) : null;
+					var _this$_runtimeEndpoin2, _meta;
+					const singleRouteRequest = this._runtimeTransport === "single" && this._singleRouteResourceOperations && this._runtimeUrl ? await createSingleRouteResourceRequest(input, init, (_this$_runtimeEndpoin2 = this._runtimeEndpointUrl) !== null && _this$_runtimeEndpoin2 !== void 0 ? _this$_runtimeEndpoin2 : 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);
@@ -1646,7 +1655,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			try {
 				const request = (async () => {
 					const response = resolvedTransport === "single" ? await this.fetchInspectorMetadataSingle({
-						runtimeUrl,
+						runtimeUrl: this.singleEndpointUrlFor(runtimeUrl),
 						headers,
 						credentials,
 						signal: abortController.signal
@@ -1845,14 +1854,14 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		}
 		/** Return the stable key that scopes connection and entitlement retries. */
 		runtimeConnectionKey() {
-			var _this$_runtimeUrl;
-			return `${(_this$_runtimeUrl = this._runtimeUrl) !== null && _this$_runtimeUrl !== void 0 ? _this$_runtimeUrl : ""}::${this._requestedTransport}`;
+			var _ref, _this$_runtimeEndpoin3;
+			return `${(_ref = (_this$_runtimeEndpoin3 = this._runtimeEndpointUrl) !== null && _this$_runtimeEndpoin3 !== void 0 ? _this$_runtimeEndpoin3 : this._runtimeUrl) !== null && _ref !== void 0 ? _ref : ""}::${this._requestedTransport}`;
 		}
 		/** Return whether a proxy still targets this Runtime connection. */
 		canReuseRuntimeAgent(agent, runtimeUrl, transport) {
 			if (!runtimeUrl) return false;
 			const connection = this.remoteAgentConnections.get(agent);
-			return (connection === null || connection === void 0 ? void 0 : connection.runtimeUrl) === runtimeUrl.replace(/\/$/, "") && connection.transport === transport;
+			return (connection === null || connection === void 0 ? void 0 : connection.runtimeUrl) === runtimeUrl.replace(/\/$/, "") && connection.endpointUrl === this._runtimeEndpointUrl && connection.transport === transport;
 		}
 		/** Return whether an async attempt still owns the active Runtime state. */
 		isCurrentRuntimeConnection(attempt) {
@@ -1929,7 +1938,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			await this.notifyRuntimeStatusChanged(CopilotKitCoreRuntimeConnectionStatus.Connecting);
 			if (!this.isCurrentRuntimeConnection(attempt)) return;
 			try {
-				var _runtimeInfoResponse$2, _runtimeInfoResponse$3, _runtimeInfoResponse$4, _runtimeInfoResponse$5, _ref, _a2uiInfo$enabled, _runtimeInfoResponse$6, _runtimeInfoResponse$7;
+				var _runtimeInfoResponse$2, _runtimeInfoResponse$3, _runtimeInfoResponse$4, _runtimeInfoResponse$5, _ref2, _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;
@@ -1938,7 +1947,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 				const credentials = this.core.credentials;
 				const rawDebug = this.core.debug;
 				const agents = Object.fromEntries(Object.entries(runtimeInfo.agents).map(([id, { description, capabilities }]) => {
-					var _runtimeInfoResponse$;
+					var _this$_runtimeEndpoin4, _runtimeInfoResponse$;
 					const existing = Object.prototype.hasOwnProperty.call(this.remoteAgents, id) ? this.remoteAgents[id] : void 0;
 					if (existing instanceof ProxiedCopilotRuntimeAgent && this.canReuseRuntimeAgent(existing, runtimeUrl, this._runtimeTransport)) {
 						this.applyHeadersToAgent(existing);
@@ -1947,7 +1956,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 						return [id, existing];
 					}
 					const agent = new ProxiedCopilotRuntimeAgent({
-						runtimeUrl,
+						runtimeUrl: (_this$_runtimeEndpoin4 = this._runtimeEndpointUrl) !== null && _this$_runtimeEndpoin4 !== void 0 ? _this$_runtimeEndpoin4 : runtimeUrl,
 						agentId: id,
 						description,
 						transport: this._runtimeTransport,
@@ -1967,6 +1976,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 					}
 					this.remoteAgentConnections.set(agent, {
 						runtimeUrl,
+						endpointUrl: this._runtimeEndpointUrl,
 						transport: this._runtimeTransport
 					});
 					return [id, agent];
@@ -1989,7 +1999,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 				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._a2uiEnabled = (_ref2 = (_a2uiInfo$enabled = a2uiInfo === null || a2uiInfo === void 0 ? void 0 : a2uiInfo.enabled) !== null && _a2uiInfo$enabled !== void 0 ? _a2uiInfo$enabled : runtimeInfoResponse.a2uiEnabled) !== null && _ref2 !== void 0 ? _ref2 : false;
 				this._a2uiAgents = (a2uiInfo === null || a2uiInfo === void 0 ? void 0 : a2uiInfo.enabled) ? a2uiInfo.agents : void 0;
 				this._openGenerativeUIEnabled = (_runtimeInfoResponse$6 = runtimeInfoResponse.openGenerativeUIEnabled) !== null && _runtimeInfoResponse$6 !== void 0 ? _runtimeInfoResponse$6 : false;
 				this._licenseStatus = runtimeInfoResponse.licenseStatus;
@@ -2048,7 +2058,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			const credentials = this.core.credentials;
 			const headers = { ...baseHeaders };
 			if (runtimeTransport === "single") return {
-				runtimeInfo: await this.fetchRuntimeInfoSingle(runtimeUrl, headers, credentials, signal),
+				runtimeInfo: await this.fetchRuntimeInfoSingle(this.singleEndpointUrlFor(runtimeUrl), headers, credentials, signal),
 				resolvedTransport: "single"
 			};
 			if (runtimeTransport === "auto") return this.fetchRuntimeInfoAutoDetect(runtimeUrl, headers, credentials, signal);
@@ -2063,6 +2073,15 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 				resolvedTransport: "rest"
 			};
 		}
+		/**
+		* The URL a single-route request targets: the runtime URL as the caller
+		* supplied it. `runtimeUrl` is the slash-stripped form used for path joins;
+		* a trailing slash can select a different proxy location, so the endpoint
+		* itself keeps it.
+		*/
+		singleEndpointUrlFor(runtimeUrl) {
+			return this._runtimeEndpointUrl !== void 0 && this._runtimeUrl === runtimeUrl ? this._runtimeEndpointUrl : runtimeUrl;
+		}
 		async fetchRuntimeInfoSingle(runtimeUrl, headers, credentials, signal) {
 			const response = await fetch(runtimeUrl, {
 				method: "POST",
@@ -2092,7 +2111,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 				};
 			} catch (_unused2) {}
 			return {
-				runtimeInfo: await this.fetchRuntimeInfoSingle(runtimeUrl, { ...headers }, credentials, signal),
+				runtimeInfo: await this.fetchRuntimeInfoSingle(this.singleEndpointUrlFor(runtimeUrl), { ...headers }, credentials, signal),
 				resolvedTransport: "single"
 			};
 		}
@@ -2767,6 +2786,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			_defineProperty(this, "_catalogComponents", []);
 			_defineProperty(this, "_disabledCatalogComponents", /* @__PURE__ */ new Set());
 			_defineProperty(this, "_disabledToolKeys", /* @__PURE__ */ new Set());
+			_defineProperty(this, "_warnedMissingToolParameters", /* @__PURE__ */ new Set());
 			_defineProperty(this, "_runAbortController", null);
 			_defineProperty(this, "_runDepth", 0);
 			_defineProperty(this, "_webmcpRegistry", new WebMCPRegistry());
@@ -2824,6 +2844,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		initialize(tools) {
 			this._propTools = [...tools];
 			this._cachedMergedTools = null;
+			this.warnOnMissingToolParameters(this._propTools);
 			this.syncWebMCP();
 		}
 		/**
@@ -2838,9 +2859,39 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			}
 			this._hookTools.set(key, tool);
 			this._cachedMergedTools = null;
+			this.warnOnMissingToolParameters([tool]);
 			this.syncWebMCP();
 		}
 		/**
+		* Report, once per tool and at development time only, a tool registered with
+		* no `parameters` schema.
+		*
+		* `createToolSchema` substitutes `{ type: "object", properties: {} }` for a
+		* missing `parameters` and returns silently, and `parameters` is optional on
+		* `FrontendTool`, so nothing — not the compiler, not the runtime — tells the
+		* developer that the model was handed a tool with nothing to fill in. It then
+		* calls the tool with no arguments. `useComponent`, `useFrontendTool` and
+		* `useHumanInTheLoop` all funnel into {@link addTool}; the provider's `tools`
+		* prop funnels into {@link initialize} and {@link setTools}.
+		*
+		* A parameterless tool is legitimate (a HITL confirm dialog, say), so this
+		* stays a warning rather than an error. An explicit empty schema
+		* (`parameters: z.object({})`) is the way to say "takes none on purpose": it
+		* satisfies the check below and `createToolSchema` reduces it to the same
+		* advertised `{ type: "object", properties: {} }` that omitting `parameters`
+		* produces, so silencing the warning costs nothing on the wire.
+		*/
+		warnOnMissingToolParameters(tools) {
+			if (process.env.NODE_ENV === "production") return;
+			for (const tool of tools) {
+				if (tool.parameters) continue;
+				const key = this.capabilityKey(tool.name, tool.agentId);
+				if (this._warnedMissingToolParameters.has(key)) continue;
+				this._warnedMissingToolParameters.add(key);
+				_copilotkit_shared.logger.warn(`Tool has no parameters schema: '${tool.name}' for agent '${tool.agentId || "global"}'. The model is told it takes no arguments and will call it with none. Add \`parameters\` (a Zod or Standard Schema object) if it should receive arguments, or \`parameters: z.object({})\` to declare that it takes none and silence this warning.`);
+			}
+		}
+		/**
 		* Remove a tool by name and optionally by agentId
 		*/
 		removeTool(id, agentId) {
@@ -2873,6 +2924,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		setTools(tools) {
 			this._propTools = [...tools];
 			this._cachedMergedTools = null;
+			this.warnOnMissingToolParameters(this._propTools);
 			this.syncWebMCP();
 		}
 		/**