@copilotkit/runtime 2.0.0-next.1 → 2.0.0-rc.1

package/dist/runtime/handlers/intelligence/memories.cjs

@@ -0,0 +1,260 @@
+const require_runtime = require('../../../_virtual/_rolldown/runtime.cjs');
+const require_json_response = require('../shared/json-response.cjs');
+const require_resolve_intelligence_user = require('../shared/resolve-intelligence-user.cjs');
+const require_runtime$1 = require('../../core/runtime.cjs');
+const require_memory_policy = require('../shared/memory-policy.cjs');
+const require_platform_error = require('../shared/platform-error.cjs');
+let _copilotkit_shared = require("@copilotkit/shared");
+
+//#region src/runtime/handlers/intelligence/memories.ts
+async function resolveClientMemory(runtime, request) {
+	const user = await require_resolve_intelligence_user.resolveIntelligenceUser({
+		runtime,
+		request
+	});
+	if (require_json_response.isHandlerResponse(user)) return user;
+	const access = await require_memory_policy.resolveWebMemory(runtime, request, user, "client");
+	if (require_json_response.isHandlerResponse(access)) return access;
+	if (runtime.memory && !require_memory_policy.grantAllowsMemory(access.grant)) return require_json_response.errorResponse("Memory access denied", 403);
+	return access;
+}
+const MISSING_INTELLIGENCE_MESSAGE = "Missing CopilotKitIntelligence configuration. Memory operations require a CopilotKitIntelligence instance to be provided in CopilotRuntime options.";
+/** Allowed `kind` vocabulary the platform's memory endpoints accept. */
+const MEMORY_KINDS = new Set([
+	"topical",
+	"episodic",
+	"operational"
+]);
+/** Allowed `scope` vocabulary the platform's memory endpoints accept. */
+const MEMORY_SCOPES = new Set(["user", "project"]);
+/**
+* Maps a thrown error to a `Response`.
+*
+* The reasoning now lives with the implementation in
+* `../shared/platform-error`, which the thread handlers share. This alias is
+* kept so the many call sites below read the same as they always did.
+*/
+const memoryErrorResponse = require_platform_error.platformErrorResponse;
+async function parseJsonBody(request) {
+	try {
+		return await request.json();
+	} catch (error) {
+		_copilotkit_shared.logger.error({ err: error }, "Malformed JSON in memory request body");
+		return require_json_response.errorResponse("Invalid request body", 400);
+	}
+}
+/**
+* Extracts and validates the create/supersede body fields the platform's
+* memory endpoints require. Returns a `Response` (400) on invalid input.
+*/
+function parseMemoryBody(body) {
+	const { content, kind, scope, sourceThreadIds } = body;
+	if (typeof content !== "string" || typeof kind !== "string") return require_json_response.errorResponse("Memory requires string `content` and `kind`", 400);
+	if (!MEMORY_KINDS.has(kind)) return require_json_response.errorResponse("Memory `kind` must be one of: topical, episodic, operational", 400);
+	if (scope !== void 0 && typeof scope !== "string") return require_json_response.errorResponse("Memory `scope` must be a string when provided", 400);
+	if (typeof scope === "string" && !MEMORY_SCOPES.has(scope)) return require_json_response.errorResponse("Memory `scope` must be one of: user, project", 400);
+	if (sourceThreadIds !== void 0 && (!Array.isArray(sourceThreadIds) || !sourceThreadIds.every((id) => typeof id === "string"))) return require_json_response.errorResponse("Memory `sourceThreadIds` must be an array of strings when provided", 400);
+	return {
+		content,
+		kind,
+		...typeof scope === "string" ? { scope } : {},
+		...Array.isArray(sourceThreadIds) ? { sourceThreadIds } : {}
+	};
+}
+/**
+* Validates the recall body: `query` required non-empty string (trimmed);
+* `limit` optional finite positive integer; `scope` optional and in the known
+* scopes. Returns a 400 Response on invalid input. The returned `query` is the
+* trimmed value so a whitespace-padded query is never forwarded to the platform.
+*/
+function parseRecallBody(body) {
+	const { query, limit, scope } = body;
+	const trimmedQuery = typeof query === "string" ? query.trim() : query;
+	if (typeof trimmedQuery !== "string" || trimmedQuery.length === 0) return require_json_response.errorResponse("Recall requires a non-empty string `query`", 400);
+	if (limit !== void 0 && !(typeof limit === "number" && Number.isInteger(limit) && limit > 0)) return require_json_response.errorResponse("Recall `limit` must be a positive integer", 400);
+	if (scope !== void 0 && typeof scope !== "string") return require_json_response.errorResponse("Recall `scope` must be a string when provided", 400);
+	if (typeof scope === "string" && !MEMORY_SCOPES.has(scope)) return require_json_response.errorResponse("Recall `scope` must be one of: user, project", 400);
+	return {
+		query: trimmedQuery,
+		...typeof limit === "number" ? { limit } : {},
+		...typeof scope === "string" ? { scope } : {}
+	};
+}
+/**
+* Lists the resolved user's long-term memories via CopilotKit Intelligence.
+*
+* Mirrors {@link handleListThreads}: requires a `CopilotKitIntelligence`
+* runtime, resolves the user with `identifyUser` (never trusting a
+* client-supplied id), and proxies to the platform's `GET /api/memories`
+* with the project API key + resolved user. The `?includeInvalidated=true`
+* query is forwarded so callers can opt into retired rows. The response is
+* the platform's `{ memories }` envelope, which the client memory store
+* consumes directly.
+*/
+async function handleListMemories({ runtime, request }) {
+	if (require_runtime$1.isIntelligenceRuntime(runtime)) try {
+		const includeInvalidated = new URL(request.url).searchParams.get("includeInvalidated") === "true";
+		const access = await resolveClientMemory(runtime, request);
+		if (require_json_response.isHandlerResponse(access)) return access;
+		const data = await runtime.intelligence.listMemories({
+			userId: access.user.id,
+			...runtime.memory ? { memoryGrant: access.grant } : {},
+			...includeInvalidated ? { includeInvalidated: true } : {}
+		});
+		if (data == null || typeof data !== "object" || !Array.isArray(data.memories)) {
+			_copilotkit_shared.logger.error({ data }, "listMemories: platform returned a response without a `memories` array");
+			return require_json_response.errorResponse("Memory platform returned an invalid list response", 502);
+		}
+		return Response.json(data);
+	} catch (error) {
+		_copilotkit_shared.logger.error({ err: error }, "Error listing memories");
+		return memoryErrorResponse(error, "Failed to list memories");
+	}
+	return require_json_response.errorResponse(MISSING_INTELLIGENCE_MESSAGE, 422);
+}
+/**
+* Semantically recalls the resolved user's memories via the platform (`POST
+* /api/memories/recall`, hybrid RAG). Mirrors {@link handleListMemories}:
+* requires a `CopilotKitIntelligence` runtime, resolves the user with
+* `identifyUser` (never a client-supplied id), proxies with the project API
+* key + resolved user. Body `{ query, limit?, scope? }`; response `{ memories }`,
+* each optionally carrying `score`.
+*/
+async function handleRecallMemories({ runtime, request }) {
+	if (!require_runtime$1.isIntelligenceRuntime(runtime)) return require_json_response.errorResponse(MISSING_INTELLIGENCE_MESSAGE, 422);
+	try {
+		const body = await parseJsonBody(request);
+		if (require_json_response.isHandlerResponse(body)) return body;
+		const fields = parseRecallBody(body);
+		if (require_json_response.isHandlerResponse(fields)) return fields;
+		const access = await resolveClientMemory(runtime, request);
+		if (require_json_response.isHandlerResponse(access)) return access;
+		const data = await runtime.intelligence.recallMemories({
+			userId: access.user.id,
+			...runtime.memory ? { memoryGrant: access.grant } : {},
+			...fields
+		});
+		if (data == null || typeof data !== "object" || !Array.isArray(data.memories)) {
+			_copilotkit_shared.logger.error({ data }, "recallMemories: platform returned a response without a `memories` array");
+			return require_json_response.errorResponse("Memory platform returned an invalid recall response", 502);
+		}
+		return Response.json(data);
+	} catch (error) {
+		_copilotkit_shared.logger.error({ err: error }, "Error recalling memories");
+		return memoryErrorResponse(error, "Failed to recall memories");
+	}
+}
+/**
+* Mints memory-realtime join credentials (platform `POST
+* /api/memories/subscribe`). Mirrors {@link handleSubscribeToThreads}: requires
+* a `CopilotKitIntelligence` runtime and resolves the user with `identifyUser`
+* (never a client-supplied id). Returns `{ joinToken, joinCode }` — memory needs
+* the `joinCode` here (unlike threads, where it rides the thread-list response)
+* because the client builds the `user_meta:memories:<joinCode>` channel topic
+* from it.
+*
+* When the platform also resolves a project scope, the response additionally
+* carries `projectJoinToken` / `projectJoinCode`, which the client uses to open
+* a second `project_meta:memories:<projectJoinCode>` channel. These are
+* optional: absent project scope → both fields are omitted (silent-degrade
+* contract; the client opens only the user channel).
+*/
+async function handleSubscribeToMemories({ runtime, request }) {
+	if (require_runtime$1.isIntelligenceRuntime(runtime)) try {
+		const access = await resolveClientMemory(runtime, request);
+		if (require_json_response.isHandlerResponse(access)) return access;
+		const credentials = await runtime.intelligence.ɵsubscribeToMemories({
+			userId: access.user.id,
+			...runtime.memory ? { memoryGrant: access.grant } : {}
+		});
+		return Response.json({
+			...credentials.joinToken !== void 0 ? { joinToken: credentials.joinToken } : {},
+			...credentials.joinCode !== void 0 ? { joinCode: credentials.joinCode } : {},
+			...credentials.projectJoinToken !== void 0 ? { projectJoinToken: credentials.projectJoinToken } : {},
+			...credentials.projectJoinCode !== void 0 ? { projectJoinCode: credentials.projectJoinCode } : {}
+		});
+	} catch (error) {
+		_copilotkit_shared.logger.error({ err: error }, "Error subscribing to memories");
+		return memoryErrorResponse(error, "Failed to subscribe to memories");
+	}
+	return require_json_response.errorResponse(MISSING_INTELLIGENCE_MESSAGE, 422);
+}
+/**
+* Creates a memory for the resolved user (platform `POST /api/memories`).
+* Identity comes from `identifyUser`, never the request body. Returns 201
+* with the stored memory (the client store applies it server-authoritatively).
+*/
+async function handleCreateMemory({ runtime, request }) {
+	if (!require_runtime$1.isIntelligenceRuntime(runtime)) return require_json_response.errorResponse(MISSING_INTELLIGENCE_MESSAGE, 422);
+	try {
+		const body = await parseJsonBody(request);
+		if (require_json_response.isHandlerResponse(body)) return body;
+		const fields = parseMemoryBody(body);
+		if (require_json_response.isHandlerResponse(fields)) return fields;
+		const access = await resolveClientMemory(runtime, request);
+		if (require_json_response.isHandlerResponse(access)) return access;
+		const data = await runtime.intelligence.createMemory({
+			userId: access.user.id,
+			...runtime.memory ? { memoryGrant: access.grant } : {},
+			...fields
+		});
+		return Response.json(data, { status: 201 });
+	} catch (error) {
+		_copilotkit_shared.logger.error({ err: error }, "Error creating memory");
+		return memoryErrorResponse(error, "Failed to create memory");
+	}
+}
+/**
+* Supersedes a memory (platform `PATCH /api/memories/:id`): retires `:id` and
+* inserts the new content atomically; the response carries `retiredId`.
+*/
+async function handleUpdateMemory({ runtime, request, memoryId }) {
+	if (!require_runtime$1.isIntelligenceRuntime(runtime)) return require_json_response.errorResponse(MISSING_INTELLIGENCE_MESSAGE, 422);
+	try {
+		const body = await parseJsonBody(request);
+		if (require_json_response.isHandlerResponse(body)) return body;
+		const fields = parseMemoryBody(body);
+		if (require_json_response.isHandlerResponse(fields)) return fields;
+		const access = await resolveClientMemory(runtime, request);
+		if (require_json_response.isHandlerResponse(access)) return access;
+		const data = await runtime.intelligence.updateMemory({
+			userId: access.user.id,
+			...runtime.memory ? { memoryGrant: access.grant } : {},
+			id: memoryId,
+			...fields
+		});
+		return Response.json(data);
+	} catch (error) {
+		_copilotkit_shared.logger.error({ err: error }, "Error updating memory");
+		return memoryErrorResponse(error, "Failed to update memory");
+	}
+}
+/**
+* Retires (forgets) a memory (platform `DELETE /api/memories/:id`). Non-lossy
+* on the platform side; returns 204.
+*/
+async function handleRemoveMemory({ runtime, request, memoryId }) {
+	if (!require_runtime$1.isIntelligenceRuntime(runtime)) return require_json_response.errorResponse(MISSING_INTELLIGENCE_MESSAGE, 422);
+	try {
+		const access = await resolveClientMemory(runtime, request);
+		if (require_json_response.isHandlerResponse(access)) return access;
+		await runtime.intelligence.removeMemory({
+			userId: access.user.id,
+			id: memoryId,
+			...runtime.memory ? { memoryGrant: access.grant } : {}
+		});
+		return new Response(null, { status: 204 });
+	} catch (error) {
+		_copilotkit_shared.logger.error({ err: error }, "Error removing memory");
+		return memoryErrorResponse(error, "Failed to remove memory");
+	}
+}
+
+//#endregion
+exports.handleCreateMemory = handleCreateMemory;
+exports.handleListMemories = handleListMemories;
+exports.handleRecallMemories = handleRecallMemories;
+exports.handleRemoveMemory = handleRemoveMemory;
+exports.handleSubscribeToMemories = handleSubscribeToMemories;
+exports.handleUpdateMemory = handleUpdateMemory;
+//# sourceMappingURL=memories.cjs.map

package/dist/runtime/handlers/intelligence/memories.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"memories.cjs","names":["resolveIntelligenceUser","isHandlerResponse","resolveWebMemory","grantAllowsMemory","errorResponse","platformErrorResponse","isIntelligenceRuntime"],"sources":["../../../../src/runtime/handlers/intelligence/memories.ts"],"sourcesContent":["import type {\n  CopilotIntelligenceRuntimeLike,\n  CopilotRuntimeLike,\n} from \"../../core/runtime\";\nimport { isIntelligenceRuntime } from \"../../core/runtime\";\nimport { logger } from \"@copilotkit/shared\";\nimport { errorResponse, isHandlerResponse } from \"../shared/json-response\";\nimport { resolveIntelligenceUser } from \"../shared/resolve-intelligence-user\";\nimport { grantAllowsMemory, resolveWebMemory } from \"../shared/memory-policy\";\nimport { platformErrorResponse } from \"../shared/platform-error\";\n\ninterface MemoriesHandlerParams {\n  runtime: CopilotRuntimeLike;\n  request: Request;\n}\n\ninterface MemoryMutationParams extends MemoriesHandlerParams {\n  memoryId: string;\n}\n\nasync function resolveClientMemory(\n  runtime: CopilotIntelligenceRuntimeLike,\n  request: Request,\n) {\n  const user = await resolveIntelligenceUser({ runtime, request });\n  if (isHandlerResponse(user)) return user;\n  const access = await resolveWebMemory(runtime, request, user, \"client\");\n  if (isHandlerResponse(access)) return access;\n  // Unlike an agent run — which proceeds without Memory tools when the policy\n  // grants nothing — these routes exist ONLY to serve memories. A caller who\n  // asked for them and may not have them gets 403; an empty list would imply\n  // there are none, which is a different and false claim.\n  if (runtime.memory && !grantAllowsMemory(access.grant)) {\n    return errorResponse(\"Memory access denied\", 403);\n  }\n  return access;\n}\n\nconst MISSING_INTELLIGENCE_MESSAGE =\n  \"Missing CopilotKitIntelligence configuration. Memory operations require a CopilotKitIntelligence instance to be provided in CopilotRuntime options.\";\n\n/** Allowed `kind` vocabulary the platform's memory endpoints accept. */\nconst MEMORY_KINDS: ReadonlySet<string> = new Set([\n  \"topical\",\n  \"episodic\",\n  \"operational\",\n]);\n/** Allowed `scope` vocabulary the platform's memory endpoints accept. */\nconst MEMORY_SCOPES: ReadonlySet<string> = new Set([\"user\", \"project\"]);\n\n/**\n * Maps a thrown error to a `Response`.\n *\n * The reasoning now lives with the implementation in\n * `../shared/platform-error`, which the thread handlers share. This alias is\n * kept so the many call sites below read the same as they always did.\n */\nconst memoryErrorResponse = platformErrorResponse;\n\nasync function parseJsonBody(\n  request: Request,\n): Promise<Record<string, unknown> | Response> {\n  try {\n    return (await request.json()) as Record<string, unknown>;\n  } catch (error) {\n    logger.error({ err: error }, \"Malformed JSON in memory request body\");\n    return errorResponse(\"Invalid request body\", 400);\n  }\n}\n\n/**\n * Extracts and validates the create/supersede body fields the platform's\n * memory endpoints require. Returns a `Response` (400) on invalid input.\n */\nfunction parseMemoryBody(body: Record<string, unknown>):\n  | {\n      content: string;\n      kind: string;\n      scope?: string;\n      sourceThreadIds?: string[];\n    }\n  | Response {\n  const { content, kind, scope, sourceThreadIds } = body;\n  if (typeof content !== \"string\" || typeof kind !== \"string\") {\n    return errorResponse(\"Memory requires string `content` and `kind`\", 400);\n  }\n  // `kind` must be one of the platform's known kinds. Reject an out-of-vocabulary\n  // value here rather than forwarding it for the platform to reject.\n  if (!MEMORY_KINDS.has(kind)) {\n    return errorResponse(\n      \"Memory `kind` must be one of: topical, episodic, operational\",\n      400,\n    );\n  }\n  // `scope` is optional: when omitted the platform applies its default\n  // (`\"user\"`). Only reject a present-but-wrong-typed scope.\n  if (scope !== undefined && typeof scope !== \"string\") {\n    return errorResponse(\"Memory `scope` must be a string when provided\", 400);\n  }\n  // When `scope` is present, it must be one of the known scopes.\n  if (typeof scope === \"string\" && !MEMORY_SCOPES.has(scope)) {\n    return errorResponse(\"Memory `scope` must be one of: user, project\", 400);\n  }\n  // `sourceThreadIds` is optional, but when present it must be a string array.\n  // Validate every element so non-string ids are not forwarded to the platform.\n  if (\n    sourceThreadIds !== undefined &&\n    (!Array.isArray(sourceThreadIds) ||\n      !sourceThreadIds.every((id) => typeof id === \"string\"))\n  ) {\n    return errorResponse(\n      \"Memory `sourceThreadIds` must be an array of strings when provided\",\n      400,\n    );\n  }\n  return {\n    content,\n    kind,\n    ...(typeof scope === \"string\" ? { scope } : {}),\n    ...(Array.isArray(sourceThreadIds)\n      ? { sourceThreadIds: sourceThreadIds as string[] }\n      : {}),\n    // `sourceThreadIds` elements are validated as strings above; the cast is safe.\n  };\n}\n\n/**\n * Validates the recall body: `query` required non-empty string (trimmed);\n * `limit` optional finite positive integer; `scope` optional and in the known\n * scopes. Returns a 400 Response on invalid input. The returned `query` is the\n * trimmed value so a whitespace-padded query is never forwarded to the platform.\n */\nfunction parseRecallBody(\n  body: Record<string, unknown>,\n): { query: string; limit?: number; scope?: string } | Response {\n  const { query, limit, scope } = body;\n  // Trim before the emptiness check so whitespace-only queries (e.g. \"   \")\n  // are rejected rather than forwarded as a useless query to the platform.\n  const trimmedQuery = typeof query === \"string\" ? query.trim() : query;\n  if (typeof trimmedQuery !== \"string\" || trimmedQuery.length === 0) {\n    return errorResponse(\"Recall requires a non-empty string `query`\", 400);\n  }\n  // When provided, `limit` must be a finite positive integer. `Number.isInteger`\n  // already rejects NaN, Infinity, and fractions (NaN/Infinity would otherwise\n  // JSON-serialize to `null` and silently corrupt the forwarded request);\n  // the `> 0` guard rejects zero and negatives.\n  if (\n    limit !== undefined &&\n    !(typeof limit === \"number\" && Number.isInteger(limit) && limit > 0)\n  ) {\n    return errorResponse(\"Recall `limit` must be a positive integer\", 400);\n  }\n  if (scope !== undefined && typeof scope !== \"string\") {\n    return errorResponse(\"Recall `scope` must be a string when provided\", 400);\n  }\n  if (typeof scope === \"string\" && !MEMORY_SCOPES.has(scope)) {\n    return errorResponse(\"Recall `scope` must be one of: user, project\", 400);\n  }\n  return {\n    query: trimmedQuery,\n    ...(typeof limit === \"number\" ? { limit } : {}),\n    ...(typeof scope === \"string\" ? { scope } : {}),\n  };\n}\n\n/**\n * Lists the resolved user's long-term memories via CopilotKit Intelligence.\n *\n * Mirrors {@link handleListThreads}: requires a `CopilotKitIntelligence`\n * runtime, resolves the user with `identifyUser` (never trusting a\n * client-supplied id), and proxies to the platform's `GET /api/memories`\n * with the project API key + resolved user. The `?includeInvalidated=true`\n * query is forwarded so callers can opt into retired rows. The response is\n * the platform's `{ memories }` envelope, which the client memory store\n * consumes directly.\n */\nexport async function handleListMemories({\n  runtime,\n  request,\n}: MemoriesHandlerParams): Promise<Response> {\n  if (isIntelligenceRuntime(runtime)) {\n    try {\n      const url = new URL(request.url);\n      const includeInvalidated =\n        url.searchParams.get(\"includeInvalidated\") === \"true\";\n\n      const access = await resolveClientMemory(runtime, request);\n      if (isHandlerResponse(access)) return access;\n\n      const data = await runtime.intelligence.listMemories({\n        userId: access.user.id,\n        ...(runtime.memory ? { memoryGrant: access.grant } : {}),\n        ...(includeInvalidated ? { includeInvalidated: true } : {}),\n      });\n\n      // The client memory store consumes the `{ memories: [...] }` envelope\n      // directly. Assert the shape before forwarding so a platform contract\n      // violation surfaces as a clear 502 (the runtime is healthy but its\n      // dependency returned the wrong shape) instead of a 200 the client will\n      // choke on.\n      if (\n        data == null ||\n        typeof data !== \"object\" ||\n        !Array.isArray((data as { memories?: unknown }).memories)\n      ) {\n        logger.error(\n          { data },\n          \"listMemories: platform returned a response without a `memories` array\",\n        );\n        return errorResponse(\n          \"Memory platform returned an invalid list response\",\n          502,\n        );\n      }\n\n      return Response.json(data);\n    } catch (error) {\n      logger.error({ err: error }, \"Error listing memories\");\n      return memoryErrorResponse(error, \"Failed to list memories\");\n    }\n  }\n\n  return errorResponse(MISSING_INTELLIGENCE_MESSAGE, 422);\n}\n\n/**\n * Semantically recalls the resolved user's memories via the platform (`POST\n * /api/memories/recall`, hybrid RAG). Mirrors {@link handleListMemories}:\n * requires a `CopilotKitIntelligence` runtime, resolves the user with\n * `identifyUser` (never a client-supplied id), proxies with the project API\n * key + resolved user. Body `{ query, limit?, scope? }`; response `{ memories }`,\n * each optionally carrying `score`.\n */\nexport async function handleRecallMemories({\n  runtime,\n  request,\n}: MemoriesHandlerParams): Promise<Response> {\n  if (!isIntelligenceRuntime(runtime)) {\n    return errorResponse(MISSING_INTELLIGENCE_MESSAGE, 422);\n  }\n  try {\n    const body = await parseJsonBody(request);\n    if (isHandlerResponse(body)) return body;\n    const fields = parseRecallBody(body);\n    if (isHandlerResponse(fields)) return fields;\n\n    const access = await resolveClientMemory(runtime, request);\n    if (isHandlerResponse(access)) return access;\n\n    const data = await runtime.intelligence.recallMemories({\n      userId: access.user.id,\n      ...(runtime.memory ? { memoryGrant: access.grant } : {}),\n      ...fields,\n    });\n\n    if (\n      data == null ||\n      typeof data !== \"object\" ||\n      !Array.isArray((data as { memories?: unknown }).memories)\n    ) {\n      logger.error(\n        { data },\n        \"recallMemories: platform returned a response without a `memories` array\",\n      );\n      return errorResponse(\n        \"Memory platform returned an invalid recall response\",\n        502,\n      );\n    }\n    return Response.json(data);\n  } catch (error) {\n    logger.error({ err: error }, \"Error recalling memories\");\n    return memoryErrorResponse(error, \"Failed to recall memories\");\n  }\n}\n\n/**\n * Mints memory-realtime join credentials (platform `POST\n * /api/memories/subscribe`). Mirrors {@link handleSubscribeToThreads}: requires\n * a `CopilotKitIntelligence` runtime and resolves the user with `identifyUser`\n * (never a client-supplied id). Returns `{ joinToken, joinCode }` — memory needs\n * the `joinCode` here (unlike threads, where it rides the thread-list response)\n * because the client builds the `user_meta:memories:<joinCode>` channel topic\n * from it.\n *\n * When the platform also resolves a project scope, the response additionally\n * carries `projectJoinToken` / `projectJoinCode`, which the client uses to open\n * a second `project_meta:memories:<projectJoinCode>` channel. These are\n * optional: absent project scope → both fields are omitted (silent-degrade\n * contract; the client opens only the user channel).\n */\nexport async function handleSubscribeToMemories({\n  runtime,\n  request,\n}: MemoriesHandlerParams): Promise<Response> {\n  if (isIntelligenceRuntime(runtime)) {\n    try {\n      const access = await resolveClientMemory(runtime, request);\n      if (isHandlerResponse(access)) return access;\n\n      const credentials = await runtime.intelligence.ɵsubscribeToMemories({\n        userId: access.user.id,\n        ...(runtime.memory ? { memoryGrant: access.grant } : {}),\n      });\n\n      return Response.json({\n        ...(credentials.joinToken !== undefined\n          ? { joinToken: credentials.joinToken }\n          : {}),\n        ...(credentials.joinCode !== undefined\n          ? { joinCode: credentials.joinCode }\n          : {}),\n        // Project-scoped credentials ride along only when the platform minted\n        // them; omit both when absent (silent-degrade contract).\n        ...(credentials.projectJoinToken !== undefined\n          ? { projectJoinToken: credentials.projectJoinToken }\n          : {}),\n        ...(credentials.projectJoinCode !== undefined\n          ? { projectJoinCode: credentials.projectJoinCode }\n          : {}),\n      });\n    } catch (error) {\n      logger.error({ err: error }, \"Error subscribing to memories\");\n      return memoryErrorResponse(error, \"Failed to subscribe to memories\");\n    }\n  }\n\n  return errorResponse(MISSING_INTELLIGENCE_MESSAGE, 422);\n}\n\n/**\n * Creates a memory for the resolved user (platform `POST /api/memories`).\n * Identity comes from `identifyUser`, never the request body. Returns 201\n * with the stored memory (the client store applies it server-authoritatively).\n */\nexport async function handleCreateMemory({\n  runtime,\n  request,\n}: MemoriesHandlerParams): Promise<Response> {\n  if (!isIntelligenceRuntime(runtime)) {\n    return errorResponse(MISSING_INTELLIGENCE_MESSAGE, 422);\n  }\n  try {\n    const body = await parseJsonBody(request);\n    if (isHandlerResponse(body)) return body;\n    const fields = parseMemoryBody(body);\n    if (isHandlerResponse(fields)) return fields;\n\n    const access = await resolveClientMemory(runtime, request);\n    if (isHandlerResponse(access)) return access;\n\n    const data = await runtime.intelligence.createMemory({\n      userId: access.user.id,\n      ...(runtime.memory ? { memoryGrant: access.grant } : {}),\n      ...fields,\n    });\n    return Response.json(data, { status: 201 });\n  } catch (error) {\n    logger.error({ err: error }, \"Error creating memory\");\n    return memoryErrorResponse(error, \"Failed to create memory\");\n  }\n}\n\n/**\n * Supersedes a memory (platform `PATCH /api/memories/:id`): retires `:id` and\n * inserts the new content atomically; the response carries `retiredId`.\n */\nexport async function handleUpdateMemory({\n  runtime,\n  request,\n  memoryId,\n}: MemoryMutationParams): Promise<Response> {\n  if (!isIntelligenceRuntime(runtime)) {\n    return errorResponse(MISSING_INTELLIGENCE_MESSAGE, 422);\n  }\n  try {\n    const body = await parseJsonBody(request);\n    if (isHandlerResponse(body)) return body;\n    const fields = parseMemoryBody(body);\n    if (isHandlerResponse(fields)) return fields;\n\n    const access = await resolveClientMemory(runtime, request);\n    if (isHandlerResponse(access)) return access;\n\n    const data = await runtime.intelligence.updateMemory({\n      userId: access.user.id,\n      ...(runtime.memory ? { memoryGrant: access.grant } : {}),\n      id: memoryId,\n      ...fields,\n    });\n    return Response.json(data);\n  } catch (error) {\n    logger.error({ err: error }, \"Error updating memory\");\n    return memoryErrorResponse(error, \"Failed to update memory\");\n  }\n}\n\n/**\n * Retires (forgets) a memory (platform `DELETE /api/memories/:id`). Non-lossy\n * on the platform side; returns 204.\n */\nexport async function handleRemoveMemory({\n  runtime,\n  request,\n  memoryId,\n}: MemoryMutationParams): Promise<Response> {\n  if (!isIntelligenceRuntime(runtime)) {\n    return errorResponse(MISSING_INTELLIGENCE_MESSAGE, 422);\n  }\n  try {\n    const access = await resolveClientMemory(runtime, request);\n    if (isHandlerResponse(access)) return access;\n\n    await runtime.intelligence.removeMemory({\n      userId: access.user.id,\n      id: memoryId,\n      ...(runtime.memory ? { memoryGrant: access.grant } : {}),\n    });\n    return new Response(null, { status: 204 });\n  } catch (error) {\n    logger.error({ err: error }, \"Error removing memory\");\n    return memoryErrorResponse(error, \"Failed to remove memory\");\n  }\n}\n"],"mappings":"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"}

package/dist/runtime/handlers/intelligence/memories.mjs

@@ -0,0 +1,254 @@
+import { errorResponse, isHandlerResponse } from "../shared/json-response.mjs";
+import { resolveIntelligenceUser } from "../shared/resolve-intelligence-user.mjs";
+import { isIntelligenceRuntime } from "../../core/runtime.mjs";
+import { grantAllowsMemory, resolveWebMemory } from "../shared/memory-policy.mjs";
+import { platformErrorResponse } from "../shared/platform-error.mjs";
+import { logger } from "@copilotkit/shared";
+
+//#region src/runtime/handlers/intelligence/memories.ts
+async function resolveClientMemory(runtime, request) {
+	const user = await resolveIntelligenceUser({
+		runtime,
+		request
+	});
+	if (isHandlerResponse(user)) return user;
+	const access = await resolveWebMemory(runtime, request, user, "client");
+	if (isHandlerResponse(access)) return access;
+	if (runtime.memory && !grantAllowsMemory(access.grant)) return errorResponse("Memory access denied", 403);
+	return access;
+}
+const MISSING_INTELLIGENCE_MESSAGE = "Missing CopilotKitIntelligence configuration. Memory operations require a CopilotKitIntelligence instance to be provided in CopilotRuntime options.";
+/** Allowed `kind` vocabulary the platform's memory endpoints accept. */
+const MEMORY_KINDS = new Set([
+	"topical",
+	"episodic",
+	"operational"
+]);
+/** Allowed `scope` vocabulary the platform's memory endpoints accept. */
+const MEMORY_SCOPES = new Set(["user", "project"]);
+/**
+* Maps a thrown error to a `Response`.
+*
+* The reasoning now lives with the implementation in
+* `../shared/platform-error`, which the thread handlers share. This alias is
+* kept so the many call sites below read the same as they always did.
+*/
+const memoryErrorResponse = platformErrorResponse;
+async function parseJsonBody(request) {
+	try {
+		return await request.json();
+	} catch (error) {
+		logger.error({ err: error }, "Malformed JSON in memory request body");
+		return errorResponse("Invalid request body", 400);
+	}
+}
+/**
+* Extracts and validates the create/supersede body fields the platform's
+* memory endpoints require. Returns a `Response` (400) on invalid input.
+*/
+function parseMemoryBody(body) {
+	const { content, kind, scope, sourceThreadIds } = body;
+	if (typeof content !== "string" || typeof kind !== "string") return errorResponse("Memory requires string `content` and `kind`", 400);
+	if (!MEMORY_KINDS.has(kind)) return errorResponse("Memory `kind` must be one of: topical, episodic, operational", 400);
+	if (scope !== void 0 && typeof scope !== "string") return errorResponse("Memory `scope` must be a string when provided", 400);
+	if (typeof scope === "string" && !MEMORY_SCOPES.has(scope)) return errorResponse("Memory `scope` must be one of: user, project", 400);
+	if (sourceThreadIds !== void 0 && (!Array.isArray(sourceThreadIds) || !sourceThreadIds.every((id) => typeof id === "string"))) return errorResponse("Memory `sourceThreadIds` must be an array of strings when provided", 400);
+	return {
+		content,
+		kind,
+		...typeof scope === "string" ? { scope } : {},
+		...Array.isArray(sourceThreadIds) ? { sourceThreadIds } : {}
+	};
+}
+/**
+* Validates the recall body: `query` required non-empty string (trimmed);
+* `limit` optional finite positive integer; `scope` optional and in the known
+* scopes. Returns a 400 Response on invalid input. The returned `query` is the
+* trimmed value so a whitespace-padded query is never forwarded to the platform.
+*/
+function parseRecallBody(body) {
+	const { query, limit, scope } = body;
+	const trimmedQuery = typeof query === "string" ? query.trim() : query;
+	if (typeof trimmedQuery !== "string" || trimmedQuery.length === 0) return errorResponse("Recall requires a non-empty string `query`", 400);
+	if (limit !== void 0 && !(typeof limit === "number" && Number.isInteger(limit) && limit > 0)) return errorResponse("Recall `limit` must be a positive integer", 400);
+	if (scope !== void 0 && typeof scope !== "string") return errorResponse("Recall `scope` must be a string when provided", 400);
+	if (typeof scope === "string" && !MEMORY_SCOPES.has(scope)) return errorResponse("Recall `scope` must be one of: user, project", 400);
+	return {
+		query: trimmedQuery,
+		...typeof limit === "number" ? { limit } : {},
+		...typeof scope === "string" ? { scope } : {}
+	};
+}
+/**
+* Lists the resolved user's long-term memories via CopilotKit Intelligence.
+*
+* Mirrors {@link handleListThreads}: requires a `CopilotKitIntelligence`
+* runtime, resolves the user with `identifyUser` (never trusting a
+* client-supplied id), and proxies to the platform's `GET /api/memories`
+* with the project API key + resolved user. The `?includeInvalidated=true`
+* query is forwarded so callers can opt into retired rows. The response is
+* the platform's `{ memories }` envelope, which the client memory store
+* consumes directly.
+*/
+async function handleListMemories({ runtime, request }) {
+	if (isIntelligenceRuntime(runtime)) try {
+		const includeInvalidated = new URL(request.url).searchParams.get("includeInvalidated") === "true";
+		const access = await resolveClientMemory(runtime, request);
+		if (isHandlerResponse(access)) return access;
+		const data = await runtime.intelligence.listMemories({
+			userId: access.user.id,
+			...runtime.memory ? { memoryGrant: access.grant } : {},
+			...includeInvalidated ? { includeInvalidated: true } : {}
+		});
+		if (data == null || typeof data !== "object" || !Array.isArray(data.memories)) {
+			logger.error({ data }, "listMemories: platform returned a response without a `memories` array");
+			return errorResponse("Memory platform returned an invalid list response", 502);
+		}
+		return Response.json(data);
+	} catch (error) {
+		logger.error({ err: error }, "Error listing memories");
+		return memoryErrorResponse(error, "Failed to list memories");
+	}
+	return errorResponse(MISSING_INTELLIGENCE_MESSAGE, 422);
+}
+/**
+* Semantically recalls the resolved user's memories via the platform (`POST
+* /api/memories/recall`, hybrid RAG). Mirrors {@link handleListMemories}:
+* requires a `CopilotKitIntelligence` runtime, resolves the user with
+* `identifyUser` (never a client-supplied id), proxies with the project API
+* key + resolved user. Body `{ query, limit?, scope? }`; response `{ memories }`,
+* each optionally carrying `score`.
+*/
+async function handleRecallMemories({ runtime, request }) {
+	if (!isIntelligenceRuntime(runtime)) return errorResponse(MISSING_INTELLIGENCE_MESSAGE, 422);
+	try {
+		const body = await parseJsonBody(request);
+		if (isHandlerResponse(body)) return body;
+		const fields = parseRecallBody(body);
+		if (isHandlerResponse(fields)) return fields;
+		const access = await resolveClientMemory(runtime, request);
+		if (isHandlerResponse(access)) return access;
+		const data = await runtime.intelligence.recallMemories({
+			userId: access.user.id,
+			...runtime.memory ? { memoryGrant: access.grant } : {},
+			...fields
+		});
+		if (data == null || typeof data !== "object" || !Array.isArray(data.memories)) {
+			logger.error({ data }, "recallMemories: platform returned a response without a `memories` array");
+			return errorResponse("Memory platform returned an invalid recall response", 502);
+		}
+		return Response.json(data);
+	} catch (error) {
+		logger.error({ err: error }, "Error recalling memories");
+		return memoryErrorResponse(error, "Failed to recall memories");
+	}
+}
+/**
+* Mints memory-realtime join credentials (platform `POST
+* /api/memories/subscribe`). Mirrors {@link handleSubscribeToThreads}: requires
+* a `CopilotKitIntelligence` runtime and resolves the user with `identifyUser`
+* (never a client-supplied id). Returns `{ joinToken, joinCode }` — memory needs
+* the `joinCode` here (unlike threads, where it rides the thread-list response)
+* because the client builds the `user_meta:memories:<joinCode>` channel topic
+* from it.
+*
+* When the platform also resolves a project scope, the response additionally
+* carries `projectJoinToken` / `projectJoinCode`, which the client uses to open
+* a second `project_meta:memories:<projectJoinCode>` channel. These are
+* optional: absent project scope → both fields are omitted (silent-degrade
+* contract; the client opens only the user channel).
+*/
+async function handleSubscribeToMemories({ runtime, request }) {
+	if (isIntelligenceRuntime(runtime)) try {
+		const access = await resolveClientMemory(runtime, request);
+		if (isHandlerResponse(access)) return access;
+		const credentials = await runtime.intelligence.ɵsubscribeToMemories({
+			userId: access.user.id,
+			...runtime.memory ? { memoryGrant: access.grant } : {}
+		});
+		return Response.json({
+			...credentials.joinToken !== void 0 ? { joinToken: credentials.joinToken } : {},
+			...credentials.joinCode !== void 0 ? { joinCode: credentials.joinCode } : {},
+			...credentials.projectJoinToken !== void 0 ? { projectJoinToken: credentials.projectJoinToken } : {},
+			...credentials.projectJoinCode !== void 0 ? { projectJoinCode: credentials.projectJoinCode } : {}
+		});
+	} catch (error) {
+		logger.error({ err: error }, "Error subscribing to memories");
+		return memoryErrorResponse(error, "Failed to subscribe to memories");
+	}
+	return errorResponse(MISSING_INTELLIGENCE_MESSAGE, 422);
+}
+/**
+* Creates a memory for the resolved user (platform `POST /api/memories`).
+* Identity comes from `identifyUser`, never the request body. Returns 201
+* with the stored memory (the client store applies it server-authoritatively).
+*/
+async function handleCreateMemory({ runtime, request }) {
+	if (!isIntelligenceRuntime(runtime)) return errorResponse(MISSING_INTELLIGENCE_MESSAGE, 422);
+	try {
+		const body = await parseJsonBody(request);
+		if (isHandlerResponse(body)) return body;
+		const fields = parseMemoryBody(body);
+		if (isHandlerResponse(fields)) return fields;
+		const access = await resolveClientMemory(runtime, request);
+		if (isHandlerResponse(access)) return access;
+		const data = await runtime.intelligence.createMemory({
+			userId: access.user.id,
+			...runtime.memory ? { memoryGrant: access.grant } : {},
+			...fields
+		});
+		return Response.json(data, { status: 201 });
+	} catch (error) {
+		logger.error({ err: error }, "Error creating memory");
+		return memoryErrorResponse(error, "Failed to create memory");
+	}
+}
+/**
+* Supersedes a memory (platform `PATCH /api/memories/:id`): retires `:id` and
+* inserts the new content atomically; the response carries `retiredId`.
+*/
+async function handleUpdateMemory({ runtime, request, memoryId }) {
+	if (!isIntelligenceRuntime(runtime)) return errorResponse(MISSING_INTELLIGENCE_MESSAGE, 422);
+	try {
+		const body = await parseJsonBody(request);
+		if (isHandlerResponse(body)) return body;
+		const fields = parseMemoryBody(body);
+		if (isHandlerResponse(fields)) return fields;
+		const access = await resolveClientMemory(runtime, request);
+		if (isHandlerResponse(access)) return access;
+		const data = await runtime.intelligence.updateMemory({
+			userId: access.user.id,
+			...runtime.memory ? { memoryGrant: access.grant } : {},
+			id: memoryId,
+			...fields
+		});
+		return Response.json(data);
+	} catch (error) {
+		logger.error({ err: error }, "Error updating memory");
+		return memoryErrorResponse(error, "Failed to update memory");
+	}
+}
+/**
+* Retires (forgets) a memory (platform `DELETE /api/memories/:id`). Non-lossy
+* on the platform side; returns 204.
+*/
+async function handleRemoveMemory({ runtime, request, memoryId }) {
+	if (!isIntelligenceRuntime(runtime)) return errorResponse(MISSING_INTELLIGENCE_MESSAGE, 422);
+	try {
+		const access = await resolveClientMemory(runtime, request);
+		if (isHandlerResponse(access)) return access;
+		await runtime.intelligence.removeMemory({
+			userId: access.user.id,
+			id: memoryId,
+			...runtime.memory ? { memoryGrant: access.grant } : {}
+		});
+		return new Response(null, { status: 204 });
+	} catch (error) {
+		logger.error({ err: error }, "Error removing memory");
+		return memoryErrorResponse(error, "Failed to remove memory");
+	}
+}
+
+//#endregion
+export { handleCreateMemory, handleListMemories, handleRecallMemories, handleRemoveMemory, handleSubscribeToMemories, handleUpdateMemory };
+//# sourceMappingURL=memories.mjs.map

package/dist/runtime/handlers/intelligence/memories.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"memories.mjs","names":[],"sources":["../../../../src/runtime/handlers/intelligence/memories.ts"],"sourcesContent":["import type {\n  CopilotIntelligenceRuntimeLike,\n  CopilotRuntimeLike,\n} from \"../../core/runtime\";\nimport { isIntelligenceRuntime } from \"../../core/runtime\";\nimport { logger } from \"@copilotkit/shared\";\nimport { errorResponse, isHandlerResponse } from \"../shared/json-response\";\nimport { resolveIntelligenceUser } from \"../shared/resolve-intelligence-user\";\nimport { grantAllowsMemory, resolveWebMemory } from \"../shared/memory-policy\";\nimport { platformErrorResponse } from \"../shared/platform-error\";\n\ninterface MemoriesHandlerParams {\n  runtime: CopilotRuntimeLike;\n  request: Request;\n}\n\ninterface MemoryMutationParams extends MemoriesHandlerParams {\n  memoryId: string;\n}\n\nasync function resolveClientMemory(\n  runtime: CopilotIntelligenceRuntimeLike,\n  request: Request,\n) {\n  const user = await resolveIntelligenceUser({ runtime, request });\n  if (isHandlerResponse(user)) return user;\n  const access = await resolveWebMemory(runtime, request, user, \"client\");\n  if (isHandlerResponse(access)) return access;\n  // Unlike an agent run — which proceeds without Memory tools when the policy\n  // grants nothing — these routes exist ONLY to serve memories. A caller who\n  // asked for them and may not have them gets 403; an empty list would imply\n  // there are none, which is a different and false claim.\n  if (runtime.memory && !grantAllowsMemory(access.grant)) {\n    return errorResponse(\"Memory access denied\", 403);\n  }\n  return access;\n}\n\nconst MISSING_INTELLIGENCE_MESSAGE =\n  \"Missing CopilotKitIntelligence configuration. Memory operations require a CopilotKitIntelligence instance to be provided in CopilotRuntime options.\";\n\n/** Allowed `kind` vocabulary the platform's memory endpoints accept. */\nconst MEMORY_KINDS: ReadonlySet<string> = new Set([\n  \"topical\",\n  \"episodic\",\n  \"operational\",\n]);\n/** Allowed `scope` vocabulary the platform's memory endpoints accept. */\nconst MEMORY_SCOPES: ReadonlySet<string> = new Set([\"user\", \"project\"]);\n\n/**\n * Maps a thrown error to a `Response`.\n *\n * The reasoning now lives with the implementation in\n * `../shared/platform-error`, which the thread handlers share. This alias is\n * kept so the many call sites below read the same as they always did.\n */\nconst memoryErrorResponse = platformErrorResponse;\n\nasync function parseJsonBody(\n  request: Request,\n): Promise<Record<string, unknown> | Response> {\n  try {\n    return (await request.json()) as Record<string, unknown>;\n  } catch (error) {\n    logger.error({ err: error }, \"Malformed JSON in memory request body\");\n    return errorResponse(\"Invalid request body\", 400);\n  }\n}\n\n/**\n * Extracts and validates the create/supersede body fields the platform's\n * memory endpoints require. Returns a `Response` (400) on invalid input.\n */\nfunction parseMemoryBody(body: Record<string, unknown>):\n  | {\n      content: string;\n      kind: string;\n      scope?: string;\n      sourceThreadIds?: string[];\n    }\n  | Response {\n  const { content, kind, scope, sourceThreadIds } = body;\n  if (typeof content !== \"string\" || typeof kind !== \"string\") {\n    return errorResponse(\"Memory requires string `content` and `kind`\", 400);\n  }\n  // `kind` must be one of the platform's known kinds. Reject an out-of-vocabulary\n  // value here rather than forwarding it for the platform to reject.\n  if (!MEMORY_KINDS.has(kind)) {\n    return errorResponse(\n      \"Memory `kind` must be one of: topical, episodic, operational\",\n      400,\n    );\n  }\n  // `scope` is optional: when omitted the platform applies its default\n  // (`\"user\"`). Only reject a present-but-wrong-typed scope.\n  if (scope !== undefined && typeof scope !== \"string\") {\n    return errorResponse(\"Memory `scope` must be a string when provided\", 400);\n  }\n  // When `scope` is present, it must be one of the known scopes.\n  if (typeof scope === \"string\" && !MEMORY_SCOPES.has(scope)) {\n    return errorResponse(\"Memory `scope` must be one of: user, project\", 400);\n  }\n  // `sourceThreadIds` is optional, but when present it must be a string array.\n  // Validate every element so non-string ids are not forwarded to the platform.\n  if (\n    sourceThreadIds !== undefined &&\n    (!Array.isArray(sourceThreadIds) ||\n      !sourceThreadIds.every((id) => typeof id === \"string\"))\n  ) {\n    return errorResponse(\n      \"Memory `sourceThreadIds` must be an array of strings when provided\",\n      400,\n    );\n  }\n  return {\n    content,\n    kind,\n    ...(typeof scope === \"string\" ? { scope } : {}),\n    ...(Array.isArray(sourceThreadIds)\n      ? { sourceThreadIds: sourceThreadIds as string[] }\n      : {}),\n    // `sourceThreadIds` elements are validated as strings above; the cast is safe.\n  };\n}\n\n/**\n * Validates the recall body: `query` required non-empty string (trimmed);\n * `limit` optional finite positive integer; `scope` optional and in the known\n * scopes. Returns a 400 Response on invalid input. The returned `query` is the\n * trimmed value so a whitespace-padded query is never forwarded to the platform.\n */\nfunction parseRecallBody(\n  body: Record<string, unknown>,\n): { query: string; limit?: number; scope?: string } | Response {\n  const { query, limit, scope } = body;\n  // Trim before the emptiness check so whitespace-only queries (e.g. \"   \")\n  // are rejected rather than forwarded as a useless query to the platform.\n  const trimmedQuery = typeof query === \"string\" ? query.trim() : query;\n  if (typeof trimmedQuery !== \"string\" || trimmedQuery.length === 0) {\n    return errorResponse(\"Recall requires a non-empty string `query`\", 400);\n  }\n  // When provided, `limit` must be a finite positive integer. `Number.isInteger`\n  // already rejects NaN, Infinity, and fractions (NaN/Infinity would otherwise\n  // JSON-serialize to `null` and silently corrupt the forwarded request);\n  // the `> 0` guard rejects zero and negatives.\n  if (\n    limit !== undefined &&\n    !(typeof limit === \"number\" && Number.isInteger(limit) && limit > 0)\n  ) {\n    return errorResponse(\"Recall `limit` must be a positive integer\", 400);\n  }\n  if (scope !== undefined && typeof scope !== \"string\") {\n    return errorResponse(\"Recall `scope` must be a string when provided\", 400);\n  }\n  if (typeof scope === \"string\" && !MEMORY_SCOPES.has(scope)) {\n    return errorResponse(\"Recall `scope` must be one of: user, project\", 400);\n  }\n  return {\n    query: trimmedQuery,\n    ...(typeof limit === \"number\" ? { limit } : {}),\n    ...(typeof scope === \"string\" ? { scope } : {}),\n  };\n}\n\n/**\n * Lists the resolved user's long-term memories via CopilotKit Intelligence.\n *\n * Mirrors {@link handleListThreads}: requires a `CopilotKitIntelligence`\n * runtime, resolves the user with `identifyUser` (never trusting a\n * client-supplied id), and proxies to the platform's `GET /api/memories`\n * with the project API key + resolved user. The `?includeInvalidated=true`\n * query is forwarded so callers can opt into retired rows. The response is\n * the platform's `{ memories }` envelope, which the client memory store\n * consumes directly.\n */\nexport async function handleListMemories({\n  runtime,\n  request,\n}: MemoriesHandlerParams): Promise<Response> {\n  if (isIntelligenceRuntime(runtime)) {\n    try {\n      const url = new URL(request.url);\n      const includeInvalidated =\n        url.searchParams.get(\"includeInvalidated\") === \"true\";\n\n      const access = await resolveClientMemory(runtime, request);\n      if (isHandlerResponse(access)) return access;\n\n      const data = await runtime.intelligence.listMemories({\n        userId: access.user.id,\n        ...(runtime.memory ? { memoryGrant: access.grant } : {}),\n        ...(includeInvalidated ? { includeInvalidated: true } : {}),\n      });\n\n      // The client memory store consumes the `{ memories: [...] }` envelope\n      // directly. Assert the shape before forwarding so a platform contract\n      // violation surfaces as a clear 502 (the runtime is healthy but its\n      // dependency returned the wrong shape) instead of a 200 the client will\n      // choke on.\n      if (\n        data == null ||\n        typeof data !== \"object\" ||\n        !Array.isArray((data as { memories?: unknown }).memories)\n      ) {\n        logger.error(\n          { data },\n          \"listMemories: platform returned a response without a `memories` array\",\n        );\n        return errorResponse(\n          \"Memory platform returned an invalid list response\",\n          502,\n        );\n      }\n\n      return Response.json(data);\n    } catch (error) {\n      logger.error({ err: error }, \"Error listing memories\");\n      return memoryErrorResponse(error, \"Failed to list memories\");\n    }\n  }\n\n  return errorResponse(MISSING_INTELLIGENCE_MESSAGE, 422);\n}\n\n/**\n * Semantically recalls the resolved user's memories via the platform (`POST\n * /api/memories/recall`, hybrid RAG). Mirrors {@link handleListMemories}:\n * requires a `CopilotKitIntelligence` runtime, resolves the user with\n * `identifyUser` (never a client-supplied id), proxies with the project API\n * key + resolved user. Body `{ query, limit?, scope? }`; response `{ memories }`,\n * each optionally carrying `score`.\n */\nexport async function handleRecallMemories({\n  runtime,\n  request,\n}: MemoriesHandlerParams): Promise<Response> {\n  if (!isIntelligenceRuntime(runtime)) {\n    return errorResponse(MISSING_INTELLIGENCE_MESSAGE, 422);\n  }\n  try {\n    const body = await parseJsonBody(request);\n    if (isHandlerResponse(body)) return body;\n    const fields = parseRecallBody(body);\n    if (isHandlerResponse(fields)) return fields;\n\n    const access = await resolveClientMemory(runtime, request);\n    if (isHandlerResponse(access)) return access;\n\n    const data = await runtime.intelligence.recallMemories({\n      userId: access.user.id,\n      ...(runtime.memory ? { memoryGrant: access.grant } : {}),\n      ...fields,\n    });\n\n    if (\n      data == null ||\n      typeof data !== \"object\" ||\n      !Array.isArray((data as { memories?: unknown }).memories)\n    ) {\n      logger.error(\n        { data },\n        \"recallMemories: platform returned a response without a `memories` array\",\n      );\n      return errorResponse(\n        \"Memory platform returned an invalid recall response\",\n        502,\n      );\n    }\n    return Response.json(data);\n  } catch (error) {\n    logger.error({ err: error }, \"Error recalling memories\");\n    return memoryErrorResponse(error, \"Failed to recall memories\");\n  }\n}\n\n/**\n * Mints memory-realtime join credentials (platform `POST\n * /api/memories/subscribe`). Mirrors {@link handleSubscribeToThreads}: requires\n * a `CopilotKitIntelligence` runtime and resolves the user with `identifyUser`\n * (never a client-supplied id). Returns `{ joinToken, joinCode }` — memory needs\n * the `joinCode` here (unlike threads, where it rides the thread-list response)\n * because the client builds the `user_meta:memories:<joinCode>` channel topic\n * from it.\n *\n * When the platform also resolves a project scope, the response additionally\n * carries `projectJoinToken` / `projectJoinCode`, which the client uses to open\n * a second `project_meta:memories:<projectJoinCode>` channel. These are\n * optional: absent project scope → both fields are omitted (silent-degrade\n * contract; the client opens only the user channel).\n */\nexport async function handleSubscribeToMemories({\n  runtime,\n  request,\n}: MemoriesHandlerParams): Promise<Response> {\n  if (isIntelligenceRuntime(runtime)) {\n    try {\n      const access = await resolveClientMemory(runtime, request);\n      if (isHandlerResponse(access)) return access;\n\n      const credentials = await runtime.intelligence.ɵsubscribeToMemories({\n        userId: access.user.id,\n        ...(runtime.memory ? { memoryGrant: access.grant } : {}),\n      });\n\n      return Response.json({\n        ...(credentials.joinToken !== undefined\n          ? { joinToken: credentials.joinToken }\n          : {}),\n        ...(credentials.joinCode !== undefined\n          ? { joinCode: credentials.joinCode }\n          : {}),\n        // Project-scoped credentials ride along only when the platform minted\n        // them; omit both when absent (silent-degrade contract).\n        ...(credentials.projectJoinToken !== undefined\n          ? { projectJoinToken: credentials.projectJoinToken }\n          : {}),\n        ...(credentials.projectJoinCode !== undefined\n          ? { projectJoinCode: credentials.projectJoinCode }\n          : {}),\n      });\n    } catch (error) {\n      logger.error({ err: error }, \"Error subscribing to memories\");\n      return memoryErrorResponse(error, \"Failed to subscribe to memories\");\n    }\n  }\n\n  return errorResponse(MISSING_INTELLIGENCE_MESSAGE, 422);\n}\n\n/**\n * Creates a memory for the resolved user (platform `POST /api/memories`).\n * Identity comes from `identifyUser`, never the request body. Returns 201\n * with the stored memory (the client store applies it server-authoritatively).\n */\nexport async function handleCreateMemory({\n  runtime,\n  request,\n}: MemoriesHandlerParams): Promise<Response> {\n  if (!isIntelligenceRuntime(runtime)) {\n    return errorResponse(MISSING_INTELLIGENCE_MESSAGE, 422);\n  }\n  try {\n    const body = await parseJsonBody(request);\n    if (isHandlerResponse(body)) return body;\n    const fields = parseMemoryBody(body);\n    if (isHandlerResponse(fields)) return fields;\n\n    const access = await resolveClientMemory(runtime, request);\n    if (isHandlerResponse(access)) return access;\n\n    const data = await runtime.intelligence.createMemory({\n      userId: access.user.id,\n      ...(runtime.memory ? { memoryGrant: access.grant } : {}),\n      ...fields,\n    });\n    return Response.json(data, { status: 201 });\n  } catch (error) {\n    logger.error({ err: error }, \"Error creating memory\");\n    return memoryErrorResponse(error, \"Failed to create memory\");\n  }\n}\n\n/**\n * Supersedes a memory (platform `PATCH /api/memories/:id`): retires `:id` and\n * inserts the new content atomically; the response carries `retiredId`.\n */\nexport async function handleUpdateMemory({\n  runtime,\n  request,\n  memoryId,\n}: MemoryMutationParams): Promise<Response> {\n  if (!isIntelligenceRuntime(runtime)) {\n    return errorResponse(MISSING_INTELLIGENCE_MESSAGE, 422);\n  }\n  try {\n    const body = await parseJsonBody(request);\n    if (isHandlerResponse(body)) return body;\n    const fields = parseMemoryBody(body);\n    if (isHandlerResponse(fields)) return fields;\n\n    const access = await resolveClientMemory(runtime, request);\n    if (isHandlerResponse(access)) return access;\n\n    const data = await runtime.intelligence.updateMemory({\n      userId: access.user.id,\n      ...(runtime.memory ? { memoryGrant: access.grant } : {}),\n      id: memoryId,\n      ...fields,\n    });\n    return Response.json(data);\n  } catch (error) {\n    logger.error({ err: error }, \"Error updating memory\");\n    return memoryErrorResponse(error, \"Failed to update memory\");\n  }\n}\n\n/**\n * Retires (forgets) a memory (platform `DELETE /api/memories/:id`). Non-lossy\n * on the platform side; returns 204.\n */\nexport async function handleRemoveMemory({\n  runtime,\n  request,\n  memoryId,\n}: MemoryMutationParams): Promise<Response> {\n  if (!isIntelligenceRuntime(runtime)) {\n    return errorResponse(MISSING_INTELLIGENCE_MESSAGE, 422);\n  }\n  try {\n    const access = await resolveClientMemory(runtime, request);\n    if (isHandlerResponse(access)) return access;\n\n    await runtime.intelligence.removeMemory({\n      userId: access.user.id,\n      id: memoryId,\n      ...(runtime.memory ? { memoryGrant: access.grant } : {}),\n    });\n    return new Response(null, { status: 204 });\n  } catch (error) {\n    logger.error({ err: error }, \"Error removing memory\");\n    return memoryErrorResponse(error, \"Failed to remove memory\");\n  }\n}\n"],"mappings":"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"}