@cdoing/cli 0.1.0

package/dist/ui/hooks/useAgent.js

@@ -0,0 +1,213 @@
+"use strict";
+/**
+ * useAgent.ts — React hook that owns the AgentRunner lifecycle.
+ *
+ * Single responsibility: build, rebuild, and run the AI agent.
+ * It knows nothing about conversations, sessions, slash commands, or UI
+ * messages — those live in useChat.ts.
+ *
+ * Why a separate hook?
+ *  - The agent can be rebuilt (e.g. when the user changes the model) without
+ *    touching any message or session state.
+ *  - The streaming callbacks (onToken, onToolCall…) are pure side-effects of
+ *    the agent run.  Keeping them here makes them easy to read end-to-end.
+ *  - useChat.ts can stay focused on slash commands and message history.
+ *
+ * What this hook exposes:
+ *  - agentRef          — the live AgentRunner instance
+ *  - modelConfigRef    — mutable model settings (mutated by /model, /provider)
+ *  - toolRegistryRef   — mutable tool list (mutated by /dir)
+ *  - workingDirRef     — current working directory as a ref
+ *  - planManagerRef    — manages plan-mode state
+ *  - rulesManagerRef   — loads .cdoing/rules.md
+ *  - effortManagerRef  — tracks effort level
+ *  - mcpManagerRef     — MCP server configuration
+ *  - contextProvidersRef — @mention context providers
+ *  - rebuildAgent()    — recreate the agent after config changes
+ *  - resolveContextProviders() — expand @mentions in a message
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useAgent = useAgent;
+const react_1 = require("react");
+const ai_1 = require("@cdoing/ai");
+const core_1 = require("@cdoing/core");
+// ─────────────────────────────────────────────────────────────────────────────
+// Hook
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Manages the AgentRunner and all mutable config references.
+ *
+ * All returned refs are intentionally mutable — slash commands in useChat.ts
+ * mutate them (e.g. modelConfigRef.current.model = "gpt-4o") and then call
+ * rebuildAgent() to create a fresh AgentRunner with the new settings.
+ */
+function useAgent(opts) {
+    // ── Mutable config refs ───────────────────────────────────────────────────
+    // These use useRef (not useState) because changing them should NOT trigger
+    // a re-render.  Re-renders are triggered by state variables in useChat.ts.
+    /** Current working directory — changes when the user runs /dir */
+    const workingDirRef = (0, react_1.useRef)(process.cwd());
+    /** Model + provider + API key settings — changes on /model, /provider, /config set */
+    const modelConfigRef = (0, react_1.useRef)({ ...opts.modelConfig });
+    /** The set of tools available to the agent — swapped on /dir to match the new cwd */
+    const toolRegistryRef = (0, react_1.useRef)(opts.toolRegistry);
+    // ── Feature-manager refs ─────────────────────────────────────────────────
+    // Each manager encapsulates one feature.  They are ref-stored so the agent
+    // can query them synchronously inside buildAgent() without going through state.
+    /** Plan mode: the agent proposes a plan before executing */
+    const planManagerRef = (0, react_1.useRef)(new core_1.PlanManager());
+    /** Project-specific rules loaded from .cdoing/rules.md */
+    const rulesManagerRef = (0, react_1.useRef)(new core_1.RulesManager(process.cwd()));
+    /** Effort level — low / medium / high / max — affects the system prompt */
+    const effortManagerRef = (0, react_1.useRef)(new core_1.EffortManager());
+    /** MCP (Model Context Protocol) server configuration */
+    const mcpManagerRef = (0, react_1.useRef)(new core_1.McpManager(process.cwd()));
+    /**
+     * Registry of @mention context providers.
+     * Each provider has a trigger (e.g. "@file") and a resolve() function that
+     * returns context to inject into the user's message before it reaches the LLM.
+     */
+    const contextProvidersRef = (0, react_1.useRef)(buildContextProviders());
+    // ── Agent ref ────────────────────────────────────────────────────────────
+    /**
+     * The live AgentRunner instance.  Wrapped in a ref so the same object is
+     * accessible inside async callbacks without capturing a stale closure.
+     *
+     * Initialized with buildAgentInternal() immediately, then replaced via
+     * rebuildAgent() whenever settings change.
+     */
+    const agentRef = (0, react_1.useRef)((() => {
+        try {
+            return buildAgentInternal();
+        }
+        catch {
+            return null;
+        }
+    })());
+    // ─────────────────────────────────────────────────────────────────────────
+    // Agent builder
+    // ─────────────────────────────────────────────────────────────────────────
+    /**
+     * Construct a new AgentRunner from the current refs.
+     *
+     * Called once on mount and again via rebuildAgent() after any config change.
+     * Combines project config, rules, and effort hints into a single system prompt.
+     */
+    function buildAgentInternal() {
+        const dir = workingDirRef.current;
+        const projectConfig = (0, core_1.loadProjectConfig)(dir); // .cdoing/config.md
+        const rulesText = rulesManagerRef.current?.formatForPrompt() || "";
+        const effortHint = effortManagerRef.current?.getSystemPromptAddition() || "";
+        // Merge all system-prompt additions, filtering out empty strings
+        const systemPrompt = [projectConfig || "", rulesText, effortHint]
+            .filter(Boolean)
+            .join("\n\n");
+        return new ai_1.AgentRunner(modelConfigRef.current, toolRegistryRef.current, opts.permissionManager, opts.hookManager, {
+            workingDir: dir,
+            projectConfig: systemPrompt || undefined,
+            memory: opts.memoryStore.formatForPrompt() || undefined,
+        });
+    }
+    /**
+     * Replace the live agent with a freshly built one.
+     * Call this any time you mutate modelConfigRef, toolRegistryRef, or workingDirRef.
+     */
+    function rebuildAgent() {
+        try {
+            agentRef.current = buildAgentInternal();
+        }
+        catch (err) {
+            // Don't crash — agentRef keeps the previous agent (or null).
+            // The error will surface as a friendly message on the next send.
+        }
+    }
+    // ─────────────────────────────────────────────────────────────────────────
+    // Context provider resolver
+    // ─────────────────────────────────────────────────────────────────────────
+    /**
+     * Expand any @mention triggers in the user's message.
+     *
+     * Example: "@file src/main.ts tell me what this does"
+     *   → strips "@file src/main.ts"
+     *   → reads the file
+     *   → returns "tell me what this does\n\n---\n\n<file path="src/main.ts">…</file>"
+     *
+     * @param message           Raw message as typed by the user
+     * @param workingDir        Current working directory (for relative file paths)
+     * @param lastTerminalOutput Last captured terminal output (for @terminal)
+     */
+    async function resolveContextProviders(message, workingDir, lastTerminalOutput) {
+        const providers = contextProvidersRef.current.getAll();
+        if (!providers.length)
+            return message;
+        const injected = [];
+        let clean = message;
+        for (const provider of providers) {
+            const idx = message.indexOf(provider.trigger);
+            if (idx < 0)
+                continue; // trigger not present
+            // Extract the argument (text after the trigger on the same line)
+            const after = message.substring(idx + provider.trigger.length);
+            let arg;
+            if (provider.requiresArg) {
+                const end = after.indexOf("\n");
+                arg = (end >= 0 ? after.substring(0, end) : after).trim();
+            }
+            // Remove the trigger (+ optional arg) from the clean message
+            const fullTrigger = provider.requiresArg && arg
+                ? `${provider.trigger} ${arg}`
+                : provider.trigger;
+            clean = clean.replace(fullTrigger, "").trim();
+            try {
+                const result = await provider.resolve(arg, { workingDir, terminalOutput: lastTerminalOutput });
+                if (result.content)
+                    injected.push(result.content);
+            }
+            catch {
+                // If a provider fails, skip it silently — the message still goes through
+            }
+        }
+        // Append all injected context blocks separated by a horizontal rule
+        return injected.length
+            ? `${clean}\n\n---\n\n${injected.join("\n\n---\n\n")}`
+            : clean;
+    }
+    // ─────────────────────────────────────────────────────────────────────────
+    // Public API
+    // ─────────────────────────────────────────────────────────────────────────
+    return {
+        // Refs exposed so slash commands in useChat.ts can mutate them
+        agentRef,
+        modelConfigRef,
+        toolRegistryRef,
+        workingDirRef,
+        planManagerRef,
+        rulesManagerRef,
+        effortManagerRef,
+        mcpManagerRef,
+        contextProvidersRef,
+        // Actions
+        rebuildAgent,
+        resolveContextProviders,
+    };
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Private helpers (module-level, not exported)
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Register all built-in @mention context providers.
+ *
+ * The Strategy pattern: each provider is interchangeable and can be added or
+ * removed without changing the chat hook.
+ */
+function buildContextProviders() {
+    const reg = new core_1.ContextProviderRegistry();
+    reg.register(new core_1.TerminalContextProvider()); // @terminal — recent shell output
+    reg.register(new core_1.UrlContextProvider()); // @url <link> — fetch a webpage
+    reg.register(new core_1.TreeContextProvider()); // @tree — project file tree
+    reg.register(new core_1.CodebaseContextProvider()); // @codebase — full codebase
+    reg.register(new core_1.ClipboardContextProvider()); // @clip — clipboard content
+    reg.register(new core_1.FileIncludeContextProvider()); // @file <path> — include a file
+    return reg;
+}
+//# sourceMappingURL=useAgent.js.map

package/dist/ui/hooks/useAgent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAgent.js","sourceRoot":"","sources":["../../../src/ui/hooks/useAgent.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;;AA6CH,4BAiLC;AA5ND,iCAA+B;AAC/B,mCAAyC;AAGzC,uCAasB;AAetB,gFAAgF;AAChF,OAAO;AACP,gFAAgF;AAEhF;;;;;;GAMG;AACH,SAAgB,QAAQ,CAAC,IAAqB;IAE5C,6EAA6E;IAC7E,2EAA2E;IAC3E,2EAA2E;IAE3E,kEAAkE;IAClE,MAAM,aAAa,GAAG,IAAA,cAAM,EAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAE5C,sFAAsF;IACtF,MAAM,cAAc,GAAG,IAAA,cAAM,EAAuB,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IAE7E,qFAAqF;IACrF,MAAM,eAAe,GAAG,IAAA,cAAM,EAAe,IAAI,CAAC,YAAY,CAAC,CAAC;IAEhE,4EAA4E;IAC5E,2EAA2E;IAC3E,gFAAgF;IAEhF,4DAA4D;IAC5D,MAAM,cAAc,GAAG,IAAA,cAAM,EAAC,IAAI,kBAAW,EAAE,CAAC,CAAC;IAEjD,0DAA0D;IAC1D,MAAM,eAAe,GAAG,IAAA,cAAM,EAAC,IAAI,mBAAY,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAEhE,2EAA2E;IAC3E,MAAM,gBAAgB,GAAG,IAAA,cAAM,EAAC,IAAI,oBAAa,EAAE,CAAC,CAAC;IAErD,wDAAwD;IACxD,MAAM,aAAa,GAAG,IAAA,cAAM,EAAC,IAAI,iBAAU,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAE5D;;;;OAIG;IACH,MAAM,mBAAmB,GAAG,IAAA,cAAM,EAChC,qBAAqB,EAAE,CACxB,CAAC;IAEF,4EAA4E;IAC5E;;;;;;OAMG;IACH,MAAM,QAAQ,GAAG,IAAA,cAAM,EAAqB,CAAC,GAAG,EAAE;QAChD,IAAI,CAAC;YAAC,OAAO,kBAAkB,EAAE,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,OAAO,IAAI,CAAC;QAAC,CAAC;IAC7D,CAAC,CAAC,EAAE,CAAC,CAAC;IAEN,4EAA4E;IAC5E,gBAAgB;IAChB,4EAA4E;IAE5E;;;;;OAKG;IACH,SAAS,kBAAkB;QACzB,MAAM,GAAG,GAAY,aAAa,CAAC,OAAO,CAAC;QAC3C,MAAM,aAAa,GAAG,IAAA,wBAAiB,EAAC,GAAG,CAAC,CAAC,CAAQ,oBAAoB;QACzE,MAAM,SAAS,GAAM,eAAe,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC;QACtE,MAAM,UAAU,GAAK,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,EAAE,IAAI,EAAE,CAAC;QAE/E,iEAAiE;QACjE,MAAM,YAAY,GAAG,CAAC,aAAa,IAAI,EAAE,EAAE,SAAS,EAAE,UAAU,CAAC;aAC9D,MAAM,CAAC,OAAO,CAAC;aACf,IAAI,CAAC,MAAM,CAAC,CAAC;QAEhB,OAAO,IAAI,gBAAW,CACpB,cAAc,CAAC,OAAO,EACtB,eAAe,CAAC,OAAO,EACvB,IAAI,CAAC,iBAAiB,EACtB,IAAI,CAAC,WAAW,EAChB;YACE,UAAU,EAAK,GAAG;YAClB,aAAa,EAAE,YAAY,IAAI,SAAS;YACxC,MAAM,EAAS,IAAI,CAAC,WAAW,CAAC,eAAe,EAAE,IAAI,SAAS;SAC/D,CACF,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,SAAS,YAAY;QACnB,IAAI,CAAC;YACH,QAAQ,CAAC,OAAO,GAAG,kBAAkB,EAAE,CAAC;QAC1C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,6DAA6D;YAC7D,iEAAiE;QACnE,CAAC;IACH,CAAC;IAED,4EAA4E;IAC5E,4BAA4B;IAC5B,4EAA4E;IAE5E;;;;;;;;;;;OAWG;IACH,KAAK,UAAU,uBAAuB,CACpC,OAAe,EACf,UAAkB,EAClB,kBAA0B;QAE1B,MAAM,SAAS,GAAG,mBAAmB,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACvD,IAAI,CAAC,SAAS,CAAC,MAAM;YAAE,OAAO,OAAO,CAAC;QAEtC,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,IAAI,KAAK,GAAG,OAAO,CAAC;QAEpB,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC9C,IAAI,GAAG,GAAG,CAAC;gBAAE,SAAS,CAA6B,sBAAsB;YAEzE,iEAAiE;YACjE,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC/D,IAAI,GAAuB,CAAC;YAC5B,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC;gBACzB,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gBAChC,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;YAC5D,CAAC;YAED,6DAA6D;YAC7D,MAAM,WAAW,GAAG,QAAQ,CAAC,WAAW,IAAI,GAAG;gBAC7C,CAAC,CAAC,GAAG,QAAQ,CAAC,OAAO,IAAI,GAAG,EAAE;gBAC9B,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;YACrB,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAE9C,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;gBAC/F,IAAI,MAAM,CAAC,OAAO;oBAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACpD,CAAC;YAAC,MAAM,CAAC;gBACP,yEAAyE;YAC3E,CAAC;QACH,CAAC;QAED,oEAAoE;QACpE,OAAO,QAAQ,CAAC,MAAM;YACpB,CAAC,CAAC,GAAG,KAAK,cAAc,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE;YACtD,CAAC,CAAC,KAAK,CAAC;IACZ,CAAC;IAED,4EAA4E;IAC5E,aAAa;IACb,4EAA4E;IAE5E,OAAO;QACL,+DAA+D;QAC/D,QAAQ;QACR,cAAc;QACd,eAAe;QACf,aAAa;QACb,cAAc;QACd,eAAe;QACf,gBAAgB;QAChB,aAAa;QACb,mBAAmB;QACnB,UAAU;QACV,YAAY;QACZ,uBAAuB;KACxB,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,+CAA+C;AAC/C,gFAAgF;AAEhF;;;;;GAKG;AACH,SAAS,qBAAqB;IAC5B,MAAM,GAAG,GAAG,IAAI,8BAAuB,EAAE,CAAC;IAC1C,GAAG,CAAC,QAAQ,CAAC,IAAI,8BAAuB,EAAE,CAAC,CAAC,CAAG,kCAAkC;IACjF,GAAG,CAAC,QAAQ,CAAC,IAAI,yBAAkB,EAAE,CAAC,CAAC,CAAQ,gCAAgC;IAC/E,GAAG,CAAC,QAAQ,CAAC,IAAI,0BAAmB,EAAE,CAAC,CAAC,CAAO,4BAA4B;IAC3E,GAAG,CAAC,QAAQ,CAAC,IAAI,8BAAuB,EAAE,CAAC,CAAC,CAAG,4BAA4B;IAC3E,GAAG,CAAC,QAAQ,CAAC,IAAI,+BAAwB,EAAE,CAAC,CAAC,CAAE,4BAA4B;IAC3E,GAAG,CAAC,QAAQ,CAAC,IAAI,iCAA0B,EAAE,CAAC,CAAC,CAAA,gCAAgC;IAC/E,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/ui/hooks/useChat.d.ts

@@ -0,0 +1,74 @@
+/**
+ * useChat.ts — Main chat state hook.
+ *
+ * This is the top-level hook consumed by App.tsx.  It wires together three
+ * concerns that intentionally live in separate modules:
+ *
+ *   1. Agent lifecycle   →  ./useAgent.ts
+ *      Build / rebuild the AgentRunner when settings change.
+ *
+ *   2. Pure utilities    →  ./helpers.ts
+ *      Terminal output, diff printing, help text — no React.
+ *
+ *   3. This file (useChat.ts)
+ *      - Message history (what's displayed in the chat window)
+ *      - Session / conversation persistence
+ *      - Background jobs (/bg, /jobs)
+ *      - Slash command dispatch (/model, /dir, /clear, …)
+ *      - The sendMessage() function that runs the agent and streams tokens
+ *
+ * Learning note — why split at all?
+ *   A single 1000-line file works but becomes hard to navigate.  Splitting by
+ *   responsibility means you can read useAgent.ts to understand "how is the
+ *   AI agent built?" without wading through session management, and vice versa.
+ *
+ * Data flow:
+ *   User types  →  UserInput.tsx  →  onSubmit  →  App.tsx  →  sendMessage()
+ *                                                              ↓
+ *                                                       agentRef.current.run()
+ *                                                              ↓
+ *                                              onToken / onToolCall / onComplete
+ *                                                              ↓
+ *                                                    setStreamingContent / setMessages
+ */
+import type { ModelConfig } from "@cdoing/ai";
+import type { ToolRegistry, PermissionManager, HookManager, MemoryStore, TodoStore } from "@cdoing/core";
+import { listConversations } from "../../history";
+import type { ChatMessage, ToolActivity, UsageInfo, ContextUsage, BackgroundJob } from "../types";
+/** Props passed by the parent component (App.tsx → chat.ts → here) */
+export interface UseChatOptions {
+    modelConfig: Partial<ModelConfig>;
+    toolRegistry: ToolRegistry;
+    permissionManager: PermissionManager;
+    hookManager: HookManager;
+    memoryStore: MemoryStore;
+    todoStore?: TodoStore;
+}
+export declare function useChat(opts: UseChatOptions): {
+    messages: ChatMessage[];
+    setMessages: import("react").Dispatch<import("react").SetStateAction<ChatMessage[]>>;
+    streamingContent: string;
+    isProcessing: boolean;
+    toolActivity: ToolActivity | null;
+    lastUsage: UsageInfo | null;
+    contextUsage: ContextUsage | null;
+    workingDir: string;
+    backgroundJobs: BackgroundJob[];
+    showSessionBrowser: boolean;
+    setShowSessionBrowser: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    conversations: typeof listConversations;
+    modelConfig: {
+        provider?: string | undefined;
+        model?: string | undefined;
+        apiKey?: string | undefined;
+        oauthToken?: string | undefined;
+        temperature?: number | undefined;
+        maxTokens?: number | undefined;
+        baseURL?: string | undefined;
+    };
+    sendMessage: (text: string) => Promise<void>;
+    handleSlashCommand: (command: string) => Promise<string | null>;
+    cancelCurrent: () => void;
+    addSystemMessage: (content: string) => void;
+};
+//# sourceMappingURL=useChat.d.ts.map

package/dist/ui/hooks/useChat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChat.d.ts","sourceRoot":"","sources":["../../../src/ui/hooks/useChat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAOH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EAEjB,WAAW,EACX,WAAW,EACX,SAAS,EACV,MAAM,cAAc,CAAC;AAItB,OAAO,EAIL,iBAAiB,EAKlB,MAAM,eAAe,CAAC;AAsBvB,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAiBlG,sEAAsE;AACtE,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAQ,OAAO,CAAC,WAAW,CAAC,CAAC;IACxC,YAAY,EAAO,YAAY,CAAC;IAChC,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,WAAW,EAAQ,WAAW,CAAC;IAC/B,WAAW,EAAQ,WAAW,CAAC;IAC/B,SAAS,CAAC,EAAS,SAAS,CAAC;CAC9B;AAMD,wBAAgB,OAAO,CAAC,IAAI,EAAE,cAAc;;;;;;;;;;;;;;;;;;;;;;wBAwL3B,MAAM;kCA2JH,MAAM,KAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;;gCA/Od,MAAM,KAAG,IAAI;EAytBjD"}