@yuaone/cli 0.1.0

package/dist/progress-renderer.js

@@ -0,0 +1,249 @@
+/**
+ * @module progress-renderer
+ * @description Real-time agent execution progress display for CLI.
+ *
+ * Shows:
+ * - Agent status (planning/coding/reviewing/testing)
+ * - Current tool execution (file, command, etc.)
+ * - Token usage bar
+ * - Iteration progress
+ * - Thinking stream (reasoning deltas)
+ */
+import { colors } from "./renderer.js";
+// ─── ANSI Helpers ───
+function c(color, text) {
+    return `${color}${text}${colors.reset}`;
+}
+function termWidth() {
+    return process.stdout.columns || 80;
+}
+/** Truncate a string to fit within `max` columns, appending ellipsis if needed. */
+function truncate(text, max) {
+    if (text.length <= max)
+        return text;
+    return text.slice(0, max - 1) + "\u2026";
+}
+/** Format a token count for display (e.g. 12400 -> "12.4k"). */
+function formatTokens(n) {
+    if (n >= 1_000_000)
+        return `${(n / 1_000_000).toFixed(1)}M`;
+    if (n >= 1_000)
+        return `${(n / 1_000).toFixed(1)}k`;
+    return String(n);
+}
+// ─── Phase labels & colors ───
+const PHASE_LABELS = {
+    planning: { tag: "[PLAN]", color: colors.blue },
+    coding: { tag: "[CODE]", color: colors.green },
+    reviewing: { tag: "[REVIEW]", color: colors.yellow },
+    testing: { tag: "[TEST]", color: colors.cyan },
+    waiting: { tag: "[WAIT]", color: colors.gray },
+};
+// ─── Progress Bar ───
+/**
+ * Render a Unicode progress bar.
+ *
+ * @param current - Current value.
+ * @param max     - Maximum value.
+ * @param width   - Character width of the bar (filled + empty).
+ * @returns Colored bar string, e.g. `████████░░░░░░░░`.
+ */
+export function renderBar(current, max, width = 20) {
+    const ratio = max > 0 ? Math.min(current / max, 1) : 0;
+    const filled = Math.round(ratio * width);
+    const empty = width - filled;
+    const pct = ratio * 100;
+    let barColor;
+    if (pct >= 80)
+        barColor = colors.red;
+    else if (pct >= 60)
+        barColor = colors.yellow;
+    else
+        barColor = colors.green;
+    return c(barColor, "\u2588".repeat(filled)) + c(colors.gray, "\u2591".repeat(empty));
+}
+// ─── ProgressRenderer ───
+/**
+ * Real-time CLI renderer for agent execution progress.
+ *
+ * Usage:
+ * ```ts
+ * const pr = new ProgressRenderer({ maxIterations: 25, maxTokens: 200_000, showThinking: true });
+ * pr.onStatus({ phase: "planning", detail: "analyzing codebase" });
+ * pr.onToolCall({ tool: "file_read", input: "src/index.ts" });
+ * pr.onToolResult({ tool: "file_read", success: true, summary: "42 lines" });
+ * pr.onIterationEnd(3, 25, 12400, 200000);
+ * pr.onDone({ filesChanged: ["a.ts"], iterations: 3, tokensUsed: 12400, durationMs: 8200, summary: "Done" });
+ * ```
+ */
+export class ProgressRenderer {
+    config;
+    thinkingBuffer = "";
+    thinkingTimer = null;
+    currentPhase = null;
+    constructor(config) {
+        this.config = config;
+    }
+    // ─── Status ───
+    /** Display an agent phase transition. */
+    onStatus(event) {
+        const { tag, color } = PHASE_LABELS[event.phase];
+        const detail = event.detail ? c(colors.dim, ` ${event.detail}`) : "";
+        console.log(`${c(color + colors.bold, tag)}${detail}`);
+        this.currentPhase = event.phase;
+    }
+    // ─── Tool Call / Result ───
+    /** Display a tool invocation line. */
+    onToolCall(event) {
+        const maxInput = termWidth() - event.tool.length - 10;
+        const input = truncate(event.input, Math.max(maxInput, 20));
+        console.log(c(colors.dim, "  \u251C\u2500 ") +
+            c(colors.yellow, event.tool) +
+            c(colors.dim, ": ") +
+            c(colors.white, input));
+    }
+    /** Display a tool result line (success or error). */
+    onToolResult(event) {
+        const maxSummary = termWidth() - 10;
+        if (event.success) {
+            console.log(c(colors.dim, "  \u2514\u2500 ") +
+                c(colors.green, "\u2713 ") +
+                c(colors.dim, truncate(event.summary, maxSummary)));
+        }
+        else {
+            console.log(c(colors.dim, "  \u2514\u2500 ") +
+                c(colors.red, "\u2717 ") +
+                c(colors.red, truncate(event.summary, maxSummary)));
+        }
+    }
+    // ─── Thinking Stream ───
+    /**
+     * Stream a reasoning delta.
+     * Output is debounced (200 ms) and rendered in dim gray,
+     * word-wrapped to the terminal width.
+     */
+    onThinking(delta) {
+        if (!this.config.showThinking)
+            return;
+        this.thinkingBuffer += delta;
+        if (this.thinkingTimer)
+            clearTimeout(this.thinkingTimer);
+        this.thinkingTimer = setTimeout(() => {
+            this.flushThinking();
+        }, 200);
+    }
+    /** Flush any buffered thinking text to stdout. */
+    flushThinking() {
+        if (!this.thinkingBuffer)
+            return;
+        const width = termWidth() - 4; // indent
+        const text = this.thinkingBuffer;
+        this.thinkingBuffer = "";
+        this.thinkingTimer = null;
+        const lines = this.wrapText(text, width);
+        for (const line of lines) {
+            console.log(c(colors.gray + colors.dim, `  ${line}`));
+        }
+    }
+    /** Word-wrap text to a given width. */
+    wrapText(text, width) {
+        const result = [];
+        const raw = text.replace(/\n/g, " ");
+        let remaining = raw;
+        while (remaining.length > 0) {
+            if (remaining.length <= width) {
+                result.push(remaining);
+                break;
+            }
+            let breakIdx = remaining.lastIndexOf(" ", width);
+            if (breakIdx <= 0)
+                breakIdx = width;
+            result.push(remaining.slice(0, breakIdx));
+            remaining = remaining.slice(breakIdx).trimStart();
+        }
+        return result;
+    }
+    // ─── Iteration Progress ───
+    /**
+     * Render an iteration progress line with bar and token usage.
+     *
+     * Example output:
+     * ```
+     * [3/25] ████████░░░░░░░░ 32% | tokens: 12.4k/200k
+     * ```
+     */
+    onIterationEnd(iteration, maxIteration, tokensUsed, maxTokens) {
+        // Flush any pending thinking text before the progress line.
+        this.flushThinking();
+        const pct = maxIteration > 0 ? Math.round((iteration / maxIteration) * 100) : 0;
+        const iterLabel = c(colors.bold, `[${iteration}/${maxIteration}]`);
+        const bar = renderBar(iteration, maxIteration, 16);
+        const pctStr = `${String(pct).padStart(3)}%`;
+        const tokenStr = `${formatTokens(tokensUsed)}/${formatTokens(maxTokens)}`;
+        console.log(`${iterLabel} ${bar} ${pctStr} ${c(colors.dim, "|")} ${c(colors.dim, "tokens:")} ${tokenStr}`);
+    }
+    // ─── Approval ───
+    /** Display an approval-needed prompt box. */
+    onApprovalNeeded(approval) {
+        this.flushThinking();
+        const riskColor = approval.risk === "high"
+            ? colors.bgRed
+            : approval.risk === "medium"
+                ? colors.bgYellow
+                : colors.green;
+        const riskLabel = c(riskColor + colors.bold, ` ${approval.risk.toUpperCase()} `);
+        const border = c(colors.yellow, "\u250C" + "\u2500".repeat(termWidth() - 4) + "\u2510");
+        const bottom = c(colors.yellow, "\u2514" + "\u2500".repeat(termWidth() - 4) + "\u2518");
+        console.log();
+        console.log(border);
+        console.log(c(colors.yellow, "\u2502") +
+            c(colors.bold + colors.yellow, " APPROVAL NEEDED ") +
+            riskLabel +
+            " ".repeat(Math.max(0, termWidth() - 22 - approval.risk.length - 4)) +
+            c(colors.yellow, "\u2502"));
+        console.log(c(colors.yellow, "\u2502") +
+            ` Tool: ${c(colors.cyan, approval.tool)}` +
+            " ".repeat(Math.max(0, termWidth() - 10 - approval.tool.length - 2)) +
+            c(colors.yellow, "\u2502"));
+        console.log(c(colors.yellow, "\u2502") +
+            ` ${truncate(approval.description, termWidth() - 4)}` +
+            " ".repeat(Math.max(0, termWidth() - 3 - Math.min(approval.description.length, termWidth() - 4) - 1)) +
+            c(colors.yellow, "\u2502"));
+        console.log(bottom);
+        console.log();
+    }
+    // ─── Done ───
+    /** Display a completion summary. */
+    onDone(result) {
+        this.flushThinking();
+        console.log();
+        console.log(c(colors.green + colors.bold, "  COMPLETED"));
+        console.log(c(colors.dim, "  " + "\u2500".repeat(50)));
+        const durationSec = (result.durationMs / 1000).toFixed(1);
+        console.log(`  ${c(colors.dim, "Files changed:")} ${c(colors.white, String(result.filesChanged.length))}`);
+        for (const f of result.filesChanged) {
+            console.log(`    ${c(colors.dim, "\u2022")} ${f}`);
+        }
+        console.log(`  ${c(colors.dim, "Iterations:")}    ${c(colors.white, `${result.iterations}/${this.config.maxIterations}`)}`);
+        console.log(`  ${c(colors.dim, "Tokens:")}        ${c(colors.white, `${formatTokens(result.tokensUsed)}/${formatTokens(this.config.maxTokens)}`)}`);
+        console.log(`  ${c(colors.dim, "Duration:")}      ${c(colors.white, `${durationSec}s`)}`);
+        if (result.summary) {
+            console.log();
+            console.log(`  ${c(colors.dim, result.summary)}`);
+        }
+        console.log();
+    }
+    // ─── Error ───
+    /** Display an error message in red. */
+    onError(error) {
+        this.flushThinking();
+        console.log(c(colors.red + colors.bold, `  ERROR: `) + c(colors.red, error));
+    }
+    // ─── Clear ───
+    /** Clear the current progress display area. */
+    clear() {
+        this.flushThinking();
+        process.stdout.write("\x1b[2J\x1b[H"); // clear screen + move cursor home
+    }
+}
+//# sourceMappingURL=progress-renderer.js.map

package/dist/progress-renderer.js.map

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

package/dist/renderer.d.ts

@@ -0,0 +1,67 @@
+/**
+ * YUAN CLI — Terminal Renderer
+ *
+ * Handles styled terminal output: colors, spinners, markdown,
+ * agent thinking display, and tool call rendering.
+ */
+export declare const colors: {
+    readonly reset: "\u001B[0m";
+    readonly bold: "\u001B[1m";
+    readonly dim: "\u001B[2m";
+    readonly italic: "\u001B[3m";
+    readonly underline: "\u001B[4m";
+    readonly red: "\u001B[31m";
+    readonly green: "\u001B[32m";
+    readonly yellow: "\u001B[33m";
+    readonly blue: "\u001B[34m";
+    readonly magenta: "\u001B[35m";
+    readonly cyan: "\u001B[36m";
+    readonly white: "\u001B[37m";
+    readonly gray: "\u001B[90m";
+    readonly bgRed: "\u001B[41m";
+    readonly bgGreen: "\u001B[42m";
+    readonly bgYellow: "\u001B[43m";
+    readonly bgBlue: "\u001B[44m";
+};
+export declare class Spinner {
+    private interval;
+    private frameIndex;
+    private message;
+    constructor(message: string);
+    start(): void;
+    update(message: string): void;
+    stop(finalMessage?: string): void;
+}
+export declare class TerminalRenderer {
+    /** Print the YUAN banner */
+    banner(): void;
+    /** Print an info line */
+    info(message: string): void;
+    /** Print a success line */
+    success(message: string): void;
+    /** Print a warning line */
+    warn(message: string): void;
+    /** Print an error line */
+    error(message: string): void;
+    /** Display agent thinking indicator */
+    thinking(): Spinner;
+    /** Display a tool call */
+    toolCall(toolName: string, args?: string): void;
+    /** Display a tool result (truncated) */
+    toolResult(result: string, maxLines?: number): void;
+    /** Render basic markdown to terminal (code blocks, bold, headers) */
+    markdown(text: string): void;
+    /** Print a horizontal separator */
+    separator(): void;
+    /** Print agent response text */
+    agentResponse(text: string): void;
+    /** Print the prompt indicator for interactive mode */
+    prompt(): void;
+    /** Stream a token (no newline, real-time output) */
+    streamToken(token: string): void;
+    /** End a streaming sequence (newline + reset) */
+    endStream(): void;
+    /** Create a spinner with custom message */
+    spinner(message: string): Spinner;
+}
+//# sourceMappingURL=renderer.d.ts.map

package/dist/renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;CAoBT,CAAC;AAUX,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAA+C;IAC/D,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,MAAM;IAI3B,KAAK,IAAI,IAAI;IAYb,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI7B,IAAI,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI;CAWlC;AAID,qBAAa,gBAAgB;IAC3B,4BAA4B;IAC5B,MAAM,IAAI,IAAI;IAOd,yBAAyB;IACzB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3B,2BAA2B;IAC3B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI9B,2BAA2B;IAC3B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3B,0BAA0B;IAC1B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI5B,uCAAuC;IACvC,QAAQ,IAAI,OAAO;IAMnB,0BAA0B;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAM/C,wCAAwC;IACxC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,IAAI;IAa9C,qEAAqE;IACrE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAwD5B,mCAAmC;IACnC,SAAS,IAAI,IAAI;IAIjB,gCAAgC;IAChC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAMjC,sDAAsD;IACtD,MAAM,IAAI,IAAI;IAId,oDAAoD;IACpD,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIhC,iDAAiD;IACjD,SAAS,IAAI,IAAI;IAIjB,2CAA2C;IAC3C,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;CAGlC"}

package/dist/renderer.js

@@ -0,0 +1,182 @@
+/**
+ * YUAN CLI — Terminal Renderer
+ *
+ * Handles styled terminal output: colors, spinners, markdown,
+ * agent thinking display, and tool call rendering.
+ */
+// ─── ANSI color helpers (no external deps) ───
+const ESC = "\x1b[";
+export const colors = {
+    reset: `${ESC}0m`,
+    bold: `${ESC}1m`,
+    dim: `${ESC}2m`,
+    italic: `${ESC}3m`,
+    underline: `${ESC}4m`,
+    red: `${ESC}31m`,
+    green: `${ESC}32m`,
+    yellow: `${ESC}33m`,
+    blue: `${ESC}34m`,
+    magenta: `${ESC}35m`,
+    cyan: `${ESC}36m`,
+    white: `${ESC}37m`,
+    gray: `${ESC}90m`,
+    bgRed: `${ESC}41m`,
+    bgGreen: `${ESC}42m`,
+    bgYellow: `${ESC}43m`,
+    bgBlue: `${ESC}44m`,
+};
+function c(color, text) {
+    return `${color}${text}${colors.reset}`;
+}
+// ─── Spinner ───
+const SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+export class Spinner {
+    interval = null;
+    frameIndex = 0;
+    message;
+    constructor(message) {
+        this.message = message;
+    }
+    start() {
+        this.frameIndex = 0;
+        process.stdout.write("\x1b[?25l"); // hide cursor
+        this.interval = setInterval(() => {
+            const frame = SPINNER_FRAMES[this.frameIndex % SPINNER_FRAMES.length];
+            process.stdout.write(`\r${c(colors.cyan, frame)} ${c(colors.dim, this.message)}`);
+            this.frameIndex++;
+        }, 80);
+    }
+    update(message) {
+        this.message = message;
+    }
+    stop(finalMessage) {
+        if (this.interval) {
+            clearInterval(this.interval);
+            this.interval = null;
+        }
+        process.stdout.write("\r\x1b[K"); // clear line
+        process.stdout.write("\x1b[?25h"); // show cursor
+        if (finalMessage) {
+            console.log(`${c(colors.green, "✓")} ${finalMessage}`);
+        }
+    }
+}
+// ─── Terminal Renderer ───
+export class TerminalRenderer {
+    /** Print the YUAN banner */
+    banner() {
+        console.log(c(colors.bold + colors.cyan, "\n  YUAN") +
+            c(colors.dim, " — Autonomous Coding Agent\n"));
+    }
+    /** Print an info line */
+    info(message) {
+        console.log(`${c(colors.blue, "ℹ")} ${message}`);
+    }
+    /** Print a success line */
+    success(message) {
+        console.log(`${c(colors.green, "✓")} ${message}`);
+    }
+    /** Print a warning line */
+    warn(message) {
+        console.log(`${c(colors.yellow, "⚠")} ${message}`);
+    }
+    /** Print an error line */
+    error(message) {
+        console.log(`${c(colors.red, "✗")} ${message}`);
+    }
+    /** Display agent thinking indicator */
+    thinking() {
+        const spinner = new Spinner("thinking...");
+        spinner.start();
+        return spinner;
+    }
+    /** Display a tool call */
+    toolCall(toolName, args) {
+        const toolStr = c(colors.yellow, toolName);
+        const argsStr = args ? c(colors.dim, ` ${args}`) : "";
+        console.log(`  ${c(colors.dim, "🔧")} ${toolStr}${argsStr}`);
+    }
+    /** Display a tool result (truncated) */
+    toolResult(result, maxLines = 5) {
+        const lines = result.split("\n");
+        const display = lines.slice(0, maxLines);
+        for (const line of display) {
+            console.log(`  ${c(colors.dim, "│")} ${c(colors.dim, line)}`);
+        }
+        if (lines.length > maxLines) {
+            console.log(`  ${c(colors.dim, "│")} ${c(colors.dim, `... (${lines.length - maxLines} more lines)`)}`);
+        }
+    }
+    /** Render basic markdown to terminal (code blocks, bold, headers) */
+    markdown(text) {
+        const lines = text.split("\n");
+        let inCodeBlock = false;
+        let codeLanguage = "";
+        for (const line of lines) {
+            // Code block start/end
+            if (line.startsWith("```")) {
+                if (!inCodeBlock) {
+                    inCodeBlock = true;
+                    codeLanguage = line.slice(3).trim();
+                    const langLabel = codeLanguage ? ` ${codeLanguage}` : "";
+                    console.log(c(colors.dim, `  ┌──${langLabel}${"─".repeat(Math.max(0, 40 - langLabel.length))}`));
+                }
+                else {
+                    inCodeBlock = false;
+                    codeLanguage = "";
+                    console.log(c(colors.dim, `  └${"─".repeat(44)}`));
+                }
+                continue;
+            }
+            if (inCodeBlock) {
+                console.log(`  ${c(colors.dim, "│")} ${c(colors.green, line)}`);
+                continue;
+            }
+            // Headers
+            if (line.startsWith("### ")) {
+                console.log(c(colors.bold + colors.white, `  ${line.slice(4)}`));
+                continue;
+            }
+            if (line.startsWith("## ")) {
+                console.log(c(colors.bold + colors.cyan, `  ${line.slice(3)}`));
+                continue;
+            }
+            if (line.startsWith("# ")) {
+                console.log(c(colors.bold + colors.cyan, `  ${line.slice(2)}`));
+                continue;
+            }
+            // Bold (**text**)
+            let formatted = line.replace(/\*\*(.+?)\*\*/g, (_, content) => c(colors.bold, content));
+            // Inline code (`text`)
+            formatted = formatted.replace(/`(.+?)`/g, (_, content) => c(colors.yellow, content));
+            console.log(`  ${formatted}`);
+        }
+    }
+    /** Print a horizontal separator */
+    separator() {
+        console.log(c(colors.dim, "  " + "─".repeat(50)));
+    }
+    /** Print agent response text */
+    agentResponse(text) {
+        console.log();
+        this.markdown(text);
+        console.log();
+    }
+    /** Print the prompt indicator for interactive mode */
+    prompt() {
+        process.stdout.write(c(colors.cyan + colors.bold, "\n❯ "));
+    }
+    /** Stream a token (no newline, real-time output) */
+    streamToken(token) {
+        process.stdout.write(token);
+    }
+    /** End a streaming sequence (newline + reset) */
+    endStream() {
+        process.stdout.write("\n");
+    }
+    /** Create a spinner with custom message */
+    spinner(message) {
+        return new Spinner(message);
+    }
+}
+//# sourceMappingURL=renderer.js.map

package/dist/renderer.js.map

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

package/dist/session.d.ts

@@ -0,0 +1,71 @@
+/**
+ * YUAN CLI — Session Manager
+ *
+ * Handles saving/loading agent sessions for `yuan resume`.
+ * Connects to @yuaone/core SessionPersistence for disk-level persistence
+ * with checkpointing and crash recovery support.
+ */
+import { type SessionSnapshot, type SessionStatus } from "@yuaone/core";
+/** A single message in the conversation (CLI-level) */
+export interface SessionMessage {
+    role: "user" | "assistant" | "system";
+    content: string;
+    timestamp: number;
+}
+/** Stored session data (CLI-level, maps to core's PersistentSessionData) */
+export interface SessionData {
+    id: string;
+    createdAt: number;
+    updatedAt: number;
+    workDir: string;
+    messages: SessionMessage[];
+    provider: string;
+    model: string;
+    status: SessionStatus;
+    iteration: number;
+    tokenUsage: {
+        input: number;
+        output: number;
+    };
+}
+/**
+ * SessionManager — save/load/resume agent sessions.
+ *
+ * Wraps @yuaone/core SessionPersistence with CLI-friendly interface.
+ * Sessions are stored in ~/.yuan/sessions/<sessionId>/ with:
+ * - state.json: metadata
+ * - messages.json: conversation history
+ * - checkpoint.json: iteration/token state
+ */
+export declare class SessionManager {
+    private readonly persistence;
+    constructor(baseDir?: string);
+    /** Create a new session */
+    create(workDir: string, provider: string, model: string): SessionData;
+    /** Save a session to disk (via core SessionPersistence) */
+    save(session: SessionData): void;
+    /** Load a session by ID */
+    load(sessionId: string): SessionData | null;
+    /** Load the last session */
+    loadLast(): SessionData | null;
+    /** Get the last session ID */
+    getLastSessionId(): string | null;
+    /** Add a message to a session */
+    addMessage(session: SessionData, role: "user" | "assistant" | "system", content: string): void;
+    /** Save a checkpoint (called after each iteration) */
+    saveCheckpoint(session: SessionData, changedFiles?: string[], lastToolCall?: string): Promise<void>;
+    /** Update session status */
+    updateStatus(session: SessionData, status: SessionStatus): Promise<void>;
+    /** List recent sessions (async) */
+    listSessions(limit?: number): Promise<SessionSnapshot[]>;
+    /** List recent sessions (sync for CLI display) */
+    listRecent(limit?: number): SessionData[];
+    /** Detect crashed sessions */
+    detectCrashed(): Promise<SessionSnapshot[]>;
+    /** Clean up old sessions */
+    cleanup(maxAgeDays?: number): Promise<number>;
+    private toSnapshot;
+    /** Sync load from disk (for CLI compatibility) */
+    private loadSync;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,EAEL,KAAK,eAAe,EAGpB,KAAK,aAAa,EACnB,MAAM,cAAc,CAAC;AAMtB,uDAAuD;AACvD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,4EAA4E;AAC5E,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/C;AAED;;;;;;;;GAQG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;gBAErC,OAAO,CAAC,EAAE,MAAM;IAI5B,2BAA2B;IAC3B,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW;IAyBrE,2DAA2D;IAC3D,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAmChC,2BAA2B;IAC3B,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAI3C,4BAA4B;IAC5B,QAAQ,IAAI,WAAW,GAAG,IAAI;IAM9B,8BAA8B;IAC9B,gBAAgB,IAAI,MAAM,GAAG,IAAI;IAWjC,iCAAiC;IACjC,UAAU,CACR,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,EACrC,OAAO,EAAE,MAAM,GACd,IAAI;IASP,sDAAsD;IAChD,cAAc,CAClB,OAAO,EAAE,WAAW,EACpB,YAAY,GAAE,MAAM,EAAO,EAC3B,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC;IAWhB,4BAA4B;IACtB,YAAY,CAChB,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,IAAI,CAAC;IAKhB,mCAAmC;IAC7B,YAAY,CAAC,KAAK,SAAK,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAI1D,kDAAkD;IAClD,UAAU,CAAC,KAAK,SAAK,GAAG,WAAW,EAAE;IAqDrC,8BAA8B;IACxB,aAAa,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAIjD,4BAA4B;IACtB,OAAO,CAAC,UAAU,SAAK,GAAG,OAAO,CAAC,MAAM,CAAC;IAM/C,OAAO,CAAC,UAAU;IAelB,kDAAkD;IAClD,OAAO,CAAC,QAAQ;CA2CjB"}