@copilotkit/runtime 1.55.2-next.1 → 1.55.3

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

@@ -0,0 +1,179 @@
+require("reflect-metadata");
+const require_runtime = require('../../../../_virtual/_rolldown/runtime.cjs');
+const require_runtime$1 = require('../../core/runtime.cjs');
+const require_json_response = require('../shared/json-response.cjs');
+const require_intelligence_utils = require('../shared/intelligence-utils.cjs');
+const require_resolve_intelligence_user = require('../shared/resolve-intelligence-user.cjs');
+let _copilotkit_shared = require("@copilotkit/shared");
+
+//#region src/v2/runtime/handlers/intelligence/threads.ts
+async function parseJsonBody(request) {
+	try {
+		return await request.json();
+	} catch (error) {
+		_copilotkit_shared.logger.error({ err: error }, "Malformed JSON in request body");
+		return require_json_response.errorResponse("Invalid request body", 400);
+	}
+}
+function requireIntelligenceRuntime(runtime) {
+	if (!require_runtime$1.isIntelligenceRuntime(runtime)) return require_json_response.errorResponse("Missing CopilotKitIntelligence configuration. Thread operations require a CopilotKitIntelligence instance to be provided in CopilotRuntime options.", 422);
+	return runtime;
+}
+async function resolveThreadMutationContext(runtime, request) {
+	const body = await parseJsonBody(request);
+	if (require_json_response.isHandlerResponse(body)) return body;
+	const user = await require_resolve_intelligence_user.resolveIntelligenceUser({
+		runtime,
+		request
+	});
+	if (require_json_response.isHandlerResponse(user)) return user;
+	const agentId = body.agentId;
+	if (!require_intelligence_utils.isValidIdentifier(agentId)) return require_json_response.errorResponse("Valid agentId is required", 400);
+	return {
+		body,
+		userId: user.id,
+		agentId
+	};
+}
+async function handleListThreads({ runtime, request }) {
+	const intelligenceRuntime = requireIntelligenceRuntime(runtime);
+	if (require_json_response.isHandlerResponse(intelligenceRuntime)) return intelligenceRuntime;
+	try {
+		const url = new URL(request.url);
+		const agentId = url.searchParams.get("agentId");
+		const includeArchived = url.searchParams.get("includeArchived") === "true";
+		const limitParam = url.searchParams.get("limit");
+		const cursor = url.searchParams.get("cursor");
+		const user = await require_resolve_intelligence_user.resolveIntelligenceUser({
+			runtime: intelligenceRuntime,
+			request
+		});
+		if (require_json_response.isHandlerResponse(user)) return user;
+		if (!require_intelligence_utils.isValidIdentifier(agentId)) return require_json_response.errorResponse("Valid agentId query param is required", 400);
+		const data = await intelligenceRuntime.intelligence.listThreads({
+			userId: user.id,
+			agentId,
+			...includeArchived ? { includeArchived: true } : {},
+			...limitParam ? { limit: Number(limitParam) } : {},
+			...cursor ? { cursor } : {}
+		});
+		return Response.json(data);
+	} catch (error) {
+		_copilotkit_shared.logger.error({ err: error }, "Error listing threads");
+		return require_json_response.errorResponse("Failed to list threads", 500);
+	}
+}
+async function handleUpdateThread({ runtime, request, threadId }) {
+	const intelligenceRuntime = requireIntelligenceRuntime(runtime);
+	if (require_json_response.isHandlerResponse(intelligenceRuntime)) return intelligenceRuntime;
+	try {
+		const mutation = await resolveThreadMutationContext(intelligenceRuntime, request);
+		if (require_json_response.isHandlerResponse(mutation)) return mutation;
+		const updates = { ...mutation.body };
+		delete updates.agentId;
+		delete updates.userId;
+		const thread = await intelligenceRuntime.intelligence.updateThread({
+			threadId,
+			userId: mutation.userId,
+			agentId: mutation.agentId,
+			updates
+		});
+		return Response.json(thread);
+	} catch (error) {
+		_copilotkit_shared.logger.error({
+			err: error,
+			threadId
+		}, "Error updating thread");
+		return require_json_response.errorResponse("Failed to update thread", 500);
+	}
+}
+async function handleSubscribeToThreads({ runtime, request }) {
+	const intelligenceRuntime = requireIntelligenceRuntime(runtime);
+	if (require_json_response.isHandlerResponse(intelligenceRuntime)) return intelligenceRuntime;
+	try {
+		const user = await require_resolve_intelligence_user.resolveIntelligenceUser({
+			runtime: intelligenceRuntime,
+			request
+		});
+		if (require_json_response.isHandlerResponse(user)) return user;
+		const credentials = await intelligenceRuntime.intelligence.ɵsubscribeToThreads({ userId: user.id });
+		return Response.json({ joinToken: credentials.joinToken });
+	} catch (error) {
+		_copilotkit_shared.logger.error({ err: error }, "Error subscribing to threads");
+		return require_json_response.errorResponse("Failed to subscribe to threads", 500);
+	}
+}
+async function handleArchiveThread({ runtime, request, threadId }) {
+	const intelligenceRuntime = requireIntelligenceRuntime(runtime);
+	if (require_json_response.isHandlerResponse(intelligenceRuntime)) return intelligenceRuntime;
+	try {
+		const mutation = await resolveThreadMutationContext(intelligenceRuntime, request);
+		if (require_json_response.isHandlerResponse(mutation)) return mutation;
+		await intelligenceRuntime.intelligence.archiveThread({
+			threadId,
+			userId: mutation.userId,
+			agentId: mutation.agentId
+		});
+		return Response.json({
+			threadId,
+			archived: true
+		});
+	} catch (error) {
+		_copilotkit_shared.logger.error({
+			err: error,
+			threadId
+		}, "Error archiving thread");
+		return require_json_response.errorResponse("Failed to archive thread", 500);
+	}
+}
+async function handleDeleteThread({ runtime, request, threadId }) {
+	const intelligenceRuntime = requireIntelligenceRuntime(runtime);
+	if (require_json_response.isHandlerResponse(intelligenceRuntime)) return intelligenceRuntime;
+	try {
+		const mutation = await resolveThreadMutationContext(intelligenceRuntime, request);
+		if (require_json_response.isHandlerResponse(mutation)) return mutation;
+		await intelligenceRuntime.intelligence.deleteThread({
+			threadId,
+			userId: mutation.userId,
+			agentId: mutation.agentId
+		});
+		return Response.json({
+			threadId,
+			deleted: true
+		});
+	} catch (error) {
+		_copilotkit_shared.logger.error({
+			err: error,
+			threadId
+		}, "Error deleting thread");
+		return require_json_response.errorResponse("Failed to delete thread", 500);
+	}
+}
+async function handleGetThreadMessages({ runtime, request, threadId }) {
+	const intelligenceRuntime = requireIntelligenceRuntime(runtime);
+	if (require_json_response.isHandlerResponse(intelligenceRuntime)) return intelligenceRuntime;
+	try {
+		const user = await require_resolve_intelligence_user.resolveIntelligenceUser({
+			runtime: intelligenceRuntime,
+			request
+		});
+		if (require_json_response.isHandlerResponse(user)) return user;
+		const data = await intelligenceRuntime.intelligence.getThreadMessages({ threadId });
+		return Response.json(data);
+	} catch (error) {
+		_copilotkit_shared.logger.error({
+			err: error,
+			threadId
+		}, "Error getting thread messages");
+		return require_json_response.errorResponse("Failed to get thread messages", 500);
+	}
+}
+
+//#endregion
+exports.handleArchiveThread = handleArchiveThread;
+exports.handleDeleteThread = handleDeleteThread;
+exports.handleGetThreadMessages = handleGetThreadMessages;
+exports.handleListThreads = handleListThreads;
+exports.handleSubscribeToThreads = handleSubscribeToThreads;
+exports.handleUpdateThread = handleUpdateThread;
+//# sourceMappingURL=threads.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"threads.cjs","names":["errorResponse","isIntelligenceRuntime","isHandlerResponse","resolveIntelligenceUser","isValidIdentifier"],"sources":["../../../../../src/v2/runtime/handlers/intelligence/threads.ts"],"sourcesContent":["import {\n  CopilotIntelligenceRuntimeLike,\n  CopilotRuntimeLike,\n  isIntelligenceRuntime,\n} 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\";\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  const intelligenceRuntime = requireIntelligenceRuntime(runtime);\n  if (isHandlerResponse(intelligenceRuntime)) {\n    return intelligenceRuntime;\n  }\n\n  try {\n    const url = new URL(request.url);\n    const agentId = url.searchParams.get(\"agentId\");\n    const includeArchived = url.searchParams.get(\"includeArchived\") === \"true\";\n    const limitParam = url.searchParams.get(\"limit\");\n    const cursor = url.searchParams.get(\"cursor\");\n    const user = await resolveIntelligenceUser({\n      runtime: intelligenceRuntime,\n      request,\n    });\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 intelligenceRuntime.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\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    const updates = { ...mutation.body };\n    delete updates.agentId;\n    delete updates.userId;\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  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 data = await intelligenceRuntime.intelligence.getThreadMessages({\n      threadId,\n    });\n\n    return Response.json(data);\n  } catch (error) {\n    logger.error({ err: error, threadId }, \"Error getting thread messages\");\n    return errorResponse(\"Failed to get thread messages\", 500);\n  }\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,173 @@
+import "reflect-metadata";
+import { isIntelligenceRuntime } from "../../core/runtime.mjs";
+import { errorResponse, isHandlerResponse } from "../shared/json-response.mjs";
+import { isValidIdentifier } from "../shared/intelligence-utils.mjs";
+import { resolveIntelligenceUser } from "../shared/resolve-intelligence-user.mjs";
+import { logger } from "@copilotkit/shared";
+
+//#region src/v2/runtime/handlers/intelligence/threads.ts
+async function parseJsonBody(request) {
+	try {
+		return await request.json();
+	} catch (error) {
+		logger.error({ err: error }, "Malformed JSON in request body");
+		return errorResponse("Invalid request body", 400);
+	}
+}
+function requireIntelligenceRuntime(runtime) {
+	if (!isIntelligenceRuntime(runtime)) return errorResponse("Missing CopilotKitIntelligence configuration. Thread operations require a CopilotKitIntelligence instance to be provided in CopilotRuntime options.", 422);
+	return runtime;
+}
+async function resolveThreadMutationContext(runtime, request) {
+	const body = await parseJsonBody(request);
+	if (isHandlerResponse(body)) return body;
+	const user = await resolveIntelligenceUser({
+		runtime,
+		request
+	});
+	if (isHandlerResponse(user)) return user;
+	const agentId = body.agentId;
+	if (!isValidIdentifier(agentId)) return errorResponse("Valid agentId is required", 400);
+	return {
+		body,
+		userId: user.id,
+		agentId
+	};
+}
+async function handleListThreads({ runtime, request }) {
+	const intelligenceRuntime = requireIntelligenceRuntime(runtime);
+	if (isHandlerResponse(intelligenceRuntime)) return intelligenceRuntime;
+	try {
+		const url = new URL(request.url);
+		const agentId = url.searchParams.get("agentId");
+		const includeArchived = url.searchParams.get("includeArchived") === "true";
+		const limitParam = url.searchParams.get("limit");
+		const cursor = url.searchParams.get("cursor");
+		const user = await resolveIntelligenceUser({
+			runtime: intelligenceRuntime,
+			request
+		});
+		if (isHandlerResponse(user)) return user;
+		if (!isValidIdentifier(agentId)) return errorResponse("Valid agentId query param is required", 400);
+		const data = await intelligenceRuntime.intelligence.listThreads({
+			userId: user.id,
+			agentId,
+			...includeArchived ? { includeArchived: true } : {},
+			...limitParam ? { limit: Number(limitParam) } : {},
+			...cursor ? { cursor } : {}
+		});
+		return Response.json(data);
+	} catch (error) {
+		logger.error({ err: error }, "Error listing threads");
+		return errorResponse("Failed to list threads", 500);
+	}
+}
+async function handleUpdateThread({ runtime, request, threadId }) {
+	const intelligenceRuntime = requireIntelligenceRuntime(runtime);
+	if (isHandlerResponse(intelligenceRuntime)) return intelligenceRuntime;
+	try {
+		const mutation = await resolveThreadMutationContext(intelligenceRuntime, request);
+		if (isHandlerResponse(mutation)) return mutation;
+		const updates = { ...mutation.body };
+		delete updates.agentId;
+		delete updates.userId;
+		const thread = await intelligenceRuntime.intelligence.updateThread({
+			threadId,
+			userId: mutation.userId,
+			agentId: mutation.agentId,
+			updates
+		});
+		return Response.json(thread);
+	} catch (error) {
+		logger.error({
+			err: error,
+			threadId
+		}, "Error updating thread");
+		return errorResponse("Failed to update thread", 500);
+	}
+}
+async function handleSubscribeToThreads({ runtime, request }) {
+	const intelligenceRuntime = requireIntelligenceRuntime(runtime);
+	if (isHandlerResponse(intelligenceRuntime)) return intelligenceRuntime;
+	try {
+		const user = await resolveIntelligenceUser({
+			runtime: intelligenceRuntime,
+			request
+		});
+		if (isHandlerResponse(user)) return user;
+		const credentials = await intelligenceRuntime.intelligence.ɵsubscribeToThreads({ userId: user.id });
+		return Response.json({ joinToken: credentials.joinToken });
+	} catch (error) {
+		logger.error({ err: error }, "Error subscribing to threads");
+		return errorResponse("Failed to subscribe to threads", 500);
+	}
+}
+async function handleArchiveThread({ runtime, request, threadId }) {
+	const intelligenceRuntime = requireIntelligenceRuntime(runtime);
+	if (isHandlerResponse(intelligenceRuntime)) return intelligenceRuntime;
+	try {
+		const mutation = await resolveThreadMutationContext(intelligenceRuntime, request);
+		if (isHandlerResponse(mutation)) return mutation;
+		await intelligenceRuntime.intelligence.archiveThread({
+			threadId,
+			userId: mutation.userId,
+			agentId: mutation.agentId
+		});
+		return Response.json({
+			threadId,
+			archived: true
+		});
+	} catch (error) {
+		logger.error({
+			err: error,
+			threadId
+		}, "Error archiving thread");
+		return errorResponse("Failed to archive thread", 500);
+	}
+}
+async function handleDeleteThread({ runtime, request, threadId }) {
+	const intelligenceRuntime = requireIntelligenceRuntime(runtime);
+	if (isHandlerResponse(intelligenceRuntime)) return intelligenceRuntime;
+	try {
+		const mutation = await resolveThreadMutationContext(intelligenceRuntime, request);
+		if (isHandlerResponse(mutation)) return mutation;
+		await intelligenceRuntime.intelligence.deleteThread({
+			threadId,
+			userId: mutation.userId,
+			agentId: mutation.agentId
+		});
+		return Response.json({
+			threadId,
+			deleted: true
+		});
+	} catch (error) {
+		logger.error({
+			err: error,
+			threadId
+		}, "Error deleting thread");
+		return errorResponse("Failed to delete thread", 500);
+	}
+}
+async function handleGetThreadMessages({ runtime, request, threadId }) {
+	const intelligenceRuntime = requireIntelligenceRuntime(runtime);
+	if (isHandlerResponse(intelligenceRuntime)) return intelligenceRuntime;
+	try {
+		const user = await resolveIntelligenceUser({
+			runtime: intelligenceRuntime,
+			request
+		});
+		if (isHandlerResponse(user)) return user;
+		const data = await intelligenceRuntime.intelligence.getThreadMessages({ threadId });
+		return Response.json(data);
+	} catch (error) {
+		logger.error({
+			err: error,
+			threadId
+		}, "Error getting thread messages");
+		return errorResponse("Failed to get thread messages", 500);
+	}
+}
+
+//#endregion
+export { handleArchiveThread, handleDeleteThread, handleGetThreadMessages, handleListThreads, handleSubscribeToThreads, handleUpdateThread };
+//# sourceMappingURL=threads.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"threads.mjs","names":[],"sources":["../../../../../src/v2/runtime/handlers/intelligence/threads.ts"],"sourcesContent":["import {\n  CopilotIntelligenceRuntimeLike,\n  CopilotRuntimeLike,\n  isIntelligenceRuntime,\n} 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\";\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  const intelligenceRuntime = requireIntelligenceRuntime(runtime);\n  if (isHandlerResponse(intelligenceRuntime)) {\n    return intelligenceRuntime;\n  }\n\n  try {\n    const url = new URL(request.url);\n    const agentId = url.searchParams.get(\"agentId\");\n    const includeArchived = url.searchParams.get(\"includeArchived\") === \"true\";\n    const limitParam = url.searchParams.get(\"limit\");\n    const cursor = url.searchParams.get(\"cursor\");\n    const user = await resolveIntelligenceUser({\n      runtime: intelligenceRuntime,\n      request,\n    });\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 intelligenceRuntime.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\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    const updates = { ...mutation.body };\n    delete updates.agentId;\n    delete updates.userId;\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  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 data = await intelligenceRuntime.intelligence.getThreadMessages({\n      threadId,\n    });\n\n    return Response.json(data);\n  } catch (error) {\n    logger.error({ err: error, threadId }, \"Error getting thread messages\");\n    return errorResponse(\"Failed to get thread messages\", 500);\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@copilotkit/runtime",
-  "version": "1.55.2-next.1",
+  "version": "1.55.3",
   "private": false,
   "keywords": [
     "ai",
@@ -115,7 +115,7 @@
     "uuid": "^10.0.0",
     "ws": "^8.18.0",
     "zod": "^3.23.3",
-    "@copilotkit/shared": "1.55.2-next.1"
+    "@copilotkit/shared": "1.55.3"
   },
   "devDependencies": {
     "@copilotkit/aimock": "^1.10.0",

package/src/v2/runtime/__tests__/fetch-router.test.ts

@@ -50,6 +50,57 @@ describe("fetch-router", () => {
       expect(result).toBeNull();
     });
 
+    it("matches GET /threads", () => {
+      const result = matchRoute("/api/copilotkit/threads", basePath);
+      expect(result).toEqual({ method: "threads/list" });
+    });
+
+    it("matches POST /threads/subscribe", () => {
+      const result = matchRoute("/api/copilotkit/threads/subscribe", basePath);
+      expect(result).toEqual({ method: "threads/subscribe" });
+    });
+
+    it("matches PATCH /threads/:threadId", () => {
+      const result = matchRoute("/api/copilotkit/threads/thread-abc", basePath);
+      expect(result).toEqual({
+        method: "threads/update",
+        threadId: "thread-abc",
+      });
+    });
+
+    it("matches POST /threads/:threadId/archive", () => {
+      const result = matchRoute(
+        "/api/copilotkit/threads/thread-abc/archive",
+        basePath,
+      );
+      expect(result).toEqual({
+        method: "threads/archive",
+        threadId: "thread-abc",
+      });
+    });
+
+    it("matches GET /threads/:threadId/messages", () => {
+      const result = matchRoute(
+        "/api/copilotkit/threads/thread-abc/messages",
+        basePath,
+      );
+      expect(result).toEqual({
+        method: "threads/messages",
+        threadId: "thread-abc",
+      });
+    });
+
+    it("handles URL-encoded threadId in thread routes", () => {
+      const result = matchRoute(
+        "/api/copilotkit/threads/thread%2F123",
+        basePath,
+      );
+      expect(result).toEqual({
+        method: "threads/update",
+        threadId: "thread/123",
+      });
+    });
+
     it("returns null when basePath is a prefix but not a segment boundary", () => {
       const result = matchRoute("/api/copilotkitextra/info", basePath);
       expect(result).toBeNull();
@@ -124,6 +175,31 @@ describe("fetch-router", () => {
       expect(result).toBeNull();
     });
 
+    it("matches /threads suffix", () => {
+      const result = matchRoute("/anything/threads");
+      expect(result).toEqual({ method: "threads/list" });
+    });
+
+    it("matches /threads/subscribe suffix", () => {
+      const result = matchRoute("/anything/threads/subscribe");
+      expect(result).toEqual({ method: "threads/subscribe" });
+    });
+
+    it("matches /threads/:threadId suffix", () => {
+      const result = matchRoute("/anything/threads/t1");
+      expect(result).toEqual({ method: "threads/update", threadId: "t1" });
+    });
+
+    it("matches /threads/:threadId/archive suffix", () => {
+      const result = matchRoute("/anything/threads/t1/archive");
+      expect(result).toEqual({ method: "threads/archive", threadId: "t1" });
+    });
+
+    it("matches /threads/:threadId/messages suffix", () => {
+      const result = matchRoute("/anything/threads/t1/messages");
+      expect(result).toEqual({ method: "threads/messages", threadId: "t1" });
+    });
+
     it("works with deeply nested mount prefix", () => {
       const result = matchRoute("/api/v2/copilotkit/agent/a1/run");
       expect(result).toEqual({ method: "agent/run", agentId: "a1" });

package/src/v2/runtime/core/fetch-handler.ts

@@ -46,6 +46,14 @@ import { handleConnectAgent } from "../handlers/handle-connect";
 import { handleStopAgent } from "../handlers/handle-stop";
 import { handleGetRuntimeInfo } from "../handlers/get-runtime-info";
 import { handleTranscribe } from "../handlers/handle-transcribe";
+import {
+  handleListThreads,
+  handleSubscribeToThreads,
+  handleUpdateThread,
+  handleArchiveThread,
+  handleDeleteThread,
+  handleGetThreadMessages,
+} from "../handlers/handle-threads";
 import {
   parseMethodCall,
   createJsonRequest,
@@ -306,6 +314,31 @@ function dispatchRoute(
       return handleGetRuntimeInfo({ runtime, request });
     case "transcribe":
       return handleTranscribe({ runtime, request });
+    case "threads/list":
+      return handleListThreads({ runtime, request });
+    case "threads/subscribe":
+      return handleSubscribeToThreads({ runtime, request });
+    case "threads/update":
+      if (request.method.toUpperCase() === "DELETE") {
+        return handleDeleteThread({
+          runtime,
+          request,
+          threadId: route.threadId,
+        });
+      }
+      return handleUpdateThread({ runtime, request, threadId: route.threadId });
+    case "threads/archive":
+      return handleArchiveThread({
+        runtime,
+        request,
+        threadId: route.threadId,
+      });
+    case "threads/messages":
+      return handleGetThreadMessages({
+        runtime,
+        request,
+        threadId: route.threadId,
+      });
   }
 }
 
@@ -376,10 +409,28 @@ function validateHttpMethod(
   route: RouteInfo,
 ): Response | null {
   const method = httpMethod.toUpperCase();
-  if (route.method === "info" && method === "GET") return null;
-  if (route.method !== "info" && method === "POST") return null;
-  const allowed = route.method === "info" ? "GET" : "POST";
-  return jsonResponse({ error: "Method not allowed" }, 405, { Allow: allowed });
+
+  switch (route.method) {
+    case "info":
+    case "threads/list":
+    case "threads/messages":
+      if (method === "GET") return null;
+      return jsonResponse({ error: "Method not allowed" }, 405, {
+        Allow: "GET",
+      });
+
+    case "threads/update":
+      if (method === "PATCH" || method === "DELETE") return null;
+      return jsonResponse({ error: "Method not allowed" }, 405, {
+        Allow: "PATCH, DELETE",
+      });
+
+    default:
+      if (method === "POST") return null;
+      return jsonResponse({ error: "Method not allowed" }, 405, {
+        Allow: "POST",
+      });
+  }
 }
 
 /* ------------------------------------------------------------------------------------------------

package/src/v2/runtime/core/fetch-router.ts

@@ -108,5 +108,53 @@ function matchSegments(path: string): RouteInfo | null {
     return { method: "agent/stop", agentId, threadId };
   }
 
+  // /threads/subscribe (2 segments)
+  if (
+    len >= 2 &&
+    segments[len - 2] === "threads" &&
+    segments[len - 1] === "subscribe"
+  ) {
+    return { method: "threads/subscribe" };
+  }
+
+  // /threads/:threadId/messages (3 segments)
+  if (
+    len >= 3 &&
+    segments[len - 3] === "threads" &&
+    segments[len - 1] === "messages"
+  ) {
+    const threadId = safeDecodeURIComponent(segments[len - 2]!);
+    if (!threadId) return null;
+    return { method: "threads/messages", threadId };
+  }
+
+  // /threads/:threadId/archive (3 segments)
+  if (
+    len >= 3 &&
+    segments[len - 3] === "threads" &&
+    segments[len - 1] === "archive"
+  ) {
+    const threadId = safeDecodeURIComponent(segments[len - 2]!);
+    if (!threadId) return null;
+    return { method: "threads/archive", threadId };
+  }
+
+  // /threads/:threadId (2 segments) — update or delete
+  if (
+    len >= 2 &&
+    segments[len - 2] === "threads" &&
+    segments[len - 1] !== "subscribe"
+  ) {
+    const threadId = safeDecodeURIComponent(segments[len - 1]!);
+    if (!threadId) return null;
+    // Disambiguated by HTTP method in the handler
+    return { method: "threads/update", threadId };
+  }
+
+  // /threads (1 segment) — list
+  if (len >= 1 && segments[len - 1] === "threads") {
+    return { method: "threads/list" };
+  }
+
   return null;
 }

package/src/v2/runtime/core/hooks.ts

@@ -38,7 +38,12 @@ export type RouteInfo =
   | { method: "agent/connect"; agentId: string }
   | { method: "agent/stop"; agentId: string; threadId: string }
   | { method: "info" }
-  | { method: "transcribe" };
+  | { method: "transcribe" }
+  | { method: "threads/list" }
+  | { method: "threads/subscribe" }
+  | { method: "threads/update"; threadId: string }
+  | { method: "threads/archive"; threadId: string }
+  | { method: "threads/messages"; threadId: string };
 
 /* ------------------------------------------------------------------------------------------------
  * Hook contexts

package/src/v2/runtime/handlers/handle-threads.ts

@@ -1,6 +1,7 @@
 export {
   handleArchiveThread,
   handleDeleteThread,
+  handleGetThreadMessages,
   handleListThreads,
   handleSubscribeToThreads,
   handleUpdateThread,