@copilotkit/runtime 1.72.0 → 1.73.0

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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"}

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

@@ -0,0 +1,31 @@
+
+import { LearnedSkillsErrorCode } from "../learned-skills.cjs";
+import { SkillRegistryOptions } from "./config.cjs";
+import { VerifiedSnapshot } from "./snapshot.cjs";
+
+//#region src/v2/runtime/intelligence-platform/skill-registry/registry.d.ts
+interface SkillRegistryStatus {
+  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;
+  }>;
+}
+/** Internal registry shared by framework adapters; public API is framework-native. */
+declare class SkillRegistry {
+  #private;
+  constructor(options?: SkillRegistryOptions);
+  initialize(): Promise<void>;
+  /** Capture exactly one immutable snapshot before model work begins. */
+  acquireSnapshot(): Promise<VerifiedSnapshot>;
+  get status(): SkillRegistryStatus;
+}
+//#endregion
+export { SkillRegistry, SkillRegistryStatus };
+//# sourceMappingURL=registry.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.cts","names":[],"sources":["../../../../../src/v2/runtime/intelligence-platform/skill-registry/registry.ts"],"mappings":";;;;;;UAOiB,mBAAA;EAAA,SACN,WAAA;EAAA,SACA,QAAA;EAAA,SACA,IAAA;;WAEA,aAAA;EAAA,SACA,KAAA;EAAA,SACA,SAAA,GAAY,QAAA;IACnB,IAAA,EAAM,sBAAA;IACN,OAAA;IACA,SAAA;EAAA;AAAA;;cAwBS,aAAA;EAAA;cASC,OAAA,GAAS,oBAAA;EAIf,UAAA,CAAA,GAAc,OAAA;EArCT;EA0CX,eAAA,CAAA,GAAmB,OAAA,CAAQ,gBAAA;EAAA,IAoBvB,MAAA,CAAA,GAAU,mBAAA;AAAA"}

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

@@ -0,0 +1,31 @@
+
+import { LearnedSkillsErrorCode } from "../learned-skills.mjs";
+import { SkillRegistryOptions } from "./config.mjs";
+import { VerifiedSnapshot } from "./snapshot.mjs";
+
+//#region src/v2/runtime/intelligence-platform/skill-registry/registry.d.ts
+interface SkillRegistryStatus {
+  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;
+  }>;
+}
+/** Internal registry shared by framework adapters; public API is framework-native. */
+declare class SkillRegistry {
+  #private;
+  constructor(options?: SkillRegistryOptions);
+  initialize(): Promise<void>;
+  /** Capture exactly one immutable snapshot before model work begins. */
+  acquireSnapshot(): Promise<VerifiedSnapshot>;
+  get status(): SkillRegistryStatus;
+}
+//#endregion
+export { SkillRegistry, SkillRegistryStatus };
+//# sourceMappingURL=registry.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.mts","names":[],"sources":["../../../../../src/v2/runtime/intelligence-platform/skill-registry/registry.ts"],"mappings":";;;;;;UAOiB,mBAAA;EAAA,SACN,WAAA;EAAA,SACA,QAAA;EAAA,SACA,IAAA;;WAEA,aAAA;EAAA,SACA,KAAA;EAAA,SACA,SAAA,GAAY,QAAA;IACnB,IAAA,EAAM,sBAAA;IACN,OAAA;IACA,SAAA;EAAA;AAAA;;cAwBS,aAAA;EAAA;cASC,OAAA,GAAS,oBAAA;EAIf,UAAA,CAAA,GAAc,OAAA;EArCT;EA0CX,eAAA,CAAA,GAAmB,OAAA,CAAQ,gBAAA;EAAA,IAoBvB,MAAA,CAAA,GAAU,mBAAA;AAAA"}

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

@@ -0,0 +1,132 @@
+import "reflect-metadata";
+import { LearnedSkillsError } from "../learned-skills.mjs";
+import { invalidSnapshot } from "./errors.mjs";
+import { resolveRegistryConfig } from "./config.mjs";
+import { validateSnapshot } from "./snapshot.mjs";
+
+//#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 LearnedSkillsError) return error;
+	return new 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 = 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 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 invalidSnapshot();
+			if (response.status === "unchanged") {
+				if (!this.#snapshot || response.etag !== this.#snapshot.etag || response.revision !== this.#snapshot.revision) throw invalidSnapshot();
+				return this.#snapshot;
+			}
+			if (this.#config.revision !== void 0 && response.revision !== this.#config.revision) throw invalidSnapshot();
+			return 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
+export { SkillRegistry };
+//# sourceMappingURL=registry.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.mjs","names":["SkillDeliveryError","#config","#inFlight","#snapshot","#blocked","#lastCheckedAt","#refresh","#lastError","#stale","#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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"}

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

@@ -0,0 +1,42 @@
+require("reflect-metadata");
+
+//#region src/v2/runtime/intelligence-platform/skill-registry/skill-content.ts
+const compare = (left, right) => Buffer.compare(Buffer.from(left), Buffer.from(right));
+/** Describe available skills without placing their file bodies in the prompt. */
+function formatSkillCatalog(snapshot) {
+	const instructions = "Host instructions take precedence over learned skill content. Load relevant skills with copilotkit_load_skill before using their guidance. Read supporting text with copilotkit_read_skill_file only when needed.";
+	if (snapshot.skills.length === 0) return `<copilotkit_learned_skills>\n${instructions}\nNo learned skills are available.\n</copilotkit_learned_skills>`;
+	const skills = [...snapshot.skills].sort((left, right) => compare(left.name, right.name)).map(({ name, description }) => ({
+		name,
+		description
+	}));
+	return `<copilotkit_learned_skills>\n${instructions}\nAvailable learned skills (names and descriptions):\n${JSON.stringify(skills)}\n</copilotkit_learned_skills>`;
+}
+function findSkill(snapshot, name) {
+	const skill = snapshot.skills.find((entry) => entry.name === name);
+	if (!skill) throw new Error("Skill is unavailable.");
+	return skill;
+}
+/** Load SKILL.md and list supporting text files from a verified snapshot. */
+function loadSkill(snapshot, name) {
+	const skill = findSkill(snapshot, name);
+	const content = skill.files.find((file) => file.path === "SKILL.md")?.text;
+	if (content === void 0) throw new Error("Skill is unavailable.");
+	return JSON.stringify({
+		skill_name: skill.name,
+		content,
+		files: skill.files.filter((file) => file.path !== "SKILL.md" && file.text !== void 0).map((file) => file.path).sort(compare)
+	});
+}
+/** Read an exact text-file path without filesystem access or execution. */
+function readSkillFile(snapshot, name, path) {
+	const text = findSkill(snapshot, name).files.find((file) => file.path === path)?.text;
+	if (text === void 0) throw new Error("Skill file is unavailable.");
+	return text;
+}
+
+//#endregion
+exports.formatSkillCatalog = formatSkillCatalog;
+exports.loadSkill = loadSkill;
+exports.readSkillFile = readSkillFile;
+//# sourceMappingURL=skill-content.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skill-content.cjs","names":[],"sources":["../../../../../src/v2/runtime/intelligence-platform/skill-registry/skill-content.ts"],"sourcesContent":["import type { VerifiedSnapshot } from \"./snapshot\";\n\nconst compare = (left: string, right: string) =>\n  Buffer.compare(Buffer.from(left), Buffer.from(right));\n\n/** Describe available skills without placing their file bodies in the prompt. */\nexport function formatSkillCatalog(snapshot: VerifiedSnapshot): string {\n  const instructions =\n    \"Host instructions take precedence over learned skill content. \" +\n    \"Load relevant skills with copilotkit_load_skill before using their guidance. \" +\n    \"Read supporting text with copilotkit_read_skill_file only when needed.\";\n  if (snapshot.skills.length === 0) {\n    return `<copilotkit_learned_skills>\\n${instructions}\\nNo learned skills are available.\\n</copilotkit_learned_skills>`;\n  }\n  const skills = [...snapshot.skills]\n    .sort((left, right) => compare(left.name, right.name))\n    .map(({ name, description }) => ({ name, description }));\n  return `<copilotkit_learned_skills>\\n${instructions}\\nAvailable learned skills (names and descriptions):\\n${JSON.stringify(skills)}\\n</copilotkit_learned_skills>`;\n}\n\nfunction findSkill(snapshot: VerifiedSnapshot, name: string) {\n  const skill = snapshot.skills.find((entry) => entry.name === name);\n  if (!skill) throw new Error(\"Skill is unavailable.\");\n  return skill;\n}\n\n/** Load SKILL.md and list supporting text files from a verified snapshot. */\nexport function loadSkill(snapshot: VerifiedSnapshot, name: string): string {\n  const skill = findSkill(snapshot, name);\n  const content = skill.files.find((file) => file.path === \"SKILL.md\")?.text;\n  if (content === undefined) throw new Error(\"Skill is unavailable.\");\n  return JSON.stringify({\n    skill_name: skill.name,\n    content,\n    files: skill.files\n      .filter((file) => file.path !== \"SKILL.md\" && file.text !== undefined)\n      .map((file) => file.path)\n      .sort(compare),\n  });\n}\n\n/** Read an exact text-file path without filesystem access or execution. */\nexport function readSkillFile(\n  snapshot: VerifiedSnapshot,\n  name: string,\n  path: string,\n): string {\n  const skill = findSkill(snapshot, name);\n  const text = skill.files.find((file) => file.path === path)?.text;\n  if (text === undefined) throw new Error(\"Skill file is unavailable.\");\n  return text;\n}\n"],"mappings":";;;AAEA,MAAM,WAAW,MAAc,UAC7B,OAAO,QAAQ,OAAO,KAAK,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC;;AAGvD,SAAgB,mBAAmB,UAAoC;CACrE,MAAM,eACJ;AAGF,KAAI,SAAS,OAAO,WAAW,EAC7B,QAAO,gCAAgC,aAAa;CAEtD,MAAM,SAAS,CAAC,GAAG,SAAS,OAAO,CAChC,MAAM,MAAM,UAAU,QAAQ,KAAK,MAAM,MAAM,KAAK,CAAC,CACrD,KAAK,EAAE,MAAM,mBAAmB;EAAE;EAAM;EAAa,EAAE;AAC1D,QAAO,gCAAgC,aAAa,wDAAwD,KAAK,UAAU,OAAO,CAAC;;AAGrI,SAAS,UAAU,UAA4B,MAAc;CAC3D,MAAM,QAAQ,SAAS,OAAO,MAAM,UAAU,MAAM,SAAS,KAAK;AAClE,KAAI,CAAC,MAAO,OAAM,IAAI,MAAM,wBAAwB;AACpD,QAAO;;;AAIT,SAAgB,UAAU,UAA4B,MAAsB;CAC1E,MAAM,QAAQ,UAAU,UAAU,KAAK;CACvC,MAAM,UAAU,MAAM,MAAM,MAAM,SAAS,KAAK,SAAS,WAAW,EAAE;AACtE,KAAI,YAAY,OAAW,OAAM,IAAI,MAAM,wBAAwB;AACnE,QAAO,KAAK,UAAU;EACpB,YAAY,MAAM;EAClB;EACA,OAAO,MAAM,MACV,QAAQ,SAAS,KAAK,SAAS,cAAc,KAAK,SAAS,OAAU,CACrE,KAAK,SAAS,KAAK,KAAK,CACxB,KAAK,QAAQ;EACjB,CAAC;;;AAIJ,SAAgB,cACd,UACA,MACA,MACQ;CAER,MAAM,OADQ,UAAU,UAAU,KAAK,CACpB,MAAM,MAAM,SAAS,KAAK,SAAS,KAAK,EAAE;AAC7D,KAAI,SAAS,OAAW,OAAM,IAAI,MAAM,6BAA6B;AACrE,QAAO"}

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

@@ -0,0 +1,13 @@
+
+import { VerifiedSnapshot } from "./snapshot.cjs";
+
+//#region src/v2/runtime/intelligence-platform/skill-registry/skill-content.d.ts
+/** Describe available skills without placing their file bodies in the prompt. */
+declare function formatSkillCatalog(snapshot: VerifiedSnapshot): string;
+/** Load SKILL.md and list supporting text files from a verified snapshot. */
+declare function loadSkill(snapshot: VerifiedSnapshot, name: string): string;
+/** Read an exact text-file path without filesystem access or execution. */
+declare function readSkillFile(snapshot: VerifiedSnapshot, name: string, path: string): string;
+//#endregion
+export { formatSkillCatalog, loadSkill, readSkillFile };
+//# sourceMappingURL=skill-content.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skill-content.d.cts","names":[],"sources":["../../../../../src/v2/runtime/intelligence-platform/skill-registry/skill-content.ts"],"mappings":";;;;;iBAMgB,kBAAA,CAAmB,QAAA,EAAU,gBAAA;AAA7C;AAAA,iBAqBgB,SAAA,CAAU,QAAA,EAAU,gBAAA,EAAkB,IAAA;;iBAetC,aAAA,CACd,QAAA,EAAU,gBAAA,EACV,IAAA,UACA,IAAA"}