@copilotkit/runtime 1.64.2 → 1.64.3-canary.1785623356

package/dist/v2/runtime/handlers/get-runtime-info.mjs

@@ -16,7 +16,8 @@ function resolveLicenseStatus(runtime) {
 }
 async function handleGetRuntimeInfo({ runtime, request, threadEndpointsEnabled = true }) {
 	try {
-		const agents = await resolveAgents(runtime.agents, request);
+		const webEnabled = !isIntelligenceRuntime(runtime) || runtime.identifyUser !== void 0;
+		const agents = webEnabled ? await resolveAgents(runtime.agents, request) : {};
 		const agentEntries = await Promise.all(Object.entries(agents).map(async ([name, agent]) => {
 			let capabilities;
 			try {
@@ -35,17 +36,17 @@ async function handleGetRuntimeInfo({ runtime, request, threadEndpointsEnabled =
 		const runtimeInfo = {
 			version: VERSION,
 			agents: Object.fromEntries(agentEntries),
-			audioFileTranscriptionEnabled: !!runtime.transcriptionService,
+			audioFileTranscriptionEnabled: webEnabled && !!runtime.transcriptionService,
 			mode: runtime.mode,
-			threadEndpoints: resolveThreadEndpointInfo(runtime, threadEndpointsEnabled),
-			suggestions: true,
-			...isIntelligenceRuntime(runtime) ? { intelligence: { wsUrl: runtime.intelligence.ɵgetClientWsUrl() } } : {},
-			a2uiEnabled: isA2UIEnabled(runtime.a2ui),
-			...isA2UIEnabled(runtime.a2ui) ? { a2ui: {
+			threadEndpoints: resolveThreadEndpointInfo(runtime, threadEndpointsEnabled && webEnabled),
+			suggestions: webEnabled,
+			...isIntelligenceRuntime(runtime) && webEnabled ? { intelligence: { wsUrl: runtime.intelligence.ɵgetClientWsUrl() } } : {},
+			a2uiEnabled: webEnabled && isA2UIEnabled(runtime.a2ui),
+			...webEnabled && isA2UIEnabled(runtime.a2ui) ? { a2ui: {
 				enabled: true,
 				...runtime.a2ui.agents ? { agents: runtime.a2ui.agents } : {}
 			} } : {},
-			openGenerativeUIEnabled: !!runtime.openGenerativeUI,
+			openGenerativeUIEnabled: webEnabled && !!runtime.openGenerativeUI,
 			...isIntelligenceRuntime(runtime) ? { licenseStatus: resolveLicenseStatus(runtime) } : {},
 			telemetryDisabled: isTelemetryDisabled()
 		};

package/dist/v2/runtime/handlers/get-runtime-info.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"get-runtime-info.mjs","names":[],"sources":["../../../../src/v2/runtime/handlers/get-runtime-info.ts"],"sourcesContent":["import type { AgentCapabilities } from \"@ag-ui/core\";\nimport type { CopilotRuntimeLike } from \"../core/runtime\";\nimport {\n  isA2UIEnabled,\n  isIntelligenceRuntime,\n  resolveAgents,\n} from \"../core/runtime\";\nimport type {\n  AgentDescription,\n  RuntimeInfo,\n  ThreadEndpointRuntimeInfo,\n} from \"@copilotkit/shared\";\nimport type { RuntimeLicenseStatus } from \"@copilotkit/shared\";\nimport { VERSION } from \"../core/runtime\";\nimport { isTelemetryDisabled } from \"../telemetry/telemetry-client\";\nimport { supportsLocalThreadEndpoints } from \"../runner/agent-runner\";\n\nfunction resolveLicenseStatus(\n  runtime: CopilotRuntimeLike,\n): RuntimeLicenseStatus {\n  if (!runtime.licenseChecker) return \"none\";\n  const status = runtime.licenseChecker.getStatus();\n  if (status.warningSeverity === \"none\") return \"valid\";\n  if (status.error === \"expired\") return \"expired\";\n  if (status.warningSeverity === \"warning\") return \"expiring\";\n  if (status.error) return \"invalid\";\n  if (status.warningSeverity === \"info\") return \"none\";\n  return \"unknown\";\n}\n\ninterface HandleGetRuntimeInfoParameters {\n  runtime: CopilotRuntimeLike;\n  request: Request;\n  threadEndpointsEnabled?: boolean;\n}\n\nexport async function handleGetRuntimeInfo({\n  runtime,\n  request,\n  threadEndpointsEnabled = true,\n}: HandleGetRuntimeInfoParameters) {\n  try {\n    const agents = await resolveAgents(runtime.agents, request);\n\n    const agentEntries = await Promise.all(\n      Object.entries(agents).map(async ([name, agent]) => {\n        let capabilities: AgentCapabilities | undefined;\n        try {\n          capabilities = agent.getCapabilities\n            ? await agent.getCapabilities()\n            : undefined;\n        } catch (error) {\n          // Per-agent isolation: a single agent failing to report capabilities\n          // must not take down the entire /info endpoint.\n          console.warn(\n            `Failed to fetch capabilities for agent \"${name}\":`,\n            error instanceof Error ? error.message : error,\n          );\n          capabilities = undefined;\n        }\n\n        const description: AgentDescription = {\n          name,\n          description: agent.description,\n          className: agent.constructor.name,\n          ...(capabilities ? { capabilities } : {}),\n        };\n\n        return [name, description] as const;\n      }),\n    );\n\n    const agentsDict: Record<string, AgentDescription> =\n      Object.fromEntries(agentEntries);\n\n    const runtimeInfo: RuntimeInfo = {\n      version: VERSION,\n      agents: agentsDict,\n      audioFileTranscriptionEnabled: !!runtime.transcriptionService,\n      mode: runtime.mode,\n      threadEndpoints: resolveThreadEndpointInfo(\n        runtime,\n        threadEndpointsEnabled,\n      ),\n      // Advertised unconditionally. Multi-route runtimes expose the dedicated\n      // POST /agent/:agentId/suggest path; single-route clients fall back to a\n      // client-side run (they don't construct the single-route envelope for\n      // suggest). The flag lets multi-route clients detect the stateless path.\n      suggestions: true,\n      ...(isIntelligenceRuntime(runtime)\n        ? {\n            intelligence: {\n              wsUrl: runtime.intelligence.ɵgetClientWsUrl(),\n            },\n          }\n        : {}),\n      // Legacy flat flag, kept for older clients. The `a2ui` object below is\n      // the source of truth: it preserves the per-agent scoping that this\n      // boolean discards (see CopilotKit/CopilotKit#5369). Both go through the\n      // shared isA2UIEnabled() predicate so an explicit `enabled: false`\n      // disables a2ui here exactly as it does on the run path.\n      a2uiEnabled: isA2UIEnabled(runtime.a2ui),\n      ...(isA2UIEnabled(runtime.a2ui)\n        ? {\n            a2ui: {\n              enabled: true,\n              ...(runtime.a2ui.agents ? { agents: runtime.a2ui.agents } : {}),\n            },\n          }\n        : {}),\n      openGenerativeUIEnabled: !!runtime.openGenerativeUI,\n      ...(isIntelligenceRuntime(runtime)\n        ? { licenseStatus: resolveLicenseStatus(runtime) }\n        : {}),\n      telemetryDisabled: isTelemetryDisabled(),\n    };\n\n    return new Response(JSON.stringify(runtimeInfo), {\n      status: 200,\n      headers: { \"Content-Type\": \"application/json\" },\n    });\n  } catch (error) {\n    return new Response(\n      JSON.stringify({\n        error: \"Failed to retrieve runtime information\",\n        message: error instanceof Error ? error.message : \"Unknown error\",\n      }),\n      {\n        status: 500,\n        headers: { \"Content-Type\": \"application/json\" },\n      },\n    );\n  }\n}\n\nfunction resolveThreadEndpointInfo(\n  runtime: CopilotRuntimeLike,\n  threadEndpointsEnabled: boolean,\n): ThreadEndpointRuntimeInfo {\n  const hasRestThreadBackend =\n    isIntelligenceRuntime(runtime) ||\n    supportsLocalThreadEndpoints(runtime.runner);\n  const restEndpointsAvailable = threadEndpointsEnabled && hasRestThreadBackend;\n  const managedThreadMetadata =\n    threadEndpointsEnabled && isIntelligenceRuntime(runtime);\n\n  return {\n    list: restEndpointsAvailable,\n    inspect: restEndpointsAvailable,\n    mutations: managedThreadMetadata,\n    realtimeMetadata: managedThreadMetadata,\n  };\n}\n"],"mappings":";;;;;;AAiBA,SAAS,qBACP,SACsB;AACtB,KAAI,CAAC,QAAQ,eAAgB,QAAO;CACpC,MAAM,SAAS,QAAQ,eAAe,WAAW;AACjD,KAAI,OAAO,oBAAoB,OAAQ,QAAO;AAC9C,KAAI,OAAO,UAAU,UAAW,QAAO;AACvC,KAAI,OAAO,oBAAoB,UAAW,QAAO;AACjD,KAAI,OAAO,MAAO,QAAO;AACzB,KAAI,OAAO,oBAAoB,OAAQ,QAAO;AAC9C,QAAO;;AAST,eAAsB,qBAAqB,EACzC,SACA,SACA,yBAAyB,QACQ;AACjC,KAAI;EACF,MAAM,SAAS,MAAM,cAAc,QAAQ,QAAQ,QAAQ;EAE3D,MAAM,eAAe,MAAM,QAAQ,IACjC,OAAO,QAAQ,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,WAAW;GAClD,IAAI;AACJ,OAAI;AACF,mBAAe,MAAM,kBACjB,MAAM,MAAM,iBAAiB,GAC7B;YACG,OAAO;AAGd,YAAQ,KACN,2CAA2C,KAAK,KAChD,iBAAiB,QAAQ,MAAM,UAAU,MAC1C;AACD,mBAAe;;AAUjB,UAAO,CAAC,MAP8B;IACpC;IACA,aAAa,MAAM;IACnB,WAAW,MAAM,YAAY;IAC7B,GAAI,eAAe,EAAE,cAAc,GAAG,EAAE;IACzC,CAEyB;IAC1B,CACH;EAKD,MAAM,cAA2B;GAC/B,SAAS;GACT,QAJA,OAAO,YAAY,aAAa;GAKhC,+BAA+B,CAAC,CAAC,QAAQ;GACzC,MAAM,QAAQ;GACd,iBAAiB,0BACf,SACA,uBACD;GAKD,aAAa;GACb,GAAI,sBAAsB,QAAQ,GAC9B,EACE,cAAc,EACZ,OAAO,QAAQ,aAAa,iBAAiB,EAC9C,EACF,GACD,EAAE;GAMN,aAAa,cAAc,QAAQ,KAAK;GACxC,GAAI,cAAc,QAAQ,KAAK,GAC3B,EACE,MAAM;IACJ,SAAS;IACT,GAAI,QAAQ,KAAK,SAAS,EAAE,QAAQ,QAAQ,KAAK,QAAQ,GAAG,EAAE;IAC/D,EACF,GACD,EAAE;GACN,yBAAyB,CAAC,CAAC,QAAQ;GACnC,GAAI,sBAAsB,QAAQ,GAC9B,EAAE,eAAe,qBAAqB,QAAQ,EAAE,GAChD,EAAE;GACN,mBAAmB,qBAAqB;GACzC;AAED,SAAO,IAAI,SAAS,KAAK,UAAU,YAAY,EAAE;GAC/C,QAAQ;GACR,SAAS,EAAE,gBAAgB,oBAAoB;GAChD,CAAC;UACK,OAAO;AACd,SAAO,IAAI,SACT,KAAK,UAAU;GACb,OAAO;GACP,SAAS,iBAAiB,QAAQ,MAAM,UAAU;GACnD,CAAC,EACF;GACE,QAAQ;GACR,SAAS,EAAE,gBAAgB,oBAAoB;GAChD,CACF;;;AAIL,SAAS,0BACP,SACA,wBAC2B;CAC3B,MAAM,uBACJ,sBAAsB,QAAQ,IAC9B,6BAA6B,QAAQ,OAAO;CAC9C,MAAM,yBAAyB,0BAA0B;CACzD,MAAM,wBACJ,0BAA0B,sBAAsB,QAAQ;AAE1D,QAAO;EACL,MAAM;EACN,SAAS;EACT,WAAW;EACX,kBAAkB;EACnB"}
+{"version":3,"file":"get-runtime-info.mjs","names":[],"sources":["../../../../src/v2/runtime/handlers/get-runtime-info.ts"],"sourcesContent":["import type { AgentCapabilities } from \"@ag-ui/core\";\nimport type { CopilotRuntimeLike } from \"../core/runtime\";\nimport {\n  isA2UIEnabled,\n  isIntelligenceRuntime,\n  resolveAgents,\n} from \"../core/runtime\";\nimport type {\n  AgentDescription,\n  RuntimeInfo,\n  ThreadEndpointRuntimeInfo,\n} from \"@copilotkit/shared\";\nimport type { RuntimeLicenseStatus } from \"@copilotkit/shared\";\nimport { VERSION } from \"../core/runtime\";\nimport { isTelemetryDisabled } from \"../telemetry/telemetry-client\";\nimport { supportsLocalThreadEndpoints } from \"../runner/agent-runner\";\n\nfunction resolveLicenseStatus(\n  runtime: CopilotRuntimeLike,\n): RuntimeLicenseStatus {\n  if (!runtime.licenseChecker) return \"none\";\n  const status = runtime.licenseChecker.getStatus();\n  if (status.warningSeverity === \"none\") return \"valid\";\n  if (status.error === \"expired\") return \"expired\";\n  if (status.warningSeverity === \"warning\") return \"expiring\";\n  if (status.error) return \"invalid\";\n  if (status.warningSeverity === \"info\") return \"none\";\n  return \"unknown\";\n}\n\ninterface HandleGetRuntimeInfoParameters {\n  runtime: CopilotRuntimeLike;\n  request: Request;\n  threadEndpointsEnabled?: boolean;\n}\n\nexport async function handleGetRuntimeInfo({\n  runtime,\n  request,\n  threadEndpointsEnabled = true,\n}: HandleGetRuntimeInfoParameters) {\n  try {\n    const webEnabled =\n      !isIntelligenceRuntime(runtime) || runtime.identifyUser !== undefined;\n    const agents = webEnabled\n      ? await resolveAgents(runtime.agents, request)\n      : {};\n\n    const agentEntries = await Promise.all(\n      Object.entries(agents).map(async ([name, agent]) => {\n        let capabilities: AgentCapabilities | undefined;\n        try {\n          capabilities = agent.getCapabilities\n            ? await agent.getCapabilities()\n            : undefined;\n        } catch (error) {\n          // Per-agent isolation: a single agent failing to report capabilities\n          // must not take down the entire /info endpoint.\n          console.warn(\n            `Failed to fetch capabilities for agent \"${name}\":`,\n            error instanceof Error ? error.message : error,\n          );\n          capabilities = undefined;\n        }\n\n        const description: AgentDescription = {\n          name,\n          description: agent.description,\n          className: agent.constructor.name,\n          ...(capabilities ? { capabilities } : {}),\n        };\n\n        return [name, description] as const;\n      }),\n    );\n\n    const agentsDict: Record<string, AgentDescription> =\n      Object.fromEntries(agentEntries);\n\n    const runtimeInfo: RuntimeInfo = {\n      version: VERSION,\n      agents: agentsDict,\n      audioFileTranscriptionEnabled:\n        webEnabled && !!runtime.transcriptionService,\n      mode: runtime.mode,\n      threadEndpoints: resolveThreadEndpointInfo(\n        runtime,\n        threadEndpointsEnabled && webEnabled,\n      ),\n      // Advertised unconditionally. Multi-route runtimes expose the dedicated\n      // POST /agent/:agentId/suggest path; single-route clients fall back to a\n      // client-side run (they don't construct the single-route envelope for\n      // suggest). The flag lets multi-route clients detect the stateless path.\n      suggestions: webEnabled,\n      ...(isIntelligenceRuntime(runtime) && webEnabled\n        ? {\n            intelligence: {\n              wsUrl: runtime.intelligence.ɵgetClientWsUrl(),\n            },\n          }\n        : {}),\n      // Legacy flat flag, kept for older clients. The `a2ui` object below is\n      // the source of truth: it preserves the per-agent scoping that this\n      // boolean discards (see CopilotKit/CopilotKit#5369). Both go through the\n      // shared isA2UIEnabled() predicate so an explicit `enabled: false`\n      // disables a2ui here exactly as it does on the run path.\n      a2uiEnabled: webEnabled && isA2UIEnabled(runtime.a2ui),\n      ...(webEnabled && isA2UIEnabled(runtime.a2ui)\n        ? {\n            a2ui: {\n              enabled: true,\n              ...(runtime.a2ui.agents ? { agents: runtime.a2ui.agents } : {}),\n            },\n          }\n        : {}),\n      openGenerativeUIEnabled: webEnabled && !!runtime.openGenerativeUI,\n      ...(isIntelligenceRuntime(runtime)\n        ? { licenseStatus: resolveLicenseStatus(runtime) }\n        : {}),\n      telemetryDisabled: isTelemetryDisabled(),\n    };\n\n    return new Response(JSON.stringify(runtimeInfo), {\n      status: 200,\n      headers: { \"Content-Type\": \"application/json\" },\n    });\n  } catch (error) {\n    return new Response(\n      JSON.stringify({\n        error: \"Failed to retrieve runtime information\",\n        message: error instanceof Error ? error.message : \"Unknown error\",\n      }),\n      {\n        status: 500,\n        headers: { \"Content-Type\": \"application/json\" },\n      },\n    );\n  }\n}\n\nfunction resolveThreadEndpointInfo(\n  runtime: CopilotRuntimeLike,\n  threadEndpointsEnabled: boolean,\n): ThreadEndpointRuntimeInfo {\n  const hasRestThreadBackend =\n    isIntelligenceRuntime(runtime) ||\n    supportsLocalThreadEndpoints(runtime.runner);\n  const restEndpointsAvailable = threadEndpointsEnabled && hasRestThreadBackend;\n  const managedThreadMetadata =\n    threadEndpointsEnabled && isIntelligenceRuntime(runtime);\n\n  return {\n    list: restEndpointsAvailable,\n    inspect: restEndpointsAvailable,\n    mutations: managedThreadMetadata,\n    realtimeMetadata: managedThreadMetadata,\n  };\n}\n"],"mappings":";;;;;;AAiBA,SAAS,qBACP,SACsB;AACtB,KAAI,CAAC,QAAQ,eAAgB,QAAO;CACpC,MAAM,SAAS,QAAQ,eAAe,WAAW;AACjD,KAAI,OAAO,oBAAoB,OAAQ,QAAO;AAC9C,KAAI,OAAO,UAAU,UAAW,QAAO;AACvC,KAAI,OAAO,oBAAoB,UAAW,QAAO;AACjD,KAAI,OAAO,MAAO,QAAO;AACzB,KAAI,OAAO,oBAAoB,OAAQ,QAAO;AAC9C,QAAO;;AAST,eAAsB,qBAAqB,EACzC,SACA,SACA,yBAAyB,QACQ;AACjC,KAAI;EACF,MAAM,aACJ,CAAC,sBAAsB,QAAQ,IAAI,QAAQ,iBAAiB;EAC9D,MAAM,SAAS,aACX,MAAM,cAAc,QAAQ,QAAQ,QAAQ,GAC5C,EAAE;EAEN,MAAM,eAAe,MAAM,QAAQ,IACjC,OAAO,QAAQ,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,WAAW;GAClD,IAAI;AACJ,OAAI;AACF,mBAAe,MAAM,kBACjB,MAAM,MAAM,iBAAiB,GAC7B;YACG,OAAO;AAGd,YAAQ,KACN,2CAA2C,KAAK,KAChD,iBAAiB,QAAQ,MAAM,UAAU,MAC1C;AACD,mBAAe;;AAUjB,UAAO,CAAC,MAP8B;IACpC;IACA,aAAa,MAAM;IACnB,WAAW,MAAM,YAAY;IAC7B,GAAI,eAAe,EAAE,cAAc,GAAG,EAAE;IACzC,CAEyB;IAC1B,CACH;EAKD,MAAM,cAA2B;GAC/B,SAAS;GACT,QAJA,OAAO,YAAY,aAAa;GAKhC,+BACE,cAAc,CAAC,CAAC,QAAQ;GAC1B,MAAM,QAAQ;GACd,iBAAiB,0BACf,SACA,0BAA0B,WAC3B;GAKD,aAAa;GACb,GAAI,sBAAsB,QAAQ,IAAI,aAClC,EACE,cAAc,EACZ,OAAO,QAAQ,aAAa,iBAAiB,EAC9C,EACF,GACD,EAAE;GAMN,aAAa,cAAc,cAAc,QAAQ,KAAK;GACtD,GAAI,cAAc,cAAc,QAAQ,KAAK,GACzC,EACE,MAAM;IACJ,SAAS;IACT,GAAI,QAAQ,KAAK,SAAS,EAAE,QAAQ,QAAQ,KAAK,QAAQ,GAAG,EAAE;IAC/D,EACF,GACD,EAAE;GACN,yBAAyB,cAAc,CAAC,CAAC,QAAQ;GACjD,GAAI,sBAAsB,QAAQ,GAC9B,EAAE,eAAe,qBAAqB,QAAQ,EAAE,GAChD,EAAE;GACN,mBAAmB,qBAAqB;GACzC;AAED,SAAO,IAAI,SAAS,KAAK,UAAU,YAAY,EAAE;GAC/C,QAAQ;GACR,SAAS,EAAE,gBAAgB,oBAAoB;GAChD,CAAC;UACK,OAAO;AACd,SAAO,IAAI,SACT,KAAK,UAAU;GACb,OAAO;GACP,SAAS,iBAAiB,QAAQ,MAAM,UAAU;GACnD,CAAC,EACF;GACE,QAAQ;GACR,SAAS,EAAE,gBAAgB,oBAAoB;GAChD,CACF;;;AAIL,SAAS,0BACP,SACA,wBAC2B;CAC3B,MAAM,uBACJ,sBAAsB,QAAQ,IAC9B,6BAA6B,QAAQ,OAAO;CAC9C,MAAM,yBAAyB,0BAA0B;CACzD,MAAM,wBACJ,0BAA0B,sBAAsB,QAAQ;AAE1D,QAAO;EACL,MAAM;EACN,SAAS;EACT,WAAW;EACX,kBAAkB;EACnB"}

package/dist/v2/runtime/handlers/handle-run.cjs

@@ -26,11 +26,12 @@ async function handleRunAgent({ runtime, request, agentId }) {
 			agent,
 			providerA2UIHasCatalog: input.forwardedProps?.a2uiCatalogAvailable === true
 		});
-		await require_agent_utils.attachIntelligenceEnterpriseLearning({
+		const memoryResponse = await require_agent_utils.attachIntelligenceEnterpriseLearning({
 			runtime,
 			request,
 			agent
 		});
+		if (memoryResponse instanceof Response) return memoryResponse;
 		agent.setMessages(input.messages);
 		agent.setState(input.state);
 		agent.threadId = input.threadId;

package/dist/v2/runtime/handlers/handle-run.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"handle-run.cjs","names":["cloneAgentForRequest","parseRunRequest","attachIntelligenceEnterpriseLearning","isIntelligenceRuntime","handleIntelligenceRun","handleSseRun"],"sources":["../../../../src/v2/runtime/handlers/handle-run.ts"],"sourcesContent":["import { isIntelligenceRuntime } from \"../core/runtime\";\nimport { telemetry } from \"../telemetry\";\nimport type { RunAgentParameters } from \"./shared/agent-utils\";\nimport {\n  attachIntelligenceEnterpriseLearning,\n  cloneAgentForRequest,\n  configureAgentForRequest,\n  parseRunRequest,\n} from \"./shared/agent-utils\";\nimport { handleIntelligenceRun } from \"./intelligence/run\";\nimport { handleSseRun } from \"./sse/run\";\n\nexport async function handleRunAgent({\n  runtime,\n  request,\n  agentId,\n}: RunAgentParameters) {\n  telemetry.capture(\"oss.runtime.copilot_request_created\", {\n    \"cloud.guardrails.enabled\": false,\n    requestType: \"run\",\n    \"cloud.api_key_provided\": !!request.headers.get(\n      \"x-copilotcloud-public-api-key\",\n    ),\n    ...(request.headers.get(\"x-copilotcloud-public-api-key\")\n      ? {\n          \"cloud.public_api_key\": request.headers.get(\n            \"x-copilotcloud-public-api-key\",\n          )!,\n        }\n      : {}),\n  });\n\n  try {\n    const agent = await cloneAgentForRequest(runtime, agentId, request);\n    if (agent instanceof Response) {\n      return agent;\n    }\n\n    // Ensure the clone carries the registry key so InMemoryAgentRunner can\n    // tag historic runs with the correct agentId for filtering.\n    agent.agentId = agentId;\n\n    // Parse the body before configuring middleware: the request is single-read,\n    // and middleware configuration needs the A2UI catalog signal the React\n    // provider forwards (see `a2uiCatalogAvailable` below). Middleware is applied\n    // to the agent here; the run itself is kicked off later, so this is safe.\n    const input = await parseRunRequest(request);\n    if (input instanceof Response) {\n      return input;\n    }\n\n    // `<CopilotKit a2ui={{ catalog }}>` forwards this flag on every run. Its\n    // presence alone is enough to turn A2UI on end-to-end — no runtime-side\n    // `a2ui` config required.\n    const providerA2UIHasCatalog =\n      (input.forwardedProps as Record<string, unknown> | undefined)\n        ?.a2uiCatalogAvailable === true;\n\n    configureAgentForRequest({\n      runtime,\n      request,\n      agentId,\n      agent,\n      providerA2UIHasCatalog,\n    });\n    await attachIntelligenceEnterpriseLearning({ runtime, request, agent });\n\n    agent.setMessages(input.messages);\n    agent.setState(input.state);\n    agent.threadId = input.threadId;\n\n    if (runtime.debug?.lifecycle && runtime.debugLogger) {\n      runtime.debugLogger.debug(\n        { agentName: agentId, threadId: input.threadId },\n        \"Agent run started\",\n      );\n    }\n\n    if (isIntelligenceRuntime(runtime)) {\n      return handleIntelligenceRun({\n        runtime,\n        request,\n        agentId,\n        agent,\n        input,\n      });\n    }\n\n    return handleSseRun({\n      runtime,\n      request,\n      agent,\n      input,\n      agentId,\n      debug: runtime.debug,\n      logger: runtime.debugLogger,\n    });\n  } catch (error) {\n    console.error(\"Error running agent:\", error);\n    console.error(\n      \"Error stack:\",\n      error instanceof Error ? error.stack : \"No stack trace\",\n    );\n    console.error(\"Error details:\", {\n      name: error instanceof Error ? error.name : \"Unknown\",\n      message: error instanceof Error ? error.message : String(error),\n      cause: error instanceof Error ? error.cause : undefined,\n    });\n\n    return new Response(\n      JSON.stringify({\n        error: \"Failed to run agent\",\n        message: error instanceof Error ? error.message : \"Unknown error\",\n      }),\n      {\n        status: 500,\n        headers: { \"Content-Type\": \"application/json\" },\n      },\n    );\n  }\n}\n"],"mappings":";;;;;;;;AAYA,eAAsB,eAAe,EACnC,SACA,SACA,WACqB;AACrB,kCAAU,QAAQ,uCAAuC;EACvD,4BAA4B;EAC5B,aAAa;EACb,0BAA0B,CAAC,CAAC,QAAQ,QAAQ,IAC1C,gCACD;EACD,GAAI,QAAQ,QAAQ,IAAI,gCAAgC,GACpD,EACE,wBAAwB,QAAQ,QAAQ,IACtC,gCACD,EACF,GACD,EAAE;EACP,CAAC;AAEF,KAAI;EACF,MAAM,QAAQ,MAAMA,yCAAqB,SAAS,SAAS,QAAQ;AACnE,MAAI,iBAAiB,SACnB,QAAO;AAKT,QAAM,UAAU;EAMhB,MAAM,QAAQ,MAAMC,oCAAgB,QAAQ;AAC5C,MAAI,iBAAiB,SACnB,QAAO;AAUT,+CAAyB;GACvB;GACA;GACA;GACA;GACA,wBARC,MAAM,gBACH,yBAAyB;GAQ9B,CAAC;AACF,QAAMC,yDAAqC;GAAE;GAAS;GAAS;GAAO,CAAC;AAEvE,QAAM,YAAY,MAAM,SAAS;AACjC,QAAM,SAAS,MAAM,MAAM;AAC3B,QAAM,WAAW,MAAM;AAEvB,MAAI,QAAQ,OAAO,aAAa,QAAQ,YACtC,SAAQ,YAAY,MAClB;GAAE,WAAW;GAAS,UAAU,MAAM;GAAU,EAChD,oBACD;AAGH,MAAIC,sCAAsB,QAAQ,CAChC,QAAOC,kCAAsB;GAC3B;GACA;GACA;GACA;GACA;GACD,CAAC;AAGJ,SAAOC,2BAAa;GAClB;GACA;GACA;GACA;GACA;GACA,OAAO,QAAQ;GACf,QAAQ,QAAQ;GACjB,CAAC;UACK,OAAO;AACd,UAAQ,MAAM,wBAAwB,MAAM;AAC5C,UAAQ,MACN,gBACA,iBAAiB,QAAQ,MAAM,QAAQ,iBACxC;AACD,UAAQ,MAAM,kBAAkB;GAC9B,MAAM,iBAAiB,QAAQ,MAAM,OAAO;GAC5C,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;GAC/D,OAAO,iBAAiB,QAAQ,MAAM,QAAQ;GAC/C,CAAC;AAEF,SAAO,IAAI,SACT,KAAK,UAAU;GACb,OAAO;GACP,SAAS,iBAAiB,QAAQ,MAAM,UAAU;GACnD,CAAC,EACF;GACE,QAAQ;GACR,SAAS,EAAE,gBAAgB,oBAAoB;GAChD,CACF"}
+{"version":3,"file":"handle-run.cjs","names":["cloneAgentForRequest","parseRunRequest","attachIntelligenceEnterpriseLearning","isIntelligenceRuntime","handleIntelligenceRun","handleSseRun"],"sources":["../../../../src/v2/runtime/handlers/handle-run.ts"],"sourcesContent":["import { isIntelligenceRuntime } from \"../core/runtime\";\nimport { telemetry } from \"../telemetry\";\nimport type { RunAgentParameters } from \"./shared/agent-utils\";\nimport {\n  attachIntelligenceEnterpriseLearning,\n  cloneAgentForRequest,\n  configureAgentForRequest,\n  parseRunRequest,\n} from \"./shared/agent-utils\";\nimport { handleIntelligenceRun } from \"./intelligence/run\";\nimport { handleSseRun } from \"./sse/run\";\n\nexport async function handleRunAgent({\n  runtime,\n  request,\n  agentId,\n}: RunAgentParameters) {\n  telemetry.capture(\"oss.runtime.copilot_request_created\", {\n    \"cloud.guardrails.enabled\": false,\n    requestType: \"run\",\n    \"cloud.api_key_provided\": !!request.headers.get(\n      \"x-copilotcloud-public-api-key\",\n    ),\n    ...(request.headers.get(\"x-copilotcloud-public-api-key\")\n      ? {\n          \"cloud.public_api_key\": request.headers.get(\n            \"x-copilotcloud-public-api-key\",\n          )!,\n        }\n      : {}),\n  });\n\n  try {\n    const agent = await cloneAgentForRequest(runtime, agentId, request);\n    if (agent instanceof Response) {\n      return agent;\n    }\n\n    // Ensure the clone carries the registry key so InMemoryAgentRunner can\n    // tag historic runs with the correct agentId for filtering.\n    agent.agentId = agentId;\n\n    // Parse the body before configuring middleware: the request is single-read,\n    // and middleware configuration needs the A2UI catalog signal the React\n    // provider forwards (see `a2uiCatalogAvailable` below). Middleware is applied\n    // to the agent here; the run itself is kicked off later, so this is safe.\n    const input = await parseRunRequest(request);\n    if (input instanceof Response) {\n      return input;\n    }\n\n    // `<CopilotKit a2ui={{ catalog }}>` forwards this flag on every run. Its\n    // presence alone is enough to turn A2UI on end-to-end — no runtime-side\n    // `a2ui` config required.\n    const providerA2UIHasCatalog =\n      (input.forwardedProps as Record<string, unknown> | undefined)\n        ?.a2uiCatalogAvailable === true;\n\n    configureAgentForRequest({\n      runtime,\n      request,\n      agentId,\n      agent,\n      providerA2UIHasCatalog,\n    });\n    const memoryResponse = await attachIntelligenceEnterpriseLearning({\n      runtime,\n      request,\n      agent,\n    });\n    if (memoryResponse instanceof Response) return memoryResponse;\n\n    agent.setMessages(input.messages);\n    agent.setState(input.state);\n    agent.threadId = input.threadId;\n\n    if (runtime.debug?.lifecycle && runtime.debugLogger) {\n      runtime.debugLogger.debug(\n        { agentName: agentId, threadId: input.threadId },\n        \"Agent run started\",\n      );\n    }\n\n    if (isIntelligenceRuntime(runtime)) {\n      return handleIntelligenceRun({\n        runtime,\n        request,\n        agentId,\n        agent,\n        input,\n      });\n    }\n\n    return handleSseRun({\n      runtime,\n      request,\n      agent,\n      input,\n      agentId,\n      debug: runtime.debug,\n      logger: runtime.debugLogger,\n    });\n  } catch (error) {\n    console.error(\"Error running agent:\", error);\n    console.error(\n      \"Error stack:\",\n      error instanceof Error ? error.stack : \"No stack trace\",\n    );\n    console.error(\"Error details:\", {\n      name: error instanceof Error ? error.name : \"Unknown\",\n      message: error instanceof Error ? error.message : String(error),\n      cause: error instanceof Error ? error.cause : undefined,\n    });\n\n    return new Response(\n      JSON.stringify({\n        error: \"Failed to run agent\",\n        message: error instanceof Error ? error.message : \"Unknown error\",\n      }),\n      {\n        status: 500,\n        headers: { \"Content-Type\": \"application/json\" },\n      },\n    );\n  }\n}\n"],"mappings":";;;;;;;;AAYA,eAAsB,eAAe,EACnC,SACA,SACA,WACqB;AACrB,kCAAU,QAAQ,uCAAuC;EACvD,4BAA4B;EAC5B,aAAa;EACb,0BAA0B,CAAC,CAAC,QAAQ,QAAQ,IAC1C,gCACD;EACD,GAAI,QAAQ,QAAQ,IAAI,gCAAgC,GACpD,EACE,wBAAwB,QAAQ,QAAQ,IACtC,gCACD,EACF,GACD,EAAE;EACP,CAAC;AAEF,KAAI;EACF,MAAM,QAAQ,MAAMA,yCAAqB,SAAS,SAAS,QAAQ;AACnE,MAAI,iBAAiB,SACnB,QAAO;AAKT,QAAM,UAAU;EAMhB,MAAM,QAAQ,MAAMC,oCAAgB,QAAQ;AAC5C,MAAI,iBAAiB,SACnB,QAAO;AAUT,+CAAyB;GACvB;GACA;GACA;GACA;GACA,wBARC,MAAM,gBACH,yBAAyB;GAQ9B,CAAC;EACF,MAAM,iBAAiB,MAAMC,yDAAqC;GAChE;GACA;GACA;GACD,CAAC;AACF,MAAI,0BAA0B,SAAU,QAAO;AAE/C,QAAM,YAAY,MAAM,SAAS;AACjC,QAAM,SAAS,MAAM,MAAM;AAC3B,QAAM,WAAW,MAAM;AAEvB,MAAI,QAAQ,OAAO,aAAa,QAAQ,YACtC,SAAQ,YAAY,MAClB;GAAE,WAAW;GAAS,UAAU,MAAM;GAAU,EAChD,oBACD;AAGH,MAAIC,sCAAsB,QAAQ,CAChC,QAAOC,kCAAsB;GAC3B;GACA;GACA;GACA;GACA;GACD,CAAC;AAGJ,SAAOC,2BAAa;GAClB;GACA;GACA;GACA;GACA;GACA,OAAO,QAAQ;GACf,QAAQ,QAAQ;GACjB,CAAC;UACK,OAAO;AACd,UAAQ,MAAM,wBAAwB,MAAM;AAC5C,UAAQ,MACN,gBACA,iBAAiB,QAAQ,MAAM,QAAQ,iBACxC;AACD,UAAQ,MAAM,kBAAkB;GAC9B,MAAM,iBAAiB,QAAQ,MAAM,OAAO;GAC5C,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;GAC/D,OAAO,iBAAiB,QAAQ,MAAM,QAAQ;GAC/C,CAAC;AAEF,SAAO,IAAI,SACT,KAAK,UAAU;GACb,OAAO;GACP,SAAS,iBAAiB,QAAQ,MAAM,UAAU;GACnD,CAAC,EACF;GACE,QAAQ;GACR,SAAS,EAAE,gBAAgB,oBAAoB;GAChD,CACF"}

package/dist/v2/runtime/handlers/handle-run.mjs

@@ -26,11 +26,12 @@ async function handleRunAgent({ runtime, request, agentId }) {
 			agent,
 			providerA2UIHasCatalog: input.forwardedProps?.a2uiCatalogAvailable === true
 		});
-		await attachIntelligenceEnterpriseLearning({
+		const memoryResponse = await attachIntelligenceEnterpriseLearning({
 			runtime,
 			request,
 			agent
 		});
+		if (memoryResponse instanceof Response) return memoryResponse;
 		agent.setMessages(input.messages);
 		agent.setState(input.state);
 		agent.threadId = input.threadId;

package/dist/v2/runtime/handlers/handle-run.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"handle-run.mjs","names":[],"sources":["../../../../src/v2/runtime/handlers/handle-run.ts"],"sourcesContent":["import { isIntelligenceRuntime } from \"../core/runtime\";\nimport { telemetry } from \"../telemetry\";\nimport type { RunAgentParameters } from \"./shared/agent-utils\";\nimport {\n  attachIntelligenceEnterpriseLearning,\n  cloneAgentForRequest,\n  configureAgentForRequest,\n  parseRunRequest,\n} from \"./shared/agent-utils\";\nimport { handleIntelligenceRun } from \"./intelligence/run\";\nimport { handleSseRun } from \"./sse/run\";\n\nexport async function handleRunAgent({\n  runtime,\n  request,\n  agentId,\n}: RunAgentParameters) {\n  telemetry.capture(\"oss.runtime.copilot_request_created\", {\n    \"cloud.guardrails.enabled\": false,\n    requestType: \"run\",\n    \"cloud.api_key_provided\": !!request.headers.get(\n      \"x-copilotcloud-public-api-key\",\n    ),\n    ...(request.headers.get(\"x-copilotcloud-public-api-key\")\n      ? {\n          \"cloud.public_api_key\": request.headers.get(\n            \"x-copilotcloud-public-api-key\",\n          )!,\n        }\n      : {}),\n  });\n\n  try {\n    const agent = await cloneAgentForRequest(runtime, agentId, request);\n    if (agent instanceof Response) {\n      return agent;\n    }\n\n    // Ensure the clone carries the registry key so InMemoryAgentRunner can\n    // tag historic runs with the correct agentId for filtering.\n    agent.agentId = agentId;\n\n    // Parse the body before configuring middleware: the request is single-read,\n    // and middleware configuration needs the A2UI catalog signal the React\n    // provider forwards (see `a2uiCatalogAvailable` below). Middleware is applied\n    // to the agent here; the run itself is kicked off later, so this is safe.\n    const input = await parseRunRequest(request);\n    if (input instanceof Response) {\n      return input;\n    }\n\n    // `<CopilotKit a2ui={{ catalog }}>` forwards this flag on every run. Its\n    // presence alone is enough to turn A2UI on end-to-end — no runtime-side\n    // `a2ui` config required.\n    const providerA2UIHasCatalog =\n      (input.forwardedProps as Record<string, unknown> | undefined)\n        ?.a2uiCatalogAvailable === true;\n\n    configureAgentForRequest({\n      runtime,\n      request,\n      agentId,\n      agent,\n      providerA2UIHasCatalog,\n    });\n    await attachIntelligenceEnterpriseLearning({ runtime, request, agent });\n\n    agent.setMessages(input.messages);\n    agent.setState(input.state);\n    agent.threadId = input.threadId;\n\n    if (runtime.debug?.lifecycle && runtime.debugLogger) {\n      runtime.debugLogger.debug(\n        { agentName: agentId, threadId: input.threadId },\n        \"Agent run started\",\n      );\n    }\n\n    if (isIntelligenceRuntime(runtime)) {\n      return handleIntelligenceRun({\n        runtime,\n        request,\n        agentId,\n        agent,\n        input,\n      });\n    }\n\n    return handleSseRun({\n      runtime,\n      request,\n      agent,\n      input,\n      agentId,\n      debug: runtime.debug,\n      logger: runtime.debugLogger,\n    });\n  } catch (error) {\n    console.error(\"Error running agent:\", error);\n    console.error(\n      \"Error stack:\",\n      error instanceof Error ? error.stack : \"No stack trace\",\n    );\n    console.error(\"Error details:\", {\n      name: error instanceof Error ? error.name : \"Unknown\",\n      message: error instanceof Error ? error.message : String(error),\n      cause: error instanceof Error ? error.cause : undefined,\n    });\n\n    return new Response(\n      JSON.stringify({\n        error: \"Failed to run agent\",\n        message: error instanceof Error ? error.message : \"Unknown error\",\n      }),\n      {\n        status: 500,\n        headers: { \"Content-Type\": \"application/json\" },\n      },\n    );\n  }\n}\n"],"mappings":";;;;;;;;AAYA,eAAsB,eAAe,EACnC,SACA,SACA,WACqB;AACrB,WAAU,QAAQ,uCAAuC;EACvD,4BAA4B;EAC5B,aAAa;EACb,0BAA0B,CAAC,CAAC,QAAQ,QAAQ,IAC1C,gCACD;EACD,GAAI,QAAQ,QAAQ,IAAI,gCAAgC,GACpD,EACE,wBAAwB,QAAQ,QAAQ,IACtC,gCACD,EACF,GACD,EAAE;EACP,CAAC;AAEF,KAAI;EACF,MAAM,QAAQ,MAAM,qBAAqB,SAAS,SAAS,QAAQ;AACnE,MAAI,iBAAiB,SACnB,QAAO;AAKT,QAAM,UAAU;EAMhB,MAAM,QAAQ,MAAM,gBAAgB,QAAQ;AAC5C,MAAI,iBAAiB,SACnB,QAAO;AAUT,2BAAyB;GACvB;GACA;GACA;GACA;GACA,wBARC,MAAM,gBACH,yBAAyB;GAQ9B,CAAC;AACF,QAAM,qCAAqC;GAAE;GAAS;GAAS;GAAO,CAAC;AAEvE,QAAM,YAAY,MAAM,SAAS;AACjC,QAAM,SAAS,MAAM,MAAM;AAC3B,QAAM,WAAW,MAAM;AAEvB,MAAI,QAAQ,OAAO,aAAa,QAAQ,YACtC,SAAQ,YAAY,MAClB;GAAE,WAAW;GAAS,UAAU,MAAM;GAAU,EAChD,oBACD;AAGH,MAAI,sBAAsB,QAAQ,CAChC,QAAO,sBAAsB;GAC3B;GACA;GACA;GACA;GACA;GACD,CAAC;AAGJ,SAAO,aAAa;GAClB;GACA;GACA;GACA;GACA;GACA,OAAO,QAAQ;GACf,QAAQ,QAAQ;GACjB,CAAC;UACK,OAAO;AACd,UAAQ,MAAM,wBAAwB,MAAM;AAC5C,UAAQ,MACN,gBACA,iBAAiB,QAAQ,MAAM,QAAQ,iBACxC;AACD,UAAQ,MAAM,kBAAkB;GAC9B,MAAM,iBAAiB,QAAQ,MAAM,OAAO;GAC5C,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;GAC/D,OAAO,iBAAiB,QAAQ,MAAM,QAAQ;GAC/C,CAAC;AAEF,SAAO,IAAI,SACT,KAAK,UAAU;GACb,OAAO;GACP,SAAS,iBAAiB,QAAQ,MAAM,UAAU;GACnD,CAAC,EACF;GACE,QAAQ;GACR,SAAS,EAAE,gBAAgB,oBAAoB;GAChD,CACF"}
+{"version":3,"file":"handle-run.mjs","names":[],"sources":["../../../../src/v2/runtime/handlers/handle-run.ts"],"sourcesContent":["import { isIntelligenceRuntime } from \"../core/runtime\";\nimport { telemetry } from \"../telemetry\";\nimport type { RunAgentParameters } from \"./shared/agent-utils\";\nimport {\n  attachIntelligenceEnterpriseLearning,\n  cloneAgentForRequest,\n  configureAgentForRequest,\n  parseRunRequest,\n} from \"./shared/agent-utils\";\nimport { handleIntelligenceRun } from \"./intelligence/run\";\nimport { handleSseRun } from \"./sse/run\";\n\nexport async function handleRunAgent({\n  runtime,\n  request,\n  agentId,\n}: RunAgentParameters) {\n  telemetry.capture(\"oss.runtime.copilot_request_created\", {\n    \"cloud.guardrails.enabled\": false,\n    requestType: \"run\",\n    \"cloud.api_key_provided\": !!request.headers.get(\n      \"x-copilotcloud-public-api-key\",\n    ),\n    ...(request.headers.get(\"x-copilotcloud-public-api-key\")\n      ? {\n          \"cloud.public_api_key\": request.headers.get(\n            \"x-copilotcloud-public-api-key\",\n          )!,\n        }\n      : {}),\n  });\n\n  try {\n    const agent = await cloneAgentForRequest(runtime, agentId, request);\n    if (agent instanceof Response) {\n      return agent;\n    }\n\n    // Ensure the clone carries the registry key so InMemoryAgentRunner can\n    // tag historic runs with the correct agentId for filtering.\n    agent.agentId = agentId;\n\n    // Parse the body before configuring middleware: the request is single-read,\n    // and middleware configuration needs the A2UI catalog signal the React\n    // provider forwards (see `a2uiCatalogAvailable` below). Middleware is applied\n    // to the agent here; the run itself is kicked off later, so this is safe.\n    const input = await parseRunRequest(request);\n    if (input instanceof Response) {\n      return input;\n    }\n\n    // `<CopilotKit a2ui={{ catalog }}>` forwards this flag on every run. Its\n    // presence alone is enough to turn A2UI on end-to-end — no runtime-side\n    // `a2ui` config required.\n    const providerA2UIHasCatalog =\n      (input.forwardedProps as Record<string, unknown> | undefined)\n        ?.a2uiCatalogAvailable === true;\n\n    configureAgentForRequest({\n      runtime,\n      request,\n      agentId,\n      agent,\n      providerA2UIHasCatalog,\n    });\n    const memoryResponse = await attachIntelligenceEnterpriseLearning({\n      runtime,\n      request,\n      agent,\n    });\n    if (memoryResponse instanceof Response) return memoryResponse;\n\n    agent.setMessages(input.messages);\n    agent.setState(input.state);\n    agent.threadId = input.threadId;\n\n    if (runtime.debug?.lifecycle && runtime.debugLogger) {\n      runtime.debugLogger.debug(\n        { agentName: agentId, threadId: input.threadId },\n        \"Agent run started\",\n      );\n    }\n\n    if (isIntelligenceRuntime(runtime)) {\n      return handleIntelligenceRun({\n        runtime,\n        request,\n        agentId,\n        agent,\n        input,\n      });\n    }\n\n    return handleSseRun({\n      runtime,\n      request,\n      agent,\n      input,\n      agentId,\n      debug: runtime.debug,\n      logger: runtime.debugLogger,\n    });\n  } catch (error) {\n    console.error(\"Error running agent:\", error);\n    console.error(\n      \"Error stack:\",\n      error instanceof Error ? error.stack : \"No stack trace\",\n    );\n    console.error(\"Error details:\", {\n      name: error instanceof Error ? error.name : \"Unknown\",\n      message: error instanceof Error ? error.message : String(error),\n      cause: error instanceof Error ? error.cause : undefined,\n    });\n\n    return new Response(\n      JSON.stringify({\n        error: \"Failed to run agent\",\n        message: error instanceof Error ? error.message : \"Unknown error\",\n      }),\n      {\n        status: 500,\n        headers: { \"Content-Type\": \"application/json\" },\n      },\n    );\n  }\n}\n"],"mappings":";;;;;;;;AAYA,eAAsB,eAAe,EACnC,SACA,SACA,WACqB;AACrB,WAAU,QAAQ,uCAAuC;EACvD,4BAA4B;EAC5B,aAAa;EACb,0BAA0B,CAAC,CAAC,QAAQ,QAAQ,IAC1C,gCACD;EACD,GAAI,QAAQ,QAAQ,IAAI,gCAAgC,GACpD,EACE,wBAAwB,QAAQ,QAAQ,IACtC,gCACD,EACF,GACD,EAAE;EACP,CAAC;AAEF,KAAI;EACF,MAAM,QAAQ,MAAM,qBAAqB,SAAS,SAAS,QAAQ;AACnE,MAAI,iBAAiB,SACnB,QAAO;AAKT,QAAM,UAAU;EAMhB,MAAM,QAAQ,MAAM,gBAAgB,QAAQ;AAC5C,MAAI,iBAAiB,SACnB,QAAO;AAUT,2BAAyB;GACvB;GACA;GACA;GACA;GACA,wBARC,MAAM,gBACH,yBAAyB;GAQ9B,CAAC;EACF,MAAM,iBAAiB,MAAM,qCAAqC;GAChE;GACA;GACA;GACD,CAAC;AACF,MAAI,0BAA0B,SAAU,QAAO;AAE/C,QAAM,YAAY,MAAM,SAAS;AACjC,QAAM,SAAS,MAAM,MAAM;AAC3B,QAAM,WAAW,MAAM;AAEvB,MAAI,QAAQ,OAAO,aAAa,QAAQ,YACtC,SAAQ,YAAY,MAClB;GAAE,WAAW;GAAS,UAAU,MAAM;GAAU,EAChD,oBACD;AAGH,MAAI,sBAAsB,QAAQ,CAChC,QAAO,sBAAsB;GAC3B;GACA;GACA;GACA;GACA;GACD,CAAC;AAGJ,SAAO,aAAa;GAClB;GACA;GACA;GACA;GACA;GACA,OAAO,QAAQ;GACf,QAAQ,QAAQ;GACjB,CAAC;UACK,OAAO;AACd,UAAQ,MAAM,wBAAwB,MAAM;AAC5C,UAAQ,MACN,gBACA,iBAAiB,QAAQ,MAAM,QAAQ,iBACxC;AACD,UAAQ,MAAM,kBAAkB;GAC9B,MAAM,iBAAiB,QAAQ,MAAM,OAAO;GAC5C,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;GAC/D,OAAO,iBAAiB,QAAQ,MAAM,QAAQ;GAC/C,CAAC;AAEF,SAAO,IAAI,SACT,KAAK,UAAU;GACb,OAAO;GACP,SAAS,iBAAiB,QAAQ,MAAM,UAAU;GACnD,CAAC,EACF;GACE,QAAQ;GACR,SAAS,EAAE,gBAAgB,oBAAoB;GAChD,CACF"}

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

@@ -4,9 +4,18 @@ const require_runtime$1 = require('../../core/runtime.cjs');
 const require_client = require('../../intelligence-platform/client.cjs');
 const require_json_response = require('../shared/json-response.cjs');
 const require_resolve_intelligence_user = require('../shared/resolve-intelligence-user.cjs');
+const require_memory_policy = require('../shared/memory-policy.cjs');
 let _copilotkit_shared = require("@copilotkit/shared");
 
 //#region src/v2/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;
+	return require_memory_policy.resolveWebMemory(runtime, request, user, "client");
+}
 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([
@@ -95,13 +104,11 @@ function parseRecallBody(body) {
 async function handleListMemories({ runtime, request }) {
 	if (require_runtime$1.isIntelligenceRuntime(runtime)) try {
 		const includeInvalidated = new URL(request.url).searchParams.get("includeInvalidated") === "true";
-		const user = await require_resolve_intelligence_user.resolveIntelligenceUser({
-			runtime,
-			request
-		});
-		if (require_json_response.isHandlerResponse(user)) return user;
+		const access = await resolveClientMemory(runtime, request);
+		if (require_json_response.isHandlerResponse(access)) return access;
 		const data = await runtime.intelligence.listMemories({
-			userId: user.id,
+			userId: access.user.id,
+			...runtime.memory ? { memoryGrant: access.grant } : {},
 			...includeInvalidated ? { includeInvalidated: true } : {}
 		});
 		if (data == null || typeof data !== "object" || !Array.isArray(data.memories)) {
@@ -130,13 +137,11 @@ async function handleRecallMemories({ runtime, request }) {
 		if (require_json_response.isHandlerResponse(body)) return body;
 		const fields = parseRecallBody(body);
 		if (require_json_response.isHandlerResponse(fields)) return fields;
-		const user = await require_resolve_intelligence_user.resolveIntelligenceUser({
-			runtime,
-			request
-		});
-		if (require_json_response.isHandlerResponse(user)) return user;
+		const access = await resolveClientMemory(runtime, request);
+		if (require_json_response.isHandlerResponse(access)) return access;
 		const data = await runtime.intelligence.recallMemories({
-			userId: user.id,
+			userId: access.user.id,
+			...runtime.memory ? { memoryGrant: access.grant } : {},
 			...fields
 		});
 		if (data == null || typeof data !== "object" || !Array.isArray(data.memories)) {
@@ -166,15 +171,15 @@ async function handleRecallMemories({ runtime, request }) {
 */
 async function handleSubscribeToMemories({ runtime, request }) {
 	if (require_runtime$1.isIntelligenceRuntime(runtime)) try {
-		const user = await require_resolve_intelligence_user.resolveIntelligenceUser({
-			runtime,
-			request
+		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 } : {}
 		});
-		if (require_json_response.isHandlerResponse(user)) return user;
-		const credentials = await runtime.intelligence.ɵsubscribeToMemories({ userId: user.id });
 		return Response.json({
-			joinToken: credentials.joinToken,
-			joinCode: credentials.joinCode,
+			...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 } : {}
 		});
@@ -196,13 +201,11 @@ async function handleCreateMemory({ runtime, request }) {
 		if (require_json_response.isHandlerResponse(body)) return body;
 		const fields = parseMemoryBody(body);
 		if (require_json_response.isHandlerResponse(fields)) return fields;
-		const user = await require_resolve_intelligence_user.resolveIntelligenceUser({
-			runtime,
-			request
-		});
-		if (require_json_response.isHandlerResponse(user)) return user;
+		const access = await resolveClientMemory(runtime, request);
+		if (require_json_response.isHandlerResponse(access)) return access;
 		const data = await runtime.intelligence.createMemory({
-			userId: user.id,
+			userId: access.user.id,
+			...runtime.memory ? { memoryGrant: access.grant } : {},
 			...fields
 		});
 		return Response.json(data, { status: 201 });
@@ -222,13 +225,11 @@ async function handleUpdateMemory({ runtime, request, memoryId }) {
 		if (require_json_response.isHandlerResponse(body)) return body;
 		const fields = parseMemoryBody(body);
 		if (require_json_response.isHandlerResponse(fields)) return fields;
-		const user = await require_resolve_intelligence_user.resolveIntelligenceUser({
-			runtime,
-			request
-		});
-		if (require_json_response.isHandlerResponse(user)) return user;
+		const access = await resolveClientMemory(runtime, request);
+		if (require_json_response.isHandlerResponse(access)) return access;
 		const data = await runtime.intelligence.updateMemory({
-			userId: user.id,
+			userId: access.user.id,
+			...runtime.memory ? { memoryGrant: access.grant } : {},
 			id: memoryId,
 			...fields
 		});
@@ -245,14 +246,12 @@ async function handleUpdateMemory({ runtime, request, memoryId }) {
 async function handleRemoveMemory({ runtime, request, memoryId }) {
 	if (!require_runtime$1.isIntelligenceRuntime(runtime)) return require_json_response.errorResponse(MISSING_INTELLIGENCE_MESSAGE, 422);
 	try {
-		const user = await require_resolve_intelligence_user.resolveIntelligenceUser({
-			runtime,
-			request
-		});
-		if (require_json_response.isHandlerResponse(user)) return user;
+		const access = await resolveClientMemory(runtime, request);
+		if (require_json_response.isHandlerResponse(access)) return access;
 		await runtime.intelligence.removeMemory({
-			userId: user.id,
-			id: memoryId
+			userId: access.user.id,
+			id: memoryId,
+			...runtime.memory ? { memoryGrant: access.grant } : {}
 		});
 		return new Response(null, { status: 204 });
 	} catch (error) {

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

@@ -1 +1 @@
-{"version":3,"file":"memories.cjs","names":["PlatformRequestError","errorResponse","isIntelligenceRuntime","resolveIntelligenceUser","isHandlerResponse"],"sources":["../../../../../src/v2/runtime/handlers/intelligence/memories.ts"],"sourcesContent":["import type { CopilotRuntimeLike } 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 { PlatformRequestError } from \"../../intelligence-platform/client\";\n\ninterface MemoriesHandlerParams {\n  runtime: CopilotRuntimeLike;\n  request: Request;\n}\n\ninterface MemoryMutationParams extends MemoriesHandlerParams {\n  memoryId: string;\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 * For a {@link PlatformRequestError}, forward only client-actionable **4xx**\n * statuses verbatim (e.g. 404 missing/wrong-scope memory, 409 conflict, 422\n * unprocessable) so a `useMemories` consumer can branch on them — a flat 500\n * would erase that distinction. A platform **5xx** (or any non-4xx / malformed\n * status) means the runtime is healthy but its dependency failed, so it surfaces\n * as `502 Bad Gateway` rather than echoing the upstream status as if the runtime\n * itself broke — and this also avoids a `new Response(..., { status })`\n * `RangeError` on an out-of-range status. Non-platform throws stay 500.\n */\nfunction memoryErrorResponse(error: unknown, message: string): Response {\n  if (error instanceof PlatformRequestError) {\n    const { status } = error;\n    if (Number.isInteger(status) && status >= 400 && status <= 499) {\n      return errorResponse(message, status);\n    }\n    return errorResponse(message, 502);\n  }\n  return errorResponse(message, 500);\n}\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 the Intelligence platform.\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 user = await resolveIntelligenceUser({ runtime, request });\n      if (isHandlerResponse(user)) return user;\n\n      const data = await runtime.intelligence.listMemories({\n        userId: user.id,\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 user = await resolveIntelligenceUser({ runtime, request });\n    if (isHandlerResponse(user)) return user;\n\n    const data = await runtime.intelligence.recallMemories({\n      userId: user.id,\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 user = await resolveIntelligenceUser({ runtime, request });\n      if (isHandlerResponse(user)) return user;\n\n      const credentials = await runtime.intelligence.ɵsubscribeToMemories({\n        userId: user.id,\n      });\n\n      return Response.json({\n        joinToken: credentials.joinToken,\n        joinCode: credentials.joinCode,\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 user = await resolveIntelligenceUser({ runtime, request });\n    if (isHandlerResponse(user)) return user;\n\n    const data = await runtime.intelligence.createMemory({\n      userId: user.id,\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 user = await resolveIntelligenceUser({ runtime, request });\n    if (isHandlerResponse(user)) return user;\n\n    const data = await runtime.intelligence.updateMemory({\n      userId: user.id,\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 user = await resolveIntelligenceUser({ runtime, request });\n    if (isHandlerResponse(user)) return user;\n\n    await runtime.intelligence.removeMemory({ userId: user.id, id: memoryId });\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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"}
+{"version":3,"file":"memories.cjs","names":["resolveIntelligenceUser","isHandlerResponse","resolveWebMemory","PlatformRequestError","errorResponse","isIntelligenceRuntime"],"sources":["../../../../../src/v2/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 { resolveWebMemory } from \"../shared/memory-policy\";\nimport { PlatformRequestError } from \"../../intelligence-platform/client\";\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  return resolveWebMemory(runtime, request, user, \"client\");\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 * For a {@link PlatformRequestError}, forward only client-actionable **4xx**\n * statuses verbatim (e.g. 404 missing/wrong-scope memory, 409 conflict, 422\n * unprocessable) so a `useMemories` consumer can branch on them — a flat 500\n * would erase that distinction. A platform **5xx** (or any non-4xx / malformed\n * status) means the runtime is healthy but its dependency failed, so it surfaces\n * as `502 Bad Gateway` rather than echoing the upstream status as if the runtime\n * itself broke — and this also avoids a `new Response(..., { status })`\n * `RangeError` on an out-of-range status. Non-platform throws stay 500.\n */\nfunction memoryErrorResponse(error: unknown, message: string): Response {\n  if (error instanceof PlatformRequestError) {\n    const { status } = error;\n    if (Number.isInteger(status) && status >= 400 && status <= 499) {\n      return errorResponse(message, status);\n    }\n    return errorResponse(message, 502);\n  }\n  return errorResponse(message, 500);\n}\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 the Intelligence platform.\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/v2/runtime/handlers/intelligence/memories.mjs

@@ -3,9 +3,18 @@ import { isIntelligenceRuntime } from "../../core/runtime.mjs";
 import { PlatformRequestError } from "../../intelligence-platform/client.mjs";
 import { errorResponse, isHandlerResponse } from "../shared/json-response.mjs";
 import { resolveIntelligenceUser } from "../shared/resolve-intelligence-user.mjs";
+import { resolveWebMemory } from "../shared/memory-policy.mjs";
 import { logger } from "@copilotkit/shared";
 
 //#region src/v2/runtime/handlers/intelligence/memories.ts
+async function resolveClientMemory(runtime, request) {
+	const user = await resolveIntelligenceUser({
+		runtime,
+		request
+	});
+	if (isHandlerResponse(user)) return user;
+	return resolveWebMemory(runtime, request, user, "client");
+}
 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([
@@ -94,13 +103,11 @@ function parseRecallBody(body) {
 async function handleListMemories({ runtime, request }) {
 	if (isIntelligenceRuntime(runtime)) try {
 		const includeInvalidated = new URL(request.url).searchParams.get("includeInvalidated") === "true";
-		const user = await resolveIntelligenceUser({
-			runtime,
-			request
-		});
-		if (isHandlerResponse(user)) return user;
+		const access = await resolveClientMemory(runtime, request);
+		if (isHandlerResponse(access)) return access;
 		const data = await runtime.intelligence.listMemories({
-			userId: user.id,
+			userId: access.user.id,
+			...runtime.memory ? { memoryGrant: access.grant } : {},
 			...includeInvalidated ? { includeInvalidated: true } : {}
 		});
 		if (data == null || typeof data !== "object" || !Array.isArray(data.memories)) {
@@ -129,13 +136,11 @@ async function handleRecallMemories({ runtime, request }) {
 		if (isHandlerResponse(body)) return body;
 		const fields = parseRecallBody(body);
 		if (isHandlerResponse(fields)) return fields;
-		const user = await resolveIntelligenceUser({
-			runtime,
-			request
-		});
-		if (isHandlerResponse(user)) return user;
+		const access = await resolveClientMemory(runtime, request);
+		if (isHandlerResponse(access)) return access;
 		const data = await runtime.intelligence.recallMemories({
-			userId: user.id,
+			userId: access.user.id,
+			...runtime.memory ? { memoryGrant: access.grant } : {},
 			...fields
 		});
 		if (data == null || typeof data !== "object" || !Array.isArray(data.memories)) {
@@ -165,15 +170,15 @@ async function handleRecallMemories({ runtime, request }) {
 */
 async function handleSubscribeToMemories({ runtime, request }) {
 	if (isIntelligenceRuntime(runtime)) try {
-		const user = await resolveIntelligenceUser({
-			runtime,
-			request
+		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 } : {}
 		});
-		if (isHandlerResponse(user)) return user;
-		const credentials = await runtime.intelligence.ɵsubscribeToMemories({ userId: user.id });
 		return Response.json({
-			joinToken: credentials.joinToken,
-			joinCode: credentials.joinCode,
+			...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 } : {}
 		});
@@ -195,13 +200,11 @@ async function handleCreateMemory({ runtime, request }) {
 		if (isHandlerResponse(body)) return body;
 		const fields = parseMemoryBody(body);
 		if (isHandlerResponse(fields)) return fields;
-		const user = await resolveIntelligenceUser({
-			runtime,
-			request
-		});
-		if (isHandlerResponse(user)) return user;
+		const access = await resolveClientMemory(runtime, request);
+		if (isHandlerResponse(access)) return access;
 		const data = await runtime.intelligence.createMemory({
-			userId: user.id,
+			userId: access.user.id,
+			...runtime.memory ? { memoryGrant: access.grant } : {},
 			...fields
 		});
 		return Response.json(data, { status: 201 });
@@ -221,13 +224,11 @@ async function handleUpdateMemory({ runtime, request, memoryId }) {
 		if (isHandlerResponse(body)) return body;
 		const fields = parseMemoryBody(body);
 		if (isHandlerResponse(fields)) return fields;
-		const user = await resolveIntelligenceUser({
-			runtime,
-			request
-		});
-		if (isHandlerResponse(user)) return user;
+		const access = await resolveClientMemory(runtime, request);
+		if (isHandlerResponse(access)) return access;
 		const data = await runtime.intelligence.updateMemory({
-			userId: user.id,
+			userId: access.user.id,
+			...runtime.memory ? { memoryGrant: access.grant } : {},
 			id: memoryId,
 			...fields
 		});
@@ -244,14 +245,12 @@ async function handleUpdateMemory({ runtime, request, memoryId }) {
 async function handleRemoveMemory({ runtime, request, memoryId }) {
 	if (!isIntelligenceRuntime(runtime)) return errorResponse(MISSING_INTELLIGENCE_MESSAGE, 422);
 	try {
-		const user = await resolveIntelligenceUser({
-			runtime,
-			request
-		});
-		if (isHandlerResponse(user)) return user;
+		const access = await resolveClientMemory(runtime, request);
+		if (isHandlerResponse(access)) return access;
 		await runtime.intelligence.removeMemory({
-			userId: user.id,
-			id: memoryId
+			userId: access.user.id,
+			id: memoryId,
+			...runtime.memory ? { memoryGrant: access.grant } : {}
 		});
 		return new Response(null, { status: 204 });
 	} catch (error) {