@warlock.js/ai 4.4.0 → 4.6.0

package/esm/agent/snapshot.mjs

@@ -0,0 +1,101 @@
+import { AgentExecutionError } from "../errors/agent-execution-error.mjs";
+import { AgentDriftError } from "../errors/agent-drift-error.mjs";
+import "../errors/index.mjs";
+import { resolveDefaultSnapshotStore } from "../config.mjs";
+
+//#region ../@warlock.js/ai/src/agent/snapshot.ts
+/**
+* Resolve the effective {@link SnapshotStore}: the agent's own
+* `durable.store` wins; absent that, fall back to the global default
+* set via `ai.config({ defaultSnapshotStore })`.
+*
+* The global default is typed for the supervisor snapshot shape, but
+* every store impl keys purely by `runId` and round-trips whatever
+* envelope it is handed — so it serves an `AgentSnapshot` just as well.
+* The cast re-tags the shape at this single boundary (Option B); the
+* agent only ever hands it an `AgentSnapshot`.
+*/
+function resolveSnapshotStore(durable) {
+	return durable?.store ?? resolveDefaultSnapshotStore();
+}
+/**
+* Write the current run state to the resolved snapshot store. No-op
+* (returns `{ ok: true }`) when neither `durable.store` nor the global
+* `defaultSnapshotStore` is configured — the common non-durable path.
+* Failures are returned as `{ ok: false }` rather than thrown so the
+* engine can surface them via logs without aborting the run — a failed
+* checkpoint loses resume-ability from that point but never breaks an
+* otherwise-healthy run.
+*/
+async function persistAgentSnapshot(params) {
+	const store = resolveSnapshotStore(params.durable);
+	if (!store) return { ok: true };
+	const snapshot = {
+		runId: params.runId,
+		agentName: params.agentName,
+		signature: params.signature,
+		version: params.version,
+		input: params.input,
+		systemPrompt: params.systemPrompt,
+		responseSchema: params.responseSchema,
+		promptName: params.promptName,
+		promptVersion: params.promptVersion,
+		messages: params.messages,
+		trips: params.trips,
+		toolCalls: params.toolCalls,
+		usage: params.usage,
+		status: params.status,
+		startedAt: params.startedAt,
+		savedAt: (/* @__PURE__ */ new Date()).toISOString()
+	};
+	try {
+		await store.save(snapshot);
+		return { ok: true };
+	} catch (error) {
+		return {
+			ok: false,
+			error
+		};
+	}
+}
+/**
+* Delete a persisted snapshot — used after a successful run when
+* `durable.deleteOnComplete` is set. Never throws: a failed delete is
+* surfaced as `{ ok: false }` and the engine logs it. No-op (ok) when no
+* store is configured.
+*/
+async function deleteAgentSnapshot(params) {
+	const store = resolveSnapshotStore(params.durable);
+	if (!store) return { ok: true };
+	try {
+		await store.delete(params.runId);
+		return { ok: true };
+	} catch (error) {
+		return {
+			ok: false,
+			error
+		};
+	}
+}
+/**
+* Load a persisted snapshot for `resume()` and run the drift check.
+* Throws `AgentExecutionError` when no store is configured or when the
+* run is missing; throws `AgentDriftError` when the stored signature
+* doesn't match the current definition (unless `force` is set).
+*/
+async function loadAgentSnapshotForResume(params) {
+	const store = resolveSnapshotStore(params.durable);
+	if (!store) throw new AgentExecutionError(`agent "${params.agentName}" has no durable store configured — set \`durable: { store }\` on the config or call \`ai.config({ defaultSnapshotStore })\` at boot before calling resume()`, { context: { runId: params.runId } });
+	const snapshot = await store.load(params.runId) ?? null;
+	if (!snapshot) throw new AgentExecutionError(`agent "${params.agentName}": no snapshot for runId "${params.runId}"`, { context: { runId: params.runId } });
+	if (!params.options?.force && snapshot.signature !== params.signature) throw new AgentDriftError(`agent "${params.agentName}" signature drift on resume`, {
+		savedSignature: snapshot.signature,
+		currentSignature: params.signature,
+		runId: params.runId
+	});
+	return snapshot;
+}
+
+//#endregion
+export { deleteAgentSnapshot, loadAgentSnapshotForResume, persistAgentSnapshot };
+//# sourceMappingURL=snapshot.mjs.map

package/esm/agent/snapshot.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.mjs","names":[],"sources":["../../../../../../../@warlock.js/ai/src/agent/snapshot.ts"],"sourcesContent":["import { resolveDefaultSnapshotStore } from \"../config\";\nimport type {\n  AgentResumeOptions,\n} from \"../contracts/agent/agent-options.type\";\nimport type {\n  AgentSnapshot,\n  AgentSnapshotStatus,\n} from \"../contracts/agent/agent-snapshot.type\";\nimport type { SnapshotStore } from \"../contracts/orchestrator/snapshot-store.contract\";\nimport type { Message } from \"../contracts/conversation-message.type\";\nimport type { LLMTrip } from \"../contracts/result/llm-trip.type\";\nimport type { ToolCall } from \"../contracts/result/tool-call.type\";\nimport type { Usage } from \"../contracts/result/usage.type\";\nimport { AgentDriftError, AgentExecutionError } from \"../errors\";\n\n/**\n * The agent's `durable` config, narrowed to the fields the snapshot\n * helpers read. Kept minimal so this module doesn't depend on the full\n * resolved-config shape.\n */\nexport type AgentDurableConfig = {\n  store?: SnapshotStore<AgentSnapshot>;\n  deleteOnComplete?: boolean;\n};\n\n/**\n * Resolve the effective {@link SnapshotStore}: the agent's own\n * `durable.store` wins; absent that, fall back to the global default\n * set via `ai.config({ defaultSnapshotStore })`.\n *\n * The global default is typed for the supervisor snapshot shape, but\n * every store impl keys purely by `runId` and round-trips whatever\n * envelope it is handed — so it serves an `AgentSnapshot` just as well.\n * The cast re-tags the shape at this single boundary (Option B); the\n * agent only ever hands it an `AgentSnapshot`.\n */\nfunction resolveSnapshotStore(\n  durable: AgentDurableConfig | undefined,\n): SnapshotStore<AgentSnapshot> | undefined {\n  return (\n    durable?.store ??\n    (resolveDefaultSnapshotStore() as SnapshotStore<AgentSnapshot> | undefined)\n  );\n}\n\nexport type PersistAgentParams = {\n  durable: AgentDurableConfig | undefined;\n  runId: string;\n  agentName: string;\n  signature: string;\n  version?: string;\n  input: string;\n  systemPrompt?: string;\n  responseSchema?: Record<string, unknown>;\n  promptName?: string;\n  promptVersion?: string;\n  messages: Message[];\n  trips: LLMTrip[];\n  toolCalls: ToolCall[];\n  usage: Usage;\n  status: AgentSnapshotStatus;\n  startedAt: string;\n};\n\nexport type PersistOutcome = { ok: true } | { ok: false; error: unknown };\n\n/**\n * Write the current run state to the resolved snapshot store. No-op\n * (returns `{ ok: true }`) when neither `durable.store` nor the global\n * `defaultSnapshotStore` is configured — the common non-durable path.\n * Failures are returned as `{ ok: false }` rather than thrown so the\n * engine can surface them via logs without aborting the run — a failed\n * checkpoint loses resume-ability from that point but never breaks an\n * otherwise-healthy run.\n */\nexport async function persistAgentSnapshot(\n  params: PersistAgentParams,\n): Promise<PersistOutcome> {\n  const store = resolveSnapshotStore(params.durable);\n\n  if (!store) {\n    return { ok: true };\n  }\n\n  const snapshot: AgentSnapshot = {\n    runId: params.runId,\n    agentName: params.agentName,\n    signature: params.signature,\n    version: params.version,\n    input: params.input,\n    systemPrompt: params.systemPrompt,\n    responseSchema: params.responseSchema,\n    promptName: params.promptName,\n    promptVersion: params.promptVersion,\n    messages: params.messages,\n    trips: params.trips,\n    toolCalls: params.toolCalls,\n    usage: params.usage,\n    status: params.status,\n    startedAt: params.startedAt,\n    savedAt: new Date().toISOString(),\n  };\n\n  try {\n    await store.save(snapshot);\n\n    return { ok: true };\n  } catch (error) {\n    return { ok: false, error };\n  }\n}\n\n/**\n * Delete a persisted snapshot — used after a successful run when\n * `durable.deleteOnComplete` is set. Never throws: a failed delete is\n * surfaced as `{ ok: false }` and the engine logs it. No-op (ok) when no\n * store is configured.\n */\nexport async function deleteAgentSnapshot(params: {\n  durable: AgentDurableConfig | undefined;\n  runId: string;\n}): Promise<PersistOutcome> {\n  const store = resolveSnapshotStore(params.durable);\n\n  if (!store) {\n    return { ok: true };\n  }\n\n  try {\n    await store.delete(params.runId);\n\n    return { ok: true };\n  } catch (error) {\n    return { ok: false, error };\n  }\n}\n\n/**\n * Load a persisted snapshot for `resume()` and run the drift check.\n * Throws `AgentExecutionError` when no store is configured or when the\n * run is missing; throws `AgentDriftError` when the stored signature\n * doesn't match the current definition (unless `force` is set).\n */\nexport async function loadAgentSnapshotForResume(params: {\n  durable: AgentDurableConfig | undefined;\n  agentName: string;\n  signature: string;\n  runId: string;\n  options?: AgentResumeOptions<unknown>;\n}): Promise<AgentSnapshot> {\n  const store = resolveSnapshotStore(params.durable);\n\n  if (!store) {\n    throw new AgentExecutionError(\n      `agent \"${params.agentName}\" has no durable store configured — set \\`durable: { store }\\` on the config or call \\`ai.config({ defaultSnapshotStore })\\` at boot before calling resume()`,\n      { context: { runId: params.runId } },\n    );\n  }\n\n  const snapshot = (await store.load(params.runId)) ?? null;\n\n  if (!snapshot) {\n    throw new AgentExecutionError(\n      `agent \"${params.agentName}\": no snapshot for runId \"${params.runId}\"`,\n      { context: { runId: params.runId } },\n    );\n  }\n\n  if (!params.options?.force && snapshot.signature !== params.signature) {\n    throw new AgentDriftError(\n      `agent \"${params.agentName}\" signature drift on resume`,\n      {\n        savedSignature: snapshot.signature,\n        currentSignature: params.signature,\n        runId: params.runId,\n      },\n    );\n  }\n\n  return snapshot;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAoCA,SAAS,qBACP,SAC0C;CAC1C,OACE,SAAS,SACR,4BAA4B;AAEjC;;;;;;;;;;AAgCA,eAAsB,qBACpB,QACyB;CACzB,MAAM,QAAQ,qBAAqB,OAAO,OAAO;CAEjD,IAAI,CAAC,OACH,OAAO,EAAE,IAAI,KAAK;CAGpB,MAAM,WAA0B;EAC9B,OAAO,OAAO;EACd,WAAW,OAAO;EAClB,WAAW,OAAO;EAClB,SAAS,OAAO;EAChB,OAAO,OAAO;EACd,cAAc,OAAO;EACrB,gBAAgB,OAAO;EACvB,YAAY,OAAO;EACnB,eAAe,OAAO;EACtB,UAAU,OAAO;EACjB,OAAO,OAAO;EACd,WAAW,OAAO;EAClB,OAAO,OAAO;EACd,QAAQ,OAAO;EACf,WAAW,OAAO;EAClB,0BAAS,IAAI,KAAK,EAAC,CAAC,YAAY;CAClC;CAEA,IAAI;EACF,MAAM,MAAM,KAAK,QAAQ;EAEzB,OAAO,EAAE,IAAI,KAAK;CACpB,SAAS,OAAO;EACd,OAAO;GAAE,IAAI;GAAO;EAAM;CAC5B;AACF;;;;;;;AAQA,eAAsB,oBAAoB,QAGd;CAC1B,MAAM,QAAQ,qBAAqB,OAAO,OAAO;CAEjD,IAAI,CAAC,OACH,OAAO,EAAE,IAAI,KAAK;CAGpB,IAAI;EACF,MAAM,MAAM,OAAO,OAAO,KAAK;EAE/B,OAAO,EAAE,IAAI,KAAK;CACpB,SAAS,OAAO;EACd,OAAO;GAAE,IAAI;GAAO;EAAM;CAC5B;AACF;;;;;;;AAQA,eAAsB,2BAA2B,QAMtB;CACzB,MAAM,QAAQ,qBAAqB,OAAO,OAAO;CAEjD,IAAI,CAAC,OACH,MAAM,IAAI,oBACR,UAAU,OAAO,UAAU,+JAC3B,EAAE,SAAS,EAAE,OAAO,OAAO,MAAM,EAAE,CACrC;CAGF,MAAM,WAAY,MAAM,MAAM,KAAK,OAAO,KAAK,KAAM;CAErD,IAAI,CAAC,UACH,MAAM,IAAI,oBACR,UAAU,OAAO,UAAU,4BAA4B,OAAO,MAAM,IACpE,EAAE,SAAS,EAAE,OAAO,OAAO,MAAM,EAAE,CACrC;CAGF,IAAI,CAAC,OAAO,SAAS,SAAS,SAAS,cAAc,OAAO,WAC1D,MAAM,IAAI,gBACR,UAAU,OAAO,UAAU,8BAC3B;EACE,gBAAgB,SAAS;EACzB,kBAAkB,OAAO;EACzB,OAAO,OAAO;CAChB,CACF;CAGF,OAAO;AACT"}

package/esm/ai-openai/src/embedder.mjs

@@ -0,0 +1,4 @@
+import "./utils/index.mjs";
+import { log } from "@warlock.js/logger";
+
+export {  };

package/esm/ai-openai/src/image.mjs

@@ -0,0 +1,5 @@
+import "../../index.mjs";
+import "./utils/index.mjs";
+import { log } from "@warlock.js/logger";
+
+export {  };

package/esm/ai-openai/src/index.mjs

@@ -0,0 +1,7 @@
+import "./embedder.mjs";
+import "./image.mjs";
+import "./speech.mjs";
+import "./transcription.mjs";
+import "./sdk.mjs";
+
+export {  };

package/esm/ai-openai/src/model.mjs

@@ -0,0 +1,5 @@
+import "../../index.mjs";
+import "./utils/index.mjs";
+import { log } from "@warlock.js/logger";
+
+export {  };

package/esm/ai-openai/src/sdk.mjs

@@ -0,0 +1,9 @@
+import "../../index.mjs";
+import "./embedder.mjs";
+import "./image.mjs";
+import "./model.mjs";
+import "./speech.mjs";
+import "./transcription.mjs";
+import "openai";
+
+export {  };

package/esm/ai-openai/src/speech.mjs

@@ -0,0 +1,5 @@
+import "../../index.mjs";
+import "./utils/index.mjs";
+import { log } from "@warlock.js/logger";
+
+export {  };

package/esm/ai-openai/src/transcription.mjs

@@ -0,0 +1,6 @@
+import "../../index.mjs";
+import "./utils/index.mjs";
+import { log } from "@warlock.js/logger";
+import "openai";
+
+export {  };

package/esm/ai-openai/src/utils/index.mjs

@@ -0,0 +1,5 @@
+import "./to-openai-messages.mjs";
+import "./to-openai-tools.mjs";
+import "./wrap-openai-error.mjs";
+
+export {  };

package/esm/ai-openai/src/utils/to-openai-messages.mjs

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

package/esm/ai-openai/src/utils/to-openai-tools.mjs

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

package/esm/ai-openai/src/utils/wrap-openai-error.mjs

@@ -0,0 +1,4 @@
+import "../../../index.mjs";
+import "openai";
+
+export {  };

package/esm/ai.d.mts

@@ -2,16 +2,27 @@ import { tool } from "./tool/tool.mjs";
 import { agent } from "./agent/agent.mjs";
 import { budget, readBudgetFallbackSignal } from "./middleware/builtins/budget.mjs";
 import { spawnSubAgent } from "./agent/spawn-sub-agent.mjs";
-import { SystemPromptFactory } from "./system-prompt/system-prompt.mjs";
-import { judge } from "./eval/judge-scorer.mjs";
-import { contains, exact, predicate } from "./eval/scorers.mjs";
 import { batch } from "./batch/batch.mjs";
+import { streamObject } from "./object-stream/stream-object.mjs";
+import { serve } from "./serve/serve.mjs";
 import { memory } from "./checkpoint/memory.mjs";
 import { pg } from "./checkpoint/pg.mjs";
 import { redis } from "./checkpoint/redis.mjs";
 import { setAIConfig } from "./config.mjs";
-import { memory as memory$1 } from "./memory/memory.mjs";
-import { guardrail } from "./middleware/builtins/guardrail.mjs";
+import { dataset } from "./eval/dataset.mjs";
+import { evalScorers } from "./eval/index.mjs";
+import { humanApproval } from "./human/human-approval.mjs";
+import { image } from "./image/image.mjs";
+import { speech } from "./speech/speech.mjs";
+import { audioFromBuffer, audioFromFile, audioMediaTypeForFilename } from "./transcribe/audio-input.mjs";
+import { transcribe } from "./transcribe/transcribe.mjs";
+import { resume } from "./human/resume.mjs";
+import { memory as memory$1 } from "./human/stores/memory.mjs";
+import { pg as pg$1 } from "./human/stores/pg.mjs";
+import { redis as redis$1 } from "./human/stores/redis.mjs";
+import { guardrail } from "./guard/guardrail.mjs";
+import { memory as memory$2 } from "./memory/memory.mjs";
+import { guardrail as guardrail$1 } from "./middleware/builtins/guardrail.mjs";
 import { semanticCache } from "./middleware/builtins/semantic-cache.mjs";
 import { composeMiddleware } from "./middleware/helpers/compose.mjs";
 import { forTool } from "./middleware/helpers/for-tool.mjs";
@@ -19,18 +30,158 @@ import { mockRouter } from "./mock/mock-router.mjs";
 import { fallbackModel } from "./model/fallback-model.mjs";
 import { orchestrator } from "./orchestrator/orchestrator.mjs";
 import { planner } from "./planner/planner.mjs";
-import { memory as memory$2 } from "./snapshot/memory.mjs";
-import { pg as pg$1 } from "./snapshot/pg.mjs";
-import { redis as redis$1 } from "./snapshot/redis.mjs";
+import { defaultPromptsManager } from "./prompts/prompts-manager.mjs";
+import { rag } from "./rag/rag.mjs";
+import { chunk } from "./rag/chunk/chunk.mjs";
+import { cacheVectorStore } from "./rag/store/cache-vector-store.mjs";
+import { pgVectorStore, vectorLiteral } from "./rag/store/pg-vector-store.mjs";
+import { loadText } from "./rag/loaders/load-text.mjs";
+import { loadHtml } from "./rag/loaders/load-html.mjs";
+import { loadWeb } from "./rag/loaders/load-web.mjs";
+import { loadPdf } from "./rag/loaders/load-pdf.mjs";
+import { keywordReranker } from "./rag/rerank/keyword-reranker.mjs";
+import { llmReranker } from "./rag/rerank/llm-reranker.mjs";
+import { reciprocalRankFusion } from "./rag/hybrid/rrf.mjs";
+import { bm25Rank } from "./rag/hybrid/bm25.mjs";
+import { hybridRank } from "./rag/hybrid/hybrid-rank.mjs";
+import { multiQuery } from "./rag/transforms/multi-query.mjs";
+import { skills } from "./skills/skills.mjs";
+import { systemPrompt } from "./system-prompt/system-prompt.mjs";
+import { prompt } from "./prompt/prompt.mjs";
+import { vcr } from "./vcr/vcr.mjs";
+import { memory as memory$3 } from "./snapshot/memory.mjs";
+import { pg as pg$2 } from "./snapshot/pg.mjs";
+import { redis as redis$2 } from "./snapshot/redis.mjs";
 import { fanOut } from "./supervisor/fan-out.mjs";
 import { router } from "./supervisor/router-factory.mjs";
 import { supervisor } from "./supervisor/supervisor.mjs";
+import { team } from "./team/team.mjs";
 import { instruction } from "./system-prompt/instruction.mjs";
 import { persona } from "./system-prompt/persona.mjs";
 import { step } from "./workflow/step.mjs";
 import { workflow } from "./workflow/workflow.mjs";
 
 //#region ../@warlock.js/ai/src/ai.d.ts
+/**
+ * The shape of the top-level `ai` namespace. Declared as an `interface` (not an
+ * inferred `const` type) so satellite packages can attach their verb via
+ * `declare module "@warlock.js/ai" { interface Ai { … } }` — e.g. `ai.workspace`,
+ * `ai.tools`, `ai.mcp`, `ai.human`. The runtime object below is asserted to this
+ * type; a satellite assigns its member on import.
+ */
+interface Ai {
+  config: typeof setAIConfig;
+  tool: typeof tool;
+  agent: typeof agent;
+  systemPrompt: typeof systemPrompt;
+  persona: typeof persona;
+  instruction: typeof instruction;
+  workflow: typeof workflow;
+  step: typeof step;
+  supervisor: typeof supervisor;
+  team: typeof team;
+  orchestrator: typeof orchestrator;
+  memory: typeof memory$2;
+  skills: typeof skills;
+  planner: typeof planner;
+  rag: typeof rag & {
+    keywordReranker: typeof keywordReranker;
+    llmReranker: typeof llmReranker;
+    chunk: typeof chunk;
+    cacheVectorStore: typeof cacheVectorStore;
+    pgVectorStore: typeof pgVectorStore;
+    vectorLiteral: typeof vectorLiteral;
+    loadText: typeof loadText;
+    loadHtml: typeof loadHtml;
+    loadWeb: typeof loadWeb;
+    loadPdf: typeof loadPdf;
+    bm25Rank: typeof bm25Rank;
+    reciprocalRankFusion: typeof reciprocalRankFusion;
+    hybridRank: typeof hybridRank;
+    multiQuery: typeof multiQuery;
+  };
+  spawnSubAgent: typeof spawnSubAgent;
+  router: typeof router;
+  fanOut: typeof fanOut;
+  batch: typeof batch;
+  /** Structured-output streaming — partial-object snapshots + a strict final parse (A1). */
+  streamObject: typeof streamObject;
+  /** Serve an executable as an SSE HTTP endpoint — production serving primitive (A3). */
+  serve: typeof serve;
+  /**
+   * Generate images from a text prompt — the image-output verb of the
+   * output-modality track (Theme I). Wraps an `ImageModelContract` (from
+   * `openai.image(...)` / `google.image(...)`) in the uniform
+   * never-throws `{ data, error, usage, report }` envelope with cost-truth
+   * and observability.
+   */
+  image: typeof image;
+  /** Text-to-speech (TTS) — the audio-output verb of the modality track (Theme I). */
+  speech: typeof speech;
+  /** Speech-to-text (STT / transcription) — the audio-input verb of the modality track (Theme I). */
+  transcribe: typeof transcribe;
+  /** Read an audio file from disk → `AudioInput` for `ai.transcribe` (non-AI file plumbing). */
+  audioFromFile: typeof audioFromFile;
+  /** Package raw audio bytes → `AudioInput` for `ai.transcribe`. */
+  audioFromBuffer: typeof audioFromBuffer;
+  /** Resolve the audio media type from a filename's extension. */
+  audioMediaTypeForFilename: typeof audioMediaTypeForFilename;
+  fallbackModel: typeof fallbackModel;
+  eval: typeof evalScorers;
+  dataset: typeof dataset;
+  prompt: typeof prompt;
+  /**
+   * Process-wide registry of named, versioned `systemPrompt(...)` builders,
+   * keyed by `name@version`. A `systemPrompt(input, { name })` (or any
+   * `.meta({ name })` rename) auto-registers here; `ai.prompts.get(name)` /
+   * `.resolve(name)` reads them back, and `systemPrompt().merge(name)` folds a
+   * registered prompt into a new one.
+   */
+  prompts: ReturnType<typeof defaultPromptsManager>;
+  vcr: typeof vcr;
+  mockRouter: typeof mockRouter;
+  middleware: {
+    budget: typeof budget;
+    guardrail: typeof guardrail$1;
+    semanticCache: typeof semanticCache;
+    compose: typeof composeMiddleware;
+    forTool: typeof forTool;
+    readBudgetFallbackSignal: typeof readBudgetFallbackSignal;
+  };
+  checkpoint: {
+    memory: typeof memory;
+    pg: typeof pg;
+    redis: typeof redis;
+  };
+  snapshot: {
+    memory: typeof memory$3;
+    pg: typeof pg$2;
+    redis: typeof redis$2;
+  };
+  /**
+   * Human-in-the-loop tool approval (interrupt / resume).
+   *
+   * - `human.approval(options)` — the `tool.before` approval-gate middleware.
+   * - `human.resume(id, decision, options)` — out-of-process durable resume.
+   * - `human.interrupt.{memory,pg,redis}()` — durable {@link InterruptStore}
+   *   factories (memory ships real; pg/redis are lazy optional peers).
+   */
+  human: {
+    approval: typeof humanApproval;
+    resume: typeof resume;
+    interrupt: {
+      memory: typeof memory$1;
+      pg: typeof pg$1;
+      redis: typeof redis$1;
+    };
+  };
+  /**
+   * Content-intelligence guardrail. `ai.guardrail(options)` builds a composed
+   * input / output / tool middleware; `ai.guardrail.{pii,topic,injection,moderation}`
+   * are the built-in detector factories.
+   */
+  guardrail: typeof guardrail;
+}
 /**
  * Top-level `ai` namespace — holds built-in factories and user-registered SDK adapters.
  *
@@ -42,6 +193,7 @@ import { workflow } from "./workflow/workflow.mjs";
  * - `ai.instruction(text)` — reusable instruction block (can be passed to `systemPrompt`).
  * - `ai.orchestrator(...)` — session-state manager wrapped around a supervisor (durable session, drift detection, resume, commands).
  * - `ai.memory(...)` — build an agent-memory store with WORKING (in-run scratch) and SEMANTIC (cache-driver `.similar()` recall) tiers.
+ * - `ai.skills(...)` — build a runtime skills library (always-injected metadata catalog + on-demand loadSkill tool).
  * - `ai.planner(...)` — build an executable that generates an ordered plan over registered capabilities, then runs it step-by-step.
  * - `ai.spawnSubAgent(spec)` — thin wrapper that builds a fresh one-shot `agent()` with an optional per-task `budget` and runs the task once. A general primitive (not planner-specific).
  * - `ai.router(...)` — build a supervisor-compatible routing agent from named intents.
@@ -52,6 +204,8 @@ import { workflow } from "./workflow/workflow.mjs";
  * - `ai.mockRouter(decisions, opts?)` — deterministic supervisor `route` callback for tests.
  * - `ai.checkpoint.{memory,pg,redis}()` — durable orchestrator session checkpoint stores.
  * - `ai.snapshot.{memory,pg,redis}()` — supervisor-run snapshot stores for `iterate: true` resume.
+ * - `ai.human.approval(...)` / `ai.human.resume(...)` / `ai.human.interrupt.{memory,pg,redis}()` — human-in-the-loop tool approval (interrupt / resume).
+ * - `ai.guardrail(options)` + `ai.guardrail.{pii,topic,injection,moderation}(...)` — content-intelligence guardrails (moderation / PII / injection / topic).
  * - `ai.openai.model(...)` / `ai.anthropic.model(...)` / ... once the adapter SDK is registered.
  *
  * @example
@@ -70,50 +224,7 @@ import { workflow } from "./workflow/workflow.mjs";
  *   placeholders: { language: "Arabic" },
  * });
  */
-declare const ai: {
-  config: typeof setAIConfig;
-  tool: typeof tool;
-  agent: typeof agent;
-  systemPrompt: SystemPromptFactory;
-  persona: typeof persona;
-  instruction: typeof instruction;
-  workflow: typeof workflow;
-  step: typeof step;
-  supervisor: typeof supervisor;
-  orchestrator: typeof orchestrator;
-  memory: typeof memory$1;
-  planner: typeof planner;
-  spawnSubAgent: typeof spawnSubAgent;
-  router: typeof router;
-  fanOut: typeof fanOut;
-  batch: typeof batch;
-  fallbackModel: typeof fallbackModel;
-  eval: {
-    exact: typeof exact;
-    contains: typeof contains;
-    predicate: typeof predicate;
-    judge: typeof judge;
-  };
-  mockRouter: typeof mockRouter;
-  middleware: {
-    budget: typeof budget;
-    guardrail: typeof guardrail;
-    semanticCache: typeof semanticCache;
-    compose: typeof composeMiddleware;
-    forTool: typeof forTool;
-    readBudgetFallbackSignal: typeof readBudgetFallbackSignal;
-  };
-  checkpoint: {
-    memory: typeof memory;
-    pg: typeof pg;
-    redis: typeof redis;
-  };
-  snapshot: {
-    memory: typeof memory$2;
-    pg: typeof pg$1;
-    redis: typeof redis$1;
-  };
-};
+declare const ai: Ai;
 //#endregion
-export { ai };
+export { Ai, ai };
 //# sourceMappingURL=ai.d.mts.map

package/esm/ai.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"ai.d.mts","names":[],"sources":["../../../../../../@warlock.js/ai/src/ai.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoEA;;;;;;;;;;;;;;;;;;cAAa,EAAA"}
+{"version":3,"file":"ai.d.mts","names":[],"sources":["../../../../../../@warlock.js/ai/src/ai.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UA6EiB,EAAA;EACf,MAAA,SAAe,WAAA;EACf,IAAA,SAAa,IAAA;EACb,KAAA,SAAc,KAAA;EACd,YAAA,SAAqB,YAAA;EACrB,OAAA,SAAgB,OAAA;EAChB,WAAA,SAAoB,WAAA;EACpB,QAAA,SAAiB,QAAA;EACjB,IAAA,SAAa,IAAA;EACb,UAAA,SAAmB,UAAA;EACnB,IAAA,SAAa,IAAA;EACb,YAAA,SAAqB,YAAA;EACrB,MAAA,SAAe,QAAA;EACf,MAAA,SAAe,MAAA;EACf,OAAA,SAAgB,OAAA;EAChB,GAAA,SAAY,GAAA;IACV,eAAA,SAAwB,eAAA;IACxB,WAAA,SAAoB,WAAA;IACpB,KAAA,SAAc,KAAA;IACd,gBAAA,SAAyB,gBAAA;IACzB,aAAA,SAAsB,aAAA;IACtB,aAAA,SAAsB,aAAA;IACtB,QAAA,SAAiB,QAAA;IACjB,QAAA,SAAiB,QAAA;IACjB,OAAA,SAAgB,OAAA;IAChB,OAAA,SAAgB,OAAA;IAChB,QAAA,SAAiB,QAAA;IACjB,oBAAA,SAA6B,oBAAA;IAC7B,UAAA,SAAmB,UAAA;IACnB,UAAA,SAAmB,UAAA;EAAA;EAErB,aAAA,SAAsB,aAAA;EACtB,MAAA,SAAe,MAAA;EACf,MAAA,SAAe,MAAA;EACf,KAAA,SAAc,KAAA;EAjCC;EAmCf,YAAA,SAAqB,YAAA;EAjCP;EAmCd,KAAA,SAAc,KAAA;EAjCE;;;;;;;EAyChB,KAAA,SAAc,KAAA;EAjCC;EAmCf,MAAA,SAAe,MAAA;EAjCH;EAmCZ,UAAA,SAAmB,UAAA;EAjCG;EAmCtB,aAAA,SAAsB,aAAA;EAjCK;EAmC3B,eAAA,SAAwB,eAAA;EAjCA;EAmCxB,yBAAA,SAAkC,yBAAA;EAClC,aAAA,SAAsB,aAAA;EACtB,IAAA,SAAa,WAAA;EACb,OAAA,SAAgB,OAAA;EAChB,MAAA,SAAe,MAAA;EAjCgB;;;;;;;EAyC/B,OAAA,EAAS,UAAA,QAAkB,qBAAA;EAC3B,GAAA,SAAY,GAAA;EACZ,UAAA,SAAmB,UAAA;EACnB,UAAA;IACE,MAAA,SAAe,MAAA;IACf,SAAA,SAAkB,WAAA;IAClB,aAAA,SAAsB,aAAA;IACtB,OAAA,SAAgB,iBAAA;IAChB,OAAA,SAAgB,OAAA;IAChB,wBAAA,SAAiC,wBAAA;EAAA;EAEnC,UAAA;IACE,MAAA,SAAe,MAAA;IACf,EAAA,SAAW,EAAA;IACX,KAAA,SAAc,KAAA;EAAA;EAEhB,QAAA;IACE,MAAA,SAAe,QAAA;IACf,EAAA,SAAW,IAAA;IACX,KAAA,SAAc,OAAA;EAAA;EAVmB;;;;;;;;EAoBnC,KAAA;IACE,QAAA,SAAiB,aAAA;IACjB,MAAA,SAAe,MAAA;IACf,SAAA;MACE,MAAA,SAAe,QAAA;MACf,EAAA,SAAW,IAAA;MACX,KAAA,SAAc,OAAA;IAAA;EAAA;EArGlB;;;;;EA6GA,SAAA,SAAkB,SAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA6CP,EAAA,EAwER,EAAE"}

package/esm/ai.mjs

@@ -5,15 +5,30 @@ import { semanticCache } from "./middleware/builtins/semantic-cache.mjs";
 import { composeMiddleware } from "./middleware/helpers/compose.mjs";
 import { forTool } from "./middleware/helpers/for-tool.mjs";
 import { tool } from "./tool/tool.mjs";
+import { skills } from "./skills/skills.mjs";
+import { memory } from "./memory/memory.mjs";
+import "./skills/index.mjs";
 import { agent } from "./agent/agent.mjs";
 import { spawnSubAgent } from "./agent/spawn-sub-agent.mjs";
 import { batch } from "./batch/batch.mjs";
 import "./batch/index.mjs";
-import { memory } from "./checkpoint/memory.mjs";
+import { streamObject } from "./object-stream/stream-object.mjs";
+import "./object-stream/index.mjs";
+import { serve } from "./serve/serve.mjs";
+import { memory as memory$1 } from "./checkpoint/memory.mjs";
 import { pg } from "./checkpoint/pg.mjs";
 import { redis } from "./checkpoint/redis.mjs";
+import { dataset } from "./eval/dataset.mjs";
 import { evalScorers } from "./eval/index.mjs";
-import { memory as memory$1 } from "./memory/memory.mjs";
+import { human } from "./human/register.mjs";
+import { image } from "./image/image.mjs";
+import "./image/index.mjs";
+import { speech } from "./speech/speech.mjs";
+import "./speech/index.mjs";
+import { audioFromBuffer, audioFromFile, audioMediaTypeForFilename } from "./transcribe/audio-input.mjs";
+import { transcribe } from "./transcribe/transcribe.mjs";
+import "./transcribe/index.mjs";
+import { guardrail as guardrail$1 } from "./guard/guardrail.mjs";
 import { mockRouter } from "./mock/mock-router.mjs";
 import "./mock/index.mjs";
 import { fallbackModel } from "./model/fallback-model.mjs";
@@ -23,15 +38,36 @@ import { orchestrator } from "./orchestrator/orchestrator.mjs";
 import "./orchestrator/index.mjs";
 import { planner } from "./planner/planner.mjs";
 import "./planner/index.mjs";
+import { instruction } from "./system-prompt/instruction.mjs";
+import { persona } from "./system-prompt/persona.mjs";
+import { systemPrompt } from "./system-prompt/system-prompt.mjs";
+import { defaultPromptsManager } from "./prompts/prompts-manager.mjs";
+import { chunk } from "./rag/chunk/chunk.mjs";
+import { cacheVectorStore } from "./rag/store/cache-vector-store.mjs";
+import { rag } from "./rag/rag.mjs";
+import { pgVectorStore, vectorLiteral } from "./rag/store/pg-vector-store.mjs";
+import { loadText } from "./rag/loaders/load-text.mjs";
+import { loadHtml } from "./rag/loaders/load-html.mjs";
+import { loadWeb } from "./rag/loaders/load-web.mjs";
+import { loadPdf } from "./rag/loaders/load-pdf.mjs";
+import { keywordReranker } from "./rag/rerank/keyword-reranker.mjs";
+import { llmReranker } from "./rag/rerank/llm-reranker.mjs";
+import { reciprocalRankFusion } from "./rag/hybrid/rrf.mjs";
+import { bm25Rank } from "./rag/hybrid/bm25.mjs";
+import { hybridRank } from "./rag/hybrid/hybrid-rank.mjs";
+import { multiQuery } from "./rag/transforms/multi-query.mjs";
+import "./rag/index.mjs";
+import { prompt } from "./prompt/prompt.mjs";
+import "./prompt/index.mjs";
+import { vcr } from "./vcr/vcr.mjs";
+import "./vcr/index.mjs";
 import { memory as memory$2 } from "./snapshot/memory.mjs";
 import { pg as pg$1 } from "./snapshot/pg.mjs";
 import { redis as redis$1 } from "./snapshot/redis.mjs";
 import { fanOut } from "./supervisor/fan-out.mjs";
 import { router } from "./supervisor/router-factory.mjs";
 import "./supervisor/index.mjs";
-import { instruction } from "./system-prompt/instruction.mjs";
-import { persona } from "./system-prompt/persona.mjs";
-import { systemPrompt } from "./system-prompt/system-prompt.mjs";
+import { team } from "./team/team.mjs";
 import { step } from "./workflow/step.mjs";
 import { workflow } from "./workflow/workflow.mjs";
 
@@ -47,6 +83,7 @@ import { workflow } from "./workflow/workflow.mjs";
 * - `ai.instruction(text)` — reusable instruction block (can be passed to `systemPrompt`).
 * - `ai.orchestrator(...)` — session-state manager wrapped around a supervisor (durable session, drift detection, resume, commands).
 * - `ai.memory(...)` — build an agent-memory store with WORKING (in-run scratch) and SEMANTIC (cache-driver `.similar()` recall) tiers.
+* - `ai.skills(...)` — build a runtime skills library (always-injected metadata catalog + on-demand loadSkill tool).
 * - `ai.planner(...)` — build an executable that generates an ordered plan over registered capabilities, then runs it step-by-step.
 * - `ai.spawnSubAgent(spec)` — thin wrapper that builds a fresh one-shot `agent()` with an optional per-task `budget` and runs the task once. A general primitive (not planner-specific).
 * - `ai.router(...)` — build a supervisor-compatible routing agent from named intents.
@@ -57,6 +94,8 @@ import { workflow } from "./workflow/workflow.mjs";
 * - `ai.mockRouter(decisions, opts?)` — deterministic supervisor `route` callback for tests.
 * - `ai.checkpoint.{memory,pg,redis}()` — durable orchestrator session checkpoint stores.
 * - `ai.snapshot.{memory,pg,redis}()` — supervisor-run snapshot stores for `iterate: true` resume.
+* - `ai.human.approval(...)` / `ai.human.resume(...)` / `ai.human.interrupt.{memory,pg,redis}()` — human-in-the-loop tool approval (interrupt / resume).
+* - `ai.guardrail(options)` + `ai.guardrail.{pii,topic,injection,moderation}(...)` — content-intelligence guardrails (moderation / PII / injection / topic).
 * - `ai.openai.model(...)` / `ai.anthropic.model(...)` / ... once the adapter SDK is registered.
 *
 * @example
@@ -85,15 +124,45 @@ const ai = {
 	workflow,
 	step,
 	supervisor,
+	team,
 	orchestrator,
-	memory: memory$1,
+	memory,
+	skills,
 	planner,
+	rag: Object.assign(rag, {
+		keywordReranker,
+		llmReranker,
+		chunk,
+		cacheVectorStore,
+		pgVectorStore,
+		vectorLiteral,
+		loadText,
+		loadHtml,
+		loadWeb,
+		loadPdf,
+		bm25Rank,
+		reciprocalRankFusion,
+		hybridRank,
+		multiQuery
+	}),
 	spawnSubAgent,
 	router,
 	fanOut,
 	batch,
+	streamObject,
+	serve,
+	image,
+	speech,
+	transcribe,
+	audioFromFile,
+	audioFromBuffer,
+	audioMediaTypeForFilename,
 	fallbackModel,
 	eval: evalScorers,
+	dataset,
+	prompt,
+	prompts: defaultPromptsManager(),
+	vcr,
 	mockRouter,
 	middleware: {
 		budget,
@@ -104,7 +173,7 @@ const ai = {
 		readBudgetFallbackSignal
 	},
 	checkpoint: {
-		memory,
+		memory: memory$1,
 		pg,
 		redis
 	},
@@ -112,7 +181,9 @@ const ai = {
 		memory: memory$2,
 		pg: pg$1,
 		redis: redis$1
-	}
+	},
+	human,
+	guardrail: guardrail$1
 };
 
 //#endregion