@warlock.js/core 4.7.0 → 4.8.1

package/esm/ai/src/serve/stream-to-sse.mjs

@@ -1,37 +0,0 @@
-import { SSE_DONE, encodeSSE } from "./sse.mjs";
-
-//#region ../@warlock.js/ai/src/serve/stream-to-sse.ts
-/**
-* Convert a primitive's event stream into an SSE byte stream (A3): each
-* event becomes an SSE frame named by its `type`, then the final `result`
-* (or an `error` frame if it rejects) is emitted, and finally the
-* `[DONE]` sentinel. Pure and transport-agnostic — {@link serve} pipes it
-* to an HTTP response, but it works against any sink.
-*
-* @example
-* for await (const frame of streamToSSE(agent.stream("hi"))) {
-*   res.write(frame);
-* }
-*/
-async function* streamToSSE(stream) {
-	for await (const event of stream) yield encodeSSE({
-		event: event.type,
-		data: event
-	});
-	if (stream.result) try {
-		yield encodeSSE({
-			event: "result",
-			data: await stream.result
-		});
-	} catch (error) {
-		yield encodeSSE({
-			event: "error",
-			data: { message: error instanceof Error ? error.message : String(error) }
-		});
-	}
-	yield SSE_DONE;
-}
-
-//#endregion
-export { streamToSSE };
-//# sourceMappingURL=stream-to-sse.mjs.map

package/esm/ai/src/serve/stream-to-sse.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"stream-to-sse.mjs","names":[],"sources":["../../../../../../../../../@warlock.js/ai/src/serve/stream-to-sse.ts"],"sourcesContent":["import { encodeSSE, SSE_DONE } from \"./sse\";\n\n/**\n * A streamable execution: an async iterable of typed events that also\n * exposes the final `result` promise — exactly the shape every primitive's\n * `stream()` returns ({@link StreamContract}).\n */\nexport type StreamLike<TEvent extends { type: string }, TResult> =\n  AsyncIterable<TEvent> & { result?: Promise<TResult> };\n\n/**\n * Convert a primitive's event stream into an SSE byte stream (A3): each\n * event becomes an SSE frame named by its `type`, then the final `result`\n * (or an `error` frame if it rejects) is emitted, and finally the\n * `[DONE]` sentinel. Pure and transport-agnostic — {@link serve} pipes it\n * to an HTTP response, but it works against any sink.\n *\n * @example\n * for await (const frame of streamToSSE(agent.stream(\"hi\"))) {\n *   res.write(frame);\n * }\n */\nexport async function* streamToSSE<TEvent extends { type: string }, TResult>(\n  stream: StreamLike<TEvent, TResult>,\n): AsyncIterable<string> {\n  for await (const event of stream) {\n    yield encodeSSE({ event: event.type, data: event });\n  }\n\n  if (stream.result) {\n    try {\n      const result = await stream.result;\n      yield encodeSSE({ event: \"result\", data: result });\n    } catch (error) {\n      yield encodeSSE({\n        event: \"error\",\n        data: { message: error instanceof Error ? error.message : String(error) },\n      });\n    }\n  }\n\n  yield SSE_DONE;\n}\n"],"mappings":";;;;;;;;;;;;;;;AAsBA,gBAAuB,YACrB,QACuB;CACvB,WAAW,MAAM,SAAS,QACxB,MAAM,UAAU;EAAE,OAAO,MAAM;EAAM,MAAM;CAAM,CAAC;CAGpD,IAAI,OAAO,QACT,IAAI;EAEF,MAAM,UAAU;GAAE,OAAO;GAAU,MAAM,MADpB,OAAO;EACoB,CAAC;CACnD,SAAS,OAAO;EACd,MAAM,UAAU;GACd,OAAO;GACP,MAAM,EAAE,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,EAAE;EAC1E,CAAC;CACH;CAGF,MAAM;AACR"}

package/esm/ai/src/skills/catalog.mjs

@@ -1,140 +0,0 @@
-//#region ../@warlock.js/ai/src/skills/catalog.ts
-let isEmbedderPeerInstalled = null;
-let loadingPromise;
-const EMBEDDER_INSTALL_INSTRUCTIONS = `
-Semantic skill pre-injection ({ inject: { select: "semantic" } }) needs an
-embedder. Pass one explicitly (reuse the one you built for ai.memory()):
-
-  skills({ inject: { select: "semantic", topK: 2, embedder } })
-
-or install an embedder provider:
-
-  npm install @warlock.js/ai-openai
-
-Or with your preferred package manager:
-
-  pnpm add @warlock.js/ai-openai
-  yarn add @warlock.js/ai-openai
-
-Then build one with \`new OpenAIEmbedder(client, { name: "text-embedding-3-small" })\`
-and pass it via \`inject.embedder\`.
-`.trim();
-/**
-* Probe for an installed embedder provider once, concurrency-safe. A bare
-* `catch` flips the flag to `false`; the curated install string surfaces
-* at use time. The provider's embedder needs a constructed SDK client, so
-* we cannot auto-build one — the probe only decides whether the curated
-* message should mention installing the package vs. just passing one in.
-*/
-function probeEmbedderPeer() {
-	if (isEmbedderPeerInstalled !== null) return Promise.resolve();
-	if (loadingPromise) return loadingPromise;
-	loadingPromise = (async () => {
-		try {
-			await import("../../../ai-openai/src/index.mjs");
-			isEmbedderPeerInstalled = true;
-		} catch {
-			isEmbedderPeerInstalled = false;
-		}
-	})();
-	return loadingPromise;
-}
-/**
-* Resolve the embedder for semantic selection. The explicit
-* `inject.embedder` always wins. With none supplied, the lazy probe runs
-* and the curated install string is thrown at use time — a provider's
-* embedder requires a constructed client, so there is no safe auto-build.
-*/
-async function resolveEmbedder(explicit) {
-	if (explicit) return explicit;
-	probeEmbedderPeer();
-	throw new Error(EMBEDDER_INSTALL_INSTRUCTIONS);
-}
-/**
-* Merge every source's `list()` into one de-duplicated catalog. Sources
-* are merged in order; a LATER source wins on a name collision (explicit,
-* documented precedence). Candidates are already filtered by each store's
-* `list()`, so the merged catalog never carries an inert candidate.
-*/
-async function buildCatalog(stores, scope) {
-	const merged = /* @__PURE__ */ new Map();
-	for (const store of stores) {
-		const entries = await store.list(scope);
-		for (const entry of entries) merged.set(entry.name, entry);
-	}
-	return [...merged.values()];
-}
-/**
-* Render the catalog as one line per skill — `name`, `version`,
-* `description` — matching the projection `scripts/generate-llms.mjs`
-* emits for `llms.txt` so the runtime catalog and the docs index read
-* identically. Returns an empty string when no skills are in scope so the
-* agent prepends nothing.
-*/
-function renderCatalogPrompt(name, entries) {
-	if (entries.length === 0) return "";
-	const lines = entries.map((entry) => `- ${entry.name} (v${entry.version}): ${entry.description}`);
-	return [
-		`# Available skills — "${name}"`,
-		"",
-		"You can load any of the following skills on demand with the `loadSkill` tool to pull its full instructions into context:",
-		"",
-		...lines
-	].join("\n");
-}
-/**
-* Load the full record for `name` across the merged sources, honoring the
-* later-source-wins precedence: the FIRST store (iterating in reverse) to
-* return a hit owns the name. A pinned `version` narrows the lookup.
-* Returns `undefined` when no source has the skill.
-*/
-async function loadRecord(stores, name, version) {
-	for (let index = stores.length - 1; index >= 0; index--) {
-		const record = await stores[index].load(name, version);
-		if (record) return record;
-	}
-}
-/**
-* Rank the in-scope catalog by cosine similarity to `input` and return the
-* full `SkillRecord`s for the top `topK` clearing `threshold`.
-*
-* Embeds `input` and every catalog `description` via the resolved
-* embedder (explicit `inject.embedder`, else the lazy provider), scores by
-* cosine similarity, sorts descending, applies the optional floor, slices
-* to `topK`, then loads those bodies. The embedder is the only optional
-* dependency this whole feature carries.
-*/
-async function semanticPreselect(stores, input, topK, options = {}) {
-	const catalog = await buildCatalog(stores, options.scope);
-	if (catalog.length === 0 || topK <= 0) return [];
-	const { vectors } = await (await resolveEmbedder(options.embedder)).embedMany([input, ...catalog.map((entry) => entry.description)]);
-	const inputVector = vectors[0];
-	const threshold = options.threshold ?? 0;
-	const scored = catalog.map((entry, index) => ({
-		entry,
-		score: cosineSimilarity(inputVector, vectors[index + 1])
-	})).filter((candidate) => candidate.score >= threshold).sort((first, second) => second.score - first.score).slice(0, topK);
-	const records = [];
-	for (const candidate of scored) {
-		const record = await loadRecord(stores, candidate.entry.name, candidate.entry.version);
-		if (record) records.push(record);
-	}
-	return records;
-}
-/** Cosine similarity of two equal-length vectors; `0` when either is degenerate. */
-function cosineSimilarity(a, b) {
-	let dot = 0;
-	let normA = 0;
-	let normB = 0;
-	for (let index = 0; index < a.length; index++) {
-		dot += a[index] * b[index];
-		normA += a[index] * a[index];
-		normB += b[index] * b[index];
-	}
-	if (normA === 0 || normB === 0) return 0;
-	return dot / (Math.sqrt(normA) * Math.sqrt(normB));
-}
-
-//#endregion
-export { buildCatalog, loadRecord, renderCatalogPrompt, semanticPreselect };
-//# sourceMappingURL=catalog.mjs.map

package/esm/ai/src/skills/catalog.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"catalog.mjs","names":[],"sources":["../../../../../../../../../@warlock.js/ai/src/skills/catalog.ts"],"sourcesContent":["import type { EmbedderContract } from \"../contracts/embedder.contract\";\nimport type {\n  SkillCatalogEntry,\n  SkillRecord,\n} from \"./contracts/skill-record.type\";\nimport type { SkillsStoreContract } from \"./contracts/skills-store.contract\";\n\n// ============================================================\n// Optional embedder (OPTIONAL peer)\n// ============================================================\n//\n// The embedder is needed ONLY for `inject.select === \"semantic\"`. It is\n// passed explicitly via `inject.embedder` in the common case (consumers\n// reuse the one they built for `ai.memory()`). When a consumer relies on\n// an auto-resolved embedder instead, the canonical lazy-peer probe below\n// surfaces a curated install string at USE TIME (first semantic preload)\n// rather than a raw module-resolution stack trace. Catalog-only /\n// loadSkill-only usage never touches this path.\n\nlet isEmbedderPeerInstalled: boolean | null = null;\nlet loadingPromise: Promise<void> | undefined;\n\nconst EMBEDDER_INSTALL_INSTRUCTIONS = `\nSemantic skill pre-injection ({ inject: { select: \"semantic\" } }) needs an\nembedder. Pass one explicitly (reuse the one you built for ai.memory()):\n\n  skills({ inject: { select: \"semantic\", topK: 2, embedder } })\n\nor install an embedder provider:\n\n  npm install @warlock.js/ai-openai\n\nOr with your preferred package manager:\n\n  pnpm add @warlock.js/ai-openai\n  yarn add @warlock.js/ai-openai\n\nThen build one with \\`new OpenAIEmbedder(client, { name: \"text-embedding-3-small\" })\\`\nand pass it via \\`inject.embedder\\`.\n`.trim();\n\n/**\n * Probe for an installed embedder provider once, concurrency-safe. A bare\n * `catch` flips the flag to `false`; the curated install string surfaces\n * at use time. The provider's embedder needs a constructed SDK client, so\n * we cannot auto-build one — the probe only decides whether the curated\n * message should mention installing the package vs. just passing one in.\n */\nfunction probeEmbedderPeer(): Promise<void> {\n  if (isEmbedderPeerInstalled !== null) {\n    return Promise.resolve();\n  }\n\n  if (loadingPromise) {\n    return loadingPromise;\n  }\n\n  loadingPromise = (async () => {\n    try {\n      await import(\"@warlock.js/ai-openai\");\n      isEmbedderPeerInstalled = true;\n    } catch {\n      isEmbedderPeerInstalled = false;\n    }\n  })();\n\n  return loadingPromise;\n}\n\n/**\n * Resolve the embedder for semantic selection. The explicit\n * `inject.embedder` always wins. With none supplied, the lazy probe runs\n * and the curated install string is thrown at use time — a provider's\n * embedder requires a constructed client, so there is no safe auto-build.\n */\nasync function resolveEmbedder(explicit?: EmbedderContract): Promise<EmbedderContract> {\n  if (explicit) {\n    return explicit;\n  }\n\n  // Warm the peer probe non-blockingly (so a future explicit call can hint\n  // whether to install vs. just pass one in) but do NOT await it — a\n  // provider's embedder needs a constructed client, so there is no safe\n  // auto-build either way and the throw is immediate.\n  void probeEmbedderPeer();\n\n  throw new Error(EMBEDDER_INSTALL_INSTRUCTIONS);\n}\n\n/**\n * Merge every source's `list()` into one de-duplicated catalog. Sources\n * are merged in order; a LATER source wins on a name collision (explicit,\n * documented precedence). Candidates are already filtered by each store's\n * `list()`, so the merged catalog never carries an inert candidate.\n */\nexport async function buildCatalog(\n  stores: SkillsStoreContract[],\n  scope?: { tags?: string[] },\n): Promise<SkillCatalogEntry[]> {\n  const merged = new Map<string, SkillCatalogEntry>();\n\n  for (const store of stores) {\n    const entries = await store.list(scope);\n\n    for (const entry of entries) {\n      merged.set(entry.name, entry);\n    }\n  }\n\n  return [...merged.values()];\n}\n\n/**\n * Render the catalog as one line per skill — `name`, `version`,\n * `description` — matching the projection `scripts/generate-llms.mjs`\n * emits for `llms.txt` so the runtime catalog and the docs index read\n * identically. Returns an empty string when no skills are in scope so the\n * agent prepends nothing.\n */\nexport function renderCatalogPrompt(name: string, entries: SkillCatalogEntry[]): string {\n  if (entries.length === 0) {\n    return \"\";\n  }\n\n  const lines = entries.map(\n    (entry) => `- ${entry.name} (v${entry.version}): ${entry.description}`,\n  );\n\n  return [\n    `# Available skills — \"${name}\"`,\n    \"\",\n    \"You can load any of the following skills on demand with the `loadSkill` tool to pull its full instructions into context:\",\n    \"\",\n    ...lines,\n  ].join(\"\\n\");\n}\n\n/**\n * Load the full record for `name` across the merged sources, honoring the\n * later-source-wins precedence: the FIRST store (iterating in reverse) to\n * return a hit owns the name. A pinned `version` narrows the lookup.\n * Returns `undefined` when no source has the skill.\n */\nexport async function loadRecord(\n  stores: SkillsStoreContract[],\n  name: string,\n  version?: number,\n): Promise<SkillRecord | undefined> {\n  for (let index = stores.length - 1; index >= 0; index--) {\n    const record = await stores[index].load(name, version);\n\n    if (record) {\n      return record;\n    }\n  }\n\n  return undefined;\n}\n\n/**\n * Rank the in-scope catalog by cosine similarity to `input` and return the\n * full `SkillRecord`s for the top `topK` clearing `threshold`.\n *\n * Embeds `input` and every catalog `description` via the resolved\n * embedder (explicit `inject.embedder`, else the lazy provider), scores by\n * cosine similarity, sorts descending, applies the optional floor, slices\n * to `topK`, then loads those bodies. The embedder is the only optional\n * dependency this whole feature carries.\n */\nexport async function semanticPreselect(\n  stores: SkillsStoreContract[],\n  input: string,\n  topK: number,\n  options: { embedder?: EmbedderContract; threshold?: number; scope?: { tags?: string[] } } = {},\n): Promise<SkillRecord[]> {\n  const catalog = await buildCatalog(stores, options.scope);\n\n  if (catalog.length === 0 || topK <= 0) {\n    return [];\n  }\n\n  const embedder = await resolveEmbedder(options.embedder);\n\n  const { vectors } = await embedder.embedMany([\n    input,\n    ...catalog.map((entry) => entry.description),\n  ]);\n\n  const inputVector = vectors[0];\n  const threshold = options.threshold ?? 0;\n\n  const scored = catalog\n    .map((entry, index) => ({\n      entry,\n      score: cosineSimilarity(inputVector, vectors[index + 1]),\n    }))\n    .filter((candidate) => candidate.score >= threshold)\n    .sort((first, second) => second.score - first.score)\n    .slice(0, topK);\n\n  const records: SkillRecord[] = [];\n\n  for (const candidate of scored) {\n    const record = await loadRecord(stores, candidate.entry.name, candidate.entry.version);\n\n    if (record) {\n      records.push(record);\n    }\n  }\n\n  return records;\n}\n\n/** Cosine similarity of two equal-length vectors; `0` when either is degenerate. */\nfunction cosineSimilarity(a: number[], b: number[]): number {\n  let dot = 0;\n  let normA = 0;\n  let normB = 0;\n\n  for (let index = 0; index < a.length; index++) {\n    dot += a[index] * b[index];\n    normA += a[index] * a[index];\n    normB += b[index] * b[index];\n  }\n\n  if (normA === 0 || normB === 0) {\n    return 0;\n  }\n\n  return dot / (Math.sqrt(normA) * Math.sqrt(normB));\n}\n"],"mappings":";AAmBA,IAAI,0BAA0C;AAC9C,IAAI;AAEJ,MAAM,gCAAgC;;;;;;;;;;;;;;;;;EAiBpC,KAAK;;;;;;;;AASP,SAAS,oBAAmC;CAC1C,IAAI,4BAA4B,MAC9B,OAAO,QAAQ,QAAQ;CAGzB,IAAI,gBACF,OAAO;CAGT,kBAAkB,YAAY;EAC5B,IAAI;GACF,MAAM,OAAO;GACb,0BAA0B;EAC5B,QAAQ;GACN,0BAA0B;EAC5B;CACF,EAAC,CAAE;CAEH,OAAO;AACT;;;;;;;AAQA,eAAe,gBAAgB,UAAwD;CACrF,IAAI,UACF,OAAO;CAOT,AAAK,kBAAkB;CAEvB,MAAM,IAAI,MAAM,6BAA6B;AAC/C;;;;;;;AAQA,eAAsB,aACpB,QACA,OAC8B;CAC9B,MAAM,yBAAS,IAAI,IAA+B;CAElD,KAAK,MAAM,SAAS,QAAQ;EAC1B,MAAM,UAAU,MAAM,MAAM,KAAK,KAAK;EAEtC,KAAK,MAAM,SAAS,SAClB,OAAO,IAAI,MAAM,MAAM,KAAK;CAEhC;CAEA,OAAO,CAAC,GAAG,OAAO,OAAO,CAAC;AAC5B;;;;;;;;AASA,SAAgB,oBAAoB,MAAc,SAAsC;CACtF,IAAI,QAAQ,WAAW,GACrB,OAAO;CAGT,MAAM,QAAQ,QAAQ,KACnB,UAAU,KAAK,MAAM,KAAK,KAAK,MAAM,QAAQ,KAAK,MAAM,aAC3D;CAEA,OAAO;EACL,yBAAyB,KAAK;EAC9B;EACA;EACA;EACA,GAAG;CACL,CAAC,CAAC,KAAK,IAAI;AACb;;;;;;;AAQA,eAAsB,WACpB,QACA,MACA,SACkC;CAClC,KAAK,IAAI,QAAQ,OAAO,SAAS,GAAG,SAAS,GAAG,SAAS;EACvD,MAAM,SAAS,MAAM,OAAO,MAAM,CAAC,KAAK,MAAM,OAAO;EAErD,IAAI,QACF,OAAO;CAEX;AAGF;;;;;;;;;;;AAYA,eAAsB,kBACpB,QACA,OACA,MACA,UAA4F,CAAC,GACrE;CACxB,MAAM,UAAU,MAAM,aAAa,QAAQ,QAAQ,KAAK;CAExD,IAAI,QAAQ,WAAW,KAAK,QAAQ,GAClC,OAAO,CAAC;CAKV,MAAM,EAAE,YAAY,OAAM,MAFH,gBAAgB,QAAQ,QAAQ,EAErB,CAAC,UAAU,CAC3C,OACA,GAAG,QAAQ,KAAK,UAAU,MAAM,WAAW,CAC7C,CAAC;CAED,MAAM,cAAc,QAAQ;CAC5B,MAAM,YAAY,QAAQ,aAAa;CAEvC,MAAM,SAAS,QACZ,KAAK,OAAO,WAAW;EACtB;EACA,OAAO,iBAAiB,aAAa,QAAQ,QAAQ,EAAE;CACzD,EAAE,CAAC,CACF,QAAQ,cAAc,UAAU,SAAS,SAAS,CAAC,CACnD,MAAM,OAAO,WAAW,OAAO,QAAQ,MAAM,KAAK,CAAC,CACnD,MAAM,GAAG,IAAI;CAEhB,MAAM,UAAyB,CAAC;CAEhC,KAAK,MAAM,aAAa,QAAQ;EAC9B,MAAM,SAAS,MAAM,WAAW,QAAQ,UAAU,MAAM,MAAM,UAAU,MAAM,OAAO;EAErF,IAAI,QACF,QAAQ,KAAK,MAAM;CAEvB;CAEA,OAAO;AACT;;AAGA,SAAS,iBAAiB,GAAa,GAAqB;CAC1D,IAAI,MAAM;CACV,IAAI,QAAQ;CACZ,IAAI,QAAQ;CAEZ,KAAK,IAAI,QAAQ,GAAG,QAAQ,EAAE,QAAQ,SAAS;EAC7C,OAAO,EAAE,SAAS,EAAE;EACpB,SAAS,EAAE,SAAS,EAAE;EACtB,SAAS,EAAE,SAAS,EAAE;CACxB;CAEA,IAAI,UAAU,KAAK,UAAU,GAC3B,OAAO;CAGT,OAAO,OAAO,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,KAAK;AAClD"}

package/esm/ai/src/skills/index.mjs

@@ -1,11 +0,0 @@
-import { buildCatalog, loadRecord, renderCatalogPrompt, semanticPreselect } from "./catalog.mjs";
-import { loadSkillTool } from "./load-skill-tool.mjs";
-import { saveSkillTool } from "./save-skill-tool.mjs";
-import { parseFrontmatter, parseTags } from "./sources/parse-frontmatter.mjs";
-import { directorySource } from "./sources/directory-source.mjs";
-import { storeSource } from "./sources/store-source.mjs";
-import { urlSource } from "./sources/url-source.mjs";
-import { resolveSource } from "./sources/index.mjs";
-import { skills } from "./skills.mjs";
-
-export {  };

package/esm/ai/src/skills/load-skill-tool.mjs

@@ -1,65 +0,0 @@
-import { tool } from "../tool/tool.mjs";
-
-//#region ../@warlock.js/ai/src/skills/load-skill-tool.ts
-/**
-* Hand-built, schema-library-agnostic Standard Schema for
-* `{ name: string; version?: number }` — built without `seal` / `zod` so
-* the skills feature stays dependency-free, matching the framework's own
-* `ragToolSchema` style. Bad shapes return `{ issues }` so the tool
-* runtime surfaces a `SchemaValidationError` like any other tool.
-*/
-function loadSkillSchema() {
-	return { "~standard": {
-		version: 1,
-		vendor: "warlock-ai-skills",
-		validate: (value) => {
-			const candidate = value;
-			if (!candidate || typeof candidate.name !== "string") return { issues: [{ message: "loadSkill input must be { name: string; version?: number }" }] };
-			if (candidate.version !== void 0 && typeof candidate.version !== "number") return { issues: [{ message: "loadSkill `version` must be a number when provided" }] };
-			return { value: {
-				name: candidate.name,
-				...candidate.version !== void 0 ? { version: candidate.version } : {}
-			} };
-		}
-	} };
-}
-/**
-* Build the `loadSkill` tool for one run. Returns the skill **body** as
-* the tool result, which the agent loop feeds straight back to the model
-* (the standard `role:"tool"` message path) — making the loaded procedure
-* visible on the next trip.
-*
-* The per-run counter is closed over here (one tool instance per run), so
-* the budget is naturally scoped to this execution:
-* - Past `maxLoadsPerRun` ⇒ returns `{ error: "skill load budget exhausted" }`
-*   as a RESULT, never a throw — the model self-corrects, exactly how the
-*   agent loop treats any tool error.
-* - Unknown skill (`load` ⇒ undefined) ⇒ `{ error: "unknown skill: <name>" }`.
-*
-* `execute` itself never throws — both failure modes are error results, so
-* the run continues.
-*/
-function loadSkillTool(deps) {
-	let loads = 0;
-	return tool({
-		name: "loadSkill",
-		description: "Load the full instructions of a named skill from the catalog into context. Call it with the skill's `name` (and optional `version`) when you need its detailed procedure.",
-		input: loadSkillSchema(),
-		execute: async ({ name, version }) => {
-			if (loads >= deps.maxLoadsPerRun) return { error: "skill load budget exhausted" };
-			loads += 1;
-			const record = await deps.load(name, version);
-			if (!record) return { error: `unknown skill: ${name}` };
-			deps.onLoaded?.(record);
-			return {
-				body: record.body,
-				name: record.name,
-				version: record.version
-			};
-		}
-	});
-}
-
-//#endregion
-export { loadSkillTool };
-//# sourceMappingURL=load-skill-tool.mjs.map

package/esm/ai/src/skills/load-skill-tool.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"load-skill-tool.mjs","names":[],"sources":["../../../../../../../../../@warlock.js/ai/src/skills/load-skill-tool.ts"],"sourcesContent":["import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport type { ToolContract } from \"../tool/tool\";\nimport { tool } from \"../tool/tool\";\nimport type {\n  LoadSkillInput,\n  SkillRecord,\n} from \"./contracts/skill-record.type\";\n\n/** Result the `loadSkill` tool feeds back to the model. */\nexport type LoadSkillResult =\n  | { body: string; name: string; version: number }\n  | { error: string };\n\n/**\n * Hand-built, schema-library-agnostic Standard Schema for\n * `{ name: string; version?: number }` — built without `seal` / `zod` so\n * the skills feature stays dependency-free, matching the framework's own\n * `ragToolSchema` style. Bad shapes return `{ issues }` so the tool\n * runtime surfaces a `SchemaValidationError` like any other tool.\n */\nfunction loadSkillSchema(): StandardSchemaV1<LoadSkillInput> {\n  return {\n    \"~standard\": {\n      version: 1,\n      vendor: \"warlock-ai-skills\",\n      validate: (value: unknown) => {\n        const candidate = value as { name?: unknown; version?: unknown } | null;\n\n        if (!candidate || typeof candidate.name !== \"string\") {\n          return { issues: [{ message: \"loadSkill input must be { name: string; version?: number }\" }] };\n        }\n\n        if (candidate.version !== undefined && typeof candidate.version !== \"number\") {\n          return { issues: [{ message: \"loadSkill `version` must be a number when provided\" }] };\n        }\n\n        return {\n          value: {\n            name: candidate.name,\n            ...(candidate.version !== undefined ? { version: candidate.version } : {}),\n          },\n        };\n      },\n    },\n  };\n}\n\n/** Dependencies the `loadSkill` tool closes over — kept narrow for testing. */\nexport type LoadSkillToolDeps = {\n  /** Resolve a skill's full record across the merged sources. */\n  load: (name: string, version?: number) => Promise<SkillRecord | undefined>;\n  /** Per-run budget cap on `loadSkill` calls (default 5, enforced by caller-supplied counter). */\n  maxLoadsPerRun: number;\n  /** Fired on each successful load (`type: \"loaded\"`); errors swallowed by the sink wrapper. */\n  onLoaded?: (record: SkillRecord) => void;\n};\n\n/**\n * Build the `loadSkill` tool for one run. Returns the skill **body** as\n * the tool result, which the agent loop feeds straight back to the model\n * (the standard `role:\"tool\"` message path) — making the loaded procedure\n * visible on the next trip.\n *\n * The per-run counter is closed over here (one tool instance per run), so\n * the budget is naturally scoped to this execution:\n * - Past `maxLoadsPerRun` ⇒ returns `{ error: \"skill load budget exhausted\" }`\n *   as a RESULT, never a throw — the model self-corrects, exactly how the\n *   agent loop treats any tool error.\n * - Unknown skill (`load` ⇒ undefined) ⇒ `{ error: \"unknown skill: <name>\" }`.\n *\n * `execute` itself never throws — both failure modes are error results, so\n * the run continues.\n */\nexport function loadSkillTool(deps: LoadSkillToolDeps): ToolContract<LoadSkillInput, LoadSkillResult> {\n  let loads = 0;\n\n  return tool<LoadSkillInput, LoadSkillResult>({\n    name: \"loadSkill\",\n    description:\n      \"Load the full instructions of a named skill from the catalog into context. Call it with the skill's `name` (and optional `version`) when you need its detailed procedure.\",\n    input: loadSkillSchema(),\n    execute: async ({ name, version }) => {\n      if (loads >= deps.maxLoadsPerRun) {\n        return { error: \"skill load budget exhausted\" };\n      }\n\n      loads += 1;\n\n      const record = await deps.load(name, version);\n\n      if (!record) {\n        return { error: `unknown skill: ${name}` };\n      }\n\n      deps.onLoaded?.(record);\n\n      return { body: record.body, name: record.name, version: record.version };\n    },\n  });\n}\n"],"mappings":";;;;;;;;;;AAoBA,SAAS,kBAAoD;CAC3D,OAAO,EACL,aAAa;EACX,SAAS;EACT,QAAQ;EACR,WAAW,UAAmB;GAC5B,MAAM,YAAY;GAElB,IAAI,CAAC,aAAa,OAAO,UAAU,SAAS,UAC1C,OAAO,EAAE,QAAQ,CAAC,EAAE,SAAS,6DAA6D,CAAC,EAAE;GAG/F,IAAI,UAAU,YAAY,UAAa,OAAO,UAAU,YAAY,UAClE,OAAO,EAAE,QAAQ,CAAC,EAAE,SAAS,qDAAqD,CAAC,EAAE;GAGvF,OAAO,EACL,OAAO;IACL,MAAM,UAAU;IAChB,GAAI,UAAU,YAAY,SAAY,EAAE,SAAS,UAAU,QAAQ,IAAI,CAAC;GAC1E,EACF;EACF;CACF,EACF;AACF;;;;;;;;;;;;;;;;;AA4BA,SAAgB,cAAc,MAAwE;CACpG,IAAI,QAAQ;CAEZ,OAAO,KAAsC;EAC3C,MAAM;EACN,aACE;EACF,OAAO,gBAAgB;EACvB,SAAS,OAAO,EAAE,MAAM,cAAc;GACpC,IAAI,SAAS,KAAK,gBAChB,OAAO,EAAE,OAAO,8BAA8B;GAGhD,SAAS;GAET,MAAM,SAAS,MAAM,KAAK,KAAK,MAAM,OAAO;GAE5C,IAAI,CAAC,QACH,OAAO,EAAE,OAAO,kBAAkB,OAAO;GAG3C,KAAK,WAAW,MAAM;GAEtB,OAAO;IAAE,MAAM,OAAO;IAAM,MAAM,OAAO;IAAM,SAAS,OAAO;GAAQ;EACzE;CACF,CAAC;AACH"}

package/esm/ai/src/skills/save-skill-tool.mjs

@@ -1,65 +0,0 @@
-import { tool } from "../tool/tool.mjs";
-
-//#region ../@warlock.js/ai/src/skills/save-skill-tool.ts
-/**
-* Hand-built Standard Schema for the `saveSkill` input — dependency-free,
-* mirroring `loadSkillSchema`. Requires `name` / `description` / `body`;
-* `tags` is an optional string array.
-*/
-function saveSkillSchema() {
-	return { "~standard": {
-		version: 1,
-		vendor: "warlock-ai-skills",
-		validate: (value) => {
-			const candidate = value;
-			if (!candidate || typeof candidate.name !== "string" || typeof candidate.description !== "string" || typeof candidate.body !== "string") return { issues: [{ message: "saveSkill input must be { name: string; description: string; body: string; tags?: string[] }" }] };
-			if (candidate.tags !== void 0 && (!Array.isArray(candidate.tags) || !candidate.tags.every((tag) => typeof tag === "string"))) return { issues: [{ message: "saveSkill `tags` must be a string[] when provided" }] };
-			return { value: {
-				name: candidate.name,
-				description: candidate.description,
-				body: candidate.body,
-				...candidate.tags !== void 0 ? { tags: candidate.tags } : {}
-			} };
-		}
-	} };
-}
-/**
-* Build the **Phase 2** `saveSkill` tool — exposed ONLY when a `review`
-* gate is configured. It writes an INERT `type: "candidate"` record via
-* `saveCandidate`. A candidate is filtered out of the catalog and from
-* preload — it can NEVER be injected until the default-DENY review gate
-* promotes it. So `saveSkill` alone can never turn the model's own output
-* into an injected instruction; promotion is a separate, gated step.
-*
-* `execute` never throws — a store write failure surfaces as an error
-* result so the run continues.
-*/
-function saveSkillTool(deps) {
-	return tool({
-		name: "saveSkill",
-		description: "Propose a new reusable skill. The skill is saved as an INERT candidate and is NOT used until a reviewer approves it — it will not affect the current run.",
-		input: saveSkillSchema(),
-		execute: async (input) => {
-			try {
-				const record = await deps.saveCandidate({
-					name: input.name,
-					description: input.description,
-					body: input.body,
-					...input.tags !== void 0 ? { tags: input.tags } : {}
-				});
-				deps.onSaved?.(record);
-				return {
-					saved: true,
-					name: record.name,
-					status: "candidate"
-				};
-			} catch (error) {
-				return { error: error instanceof Error ? error.message : String(error) };
-			}
-		}
-	});
-}
-
-//#endregion
-export { saveSkillTool };
-//# sourceMappingURL=save-skill-tool.mjs.map

package/esm/ai/src/skills/save-skill-tool.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"save-skill-tool.mjs","names":[],"sources":["../../../../../../../../../@warlock.js/ai/src/skills/save-skill-tool.ts"],"sourcesContent":["import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport type { ToolContract } from \"../tool/tool\";\nimport { tool } from \"../tool/tool\";\nimport type { SkillRecord } from \"./contracts/skill-record.type\";\n\n/** Validated input of the `saveSkill` tool. */\nexport type SaveSkillInput = {\n  name: string;\n  description: string;\n  body: string;\n  tags?: string[];\n};\n\n/** Result the `saveSkill` tool feeds back to the model. */\nexport type SaveSkillResult =\n  | { saved: true; name: string; status: \"candidate\" }\n  | { error: string };\n\n/**\n * Hand-built Standard Schema for the `saveSkill` input — dependency-free,\n * mirroring `loadSkillSchema`. Requires `name` / `description` / `body`;\n * `tags` is an optional string array.\n */\nfunction saveSkillSchema(): StandardSchemaV1<SaveSkillInput> {\n  return {\n    \"~standard\": {\n      version: 1,\n      vendor: \"warlock-ai-skills\",\n      validate: (value: unknown) => {\n        const candidate = value as\n          | { name?: unknown; description?: unknown; body?: unknown; tags?: unknown }\n          | null;\n\n        if (\n          !candidate ||\n          typeof candidate.name !== \"string\" ||\n          typeof candidate.description !== \"string\" ||\n          typeof candidate.body !== \"string\"\n        ) {\n          return {\n            issues: [\n              {\n                message:\n                  \"saveSkill input must be { name: string; description: string; body: string; tags?: string[] }\",\n              },\n            ],\n          };\n        }\n\n        if (\n          candidate.tags !== undefined &&\n          (!Array.isArray(candidate.tags) ||\n            !candidate.tags.every((tag) => typeof tag === \"string\"))\n        ) {\n          return { issues: [{ message: \"saveSkill `tags` must be a string[] when provided\" }] };\n        }\n\n        return {\n          value: {\n            name: candidate.name,\n            description: candidate.description,\n            body: candidate.body,\n            ...(candidate.tags !== undefined ? { tags: candidate.tags as string[] } : {}),\n          },\n        };\n      },\n    },\n  };\n}\n\n/** Dependencies the `saveSkill` tool closes over. */\nexport type SaveSkillToolDeps = {\n  /** Write an INERT candidate; the returned record is `type: \"candidate\"`. */\n  saveCandidate: (record: Omit<SkillRecord, \"version\" | \"type\">) => Promise<SkillRecord>;\n  /** Fired on a successful save (`type: \"saved\"`); errors swallowed by the sink wrapper. */\n  onSaved?: (record: SkillRecord) => void;\n};\n\n/**\n * Build the **Phase 2** `saveSkill` tool — exposed ONLY when a `review`\n * gate is configured. It writes an INERT `type: \"candidate\"` record via\n * `saveCandidate`. A candidate is filtered out of the catalog and from\n * preload — it can NEVER be injected until the default-DENY review gate\n * promotes it. So `saveSkill` alone can never turn the model's own output\n * into an injected instruction; promotion is a separate, gated step.\n *\n * `execute` never throws — a store write failure surfaces as an error\n * result so the run continues.\n */\nexport function saveSkillTool(deps: SaveSkillToolDeps): ToolContract<SaveSkillInput, SaveSkillResult> {\n  return tool<SaveSkillInput, SaveSkillResult>({\n    name: \"saveSkill\",\n    description:\n      \"Propose a new reusable skill. The skill is saved as an INERT candidate and is NOT used until a reviewer approves it — it will not affect the current run.\",\n    input: saveSkillSchema(),\n    execute: async (input) => {\n      try {\n        const record = await deps.saveCandidate({\n          name: input.name,\n          description: input.description,\n          body: input.body,\n          ...(input.tags !== undefined ? { tags: input.tags } : {}),\n        });\n\n        deps.onSaved?.(record);\n\n        return { saved: true, name: record.name, status: \"candidate\" };\n      } catch (error) {\n        return { error: error instanceof Error ? error.message : String(error) };\n      }\n    },\n  });\n}\n"],"mappings":";;;;;;;;AAuBA,SAAS,kBAAoD;CAC3D,OAAO,EACL,aAAa;EACX,SAAS;EACT,QAAQ;EACR,WAAW,UAAmB;GAC5B,MAAM,YAAY;GAIlB,IACE,CAAC,aACD,OAAO,UAAU,SAAS,YAC1B,OAAO,UAAU,gBAAgB,YACjC,OAAO,UAAU,SAAS,UAE1B,OAAO,EACL,QAAQ,CACN,EACE,SACE,+FACJ,CACF,EACF;GAGF,IACE,UAAU,SAAS,WAClB,CAAC,MAAM,QAAQ,UAAU,IAAI,KAC5B,CAAC,UAAU,KAAK,OAAO,QAAQ,OAAO,QAAQ,QAAQ,IAExD,OAAO,EAAE,QAAQ,CAAC,EAAE,SAAS,oDAAoD,CAAC,EAAE;GAGtF,OAAO,EACL,OAAO;IACL,MAAM,UAAU;IAChB,aAAa,UAAU;IACvB,MAAM,UAAU;IAChB,GAAI,UAAU,SAAS,SAAY,EAAE,MAAM,UAAU,KAAiB,IAAI,CAAC;GAC7E,EACF;EACF;CACF,EACF;AACF;;;;;;;;;;;;AAqBA,SAAgB,cAAc,MAAwE;CACpG,OAAO,KAAsC;EAC3C,MAAM;EACN,aACE;EACF,OAAO,gBAAgB;EACvB,SAAS,OAAO,UAAU;GACxB,IAAI;IACF,MAAM,SAAS,MAAM,KAAK,cAAc;KACtC,MAAM,MAAM;KACZ,aAAa,MAAM;KACnB,MAAM,MAAM;KACZ,GAAI,MAAM,SAAS,SAAY,EAAE,MAAM,MAAM,KAAK,IAAI,CAAC;IACzD,CAAC;IAED,KAAK,UAAU,MAAM;IAErB,OAAO;KAAE,OAAO;KAAM,MAAM,OAAO;KAAM,QAAQ;IAAY;GAC/D,SAAS,OAAO;IACd,OAAO,EAAE,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,EAAE;GACzE;EACF;CACF,CAAC;AACH"}

package/esm/ai/src/skills/skills.mjs

@@ -1,109 +0,0 @@
-import { buildCatalog, loadRecord, renderCatalogPrompt, semanticPreselect } from "./catalog.mjs";
-import { loadSkillTool } from "./load-skill-tool.mjs";
-import { saveSkillTool } from "./save-skill-tool.mjs";
-import { resolveSource } from "./sources/index.mjs";
-
-//#region ../@warlock.js/ai/src/skills/skills.ts
-const DEFAULT_MAX_LOADS_PER_RUN = 5;
-/**
-* Create a runtime skills library — the **mechanism** behind the
-* first-class `skills` agent option.
-*
-* The returned {@link SkillsContract} produces the agent-facing wiring:
-* - `catalog` / `catalogPrompt` — the always-injected cheap metadata block
-*   (one line per in-scope, non-candidate skill).
-* - `preload` — the bodies to inject up front per `inject` (`[]` when
-*   `inject` is omitted — the default catalog-only progressive disclosure).
-* - `tools(runId)` — the `loadSkill` tool always; plus `saveSkill` ONLY
-*   when a `review` gate is configured (otherwise self-authoring is inert).
-*
-* Sources are merged in order; a later source wins on a name collision.
-* `maxLoadsPerRun` (default 5) caps `loadSkill` calls per run; exhaustion
-* is an error RESULT the model self-corrects from, never a throw.
-*
-* @example
-* const lib = skills({
-*   name: "build-skills",
-*   sources: [{ type: "directory", path: "./agent-skills" }],
-*   inject: { select: "semantic", topK: 2, embedder },
-*   maxLoadsPerRun: 4,
-*   scope: { tags: ["frontend"] },
-* });
-*/
-function skills(config) {
-	if (!config.sources || config.sources.length === 0) throw new Error(`skills("${config.name}"): at least one source is required (directory / url / store)`);
-	const stores = config.sources.map(resolveSource);
-	const scope = config.scope;
-	const maxLoadsPerRun = config.maxLoadsPerRun ?? DEFAULT_MAX_LOADS_PER_RUN;
-	const reviewExposed = config.review !== void 0;
-	/** Fire an analytics event, swallowing any sink error (mirrors agent hooks). */
-	const emit = (event) => {
-		if (!config.analytics) return;
-		try {
-			Promise.resolve(config.analytics(event)).catch(() => void 0);
-		} catch {}
-	};
-	const catalog = async () => {
-		const entries = await buildCatalog(stores, scope);
-		for (const entry of entries) emit({
-			type: "catalogued",
-			skill: entry.name,
-			version: entry.version
-		});
-		return entries;
-	};
-	return {
-		name: config.name,
-		catalog,
-		async catalogPrompt() {
-			const entries = await catalog();
-			return renderCatalogPrompt(config.name, entries);
-		},
-		async preload(input) {
-			if (!config.inject) return [];
-			if (config.inject === "all") {
-				const entries = await buildCatalog(stores, scope);
-				const records = [];
-				for (const entry of entries) {
-					const record = await loadRecord(stores, entry.name, entry.version);
-					if (record) records.push(record);
-				}
-				return records;
-			}
-			return semanticPreselect(stores, input, config.inject.topK, {
-				embedder: config.inject.embedder,
-				threshold: config.inject.threshold,
-				scope
-			});
-		},
-		tools(runId) {
-			const entries = [loadSkillTool({
-				load: (name, version) => loadRecord(stores, name, version),
-				maxLoadsPerRun,
-				onLoaded: (record) => emit({
-					type: "loaded",
-					skill: record.name,
-					version: record.version,
-					runId
-				})
-			})];
-			if (reviewExposed && config.review) {
-				const reviewStore = config.review.store;
-				entries.push(saveSkillTool({
-					saveCandidate: (record) => reviewStore.saveCandidate(record),
-					onSaved: (record) => emit({
-						type: "saved",
-						skill: record.name,
-						version: record.version,
-						runId
-					})
-				}));
-			}
-			return entries;
-		}
-	};
-}
-
-//#endregion
-export { skills };
-//# sourceMappingURL=skills.mjs.map

package/esm/ai/src/skills/skills.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"skills.mjs","names":[],"sources":["../../../../../../../../../@warlock.js/ai/src/skills/skills.ts"],"sourcesContent":["import type { AgentToolEntry } from \"../tool/executable-as-tool\";\nimport {\n  buildCatalog,\n  loadRecord,\n  renderCatalogPrompt,\n  semanticPreselect,\n} from \"./catalog\";\nimport type {\n  SkillAnalyticsEvent,\n  SkillsConfig,\n} from \"./contracts/skills-config.type\";\nimport type {\n  SkillCatalogEntry,\n  SkillRecord,\n} from \"./contracts/skill-record.type\";\nimport type { SkillsContract } from \"./contracts/skills.contract\";\nimport type { SkillsStoreContract } from \"./contracts/skills-store.contract\";\nimport { loadSkillTool } from \"./load-skill-tool\";\nimport { saveSkillTool } from \"./save-skill-tool\";\nimport { resolveSource } from \"./sources\";\n\nconst DEFAULT_MAX_LOADS_PER_RUN = 5;\n\n/**\n * Create a runtime skills library — the **mechanism** behind the\n * first-class `skills` agent option.\n *\n * The returned {@link SkillsContract} produces the agent-facing wiring:\n * - `catalog` / `catalogPrompt` — the always-injected cheap metadata block\n *   (one line per in-scope, non-candidate skill).\n * - `preload` — the bodies to inject up front per `inject` (`[]` when\n *   `inject` is omitted — the default catalog-only progressive disclosure).\n * - `tools(runId)` — the `loadSkill` tool always; plus `saveSkill` ONLY\n *   when a `review` gate is configured (otherwise self-authoring is inert).\n *\n * Sources are merged in order; a later source wins on a name collision.\n * `maxLoadsPerRun` (default 5) caps `loadSkill` calls per run; exhaustion\n * is an error RESULT the model self-corrects from, never a throw.\n *\n * @example\n * const lib = skills({\n *   name: \"build-skills\",\n *   sources: [{ type: \"directory\", path: \"./agent-skills\" }],\n *   inject: { select: \"semantic\", topK: 2, embedder },\n *   maxLoadsPerRun: 4,\n *   scope: { tags: [\"frontend\"] },\n * });\n */\nexport function skills(config: SkillsConfig): SkillsContract {\n  if (!config.sources || config.sources.length === 0) {\n    throw new Error(\n      `skills(\"${config.name}\"): at least one source is required (directory / url / store)`,\n    );\n  }\n\n  const stores: SkillsStoreContract[] = config.sources.map(resolveSource);\n  const scope = config.scope;\n  const maxLoadsPerRun = config.maxLoadsPerRun ?? DEFAULT_MAX_LOADS_PER_RUN;\n  const reviewExposed = config.review !== undefined;\n\n  /** Fire an analytics event, swallowing any sink error (mirrors agent hooks). */\n  const emit = (event: SkillAnalyticsEvent): void => {\n    if (!config.analytics) {\n      return;\n    }\n\n    try {\n      void Promise.resolve(config.analytics(event)).catch(() => undefined);\n    } catch {\n      // Sink threw synchronously — swallowed; analytics never crash a run.\n    }\n  };\n\n  const catalog = async (): Promise<SkillCatalogEntry[]> => {\n    const entries = await buildCatalog(stores, scope);\n\n    for (const entry of entries) {\n      emit({ type: \"catalogued\", skill: entry.name, version: entry.version });\n    }\n\n    return entries;\n  };\n\n  return {\n    name: config.name,\n\n    catalog,\n\n    async catalogPrompt(): Promise<string> {\n      const entries = await catalog();\n\n      return renderCatalogPrompt(config.name, entries);\n    },\n\n    async preload(input: string): Promise<SkillRecord[]> {\n      if (!config.inject) {\n        return [];\n      }\n\n      if (config.inject === \"all\") {\n        const entries = await buildCatalog(stores, scope);\n        const records: SkillRecord[] = [];\n\n        for (const entry of entries) {\n          const record = await loadRecord(stores, entry.name, entry.version);\n\n          if (record) {\n            records.push(record);\n          }\n        }\n\n        return records;\n      }\n\n      // `{ select: \"semantic\", topK }`\n      return semanticPreselect(stores, input, config.inject.topK, {\n        embedder: config.inject.embedder,\n        threshold: config.inject.threshold,\n        scope,\n      });\n    },\n\n    tools(runId?: string): AgentToolEntry<any, any>[] {\n      const entries: AgentToolEntry<any, any>[] = [\n        loadSkillTool({\n          load: (name, version) => loadRecord(stores, name, version),\n          maxLoadsPerRun,\n          onLoaded: (record) =>\n            emit({ type: \"loaded\", skill: record.name, version: record.version, runId }),\n        }),\n      ];\n\n      // Phase 2 — `saveSkill` is exposed ONLY when a review gate is wired.\n      // Absent gate ⇒ self-authoring is inert: the tool is never registered\n      // and a candidate can never be written, let alone injected.\n      if (reviewExposed && config.review) {\n        const reviewStore = config.review.store;\n\n        entries.push(\n          saveSkillTool({\n            saveCandidate: (record) => reviewStore.saveCandidate(record),\n            onSaved: (record) =>\n              emit({ type: \"saved\", skill: record.name, version: record.version, runId }),\n          }),\n        );\n      }\n\n      return entries;\n    },\n  };\n}\n"],"mappings":";;;;;;AAqBA,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BlC,SAAgB,OAAO,QAAsC;CAC3D,IAAI,CAAC,OAAO,WAAW,OAAO,QAAQ,WAAW,GAC/C,MAAM,IAAI,MACR,WAAW,OAAO,KAAK,8DACzB;CAGF,MAAM,SAAgC,OAAO,QAAQ,IAAI,aAAa;CACtE,MAAM,QAAQ,OAAO;CACrB,MAAM,iBAAiB,OAAO,kBAAkB;CAChD,MAAM,gBAAgB,OAAO,WAAW;;CAGxC,MAAM,QAAQ,UAAqC;EACjD,IAAI,CAAC,OAAO,WACV;EAGF,IAAI;GACF,AAAK,QAAQ,QAAQ,OAAO,UAAU,KAAK,CAAC,CAAC,CAAC,YAAY,MAAS;EACrE,QAAQ,CAER;CACF;CAEA,MAAM,UAAU,YAA0C;EACxD,MAAM,UAAU,MAAM,aAAa,QAAQ,KAAK;EAEhD,KAAK,MAAM,SAAS,SAClB,KAAK;GAAE,MAAM;GAAc,OAAO,MAAM;GAAM,SAAS,MAAM;EAAQ,CAAC;EAGxE,OAAO;CACT;CAEA,OAAO;EACL,MAAM,OAAO;EAEb;EAEA,MAAM,gBAAiC;GACrC,MAAM,UAAU,MAAM,QAAQ;GAE9B,OAAO,oBAAoB,OAAO,MAAM,OAAO;EACjD;EAEA,MAAM,QAAQ,OAAuC;GACnD,IAAI,CAAC,OAAO,QACV,OAAO,CAAC;GAGV,IAAI,OAAO,WAAW,OAAO;IAC3B,MAAM,UAAU,MAAM,aAAa,QAAQ,KAAK;IAChD,MAAM,UAAyB,CAAC;IAEhC,KAAK,MAAM,SAAS,SAAS;KAC3B,MAAM,SAAS,MAAM,WAAW,QAAQ,MAAM,MAAM,MAAM,OAAO;KAEjE,IAAI,QACF,QAAQ,KAAK,MAAM;IAEvB;IAEA,OAAO;GACT;GAGA,OAAO,kBAAkB,QAAQ,OAAO,OAAO,OAAO,MAAM;IAC1D,UAAU,OAAO,OAAO;IACxB,WAAW,OAAO,OAAO;IACzB;GACF,CAAC;EACH;EAEA,MAAM,OAA4C;GAChD,MAAM,UAAsC,CAC1C,cAAc;IACZ,OAAO,MAAM,YAAY,WAAW,QAAQ,MAAM,OAAO;IACzD;IACA,WAAW,WACT,KAAK;KAAE,MAAM;KAAU,OAAO,OAAO;KAAM,SAAS,OAAO;KAAS;IAAM,CAAC;GAC/E,CAAC,CACH;GAKA,IAAI,iBAAiB,OAAO,QAAQ;IAClC,MAAM,cAAc,OAAO,OAAO;IAElC,QAAQ,KACN,cAAc;KACZ,gBAAgB,WAAW,YAAY,cAAc,MAAM;KAC3D,UAAU,WACR,KAAK;MAAE,MAAM;MAAS,OAAO,OAAO;MAAM,SAAS,OAAO;MAAS;KAAM,CAAC;IAC9E,CAAC,CACH;GACF;GAEA,OAAO;EACT;CACF;AACF"}

package/esm/ai/src/skills/sources/directory-source.mjs

@@ -1,108 +0,0 @@
-import { parseFrontmatter, parseTags } from "./parse-frontmatter.mjs";
-
-//#region ../@warlock.js/ai/src/skills/sources/directory-source.ts
-/**
-* Lazily-loaded `node:fs/promises`. Core takes no new filesystem
-* dependency — a `store`-only or `url`-only consumer never touches the
-* filesystem because the module is imported on first read, not at module
-* load. Settled once and cached.
-*/
-let fsMod;
-let pathMod;
-async function loadFs() {
-	if (!fsMod) fsMod = await import("node:fs/promises");
-	if (!pathMod) pathMod = await import("node:path");
-	return {
-		fs: fsMod,
-		path: pathMod
-	};
-}
-/**
-* Read `path/<folder>/SKILL.md` into {@link SkillRecord}s, parsing the
-* same `key: value` front-matter as `scripts/generate-llms.mjs`. Each
-* direct sub-directory holding a `SKILL.md` becomes one skill named after
-* the folder; the `description` comes from front-matter, `tags` from a
-* comma-separated `tags:` line, and the body is everything after the
-* closing `---`. Files at the root (e.g. `README.md`) are ignored.
-*
-* Reads are a snapshot at first call and cached for the source's lifetime
-* (a single agent run reads the catalog and bodies from one consistent
-* view). A missing directory yields an empty library, not a throw.
-*/
-function directorySource(dirPath) {
-	let cache;
-	const records = () => {
-		if (!cache) cache = readDirectory(dirPath);
-		return cache;
-	};
-	return {
-		async list(scope) {
-			const all = await records();
-			const wanted = scope?.tags;
-			return [...all.values()].filter((record) => intersects(record.tags, wanted)).map(toCatalogEntry);
-		},
-		async load(name, version) {
-			const record = (await records()).get(name);
-			if (!record) return;
-			if (version !== void 0 && record.version !== version) return;
-			return record;
-		},
-		async saveCandidate() {
-			throw new Error("directory source is read-only — saveCandidate requires a writable store (set `review.store`)");
-		},
-		async promote() {
-			throw new Error("directory source is read-only — promote requires a writable store (set `review.store`)");
-		}
-	};
-}
-/** Walk the directory once, parsing every `<folder>/SKILL.md` into a record. */
-async function readDirectory(dirPath) {
-	const { fs, path } = await loadFs();
-	const records = /* @__PURE__ */ new Map();
-	let entries;
-	try {
-		entries = await fs.readdir(dirPath, { withFileTypes: true });
-	} catch {
-		return records;
-	}
-	for (const entry of entries) {
-		if (!entry.isDirectory()) continue;
-		const skillFile = path.join(dirPath, entry.name, "SKILL.md");
-		let text;
-		try {
-			text = await fs.readFile(skillFile, "utf8");
-		} catch {
-			continue;
-		}
-		const { meta, body } = parseFrontmatter(text);
-		records.set(entry.name, {
-			name: entry.name,
-			description: meta.description ?? "(no description)",
-			version: 1,
-			body: body.trim(),
-			tags: parseTags(meta.tags),
-			type: "authored"
-		});
-	}
-	return records;
-}
-/** Project a full record down to its catalog entry (body omitted). */
-function toCatalogEntry(record) {
-	return {
-		name: record.name,
-		description: record.description,
-		version: record.version,
-		tags: record.tags,
-		type: record.type
-	};
-}
-/** True when no filter is requested or the record shares a requested tag. */
-function intersects(recordTags, wanted) {
-	if (!wanted || wanted.length === 0) return true;
-	if (!recordTags || recordTags.length === 0) return false;
-	return recordTags.some((tag) => wanted.includes(tag));
-}
-
-//#endregion
-export { directorySource };
-//# sourceMappingURL=directory-source.mjs.map

package/esm/ai/src/skills/sources/directory-source.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"directory-source.mjs","names":[],"sources":["../../../../../../../../../../@warlock.js/ai/src/skills/sources/directory-source.ts"],"sourcesContent":["import type {\n  SkillCatalogEntry,\n  SkillRecord,\n} from \"../contracts/skill-record.type\";\nimport type { SkillsStoreContract } from \"../contracts/skills-store.contract\";\nimport { parseFrontmatter, parseTags } from \"./parse-frontmatter\";\n\n/**\n * Lazily-loaded `node:fs/promises`. Core takes no new filesystem\n * dependency — a `store`-only or `url`-only consumer never touches the\n * filesystem because the module is imported on first read, not at module\n * load. Settled once and cached.\n */\nlet fsMod: typeof import(\"node:fs/promises\") | undefined;\nlet pathMod: typeof import(\"node:path\") | undefined;\n\nasync function loadFs(): Promise<{\n  fs: typeof import(\"node:fs/promises\");\n  path: typeof import(\"node:path\");\n}> {\n  if (!fsMod) {\n    fsMod = await import(\"node:fs/promises\");\n  }\n\n  if (!pathMod) {\n    pathMod = await import(\"node:path\");\n  }\n\n  return { fs: fsMod, path: pathMod };\n}\n\n/**\n * Read `path/<folder>/SKILL.md` into {@link SkillRecord}s, parsing the\n * same `key: value` front-matter as `scripts/generate-llms.mjs`. Each\n * direct sub-directory holding a `SKILL.md` becomes one skill named after\n * the folder; the `description` comes from front-matter, `tags` from a\n * comma-separated `tags:` line, and the body is everything after the\n * closing `---`. Files at the root (e.g. `README.md`) are ignored.\n *\n * Reads are a snapshot at first call and cached for the source's lifetime\n * (a single agent run reads the catalog and bodies from one consistent\n * view). A missing directory yields an empty library, not a throw.\n */\nexport function directorySource(dirPath: string): SkillsStoreContract {\n  let cache: Promise<Map<string, SkillRecord>> | undefined;\n\n  const records = (): Promise<Map<string, SkillRecord>> => {\n    if (!cache) {\n      cache = readDirectory(dirPath);\n    }\n\n    return cache;\n  };\n\n  return {\n    async list(scope?: { tags?: string[] }): Promise<SkillCatalogEntry[]> {\n      const all = await records();\n      const wanted = scope?.tags;\n\n      return [...all.values()]\n        .filter((record) => intersects(record.tags, wanted))\n        .map(toCatalogEntry);\n    },\n    async load(name: string, version?: number): Promise<SkillRecord | undefined> {\n      const all = await records();\n      const record = all.get(name);\n\n      if (!record) {\n        return undefined;\n      }\n\n      if (version !== undefined && record.version !== version) {\n        return undefined;\n      }\n\n      return record;\n    },\n    async saveCandidate(): Promise<SkillRecord> {\n      throw new Error(\n        \"directory source is read-only — saveCandidate requires a writable store (set `review.store`)\",\n      );\n    },\n    async promote(): Promise<SkillRecord> {\n      throw new Error(\n        \"directory source is read-only — promote requires a writable store (set `review.store`)\",\n      );\n    },\n  };\n}\n\n/** Walk the directory once, parsing every `<folder>/SKILL.md` into a record. */\nasync function readDirectory(dirPath: string): Promise<Map<string, SkillRecord>> {\n  const { fs, path } = await loadFs();\n  const records = new Map<string, SkillRecord>();\n\n  let entries: Array<{ name: string; isDirectory(): boolean }>;\n\n  try {\n    entries = await fs.readdir(dirPath, { withFileTypes: true });\n  } catch {\n    // Missing directory ⇒ empty library; the catalog simply omits it.\n    return records;\n  }\n\n  for (const entry of entries) {\n    if (!entry.isDirectory()) {\n      continue;\n    }\n\n    const skillFile = path.join(dirPath, entry.name, \"SKILL.md\");\n\n    let text: string;\n\n    try {\n      text = await fs.readFile(skillFile, \"utf8\");\n    } catch {\n      // A sub-directory without a SKILL.md is not a skill — skip it.\n      continue;\n    }\n\n    const { meta, body } = parseFrontmatter(text);\n\n    records.set(entry.name, {\n      name: entry.name,\n      description: meta.description ?? \"(no description)\",\n      version: 1,\n      body: body.trim(),\n      tags: parseTags(meta.tags),\n      type: \"authored\",\n    });\n  }\n\n  return records;\n}\n\n/** Project a full record down to its catalog entry (body omitted). */\nfunction toCatalogEntry(record: SkillRecord): SkillCatalogEntry {\n  return {\n    name: record.name,\n    description: record.description,\n    version: record.version,\n    tags: record.tags,\n    type: record.type,\n  };\n}\n\n/** True when no filter is requested or the record shares a requested tag. */\nfunction intersects(recordTags: string[] | undefined, wanted: string[] | undefined): boolean {\n  if (!wanted || wanted.length === 0) {\n    return true;\n  }\n\n  if (!recordTags || recordTags.length === 0) {\n    return false;\n  }\n\n  return recordTags.some((tag) => wanted.includes(tag));\n}\n"],"mappings":";;;;;;;;;AAaA,IAAI;AACJ,IAAI;AAEJ,eAAe,SAGZ;CACD,IAAI,CAAC,OACH,QAAQ,MAAM,OAAO;CAGvB,IAAI,CAAC,SACH,UAAU,MAAM,OAAO;CAGzB,OAAO;EAAE,IAAI;EAAO,MAAM;CAAQ;AACpC;;;;;;;;;;;;;AAcA,SAAgB,gBAAgB,SAAsC;CACpE,IAAI;CAEJ,MAAM,gBAAmD;EACvD,IAAI,CAAC,OACH,QAAQ,cAAc,OAAO;EAG/B,OAAO;CACT;CAEA,OAAO;EACL,MAAM,KAAK,OAA2D;GACpE,MAAM,MAAM,MAAM,QAAQ;GAC1B,MAAM,SAAS,OAAO;GAEtB,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,CAAC,CACrB,QAAQ,WAAW,WAAW,OAAO,MAAM,MAAM,CAAC,CAAC,CACnD,IAAI,cAAc;EACvB;EACA,MAAM,KAAK,MAAc,SAAoD;GAE3E,MAAM,UAAS,MADG,QAAQ,EACR,CAAC,IAAI,IAAI;GAE3B,IAAI,CAAC,QACH;GAGF,IAAI,YAAY,UAAa,OAAO,YAAY,SAC9C;GAGF,OAAO;EACT;EACA,MAAM,gBAAsC;GAC1C,MAAM,IAAI,MACR,8FACF;EACF;EACA,MAAM,UAAgC;GACpC,MAAM,IAAI,MACR,wFACF;EACF;CACF;AACF;;AAGA,eAAe,cAAc,SAAoD;CAC/E,MAAM,EAAE,IAAI,SAAS,MAAM,OAAO;CAClC,MAAM,0BAAU,IAAI,IAAyB;CAE7C,IAAI;CAEJ,IAAI;EACF,UAAU,MAAM,GAAG,QAAQ,SAAS,EAAE,eAAe,KAAK,CAAC;CAC7D,QAAQ;EAEN,OAAO;CACT;CAEA,KAAK,MAAM,SAAS,SAAS;EAC3B,IAAI,CAAC,MAAM,YAAY,GACrB;EAGF,MAAM,YAAY,KAAK,KAAK,SAAS,MAAM,MAAM,UAAU;EAE3D,IAAI;EAEJ,IAAI;GACF,OAAO,MAAM,GAAG,SAAS,WAAW,MAAM;EAC5C,QAAQ;GAEN;EACF;EAEA,MAAM,EAAE,MAAM,SAAS,iBAAiB,IAAI;EAE5C,QAAQ,IAAI,MAAM,MAAM;GACtB,MAAM,MAAM;GACZ,aAAa,KAAK,eAAe;GACjC,SAAS;GACT,MAAM,KAAK,KAAK;GAChB,MAAM,UAAU,KAAK,IAAI;GACzB,MAAM;EACR,CAAC;CACH;CAEA,OAAO;AACT;;AAGA,SAAS,eAAe,QAAwC;CAC9D,OAAO;EACL,MAAM,OAAO;EACb,aAAa,OAAO;EACpB,SAAS,OAAO;EAChB,MAAM,OAAO;EACb,MAAM,OAAO;CACf;AACF;;AAGA,SAAS,WAAW,YAAkC,QAAuC;CAC3F,IAAI,CAAC,UAAU,OAAO,WAAW,GAC/B,OAAO;CAGT,IAAI,CAAC,cAAc,WAAW,WAAW,GACvC,OAAO;CAGT,OAAO,WAAW,MAAM,QAAQ,OAAO,SAAS,GAAG,CAAC;AACtD"}

package/esm/ai/src/skills/sources/index.mjs

@@ -1,27 +0,0 @@
-import { parseFrontmatter, parseTags } from "./parse-frontmatter.mjs";
-import { directorySource } from "./directory-source.mjs";
-import { storeSource } from "./store-source.mjs";
-import { urlSource } from "./url-source.mjs";
-
-//#region ../@warlock.js/ai/src/skills/sources/index.ts
-/**
-* Resolve a declarative {@link SkillSource} into a concrete
-* {@link SkillsStoreContract} reader. Discriminated by `type` (never
-* `kind`): `directory` reads the filesystem, `url` fetches a manifest,
-* `store` passes a store through verbatim.
-*/
-function resolveSource(source) {
-	switch (source.type) {
-		case "directory": return directorySource(source.path);
-		case "url": return urlSource(source.url, {
-			headers: source.headers,
-			policy: source.policy,
-			cacheTtlMs: source.cacheTtlMs
-		});
-		case "store": return storeSource(source.store);
-	}
-}
-
-//#endregion
-export { resolveSource };
-//# sourceMappingURL=index.mjs.map