@copilotkit/core 1.64.2-canary.1785346263 → 1.64.2-canary.rc-1

package/dist/index.umd.js

@@ -1911,6 +1911,9 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		constructor(core) {
 			this.core = core;
 			_defineProperty(this, "_tools", []);
+			_defineProperty(this, "_catalogComponents", []);
+			_defineProperty(this, "_disabledCatalogComponents", /* @__PURE__ */ new Set());
+			_defineProperty(this, "_disabledToolKeys", /* @__PURE__ */ new Set());
 			_defineProperty(this, "_runAbortController", null);
 			_defineProperty(this, "_runDepth", 0);
 			_defineProperty(this, "_lastConnectedThreadIdsByAgent", /* @__PURE__ */ new Map());
@@ -1998,6 +2001,32 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			this._tools = [...tools];
 		}
 		/**
+		* Return the registered A2UI catalog components (readonly).
+		*/
+		get catalogComponents() {
+			return this._catalogComponents;
+		}
+		/**
+		* Replace the registered catalog component list. Preserves the disabled set
+		* (by name) so re-registration does not re-enable disabled components.
+		*/
+		setCatalogComponents(components) {
+			this._catalogComponents = [...components];
+		}
+		/**
+		* Enable or disable a catalog component by name.
+		*/
+		setCatalogComponentEnabled(name, enabled) {
+			if (enabled) this._disabledCatalogComponents.delete(name);
+			else this._disabledCatalogComponents.add(name);
+		}
+		/**
+		* Whether a catalog component is enabled. Unknown names default to enabled.
+		*/
+		isCatalogComponentEnabled(name) {
+			return !this._disabledCatalogComponents.has(name);
+		}
+		/**
 		* Connect an agent (establish initial connection)
 		*/
 		async connectAgent({ agent }) {
@@ -2485,11 +2514,30 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 				error: handlerResult.error
 			};
 		}
+		/** Stable identity for a tool override: agent-scope + name (NUL-separated). */
+		capabilityKey(name, agentId) {
+			return `${agentId !== null && agentId !== void 0 ? agentId : ""}\u0000${name}`;
+		}
+		/**
+		* Enable/disable a registered frontend tool at runtime without unregistering
+		* it. A disabled tool is omitted from {@link buildFrontendTools}, so the agent
+		* never receives it. Unlike the per-tool `available` flag, this override
+		* survives the tool being re-registered.
+		*/
+		setToolEnabled(name, enabled, agentId) {
+			const key = this.capabilityKey(name, agentId);
+			if (enabled) this._disabledToolKeys.delete(key);
+			else this._disabledToolKeys.add(key);
+		}
+		/** Whether a tool is currently enabled (not overridden off). Defaults true. */
+		isToolEnabled(name, agentId) {
+			return !this._disabledToolKeys.has(this.capabilityKey(name, agentId));
+		}
 		/**
 		* Build frontend tools for an agent
 		*/
 		buildFrontendTools(agentId) {
-			return this._tools.filter((tool) => tool.available !== false && tool.available !== "disabled" && (!tool.agentId || tool.agentId === agentId)).map((tool) => {
+			return this._tools.filter((tool) => tool.available !== false && tool.available !== "disabled" && (!tool.agentId || tool.agentId === agentId) && this.isToolEnabled(tool.name, tool.agentId)).map((tool) => {
 				var _tool$description;
 				return {
 					name: tool.name,
@@ -3151,6 +3199,13 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			message: "Failed to fetch memories",
 			docsPath: "docs/errors/memory.md#memory_list_failed"
 		},
+		MEMORY_RECALL_FAILED: {
+			code: "MEMORY_RECALL_FAILED",
+			category: "dependency",
+			retryable: true,
+			message: "Failed to recall memories",
+			docsPath: "docs/errors/memory.md#memory_recall_failed"
+		},
 		MEMORY_CREDENTIALS_FAILED: {
 			code: "MEMORY_CREDENTIALS_FAILED",
 			category: "dependency",
@@ -3222,6 +3277,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 //#region src/memory.ts
 	const MEMORIES_PATH = "/memories";
 	const MEMORIES_SUBSCRIBE_PATH = "/memories/subscribe";
+	const MEMORIES_RECALL_PATH = "/memories/recall";
 	const REQUEST_TIMEOUT_MS$1 = 15e3;
 	/** Consecutive socket errors tolerated before the realtime stream gives up. */
 	const MAX_SOCKET_RETRIES$1 = 5;
@@ -3436,10 +3492,12 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		return (0, rxjs_fetch.fromFetch)(input, init);
 	}
 	/**
-	* Fetches the memory snapshot and maps it to a success/failure action. Keeps
-	* only user-scoped memories (v1 surfaces user scope only; the realtime stream
-	* is user-scoped too), so project-scoped rows visible to the caller are
-	* dropped from the store.
+	* Fetches the memory snapshot and maps it to a success/failure action. Both
+	* user- and project-scoped rows are kept: the store now opens a second
+	* `project_meta:memories:<code>` realtime channel (when project credentials are
+	* available) that keeps project rows in sync, so surfacing them in the snapshot
+	* no longer risks a stale list. Rows are keyed by id across both channels, so
+	* realtime deltas reconcile either scope idempotently.
 	*/
 	function createMemoryFetchObservable(environment, context, sessionId) {
 		return (0, rxjs.defer)(() => {
@@ -3465,7 +3523,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 				}
 			}), (0, rxjs_operators.map)((data) => memoryRestEvents.listSucceeded({
 				sessionId,
-				memories: data.memories.filter((memory) => memory.scope === "user")
+				memories: data.memories
 			})), (0, rxjs_operators.catchError)((error) => {
 				if (error instanceof MemoryRouteUnavailableError) return (0, rxjs.of)(memoryRestEvents.listUnavailable({ sessionId }));
 				return (0, rxjs.of)(memoryRestEvents.listFailed({
@@ -3508,10 +3566,15 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		}), (0, rxjs_operators.map)((data) => {
 			if (typeof data.joinToken !== "string" || data.joinToken.length === 0) throw new Error("missing joinToken");
 			if (typeof data.joinCode !== "string" || data.joinCode.length === 0) throw new Error("missing joinCode");
+			const hasProjectCreds = typeof data.projectJoinToken === "string" && data.projectJoinToken.length > 0 && typeof data.projectJoinCode === "string" && data.projectJoinCode.length > 0;
 			return memoryRestEvents.credentialsSucceeded({
 				sessionId,
 				joinToken: data.joinToken,
-				joinCode: data.joinCode
+				joinCode: data.joinCode,
+				...hasProjectCreds ? {
+					projectJoinToken: data.projectJoinToken,
+					projectJoinCode: data.projectJoinCode
+				} : {}
 			});
 		}), (0, rxjs_operators.catchError)((error) => {
 			if (error instanceof MemoryRouteUnavailableError) return (0, rxjs.of)(memoryRestEvents.credentialsUnavailable({ sessionId }));
@@ -3532,6 +3595,21 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			invalidatedAt: data.invalidatedAt
 		};
 	}
+	/**
+	* Projects a recall REST response memory (which carries a relevance `score`)
+	* to the public {@link Memory} shape. `score` is copied through when supplied.
+	*/
+	function recallResponseToMemory(data) {
+		return {
+			id: data.id,
+			kind: data.kind,
+			scope: data.scope,
+			content: data.content,
+			sourceThreadIds: data.sourceThreadIds,
+			invalidatedAt: data.invalidatedAt,
+			...typeof data.score === "number" ? { score: data.score } : {}
+		};
+	}
 	const MEMORY_KINDS = new Set([
 		"topical",
 		"episodic",
@@ -3722,9 +3800,32 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 					return action.sessionId === state.sessionId && Boolean((_state$context = state.context) === null || _state$context === void 0 ? void 0 : _state$context.wsUrl);
 				}), (0, rxjs_operators.switchMap)(([action, state]) => {
 					const context = state.context;
-					const { joinToken, joinCode } = action;
+					const { joinToken, joinCode, projectJoinToken, projectJoinCode } = action;
 					const sessionId = action.sessionId;
 					const shutdown$ = actions$.pipe(ofType(memoryAdapterEvents.contextChanged, memoryAdapterEvents.stopped));
+					const channelMetadata$ = (channelJoinToken, topic) => {
+						const channel$ = ɵphoenixChannel$({
+							socket$: ɵphoenixSocket$({
+								url: context.wsUrl,
+								options: {
+									params: { join_token: channelJoinToken },
+									reconnectAfterMs: (0, _copilotkit_shared.phoenixExponentialBackoff)(100, 1e4),
+									rejoinAfterMs: (0, _copilotkit_shared.phoenixExponentialBackoff)(1e3, 3e4)
+								}
+							}).pipe((0, rxjs_operators.shareReplay)({
+								bufferSize: 1,
+								refCount: true
+							})),
+							topic
+						}).pipe((0, rxjs_operators.shareReplay)({
+							bufferSize: 1,
+							refCount: true
+						}));
+						return (0, rxjs.merge)(channel$.pipe((0, rxjs_operators.switchMap)(({ channel }) => ɵobservePhoenixEvent$(channel, MEMORY_METADATA_EVENT)), (0, rxjs_operators.map)((event) => mapMemoryMetadataEvent(event, sessionId))), ɵjoinPhoenixChannel$(channel$).pipe((0, rxjs_operators.catchError)((error) => {
+							console.warn(`[memory] failed to join ${topic}`, error);
+							return rxjs.EMPTY;
+						})));
+					};
 					return (0, rxjs.defer)(() => {
 						const socket$ = ɵphoenixSocket$({
 							url: context.wsUrl,
@@ -3754,7 +3855,8 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 							console.warn(`[memory] failed to join user_meta:memories:${joinCode}`, error);
 							return (0, rxjs.of)(memoryDomainEvents.realtimeUnavailable({ sessionId }));
 						}));
-						return (0, rxjs.merge)((0, rxjs.of)(memoryDomainEvents.realtimeConnecting({ sessionId })), metadata$, join$, fatalStatus$).pipe((0, rxjs_operators.takeUntil)((0, rxjs.merge)(shutdown$, fatalSocketShutdown$.pipe((0, rxjs.observeOn)(rxjs.asapScheduler)))), (0, rxjs_operators.finalize)(() => {}));
+						const projectMetadata$ = projectJoinToken && projectJoinCode ? channelMetadata$(projectJoinToken, `project_meta:memories:${projectJoinCode}`) : rxjs.EMPTY;
+						return (0, rxjs.merge)((0, rxjs.of)(memoryDomainEvents.realtimeConnecting({ sessionId })), metadata$, join$, projectMetadata$, fatalStatus$).pipe((0, rxjs_operators.takeUntil)((0, rxjs.merge)(shutdown$, fatalSocketShutdown$.pipe((0, rxjs.observeOn)(rxjs.asapScheduler)))), (0, rxjs_operators.finalize)(() => {}));
 					});
 				})))
 			]
@@ -3796,6 +3898,37 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 				store.dispatch(memoryRestEvents.listRequested({ sessionId }));
 				return done;
 			},
+			recall(query, opts) {
+				const { context } = store.getState();
+				if (!(context === null || context === void 0 ? void 0 : context.runtimeUrl)) return Promise.reject(/* @__PURE__ */ new Error("Runtime URL is not configured"));
+				const body = { query };
+				if ((opts === null || opts === void 0 ? void 0 : opts.limit) !== void 0) body.limit = opts.limit;
+				if ((opts === null || opts === void 0 ? void 0 : opts.scope) !== void 0) body.scope = opts.scope;
+				return (0, rxjs.firstValueFrom)(memoryFromFetch(`${context.runtimeUrl}${MEMORIES_RECALL_PATH}`, {
+					selector: async (response) => {
+						if (!response.ok) throw new MemoryError("MEMORY_RECALL_FAILED", {
+							message: `Failed to recall memories: ${response.status}`,
+							retryable: isRetryableStatus(response.status)
+						});
+						return await response.json();
+					},
+					fetch: environment.fetch,
+					method: "POST",
+					headers: {
+						...context.headers,
+						"Content-Type": "application/json"
+					},
+					body: JSON.stringify(body)
+				}).pipe((0, rxjs_operators.timeout)({
+					first: REQUEST_TIMEOUT_MS$1,
+					with: () => {
+						throw new MemoryError("MEMORY_REQUEST_TIMEOUT");
+					}
+				}), (0, rxjs_operators.map)((data) => {
+					var _data$memories;
+					return ((_data$memories = data.memories) !== null && _data$memories !== void 0 ? _data$memories : []).map((m) => recallResponseToMemory(m));
+				})));
+			},
 			addMemory(input) {
 				return trackMutation(memoryAdapterEvents.addRequested({
 					requestId: createMemoryRequestId(),
@@ -4011,6 +4144,9 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		get tools() {
 			return this.runHandler.tools;
 		}
+		get catalogComponents() {
+			return this.runHandler.catalogComponents;
+		}
 		get runtimeUrl() {
 			return this.agentRegistry.runtimeUrl;
 		}
@@ -4339,6 +4475,46 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			this.runHandler.setTools(tools);
 		}
 		/**
+		* Enable/disable a registered frontend tool at runtime without unregistering
+		* it (Inspector "Capabilities" tool). A disabled tool is omitted from the
+		* tool list sent to the agent on the next run. The override is keyed by name
+		* (+ optional agentId) and survives the tool being re-registered.
+		*/
+		setToolEnabled(name, enabled, agentId) {
+			this.runHandler.setToolEnabled(name, enabled, agentId);
+		}
+		/** Whether a registered tool is currently enabled (defaults true). */
+		isToolEnabled(name, agentId) {
+			return this.runHandler.isToolEnabled(name, agentId);
+		}
+		/**
+		* A2UI catalog component management (delegated to RunHandler).
+		* Registers the full component list and controls per-component enablement.
+		*/
+		setCatalogComponents(components) {
+			this.runHandler.setCatalogComponents(components);
+			this.notifySubscribers((subscriber) => {
+				var _subscriber$onCatalog;
+				return (_subscriber$onCatalog = subscriber.onCatalogComponentsChanged) === null || _subscriber$onCatalog === void 0 ? void 0 : _subscriber$onCatalog.call(subscriber, {
+					copilotkit: this,
+					catalogComponents: this.runHandler.catalogComponents
+				});
+			}, "Subscriber onCatalogComponentsChanged error:");
+		}
+		setCatalogComponentEnabled(name, enabled) {
+			this.runHandler.setCatalogComponentEnabled(name, enabled);
+			this.notifySubscribers((subscriber) => {
+				var _subscriber$onCatalog2;
+				return (_subscriber$onCatalog2 = subscriber.onCatalogComponentsChanged) === null || _subscriber$onCatalog2 === void 0 ? void 0 : _subscriber$onCatalog2.call(subscriber, {
+					copilotkit: this,
+					catalogComponents: this.runHandler.catalogComponents
+				});
+			}, "Subscriber onCatalogComponentsChanged error:");
+		}
+		isCatalogComponentEnabled(name) {
+			return this.runHandler.isCatalogComponentEnabled(name);
+		}
+		/**
 		* Subscription lifecycle
 		*/
 		subscribe(subscriber) {