@copilotkit/shared 1.70.1 → 1.70.2

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.1",
+  "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/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";

package/src/utils/inspector-learning.test.ts

@@ -0,0 +1,213 @@
+import { describe, expect, it } from "vitest";
+import {
+  parseInspectorLearningRequestV1,
+  parseInspectorLearningSnapshotV1,
+  parseInspectorLearningUrl,
+} from "./inspector-learning";
+
+const emptySnapshot = () => ({
+  schemaVersion: 1,
+  projectKey: "project-safe-key",
+  snapshotVersion: "snapshot-1",
+  webAppOrigin: "https://app.copilotkit.ai",
+  configuration: { state: "not_configured" },
+  pendingThreadCount: 0,
+  run: { hasActiveRun: false, hasEverSucceeded: false, latest: null },
+  pendingCandidateCount: 0,
+  skillsPage: {
+    page: 1,
+    pageSize: 3,
+    total: 0,
+    totalPages: 0,
+    items: [],
+  },
+  insightsPage: {
+    page: 1,
+    pageSize: 4,
+    total: 0,
+    totalPages: 0,
+    items: [],
+  },
+  links: {
+    learning: "https://app.copilotkit.ai/learning",
+    candidates: null,
+    runs: null,
+  },
+});
+
+describe("Inspector Learning wire validation", () => {
+  it("accepts and copies a bounded V1 snapshot", () => {
+    const source = emptySnapshot();
+    const parsed = parseInspectorLearningSnapshotV1(source);
+
+    expect(parsed).toEqual(source);
+    expect(parsed).not.toBe(source);
+  });
+
+  it("copies only the supported fields from the latest Learning run", () => {
+    const source = {
+      ...emptySnapshot(),
+      run: {
+        hasActiveRun: false,
+        hasEverSucceeded: true,
+        latest: {
+          status: "succeeded",
+          completedAt: "2026-09-04T12:00:00.000Z",
+          internalPayload: "must-not-cross-the-boundary",
+        },
+      },
+    };
+
+    expect(parseInspectorLearningSnapshotV1(source)?.run.latest).toEqual({
+      status: "succeeded",
+      completedAt: "2026-09-04T12:00:00.000Z",
+    });
+  });
+
+  it("rejects unsafe links and oversized evidence", () => {
+    expect(
+      parseInspectorLearningUrl(
+        "javascript:alert(1)",
+        "https://app.copilotkit.ai",
+      ),
+    ).toBeUndefined();
+    expect(
+      parseInspectorLearningUrl(
+        "http://example.com/learning",
+        "https://app.copilotkit.ai",
+      ),
+    ).toBeUndefined();
+    expect(
+      parseInspectorLearningUrl(
+        "https://attacker.example/learning",
+        "https://app.copilotkit.ai",
+      ),
+    ).toBeUndefined();
+    expect(
+      parseInspectorLearningUrl(
+        "https://app.copilotkit.ai.evil.test/learning",
+        "https://app.copilotkit.ai",
+      ),
+    ).toBeUndefined();
+    expect(
+      parseInspectorLearningUrl(
+        "http://localhost:3000/learning",
+        "http://localhost:3000",
+      ),
+    ).toBe("http://localhost:3000/learning");
+    expect(
+      parseInspectorLearningUrl(
+        "https://intelligence.customer.example/learning",
+        "https://intelligence.customer.example",
+      ),
+    ).toBe("https://intelligence.customer.example/learning");
+
+    const snapshot = emptySnapshot();
+    snapshot.insightsPage = {
+      page: 1,
+      pageSize: 4,
+      total: 1,
+      totalPages: 1,
+      items: [
+        {
+          id: "insight-1",
+          statement: "A bounded pattern",
+          impact: "A bounded impact",
+          totalThreadCount: 101,
+          evidenceTruncated: true,
+          evidence: Array.from({ length: 101 }, (_, index) => ({
+            status: "available",
+            threadId: `thread-${index}`,
+            threadName: null,
+            messageIds: [],
+            updatedAt: "2026-09-03T00:00:00.000Z",
+          })),
+        },
+      ],
+    };
+    expect(parseInspectorLearningSnapshotV1(snapshot)).toBeUndefined();
+  });
+
+  it("rejects required actions that are absent or point at another origin", () => {
+    const missingRuns = emptySnapshot();
+    missingRuns.pendingThreadCount = 1;
+    expect(parseInspectorLearningSnapshotV1(missingRuns)).toBeUndefined();
+
+    const missingCandidates = emptySnapshot();
+    missingCandidates.pendingCandidateCount = 1;
+    expect(parseInspectorLearningSnapshotV1(missingCandidates)).toBeUndefined();
+
+    const arbitraryOrigin = emptySnapshot();
+    arbitraryOrigin.links.learning = "https://attacker.example/learning";
+    expect(parseInspectorLearningSnapshotV1(arbitraryOrigin)).toBeUndefined();
+
+    const configuredOrigin = emptySnapshot();
+    configuredOrigin.webAppOrigin = "https://intelligence.customer.example";
+    configuredOrigin.links.learning =
+      "https://intelligence.customer.example/learning";
+    expect(parseInspectorLearningSnapshotV1(configuredOrigin)).toBeDefined();
+  });
+
+  it("accepts identifier-free unavailable evidence separately from unnamed evidence", () => {
+    const snapshot = emptySnapshot();
+    snapshot.insightsPage = {
+      page: 1,
+      pageSize: 4,
+      total: 1,
+      totalPages: 1,
+      items: [
+        {
+          id: "insight-1",
+          statement: "Verify the order.",
+          impact: "Avoids incorrect guidance.",
+          totalThreadCount: 2,
+          evidenceTruncated: false,
+          evidence: [
+            { status: "unavailable" },
+            {
+              status: "available",
+              threadId: "thread-2",
+              threadName: null,
+              messageIds: ["message-2"],
+              updatedAt: "2026-09-03T00:00:00.000Z",
+            },
+          ],
+        },
+      ],
+    };
+
+    expect(parseInspectorLearningSnapshotV1(snapshot)).toBeDefined();
+    snapshot.insightsPage.items[0].evidence[0] = {
+      status: "unavailable",
+      threadId: "former-id",
+    };
+    expect(parseInspectorLearningSnapshotV1(snapshot)).toBeUndefined();
+  });
+
+  it("rejects inconsistent server pagination", () => {
+    const snapshot = emptySnapshot();
+    snapshot.insightsPage = {
+      page: 2,
+      pageSize: 4,
+      total: 1,
+      totalPages: 1,
+      items: [],
+    };
+
+    expect(parseInspectorLearningSnapshotV1(snapshot)).toBeUndefined();
+  });
+
+  it("accepts only the browser-owned scope and pagination fields", () => {
+    expect(
+      parseInspectorLearningRequestV1({
+        agentId: "support",
+        skillsPage: 2,
+        insightsPage: 3,
+      }),
+    ).toEqual({ agentId: "support", skillsPage: 2, insightsPage: 3 });
+    expect(
+      parseInspectorLearningRequestV1({ runtimeContainerId: "attacker-scope" }),
+    ).toBeUndefined();
+    expect(parseInspectorLearningRequestV1({ skillsPage: 0 })).toBeUndefined();
+  });
+});