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

package/dist/runtime/handlers/shared/agent-utils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-utils.mjs","names":[],"sources":["../../../../src/runtime/handlers/shared/agent-utils.ts"],"sourcesContent":["import type { AbstractAgent, RunAgentInput } from \"@ag-ui/client\";\nimport { RunAgentInputSchema } from \"@ag-ui/core/schemas\";\nimport type { CopilotKitUIEnvelope } from \"@copilotkit/shared\";\nimport {\n  A2UIMiddleware,\n  OpenGenerativeUIMiddleware,\n} from \"@copilotkit/shared/event-transforms\";\nimport { MCPAppsMiddleware } from \"@ag-ui/mcp-apps-middleware\";\nimport { MCPMiddleware } from \"@ag-ui/mcp-middleware\";\nimport { GenerativeUIMiddleware } from \"../../generative-ui\";\nimport type { CopilotRuntimeLike } from \"../../core/runtime\";\nimport {\n  isA2UIEnabled,\n  isIntelligenceRuntime,\n  resolveAgents,\n} from \"../../core/runtime\";\nimport {\n  INTELLIGENCE_MEMORY_GRANT_HEADER,\n  INTELLIGENCE_USER_ID_HEADER,\n} from \"../../intelligence-platform/client\";\nimport {\n  mergeForwardableHeaders,\n  resolveForwardHeadersPolicy,\n} from \"../header-utils\";\nimport { resolveMcpAppsServers } from \"./mcp-apps-servers\";\nimport { resolveIntelligenceUser } from \"./resolve-intelligence-user\";\nimport { grantAllowsMemory, resolveWebMemory } from \"./memory-policy\";\nimport { errorResponse } from \"./json-response\";\nimport { logger } from \"@copilotkit/shared\";\n\ntype MiddlewareCapableAgent = AbstractAgent & {\n  use?: (middleware: unknown) => void;\n  headers?: Record<string, string>;\n};\n\nexport interface RunAgentParameters {\n  request: Request;\n  runtime: CopilotRuntimeLike;\n  agentId: string;\n}\n\nexport interface ConnectRequestBody extends RunAgentInput {\n  lastSeenEventId?: string | null;\n}\n\n/**\n * Resolve `agentId` against the runtime's agents and return a per-request\n * clone of the matching agent.\n *\n * Dual return contract — both callers (`handle-run.ts`, `handle-connect.ts`)\n * depend on it:\n * - Returns a cloned `AbstractAgent` when the agent exists.\n * - Returns a 404 `Response` (`{ error: \"Agent not found\", ... }`) when the\n *   agent is unknown. Callers MUST `instanceof Response`-check the result and\n *   return it directly; this doubles as the connect/run path's agent-existence\n *   guard, so skipping the check would let unknown agent ids slip through.\n *\n * The clone is what subsequent per-request mutation (middleware attach,\n * `agent.headers` merge) operates on, leaving the shared agent registration\n * untouched.\n */\nexport async function cloneAgentForRequest(\n  runtime: CopilotRuntimeLike,\n  agentId: string,\n  request?: Request,\n): Promise<AbstractAgent | Response> {\n  const agents = await resolveAgents(runtime.agents, request);\n\n  if (!agents[agentId]) {\n    return new Response(\n      JSON.stringify({\n        error: \"Agent not found\",\n        message: `Agent '${agentId}' does not exist`,\n      }),\n      {\n        status: 404,\n        headers: { \"Content-Type\": \"application/json\" },\n      },\n    );\n  }\n\n  return (agents[agentId] as AbstractAgent).clone() as AbstractAgent;\n}\n\nexport function configureAgentForRequest(params: {\n  runtime: CopilotRuntimeLike;\n  request: Request;\n  agentId: string;\n  agent: AbstractAgent;\n  /**\n   * True when the React provider was given an A2UI catalog\n   * (`<CopilotKit a2ui={{ catalog }}>`), forwarded per-run. A catalog alone is\n   * enough to enable A2UI and inject the render tool — the developer no longer\n   * has to also set `a2ui.injectA2UITool` on the runtime.\n   */\n  providerA2UIHasCatalog?: boolean;\n  /**\n   * The transport of the generative UI envelope that the client sent on this\n   * run (`forwardedProps.copilotkit.ui`). Not set when the run has no envelope.\n   */\n  providerGenerativeUITransport?: CopilotKitUIEnvelope[\"metadata\"][\"extensions\"][\"copilotkit_transport\"];\n  /** Retain proxy rejection even when no server is available to this agent. */\n  isMcpProxyRequest?: boolean;\n}): void {\n  const {\n    runtime,\n    request,\n    agentId,\n    providerA2UIHasCatalog,\n    isMcpProxyRequest,\n  } = params;\n  const agent = params.agent as MiddlewareCapableAgent;\n\n  // A2UI is on when the runtime explicitly enables it, OR when the provider\n  // forwarded a catalog — but an explicit `enabled: false` always wins (we\n  // provide a quick default, never override a deeper opt-out).\n  const a2uiEnabledByCatalog =\n    !!providerA2UIHasCatalog && runtime.a2ui?.enabled !== false;\n\n  if (isA2UIEnabled(runtime.a2ui) || a2uiEnabledByCatalog) {\n    // `enabled` is a CopilotKit-level switch, not an A2UIMiddleware option —\n    // drop it (alongside the agent filter) before forwarding to the middleware.\n    const {\n      agents: targetAgents,\n      enabled: _enabled,\n      injectA2UITool,\n      ...a2uiOptions\n    } = runtime.a2ui ?? {};\n    const shouldApply = !targetAgents || targetAgents.includes(agentId);\n    if (shouldApply && typeof agent.use === \"function\") {\n      agent.use(\n        new A2UIMiddleware({\n          ...a2uiOptions,\n          // Default render-tool injection on when a catalog is present and the\n          // developer hasn't set it explicitly. `??` means an explicit value\n          // (including `false`) is always respected.\n          injectA2UITool:\n            injectA2UITool ?? (providerA2UIHasCatalog ? true : undefined),\n        }),\n      );\n    }\n  }\n\n  if (isIntelligenceRuntime(runtime) && typeof agent.use === \"function\") {\n    // Ordinary runs need no middleware without selected servers. Proxy requests\n    // still need the upstream guard so they cannot fall through to the model.\n    const mcpServers = resolveMcpAppsServers(\n      runtime.mcpApps?.servers ?? [],\n      agentId,\n    );\n    if (mcpServers.length > 0 || isMcpProxyRequest) {\n      agent.use(\n        new MCPAppsMiddleware({ mcpServers, discoveryFailureMode: \"throw\" }),\n      );\n    }\n  } else if (runtime.mcpApps?.servers?.length) {\n    const mcpServers = resolveMcpAppsServers(runtime.mcpApps.servers, agentId);\n\n    if (mcpServers.length > 0 && typeof agent.use === \"function\") {\n      agent.use(new MCPAppsMiddleware({ mcpServers }));\n    }\n  }\n\n  if (runtime.openGenerativeUI) {\n    const config = runtime.openGenerativeUI;\n    const targetAgents = typeof config === \"object\" ? config.agents : undefined;\n    const shouldApply = !targetAgents || targetAgents.includes(agentId);\n    if (shouldApply && typeof agent.use === \"function\") {\n      agent.use(new OpenGenerativeUIMiddleware());\n    }\n  }\n\n  // A \"markdown\" envelope means the model writes ```a2ui fences, so the run\n  // gets no render tool, even when the runtime turns generative UI on.\n  const generativeUI = runtime.generativeUI;\n  const transport = params.providerGenerativeUITransport;\n  const isGenerativeUIRun =\n    transport === \"tool\" || (transport !== \"markdown\" && !!generativeUI);\n  if (\n    isGenerativeUIRun &&\n    generativeUI !== false &&\n    typeof agent.use === \"function\"\n  ) {\n    const targetAgents =\n      typeof generativeUI === \"object\" ? generativeUI.agents : undefined;\n    if (!targetAgents || targetAgents.includes(agentId)) {\n      agent.use(new GenerativeUIMiddleware());\n    }\n  }\n\n  // Forward eligible inbound headers onto the outgoing agent call under the\n  // runtime's resolved forwarding policy (`authorization` / custom `x-*`, with\n  // known infra/proxy/platform headers stripped by the default denylist —\n  // #5712), but let headers the server explicitly configured on the agent WIN\n  // on collision (case-insensitively): a server-set service-to-service token\n  // (e.g. an IAM bearer) must never be silently overridden by a\n  // browser/edge/platform-injected inbound header. See `mergeForwardableHeaders`\n  // for the casing/duplicate-key rationale and `shouldForwardHeader` for breadth.\n  agent.headers = mergeForwardableHeaders(\n    agent.headers,\n    request,\n    // `forwardHeadersPolicy` is optional on the published `CopilotRuntimeLike`\n    // interface (non-breaking minor release). Concrete runtimes always set it;\n    // a policy-less external implementor falls back to the default resolved\n    // policy (default-on denylist) so behavior stays identical and never derefs\n    // undefined.\n    runtime.forwardHeadersPolicy ?? resolveForwardHeadersPolicy(undefined),\n  );\n}\n\n/**\n * Shared by the two places a run meets a middleware-less agent: before Memory\n * is resolved (nothing left to resolve) and after (Memory resolved to nothing).\n */\nconst NO_MIDDLEWARE_WARNING =\n  \"CopilotKitIntelligence.enableEnterpriseLearning is enabled, but the agent \" +\n  \"does not support middleware (no `.use()` method); Intelligence tools were \" +\n  \"not attached for this run.\";\n\n/**\n * Attach CopilotKit Intelligence's MCP tools to the agent run when\n * `CopilotKitIntelligence` was constructed with\n * `enableEnterpriseLearning: true`. Uses `@ag-ui/mcp-middleware`, so the\n * tools are available uniformly across agent frameworks (not just\n * `BuiltInAgent`).\n *\n * The middleware sits on a per-request agent clone, so the per-request\n * auth (Bearer apiKey + resolved user-id) is baked into the transport\n * headers at attach time. If user resolution fails, attachment is\n * skipped silently — the intelligence run handler will reject the\n * request with the same error. Note this means `identifyUser` is\n * resolved twice per learning-enabled run (here and in the run handler);\n * the callback is expected to be idempotent and side-effect-free.\n *\n * Intentionally split out from `configureAgentForRequest`: this is only\n * relevant to actual agent runs, not auxiliary flows like thread-name\n * generation (which has no need for MCP tools and shouldn't pay the\n * `listTools` round-trip).\n */\nexport async function attachIntelligenceEnterpriseLearning(params: {\n  runtime: CopilotRuntimeLike;\n  request: Request;\n  agent: AbstractAgent;\n}): Promise<void | Response> {\n  const { runtime, request } = params;\n  const agent = params.agent as MiddlewareCapableAgent;\n\n  if (!isIntelligenceRuntime(runtime)) return;\n\n  const learningEnabled =\n    runtime.intelligence?.ɵisEnterpriseLearningEnabled?.() === true;\n  if (runtime.memory === undefined && !learningEnabled) return;\n\n  // Nothing here is resolvable for an agent whose framework can't take\n  // middleware and whose runtime configures no Memory — bail before paying for\n  // `identifyUser`, so an enterprise-learning-only run keeps warning rather\n  // than acquiring a new way to fail.\n  if (runtime.memory === undefined && typeof agent.use !== \"function\") {\n    logger.warn(NO_MIDDLEWARE_WARNING);\n    return;\n  }\n\n  const userResult = await resolveIntelligenceUser({ runtime, request });\n  if (userResult instanceof Response) return userResult;\n  const access = await resolveWebMemory(runtime, request, userResult, \"agent\");\n  if (access instanceof Response) return access;\n\n  const memoryGranted =\n    runtime.memory !== undefined && grantAllowsMemory(access.grant);\n\n  // A policy that grants no scope means this run gets no Memory — it does NOT\n  // mean the run is refused. Attach nothing and let the conversation proceed,\n  // exactly as a Channel does when its grant asks for nothing\n  // (`hasMemoryAccess` in @copilotkit/channels-core). Returning a 403 here\n  // instead fails the whole run, so switching Memory off for one tenant would\n  // leave that tenant with no assistant, and the only signal is a run error the\n  // chat surface has no reason to render.\n  //\n  // Enterprise learning rides the SAME MCP server, so \"no Memory\" must not cost\n  // an operator the learning tools too. When it is on, attach anyway and let\n  // Intelligence filter: it registers one Memory tool per granted scope and\n  // none at all for an all-none grant, leaving the learning tools untouched.\n  if (!memoryGranted && !learningEnabled) return;\n\n  // Whatever is left to attach needs middleware. Failing the run is right only\n  // when Memory was actually granted and cannot be delivered; a run that merely\n  // wanted learning tools warns and proceeds, as it always has.\n  if (typeof agent.use !== \"function\") {\n    if (memoryGranted) {\n      return errorResponse(\n        \"Memory is configured, but this agent does not support middleware\",\n        500,\n      );\n    }\n    logger.warn(NO_MIDDLEWARE_WARNING);\n    return;\n  }\n\n  agent.use(\n    new MCPMiddleware([\n      {\n        type: \"http\",\n        url: `${runtime.intelligence.ɵgetApiUrl()}/mcp`,\n        serverId: \"intelligence\",\n        headers: {\n          Authorization: `Bearer ${runtime.intelligence.ɵgetApiKey()}`,\n          [INTELLIGENCE_USER_ID_HEADER]: userResult.id,\n          ...(runtime.memory\n            ? {\n                [INTELLIGENCE_MEMORY_GRANT_HEADER]: JSON.stringify(\n                  access.grant,\n                ),\n              }\n            : {}),\n        },\n      },\n    ]),\n  );\n}\n\n// Intentional local exception: HTTP request parsing runs before AG-UI's event\n// compatibility boundary. Mirror its historically accepted optional-null rules\n// and its legacy binary-part upgrade here, without depending on a new public\n// AG-UI helper (AG-UI does not export one). Keep these aligned\n// with client/src/middleware/compatibility-boundary.ts and AG-UI's migration guide.\n// Required nulls and nulls within application data must remain untouched.\nfunction warnCompatibility(what: string, replacement: string) {\n  if (\n    typeof process !== \"undefined\" &&\n    typeof process.env !== \"undefined\" &&\n    process.env.SUPPRESS_TRANSFORMATION_WARNINGS\n  )\n    return;\n  console.warn(\n    `[ag-ui][compat] Converting deprecated ${what} to ${replacement}. The old shape leaves the protocol after its shim window — see the repo-root DEPRECATIONS.md. Set SUPPRESS_TRANSFORMATION_WARNINGS=true to silence.`,\n  );\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction omitLegacyNull(\n  value: unknown,\n  field: string,\n  context: string,\n): unknown {\n  if (!isRecord(value) || value[field] !== null) return value;\n  warnCompatibility(`${context}.${field}: null`, \"an absent field\");\n  const { [field]: _null, ...rest } = value;\n  return rest;\n}\n\nfunction mapProtocolArray(\n  value: unknown,\n  field: string,\n  normalize: (entry: unknown) => unknown,\n): unknown {\n  if (!isRecord(value) || !Array.isArray(value[field])) return value;\n  const original = value[field];\n  const entries = original.map(normalize);\n  return entries.some((entry, index) => entry !== original[index])\n    ? { ...value, [field]: entries }\n    : value;\n}\n\nfunction mediaTypeFor(\n  mimeType: string,\n): \"image\" | \"audio\" | \"video\" | \"document\" {\n  if (mimeType.startsWith(\"image/\")) return \"image\";\n  if (mimeType.startsWith(\"audio/\")) return \"audio\";\n  if (mimeType.startsWith(\"video/\")) return \"video\";\n  return \"document\";\n}\n\nfunction sameSource(part: unknown, converted: Record<string, unknown>) {\n  if (!isRecord(part) || part.type !== converted.type) return false;\n  const a = part.source;\n  const b = converted.source as Record<string, unknown>;\n  return (\n    isRecord(a) &&\n    a.type === b.type &&\n    a.value === b.value &&\n    a.mimeType === b.mimeType\n  );\n}\n\n/**\n * The 0.x `{ type: \"binary\" }` part, which 1.0 retired and main accepted.\n * Mirrors AG-UI's outgoing upgrade (client/src/middleware/legacy-content.ts):\n * data or url becomes the media part its mime type names, and a binary part\n * that only mirrors a modern part already in the message is dropped. A part\n * with only an `id` has no 1.0 form; it is dropped with a warning instead of\n * failing the whole request, which is what BuiltInAgent already did with it.\n */\nfunction upgradeLegacyBinaryParts(content: unknown[]): unknown[] {\n  return content.flatMap((part) => {\n    if (\n      !isRecord(part) ||\n      part.type !== \"binary\" ||\n      typeof part.mimeType !== \"string\"\n    )\n      return [part];\n    const kind =\n      typeof part.data === \"string\"\n        ? \"data\"\n        : typeof part.url === \"string\"\n          ? \"url\"\n          : null;\n    if (kind === null) {\n      console.warn(\n        \"[CopilotKit] Dropping a legacy binary content part that has no data or url; AG-UI 1.0 has no equivalent for it.\",\n      );\n      return [];\n    }\n    warnCompatibility(\"binary input content\", \"the modern media content part\");\n    const converted: Record<string, unknown> = {\n      type: mediaTypeFor(part.mimeType),\n      source: {\n        type: kind,\n        value: kind === \"data\" ? part.data : part.url,\n        mimeType: part.mimeType,\n      },\n      ...(typeof part.filename === \"string\"\n        ? { metadata: { filename: part.filename } }\n        : {}),\n    };\n    return content.some((other) => sameSource(other, converted))\n      ? []\n      : [converted];\n  });\n}\n\nfunction normalizeLegacyMessageContent(message: unknown): unknown {\n  const upgraded =\n    isRecord(message) &&\n    Array.isArray(message.content) &&\n    message.content.some((part) => isRecord(part) && part.type === \"binary\")\n      ? {\n          ...message,\n          content: upgradeLegacyBinaryParts(message.content),\n        }\n      : message;\n  return mapProtocolArray(upgraded, \"content\", (part) => {\n    if (!isRecord(part)) return part;\n    switch (part.type) {\n      case \"image\":\n      case \"audio\":\n      case \"video\":\n      case \"document\":\n        return omitLegacyNull(part, \"metadata\", `${part.type} input content`);\n      default:\n        return part;\n    }\n  });\n}\n\nfunction normalizeLegacyRunAgentInput(input: unknown): unknown {\n  let normalized = omitLegacyNull(input, \"forwardedProps\", \"RunAgentInput\");\n  normalized = mapProtocolArray(normalized, \"tools\", (tool) =>\n    omitLegacyNull(tool, \"parameters\", \"Tool\"),\n  );\n  normalized = mapProtocolArray(normalized, \"resume\", (entry) =>\n    omitLegacyNull(entry, \"payload\", \"ResumeEntry\"),\n  );\n  return mapProtocolArray(\n    normalized,\n    \"messages\",\n    normalizeLegacyMessageContent,\n  );\n}\n\nfunction parseRunAgentInput(value: unknown): RunAgentInput {\n  // With strictNullChecks disabled, Zod infers some required nested fields\n  // (such as image.source) as optional. The schema still validates them.\n  return RunAgentInputSchema.parse(\n    normalizeLegacyRunAgentInput(value),\n  ) as RunAgentInput;\n}\n\nexport async function parseRunRequest(\n  request: Request,\n): Promise<RunAgentInput | Response> {\n  try {\n    const requestBody = await request.json();\n    return parseRunAgentInput(requestBody);\n  } catch (error) {\n    logger.error(\"Invalid run request body:\", error);\n    return new Response(\n      JSON.stringify({\n        error: \"Invalid request body\",\n        details: error instanceof Error ? error.message : String(error),\n      }),\n      {\n        status: 400,\n        headers: { \"Content-Type\": \"application/json\" },\n      },\n    );\n  }\n}\n\nexport async function parseConnectRequest(request: Request): Promise<\n  | Response\n  | {\n      input: RunAgentInput;\n      lastSeenEventId: string | null;\n    }\n> {\n  try {\n    const requestBody = await request.json();\n    const input = parseRunAgentInput(requestBody);\n    let lastSeenEventId: string | null = null;\n\n    if (\n      \"lastSeenEventId\" in (requestBody as Record<string, unknown>) &&\n      (typeof (requestBody as Record<string, unknown>).lastSeenEventId ===\n        \"string\" ||\n        (requestBody as Record<string, unknown>).lastSeenEventId === null)\n    ) {\n      lastSeenEventId =\n        (requestBody as ConnectRequestBody).lastSeenEventId ?? null;\n    }\n\n    return { input, lastSeenEventId };\n  } catch (error) {\n    logger.error(\"Invalid connect request body:\", error);\n    return new Response(\n      JSON.stringify({\n        error: \"Invalid request body\",\n        details: error instanceof Error ? error.message : String(error),\n      }),\n      {\n        status: 400,\n        headers: { \"Content-Type\": \"application/json\" },\n      },\n    );\n  }\n}\n"],"mappings":"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"}

package/dist/runtime/handlers/shared/cloud-telemetry.cjs

@@ -0,0 +1,30 @@
+const require_runtime = require('../../../_virtual/_rolldown/runtime.cjs');
+let _copilotkit_shared = require("@copilotkit/shared");
+
+//#region src/runtime/handlers/shared/cloud-telemetry.ts
+/**
+* Whether the caller forwarded CopilotCloud guardrails configuration.
+*
+* Guardrails reach a runtime as `forwardedProps.cloud.guardrails`. An earlier
+* version read the body only when the CopilotCloud key header was present,
+* because in principle only a CopilotCloud client sends guardrails and that
+* client always sends its key. Production does not hold to that: of 112
+* guardrails-enabled requests over 90 days, 2 carried no key, and they
+* undercounted as `false`. The signal is rare enough — 13 people across 9
+* Cloud keys in a year — that losing 2% of it to save a body clone is a bad
+* trade, so the body is now always read.
+*
+* `readBody` clones rather than consuming, so the handler can still parse the
+* request afterwards.
+*/
+async function readGuardrailsEnabled(request) {
+	try {
+		return ((await (0, _copilotkit_shared.readBody)(request))?.forwardedProps)?.cloud?.guardrails !== void 0;
+	} catch {
+		return false;
+	}
+}
+
+//#endregion
+exports.readGuardrailsEnabled = readGuardrailsEnabled;
+//# sourceMappingURL=cloud-telemetry.cjs.map

package/dist/runtime/handlers/shared/cloud-telemetry.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-telemetry.cjs","names":[],"sources":["../../../../src/runtime/handlers/shared/cloud-telemetry.ts"],"sourcesContent":["// The CopilotCloud guardrails flag on `oss.runtime.copilot_request_created`.\n//\n// It lives here because the v1 entrypoint used to compute it in its own\n// middleware and emit a second copy of the event. That copy is gone; this is\n// what it carried and the v2 handlers did not.\n//\n// The v1 copy also carried `cloud.base_url`, which is deliberately not\n// ported. The cross-language conformance suite pins this event to exactly\n// requestType, cloud.guardrails.enabled and cloud.api_key_provided\n// (`tools/runtime-conformance/telemetry-cases.mjs`), and the four native\n// runtimes send nothing else. A near-constant read off an env var is not\n// worth diverging the canonical event shape for.\n\nimport { readBody } from \"@copilotkit/shared\";\nimport type { RunAgentInput } from \"@ag-ui/client\";\n\n/**\n * Whether the caller forwarded CopilotCloud guardrails configuration.\n *\n * Guardrails reach a runtime as `forwardedProps.cloud.guardrails`. An earlier\n * version read the body only when the CopilotCloud key header was present,\n * because in principle only a CopilotCloud client sends guardrails and that\n * client always sends its key. Production does not hold to that: of 112\n * guardrails-enabled requests over 90 days, 2 carried no key, and they\n * undercounted as `false`. The signal is rare enough — 13 people across 9\n * Cloud keys in a year — that losing 2% of it to save a body clone is a bad\n * trade, so the body is now always read.\n *\n * `readBody` clones rather than consuming, so the handler can still parse the\n * request afterwards.\n */\nexport async function readGuardrailsEnabled(\n  request: Request,\n): Promise<boolean> {\n  try {\n    const body = (await readBody(request)) as RunAgentInput | undefined;\n    const forwardedProps = body?.forwardedProps as\n      | { cloud?: { guardrails?: unknown } }\n      | undefined;\n    return forwardedProps?.cloud?.guardrails !== undefined;\n  } catch {\n    // Telemetry must never decide whether a request is served.\n    return false;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AA+BA,eAAsB,sBACpB,SACkB;AAClB,KAAI;AAKF,WAJc,uCAAe,QAAQ,GACR,iBAGN,OAAO,eAAe;SACvC;AAEN,SAAO"}

package/dist/runtime/handlers/shared/cloud-telemetry.mjs

@@ -0,0 +1,29 @@
+import { readBody } from "@copilotkit/shared";
+
+//#region src/runtime/handlers/shared/cloud-telemetry.ts
+/**
+* Whether the caller forwarded CopilotCloud guardrails configuration.
+*
+* Guardrails reach a runtime as `forwardedProps.cloud.guardrails`. An earlier
+* version read the body only when the CopilotCloud key header was present,
+* because in principle only a CopilotCloud client sends guardrails and that
+* client always sends its key. Production does not hold to that: of 112
+* guardrails-enabled requests over 90 days, 2 carried no key, and they
+* undercounted as `false`. The signal is rare enough — 13 people across 9
+* Cloud keys in a year — that losing 2% of it to save a body clone is a bad
+* trade, so the body is now always read.
+*
+* `readBody` clones rather than consuming, so the handler can still parse the
+* request afterwards.
+*/
+async function readGuardrailsEnabled(request) {
+	try {
+		return ((await readBody(request))?.forwardedProps)?.cloud?.guardrails !== void 0;
+	} catch {
+		return false;
+	}
+}
+
+//#endregion
+export { readGuardrailsEnabled };
+//# sourceMappingURL=cloud-telemetry.mjs.map

package/dist/runtime/handlers/shared/cloud-telemetry.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-telemetry.mjs","names":[],"sources":["../../../../src/runtime/handlers/shared/cloud-telemetry.ts"],"sourcesContent":["// The CopilotCloud guardrails flag on `oss.runtime.copilot_request_created`.\n//\n// It lives here because the v1 entrypoint used to compute it in its own\n// middleware and emit a second copy of the event. That copy is gone; this is\n// what it carried and the v2 handlers did not.\n//\n// The v1 copy also carried `cloud.base_url`, which is deliberately not\n// ported. The cross-language conformance suite pins this event to exactly\n// requestType, cloud.guardrails.enabled and cloud.api_key_provided\n// (`tools/runtime-conformance/telemetry-cases.mjs`), and the four native\n// runtimes send nothing else. A near-constant read off an env var is not\n// worth diverging the canonical event shape for.\n\nimport { readBody } from \"@copilotkit/shared\";\nimport type { RunAgentInput } from \"@ag-ui/client\";\n\n/**\n * Whether the caller forwarded CopilotCloud guardrails configuration.\n *\n * Guardrails reach a runtime as `forwardedProps.cloud.guardrails`. An earlier\n * version read the body only when the CopilotCloud key header was present,\n * because in principle only a CopilotCloud client sends guardrails and that\n * client always sends its key. Production does not hold to that: of 112\n * guardrails-enabled requests over 90 days, 2 carried no key, and they\n * undercounted as `false`. The signal is rare enough — 13 people across 9\n * Cloud keys in a year — that losing 2% of it to save a body clone is a bad\n * trade, so the body is now always read.\n *\n * `readBody` clones rather than consuming, so the handler can still parse the\n * request afterwards.\n */\nexport async function readGuardrailsEnabled(\n  request: Request,\n): Promise<boolean> {\n  try {\n    const body = (await readBody(request)) as RunAgentInput | undefined;\n    const forwardedProps = body?.forwardedProps as\n      | { cloud?: { guardrails?: unknown } }\n      | undefined;\n    return forwardedProps?.cloud?.guardrails !== undefined;\n  } catch {\n    // Telemetry must never decide whether a request is served.\n    return false;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AA+BA,eAAsB,sBACpB,SACkB;AAClB,KAAI;AAKF,WAJc,MAAM,SAAS,QAAQ,GACR,iBAGN,OAAO,eAAe;SACvC;AAEN,SAAO"}

package/dist/runtime/handlers/shared/describe-endpoint.cjs

@@ -0,0 +1,25 @@
+
+//#region src/runtime/handlers/shared/describe-endpoint.ts
+/**
+* A form of the endpoint that is safe to write to application logs.
+*
+* Both halves of an endpoint URL can carry a secret: userinfo, and the query
+* string — the #2407 reporter's own workaround appended `?uid=<hash of the
+* API key>`. Only the origin and path survive.
+*
+* Used for anything that leaves this process with an endpoint in it: log
+* lines, and the tool descriptions that go to the model provider.
+*/
+function describeEndpoint(endpoint) {
+	if (!endpoint) return "an MCP endpoint";
+	try {
+		const url = new URL(endpoint);
+		return `${url.protocol}//${url.host}${url.pathname}`;
+	} catch {
+		return "an MCP endpoint";
+	}
+}
+
+//#endregion
+exports.describeEndpoint = describeEndpoint;
+//# sourceMappingURL=describe-endpoint.cjs.map

package/dist/runtime/handlers/shared/describe-endpoint.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe-endpoint.cjs","names":[],"sources":["../../../../src/runtime/handlers/shared/describe-endpoint.ts"],"sourcesContent":["/**\n * A form of the endpoint that is safe to write to application logs.\n *\n * Both halves of an endpoint URL can carry a secret: userinfo, and the query\n * string — the #2407 reporter's own workaround appended `?uid=<hash of the\n * API key>`. Only the origin and path survive.\n *\n * Used for anything that leaves this process with an endpoint in it: log\n * lines, and the tool descriptions that go to the model provider.\n */\nexport function describeEndpoint(endpoint: string | undefined): string {\n  if (!endpoint) return \"an MCP endpoint\";\n  try {\n    const url = new URL(endpoint);\n    // Not `url.origin`: for any scheme other than http(s) that is the opaque\n    // origin, the literal string \"null\", and `pathname` is empty — so a\n    // `stdio://` endpoint would render as \"null\" in a log and in a prompt.\n    // Rebuilding from protocol and host keeps every scheme legible while\n    // still dropping userinfo, query, and fragment.\n    return `${url.protocol}//${url.host}${url.pathname}`;\n  } catch {\n    return \"an MCP endpoint\";\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAUA,SAAgB,iBAAiB,UAAsC;AACrE,KAAI,CAAC,SAAU,QAAO;AACtB,KAAI;EACF,MAAM,MAAM,IAAI,IAAI,SAAS;AAM7B,SAAO,GAAG,IAAI,SAAS,IAAI,IAAI,OAAO,IAAI;SACpC;AACN,SAAO"}

package/dist/runtime/handlers/shared/describe-endpoint.mjs

@@ -0,0 +1,24 @@
+//#region src/runtime/handlers/shared/describe-endpoint.ts
+/**
+* A form of the endpoint that is safe to write to application logs.
+*
+* Both halves of an endpoint URL can carry a secret: userinfo, and the query
+* string — the #2407 reporter's own workaround appended `?uid=<hash of the
+* API key>`. Only the origin and path survive.
+*
+* Used for anything that leaves this process with an endpoint in it: log
+* lines, and the tool descriptions that go to the model provider.
+*/
+function describeEndpoint(endpoint) {
+	if (!endpoint) return "an MCP endpoint";
+	try {
+		const url = new URL(endpoint);
+		return `${url.protocol}//${url.host}${url.pathname}`;
+	} catch {
+		return "an MCP endpoint";
+	}
+}
+
+//#endregion
+export { describeEndpoint };
+//# sourceMappingURL=describe-endpoint.mjs.map

package/dist/runtime/handlers/shared/describe-endpoint.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe-endpoint.mjs","names":[],"sources":["../../../../src/runtime/handlers/shared/describe-endpoint.ts"],"sourcesContent":["/**\n * A form of the endpoint that is safe to write to application logs.\n *\n * Both halves of an endpoint URL can carry a secret: userinfo, and the query\n * string — the #2407 reporter's own workaround appended `?uid=<hash of the\n * API key>`. Only the origin and path survive.\n *\n * Used for anything that leaves this process with an endpoint in it: log\n * lines, and the tool descriptions that go to the model provider.\n */\nexport function describeEndpoint(endpoint: string | undefined): string {\n  if (!endpoint) return \"an MCP endpoint\";\n  try {\n    const url = new URL(endpoint);\n    // Not `url.origin`: for any scheme other than http(s) that is the opaque\n    // origin, the literal string \"null\", and `pathname` is empty — so a\n    // `stdio://` endpoint would render as \"null\" in a log and in a prompt.\n    // Rebuilding from protocol and host keeps every scheme legible while\n    // still dropping userinfo, query, and fragment.\n    return `${url.protocol}//${url.host}${url.pathname}`;\n  } catch {\n    return \"an MCP endpoint\";\n  }\n}\n"],"mappings":";;;;;;;;;;;AAUA,SAAgB,iBAAiB,UAAsC;AACrE,KAAI,CAAC,SAAU,QAAO;AACtB,KAAI;EACF,MAAM,MAAM,IAAI,IAAI,SAAS;AAM7B,SAAO,GAAG,IAAI,SAAS,IAAI,IAAI,OAAO,IAAI;SACpC;AACN,SAAO"}

package/dist/runtime/handlers/shared/intelligence-utils.cjs

@@ -0,0 +1,24 @@
+const require_client = require('../../intelligence-platform/client.cjs');
+
+//#region src/runtime/handlers/shared/intelligence-utils.ts
+/**
+* Returns the HTTP status carried by platform request errors.
+*/
+function getPlatformErrorStatus(error) {
+	if (error instanceof require_client.PlatformRequestError) return error.status;
+	if (error !== null && typeof error === "object" && "status" in error && typeof error.status === "number") return error.status;
+}
+const MAX_ID_LENGTH = 128;
+const SAFE_ID_PATTERN = /^[\w.@:=-]+$/;
+/**
+* Validates that a string identifier (userId, agentId) is safe to pass through.
+* Returns `true` if valid, `false` otherwise.
+*/
+function isValidIdentifier(value) {
+	return typeof value === "string" && value.length > 0 && value.length <= MAX_ID_LENGTH && SAFE_ID_PATTERN.test(value);
+}
+
+//#endregion
+exports.getPlatformErrorStatus = getPlatformErrorStatus;
+exports.isValidIdentifier = isValidIdentifier;
+//# sourceMappingURL=intelligence-utils.cjs.map

package/dist/runtime/handlers/shared/intelligence-utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"intelligence-utils.cjs","names":["PlatformRequestError"],"sources":["../../../../src/runtime/handlers/shared/intelligence-utils.ts"],"sourcesContent":["import { PlatformRequestError } from \"../../intelligence-platform/client\";\n\n/**\n * Returns the HTTP status carried by platform request errors.\n */\nexport function getPlatformErrorStatus(error: unknown): number | undefined {\n  if (error instanceof PlatformRequestError) {\n    return error.status;\n  }\n\n  if (\n    error !== null &&\n    typeof error === \"object\" &&\n    \"status\" in error &&\n    typeof error.status === \"number\"\n  ) {\n    return error.status;\n  }\n\n  return undefined;\n}\n\nexport function isPlatformNotFoundError(error: unknown): boolean {\n  return getPlatformErrorStatus(error) === 404;\n}\n\nconst MAX_ID_LENGTH = 128;\nconst SAFE_ID_PATTERN = /^[\\w.@:=-]+$/;\n\n/**\n * Validates that a string identifier (userId, agentId) is safe to pass through.\n * Returns `true` if valid, `false` otherwise.\n */\nexport function isValidIdentifier(value: unknown): value is string {\n  return (\n    typeof value === \"string\" &&\n    value.length > 0 &&\n    value.length <= MAX_ID_LENGTH &&\n    SAFE_ID_PATTERN.test(value)\n  );\n}\n"],"mappings":";;;;;;AAKA,SAAgB,uBAAuB,OAAoC;AACzE,KAAI,iBAAiBA,oCACnB,QAAO,MAAM;AAGf,KACE,UAAU,QACV,OAAO,UAAU,YACjB,YAAY,SACZ,OAAO,MAAM,WAAW,SAExB,QAAO,MAAM;;AAUjB,MAAM,gBAAgB;AACtB,MAAM,kBAAkB;;;;;AAMxB,SAAgB,kBAAkB,OAAiC;AACjE,QACE,OAAO,UAAU,YACjB,MAAM,SAAS,KACf,MAAM,UAAU,iBAChB,gBAAgB,KAAK,MAAM"}

package/dist/runtime/handlers/shared/intelligence-utils.mjs

@@ -0,0 +1,23 @@
+import { PlatformRequestError } from "../../intelligence-platform/client.mjs";
+
+//#region src/runtime/handlers/shared/intelligence-utils.ts
+/**
+* Returns the HTTP status carried by platform request errors.
+*/
+function getPlatformErrorStatus(error) {
+	if (error instanceof PlatformRequestError) return error.status;
+	if (error !== null && typeof error === "object" && "status" in error && typeof error.status === "number") return error.status;
+}
+const MAX_ID_LENGTH = 128;
+const SAFE_ID_PATTERN = /^[\w.@:=-]+$/;
+/**
+* Validates that a string identifier (userId, agentId) is safe to pass through.
+* Returns `true` if valid, `false` otherwise.
+*/
+function isValidIdentifier(value) {
+	return typeof value === "string" && value.length > 0 && value.length <= MAX_ID_LENGTH && SAFE_ID_PATTERN.test(value);
+}
+
+//#endregion
+export { getPlatformErrorStatus, isValidIdentifier };
+//# sourceMappingURL=intelligence-utils.mjs.map

package/dist/runtime/handlers/shared/intelligence-utils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"intelligence-utils.mjs","names":[],"sources":["../../../../src/runtime/handlers/shared/intelligence-utils.ts"],"sourcesContent":["import { PlatformRequestError } from \"../../intelligence-platform/client\";\n\n/**\n * Returns the HTTP status carried by platform request errors.\n */\nexport function getPlatformErrorStatus(error: unknown): number | undefined {\n  if (error instanceof PlatformRequestError) {\n    return error.status;\n  }\n\n  if (\n    error !== null &&\n    typeof error === \"object\" &&\n    \"status\" in error &&\n    typeof error.status === \"number\"\n  ) {\n    return error.status;\n  }\n\n  return undefined;\n}\n\nexport function isPlatformNotFoundError(error: unknown): boolean {\n  return getPlatformErrorStatus(error) === 404;\n}\n\nconst MAX_ID_LENGTH = 128;\nconst SAFE_ID_PATTERN = /^[\\w.@:=-]+$/;\n\n/**\n * Validates that a string identifier (userId, agentId) is safe to pass through.\n * Returns `true` if valid, `false` otherwise.\n */\nexport function isValidIdentifier(value: unknown): value is string {\n  return (\n    typeof value === \"string\" &&\n    value.length > 0 &&\n    value.length <= MAX_ID_LENGTH &&\n    SAFE_ID_PATTERN.test(value)\n  );\n}\n"],"mappings":";;;;;;AAKA,SAAgB,uBAAuB,OAAoC;AACzE,KAAI,iBAAiB,qBACnB,QAAO,MAAM;AAGf,KACE,UAAU,QACV,OAAO,UAAU,YACjB,YAAY,SACZ,OAAO,MAAM,WAAW,SAExB,QAAO,MAAM;;AAUjB,MAAM,gBAAgB;AACtB,MAAM,kBAAkB;;;;;AAMxB,SAAgB,kBAAkB,OAAiC;AACjE,QACE,OAAO,UAAU,YACjB,MAAM,SAAS,KACf,MAAM,UAAU,iBAChB,gBAAgB,KAAK,MAAM"}

package/dist/runtime/handlers/shared/json-response.cjs

@@ -0,0 +1,14 @@
+
+//#region src/runtime/handlers/shared/json-response.ts
+const errorResponse = (message, status) => new Response(JSON.stringify({ error: message }), {
+	status,
+	headers: { "Content-Type": "application/json" }
+});
+function isHandlerResponse(value) {
+	return value instanceof Response;
+}
+
+//#endregion
+exports.errorResponse = errorResponse;
+exports.isHandlerResponse = isHandlerResponse;
+//# sourceMappingURL=json-response.cjs.map

package/dist/runtime/handlers/shared/json-response.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-response.cjs","names":[],"sources":["../../../../src/runtime/handlers/shared/json-response.ts"],"sourcesContent":["export const errorResponse = (message: string, status: number) =>\n  new Response(JSON.stringify({ error: message }), {\n    status,\n    headers: { \"Content-Type\": \"application/json\" },\n  });\n\nexport function isHandlerResponse(value: unknown): value is Response {\n  return value instanceof Response;\n}\n"],"mappings":";;AAAA,MAAa,iBAAiB,SAAiB,WAC7C,IAAI,SAAS,KAAK,UAAU,EAAE,OAAO,SAAS,CAAC,EAAE;CAC/C;CACA,SAAS,EAAE,gBAAgB,oBAAoB;CAChD,CAAC;AAEJ,SAAgB,kBAAkB,OAAmC;AACnE,QAAO,iBAAiB"}

package/dist/runtime/handlers/shared/json-response.mjs

@@ -0,0 +1,12 @@
+//#region src/runtime/handlers/shared/json-response.ts
+const errorResponse = (message, status) => new Response(JSON.stringify({ error: message }), {
+	status,
+	headers: { "Content-Type": "application/json" }
+});
+function isHandlerResponse(value) {
+	return value instanceof Response;
+}
+
+//#endregion
+export { errorResponse, isHandlerResponse };
+//# sourceMappingURL=json-response.mjs.map

package/dist/runtime/handlers/shared/json-response.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-response.mjs","names":[],"sources":["../../../../src/runtime/handlers/shared/json-response.ts"],"sourcesContent":["export const errorResponse = (message: string, status: number) =>\n  new Response(JSON.stringify({ error: message }), {\n    status,\n    headers: { \"Content-Type\": \"application/json\" },\n  });\n\nexport function isHandlerResponse(value: unknown): value is Response {\n  return value instanceof Response;\n}\n"],"mappings":";AAAA,MAAa,iBAAiB,SAAiB,WAC7C,IAAI,SAAS,KAAK,UAAU,EAAE,OAAO,SAAS,CAAC,EAAE;CAC/C;CACA,SAAS,EAAE,gBAAgB,oBAAoB;CAChD,CAAC;AAEJ,SAAgB,kBAAkB,OAAmC;AACnE,QAAO,iBAAiB"}

package/dist/runtime/handlers/shared/mcp-apps-servers.cjs

@@ -0,0 +1,22 @@
+const require_describe_endpoint = require('./describe-endpoint.cjs');
+
+//#region src/runtime/handlers/shared/mcp-apps-servers.ts
+const UNSUPPORTED_POLICY_KEYS = ["includeTools", "excludeTools"];
+const MCP_APPS_POLICY_ISSUE = "https://github.com/CopilotKit/CopilotKit/issues/5930";
+/**
+* Select the servers for an agent and validate the policy boundary owned by
+* the installed MCP Apps middleware.
+*/
+function resolveMcpAppsServers(servers, agentId) {
+	const violations = [];
+	for (const [index, server] of servers.entries()) {
+		const config = server;
+		for (const key of UNSUPPORTED_POLICY_KEYS) if (Object.prototype.hasOwnProperty.call(config, key) && config[key] !== void 0) violations.push(`${key} at server[${index}] (${server.serverId ?? require_describe_endpoint.describeEndpoint(server.url)})`);
+	}
+	if (violations.length > 0) throw new Error(`Unsupported MCP Apps tool policy: ${violations.join(", ")}. @ag-ui/mcp-apps-middleware owns per-server tool policy, and the release the runtime depends on does not support these keys; see ${MCP_APPS_POLICY_ISSUE}.`);
+	return servers.filter((server) => !server.agentId || server.agentId === agentId).map(({ agentId: _agentId, ...server }) => server);
+}
+
+//#endregion
+exports.resolveMcpAppsServers = resolveMcpAppsServers;
+//# sourceMappingURL=mcp-apps-servers.cjs.map

package/dist/runtime/handlers/shared/mcp-apps-servers.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-apps-servers.cjs","names":["describeEndpoint"],"sources":["../../../../src/runtime/handlers/shared/mcp-apps-servers.ts"],"sourcesContent":["import type { MCPClientConfig } from \"@ag-ui/mcp-apps-middleware\";\nimport type { McpAppsServerConfig } from \"../../core/runtime\";\nimport { describeEndpoint } from \"./describe-endpoint\";\n\nconst UNSUPPORTED_POLICY_KEYS = [\"includeTools\", \"excludeTools\"] as const;\nconst MCP_APPS_POLICY_ISSUE =\n  \"https://github.com/CopilotKit/CopilotKit/issues/5930\";\n\n/**\n * Select the servers for an agent and validate the policy boundary owned by\n * the installed MCP Apps middleware.\n */\nexport function resolveMcpAppsServers(\n  servers: readonly McpAppsServerConfig[],\n  agentId: string,\n): MCPClientConfig[] {\n  const violations: string[] = [];\n\n  for (const [index, server] of servers.entries()) {\n    const config = server as unknown as Record<string, unknown>;\n    for (const key of UNSUPPORTED_POLICY_KEYS) {\n      if (\n        Object.prototype.hasOwnProperty.call(config, key) &&\n        config[key] !== undefined\n      ) {\n        violations.push(\n          `${key} at server[${index}] (${server.serverId ?? describeEndpoint(server.url)})`,\n        );\n      }\n    }\n  }\n\n  if (violations.length > 0) {\n    throw new Error(\n      `Unsupported MCP Apps tool policy: ${violations.join(\", \")}. ` +\n        `@ag-ui/mcp-apps-middleware owns per-server tool policy, and the ` +\n        `release the runtime depends on does not support these keys; see ` +\n        `${MCP_APPS_POLICY_ISSUE}.`,\n    );\n  }\n\n  return servers\n    .filter((server) => !server.agentId || server.agentId === agentId)\n    .map(({ agentId: _agentId, ...server }) => server as MCPClientConfig);\n}\n"],"mappings":";;;AAIA,MAAM,0BAA0B,CAAC,gBAAgB,eAAe;AAChE,MAAM,wBACJ;;;;;AAMF,SAAgB,sBACd,SACA,SACmB;CACnB,MAAM,aAAuB,EAAE;AAE/B,MAAK,MAAM,CAAC,OAAO,WAAW,QAAQ,SAAS,EAAE;EAC/C,MAAM,SAAS;AACf,OAAK,MAAM,OAAO,wBAChB,KACE,OAAO,UAAU,eAAe,KAAK,QAAQ,IAAI,IACjD,OAAO,SAAS,OAEhB,YAAW,KACT,GAAG,IAAI,aAAa,MAAM,KAAK,OAAO,YAAYA,2CAAiB,OAAO,IAAI,CAAC,GAChF;;AAKP,KAAI,WAAW,SAAS,EACtB,OAAM,IAAI,MACR,qCAAqC,WAAW,KAAK,KAAK,CAAC,oIAGtD,sBAAsB,GAC5B;AAGH,QAAO,QACJ,QAAQ,WAAW,CAAC,OAAO,WAAW,OAAO,YAAY,QAAQ,CACjE,KAAK,EAAE,SAAS,UAAU,GAAG,aAAa,OAA0B"}

package/dist/runtime/handlers/shared/mcp-apps-servers.mjs

@@ -0,0 +1,22 @@
+import { describeEndpoint } from "./describe-endpoint.mjs";
+
+//#region src/runtime/handlers/shared/mcp-apps-servers.ts
+const UNSUPPORTED_POLICY_KEYS = ["includeTools", "excludeTools"];
+const MCP_APPS_POLICY_ISSUE = "https://github.com/CopilotKit/CopilotKit/issues/5930";
+/**
+* Select the servers for an agent and validate the policy boundary owned by
+* the installed MCP Apps middleware.
+*/
+function resolveMcpAppsServers(servers, agentId) {
+	const violations = [];
+	for (const [index, server] of servers.entries()) {
+		const config = server;
+		for (const key of UNSUPPORTED_POLICY_KEYS) if (Object.prototype.hasOwnProperty.call(config, key) && config[key] !== void 0) violations.push(`${key} at server[${index}] (${server.serverId ?? describeEndpoint(server.url)})`);
+	}
+	if (violations.length > 0) throw new Error(`Unsupported MCP Apps tool policy: ${violations.join(", ")}. @ag-ui/mcp-apps-middleware owns per-server tool policy, and the release the runtime depends on does not support these keys; see ${MCP_APPS_POLICY_ISSUE}.`);
+	return servers.filter((server) => !server.agentId || server.agentId === agentId).map(({ agentId: _agentId, ...server }) => server);
+}
+
+//#endregion
+export { resolveMcpAppsServers };
+//# sourceMappingURL=mcp-apps-servers.mjs.map

package/dist/runtime/handlers/shared/mcp-apps-servers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-apps-servers.mjs","names":[],"sources":["../../../../src/runtime/handlers/shared/mcp-apps-servers.ts"],"sourcesContent":["import type { MCPClientConfig } from \"@ag-ui/mcp-apps-middleware\";\nimport type { McpAppsServerConfig } from \"../../core/runtime\";\nimport { describeEndpoint } from \"./describe-endpoint\";\n\nconst UNSUPPORTED_POLICY_KEYS = [\"includeTools\", \"excludeTools\"] as const;\nconst MCP_APPS_POLICY_ISSUE =\n  \"https://github.com/CopilotKit/CopilotKit/issues/5930\";\n\n/**\n * Select the servers for an agent and validate the policy boundary owned by\n * the installed MCP Apps middleware.\n */\nexport function resolveMcpAppsServers(\n  servers: readonly McpAppsServerConfig[],\n  agentId: string,\n): MCPClientConfig[] {\n  const violations: string[] = [];\n\n  for (const [index, server] of servers.entries()) {\n    const config = server as unknown as Record<string, unknown>;\n    for (const key of UNSUPPORTED_POLICY_KEYS) {\n      if (\n        Object.prototype.hasOwnProperty.call(config, key) &&\n        config[key] !== undefined\n      ) {\n        violations.push(\n          `${key} at server[${index}] (${server.serverId ?? describeEndpoint(server.url)})`,\n        );\n      }\n    }\n  }\n\n  if (violations.length > 0) {\n    throw new Error(\n      `Unsupported MCP Apps tool policy: ${violations.join(\", \")}. ` +\n        `@ag-ui/mcp-apps-middleware owns per-server tool policy, and the ` +\n        `release the runtime depends on does not support these keys; see ` +\n        `${MCP_APPS_POLICY_ISSUE}.`,\n    );\n  }\n\n  return servers\n    .filter((server) => !server.agentId || server.agentId === agentId)\n    .map(({ agentId: _agentId, ...server }) => server as MCPClientConfig);\n}\n"],"mappings":";;;AAIA,MAAM,0BAA0B,CAAC,gBAAgB,eAAe;AAChE,MAAM,wBACJ;;;;;AAMF,SAAgB,sBACd,SACA,SACmB;CACnB,MAAM,aAAuB,EAAE;AAE/B,MAAK,MAAM,CAAC,OAAO,WAAW,QAAQ,SAAS,EAAE;EAC/C,MAAM,SAAS;AACf,OAAK,MAAM,OAAO,wBAChB,KACE,OAAO,UAAU,eAAe,KAAK,QAAQ,IAAI,IACjD,OAAO,SAAS,OAEhB,YAAW,KACT,GAAG,IAAI,aAAa,MAAM,KAAK,OAAO,YAAY,iBAAiB,OAAO,IAAI,CAAC,GAChF;;AAKP,KAAI,WAAW,SAAS,EACtB,OAAM,IAAI,MACR,qCAAqC,WAAW,KAAK,KAAK,CAAC,oIAGtD,sBAAsB,GAC5B;AAGH,QAAO,QACJ,QAAQ,WAAW,CAAC,OAAO,WAAW,OAAO,YAAY,QAAQ,CACjE,KAAK,EAAE,SAAS,UAAU,GAAG,aAAa,OAA0B"}

package/dist/runtime/handlers/shared/memory-policy.cjs

@@ -0,0 +1,78 @@
+const require_json_response = require('./json-response.cjs');
+
+//#region src/runtime/handlers/shared/memory-policy.ts
+const ACCESS = new Set([
+	"none",
+	"read",
+	"read-write"
+]);
+/** What a policy that declines Memory entirely resolves to. */
+const NO_MEMORY = Object.freeze({
+	user: "none",
+	project: "none"
+});
+/**
+* True when a grant asks for any Memory operation at all.
+*
+* The web counterpart of `hasMemoryAccess` in `@copilotkit/channels-core`, and
+* deliberately the same predicate: a grant with every scope at `"none"` means
+* "this request gets no Memory", NOT "refuse this request". Channels has always
+* read it that way — there both scopes are optional and default to `"none"`, so
+* all-none is the grant you get by writing nothing, which could not coherently
+* mean refusal.
+*/
+function grantAllowsMemory(grant) {
+	return grant.user !== "none" || grant.project !== "none";
+}
+/**
+* Evaluates and validates one configured web Memory policy.
+*
+* Resolving is separate from ACTING on the result, because the two callers want
+* opposite things from a policy that grants nothing:
+*
+*   - An agent run wants to proceed WITHOUT Memory tools. `memory.access` is a
+*     Memory policy, not an authorization gate on the conversation; a runtime
+*     that wants to reject the request outright has `beforeRequestMiddleware`
+*     for exactly that. Failing the run here means a deployment that switches
+*     Memory off for one tenant gets no assistant at all, and the failure
+*     surfaces as a bare run error rather than as anything a user can read.
+*   - The browser Memory routes want a 403. There the caller asked for memories
+*     specifically, so "you may not have them" is the honest answer, and an
+*     empty list would imply none exist.
+*
+* So this returns the grant (or a Response for a genuinely broken policy), and
+* each call site applies `grantAllowsMemory` to its own case.
+*/
+async function resolveWebMemory(runtime, request, user, consumer) {
+	if (!runtime.memory) return {
+		user,
+		grant: {
+			user: "read-write",
+			project: "read-write"
+		}
+	};
+	try {
+		const grant = await runtime.memory.access({
+			request,
+			user,
+			consumer
+		});
+		if (grant === void 0) return require_json_response.errorResponse("Memory policy returned an invalid grant", 500);
+		const resolved = grant ?? NO_MEMORY;
+		if (!ACCESS.has(resolved.user) || !ACCESS.has(resolved.project)) return require_json_response.errorResponse("Memory policy returned an invalid grant", 500);
+		return {
+			user,
+			grant: {
+				user: resolved.user,
+				project: resolved.project
+			}
+		};
+	} catch {
+		return require_json_response.errorResponse("Memory policy failed", 500);
+	}
+}
+
+//#endregion
+exports.grantAllowsMemory = grantAllowsMemory;
+exports.resolveWebMemory = resolveWebMemory;
+//# sourceMappingURL=memory-policy.cjs.map

package/dist/runtime/handlers/shared/memory-policy.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-policy.cjs","names":["errorResponse"],"sources":["../../../../src/runtime/handlers/shared/memory-policy.ts"],"sourcesContent":["import type {\n  CopilotIntelligenceRuntimeLike,\n  CopilotRuntimeUser,\n  MemoryConsumer,\n  MemoryGrant,\n} from \"../../core/runtime\";\nimport { errorResponse } from \"./json-response\";\n\nconst ACCESS = new Set([\"none\", \"read\", \"read-write\"]);\n\n/** What a policy that declines Memory entirely resolves to. */\nconst NO_MEMORY: MemoryGrant = Object.freeze({\n  user: \"none\",\n  project: \"none\",\n});\n\nexport interface ResolvedWebMemory {\n  readonly user: CopilotRuntimeUser;\n  readonly grant: MemoryGrant;\n}\n\n/**\n * True when a grant asks for any Memory operation at all.\n *\n * The web counterpart of `hasMemoryAccess` in `@copilotkit/channels-core`, and\n * deliberately the same predicate: a grant with every scope at `\"none\"` means\n * \"this request gets no Memory\", NOT \"refuse this request\". Channels has always\n * read it that way — there both scopes are optional and default to `\"none\"`, so\n * all-none is the grant you get by writing nothing, which could not coherently\n * mean refusal.\n */\nexport function grantAllowsMemory(grant: MemoryGrant): boolean {\n  return grant.user !== \"none\" || grant.project !== \"none\";\n}\n\n/**\n * Evaluates and validates one configured web Memory policy.\n *\n * Resolving is separate from ACTING on the result, because the two callers want\n * opposite things from a policy that grants nothing:\n *\n *   - An agent run wants to proceed WITHOUT Memory tools. `memory.access` is a\n *     Memory policy, not an authorization gate on the conversation; a runtime\n *     that wants to reject the request outright has `beforeRequestMiddleware`\n *     for exactly that. Failing the run here means a deployment that switches\n *     Memory off for one tenant gets no assistant at all, and the failure\n *     surfaces as a bare run error rather than as anything a user can read.\n *   - The browser Memory routes want a 403. There the caller asked for memories\n *     specifically, so \"you may not have them\" is the honest answer, and an\n *     empty list would imply none exist.\n *\n * So this returns the grant (or a Response for a genuinely broken policy), and\n * each call site applies `grantAllowsMemory` to its own case.\n */\nexport async function resolveWebMemory(\n  runtime: CopilotIntelligenceRuntimeLike,\n  request: Request,\n  user: CopilotRuntimeUser,\n  consumer: MemoryConsumer,\n): Promise<ResolvedWebMemory | Response> {\n  if (!runtime.memory) {\n    return {\n      user,\n      grant: { user: \"read-write\", project: \"read-write\" },\n    };\n  }\n\n  try {\n    const grant = await runtime.memory.access({ request, user, consumer });\n    // `null` is the policy declining to grant anything, which is the same\n    // outcome as an explicit all-none grant — not a distinct third state.\n    //\n    // `undefined` is NOT that. The contract is `MemoryGrant | null`, so a\n    // missing return is a policy that is broken rather than restrictive — a\n    // JavaScript caller who forgot one, or a branch that falls off the end.\n    // Reading it as \"grant nothing\" would switch Memory off silently for the\n    // exact deployments least able to notice; it fails loudly instead.\n    if (grant === undefined) {\n      return errorResponse(\"Memory policy returned an invalid grant\", 500);\n    }\n    const resolved = grant ?? NO_MEMORY;\n    if (!ACCESS.has(resolved.user) || !ACCESS.has(resolved.project)) {\n      return errorResponse(\"Memory policy returned an invalid grant\", 500);\n    }\n    return { user, grant: { user: resolved.user, project: resolved.project } };\n  } catch {\n    return errorResponse(\"Memory policy failed\", 500);\n  }\n}\n"],"mappings":";;;AAQA,MAAM,SAAS,IAAI,IAAI;CAAC;CAAQ;CAAQ;CAAa,CAAC;;AAGtD,MAAM,YAAyB,OAAO,OAAO;CAC3C,MAAM;CACN,SAAS;CACV,CAAC;;;;;;;;;;;AAiBF,SAAgB,kBAAkB,OAA6B;AAC7D,QAAO,MAAM,SAAS,UAAU,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;AAsBpD,eAAsB,iBACpB,SACA,SACA,MACA,UACuC;AACvC,KAAI,CAAC,QAAQ,OACX,QAAO;EACL;EACA,OAAO;GAAE,MAAM;GAAc,SAAS;GAAc;EACrD;AAGH,KAAI;EACF,MAAM,QAAQ,MAAM,QAAQ,OAAO,OAAO;GAAE;GAAS;GAAM;GAAU,CAAC;AAStE,MAAI,UAAU,OACZ,QAAOA,oCAAc,2CAA2C,IAAI;EAEtE,MAAM,WAAW,SAAS;AAC1B,MAAI,CAAC,OAAO,IAAI,SAAS,KAAK,IAAI,CAAC,OAAO,IAAI,SAAS,QAAQ,CAC7D,QAAOA,oCAAc,2CAA2C,IAAI;AAEtE,SAAO;GAAE;GAAM,OAAO;IAAE,MAAM,SAAS;IAAM,SAAS,SAAS;IAAS;GAAE;SACpE;AACN,SAAOA,oCAAc,wBAAwB,IAAI"}

package/dist/runtime/handlers/shared/memory-policy.mjs

@@ -0,0 +1,77 @@
+import { errorResponse } from "./json-response.mjs";
+
+//#region src/runtime/handlers/shared/memory-policy.ts
+const ACCESS = new Set([
+	"none",
+	"read",
+	"read-write"
+]);
+/** What a policy that declines Memory entirely resolves to. */
+const NO_MEMORY = Object.freeze({
+	user: "none",
+	project: "none"
+});
+/**
+* True when a grant asks for any Memory operation at all.
+*
+* The web counterpart of `hasMemoryAccess` in `@copilotkit/channels-core`, and
+* deliberately the same predicate: a grant with every scope at `"none"` means
+* "this request gets no Memory", NOT "refuse this request". Channels has always
+* read it that way — there both scopes are optional and default to `"none"`, so
+* all-none is the grant you get by writing nothing, which could not coherently
+* mean refusal.
+*/
+function grantAllowsMemory(grant) {
+	return grant.user !== "none" || grant.project !== "none";
+}
+/**
+* Evaluates and validates one configured web Memory policy.
+*
+* Resolving is separate from ACTING on the result, because the two callers want
+* opposite things from a policy that grants nothing:
+*
+*   - An agent run wants to proceed WITHOUT Memory tools. `memory.access` is a
+*     Memory policy, not an authorization gate on the conversation; a runtime
+*     that wants to reject the request outright has `beforeRequestMiddleware`
+*     for exactly that. Failing the run here means a deployment that switches
+*     Memory off for one tenant gets no assistant at all, and the failure
+*     surfaces as a bare run error rather than as anything a user can read.
+*   - The browser Memory routes want a 403. There the caller asked for memories
+*     specifically, so "you may not have them" is the honest answer, and an
+*     empty list would imply none exist.
+*
+* So this returns the grant (or a Response for a genuinely broken policy), and
+* each call site applies `grantAllowsMemory` to its own case.
+*/
+async function resolveWebMemory(runtime, request, user, consumer) {
+	if (!runtime.memory) return {
+		user,
+		grant: {
+			user: "read-write",
+			project: "read-write"
+		}
+	};
+	try {
+		const grant = await runtime.memory.access({
+			request,
+			user,
+			consumer
+		});
+		if (grant === void 0) return errorResponse("Memory policy returned an invalid grant", 500);
+		const resolved = grant ?? NO_MEMORY;
+		if (!ACCESS.has(resolved.user) || !ACCESS.has(resolved.project)) return errorResponse("Memory policy returned an invalid grant", 500);
+		return {
+			user,
+			grant: {
+				user: resolved.user,
+				project: resolved.project
+			}
+		};
+	} catch {
+		return errorResponse("Memory policy failed", 500);
+	}
+}
+
+//#endregion
+export { grantAllowsMemory, resolveWebMemory };
+//# sourceMappingURL=memory-policy.mjs.map

package/dist/runtime/handlers/shared/memory-policy.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-policy.mjs","names":[],"sources":["../../../../src/runtime/handlers/shared/memory-policy.ts"],"sourcesContent":["import type {\n  CopilotIntelligenceRuntimeLike,\n  CopilotRuntimeUser,\n  MemoryConsumer,\n  MemoryGrant,\n} from \"../../core/runtime\";\nimport { errorResponse } from \"./json-response\";\n\nconst ACCESS = new Set([\"none\", \"read\", \"read-write\"]);\n\n/** What a policy that declines Memory entirely resolves to. */\nconst NO_MEMORY: MemoryGrant = Object.freeze({\n  user: \"none\",\n  project: \"none\",\n});\n\nexport interface ResolvedWebMemory {\n  readonly user: CopilotRuntimeUser;\n  readonly grant: MemoryGrant;\n}\n\n/**\n * True when a grant asks for any Memory operation at all.\n *\n * The web counterpart of `hasMemoryAccess` in `@copilotkit/channels-core`, and\n * deliberately the same predicate: a grant with every scope at `\"none\"` means\n * \"this request gets no Memory\", NOT \"refuse this request\". Channels has always\n * read it that way — there both scopes are optional and default to `\"none\"`, so\n * all-none is the grant you get by writing nothing, which could not coherently\n * mean refusal.\n */\nexport function grantAllowsMemory(grant: MemoryGrant): boolean {\n  return grant.user !== \"none\" || grant.project !== \"none\";\n}\n\n/**\n * Evaluates and validates one configured web Memory policy.\n *\n * Resolving is separate from ACTING on the result, because the two callers want\n * opposite things from a policy that grants nothing:\n *\n *   - An agent run wants to proceed WITHOUT Memory tools. `memory.access` is a\n *     Memory policy, not an authorization gate on the conversation; a runtime\n *     that wants to reject the request outright has `beforeRequestMiddleware`\n *     for exactly that. Failing the run here means a deployment that switches\n *     Memory off for one tenant gets no assistant at all, and the failure\n *     surfaces as a bare run error rather than as anything a user can read.\n *   - The browser Memory routes want a 403. There the caller asked for memories\n *     specifically, so \"you may not have them\" is the honest answer, and an\n *     empty list would imply none exist.\n *\n * So this returns the grant (or a Response for a genuinely broken policy), and\n * each call site applies `grantAllowsMemory` to its own case.\n */\nexport async function resolveWebMemory(\n  runtime: CopilotIntelligenceRuntimeLike,\n  request: Request,\n  user: CopilotRuntimeUser,\n  consumer: MemoryConsumer,\n): Promise<ResolvedWebMemory | Response> {\n  if (!runtime.memory) {\n    return {\n      user,\n      grant: { user: \"read-write\", project: \"read-write\" },\n    };\n  }\n\n  try {\n    const grant = await runtime.memory.access({ request, user, consumer });\n    // `null` is the policy declining to grant anything, which is the same\n    // outcome as an explicit all-none grant — not a distinct third state.\n    //\n    // `undefined` is NOT that. The contract is `MemoryGrant | null`, so a\n    // missing return is a policy that is broken rather than restrictive — a\n    // JavaScript caller who forgot one, or a branch that falls off the end.\n    // Reading it as \"grant nothing\" would switch Memory off silently for the\n    // exact deployments least able to notice; it fails loudly instead.\n    if (grant === undefined) {\n      return errorResponse(\"Memory policy returned an invalid grant\", 500);\n    }\n    const resolved = grant ?? NO_MEMORY;\n    if (!ACCESS.has(resolved.user) || !ACCESS.has(resolved.project)) {\n      return errorResponse(\"Memory policy returned an invalid grant\", 500);\n    }\n    return { user, grant: { user: resolved.user, project: resolved.project } };\n  } catch {\n    return errorResponse(\"Memory policy failed\", 500);\n  }\n}\n"],"mappings":";;;AAQA,MAAM,SAAS,IAAI,IAAI;CAAC;CAAQ;CAAQ;CAAa,CAAC;;AAGtD,MAAM,YAAyB,OAAO,OAAO;CAC3C,MAAM;CACN,SAAS;CACV,CAAC;;;;;;;;;;;AAiBF,SAAgB,kBAAkB,OAA6B;AAC7D,QAAO,MAAM,SAAS,UAAU,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;AAsBpD,eAAsB,iBACpB,SACA,SACA,MACA,UACuC;AACvC,KAAI,CAAC,QAAQ,OACX,QAAO;EACL;EACA,OAAO;GAAE,MAAM;GAAc,SAAS;GAAc;EACrD;AAGH,KAAI;EACF,MAAM,QAAQ,MAAM,QAAQ,OAAO,OAAO;GAAE;GAAS;GAAM;GAAU,CAAC;AAStE,MAAI,UAAU,OACZ,QAAO,cAAc,2CAA2C,IAAI;EAEtE,MAAM,WAAW,SAAS;AAC1B,MAAI,CAAC,OAAO,IAAI,SAAS,KAAK,IAAI,CAAC,OAAO,IAAI,SAAS,QAAQ,CAC7D,QAAO,cAAc,2CAA2C,IAAI;AAEtE,SAAO;GAAE;GAAM,OAAO;IAAE,MAAM,SAAS;IAAM,SAAS,SAAS;IAAS;GAAE;SACpE;AACN,SAAO,cAAc,wBAAwB,IAAI"}

package/dist/runtime/handlers/shared/platform-error.cjs

@@ -0,0 +1,39 @@
+const require_json_response = require('./json-response.cjs');
+const require_client = require('../../intelligence-platform/client.cjs');
+
+//#region src/runtime/handlers/shared/platform-error.ts
+/**
+* Map a thrown error from a platform call onto a `Response`.
+*
+* Extracted from the memory handlers, which had it first and alone; the thread
+* handlers flattened every failure to 500, so a "this does not exist yet" was
+* indistinguishable from "the platform is down". One copy, because two would
+* drift the moment either grew a case.
+*
+* Forward only client-actionable **4xx** statuses verbatim (404 missing or
+* wrong-scope, 409 conflict, 422 unprocessable) so a consumer can branch on
+* them — a flat 500 erases that distinction. A platform **5xx**, or any non-4xx
+* or malformed status, means this runtime is healthy but its dependency failed,
+* so it surfaces as `502 Bad Gateway` rather than echoing the upstream status as
+* if the runtime itself broke. That also avoids a `RangeError` from
+* `new Response(..., { status })` on an out-of-range status. Anything that is
+* not a platform error at all stays 500.
+*
+* A platform **401** is also 502: it rejects the runtime's own credentials
+* (e.g. a rotated API key), not the end user, so forwarding it would tell the
+* browser the user is unauthenticated for a fault only the server can fix. A
+* **403** is different: the platform uses it to deny this user an action (e.g.
+* a write to read-only memory), so it is forwarded like any other 4xx.
+*/
+function platformErrorResponse(error, message) {
+	if (error instanceof require_client.PlatformRequestError) {
+		const { status } = error;
+		if (Number.isInteger(status) && status >= 400 && status <= 499 && status !== 401) return require_json_response.errorResponse(message, status);
+		return require_json_response.errorResponse(message, 502);
+	}
+	return require_json_response.errorResponse(message, 500);
+}
+
+//#endregion
+exports.platformErrorResponse = platformErrorResponse;
+//# sourceMappingURL=platform-error.cjs.map

package/dist/runtime/handlers/shared/platform-error.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-error.cjs","names":["PlatformRequestError","errorResponse"],"sources":["../../../../src/runtime/handlers/shared/platform-error.ts"],"sourcesContent":["import { PlatformRequestError } from \"../../intelligence-platform/client\";\nimport { errorResponse } from \"./json-response\";\n\n/**\n * Map a thrown error from a platform call onto a `Response`.\n *\n * Extracted from the memory handlers, which had it first and alone; the thread\n * handlers flattened every failure to 500, so a \"this does not exist yet\" was\n * indistinguishable from \"the platform is down\". One copy, because two would\n * drift the moment either grew a case.\n *\n * Forward only client-actionable **4xx** statuses verbatim (404 missing or\n * wrong-scope, 409 conflict, 422 unprocessable) so a consumer can branch on\n * them — a flat 500 erases that distinction. A platform **5xx**, or any non-4xx\n * or malformed status, means this runtime is healthy but its dependency failed,\n * so it surfaces as `502 Bad Gateway` rather than echoing the upstream status as\n * if the runtime itself broke. That also avoids a `RangeError` from\n * `new Response(..., { status })` on an out-of-range status. Anything that is\n * not a platform error at all stays 500.\n *\n * A platform **401** is also 502: it rejects the runtime's own credentials\n * (e.g. a rotated API key), not the end user, so forwarding it would tell the\n * browser the user is unauthenticated for a fault only the server can fix. A\n * **403** is different: the platform uses it to deny this user an action (e.g.\n * a write to read-only memory), so it is forwarded like any other 4xx.\n */\nexport function platformErrorResponse(\n  error: unknown,\n  message: string,\n): Response {\n  if (error instanceof PlatformRequestError) {\n    const { status } = error;\n    if (\n      Number.isInteger(status) &&\n      status >= 400 &&\n      status <= 499 &&\n      status !== 401\n    ) {\n      return errorResponse(message, status);\n    }\n    return errorResponse(message, 502);\n  }\n  return errorResponse(message, 500);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,SAAgB,sBACd,OACA,SACU;AACV,KAAI,iBAAiBA,qCAAsB;EACzC,MAAM,EAAE,WAAW;AACnB,MACE,OAAO,UAAU,OAAO,IACxB,UAAU,OACV,UAAU,OACV,WAAW,IAEX,QAAOC,oCAAc,SAAS,OAAO;AAEvC,SAAOA,oCAAc,SAAS,IAAI;;AAEpC,QAAOA,oCAAc,SAAS,IAAI"}