notsleep 1.0.0

package/dist/modelsdev.js

@@ -0,0 +1,265 @@
+"use strict";
+// ============================================================
+// NotSleep - Live model metadata (context window + pricing)
+// ============================================================
+//
+// The agent's context-usage ratio is (current tokens ÷ window limit). The
+// numerator is already the REAL prompt_tokens the API reports. This module
+// makes the DENOMINATOR live too, instead of a static hand-maintained table,
+// via three layered sources (most authoritative first):
+//
+//   1. models.dev  — the models.dev/api.json catalog (what OpenCode uses):
+//                    accurate context/output limits + pricing for ~all
+//                    providers & models. Fetched once, cached to disk.
+//   2. /models      — a provider's own OpenAI-style `GET /models` endpoint,
+//                    for custom proxies / models the catalog doesn't list.
+//   3. static table — the offline fallback baked into cost.ts.
+//
+// Plus a reactive safety net: parseContextOverflow() reads the true maximum
+// out of a provider's "context length exceeded" error so the agent can
+// self-correct even when every source above was wrong.
+//
+// Networking is best-effort and never throws: offline runs silently fall
+// back to the static table. The parsed catalog is held in a module singleton
+// that config.ts reads SYNCHRONOUSLY — it stays empty until ensureModelCatalog()
+// is called, so unit tests (which never call it) remain fully offline/static.
+// ============================================================
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setCatalogForTest = setCatalogForTest;
+exports.ensureModelCatalog = ensureModelCatalog;
+exports.lookupModelInfo = lookupModelInfo;
+exports.liveContextLimit = liveContextLimit;
+exports.livePrice = livePrice;
+exports.fetchEndpointContextLimit = fetchEndpointContextLimit;
+exports.parseContextOverflow = parseContextOverflow;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const API_URL = 'https://models.dev/api.json';
+const CACHE_PATH = path.join(os.homedir(), '.notsleep', 'models.dev.json');
+const TTL_MS = 24 * 60 * 60 * 1000; // refresh at most once a day
+const DEFAULT_FETCH_TIMEOUT_MS = 8000;
+/**
+ * Map a NotSleep registry provider name to its models.dev provider id where
+ * they differ. Providers not on models.dev (together, fireworks, ollama,
+ * limitrouter, ...) simply miss and fall through to the next source.
+ */
+const PROVIDER_ALIAS = {
+    gemini: 'google',
+};
+let memoryCatalog = null;
+/** Test / advanced hook: inject or clear the in-memory catalog directly. */
+function setCatalogForTest(catalog) {
+    memoryCatalog = catalog;
+}
+function readDiskCache() {
+    try {
+        const obj = JSON.parse(fs.readFileSync(CACHE_PATH, 'utf-8'));
+        if (obj && typeof obj.fetchedAt === 'number' && obj.catalog)
+            return obj;
+    }
+    catch {
+        /* no/invalid cache */
+    }
+    return null;
+}
+function writeDiskCache(catalog) {
+    try {
+        fs.mkdirSync(path.dirname(CACHE_PATH), { recursive: true });
+        fs.writeFileSync(CACHE_PATH, JSON.stringify({ fetchedAt: Date.now(), catalog }));
+    }
+    catch {
+        /* cache is best-effort */
+    }
+}
+/**
+ * Ensure the model catalog is loaded into memory, refreshing from models.dev
+ * when the disk cache is missing or older than the TTL. Never throws: on any
+ * network/parse failure it falls back to a stale cache, or leaves the catalog
+ * empty (callers then use the static table). Returns the catalog or null.
+ */
+async function ensureModelCatalog(opts) {
+    if (memoryCatalog && !opts?.force)
+        return memoryCatalog;
+    const disk = readDiskCache();
+    const fresh = disk ? Date.now() - disk.fetchedAt < TTL_MS : false;
+    if (disk && fresh && !opts?.force) {
+        memoryCatalog = disk.catalog;
+        return memoryCatalog;
+    }
+    // Opt-out: never touch the network. Use a (possibly stale) disk cache if we
+    // have one, otherwise leave the catalog empty (callers use the static table).
+    const optOut = /^(1|true|yes)$/i.test(process.env.NOTSLEEP_NO_MODEL_SYNC || '');
+    if (optOut && !opts?.force) {
+        if (disk) {
+            memoryCatalog = disk.catalog;
+            return memoryCatalog;
+        }
+        return null;
+    }
+    // Cache missing or stale → try the network.
+    try {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), opts?.timeoutMs ?? DEFAULT_FETCH_TIMEOUT_MS);
+        const res = await fetch(API_URL, { signal: controller.signal });
+        clearTimeout(timer);
+        if (res.ok) {
+            const catalog = (await res.json());
+            memoryCatalog = catalog;
+            writeDiskCache(catalog);
+            opts?.log?.(`Synced model catalog from models.dev (${Object.keys(catalog).length} providers).`);
+            return memoryCatalog;
+        }
+        opts?.log?.(`models.dev returned HTTP ${res.status}; using ${disk ? 'cached' : 'static'} model limits.`);
+    }
+    catch (err) {
+        opts?.log?.(`models.dev sync failed (${err?.message || err}); using ${disk ? 'cached' : 'static'} model limits.`);
+    }
+    // Fall back to a stale cache if we have one.
+    if (disk) {
+        memoryCatalog = disk.catalog;
+        return memoryCatalog;
+    }
+    return null;
+}
+/**
+ * Look up a model in the in-memory catalog. Tries the provider-scoped entry
+ * first (with alias mapping), then a global scan by exact id, then a loose
+ * match (key ends with "/modelId", or the entry's own `id` matches) to handle
+ * aggregators like OpenRouter that key models as "vendor/model".
+ */
+function lookupModelInfo(providerName, modelId) {
+    if (!memoryCatalog || !modelId)
+        return null;
+    const pid = PROVIDER_ALIAS[providerName] ?? providerName;
+    const scoped = memoryCatalog[pid]?.models?.[modelId];
+    if (scoped)
+        return scoped;
+    // Exact id match anywhere.
+    for (const p of Object.keys(memoryCatalog)) {
+        const hit = memoryCatalog[p]?.models?.[modelId];
+        if (hit)
+            return hit;
+    }
+    // Loose match (last resort).
+    for (const p of Object.keys(memoryCatalog)) {
+        const models = memoryCatalog[p]?.models;
+        if (!models)
+            continue;
+        for (const key of Object.keys(models)) {
+            if (key.endsWith('/' + modelId) || models[key]?.id === modelId)
+                return models[key];
+        }
+    }
+    return null;
+}
+/** Live max context window for a model, or undefined if unknown. */
+function liveContextLimit(providerName, modelId) {
+    const ctx = lookupModelInfo(providerName, modelId)?.limit?.context;
+    return typeof ctx === 'number' && ctx > 0 ? ctx : undefined;
+}
+/** Live per-1M pricing for a model, or undefined if unknown. */
+function livePrice(providerName, modelId) {
+    const cost = lookupModelInfo(providerName, modelId)?.cost;
+    if (cost && typeof cost.input === 'number' && typeof cost.output === 'number') {
+        return { input: cost.input, output: cost.output };
+    }
+    return undefined;
+}
+/**
+ * Query a provider's own OpenAI-style `GET {baseURL}/models` for a model's
+ * context window. Handles the common field spellings (OpenRouter's
+ * `context_length` / `top_provider.context_length`, etc). Best-effort:
+ * returns undefined on any failure. Used as a fallback for custom proxies
+ * and models that models.dev doesn't list.
+ */
+async function fetchEndpointContextLimit(baseURL, apiKey, modelId, timeoutMs = 6000) {
+    if (!baseURL || !modelId)
+        return undefined;
+    const url = baseURL.replace(/\/+$/, '') + '/models';
+    try {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        const res = await fetch(url, {
+            headers: apiKey ? { Authorization: `Bearer ${apiKey}` } : {},
+            signal: controller.signal,
+        });
+        clearTimeout(timer);
+        if (!res.ok)
+            return undefined;
+        const body = await res.json();
+        const list = Array.isArray(body?.data) ? body.data : Array.isArray(body) ? body : [];
+        const m = list.find((x) => x?.id === modelId || x?.name === modelId);
+        if (!m)
+            return undefined;
+        const ctx = m.context_length ??
+            m.context_window ??
+            m.max_context_length ??
+            m?.top_provider?.context_length ??
+            m?.limit?.context;
+        return typeof ctx === 'number' && ctx > 0 ? ctx : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Extract the true maximum context length out of a provider's "context length
+ * exceeded" error message, so the agent can self-correct. Returns the model's
+ * max in tokens, or undefined if the message isn't a context-overflow error.
+ *
+ * Handles e.g.:
+ *   OpenAI:    "maximum context length is 128000 tokens. However, your
+ *               messages resulted in 130512 tokens"
+ *   Anthropic: "prompt is too long: 215000 tokens > 200000 maximum"
+ */
+function parseContextOverflow(message) {
+    if (!message)
+        return undefined;
+    const low = message.toLowerCase();
+    const isOverflow = /context length|context window|context_length_exceeded|maximum context|prompt is too long|too many tokens|reduce the length/.test(low);
+    if (!isOverflow)
+        return undefined;
+    // Collect token-sized numbers (>= 1000), commas allowed.
+    const nums = (message.match(/\d[\d,]{3,}/g) || [])
+        .map((s) => parseInt(s.replace(/,/g, ''), 10))
+        .filter((n) => Number.isFinite(n) && n >= 1000);
+    if (nums.length === 0)
+        return undefined;
+    // In "max is X but you sent Y", the limit is the smaller value (X < Y).
+    return Math.min(...nums);
+}
+//# sourceMappingURL=modelsdev.js.map

package/dist/modelsdev.js.map

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

package/dist/parallel.d.ts

@@ -0,0 +1,54 @@
+import { WorktreeManager } from './worktree';
+import { Logger } from './logger';
+export interface ParallelTask {
+    id: string;
+    description: string;
+}
+export interface TaskRunContext {
+    task: ParallelTask;
+    /** The isolated worktree directory this task must run in. */
+    workdir: string;
+    /** The branch checked out in that worktree. */
+    branch: string;
+}
+/** Executes a single task inside its worktree. Should resolve on success. */
+export type TaskRunner = (ctx: TaskRunContext) => Promise<void>;
+export interface ParallelOptions {
+    /** Max tasks running at once. */
+    concurrency: number;
+    /** Merge each task's branch back into the base branch when it succeeds. */
+    merge?: boolean;
+    /** Delete a task's worktree after it finishes (branch is kept). Default true. */
+    cleanup?: boolean;
+}
+export interface ParallelTaskOutcome {
+    task: ParallelTask;
+    branch: string;
+    ok: boolean;
+    merged: boolean;
+    conflict: boolean;
+    error?: string;
+    note?: string;
+}
+export declare class ParallelRunner {
+    private readonly repoRoot;
+    private readonly logger;
+    private readonly wm;
+    constructor(repoRoot: string, logger: Logger, wm?: WorktreeManager);
+    /**
+     * Run all tasks with bounded concurrency, each in its own worktree.
+     * Returns one outcome per task (input order preserved).
+     */
+    run(tasks: ParallelTask[], taskRunner: TaskRunner, options: ParallelOptions): Promise<ParallelTaskOutcome[]>;
+}
+/**
+ * Production task runner: launches the notsleep one-shot CLI as a child
+ * process, with cwd set to the task's worktree. This gives OS-level isolation
+ * (separate process, separate cwd) so parallel agents share nothing mutable.
+ *
+ * @param nodeBin   Path to node (usually process.execPath).
+ * @param cliEntry  Path to the built CLI entry (dist/index.js).
+ * @param extraArgs Extra CLI args to forward (e.g. ['--max-iterations','30']).
+ */
+export declare function spawnAgentInWorktree(nodeBin: string, cliEntry: string, extraArgs: string[], logger: Logger): TaskRunner;
+//# sourceMappingURL=parallel.d.ts.map

package/dist/parallel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallel.d.ts","sourceRoot":"","sources":["../src/parallel.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,YAAY,CAAC;IACnB,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,6EAA6E;AAC7E,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEhE,MAAM,WAAW,eAAe;IAC9B,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,iFAAiF;IACjF,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAkB;gBAEzB,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,eAAe;IAMlE;;;OAGG;IACG,GAAG,CACP,KAAK,EAAE,YAAY,EAAE,EACrB,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,mBAAmB,EAAE,CAAC;CA4FlC;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EAAE,EACnB,MAAM,EAAE,MAAM,GACb,UAAU,CAmBZ"}

package/dist/parallel.js

@@ -0,0 +1,139 @@
+"use strict";
+// ============================================================
+// NotSleep - Parallel task runner
+// ============================================================
+//
+// Runs multiple tasks CONCURRENTLY and SAFELY. Each task gets its own git
+// worktree (isolated working directory + branch), so agents editing files at
+// the same time can never clobber each other. After a task finishes, its
+// branch is optionally merged back into the base branch; merge conflicts are
+// aborted and the branch is kept for manual review rather than forcing a
+// broken merge.
+//
+// The actual per-task execution is injected as `taskRunner`, which keeps this
+// orchestrator fully unit-testable without spawning real agents or hitting the
+// network. The production runner (spawnAgentInWorktree) launches the existing
+// one-shot CLI as a child process with cwd set to the task's worktree.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ParallelRunner = void 0;
+exports.spawnAgentInWorktree = spawnAgentInWorktree;
+const child_process_1 = require("child_process");
+const worktree_1 = require("./worktree");
+const pool_1 = require("./pool");
+class ParallelRunner {
+    repoRoot;
+    logger;
+    wm;
+    constructor(repoRoot, logger, wm) {
+        this.repoRoot = repoRoot;
+        this.logger = logger;
+        this.wm = wm ?? new worktree_1.WorktreeManager(repoRoot);
+    }
+    /**
+     * Run all tasks with bounded concurrency, each in its own worktree.
+     * Returns one outcome per task (input order preserved).
+     */
+    async run(tasks, taskRunner, options) {
+        await this.wm.assertGitRepo();
+        const cleanup = options.cleanup !== false; // default true
+        const merge = options.merge === true;
+        this.logger.info(`Parallel run: ${tasks.length} task(s), concurrency ${options.concurrency}, ` +
+            `merge=${merge}, cleanup=${cleanup}.`);
+        const outcomes = [];
+        const poolResults = await (0, pool_1.runPool)(tasks, options.concurrency, async (task) => {
+            const wt = await this.wm.add(task.id);
+            this.logger.info(`[${task.id}] worktree ready at ${wt.dir} (branch ${wt.branch}).`);
+            const outcome = {
+                task,
+                branch: wt.branch,
+                ok: false,
+                merged: false,
+                conflict: false,
+            };
+            try {
+                await taskRunner({ task, workdir: wt.dir, branch: wt.branch });
+                outcome.ok = true;
+                this.logger.info(`[${task.id}] finished.`);
+            }
+            catch (err) {
+                outcome.ok = false;
+                outcome.error = err?.message || String(err);
+                this.logger.error(`[${task.id}] failed: ${outcome.error}`);
+            }
+            // Merge only successful branches. A failed task's partial work stays on
+            // its branch for inspection and is never merged automatically.
+            if (outcome.ok && merge) {
+                try {
+                    const m = await this.wm.mergeBranch(task.id);
+                    outcome.merged = m.merged;
+                    outcome.conflict = m.conflict;
+                    outcome.note = m.message;
+                    this.logger[m.conflict ? 'warn' : 'info'](`[${task.id}] ${m.message}`);
+                }
+                catch (err) {
+                    outcome.note = `merge error: ${err?.message || String(err)}`;
+                    this.logger.error(`[${task.id}] ${outcome.note}`);
+                }
+            }
+            // Remove the worktree directory. Keep the branch either way so commits
+            // are recoverable (successful-but-unmerged, or failed for review).
+            if (cleanup) {
+                await this.wm.remove(task.id, false).catch((e) => this.logger.warn(`[${task.id}] worktree cleanup failed: ${e.message}`));
+            }
+            return outcome;
+        }, (settled) => {
+            // Pool never throws, but a worker that somehow rejected still yields a
+            // PoolResult; surface a minimal outcome so counts stay correct.
+            if (!settled.ok && !settled.value) {
+                outcomes[settled.index] = {
+                    task: settled.item,
+                    branch: '(none)',
+                    ok: false,
+                    merged: false,
+                    conflict: false,
+                    error: settled.error?.message || 'unknown error',
+                };
+            }
+        });
+        for (const r of poolResults) {
+            outcomes[r.index] = r.value ?? outcomes[r.index];
+        }
+        const ok = outcomes.filter((o) => o && o.ok).length;
+        const merged = outcomes.filter((o) => o && o.merged).length;
+        const conflicts = outcomes.filter((o) => o && o.conflict).length;
+        this.logger.info(`Parallel run complete: ${ok}/${tasks.length} ok, ${merged} merged, ${conflicts} conflict(s).`);
+        return outcomes;
+    }
+}
+exports.ParallelRunner = ParallelRunner;
+/**
+ * Production task runner: launches the notsleep one-shot CLI as a child
+ * process, with cwd set to the task's worktree. This gives OS-level isolation
+ * (separate process, separate cwd) so parallel agents share nothing mutable.
+ *
+ * @param nodeBin   Path to node (usually process.execPath).
+ * @param cliEntry  Path to the built CLI entry (dist/index.js).
+ * @param extraArgs Extra CLI args to forward (e.g. ['--max-iterations','30']).
+ */
+function spawnAgentInWorktree(nodeBin, cliEntry, extraArgs, logger) {
+    return (ctx) => new Promise((resolve, reject) => {
+        const args = [cliEntry, '--task-file', '-', ...extraArgs];
+        // We pass the task via a temp file rather than argv to avoid shell/quoting
+        // issues; but simplest portable approach: pass description as a single arg.
+        const child = (0, child_process_1.spawn)(nodeBin, [cliEntry, ctx.task.description, ...extraArgs], {
+            cwd: ctx.workdir,
+            stdio: 'inherit',
+            env: { ...process.env },
+        });
+        child.on('error', reject);
+        child.on('exit', (code) => {
+            if (code === 0)
+                resolve();
+            else
+                reject(new Error(`agent process exited with code ${code}`));
+        });
+        void args; // reserved for a future stdin-based task handoff
+        void logger;
+    });
+}
+//# sourceMappingURL=parallel.js.map

package/dist/parallel.js.map

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

package/dist/pool.d.ts

@@ -0,0 +1,17 @@
+export interface PoolResult<T, R> {
+    item: T;
+    index: number;
+    ok: boolean;
+    value?: R;
+    error?: Error;
+}
+/**
+ * Process `items` with a worker, capping in-flight work at `concurrency`.
+ *
+ * @param items       Work items.
+ * @param concurrency Max simultaneous workers (clamped to >= 1).
+ * @param worker      Async fn producing a result for an item.
+ * @param onSettled   Optional callback fired as each item finishes.
+ */
+export declare function runPool<T, R>(items: T[], concurrency: number, worker: (item: T, index: number) => Promise<R>, onSettled?: (result: PoolResult<T, R>) => void): Promise<PoolResult<T, R>[]>;
+//# sourceMappingURL=pool.d.ts.map

package/dist/pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../src/pool.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,UAAU,CAAC,CAAC,EAAE,CAAC;IAC9B,IAAI,EAAE,CAAC,CAAC;IACR,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE,CAAC,CAAC;IACV,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED;;;;;;;GAOG;AACH,wBAAsB,OAAO,CAAC,CAAC,EAAE,CAAC,EAChC,KAAK,EAAE,CAAC,EAAE,EACV,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EAC9C,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,IAAI,GAC7C,OAAO,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CA8B7B"}

package/dist/pool.js

@@ -0,0 +1,53 @@
+"use strict";
+// ============================================================
+// NotSleep - Bounded concurrency pool
+// ============================================================
+//
+// Runs async work over a list of items with at most `concurrency` running at
+// once. Never rejects: each item's outcome is captured as ok/err so one
+// failure can't sink the whole batch. Order of results matches input order.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runPool = runPool;
+/**
+ * Process `items` with a worker, capping in-flight work at `concurrency`.
+ *
+ * @param items       Work items.
+ * @param concurrency Max simultaneous workers (clamped to >= 1).
+ * @param worker      Async fn producing a result for an item.
+ * @param onSettled   Optional callback fired as each item finishes.
+ */
+async function runPool(items, concurrency, worker, onSettled) {
+    const limit = Math.max(1, Math.floor(concurrency) || 1);
+    const results = new Array(items.length);
+    let next = 0;
+    async function runWorkerLoop() {
+        while (true) {
+            const index = next++;
+            if (index >= items.length)
+                return;
+            const item = items[index];
+            let settled;
+            try {
+                const value = await worker(item, index);
+                settled = { item, index, ok: true, value };
+            }
+            catch (error) {
+                settled = { item, index, ok: false, error: error instanceof Error ? error : new Error(String(error)) };
+            }
+            results[index] = settled;
+            if (onSettled) {
+                try {
+                    onSettled(settled);
+                }
+                catch { /* callback errors never break the pool */ }
+            }
+        }
+    }
+    const workerCount = Math.min(limit, items.length);
+    const loops = [];
+    for (let i = 0; i < workerCount; i++)
+        loops.push(runWorkerLoop());
+    await Promise.all(loops);
+    return results;
+}
+//# sourceMappingURL=pool.js.map

package/dist/pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.js","sourceRoot":"","sources":["../src/pool.ts"],"names":[],"mappings":";AAAA,+DAA+D;AAC/D,sCAAsC;AACtC,+DAA+D;AAC/D,EAAE;AACF,6EAA6E;AAC7E,wEAAwE;AACxE,4EAA4E;;AAkB5E,0BAmCC;AA3CD;;;;;;;GAOG;AACI,KAAK,UAAU,OAAO,CAC3B,KAAU,EACV,WAAmB,EACnB,MAA8C,EAC9C,SAA8C;IAE9C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;IACxD,MAAM,OAAO,GAAuB,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5D,IAAI,IAAI,GAAG,CAAC,CAAC;IAEb,KAAK,UAAU,aAAa;QAC1B,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,KAAK,GAAG,IAAI,EAAE,CAAC;YACrB,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM;gBAAE,OAAO;YAClC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;YAC1B,IAAI,OAAyB,CAAC;YAC9B,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;gBACxC,OAAO,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;YAC7C,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACpB,OAAO,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YACzG,CAAC;YACD,OAAO,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC;YACzB,IAAI,SAAS,EAAE,CAAC;gBACd,IAAI,CAAC;oBAAC,SAAS,CAAC,OAAO,CAAC,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,0CAA0C,CAAC,CAAC;YAClF,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAClD,MAAM,KAAK,GAAoB,EAAE,CAAC;IAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,EAAE,CAAC,EAAE;QAAE,KAAK,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;IAClE,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAEzB,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/provider.d.ts

@@ -0,0 +1,60 @@
+import { AgentConfig, LLMResponse, Message, ToolDefinition } from './types';
+import { Logger } from './logger';
+/**
+ * Converts our ToolDefinition[] to provider-specific tool format.
+ * Handles retries with exponential backoff.
+ * Normalizes responses to a unified LLMResponse format.
+ *
+ * Supports two endpoints — primary (chat) and an optional cheaper small model
+ * (chatSmall) — which may be different providers entirely. Clients are built
+ * lazily and cached per (baseURL, apiKey), so a mixed setup (e.g. Anthropic
+ * primary + OpenAI small) works without extra wiring.
+ */
+export declare class LLMProvider {
+    private config;
+    private logger;
+    private readonly primary;
+    private readonly small?;
+    private openaiClients;
+    private anthropicClients;
+    constructor(config: AgentConfig, logger: Logger);
+    /** Build the primary endpoint from the resolved config blocks. */
+    private endpointFromConfig;
+    private getOpenAIClient;
+    private getAnthropicClient;
+    /**
+     * Send messages to the PRIMARY model and get a response.
+     * Automatically retries on transient errors with exponential backoff.
+     */
+    chat(messages: Message[], tools: ToolDefinition[], opts?: {
+        maxRetries?: number;
+        maxDelayMs?: number;
+    }): Promise<LLMResponse>;
+    /**
+     * Send messages to the SMALL model (if configured), else the primary. Used
+     * for the agent's own internal calls — context summarization and follow-up
+     * task generation — so they run on a cheaper model when one is set.
+     */
+    chatSmall(messages: Message[], tools: ToolDefinition[], opts?: {
+        maxRetries?: number;
+        maxDelayMs?: number;
+    }): Promise<LLMResponse>;
+    /** True when a distinct small model is configured. */
+    hasSmallModel(): boolean;
+    private callEndpoint;
+    private chatOpenAI;
+    private toOpenAIMessage;
+    private toOpenAITool;
+    private chatAnthropic;
+    private toAnthropicMessages;
+    private toAnthropicTool;
+    private isRetryableError;
+    private calculateBackoff;
+    /**
+     * Wrap common API errors with actionable, user-friendly messages so the
+     * operator can fix config issues without digging through raw HTTP bodies.
+     */
+    private enhanceError;
+    private sleep;
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAsB,cAAc,EAAE,MAAM,SAAS,CAAC;AAChG,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAclC;;;;;;;;;GASG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,MAAM,CAAS;IAEvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAW;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAW;IAElC,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,gBAAgB,CAAgC;gBAE5C,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM;IAe/C,kEAAkE;IAClE,OAAO,CAAC,kBAAkB;IAS1B,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,kBAAkB;IAU1B;;;OAGG;IACG,IAAI,CACR,QAAQ,EAAE,OAAO,EAAE,EACnB,KAAK,EAAE,cAAc,EAAE,EACvB,IAAI,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAClD,OAAO,CAAC,WAAW,CAAC;IAIvB;;;;OAIG;IACG,SAAS,CACb,QAAQ,EAAE,OAAO,EAAE,EACnB,KAAK,EAAE,cAAc,EAAE,EACvB,IAAI,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAClD,OAAO,CAAC,WAAW,CAAC;IAIvB,sDAAsD;IACtD,aAAa,IAAI,OAAO;YAIV,YAAY;YA+CZ,UAAU;IAkDxB,OAAO,CAAC,eAAe;IAyBvB,OAAO,CAAC,YAAY;YAaN,aAAa;IAsD3B,OAAO,CAAC,mBAAmB;IAgE3B,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,gBAAgB;IAyBxB,OAAO,CAAC,gBAAgB;IAgBxB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAuDpB,OAAO,CAAC,KAAK;CAGd"}