@copilotkit/runtime 1.76.0 → 1.77.1

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

@@ -1,9 +1,9 @@
 import "reflect-metadata";
 import { isIntelligenceRuntime } from "../../core/runtime.mjs";
-import { PlatformRequestError } from "../../intelligence-platform/client.mjs";
 import { errorResponse, isHandlerResponse } from "../shared/json-response.mjs";
 import { resolveIntelligenceUser } from "../shared/resolve-intelligence-user.mjs";
 import { grantAllowsMemory, resolveWebMemory } from "../shared/memory-policy.mjs";
+import { platformErrorResponse } from "../shared/platform-error.mjs";
 import { logger } from "@copilotkit/shared";
 
 //#region src/v2/runtime/handlers/intelligence/memories.ts
@@ -30,23 +30,11 @@ const MEMORY_SCOPES = new Set(["user", "project"]);
 /**
 * Maps a thrown error to a `Response`.
 *
-* For a {@link PlatformRequestError}, forward only client-actionable **4xx**
-* statuses verbatim (e.g. 404 missing/wrong-scope memory, 409 conflict, 422
-* unprocessable) so a `useMemories` consumer can branch on them — a flat 500
-* would erase that distinction. A platform **5xx** (or any non-4xx / malformed
-* status) means the runtime is healthy but its dependency failed, so it surfaces
-* as `502 Bad Gateway` rather than echoing the upstream status as if the runtime
-* itself broke — and this also avoids a `new Response(..., { status })`
-* `RangeError` on an out-of-range status. Non-platform throws stay 500.
+* The reasoning now lives with the implementation in
+* `../shared/platform-error`, which the thread handlers share. This alias is
+* kept so the many call sites below read the same as they always did.
 */
-function memoryErrorResponse(error, message) {
-	if (error instanceof PlatformRequestError) {
-		const { status } = error;
-		if (Number.isInteger(status) && status >= 400 && status <= 499) return errorResponse(message, status);
-		return errorResponse(message, 502);
-	}
-	return errorResponse(message, 500);
-}
+const memoryErrorResponse = platformErrorResponse;
 async function parseJsonBody(request) {
 	try {
 		return await request.json();

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

@@ -1 +1 @@
-{"version":3,"file":"memories.mjs","names":[],"sources":["../../../../../src/v2/runtime/handlers/intelligence/memories.ts"],"sourcesContent":["import type {\n  CopilotIntelligenceRuntimeLike,\n  CopilotRuntimeLike,\n} from \"../../core/runtime\";\nimport { isIntelligenceRuntime } from \"../../core/runtime\";\nimport { logger } from \"@copilotkit/shared\";\nimport { errorResponse, isHandlerResponse } from \"../shared/json-response\";\nimport { resolveIntelligenceUser } from \"../shared/resolve-intelligence-user\";\nimport { grantAllowsMemory, resolveWebMemory } from \"../shared/memory-policy\";\nimport { PlatformRequestError } from \"../../intelligence-platform/client\";\n\ninterface MemoriesHandlerParams {\n  runtime: CopilotRuntimeLike;\n  request: Request;\n}\n\ninterface MemoryMutationParams extends MemoriesHandlerParams {\n  memoryId: string;\n}\n\nasync function resolveClientMemory(\n  runtime: CopilotIntelligenceRuntimeLike,\n  request: Request,\n) {\n  const user = await resolveIntelligenceUser({ runtime, request });\n  if (isHandlerResponse(user)) return user;\n  const access = await resolveWebMemory(runtime, request, user, \"client\");\n  if (isHandlerResponse(access)) return access;\n  // Unlike an agent run — which proceeds without Memory tools when the policy\n  // grants nothing — these routes exist ONLY to serve memories. A caller who\n  // asked for them and may not have them gets 403; an empty list would imply\n  // there are none, which is a different and false claim.\n  if (runtime.memory && !grantAllowsMemory(access.grant)) {\n    return errorResponse(\"Memory access denied\", 403);\n  }\n  return access;\n}\n\nconst MISSING_INTELLIGENCE_MESSAGE =\n  \"Missing CopilotKitIntelligence configuration. Memory operations require a CopilotKitIntelligence instance to be provided in CopilotRuntime options.\";\n\n/** Allowed `kind` vocabulary the platform's memory endpoints accept. */\nconst MEMORY_KINDS: ReadonlySet<string> = new Set([\n  \"topical\",\n  \"episodic\",\n  \"operational\",\n]);\n/** Allowed `scope` vocabulary the platform's memory endpoints accept. */\nconst MEMORY_SCOPES: ReadonlySet<string> = new Set([\"user\", \"project\"]);\n\n/**\n * Maps a thrown error to a `Response`.\n *\n * For a {@link PlatformRequestError}, forward only client-actionable **4xx**\n * statuses verbatim (e.g. 404 missing/wrong-scope memory, 409 conflict, 422\n * unprocessable) so a `useMemories` consumer can branch on them — a flat 500\n * would erase that distinction. A platform **5xx** (or any non-4xx / malformed\n * status) means the runtime is healthy but its dependency failed, so it surfaces\n * as `502 Bad Gateway` rather than echoing the upstream status as if the runtime\n * itself broke — and this also avoids a `new Response(..., { status })`\n * `RangeError` on an out-of-range status. Non-platform throws stay 500.\n */\nfunction memoryErrorResponse(error: unknown, message: string): Response {\n  if (error instanceof PlatformRequestError) {\n    const { status } = error;\n    if (Number.isInteger(status) && status >= 400 && status <= 499) {\n      return errorResponse(message, status);\n    }\n    return errorResponse(message, 502);\n  }\n  return errorResponse(message, 500);\n}\n\nasync function parseJsonBody(\n  request: Request,\n): Promise<Record<string, unknown> | Response> {\n  try {\n    return (await request.json()) as Record<string, unknown>;\n  } catch (error) {\n    logger.error({ err: error }, \"Malformed JSON in memory request body\");\n    return errorResponse(\"Invalid request body\", 400);\n  }\n}\n\n/**\n * Extracts and validates the create/supersede body fields the platform's\n * memory endpoints require. Returns a `Response` (400) on invalid input.\n */\nfunction parseMemoryBody(body: Record<string, unknown>):\n  | {\n      content: string;\n      kind: string;\n      scope?: string;\n      sourceThreadIds?: string[];\n    }\n  | Response {\n  const { content, kind, scope, sourceThreadIds } = body;\n  if (typeof content !== \"string\" || typeof kind !== \"string\") {\n    return errorResponse(\"Memory requires string `content` and `kind`\", 400);\n  }\n  // `kind` must be one of the platform's known kinds. Reject an out-of-vocabulary\n  // value here rather than forwarding it for the platform to reject.\n  if (!MEMORY_KINDS.has(kind)) {\n    return errorResponse(\n      \"Memory `kind` must be one of: topical, episodic, operational\",\n      400,\n    );\n  }\n  // `scope` is optional: when omitted the platform applies its default\n  // (`\"user\"`). Only reject a present-but-wrong-typed scope.\n  if (scope !== undefined && typeof scope !== \"string\") {\n    return errorResponse(\"Memory `scope` must be a string when provided\", 400);\n  }\n  // When `scope` is present, it must be one of the known scopes.\n  if (typeof scope === \"string\" && !MEMORY_SCOPES.has(scope)) {\n    return errorResponse(\"Memory `scope` must be one of: user, project\", 400);\n  }\n  // `sourceThreadIds` is optional, but when present it must be a string array.\n  // Validate every element so non-string ids are not forwarded to the platform.\n  if (\n    sourceThreadIds !== undefined &&\n    (!Array.isArray(sourceThreadIds) ||\n      !sourceThreadIds.every((id) => typeof id === \"string\"))\n  ) {\n    return errorResponse(\n      \"Memory `sourceThreadIds` must be an array of strings when provided\",\n      400,\n    );\n  }\n  return {\n    content,\n    kind,\n    ...(typeof scope === \"string\" ? { scope } : {}),\n    ...(Array.isArray(sourceThreadIds)\n      ? { sourceThreadIds: sourceThreadIds as string[] }\n      : {}),\n    // `sourceThreadIds` elements are validated as strings above; the cast is safe.\n  };\n}\n\n/**\n * Validates the recall body: `query` required non-empty string (trimmed);\n * `limit` optional finite positive integer; `scope` optional and in the known\n * scopes. Returns a 400 Response on invalid input. The returned `query` is the\n * trimmed value so a whitespace-padded query is never forwarded to the platform.\n */\nfunction parseRecallBody(\n  body: Record<string, unknown>,\n): { query: string; limit?: number; scope?: string } | Response {\n  const { query, limit, scope } = body;\n  // Trim before the emptiness check so whitespace-only queries (e.g. \"   \")\n  // are rejected rather than forwarded as a useless query to the platform.\n  const trimmedQuery = typeof query === \"string\" ? query.trim() : query;\n  if (typeof trimmedQuery !== \"string\" || trimmedQuery.length === 0) {\n    return errorResponse(\"Recall requires a non-empty string `query`\", 400);\n  }\n  // When provided, `limit` must be a finite positive integer. `Number.isInteger`\n  // already rejects NaN, Infinity, and fractions (NaN/Infinity would otherwise\n  // JSON-serialize to `null` and silently corrupt the forwarded request);\n  // the `> 0` guard rejects zero and negatives.\n  if (\n    limit !== undefined &&\n    !(typeof limit === \"number\" && Number.isInteger(limit) && limit > 0)\n  ) {\n    return errorResponse(\"Recall `limit` must be a positive integer\", 400);\n  }\n  if (scope !== undefined && typeof scope !== \"string\") {\n    return errorResponse(\"Recall `scope` must be a string when provided\", 400);\n  }\n  if (typeof scope === \"string\" && !MEMORY_SCOPES.has(scope)) {\n    return errorResponse(\"Recall `scope` must be one of: user, project\", 400);\n  }\n  return {\n    query: trimmedQuery,\n    ...(typeof limit === \"number\" ? { limit } : {}),\n    ...(typeof scope === \"string\" ? { scope } : {}),\n  };\n}\n\n/**\n * Lists the resolved user's long-term memories via CopilotKit Intelligence.\n *\n * Mirrors {@link handleListThreads}: requires a `CopilotKitIntelligence`\n * runtime, resolves the user with `identifyUser` (never trusting a\n * client-supplied id), and proxies to the platform's `GET /api/memories`\n * with the project API key + resolved user. The `?includeInvalidated=true`\n * query is forwarded so callers can opt into retired rows. The response is\n * the platform's `{ memories }` envelope, which the client memory store\n * consumes directly.\n */\nexport async function handleListMemories({\n  runtime,\n  request,\n}: MemoriesHandlerParams): Promise<Response> {\n  if (isIntelligenceRuntime(runtime)) {\n    try {\n      const url = new URL(request.url);\n      const includeInvalidated =\n        url.searchParams.get(\"includeInvalidated\") === \"true\";\n\n      const access = await resolveClientMemory(runtime, request);\n      if (isHandlerResponse(access)) return access;\n\n      const data = await runtime.intelligence.listMemories({\n        userId: access.user.id,\n        ...(runtime.memory ? { memoryGrant: access.grant } : {}),\n        ...(includeInvalidated ? { includeInvalidated: true } : {}),\n      });\n\n      // The client memory store consumes the `{ memories: [...] }` envelope\n      // directly. Assert the shape before forwarding so a platform contract\n      // violation surfaces as a clear 502 (the runtime is healthy but its\n      // dependency returned the wrong shape) instead of a 200 the client will\n      // choke on.\n      if (\n        data == null ||\n        typeof data !== \"object\" ||\n        !Array.isArray((data as { memories?: unknown }).memories)\n      ) {\n        logger.error(\n          { data },\n          \"listMemories: platform returned a response without a `memories` array\",\n        );\n        return errorResponse(\n          \"Memory platform returned an invalid list response\",\n          502,\n        );\n      }\n\n      return Response.json(data);\n    } catch (error) {\n      logger.error({ err: error }, \"Error listing memories\");\n      return memoryErrorResponse(error, \"Failed to list memories\");\n    }\n  }\n\n  return errorResponse(MISSING_INTELLIGENCE_MESSAGE, 422);\n}\n\n/**\n * Semantically recalls the resolved user's memories via the platform (`POST\n * /api/memories/recall`, hybrid RAG). Mirrors {@link handleListMemories}:\n * requires a `CopilotKitIntelligence` runtime, resolves the user with\n * `identifyUser` (never a client-supplied id), proxies with the project API\n * key + resolved user. Body `{ query, limit?, scope? }`; response `{ memories }`,\n * each optionally carrying `score`.\n */\nexport async function handleRecallMemories({\n  runtime,\n  request,\n}: MemoriesHandlerParams): Promise<Response> {\n  if (!isIntelligenceRuntime(runtime)) {\n    return errorResponse(MISSING_INTELLIGENCE_MESSAGE, 422);\n  }\n  try {\n    const body = await parseJsonBody(request);\n    if (isHandlerResponse(body)) return body;\n    const fields = parseRecallBody(body);\n    if (isHandlerResponse(fields)) return fields;\n\n    const access = await resolveClientMemory(runtime, request);\n    if (isHandlerResponse(access)) return access;\n\n    const data = await runtime.intelligence.recallMemories({\n      userId: access.user.id,\n      ...(runtime.memory ? { memoryGrant: access.grant } : {}),\n      ...fields,\n    });\n\n    if (\n      data == null ||\n      typeof data !== \"object\" ||\n      !Array.isArray((data as { memories?: unknown }).memories)\n    ) {\n      logger.error(\n        { data },\n        \"recallMemories: platform returned a response without a `memories` array\",\n      );\n      return errorResponse(\n        \"Memory platform returned an invalid recall response\",\n        502,\n      );\n    }\n    return Response.json(data);\n  } catch (error) {\n    logger.error({ err: error }, \"Error recalling memories\");\n    return memoryErrorResponse(error, \"Failed to recall memories\");\n  }\n}\n\n/**\n * Mints memory-realtime join credentials (platform `POST\n * /api/memories/subscribe`). Mirrors {@link handleSubscribeToThreads}: requires\n * a `CopilotKitIntelligence` runtime and resolves the user with `identifyUser`\n * (never a client-supplied id). Returns `{ joinToken, joinCode }` — memory needs\n * the `joinCode` here (unlike threads, where it rides the thread-list response)\n * because the client builds the `user_meta:memories:<joinCode>` channel topic\n * from it.\n *\n * When the platform also resolves a project scope, the response additionally\n * carries `projectJoinToken` / `projectJoinCode`, which the client uses to open\n * a second `project_meta:memories:<projectJoinCode>` channel. These are\n * optional: absent project scope → both fields are omitted (silent-degrade\n * contract; the client opens only the user channel).\n */\nexport async function handleSubscribeToMemories({\n  runtime,\n  request,\n}: MemoriesHandlerParams): Promise<Response> {\n  if (isIntelligenceRuntime(runtime)) {\n    try {\n      const access = await resolveClientMemory(runtime, request);\n      if (isHandlerResponse(access)) return access;\n\n      const credentials = await runtime.intelligence.ɵsubscribeToMemories({\n        userId: access.user.id,\n        ...(runtime.memory ? { memoryGrant: access.grant } : {}),\n      });\n\n      return Response.json({\n        ...(credentials.joinToken !== undefined\n          ? { joinToken: credentials.joinToken }\n          : {}),\n        ...(credentials.joinCode !== undefined\n          ? { joinCode: credentials.joinCode }\n          : {}),\n        // Project-scoped credentials ride along only when the platform minted\n        // them; omit both when absent (silent-degrade contract).\n        ...(credentials.projectJoinToken !== undefined\n          ? { projectJoinToken: credentials.projectJoinToken }\n          : {}),\n        ...(credentials.projectJoinCode !== undefined\n          ? { projectJoinCode: credentials.projectJoinCode }\n          : {}),\n      });\n    } catch (error) {\n      logger.error({ err: error }, \"Error subscribing to memories\");\n      return memoryErrorResponse(error, \"Failed to subscribe to memories\");\n    }\n  }\n\n  return errorResponse(MISSING_INTELLIGENCE_MESSAGE, 422);\n}\n\n/**\n * Creates a memory for the resolved user (platform `POST /api/memories`).\n * Identity comes from `identifyUser`, never the request body. Returns 201\n * with the stored memory (the client store applies it server-authoritatively).\n */\nexport async function handleCreateMemory({\n  runtime,\n  request,\n}: MemoriesHandlerParams): Promise<Response> {\n  if (!isIntelligenceRuntime(runtime)) {\n    return errorResponse(MISSING_INTELLIGENCE_MESSAGE, 422);\n  }\n  try {\n    const body = await parseJsonBody(request);\n    if (isHandlerResponse(body)) return body;\n    const fields = parseMemoryBody(body);\n    if (isHandlerResponse(fields)) return fields;\n\n    const access = await resolveClientMemory(runtime, request);\n    if (isHandlerResponse(access)) return access;\n\n    const data = await runtime.intelligence.createMemory({\n      userId: access.user.id,\n      ...(runtime.memory ? { memoryGrant: access.grant } : {}),\n      ...fields,\n    });\n    return Response.json(data, { status: 201 });\n  } catch (error) {\n    logger.error({ err: error }, \"Error creating memory\");\n    return memoryErrorResponse(error, \"Failed to create memory\");\n  }\n}\n\n/**\n * Supersedes a memory (platform `PATCH /api/memories/:id`): retires `:id` and\n * inserts the new content atomically; the response carries `retiredId`.\n */\nexport async function handleUpdateMemory({\n  runtime,\n  request,\n  memoryId,\n}: MemoryMutationParams): Promise<Response> {\n  if (!isIntelligenceRuntime(runtime)) {\n    return errorResponse(MISSING_INTELLIGENCE_MESSAGE, 422);\n  }\n  try {\n    const body = await parseJsonBody(request);\n    if (isHandlerResponse(body)) return body;\n    const fields = parseMemoryBody(body);\n    if (isHandlerResponse(fields)) return fields;\n\n    const access = await resolveClientMemory(runtime, request);\n    if (isHandlerResponse(access)) return access;\n\n    const data = await runtime.intelligence.updateMemory({\n      userId: access.user.id,\n      ...(runtime.memory ? { memoryGrant: access.grant } : {}),\n      id: memoryId,\n      ...fields,\n    });\n    return Response.json(data);\n  } catch (error) {\n    logger.error({ err: error }, \"Error updating memory\");\n    return memoryErrorResponse(error, \"Failed to update memory\");\n  }\n}\n\n/**\n * Retires (forgets) a memory (platform `DELETE /api/memories/:id`). Non-lossy\n * on the platform side; returns 204.\n */\nexport async function handleRemoveMemory({\n  runtime,\n  request,\n  memoryId,\n}: MemoryMutationParams): Promise<Response> {\n  if (!isIntelligenceRuntime(runtime)) {\n    return errorResponse(MISSING_INTELLIGENCE_MESSAGE, 422);\n  }\n  try {\n    const access = await resolveClientMemory(runtime, request);\n    if (isHandlerResponse(access)) return access;\n\n    await runtime.intelligence.removeMemory({\n      userId: access.user.id,\n      id: memoryId,\n      ...(runtime.memory ? { memoryGrant: access.grant } : {}),\n    });\n    return new Response(null, { status: 204 });\n  } catch (error) {\n    logger.error({ err: error }, \"Error removing memory\");\n    return memoryErrorResponse(error, \"Failed to remove memory\");\n  }\n}\n"],"mappings":";;;;;;;;;AAoBA,eAAe,oBACb,SACA,SACA;CACA,MAAM,OAAO,MAAM,wBAAwB;EAAE;EAAS;EAAS,CAAC;AAChE,KAAI,kBAAkB,KAAK,CAAE,QAAO;CACpC,MAAM,SAAS,MAAM,iBAAiB,SAAS,SAAS,MAAM,SAAS;AACvE,KAAI,kBAAkB,OAAO,CAAE,QAAO;AAKtC,KAAI,QAAQ,UAAU,CAAC,kBAAkB,OAAO,MAAM,CACpD,QAAO,cAAc,wBAAwB,IAAI;AAEnD,QAAO;;AAGT,MAAM,+BACJ;;AAGF,MAAM,eAAoC,IAAI,IAAI;CAChD;CACA;CACA;CACD,CAAC;;AAEF,MAAM,gBAAqC,IAAI,IAAI,CAAC,QAAQ,UAAU,CAAC;;;;;;;;;;;;;AAcvE,SAAS,oBAAoB,OAAgB,SAA2B;AACtE,KAAI,iBAAiB,sBAAsB;EACzC,MAAM,EAAE,WAAW;AACnB,MAAI,OAAO,UAAU,OAAO,IAAI,UAAU,OAAO,UAAU,IACzD,QAAO,cAAc,SAAS,OAAO;AAEvC,SAAO,cAAc,SAAS,IAAI;;AAEpC,QAAO,cAAc,SAAS,IAAI;;AAGpC,eAAe,cACb,SAC6C;AAC7C,KAAI;AACF,SAAQ,MAAM,QAAQ,MAAM;UACrB,OAAO;AACd,SAAO,MAAM,EAAE,KAAK,OAAO,EAAE,wCAAwC;AACrE,SAAO,cAAc,wBAAwB,IAAI;;;;;;;AAQrD,SAAS,gBAAgB,MAOZ;CACX,MAAM,EAAE,SAAS,MAAM,OAAO,oBAAoB;AAClD,KAAI,OAAO,YAAY,YAAY,OAAO,SAAS,SACjD,QAAO,cAAc,+CAA+C,IAAI;AAI1E,KAAI,CAAC,aAAa,IAAI,KAAK,CACzB,QAAO,cACL,gEACA,IACD;AAIH,KAAI,UAAU,UAAa,OAAO,UAAU,SAC1C,QAAO,cAAc,iDAAiD,IAAI;AAG5E,KAAI,OAAO,UAAU,YAAY,CAAC,cAAc,IAAI,MAAM,CACxD,QAAO,cAAc,gDAAgD,IAAI;AAI3E,KACE,oBAAoB,WACnB,CAAC,MAAM,QAAQ,gBAAgB,IAC9B,CAAC,gBAAgB,OAAO,OAAO,OAAO,OAAO,SAAS,EAExD,QAAO,cACL,sEACA,IACD;AAEH,QAAO;EACL;EACA;EACA,GAAI,OAAO,UAAU,WAAW,EAAE,OAAO,GAAG,EAAE;EAC9C,GAAI,MAAM,QAAQ,gBAAgB,GAC9B,EAAmB,iBAA6B,GAChD,EAAE;EAEP;;;;;;;;AASH,SAAS,gBACP,MAC8D;CAC9D,MAAM,EAAE,OAAO,OAAO,UAAU;CAGhC,MAAM,eAAe,OAAO,UAAU,WAAW,MAAM,MAAM,GAAG;AAChE,KAAI,OAAO,iBAAiB,YAAY,aAAa,WAAW,EAC9D,QAAO,cAAc,8CAA8C,IAAI;AAMzE,KACE,UAAU,UACV,EAAE,OAAO,UAAU,YAAY,OAAO,UAAU,MAAM,IAAI,QAAQ,GAElE,QAAO,cAAc,6CAA6C,IAAI;AAExE,KAAI,UAAU,UAAa,OAAO,UAAU,SAC1C,QAAO,cAAc,iDAAiD,IAAI;AAE5E,KAAI,OAAO,UAAU,YAAY,CAAC,cAAc,IAAI,MAAM,CACxD,QAAO,cAAc,gDAAgD,IAAI;AAE3E,QAAO;EACL,OAAO;EACP,GAAI,OAAO,UAAU,WAAW,EAAE,OAAO,GAAG,EAAE;EAC9C,GAAI,OAAO,UAAU,WAAW,EAAE,OAAO,GAAG,EAAE;EAC/C;;;;;;;;;;;;;AAcH,eAAsB,mBAAmB,EACvC,SACA,WAC2C;AAC3C,KAAI,sBAAsB,QAAQ,CAChC,KAAI;EAEF,MAAM,qBADM,IAAI,IAAI,QAAQ,IAAI,CAE1B,aAAa,IAAI,qBAAqB,KAAK;EAEjD,MAAM,SAAS,MAAM,oBAAoB,SAAS,QAAQ;AAC1D,MAAI,kBAAkB,OAAO,CAAE,QAAO;EAEtC,MAAM,OAAO,MAAM,QAAQ,aAAa,aAAa;GACnD,QAAQ,OAAO,KAAK;GACpB,GAAI,QAAQ,SAAS,EAAE,aAAa,OAAO,OAAO,GAAG,EAAE;GACvD,GAAI,qBAAqB,EAAE,oBAAoB,MAAM,GAAG,EAAE;GAC3D,CAAC;AAOF,MACE,QAAQ,QACR,OAAO,SAAS,YAChB,CAAC,MAAM,QAAS,KAAgC,SAAS,EACzD;AACA,UAAO,MACL,EAAE,MAAM,EACR,wEACD;AACD,UAAO,cACL,qDACA,IACD;;AAGH,SAAO,SAAS,KAAK,KAAK;UACnB,OAAO;AACd,SAAO,MAAM,EAAE,KAAK,OAAO,EAAE,yBAAyB;AACtD,SAAO,oBAAoB,OAAO,0BAA0B;;AAIhE,QAAO,cAAc,8BAA8B,IAAI;;;;;;;;;;AAWzD,eAAsB,qBAAqB,EACzC,SACA,WAC2C;AAC3C,KAAI,CAAC,sBAAsB,QAAQ,CACjC,QAAO,cAAc,8BAA8B,IAAI;AAEzD,KAAI;EACF,MAAM,OAAO,MAAM,cAAc,QAAQ;AACzC,MAAI,kBAAkB,KAAK,CAAE,QAAO;EACpC,MAAM,SAAS,gBAAgB,KAAK;AACpC,MAAI,kBAAkB,OAAO,CAAE,QAAO;EAEtC,MAAM,SAAS,MAAM,oBAAoB,SAAS,QAAQ;AAC1D,MAAI,kBAAkB,OAAO,CAAE,QAAO;EAEtC,MAAM,OAAO,MAAM,QAAQ,aAAa,eAAe;GACrD,QAAQ,OAAO,KAAK;GACpB,GAAI,QAAQ,SAAS,EAAE,aAAa,OAAO,OAAO,GAAG,EAAE;GACvD,GAAG;GACJ,CAAC;AAEF,MACE,QAAQ,QACR,OAAO,SAAS,YAChB,CAAC,MAAM,QAAS,KAAgC,SAAS,EACzD;AACA,UAAO,MACL,EAAE,MAAM,EACR,0EACD;AACD,UAAO,cACL,uDACA,IACD;;AAEH,SAAO,SAAS,KAAK,KAAK;UACnB,OAAO;AACd,SAAO,MAAM,EAAE,KAAK,OAAO,EAAE,2BAA2B;AACxD,SAAO,oBAAoB,OAAO,4BAA4B;;;;;;;;;;;;;;;;;;AAmBlE,eAAsB,0BAA0B,EAC9C,SACA,WAC2C;AAC3C,KAAI,sBAAsB,QAAQ,CAChC,KAAI;EACF,MAAM,SAAS,MAAM,oBAAoB,SAAS,QAAQ;AAC1D,MAAI,kBAAkB,OAAO,CAAE,QAAO;EAEtC,MAAM,cAAc,MAAM,QAAQ,aAAa,qBAAqB;GAClE,QAAQ,OAAO,KAAK;GACpB,GAAI,QAAQ,SAAS,EAAE,aAAa,OAAO,OAAO,GAAG,EAAE;GACxD,CAAC;AAEF,SAAO,SAAS,KAAK;GACnB,GAAI,YAAY,cAAc,SAC1B,EAAE,WAAW,YAAY,WAAW,GACpC,EAAE;GACN,GAAI,YAAY,aAAa,SACzB,EAAE,UAAU,YAAY,UAAU,GAClC,EAAE;GAGN,GAAI,YAAY,qBAAqB,SACjC,EAAE,kBAAkB,YAAY,kBAAkB,GAClD,EAAE;GACN,GAAI,YAAY,oBAAoB,SAChC,EAAE,iBAAiB,YAAY,iBAAiB,GAChD,EAAE;GACP,CAAC;UACK,OAAO;AACd,SAAO,MAAM,EAAE,KAAK,OAAO,EAAE,gCAAgC;AAC7D,SAAO,oBAAoB,OAAO,kCAAkC;;AAIxE,QAAO,cAAc,8BAA8B,IAAI;;;;;;;AAQzD,eAAsB,mBAAmB,EACvC,SACA,WAC2C;AAC3C,KAAI,CAAC,sBAAsB,QAAQ,CACjC,QAAO,cAAc,8BAA8B,IAAI;AAEzD,KAAI;EACF,MAAM,OAAO,MAAM,cAAc,QAAQ;AACzC,MAAI,kBAAkB,KAAK,CAAE,QAAO;EACpC,MAAM,SAAS,gBAAgB,KAAK;AACpC,MAAI,kBAAkB,OAAO,CAAE,QAAO;EAEtC,MAAM,SAAS,MAAM,oBAAoB,SAAS,QAAQ;AAC1D,MAAI,kBAAkB,OAAO,CAAE,QAAO;EAEtC,MAAM,OAAO,MAAM,QAAQ,aAAa,aAAa;GACnD,QAAQ,OAAO,KAAK;GACpB,GAAI,QAAQ,SAAS,EAAE,aAAa,OAAO,OAAO,GAAG,EAAE;GACvD,GAAG;GACJ,CAAC;AACF,SAAO,SAAS,KAAK,MAAM,EAAE,QAAQ,KAAK,CAAC;UACpC,OAAO;AACd,SAAO,MAAM,EAAE,KAAK,OAAO,EAAE,wBAAwB;AACrD,SAAO,oBAAoB,OAAO,0BAA0B;;;;;;;AAQhE,eAAsB,mBAAmB,EACvC,SACA,SACA,YAC0C;AAC1C,KAAI,CAAC,sBAAsB,QAAQ,CACjC,QAAO,cAAc,8BAA8B,IAAI;AAEzD,KAAI;EACF,MAAM,OAAO,MAAM,cAAc,QAAQ;AACzC,MAAI,kBAAkB,KAAK,CAAE,QAAO;EACpC,MAAM,SAAS,gBAAgB,KAAK;AACpC,MAAI,kBAAkB,OAAO,CAAE,QAAO;EAEtC,MAAM,SAAS,MAAM,oBAAoB,SAAS,QAAQ;AAC1D,MAAI,kBAAkB,OAAO,CAAE,QAAO;EAEtC,MAAM,OAAO,MAAM,QAAQ,aAAa,aAAa;GACnD,QAAQ,OAAO,KAAK;GACpB,GAAI,QAAQ,SAAS,EAAE,aAAa,OAAO,OAAO,GAAG,EAAE;GACvD,IAAI;GACJ,GAAG;GACJ,CAAC;AACF,SAAO,SAAS,KAAK,KAAK;UACnB,OAAO;AACd,SAAO,MAAM,EAAE,KAAK,OAAO,EAAE,wBAAwB;AACrD,SAAO,oBAAoB,OAAO,0BAA0B;;;;;;;AAQhE,eAAsB,mBAAmB,EACvC,SACA,SACA,YAC0C;AAC1C,KAAI,CAAC,sBAAsB,QAAQ,CACjC,QAAO,cAAc,8BAA8B,IAAI;AAEzD,KAAI;EACF,MAAM,SAAS,MAAM,oBAAoB,SAAS,QAAQ;AAC1D,MAAI,kBAAkB,OAAO,CAAE,QAAO;AAEtC,QAAM,QAAQ,aAAa,aAAa;GACtC,QAAQ,OAAO,KAAK;GACpB,IAAI;GACJ,GAAI,QAAQ,SAAS,EAAE,aAAa,OAAO,OAAO,GAAG,EAAE;GACxD,CAAC;AACF,SAAO,IAAI,SAAS,MAAM,EAAE,QAAQ,KAAK,CAAC;UACnC,OAAO;AACd,SAAO,MAAM,EAAE,KAAK,OAAO,EAAE,wBAAwB;AACrD,SAAO,oBAAoB,OAAO,0BAA0B"}
+{"version":3,"file":"memories.mjs","names":[],"sources":["../../../../../src/v2/runtime/handlers/intelligence/memories.ts"],"sourcesContent":["import type {\n  CopilotIntelligenceRuntimeLike,\n  CopilotRuntimeLike,\n} from \"../../core/runtime\";\nimport { isIntelligenceRuntime } from \"../../core/runtime\";\nimport { logger } from \"@copilotkit/shared\";\nimport { errorResponse, isHandlerResponse } from \"../shared/json-response\";\nimport { resolveIntelligenceUser } from \"../shared/resolve-intelligence-user\";\nimport { grantAllowsMemory, resolveWebMemory } from \"../shared/memory-policy\";\nimport { platformErrorResponse } from \"../shared/platform-error\";\n\ninterface MemoriesHandlerParams {\n  runtime: CopilotRuntimeLike;\n  request: Request;\n}\n\ninterface MemoryMutationParams extends MemoriesHandlerParams {\n  memoryId: string;\n}\n\nasync function resolveClientMemory(\n  runtime: CopilotIntelligenceRuntimeLike,\n  request: Request,\n) {\n  const user = await resolveIntelligenceUser({ runtime, request });\n  if (isHandlerResponse(user)) return user;\n  const access = await resolveWebMemory(runtime, request, user, \"client\");\n  if (isHandlerResponse(access)) return access;\n  // Unlike an agent run — which proceeds without Memory tools when the policy\n  // grants nothing — these routes exist ONLY to serve memories. A caller who\n  // asked for them and may not have them gets 403; an empty list would imply\n  // there are none, which is a different and false claim.\n  if (runtime.memory && !grantAllowsMemory(access.grant)) {\n    return errorResponse(\"Memory access denied\", 403);\n  }\n  return access;\n}\n\nconst MISSING_INTELLIGENCE_MESSAGE =\n  \"Missing CopilotKitIntelligence configuration. Memory operations require a CopilotKitIntelligence instance to be provided in CopilotRuntime options.\";\n\n/** Allowed `kind` vocabulary the platform's memory endpoints accept. */\nconst MEMORY_KINDS: ReadonlySet<string> = new Set([\n  \"topical\",\n  \"episodic\",\n  \"operational\",\n]);\n/** Allowed `scope` vocabulary the platform's memory endpoints accept. */\nconst MEMORY_SCOPES: ReadonlySet<string> = new Set([\"user\", \"project\"]);\n\n/**\n * Maps a thrown error to a `Response`.\n *\n * The reasoning now lives with the implementation in\n * `../shared/platform-error`, which the thread handlers share. This alias is\n * kept so the many call sites below read the same as they always did.\n */\nconst memoryErrorResponse = platformErrorResponse;\n\nasync function parseJsonBody(\n  request: Request,\n): Promise<Record<string, unknown> | Response> {\n  try {\n    return (await request.json()) as Record<string, unknown>;\n  } catch (error) {\n    logger.error({ err: error }, \"Malformed JSON in memory request body\");\n    return errorResponse(\"Invalid request body\", 400);\n  }\n}\n\n/**\n * Extracts and validates the create/supersede body fields the platform's\n * memory endpoints require. Returns a `Response` (400) on invalid input.\n */\nfunction parseMemoryBody(body: Record<string, unknown>):\n  | {\n      content: string;\n      kind: string;\n      scope?: string;\n      sourceThreadIds?: string[];\n    }\n  | Response {\n  const { content, kind, scope, sourceThreadIds } = body;\n  if (typeof content !== \"string\" || typeof kind !== \"string\") {\n    return errorResponse(\"Memory requires string `content` and `kind`\", 400);\n  }\n  // `kind` must be one of the platform's known kinds. Reject an out-of-vocabulary\n  // value here rather than forwarding it for the platform to reject.\n  if (!MEMORY_KINDS.has(kind)) {\n    return errorResponse(\n      \"Memory `kind` must be one of: topical, episodic, operational\",\n      400,\n    );\n  }\n  // `scope` is optional: when omitted the platform applies its default\n  // (`\"user\"`). Only reject a present-but-wrong-typed scope.\n  if (scope !== undefined && typeof scope !== \"string\") {\n    return errorResponse(\"Memory `scope` must be a string when provided\", 400);\n  }\n  // When `scope` is present, it must be one of the known scopes.\n  if (typeof scope === \"string\" && !MEMORY_SCOPES.has(scope)) {\n    return errorResponse(\"Memory `scope` must be one of: user, project\", 400);\n  }\n  // `sourceThreadIds` is optional, but when present it must be a string array.\n  // Validate every element so non-string ids are not forwarded to the platform.\n  if (\n    sourceThreadIds !== undefined &&\n    (!Array.isArray(sourceThreadIds) ||\n      !sourceThreadIds.every((id) => typeof id === \"string\"))\n  ) {\n    return errorResponse(\n      \"Memory `sourceThreadIds` must be an array of strings when provided\",\n      400,\n    );\n  }\n  return {\n    content,\n    kind,\n    ...(typeof scope === \"string\" ? { scope } : {}),\n    ...(Array.isArray(sourceThreadIds)\n      ? { sourceThreadIds: sourceThreadIds as string[] }\n      : {}),\n    // `sourceThreadIds` elements are validated as strings above; the cast is safe.\n  };\n}\n\n/**\n * Validates the recall body: `query` required non-empty string (trimmed);\n * `limit` optional finite positive integer; `scope` optional and in the known\n * scopes. Returns a 400 Response on invalid input. The returned `query` is the\n * trimmed value so a whitespace-padded query is never forwarded to the platform.\n */\nfunction parseRecallBody(\n  body: Record<string, unknown>,\n): { query: string; limit?: number; scope?: string } | Response {\n  const { query, limit, scope } = body;\n  // Trim before the emptiness check so whitespace-only queries (e.g. \"   \")\n  // are rejected rather than forwarded as a useless query to the platform.\n  const trimmedQuery = typeof query === \"string\" ? query.trim() : query;\n  if (typeof trimmedQuery !== \"string\" || trimmedQuery.length === 0) {\n    return errorResponse(\"Recall requires a non-empty string `query`\", 400);\n  }\n  // When provided, `limit` must be a finite positive integer. `Number.isInteger`\n  // already rejects NaN, Infinity, and fractions (NaN/Infinity would otherwise\n  // JSON-serialize to `null` and silently corrupt the forwarded request);\n  // the `> 0` guard rejects zero and negatives.\n  if (\n    limit !== undefined &&\n    !(typeof limit === \"number\" && Number.isInteger(limit) && limit > 0)\n  ) {\n    return errorResponse(\"Recall `limit` must be a positive integer\", 400);\n  }\n  if (scope !== undefined && typeof scope !== \"string\") {\n    return errorResponse(\"Recall `scope` must be a string when provided\", 400);\n  }\n  if (typeof scope === \"string\" && !MEMORY_SCOPES.has(scope)) {\n    return errorResponse(\"Recall `scope` must be one of: user, project\", 400);\n  }\n  return {\n    query: trimmedQuery,\n    ...(typeof limit === \"number\" ? { limit } : {}),\n    ...(typeof scope === \"string\" ? { scope } : {}),\n  };\n}\n\n/**\n * Lists the resolved user's long-term memories via CopilotKit Intelligence.\n *\n * Mirrors {@link handleListThreads}: requires a `CopilotKitIntelligence`\n * runtime, resolves the user with `identifyUser` (never trusting a\n * client-supplied id), and proxies to the platform's `GET /api/memories`\n * with the project API key + resolved user. The `?includeInvalidated=true`\n * query is forwarded so callers can opt into retired rows. The response is\n * the platform's `{ memories }` envelope, which the client memory store\n * consumes directly.\n */\nexport async function handleListMemories({\n  runtime,\n  request,\n}: MemoriesHandlerParams): Promise<Response> {\n  if (isIntelligenceRuntime(runtime)) {\n    try {\n      const url = new URL(request.url);\n      const includeInvalidated =\n        url.searchParams.get(\"includeInvalidated\") === \"true\";\n\n      const access = await resolveClientMemory(runtime, request);\n      if (isHandlerResponse(access)) return access;\n\n      const data = await runtime.intelligence.listMemories({\n        userId: access.user.id,\n        ...(runtime.memory ? { memoryGrant: access.grant } : {}),\n        ...(includeInvalidated ? { includeInvalidated: true } : {}),\n      });\n\n      // The client memory store consumes the `{ memories: [...] }` envelope\n      // directly. Assert the shape before forwarding so a platform contract\n      // violation surfaces as a clear 502 (the runtime is healthy but its\n      // dependency returned the wrong shape) instead of a 200 the client will\n      // choke on.\n      if (\n        data == null ||\n        typeof data !== \"object\" ||\n        !Array.isArray((data as { memories?: unknown }).memories)\n      ) {\n        logger.error(\n          { data },\n          \"listMemories: platform returned a response without a `memories` array\",\n        );\n        return errorResponse(\n          \"Memory platform returned an invalid list response\",\n          502,\n        );\n      }\n\n      return Response.json(data);\n    } catch (error) {\n      logger.error({ err: error }, \"Error listing memories\");\n      return memoryErrorResponse(error, \"Failed to list memories\");\n    }\n  }\n\n  return errorResponse(MISSING_INTELLIGENCE_MESSAGE, 422);\n}\n\n/**\n * Semantically recalls the resolved user's memories via the platform (`POST\n * /api/memories/recall`, hybrid RAG). Mirrors {@link handleListMemories}:\n * requires a `CopilotKitIntelligence` runtime, resolves the user with\n * `identifyUser` (never a client-supplied id), proxies with the project API\n * key + resolved user. Body `{ query, limit?, scope? }`; response `{ memories }`,\n * each optionally carrying `score`.\n */\nexport async function handleRecallMemories({\n  runtime,\n  request,\n}: MemoriesHandlerParams): Promise<Response> {\n  if (!isIntelligenceRuntime(runtime)) {\n    return errorResponse(MISSING_INTELLIGENCE_MESSAGE, 422);\n  }\n  try {\n    const body = await parseJsonBody(request);\n    if (isHandlerResponse(body)) return body;\n    const fields = parseRecallBody(body);\n    if (isHandlerResponse(fields)) return fields;\n\n    const access = await resolveClientMemory(runtime, request);\n    if (isHandlerResponse(access)) return access;\n\n    const data = await runtime.intelligence.recallMemories({\n      userId: access.user.id,\n      ...(runtime.memory ? { memoryGrant: access.grant } : {}),\n      ...fields,\n    });\n\n    if (\n      data == null ||\n      typeof data !== \"object\" ||\n      !Array.isArray((data as { memories?: unknown }).memories)\n    ) {\n      logger.error(\n        { data },\n        \"recallMemories: platform returned a response without a `memories` array\",\n      );\n      return errorResponse(\n        \"Memory platform returned an invalid recall response\",\n        502,\n      );\n    }\n    return Response.json(data);\n  } catch (error) {\n    logger.error({ err: error }, \"Error recalling memories\");\n    return memoryErrorResponse(error, \"Failed to recall memories\");\n  }\n}\n\n/**\n * Mints memory-realtime join credentials (platform `POST\n * /api/memories/subscribe`). Mirrors {@link handleSubscribeToThreads}: requires\n * a `CopilotKitIntelligence` runtime and resolves the user with `identifyUser`\n * (never a client-supplied id). Returns `{ joinToken, joinCode }` — memory needs\n * the `joinCode` here (unlike threads, where it rides the thread-list response)\n * because the client builds the `user_meta:memories:<joinCode>` channel topic\n * from it.\n *\n * When the platform also resolves a project scope, the response additionally\n * carries `projectJoinToken` / `projectJoinCode`, which the client uses to open\n * a second `project_meta:memories:<projectJoinCode>` channel. These are\n * optional: absent project scope → both fields are omitted (silent-degrade\n * contract; the client opens only the user channel).\n */\nexport async function handleSubscribeToMemories({\n  runtime,\n  request,\n}: MemoriesHandlerParams): Promise<Response> {\n  if (isIntelligenceRuntime(runtime)) {\n    try {\n      const access = await resolveClientMemory(runtime, request);\n      if (isHandlerResponse(access)) return access;\n\n      const credentials = await runtime.intelligence.ɵsubscribeToMemories({\n        userId: access.user.id,\n        ...(runtime.memory ? { memoryGrant: access.grant } : {}),\n      });\n\n      return Response.json({\n        ...(credentials.joinToken !== undefined\n          ? { joinToken: credentials.joinToken }\n          : {}),\n        ...(credentials.joinCode !== undefined\n          ? { joinCode: credentials.joinCode }\n          : {}),\n        // Project-scoped credentials ride along only when the platform minted\n        // them; omit both when absent (silent-degrade contract).\n        ...(credentials.projectJoinToken !== undefined\n          ? { projectJoinToken: credentials.projectJoinToken }\n          : {}),\n        ...(credentials.projectJoinCode !== undefined\n          ? { projectJoinCode: credentials.projectJoinCode }\n          : {}),\n      });\n    } catch (error) {\n      logger.error({ err: error }, \"Error subscribing to memories\");\n      return memoryErrorResponse(error, \"Failed to subscribe to memories\");\n    }\n  }\n\n  return errorResponse(MISSING_INTELLIGENCE_MESSAGE, 422);\n}\n\n/**\n * Creates a memory for the resolved user (platform `POST /api/memories`).\n * Identity comes from `identifyUser`, never the request body. Returns 201\n * with the stored memory (the client store applies it server-authoritatively).\n */\nexport async function handleCreateMemory({\n  runtime,\n  request,\n}: MemoriesHandlerParams): Promise<Response> {\n  if (!isIntelligenceRuntime(runtime)) {\n    return errorResponse(MISSING_INTELLIGENCE_MESSAGE, 422);\n  }\n  try {\n    const body = await parseJsonBody(request);\n    if (isHandlerResponse(body)) return body;\n    const fields = parseMemoryBody(body);\n    if (isHandlerResponse(fields)) return fields;\n\n    const access = await resolveClientMemory(runtime, request);\n    if (isHandlerResponse(access)) return access;\n\n    const data = await runtime.intelligence.createMemory({\n      userId: access.user.id,\n      ...(runtime.memory ? { memoryGrant: access.grant } : {}),\n      ...fields,\n    });\n    return Response.json(data, { status: 201 });\n  } catch (error) {\n    logger.error({ err: error }, \"Error creating memory\");\n    return memoryErrorResponse(error, \"Failed to create memory\");\n  }\n}\n\n/**\n * Supersedes a memory (platform `PATCH /api/memories/:id`): retires `:id` and\n * inserts the new content atomically; the response carries `retiredId`.\n */\nexport async function handleUpdateMemory({\n  runtime,\n  request,\n  memoryId,\n}: MemoryMutationParams): Promise<Response> {\n  if (!isIntelligenceRuntime(runtime)) {\n    return errorResponse(MISSING_INTELLIGENCE_MESSAGE, 422);\n  }\n  try {\n    const body = await parseJsonBody(request);\n    if (isHandlerResponse(body)) return body;\n    const fields = parseMemoryBody(body);\n    if (isHandlerResponse(fields)) return fields;\n\n    const access = await resolveClientMemory(runtime, request);\n    if (isHandlerResponse(access)) return access;\n\n    const data = await runtime.intelligence.updateMemory({\n      userId: access.user.id,\n      ...(runtime.memory ? { memoryGrant: access.grant } : {}),\n      id: memoryId,\n      ...fields,\n    });\n    return Response.json(data);\n  } catch (error) {\n    logger.error({ err: error }, \"Error updating memory\");\n    return memoryErrorResponse(error, \"Failed to update memory\");\n  }\n}\n\n/**\n * Retires (forgets) a memory (platform `DELETE /api/memories/:id`). Non-lossy\n * on the platform side; returns 204.\n */\nexport async function handleRemoveMemory({\n  runtime,\n  request,\n  memoryId,\n}: MemoryMutationParams): Promise<Response> {\n  if (!isIntelligenceRuntime(runtime)) {\n    return errorResponse(MISSING_INTELLIGENCE_MESSAGE, 422);\n  }\n  try {\n    const access = await resolveClientMemory(runtime, request);\n    if (isHandlerResponse(access)) return access;\n\n    await runtime.intelligence.removeMemory({\n      userId: access.user.id,\n      id: memoryId,\n      ...(runtime.memory ? { memoryGrant: access.grant } : {}),\n    });\n    return new Response(null, { status: 204 });\n  } catch (error) {\n    logger.error({ err: error }, \"Error removing memory\");\n    return memoryErrorResponse(error, \"Failed to remove memory\");\n  }\n}\n"],"mappings":";;;;;;;;;AAoBA,eAAe,oBACb,SACA,SACA;CACA,MAAM,OAAO,MAAM,wBAAwB;EAAE;EAAS;EAAS,CAAC;AAChE,KAAI,kBAAkB,KAAK,CAAE,QAAO;CACpC,MAAM,SAAS,MAAM,iBAAiB,SAAS,SAAS,MAAM,SAAS;AACvE,KAAI,kBAAkB,OAAO,CAAE,QAAO;AAKtC,KAAI,QAAQ,UAAU,CAAC,kBAAkB,OAAO,MAAM,CACpD,QAAO,cAAc,wBAAwB,IAAI;AAEnD,QAAO;;AAGT,MAAM,+BACJ;;AAGF,MAAM,eAAoC,IAAI,IAAI;CAChD;CACA;CACA;CACD,CAAC;;AAEF,MAAM,gBAAqC,IAAI,IAAI,CAAC,QAAQ,UAAU,CAAC;;;;;;;;AASvE,MAAM,sBAAsB;AAE5B,eAAe,cACb,SAC6C;AAC7C,KAAI;AACF,SAAQ,MAAM,QAAQ,MAAM;UACrB,OAAO;AACd,SAAO,MAAM,EAAE,KAAK,OAAO,EAAE,wCAAwC;AACrE,SAAO,cAAc,wBAAwB,IAAI;;;;;;;AAQrD,SAAS,gBAAgB,MAOZ;CACX,MAAM,EAAE,SAAS,MAAM,OAAO,oBAAoB;AAClD,KAAI,OAAO,YAAY,YAAY,OAAO,SAAS,SACjD,QAAO,cAAc,+CAA+C,IAAI;AAI1E,KAAI,CAAC,aAAa,IAAI,KAAK,CACzB,QAAO,cACL,gEACA,IACD;AAIH,KAAI,UAAU,UAAa,OAAO,UAAU,SAC1C,QAAO,cAAc,iDAAiD,IAAI;AAG5E,KAAI,OAAO,UAAU,YAAY,CAAC,cAAc,IAAI,MAAM,CACxD,QAAO,cAAc,gDAAgD,IAAI;AAI3E,KACE,oBAAoB,WACnB,CAAC,MAAM,QAAQ,gBAAgB,IAC9B,CAAC,gBAAgB,OAAO,OAAO,OAAO,OAAO,SAAS,EAExD,QAAO,cACL,sEACA,IACD;AAEH,QAAO;EACL;EACA;EACA,GAAI,OAAO,UAAU,WAAW,EAAE,OAAO,GAAG,EAAE;EAC9C,GAAI,MAAM,QAAQ,gBAAgB,GAC9B,EAAmB,iBAA6B,GAChD,EAAE;EAEP;;;;;;;;AASH,SAAS,gBACP,MAC8D;CAC9D,MAAM,EAAE,OAAO,OAAO,UAAU;CAGhC,MAAM,eAAe,OAAO,UAAU,WAAW,MAAM,MAAM,GAAG;AAChE,KAAI,OAAO,iBAAiB,YAAY,aAAa,WAAW,EAC9D,QAAO,cAAc,8CAA8C,IAAI;AAMzE,KACE,UAAU,UACV,EAAE,OAAO,UAAU,YAAY,OAAO,UAAU,MAAM,IAAI,QAAQ,GAElE,QAAO,cAAc,6CAA6C,IAAI;AAExE,KAAI,UAAU,UAAa,OAAO,UAAU,SAC1C,QAAO,cAAc,iDAAiD,IAAI;AAE5E,KAAI,OAAO,UAAU,YAAY,CAAC,cAAc,IAAI,MAAM,CACxD,QAAO,cAAc,gDAAgD,IAAI;AAE3E,QAAO;EACL,OAAO;EACP,GAAI,OAAO,UAAU,WAAW,EAAE,OAAO,GAAG,EAAE;EAC9C,GAAI,OAAO,UAAU,WAAW,EAAE,OAAO,GAAG,EAAE;EAC/C;;;;;;;;;;;;;AAcH,eAAsB,mBAAmB,EACvC,SACA,WAC2C;AAC3C,KAAI,sBAAsB,QAAQ,CAChC,KAAI;EAEF,MAAM,qBADM,IAAI,IAAI,QAAQ,IAAI,CAE1B,aAAa,IAAI,qBAAqB,KAAK;EAEjD,MAAM,SAAS,MAAM,oBAAoB,SAAS,QAAQ;AAC1D,MAAI,kBAAkB,OAAO,CAAE,QAAO;EAEtC,MAAM,OAAO,MAAM,QAAQ,aAAa,aAAa;GACnD,QAAQ,OAAO,KAAK;GACpB,GAAI,QAAQ,SAAS,EAAE,aAAa,OAAO,OAAO,GAAG,EAAE;GACvD,GAAI,qBAAqB,EAAE,oBAAoB,MAAM,GAAG,EAAE;GAC3D,CAAC;AAOF,MACE,QAAQ,QACR,OAAO,SAAS,YAChB,CAAC,MAAM,QAAS,KAAgC,SAAS,EACzD;AACA,UAAO,MACL,EAAE,MAAM,EACR,wEACD;AACD,UAAO,cACL,qDACA,IACD;;AAGH,SAAO,SAAS,KAAK,KAAK;UACnB,OAAO;AACd,SAAO,MAAM,EAAE,KAAK,OAAO,EAAE,yBAAyB;AACtD,SAAO,oBAAoB,OAAO,0BAA0B;;AAIhE,QAAO,cAAc,8BAA8B,IAAI;;;;;;;;;;AAWzD,eAAsB,qBAAqB,EACzC,SACA,WAC2C;AAC3C,KAAI,CAAC,sBAAsB,QAAQ,CACjC,QAAO,cAAc,8BAA8B,IAAI;AAEzD,KAAI;EACF,MAAM,OAAO,MAAM,cAAc,QAAQ;AACzC,MAAI,kBAAkB,KAAK,CAAE,QAAO;EACpC,MAAM,SAAS,gBAAgB,KAAK;AACpC,MAAI,kBAAkB,OAAO,CAAE,QAAO;EAEtC,MAAM,SAAS,MAAM,oBAAoB,SAAS,QAAQ;AAC1D,MAAI,kBAAkB,OAAO,CAAE,QAAO;EAEtC,MAAM,OAAO,MAAM,QAAQ,aAAa,eAAe;GACrD,QAAQ,OAAO,KAAK;GACpB,GAAI,QAAQ,SAAS,EAAE,aAAa,OAAO,OAAO,GAAG,EAAE;GACvD,GAAG;GACJ,CAAC;AAEF,MACE,QAAQ,QACR,OAAO,SAAS,YAChB,CAAC,MAAM,QAAS,KAAgC,SAAS,EACzD;AACA,UAAO,MACL,EAAE,MAAM,EACR,0EACD;AACD,UAAO,cACL,uDACA,IACD;;AAEH,SAAO,SAAS,KAAK,KAAK;UACnB,OAAO;AACd,SAAO,MAAM,EAAE,KAAK,OAAO,EAAE,2BAA2B;AACxD,SAAO,oBAAoB,OAAO,4BAA4B;;;;;;;;;;;;;;;;;;AAmBlE,eAAsB,0BAA0B,EAC9C,SACA,WAC2C;AAC3C,KAAI,sBAAsB,QAAQ,CAChC,KAAI;EACF,MAAM,SAAS,MAAM,oBAAoB,SAAS,QAAQ;AAC1D,MAAI,kBAAkB,OAAO,CAAE,QAAO;EAEtC,MAAM,cAAc,MAAM,QAAQ,aAAa,qBAAqB;GAClE,QAAQ,OAAO,KAAK;GACpB,GAAI,QAAQ,SAAS,EAAE,aAAa,OAAO,OAAO,GAAG,EAAE;GACxD,CAAC;AAEF,SAAO,SAAS,KAAK;GACnB,GAAI,YAAY,cAAc,SAC1B,EAAE,WAAW,YAAY,WAAW,GACpC,EAAE;GACN,GAAI,YAAY,aAAa,SACzB,EAAE,UAAU,YAAY,UAAU,GAClC,EAAE;GAGN,GAAI,YAAY,qBAAqB,SACjC,EAAE,kBAAkB,YAAY,kBAAkB,GAClD,EAAE;GACN,GAAI,YAAY,oBAAoB,SAChC,EAAE,iBAAiB,YAAY,iBAAiB,GAChD,EAAE;GACP,CAAC;UACK,OAAO;AACd,SAAO,MAAM,EAAE,KAAK,OAAO,EAAE,gCAAgC;AAC7D,SAAO,oBAAoB,OAAO,kCAAkC;;AAIxE,QAAO,cAAc,8BAA8B,IAAI;;;;;;;AAQzD,eAAsB,mBAAmB,EACvC,SACA,WAC2C;AAC3C,KAAI,CAAC,sBAAsB,QAAQ,CACjC,QAAO,cAAc,8BAA8B,IAAI;AAEzD,KAAI;EACF,MAAM,OAAO,MAAM,cAAc,QAAQ;AACzC,MAAI,kBAAkB,KAAK,CAAE,QAAO;EACpC,MAAM,SAAS,gBAAgB,KAAK;AACpC,MAAI,kBAAkB,OAAO,CAAE,QAAO;EAEtC,MAAM,SAAS,MAAM,oBAAoB,SAAS,QAAQ;AAC1D,MAAI,kBAAkB,OAAO,CAAE,QAAO;EAEtC,MAAM,OAAO,MAAM,QAAQ,aAAa,aAAa;GACnD,QAAQ,OAAO,KAAK;GACpB,GAAI,QAAQ,SAAS,EAAE,aAAa,OAAO,OAAO,GAAG,EAAE;GACvD,GAAG;GACJ,CAAC;AACF,SAAO,SAAS,KAAK,MAAM,EAAE,QAAQ,KAAK,CAAC;UACpC,OAAO;AACd,SAAO,MAAM,EAAE,KAAK,OAAO,EAAE,wBAAwB;AACrD,SAAO,oBAAoB,OAAO,0BAA0B;;;;;;;AAQhE,eAAsB,mBAAmB,EACvC,SACA,SACA,YAC0C;AAC1C,KAAI,CAAC,sBAAsB,QAAQ,CACjC,QAAO,cAAc,8BAA8B,IAAI;AAEzD,KAAI;EACF,MAAM,OAAO,MAAM,cAAc,QAAQ;AACzC,MAAI,kBAAkB,KAAK,CAAE,QAAO;EACpC,MAAM,SAAS,gBAAgB,KAAK;AACpC,MAAI,kBAAkB,OAAO,CAAE,QAAO;EAEtC,MAAM,SAAS,MAAM,oBAAoB,SAAS,QAAQ;AAC1D,MAAI,kBAAkB,OAAO,CAAE,QAAO;EAEtC,MAAM,OAAO,MAAM,QAAQ,aAAa,aAAa;GACnD,QAAQ,OAAO,KAAK;GACpB,GAAI,QAAQ,SAAS,EAAE,aAAa,OAAO,OAAO,GAAG,EAAE;GACvD,IAAI;GACJ,GAAG;GACJ,CAAC;AACF,SAAO,SAAS,KAAK,KAAK;UACnB,OAAO;AACd,SAAO,MAAM,EAAE,KAAK,OAAO,EAAE,wBAAwB;AACrD,SAAO,oBAAoB,OAAO,0BAA0B;;;;;;;AAQhE,eAAsB,mBAAmB,EACvC,SACA,SACA,YAC0C;AAC1C,KAAI,CAAC,sBAAsB,QAAQ,CACjC,QAAO,cAAc,8BAA8B,IAAI;AAEzD,KAAI;EACF,MAAM,SAAS,MAAM,oBAAoB,SAAS,QAAQ;AAC1D,MAAI,kBAAkB,OAAO,CAAE,QAAO;AAEtC,QAAM,QAAQ,aAAa,aAAa;GACtC,QAAQ,OAAO,KAAK;GACpB,IAAI;GACJ,GAAI,QAAQ,SAAS,EAAE,aAAa,OAAO,OAAO,GAAG,EAAE;GACxD,CAAC;AACF,SAAO,IAAI,SAAS,MAAM,EAAE,QAAQ,KAAK,CAAC;UACnC,OAAO;AACd,SAAO,MAAM,EAAE,KAAK,OAAO,EAAE,wBAAwB;AACrD,SAAO,oBAAoB,OAAO,0BAA0B"}

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

@@ -3,6 +3,7 @@ const require_runtime = require('../../../../_virtual/_rolldown/runtime.cjs');
 const require_telemetry_client = require('../../telemetry/telemetry-client.cjs');
 const require_runtime_error_reporter = require('../../core/runtime-error-reporter.cjs');
 const require_learning = require('../../core/learning.cjs');
+const require_thread_lock_heartbeat = require('../../intelligence-platform/thread-lock-heartbeat.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');
@@ -35,6 +36,8 @@ async function handleIntelligenceRun({ runtime, request, agentId, agent, input,
 	});
 	if (require_json_response.isHandlerResponse(user)) return user;
 	const userId = user.id;
+	const proxyRequest = input.forwardedProps?.__proxiedMCPRequest;
+	const isDirectResourceRead = input.forwardedProps?.__copilotkitMcpResourceReadOnly === true && proxyRequest && typeof proxyRequest === "object" && proxyRequest.method === "resources/read";
 	let learningContainerId;
 	try {
 		const selector = runtime.intelligence.ɵgetLearningContainerId?.();
@@ -55,13 +58,16 @@ async function handleIntelligenceRun({ runtime, request, agentId, agent, input,
 		_copilotkit_shared.logger.error("Failed to resolve Learning Container:", error);
 		return Response.json({ error: "Failed to resolve Learning Container" }, { status: 500 });
 	}
+	let thread;
 	try {
-		const { thread, created } = await runtime.intelligence.getOrCreateThread({
+		const initialized = await runtime.intelligence.getOrCreateThread({
 			threadId: input.threadId,
 			userId,
 			agentId,
 			...learningContainerId !== void 0 ? { learningContainerId } : {}
 		});
+		thread = initialized.thread;
+		const { created } = initialized;
 		if (created && runtime.generateThreadNames && !thread.name?.trim()) require_thread_names.generateThreadNameForNewThread({
 			runtime,
 			request,
@@ -77,11 +83,34 @@ async function handleIntelligenceRun({ runtime, request, agentId, agent, input,
 		const platformStatus = require_intelligence_utils.getPlatformErrorStatus(error);
 		return Response.json({ error: "Failed to initialize thread" }, { status: platformStatus !== void 0 && platformStatus >= 400 && platformStatus < 500 ? platformStatus : 502 });
 	}
+	if (isDirectResourceRead) try {
+		if (thread.agentId && thread.agentId !== agentId) return Response.json({ error: "Thread belongs to another agent" }, { status: 403 });
+		agent.threadId = thread.id;
+		const run = await agent.runAgent({
+			runId: input.runId,
+			tools: input.tools,
+			context: input.context,
+			forwardedProps: input.forwardedProps
+		});
+		return Response.json({
+			kind: "mcp-resource-read",
+			threadId: thread.id,
+			runId: input.runId,
+			result: run.result ?? null
+		});
+	} catch (error) {
+		_copilotkit_shared.logger.error("MCP resource read failed:", error);
+		const status = require_intelligence_utils.getPlatformErrorStatus(error);
+		return Response.json({ error: "MCP resource read failed" }, { status: status && status >= 400 && status < 500 ? status : 502 });
+	}
 	let canonicalThreadId = input.threadId;
 	let canonicalRunId = input.runId;
 	let joinToken;
 	let backendThreadId;
+	let lockTtlSeconds;
+	let lockRequestedAt = 0;
 	try {
+		lockRequestedAt = Date.now();
 		const lockResult = await runtime.intelligence.ɵacquireThreadLock({
 			supportsBackendThreadId: true,
 			threadId: input.threadId,
@@ -96,6 +125,7 @@ async function handleIntelligenceRun({ runtime, request, agentId, agent, input,
 		canonicalRunId = lockResult.runId;
 		joinToken = lockResult.joinToken;
 		backendThreadId = lockResult.backendThreadId;
+		lockTtlSeconds = lockResult.ttlSeconds;
 	} catch (error) {
 		_copilotkit_shared.logger.error("Thread lock denied:", error);
 		const platformStatus = require_intelligence_utils.getPlatformErrorStatus(error);
@@ -136,31 +166,28 @@ async function handleIntelligenceRun({ runtime, request, agentId, agent, input,
 		return Response.json({ error: "Thread history lookup failed" }, { status: 502 });
 	}
 	runtimeTelemetry.capture("oss.runtime.agent_execution_stream_started", {});
-	let heartbeatStopped = false;
-	let heartbeatTimer;
-	heartbeatTimer = setInterval(() => {
-		runtime.intelligence.ɵrenewThreadLock({
+	const heartbeat = require_thread_lock_heartbeat.startThreadLockHeartbeat({
+		renew: (signal) => runtime.intelligence.ɵrenewThreadLock({
 			threadId: canonicalThreadId,
 			runId: canonicalRunId,
 			ttlSeconds: runtime.lockTtlSeconds,
-			...runtime.lockKeyPrefix !== void 0 ? { lockKeyPrefix: runtime.lockKeyPrefix } : {}
-		}).catch((err) => {
-			if (heartbeatStopped) return;
+			...runtime.lockKeyPrefix !== void 0 ? { lockKeyPrefix: runtime.lockKeyPrefix } : {},
+			signal
+		}),
+		intervalMs: runtime.lockHeartbeatIntervalSeconds * 1e3,
+		fallbackTtlSeconds: runtime.lockTtlSeconds,
+		initialTtlSeconds: lockTtlSeconds === void 0 ? void 0 : lockTtlSeconds - (Date.now() - lockRequestedAt) / 1e3,
+		onLost: (err) => {
 			_copilotkit_shared.logger.error("Failed to renew thread lock:", err);
-			clearHeartbeat();
 			try {
 				agent.abortRun();
 			} catch (abortError) {
 				_copilotkit_shared.logger.error("Failed to abort agent after lock renewal failure:", abortError);
 			}
-		});
-	}, runtime.lockHeartbeatIntervalSeconds * 1e3);
-	const clearHeartbeat = () => {
-		heartbeatStopped = true;
-		if (heartbeatTimer !== void 0) {
-			clearInterval(heartbeatTimer);
-			heartbeatTimer = void 0;
 		}
+	});
+	const clearHeartbeat = () => {
+		heartbeat.stop();
 	};
 	const runStarted = { current: false };
 	let immediateStartupErrorMessage;

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

@@ -1 +1 @@
-{"version":3,"file":"run.cjs","names":["telemetry","resolveIntelligenceUser","isHandlerResponse","resolveLearningContainerSelector","resolveLearningContainerId","generateThreadNameForNewThread","getPlatformErrorStatus","getRuntimeErrorReporter","EventType"],"sources":["../../../../../src/v2/runtime/handlers/intelligence/run.ts"],"sourcesContent":["import type {\n  AbstractAgent,\n  BaseEvent,\n  Message,\n  RunAgentInput,\n} from \"@ag-ui/client\";\nimport { EventType } from \"@ag-ui/client\";\nimport type { CopilotIntelligenceRuntimeLike } from \"../../core/runtime\";\nimport { generateThreadNameForNewThread } from \"./thread-names\";\nimport { logger } from \"@copilotkit/shared\";\nimport { telemetry } from \"../../telemetry\";\nimport { resolveIntelligenceUser } from \"../shared/resolve-intelligence-user\";\nimport { isHandlerResponse } from \"../shared/json-response\";\nimport type { AgentRunnerRunRequest } from \"../../runner/agent-runner\";\nimport type { Observable } from \"rxjs\";\nimport { getRuntimeErrorReporter } from \"../../core/runtime-error-reporter\";\nimport type { RuntimeErrorPhase } from \"../../core/runtime-error-reporter\";\nimport {\n  resolveLearningContainerId,\n  resolveLearningContainerSelector,\n} from \"../../core/learning\";\nimport { getPlatformErrorStatus } from \"../shared/intelligence-utils\";\n\n/**\n * Builds browser-facing realtime connection metadata owned by the runtime.\n */\nfunction buildRealtimeConnectionInfo(params: {\n  clientUrl: string;\n  threadId: string;\n}): { clientUrl: string; topic: string } {\n  return {\n    clientUrl: params.clientUrl,\n    topic: `thread:${params.threadId}`,\n  };\n}\n\ninterface RunnerStartupBoundary {\n  events: Observable<BaseEvent>;\n  startup: Promise<void>;\n}\n\ninterface RunnerWithStartupBoundary {\n  runWithStartupBoundary(request: AgentRunnerRunRequest): RunnerStartupBoundary;\n}\n\nfunction hasRunnerStartupBoundary(\n  runner: CopilotIntelligenceRuntimeLike[\"runner\"],\n): runner is CopilotIntelligenceRuntimeLike[\"runner\"] &\n  RunnerWithStartupBoundary {\n  const candidate = runner as { runWithStartupBoundary?: unknown };\n\n  return (\n    typeof candidate.runWithStartupBoundary === \"function\" &&\n    (Object.prototype.hasOwnProperty.call(runner, \"runWithStartupBoundary\") ||\n      Object.prototype.hasOwnProperty.call(runner, \"threads\"))\n  );\n}\n\ninterface HandleIntelligenceRunParams {\n  runtime: CopilotIntelligenceRuntimeLike;\n  request: Request;\n  agentId: string;\n  agent: AbstractAgent;\n  input: RunAgentInput;\n  startTime?: number;\n}\n\nexport async function handleIntelligenceRun({\n  runtime,\n  request,\n  agentId,\n  agent,\n  input,\n  startTime,\n}: HandleIntelligenceRunParams): Promise<Response> {\n  const runtimeTelemetry = runtime.telemetry ?? telemetry;\n\n  if (!runtime.intelligence) {\n    return Response.json(\n      {\n        error: \"Intelligence not configured\",\n        message: \"Intelligence mode requires a CopilotKitIntelligence\",\n      },\n      { status: 500 },\n    );\n  }\n\n  const user = await resolveIntelligenceUser({ runtime, request });\n  if (isHandlerResponse(user)) {\n    return user;\n  }\n  const userId = user.id;\n\n  let learningContainerId: string | undefined;\n  try {\n    const selector = runtime.intelligence.ɵgetLearningContainerId?.();\n    learningContainerId = selector\n      ? await resolveLearningContainerSelector(selector, {\n          surface: \"web\",\n          user,\n          agentId,\n          input,\n        })\n      : await resolveLearningContainerId(runtime.learning, {\n          surface: \"web\",\n          request,\n          threadId: input.threadId,\n          runId: input.runId,\n          agentId,\n          userId,\n        });\n  } catch (error) {\n    logger.error(\"Failed to resolve Learning Container:\", error);\n    return Response.json(\n      { error: \"Failed to resolve Learning Container\" },\n      { status: 500 },\n    );\n  }\n\n  try {\n    const { thread, created } = await runtime.intelligence.getOrCreateThread({\n      threadId: input.threadId,\n      userId,\n      agentId,\n      ...(learningContainerId !== undefined ? { learningContainerId } : {}),\n    });\n\n    if (created && runtime.generateThreadNames && !thread.name?.trim()) {\n      void generateThreadNameForNewThread({\n        runtime,\n        request,\n        agentId,\n        sourceInput: input,\n        thread,\n        userId,\n      }).catch((nameError) => {\n        logger.error(\"Failed to generate thread name:\", nameError);\n      });\n    }\n  } catch (error) {\n    logger.error(\"Failed to get or create thread:\", error);\n    const platformStatus = getPlatformErrorStatus(error);\n    return Response.json(\n      {\n        error: \"Failed to initialize thread\",\n      },\n      {\n        status:\n          platformStatus !== undefined &&\n          platformStatus >= 400 &&\n          platformStatus < 500\n            ? platformStatus\n            : 502,\n      },\n    );\n  }\n\n  let canonicalThreadId = input.threadId;\n  let canonicalRunId = input.runId;\n  let joinToken: string | undefined;\n  let backendThreadId: string | undefined;\n  try {\n    const lockResult = await runtime.intelligence.ɵacquireThreadLock({\n      supportsBackendThreadId: true,\n      threadId: input.threadId,\n      runId: input.runId,\n      userId,\n      agentId,\n      ...(learningContainerId !== undefined ? { learningContainerId } : {}),\n      ...(runtime.lockKeyPrefix !== undefined\n        ? { lockKeyPrefix: runtime.lockKeyPrefix }\n        : {}),\n      ttlSeconds: runtime.lockTtlSeconds,\n    });\n    canonicalThreadId = lockResult.threadId;\n    canonicalRunId = lockResult.runId;\n    joinToken = lockResult.joinToken;\n    backendThreadId = lockResult.backendThreadId;\n  } catch (error) {\n    logger.error(\"Thread lock denied:\", error);\n    const platformStatus = getPlatformErrorStatus(error);\n    return Response.json(\n      {\n        error: \"Thread lock denied\",\n      },\n      {\n        status: platformStatus === 409 ? 409 : 502,\n      },\n    );\n  }\n\n  const cleanupLock = (reason: string): Promise<void> =>\n    runtime.intelligence\n      .ɵcleanupThreadLock({\n        threadId: canonicalThreadId || input.threadId,\n        runId: canonicalRunId || input.runId,\n      })\n      .catch((cleanupError) => {\n        logger.error(\n          { err: cleanupError, reason },\n          \"Failed to cleanup thread lock\",\n        );\n      });\n\n  if (!canonicalThreadId || !canonicalRunId || !joinToken) {\n    await cleanupLock(\"malformed-lock-response\");\n    return Response.json(\n      {\n        error: \"Run connection credentials not available\",\n        message:\n          \"Intelligence platform did not return canonical threadId, runId, and joinToken\",\n      },\n      { status: 502 },\n    );\n  }\n\n  const canonicalInput: RunAgentInput = {\n    ...input,\n    threadId: canonicalThreadId,\n    runId: canonicalRunId,\n  };\n\n  let persistedInputMessages: Message[] | undefined;\n  if (Array.isArray(input.messages)) {\n    try {\n      const history = await runtime.intelligence.getThreadMessages({\n        threadId: canonicalThreadId,\n        userId,\n      });\n      const historicMessageIds = new Set(\n        history.messages.map((message) => message.id),\n      );\n      persistedInputMessages = input.messages.filter(\n        (message) => !historicMessageIds.has(message.id),\n      );\n    } catch (error) {\n      logger.error(\"Thread history lookup failed:\", error);\n      await cleanupLock(\"thread-history-lookup-failed\");\n      return Response.json(\n        {\n          error: \"Thread history lookup failed\",\n        },\n        { status: 502 },\n      );\n    }\n  }\n\n  runtimeTelemetry.capture(\"oss.runtime.agent_execution_stream_started\", {});\n\n  // Start heartbeat timer to renew the thread lock.\n  let heartbeatStopped = false;\n  let heartbeatTimer: ReturnType<typeof setInterval> | undefined;\n  heartbeatTimer = setInterval(() => {\n    runtime.intelligence\n      .ɵrenewThreadLock({\n        threadId: canonicalThreadId,\n        runId: canonicalRunId,\n        ttlSeconds: runtime.lockTtlSeconds,\n        ...(runtime.lockKeyPrefix !== undefined\n          ? { lockKeyPrefix: runtime.lockKeyPrefix }\n          : {}),\n      })\n      .catch((err) => {\n        if (heartbeatStopped) {\n          return;\n        }\n\n        logger.error(\"Failed to renew thread lock:\", err);\n        clearHeartbeat();\n        try {\n          agent.abortRun();\n        } catch (abortError) {\n          logger.error(\n            \"Failed to abort agent after lock renewal failure:\",\n            abortError,\n          );\n        }\n      });\n  }, runtime.lockHeartbeatIntervalSeconds * 1_000);\n\n  const clearHeartbeat = () => {\n    heartbeatStopped = true;\n    if (heartbeatTimer !== undefined) {\n      clearInterval(heartbeatTimer);\n      heartbeatTimer = undefined;\n    }\n  };\n\n  const runStarted = { current: false };\n  let immediateStartupErrorMessage: string | undefined;\n  let immediateStartupCleanup: Promise<void> | undefined;\n\n  const runRequest: AgentRunnerRunRequest = {\n    threadId: canonicalThreadId,\n    ...(backendThreadId === undefined ? {} : { backendThreadId }),\n    agent,\n    input: canonicalInput,\n    ...(persistedInputMessages !== undefined ? { persistedInputMessages } : {}),\n  };\n\n  const runtimeErrorReporter = getRuntimeErrorReporter(runtime);\n  let agentErrorReported = false;\n  const reportAgentError = (error: unknown, phase: RuntimeErrorPhase) => {\n    if (agentErrorReported) return;\n    agentErrorReported = true;\n    // Analytics describes the outcome; only the application-owned reporter\n    // receives diagnostics that may contain customer or upstream content.\n    runtimeTelemetry.capture(\"oss.runtime.agent_execution_stream_errored\", {\n      error: \"AGENT_EXECUTION_FAILED\",\n    });\n    runtimeErrorReporter?.report({\n      request,\n      error,\n      operation: \"agent.run\",\n      agentId,\n      threadId: canonicalThreadId,\n      runId: canonicalRunId,\n      phase,\n      startTime,\n    });\n  };\n\n  try {\n    const runStart = hasRunnerStartupBoundary(runtime.runner)\n      ? runtime.runner.runWithStartupBoundary(runRequest)\n      : {\n          events: runtime.runner.run(runRequest),\n          startup: Promise.resolve(),\n        };\n\n    runStart.events.subscribe({\n      next: (event: BaseEvent) => {\n        if (event.type === EventType.RUN_STARTED) {\n          runStarted.current = true;\n        }\n        if (event.type === EventType.RUN_ERROR) {\n          const message =\n            \"message\" in event && typeof event.message === \"string\"\n              ? event.message\n              : \"Runner failed before the run started\";\n          reportAgentError(\n            new Error(message),\n            runStarted.current\n              ? \"intelligence.subscription\"\n              : \"intelligence.startup\",\n          );\n          if (!runStarted.current) {\n            clearHeartbeat();\n            immediateStartupErrorMessage = message;\n            immediateStartupCleanup = cleanupLock(\"runner-start-failed\");\n          }\n        }\n      },\n      error: (error) => {\n        reportAgentError(\n          error,\n          runStarted.current\n            ? \"intelligence.subscription\"\n            : \"intelligence.startup\",\n        );\n        clearHeartbeat();\n        if (!runStarted.current) {\n          immediateStartupErrorMessage =\n            error instanceof Error ? error.message : String(error);\n          immediateStartupCleanup = cleanupLock(\"runner-start-error\");\n        } else {\n          cleanupLock(\"runner-error\");\n        }\n        logger.error(\"Error running agent:\", error);\n      },\n      complete: () => {\n        clearHeartbeat();\n        // Preserve the existing completion count even when the stream contains\n        // RUN_ERROR. Failure reporting is separate and carries only a safe code.\n        runtimeTelemetry.capture(\n          \"oss.runtime.agent_execution_stream_ended\",\n          {},\n        );\n      },\n    });\n\n    await runStart.startup;\n  } catch (error) {\n    reportAgentError(error, \"intelligence.startup\");\n    clearHeartbeat();\n    await (immediateStartupCleanup ?? cleanupLock(\"runner-start-threw\"));\n    logger.error(\"Error starting agent runner:\", error);\n    return Response.json(\n      {\n        error: \"Failed to start runner\",\n        message: error instanceof Error ? error.message : String(error),\n      },\n      { status: 502 },\n    );\n  }\n\n  if (immediateStartupErrorMessage) {\n    await immediateStartupCleanup;\n    return Response.json(\n      {\n        error: \"Failed to start runner\",\n        message: immediateStartupErrorMessage,\n      },\n      { status: 502 },\n    );\n  }\n\n  // IntelligenceAgentRunner resolves this boundary after Phoenix channel join.\n  // Other runner implementations fall back to construction/subscription errors.\n  return Response.json(\n    {\n      threadId: canonicalThreadId,\n      runId: canonicalRunId,\n      joinToken,\n      realtime: buildRealtimeConnectionInfo({\n        clientUrl: runtime.intelligence.ɵgetClientWsUrl(),\n        threadId: canonicalThreadId,\n      }),\n    },\n    {\n      headers: { \"Cache-Control\": \"no-cache\" },\n    },\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"run.cjs","names":["telemetry","resolveIntelligenceUser","isHandlerResponse","resolveLearningContainerSelector","resolveLearningContainerId","generateThreadNameForNewThread","getPlatformErrorStatus","startThreadLockHeartbeat","getRuntimeErrorReporter","EventType"],"sources":["../../../../../src/v2/runtime/handlers/intelligence/run.ts"],"sourcesContent":["import type {\n  AbstractAgent,\n  BaseEvent,\n  Message,\n  RunAgentInput,\n} from \"@ag-ui/client\";\nimport { EventType } from \"@ag-ui/client\";\nimport type { CopilotIntelligenceRuntimeLike } from \"../../core/runtime\";\nimport { generateThreadNameForNewThread } from \"./thread-names\";\nimport { logger } from \"@copilotkit/shared\";\nimport { telemetry } from \"../../telemetry\";\nimport { resolveIntelligenceUser } from \"../shared/resolve-intelligence-user\";\nimport { isHandlerResponse } from \"../shared/json-response\";\nimport type { AgentRunnerRunRequest } from \"../../runner/agent-runner\";\nimport type { Observable } from \"rxjs\";\nimport { getRuntimeErrorReporter } from \"../../core/runtime-error-reporter\";\nimport type { RuntimeErrorPhase } from \"../../core/runtime-error-reporter\";\nimport {\n  resolveLearningContainerId,\n  resolveLearningContainerSelector,\n} from \"../../core/learning\";\nimport { getPlatformErrorStatus } from \"../shared/intelligence-utils\";\nimport { startThreadLockHeartbeat } from \"../../intelligence-platform/thread-lock-heartbeat\";\nimport type { ThreadSummary } from \"../../intelligence-platform\";\n\n/**\n * Builds browser-facing realtime connection metadata owned by the runtime.\n */\nfunction buildRealtimeConnectionInfo(params: {\n  clientUrl: string;\n  threadId: string;\n}): { clientUrl: string; topic: string } {\n  return {\n    clientUrl: params.clientUrl,\n    topic: `thread:${params.threadId}`,\n  };\n}\n\ninterface RunnerStartupBoundary {\n  events: Observable<BaseEvent>;\n  startup: Promise<void>;\n}\n\ninterface RunnerWithStartupBoundary {\n  runWithStartupBoundary(request: AgentRunnerRunRequest): RunnerStartupBoundary;\n}\n\nfunction hasRunnerStartupBoundary(\n  runner: CopilotIntelligenceRuntimeLike[\"runner\"],\n): runner is CopilotIntelligenceRuntimeLike[\"runner\"] &\n  RunnerWithStartupBoundary {\n  const candidate = runner as { runWithStartupBoundary?: unknown };\n\n  return (\n    typeof candidate.runWithStartupBoundary === \"function\" &&\n    (Object.prototype.hasOwnProperty.call(runner, \"runWithStartupBoundary\") ||\n      Object.prototype.hasOwnProperty.call(runner, \"threads\"))\n  );\n}\n\ninterface HandleIntelligenceRunParams {\n  runtime: CopilotIntelligenceRuntimeLike;\n  request: Request;\n  agentId: string;\n  agent: AbstractAgent;\n  input: RunAgentInput;\n  startTime?: number;\n}\n\nexport async function handleIntelligenceRun({\n  runtime,\n  request,\n  agentId,\n  agent,\n  input,\n  startTime,\n}: HandleIntelligenceRunParams): Promise<Response> {\n  const runtimeTelemetry = runtime.telemetry ?? telemetry;\n\n  if (!runtime.intelligence) {\n    return Response.json(\n      {\n        error: \"Intelligence not configured\",\n        message: \"Intelligence mode requires a CopilotKitIntelligence\",\n      },\n      { status: 500 },\n    );\n  }\n\n  const user = await resolveIntelligenceUser({ runtime, request });\n  if (isHandlerResponse(user)) {\n    return user;\n  }\n  const userId = user.id;\n\n  const proxyRequest = (\n    input.forwardedProps as Record<string, unknown> | undefined\n  )?.__proxiedMCPRequest;\n  const isDirectResourceRead =\n    input.forwardedProps?.__copilotkitMcpResourceReadOnly === true &&\n    proxyRequest &&\n    typeof proxyRequest === \"object\" &&\n    (proxyRequest as { method?: unknown }).method === \"resources/read\";\n\n  let learningContainerId: string | undefined;\n  try {\n    const selector = runtime.intelligence.ɵgetLearningContainerId?.();\n    learningContainerId = selector\n      ? await resolveLearningContainerSelector(selector, {\n          surface: \"web\",\n          user,\n          agentId,\n          input,\n        })\n      : await resolveLearningContainerId(runtime.learning, {\n          surface: \"web\",\n          request,\n          threadId: input.threadId,\n          runId: input.runId,\n          agentId,\n          userId,\n        });\n  } catch (error) {\n    logger.error(\"Failed to resolve Learning Container:\", error);\n    return Response.json(\n      { error: \"Failed to resolve Learning Container\" },\n      { status: 500 },\n    );\n  }\n\n  let thread: ThreadSummary;\n  try {\n    const initialized = await runtime.intelligence.getOrCreateThread({\n      threadId: input.threadId,\n      userId,\n      agentId,\n      ...(learningContainerId !== undefined ? { learningContainerId } : {}),\n    });\n    thread = initialized.thread;\n    const { created } = initialized;\n\n    if (created && runtime.generateThreadNames && !thread.name?.trim()) {\n      void generateThreadNameForNewThread({\n        runtime,\n        request,\n        agentId,\n        sourceInput: input,\n        thread,\n        userId,\n      }).catch((nameError) => {\n        logger.error(\"Failed to generate thread name:\", nameError);\n      });\n    }\n  } catch (error) {\n    logger.error(\"Failed to get or create thread:\", error);\n    const platformStatus = getPlatformErrorStatus(error);\n    return Response.json(\n      {\n        error: \"Failed to initialize thread\",\n      },\n      {\n        status:\n          platformStatus !== undefined &&\n          platformStatus >= 400 &&\n          platformStatus < 500\n            ? platformStatus\n            : 502,\n      },\n    );\n  }\n\n  // MCP App resources are presentation data. Initialize the thread through the\n  // usual path, then fetch without claiming its mutation lock so an approval\n  // can continue while the resource server is still answering.\n  if (isDirectResourceRead) {\n    try {\n      if (thread.agentId && thread.agentId !== agentId) {\n        return Response.json(\n          { error: \"Thread belongs to another agent\" },\n          { status: 403 },\n        );\n      }\n      agent.threadId = thread.id;\n      const run = await agent.runAgent({\n        runId: input.runId,\n        tools: input.tools,\n        context: input.context,\n        forwardedProps: input.forwardedProps,\n      });\n      return Response.json({\n        kind: \"mcp-resource-read\",\n        threadId: thread.id,\n        runId: input.runId,\n        result: run.result ?? null,\n      });\n    } catch (error) {\n      logger.error(\"MCP resource read failed:\", error);\n      const status = getPlatformErrorStatus(error);\n      return Response.json(\n        { error: \"MCP resource read failed\" },\n        { status: status && status >= 400 && status < 500 ? status : 502 },\n      );\n    }\n  }\n\n  let canonicalThreadId = input.threadId;\n  let canonicalRunId = input.runId;\n  let joinToken: string | undefined;\n  let backendThreadId: string | undefined;\n  let lockTtlSeconds: number | undefined;\n  let lockRequestedAt = 0;\n  try {\n    // The platform starts the lock's TTL when it handles the request, so time\n    // the lifetime from the send rather than from the response.\n    lockRequestedAt = Date.now();\n    const lockResult = await runtime.intelligence.ɵacquireThreadLock({\n      supportsBackendThreadId: true,\n      threadId: input.threadId,\n      runId: input.runId,\n      userId,\n      agentId,\n      ...(learningContainerId !== undefined ? { learningContainerId } : {}),\n      ...(runtime.lockKeyPrefix !== undefined\n        ? { lockKeyPrefix: runtime.lockKeyPrefix }\n        : {}),\n      ttlSeconds: runtime.lockTtlSeconds,\n    });\n    canonicalThreadId = lockResult.threadId;\n    canonicalRunId = lockResult.runId;\n    joinToken = lockResult.joinToken;\n    backendThreadId = lockResult.backendThreadId;\n    lockTtlSeconds = lockResult.ttlSeconds;\n  } catch (error) {\n    logger.error(\"Thread lock denied:\", error);\n    const platformStatus = getPlatformErrorStatus(error);\n    return Response.json(\n      {\n        error: \"Thread lock denied\",\n      },\n      {\n        status: platformStatus === 409 ? 409 : 502,\n      },\n    );\n  }\n\n  const cleanupLock = (reason: string): Promise<void> =>\n    runtime.intelligence\n      .ɵcleanupThreadLock({\n        threadId: canonicalThreadId || input.threadId,\n        runId: canonicalRunId || input.runId,\n      })\n      .catch((cleanupError) => {\n        logger.error(\n          { err: cleanupError, reason },\n          \"Failed to cleanup thread lock\",\n        );\n      });\n\n  if (!canonicalThreadId || !canonicalRunId || !joinToken) {\n    await cleanupLock(\"malformed-lock-response\");\n    return Response.json(\n      {\n        error: \"Run connection credentials not available\",\n        message:\n          \"Intelligence platform did not return canonical threadId, runId, and joinToken\",\n      },\n      { status: 502 },\n    );\n  }\n\n  const canonicalInput: RunAgentInput = {\n    ...input,\n    threadId: canonicalThreadId,\n    runId: canonicalRunId,\n  };\n\n  let persistedInputMessages: Message[] | undefined;\n  if (Array.isArray(input.messages)) {\n    try {\n      const history = await runtime.intelligence.getThreadMessages({\n        threadId: canonicalThreadId,\n        userId,\n      });\n      const historicMessageIds = new Set(\n        history.messages.map((message) => message.id),\n      );\n      persistedInputMessages = input.messages.filter(\n        (message) => !historicMessageIds.has(message.id),\n      );\n    } catch (error) {\n      logger.error(\"Thread history lookup failed:\", error);\n      await cleanupLock(\"thread-history-lookup-failed\");\n      return Response.json(\n        {\n          error: \"Thread history lookup failed\",\n        },\n        { status: 502 },\n      );\n    }\n  }\n\n  runtimeTelemetry.capture(\"oss.runtime.agent_execution_stream_started\", {});\n\n  // Keep the thread lock alive while the run executes. Transient renewal\n  // failures are retried within the lock's remaining TTL; only a lost lock\n  // (or running out of time) aborts the run.\n  const heartbeat = startThreadLockHeartbeat({\n    renew: (signal) =>\n      runtime.intelligence.ɵrenewThreadLock({\n        threadId: canonicalThreadId,\n        runId: canonicalRunId,\n        ttlSeconds: runtime.lockTtlSeconds,\n        ...(runtime.lockKeyPrefix !== undefined\n          ? { lockKeyPrefix: runtime.lockKeyPrefix }\n          : {}),\n        signal,\n      }),\n    intervalMs: runtime.lockHeartbeatIntervalSeconds * 1_000,\n    fallbackTtlSeconds: runtime.lockTtlSeconds,\n    // The acquire round trip and the history lookup above both run between\n    // the lock request and now, so pass the lifetime the platform set minus\n    // the time already spent.\n    initialTtlSeconds:\n      lockTtlSeconds === undefined\n        ? undefined\n        : lockTtlSeconds - (Date.now() - lockRequestedAt) / 1_000,\n    onLost: (err) => {\n      logger.error(\"Failed to renew thread lock:\", err);\n      try {\n        agent.abortRun();\n      } catch (abortError) {\n        logger.error(\n          \"Failed to abort agent after lock renewal failure:\",\n          abortError,\n        );\n      }\n    },\n  });\n\n  const clearHeartbeat = () => {\n    heartbeat.stop();\n  };\n\n  const runStarted = { current: false };\n  let immediateStartupErrorMessage: string | undefined;\n  let immediateStartupCleanup: Promise<void> | undefined;\n\n  const runRequest: AgentRunnerRunRequest = {\n    threadId: canonicalThreadId,\n    ...(backendThreadId === undefined ? {} : { backendThreadId }),\n    agent,\n    input: canonicalInput,\n    ...(persistedInputMessages !== undefined ? { persistedInputMessages } : {}),\n  };\n\n  const runtimeErrorReporter = getRuntimeErrorReporter(runtime);\n  let agentErrorReported = false;\n  const reportAgentError = (error: unknown, phase: RuntimeErrorPhase) => {\n    if (agentErrorReported) return;\n    agentErrorReported = true;\n    // Analytics describes the outcome; only the application-owned reporter\n    // receives diagnostics that may contain customer or upstream content.\n    runtimeTelemetry.capture(\"oss.runtime.agent_execution_stream_errored\", {\n      error: \"AGENT_EXECUTION_FAILED\",\n    });\n    runtimeErrorReporter?.report({\n      request,\n      error,\n      operation: \"agent.run\",\n      agentId,\n      threadId: canonicalThreadId,\n      runId: canonicalRunId,\n      phase,\n      startTime,\n    });\n  };\n\n  try {\n    const runStart = hasRunnerStartupBoundary(runtime.runner)\n      ? runtime.runner.runWithStartupBoundary(runRequest)\n      : {\n          events: runtime.runner.run(runRequest),\n          startup: Promise.resolve(),\n        };\n\n    runStart.events.subscribe({\n      next: (event: BaseEvent) => {\n        if (event.type === EventType.RUN_STARTED) {\n          runStarted.current = true;\n        }\n        if (event.type === EventType.RUN_ERROR) {\n          const message =\n            \"message\" in event && typeof event.message === \"string\"\n              ? event.message\n              : \"Runner failed before the run started\";\n          reportAgentError(\n            new Error(message),\n            runStarted.current\n              ? \"intelligence.subscription\"\n              : \"intelligence.startup\",\n          );\n          if (!runStarted.current) {\n            clearHeartbeat();\n            immediateStartupErrorMessage = message;\n            immediateStartupCleanup = cleanupLock(\"runner-start-failed\");\n          }\n        }\n      },\n      error: (error) => {\n        reportAgentError(\n          error,\n          runStarted.current\n            ? \"intelligence.subscription\"\n            : \"intelligence.startup\",\n        );\n        clearHeartbeat();\n        if (!runStarted.current) {\n          immediateStartupErrorMessage =\n            error instanceof Error ? error.message : String(error);\n          immediateStartupCleanup = cleanupLock(\"runner-start-error\");\n        } else {\n          cleanupLock(\"runner-error\");\n        }\n        logger.error(\"Error running agent:\", error);\n      },\n      complete: () => {\n        clearHeartbeat();\n        // Preserve the existing completion count even when the stream contains\n        // RUN_ERROR. Failure reporting is separate and carries only a safe code.\n        runtimeTelemetry.capture(\n          \"oss.runtime.agent_execution_stream_ended\",\n          {},\n        );\n      },\n    });\n\n    await runStart.startup;\n  } catch (error) {\n    reportAgentError(error, \"intelligence.startup\");\n    clearHeartbeat();\n    await (immediateStartupCleanup ?? cleanupLock(\"runner-start-threw\"));\n    logger.error(\"Error starting agent runner:\", error);\n    return Response.json(\n      {\n        error: \"Failed to start runner\",\n        message: error instanceof Error ? error.message : String(error),\n      },\n      { status: 502 },\n    );\n  }\n\n  if (immediateStartupErrorMessage) {\n    await immediateStartupCleanup;\n    return Response.json(\n      {\n        error: \"Failed to start runner\",\n        message: immediateStartupErrorMessage,\n      },\n      { status: 502 },\n    );\n  }\n\n  // IntelligenceAgentRunner resolves this boundary after Phoenix channel join.\n  // Other runner implementations fall back to construction/subscription errors.\n  return Response.json(\n    {\n      threadId: canonicalThreadId,\n      runId: canonicalRunId,\n      joinToken,\n      realtime: buildRealtimeConnectionInfo({\n        clientUrl: runtime.intelligence.ɵgetClientWsUrl(),\n        threadId: canonicalThreadId,\n      }),\n    },\n    {\n      headers: { \"Cache-Control\": \"no-cache\" },\n    },\n  );\n}\n"],"mappings":"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"}

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

@@ -2,6 +2,7 @@ import "reflect-metadata";
 import telemetry from "../../telemetry/telemetry-client.mjs";
 import { getRuntimeErrorReporter } from "../../core/runtime-error-reporter.mjs";
 import { resolveLearningContainerId, resolveLearningContainerSelector } from "../../core/learning.mjs";
+import { startThreadLockHeartbeat } from "../../intelligence-platform/thread-lock-heartbeat.mjs";
 import { isHandlerResponse } from "../shared/json-response.mjs";
 import { getPlatformErrorStatus } from "../shared/intelligence-utils.mjs";
 import { resolveIntelligenceUser } from "../shared/resolve-intelligence-user.mjs";
@@ -34,6 +35,8 @@ async function handleIntelligenceRun({ runtime, request, agentId, agent, input,
 	});
 	if (isHandlerResponse(user)) return user;
 	const userId = user.id;
+	const proxyRequest = input.forwardedProps?.__proxiedMCPRequest;
+	const isDirectResourceRead = input.forwardedProps?.__copilotkitMcpResourceReadOnly === true && proxyRequest && typeof proxyRequest === "object" && proxyRequest.method === "resources/read";
 	let learningContainerId;
 	try {
 		const selector = runtime.intelligence.ɵgetLearningContainerId?.();
@@ -54,13 +57,16 @@ async function handleIntelligenceRun({ runtime, request, agentId, agent, input,
 		logger.error("Failed to resolve Learning Container:", error);
 		return Response.json({ error: "Failed to resolve Learning Container" }, { status: 500 });
 	}
+	let thread;
 	try {
-		const { thread, created } = await runtime.intelligence.getOrCreateThread({
+		const initialized = await runtime.intelligence.getOrCreateThread({
 			threadId: input.threadId,
 			userId,
 			agentId,
 			...learningContainerId !== void 0 ? { learningContainerId } : {}
 		});
+		thread = initialized.thread;
+		const { created } = initialized;
 		if (created && runtime.generateThreadNames && !thread.name?.trim()) generateThreadNameForNewThread({
 			runtime,
 			request,
@@ -76,11 +82,34 @@ async function handleIntelligenceRun({ runtime, request, agentId, agent, input,
 		const platformStatus = getPlatformErrorStatus(error);
 		return Response.json({ error: "Failed to initialize thread" }, { status: platformStatus !== void 0 && platformStatus >= 400 && platformStatus < 500 ? platformStatus : 502 });
 	}
+	if (isDirectResourceRead) try {
+		if (thread.agentId && thread.agentId !== agentId) return Response.json({ error: "Thread belongs to another agent" }, { status: 403 });
+		agent.threadId = thread.id;
+		const run = await agent.runAgent({
+			runId: input.runId,
+			tools: input.tools,
+			context: input.context,
+			forwardedProps: input.forwardedProps
+		});
+		return Response.json({
+			kind: "mcp-resource-read",
+			threadId: thread.id,
+			runId: input.runId,
+			result: run.result ?? null
+		});
+	} catch (error) {
+		logger.error("MCP resource read failed:", error);
+		const status = getPlatformErrorStatus(error);
+		return Response.json({ error: "MCP resource read failed" }, { status: status && status >= 400 && status < 500 ? status : 502 });
+	}
 	let canonicalThreadId = input.threadId;
 	let canonicalRunId = input.runId;
 	let joinToken;
 	let backendThreadId;
+	let lockTtlSeconds;
+	let lockRequestedAt = 0;
 	try {
+		lockRequestedAt = Date.now();
 		const lockResult = await runtime.intelligence.ɵacquireThreadLock({
 			supportsBackendThreadId: true,
 			threadId: input.threadId,
@@ -95,6 +124,7 @@ async function handleIntelligenceRun({ runtime, request, agentId, agent, input,
 		canonicalRunId = lockResult.runId;
 		joinToken = lockResult.joinToken;
 		backendThreadId = lockResult.backendThreadId;
+		lockTtlSeconds = lockResult.ttlSeconds;
 	} catch (error) {
 		logger.error("Thread lock denied:", error);
 		const platformStatus = getPlatformErrorStatus(error);
@@ -135,31 +165,28 @@ async function handleIntelligenceRun({ runtime, request, agentId, agent, input,
 		return Response.json({ error: "Thread history lookup failed" }, { status: 502 });
 	}
 	runtimeTelemetry.capture("oss.runtime.agent_execution_stream_started", {});
-	let heartbeatStopped = false;
-	let heartbeatTimer;
-	heartbeatTimer = setInterval(() => {
-		runtime.intelligence.ɵrenewThreadLock({
+	const heartbeat = startThreadLockHeartbeat({
+		renew: (signal) => runtime.intelligence.ɵrenewThreadLock({
 			threadId: canonicalThreadId,
 			runId: canonicalRunId,
 			ttlSeconds: runtime.lockTtlSeconds,
-			...runtime.lockKeyPrefix !== void 0 ? { lockKeyPrefix: runtime.lockKeyPrefix } : {}
-		}).catch((err) => {
-			if (heartbeatStopped) return;
+			...runtime.lockKeyPrefix !== void 0 ? { lockKeyPrefix: runtime.lockKeyPrefix } : {},
+			signal
+		}),
+		intervalMs: runtime.lockHeartbeatIntervalSeconds * 1e3,
+		fallbackTtlSeconds: runtime.lockTtlSeconds,
+		initialTtlSeconds: lockTtlSeconds === void 0 ? void 0 : lockTtlSeconds - (Date.now() - lockRequestedAt) / 1e3,
+		onLost: (err) => {
 			logger.error("Failed to renew thread lock:", err);
-			clearHeartbeat();
 			try {
 				agent.abortRun();
 			} catch (abortError) {
 				logger.error("Failed to abort agent after lock renewal failure:", abortError);
 			}
-		});
-	}, runtime.lockHeartbeatIntervalSeconds * 1e3);
-	const clearHeartbeat = () => {
-		heartbeatStopped = true;
-		if (heartbeatTimer !== void 0) {
-			clearInterval(heartbeatTimer);
-			heartbeatTimer = void 0;
 		}
+	});
+	const clearHeartbeat = () => {
+		heartbeat.stop();
 	};
 	const runStarted = { current: false };
 	let immediateStartupErrorMessage;

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

@@ -1 +1 @@
-{"version":3,"file":"run.mjs","names":[],"sources":["../../../../../src/v2/runtime/handlers/intelligence/run.ts"],"sourcesContent":["import type {\n  AbstractAgent,\n  BaseEvent,\n  Message,\n  RunAgentInput,\n} from \"@ag-ui/client\";\nimport { EventType } from \"@ag-ui/client\";\nimport type { CopilotIntelligenceRuntimeLike } from \"../../core/runtime\";\nimport { generateThreadNameForNewThread } from \"./thread-names\";\nimport { logger } from \"@copilotkit/shared\";\nimport { telemetry } from \"../../telemetry\";\nimport { resolveIntelligenceUser } from \"../shared/resolve-intelligence-user\";\nimport { isHandlerResponse } from \"../shared/json-response\";\nimport type { AgentRunnerRunRequest } from \"../../runner/agent-runner\";\nimport type { Observable } from \"rxjs\";\nimport { getRuntimeErrorReporter } from \"../../core/runtime-error-reporter\";\nimport type { RuntimeErrorPhase } from \"../../core/runtime-error-reporter\";\nimport {\n  resolveLearningContainerId,\n  resolveLearningContainerSelector,\n} from \"../../core/learning\";\nimport { getPlatformErrorStatus } from \"../shared/intelligence-utils\";\n\n/**\n * Builds browser-facing realtime connection metadata owned by the runtime.\n */\nfunction buildRealtimeConnectionInfo(params: {\n  clientUrl: string;\n  threadId: string;\n}): { clientUrl: string; topic: string } {\n  return {\n    clientUrl: params.clientUrl,\n    topic: `thread:${params.threadId}`,\n  };\n}\n\ninterface RunnerStartupBoundary {\n  events: Observable<BaseEvent>;\n  startup: Promise<void>;\n}\n\ninterface RunnerWithStartupBoundary {\n  runWithStartupBoundary(request: AgentRunnerRunRequest): RunnerStartupBoundary;\n}\n\nfunction hasRunnerStartupBoundary(\n  runner: CopilotIntelligenceRuntimeLike[\"runner\"],\n): runner is CopilotIntelligenceRuntimeLike[\"runner\"] &\n  RunnerWithStartupBoundary {\n  const candidate = runner as { runWithStartupBoundary?: unknown };\n\n  return (\n    typeof candidate.runWithStartupBoundary === \"function\" &&\n    (Object.prototype.hasOwnProperty.call(runner, \"runWithStartupBoundary\") ||\n      Object.prototype.hasOwnProperty.call(runner, \"threads\"))\n  );\n}\n\ninterface HandleIntelligenceRunParams {\n  runtime: CopilotIntelligenceRuntimeLike;\n  request: Request;\n  agentId: string;\n  agent: AbstractAgent;\n  input: RunAgentInput;\n  startTime?: number;\n}\n\nexport async function handleIntelligenceRun({\n  runtime,\n  request,\n  agentId,\n  agent,\n  input,\n  startTime,\n}: HandleIntelligenceRunParams): Promise<Response> {\n  const runtimeTelemetry = runtime.telemetry ?? telemetry;\n\n  if (!runtime.intelligence) {\n    return Response.json(\n      {\n        error: \"Intelligence not configured\",\n        message: \"Intelligence mode requires a CopilotKitIntelligence\",\n      },\n      { status: 500 },\n    );\n  }\n\n  const user = await resolveIntelligenceUser({ runtime, request });\n  if (isHandlerResponse(user)) {\n    return user;\n  }\n  const userId = user.id;\n\n  let learningContainerId: string | undefined;\n  try {\n    const selector = runtime.intelligence.ɵgetLearningContainerId?.();\n    learningContainerId = selector\n      ? await resolveLearningContainerSelector(selector, {\n          surface: \"web\",\n          user,\n          agentId,\n          input,\n        })\n      : await resolveLearningContainerId(runtime.learning, {\n          surface: \"web\",\n          request,\n          threadId: input.threadId,\n          runId: input.runId,\n          agentId,\n          userId,\n        });\n  } catch (error) {\n    logger.error(\"Failed to resolve Learning Container:\", error);\n    return Response.json(\n      { error: \"Failed to resolve Learning Container\" },\n      { status: 500 },\n    );\n  }\n\n  try {\n    const { thread, created } = await runtime.intelligence.getOrCreateThread({\n      threadId: input.threadId,\n      userId,\n      agentId,\n      ...(learningContainerId !== undefined ? { learningContainerId } : {}),\n    });\n\n    if (created && runtime.generateThreadNames && !thread.name?.trim()) {\n      void generateThreadNameForNewThread({\n        runtime,\n        request,\n        agentId,\n        sourceInput: input,\n        thread,\n        userId,\n      }).catch((nameError) => {\n        logger.error(\"Failed to generate thread name:\", nameError);\n      });\n    }\n  } catch (error) {\n    logger.error(\"Failed to get or create thread:\", error);\n    const platformStatus = getPlatformErrorStatus(error);\n    return Response.json(\n      {\n        error: \"Failed to initialize thread\",\n      },\n      {\n        status:\n          platformStatus !== undefined &&\n          platformStatus >= 400 &&\n          platformStatus < 500\n            ? platformStatus\n            : 502,\n      },\n    );\n  }\n\n  let canonicalThreadId = input.threadId;\n  let canonicalRunId = input.runId;\n  let joinToken: string | undefined;\n  let backendThreadId: string | undefined;\n  try {\n    const lockResult = await runtime.intelligence.ɵacquireThreadLock({\n      supportsBackendThreadId: true,\n      threadId: input.threadId,\n      runId: input.runId,\n      userId,\n      agentId,\n      ...(learningContainerId !== undefined ? { learningContainerId } : {}),\n      ...(runtime.lockKeyPrefix !== undefined\n        ? { lockKeyPrefix: runtime.lockKeyPrefix }\n        : {}),\n      ttlSeconds: runtime.lockTtlSeconds,\n    });\n    canonicalThreadId = lockResult.threadId;\n    canonicalRunId = lockResult.runId;\n    joinToken = lockResult.joinToken;\n    backendThreadId = lockResult.backendThreadId;\n  } catch (error) {\n    logger.error(\"Thread lock denied:\", error);\n    const platformStatus = getPlatformErrorStatus(error);\n    return Response.json(\n      {\n        error: \"Thread lock denied\",\n      },\n      {\n        status: platformStatus === 409 ? 409 : 502,\n      },\n    );\n  }\n\n  const cleanupLock = (reason: string): Promise<void> =>\n    runtime.intelligence\n      .ɵcleanupThreadLock({\n        threadId: canonicalThreadId || input.threadId,\n        runId: canonicalRunId || input.runId,\n      })\n      .catch((cleanupError) => {\n        logger.error(\n          { err: cleanupError, reason },\n          \"Failed to cleanup thread lock\",\n        );\n      });\n\n  if (!canonicalThreadId || !canonicalRunId || !joinToken) {\n    await cleanupLock(\"malformed-lock-response\");\n    return Response.json(\n      {\n        error: \"Run connection credentials not available\",\n        message:\n          \"Intelligence platform did not return canonical threadId, runId, and joinToken\",\n      },\n      { status: 502 },\n    );\n  }\n\n  const canonicalInput: RunAgentInput = {\n    ...input,\n    threadId: canonicalThreadId,\n    runId: canonicalRunId,\n  };\n\n  let persistedInputMessages: Message[] | undefined;\n  if (Array.isArray(input.messages)) {\n    try {\n      const history = await runtime.intelligence.getThreadMessages({\n        threadId: canonicalThreadId,\n        userId,\n      });\n      const historicMessageIds = new Set(\n        history.messages.map((message) => message.id),\n      );\n      persistedInputMessages = input.messages.filter(\n        (message) => !historicMessageIds.has(message.id),\n      );\n    } catch (error) {\n      logger.error(\"Thread history lookup failed:\", error);\n      await cleanupLock(\"thread-history-lookup-failed\");\n      return Response.json(\n        {\n          error: \"Thread history lookup failed\",\n        },\n        { status: 502 },\n      );\n    }\n  }\n\n  runtimeTelemetry.capture(\"oss.runtime.agent_execution_stream_started\", {});\n\n  // Start heartbeat timer to renew the thread lock.\n  let heartbeatStopped = false;\n  let heartbeatTimer: ReturnType<typeof setInterval> | undefined;\n  heartbeatTimer = setInterval(() => {\n    runtime.intelligence\n      .ɵrenewThreadLock({\n        threadId: canonicalThreadId,\n        runId: canonicalRunId,\n        ttlSeconds: runtime.lockTtlSeconds,\n        ...(runtime.lockKeyPrefix !== undefined\n          ? { lockKeyPrefix: runtime.lockKeyPrefix }\n          : {}),\n      })\n      .catch((err) => {\n        if (heartbeatStopped) {\n          return;\n        }\n\n        logger.error(\"Failed to renew thread lock:\", err);\n        clearHeartbeat();\n        try {\n          agent.abortRun();\n        } catch (abortError) {\n          logger.error(\n            \"Failed to abort agent after lock renewal failure:\",\n            abortError,\n          );\n        }\n      });\n  }, runtime.lockHeartbeatIntervalSeconds * 1_000);\n\n  const clearHeartbeat = () => {\n    heartbeatStopped = true;\n    if (heartbeatTimer !== undefined) {\n      clearInterval(heartbeatTimer);\n      heartbeatTimer = undefined;\n    }\n  };\n\n  const runStarted = { current: false };\n  let immediateStartupErrorMessage: string | undefined;\n  let immediateStartupCleanup: Promise<void> | undefined;\n\n  const runRequest: AgentRunnerRunRequest = {\n    threadId: canonicalThreadId,\n    ...(backendThreadId === undefined ? {} : { backendThreadId }),\n    agent,\n    input: canonicalInput,\n    ...(persistedInputMessages !== undefined ? { persistedInputMessages } : {}),\n  };\n\n  const runtimeErrorReporter = getRuntimeErrorReporter(runtime);\n  let agentErrorReported = false;\n  const reportAgentError = (error: unknown, phase: RuntimeErrorPhase) => {\n    if (agentErrorReported) return;\n    agentErrorReported = true;\n    // Analytics describes the outcome; only the application-owned reporter\n    // receives diagnostics that may contain customer or upstream content.\n    runtimeTelemetry.capture(\"oss.runtime.agent_execution_stream_errored\", {\n      error: \"AGENT_EXECUTION_FAILED\",\n    });\n    runtimeErrorReporter?.report({\n      request,\n      error,\n      operation: \"agent.run\",\n      agentId,\n      threadId: canonicalThreadId,\n      runId: canonicalRunId,\n      phase,\n      startTime,\n    });\n  };\n\n  try {\n    const runStart = hasRunnerStartupBoundary(runtime.runner)\n      ? runtime.runner.runWithStartupBoundary(runRequest)\n      : {\n          events: runtime.runner.run(runRequest),\n          startup: Promise.resolve(),\n        };\n\n    runStart.events.subscribe({\n      next: (event: BaseEvent) => {\n        if (event.type === EventType.RUN_STARTED) {\n          runStarted.current = true;\n        }\n        if (event.type === EventType.RUN_ERROR) {\n          const message =\n            \"message\" in event && typeof event.message === \"string\"\n              ? event.message\n              : \"Runner failed before the run started\";\n          reportAgentError(\n            new Error(message),\n            runStarted.current\n              ? \"intelligence.subscription\"\n              : \"intelligence.startup\",\n          );\n          if (!runStarted.current) {\n            clearHeartbeat();\n            immediateStartupErrorMessage = message;\n            immediateStartupCleanup = cleanupLock(\"runner-start-failed\");\n          }\n        }\n      },\n      error: (error) => {\n        reportAgentError(\n          error,\n          runStarted.current\n            ? \"intelligence.subscription\"\n            : \"intelligence.startup\",\n        );\n        clearHeartbeat();\n        if (!runStarted.current) {\n          immediateStartupErrorMessage =\n            error instanceof Error ? error.message : String(error);\n          immediateStartupCleanup = cleanupLock(\"runner-start-error\");\n        } else {\n          cleanupLock(\"runner-error\");\n        }\n        logger.error(\"Error running agent:\", error);\n      },\n      complete: () => {\n        clearHeartbeat();\n        // Preserve the existing completion count even when the stream contains\n        // RUN_ERROR. Failure reporting is separate and carries only a safe code.\n        runtimeTelemetry.capture(\n          \"oss.runtime.agent_execution_stream_ended\",\n          {},\n        );\n      },\n    });\n\n    await runStart.startup;\n  } catch (error) {\n    reportAgentError(error, \"intelligence.startup\");\n    clearHeartbeat();\n    await (immediateStartupCleanup ?? cleanupLock(\"runner-start-threw\"));\n    logger.error(\"Error starting agent runner:\", error);\n    return Response.json(\n      {\n        error: \"Failed to start runner\",\n        message: error instanceof Error ? error.message : String(error),\n      },\n      { status: 502 },\n    );\n  }\n\n  if (immediateStartupErrorMessage) {\n    await immediateStartupCleanup;\n    return Response.json(\n      {\n        error: \"Failed to start runner\",\n        message: immediateStartupErrorMessage,\n      },\n      { status: 502 },\n    );\n  }\n\n  // IntelligenceAgentRunner resolves this boundary after Phoenix channel join.\n  // Other runner implementations fall back to construction/subscription errors.\n  return Response.json(\n    {\n      threadId: canonicalThreadId,\n      runId: canonicalRunId,\n      joinToken,\n      realtime: buildRealtimeConnectionInfo({\n        clientUrl: runtime.intelligence.ɵgetClientWsUrl(),\n        threadId: canonicalThreadId,\n      }),\n    },\n    {\n      headers: { \"Cache-Control\": \"no-cache\" },\n    },\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"run.mjs","names":[],"sources":["../../../../../src/v2/runtime/handlers/intelligence/run.ts"],"sourcesContent":["import type {\n  AbstractAgent,\n  BaseEvent,\n  Message,\n  RunAgentInput,\n} from \"@ag-ui/client\";\nimport { EventType } from \"@ag-ui/client\";\nimport type { CopilotIntelligenceRuntimeLike } from \"../../core/runtime\";\nimport { generateThreadNameForNewThread } from \"./thread-names\";\nimport { logger } from \"@copilotkit/shared\";\nimport { telemetry } from \"../../telemetry\";\nimport { resolveIntelligenceUser } from \"../shared/resolve-intelligence-user\";\nimport { isHandlerResponse } from \"../shared/json-response\";\nimport type { AgentRunnerRunRequest } from \"../../runner/agent-runner\";\nimport type { Observable } from \"rxjs\";\nimport { getRuntimeErrorReporter } from \"../../core/runtime-error-reporter\";\nimport type { RuntimeErrorPhase } from \"../../core/runtime-error-reporter\";\nimport {\n  resolveLearningContainerId,\n  resolveLearningContainerSelector,\n} from \"../../core/learning\";\nimport { getPlatformErrorStatus } from \"../shared/intelligence-utils\";\nimport { startThreadLockHeartbeat } from \"../../intelligence-platform/thread-lock-heartbeat\";\nimport type { ThreadSummary } from \"../../intelligence-platform\";\n\n/**\n * Builds browser-facing realtime connection metadata owned by the runtime.\n */\nfunction buildRealtimeConnectionInfo(params: {\n  clientUrl: string;\n  threadId: string;\n}): { clientUrl: string; topic: string } {\n  return {\n    clientUrl: params.clientUrl,\n    topic: `thread:${params.threadId}`,\n  };\n}\n\ninterface RunnerStartupBoundary {\n  events: Observable<BaseEvent>;\n  startup: Promise<void>;\n}\n\ninterface RunnerWithStartupBoundary {\n  runWithStartupBoundary(request: AgentRunnerRunRequest): RunnerStartupBoundary;\n}\n\nfunction hasRunnerStartupBoundary(\n  runner: CopilotIntelligenceRuntimeLike[\"runner\"],\n): runner is CopilotIntelligenceRuntimeLike[\"runner\"] &\n  RunnerWithStartupBoundary {\n  const candidate = runner as { runWithStartupBoundary?: unknown };\n\n  return (\n    typeof candidate.runWithStartupBoundary === \"function\" &&\n    (Object.prototype.hasOwnProperty.call(runner, \"runWithStartupBoundary\") ||\n      Object.prototype.hasOwnProperty.call(runner, \"threads\"))\n  );\n}\n\ninterface HandleIntelligenceRunParams {\n  runtime: CopilotIntelligenceRuntimeLike;\n  request: Request;\n  agentId: string;\n  agent: AbstractAgent;\n  input: RunAgentInput;\n  startTime?: number;\n}\n\nexport async function handleIntelligenceRun({\n  runtime,\n  request,\n  agentId,\n  agent,\n  input,\n  startTime,\n}: HandleIntelligenceRunParams): Promise<Response> {\n  const runtimeTelemetry = runtime.telemetry ?? telemetry;\n\n  if (!runtime.intelligence) {\n    return Response.json(\n      {\n        error: \"Intelligence not configured\",\n        message: \"Intelligence mode requires a CopilotKitIntelligence\",\n      },\n      { status: 500 },\n    );\n  }\n\n  const user = await resolveIntelligenceUser({ runtime, request });\n  if (isHandlerResponse(user)) {\n    return user;\n  }\n  const userId = user.id;\n\n  const proxyRequest = (\n    input.forwardedProps as Record<string, unknown> | undefined\n  )?.__proxiedMCPRequest;\n  const isDirectResourceRead =\n    input.forwardedProps?.__copilotkitMcpResourceReadOnly === true &&\n    proxyRequest &&\n    typeof proxyRequest === \"object\" &&\n    (proxyRequest as { method?: unknown }).method === \"resources/read\";\n\n  let learningContainerId: string | undefined;\n  try {\n    const selector = runtime.intelligence.ɵgetLearningContainerId?.();\n    learningContainerId = selector\n      ? await resolveLearningContainerSelector(selector, {\n          surface: \"web\",\n          user,\n          agentId,\n          input,\n        })\n      : await resolveLearningContainerId(runtime.learning, {\n          surface: \"web\",\n          request,\n          threadId: input.threadId,\n          runId: input.runId,\n          agentId,\n          userId,\n        });\n  } catch (error) {\n    logger.error(\"Failed to resolve Learning Container:\", error);\n    return Response.json(\n      { error: \"Failed to resolve Learning Container\" },\n      { status: 500 },\n    );\n  }\n\n  let thread: ThreadSummary;\n  try {\n    const initialized = await runtime.intelligence.getOrCreateThread({\n      threadId: input.threadId,\n      userId,\n      agentId,\n      ...(learningContainerId !== undefined ? { learningContainerId } : {}),\n    });\n    thread = initialized.thread;\n    const { created } = initialized;\n\n    if (created && runtime.generateThreadNames && !thread.name?.trim()) {\n      void generateThreadNameForNewThread({\n        runtime,\n        request,\n        agentId,\n        sourceInput: input,\n        thread,\n        userId,\n      }).catch((nameError) => {\n        logger.error(\"Failed to generate thread name:\", nameError);\n      });\n    }\n  } catch (error) {\n    logger.error(\"Failed to get or create thread:\", error);\n    const platformStatus = getPlatformErrorStatus(error);\n    return Response.json(\n      {\n        error: \"Failed to initialize thread\",\n      },\n      {\n        status:\n          platformStatus !== undefined &&\n          platformStatus >= 400 &&\n          platformStatus < 500\n            ? platformStatus\n            : 502,\n      },\n    );\n  }\n\n  // MCP App resources are presentation data. Initialize the thread through the\n  // usual path, then fetch without claiming its mutation lock so an approval\n  // can continue while the resource server is still answering.\n  if (isDirectResourceRead) {\n    try {\n      if (thread.agentId && thread.agentId !== agentId) {\n        return Response.json(\n          { error: \"Thread belongs to another agent\" },\n          { status: 403 },\n        );\n      }\n      agent.threadId = thread.id;\n      const run = await agent.runAgent({\n        runId: input.runId,\n        tools: input.tools,\n        context: input.context,\n        forwardedProps: input.forwardedProps,\n      });\n      return Response.json({\n        kind: \"mcp-resource-read\",\n        threadId: thread.id,\n        runId: input.runId,\n        result: run.result ?? null,\n      });\n    } catch (error) {\n      logger.error(\"MCP resource read failed:\", error);\n      const status = getPlatformErrorStatus(error);\n      return Response.json(\n        { error: \"MCP resource read failed\" },\n        { status: status && status >= 400 && status < 500 ? status : 502 },\n      );\n    }\n  }\n\n  let canonicalThreadId = input.threadId;\n  let canonicalRunId = input.runId;\n  let joinToken: string | undefined;\n  let backendThreadId: string | undefined;\n  let lockTtlSeconds: number | undefined;\n  let lockRequestedAt = 0;\n  try {\n    // The platform starts the lock's TTL when it handles the request, so time\n    // the lifetime from the send rather than from the response.\n    lockRequestedAt = Date.now();\n    const lockResult = await runtime.intelligence.ɵacquireThreadLock({\n      supportsBackendThreadId: true,\n      threadId: input.threadId,\n      runId: input.runId,\n      userId,\n      agentId,\n      ...(learningContainerId !== undefined ? { learningContainerId } : {}),\n      ...(runtime.lockKeyPrefix !== undefined\n        ? { lockKeyPrefix: runtime.lockKeyPrefix }\n        : {}),\n      ttlSeconds: runtime.lockTtlSeconds,\n    });\n    canonicalThreadId = lockResult.threadId;\n    canonicalRunId = lockResult.runId;\n    joinToken = lockResult.joinToken;\n    backendThreadId = lockResult.backendThreadId;\n    lockTtlSeconds = lockResult.ttlSeconds;\n  } catch (error) {\n    logger.error(\"Thread lock denied:\", error);\n    const platformStatus = getPlatformErrorStatus(error);\n    return Response.json(\n      {\n        error: \"Thread lock denied\",\n      },\n      {\n        status: platformStatus === 409 ? 409 : 502,\n      },\n    );\n  }\n\n  const cleanupLock = (reason: string): Promise<void> =>\n    runtime.intelligence\n      .ɵcleanupThreadLock({\n        threadId: canonicalThreadId || input.threadId,\n        runId: canonicalRunId || input.runId,\n      })\n      .catch((cleanupError) => {\n        logger.error(\n          { err: cleanupError, reason },\n          \"Failed to cleanup thread lock\",\n        );\n      });\n\n  if (!canonicalThreadId || !canonicalRunId || !joinToken) {\n    await cleanupLock(\"malformed-lock-response\");\n    return Response.json(\n      {\n        error: \"Run connection credentials not available\",\n        message:\n          \"Intelligence platform did not return canonical threadId, runId, and joinToken\",\n      },\n      { status: 502 },\n    );\n  }\n\n  const canonicalInput: RunAgentInput = {\n    ...input,\n    threadId: canonicalThreadId,\n    runId: canonicalRunId,\n  };\n\n  let persistedInputMessages: Message[] | undefined;\n  if (Array.isArray(input.messages)) {\n    try {\n      const history = await runtime.intelligence.getThreadMessages({\n        threadId: canonicalThreadId,\n        userId,\n      });\n      const historicMessageIds = new Set(\n        history.messages.map((message) => message.id),\n      );\n      persistedInputMessages = input.messages.filter(\n        (message) => !historicMessageIds.has(message.id),\n      );\n    } catch (error) {\n      logger.error(\"Thread history lookup failed:\", error);\n      await cleanupLock(\"thread-history-lookup-failed\");\n      return Response.json(\n        {\n          error: \"Thread history lookup failed\",\n        },\n        { status: 502 },\n      );\n    }\n  }\n\n  runtimeTelemetry.capture(\"oss.runtime.agent_execution_stream_started\", {});\n\n  // Keep the thread lock alive while the run executes. Transient renewal\n  // failures are retried within the lock's remaining TTL; only a lost lock\n  // (or running out of time) aborts the run.\n  const heartbeat = startThreadLockHeartbeat({\n    renew: (signal) =>\n      runtime.intelligence.ɵrenewThreadLock({\n        threadId: canonicalThreadId,\n        runId: canonicalRunId,\n        ttlSeconds: runtime.lockTtlSeconds,\n        ...(runtime.lockKeyPrefix !== undefined\n          ? { lockKeyPrefix: runtime.lockKeyPrefix }\n          : {}),\n        signal,\n      }),\n    intervalMs: runtime.lockHeartbeatIntervalSeconds * 1_000,\n    fallbackTtlSeconds: runtime.lockTtlSeconds,\n    // The acquire round trip and the history lookup above both run between\n    // the lock request and now, so pass the lifetime the platform set minus\n    // the time already spent.\n    initialTtlSeconds:\n      lockTtlSeconds === undefined\n        ? undefined\n        : lockTtlSeconds - (Date.now() - lockRequestedAt) / 1_000,\n    onLost: (err) => {\n      logger.error(\"Failed to renew thread lock:\", err);\n      try {\n        agent.abortRun();\n      } catch (abortError) {\n        logger.error(\n          \"Failed to abort agent after lock renewal failure:\",\n          abortError,\n        );\n      }\n    },\n  });\n\n  const clearHeartbeat = () => {\n    heartbeat.stop();\n  };\n\n  const runStarted = { current: false };\n  let immediateStartupErrorMessage: string | undefined;\n  let immediateStartupCleanup: Promise<void> | undefined;\n\n  const runRequest: AgentRunnerRunRequest = {\n    threadId: canonicalThreadId,\n    ...(backendThreadId === undefined ? {} : { backendThreadId }),\n    agent,\n    input: canonicalInput,\n    ...(persistedInputMessages !== undefined ? { persistedInputMessages } : {}),\n  };\n\n  const runtimeErrorReporter = getRuntimeErrorReporter(runtime);\n  let agentErrorReported = false;\n  const reportAgentError = (error: unknown, phase: RuntimeErrorPhase) => {\n    if (agentErrorReported) return;\n    agentErrorReported = true;\n    // Analytics describes the outcome; only the application-owned reporter\n    // receives diagnostics that may contain customer or upstream content.\n    runtimeTelemetry.capture(\"oss.runtime.agent_execution_stream_errored\", {\n      error: \"AGENT_EXECUTION_FAILED\",\n    });\n    runtimeErrorReporter?.report({\n      request,\n      error,\n      operation: \"agent.run\",\n      agentId,\n      threadId: canonicalThreadId,\n      runId: canonicalRunId,\n      phase,\n      startTime,\n    });\n  };\n\n  try {\n    const runStart = hasRunnerStartupBoundary(runtime.runner)\n      ? runtime.runner.runWithStartupBoundary(runRequest)\n      : {\n          events: runtime.runner.run(runRequest),\n          startup: Promise.resolve(),\n        };\n\n    runStart.events.subscribe({\n      next: (event: BaseEvent) => {\n        if (event.type === EventType.RUN_STARTED) {\n          runStarted.current = true;\n        }\n        if (event.type === EventType.RUN_ERROR) {\n          const message =\n            \"message\" in event && typeof event.message === \"string\"\n              ? event.message\n              : \"Runner failed before the run started\";\n          reportAgentError(\n            new Error(message),\n            runStarted.current\n              ? \"intelligence.subscription\"\n              : \"intelligence.startup\",\n          );\n          if (!runStarted.current) {\n            clearHeartbeat();\n            immediateStartupErrorMessage = message;\n            immediateStartupCleanup = cleanupLock(\"runner-start-failed\");\n          }\n        }\n      },\n      error: (error) => {\n        reportAgentError(\n          error,\n          runStarted.current\n            ? \"intelligence.subscription\"\n            : \"intelligence.startup\",\n        );\n        clearHeartbeat();\n        if (!runStarted.current) {\n          immediateStartupErrorMessage =\n            error instanceof Error ? error.message : String(error);\n          immediateStartupCleanup = cleanupLock(\"runner-start-error\");\n        } else {\n          cleanupLock(\"runner-error\");\n        }\n        logger.error(\"Error running agent:\", error);\n      },\n      complete: () => {\n        clearHeartbeat();\n        // Preserve the existing completion count even when the stream contains\n        // RUN_ERROR. Failure reporting is separate and carries only a safe code.\n        runtimeTelemetry.capture(\n          \"oss.runtime.agent_execution_stream_ended\",\n          {},\n        );\n      },\n    });\n\n    await runStart.startup;\n  } catch (error) {\n    reportAgentError(error, \"intelligence.startup\");\n    clearHeartbeat();\n    await (immediateStartupCleanup ?? cleanupLock(\"runner-start-threw\"));\n    logger.error(\"Error starting agent runner:\", error);\n    return Response.json(\n      {\n        error: \"Failed to start runner\",\n        message: error instanceof Error ? error.message : String(error),\n      },\n      { status: 502 },\n    );\n  }\n\n  if (immediateStartupErrorMessage) {\n    await immediateStartupCleanup;\n    return Response.json(\n      {\n        error: \"Failed to start runner\",\n        message: immediateStartupErrorMessage,\n      },\n      { status: 502 },\n    );\n  }\n\n  // IntelligenceAgentRunner resolves this boundary after Phoenix channel join.\n  // Other runner implementations fall back to construction/subscription errors.\n  return Response.json(\n    {\n      threadId: canonicalThreadId,\n      runId: canonicalRunId,\n      joinToken,\n      realtime: buildRealtimeConnectionInfo({\n        clientUrl: runtime.intelligence.ɵgetClientWsUrl(),\n        threadId: canonicalThreadId,\n      }),\n    },\n    {\n      headers: { \"Cache-Control\": \"no-cache\" },\n    },\n  );\n}\n"],"mappings":"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"}

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

@@ -5,6 +5,7 @@ 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');
+const require_platform_error = require('../shared/platform-error.cjs');
 let _copilotkit_shared = require("@copilotkit/shared");
 
 //#region src/v2/runtime/handlers/intelligence/threads.ts
@@ -187,7 +188,7 @@ async function handleGetThreadMessages({ runtime, request, threadId }) {
 			err: error,
 			threadId
 		}, "Error fetching thread messages");
-		return require_json_response.errorResponse("Failed to fetch thread messages", 500);
+		return require_platform_error.platformErrorResponse(error, "Failed to fetch thread messages");
 	}
 	if (require_agent_runner.supportsLocalThreadEndpoints(runtime.runner)) {
 		const mapped = runtime.runner.getThreadMessages(threadId).map((msg) => {
@@ -236,7 +237,7 @@ async function handleGetThreadEvents({ runtime, request, threadId }) {
 			err: error,
 			threadId
 		}, "Error fetching thread events");
-		return require_json_response.errorResponse("Failed to fetch thread events", 500);
+		return require_platform_error.platformErrorResponse(error, "Failed to fetch thread events");
 	}
 	if (require_agent_runner.supportsLocalThreadEndpoints(runtime.runner)) try {
 		const events = runtime.runner.getThreadEvents(threadId);
@@ -265,7 +266,7 @@ async function handleGetThreadState({ runtime, request, threadId }) {
 			err: error,
 			threadId
 		}, "Error fetching thread state");
-		return require_json_response.errorResponse("Failed to fetch thread state", 500);
+		return require_platform_error.platformErrorResponse(error, "Failed to fetch thread state");
 	}
 	if (require_agent_runner.supportsLocalThreadEndpoints(runtime.runner)) try {
 		const state = runtime.runner.getThreadState(threadId);