@copilotkit/runtime 1.81.0 → 1.83.0

package/dist/v2/runtime/handlers/intelligence/threads.mjs

@@ -1,9 +1,10 @@
 import "reflect-metadata";
 import { supportsLocalThreadEndpoints } from "../../runner/agent-runner.mjs";
-import { isIntelligenceRuntime } from "../../core/runtime.mjs";
 import { errorResponse, isHandlerResponse } from "../shared/json-response.mjs";
-import { isValidIdentifier } from "../shared/intelligence-utils.mjs";
+import { getPlatformErrorStatus, isValidIdentifier } from "../shared/intelligence-utils.mjs";
 import { resolveIntelligenceUser } from "../shared/resolve-intelligence-user.mjs";
+import { resolveLocalThreadOwner } from "../shared/thread-access.mjs";
+import { isIntelligenceRuntime } from "../../core/runtime.mjs";
 import { platformErrorResponse } from "../shared/platform-error.mjs";
 import { logger } from "@copilotkit/shared";
 
@@ -36,6 +37,42 @@ async function resolveThreadMutationContext(runtime, request) {
 		agentId
 	};
 }
+/**
+* The platform's `_inspect` events and state endpoints are scoped by the
+* project key only. Before calling them, confirm the thread is visible to the
+* resolved user through the user-scoped thread lookup, and return its
+* canonical id for the read, so the check and the read name the same thread.
+*
+* Returns the error Response instead when the lookup refuses: the platform's
+* 4xx for a thread the user cannot see (an expected denial, logged as a
+* warning), 502 for a malformed lookup result, and the mapped platform error
+* for anything else (logged as an error).
+*/
+async function requireUserThread(runtime, threadId, userId, failure) {
+	let thread;
+	try {
+		thread = await runtime.intelligence.getThread({
+			threadId,
+			userId
+		});
+	} catch (error) {
+		const status = getPlatformErrorStatus(error);
+		if (status !== void 0 && status >= 400 && status < 500 && status !== 401) logger.warn({
+			threadId,
+			status
+		}, "Thread not visible to the user");
+		else logger.error({
+			err: error,
+			threadId
+		}, "Error resolving thread");
+		return platformErrorResponse(error, failure);
+	}
+	if (!thread || typeof thread.id !== "string" || !thread.id.trim()) {
+		logger.error({ threadId }, "Invalid thread response from getThread");
+		return errorResponse("Invalid thread response", 502);
+	}
+	return { threadId: thread.id };
+}
 async function handleListThreads({ runtime, request }) {
 	if (isIntelligenceRuntime(runtime)) try {
 		const url = new URL(request.url);
@@ -62,27 +99,54 @@ async function handleListThreads({ runtime, request }) {
 		return errorResponse("Failed to list threads", 500);
 	}
 	if (supportsLocalThreadEndpoints(runtime.runner)) {
-		const agentId = new URL(request.url).searchParams.get("agentId");
-		let threads = runtime.runner.listThreads();
-		if (agentId) threads = threads.filter((t) => t.agentId === agentId);
-		return Response.json({
-			threads,
-			nextCursor: null
+		const ownerId = await resolveLocalThreadOwner({
+			runtime,
+			request,
+			operation: "list"
 		});
+		if (isHandlerResponse(ownerId)) return ownerId;
+		try {
+			const agentId = new URL(request.url).searchParams.get("agentId");
+			let threads = runtime.runner.listThreads({ ownerId });
+			if (agentId) threads = threads.filter((t) => t.agentId === agentId);
+			return Response.json({
+				threads,
+				nextCursor: null
+			});
+		} catch (error) {
+			logger.error({ err: error }, "Error listing threads");
+			return errorResponse("Failed to list threads", 500);
+		}
 	}
 	return errorResponse("Missing CopilotKitIntelligence configuration. Thread operations require a CopilotKitIntelligence instance to be provided in CopilotRuntime options.", 422);
 }
 /**
-* Clears all in-memory thread history for the local-dev InMemory fallback.
+* Clears the caller's in-memory thread history for the local-dev fallback.
 *
 * The local-dev fallback exposes this so consumers (e.g. the demo's Clear
 * button) can wipe in-memory thread history without restarting the runtime.
+* Only the caller's own threads are cleared, and a thread whose run is
+* still active is kept. Without `identifyUser`, the access policy refuses it
+* unless `threads: { access: "open" }` is set.
 * Intentionally a no-op when CopilotKit Intelligence is configured: real
 * thread history lives in the database and must not be wiped by a
 * client-side page load.
 */
-function handleClearThreads({ runtime }) {
-	if (supportsLocalThreadEndpoints(runtime.runner)) runtime.runner.clearThreads();
+async function handleClearThreads({ runtime, request }) {
+	if (supportsLocalThreadEndpoints(runtime.runner)) {
+		const ownerId = await resolveLocalThreadOwner({
+			runtime,
+			request,
+			operation: "clear"
+		});
+		if (isHandlerResponse(ownerId)) return ownerId;
+		try {
+			runtime.runner.clearThreads({ ownerId });
+		} catch (error) {
+			logger.error({ err: error }, "Error clearing threads");
+			return errorResponse("Failed to clear threads", 500);
+		}
+	}
 	return new Response(null, { status: 204 });
 }
 async function handleUpdateThread({ runtime, request, threadId }) {
@@ -190,7 +254,23 @@ async function handleGetThreadMessages({ runtime, request, threadId }) {
 		return platformErrorResponse(error, "Failed to fetch thread messages");
 	}
 	if (supportsLocalThreadEndpoints(runtime.runner)) {
-		const mapped = runtime.runner.getThreadMessages(threadId).map((msg) => {
+		const ownerId = await resolveLocalThreadOwner({
+			runtime,
+			request,
+			operation: "read"
+		});
+		if (isHandlerResponse(ownerId)) return ownerId;
+		let messages;
+		try {
+			messages = runtime.runner.getThreadMessages(threadId, { ownerId });
+		} catch (error) {
+			logger.error({
+				err: error,
+				threadId
+			}, "Error fetching thread messages");
+			return errorResponse("Failed to fetch thread messages", 500);
+		}
+		const mapped = messages.map((msg) => {
 			switch (msg.role) {
 				case "assistant": {
 					const toolCalls = msg.toolCalls ?? [];
@@ -229,7 +309,12 @@ async function handleGetThreadEvents({ runtime, request, threadId }) {
 			request
 		});
 		if (isHandlerResponse(user)) return user;
-		const data = await runtime.intelligence.getThreadEvents({ threadId });
+		const thread = await requireUserThread(runtime, threadId, user.id, "Failed to fetch thread events");
+		if (isHandlerResponse(thread)) return thread;
+		const data = await runtime.intelligence.getThreadEvents({
+			threadId: thread.threadId,
+			userId: user.id
+		});
 		return Response.json({ events: data.events });
 	} catch (error) {
 		logger.error({
@@ -238,15 +323,23 @@ async function handleGetThreadEvents({ runtime, request, threadId }) {
 		}, "Error fetching thread events");
 		return platformErrorResponse(error, "Failed to fetch thread events");
 	}
-	if (supportsLocalThreadEndpoints(runtime.runner)) try {
-		const events = runtime.runner.getThreadEvents(threadId);
-		return Response.json({ events });
-	} catch (error) {
-		logger.error({
-			err: error,
-			threadId
-		}, "Error fetching thread events");
-		return errorResponse("Failed to fetch thread events", 500);
+	if (supportsLocalThreadEndpoints(runtime.runner)) {
+		const ownerId = await resolveLocalThreadOwner({
+			runtime,
+			request,
+			operation: "read"
+		});
+		if (isHandlerResponse(ownerId)) return ownerId;
+		try {
+			const events = runtime.runner.getThreadEvents(threadId, { ownerId });
+			return Response.json({ events });
+		} catch (error) {
+			logger.error({
+				err: error,
+				threadId
+			}, "Error fetching thread events");
+			return errorResponse("Failed to fetch thread events", 500);
+		}
 	}
 	return errorResponse("Missing CopilotKitIntelligence configuration. Thread operations require a CopilotKitIntelligence instance to be provided in CopilotRuntime options.", 422);
 }
@@ -257,7 +350,12 @@ async function handleGetThreadState({ runtime, request, threadId }) {
 			request
 		});
 		if (isHandlerResponse(user)) return user;
-		const data = await runtime.intelligence.getThreadState({ threadId });
+		const thread = await requireUserThread(runtime, threadId, user.id, "Failed to fetch thread state");
+		if (isHandlerResponse(thread)) return thread;
+		const data = await runtime.intelligence.getThreadState({
+			threadId: thread.threadId,
+			userId: user.id
+		});
 		const state = data.kind === "snapshot" ? data.state : null;
 		return Response.json({ state });
 	} catch (error) {
@@ -267,15 +365,23 @@ async function handleGetThreadState({ runtime, request, threadId }) {
 		}, "Error fetching thread state");
 		return platformErrorResponse(error, "Failed to fetch thread state");
 	}
-	if (supportsLocalThreadEndpoints(runtime.runner)) try {
-		const state = runtime.runner.getThreadState(threadId);
-		return Response.json({ state });
-	} catch (error) {
-		logger.error({
-			err: error,
-			threadId
-		}, "Error fetching thread state");
-		return errorResponse("Failed to fetch thread state", 500);
+	if (supportsLocalThreadEndpoints(runtime.runner)) {
+		const ownerId = await resolveLocalThreadOwner({
+			runtime,
+			request,
+			operation: "read"
+		});
+		if (isHandlerResponse(ownerId)) return ownerId;
+		try {
+			const state = runtime.runner.getThreadState(threadId, { ownerId });
+			return Response.json({ state });
+		} catch (error) {
+			logger.error({
+				err: error,
+				threadId
+			}, "Error fetching thread state");
+			return errorResponse("Failed to fetch thread state", 500);
+		}
 	}
 	return errorResponse("Missing CopilotKitIntelligence configuration. Thread operations require a CopilotKitIntelligence instance to be provided in CopilotRuntime options.", 422);
 }

package/dist/v2/runtime/handlers/intelligence/threads.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"threads.mjs","names":[],"sources":["../../../../../src/v2/runtime/handlers/intelligence/threads.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 { isValidIdentifier } from \"../shared/intelligence-utils\";\nimport { resolveIntelligenceUser } from \"../shared/resolve-intelligence-user\";\nimport { platformErrorResponse } from \"../shared/platform-error\";\nimport { supportsLocalThreadEndpoints } from \"../../runner/agent-runner\";\n\ninterface ThreadsHandlerParams {\n  runtime: CopilotRuntimeLike;\n  request: Request;\n}\n\ninterface ThreadMutationParams extends ThreadsHandlerParams {\n  threadId: string;\n}\n\ninterface ThreadMutationContext {\n  userId: string;\n  agentId: string;\n  body: Record<string, unknown>;\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 request body\");\n    return errorResponse(\"Invalid request body\", 400);\n  }\n}\n\nfunction requireIntelligenceRuntime(\n  runtime: CopilotRuntimeLike,\n): CopilotIntelligenceRuntimeLike | Response {\n  if (!isIntelligenceRuntime(runtime)) {\n    return errorResponse(\n      \"Missing CopilotKitIntelligence configuration. Thread operations require a CopilotKitIntelligence instance to be provided in CopilotRuntime options.\",\n      422,\n    );\n  }\n\n  return runtime;\n}\n\nasync function resolveThreadMutationContext(\n  runtime: CopilotIntelligenceRuntimeLike,\n  request: Request,\n): Promise<ThreadMutationContext | Response> {\n  const body = await parseJsonBody(request);\n  if (isHandlerResponse(body)) return body;\n\n  const user = await resolveIntelligenceUser({ runtime, request });\n  if (isHandlerResponse(user)) return user;\n\n  const agentId = body.agentId;\n  if (!isValidIdentifier(agentId)) {\n    return errorResponse(\"Valid agentId is required\", 400);\n  }\n\n  return {\n    body,\n    userId: user.id,\n    agentId,\n  };\n}\n\nexport async function handleListThreads({\n  runtime,\n  request,\n}: ThreadsHandlerParams): Promise<Response> {\n  // CopilotKit Intelligence path\n  if (isIntelligenceRuntime(runtime)) {\n    try {\n      const url = new URL(request.url);\n      const agentId = url.searchParams.get(\"agentId\");\n      const includeArchived =\n        url.searchParams.get(\"includeArchived\") === \"true\";\n      const limitParam = url.searchParams.get(\"limit\");\n      const cursor = url.searchParams.get(\"cursor\");\n      const user = await resolveIntelligenceUser({ runtime, request });\n      if (isHandlerResponse(user)) return user;\n\n      if (!isValidIdentifier(agentId)) {\n        return errorResponse(\"Valid agentId query param is required\", 400);\n      }\n\n      const data = await runtime.intelligence.listThreads({\n        userId: user.id,\n        agentId,\n        ...(includeArchived ? { includeArchived: true } : {}),\n        ...(limitParam ? { limit: Number(limitParam) } : {}),\n        ...(cursor ? { cursor } : {}),\n      });\n\n      return Response.json(data);\n    } catch (error) {\n      logger.error({ err: error }, \"Error listing threads\");\n      return errorResponse(\"Failed to list threads\", 500);\n    }\n  }\n\n  // Local in-memory fallback — useful for local development without Intelligence\n  if (supportsLocalThreadEndpoints(runtime.runner)) {\n    const url = new URL(request.url);\n    const agentId = url.searchParams.get(\"agentId\");\n    let threads = runtime.runner.listThreads();\n    if (agentId) {\n      threads = threads.filter((t) => t.agentId === agentId);\n    }\n    return Response.json({ threads, nextCursor: null });\n  }\n\n  return errorResponse(\n    \"Missing CopilotKitIntelligence configuration. Thread operations require a CopilotKitIntelligence instance to be provided in CopilotRuntime options.\",\n    422,\n  );\n}\n\n/**\n * Clears all in-memory thread history for the local-dev InMemory fallback.\n *\n * The local-dev fallback exposes this so consumers (e.g. the demo's Clear\n * button) can wipe in-memory thread history without restarting the runtime.\n * Intentionally a no-op when CopilotKit Intelligence is configured: real\n * thread history lives in the database and must not be wiped by a\n * client-side page load.\n */\nexport function handleClearThreads({\n  runtime,\n}: ThreadsHandlerParams): Response {\n  if (supportsLocalThreadEndpoints(runtime.runner)) {\n    runtime.runner.clearThreads();\n  }\n  return new Response(null, { status: 204 });\n}\n\nexport async function handleUpdateThread({\n  runtime,\n  request,\n  threadId,\n}: ThreadMutationParams): Promise<Response> {\n  const intelligenceRuntime = requireIntelligenceRuntime(runtime);\n  if (isHandlerResponse(intelligenceRuntime)) {\n    return intelligenceRuntime;\n  }\n\n  try {\n    const mutation = await resolveThreadMutationContext(\n      intelligenceRuntime,\n      request,\n    );\n    if (isHandlerResponse(mutation)) return mutation;\n\n    // The public SDK accepts trusted updates; browser fields must be allowlisted.\n    const updates: Record<string, unknown> = {};\n    for (const key of [\"name\", \"archived\"]) {\n      if (Object.prototype.hasOwnProperty.call(mutation.body, key)) {\n        updates[key] = mutation.body[key];\n      }\n    }\n\n    const thread = await intelligenceRuntime.intelligence.updateThread({\n      threadId,\n      userId: mutation.userId,\n      agentId: mutation.agentId,\n      updates,\n    });\n\n    return Response.json(thread);\n  } catch (error) {\n    logger.error({ err: error, threadId }, \"Error updating thread\");\n    return errorResponse(\"Failed to update thread\", 500);\n  }\n}\n\nexport async function handleSubscribeToThreads({\n  runtime,\n  request,\n}: ThreadsHandlerParams): Promise<Response> {\n  const intelligenceRuntime = requireIntelligenceRuntime(runtime);\n  if (isHandlerResponse(intelligenceRuntime)) {\n    return intelligenceRuntime;\n  }\n\n  try {\n    const user = await resolveIntelligenceUser({\n      runtime: intelligenceRuntime,\n      request,\n    });\n    if (isHandlerResponse(user)) return user;\n\n    const credentials =\n      await intelligenceRuntime.intelligence.ɵsubscribeToThreads({\n        userId: user.id,\n      });\n\n    return Response.json({ joinToken: credentials.joinToken });\n  } catch (error) {\n    logger.error({ err: error }, \"Error subscribing to threads\");\n    return errorResponse(\"Failed to subscribe to threads\", 500);\n  }\n}\n\nexport async function handleArchiveThread({\n  runtime,\n  request,\n  threadId,\n}: ThreadMutationParams): Promise<Response> {\n  const intelligenceRuntime = requireIntelligenceRuntime(runtime);\n  if (isHandlerResponse(intelligenceRuntime)) {\n    return intelligenceRuntime;\n  }\n\n  try {\n    const mutation = await resolveThreadMutationContext(\n      intelligenceRuntime,\n      request,\n    );\n    if (isHandlerResponse(mutation)) return mutation;\n\n    await intelligenceRuntime.intelligence.archiveThread({\n      threadId,\n      userId: mutation.userId,\n      agentId: mutation.agentId,\n    });\n\n    return Response.json({ threadId, archived: true });\n  } catch (error) {\n    logger.error({ err: error, threadId }, \"Error archiving thread\");\n    return errorResponse(\"Failed to archive thread\", 500);\n  }\n}\n\nexport async function handleDeleteThread({\n  runtime,\n  request,\n  threadId,\n}: ThreadMutationParams): Promise<Response> {\n  const intelligenceRuntime = requireIntelligenceRuntime(runtime);\n  if (isHandlerResponse(intelligenceRuntime)) {\n    return intelligenceRuntime;\n  }\n\n  try {\n    const mutation = await resolveThreadMutationContext(\n      intelligenceRuntime,\n      request,\n    );\n    if (isHandlerResponse(mutation)) return mutation;\n\n    await intelligenceRuntime.intelligence.deleteThread({\n      threadId,\n      userId: mutation.userId,\n      agentId: mutation.agentId,\n    });\n\n    return Response.json({ threadId, deleted: true });\n  } catch (error) {\n    logger.error({ err: error, threadId }, \"Error deleting thread\");\n    return errorResponse(\"Failed to delete thread\", 500);\n  }\n}\n\nexport async function handleGetThreadMessages({\n  runtime,\n  request,\n  threadId,\n}: ThreadMutationParams): Promise<Response> {\n  // CopilotKit Intelligence path\n  if (isIntelligenceRuntime(runtime)) {\n    try {\n      const user = await resolveIntelligenceUser({ runtime, request });\n      if (isHandlerResponse(user)) return user;\n\n      const data = await runtime.intelligence.getThreadMessages({\n        threadId,\n        userId: user.id,\n      });\n      return Response.json(data);\n    } catch (error) {\n      logger.error({ err: error, threadId }, \"Error fetching thread messages\");\n      return platformErrorResponse(error, \"Failed to fetch thread messages\");\n    }\n  }\n\n  // Local in-memory fallback — useful for local development without Intelligence\n  if (supportsLocalThreadEndpoints(runtime.runner)) {\n    const messages = runtime.runner.getThreadMessages(threadId);\n    // Map ag-ui Message objects to the same shape CopilotKit Intelligence\n    // returns. Switching on the discriminant `role` lets each branch read\n    // the narrowed message arm directly, instead of laundering through\n    // `Record<string, unknown>` and chained `as` casts.\n    const mapped = messages.map((msg) => {\n      switch (msg.role) {\n        case \"assistant\": {\n          const toolCalls = msg.toolCalls ?? [];\n          return {\n            id: msg.id,\n            role: msg.role,\n            ...(msg.content !== undefined ? { content: msg.content } : {}),\n            ...(toolCalls.length > 0\n              ? {\n                  toolCalls: toolCalls.map((tc) => ({\n                    id: tc.id,\n                    name: tc.function.name,\n                    args: tc.function.arguments,\n                  })),\n                }\n              : {}),\n          };\n        }\n        case \"tool\":\n          return {\n            id: msg.id,\n            role: msg.role,\n            content: msg.content,\n            toolCallId: msg.toolCallId,\n          };\n        default:\n          return {\n            id: msg.id,\n            role: msg.role,\n            ...(\"content\" in msg && msg.content !== undefined\n              ? { content: msg.content }\n              : {}),\n          };\n      }\n    });\n    return Response.json({ messages: mapped });\n  }\n\n  return errorResponse(\n    \"Missing CopilotKitIntelligence configuration. Thread operations require a CopilotKitIntelligence instance to be provided in CopilotRuntime options.\",\n    422,\n  );\n}\n\nexport async function handleGetThreadEvents({\n  runtime,\n  request,\n  threadId,\n}: ThreadMutationParams): Promise<Response> {\n  // CopilotKit Intelligence path. Delegates to the platform's `_inspect`\n  // endpoint (Intelligence PR #144). Auth still flows through the standard\n  // identifyUser → API key path; threadId scoping happens server-side.\n  if (isIntelligenceRuntime(runtime)) {\n    try {\n      const user = await resolveIntelligenceUser({ runtime, request });\n      if (isHandlerResponse(user)) return user;\n\n      const data = await runtime.intelligence.getThreadEvents({ threadId });\n      // Strip platform-internal fields (`decodeErrorRowIds`, `truncated`)\n      // before returning to the inspector — those describe persistence-side\n      // concerns the inspector currently has no UI for. The shape becomes\n      // `{ events }`, matching the in-memory branch below.\n      return Response.json({ events: data.events });\n    } catch (error) {\n      logger.error({ err: error, threadId }, \"Error fetching thread events\");\n      return platformErrorResponse(error, \"Failed to fetch thread events\");\n    }\n  }\n\n  // Local in-memory fallback\n  if (supportsLocalThreadEndpoints(runtime.runner)) {\n    try {\n      const events = runtime.runner.getThreadEvents(threadId);\n      return Response.json({ events });\n    } catch (error) {\n      logger.error({ err: error, threadId }, \"Error fetching thread events\");\n      return errorResponse(\"Failed to fetch thread events\", 500);\n    }\n  }\n\n  return errorResponse(\n    \"Missing CopilotKitIntelligence configuration. Thread operations require a CopilotKitIntelligence instance to be provided in CopilotRuntime options.\",\n    422,\n  );\n}\n\nexport async function handleGetThreadState({\n  runtime,\n  request,\n  threadId,\n}: ThreadMutationParams): Promise<Response> {\n  // CopilotKit Intelligence path. Delegates to the platform's `_inspect`\n  // state endpoint, which folds STATE_DELTA events onto the latest\n  // STATE_SNAPSHOT to return the thread's current state.\n  if (isIntelligenceRuntime(runtime)) {\n    try {\n      const user = await resolveIntelligenceUser({ runtime, request });\n      if (isHandlerResponse(user)) return user;\n\n      const data = await runtime.intelligence.getThreadState({ threadId });\n      // Flatten the discriminated `ThreadStateResult` to the wire shape the\n      // inspector consumes (`{ state: <value> | null }`). Missing snapshot\n      // and decode-error both surface as `null`; the inspector renders an\n      // empty state branch for null and the platform's decode-error case is\n      // already logged platform-side.\n      const state = data.kind === \"snapshot\" ? data.state : null;\n      return Response.json({ state });\n    } catch (error) {\n      logger.error({ err: error, threadId }, \"Error fetching thread state\");\n      return platformErrorResponse(error, \"Failed to fetch thread state\");\n    }\n  }\n\n  if (supportsLocalThreadEndpoints(runtime.runner)) {\n    try {\n      const state = runtime.runner.getThreadState(threadId);\n      return Response.json({ state });\n    } catch (error) {\n      logger.error({ err: error, threadId }, \"Error fetching thread state\");\n      return errorResponse(\"Failed to fetch thread state\", 500);\n    }\n  }\n\n  return errorResponse(\n    \"Missing CopilotKitIntelligence configuration. Thread operations require a CopilotKitIntelligence instance to be provided in CopilotRuntime options.\",\n    422,\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"threads.mjs","names":[],"sources":["../../../../../src/v2/runtime/handlers/intelligence/threads.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 {\n  getPlatformErrorStatus,\n  isValidIdentifier,\n} from \"../shared/intelligence-utils\";\nimport { resolveIntelligenceUser } from \"../shared/resolve-intelligence-user\";\nimport { platformErrorResponse } from \"../shared/platform-error\";\nimport { supportsLocalThreadEndpoints } from \"../../runner/agent-runner\";\nimport { resolveLocalThreadOwner } from \"../shared/thread-access\";\n\ninterface ThreadsHandlerParams {\n  runtime: CopilotRuntimeLike;\n  request: Request;\n}\n\ninterface ThreadMutationParams extends ThreadsHandlerParams {\n  threadId: string;\n}\n\ninterface ThreadMutationContext {\n  userId: string;\n  agentId: string;\n  body: Record<string, unknown>;\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 request body\");\n    return errorResponse(\"Invalid request body\", 400);\n  }\n}\n\nfunction requireIntelligenceRuntime(\n  runtime: CopilotRuntimeLike,\n): CopilotIntelligenceRuntimeLike | Response {\n  if (!isIntelligenceRuntime(runtime)) {\n    return errorResponse(\n      \"Missing CopilotKitIntelligence configuration. Thread operations require a CopilotKitIntelligence instance to be provided in CopilotRuntime options.\",\n      422,\n    );\n  }\n\n  return runtime;\n}\n\nasync function resolveThreadMutationContext(\n  runtime: CopilotIntelligenceRuntimeLike,\n  request: Request,\n): Promise<ThreadMutationContext | Response> {\n  const body = await parseJsonBody(request);\n  if (isHandlerResponse(body)) return body;\n\n  const user = await resolveIntelligenceUser({ runtime, request });\n  if (isHandlerResponse(user)) return user;\n\n  const agentId = body.agentId;\n  if (!isValidIdentifier(agentId)) {\n    return errorResponse(\"Valid agentId is required\", 400);\n  }\n\n  return {\n    body,\n    userId: user.id,\n    agentId,\n  };\n}\n\n/**\n * The platform's `_inspect` events and state endpoints are scoped by the\n * project key only. Before calling them, confirm the thread is visible to the\n * resolved user through the user-scoped thread lookup, and return its\n * canonical id for the read, so the check and the read name the same thread.\n *\n * Returns the error Response instead when the lookup refuses: the platform's\n * 4xx for a thread the user cannot see (an expected denial, logged as a\n * warning), 502 for a malformed lookup result, and the mapped platform error\n * for anything else (logged as an error).\n */\nasync function requireUserThread(\n  runtime: CopilotIntelligenceRuntimeLike,\n  threadId: string,\n  userId: string,\n  failure: string,\n): Promise<{ threadId: string } | Response> {\n  let thread: Awaited<ReturnType<typeof runtime.intelligence.getThread>>;\n  try {\n    thread = await runtime.intelligence.getThread({ threadId, userId });\n  } catch (error) {\n    const status = getPlatformErrorStatus(error);\n    if (\n      status !== undefined &&\n      status >= 400 &&\n      status < 500 &&\n      status !== 401\n    ) {\n      logger.warn({ threadId, status }, \"Thread not visible to the user\");\n    } else {\n      logger.error({ err: error, threadId }, \"Error resolving thread\");\n    }\n    return platformErrorResponse(error, failure);\n  }\n  if (!thread || typeof thread.id !== \"string\" || !thread.id.trim()) {\n    logger.error({ threadId }, \"Invalid thread response from getThread\");\n    return errorResponse(\"Invalid thread response\", 502);\n  }\n  return { threadId: thread.id };\n}\n\nexport async function handleListThreads({\n  runtime,\n  request,\n}: ThreadsHandlerParams): Promise<Response> {\n  // CopilotKit Intelligence path\n  if (isIntelligenceRuntime(runtime)) {\n    try {\n      const url = new URL(request.url);\n      const agentId = url.searchParams.get(\"agentId\");\n      const includeArchived =\n        url.searchParams.get(\"includeArchived\") === \"true\";\n      const limitParam = url.searchParams.get(\"limit\");\n      const cursor = url.searchParams.get(\"cursor\");\n      const user = await resolveIntelligenceUser({ runtime, request });\n      if (isHandlerResponse(user)) return user;\n\n      if (!isValidIdentifier(agentId)) {\n        return errorResponse(\"Valid agentId query param is required\", 400);\n      }\n\n      const data = await runtime.intelligence.listThreads({\n        userId: user.id,\n        agentId,\n        ...(includeArchived ? { includeArchived: true } : {}),\n        ...(limitParam ? { limit: Number(limitParam) } : {}),\n        ...(cursor ? { cursor } : {}),\n      });\n\n      return Response.json(data);\n    } catch (error) {\n      logger.error({ err: error }, \"Error listing threads\");\n      return errorResponse(\"Failed to list threads\", 500);\n    }\n  }\n\n  // Local in-memory fallback — useful for local development without Intelligence\n  if (supportsLocalThreadEndpoints(runtime.runner)) {\n    const ownerId = await resolveLocalThreadOwner({\n      runtime,\n      request,\n      operation: \"list\",\n    });\n    if (isHandlerResponse(ownerId)) return ownerId;\n    try {\n      const url = new URL(request.url);\n      const agentId = url.searchParams.get(\"agentId\");\n      let threads = runtime.runner.listThreads({ ownerId });\n      if (agentId) {\n        threads = threads.filter((t) => t.agentId === agentId);\n      }\n      return Response.json({ threads, nextCursor: null });\n    } catch (error) {\n      logger.error({ err: error }, \"Error listing threads\");\n      return errorResponse(\"Failed to list threads\", 500);\n    }\n  }\n\n  return errorResponse(\n    \"Missing CopilotKitIntelligence configuration. Thread operations require a CopilotKitIntelligence instance to be provided in CopilotRuntime options.\",\n    422,\n  );\n}\n\n/**\n * Clears the caller's in-memory thread history for the local-dev fallback.\n *\n * The local-dev fallback exposes this so consumers (e.g. the demo's Clear\n * button) can wipe in-memory thread history without restarting the runtime.\n * Only the caller's own threads are cleared, and a thread whose run is\n * still active is kept. Without `identifyUser`, the access policy refuses it\n * unless `threads: { access: \"open\" }` is set.\n * Intentionally a no-op when CopilotKit Intelligence is configured: real\n * thread history lives in the database and must not be wiped by a\n * client-side page load.\n */\nexport async function handleClearThreads({\n  runtime,\n  request,\n}: ThreadsHandlerParams): Promise<Response> {\n  if (supportsLocalThreadEndpoints(runtime.runner)) {\n    const ownerId = await resolveLocalThreadOwner({\n      runtime,\n      request,\n      operation: \"clear\",\n    });\n    if (isHandlerResponse(ownerId)) return ownerId;\n    try {\n      runtime.runner.clearThreads({ ownerId });\n    } catch (error) {\n      logger.error({ err: error }, \"Error clearing threads\");\n      return errorResponse(\"Failed to clear threads\", 500);\n    }\n  }\n  return new Response(null, { status: 204 });\n}\n\nexport async function handleUpdateThread({\n  runtime,\n  request,\n  threadId,\n}: ThreadMutationParams): Promise<Response> {\n  const intelligenceRuntime = requireIntelligenceRuntime(runtime);\n  if (isHandlerResponse(intelligenceRuntime)) {\n    return intelligenceRuntime;\n  }\n\n  try {\n    const mutation = await resolveThreadMutationContext(\n      intelligenceRuntime,\n      request,\n    );\n    if (isHandlerResponse(mutation)) return mutation;\n\n    // The public SDK accepts trusted updates; browser fields must be allowlisted.\n    const updates: Record<string, unknown> = {};\n    for (const key of [\"name\", \"archived\"]) {\n      if (Object.prototype.hasOwnProperty.call(mutation.body, key)) {\n        updates[key] = mutation.body[key];\n      }\n    }\n\n    const thread = await intelligenceRuntime.intelligence.updateThread({\n      threadId,\n      userId: mutation.userId,\n      agentId: mutation.agentId,\n      updates,\n    });\n\n    return Response.json(thread);\n  } catch (error) {\n    logger.error({ err: error, threadId }, \"Error updating thread\");\n    return errorResponse(\"Failed to update thread\", 500);\n  }\n}\n\nexport async function handleSubscribeToThreads({\n  runtime,\n  request,\n}: ThreadsHandlerParams): Promise<Response> {\n  const intelligenceRuntime = requireIntelligenceRuntime(runtime);\n  if (isHandlerResponse(intelligenceRuntime)) {\n    return intelligenceRuntime;\n  }\n\n  try {\n    const user = await resolveIntelligenceUser({\n      runtime: intelligenceRuntime,\n      request,\n    });\n    if (isHandlerResponse(user)) return user;\n\n    const credentials =\n      await intelligenceRuntime.intelligence.ɵsubscribeToThreads({\n        userId: user.id,\n      });\n\n    return Response.json({ joinToken: credentials.joinToken });\n  } catch (error) {\n    logger.error({ err: error }, \"Error subscribing to threads\");\n    return errorResponse(\"Failed to subscribe to threads\", 500);\n  }\n}\n\nexport async function handleArchiveThread({\n  runtime,\n  request,\n  threadId,\n}: ThreadMutationParams): Promise<Response> {\n  const intelligenceRuntime = requireIntelligenceRuntime(runtime);\n  if (isHandlerResponse(intelligenceRuntime)) {\n    return intelligenceRuntime;\n  }\n\n  try {\n    const mutation = await resolveThreadMutationContext(\n      intelligenceRuntime,\n      request,\n    );\n    if (isHandlerResponse(mutation)) return mutation;\n\n    await intelligenceRuntime.intelligence.archiveThread({\n      threadId,\n      userId: mutation.userId,\n      agentId: mutation.agentId,\n    });\n\n    return Response.json({ threadId, archived: true });\n  } catch (error) {\n    logger.error({ err: error, threadId }, \"Error archiving thread\");\n    return errorResponse(\"Failed to archive thread\", 500);\n  }\n}\n\nexport async function handleDeleteThread({\n  runtime,\n  request,\n  threadId,\n}: ThreadMutationParams): Promise<Response> {\n  const intelligenceRuntime = requireIntelligenceRuntime(runtime);\n  if (isHandlerResponse(intelligenceRuntime)) {\n    return intelligenceRuntime;\n  }\n\n  try {\n    const mutation = await resolveThreadMutationContext(\n      intelligenceRuntime,\n      request,\n    );\n    if (isHandlerResponse(mutation)) return mutation;\n\n    await intelligenceRuntime.intelligence.deleteThread({\n      threadId,\n      userId: mutation.userId,\n      agentId: mutation.agentId,\n    });\n\n    return Response.json({ threadId, deleted: true });\n  } catch (error) {\n    logger.error({ err: error, threadId }, \"Error deleting thread\");\n    return errorResponse(\"Failed to delete thread\", 500);\n  }\n}\n\nexport async function handleGetThreadMessages({\n  runtime,\n  request,\n  threadId,\n}: ThreadMutationParams): Promise<Response> {\n  // CopilotKit Intelligence path\n  if (isIntelligenceRuntime(runtime)) {\n    try {\n      const user = await resolveIntelligenceUser({ runtime, request });\n      if (isHandlerResponse(user)) return user;\n\n      const data = await runtime.intelligence.getThreadMessages({\n        threadId,\n        userId: user.id,\n      });\n      return Response.json(data);\n    } catch (error) {\n      logger.error({ err: error, threadId }, \"Error fetching thread messages\");\n      return platformErrorResponse(error, \"Failed to fetch thread messages\");\n    }\n  }\n\n  // Local in-memory fallback — useful for local development without Intelligence\n  if (supportsLocalThreadEndpoints(runtime.runner)) {\n    const ownerId = await resolveLocalThreadOwner({\n      runtime,\n      request,\n      operation: \"read\",\n    });\n    if (isHandlerResponse(ownerId)) return ownerId;\n    // Another owner's thread reads exactly like an unknown thread.\n    let messages: ReturnType<typeof runtime.runner.getThreadMessages>;\n    try {\n      messages = runtime.runner.getThreadMessages(threadId, { ownerId });\n    } catch (error) {\n      logger.error({ err: error, threadId }, \"Error fetching thread messages\");\n      return errorResponse(\"Failed to fetch thread messages\", 500);\n    }\n    // Map ag-ui Message objects to the same shape CopilotKit Intelligence\n    // returns. Switching on the discriminant `role` lets each branch read\n    // the narrowed message arm directly, instead of laundering through\n    // `Record<string, unknown>` and chained `as` casts.\n    const mapped = messages.map((msg) => {\n      switch (msg.role) {\n        case \"assistant\": {\n          const toolCalls = msg.toolCalls ?? [];\n          return {\n            id: msg.id,\n            role: msg.role,\n            ...(msg.content !== undefined ? { content: msg.content } : {}),\n            ...(toolCalls.length > 0\n              ? {\n                  toolCalls: toolCalls.map((tc) => ({\n                    id: tc.id,\n                    name: tc.function.name,\n                    args: tc.function.arguments,\n                  })),\n                }\n              : {}),\n          };\n        }\n        case \"tool\":\n          return {\n            id: msg.id,\n            role: msg.role,\n            content: msg.content,\n            toolCallId: msg.toolCallId,\n          };\n        default:\n          return {\n            id: msg.id,\n            role: msg.role,\n            ...(\"content\" in msg && msg.content !== undefined\n              ? { content: msg.content }\n              : {}),\n          };\n      }\n    });\n    return Response.json({ messages: mapped });\n  }\n\n  return errorResponse(\n    \"Missing CopilotKitIntelligence configuration. Thread operations require a CopilotKitIntelligence instance to be provided in CopilotRuntime options.\",\n    422,\n  );\n}\n\nexport async function handleGetThreadEvents({\n  runtime,\n  request,\n  threadId,\n}: ThreadMutationParams): Promise<Response> {\n  // CopilotKit Intelligence path. Delegates to the platform's `_inspect`\n  // endpoint (Intelligence PR #144). Auth still flows through the standard\n  // identifyUser → API key path. `_inspect` is not user-scoped, so the\n  // thread is first checked against the user (see `requireUserThread`).\n  if (isIntelligenceRuntime(runtime)) {\n    try {\n      const user = await resolveIntelligenceUser({ runtime, request });\n      if (isHandlerResponse(user)) return user;\n      const thread = await requireUserThread(\n        runtime,\n        threadId,\n        user.id,\n        \"Failed to fetch thread events\",\n      );\n      if (isHandlerResponse(thread)) return thread;\n\n      const data = await runtime.intelligence.getThreadEvents({\n        threadId: thread.threadId,\n        userId: user.id,\n      });\n      // Strip platform-internal fields (`decodeErrorRowIds`, `truncated`)\n      // before returning to the inspector — those describe persistence-side\n      // concerns the inspector currently has no UI for. The shape becomes\n      // `{ events }`, matching the in-memory branch below.\n      return Response.json({ events: data.events });\n    } catch (error) {\n      logger.error({ err: error, threadId }, \"Error fetching thread events\");\n      return platformErrorResponse(error, \"Failed to fetch thread events\");\n    }\n  }\n\n  // Local in-memory fallback\n  if (supportsLocalThreadEndpoints(runtime.runner)) {\n    const ownerId = await resolveLocalThreadOwner({\n      runtime,\n      request,\n      operation: \"read\",\n    });\n    if (isHandlerResponse(ownerId)) return ownerId;\n    try {\n      const events = runtime.runner.getThreadEvents(threadId, { ownerId });\n      return Response.json({ events });\n    } catch (error) {\n      logger.error({ err: error, threadId }, \"Error fetching thread events\");\n      return errorResponse(\"Failed to fetch thread events\", 500);\n    }\n  }\n\n  return errorResponse(\n    \"Missing CopilotKitIntelligence configuration. Thread operations require a CopilotKitIntelligence instance to be provided in CopilotRuntime options.\",\n    422,\n  );\n}\n\nexport async function handleGetThreadState({\n  runtime,\n  request,\n  threadId,\n}: ThreadMutationParams): Promise<Response> {\n  // CopilotKit Intelligence path. Delegates to the platform's `_inspect`\n  // state endpoint, which folds STATE_DELTA events onto the latest\n  // STATE_SNAPSHOT to return the thread's current state.\n  if (isIntelligenceRuntime(runtime)) {\n    try {\n      const user = await resolveIntelligenceUser({ runtime, request });\n      if (isHandlerResponse(user)) return user;\n      const thread = await requireUserThread(\n        runtime,\n        threadId,\n        user.id,\n        \"Failed to fetch thread state\",\n      );\n      if (isHandlerResponse(thread)) return thread;\n\n      const data = await runtime.intelligence.getThreadState({\n        threadId: thread.threadId,\n        userId: user.id,\n      });\n      // Flatten the discriminated `ThreadStateResult` to the wire shape the\n      // inspector consumes (`{ state: <value> | null }`). Missing snapshot\n      // and decode-error both surface as `null`; the inspector renders an\n      // empty state branch for null and the platform's decode-error case is\n      // already logged platform-side.\n      const state = data.kind === \"snapshot\" ? data.state : null;\n      return Response.json({ state });\n    } catch (error) {\n      logger.error({ err: error, threadId }, \"Error fetching thread state\");\n      return platformErrorResponse(error, \"Failed to fetch thread state\");\n    }\n  }\n\n  if (supportsLocalThreadEndpoints(runtime.runner)) {\n    const ownerId = await resolveLocalThreadOwner({\n      runtime,\n      request,\n      operation: \"read\",\n    });\n    if (isHandlerResponse(ownerId)) return ownerId;\n    try {\n      const state = runtime.runner.getThreadState(threadId, { ownerId });\n      return Response.json({ state });\n    } catch (error) {\n      logger.error({ err: error, threadId }, \"Error fetching thread state\");\n      return errorResponse(\"Failed to fetch thread state\", 500);\n    }\n  }\n\n  return errorResponse(\n    \"Missing CopilotKitIntelligence configuration. Thread operations require a CopilotKitIntelligence instance to be provided in CopilotRuntime options.\",\n    422,\n  );\n}\n"],"mappings":";;;;;;;;;;;AA+BA,eAAe,cACb,SAC6C;AAC7C,KAAI;AACF,SAAQ,MAAM,QAAQ,MAAM;UACrB,OAAO;AACd,SAAO,MAAM,EAAE,KAAK,OAAO,EAAE,iCAAiC;AAC9D,SAAO,cAAc,wBAAwB,IAAI;;;AAIrD,SAAS,2BACP,SAC2C;AAC3C,KAAI,CAAC,sBAAsB,QAAQ,CACjC,QAAO,cACL,uJACA,IACD;AAGH,QAAO;;AAGT,eAAe,6BACb,SACA,SAC2C;CAC3C,MAAM,OAAO,MAAM,cAAc,QAAQ;AACzC,KAAI,kBAAkB,KAAK,CAAE,QAAO;CAEpC,MAAM,OAAO,MAAM,wBAAwB;EAAE;EAAS;EAAS,CAAC;AAChE,KAAI,kBAAkB,KAAK,CAAE,QAAO;CAEpC,MAAM,UAAU,KAAK;AACrB,KAAI,CAAC,kBAAkB,QAAQ,CAC7B,QAAO,cAAc,6BAA6B,IAAI;AAGxD,QAAO;EACL;EACA,QAAQ,KAAK;EACb;EACD;;;;;;;;;;;;;AAcH,eAAe,kBACb,SACA,UACA,QACA,SAC0C;CAC1C,IAAI;AACJ,KAAI;AACF,WAAS,MAAM,QAAQ,aAAa,UAAU;GAAE;GAAU;GAAQ,CAAC;UAC5D,OAAO;EACd,MAAM,SAAS,uBAAuB,MAAM;AAC5C,MACE,WAAW,UACX,UAAU,OACV,SAAS,OACT,WAAW,IAEX,QAAO,KAAK;GAAE;GAAU;GAAQ,EAAE,iCAAiC;MAEnE,QAAO,MAAM;GAAE,KAAK;GAAO;GAAU,EAAE,yBAAyB;AAElE,SAAO,sBAAsB,OAAO,QAAQ;;AAE9C,KAAI,CAAC,UAAU,OAAO,OAAO,OAAO,YAAY,CAAC,OAAO,GAAG,MAAM,EAAE;AACjE,SAAO,MAAM,EAAE,UAAU,EAAE,yCAAyC;AACpE,SAAO,cAAc,2BAA2B,IAAI;;AAEtD,QAAO,EAAE,UAAU,OAAO,IAAI;;AAGhC,eAAsB,kBAAkB,EACtC,SACA,WAC0C;AAE1C,KAAI,sBAAsB,QAAQ,CAChC,KAAI;EACF,MAAM,MAAM,IAAI,IAAI,QAAQ,IAAI;EAChC,MAAM,UAAU,IAAI,aAAa,IAAI,UAAU;EAC/C,MAAM,kBACJ,IAAI,aAAa,IAAI,kBAAkB,KAAK;EAC9C,MAAM,aAAa,IAAI,aAAa,IAAI,QAAQ;EAChD,MAAM,SAAS,IAAI,aAAa,IAAI,SAAS;EAC7C,MAAM,OAAO,MAAM,wBAAwB;GAAE;GAAS;GAAS,CAAC;AAChE,MAAI,kBAAkB,KAAK,CAAE,QAAO;AAEpC,MAAI,CAAC,kBAAkB,QAAQ,CAC7B,QAAO,cAAc,yCAAyC,IAAI;EAGpE,MAAM,OAAO,MAAM,QAAQ,aAAa,YAAY;GAClD,QAAQ,KAAK;GACb;GACA,GAAI,kBAAkB,EAAE,iBAAiB,MAAM,GAAG,EAAE;GACpD,GAAI,aAAa,EAAE,OAAO,OAAO,WAAW,EAAE,GAAG,EAAE;GACnD,GAAI,SAAS,EAAE,QAAQ,GAAG,EAAE;GAC7B,CAAC;AAEF,SAAO,SAAS,KAAK,KAAK;UACnB,OAAO;AACd,SAAO,MAAM,EAAE,KAAK,OAAO,EAAE,wBAAwB;AACrD,SAAO,cAAc,0BAA0B,IAAI;;AAKvD,KAAI,6BAA6B,QAAQ,OAAO,EAAE;EAChD,MAAM,UAAU,MAAM,wBAAwB;GAC5C;GACA;GACA,WAAW;GACZ,CAAC;AACF,MAAI,kBAAkB,QAAQ,CAAE,QAAO;AACvC,MAAI;GAEF,MAAM,UADM,IAAI,IAAI,QAAQ,IAAI,CACZ,aAAa,IAAI,UAAU;GAC/C,IAAI,UAAU,QAAQ,OAAO,YAAY,EAAE,SAAS,CAAC;AACrD,OAAI,QACF,WAAU,QAAQ,QAAQ,MAAM,EAAE,YAAY,QAAQ;AAExD,UAAO,SAAS,KAAK;IAAE;IAAS,YAAY;IAAM,CAAC;WAC5C,OAAO;AACd,UAAO,MAAM,EAAE,KAAK,OAAO,EAAE,wBAAwB;AACrD,UAAO,cAAc,0BAA0B,IAAI;;;AAIvD,QAAO,cACL,uJACA,IACD;;;;;;;;;;;;;;AAeH,eAAsB,mBAAmB,EACvC,SACA,WAC0C;AAC1C,KAAI,6BAA6B,QAAQ,OAAO,EAAE;EAChD,MAAM,UAAU,MAAM,wBAAwB;GAC5C;GACA;GACA,WAAW;GACZ,CAAC;AACF,MAAI,kBAAkB,QAAQ,CAAE,QAAO;AACvC,MAAI;AACF,WAAQ,OAAO,aAAa,EAAE,SAAS,CAAC;WACjC,OAAO;AACd,UAAO,MAAM,EAAE,KAAK,OAAO,EAAE,yBAAyB;AACtD,UAAO,cAAc,2BAA2B,IAAI;;;AAGxD,QAAO,IAAI,SAAS,MAAM,EAAE,QAAQ,KAAK,CAAC;;AAG5C,eAAsB,mBAAmB,EACvC,SACA,SACA,YAC0C;CAC1C,MAAM,sBAAsB,2BAA2B,QAAQ;AAC/D,KAAI,kBAAkB,oBAAoB,CACxC,QAAO;AAGT,KAAI;EACF,MAAM,WAAW,MAAM,6BACrB,qBACA,QACD;AACD,MAAI,kBAAkB,SAAS,CAAE,QAAO;EAGxC,MAAM,UAAmC,EAAE;AAC3C,OAAK,MAAM,OAAO,CAAC,QAAQ,WAAW,CACpC,KAAI,OAAO,UAAU,eAAe,KAAK,SAAS,MAAM,IAAI,CAC1D,SAAQ,OAAO,SAAS,KAAK;EAIjC,MAAM,SAAS,MAAM,oBAAoB,aAAa,aAAa;GACjE;GACA,QAAQ,SAAS;GACjB,SAAS,SAAS;GAClB;GACD,CAAC;AAEF,SAAO,SAAS,KAAK,OAAO;UACrB,OAAO;AACd,SAAO,MAAM;GAAE,KAAK;GAAO;GAAU,EAAE,wBAAwB;AAC/D,SAAO,cAAc,2BAA2B,IAAI;;;AAIxD,eAAsB,yBAAyB,EAC7C,SACA,WAC0C;CAC1C,MAAM,sBAAsB,2BAA2B,QAAQ;AAC/D,KAAI,kBAAkB,oBAAoB,CACxC,QAAO;AAGT,KAAI;EACF,MAAM,OAAO,MAAM,wBAAwB;GACzC,SAAS;GACT;GACD,CAAC;AACF,MAAI,kBAAkB,KAAK,CAAE,QAAO;EAEpC,MAAM,cACJ,MAAM,oBAAoB,aAAa,oBAAoB,EACzD,QAAQ,KAAK,IACd,CAAC;AAEJ,SAAO,SAAS,KAAK,EAAE,WAAW,YAAY,WAAW,CAAC;UACnD,OAAO;AACd,SAAO,MAAM,EAAE,KAAK,OAAO,EAAE,+BAA+B;AAC5D,SAAO,cAAc,kCAAkC,IAAI;;;AAI/D,eAAsB,oBAAoB,EACxC,SACA,SACA,YAC0C;CAC1C,MAAM,sBAAsB,2BAA2B,QAAQ;AAC/D,KAAI,kBAAkB,oBAAoB,CACxC,QAAO;AAGT,KAAI;EACF,MAAM,WAAW,MAAM,6BACrB,qBACA,QACD;AACD,MAAI,kBAAkB,SAAS,CAAE,QAAO;AAExC,QAAM,oBAAoB,aAAa,cAAc;GACnD;GACA,QAAQ,SAAS;GACjB,SAAS,SAAS;GACnB,CAAC;AAEF,SAAO,SAAS,KAAK;GAAE;GAAU,UAAU;GAAM,CAAC;UAC3C,OAAO;AACd,SAAO,MAAM;GAAE,KAAK;GAAO;GAAU,EAAE,yBAAyB;AAChE,SAAO,cAAc,4BAA4B,IAAI;;;AAIzD,eAAsB,mBAAmB,EACvC,SACA,SACA,YAC0C;CAC1C,MAAM,sBAAsB,2BAA2B,QAAQ;AAC/D,KAAI,kBAAkB,oBAAoB,CACxC,QAAO;AAGT,KAAI;EACF,MAAM,WAAW,MAAM,6BACrB,qBACA,QACD;AACD,MAAI,kBAAkB,SAAS,CAAE,QAAO;AAExC,QAAM,oBAAoB,aAAa,aAAa;GAClD;GACA,QAAQ,SAAS;GACjB,SAAS,SAAS;GACnB,CAAC;AAEF,SAAO,SAAS,KAAK;GAAE;GAAU,SAAS;GAAM,CAAC;UAC1C,OAAO;AACd,SAAO,MAAM;GAAE,KAAK;GAAO;GAAU,EAAE,wBAAwB;AAC/D,SAAO,cAAc,2BAA2B,IAAI;;;AAIxD,eAAsB,wBAAwB,EAC5C,SACA,SACA,YAC0C;AAE1C,KAAI,sBAAsB,QAAQ,CAChC,KAAI;EACF,MAAM,OAAO,MAAM,wBAAwB;GAAE;GAAS;GAAS,CAAC;AAChE,MAAI,kBAAkB,KAAK,CAAE,QAAO;EAEpC,MAAM,OAAO,MAAM,QAAQ,aAAa,kBAAkB;GACxD;GACA,QAAQ,KAAK;GACd,CAAC;AACF,SAAO,SAAS,KAAK,KAAK;UACnB,OAAO;AACd,SAAO,MAAM;GAAE,KAAK;GAAO;GAAU,EAAE,iCAAiC;AACxE,SAAO,sBAAsB,OAAO,kCAAkC;;AAK1E,KAAI,6BAA6B,QAAQ,OAAO,EAAE;EAChD,MAAM,UAAU,MAAM,wBAAwB;GAC5C;GACA;GACA,WAAW;GACZ,CAAC;AACF,MAAI,kBAAkB,QAAQ,CAAE,QAAO;EAEvC,IAAI;AACJ,MAAI;AACF,cAAW,QAAQ,OAAO,kBAAkB,UAAU,EAAE,SAAS,CAAC;WAC3D,OAAO;AACd,UAAO,MAAM;IAAE,KAAK;IAAO;IAAU,EAAE,iCAAiC;AACxE,UAAO,cAAc,mCAAmC,IAAI;;EAM9D,MAAM,SAAS,SAAS,KAAK,QAAQ;AACnC,WAAQ,IAAI,MAAZ;IACE,KAAK,aAAa;KAChB,MAAM,YAAY,IAAI,aAAa,EAAE;AACrC,YAAO;MACL,IAAI,IAAI;MACR,MAAM,IAAI;MACV,GAAI,IAAI,YAAY,SAAY,EAAE,SAAS,IAAI,SAAS,GAAG,EAAE;MAC7D,GAAI,UAAU,SAAS,IACnB,EACE,WAAW,UAAU,KAAK,QAAQ;OAChC,IAAI,GAAG;OACP,MAAM,GAAG,SAAS;OAClB,MAAM,GAAG,SAAS;OACnB,EAAE,EACJ,GACD,EAAE;MACP;;IAEH,KAAK,OACH,QAAO;KACL,IAAI,IAAI;KACR,MAAM,IAAI;KACV,SAAS,IAAI;KACb,YAAY,IAAI;KACjB;IACH,QACE,QAAO;KACL,IAAI,IAAI;KACR,MAAM,IAAI;KACV,GAAI,aAAa,OAAO,IAAI,YAAY,SACpC,EAAE,SAAS,IAAI,SAAS,GACxB,EAAE;KACP;;IAEL;AACF,SAAO,SAAS,KAAK,EAAE,UAAU,QAAQ,CAAC;;AAG5C,QAAO,cACL,uJACA,IACD;;AAGH,eAAsB,sBAAsB,EAC1C,SACA,SACA,YAC0C;AAK1C,KAAI,sBAAsB,QAAQ,CAChC,KAAI;EACF,MAAM,OAAO,MAAM,wBAAwB;GAAE;GAAS;GAAS,CAAC;AAChE,MAAI,kBAAkB,KAAK,CAAE,QAAO;EACpC,MAAM,SAAS,MAAM,kBACnB,SACA,UACA,KAAK,IACL,gCACD;AACD,MAAI,kBAAkB,OAAO,CAAE,QAAO;EAEtC,MAAM,OAAO,MAAM,QAAQ,aAAa,gBAAgB;GACtD,UAAU,OAAO;GACjB,QAAQ,KAAK;GACd,CAAC;AAKF,SAAO,SAAS,KAAK,EAAE,QAAQ,KAAK,QAAQ,CAAC;UACtC,OAAO;AACd,SAAO,MAAM;GAAE,KAAK;GAAO;GAAU,EAAE,+BAA+B;AACtE,SAAO,sBAAsB,OAAO,gCAAgC;;AAKxE,KAAI,6BAA6B,QAAQ,OAAO,EAAE;EAChD,MAAM,UAAU,MAAM,wBAAwB;GAC5C;GACA;GACA,WAAW;GACZ,CAAC;AACF,MAAI,kBAAkB,QAAQ,CAAE,QAAO;AACvC,MAAI;GACF,MAAM,SAAS,QAAQ,OAAO,gBAAgB,UAAU,EAAE,SAAS,CAAC;AACpE,UAAO,SAAS,KAAK,EAAE,QAAQ,CAAC;WACzB,OAAO;AACd,UAAO,MAAM;IAAE,KAAK;IAAO;IAAU,EAAE,+BAA+B;AACtE,UAAO,cAAc,iCAAiC,IAAI;;;AAI9D,QAAO,cACL,uJACA,IACD;;AAGH,eAAsB,qBAAqB,EACzC,SACA,SACA,YAC0C;AAI1C,KAAI,sBAAsB,QAAQ,CAChC,KAAI;EACF,MAAM,OAAO,MAAM,wBAAwB;GAAE;GAAS;GAAS,CAAC;AAChE,MAAI,kBAAkB,KAAK,CAAE,QAAO;EACpC,MAAM,SAAS,MAAM,kBACnB,SACA,UACA,KAAK,IACL,+BACD;AACD,MAAI,kBAAkB,OAAO,CAAE,QAAO;EAEtC,MAAM,OAAO,MAAM,QAAQ,aAAa,eAAe;GACrD,UAAU,OAAO;GACjB,QAAQ,KAAK;GACd,CAAC;EAMF,MAAM,QAAQ,KAAK,SAAS,aAAa,KAAK,QAAQ;AACtD,SAAO,SAAS,KAAK,EAAE,OAAO,CAAC;UACxB,OAAO;AACd,SAAO,MAAM;GAAE,KAAK;GAAO;GAAU,EAAE,8BAA8B;AACrE,SAAO,sBAAsB,OAAO,+BAA+B;;AAIvE,KAAI,6BAA6B,QAAQ,OAAO,EAAE;EAChD,MAAM,UAAU,MAAM,wBAAwB;GAC5C;GACA;GACA,WAAW;GACZ,CAAC;AACF,MAAI,kBAAkB,QAAQ,CAAE,QAAO;AACvC,MAAI;GACF,MAAM,QAAQ,QAAQ,OAAO,eAAe,UAAU,EAAE,SAAS,CAAC;AAClE,UAAO,SAAS,KAAK,EAAE,OAAO,CAAC;WACxB,OAAO;AACd,UAAO,MAAM;IAAE,KAAK;IAAO;IAAU,EAAE,8BAA8B;AACrE,UAAO,cAAc,gCAAgC,IAAI;;;AAI7D,QAAO,cACL,uJACA,IACD"}

package/dist/v2/runtime/handlers/shared/agent-utils.cjs

@@ -1,12 +1,12 @@
 require("reflect-metadata");
 const require_runtime = require('../../../../_virtual/_rolldown/runtime.cjs');
 const require_header_utils = require('../header-utils.cjs');
-const require_runtime$1 = require('../../core/runtime.cjs');
+const require_json_response = require('./json-response.cjs');
 const require_client = require('../../intelligence-platform/client.cjs');
+const require_resolve_intelligence_user = require('./resolve-intelligence-user.cjs');
+const require_runtime$1 = require('../../core/runtime.cjs');
 const require_generative_ui_middleware = require('../../generative-ui/generative-ui-middleware.cjs');
 const require_mcp_apps_servers = require('./mcp-apps-servers.cjs');
-const require_json_response = require('./json-response.cjs');
-const require_resolve_intelligence_user = require('./resolve-intelligence-user.cjs');
 const require_memory_policy = require('./memory-policy.cjs');
 let _copilotkit_shared = require("@copilotkit/shared");
 let _ag_ui_mcp_middleware = require("@ag-ui/mcp-middleware");

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

@@ -1,11 +1,11 @@
 import "reflect-metadata";
 import { mergeForwardableHeaders, resolveForwardHeadersPolicy } from "../header-utils.mjs";
-import { isA2UIEnabled, isIntelligenceRuntime, resolveAgents } from "../../core/runtime.mjs";
+import { errorResponse } from "./json-response.mjs";
 import { INTELLIGENCE_MEMORY_GRANT_HEADER, INTELLIGENCE_USER_ID_HEADER } from "../../intelligence-platform/client.mjs";
+import { resolveIntelligenceUser } from "./resolve-intelligence-user.mjs";
+import { isA2UIEnabled, isIntelligenceRuntime, resolveAgents } from "../../core/runtime.mjs";
 import { GenerativeUIMiddleware } from "../../generative-ui/generative-ui-middleware.mjs";
 import { resolveMcpAppsServers } from "./mcp-apps-servers.mjs";
-import { errorResponse } from "./json-response.mjs";
-import { resolveIntelligenceUser } from "./resolve-intelligence-user.mjs";
 import { grantAllowsMemory, resolveWebMemory } from "./memory-policy.mjs";
 import { logger } from "@copilotkit/shared";
 import { MCPMiddleware } from "@ag-ui/mcp-middleware";

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

@@ -1,4 +1,5 @@
 require("reflect-metadata");
+const require_mcp_client_cache = require('../../../../lib/runtime/mcp-client-cache.cjs');
 
 //#region src/v2/runtime/handlers/shared/mcp-apps-servers.ts
 const UNSUPPORTED_POLICY_KEYS = ["includeTools", "excludeTools"];
@@ -11,7 +12,7 @@ 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 ?? server.url})`);
+		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_mcp_client_cache.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);

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

@@ -1 +1 @@
-{"version":3,"file":"mcp-apps-servers.cjs","names":[],"sources":["../../../../../src/v2/runtime/handlers/shared/mcp-apps-servers.ts"],"sourcesContent":["import type { MCPClientConfig } from \"@ag-ui/mcp-apps-middleware\";\nimport type { McpAppsServerConfig } from \"../../core/runtime\";\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 ?? 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":";;;AAGA,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,OAAO,IAAI,GAC9D;;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"}
+{"version":3,"file":"mcp-apps-servers.cjs","names":["describeEndpoint"],"sources":["../../../../../src/v2/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 \"../../../../v1-deprecated/lib/runtime/mcp-client-cache\";\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,0CAAiB,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/v2/runtime/handlers/shared/mcp-apps-servers.mjs

@@ -1,4 +1,6 @@
 import "reflect-metadata";
+import { describeEndpoint } from "../../../../lib/runtime/mcp-client-cache.mjs";
+
 //#region src/v2/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";
@@ -10,7 +12,7 @@ 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 ?? server.url})`);
+		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);

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

@@ -1 +1 @@
-{"version":3,"file":"mcp-apps-servers.mjs","names":[],"sources":["../../../../../src/v2/runtime/handlers/shared/mcp-apps-servers.ts"],"sourcesContent":["import type { MCPClientConfig } from \"@ag-ui/mcp-apps-middleware\";\nimport type { McpAppsServerConfig } from \"../../core/runtime\";\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 ?? 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":";;AAGA,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,OAAO,IAAI,GAC9D;;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"}
+{"version":3,"file":"mcp-apps-servers.mjs","names":[],"sources":["../../../../../src/v2/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 \"../../../../v1-deprecated/lib/runtime/mcp-client-cache\";\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/v2/runtime/handlers/shared/platform-error.cjs

@@ -1,6 +1,6 @@
 require("reflect-metadata");
-const require_client = require('../../intelligence-platform/client.cjs');
 const require_json_response = require('./json-response.cjs');
+const require_client = require('../../intelligence-platform/client.cjs');
 
 //#region src/v2/runtime/handlers/shared/platform-error.ts
 /**

package/dist/v2/runtime/handlers/shared/platform-error.mjs

@@ -1,6 +1,6 @@
 import "reflect-metadata";
-import { PlatformRequestError } from "../../intelligence-platform/client.mjs";
 import { errorResponse } from "./json-response.mjs";
+import { PlatformRequestError } from "../../intelligence-platform/client.mjs";
 
 //#region src/v2/runtime/handlers/shared/platform-error.ts
 /**

package/dist/v2/runtime/handlers/shared/resolve-intelligence-user.cjs

@@ -1,9 +1,22 @@
 require("reflect-metadata");
 const require_json_response = require('./json-response.cjs');
 const require_intelligence_utils = require('./intelligence-utils.cjs');
+const require_runtime = require('../../core/runtime.cjs');
 
 //#region src/v2/runtime/handlers/shared/resolve-intelligence-user.ts
+/** Narrows a runtime to one that has `identifyUser`. */
+function hasIdentifyUser(runtime) {
+	return typeof runtime.identifyUser === "function";
+}
 const resolvedUsers = /* @__PURE__ */ new WeakMap();
+/**
+* Resolves the request's user through `identifyUser`, once per request, for
+* both runtime kinds: the Intelligence runtime and an SSE runtime with
+* `identifyUser` (local Thread ownership). Only the Intelligence runtime
+* needs the user's `name`; an SSE runtime needs the `id` alone.
+*
+* A callback that throws gets a 500 on every route.
+*/
 async function resolveIntelligenceUser(params) {
 	const { runtime, request } = params;
 	const existing = resolvedUsers.get(request);
@@ -13,20 +26,26 @@ async function resolveIntelligenceUser(params) {
 	return resolution;
 }
 async function resolveUser(runtime, request) {
+	if (!hasIdentifyUser(runtime)) {
+		console.error("Error identifying user: identifyUser is not configured");
+		return require_json_response.errorResponse("Failed to identify user", 500);
+	}
 	try {
 		const user = await runtime.identifyUser(request);
 		if (!require_intelligence_utils.isValidIdentifier(user?.id)) return require_json_response.errorResponse("identifyUser must return a valid user id", 400);
-		if (typeof user?.name !== "string" || user.name.trim().length === 0) return require_json_response.errorResponse("identifyUser must return a valid user name", 400);
+		const hasName = typeof user?.name === "string" && user.name.trim().length > 0;
+		if (!hasName && require_runtime.isIntelligenceRuntime(runtime)) return require_json_response.errorResponse("identifyUser must return a valid user name", 400);
 		return {
 			id: user.id,
-			name: user.name
+			name: hasName ? user.name : user.id
 		};
 	} catch (error) {
-		console.error("Error identifying intelligence user:", error);
+		console.error("Error identifying user:", error);
 		return require_json_response.errorResponse("Failed to identify user", 500);
 	}
 }
 
 //#endregion
+exports.hasIdentifyUser = hasIdentifyUser;
 exports.resolveIntelligenceUser = resolveIntelligenceUser;
 //# sourceMappingURL=resolve-intelligence-user.cjs.map

package/dist/v2/runtime/handlers/shared/resolve-intelligence-user.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-intelligence-user.cjs","names":["isValidIdentifier","errorResponse"],"sources":["../../../../../src/v2/runtime/handlers/shared/resolve-intelligence-user.ts"],"sourcesContent":["import type {\n  CopilotIntelligenceRuntimeLike,\n  CopilotRuntimeUser,\n} from \"../../core/runtime\";\nimport { errorResponse } from \"./json-response\";\nimport { isValidIdentifier } from \"./intelligence-utils\";\n\nconst resolvedUsers = new WeakMap<\n  Request,\n  Promise<CopilotRuntimeUser | Response>\n>();\n\nexport async function resolveIntelligenceUser(params: {\n  runtime: CopilotIntelligenceRuntimeLike;\n  request: Request;\n}): Promise<CopilotRuntimeUser | Response> {\n  const { runtime, request } = params;\n\n  const existing = resolvedUsers.get(request);\n  if (existing) return existing;\n\n  const resolution = resolveUser(runtime, request);\n  resolvedUsers.set(request, resolution);\n  return resolution;\n}\n\nasync function resolveUser(\n  runtime: CopilotIntelligenceRuntimeLike,\n  request: Request,\n): Promise<CopilotRuntimeUser | Response> {\n  try {\n    const user = await runtime.identifyUser(request);\n    if (!isValidIdentifier(user?.id)) {\n      return errorResponse(\"identifyUser must return a valid user id\", 400);\n    }\n    if (typeof user?.name !== \"string\" || user.name.trim().length === 0) {\n      return errorResponse(\"identifyUser must return a valid user name\", 400);\n    }\n\n    return { id: user.id, name: user.name };\n  } catch (error) {\n    console.error(\"Error identifying intelligence user:\", error);\n    return errorResponse(\"Failed to identify user\", 500);\n  }\n}\n"],"mappings":";;;;;AAOA,MAAM,gCAAgB,IAAI,SAGvB;AAEH,eAAsB,wBAAwB,QAGH;CACzC,MAAM,EAAE,SAAS,YAAY;CAE7B,MAAM,WAAW,cAAc,IAAI,QAAQ;AAC3C,KAAI,SAAU,QAAO;CAErB,MAAM,aAAa,YAAY,SAAS,QAAQ;AAChD,eAAc,IAAI,SAAS,WAAW;AACtC,QAAO;;AAGT,eAAe,YACb,SACA,SACwC;AACxC,KAAI;EACF,MAAM,OAAO,MAAM,QAAQ,aAAa,QAAQ;AAChD,MAAI,CAACA,6CAAkB,MAAM,GAAG,CAC9B,QAAOC,oCAAc,4CAA4C,IAAI;AAEvE,MAAI,OAAO,MAAM,SAAS,YAAY,KAAK,KAAK,MAAM,CAAC,WAAW,EAChE,QAAOA,oCAAc,8CAA8C,IAAI;AAGzE,SAAO;GAAE,IAAI,KAAK;GAAI,MAAM,KAAK;GAAM;UAChC,OAAO;AACd,UAAQ,MAAM,wCAAwC,MAAM;AAC5D,SAAOA,oCAAc,2BAA2B,IAAI"}
+{"version":3,"file":"resolve-intelligence-user.cjs","names":["errorResponse","isValidIdentifier","isIntelligenceRuntime"],"sources":["../../../../../src/v2/runtime/handlers/shared/resolve-intelligence-user.ts"],"sourcesContent":["import type {\n  CopilotIntelligenceRuntimeLike,\n  CopilotRuntimeLike,\n  CopilotRuntimeUser,\n  IdentifyUserCallback,\n} from \"../../core/runtime\";\nimport { isIntelligenceRuntime } from \"../../core/runtime\";\nimport { errorResponse } from \"./json-response\";\nimport { isValidIdentifier } from \"./intelligence-utils\";\n\n/** A runtime whose `identifyUser` is known to be set. */\nexport type IdentifiedRuntimeLike = CopilotRuntimeLike & {\n  identifyUser: IdentifyUserCallback;\n};\n\n/** Narrows a runtime to one that has `identifyUser`. */\nexport function hasIdentifyUser(\n  runtime: CopilotRuntimeLike,\n): runtime is IdentifiedRuntimeLike {\n  return typeof runtime.identifyUser === \"function\";\n}\n\nconst resolvedUsers = new WeakMap<\n  Request,\n  Promise<CopilotRuntimeUser | Response>\n>();\n\n/**\n * Resolves the request's user through `identifyUser`, once per request, for\n * both runtime kinds: the Intelligence runtime and an SSE runtime with\n * `identifyUser` (local Thread ownership). Only the Intelligence runtime\n * needs the user's `name`; an SSE runtime needs the `id` alone.\n *\n * A callback that throws gets a 500 on every route.\n */\nexport async function resolveIntelligenceUser(params: {\n  runtime: CopilotIntelligenceRuntimeLike | IdentifiedRuntimeLike;\n  request: Request;\n}): Promise<CopilotRuntimeUser | Response> {\n  const { runtime, request } = params;\n\n  const existing = resolvedUsers.get(request);\n  if (existing) return existing;\n\n  const resolution = resolveUser(runtime, request);\n  resolvedUsers.set(request, resolution);\n  return resolution;\n}\n\nasync function resolveUser(\n  runtime: CopilotRuntimeLike,\n  request: Request,\n): Promise<CopilotRuntimeUser | Response> {\n  if (!hasIdentifyUser(runtime)) {\n    console.error(\"Error identifying user: identifyUser is not configured\");\n    return errorResponse(\"Failed to identify user\", 500);\n  }\n  try {\n    const user = await runtime.identifyUser(request);\n    if (!isValidIdentifier(user?.id)) {\n      return errorResponse(\"identifyUser must return a valid user id\", 400);\n    }\n    const hasName =\n      typeof user?.name === \"string\" && user.name.trim().length > 0;\n    if (!hasName && isIntelligenceRuntime(runtime)) {\n      return errorResponse(\"identifyUser must return a valid user name\", 400);\n    }\n\n    return { id: user.id, name: hasName ? user.name : user.id };\n  } catch (error) {\n    console.error(\"Error identifying user:\", error);\n    return errorResponse(\"Failed to identify user\", 500);\n  }\n}\n"],"mappings":";;;;;;;AAgBA,SAAgB,gBACd,SACkC;AAClC,QAAO,OAAO,QAAQ,iBAAiB;;AAGzC,MAAM,gCAAgB,IAAI,SAGvB;;;;;;;;;AAUH,eAAsB,wBAAwB,QAGH;CACzC,MAAM,EAAE,SAAS,YAAY;CAE7B,MAAM,WAAW,cAAc,IAAI,QAAQ;AAC3C,KAAI,SAAU,QAAO;CAErB,MAAM,aAAa,YAAY,SAAS,QAAQ;AAChD,eAAc,IAAI,SAAS,WAAW;AACtC,QAAO;;AAGT,eAAe,YACb,SACA,SACwC;AACxC,KAAI,CAAC,gBAAgB,QAAQ,EAAE;AAC7B,UAAQ,MAAM,yDAAyD;AACvE,SAAOA,oCAAc,2BAA2B,IAAI;;AAEtD,KAAI;EACF,MAAM,OAAO,MAAM,QAAQ,aAAa,QAAQ;AAChD,MAAI,CAACC,6CAAkB,MAAM,GAAG,CAC9B,QAAOD,oCAAc,4CAA4C,IAAI;EAEvE,MAAM,UACJ,OAAO,MAAM,SAAS,YAAY,KAAK,KAAK,MAAM,CAAC,SAAS;AAC9D,MAAI,CAAC,WAAWE,sCAAsB,QAAQ,CAC5C,QAAOF,oCAAc,8CAA8C,IAAI;AAGzE,SAAO;GAAE,IAAI,KAAK;GAAI,MAAM,UAAU,KAAK,OAAO,KAAK;GAAI;UACpD,OAAO;AACd,UAAQ,MAAM,2BAA2B,MAAM;AAC/C,SAAOA,oCAAc,2BAA2B,IAAI"}

package/dist/v2/runtime/handlers/shared/resolve-intelligence-user.mjs

@@ -1,9 +1,22 @@
 import "reflect-metadata";
 import { errorResponse } from "./json-response.mjs";
 import { isValidIdentifier } from "./intelligence-utils.mjs";
+import { isIntelligenceRuntime } from "../../core/runtime.mjs";
 
 //#region src/v2/runtime/handlers/shared/resolve-intelligence-user.ts
+/** Narrows a runtime to one that has `identifyUser`. */
+function hasIdentifyUser(runtime) {
+	return typeof runtime.identifyUser === "function";
+}
 const resolvedUsers = /* @__PURE__ */ new WeakMap();
+/**
+* Resolves the request's user through `identifyUser`, once per request, for
+* both runtime kinds: the Intelligence runtime and an SSE runtime with
+* `identifyUser` (local Thread ownership). Only the Intelligence runtime
+* needs the user's `name`; an SSE runtime needs the `id` alone.
+*
+* A callback that throws gets a 500 on every route.
+*/
 async function resolveIntelligenceUser(params) {
 	const { runtime, request } = params;
 	const existing = resolvedUsers.get(request);
@@ -13,20 +26,25 @@ async function resolveIntelligenceUser(params) {
 	return resolution;
 }
 async function resolveUser(runtime, request) {
+	if (!hasIdentifyUser(runtime)) {
+		console.error("Error identifying user: identifyUser is not configured");
+		return errorResponse("Failed to identify user", 500);
+	}
 	try {
 		const user = await runtime.identifyUser(request);
 		if (!isValidIdentifier(user?.id)) return errorResponse("identifyUser must return a valid user id", 400);
-		if (typeof user?.name !== "string" || user.name.trim().length === 0) return errorResponse("identifyUser must return a valid user name", 400);
+		const hasName = typeof user?.name === "string" && user.name.trim().length > 0;
+		if (!hasName && isIntelligenceRuntime(runtime)) return errorResponse("identifyUser must return a valid user name", 400);
 		return {
 			id: user.id,
-			name: user.name
+			name: hasName ? user.name : user.id
 		};
 	} catch (error) {
-		console.error("Error identifying intelligence user:", error);
+		console.error("Error identifying user:", error);
 		return errorResponse("Failed to identify user", 500);
 	}
 }
 
 //#endregion
-export { resolveIntelligenceUser };
+export { hasIdentifyUser, resolveIntelligenceUser };
 //# sourceMappingURL=resolve-intelligence-user.mjs.map

package/dist/v2/runtime/handlers/shared/resolve-intelligence-user.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-intelligence-user.mjs","names":[],"sources":["../../../../../src/v2/runtime/handlers/shared/resolve-intelligence-user.ts"],"sourcesContent":["import type {\n  CopilotIntelligenceRuntimeLike,\n  CopilotRuntimeUser,\n} from \"../../core/runtime\";\nimport { errorResponse } from \"./json-response\";\nimport { isValidIdentifier } from \"./intelligence-utils\";\n\nconst resolvedUsers = new WeakMap<\n  Request,\n  Promise<CopilotRuntimeUser | Response>\n>();\n\nexport async function resolveIntelligenceUser(params: {\n  runtime: CopilotIntelligenceRuntimeLike;\n  request: Request;\n}): Promise<CopilotRuntimeUser | Response> {\n  const { runtime, request } = params;\n\n  const existing = resolvedUsers.get(request);\n  if (existing) return existing;\n\n  const resolution = resolveUser(runtime, request);\n  resolvedUsers.set(request, resolution);\n  return resolution;\n}\n\nasync function resolveUser(\n  runtime: CopilotIntelligenceRuntimeLike,\n  request: Request,\n): Promise<CopilotRuntimeUser | Response> {\n  try {\n    const user = await runtime.identifyUser(request);\n    if (!isValidIdentifier(user?.id)) {\n      return errorResponse(\"identifyUser must return a valid user id\", 400);\n    }\n    if (typeof user?.name !== \"string\" || user.name.trim().length === 0) {\n      return errorResponse(\"identifyUser must return a valid user name\", 400);\n    }\n\n    return { id: user.id, name: user.name };\n  } catch (error) {\n    console.error(\"Error identifying intelligence user:\", error);\n    return errorResponse(\"Failed to identify user\", 500);\n  }\n}\n"],"mappings":";;;;;AAOA,MAAM,gCAAgB,IAAI,SAGvB;AAEH,eAAsB,wBAAwB,QAGH;CACzC,MAAM,EAAE,SAAS,YAAY;CAE7B,MAAM,WAAW,cAAc,IAAI,QAAQ;AAC3C,KAAI,SAAU,QAAO;CAErB,MAAM,aAAa,YAAY,SAAS,QAAQ;AAChD,eAAc,IAAI,SAAS,WAAW;AACtC,QAAO;;AAGT,eAAe,YACb,SACA,SACwC;AACxC,KAAI;EACF,MAAM,OAAO,MAAM,QAAQ,aAAa,QAAQ;AAChD,MAAI,CAAC,kBAAkB,MAAM,GAAG,CAC9B,QAAO,cAAc,4CAA4C,IAAI;AAEvE,MAAI,OAAO,MAAM,SAAS,YAAY,KAAK,KAAK,MAAM,CAAC,WAAW,EAChE,QAAO,cAAc,8CAA8C,IAAI;AAGzE,SAAO;GAAE,IAAI,KAAK;GAAI,MAAM,KAAK;GAAM;UAChC,OAAO;AACd,UAAQ,MAAM,wCAAwC,MAAM;AAC5D,SAAO,cAAc,2BAA2B,IAAI"}
+{"version":3,"file":"resolve-intelligence-user.mjs","names":[],"sources":["../../../../../src/v2/runtime/handlers/shared/resolve-intelligence-user.ts"],"sourcesContent":["import type {\n  CopilotIntelligenceRuntimeLike,\n  CopilotRuntimeLike,\n  CopilotRuntimeUser,\n  IdentifyUserCallback,\n} from \"../../core/runtime\";\nimport { isIntelligenceRuntime } from \"../../core/runtime\";\nimport { errorResponse } from \"./json-response\";\nimport { isValidIdentifier } from \"./intelligence-utils\";\n\n/** A runtime whose `identifyUser` is known to be set. */\nexport type IdentifiedRuntimeLike = CopilotRuntimeLike & {\n  identifyUser: IdentifyUserCallback;\n};\n\n/** Narrows a runtime to one that has `identifyUser`. */\nexport function hasIdentifyUser(\n  runtime: CopilotRuntimeLike,\n): runtime is IdentifiedRuntimeLike {\n  return typeof runtime.identifyUser === \"function\";\n}\n\nconst resolvedUsers = new WeakMap<\n  Request,\n  Promise<CopilotRuntimeUser | Response>\n>();\n\n/**\n * Resolves the request's user through `identifyUser`, once per request, for\n * both runtime kinds: the Intelligence runtime and an SSE runtime with\n * `identifyUser` (local Thread ownership). Only the Intelligence runtime\n * needs the user's `name`; an SSE runtime needs the `id` alone.\n *\n * A callback that throws gets a 500 on every route.\n */\nexport async function resolveIntelligenceUser(params: {\n  runtime: CopilotIntelligenceRuntimeLike | IdentifiedRuntimeLike;\n  request: Request;\n}): Promise<CopilotRuntimeUser | Response> {\n  const { runtime, request } = params;\n\n  const existing = resolvedUsers.get(request);\n  if (existing) return existing;\n\n  const resolution = resolveUser(runtime, request);\n  resolvedUsers.set(request, resolution);\n  return resolution;\n}\n\nasync function resolveUser(\n  runtime: CopilotRuntimeLike,\n  request: Request,\n): Promise<CopilotRuntimeUser | Response> {\n  if (!hasIdentifyUser(runtime)) {\n    console.error(\"Error identifying user: identifyUser is not configured\");\n    return errorResponse(\"Failed to identify user\", 500);\n  }\n  try {\n    const user = await runtime.identifyUser(request);\n    if (!isValidIdentifier(user?.id)) {\n      return errorResponse(\"identifyUser must return a valid user id\", 400);\n    }\n    const hasName =\n      typeof user?.name === \"string\" && user.name.trim().length > 0;\n    if (!hasName && isIntelligenceRuntime(runtime)) {\n      return errorResponse(\"identifyUser must return a valid user name\", 400);\n    }\n\n    return { id: user.id, name: hasName ? user.name : user.id };\n  } catch (error) {\n    console.error(\"Error identifying user:\", error);\n    return errorResponse(\"Failed to identify user\", 500);\n  }\n}\n"],"mappings":";;;;;;;AAgBA,SAAgB,gBACd,SACkC;AAClC,QAAO,OAAO,QAAQ,iBAAiB;;AAGzC,MAAM,gCAAgB,IAAI,SAGvB;;;;;;;;;AAUH,eAAsB,wBAAwB,QAGH;CACzC,MAAM,EAAE,SAAS,YAAY;CAE7B,MAAM,WAAW,cAAc,IAAI,QAAQ;AAC3C,KAAI,SAAU,QAAO;CAErB,MAAM,aAAa,YAAY,SAAS,QAAQ;AAChD,eAAc,IAAI,SAAS,WAAW;AACtC,QAAO;;AAGT,eAAe,YACb,SACA,SACwC;AACxC,KAAI,CAAC,gBAAgB,QAAQ,EAAE;AAC7B,UAAQ,MAAM,yDAAyD;AACvE,SAAO,cAAc,2BAA2B,IAAI;;AAEtD,KAAI;EACF,MAAM,OAAO,MAAM,QAAQ,aAAa,QAAQ;AAChD,MAAI,CAAC,kBAAkB,MAAM,GAAG,CAC9B,QAAO,cAAc,4CAA4C,IAAI;EAEvE,MAAM,UACJ,OAAO,MAAM,SAAS,YAAY,KAAK,KAAK,MAAM,CAAC,SAAS;AAC9D,MAAI,CAAC,WAAW,sBAAsB,QAAQ,CAC5C,QAAO,cAAc,8CAA8C,IAAI;AAGzE,SAAO;GAAE,IAAI,KAAK;GAAI,MAAM,UAAU,KAAK,OAAO,KAAK;GAAI;UACpD,OAAO;AACd,UAAQ,MAAM,2BAA2B,MAAM;AAC/C,SAAO,cAAc,2BAA2B,IAAI"}