@backendkit-labs/curator-codex-agent 0.2.0 → 1.0.1

package/dist/knowledge/transformers-embedder.js

@@ -0,0 +1,222 @@
+import { Worker } from 'node:worker_threads';
+import { fileURLToPath } from 'node:url';
+import * as os from 'node:os';
+const DEFAULT_POOL_SIZE = 2;
+// Don't split a batch into more chunks than this would leave per chunk — below this,
+// the fixed per-call overhead (worker round-trip, tokenizer setup) stops being worth
+// paying for the extra parallelism. Benchmarked against a small-pool workload; revisit
+// if CODEX_EMBED_WORKERS is tuned for a much larger concurrent load.
+const MIN_TEXTS_PER_CHUNK = 8;
+// How long to hold a batch open waiting for more concurrent embed() calls to join it,
+// measured from the first call in the batch (not reset on each new arrival — a steady
+// stream of calls would otherwise starve the flush indefinitely). setImmediate only
+// catches calls issued in the exact same tick; real bursts (e.g. curate_path walking a
+// directory) tend to arrive a few ms apart, missing that window entirely. Every call
+// pays this as fixed added latency, so keep it small.
+const DEFAULT_BATCH_WINDOW_MS = 8;
+/** One worker thread plus its own in-flight request table — the pool's unit of dispatch. */
+class WorkerSlot {
+    worker;
+    pending = new Map();
+    constructor(worker) {
+        this.worker = worker;
+    }
+    get inFlight() {
+        return this.pending.size;
+    }
+}
+/**
+ * Embedder backed by a pool of worker threads (see embedder-worker.ts). The
+ * transformers.js model inference is CPU-bound and single-threaded per worker;
+ * running it off the main thread keeps the MCP server responsive to search_vault
+ * while a reindex embeds in background.
+ *
+ * Two things that matter under concurrent load from multiple callers:
+ * - **Pool, not one worker.** A single worker serializes every embed() behind
+ *   one CPU-bound thread — concurrent callers just queue. A bounded pool
+ *   (CODEX_EMBED_WORKERS, default 2, capped at os.cpus().length) lets that many
+ *   embed batches actually run in parallel instead.
+ * - **Micro-batching.** embed() calls made within a short window (CODEX_EMBED_BATCH_MS,
+ *   default 8ms — not just the same event-loop tick) are merged and split across the
+ *   pool (see flushBatch()), amortizing the model's fixed per-call overhead across
+ *   calls that arrive close together but not perfectly simultaneously.
+ */
+export class TransformersEmbedder {
+    model;
+    quantized = true;
+    poolSize;
+    batchWindowMs;
+    slots = [];
+    seq = 0;
+    progressCb;
+    batchQueue = [];
+    batchScheduled = false;
+    constructor(modelId = 'Xenova/nomic-embed-text-v1', poolSize, batchWindowMs) {
+        this.model = modelId;
+        const envSize = parseInt(process.env.CODEX_EMBED_WORKERS ?? '', 10);
+        const requested = poolSize ?? (Number.isFinite(envSize) && envSize > 0 ? envSize : DEFAULT_POOL_SIZE);
+        this.poolSize = Math.max(1, Math.min(requested, os.cpus().length));
+        const envWindow = parseInt(process.env.CODEX_EMBED_BATCH_MS ?? '', 10);
+        this.batchWindowMs = batchWindowMs
+            ?? (Number.isFinite(envWindow) && envWindow >= 0 ? envWindow : DEFAULT_BATCH_WINDOW_MS);
+    }
+    // ── Pool management ──────────────────────────────────────────────────────
+    ensurePool() {
+        if (this.slots.length === 0) {
+            for (let i = 0; i < this.poolSize; i++) {
+                this.slots.push(this.spawnWorker());
+            }
+        }
+        return this.slots;
+    }
+    spawnWorker() {
+        const workerPath = fileURLToPath(new URL('./embedder-worker.js', import.meta.url));
+        const worker = new Worker(workerPath);
+        const slot = new WorkerSlot(worker);
+        worker.on('message', (msg) => {
+            if (msg.type === 'progress') {
+                if (msg.info)
+                    this.progressCb?.(msg.info);
+                return;
+            }
+            if (typeof msg.id !== 'number')
+                return;
+            const p = slot.pending.get(msg.id);
+            if (!p)
+                return;
+            slot.pending.delete(msg.id);
+            this.updateRef(slot);
+            if (msg.ok)
+                p.resolve(msg);
+            else
+                p.reject(new Error(msg.error ?? 'embedder worker error'));
+        });
+        worker.on('error', (err) => {
+            for (const p of slot.pending.values())
+                p.reject(err);
+            slot.pending.clear();
+        });
+        worker.on('exit', (code) => {
+            if (code !== 0) {
+                const err = new Error(`embedder worker exited with code ${code}`);
+                for (const p of slot.pending.values())
+                    p.reject(err);
+                slot.pending.clear();
+            }
+            this.slots = this.slots.filter(s => s !== slot);
+        });
+        // Idle worker should not keep the process alive on its own; ref() only
+        // while it has requests in flight (see updateRef) so embeds never get cut off.
+        worker.unref();
+        return slot;
+    }
+    /** Keep the process alive while this worker has requests in flight, release it when idle. */
+    updateRef(slot) {
+        if (slot.inFlight > 0)
+            slot.worker.ref();
+        else
+            slot.worker.unref();
+    }
+    /** Least-busy routing — picks the slot with the fewest in-flight requests. */
+    pickSlot() {
+        const slots = this.ensurePool();
+        return slots.reduce((best, s) => (s.inFlight < best.inFlight ? s : best), slots[0]);
+    }
+    request(slot, payload) {
+        const id = ++this.seq;
+        return new Promise((resolve, reject) => {
+            slot.pending.set(id, { resolve, reject });
+            this.updateRef(slot);
+            slot.worker.postMessage({ id, model: this.model, quantized: this.quantized, ...payload });
+        });
+    }
+    // ── Public API ────────────────────────────────────────────────────────────
+    /**
+     * Warms up every worker in the pool so the first real embed() isn't the one
+     * paying model-load cost. The first worker inits alone (it may need to
+     * download the model); once cached to disk, the rest init in parallel since
+     * loading a cached model is fast and safe to parallelize.
+     */
+    async init(onProgress) {
+        const alreadyCached = this.slots.length > 0;
+        const slots = this.ensurePool();
+        this.progressCb = onProgress;
+        try {
+            await this.request(slots[0], { type: 'init' });
+            this.progressCb = undefined;
+            if (slots.length > 1) {
+                await Promise.all(slots.slice(1).map(s => this.request(s, { type: 'init' })));
+            }
+        }
+        finally {
+            this.progressCb = undefined;
+        }
+        return { alreadyCached };
+    }
+    /**
+     * Embeds a batch of texts. Calls made within batchWindowMs of each other are
+     * merged into shared worker requests — see flushBatch().
+     */
+    async embed(texts) {
+        if (texts.length === 0)
+            return [];
+        return new Promise((resolve, reject) => {
+            this.batchQueue.push({ texts, resolve, reject });
+            if (!this.batchScheduled) {
+                this.batchScheduled = true;
+                setTimeout(() => this.flushBatch(), this.batchWindowMs);
+            }
+        });
+    }
+    async embedOne(text) {
+        const results = await this.embed([text]);
+        return results[0] ?? [];
+    }
+    // ── Batching ──────────────────────────────────────────────────────────────
+    async flushBatch() {
+        const batch = this.batchQueue;
+        this.batchQueue = [];
+        this.batchScheduled = false;
+        if (batch.length === 0)
+            return;
+        // Split the batch across up to poolSize workers instead of sending it all to
+        // one — otherwise a pool of N idle workers buys nothing (everything still
+        // funnels through a single inference call) while still paying N times the
+        // model-load cost at init(). Also never split below MIN_TEXTS_PER_CHUNK texts
+        // per chunk — a pool sized for a bigger burst shouldn't over-shard a small batch.
+        const totalTexts = batch.reduce((n, e) => n + e.texts.length, 0);
+        const maxChunksByWork = Math.max(1, Math.floor(totalTexts / MIN_TEXTS_PER_CHUNK));
+        const chunkCount = Math.min(this.ensurePool().length, batch.length, maxChunksByWork);
+        const chunks = this.splitIntoChunks(batch, chunkCount);
+        await Promise.all(chunks.map(chunk => this.runChunk(chunk)));
+    }
+    splitIntoChunks(batch, chunkCount) {
+        const chunks = Array.from({ length: chunkCount }, () => []);
+        batch.forEach((entry, i) => chunks[i % chunkCount].push(entry));
+        return chunks;
+    }
+    async runChunk(chunk) {
+        if (chunk.length === 0)
+            return;
+        const allTexts = chunk.flatMap(e => e.texts);
+        // Picked per chunk, after earlier chunks in this same flush have already
+        // claimed a slot — inFlight is updated synchronously inside request(), so
+        // concurrent chunks land on different workers instead of piling onto one.
+        const slot = this.pickSlot();
+        try {
+            const reply = await this.request(slot, { type: 'embed', texts: allTexts });
+            const embeddings = reply.embeddings ?? [];
+            let offset = 0;
+            for (const entry of chunk) {
+                entry.resolve(embeddings.slice(offset, offset + entry.texts.length));
+                offset += entry.texts.length;
+            }
+        }
+        catch (err) {
+            const e = err instanceof Error ? err : new Error(String(err));
+            for (const entry of chunk)
+                entry.reject(e);
+        }
+    }
+}
+//# sourceMappingURL=transformers-embedder.js.map

package/dist/knowledge/transformers-embedder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformers-embedder.js","sourceRoot":"","sources":["../../src/knowledge/transformers-embedder.ts"],"names":[],"mappings":"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"}

package/dist/pdf-reader.d.ts

@@ -0,0 +1,11 @@
+export interface PdfContent {
+    text: string;
+    pages: number;
+    filename: string;
+}
+/**
+ * Extract plain text from a PDF file.
+ * Returns the full text content, page count, and filename.
+ */
+export declare function extractPdfText(filePath: string): Promise<PdfContent>;
+//# sourceMappingURL=pdf-reader.d.ts.map

package/dist/pdf-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf-reader.d.ts","sourceRoot":"","sources":["../src/pdf-reader.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAY1E"}

package/dist/pdf-reader.js

@@ -0,0 +1,21 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { createRequire } from 'node:module';
+// pdf-parse is CJS — use createRequire to load it safely in ESM/NodeNext
+const require = createRequire(import.meta.url);
+/**
+ * Extract plain text from a PDF file.
+ * Returns the full text content, page count, and filename.
+ */
+export async function extractPdfText(filePath) {
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    const pdfParse = require('pdf-parse');
+    const buffer = await fs.readFile(filePath);
+    const data = await pdfParse(buffer);
+    return {
+        text: data.text.trim(),
+        pages: data.numpages,
+        filename: path.basename(filePath),
+    };
+}
+//# sourceMappingURL=pdf-reader.js.map

package/dist/pdf-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf-reader.js","sourceRoot":"","sources":["../src/pdf-reader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,yEAAyE;AACzE,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAQ/C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,QAAgB;IACjD,8DAA8D;IAC9D,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAgF,CAAC;IAErH,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC3C,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAC;IAEpC,OAAO;QACH,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;QACtB,KAAK,EAAE,IAAI,CAAC,QAAQ;QACpB,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;KACpC,CAAC;AACN,CAAC"}

package/dist/project.d.ts

@@ -0,0 +1,28 @@
+export interface ProjectContext {
+    projectName: string;
+    projectRoot: string;
+    vaultPath: string;
+}
+/**
+ * Resolve the current project context.
+ *
+ * Priority for project root:
+ *   1. CODEX_PROJECT_PATH env var (explicit manual override)
+ *   2. CLAUDE_PROJECT_DIR env var — set by Claude Code itself on every spawned MCP
+ *      server (project-scoped or user/global-scoped alike) to the active session's
+ *      project root. This is what makes a single global mcpServers entry (registered
+ *      once, used across every project) resolve to the right vault per project instead
+ *      of needing a CODEX_PROJECT_PATH hardcoded per project.
+ *   3. Git root detected from CWD
+ *   4. CWD as fallback (non-git directories)
+ *
+ * Vault location: $BK_HOME/vaults/{project-name}/
+ *   BK_HOME defaults to ~/.bk-agent/ — the unified platform infrastructure dir.
+ *   Override with BK_HOME env var (e.g. for server deployments or rename).
+ */
+export declare function resolveProject(): Promise<ProjectContext>;
+/**
+ * Find a vault note by title (fuzzy filename match) or by relative path within the vault.
+ */
+export declare function findNote(vaultPath: string, pathOrTitle: string): Promise<string>;
+//# sourceMappingURL=project.d.ts.map

package/dist/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,cAAc;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,cAAc,CAAC,CAwB9D;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAwBtF"}

package/dist/project.js

@@ -0,0 +1,88 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { execSync } from 'node:child_process';
+import { initBkHome, bkPaths } from '@backendkit-labs/infra';
+/**
+ * Resolve the current project context.
+ *
+ * Priority for project root:
+ *   1. CODEX_PROJECT_PATH env var (explicit manual override)
+ *   2. CLAUDE_PROJECT_DIR env var — set by Claude Code itself on every spawned MCP
+ *      server (project-scoped or user/global-scoped alike) to the active session's
+ *      project root. This is what makes a single global mcpServers entry (registered
+ *      once, used across every project) resolve to the right vault per project instead
+ *      of needing a CODEX_PROJECT_PATH hardcoded per project.
+ *   3. Git root detected from CWD
+ *   4. CWD as fallback (non-git directories)
+ *
+ * Vault location: $BK_HOME/vaults/{project-name}/
+ *   BK_HOME defaults to ~/.bk-agent/ — the unified platform infrastructure dir.
+ *   Override with BK_HOME env var (e.g. for server deployments or rename).
+ */
+export async function resolveProject() {
+    const startPath = process.env.CODEX_PROJECT_PATH ?? process.env.CLAUDE_PROJECT_DIR ?? process.cwd();
+    let projectRoot;
+    let projectName;
+    try {
+        const gitRoot = execSync('git rev-parse --show-toplevel', {
+            cwd: startPath,
+            encoding: 'utf-8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        }).trim();
+        projectRoot = gitRoot;
+        projectName = path.basename(gitRoot);
+    }
+    catch {
+        projectRoot = startPath;
+        projectName = path.basename(startPath);
+    }
+    await initBkHome();
+    const vaultPath = bkPaths.vault(projectName);
+    await fs.mkdir(vaultPath, { recursive: true });
+    return { projectName, projectRoot, vaultPath };
+}
+/**
+ * Find a vault note by title (fuzzy filename match) or by relative path within the vault.
+ */
+export async function findNote(vaultPath, pathOrTitle) {
+    // Treat as path if it looks like one
+    if (pathOrTitle.includes('/') || pathOrTitle.includes('\\') || pathOrTitle.endsWith('.md')) {
+        const resolved = path.isAbsolute(pathOrTitle)
+            ? pathOrTitle
+            : path.join(vaultPath, pathOrTitle);
+        return await fs.readFile(resolved, 'utf-8');
+    }
+    // Search vault by filename containing the title
+    const searchTerm = pathOrTitle.toLowerCase().replace(/\s+/g, '-');
+    const found = await scanVaultForTitle(vaultPath, searchTerm);
+    if (found.length === 0) {
+        throw new Error(`Note not found in vault: "${pathOrTitle}"`);
+    }
+    // Return best match (most recently modified)
+    const stats = await Promise.all(found.map(async (f) => ({ path: f, mtime: (await fs.stat(f)).mtime.getTime() })));
+    stats.sort((a, b) => b.mtime - a.mtime);
+    return await fs.readFile(stats[0].path, 'utf-8');
+}
+async function scanVaultForTitle(dir, searchTerm) {
+    const results = [];
+    let entries;
+    try {
+        entries = await fs.readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        return results;
+    }
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory() && !entry.name.startsWith('.')) {
+            results.push(...await scanVaultForTitle(fullPath, searchTerm));
+        }
+        else if (entry.isFile() && entry.name.endsWith('.md')) {
+            if (entry.name.toLowerCase().includes(searchTerm)) {
+                results.push(fullPath);
+            }
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=project.js.map

package/dist/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAQ7D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc;IAChC,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAEpG,IAAI,WAAmB,CAAC;IACxB,IAAI,WAAmB,CAAC;IAExB,IAAI,CAAC;QACD,MAAM,OAAO,GAAG,QAAQ,CAAC,+BAA+B,EAAE;YACtD,GAAG,EAAE,SAAS;YACd,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;SACtC,CAAC,CAAC,IAAI,EAAE,CAAC;QACV,WAAW,GAAG,OAAO,CAAC;QACtB,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACL,WAAW,GAAG,SAAS,CAAC;QACxB,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC3C,CAAC;IAED,MAAM,UAAU,EAAE,CAAC;IACnB,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC7C,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE/C,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;AACnD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,SAAiB,EAAE,WAAmB;IACjE,qCAAqC;IACrC,IAAI,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACzF,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;YACzC,CAAC,CAAC,WAAW;YACb,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QACxC,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;IAED,gDAAgD;IAChD,MAAM,UAAU,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAClE,MAAM,KAAK,GAAG,MAAM,iBAAiB,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAE7D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,6BAA6B,WAAW,GAAG,CAAC,CAAC;IACjE,CAAC;IAED,6CAA6C;IAC7C,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAC3B,KAAK,CAAC,GAAG,CAAC,KAAK,EAAC,CAAC,EAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CACjF,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAExC,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACrD,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,GAAW,EAAE,UAAkB;IAC5D,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,OAAiB,CAAC;IAEtB,IAAI,CAAC;QACD,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,OAAO,CAAC;IACnB,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACrD,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,iBAAiB,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC;QACnE,CAAC;aAAM,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACtD,IAAI,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;gBAChD,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC3B,CAAC;QACL,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC"}

package/dist/providers/anthropic-adapter.d.ts

@@ -1,4 +1,4 @@
-import type { CuratorLLMProvider } from './types.js';
+import type { CuratorLLMProvider, CompleteOptions } from './types.js';
 export interface AnthropicAdapterOptions {
     apiKey: string;
     model?: string;
@@ -9,6 +9,6 @@ export declare class AnthropicAdapter implements CuratorLLMProvider {
     private readonly model;
     private readonly maxTokens;
     constructor(opts: AnthropicAdapterOptions);
-    complete(systemPrompt: string, userMessage: string): Promise<string>;
+    complete(systemPrompt: string, userMessage: string, opts?: CompleteOptions): Promise<string>;
 }
 //# sourceMappingURL=anthropic-adapter.d.ts.map

package/dist/providers/anthropic-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"anthropic-adapter.d.ts","sourceRoot":"","sources":["../../src/providers/anthropic-adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,WAAW,uBAAuB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,gBAAiB,YAAW,kBAAkB;IACvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,IAAI,EAAE,uBAAuB;IAMnC,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAU7E"}
+{"version":3,"file":"anthropic-adapter.d.ts","sourceRoot":"","sources":["../../src/providers/anthropic-adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEtE,MAAM,WAAW,uBAAuB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,gBAAiB,YAAW,kBAAkB;IACvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,IAAI,EAAE,uBAAuB;IAMnC,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,MAAM,CAAC;CAWzG"}

package/dist/providers/anthropic-adapter.js

@@ -1,20 +1,15 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AnthropicAdapter = void 0;
-const sdk_1 = __importDefault(require("@anthropic-ai/sdk"));
-class AnthropicAdapter {
+import Anthropic from '@anthropic-ai/sdk';
+export class AnthropicAdapter {
     client;
     model;
     maxTokens;
     constructor(opts) {
-        this.client = new sdk_1.default({ apiKey: opts.apiKey });
-        this.model = opts.model ?? 'claude-opus-4-8';
+        this.client = new Anthropic({ apiKey: opts.apiKey });
+        this.model = opts.model ?? 'claude-sonnet-4-6';
         this.maxTokens = opts.maxTokens ?? 16384;
     }
-    async complete(systemPrompt, userMessage) {
+    async complete(systemPrompt, userMessage, opts = {}) {
+        const json = opts.json !== false;
         const response = await this.client.messages.create({
             model: this.model,
             max_tokens: this.maxTokens,
@@ -22,8 +17,7 @@ class AnthropicAdapter {
             messages: [{ role: 'user', content: userMessage }],
         });
         const block = response.content[0];
-        return block?.type === 'text' ? block.text : '{}';
+        return block?.type === 'text' ? block.text : (json ? '{}' : '');
     }
 }
-exports.AnthropicAdapter = AnthropicAdapter;
 //# sourceMappingURL=anthropic-adapter.js.map

package/dist/providers/anthropic-adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"anthropic-adapter.js","sourceRoot":"","sources":["../../src/providers/anthropic-adapter.ts"],"names":[],"mappings":";;;;;;AAAA,4DAA0C;AAS1C,MAAa,gBAAgB;IACR,MAAM,CAAY;IAClB,KAAK,CAAS;IACd,SAAS,CAAS;IAEnC,YAAY,IAA6B;QACrC,IAAI,CAAC,MAAM,GAAM,IAAI,aAAS,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACxD,IAAI,CAAC,KAAK,GAAO,IAAI,CAAC,KAAK,IAAQ,iBAAiB,CAAC;QACrD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,YAAoB,EAAE,WAAmB;QACpD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;YAC/C,KAAK,EAAO,IAAI,CAAC,KAAK;YACtB,UAAU,EAAE,IAAI,CAAC,SAAS;YAC1B,MAAM,EAAM,YAAY;YACxB,QAAQ,EAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;SACvD,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAClC,OAAO,KAAK,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IACtD,CAAC;CACJ;AArBD,4CAqBC"}
+{"version":3,"file":"anthropic-adapter.js","sourceRoot":"","sources":["../../src/providers/anthropic-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAS1C,MAAM,OAAO,gBAAgB;IACR,MAAM,CAAY;IAClB,KAAK,CAAS;IACd,SAAS,CAAS;IAEnC,YAAY,IAA6B;QACrC,IAAI,CAAC,MAAM,GAAM,IAAI,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACxD,IAAI,CAAC,KAAK,GAAO,IAAI,CAAC,KAAK,IAAQ,mBAAmB,CAAC;QACvD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,YAAoB,EAAE,WAAmB,EAAE,OAAwB,EAAE;QAChF,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC;QACjC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;YAC/C,KAAK,EAAO,IAAI,CAAC,KAAK;YACtB,UAAU,EAAE,IAAI,CAAC,SAAS;YAC1B,MAAM,EAAM,YAAY;YACxB,QAAQ,EAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;SACvD,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAClC,OAAO,KAAK,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACpE,CAAC;CACJ"}

package/dist/providers/index.d.ts

@@ -10,5 +10,5 @@ export interface ProviderConfig {
     baseUrl?: string;
     maxTokens?: number;
 }
-export declare function createProvider(cfg?: Partial<ProviderConfig>): CuratorLLMProvider;
+export declare function createProvider(cfg: ProviderConfig): CuratorLLMProvider;
 //# sourceMappingURL=index.d.ts.map

package/dist/providers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,OAAO,EAAE,aAAa,EAAE,MAAS,qBAAqB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,WAAW,CAAC;AAE1E,MAAM,WAAW,cAAc;IAC3B,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AASD,wBAAgB,cAAc,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAahF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,OAAO,EAAE,aAAa,EAAE,MAAS,qBAAqB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,WAAW,CAAC;AAE1E,MAAM,WAAW,cAAc;IAC3B,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AASD,wBAAgB,cAAc,CAAC,GAAG,EAAE,cAAc,GAAG,kBAAkB,CAYtE"}

package/dist/providers/index.js

@@ -1,29 +1,22 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AnthropicAdapter = exports.OpenAIAdapter = void 0;
-exports.createProvider = createProvider;
-const openai_adapter_js_1 = require("./openai-adapter.js");
-const anthropic_adapter_js_1 = require("./anthropic-adapter.js");
-var openai_adapter_js_2 = require("./openai-adapter.js");
-Object.defineProperty(exports, "OpenAIAdapter", { enumerable: true, get: function () { return openai_adapter_js_2.OpenAIAdapter; } });
-var anthropic_adapter_js_2 = require("./anthropic-adapter.js");
-Object.defineProperty(exports, "AnthropicAdapter", { enumerable: true, get: function () { return anthropic_adapter_js_2.AnthropicAdapter; } });
+import { OpenAIAdapter } from './openai-adapter.js';
+import { AnthropicAdapter } from './anthropic-adapter.js';
+export { OpenAIAdapter } from './openai-adapter.js';
+export { AnthropicAdapter } from './anthropic-adapter.js';
 const DEFAULTS = {
     deepseek: { model: 'deepseek-reasoner', baseUrl: 'https://api.deepseek.com/v1' },
     openai: { model: 'o3-mini' },
     ollama: { model: 'qwen2.5-coder:7b', baseUrl: 'http://localhost:11434/v1' },
-    anthropic: { model: 'claude-opus-4-8' },
+    anthropic: { model: 'claude-sonnet-4-6' },
 };
-function createProvider(cfg) {
-    const provider = (cfg?.provider ?? process.env.CURATOR_PROVIDER ?? 'deepseek');
-    const apiKey = cfg?.apiKey ?? process.env.CURATOR_API_KEY ?? '';
-    const model = cfg?.model ?? process.env.CURATOR_MODEL ?? DEFAULTS[provider].model;
-    const baseUrl = cfg?.baseUrl ?? process.env.CURATOR_BASE_URL ?? DEFAULTS[provider].baseUrl;
-    if (!apiKey)
-        throw new Error('CURATOR_API_KEY env var is required');
+export function createProvider(cfg) {
+    const provider = cfg.provider ?? 'deepseek';
+    const model = cfg.model ?? DEFAULTS[provider].model;
+    const baseUrl = cfg.baseUrl ?? DEFAULTS[provider].baseUrl;
+    if (!cfg.apiKey)
+        throw new Error('API key is required');
     if (provider === 'anthropic') {
-        return new anthropic_adapter_js_1.AnthropicAdapter({ apiKey, model, maxTokens: cfg?.maxTokens });
+        return new AnthropicAdapter({ apiKey: cfg.apiKey, model, maxTokens: cfg.maxTokens });
     }
-    return new openai_adapter_js_1.OpenAIAdapter({ apiKey, model, baseUrl, maxTokens: cfg?.maxTokens });
+    return new OpenAIAdapter({ apiKey: cfg.apiKey, model, baseUrl, maxTokens: cfg.maxTokens });
 }
 //# sourceMappingURL=index.js.map

package/dist/providers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":";;;AAyBA,wCAaC;AAtCD,2DAAuD;AACvD,iEAA0D;AAG1D,yDAAuD;AAA9C,kHAAA,aAAa,OAAA;AACtB,+DAA0D;AAAjD,wHAAA,gBAAgB,OAAA;AAazB,MAAM,QAAQ,GAA8D;IACxE,QAAQ,EAAG,EAAE,KAAK,EAAE,mBAAmB,EAAE,OAAO,EAAE,6BAA6B,EAAE;IACjF,MAAM,EAAK,EAAE,KAAK,EAAE,SAAS,EAAE;IAC/B,MAAM,EAAK,EAAE,KAAK,EAAE,kBAAkB,EAAG,OAAO,EAAE,2BAA2B,EAAE;IAC/E,SAAS,EAAE,EAAE,KAAK,EAAE,iBAAiB,EAAE;CAC1C,CAAC;AAEF,SAAgB,cAAc,CAAC,GAA6B;IACxD,MAAM,QAAQ,GAAG,CAAC,GAAG,EAAE,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,UAAU,CAAiB,CAAC;IAC/F,MAAM,MAAM,GAAK,GAAG,EAAE,MAAM,IAAM,OAAO,CAAC,GAAG,CAAC,eAAe,IAAM,EAAE,CAAC;IACtE,MAAM,KAAK,GAAM,GAAG,EAAE,KAAK,IAAO,OAAO,CAAC,GAAG,CAAC,aAAa,IAAS,QAAQ,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC;IAC7F,MAAM,OAAO,GAAI,GAAG,EAAE,OAAO,IAAK,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;IAE/F,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IAEpE,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;QAC3B,OAAO,IAAI,uCAAgB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED,OAAO,IAAI,iCAAa,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;AACpF,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAS,qBAAqB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG1D,OAAO,EAAE,aAAa,EAAE,MAAS,qBAAqB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAa1D,MAAM,QAAQ,GAA8D;IACxE,QAAQ,EAAG,EAAE,KAAK,EAAE,mBAAmB,EAAE,OAAO,EAAE,6BAA6B,EAAE;IACjF,MAAM,EAAK,EAAE,KAAK,EAAE,SAAS,EAAE;IAC/B,MAAM,EAAK,EAAE,KAAK,EAAE,kBAAkB,EAAG,OAAO,EAAE,2BAA2B,EAAE;IAC/E,SAAS,EAAE,EAAE,KAAK,EAAE,mBAAmB,EAAE;CAC5C,CAAC;AAEF,MAAM,UAAU,cAAc,CAAC,GAAmB;IAC9C,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,IAAI,UAAU,CAAC;IAC5C,MAAM,KAAK,GAAM,GAAG,CAAC,KAAK,IAAO,QAAQ,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC;IAC1D,MAAM,OAAO,GAAI,GAAG,CAAC,OAAO,IAAK,QAAQ,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;IAE5D,IAAI,CAAC,GAAG,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IAExD,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;QAC3B,OAAO,IAAI,gBAAgB,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;IACzF,CAAC;IAED,OAAO,IAAI,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;AAC/F,CAAC"}

package/dist/providers/openai-adapter.d.ts

@@ -1,4 +1,4 @@
-import type { CuratorLLMProvider } from './types.js';
+import type { CuratorLLMProvider, CompleteOptions } from './types.js';
 export interface OpenAIAdapterOptions {
     apiKey: string;
     model: string;
@@ -11,6 +11,6 @@ export declare class OpenAIAdapter implements CuratorLLMProvider {
     private readonly maxTokens;
     private readonly isReasoner;
     constructor(opts: OpenAIAdapterOptions);
-    complete(systemPrompt: string, userMessage: string): Promise<string>;
+    complete(systemPrompt: string, userMessage: string, opts?: CompleteOptions): Promise<string>;
 }
 //# sourceMappingURL=openai-adapter.d.ts.map

package/dist/providers/openai-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openai-adapter.d.ts","sourceRoot":"","sources":["../../src/providers/openai-adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,WAAW,oBAAoB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,aAAc,YAAW,kBAAkB;IACpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;gBAEzB,IAAI,EAAE,oBAAoB;IAUhC,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAa7E"}
+{"version":3,"file":"openai-adapter.d.ts","sourceRoot":"","sources":["../../src/providers/openai-adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEtE,MAAM,WAAW,oBAAoB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,aAAc,YAAW,kBAAkB;IACpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;gBAEzB,IAAI,EAAE,oBAAoB;IAUhC,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,MAAM,CAAC;CAczG"}

package/dist/providers/openai-adapter.js

@@ -1,17 +1,11 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.OpenAIAdapter = void 0;
-const openai_1 = __importDefault(require("openai"));
-class OpenAIAdapter {
+import OpenAI from 'openai';
+export class OpenAIAdapter {
     client;
     model;
     maxTokens;
     isReasoner;
     constructor(opts) {
-        this.client = new openai_1.default({
+        this.client = new OpenAI({
             apiKey: opts.apiKey,
             baseURL: opts.baseUrl ?? 'https://api.deepseek.com/v1',
         });
@@ -19,19 +13,19 @@ class OpenAIAdapter {
         this.maxTokens = opts.maxTokens ?? 16384;
         this.isReasoner = /reasoner|^o\d/.test(opts.model);
     }
-    async complete(systemPrompt, userMessage) {
+    async complete(systemPrompt, userMessage, opts = {}) {
+        const json = opts.json !== false;
         const completion = await this.client.chat.completions.create({
             model: this.model,
             max_tokens: this.maxTokens,
-            response_format: { type: 'json_object' },
+            ...(json ? { response_format: { type: 'json_object' } } : {}),
             ...(this.isReasoner ? {} : { temperature: 0.2 }),
             messages: [
                 { role: 'system', content: systemPrompt },
                 { role: 'user', content: userMessage },
             ],
         });
-        return completion.choices[0]?.message?.content ?? '{}';
+        return completion.choices[0]?.message?.content ?? (json ? '{}' : '');
     }
 }
-exports.OpenAIAdapter = OpenAIAdapter;
 //# sourceMappingURL=openai-adapter.js.map

package/dist/providers/openai-adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"openai-adapter.js","sourceRoot":"","sources":["../../src/providers/openai-adapter.ts"],"names":[],"mappings":";;;;;;AAAA,oDAA4B;AAU5B,MAAa,aAAa;IACL,MAAM,CAAS;IACf,KAAK,CAAS;IACd,SAAS,CAAS;IAClB,UAAU,CAAU;IAErC,YAAY,IAA0B;QAClC,IAAI,CAAC,MAAM,GAAG,IAAI,gBAAM,CAAC;YACrB,MAAM,EAAG,IAAI,CAAC,MAAM;YACpB,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,6BAA6B;SACzD,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,GAAO,IAAI,CAAC,KAAK,CAAC;QAC5B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC;QACzC,IAAI,CAAC,UAAU,GAAG,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,YAAoB,EAAE,WAAmB;QACpD,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;YACzD,KAAK,EAAY,IAAI,CAAC,KAAK;YAC3B,UAAU,EAAO,IAAI,CAAC,SAAS;YAC/B,eAAe,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE;YACxC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC;YAChD,QAAQ,EAAE;gBACN,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE;gBACzC,EAAE,IAAI,EAAE,MAAM,EAAI,OAAO,EAAE,WAAW,EAAE;aAC3C;SACJ,CAAC,CAAC;QACH,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,IAAI,IAAI,CAAC;IAC3D,CAAC;CACJ;AA7BD,sCA6BC"}
+{"version":3,"file":"openai-adapter.js","sourceRoot":"","sources":["../../src/providers/openai-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAU5B,MAAM,OAAO,aAAa;IACL,MAAM,CAAS;IACf,KAAK,CAAS;IACd,SAAS,CAAS;IAClB,UAAU,CAAU;IAErC,YAAY,IAA0B;QAClC,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC;YACrB,MAAM,EAAG,IAAI,CAAC,MAAM;YACpB,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,6BAA6B;SACzD,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,GAAO,IAAI,CAAC,KAAK,CAAC;QAC5B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC;QACzC,IAAI,CAAC,UAAU,GAAG,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,YAAoB,EAAE,WAAmB,EAAE,OAAwB,EAAE;QAChF,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC;QACjC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;YACzD,KAAK,EAAY,IAAI,CAAC,KAAK;YAC3B,UAAU,EAAO,IAAI,CAAC,SAAS;YAC/B,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,EAAE,IAAI,EAAE,aAAsB,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtE,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC;YAChD,QAAQ,EAAE;gBACN,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE;gBACzC,EAAE,IAAI,EAAE,MAAM,EAAI,OAAO,EAAE,WAAW,EAAE;aAC3C;SACJ,CAAC,CAAC;QACH,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACzE,CAAC;CACJ"}

package/dist/providers/types.d.ts

@@ -1,4 +1,11 @@
+export interface CompleteOptions {
+    /**
+     * Force structured JSON output (default: true).
+     * Set to false for free-form text/markdown responses (e.g. synthesis).
+     */
+    json?: boolean;
+}
 export interface CuratorLLMProvider {
-    complete(systemPrompt: string, userMessage: string): Promise<string>;
+    complete(systemPrompt: string, userMessage: string, opts?: CompleteOptions): Promise<string>;
 }
 //# sourceMappingURL=types.d.ts.map