@copilotkit/runtime 1.70.1 → 1.70.2

package/dist/v2/runtime/endpoints/single-route-helpers.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"single-route-helpers.mjs","names":[],"sources":["../../../../src/v2/runtime/endpoints/single-route-helpers.ts"],"sourcesContent":["const METHOD_NAMES = [\n  \"agent/run\",\n  \"agent/suggest\",\n  \"agent/connect\",\n  \"agent/stop\",\n  \"info\",\n  \"inspector/metadata\",\n  \"transcribe\",\n] as const;\n\nexport type EndpointMethod = (typeof METHOD_NAMES)[number];\n\ninterface JsonEnvelope {\n  method?: string;\n  params?: Record<string, unknown>;\n  body?: unknown;\n}\n\nexport interface MethodCall {\n  method: EndpointMethod;\n  params?: Record<string, unknown>;\n  body?: unknown;\n}\n\n/**\n * Detect a single-route JSON envelope on a request the multi-route router\n * could not match.\n *\n * A single-endpoint client (`useSingleEndpoint` on the frontend provider)\n * POSTs `{ method, params, body }` at the base path. A multi-route runtime\n * matches no route for that path and would otherwise answer a bare 404, giving\n * the developer nothing to go on. Recognising the envelope here lets the\n * handler name the actual cause instead.\n *\n * Deliberately conservative: it reports a method only for a POST carrying a\n * JSON body whose `method` is one the single-route endpoint actually accepts.\n * Anything else is a genuine 404 and must stay one.\n *\n * @returns The envelope's method name, or `null` if this is not an envelope.\n */\nexport async function detectSingleRouteEnvelope(\n  request: Request,\n): Promise<EndpointMethod | null> {\n  if (request.method !== \"POST\") return null;\n\n  const contentType = request.headers.get(\"content-type\") || \"\";\n  if (!contentType.includes(\"application/json\")) return null;\n\n  let envelope: unknown;\n  try {\n    envelope = await request.clone().json();\n  } catch {\n    return null;\n  }\n\n  if (typeof envelope !== \"object\" || envelope === null) return null;\n\n  const method = (envelope as JsonEnvelope).method;\n  if (typeof method !== \"string\") return null;\n  if (!(METHOD_NAMES as readonly string[]).includes(method)) return null;\n\n  return method as EndpointMethod;\n}\n\nexport async function parseMethodCall(request: Request): Promise<MethodCall> {\n  const contentType = request.headers.get(\"content-type\") || \"\";\n\n  if (!contentType.includes(\"application/json\")) {\n    throw createResponseError(\n      \"Single-route endpoint expects JSON payloads\",\n      415,\n    );\n  }\n\n  let jsonEnvelope: JsonEnvelope;\n  try {\n    jsonEnvelope = (await request.clone().json()) as JsonEnvelope;\n  } catch {\n    throw createResponseError(\"Invalid JSON payload\", 400);\n  }\n\n  const method = validateMethod(jsonEnvelope.method);\n\n  return {\n    method,\n    params: jsonEnvelope.params,\n    body: jsonEnvelope.body,\n  };\n}\n\nexport function expectString(\n  params: Record<string, unknown> | undefined,\n  key: string,\n): string {\n  const value = params?.[key];\n  if (typeof value === \"string\" && value.trim().length > 0) {\n    return value;\n  }\n\n  throw createResponseError(`Missing or invalid parameter '${key}'`, 400);\n}\n\nexport function createJsonRequest(base: Request, body: unknown): Request {\n  if (body === undefined || body === null) {\n    throw createResponseError(\"Missing request body for JSON handler\", 400);\n  }\n\n  const headers = new Headers(base.headers);\n  headers.set(\"content-type\", \"application/json\");\n  headers.delete(\"content-length\");\n\n  const serializedBody = serializeJsonBody(body);\n\n  return new Request(base.url, {\n    method: \"POST\",\n    headers,\n    body: serializedBody,\n    signal: base.signal,\n  });\n}\n\nexport function createResponseError(message: string, status: number): Response {\n  return new Response(\n    JSON.stringify({\n      error: \"invalid_request\",\n      message,\n    }),\n    {\n      status,\n      headers: {\n        \"Content-Type\": \"application/json\",\n      },\n    },\n  );\n}\n\nfunction validateMethod(method: string | undefined): EndpointMethod {\n  if (!method) {\n    throw createResponseError(\"Missing method field\", 400);\n  }\n\n  if ((METHOD_NAMES as readonly string[]).includes(method)) {\n    return method as EndpointMethod;\n  }\n\n  throw createResponseError(`Unsupported method '${method}'`, 400);\n}\n\nfunction serializeJsonBody(body: unknown): BodyInit {\n  if (typeof body === \"string\") {\n    return body;\n  }\n\n  if (\n    body instanceof Blob ||\n    body instanceof ArrayBuffer ||\n    body instanceof Uint8Array\n  ) {\n    // Uint8Array<ArrayBufferLike> is a valid fetch body at runtime, but the\n    // DOM lib's BodyInit only admits ArrayBuffer-backed views.\n    return body as BodyInit;\n  }\n\n  if (body instanceof FormData || body instanceof URLSearchParams) {\n    return body;\n  }\n\n  return JSON.stringify(body);\n}\n"],"mappings":";;AAAA,MAAM,eAAe;CACnB;CACA;CACA;CACA;CACA;CACA;CACA;CACD;;;;;;;;;;;;;;;;;AAgCD,eAAsB,0BACpB,SACgC;AAChC,KAAI,QAAQ,WAAW,OAAQ,QAAO;AAGtC,KAAI,EADgB,QAAQ,QAAQ,IAAI,eAAe,IAAI,IAC1C,SAAS,mBAAmB,CAAE,QAAO;CAEtD,IAAI;AACJ,KAAI;AACF,aAAW,MAAM,QAAQ,OAAO,CAAC,MAAM;SACjC;AACN,SAAO;;AAGT,KAAI,OAAO,aAAa,YAAY,aAAa,KAAM,QAAO;CAE9D,MAAM,SAAU,SAA0B;AAC1C,KAAI,OAAO,WAAW,SAAU,QAAO;AACvC,KAAI,CAAE,aAAmC,SAAS,OAAO,CAAE,QAAO;AAElE,QAAO;;AAGT,eAAsB,gBAAgB,SAAuC;AAG3E,KAAI,EAFgB,QAAQ,QAAQ,IAAI,eAAe,IAAI,IAE1C,SAAS,mBAAmB,CAC3C,OAAM,oBACJ,+CACA,IACD;CAGH,IAAI;AACJ,KAAI;AACF,iBAAgB,MAAM,QAAQ,OAAO,CAAC,MAAM;SACtC;AACN,QAAM,oBAAoB,wBAAwB,IAAI;;AAKxD,QAAO;EACL,QAHa,eAAe,aAAa,OAAO;EAIhD,QAAQ,aAAa;EACrB,MAAM,aAAa;EACpB;;AAGH,SAAgB,aACd,QACA,KACQ;CACR,MAAM,QAAQ,SAAS;AACvB,KAAI,OAAO,UAAU,YAAY,MAAM,MAAM,CAAC,SAAS,EACrD,QAAO;AAGT,OAAM,oBAAoB,iCAAiC,IAAI,IAAI,IAAI;;AAGzE,SAAgB,kBAAkB,MAAe,MAAwB;AACvE,KAAI,SAAS,UAAa,SAAS,KACjC,OAAM,oBAAoB,yCAAyC,IAAI;CAGzE,MAAM,UAAU,IAAI,QAAQ,KAAK,QAAQ;AACzC,SAAQ,IAAI,gBAAgB,mBAAmB;AAC/C,SAAQ,OAAO,iBAAiB;CAEhC,MAAM,iBAAiB,kBAAkB,KAAK;AAE9C,QAAO,IAAI,QAAQ,KAAK,KAAK;EAC3B,QAAQ;EACR;EACA,MAAM;EACN,QAAQ,KAAK;EACd,CAAC;;AAGJ,SAAgB,oBAAoB,SAAiB,QAA0B;AAC7E,QAAO,IAAI,SACT,KAAK,UAAU;EACb,OAAO;EACP;EACD,CAAC,EACF;EACE;EACA,SAAS,EACP,gBAAgB,oBACjB;EACF,CACF;;AAGH,SAAS,eAAe,QAA4C;AAClE,KAAI,CAAC,OACH,OAAM,oBAAoB,wBAAwB,IAAI;AAGxD,KAAK,aAAmC,SAAS,OAAO,CACtD,QAAO;AAGT,OAAM,oBAAoB,uBAAuB,OAAO,IAAI,IAAI;;AAGlE,SAAS,kBAAkB,MAAyB;AAClD,KAAI,OAAO,SAAS,SAClB,QAAO;AAGT,KACE,gBAAgB,QAChB,gBAAgB,eAChB,gBAAgB,WAIhB,QAAO;AAGT,KAAI,gBAAgB,YAAY,gBAAgB,gBAC9C,QAAO;AAGT,QAAO,KAAK,UAAU,KAAK"}
+{"version":3,"file":"single-route-helpers.mjs","names":[],"sources":["../../../../src/v2/runtime/endpoints/single-route-helpers.ts"],"sourcesContent":["const METHOD_NAMES = [\n  \"agent/run\",\n  \"agent/suggest\",\n  \"agent/connect\",\n  \"agent/stop\",\n  \"info\",\n  \"inspector/metadata\",\n  \"inspector/learning\",\n  \"transcribe\",\n  \"resource/request\",\n] as const;\n\nexport type EndpointMethod = (typeof METHOD_NAMES)[number];\n\ninterface JsonEnvelope {\n  method?: string;\n  params?: Record<string, unknown>;\n  body?: unknown;\n}\n\nexport interface MethodCall {\n  method: EndpointMethod;\n  params?: Record<string, unknown>;\n  body?: unknown;\n}\n\n/**\n * Detect a single-route JSON envelope on a request the multi-route router\n * could not match.\n *\n * A single-endpoint client (`useSingleEndpoint` on the frontend provider)\n * POSTs `{ method, params, body }` at the base path. A multi-route runtime\n * matches no route for that path and would otherwise answer a bare 404, giving\n * the developer nothing to go on. Recognising the envelope here lets the\n * handler name the actual cause instead.\n *\n * Deliberately conservative: it reports a method only for a POST carrying a\n * JSON body whose `method` is one the single-route endpoint actually accepts.\n * Anything else is a genuine 404 and must stay one.\n *\n * @returns The envelope's method name, or `null` if this is not an envelope.\n */\nexport async function detectSingleRouteEnvelope(\n  request: Request,\n): Promise<EndpointMethod | null> {\n  if (request.method !== \"POST\") return null;\n\n  const contentType = request.headers.get(\"content-type\") || \"\";\n  if (!contentType.includes(\"application/json\")) return null;\n\n  let envelope: unknown;\n  try {\n    envelope = await request.clone().json();\n  } catch {\n    return null;\n  }\n\n  if (typeof envelope !== \"object\" || envelope === null) return null;\n\n  const method = (envelope as JsonEnvelope).method;\n  if (typeof method !== \"string\") return null;\n  if (!(METHOD_NAMES as readonly string[]).includes(method)) return null;\n\n  return method as EndpointMethod;\n}\n\nexport async function parseMethodCall(request: Request): Promise<MethodCall> {\n  const contentType = request.headers.get(\"content-type\") || \"\";\n\n  if (!contentType.includes(\"application/json\")) {\n    throw createResponseError(\n      \"Single-route endpoint expects JSON payloads\",\n      415,\n    );\n  }\n\n  let jsonEnvelope: JsonEnvelope;\n  try {\n    jsonEnvelope = (await request.clone().json()) as JsonEnvelope;\n  } catch {\n    throw createResponseError(\"Invalid JSON payload\", 400);\n  }\n\n  const method = validateMethod(jsonEnvelope.method);\n\n  return {\n    method,\n    params: jsonEnvelope.params,\n    body: jsonEnvelope.body,\n  };\n}\n\nexport function expectString(\n  params: Record<string, unknown> | undefined,\n  key: string,\n): string {\n  const value = params?.[key];\n  if (typeof value === \"string\" && value.trim().length > 0) {\n    return value;\n  }\n\n  throw createResponseError(`Missing or invalid parameter '${key}'`, 400);\n}\n\nexport function createJsonRequest(base: Request, body: unknown): Request {\n  if (body === undefined || body === null) {\n    throw createResponseError(\"Missing request body for JSON handler\", 400);\n  }\n\n  const headers = new Headers(base.headers);\n  headers.set(\"content-type\", \"application/json\");\n  headers.delete(\"content-length\");\n\n  const serializedBody = serializeJsonBody(body);\n\n  return new Request(base.url, {\n    method: \"POST\",\n    headers,\n    body: serializedBody,\n    signal: base.signal,\n  });\n}\n\n/**\n * Rebuild a resource request carried inside the single-route JSON envelope.\n *\n * The resource path must stay relative to the mounted Runtime. This prevents\n * the envelope from becoming an open HTTP proxy while preserving the method,\n * query string, headers, and cancellation signal used by the REST handler.\n */\nexport function createResourceRequest(\n  base: Request,\n  path: string,\n  httpMethod: string,\n  body: unknown,\n): Request {\n  if (!path.startsWith(\"/\") || path.startsWith(\"//\")) {\n    throw createResponseError(\"Resource path must be Runtime-relative\", 400);\n  }\n\n  const resourceUrl = new URL(path, \"http://copilotkit.resource\");\n  if (resourceUrl.origin !== \"http://copilotkit.resource\") {\n    throw createResponseError(\"Resource path must be Runtime-relative\", 400);\n  }\n\n  const targetUrl = new URL(base.url);\n  targetUrl.pathname = `${targetUrl.pathname.replace(/\\/$/, \"\")}${resourceUrl.pathname}`;\n  targetUrl.search = resourceUrl.search;\n\n  const method = httpMethod.toUpperCase();\n  const headers = new Headers(base.headers);\n  headers.delete(\"content-length\");\n  const hasBody = method !== \"GET\" && method !== \"HEAD\" && body != null;\n\n  return new Request(targetUrl, {\n    method,\n    headers,\n    ...(hasBody ? { body: serializeJsonBody(body) } : {}),\n    signal: base.signal,\n  });\n}\n\nexport function createResponseError(message: string, status: number): Response {\n  return new Response(\n    JSON.stringify({\n      error: \"invalid_request\",\n      message,\n    }),\n    {\n      status,\n      headers: {\n        \"Content-Type\": \"application/json\",\n      },\n    },\n  );\n}\n\nfunction validateMethod(method: string | undefined): EndpointMethod {\n  if (!method) {\n    throw createResponseError(\"Missing method field\", 400);\n  }\n\n  if ((METHOD_NAMES as readonly string[]).includes(method)) {\n    return method as EndpointMethod;\n  }\n\n  throw createResponseError(`Unsupported method '${method}'`, 400);\n}\n\nfunction serializeJsonBody(body: unknown): BodyInit {\n  if (typeof body === \"string\") {\n    return body;\n  }\n\n  if (\n    body instanceof Blob ||\n    body instanceof ArrayBuffer ||\n    body instanceof Uint8Array\n  ) {\n    // Uint8Array<ArrayBufferLike> is a valid fetch body at runtime, but the\n    // DOM lib's BodyInit only admits ArrayBuffer-backed views.\n    return body as BodyInit;\n  }\n\n  if (body instanceof FormData || body instanceof URLSearchParams) {\n    return body;\n  }\n\n  return JSON.stringify(body);\n}\n"],"mappings":"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"}

package/dist/v2/runtime/handlers/get-runtime-info.cjs

@@ -24,7 +24,7 @@ function resolveLicenseStatus(runtime) {
 */
 function resolveCompatibilityLicenseStatus(runtime, runtimeEntitlements) {
 	if (runtimeEntitlements?.status === "ready") {
-		if (runtimeEntitlements.entitlement.source === "managedOrgSubscription") return runtimeEntitlements.entitlement.active ? "valid" : "none";
+		if (runtimeEntitlements.entitlement.source === "managedOrgSubscription" || runtimeEntitlements.entitlement.source === "awsMarketplaceDeploymentLicense") return runtimeEntitlements.entitlement.active ? "valid" : "none";
 		if (runtimeEntitlements.entitlement.active) return "valid";
 	}
 	const legacyLicenseStatus = resolveLicenseStatus(runtime);
@@ -61,7 +61,7 @@ async function resolveRuntimeEntitlements(runtime) {
 		};
 	}
 }
-async function handleGetRuntimeInfo({ runtime, request, threadEndpointsEnabled = true }) {
+async function handleGetRuntimeInfo({ runtime, request, threadEndpointsEnabled = true, inspectorLearningEnabled = false, singleRouteResourceOperationsEnabled = false }) {
 	try {
 		const runtimeEntitlementsPromise = resolveRuntimeEntitlements(runtime);
 		const webEnabled = !require_runtime.isIntelligenceRuntime(runtime) || runtime.identifyUser !== void 0;
@@ -89,10 +89,15 @@ async function handleGetRuntimeInfo({ runtime, request, threadEndpointsEnabled =
 			audioFileTranscriptionEnabled: webEnabled && !!runtime.transcriptionService,
 			mode: runtime.mode,
 			threadEndpoints: resolveThreadEndpointInfo(runtime, threadEndpointsEnabled && webEnabled),
+			...singleRouteResourceOperationsEnabled ? { singleRoute: {
+				resourceOperations: true,
+				threadEndpoints: resolveThreadEndpointInfo(runtime, webEnabled)
+			} } : {},
 			suggestions: webEnabled,
 			...require_runtime.isIntelligenceRuntime(runtime) && webEnabled ? {
 				intelligence: { wsUrl: runtime.intelligence.ɵgetClientWsUrl() },
-				inspectorMetadata: true
+				inspectorMetadata: true,
+				...runtime.debug?.enabled === true && inspectorLearningEnabled ? { inspectorLearning: true } : {}
 			} : {},
 			a2uiEnabled: webEnabled && require_runtime.isA2UIEnabled(runtime.a2ui),
 			...webEnabled && require_runtime.isA2UIEnabled(runtime.a2ui) ? { a2ui: {

package/dist/v2/runtime/handlers/get-runtime-info.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"get-runtime-info.cjs","names":["isIntelligenceRuntime","PlatformRequestError","resolveAgents","VERSION","isA2UIEnabled","isTelemetryDisabled","supportsLocalThreadEndpoints"],"sources":["../../../../src/v2/runtime/handlers/get-runtime-info.ts"],"sourcesContent":["import type { AgentCapabilities } from \"@ag-ui/core\";\nimport type { CopilotRuntimeLike } from \"../core/runtime\";\nimport {\n  isA2UIEnabled,\n  isIntelligenceRuntime,\n  resolveAgents,\n} from \"../core/runtime\";\nimport type {\n  AgentDescription,\n  RuntimeInfo,\n  RuntimeEntitlementResponse,\n  ThreadEndpointRuntimeInfo,\n} from \"@copilotkit/shared\";\nimport type { RuntimeLicenseStatus } from \"@copilotkit/shared\";\nimport { VERSION } from \"../core/runtime\";\nimport { PlatformRequestError } from \"../intelligence-platform/client\";\nimport { isTelemetryDisabled } from \"../telemetry/telemetry-client\";\nimport { supportsLocalThreadEndpoints } from \"../runner/agent-runner\";\n\nfunction resolveLicenseStatus(\n  runtime: CopilotRuntimeLike,\n): RuntimeLicenseStatus {\n  if (!runtime.licenseChecker) return \"none\";\n  const status = runtime.licenseChecker.getStatus();\n  if (status.warningSeverity === \"none\") return \"valid\";\n  if (status.error === \"expired\") return \"expired\";\n  if (status.warningSeverity === \"warning\") return \"expiring\";\n  if (status.error) return \"invalid\";\n  if (status.warningSeverity === \"info\") return \"none\";\n  return \"unknown\";\n}\n\n/**\n * Map the structured entitlement authority onto the legacy status consumed by\n * older Core, React, and Angular thread surfaces. A ready managed entitlement\n * is authoritative in both directions. Otherwise, preserve the legacy\n * self-hosted license fallback. A retryable lookup without that fallback\n * remains unknown until it resolves.\n */\nfunction resolveCompatibilityLicenseStatus(\n  runtime: CopilotRuntimeLike,\n  runtimeEntitlements: RuntimeEntitlementResponse | undefined,\n): RuntimeLicenseStatus {\n  if (runtimeEntitlements?.status === \"ready\") {\n    if (runtimeEntitlements.entitlement.source === \"managedOrgSubscription\") {\n      return runtimeEntitlements.entitlement.active ? \"valid\" : \"none\";\n    }\n\n    if (runtimeEntitlements.entitlement.active) {\n      return \"valid\";\n    }\n  }\n\n  const legacyLicenseStatus = resolveLicenseStatus(runtime);\n  if (\n    legacyLicenseStatus === \"none\" &&\n    runtimeEntitlements?.status !== \"ready\" &&\n    runtimeEntitlements?.error.retryable\n  ) {\n    return \"unknown\";\n  }\n\n  return legacyLicenseStatus;\n}\n\ninterface HandleGetRuntimeInfoParameters {\n  runtime: CopilotRuntimeLike;\n  request: Request;\n  threadEndpointsEnabled?: boolean;\n}\n\n/**\n * Resolve structured Runtime entitlements for configured Intelligence runtimes.\n *\n * Dependency failures are deliberately converted to a stable unavailable\n * diagnostic so `/info` remains an availability endpoint. The underlying\n * error is not exposed because it may contain upstream response details.\n */\nasync function resolveRuntimeEntitlements(\n  runtime: CopilotRuntimeLike,\n): Promise<RuntimeEntitlementResponse | undefined> {\n  if (!isIntelligenceRuntime(runtime)) {\n    return undefined;\n  }\n\n  try {\n    return await runtime.intelligence.getRuntimeEntitlements();\n  } catch (error) {\n    if (error instanceof PlatformRequestError && error.retryable === false) {\n      return {\n        status: \"misconfigured\",\n        error: {\n          code: \"runtime_entitlements_misconfigured\",\n          message: \"Runtime entitlement lookup is misconfigured\",\n          retryable: false,\n        },\n      };\n    }\n\n    return {\n      status: \"unavailable\",\n      error: {\n        code: \"runtime_entitlements_unavailable\",\n        message: \"Runtime entitlement lookup failed\",\n        retryable: true,\n      },\n    };\n  }\n}\n\nexport async function handleGetRuntimeInfo({\n  runtime,\n  request,\n  threadEndpointsEnabled = true,\n}: HandleGetRuntimeInfoParameters) {\n  try {\n    const runtimeEntitlementsPromise = resolveRuntimeEntitlements(runtime);\n    const webEnabled =\n      !isIntelligenceRuntime(runtime) || runtime.identifyUser !== undefined;\n    const agents = webEnabled\n      ? await resolveAgents(runtime.agents, request)\n      : {};\n\n    const agentEntries = await Promise.all(\n      Object.entries(agents).map(async ([name, agent]) => {\n        let capabilities: AgentCapabilities | undefined;\n        try {\n          capabilities = agent.getCapabilities\n            ? await agent.getCapabilities()\n            : undefined;\n        } catch (error) {\n          // Per-agent isolation: a single agent failing to report capabilities\n          // must not take down the entire /info endpoint.\n          console.warn(\n            `Failed to fetch capabilities for agent \"${name}\":`,\n            error instanceof Error ? error.message : error,\n          );\n          capabilities = undefined;\n        }\n\n        const description: AgentDescription = {\n          name,\n          description: agent.description,\n          className: agent.constructor.name,\n          ...(capabilities ? { capabilities } : {}),\n        };\n\n        return [name, description] as const;\n      }),\n    );\n\n    const agentsDict: Record<string, AgentDescription> =\n      Object.fromEntries(agentEntries);\n    const runtimeEntitlements = await runtimeEntitlementsPromise;\n\n    const runtimeInfo: RuntimeInfo = {\n      version: VERSION,\n      agents: agentsDict,\n      audioFileTranscriptionEnabled:\n        webEnabled && !!runtime.transcriptionService,\n      mode: runtime.mode,\n      threadEndpoints: resolveThreadEndpointInfo(\n        runtime,\n        threadEndpointsEnabled && webEnabled,\n      ),\n      // Advertised unconditionally. Multi-route runtimes expose the dedicated\n      // POST /agent/:agentId/suggest path; single-route clients fall back to a\n      // client-side run (they don't construct the single-route envelope for\n      // suggest). The flag lets multi-route clients detect the stateless path.\n      suggestions: webEnabled,\n      ...(isIntelligenceRuntime(runtime) && webEnabled\n        ? {\n            intelligence: {\n              wsUrl: runtime.intelligence.ɵgetClientWsUrl(),\n            },\n            inspectorMetadata: true,\n          }\n        : {}),\n      // Legacy flat flag, kept for older clients. The `a2ui` object below is\n      // the source of truth: it preserves the per-agent scoping that this\n      // boolean discards (see CopilotKit/CopilotKit#5369). Both go through the\n      // shared isA2UIEnabled() predicate so an explicit `enabled: false`\n      // disables a2ui here exactly as it does on the run path.\n      a2uiEnabled: webEnabled && isA2UIEnabled(runtime.a2ui),\n      ...(webEnabled && isA2UIEnabled(runtime.a2ui)\n        ? {\n            a2ui: {\n              enabled: true,\n              ...(runtime.a2ui.agents ? { agents: runtime.a2ui.agents } : {}),\n            },\n          }\n        : {}),\n      openGenerativeUIEnabled: webEnabled && !!runtime.openGenerativeUI,\n      ...(isIntelligenceRuntime(runtime)\n        ? {\n            licenseStatus: resolveCompatibilityLicenseStatus(\n              runtime,\n              runtimeEntitlements,\n            ),\n          }\n        : {}),\n      ...(runtimeEntitlements ? { runtimeEntitlements } : {}),\n      telemetryDisabled: isTelemetryDisabled(),\n    };\n\n    return new Response(JSON.stringify(runtimeInfo), {\n      status: 200,\n      headers: { \"Content-Type\": \"application/json\" },\n    });\n  } catch (error) {\n    return new Response(\n      JSON.stringify({\n        error: \"Failed to retrieve runtime information\",\n        message: error instanceof Error ? error.message : \"Unknown error\",\n      }),\n      {\n        status: 500,\n        headers: { \"Content-Type\": \"application/json\" },\n      },\n    );\n  }\n}\n\nfunction resolveThreadEndpointInfo(\n  runtime: CopilotRuntimeLike,\n  threadEndpointsEnabled: boolean,\n): ThreadEndpointRuntimeInfo {\n  const hasRestThreadBackend =\n    isIntelligenceRuntime(runtime) ||\n    supportsLocalThreadEndpoints(runtime.runner);\n  const restEndpointsAvailable = threadEndpointsEnabled && hasRestThreadBackend;\n  const managedThreadMetadata =\n    threadEndpointsEnabled && isIntelligenceRuntime(runtime);\n\n  return {\n    list: restEndpointsAvailable,\n    inspect: restEndpointsAvailable,\n    mutations: managedThreadMetadata,\n    realtimeMetadata: managedThreadMetadata,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"get-runtime-info.cjs","names":["isIntelligenceRuntime","PlatformRequestError","resolveAgents","VERSION","isA2UIEnabled","isTelemetryDisabled","supportsLocalThreadEndpoints"],"sources":["../../../../src/v2/runtime/handlers/get-runtime-info.ts"],"sourcesContent":["import type { AgentCapabilities } from \"@ag-ui/core\";\nimport type { CopilotRuntimeLike } from \"../core/runtime\";\nimport {\n  isA2UIEnabled,\n  isIntelligenceRuntime,\n  resolveAgents,\n} from \"../core/runtime\";\nimport type {\n  AgentDescription,\n  RuntimeInfo,\n  RuntimeEntitlementResponse,\n  ThreadEndpointRuntimeInfo,\n} from \"@copilotkit/shared\";\nimport type { RuntimeLicenseStatus } from \"@copilotkit/shared\";\nimport { VERSION } from \"../core/runtime\";\nimport { PlatformRequestError } from \"../intelligence-platform/client\";\nimport { isTelemetryDisabled } from \"../telemetry/telemetry-client\";\nimport { supportsLocalThreadEndpoints } from \"../runner/agent-runner\";\n\nfunction resolveLicenseStatus(\n  runtime: CopilotRuntimeLike,\n): RuntimeLicenseStatus {\n  if (!runtime.licenseChecker) return \"none\";\n  const status = runtime.licenseChecker.getStatus();\n  if (status.warningSeverity === \"none\") return \"valid\";\n  if (status.error === \"expired\") return \"expired\";\n  if (status.warningSeverity === \"warning\") return \"expiring\";\n  if (status.error) return \"invalid\";\n  if (status.warningSeverity === \"info\") return \"none\";\n  return \"unknown\";\n}\n\n/**\n * Map the structured entitlement authority onto the legacy status consumed by\n * older Core, React, and Angular thread surfaces. A ready managed entitlement\n * is authoritative in both directions. Otherwise, preserve the legacy\n * self-hosted license fallback. A retryable lookup without that fallback\n * remains unknown until it resolves.\n */\nfunction resolveCompatibilityLicenseStatus(\n  runtime: CopilotRuntimeLike,\n  runtimeEntitlements: RuntimeEntitlementResponse | undefined,\n): RuntimeLicenseStatus {\n  if (runtimeEntitlements?.status === \"ready\") {\n    if (\n      runtimeEntitlements.entitlement.source === \"managedOrgSubscription\" ||\n      runtimeEntitlements.entitlement.source ===\n        \"awsMarketplaceDeploymentLicense\"\n    ) {\n      return runtimeEntitlements.entitlement.active ? \"valid\" : \"none\";\n    }\n\n    if (runtimeEntitlements.entitlement.active) {\n      return \"valid\";\n    }\n  }\n\n  const legacyLicenseStatus = resolveLicenseStatus(runtime);\n  if (\n    legacyLicenseStatus === \"none\" &&\n    runtimeEntitlements?.status !== \"ready\" &&\n    runtimeEntitlements?.error.retryable\n  ) {\n    return \"unknown\";\n  }\n\n  return legacyLicenseStatus;\n}\n\ninterface HandleGetRuntimeInfoParameters {\n  runtime: CopilotRuntimeLike;\n  request: Request;\n  threadEndpointsEnabled?: boolean;\n  inspectorLearningEnabled?: boolean;\n  singleRouteResourceOperationsEnabled?: boolean;\n}\n\n/**\n * Resolve structured Runtime entitlements for configured Intelligence runtimes.\n *\n * Dependency failures are deliberately converted to a stable unavailable\n * diagnostic so `/info` remains an availability endpoint. The underlying\n * error is not exposed because it may contain upstream response details.\n */\nasync function resolveRuntimeEntitlements(\n  runtime: CopilotRuntimeLike,\n): Promise<RuntimeEntitlementResponse | undefined> {\n  if (!isIntelligenceRuntime(runtime)) {\n    return undefined;\n  }\n\n  try {\n    return await runtime.intelligence.getRuntimeEntitlements();\n  } catch (error) {\n    if (error instanceof PlatformRequestError && error.retryable === false) {\n      return {\n        status: \"misconfigured\",\n        error: {\n          code: \"runtime_entitlements_misconfigured\",\n          message: \"Runtime entitlement lookup is misconfigured\",\n          retryable: false,\n        },\n      };\n    }\n\n    return {\n      status: \"unavailable\",\n      error: {\n        code: \"runtime_entitlements_unavailable\",\n        message: \"Runtime entitlement lookup failed\",\n        retryable: true,\n      },\n    };\n  }\n}\n\nexport async function handleGetRuntimeInfo({\n  runtime,\n  request,\n  threadEndpointsEnabled = true,\n  inspectorLearningEnabled = false,\n  singleRouteResourceOperationsEnabled = false,\n}: HandleGetRuntimeInfoParameters) {\n  try {\n    const runtimeEntitlementsPromise = resolveRuntimeEntitlements(runtime);\n    const webEnabled =\n      !isIntelligenceRuntime(runtime) || runtime.identifyUser !== undefined;\n    const agents = webEnabled\n      ? await resolveAgents(runtime.agents, request)\n      : {};\n\n    const agentEntries = await Promise.all(\n      Object.entries(agents).map(async ([name, agent]) => {\n        let capabilities: AgentCapabilities | undefined;\n        try {\n          capabilities = agent.getCapabilities\n            ? await agent.getCapabilities()\n            : undefined;\n        } catch (error) {\n          // Per-agent isolation: a single agent failing to report capabilities\n          // must not take down the entire /info endpoint.\n          console.warn(\n            `Failed to fetch capabilities for agent \"${name}\":`,\n            error instanceof Error ? error.message : error,\n          );\n          capabilities = undefined;\n        }\n\n        const description: AgentDescription = {\n          name,\n          description: agent.description,\n          className: agent.constructor.name,\n          ...(capabilities ? { capabilities } : {}),\n        };\n\n        return [name, description] as const;\n      }),\n    );\n\n    const agentsDict: Record<string, AgentDescription> =\n      Object.fromEntries(agentEntries);\n    const runtimeEntitlements = await runtimeEntitlementsPromise;\n\n    const runtimeInfo: RuntimeInfo = {\n      version: VERSION,\n      agents: agentsDict,\n      audioFileTranscriptionEnabled:\n        webEnabled && !!runtime.transcriptionService,\n      mode: runtime.mode,\n      threadEndpoints: resolveThreadEndpointInfo(\n        runtime,\n        threadEndpointsEnabled && webEnabled,\n      ),\n      ...(singleRouteResourceOperationsEnabled\n        ? {\n            singleRoute: {\n              resourceOperations: true,\n              threadEndpoints: resolveThreadEndpointInfo(runtime, webEnabled),\n            },\n          }\n        : {}),\n      // Advertised unconditionally. Multi-route runtimes expose the dedicated\n      // POST /agent/:agentId/suggest path; single-route clients fall back to a\n      // client-side run (they don't construct the single-route envelope for\n      // suggest). The flag lets multi-route clients detect the stateless path.\n      suggestions: webEnabled,\n      ...(isIntelligenceRuntime(runtime) && webEnabled\n        ? {\n            intelligence: {\n              wsUrl: runtime.intelligence.ɵgetClientWsUrl(),\n            },\n            inspectorMetadata: true,\n            ...(runtime.debug?.enabled === true && inspectorLearningEnabled\n              ? { inspectorLearning: true }\n              : {}),\n          }\n        : {}),\n      // Legacy flat flag, kept for older clients. The `a2ui` object below is\n      // the source of truth: it preserves the per-agent scoping that this\n      // boolean discards (see CopilotKit/CopilotKit#5369). Both go through the\n      // shared isA2UIEnabled() predicate so an explicit `enabled: false`\n      // disables a2ui here exactly as it does on the run path.\n      a2uiEnabled: webEnabled && isA2UIEnabled(runtime.a2ui),\n      ...(webEnabled && isA2UIEnabled(runtime.a2ui)\n        ? {\n            a2ui: {\n              enabled: true,\n              ...(runtime.a2ui.agents ? { agents: runtime.a2ui.agents } : {}),\n            },\n          }\n        : {}),\n      openGenerativeUIEnabled: webEnabled && !!runtime.openGenerativeUI,\n      ...(isIntelligenceRuntime(runtime)\n        ? {\n            licenseStatus: resolveCompatibilityLicenseStatus(\n              runtime,\n              runtimeEntitlements,\n            ),\n          }\n        : {}),\n      ...(runtimeEntitlements ? { runtimeEntitlements } : {}),\n      telemetryDisabled: isTelemetryDisabled(),\n    };\n\n    return new Response(JSON.stringify(runtimeInfo), {\n      status: 200,\n      headers: { \"Content-Type\": \"application/json\" },\n    });\n  } catch (error) {\n    return new Response(\n      JSON.stringify({\n        error: \"Failed to retrieve runtime information\",\n        message: error instanceof Error ? error.message : \"Unknown error\",\n      }),\n      {\n        status: 500,\n        headers: { \"Content-Type\": \"application/json\" },\n      },\n    );\n  }\n}\n\nfunction resolveThreadEndpointInfo(\n  runtime: CopilotRuntimeLike,\n  threadEndpointsEnabled: boolean,\n): ThreadEndpointRuntimeInfo {\n  const hasRestThreadBackend =\n    isIntelligenceRuntime(runtime) ||\n    supportsLocalThreadEndpoints(runtime.runner);\n  const restEndpointsAvailable = threadEndpointsEnabled && hasRestThreadBackend;\n  const managedThreadMetadata =\n    threadEndpointsEnabled && isIntelligenceRuntime(runtime);\n\n  return {\n    list: restEndpointsAvailable,\n    inspect: restEndpointsAvailable,\n    mutations: managedThreadMetadata,\n    realtimeMetadata: managedThreadMetadata,\n  };\n}\n"],"mappings":"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"}

package/dist/v2/runtime/handlers/get-runtime-info.mjs

@@ -24,7 +24,7 @@ function resolveLicenseStatus(runtime) {
 */
 function resolveCompatibilityLicenseStatus(runtime, runtimeEntitlements) {
 	if (runtimeEntitlements?.status === "ready") {
-		if (runtimeEntitlements.entitlement.source === "managedOrgSubscription") return runtimeEntitlements.entitlement.active ? "valid" : "none";
+		if (runtimeEntitlements.entitlement.source === "managedOrgSubscription" || runtimeEntitlements.entitlement.source === "awsMarketplaceDeploymentLicense") return runtimeEntitlements.entitlement.active ? "valid" : "none";
 		if (runtimeEntitlements.entitlement.active) return "valid";
 	}
 	const legacyLicenseStatus = resolveLicenseStatus(runtime);
@@ -61,7 +61,7 @@ async function resolveRuntimeEntitlements(runtime) {
 		};
 	}
 }
-async function handleGetRuntimeInfo({ runtime, request, threadEndpointsEnabled = true }) {
+async function handleGetRuntimeInfo({ runtime, request, threadEndpointsEnabled = true, inspectorLearningEnabled = false, singleRouteResourceOperationsEnabled = false }) {
 	try {
 		const runtimeEntitlementsPromise = resolveRuntimeEntitlements(runtime);
 		const webEnabled = !isIntelligenceRuntime(runtime) || runtime.identifyUser !== void 0;
@@ -89,10 +89,15 @@ async function handleGetRuntimeInfo({ runtime, request, threadEndpointsEnabled =
 			audioFileTranscriptionEnabled: webEnabled && !!runtime.transcriptionService,
 			mode: runtime.mode,
 			threadEndpoints: resolveThreadEndpointInfo(runtime, threadEndpointsEnabled && webEnabled),
+			...singleRouteResourceOperationsEnabled ? { singleRoute: {
+				resourceOperations: true,
+				threadEndpoints: resolveThreadEndpointInfo(runtime, webEnabled)
+			} } : {},
 			suggestions: webEnabled,
 			...isIntelligenceRuntime(runtime) && webEnabled ? {
 				intelligence: { wsUrl: runtime.intelligence.ɵgetClientWsUrl() },
-				inspectorMetadata: true
+				inspectorMetadata: true,
+				...runtime.debug?.enabled === true && inspectorLearningEnabled ? { inspectorLearning: true } : {}
 			} : {},
 			a2uiEnabled: webEnabled && isA2UIEnabled(runtime.a2ui),
 			...webEnabled && isA2UIEnabled(runtime.a2ui) ? { a2ui: {

package/dist/v2/runtime/handlers/get-runtime-info.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"get-runtime-info.mjs","names":[],"sources":["../../../../src/v2/runtime/handlers/get-runtime-info.ts"],"sourcesContent":["import type { AgentCapabilities } from \"@ag-ui/core\";\nimport type { CopilotRuntimeLike } from \"../core/runtime\";\nimport {\n  isA2UIEnabled,\n  isIntelligenceRuntime,\n  resolveAgents,\n} from \"../core/runtime\";\nimport type {\n  AgentDescription,\n  RuntimeInfo,\n  RuntimeEntitlementResponse,\n  ThreadEndpointRuntimeInfo,\n} from \"@copilotkit/shared\";\nimport type { RuntimeLicenseStatus } from \"@copilotkit/shared\";\nimport { VERSION } from \"../core/runtime\";\nimport { PlatformRequestError } from \"../intelligence-platform/client\";\nimport { isTelemetryDisabled } from \"../telemetry/telemetry-client\";\nimport { supportsLocalThreadEndpoints } from \"../runner/agent-runner\";\n\nfunction resolveLicenseStatus(\n  runtime: CopilotRuntimeLike,\n): RuntimeLicenseStatus {\n  if (!runtime.licenseChecker) return \"none\";\n  const status = runtime.licenseChecker.getStatus();\n  if (status.warningSeverity === \"none\") return \"valid\";\n  if (status.error === \"expired\") return \"expired\";\n  if (status.warningSeverity === \"warning\") return \"expiring\";\n  if (status.error) return \"invalid\";\n  if (status.warningSeverity === \"info\") return \"none\";\n  return \"unknown\";\n}\n\n/**\n * Map the structured entitlement authority onto the legacy status consumed by\n * older Core, React, and Angular thread surfaces. A ready managed entitlement\n * is authoritative in both directions. Otherwise, preserve the legacy\n * self-hosted license fallback. A retryable lookup without that fallback\n * remains unknown until it resolves.\n */\nfunction resolveCompatibilityLicenseStatus(\n  runtime: CopilotRuntimeLike,\n  runtimeEntitlements: RuntimeEntitlementResponse | undefined,\n): RuntimeLicenseStatus {\n  if (runtimeEntitlements?.status === \"ready\") {\n    if (runtimeEntitlements.entitlement.source === \"managedOrgSubscription\") {\n      return runtimeEntitlements.entitlement.active ? \"valid\" : \"none\";\n    }\n\n    if (runtimeEntitlements.entitlement.active) {\n      return \"valid\";\n    }\n  }\n\n  const legacyLicenseStatus = resolveLicenseStatus(runtime);\n  if (\n    legacyLicenseStatus === \"none\" &&\n    runtimeEntitlements?.status !== \"ready\" &&\n    runtimeEntitlements?.error.retryable\n  ) {\n    return \"unknown\";\n  }\n\n  return legacyLicenseStatus;\n}\n\ninterface HandleGetRuntimeInfoParameters {\n  runtime: CopilotRuntimeLike;\n  request: Request;\n  threadEndpointsEnabled?: boolean;\n}\n\n/**\n * Resolve structured Runtime entitlements for configured Intelligence runtimes.\n *\n * Dependency failures are deliberately converted to a stable unavailable\n * diagnostic so `/info` remains an availability endpoint. The underlying\n * error is not exposed because it may contain upstream response details.\n */\nasync function resolveRuntimeEntitlements(\n  runtime: CopilotRuntimeLike,\n): Promise<RuntimeEntitlementResponse | undefined> {\n  if (!isIntelligenceRuntime(runtime)) {\n    return undefined;\n  }\n\n  try {\n    return await runtime.intelligence.getRuntimeEntitlements();\n  } catch (error) {\n    if (error instanceof PlatformRequestError && error.retryable === false) {\n      return {\n        status: \"misconfigured\",\n        error: {\n          code: \"runtime_entitlements_misconfigured\",\n          message: \"Runtime entitlement lookup is misconfigured\",\n          retryable: false,\n        },\n      };\n    }\n\n    return {\n      status: \"unavailable\",\n      error: {\n        code: \"runtime_entitlements_unavailable\",\n        message: \"Runtime entitlement lookup failed\",\n        retryable: true,\n      },\n    };\n  }\n}\n\nexport async function handleGetRuntimeInfo({\n  runtime,\n  request,\n  threadEndpointsEnabled = true,\n}: HandleGetRuntimeInfoParameters) {\n  try {\n    const runtimeEntitlementsPromise = resolveRuntimeEntitlements(runtime);\n    const webEnabled =\n      !isIntelligenceRuntime(runtime) || runtime.identifyUser !== undefined;\n    const agents = webEnabled\n      ? await resolveAgents(runtime.agents, request)\n      : {};\n\n    const agentEntries = await Promise.all(\n      Object.entries(agents).map(async ([name, agent]) => {\n        let capabilities: AgentCapabilities | undefined;\n        try {\n          capabilities = agent.getCapabilities\n            ? await agent.getCapabilities()\n            : undefined;\n        } catch (error) {\n          // Per-agent isolation: a single agent failing to report capabilities\n          // must not take down the entire /info endpoint.\n          console.warn(\n            `Failed to fetch capabilities for agent \"${name}\":`,\n            error instanceof Error ? error.message : error,\n          );\n          capabilities = undefined;\n        }\n\n        const description: AgentDescription = {\n          name,\n          description: agent.description,\n          className: agent.constructor.name,\n          ...(capabilities ? { capabilities } : {}),\n        };\n\n        return [name, description] as const;\n      }),\n    );\n\n    const agentsDict: Record<string, AgentDescription> =\n      Object.fromEntries(agentEntries);\n    const runtimeEntitlements = await runtimeEntitlementsPromise;\n\n    const runtimeInfo: RuntimeInfo = {\n      version: VERSION,\n      agents: agentsDict,\n      audioFileTranscriptionEnabled:\n        webEnabled && !!runtime.transcriptionService,\n      mode: runtime.mode,\n      threadEndpoints: resolveThreadEndpointInfo(\n        runtime,\n        threadEndpointsEnabled && webEnabled,\n      ),\n      // Advertised unconditionally. Multi-route runtimes expose the dedicated\n      // POST /agent/:agentId/suggest path; single-route clients fall back to a\n      // client-side run (they don't construct the single-route envelope for\n      // suggest). The flag lets multi-route clients detect the stateless path.\n      suggestions: webEnabled,\n      ...(isIntelligenceRuntime(runtime) && webEnabled\n        ? {\n            intelligence: {\n              wsUrl: runtime.intelligence.ɵgetClientWsUrl(),\n            },\n            inspectorMetadata: true,\n          }\n        : {}),\n      // Legacy flat flag, kept for older clients. The `a2ui` object below is\n      // the source of truth: it preserves the per-agent scoping that this\n      // boolean discards (see CopilotKit/CopilotKit#5369). Both go through the\n      // shared isA2UIEnabled() predicate so an explicit `enabled: false`\n      // disables a2ui here exactly as it does on the run path.\n      a2uiEnabled: webEnabled && isA2UIEnabled(runtime.a2ui),\n      ...(webEnabled && isA2UIEnabled(runtime.a2ui)\n        ? {\n            a2ui: {\n              enabled: true,\n              ...(runtime.a2ui.agents ? { agents: runtime.a2ui.agents } : {}),\n            },\n          }\n        : {}),\n      openGenerativeUIEnabled: webEnabled && !!runtime.openGenerativeUI,\n      ...(isIntelligenceRuntime(runtime)\n        ? {\n            licenseStatus: resolveCompatibilityLicenseStatus(\n              runtime,\n              runtimeEntitlements,\n            ),\n          }\n        : {}),\n      ...(runtimeEntitlements ? { runtimeEntitlements } : {}),\n      telemetryDisabled: isTelemetryDisabled(),\n    };\n\n    return new Response(JSON.stringify(runtimeInfo), {\n      status: 200,\n      headers: { \"Content-Type\": \"application/json\" },\n    });\n  } catch (error) {\n    return new Response(\n      JSON.stringify({\n        error: \"Failed to retrieve runtime information\",\n        message: error instanceof Error ? error.message : \"Unknown error\",\n      }),\n      {\n        status: 500,\n        headers: { \"Content-Type\": \"application/json\" },\n      },\n    );\n  }\n}\n\nfunction resolveThreadEndpointInfo(\n  runtime: CopilotRuntimeLike,\n  threadEndpointsEnabled: boolean,\n): ThreadEndpointRuntimeInfo {\n  const hasRestThreadBackend =\n    isIntelligenceRuntime(runtime) ||\n    supportsLocalThreadEndpoints(runtime.runner);\n  const restEndpointsAvailable = threadEndpointsEnabled && hasRestThreadBackend;\n  const managedThreadMetadata =\n    threadEndpointsEnabled && isIntelligenceRuntime(runtime);\n\n  return {\n    list: restEndpointsAvailable,\n    inspect: restEndpointsAvailable,\n    mutations: managedThreadMetadata,\n    realtimeMetadata: managedThreadMetadata,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"get-runtime-info.mjs","names":[],"sources":["../../../../src/v2/runtime/handlers/get-runtime-info.ts"],"sourcesContent":["import type { AgentCapabilities } from \"@ag-ui/core\";\nimport type { CopilotRuntimeLike } from \"../core/runtime\";\nimport {\n  isA2UIEnabled,\n  isIntelligenceRuntime,\n  resolveAgents,\n} from \"../core/runtime\";\nimport type {\n  AgentDescription,\n  RuntimeInfo,\n  RuntimeEntitlementResponse,\n  ThreadEndpointRuntimeInfo,\n} from \"@copilotkit/shared\";\nimport type { RuntimeLicenseStatus } from \"@copilotkit/shared\";\nimport { VERSION } from \"../core/runtime\";\nimport { PlatformRequestError } from \"../intelligence-platform/client\";\nimport { isTelemetryDisabled } from \"../telemetry/telemetry-client\";\nimport { supportsLocalThreadEndpoints } from \"../runner/agent-runner\";\n\nfunction resolveLicenseStatus(\n  runtime: CopilotRuntimeLike,\n): RuntimeLicenseStatus {\n  if (!runtime.licenseChecker) return \"none\";\n  const status = runtime.licenseChecker.getStatus();\n  if (status.warningSeverity === \"none\") return \"valid\";\n  if (status.error === \"expired\") return \"expired\";\n  if (status.warningSeverity === \"warning\") return \"expiring\";\n  if (status.error) return \"invalid\";\n  if (status.warningSeverity === \"info\") return \"none\";\n  return \"unknown\";\n}\n\n/**\n * Map the structured entitlement authority onto the legacy status consumed by\n * older Core, React, and Angular thread surfaces. A ready managed entitlement\n * is authoritative in both directions. Otherwise, preserve the legacy\n * self-hosted license fallback. A retryable lookup without that fallback\n * remains unknown until it resolves.\n */\nfunction resolveCompatibilityLicenseStatus(\n  runtime: CopilotRuntimeLike,\n  runtimeEntitlements: RuntimeEntitlementResponse | undefined,\n): RuntimeLicenseStatus {\n  if (runtimeEntitlements?.status === \"ready\") {\n    if (\n      runtimeEntitlements.entitlement.source === \"managedOrgSubscription\" ||\n      runtimeEntitlements.entitlement.source ===\n        \"awsMarketplaceDeploymentLicense\"\n    ) {\n      return runtimeEntitlements.entitlement.active ? \"valid\" : \"none\";\n    }\n\n    if (runtimeEntitlements.entitlement.active) {\n      return \"valid\";\n    }\n  }\n\n  const legacyLicenseStatus = resolveLicenseStatus(runtime);\n  if (\n    legacyLicenseStatus === \"none\" &&\n    runtimeEntitlements?.status !== \"ready\" &&\n    runtimeEntitlements?.error.retryable\n  ) {\n    return \"unknown\";\n  }\n\n  return legacyLicenseStatus;\n}\n\ninterface HandleGetRuntimeInfoParameters {\n  runtime: CopilotRuntimeLike;\n  request: Request;\n  threadEndpointsEnabled?: boolean;\n  inspectorLearningEnabled?: boolean;\n  singleRouteResourceOperationsEnabled?: boolean;\n}\n\n/**\n * Resolve structured Runtime entitlements for configured Intelligence runtimes.\n *\n * Dependency failures are deliberately converted to a stable unavailable\n * diagnostic so `/info` remains an availability endpoint. The underlying\n * error is not exposed because it may contain upstream response details.\n */\nasync function resolveRuntimeEntitlements(\n  runtime: CopilotRuntimeLike,\n): Promise<RuntimeEntitlementResponse | undefined> {\n  if (!isIntelligenceRuntime(runtime)) {\n    return undefined;\n  }\n\n  try {\n    return await runtime.intelligence.getRuntimeEntitlements();\n  } catch (error) {\n    if (error instanceof PlatformRequestError && error.retryable === false) {\n      return {\n        status: \"misconfigured\",\n        error: {\n          code: \"runtime_entitlements_misconfigured\",\n          message: \"Runtime entitlement lookup is misconfigured\",\n          retryable: false,\n        },\n      };\n    }\n\n    return {\n      status: \"unavailable\",\n      error: {\n        code: \"runtime_entitlements_unavailable\",\n        message: \"Runtime entitlement lookup failed\",\n        retryable: true,\n      },\n    };\n  }\n}\n\nexport async function handleGetRuntimeInfo({\n  runtime,\n  request,\n  threadEndpointsEnabled = true,\n  inspectorLearningEnabled = false,\n  singleRouteResourceOperationsEnabled = false,\n}: HandleGetRuntimeInfoParameters) {\n  try {\n    const runtimeEntitlementsPromise = resolveRuntimeEntitlements(runtime);\n    const webEnabled =\n      !isIntelligenceRuntime(runtime) || runtime.identifyUser !== undefined;\n    const agents = webEnabled\n      ? await resolveAgents(runtime.agents, request)\n      : {};\n\n    const agentEntries = await Promise.all(\n      Object.entries(agents).map(async ([name, agent]) => {\n        let capabilities: AgentCapabilities | undefined;\n        try {\n          capabilities = agent.getCapabilities\n            ? await agent.getCapabilities()\n            : undefined;\n        } catch (error) {\n          // Per-agent isolation: a single agent failing to report capabilities\n          // must not take down the entire /info endpoint.\n          console.warn(\n            `Failed to fetch capabilities for agent \"${name}\":`,\n            error instanceof Error ? error.message : error,\n          );\n          capabilities = undefined;\n        }\n\n        const description: AgentDescription = {\n          name,\n          description: agent.description,\n          className: agent.constructor.name,\n          ...(capabilities ? { capabilities } : {}),\n        };\n\n        return [name, description] as const;\n      }),\n    );\n\n    const agentsDict: Record<string, AgentDescription> =\n      Object.fromEntries(agentEntries);\n    const runtimeEntitlements = await runtimeEntitlementsPromise;\n\n    const runtimeInfo: RuntimeInfo = {\n      version: VERSION,\n      agents: agentsDict,\n      audioFileTranscriptionEnabled:\n        webEnabled && !!runtime.transcriptionService,\n      mode: runtime.mode,\n      threadEndpoints: resolveThreadEndpointInfo(\n        runtime,\n        threadEndpointsEnabled && webEnabled,\n      ),\n      ...(singleRouteResourceOperationsEnabled\n        ? {\n            singleRoute: {\n              resourceOperations: true,\n              threadEndpoints: resolveThreadEndpointInfo(runtime, webEnabled),\n            },\n          }\n        : {}),\n      // Advertised unconditionally. Multi-route runtimes expose the dedicated\n      // POST /agent/:agentId/suggest path; single-route clients fall back to a\n      // client-side run (they don't construct the single-route envelope for\n      // suggest). The flag lets multi-route clients detect the stateless path.\n      suggestions: webEnabled,\n      ...(isIntelligenceRuntime(runtime) && webEnabled\n        ? {\n            intelligence: {\n              wsUrl: runtime.intelligence.ɵgetClientWsUrl(),\n            },\n            inspectorMetadata: true,\n            ...(runtime.debug?.enabled === true && inspectorLearningEnabled\n              ? { inspectorLearning: true }\n              : {}),\n          }\n        : {}),\n      // Legacy flat flag, kept for older clients. The `a2ui` object below is\n      // the source of truth: it preserves the per-agent scoping that this\n      // boolean discards (see CopilotKit/CopilotKit#5369). Both go through the\n      // shared isA2UIEnabled() predicate so an explicit `enabled: false`\n      // disables a2ui here exactly as it does on the run path.\n      a2uiEnabled: webEnabled && isA2UIEnabled(runtime.a2ui),\n      ...(webEnabled && isA2UIEnabled(runtime.a2ui)\n        ? {\n            a2ui: {\n              enabled: true,\n              ...(runtime.a2ui.agents ? { agents: runtime.a2ui.agents } : {}),\n            },\n          }\n        : {}),\n      openGenerativeUIEnabled: webEnabled && !!runtime.openGenerativeUI,\n      ...(isIntelligenceRuntime(runtime)\n        ? {\n            licenseStatus: resolveCompatibilityLicenseStatus(\n              runtime,\n              runtimeEntitlements,\n            ),\n          }\n        : {}),\n      ...(runtimeEntitlements ? { runtimeEntitlements } : {}),\n      telemetryDisabled: isTelemetryDisabled(),\n    };\n\n    return new Response(JSON.stringify(runtimeInfo), {\n      status: 200,\n      headers: { \"Content-Type\": \"application/json\" },\n    });\n  } catch (error) {\n    return new Response(\n      JSON.stringify({\n        error: \"Failed to retrieve runtime information\",\n        message: error instanceof Error ? error.message : \"Unknown error\",\n      }),\n      {\n        status: 500,\n        headers: { \"Content-Type\": \"application/json\" },\n      },\n    );\n  }\n}\n\nfunction resolveThreadEndpointInfo(\n  runtime: CopilotRuntimeLike,\n  threadEndpointsEnabled: boolean,\n): ThreadEndpointRuntimeInfo {\n  const hasRestThreadBackend =\n    isIntelligenceRuntime(runtime) ||\n    supportsLocalThreadEndpoints(runtime.runner);\n  const restEndpointsAvailable = threadEndpointsEnabled && hasRestThreadBackend;\n  const managedThreadMetadata =\n    threadEndpointsEnabled && isIntelligenceRuntime(runtime);\n\n  return {\n    list: restEndpointsAvailable,\n    inspect: restEndpointsAvailable,\n    mutations: managedThreadMetadata,\n    realtimeMetadata: managedThreadMetadata,\n  };\n}\n"],"mappings":"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"}

package/dist/v2/runtime/handlers/handle-inspector-learning.cjs

@@ -0,0 +1,56 @@
+require("reflect-metadata");
+const require_runtime = require('../../../_virtual/_rolldown/runtime.cjs');
+const require_runtime$1 = require('../core/runtime.cjs');
+const require_client = require('../intelligence-platform/client.cjs');
+const require_resolve_intelligence_user = require('./shared/resolve-intelligence-user.cjs');
+let _copilotkit_shared = require("@copilotkit/shared");
+
+//#region src/v2/runtime/handlers/handle-inspector-learning.ts
+const headers = {
+	"Cache-Control": "no-store, private",
+	"Content-Type": "application/json"
+};
+const errorResponse = (status, message) => new Response(JSON.stringify({ error: message }), {
+	status,
+	headers
+});
+const queryPage = (value) => value === null ? void 0 : Number(value);
+/** Proxies a bounded Learning read through the runtime's server-held credential. */
+async function handleInspectorLearning({ runtime, request, enabled }) {
+	if (!enabled || runtime.debug?.enabled !== true || !require_runtime$1.isIntelligenceRuntime(runtime)) return errorResponse(404, "Not found");
+	const user = await require_resolve_intelligence_user.resolveIntelligenceUser({
+		runtime,
+		request
+	});
+	if (user instanceof Response) return user;
+	const url = new URL(request.url);
+	if ([...url.searchParams.keys()].some((key) => ![
+		"agentId",
+		"skillsPage",
+		"insightsPage"
+	].includes(key))) return errorResponse(400, "Invalid Inspector Learning request");
+	const parsedRequest = (0, _copilotkit_shared.parseInspectorLearningRequestV1)({
+		agentId: url.searchParams.get("agentId") ?? void 0,
+		skillsPage: queryPage(url.searchParams.get("skillsPage")),
+		insightsPage: queryPage(url.searchParams.get("insightsPage"))
+	});
+	if (!parsedRequest) return errorResponse(400, "Invalid Inspector Learning request");
+	try {
+		const snapshot = (0, _copilotkit_shared.parseInspectorLearningSnapshotV1)(await runtime.intelligence.getInspectorLearning({
+			...parsedRequest,
+			...typeof runtime.learning?.containerId === "string" ? { runtimeContainerId: runtime.learning.containerId } : {}
+		}));
+		if (!snapshot) return errorResponse(502, "Invalid Inspector Learning response");
+		return new Response(JSON.stringify(snapshot), {
+			status: 200,
+			headers
+		});
+	} catch (error) {
+		if (error instanceof require_client.PlatformRequestError && error.status === 404) return errorResponse(404, "Not found");
+		return errorResponse(503, "Inspector Learning is temporarily unavailable");
+	}
+}
+
+//#endregion
+exports.handleInspectorLearning = handleInspectorLearning;
+//# sourceMappingURL=handle-inspector-learning.cjs.map

package/dist/v2/runtime/handlers/handle-inspector-learning.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle-inspector-learning.cjs","names":["isIntelligenceRuntime","resolveIntelligenceUser","PlatformRequestError"],"sources":["../../../../src/v2/runtime/handlers/handle-inspector-learning.ts"],"sourcesContent":["import {\n  parseInspectorLearningRequestV1,\n  parseInspectorLearningSnapshotV1,\n} from \"@copilotkit/shared\";\nimport type { CopilotRuntimeLike } from \"../core/runtime\";\nimport { isIntelligenceRuntime } from \"../core/runtime\";\nimport { PlatformRequestError } from \"../intelligence-platform/client\";\nimport { resolveIntelligenceUser } from \"./shared/resolve-intelligence-user\";\n\nconst headers = {\n  \"Cache-Control\": \"no-store, private\",\n  \"Content-Type\": \"application/json\",\n} as const;\n\nconst errorResponse = (status: number, message: string) =>\n  new Response(JSON.stringify({ error: message }), { status, headers });\n\nconst queryPage = (value: string | null): number | undefined =>\n  value === null ? undefined : Number(value);\n\n/** Proxies a bounded Learning read through the runtime's server-held credential. */\nexport async function handleInspectorLearning({\n  runtime,\n  request,\n  enabled,\n}: {\n  readonly runtime: CopilotRuntimeLike;\n  readonly request: Request;\n  readonly enabled: boolean;\n}): Promise<Response> {\n  if (\n    !enabled ||\n    runtime.debug?.enabled !== true ||\n    !isIntelligenceRuntime(runtime)\n  ) {\n    return errorResponse(404, \"Not found\");\n  }\n  const user = await resolveIntelligenceUser({ runtime, request });\n  if (user instanceof Response) return user;\n  const url = new URL(request.url);\n  if (\n    [...url.searchParams.keys()].some(\n      (key) => ![\"agentId\", \"skillsPage\", \"insightsPage\"].includes(key),\n    )\n  ) {\n    return errorResponse(400, \"Invalid Inspector Learning request\");\n  }\n  const parsedRequest = parseInspectorLearningRequestV1({\n    agentId: url.searchParams.get(\"agentId\") ?? undefined,\n    skillsPage: queryPage(url.searchParams.get(\"skillsPage\")),\n    insightsPage: queryPage(url.searchParams.get(\"insightsPage\")),\n  });\n  if (!parsedRequest)\n    return errorResponse(400, \"Invalid Inspector Learning request\");\n\n  try {\n    const snapshot = parseInspectorLearningSnapshotV1(\n      await runtime.intelligence.getInspectorLearning({\n        ...parsedRequest,\n        ...(typeof runtime.learning?.containerId === \"string\"\n          ? { runtimeContainerId: runtime.learning.containerId }\n          : {}),\n      }),\n    );\n    if (!snapshot)\n      return errorResponse(502, \"Invalid Inspector Learning response\");\n    return new Response(JSON.stringify(snapshot), { status: 200, headers });\n  } catch (error) {\n    if (error instanceof PlatformRequestError && error.status === 404) {\n      return errorResponse(404, \"Not found\");\n    }\n    return errorResponse(503, \"Inspector Learning is temporarily unavailable\");\n  }\n}\n"],"mappings":";;;;;;;;AASA,MAAM,UAAU;CACd,iBAAiB;CACjB,gBAAgB;CACjB;AAED,MAAM,iBAAiB,QAAgB,YACrC,IAAI,SAAS,KAAK,UAAU,EAAE,OAAO,SAAS,CAAC,EAAE;CAAE;CAAQ;CAAS,CAAC;AAEvE,MAAM,aAAa,UACjB,UAAU,OAAO,SAAY,OAAO,MAAM;;AAG5C,eAAsB,wBAAwB,EAC5C,SACA,SACA,WAKoB;AACpB,KACE,CAAC,WACD,QAAQ,OAAO,YAAY,QAC3B,CAACA,wCAAsB,QAAQ,CAE/B,QAAO,cAAc,KAAK,YAAY;CAExC,MAAM,OAAO,MAAMC,0DAAwB;EAAE;EAAS;EAAS,CAAC;AAChE,KAAI,gBAAgB,SAAU,QAAO;CACrC,MAAM,MAAM,IAAI,IAAI,QAAQ,IAAI;AAChC,KACE,CAAC,GAAG,IAAI,aAAa,MAAM,CAAC,CAAC,MAC1B,QAAQ,CAAC;EAAC;EAAW;EAAc;EAAe,CAAC,SAAS,IAAI,CAClE,CAED,QAAO,cAAc,KAAK,qCAAqC;CAEjE,MAAM,wEAAgD;EACpD,SAAS,IAAI,aAAa,IAAI,UAAU,IAAI;EAC5C,YAAY,UAAU,IAAI,aAAa,IAAI,aAAa,CAAC;EACzD,cAAc,UAAU,IAAI,aAAa,IAAI,eAAe,CAAC;EAC9D,CAAC;AACF,KAAI,CAAC,cACH,QAAO,cAAc,KAAK,qCAAqC;AAEjE,KAAI;EACF,MAAM,oEACJ,MAAM,QAAQ,aAAa,qBAAqB;GAC9C,GAAG;GACH,GAAI,OAAO,QAAQ,UAAU,gBAAgB,WACzC,EAAE,oBAAoB,QAAQ,SAAS,aAAa,GACpD,EAAE;GACP,CAAC,CACH;AACD,MAAI,CAAC,SACH,QAAO,cAAc,KAAK,sCAAsC;AAClE,SAAO,IAAI,SAAS,KAAK,UAAU,SAAS,EAAE;GAAE,QAAQ;GAAK;GAAS,CAAC;UAChE,OAAO;AACd,MAAI,iBAAiBC,uCAAwB,MAAM,WAAW,IAC5D,QAAO,cAAc,KAAK,YAAY;AAExC,SAAO,cAAc,KAAK,gDAAgD"}

package/dist/v2/runtime/handlers/handle-inspector-learning.mjs

@@ -0,0 +1,55 @@
+import "reflect-metadata";
+import { isIntelligenceRuntime } from "../core/runtime.mjs";
+import { PlatformRequestError } from "../intelligence-platform/client.mjs";
+import { resolveIntelligenceUser } from "./shared/resolve-intelligence-user.mjs";
+import { parseInspectorLearningRequestV1, parseInspectorLearningSnapshotV1 } from "@copilotkit/shared";
+
+//#region src/v2/runtime/handlers/handle-inspector-learning.ts
+const headers = {
+	"Cache-Control": "no-store, private",
+	"Content-Type": "application/json"
+};
+const errorResponse = (status, message) => new Response(JSON.stringify({ error: message }), {
+	status,
+	headers
+});
+const queryPage = (value) => value === null ? void 0 : Number(value);
+/** Proxies a bounded Learning read through the runtime's server-held credential. */
+async function handleInspectorLearning({ runtime, request, enabled }) {
+	if (!enabled || runtime.debug?.enabled !== true || !isIntelligenceRuntime(runtime)) return errorResponse(404, "Not found");
+	const user = await resolveIntelligenceUser({
+		runtime,
+		request
+	});
+	if (user instanceof Response) return user;
+	const url = new URL(request.url);
+	if ([...url.searchParams.keys()].some((key) => ![
+		"agentId",
+		"skillsPage",
+		"insightsPage"
+	].includes(key))) return errorResponse(400, "Invalid Inspector Learning request");
+	const parsedRequest = parseInspectorLearningRequestV1({
+		agentId: url.searchParams.get("agentId") ?? void 0,
+		skillsPage: queryPage(url.searchParams.get("skillsPage")),
+		insightsPage: queryPage(url.searchParams.get("insightsPage"))
+	});
+	if (!parsedRequest) return errorResponse(400, "Invalid Inspector Learning request");
+	try {
+		const snapshot = parseInspectorLearningSnapshotV1(await runtime.intelligence.getInspectorLearning({
+			...parsedRequest,
+			...typeof runtime.learning?.containerId === "string" ? { runtimeContainerId: runtime.learning.containerId } : {}
+		}));
+		if (!snapshot) return errorResponse(502, "Invalid Inspector Learning response");
+		return new Response(JSON.stringify(snapshot), {
+			status: 200,
+			headers
+		});
+	} catch (error) {
+		if (error instanceof PlatformRequestError && error.status === 404) return errorResponse(404, "Not found");
+		return errorResponse(503, "Inspector Learning is temporarily unavailable");
+	}
+}
+
+//#endregion
+export { handleInspectorLearning };
+//# sourceMappingURL=handle-inspector-learning.mjs.map

package/dist/v2/runtime/handlers/handle-inspector-learning.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle-inspector-learning.mjs","names":[],"sources":["../../../../src/v2/runtime/handlers/handle-inspector-learning.ts"],"sourcesContent":["import {\n  parseInspectorLearningRequestV1,\n  parseInspectorLearningSnapshotV1,\n} from \"@copilotkit/shared\";\nimport type { CopilotRuntimeLike } from \"../core/runtime\";\nimport { isIntelligenceRuntime } from \"../core/runtime\";\nimport { PlatformRequestError } from \"../intelligence-platform/client\";\nimport { resolveIntelligenceUser } from \"./shared/resolve-intelligence-user\";\n\nconst headers = {\n  \"Cache-Control\": \"no-store, private\",\n  \"Content-Type\": \"application/json\",\n} as const;\n\nconst errorResponse = (status: number, message: string) =>\n  new Response(JSON.stringify({ error: message }), { status, headers });\n\nconst queryPage = (value: string | null): number | undefined =>\n  value === null ? undefined : Number(value);\n\n/** Proxies a bounded Learning read through the runtime's server-held credential. */\nexport async function handleInspectorLearning({\n  runtime,\n  request,\n  enabled,\n}: {\n  readonly runtime: CopilotRuntimeLike;\n  readonly request: Request;\n  readonly enabled: boolean;\n}): Promise<Response> {\n  if (\n    !enabled ||\n    runtime.debug?.enabled !== true ||\n    !isIntelligenceRuntime(runtime)\n  ) {\n    return errorResponse(404, \"Not found\");\n  }\n  const user = await resolveIntelligenceUser({ runtime, request });\n  if (user instanceof Response) return user;\n  const url = new URL(request.url);\n  if (\n    [...url.searchParams.keys()].some(\n      (key) => ![\"agentId\", \"skillsPage\", \"insightsPage\"].includes(key),\n    )\n  ) {\n    return errorResponse(400, \"Invalid Inspector Learning request\");\n  }\n  const parsedRequest = parseInspectorLearningRequestV1({\n    agentId: url.searchParams.get(\"agentId\") ?? undefined,\n    skillsPage: queryPage(url.searchParams.get(\"skillsPage\")),\n    insightsPage: queryPage(url.searchParams.get(\"insightsPage\")),\n  });\n  if (!parsedRequest)\n    return errorResponse(400, \"Invalid Inspector Learning request\");\n\n  try {\n    const snapshot = parseInspectorLearningSnapshotV1(\n      await runtime.intelligence.getInspectorLearning({\n        ...parsedRequest,\n        ...(typeof runtime.learning?.containerId === \"string\"\n          ? { runtimeContainerId: runtime.learning.containerId }\n          : {}),\n      }),\n    );\n    if (!snapshot)\n      return errorResponse(502, \"Invalid Inspector Learning response\");\n    return new Response(JSON.stringify(snapshot), { status: 200, headers });\n  } catch (error) {\n    if (error instanceof PlatformRequestError && error.status === 404) {\n      return errorResponse(404, \"Not found\");\n    }\n    return errorResponse(503, \"Inspector Learning is temporarily unavailable\");\n  }\n}\n"],"mappings":";;;;;;;AASA,MAAM,UAAU;CACd,iBAAiB;CACjB,gBAAgB;CACjB;AAED,MAAM,iBAAiB,QAAgB,YACrC,IAAI,SAAS,KAAK,UAAU,EAAE,OAAO,SAAS,CAAC,EAAE;CAAE;CAAQ;CAAS,CAAC;AAEvE,MAAM,aAAa,UACjB,UAAU,OAAO,SAAY,OAAO,MAAM;;AAG5C,eAAsB,wBAAwB,EAC5C,SACA,SACA,WAKoB;AACpB,KACE,CAAC,WACD,QAAQ,OAAO,YAAY,QAC3B,CAAC,sBAAsB,QAAQ,CAE/B,QAAO,cAAc,KAAK,YAAY;CAExC,MAAM,OAAO,MAAM,wBAAwB;EAAE;EAAS;EAAS,CAAC;AAChE,KAAI,gBAAgB,SAAU,QAAO;CACrC,MAAM,MAAM,IAAI,IAAI,QAAQ,IAAI;AAChC,KACE,CAAC,GAAG,IAAI,aAAa,MAAM,CAAC,CAAC,MAC1B,QAAQ,CAAC;EAAC;EAAW;EAAc;EAAe,CAAC,SAAS,IAAI,CAClE,CAED,QAAO,cAAc,KAAK,qCAAqC;CAEjE,MAAM,gBAAgB,gCAAgC;EACpD,SAAS,IAAI,aAAa,IAAI,UAAU,IAAI;EAC5C,YAAY,UAAU,IAAI,aAAa,IAAI,aAAa,CAAC;EACzD,cAAc,UAAU,IAAI,aAAa,IAAI,eAAe,CAAC;EAC9D,CAAC;AACF,KAAI,CAAC,cACH,QAAO,cAAc,KAAK,qCAAqC;AAEjE,KAAI;EACF,MAAM,WAAW,iCACf,MAAM,QAAQ,aAAa,qBAAqB;GAC9C,GAAG;GACH,GAAI,OAAO,QAAQ,UAAU,gBAAgB,WACzC,EAAE,oBAAoB,QAAQ,SAAS,aAAa,GACpD,EAAE;GACP,CAAC,CACH;AACD,MAAI,CAAC,SACH,QAAO,cAAc,KAAK,sCAAsC;AAClE,SAAO,IAAI,SAAS,KAAK,UAAU,SAAS,EAAE;GAAE,QAAQ;GAAK;GAAS,CAAC;UAChE,OAAO;AACd,MAAI,iBAAiB,wBAAwB,MAAM,WAAW,IAC5D,QAAO,cAAc,KAAK,YAAY;AAExC,SAAO,cAAc,KAAK,gDAAgD"}

package/dist/v2/runtime/handlers/shared/sse-response.cjs

@@ -85,7 +85,7 @@ function createSseEventResponse({ request, observableFactory, debugEventBus, age
 							...summarizeEvent(event)
 						}, "Event emitted");
 					}
-					await writer.write(encoder.encode(event));
+					await writer.write(encoder.encodeBinary(event));
 				} catch (error) {
 					if (error instanceof Error && error.name === "AbortError") streamClosed = true;
 					else {

package/dist/v2/runtime/handlers/shared/sse-response.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"sse-response.cjs","names":["defaultTelemetry","EventEncoder","createLogger"],"sources":["../../../../../src/v2/runtime/handlers/shared/sse-response.ts"],"sourcesContent":["import type { BaseEvent } from \"@ag-ui/client\";\nimport { EventEncoder } from \"@ag-ui/encoder\";\nimport type { Observable, Subscription } from \"rxjs\";\nimport type { ResolvedDebugConfig } from \"@copilotkit/shared\";\nimport { createLogger } from \"../../../../v1-deprecated/lib/logger\";\nimport type { CopilotRuntimeLogger } from \"../../../../v1-deprecated/lib/logger\";\nimport { telemetry as defaultTelemetry } from \"../../telemetry\";\nimport type { TelemetryCapture } from \"../../telemetry/telemetry-client\";\nimport type { DebugEventBus } from \"../../core/debug-event-bus\";\nimport type {\n  RuntimeErrorPhase,\n  RuntimeErrorReporter,\n} from \"../../core/runtime-error-reporter\";\n\ninterface CreateSseEventResponseParams {\n  request: Request;\n  observableFactory: () =>\n    | Promise<Observable<BaseEvent>>\n    | Observable<BaseEvent>;\n  debugEventBus?: DebugEventBus;\n  agentId?: string;\n  debug?: ResolvedDebugConfig;\n  /** Pre-created logger instance to avoid creating a new pino logger per request. */\n  logger?: CopilotRuntimeLogger;\n  /** Runtime-bound telemetry capture. Falls back for external direct callers. */\n  telemetry?: TelemetryCapture;\n  /**\n   * Whether to emit `oss.runtime.agent_execution_stream_*` telemetry for this\n   * stream. Defaults to `true`. The stateless `/suggest` path sets this to\n   * `false`: a suggestion is a side-effect-free structured completion, not a\n   * tracked run, and under `available: \"always\"` it fires often enough to flood\n   * run telemetry.\n   */\n  captureTelemetry?: boolean;\n  runtimeErrorReporter?: RuntimeErrorReporter;\n  startTime?: number;\n}\n\nexport function createSseEventResponse({\n  request,\n  observableFactory,\n  debugEventBus,\n  agentId,\n  debug,\n  logger,\n  telemetry = defaultTelemetry,\n  captureTelemetry = true,\n  runtimeErrorReporter,\n  startTime,\n}: CreateSseEventResponseParams): Response {\n  const stream = new TransformStream();\n  const writer = stream.writable.getWriter();\n  const encoder = new EventEncoder();\n  let streamClosed = false;\n  let debugThreadId = \"\";\n  let debugRunId = \"\";\n\n  const debugLogger = debug?.enabled\n    ? (logger ??\n      createLogger({ level: \"debug\", component: \"copilotkit-debug\" }))\n    : undefined;\n\n  const closeStream = async () => {\n    if (!streamClosed) {\n      try {\n        await writer.close();\n        streamClosed = true;\n      } catch {\n        // Stream already closed.\n      }\n    }\n  };\n\n  const logError = (error: unknown) => {\n    console.error(\"Error running agent:\", error);\n    console.error(\n      \"Error stack:\",\n      error instanceof Error ? error.stack : \"No stack trace\",\n    );\n    console.error(\"Error details:\", {\n      name: error instanceof Error ? error.name : \"Unknown\",\n      message: error instanceof Error ? error.message : String(error),\n      cause: error instanceof Error ? error.cause : undefined,\n    });\n  };\n\n  let subscription: Subscription | undefined;\n  let agentErrorReported = false;\n\n  const reportAgentError = (error: unknown, phase: RuntimeErrorPhase) => {\n    if (agentErrorReported) return;\n    agentErrorReported = true;\n    runtimeErrorReporter?.report({\n      request,\n      error,\n      operation: \"agent.run\",\n      agentId,\n      threadId: debugThreadId || undefined,\n      runId: debugRunId || undefined,\n      phase,\n      startTime,\n    });\n  };\n\n  (async () => {\n    const observable = await observableFactory();\n\n    if (captureTelemetry) {\n      telemetry.capture(\"oss.runtime.agent_execution_stream_started\", {});\n    }\n\n    if (debug?.lifecycle) {\n      debugLogger!.debug(\"SSE stream opened\");\n    }\n\n    let eventCount = 0;\n    let loggedEventCount = 0;\n\n    subscription = observable.subscribe({\n      next: async (event) => {\n        // Extract threadId/runId from RUN_STARTED\n        if (event.type === \"RUN_STARTED\") {\n          const e = event as { threadId?: string; runId?: string };\n          debugThreadId = e.threadId ?? \"\";\n          debugRunId = e.runId ?? \"\";\n        }\n\n        if (event.type === \"RUN_ERROR\") {\n          const e = event as {\n            message?: unknown;\n            threadId?: string;\n            runId?: string;\n          };\n          debugThreadId = e.threadId ?? debugThreadId;\n          debugRunId = e.runId ?? debugRunId;\n          reportAgentError(\n            new Error(\n              typeof e.message === \"string\"\n                ? e.message\n                : \"Runner reported a run error\",\n            ),\n            \"sse.subscription\",\n          );\n        }\n\n        // Broadcast to debug listeners BEFORE the stream-closed gate below.\n        // Intentional: debug subscribers (e.g. the VS Code Inspector panel)\n        // should still receive trailing events after the SSE client for\n        // this request closed its connection — they're independent\n        // consumers observing the underlying runtime, not the request's\n        // response stream.\n        //\n        // Wrapped in try/catch so a buggy debug subscriber can't propagate\n        // an exception into this observer — if the throw reached the\n        // `next` callback it would get routed to `error` by RxJS, closing\n        // the SSE stream for an unrelated reason. Log via `logError` and\n        // move on.\n        if (debugEventBus) {\n          try {\n            debugEventBus.broadcast(event, {\n              agentId: agentId ?? \"\",\n              threadId: debugThreadId,\n              runId: debugRunId,\n            });\n          } catch (broadcastError) {\n            logError(broadcastError);\n          }\n        }\n\n        if (!request.signal.aborted && !streamClosed) {\n          try {\n            eventCount++;\n            if (debug?.events) {\n              loggedEventCount++;\n              if (debug.verbose) {\n                debugLogger!.debug({ event }, \"Event emitted\");\n              } else {\n                debugLogger!.debug(\n                  { type: event.type, ...summarizeEvent(event) },\n                  \"Event emitted\",\n                );\n              }\n            }\n            await writer.write(encoder.encode(event));\n          } catch (error) {\n            if (error instanceof Error && error.name === \"AbortError\") {\n              streamClosed = true;\n            } else {\n              // Non-abort write failures (backpressure disconnects,\n              // transform-stream exceptions, …) were previously swallowed\n              // silently — `streamClosed` stayed `false` and the next\n              // event re-attempted a broken writer. Log and mark the\n              // stream closed so we stop trying.\n              logError(error);\n              streamClosed = true;\n            }\n          }\n        }\n      },\n      error: async (error) => {\n        reportAgentError(error, \"sse.subscription\");\n        if (captureTelemetry) {\n          telemetry.capture(\"oss.runtime.agent_execution_stream_errored\", {\n            error: error instanceof Error ? error.message : String(error),\n          });\n        }\n        if (debug?.lifecycle) {\n          debugLogger!.debug(\n            { error: error instanceof Error ? error.message : String(error) },\n            \"SSE stream errored\",\n          );\n        }\n        logError(error);\n        await closeStream();\n      },\n      complete: async () => {\n        if (captureTelemetry) {\n          telemetry.capture(\"oss.runtime.agent_execution_stream_ended\", {});\n        }\n        if (debug?.lifecycle) {\n          debugLogger!.debug(\n            { eventCount, loggedEventCount },\n            \"SSE stream completed\",\n          );\n        }\n        await closeStream();\n      },\n    });\n\n    // If the client disconnected before the subscription was created,\n    // unsubscribe immediately to avoid leaking the observable.\n    if (request.signal.aborted) {\n      subscription.unsubscribe();\n    }\n  })().catch(async (error) => {\n    reportAgentError(error, \"sse.factory\");\n    logError(error);\n    await closeStream();\n  });\n\n  request.signal.addEventListener(\"abort\", () => {\n    subscription?.unsubscribe();\n  });\n\n  return new Response(stream.readable, {\n    status: 200,\n    headers: {\n      \"Content-Type\": \"text/event-stream\",\n      \"Cache-Control\": \"no-cache\",\n      Connection: \"keep-alive\",\n    },\n  });\n}\n\nfunction summarizeEvent(event: BaseEvent): Record<string, unknown> {\n  const e = event as any;\n  const summary: Record<string, unknown> = {};\n\n  if (e.messageId) summary.messageId = e.messageId;\n  if (e.toolCallId) summary.toolCallId = e.toolCallId;\n  if (e.toolCallName) summary.toolCallName = e.toolCallName;\n  if (e.role) summary.role = e.role;\n  if (e.delta != null && typeof e.delta === \"string\")\n    summary.deltaLength = e.delta.length;\n  if (e.snapshot && typeof e.snapshot === \"object\")\n    summary.snapshotKeys = Object.keys(e.snapshot);\n  if (e.delta && Array.isArray(e.delta))\n    summary.operationCount = e.delta.length;\n  if (e.threadId) summary.threadId = e.threadId;\n  if (e.runId) summary.runId = e.runId;\n  if (e.message) summary.message = e.message;\n  if (e.code) summary.code = e.code;\n  if (e.stepName) summary.stepName = e.stepName;\n\n  return summary;\n}\n"],"mappings":"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"}
+{"version":3,"file":"sse-response.cjs","names":["defaultTelemetry","EventEncoder","createLogger"],"sources":["../../../../../src/v2/runtime/handlers/shared/sse-response.ts"],"sourcesContent":["import type { BaseEvent } from \"@ag-ui/client\";\nimport { EventEncoder } from \"@ag-ui/encoder\";\nimport type { Observable, Subscription } from \"rxjs\";\nimport type { ResolvedDebugConfig } from \"@copilotkit/shared\";\nimport { createLogger } from \"../../../../v1-deprecated/lib/logger\";\nimport type { CopilotRuntimeLogger } from \"../../../../v1-deprecated/lib/logger\";\nimport { telemetry as defaultTelemetry } from \"../../telemetry\";\nimport type { TelemetryCapture } from \"../../telemetry/telemetry-client\";\nimport type { DebugEventBus } from \"../../core/debug-event-bus\";\nimport type {\n  RuntimeErrorPhase,\n  RuntimeErrorReporter,\n} from \"../../core/runtime-error-reporter\";\n\ninterface CreateSseEventResponseParams {\n  request: Request;\n  observableFactory: () =>\n    | Promise<Observable<BaseEvent>>\n    | Observable<BaseEvent>;\n  debugEventBus?: DebugEventBus;\n  agentId?: string;\n  debug?: ResolvedDebugConfig;\n  /** Pre-created logger instance to avoid creating a new pino logger per request. */\n  logger?: CopilotRuntimeLogger;\n  /** Runtime-bound telemetry capture. Falls back for external direct callers. */\n  telemetry?: TelemetryCapture;\n  /**\n   * Whether to emit `oss.runtime.agent_execution_stream_*` telemetry for this\n   * stream. Defaults to `true`. The stateless `/suggest` path sets this to\n   * `false`: a suggestion is a side-effect-free structured completion, not a\n   * tracked run, and under `available: \"always\"` it fires often enough to flood\n   * run telemetry.\n   */\n  captureTelemetry?: boolean;\n  runtimeErrorReporter?: RuntimeErrorReporter;\n  startTime?: number;\n}\n\nexport function createSseEventResponse({\n  request,\n  observableFactory,\n  debugEventBus,\n  agentId,\n  debug,\n  logger,\n  telemetry = defaultTelemetry,\n  captureTelemetry = true,\n  runtimeErrorReporter,\n  startTime,\n}: CreateSseEventResponseParams): Response {\n  const stream = new TransformStream();\n  const writer = stream.writable.getWriter();\n  const encoder = new EventEncoder();\n  let streamClosed = false;\n  let debugThreadId = \"\";\n  let debugRunId = \"\";\n\n  const debugLogger = debug?.enabled\n    ? (logger ??\n      createLogger({ level: \"debug\", component: \"copilotkit-debug\" }))\n    : undefined;\n\n  const closeStream = async () => {\n    if (!streamClosed) {\n      try {\n        await writer.close();\n        streamClosed = true;\n      } catch {\n        // Stream already closed.\n      }\n    }\n  };\n\n  const logError = (error: unknown) => {\n    console.error(\"Error running agent:\", error);\n    console.error(\n      \"Error stack:\",\n      error instanceof Error ? error.stack : \"No stack trace\",\n    );\n    console.error(\"Error details:\", {\n      name: error instanceof Error ? error.name : \"Unknown\",\n      message: error instanceof Error ? error.message : String(error),\n      cause: error instanceof Error ? error.cause : undefined,\n    });\n  };\n\n  let subscription: Subscription | undefined;\n  let agentErrorReported = false;\n\n  const reportAgentError = (error: unknown, phase: RuntimeErrorPhase) => {\n    if (agentErrorReported) return;\n    agentErrorReported = true;\n    runtimeErrorReporter?.report({\n      request,\n      error,\n      operation: \"agent.run\",\n      agentId,\n      threadId: debugThreadId || undefined,\n      runId: debugRunId || undefined,\n      phase,\n      startTime,\n    });\n  };\n\n  (async () => {\n    const observable = await observableFactory();\n\n    if (captureTelemetry) {\n      telemetry.capture(\"oss.runtime.agent_execution_stream_started\", {});\n    }\n\n    if (debug?.lifecycle) {\n      debugLogger!.debug(\"SSE stream opened\");\n    }\n\n    let eventCount = 0;\n    let loggedEventCount = 0;\n\n    subscription = observable.subscribe({\n      next: async (event) => {\n        // Extract threadId/runId from RUN_STARTED\n        if (event.type === \"RUN_STARTED\") {\n          const e = event as { threadId?: string; runId?: string };\n          debugThreadId = e.threadId ?? \"\";\n          debugRunId = e.runId ?? \"\";\n        }\n\n        if (event.type === \"RUN_ERROR\") {\n          const e = event as {\n            message?: unknown;\n            threadId?: string;\n            runId?: string;\n          };\n          debugThreadId = e.threadId ?? debugThreadId;\n          debugRunId = e.runId ?? debugRunId;\n          reportAgentError(\n            new Error(\n              typeof e.message === \"string\"\n                ? e.message\n                : \"Runner reported a run error\",\n            ),\n            \"sse.subscription\",\n          );\n        }\n\n        // Broadcast to debug listeners BEFORE the stream-closed gate below.\n        // Intentional: debug subscribers (e.g. the VS Code Inspector panel)\n        // should still receive trailing events after the SSE client for\n        // this request closed its connection — they're independent\n        // consumers observing the underlying runtime, not the request's\n        // response stream.\n        //\n        // Wrapped in try/catch so a buggy debug subscriber can't propagate\n        // an exception into this observer — if the throw reached the\n        // `next` callback it would get routed to `error` by RxJS, closing\n        // the SSE stream for an unrelated reason. Log via `logError` and\n        // move on.\n        if (debugEventBus) {\n          try {\n            debugEventBus.broadcast(event, {\n              agentId: agentId ?? \"\",\n              threadId: debugThreadId,\n              runId: debugRunId,\n            });\n          } catch (broadcastError) {\n            logError(broadcastError);\n          }\n        }\n\n        if (!request.signal.aborted && !streamClosed) {\n          try {\n            eventCount++;\n            if (debug?.events) {\n              loggedEventCount++;\n              if (debug.verbose) {\n                debugLogger!.debug({ event }, \"Event emitted\");\n              } else {\n                debugLogger!.debug(\n                  { type: event.type, ...summarizeEvent(event) },\n                  \"Event emitted\",\n                );\n              }\n            }\n            await writer.write(encoder.encodeBinary(event));\n          } catch (error) {\n            if (error instanceof Error && error.name === \"AbortError\") {\n              streamClosed = true;\n            } else {\n              // Non-abort write failures (backpressure disconnects,\n              // transform-stream exceptions, …) were previously swallowed\n              // silently — `streamClosed` stayed `false` and the next\n              // event re-attempted a broken writer. Log and mark the\n              // stream closed so we stop trying.\n              logError(error);\n              streamClosed = true;\n            }\n          }\n        }\n      },\n      error: async (error) => {\n        reportAgentError(error, \"sse.subscription\");\n        if (captureTelemetry) {\n          telemetry.capture(\"oss.runtime.agent_execution_stream_errored\", {\n            error: error instanceof Error ? error.message : String(error),\n          });\n        }\n        if (debug?.lifecycle) {\n          debugLogger!.debug(\n            { error: error instanceof Error ? error.message : String(error) },\n            \"SSE stream errored\",\n          );\n        }\n        logError(error);\n        await closeStream();\n      },\n      complete: async () => {\n        if (captureTelemetry) {\n          telemetry.capture(\"oss.runtime.agent_execution_stream_ended\", {});\n        }\n        if (debug?.lifecycle) {\n          debugLogger!.debug(\n            { eventCount, loggedEventCount },\n            \"SSE stream completed\",\n          );\n        }\n        await closeStream();\n      },\n    });\n\n    // If the client disconnected before the subscription was created,\n    // unsubscribe immediately to avoid leaking the observable.\n    if (request.signal.aborted) {\n      subscription.unsubscribe();\n    }\n  })().catch(async (error) => {\n    reportAgentError(error, \"sse.factory\");\n    logError(error);\n    await closeStream();\n  });\n\n  request.signal.addEventListener(\"abort\", () => {\n    subscription?.unsubscribe();\n  });\n\n  return new Response(stream.readable, {\n    status: 200,\n    headers: {\n      \"Content-Type\": \"text/event-stream\",\n      \"Cache-Control\": \"no-cache\",\n      Connection: \"keep-alive\",\n    },\n  });\n}\n\nfunction summarizeEvent(event: BaseEvent): Record<string, unknown> {\n  const e = event as any;\n  const summary: Record<string, unknown> = {};\n\n  if (e.messageId) summary.messageId = e.messageId;\n  if (e.toolCallId) summary.toolCallId = e.toolCallId;\n  if (e.toolCallName) summary.toolCallName = e.toolCallName;\n  if (e.role) summary.role = e.role;\n  if (e.delta != null && typeof e.delta === \"string\")\n    summary.deltaLength = e.delta.length;\n  if (e.snapshot && typeof e.snapshot === \"object\")\n    summary.snapshotKeys = Object.keys(e.snapshot);\n  if (e.delta && Array.isArray(e.delta))\n    summary.operationCount = e.delta.length;\n  if (e.threadId) summary.threadId = e.threadId;\n  if (e.runId) summary.runId = e.runId;\n  if (e.message) summary.message = e.message;\n  if (e.code) summary.code = e.code;\n  if (e.stepName) summary.stepName = e.stepName;\n\n  return summary;\n}\n"],"mappings":"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"}

package/dist/v2/runtime/handlers/shared/sse-response.mjs

@@ -84,7 +84,7 @@ function createSseEventResponse({ request, observableFactory, debugEventBus, age
 							...summarizeEvent(event)
 						}, "Event emitted");
 					}
-					await writer.write(encoder.encode(event));
+					await writer.write(encoder.encodeBinary(event));
 				} catch (error) {
 					if (error instanceof Error && error.name === "AbortError") streamClosed = true;
 					else {

package/dist/v2/runtime/handlers/shared/sse-response.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"sse-response.mjs","names":["defaultTelemetry"],"sources":["../../../../../src/v2/runtime/handlers/shared/sse-response.ts"],"sourcesContent":["import type { BaseEvent } from \"@ag-ui/client\";\nimport { EventEncoder } from \"@ag-ui/encoder\";\nimport type { Observable, Subscription } from \"rxjs\";\nimport type { ResolvedDebugConfig } from \"@copilotkit/shared\";\nimport { createLogger } from \"../../../../v1-deprecated/lib/logger\";\nimport type { CopilotRuntimeLogger } from \"../../../../v1-deprecated/lib/logger\";\nimport { telemetry as defaultTelemetry } from \"../../telemetry\";\nimport type { TelemetryCapture } from \"../../telemetry/telemetry-client\";\nimport type { DebugEventBus } from \"../../core/debug-event-bus\";\nimport type {\n  RuntimeErrorPhase,\n  RuntimeErrorReporter,\n} from \"../../core/runtime-error-reporter\";\n\ninterface CreateSseEventResponseParams {\n  request: Request;\n  observableFactory: () =>\n    | Promise<Observable<BaseEvent>>\n    | Observable<BaseEvent>;\n  debugEventBus?: DebugEventBus;\n  agentId?: string;\n  debug?: ResolvedDebugConfig;\n  /** Pre-created logger instance to avoid creating a new pino logger per request. */\n  logger?: CopilotRuntimeLogger;\n  /** Runtime-bound telemetry capture. Falls back for external direct callers. */\n  telemetry?: TelemetryCapture;\n  /**\n   * Whether to emit `oss.runtime.agent_execution_stream_*` telemetry for this\n   * stream. Defaults to `true`. The stateless `/suggest` path sets this to\n   * `false`: a suggestion is a side-effect-free structured completion, not a\n   * tracked run, and under `available: \"always\"` it fires often enough to flood\n   * run telemetry.\n   */\n  captureTelemetry?: boolean;\n  runtimeErrorReporter?: RuntimeErrorReporter;\n  startTime?: number;\n}\n\nexport function createSseEventResponse({\n  request,\n  observableFactory,\n  debugEventBus,\n  agentId,\n  debug,\n  logger,\n  telemetry = defaultTelemetry,\n  captureTelemetry = true,\n  runtimeErrorReporter,\n  startTime,\n}: CreateSseEventResponseParams): Response {\n  const stream = new TransformStream();\n  const writer = stream.writable.getWriter();\n  const encoder = new EventEncoder();\n  let streamClosed = false;\n  let debugThreadId = \"\";\n  let debugRunId = \"\";\n\n  const debugLogger = debug?.enabled\n    ? (logger ??\n      createLogger({ level: \"debug\", component: \"copilotkit-debug\" }))\n    : undefined;\n\n  const closeStream = async () => {\n    if (!streamClosed) {\n      try {\n        await writer.close();\n        streamClosed = true;\n      } catch {\n        // Stream already closed.\n      }\n    }\n  };\n\n  const logError = (error: unknown) => {\n    console.error(\"Error running agent:\", error);\n    console.error(\n      \"Error stack:\",\n      error instanceof Error ? error.stack : \"No stack trace\",\n    );\n    console.error(\"Error details:\", {\n      name: error instanceof Error ? error.name : \"Unknown\",\n      message: error instanceof Error ? error.message : String(error),\n      cause: error instanceof Error ? error.cause : undefined,\n    });\n  };\n\n  let subscription: Subscription | undefined;\n  let agentErrorReported = false;\n\n  const reportAgentError = (error: unknown, phase: RuntimeErrorPhase) => {\n    if (agentErrorReported) return;\n    agentErrorReported = true;\n    runtimeErrorReporter?.report({\n      request,\n      error,\n      operation: \"agent.run\",\n      agentId,\n      threadId: debugThreadId || undefined,\n      runId: debugRunId || undefined,\n      phase,\n      startTime,\n    });\n  };\n\n  (async () => {\n    const observable = await observableFactory();\n\n    if (captureTelemetry) {\n      telemetry.capture(\"oss.runtime.agent_execution_stream_started\", {});\n    }\n\n    if (debug?.lifecycle) {\n      debugLogger!.debug(\"SSE stream opened\");\n    }\n\n    let eventCount = 0;\n    let loggedEventCount = 0;\n\n    subscription = observable.subscribe({\n      next: async (event) => {\n        // Extract threadId/runId from RUN_STARTED\n        if (event.type === \"RUN_STARTED\") {\n          const e = event as { threadId?: string; runId?: string };\n          debugThreadId = e.threadId ?? \"\";\n          debugRunId = e.runId ?? \"\";\n        }\n\n        if (event.type === \"RUN_ERROR\") {\n          const e = event as {\n            message?: unknown;\n            threadId?: string;\n            runId?: string;\n          };\n          debugThreadId = e.threadId ?? debugThreadId;\n          debugRunId = e.runId ?? debugRunId;\n          reportAgentError(\n            new Error(\n              typeof e.message === \"string\"\n                ? e.message\n                : \"Runner reported a run error\",\n            ),\n            \"sse.subscription\",\n          );\n        }\n\n        // Broadcast to debug listeners BEFORE the stream-closed gate below.\n        // Intentional: debug subscribers (e.g. the VS Code Inspector panel)\n        // should still receive trailing events after the SSE client for\n        // this request closed its connection — they're independent\n        // consumers observing the underlying runtime, not the request's\n        // response stream.\n        //\n        // Wrapped in try/catch so a buggy debug subscriber can't propagate\n        // an exception into this observer — if the throw reached the\n        // `next` callback it would get routed to `error` by RxJS, closing\n        // the SSE stream for an unrelated reason. Log via `logError` and\n        // move on.\n        if (debugEventBus) {\n          try {\n            debugEventBus.broadcast(event, {\n              agentId: agentId ?? \"\",\n              threadId: debugThreadId,\n              runId: debugRunId,\n            });\n          } catch (broadcastError) {\n            logError(broadcastError);\n          }\n        }\n\n        if (!request.signal.aborted && !streamClosed) {\n          try {\n            eventCount++;\n            if (debug?.events) {\n              loggedEventCount++;\n              if (debug.verbose) {\n                debugLogger!.debug({ event }, \"Event emitted\");\n              } else {\n                debugLogger!.debug(\n                  { type: event.type, ...summarizeEvent(event) },\n                  \"Event emitted\",\n                );\n              }\n            }\n            await writer.write(encoder.encode(event));\n          } catch (error) {\n            if (error instanceof Error && error.name === \"AbortError\") {\n              streamClosed = true;\n            } else {\n              // Non-abort write failures (backpressure disconnects,\n              // transform-stream exceptions, …) were previously swallowed\n              // silently — `streamClosed` stayed `false` and the next\n              // event re-attempted a broken writer. Log and mark the\n              // stream closed so we stop trying.\n              logError(error);\n              streamClosed = true;\n            }\n          }\n        }\n      },\n      error: async (error) => {\n        reportAgentError(error, \"sse.subscription\");\n        if (captureTelemetry) {\n          telemetry.capture(\"oss.runtime.agent_execution_stream_errored\", {\n            error: error instanceof Error ? error.message : String(error),\n          });\n        }\n        if (debug?.lifecycle) {\n          debugLogger!.debug(\n            { error: error instanceof Error ? error.message : String(error) },\n            \"SSE stream errored\",\n          );\n        }\n        logError(error);\n        await closeStream();\n      },\n      complete: async () => {\n        if (captureTelemetry) {\n          telemetry.capture(\"oss.runtime.agent_execution_stream_ended\", {});\n        }\n        if (debug?.lifecycle) {\n          debugLogger!.debug(\n            { eventCount, loggedEventCount },\n            \"SSE stream completed\",\n          );\n        }\n        await closeStream();\n      },\n    });\n\n    // If the client disconnected before the subscription was created,\n    // unsubscribe immediately to avoid leaking the observable.\n    if (request.signal.aborted) {\n      subscription.unsubscribe();\n    }\n  })().catch(async (error) => {\n    reportAgentError(error, \"sse.factory\");\n    logError(error);\n    await closeStream();\n  });\n\n  request.signal.addEventListener(\"abort\", () => {\n    subscription?.unsubscribe();\n  });\n\n  return new Response(stream.readable, {\n    status: 200,\n    headers: {\n      \"Content-Type\": \"text/event-stream\",\n      \"Cache-Control\": \"no-cache\",\n      Connection: \"keep-alive\",\n    },\n  });\n}\n\nfunction summarizeEvent(event: BaseEvent): Record<string, unknown> {\n  const e = event as any;\n  const summary: Record<string, unknown> = {};\n\n  if (e.messageId) summary.messageId = e.messageId;\n  if (e.toolCallId) summary.toolCallId = e.toolCallId;\n  if (e.toolCallName) summary.toolCallName = e.toolCallName;\n  if (e.role) summary.role = e.role;\n  if (e.delta != null && typeof e.delta === \"string\")\n    summary.deltaLength = e.delta.length;\n  if (e.snapshot && typeof e.snapshot === \"object\")\n    summary.snapshotKeys = Object.keys(e.snapshot);\n  if (e.delta && Array.isArray(e.delta))\n    summary.operationCount = e.delta.length;\n  if (e.threadId) summary.threadId = e.threadId;\n  if (e.runId) summary.runId = e.runId;\n  if (e.message) summary.message = e.message;\n  if (e.code) summary.code = e.code;\n  if (e.stepName) summary.stepName = e.stepName;\n\n  return summary;\n}\n"],"mappings":"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"}
+{"version":3,"file":"sse-response.mjs","names":["defaultTelemetry"],"sources":["../../../../../src/v2/runtime/handlers/shared/sse-response.ts"],"sourcesContent":["import type { BaseEvent } from \"@ag-ui/client\";\nimport { EventEncoder } from \"@ag-ui/encoder\";\nimport type { Observable, Subscription } from \"rxjs\";\nimport type { ResolvedDebugConfig } from \"@copilotkit/shared\";\nimport { createLogger } from \"../../../../v1-deprecated/lib/logger\";\nimport type { CopilotRuntimeLogger } from \"../../../../v1-deprecated/lib/logger\";\nimport { telemetry as defaultTelemetry } from \"../../telemetry\";\nimport type { TelemetryCapture } from \"../../telemetry/telemetry-client\";\nimport type { DebugEventBus } from \"../../core/debug-event-bus\";\nimport type {\n  RuntimeErrorPhase,\n  RuntimeErrorReporter,\n} from \"../../core/runtime-error-reporter\";\n\ninterface CreateSseEventResponseParams {\n  request: Request;\n  observableFactory: () =>\n    | Promise<Observable<BaseEvent>>\n    | Observable<BaseEvent>;\n  debugEventBus?: DebugEventBus;\n  agentId?: string;\n  debug?: ResolvedDebugConfig;\n  /** Pre-created logger instance to avoid creating a new pino logger per request. */\n  logger?: CopilotRuntimeLogger;\n  /** Runtime-bound telemetry capture. Falls back for external direct callers. */\n  telemetry?: TelemetryCapture;\n  /**\n   * Whether to emit `oss.runtime.agent_execution_stream_*` telemetry for this\n   * stream. Defaults to `true`. The stateless `/suggest` path sets this to\n   * `false`: a suggestion is a side-effect-free structured completion, not a\n   * tracked run, and under `available: \"always\"` it fires often enough to flood\n   * run telemetry.\n   */\n  captureTelemetry?: boolean;\n  runtimeErrorReporter?: RuntimeErrorReporter;\n  startTime?: number;\n}\n\nexport function createSseEventResponse({\n  request,\n  observableFactory,\n  debugEventBus,\n  agentId,\n  debug,\n  logger,\n  telemetry = defaultTelemetry,\n  captureTelemetry = true,\n  runtimeErrorReporter,\n  startTime,\n}: CreateSseEventResponseParams): Response {\n  const stream = new TransformStream();\n  const writer = stream.writable.getWriter();\n  const encoder = new EventEncoder();\n  let streamClosed = false;\n  let debugThreadId = \"\";\n  let debugRunId = \"\";\n\n  const debugLogger = debug?.enabled\n    ? (logger ??\n      createLogger({ level: \"debug\", component: \"copilotkit-debug\" }))\n    : undefined;\n\n  const closeStream = async () => {\n    if (!streamClosed) {\n      try {\n        await writer.close();\n        streamClosed = true;\n      } catch {\n        // Stream already closed.\n      }\n    }\n  };\n\n  const logError = (error: unknown) => {\n    console.error(\"Error running agent:\", error);\n    console.error(\n      \"Error stack:\",\n      error instanceof Error ? error.stack : \"No stack trace\",\n    );\n    console.error(\"Error details:\", {\n      name: error instanceof Error ? error.name : \"Unknown\",\n      message: error instanceof Error ? error.message : String(error),\n      cause: error instanceof Error ? error.cause : undefined,\n    });\n  };\n\n  let subscription: Subscription | undefined;\n  let agentErrorReported = false;\n\n  const reportAgentError = (error: unknown, phase: RuntimeErrorPhase) => {\n    if (agentErrorReported) return;\n    agentErrorReported = true;\n    runtimeErrorReporter?.report({\n      request,\n      error,\n      operation: \"agent.run\",\n      agentId,\n      threadId: debugThreadId || undefined,\n      runId: debugRunId || undefined,\n      phase,\n      startTime,\n    });\n  };\n\n  (async () => {\n    const observable = await observableFactory();\n\n    if (captureTelemetry) {\n      telemetry.capture(\"oss.runtime.agent_execution_stream_started\", {});\n    }\n\n    if (debug?.lifecycle) {\n      debugLogger!.debug(\"SSE stream opened\");\n    }\n\n    let eventCount = 0;\n    let loggedEventCount = 0;\n\n    subscription = observable.subscribe({\n      next: async (event) => {\n        // Extract threadId/runId from RUN_STARTED\n        if (event.type === \"RUN_STARTED\") {\n          const e = event as { threadId?: string; runId?: string };\n          debugThreadId = e.threadId ?? \"\";\n          debugRunId = e.runId ?? \"\";\n        }\n\n        if (event.type === \"RUN_ERROR\") {\n          const e = event as {\n            message?: unknown;\n            threadId?: string;\n            runId?: string;\n          };\n          debugThreadId = e.threadId ?? debugThreadId;\n          debugRunId = e.runId ?? debugRunId;\n          reportAgentError(\n            new Error(\n              typeof e.message === \"string\"\n                ? e.message\n                : \"Runner reported a run error\",\n            ),\n            \"sse.subscription\",\n          );\n        }\n\n        // Broadcast to debug listeners BEFORE the stream-closed gate below.\n        // Intentional: debug subscribers (e.g. the VS Code Inspector panel)\n        // should still receive trailing events after the SSE client for\n        // this request closed its connection — they're independent\n        // consumers observing the underlying runtime, not the request's\n        // response stream.\n        //\n        // Wrapped in try/catch so a buggy debug subscriber can't propagate\n        // an exception into this observer — if the throw reached the\n        // `next` callback it would get routed to `error` by RxJS, closing\n        // the SSE stream for an unrelated reason. Log via `logError` and\n        // move on.\n        if (debugEventBus) {\n          try {\n            debugEventBus.broadcast(event, {\n              agentId: agentId ?? \"\",\n              threadId: debugThreadId,\n              runId: debugRunId,\n            });\n          } catch (broadcastError) {\n            logError(broadcastError);\n          }\n        }\n\n        if (!request.signal.aborted && !streamClosed) {\n          try {\n            eventCount++;\n            if (debug?.events) {\n              loggedEventCount++;\n              if (debug.verbose) {\n                debugLogger!.debug({ event }, \"Event emitted\");\n              } else {\n                debugLogger!.debug(\n                  { type: event.type, ...summarizeEvent(event) },\n                  \"Event emitted\",\n                );\n              }\n            }\n            await writer.write(encoder.encodeBinary(event));\n          } catch (error) {\n            if (error instanceof Error && error.name === \"AbortError\") {\n              streamClosed = true;\n            } else {\n              // Non-abort write failures (backpressure disconnects,\n              // transform-stream exceptions, …) were previously swallowed\n              // silently — `streamClosed` stayed `false` and the next\n              // event re-attempted a broken writer. Log and mark the\n              // stream closed so we stop trying.\n              logError(error);\n              streamClosed = true;\n            }\n          }\n        }\n      },\n      error: async (error) => {\n        reportAgentError(error, \"sse.subscription\");\n        if (captureTelemetry) {\n          telemetry.capture(\"oss.runtime.agent_execution_stream_errored\", {\n            error: error instanceof Error ? error.message : String(error),\n          });\n        }\n        if (debug?.lifecycle) {\n          debugLogger!.debug(\n            { error: error instanceof Error ? error.message : String(error) },\n            \"SSE stream errored\",\n          );\n        }\n        logError(error);\n        await closeStream();\n      },\n      complete: async () => {\n        if (captureTelemetry) {\n          telemetry.capture(\"oss.runtime.agent_execution_stream_ended\", {});\n        }\n        if (debug?.lifecycle) {\n          debugLogger!.debug(\n            { eventCount, loggedEventCount },\n            \"SSE stream completed\",\n          );\n        }\n        await closeStream();\n      },\n    });\n\n    // If the client disconnected before the subscription was created,\n    // unsubscribe immediately to avoid leaking the observable.\n    if (request.signal.aborted) {\n      subscription.unsubscribe();\n    }\n  })().catch(async (error) => {\n    reportAgentError(error, \"sse.factory\");\n    logError(error);\n    await closeStream();\n  });\n\n  request.signal.addEventListener(\"abort\", () => {\n    subscription?.unsubscribe();\n  });\n\n  return new Response(stream.readable, {\n    status: 200,\n    headers: {\n      \"Content-Type\": \"text/event-stream\",\n      \"Cache-Control\": \"no-cache\",\n      Connection: \"keep-alive\",\n    },\n  });\n}\n\nfunction summarizeEvent(event: BaseEvent): Record<string, unknown> {\n  const e = event as any;\n  const summary: Record<string, unknown> = {};\n\n  if (e.messageId) summary.messageId = e.messageId;\n  if (e.toolCallId) summary.toolCallId = e.toolCallId;\n  if (e.toolCallName) summary.toolCallName = e.toolCallName;\n  if (e.role) summary.role = e.role;\n  if (e.delta != null && typeof e.delta === \"string\")\n    summary.deltaLength = e.delta.length;\n  if (e.snapshot && typeof e.snapshot === \"object\")\n    summary.snapshotKeys = Object.keys(e.snapshot);\n  if (e.delta && Array.isArray(e.delta))\n    summary.operationCount = e.delta.length;\n  if (e.threadId) summary.threadId = e.threadId;\n  if (e.runId) summary.runId = e.runId;\n  if (e.message) summary.message = e.message;\n  if (e.code) summary.code = e.code;\n  if (e.stepName) summary.stepName = e.stepName;\n\n  return summary;\n}\n"],"mappings":"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"}

package/dist/v2/runtime/intelligence-platform/client.cjs

@@ -18,7 +18,11 @@ function isRetryableRuntimeEntitlementStatus(status) {
 }
 const runtimeEntitlementSchema = zod.z.object({
 	active: zod.z.boolean(),
-	source: zod.z.enum(["managedOrgSubscription", "selfHostedDeploymentLicense"]),
+	source: zod.z.enum([
+		"managedOrgSubscription",
+		"selfHostedDeploymentLicense",
+		"awsMarketplaceDeploymentLicense"
+	]),
 	features: zod.z.record(zod.z.string(), zod.z.boolean()),
 	limits: zod.z.record(zod.z.string(), zod.z.number()),
 	planCode: zod.z.string().optional(),
@@ -99,6 +103,7 @@ const MANAGED_INTELLIGENCE_API_URL = "https://api.intelligence.copilotkit.ai";
 const MANAGED_INTELLIGENCE_WS_URL = "wss://realtime.intelligence.copilotkit.ai";
 /** Maximum time spent on the optional Inspector metadata provider request. */
 const INSPECTOR_METADATA_REQUEST_TIMEOUT_MS = 5e3;
+const INSPECTOR_LEARNING_REQUEST_TIMEOUT_MS = 5e3;
 /**
 * Error thrown when a CopilotKit Intelligence HTTP request returns a non-2xx
 * status. Carries the HTTP {@link status} code so callers can branch on
@@ -195,6 +200,7 @@ var CopilotKitIntelligence = class {
 	#threadDeletedListeners = /* @__PURE__ */ new Set();
 	constructor(config) {
 		if (config.getLearningContainerId !== void 0 && typeof config.getLearningContainerId !== "function") throw new Error("CopilotKitIntelligence `getLearningContainerId` must be a callback");
+		assertConfiguredApiKey(config.apiKey);
 		const configuredApiUrl = configuredUrl(config.apiUrl);
 		const configuredWsUrl = configuredUrl(config.wsUrl);
 		warnOnPartialHostOverride(configuredApiUrl, configuredWsUrl);
@@ -340,6 +346,30 @@ var CopilotKitIntelligence = class {
 			if (timeoutId !== void 0) clearTimeout(timeoutId);
 		}
 	}
+	/** Fetches one credential-scoped, bounded Learning projection for Inspector. */
+	async getInspectorLearning(request) {
+		const url = new URL(`${this.#apiUrl}/api/inspector/learning`);
+		if (request.agentId) url.searchParams.set("agentId", request.agentId);
+		if (request.skillsPage) url.searchParams.set("skillsPage", String(request.skillsPage));
+		if (request.insightsPage) url.searchParams.set("insightsPage", String(request.insightsPage));
+		if (request.runtimeContainerId) url.searchParams.set("runtimeContainerId", request.runtimeContainerId);
+		const controller = new AbortController();
+		const timeoutError = /* @__PURE__ */ new Error("Intelligence Inspector Learning request timed out");
+		const timeout = setTimeout(() => controller.abort(timeoutError), INSPECTOR_LEARNING_REQUEST_TIMEOUT_MS);
+		try {
+			const response = await fetch(url, {
+				method: "GET",
+				headers: { Authorization: `Bearer ${this.#apiKey}` },
+				signal: controller.signal
+			});
+			if (!response.ok) throw new PlatformRequestError(`Intelligence platform error ${response.status}`, response.status, response.status === 429 || response.status >= 500);
+			const snapshot = (0, _copilotkit_shared.parseInspectorLearningSnapshotV1)(await response.json());
+			if (!snapshot) throw new PlatformRequestError("Invalid Inspector Learning response", 502, true);
+			return snapshot;
+		} finally {
+			clearTimeout(timeout);
+		}
+	}
 	/**
 	* Resolve the Runtime entitlement projection for this project.
 	*
@@ -820,6 +850,24 @@ function configuredUrl(url) {
 	return trimmed ? trimmed : void 0;
 }
 /**
+* Reject an Intelligence project API key that carries no credential.
+*
+* `apiKey` is required on the config type, so TypeScript catches an absent
+* property. It does not catch an empty one, and the common shape is a
+* `process.env` read that TypeScript is told to trust — `?? ""` in the starter
+* wiring block, `!` in this file's own examples. When the variable is unset,
+* both produce a blank key that is sent verbatim as `Authorization: Bearer `
+* and fails much later as a 401 that points at nothing.
+*
+* A runtime with no credential cannot serve managed Intelligence, so this
+* throws at construction: callers build the client during boot, which puts the
+* error at startup rather than on a user's first message.
+*/
+function assertConfiguredApiKey(apiKey) {
+	if (typeof apiKey === "string" && apiKey.trim() !== "") return;
+	throw new Error("CopilotKitIntelligence `apiKey` is required and cannot be blank. It is the CopilotKit Intelligence project API key, normally read from the CPK_INTELLIGENCE_API_KEY environment variable. Run `copilotkit project select` to provision one for your project.");
+}
+/**
 * Warn when exactly one of `apiUrl`/`wsUrl` is configured. The API and realtime
 * planes are separate hosts, so a lone override silently leaves the other plane
 * on CopilotKit's managed platform — a self-hosted API paired with the managed