aura-code 0.6.3 → 0.10.1

package/dist/checkpoints/engine.js

@@ -0,0 +1,324 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.gitDirOf = gitDirOf;
+exports.createCheckpoint = createCheckpoint;
+exports.listCheckpoints = listCheckpoints;
+exports.restoreCheckpoint = restoreCheckpoint;
+exports.pruneCheckpoints = pruneCheckpoints;
+exports.deleteCheckpoint = deleteCheckpoint;
+/**
+ * Checkpoints — shadow-git snapshots of the working tree, so every agent
+ * write is cheaply reversible with `aura --undo` (or `:undo` in the REPL).
+ *
+ * How it works: before the first mutating tool call of each turn, the loop
+ * snapshots the ENTIRE working tree (tracked + untracked, .gitignore
+ * respected) into the repo's object store via a TEMPORARY index, then points
+ * a ref at it under `refs/aura/checkpoints/<id>`. The user's real index,
+ * HEAD, branches, and reflog are never touched — checkpoints are invisible
+ * to normal git workflows and are garbage-collectable once pruned.
+ *
+ * Restore diffs the snapshot tree against a fresh snapshot of "now", writes
+ * changed/added files back and deletes files that didn't exist at snapshot
+ * time. A pre-restore checkpoint is always taken first, so restore itself
+ * is undoable.
+ *
+ * Requires the project to be a git repository; in a non-repo all operations
+ * are silent no-ops (create returns null).
+ */
+const child_process_1 = require("child_process");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const REF_PREFIX = 'refs/aura/checkpoints/';
+/** Shadow commits need an ident but must never depend on user git config. */
+const SHADOW_IDENT = {
+    GIT_AUTHOR_NAME: 'aura-checkpoint',
+    GIT_AUTHOR_EMAIL: 'checkpoint@aura.local',
+    GIT_COMMITTER_NAME: 'aura-checkpoint',
+    GIT_COMMITTER_EMAIL: 'checkpoint@aura.local',
+};
+function git(root, args, extraEnv, stdin) {
+    return new Promise((resolve, reject) => {
+        const child = (0, child_process_1.execFile)('git', args, { cwd: root, env: { ...process.env, ...SHADOW_IDENT, ...extraEnv }, maxBuffer: 64 * 1024 * 1024 }, (err, stdout, stderr) => {
+            if (err)
+                reject(new Error(`git ${args[0]}: ${stderr || err.message}`));
+            else
+                resolve(stdout);
+        });
+        if (stdin !== undefined)
+            child.stdin?.end(stdin);
+        else
+            child.stdin?.end();
+    });
+}
+/** Absolute .git dir of the repo containing root, or null if not a repo. */
+async function gitDirOf(root) {
+    try {
+        return (await git(root, ['rev-parse', '--absolute-git-dir'])).trim();
+    }
+    catch {
+        return null;
+    }
+}
+// Monotonic within the process so ids created in the same millisecond still
+// sort in creation order (listCheckpoints sorts by refname).
+let lastIdTs = 0;
+function newId() {
+    lastIdTs = Math.max(Date.now(), lastIdTs + 1);
+    return `${lastIdTs.toString(36)}-${Math.random().toString(36).slice(2, 6)}`;
+}
+/**
+ * Common secret patterns that should never be captured in checkpoints.
+ * These patterns match files that contain API keys, tokens, or other secrets.
+ */
+const SECRET_PATTERNS = [
+    // Environment variable style: TOKEN=, API_KEY=, etc.
+    /^(?:TOKEN|API_KEY|SECRET|PASSWORD|AUTH|KEY|BEARER)\s*=/i,
+    // JSON style: "api_key": "sk_...", "token": "ghp_..."
+    /["'](?:api_key|token|secret|password|auth_key|bearer|access_token)["']?\s*:\s*["']?(?:sk_|pk_|ghp_|gho_|ghu_|glpat-|ey|Bearer)/i,
+    // Common API key patterns (more lenient)
+    /(?:sk_|pk_|ghp_|gho_|ghu_|glpat-)[a-zA-Z0-9_]{10,}/i,
+    // Bearer tokens
+    /Bearer\s+[a-zA-Z0-9_\-\.]{10,}/i,
+    // Private keys
+    /-----BEGIN\s+(?:RSA\s+)?PRIVATE\s+KEY-----/,
+    // Generic long base64-like strings (likely tokens)
+    /[a-zA-Z0-9_\-\.]{32,}/,
+];
+/**
+ * Check if a file contains potential secrets by scanning its content.
+ * Returns true if any secret pattern is matched.
+ */
+function fileContainsSecrets(content) {
+    for (const pattern of SECRET_PATTERNS) {
+        if (pattern.test(content))
+            return true;
+    }
+    return false;
+}
+/**
+ * Get list of files in the temporary index that should be excluded from checkpoints
+ * due to containing secrets.
+ */
+async function getSecretFilesFromIndex(root, env) {
+    const secretFiles = [];
+    try {
+        // Get all files in the temporary index (tracked + staged untracked files)
+        const out = await git(root, ['ls-files', '-z'], env);
+        const files = out.split('\0').filter(Boolean);
+        for (const file of files) {
+            const absPath = path.join(root, file);
+            try {
+                // Only check text-based files that might contain credentials
+                if (/\.(json|js|ts|mjs|env|config|sh|py|ya?ml|toml|ini|conf|txt|md)$/.test(file)) {
+                    const content = fs.readFileSync(absPath, 'utf8');
+                    if (fileContainsSecrets(content)) {
+                        secretFiles.push(file);
+                    }
+                }
+            }
+            catch (e) { /* skip files we can't read */ }
+        }
+    }
+    catch (e) { /* if git ls-files fails, return empty array */ }
+    return secretFiles;
+}
+/**
+ * Snapshot the working tree into the object store through a temporary index.
+ * Returns the tree hash. Never touches the user's real index.
+ *
+ * SECURITY: Excludes files containing secrets to prevent credential leakage
+ * into checkpoint refs. This is a critical safety measure since checkpoint refs
+ * live outside normal branches and won't be caught by standard secret scanning.
+ */
+async function writeShadowTree(root, gitDir) {
+    const tmpIndex = path.join(gitDir, `aura-checkpoint-index-${process.pid}`);
+    const env = { GIT_INDEX_FILE: tmpIndex };
+    try {
+        // Seed from HEAD when it exists so `add -A` computes a minimal update.
+        try {
+            await git(root, ['read-tree', 'HEAD'], env);
+        }
+        catch {
+            await git(root, ['read-tree', '--empty'], env);
+        }
+        // Add all files, respecting .gitignore (git add -A behavior)
+        await git(root, ['add', '-A', '--', '.'], env);
+        // CRITICAL: Remove any files that contain secrets (check AFTER adding to index)
+        const secretFiles = await getSecretFilesFromIndex(root, env);
+        if (secretFiles.length > 0) {
+            // Remove files with secrets from the index
+            await git(root, ['rm', '--cached', '--', ...secretFiles], env);
+            console.warn(`[checkpoint] Excluded ${secretFiles.length} file(s) containing secrets from checkpoint`);
+        }
+        return (await git(root, ['write-tree'], env)).trim();
+    }
+    finally {
+        try {
+            fs.unlinkSync(tmpIndex);
+        }
+        catch { /* already gone */ }
+    }
+}
+/**
+ * Create a checkpoint of the current working tree.
+ * Returns null when: not a git repo, or the tree is identical to the most
+ * recent checkpoint (deduped — repeated calls within a burst are no-ops).
+ */
+async function createCheckpoint(root, label) {
+    const gitDir = await gitDirOf(root);
+    if (!gitDir)
+        return null;
+    const tree = await writeShadowTree(root, gitDir);
+    const existing = await listCheckpoints(root);
+    if (existing[0]?.tree === tree)
+        return null;
+    let head = null;
+    try {
+        head = (await git(root, ['rev-parse', '--verify', 'HEAD'])).trim();
+    }
+    catch { /* unborn branch — parentless shadow commit */ }
+    const cleanLabel = label.replace(/\s+/g, ' ').trim().slice(0, 120) || 'checkpoint';
+    const commitArgs = ['commit-tree', tree, '-m', cleanLabel];
+    if (head)
+        commitArgs.push('-p', head);
+    const commit = (await git(root, commitArgs)).trim();
+    const id = newId();
+    const ref = REF_PREFIX + id;
+    await git(root, ['update-ref', ref, commit]);
+    return { id, ref, commit, tree, label: cleanLabel, createdAt: new Date().toISOString() };
+}
+/** All checkpoints for the repo containing root, newest first. */
+async function listCheckpoints(root) {
+    const gitDir = await gitDirOf(root);
+    if (!gitDir)
+        return [];
+    // Sort by refname, not creatordate: commit dates have 1-second resolution,
+    // while ids embed a base36 ms timestamp that sorts correctly lexically.
+    const out = await git(root, [
+        'for-each-ref', '--sort=-refname',
+        '--format=%(refname)%09%(objectname)%09%(tree)%09%(creatordate:iso-strict)%09%(subject)',
+        REF_PREFIX,
+    ]);
+    return out.split('\n').filter(Boolean).map(line => {
+        const [ref, commit, tree, createdAt, ...subject] = line.split('\t');
+        return {
+            id: ref.slice(REF_PREFIX.length),
+            ref, commit, tree, createdAt,
+            label: subject.join('\t'),
+        };
+    });
+}
+/**
+ * Restore the working tree to the state captured by checkpoint `id`
+ * (or the most recent checkpoint when id is omitted).
+ *
+ * Only paths that differ are touched; the user's index/HEAD stay put, so
+ * after a restore `git status` simply reflects the restored content.
+ */
+async function restoreCheckpoint(root, id) {
+    const gitDir = await gitDirOf(root);
+    if (!gitDir)
+        throw new Error('Not a git repository — checkpoints unavailable.');
+    const all = await listCheckpoints(root);
+    if (all.length === 0)
+        throw new Error('No checkpoints exist for this repository.');
+    const target = id ? all.find(c => c.id === id) : all[0];
+    if (!target)
+        throw new Error(`Checkpoint not found: ${id}`);
+    // Snapshot "now" first — makes the restore itself undoable, and gives us
+    // the tree to diff against. createCheckpoint dedupes, so when the tree
+    // hasn't changed since the latest checkpoint we reuse that one's tree.
+    const preRestore = await createCheckpoint(root, `pre-restore (before restoring ${target.id})`);
+    const nowTree = preRestore?.tree ?? (await listCheckpoints(root))[0].tree;
+    if (nowTree === target.tree)
+        return { restored: [], deleted: [], preRestore };
+    // -z output: STATUS NUL path NUL … — statuses relative nowTree → target:
+    //   A = exists only in the snapshot (write it back)
+    //   D = exists only now (delete it)
+    //   M/T = content/type differs (write it back)
+    const raw = await git(root, ['diff-tree', '-r', '-z', '--name-status', nowTree, target.tree]);
+    const parts = raw.split('\0').filter(p => p.length > 0);
+    const toWrite = [];
+    const toDelete = [];
+    for (let i = 0; i + 1 < parts.length; i += 2) {
+        const status = parts[i];
+        const file = parts[i + 1];
+        if (status === 'D')
+            toDelete.push(file);
+        else
+            toWrite.push(file);
+    }
+    for (const file of toDelete) {
+        try {
+            fs.rmSync(path.join(root, file), { force: true });
+        }
+        catch { /* best-effort */ }
+    }
+    if (toWrite.length > 0) {
+        const tmpIndex = path.join(gitDir, `aura-restore-index-${process.pid}`);
+        const env = { GIT_INDEX_FILE: tmpIndex };
+        try {
+            await git(root, ['read-tree', target.tree], env);
+            await git(root, ['checkout-index', '-f', '-z', '--stdin'], env, toWrite.join('\0') + '\0');
+        }
+        finally {
+            try {
+                fs.unlinkSync(tmpIndex);
+            }
+            catch { /* already gone */ }
+        }
+    }
+    return { restored: toWrite, deleted: toDelete, preRestore };
+}
+/** Delete all but the newest `keep` checkpoints. Returns how many were pruned. */
+async function pruneCheckpoints(root, keep) {
+    const all = await listCheckpoints(root);
+    const stale = all.slice(Math.max(0, keep));
+    for (const cp of stale) {
+        await git(root, ['update-ref', '-d', cp.ref]);
+    }
+    return stale.length;
+}
+/** Delete a single checkpoint by id. */
+async function deleteCheckpoint(root, id) {
+    const all = await listCheckpoints(root);
+    const cp = all.find(c => c.id === id);
+    if (!cp)
+        return false;
+    await git(root, ['update-ref', '-d', cp.ref]);
+    return true;
+}
+//# sourceMappingURL=engine.js.map

package/dist/checkpoints/engine.js.map

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

package/dist/cli/command-palette.d.ts

@@ -0,0 +1,26 @@
+export interface PaletteCommand {
+    id: string;
+    label: string;
+    description: string;
+    category: string;
+}
+/**
+ * All commands available in the palette. Derived from help-data.ts
+ * but kept as a static list here to avoid circular imports.
+ */
+export declare const PALETTE_COMMANDS: PaletteCommand[];
+/**
+ * Fuzzy-match a query against a command's label + id.
+ * Returns a score (lower = better match), or -1 for no match.
+ */
+export declare function fuzzyMatch(query: string, text: string): number;
+/**
+ * Filter and sort commands by fuzzy match score.
+ */
+export declare function filterCommands(query: string): PaletteCommand[];
+/**
+ * Render the palette overlay. Returns styled lines to draw.
+ * `selectedIdx` is the currently highlighted item.
+ * `maxVisible` controls how many items fit in the overlay.
+ */
+export declare function renderPalette(commands: PaletteCommand[], query: string, selectedIdx: number, maxVisible: number, width: number): string[];

package/dist/cli/command-palette.js

@@ -0,0 +1,133 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PALETTE_COMMANDS = void 0;
+exports.fuzzyMatch = fuzzyMatch;
+exports.filterCommands = filterCommands;
+exports.renderPalette = renderPalette;
+/**
+ * Command palette — Ctrl+P opens a fuzzy-searchable list of all
+ * :commands. Inspired by OpenCode's Ctrl+P palette.
+ *
+ * Renders an overlay panel at the bottom of the screen (above the
+ * input box in bottom-input layout). User types to filter, arrow
+ * keys to navigate, Enter to execute, Esc to cancel.
+ */
+const chalk_1 = __importDefault(require("chalk"));
+const diamond_js_1 = require("./diamond.js");
+const TEXT = chalk_1.default.hex(diamond_js_1.TEXT_HEX);
+const TEXT_DIM = chalk_1.default.hex(diamond_js_1.TEXT_DIM_HEX);
+const RUBY = diamond_js_1.RUBY_ACCENT;
+const HIGHLIGHT = chalk_1.default.hex('#cc785c');
+/**
+ * All commands available in the palette. Derived from help-data.ts
+ * but kept as a static list here to avoid circular imports.
+ */
+exports.PALETTE_COMMANDS = [
+    // Session
+    { id: ':id', label: 'Show session ID', description: 'Current chat ID', category: 'Session' },
+    { id: ':sessions', label: 'List sessions', description: 'All saved sessions', category: 'Session' },
+    { id: ':resume', label: 'Resume session', description: 'Resume latest session', category: 'Session' },
+    { id: ':new', label: 'New session', description: 'Start fresh session', category: 'Session' },
+    { id: ':history', label: 'Show history', description: 'Turn count in current session', category: 'Session' },
+    { id: ':save', label: 'Save session', description: 'Rename/save current session', category: 'Session' },
+    // Model
+    { id: ':model', label: 'Switch model', description: 'Interactive model selector', category: 'Model / API' },
+    { id: ':models', label: 'List models', description: 'All available models', category: 'Model / API' },
+    { id: ':provider', label: 'Provider wizard', description: 'Pick provider, model, key', category: 'Model / API' },
+    { id: ':apikey', label: 'Set API key', description: 'Set API key for session', category: 'Model / API' },
+    // Workflows
+    { id: ':workflows', label: 'List workflows', description: 'All saved workflows', category: 'Workflows' },
+    { id: ':workflow', label: 'Create workflow', description: 'Multi-step workflow', category: 'Workflows' },
+    { id: ':machina', label: 'Machina task', description: 'Self-verification + auto-retry', category: 'Workflows' },
+    { id: ':council', label: 'Council', description: 'Parallel read-only specialists', category: 'Workflows' },
+    { id: ':q add', label: 'Queue task', description: 'Enqueue a task', category: 'Workflows' },
+    { id: ':q list', label: 'Queue list', description: 'List queued tasks', category: 'Workflows' },
+    // Memory
+    { id: ':dream', label: 'Dream', description: 'Consolidate episodes', category: 'Memory' },
+    { id: ':rem', label: 'Show memory', description: 'Reconciled memory', category: 'Memory' },
+    { id: ':mine', label: 'Mine patterns', description: 'Mine episodes for patterns', category: 'Memory' },
+    { id: ':research', label: 'Research', description: 'Multi-step research pass', category: 'Memory' },
+    { id: ':btw', label: 'Side question', description: 'Quick read-only question', category: 'Memory' },
+    // Voice
+    { id: ':speak', label: 'Toggle voice', description: 'Read replies aloud', category: 'Voice' },
+    // Safety
+    { id: ':approve', label: 'Toggle auto-approve', description: 'Skip y/N prompts', category: 'Safety' },
+    // System
+    { id: ':help', label: 'Help', description: 'Show all commands', category: 'System' },
+    { id: ':q', label: 'Quit', description: 'Exit Aura', category: 'System' },
+    { id: ':context', label: 'Context health', description: 'Token usage dashboard', category: 'System' },
+    { id: ':doctor', label: 'Doctor', description: 'Run health checks', category: 'System' },
+];
+/**
+ * Fuzzy-match a query against a command's label + id.
+ * Returns a score (lower = better match), or -1 for no match.
+ */
+function fuzzyMatch(query, text) {
+    if (!query)
+        return 0;
+    const q = query.toLowerCase();
+    const t = text.toLowerCase();
+    // Exact substring match — best
+    const idx = t.indexOf(q);
+    if (idx >= 0)
+        return idx;
+    // Fuzzy: all chars of query appear in order in text
+    let qi = 0;
+    let score = 0;
+    let lastMatchPos = -1;
+    for (let ti = 0; ti < t.length && qi < q.length; ti++) {
+        if (t[ti] === q[qi]) {
+            score += lastMatchPos >= 0 ? (ti - lastMatchPos) : 0;
+            lastMatchPos = ti;
+            qi++;
+        }
+    }
+    return qi === q.length ? score + 100 : -1;
+}
+/**
+ * Filter and sort commands by fuzzy match score.
+ */
+function filterCommands(query) {
+    if (!query)
+        return exports.PALETTE_COMMANDS;
+    const scored = exports.PALETTE_COMMANDS.map(cmd => {
+        const score = fuzzyMatch(query, cmd.label + ' ' + cmd.id);
+        return { cmd, score };
+    }).filter(s => s.score >= 0);
+    scored.sort((a, b) => a.score - b.score);
+    return scored.map(s => s.cmd);
+}
+/**
+ * Render the palette overlay. Returns styled lines to draw.
+ * `selectedIdx` is the currently highlighted item.
+ * `maxVisible` controls how many items fit in the overlay.
+ */
+function renderPalette(commands, query, selectedIdx, maxVisible, width) {
+    const lines = [];
+    // Header
+    lines.push(TEXT_DIM('  ┌─ command palette ' + '─'.repeat(Math.max(0, width - 21)) + '┐'));
+    lines.push(TEXT_DIM('  │ ') + RUBY(query) + TEXT_DIM('_'.repeat(Math.max(0, width - query.length - 6)) + ' │'));
+    const visible = commands.slice(0, maxVisible);
+    const actualSelected = Math.min(selectedIdx, visible.length - 1);
+    for (let i = 0; i < visible.length; i++) {
+        const cmd = visible[i];
+        const isSelected = i === actualSelected;
+        const prefix = isSelected ? RUBY('▸ ') : '  ';
+        const label = isSelected ? HIGHLIGHT.bold(cmd.label) : TEXT(cmd.label);
+        const desc = TEXT_DIM(`  ${cmd.description}`);
+        const cat = TEXT_DIM(` [${cmd.category}]`);
+        const content = `${prefix}${label}${desc}${cat}`;
+        const truncContent = content.length > width - 4
+            ? content.slice(0, width - 5) + '…'
+            : content;
+        lines.push(TEXT_DIM('  │ ') + truncContent + TEXT_DIM(' │'));
+    }
+    // Footer
+    lines.push(TEXT_DIM('  └' + '─'.repeat(width - 4) + '┘'));
+    lines.push(TEXT_DIM('  ↑↓ navigate · Enter select · Esc cancel'));
+    return lines;
+}
+//# sourceMappingURL=command-palette.js.map

package/dist/cli/command-palette.js.map

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

package/dist/cli/context-health.d.ts

@@ -0,0 +1,51 @@
+import type { HistoryMessage } from '../providers/types.js';
+export interface LargestMessage {
+    role: string;
+    preview: string;
+    tokens: number;
+    index: number;
+}
+export interface CompactionEvent {
+    turn: number;
+    beforeTokens: number;
+    afterTokens: number;
+    generation: number;
+}
+export interface ContextHealth {
+    estimatedTokens: number;
+    contextWindow: number;
+    usagePercent: number;
+    recapGeneration: number;
+    nextCompactionThreshold: number;
+    nextCompactionPercent: number;
+    tokensUntilCompaction: number;
+    rolloversRemaining: number;
+    totalInputTokens: number;
+    totalOutputTokens: number;
+    totalCostUsd: number;
+    turnCount: number;
+    toolCallCount: number;
+    compactionCount: number;
+    largestMessages: LargestMessage[];
+    compactionHistory: CompactionEvent[];
+}
+export declare class ContextHealthTracker {
+    private getSystem;
+    private getHistory;
+    private model;
+    private pricingModel;
+    private compactionEvents;
+    private _turnCount;
+    private _toolCallCount;
+    constructor(getSystem: () => string, getHistory: () => HistoryMessage[], model: string, pricingModel: string);
+    incrementTurn(): void;
+    incrementToolCalls(n?: number): void;
+    /** Replace the system-prompt source — used when a shared tracker is passed
+     *  into the loop and the loop builds the real (task-embedded) system prompt. */
+    updateSystem(s: string): void;
+    recordCompaction(beforeTokens: number, afterTokens: number, generation: number): void;
+    snapshot(inputTokens?: number, outputTokens?: number): ContextHealth;
+}
+export declare function formatContextBar(h: ContextHealth): string;
+export declare function formatContextDashboard(h: ContextHealth): string;
+export declare function formatCompactionEvent(beforeTokens: number, afterTokens: number, generation: number, threshold: number): string;