@loompad/cli 0.1.0 → 1.1.1

package/dist/core/events/sqlite-store.js

@@ -0,0 +1,215 @@
+import { MAIN_CHAT } from "../../types.js";
+import { ContinuityStore } from "../continuity/store.js";
+import fs from "node:fs";
+import path from "node:path";
+import { randomUUID } from "node:crypto";
+import { isDeepStrictEqual } from "node:util";
+import { ContinuityError, digest } from "../continuity/contracts.js";
+export class SqliteStore {
+    db;
+    continuity;
+    file;
+    constructor(sqlite, file) {
+        this.file = file;
+        this.db = new sqlite.DatabaseSync(file);
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS events (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        ts INTEGER NOT NULL,
+        kind TEXT NOT NULL,
+        agent_id TEXT,
+        chat TEXT,
+        payload TEXT NOT NULL
+      );
+      CREATE INDEX IF NOT EXISTS idx_events_kind ON events(kind, id);
+    `);
+        // Migrate BEFORE indexing chat. A log written before chats existed already
+        // has an `events` table, so CREATE TABLE IF NOT EXISTS is a no-op and the
+        // column is still missing — indexing it here would throw "no such column"
+        // and take the whole log down with it. Add the column, then index.
+        // The log is append-only and those events are history: a NULL chat reads
+        // as the main conversation rather than being rewritten.
+        const cols = this.db.prepare("PRAGMA table_info(events)").all();
+        if (!cols.some((c) => c.name === "chat")) {
+            this.db.exec("ALTER TABLE events ADD COLUMN chat TEXT");
+        }
+        this.db.exec("CREATE INDEX IF NOT EXISTS idx_events_chat ON events(chat, id)");
+        // time windows over one kind: today's spend, the cost/usage charts
+        this.db.exec("CREATE INDEX IF NOT EXISTS idx_events_kind_ts ON events(kind, ts)");
+        this.continuity = new ContinuityStore(this.db, file);
+    }
+    /** Explicit offline migration. Conflicting IDs or malformed records abort the
+     * entire import; original files and IDs stay intact. Never silently renumber. */
+    importJsonl(file) {
+        const ownerTable = this.db.prepare("SELECT name FROM sqlite_master WHERE name='continuity_meta'").get();
+        if (ownerTable && this.db.prepare("SELECT value FROM continuity_meta WHERE key='owner'").get())
+            throw new ContinuityError("conflict", "close the Brain project owner before importing legacy history");
+        const events = this.readJsonl(file), hash = digest(fs.readFileSync(file, "utf8"));
+        const backup = `${file}.before-brain-v1.${randomUUID()}`;
+        fs.copyFileSync(file, backup, fs.constants.COPYFILE_EXCL);
+        const dbBackup = `${path.join(path.dirname(file), "log.db")}.before-jsonl.${randomUUID()}.db`;
+        this.db.prepare("VACUUM INTO ?").run(dbBackup);
+        let imported = 0, known = 0;
+        this.db.exec("BEGIN IMMEDIATE");
+        try {
+            this.db.exec("CREATE TABLE IF NOT EXISTS continuity_imports (hash TEXT PRIMARY KEY, source TEXT NOT NULL, count INTEGER NOT NULL, backup TEXT NOT NULL)");
+            for (const event of events) {
+                const prior = this.eventById(event.id);
+                if (prior) {
+                    if (!isDeepStrictEqual(prior, event))
+                        throw new ContinuityError("conflict", `legacy event ID ${event.id} conflicts with SQLite; reconcile the two backups before import`);
+                    known++;
+                    continue;
+                }
+                this.db.prepare("INSERT INTO events(id,ts,kind,agent_id,chat,payload) VALUES (?,?,?,?,?,?)")
+                    .run(event.id, event.ts, event.kind, event.agentId ?? null, event.chat ?? null, JSON.stringify(event.payload));
+                imported++;
+            }
+            this.db.prepare("INSERT OR IGNORE INTO continuity_imports VALUES (?,?,?,?)").run(hash, path.basename(file), events.length, path.basename(backup));
+            this.db.exec("COMMIT");
+        }
+        catch (error) {
+            this.db.exec("ROLLBACK");
+            throw error;
+        }
+        return { imported, known, backup };
+    }
+    verifyJsonl(file) {
+        if (!fs.existsSync(file) || !fs.statSync(file).size)
+            return;
+        for (const event of this.readJsonl(file))
+            if (!isDeepStrictEqual(event, this.eventById(event.id)))
+                throw new ContinuityError("conflict", "SQLite and JSONL contain distinct histories; stop the daemon and run loom brain:migrate before continuing");
+    }
+    eventById(id) {
+        const row = this.db.prepare("SELECT * FROM events WHERE id=?").get(id);
+        return row ? { id: row.id, ts: row.ts, kind: row.kind, ...(row.agent_id ? { agentId: row.agent_id } : {}),
+            ...(row.chat ? { chat: row.chat } : {}), payload: JSON.parse(row.payload) } : undefined;
+    }
+    readJsonl(file) {
+        if (fs.statSync(file).size > 100_000_000)
+            throw new ContinuityError("overflow", "legacy import exceeds the 100 MB offline import limit");
+        let last = 0;
+        return fs.readFileSync(file, "utf8").split("\n").filter(line => line.trim()).map(line => {
+            let event;
+            try {
+                event = JSON.parse(line);
+            }
+            catch {
+                throw new ContinuityError("invalid", "malformed JSONL record; repair a copy before migration (original left intact)");
+            }
+            if (!Number.isSafeInteger(event.id) || event.id <= last || !Number.isSafeInteger(event.ts) ||
+                typeof event.kind !== "string" || !event.payload || typeof event.payload !== "object" || Array.isArray(event.payload) ||
+                (event.chat !== undefined && typeof event.chat !== "string") || (event.agentId !== undefined && typeof event.agentId !== "string"))
+                throw new ContinuityError("invalid", "invalid or duplicate/out-of-order legacy event");
+            last = event.id;
+            return { id: event.id, ts: event.ts, kind: event.kind, ...(event.agentId ? { agentId: event.agentId } : {}), ...(event.chat ? { chat: event.chat } : {}), payload: event.payload };
+        });
+    }
+    append(e) {
+        this.continuity.guardEventWriter();
+        const stmt = this.db.prepare("INSERT INTO events (ts, kind, agent_id, chat, payload) VALUES (?, ?, ?, ?, ?)");
+        const res = stmt.run(e.ts, e.kind, e.agentId ?? null, e.chat ?? null, JSON.stringify(e.payload));
+        return {
+            id: Number(res.lastInsertRowid),
+            ts: e.ts,
+            kind: e.kind,
+            ...(e.agentId ? { agentId: e.agentId } : {}),
+            ...(e.chat ? { chat: e.chat } : {}),
+            payload: e.payload,
+        };
+    }
+    /** The WHERE clause every read shares (list and count). */
+    where(opts) {
+        const clauses = [];
+        const params = [];
+        if (opts.since !== undefined) {
+            clauses.push("id > ?");
+            params.push(opts.since);
+        }
+        if (opts.before !== undefined) {
+            clauses.push("id < ?");
+            params.push(opts.before);
+        }
+        if (opts.kinds?.length) {
+            clauses.push(`kind IN (${opts.kinds.map(() => "?").join(",")})`);
+            params.push(...opts.kinds);
+        }
+        if (opts.sinceTs !== undefined) {
+            clauses.push("ts >= ?");
+            params.push(opts.sinceTs);
+        }
+        if (opts.chat !== undefined) {
+            if (opts.chat === MAIN_CHAT) {
+                // pre-chat history has no id and belongs to the main conversation
+                clauses.push("(chat = ? OR chat IS NULL)");
+            }
+            else {
+                clauses.push("chat = ?");
+            }
+            params.push(opts.chat);
+        }
+        if (opts.agentId !== undefined) {
+            clauses.push("agent_id = ?");
+            params.push(opts.agentId);
+        }
+        return { where: clauses.length ? `WHERE ${clauses.join(" AND ")}` : "", params };
+    }
+    count(opts = {}) {
+        const { where, params } = this.where(opts);
+        const row = this.db.prepare(`SELECT COUNT(*) AS n FROM events ${where}`).get(...params);
+        return Number(row.n);
+    }
+    list(opts = {}) {
+        const { where, params } = this.where(opts);
+        return this.listWhere(opts, where, params);
+    }
+    listWhere(opts, where, params) {
+        // When limiting, we want the *most recent* N in ascending order.
+        const sql = opts.limit
+            ? `SELECT * FROM (SELECT * FROM events ${where} ORDER BY id DESC LIMIT ?) ORDER BY id ASC`
+            : `SELECT * FROM events ${where} ORDER BY id ASC`;
+        if (opts.limit)
+            params.push(opts.limit);
+        const rows = this.db.prepare(sql).all(...params);
+        return rows.map((r) => ({
+            id: Number(r.id),
+            ts: r.ts,
+            kind: r.kind,
+            ...(r.agent_id ? { agentId: r.agent_id } : {}),
+            ...(r.chat ? { chat: r.chat } : {}),
+            payload: JSON.parse(r.payload),
+        }));
+    }
+    size() {
+        const n = this.db.prepare("SELECT COUNT(*) AS n FROM events").get();
+        let bytes = 0;
+        for (const f of [this.file, `${this.file}-wal`]) {
+            try {
+                bytes += fs.statSync(f).size;
+            }
+            catch {
+                /* no wal file is fine */
+            }
+        }
+        return { bytes, events: Number(n.n) };
+    }
+    compact() {
+        this.db.exec("VACUUM");
+    }
+    lastReplyIds() {
+        const rows = this.db
+            .prepare("SELECT COALESCE(chat, ?) AS c, MAX(id) AS m FROM events WHERE kind = 'message' AND agent_id IS NOT NULL GROUP BY COALESCE(chat, ?)")
+            .all(MAIN_CHAT, MAIN_CHAT);
+        return new Map(rows.map((r) => [r.c, Number(r.m)]));
+    }
+    lastId() {
+        const row = this.db.prepare("SELECT MAX(id) AS m FROM events").get();
+        return row?.m ? Number(row.m) : 0;
+    }
+    close() {
+        this.continuity.releaseOwner();
+        this.db.close();
+    }
+}
+//# sourceMappingURL=sqlite-store.js.map

package/dist/core/events/sqlite-store.js.map

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

package/dist/core/forecast.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Pre-flight forecast: what a turn on this agent usually costs and takes,
+ * before you send it.
+ *
+ * Read from the agent's own recent turns, not a price list — a CLI on a
+ * subscription reports no dollars and gets a time-only forecast, a model
+ * agent's spend is what it actually spent here. "Typical" is the median and
+ * "high" the 80th percentile, so one marathon turn doesn't move the number.
+ * With a daily budget set, it says when one more high turn could cross it.
+ */
+export interface Forecast {
+    /** How many recent turns it's read from. */
+    turns: number;
+    ms: {
+        typical: number;
+        high: number;
+    };
+    /** Absent when the agent reports no spend (a CLI on a subscription). */
+    usd?: {
+        typical: number;
+        high: number;
+    };
+    budget?: {
+        capUsd: number;
+        spentUsd: number;
+        mayCross: boolean;
+    };
+}
+/** The fewest turns a forecast is honest from. */
+export declare const FORECAST_MIN_TURNS = 3;
+/** How many recent turns it remembers per agent. */
+export declare const FORECAST_WINDOW = 30;
+export declare function forecastFrom(costs: number[], durations: number[], budget?: {
+    capUsd: number;
+    spentUsd: number;
+}): Forecast | null;
+/** A fixed-size record of the latest values. */
+export declare class Recent {
+    private readonly size;
+    private xs;
+    constructor(size?: number);
+    push(x: number): void;
+    values(): number[];
+}

package/dist/core/forecast.js

@@ -0,0 +1,46 @@
+/**
+ * Pre-flight forecast: what a turn on this agent usually costs and takes,
+ * before you send it.
+ *
+ * Read from the agent's own recent turns, not a price list — a CLI on a
+ * subscription reports no dollars and gets a time-only forecast, a model
+ * agent's spend is what it actually spent here. "Typical" is the median and
+ * "high" the 80th percentile, so one marathon turn doesn't move the number.
+ * With a daily budget set, it says when one more high turn could cross it.
+ */
+/** The fewest turns a forecast is honest from. */
+export const FORECAST_MIN_TURNS = 3;
+/** How many recent turns it remembers per agent. */
+export const FORECAST_WINDOW = 30;
+function quantile(xs, q) {
+    const s = [...xs].sort((a, b) => a - b);
+    const i = (s.length - 1) * q, lo = Math.floor(i), hi = Math.ceil(i);
+    return s[lo] + (s[hi] - s[lo]) * (i - lo);
+}
+export function forecastFrom(costs, durations, budget) {
+    const ms = durations.filter((x) => Number.isFinite(x) && x > 0);
+    if (ms.length < FORECAST_MIN_TURNS)
+        return null;
+    const usd = costs.filter((x) => Number.isFinite(x) && x > 0);
+    const out = { turns: ms.length, ms: { typical: Math.round(quantile(ms, 0.5)), high: Math.round(quantile(ms, 0.8)) } };
+    if (usd.length >= FORECAST_MIN_TURNS)
+        out.usd = { typical: round(quantile(usd, 0.5)), high: round(quantile(usd, 0.8)) };
+    if (budget && budget.capUsd > 0) {
+        const high = out.usd?.high ?? 0;
+        out.budget = { capUsd: budget.capUsd, spentUsd: round(budget.spentUsd), mayCross: budget.spentUsd + high >= budget.capUsd };
+    }
+    return out;
+}
+const round = (x) => Math.round(x * 10_000) / 10_000;
+/** A fixed-size record of the latest values. */
+export class Recent {
+    size;
+    xs = [];
+    constructor(size = FORECAST_WINDOW) {
+        this.size = size;
+    }
+    push(x) { this.xs.push(x); if (this.xs.length > this.size)
+        this.xs.shift(); }
+    values() { return this.xs; }
+}
+//# sourceMappingURL=forecast.js.map

package/dist/core/forecast.js.map

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

package/dist/core/free-pool.d.ts

@@ -0,0 +1,65 @@
+/**
+ * The free pool: a model agent that spreads its turns across every free model
+ * a provider serves, instead of leaning on one.
+ *
+ * OpenRouter's free models are rate-limited per model (a burst on one gets a
+ * 429 while the others are idle) and capped per account per day (50 requests
+ * on a free-tier key, 1000 with credits, shared by every `:free` model). Those
+ * are different failures with different answers:
+ *
+ * - one model rate-limited → rest it for a minute and take the next one;
+ * - the daily cap spent → every free model will say the same thing, so stop at
+ *   once and say when it resets, rather than walking the list to collect the
+ *   same 429 nineteen times.
+ *
+ * An agent opts in with the model id `pool:free` (`openrouter/pool:free` in a
+ * picker). Each turn takes the next model in a machine-wide rotation, so a
+ * crew of model agents on the pool lands on different models at once.
+ */
+import { type ResolvedProvider } from "./providers.js";
+export declare const FREE_POOL = "pool:free";
+export declare const isPool: (model: string | undefined) => boolean;
+interface PoolModel {
+    id: string;
+    context: number;
+    tools: boolean;
+}
+/** The provider's free chat models, best first (most context). */
+export declare function freeModels(p: ResolvedProvider, opts?: {
+    tools?: boolean;
+    fetchImpl?: typeof fetch;
+}): Promise<PoolModel[]>;
+/**
+ * A free model the provider won't serve to Loom at all — OpenRouter keeps some
+ * "for agentic harnesses" on its own app list and answers 403. That's about the
+ * model, not the key: skip it for a week, then look again.
+ */
+export declare function isClosedToUs(status: number, body: string): boolean;
+export declare function closeModel(model: string): void;
+/** Free here: by the provider's naming rule, or by the zero price its list gave. */
+export declare function isFreeModel(p: ResolvedProvider, model: string): boolean;
+/** A model that just said 429: leave it alone for a while. */
+export declare function rest(model: string, ms?: number): void;
+/**
+ * The order to try this turn: the next model in the rotation first, then the
+ * rest, with resting models at the back. `max` bounds a turn's attempts.
+ */
+export declare function rotation(models: PoolModel[], max?: number): string[];
+/** OpenRouter's "you've used today's free requests" (not one model being busy). */
+export declare function isDailyCap(status: number, body: string): boolean;
+/** When the cap lifts, from X-RateLimit-Reset (epoch ms or s), if it said. */
+export declare function resetAt(headers: Headers | undefined): number | null;
+export declare function dailyCapMessage(label: string, at: number | null): string;
+/** One free request this machine made today (UTC day, as OpenRouter counts). */
+export declare function countFreeRequest(): void;
+/** The cap was hit: remember when, so the picker can say so without asking. */
+export declare function noteCapped(at: number | null): void;
+/** Today's free requests from this machine, and whether the cap is known to be hit. */
+export declare function freeUsage(): {
+    day: string;
+    used: number;
+    cappedUntil: number | null;
+};
+/** Tests. */
+export declare function resetPool(): void;
+export {};

package/dist/core/free-pool.js

@@ -0,0 +1,171 @@
+/**
+ * The free pool: a model agent that spreads its turns across every free model
+ * a provider serves, instead of leaning on one.
+ *
+ * OpenRouter's free models are rate-limited per model (a burst on one gets a
+ * 429 while the others are idle) and capped per account per day (50 requests
+ * on a free-tier key, 1000 with credits, shared by every `:free` model). Those
+ * are different failures with different answers:
+ *
+ * - one model rate-limited → rest it for a minute and take the next one;
+ * - the daily cap spent → every free model will say the same thing, so stop at
+ *   once and say when it resets, rather than walking the list to collect the
+ *   same 429 nineteen times.
+ *
+ * An agent opts in with the model id `pool:free` (`openrouter/pool:free` in a
+ * picker). Each turn takes the next model in a machine-wide rotation, so a
+ * crew of model agents on the pool lands on different models at once.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { modelsUrl, requestHeaders } from "./providers.js";
+import { loomHome } from "./registry.js";
+export const FREE_POOL = "pool:free";
+export const isPool = (model) => model?.trim() === FREE_POOL;
+/** Not chat models, whatever their price: music, safety classifiers, embeddings, speech. */
+const NOT_CHAT = /lyria|content-safety|guard|embed|tts|whisper|moderation|image-preview|-image\b/i;
+const cache = new Map();
+const LIST_TTL_MS = 30 * 60_000;
+/** The provider's free chat models, best first (most context). */
+export async function freeModels(p, opts = {}) {
+    const hit = cache.get(p.id);
+    let models = hit && Date.now() - hit.at < LIST_TTL_MS ? hit.models : null;
+    if (!models) {
+        const res = await (opts.fetchImpl ?? fetch)(modelsUrl(p), { headers: requestHeaders(p), signal: AbortSignal.timeout(15_000) });
+        if (!res.ok)
+            throw new Error(`${p.label} didn't list its models (${res.status})`);
+        const body = (await res.json());
+        models = (body.data ?? [])
+            .filter((m) => typeof m.id === "string")
+            .filter((m) => p.free(m.id) || (m.pricing?.prompt === "0" && m.pricing?.completion === "0"))
+            .filter((m) => !NOT_CHAT.test(m.id) && m.id !== "openrouter/free")
+            .filter((m) => !m.architecture?.output_modalities || m.architecture.output_modalities.includes("text"))
+            .map((m) => ({ id: m.id, context: m.context_length ?? 0, tools: (m.supported_parameters ?? []).includes("tools") }))
+            .sort((a, b) => b.context - a.context);
+        cache.set(p.id, { at: Date.now(), models });
+    }
+    const shut = closed();
+    return models.filter((m) => !shut.has(m.id) && (!opts.tools || m.tools));
+}
+// ---- models closed to Loom ---------------------------------------------------------
+/**
+ * A free model the provider won't serve to Loom at all — OpenRouter keeps some
+ * "for agentic harnesses" on its own app list and answers 403. That's about the
+ * model, not the key: skip it for a week, then look again.
+ */
+export function isClosedToUs(status, body) {
+    return (status === 403 || status === 404) && /only available (?:on|to|in)|not available (?:for|to|via)|restricted to/i.test(body);
+}
+const closedFile = () => path.join(loomHome(), "free-closed.json");
+const WEEK = 7 * 24 * 3600_000;
+function closed() {
+    try {
+        const all = JSON.parse(fs.readFileSync(closedFile(), "utf8"));
+        return new Set(Object.entries(all).filter(([, at]) => Date.now() - at < WEEK).map(([id]) => id));
+    }
+    catch {
+        return new Set();
+    }
+}
+export function closeModel(model) {
+    let all = {};
+    try {
+        all = JSON.parse(fs.readFileSync(closedFile(), "utf8"));
+    }
+    catch { /* none yet */ }
+    all[model] = Date.now();
+    try {
+        fs.mkdirSync(path.dirname(closedFile()), { recursive: true });
+        fs.writeFileSync(closedFile(), JSON.stringify(all));
+    }
+    catch { /* best effort */ }
+}
+/** Free here: by the provider's naming rule, or by the zero price its list gave. */
+export function isFreeModel(p, model) {
+    return p.free(model) || Boolean(cache.get(p.id)?.models.some((m) => m.id === model));
+}
+// ---- rotation and rest -------------------------------------------------------
+let cursor = 0;
+const restingUntil = new Map();
+/** A model that just said 429: leave it alone for a while. */
+export function rest(model, ms = 60_000) {
+    restingUntil.set(model, Date.now() + ms);
+}
+/**
+ * The order to try this turn: the next model in the rotation first, then the
+ * rest, with resting models at the back. `max` bounds a turn's attempts.
+ */
+export function rotation(models, max = 4) {
+    if (!models.length)
+        return [];
+    const start = cursor++ % models.length;
+    const ordered = [...models.slice(start), ...models.slice(0, start)].map((m) => m.id);
+    const now = Date.now();
+    const awake = ordered.filter((id) => (restingUntil.get(id) ?? 0) <= now);
+    const resting = ordered.filter((id) => (restingUntil.get(id) ?? 0) > now);
+    return [...awake, ...resting].slice(0, max);
+}
+// ---- the account's daily cap ---------------------------------------------------
+/** OpenRouter's "you've used today's free requests" (not one model being busy). */
+export function isDailyCap(status, body) {
+    return status === 429 && /free-models-per-day|per[- ]day|daily/i.test(body);
+}
+/** When the cap lifts, from X-RateLimit-Reset (epoch ms or s), if it said. */
+export function resetAt(headers) {
+    const raw = headers?.get("x-ratelimit-reset");
+    const n = raw ? Number(raw) : NaN;
+    if (!Number.isFinite(n) || n <= 0)
+        return null;
+    return n < 1e12 ? n * 1000 : n;
+}
+export function dailyCapMessage(label, at) {
+    const when = at ? ` — it resets ${new Date(at).toLocaleString(undefined, { weekday: "short", hour: "numeric", minute: "2-digit" })}` : "";
+    return `${label}'s free requests for today are used up (every free model shares one daily cap)${when}. ` +
+        "Credits on the account raise the cap; until then, a paid model or another agent can take the turn.";
+}
+const usageFile = () => path.join(loomHome(), "free-usage.json");
+const today = () => new Date().toISOString().slice(0, 10);
+function readUsage() {
+    try {
+        const u = JSON.parse(fs.readFileSync(usageFile(), "utf8"));
+        if (u.day === today())
+            return u;
+    }
+    catch {
+        /* none yet */
+    }
+    return { day: today(), count: 0 };
+}
+function writeUsage(u) {
+    try {
+        fs.mkdirSync(path.dirname(usageFile()), { recursive: true });
+        fs.writeFileSync(usageFile(), JSON.stringify(u));
+    }
+    catch {
+        /* a counter is not worth failing a turn over */
+    }
+}
+/** One free request this machine made today (UTC day, as OpenRouter counts). */
+export function countFreeRequest() {
+    const u = readUsage();
+    u.count++;
+    writeUsage(u);
+}
+/** The cap was hit: remember when, so the picker can say so without asking. */
+export function noteCapped(at) {
+    const u = readUsage();
+    u.capped = at ?? Date.now() + 6 * 3600_000;
+    writeUsage(u);
+}
+/** Today's free requests from this machine, and whether the cap is known to be hit. */
+export function freeUsage() {
+    const u = readUsage();
+    return { day: u.day, used: u.count, cappedUntil: u.capped && u.capped > Date.now() ? u.capped : null };
+}
+/** Tests. */
+export function resetPool() {
+    cache.clear();
+    restingUntil.clear();
+    cursor = 0;
+}
+//# sourceMappingURL=free-pool.js.map

package/dist/core/free-pool.js.map

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

package/dist/core/git.d.ts

@@ -90,6 +90,14 @@ export interface GitStatus {
  * that into one list and you get a checkbox that lies about what a commit will
  * contain.
  */
+/**
+ * Stage exactly these paths and commit them — the per-turn commit's primitive.
+ *
+ * Scoped staging on purpose: `git add -A` here would swallow another agent's
+ * uncommitted work into this agent's commit, which is precisely the
+ * misattribution the feature exists to end.
+ */
+export declare function stageAndCommitFiles(dir: string, paths: string[], message: string): Promise<CommitResult>;
 export declare function status(dir: string): Promise<GitStatus>;
 /**
  * Start version control here.
@@ -132,6 +140,28 @@ export interface Branches {
 }
 /** Local branches and which one is checked out — for the checkout picker. */
 export declare function branches(dir: string): Promise<Branches>;
+/**
+ * Create a branch (if needed) and switch to it — the board-card primitive.
+ *
+ * `checkout -B` would move an existing branch's tip, silently discarding where
+ * it pointed; this creates only when absent and otherwise just switches, so
+ * re-dragging a card to Working is idempotent rather than destructive.
+ */
+/**
+ * Run git (or another command) and hand back its output, errors and all.
+ *
+ * For the places that want to *look* — what's on a branch, what a PR would
+ * carry — rather than act, where a non-zero exit is an answer ("no such
+ * branch") and not a failure.
+ */
+export declare function readOut(dir: string, args: string[], opts?: {
+    cmd?: string;
+    args?: string[];
+}): Promise<string>;
+export declare function ensureBranch(dir: string, name: string): Promise<{
+    branch: string;
+    created: boolean;
+}>;
 /**
  * Switch to a branch or commit.
  *