@warlock.js/ai 4.5.0 → 4.6.1

package/CHANGELOG.md

@@ -4,6 +4,20 @@ All notable changes to `@warlock.js/ai` are documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). `@warlock.js/*` packages are released in lockstep — every package shares the same version number, so a version below may list only the changes that affected this package.
 
+## 4.6.0
+
+### Added
+
+- **`ai.image(params)`** — image generation, the first verb of the output-modality track (Theme I). Wraps an `ImageModelContract` in the uniform never-throws `{ data, error, usage, report }` envelope, with cost-truth (per-token for `gpt-image`, per-image for DALL·E / Imagen) folded into the same `Usage.cost` rollup and a `type: "image"` report routed to observers. Ships on the OpenAI + Google adapters.
+- **`SDKAdapterContract.image?(config)`** — the image-model capability seam, mirroring `embedder?()`. Adds `ImageModelContract`, `GeneratedImage` (discriminated `base64` | `url`), `ImageModelPricing`, and `ImageGenerationOptions`.
+- **`MockSDK().image(...)` + `MockImageModel`** — deterministic image doubles (scriptable responses, recorded calls, pricing) for tests.
+- **`ai.speech(params)` + `ai.transcribe(params)`** — text-to-speech and speech-to-text, the audio verbs of the modality track. Same uniform never-throws envelope + cost-truth (per-character / per-minute / per-token). New `SpeechModelContract` / `TranscriptionModelContract` on `SDKAdapterContract.speech?()` / `transcribe?()`, plus `MockSpeechModel` / `MockTranscriptionModel`.
+- **`ai.audioFromFile(path)` / `ai.audioFromBuffer(bytes, mediaType)` / `ai.audioMediaTypeForFilename(name)`** — non-AI utilities that package audio (WhatsApp `.ogg`/`.opus`, iOS `.m4a`, …) into the `AudioInput` shape `ai.transcribe` consumes.
+- **`ai.rag.pgVectorStore({ client })`** — a Postgres + pgvector vector store satisfying `VectorStoreContract` (upsert / query / removeNamespace), with an `ensureSchema()` DDL helper and a lazy `pg` optional peer.
+- **`ai.rag.loadText` / `loadHtml` / `loadWeb` / `loadPdf`** — document loaders producing `RagDocument`s for `.index()`. `loadWeb` is SSRF-safe (routes through `guardedFetch` / `OutboundPolicy`); `loadPdf` uses a lazy `pdf-parse` optional peer.
+- **Durable mid-run crash-resume** — opt-in `durable: { store, deleteOnComplete? }` on `ai.agent` / `ai.planner` with a stable `runId` + `agent.resume(runId)` / `planner.resume(runId)`. Per-trip (agent) / per-node (planner) checkpoints reuse `ai.snapshot.{memory,pg,redis}`; drift detection via `AgentDriftError` / `PlannerDriftError` (bypass with `{ force: true }`); completed work never re-runs its tools and usage is never double-counted.
+- **`ai.rag.*` namespace** now also carries `chunk`, `cacheVectorStore`, `pgVectorStore`, `loadText`/`loadHtml`/`loadWeb`/`loadPdf`, `bm25Rank`, `reciprocalRankFusion`, `hybridRank`, `multiQuery` (previously standalone-only exports), for `ai.*`-namespace consistency.
+
 ## 4.5.0 - 2026-07-01
 
 ### Added

package/cjs/index.cjs

@@ -1,9 +1,10 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_src = require('./src-C02yzsLs.cjs');
+const require_src = require('./src-OZyDYHxm.cjs');
 const require_matcher_logic = require('./matcher-logic-SBnzYohQ.cjs');
 
 exports.AIError = require_src.AIError;
 exports.AgentCancelledError = require_src.AgentCancelledError;
+exports.AgentDriftError = require_src.AgentDriftError;
 exports.AgentExecutionError = require_src.AgentExecutionError;
 exports.AgentMaxTripsError = require_src.AgentMaxTripsError;
 exports.ApprovalRejectedError = require_src.ApprovalRejectedError;
@@ -20,9 +21,12 @@ exports.InvalidRequestError = require_src.InvalidRequestError;
 exports.JUDGE_DEFAULT_REPAIR_ATTEMPTS = require_src.JUDGE_DEFAULT_REPAIR_ATTEMPTS;
 exports.MaxIterationsError = require_src.MaxIterationsError;
 exports.MaxStepsExceededError = require_src.MaxStepsExceededError;
+exports.MockImageModel = require_src.MockImageModel;
 exports.MockModel = require_src.MockModel;
 exports.MockSDK = require_src.MockSDK;
 exports.MockSkillsStore = require_src.MockSkillsStore;
+exports.MockSpeechModel = require_src.MockSpeechModel;
+exports.MockTranscriptionModel = require_src.MockTranscriptionModel;
 exports.OPENAI_INSTALL_INSTRUCTIONS = require_src.OPENAI_INSTALL_INSTRUCTIONS;
 exports.OrchestratorCancelledError = require_src.OrchestratorCancelledError;
 exports.OrchestratorConfigError = require_src.OrchestratorConfigError;
@@ -31,8 +35,10 @@ exports.OrchestratorEmitter = require_src.OrchestratorEmitter;
 exports.OrchestratorExecution = require_src.OrchestratorExecution;
 exports.OrchestratorFailedError = require_src.OrchestratorFailedError;
 exports.OutboundPolicyError = require_src.OutboundPolicyError;
+exports.PDF_PARSE_INSTALL_INSTRUCTIONS = require_src.PDF_PARSE_INSTALL_INSTRUCTIONS;
 exports.Persona = require_src.Persona;
 exports.PlannerCancelledError = require_src.PlannerCancelledError;
+exports.PlannerDriftError = require_src.PlannerDriftError;
 exports.PlannerFailedError = require_src.PlannerFailedError;
 exports.PlannerPlanInvalidError = require_src.PlannerPlanInvalidError;
 exports.PromptNotFoundError = require_src.PromptNotFoundError;
@@ -65,6 +71,9 @@ exports.agent = require_src.agent;
 exports.ai = require_src.ai;
 exports.approximateTokenCount = require_src.approximateTokenCount;
 exports.assertUrlAllowed = require_src.assertUrlAllowed;
+exports.audioFromBuffer = require_src.audioFromBuffer;
+exports.audioFromFile = require_src.audioFromFile;
+exports.audioMediaTypeForFilename = require_src.audioMediaTypeForFilename;
 exports.batch = require_src.batch;
 exports.bm25Rank = require_src.bm25Rank;
 exports.budget = require_src.budget;
@@ -80,6 +89,7 @@ exports.chunk = require_src.chunk;
 exports.collectStreamObject = require_src.collectStreamObject;
 exports.composeMiddleware = require_src.composeMiddleware;
 exports.computeCost = require_src.computeCost;
+exports.computeImageCost = require_src.computeImageCost;
 exports.computeOrchestratorSignature = require_src.computeOrchestratorSignature;
 exports.computePlannerSignature = require_src.computeSignature$1;
 exports.computeSignature = require_src.computeSignature;
@@ -118,6 +128,7 @@ exports.guardrail = require_src.guardrail;
 exports.hashRequest = require_src.hashRequest;
 exports.humanApproval = require_src.humanApproval;
 exports.hybridRank = require_src.hybridRank;
+exports.image = require_src.image;
 exports.inProcessSessionLock = require_src.inProcessSessionLock;
 exports.injectOrchestratorMemories = require_src.injectMemories;
 exports.injection = require_src.injection;
@@ -131,9 +142,13 @@ exports.isPrivateOrReservedIp = require_src.isPrivateOrReservedIp;
 exports.judge = require_src.judge;
 exports.keywordReranker = require_src.keywordReranker;
 exports.llmReranker = require_src.llmReranker;
+exports.loadHtml = require_src.loadHtml;
+exports.loadPdf = require_src.loadPdf;
 exports.loadRecord = require_src.loadRecord;
 exports.loadSkillTool = require_src.loadSkillTool;
 exports.loadSupervisorSnapshotForResume = require_src.loadSnapshotForResume;
+exports.loadText = require_src.loadText;
+exports.loadWeb = require_src.loadWeb;
 exports.matchConverge = require_matcher_logic.matchConverge;
 exports.matchOutputShape = require_matcher_logic.matchOutputShape;
 exports.matchPassStep = require_matcher_logic.matchPassStep;
@@ -157,6 +172,7 @@ exports.parsePartialJson = require_src.parsePartialJson;
 exports.parseTags = require_src.parseTags;
 exports.persistSupervisorSnapshot = require_src.persistSupervisorSnapshot;
 exports.persona = require_src.persona;
+exports.pgVectorStore = require_src.pgVectorStore;
 exports.pii = require_src.pii;
 exports.planSchema = require_src.planSchema;
 exports.planner = require_src.planner;
@@ -208,6 +224,7 @@ exports.snapshotMemory = require_src.memory;
 exports.snapshotPg = require_src.pg;
 exports.snapshotRedis = require_src.redis;
 exports.spawnSubAgent = require_src.spawnSubAgent;
+exports.speech = require_src.speech;
 exports.stampReportLineage = require_src.stampReportLineage;
 exports.step = require_src.step;
 exports.storeSource = require_src.storeSource;
@@ -222,8 +239,10 @@ exports.toJSON = require_src.toJSON;
 exports.toJUnit = require_src.toJUnit;
 exports.tool = require_src.tool;
 exports.topic = require_src.topic;
+exports.transcribe = require_src.transcribe;
 exports.urlSource = require_src.urlSource;
 exports.vcr = require_src.vcr;
+exports.vectorLiteral = require_src.vectorLiteral;
 exports.withRunFrame = require_src.withRunFrame;
 exports.withoutRunFrame = require_src.withoutRunFrame;
 exports.workflow = require_src.workflow;

package/cjs/{src-DFibP2FQ.cjs → src-Bmajk4Qg.cjs}

@@ -25,6 +25,6 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 }) : target, mod));
 
 //#endregion
-require('./src-C02yzsLs.cjs');
+require('./src-OZyDYHxm.cjs');
 let _warlock_js_logger = require("@warlock.js/logger");
 require("openai");