@heysalad/cheri-cli 1.2.1 → 1.3.0

package/CHANGELOG.md

@@ -2,6 +2,59 @@
 
 All notable changes to Cheri CLI will be documented in this file.
 
+## [1.3.0] - 2026-02-17
+
+### 🎯 Major Feature - Token-Tracked Sessions with Predictable Costs
+
+#### Durable Objects Backend
+- **Automatic Workspace Creation**: Workspaces are automatically initialized on login
+- **Session Management**: Each chat is tracked as a separate session with token limits
+- **Token Tracking**: Real-time tracking of input and output tokens
+- **Cost Calculation**: Automatic cost estimation based on AWS Bedrock pricing
+  - Claude Sonnet 4: $3/M input, $15/M output
+  - Max ~$9 per 1M token session
+- **Auto-Compaction**: Sessions automatically compact at 90% of 1M token limit
+- **Force Compaction**: Sessions force compact at 100% to maintain limits
+
+#### New Cloud Tools
+- `get_workspace_stats` - View monthly token usage, limits, and costs
+- `list_sessions` - List all chat sessions with token tracking
+- `get_session_cost` - Get detailed cost breakdown for a specific session
+
+#### Backend Architecture
+- **WorkspaceDO**: One Durable Object per user managing all sessions
+- **SessionDO**: One Durable Object per chat tracking messages and tokens
+- **Persistent State**: Automatic state management with Cloudflare Durable Objects
+- **Scalable**: Handles unlimited users with per-user isolation
+
+#### API Enhancements
+- `POST /api/workspace/init` - Initialize user workspace
+- `POST /api/workspace/session/create` - Create new tracked session
+- `GET /api/workspace/sessions` - List recent sessions
+- `GET /api/workspace/session/:id` - Get specific session details
+- `GET /api/workspace/stats` - Get workspace statistics
+- `POST /api/session/:id/message` - Add message with token tracking
+- `GET /api/session/:id/cost` - Get session cost estimate
+- `POST /api/session/:id/compact` - Manual session compaction
+
+### ✨ Improved
+- **Login Flow**: Now automatically initializes workspace with token tracking
+- **Cost Visibility**: Users can see token usage and costs at any time
+- **Predictable Billing**: 1M token limit per chat ensures known maximum costs
+
+### 📚 Documentation
+- Added `ARCHITECTURE_PLAN.md` with complete system design
+- Added `DURABLE_OBJECTS_STARTER.ts` with implementation reference
+- Added `wrangler.toml` for Cloudflare Workers configuration
+
+### 🔧 Technical Details
+- Integrated Durable Objects into existing Cloudflare Workers backend
+- Added TypeScript interfaces for Workspace and Session types
+- Implemented token estimation based on character count (~4 chars/token)
+- Added pricing constants for multiple AI models (Claude, Nova)
+
+---
+
 ## [1.1.0] - 2026-02-17
 
 ### ✨ Added - Beautiful UI & Animations

package/README.md

@@ -2,7 +2,12 @@
 
 CLI for [Cheri](https://cheri.heysalad.app) — the AI-powered cloud IDE that never forgets.
 
-Manage workspaces, track API usage, and access your AI memory from the terminal.
+**Features:**
+- 🤖 AI-powered coding agent with tool execution
+- 📊 Token-tracked sessions with predictable costs
+- ☁️ Cloud workspace management
+- 💾 Persistent memory system
+- 🔧 Automatic workspace initialization
 
 ## Install
 
@@ -15,14 +20,14 @@ Requires Node.js 18+.
 ## Quick Start
 
 ```bash
-# Authenticate with your Cheri account
+# Authenticate with your Cheri account (auto-initializes workspace)
 cheri login
 
-# Launch a cloud workspace
-cheri workspace launch owner/my-repo
+# Start coding with AI agent
+cheri agent "create a todo list app"
 
-# Check account status
-cheri status
+# Check token usage and costs
+cheri stats
 
 # View API usage and rate limits
 cheri usage
@@ -30,19 +35,40 @@ cheri usage
 
 ## Commands
 
+### AI Agent
 | Command | Description |
 |---|---|
-| `cheri login` | Authenticate with GitHub |
+| `cheri agent <task>` | Start AI coding agent for a task |
+| `cheri agent -i` | Interactive agent mode |
+| `cheri agent -r <session-id>` | Resume a previous session |
+
+### Account & Authentication
+| Command | Description |
+|---|---|
+| `cheri login` | Authenticate with GitHub (auto-initializes workspace) |
 | `cheri status` | Show account and workspace status |
 | `cheri usage` | Show API usage and rate limit status |
+| `cheri stats` | Show token usage statistics and costs |
+
+### Workspaces
+| Command | Description |
+|---|---|
 | `cheri workspace launch <repo>` | Launch a new cloud workspace |
 | `cheri workspace list` | List all workspaces |
 | `cheri workspace stop <id>` | Stop a running workspace |
 | `cheri workspace status <id>` | Get workspace status |
+
+### Memory
+| Command | Description |
+|---|---|
 | `cheri memory show` | Show current memory entries |
 | `cheri memory add <text>` | Add a memory entry |
 | `cheri memory clear` | Clear all memory |
 | `cheri memory export` | Export memory to JSON |
+
+### Configuration
+| Command | Description |
+|---|---|
 | `cheri config list` | Show all configuration |
 | `cheri config get <key>` | Get a config value |
 | `cheri config set <key> <value>` | Set a config value |
@@ -60,6 +86,26 @@ $ cheri
 🍒 cheri > exit
 ```
 
+## Token Limits & Costs
+
+### Per Session (Chat)
+- **Max Tokens**: 1,000,000 tokens per chat
+- **Auto-Compact**: Triggers at 900K tokens (90%)
+- **Force Compact**: Triggers at 1M tokens (100%)
+
+### Monthly Limits
+| Plan | Sessions | Tokens/Month | Max Cost/Month |
+|---|---|---|---|
+| Free | 10 | 10M tokens | ~$90 |
+| Pro | 100 | 100M tokens | ~$900 |
+
+### Pricing (AWS Bedrock Claude Sonnet 4)
+- **Input**: $3.00 per 1M tokens
+- **Output**: $15.00 per 1M tokens
+- **Max per chat**: ~$9.00 (at 1M tokens, 50/50 split)
+
+Use `cheri stats` to check your current token usage and costs.
+
 ## Rate Limits
 
 | Plan | Limit |
@@ -77,12 +123,6 @@ Config is stored in `~/.cheri/`. Set the API URL if self-hosting:
 cheri config set apiUrl https://your-instance.example.com
 ```
 
-## Links
-
-- [Cheri Cloud IDE](https://cheri.heysalad.app)
-- [Dashboard](https://cheri.heysalad.app/dashboard)
-- [GitHub](https://github.com/chilu18/cloud-ide)
-
 ## 🔗 Links
 
 - **Homepage**: [cheri.heysalad.app](https://cheri.heysalad.app)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@heysalad/cheri-cli",
-  "version": "1.2.1",
-  "description": "Cheri CLI - AI-powered cloud IDE by HeySalad®. Like Claude Code, but for cloud workspaces. Now with beautiful animations and enhanced UI!",
+  "version": "1.3.0",
+  "description": "Cheri CLI - AI-powered cloud IDE by HeySalad®. With token-tracked sessions, predictable AI costs, and automatic workspace management.",
   "type": "module",
   "bin": {
     "cheri": "./bin/cheri.js"

package/src/commands/agent.js

@@ -50,6 +50,9 @@ const CLOUD_TOOLS = [
   { name: "get_usage", description: "Get the user's API usage and rate limit statistics", parameters: { type: "object", properties: {}, required: [] } },
   { name: "get_config", description: "Get a configuration value by key (dot notation supported)", parameters: { type: "object", properties: { key: { type: "string", description: "Config key, e.g. 'ai.provider'" } }, required: ["key"] } },
   { name: "set_config", description: "Set a configuration value", parameters: { type: "object", properties: { key: { type: "string", description: "Config key" }, value: { type: "string", description: "Value to set" } }, required: ["key", "value"] } },
+  { name: "get_workspace_stats", description: "Get token usage statistics for your workspace (monthly usage, limits, costs)", parameters: { type: "object", properties: {}, required: [] } },
+  { name: "list_sessions", description: "List recent chat sessions with token tracking", parameters: { type: "object", properties: {}, required: [] } },
+  { name: "get_session_cost", description: "Get detailed token usage and cost estimate for a specific session", parameters: { type: "object", properties: { sessionId: { type: "string", description: "Session ID to query" } }, required: ["sessionId"] } },
 ];
 
 // ── Agent meta-tools ────────────────────────────────────────────────────────
@@ -99,6 +102,9 @@ async function executeCloudTool(name, args) {
         setConfigValue(args.key, args.value);
         return { key: args.key, value: args.value, status: "updated" };
       }
+      case "get_workspace_stats": return await apiClient.getWorkspaceStats();
+      case "list_sessions": return await apiClient.listSessions();
+      case "get_session_cost": return await apiClient.getSessionCost(args.sessionId);
       default: return { error: `Unknown cloud tool: ${name}` };
     }
   } catch (err) {

package/src/commands/login.js

@@ -63,6 +63,16 @@ export async function loginFlow() {
     log.blank();
     log.success(`Logged in as ${chalk.cyan(me.ghLogin || me.userId)}`);
     log.keyValue("Plan", me.plan === "pro" ? chalk.green("Pro") : "Free");
+
+    // Initialize workspace for token tracking
+    try {
+      await apiClient.initWorkspace();
+      log.dim("✓ Workspace initialized with token tracking");
+    } catch (workspaceErr) {
+      // Workspace init is non-critical, just log it
+      log.dim(`⚠ Workspace init skipped: ${workspaceErr.message}`);
+    }
+
     log.blank();
     log.tip("Using Cheri cloud service (AWS Bedrock). Run 'cheri agent' to start coding!");
   } catch (err) {

package/src/lib/api-client.js

@@ -128,4 +128,42 @@ export const apiClient = {
   async getModels() {
     return request("/api/chat/models");
   },
+
+  // Token-Tracked Workspaces & Sessions
+  async initWorkspace() {
+    return request("/api/workspace/init", { method: "POST" });
+  },
+
+  async createSession() {
+    return request("/api/workspace/session/create", { method: "POST" });
+  },
+
+  async listSessions() {
+    return request("/api/workspace/sessions");
+  },
+
+  async getSession(sessionId) {
+    return request(`/api/workspace/session/${encodeURIComponent(sessionId)}`);
+  },
+
+  async getWorkspaceStats() {
+    return request("/api/workspace/stats");
+  },
+
+  async addSessionMessage(sessionId, role, content, tokens = null) {
+    return request(`/api/session/${encodeURIComponent(sessionId)}/message`, {
+      method: "POST",
+      body: JSON.stringify({ role, content, tokens }),
+    });
+  },
+
+  async getSessionCost(sessionId) {
+    return request(`/api/session/${encodeURIComponent(sessionId)}/cost`);
+  },
+
+  async compactSession(sessionId) {
+    return request(`/api/session/${encodeURIComponent(sessionId)}/compact`, {
+      method: "POST",
+    });
+  },
 };