@oxagen/cli 0.5.0 → 0.6.0

package/dist/agent/__tests__/prompt-enhancer.test.js

@@ -0,0 +1,107 @@
+/**
+ * Prompt enhancement — proves a raw prompt is enriched with real code-graph
+ * context (symbol definitions, file symbols, dependents) and recalled lessons,
+ * and that it degrades to a no-op when there is nothing to add.
+ */
+import { describe, it, expect, beforeAll, afterAll } from "vitest";
+import { promises as fs } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { extractCandidates, enhancePrompt } from "../prompt-enhancer.js";
+import { clearCodeGraphCache } from "../code-graph.js";
+let root = "";
+beforeAll(async () => {
+    root = await fs.mkdtemp(join(tmpdir(), "oxagen-pe-"));
+    await fs.writeFile(join(root, "alpha.ts"), ["export function computeAlpha() {", "  return 1;", "}"].join("\n"));
+    await fs.writeFile(join(root, "beta.ts"), [
+        'import { computeAlpha } from "./alpha.js";',
+        "export class BetaEngine {}",
+        "export function runBeta() {",
+        "  return computeAlpha();",
+        "}",
+    ].join("\n"));
+    await fs.mkdir(join(root, "sub"), { recursive: true });
+    await fs.writeFile(join(root, "sub", "gamma.ts"), ['import { BetaEngine } from "../beta.js";', "export const g = new BetaEngine();"].join("\n"));
+});
+afterAll(async () => {
+    clearCodeGraphCache();
+    if (root)
+        await fs.rm(root, { recursive: true, force: true });
+});
+describe("extractCandidates", () => {
+    it("pulls backticked symbols and paths, CamelCase and snake_case", () => {
+        const { symbols, paths } = extractCandidates("where is `computeAlpha` defined? look at `src/agent/loop.ts` and the GraphNode type and build_tools fn and edit alpha.ts");
+        expect(symbols).toContain("computeAlpha");
+        expect(symbols).toContain("GraphNode");
+        expect(symbols).toContain("build_tools");
+        expect(paths).toContain("src/agent/loop.ts");
+        expect(paths).toContain("alpha.ts");
+    });
+});
+const noMemory = {
+    record: () => undefined,
+    recall: () => [],
+    all: () => [],
+};
+describe("enhancePrompt", () => {
+    it("retrieves symbol definitions, file symbols and dependents", async () => {
+        const res = await enhancePrompt({
+            prompt: "where is `computeAlpha` defined and what imports `beta.ts`?",
+            cwd: root,
+            memory: noMemory,
+        });
+        expect(res.resolved).toContain("computeAlpha");
+        expect(res.resolved).toContain("beta.ts");
+        expect(res.context).toContain("alpha.ts"); // computeAlpha's definition site
+        expect(res.context).toContain("Symbols in beta.ts");
+        expect(res.context).toContain("sub/gamma.ts"); // dependent of beta.ts
+        // The enhanced prompt keeps the original text and appends the context block.
+        expect(res.prompt.startsWith("where is")).toBe(true);
+        expect(res.prompt).toContain("Relevant code context");
+    });
+    it("injects recalled lessons as a context section", async () => {
+        const lesson = {
+            id: "m1",
+            createdAt: 1,
+            kind: "gotcha",
+            weight: "critical",
+            lesson: "beta.ts must keep its default export",
+            files: ["beta.ts"],
+            outcome: "success",
+        };
+        const memory = { record: () => undefined, recall: () => [lesson], all: () => [] };
+        const res = await enhancePrompt({ prompt: "touch beta.ts", cwd: root, memory });
+        expect(res.lessons).toHaveLength(1);
+        expect(res.context).toContain("Lessons from past work");
+        expect(res.context).toContain("must keep its default export");
+    });
+    it("resolves context from extraQueries even when the prompt names nothing", async () => {
+        const res = await enhancePrompt({
+            prompt: "do the thing",
+            cwd: root,
+            memory: noMemory,
+            extraQueries: ["computeAlpha", "beta.ts"],
+        });
+        expect(res.resolved).toContain("computeAlpha");
+        expect(res.resolved).toContain("beta.ts");
+        expect(res.context).toContain("Relevant code context");
+        // extraQueries sharpen retrieval but never pollute the visible prompt text.
+        expect(res.prompt.startsWith("do the thing")).toBe(true);
+        expect(res.prompt).not.toContain("computeAlpha\n");
+    });
+    it("is a no-op when nothing is found", async () => {
+        const res = await enhancePrompt({ prompt: "hello there friend", cwd: root, memory: noMemory });
+        expect(res.context).toBe("");
+        expect(res.prompt).toBe("hello there friend");
+        expect(res.resolved).toHaveLength(0);
+    });
+    it("never throws and degrades when the cwd is unreadable", async () => {
+        const res = await enhancePrompt({
+            prompt: "look at `Thing`",
+            cwd: join(root, "does-not-exist"),
+            memory: noMemory,
+        });
+        expect(res.prompt).toContain("look at");
+    });
+});
+//# sourceMappingURL=prompt-enhancer.test.js.map

package/dist/agent/__tests__/prompt-enhancer.test.js.map

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

package/dist/agent/__tests__/trace-format.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=trace-format.test.d.ts.map

package/dist/agent/__tests__/trace-format.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-format.test.d.ts","sourceRoot":"","sources":["../../../src/agent/__tests__/trace-format.test.ts"],"names":[],"mappings":""}

package/dist/agent/__tests__/trace-format.test.js

@@ -0,0 +1,104 @@
+/**
+ * Plain-text trace rendering — proves the report includes every section (prompt,
+ * scores, refined prompt, injected context, model, judge rounds) and that the
+ * conditional sections (refined prompt, bare-mode "not judged", the list) behave.
+ */
+import { describe, it, expect, vi } from "vitest";
+vi.mock("../../lib/config.js", () => ({ readConfig: () => ({}) }));
+import { formatTraceText, formatTraceList } from "../trace-format.js";
+function judge(over = {}) {
+    return {
+        complete: false,
+        confidence: 80,
+        findings: ["missing migration"],
+        remainingWork: ["write it"],
+        reasoning: "tests absent",
+        model: "anthropic/claude-opus-4.8",
+        fallback: false,
+        usage: { inputTokens: 0, outputTokens: 0, costUsd: 0 },
+        ...over,
+    };
+}
+function trace(over = {}) {
+    return {
+        id: "turn_1",
+        createdAt: 1,
+        cwd: "/x",
+        originalPrompt: "add a refund route",
+        evaluation: {
+            completeness: 72,
+            complexity: 60,
+            recommendedTier: "balanced",
+            missing: ["which file"],
+            contextQueries: [],
+            refinedPrompt: "add refund route to billing api",
+            removed: ["please"],
+            reasoning: "fairly clear",
+            fallback: false,
+            model: "anthropic/claude-haiku-4.5",
+            usage: { inputTokens: 0, outputTokens: 0, costUsd: 0 },
+        },
+        enhancement: {
+            prompt: "add refund route to billing api\n\n## ctx",
+            context: "## ctx",
+            resolved: ["refundHandler"],
+            lessonCount: 2,
+            source: "code-graph+memory",
+        },
+        selectedModel: "anthropic/claude-opus-4.8",
+        selectedTier: "precise",
+        selectionRationale: "router escalated — billing",
+        response: "added it",
+        filesTouched: ["src/billing/refund.ts"],
+        commandsRun: ["pnpm test"],
+        judgeRounds: [judge(), judge({ complete: true, findings: [], remainingWork: [] })],
+        finalComplete: true,
+        steps: 7,
+        usage: { inputTokens: 100, outputTokens: 50, costUsd: 0.0123 },
+        durationMs: 4200,
+        ...over,
+    };
+}
+describe("formatTraceText", () => {
+    it("renders every section with scores, context, model, and judge rounds", () => {
+        const out = formatTraceText(trace());
+        expect(out).toContain("1 · Original prompt");
+        expect(out).toContain("add a refund route");
+        expect(out).toContain("completeness");
+        expect(out).toContain("72/100");
+        expect(out).toContain("3 · Refined prompt");
+        expect(out).toContain("add refund route to billing api");
+        expect(out).toContain("4 · Injected context · code-graph+memory");
+        expect(out).toContain("refundHandler");
+        expect(out).toContain("5 · Model selected");
+        expect(out).toContain("opus");
+        expect(out).toContain("round 1: INCOMPLETE");
+        expect(out).toContain("round 2: COMPLETE");
+        expect(out).toContain("missing migration");
+        expect(out).toContain("src/billing/refund.ts");
+    });
+    it("omits the refined-prompt section when unchanged, and shows bare-mode judging", () => {
+        const out = formatTraceText(trace({
+            evaluation: { ...trace().evaluation, refinedPrompt: "add a refund route", missing: [], removed: [], reasoning: "" },
+            enhancement: { prompt: "p", context: "", resolved: [], lessonCount: 0, source: "none" },
+            judgeRounds: [],
+        }));
+        expect(out).not.toContain("3 · Refined prompt");
+        expect(out).toContain("no code-graph references resolved");
+        expect(out).toContain("not judged (bare mode)");
+    });
+});
+describe("formatTraceList", () => {
+    it("summarizes newest-first with a status mark", () => {
+        const out = formatTraceList([
+            trace({ id: "a", originalPrompt: "first", finalComplete: true }),
+            trace({ id: "b", originalPrompt: "second", finalComplete: false }),
+        ]);
+        expect(out).toContain("1. ✓ first");
+        expect(out).toContain("2. ✗ second");
+    });
+    it("handles the empty case", () => {
+        expect(formatTraceList([])).toBe("No turns recorded yet.");
+    });
+});
+//# sourceMappingURL=trace-format.test.js.map

package/dist/agent/__tests__/trace-format.test.js.map

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

package/dist/agent/__tests__/trace-store.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=trace-store.test.d.ts.map

package/dist/agent/__tests__/trace-store.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-store.test.d.ts","sourceRoot":"","sources":["../../../src/agent/__tests__/trace-store.test.ts"],"names":[],"mappings":""}

package/dist/agent/__tests__/trace-store.test.js

@@ -0,0 +1,113 @@
+/**
+ * Turn-trace store — proves traces persist newest-first, dedupe by id, stay
+ * bounded, and that `resolve` maps an empty arg / recency index / id / id-prefix
+ * to the right trace. Storage is redirected to a temp HOME so the real config
+ * directory is never touched.
+ */
+import { describe, it, expect, beforeEach, vi } from "vitest";
+import { rmSync } from "node:fs";
+const { TEST_HOME } = vi.hoisted(() => {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const os = require("node:os");
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const fs = require("node:fs");
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const path = require("node:path");
+    return { TEST_HOME: fs.mkdtempSync(path.join(os.tmpdir(), "oxagen-trace-")) };
+});
+vi.mock("node:os", async (orig) => {
+    const actual = await orig();
+    return { ...actual, homedir: () => TEST_HOME };
+});
+import { openTraceStore } from "../trace-store.js";
+function trace(id, prompt = "do a thing") {
+    return {
+        id,
+        createdAt: 1,
+        cwd: "/x",
+        originalPrompt: prompt,
+        evaluation: {
+            completeness: 50,
+            complexity: 50,
+            recommendedTier: "fast",
+            missing: [],
+            contextQueries: [],
+            refinedPrompt: prompt,
+            removed: [],
+            reasoning: "",
+            fallback: false,
+            model: "m",
+            usage: { inputTokens: 0, outputTokens: 0, costUsd: 0 },
+        },
+        enhancement: { prompt, context: "", resolved: [], lessonCount: 0, source: "none" },
+        selectedModel: "anthropic/claude-sonnet-4.6",
+        selectedTier: "balanced",
+        selectionRationale: "test",
+        response: "ok",
+        filesTouched: [],
+        commandsRun: [],
+        judgeRounds: [],
+        finalComplete: true,
+        steps: 1,
+        usage: { inputTokens: 0, outputTokens: 0, costUsd: 0 },
+        durationMs: 10,
+    };
+}
+const cwd = "/tmp/proj-trace-store-test";
+beforeEach(() => {
+    rmSync(`${TEST_HOME}/.config/oxagen/traces/${"proj-trace-store-test"}.json`, { force: true });
+});
+describe("openTraceStore", () => {
+    it("records newest-first and reads back", () => {
+        const store = openTraceStore(cwd);
+        store.record(trace("a"));
+        store.record(trace("b"));
+        const list = store.list();
+        expect(list.map((t) => t.id)).toEqual(["b", "a"]);
+        expect(store.last()?.id).toBe("b");
+        expect(store.get("a")?.id).toBe("a");
+    });
+    it("dedupes by id (re-record updates in place)", () => {
+        const store = openTraceStore(cwd);
+        store.record(trace("a", "first"));
+        store.record(trace("a", "second"));
+        expect(store.list()).toHaveLength(1);
+        expect(store.get("a")?.originalPrompt).toBe("second");
+    });
+    it("bounds history to the most recent 100", () => {
+        const store = openTraceStore(cwd);
+        for (let i = 0; i < 105; i++)
+            store.record(trace(`t${i}`));
+        const list = store.list();
+        expect(list).toHaveLength(100);
+        expect(list[0]?.id).toBe("t104");
+    });
+    it("resolves empty arg to the most recent", () => {
+        const store = openTraceStore(cwd);
+        store.record(trace("a"));
+        store.record(trace("b"));
+        expect(store.resolve("")?.id).toBe("b");
+    });
+    it("resolves a 1-based recency index", () => {
+        const store = openTraceStore(cwd);
+        store.record(trace("a"));
+        store.record(trace("b"));
+        expect(store.resolve("1")?.id).toBe("b");
+        expect(store.resolve("2")?.id).toBe("a");
+        expect(store.resolve("9")).toBeUndefined();
+    });
+    it("resolves by exact id and id prefix", () => {
+        const store = openTraceStore(cwd);
+        store.record(trace("turn_abcdef"));
+        expect(store.resolve("turn_abcdef")?.id).toBe("turn_abcdef");
+        expect(store.resolve("turn_abc")?.id).toBe("turn_abcdef");
+        expect(store.resolve("nope")).toBeUndefined();
+    });
+    it("returns empty results before anything is recorded", () => {
+        const store = openTraceStore("/tmp/proj-empty-xyz");
+        expect(store.list()).toEqual([]);
+        expect(store.last()).toBeUndefined();
+        expect(store.resolve("")).toBeUndefined();
+    });
+});
+//# sourceMappingURL=trace-store.test.js.map

package/dist/agent/__tests__/trace-store.test.js.map

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

package/dist/agent/code-graph.d.ts

@@ -0,0 +1,18 @@
+import type { CodeGraph } from "../daemon/code-graph/types.js";
+export type CodeGraphOperation = "search" | "file_symbols" | "dependents" | "imports";
+/** Build (or reuse) the code graph rooted at `cwd`. One build per cwd per process. */
+export declare function getCodeGraph(cwd: string): Promise<CodeGraph>;
+/** Drop cached graphs (used by tests; also lets a long-lived REPL force a rebuild). */
+export declare function clearCodeGraphCache(): void;
+/**
+ * Run one code-graph operation and return a compact, model-readable string.
+ * `query` is a symbol name for `search`, or a file path for the others.
+ */
+export declare function queryCodeGraph(cwd: string, operation: CodeGraphOperation, query: string, limit?: number): Promise<string>;
+/** Index summary for a one-line "indexed N files / M symbols" message. */
+export declare function codeGraphStats(cwd: string): Promise<{
+    files: number;
+    symbols: number;
+    edges: number;
+}>;
+//# sourceMappingURL=code-graph.d.ts.map

package/dist/agent/code-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-graph.d.ts","sourceRoot":"","sources":["../../src/agent/code-graph.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,SAAS,EAAY,MAAM,+BAA+B,CAAC;AAEzE,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,GACR,cAAc,GACd,YAAY,GACZ,SAAS,CAAC;AAId,sFAAsF;AACtF,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAO5D;AAED,uFAAuF;AACvF,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AA6BD;;;GAGG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,kBAAkB,EAC7B,KAAK,EAAE,MAAM,EACb,KAAK,SAAK,GACT,OAAO,CAAC,MAAM,CAAC,CAyCjB;AAED,0EAA0E;AAC1E,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAS5D"}

package/dist/agent/code-graph.js

@@ -0,0 +1,119 @@
+/**
+ * Code-graph retrieval for the agent loop.
+ *
+ * Wraps the daemon's code-graph builder/query API with a per-cwd, in-process
+ * cache so a coding turn can ask *structural* questions about the repository —
+ * "where is X defined?", "what imports this file?" — instead of blind grep.
+ *
+ * The graph is built lazily on first use (~2s for a large monorepo) and reused
+ * for the rest of the process. The daemon, when running, keeps a warmer copy;
+ * this path makes the capability work with or without it, which is what lets
+ * `oxagen` dogfood itself on this repo from a cold start.
+ */
+import { buildCodeGraph } from "../daemon/code-graph/builder.js";
+import { searchSymbols, dependents, imports as importsOf, } from "../daemon/code-graph/query.js";
+const cache = new Map();
+/** Build (or reuse) the code graph rooted at `cwd`. One build per cwd per process. */
+export function getCodeGraph(cwd) {
+    let graph = cache.get(cwd);
+    if (!graph) {
+        graph = buildCodeGraph(cwd);
+        cache.set(cwd, graph);
+    }
+    return graph;
+}
+/** Drop cached graphs (used by tests; also lets a long-lived REPL force a rebuild). */
+export function clearCodeGraphCache() {
+    cache.clear();
+}
+/** Resolve a user-supplied path to a file node: exact rel-path first, then suffix match. */
+function fileNodeFor(graph, query) {
+    const q = query.replace(/^\.\//, "");
+    let suffixMatch = null;
+    for (const node of graph.nodes.values()) {
+        if (node.kind !== "file")
+            continue;
+        if (node.path === q)
+            return node;
+        if (!suffixMatch && (node.path === q || node.path.endsWith(`/${q}`))) {
+            suffixMatch = node;
+        }
+    }
+    return suffixMatch;
+}
+/** Symbols a file directly contains (functions/classes/types extracted from it). */
+function symbolsInFile(graph, fileNode) {
+    return graph.edges
+        .filter((e) => e.source === fileNode.id && e.type === "contains")
+        .map((e) => graph.nodes.get(e.target))
+        .filter((n) => n !== undefined);
+}
+function formatSymbol(node) {
+    const sig = node.signature ? `  ${node.signature}` : "";
+    return `${node.kind} ${node.name} — ${node.path}:${node.range.start}${sig}`;
+}
+/**
+ * Run one code-graph operation and return a compact, model-readable string.
+ * `query` is a symbol name for `search`, or a file path for the others.
+ */
+export async function queryCodeGraph(cwd, operation, query, limit = 25) {
+    const graph = await getCodeGraph(cwd);
+    switch (operation) {
+        case "search": {
+            const hits = searchSymbols(graph, query, limit);
+            if (hits.length === 0)
+                return `No symbols matching "${query}".`;
+            return hits.map(formatSymbol).join("\n");
+        }
+        case "file_symbols": {
+            const file = fileNodeFor(graph, query);
+            if (!file)
+                return `No file matching "${query}".`;
+            const syms = symbolsInFile(graph, file).slice(0, limit);
+            if (syms.length === 0) {
+                return `${file.path}: (no top-level symbols extracted)`;
+            }
+            return `${file.path}:\n${syms.map(formatSymbol).join("\n")}`;
+        }
+        case "dependents": {
+            const file = fileNodeFor(graph, query);
+            if (!file)
+                return `No file matching "${query}".`;
+            const deps = dependents(graph, file.id);
+            if (deps.length === 0)
+                return `Nothing imports ${file.path}.`;
+            const paths = deps
+                .map((n) => n.path)
+                .sort()
+                .slice(0, limit);
+            return `Files importing ${file.path} (${deps.length}):\n${paths.join("\n")}`;
+        }
+        case "imports": {
+            const file = fileNodeFor(graph, query);
+            if (!file)
+                return `No file matching "${query}".`;
+            const imps = importsOf(graph, file.id);
+            if (imps.length === 0)
+                return `${file.path} has no resolved local imports.`;
+            const paths = imps
+                .map((n) => n.path)
+                .sort()
+                .slice(0, limit);
+            return `${file.path} imports (${imps.length}):\n${paths.join("\n")}`;
+        }
+    }
+}
+/** Index summary for a one-line "indexed N files / M symbols" message. */
+export async function codeGraphStats(cwd) {
+    const graph = await getCodeGraph(cwd);
+    let files = 0;
+    let symbols = 0;
+    for (const node of graph.nodes.values()) {
+        if (node.kind === "file")
+            files++;
+        else
+            symbols++;
+    }
+    return { files, symbols, edges: graph.edges.length };
+}
+//# sourceMappingURL=code-graph.js.map

package/dist/agent/code-graph.js.map

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

package/dist/agent/env.d.ts

@@ -0,0 +1,11 @@
+/** Thrown when no gateway credential can be resolved anywhere. */
+export declare class MissingGatewayKeyError extends Error {
+    constructor();
+}
+/**
+ * Ensure `AI_GATEWAY_API_KEY` is set in `process.env`, resolving it from config
+ * or a nearby `.env.local` if needed. Returns the key, or `null` if it could
+ * not be found anywhere.
+ */
+export declare function ensureGatewayKey(cwd?: string): string | null;
+//# sourceMappingURL=env.d.ts.map

package/dist/agent/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/agent/env.ts"],"names":[],"mappings":"AAoBA,kEAAkE;AAClE,qBAAa,sBAAuB,SAAQ,KAAK;;CAQhD;AAgCD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,GAAG,IAAI,CAiB3E"}

package/dist/agent/env.js

@@ -0,0 +1,82 @@
+/**
+ * Gateway credential resolution.
+ *
+ * The local agent loop talks to the Vercel AI Gateway (same gateway the rest of
+ * the platform uses — see the `ai-gateway-only` policy). The AI SDK reads
+ * `AI_GATEWAY_API_KEY` from the environment automatically, so all we need to do
+ * is make sure it is present before the first model call.
+ *
+ * Resolution order:
+ *   1. `AI_GATEWAY_API_KEY` already in the process environment.
+ *   2. `gatewayKey` in `~/.config/oxagen/config.json`.
+ *   3. The nearest `.env.local` walking up from the current working directory
+ *      (so running `oxagen` from inside the monorepo "just works").
+ */
+import { readFileSync, existsSync } from "node:fs";
+import { dirname, join, parse as parsePath } from "node:path";
+import { readConfig } from "../lib/config.js";
+const ENV_VAR = "AI_GATEWAY_API_KEY";
+/** Thrown when no gateway credential can be resolved anywhere. */
+export class MissingGatewayKeyError extends Error {
+    constructor() {
+        super("No AI_GATEWAY_API_KEY found. Set it in your shell, in ~/.config/oxagen/config.json " +
+            '("gatewayKey"), or in a .env.local above the working directory.');
+        this.name = "MissingGatewayKeyError";
+    }
+}
+function findInEnvLocal(startDir) {
+    let dir = startDir;
+    const { root } = parsePath(startDir);
+    // Walk up to the filesystem root looking for a .env.local that defines the key.
+    for (;;) {
+        const candidate = join(dir, ".env.local");
+        if (existsSync(candidate)) {
+            try {
+                const text = readFileSync(candidate, "utf8");
+                for (const line of text.split("\n")) {
+                    const trimmed = line.trim();
+                    if (!trimmed || trimmed.startsWith("#"))
+                        continue;
+                    const eq = trimmed.indexOf("=");
+                    if (eq === -1)
+                        continue;
+                    if (trimmed.slice(0, eq).trim() !== ENV_VAR)
+                        continue;
+                    // Strip surrounding quotes (loadEnv-style over-quoting is common here).
+                    return trimmed
+                        .slice(eq + 1)
+                        .trim()
+                        .replace(/^["']|["']$/g, "");
+                }
+            }
+            catch {
+                /* unreadable .env.local — keep walking up */
+            }
+        }
+        if (dir === root)
+            return undefined;
+        dir = dirname(dir);
+    }
+}
+/**
+ * Ensure `AI_GATEWAY_API_KEY` is set in `process.env`, resolving it from config
+ * or a nearby `.env.local` if needed. Returns the key, or `null` if it could
+ * not be found anywhere.
+ */
+export function ensureGatewayKey(cwd = process.cwd()) {
+    const fromEnv = process.env[ENV_VAR];
+    if (fromEnv && fromEnv.length > 0)
+        return fromEnv;
+    const fromConfig = readConfig().gatewayKey;
+    if (fromConfig && fromConfig.length > 0) {
+        process.env[ENV_VAR] = fromConfig;
+        return fromConfig;
+    }
+    const fromFile = findInEnvLocal(cwd);
+    if (fromFile && fromFile.length > 0) {
+        process.env[ENV_VAR] = fromFile;
+        return fromFile;
+    }
+    return null;
+}
+//# sourceMappingURL=env.js.map

package/dist/agent/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/agent/env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,WAAW,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,MAAM,OAAO,GAAG,oBAAoB,CAAC;AAErC,kEAAkE;AAClE,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC/C;QACE,KAAK,CACH,qFAAqF;YACnF,iEAAiE,CACpE,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED,SAAS,cAAc,CAAC,QAAgB;IACtC,IAAI,GAAG,GAAG,QAAQ,CAAC;IACnB,MAAM,EAAE,IAAI,EAAE,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IACrC,gFAAgF;IAChF,SAAS,CAAC;QACR,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;QAC1C,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;gBAC7C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;oBACpC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;oBAC5B,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;wBAAE,SAAS;oBAClD,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;oBAChC,IAAI,EAAE,KAAK,CAAC,CAAC;wBAAE,SAAS;oBACxB,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,OAAO;wBAAE,SAAS;oBACtD,wEAAwE;oBACxE,OAAO,OAAO;yBACX,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC;yBACb,IAAI,EAAE;yBACN,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;gBACjC,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,6CAA6C;YAC/C,CAAC;QACH,CAAC;QACD,IAAI,GAAG,KAAK,IAAI;YAAE,OAAO,SAAS,CAAC;QACnC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IAC1D,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACrC,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,OAAO,CAAC;IAElD,MAAM,UAAU,GAAG,UAAU,EAAE,CAAC,UAAU,CAAC;IAC3C,IAAI,UAAU,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,UAAU,CAAC;QAClC,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,QAAQ,CAAC;QAChC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/agent/evaluator.d.ts

@@ -0,0 +1,13 @@
+import type { PromptEvaluation } from "./trace.js";
+export interface EvaluatePromptOptions {
+    prompt: string;
+    /** Override the evaluator model slug (otherwise the fast tier). */
+    model?: string;
+    signal?: AbortSignal;
+}
+/**
+ * Evaluate a prompt with the cheap model. Returns the model's structured read, or
+ * a heuristic fallback that never throws — the pipeline must always make progress.
+ */
+export declare function evaluatePrompt(opts: EvaluatePromptOptions): Promise<PromptEvaluation>;
+//# sourceMappingURL=evaluator.d.ts.map

package/dist/agent/evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluator.d.ts","sourceRoot":"","sources":["../../src/agent/evaluator.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AA0DnD,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AA+CD;;;GAGG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,gBAAgB,CAAC,CA6B3B"}