attocode 0.1.0

package/dist/src/modes/tui.d.ts

@@ -0,0 +1,29 @@
+/**
+ * TUI Mode
+ *
+ * Full-featured Terminal User Interface for the coding agent.
+ * Uses Ink/React for rendering with anti-flicker patterns.
+ *
+ * Features:
+ * - Flicker-free rendering via Ink's <Static> component
+ * - Single useInput hook (no input conflicts)
+ * - Command palette with fuzzy search (Ctrl+P)
+ * - Theme system (dark, light, high-contrast)
+ * - LSP integration for code intelligence
+ * - Session persistence with checkpoints
+ */
+import type { LLMProviderWithTools } from '../providers/types.js';
+import type { PermissionMode } from '../tools/types.js';
+export interface TUIModeOptions {
+    permissionMode?: PermissionMode;
+    maxIterations?: number;
+    model?: string;
+    trace?: boolean;
+    theme?: 'dark' | 'light' | 'auto';
+}
+/**
+ * Start the TUI mode.
+ * Falls back to REPL mode if TUI is not available.
+ */
+export declare function startTUIMode(provider: LLMProviderWithTools, options?: TUIModeOptions): Promise<void>;
+//# sourceMappingURL=tui.d.ts.map

package/dist/src/modes/tui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui.d.ts","sourceRoot":"","sources":["../../../src/modes/tui.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AA6BxD,MAAM,WAAW,cAAc;IAC7B,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;CACnC;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,oBAAoB,EAC9B,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CA0Qf"}

package/dist/src/modes/tui.js

@@ -0,0 +1,272 @@
+/**
+ * TUI Mode
+ *
+ * Full-featured Terminal User Interface for the coding agent.
+ * Uses Ink/React for rendering with anti-flicker patterns.
+ *
+ * Features:
+ * - Flicker-free rendering via Ink's <Static> component
+ * - Single useInput hook (no input conflicts)
+ * - Command palette with fuzzy search (Ctrl+P)
+ * - Theme system (dark, light, high-contrast)
+ * - LSP integration for code intelligence
+ * - Session persistence with checkpoints
+ */
+import { createProductionAgent } from '../agent.js';
+import { ProviderAdapter, convertToolsFromRegistry, createTUIApprovalBridge } from '../adapters.js';
+import { createStandardRegistry } from '../tools/standard.js';
+import { TUIPermissionChecker } from '../tools/permission.js';
+import { createSQLiteStore, createSessionStore, createMCPClient, createCompactor, } from '../integrations/index.js';
+import { persistenceDebug, saveCheckpointToStore, loadSessionState, } from '../integrations/persistence.js';
+import { getMCPConfigPaths } from '../paths.js';
+import { showSessionPicker, showQuickPicker, formatSessionsTable } from '../session-picker.js';
+import { createLSPManager } from '../integrations/lsp.js';
+import { createLSPFileTools } from '../agent-tools/lsp-file-tools.js';
+import { initPricingCache } from '../integrations/openrouter-pricing.js';
+// Import TUI components and utilities
+import { TUIApp, checkTUICapabilities } from '../tui/index.js';
+// Import REPL mode for fallback
+import { startProductionREPL } from './repl.js';
+/**
+ * Start the TUI mode.
+ * Falls back to REPL mode if TUI is not available.
+ */
+export async function startTUIMode(provider, options = {}) {
+    const { permissionMode = 'interactive', maxIterations = 50, model, trace = false, theme = 'auto', } = options;
+    try {
+        // Check Ink availability
+        const capabilities = await checkTUICapabilities();
+        if (!capabilities.inkAvailable) {
+            console.log('! TUI not available. Falling back to legacy mode.');
+            return startProductionREPL(provider, options);
+        }
+        // Enable TUI mode for debug logger to prevent console interference with Ink
+        persistenceDebug.enableTUIMode();
+        // CRITICAL: Initialize session storage FIRST, before any heavy dynamic imports
+        // This ensures better-sqlite3 native module loads cleanly
+        let sessionStore;
+        persistenceDebug.log('[TUI] Initializing session store BEFORE dynamic imports...');
+        try {
+            sessionStore = await createSQLiteStore({ baseDir: '.agent/sessions' });
+            if (persistenceDebug.isEnabled()) {
+                const sqliteStore = sessionStore;
+                const stats = sqliteStore.getStats();
+                persistenceDebug.log('[TUI] SQLite store initialized!', { sessions: stats.sessionCount, checkpoints: stats.checkpointCount });
+            }
+            console.log('+ SQLite session store initialized');
+        }
+        catch (sqliteError) {
+            const errMsg = sqliteError.message;
+            if (persistenceDebug.isEnabled()) {
+                process.stderr.write(`[DEBUG] [TUI] SQLite FAILED: ${errMsg}\n`);
+            }
+            console.log('! SQLite unavailable, using JSONL fallback');
+            console.log(`   Error: ${errMsg}`);
+            sessionStore = await createSessionStore({ baseDir: '.agent/sessions' });
+        }
+        // Dynamic imports - using our modular TUI components
+        const { render } = await import('ink');
+        const React = await import('react');
+        // Initialize pricing cache from OpenRouter
+        await initPricingCache();
+        // Setup agent
+        // Create approval bridge FIRST so we can use it for the permission checker
+        // This must be created before the registry to inject the TUI permission checker
+        const approvalBridge = permissionMode === 'interactive' ? createTUIApprovalBridge() : null;
+        // Create registry with the real permission mode
+        // For interactive mode, we inject a TUIPermissionChecker that routes through the TUI dialog
+        // This prevents the console-based permission prompt from conflicting with Ink
+        const registry = createStandardRegistry(permissionMode);
+        // In interactive mode, inject TUI permission checker that routes through approval dialog
+        if (approvalBridge) {
+            const tuiChecker = new TUIPermissionChecker(approvalBridge);
+            registry.setPermissionChecker(tuiChecker);
+        }
+        const tools = convertToolsFromRegistry(registry);
+        const adaptedProvider = new ProviderAdapter(provider, model);
+        // Hierarchical MCP config: global (~/.config/attocode/mcp.json) + workspace (.mcp.json)
+        const mcpClient = await createMCPClient({
+            configPaths: getMCPConfigPaths(),
+            lazyLoading: true,
+            alwaysLoadTools: [],
+            summaryDescriptionLimit: 100,
+            maxToolsPerSearch: 5,
+        });
+        const mcpSummaries = mcpClient.getAllToolSummaries().map(s => ({
+            name: s.name,
+            description: s.description,
+        }));
+        // Initialize LSP manager for code intelligence
+        const lspManager = createLSPManager({ autoDetect: true });
+        let lspServers = [];
+        try {
+            lspServers = await lspManager.autoStart(process.cwd());
+            if (lspServers.length > 0) {
+                console.log(`@ LSP: Started ${lspServers.join(', ')} language server(s)`);
+            }
+            else {
+                console.log(`* LSP: No language servers found (optional)`);
+                console.log(`   For inline diagnostics: npm i -g typescript-language-server typescript`);
+            }
+        }
+        catch (err) {
+            console.log(`! LSP: Could not start language servers (${err.message})`);
+        }
+        // Create LSP-enhanced file tools (replaces standard edit_file/write_file)
+        const lspFileTools = createLSPFileTools({ lspManager, diagnosticDelay: 500 });
+        // Replace standard edit_file/write_file with LSP-enhanced versions
+        const standardToolsWithoutFileOps = tools.filter(t => !['edit_file', 'write_file'].includes(t.name));
+        const allTools = [...standardToolsWithoutFileOps, ...lspFileTools];
+        // approvalBridge is already created above with the permission checker
+        const agent = createProductionAgent({
+            toolResolver: (toolName) => toolName.startsWith('mcp_') ? mcpClient.getFullToolDefinition(toolName) : null,
+            mcpToolSummaries: mcpSummaries,
+            provider: adaptedProvider,
+            tools: allTools,
+            model,
+            maxIterations,
+            memory: { enabled: true, types: { episodic: true, semantic: true, working: true } },
+            planning: { enabled: true, autoplan: true, complexityThreshold: 6 },
+            humanInLoop: permissionMode === 'interactive'
+                ? {
+                    enabled: true,
+                    riskThreshold: 'moderate', // Require approval for moderate+ risk tools
+                    alwaysApprove: [], // Don't auto-approve anything, show dialog
+                    neverApprove: ['read_file', 'list_files', 'glob', 'grep'], // Safe read tools
+                    approvalHandler: approvalBridge.handler, // TUI approval handler
+                    auditLog: true,
+                }
+                : false,
+            // Observability: trace capture to file when --trace, logging disabled in TUI (use debug mode instead)
+            observability: trace
+                ? { enabled: true, traceCapture: { enabled: true, outputDir: '.traces' }, logging: { enabled: false } }
+                : undefined,
+            // Hooks: Only enable console output in debug mode
+            hooks: {
+                enabled: true,
+                builtIn: {
+                    logging: persistenceDebug.isEnabled(), // Only show [Hook] logs in debug mode
+                    timing: persistenceDebug.isEnabled(), // Only show timing in debug mode
+                    metrics: true,
+                },
+                custom: [],
+            },
+        });
+        // Session store was already initialized at the top
+        const compactor = createCompactor(adaptedProvider, {
+            tokenThreshold: 80000,
+            preserveRecentCount: 10,
+        });
+        // Check for existing sessions to offer resume
+        let currentSessionId;
+        let resumedSession = false;
+        const existingSessions = await sessionStore.listSessions();
+        persistenceDebug.log('[TUI] Checking existing sessions', { count: existingSessions.length });
+        if (existingSessions.length > 0) {
+            const pickerResult = await showQuickPicker(existingSessions);
+            if (pickerResult.action === 'cancel') {
+                // User typed 'list' - show full picker
+                const fullResult = await showSessionPicker(existingSessions);
+                if (fullResult.action === 'resume' && fullResult.sessionId) {
+                    currentSessionId = fullResult.sessionId;
+                    resumedSession = true;
+                }
+                else if (fullResult.action === 'cancel') {
+                    console.log('Goodbye!');
+                    await mcpClient.cleanup();
+                    await agent.cleanup();
+                    await lspManager.cleanup();
+                    return;
+                }
+                else {
+                    currentSessionId = await sessionStore.createSession();
+                }
+            }
+            else if (pickerResult.action === 'resume' && pickerResult.sessionId) {
+                currentSessionId = pickerResult.sessionId;
+                resumedSession = true;
+            }
+            else {
+                currentSessionId = await sessionStore.createSession();
+            }
+        }
+        else {
+            currentSessionId = await sessionStore.createSession();
+        }
+        persistenceDebug.log('[TUI] Session selected', {
+            sessionId: currentSessionId,
+            resumed: resumedSession,
+            storeType: persistenceDebug.storeType(sessionStore),
+        });
+        // CRITICAL: Sync the session ID to the store's internal state
+        sessionStore.setCurrentSessionId(currentSessionId);
+        // If resuming, load the session state
+        if (resumedSession) {
+            const sessionState = await loadSessionState(sessionStore, currentSessionId);
+            if (sessionState?.messages) {
+                agent.loadState({
+                    messages: sessionState.messages,
+                    iteration: sessionState.iteration,
+                    metrics: sessionState.metrics,
+                    plan: sessionState.plan,
+                    memoryContext: sessionState.memoryContext,
+                });
+                console.log(`+ Resumed ${sessionState.messages.length} messages from session`);
+            }
+        }
+        // Get git branch for status line (using execFileSync for safety - no shell injection possible)
+        const getGitBranch = () => {
+            try {
+                const { execFileSync } = require('child_process');
+                return execFileSync('git', ['rev-parse', '--abbrev-ref', 'HEAD'], { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+            }
+            catch {
+                return '';
+            }
+        };
+        const gitBranch = getGitBranch();
+        // Render TUI (don't clear in debug mode so we can see initialization messages)
+        if (!persistenceDebug.isEnabled()) {
+            console.clear();
+        }
+        else {
+            console.log('\n--- TUI Starting (debug mode - console not cleared) ---\n');
+        }
+        // Pass all required props to the TUIApp
+        const tuiProps = {
+            agent,
+            sessionStore: sessionStore,
+            mcpClient,
+            compactor,
+            lspManager: {
+                cleanup: () => lspManager.cleanup(),
+                getActiveServers: () => lspManager.getActiveServers(),
+            },
+            theme: theme,
+            model: model || 'default',
+            gitBranch,
+            currentSessionId,
+            formatSessionsTable,
+            saveCheckpointToStore,
+            loadSessionState,
+            persistenceDebug: {
+                isEnabled: () => persistenceDebug.isEnabled(),
+                log: (message, data) => persistenceDebug.log(message, data),
+                error: (message, error) => persistenceDebug.error(message, error),
+            },
+            // Approval bridge for TUI permission dialogs (only in interactive mode)
+            approvalBridge: approvalBridge || undefined,
+        };
+        const instance = render(React.createElement(TUIApp, tuiProps));
+        await instance.waitUntilExit();
+        await agent.cleanup();
+        await mcpClient.cleanup();
+        await lspManager.cleanup();
+    }
+    catch (error) {
+        console.error('! TUI failed:', error.message);
+        console.log('   Falling back to legacy mode.');
+        return startProductionREPL(provider, options);
+    }
+}
+//# sourceMappingURL=tui.js.map

package/dist/src/modes/tui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui.js","sourceRoot":"","sources":["../../../src/modes/tui.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACpG,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAI9D,OAAO,EAEL,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,eAAe,GAChB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,GAEjB,MAAM,gCAAgC,CAAC;AAExC,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC/F,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAEzE,sCAAsC;AACtC,OAAO,EAAE,MAAM,EAAoB,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEjF,gCAAgC;AAChC,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAUhD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,QAA8B,EAC9B,UAA0B,EAAE;IAE5B,MAAM,EACJ,cAAc,GAAG,aAAa,EAC9B,aAAa,GAAG,EAAE,EAClB,KAAK,EACL,KAAK,GAAG,KAAK,EACb,KAAK,GAAG,MAAM,GACf,GAAG,OAAO,CAAC;IAEZ,IAAI,CAAC;QACH,yBAAyB;QACzB,MAAM,YAAY,GAAG,MAAM,oBAAoB,EAAE,CAAC;QAElD,IAAI,CAAC,YAAY,CAAC,YAAY,EAAE,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;YACjE,OAAO,mBAAmB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAChD,CAAC;QAED,4EAA4E;QAC5E,gBAAgB,CAAC,aAAa,EAAE,CAAC;QAEjC,+EAA+E;QAC/E,0DAA0D;QAC1D,IAAI,YAA6B,CAAC;QAElC,gBAAgB,CAAC,GAAG,CAAC,4DAA4D,CAAC,CAAC;QAEnF,IAAI,CAAC;YACH,YAAY,GAAG,MAAM,iBAAiB,CAAC,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC,CAAC;YAEvE,IAAI,gBAAgB,CAAC,SAAS,EAAE,EAAE,CAAC;gBACjC,MAAM,WAAW,GAAG,YAA2B,CAAC;gBAChD,MAAM,KAAK,GAAG,WAAW,CAAC,QAAQ,EAAE,CAAC;gBACrC,gBAAgB,CAAC,GAAG,CAAC,iCAAiC,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,YAAY,EAAE,WAAW,EAAE,KAAK,CAAC,eAAe,EAAE,CAAC,CAAC;YAChI,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;QACpD,CAAC;QAAC,OAAO,WAAW,EAAE,CAAC;YACrB,MAAM,MAAM,GAAI,WAAqB,CAAC,OAAO,CAAC;YAC9C,IAAI,gBAAgB,CAAC,SAAS,EAAE,EAAE,CAAC;gBACjC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gCAAgC,MAAM,IAAI,CAAC,CAAC;YACnE,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;YAC1D,OAAO,CAAC,GAAG,CAAC,aAAa,MAAM,EAAE,CAAC,CAAC;YACnC,YAAY,GAAG,MAAM,kBAAkB,CAAC,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC,CAAC;QAC1E,CAAC;QAED,qDAAqD;QACrD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC;QACvC,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;QAEpC,2CAA2C;QAC3C,MAAM,gBAAgB,EAAE,CAAC;QAEzB,cAAc;QACd,2EAA2E;QAC3E,gFAAgF;QAChF,MAAM,cAAc,GAAG,cAAc,KAAK,aAAa,CAAC,CAAC,CAAC,uBAAuB,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAE3F,gDAAgD;QAChD,4FAA4F;QAC5F,8EAA8E;QAC9E,MAAM,QAAQ,GAAG,sBAAsB,CAAC,cAAc,CAAC,CAAC;QAExD,yFAAyF;QACzF,IAAI,cAAc,EAAE,CAAC;YACnB,MAAM,UAAU,GAAG,IAAI,oBAAoB,CAAC,cAAc,CAAC,CAAC;YAC5D,QAAQ,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC;QAC5C,CAAC;QAED,MAAM,KAAK,GAAG,wBAAwB,CAAC,QAAQ,CAAC,CAAC;QACjD,MAAM,eAAe,GAAG,IAAI,eAAe,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAE7D,wFAAwF;QACxF,MAAM,SAAS,GAAG,MAAM,eAAe,CAAC;YACtC,WAAW,EAAE,iBAAiB,EAAE;YAChC,WAAW,EAAE,IAAI;YACjB,eAAe,EAAE,EAAE;YACnB,uBAAuB,EAAE,GAAG;YAC5B,iBAAiB,EAAE,CAAC;SACrB,CAAC,CAAC;QAEH,MAAM,YAAY,GAAG,SAAS,CAAC,mBAAmB,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC7D,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,WAAW;SAC3B,CAAC,CAAC,CAAC;QAEJ,+CAA+C;QAC/C,MAAM,UAAU,GAAG,gBAAgB,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,IAAI,UAAU,GAAa,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,UAAU,GAAG,MAAM,UAAU,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;YACvD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC1B,OAAO,CAAC,GAAG,CAAC,kBAAkB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;YAC5E,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,6CAA6C,CAAC,CAAC;gBAC3D,OAAO,CAAC,GAAG,CAAC,2EAA2E,CAAC,CAAC;YAC3F,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,GAAG,CAAC,4CAA6C,GAAa,CAAC,OAAO,GAAG,CAAC,CAAC;QACrF,CAAC;QAED,0EAA0E;QAC1E,MAAM,YAAY,GAAG,kBAAkB,CAAC,EAAE,UAAU,EAAE,eAAe,EAAE,GAAG,EAAE,CAAC,CAAC;QAE9E,mEAAmE;QACnE,MAAM,2BAA2B,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACrG,MAAM,QAAQ,GAAG,CAAC,GAAG,2BAA2B,EAAE,GAAG,YAAY,CAAC,CAAC;QAEnE,sEAAsE;QAEtE,MAAM,KAAK,GAAG,qBAAqB,CAAC;YAClC,YAAY,EAAE,CAAC,QAAgB,EAAE,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI;YAClH,gBAAgB,EAAE,YAAY;YAC9B,QAAQ,EAAE,eAAe;YACzB,KAAK,EAAE,QAAQ;YACf,KAAK;YACL,aAAa;YACb,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;YACnF,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,mBAAmB,EAAE,CAAC,EAAE;YACnE,WAAW,EAAE,cAAc,KAAK,aAAa;gBAC3C,CAAC,CAAC;oBACE,OAAO,EAAE,IAAI;oBACb,aAAa,EAAE,UAAU,EAAG,4CAA4C;oBACxE,aAAa,EAAE,EAAE,EAAG,2CAA2C;oBAC/D,YAAY,EAAE,CAAC,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,EAAG,kBAAkB;oBAC9E,eAAe,EAAE,cAAe,CAAC,OAAO,EAAG,uBAAuB;oBAClE,QAAQ,EAAE,IAAI;iBACf;gBACH,CAAC,CAAC,KAAK;YACT,sGAAsG;YACtG,aAAa,EAAE,KAAK;gBAClB,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;gBACvG,CAAC,CAAC,SAAS;YACb,kDAAkD;YAClD,KAAK,EAAE;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE;oBACP,OAAO,EAAE,gBAAgB,CAAC,SAAS,EAAE,EAAE,sCAAsC;oBAC7E,MAAM,EAAE,gBAAgB,CAAC,SAAS,EAAE,EAAG,iCAAiC;oBACxE,OAAO,EAAE,IAAI;iBACd;gBACD,MAAM,EAAE,EAAE;aACX;SACF,CAAC,CAAC;QAEH,mDAAmD;QACnD,MAAM,SAAS,GAAG,eAAe,CAAC,eAAe,EAAE;YACjD,cAAc,EAAE,KAAK;YACrB,mBAAmB,EAAE,EAAE;SACxB,CAAC,CAAC;QAEH,8CAA8C;QAC9C,IAAI,gBAAwB,CAAC;QAC7B,IAAI,cAAc,GAAG,KAAK,CAAC;QAE3B,MAAM,gBAAgB,GAAG,MAAM,YAAY,CAAC,YAAY,EAAE,CAAC;QAC3D,gBAAgB,CAAC,GAAG,CAAC,kCAAkC,EAAE,EAAE,KAAK,EAAE,gBAAgB,CAAC,MAAM,EAAE,CAAC,CAAC;QAE7F,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,MAAM,YAAY,GAAG,MAAM,eAAe,CAAC,gBAAgB,CAAC,CAAC;YAE7D,IAAI,YAAY,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACrC,uCAAuC;gBACvC,MAAM,UAAU,GAAG,MAAM,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;gBAE7D,IAAI,UAAU,CAAC,MAAM,KAAK,QAAQ,IAAI,UAAU,CAAC,SAAS,EAAE,CAAC;oBAC3D,gBAAgB,GAAG,UAAU,CAAC,SAAS,CAAC;oBACxC,cAAc,GAAG,IAAI,CAAC;gBACxB,CAAC;qBAAM,IAAI,UAAU,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;oBAC1C,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;oBACxB,MAAM,SAAS,CAAC,OAAO,EAAE,CAAC;oBAC1B,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC;oBACtB,MAAM,UAAU,CAAC,OAAO,EAAE,CAAC;oBAC3B,OAAO;gBACT,CAAC;qBAAM,CAAC;oBACN,gBAAgB,GAAG,MAAM,YAAY,CAAC,aAAa,EAAE,CAAC;gBACxD,CAAC;YACH,CAAC;iBAAM,IAAI,YAAY,CAAC,MAAM,KAAK,QAAQ,IAAI,YAAY,CAAC,SAAS,EAAE,CAAC;gBACtE,gBAAgB,GAAG,YAAY,CAAC,SAAS,CAAC;gBAC1C,cAAc,GAAG,IAAI,CAAC;YACxB,CAAC;iBAAM,CAAC;gBACN,gBAAgB,GAAG,MAAM,YAAY,CAAC,aAAa,EAAE,CAAC;YACxD,CAAC;QACH,CAAC;aAAM,CAAC;YACN,gBAAgB,GAAG,MAAM,YAAY,CAAC,aAAa,EAAE,CAAC;QACxD,CAAC;QAED,gBAAgB,CAAC,GAAG,CAAC,wBAAwB,EAAE;YAC7C,SAAS,EAAE,gBAAgB;YAC3B,OAAO,EAAE,cAAc;YACvB,SAAS,EAAE,gBAAgB,CAAC,SAAS,CAAC,YAAY,CAAC;SACpD,CAAC,CAAC;QAEH,8DAA8D;QAC9D,YAAY,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,CAAC;QAEnD,sCAAsC;QACtC,IAAI,cAAc,EAAE,CAAC;YACnB,MAAM,YAAY,GAAG,MAAM,gBAAgB,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAC;YAC5E,IAAI,YAAY,EAAE,QAAQ,EAAE,CAAC;gBAC3B,KAAK,CAAC,SAAS,CAAC;oBACd,QAAQ,EAAE,YAAY,CAAC,QAAe;oBACtC,SAAS,EAAE,YAAY,CAAC,SAAS;oBACjC,OAAO,EAAE,YAAY,CAAC,OAAc;oBACpC,IAAI,EAAE,YAAY,CAAC,IAAW;oBAC9B,aAAa,EAAE,YAAY,CAAC,aAAa;iBAC1C,CAAC,CAAC;gBACH,OAAO,CAAC,GAAG,CAAC,aAAa,YAAY,CAAC,QAAQ,CAAC,MAAM,wBAAwB,CAAC,CAAC;YACjF,CAAC;QACH,CAAC;QAED,+FAA+F;QAC/F,MAAM,YAAY,GAAG,GAAW,EAAE;YAChC,IAAI,CAAC;gBACH,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;gBAClD,OAAO,YAAY,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAClI,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC,CAAC;QACF,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;QAEjC,+EAA+E;QAC/E,IAAI,CAAC,gBAAgB,CAAC,SAAS,EAAE,EAAE,CAAC;YAClC,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,6DAA6D,CAAC,CAAC;QAC7E,CAAC;QAED,wCAAwC;QACxC,MAAM,QAAQ,GAAgB;YAC5B,KAAK;YACL,YAAY,EAAE,YAA2B;YACzC,SAAS;YACT,SAAS;YACT,UAAU,EAAE;gBACV,OAAO,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE;gBACnC,gBAAgB,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,gBAAgB,EAAE;aACtD;YACD,KAAK,EAAE,KAAe;YACtB,KAAK,EAAE,KAAK,IAAI,SAAS;YACzB,SAAS;YACT,gBAAgB;YAChB,mBAAmB;YACnB,qBAAqB;YACrB,gBAAgB;YAChB,gBAAgB,EAAE;gBAChB,SAAS,EAAE,GAAG,EAAE,CAAC,gBAAgB,CAAC,SAAS,EAAE;gBAC7C,GAAG,EAAE,CAAC,OAAe,EAAE,IAAU,EAAE,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC;gBACzE,KAAK,EAAE,CAAC,OAAe,EAAE,KAAW,EAAE,EAAE,CAAC,gBAAgB,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC;aAChF;YACD,wEAAwE;YACxE,cAAc,EAAE,cAAc,IAAI,SAAS;SAC5C,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC/D,MAAM,QAAQ,CAAC,aAAa,EAAE,CAAC;QAC/B,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC;QACtB,MAAM,SAAS,CAAC,OAAO,EAAE,CAAC;QAC1B,MAAM,UAAU,CAAC,OAAO,EAAE,CAAC;IAE7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,eAAe,EAAG,KAAe,CAAC,OAAO,CAAC,CAAC;QACzD,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;QAC/C,OAAO,mBAAmB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;AACH,CAAC"}

package/dist/src/modes.d.ts

@@ -0,0 +1,179 @@
+/**
+ * Lesson 25: Agent Modes (OpenCode-inspired)
+ *
+ * Provides different operational modes for the agent:
+ * - Build: Full access to modify files and run commands
+ * - Plan: Read-only mode for exploration and planning
+ * - Review: Read-only mode focused on code review
+ *
+ * Users can switch modes with Tab key or /mode command.
+ *
+ * Usage:
+ *   agent.setMode('plan');
+ *   const currentMode = agent.getMode();
+ */
+import type { ToolDefinition } from './types.js';
+/**
+ * Available agent modes.
+ */
+export type AgentMode = 'build' | 'plan' | 'review' | 'debug';
+/**
+ * Mode configuration.
+ */
+export interface ModeConfig {
+    /** Display name */
+    name: string;
+    /** Short description */
+    description: string;
+    /** Available tool names in this mode */
+    availableTools: string[];
+    /** Additional system prompt for this mode */
+    systemPromptAddition: string;
+    /** Color for terminal display (ANSI code) */
+    color: string;
+    /** Icon for display */
+    icon: string;
+    /** Whether write operations require approval before execution (plan mode feature) */
+    requireWriteApproval: boolean;
+    /** Whether to show plan-specific prompts and UI elements */
+    showPlanPrompt: boolean;
+}
+/**
+ * Mode event types.
+ */
+export type ModeEvent = {
+    type: 'mode.changed';
+    from: AgentMode;
+    to: AgentMode;
+} | {
+    type: 'mode.tool.filtered';
+    tool: string;
+    mode: AgentMode;
+} | {
+    type: 'mode.write.intercepted';
+    tool: string;
+    reason: string;
+};
+export type ModeEventListener = (event: ModeEvent) => void;
+/**
+ * Tools that modify the filesystem or execute side effects.
+ * In plan mode with write approval, these are queued instead of executed.
+ */
+export declare const WRITE_TOOLS: string[];
+/**
+ * Check if a tool is a write operation.
+ */
+export declare function isWriteTool(toolName: string): boolean;
+/**
+ * Analyze bash command to determine if it's a write operation.
+ * Returns true for commands that modify state.
+ */
+export declare function isBashWriteCommand(command: string): boolean;
+/**
+ * Read-only tools available in restricted modes.
+ */
+export declare const READ_ONLY_TOOLS: string[];
+/**
+ * All tools (for build mode).
+ */
+export declare const ALL_TOOLS = "*";
+/**
+ * Mode configurations.
+ */
+export declare const MODES: Record<AgentMode, ModeConfig>;
+/**
+ * Manages agent modes and tool filtering.
+ */
+export declare class ModeManager {
+    private currentMode;
+    private eventListeners;
+    private allToolNames;
+    constructor(tools?: ToolDefinition[]);
+    /**
+     * Get the current mode.
+     */
+    getMode(): AgentMode;
+    /**
+     * Get the current mode configuration.
+     */
+    getModeConfig(): ModeConfig;
+    /**
+     * Set the agent mode.
+     */
+    setMode(mode: AgentMode): void;
+    /**
+     * Cycle to the next mode.
+     */
+    cycleMode(): AgentMode;
+    /**
+     * Check if a tool is available in the current mode.
+     */
+    isToolAvailable(toolName: string): boolean;
+    /**
+     * Filter tools based on current mode.
+     */
+    filterTools(tools: ToolDefinition[]): ToolDefinition[];
+    /**
+     * Get the system prompt addition for the current mode.
+     */
+    getSystemPromptAddition(): string;
+    /**
+     * Get all available modes.
+     */
+    getAllModes(): AgentMode[];
+    /**
+     * Get mode info for display.
+     */
+    getModeInfo(mode?: AgentMode): {
+        name: string;
+        icon: string;
+        color: string;
+    };
+    /**
+     * Format mode for terminal display.
+     */
+    formatModePrompt(): string;
+    /**
+     * Subscribe to mode events.
+     */
+    subscribe(listener: ModeEventListener): () => void;
+    /**
+     * Update available tools.
+     */
+    updateTools(tools: ToolDefinition[]): void;
+    /**
+     * Check if the current mode requires write approval.
+     */
+    requiresWriteApproval(): boolean;
+    /**
+     * Check if the current mode should show plan prompts.
+     */
+    shouldShowPlanPrompt(): boolean;
+    /**
+     * Check if a tool call should be intercepted (queued) in current mode.
+     * Returns true if the tool is a write operation and mode requires approval.
+     *
+     * @param toolName - The name of the tool
+     * @param args - The tool arguments (needed to check bash commands)
+     */
+    shouldInterceptTool(toolName: string, args?: Record<string, unknown>): boolean;
+    /**
+     * Toggle between build and plan modes.
+     * Useful for shift-tab or /plan command.
+     */
+    togglePlanMode(): AgentMode;
+    private emit;
+}
+/**
+ * Create a mode manager.
+ */
+export declare function createModeManager(tools?: ToolDefinition[]): ModeManager;
+/**
+ * Format all modes for display.
+ */
+export declare function formatModeList(): string;
+/**
+ * Parse mode from string (case-insensitive).
+ */
+export declare function parseMode(input: string): AgentMode | null;
+//# sourceMappingURL=modes.d.ts.map

package/dist/src/modes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modes.d.ts","sourceRoot":"","sources":["../../src/modes.ts"],"names":[],"mappings":"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"}