@oxagen/cli 0.6.0 → 0.6.1

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"}

package/dist/agents/loader.js

@@ -0,0 +1,133 @@
+/**
+ * loader.ts — Discover and parse named agent definitions.
+ *
+ * Sources, lowest → highest precedence (later overrides an earlier one by name):
+ *   1. ~/.config/oxagen/agents/*.md            (user)
+ *   2. <project>/.claude/agents/*.md           (Claude Code interop)
+ *   3. <project>/.oxagen/agents/*.md           (oxagen project agents)
+ *   4. settings.json `agents` (inline map)     (project/local, via the resolver)
+ *
+ * Each markdown file has YAML-ish frontmatter (name/description/tools/model) and
+ * a body that becomes the system prompt. We parse the small, single-line subset
+ * Claude Code's agent files use — no YAML dependency.
+ */
+import { readFileSync, readdirSync, existsSync } from "node:fs";
+import { join, basename } from "node:path";
+import { homedir } from "node:os";
+import { loadSettings } from "../settings/resolve.js";
+/** Split `---\n…\n---\nbody` into single-line key/value frontmatter + body. */
+export function parseFrontmatter(raw) {
+    const text = raw.replace(/^/, "");
+    if (!text.startsWith("---"))
+        return { data: {}, body: text.trim() };
+    const end = text.indexOf("\n---", 3);
+    if (end === -1)
+        return { data: {}, body: text.trim() };
+    const header = text.slice(3, end).trim();
+    const body = text.slice(end + 4).replace(/^\r?\n/, "").trim();
+    const data = {};
+    for (const line of header.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#"))
+            continue;
+        const colon = trimmed.indexOf(":");
+        if (colon === -1)
+            continue;
+        const key = trimmed.slice(0, colon).trim();
+        let value = trimmed.slice(colon + 1).trim();
+        if ((value.startsWith('"') && value.endsWith('"')) ||
+            (value.startsWith("'") && value.endsWith("'"))) {
+            value = value.slice(1, -1);
+        }
+        if (key)
+            data[key] = value;
+    }
+    return { data, body };
+}
+/** Parse a `tools:` value: `a, b` or `[a, b]` → ["a","b"]; empty → undefined. */
+function parseToolList(value) {
+    if (value === undefined)
+        return undefined;
+    const inner = value.trim().replace(/^\[/, "").replace(/\]$/, "");
+    const list = inner
+        .split(",")
+        .map((s) => s.trim().replace(/^["']|["']$/g, ""))
+        .filter(Boolean);
+    return list.length > 0 ? list : undefined;
+}
+function defFromMarkdown(path) {
+    let raw;
+    try {
+        raw = readFileSync(path, "utf8");
+    }
+    catch {
+        return null;
+    }
+    const { data, body } = parseFrontmatter(raw);
+    const name = data["name"] || basename(path).replace(/\.md$/, "");
+    const description = data["description"] ?? "";
+    if (!name || !body.trim())
+        return null; // a usable agent needs a name and a prompt
+    return {
+        name,
+        description,
+        systemPrompt: body,
+        tools: parseToolList(data["tools"]),
+        model: data["model"] || undefined,
+        source: path,
+    };
+}
+function loadDir(dir, into) {
+    if (!existsSync(dir))
+        return;
+    let files;
+    try {
+        files = readdirSync(dir).filter((f) => f.endsWith(".md"));
+    }
+    catch {
+        return;
+    }
+    for (const file of files.sort()) {
+        const def = defFromMarkdown(join(dir, file));
+        if (def)
+            into.set(def.name, def);
+    }
+}
+/**
+ * Load every agent definition visible from `cwd`, merged by name across sources.
+ * Returns the registry keyed by agent name.
+ */
+export function loadAgents(opts = {}) {
+    const cwd = opts.cwd ?? process.cwd();
+    const userDir = opts.userAgentsDir ?? join(homedir(), ".config", "oxagen", "agents");
+    const registry = new Map();
+    loadDir(userDir, registry);
+    loadDir(join(cwd, ".claude", "agents"), registry);
+    loadDir(join(cwd, ".oxagen", "agents"), registry);
+    // Inline definitions in settings.json (highest precedence).
+    const settings = loadSettings({ cwd, ...opts.settingsOptions, noCache: true }).settings;
+    const inline = settings.agents;
+    if (inline && typeof inline === "object") {
+        for (const [name, value] of Object.entries(inline)) {
+            if (!value || typeof value !== "object")
+                continue;
+            const v = value;
+            if (!v.prompt)
+                continue;
+            registry.set(name, {
+                name,
+                description: v.description ?? "",
+                systemPrompt: v.prompt,
+                tools: Array.isArray(v.tools) && v.tools.length > 0 ? v.tools : undefined,
+                model: v.model,
+                source: "settings.json",
+            });
+        }
+    }
+    return registry;
+}
+/** Resolve one agent by name (or null). Convenience over {@link loadAgents}. */
+export function getAgent(name, opts = {}) {
+    return loadAgents(opts).get(name) ?? null;
+}
+//# sourceMappingURL=loader.js.map

package/dist/agents/loader.js.map

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

package/dist/agents/tools.d.ts

@@ -0,0 +1,14 @@
+/**
+ * tools.ts — Restrict a tool set to an agent's allowlist.
+ *
+ * An agent's `tools` list uses permission syntax (`Read`, `Bash`,
+ * `mcp__github__*`). A tool survives if any allowlist entry glob-matches either
+ * its raw name (`read_file`, `mcp__github__create_issue`) or its canonical
+ * permission name (`Read`, `Bash`). An undefined allowlist inherits everything.
+ */
+import type { ToolSet } from "ai";
+/** True when `toolName` is permitted by the agent's allowlist. */
+export declare function toolAllowedForAgent(toolName: string, allow: string[] | undefined): boolean;
+/** Return the subset of `tools` an agent is allowed to use. */
+export declare function filterToolsForAgent(tools: ToolSet, allow: string[] | undefined): ToolSet;
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/agents/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAIlC,kEAAkE;AAClE,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,OAAO,CAI1F;AAED,+DAA+D;AAC/D,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,OAAO,CAOxF"}

package/dist/agents/tools.js

@@ -0,0 +1,21 @@
+import { matchGlob } from "@oxagen/mcp-config/permissions";
+import { canonicalToolName } from "../settings/permissions-gate.js";
+/** True when `toolName` is permitted by the agent's allowlist. */
+export function toolAllowedForAgent(toolName, allow) {
+    if (!allow)
+        return true;
+    const canonical = canonicalToolName(toolName);
+    return allow.some((entry) => matchGlob(entry, toolName) || matchGlob(entry, canonical));
+}
+/** Return the subset of `tools` an agent is allowed to use. */
+export function filterToolsForAgent(tools, allow) {
+    if (!allow)
+        return tools;
+    const out = {};
+    for (const [name, t] of Object.entries(tools)) {
+        if (toolAllowedForAgent(name, allow))
+            out[name] = t;
+    }
+    return out;
+}
+//# sourceMappingURL=tools.js.map

package/dist/agents/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/agents/tools.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAEpE,kEAAkE;AAClE,MAAM,UAAU,mBAAmB,CAAC,QAAgB,EAAE,KAA2B;IAC/E,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,SAAS,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC9C,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;AAC1F,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,mBAAmB,CAAC,KAAc,EAAE,KAA2B;IAC7E,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,MAAM,GAAG,GAAY,EAAE,CAAC;IACxB,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9C,IAAI,mBAAmB,CAAC,IAAI,EAAE,KAAK,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/agents/types.d.ts

@@ -0,0 +1,27 @@
+/**
+ * types.ts — The shape of a named agent definition.
+ *
+ * An agent is a reusable persona: a system prompt, an optional tool allowlist,
+ * and an optional model. Defined in markdown (`.oxagen/agents/<name>.md`,
+ * `.claude/agents/*.md` for Claude Code interop, or `~/.config/oxagen/agents/`)
+ * or inline in `settings.json` under `agents`. The fleet planner dispatches a
+ * task to an agent by name; `--agent <name>` runs a single turn as one.
+ */
+export interface AgentDefinition {
+    /** Unique name; how the agent is referenced and dispatched. */
+    name: string;
+    /** What the agent is for — shown in `agent list` and given to the planner. */
+    description: string;
+    /** The agent's system prompt (the markdown body, or inline `prompt`). */
+    systemPrompt: string;
+    /**
+     * Tool allowlist in permission syntax (`Read`, `Bash`, `mcp__github__*`).
+     * `undefined` means inherit every available tool.
+     */
+    tools?: string[];
+    /** Gateway model slug override for this agent. */
+    model?: string;
+    /** Where the definition came from (file path or "settings.json"). */
+    source: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,eAAe;IAC9B,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,WAAW,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,YAAY,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/agents/types.js

@@ -0,0 +1,11 @@
+/**
+ * types.ts — The shape of a named agent definition.
+ *
+ * An agent is a reusable persona: a system prompt, an optional tool allowlist,
+ * and an optional model. Defined in markdown (`.oxagen/agents/<name>.md`,
+ * `.claude/agents/*.md` for Claude Code interop, or `~/.config/oxagen/agents/`)
+ * or inline in `settings.json` under `agents`. The fleet planner dispatches a
+ * task to an agent by name; `--agent <name>` runs a single turn as one.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/agents/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/agents/write.d.ts

@@ -0,0 +1,10 @@
+/** Write a starter agent markdown file to `.oxagen/agents/<name>.md`. */
+export declare function scaffoldAgent(opts: {
+    name: string;
+    cwd?: string;
+    dir?: string;
+}): {
+    path: string;
+    created: boolean;
+};
+//# sourceMappingURL=write.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/agents/write.ts"],"names":[],"mappings":"AAmBA,yEAAyE;AACzE,wBAAgB,aAAa,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG;IACjF,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB,CAOA"}

package/dist/agents/write.js

@@ -0,0 +1,28 @@
+/**
+ * write.ts — Scaffold a new agent definition file for `oxagen agent new`.
+ */
+import { writeFileSync, existsSync, mkdirSync } from "node:fs";
+import { join, dirname } from "node:path";
+const TEMPLATE = (name) => `---
+name: ${name}
+description: Describe when this agent should be used (the planner reads this).
+tools: Read, Grep, Glob, Bash
+model: anthropic/claude-sonnet-4.6
+---
+
+You are the ${name} agent.
+
+Describe the agent's role, what it should focus on, and how it should behave.
+This whole body becomes the agent's system prompt.
+`;
+/** Write a starter agent markdown file to `.oxagen/agents/<name>.md`. */
+export function scaffoldAgent(opts) {
+    const dir = opts.dir ?? join(opts.cwd ?? process.cwd(), ".oxagen", "agents");
+    const path = join(dir, `${opts.name}.md`);
+    if (existsSync(path))
+        return { path, created: false };
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, TEMPLATE(opts.name), "utf8");
+    return { path, created: true };
+}
+//# sourceMappingURL=write.js.map

package/dist/agents/write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.js","sourceRoot":"","sources":["../../src/agents/write.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC;QAC3B,IAAI;;;;;;cAME,IAAI;;;;CAIjB,CAAC;AAEF,yEAAyE;AACzE,MAAM,UAAU,aAAa,CAAC,IAAkD;IAI9E,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC7E,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC;IAC1C,IAAI,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACtD,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,aAAa,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;IACjD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACjC,CAAC"}

package/dist/commands/__tests__/agent.test.d.ts

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

package/dist/commands/__tests__/agent.test.d.ts.map

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