@warlock.js/ai 4.8.2 → 4.9.1

package/esm/skills/skills.mjs.map

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"skills.mjs","names":[],"sources":["../../../../../../../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/skills/sources/directory-source.d.mts

@@ -1,6 +1,6 @@
 import { SkillsStoreContract } from "../contracts/skills-store.contract.mjs";
 
-//#region ../@warlock.js/ai/src/skills/sources/directory-source.d.ts
+//#region ../ai/src/skills/sources/directory-source.d.ts
 /**
  * Read `path/<folder>/SKILL.md` into {@link SkillRecord}s, parsing the
  * same `key: value` front-matter as `scripts/generate-llms.mjs`. Each

package/esm/skills/sources/directory-source.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"directory-source.d.mts","names":[],"sources":["../../../../../../../../@warlock.js/ai/src/skills/sources/directory-source.ts"],"mappings":";;;;;AA2CA;;;;AAAqE;;;;;;iBAArD,eAAA,CAAgB,OAAA,WAAkB,mBAAmB"}
+{"version":3,"file":"directory-source.d.mts","names":[],"sources":["../../../../../../../../ai/src/skills/sources/directory-source.ts"],"mappings":";;;;;AA2CA;;;;AAAqE;;;;;;iBAArD,eAAA,CAAgB,OAAA,WAAkB,mBAAmB"}

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

@@ -1,6 +1,6 @@
 import { parseFrontmatter, parseTags } from "./parse-frontmatter.mjs";
 
-//#region ../@warlock.js/ai/src/skills/sources/directory-source.ts
+//#region ../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

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

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"directory-source.mjs","names":[],"sources":["../../../../../../../../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/skills/sources/index.d.mts

@@ -5,7 +5,7 @@ import { urlSource } from "./url-source.mjs";
 import { storeSource } from "./store-source.mjs";
 import { ParsedFrontmatter, parseFrontmatter, parseTags } from "./parse-frontmatter.mjs";
 
-//#region ../@warlock.js/ai/src/skills/sources/index.d.ts
+//#region ../ai/src/skills/sources/index.d.ts
 /**
  * Resolve a declarative {@link SkillSource} into a concrete
  * {@link SkillsStoreContract} reader. Discriminated by `type` (never

package/esm/skills/sources/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../../../../../@warlock.js/ai/src/skills/sources/index.ts"],"mappings":";;;;;;;;;AAkBA;;;;;iBAAgB,aAAA,CAAc,MAAA,EAAQ,WAAA,GAAc,mBAAmB"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../../../../../ai/src/skills/sources/index.ts"],"mappings":";;;;;;;;;AAkBA;;;;;iBAAgB,aAAA,CAAc,MAAA,EAAQ,WAAA,GAAc,mBAAmB"}

package/esm/skills/sources/index.mjs

@@ -3,7 +3,7 @@ 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
+//#region ../ai/src/skills/sources/index.ts
 /**
 * Resolve a declarative {@link SkillSource} into a concrete
 * {@link SkillsStoreContract} reader. Discriminated by `type` (never

package/esm/skills/sources/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../../../../../../../@warlock.js/ai/src/skills/sources/index.ts"],"sourcesContent":["import type { SkillSource } from \"../contracts/skills-config.type\";\nimport type { SkillsStoreContract } from \"../contracts/skills-store.contract\";\nimport { directorySource } from \"./directory-source\";\nimport { storeSource } from \"./store-source\";\nimport { urlSource } from \"./url-source\";\n\nexport { directorySource } from \"./directory-source\";\nexport { urlSource } from \"./url-source\";\nexport { storeSource } from \"./store-source\";\nexport { parseFrontmatter, parseTags } from \"./parse-frontmatter\";\nexport type { ParsedFrontmatter } from \"./parse-frontmatter\";\n\n/**\n * Resolve a declarative {@link SkillSource} into a concrete\n * {@link SkillsStoreContract} reader. Discriminated by `type` (never\n * `kind`): `directory` reads the filesystem, `url` fetches a manifest,\n * `store` passes a store through verbatim.\n */\nexport function resolveSource(source: SkillSource): SkillsStoreContract {\n  switch (source.type) {\n    case \"directory\":\n      return directorySource(source.path);\n    case \"url\":\n      return urlSource(source.url, {\n        headers: source.headers,\n        policy: source.policy,\n        cacheTtlMs: source.cacheTtlMs,\n      });\n    case \"store\":\n      return storeSource(source.store);\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAkBA,SAAgB,cAAc,QAA0C;CACtE,QAAQ,OAAO,MAAf;EACE,KAAK,aACH,OAAO,gBAAgB,OAAO,IAAI;EACpC,KAAK,OACH,OAAO,UAAU,OAAO,KAAK;GAC3B,SAAS,OAAO;GAChB,QAAQ,OAAO;GACf,YAAY,OAAO;EACrB,CAAC;EACH,KAAK,SACH,OAAO,YAAY,OAAO,KAAK;CACnC;AACF"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../../../../../ai/src/skills/sources/index.ts"],"sourcesContent":["import type { SkillSource } from \"../contracts/skills-config.type\";\nimport type { SkillsStoreContract } from \"../contracts/skills-store.contract\";\nimport { directorySource } from \"./directory-source\";\nimport { storeSource } from \"./store-source\";\nimport { urlSource } from \"./url-source\";\n\nexport { directorySource } from \"./directory-source\";\nexport { urlSource } from \"./url-source\";\nexport { storeSource } from \"./store-source\";\nexport { parseFrontmatter, parseTags } from \"./parse-frontmatter\";\nexport type { ParsedFrontmatter } from \"./parse-frontmatter\";\n\n/**\n * Resolve a declarative {@link SkillSource} into a concrete\n * {@link SkillsStoreContract} reader. Discriminated by `type` (never\n * `kind`): `directory` reads the filesystem, `url` fetches a manifest,\n * `store` passes a store through verbatim.\n */\nexport function resolveSource(source: SkillSource): SkillsStoreContract {\n  switch (source.type) {\n    case \"directory\":\n      return directorySource(source.path);\n    case \"url\":\n      return urlSource(source.url, {\n        headers: source.headers,\n        policy: source.policy,\n        cacheTtlMs: source.cacheTtlMs,\n      });\n    case \"store\":\n      return storeSource(source.store);\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAkBA,SAAgB,cAAc,QAA0C;CACtE,QAAQ,OAAO,MAAf;EACE,KAAK,aACH,OAAO,gBAAgB,OAAO,IAAI;EACpC,KAAK,OACH,OAAO,UAAU,OAAO,KAAK;GAC3B,SAAS,OAAO;GAChB,QAAQ,OAAO;GACf,YAAY,OAAO;EACrB,CAAC;EACH,KAAK,SACH,OAAO,YAAY,OAAO,KAAK;CACnC;AACF"}

package/esm/skills/sources/parse-frontmatter.d.mts

@@ -1,4 +1,4 @@
-//#region ../@warlock.js/ai/src/skills/sources/parse-frontmatter.d.ts
+//#region ../ai/src/skills/sources/parse-frontmatter.d.ts
 /** The parsed front-matter (cheap metadata) plus the stripped body. */
 type ParsedFrontmatter = {
   /** Every `key: value` line from the front-matter block, values quote-stripped. */meta: Record<string, string>; /** Everything after the closing `---`, verbatim (the skill body). */

package/esm/skills/sources/parse-frontmatter.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-frontmatter.d.mts","names":[],"sources":["../../../../../../../../@warlock.js/ai/src/skills/sources/parse-frontmatter.ts"],"mappings":";;KACY,iBAAA;EAAiB,kFAE3B,IAAA,EAAM,MAAM,kBAAA;EAEZ,IAAA;AAAA;;;AAAI;AAaN;;;;AAAiE;AAsCjE;;iBAtCgB,gBAAA,CAAiB,IAAA,WAAe,iBAAiB;;AAsCd;;;;;iBAAnC,SAAA,CAAU,KAAyB"}
+{"version":3,"file":"parse-frontmatter.d.mts","names":[],"sources":["../../../../../../../../ai/src/skills/sources/parse-frontmatter.ts"],"mappings":";;KACY,iBAAA;EAAiB,kFAE3B,IAAA,EAAM,MAAM,kBAAA;EAEZ,IAAA;AAAA;;;AAAI;AAaN;;;;AAAiE;AAsCjE;;iBAtCgB,gBAAA,CAAiB,IAAA,WAAe,iBAAiB;;AAsCd;;;;;iBAAnC,SAAA,CAAU,KAAyB"}

package/esm/skills/sources/parse-frontmatter.mjs

@@ -1,4 +1,4 @@
-//#region ../@warlock.js/ai/src/skills/sources/parse-frontmatter.ts
+//#region ../ai/src/skills/sources/parse-frontmatter.ts
 /**
 * Parse simple `key: value` YAML front-matter — the only form `SKILL.md`
 * uses (no nested objects, no block arrays). Ported verbatim from the

package/esm/skills/sources/parse-frontmatter.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"parse-frontmatter.mjs","names":[],"sources":["../../../../../../../../@warlock.js/ai/src/skills/sources/parse-frontmatter.ts"],"sourcesContent":["/** The parsed front-matter (cheap metadata) plus the stripped body. */\nexport type ParsedFrontmatter = {\n  /** Every `key: value` line from the front-matter block, values quote-stripped. */\n  meta: Record<string, string>;\n  /** Everything after the closing `---`, verbatim (the skill body). */\n  body: string;\n};\n\n/**\n * Parse simple `key: value` YAML front-matter — the only form `SKILL.md`\n * uses (no nested objects, no block arrays). Ported verbatim from the\n * package's `scripts/generate-llms.mjs` `parseFrontmatter()` so the\n * runtime catalog and the docs `llms.txt` index agree byte-for-byte on\n * what a skill's `description` is.\n *\n * When the text has no `---`-delimited front-matter block, returns an\n * empty `meta` and the full text as `body`.\n */\nexport function parseFrontmatter(text: string): ParsedFrontmatter {\n  const match = text.match(/^---\\n([\\s\\S]*?)\\n---\\n([\\s\\S]*)$/);\n\n  if (!match) {\n    return { meta: {}, body: text };\n  }\n\n  const meta: Record<string, string> = {};\n\n  for (const line of match[1].split(\"\\n\")) {\n    const colon = line.indexOf(\":\");\n\n    if (colon === -1) {\n      continue;\n    }\n\n    const key = line.slice(0, colon).trim();\n    let value = line.slice(colon + 1).trim();\n\n    if (\n      (value.startsWith(\"'\") && value.endsWith(\"'\")) ||\n      (value.startsWith('\"') && value.endsWith('\"'))\n    ) {\n      value = value.slice(1, -1).replace(/''/g, \"'\").replace(/\\\\\"/g, '\"');\n    }\n\n    meta[key] = value;\n  }\n\n  return { meta, body: match[2] };\n}\n\n/**\n * Split a front-matter `tags:` value into a string array. Accepts a\n * comma-separated inline list (`tags: frontend, react`) — the simple\n * inline form that fits the `key: value` parser. Returns `undefined` when\n * the value is absent or blank so a tagless skill stays `tags: undefined`.\n */\nexport function parseTags(value: string | undefined): string[] | undefined {\n  if (!value) {\n    return undefined;\n  }\n\n  const tags = value\n    .split(\",\")\n    .map((tag) => tag.trim())\n    .filter((tag) => tag.length > 0);\n\n  return tags.length > 0 ? tags : undefined;\n}\n"],"mappings":";;;;;;;;;;;AAkBA,SAAgB,iBAAiB,MAAiC;CAChE,MAAM,QAAQ,KAAK,MAAM,mCAAmC;CAE5D,IAAI,CAAC,OACH,OAAO;EAAE,MAAM,CAAC;EAAG,MAAM;CAAK;CAGhC,MAAM,OAA+B,CAAC;CAEtC,KAAK,MAAM,QAAQ,MAAM,EAAE,CAAC,MAAM,IAAI,GAAG;EACvC,MAAM,QAAQ,KAAK,QAAQ,GAAG;EAE9B,IAAI,UAAU,IACZ;EAGF,MAAM,MAAM,KAAK,MAAM,GAAG,KAAK,CAAC,CAAC,KAAK;EACtC,IAAI,QAAQ,KAAK,MAAM,QAAQ,CAAC,CAAC,CAAC,KAAK;EAEvC,IACG,MAAM,WAAW,GAAG,KAAK,MAAM,SAAS,GAAG,KAC3C,MAAM,WAAW,IAAG,KAAK,MAAM,SAAS,IAAG,GAE5C,QAAQ,MAAM,MAAM,GAAG,EAAE,CAAC,CAAC,QAAQ,OAAO,GAAG,CAAC,CAAC,QAAQ,QAAQ,IAAG;EAGpE,KAAK,OAAO;CACd;CAEA,OAAO;EAAE;EAAM,MAAM,MAAM;CAAG;AAChC;;;;;;;AAQA,SAAgB,UAAU,OAAiD;CACzE,IAAI,CAAC,OACH;CAGF,MAAM,OAAO,MACV,MAAM,GAAG,CAAC,CACV,KAAK,QAAQ,IAAI,KAAK,CAAC,CAAC,CACxB,QAAQ,QAAQ,IAAI,SAAS,CAAC;CAEjC,OAAO,KAAK,SAAS,IAAI,OAAO;AAClC"}
+{"version":3,"file":"parse-frontmatter.mjs","names":[],"sources":["../../../../../../../../ai/src/skills/sources/parse-frontmatter.ts"],"sourcesContent":["/** The parsed front-matter (cheap metadata) plus the stripped body. */\nexport type ParsedFrontmatter = {\n  /** Every `key: value` line from the front-matter block, values quote-stripped. */\n  meta: Record<string, string>;\n  /** Everything after the closing `---`, verbatim (the skill body). */\n  body: string;\n};\n\n/**\n * Parse simple `key: value` YAML front-matter — the only form `SKILL.md`\n * uses (no nested objects, no block arrays). Ported verbatim from the\n * package's `scripts/generate-llms.mjs` `parseFrontmatter()` so the\n * runtime catalog and the docs `llms.txt` index agree byte-for-byte on\n * what a skill's `description` is.\n *\n * When the text has no `---`-delimited front-matter block, returns an\n * empty `meta` and the full text as `body`.\n */\nexport function parseFrontmatter(text: string): ParsedFrontmatter {\n  const match = text.match(/^---\\n([\\s\\S]*?)\\n---\\n([\\s\\S]*)$/);\n\n  if (!match) {\n    return { meta: {}, body: text };\n  }\n\n  const meta: Record<string, string> = {};\n\n  for (const line of match[1].split(\"\\n\")) {\n    const colon = line.indexOf(\":\");\n\n    if (colon === -1) {\n      continue;\n    }\n\n    const key = line.slice(0, colon).trim();\n    let value = line.slice(colon + 1).trim();\n\n    if (\n      (value.startsWith(\"'\") && value.endsWith(\"'\")) ||\n      (value.startsWith('\"') && value.endsWith('\"'))\n    ) {\n      value = value.slice(1, -1).replace(/''/g, \"'\").replace(/\\\\\"/g, '\"');\n    }\n\n    meta[key] = value;\n  }\n\n  return { meta, body: match[2] };\n}\n\n/**\n * Split a front-matter `tags:` value into a string array. Accepts a\n * comma-separated inline list (`tags: frontend, react`) — the simple\n * inline form that fits the `key: value` parser. Returns `undefined` when\n * the value is absent or blank so a tagless skill stays `tags: undefined`.\n */\nexport function parseTags(value: string | undefined): string[] | undefined {\n  if (!value) {\n    return undefined;\n  }\n\n  const tags = value\n    .split(\",\")\n    .map((tag) => tag.trim())\n    .filter((tag) => tag.length > 0);\n\n  return tags.length > 0 ? tags : undefined;\n}\n"],"mappings":";;;;;;;;;;;AAkBA,SAAgB,iBAAiB,MAAiC;CAChE,MAAM,QAAQ,KAAK,MAAM,mCAAmC;CAE5D,IAAI,CAAC,OACH,OAAO;EAAE,MAAM,CAAC;EAAG,MAAM;CAAK;CAGhC,MAAM,OAA+B,CAAC;CAEtC,KAAK,MAAM,QAAQ,MAAM,EAAE,CAAC,MAAM,IAAI,GAAG;EACvC,MAAM,QAAQ,KAAK,QAAQ,GAAG;EAE9B,IAAI,UAAU,IACZ;EAGF,MAAM,MAAM,KAAK,MAAM,GAAG,KAAK,CAAC,CAAC,KAAK;EACtC,IAAI,QAAQ,KAAK,MAAM,QAAQ,CAAC,CAAC,CAAC,KAAK;EAEvC,IACG,MAAM,WAAW,GAAG,KAAK,MAAM,SAAS,GAAG,KAC3C,MAAM,WAAW,IAAG,KAAK,MAAM,SAAS,IAAG,GAE5C,QAAQ,MAAM,MAAM,GAAG,EAAE,CAAC,CAAC,QAAQ,OAAO,GAAG,CAAC,CAAC,QAAQ,QAAQ,IAAG;EAGpE,KAAK,OAAO;CACd;CAEA,OAAO;EAAE;EAAM,MAAM,MAAM;CAAG;AAChC;;;;;;;AAQA,SAAgB,UAAU,OAAiD;CACzE,IAAI,CAAC,OACH;CAGF,MAAM,OAAO,MACV,MAAM,GAAG,CAAC,CACV,KAAK,QAAQ,IAAI,KAAK,CAAC,CAAC,CACxB,QAAQ,QAAQ,IAAI,SAAS,CAAC;CAEjC,OAAO,KAAK,SAAS,IAAI,OAAO;AAClC"}

package/esm/skills/sources/store-source.d.mts

@@ -1,6 +1,6 @@
 import { SkillsStoreContract } from "../contracts/skills-store.contract.mjs";
 
-//#region ../@warlock.js/ai/src/skills/sources/store-source.d.ts
+//#region ../ai/src/skills/sources/store-source.d.ts
 /**
  * Adapt a `{ type: "store", store }` source — a pass-through to any
  * {@link SkillsStoreContract} (e.g. `MockSkillsStore`, or the Phase-2

package/esm/skills/sources/store-source.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"store-source.d.mts","names":[],"sources":["../../../../../../../../@warlock.js/ai/src/skills/sources/store-source.ts"],"mappings":";;;;;AASA;;;;;iBAAgB,WAAA,CAAY,KAAA,EAAO,mBAAA,GAAsB,mBAAmB"}
+{"version":3,"file":"store-source.d.mts","names":[],"sources":["../../../../../../../../ai/src/skills/sources/store-source.ts"],"mappings":";;;;;AASA;;;;;iBAAgB,WAAA,CAAY,KAAA,EAAO,mBAAA,GAAsB,mBAAmB"}

package/esm/skills/sources/store-source.mjs

@@ -1,4 +1,4 @@
-//#region ../@warlock.js/ai/src/skills/sources/store-source.ts
+//#region ../ai/src/skills/sources/store-source.ts
 /**
 * Adapt a `{ type: "store", store }` source — a pass-through to any
 * {@link SkillsStoreContract} (e.g. `MockSkillsStore`, or the Phase-2

package/esm/skills/sources/store-source.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"store-source.mjs","names":[],"sources":["../../../../../../../../@warlock.js/ai/src/skills/sources/store-source.ts"],"sourcesContent":["import type { SkillsStoreContract } from \"../contracts/skills-store.contract\";\n\n/**\n * Adapt a `{ type: \"store\", store }` source — a pass-through to any\n * {@link SkillsStoreContract} (e.g. `MockSkillsStore`, or the Phase-2\n * `ProceduralSkillStore`). The store already implements every reader\n * method, so this is identity; it exists for symmetry with the directory\n * and url sources and to keep `resolveSource` a single dispatch table.\n */\nexport function storeSource(store: SkillsStoreContract): SkillsStoreContract {\n  return store;\n}\n"],"mappings":";;;;;;;;AASA,SAAgB,YAAY,OAAiD;CAC3E,OAAO;AACT"}
+{"version":3,"file":"store-source.mjs","names":[],"sources":["../../../../../../../../ai/src/skills/sources/store-source.ts"],"sourcesContent":["import type { SkillsStoreContract } from \"../contracts/skills-store.contract\";\n\n/**\n * Adapt a `{ type: \"store\", store }` source — a pass-through to any\n * {@link SkillsStoreContract} (e.g. `MockSkillsStore`, or the Phase-2\n * `ProceduralSkillStore`). The store already implements every reader\n * method, so this is identity; it exists for symmetry with the directory\n * and url sources and to keep `resolveSource` a single dispatch table.\n */\nexport function storeSource(store: SkillsStoreContract): SkillsStoreContract {\n  return store;\n}\n"],"mappings":";;;;;;;;AASA,SAAgB,YAAY,OAAiD;CAC3E,OAAO;AACT"}

package/esm/skills/sources/url-source.d.mts

@@ -1,7 +1,7 @@
 import { OutboundPolicy } from "../../security/outbound-policy.type.mjs";
 import { SkillsStoreContract } from "../contracts/skills-store.contract.mjs";
 
-//#region ../@warlock.js/ai/src/skills/sources/url-source.d.ts
+//#region ../ai/src/skills/sources/url-source.d.ts
 /** Options for {@link urlSource} (S3). */
 type UrlSourceOptions = {
   headers?: Record<string, string>; /** Fetch hardening for the manifest request. */

package/esm/skills/sources/url-source.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"url-source.d.mts","names":[],"sources":["../../../../../../../../@warlock.js/ai/src/skills/sources/url-source.ts"],"mappings":";;;;;KAgBY,gBAAA;EACV,OAAA,GAAU,MAAA,kBADgB;EAG1B,MAAA,GAAS,cAAc,EAAA;EAEvB,UAAA;AAAA;;;;;AAAU;AAkBZ;;;;;;;;;AAGsB;iBAHN,SAAA,CACd,GAAA,UACA,OAAA,GAAS,gBAAA,GACR,mBAAmB"}
+{"version":3,"file":"url-source.d.mts","names":[],"sources":["../../../../../../../../ai/src/skills/sources/url-source.ts"],"mappings":";;;;;KAgBY,gBAAA;EACV,OAAA,GAAU,MAAA,kBADgB;EAG1B,MAAA,GAAS,cAAc,EAAA;EAEvB,UAAA;AAAA;;;;;AAAU;AAkBZ;;;;;;;;;AAGsB;iBAHN,SAAA,CACd,GAAA,UACA,OAAA,GAAS,gBAAA,GACR,mBAAmB"}

package/esm/skills/sources/url-source.mjs

@@ -1,6 +1,6 @@
 import { fetchTextWithPolicy } from "../../security/outbound-policy.mjs";
 
-//#region ../@warlock.js/ai/src/skills/sources/url-source.ts
+//#region ../ai/src/skills/sources/url-source.ts
 /**
 * Read skills from a remote JSON manifest at `url`. The manifest is a flat
 * array of {@link SkillRecord}s (bodies inline).

package/esm/skills/sources/url-source.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"url-source.mjs","names":[],"sources":["../../../../../../../../@warlock.js/ai/src/skills/sources/url-source.ts"],"sourcesContent":["import { fetchTextWithPolicy } from \"../../security/outbound-policy\";\nimport type { OutboundPolicy } from \"../../security/outbound-policy.type\";\nimport type {\n  SkillCatalogEntry,\n  SkillRecord,\n} from \"../contracts/skill-record.type\";\nimport type { SkillsStoreContract } from \"../contracts/skills-store.contract\";\n\n/**\n * The JSON manifest shape a `url` source fetches — a flat array of skill\n * records. Bodies travel inline; the catalog projection drops them so the\n * always-injected metadata block stays cheap.\n */\ntype SkillManifest = SkillRecord[];\n\n/** Options for {@link urlSource} (S3). */\nexport type UrlSourceOptions = {\n  headers?: Record<string, string>;\n  /** Fetch hardening for the manifest request. */\n  policy?: OutboundPolicy;\n  /** Cache the manifest for this many ms; omit to cache for the source's lifetime. */\n  cacheTtlMs?: number;\n};\n\n/**\n * Read skills from a remote JSON manifest at `url`. The manifest is a flat\n * array of {@link SkillRecord}s (bodies inline).\n *\n * **Trust boundary (S3).** A remote skill source is a prompt supply chain —\n * its bodies flow straight into model context — so the manifest fetch runs\n * through the shared `OutboundPolicy` (scheme + host allowlist, post-DNS\n * private-IP deny, max bytes, timeout) and **every record is runtime-\n * validated** before it can be served. A malformed record fails loudly\n * rather than being cast blindly into a `SkillRecord`.\n *\n * The request is made lazily on the first `list()` / `load()`. The result\n * is cached for the source's lifetime, or for `cacheTtlMs` when set\n * (a stale cache refetches on next access).\n */\nexport function urlSource(\n  url: string,\n  options: UrlSourceOptions = {},\n): SkillsStoreContract {\n  const { headers, policy, cacheTtlMs } = options;\n\n  let cache: Promise<Map<string, SkillRecord>> | undefined;\n  let cachedAtMs: number | undefined;\n\n  const records = (): Promise<Map<string, SkillRecord>> => {\n    const expired =\n      cacheTtlMs !== undefined &&\n      cachedAtMs !== undefined &&\n      Date.now() - cachedAtMs > cacheTtlMs;\n\n    if (!cache || expired) {\n      cachedAtMs = Date.now();\n      cache = fetchManifest(url, headers, policy);\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 => record.type !== \"candidate\")\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 || record.type === \"candidate\") {\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        \"url source is read-only — saveCandidate requires a writable store (set `review.store`)\",\n      );\n    },\n    async promote(): Promise<SkillRecord> {\n      throw new Error(\n        \"url source is read-only — promote requires a writable store (set `review.store`)\",\n      );\n    },\n  };\n}\n\n/** Fetch + validate + parse the manifest once into a name → record map. */\nasync function fetchManifest(\n  url: string,\n  headers: Record<string, string> | undefined,\n  policy: OutboundPolicy | undefined,\n): Promise<Map<string, SkillRecord>> {\n  const result = await fetchTextWithPolicy(\n    url,\n    policy ?? {},\n    headers ? { headers } : undefined,\n  );\n\n  if (!result.ok) {\n    throw new Error(\n      `url skill source failed: ${result.status} ${result.statusText} for ${url}`,\n    );\n  }\n\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(result.text);\n  } catch (cause) {\n    throw new Error(`url skill source returned invalid JSON from ${url}`, {\n      cause,\n    });\n  }\n\n  if (!Array.isArray(parsed)) {\n    throw new Error(\n      `url skill source at ${url} must return a JSON array of skill records`,\n    );\n  }\n\n  const records = new Map<string, SkillRecord>();\n\n  (parsed as SkillManifest).forEach((raw, index) => {\n    const record = validateManifestRecord(raw, url, index);\n    records.set(record.name, record);\n  });\n\n  return records;\n}\n\n/**\n * Runtime-validate one manifest record before it is trusted as a\n * {@link SkillRecord}. Untyped remote JSON cast blindly into the context\n * is both an injection surface and a correctness bug; this rejects a\n * record missing the required `name` / `description` / `body` strings, and\n * fills `version` / `type` defaults for a thin record.\n */\nfunction validateManifestRecord(\n  raw: unknown,\n  url: string,\n  index: number,\n): SkillRecord {\n  if (!raw || typeof raw !== \"object\") {\n    throw new Error(`url skill source at ${url}: record #${index} is not an object`);\n  }\n\n  const r = raw as Record<string, unknown>;\n  const requireString = (field: string): string => {\n    const value = r[field];\n    if (typeof value !== \"string\" || value.length === 0) {\n      throw new Error(\n        `url skill source at ${url}: record #${index} is missing a string \"${field}\"`,\n      );\n    }\n    return value;\n  };\n\n  const name = requireString(\"name\");\n  const description = requireString(\"description\");\n  const body = requireString(\"body\");\n\n  const type =\n    r.type === \"authored\" || r.type === \"promoted\" || r.type === \"candidate\"\n      ? r.type\n      : \"authored\";\n  const version = typeof r.version === \"number\" ? r.version : 1;\n  const tags = Array.isArray(r.tags)\n    ? r.tags.filter((t): t is string => typeof t === \"string\")\n    : undefined;\n  const metadata =\n    r.metadata && typeof r.metadata === \"object\"\n      ? (r.metadata as Record<string, unknown>)\n      : undefined;\n\n  return { name, description, body, version, type, tags, metadata };\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":";;;;;;;;;;;;;;;;;;AAuCA,SAAgB,UACd,KACA,UAA4B,CAAC,GACR;CACrB,MAAM,EAAE,SAAS,QAAQ,eAAe;CAExC,IAAI;CACJ,IAAI;CAEJ,MAAM,gBAAmD;EACvD,MAAM,UACJ,eAAe,UACf,eAAe,UACf,KAAK,IAAI,IAAI,aAAa;EAE5B,IAAI,CAAC,SAAS,SAAS;GACrB,aAAa,KAAK,IAAI;GACtB,QAAQ,cAAc,KAAK,SAAS,MAAM;EAC5C;EAEA,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,QAAO,WAAU,OAAO,SAAS,WAAW,CAAC,CAC7C,QAAO,WAAU,WAAW,OAAO,MAAM,MAAM,CAAC,CAAC,CACjD,IAAI,cAAc;EACvB;EACA,MAAM,KAAK,MAAc,SAAoD;GAE3E,MAAM,UAAS,MADG,QAAQ,EACR,CAAC,IAAI,IAAI;GAE3B,IAAI,CAAC,UAAU,OAAO,SAAS,aAC7B;GAGF,IAAI,YAAY,UAAa,OAAO,YAAY,SAC9C;GAGF,OAAO;EACT;EACA,MAAM,gBAAsC;GAC1C,MAAM,IAAI,MACR,wFACF;EACF;EACA,MAAM,UAAgC;GACpC,MAAM,IAAI,MACR,kFACF;EACF;CACF;AACF;;AAGA,eAAe,cACb,KACA,SACA,QACmC;CACnC,MAAM,SAAS,MAAM,oBACnB,KACA,UAAU,CAAC,GACX,UAAU,EAAE,QAAQ,IAAI,MAC1B;CAEA,IAAI,CAAC,OAAO,IACV,MAAM,IAAI,MACR,4BAA4B,OAAO,OAAO,GAAG,OAAO,WAAW,OAAO,KACxE;CAGF,IAAI;CACJ,IAAI;EACF,SAAS,KAAK,MAAM,OAAO,IAAI;CACjC,SAAS,OAAO;EACd,MAAM,IAAI,MAAM,+CAA+C,OAAO,EACpE,MACF,CAAC;CACH;CAEA,IAAI,CAAC,MAAM,QAAQ,MAAM,GACvB,MAAM,IAAI,MACR,uBAAuB,IAAI,2CAC7B;CAGF,MAAM,0BAAU,IAAI,IAAyB;CAE7C,AAAC,OAAyB,SAAS,KAAK,UAAU;EAChD,MAAM,SAAS,uBAAuB,KAAK,KAAK,KAAK;EACrD,QAAQ,IAAI,OAAO,MAAM,MAAM;CACjC,CAAC;CAED,OAAO;AACT;;;;;;;;AASA,SAAS,uBACP,KACA,KACA,OACa;CACb,IAAI,CAAC,OAAO,OAAO,QAAQ,UACzB,MAAM,IAAI,MAAM,uBAAuB,IAAI,YAAY,MAAM,kBAAkB;CAGjF,MAAM,IAAI;CACV,MAAM,iBAAiB,UAA0B;EAC/C,MAAM,QAAQ,EAAE;EAChB,IAAI,OAAO,UAAU,YAAY,MAAM,WAAW,GAChD,MAAM,IAAI,MACR,uBAAuB,IAAI,YAAY,MAAM,wBAAwB,MAAM,EAC7E;EAEF,OAAO;CACT;CAEA,MAAM,OAAO,cAAc,MAAM;CACjC,MAAM,cAAc,cAAc,aAAa;CAC/C,MAAM,OAAO,cAAc,MAAM;CAEjC,MAAM,OACJ,EAAE,SAAS,cAAc,EAAE,SAAS,cAAc,EAAE,SAAS,cACzD,EAAE,OACF;CAUN,OAAO;EAAE;EAAM;EAAa;EAAM,SATlB,OAAO,EAAE,YAAY,WAAW,EAAE,UAAU;EASjB;EAAM,MARpC,MAAM,QAAQ,EAAE,IAAI,IAC7B,EAAE,KAAK,QAAQ,MAAmB,OAAO,MAAM,QAAQ,IACvD;EAMmD,UAJrD,EAAE,YAAY,OAAO,EAAE,aAAa,WAC/B,EAAE,WACH;CAE0D;AAClE;;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,MAAK,QAAO,OAAO,SAAS,GAAG,CAAC;AACpD"}
+{"version":3,"file":"url-source.mjs","names":[],"sources":["../../../../../../../../ai/src/skills/sources/url-source.ts"],"sourcesContent":["import { fetchTextWithPolicy } from \"../../security/outbound-policy\";\nimport type { OutboundPolicy } from \"../../security/outbound-policy.type\";\nimport type {\n  SkillCatalogEntry,\n  SkillRecord,\n} from \"../contracts/skill-record.type\";\nimport type { SkillsStoreContract } from \"../contracts/skills-store.contract\";\n\n/**\n * The JSON manifest shape a `url` source fetches — a flat array of skill\n * records. Bodies travel inline; the catalog projection drops them so the\n * always-injected metadata block stays cheap.\n */\ntype SkillManifest = SkillRecord[];\n\n/** Options for {@link urlSource} (S3). */\nexport type UrlSourceOptions = {\n  headers?: Record<string, string>;\n  /** Fetch hardening for the manifest request. */\n  policy?: OutboundPolicy;\n  /** Cache the manifest for this many ms; omit to cache for the source's lifetime. */\n  cacheTtlMs?: number;\n};\n\n/**\n * Read skills from a remote JSON manifest at `url`. The manifest is a flat\n * array of {@link SkillRecord}s (bodies inline).\n *\n * **Trust boundary (S3).** A remote skill source is a prompt supply chain —\n * its bodies flow straight into model context — so the manifest fetch runs\n * through the shared `OutboundPolicy` (scheme + host allowlist, post-DNS\n * private-IP deny, max bytes, timeout) and **every record is runtime-\n * validated** before it can be served. A malformed record fails loudly\n * rather than being cast blindly into a `SkillRecord`.\n *\n * The request is made lazily on the first `list()` / `load()`. The result\n * is cached for the source's lifetime, or for `cacheTtlMs` when set\n * (a stale cache refetches on next access).\n */\nexport function urlSource(\n  url: string,\n  options: UrlSourceOptions = {},\n): SkillsStoreContract {\n  const { headers, policy, cacheTtlMs } = options;\n\n  let cache: Promise<Map<string, SkillRecord>> | undefined;\n  let cachedAtMs: number | undefined;\n\n  const records = (): Promise<Map<string, SkillRecord>> => {\n    const expired =\n      cacheTtlMs !== undefined &&\n      cachedAtMs !== undefined &&\n      Date.now() - cachedAtMs > cacheTtlMs;\n\n    if (!cache || expired) {\n      cachedAtMs = Date.now();\n      cache = fetchManifest(url, headers, policy);\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 => record.type !== \"candidate\")\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 || record.type === \"candidate\") {\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        \"url source is read-only — saveCandidate requires a writable store (set `review.store`)\",\n      );\n    },\n    async promote(): Promise<SkillRecord> {\n      throw new Error(\n        \"url source is read-only — promote requires a writable store (set `review.store`)\",\n      );\n    },\n  };\n}\n\n/** Fetch + validate + parse the manifest once into a name → record map. */\nasync function fetchManifest(\n  url: string,\n  headers: Record<string, string> | undefined,\n  policy: OutboundPolicy | undefined,\n): Promise<Map<string, SkillRecord>> {\n  const result = await fetchTextWithPolicy(\n    url,\n    policy ?? {},\n    headers ? { headers } : undefined,\n  );\n\n  if (!result.ok) {\n    throw new Error(\n      `url skill source failed: ${result.status} ${result.statusText} for ${url}`,\n    );\n  }\n\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(result.text);\n  } catch (cause) {\n    throw new Error(`url skill source returned invalid JSON from ${url}`, {\n      cause,\n    });\n  }\n\n  if (!Array.isArray(parsed)) {\n    throw new Error(\n      `url skill source at ${url} must return a JSON array of skill records`,\n    );\n  }\n\n  const records = new Map<string, SkillRecord>();\n\n  (parsed as SkillManifest).forEach((raw, index) => {\n    const record = validateManifestRecord(raw, url, index);\n    records.set(record.name, record);\n  });\n\n  return records;\n}\n\n/**\n * Runtime-validate one manifest record before it is trusted as a\n * {@link SkillRecord}. Untyped remote JSON cast blindly into the context\n * is both an injection surface and a correctness bug; this rejects a\n * record missing the required `name` / `description` / `body` strings, and\n * fills `version` / `type` defaults for a thin record.\n */\nfunction validateManifestRecord(\n  raw: unknown,\n  url: string,\n  index: number,\n): SkillRecord {\n  if (!raw || typeof raw !== \"object\") {\n    throw new Error(`url skill source at ${url}: record #${index} is not an object`);\n  }\n\n  const r = raw as Record<string, unknown>;\n  const requireString = (field: string): string => {\n    const value = r[field];\n    if (typeof value !== \"string\" || value.length === 0) {\n      throw new Error(\n        `url skill source at ${url}: record #${index} is missing a string \"${field}\"`,\n      );\n    }\n    return value;\n  };\n\n  const name = requireString(\"name\");\n  const description = requireString(\"description\");\n  const body = requireString(\"body\");\n\n  const type =\n    r.type === \"authored\" || r.type === \"promoted\" || r.type === \"candidate\"\n      ? r.type\n      : \"authored\";\n  const version = typeof r.version === \"number\" ? r.version : 1;\n  const tags = Array.isArray(r.tags)\n    ? r.tags.filter((t): t is string => typeof t === \"string\")\n    : undefined;\n  const metadata =\n    r.metadata && typeof r.metadata === \"object\"\n      ? (r.metadata as Record<string, unknown>)\n      : undefined;\n\n  return { name, description, body, version, type, tags, metadata };\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":";;;;;;;;;;;;;;;;;;AAuCA,SAAgB,UACd,KACA,UAA4B,CAAC,GACR;CACrB,MAAM,EAAE,SAAS,QAAQ,eAAe;CAExC,IAAI;CACJ,IAAI;CAEJ,MAAM,gBAAmD;EACvD,MAAM,UACJ,eAAe,UACf,eAAe,UACf,KAAK,IAAI,IAAI,aAAa;EAE5B,IAAI,CAAC,SAAS,SAAS;GACrB,aAAa,KAAK,IAAI;GACtB,QAAQ,cAAc,KAAK,SAAS,MAAM;EAC5C;EAEA,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,QAAO,WAAU,OAAO,SAAS,WAAW,CAAC,CAC7C,QAAO,WAAU,WAAW,OAAO,MAAM,MAAM,CAAC,CAAC,CACjD,IAAI,cAAc;EACvB;EACA,MAAM,KAAK,MAAc,SAAoD;GAE3E,MAAM,UAAS,MADG,QAAQ,EACR,CAAC,IAAI,IAAI;GAE3B,IAAI,CAAC,UAAU,OAAO,SAAS,aAC7B;GAGF,IAAI,YAAY,UAAa,OAAO,YAAY,SAC9C;GAGF,OAAO;EACT;EACA,MAAM,gBAAsC;GAC1C,MAAM,IAAI,MACR,wFACF;EACF;EACA,MAAM,UAAgC;GACpC,MAAM,IAAI,MACR,kFACF;EACF;CACF;AACF;;AAGA,eAAe,cACb,KACA,SACA,QACmC;CACnC,MAAM,SAAS,MAAM,oBACnB,KACA,UAAU,CAAC,GACX,UAAU,EAAE,QAAQ,IAAI,MAC1B;CAEA,IAAI,CAAC,OAAO,IACV,MAAM,IAAI,MACR,4BAA4B,OAAO,OAAO,GAAG,OAAO,WAAW,OAAO,KACxE;CAGF,IAAI;CACJ,IAAI;EACF,SAAS,KAAK,MAAM,OAAO,IAAI;CACjC,SAAS,OAAO;EACd,MAAM,IAAI,MAAM,+CAA+C,OAAO,EACpE,MACF,CAAC;CACH;CAEA,IAAI,CAAC,MAAM,QAAQ,MAAM,GACvB,MAAM,IAAI,MACR,uBAAuB,IAAI,2CAC7B;CAGF,MAAM,0BAAU,IAAI,IAAyB;CAE7C,AAAC,OAAyB,SAAS,KAAK,UAAU;EAChD,MAAM,SAAS,uBAAuB,KAAK,KAAK,KAAK;EACrD,QAAQ,IAAI,OAAO,MAAM,MAAM;CACjC,CAAC;CAED,OAAO;AACT;;;;;;;;AASA,SAAS,uBACP,KACA,KACA,OACa;CACb,IAAI,CAAC,OAAO,OAAO,QAAQ,UACzB,MAAM,IAAI,MAAM,uBAAuB,IAAI,YAAY,MAAM,kBAAkB;CAGjF,MAAM,IAAI;CACV,MAAM,iBAAiB,UAA0B;EAC/C,MAAM,QAAQ,EAAE;EAChB,IAAI,OAAO,UAAU,YAAY,MAAM,WAAW,GAChD,MAAM,IAAI,MACR,uBAAuB,IAAI,YAAY,MAAM,wBAAwB,MAAM,EAC7E;EAEF,OAAO;CACT;CAEA,MAAM,OAAO,cAAc,MAAM;CACjC,MAAM,cAAc,cAAc,aAAa;CAC/C,MAAM,OAAO,cAAc,MAAM;CAEjC,MAAM,OACJ,EAAE,SAAS,cAAc,EAAE,SAAS,cAAc,EAAE,SAAS,cACzD,EAAE,OACF;CAUN,OAAO;EAAE;EAAM;EAAa;EAAM,SATlB,OAAO,EAAE,YAAY,WAAW,EAAE,UAAU;EASjB;EAAM,MARpC,MAAM,QAAQ,EAAE,IAAI,IAC7B,EAAE,KAAK,QAAQ,MAAmB,OAAO,MAAM,QAAQ,IACvD;EAMmD,UAJrD,EAAE,YAAY,OAAO,EAAE,aAAa,WAC/B,EAAE,WACH;CAE0D;AAClE;;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,MAAK,QAAO,OAAO,SAAS,GAAG,CAAC;AACpD"}

package/esm/skills/store/mock-skills-store.d.mts

@@ -1,7 +1,7 @@
 import { SkillCatalogEntry, SkillRecord } from "../contracts/skill-record.type.mjs";
 import { SkillsStoreContract } from "../contracts/skills-store.contract.mjs";
 
-//#region ../@warlock.js/ai/src/skills/store/mock-skills-store.d.ts
+//#region ../ai/src/skills/store/mock-skills-store.d.ts
 /**
  * In-memory {@link SkillsStoreContract} that ships with the package.
  *

package/esm/skills/store/mock-skills-store.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"mock-skills-store.d.mts","names":[],"sources":["../../../../../../../../@warlock.js/ai/src/skills/store/mock-skills-store.ts"],"mappings":";;;;;;AAyBA;;;;;;;;;;;;;;;;;cAAa,eAAA,YAA2B,mBAAA;EAErB;EAAA,iBAAA,OAAA;cAEE,IAAA,GAAM,WAAA;EAAN;;;;;EAWN,IAAA,CAAK,KAAA;IAAU,IAAA;EAAA,IAAoB,OAAA,CAAQ,iBAAA;EAcxB;;;;;EAAnB,IAAA,CAAK,IAAA,UAAc,OAAA,YAAmB,OAAA,CAAQ,WAAA;EAoBzD;;;;;EADW,aAAA,CACX,MAAA,EAAQ,IAAA,CAAK,WAAA,wBACZ,OAAA,CAAQ,WAAA;EAiBiC;;AAAW;;;EAA1C,OAAA,CAAQ,IAAA,WAAe,OAAA,CAAQ,WAAA;AAAA"}
+{"version":3,"file":"mock-skills-store.d.mts","names":[],"sources":["../../../../../../../../ai/src/skills/store/mock-skills-store.ts"],"mappings":";;;;;;AAyBA;;;;;;;;;;;;;;;;;cAAa,eAAA,YAA2B,mBAAA;EAErB;EAAA,iBAAA,OAAA;cAEE,IAAA,GAAM,WAAA;EAAN;;;;;EAWN,IAAA,CAAK,KAAA;IAAU,IAAA;EAAA,IAAoB,OAAA,CAAQ,iBAAA;EAcxB;;;;;EAAnB,IAAA,CAAK,IAAA,UAAc,OAAA,YAAmB,OAAA,CAAQ,WAAA;EAoBzD;;;;;EADW,aAAA,CACX,MAAA,EAAQ,IAAA,CAAK,WAAA,wBACZ,OAAA,CAAQ,WAAA;EAiBiC;;AAAW;;;EAA1C,OAAA,CAAQ,IAAA,WAAe,OAAA,CAAQ,WAAA;AAAA"}

package/esm/skills/store/mock-skills-store.mjs

@@ -1,4 +1,4 @@
-//#region ../@warlock.js/ai/src/skills/store/mock-skills-store.ts
+//#region ../ai/src/skills/store/mock-skills-store.ts
 /**
 * In-memory {@link SkillsStoreContract} that ships with the package.
 *

package/esm/skills/store/mock-skills-store.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"mock-skills-store.mjs","names":[],"sources":["../../../../../../../../@warlock.js/ai/src/skills/store/mock-skills-store.ts"],"sourcesContent":["import type {\n  SkillCatalogEntry,\n  SkillRecord,\n} from \"../contracts/skill-record.type\";\nimport type { SkillsStoreContract } from \"../contracts/skills-store.contract\";\n\n/**\n * In-memory {@link SkillsStoreContract} that ships with the package.\n *\n * Backs tests and small/ephemeral skill libraries with zero external\n * dependencies. Holds the **latest** record per skill name; `saveCandidate`\n * writes an INERT `type: \"candidate\"` (never injectable until promoted),\n * and `promote` flips it to `type: \"promoted\"` with a monotonic\n * `version + 1`.\n *\n * Construct via `new MockSkillsStore([...records])` — it is a concrete\n * test/utility store, not a factory-fronted runtime primitive, so `new`\n * is the public surface here.\n *\n * @example\n * const store = new MockSkillsStore([\n *   { name: \"scaffold\", description: \"Scaffold a form\", version: 1, body: \"...\", type: \"authored\" },\n * ]);\n * const lib = skills({ name: \"build\", sources: [{ type: \"store\", store }] });\n */\nexport class MockSkillsStore implements SkillsStoreContract {\n  /** Latest record per skill name. */\n  private readonly records = new Map<string, SkillRecord>();\n\n  public constructor(seed: SkillRecord[] = []) {\n    for (const record of seed) {\n      this.records.set(record.name, { ...record });\n    }\n  }\n\n  /**\n   * List the cheap catalog metadata for every NON-candidate skill,\n   * optionally filtered to those whose `tags` intersect `scope.tags`.\n   * Candidates are filtered out — they can never be catalogued or injected.\n   */\n  public async list(scope?: { tags?: string[] }): Promise<SkillCatalogEntry[]> {\n    const wanted = scope?.tags;\n\n    return [...this.records.values()]\n      .filter((record) => record.type !== \"candidate\")\n      .filter((record) => intersects(record.tags, wanted))\n      .map(toCatalogEntry);\n  }\n\n  /**\n   * Load the full record for `name`. When `version` is given, returns the\n   * record only if its version matches (pin); otherwise the latest. A\n   * `candidate` is never returned here — it is inert until promoted.\n   */\n  public async load(name: string, version?: number): Promise<SkillRecord | undefined> {\n    const record = this.records.get(name);\n\n    if (!record || record.type === \"candidate\") {\n      return undefined;\n    }\n\n    if (version !== undefined && record.version !== version) {\n      return undefined;\n    }\n\n    return { ...record };\n  }\n\n  /**\n   * Write an INERT candidate (`type: \"candidate\"`, `version: 0`). A\n   * candidate is filtered out of `list()` / `load()` — it can never be\n   * injected until a `review` gate promotes it.\n   */\n  public async saveCandidate(\n    record: Omit<SkillRecord, \"version\" | \"type\">,\n  ): Promise<SkillRecord> {\n    const candidate: SkillRecord = {\n      ...record,\n      version: 0,\n      type: \"candidate\",\n    };\n\n    this.records.set(candidate.name, candidate);\n\n    return { ...candidate };\n  }\n\n  /**\n   * Promote the stored candidate for `name` to a new monotonic version\n   * (`type: \"promoted\"`, `version + 1`). Throws when there is no candidate\n   * to promote — promotion of a non-existent skill is a programming error.\n   */\n  public async promote(name: string): Promise<SkillRecord> {\n    const existing = this.records.get(name);\n\n    if (!existing) {\n      throw new Error(`MockSkillsStore.promote: no skill named \"${name}\" to promote`);\n    }\n\n    const promoted: SkillRecord = {\n      ...existing,\n      version: existing.version + 1,\n      type: \"promoted\",\n    };\n\n    this.records.set(name, promoted);\n\n    return { ...promoted };\n  }\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/**\n * True when no filter tags are requested, or when the record carries at\n * least one of the requested tags. A tagless record matches only the\n * unfiltered case.\n */\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":";;;;;;;;;;;;;;;;;;;;AAyBA,IAAa,kBAAb,MAA4D;CAI1D,AAAO,YAAY,OAAsB,CAAC,GAAG;iCAFlB,IAAI,IAAyB;EAGtD,KAAK,MAAM,UAAU,MACnB,KAAK,QAAQ,IAAI,OAAO,MAAM,EAAE,GAAG,OAAO,CAAC;CAE/C;;;;;;CAOA,MAAa,KAAK,OAA2D;EAC3E,MAAM,SAAS,OAAO;EAEtB,OAAO,CAAC,GAAG,KAAK,QAAQ,OAAO,CAAC,CAAC,CAC9B,QAAQ,WAAW,OAAO,SAAS,WAAW,CAAC,CAC/C,QAAQ,WAAW,WAAW,OAAO,MAAM,MAAM,CAAC,CAAC,CACnD,IAAI,cAAc;CACvB;;;;;;CAOA,MAAa,KAAK,MAAc,SAAoD;EAClF,MAAM,SAAS,KAAK,QAAQ,IAAI,IAAI;EAEpC,IAAI,CAAC,UAAU,OAAO,SAAS,aAC7B;EAGF,IAAI,YAAY,UAAa,OAAO,YAAY,SAC9C;EAGF,OAAO,EAAE,GAAG,OAAO;CACrB;;;;;;CAOA,MAAa,cACX,QACsB;EACtB,MAAM,YAAyB;GAC7B,GAAG;GACH,SAAS;GACT,MAAM;EACR;EAEA,KAAK,QAAQ,IAAI,UAAU,MAAM,SAAS;EAE1C,OAAO,EAAE,GAAG,UAAU;CACxB;;;;;;CAOA,MAAa,QAAQ,MAAoC;EACvD,MAAM,WAAW,KAAK,QAAQ,IAAI,IAAI;EAEtC,IAAI,CAAC,UACH,MAAM,IAAI,MAAM,4CAA4C,KAAK,aAAa;EAGhF,MAAM,WAAwB;GAC5B,GAAG;GACH,SAAS,SAAS,UAAU;GAC5B,MAAM;EACR;EAEA,KAAK,QAAQ,IAAI,MAAM,QAAQ;EAE/B,OAAO,EAAE,GAAG,SAAS;CACvB;AACF;;AAGA,SAAS,eAAe,QAAwC;CAC9D,OAAO;EACL,MAAM,OAAO;EACb,aAAa,OAAO;EACpB,SAAS,OAAO;EAChB,MAAM,OAAO;EACb,MAAM,OAAO;CACf;AACF;;;;;;AAOA,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"}
+{"version":3,"file":"mock-skills-store.mjs","names":[],"sources":["../../../../../../../../ai/src/skills/store/mock-skills-store.ts"],"sourcesContent":["import type {\n  SkillCatalogEntry,\n  SkillRecord,\n} from \"../contracts/skill-record.type\";\nimport type { SkillsStoreContract } from \"../contracts/skills-store.contract\";\n\n/**\n * In-memory {@link SkillsStoreContract} that ships with the package.\n *\n * Backs tests and small/ephemeral skill libraries with zero external\n * dependencies. Holds the **latest** record per skill name; `saveCandidate`\n * writes an INERT `type: \"candidate\"` (never injectable until promoted),\n * and `promote` flips it to `type: \"promoted\"` with a monotonic\n * `version + 1`.\n *\n * Construct via `new MockSkillsStore([...records])` — it is a concrete\n * test/utility store, not a factory-fronted runtime primitive, so `new`\n * is the public surface here.\n *\n * @example\n * const store = new MockSkillsStore([\n *   { name: \"scaffold\", description: \"Scaffold a form\", version: 1, body: \"...\", type: \"authored\" },\n * ]);\n * const lib = skills({ name: \"build\", sources: [{ type: \"store\", store }] });\n */\nexport class MockSkillsStore implements SkillsStoreContract {\n  /** Latest record per skill name. */\n  private readonly records = new Map<string, SkillRecord>();\n\n  public constructor(seed: SkillRecord[] = []) {\n    for (const record of seed) {\n      this.records.set(record.name, { ...record });\n    }\n  }\n\n  /**\n   * List the cheap catalog metadata for every NON-candidate skill,\n   * optionally filtered to those whose `tags` intersect `scope.tags`.\n   * Candidates are filtered out — they can never be catalogued or injected.\n   */\n  public async list(scope?: { tags?: string[] }): Promise<SkillCatalogEntry[]> {\n    const wanted = scope?.tags;\n\n    return [...this.records.values()]\n      .filter((record) => record.type !== \"candidate\")\n      .filter((record) => intersects(record.tags, wanted))\n      .map(toCatalogEntry);\n  }\n\n  /**\n   * Load the full record for `name`. When `version` is given, returns the\n   * record only if its version matches (pin); otherwise the latest. A\n   * `candidate` is never returned here — it is inert until promoted.\n   */\n  public async load(name: string, version?: number): Promise<SkillRecord | undefined> {\n    const record = this.records.get(name);\n\n    if (!record || record.type === \"candidate\") {\n      return undefined;\n    }\n\n    if (version !== undefined && record.version !== version) {\n      return undefined;\n    }\n\n    return { ...record };\n  }\n\n  /**\n   * Write an INERT candidate (`type: \"candidate\"`, `version: 0`). A\n   * candidate is filtered out of `list()` / `load()` — it can never be\n   * injected until a `review` gate promotes it.\n   */\n  public async saveCandidate(\n    record: Omit<SkillRecord, \"version\" | \"type\">,\n  ): Promise<SkillRecord> {\n    const candidate: SkillRecord = {\n      ...record,\n      version: 0,\n      type: \"candidate\",\n    };\n\n    this.records.set(candidate.name, candidate);\n\n    return { ...candidate };\n  }\n\n  /**\n   * Promote the stored candidate for `name` to a new monotonic version\n   * (`type: \"promoted\"`, `version + 1`). Throws when there is no candidate\n   * to promote — promotion of a non-existent skill is a programming error.\n   */\n  public async promote(name: string): Promise<SkillRecord> {\n    const existing = this.records.get(name);\n\n    if (!existing) {\n      throw new Error(`MockSkillsStore.promote: no skill named \"${name}\" to promote`);\n    }\n\n    const promoted: SkillRecord = {\n      ...existing,\n      version: existing.version + 1,\n      type: \"promoted\",\n    };\n\n    this.records.set(name, promoted);\n\n    return { ...promoted };\n  }\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/**\n * True when no filter tags are requested, or when the record carries at\n * least one of the requested tags. A tagless record matches only the\n * unfiltered case.\n */\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":";;;;;;;;;;;;;;;;;;;;AAyBA,IAAa,kBAAb,MAA4D;CAI1D,AAAO,YAAY,OAAsB,CAAC,GAAG;iCAFlB,IAAI,IAAyB;EAGtD,KAAK,MAAM,UAAU,MACnB,KAAK,QAAQ,IAAI,OAAO,MAAM,EAAE,GAAG,OAAO,CAAC;CAE/C;;;;;;CAOA,MAAa,KAAK,OAA2D;EAC3E,MAAM,SAAS,OAAO;EAEtB,OAAO,CAAC,GAAG,KAAK,QAAQ,OAAO,CAAC,CAAC,CAC9B,QAAQ,WAAW,OAAO,SAAS,WAAW,CAAC,CAC/C,QAAQ,WAAW,WAAW,OAAO,MAAM,MAAM,CAAC,CAAC,CACnD,IAAI,cAAc;CACvB;;;;;;CAOA,MAAa,KAAK,MAAc,SAAoD;EAClF,MAAM,SAAS,KAAK,QAAQ,IAAI,IAAI;EAEpC,IAAI,CAAC,UAAU,OAAO,SAAS,aAC7B;EAGF,IAAI,YAAY,UAAa,OAAO,YAAY,SAC9C;EAGF,OAAO,EAAE,GAAG,OAAO;CACrB;;;;;;CAOA,MAAa,cACX,QACsB;EACtB,MAAM,YAAyB;GAC7B,GAAG;GACH,SAAS;GACT,MAAM;EACR;EAEA,KAAK,QAAQ,IAAI,UAAU,MAAM,SAAS;EAE1C,OAAO,EAAE,GAAG,UAAU;CACxB;;;;;;CAOA,MAAa,QAAQ,MAAoC;EACvD,MAAM,WAAW,KAAK,QAAQ,IAAI,IAAI;EAEtC,IAAI,CAAC,UACH,MAAM,IAAI,MAAM,4CAA4C,KAAK,aAAa;EAGhF,MAAM,WAAwB;GAC5B,GAAG;GACH,SAAS,SAAS,UAAU;GAC5B,MAAM;EACR;EAEA,KAAK,QAAQ,IAAI,MAAM,QAAQ;EAE/B,OAAO,EAAE,GAAG,SAAS;CACvB;AACF;;AAGA,SAAS,eAAe,QAAwC;CAC9D,OAAO;EACL,MAAM,OAAO;EACb,aAAa,OAAO;EACpB,SAAS,OAAO;EAChB,MAAM,OAAO;EACb,MAAM,OAAO;CACf;AACF;;;;;;AAOA,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/skills/store/procedural-skill-store.d.mts

@@ -1,7 +1,7 @@
 import { ProceduralMemoryConfig } from "../../contracts/memory/memory-config.type.mjs";
 import { SkillsStoreContract } from "../contracts/skills-store.contract.mjs";
 
-//#region ../@warlock.js/ai/src/skills/store/procedural-skill-store.d.ts
+//#region ../ai/src/skills/store/procedural-skill-store.d.ts
 /**
  * {@link SkillsStoreContract} backed by the procedural memory tier
  * (`ai.memory({ procedural })`). **The unification** the design calls for:

package/esm/skills/store/procedural-skill-store.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"procedural-skill-store.d.mts","names":[],"sources":["../../../../../../../../@warlock.js/ai/src/skills/store/procedural-skill-store.ts"],"mappings":";;;;;;AAsDA;;;;;;;;;;AAEsB;;;;;;;iBAFN,oBAAA,CACd,MAAA,EAAQ,sBAAA;EAA2B,IAAA;EAAe,WAAA;AAAA,IACjD,mBAAmB"}
+{"version":3,"file":"procedural-skill-store.d.mts","names":[],"sources":["../../../../../../../../ai/src/skills/store/procedural-skill-store.ts"],"mappings":";;;;;;AAsDA;;;;;;;;;;AAEsB;;;;;;;iBAFN,oBAAA,CACd,MAAA,EAAQ,sBAAA;EAA2B,IAAA;EAAe,WAAA;AAAA,IACjD,mBAAmB"}

package/esm/skills/store/procedural-skill-store.mjs

@@ -1,7 +1,7 @@
 import { memory } from "../../memory/memory.mjs";
 import "../../memory/index.mjs";
 
-//#region ../@warlock.js/ai/src/skills/store/procedural-skill-store.ts
+//#region ../ai/src/skills/store/procedural-skill-store.ts
 const RECALL_K = 1e3;
 /**
 * {@link SkillsStoreContract} backed by the procedural memory tier

package/esm/skills/store/procedural-skill-store.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"procedural-skill-store.mjs","names":[],"sources":["../../../../../../../../@warlock.js/ai/src/skills/store/procedural-skill-store.ts"],"sourcesContent":["import type { MemoryContract } from \"../../contracts/memory/memory.contract\";\nimport type { ProceduralMemoryConfig } from \"../../contracts/memory/memory-config.type\";\nimport { memory } from \"../../memory\";\nimport type {\n  SkillCatalogEntry,\n  SkillRecord,\n} from \"../contracts/skill-record.type\";\nimport type { SkillsStoreContract } from \"../contracts/skills-store.contract\";\n\n/**\n * Metadata a procedural memory carries to round-trip a skill. `recall()`\n * surfaces `metadata` verbatim, so the skill's identity (name, version,\n * provenance, description, tags) rides here while the procedure body lives\n * in the memory's `text`.\n */\ntype ProceduralSkillMeta = {\n  /** Marks the record as a skill (vs. a plain procedure) so `list` can scope. */\n  skill: true;\n  /** Skill name — the catalog key (also the memory `id`). */\n  name: string;\n  /** Provenance flag round-tripped onto the SkillRecord. */\n  type: \"candidate\" | \"promoted\";\n  /** Catalog line. */\n  description: string;\n  /** Monotonic version — bumped on promote. */\n  version: number;\n  /** Optional scope tags. */\n  tags?: string[];\n};\n\n/** A recalled skill entry — the procedure body plus its skill metadata. */\ntype ProceduralSkillEntry = { body: string; meta: ProceduralSkillMeta };\n\nconst RECALL_K = 1000;\n\n/**\n * {@link SkillsStoreContract} backed by the procedural memory tier\n * (`ai.memory({ procedural })`). **The unification** the design calls for:\n * \"promote a proven procedural memory to a named skill\" and \"save a\n * self-authored skill\" are the SAME machinery — one store, two entry\n * points. No fifth `MemoryTier` is added; the existing `\"procedural\"` tier\n * is reused verbatim.\n *\n * - `saveCandidate` ⇒ `memory.remember({ tier: \"procedural\", metadata: { type: \"candidate\" } })`.\n * - `promote` ⇒ re-remembers the same id with `type: \"promoted\"` and\n *   `version + 1`, which the procedural tier reinforces (increments `uses`).\n * - `list` / `load` map `memory.recall(..., { tier: \"procedural\" })` ⇒\n *   `RecalledMemory[]` ⇒ `SkillCatalogEntry[]` / `SkillRecord`, filtering\n *   out inert candidates so they can never be catalogued or injected.\n *\n * @example\n * const store = proceduralSkillStore({ embedder, store: cacheDriver });\n * const lib = skills({ name: \"learned\", sources: [{ type: \"store\", store }], review: gate });\n */\nexport function proceduralSkillStore(\n  config: ProceduralMemoryConfig & { name?: string; recallQuery?: string },\n): SkillsStoreContract {\n  const store: MemoryContract = memory({\n    name: config.name ?? \"skills.procedural\",\n    working: false,\n    defaultTier: \"procedural\",\n    procedural: {\n      embedder: config.embedder,\n      store: config.store,\n      namespace: config.namespace,\n      reinforcementWeight: config.reinforcementWeight,\n    },\n  });\n\n  // The procedural tier recalls by similarity to a query; for a full\n  // catalog listing we recall against a broad seed with a large `k` and a\n  // zero floor so every stored skill comes back.\n  const recallQuery = config.recallQuery ?? \"skill procedure how-to\";\n\n  const recallAll = async (): Promise<ProceduralSkillEntry[]> => {\n    const hits = await store.recall(recallQuery, {\n      tier: \"procedural\",\n      k: RECALL_K,\n      threshold: 0,\n    });\n\n    return hits\n      .map((hit) => ({ body: hit.text, meta: hit.metadata as ProceduralSkillMeta | undefined }))\n      .filter((entry): entry is ProceduralSkillEntry => Boolean(entry.meta?.skill));\n  };\n\n  return {\n    async list(scope?: { tags?: string[] }): Promise<SkillCatalogEntry[]> {\n      const all = await recallAll();\n      const wanted = scope?.tags;\n\n      return all\n        .filter((entry) => entry.meta.type !== \"candidate\")\n        .filter((entry) => intersects(entry.meta.tags, wanted))\n        .map((entry) => toCatalogEntry(entry.meta));\n    },\n    async load(name: string, version?: number): Promise<SkillRecord | undefined> {\n      const all = await recallAll();\n      const match = all.find((entry) => entry.meta.name === name);\n\n      if (!match || match.meta.type === \"candidate\") {\n        return undefined;\n      }\n\n      if (version !== undefined && match.meta.version !== version) {\n        return undefined;\n      }\n\n      return toRecord(match.body, match.meta);\n    },\n    async saveCandidate(record: Omit<SkillRecord, \"version\" | \"type\">): Promise<SkillRecord> {\n      const meta: ProceduralSkillMeta = {\n        skill: true,\n        name: record.name,\n        type: \"candidate\",\n        description: record.description,\n        version: 0,\n        tags: record.tags,\n      };\n\n      await store.remember({\n        id: record.name,\n        text: record.body,\n        tier: \"procedural\",\n        metadata: meta,\n      });\n\n      return { ...record, version: 0, type: \"candidate\" };\n    },\n    async promote(name: string): Promise<SkillRecord> {\n      const all = await recallAll();\n      const match = all.find((entry) => entry.meta.name === name);\n\n      if (!match) {\n        throw new Error(`proceduralSkillStore.promote: no skill named \"${name}\" to promote`);\n      }\n\n      const meta: ProceduralSkillMeta = {\n        ...match.meta,\n        type: \"promoted\",\n        version: match.meta.version + 1,\n      };\n\n      // Re-remembering the same id reinforces (uses++) AND flips the\n      // metadata — the procedural tier's reinforcement IS the promotion.\n      await store.remember({\n        id: name,\n        text: match.body,\n        tier: \"procedural\",\n        metadata: meta,\n      });\n\n      return toRecord(match.body, meta);\n    },\n  };\n}\n\nfunction toCatalogEntry(meta: ProceduralSkillMeta): SkillCatalogEntry {\n  return {\n    name: meta.name,\n    description: meta.description,\n    version: meta.version,\n    tags: meta.tags,\n    type: meta.type,\n  };\n}\n\nfunction toRecord(body: string, meta: ProceduralSkillMeta): SkillRecord {\n  return {\n    name: meta.name,\n    description: meta.description,\n    version: meta.version,\n    body,\n    tags: meta.tags,\n    type: meta.type,\n  };\n}\n\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":";;;;AAiCA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;AAqBjB,SAAgB,qBACd,QACqB;CACrB,MAAM,QAAwB,OAAO;EACnC,MAAM,OAAO,QAAQ;EACrB,SAAS;EACT,aAAa;EACb,YAAY;GACV,UAAU,OAAO;GACjB,OAAO,OAAO;GACd,WAAW,OAAO;GAClB,qBAAqB,OAAO;EAC9B;CACF,CAAC;CAKD,MAAM,cAAc,OAAO,eAAe;CAE1C,MAAM,YAAY,YAA6C;EAO7D,QAAO,MANY,MAAM,OAAO,aAAa;GAC3C,MAAM;GACN,GAAG;GACH,WAAW;EACb,CAAC,EAEU,CACR,KAAK,SAAS;GAAE,MAAM,IAAI;GAAM,MAAM,IAAI;EAA4C,EAAE,CAAC,CACzF,QAAQ,UAAyC,QAAQ,MAAM,MAAM,KAAK,CAAC;CAChF;CAEA,OAAO;EACL,MAAM,KAAK,OAA2D;GACpE,MAAM,MAAM,MAAM,UAAU;GAC5B,MAAM,SAAS,OAAO;GAEtB,OAAO,IACJ,QAAQ,UAAU,MAAM,KAAK,SAAS,WAAW,CAAC,CAClD,QAAQ,UAAU,WAAW,MAAM,KAAK,MAAM,MAAM,CAAC,CAAC,CACtD,KAAK,UAAU,eAAe,MAAM,IAAI,CAAC;EAC9C;EACA,MAAM,KAAK,MAAc,SAAoD;GAE3E,MAAM,SAAQ,MADI,UAAU,EACX,CAAC,MAAM,UAAU,MAAM,KAAK,SAAS,IAAI;GAE1D,IAAI,CAAC,SAAS,MAAM,KAAK,SAAS,aAChC;GAGF,IAAI,YAAY,UAAa,MAAM,KAAK,YAAY,SAClD;GAGF,OAAO,SAAS,MAAM,MAAM,MAAM,IAAI;EACxC;EACA,MAAM,cAAc,QAAqE;GACvF,MAAM,OAA4B;IAChC,OAAO;IACP,MAAM,OAAO;IACb,MAAM;IACN,aAAa,OAAO;IACpB,SAAS;IACT,MAAM,OAAO;GACf;GAEA,MAAM,MAAM,SAAS;IACnB,IAAI,OAAO;IACX,MAAM,OAAO;IACb,MAAM;IACN,UAAU;GACZ,CAAC;GAED,OAAO;IAAE,GAAG;IAAQ,SAAS;IAAG,MAAM;GAAY;EACpD;EACA,MAAM,QAAQ,MAAoC;GAEhD,MAAM,SAAQ,MADI,UAAU,EACX,CAAC,MAAM,UAAU,MAAM,KAAK,SAAS,IAAI;GAE1D,IAAI,CAAC,OACH,MAAM,IAAI,MAAM,iDAAiD,KAAK,aAAa;GAGrF,MAAM,OAA4B;IAChC,GAAG,MAAM;IACT,MAAM;IACN,SAAS,MAAM,KAAK,UAAU;GAChC;GAIA,MAAM,MAAM,SAAS;IACnB,IAAI;IACJ,MAAM,MAAM;IACZ,MAAM;IACN,UAAU;GACZ,CAAC;GAED,OAAO,SAAS,MAAM,MAAM,IAAI;EAClC;CACF;AACF;AAEA,SAAS,eAAe,MAA8C;CACpE,OAAO;EACL,MAAM,KAAK;EACX,aAAa,KAAK;EAClB,SAAS,KAAK;EACd,MAAM,KAAK;EACX,MAAM,KAAK;CACb;AACF;AAEA,SAAS,SAAS,MAAc,MAAwC;CACtE,OAAO;EACL,MAAM,KAAK;EACX,aAAa,KAAK;EAClB,SAAS,KAAK;EACd;EACA,MAAM,KAAK;EACX,MAAM,KAAK;CACb;AACF;AAEA,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"}
+{"version":3,"file":"procedural-skill-store.mjs","names":[],"sources":["../../../../../../../../ai/src/skills/store/procedural-skill-store.ts"],"sourcesContent":["import type { MemoryContract } from \"../../contracts/memory/memory.contract\";\nimport type { ProceduralMemoryConfig } from \"../../contracts/memory/memory-config.type\";\nimport { memory } from \"../../memory\";\nimport type {\n  SkillCatalogEntry,\n  SkillRecord,\n} from \"../contracts/skill-record.type\";\nimport type { SkillsStoreContract } from \"../contracts/skills-store.contract\";\n\n/**\n * Metadata a procedural memory carries to round-trip a skill. `recall()`\n * surfaces `metadata` verbatim, so the skill's identity (name, version,\n * provenance, description, tags) rides here while the procedure body lives\n * in the memory's `text`.\n */\ntype ProceduralSkillMeta = {\n  /** Marks the record as a skill (vs. a plain procedure) so `list` can scope. */\n  skill: true;\n  /** Skill name — the catalog key (also the memory `id`). */\n  name: string;\n  /** Provenance flag round-tripped onto the SkillRecord. */\n  type: \"candidate\" | \"promoted\";\n  /** Catalog line. */\n  description: string;\n  /** Monotonic version — bumped on promote. */\n  version: number;\n  /** Optional scope tags. */\n  tags?: string[];\n};\n\n/** A recalled skill entry — the procedure body plus its skill metadata. */\ntype ProceduralSkillEntry = { body: string; meta: ProceduralSkillMeta };\n\nconst RECALL_K = 1000;\n\n/**\n * {@link SkillsStoreContract} backed by the procedural memory tier\n * (`ai.memory({ procedural })`). **The unification** the design calls for:\n * \"promote a proven procedural memory to a named skill\" and \"save a\n * self-authored skill\" are the SAME machinery — one store, two entry\n * points. No fifth `MemoryTier` is added; the existing `\"procedural\"` tier\n * is reused verbatim.\n *\n * - `saveCandidate` ⇒ `memory.remember({ tier: \"procedural\", metadata: { type: \"candidate\" } })`.\n * - `promote` ⇒ re-remembers the same id with `type: \"promoted\"` and\n *   `version + 1`, which the procedural tier reinforces (increments `uses`).\n * - `list` / `load` map `memory.recall(..., { tier: \"procedural\" })` ⇒\n *   `RecalledMemory[]` ⇒ `SkillCatalogEntry[]` / `SkillRecord`, filtering\n *   out inert candidates so they can never be catalogued or injected.\n *\n * @example\n * const store = proceduralSkillStore({ embedder, store: cacheDriver });\n * const lib = skills({ name: \"learned\", sources: [{ type: \"store\", store }], review: gate });\n */\nexport function proceduralSkillStore(\n  config: ProceduralMemoryConfig & { name?: string; recallQuery?: string },\n): SkillsStoreContract {\n  const store: MemoryContract = memory({\n    name: config.name ?? \"skills.procedural\",\n    working: false,\n    defaultTier: \"procedural\",\n    procedural: {\n      embedder: config.embedder,\n      store: config.store,\n      namespace: config.namespace,\n      reinforcementWeight: config.reinforcementWeight,\n    },\n  });\n\n  // The procedural tier recalls by similarity to a query; for a full\n  // catalog listing we recall against a broad seed with a large `k` and a\n  // zero floor so every stored skill comes back.\n  const recallQuery = config.recallQuery ?? \"skill procedure how-to\";\n\n  const recallAll = async (): Promise<ProceduralSkillEntry[]> => {\n    const hits = await store.recall(recallQuery, {\n      tier: \"procedural\",\n      k: RECALL_K,\n      threshold: 0,\n    });\n\n    return hits\n      .map((hit) => ({ body: hit.text, meta: hit.metadata as ProceduralSkillMeta | undefined }))\n      .filter((entry): entry is ProceduralSkillEntry => Boolean(entry.meta?.skill));\n  };\n\n  return {\n    async list(scope?: { tags?: string[] }): Promise<SkillCatalogEntry[]> {\n      const all = await recallAll();\n      const wanted = scope?.tags;\n\n      return all\n        .filter((entry) => entry.meta.type !== \"candidate\")\n        .filter((entry) => intersects(entry.meta.tags, wanted))\n        .map((entry) => toCatalogEntry(entry.meta));\n    },\n    async load(name: string, version?: number): Promise<SkillRecord | undefined> {\n      const all = await recallAll();\n      const match = all.find((entry) => entry.meta.name === name);\n\n      if (!match || match.meta.type === \"candidate\") {\n        return undefined;\n      }\n\n      if (version !== undefined && match.meta.version !== version) {\n        return undefined;\n      }\n\n      return toRecord(match.body, match.meta);\n    },\n    async saveCandidate(record: Omit<SkillRecord, \"version\" | \"type\">): Promise<SkillRecord> {\n      const meta: ProceduralSkillMeta = {\n        skill: true,\n        name: record.name,\n        type: \"candidate\",\n        description: record.description,\n        version: 0,\n        tags: record.tags,\n      };\n\n      await store.remember({\n        id: record.name,\n        text: record.body,\n        tier: \"procedural\",\n        metadata: meta,\n      });\n\n      return { ...record, version: 0, type: \"candidate\" };\n    },\n    async promote(name: string): Promise<SkillRecord> {\n      const all = await recallAll();\n      const match = all.find((entry) => entry.meta.name === name);\n\n      if (!match) {\n        throw new Error(`proceduralSkillStore.promote: no skill named \"${name}\" to promote`);\n      }\n\n      const meta: ProceduralSkillMeta = {\n        ...match.meta,\n        type: \"promoted\",\n        version: match.meta.version + 1,\n      };\n\n      // Re-remembering the same id reinforces (uses++) AND flips the\n      // metadata — the procedural tier's reinforcement IS the promotion.\n      await store.remember({\n        id: name,\n        text: match.body,\n        tier: \"procedural\",\n        metadata: meta,\n      });\n\n      return toRecord(match.body, meta);\n    },\n  };\n}\n\nfunction toCatalogEntry(meta: ProceduralSkillMeta): SkillCatalogEntry {\n  return {\n    name: meta.name,\n    description: meta.description,\n    version: meta.version,\n    tags: meta.tags,\n    type: meta.type,\n  };\n}\n\nfunction toRecord(body: string, meta: ProceduralSkillMeta): SkillRecord {\n  return {\n    name: meta.name,\n    description: meta.description,\n    version: meta.version,\n    body,\n    tags: meta.tags,\n    type: meta.type,\n  };\n}\n\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":";;;;AAiCA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;AAqBjB,SAAgB,qBACd,QACqB;CACrB,MAAM,QAAwB,OAAO;EACnC,MAAM,OAAO,QAAQ;EACrB,SAAS;EACT,aAAa;EACb,YAAY;GACV,UAAU,OAAO;GACjB,OAAO,OAAO;GACd,WAAW,OAAO;GAClB,qBAAqB,OAAO;EAC9B;CACF,CAAC;CAKD,MAAM,cAAc,OAAO,eAAe;CAE1C,MAAM,YAAY,YAA6C;EAO7D,QAAO,MANY,MAAM,OAAO,aAAa;GAC3C,MAAM;GACN,GAAG;GACH,WAAW;EACb,CAAC,EAEU,CACR,KAAK,SAAS;GAAE,MAAM,IAAI;GAAM,MAAM,IAAI;EAA4C,EAAE,CAAC,CACzF,QAAQ,UAAyC,QAAQ,MAAM,MAAM,KAAK,CAAC;CAChF;CAEA,OAAO;EACL,MAAM,KAAK,OAA2D;GACpE,MAAM,MAAM,MAAM,UAAU;GAC5B,MAAM,SAAS,OAAO;GAEtB,OAAO,IACJ,QAAQ,UAAU,MAAM,KAAK,SAAS,WAAW,CAAC,CAClD,QAAQ,UAAU,WAAW,MAAM,KAAK,MAAM,MAAM,CAAC,CAAC,CACtD,KAAK,UAAU,eAAe,MAAM,IAAI,CAAC;EAC9C;EACA,MAAM,KAAK,MAAc,SAAoD;GAE3E,MAAM,SAAQ,MADI,UAAU,EACX,CAAC,MAAM,UAAU,MAAM,KAAK,SAAS,IAAI;GAE1D,IAAI,CAAC,SAAS,MAAM,KAAK,SAAS,aAChC;GAGF,IAAI,YAAY,UAAa,MAAM,KAAK,YAAY,SAClD;GAGF,OAAO,SAAS,MAAM,MAAM,MAAM,IAAI;EACxC;EACA,MAAM,cAAc,QAAqE;GACvF,MAAM,OAA4B;IAChC,OAAO;IACP,MAAM,OAAO;IACb,MAAM;IACN,aAAa,OAAO;IACpB,SAAS;IACT,MAAM,OAAO;GACf;GAEA,MAAM,MAAM,SAAS;IACnB,IAAI,OAAO;IACX,MAAM,OAAO;IACb,MAAM;IACN,UAAU;GACZ,CAAC;GAED,OAAO;IAAE,GAAG;IAAQ,SAAS;IAAG,MAAM;GAAY;EACpD;EACA,MAAM,QAAQ,MAAoC;GAEhD,MAAM,SAAQ,MADI,UAAU,EACX,CAAC,MAAM,UAAU,MAAM,KAAK,SAAS,IAAI;GAE1D,IAAI,CAAC,OACH,MAAM,IAAI,MAAM,iDAAiD,KAAK,aAAa;GAGrF,MAAM,OAA4B;IAChC,GAAG,MAAM;IACT,MAAM;IACN,SAAS,MAAM,KAAK,UAAU;GAChC;GAIA,MAAM,MAAM,SAAS;IACnB,IAAI;IACJ,MAAM,MAAM;IACZ,MAAM;IACN,UAAU;GACZ,CAAC;GAED,OAAO,SAAS,MAAM,MAAM,IAAI;EAClC;CACF;AACF;AAEA,SAAS,eAAe,MAA8C;CACpE,OAAO;EACL,MAAM,KAAK;EACX,aAAa,KAAK;EAClB,SAAS,KAAK;EACd,MAAM,KAAK;EACX,MAAM,KAAK;CACb;AACF;AAEA,SAAS,SAAS,MAAc,MAAwC;CACtE,OAAO;EACL,MAAM,KAAK;EACX,aAAa,KAAK;EAClB,SAAS,KAAK;EACd;EACA,MAAM,KAAK;EACX,MAAM,KAAK;CACb;AACF;AAEA,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/snapshot/memory.d.mts

@@ -1,7 +1,7 @@
 import { SupervisorSnapshot } from "../contracts/supervisor/supervisor-snapshot.type.mjs";
 import { SnapshotStore } from "../contracts/orchestrator/snapshot-store.contract.mjs";
 
-//#region ../@warlock.js/ai/src/snapshot/memory.d.ts
+//#region ../ai/src/snapshot/memory.d.ts
 /**
  * Create an in-memory {@link SnapshotStore}. Zero-config — no client,
  * no connection. Suitable for dev, tests, and single-process apps that

package/esm/snapshot/memory.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"memory.d.mts","names":[],"sources":["../../../../../../../@warlock.js/ai/src/snapshot/memory.ts"],"mappings":";;;;;;AAwFA;;;;;;;;;;;;;;iBAAgB,MAAA;EACM,KAAA;AAAA,IAAkB,kBAAA,KACnC,aAAA,CAAc,SAAA"}
+{"version":3,"file":"memory.d.mts","names":[],"sources":["../../../../../../../ai/src/snapshot/memory.ts"],"mappings":";;;;;;AAwFA;;;;;;;;;;;;;;iBAAgB,MAAA;EACM,KAAA;AAAA,IAAkB,kBAAA,KACnC,aAAA,CAAc,SAAA"}

package/esm/snapshot/memory.mjs

@@ -1,4 +1,4 @@
-//#region ../@warlock.js/ai/src/snapshot/memory.ts
+//#region ../ai/src/snapshot/memory.ts
 /**
 * In-memory {@link SnapshotStore} — supervisor run snapshots held in a
 * process-local `Map`, keyed by `runId`, never persisted to disk.

package/esm/snapshot/memory.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"memory.mjs","names":[],"sources":["../../../../../../../@warlock.js/ai/src/snapshot/memory.ts"],"sourcesContent":["import type { SnapshotStore } from \"../contracts/orchestrator/snapshot-store.contract\";\nimport type { SupervisorSnapshot } from \"../contracts/supervisor/supervisor-snapshot.type\";\n\n/**\n * In-memory {@link SnapshotStore} — supervisor run snapshots held in a\n * process-local `Map`, keyed by `runId`, never persisted to disk.\n *\n * Owns: the `runId` → {@link SupervisorSnapshot} mapping for\n * `iterate: true` mid-turn resume. Does NOT own: durability,\n * cross-process sharing, or TTL eviction — it is the zero-config\n * default for dev, tests, and single-process apps. Reach for\n * `ai.snapshot.pg()` / `ai.snapshot.redis()` (Phase 2) when a crashed\n * process must resume an in-flight turn.\n *\n * Front it with the {@link memory} factory — callers never `new` it.\n */\nclass MemorySnapshotStore<TSnapshot extends { runId: string }>\n  implements SnapshotStore<TSnapshot>\n{\n  /** Snapshots keyed by `runId`. */\n  private readonly snapshots = new Map<string, TSnapshot>();\n\n  /**\n   * Return the snapshot for a `runId`, or `undefined` when no in-flight\n   * run is recorded.\n   */\n  public async load(runId: string): Promise<TSnapshot | undefined> {\n    return this.snapshots.get(runId);\n  }\n\n  /**\n   * Persist a snapshot, keyed by its own `runId`. Overwrites any prior\n   * snapshot for the same run — a run has exactly one live snapshot.\n   */\n  public async save(snapshot: TSnapshot): Promise<void> {\n    this.snapshots.set(snapshot.runId, snapshot);\n  }\n\n  /**\n   * Drop the snapshot for a `runId`.\n   */\n  public async delete(runId: string): Promise<void> {\n    this.snapshots.delete(runId);\n  }\n\n  /**\n   * List the known run ids, optionally filtered by a prefix.\n   */\n  public async list(prefix?: string): Promise<string[]> {\n    const runIds: string[] = [];\n\n    for (const runId of this.snapshots.keys()) {\n      if (prefix !== undefined && !runId.startsWith(prefix)) {\n        continue;\n      }\n\n      runIds.push(runId);\n    }\n\n    return runIds;\n  }\n\n  /**\n   * The memory store has no backing table — there is nothing to\n   * migrate. Returns an empty string so callers can treat `schema()`\n   * uniformly across drivers.\n   */\n  public schema(): string {\n    return \"\";\n  }\n}\n\n/**\n * Create an in-memory {@link SnapshotStore}. Zero-config — no client,\n * no connection. Suitable for dev, tests, and single-process apps that\n * don't need to resume an interrupted `iterate: true` turn across\n * restarts.\n *\n * @example\n * import { ai } from \"@warlock.js/ai\";\n *\n * const orchestrator = ai.orchestrator({\n *   name: \"support\",\n *   intents: { ... },\n *   iterate: true,\n *   snapshotStore: ai.snapshot.memory(),\n * });\n */\nexport function memory<\n  TSnapshot extends { runId: string } = SupervisorSnapshot,\n>(): SnapshotStore<TSnapshot> {\n  return new MemorySnapshotStore<TSnapshot>();\n}\n"],"mappings":";;;;;;;;;;;;;;AAgBA,IAAM,sBAAN,MAEA;;mCAE+B,IAAI,IAAuB;;;;;;CAMxD,MAAa,KAAK,OAA+C;EAC/D,OAAO,KAAK,UAAU,IAAI,KAAK;CACjC;;;;;CAMA,MAAa,KAAK,UAAoC;EACpD,KAAK,UAAU,IAAI,SAAS,OAAO,QAAQ;CAC7C;;;;CAKA,MAAa,OAAO,OAA8B;EAChD,KAAK,UAAU,OAAO,KAAK;CAC7B;;;;CAKA,MAAa,KAAK,QAAoC;EACpD,MAAM,SAAmB,CAAC;EAE1B,KAAK,MAAM,SAAS,KAAK,UAAU,KAAK,GAAG;GACzC,IAAI,WAAW,UAAa,CAAC,MAAM,WAAW,MAAM,GAClD;GAGF,OAAO,KAAK,KAAK;EACnB;EAEA,OAAO;CACT;;;;;;CAOA,AAAO,SAAiB;EACtB,OAAO;CACT;AACF;;;;;;;;;;;;;;;;;AAkBA,SAAgB,SAEc;CAC5B,OAAO,IAAI,oBAA+B;AAC5C"}
+{"version":3,"file":"memory.mjs","names":[],"sources":["../../../../../../../ai/src/snapshot/memory.ts"],"sourcesContent":["import type { SnapshotStore } from \"../contracts/orchestrator/snapshot-store.contract\";\nimport type { SupervisorSnapshot } from \"../contracts/supervisor/supervisor-snapshot.type\";\n\n/**\n * In-memory {@link SnapshotStore} — supervisor run snapshots held in a\n * process-local `Map`, keyed by `runId`, never persisted to disk.\n *\n * Owns: the `runId` → {@link SupervisorSnapshot} mapping for\n * `iterate: true` mid-turn resume. Does NOT own: durability,\n * cross-process sharing, or TTL eviction — it is the zero-config\n * default for dev, tests, and single-process apps. Reach for\n * `ai.snapshot.pg()` / `ai.snapshot.redis()` (Phase 2) when a crashed\n * process must resume an in-flight turn.\n *\n * Front it with the {@link memory} factory — callers never `new` it.\n */\nclass MemorySnapshotStore<TSnapshot extends { runId: string }>\n  implements SnapshotStore<TSnapshot>\n{\n  /** Snapshots keyed by `runId`. */\n  private readonly snapshots = new Map<string, TSnapshot>();\n\n  /**\n   * Return the snapshot for a `runId`, or `undefined` when no in-flight\n   * run is recorded.\n   */\n  public async load(runId: string): Promise<TSnapshot | undefined> {\n    return this.snapshots.get(runId);\n  }\n\n  /**\n   * Persist a snapshot, keyed by its own `runId`. Overwrites any prior\n   * snapshot for the same run — a run has exactly one live snapshot.\n   */\n  public async save(snapshot: TSnapshot): Promise<void> {\n    this.snapshots.set(snapshot.runId, snapshot);\n  }\n\n  /**\n   * Drop the snapshot for a `runId`.\n   */\n  public async delete(runId: string): Promise<void> {\n    this.snapshots.delete(runId);\n  }\n\n  /**\n   * List the known run ids, optionally filtered by a prefix.\n   */\n  public async list(prefix?: string): Promise<string[]> {\n    const runIds: string[] = [];\n\n    for (const runId of this.snapshots.keys()) {\n      if (prefix !== undefined && !runId.startsWith(prefix)) {\n        continue;\n      }\n\n      runIds.push(runId);\n    }\n\n    return runIds;\n  }\n\n  /**\n   * The memory store has no backing table — there is nothing to\n   * migrate. Returns an empty string so callers can treat `schema()`\n   * uniformly across drivers.\n   */\n  public schema(): string {\n    return \"\";\n  }\n}\n\n/**\n * Create an in-memory {@link SnapshotStore}. Zero-config — no client,\n * no connection. Suitable for dev, tests, and single-process apps that\n * don't need to resume an interrupted `iterate: true` turn across\n * restarts.\n *\n * @example\n * import { ai } from \"@warlock.js/ai\";\n *\n * const orchestrator = ai.orchestrator({\n *   name: \"support\",\n *   intents: { ... },\n *   iterate: true,\n *   snapshotStore: ai.snapshot.memory(),\n * });\n */\nexport function memory<\n  TSnapshot extends { runId: string } = SupervisorSnapshot,\n>(): SnapshotStore<TSnapshot> {\n  return new MemorySnapshotStore<TSnapshot>();\n}\n"],"mappings":";;;;;;;;;;;;;;AAgBA,IAAM,sBAAN,MAEA;;mCAE+B,IAAI,IAAuB;;;;;;CAMxD,MAAa,KAAK,OAA+C;EAC/D,OAAO,KAAK,UAAU,IAAI,KAAK;CACjC;;;;;CAMA,MAAa,KAAK,UAAoC;EACpD,KAAK,UAAU,IAAI,SAAS,OAAO,QAAQ;CAC7C;;;;CAKA,MAAa,OAAO,OAA8B;EAChD,KAAK,UAAU,OAAO,KAAK;CAC7B;;;;CAKA,MAAa,KAAK,QAAoC;EACpD,MAAM,SAAmB,CAAC;EAE1B,KAAK,MAAM,SAAS,KAAK,UAAU,KAAK,GAAG;GACzC,IAAI,WAAW,UAAa,CAAC,MAAM,WAAW,MAAM,GAClD;GAGF,OAAO,KAAK,KAAK;EACnB;EAEA,OAAO;CACT;;;;;;CAOA,AAAO,SAAiB;EACtB,OAAO;CACT;AACF;;;;;;;;;;;;;;;;;AAkBA,SAAgB,SAEc;CAC5B,OAAO,IAAI,oBAA+B;AAC5C"}

package/esm/snapshot/pg.d.mts

@@ -1,6 +1,6 @@
 import { PgClientLike, SnapshotStore } from "../contracts/orchestrator/snapshot-store.contract.mjs";
 
-//#region ../@warlock.js/ai/src/snapshot/pg.d.ts
+//#region ../ai/src/snapshot/pg.d.ts
 /**
  * Options for {@link pg}. The `client` is an already-built `pg.Pool` /
  * `pg.Client` (anything satisfying {@link PgClientLike}); the store never

package/esm/snapshot/pg.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"pg.d.mts","names":[],"sources":["../../../../../../../@warlock.js/ai/src/snapshot/pg.ts"],"mappings":";;;;;AA2BA;;;KAAY,sBAAA;EAEV,8DAAA,MAAA,EAAQ,YAAY,EAEpB;EAAA,KAAA;AAAA;AAmLF;;;;;;;;AAAkE;;;;;;;;;;;;;;;;;AAAlE,iBAAgB,EAAA,CAAG,OAAA,EAAS,sBAAA,GAAyB,aAAa"}
+{"version":3,"file":"pg.d.mts","names":[],"sources":["../../../../../../../ai/src/snapshot/pg.ts"],"mappings":";;;;;AA2BA;;;KAAY,sBAAA;EAEV,8DAAA,MAAA,EAAQ,YAAY,EAEpB;EAAA,KAAA;AAAA;AAmLF;;;;;;;;AAAkE;;;;;;;;;;;;;;;;;AAAlE,iBAAgB,EAAA,CAAG,OAAA,EAAS,sBAAA,GAAyB,aAAa"}

package/esm/snapshot/pg.mjs

@@ -1,4 +1,4 @@
-//#region ../@warlock.js/ai/src/snapshot/pg.ts
+//#region ../ai/src/snapshot/pg.ts
 /**
 * Default backing table for the pg snapshot store. Matches the name used
 * in the orchestrator.md §8 reference wiring

package/esm/snapshot/pg.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"pg.mjs","names":[],"sources":["../../../../../../../@warlock.js/ai/src/snapshot/pg.ts"],"sourcesContent":["import type {\n  PgClientLike,\n  SnapshotStore,\n} from \"../contracts/orchestrator/snapshot-store.contract\";\nimport type { SupervisorSnapshot } from \"../contracts/supervisor/supervisor-snapshot.type\";\n\n/**\n * Default backing table for the pg snapshot store. Matches the name used\n * in the orchestrator.md §8 reference wiring\n * (`ai.snapshot.pg({ client, table: \"warlock_supervisor_snapshots\" })`).\n */\nconst DEFAULT_TABLE = \"warlock_supervisor_snapshots\";\n\n/**\n * Allowed characters in a Postgres identifier (table name). The\n * conservative ASCII subset; anything else is rejected because the table\n * name is interpolated directly into DDL/DML, and an arbitrary string\n * there would be a SQL-injection footgun. Mirrors `@warlock.js/cache`'s\n * `PgCacheDriver`.\n */\nconst SAFE_IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/;\n\n/**\n * Options for {@link pg}. The `client` is an already-built `pg.Pool` /\n * `pg.Client` (anything satisfying {@link PgClientLike}); the store never\n * opens or closes it — connection lifecycle stays with the caller.\n */\nexport type PgSnapshotStoreOptions = {\n  /** Pre-built pg client. The store only ever calls `query`. */\n  client: PgClientLike;\n  /** Table name. Defaults to `warlock_supervisor_snapshots`. */\n  table?: string;\n};\n\n/**\n * Validate and resolve the table name. Throws on an unsafe identifier so\n * the failure surfaces at construction time, not on the first query.\n */\nfunction resolveTable(table: string | undefined): string {\n  const resolved = table ?? DEFAULT_TABLE;\n\n  if (!SAFE_IDENTIFIER.test(resolved)) {\n    throw new Error(\n      `Pg snapshot store: invalid table name '${resolved}'. Allowed: [A-Za-z_][A-Za-z0-9_]*.`,\n    );\n  }\n\n  return resolved;\n}\n\n/**\n * Coerce a `payload` column value back into a {@link SupervisorSnapshot}.\n * node-postgres parses `JSONB` into a JS value already, but some pool\n * wrappers hand back the raw string — be defensive across both.\n */\nfunction parsePayload(payload: unknown): SupervisorSnapshot {\n  if (typeof payload === \"string\") {\n    return JSON.parse(payload) as SupervisorSnapshot;\n  }\n\n  return payload as SupervisorSnapshot;\n}\n\n/**\n * Postgres {@link SnapshotStore} — supervisor run snapshots persisted to a\n * single row per `runId` in a dev-provisioned table (orchestrator.md §8).\n *\n * Owns: durable round-tripping of the {@link SupervisorSnapshot} envelope\n * keyed by `runId`, so a crashed mid-turn `iterate: true` iteration can\n * resume after a restart. Does NOT own: the connection (the caller passes\n * a live `pg.Pool`/`pg.Client` and keeps owning its lifecycle) or schema\n * migration ({@link PgSnapshotStore.schema} returns DDL the dev runs\n * themselves — the framework never auto-migrates, §8.5).\n *\n * Unlike the append-only checkpoint store, a run has exactly one live\n * snapshot, so `save()` upserts on the `run_id` primary key.\n *\n * Front it with the {@link pg} factory — callers never `new` it.\n */\nclass PgSnapshotStore implements SnapshotStore {\n  /** The user-supplied pg client. The store only ever calls `query`. */\n  private readonly client: PgClientLike;\n\n  /** Validated, resolved table name. Safe to interpolate into SQL. */\n  private readonly table: string;\n\n  public constructor(options: PgSnapshotStoreOptions) {\n    if (!options || !options.client || typeof options.client.query !== \"function\") {\n      throw new Error(\n        \"Pg snapshot store requires a 'client' option implementing { query(text, params) } — pass a pg.Pool or pg.Client.\",\n      );\n    }\n\n    this.client = options.client;\n    this.table = resolveTable(options.table);\n  }\n\n  /**\n   * Load the snapshot for a `runId`, or `undefined` when no in-flight run\n   * is recorded.\n   */\n  public async load(runId: string): Promise<SupervisorSnapshot | undefined> {\n    const { rows } = await this.client.query(\n      `SELECT payload FROM ${this.table} WHERE run_id = $1`,\n      [runId],\n    );\n\n    if (rows.length === 0) {\n      return undefined;\n    }\n\n    return parsePayload((rows[0] as { payload: unknown }).payload);\n  }\n\n  /**\n   * Persist a snapshot, keyed by its own `runId`. Upserts — a run has\n   * exactly one live snapshot, so a second save for the same `runId`\n   * overwrites the payload rather than appending.\n   */\n  public async save(snapshot: SupervisorSnapshot): Promise<void> {\n    await this.client.query(\n      `INSERT INTO ${this.table} (run_id, payload, saved_at)\n       VALUES ($1, $2::jsonb, now())\n       ON CONFLICT (run_id) DO UPDATE\n         SET payload = EXCLUDED.payload,\n             saved_at = EXCLUDED.saved_at`,\n      [snapshot.runId, JSON.stringify(snapshot)],\n    );\n  }\n\n  /**\n   * Drop the snapshot for a `runId`.\n   */\n  public async delete(runId: string): Promise<void> {\n    await this.client.query(`DELETE FROM ${this.table} WHERE run_id = $1`, [\n      runId,\n    ]);\n  }\n\n  /**\n   * List the known run ids, optionally filtered by a prefix. The `_` and\n   * `%` LIKE wildcards in the prefix are escaped so an opaque runId that\n   * happens to contain them is matched literally.\n   */\n  public async list(prefix?: string): Promise<string[]> {\n    if (prefix === undefined) {\n      const { rows } = await this.client.query(\n        `SELECT run_id FROM ${this.table}`,\n      );\n\n      return rows.map((row) => (row as { run_id: string }).run_id);\n    }\n\n    const escaped = prefix\n      .replace(/\\\\/g, \"\\\\\\\\\")\n      .replace(/_/g, \"\\\\_\")\n      .replace(/%/g, \"\\\\%\");\n\n    const { rows } = await this.client.query(\n      `SELECT run_id FROM ${this.table} WHERE run_id LIKE $1 ESCAPE '\\\\'`,\n      [`${escaped}%`],\n    );\n\n    return rows.map((row) => (row as { run_id: string }).run_id);\n  }\n\n  /**\n   * Return the DDL for this store's backing table. Run once via the\n   * caller's migration tooling — the store never auto-migrates (§8.5).\n   *\n   * @example\n   * await pool.query(store.schema());\n   */\n  public schema(): string {\n    return [\n      `CREATE TABLE IF NOT EXISTS ${this.table} (`,\n      `  run_id    TEXT PRIMARY KEY,`,\n      `  payload   JSONB NOT NULL,`,\n      `  saved_at  TIMESTAMPTZ NOT NULL DEFAULT now()`,\n      `);`,\n      `CREATE INDEX IF NOT EXISTS idx_${this.table}_saved_at ON ${this.table} (saved_at);`,\n    ].join(\"\\n\");\n  }\n}\n\n/**\n * Create a Postgres-backed {@link SnapshotStore}. Pass a live\n * `pg.Pool`/`pg.Client` — the store never opens or closes it. Schema is\n * not auto-migrated: run {@link SnapshotStore.schema} through your own\n * migration tool first.\n *\n * @example\n * import { Pool } from \"pg\";\n * import { ai } from \"@warlock.js/ai\";\n *\n * const pool = new Pool({ connectionString: process.env.DATABASE_URL });\n *\n * const orchestrator = ai.orchestrator({\n *   name: \"support\",\n *   intents: { ... },\n *   iterate: true,\n *   snapshotStore: ai.snapshot.pg({\n *     client: pool,\n *     table: \"warlock_supervisor_snapshots\",\n *   }),\n * });\n *\n * // Run once, via your own migration tooling:\n * // await pool.query(orchestrator's store.schema());\n */\nexport function pg(options: PgSnapshotStoreOptions): SnapshotStore {\n  return new PgSnapshotStore(options);\n}\n"],"mappings":";;;;;;AAWA,MAAM,gBAAgB;;;;;;;;AAStB,MAAM,kBAAkB;;;;;AAkBxB,SAAS,aAAa,OAAmC;CACvD,MAAM,WAAW,SAAS;CAE1B,IAAI,CAAC,gBAAgB,KAAK,QAAQ,GAChC,MAAM,IAAI,MACR,0CAA0C,SAAS,oCACrD;CAGF,OAAO;AACT;;;;;;AAOA,SAAS,aAAa,SAAsC;CAC1D,IAAI,OAAO,YAAY,UACrB,OAAO,KAAK,MAAM,OAAO;CAG3B,OAAO;AACT;;;;;;;;;;;;;;;;;AAkBA,IAAM,kBAAN,MAA+C;CAO7C,AAAO,YAAY,SAAiC;EAClD,IAAI,CAAC,WAAW,CAAC,QAAQ,UAAU,OAAO,QAAQ,OAAO,UAAU,YACjE,MAAM,IAAI,MACR,kHACF;EAGF,KAAK,SAAS,QAAQ;EACtB,KAAK,QAAQ,aAAa,QAAQ,KAAK;CACzC;;;;;CAMA,MAAa,KAAK,OAAwD;EACxE,MAAM,EAAE,SAAS,MAAM,KAAK,OAAO,MACjC,uBAAuB,KAAK,MAAM,qBAClC,CAAC,KAAK,CACR;EAEA,IAAI,KAAK,WAAW,GAClB;EAGF,OAAO,aAAc,KAAK,EAAE,CAA0B,OAAO;CAC/D;;;;;;CAOA,MAAa,KAAK,UAA6C;EAC7D,MAAM,KAAK,OAAO,MAChB,eAAe,KAAK,MAAM;;;;4CAK1B,CAAC,SAAS,OAAO,KAAK,UAAU,QAAQ,CAAC,CAC3C;CACF;;;;CAKA,MAAa,OAAO,OAA8B;EAChD,MAAM,KAAK,OAAO,MAAM,eAAe,KAAK,MAAM,qBAAqB,CACrE,KACF,CAAC;CACH;;;;;;CAOA,MAAa,KAAK,QAAoC;EACpD,IAAI,WAAW,QAAW;GACxB,MAAM,EAAE,SAAS,MAAM,KAAK,OAAO,MACjC,sBAAsB,KAAK,OAC7B;GAEA,OAAO,KAAK,KAAK,QAAS,IAA2B,MAAM;EAC7D;EAEA,MAAM,UAAU,OACb,QAAQ,OAAO,MAAM,CAAC,CACtB,QAAQ,MAAM,KAAK,CAAC,CACpB,QAAQ,MAAM,KAAK;EAEtB,MAAM,EAAE,SAAS,MAAM,KAAK,OAAO,MACjC,sBAAsB,KAAK,MAAM,oCACjC,CAAC,GAAG,QAAQ,EAAE,CAChB;EAEA,OAAO,KAAK,KAAK,QAAS,IAA2B,MAAM;CAC7D;;;;;;;;CASA,AAAO,SAAiB;EACtB,OAAO;GACL,8BAA8B,KAAK,MAAM;GACzC;GACA;GACA;GACA;GACA,kCAAkC,KAAK,MAAM,eAAe,KAAK,MAAM;EACzE,CAAC,CAAC,KAAK,IAAI;CACb;AACF;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BA,SAAgB,GAAG,SAAgD;CACjE,OAAO,IAAI,gBAAgB,OAAO;AACpC"}
+{"version":3,"file":"pg.mjs","names":[],"sources":["../../../../../../../ai/src/snapshot/pg.ts"],"sourcesContent":["import type {\n  PgClientLike,\n  SnapshotStore,\n} from \"../contracts/orchestrator/snapshot-store.contract\";\nimport type { SupervisorSnapshot } from \"../contracts/supervisor/supervisor-snapshot.type\";\n\n/**\n * Default backing table for the pg snapshot store. Matches the name used\n * in the orchestrator.md §8 reference wiring\n * (`ai.snapshot.pg({ client, table: \"warlock_supervisor_snapshots\" })`).\n */\nconst DEFAULT_TABLE = \"warlock_supervisor_snapshots\";\n\n/**\n * Allowed characters in a Postgres identifier (table name). The\n * conservative ASCII subset; anything else is rejected because the table\n * name is interpolated directly into DDL/DML, and an arbitrary string\n * there would be a SQL-injection footgun. Mirrors `@warlock.js/cache`'s\n * `PgCacheDriver`.\n */\nconst SAFE_IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/;\n\n/**\n * Options for {@link pg}. The `client` is an already-built `pg.Pool` /\n * `pg.Client` (anything satisfying {@link PgClientLike}); the store never\n * opens or closes it — connection lifecycle stays with the caller.\n */\nexport type PgSnapshotStoreOptions = {\n  /** Pre-built pg client. The store only ever calls `query`. */\n  client: PgClientLike;\n  /** Table name. Defaults to `warlock_supervisor_snapshots`. */\n  table?: string;\n};\n\n/**\n * Validate and resolve the table name. Throws on an unsafe identifier so\n * the failure surfaces at construction time, not on the first query.\n */\nfunction resolveTable(table: string | undefined): string {\n  const resolved = table ?? DEFAULT_TABLE;\n\n  if (!SAFE_IDENTIFIER.test(resolved)) {\n    throw new Error(\n      `Pg snapshot store: invalid table name '${resolved}'. Allowed: [A-Za-z_][A-Za-z0-9_]*.`,\n    );\n  }\n\n  return resolved;\n}\n\n/**\n * Coerce a `payload` column value back into a {@link SupervisorSnapshot}.\n * node-postgres parses `JSONB` into a JS value already, but some pool\n * wrappers hand back the raw string — be defensive across both.\n */\nfunction parsePayload(payload: unknown): SupervisorSnapshot {\n  if (typeof payload === \"string\") {\n    return JSON.parse(payload) as SupervisorSnapshot;\n  }\n\n  return payload as SupervisorSnapshot;\n}\n\n/**\n * Postgres {@link SnapshotStore} — supervisor run snapshots persisted to a\n * single row per `runId` in a dev-provisioned table (orchestrator.md §8).\n *\n * Owns: durable round-tripping of the {@link SupervisorSnapshot} envelope\n * keyed by `runId`, so a crashed mid-turn `iterate: true` iteration can\n * resume after a restart. Does NOT own: the connection (the caller passes\n * a live `pg.Pool`/`pg.Client` and keeps owning its lifecycle) or schema\n * migration ({@link PgSnapshotStore.schema} returns DDL the dev runs\n * themselves — the framework never auto-migrates, §8.5).\n *\n * Unlike the append-only checkpoint store, a run has exactly one live\n * snapshot, so `save()` upserts on the `run_id` primary key.\n *\n * Front it with the {@link pg} factory — callers never `new` it.\n */\nclass PgSnapshotStore implements SnapshotStore {\n  /** The user-supplied pg client. The store only ever calls `query`. */\n  private readonly client: PgClientLike;\n\n  /** Validated, resolved table name. Safe to interpolate into SQL. */\n  private readonly table: string;\n\n  public constructor(options: PgSnapshotStoreOptions) {\n    if (!options || !options.client || typeof options.client.query !== \"function\") {\n      throw new Error(\n        \"Pg snapshot store requires a 'client' option implementing { query(text, params) } — pass a pg.Pool or pg.Client.\",\n      );\n    }\n\n    this.client = options.client;\n    this.table = resolveTable(options.table);\n  }\n\n  /**\n   * Load the snapshot for a `runId`, or `undefined` when no in-flight run\n   * is recorded.\n   */\n  public async load(runId: string): Promise<SupervisorSnapshot | undefined> {\n    const { rows } = await this.client.query(\n      `SELECT payload FROM ${this.table} WHERE run_id = $1`,\n      [runId],\n    );\n\n    if (rows.length === 0) {\n      return undefined;\n    }\n\n    return parsePayload((rows[0] as { payload: unknown }).payload);\n  }\n\n  /**\n   * Persist a snapshot, keyed by its own `runId`. Upserts — a run has\n   * exactly one live snapshot, so a second save for the same `runId`\n   * overwrites the payload rather than appending.\n   */\n  public async save(snapshot: SupervisorSnapshot): Promise<void> {\n    await this.client.query(\n      `INSERT INTO ${this.table} (run_id, payload, saved_at)\n       VALUES ($1, $2::jsonb, now())\n       ON CONFLICT (run_id) DO UPDATE\n         SET payload = EXCLUDED.payload,\n             saved_at = EXCLUDED.saved_at`,\n      [snapshot.runId, JSON.stringify(snapshot)],\n    );\n  }\n\n  /**\n   * Drop the snapshot for a `runId`.\n   */\n  public async delete(runId: string): Promise<void> {\n    await this.client.query(`DELETE FROM ${this.table} WHERE run_id = $1`, [\n      runId,\n    ]);\n  }\n\n  /**\n   * List the known run ids, optionally filtered by a prefix. The `_` and\n   * `%` LIKE wildcards in the prefix are escaped so an opaque runId that\n   * happens to contain them is matched literally.\n   */\n  public async list(prefix?: string): Promise<string[]> {\n    if (prefix === undefined) {\n      const { rows } = await this.client.query(\n        `SELECT run_id FROM ${this.table}`,\n      );\n\n      return rows.map((row) => (row as { run_id: string }).run_id);\n    }\n\n    const escaped = prefix\n      .replace(/\\\\/g, \"\\\\\\\\\")\n      .replace(/_/g, \"\\\\_\")\n      .replace(/%/g, \"\\\\%\");\n\n    const { rows } = await this.client.query(\n      `SELECT run_id FROM ${this.table} WHERE run_id LIKE $1 ESCAPE '\\\\'`,\n      [`${escaped}%`],\n    );\n\n    return rows.map((row) => (row as { run_id: string }).run_id);\n  }\n\n  /**\n   * Return the DDL for this store's backing table. Run once via the\n   * caller's migration tooling — the store never auto-migrates (§8.5).\n   *\n   * @example\n   * await pool.query(store.schema());\n   */\n  public schema(): string {\n    return [\n      `CREATE TABLE IF NOT EXISTS ${this.table} (`,\n      `  run_id    TEXT PRIMARY KEY,`,\n      `  payload   JSONB NOT NULL,`,\n      `  saved_at  TIMESTAMPTZ NOT NULL DEFAULT now()`,\n      `);`,\n      `CREATE INDEX IF NOT EXISTS idx_${this.table}_saved_at ON ${this.table} (saved_at);`,\n    ].join(\"\\n\");\n  }\n}\n\n/**\n * Create a Postgres-backed {@link SnapshotStore}. Pass a live\n * `pg.Pool`/`pg.Client` — the store never opens or closes it. Schema is\n * not auto-migrated: run {@link SnapshotStore.schema} through your own\n * migration tool first.\n *\n * @example\n * import { Pool } from \"pg\";\n * import { ai } from \"@warlock.js/ai\";\n *\n * const pool = new Pool({ connectionString: process.env.DATABASE_URL });\n *\n * const orchestrator = ai.orchestrator({\n *   name: \"support\",\n *   intents: { ... },\n *   iterate: true,\n *   snapshotStore: ai.snapshot.pg({\n *     client: pool,\n *     table: \"warlock_supervisor_snapshots\",\n *   }),\n * });\n *\n * // Run once, via your own migration tooling:\n * // await pool.query(orchestrator's store.schema());\n */\nexport function pg(options: PgSnapshotStoreOptions): SnapshotStore {\n  return new PgSnapshotStore(options);\n}\n"],"mappings":";;;;;;AAWA,MAAM,gBAAgB;;;;;;;;AAStB,MAAM,kBAAkB;;;;;AAkBxB,SAAS,aAAa,OAAmC;CACvD,MAAM,WAAW,SAAS;CAE1B,IAAI,CAAC,gBAAgB,KAAK,QAAQ,GAChC,MAAM,IAAI,MACR,0CAA0C,SAAS,oCACrD;CAGF,OAAO;AACT;;;;;;AAOA,SAAS,aAAa,SAAsC;CAC1D,IAAI,OAAO,YAAY,UACrB,OAAO,KAAK,MAAM,OAAO;CAG3B,OAAO;AACT;;;;;;;;;;;;;;;;;AAkBA,IAAM,kBAAN,MAA+C;CAO7C,AAAO,YAAY,SAAiC;EAClD,IAAI,CAAC,WAAW,CAAC,QAAQ,UAAU,OAAO,QAAQ,OAAO,UAAU,YACjE,MAAM,IAAI,MACR,kHACF;EAGF,KAAK,SAAS,QAAQ;EACtB,KAAK,QAAQ,aAAa,QAAQ,KAAK;CACzC;;;;;CAMA,MAAa,KAAK,OAAwD;EACxE,MAAM,EAAE,SAAS,MAAM,KAAK,OAAO,MACjC,uBAAuB,KAAK,MAAM,qBAClC,CAAC,KAAK,CACR;EAEA,IAAI,KAAK,WAAW,GAClB;EAGF,OAAO,aAAc,KAAK,EAAE,CAA0B,OAAO;CAC/D;;;;;;CAOA,MAAa,KAAK,UAA6C;EAC7D,MAAM,KAAK,OAAO,MAChB,eAAe,KAAK,MAAM;;;;4CAK1B,CAAC,SAAS,OAAO,KAAK,UAAU,QAAQ,CAAC,CAC3C;CACF;;;;CAKA,MAAa,OAAO,OAA8B;EAChD,MAAM,KAAK,OAAO,MAAM,eAAe,KAAK,MAAM,qBAAqB,CACrE,KACF,CAAC;CACH;;;;;;CAOA,MAAa,KAAK,QAAoC;EACpD,IAAI,WAAW,QAAW;GACxB,MAAM,EAAE,SAAS,MAAM,KAAK,OAAO,MACjC,sBAAsB,KAAK,OAC7B;GAEA,OAAO,KAAK,KAAK,QAAS,IAA2B,MAAM;EAC7D;EAEA,MAAM,UAAU,OACb,QAAQ,OAAO,MAAM,CAAC,CACtB,QAAQ,MAAM,KAAK,CAAC,CACpB,QAAQ,MAAM,KAAK;EAEtB,MAAM,EAAE,SAAS,MAAM,KAAK,OAAO,MACjC,sBAAsB,KAAK,MAAM,oCACjC,CAAC,GAAG,QAAQ,EAAE,CAChB;EAEA,OAAO,KAAK,KAAK,QAAS,IAA2B,MAAM;CAC7D;;;;;;;;CASA,AAAO,SAAiB;EACtB,OAAO;GACL,8BAA8B,KAAK,MAAM;GACzC;GACA;GACA;GACA;GACA,kCAAkC,KAAK,MAAM,eAAe,KAAK,MAAM;EACzE,CAAC,CAAC,KAAK,IAAI;CACb;AACF;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BA,SAAgB,GAAG,SAAgD;CACjE,OAAO,IAAI,gBAAgB,OAAO;AACpC"}

package/esm/snapshot/redis.d.mts

@@ -1,6 +1,6 @@
 import { RedisClientLike, SnapshotStore } from "../contracts/orchestrator/snapshot-store.contract.mjs";
 
-//#region ../@warlock.js/ai/src/snapshot/redis.d.ts
+//#region ../ai/src/snapshot/redis.d.ts
 /**
  * Options for {@link redis}. The `client` is an already-connected redis
  * client (anything satisfying {@link RedisClientLike}); the store never

package/esm/snapshot/redis.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"redis.d.mts","names":[],"sources":["../../../../../../../@warlock.js/ai/src/snapshot/redis.ts"],"mappings":";;;;;AAkBA;;;KAAY,yBAAA;EAEV,0EAAA,MAAA,EAAQ,eAAe;EAKvB;;AAAM;AAqHR;EArHE,MAAA;AAAA;;;;;;AAqHsE;;;;;;;;;;;;;;;;;iBAAxD,KAAA,CAAM,OAAA,EAAS,yBAAA,GAA4B,aAAa"}
+{"version":3,"file":"redis.d.mts","names":[],"sources":["../../../../../../../ai/src/snapshot/redis.ts"],"mappings":";;;;;AAkBA;;;KAAY,yBAAA;EAEV,0EAAA,MAAA,EAAQ,eAAe;EAKvB;;AAAM;AAqHR;EArHE,MAAA;AAAA;;;;;;AAqHsE;;;;;;;;;;;;;;;;;iBAAxD,KAAA,CAAM,OAAA,EAAS,yBAAA,GAA4B,aAAa"}

package/esm/snapshot/redis.mjs

@@ -1,4 +1,4 @@
-//#region ../@warlock.js/ai/src/snapshot/redis.ts
+//#region ../ai/src/snapshot/redis.ts
 /**
 * Default key prefix the redis store prepends to each `runId`. Namespaces
 * the snapshot keys so they coexist with other data in the same Redis

package/esm/snapshot/redis.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"redis.mjs","names":[],"sources":["../../../../../../../@warlock.js/ai/src/snapshot/redis.ts"],"sourcesContent":["import type {\n  RedisClientLike,\n  SnapshotStore,\n} from \"../contracts/orchestrator/snapshot-store.contract\";\nimport type { SupervisorSnapshot } from \"../contracts/supervisor/supervisor-snapshot.type\";\n\n/**\n * Default key prefix the redis store prepends to each `runId`. Namespaces\n * the snapshot keys so they coexist with other data in the same Redis\n * database without collision.\n */\nconst DEFAULT_PREFIX = \"warlock:supervisor:snapshot:\";\n\n/**\n * Options for {@link redis}. The `client` is an already-connected redis\n * client (anything satisfying {@link RedisClientLike}); the store never\n * connects or quits it — connection lifecycle stays with the caller.\n */\nexport type RedisSnapshotStoreOptions = {\n  /** Pre-connected redis client. The store only calls `get`/`set`/`del`. */\n  client: RedisClientLike;\n  /**\n   * Key prefix prepended to each `runId`. Defaults to\n   * `warlock:supervisor:snapshot:`.\n   */\n  prefix?: string;\n};\n\n/**\n * Redis {@link SnapshotStore} — supervisor run snapshots persisted as one\n * JSON string value per `runId`, under a namespaced key (orchestrator.md\n * §8).\n *\n * Owns: durable round-tripping of the {@link SupervisorSnapshot} envelope\n * keyed by `runId`, so a crashed mid-turn `iterate: true` iteration can\n * resume after a restart. Does NOT own: the connection (the caller passes\n * a live client and keeps owning its lifecycle) or enumeration — the\n * structural {@link RedisClientLike} surface exposes only `get`/`set`/\n * `del`, with no `SCAN`/`KEYS`, so `list()` is intentionally not\n * implemented (the contract allows stores that can't enumerate to omit\n * it). Pair it with a {@link import(\"../contracts/orchestrator/checkpoint-store.contract\").CheckpointStore}\n * for the boot-drain loop, which is where enumeration is actually needed.\n *\n * `save()` overwrites the key — a run has exactly one live snapshot.\n * Redis needs no schema, so {@link RedisSnapshotStore.schema} returns an\n * empty string for uniformity with the other drivers.\n *\n * Front it with the {@link redis} factory — callers never `new` it.\n */\nclass RedisSnapshotStore implements SnapshotStore {\n  /** The user-supplied redis client. Only `get`/`set`/`del` are called. */\n  private readonly client: RedisClientLike;\n\n  /** Key prefix prepended to each `runId`. */\n  private readonly prefix: string;\n\n  public constructor(options: RedisSnapshotStoreOptions) {\n    if (\n      !options ||\n      !options.client ||\n      typeof options.client.get !== \"function\" ||\n      typeof options.client.set !== \"function\" ||\n      typeof options.client.del !== \"function\"\n    ) {\n      throw new Error(\n        \"Redis snapshot store requires a 'client' option implementing { get, set, del } — pass a connected redis client.\",\n      );\n    }\n\n    this.client = options.client;\n    this.prefix = options.prefix ?? DEFAULT_PREFIX;\n  }\n\n  /**\n   * Build the namespaced Redis key for a `runId`.\n   */\n  private key(runId: string): string {\n    return `${this.prefix}${runId}`;\n  }\n\n  /**\n   * Load the snapshot for a `runId`, or `undefined` when the key is\n   * missing. Redis returns `null` for an absent key — converted to\n   * `undefined` at the boundary.\n   */\n  public async load(runId: string): Promise<SupervisorSnapshot | undefined> {\n    const value = await this.client.get(this.key(runId));\n\n    if (value === null) {\n      return undefined;\n    }\n\n    return JSON.parse(value) as SupervisorSnapshot;\n  }\n\n  /**\n   * Persist a snapshot, keyed by its own `runId`. Overwrites any prior\n   * snapshot for the same run — a run has exactly one live snapshot.\n   */\n  public async save(snapshot: SupervisorSnapshot): Promise<void> {\n    await this.client.set(this.key(snapshot.runId), JSON.stringify(snapshot));\n  }\n\n  /**\n   * Drop the snapshot for a `runId`.\n   */\n  public async delete(runId: string): Promise<void> {\n    await this.client.del(this.key(runId));\n  }\n\n  /**\n   * Redis needs no backing table — there is nothing to migrate. Returns\n   * an empty string so callers can treat `schema()` uniformly across\n   * drivers.\n   */\n  public schema(): string {\n    return \"\";\n  }\n}\n\n/**\n * Create a Redis-backed {@link SnapshotStore}. Pass a connected redis\n * client — the store never connects or quits it.\n *\n * Note: this store does not implement the optional `list()` — the\n * structural client surface has no `SCAN`/`KEYS`. Use a checkpoint store\n * for the production boot-drain loop where enumeration is needed.\n *\n * @example\n * import { createClient } from \"redis\";\n * import { ai } from \"@warlock.js/ai\";\n *\n * const client = createClient({ url: process.env.REDIS_URL });\n * await client.connect();\n *\n * const orchestrator = ai.orchestrator({\n *   name: \"support\",\n *   intents: { ... },\n *   iterate: true,\n *   snapshotStore: ai.snapshot.redis({ client }),\n * });\n */\nexport function redis(options: RedisSnapshotStoreOptions): SnapshotStore {\n  return new RedisSnapshotStore(options);\n}\n"],"mappings":";;;;;;AAWA,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;AAsCvB,IAAM,qBAAN,MAAkD;CAOhD,AAAO,YAAY,SAAoC;EACrD,IACE,CAAC,WACD,CAAC,QAAQ,UACT,OAAO,QAAQ,OAAO,QAAQ,cAC9B,OAAO,QAAQ,OAAO,QAAQ,cAC9B,OAAO,QAAQ,OAAO,QAAQ,YAE9B,MAAM,IAAI,MACR,iHACF;EAGF,KAAK,SAAS,QAAQ;EACtB,KAAK,SAAS,QAAQ,UAAU;CAClC;;;;CAKA,AAAQ,IAAI,OAAuB;EACjC,OAAO,GAAG,KAAK,SAAS;CAC1B;;;;;;CAOA,MAAa,KAAK,OAAwD;EACxE,MAAM,QAAQ,MAAM,KAAK,OAAO,IAAI,KAAK,IAAI,KAAK,CAAC;EAEnD,IAAI,UAAU,MACZ;EAGF,OAAO,KAAK,MAAM,KAAK;CACzB;;;;;CAMA,MAAa,KAAK,UAA6C;EAC7D,MAAM,KAAK,OAAO,IAAI,KAAK,IAAI,SAAS,KAAK,GAAG,KAAK,UAAU,QAAQ,CAAC;CAC1E;;;;CAKA,MAAa,OAAO,OAA8B;EAChD,MAAM,KAAK,OAAO,IAAI,KAAK,IAAI,KAAK,CAAC;CACvC;;;;;;CAOA,AAAO,SAAiB;EACtB,OAAO;CACT;AACF;;;;;;;;;;;;;;;;;;;;;;;AAwBA,SAAgB,MAAM,SAAmD;CACvE,OAAO,IAAI,mBAAmB,OAAO;AACvC"}
+{"version":3,"file":"redis.mjs","names":[],"sources":["../../../../../../../ai/src/snapshot/redis.ts"],"sourcesContent":["import type {\n  RedisClientLike,\n  SnapshotStore,\n} from \"../contracts/orchestrator/snapshot-store.contract\";\nimport type { SupervisorSnapshot } from \"../contracts/supervisor/supervisor-snapshot.type\";\n\n/**\n * Default key prefix the redis store prepends to each `runId`. Namespaces\n * the snapshot keys so they coexist with other data in the same Redis\n * database without collision.\n */\nconst DEFAULT_PREFIX = \"warlock:supervisor:snapshot:\";\n\n/**\n * Options for {@link redis}. The `client` is an already-connected redis\n * client (anything satisfying {@link RedisClientLike}); the store never\n * connects or quits it — connection lifecycle stays with the caller.\n */\nexport type RedisSnapshotStoreOptions = {\n  /** Pre-connected redis client. The store only calls `get`/`set`/`del`. */\n  client: RedisClientLike;\n  /**\n   * Key prefix prepended to each `runId`. Defaults to\n   * `warlock:supervisor:snapshot:`.\n   */\n  prefix?: string;\n};\n\n/**\n * Redis {@link SnapshotStore} — supervisor run snapshots persisted as one\n * JSON string value per `runId`, under a namespaced key (orchestrator.md\n * §8).\n *\n * Owns: durable round-tripping of the {@link SupervisorSnapshot} envelope\n * keyed by `runId`, so a crashed mid-turn `iterate: true` iteration can\n * resume after a restart. Does NOT own: the connection (the caller passes\n * a live client and keeps owning its lifecycle) or enumeration — the\n * structural {@link RedisClientLike} surface exposes only `get`/`set`/\n * `del`, with no `SCAN`/`KEYS`, so `list()` is intentionally not\n * implemented (the contract allows stores that can't enumerate to omit\n * it). Pair it with a {@link import(\"../contracts/orchestrator/checkpoint-store.contract\").CheckpointStore}\n * for the boot-drain loop, which is where enumeration is actually needed.\n *\n * `save()` overwrites the key — a run has exactly one live snapshot.\n * Redis needs no schema, so {@link RedisSnapshotStore.schema} returns an\n * empty string for uniformity with the other drivers.\n *\n * Front it with the {@link redis} factory — callers never `new` it.\n */\nclass RedisSnapshotStore implements SnapshotStore {\n  /** The user-supplied redis client. Only `get`/`set`/`del` are called. */\n  private readonly client: RedisClientLike;\n\n  /** Key prefix prepended to each `runId`. */\n  private readonly prefix: string;\n\n  public constructor(options: RedisSnapshotStoreOptions) {\n    if (\n      !options ||\n      !options.client ||\n      typeof options.client.get !== \"function\" ||\n      typeof options.client.set !== \"function\" ||\n      typeof options.client.del !== \"function\"\n    ) {\n      throw new Error(\n        \"Redis snapshot store requires a 'client' option implementing { get, set, del } — pass a connected redis client.\",\n      );\n    }\n\n    this.client = options.client;\n    this.prefix = options.prefix ?? DEFAULT_PREFIX;\n  }\n\n  /**\n   * Build the namespaced Redis key for a `runId`.\n   */\n  private key(runId: string): string {\n    return `${this.prefix}${runId}`;\n  }\n\n  /**\n   * Load the snapshot for a `runId`, or `undefined` when the key is\n   * missing. Redis returns `null` for an absent key — converted to\n   * `undefined` at the boundary.\n   */\n  public async load(runId: string): Promise<SupervisorSnapshot | undefined> {\n    const value = await this.client.get(this.key(runId));\n\n    if (value === null) {\n      return undefined;\n    }\n\n    return JSON.parse(value) as SupervisorSnapshot;\n  }\n\n  /**\n   * Persist a snapshot, keyed by its own `runId`. Overwrites any prior\n   * snapshot for the same run — a run has exactly one live snapshot.\n   */\n  public async save(snapshot: SupervisorSnapshot): Promise<void> {\n    await this.client.set(this.key(snapshot.runId), JSON.stringify(snapshot));\n  }\n\n  /**\n   * Drop the snapshot for a `runId`.\n   */\n  public async delete(runId: string): Promise<void> {\n    await this.client.del(this.key(runId));\n  }\n\n  /**\n   * Redis needs no backing table — there is nothing to migrate. Returns\n   * an empty string so callers can treat `schema()` uniformly across\n   * drivers.\n   */\n  public schema(): string {\n    return \"\";\n  }\n}\n\n/**\n * Create a Redis-backed {@link SnapshotStore}. Pass a connected redis\n * client — the store never connects or quits it.\n *\n * Note: this store does not implement the optional `list()` — the\n * structural client surface has no `SCAN`/`KEYS`. Use a checkpoint store\n * for the production boot-drain loop where enumeration is needed.\n *\n * @example\n * import { createClient } from \"redis\";\n * import { ai } from \"@warlock.js/ai\";\n *\n * const client = createClient({ url: process.env.REDIS_URL });\n * await client.connect();\n *\n * const orchestrator = ai.orchestrator({\n *   name: \"support\",\n *   intents: { ... },\n *   iterate: true,\n *   snapshotStore: ai.snapshot.redis({ client }),\n * });\n */\nexport function redis(options: RedisSnapshotStoreOptions): SnapshotStore {\n  return new RedisSnapshotStore(options);\n}\n"],"mappings":";;;;;;AAWA,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;AAsCvB,IAAM,qBAAN,MAAkD;CAOhD,AAAO,YAAY,SAAoC;EACrD,IACE,CAAC,WACD,CAAC,QAAQ,UACT,OAAO,QAAQ,OAAO,QAAQ,cAC9B,OAAO,QAAQ,OAAO,QAAQ,cAC9B,OAAO,QAAQ,OAAO,QAAQ,YAE9B,MAAM,IAAI,MACR,iHACF;EAGF,KAAK,SAAS,QAAQ;EACtB,KAAK,SAAS,QAAQ,UAAU;CAClC;;;;CAKA,AAAQ,IAAI,OAAuB;EACjC,OAAO,GAAG,KAAK,SAAS;CAC1B;;;;;;CAOA,MAAa,KAAK,OAAwD;EACxE,MAAM,QAAQ,MAAM,KAAK,OAAO,IAAI,KAAK,IAAI,KAAK,CAAC;EAEnD,IAAI,UAAU,MACZ;EAGF,OAAO,KAAK,MAAM,KAAK;CACzB;;;;;CAMA,MAAa,KAAK,UAA6C;EAC7D,MAAM,KAAK,OAAO,IAAI,KAAK,IAAI,SAAS,KAAK,GAAG,KAAK,UAAU,QAAQ,CAAC;CAC1E;;;;CAKA,MAAa,OAAO,OAA8B;EAChD,MAAM,KAAK,OAAO,IAAI,KAAK,IAAI,KAAK,CAAC;CACvC;;;;;;CAOA,AAAO,SAAiB;EACtB,OAAO;CACT;AACF;;;;;;;;;;;;;;;;;;;;;;;AAwBA,SAAgB,MAAM,SAAmD;CACvE,OAAO,IAAI,mBAAmB,OAAO;AACvC"}