@oxagen/cli 0.5.0 → 0.6.1

package/dist/agent/trace-store.js

@@ -0,0 +1,82 @@
+/**
+ * Turn-trace persistence — durable storage for the pipeline's per-turn records.
+ *
+ * Traces live as JSON under `~/.config/oxagen/traces/<project>.json` (one file per
+ * project, keyed by the working-directory name, consistent with the fleet store).
+ * Persisting them is what makes `/replay` work across turns and even across
+ * sessions: the user can always pull up the original prompt, the enhanced prompt,
+ * the model that was selected, the advisor that judged it, and the full chain of
+ * thought for any recent turn.
+ */
+import { mkdirSync, readFileSync, writeFileSync, existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { basename, dirname, join } from "node:path";
+/** Keep history bounded — the most recent N turns are plenty for replay. */
+const MAX_TRACES = 100;
+function projectKey(cwd) {
+    return basename(cwd) || "default";
+}
+function storePath(cwd) {
+    return join(homedir(), ".config", "oxagen", "traces", `${projectKey(cwd)}.json`);
+}
+function read(cwd) {
+    const path = storePath(cwd);
+    if (!existsSync(path))
+        return { traces: [] };
+    try {
+        const parsed = JSON.parse(readFileSync(path, "utf8"));
+        return { traces: Array.isArray(parsed.traces) ? parsed.traces : [] };
+    }
+    catch {
+        return { traces: [] };
+    }
+}
+function write(cwd, data) {
+    const path = storePath(cwd);
+    try {
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, JSON.stringify(data, null, 2), "utf8");
+    }
+    catch {
+        /* persistence is best-effort — a failed write must never break a turn */
+    }
+}
+/** Open the trace store for a working directory. */
+export function openTraceStore(cwd) {
+    return {
+        record(trace) {
+            const data = read(cwd);
+            const idx = data.traces.findIndex((t) => t.id === trace.id);
+            if (idx >= 0)
+                data.traces[idx] = trace;
+            else
+                data.traces.unshift(trace);
+            data.traces = data.traces.slice(0, MAX_TRACES);
+            write(cwd, data);
+        },
+        get(id) {
+            return read(cwd).traces.find((t) => t.id === id);
+        },
+        list() {
+            return read(cwd).traces;
+        },
+        last() {
+            return read(cwd).traces[0];
+        },
+        resolve(arg) {
+            const traces = read(cwd).traces;
+            const trimmed = arg.trim();
+            if (!trimmed)
+                return traces[0];
+            // A small positive integer is a 1-based recency index.
+            if (/^\d{1,3}$/.test(trimmed)) {
+                const n = Number.parseInt(trimmed, 10);
+                if (n >= 1 && n <= traces.length)
+                    return traces[n - 1];
+            }
+            return (traces.find((t) => t.id === trimmed) ??
+                traces.find((t) => t.id.startsWith(trimmed)));
+        },
+    };
+}
+//# sourceMappingURL=trace-store.js.map

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

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

package/dist/agent/trace.d.ts

@@ -0,0 +1,180 @@
+/**
+ * Turn-trace types — the spine of the CLI's evaluation → enhancement → judging
+ * pipeline and the data the `/replay` command renders.
+ *
+ * Every user prompt becomes a {@link TurnTrace}: what the user typed, how the
+ * cheap evaluator scored it, the context the enhancer injected, which model was
+ * selected and why, what the advisor judge concluded about completeness, and the
+ * full chain of thought from each stage. The trace is persisted so the whole
+ * process stays inspectable after the fact — nothing about how the agent reached
+ * its answer is hidden from the user.
+ *
+ * These types are framework-free (no Ink, no AI SDK) so the engine, the store,
+ * and their tests never import a renderer or hit the gateway.
+ */
+import type { ModelTier, UsageTotals } from "./fleet/types.js";
+/** A stage of the turn pipeline, in execution order. */
+export type StageKind = "evaluate" | "enhance" | "route" | "execute" | "judge" | "revise" | "complete";
+/**
+ * A live progress event the pipeline emits at each stage so the REPL can show
+ * the user exactly what is happening, in real time.
+ */
+export interface StageEvent {
+    kind: StageKind;
+    /** One-line, human-readable label for the status stream. */
+    label: string;
+    /** Optional extra detail (a model slug, a score, a verdict). */
+    detail?: string;
+}
+/**
+ * The cheap model's read of the user's prompt: how complete and how complex it
+ * is, what context to pull, and a noise-removed rewrite.
+ */
+export interface PromptEvaluation {
+    /** 0–100: how complete/actionable the prompt is on its own. */
+    completeness: number;
+    /** 0–100: how much work / risk / blast-radius the request implies. */
+    complexity: number;
+    /** Tier the evaluator recommends for the work. */
+    recommendedTier: ModelTier;
+    /** Information the prompt is missing (empty when it is self-contained). */
+    missing: string[];
+    /** Symbols / file paths / topics worth retrieving from the code graph. */
+    contextQueries: string[];
+    /** The prompt rewritten: filler removed, intent sharpened, meaning preserved. */
+    refinedPrompt: string;
+    /** What was pruned from the original prompt, and (briefly) why. */
+    removed: string[];
+    /** The evaluator's chain of thought. */
+    reasoning: string;
+    /** True when the scores came from the heuristic fallback (model unavailable). */
+    fallback: boolean;
+    /** Model slug used for the evaluation. */
+    model: string;
+    usage: UsageTotals;
+}
+/** Which candidates the enhancer mined and which actually resolved. */
+export interface ContextRetrieval {
+    /** Symbol-like candidates queried against the code graph. */
+    symbolsQueried: string[];
+    /** File-path candidates queried against the code graph. */
+    pathsQueried: string[];
+    /** Candidates that resolved to something real. */
+    resolved: string[];
+    /** Candidates that resolved to nothing (no code-graph hit). */
+    unresolved: string[];
+}
+/** What the enhancer added to the prompt before handing it to the executor. */
+export interface EnhancementTrace {
+    /** The final prompt handed to the executor (refined + injected context). */
+    prompt: string;
+    /** The injected context block alone (empty when nothing was found). */
+    context: string;
+    /** Symbol/path tokens that resolved to something in the code graph. */
+    resolved: string[];
+    /** How many past-work lessons were recalled and injected. */
+    lessonCount: number;
+    /** Where the injected context came from. */
+    source: "none" | "code-graph" | "memory" | "code-graph+memory";
+    /** Epoch ms the context-gathering started (verbose turns). */
+    startedAt?: number;
+    /** Epoch ms the context-gathering finished (verbose turns). */
+    finishedAt?: number;
+    /** Wall-clock ms spent gathering + injecting context. */
+    durationMs?: number;
+    /** Per-candidate retrieval breakdown (verbose turns). */
+    retrieval?: ContextRetrieval;
+}
+/**
+ * Timing + model + cost for one pipeline phase — the headline of verbose mode.
+ * One per phase occurrence (so each execute/judge revision round gets its own).
+ */
+export interface PhaseStat {
+    /** Which phase: evaluate | enhance | route | execute | judge. */
+    phase: StageKind;
+    /** Round index for repeated phases (execute/judge); 0 for single-shot phases. */
+    round: number;
+    startedAt: number;
+    finishedAt: number;
+    durationMs: number;
+    /** The model that did this phase's work (absent for non-LLM phases). */
+    model?: string;
+    /** Tokens + dollar cost attributable to this phase (zero for non-LLM phases). */
+    usage: UsageTotals;
+}
+/** One tool invocation: what was called, with what, what came back, how long. */
+export interface ToolEvent {
+    name: string;
+    /** Tool input, JSON-stringified and truncated. */
+    input: string;
+    /** Tool result, JSON-stringified and truncated (verbose turns). */
+    result?: string;
+    startedAt: number;
+    finishedAt: number;
+    durationMs: number;
+    /** False when the tool reported an error. */
+    ok: boolean;
+}
+/** The advisor judge's verdict on whether the agent's work is actually done. */
+export interface JudgeVerdict {
+    /** True only when every part of the request was addressed with real changes. */
+    complete: boolean;
+    /** 0–100 confidence in the verdict. */
+    confidence: number;
+    /** Concrete gaps the judge found (empty when complete). */
+    findings: string[];
+    /** What the agent still needs to do (empty when complete). */
+    remainingWork: string[];
+    /** The judge's chain of thought. */
+    reasoning: string;
+    /** Model slug used for the judgement — always distinct from the executor. */
+    model: string;
+    /** True when the verdict came from the heuristic fallback (model unavailable). */
+    fallback: boolean;
+    usage: UsageTotals;
+}
+/**
+ * The complete record of one turn through the pipeline. Persisted by the trace
+ * store and rendered by `/replay`.
+ */
+export interface TurnTrace {
+    id: string;
+    createdAt: number;
+    cwd: string;
+    /** Exactly what the user typed, verbatim. */
+    originalPrompt: string;
+    evaluation: PromptEvaluation;
+    enhancement: EnhancementTrace;
+    /** Concrete gateway model slug chosen for execution. */
+    selectedModel: string;
+    /** Tier of the selected executor model. */
+    selectedTier: ModelTier;
+    /** One-line reason the executor model was chosen. */
+    selectionRationale: string;
+    /** The agent's final assistant text (truncated for storage). */
+    response: string;
+    /** Relative paths the agent wrote or edited, from tool activity. */
+    filesTouched: string[];
+    /** Shell commands the agent ran, from tool activity. */
+    commandsRun: string[];
+    /** One verdict per judge round; index 0 is the initial completeness check. */
+    judgeRounds: JudgeVerdict[];
+    /** Whether the pipeline drove the agent to a state the judge calls complete. */
+    finalComplete: boolean;
+    /** Tool-loop steps taken across all execution rounds. */
+    steps: number;
+    /** Token + cost totals across evaluator + executor + judge calls. */
+    usage: UsageTotals;
+    durationMs: number;
+    /**
+     * Per-phase timing + model + token/cost breakdown. Present on verbose turns;
+     * lets you see exactly which model spent which dollars on which phase (enhance
+     * vs work vs review) and how long each took. Optional for backward-compat.
+     */
+    phases?: PhaseStat[];
+    /** Every tool call + result with timing (verbose turns). */
+    toolEvents?: ToolEvent[];
+    /** True when this turn was captured in verbose mode. */
+    verbose?: boolean;
+}
+//# sourceMappingURL=trace.d.ts.map

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

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

package/dist/agent/trace.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=trace.js.map

package/dist/agent/trace.js.map

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

package/dist/agent/verbose-log.d.ts

@@ -0,0 +1,8 @@
+import type { TurnTrace } from "./trace.js";
+/** Path of the JSONL verbose log for a working directory. */
+export declare function verboseLogPath(cwd: string): string;
+/** Append one turn's trace to the verbose JSONL stream. Best-effort. */
+export declare function appendVerboseLog(cwd: string, trace: TurnTrace): void;
+/** Read every record from the verbose JSONL stream (skipping malformed lines). */
+export declare function readVerboseLog(cwd: string): TurnTrace[];
+//# sourceMappingURL=verbose-log.d.ts.map

package/dist/agent/verbose-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verbose-log.d.ts","sourceRoot":"","sources":["../../src/agent/verbose-log.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAM5C,6DAA6D;AAC7D,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wEAAwE;AACxE,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI,CAQpE;AAED,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,CAcvD"}

package/dist/agent/verbose-log.js

@@ -0,0 +1,53 @@
+/**
+ * Verbose structured-log stream.
+ *
+ * When a session runs in `/verbose` mode, every turn's full {@link TurnTrace} is
+ * appended — one JSON object per line (JSONL) — to a per-project log under
+ * `~/.config/oxagen/verbose/<project>.jsonl`. Unlike the trace *store* (which is
+ * capped at the latest 100 turns for `/replay`), this stream is append-only and
+ * complete: it is the machine-readable record you analyze to prove the agent is
+ * fast, cheap, and self-improving — feed it to `jq`, a notebook, or a dashboard.
+ *
+ * Writes are best-effort: a failed log write must never break a turn.
+ */
+import { appendFileSync, mkdirSync, existsSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { basename, dirname, join } from "node:path";
+function projectKey(cwd) {
+    return basename(cwd) || "default";
+}
+/** Path of the JSONL verbose log for a working directory. */
+export function verboseLogPath(cwd) {
+    return join(homedir(), ".config", "oxagen", "verbose", `${projectKey(cwd)}.jsonl`);
+}
+/** Append one turn's trace to the verbose JSONL stream. Best-effort. */
+export function appendVerboseLog(cwd, trace) {
+    const path = verboseLogPath(cwd);
+    try {
+        mkdirSync(dirname(path), { recursive: true });
+        appendFileSync(path, JSON.stringify(trace) + "\n", "utf8");
+    }
+    catch {
+        /* logging is best-effort — never break a turn over it */
+    }
+}
+/** Read every record from the verbose JSONL stream (skipping malformed lines). */
+export function readVerboseLog(cwd) {
+    const path = verboseLogPath(cwd);
+    if (!existsSync(path))
+        return [];
+    const out = [];
+    for (const line of readFileSync(path, "utf8").split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        try {
+            out.push(JSON.parse(trimmed));
+        }
+        catch {
+            /* skip a corrupt/partial line rather than failing the whole read */
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=verbose-log.js.map

package/dist/agent/verbose-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verbose-log.js","sourceRoot":"","sources":["../../src/agent/verbose-log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC9E,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGpD,SAAS,UAAU,CAAC,GAAW;IAC7B,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC;AACpC,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AACrF,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,gBAAgB,CAAC,GAAW,EAAE,KAAgB;IAC5D,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,CAAC;QACH,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,yDAAyD;IAC3D,CAAC;AACH,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,MAAM,GAAG,GAAgB,EAAE,CAAC;IAC5B,KAAK,MAAM,IAAI,IAAI,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1D,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO;YAAE,SAAS;QACvB,IAAI,CAAC;YACH,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAc,CAAC,CAAC;QAC7C,CAAC;QAAC,MAAM,CAAC;YACP,oEAAoE;QACtE,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/agents/__tests__/loader.test.d.ts

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

package/dist/agents/__tests__/loader.test.d.ts.map

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

package/dist/agents/__tests__/loader.test.js

@@ -0,0 +1,88 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { mkdtempSync, mkdirSync, writeFileSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { loadAgents, getAgent, parseFrontmatter } from "../loader.js";
+import { clearSettingsCache } from "../../settings/resolve.js";
+let dir;
+let userDir;
+let userSettings;
+function writeAgent(rel, body) {
+    const path = join(dir, rel);
+    mkdirSync(join(path, ".."), { recursive: true });
+    writeFileSync(path, body, "utf8");
+}
+function load() {
+    return loadAgents({
+        cwd: dir,
+        userAgentsDir: userDir,
+        settingsOptions: { userSettingsPath: userSettings },
+    });
+}
+beforeEach(() => {
+    dir = mkdtempSync(join(tmpdir(), "oxagen-agents-"));
+    userDir = join(dir, "user-agents");
+    userSettings = join(dir, "user-settings.json");
+    clearSettingsCache();
+});
+afterEach(() => {
+    rmSync(dir, { recursive: true, force: true });
+    clearSettingsCache();
+});
+describe("parseFrontmatter", () => {
+    it("splits frontmatter and body", () => {
+        const { data, body } = parseFrontmatter("---\nname: x\ndescription: hi\n---\nThe prompt.");
+        expect(data["name"]).toBe("x");
+        expect(data["description"]).toBe("hi");
+        expect(body).toBe("The prompt.");
+    });
+    it("treats content without frontmatter as all body", () => {
+        expect(parseFrontmatter("just a prompt").body).toBe("just a prompt");
+    });
+    it("strips quotes from values", () => {
+        expect(parseFrontmatter('---\nmodel: "a/b"\n---\nx').data["model"]).toBe("a/b");
+    });
+});
+describe("loadAgents", () => {
+    it("loads an agent from .oxagen/agents and parses frontmatter + tools", () => {
+        writeAgent(".oxagen/agents/reviewer.md", "---\nname: reviewer\ndescription: Reviews code\ntools: Read, Grep\nmodel: a/b\n---\nYou review code.");
+        const agent = load().get("reviewer");
+        expect(agent?.description).toBe("Reviews code");
+        expect(agent?.tools).toEqual(["Read", "Grep"]);
+        expect(agent?.model).toBe("a/b");
+        expect(agent?.systemPrompt).toBe("You review code.");
+    });
+    it("parses a bracketed tools list", () => {
+        writeAgent(".oxagen/agents/a.md", "---\ntools: [Read, Bash]\n---\nbody");
+        expect(load().get("a")?.tools).toEqual(["Read", "Bash"]);
+    });
+    it("defaults the name to the filename and tools to undefined", () => {
+        writeAgent(".oxagen/agents/helper.md", "---\ndescription: d\n---\nbody");
+        const a = load().get("helper");
+        expect(a?.name).toBe("helper");
+        expect(a?.tools).toBeUndefined();
+    });
+    it(".oxagen overrides .claude overrides user, and settings.agents overrides files", () => {
+        mkdirSync(userDir, { recursive: true });
+        writeFileSync(join(userDir, "r.md"), "---\nname: r\n---\nuser version");
+        writeAgent(".claude/agents/r.md", "---\nname: r\n---\nclaude version");
+        expect(load().get("r")?.systemPrompt).toBe("claude version");
+        writeAgent(".oxagen/agents/r.md", "---\nname: r\n---\noxagen version");
+        expect(load().get("r")?.systemPrompt).toBe("oxagen version");
+        writeFileSync(userSettings, JSON.stringify({ agents: { r: { prompt: "inline version" } } }));
+        clearSettingsCache();
+        const a = load().get("r");
+        expect(a?.systemPrompt).toBe("inline version");
+        expect(a?.source).toBe("settings.json");
+    });
+    it("ignores files with no name or no body", () => {
+        writeAgent(".oxagen/agents/empty.md", "---\nname: empty\n---\n");
+        expect(load().has("empty")).toBe(false);
+    });
+    it("getAgent returns one agent or null", () => {
+        writeAgent(".oxagen/agents/solo.md", "---\nname: solo\n---\nbody");
+        expect(getAgent("solo", { cwd: dir, userAgentsDir: userDir, settingsOptions: { userSettingsPath: userSettings } })?.name).toBe("solo");
+        expect(getAgent("nope", { cwd: dir, userAgentsDir: userDir, settingsOptions: { userSettingsPath: userSettings } })).toBeNull();
+    });
+});
+//# sourceMappingURL=loader.test.js.map

package/dist/agents/__tests__/loader.test.js.map

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

package/dist/agents/__tests__/tools.test.d.ts

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

package/dist/agents/__tests__/tools.test.d.ts.map

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

package/dist/agents/__tests__/tools.test.js

@@ -0,0 +1,40 @@
+import { describe, it, expect } from "vitest";
+import { tool } from "ai";
+import { z } from "zod";
+import { toolAllowedForAgent, filterToolsForAgent } from "../tools.js";
+describe("toolAllowedForAgent", () => {
+    it("inherits everything when the allowlist is undefined", () => {
+        expect(toolAllowedForAgent("bash", undefined)).toBe(true);
+    });
+    it("matches local tools by canonical name", () => {
+        // Read covers read_file/grep/glob/list_dir/code_graph
+        expect(toolAllowedForAgent("read_file", ["Read"])).toBe(true);
+        expect(toolAllowedForAgent("grep", ["Read"])).toBe(true);
+        expect(toolAllowedForAgent("bash", ["Read"])).toBe(false);
+        expect(toolAllowedForAgent("bash", ["Bash"])).toBe(true);
+    });
+    it("matches the raw tool name too", () => {
+        expect(toolAllowedForAgent("write_file", ["write_file"])).toBe(true);
+    });
+    it("globs MCP tool names", () => {
+        expect(toolAllowedForAgent("mcp__github__create_issue", ["mcp__github__*"])).toBe(true);
+        expect(toolAllowedForAgent("mcp__other__x", ["mcp__github__*"])).toBe(false);
+    });
+});
+describe("filterToolsForAgent", () => {
+    const make = () => ({
+        read_file: tool({ description: "", inputSchema: z.object({}), execute: async () => "" }),
+        bash: tool({ description: "", inputSchema: z.object({}), execute: async () => "" }),
+        mcp__github__create_issue: tool({ description: "", inputSchema: z.object({}), execute: async () => "" }),
+    });
+    it("returns the same set when no allowlist", () => {
+        const t = make();
+        expect(filterToolsForAgent(t, undefined)).toBe(t);
+    });
+    it("keeps only allowed tools", () => {
+        const filtered = filterToolsForAgent(make(), ["Read", "mcp__github__*"]);
+        expect(Object.keys(filtered).sort()).toEqual(["mcp__github__create_issue", "read_file"]);
+        expect(filtered).not.toHaveProperty("bash");
+    });
+});
+//# sourceMappingURL=tools.test.js.map

package/dist/agents/__tests__/tools.test.js.map

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

package/dist/agents/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @module agents — Named agent definitions for the CLI.
+ *
+ * Reusable personas (system prompt + tool allowlist + model) loaded from
+ * markdown or settings.json, dispatched by the fleet planner or run directly
+ * with `--agent <name>`.
+ */
+export type { AgentDefinition } from "./types.js";
+export { loadAgents, getAgent, parseFrontmatter, type LoadAgentsOptions } from "./loader.js";
+export { filterToolsForAgent, toolAllowedForAgent } from "./tools.js";
+export { scaffoldAgent } from "./write.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC7F,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/agents/index.js

@@ -0,0 +1,4 @@
+export { loadAgents, getAgent, parseFrontmatter } from "./loader.js";
+export { filterToolsForAgent, toolAllowedForAgent } from "./tools.js";
+export { scaffoldAgent } from "./write.js";
+//# sourceMappingURL=index.js.map

package/dist/agents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,gBAAgB,EAA0B,MAAM,aAAa,CAAC;AAC7F,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/agents/loader.d.ts

@@ -0,0 +1,25 @@
+import { type ResolveSettingsOptions } from "../settings/resolve.js";
+import type { AgentDefinition } from "./types.js";
+export interface LoadAgentsOptions {
+    /** Project root (where `.oxagen`/`.claude` live). Defaults to process.cwd(). */
+    cwd?: string;
+    /** Override the user agents dir (testing). */
+    userAgentsDir?: string;
+    /** Resolver overrides so inline `settings.agents` is read from the same place (testing). */
+    settingsOptions?: ResolveSettingsOptions;
+}
+interface Frontmatter {
+    data: Record<string, string>;
+    body: string;
+}
+/** Split `---\n…\n---\nbody` into single-line key/value frontmatter + body. */
+export declare function parseFrontmatter(raw: string): Frontmatter;
+/**
+ * Load every agent definition visible from `cwd`, merged by name across sources.
+ * Returns the registry keyed by agent name.
+ */
+export declare function loadAgents(opts?: LoadAgentsOptions): Map<string, AgentDefinition>;
+/** Resolve one agent by name (or null). Convenience over {@link loadAgents}. */
+export declare function getAgent(name: string, opts?: LoadAgentsOptions): AgentDefinition | null;
+export {};
+//# sourceMappingURL=loader.d.ts.map

package/dist/agents/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/agents/loader.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAgB,KAAK,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACnF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,WAAW,iBAAiB;IAChC,gFAAgF;IAChF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4FAA4F;IAC5F,eAAe,CAAC,EAAE,sBAAsB,CAAC;CAC1C;AAED,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAwBzD;AAgDD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,GAAE,iBAAsB,GAAG,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CA6BrF;AAED,gFAAgF;AAChF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,iBAAsB,GAAG,eAAe,GAAG,IAAI,CAE3F"}