@copilotkit/runtime 1.54.1 → 1.55.0-next.7

package/dist/v2/runtime/handlers/intelligence/thread-names.cjs

@@ -0,0 +1,146 @@
+require("reflect-metadata");
+const require_runtime = require('../../../../_virtual/_rolldown/runtime.cjs');
+const require_agent_utils = require('../shared/agent-utils.cjs');
+const require_json_response = require('../shared/json-response.cjs');
+let _copilotkit_shared = require("@copilotkit/shared");
+let node_crypto = require("node:crypto");
+
+//#region src/v2/runtime/handlers/intelligence/thread-names.ts
+const THREAD_NAME_SYSTEM_PROMPT = [
+	"You generate short, specific conversation titles.",
+	"Return JSON only in this exact shape: {\"title\":\"...\"}",
+	"The title must be 2 to 5 words.",
+	"Use sentence case.",
+	"No quotes.",
+	"No emoji.",
+	"No markdown characters or formatting.",
+	"Do not use *, _, #, `, [, ], (, ), !, ~, >, or |.",
+	"No trailing punctuation.",
+	"No explanations.",
+	"Do not call tools."
+].join("\n");
+const MAX_TITLE_LENGTH = 80;
+const MAX_TITLE_WORDS = 8;
+const MAX_TRANSCRIPT_MESSAGES = 8;
+const MAX_TITLE_GENERATION_ATTEMPTS = 3;
+const FALLBACK_THREAD_TITLE = "Untitled";
+async function generateThreadNameForNewThread({ runtime, request, agentId, sourceInput, thread, userId }) {
+	if (!runtime.generateThreadNames || hasThreadName(thread.name)) return;
+	const prompt = buildThreadTitlePrompt(sourceInput.messages);
+	if (!prompt) return;
+	let generatedTitle = null;
+	for (let attempt = 1; attempt <= MAX_TITLE_GENERATION_ATTEMPTS; attempt++) try {
+		generatedTitle = await runTitleGenerationAttempt({
+			runtime,
+			request,
+			agentId,
+			threadId: thread.id,
+			prompt
+		});
+		if (generatedTitle) break;
+		_copilotkit_shared.logger.warn({
+			agentId,
+			attempt,
+			threadId: thread.id
+		}, "Thread name generation returned an empty or invalid title");
+	} catch (error) {
+		_copilotkit_shared.logger.warn({
+			err: error,
+			agentId,
+			attempt,
+			threadId: thread.id
+		}, "Thread name generation attempt failed");
+	}
+	await runtime.intelligence.updateThread({
+		threadId: thread.id,
+		userId,
+		agentId,
+		updates: { name: generatedTitle ?? FALLBACK_THREAD_TITLE }
+	});
+}
+async function runTitleGenerationAttempt(params) {
+	const { runtime, request, agentId, threadId, prompt } = params;
+	const agent = await require_agent_utils.cloneAgentForRequest(runtime, agentId);
+	if (require_json_response.isHandlerResponse(agent)) {
+		_copilotkit_shared.logger.warn({
+			agentId,
+			threadId
+		}, "Skipping thread naming because the agent could not be cloned");
+		return null;
+	}
+	require_agent_utils.configureAgentForRequest({
+		runtime,
+		request,
+		agentId,
+		agent
+	});
+	const messages = [{
+		id: (0, node_crypto.randomUUID)(),
+		role: "system",
+		content: THREAD_NAME_SYSTEM_PROMPT
+	}, {
+		id: (0, node_crypto.randomUUID)(),
+		role: "user",
+		content: prompt
+	}];
+	agent.setMessages(messages);
+	agent.setState({});
+	agent.threadId = `thread-name:${threadId}:${(0, node_crypto.randomUUID)()}`;
+	const { newMessages } = await agent.runAgent({
+		messages,
+		state: {},
+		tools: [],
+		context: [],
+		forwardedProps: {}
+	});
+	const lastMessage = newMessages.at(-1);
+	return normalizeGeneratedTitle(lastMessage ? stringifyMessageContent(lastMessage.content) : "");
+}
+function buildThreadTitlePrompt(messages) {
+	const transcript = (messages ?? []).filter((message) => [
+		"user",
+		"assistant",
+		"system",
+		"developer"
+	].includes(message.role)).map((message) => {
+		const content = stringifyMessageContent(message.content);
+		if (!content) return null;
+		return `${message.role}: ${content}`;
+	}).filter((message) => !!message).slice(-MAX_TRANSCRIPT_MESSAGES);
+	if (transcript.length === 0) return null;
+	return [
+		"Generate a short title for this conversation.",
+		"Conversation:",
+		transcript.join("\n")
+	].join("\n\n");
+}
+function stringifyMessageContent(content) {
+	if (typeof content === "string") return content.trim();
+	if (content == null) return "";
+	try {
+		return JSON.stringify(content).trim();
+	} catch {
+		return "";
+	}
+}
+function normalizeGeneratedTitle(rawTitle) {
+	let candidate = rawTitle.trim();
+	if (!candidate) return null;
+	candidate = candidate.replace(/^```(?:json)?\s*/i, "").replace(/\s*```$/, "").trim();
+	try {
+		const parsed = JSON.parse(candidate);
+		if (typeof parsed.title === "string") candidate = parsed.title;
+	} catch {}
+	candidate = candidate.replace(/^["'`]+|["'`]+$/g, "").replace(/[*_#[\]()!~>|]+/g, "").replace(/[.!?,;:]+$/g, "").replace(/\s+/g, " ").trim();
+	if (!candidate) return null;
+	if (candidate.length > MAX_TITLE_LENGTH) candidate = candidate.slice(0, MAX_TITLE_LENGTH).trim();
+	if (candidate.split(/\s+/).length > MAX_TITLE_WORDS) return null;
+	return candidate;
+}
+function hasThreadName(name) {
+	return typeof name === "string" && name.trim().length > 0;
+}
+
+//#endregion
+exports.generateThreadNameForNewThread = generateThreadNameForNewThread;
+//# sourceMappingURL=thread-names.cjs.map

package/dist/v2/runtime/handlers/intelligence/thread-names.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-names.cjs","names":["cloneAgentForRequest","isHandlerResponse"],"sources":["../../../../../src/v2/runtime/handlers/intelligence/thread-names.ts"],"sourcesContent":["import { AbstractAgent, Message, RunAgentInput } from \"@ag-ui/client\";\nimport { logger } from \"@copilotkit/shared\";\nimport { randomUUID } from \"node:crypto\";\nimport { CopilotIntelligenceRuntimeLike } from \"../../runtime\";\nimport {\n  cloneAgentForRequest,\n  configureAgentForRequest,\n} from \"../shared/agent-utils\";\nimport { ThreadSummary } from \"../../intelligence-platform\";\nimport { isHandlerResponse } from \"../shared/json-response\";\n\nconst THREAD_NAME_SYSTEM_PROMPT = [\n  \"You generate short, specific conversation titles.\",\n  'Return JSON only in this exact shape: {\"title\":\"...\"}',\n  \"The title must be 2 to 5 words.\",\n  \"Use sentence case.\",\n  \"No quotes.\",\n  \"No emoji.\",\n  \"No markdown characters or formatting.\",\n  \"Do not use *, _, #, `, [, ], (, ), !, ~, >, or |.\",\n  \"No trailing punctuation.\",\n  \"No explanations.\",\n  \"Do not call tools.\",\n].join(\"\\n\");\n\nconst MAX_TITLE_LENGTH = 80;\nconst MAX_TITLE_WORDS = 8;\nconst MAX_TRANSCRIPT_MESSAGES = 8;\nconst MAX_TITLE_GENERATION_ATTEMPTS = 3;\nconst FALLBACK_THREAD_TITLE = \"Untitled\";\n\ninterface GenerateThreadNameParams {\n  runtime: CopilotIntelligenceRuntimeLike;\n  request: Request;\n  agentId: string;\n  sourceInput: RunAgentInput;\n  thread: ThreadSummary;\n  userId: string;\n}\n\nexport async function generateThreadNameForNewThread({\n  runtime,\n  request,\n  agentId,\n  sourceInput,\n  thread,\n  userId,\n}: GenerateThreadNameParams): Promise<void> {\n  if (!runtime.generateThreadNames || hasThreadName(thread.name)) {\n    return;\n  }\n\n  const prompt = buildThreadTitlePrompt(sourceInput.messages);\n  if (!prompt) {\n    return;\n  }\n\n  let generatedTitle: string | null = null;\n\n  for (let attempt = 1; attempt <= MAX_TITLE_GENERATION_ATTEMPTS; attempt++) {\n    try {\n      generatedTitle = await runTitleGenerationAttempt({\n        runtime,\n        request,\n        agentId,\n        threadId: thread.id,\n        prompt,\n      });\n\n      if (generatedTitle) {\n        break;\n      }\n\n      logger.warn(\n        { agentId, attempt, threadId: thread.id },\n        \"Thread name generation returned an empty or invalid title\",\n      );\n    } catch (error) {\n      logger.warn(\n        { err: error, agentId, attempt, threadId: thread.id },\n        \"Thread name generation attempt failed\",\n      );\n    }\n  }\n\n  await runtime.intelligence.updateThread({\n    threadId: thread.id,\n    userId,\n    agentId,\n    updates: { name: generatedTitle ?? FALLBACK_THREAD_TITLE },\n  });\n}\n\nasync function runTitleGenerationAttempt(params: {\n  runtime: CopilotIntelligenceRuntimeLike;\n  request: Request;\n  agentId: string;\n  threadId: string;\n  prompt: string;\n}): Promise<string | null> {\n  const { runtime, request, agentId, threadId, prompt } = params;\n  const agent = await cloneAgentForRequest(runtime, agentId);\n  if (isHandlerResponse(agent)) {\n    logger.warn(\n      { agentId, threadId },\n      \"Skipping thread naming because the agent could not be cloned\",\n    );\n    return null;\n  }\n\n  configureAgentForRequest({\n    runtime,\n    request,\n    agentId,\n    agent,\n  });\n\n  const messages: Message[] = [\n    {\n      id: randomUUID(),\n      role: \"system\",\n      content: THREAD_NAME_SYSTEM_PROMPT,\n    },\n    {\n      id: randomUUID(),\n      role: \"user\",\n      content: prompt,\n    },\n  ];\n\n  agent.setMessages(messages);\n  agent.setState({});\n  agent.threadId = `thread-name:${threadId}:${randomUUID()}`;\n  const { newMessages } = await agent.runAgent({\n    messages,\n    state: {},\n    tools: [],\n    context: [],\n    forwardedProps: {},\n  });\n\n  const lastMessage = newMessages.at(-1);\n  const titleContent = lastMessage\n    ? stringifyMessageContent(lastMessage.content)\n    : \"\";\n\n  return normalizeGeneratedTitle(titleContent);\n}\n\nfunction buildThreadTitlePrompt(\n  messages: Message[] | undefined,\n): string | null {\n  const transcript = (messages ?? [])\n    .filter((message) =>\n      [\"user\", \"assistant\", \"system\", \"developer\"].includes(message.role),\n    )\n    .map((message) => {\n      const content = stringifyMessageContent(message.content);\n      if (!content) {\n        return null;\n      }\n\n      return `${message.role}: ${content}`;\n    })\n    .filter((message): message is string => !!message)\n    .slice(-MAX_TRANSCRIPT_MESSAGES);\n\n  if (transcript.length === 0) {\n    return null;\n  }\n\n  return [\n    \"Generate a short title for this conversation.\",\n    \"Conversation:\",\n    transcript.join(\"\\n\"),\n  ].join(\"\\n\\n\");\n}\n\nfunction stringifyMessageContent(content: Message[\"content\"]): string {\n  if (typeof content === \"string\") {\n    return content.trim();\n  }\n\n  if (content == null) {\n    return \"\";\n  }\n\n  try {\n    return JSON.stringify(content).trim();\n  } catch {\n    return \"\";\n  }\n}\n\nfunction normalizeGeneratedTitle(rawTitle: string): string | null {\n  let candidate = rawTitle.trim();\n  if (!candidate) {\n    return null;\n  }\n\n  candidate = candidate\n    .replace(/^```(?:json)?\\s*/i, \"\")\n    .replace(/\\s*```$/, \"\")\n    .trim();\n\n  try {\n    const parsed = JSON.parse(candidate) as { title?: unknown };\n    if (typeof parsed.title === \"string\") {\n      candidate = parsed.title;\n    }\n  } catch {\n    // Fall back to using the raw text.\n  }\n\n  candidate = candidate\n    .replace(/^[\"'`]+|[\"'`]+$/g, \"\")\n    .replace(/[*_#[\\]()!~>|]+/g, \"\")\n    .replace(/[.!?,;:]+$/g, \"\")\n    .replace(/\\s+/g, \" \")\n    .trim();\n\n  if (!candidate) {\n    return null;\n  }\n\n  if (candidate.length > MAX_TITLE_LENGTH) {\n    candidate = candidate.slice(0, MAX_TITLE_LENGTH).trim();\n  }\n\n  if (candidate.split(/\\s+/).length > MAX_TITLE_WORDS) {\n    return null;\n  }\n\n  return candidate;\n}\n\nfunction hasThreadName(name: string | null | undefined): boolean {\n  return typeof name === \"string\" && name.trim().length > 0;\n}\n\n/** @internal Exported for testing only. */\nexport const ɵnormalizeGeneratedTitle = normalizeGeneratedTitle;\n/** @internal Exported for testing only. */\nexport const ɵbuildThreadTitlePrompt = buildThreadTitlePrompt;\n/** @internal Exported for testing only. */\nexport const ɵhasThreadName = hasThreadName;\n"],"mappings":";;;;;;;;AAWA,MAAM,4BAA4B;CAChC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC,KAAK,KAAK;AAEZ,MAAM,mBAAmB;AACzB,MAAM,kBAAkB;AACxB,MAAM,0BAA0B;AAChC,MAAM,gCAAgC;AACtC,MAAM,wBAAwB;AAW9B,eAAsB,+BAA+B,EACnD,SACA,SACA,SACA,aACA,QACA,UAC0C;AAC1C,KAAI,CAAC,QAAQ,uBAAuB,cAAc,OAAO,KAAK,CAC5D;CAGF,MAAM,SAAS,uBAAuB,YAAY,SAAS;AAC3D,KAAI,CAAC,OACH;CAGF,IAAI,iBAAgC;AAEpC,MAAK,IAAI,UAAU,GAAG,WAAW,+BAA+B,UAC9D,KAAI;AACF,mBAAiB,MAAM,0BAA0B;GAC/C;GACA;GACA;GACA,UAAU,OAAO;GACjB;GACD,CAAC;AAEF,MAAI,eACF;AAGF,4BAAO,KACL;GAAE;GAAS;GAAS,UAAU,OAAO;GAAI,EACzC,4DACD;UACM,OAAO;AACd,4BAAO,KACL;GAAE,KAAK;GAAO;GAAS;GAAS,UAAU,OAAO;GAAI,EACrD,wCACD;;AAIL,OAAM,QAAQ,aAAa,aAAa;EACtC,UAAU,OAAO;EACjB;EACA;EACA,SAAS,EAAE,MAAM,kBAAkB,uBAAuB;EAC3D,CAAC;;AAGJ,eAAe,0BAA0B,QAMd;CACzB,MAAM,EAAE,SAAS,SAAS,SAAS,UAAU,WAAW;CACxD,MAAM,QAAQ,MAAMA,yCAAqB,SAAS,QAAQ;AAC1D,KAAIC,wCAAkB,MAAM,EAAE;AAC5B,4BAAO,KACL;GAAE;GAAS;GAAU,EACrB,+DACD;AACD,SAAO;;AAGT,8CAAyB;EACvB;EACA;EACA;EACA;EACD,CAAC;CAEF,MAAM,WAAsB,CAC1B;EACE,iCAAgB;EAChB,MAAM;EACN,SAAS;EACV,EACD;EACE,iCAAgB;EAChB,MAAM;EACN,SAAS;EACV,CACF;AAED,OAAM,YAAY,SAAS;AAC3B,OAAM,SAAS,EAAE,CAAC;AAClB,OAAM,WAAW,eAAe,SAAS,gCAAe;CACxD,MAAM,EAAE,gBAAgB,MAAM,MAAM,SAAS;EAC3C;EACA,OAAO,EAAE;EACT,OAAO,EAAE;EACT,SAAS,EAAE;EACX,gBAAgB,EAAE;EACnB,CAAC;CAEF,MAAM,cAAc,YAAY,GAAG,GAAG;AAKtC,QAAO,wBAJc,cACjB,wBAAwB,YAAY,QAAQ,GAC5C,GAEwC;;AAG9C,SAAS,uBACP,UACe;CACf,MAAM,cAAc,YAAY,EAAE,EAC/B,QAAQ,YACP;EAAC;EAAQ;EAAa;EAAU;EAAY,CAAC,SAAS,QAAQ,KAAK,CACpE,CACA,KAAK,YAAY;EAChB,MAAM,UAAU,wBAAwB,QAAQ,QAAQ;AACxD,MAAI,CAAC,QACH,QAAO;AAGT,SAAO,GAAG,QAAQ,KAAK,IAAI;GAC3B,CACD,QAAQ,YAA+B,CAAC,CAAC,QAAQ,CACjD,MAAM,CAAC,wBAAwB;AAElC,KAAI,WAAW,WAAW,EACxB,QAAO;AAGT,QAAO;EACL;EACA;EACA,WAAW,KAAK,KAAK;EACtB,CAAC,KAAK,OAAO;;AAGhB,SAAS,wBAAwB,SAAqC;AACpE,KAAI,OAAO,YAAY,SACrB,QAAO,QAAQ,MAAM;AAGvB,KAAI,WAAW,KACb,QAAO;AAGT,KAAI;AACF,SAAO,KAAK,UAAU,QAAQ,CAAC,MAAM;SAC/B;AACN,SAAO;;;AAIX,SAAS,wBAAwB,UAAiC;CAChE,IAAI,YAAY,SAAS,MAAM;AAC/B,KAAI,CAAC,UACH,QAAO;AAGT,aAAY,UACT,QAAQ,qBAAqB,GAAG,CAChC,QAAQ,WAAW,GAAG,CACtB,MAAM;AAET,KAAI;EACF,MAAM,SAAS,KAAK,MAAM,UAAU;AACpC,MAAI,OAAO,OAAO,UAAU,SAC1B,aAAY,OAAO;SAEf;AAIR,aAAY,UACT,QAAQ,oBAAoB,GAAG,CAC/B,QAAQ,oBAAoB,GAAG,CAC/B,QAAQ,eAAe,GAAG,CAC1B,QAAQ,QAAQ,IAAI,CACpB,MAAM;AAET,KAAI,CAAC,UACH,QAAO;AAGT,KAAI,UAAU,SAAS,iBACrB,aAAY,UAAU,MAAM,GAAG,iBAAiB,CAAC,MAAM;AAGzD,KAAI,UAAU,MAAM,MAAM,CAAC,SAAS,gBAClC,QAAO;AAGT,QAAO;;AAGT,SAAS,cAAc,MAA0C;AAC/D,QAAO,OAAO,SAAS,YAAY,KAAK,MAAM,CAAC,SAAS"}

package/dist/v2/runtime/handlers/intelligence/thread-names.mjs

@@ -0,0 +1,145 @@
+import "reflect-metadata";
+import { cloneAgentForRequest, configureAgentForRequest } from "../shared/agent-utils.mjs";
+import { isHandlerResponse } from "../shared/json-response.mjs";
+import { logger } from "@copilotkit/shared";
+import { randomUUID as randomUUID$1 } from "node:crypto";
+
+//#region src/v2/runtime/handlers/intelligence/thread-names.ts
+const THREAD_NAME_SYSTEM_PROMPT = [
+	"You generate short, specific conversation titles.",
+	"Return JSON only in this exact shape: {\"title\":\"...\"}",
+	"The title must be 2 to 5 words.",
+	"Use sentence case.",
+	"No quotes.",
+	"No emoji.",
+	"No markdown characters or formatting.",
+	"Do not use *, _, #, `, [, ], (, ), !, ~, >, or |.",
+	"No trailing punctuation.",
+	"No explanations.",
+	"Do not call tools."
+].join("\n");
+const MAX_TITLE_LENGTH = 80;
+const MAX_TITLE_WORDS = 8;
+const MAX_TRANSCRIPT_MESSAGES = 8;
+const MAX_TITLE_GENERATION_ATTEMPTS = 3;
+const FALLBACK_THREAD_TITLE = "Untitled";
+async function generateThreadNameForNewThread({ runtime, request, agentId, sourceInput, thread, userId }) {
+	if (!runtime.generateThreadNames || hasThreadName(thread.name)) return;
+	const prompt = buildThreadTitlePrompt(sourceInput.messages);
+	if (!prompt) return;
+	let generatedTitle = null;
+	for (let attempt = 1; attempt <= MAX_TITLE_GENERATION_ATTEMPTS; attempt++) try {
+		generatedTitle = await runTitleGenerationAttempt({
+			runtime,
+			request,
+			agentId,
+			threadId: thread.id,
+			prompt
+		});
+		if (generatedTitle) break;
+		logger.warn({
+			agentId,
+			attempt,
+			threadId: thread.id
+		}, "Thread name generation returned an empty or invalid title");
+	} catch (error) {
+		logger.warn({
+			err: error,
+			agentId,
+			attempt,
+			threadId: thread.id
+		}, "Thread name generation attempt failed");
+	}
+	await runtime.intelligence.updateThread({
+		threadId: thread.id,
+		userId,
+		agentId,
+		updates: { name: generatedTitle ?? FALLBACK_THREAD_TITLE }
+	});
+}
+async function runTitleGenerationAttempt(params) {
+	const { runtime, request, agentId, threadId, prompt } = params;
+	const agent = await cloneAgentForRequest(runtime, agentId);
+	if (isHandlerResponse(agent)) {
+		logger.warn({
+			agentId,
+			threadId
+		}, "Skipping thread naming because the agent could not be cloned");
+		return null;
+	}
+	configureAgentForRequest({
+		runtime,
+		request,
+		agentId,
+		agent
+	});
+	const messages = [{
+		id: randomUUID$1(),
+		role: "system",
+		content: THREAD_NAME_SYSTEM_PROMPT
+	}, {
+		id: randomUUID$1(),
+		role: "user",
+		content: prompt
+	}];
+	agent.setMessages(messages);
+	agent.setState({});
+	agent.threadId = `thread-name:${threadId}:${randomUUID$1()}`;
+	const { newMessages } = await agent.runAgent({
+		messages,
+		state: {},
+		tools: [],
+		context: [],
+		forwardedProps: {}
+	});
+	const lastMessage = newMessages.at(-1);
+	return normalizeGeneratedTitle(lastMessage ? stringifyMessageContent(lastMessage.content) : "");
+}
+function buildThreadTitlePrompt(messages) {
+	const transcript = (messages ?? []).filter((message) => [
+		"user",
+		"assistant",
+		"system",
+		"developer"
+	].includes(message.role)).map((message) => {
+		const content = stringifyMessageContent(message.content);
+		if (!content) return null;
+		return `${message.role}: ${content}`;
+	}).filter((message) => !!message).slice(-MAX_TRANSCRIPT_MESSAGES);
+	if (transcript.length === 0) return null;
+	return [
+		"Generate a short title for this conversation.",
+		"Conversation:",
+		transcript.join("\n")
+	].join("\n\n");
+}
+function stringifyMessageContent(content) {
+	if (typeof content === "string") return content.trim();
+	if (content == null) return "";
+	try {
+		return JSON.stringify(content).trim();
+	} catch {
+		return "";
+	}
+}
+function normalizeGeneratedTitle(rawTitle) {
+	let candidate = rawTitle.trim();
+	if (!candidate) return null;
+	candidate = candidate.replace(/^```(?:json)?\s*/i, "").replace(/\s*```$/, "").trim();
+	try {
+		const parsed = JSON.parse(candidate);
+		if (typeof parsed.title === "string") candidate = parsed.title;
+	} catch {}
+	candidate = candidate.replace(/^["'`]+|["'`]+$/g, "").replace(/[*_#[\]()!~>|]+/g, "").replace(/[.!?,;:]+$/g, "").replace(/\s+/g, " ").trim();
+	if (!candidate) return null;
+	if (candidate.length > MAX_TITLE_LENGTH) candidate = candidate.slice(0, MAX_TITLE_LENGTH).trim();
+	if (candidate.split(/\s+/).length > MAX_TITLE_WORDS) return null;
+	return candidate;
+}
+function hasThreadName(name) {
+	return typeof name === "string" && name.trim().length > 0;
+}
+
+//#endregion
+export { generateThreadNameForNewThread };
+//# sourceMappingURL=thread-names.mjs.map

package/dist/v2/runtime/handlers/intelligence/thread-names.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-names.mjs","names":["randomUUID"],"sources":["../../../../../src/v2/runtime/handlers/intelligence/thread-names.ts"],"sourcesContent":["import { AbstractAgent, Message, RunAgentInput } from \"@ag-ui/client\";\nimport { logger } from \"@copilotkit/shared\";\nimport { randomUUID } from \"node:crypto\";\nimport { CopilotIntelligenceRuntimeLike } from \"../../runtime\";\nimport {\n  cloneAgentForRequest,\n  configureAgentForRequest,\n} from \"../shared/agent-utils\";\nimport { ThreadSummary } from \"../../intelligence-platform\";\nimport { isHandlerResponse } from \"../shared/json-response\";\n\nconst THREAD_NAME_SYSTEM_PROMPT = [\n  \"You generate short, specific conversation titles.\",\n  'Return JSON only in this exact shape: {\"title\":\"...\"}',\n  \"The title must be 2 to 5 words.\",\n  \"Use sentence case.\",\n  \"No quotes.\",\n  \"No emoji.\",\n  \"No markdown characters or formatting.\",\n  \"Do not use *, _, #, `, [, ], (, ), !, ~, >, or |.\",\n  \"No trailing punctuation.\",\n  \"No explanations.\",\n  \"Do not call tools.\",\n].join(\"\\n\");\n\nconst MAX_TITLE_LENGTH = 80;\nconst MAX_TITLE_WORDS = 8;\nconst MAX_TRANSCRIPT_MESSAGES = 8;\nconst MAX_TITLE_GENERATION_ATTEMPTS = 3;\nconst FALLBACK_THREAD_TITLE = \"Untitled\";\n\ninterface GenerateThreadNameParams {\n  runtime: CopilotIntelligenceRuntimeLike;\n  request: Request;\n  agentId: string;\n  sourceInput: RunAgentInput;\n  thread: ThreadSummary;\n  userId: string;\n}\n\nexport async function generateThreadNameForNewThread({\n  runtime,\n  request,\n  agentId,\n  sourceInput,\n  thread,\n  userId,\n}: GenerateThreadNameParams): Promise<void> {\n  if (!runtime.generateThreadNames || hasThreadName(thread.name)) {\n    return;\n  }\n\n  const prompt = buildThreadTitlePrompt(sourceInput.messages);\n  if (!prompt) {\n    return;\n  }\n\n  let generatedTitle: string | null = null;\n\n  for (let attempt = 1; attempt <= MAX_TITLE_GENERATION_ATTEMPTS; attempt++) {\n    try {\n      generatedTitle = await runTitleGenerationAttempt({\n        runtime,\n        request,\n        agentId,\n        threadId: thread.id,\n        prompt,\n      });\n\n      if (generatedTitle) {\n        break;\n      }\n\n      logger.warn(\n        { agentId, attempt, threadId: thread.id },\n        \"Thread name generation returned an empty or invalid title\",\n      );\n    } catch (error) {\n      logger.warn(\n        { err: error, agentId, attempt, threadId: thread.id },\n        \"Thread name generation attempt failed\",\n      );\n    }\n  }\n\n  await runtime.intelligence.updateThread({\n    threadId: thread.id,\n    userId,\n    agentId,\n    updates: { name: generatedTitle ?? FALLBACK_THREAD_TITLE },\n  });\n}\n\nasync function runTitleGenerationAttempt(params: {\n  runtime: CopilotIntelligenceRuntimeLike;\n  request: Request;\n  agentId: string;\n  threadId: string;\n  prompt: string;\n}): Promise<string | null> {\n  const { runtime, request, agentId, threadId, prompt } = params;\n  const agent = await cloneAgentForRequest(runtime, agentId);\n  if (isHandlerResponse(agent)) {\n    logger.warn(\n      { agentId, threadId },\n      \"Skipping thread naming because the agent could not be cloned\",\n    );\n    return null;\n  }\n\n  configureAgentForRequest({\n    runtime,\n    request,\n    agentId,\n    agent,\n  });\n\n  const messages: Message[] = [\n    {\n      id: randomUUID(),\n      role: \"system\",\n      content: THREAD_NAME_SYSTEM_PROMPT,\n    },\n    {\n      id: randomUUID(),\n      role: \"user\",\n      content: prompt,\n    },\n  ];\n\n  agent.setMessages(messages);\n  agent.setState({});\n  agent.threadId = `thread-name:${threadId}:${randomUUID()}`;\n  const { newMessages } = await agent.runAgent({\n    messages,\n    state: {},\n    tools: [],\n    context: [],\n    forwardedProps: {},\n  });\n\n  const lastMessage = newMessages.at(-1);\n  const titleContent = lastMessage\n    ? stringifyMessageContent(lastMessage.content)\n    : \"\";\n\n  return normalizeGeneratedTitle(titleContent);\n}\n\nfunction buildThreadTitlePrompt(\n  messages: Message[] | undefined,\n): string | null {\n  const transcript = (messages ?? [])\n    .filter((message) =>\n      [\"user\", \"assistant\", \"system\", \"developer\"].includes(message.role),\n    )\n    .map((message) => {\n      const content = stringifyMessageContent(message.content);\n      if (!content) {\n        return null;\n      }\n\n      return `${message.role}: ${content}`;\n    })\n    .filter((message): message is string => !!message)\n    .slice(-MAX_TRANSCRIPT_MESSAGES);\n\n  if (transcript.length === 0) {\n    return null;\n  }\n\n  return [\n    \"Generate a short title for this conversation.\",\n    \"Conversation:\",\n    transcript.join(\"\\n\"),\n  ].join(\"\\n\\n\");\n}\n\nfunction stringifyMessageContent(content: Message[\"content\"]): string {\n  if (typeof content === \"string\") {\n    return content.trim();\n  }\n\n  if (content == null) {\n    return \"\";\n  }\n\n  try {\n    return JSON.stringify(content).trim();\n  } catch {\n    return \"\";\n  }\n}\n\nfunction normalizeGeneratedTitle(rawTitle: string): string | null {\n  let candidate = rawTitle.trim();\n  if (!candidate) {\n    return null;\n  }\n\n  candidate = candidate\n    .replace(/^```(?:json)?\\s*/i, \"\")\n    .replace(/\\s*```$/, \"\")\n    .trim();\n\n  try {\n    const parsed = JSON.parse(candidate) as { title?: unknown };\n    if (typeof parsed.title === \"string\") {\n      candidate = parsed.title;\n    }\n  } catch {\n    // Fall back to using the raw text.\n  }\n\n  candidate = candidate\n    .replace(/^[\"'`]+|[\"'`]+$/g, \"\")\n    .replace(/[*_#[\\]()!~>|]+/g, \"\")\n    .replace(/[.!?,;:]+$/g, \"\")\n    .replace(/\\s+/g, \" \")\n    .trim();\n\n  if (!candidate) {\n    return null;\n  }\n\n  if (candidate.length > MAX_TITLE_LENGTH) {\n    candidate = candidate.slice(0, MAX_TITLE_LENGTH).trim();\n  }\n\n  if (candidate.split(/\\s+/).length > MAX_TITLE_WORDS) {\n    return null;\n  }\n\n  return candidate;\n}\n\nfunction hasThreadName(name: string | null | undefined): boolean {\n  return typeof name === \"string\" && name.trim().length > 0;\n}\n\n/** @internal Exported for testing only. */\nexport const ɵnormalizeGeneratedTitle = normalizeGeneratedTitle;\n/** @internal Exported for testing only. */\nexport const ɵbuildThreadTitlePrompt = buildThreadTitlePrompt;\n/** @internal Exported for testing only. */\nexport const ɵhasThreadName = hasThreadName;\n"],"mappings":"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"}

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

@@ -0,0 +1,159 @@
+require("reflect-metadata");
+const require_runtime = require('../../../../_virtual/_rolldown/runtime.cjs');
+const require_runtime$1 = require('../../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);
+	}
+}
+
+//#endregion
+exports.handleArchiveThread = handleArchiveThread;
+exports.handleDeleteThread = handleDeleteThread;
+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 \"../../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"],"mappings":"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"}

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

@@ -0,0 +1,154 @@
+import "reflect-metadata";
+import { isIntelligenceRuntime } from "../../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);
+	}
+}
+
+//#endregion
+export { handleArchiveThread, handleDeleteThread, handleListThreads, handleSubscribeToThreads, handleUpdateThread };
+//# sourceMappingURL=threads.mjs.map