@copilotkit/runtime 1.69.3 → 1.70.0

package/dist/v2/runtime/intelligence-platform/client.d.cts

@@ -1,5 +1,6 @@
 
-import { InspectorMetadataV1 } from "@copilotkit/shared";
+import { GetLearningContainerId } from "../core/learning.cjs";
+import { InspectorMetadataV1, RuntimeEntitlementResponse } from "@copilotkit/shared";
 
 //#region src/v2/runtime/intelligence-platform/client.d.ts
 interface RuntimeMemoryGrant {
@@ -53,6 +54,14 @@ interface CopilotKitIntelligenceConfig {
   wsUrl?: string;
   /** API key for authenticating with CopilotKit Intelligence */
   apiKey: string;
+  /**
+   * Chooses the stable Learning Container ID for each Intelligence run.
+   * The callback receives the resolved application user and AG-UI run input.
+   * It must return the same ID for every run on one Thread because a Thread
+   * cannot move between Learning Containers after its first assignment.
+   * Return `null` or `undefined` to leave the Thread unassigned.
+   */
+  getLearningContainerId?: GetLearningContainerId;
   /**
    * Enable Enterprise Learning — expose CopilotKit Intelligence's
    * built-in tools (bash + thread/memory tools) to agent runs on an
@@ -379,7 +388,7 @@ interface ThreadLockInfo {
  * import { CopilotKitIntelligence, CopilotRuntime } from "@copilotkit/runtime";
  *
  * const intelligence = new CopilotKitIntelligence({
- *   apiKey: process.env.INTELLIGENCE_API_KEY!,
+ *   apiKey: process.env.CPK_INTELLIGENCE_API_KEY!,
  * });
  *
  * const runtime = new CopilotRuntime({
@@ -400,7 +409,7 @@ interface ThreadLockInfo {
  * const intelligence = new CopilotKitIntelligence({
  *   apiUrl: "https://api.intelligence.example.com",
  *   wsUrl: "wss://realtime.intelligence.example.com",
- *   apiKey: process.env.INTELLIGENCE_API_KEY!,
+ *   apiKey: process.env.CPK_INTELLIGENCE_API_KEY!,
  * });
  * ```
  */
@@ -454,6 +463,8 @@ declare class CopilotKitIntelligence {
   ɵgetRunnerAuthToken(): string;
   /** @internal Used by `attachIntelligenceEnterpriseLearning` to populate `Authorization`. */
   ɵgetApiKey(): string;
+  /** @internal Used by the Intelligence runtime to assign Learning Containers. */
+  ɵgetLearningContainerId(): GetLearningContainerId | undefined;
   /** @internal Used by `attachIntelligenceEnterpriseLearning` to gate MCP attachment. */
   ɵisEnterpriseLearningEnabled(): boolean;
   /**
@@ -468,6 +479,14 @@ declare class CopilotKitIntelligence {
    * @throws {@link PlatformRequestError} for provider failures other than 404.
    */
   getInspectorMetadata(): Promise<InspectorMetadataV1 | undefined>;
+  /**
+   * Resolve the Runtime entitlement projection for this project.
+   *
+   * Concurrent calls share one request. Active grants cache for 30 seconds;
+   * inactive results and failures cache for 5 seconds. Callers receive copies
+   * so they cannot mutate cached authority.
+   */
+  getRuntimeEntitlements(): Promise<RuntimeEntitlementResponse>;
   /**
    * List all non-archived threads for a given user and agent.
    *

package/dist/v2/runtime/intelligence-platform/client.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.cts","names":[],"sources":["../../../../src/v2/runtime/intelligence-platform/client.ts"],"mappings":"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"}
+{"version":3,"file":"client.d.cts","names":[],"sources":["../../../../src/v2/runtime/intelligence-platform/client.ts"],"mappings":"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"}

package/dist/v2/runtime/intelligence-platform/client.d.mts

@@ -1,5 +1,6 @@
 
-import { InspectorMetadataV1 } from "@copilotkit/shared";
+import { GetLearningContainerId } from "../core/learning.mjs";
+import { InspectorMetadataV1, RuntimeEntitlementResponse } from "@copilotkit/shared";
 
 //#region src/v2/runtime/intelligence-platform/client.d.ts
 interface RuntimeMemoryGrant {
@@ -53,6 +54,14 @@ interface CopilotKitIntelligenceConfig {
   wsUrl?: string;
   /** API key for authenticating with CopilotKit Intelligence */
   apiKey: string;
+  /**
+   * Chooses the stable Learning Container ID for each Intelligence run.
+   * The callback receives the resolved application user and AG-UI run input.
+   * It must return the same ID for every run on one Thread because a Thread
+   * cannot move between Learning Containers after its first assignment.
+   * Return `null` or `undefined` to leave the Thread unassigned.
+   */
+  getLearningContainerId?: GetLearningContainerId;
   /**
    * Enable Enterprise Learning — expose CopilotKit Intelligence's
    * built-in tools (bash + thread/memory tools) to agent runs on an
@@ -379,7 +388,7 @@ interface ThreadLockInfo {
  * import { CopilotKitIntelligence, CopilotRuntime } from "@copilotkit/runtime";
  *
  * const intelligence = new CopilotKitIntelligence({
- *   apiKey: process.env.INTELLIGENCE_API_KEY!,
+ *   apiKey: process.env.CPK_INTELLIGENCE_API_KEY!,
  * });
  *
  * const runtime = new CopilotRuntime({
@@ -400,7 +409,7 @@ interface ThreadLockInfo {
  * const intelligence = new CopilotKitIntelligence({
  *   apiUrl: "https://api.intelligence.example.com",
  *   wsUrl: "wss://realtime.intelligence.example.com",
- *   apiKey: process.env.INTELLIGENCE_API_KEY!,
+ *   apiKey: process.env.CPK_INTELLIGENCE_API_KEY!,
  * });
  * ```
  */
@@ -454,6 +463,8 @@ declare class CopilotKitIntelligence {
   ɵgetRunnerAuthToken(): string;
   /** @internal Used by `attachIntelligenceEnterpriseLearning` to populate `Authorization`. */
   ɵgetApiKey(): string;
+  /** @internal Used by the Intelligence runtime to assign Learning Containers. */
+  ɵgetLearningContainerId(): GetLearningContainerId | undefined;
   /** @internal Used by `attachIntelligenceEnterpriseLearning` to gate MCP attachment. */
   ɵisEnterpriseLearningEnabled(): boolean;
   /**
@@ -468,6 +479,14 @@ declare class CopilotKitIntelligence {
    * @throws {@link PlatformRequestError} for provider failures other than 404.
    */
   getInspectorMetadata(): Promise<InspectorMetadataV1 | undefined>;
+  /**
+   * Resolve the Runtime entitlement projection for this project.
+   *
+   * Concurrent calls share one request. Active grants cache for 30 seconds;
+   * inactive results and failures cache for 5 seconds. Callers receive copies
+   * so they cannot mutate cached authority.
+   */
+  getRuntimeEntitlements(): Promise<RuntimeEntitlementResponse>;
   /**
    * List all non-archived threads for a given user and agent.
    *

package/dist/v2/runtime/intelligence-platform/client.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.mts","names":[],"sources":["../../../../src/v2/runtime/intelligence-platform/client.ts"],"mappings":"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"}
+{"version":3,"file":"client.d.mts","names":[],"sources":["../../../../src/v2/runtime/intelligence-platform/client.ts"],"mappings":";;;;;UAiIU,kBAAA;EAAA,SACC,IAAA;EAAA,SACA,OAAA;AAAA;;;;;;;;;;;;;;;;;;;UA+FM,oBAAA;EACf,QAAA;EACA,MAAA;EACA,OAAA;AAAA;AAAA,UAGe,4BAAA;EAqFf;;;;;;AAUF;EAvFE,MAAA;;;;;;;;;;AAsGF;;;EAzFE,KAAA;EA2FA;EAzFA,MAAA;EA6FA;;;;;;;EArFA,sBAAA,GAAyB,sBAAA;EAiGU;;;;AAKrC;;;;;AASA;;;;;EAhGE,wBAAA;EAoGA;;;AASF;EAxGE,eAAA,IAAmB,MAAA,EAAQ,aAAA;;;;AA+G7B;EA1GE,eAAA,IAAmB,MAAA,EAAQ,aAAA;;;;;EAK3B,eAAA,IAAmB,MAAA,EAAQ,oBAAA;AAAA;;;;AAmH7B;;;;UAzGiB,aAAA;EA6Gf;EA3GA,EAAA;EA+GA;EA7GA,IAAA;EA6GqB;EA3GrB,SAAA;EA8Ge;EA5Gf,aAAA;;EAEA,SAAA;EA2GM;EAzGN,SAAA;EA4GyC;EA1GzC,QAAA;EA2GA;EAzGA,OAAA;EA4Ge;EA1Gf,WAAA;;EAEA,cAAA;AAAA;;UAIe,mBAAA;EAsGiB;EApGhC,OAAA,EAAS,aAAA;EA6GM;EA3Gf,QAAA;;EAEA,SAAA;EA0GA;EAxGA,UAAA;AAAA;;;;AAqHF;UA9GiB,aAAA;;EAEf,EAAA;EA4G0D;EA1G1D,IAAA;EA4GyC;EA1GzC,KAAA;EA0GiD;EAxGjD,OAAA;EAwHe;EAtHf,eAAA;;EAEA,aAAA;EAsHA;EApHA,KAAA;AAAA;;UAIe,oBAAA;EACf,QAAA,EAAU,aAAA;AAAA;;UAIK,sBAAA;EACf,QAAA,EAAU,aAAA;AAAA;;;AA6IZ;;;UArIiB,kBAAA,SAA2B,aAAA;EAuI1C;EArIA,QAAA;EAyIA;EAvIA,SAAA;AAAA;;;;;;;UASe,mBAAA;EA6IA;EA3If,IAAA;EAAA,CACC,GAAA;AAAA;;UAIc,mBAAA;EA+IkB;EA7IjC,QAAA;EA8IA;EA5IA,MAAA;EAqJe;EAnJf,OAAA;;EAEA,IAAA;EAkJA;EAhJA,mBAAA;AAAA;;UAIe,wBAAA;EAgJN;EA9IT,QAAA;EAuJ6B;EArJ7B,KAAA;EAqJ6B;EAnJ7B,SAAA;EAqJI;EAnJJ,IAAA,GAAO,cAAA;AAAA;AAAA,UAGQ,yBAAA;EACf,MAAA;AAAA;AAAA,UAGe,0BAAA;EACf,SAAA;AAAA;AAAA,UAGe,0BAAA;EACf,MAAA;EACA,WAAA,GAAc,kBAAA;AAAA;;;;;;;UASC,2BAAA;EACf,SAAA;EACA,QAAA;;;;;;;;EAQA,gBAAA;EACA,eAAA;AAAA;AAAA,KAGU,qBAAA,GAAwB,wBAAA;AAAA,UAEnB,yBAAA,SAAkC,wBAAA;EA0I5C;EAxIL,KAAA;AAAA;;;;AA+IF;;;;;AA4CA;;;UA7KiB,cAAA;EAqPoB;EAnPnC,MAAA;EAqRqB;EAnRrB,QAAA;EAyUsC;;;;;EAnUtC,IAAA;EAymBgB;EAvmBhB,OAAA;EAymBI;;;;;;EAlmBJ,aAAA;EA8qBgB;EA5qBhB,UAAA;AAAA;;UAIe,gBAAA;EA4sBL;EA1sBV,EAAA;EA2sBG;;;;;EArsBH,SAAA;AAAA;;UAIe,aAAA;EA2wBkC;EAzwBjD,EAAA;EAqyBI;EAnyBJ,IAAA;EA6zBqB;EA3zBrB,OAAA;EAm2BY;EAj2BZ,YAAA;EA+2BS;EA72BT,SAAA,GAAY,KAAA;IACV,EAAA;IACA,IAAA,UAk6BU;IAh6BV,IAAA;EAAA;EAw8BE;EAr8BJ,UAAA;AAAA;;UAIe,sBAAA;EACf,QAAA,EAAU,aAAA;AAAA;;;;;;UAQK,kBAAA;EACf,IAAA;EAAA,CACC,GAAA;AAAA;;;;;;UAQc,oBAAA;EACf,MAAA,EAAQ,kBAAA;EAuK2B;EArKnC,iBAAA;EAqKgB;EAnKhB,SAAA;AAAA;;;;;;;KASU,mBAAA;EACN,IAAA;AAAA;EACA,IAAA;AAAA;EACA,IAAA;EAAkB,KAAA;EAAgB,aAAA;AAAA;AAAA,UAEvB,wBAAA;EACf,QAAA;EACA,KAAA;EACA,MAAA;EACA,OAAA;EAySwC;EAvSxC,mBAAA;EA+eE;EA7eF,iBAAA;EA+eE;EA7eF,aAAA;EA+eE;EA7eF,UAAA;AAAA;AAAA,UAGe,sBAAA;EACf,QAAA;EACA,KAAA;EAkgBE;EAhgBF,UAAA;EAigBE;EA/fF,aAAA;AAAA;AAAA,UAGe,wBAAA;EACf,QAAA;EACA,KAAA;AAAA;AAAA,UAGe,uBAAA;EACf,UAAA;AAAA;AAAA,UAGe,cAAA;EACf,GAAA;EACA,UAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA0CW,sBAAA;EAAA;cAeC,MAAA,EAAQ,4BAAA;EAukBjB;;;;;;;;;;;;;;;;;;EA9gBH,eAAA,CAAgB,QAAA,GAAW,MAAA,EAAQ,aAAA;EAolBnB;;;;;;;;;EApkBhB,eAAA,CAAgB,QAAA,GAAW,MAAA,EAAQ,aAAA;EAooB7B;;;;;;;;;;EAnnBN,eAAA,CACE,QAAA,GAAW,MAAA,EAAQ,oBAAA;EAQrB,UAAA,CAAA;EAIA,eAAA,CAAA;EAIA,eAAA,CAAA;EAIA,iBAAA,CAAA;EAIA,mBAAA,CAAA;EA8oBI;EAzoBJ,UAAA,CAAA;EA6pBM;EAxpBN,uBAAA,CAAA,GAA2B,sBAAA;EAwpBN;EAnpBrB,4BAAA,CAAA;EAqpBY;;;;;;;;;;;EAtoBN,oBAAA,CAAA,GAAwB,OAAA,CAAQ,mBAAA;EA8qBlC;;;;;;;EA9mBE,sBAAA,CAAA,GAA0B,OAAA,CAAQ,0BAAA;EAqrBtC;;;;;;;;EA9eI,WAAA,CAAY,MAAA;IAChB,MAAA;IACA,OAAA;IACA,eAAA;IACA,KAAA;IACA,MAAA;EAAA,IACE,OAAA,CAAQ,mBAAA;EA2hBa;;;;;;;;;;EApgBnB,YAAA,CAAa,MAAA;IACjB,MAAA;IACA,WAAA,GAAc,kBAAA;IACd,kBAAA;EAAA,IACE,OAAA,CAAQ,oBAAA;;;;;;;EAgBN,YAAA,CAAa,MAAA;IACjB,MAAA;IACA,WAAA,GAAc,kBAAA;IACd,OAAA;IACA,IAAA;IAEA,KAAA;IACA,eAAA;EAAA,IACE,OAAA,CAAQ,kBAAA;;;;;;;;;EAsBN,YAAA,CAAa,MAAA;IACjB,MAAA;IACA,WAAA,GAAc,kBAAA;IACd,EAAA;IACA,OAAA;IACA,IAAA;IAEA,KAAA;IACA,eAAA;EAAA,IACE,OAAA,CAAQ,kBAAA;;;;;EAkBN,YAAA,CAAa,MAAA;IACjB,MAAA;IACA,EAAA;IACA,WAAA,GAAc,kBAAA;EAAA,IACZ,OAAA;;;;;;;EAeE,cAAA,CAAe,MAAA;IACnB,MAAA;IACA,WAAA,GAAc,kBAAA;IACd,KAAA;IACA,KAAA;IACA,KAAA;EAAA,IACE,OAAA,CAAQ,sBAAA;EAaN,mBAAA,CACJ,MAAA,EAAQ,yBAAA,GACP,OAAA,CAAQ,0BAAA;;;;;;;;;;;;;;;;;;EA2BL,oBAAA,CACJ,MAAA,EAAQ,0BAAA,GACP,OAAA,CAAQ,2BAAA;;;;;;;;;EAiBL,YAAA,CAAa,MAAA;IACjB,QAAA;IACA,MAAA;IACA,OAAA;IACA,OAAA,EAAS,mBAAA;EAAA,IACP,OAAA,CAAQ,aAAA;;;;;;;;;;EAuBN,YAAA,CAAa,MAAA,EAAQ,mBAAA,GAAsB,OAAA,CAAQ,aAAA;;;;;;;;EAyBnD,SAAA,CAAU,MAAA;IACd,QAAA;IACA,MAAA;EAAA,IACE,OAAA,CAAQ,aAAA;;;;;;;;;;;;;;;;EAwBN,iBAAA,CACJ,MAAA,EAAQ,mBAAA,GACP,OAAA;IAAU,MAAA,EAAQ,aAAA;IAAe,OAAA;EAAA;;;;;;;EAmC9B,iBAAA,CAAkB,MAAA;IACtB,QAAA;IACA,MAAA;IAEA,iBAAA;EAAA,IACE,OAAA,CAAQ,sBAAA;;EAaN,uBAAA,CAAwB,OAAA,WAAkB,OAAA;IAC9C,KAAA,EAAO,UAAA;IACP,QAAA;EAAA;;;;;;;;;;;;EA8BI,eAAA,CAAgB,MAAA;IACpB,QAAA;EAAA,IACE,OAAA,CAAQ,oBAAA;;;;;;;;;;;;;;EAoBN,cAAA,CAAe,MAAA;IACnB,QAAA;EAAA,IACE,OAAA,CAAQ,mBAAA;;;;;;;;;EAeN,aAAA,CAAc,MAAA;IAClB,QAAA;IACA,MAAA;IACA,OAAA;EAAA,IACE,OAAA;;;;;;;;;EAiBE,YAAA,CAAa,MAAA;IACjB,QAAA;IACA,MAAA;IACA,OAAA;EAAA,IACE,OAAA;;;;;;;;;;;;;;;;;;;;;;;EAmCE,QAAA,CAAS,MAAA,EAAQ,cAAA,GAAiB,OAAA,CAAQ,gBAAA;EAmC1C,kBAAA,CACJ,MAAA,EAAQ,wBAAA,GACP,OAAA,CAAQ,yBAAA;EAwBL,kBAAA,CAAmB,MAAA,EAAQ,wBAAA,GAA2B,OAAA;EAUtD,gBAAA,CACJ,MAAA,EAAQ,sBAAA,GACP,OAAA,CAAQ,uBAAA;EAcL,kBAAA,CAAmB,MAAA;IACvB,QAAA;IACA,MAAA;EAAA,IACE,OAAA,CAAQ,wBAAA;EAQN,cAAA,CAAe,MAAA;IACnB,QAAA;IACA,MAAA;IACA,OAAA;EAAA,IACE,OAAA,CAAQ,qBAAA;AAAA"}

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

@@ -1,8 +1,71 @@
 import "reflect-metadata";
 import { logger, parseInspectorMetadataV1 } from "@copilotkit/shared";
 import { randomUUID as randomUUID$1 } from "crypto";
+import { z } from "zod";
 
 //#region src/v2/runtime/intelligence-platform/client.ts
+const RUNTIME_ENTITLEMENTS_REQUEST_TIMEOUT_MS = 1500;
+const RUNTIME_ENTITLEMENTS_SUCCESS_TTL_MS = 3e4;
+const RUNTIME_ENTITLEMENTS_NEGATIVE_TTL_MS = 5e3;
+/** Whether a response grants Runtime access and therefore cannot be served stale. */
+function grantsRuntimeAccess(response) {
+	return response.status === "ready" && response.entitlement.active;
+}
+/** Whether an HTTP status can recover without changing Runtime configuration. */
+function isRetryableRuntimeEntitlementStatus(status) {
+	return status === 408 || status === 425 || status === 429 || status >= 500;
+}
+const runtimeEntitlementSchema = z.object({
+	active: z.boolean(),
+	source: z.enum(["managedOrgSubscription", "selfHostedDeploymentLicense"]),
+	features: z.record(z.string(), z.boolean()),
+	limits: z.record(z.string(), z.number()),
+	planCode: z.string().optional(),
+	entitlementSource: z.string().optional()
+}).strict();
+const runtimeEntitlementResponseSchema = z.discriminatedUnion("status", [z.object({
+	status: z.literal("ready"),
+	entitlement: runtimeEntitlementSchema
+}).strict(), z.object({
+	status: z.enum([
+		"degraded",
+		"misconfigured",
+		"unavailable"
+	]),
+	error: z.object({
+		code: z.string(),
+		message: z.string(),
+		retryable: z.boolean(),
+		requestId: z.string().optional(),
+		traceId: z.string().optional()
+	}).strict()
+}).strict()]);
+const legacyRuntimeEntitlementTransportSchema = runtimeEntitlementSchema.extend({ organizationId: z.string() });
+/** Check the published App API response union without widening its type. */
+function isPublishedRuntimeEntitlementResponse(value) {
+	return runtimeEntitlementResponseSchema.safeParse(value).success;
+}
+/**
+* Validate the published App API response union, with flat-response support
+* during mixed-version rollouts.
+*/
+function normalizeRuntimeEntitlementTransport(value) {
+	if (isPublishedRuntimeEntitlementResponse(value)) return value;
+	const legacyResponse = legacyRuntimeEntitlementTransportSchema.safeParse(value);
+	if (!legacyResponse.success) return;
+	const transport = legacyResponse.data;
+	return {
+		status: "ready",
+		entitlement: {
+			active: transport.active,
+			source: transport.source,
+			features: transport.features,
+			limits: transport.limits,
+			...transport.planCode !== void 0 ? { planCode: transport.planCode } : {},
+			...transport.entitlementSource !== void 0 ? { entitlementSource: transport.entitlementSource } : {}
+		}
+	};
+}
 /**
 * Header name carrying the per-call end-user identity that the CopilotKit
 * Intelligence `/mcp` endpoint requires. Internal CopilotKit machinery —
@@ -53,12 +116,33 @@ const INSPECTOR_METADATA_REQUEST_TIMEOUT_MS = 5e3;
 * ```
 */
 var PlatformRequestError = class extends Error {
-	constructor(message, status) {
+	constructor(message, status, retryable) {
 		super(message);
 		this.status = status;
+		this.retryable = retryable;
 		this.name = "PlatformRequestError";
 	}
 };
+/** Copy a public Runtime entitlement so callers cannot mutate cached authority. */
+function cloneRuntimeEntitlementResponse(response) {
+	if (response.status === "ready") return {
+		status: "ready",
+		entitlement: {
+			...response.entitlement,
+			features: { ...response.entitlement.features },
+			limits: { ...response.entitlement.limits }
+		}
+	};
+	return {
+		status: response.status,
+		error: { ...response.error }
+	};
+}
+/** Copy a cached Error while preserving its concrete type and own fields. */
+function cloneRuntimeEntitlementError(error) {
+	if (!(error instanceof Error)) return error;
+	return Object.create(Object.getPrototypeOf(error), Object.getOwnPropertyDescriptors(error));
+}
 /**
 * Client for the CopilotKit Intelligence REST API.
 *
@@ -69,7 +153,7 @@ var PlatformRequestError = class extends Error {
 * import { CopilotKitIntelligence, CopilotRuntime } from "@copilotkit/runtime";
 *
 * const intelligence = new CopilotKitIntelligence({
-*   apiKey: process.env.INTELLIGENCE_API_KEY!,
+*   apiKey: process.env.CPK_INTELLIGENCE_API_KEY!,
 * });
 *
 * const runtime = new CopilotRuntime({
@@ -90,7 +174,7 @@ var PlatformRequestError = class extends Error {
 * const intelligence = new CopilotKitIntelligence({
 *   apiUrl: "https://api.intelligence.example.com",
 *   wsUrl: "wss://realtime.intelligence.example.com",
-*   apiKey: process.env.INTELLIGENCE_API_KEY!,
+*   apiKey: process.env.CPK_INTELLIGENCE_API_KEY!,
 * });
 * ```
 */
@@ -101,10 +185,15 @@ var CopilotKitIntelligence = class {
 	#channelsWsUrl;
 	#apiKey;
 	#enterpriseLearningEnabled;
+	#getLearningContainerId;
+	#runtimeEntitlementsCache;
+	#runtimeEntitlementsFailure;
+	#runtimeEntitlementsInFlight;
 	#threadCreatedListeners = /* @__PURE__ */ new Set();
 	#threadUpdatedListeners = /* @__PURE__ */ new Set();
 	#threadDeletedListeners = /* @__PURE__ */ new Set();
 	constructor(config) {
+		if (config.getLearningContainerId !== void 0 && typeof config.getLearningContainerId !== "function") throw new Error("CopilotKitIntelligence `getLearningContainerId` must be a callback");
 		const configuredApiUrl = configuredUrl(config.apiUrl);
 		const configuredWsUrl = configuredUrl(config.wsUrl);
 		warnOnPartialHostOverride(configuredApiUrl, configuredWsUrl);
@@ -115,6 +204,7 @@ var CopilotKitIntelligence = class {
 		this.#channelsWsUrl = deriveChannelsWsUrl(intelligenceWsUrl);
 		this.#apiKey = config.apiKey;
 		this.#enterpriseLearningEnabled = config.enableEnterpriseLearning ?? false;
+		this.#getLearningContainerId = config.getLearningContainerId;
 		if (config.onThreadCreated) this.onThreadCreated(config.onThreadCreated);
 		if (config.onThreadUpdated) this.onThreadUpdated(config.onThreadUpdated);
 		if (config.onThreadDeleted) this.onThreadDeleted(config.onThreadDeleted);
@@ -193,6 +283,10 @@ var CopilotKitIntelligence = class {
 	ɵgetApiKey() {
 		return this.#apiKey;
 	}
+	/** @internal Used by the Intelligence runtime to assign Learning Containers. */
+	ɵgetLearningContainerId() {
+		return this.#getLearningContainerId;
+	}
 	/** @internal Used by `attachIntelligenceEnterpriseLearning` to gate MCP attachment. */
 	ɵisEnterpriseLearningEnabled() {
 		return this.#enterpriseLearningEnabled;
@@ -245,6 +339,79 @@ var CopilotKitIntelligence = class {
 			if (timeoutId !== void 0) clearTimeout(timeoutId);
 		}
 	}
+	/**
+	* Resolve the Runtime entitlement projection for this project.
+	*
+	* Concurrent calls share one request. Active grants cache for 30 seconds;
+	* inactive results and failures cache for 5 seconds. Callers receive copies
+	* so they cannot mutate cached authority.
+	*/
+	async getRuntimeEntitlements() {
+		const now = Date.now();
+		if (this.#runtimeEntitlementsCache && now < this.#runtimeEntitlementsCache.expiresAt) return cloneRuntimeEntitlementResponse(this.#runtimeEntitlementsCache.response);
+		if (this.#runtimeEntitlementsFailure && now < this.#runtimeEntitlementsFailure.expiresAt) throw cloneRuntimeEntitlementError(this.#runtimeEntitlementsFailure.error);
+		const request = this.#runtimeEntitlementsInFlight ?? this.#fetchRuntimeEntitlements().then((response) => {
+			this.#runtimeEntitlementsFailure = void 0;
+			this.#runtimeEntitlementsCache = {
+				response,
+				expiresAt: Date.now() + (grantsRuntimeAccess(response) ? RUNTIME_ENTITLEMENTS_SUCCESS_TTL_MS : RUNTIME_ENTITLEMENTS_NEGATIVE_TTL_MS)
+			};
+			return response;
+		}).catch((error) => {
+			this.#runtimeEntitlementsFailure = {
+				error,
+				expiresAt: Date.now() + RUNTIME_ENTITLEMENTS_NEGATIVE_TTL_MS
+			};
+			throw error;
+		});
+		this.#runtimeEntitlementsInFlight = request;
+		try {
+			return cloneRuntimeEntitlementResponse(await request);
+		} catch (error) {
+			throw cloneRuntimeEntitlementError(error);
+		} finally {
+			if (this.#runtimeEntitlementsInFlight === request) this.#runtimeEntitlementsInFlight = void 0;
+		}
+	}
+	/** Perform one bounded Runtime entitlement request without caching. */
+	async #fetchRuntimeEntitlements() {
+		const path = "/api/entitlements/runtime";
+		const controller = new AbortController();
+		const timeout = setTimeout(() => controller.abort(), RUNTIME_ENTITLEMENTS_REQUEST_TIMEOUT_MS);
+		try {
+			const response = await fetch(`${this.#apiUrl}${path}`, {
+				method: "GET",
+				headers: {
+					Authorization: `Bearer ${this.#apiKey}`,
+					"Content-Type": "application/json"
+				},
+				signal: controller.signal
+			});
+			if (!response.ok) {
+				await response.body?.cancel();
+				logger.error({
+					status: response.status,
+					path
+				}, "Runtime entitlement request failed");
+				throw new PlatformRequestError(`Runtime entitlement request failed with status ${response.status}`, response.status, isRetryableRuntimeEntitlementStatus(response.status));
+			}
+			let payload;
+			try {
+				payload = await response.json();
+			} catch {
+				throw new PlatformRequestError("Runtime entitlement response was malformed", 502, false);
+			}
+			const normalized = normalizeRuntimeEntitlementTransport(payload);
+			if (!normalized) throw new PlatformRequestError("Runtime entitlement response was malformed", 502, false);
+			return normalized;
+		} catch (error) {
+			if (error instanceof PlatformRequestError) throw error;
+			if (controller.signal.aborted || error instanceof DOMException && error.name === "AbortError") throw new PlatformRequestError("Runtime entitlement request timed out", 504, true);
+			throw new PlatformRequestError("Runtime entitlement request failed", 502, true);
+		} finally {
+			clearTimeout(timeout);
+		}
+	}
 	async #request(method, path, body, extraHeaders) {
 		const url = `${this.#apiUrl}${path}`;
 		const headers = {