codeep 2.13.0 → 2.13.1

package/dist/acp/session.d.ts

@@ -26,4 +26,13 @@ export interface AgentSessionOptions {
  * Falls back to a minimal synthetic context if scanning fails.
  */
 export declare function buildProjectContext(workspaceRoot: string): ProjectContext;
+export declare function toolCallMeta(toolName: string, params: Record<string, string>, workspaceRoot: string): {
+    kind: string;
+    title: string;
+};
+export declare function buildRawOutput(toolName: string, params: Record<string, string>, toolResult: {
+    success: boolean;
+    output: string;
+    error?: string;
+}): string | undefined;
 export declare function runAgentSession(opts: AgentSessionOptions): Promise<void>;

package/dist/acp/session.js

@@ -24,7 +24,10 @@ export function buildProjectContext(workspaceRoot) {
     };
 }
 // Maps internal tool names to ACP tool_call kind values and human titles.
-function toolCallMeta(toolName, params, workspaceRoot) {
+// Exported (not just module-private) so it can be unit-tested in isolation —
+// testing it through runAgentSession would require mocking the entire agent
+// loop, which would defeat the point of covering this mapping.
+export function toolCallMeta(toolName, params, workspaceRoot) {
     const file = params.path ?? params.file ?? '';
     // Use full path for edit tools (Zed renders it as a clickable file link)
     const absFile = file
@@ -51,7 +54,8 @@ function toolCallMeta(toolName, params, workspaceRoot) {
 // Builds rawOutput content to display inside tool call cards.
 // For write/edit operations, returns the code content or diff.
 // For command execution, returns the command output.
-function buildRawOutput(toolName, params, toolResult) {
+// Exported for direct unit testing (see session.test.ts).
+export function buildRawOutput(toolName, params, toolResult) {
     // Always surface error details when a tool fails
     if (!toolResult.success && toolResult.error) {
         return `Error: ${toolResult.error}`;

package/dist/config/index.d.ts

@@ -14,8 +14,8 @@ interface ProviderApiKey {
     providerId: string;
     apiKey: string;
 }
-type AgentMode = 'on' | 'manual';
-interface ConfigSchema {
+type AgentMode = 'on' | 'manual' | 'off';
+export interface ConfigSchema {
     apiKey: string;
     provider: string;
     model: string;

package/dist/renderer/App.js

@@ -23,125 +23,12 @@ const LOGO_LINES = [
     ' ╚═════╝ ╚═════╝ ╚═════╝ ╚══════╝╚══════╝╚═╝     ',
 ];
 const LOGO_HEIGHT = LOGO_LINES.length;
-// Command descriptions for autocomplete
-const COMMAND_DESCRIPTIONS = {
-    'help': 'Show help',
-    'status': 'Show status',
-    'settings': 'Adjust settings',
-    'version': 'Show version',
-    'update': 'Check updates',
-    'clear': 'Clear chat',
-    'exit': 'Quit',
-    'sessions': 'Manage sessions',
-    'new': 'New session',
-    'rename': 'Rename session',
-    'search': 'Search history',
-    'export': 'Export chat',
-    'agent': 'Run agent for a task',
-    'agent-dry': 'Preview agent actions',
-    'stop': 'Stop running agent',
-    'undo': 'Undo last action',
-    'undo-all': 'Undo all actions',
-    'history': 'Show agent history',
-    'changes': 'Show session changes',
-    'diff': 'Review git changes',
-    'commit': 'Generate commit message',
-    'git-commit': 'Commit with message',
-    'push': 'Git push',
-    'pull': 'Git pull',
-    'amend': 'Amend the last commit',
-    'pr': 'Create a pull request description',
-    'changelog': 'Generate changelog from recent commits',
-    'branch': 'Create a new branch with smart naming',
-    'stash': 'Stash changes with a meaningful message',
-    'unstash': 'Apply and drop the most recent stash',
-    'init': 'Initialize project (.codeep/)',
-    'scan': 'Scan project',
-    'memory': 'Add/list/remove project memory notes',
-    'review': 'Code review',
-    'copy': 'Copy code block',
-    'paste': 'Paste from clipboard',
-    'apply': 'Apply file changes',
-    'add': 'Add file to context',
-    'drop': 'Remove file from context',
-    'multiline': 'Toggle multi-line input',
-    'test': 'Generate/run tests',
-    'docs': 'Open web docs for a command (e.g. /docs personality)',
-    'refactor': 'Improve code quality',
-    'fix': 'Debug and fix issues',
-    'explain': 'Explain code',
-    'optimize': 'Optimize performance',
-    'debug': 'Debug problems',
-    'test-fix': 'Fix failing tests',
-    'coverage': 'Analyze test coverage and suggest improvements',
-    'e2e': 'Generate end-to-end tests',
-    'mock': 'Generate mock data for testing',
-    'readme': 'Generate or update README',
-    'api-docs': 'Generate API documentation',
-    'translate': 'Translate code comments to English',
-    'types': 'Add or improve TypeScript types',
-    'cleanup': 'Clean up code (remove unused, format)',
-    'modernize': 'Update code to use modern syntax',
-    'migrate': 'Migrate code to newer version',
-    'split': 'Split a large file into smaller modules',
-    'security': 'Security audit',
-    'log': 'Add logging to code',
-    'build': 'Build the project',
-    'deploy': 'Build and deploy',
-    'release': 'Create a new release',
-    'publish': 'Publish package to npm',
-    'component': 'Generate a React/Vue component',
-    'api': 'Generate an API endpoint',
-    'hook': 'Generate a React hook',
-    'service': 'Generate a service/utility module',
-    'page': 'Generate a new page/route',
-    'form': 'Generate a form with validation',
-    'crud': 'Generate full CRUD for an entity',
-    'docker': 'Generate Dockerfile and docker-compose',
-    'ci': 'Generate CI/CD configuration',
-    'env': 'Setup environment configuration',
-    'k8s': 'Generate Kubernetes manifests',
-    'terraform': 'Generate Terraform configuration',
-    'nginx': 'Generate Nginx configuration',
-    'monitor': 'Add monitoring and observability',
-    'skills': 'List all skills',
-    'provider': 'Switch provider',
-    'model': 'Switch model',
-    'protocol': 'Switch protocol',
-    'lang': 'Set language',
-    'grant': 'Grant write permission',
-    'login': 'Change API key',
-    'logout': 'Logout',
-    'account': 'Link this machine to your codeep.dev account',
-    'context-save': 'Save conversation',
-    'context-load': 'Load conversation',
-    'context-clear': 'Clear saved context',
-    'learn': 'Learn code preferences',
-    'cost': 'Show session cost and token usage',
-    'profile': 'Save/load settings profiles',
-    'tasks': 'List/add/done/delete codeep.dev tasks — add <title> [--bug|--feature]',
-    'sync': 'Sync learning preferences and profiles to codeep.dev',
-    'telemetry': 'Show or toggle automatic cloud telemetry (on/off)',
-    'keysync': 'Show or toggle syncing API keys to codeep.dev (on/off)',
-    'thinking': 'Set the thinking/reasoning-effort tier (auto/low/medium/high/max) for models that support it',
-    'effort': 'Alias for /thinking — set the reasoning-effort tier',
-    // 2.0 — surfaced for `/` autocomplete; documented in /help too.
-    'compact': 'Summarize older messages to free up context',
-    'commands': 'List custom slash commands in .codeep/commands/*.md',
-    'checkpoint': 'Snapshot the session (conversation + provider/model + git HEAD)',
-    'checkpoints': 'List saved checkpoints for this workspace',
-    'rewind': 'Restore conversation from a saved checkpoint',
-    'hooks': 'List installed lifecycle hooks (.codeep/hooks/<event>.sh)',
-    'mcp': 'Manage MCP servers (browse, install, add, remove, resources, prompts)',
-    'openrouter': 'Tune OpenRouter routing (preferred / ignore providers, fallbacks, privacy)',
-    'plan': 'Generate a numbered plan for a task — review before /go executes it',
-    'go': 'Execute the pending plan from /plan',
-    'personality': 'Switch agent tone: concise / verbose / security / senior-reviewer / etc',
-    'me': 'Your user profile (reply language, style, stack) — adapts the agent to you. /me init, /me learn, /me sync',
-    'agents': 'List sub-agents the agent can delegate self-contained tasks to (researcher / reviewer / tester / custom)',
-    'insights': 'Activity summary over the last N days (default 7): runs, files, tools, projects',
-    'recall': 'Search across ALL saved sessions (cross-session; /search is current-session only)',
-};
+// ─── Command metadata ────────────────────────────────────────────────────────
+//
+// `COMMAND_DESCRIPTIONS` used to be hand-maintained here in App.ts and kept in
+// sync (manually) with the `/help` screen in components/Help.ts. Both now derive
+// from the single source of truth in `./commands/registry.ts`.
+import { COMMAND_DESCRIPTIONS } from './commands/registry.js';
 import { helpCategories, keyboardShortcuts } from './components/Help.js';
 import { handleSettingsKey, SETTINGS } from './components/Settings.js';
 import { renderExportPanel, handleExportKey as handleExportKeyComponent } from './components/Export.js';

package/dist/renderer/commands/registry.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Single source of truth for Codeep slash commands.
+ *
+ * Every other place that needs command metadata — the `/` autocomplete in
+ * `App.ts`, the `/help` screen in `components/Help.ts`, the dispatcher in
+ * `commands.ts`, and the ACP command handler in `acp/commands.ts` — derives
+ * from this registry. Adding a command means adding one entry here; the
+ * autocomplete list, help screen, and command index all pick it up.
+ *
+ * ## What lives here vs. elsewhere
+ *
+ * - **`CommandDef`** is metadata only: name, aliases, description, category.
+ *   The actual handler logic stays in `renderer/commands.ts` (CLI) and
+ *   `acp/commands.ts` (ACP) — those files keep their per-command `case`
+ *   blocks, but they now look up the canonical name/description/alias map here.
+ * - **Argument syntax** (e.g. `/rename <name>`, `/mcp browse [id]`) is
+ *   documented via the optional `usage` field — surfaced in `/help` only.
+ *   The autocomplete list shows just the bare command name.
+ * - **Hidden commands** (`hidden: true`) are valid and dispatched, but don't
+ *   appear in the autocomplete dropdown or `/help`. Use for aliases that
+ *   would clutter the list (single-letter shortcuts) and internal commands.
+ *
+ * ## Invariants (enforced by `registry.test.ts`)
+ *
+ * - No two commands share a name or alias.
+ * - Every `category` referenced exists in `CATEGORY_ORDER`.
+ * - `usage` keys never collide with a sibling command's name.
+ */
+/** Display categories, in the order `/help` shows them. */
+export declare const CATEGORY_ORDER: readonly ["general", "sessions", "checkpoints", "agent", "git", "code", "skills", "settings", "extensions", "cloud", "codegen", "thinking"];
+export type CommandCategory = (typeof CATEGORY_ORDER)[number];
+/** Human-readable title for each category (used by `/help`). */
+export declare const CATEGORY_TITLES: Record<CommandCategory, string>;
+export interface CommandDef {
+    /** Primary command name, without the leading `/`. */
+    name: string;
+    /** Alternate names that dispatch to the same handler. Hidden from `/help`
+     *  by default (set `aliasListed: true` to show them, e.g. `/effort`). */
+    aliases?: string[];
+    /** One-line description shown in autocomplete and `/help`. */
+    description: string;
+    /** Display group in `/help`. */
+    category: CommandCategory;
+    /** Extra usage rows shown only in `/help` (e.g. `/mcp browse [id]`).
+     *  Each entry is rendered as a separate row under the same command. */
+    usage?: string[];
+    /** When true, the command is valid but hidden from autocomplete + `/help`.
+     *  Used for single-letter shortcuts and internal aliases. */
+    hidden?: boolean;
+    /** When true, an alias is listed in `/help` alongside the primary name
+     *  (e.g. `/effort` appears next to `/thinking`). Default false — most
+     *  aliases are hidden shortcuts. */
+    aliasListed?: boolean;
+}
+/**
+ * The registry. Order within a category is preserved as-is in `/help`,
+ * so keep entries grouped by category in source for readability.
+ */
+export declare const COMMANDS: CommandDef[];
+/** `name → description` for every visible (non-hidden) command + listed alias.
+ *  This is the data behind the `/` autocomplete dropdown in `App.ts`.
+ *
+ *  Single-letter aliases (the `c`/`t`/`d`/… shortcuts) are deliberately
+ *  EXCLUDED from the dropdown — bare one-letter rows just clutter it (they
+ *  stay fully routable via the dispatcher + show in `/help` as `(/c)` suffixes).
+ *  Multi-letter listed aliases (`effort`, `stats`) are kept; they read as real
+ *  commands, not noise. */
+export declare const COMMAND_DESCRIPTIONS: Record<string, string>;
+/** Every valid command name, including hidden ones and aliases — used by the
+ *  dispatcher to validate input before looking up a handler. */
+export declare const ALL_COMMAND_NAMES: ReadonlySet<string>;
+export declare function resolveCommand(token: string): CommandDef | undefined;
+/** All aliases (every value in `aliases` across the registry), for quick
+ *  "is this a shortcut?" checks. */
+export declare const ALL_ALIASES: ReadonlySet<string>;
+export interface HelpItemSpec {
+    /** Visible key in `/help`, including the leading `/`. */
+    key: string;
+    description: string;
+}
+export interface HelpCategorySpec {
+    title: string;
+    items: HelpItemSpec[];
+}
+/**
+ * Hand-curated help layout. Categories appear in this order; each item's `key`
+ * is rendered verbatim. The command registry provides autocomplete + dispatch
+ * metadata; this layout provides the `/help` rendering. They overlap by design
+ * — keeping both lets the help screen document env vars, subcommand flavors,
+ * and recommended workflows that don't fit the strict command/alias shape.
+ */
+export declare const HELP_LAYOUT: HelpCategorySpec[];