@copilotkit/runtime 1.83.0 → 2.0.0-rc.0

package/dist/runtime/intelligence-platform/skill-registry/config.d.cts

@@ -0,0 +1,47 @@
+import { CopilotKitIntelligence } from "../client.cjs";
+
+//#region src/runtime/intelligence-platform/skill-registry/config.d.ts
+interface SkillRegistryCommonOptions {
+  client?: CopilotKitIntelligence;
+  apiKey?: string;
+  apiUrl?: string;
+  freshnessWindowMs?: number;
+  requestTimeoutMs?: number;
+  debug?: boolean;
+}
+/** One published container and an optional exact revision pin. */
+interface SkillRegistryContainer {
+  readonly id: string;
+  readonly revision?: string;
+}
+/** Legacy selection and explicit multi-container selection cannot be combined. */
+type SkillRegistryOptions = SkillRegistryCommonOptions & ({
+  containerId?: string;
+  revision?: string;
+  containers?: never;
+} | {
+  containers: readonly SkillRegistryContainer[];
+  containerId?: never;
+  revision?: never;
+});
+interface RegistryCommonConfig {
+  readonly client: CopilotKitIntelligence;
+  readonly freshnessWindowMs: number;
+  readonly requestTimeoutMs: number;
+  readonly debug: boolean;
+}
+type SingleContainerConfig = RegistryCommonConfig & {
+  readonly containerId: string;
+  readonly revision?: string;
+  readonly containers?: never;
+};
+type RegistryConfig = SingleContainerConfig | (RegistryCommonConfig & {
+  readonly containers: readonly SkillRegistryContainer[];
+  readonly containerId?: never;
+  readonly revision?: never;
+});
+/** Resolve once. Never retain the options object, environment, or a second key. */
+declare function resolveRegistryConfig(options?: SkillRegistryOptions, environment?: NodeJS.ProcessEnv): RegistryConfig;
+//#endregion
+export { RegistryConfig, SingleContainerConfig, SkillRegistryCommonOptions, SkillRegistryContainer, SkillRegistryOptions, resolveRegistryConfig };
+//# sourceMappingURL=config.d.cts.map

package/dist/runtime/intelligence-platform/skill-registry/config.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.cts","names":[],"sources":["../../../../src/runtime/intelligence-platform/skill-registry/config.ts"],"mappings":";;;UAGiB,0BAAA;EACf,MAAA,GAAS,sBAAA;EACT,MAAA;EACA,MAAA;EACA,iBAAA;EACA,gBAAA;EACA,KAAA;AAAA;;UAGe,sBAAA;EAAA,SACN,EAAA;EAAA,SACA,QAAA;AAAA;;KAIC,oBAAA,GAAuB,0BAAA;EAE3B,WAAA;EAAsB,QAAA;EAAmB,UAAA;AAAA;EAEzC,UAAA,WAAqB,sBAAA;EACrB,WAAA;EACA,QAAA;AAAA;AAAA,UAIE,oBAAA;EAAA,SACC,MAAA,EAAQ,sBAAA;EAAA,SACR,iBAAA;EAAA,SACA,gBAAA;EAAA,SACA,KAAA;AAAA;AAAA,KAGC,qBAAA,GAAwB,oBAAA;EAAA,SACzB,WAAA;EAAA,SACA,QAAA;EAAA,SACA,UAAA;AAAA;AAAA,KAGC,cAAA,GACR,qBAAA,IACC,oBAAA;EAAA,SACU,UAAA,WAAqB,sBAAA;EAAA,SACrB,WAAA;EAAA,SACA,QAAA;AAAA;;iBAIC,qBAAA,CACd,OAAA,GAAS,oBAAA,EACT,WAAA,GAAa,MAAA,CAAO,UAAA,GACnB,cAAA"}

package/dist/runtime/intelligence-platform/skill-registry/config.d.mts

@@ -0,0 +1,47 @@
+import { CopilotKitIntelligence } from "../client.mjs";
+
+//#region src/runtime/intelligence-platform/skill-registry/config.d.ts
+interface SkillRegistryCommonOptions {
+  client?: CopilotKitIntelligence;
+  apiKey?: string;
+  apiUrl?: string;
+  freshnessWindowMs?: number;
+  requestTimeoutMs?: number;
+  debug?: boolean;
+}
+/** One published container and an optional exact revision pin. */
+interface SkillRegistryContainer {
+  readonly id: string;
+  readonly revision?: string;
+}
+/** Legacy selection and explicit multi-container selection cannot be combined. */
+type SkillRegistryOptions = SkillRegistryCommonOptions & ({
+  containerId?: string;
+  revision?: string;
+  containers?: never;
+} | {
+  containers: readonly SkillRegistryContainer[];
+  containerId?: never;
+  revision?: never;
+});
+interface RegistryCommonConfig {
+  readonly client: CopilotKitIntelligence;
+  readonly freshnessWindowMs: number;
+  readonly requestTimeoutMs: number;
+  readonly debug: boolean;
+}
+type SingleContainerConfig = RegistryCommonConfig & {
+  readonly containerId: string;
+  readonly revision?: string;
+  readonly containers?: never;
+};
+type RegistryConfig = SingleContainerConfig | (RegistryCommonConfig & {
+  readonly containers: readonly SkillRegistryContainer[];
+  readonly containerId?: never;
+  readonly revision?: never;
+});
+/** Resolve once. Never retain the options object, environment, or a second key. */
+declare function resolveRegistryConfig(options?: SkillRegistryOptions, environment?: NodeJS.ProcessEnv): RegistryConfig;
+//#endregion
+export { RegistryConfig, SingleContainerConfig, SkillRegistryCommonOptions, SkillRegistryContainer, SkillRegistryOptions, resolveRegistryConfig };
+//# sourceMappingURL=config.d.mts.map

package/dist/runtime/intelligence-platform/skill-registry/config.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.mts","names":[],"sources":["../../../../src/runtime/intelligence-platform/skill-registry/config.ts"],"mappings":";;;UAGiB,0BAAA;EACf,MAAA,GAAS,sBAAA;EACT,MAAA;EACA,MAAA;EACA,iBAAA;EACA,gBAAA;EACA,KAAA;AAAA;;UAGe,sBAAA;EAAA,SACN,EAAA;EAAA,SACA,QAAA;AAAA;;KAIC,oBAAA,GAAuB,0BAAA;EAE3B,WAAA;EAAsB,QAAA;EAAmB,UAAA;AAAA;EAEzC,UAAA,WAAqB,sBAAA;EACrB,WAAA;EACA,QAAA;AAAA;AAAA,UAIE,oBAAA;EAAA,SACC,MAAA,EAAQ,sBAAA;EAAA,SACR,iBAAA;EAAA,SACA,gBAAA;EAAA,SACA,KAAA;AAAA;AAAA,KAGC,qBAAA,GAAwB,oBAAA;EAAA,SACzB,WAAA;EAAA,SACA,QAAA;EAAA,SACA,UAAA;AAAA;AAAA,KAGC,cAAA,GACR,qBAAA,IACC,oBAAA;EAAA,SACU,UAAA,WAAqB,sBAAA;EAAA,SACrB,WAAA;EAAA,SACA,QAAA;AAAA;;iBAIC,qBAAA,CACd,OAAA,GAAS,oBAAA,EACT,WAAA,GAAa,MAAA,CAAO,UAAA,GACnB,cAAA"}

package/dist/runtime/intelligence-platform/skill-registry/config.mjs

@@ -0,0 +1,65 @@
+import { LearnedSkillsError } from "../learned-skills.mjs";
+import { CopilotKitIntelligence } from "../client.mjs";
+
+//#region src/runtime/intelligence-platform/skill-registry/config.ts
+/** Resolve once. Never retain the options object, environment, or a second key. */
+function resolveRegistryConfig(options = {}, environment = process.env) {
+	try {
+		const multiple = options.containers !== void 0;
+		if (multiple && (options.containerId !== void 0 || options.revision !== void 0)) throw new LearnedSkillsError("INVALID_CONFIG", false);
+		const containerId = multiple ? void 0 : options.containerId ?? environment.CPK_INTELLIGENCE_LEARNING_CONTAINER_ID;
+		const revision = multiple ? void 0 : options.revision ?? environment.CPK_INTELLIGENCE_SKILLS_REVISION;
+		let containers;
+		if (multiple) {
+			if (!Array.isArray(options.containers) || options.containers.length === 0 || options.containers.length > 50) throw new LearnedSkillsError("INVALID_CONFIG", false);
+			const seen = /* @__PURE__ */ new Set();
+			containers = Object.freeze(options.containers.map((source) => {
+				if (!source || typeof source.id !== "string" || !source.id.trim() || /[\u0000-\u001f\u007f]/.test(source.id) || seen.has(source.id) || source.revision !== void 0 && (typeof source.revision !== "string" || !source.revision.trim())) throw new LearnedSkillsError("INVALID_CONFIG", false);
+				encodeURIComponent(source.id);
+				seen.add(source.id);
+				return Object.freeze({
+					id: source.id,
+					...source.revision !== void 0 ? { revision: source.revision } : {}
+				});
+			}));
+		}
+		const freshnessWindowMs = options.freshnessWindowMs ?? 5e3;
+		const requestTimeoutMs = options.requestTimeoutMs ?? 5e3;
+		const debug = options.debug ?? false;
+		if (!multiple && (typeof containerId !== "string" || !containerId.trim()) || revision !== void 0 && (typeof revision !== "string" || revision.length === 0) || !Number.isSafeInteger(freshnessWindowMs) || freshnessWindowMs < 0 || !Number.isSafeInteger(requestTimeoutMs) || requestTimeoutMs < 1 || requestTimeoutMs > 2147483647 || typeof debug !== "boolean") throw new LearnedSkillsError("INVALID_CONFIG", false);
+		let client = options.client;
+		if (client !== void 0) {
+			if (!client || typeof (multiple ? client.getLearnedSkillsSnapshots : client.getLearnedSkillsSnapshot) !== "function") throw new LearnedSkillsError("INVALID_CONFIG", false);
+		} else {
+			const apiKey = options.apiKey ?? environment.CPK_INTELLIGENCE_API_KEY;
+			const apiUrl = options.apiUrl ?? environment.INTELLIGENCE_API_URL;
+			if (typeof apiKey !== "string" || !apiKey.trim()) throw new LearnedSkillsError("INVALID_CONFIG", false);
+			if (apiUrl?.trim()) {
+				const url = new URL(apiUrl);
+				if (!["http:", "https:"].includes(url.protocol) || url.username || url.password || url.search || url.hash) throw new LearnedSkillsError("INVALID_CONFIG", false);
+			}
+			client = new CopilotKitIntelligence({
+				apiKey,
+				...apiUrl !== void 0 ? { apiUrl } : {},
+				...apiUrl?.trim() ? { wsUrl: "wss://realtime.intelligence.copilotkit.ai" } : {}
+			});
+		}
+		return Object.freeze({
+			client,
+			...containers ? { containers } : {
+				containerId,
+				...revision !== void 0 ? { revision } : {}
+			},
+			freshnessWindowMs,
+			requestTimeoutMs,
+			debug
+		});
+	} catch (error) {
+		if (error instanceof LearnedSkillsError) throw error;
+		throw new LearnedSkillsError("INVALID_CONFIG", false, error);
+	}
+}
+
+//#endregion
+export { resolveRegistryConfig };
+//# sourceMappingURL=config.mjs.map

package/dist/runtime/intelligence-platform/skill-registry/config.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.mjs","names":["SkillDeliveryError"],"sources":["../../../../src/runtime/intelligence-platform/skill-registry/config.ts"],"sourcesContent":["import { CopilotKitIntelligence } from \"../client\";\nimport { SkillDeliveryError } from \"./errors\";\n\nexport interface SkillRegistryCommonOptions {\n  client?: CopilotKitIntelligence;\n  apiKey?: string;\n  apiUrl?: string;\n  freshnessWindowMs?: number;\n  requestTimeoutMs?: number;\n  debug?: boolean;\n}\n/** One published container and an optional exact revision pin. */\nexport interface SkillRegistryContainer {\n  readonly id: string;\n  readonly revision?: string;\n}\n\n/** Legacy selection and explicit multi-container selection cannot be combined. */\nexport type SkillRegistryOptions = SkillRegistryCommonOptions &\n  (\n    | { containerId?: string; revision?: string; containers?: never }\n    | {\n        containers: readonly SkillRegistryContainer[];\n        containerId?: never;\n        revision?: never;\n      }\n  );\n\ninterface RegistryCommonConfig {\n  readonly client: CopilotKitIntelligence;\n  readonly freshnessWindowMs: number;\n  readonly requestTimeoutMs: number;\n  readonly debug: boolean;\n}\n\nexport type SingleContainerConfig = RegistryCommonConfig & {\n  readonly containerId: string;\n  readonly revision?: string;\n  readonly containers?: never;\n};\n\nexport type RegistryConfig =\n  | SingleContainerConfig\n  | (RegistryCommonConfig & {\n      readonly containers: readonly SkillRegistryContainer[];\n      readonly containerId?: never;\n      readonly revision?: never;\n    });\n\n/** Resolve once. Never retain the options object, environment, or a second key. */\nexport function resolveRegistryConfig(\n  options: SkillRegistryOptions = {},\n  environment: NodeJS.ProcessEnv = process.env,\n): RegistryConfig {\n  try {\n    const multiple = options.containers !== undefined;\n    if (\n      multiple &&\n      (options.containerId !== undefined || options.revision !== undefined)\n    ) {\n      throw new SkillDeliveryError(\"INVALID_CONFIG\", false);\n    }\n    const containerId = multiple\n      ? undefined\n      : (options.containerId ??\n        environment.CPK_INTELLIGENCE_LEARNING_CONTAINER_ID);\n    const revision = multiple\n      ? undefined\n      : (options.revision ?? environment.CPK_INTELLIGENCE_SKILLS_REVISION);\n    let containers: readonly SkillRegistryContainer[] | undefined;\n    if (multiple) {\n      if (\n        !Array.isArray(options.containers) ||\n        options.containers.length === 0 ||\n        options.containers.length > 50\n      ) {\n        throw new SkillDeliveryError(\"INVALID_CONFIG\", false);\n      }\n      const seen = new Set<string>();\n      containers = Object.freeze(\n        options.containers.map((source) => {\n          if (\n            !source ||\n            typeof source.id !== \"string\" ||\n            !source.id.trim() ||\n            // Reject control characters in caller-provided container IDs.\n            // eslint-disable-next-line no-control-regex\n            /[\\u0000-\\u001f\\u007f]/.test(source.id) ||\n            seen.has(source.id) ||\n            (source.revision !== undefined &&\n              (typeof source.revision !== \"string\" || !source.revision.trim()))\n          ) {\n            throw new SkillDeliveryError(\"INVALID_CONFIG\", false);\n          }\n          // Reject malformed Unicode before constructing a qualified tool name.\n          encodeURIComponent(source.id);\n          seen.add(source.id);\n          return Object.freeze({\n            id: source.id,\n            ...(source.revision !== undefined\n              ? { revision: source.revision }\n              : {}),\n          });\n        }),\n      );\n    }\n    const freshnessWindowMs = options.freshnessWindowMs ?? 5_000;\n    const requestTimeoutMs = options.requestTimeoutMs ?? 5_000;\n    const debug = options.debug ?? false;\n    if (\n      (!multiple && (typeof containerId !== \"string\" || !containerId.trim())) ||\n      (revision !== undefined &&\n        (typeof revision !== \"string\" || revision.length === 0)) ||\n      !Number.isSafeInteger(freshnessWindowMs) ||\n      freshnessWindowMs < 0 ||\n      !Number.isSafeInteger(requestTimeoutMs) ||\n      requestTimeoutMs < 1 ||\n      requestTimeoutMs > 2_147_483_647 ||\n      typeof debug !== \"boolean\"\n    )\n      throw new SkillDeliveryError(\"INVALID_CONFIG\", false);\n    let client = options.client;\n    if (client !== undefined) {\n      if (\n        !client ||\n        typeof (multiple\n          ? client.getLearnedSkillsSnapshots\n          : client.getLearnedSkillsSnapshot) !== \"function\"\n      )\n        throw new SkillDeliveryError(\"INVALID_CONFIG\", false);\n    } else {\n      const apiKey = options.apiKey ?? environment.CPK_INTELLIGENCE_API_KEY;\n      const apiUrl = options.apiUrl ?? environment.INTELLIGENCE_API_URL;\n      if (typeof apiKey !== \"string\" || !apiKey.trim())\n        throw new SkillDeliveryError(\"INVALID_CONFIG\", false);\n      if (apiUrl?.trim()) {\n        const url = new URL(apiUrl);\n        if (\n          ![\"http:\", \"https:\"].includes(url.protocol) ||\n          url.username ||\n          url.password ||\n          url.search ||\n          url.hash\n        )\n          throw new SkillDeliveryError(\"INVALID_CONFIG\", false);\n      }\n      client = new CopilotKitIntelligence({\n        apiKey,\n        ...(apiUrl !== undefined ? { apiUrl } : {}),\n        // This private helper client uses REST only. Explicitly retain the\n        // canonical websocket default to prevent an irrelevant host warning.\n        ...(apiUrl?.trim()\n          ? { wsUrl: \"wss://realtime.intelligence.copilotkit.ai\" }\n          : {}),\n      });\n    }\n    return Object.freeze({\n      client,\n      ...(containers\n        ? { containers }\n        : {\n            containerId: containerId!,\n            ...(revision !== undefined ? { revision } : {}),\n          }),\n      freshnessWindowMs,\n      requestTimeoutMs,\n      debug,\n    });\n  } catch (error) {\n    if (error instanceof SkillDeliveryError) throw error;\n    throw new SkillDeliveryError(\"INVALID_CONFIG\", false, error);\n  }\n}\n"],"mappings":";;;;;AAkDA,SAAgB,sBACd,UAAgC,EAAE,EAClC,cAAiC,QAAQ,KACzB;AAChB,KAAI;EACF,MAAM,WAAW,QAAQ,eAAe;AACxC,MACE,aACC,QAAQ,gBAAgB,UAAa,QAAQ,aAAa,QAE3D,OAAM,IAAIA,mBAAmB,kBAAkB,MAAM;EAEvD,MAAM,cAAc,WAChB,SACC,QAAQ,eACT,YAAY;EAChB,MAAM,WAAW,WACb,SACC,QAAQ,YAAY,YAAY;EACrC,IAAI;AACJ,MAAI,UAAU;AACZ,OACE,CAAC,MAAM,QAAQ,QAAQ,WAAW,IAClC,QAAQ,WAAW,WAAW,KAC9B,QAAQ,WAAW,SAAS,GAE5B,OAAM,IAAIA,mBAAmB,kBAAkB,MAAM;GAEvD,MAAM,uBAAO,IAAI,KAAa;AAC9B,gBAAa,OAAO,OAClB,QAAQ,WAAW,KAAK,WAAW;AACjC,QACE,CAAC,UACD,OAAO,OAAO,OAAO,YACrB,CAAC,OAAO,GAAG,MAAM,IAGjB,wBAAwB,KAAK,OAAO,GAAG,IACvC,KAAK,IAAI,OAAO,GAAG,IAClB,OAAO,aAAa,WAClB,OAAO,OAAO,aAAa,YAAY,CAAC,OAAO,SAAS,MAAM,EAEjE,OAAM,IAAIA,mBAAmB,kBAAkB,MAAM;AAGvD,uBAAmB,OAAO,GAAG;AAC7B,SAAK,IAAI,OAAO,GAAG;AACnB,WAAO,OAAO,OAAO;KACnB,IAAI,OAAO;KACX,GAAI,OAAO,aAAa,SACpB,EAAE,UAAU,OAAO,UAAU,GAC7B,EAAE;KACP,CAAC;KACF,CACH;;EAEH,MAAM,oBAAoB,QAAQ,qBAAqB;EACvD,MAAM,mBAAmB,QAAQ,oBAAoB;EACrD,MAAM,QAAQ,QAAQ,SAAS;AAC/B,MACG,CAAC,aAAa,OAAO,gBAAgB,YAAY,CAAC,YAAY,MAAM,KACpE,aAAa,WACX,OAAO,aAAa,YAAY,SAAS,WAAW,MACvD,CAAC,OAAO,cAAc,kBAAkB,IACxC,oBAAoB,KACpB,CAAC,OAAO,cAAc,iBAAiB,IACvC,mBAAmB,KACnB,mBAAmB,cACnB,OAAO,UAAU,UAEjB,OAAM,IAAIA,mBAAmB,kBAAkB,MAAM;EACvD,IAAI,SAAS,QAAQ;AACrB,MAAI,WAAW,QACb;OACE,CAAC,UACD,QAAQ,WACJ,OAAO,4BACP,OAAO,8BAA8B,WAEzC,OAAM,IAAIA,mBAAmB,kBAAkB,MAAM;SAClD;GACL,MAAM,SAAS,QAAQ,UAAU,YAAY;GAC7C,MAAM,SAAS,QAAQ,UAAU,YAAY;AAC7C,OAAI,OAAO,WAAW,YAAY,CAAC,OAAO,MAAM,CAC9C,OAAM,IAAIA,mBAAmB,kBAAkB,MAAM;AACvD,OAAI,QAAQ,MAAM,EAAE;IAClB,MAAM,MAAM,IAAI,IAAI,OAAO;AAC3B,QACE,CAAC,CAAC,SAAS,SAAS,CAAC,SAAS,IAAI,SAAS,IAC3C,IAAI,YACJ,IAAI,YACJ,IAAI,UACJ,IAAI,KAEJ,OAAM,IAAIA,mBAAmB,kBAAkB,MAAM;;AAEzD,YAAS,IAAI,uBAAuB;IAClC;IACA,GAAI,WAAW,SAAY,EAAE,QAAQ,GAAG,EAAE;IAG1C,GAAI,QAAQ,MAAM,GACd,EAAE,OAAO,6CAA6C,GACtD,EAAE;IACP,CAAC;;AAEJ,SAAO,OAAO,OAAO;GACnB;GACA,GAAI,aACA,EAAE,YAAY,GACd;IACe;IACb,GAAI,aAAa,SAAY,EAAE,UAAU,GAAG,EAAE;IAC/C;GACL;GACA;GACA;GACD,CAAC;UACK,OAAO;AACd,MAAI,iBAAiBA,mBAAoB,OAAM;AAC/C,QAAM,IAAIA,mBAAmB,kBAAkB,OAAO,MAAM"}

package/dist/runtime/intelligence-platform/skill-registry/errors.cjs

@@ -0,0 +1,10 @@
+const require_learned_skills = require('../learned-skills.cjs');
+
+//#region src/runtime/intelligence-platform/skill-registry/errors.ts
+function invalidSnapshot(cause) {
+	return new require_learned_skills.LearnedSkillsError("INVALID_SNAPSHOT", false, cause);
+}
+
+//#endregion
+exports.invalidSnapshot = invalidSnapshot;
+//# sourceMappingURL=errors.cjs.map

package/dist/runtime/intelligence-platform/skill-registry/errors.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.cjs","names":["LearnedSkillsError"],"sources":["../../../../src/runtime/intelligence-platform/skill-registry/errors.ts"],"sourcesContent":["import { LearnedSkillsError } from \"../learned-skills\";\n\n// Reuse the canonical delivery error identity across transport and adapter code.\nexport { LearnedSkillsError as SkillDeliveryError } from \"../learned-skills\";\nexport type { LearnedSkillsErrorCode as SkillDeliveryErrorCode } from \"../learned-skills\";\n\nexport function invalidSnapshot(cause?: unknown): LearnedSkillsError {\n  return new LearnedSkillsError(\"INVALID_SNAPSHOT\", false, cause);\n}\n"],"mappings":";;;AAMA,SAAgB,gBAAgB,OAAqC;AACnE,QAAO,IAAIA,0CAAmB,oBAAoB,OAAO,MAAM"}

package/dist/runtime/intelligence-platform/skill-registry/errors.d.cts

@@ -0,0 +1,7 @@
+import { LearnedSkillsError, LearnedSkillsErrorCode } from "../learned-skills.cjs";
+
+//#region src/runtime/intelligence-platform/skill-registry/errors.d.ts
+declare function invalidSnapshot(cause?: unknown): LearnedSkillsError;
+//#endregion
+export { invalidSnapshot };
+//# sourceMappingURL=errors.d.cts.map

package/dist/runtime/intelligence-platform/skill-registry/errors.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.cts","names":[],"sources":["../../../../src/runtime/intelligence-platform/skill-registry/errors.ts"],"mappings":";;;iBAMgB,eAAA,CAAgB,KAAA,aAAkB,kBAAA"}

package/dist/runtime/intelligence-platform/skill-registry/errors.d.mts

@@ -0,0 +1,7 @@
+import { LearnedSkillsError, LearnedSkillsErrorCode } from "../learned-skills.mjs";
+
+//#region src/runtime/intelligence-platform/skill-registry/errors.d.ts
+declare function invalidSnapshot(cause?: unknown): LearnedSkillsError;
+//#endregion
+export { invalidSnapshot };
+//# sourceMappingURL=errors.d.mts.map

package/dist/runtime/intelligence-platform/skill-registry/errors.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.mts","names":[],"sources":["../../../../src/runtime/intelligence-platform/skill-registry/errors.ts"],"mappings":";;;iBAMgB,eAAA,CAAgB,KAAA,aAAkB,kBAAA"}

package/dist/runtime/intelligence-platform/skill-registry/errors.mjs

@@ -0,0 +1,10 @@
+import { LearnedSkillsError } from "../learned-skills.mjs";
+
+//#region src/runtime/intelligence-platform/skill-registry/errors.ts
+function invalidSnapshot(cause) {
+	return new LearnedSkillsError("INVALID_SNAPSHOT", false, cause);
+}
+
+//#endregion
+export { invalidSnapshot };
+//# sourceMappingURL=errors.mjs.map

package/dist/runtime/intelligence-platform/skill-registry/errors.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.mjs","names":[],"sources":["../../../../src/runtime/intelligence-platform/skill-registry/errors.ts"],"sourcesContent":["import { LearnedSkillsError } from \"../learned-skills\";\n\n// Reuse the canonical delivery error identity across transport and adapter code.\nexport { LearnedSkillsError as SkillDeliveryError } from \"../learned-skills\";\nexport type { LearnedSkillsErrorCode as SkillDeliveryErrorCode } from \"../learned-skills\";\n\nexport function invalidSnapshot(cause?: unknown): LearnedSkillsError {\n  return new LearnedSkillsError(\"INVALID_SNAPSHOT\", false, cause);\n}\n"],"mappings":";;;AAMA,SAAgB,gBAAgB,OAAqC;AACnE,QAAO,IAAI,mBAAmB,oBAAoB,OAAO,MAAM"}

package/dist/runtime/intelligence-platform/skill-registry/index.d.cts

@@ -0,0 +1,7 @@
+import { LearnedSkillsError, LearnedSkillsErrorCode } from "../learned-skills.cjs";
+import { MAX_ARCHIVE_ENTRIES, MAX_SNAPSHOT_BYTES, readArchive, safeRelativePath } from "./archive.cjs";
+import { RegistryConfig, SingleContainerConfig, SkillRegistryCommonOptions, SkillRegistryContainer, SkillRegistryOptions, resolveRegistryConfig } from "./config.cjs";
+import { invalidSnapshot } from "./errors.cjs";
+import { SnapshotFile, SnapshotSkill, VerifiedSnapshot, validateSnapshot } from "./snapshot.cjs";
+import { SkillRegistry, SkillRegistryStatus } from "./registry.cjs";
+import { formatSkillCatalog, loadSkill, readSkillFile } from "./skill-content.cjs";

package/dist/runtime/intelligence-platform/skill-registry/index.d.mts

@@ -0,0 +1,7 @@
+import { LearnedSkillsError, LearnedSkillsErrorCode } from "../learned-skills.mjs";
+import { MAX_ARCHIVE_ENTRIES, MAX_SNAPSHOT_BYTES, readArchive, safeRelativePath } from "./archive.mjs";
+import { RegistryConfig, SingleContainerConfig, SkillRegistryCommonOptions, SkillRegistryContainer, SkillRegistryOptions, resolveRegistryConfig } from "./config.mjs";
+import { invalidSnapshot } from "./errors.mjs";
+import { SnapshotFile, SnapshotSkill, VerifiedSnapshot, validateSnapshot } from "./snapshot.mjs";
+import { SkillRegistry, SkillRegistryStatus } from "./registry.mjs";
+import { formatSkillCatalog, loadSkill, readSkillFile } from "./skill-content.mjs";

package/dist/runtime/intelligence-platform/skill-registry/registry.cjs

@@ -0,0 +1,247 @@
+const require_runtime = require('../../../_virtual/_rolldown/runtime.cjs');
+const require_learned_skills = require('../learned-skills.cjs');
+const require_errors = require('./errors.cjs');
+const require_config = require('./config.cjs');
+const require_snapshot = require('./snapshot.cjs');
+let node_crypto = require("node:crypto");
+
+//#region src/runtime/intelligence-platform/skill-registry/registry.ts
+function transient(error) {
+	return [
+		"NETWORK_ERROR",
+		"TIMEOUT",
+		"INVALID_SNAPSHOT",
+		"UNSUPPORTED_SERVER"
+	].includes(error.code);
+}
+function deliveryError(error) {
+	if (error instanceof require_learned_skills.LearnedSkillsError) return error;
+	return new require_learned_skills.LearnedSkillsError(error instanceof Error && error.name === "TimeoutError" ? "TIMEOUT" : "NETWORK_ERROR", true, error);
+}
+/** Internal registry shared by framework adapters; public API is framework-native. */
+var SingleContainerRegistry = class {
+	#config;
+	#snapshot;
+	#inFlight;
+	#lastCheckedAt;
+	#stale = false;
+	#lastError;
+	#blocked;
+	constructor(config, fetchSnapshot = (request) => config.client.getLearnedSkillsSnapshot(request)) {
+		this.fetchSnapshot = fetchSnapshot;
+		this.#config = config;
+	}
+	async initialize() {
+		await this.acquireSnapshot();
+	}
+	/** Capture exactly one immutable snapshot before model work begins. */
+	acquireSnapshot() {
+		if (this.#inFlight) return this.#inFlight;
+		if (this.#snapshot && !this.#blocked && this.#lastCheckedAt !== void 0 && Date.now() - this.#lastCheckedAt < this.#config.freshnessWindowMs) return Promise.resolve(this.#snapshot);
+		this.#inFlight = Promise.resolve().then(() => this.#refresh()).finally(() => {
+			this.#inFlight = void 0;
+		});
+		return this.#inFlight;
+	}
+	get status() {
+		const error = this.#lastError;
+		return Object.freeze({
+			initialized: this.#snapshot !== void 0,
+			...this.#snapshot ? { revision: this.#snapshot.revision } : {},
+			mode: this.#config.revision === void 0 ? "latest" : "pinned",
+			...this.#lastCheckedAt !== void 0 ? { lastCheckedAt: new Date(this.#lastCheckedAt).toISOString() } : {},
+			stale: this.#stale,
+			...error ? { lastError: Object.freeze({
+				code: error.code,
+				message: error.message,
+				retryable: error.retryable
+			}) } : {}
+		});
+	}
+	async #refresh() {
+		const startedAt = Date.now();
+		const controller = new AbortController();
+		let timer;
+		const deadline = new Promise((_, reject) => {
+			timer = setTimeout(() => {
+				const error = new require_learned_skills.LearnedSkillsError("TIMEOUT", true);
+				controller.abort(error);
+				timer = setTimeout(() => reject(error), 0);
+			}, this.#config.requestTimeoutMs);
+		});
+		const replacement = async () => {
+			const response = await this.fetchSnapshot({
+				containerId: this.#config.containerId,
+				...this.#config.revision !== void 0 ? { revision: this.#config.revision } : {},
+				...this.#snapshot ? { ifNoneMatch: this.#snapshot.etag } : {},
+				signal: controller.signal
+			});
+			controller.signal.throwIfAborted();
+			if (!response || typeof response !== "object") throw require_errors.invalidSnapshot();
+			if (response.status === "unchanged") {
+				if (!this.#snapshot || response.etag !== this.#snapshot.etag || response.revision !== this.#snapshot.revision) throw require_errors.invalidSnapshot();
+				return this.#snapshot;
+			}
+			if (this.#config.revision !== void 0 && response.revision !== this.#config.revision) throw require_errors.invalidSnapshot();
+			return require_snapshot.validateSnapshot(response, controller.signal);
+		};
+		try {
+			const snapshot = await Promise.race([replacement(), deadline]);
+			this.#snapshot = snapshot;
+			this.#lastCheckedAt = Date.now();
+			this.#stale = false;
+			this.#lastError = void 0;
+			this.#blocked = void 0;
+			this.#debug("refresh-success", startedAt);
+			return snapshot;
+		} catch (cause) {
+			const error = deliveryError(cause);
+			if (!transient(error)) {
+				this.#blocked = error;
+				this.#stale = false;
+				this.#lastError = error;
+				this.#debug("refresh-denied", startedAt, error.code);
+				throw error;
+			}
+			if (this.#blocked) {
+				this.#lastError = this.#blocked;
+				this.#debug("refresh-failed", startedAt, error.code);
+				throw this.#blocked;
+			}
+			this.#lastError = error;
+			this.#stale = this.#snapshot !== void 0;
+			this.#debug("refresh-failed", startedAt, error.code);
+			if (this.#snapshot) return this.#snapshot;
+			throw error;
+		} finally {
+			if (timer !== void 0) clearTimeout(timer);
+		}
+	}
+	#debug(event, startedAt, errorCode) {
+		if (!this.#config.debug) return;
+		console.debug("CopilotKit learned skills", {
+			event,
+			containerId: this.#config.containerId,
+			revision: this.#snapshot?.revision,
+			durationMs: Date.now() - startedAt,
+			...errorCode ? { errorCode } : {}
+		});
+	}
+};
+/** Coalesce refreshes from this registry into one request in the next microtask. */
+function batchLoader(client) {
+	let pending = [];
+	return (request) => new Promise((resolve, reject) => {
+		pending.push({
+			request,
+			resolve,
+			reject
+		});
+		if (pending.length !== 1) return;
+		queueMicrotask(async () => {
+			const batch = pending;
+			pending = [];
+			try {
+				const results = await client.getLearnedSkillsSnapshots({
+					containers: batch.map(({ request: { signal: _signal, ...source } }) => source),
+					signal: batch[0].request.signal
+				});
+				if (!Array.isArray(results) || results.length !== batch.length || results.some((result, index) => result?.containerId !== batch[index].request.containerId)) throw require_errors.invalidSnapshot();
+				for (let index = 0; index < batch.length; index++) {
+					const result = results[index];
+					if (result.status === "error") batch[index].reject(result.error);
+					else batch[index].resolve(result);
+				}
+			} catch (error) {
+				for (const item of batch) item.reject(error);
+			}
+		});
+	});
+}
+/** Compose independent container caches into one immutable invocation snapshot. */
+var SkillRegistry = class {
+	#sources;
+	#multiple;
+	#snapshot;
+	#parts;
+	#inFlight;
+	constructor(options = {}) {
+		const config = require_config.resolveRegistryConfig(options);
+		this.#multiple = config.containers !== void 0;
+		const fetchBatch = batchLoader(config.client);
+		this.#sources = config.containers !== void 0 ? config.containers.map(({ id, revision }) => ({
+			id,
+			registry: new SingleContainerRegistry(Object.freeze({
+				client: config.client,
+				freshnessWindowMs: config.freshnessWindowMs,
+				requestTimeoutMs: config.requestTimeoutMs,
+				debug: config.debug,
+				containerId: id,
+				...revision !== void 0 ? { revision } : {}
+			}), fetchBatch)
+		})) : [{
+			id: config.containerId,
+			registry: new SingleContainerRegistry({
+				client: config.client,
+				containerId: config.containerId,
+				revision: config.revision,
+				freshnessWindowMs: config.freshnessWindowMs,
+				requestTimeoutMs: config.requestTimeoutMs,
+				debug: config.debug
+			})
+		}];
+	}
+	/** Load every configured container before agent initialization completes. */
+	async initialize() {
+		await this.acquireSnapshot();
+	}
+	/** Capture every container once; a failed source cannot yield a partial catalog. */
+	acquireSnapshot() {
+		if (!this.#multiple) return this.#sources[0].registry.acquireSnapshot();
+		if (this.#inFlight) return this.#inFlight;
+		this.#inFlight = Promise.all(this.#sources.map(({ registry }) => registry.acquireSnapshot())).then((parts) => {
+			if (this.#snapshot && parts.every((part, index) => part === this.#parts?.[index])) return this.#snapshot;
+			const identity = (0, node_crypto.createHash)("sha256").update(JSON.stringify(parts.map((part, index) => [
+				this.#sources[index].id,
+				part.revision,
+				part.etag
+			]))).digest("hex");
+			const skills = Object.freeze(parts.flatMap((part, index) => part.skills.map((skill) => Object.freeze({
+				...skill,
+				name: `${encodeURIComponent(this.#sources[index].id)}/${skill.name}`
+			}))));
+			this.#parts = parts;
+			this.#snapshot = Object.freeze({
+				revision: `multi:${identity}`,
+				etag: `"${identity}"`,
+				skills
+			});
+			return this.#snapshot;
+		}).finally(() => {
+			this.#inFlight = void 0;
+		});
+		return this.#inFlight;
+	}
+	/** Report each container's real revision; no aggregate server revision exists. */
+	get status() {
+		if (!this.#multiple) return this.#sources[0].registry.status;
+		const containers = Object.freeze(this.#sources.map(({ id, registry }) => Object.freeze({
+			id,
+			...registry.status
+		})));
+		const error = containers.find((source) => source.lastError && !source.lastError.retryable)?.lastError ?? containers.find((source) => source.lastError)?.lastError;
+		const timestamps = containers.map((source) => source.lastCheckedAt);
+		return Object.freeze({
+			initialized: this.#snapshot !== void 0,
+			mode: containers.every((source) => source.mode === "pinned") ? "pinned" : "latest",
+			stale: containers.some((source) => source.stale),
+			...timestamps.every((timestamp) => timestamp !== void 0) ? { lastCheckedAt: [...timestamps].sort()[0] } : {},
+			...error ? { lastError: error } : {},
+			containers
+		});
+	}
+};
+
+//#endregion
+exports.SkillRegistry = SkillRegistry;
+//# sourceMappingURL=registry.cjs.map

package/dist/runtime/intelligence-platform/skill-registry/registry.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.cjs","names":["SkillDeliveryError","#config","#inFlight","#snapshot","#blocked","#lastCheckedAt","#refresh","#lastError","#stale","invalidSnapshot","validateSnapshot","#debug","#sources","#multiple","resolveRegistryConfig","#parts"],"sources":["../../../../src/runtime/intelligence-platform/skill-registry/registry.ts"],"sourcesContent":["import type { CopilotKitIntelligence } from \"../client\";\nimport type {\n  GetLearnedSkillsSnapshotRequest,\n  LearnedSkillsSnapshotResult,\n} from \"../learned-skills\";\nimport { createHash } from \"node:crypto\";\nimport { resolveRegistryConfig } from \"./config\";\nimport type { SingleContainerConfig, SkillRegistryOptions } from \"./config\";\nimport { SkillDeliveryError, invalidSnapshot } from \"./errors\";\nimport type { SkillDeliveryErrorCode } from \"./errors\";\nimport { validateSnapshot } from \"./snapshot\";\nimport type { VerifiedSnapshot } from \"./snapshot\";\n\nexport interface SkillRegistryStatus {\n  /** Present only for the explicit containers interface. */\n  readonly containers?: readonly (SkillRegistryStatus & {\n    readonly id: string;\n  })[];\n  readonly initialized: boolean;\n  readonly revision?: string;\n  readonly mode: \"latest\" | \"pinned\";\n  /** ISO 8601 timestamp of the last successful 200 or matching 304 check. */\n  readonly lastCheckedAt?: string;\n  readonly stale: boolean;\n  readonly lastError?: Readonly<{\n    code: SkillDeliveryErrorCode;\n    message: string;\n    retryable: boolean;\n  }>;\n}\n\nfunction transient(error: SkillDeliveryError): boolean {\n  return [\n    \"NETWORK_ERROR\",\n    \"TIMEOUT\",\n    \"INVALID_SNAPSHOT\",\n    \"UNSUPPORTED_SERVER\",\n  ].includes(error.code);\n}\nfunction deliveryError(error: unknown): SkillDeliveryError {\n  if (error instanceof SkillDeliveryError) return error;\n  return new SkillDeliveryError(\n    error instanceof Error && error.name === \"TimeoutError\"\n      ? \"TIMEOUT\"\n      : \"NETWORK_ERROR\",\n    true,\n    error,\n  );\n}\n\n/** Internal registry shared by framework adapters; public API is framework-native. */\nclass SingleContainerRegistry {\n  readonly #config: SingleContainerConfig;\n  #snapshot?: VerifiedSnapshot;\n  #inFlight?: Promise<VerifiedSnapshot>;\n  #lastCheckedAt?: number;\n  #stale = false;\n  #lastError?: SkillDeliveryError;\n  #blocked?: SkillDeliveryError;\n\n  constructor(\n    config: SingleContainerConfig,\n    private readonly fetchSnapshot = (\n      request: GetLearnedSkillsSnapshotRequest,\n    ) => config.client.getLearnedSkillsSnapshot(request),\n  ) {\n    this.#config = config;\n  }\n\n  async initialize(): Promise<void> {\n    await this.acquireSnapshot();\n  }\n\n  /** Capture exactly one immutable snapshot before model work begins. */\n  acquireSnapshot(): Promise<VerifiedSnapshot> {\n    if (this.#inFlight) return this.#inFlight;\n    if (\n      this.#snapshot &&\n      !this.#blocked &&\n      this.#lastCheckedAt !== undefined &&\n      Date.now() - this.#lastCheckedAt < this.#config.freshnessWindowMs\n    ) {\n      return Promise.resolve(this.#snapshot);\n    }\n    // Defer work one microtask so reentrant and concurrent callers observe the\n    // same promise before an injected client can start its request.\n    this.#inFlight = Promise.resolve()\n      .then(() => this.#refresh())\n      .finally(() => {\n        this.#inFlight = undefined;\n      });\n    return this.#inFlight;\n  }\n\n  get status(): SkillRegistryStatus {\n    const error = this.#lastError;\n    return Object.freeze({\n      initialized: this.#snapshot !== undefined,\n      ...(this.#snapshot ? { revision: this.#snapshot.revision } : {}),\n      mode: this.#config.revision === undefined ? \"latest\" : \"pinned\",\n      ...(this.#lastCheckedAt !== undefined\n        ? { lastCheckedAt: new Date(this.#lastCheckedAt).toISOString() }\n        : {}),\n      stale: this.#stale,\n      ...(error\n        ? {\n            lastError: Object.freeze({\n              code: error.code,\n              message: error.message,\n              retryable: error.retryable,\n            }),\n          }\n        : {}),\n    });\n  }\n\n  async #refresh(): Promise<VerifiedSnapshot> {\n    const startedAt = Date.now();\n    const controller = new AbortController();\n    let timer: ReturnType<typeof setTimeout> | undefined;\n    const deadline = new Promise<never>((_, reject) => {\n      timer = setTimeout(() => {\n        const error = new SkillDeliveryError(\"TIMEOUT\", true);\n        controller.abort(error);\n        // Give a canonical client that already received denial headers one\n        // event-loop turn to report that denial before the watchdog wins.\n        timer = setTimeout(() => reject(error), 0);\n      }, this.#config.requestTimeoutMs);\n    });\n    const replacement = async (): Promise<VerifiedSnapshot> => {\n      const response = await this.fetchSnapshot({\n        containerId: this.#config.containerId,\n        ...(this.#config.revision !== undefined\n          ? { revision: this.#config.revision }\n          : {}),\n        ...(this.#snapshot ? { ifNoneMatch: this.#snapshot.etag } : {}),\n        signal: controller.signal,\n      });\n      controller.signal.throwIfAborted();\n      if (!response || typeof response !== \"object\") throw invalidSnapshot();\n      if (response.status === \"unchanged\") {\n        if (\n          !this.#snapshot ||\n          response.etag !== this.#snapshot.etag ||\n          response.revision !== this.#snapshot.revision\n        )\n          throw invalidSnapshot();\n        return this.#snapshot;\n      }\n      if (\n        this.#config.revision !== undefined &&\n        response.revision !== this.#config.revision\n      )\n        throw invalidSnapshot();\n      return validateSnapshot(response, controller.signal);\n    };\n    try {\n      const snapshot = await Promise.race([replacement(), deadline]);\n      // An abandoned parse never writes registry state: only the winning\n      // complete replacement reaches this assignment.\n      this.#snapshot = snapshot;\n      this.#lastCheckedAt = Date.now();\n      this.#stale = false;\n      this.#lastError = undefined;\n      this.#blocked = undefined;\n      this.#debug(\"refresh-success\", startedAt);\n      return snapshot;\n    } catch (cause) {\n      const error = deliveryError(cause);\n      if (!transient(error)) {\n        this.#blocked = error;\n        this.#stale = false;\n        this.#lastError = error;\n        this.#debug(\"refresh-denied\", startedAt, error.code);\n        throw error;\n      }\n      // A later unreachable server cannot undo an already confirmed denial.\n      if (this.#blocked) {\n        this.#lastError = this.#blocked;\n        this.#debug(\"refresh-failed\", startedAt, error.code);\n        throw this.#blocked;\n      }\n      this.#lastError = error;\n      this.#stale = this.#snapshot !== undefined;\n      this.#debug(\"refresh-failed\", startedAt, error.code);\n      if (this.#snapshot) return this.#snapshot;\n      throw error;\n    } finally {\n      if (timer !== undefined) clearTimeout(timer);\n    }\n  }\n\n  #debug(\n    event: string,\n    startedAt: number,\n    errorCode?: SkillDeliveryErrorCode,\n  ): void {\n    if (!this.#config.debug) return;\n    console.debug(\"CopilotKit learned skills\", {\n      event,\n      containerId: this.#config.containerId,\n      revision: this.#snapshot?.revision,\n      durationMs: Date.now() - startedAt,\n      ...(errorCode ? { errorCode } : {}),\n    });\n  }\n}\n\n/** Coalesce refreshes from this registry into one request in the next microtask. */\nfunction batchLoader(client: CopilotKitIntelligence) {\n  let pending: {\n    request: GetLearnedSkillsSnapshotRequest;\n    resolve: (value: LearnedSkillsSnapshotResult) => void;\n    reject: (error: unknown) => void;\n  }[] = [];\n  return (\n    request: GetLearnedSkillsSnapshotRequest,\n  ): Promise<LearnedSkillsSnapshotResult> =>\n    new Promise((resolve, reject) => {\n      pending.push({ request, resolve, reject });\n      if (pending.length !== 1) return;\n      queueMicrotask(async () => {\n        const batch = pending;\n        pending = [];\n        try {\n          const results = await client.getLearnedSkillsSnapshots({\n            containers: batch.map(\n              ({ request: { signal: _signal, ...source } }) => source,\n            ),\n            signal: batch[0].request.signal,\n          });\n          if (\n            !Array.isArray(results) ||\n            results.length !== batch.length ||\n            results.some(\n              (result, index) =>\n                result?.containerId !== batch[index].request.containerId,\n            )\n          )\n            throw invalidSnapshot();\n          for (let index = 0; index < batch.length; index++) {\n            const result = results[index];\n            if (result.status === \"error\") batch[index].reject(result.error);\n            else batch[index].resolve(result);\n          }\n        } catch (error) {\n          for (const item of batch) item.reject(error);\n        }\n      });\n    });\n}\n\n/** Compose independent container caches into one immutable invocation snapshot. */\nexport class SkillRegistry {\n  readonly #sources: readonly {\n    readonly id: string;\n    readonly registry: SingleContainerRegistry;\n  }[];\n  readonly #multiple: boolean;\n  #snapshot?: VerifiedSnapshot;\n  #parts?: readonly VerifiedSnapshot[];\n  #inFlight?: Promise<VerifiedSnapshot>;\n\n  constructor(options: SkillRegistryOptions = {}) {\n    const config = resolveRegistryConfig(options);\n    this.#multiple = config.containers !== undefined;\n    const fetchBatch = batchLoader(config.client);\n    this.#sources =\n      config.containers !== undefined\n        ? config.containers.map(({ id, revision }) => ({\n            id,\n            registry: new SingleContainerRegistry(\n              Object.freeze({\n                client: config.client,\n                freshnessWindowMs: config.freshnessWindowMs,\n                requestTimeoutMs: config.requestTimeoutMs,\n                debug: config.debug,\n                containerId: id,\n                ...(revision !== undefined ? { revision } : {}),\n              }),\n              fetchBatch,\n            ),\n          }))\n        : [\n            {\n              id: config.containerId!,\n              registry: new SingleContainerRegistry({\n                client: config.client,\n                containerId: config.containerId!,\n                revision: config.revision,\n                freshnessWindowMs: config.freshnessWindowMs,\n                requestTimeoutMs: config.requestTimeoutMs,\n                debug: config.debug,\n              }),\n            },\n          ];\n  }\n\n  /** Load every configured container before agent initialization completes. */\n  async initialize(): Promise<void> {\n    await this.acquireSnapshot();\n  }\n\n  /** Capture every container once; a failed source cannot yield a partial catalog. */\n  acquireSnapshot(): Promise<VerifiedSnapshot> {\n    if (!this.#multiple) return this.#sources[0].registry.acquireSnapshot();\n    if (this.#inFlight) return this.#inFlight;\n    this.#inFlight = Promise.all(\n      this.#sources.map(({ registry }) => registry.acquireSnapshot()),\n    )\n      .then((parts) => {\n        if (\n          this.#snapshot &&\n          parts.every((part, index) => part === this.#parts?.[index])\n        ) {\n          return this.#snapshot;\n        }\n        const identity = createHash(\"sha256\")\n          .update(\n            JSON.stringify(\n              parts.map((part, index) => [\n                this.#sources[index].id,\n                part.revision,\n                part.etag,\n              ]),\n            ),\n          )\n          .digest(\"hex\");\n        const skills = Object.freeze(\n          parts.flatMap((part, index) =>\n            part.skills.map((skill) =>\n              Object.freeze({\n                ...skill,\n                name: `${encodeURIComponent(this.#sources[index].id)}/${skill.name}`,\n              }),\n            ),\n          ),\n        );\n        this.#parts = parts;\n        this.#snapshot = Object.freeze({\n          revision: `multi:${identity}`,\n          etag: `\"${identity}\"`,\n          skills,\n        });\n        return this.#snapshot;\n      })\n      .finally(() => {\n        this.#inFlight = undefined;\n      });\n    return this.#inFlight;\n  }\n\n  /** Report each container's real revision; no aggregate server revision exists. */\n  get status(): SkillRegistryStatus {\n    if (!this.#multiple) return this.#sources[0].registry.status;\n    const containers = Object.freeze(\n      this.#sources.map(({ id, registry }) =>\n        Object.freeze({ id, ...registry.status }),\n      ),\n    );\n    const error =\n      containers.find(\n        (source) => source.lastError && !source.lastError.retryable,\n      )?.lastError ?? containers.find((source) => source.lastError)?.lastError;\n    const timestamps = containers.map((source) => source.lastCheckedAt);\n    return Object.freeze({\n      initialized: this.#snapshot !== undefined,\n      mode: containers.every((source) => source.mode === \"pinned\")\n        ? \"pinned\"\n        : \"latest\",\n      stale: containers.some((source) => source.stale),\n      ...(timestamps.every((timestamp) => timestamp !== undefined)\n        ? { lastCheckedAt: [...timestamps].sort()[0] }\n        : {}),\n      ...(error ? { lastError: error } : {}),\n      containers,\n    });\n  }\n}\n"],"mappings":";;;;;;;;AA+BA,SAAS,UAAU,OAAoC;AACrD,QAAO;EACL;EACA;EACA;EACA;EACD,CAAC,SAAS,MAAM,KAAK;;AAExB,SAAS,cAAc,OAAoC;AACzD,KAAI,iBAAiBA,0CAAoB,QAAO;AAChD,QAAO,IAAIA,0CACT,iBAAiB,SAAS,MAAM,SAAS,iBACrC,YACA,iBACJ,MACA,MACD;;;AAIH,IAAM,0BAAN,MAA8B;CAC5B,CAASC;CACT;CACA;CACA;CACA,SAAS;CACT;CACA;CAEA,YACE,QACA,AAAiB,iBACf,YACG,OAAO,OAAO,yBAAyB,QAAQ,EACpD;EAHiB;AAIjB,QAAKA,SAAU;;CAGjB,MAAM,aAA4B;AAChC,QAAM,KAAK,iBAAiB;;;CAI9B,kBAA6C;AAC3C,MAAI,MAAKC,SAAW,QAAO,MAAKA;AAChC,MACE,MAAKC,YACL,CAAC,MAAKC,WACN,MAAKC,kBAAmB,UACxB,KAAK,KAAK,GAAG,MAAKA,gBAAiB,MAAKJ,OAAQ,kBAEhD,QAAO,QAAQ,QAAQ,MAAKE,SAAU;AAIxC,QAAKD,WAAY,QAAQ,SAAS,CAC/B,WAAW,MAAKI,SAAU,CAAC,CAC3B,cAAc;AACb,SAAKJ,WAAY;IACjB;AACJ,SAAO,MAAKA;;CAGd,IAAI,SAA8B;EAChC,MAAM,QAAQ,MAAKK;AACnB,SAAO,OAAO,OAAO;GACnB,aAAa,MAAKJ,aAAc;GAChC,GAAI,MAAKA,WAAY,EAAE,UAAU,MAAKA,SAAU,UAAU,GAAG,EAAE;GAC/D,MAAM,MAAKF,OAAQ,aAAa,SAAY,WAAW;GACvD,GAAI,MAAKI,kBAAmB,SACxB,EAAE,eAAe,IAAI,KAAK,MAAKA,cAAe,CAAC,aAAa,EAAE,GAC9D,EAAE;GACN,OAAO,MAAKG;GACZ,GAAI,QACA,EACE,WAAW,OAAO,OAAO;IACvB,MAAM,MAAM;IACZ,SAAS,MAAM;IACf,WAAW,MAAM;IAClB,CAAC,EACH,GACD,EAAE;GACP,CAAC;;CAGJ,OAAMF,UAAsC;EAC1C,MAAM,YAAY,KAAK,KAAK;EAC5B,MAAM,aAAa,IAAI,iBAAiB;EACxC,IAAI;EACJ,MAAM,WAAW,IAAI,SAAgB,GAAG,WAAW;AACjD,WAAQ,iBAAiB;IACvB,MAAM,QAAQ,IAAIN,0CAAmB,WAAW,KAAK;AACrD,eAAW,MAAM,MAAM;AAGvB,YAAQ,iBAAiB,OAAO,MAAM,EAAE,EAAE;MACzC,MAAKC,OAAQ,iBAAiB;IACjC;EACF,MAAM,cAAc,YAAuC;GACzD,MAAM,WAAW,MAAM,KAAK,cAAc;IACxC,aAAa,MAAKA,OAAQ;IAC1B,GAAI,MAAKA,OAAQ,aAAa,SAC1B,EAAE,UAAU,MAAKA,OAAQ,UAAU,GACnC,EAAE;IACN,GAAI,MAAKE,WAAY,EAAE,aAAa,MAAKA,SAAU,MAAM,GAAG,EAAE;IAC9D,QAAQ,WAAW;IACpB,CAAC;AACF,cAAW,OAAO,gBAAgB;AAClC,OAAI,CAAC,YAAY,OAAO,aAAa,SAAU,OAAMM,gCAAiB;AACtE,OAAI,SAAS,WAAW,aAAa;AACnC,QACE,CAAC,MAAKN,YACN,SAAS,SAAS,MAAKA,SAAU,QACjC,SAAS,aAAa,MAAKA,SAAU,SAErC,OAAMM,gCAAiB;AACzB,WAAO,MAAKN;;AAEd,OACE,MAAKF,OAAQ,aAAa,UAC1B,SAAS,aAAa,MAAKA,OAAQ,SAEnC,OAAMQ,gCAAiB;AACzB,UAAOC,kCAAiB,UAAU,WAAW,OAAO;;AAEtD,MAAI;GACF,MAAM,WAAW,MAAM,QAAQ,KAAK,CAAC,aAAa,EAAE,SAAS,CAAC;AAG9D,SAAKP,WAAY;AACjB,SAAKE,gBAAiB,KAAK,KAAK;AAChC,SAAKG,QAAS;AACd,SAAKD,YAAa;AAClB,SAAKH,UAAW;AAChB,SAAKO,MAAO,mBAAmB,UAAU;AACzC,UAAO;WACA,OAAO;GACd,MAAM,QAAQ,cAAc,MAAM;AAClC,OAAI,CAAC,UAAU,MAAM,EAAE;AACrB,UAAKP,UAAW;AAChB,UAAKI,QAAS;AACd,UAAKD,YAAa;AAClB,UAAKI,MAAO,kBAAkB,WAAW,MAAM,KAAK;AACpD,UAAM;;AAGR,OAAI,MAAKP,SAAU;AACjB,UAAKG,YAAa,MAAKH;AACvB,UAAKO,MAAO,kBAAkB,WAAW,MAAM,KAAK;AACpD,UAAM,MAAKP;;AAEb,SAAKG,YAAa;AAClB,SAAKC,QAAS,MAAKL,aAAc;AACjC,SAAKQ,MAAO,kBAAkB,WAAW,MAAM,KAAK;AACpD,OAAI,MAAKR,SAAW,QAAO,MAAKA;AAChC,SAAM;YACE;AACR,OAAI,UAAU,OAAW,cAAa,MAAM;;;CAIhD,OACE,OACA,WACA,WACM;AACN,MAAI,CAAC,MAAKF,OAAQ,MAAO;AACzB,UAAQ,MAAM,6BAA6B;GACzC;GACA,aAAa,MAAKA,OAAQ;GAC1B,UAAU,MAAKE,UAAW;GAC1B,YAAY,KAAK,KAAK,GAAG;GACzB,GAAI,YAAY,EAAE,WAAW,GAAG,EAAE;GACnC,CAAC;;;;AAKN,SAAS,YAAY,QAAgC;CACnD,IAAI,UAIE,EAAE;AACR,SACE,YAEA,IAAI,SAAS,SAAS,WAAW;AAC/B,UAAQ,KAAK;GAAE;GAAS;GAAS;GAAQ,CAAC;AAC1C,MAAI,QAAQ,WAAW,EAAG;AAC1B,iBAAe,YAAY;GACzB,MAAM,QAAQ;AACd,aAAU,EAAE;AACZ,OAAI;IACF,MAAM,UAAU,MAAM,OAAO,0BAA0B;KACrD,YAAY,MAAM,KACf,EAAE,SAAS,EAAE,QAAQ,SAAS,GAAG,eAAe,OAClD;KACD,QAAQ,MAAM,GAAG,QAAQ;KAC1B,CAAC;AACF,QACE,CAAC,MAAM,QAAQ,QAAQ,IACvB,QAAQ,WAAW,MAAM,UACzB,QAAQ,MACL,QAAQ,UACP,QAAQ,gBAAgB,MAAM,OAAO,QAAQ,YAChD,CAED,OAAMM,gCAAiB;AACzB,SAAK,IAAI,QAAQ,GAAG,QAAQ,MAAM,QAAQ,SAAS;KACjD,MAAM,SAAS,QAAQ;AACvB,SAAI,OAAO,WAAW,QAAS,OAAM,OAAO,OAAO,OAAO,MAAM;SAC3D,OAAM,OAAO,QAAQ,OAAO;;YAE5B,OAAO;AACd,SAAK,MAAM,QAAQ,MAAO,MAAK,OAAO,MAAM;;IAE9C;GACF;;;AAIN,IAAa,gBAAb,MAA2B;CACzB,CAASG;CAIT,CAASC;CACT;CACA;CACA;CAEA,YAAY,UAAgC,EAAE,EAAE;EAC9C,MAAM,SAASC,qCAAsB,QAAQ;AAC7C,QAAKD,WAAY,OAAO,eAAe;EACvC,MAAM,aAAa,YAAY,OAAO,OAAO;AAC7C,QAAKD,UACH,OAAO,eAAe,SAClB,OAAO,WAAW,KAAK,EAAE,IAAI,gBAAgB;GAC3C;GACA,UAAU,IAAI,wBACZ,OAAO,OAAO;IACZ,QAAQ,OAAO;IACf,mBAAmB,OAAO;IAC1B,kBAAkB,OAAO;IACzB,OAAO,OAAO;IACd,aAAa;IACb,GAAI,aAAa,SAAY,EAAE,UAAU,GAAG,EAAE;IAC/C,CAAC,EACF,WACD;GACF,EAAE,GACH,CACE;GACE,IAAI,OAAO;GACX,UAAU,IAAI,wBAAwB;IACpC,QAAQ,OAAO;IACf,aAAa,OAAO;IACpB,UAAU,OAAO;IACjB,mBAAmB,OAAO;IAC1B,kBAAkB,OAAO;IACzB,OAAO,OAAO;IACf,CAAC;GACH,CACF;;;CAIT,MAAM,aAA4B;AAChC,QAAM,KAAK,iBAAiB;;;CAI9B,kBAA6C;AAC3C,MAAI,CAAC,MAAKC,SAAW,QAAO,MAAKD,QAAS,GAAG,SAAS,iBAAiB;AACvE,MAAI,MAAKV,SAAW,QAAO,MAAKA;AAChC,QAAKA,WAAY,QAAQ,IACvB,MAAKU,QAAS,KAAK,EAAE,eAAe,SAAS,iBAAiB,CAAC,CAChE,CACE,MAAM,UAAU;AACf,OACE,MAAKT,YACL,MAAM,OAAO,MAAM,UAAU,SAAS,MAAKY,QAAS,OAAO,CAE3D,QAAO,MAAKZ;GAEd,MAAM,uCAAsB,SAAS,CAClC,OACC,KAAK,UACH,MAAM,KAAK,MAAM,UAAU;IACzB,MAAKS,QAAS,OAAO;IACrB,KAAK;IACL,KAAK;IACN,CAAC,CACH,CACF,CACA,OAAO,MAAM;GAChB,MAAM,SAAS,OAAO,OACpB,MAAM,SAAS,MAAM,UACnB,KAAK,OAAO,KAAK,UACf,OAAO,OAAO;IACZ,GAAG;IACH,MAAM,GAAG,mBAAmB,MAAKA,QAAS,OAAO,GAAG,CAAC,GAAG,MAAM;IAC/D,CAAC,CACH,CACF,CACF;AACD,SAAKG,QAAS;AACd,SAAKZ,WAAY,OAAO,OAAO;IAC7B,UAAU,SAAS;IACnB,MAAM,IAAI,SAAS;IACnB;IACD,CAAC;AACF,UAAO,MAAKA;IACZ,CACD,cAAc;AACb,SAAKD,WAAY;IACjB;AACJ,SAAO,MAAKA;;;CAId,IAAI,SAA8B;AAChC,MAAI,CAAC,MAAKW,SAAW,QAAO,MAAKD,QAAS,GAAG,SAAS;EACtD,MAAM,aAAa,OAAO,OACxB,MAAKA,QAAS,KAAK,EAAE,IAAI,eACvB,OAAO,OAAO;GAAE;GAAI,GAAG,SAAS;GAAQ,CAAC,CAC1C,CACF;EACD,MAAM,QACJ,WAAW,MACR,WAAW,OAAO,aAAa,CAAC,OAAO,UAAU,UACnD,EAAE,aAAa,WAAW,MAAM,WAAW,OAAO,UAAU,EAAE;EACjE,MAAM,aAAa,WAAW,KAAK,WAAW,OAAO,cAAc;AACnE,SAAO,OAAO,OAAO;GACnB,aAAa,MAAKT,aAAc;GAChC,MAAM,WAAW,OAAO,WAAW,OAAO,SAAS,SAAS,GACxD,WACA;GACJ,OAAO,WAAW,MAAM,WAAW,OAAO,MAAM;GAChD,GAAI,WAAW,OAAO,cAAc,cAAc,OAAU,GACxD,EAAE,eAAe,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,IAAI,GAC5C,EAAE;GACN,GAAI,QAAQ,EAAE,WAAW,OAAO,GAAG,EAAE;GACrC;GACD,CAAC"}

package/dist/runtime/intelligence-platform/skill-registry/registry.d.cts

@@ -0,0 +1,36 @@
+import { LearnedSkillsErrorCode } from "../learned-skills.cjs";
+import { SkillRegistryOptions } from "./config.cjs";
+import { VerifiedSnapshot } from "./snapshot.cjs";
+
+//#region src/runtime/intelligence-platform/skill-registry/registry.d.ts
+interface SkillRegistryStatus {
+  /** Present only for the explicit containers interface. */
+  readonly containers?: readonly (SkillRegistryStatus & {
+    readonly id: string;
+  })[];
+  readonly initialized: boolean;
+  readonly revision?: string;
+  readonly mode: "latest" | "pinned";
+  /** ISO 8601 timestamp of the last successful 200 or matching 304 check. */
+  readonly lastCheckedAt?: string;
+  readonly stale: boolean;
+  readonly lastError?: Readonly<{
+    code: LearnedSkillsErrorCode;
+    message: string;
+    retryable: boolean;
+  }>;
+}
+/** Compose independent container caches into one immutable invocation snapshot. */
+declare class SkillRegistry {
+  #private;
+  constructor(options?: SkillRegistryOptions);
+  /** Load every configured container before agent initialization completes. */
+  initialize(): Promise<void>;
+  /** Capture every container once; a failed source cannot yield a partial catalog. */
+  acquireSnapshot(): Promise<VerifiedSnapshot>;
+  /** Report each container's real revision; no aggregate server revision exists. */
+  get status(): SkillRegistryStatus;
+}
+//#endregion
+export { SkillRegistry, SkillRegistryStatus };
+//# sourceMappingURL=registry.d.cts.map

package/dist/runtime/intelligence-platform/skill-registry/registry.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.cts","names":[],"sources":["../../../../src/runtime/intelligence-platform/skill-registry/registry.ts"],"mappings":";;;;;UAaiB,mBAAA;;WAEN,UAAA,aAAuB,mBAAA;IAAA,SACrB,EAAA;EAAA;EAAA,SAEF,WAAA;EAAA,SACA,QAAA;EAAA,SACA,IAAA;EAIoB;EAAA,SAFpB,aAAA;EAAA,SACA,KAAA;EAAA,SACA,SAAA,GAAY,QAAA;IACnB,IAAA,EAAM,sBAAA;IACN,OAAA;IACA,SAAA;EAAA;AAAA;;cAkOS,aAAA;EAAA;cAUC,OAAA,GAAS,oBAAA;EA9Ob;EAkRF,UAAA,CAAA,GAAc,OAAA;EAhRlB;EAqRF,eAAA,CAAA,GAAmB,OAAA,CAAQ,gBAAA;EArRhB;EAAA,IAsUP,MAAA,CAAA,GAAU,mBAAA;AAAA"}

package/dist/runtime/intelligence-platform/skill-registry/registry.d.mts

@@ -0,0 +1,36 @@
+import { LearnedSkillsErrorCode } from "../learned-skills.mjs";
+import { SkillRegistryOptions } from "./config.mjs";
+import { VerifiedSnapshot } from "./snapshot.mjs";
+
+//#region src/runtime/intelligence-platform/skill-registry/registry.d.ts
+interface SkillRegistryStatus {
+  /** Present only for the explicit containers interface. */
+  readonly containers?: readonly (SkillRegistryStatus & {
+    readonly id: string;
+  })[];
+  readonly initialized: boolean;
+  readonly revision?: string;
+  readonly mode: "latest" | "pinned";
+  /** ISO 8601 timestamp of the last successful 200 or matching 304 check. */
+  readonly lastCheckedAt?: string;
+  readonly stale: boolean;
+  readonly lastError?: Readonly<{
+    code: LearnedSkillsErrorCode;
+    message: string;
+    retryable: boolean;
+  }>;
+}
+/** Compose independent container caches into one immutable invocation snapshot. */
+declare class SkillRegistry {
+  #private;
+  constructor(options?: SkillRegistryOptions);
+  /** Load every configured container before agent initialization completes. */
+  initialize(): Promise<void>;
+  /** Capture every container once; a failed source cannot yield a partial catalog. */
+  acquireSnapshot(): Promise<VerifiedSnapshot>;
+  /** Report each container's real revision; no aggregate server revision exists. */
+  get status(): SkillRegistryStatus;
+}
+//#endregion
+export { SkillRegistry, SkillRegistryStatus };
+//# sourceMappingURL=registry.d.mts.map

package/dist/runtime/intelligence-platform/skill-registry/registry.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.mts","names":[],"sources":["../../../../src/runtime/intelligence-platform/skill-registry/registry.ts"],"mappings":";;;;;UAaiB,mBAAA;;WAEN,UAAA,aAAuB,mBAAA;IAAA,SACrB,EAAA;EAAA;EAAA,SAEF,WAAA;EAAA,SACA,QAAA;EAAA,SACA,IAAA;EAIoB;EAAA,SAFpB,aAAA;EAAA,SACA,KAAA;EAAA,SACA,SAAA,GAAY,QAAA;IACnB,IAAA,EAAM,sBAAA;IACN,OAAA;IACA,SAAA;EAAA;AAAA;;cAkOS,aAAA;EAAA;cAUC,OAAA,GAAS,oBAAA;EA9Ob;EAkRF,UAAA,CAAA,GAAc,OAAA;EAhRlB;EAqRF,eAAA,CAAA,GAAmB,OAAA,CAAQ,gBAAA;EArRhB;EAAA,IAsUP,MAAA,CAAA,GAAU,mBAAA;AAAA"}