mythos-router 1.0.0 → 1.1.1

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 thewaltero
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 thewaltero
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,220 +1,213 @@
 <div align="center">
 
-# MYTHOS
-
-### Capybara Tier · Claude Opus 4.6 · Strict Write Discipline
-
-**The leaked Anthropic reasoning protocol. Running locally.**
-
-[![npm](https://img.shields.io/npm/v/mythos-router?style=flat-square&color=cc785c)](https://www.npmjs.com/package/mythos-router)
+<pre>
+    ███╗   ███╗██╗   ██╗████████╗██╗  ██╗ ██████╗ ███████╗
+    ████╗ ████║╚██╗ ██╔╝╚══██╔══╝██║  ██║██╔═══██╗██╔════╝
+    ██╔████╔██║ ╚████╔╝    ██║   ███████║██║   ██║███████╗
+    ██║╚██╔╝██║  ╚██╔╝     ██║   ██╔══██║██║   ██║╚════██║
+    ██║ ╚═╝ ██║   ██║      ██║   ██║  ██║╚██████╔╝███████║
+    ╚═╝     ╚═╝   ╚═╝      ╚═╝   ╚═╝  ╚═╝ ╚═════╝ ╚══════╝
+</pre>
+
+### Claude-powered CLI agent framework for structured execution, memory, and verification
+
+[![npm](https://img.shields.io/npm/v/mythos-router?style=flat-square)](https://www.npmjs.com/package/mythos-router)
 [![Node.js](https://img.shields.io/badge/Node.js-20+-339933?style=flat-square&logo=node.js&logoColor=white)](https://nodejs.org)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.7-3178C6?style=flat-square&logo=typescript&logoColor=white)](https://typescriptlang.org)
-[![Claude](https://img.shields.io/badge/Claude-Opus_4.6-cc785c?style=flat-square)](https://anthropic.com)
 [![License](https://img.shields.io/badge/License-MIT-green?style=flat-square)](./LICENSE)
-[![GitHub stars](https://img.shields.io/github/stars/thewaltero/mythos-router?style=social)](https://github.com/thewaltero/mythos-router)
-
-<p align="center">
-  <img src="assets/demo.png" alt="mythos-router terminal demo" width="700" />
-</p>
-
-```bash
-# Try it now
-npx mythos-router chat
-```
 
 </div>
 
 ---
 
-## What is this?
+## Overview
 
-**mythos-router** is a local CLI power tool that implements the *leaked Anthropic "Capybara" reasoning protocol* — the specialized tier designed for PhD-level reasoning and cybersecurity analysis.
+**mythos-router** is a local CLI framework for building structured AI agent workflows using the Anthropic API.
 
-Unlike standard Claude wrappers, mythos-router enforces **Strict Write Discipline (SWD)**: every file operation the AI claims to perform is *verified against the actual filesystem*. If the model hallucinates a write, it gets a Correction Turn. If it fails twice, it yields to the human.
+It extends standard LLM interactions with:
+- deterministic file operation verification
+- session-based memory logging
+- token budgeting and cost tracking
+- optional execution tracing and dry-run mode
 
-Zero slop. Zero hallucinated state. Full adaptive thinking.
+The goal is to make LLM-assisted development more **traceable, controllable, and reproducible**.
 
 ---
 
-## Features
+## Key Features
 
 | Feature | Description |
-|---------|-------------|
-| 🧠 **Adaptive Thinking** | Opus 4.6 with configurable effort levels (high/medium/low) |
-| 🔒 **Strict Write Discipline** | Pre/post filesystem snapshots verify every model claim |
-| 💤 **Self-Healing Memory** | `MEMORY.md` logs every action; auto-compresses via "Dream" |
-| ⟲ **Correction Turns** | Model gets 2 retries to match filesystem reality, then yields |
-| 📋 **Drift Detection** | `verify` command syncs codebase state with memory |
-| 🚀 **Zero Build** | Runs directly via `tsx` — no compile step in dev |
+|--------|-------------|
+| 🧠 Agentic chat runtime | Interactive CLI powered by Claude models |
+| 📁 Execution verification | File operations are validated against filesystem state |
+| 🧾 Session memory | Persistent `MEMORY.md` logs all actions |
+| 💰 Token budgeting | Track and limit usage per session |
+| 🔍 Dry-run mode | Preview file changes before execution |
+| 📊 Verbose tracing | Inspect internal reasoning and execution steps |
+| 🔁 Drift detection | Compare memory state with actual filesystem |
+| ⚡ Zero build runtime | Runs directly via `tsx` in development |
 
 ---
 
 ## Installation
 
-### Quick Start (npm)
-
+### Global install
 ```bash
-# Install globally
 npm install -g mythos-router
-
-# Set your API key
-export ANTHROPIC_API_KEY="sk-ant-..."
-# Windows: $env:ANTHROPIC_API_KEY = "sk-ant-..."
-
-# Go
-mythos chat
 ```
 
-### Or try without installing
-
+### Run without installation
 ```bash
 npx mythos-router chat
 ```
 
-### From Source
-
+### From source
 ```bash
 git clone https://github.com/thewaltero/mythos-router.git
 cd mythos-router
-npm install
-npm run chat
+npm install --ignore-scripts
 ```
 
 ---
 
-## Usage
+## Setup
 
-### `mythos chat` — Interactive Capybara Session
+Set your Anthropic API key:
 
-```bash
-mythos chat                  # Full power (high effort)
-mythos chat --effort low     # Budget mode
-mythos chat --effort medium  # Balanced
+**Windows (PowerShell)**
+```powershell
+$env:ANTHROPIC_API_KEY="sk-ant-..."
 ```
 
-In-session commands:
-- `/exit` — End session
-- `/memory` — Show memory status
-- `/clear` — Clear conversation (memory persists)
-
-### `mythos verify` — Zero-Drift Codebase Scan
-
+**macOS / Linux**
 ```bash
-mythos verify
+export ANTHROPIC_API_KEY="sk-ant-..."
 ```
 
-Scans every file in your project and cross-references against `MEMORY.md`:
-- ✅ **Verified** — File state matches memory
-- ⚠️ **Drift** — File changed but memory doesn't reflect it
-- ❌ **Missing** — Memory references a file that doesn't exist
+---
 
-### `mythos dream` — Memory Compression
+## Usage
 
+### Start interactive chat
 ```bash
-mythos dream          # Auto-compress when needed
-mythos dream --force  # Force compression
+mythos chat
 ```
 
-When `MEMORY.md` exceeds 100 entries, older logs are compressed into a summary block using Claude (low effort, minimal token burn). Recent entries are preserved intact.
+### Modes
+```bash
+mythos chat --effort high       # deeper reasoning
+mythos chat --effort medium     # balanced
+mythos chat --effort low        # faster responses
+```
 
 ---
 
-## Architecture
+## Safety & Execution Control
 
-```
-mythos-router/
-├── src/
-│   ├── cli.ts           # Commander.js entry point
-│   ├── config.ts        # Capybara system prompt + constants
-│   ├── client.ts        # Anthropic SDK (adaptive thinking)
-│   ├── swd.ts           # Strict Write Discipline engine
-│   ├── memory.ts        # MEMORY.md self-healing manager
-│   ├── utils.ts         # Terminal formatting (zero-dep)
-│   └── commands/
-│       ├── chat.ts      # Interactive REPL
-│       ├── verify.ts    # Codebase ↔ Memory scanner
-│       └── dream.ts     # Memory compression
-├── .mythosignore        # SWD scan exclusions
-├── MEMORY.md            # Auto-generated agentic memory
-└── AGENTS.md            # Project conventions
+### Dry-run mode
+Preview file operations before applying changes:
+```bash
+mythos chat --dry-run
 ```
 
-### The SWD Protocol
-
+### Verbose mode
+Inspect execution steps and verification logic:
+```bash
+mythos chat --verbose
 ```
-User Input
-    │
-    ▼
-[Pre-Snapshot] ── filesystem state captured
-    │
-    ▼
-[Claude Opus 4.6] ── adaptive thinking (high effort)
-    │
-    ▼
-[Parse FILE_ACTION blocks] ── extract claimed operations
-    │
-    ▼
-[Post-Snapshot] ── filesystem state re-captured
-    │
-    ▼
-[Verify] ── before vs. after vs. model claims
-    │
-    ├── ✅ All verified → Log to MEMORY.md
-    │
-    └── ❌ Mismatch → Correction Turn (max 2 retries)
-                │
-                └── Still failing → Yield to human
+
+### Combined
+```bash
+mythos chat --dry-run --verbose
 ```
 
 ---
 
-## MEMORY.md — Should You Commit It?
+## Token Budgeting
 
-**Yes.** `MEMORY.md` is designed to be committed to your repository. It becomes a "collaborative brain" where:
-- Multiple developers can see what the AI did in previous sessions
-- Different AI agents can reference past context
-- You get a full audit trail of every AI-assisted file operation
+`mythos-router` includes a built-in usage tracker for session cost control.
 
-If you prefer to keep it private, add `MEMORY.md` to your `.gitignore`.
+```bash
+mythos chat --max-tokens 100000
+mythos chat --max-turns 10
+mythos chat --no-budget
+```
+
+When limits are reached, the session performs a graceful save of state into `MEMORY.md`.
 
 ---
 
-## The Capybara System Prompt
+## Commands
 
-The system prompt implements the leaked Anthropic protocol:
+### Chat session
+```bash
+mythos chat
+```
 
-> **Tier: Capybara** (Specialized in Cybersecurity & PhD Reasoning)
->
-> Follow 'Strict Write Discipline' and never hallucinate filesystem state.
-> Every file operation must be wrapped in `[FILE_ACTION]` blocks for verification.
+### Codebase verification
+Scans filesystem state and compares it with recorded memory:
+```bash
+mythos verify
+mythos verify --dry-run
+```
 
-The model is instructed to emit machine-readable delimiters around every file operation, making SWD verification 100% reliable.
+### Memory compression
+Reduces size of `MEMORY.md` while preserving recent context:
+```bash
+mythos dream
+mythos dream --dry-run
+```
 
 ---
 
-## Configuration
+## Architecture
+
+```text
+src/
+├── cli.ts            # CLI entry (Commander.js)
+├── client.ts         # Anthropic API client
+├── config.ts         # Model + runtime configuration
+├── budget.ts         # Token and turn tracking
+├── swd.ts            # File operation verification layer
+├── memory.ts         # MEMORY.md system
+├── utils.ts          # CLI utilities
+└── commands/
+    ├── chat.ts
+    ├── verify.ts
+    └── dream.ts
+```
 
-| Env Variable | Required | Description |
-|-------------|----------|-------------|
-| `ANTHROPIC_API_KEY` | ✅ | Your Anthropic API key |
+---
 
-| File | Purpose |
-|------|---------|
-| `.mythosignore` | Patterns to exclude from SWD scanning |
-| `MEMORY.md` | Auto-generated agentic memory log |
+## Execution Model
+
+1. User input is received in CLI
+2. LLM generates response with structured file operations
+3. File system snapshot is captured
+4. Proposed changes are validated against actual filesystem state
+5. Verified actions are applied and logged to `MEMORY.md`
+6. Drift or mismatches trigger correction handling
 
 ---
 
-## Token Usage
+## MEMORY.md
+
+`MEMORY.md` acts as a persistent execution log of the agent system.
+
+It records:
+- executed file operations
+- session summaries
+- verification results
 
-| Mode | Typical Cost Per Turn |
-|------|----------------------|
-| `--effort high` | Full Opus 4.6 pricing (deep reasoning) |
-| `--effort medium` | Balanced — good for most tasks |
-| `--effort low` | Minimal thinking — quick answers |
-| `dream` | Low effort summarization (~500 tokens) |
+It can optionally be committed to version control for collaborative AI-assisted development.
 
-Token counts are displayed after every chat response.
+---
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `ANTHROPIC_API_KEY` | Yes | API key for Anthropic models |
 
 ---
 
@@ -224,6 +217,8 @@ MIT
 
 ---
 
-<div align="center">
-<sub>Built with the leaked Capybara protocol. No affiliation with Anthropic. Use responsibly.</sub>
-</div>
+## Disclaimer
+
+This project is an independent open-source tool built on top of the Anthropic API. It is not affiliated with or endorsed by Anthropic.
+
+<div align="center"><sub>Built for structured AI agent workflows with verifiable execution.</sub></div>

package/dist/budget.d.ts

@@ -0,0 +1,47 @@
+export interface BudgetConfig {
+    maxTokens: number;
+    maxTurns: number;
+    warnAtPercent: number;
+    /** Cost per input token in USD (update when Anthropic changes pricing) */
+    costPerInputToken: number;
+    /** Cost per output token in USD (update when Anthropic changes pricing) */
+    costPerOutputToken: number;
+}
+export interface BudgetCheck {
+    ok: boolean;
+    reason?: string;
+    tokensPercent: number;
+    turnsPercent: number;
+    warning: boolean;
+    /** True when budget is exhausted — signals the caller to perform a graceful save */
+    exhausted: boolean;
+}
+export interface BudgetSnapshot {
+    totalTokens: number;
+    inputTokens: number;
+    outputTokens: number;
+    turns: number;
+    maxTokens: number;
+    maxTurns: number;
+    startedAt: number;
+    elapsedMs: number;
+    /** Estimated cost in USD based on configured token pricing */
+    estimatedCostUSD: number;
+}
+export declare class SessionBudget {
+    private config;
+    private totalInput;
+    private totalOutput;
+    private turnCount;
+    private startedAt;
+    private enabled;
+    constructor(config?: Partial<BudgetConfig>, enabled?: boolean);
+    record(inputTokens: number, outputTokens: number): void;
+    check(): BudgetCheck;
+    status(): BudgetSnapshot;
+    isEnabled(): boolean;
+    formatBar(width?: number): string;
+    formatWarning(): string | null;
+    formatSessionSummary(): string;
+}
+//# sourceMappingURL=budget.d.ts.map

package/dist/budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../src/budget.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,0EAA0E;IAC1E,iBAAiB,EAAE,MAAM,CAAC;IAC1B,2EAA2E;IAC3E,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,oFAAoF;IACpF,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAGD,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAU;gBAEb,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,EAAE,OAAO,UAAO;IAa1D,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAOvD,KAAK,IAAI,WAAW;IA6CpB,MAAM,IAAI,cAAc;IAkBxB,SAAS,IAAI,OAAO;IAKpB,SAAS,CAAC,KAAK,SAAK,GAAG,MAAM;IAkC7B,aAAa,IAAI,MAAM,GAAG,IAAI;IA6B9B,oBAAoB,IAAI,MAAM;CAQ/B"}

package/dist/budget.js

@@ -0,0 +1,157 @@
+// ─────────────────────────────────────────────────────────────
+//  mythos-router :: budget.ts
+//  Session Budget Limiter — Financial safety switch
+// ─────────────────────────────────────────────────────────────
+import { DEFAULT_MAX_TOKENS_PER_SESSION, DEFAULT_MAX_TURNS, BUDGET_WARN_PERCENT, COST_PER_INPUT_TOKEN, COST_PER_OUTPUT_TOKEN, } from './config.js';
+import { c } from './utils.js';
+// ── Session Budget Class ─────────────────────────────────────
+export class SessionBudget {
+    config;
+    totalInput = 0;
+    totalOutput = 0;
+    turnCount = 0;
+    startedAt;
+    enabled;
+    constructor(config, enabled = true) {
+        this.config = {
+            maxTokens: config?.maxTokens ?? DEFAULT_MAX_TOKENS_PER_SESSION,
+            maxTurns: config?.maxTurns ?? DEFAULT_MAX_TURNS,
+            warnAtPercent: config?.warnAtPercent ?? BUDGET_WARN_PERCENT,
+            costPerInputToken: config?.costPerInputToken ?? COST_PER_INPUT_TOKEN,
+            costPerOutputToken: config?.costPerOutputToken ?? COST_PER_OUTPUT_TOKEN,
+        };
+        this.startedAt = Date.now();
+        this.enabled = enabled;
+    }
+    // ── Record token usage after an API call ─────────────────
+    record(inputTokens, outputTokens) {
+        this.totalInput += inputTokens;
+        this.totalOutput += outputTokens;
+        this.turnCount++;
+    }
+    // ── Check if budget is still ok ──────────────────────────
+    check() {
+        if (!this.enabled) {
+            return { ok: true, tokensPercent: 0, turnsPercent: 0, warning: false, exhausted: false };
+        }
+        const totalTokens = this.totalInput + this.totalOutput;
+        const tokensPercent = (totalTokens / this.config.maxTokens) * 100;
+        const turnsPercent = (this.turnCount / this.config.maxTurns) * 100;
+        const warning = tokensPercent >= this.config.warnAtPercent ||
+            turnsPercent >= this.config.warnAtPercent;
+        // Token limit exceeded
+        if (totalTokens >= this.config.maxTokens) {
+            return {
+                ok: false,
+                exhausted: true,
+                reason: `Session budget exhausted: ${totalTokens.toLocaleString()}/${this.config.maxTokens.toLocaleString()} tokens ` +
+                    `used across ${this.turnCount} turns. ` +
+                    `Use --max-tokens <n> to increase or --no-budget to disable.`,
+                tokensPercent: Math.min(tokensPercent, 100),
+                turnsPercent,
+                warning: true,
+            };
+        }
+        // Turn limit exceeded
+        if (this.turnCount >= this.config.maxTurns) {
+            return {
+                ok: false,
+                exhausted: true,
+                reason: `Session turn limit reached: ${this.turnCount}/${this.config.maxTurns} turns. ` +
+                    `Use --max-turns <n> to increase or --no-budget to disable.`,
+                tokensPercent,
+                turnsPercent: Math.min(turnsPercent, 100),
+                warning: true,
+            };
+        }
+        return { ok: true, tokensPercent, turnsPercent, warning, exhausted: false };
+    }
+    // ── Get current snapshot ─────────────────────────────────
+    status() {
+        const estimatedCostUSD = this.totalInput * this.config.costPerInputToken +
+            this.totalOutput * this.config.costPerOutputToken;
+        return {
+            totalTokens: this.totalInput + this.totalOutput,
+            inputTokens: this.totalInput,
+            outputTokens: this.totalOutput,
+            turns: this.turnCount,
+            maxTokens: this.config.maxTokens,
+            maxTurns: this.config.maxTurns,
+            startedAt: this.startedAt,
+            elapsedMs: Date.now() - this.startedAt,
+            estimatedCostUSD,
+        };
+    }
+    // ── Is budget enforcement enabled? ───────────────────────
+    isEnabled() {
+        return this.enabled;
+    }
+    // ── Format a visual budget bar for the terminal ──────────
+    formatBar(width = 20) {
+        if (!this.enabled) {
+            return `${c.dim}budget: ${c.yellow}disabled${c.dim} (expert mode)${c.reset}`;
+        }
+        const snap = this.status();
+        const tokPct = Math.min((snap.totalTokens / snap.maxTokens) * 100, 100);
+        const turnPct = Math.min((snap.turns / snap.maxTurns) * 100, 100);
+        const tokBar = progressBar(tokPct, width);
+        const turnBar = progressBar(turnPct, Math.floor(width / 2));
+        const tokColor = tokPct >= 90 ? c.red : tokPct >= this.config.warnAtPercent ? c.yellow : c.green;
+        const turnColor = turnPct >= 90 ? c.red : turnPct >= this.config.warnAtPercent ? c.yellow : c.green;
+        const elapsed = formatElapsed(snap.elapsedMs);
+        return (`${c.dim}budget:${c.reset} ` +
+            `${tokColor}${tokBar}${c.reset} ` +
+            `${tokColor}${snap.totalTokens.toLocaleString()}${c.dim}/${snap.maxTokens.toLocaleString()} tokens${c.reset} · ` +
+            `${turnColor}${turnBar}${c.reset} ` +
+            `${turnColor}${snap.turns}${c.dim}/${snap.maxTurns} turns${c.reset} · ` +
+            `${c.dim}~$${snap.estimatedCostUSD.toFixed(4)} · ${elapsed}${c.reset}`);
+    }
+    // ── Format warning message if at threshold ───────────────
+    formatWarning() {
+        if (!this.enabled)
+            return null;
+        const { warning, ok, tokensPercent, turnsPercent } = this.check();
+        if (!ok) {
+            const snap = this.status();
+            return (`${c.yellow}${c.bold}⏸ BUDGET REACHED — Graceful Save${c.reset}\n` +
+                `${c.dim}  ${snap.totalTokens.toLocaleString()} tokens consumed across ${snap.turns} turns (~$${snap.estimatedCostUSD.toFixed(4)}).${c.reset}\n` +
+                `${c.green}  Progress saved to MEMORY.md. Resume with ${c.cyan}mythos chat${c.green} to continue.${c.reset}\n` +
+                `${c.dim}  Increase limits: ${c.cyan}mythos chat --max-tokens 1000000 --max-turns 50${c.reset}\n` +
+                `${c.dim}  Disable limits:  ${c.cyan}mythos chat --no-budget${c.reset}`);
+        }
+        if (warning) {
+            const higher = Math.max(tokensPercent, turnsPercent);
+            const snap = this.status();
+            return (`${c.yellow}⚠ Budget ${Math.round(higher)}% consumed${c.reset} — ` +
+                `${c.dim}${snap.totalTokens.toLocaleString()} tokens · ${snap.turns} turns${c.reset}`);
+        }
+        return null;
+    }
+    // ── Graceful session summary for MEMORY.md ────────────────
+    formatSessionSummary() {
+        const snap = this.status();
+        const elapsed = formatElapsed(snap.elapsedMs);
+        return (`budget-save: ${snap.totalTokens.toLocaleString()} tokens · ` +
+            `${snap.turns} turns · ~$${snap.estimatedCostUSD.toFixed(4)} · ${elapsed}`);
+    }
+}
+// ── Progress Bar Helper ──────────────────────────────────────
+function progressBar(percent, width) {
+    const filled = Math.round((percent / 100) * width);
+    const empty = width - filled;
+    return `[${`█`.repeat(filled)}${`░`.repeat(empty)}]`;
+}
+// ── Elapsed Time Formatter ───────────────────────────────────
+function formatElapsed(ms) {
+    const seconds = Math.floor(ms / 1000);
+    if (seconds < 60)
+        return `${seconds}s`;
+    const minutes = Math.floor(seconds / 60);
+    const secs = seconds % 60;
+    if (minutes < 60)
+        return `${minutes}m ${secs}s`;
+    const hours = Math.floor(minutes / 60);
+    const mins = minutes % 60;
+    return `${hours}h ${mins}m`;
+}
+//# sourceMappingURL=budget.js.map

package/dist/budget.js.map

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