@copilotkit/shared 1.70.0 → 1.70.2

package/dist/utils/inspector-learning.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspector-learning.mjs","names":[],"sources":["../../src/utils/inspector-learning.ts"],"sourcesContent":["/** A bounded page in the Inspector Learning snapshot. */\nexport interface InspectorLearningPage<T> {\n  readonly page: number;\n  readonly pageSize: number;\n  readonly total: number;\n  readonly totalPages: number;\n  readonly items: readonly T[];\n}\n\nexport type InspectorLearningEvidence =\n  | {\n      readonly status: \"available\";\n      readonly threadId: string;\n      readonly threadName: string | null;\n      readonly messageIds: readonly string[];\n      readonly updatedAt: string;\n    }\n  | { readonly status: \"unavailable\" };\n\nexport interface InspectorLearningInsight {\n  readonly id: string;\n  readonly statement: string;\n  readonly impact: string;\n  readonly totalThreadCount: number;\n  readonly evidenceTruncated: boolean;\n  readonly evidence: readonly InspectorLearningEvidence[];\n}\n\nexport interface InspectorLearningSkill {\n  readonly id: string;\n  readonly name: string;\n  readonly description: string;\n  readonly revision: number;\n  readonly skillMd: string;\n  readonly sourceInsight: InspectorLearningInsight | null;\n}\n\nexport interface InspectorLearningSnapshotV1 {\n  readonly schemaVersion: 1;\n  readonly projectKey: string;\n  readonly snapshotVersion: string;\n  readonly webAppOrigin: string;\n  readonly configuration:\n    | { readonly state: \"not_configured\" }\n    | {\n        readonly state: \"invalid\";\n        readonly reason: \"container\" | \"instrumentation\";\n      }\n    | {\n        readonly state: \"configured\";\n        readonly container: { readonly id: string; readonly name: string };\n      }\n    | { readonly state: \"selection_required\" };\n  readonly pendingThreadCount: number;\n  readonly run: {\n    readonly hasActiveRun: boolean;\n    readonly hasEverSucceeded: boolean;\n    readonly latest: {\n      readonly completedAt: string | null;\n      readonly status:\n        | \"queued\"\n        | \"freezing\"\n        | \"batching\"\n        | \"reducing\"\n        | \"finalizing\"\n        | \"succeeded\"\n        | \"failed\";\n    } | null;\n  };\n  readonly pendingCandidateCount: number;\n  readonly skillsPage: InspectorLearningPage<InspectorLearningSkill>;\n  readonly insightsPage: InspectorLearningPage<InspectorLearningInsight>;\n  readonly links: {\n    readonly learning: string;\n    readonly candidates: string | null;\n    readonly runs: string | null;\n  };\n}\n\nexport interface InspectorLearningRequestV1 {\n  readonly agentId?: string;\n  readonly skillsPage?: number;\n  readonly insightsPage?: number;\n}\n\ntype RecordValue = Record<string, unknown>;\n\nconst record = (value: unknown): value is RecordValue =>\n  typeof value === \"object\" && value !== null && !Array.isArray(value);\nconst string = (value: unknown, maximum: number): value is string =>\n  typeof value === \"string\" &&\n  value.trim().length > 0 &&\n  value.length <= maximum;\nconst integer = (value: unknown, minimum = 0): value is number =>\n  typeof value === \"number\" && Number.isSafeInteger(value) && value >= minimum;\nconst date = (value: unknown): value is string =>\n  typeof value === \"string\" && !Number.isNaN(Date.parse(value));\n\n/**\n * Accepts only the configured Intelligence web-app origin.\n *\n * Learning links are server-authored actions. Treating every HTTPS origin as\n * trusted would let a misconfigured or compromised upstream turn Inspector\n * copy into a navigation primitive for an arbitrary site.\n */\nexport function parseInspectorLearningUrl(\n  value: unknown,\n  trustedOrigin: unknown,\n): string | undefined {\n  if (\n    typeof value !== \"string\" ||\n    value.length > 4_000 ||\n    typeof trustedOrigin !== \"string\" ||\n    trustedOrigin.length > 2_000\n  ) {\n    return undefined;\n  }\n  try {\n    const parsed = new URL(value);\n    const configured = new URL(trustedOrigin);\n    const loopback = [\"localhost\", \"127.0.0.1\", \"[::1]\"].includes(\n      configured.hostname,\n    );\n    if (\n      parsed.username ||\n      parsed.password ||\n      configured.username ||\n      configured.password ||\n      configured.pathname !== \"/\" ||\n      configured.search ||\n      configured.hash ||\n      (configured.protocol !== \"https:\" &&\n        !(configured.protocol === \"http:\" && loopback)) ||\n      parsed.origin !== configured.origin\n    ) {\n      return undefined;\n    }\n    return parsed.toString();\n  } catch {\n    return undefined;\n  }\n}\n\nfunction parseEvidence(value: unknown): InspectorLearningEvidence | undefined {\n  if (record(value) && value.status === \"unavailable\") {\n    return Object.keys(value).length === 1\n      ? { status: \"unavailable\" }\n      : undefined;\n  }\n  if (\n    !record(value) ||\n    value.status !== \"available\" ||\n    !string(value.threadId, 128) ||\n    !date(value.updatedAt)\n  ) {\n    return undefined;\n  }\n  if (\n    value.threadName !== null &&\n    !(typeof value.threadName === \"string\" && value.threadName.length <= 4_000)\n  ) {\n    return undefined;\n  }\n  if (\n    !Array.isArray(value.messageIds) ||\n    value.messageIds.length > 200 ||\n    !value.messageIds.every((id) => string(id, 128))\n  ) {\n    return undefined;\n  }\n  return {\n    status: \"available\",\n    threadId: value.threadId,\n    threadName: value.threadName,\n    messageIds: [...value.messageIds],\n    updatedAt: value.updatedAt,\n  };\n}\n\nfunction parseInsight(value: unknown): InspectorLearningInsight | undefined {\n  if (\n    !record(value) ||\n    !string(value.id, 128) ||\n    !string(value.statement, 4_000) ||\n    !string(value.impact, 4_000) ||\n    !integer(value.totalThreadCount) ||\n    typeof value.evidenceTruncated !== \"boolean\" ||\n    !Array.isArray(value.evidence) ||\n    value.evidence.length > 100\n  ) {\n    return undefined;\n  }\n  const evidence = value.evidence.map(parseEvidence);\n  if (evidence.some((item) => item === undefined)) return undefined;\n  return {\n    id: value.id,\n    statement: value.statement,\n    impact: value.impact,\n    totalThreadCount: value.totalThreadCount,\n    evidenceTruncated: value.evidenceTruncated,\n    evidence: evidence as InspectorLearningEvidence[],\n  };\n}\n\nfunction parseSkill(value: unknown): InspectorLearningSkill | undefined {\n  if (\n    !record(value) ||\n    !string(value.id, 128) ||\n    !string(value.name, 128) ||\n    !string(value.description, 4_000) ||\n    !integer(value.revision, 1) ||\n    typeof value.skillMd !== \"string\" ||\n    value.skillMd.length > 131_072\n  ) {\n    return undefined;\n  }\n  const sourceInsight =\n    value.sourceInsight === null ? null : parseInsight(value.sourceInsight);\n  if (sourceInsight === undefined) return undefined;\n  return {\n    id: value.id,\n    name: value.name,\n    description: value.description,\n    revision: value.revision,\n    skillMd: value.skillMd,\n    sourceInsight,\n  };\n}\n\nfunction parsePage<T>(\n  value: unknown,\n  pageSize: 3 | 4,\n  parseItem: (item: unknown) => T | undefined,\n): InspectorLearningPage<T> | undefined {\n  if (\n    !record(value) ||\n    !integer(value.page, 1) ||\n    value.pageSize !== pageSize ||\n    !integer(value.total) ||\n    !integer(value.totalPages) ||\n    !Array.isArray(value.items) ||\n    value.items.length > pageSize\n  ) {\n    return undefined;\n  }\n  const items = value.items.map(parseItem);\n  if (items.some((item) => item === undefined)) return undefined;\n  if (value.total === 0) {\n    if (value.page !== 1 || value.totalPages !== 0 || items.length !== 0) {\n      return undefined;\n    }\n  } else {\n    const totalPages = Math.ceil(value.total / pageSize);\n    const expectedItems = Math.min(\n      pageSize,\n      value.total - (value.page - 1) * pageSize,\n    );\n    if (\n      value.totalPages !== totalPages ||\n      value.page > totalPages ||\n      items.length !== expectedItems\n    ) {\n      return undefined;\n    }\n  }\n  return {\n    page: value.page,\n    pageSize,\n    total: value.total,\n    totalPages: value.totalPages,\n    items: items as T[],\n  };\n}\n\nfunction parseConfiguration(\n  value: unknown,\n): InspectorLearningSnapshotV1[\"configuration\"] | undefined {\n  if (!record(value)) return undefined;\n  if (\n    value.state === \"not_configured\" ||\n    value.state === \"selection_required\"\n  ) {\n    return { state: value.state };\n  }\n  if (\n    value.state === \"invalid\" &&\n    (value.reason === \"container\" || value.reason === \"instrumentation\")\n  ) {\n    return { state: value.state, reason: value.reason };\n  }\n  if (\n    value.state === \"configured\" &&\n    record(value.container) &&\n    string(value.container.id, 128) &&\n    string(value.container.name, 128)\n  ) {\n    return {\n      state: \"configured\",\n      container: { id: value.container.id, name: value.container.name },\n    };\n  }\n  return undefined;\n}\n\nconst runStatuses = new Set([\n  \"queued\",\n  \"freezing\",\n  \"batching\",\n  \"reducing\",\n  \"finalizing\",\n  \"succeeded\",\n  \"failed\",\n]);\n\n/** Validates and copies an untrusted Learning snapshot at each process boundary. */\nexport function parseInspectorLearningSnapshotV1(\n  value: unknown,\n): InspectorLearningSnapshotV1 | undefined {\n  if (\n    !record(value) ||\n    value.schemaVersion !== 1 ||\n    !string(value.projectKey, 128) ||\n    !string(value.snapshotVersion, 128) ||\n    !integer(value.pendingThreadCount) ||\n    !integer(value.pendingCandidateCount) ||\n    !record(value.run) ||\n    typeof value.run.hasActiveRun !== \"boolean\" ||\n    typeof value.run.hasEverSucceeded !== \"boolean\"\n  ) {\n    return undefined;\n  }\n  const configuration = parseConfiguration(value.configuration);\n  const skillsPage = parsePage(value.skillsPage, 3, parseSkill);\n  const insightsPage = parsePage(value.insightsPage, 4, parseInsight);\n  if (!configuration || !skillsPage || !insightsPage) return undefined;\n  let latest: InspectorLearningSnapshotV1[\"run\"][\"latest\"] = null;\n  if (value.run.latest !== null) {\n    const latestRun = value.run.latest;\n    if (!record(latestRun)) {\n      return undefined;\n    }\n    const { status, completedAt } = latestRun;\n    if (\n      typeof status !== \"string\" ||\n      !runStatuses.has(status) ||\n      (completedAt !== null && !date(completedAt))\n    )\n      return undefined;\n    latest = {\n      status: status as NonNullable<typeof latest>[\"status\"],\n      completedAt: completedAt as NonNullable<typeof latest>[\"completedAt\"],\n    };\n  }\n  if (!record(value.links)) return undefined;\n  const originUrl = parseInspectorLearningUrl(\n    value.webAppOrigin,\n    value.webAppOrigin,\n  );\n  if (!originUrl || new URL(originUrl).pathname !== \"/\") return undefined;\n  const webAppOrigin = new URL(originUrl).origin;\n  const learning = parseInspectorLearningUrl(\n    value.links.learning,\n    webAppOrigin,\n  );\n  const candidates =\n    value.links.candidates === null\n      ? null\n      : parseInspectorLearningUrl(value.links.candidates, webAppOrigin);\n  const runs =\n    value.links.runs === null\n      ? null\n      : parseInspectorLearningUrl(value.links.runs, webAppOrigin);\n  if (\n    !learning ||\n    candidates === undefined ||\n    runs === undefined ||\n    (value.pendingThreadCount > 0 && runs === null) ||\n    (value.pendingCandidateCount > 0 && candidates === null)\n  )\n    return undefined;\n  return {\n    schemaVersion: 1,\n    projectKey: value.projectKey,\n    snapshotVersion: value.snapshotVersion,\n    webAppOrigin,\n    configuration,\n    pendingThreadCount: value.pendingThreadCount,\n    run: {\n      hasActiveRun: value.run.hasActiveRun,\n      hasEverSucceeded: value.run.hasEverSucceeded,\n      latest,\n    },\n    pendingCandidateCount: value.pendingCandidateCount,\n    skillsPage,\n    insightsPage,\n    links: { learning, candidates, runs },\n  };\n}\n\n/** Normalizes the browser-owned request without accepting container scope. */\nexport function parseInspectorLearningRequestV1(\n  value: unknown,\n): InspectorLearningRequestV1 | undefined {\n  if (!record(value)) return undefined;\n  if (\n    Object.keys(value).some(\n      (key) => ![\"agentId\", \"skillsPage\", \"insightsPage\"].includes(key),\n    )\n  ) {\n    return undefined;\n  }\n  const agentId = value.agentId;\n  const skillsPage = value.skillsPage;\n  const insightsPage = value.insightsPage;\n  if (agentId !== undefined && !string(agentId, 128)) return undefined;\n  if (skillsPage !== undefined && !integer(skillsPage, 1)) return undefined;\n  if (insightsPage !== undefined && !integer(insightsPage, 1)) return undefined;\n  return {\n    ...(agentId === undefined ? {} : { agentId }),\n    ...(skillsPage === undefined ? {} : { skillsPage }),\n    ...(insightsPage === undefined ? {} : { insightsPage }),\n  };\n}\n"],"mappings":"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"}

package/dist/utils/types.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"types.cjs","names":[],"sources":["../../src/utils/types.ts"],"sourcesContent":["import type { AgentCapabilities } from \"@ag-ui/core\";\n\nexport type MaybePromise<T> = T | PromiseLike<T>;\n\n/**\n * More specific utility for records with at least one key\n */\nexport type NonEmptyRecord<T> =\n  T extends Record<string, unknown>\n    ? keyof T extends never\n      ? never\n      : T\n    : never;\n\n/**\n * Type representing an agent's basic information\n */\nexport interface AgentDescription {\n  name: string;\n  className: string;\n  description: string;\n  capabilities?: AgentCapabilities;\n}\n\nexport type RuntimeMode = \"sse\" | \"intelligence\";\n\nexport const RUNTIME_MODE_SSE = \"sse\" as const;\nexport const RUNTIME_MODE_INTELLIGENCE = \"intelligence\" as const;\n\nexport interface IntelligenceRuntimeInfo {\n  wsUrl: string;\n}\n\nexport interface ThreadEndpointRuntimeInfo {\n  list: boolean;\n  inspect: boolean;\n  mutations: boolean;\n  realtimeMetadata: boolean;\n}\n\nexport type RuntimeLicenseStatus =\n  | \"valid\"\n  | \"none\"\n  | \"expired\"\n  | \"expiring\"\n  | \"invalid\"\n  | \"unknown\";\n\n/** Runtime entitlement authority resolved by a managed or self-hosted backend. */\ninterface RuntimeEntitlement {\n  /** Whether the resolved entitlement currently grants product access. */\n  active: boolean;\n  /** Deployment authority that produced this entitlement. */\n  source: \"managedOrgSubscription\" | \"selfHostedDeploymentLicense\";\n  /** Boolean feature grants keyed by stable feature id. */\n  features: Record<string, boolean>;\n  /** Numeric limits keyed by stable feature id. */\n  limits: Record<string, number>;\n  /** Optional catalog plan code supplied by the entitlement authority. */\n  planCode?: string;\n  /** Optional lower-level source metadata supplied by the authority. */\n  entitlementSource?: string;\n}\n\n/** Public diagnostic returned when Runtime entitlement resolution is not ready. */\ninterface RuntimeEntitlementError {\n  /** Stable backend or SDK error code. */\n  code: string;\n  /** Safe human-readable diagnostic. */\n  message: string;\n  /** Whether a later resolution attempt may succeed without reconfiguration. */\n  retryable: boolean;\n  /** Optional originating request correlation id. */\n  requestId?: string;\n  /** Optional originating trace correlation id. */\n  traceId?: string;\n}\n\n/** Successfully resolved Runtime entitlement response. */\ninterface RuntimeEntitlementReadyResponse {\n  status: \"ready\";\n  entitlement: RuntimeEntitlement;\n  error?: never;\n}\n\n/** Structured non-ready Runtime entitlement response. */\ninterface RuntimeEntitlementErrorResponse {\n  status: \"degraded\" | \"misconfigured\" | \"unavailable\";\n  entitlement?: never;\n  error: RuntimeEntitlementError;\n}\n\n/** Final structured Runtime entitlement response exposed through `/info`. */\nexport type RuntimeEntitlementResponse =\n  | RuntimeEntitlementReadyResponse\n  | RuntimeEntitlementErrorResponse;\n\nexport interface A2UIRuntimeInfo {\n  enabled: boolean;\n  /**\n   * Agent ids the runtime applies A2UI to. When omitted, A2UI applies to\n   * every agent served by the runtime.\n   */\n  agents?: string[];\n}\n\nexport interface RuntimeInfo {\n  version: string;\n  agents: Record<string, AgentDescription>;\n  audioFileTranscriptionEnabled: boolean;\n  mode: RuntimeMode;\n  intelligence?: IntelligenceRuntimeInfo;\n  threadEndpoints?: ThreadEndpointRuntimeInfo;\n  /** Whether this runtime exposes trusted inspector metadata. */\n  inspectorMetadata?: boolean;\n  /**\n   * When true, the runtime exposes POST /agent/:agentId/suggest for stateless\n   * suggestion generation. Absent on older runtimes; clients fall back to a\n   * client-side agent run.\n   */\n  suggestions?: boolean;\n  /**\n   * @deprecated Use `a2ui` instead, which preserves per-agent scoping.\n   * Kept for backward compatibility with older clients.\n   */\n  a2uiEnabled?: boolean;\n  a2ui?: A2UIRuntimeInfo;\n  openGenerativeUIEnabled?: boolean;\n  /** Structured Runtime-level entitlement authority, when advertised. */\n  runtimeEntitlements?: RuntimeEntitlementResponse;\n  /** Legacy compatibility diagnostic retained for older Core/Inspector clients. */\n  licenseStatus?: RuntimeLicenseStatus;\n  telemetryDisabled?: boolean;\n}\n"],"mappings":";;AA0BA,MAAa,mBAAmB;AAChC,MAAa,4BAA4B"}
+{"version":3,"file":"types.cjs","names":[],"sources":["../../src/utils/types.ts"],"sourcesContent":["import type { AgentCapabilities } from \"@ag-ui/core\";\n\nexport type MaybePromise<T> = T | PromiseLike<T>;\n\n/**\n * More specific utility for records with at least one key\n */\nexport type NonEmptyRecord<T> =\n  T extends Record<string, unknown>\n    ? keyof T extends never\n      ? never\n      : T\n    : never;\n\n/**\n * Type representing an agent's basic information\n */\nexport interface AgentDescription {\n  name: string;\n  className: string;\n  description: string;\n  capabilities?: AgentCapabilities;\n}\n\nexport type RuntimeMode = \"sse\" | \"intelligence\";\n\nexport const RUNTIME_MODE_SSE = \"sse\" as const;\nexport const RUNTIME_MODE_INTELLIGENCE = \"intelligence\" as const;\n\nexport interface IntelligenceRuntimeInfo {\n  wsUrl: string;\n}\n\nexport interface ThreadEndpointRuntimeInfo {\n  list: boolean;\n  inspect: boolean;\n  mutations: boolean;\n  realtimeMetadata: boolean;\n}\n\nexport type RuntimeLicenseStatus =\n  | \"valid\"\n  | \"none\"\n  | \"expired\"\n  | \"expiring\"\n  | \"invalid\"\n  | \"unknown\";\n\n/** Runtime entitlement authority resolved by a managed or self-hosted backend. */\ninterface RuntimeEntitlement {\n  /** Whether the resolved entitlement currently grants product access. */\n  active: boolean;\n  /** Deployment authority that produced this entitlement. */\n  source:\n    | \"managedOrgSubscription\"\n    | \"selfHostedDeploymentLicense\"\n    | \"awsMarketplaceDeploymentLicense\";\n  /** Boolean feature grants keyed by stable feature id. */\n  features: Record<string, boolean>;\n  /** Numeric limits keyed by stable feature id. */\n  limits: Record<string, number>;\n  /** Optional catalog plan code supplied by the entitlement authority. */\n  planCode?: string;\n  /** Optional lower-level source metadata supplied by the authority. */\n  entitlementSource?: string;\n}\n\n/** Public diagnostic returned when Runtime entitlement resolution is not ready. */\ninterface RuntimeEntitlementError {\n  /** Stable backend or SDK error code. */\n  code: string;\n  /** Safe human-readable diagnostic. */\n  message: string;\n  /** Whether a later resolution attempt may succeed without reconfiguration. */\n  retryable: boolean;\n  /** Optional originating request correlation id. */\n  requestId?: string;\n  /** Optional originating trace correlation id. */\n  traceId?: string;\n}\n\n/** Successfully resolved Runtime entitlement response. */\ninterface RuntimeEntitlementReadyResponse {\n  status: \"ready\";\n  entitlement: RuntimeEntitlement;\n  error?: never;\n}\n\n/** Structured non-ready Runtime entitlement response. */\ninterface RuntimeEntitlementErrorResponse {\n  status: \"degraded\" | \"misconfigured\" | \"unavailable\";\n  entitlement?: never;\n  error: RuntimeEntitlementError;\n}\n\n/** Final structured Runtime entitlement response exposed through `/info`. */\nexport type RuntimeEntitlementResponse =\n  | RuntimeEntitlementReadyResponse\n  | RuntimeEntitlementErrorResponse;\n\nexport interface A2UIRuntimeInfo {\n  enabled: boolean;\n  /**\n   * Agent ids the runtime applies A2UI to. When omitted, A2UI applies to\n   * every agent served by the runtime.\n   */\n  agents?: string[];\n}\n\n/** Intelligence resource support available through a single runtime route. */\nexport interface SingleRouteRuntimeInfo {\n  /** Whether the runtime accepts resource requests through the single route. */\n  resourceOperations: boolean;\n  /** Thread features available through the single-route resource bridge. */\n  threadEndpoints: ThreadEndpointRuntimeInfo;\n}\n\nexport interface RuntimeInfo {\n  version: string;\n  agents: Record<string, AgentDescription>;\n  audioFileTranscriptionEnabled: boolean;\n  mode: RuntimeMode;\n  intelligence?: IntelligenceRuntimeInfo;\n  threadEndpoints?: ThreadEndpointRuntimeInfo;\n  /** Optional capabilities exposed by runtimes that use one HTTP route. */\n  singleRoute?: SingleRouteRuntimeInfo;\n  /** Whether this runtime exposes trusted inspector metadata. */\n  inspectorMetadata?: boolean;\n  /** Whether this runtime exposes the debug-authorized Learning snapshot. */\n  inspectorLearning?: boolean;\n  /**\n   * When true, the runtime exposes POST /agent/:agentId/suggest for stateless\n   * suggestion generation. Absent on older runtimes; clients fall back to a\n   * client-side agent run.\n   */\n  suggestions?: boolean;\n  /**\n   * @deprecated Use `a2ui` instead, which preserves per-agent scoping.\n   * Kept for backward compatibility with older clients.\n   */\n  a2uiEnabled?: boolean;\n  a2ui?: A2UIRuntimeInfo;\n  openGenerativeUIEnabled?: boolean;\n  /** Structured Runtime-level entitlement authority, when advertised. */\n  runtimeEntitlements?: RuntimeEntitlementResponse;\n  /** Legacy compatibility diagnostic retained for older Core/Inspector clients. */\n  licenseStatus?: RuntimeLicenseStatus;\n  telemetryDisabled?: boolean;\n}\n"],"mappings":";;AA0BA,MAAa,mBAAmB;AAChC,MAAa,4BAA4B"}

package/dist/utils/types.d.cts

@@ -33,7 +33,7 @@ interface RuntimeEntitlement {
   /** Whether the resolved entitlement currently grants product access. */
   active: boolean;
   /** Deployment authority that produced this entitlement. */
-  source: "managedOrgSubscription" | "selfHostedDeploymentLicense";
+  source: "managedOrgSubscription" | "selfHostedDeploymentLicense" | "awsMarketplaceDeploymentLicense";
   /** Boolean feature grants keyed by stable feature id. */
   features: Record<string, boolean>;
   /** Numeric limits keyed by stable feature id. */
@@ -78,6 +78,13 @@ interface A2UIRuntimeInfo {
    */
   agents?: string[];
 }
+/** Intelligence resource support available through a single runtime route. */
+interface SingleRouteRuntimeInfo {
+  /** Whether the runtime accepts resource requests through the single route. */
+  resourceOperations: boolean;
+  /** Thread features available through the single-route resource bridge. */
+  threadEndpoints: ThreadEndpointRuntimeInfo;
+}
 interface RuntimeInfo {
   version: string;
   agents: Record<string, AgentDescription>;
@@ -85,8 +92,12 @@ interface RuntimeInfo {
   mode: RuntimeMode;
   intelligence?: IntelligenceRuntimeInfo;
   threadEndpoints?: ThreadEndpointRuntimeInfo;
+  /** Optional capabilities exposed by runtimes that use one HTTP route. */
+  singleRoute?: SingleRouteRuntimeInfo;
   /** Whether this runtime exposes trusted inspector metadata. */
   inspectorMetadata?: boolean;
+  /** Whether this runtime exposes the debug-authorized Learning snapshot. */
+  inspectorLearning?: boolean;
   /**
    * When true, the runtime exposes POST /agent/:agentId/suggest for stateless
    * suggestion generation. Absent on older runtimes; clients fall back to a
@@ -107,5 +118,5 @@ interface RuntimeInfo {
   telemetryDisabled?: boolean;
 }
 //#endregion
-export { A2UIRuntimeInfo, AgentDescription, IntelligenceRuntimeInfo, MaybePromise, NonEmptyRecord, RUNTIME_MODE_INTELLIGENCE, RUNTIME_MODE_SSE, RuntimeEntitlementResponse, RuntimeInfo, RuntimeLicenseStatus, RuntimeMode, ThreadEndpointRuntimeInfo };
+export { A2UIRuntimeInfo, AgentDescription, IntelligenceRuntimeInfo, MaybePromise, NonEmptyRecord, RUNTIME_MODE_INTELLIGENCE, RUNTIME_MODE_SSE, RuntimeEntitlementResponse, RuntimeInfo, RuntimeLicenseStatus, RuntimeMode, SingleRouteRuntimeInfo, ThreadEndpointRuntimeInfo };
 //# sourceMappingURL=types.d.cts.map

package/dist/utils/types.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.cts","names":[],"sources":["../../src/utils/types.ts"],"mappings":";;;KAEY,YAAA,MAAkB,CAAA,GAAI,WAAA,CAAY,CAAA;;AAA9C;;KAKY,cAAA,MACV,CAAA,SAAU,MAAA,0BACA,CAAA,yBAEJ,CAAA;;;;UAMS,gBAAA;EACf,IAAA;EACA,SAAA;EACA,WAAA;EACA,YAAA,GAAe,iBAAA;AAAA;AAAA,KAGL,WAAA;AAAA,cAEC,gBAAA;AAAA,cACA,yBAAA;AAAA,UAEI,uBAAA;EACf,KAAA;AAAA;AAAA,UAGe,yBAAA;EACf,IAAA;EACA,OAAA;EACA,SAAA;EACA,gBAAA;AAAA;AAAA,KAGU,oBAAA;;UASF,kBAAA;EAtCF;EAwCN,MAAA;EAxCO;EA0CP,MAAA;EApC+B;EAsC/B,QAAA,EAAU,MAAA;EAlCsB;EAoChC,MAAA,EAAQ,MAAA;EAtCR;EAwCA,QAAA;EAtCA;EAwCA,iBAAA;AAAA;;UAIQ,uBAAA;EAzCa;EA2CrB,IAAA;EA3CqB;EA6CrB,OAAA;EA3CW;EA6CX,SAAA;;EAEA,SAAA;EA/C4C;EAiD5C,OAAA;AAAA;;UAIQ,+BAAA;EACR,MAAA;EACA,WAAA,EAAa,kBAAA;EACb,KAAA;AAAA;;UAIQ,+BAAA;EACR,MAAA;EACA,WAAA;EACA,KAAA,EAAO,uBAAA;AAAA;;KAIG,0BAAA,GACR,+BAAA,GACA,+BAAA;AAAA,UAEa,eAAA;EACf,OAAA;EA7DgB;;AAGlB;;EA+DE,MAAA;AAAA;AAAA,UAGe,WAAA;EACf,OAAA;EACA,MAAA,EAAQ,MAAA,SAAe,gBAAA;EACvB,6BAAA;EACA,IAAA,EAAM,WAAA;EACN,YAAA,GAAe,uBAAA;EACf,eAAA,GAAkB,yBAAA;EAzDlB;EA2DA,iBAAA;EAzDA;;;;;EA+DA,WAAA;EAvDQ;;;;EA4DR,WAAA;EACA,IAAA,GAAO,eAAA;EACP,uBAAA;EAtDA;EAwDA,mBAAA,GAAsB,0BAAA;EAtDf;EAwDP,aAAA,GAAgB,oBAAA;EAChB,iBAAA;AAAA"}
+{"version":3,"file":"types.d.cts","names":[],"sources":["../../src/utils/types.ts"],"mappings":";;;KAEY,YAAA,MAAkB,CAAA,GAAI,WAAA,CAAY,CAAA;;AAA9C;;KAKY,cAAA,MACV,CAAA,SAAU,MAAA,0BACA,CAAA,yBAEJ,CAAA;;;;UAMS,gBAAA;EACf,IAAA;EACA,SAAA;EACA,WAAA;EACA,YAAA,GAAe,iBAAA;AAAA;AAAA,KAGL,WAAA;AAAA,cAEC,gBAAA;AAAA,cACA,yBAAA;AAAA,UAEI,uBAAA;EACf,KAAA;AAAA;AAAA,UAGe,yBAAA;EACf,IAAA;EACA,OAAA;EACA,SAAA;EACA,gBAAA;AAAA;AAAA,KAGU,oBAAA;;UASF,kBAAA;EAtCF;EAwCN,MAAA;EAxCO;EA0CP,MAAA;EApC+B;EAyC/B,QAAA,EAAU,MAAA;EArCsB;EAuChC,MAAA,EAAQ,MAAA;EAzCR;EA2CA,QAAA;EAzCA;EA2CA,iBAAA;AAAA;;UAIQ,uBAAA;EA5Ca;EA8CrB,IAAA;EA9CqB;EAgDrB,OAAA;EA9CW;EAgDX,SAAA;;EAEA,SAAA;EAlD4C;EAoD5C,OAAA;AAAA;;UAIQ,+BAAA;EACR,MAAA;EACA,WAAA,EAAa,kBAAA;EACb,KAAA;AAAA;;UAIQ,+BAAA;EACR,MAAA;EACA,WAAA;EACA,KAAA,EAAO,uBAAA;AAAA;;KAIG,0BAAA,GACR,+BAAA,GACA,+BAAA;AAAA,UAEa,eAAA;EACf,OAAA;EAhEgB;;AAGlB;;EAkEE,MAAA;AAAA;;UAIe,sBAAA;EA7DW;EA+D1B,kBAAA;EApDc;EAsDd,eAAA,EAAiB,yBAAA;AAAA;AAAA,UAGF,WAAA;EACf,OAAA;EACA,MAAA,EAAQ,MAAA,SAAe,gBAAA;EACvB,6BAAA;EACA,IAAA,EAAM,WAAA;EACN,YAAA,GAAe,uBAAA;EACf,eAAA,GAAkB,yBAAA;EA3DD;EA6DjB,WAAA,GAAc,sBAAA;EAzDiB;EA2D/B,iBAAA;EA3D+B;EA6D/B,iBAAA;EAzDA;;;;;EA+DA,WAAA;EArDQ;;;;EA0DR,WAAA;EACA,IAAA,GAAO,eAAA;EACP,uBAAA;EAzDA;EA2DA,mBAAA,GAAsB,0BAAA;EA3DjB;EA6DL,aAAA,GAAgB,oBAAA;EAChB,iBAAA;AAAA"}

package/dist/utils/types.d.mts

@@ -33,7 +33,7 @@ interface RuntimeEntitlement {
   /** Whether the resolved entitlement currently grants product access. */
   active: boolean;
   /** Deployment authority that produced this entitlement. */
-  source: "managedOrgSubscription" | "selfHostedDeploymentLicense";
+  source: "managedOrgSubscription" | "selfHostedDeploymentLicense" | "awsMarketplaceDeploymentLicense";
   /** Boolean feature grants keyed by stable feature id. */
   features: Record<string, boolean>;
   /** Numeric limits keyed by stable feature id. */
@@ -78,6 +78,13 @@ interface A2UIRuntimeInfo {
    */
   agents?: string[];
 }
+/** Intelligence resource support available through a single runtime route. */
+interface SingleRouteRuntimeInfo {
+  /** Whether the runtime accepts resource requests through the single route. */
+  resourceOperations: boolean;
+  /** Thread features available through the single-route resource bridge. */
+  threadEndpoints: ThreadEndpointRuntimeInfo;
+}
 interface RuntimeInfo {
   version: string;
   agents: Record<string, AgentDescription>;
@@ -85,8 +92,12 @@ interface RuntimeInfo {
   mode: RuntimeMode;
   intelligence?: IntelligenceRuntimeInfo;
   threadEndpoints?: ThreadEndpointRuntimeInfo;
+  /** Optional capabilities exposed by runtimes that use one HTTP route. */
+  singleRoute?: SingleRouteRuntimeInfo;
   /** Whether this runtime exposes trusted inspector metadata. */
   inspectorMetadata?: boolean;
+  /** Whether this runtime exposes the debug-authorized Learning snapshot. */
+  inspectorLearning?: boolean;
   /**
    * When true, the runtime exposes POST /agent/:agentId/suggest for stateless
    * suggestion generation. Absent on older runtimes; clients fall back to a
@@ -107,5 +118,5 @@ interface RuntimeInfo {
   telemetryDisabled?: boolean;
 }
 //#endregion
-export { A2UIRuntimeInfo, AgentDescription, IntelligenceRuntimeInfo, MaybePromise, NonEmptyRecord, RUNTIME_MODE_INTELLIGENCE, RUNTIME_MODE_SSE, RuntimeEntitlementResponse, RuntimeInfo, RuntimeLicenseStatus, RuntimeMode, ThreadEndpointRuntimeInfo };
+export { A2UIRuntimeInfo, AgentDescription, IntelligenceRuntimeInfo, MaybePromise, NonEmptyRecord, RUNTIME_MODE_INTELLIGENCE, RUNTIME_MODE_SSE, RuntimeEntitlementResponse, RuntimeInfo, RuntimeLicenseStatus, RuntimeMode, SingleRouteRuntimeInfo, ThreadEndpointRuntimeInfo };
 //# sourceMappingURL=types.d.mts.map

package/dist/utils/types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../../src/utils/types.ts"],"mappings":";;;KAEY,YAAA,MAAkB,CAAA,GAAI,WAAA,CAAY,CAAA;;AAA9C;;KAKY,cAAA,MACV,CAAA,SAAU,MAAA,0BACA,CAAA,yBAEJ,CAAA;;;;UAMS,gBAAA;EACf,IAAA;EACA,SAAA;EACA,WAAA;EACA,YAAA,GAAe,iBAAA;AAAA;AAAA,KAGL,WAAA;AAAA,cAEC,gBAAA;AAAA,cACA,yBAAA;AAAA,UAEI,uBAAA;EACf,KAAA;AAAA;AAAA,UAGe,yBAAA;EACf,IAAA;EACA,OAAA;EACA,SAAA;EACA,gBAAA;AAAA;AAAA,KAGU,oBAAA;;UASF,kBAAA;EAtCF;EAwCN,MAAA;EAxCO;EA0CP,MAAA;EApC+B;EAsC/B,QAAA,EAAU,MAAA;EAlCsB;EAoChC,MAAA,EAAQ,MAAA;EAtCR;EAwCA,QAAA;EAtCA;EAwCA,iBAAA;AAAA;;UAIQ,uBAAA;EAzCa;EA2CrB,IAAA;EA3CqB;EA6CrB,OAAA;EA3CW;EA6CX,SAAA;;EAEA,SAAA;EA/C4C;EAiD5C,OAAA;AAAA;;UAIQ,+BAAA;EACR,MAAA;EACA,WAAA,EAAa,kBAAA;EACb,KAAA;AAAA;;UAIQ,+BAAA;EACR,MAAA;EACA,WAAA;EACA,KAAA,EAAO,uBAAA;AAAA;;KAIG,0BAAA,GACR,+BAAA,GACA,+BAAA;AAAA,UAEa,eAAA;EACf,OAAA;EA7DgB;;AAGlB;;EA+DE,MAAA;AAAA;AAAA,UAGe,WAAA;EACf,OAAA;EACA,MAAA,EAAQ,MAAA,SAAe,gBAAA;EACvB,6BAAA;EACA,IAAA,EAAM,WAAA;EACN,YAAA,GAAe,uBAAA;EACf,eAAA,GAAkB,yBAAA;EAzDlB;EA2DA,iBAAA;EAzDA;;;;;EA+DA,WAAA;EAvDQ;;;;EA4DR,WAAA;EACA,IAAA,GAAO,eAAA;EACP,uBAAA;EAtDA;EAwDA,mBAAA,GAAsB,0BAAA;EAtDf;EAwDP,aAAA,GAAgB,oBAAA;EAChB,iBAAA;AAAA"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../src/utils/types.ts"],"mappings":";;;KAEY,YAAA,MAAkB,CAAA,GAAI,WAAA,CAAY,CAAA;;AAA9C;;KAKY,cAAA,MACV,CAAA,SAAU,MAAA,0BACA,CAAA,yBAEJ,CAAA;;;;UAMS,gBAAA;EACf,IAAA;EACA,SAAA;EACA,WAAA;EACA,YAAA,GAAe,iBAAA;AAAA;AAAA,KAGL,WAAA;AAAA,cAEC,gBAAA;AAAA,cACA,yBAAA;AAAA,UAEI,uBAAA;EACf,KAAA;AAAA;AAAA,UAGe,yBAAA;EACf,IAAA;EACA,OAAA;EACA,SAAA;EACA,gBAAA;AAAA;AAAA,KAGU,oBAAA;;UASF,kBAAA;EAtCF;EAwCN,MAAA;EAxCO;EA0CP,MAAA;EApC+B;EAyC/B,QAAA,EAAU,MAAA;EArCsB;EAuChC,MAAA,EAAQ,MAAA;EAzCR;EA2CA,QAAA;EAzCA;EA2CA,iBAAA;AAAA;;UAIQ,uBAAA;EA5Ca;EA8CrB,IAAA;EA9CqB;EAgDrB,OAAA;EA9CW;EAgDX,SAAA;;EAEA,SAAA;EAlD4C;EAoD5C,OAAA;AAAA;;UAIQ,+BAAA;EACR,MAAA;EACA,WAAA,EAAa,kBAAA;EACb,KAAA;AAAA;;UAIQ,+BAAA;EACR,MAAA;EACA,WAAA;EACA,KAAA,EAAO,uBAAA;AAAA;;KAIG,0BAAA,GACR,+BAAA,GACA,+BAAA;AAAA,UAEa,eAAA;EACf,OAAA;EAhEgB;;AAGlB;;EAkEE,MAAA;AAAA;;UAIe,sBAAA;EA7DW;EA+D1B,kBAAA;EApDc;EAsDd,eAAA,EAAiB,yBAAA;AAAA;AAAA,UAGF,WAAA;EACf,OAAA;EACA,MAAA,EAAQ,MAAA,SAAe,gBAAA;EACvB,6BAAA;EACA,IAAA,EAAM,WAAA;EACN,YAAA,GAAe,uBAAA;EACf,eAAA,GAAkB,yBAAA;EA3DD;EA6DjB,WAAA,GAAc,sBAAA;EAzDiB;EA2D/B,iBAAA;EA3D+B;EA6D/B,iBAAA;EAzDA;;;;;EA+DA,WAAA;EArDQ;;;;EA0DR,WAAA;EACA,IAAA,GAAO,eAAA;EACP,uBAAA;EAzDA;EA2DA,mBAAA,GAAsB,0BAAA;EA3DjB;EA6DL,aAAA,GAAgB,oBAAA;EAChB,iBAAA;AAAA"}

package/dist/utils/types.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"types.mjs","names":[],"sources":["../../src/utils/types.ts"],"sourcesContent":["import type { AgentCapabilities } from \"@ag-ui/core\";\n\nexport type MaybePromise<T> = T | PromiseLike<T>;\n\n/**\n * More specific utility for records with at least one key\n */\nexport type NonEmptyRecord<T> =\n  T extends Record<string, unknown>\n    ? keyof T extends never\n      ? never\n      : T\n    : never;\n\n/**\n * Type representing an agent's basic information\n */\nexport interface AgentDescription {\n  name: string;\n  className: string;\n  description: string;\n  capabilities?: AgentCapabilities;\n}\n\nexport type RuntimeMode = \"sse\" | \"intelligence\";\n\nexport const RUNTIME_MODE_SSE = \"sse\" as const;\nexport const RUNTIME_MODE_INTELLIGENCE = \"intelligence\" as const;\n\nexport interface IntelligenceRuntimeInfo {\n  wsUrl: string;\n}\n\nexport interface ThreadEndpointRuntimeInfo {\n  list: boolean;\n  inspect: boolean;\n  mutations: boolean;\n  realtimeMetadata: boolean;\n}\n\nexport type RuntimeLicenseStatus =\n  | \"valid\"\n  | \"none\"\n  | \"expired\"\n  | \"expiring\"\n  | \"invalid\"\n  | \"unknown\";\n\n/** Runtime entitlement authority resolved by a managed or self-hosted backend. */\ninterface RuntimeEntitlement {\n  /** Whether the resolved entitlement currently grants product access. */\n  active: boolean;\n  /** Deployment authority that produced this entitlement. */\n  source: \"managedOrgSubscription\" | \"selfHostedDeploymentLicense\";\n  /** Boolean feature grants keyed by stable feature id. */\n  features: Record<string, boolean>;\n  /** Numeric limits keyed by stable feature id. */\n  limits: Record<string, number>;\n  /** Optional catalog plan code supplied by the entitlement authority. */\n  planCode?: string;\n  /** Optional lower-level source metadata supplied by the authority. */\n  entitlementSource?: string;\n}\n\n/** Public diagnostic returned when Runtime entitlement resolution is not ready. */\ninterface RuntimeEntitlementError {\n  /** Stable backend or SDK error code. */\n  code: string;\n  /** Safe human-readable diagnostic. */\n  message: string;\n  /** Whether a later resolution attempt may succeed without reconfiguration. */\n  retryable: boolean;\n  /** Optional originating request correlation id. */\n  requestId?: string;\n  /** Optional originating trace correlation id. */\n  traceId?: string;\n}\n\n/** Successfully resolved Runtime entitlement response. */\ninterface RuntimeEntitlementReadyResponse {\n  status: \"ready\";\n  entitlement: RuntimeEntitlement;\n  error?: never;\n}\n\n/** Structured non-ready Runtime entitlement response. */\ninterface RuntimeEntitlementErrorResponse {\n  status: \"degraded\" | \"misconfigured\" | \"unavailable\";\n  entitlement?: never;\n  error: RuntimeEntitlementError;\n}\n\n/** Final structured Runtime entitlement response exposed through `/info`. */\nexport type RuntimeEntitlementResponse =\n  | RuntimeEntitlementReadyResponse\n  | RuntimeEntitlementErrorResponse;\n\nexport interface A2UIRuntimeInfo {\n  enabled: boolean;\n  /**\n   * Agent ids the runtime applies A2UI to. When omitted, A2UI applies to\n   * every agent served by the runtime.\n   */\n  agents?: string[];\n}\n\nexport interface RuntimeInfo {\n  version: string;\n  agents: Record<string, AgentDescription>;\n  audioFileTranscriptionEnabled: boolean;\n  mode: RuntimeMode;\n  intelligence?: IntelligenceRuntimeInfo;\n  threadEndpoints?: ThreadEndpointRuntimeInfo;\n  /** Whether this runtime exposes trusted inspector metadata. */\n  inspectorMetadata?: boolean;\n  /**\n   * When true, the runtime exposes POST /agent/:agentId/suggest for stateless\n   * suggestion generation. Absent on older runtimes; clients fall back to a\n   * client-side agent run.\n   */\n  suggestions?: boolean;\n  /**\n   * @deprecated Use `a2ui` instead, which preserves per-agent scoping.\n   * Kept for backward compatibility with older clients.\n   */\n  a2uiEnabled?: boolean;\n  a2ui?: A2UIRuntimeInfo;\n  openGenerativeUIEnabled?: boolean;\n  /** Structured Runtime-level entitlement authority, when advertised. */\n  runtimeEntitlements?: RuntimeEntitlementResponse;\n  /** Legacy compatibility diagnostic retained for older Core/Inspector clients. */\n  licenseStatus?: RuntimeLicenseStatus;\n  telemetryDisabled?: boolean;\n}\n"],"mappings":";AA0BA,MAAa,mBAAmB;AAChC,MAAa,4BAA4B"}
+{"version":3,"file":"types.mjs","names":[],"sources":["../../src/utils/types.ts"],"sourcesContent":["import type { AgentCapabilities } from \"@ag-ui/core\";\n\nexport type MaybePromise<T> = T | PromiseLike<T>;\n\n/**\n * More specific utility for records with at least one key\n */\nexport type NonEmptyRecord<T> =\n  T extends Record<string, unknown>\n    ? keyof T extends never\n      ? never\n      : T\n    : never;\n\n/**\n * Type representing an agent's basic information\n */\nexport interface AgentDescription {\n  name: string;\n  className: string;\n  description: string;\n  capabilities?: AgentCapabilities;\n}\n\nexport type RuntimeMode = \"sse\" | \"intelligence\";\n\nexport const RUNTIME_MODE_SSE = \"sse\" as const;\nexport const RUNTIME_MODE_INTELLIGENCE = \"intelligence\" as const;\n\nexport interface IntelligenceRuntimeInfo {\n  wsUrl: string;\n}\n\nexport interface ThreadEndpointRuntimeInfo {\n  list: boolean;\n  inspect: boolean;\n  mutations: boolean;\n  realtimeMetadata: boolean;\n}\n\nexport type RuntimeLicenseStatus =\n  | \"valid\"\n  | \"none\"\n  | \"expired\"\n  | \"expiring\"\n  | \"invalid\"\n  | \"unknown\";\n\n/** Runtime entitlement authority resolved by a managed or self-hosted backend. */\ninterface RuntimeEntitlement {\n  /** Whether the resolved entitlement currently grants product access. */\n  active: boolean;\n  /** Deployment authority that produced this entitlement. */\n  source:\n    | \"managedOrgSubscription\"\n    | \"selfHostedDeploymentLicense\"\n    | \"awsMarketplaceDeploymentLicense\";\n  /** Boolean feature grants keyed by stable feature id. */\n  features: Record<string, boolean>;\n  /** Numeric limits keyed by stable feature id. */\n  limits: Record<string, number>;\n  /** Optional catalog plan code supplied by the entitlement authority. */\n  planCode?: string;\n  /** Optional lower-level source metadata supplied by the authority. */\n  entitlementSource?: string;\n}\n\n/** Public diagnostic returned when Runtime entitlement resolution is not ready. */\ninterface RuntimeEntitlementError {\n  /** Stable backend or SDK error code. */\n  code: string;\n  /** Safe human-readable diagnostic. */\n  message: string;\n  /** Whether a later resolution attempt may succeed without reconfiguration. */\n  retryable: boolean;\n  /** Optional originating request correlation id. */\n  requestId?: string;\n  /** Optional originating trace correlation id. */\n  traceId?: string;\n}\n\n/** Successfully resolved Runtime entitlement response. */\ninterface RuntimeEntitlementReadyResponse {\n  status: \"ready\";\n  entitlement: RuntimeEntitlement;\n  error?: never;\n}\n\n/** Structured non-ready Runtime entitlement response. */\ninterface RuntimeEntitlementErrorResponse {\n  status: \"degraded\" | \"misconfigured\" | \"unavailable\";\n  entitlement?: never;\n  error: RuntimeEntitlementError;\n}\n\n/** Final structured Runtime entitlement response exposed through `/info`. */\nexport type RuntimeEntitlementResponse =\n  | RuntimeEntitlementReadyResponse\n  | RuntimeEntitlementErrorResponse;\n\nexport interface A2UIRuntimeInfo {\n  enabled: boolean;\n  /**\n   * Agent ids the runtime applies A2UI to. When omitted, A2UI applies to\n   * every agent served by the runtime.\n   */\n  agents?: string[];\n}\n\n/** Intelligence resource support available through a single runtime route. */\nexport interface SingleRouteRuntimeInfo {\n  /** Whether the runtime accepts resource requests through the single route. */\n  resourceOperations: boolean;\n  /** Thread features available through the single-route resource bridge. */\n  threadEndpoints: ThreadEndpointRuntimeInfo;\n}\n\nexport interface RuntimeInfo {\n  version: string;\n  agents: Record<string, AgentDescription>;\n  audioFileTranscriptionEnabled: boolean;\n  mode: RuntimeMode;\n  intelligence?: IntelligenceRuntimeInfo;\n  threadEndpoints?: ThreadEndpointRuntimeInfo;\n  /** Optional capabilities exposed by runtimes that use one HTTP route. */\n  singleRoute?: SingleRouteRuntimeInfo;\n  /** Whether this runtime exposes trusted inspector metadata. */\n  inspectorMetadata?: boolean;\n  /** Whether this runtime exposes the debug-authorized Learning snapshot. */\n  inspectorLearning?: boolean;\n  /**\n   * When true, the runtime exposes POST /agent/:agentId/suggest for stateless\n   * suggestion generation. Absent on older runtimes; clients fall back to a\n   * client-side agent run.\n   */\n  suggestions?: boolean;\n  /**\n   * @deprecated Use `a2ui` instead, which preserves per-agent scoping.\n   * Kept for backward compatibility with older clients.\n   */\n  a2uiEnabled?: boolean;\n  a2ui?: A2UIRuntimeInfo;\n  openGenerativeUIEnabled?: boolean;\n  /** Structured Runtime-level entitlement authority, when advertised. */\n  runtimeEntitlements?: RuntimeEntitlementResponse;\n  /** Legacy compatibility diagnostic retained for older Core/Inspector clients. */\n  licenseStatus?: RuntimeLicenseStatus;\n  telemetryDisabled?: boolean;\n}\n"],"mappings":";AA0BA,MAAa,mBAAmB;AAChC,MAAa,4BAA4B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@copilotkit/shared",
-  "version": "1.70.0",
+  "version": "1.70.2",
   "private": false,
   "keywords": [
     "ai",
@@ -32,8 +32,19 @@
       "import": "./dist/index.mjs",
       "require": "./dist/index.cjs"
     },
+    "./telemetry": {
+      "import": "./dist/telemetry/index.mjs",
+      "require": "./dist/telemetry/index.cjs"
+    },
     "./package.json": "./package.json"
   },
+  "typesVersions": {
+    "*": {
+      "telemetry": [
+        "./dist/telemetry/index.d.cts"
+      ]
+    }
+  },
   "publishConfig": {
     "access": "public"
   },

package/src/__tests__/license-context.test.ts

@@ -1,6 +1,9 @@
 import { expect, test } from "vitest";
 import { createLicenseContextValue } from "../index";
-import type { RuntimeLicenseStatus } from "../utils/types";
+import type {
+  RuntimeEntitlementResponse,
+  RuntimeLicenseStatus,
+} from "../utils/types";
 
 test("license context fails open when no status is known", () => {
   for (const status of [null, undefined] as const) {
@@ -162,6 +165,24 @@ test("license context denies features and limits for a ready inactive entitlemen
   expect(ctx.getLimit("threads")).toBeNull();
 });
 
+test("license context does not fall back for an inactive AWS Marketplace entitlement", () => {
+  const marketplaceEntitlements = {
+    status: "ready",
+    entitlement: {
+      active: false,
+      source: "awsMarketplaceDeploymentLicense",
+      features: {},
+      limits: {},
+    },
+  } as const satisfies RuntimeEntitlementResponse;
+
+  const ctx = createLicenseContextValue("valid", marketplaceEntitlements);
+
+  expect(ctx.status).toBe("none");
+  expect(ctx.checkFeature("threads")).toBe(false);
+  expect(ctx.getLimit("threads")).toBeNull();
+});
+
 test.each(["valid", "expiring"] as RuntimeLicenseStatus[])(
   "license context preserves a %s legacy fallback for an inactive self-hosted entitlement",
   (status) => {

package/src/__tests__/root-entry-browser-safety.test.ts

@@ -0,0 +1,85 @@
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { describe, expect, it } from "vitest";
+
+/**
+ * `@copilotkit/shared` is imported by browser-facing packages such as
+ * `@copilotkit/react-core`. Browser bundlers resolve the whole static module
+ * graph before they tree-shake, so a single static edge from this entry to a
+ * Node-only package makes every dependent browser build print "Module ... has
+ * been externalized for browser compatibility" warnings, even when the
+ * consumer never touches the offending code. That was issue #4151, caused by
+ * the root entry re-exporting `telemetry/telemetry-client.ts`.
+ *
+ * Deferring the import does not help: a dynamic import keeps the graph edge.
+ * The edge itself has to stay out of this entry. This test walks the static,
+ * value-level graph from `src/index.ts` and fails if it reaches a Node-only
+ * package. Type-only edges are erased at build time and are therefore fine.
+ */
+const NODE_ONLY_PACKAGES = ["@segment/analytics-node", "node-fetch"];
+
+const SRC = resolve(__dirname, "..");
+
+function resolveRelative(fromFile: string, specifier: string): string | null {
+  const base = join(dirname(fromFile), specifier);
+  for (const candidate of [
+    `${base}.ts`,
+    `${base}.tsx`,
+    join(base, "index.ts"),
+    base,
+  ]) {
+    if (existsSync(candidate) && !candidate.endsWith("/")) {
+      return candidate;
+    }
+  }
+  return null;
+}
+
+/** Bare specifiers reachable from `entry` through value (non-type) edges. */
+function collectRuntimeDependencies(entry: string): Set<string> {
+  const bare = new Set<string>();
+  const seen = new Set<string>();
+  const queue = [entry];
+
+  while (queue.length > 0) {
+    const file = queue.pop()!;
+    if (seen.has(file)) continue;
+    seen.add(file);
+
+    const source = readFileSync(file, "utf8");
+    // `import ... from "x"`, `export ... from "x"`, `import("x")`. The
+    // negative lookahead drops `import type` / `export type`, which the
+    // compiler erases.
+    const pattern =
+      /(?:\b(?:import|export)\b(?!\s+type\b)[\s\S]*?\bfrom\s*|\bimport\s*\(\s*)["']([^"']+)["']/g;
+
+    for (const match of source.matchAll(pattern)) {
+      const specifier = match[1];
+      if (specifier.startsWith(".")) {
+        const target = resolveRelative(file, specifier);
+        if (target) queue.push(target);
+        continue;
+      }
+      bare.add(specifier);
+    }
+  }
+
+  return bare;
+}
+
+describe("root entry browser safety (#4151)", () => {
+  it("does not reach Node-only packages through value imports", () => {
+    const reachable = collectRuntimeDependencies(join(SRC, "index.ts"));
+    const offenders = NODE_ONLY_PACKAGES.filter((pkg) => reachable.has(pkg));
+    expect(offenders).toEqual([]);
+  });
+
+  it("still reaches Node-only packages from the telemetry subpath entry", () => {
+    // Guards the test itself: the walker has to be able to see the edge it is
+    // asserting the absence of above.
+    const reachable = collectRuntimeDependencies(
+      join(SRC, "telemetry", "index.ts"),
+    );
+    expect(reachable).toContain("@segment/analytics-node");
+  });
+});

package/src/attachments/types.ts

@@ -44,6 +44,16 @@ export interface AttachmentsConfig {
   accept?: string;
   /** Maximum file size in bytes, default 20MB (20 * 1024 * 1024) */
   maxSize?: number;
+  /**
+   * How many files may upload at the same time, default 1 — `onUpload` is not
+   * called concurrently unless you raise this. Files past the limit wait for a
+   * free slot; `Infinity` lifts it. The limit covers everything in flight, so
+   * two selections dropped or pasted at once share the slots rather than each
+   * taking the full number.
+   * Honored by the React `useAttachments` hook — the Vue and Angular bindings
+   * still upload serially.
+   */
+  maxConcurrentUploads?: number;
   /** Custom upload handler. Return an InputContentSource with optional metadata. */
   onUpload?: (
     file: File,

package/src/index.ts

@@ -1,7 +1,31 @@
 export * from "./types";
 export * from "./utils";
 export * from "./constants";
-export * from "./telemetry";
+// Telemetry is split deliberately. `TelemetryClient` imports
+// `@segment/analytics-node`, which imports `node-fetch`, which imports the
+// Node built-ins `stream`, `http`, `https` and `zlib`. Browser bundlers
+// resolve the whole module graph before they tree-shake, so re-exporting
+// that module here made every browser build of a dependent package print
+// "Module ... has been externalized for browser compatibility" warnings,
+// even when the consumer never touched telemetry (#4151). Only the
+// browser-safe telemetry surface is re-exported from this entry. Server
+// code that needs the client imports it from `@copilotkit/shared/telemetry`.
+// This mirrors the license-verifier note below.
+export { isTelemetryDisabled } from "./telemetry/telemetry-disabled";
+export * from "./telemetry/sampling";
+export {
+  firstNonBlankTelemetryId,
+  lambdaClient,
+  parseTelemetryIdFromLicense,
+  parseAndWarnTelemetryId,
+} from "./telemetry/lambda-client";
+export type { LambdaSendOptions } from "./telemetry/lambda-client";
+// Types only: erased at build time, so they add no runtime edge to
+// `telemetry-client.ts` and therefore none to @segment/analytics-node.
+export type {
+  TelemetryCapture,
+  TelemetryIdentity,
+} from "./telemetry/telemetry-client";
 export * from "./debug";
 export * from "./standard-schema";
 export * from "./attachments";
@@ -106,7 +130,8 @@ export function createLicenseContextValue(
   const activeEntitlement = featureAuthority?.active ? featureAuthority : null;
   const resolvedStatus = activeEntitlement
     ? "valid"
-    : readyEntitlement?.source === "managedOrgSubscription"
+    : readyEntitlement?.source === "managedOrgSubscription" ||
+        readyEntitlement?.source === "awsMarketplaceDeploymentLicense"
       ? "none"
       : featureAuthority
         ? (status ?? "none")

package/src/telemetry/telemetry-client.ts

@@ -8,24 +8,9 @@ import {
   parseAndWarnTelemetryId,
 } from "./lambda-client";
 import { computeSamplingMeta, TELEMETRY_EMITTER_V1 } from "./sampling";
+import { isTelemetryDisabled } from "./telemetry-disabled";
 
-/**
- * Checks if telemetry is disabled via environment variables.
- * Users can opt out by setting:
- * - COPILOTKIT_TELEMETRY_DISABLED=true or COPILOTKIT_TELEMETRY_DISABLED=1
- * - DO_NOT_TRACK=true or DO_NOT_TRACK=1
- */
-export function isTelemetryDisabled(): boolean {
-  return (
-    (process.env as Record<string, string | undefined>)
-      .COPILOTKIT_TELEMETRY_DISABLED === "true" ||
-    (process.env as Record<string, string | undefined>)
-      .COPILOTKIT_TELEMETRY_DISABLED === "1" ||
-    (process.env as Record<string, string | undefined>).DO_NOT_TRACK ===
-      "true" ||
-    (process.env as Record<string, string | undefined>).DO_NOT_TRACK === "1"
-  );
-}
+export { isTelemetryDisabled };
 
 /** Transport identity and sampling authority resolved for one runtime. */
 export interface TelemetryIdentity {

package/src/telemetry/telemetry-disabled.ts

@@ -0,0 +1,22 @@
+/**
+ * Checks if telemetry is disabled via environment variables.
+ * Users can opt out by setting:
+ * - COPILOTKIT_TELEMETRY_DISABLED=true or COPILOTKIT_TELEMETRY_DISABLED=1
+ * - DO_NOT_TRACK=true or DO_NOT_TRACK=1
+ *
+ * Lives in its own module so that the browser-facing root entry can
+ * re-export it without pulling in `telemetry-client.ts`, whose
+ * `@segment/analytics-node` import drags Node built-ins into browser
+ * bundler module graphs. See the note in `../index.ts`.
+ */
+export function isTelemetryDisabled(): boolean {
+  return (
+    (process.env as Record<string, string | undefined>)
+      .COPILOTKIT_TELEMETRY_DISABLED === "true" ||
+    (process.env as Record<string, string | undefined>)
+      .COPILOTKIT_TELEMETRY_DISABLED === "1" ||
+    (process.env as Record<string, string | undefined>).DO_NOT_TRACK ===
+      "true" ||
+    (process.env as Record<string, string | undefined>).DO_NOT_TRACK === "1"
+  );
+}

package/src/utils/console-styling.ts

@@ -53,15 +53,15 @@ export function logCopilotKitPlatformMessage() {
   console.log(
     `%cCopilotKit Warning%c
 
-useCopilotChatHeadless_c provides full compatibility with CopilotKit's newly released Headless UI feature set. To enable this premium feature, add your public license key, available for free at:
+useCopilotChatHeadless_c provides full compatibility with CopilotKit's newly released Headless UI feature set. Headless UI requires a CopilotKit Intelligence license key, available for free at:
 
 %chttps://dashboard.operations.copilotkit.ai%c
 
 Alternatively, useCopilotChat is available for basic programmatic control, and does not require a license key.
 
-To learn more about premium features, read the documentation here:
+To learn more about CopilotKit Intelligence, read the documentation here:
 
-%chttps://docs.copilotkit.ai/premium/overview%c`,
+%chttps://docs.copilotkit.ai/intelligence/overview%c`,
     ConsoleStyles.header,
     ConsoleStyles.body,
     ConsoleStyles.cta,

package/src/utils/index.ts

@@ -4,6 +4,7 @@ export * from "./console-styling";
 export * from "./errors";
 export * from "./json-schema";
 export * from "./inspector-metadata";
+export * from "./inspector-learning";
 export * from "./inspector-visibility";
 export * from "./types";
 export * from "./random-id";