@oxagen/cli 0.5.0 → 0.6.1

package/dist/agent/tools.js

@@ -0,0 +1,354 @@
+/**
+ * Local coding tools for the agent loop.
+ *
+ * These are the host-filesystem / shell primitives that Claude Code-style
+ * agentic coding needs and that the Oxagen platform deliberately does NOT expose
+ * (the platform only has a sandboxed `agent.code.execute`, not host-fs tools).
+ * Each is an AI SDK `tool()` whose `execute` operates on the local working
+ * directory and returns a string the model can read.
+ *
+ * Safety: the mutating tools (`write_file`, `edit_file`, `bash`) are routed
+ * through a {@link PermissionBroker} when one is supplied — each call is checked
+ * (and, in `ask` mode, approved by the human) before it runs. `--readonly`
+ * withholds them entirely. With no broker the tools run ungated (the fleet
+ * orchestrator runs its own policy), so callers that face a user — the REPL and
+ * one-shot — always supply one.
+ */
+import { tool } from "ai";
+import { z } from "zod";
+import { promises as fs } from "node:fs";
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+import { resolve, relative, join, isAbsolute } from "node:path";
+import { queryCodeGraph } from "./code-graph.js";
+import { isMutatingTool, toRequest } from "./permissions.js";
+const execAsync = promisify(exec);
+const MAX_OUTPUT = 30_000; // chars; keep tool output from blowing the context window
+const IGNORE_DIRS = new Set([
+    "node_modules",
+    ".git",
+    ".next",
+    "dist",
+    "build",
+    "coverage",
+    ".turbo",
+    ".vercel",
+]);
+function clip(text) {
+    if (text.length <= MAX_OUTPUT)
+        return text;
+    return (text.slice(0, MAX_OUTPUT) +
+        `\n… [truncated ${text.length - MAX_OUTPUT} chars]`);
+}
+/** Resolve a user-supplied path against cwd; absolute paths are honored as-is. */
+function resolvePath(cwd, p) {
+    return isAbsolute(p) ? p : resolve(cwd, p);
+}
+function globToRegExp(pattern) {
+    // Minimal glob → regex: ** matches across dirs, * within a segment, ? one char.
+    let re = "";
+    for (let i = 0; i < pattern.length; i++) {
+        const c = pattern[i];
+        if (c === "*") {
+            if (pattern[i + 1] === "*") {
+                re += ".*";
+                i++;
+                if (pattern[i + 1] === "/")
+                    i++; // consume the slash after **
+            }
+            else {
+                re += "[^/]*";
+            }
+        }
+        else if (c === "?") {
+            re += "[^/]";
+        }
+        else if (".+^${}()|[]\\".includes(c)) {
+            re += "\\" + c;
+        }
+        else {
+            re += c;
+        }
+    }
+    return new RegExp("^" + re + "$");
+}
+async function* walk(dir, cwd) {
+    let entries;
+    try {
+        const dirents = await fs.readdir(dir, { withFileTypes: true });
+        entries = dirents.map((d) => ({ name: d.name, isDir: d.isDirectory() }));
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        if (entry.isDir && IGNORE_DIRS.has(entry.name))
+            continue;
+        const abs = join(dir, entry.name);
+        const rel = relative(cwd, abs);
+        if (entry.isDir) {
+            yield* walk(abs, cwd);
+        }
+        else {
+            yield { abs, rel };
+        }
+    }
+}
+export function buildTools(cwd, opts = {}) {
+    const tools = {
+        read_file: tool({
+            description: "Read a file from the working directory. Returns the file contents (optionally a line range).",
+            inputSchema: z.object({
+                path: z.string().describe("File path, relative to cwd or absolute."),
+                offset: z
+                    .number()
+                    .int()
+                    .optional()
+                    .describe("1-based start line (optional)."),
+                limit: z
+                    .number()
+                    .int()
+                    .optional()
+                    .describe("Max number of lines to return (optional)."),
+            }),
+            execute: async ({ path, offset, limit }) => {
+                try {
+                    const text = await fs.readFile(resolvePath(cwd, path), "utf8");
+                    if (offset == null && limit == null)
+                        return clip(text);
+                    const lines = text.split("\n");
+                    const start = offset ? offset - 1 : 0;
+                    const end = limit ? start + limit : lines.length;
+                    return clip(lines.slice(start, end).join("\n"));
+                }
+                catch (err) {
+                    return `Error reading ${path}: ${err instanceof Error ? err.message : String(err)}`;
+                }
+            },
+        }),
+        write_file: tool({
+            description: "Write (create or overwrite) a file with the given content. Creates parent directories as needed.",
+            inputSchema: z.object({
+                path: z.string(),
+                content: z.string(),
+            }),
+            execute: async ({ path, content }) => {
+                try {
+                    const abs = resolvePath(cwd, path);
+                    await fs.mkdir(resolve(abs, ".."), { recursive: true });
+                    await fs.writeFile(abs, content, "utf8");
+                    return `Wrote ${content.length} bytes to ${path}`;
+                }
+                catch (err) {
+                    return `Error writing ${path}: ${err instanceof Error ? err.message : String(err)}`;
+                }
+            },
+        }),
+        edit_file: tool({
+            description: "Replace an exact substring in a file. old_string must appear exactly once. Use for surgical edits.",
+            inputSchema: z.object({
+                path: z.string(),
+                old_string: z.string().describe("Exact text to replace (must be unique)."),
+                new_string: z.string().describe("Replacement text."),
+            }),
+            execute: async ({ path, old_string, new_string }) => {
+                try {
+                    const abs = resolvePath(cwd, path);
+                    const text = await fs.readFile(abs, "utf8");
+                    const count = text.split(old_string).length - 1;
+                    if (count === 0)
+                        return `Error: old_string not found in ${path}.`;
+                    if (count > 1)
+                        return `Error: old_string appears ${count} times in ${path}; make it unique.`;
+                    await fs.writeFile(abs, text.replace(old_string, new_string), "utf8");
+                    return `Edited ${path}`;
+                }
+                catch (err) {
+                    return `Error editing ${path}: ${err instanceof Error ? err.message : String(err)}`;
+                }
+            },
+        }),
+        list_dir: tool({
+            description: "List the entries of a directory (non-recursive).",
+            inputSchema: z.object({
+                path: z.string().optional().describe("Directory (default: cwd)."),
+            }),
+            execute: async ({ path }) => {
+                try {
+                    const abs = resolvePath(cwd, path ?? ".");
+                    const dirents = await fs.readdir(abs, { withFileTypes: true });
+                    const lines = dirents
+                        .map((d) => (d.isDirectory() ? `${d.name}/` : d.name))
+                        .sort();
+                    return clip(lines.join("\n") || "(empty)");
+                }
+                catch (err) {
+                    return `Error listing ${path ?? "."}: ${err instanceof Error ? err.message : String(err)}`;
+                }
+            },
+        }),
+        glob: tool({
+            description: "Find files matching a glob pattern (e.g. 'src/**/*.ts'). Skips node_modules/.git/dist.",
+            inputSchema: z.object({
+                pattern: z.string(),
+            }),
+            execute: async ({ pattern }) => {
+                const re = globToRegExp(pattern);
+                const matches = [];
+                for await (const { rel } of walk(cwd, cwd)) {
+                    if (re.test(rel))
+                        matches.push(rel);
+                    if (matches.length >= 500)
+                        break;
+                }
+                return clip(matches.sort().join("\n") || "(no matches)");
+            },
+        }),
+        grep: tool({
+            description: "Search file contents with a regular expression. Returns matching file:line:text. Skips node_modules/.git/dist.",
+            inputSchema: z.object({
+                pattern: z.string().describe("JavaScript regular expression."),
+                path: z
+                    .string()
+                    .optional()
+                    .describe("Subdirectory to search (default: cwd)."),
+                glob: z
+                    .string()
+                    .optional()
+                    .describe("Restrict to files matching this glob (e.g. '*.ts')."),
+            }),
+            execute: async ({ pattern, path, glob }) => {
+                let re;
+                try {
+                    re = new RegExp(pattern);
+                }
+                catch (err) {
+                    return `Invalid regex: ${err instanceof Error ? err.message : String(err)}`;
+                }
+                const fileRe = glob ? globToRegExp(glob.includes("/") ? glob : `**/${glob}`) : null;
+                const root = resolvePath(cwd, path ?? ".");
+                const hits = [];
+                for await (const { abs, rel } of walk(root, cwd)) {
+                    if (fileRe && !fileRe.test(rel))
+                        continue;
+                    let text;
+                    try {
+                        text = await fs.readFile(abs, "utf8");
+                    }
+                    catch {
+                        continue; // binary / unreadable
+                    }
+                    const lines = text.split("\n");
+                    for (let i = 0; i < lines.length; i++) {
+                        if (re.test(lines[i])) {
+                            hits.push(`${rel}:${i + 1}:${lines[i].slice(0, 200)}`);
+                            if (hits.length >= 200)
+                                break;
+                        }
+                    }
+                    if (hits.length >= 200)
+                        break;
+                }
+                return clip(hits.join("\n") || "(no matches)");
+            },
+        }),
+        code_graph: tool({
+            description: "Query the repository's code graph — a precomputed index of symbols and " +
+                "import relationships — for STRUCTURAL answers, instead of guessing paths " +
+                "or grepping. Prefer this over `grep` for \"where is X defined\" and for " +
+                "impact analysis before a change. Operations: 'search' finds where a " +
+                "symbol (function/class/type/interface) is defined by name; 'file_symbols' " +
+                "lists the top-level symbols a file defines; 'dependents' lists the files " +
+                "that import a given file (what a change could break); 'imports' lists the " +
+                "local files a given file imports.",
+            inputSchema: z.object({
+                operation: z.enum(["search", "file_symbols", "dependents", "imports"]),
+                query: z
+                    .string()
+                    .describe("A symbol name for 'search'; a file path (relative to cwd, or a suffix " +
+                    "like 'agent/loop.ts') for 'file_symbols' / 'dependents' / 'imports'."),
+                limit: z
+                    .number()
+                    .int()
+                    .optional()
+                    .describe("Max results to return (default 25)."),
+            }),
+            execute: async ({ operation, query, limit }) => {
+                try {
+                    return clip(await queryCodeGraph(cwd, operation, query, limit));
+                }
+                catch (err) {
+                    return `code_graph error: ${err instanceof Error ? err.message : String(err)}`;
+                }
+            },
+        }),
+        bash: tool({
+            description: "Run a shell command in the working directory. Use for builds, tests, git, package managers. Has a timeout.",
+            inputSchema: z.object({
+                command: z.string(),
+                timeout_ms: z
+                    .number()
+                    .int()
+                    .optional()
+                    .describe("Timeout in milliseconds (default 120000, max 600000)."),
+            }),
+            execute: async ({ command, timeout_ms }) => {
+                const timeout = Math.min(timeout_ms ?? 120_000, 600_000);
+                try {
+                    const { stdout, stderr } = await execAsync(command, {
+                        cwd,
+                        timeout,
+                        maxBuffer: 10 * 1024 * 1024,
+                        shell: "/bin/bash",
+                    });
+                    const out = [stdout, stderr].filter(Boolean).join("\n").trim();
+                    return clip(out || "(no output)");
+                }
+                catch (err) {
+                    const e = err;
+                    if (e.killed)
+                        return `Command timed out after ${timeout}ms.`;
+                    const out = [e.stdout, e.stderr, e.message].filter(Boolean).join("\n").trim();
+                    return clip(`Command failed:\n${out}`);
+                }
+            },
+        }),
+    };
+    // Read-only mode: withhold every mutating tool so the model literally cannot
+    // change the filesystem or run commands.
+    if (opts.readOnly) {
+        delete tools["write_file"];
+        delete tools["edit_file"];
+        delete tools["bash"];
+        return tools;
+    }
+    // Otherwise, gate each mutating tool through the permission broker (if any).
+    // The broker decides allow/deny (prompting the human in `ask` mode); a denial
+    // is surfaced to the model as a tool result so it can adapt rather than crash.
+    const broker = opts.broker;
+    if (broker) {
+        for (const name of Object.keys(tools)) {
+            if (!isMutatingTool(name))
+                continue;
+            const original = tools[name];
+            const innerExecute = original?.execute;
+            if (!original || typeof innerExecute !== "function")
+                continue;
+            tools[name] = {
+                ...original,
+                execute: async (input, options) => {
+                    const req = toRequest(name, input, cwd);
+                    if (req) {
+                        const decision = await broker.check(req);
+                        if (decision.decision === "deny") {
+                            return `Permission denied (${decision.reason}). The user did not approve this ${name} call; do not retry it — explain or choose another approach.`;
+                        }
+                    }
+                    return innerExecute.call(original, input, options);
+                },
+            };
+        }
+    }
+    return tools;
+}
+//# sourceMappingURL=tools.js.map

package/dist/agent/tools.js.map

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

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

@@ -0,0 +1,13 @@
+import type { TurnTrace } from "./trace.js";
+/**
+ * The verbose telemetry section: per-phase timing + model + cost, the per-model
+ * rollup (who did the work vs the review vs the enhance and what each cost),
+ * context-gather detail, the injected context, tool calls + results, and the
+ * efficiency metrics that let you prove one run is faster/cheaper than another.
+ */
+export declare function formatVerboseSection(trace: TurnTrace): string[];
+/** Render one trace as a human-readable, plain-text report. */
+export declare function formatTraceText(trace: TurnTrace): string;
+/** Render a recent-turns list (newest first) as plain text. */
+export declare function formatTraceList(traces: TurnTrace[]): string;
+//# sourceMappingURL=trace-format.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trace-format.d.ts","sourceRoot":"","sources":["../../src/agent/trace-format.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAwB,SAAS,EAAE,MAAM,YAAY,CAAC;AAgElE;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,EAAE,CAyE/D;AAED,+DAA+D;AAC/D,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAoExD;AAED,+DAA+D;AAC/D,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAU3D"}

package/dist/agent/trace-format.js

@@ -0,0 +1,188 @@
+/**
+ * Plain-text rendering of a turn trace.
+ *
+ * The REPL renders a trace with Ink ({@link TraceView}); this module produces the
+ * same information as plain text for the non-interactive `oxagen replay` command,
+ * so the full chain of thought is inspectable in a pipe, a log, or CI. Kept pure
+ * (no Ink, no AI SDK) so it is trivially testable.
+ */
+import { formatUsd } from "./model-router.js";
+function bar(score) {
+    const filled = Math.round((Math.max(0, Math.min(100, score)) / 100) * 10);
+    return "█".repeat(filled) + "░".repeat(10 - filled);
+}
+function bullets(items, glyph = "-") {
+    return items.map((i) => `    ${glyph} ${i}`).join("\n");
+}
+/** Compact ms → "340ms" / "1.2s". */
+function fmtMs(ms) {
+    return ms < 1000 ? `${Math.round(ms)}ms` : `${(ms / 1000).toFixed(2)}s`;
+}
+function shortModel(model) {
+    return model ? model.split("/").pop() ?? model : "—";
+}
+/** Human label for a phase in the verbose breakdown. */
+const PHASE_LABEL = {
+    evaluate: "prompt eval",
+    enhance: "context gather",
+    route: "route",
+    execute: "WORK (code)",
+    judge: "REVIEW (judge)",
+    revise: "revise",
+    complete: "complete",
+};
+/** Group phases by the model that ran them — the "who spent what" headline. */
+function rollupByModel(phases) {
+    const byModel = new Map();
+    for (const p of phases) {
+        if (!p.model)
+            continue; // non-LLM phases (enhance/route) have no model
+        const r = byModel.get(p.model) ??
+            { model: p.model, inputTokens: 0, outputTokens: 0, costUsd: 0, durationMs: 0, phases: [] };
+        r.inputTokens += p.usage.inputTokens;
+        r.outputTokens += p.usage.outputTokens;
+        r.costUsd += p.usage.costUsd;
+        r.durationMs += p.durationMs;
+        if (!r.phases.includes(PHASE_LABEL[p.phase]))
+            r.phases.push(PHASE_LABEL[p.phase]);
+        byModel.set(p.model, r);
+    }
+    return [...byModel.values()].sort((a, b) => b.costUsd - a.costUsd);
+}
+/** One line per tool call: name · duration · ok · input → result (truncated). */
+function formatToolEvent(e) {
+    const head = `    ${e.ok ? "·" : "✗"} ${e.name} (${fmtMs(e.durationMs)})  ${e.input}`;
+    return e.result ? `${head}\n        → ${e.result}` : head;
+}
+/**
+ * The verbose telemetry section: per-phase timing + model + cost, the per-model
+ * rollup (who did the work vs the review vs the enhance and what each cost),
+ * context-gather detail, the injected context, tool calls + results, and the
+ * efficiency metrics that let you prove one run is faster/cheaper than another.
+ */
+export function formatVerboseSection(trace) {
+    const lines = [];
+    const phases = trace.phases ?? [];
+    if (phases.length === 0 && !trace.toolEvents?.length)
+        return lines;
+    lines.push("", "── verbose telemetry ───────────────────────────────────");
+    // Per-phase timeline.
+    if (phases.length) {
+        lines.push("", "phases (time · model · tokens in→out · cost)");
+        for (const p of phases) {
+            const round = p.phase === "execute" || p.phase === "judge" ? ` #${p.round + 1}` : "";
+            const tok = p.usage.inputTokens || p.usage.outputTokens
+                ? ` · ${p.usage.inputTokens}→${p.usage.outputTokens} tok · ${formatUsd(p.usage.costUsd)}`
+                : "";
+            lines.push(`    ${PHASE_LABEL[p.phase]}${round}  ${fmtMs(p.durationMs)} · ${shortModel(p.model)}${tok}`);
+        }
+    }
+    // The headline: which model spent which dollars on which role.
+    const rollup = rollupByModel(phases);
+    if (rollup.length) {
+        lines.push("", "models used (role · time · tokens · cost)");
+        for (const r of rollup) {
+            lines.push(`    ${shortModel(r.model)} [${r.phases.join(", ")}]  ` +
+                `${fmtMs(r.durationMs)} · ${r.inputTokens}→${r.outputTokens} tok · ${formatUsd(r.costUsd)}`);
+        }
+    }
+    // Context-gather detail.
+    const en = trace.enhancement;
+    if (en.retrieval || en.durationMs != null) {
+        lines.push("", `context gathering${en.durationMs != null ? ` · ${fmtMs(en.durationMs)}` : ""}`);
+        if (en.retrieval) {
+            const r = en.retrieval;
+            if (r.symbolsQueried.length)
+                lines.push(`    symbols queried: ${r.symbolsQueried.join(", ")}`);
+            if (r.pathsQueried.length)
+                lines.push(`    paths queried:   ${r.pathsQueried.join(", ")}`);
+            if (r.resolved.length)
+                lines.push(`    resolved:        ${r.resolved.join(", ")}`);
+            if (r.unresolved.length)
+                lines.push(`    unresolved:      ${r.unresolved.join(", ")}`);
+        }
+        if (en.context) {
+            lines.push("    injected context:");
+            for (const l of en.context.split("\n"))
+                lines.push(`      ${l}`);
+        }
+    }
+    // Tool calls + results.
+    const tools = trace.toolEvents ?? [];
+    if (tools.length) {
+        lines.push("", `tool calls (${tools.length})`);
+        for (const e of tools)
+            lines.push(formatToolEvent(e));
+    }
+    // Efficiency — the "prove it" numbers.
+    const totalTok = trace.usage.inputTokens + trace.usage.outputTokens;
+    const secs = trace.durationMs / 1000;
+    lines.push("", "efficiency", `    ${fmtMs(trace.durationMs)} total · ${totalTok} tok · ${formatUsd(trace.usage.costUsd)}`, `    ${secs > 0 ? Math.round(totalTok / secs) : 0} tok/s · ` +
+        `${trace.steps} steps · ${trace.filesTouched.length} file(s) changed` +
+        (trace.filesTouched.length
+            ? ` · ${formatUsd(trace.usage.costUsd / trace.filesTouched.length)}/file`
+            : ""));
+    return lines;
+}
+/** Render one trace as a human-readable, plain-text report. */
+export function formatTraceText(trace) {
+    const { evaluation: ev, enhancement: en } = trace;
+    const lines = [];
+    lines.push(`↻ replay ${trace.id} · ${Math.round(trace.durationMs / 100) / 10}s · ` +
+        `${formatUsd(trace.usage.costUsd)} · ${trace.finalComplete ? "complete" : "gaps remain"}`);
+    lines.push("", "1 · Original prompt", `    ${trace.originalPrompt}`);
+    lines.push("", `2 · Evaluation${ev.fallback ? " (heuristic)" : ` · ${ev.model.split("/").pop()}`}`, `    completeness ${bar(ev.completeness)} ${ev.completeness}/100`, `    complexity   ${bar(ev.complexity)} ${ev.complexity}/100`);
+    if (ev.missing.length)
+        lines.push("    missing from prompt:", bullets(ev.missing, "?"));
+    if (ev.removed.length)
+        lines.push("    pruned as low-value:", bullets(ev.removed, "−"));
+    if (ev.reasoning)
+        lines.push(`    ${ev.reasoning}`);
+    if (ev.refinedPrompt !== trace.originalPrompt) {
+        lines.push("", "3 · Refined prompt (noise removed)", `    ${ev.refinedPrompt}`);
+    }
+    lines.push("", `4 · Injected context · ${en.source}`);
+    lines.push(en.resolved.length
+        ? `    code refs: ${en.resolved.join(", ")}`
+        : "    no code-graph references resolved");
+    lines.push(`    recalled lessons: ${en.lessonCount}`);
+    lines.push("", "5 · Model selected", `    ${trace.selectedModel.split("/").pop()} (${trace.selectedTier}) — ${trace.selectionRationale}`);
+    lines.push("", "6 · Completeness review (advisor)");
+    if (trace.judgeRounds.length === 0) {
+        lines.push("    not judged (bare mode)");
+    }
+    else {
+        for (let i = 0; i < trace.judgeRounds.length; i++) {
+            const v = trace.judgeRounds[i];
+            if (!v)
+                continue;
+            lines.push(`    round ${i + 1}: ${v.complete ? "COMPLETE" : "INCOMPLETE"} · ` +
+                `${v.confidence}% confident · advisor ${v.model.split("/").pop()}` +
+                (v.fallback ? " (heuristic)" : ""));
+            if (v.findings.length)
+                lines.push(bullets(v.findings, "✗"));
+            if (v.reasoning)
+                lines.push(`      ${v.reasoning}`);
+        }
+    }
+    lines.push("", `${trace.steps} steps · ${trace.filesTouched.length} file(s) touched` +
+        (trace.filesTouched.length ? `: ${trace.filesTouched.slice(0, 5).join(", ")}` : ""));
+    // Verbose turns carry the full per-phase / per-model / tool telemetry.
+    if (trace.verbose || trace.phases?.length || trace.toolEvents?.length) {
+        lines.push(...formatVerboseSection(trace));
+    }
+    return lines.join("\n");
+}
+/** Render a recent-turns list (newest first) as plain text. */
+export function formatTraceList(traces) {
+    if (traces.length === 0)
+        return "No turns recorded yet.";
+    return traces
+        .map((t, i) => {
+        const mark = t.finalComplete ? "✓" : "✗";
+        const prompt = t.originalPrompt.length > 56 ? t.originalPrompt.slice(0, 56) + "…" : t.originalPrompt;
+        return `${i + 1}. ${mark} ${prompt}  [${t.selectedModel.split("/").pop()} · ${formatUsd(t.usage.costUsd)}]`;
+    })
+        .join("\n");
+}
+//# sourceMappingURL=trace-format.js.map

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

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

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

@@ -0,0 +1,19 @@
+import type { TurnTrace } from "./trace.js";
+export interface TraceStore {
+    /** Persist a trace (newest first), bounding the file to the latest MAX_TRACES. */
+    record(trace: TurnTrace): void;
+    /** Fetch one trace by id. */
+    get(id: string): TurnTrace | undefined;
+    /** All traces, newest first. */
+    list(): TurnTrace[];
+    /** The most recent trace, or undefined if none. */
+    last(): TurnTrace | undefined;
+    /**
+     * Resolve a `/replay` argument to a trace: empty → most recent; a 1-based index
+     * (`/replay 2` = second-newest); or an id (exact, then prefix). undefined if no match.
+     */
+    resolve(arg: string): TurnTrace | undefined;
+}
+/** Open the trace store for a working directory. */
+export declare function openTraceStore(cwd: string): TraceStore;
+//# sourceMappingURL=trace-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trace-store.d.ts","sourceRoot":"","sources":["../../src/agent/trace-store.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAsC5C,MAAM,WAAW,UAAU;IACzB,kFAAkF;IAClF,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IAC/B,6BAA6B;IAC7B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IACvC,gCAAgC;IAChC,IAAI,IAAI,SAAS,EAAE,CAAC;IACpB,mDAAmD;IACnD,IAAI,IAAI,SAAS,GAAG,SAAS,CAAC;IAC9B;;;OAGG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;CAC7C;AAED,oDAAoD;AACpD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAkCtD"}