oh-my-claude-sisyphus 3.5.6 → 3.5.7

package/README.md

@@ -11,407 +11,122 @@
 
 **Multi-agent orchestration for Claude Code. Zero learning curve.**
 
-*Some advanced users customize zsh for years — most of us just use oh-my-zsh.*
 *Don't learn Claude Code. Just use OMC.*
 
-[Get Started](#get-started) • [Documentation](https://yeachan-heo.github.io/oh-my-claudecode-website) • [Migration Guide](docs/MIGRATION.md)
+[Get Started](#quick-start) • [Documentation](https://yeachan-heo.github.io/oh-my-claudecode-website) • [Migration Guide](docs/MIGRATION.md)
 
 </div>
 
 ---
 
-## Get Started (30 seconds)
+## Quick Start
 
-**Step 1:** Install the plugin
-```
+**Step 1: Install**
+```bash
 /plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode
 /plugin install oh-my-claudecode
 ```
 
-**Step 2:** Run setup
-```
+**Step 2: Setup**
+```bash
 /oh-my-claudecode:omc-setup
 ```
 
-That's it. Everything else is automatic.
-
----
-
-## What Happens Now
-
-| When You... | I Automatically... |
-|-------------|-------------------|
-| Give me a complex task | Parallelize with specialist agents |
-| Say "plan this" | Start a planning interview |
-| Say "don't stop until done" | Persist until verified complete |
-| Work on UI/frontend | Activate design sensibility |
-| Need research or exploration | Delegate to specialized agents |
-| Say "build me..." or use autopilot | Execute full autonomous workflow |
-
-**You don't need to memorize commands.** I detect intent from natural language and activate the right behaviors automatically.
-
----
-
-## Magic Keywords (Optional Shortcuts)
-
-These are **optional shortcuts** for power users who want explicit control. Natural language works just fine - these keywords simply provide precision when you want it.
-
-Include these words anywhere in your message:
-
-| Keyword | Effect |
-|---------|--------|
-| `ralph` | Persistence mode - won't stop until done |
-| `ralplan` | Iterative planning with consensus |
-| `ulw` / `ultrawork` | Maximum parallel execution |
-| `ultrapilot` | Parallel autopilot (3-5x faster) |
-| `swarm` | N coordinated agents |
-| `pipeline` | Sequential agent chaining |
-| `eco` / `ecomode` | Token-efficient parallel execution |
-| `plan` | Start a planning interview |
-| `autopilot` / `ap` | Full autonomous execution |
-
-**Combine them:** `ralph ulw: migrate the database` or `eco: refactor auth system`
-
----
-
-## Execution Modes (v3.4.0)
-
-### Ultrapilot: Parallel Autopilot
-
-3-5x faster execution with up to 5 parallel workers. Perfect for multi-component systems and large refactoring:
-
-```
-/oh-my-claudecode:ultrapilot "build a fullstack todo app"
-```
-
-**How it works:**
-- Automatic task decomposition into parallelizable subtasks
-- Non-overlapping file ownership prevents conflicts
-- Parallel execution with intelligent coordination
-- Automatic conflict detection and resolution
-
----
-
-### Swarm: Coordinated Agents
-
-N independent agents claiming tasks from a shared pool:
-
-```
-/oh-my-claudecode:swarm 5:executor "fix all TypeScript errors"
-```
-
-**Features:**
-- Atomic task claiming prevents duplicate work
-- 5-minute timeout per task with auto-release
-- Scales from 2 to 10 workers
-
----
-
-### Pipeline: Sequential Chaining
-
-Chain agents together with data passing between stages:
-
-```
-/oh-my-claudecode:pipeline explore:haiku -> architect:opus -> executor:sonnet
-```
-
-**Built-in Presets:**
-- `review` - explore → architect → critic → executor
-- `implement` - planner → executor → tdd-guide
-- `debug` - explore → architect → build-fixer
-- `security` - explore → security-reviewer → executor
-
----
-
-### Ecomode: Token-Efficient
-
-Maximum parallelism with Haiku where possible, falling back to Sonnet/Opus for complex reasoning:
-
-```
-/oh-my-claudecode:ecomode "refactor the authentication system"
-```
-
-**30-50% token savings** compared to standard ultrawork while maintaining quality.
-
----
-
-## Auto Skill Learning (v3.5.0)
-
-OMC can automatically detect patterns in your problem-solving and suggest extracting them as reusable skills.
-
-### How It Works
-
-1. **Pattern Detection** - Recognizes problem-solution pairs in conversations
-2. **Skill Extraction** - `/oh-my-claudecode:learner` extracts reusable knowledge
-3. **Auto-Matching** - Fuzzy matching detects when skills apply to new problems
-4. **Auto-Invocation** - High-confidence matches (80+) auto-apply without prompting
-
-### Managing Local Skills
-
-```
-/oh-my-claudecode:skill list           # List all learned skills
-/oh-my-claudecode:skill search "auth"  # Find skills by keyword
-/oh-my-claudecode:skill edit <name>    # Edit a skill
-/oh-my-claudecode:skill sync           # Sync user + project skills
-```
-
-### Skill Storage
-
-- **User-level**: `~/.claude/skills/sisyphus-learned/` (shared across projects)
-- **Project-level**: `.omc/skills/` (project-specific)
-
-Skills use YAML frontmatter with triggers, tags, and quality scores.
-
----
-
-## Analytics & Cost Tracking (v3.5.0)
-
-Track your Claude Code usage across all sessions with automatic transcript analysis.
-
-### Backfill Historical Data
-
-```
-omc backfill                    # Analyze all transcripts
-omc backfill --from 2026-01-01  # From specific date
-omc backfill --project "*/myproject/*"  # Filter by project
-```
-
-### View Statistics
-
-```
-omc stats                       # All sessions aggregate
-omc stats --session             # Current session only
-omc stats --json                # JSON output
-```
-
-**Sample Output:**
-```
-📊 All Sessions Stats
-Sessions: 18
-Entries: 3356
-
-💰 Token Usage & Cost
-Total Tokens: 4.36M
-Total Cost: $2620.49
-
-🤖 Top Agents by Cost (All Sessions)
-  (main session)              700.7k tokens  $1546.46
-  oh-my-claudecode:architect    1.18M tokens  $432.68
-  oh-my-claudecode:planner    540.9k tokens  $274.85
-  oh-my-claudecode:executor   306.9k tokens  $77.43
-```
-
-**Features:**
-- Automatic backfill on first `omc stats` run
-- Global storage in `~/.omc/state/` (cross-project)
-- Proper agent attribution (main session vs spawned agents)
-- Deduplication prevents double-counting
-
----
-
-## Data Analysis & Research (v3.4.0)
-
-### Scientist Agent Tiers
-
-Three tiers of scientist agents for quantitative analysis and data science:
-
-| Agent | Model | Use For |
-|-------|-------|---------|
-| `scientist-low` | Haiku | Quick data inspection, simple statistics, file enumeration |
-| `scientist` | Sonnet | Standard analysis, pattern detection, visualization |
-| `scientist-high` | Opus | Complex reasoning, hypothesis validation, ML workflows |
-
-**Features:**
-- **Persistent Python REPL** - Variables persist across calls (no pickle/reload overhead)
-- **Structured markers** - `[FINDING]`, `[STAT:*]`, `[DATA]`, `[LIMITATION]` for parsed output
-- **Quality gates** - Every finding requires statistical evidence (CI, effect size, p-value)
-- **Auto-visualization** - Charts saved to `.omc/scientist/figures/`
-- **Report generation** - Markdown reports with embedded figures
-
-```python
-# Variables persist across calls!
-python_repl(action="execute", researchSessionID="analysis",
-            code="import pandas as pd; df = pd.read_csv('data.csv')")
-
-# df still exists - no need to reload
-python_repl(action="execute", researchSessionID="analysis",
-            code="print(df.describe())")
-```
-
-### /oh-my-claudecode:research Command (NEW)
-
-Orchestrate parallel scientist agents for comprehensive research workflows:
-
-```
-/oh-my-claudecode:research <goal>                    # Standard research with checkpoints
-/oh-my-claudecode:research AUTO: <goal>              # Fully autonomous until complete
-/oh-my-claudecode:research status                    # Check current session
-/oh-my-claudecode:research resume                    # Resume interrupted session
-/oh-my-claudecode:research list                      # List all sessions
-/oh-my-claudecode:research report <session-id>       # Generate report for session
-```
-
-**Research Protocol:**
-1. **Decomposition** - Breaks goal into 3-7 independent stages
-2. **Parallel Execution** - Fires scientist agents concurrently (max 5)
-3. **Cross-Validation** - Verifies consistency across findings
-4. **Synthesis** - Generates comprehensive markdown report
-
-**Smart Model Routing:**
-- Data gathering tasks → `scientist-low` (Haiku)
-- Standard analysis → `scientist` (Sonnet)
-- Complex reasoning → `scientist-high` (Opus)
-
-**Session Management:** Research state persists at `.omc/research/{session-id}/` enabling resume after interruption.
-
----
-
-## Stopping Things
-
-Just say:
-- "stop"
-- "cancel"
-- "abort"
-
-I'll intelligently determine what to stop based on context.
-
----
-
-## MCP Server Configuration
-
-Extend Claude Code with additional tools via Model Context Protocol (MCP) servers.
-
-```
-/oh-my-claudecode:mcp-setup
-```
-
-### Supported MCP Servers
-
-| Server | Description | API Key Required |
-|--------|-------------|------------------|
-| **Context7** | Documentation and code context from popular libraries | No |
-| **Exa** | Enhanced web search (replaces built-in websearch) | Yes |
-| **Filesystem** | Extended file system access | No |
-| **GitHub** | GitHub API for issues, PRs, repos | Yes (PAT) |
-
-### Quick Setup
-
-Run the setup command and follow the prompts:
-```
-/oh-my-claudecode:mcp-setup
+**Step 3: Build something**
 ```
-
-Or configure manually in `~/.claude/settings.json`:
-```json
-{
-  "mcpServers": {
-    "context7": {
-      "command": "npx",
-      "args": ["-y", "@upstash/context7-mcp"]
-    },
-    "exa": {
-      "command": "npx",
-      "args": ["-y", "exa-mcp-server"],
-      "env": {
-        "EXA_API_KEY": "your-key-here"
-      }
-    }
-  }
-}
+autopilot: build a REST API for managing tasks
 ```
 
-After configuration, restart Claude Code for changes to take effect.
+That's it. Everything else is automatic.
 
 ---
 
-## What's Under the Hood
+## Why oh-my-claudecode?
 
-- **32 Specialized Agents** - architect, researcher, explore, designer, writer, vision, critic, analyst, executor, planner, qa-tester, scientist (with tier variants including explore-high)
-- **40 Skills** - orchestrate, autopilot, ultrawork, ultrapilot, swarm, pipeline, ecomode, ralph, planner, ralplan, deepsearch, analyze, research, tdd, build-fix, code-review, security-review, git-master, frontend-ui-ux, learner, mcp-setup, cancel (unified), and more
-- **5 Execution Modes** - Autopilot (autonomous), Ultrapilot (3-5x parallel), Swarm (coordinated), Pipeline (sequential), Ecomode (token-efficient)
-- **MCP Server Support** - Easy configuration of Context7, Exa, GitHub, and custom MCP servers
-- **Persistent Python REPL** - True variable persistence for data analysis
-- **Research Workflow** - Parallel scientist orchestration with `/oh-my-claudecode:research` command
-- **HUD Statusline** - Real-time visualization of orchestration state
-- **Learned Skills** - Extract reusable insights from sessions with `/oh-my-claudecode:learner`
-- **Memory System** - Persistent context that survives compaction
+- **Zero configuration required** - Works out of the box with intelligent defaults
+- **Natural language interface** - No commands to memorize, just describe what you want
+- **Automatic parallelization** - Complex tasks distributed across specialized agents
+- **Persistent execution** - Won't give up until the job is verified complete
+- **Cost optimization** - Smart model routing saves 30-50% on tokens
+- **Learn from experience** - Automatically extracts and reuses problem-solving patterns
+- **Real-time visibility** - HUD statusline shows what's happening under the hood
 
 ---
 
-## HUD Statusline
+## Features
 
-The HUD displays real-time orchestration status in Claude Code's status bar:
+### Execution Modes
+Multiple strategies for different use cases - from fully autonomous builds to token-efficient refactoring. [Learn more →](https://yeachan-heo.github.io/oh-my-claudecode-website/execution-modes)
 
-```
-[OMC] | 5h:0% wk:100%(1d6h) | ctx:45% | agents:Ae
-todos:3/5 (working: Implementing feature)
-```
+| Mode | Speed | Use For |
+|------|-------|---------|
+| **Autopilot** | Fast | Full autonomous workflows |
+| **Ultrapilot** | 3-5x faster | Multi-component systems |
+| **Ecomode** | Fast + 30-50% cheaper | Budget-conscious projects |
+| **Swarm** | Coordinated | Parallel independent tasks |
+| **Pipeline** | Sequential | Multi-stage processing |
 
-**Line 1:** Core metrics
-- Rate limits with reset times (e.g., `wk:100%(1d6h)` = resets in 1 day 6 hours)
-- Context window usage
-- Active agents (coded by type and model tier)
+### Intelligent Orchestration
+- **32 specialized agents** for architecture, research, design, testing, data science
+- **Smart model routing** - Haiku for simple tasks, Opus for complex reasoning
+- **Automatic delegation** - Right agent for the job, every time
 
-**Line 2:** Todo progress
-- Completion ratio (`3/5`)
-- Current task in progress
+### Developer Experience
+- **Magic keywords** - `ralph`, `ulw`, `eco`, `plan` for explicit control
+- **HUD statusline** - Real-time orchestration metrics in your status bar
+- **Skill learning** - Extract reusable patterns from your sessions
+- **Analytics & cost tracking** - Understand token usage across all sessions
 
-Run `/oh-my-claudecode:hud setup` to configure display options.
+[Full feature list →](docs/REFERENCE.md)
 
 ---
 
-## Coming from 2.x?
+## Magic Keywords
 
-**Good news:** Your old commands still work!
+Optional shortcuts for power users. Natural language works fine without them.
 
-```
-/oh-my-claudecode:ralph "task"      →  Still works (or just say "ralph: task")
-/oh-my-claudecode:ultrawork "task"  →  Still works (or just use "ulw" keyword)
-/oh-my-claudecode:planner "task"    →  Still works (or just say "plan this")
-```
+| Keyword | Effect | Example |
+|---------|--------|---------|
+| `autopilot` | Full autonomous execution | `autopilot: build a todo app` |
+| `ralph` | Persistence mode | `ralph: refactor auth` |
+| `ulw` | Maximum parallelism | `ulw fix all errors` |
+| `eco` | Token-efficient execution | `eco: migrate database` |
+| `plan` | Planning interview | `plan the API` |
 
-The difference? You don't *need* them anymore. Everything auto-activates.
-
-See the [Migration Guide](docs/MIGRATION.md) for details.
+**Combine them:** `ralph ulw: migrate database` = persistence + parallelism
 
 ---
 
 ## Documentation
 
-- [Full Reference](docs/FULL-README.md) - Complete documentation (800+ lines)
-- [Migration Guide](docs/MIGRATION.md) - 2.x to 3.0 transition
-- [Architecture](docs/ARCHITECTURE.md) - Technical deep-dive
-- [Website](https://yeachan-heo.github.io/oh-my-claudecode-website) - Online docs
+- **[Full Reference](docs/REFERENCE.md)** - Complete feature documentation
+- **[Website](https://yeachan-heo.github.io/oh-my-claudecode-website)** - Interactive guides and examples
+- **[Migration Guide](docs/MIGRATION.md)** - Upgrade from v2.x
+- **[Architecture](docs/ARCHITECTURE.md)** - How it works under the hood
 
 ---
 
 ## Requirements
 
 - [Claude Code](https://docs.anthropic.com/claude-code) CLI
-- One of:
-  - **Claude Max/Pro subscription** (recommended for individuals)
-  - **Anthropic API key** (for API-based usage)
-
----
-
-## Star History
-
-[![Star History Chart](https://api.star-history.com/svg?repos=Yeachan-Heo/oh-my-claudecode&type=Date)](https://star-history.com/#Yeachan-Heo/oh-my-claudecode&Date)
+- Claude Max/Pro subscription OR Anthropic API key
 
 ---
 
 ## License
 
-MIT - see [LICENSE](LICENSE)
+MIT
 
 ---
 
 <div align="center">
 
-**Inspired by:**
-
-[oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode) • [claude-hud](https://github.com/ryanjoachim/claude-hud) • [Superpowers](https://github.com/NexTechFusion/Superpowers) • [everything-claude-code](https://github.com/affaan-m/everything-claude-code)
+**Inspired by:** [oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode) • [claude-hud](https://github.com/ryanjoachim/claude-hud) • [Superpowers](https://github.com/NexTechFusion/Superpowers) • [everything-claude-code](https://github.com/affaan-m/everything-claude-code)
 
 **Zero learning curve. Maximum power.**
 
 </div>
+
+## Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=Yeachan-Heo/oh-my-claudecode&type=date&legend=top-left)](https://www.star-history.com/#Yeachan-Heo/oh-my-claudecode&type=date&legend=top-left)

package/commands/omc-setup.md

@@ -82,6 +82,45 @@ fi
 
 **Note:** The `npm install` command triggers the `prepare` script which runs `npm run build`, creating the dist/ directory with all compiled HUD files.
 
+## Step 3.6: Install CLI Analytics Tools (Optional)
+
+The OMC CLI provides standalone token analytics commands (`omc stats`, `omc agents`, `omc backfill`, `omc tui`).
+
+Ask user: "Would you like to install the OMC CLI for standalone analytics? (Recommended for tracking token usage and costs)"
+
+**Options:**
+1. **Yes (Recommended)** - Install CLI tools globally for `omc stats`, `omc agents`, etc.
+2. **No** - Skip CLI installation, use only plugin skills
+
+### If User Chooses YES:
+
+```bash
+# Check for bun (preferred) or npm
+if command -v bun &> /dev/null; then
+  echo "Installing OMC CLI via bun..."
+  bun install -g oh-my-claudecode
+elif command -v npm &> /dev/null; then
+  echo "Installing OMC CLI via npm..."
+  npm install -g oh-my-claudecode
+else
+  echo "ERROR: Neither bun nor npm found. Please install Node.js or Bun first."
+  exit 1
+fi
+
+# Verify installation
+if command -v omc &> /dev/null; then
+  echo "✓ OMC CLI installed successfully!"
+  echo "  Try: omc stats, omc agents, omc backfill"
+else
+  echo "⚠ CLI installed but 'omc' not in PATH."
+  echo "  You may need to restart your terminal or add npm/bun global bin to PATH."
+fi
+```
+
+### If User Chooses NO:
+
+Skip this step. User can install later with `npm install -g oh-my-claudecode`.
+
 ## Step 4: Verify Plugin Installation
 
 ```bash
@@ -144,6 +183,12 @@ Run /oh-my-claudecode:mcp-setup to add tools like web search, GitHub, etc.
 HUD STATUSLINE:
 The status bar now shows OMC state. Restart Claude Code to see it.
 
+CLI ANALYTICS (if installed):
+- omc           - Full dashboard (stats + agents + cost)
+- omc stats     - View token usage and costs
+- omc agents    - See agent breakdown by cost
+- omc tui       - Launch interactive TUI dashboard
+
 That's it! Just use Claude Code normally.
 ```
 
@@ -173,6 +218,12 @@ MAGIC KEYWORDS (power-user shortcuts):
 HUD STATUSLINE:
 The status bar now shows OMC state. Restart Claude Code to see it.
 
+CLI ANALYTICS (if installed):
+- omc           - Full dashboard (stats + agents + cost)
+- omc stats     - View token usage and costs
+- omc agents    - See agent breakdown by cost
+- omc tui       - Launch interactive TUI dashboard
+
 Your workflow won't break - it just got easier!
 ```
 

package/dist/__tests__/analytics/tokscale-adapter.test.d.ts

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

package/dist/__tests__/analytics/tokscale-adapter.test.d.ts.map

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

package/dist/__tests__/analytics/tokscale-adapter.test.js

@@ -0,0 +1,79 @@
+import { describe, it, expect, beforeEach } from 'vitest';
+import { getTokscaleAdapter, lookupPricingWithFallback, isTokscaleAvailable, resetAdapterCache } from '../../analytics/tokscale-adapter.js';
+describe('tokscale-adapter', () => {
+    beforeEach(() => {
+        // Reset the cached adapter before each test
+        resetAdapterCache();
+    });
+    describe('getTokscaleAdapter', () => {
+        it('returns adapter with isAvailable property', async () => {
+            const adapter = await getTokscaleAdapter();
+            expect(adapter).toHaveProperty('isAvailable');
+            expect(typeof adapter.isAvailable).toBe('boolean');
+        });
+        it('caches adapter instance', async () => {
+            const adapter1 = await getTokscaleAdapter();
+            const adapter2 = await getTokscaleAdapter();
+            expect(adapter1).toBe(adapter2);
+        });
+        it('returns adapter with expected properties when available', async () => {
+            const adapter = await getTokscaleAdapter();
+            // Even when unavailable, should have isAvailable property
+            expect(adapter).toHaveProperty('isAvailable');
+        });
+    });
+    describe('lookupPricingWithFallback', () => {
+        it('returns pricing for known models', async () => {
+            const pricing = await lookupPricingWithFallback('claude-sonnet-4.5');
+            expect(pricing).toHaveProperty('inputPerMillion');
+            expect(pricing).toHaveProperty('outputPerMillion');
+            expect(pricing.inputPerMillion).toBeGreaterThan(0);
+            expect(pricing.outputPerMillion).toBeGreaterThan(0);
+        });
+        it('returns pricing for haiku model', async () => {
+            const pricing = await lookupPricingWithFallback('claude-haiku-4');
+            // Tokscale returns live pricing from LiteLLM database
+            expect(pricing.inputPerMillion).toBeGreaterThan(0);
+            expect(pricing.outputPerMillion).toBeGreaterThan(0);
+            expect(pricing.outputPerMillion).toBeGreaterThan(pricing.inputPerMillion);
+        });
+        it('returns pricing for opus model', async () => {
+            const pricing = await lookupPricingWithFallback('claude-opus-4.5');
+            // Tokscale returns live pricing from LiteLLM database
+            expect(pricing.inputPerMillion).toBeGreaterThan(0);
+            expect(pricing.outputPerMillion).toBeGreaterThan(0);
+            expect(pricing.outputPerMillion).toBeGreaterThan(pricing.inputPerMillion);
+        });
+        it('returns default pricing for unknown models', async () => {
+            const pricing = await lookupPricingWithFallback('unknown-model-xyz');
+            expect(pricing).toBeDefined();
+            expect(pricing).toHaveProperty('inputPerMillion');
+            expect(pricing).toHaveProperty('outputPerMillion');
+        });
+        it('includes cache pricing fields', async () => {
+            const pricing = await lookupPricingWithFallback('claude-sonnet-4.5');
+            expect(pricing).toHaveProperty('cacheWriteMarkup');
+            expect(pricing).toHaveProperty('cacheReadDiscount');
+        });
+    });
+    describe('isTokscaleAvailable', () => {
+        it('returns a boolean', async () => {
+            const available = await isTokscaleAvailable();
+            expect(typeof available).toBe('boolean');
+        });
+    });
+    describe('resetAdapterCache', () => {
+        it('clears the cached adapter', async () => {
+            // Get adapter to populate cache
+            const adapter1 = await getTokscaleAdapter();
+            // Reset cache
+            resetAdapterCache();
+            // Get adapter again - should create new instance
+            const adapter2 = await getTokscaleAdapter();
+            // Both should have same structure but might be different instances
+            // depending on whether tokscale is available
+            expect(adapter2).toHaveProperty('isAvailable');
+        });
+    });
+});
+//# sourceMappingURL=tokscale-adapter.test.js.map

package/dist/__tests__/analytics/tokscale-adapter.test.js.map

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

package/dist/analytics/cost-estimator.d.ts

@@ -6,7 +6,21 @@ export interface CostInput {
     cacheCreationTokens: number;
     cacheReadTokens: number;
 }
+/**
+ * Synchronous cost calculation using hardcoded pricing.
+ * Fast path for HUD and sync operations that need instant response.
+ */
 export declare function calculateCost(input: CostInput): CostBreakdown;
+/**
+ * Asynchronous cost calculation using live TokScale pricing.
+ * Provides up-to-date pricing with fallback to hardcoded values.
+ */
+export declare function calculateCostAsync(input: CostInput): Promise<CostBreakdown>;
+/**
+ * Batch cost calculation with efficient pricing lookup.
+ * Fetches pricing once per unique model for better performance.
+ */
+export declare function batchCalculateCost(inputs: CostInput[]): Promise<CostBreakdown[]>;
 export declare function formatCost(cost: number): string;
 export declare function getCostColor(cost: number): 'green' | 'yellow' | 'red';
 export declare function estimateDailyCost(tokensPerHour: number, modelName: string): number;

package/dist/analytics/cost-estimator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cost-estimator.d.ts","sourceRoot":"","sources":["../../src/analytics/cost-estimator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,aAAa,EAAE,MAAM,YAAY,CAAC;AAElE,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,aAAa,CA0B7D;AA8BD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK/C;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAIrE;AAED,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAKlF;AAED,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEpF"}
+{"version":3,"file":"cost-estimator.d.ts","sourceRoot":"","sources":["../../src/analytics/cost-estimator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,aAAa,EAAE,MAAM,YAAY,CAAC;AAGlE,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,aAAa,CA0B7D;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,CA0BjF;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAsCtF;AA8BD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK/C;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAIrE;AAED,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAKlF;AAED,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEpF"}