@copilotkit/runtime 1.72.1-canary.sp-longthread-perf → 1.73.1

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

@@ -0,0 +1,11 @@
+
+//#region src/v2/runtime/intelligence-platform/skill-registry/archive.d.ts
+/** Internal corruption bounds, including manifest and directory entries. */
+declare const MAX_ARCHIVE_ENTRIES = 1000;
+declare const MAX_SNAPSHOT_BYTES: number;
+declare function safeRelativePath(path: string): boolean;
+/** Decode only the listed ZIP namespace. No filesystem is involved. */
+declare function readArchive(bytes: Buffer, signal?: AbortSignal): Promise<Map<string, Buffer>>;
+//#endregion
+export { MAX_ARCHIVE_ENTRIES, MAX_SNAPSHOT_BYTES, readArchive, safeRelativePath };
+//# sourceMappingURL=archive.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"archive.d.cts","names":[],"sources":["../../../../../src/v2/runtime/intelligence-platform/skill-registry/archive.ts"],"mappings":";;;cAMa,mBAAA;AAAA,cACA,kBAAA;AAAA,iBAEG,gBAAA,CAAiB,IAAA;;iBAcjB,WAAA,CACd,KAAA,EAAO,MAAA,EACP,MAAA,GAAS,WAAA,GACR,OAAA,CAAQ,GAAA,SAAY,MAAA"}

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

@@ -0,0 +1,11 @@
+
+//#region src/v2/runtime/intelligence-platform/skill-registry/archive.d.ts
+/** Internal corruption bounds, including manifest and directory entries. */
+declare const MAX_ARCHIVE_ENTRIES = 1000;
+declare const MAX_SNAPSHOT_BYTES: number;
+declare function safeRelativePath(path: string): boolean;
+/** Decode only the listed ZIP namespace. No filesystem is involved. */
+declare function readArchive(bytes: Buffer, signal?: AbortSignal): Promise<Map<string, Buffer>>;
+//#endregion
+export { MAX_ARCHIVE_ENTRIES, MAX_SNAPSHOT_BYTES, readArchive, safeRelativePath };
+//# sourceMappingURL=archive.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"archive.d.mts","names":[],"sources":["../../../../../src/v2/runtime/intelligence-platform/skill-registry/archive.ts"],"mappings":";;;cAMa,mBAAA;AAAA,cACA,kBAAA;AAAA,iBAEG,gBAAA,CAAiB,IAAA;;iBAcjB,WAAA,CACd,KAAA,EAAO,MAAA,EACP,MAAA,GAAS,WAAA,GACR,OAAA,CAAQ,GAAA,SAAY,MAAA"}

package/dist/v2/runtime/intelligence-platform/skill-registry/archive.mjs

@@ -0,0 +1,128 @@
+import "reflect-metadata";
+import { invalidSnapshot } from "./errors.mjs";
+import { fromBuffer } from "yauzl";
+
+//#region src/v2/runtime/intelligence-platform/skill-registry/archive.ts
+/** Internal corruption bounds, including manifest and directory entries. */
+const MAX_ARCHIVE_ENTRIES = 1e3;
+const MAX_SNAPSHOT_BYTES = 32 * 1024 * 1024;
+function safeRelativePath(path) {
+	return path.length > 0 && !/[\\\x00-\x1f\x7f]/.test(path) && !/^[a-z]:/i.test(path) && path.split("/").every((part) => part !== "" && part !== "." && part !== "..");
+}
+/** Decode only the listed ZIP namespace. No filesystem is involved. */
+function readArchive(bytes, signal) {
+	return new Promise((resolve, reject) => {
+		let archive;
+		let stream;
+		let settled = false;
+		const finish = (error) => {
+			if (settled) return;
+			settled = true;
+			signal?.removeEventListener("abort", abort);
+			stream?.destroy();
+			archive?.close();
+			if (error !== void 0) reject(error);
+			else resolve(files);
+		};
+		const abort = () => finish(signal?.reason ?? invalidSnapshot());
+		const files = /* @__PURE__ */ new Map();
+		const names = /* @__PURE__ */ new Set();
+		let decodedBytes = 0;
+		signal?.addEventListener("abort", abort, { once: true });
+		if (signal?.aborted) {
+			abort();
+			return;
+		}
+		fromBuffer(bytes, {
+			lazyEntries: true,
+			decodeStrings: false,
+			validateEntrySizes: true,
+			autoClose: false
+		}, (error, zip) => {
+			if (error) {
+				finish(invalidSnapshot(error));
+				return;
+			}
+			archive = zip;
+			if (settled) {
+				zip.close();
+				return;
+			}
+			zip.on("error", (cause) => finish(invalidSnapshot(cause)));
+			zip.on("end", () => finish());
+			if (zip.entryCount > MAX_ARCHIVE_ENTRIES) {
+				finish(invalidSnapshot());
+				return;
+			}
+			zip.on("entry", (entry) => {
+				try {
+					const rawName = entry.fileName;
+					if (!Buffer.isBuffer(rawName)) throw invalidSnapshot();
+					const name = new TextDecoder("utf-8", {
+						fatal: true,
+						ignoreBOM: true
+					}).decode(rawName);
+					const directory = name.endsWith("/");
+					if (!safeRelativePath(directory ? name.slice(0, -1) : name) || names.has(name)) throw invalidSnapshot();
+					names.add(name);
+					const fileType = entry.externalFileAttributes >>> 16 & 61440;
+					if (fileType !== 0 && fileType !== (directory ? 16384 : 32768)) throw invalidSnapshot();
+					if (entry.isEncrypted() || ![0, 8].includes(entry.compressionMethod)) throw invalidSnapshot();
+					if (!Number.isSafeInteger(entry.uncompressedSize) || entry.uncompressedSize < 0) throw invalidSnapshot();
+					decodedBytes += entry.uncompressedSize;
+					if (decodedBytes > MAX_SNAPSHOT_BYTES || directory && entry.uncompressedSize !== 0) throw invalidSnapshot();
+					const local = entry.relativeOffsetOfLocalHeader;
+					if (local < 0 || local + 30 > bytes.length || bytes.readUInt32LE(local) !== 67324752) throw invalidSnapshot();
+					if (bytes.readUInt16LE(local + 6) !== entry.generalPurposeBitFlag || bytes.readUInt16LE(local + 8) !== entry.compressionMethod) throw invalidSnapshot();
+					const localNameLength = bytes.readUInt16LE(local + 26);
+					const localExtraLength = bytes.readUInt16LE(local + 28);
+					if (local + 30 + localNameLength + localExtraLength + entry.compressedSize > bytes.length || !bytes.subarray(local + 30, local + 30 + localNameLength).equals(rawName)) throw invalidSnapshot();
+					if (!(entry.generalPurposeBitFlag & 8) && (bytes.readUInt32LE(local + 18) !== entry.compressedSize || bytes.readUInt32LE(local + 22) !== entry.uncompressedSize)) throw invalidSnapshot();
+					if (directory) {
+						zip.readEntry();
+						return;
+					}
+					zip.openReadStream(entry, (readError, readStream) => {
+						if (readError) {
+							finish(invalidSnapshot(readError));
+							return;
+						}
+						stream = readStream;
+						if (settled) {
+							readStream.destroy();
+							return;
+						}
+						const chunks = [];
+						let size = 0;
+						readStream.on("error", (cause) => finish(invalidSnapshot(cause)));
+						readStream.on("data", (chunk) => {
+							size += chunk.length;
+							if (size > entry.uncompressedSize || size > MAX_SNAPSHOT_BYTES) {
+								finish(invalidSnapshot());
+								return;
+							}
+							chunks.push(chunk);
+						});
+						readStream.on("end", () => {
+							if (settled) return;
+							if (size !== entry.uncompressedSize) {
+								finish(invalidSnapshot());
+								return;
+							}
+							files.set(name, Buffer.concat(chunks, size));
+							stream = void 0;
+							zip.readEntry();
+						});
+					});
+				} catch (cause) {
+					finish(invalidSnapshot(cause));
+				}
+			});
+			zip.readEntry();
+		});
+	});
+}
+
+//#endregion
+export { MAX_ARCHIVE_ENTRIES, MAX_SNAPSHOT_BYTES, readArchive, safeRelativePath };
+//# sourceMappingURL=archive.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"archive.mjs","names":[],"sources":["../../../../../src/v2/runtime/intelligence-platform/skill-registry/archive.ts"],"sourcesContent":["import { fromBuffer } from \"yauzl\";\nimport type { Entry, ZipFile } from \"yauzl\";\nimport type { Readable } from \"node:stream\";\nimport { invalidSnapshot } from \"./errors\";\n\n/** Internal corruption bounds, including manifest and directory entries. */\nexport const MAX_ARCHIVE_ENTRIES = 1_000;\nexport const MAX_SNAPSHOT_BYTES = 32 * 1024 * 1024;\n\nexport function safeRelativePath(path: string): boolean {\n  return (\n    path.length > 0 &&\n    // Reject control bytes in archive paths, including NUL and DEL.\n    // eslint-disable-next-line no-control-regex\n    !/[\\\\\\x00-\\x1f\\x7f]/.test(path) &&\n    !/^[a-z]:/i.test(path) &&\n    path\n      .split(\"/\")\n      .every((part) => part !== \"\" && part !== \".\" && part !== \"..\")\n  );\n}\n\n/** Decode only the listed ZIP namespace. No filesystem is involved. */\nexport function readArchive(\n  bytes: Buffer,\n  signal?: AbortSignal,\n): Promise<Map<string, Buffer>> {\n  return new Promise((resolve, reject) => {\n    let archive: ZipFile | undefined;\n    let stream: Readable | undefined;\n    let settled = false;\n    const finish = (error?: unknown) => {\n      if (settled) return;\n      settled = true;\n      signal?.removeEventListener(\"abort\", abort);\n      stream?.destroy();\n      archive?.close();\n      if (error !== undefined) reject(error);\n      else resolve(files);\n    };\n    const abort = () => finish(signal?.reason ?? invalidSnapshot());\n    const files = new Map<string, Buffer>();\n    const names = new Set<string>();\n    let decodedBytes = 0;\n    signal?.addEventListener(\"abort\", abort, { once: true });\n    if (signal?.aborted) {\n      abort();\n      return;\n    }\n    fromBuffer(\n      bytes,\n      {\n        lazyEntries: true,\n        decodeStrings: false,\n        validateEntrySizes: true,\n        autoClose: false,\n      },\n      (error, zip) => {\n        if (error) {\n          finish(invalidSnapshot(error));\n          return;\n        }\n        archive = zip;\n        if (settled) {\n          zip.close();\n          return;\n        }\n        zip.on(\"error\", (cause: unknown) => finish(invalidSnapshot(cause)));\n        zip.on(\"end\", () => finish());\n        if (zip.entryCount > MAX_ARCHIVE_ENTRIES) {\n          finish(invalidSnapshot());\n          return;\n        }\n        zip.on(\"entry\", (entry: Entry) => {\n          try {\n            // decodeStrings:false preserves raw UTF-8 names instead of normalizing\n            // backslashes or consulting alternate Unicode-path extra fields.\n            const rawName: unknown = entry.fileName;\n            if (!Buffer.isBuffer(rawName)) throw invalidSnapshot();\n            const name = new TextDecoder(\"utf-8\", {\n              fatal: true,\n              ignoreBOM: true,\n            }).decode(rawName);\n            const directory = name.endsWith(\"/\");\n            if (\n              !safeRelativePath(directory ? name.slice(0, -1) : name) ||\n              names.has(name)\n            )\n              throw invalidSnapshot();\n            names.add(name);\n            const fileType = (entry.externalFileAttributes >>> 16) & 0o170000;\n            if (\n              fileType !== 0 &&\n              fileType !== (directory ? 0o040000 : 0o100000)\n            )\n              throw invalidSnapshot();\n            if (\n              entry.isEncrypted() ||\n              ![0, 8].includes(entry.compressionMethod)\n            )\n              throw invalidSnapshot();\n            if (\n              !Number.isSafeInteger(entry.uncompressedSize) ||\n              entry.uncompressedSize < 0\n            )\n              throw invalidSnapshot();\n            decodedBytes += entry.uncompressedSize;\n            if (\n              decodedBytes > MAX_SNAPSHOT_BYTES ||\n              (directory && entry.uncompressedSize !== 0)\n            )\n              throw invalidSnapshot();\n            // Require the central directory and the local entry to name the same\n            // bytes. ZIP data descriptors may leave local sizes unset.\n            const local = entry.relativeOffsetOfLocalHeader;\n            if (\n              local < 0 ||\n              local + 30 > bytes.length ||\n              bytes.readUInt32LE(local) !== 0x04034b50\n            )\n              throw invalidSnapshot();\n            if (\n              bytes.readUInt16LE(local + 6) !== entry.generalPurposeBitFlag ||\n              bytes.readUInt16LE(local + 8) !== entry.compressionMethod\n            )\n              throw invalidSnapshot();\n            const localNameLength = bytes.readUInt16LE(local + 26);\n            const localExtraLength = bytes.readUInt16LE(local + 28);\n            const dataStart = local + 30 + localNameLength + localExtraLength;\n            if (\n              dataStart + entry.compressedSize > bytes.length ||\n              !bytes\n                .subarray(local + 30, local + 30 + localNameLength)\n                .equals(rawName)\n            )\n              throw invalidSnapshot();\n            if (\n              !(entry.generalPurposeBitFlag & 8) &&\n              (bytes.readUInt32LE(local + 18) !== entry.compressedSize ||\n                bytes.readUInt32LE(local + 22) !== entry.uncompressedSize)\n            )\n              throw invalidSnapshot();\n            if (directory) {\n              zip.readEntry();\n              return;\n            }\n            zip.openReadStream(entry, (readError, readStream) => {\n              if (readError) {\n                finish(invalidSnapshot(readError));\n                return;\n              }\n              stream = readStream;\n              if (settled) {\n                readStream.destroy();\n                return;\n              }\n              const chunks: Buffer[] = [];\n              let size = 0;\n              readStream.on(\"error\", (cause: unknown) =>\n                finish(invalidSnapshot(cause)),\n              );\n              readStream.on(\"data\", (chunk: Buffer) => {\n                size += chunk.length;\n                if (\n                  size > entry.uncompressedSize ||\n                  size > MAX_SNAPSHOT_BYTES\n                ) {\n                  finish(invalidSnapshot());\n                  return;\n                }\n                chunks.push(chunk);\n              });\n              readStream.on(\"end\", () => {\n                if (settled) return;\n                if (size !== entry.uncompressedSize) {\n                  finish(invalidSnapshot());\n                  return;\n                }\n                files.set(name, Buffer.concat(chunks, size));\n                stream = undefined;\n                zip.readEntry();\n              });\n            });\n          } catch (cause) {\n            finish(invalidSnapshot(cause));\n          }\n        });\n        zip.readEntry();\n      },\n    );\n  });\n}\n"],"mappings":";;;;;;AAMA,MAAa,sBAAsB;AACnC,MAAa,qBAAqB,KAAK,OAAO;AAE9C,SAAgB,iBAAiB,MAAuB;AACtD,QACE,KAAK,SAAS,KAGd,CAAC,oBAAoB,KAAK,KAAK,IAC/B,CAAC,WAAW,KAAK,KAAK,IACtB,KACG,MAAM,IAAI,CACV,OAAO,SAAS,SAAS,MAAM,SAAS,OAAO,SAAS,KAAK;;;AAKpE,SAAgB,YACd,OACA,QAC8B;AAC9B,QAAO,IAAI,SAAS,SAAS,WAAW;EACtC,IAAI;EACJ,IAAI;EACJ,IAAI,UAAU;EACd,MAAM,UAAU,UAAoB;AAClC,OAAI,QAAS;AACb,aAAU;AACV,WAAQ,oBAAoB,SAAS,MAAM;AAC3C,WAAQ,SAAS;AACjB,YAAS,OAAO;AAChB,OAAI,UAAU,OAAW,QAAO,MAAM;OACjC,SAAQ,MAAM;;EAErB,MAAM,cAAc,OAAO,QAAQ,UAAU,iBAAiB,CAAC;EAC/D,MAAM,wBAAQ,IAAI,KAAqB;EACvC,MAAM,wBAAQ,IAAI,KAAa;EAC/B,IAAI,eAAe;AACnB,UAAQ,iBAAiB,SAAS,OAAO,EAAE,MAAM,MAAM,CAAC;AACxD,MAAI,QAAQ,SAAS;AACnB,UAAO;AACP;;AAEF,aACE,OACA;GACE,aAAa;GACb,eAAe;GACf,oBAAoB;GACpB,WAAW;GACZ,GACA,OAAO,QAAQ;AACd,OAAI,OAAO;AACT,WAAO,gBAAgB,MAAM,CAAC;AAC9B;;AAEF,aAAU;AACV,OAAI,SAAS;AACX,QAAI,OAAO;AACX;;AAEF,OAAI,GAAG,UAAU,UAAmB,OAAO,gBAAgB,MAAM,CAAC,CAAC;AACnE,OAAI,GAAG,aAAa,QAAQ,CAAC;AAC7B,OAAI,IAAI,aAAa,qBAAqB;AACxC,WAAO,iBAAiB,CAAC;AACzB;;AAEF,OAAI,GAAG,UAAU,UAAiB;AAChC,QAAI;KAGF,MAAM,UAAmB,MAAM;AAC/B,SAAI,CAAC,OAAO,SAAS,QAAQ,CAAE,OAAM,iBAAiB;KACtD,MAAM,OAAO,IAAI,YAAY,SAAS;MACpC,OAAO;MACP,WAAW;MACZ,CAAC,CAAC,OAAO,QAAQ;KAClB,MAAM,YAAY,KAAK,SAAS,IAAI;AACpC,SACE,CAAC,iBAAiB,YAAY,KAAK,MAAM,GAAG,GAAG,GAAG,KAAK,IACvD,MAAM,IAAI,KAAK,CAEf,OAAM,iBAAiB;AACzB,WAAM,IAAI,KAAK;KACf,MAAM,WAAY,MAAM,2BAA2B,KAAM;AACzD,SACE,aAAa,KACb,cAAc,YAAY,QAAW,OAErC,OAAM,iBAAiB;AACzB,SACE,MAAM,aAAa,IACnB,CAAC,CAAC,GAAG,EAAE,CAAC,SAAS,MAAM,kBAAkB,CAEzC,OAAM,iBAAiB;AACzB,SACE,CAAC,OAAO,cAAc,MAAM,iBAAiB,IAC7C,MAAM,mBAAmB,EAEzB,OAAM,iBAAiB;AACzB,qBAAgB,MAAM;AACtB,SACE,eAAe,sBACd,aAAa,MAAM,qBAAqB,EAEzC,OAAM,iBAAiB;KAGzB,MAAM,QAAQ,MAAM;AACpB,SACE,QAAQ,KACR,QAAQ,KAAK,MAAM,UACnB,MAAM,aAAa,MAAM,KAAK,SAE9B,OAAM,iBAAiB;AACzB,SACE,MAAM,aAAa,QAAQ,EAAE,KAAK,MAAM,yBACxC,MAAM,aAAa,QAAQ,EAAE,KAAK,MAAM,kBAExC,OAAM,iBAAiB;KACzB,MAAM,kBAAkB,MAAM,aAAa,QAAQ,GAAG;KACtD,MAAM,mBAAmB,MAAM,aAAa,QAAQ,GAAG;AAEvD,SADkB,QAAQ,KAAK,kBAAkB,mBAEnC,MAAM,iBAAiB,MAAM,UACzC,CAAC,MACE,SAAS,QAAQ,IAAI,QAAQ,KAAK,gBAAgB,CAClD,OAAO,QAAQ,CAElB,OAAM,iBAAiB;AACzB,SACE,EAAE,MAAM,wBAAwB,OAC/B,MAAM,aAAa,QAAQ,GAAG,KAAK,MAAM,kBACxC,MAAM,aAAa,QAAQ,GAAG,KAAK,MAAM,kBAE3C,OAAM,iBAAiB;AACzB,SAAI,WAAW;AACb,UAAI,WAAW;AACf;;AAEF,SAAI,eAAe,QAAQ,WAAW,eAAe;AACnD,UAAI,WAAW;AACb,cAAO,gBAAgB,UAAU,CAAC;AAClC;;AAEF,eAAS;AACT,UAAI,SAAS;AACX,kBAAW,SAAS;AACpB;;MAEF,MAAM,SAAmB,EAAE;MAC3B,IAAI,OAAO;AACX,iBAAW,GAAG,UAAU,UACtB,OAAO,gBAAgB,MAAM,CAAC,CAC/B;AACD,iBAAW,GAAG,SAAS,UAAkB;AACvC,eAAQ,MAAM;AACd,WACE,OAAO,MAAM,oBACb,OAAO,oBACP;AACA,eAAO,iBAAiB,CAAC;AACzB;;AAEF,cAAO,KAAK,MAAM;QAClB;AACF,iBAAW,GAAG,aAAa;AACzB,WAAI,QAAS;AACb,WAAI,SAAS,MAAM,kBAAkB;AACnC,eAAO,iBAAiB,CAAC;AACzB;;AAEF,aAAM,IAAI,MAAM,OAAO,OAAO,QAAQ,KAAK,CAAC;AAC5C,gBAAS;AACT,WAAI,WAAW;QACf;OACF;aACK,OAAO;AACd,YAAO,gBAAgB,MAAM,CAAC;;KAEhC;AACF,OAAI,WAAW;IAElB;GACD"}

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

@@ -0,0 +1,48 @@
+require("reflect-metadata");
+const require_learned_skills = require('../learned-skills.cjs');
+const require_client = require('../client.cjs');
+
+//#region src/v2/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 containerId = options.containerId ?? environment.CPK_INTELLIGENCE_LEARNING_CONTAINER_ID;
+		const revision = options.revision ?? environment.CPK_INTELLIGENCE_SKILLS_REVISION;
+		const freshnessWindowMs = options.freshnessWindowMs ?? 5e3;
+		const requestTimeoutMs = options.requestTimeoutMs ?? 5e3;
+		const debug = options.debug ?? false;
+		if (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 require_learned_skills.LearnedSkillsError("INVALID_CONFIG", false);
+		let client = options.client;
+		if (client !== void 0) {
+			if (!client || typeof client.getLearnedSkillsSnapshot !== "function") throw new require_learned_skills.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 require_learned_skills.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 require_learned_skills.LearnedSkillsError("INVALID_CONFIG", false);
+			}
+			client = new require_client.CopilotKitIntelligence({
+				apiKey,
+				...apiUrl !== void 0 ? { apiUrl } : {},
+				...apiUrl?.trim() ? { wsUrl: "wss://realtime.intelligence.copilotkit.ai" } : {}
+			});
+		}
+		return Object.freeze({
+			client,
+			containerId,
+			...revision !== void 0 ? { revision } : {},
+			freshnessWindowMs,
+			requestTimeoutMs,
+			debug
+		});
+	} catch (error) {
+		if (error instanceof require_learned_skills.LearnedSkillsError) throw error;
+		throw new require_learned_skills.LearnedSkillsError("INVALID_CONFIG", false, error);
+	}
+}
+
+//#endregion
+exports.resolveRegistryConfig = resolveRegistryConfig;
+//# sourceMappingURL=config.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.cjs","names":["SkillDeliveryError","CopilotKitIntelligence"],"sources":["../../../../../src/v2/runtime/intelligence-platform/skill-registry/config.ts"],"sourcesContent":["import { CopilotKitIntelligence } from \"../client\";\nimport { SkillDeliveryError } from \"./errors\";\n\nexport interface SkillRegistryOptions {\n  client?: CopilotKitIntelligence;\n  apiKey?: string;\n  apiUrl?: string;\n  containerId?: string;\n  revision?: string;\n  freshnessWindowMs?: number;\n  requestTimeoutMs?: number;\n  debug?: boolean;\n}\nexport interface RegistryConfig {\n  readonly client: CopilotKitIntelligence;\n  readonly containerId: string;\n  readonly revision?: string;\n  readonly freshnessWindowMs: number;\n  readonly requestTimeoutMs: number;\n  readonly debug: boolean;\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 containerId =\n      options.containerId ?? environment.CPK_INTELLIGENCE_LEARNING_CONTAINER_ID;\n    const revision =\n      options.revision ?? environment.CPK_INTELLIGENCE_SKILLS_REVISION;\n    const freshnessWindowMs = options.freshnessWindowMs ?? 5_000;\n    const requestTimeoutMs = options.requestTimeoutMs ?? 5_000;\n    const debug = options.debug ?? false;\n    if (\n      typeof containerId !== \"string\" ||\n      !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 (!client || typeof client.getLearnedSkillsSnapshot !== \"function\")\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      containerId,\n      ...(revision !== undefined ? { revision } : {}),\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":";;;;;;AAuBA,SAAgB,sBACd,UAAgC,EAAE,EAClC,cAAiC,QAAQ,KACzB;AAChB,KAAI;EACF,MAAM,cACJ,QAAQ,eAAe,YAAY;EACrC,MAAM,WACJ,QAAQ,YAAY,YAAY;EAClC,MAAM,oBAAoB,QAAQ,qBAAqB;EACvD,MAAM,mBAAmB,QAAQ,oBAAoB;EACrD,MAAM,QAAQ,QAAQ,SAAS;AAC/B,MACE,OAAO,gBAAgB,YACvB,CAAC,YAAY,MAAM,IAClB,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,0CAAmB,kBAAkB,MAAM;EACvD,IAAI,SAAS,QAAQ;AACrB,MAAI,WAAW,QACb;OAAI,CAAC,UAAU,OAAO,OAAO,6BAA6B,WACxD,OAAM,IAAIA,0CAAmB,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,0CAAmB,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,0CAAmB,kBAAkB,MAAM;;AAEzD,YAAS,IAAIC,sCAAuB;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;GACA,GAAI,aAAa,SAAY,EAAE,UAAU,GAAG,EAAE;GAC9C;GACA;GACA;GACD,CAAC;UACK,OAAO;AACd,MAAI,iBAAiBD,0CAAoB,OAAM;AAC/C,QAAM,IAAIA,0CAAmB,kBAAkB,OAAO,MAAM"}

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

@@ -0,0 +1,27 @@
+
+import { CopilotKitIntelligence } from "../client.cjs";
+
+//#region src/v2/runtime/intelligence-platform/skill-registry/config.d.ts
+interface SkillRegistryOptions {
+  client?: CopilotKitIntelligence;
+  apiKey?: string;
+  apiUrl?: string;
+  containerId?: string;
+  revision?: string;
+  freshnessWindowMs?: number;
+  requestTimeoutMs?: number;
+  debug?: boolean;
+}
+interface RegistryConfig {
+  readonly client: CopilotKitIntelligence;
+  readonly containerId: string;
+  readonly revision?: string;
+  readonly freshnessWindowMs: number;
+  readonly requestTimeoutMs: number;
+  readonly debug: boolean;
+}
+/** Resolve once. Never retain the options object, environment, or a second key. */
+declare function resolveRegistryConfig(options?: SkillRegistryOptions, environment?: NodeJS.ProcessEnv): RegistryConfig;
+//#endregion
+export { RegistryConfig, SkillRegistryOptions, resolveRegistryConfig };
+//# sourceMappingURL=config.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.cts","names":[],"sources":["../../../../../src/v2/runtime/intelligence-platform/skill-registry/config.ts"],"mappings":";;;;UAGiB,oBAAA;EACf,MAAA,GAAS,sBAAA;EACT,MAAA;EACA,MAAA;EACA,WAAA;EACA,QAAA;EACA,iBAAA;EACA,gBAAA;EACA,KAAA;AAAA;AAAA,UAEe,cAAA;EAAA,SACN,MAAA,EAAQ,sBAAA;EAAA,SACR,WAAA;EAAA,SACA,QAAA;EAAA,SACA,iBAAA;EAAA,SACA,gBAAA;EAAA,SACA,KAAA;AAAA;;iBAIK,qBAAA,CACd,OAAA,GAAS,oBAAA,EACT,WAAA,GAAa,MAAA,CAAO,UAAA,GACnB,cAAA"}

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

@@ -0,0 +1,27 @@
+
+import { CopilotKitIntelligence } from "../client.mjs";
+
+//#region src/v2/runtime/intelligence-platform/skill-registry/config.d.ts
+interface SkillRegistryOptions {
+  client?: CopilotKitIntelligence;
+  apiKey?: string;
+  apiUrl?: string;
+  containerId?: string;
+  revision?: string;
+  freshnessWindowMs?: number;
+  requestTimeoutMs?: number;
+  debug?: boolean;
+}
+interface RegistryConfig {
+  readonly client: CopilotKitIntelligence;
+  readonly containerId: string;
+  readonly revision?: string;
+  readonly freshnessWindowMs: number;
+  readonly requestTimeoutMs: number;
+  readonly debug: boolean;
+}
+/** Resolve once. Never retain the options object, environment, or a second key. */
+declare function resolveRegistryConfig(options?: SkillRegistryOptions, environment?: NodeJS.ProcessEnv): RegistryConfig;
+//#endregion
+export { RegistryConfig, SkillRegistryOptions, resolveRegistryConfig };
+//# sourceMappingURL=config.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.mts","names":[],"sources":["../../../../../src/v2/runtime/intelligence-platform/skill-registry/config.ts"],"mappings":";;;;UAGiB,oBAAA;EACf,MAAA,GAAS,sBAAA;EACT,MAAA;EACA,MAAA;EACA,WAAA;EACA,QAAA;EACA,iBAAA;EACA,gBAAA;EACA,KAAA;AAAA;AAAA,UAEe,cAAA;EAAA,SACN,MAAA,EAAQ,sBAAA;EAAA,SACR,WAAA;EAAA,SACA,QAAA;EAAA,SACA,iBAAA;EAAA,SACA,gBAAA;EAAA,SACA,KAAA;AAAA;;iBAIK,qBAAA,CACd,OAAA,GAAS,oBAAA,EACT,WAAA,GAAa,MAAA,CAAO,UAAA,GACnB,cAAA"}

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

@@ -0,0 +1,48 @@
+import "reflect-metadata";
+import { LearnedSkillsError } from "../learned-skills.mjs";
+import { CopilotKitIntelligence } from "../client.mjs";
+
+//#region src/v2/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 containerId = options.containerId ?? environment.CPK_INTELLIGENCE_LEARNING_CONTAINER_ID;
+		const revision = options.revision ?? environment.CPK_INTELLIGENCE_SKILLS_REVISION;
+		const freshnessWindowMs = options.freshnessWindowMs ?? 5e3;
+		const requestTimeoutMs = options.requestTimeoutMs ?? 5e3;
+		const debug = options.debug ?? false;
+		if (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 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,
+			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/v2/runtime/intelligence-platform/skill-registry/config.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.mjs","names":["SkillDeliveryError"],"sources":["../../../../../src/v2/runtime/intelligence-platform/skill-registry/config.ts"],"sourcesContent":["import { CopilotKitIntelligence } from \"../client\";\nimport { SkillDeliveryError } from \"./errors\";\n\nexport interface SkillRegistryOptions {\n  client?: CopilotKitIntelligence;\n  apiKey?: string;\n  apiUrl?: string;\n  containerId?: string;\n  revision?: string;\n  freshnessWindowMs?: number;\n  requestTimeoutMs?: number;\n  debug?: boolean;\n}\nexport interface RegistryConfig {\n  readonly client: CopilotKitIntelligence;\n  readonly containerId: string;\n  readonly revision?: string;\n  readonly freshnessWindowMs: number;\n  readonly requestTimeoutMs: number;\n  readonly debug: boolean;\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 containerId =\n      options.containerId ?? environment.CPK_INTELLIGENCE_LEARNING_CONTAINER_ID;\n    const revision =\n      options.revision ?? environment.CPK_INTELLIGENCE_SKILLS_REVISION;\n    const freshnessWindowMs = options.freshnessWindowMs ?? 5_000;\n    const requestTimeoutMs = options.requestTimeoutMs ?? 5_000;\n    const debug = options.debug ?? false;\n    if (\n      typeof containerId !== \"string\" ||\n      !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 (!client || typeof client.getLearnedSkillsSnapshot !== \"function\")\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      containerId,\n      ...(revision !== undefined ? { revision } : {}),\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":";;;;;;AAuBA,SAAgB,sBACd,UAAgC,EAAE,EAClC,cAAiC,QAAQ,KACzB;AAChB,KAAI;EACF,MAAM,cACJ,QAAQ,eAAe,YAAY;EACrC,MAAM,WACJ,QAAQ,YAAY,YAAY;EAClC,MAAM,oBAAoB,QAAQ,qBAAqB;EACvD,MAAM,mBAAmB,QAAQ,oBAAoB;EACrD,MAAM,QAAQ,QAAQ,SAAS;AAC/B,MACE,OAAO,gBAAgB,YACvB,CAAC,YAAY,MAAM,IAClB,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;OAAI,CAAC,UAAU,OAAO,OAAO,6BAA6B,WACxD,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;GACA,GAAI,aAAa,SAAY,EAAE,UAAU,GAAG,EAAE;GAC9C;GACA;GACA;GACD,CAAC;UACK,OAAO;AACd,MAAI,iBAAiBA,mBAAoB,OAAM;AAC/C,QAAM,IAAIA,mBAAmB,kBAAkB,OAAO,MAAM"}

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

@@ -0,0 +1,11 @@
+require("reflect-metadata");
+const require_learned_skills = require('../learned-skills.cjs');
+
+//#region src/v2/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/v2/runtime/intelligence-platform/skill-registry/errors.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.cjs","names":["LearnedSkillsError"],"sources":["../../../../../src/v2/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/v2/runtime/intelligence-platform/skill-registry/errors.d.cts

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

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

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

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

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

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

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

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

@@ -0,0 +1,11 @@
+import "reflect-metadata";
+import { LearnedSkillsError } from "../learned-skills.mjs";
+
+//#region src/v2/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/v2/runtime/intelligence-platform/skill-registry/errors.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.mjs","names":[],"sources":["../../../../../src/v2/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/v2/runtime/intelligence-platform/skill-registry/index.d.cts

@@ -0,0 +1,8 @@
+
+import { MAX_ARCHIVE_ENTRIES, MAX_SNAPSHOT_BYTES, readArchive, safeRelativePath } from "./archive.cjs";
+import { LearnedSkillsError, LearnedSkillsErrorCode } from "../learned-skills.cjs";
+import { RegistryConfig, 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/v2/runtime/intelligence-platform/skill-registry/index.d.mts

@@ -0,0 +1,8 @@
+
+import { MAX_ARCHIVE_ENTRIES, MAX_SNAPSHOT_BYTES, readArchive, safeRelativePath } from "./archive.mjs";
+import { LearnedSkillsError, LearnedSkillsErrorCode } from "../learned-skills.mjs";
+import { RegistryConfig, 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/v2/runtime/intelligence-platform/skill-registry/registry.cjs

@@ -0,0 +1,132 @@
+require("reflect-metadata");
+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');
+
+//#region src/v2/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 SkillRegistry = class {
+	#config;
+	#snapshot;
+	#inFlight;
+	#lastCheckedAt;
+	#stale = false;
+	#lastError;
+	#blocked;
+	constructor(options = {}) {
+		this.#config = require_config.resolveRegistryConfig(options);
+	}
+	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.#config.client.getLearnedSkillsSnapshot({
+				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 } : {}
+		});
+	}
+};
+
+//#endregion
+exports.SkillRegistry = SkillRegistry;
+//# sourceMappingURL=registry.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.cjs","names":["SkillDeliveryError","#config","resolveRegistryConfig","#inFlight","#snapshot","#blocked","#lastCheckedAt","#refresh","#lastError","#stale","invalidSnapshot","validateSnapshot","#debug"],"sources":["../../../../../src/v2/runtime/intelligence-platform/skill-registry/registry.ts"],"sourcesContent":["import { resolveRegistryConfig } from \"./config\";\nimport type { RegistryConfig, 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  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. */\nexport class SkillRegistry {\n  readonly #config: RegistryConfig;\n  #snapshot?: VerifiedSnapshot;\n  #inFlight?: Promise<VerifiedSnapshot>;\n  #lastCheckedAt?: number;\n  #stale = false;\n  #lastError?: SkillDeliveryError;\n  #blocked?: SkillDeliveryError;\n\n  constructor(options: SkillRegistryOptions = {}) {\n    this.#config = resolveRegistryConfig(options);\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.#config.client.getLearnedSkillsSnapshot({\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"],"mappings":"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"}