codeep 2.13.0 → 2.13.2

package/dist/renderer/components/Help.js

@@ -1,184 +1,22 @@
 /**
- * Help screen component
+ * Help screen component.
+ *
+ * The `/help` layout lives in `../commands/registry.ts` as `HELP_LAYOUT`
+ * (single source of truth, alongside the command metadata). This file
+ * re-exports it under the historical `helpCategories` name so existing
+ * callers (`App.ts`, `handlers.ts`) keep working, and owns the keyboard-
+ * shortcuts panel (which is independent of commands). The actual rendering
+ * is done by `App.ts`, which iterates `helpCategories` directly.
  */
-import { fg } from '../ansi.js';
-// Primary color: #f02a30 (Codeep red)
-const PRIMARY_COLOR = fg.rgb(240, 42, 48);
+import { HELP_LAYOUT } from '../commands/registry.js';
 /**
- * Codeep command help data
+ * Codeep command help data — re-exported from the registry so there's a
+ * single source of truth for both `/help` rendering and `/` autocomplete.
  */
-export const helpCategories = [
-    {
-        title: 'General',
-        items: [
-            { key: '/help', description: 'Show this help' },
-            { key: '/status', description: 'Current status' },
-            { key: '/settings', description: 'Open settings' },
-            { key: '/version', description: 'Show version' },
-            { key: '/update', description: 'Check for updates' },
-            { key: '/stats (/cost)', description: 'Token usage & cost this session' },
-            { key: '/clear', description: 'Clear chat' },
-            { key: '/exit', description: 'Quit application' },
-        ],
-    },
-    {
-        title: 'Sessions',
-        items: [
-            { key: '/sessions', description: 'List and load sessions' },
-            { key: '/new', description: 'Start new session' },
-            { key: '/rename <name>', description: 'Rename current session' },
-            { key: '/search <term>', description: 'Search the current session' },
-            { key: '/recall <query>', description: 'Search across ALL saved sessions (cross-session)' },
-            { key: '/recall … --resume', description: 'Load the top-matching session directly' },
-            { key: '/recall … --summarize', description: 'LLM recap of what you did across matches' },
-            { key: '/export [md|json|txt]', description: 'Export chat' },
-            { key: '/compact [keepN]', description: 'AI-summarize older messages to free up context (keeps last N)' },
-        ],
-    },
-    {
-        title: 'Checkpoints (2.0)',
-        items: [
-            { key: '/checkpoint [name]', description: 'Snapshot conversation + provider/model + git HEAD' },
-            { key: '/checkpoints', description: 'List saved checkpoints in this workspace' },
-            { key: '/rewind <id>', description: 'Restore conversation from a checkpoint' },
-            { key: '/checkpoint delete <id>', description: 'Delete a saved checkpoint' },
-        ],
-    },
-    {
-        title: 'Agent Mode',
-        items: [
-            { key: '/agent <task>', description: 'Run agent with task' },
-            { key: '/agent-dry <task>', description: 'Dry run (no changes)' },
-            { key: '/plan <task>', description: 'Generate a plan first — review before /go executes' },
-            { key: '/go', description: 'Execute the pending plan from /plan' },
-            { key: '/stop', description: 'Stop running agent' },
-            { key: '/undo', description: 'Undo last agent action' },
-            { key: '/undo-all', description: 'Undo all agent actions' },
-            { key: '/history', description: 'Show agent history' },
-            { key: '/changes', description: 'Show session changes' },
-        ],
-    },
-    {
-        title: 'Git & Project',
-        items: [
-            { key: '/diff', description: 'Review git diff with AI' },
-            { key: '/diff --staged', description: 'Review staged changes' },
-            { key: '/commit (/c)', description: 'Generate commit message' },
-            { key: '/git-commit <msg>', description: 'Commit with message' },
-            { key: '/push (/p)', description: 'Git push' },
-            { key: '/pull', description: 'Git pull' },
-            { key: '/amend', description: 'Amend last commit' },
-            { key: '/branch', description: 'Create/manage branches' },
-            { key: '/stash', description: 'Stash changes' },
-            { key: '/init', description: 'Initialize project (.codeep/ folder)' },
-            { key: '/scan', description: 'Scan project structure' },
-            { key: '/memory <note>', description: 'Add note to project intelligence' },
-            { key: '/memory list', description: 'Show all memory notes' },
-            { key: '/memory remove <n>', description: 'Remove note by index' },
-            { key: '/memory clear', description: 'Clear all memory notes' },
-            { key: '/review', description: 'AI review of unstaged git changes (not full codebase)' },
-            { key: '/review --staged', description: 'AI review of staged git changes' },
-            { key: '/review --static', description: 'Static analysis — changed files, or whole src/ if clean' },
-            { key: '/review <file>', description: 'Static analysis of specific file(s)' },
-        ],
-    },
-    {
-        title: 'Code Operations',
-        items: [
-            { key: '/copy [n]', description: 'Copy code block to clipboard' },
-            { key: '/paste', description: 'Paste from clipboard' },
-            { key: '/apply', description: 'Apply file changes from AI' },
-            { key: '/add <path>', description: 'Add file to context' },
-            { key: '/drop [path]', description: 'Remove file (or all) from context' },
-            { key: '/multiline', description: 'Toggle multi-line input mode' },
-        ],
-    },
-    {
-        title: 'Skills (Shortcuts)',
-        items: [
-            { key: '/test (/t)', description: 'Generate/run tests' },
-            { key: '/docs (/d)', description: 'Add documentation' },
-            { key: '/refactor (/r)', description: 'Improve code quality' },
-            { key: '/fix (/f)', description: 'Debug and fix issues' },
-            { key: '/explain (/e)', description: 'Explain code' },
-            { key: '/optimize (/o)', description: 'Optimize performance' },
-            { key: '/debug (/b)', description: 'Debug problems' },
-            { key: '/security', description: 'Security audit (SQLi, XSS, secrets, auth)' },
-            { key: '/coverage', description: 'Run/analyze test coverage' },
-            { key: '/component <name>', description: 'Generate UI component' },
-            { key: '/api <name>', description: 'Generate API endpoint' },
-            { key: '/docker', description: 'Generate Dockerfile + compose' },
-            { key: '/skills', description: 'List all 50+ skills' },
-            { key: '/skills <query>', description: 'Search skills by keyword' },
-        ],
-    },
-    {
-        title: 'Settings',
-        items: [
-            { key: '/provider', description: 'Change AI provider' },
-            { key: '/model', description: 'Change model' },
-            { key: '/model <name>', description: 'Load saved profile (e.g. /model fast)' },
-            { key: '/protocol', description: 'Switch API protocol' },
-            { key: '/lang', description: 'Set response language' },
-            { key: '/grant', description: 'Grant write permission' },
-            { key: '/login', description: 'Login with API key' },
-            { key: '/logout', description: 'Logout from provider' },
-            { key: '/profile save <name>', description: 'Save current provider+model as profile' },
-            { key: '/profile list', description: 'List saved profiles' },
-            { key: '/openrouter', description: 'OpenRouter routing prefs (prefer/ignore providers, fallbacks, privacy)' },
-            { key: '/personality', description: 'List or switch agent tone (concise / verbose / security / senior-reviewer / …)' },
-            { key: '/personality <name>', description: 'Activate a personality. /personality off to clear.' },
-            { key: '/me', description: 'Your user profile (reply language, style, stack) — adapts the agent to you' },
-            { key: '/me init [project]', description: 'Scaffold a profile template (global, or for this project). /me off to disable' },
-            { key: '/me learn [on|off]', description: 'Learn durable prefs from this session now; on/off toggles auto-learn. /me forget clears it' },
-            { key: '/me sync', description: 'Push your profile to the codeep.dev dashboard (and pull on a fresh machine)' },
-            { key: '/agents', description: 'List sub-agents the agent can delegate to (researcher / reviewer / tester / your own)' },
-            { key: '/insights [--days N]', description: 'Activity summary — runs, files, tools, projects over the last N days (default 7)' },
-        ],
-    },
-    {
-        title: 'Extensions & MCP (2.0)',
-        items: [
-            { key: '/mcp', description: 'List connected MCP servers + their tools' },
-            { key: '/mcp browse [id]', description: 'Browse marketplace (12 servers) or show one' },
-            { key: '/mcp install <id> [args]', description: 'Install a marketplace server into this project' },
-            { key: '/mcp add <name> <cmd>', description: 'Add a custom MCP server (npx, binary, etc.)' },
-            { key: '/mcp remove <name>', description: 'Remove a project-scoped MCP server' },
-            { key: '/mcp reload', description: 'Re-read .codeep/mcp_servers.json (after manual edit)' },
-            { key: '/mcp resources', description: 'List resources exposed by connected servers' },
-            { key: '/mcp read <uri>', description: 'Read one MCP resource' },
-            { key: '/mcp prompts', description: 'List prompt templates exposed by servers' },
-            { key: '/mcp prompt <server> <name>', description: 'Materialize a prompt with arguments (key=value)' },
-            { key: '/hooks', description: 'List installed lifecycle hooks (.codeep/hooks/<event>.sh)' },
-            { key: '/commands', description: 'List custom slash commands (.codeep/commands/*.md)' },
-        ],
-    },
-    {
-        title: 'Context',
-        items: [
-            { key: '/context-save', description: 'Save conversation' },
-            { key: '/context-load', description: 'Load conversation' },
-            { key: '/context-clear', description: 'Clear saved context' },
-            { key: '/learn', description: 'Learn code preferences' },
-            { key: '/learn status', description: 'Show learned prefs' },
-            { key: '/learn rule <text>', description: 'Add custom rule' },
-        ],
-    },
-    {
-        title: 'Ollama (Local AI)',
-        items: [
-            { key: '/provider', description: 'Select "ollama" for local models' },
-            { key: '/settings > Ollama URL', description: 'Set URL (default: http://localhost:11434)' },
-            { key: '/model', description: 'Pick installed Ollama model dynamically' },
-            { key: '/model pull <model>', description: 'Pull an Ollama model (local Ollama only)' },
-            { key: '/model browse', description: 'Browse recommended local coding models and pull one' },
-            { key: '/model rm <model>', description: 'Remove a locally-installed Ollama model (local only)' },
-            { key: 'OLLAMA_HOST=0.0.0.0', description: 'Required env var for remote Ollama access' },
-        ],
-    },
-];
+export const helpCategories = HELP_LAYOUT;
 /**
- * Keyboard shortcuts
+ * Keyboard shortcuts (independent of the command registry — raw key
+ * bindings, not slash commands).
  */
 export const keyboardShortcuts = [
     { key: 'Enter', description: 'Send message' },

package/dist/renderer/components/Settings.d.ts

@@ -1,8 +1,12 @@
 /**
  * Settings screen component
  */
+import { type ConfigSchema } from '../../config/index';
 export interface SettingItem {
-    key: string;
+    /** Must be a known config key — typed as `keyof ConfigSchema` so adding a
+     *  setting with an unknown key is a compile error, not a silent runtime
+     *  no-op. */
+    key: keyof ConfigSchema;
     label: string;
     getValue: () => string | number | boolean;
     type: 'number' | 'select' | 'text';

package/dist/renderer/components/Settings.js

@@ -7,6 +7,24 @@ import { updateRateLimits } from '../../utils/ratelimit.js';
 // Primary color: #f02a30 (Codeep red)
 const PRIMARY_COLOR = fg.rgb(240, 42, 48);
 const PRIMARY_BRIGHT = fg.rgb(255, 80, 85);
+/**
+ * Write a value to the config for a given setting.
+ *
+ * This is the single typed write path for the settings screen. The win is on
+ * the KEY: `setting.key` is `keyof ConfigSchema` and `config.set` is generic
+ * over the key, so a misspelled or unknown setting key is now a compile error
+ * (previously every call site used `config.set(setting.key as any, …)`, which
+ * suppressed that check too). The VALUE is NOT checked against the specific
+ * key's type — because `SettingItem` is heterogeneous, `typeof setting.key`
+ * widens to the full key union and `ConfigSchema[typeof setting.key]` collapses
+ * to the union of every value type, so the cast here is intentionally wide.
+ * Centralising it keeps that one unavoidable cast in a single audited spot
+ * instead of seven. (Per-key value safety would need a generic `SettingItem<K>`
+ * authored via a `defineSetting<K>` helper — tracked as a follow-up.)
+ */
+function writeSetting(setting, value) {
+    config.set(setting.key, value);
+}
 export const SETTINGS = [
     {
         key: 'temperature',
@@ -308,7 +326,7 @@ export function handleSettingsKey(key, ctrl, state) {
                 const num = parseFloat(state.editValue);
                 if (!isNaN(num)) {
                     const clamped = Math.max(setting.min || 0, Math.min(setting.max || Infinity, num));
-                    config.set(setting.key, clamped);
+                    writeSetting(setting, clamped);
                     if (setting.key === 'rateLimitApi' || setting.key === 'rateLimitCommands') {
                         updateRateLimits();
                     }
@@ -318,7 +336,7 @@ export function handleSettingsKey(key, ctrl, state) {
                 }
             }
             if (setting.type === 'text' && state.editValue.trim()) {
-                config.set(setting.key, state.editValue.trim());
+                writeSetting(setting, state.editValue.trim());
                 newState.editing = false;
                 newState.editValue = '';
                 return { handled: true, close: false, notify: `${setting.label}: ${state.editValue.trim()}`, newState };
@@ -358,7 +376,7 @@ export function handleSettingsKey(key, ctrl, state) {
             const step = setting.step || 1;
             const delta = key === 'left' ? -step : step;
             const newValue = Math.max(setting.min || 0, Math.min(setting.max || Infinity, current + delta));
-            config.set(setting.key, newValue);
+            writeSetting(setting, newValue);
             if (setting.key === 'rateLimitApi' || setting.key === 'rateLimitCommands') {
                 updateRateLimits();
             }
@@ -370,7 +388,7 @@ export function handleSettingsKey(key, ctrl, state) {
             const newIdx = key === 'left'
                 ? (currentIdx - 1 + setting.options.length) % setting.options.length
                 : (currentIdx + 1) % setting.options.length;
-            config.set(setting.key, setting.options[newIdx].value);
+            writeSetting(setting, setting.options[newIdx].value);
             return { handled: true, close: false, newState };
         }
         return { handled: true, close: false, newState };
@@ -386,7 +404,7 @@ export function handleSettingsKey(key, ctrl, state) {
             const current = config.get(setting.key);
             const currentIdx = setting.options.findIndex(o => o.value === current);
             const newIdx = (currentIdx + 1) % setting.options.length;
-            config.set(setting.key, setting.options[newIdx].value);
+            writeSetting(setting, setting.options[newIdx].value);
             return {
                 handled: true,
                 close: false,

package/dist/renderer/main.js

@@ -203,6 +203,8 @@ async function handleSubmit(message) {
                     provider: entry.provider,
                     inputTokens: entry.promptTokens || undefined,
                     outputTokens: entry.completionTokens || undefined,
+                    cacheCreationTokens: entry.cacheCreationTokens || undefined,
+                    cacheReadTokens: entry.cacheReadTokens || undefined,
                     estimatedCost: entry.estimatedCost || undefined,
                 });
             }
@@ -888,6 +890,8 @@ async function gracefulShutdown() {
             projectId,
             inputTokens: tokenStats.totalPromptTokens || undefined,
             outputTokens: tokenStats.totalCompletionTokens || undefined,
+            cacheCreationTokens: tokenStats.totalCacheCreationTokens || undefined,
+            cacheReadTokens: tokenStats.totalCacheReadTokens || undefined,
             estimatedCost: tokenStats.estimatedCost || undefined,
         }),
     ]);

package/dist/utils/codeepCloud.d.ts

@@ -25,6 +25,12 @@ export interface StatsPayload {
     isGit?: boolean;
     inputTokens?: number;
     outputTokens?: number;
+    /** Anthropic prompt caching: tokens written to cache (billed ~1.25× input).
+     *  Undefined for providers that don't report caching. */
+    cacheCreationTokens?: number;
+    /** Anthropic prompt caching: tokens read from cache (billed ~0.1× input).
+     *  Undefined for providers that don't report caching. */
+    cacheReadTokens?: number;
     estimatedCost?: number;
 }
 /**

package/dist/utils/gitHookInstaller.js

@@ -3,7 +3,7 @@
 // issues at/above the threshold are found. Honors .codeep/review.{yml,json}.
 //
 // This is a GIT-hook installer — distinct from the lifecycle SHELL hooks in
-// utils/hooks.ts (.codeep/hooks/<event>.sh) and the React hook in src/hooks/.
+// utils/hooks.ts (.codeep/hooks/<event>.sh).
 import { readFileSync, writeFileSync, mkdirSync, chmodSync, rmSync } from 'fs';
 import { join, dirname, isAbsolute } from 'path';
 import { execSync } from 'child_process';

package/dist/utils/tokenTracker.d.ts

@@ -19,6 +19,10 @@ export interface SessionTokenStats {
     totalTokens: number;
     requestCount: number;
     estimatedCost: number;
+    /** Anthropic prompt caching: total tokens written to cache this session. */
+    totalCacheCreationTokens: number;
+    /** Anthropic prompt caching: total tokens read from cache this session. */
+    totalCacheReadTokens: number;
 }
 interface TokenRecord {
     timestamp: number;
@@ -63,6 +67,12 @@ export interface ProviderCostBreakdown {
     model: string;
     promptTokens: number;
     completionTokens: number;
+    /** Anthropic prompt caching: tokens written to cache (billed ~1.25× input).
+     *  0 for providers that don't report caching. */
+    cacheCreationTokens: number;
+    /** Anthropic prompt caching: tokens read from cache (billed ~0.1× input).
+     *  0 for providers that don't report caching. */
+    cacheReadTokens: number;
     estimatedCost: number;
 }
 /**

package/dist/utils/tokenTracker.js

@@ -167,9 +167,11 @@ export function getCostBreakdown() {
     const grouped = new Map();
     for (const record of records) {
         const key = `${record.provider}/${record.model}`;
-        const existing = grouped.get(key) ?? { provider: record.provider, model: record.model, promptTokens: 0, completionTokens: 0, estimatedCost: 0 };
+        const existing = grouped.get(key) ?? { provider: record.provider, model: record.model, promptTokens: 0, completionTokens: 0, cacheCreationTokens: 0, cacheReadTokens: 0, estimatedCost: 0 };
         existing.promptTokens += record.promptTokens;
         existing.completionTokens += record.completionTokens;
+        existing.cacheCreationTokens += record.cacheCreationTokens ?? 0;
+        existing.cacheReadTokens += record.cacheReadTokens ?? 0;
         // Cost source priority:
         //   1. Provider-reported USD (OpenRouter, MaxiCloud, etc.) — most accurate.
         //   2. Our MODEL_PRICING table — for built-in providers we maintain rates for.
@@ -223,10 +225,14 @@ export function getSessionStats() {
     let totalPromptTokens = 0;
     let totalCompletionTokens = 0;
     let totalTokens = 0;
+    let totalCacheCreationTokens = 0;
+    let totalCacheReadTokens = 0;
     for (const record of records) {
         totalPromptTokens += record.promptTokens;
         totalCompletionTokens += record.completionTokens;
         totalTokens += record.totalTokens;
+        totalCacheCreationTokens += record.cacheCreationTokens ?? 0;
+        totalCacheReadTokens += record.cacheReadTokens ?? 0;
     }
     const estimatedCost = getCostBreakdown().reduce((s, b) => s + b.estimatedCost, 0);
     return {
@@ -235,6 +241,8 @@ export function getSessionStats() {
         totalTokens,
         requestCount: records.length,
         estimatedCost,
+        totalCacheCreationTokens,
+        totalCacheReadTokens,
     };
 }
 /**

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "2.13.0";
+export declare const VERSION = "2.13.2";

package/dist/version.js

@@ -1,4 +1,4 @@
 // AUTO-GENERATED by scripts/gen-version.js — do not edit by hand.
 // Baked from package.json at build time so the bun-compiled binary reports
 // the right version (it has no package.json on disk to read at runtime).
-export const VERSION = '2.13.0';
+export const VERSION = '2.13.2';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codeep",
-  "version": "2.13.0",
+  "version": "2.13.2",
   "description": "AI-powered coding assistant built for the terminal. Multiple LLM providers, project-aware context, and a seamless development workflow.",
   "type": "module",
   "main": "dist/index.js",
@@ -10,9 +10,8 @@
   "scripts": {
     "dev": "node scripts/gen-version.js && node --import tsx src/renderer/main.ts",
     "prepack": "node scripts/gen-version.js && tsc && node scripts/fix-imports.js",
-    "build": "node scripts/gen-version.js && tsc && node scripts/fix-imports.js",
+    "build": "node scripts/gen-version.js && rm -rf dist && tsc && node scripts/fix-imports.js",
     "start": "node dist/renderer/main.js",
-    "build:binary": "npm run build && pkg dist/renderer/main.js --targets node18-macos-arm64,node18-macos-x64,node18-linux-x64 --output bin/codeep",
     "test": "vitest run",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
@@ -39,7 +38,7 @@
   "homepage": "https://codeep.dev",
   "dependencies": {
     "clipboardy": "^4.0.0",
-    "conf": "^12.0.0",
+    "conf": "^13.1.0",
     "js-yaml": "^4.1.0",
     "keytar": "^7.9.0",
     "open": "^10.0.0"
@@ -48,7 +47,6 @@
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^20.10.0",
     "@vitest/coverage-v8": "^4.0.18",
-    "pkg": "^5.8.1",
     "tsx": "^4.7.0",
     "typescript": "^6.0.2",
     "vitest": "^4.0.18"
@@ -67,10 +65,5 @@
   ],
   "publishConfig": {
     "access": "public"
-  },
-  "pkg": {
-    "assets": [
-      "dist/acp/**/*"
-    ]
   }
 }