@warlock.js/core 4.8.0 → 4.8.1

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

@@ -1 +0,0 @@
-{"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"}

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

@@ -1,46 +0,0 @@
-//#region ../@warlock.js/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's `scripts/generate-llms.mjs` `parseFrontmatter()` so the
-* runtime catalog and the docs `llms.txt` index agree byte-for-byte on
-* what a skill's `description` is.
-*
-* When the text has no `---`-delimited front-matter block, returns an
-* empty `meta` and the full text as `body`.
-*/
-function parseFrontmatter(text) {
-	const match = text.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
-	if (!match) return {
-		meta: {},
-		body: text
-	};
-	const meta = {};
-	for (const line of match[1].split("\n")) {
-		const colon = line.indexOf(":");
-		if (colon === -1) continue;
-		const key = line.slice(0, colon).trim();
-		let value = line.slice(colon + 1).trim();
-		if (value.startsWith("'") && value.endsWith("'") || value.startsWith("\"") && value.endsWith("\"")) value = value.slice(1, -1).replace(/''/g, "'").replace(/\\"/g, "\"");
-		meta[key] = value;
-	}
-	return {
-		meta,
-		body: match[2]
-	};
-}
-/**
-* Split a front-matter `tags:` value into a string array. Accepts a
-* comma-separated inline list (`tags: frontend, react`) — the simple
-* inline form that fits the `key: value` parser. Returns `undefined` when
-* the value is absent or blank so a tagless skill stays `tags: undefined`.
-*/
-function parseTags(value) {
-	if (!value) return;
-	const tags = value.split(",").map((tag) => tag.trim()).filter((tag) => tag.length > 0);
-	return tags.length > 0 ? tags : void 0;
-}
-
-//#endregion
-export { parseFrontmatter, parseTags };
-//# sourceMappingURL=parse-frontmatter.mjs.map

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

@@ -1 +0,0 @@
-{"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"}

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

@@ -1,15 +0,0 @@
-//#region ../@warlock.js/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
-* `ProceduralSkillStore`). The store already implements every reader
-* method, so this is identity; it exists for symmetry with the directory
-* and url sources and to keep `resolveSource` a single dispatch table.
-*/
-function storeSource(store) {
-	return store;
-}
-
-//#endregion
-export { storeSource };
-//# sourceMappingURL=store-source.mjs.map

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

@@ -1 +0,0 @@
-{"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"}

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

@@ -1,117 +0,0 @@
-import { fetchTextWithPolicy } from "../../security/outbound-policy.mjs";
-
-//#region ../@warlock.js/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).
-*
-* **Trust boundary (S3).** A remote skill source is a prompt supply chain —
-* its bodies flow straight into model context — so the manifest fetch runs
-* through the shared `OutboundPolicy` (scheme + host allowlist, post-DNS
-* private-IP deny, max bytes, timeout) and **every record is runtime-
-* validated** before it can be served. A malformed record fails loudly
-* rather than being cast blindly into a `SkillRecord`.
-*
-* The request is made lazily on the first `list()` / `load()`. The result
-* is cached for the source's lifetime, or for `cacheTtlMs` when set
-* (a stale cache refetches on next access).
-*/
-function urlSource(url, options = {}) {
-	const { headers, policy, cacheTtlMs } = options;
-	let cache;
-	let cachedAtMs;
-	const records = () => {
-		const expired = cacheTtlMs !== void 0 && cachedAtMs !== void 0 && Date.now() - cachedAtMs > cacheTtlMs;
-		if (!cache || expired) {
-			cachedAtMs = Date.now();
-			cache = fetchManifest(url, headers, policy);
-		}
-		return cache;
-	};
-	return {
-		async list(scope) {
-			const all = await records();
-			const wanted = scope?.tags;
-			return [...all.values()].filter((record) => record.type !== "candidate").filter((record) => intersects(record.tags, wanted)).map(toCatalogEntry);
-		},
-		async load(name, version) {
-			const record = (await records()).get(name);
-			if (!record || record.type === "candidate") return;
-			if (version !== void 0 && record.version !== version) return;
-			return record;
-		},
-		async saveCandidate() {
-			throw new Error("url source is read-only — saveCandidate requires a writable store (set `review.store`)");
-		},
-		async promote() {
-			throw new Error("url source is read-only — promote requires a writable store (set `review.store`)");
-		}
-	};
-}
-/** Fetch + validate + parse the manifest once into a name → record map. */
-async function fetchManifest(url, headers, policy) {
-	const result = await fetchTextWithPolicy(url, policy ?? {}, headers ? { headers } : void 0);
-	if (!result.ok) throw new Error(`url skill source failed: ${result.status} ${result.statusText} for ${url}`);
-	let parsed;
-	try {
-		parsed = JSON.parse(result.text);
-	} catch (cause) {
-		throw new Error(`url skill source returned invalid JSON from ${url}`, { cause });
-	}
-	if (!Array.isArray(parsed)) throw new Error(`url skill source at ${url} must return a JSON array of skill records`);
-	const records = /* @__PURE__ */ new Map();
-	parsed.forEach((raw, index) => {
-		const record = validateManifestRecord(raw, url, index);
-		records.set(record.name, record);
-	});
-	return records;
-}
-/**
-* Runtime-validate one manifest record before it is trusted as a
-* {@link SkillRecord}. Untyped remote JSON cast blindly into the context
-* is both an injection surface and a correctness bug; this rejects a
-* record missing the required `name` / `description` / `body` strings, and
-* fills `version` / `type` defaults for a thin record.
-*/
-function validateManifestRecord(raw, url, index) {
-	if (!raw || typeof raw !== "object") throw new Error(`url skill source at ${url}: record #${index} is not an object`);
-	const r = raw;
-	const requireString = (field) => {
-		const value = r[field];
-		if (typeof value !== "string" || value.length === 0) throw new Error(`url skill source at ${url}: record #${index} is missing a string "${field}"`);
-		return value;
-	};
-	const name = requireString("name");
-	const description = requireString("description");
-	const body = requireString("body");
-	const type = r.type === "authored" || r.type === "promoted" || r.type === "candidate" ? r.type : "authored";
-	return {
-		name,
-		description,
-		body,
-		version: typeof r.version === "number" ? r.version : 1,
-		type,
-		tags: Array.isArray(r.tags) ? r.tags.filter((t) => typeof t === "string") : void 0,
-		metadata: r.metadata && typeof r.metadata === "object" ? r.metadata : void 0
-	};
-}
-/** Project a full record down to its catalog entry (body omitted). */
-function toCatalogEntry(record) {
-	return {
-		name: record.name,
-		description: record.description,
-		version: record.version,
-		tags: record.tags,
-		type: record.type
-	};
-}
-/** True when no filter is requested or the record shares a requested tag. */
-function intersects(recordTags, wanted) {
-	if (!wanted || wanted.length === 0) return true;
-	if (!recordTags || recordTags.length === 0) return false;
-	return recordTags.some((tag) => wanted.includes(tag));
-}
-
-//#endregion
-export { urlSource };
-//# sourceMappingURL=url-source.mjs.map

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

@@ -1 +0,0 @@
-{"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":"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"}

package/esm/ai/src/snapshot/memory.mjs

@@ -1,81 +0,0 @@
-//#region ../@warlock.js/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.
-*
-* Owns: the `runId` → {@link SupervisorSnapshot} mapping for
-* `iterate: true` mid-turn resume. Does NOT own: durability,
-* cross-process sharing, or TTL eviction — it is the zero-config
-* default for dev, tests, and single-process apps. Reach for
-* `ai.snapshot.pg()` / `ai.snapshot.redis()` (Phase 2) when a crashed
-* process must resume an in-flight turn.
-*
-* Front it with the {@link memory} factory — callers never `new` it.
-*/
-var MemorySnapshotStore = class {
-	constructor() {
-		this.snapshots = /* @__PURE__ */ new Map();
-	}
-	/**
-	* Return the snapshot for a `runId`, or `undefined` when no in-flight
-	* run is recorded.
-	*/
-	async load(runId) {
-		return this.snapshots.get(runId);
-	}
-	/**
-	* Persist a snapshot, keyed by its own `runId`. Overwrites any prior
-	* snapshot for the same run — a run has exactly one live snapshot.
-	*/
-	async save(snapshot) {
-		this.snapshots.set(snapshot.runId, snapshot);
-	}
-	/**
-	* Drop the snapshot for a `runId`.
-	*/
-	async delete(runId) {
-		this.snapshots.delete(runId);
-	}
-	/**
-	* List the known run ids, optionally filtered by a prefix.
-	*/
-	async list(prefix) {
-		const runIds = [];
-		for (const runId of this.snapshots.keys()) {
-			if (prefix !== void 0 && !runId.startsWith(prefix)) continue;
-			runIds.push(runId);
-		}
-		return runIds;
-	}
-	/**
-	* The memory store has no backing table — there is nothing to
-	* migrate. Returns an empty string so callers can treat `schema()`
-	* uniformly across drivers.
-	*/
-	schema() {
-		return "";
-	}
-};
-/**
-* Create an in-memory {@link SnapshotStore}. Zero-config — no client,
-* no connection. Suitable for dev, tests, and single-process apps that
-* don't need to resume an interrupted `iterate: true` turn across
-* restarts.
-*
-* @example
-* import { ai } from "@warlock.js/ai";
-*
-* const orchestrator = ai.orchestrator({
-*   name: "support",
-*   intents: { ... },
-*   iterate: true,
-*   snapshotStore: ai.snapshot.memory(),
-* });
-*/
-function memory() {
-	return new MemorySnapshotStore();
-}
-
-//#endregion
-export { memory };
-//# sourceMappingURL=memory.mjs.map

package/esm/ai/src/snapshot/memory.mjs.map

@@ -1 +0,0 @@
-{"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"}

package/esm/ai/src/snapshot/pg.mjs

@@ -1,146 +0,0 @@
-//#region ../@warlock.js/ai/src/snapshot/pg.ts
-/**
-* Default backing table for the pg snapshot store. Matches the name used
-* in the orchestrator.md §8 reference wiring
-* (`ai.snapshot.pg({ client, table: "warlock_supervisor_snapshots" })`).
-*/
-const DEFAULT_TABLE = "warlock_supervisor_snapshots";
-/**
-* Allowed characters in a Postgres identifier (table name). The
-* conservative ASCII subset; anything else is rejected because the table
-* name is interpolated directly into DDL/DML, and an arbitrary string
-* there would be a SQL-injection footgun. Mirrors `@warlock.js/cache`'s
-* `PgCacheDriver`.
-*/
-const SAFE_IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/;
-/**
-* Validate and resolve the table name. Throws on an unsafe identifier so
-* the failure surfaces at construction time, not on the first query.
-*/
-function resolveTable(table) {
-	const resolved = table ?? DEFAULT_TABLE;
-	if (!SAFE_IDENTIFIER.test(resolved)) throw new Error(`Pg snapshot store: invalid table name '${resolved}'. Allowed: [A-Za-z_][A-Za-z0-9_]*.`);
-	return resolved;
-}
-/**
-* Coerce a `payload` column value back into a {@link SupervisorSnapshot}.
-* node-postgres parses `JSONB` into a JS value already, but some pool
-* wrappers hand back the raw string — be defensive across both.
-*/
-function parsePayload(payload) {
-	if (typeof payload === "string") return JSON.parse(payload);
-	return payload;
-}
-/**
-* Postgres {@link SnapshotStore} — supervisor run snapshots persisted to a
-* single row per `runId` in a dev-provisioned table (orchestrator.md §8).
-*
-* Owns: durable round-tripping of the {@link SupervisorSnapshot} envelope
-* keyed by `runId`, so a crashed mid-turn `iterate: true` iteration can
-* resume after a restart. Does NOT own: the connection (the caller passes
-* a live `pg.Pool`/`pg.Client` and keeps owning its lifecycle) or schema
-* migration ({@link PgSnapshotStore.schema} returns DDL the dev runs
-* themselves — the framework never auto-migrates, §8.5).
-*
-* Unlike the append-only checkpoint store, a run has exactly one live
-* snapshot, so `save()` upserts on the `run_id` primary key.
-*
-* Front it with the {@link pg} factory — callers never `new` it.
-*/
-var PgSnapshotStore = class {
-	constructor(options) {
-		if (!options || !options.client || typeof options.client.query !== "function") throw new Error("Pg snapshot store requires a 'client' option implementing { query(text, params) } — pass a pg.Pool or pg.Client.");
-		this.client = options.client;
-		this.table = resolveTable(options.table);
-	}
-	/**
-	* Load the snapshot for a `runId`, or `undefined` when no in-flight run
-	* is recorded.
-	*/
-	async load(runId) {
-		const { rows } = await this.client.query(`SELECT payload FROM ${this.table} WHERE run_id = $1`, [runId]);
-		if (rows.length === 0) return;
-		return parsePayload(rows[0].payload);
-	}
-	/**
-	* Persist a snapshot, keyed by its own `runId`. Upserts — a run has
-	* exactly one live snapshot, so a second save for the same `runId`
-	* overwrites the payload rather than appending.
-	*/
-	async save(snapshot) {
-		await this.client.query(`INSERT INTO ${this.table} (run_id, payload, saved_at)
-       VALUES ($1, $2::jsonb, now())
-       ON CONFLICT (run_id) DO UPDATE
-         SET payload = EXCLUDED.payload,
-             saved_at = EXCLUDED.saved_at`, [snapshot.runId, JSON.stringify(snapshot)]);
-	}
-	/**
-	* Drop the snapshot for a `runId`.
-	*/
-	async delete(runId) {
-		await this.client.query(`DELETE FROM ${this.table} WHERE run_id = $1`, [runId]);
-	}
-	/**
-	* List the known run ids, optionally filtered by a prefix. The `_` and
-	* `%` LIKE wildcards in the prefix are escaped so an opaque runId that
-	* happens to contain them is matched literally.
-	*/
-	async list(prefix) {
-		if (prefix === void 0) {
-			const { rows } = await this.client.query(`SELECT run_id FROM ${this.table}`);
-			return rows.map((row) => row.run_id);
-		}
-		const escaped = prefix.replace(/\\/g, "\\\\").replace(/_/g, "\\_").replace(/%/g, "\\%");
-		const { rows } = await this.client.query(`SELECT run_id FROM ${this.table} WHERE run_id LIKE $1 ESCAPE '\\'`, [`${escaped}%`]);
-		return rows.map((row) => row.run_id);
-	}
-	/**
-	* Return the DDL for this store's backing table. Run once via the
-	* caller's migration tooling — the store never auto-migrates (§8.5).
-	*
-	* @example
-	* await pool.query(store.schema());
-	*/
-	schema() {
-		return [
-			`CREATE TABLE IF NOT EXISTS ${this.table} (`,
-			`  run_id    TEXT PRIMARY KEY,`,
-			`  payload   JSONB NOT NULL,`,
-			`  saved_at  TIMESTAMPTZ NOT NULL DEFAULT now()`,
-			`);`,
-			`CREATE INDEX IF NOT EXISTS idx_${this.table}_saved_at ON ${this.table} (saved_at);`
-		].join("\n");
-	}
-};
-/**
-* Create a Postgres-backed {@link SnapshotStore}. Pass a live
-* `pg.Pool`/`pg.Client` — the store never opens or closes it. Schema is
-* not auto-migrated: run {@link SnapshotStore.schema} through your own
-* migration tool first.
-*
-* @example
-* import { Pool } from "pg";
-* import { ai } from "@warlock.js/ai";
-*
-* const pool = new Pool({ connectionString: process.env.DATABASE_URL });
-*
-* const orchestrator = ai.orchestrator({
-*   name: "support",
-*   intents: { ... },
-*   iterate: true,
-*   snapshotStore: ai.snapshot.pg({
-*     client: pool,
-*     table: "warlock_supervisor_snapshots",
-*   }),
-* });
-*
-* // Run once, via your own migration tooling:
-* // await pool.query(orchestrator's store.schema());
-*/
-function pg(options) {
-	return new PgSnapshotStore(options);
-}
-
-//#endregion
-export { pg };
-//# sourceMappingURL=pg.mjs.map

package/esm/ai/src/snapshot/pg.mjs.map

@@ -1 +0,0 @@
-{"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"}

package/esm/ai/src/snapshot/redis.mjs

@@ -1,101 +0,0 @@
-//#region ../@warlock.js/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
-* database without collision.
-*/
-const DEFAULT_PREFIX = "warlock:supervisor:snapshot:";
-/**
-* Redis {@link SnapshotStore} — supervisor run snapshots persisted as one
-* JSON string value per `runId`, under a namespaced key (orchestrator.md
-* §8).
-*
-* Owns: durable round-tripping of the {@link SupervisorSnapshot} envelope
-* keyed by `runId`, so a crashed mid-turn `iterate: true` iteration can
-* resume after a restart. Does NOT own: the connection (the caller passes
-* a live client and keeps owning its lifecycle) or enumeration — the
-* structural {@link RedisClientLike} surface exposes only `get`/`set`/
-* `del`, with no `SCAN`/`KEYS`, so `list()` is intentionally not
-* implemented (the contract allows stores that can't enumerate to omit
-* it). Pair it with a {@link import("../contracts/orchestrator/checkpoint-store.contract").CheckpointStore}
-* for the boot-drain loop, which is where enumeration is actually needed.
-*
-* `save()` overwrites the key — a run has exactly one live snapshot.
-* Redis needs no schema, so {@link RedisSnapshotStore.schema} returns an
-* empty string for uniformity with the other drivers.
-*
-* Front it with the {@link redis} factory — callers never `new` it.
-*/
-var RedisSnapshotStore = class {
-	constructor(options) {
-		if (!options || !options.client || typeof options.client.get !== "function" || typeof options.client.set !== "function" || typeof options.client.del !== "function") throw new Error("Redis snapshot store requires a 'client' option implementing { get, set, del } — pass a connected redis client.");
-		this.client = options.client;
-		this.prefix = options.prefix ?? DEFAULT_PREFIX;
-	}
-	/**
-	* Build the namespaced Redis key for a `runId`.
-	*/
-	key(runId) {
-		return `${this.prefix}${runId}`;
-	}
-	/**
-	* Load the snapshot for a `runId`, or `undefined` when the key is
-	* missing. Redis returns `null` for an absent key — converted to
-	* `undefined` at the boundary.
-	*/
-	async load(runId) {
-		const value = await this.client.get(this.key(runId));
-		if (value === null) return;
-		return JSON.parse(value);
-	}
-	/**
-	* Persist a snapshot, keyed by its own `runId`. Overwrites any prior
-	* snapshot for the same run — a run has exactly one live snapshot.
-	*/
-	async save(snapshot) {
-		await this.client.set(this.key(snapshot.runId), JSON.stringify(snapshot));
-	}
-	/**
-	* Drop the snapshot for a `runId`.
-	*/
-	async delete(runId) {
-		await this.client.del(this.key(runId));
-	}
-	/**
-	* Redis needs no backing table — there is nothing to migrate. Returns
-	* an empty string so callers can treat `schema()` uniformly across
-	* drivers.
-	*/
-	schema() {
-		return "";
-	}
-};
-/**
-* Create a Redis-backed {@link SnapshotStore}. Pass a connected redis
-* client — the store never connects or quits it.
-*
-* Note: this store does not implement the optional `list()` — the
-* structural client surface has no `SCAN`/`KEYS`. Use a checkpoint store
-* for the production boot-drain loop where enumeration is needed.
-*
-* @example
-* import { createClient } from "redis";
-* import { ai } from "@warlock.js/ai";
-*
-* const client = createClient({ url: process.env.REDIS_URL });
-* await client.connect();
-*
-* const orchestrator = ai.orchestrator({
-*   name: "support",
-*   intents: { ... },
-*   iterate: true,
-*   snapshotStore: ai.snapshot.redis({ client }),
-* });
-*/
-function redis(options) {
-	return new RedisSnapshotStore(options);
-}
-
-//#endregion
-export { redis };
-//# sourceMappingURL=redis.mjs.map

package/esm/ai/src/snapshot/redis.mjs.map

@@ -1 +0,0 @@
-{"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"}

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

@@ -1,3 +0,0 @@
-import { speech } from "./speech.mjs";
-
-export {  };