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

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

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

@@ -0,0 +1,13 @@
+
+import { VerifiedSnapshot } from "./snapshot.mjs";
+
+//#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.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skill-content.d.mts","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"}

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

@@ -0,0 +1,39 @@
+import "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
+export { formatSkillCatalog, loadSkill, readSkillFile };
+//# sourceMappingURL=skill-content.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skill-content.mjs","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/snapshot.cjs

@@ -0,0 +1,93 @@
+require("reflect-metadata");
+const require_runtime = require('../../../../_virtual/_rolldown/runtime.cjs');
+const require_learned_skills = require('../learned-skills.cjs');
+const require_errors = require('./errors.cjs');
+const require_archive = require('./archive.cjs');
+let node_crypto = require("node:crypto");
+
+//#region src/v2/runtime/intelligence-platform/skill-registry/snapshot.ts
+function object(value) {
+	return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function sha256(bytes) {
+	return (0, node_crypto.createHash)("sha256").update(bytes).digest("hex");
+}
+function utf8(bytes) {
+	try {
+		return new TextDecoder("utf-8", {
+			fatal: true,
+			ignoreBOM: true
+		}).decode(bytes);
+	} catch {
+		return;
+	}
+}
+/** Validate a replacement fully before it can become an invocation snapshot. */
+async function validateSnapshot(response, signal) {
+	try {
+		if (!object(response) || !(response.bytes instanceof Uint8Array) || typeof response.revision !== "string" || typeof response.etag !== "string" || typeof response.contentType !== "string") throw require_errors.invalidSnapshot();
+		const { revision, etag, contentType } = response;
+		if (response.status !== "snapshot" || response.bytes.byteLength > require_archive.MAX_SNAPSHOT_BYTES || contentType.split(";", 1)[0]?.trim().toLowerCase() !== "application/zip" || !revision || !/^"[a-f0-9]{64}"$/.test(etag)) throw require_errors.invalidSnapshot();
+		const bytes = Buffer.from(response.bytes);
+		if (`"${sha256(bytes)}"` !== etag) throw require_errors.invalidSnapshot();
+		const archive = await require_archive.readArchive(bytes, signal);
+		const manifestBytes = archive.get("manifest.json");
+		if (!manifestBytes) throw require_errors.invalidSnapshot();
+		const decoded = utf8(manifestBytes);
+		if (decoded === void 0) throw require_errors.invalidSnapshot();
+		const manifest = JSON.parse(decoded);
+		if (!object(manifest)) throw require_errors.invalidSnapshot();
+		if (typeof manifest.schemaVersion === "number" && manifest.schemaVersion !== 1) throw new require_learned_skills.LearnedSkillsError("UNSUPPORTED_SERVER", false);
+		if (manifest.schemaVersion !== 1 || manifest.revision !== revision || !Array.isArray(manifest.skills)) throw require_errors.invalidSnapshot();
+		const expected = new Set(["manifest.json"]);
+		let previousName;
+		const skills = [];
+		for (const skill of manifest.skills) {
+			if (!object(skill) || typeof skill.name !== "string" || !require_archive.safeRelativePath(skill.name) || skill.name.includes("/") || previousName !== void 0 && Buffer.compare(Buffer.from(previousName), Buffer.from(skill.name)) >= 0 || typeof skill.description !== "string" || !Array.isArray(skill.files)) throw require_errors.invalidSnapshot();
+			previousName = skill.name;
+			let previousPath;
+			let hasSkill = false;
+			const files = [];
+			for (const file of skill.files) {
+				if (!object(file) || typeof file.path !== "string" || !require_archive.safeRelativePath(file.path) || previousPath !== void 0 && Buffer.compare(Buffer.from(previousPath), Buffer.from(file.path)) >= 0 || typeof file.size !== "number" || !Number.isSafeInteger(file.size) || file.size < 0 || typeof file.sha256 !== "string" || !/^[a-f0-9]{64}$/.test(file.sha256)) throw require_errors.invalidSnapshot();
+				previousPath = file.path;
+				const path = `${skill.name}/${file.path}`;
+				if (expected.has(path)) throw require_errors.invalidSnapshot();
+				expected.add(path);
+				const content = archive.get(path);
+				if (!content || content.length !== file.size || sha256(content) !== file.sha256) throw require_errors.invalidSnapshot();
+				const text = utf8(content);
+				if (file.path === "SKILL.md") {
+					if (text === void 0) throw require_errors.invalidSnapshot();
+					hasSkill = true;
+				}
+				files.push(Object.freeze({
+					path: file.path,
+					size: file.size,
+					sha256: file.sha256,
+					...text !== void 0 ? { text } : {}
+				}));
+			}
+			if (!hasSkill) throw require_errors.invalidSnapshot();
+			skills.push(Object.freeze({
+				name: skill.name,
+				description: skill.description,
+				files: Object.freeze(files)
+			}));
+		}
+		if (expected.size !== archive.size || [...archive.keys()].some((path) => !expected.has(path))) throw require_errors.invalidSnapshot();
+		return Object.freeze({
+			revision,
+			etag,
+			skills: Object.freeze(skills)
+		});
+	} catch (error) {
+		if (signal?.aborted) throw signal.reason;
+		if (error instanceof require_learned_skills.LearnedSkillsError) throw error;
+		throw require_errors.invalidSnapshot(error);
+	}
+}
+
+//#endregion
+exports.validateSnapshot = validateSnapshot;
+//# sourceMappingURL=snapshot.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.cjs","names":["invalidSnapshot","MAX_SNAPSHOT_BYTES","readArchive","SkillDeliveryError","safeRelativePath"],"sources":["../../../../../src/v2/runtime/intelligence-platform/skill-registry/snapshot.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\nimport type { LearnedSkillsSnapshotResult } from \"../learned-skills\";\nimport { SkillDeliveryError, invalidSnapshot } from \"./errors\";\nimport { MAX_SNAPSHOT_BYTES, readArchive, safeRelativePath } from \"./archive\";\n\nexport interface SnapshotFile {\n  readonly path: string;\n  readonly size: number;\n  readonly sha256: string;\n  /** Absent for supporting resources that cannot be decoded as UTF-8 text. */\n  readonly text?: string;\n}\nexport interface SnapshotSkill {\n  readonly name: string;\n  readonly description: string;\n  readonly files: readonly SnapshotFile[];\n}\nexport interface VerifiedSnapshot {\n  readonly revision: string;\n  readonly etag: string;\n  readonly skills: readonly SnapshotSkill[];\n}\n\nfunction object(value: unknown): value is Record<string, unknown> {\n  return value !== null && typeof value === \"object\" && !Array.isArray(value);\n}\nfunction sha256(bytes: Uint8Array): string {\n  return createHash(\"sha256\").update(bytes).digest(\"hex\");\n}\nfunction utf8(bytes: Uint8Array): string | undefined {\n  try {\n    return new TextDecoder(\"utf-8\", { fatal: true, ignoreBOM: true }).decode(\n      bytes,\n    );\n  } catch {\n    return undefined;\n  }\n}\n\n/** Validate a replacement fully before it can become an invocation snapshot. */\nexport async function validateSnapshot(\n  response: Extract<LearnedSkillsSnapshotResult, { status: \"snapshot\" }>,\n  signal?: AbortSignal,\n): Promise<VerifiedSnapshot> {\n  try {\n    if (\n      !object(response) ||\n      !(response.bytes instanceof Uint8Array) ||\n      typeof response.revision !== \"string\" ||\n      typeof response.etag !== \"string\" ||\n      typeof response.contentType !== \"string\"\n    )\n      throw invalidSnapshot();\n    const { revision, etag, contentType } = response;\n    if (\n      response.status !== \"snapshot\" ||\n      response.bytes.byteLength > MAX_SNAPSHOT_BYTES ||\n      contentType.split(\";\", 1)[0]?.trim().toLowerCase() !==\n        \"application/zip\" ||\n      !revision ||\n      !/^\"[a-f0-9]{64}\"$/.test(etag)\n    )\n      throw invalidSnapshot();\n    // Own the bytes before asynchronous decompression so an injected client\n    // cannot mutate an in-flight replacement after its digest is checked.\n    const bytes = Buffer.from(response.bytes);\n    if (`\"${sha256(bytes)}\"` !== etag) throw invalidSnapshot();\n    const archive = await readArchive(bytes, signal);\n    const manifestBytes = archive.get(\"manifest.json\");\n    if (!manifestBytes) throw invalidSnapshot();\n    const decoded = utf8(manifestBytes);\n    if (decoded === undefined) throw invalidSnapshot();\n    const manifest: unknown = JSON.parse(decoded);\n    if (!object(manifest)) throw invalidSnapshot();\n    if (\n      typeof manifest.schemaVersion === \"number\" &&\n      manifest.schemaVersion !== 1\n    )\n      throw new SkillDeliveryError(\"UNSUPPORTED_SERVER\", false);\n    if (\n      manifest.schemaVersion !== 1 ||\n      manifest.revision !== revision ||\n      !Array.isArray(manifest.skills)\n    )\n      throw invalidSnapshot();\n    const expected = new Set([\"manifest.json\"]);\n    let previousName: string | undefined;\n    const skills: SnapshotSkill[] = [];\n    for (const skill of manifest.skills) {\n      if (\n        !object(skill) ||\n        typeof skill.name !== \"string\" ||\n        !safeRelativePath(skill.name) ||\n        skill.name.includes(\"/\") ||\n        (previousName !== undefined &&\n          Buffer.compare(Buffer.from(previousName), Buffer.from(skill.name)) >=\n            0) ||\n        typeof skill.description !== \"string\" ||\n        !Array.isArray(skill.files)\n      )\n        throw invalidSnapshot();\n      previousName = skill.name;\n      let previousPath: string | undefined;\n      let hasSkill = false;\n      const files: SnapshotFile[] = [];\n      for (const file of skill.files) {\n        if (\n          !object(file) ||\n          typeof file.path !== \"string\" ||\n          !safeRelativePath(file.path) ||\n          (previousPath !== undefined &&\n            Buffer.compare(Buffer.from(previousPath), Buffer.from(file.path)) >=\n              0) ||\n          typeof file.size !== \"number\" ||\n          !Number.isSafeInteger(file.size) ||\n          file.size < 0 ||\n          typeof file.sha256 !== \"string\" ||\n          !/^[a-f0-9]{64}$/.test(file.sha256)\n        )\n          throw invalidSnapshot();\n        previousPath = file.path;\n        const path = `${skill.name}/${file.path}`;\n        if (expected.has(path)) throw invalidSnapshot();\n        expected.add(path);\n        const content = archive.get(path);\n        if (\n          !content ||\n          content.length !== file.size ||\n          sha256(content) !== file.sha256\n        )\n          throw invalidSnapshot();\n        const text = utf8(content);\n        if (file.path === \"SKILL.md\") {\n          if (text === undefined) throw invalidSnapshot();\n          hasSkill = true;\n        }\n        files.push(\n          Object.freeze({\n            path: file.path,\n            size: file.size,\n            sha256: file.sha256,\n            ...(text !== undefined ? { text } : {}),\n          }),\n        );\n      }\n      if (!hasSkill) throw invalidSnapshot();\n      skills.push(\n        Object.freeze({\n          name: skill.name,\n          description: skill.description,\n          files: Object.freeze(files),\n        }),\n      );\n    }\n    if (\n      expected.size !== archive.size ||\n      [...archive.keys()].some((path) => !expected.has(path))\n    )\n      throw invalidSnapshot();\n    return Object.freeze({\n      revision: revision,\n      etag: etag,\n      skills: Object.freeze(skills),\n    });\n  } catch (error) {\n    if (signal?.aborted) throw signal.reason;\n    if (error instanceof SkillDeliveryError) throw error;\n    throw invalidSnapshot(error);\n  }\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,28 @@
+
+import { LearnedSkillsSnapshotResult } from "../learned-skills.cjs";
+
+//#region src/v2/runtime/intelligence-platform/skill-registry/snapshot.d.ts
+interface SnapshotFile {
+  readonly path: string;
+  readonly size: number;
+  readonly sha256: string;
+  /** Absent for supporting resources that cannot be decoded as UTF-8 text. */
+  readonly text?: string;
+}
+interface SnapshotSkill {
+  readonly name: string;
+  readonly description: string;
+  readonly files: readonly SnapshotFile[];
+}
+interface VerifiedSnapshot {
+  readonly revision: string;
+  readonly etag: string;
+  readonly skills: readonly SnapshotSkill[];
+}
+/** Validate a replacement fully before it can become an invocation snapshot. */
+declare function validateSnapshot(response: Extract<LearnedSkillsSnapshotResult, {
+  status: "snapshot";
+}>, signal?: AbortSignal): Promise<VerifiedSnapshot>;
+//#endregion
+export { SnapshotFile, SnapshotSkill, VerifiedSnapshot, validateSnapshot };
+//# sourceMappingURL=snapshot.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.cts","names":[],"sources":["../../../../../src/v2/runtime/intelligence-platform/skill-registry/snapshot.ts"],"mappings":";;;;UAKiB,YAAA;EAAA,SACN,IAAA;EAAA,SACA,IAAA;EAAA,SACA,MAAA;;WAEA,IAAA;AAAA;AAAA,UAEM,aAAA;EAAA,SACN,IAAA;EAAA,SACA,WAAA;EAAA,SACA,KAAA,WAAgB,YAAA;AAAA;AAAA,UAEV,gBAAA;EAAA,SACN,QAAA;EAAA,SACA,IAAA;EAAA,SACA,MAAA,WAAiB,aAAA;AAAA;;iBAoBN,gBAAA,CACpB,QAAA,EAAU,OAAA,CAAQ,2BAAA;EAA+B,MAAA;AAAA,IACjD,MAAA,GAAS,WAAA,GACR,OAAA,CAAQ,gBAAA"}

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

@@ -0,0 +1,28 @@
+
+import { LearnedSkillsSnapshotResult } from "../learned-skills.mjs";
+
+//#region src/v2/runtime/intelligence-platform/skill-registry/snapshot.d.ts
+interface SnapshotFile {
+  readonly path: string;
+  readonly size: number;
+  readonly sha256: string;
+  /** Absent for supporting resources that cannot be decoded as UTF-8 text. */
+  readonly text?: string;
+}
+interface SnapshotSkill {
+  readonly name: string;
+  readonly description: string;
+  readonly files: readonly SnapshotFile[];
+}
+interface VerifiedSnapshot {
+  readonly revision: string;
+  readonly etag: string;
+  readonly skills: readonly SnapshotSkill[];
+}
+/** Validate a replacement fully before it can become an invocation snapshot. */
+declare function validateSnapshot(response: Extract<LearnedSkillsSnapshotResult, {
+  status: "snapshot";
+}>, signal?: AbortSignal): Promise<VerifiedSnapshot>;
+//#endregion
+export { SnapshotFile, SnapshotSkill, VerifiedSnapshot, validateSnapshot };
+//# sourceMappingURL=snapshot.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.mts","names":[],"sources":["../../../../../src/v2/runtime/intelligence-platform/skill-registry/snapshot.ts"],"mappings":";;;;UAKiB,YAAA;EAAA,SACN,IAAA;EAAA,SACA,IAAA;EAAA,SACA,MAAA;;WAEA,IAAA;AAAA;AAAA,UAEM,aAAA;EAAA,SACN,IAAA;EAAA,SACA,WAAA;EAAA,SACA,KAAA,WAAgB,YAAA;AAAA;AAAA,UAEV,gBAAA;EAAA,SACN,QAAA;EAAA,SACA,IAAA;EAAA,SACA,MAAA,WAAiB,aAAA;AAAA;;iBAoBN,gBAAA,CACpB,QAAA,EAAU,OAAA,CAAQ,2BAAA;EAA+B,MAAA;AAAA,IACjD,MAAA,GAAS,WAAA,GACR,OAAA,CAAQ,gBAAA"}

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

@@ -0,0 +1,92 @@
+import "reflect-metadata";
+import { LearnedSkillsError } from "../learned-skills.mjs";
+import { invalidSnapshot } from "./errors.mjs";
+import { MAX_SNAPSHOT_BYTES, readArchive, safeRelativePath } from "./archive.mjs";
+import { createHash } from "node:crypto";
+
+//#region src/v2/runtime/intelligence-platform/skill-registry/snapshot.ts
+function object(value) {
+	return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function sha256(bytes) {
+	return createHash("sha256").update(bytes).digest("hex");
+}
+function utf8(bytes) {
+	try {
+		return new TextDecoder("utf-8", {
+			fatal: true,
+			ignoreBOM: true
+		}).decode(bytes);
+	} catch {
+		return;
+	}
+}
+/** Validate a replacement fully before it can become an invocation snapshot. */
+async function validateSnapshot(response, signal) {
+	try {
+		if (!object(response) || !(response.bytes instanceof Uint8Array) || typeof response.revision !== "string" || typeof response.etag !== "string" || typeof response.contentType !== "string") throw invalidSnapshot();
+		const { revision, etag, contentType } = response;
+		if (response.status !== "snapshot" || response.bytes.byteLength > MAX_SNAPSHOT_BYTES || contentType.split(";", 1)[0]?.trim().toLowerCase() !== "application/zip" || !revision || !/^"[a-f0-9]{64}"$/.test(etag)) throw invalidSnapshot();
+		const bytes = Buffer.from(response.bytes);
+		if (`"${sha256(bytes)}"` !== etag) throw invalidSnapshot();
+		const archive = await readArchive(bytes, signal);
+		const manifestBytes = archive.get("manifest.json");
+		if (!manifestBytes) throw invalidSnapshot();
+		const decoded = utf8(manifestBytes);
+		if (decoded === void 0) throw invalidSnapshot();
+		const manifest = JSON.parse(decoded);
+		if (!object(manifest)) throw invalidSnapshot();
+		if (typeof manifest.schemaVersion === "number" && manifest.schemaVersion !== 1) throw new LearnedSkillsError("UNSUPPORTED_SERVER", false);
+		if (manifest.schemaVersion !== 1 || manifest.revision !== revision || !Array.isArray(manifest.skills)) throw invalidSnapshot();
+		const expected = new Set(["manifest.json"]);
+		let previousName;
+		const skills = [];
+		for (const skill of manifest.skills) {
+			if (!object(skill) || typeof skill.name !== "string" || !safeRelativePath(skill.name) || skill.name.includes("/") || previousName !== void 0 && Buffer.compare(Buffer.from(previousName), Buffer.from(skill.name)) >= 0 || typeof skill.description !== "string" || !Array.isArray(skill.files)) throw invalidSnapshot();
+			previousName = skill.name;
+			let previousPath;
+			let hasSkill = false;
+			const files = [];
+			for (const file of skill.files) {
+				if (!object(file) || typeof file.path !== "string" || !safeRelativePath(file.path) || previousPath !== void 0 && Buffer.compare(Buffer.from(previousPath), Buffer.from(file.path)) >= 0 || typeof file.size !== "number" || !Number.isSafeInteger(file.size) || file.size < 0 || typeof file.sha256 !== "string" || !/^[a-f0-9]{64}$/.test(file.sha256)) throw invalidSnapshot();
+				previousPath = file.path;
+				const path = `${skill.name}/${file.path}`;
+				if (expected.has(path)) throw invalidSnapshot();
+				expected.add(path);
+				const content = archive.get(path);
+				if (!content || content.length !== file.size || sha256(content) !== file.sha256) throw invalidSnapshot();
+				const text = utf8(content);
+				if (file.path === "SKILL.md") {
+					if (text === void 0) throw invalidSnapshot();
+					hasSkill = true;
+				}
+				files.push(Object.freeze({
+					path: file.path,
+					size: file.size,
+					sha256: file.sha256,
+					...text !== void 0 ? { text } : {}
+				}));
+			}
+			if (!hasSkill) throw invalidSnapshot();
+			skills.push(Object.freeze({
+				name: skill.name,
+				description: skill.description,
+				files: Object.freeze(files)
+			}));
+		}
+		if (expected.size !== archive.size || [...archive.keys()].some((path) => !expected.has(path))) throw invalidSnapshot();
+		return Object.freeze({
+			revision,
+			etag,
+			skills: Object.freeze(skills)
+		});
+	} catch (error) {
+		if (signal?.aborted) throw signal.reason;
+		if (error instanceof LearnedSkillsError) throw error;
+		throw invalidSnapshot(error);
+	}
+}
+
+//#endregion
+export { validateSnapshot };
+//# sourceMappingURL=snapshot.mjs.map