@loompad/cli 0.1.0 → 1.1.1

package/dist/core/proof.js

@@ -0,0 +1,216 @@
+/**
+ * Proof — is "done" true? (the "Proof Pack")
+ *
+ * Agents say "all tests pass" when three of fourteen ran, or when none did.
+ * Proof reads what an agent *claimed* at the end of a turn, what it actually
+ * *ran* during it (the shell tool calls and their exit codes, already in the
+ * log), and — the part no vendor does for itself — what happens when Loom runs
+ * the project's tests again in a clean checkout of the agent's changes. The
+ * verdict is one of:
+ *
+ *   verified      the re-run passes, and nothing the agent claimed contradicts it
+ *   contradicted  the re-run fails, or a claim doesn't match what happened
+ *                 (it said 14 pass and 11 did; it said tests pass and never ran any)
+ *   unverified    nothing to check against (no test command, no claims)
+ *
+ * This file is pure: claims, evidence, counts, the verdict. Running the tests
+ * in a clean worktree is the daemon's (daemon/proof.ts).
+ */
+import fs from "node:fs";
+import path from "node:path";
+// ── claims ──
+const NUM = String.raw `(\d{1,6})`;
+const CLAIM_PATTERNS = [
+    { kind: "tests", re: new RegExp(String.raw `\b(?:all\s+)?${NUM}?\s*(?:/\s*${NUM}\s*)?(?:unit\s+|e2e\s+|integration\s+)?(?:tests?|specs?|test cases?)\b[^.\n]{0,40}?\b(?:pass(?:es|ed|ing)?|green|succeed(?:s|ed)?|ok)\b`, "i") },
+    { kind: "tests", re: /\b(?:all\s+)?(?:the\s+)?tests?\s+(?:are\s+|now\s+)*(?:pass(?:es|ed|ing)?|green)\b/i },
+    { kind: "tests", re: new RegExp(String.raw `\b${NUM}\s+passed\b`, "i") },
+    { kind: "build", re: /\b(?:the\s+)?build\s+(?:now\s+)?(?:pass(?:es|ed)?|succeed(?:s|ed)?|is\s+green|works|compiles)\b|\bbuilds?\s+(?:cleanly|successfully)\b/i },
+    { kind: "typecheck", re: /\b(?:type[- ]?check(?:s|ing)?|tsc|types)\s+(?:(?:is|are)\s+)?(?:now\s+)?(?:pass(?:es|ed)?|clean|green|succeed(?:s|ed)?)\b|\bno\s+type\s+errors\b/i },
+    { kind: "lint", re: /\b(?:lint(?:ing|er)?|eslint|ruff|clippy)\s+(?:(?:is|are)\s+)?(?:now\s+)?(?:pass(?:es|ed)?|clean|green)\b|\bno\s+lint\s+(?:errors|warnings)\b/i },
+];
+/**
+ * Sentences that only *talk about* tests claim nothing: a hope or a condition
+ * ("should pass once CI…", "if the tests pass"), a negation ("haven't run"),
+ * an instruction ("Run the tests to check").
+ */
+const HEDGE = /\b(?:should|would|could|might|may|will|once|until|if|unless|hopefully|expect(?:ed|s)?|to make sure|to verify|to confirm|supposed to)\b/i;
+const NEGATED = /\b(?:not|never|no longer|not yet|haven'?t|hasn'?t|didn'?t|don'?t|doesn'?t|couldn'?t|can'?t|cannot|won'?t|unable|without)\b/i;
+const INSTRUCTION = /^(?:please\s+)?(?:run|try|make sure|check|verify|ensure)\b/i;
+/** What a turn's final message says is true. One claim per kind (the strongest sentence). */
+export function extractClaims(text) {
+    const out = new Map();
+    const prose = text.replace(/```[\s\S]*?```/g, " "); // code blocks show commands and output, not claims
+    for (const raw of prose.split(/(?<=[.!?])\s+|\n+/)) {
+        const sentence = raw.replace(/^[\s>*\-•✅✓☑️]+/, "").trim();
+        if (!sentence || sentence.length > 400)
+            continue;
+        for (const { kind, re } of CLAIM_PATTERNS) {
+            const m = re.exec(sentence);
+            if (!m)
+                continue;
+            if (HEDGE.test(sentence) || NEGATED.test(sentence) || INSTRUCTION.test(sentence))
+                continue;
+            if (/\b(?:fail(?:s|ed|ing|ures?)?|broken|red)\b/i.test(sentence) && !/\b0\s+fail/i.test(sentence))
+                continue;
+            const nums = m.slice(1).filter((x) => x !== undefined).map(Number);
+            const claim = { kind, text: sentence.slice(0, 240) };
+            if (kind === "tests" && nums.length) {
+                claim.passed = nums[0];
+                if (nums.length > 1)
+                    claim.total = nums[1];
+            }
+            const prev = out.get(kind);
+            if (!prev || (claim.passed !== undefined && prev.passed === undefined))
+                out.set(kind, claim);
+        }
+    }
+    return [...out.values()];
+}
+// ── what ran ──
+const KIND_OF = [
+    { kind: "typecheck", re: /\b(?:tsc\b(?!.*--build)|vue-tsc|mypy|pyright|typecheck|type-check|check-types)\b/i },
+    { kind: "lint", re: /\b(?:eslint|lint|ruff\s+check|flake8|pylint|clippy|golangci-lint|biome\s+(?:check|lint))\b/i },
+    { kind: "tests", re: /\b(?:test|tests|vitest|jest|mocha|ava|pytest|py\.test|unittest|rspec|phpunit|go\s+test|cargo\s+test|cargo\s+nextest|dotnet\s+test|mvn\s+test|gradle\w*\s+test|swift\s+test|bun\s+test|deno\s+test|node\s+--test|playwright\s+test|cypress\s+run)\b/i },
+    { kind: "build", re: /\b(?:build|compile|cargo\s+build|go\s+build|tsc\s+--build|make\b|webpack|vite\s+build|next\s+build|gradle\w*\s+assemble)\b/i },
+];
+export function commandKind(command) {
+    for (const { kind, re } of KIND_OF)
+        if (re.test(command))
+            return kind;
+    return "other";
+}
+/**
+ * Pass/fail counts from a test runner's output: vitest, jest, mocha, node:test,
+ * pytest, go test, cargo test, rspec, phpunit. Null when it can't tell.
+ */
+export function parseCounts(output) {
+    const o = output.replace(/\x1b\[[0-9;]*m/g, "");
+    let m;
+    // vitest: "Tests  1 failed | 12 passed | 2 skipped (15)"
+    if ((m = /Tests\s+((?:\d+\s+\w+\s*\|?\s*)+)\((\d+)\)/.exec(o))) {
+        const part = (w) => Number(new RegExp(String.raw `(\d+)\s+${w}`).exec(m[1])?.[1] ?? 0);
+        return { passed: part("passed"), failed: part("failed"), skipped: part("skipped"), total: Number(m[2]) };
+    }
+    // jest: "Tests:       1 failed, 12 passed, 13 total"
+    if ((m = /Tests:\s+(.*?)(\d+)\s+total/.exec(o))) {
+        const part = (w) => Number(new RegExp(String.raw `(\d+)\s+${w}`).exec(m[1])?.[1] ?? 0);
+        return { passed: part("passed"), failed: part("failed"), skipped: part("skipped"), total: Number(m[2]) };
+    }
+    // node:test: "# pass 12" / "# fail 1"   (also "ℹ pass 12")
+    if (/(?:#|ℹ)\s+pass\s+\d+/.test(o)) {
+        const n = (w) => Number(new RegExp(String.raw `(?:#|ℹ)\s+${w}\s+(\d+)`).exec(o)?.[1] ?? 0);
+        return { passed: n("pass"), failed: n("fail"), skipped: n("skipped"), total: n("tests") || undefined };
+    }
+    // pytest: "=== 3 passed, 1 failed, 2 skipped in 0.12s ==="
+    if ((m = /=+\s*((?:\d+\s+\w+(?:,\s*)?)+)\s+in\s+[\d.]+s/.exec(o))) {
+        const part = (w) => Number(new RegExp(String.raw `(\d+)\s+${w}`).exec(m[1])?.[1] ?? 0);
+        return { passed: part("passed"), failed: part("failed") + part("error"), skipped: part("skipped") };
+    }
+    // cargo: "test result: ok. 5 passed; 0 failed; 1 ignored"
+    if ((m = /test result: \w+\. (\d+) passed; (\d+) failed(?:; (\d+) ignored)?/.exec(o))) {
+        return { passed: Number(m[1]), failed: Number(m[2]), skipped: Number(m[3] ?? 0) };
+    }
+    // mocha: "12 passing" / "1 failing"
+    if ((m = /(\d+)\s+passing\b/.exec(o))) {
+        return { passed: Number(m[1]), failed: Number(/(\d+)\s+failing\b/.exec(o)?.[1] ?? 0), skipped: Number(/(\d+)\s+pending\b/.exec(o)?.[1] ?? 0) };
+    }
+    // rspec: "14 examples, 1 failure"
+    if ((m = /(\d+)\s+examples?,\s+(\d+)\s+failures?/.exec(o)))
+        return { passed: Number(m[1]) - Number(m[2]), failed: Number(m[2]), total: Number(m[1]) };
+    // phpunit: "OK (12 tests, 30 assertions)" / "Tests: 12, Assertions: 30, Failures: 1."
+    if ((m = /OK \((\d+) tests?/.exec(o)))
+        return { passed: Number(m[1]), failed: 0, total: Number(m[1]) };
+    if ((m = /Tests: (\d+), Assertions: \d+(?:, Errors: (\d+))?(?:, Failures: (\d+))?/.exec(o))) {
+        const failed = Number(m[2] ?? 0) + Number(m[3] ?? 0);
+        return { passed: Number(m[1]) - failed, failed, total: Number(m[1]) };
+    }
+    // go: count "--- PASS" / "--- FAIL" lines, else a bare ok/FAIL package summary
+    const goPass = (o.match(/^\s*--- PASS:/gm) ?? []).length, goFail = (o.match(/^\s*--- FAIL:/gm) ?? []).length;
+    if (goPass || goFail)
+        return { passed: goPass, failed: goFail };
+    return null;
+}
+/** The commands a turn ran, from its tool_call events. */
+export function evidenceFrom(events) {
+    const out = [];
+    for (const e of events) {
+        if (e.kind !== "tool_call")
+            continue;
+        const p = e.payload;
+        const command = typeof p.command === "string" ? p.command
+            : String(p.tool ?? "").toLowerCase() === "shell" || String(p.tool ?? "").toLowerCase() === "bash"
+                ? String(p.input?.command ?? p.summary ?? "").replace(/^shell:\s*/, "") : "";
+        if (!command.trim())
+            continue;
+        const exitCode = typeof p.exitCode === "number" ? p.exitCode : null;
+        const output = [p.output, p.preview].filter((x) => typeof x === "string").join("\n");
+        const counts = output ? parseCounts(output) : null;
+        const ok = exitCode !== null ? exitCode === 0 : p.ok !== false && !(counts && counts.failed > 0);
+        out.push({ command: command.slice(0, 500), kind: commandKind(command), exitCode, ok, ...(counts ? { counts } : {}), eventId: e.id });
+    }
+    return out;
+}
+// ── the project's test command ──
+/** The command that tests this project, from what it declares. Null when it declares nothing runnable. */
+export function detectTestCommand(dir) {
+    const has = (f) => fs.existsSync(path.join(dir, f));
+    if (has("package.json")) {
+        try {
+            const pkg = JSON.parse(fs.readFileSync(path.join(dir, "package.json"), "utf8"));
+            const test = pkg.scripts?.test;
+            if (test && !/no test specified/i.test(test)) {
+                const runner = has("pnpm-lock.yaml") ? "pnpm" : has("yarn.lock") ? "yarn" : has("bun.lockb") || has("bun.lock") ? "bun" : "npm";
+                return runner === "npm" ? "npm test" : `${runner} test`;
+            }
+        }
+        catch { /* a package.json we can't read declares nothing */ }
+    }
+    if (has("Cargo.toml"))
+        return "cargo test";
+    if (has("go.mod"))
+        return "go test ./...";
+    if (has("pytest.ini") || has("conftest.py") || (has("pyproject.toml") && /\[tool\.pytest/.test(fs.readFileSync(path.join(dir, "pyproject.toml"), "utf8"))))
+        return "python -m pytest -q";
+    if (has("Makefile") && /^test:/m.test(fs.readFileSync(path.join(dir, "Makefile"), "utf8")))
+        return "make test";
+    return null;
+}
+// ── the verdict ──
+/** Weigh what was claimed against what ran and what the clean re-run showed. */
+export function judge(claims, ran, rerun) {
+    const checks = claims.map((c) => {
+        const same = ran.filter((r) => r.kind === c.kind);
+        const last = same.at(-1);
+        if (c.kind === "tests" && rerun) {
+            if (!rerun.ok)
+                return { ...c, status: "contradicted", why: `the tests fail in a clean checkout${rerun.counts ? ` (${rerun.counts.failed} failed)` : ""}` };
+            if (c.passed !== undefined && rerun.counts && rerun.counts.passed < c.passed)
+                return { ...c, status: "contradicted", why: `said ${c.passed} pass; ${rerun.counts.passed} did` };
+            return { ...c, status: "supported", why: rerun.counts ? `${rerun.counts.passed} passed in a clean checkout` : "the tests pass in a clean checkout" };
+        }
+        if (!last)
+            return { ...c, status: "contradicted", why: `no ${c.kind === "tests" ? "test" : c.kind} command ran this turn` };
+        if (!last.ok)
+            return { ...c, status: "contradicted", why: `the last ${c.kind} command failed${last.exitCode !== null ? ` (exit ${last.exitCode})` : ""}: ${last.command.slice(0, 80)}` };
+        if (c.kind === "tests" && c.passed !== undefined && last.counts && last.counts.passed < c.passed)
+            return { ...c, status: "contradicted", why: `said ${c.passed} pass; the run showed ${last.counts.passed}` };
+        return { ...c, status: "supported", why: `${last.command.slice(0, 80)} succeeded` };
+    });
+    const contradicted = checks.filter((c) => c.status === "contradicted");
+    let verdict;
+    if (contradicted.length || (rerun && !rerun.ok))
+        verdict = "contradicted";
+    else if (rerun?.ok)
+        verdict = "verified";
+    else if (checks.length && checks.every((c) => c.status === "supported"))
+        verdict = "verified";
+    else
+        verdict = "unverified";
+    const headline = verdict === "contradicted"
+        ? contradicted[0] ? `Claimed “${contradicted[0].text.slice(0, 60)}” — ${contradicted[0].why}` : `The tests fail in a clean checkout${rerun?.counts ? `: ${rerun.counts.failed} failed` : ""}`
+        : verdict === "verified"
+            ? rerun?.ok ? `Verified: ${rerun.counts ? `${rerun.counts.passed} tests pass` : "the tests pass"} in a clean checkout` : "Verified against the commands it ran"
+            : rerun === null && !claims.length ? "Nothing to verify: no claims and no test command" : "Unverified: no test command to check it against";
+    return { verdict, headline, claims: checks, ran, rerun };
+}
+//# sourceMappingURL=proof.js.map

package/dist/core/proof.js.map

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

package/dist/core/provider-text.d.ts

@@ -0,0 +1,23 @@
+/**
+ * One short completion from a configured provider (ollama, OpenRouter, …) —
+ * the non-Claude twin of claude-cli.ts's claudeText, for Loom's own small
+ * jobs (the memory extractor). `pool:free` takes the next few free models in
+ * the rotation, so a busy one doesn't fail the job, and stops at the daily cap.
+ */
+/** "ollama/qwen3:4b" → provider "ollama", model "qwen3:4b"; null when the prefix isn't a provider. */
+export declare function providerModel(ref: string): {
+    provider: string;
+    model: string;
+} | null;
+export declare function providerText(ref: string, prompt: string, opts?: {
+    timeoutMs?: number;
+    fetchImpl?: typeof fetch;
+}): Promise<string>;
+/**
+ * Loom's own small jobs (the memory extractor, LLM handoff briefs, the
+ * dynamic-route router) all come through here: a provider/model runs on that
+ * provider, anything else ("haiku", "sonnet") is a Claude alias.
+ */
+export declare function helperText(model: string, prompt: string, opts?: {
+    timeoutMs?: number;
+}): Promise<string>;

package/dist/core/provider-text.js

@@ -0,0 +1,66 @@
+/**
+ * One short completion from a configured provider (ollama, OpenRouter, …) —
+ * the non-Claude twin of claude-cli.ts's claudeText, for Loom's own small
+ * jobs (the memory extractor). `pool:free` takes the next few free models in
+ * the rotation, so a busy one doesn't fail the job, and stops at the daily cap.
+ */
+import { claudeText } from "./claude-cli.js";
+import { countFreeRequest, freeModels, isDailyCap, isPool, noteCapped, resetAt, rest, rotation } from "./free-pool.js";
+import { chatUrl, explainStatus, requestHeaders, resolveProvider } from "./providers.js";
+/** "ollama/qwen3:4b" → provider "ollama", model "qwen3:4b"; null when the prefix isn't a provider. */
+export function providerModel(ref) {
+    const i = ref.indexOf("/");
+    if (i <= 0)
+        return null;
+    const provider = ref.slice(0, i), model = ref.slice(i + 1);
+    return model && resolveProvider(provider) ? { provider, model } : null;
+}
+export async function providerText(ref, prompt, opts = {}) {
+    const pm = providerModel(ref);
+    if (!pm)
+        throw new Error(`${ref} isn't a configured provider/model`);
+    const p = resolveProvider(pm.provider);
+    const doFetch = opts.fetchImpl ?? fetch;
+    const candidates = isPool(pm.model) ? rotation(await freeModels(p, { fetchImpl: doFetch }), 3) : [pm.model];
+    if (!candidates.length)
+        throw new Error(`${p.label} has no free models to use`);
+    let last = "";
+    for (const model of candidates) {
+        const res = await doFetch(chatUrl(p), {
+            method: "POST",
+            headers: requestHeaders(p),
+            body: JSON.stringify({ model, messages: [{ role: "user", content: prompt }], stream: false, temperature: 0 }),
+            signal: AbortSignal.timeout(opts.timeoutMs ?? 60_000),
+        });
+        if (p.free(model) || isPool(pm.model))
+            countFreeRequest();
+        if (res.ok) {
+            const body = (await res.json());
+            const text = body.choices?.[0]?.message?.content ?? "";
+            if (text.trim())
+                return text;
+            last = `${model} returned nothing`;
+            continue;
+        }
+        const raw = await res.text().catch(() => "");
+        if (isDailyCap(res.status, raw)) {
+            noteCapped(resetAt(res.headers));
+            throw new Error(explainStatus(res.status, raw, p));
+        }
+        last = explainStatus(res.status, raw, p);
+        if (res.status === 429)
+            rest(model);
+        if (!isPool(pm.model))
+            break;
+    }
+    throw new Error(last || `${p.label} didn't answer`);
+}
+/**
+ * Loom's own small jobs (the memory extractor, LLM handoff briefs, the
+ * dynamic-route router) all come through here: a provider/model runs on that
+ * provider, anything else ("haiku", "sonnet") is a Claude alias.
+ */
+export function helperText(model, prompt, opts = {}) {
+    return providerModel(model) ? providerText(model, prompt, opts) : claudeText(prompt, { model, ...(opts.timeoutMs ? { timeoutMs: opts.timeoutMs } : {}) });
+}
+//# sourceMappingURL=provider-text.js.map

package/dist/core/provider-text.js.map

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

package/dist/core/providers.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Where a model agent's turns actually go, and where its key lives.
+ *
+ * Loom's agents have always been CLIs, which bring their own auth. A model
+ * agent (adapters/model.ts) doesn't: it needs a base URL, a key, and whatever
+ * headers that particular service insists on. This is the one place that
+ * knows those things.
+ *
+ * ## Keys are not project config
+ *
+ * `.loom/config.json` is committed in most projects. A key in it is a key in
+ * the repository, and then in the fork, and then in the search index. So the
+ * project config names a PROVIDER — `"provider": "openrouter"` — and the key
+ * lives either in the environment or in `~/.loom/providers.json`, mode 0600,
+ * beside the daemon token that already lives there under the same rule.
+ *
+ * Nothing here returns a key to an HTTP client, logs one, or prints one. What
+ * a person sees is whether a provider is configured and the last four
+ * characters, which is enough to tell two keys apart and not enough to use
+ * one.
+ *
+ * ## Providers differ in ways that matter
+ *
+ * They all speak `/v1/chat/completions`, and then each has a quirk: OpenRouter
+ * wants attribution headers, AgentRouter refuses clients it doesn't recognise,
+ * a local Ollama wants no key at all. Those live in the table rather than in
+ * the adapter, so adding a provider is data.
+ */
+export interface ProviderSpec {
+    id: string;
+    label: string;
+    /** Base URL with no trailing slash and no `/v1` — the paths add it. */
+    baseUrl: string;
+    /** Environment variables checked, in order, before the store. */
+    envKeys: string[];
+    /** Headers this provider needs beyond authorisation. */
+    headers?: Record<string, string>;
+    /** Does this model cost nothing here? A convention, where one exists. */
+    free?: (modelId: string) => boolean;
+    /** Said out loud by `loom providers`, when there's something to know. */
+    note?: string;
+    docs?: string;
+}
+/**
+ * The ones Loom knows by name. Anything else is a custom provider: give it a
+ * base URL and it works, because the protocol is the protocol.
+ */
+export declare const BUILTIN_PROVIDERS: ProviderSpec[];
+/** What's been configured on this machine, by provider id. */
+export interface StoredProvider {
+    key?: string;
+    /** Overrides the built-in base URL, or defines one for a custom provider. */
+    baseUrl?: string;
+    label?: string;
+    /** Extra headers — how a person answers a provider that wants something odd. */
+    headers?: Record<string, string>;
+}
+export declare function providersFile(): string;
+export interface ResolvedProvider {
+    id: string;
+    label: string;
+    baseUrl: string;
+    /** Null when nothing has been configured — callers decide if that's fatal. */
+    key: string | null;
+    headers: Record<string, string>;
+    free: (modelId: string) => boolean;
+    note?: string;
+    docs?: string;
+}
+/** The spec for an id, built-in or stored, or null if nobody has heard of it. */
+export declare function specFor(id: string): ProviderSpec | null;
+/**
+ * Everything needed to make a call: URL, key, headers.
+ *
+ * The environment wins over the stored file, so a shell that sets a key for
+ * one run doesn't have to undo anything afterwards.
+ */
+export declare function resolveProvider(id: string, env?: NodeJS.ProcessEnv): ResolvedProvider | null;
+/** Save a key, a base URL, headers — any subset. Writes 0600. */
+export declare function setProvider(id: string, patch: StoredProvider): void;
+export declare function forgetProvider(id: string): boolean;
+/** The last four characters, which tells two keys apart and uses neither. */
+export declare function maskKey(key: string | null): string;
+export interface ProviderSummary {
+    id: string;
+    label: string;
+    baseUrl: string;
+    configured: boolean;
+    /** Masked. There is no code path that returns the key itself. */
+    hint: string;
+    /** Where the key came from, so "why is it still the old one" is answerable. */
+    source: "env" | "file" | "none";
+    note?: string;
+    docs?: string;
+}
+/** Every provider Loom knows or has been told about, and whether it can be used. */
+export declare function listProviders(env?: NodeJS.ProcessEnv): ProviderSummary[];
+export declare function chatUrl(p: ResolvedProvider): string;
+export declare function modelsUrl(p: ResolvedProvider): string;
+/**
+ * Headers for a request. A provider with no key gets none — a local server
+ * doesn't want `Authorization: Bearer null`, which is a 401 that reads like a
+ * bad key rather than like no key.
+ */
+export declare function requestHeaders(p: ResolvedProvider): Record<string, string>;
+/**
+ * Turn a provider's refusal into something a person can act on.
+ *
+ * These four are the ones worth naming: they're the difference between "your
+ * key is wrong", "your free quota is spent", "that model is gone" and "slow
+ * down", and each has a different next step.
+ */
+export declare function explainStatus(status: number, body: string, p: ResolvedProvider): string;
+/** Is this the kind of failure another model on the same key might survive? */
+export declare function isExhausted(status: number): boolean;
+export interface ProviderModel {
+    id: string;
+    provider: string;
+    /** Free on this provider, by that provider's own convention. */
+    free: boolean;
+    /** AgentRouter reports these per model; most providers don't. */
+    endpoints?: string[];
+}
+/** How long a model list is believed before asking again. */
+export declare const MODELS_TTL_MS: number;
+/**
+ * The models a provider has right now.
+ *
+ * Cached on disk rather than in memory: the CLI is a new process every time,
+ * and asking a provider for its catalogue once per command is rude to them and
+ * slow for you. `refresh` skips the cache — which is what a model that has
+ * just appeared (or vanished) needs.
+ */
+export declare function fetchModels(p: ResolvedProvider, opts?: {
+    refresh?: boolean;
+    fetchImpl?: typeof fetch;
+}): Promise<{
+    models: ProviderModel[];
+    cached: boolean;
+    error?: string;
+}>;
+/** Every configured provider's models, for a picker that spans providers. */
+export declare function allModels(opts?: {
+    refresh?: boolean;
+    env?: NodeJS.ProcessEnv;
+}): Promise<{
+    models: ProviderModel[];
+    errors: Array<{
+        provider: string;
+        error: string;
+    }>;
+}>;