@nanocollective/nanocoder 1.11.3

package/LICENSE.md

@@ -0,0 +1,23 @@
+# License
+
+MIT License
+
+Copyright (c) 2025 Nano Collective
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,366 @@
+# Nanocoder
+
+A local-first CLI coding agent that brings the power of agentic coding tools like Claude Code and Gemini CLI to local models or controlled APIs like OpenRouter. Built with privacy and control in mind, Nanocoder supports multiple AI providers with tool support for file operations and command execution.
+
+![Example](./.github/assets/example.gif)
+
+## Table of Contents
+
+- [FAQs](#faqs)
+- [Installation](#installation)
+  - [For Users (Recommended)](#for-users-recommended)
+  - [For Development](#for-development)
+- [Configuration](#configuration)
+  - [AI Provider Setup](#ai-provider-setup)
+  - [MCP (Model Context Protocol) Servers](#mcp-model-context-protocol-servers)
+  - [User Preferences](#user-preferences)
+  - [Commands](#commands)
+    - [Built-in Commands](#built-in-commands)
+    - [Custom Commands](#custom-commands)
+- [Features](#features)
+  - [Multi-Provider Support](#-multi-provider-support)
+  - [Advanced Tool System](#️-advanced-tool-system)
+  - [Custom Command System](#-custom-command-system)
+  - [Enhanced User Experience](#-enhanced-user-experience)
+  - [Developer Features](#️-developer-features)
+- [Community](#community)
+
+## FAQs
+
+### What is Nanocoder?
+
+Nanocoder is a local-first CLI coding agent that brings the power of agentic coding tools like Claude Code and Gemini CLI to local models or controlled APIs like OpenRouter. Built with privacy and control in mind, Nanocoder supports any AI provider that has an OpenAI compatible end-point, tool and non-tool calling models.
+
+### How is this different to OpenCode?
+
+This comes down to philosophy. OpenCode is a great tool, but it's owned and managed by a venture-backed company that restricts community and open-source involvement to the outskirts. With Nanocoder, the focus is on building a true community-led project where anyone can contribute openly and directly. We believe AI is too powerful to be in the hands of big corporations and everyone should have access to it.
+
+We also strongly believe in the "local-first" approach, where your data, models, and processing stay on your machine whenever possible to ensure maximum privacy and user control. Beyond that, we're actively pushing to develop advancements and frameworks for small, local models to be effective at coding locally.
+
+Not everyone will agree with this philosophy, and that's okay. We believe in fostering an inclusive community that's focused on open collaboration and privacy-first AI coding tools.
+
+### I want to be involved, how do I start?
+
+Firstly, we would love for you to be involved. You can get started contributing to Nanocoder in several ways, check out the [Community](#community) section of this README.
+
+## Installation
+
+### For Users (Recommended)
+
+Install globally and use anywhere:
+
+```bash
+npm install -g @nanocollective/nanocoder
+```
+
+Then run in any directory:
+
+```bash
+nanocoder
+```
+
+### For Development
+
+If you want to contribute or modify Nanocoder:
+
+**Prerequisites:**
+
+- Node.js 18+
+- npm
+
+**Setup:**
+
+1. Clone and install dependencies:
+
+```bash
+git clone [repo-url]
+cd nanocoder
+npm install
+```
+
+2. Build the project:
+
+```bash
+npm run build
+```
+
+3. Run locally:
+
+```bash
+npm run start
+```
+
+Or build and run in one command:
+
+```bash
+npm run dev
+```
+
+## Configuration
+
+### AI Provider Setup
+
+Nanocoder supports any OpenAI-compatible API through a unified provider configuration. Create `agents.config.json` in your **working directory** (where you run `nanocoder`):
+
+```json
+{
+	"nanocoder": {
+		"providers": [
+			{
+				"name": "llama-cpp",
+				"baseUrl": "http://localhost:8080/v1",
+				"models": ["qwen3-coder:a3b", "deepseek-v3.1"]
+			},
+			{
+				"name": "Ollama",
+				"baseUrl": "http://localhost:11434/v1",
+				"models": ["qwen2.5-coder:14b", "llama3.2"]
+			},
+			{
+				"name": "OpenRouter",
+				"baseUrl": "https://openrouter.ai/api/v1",
+				"apiKey": "your-openrouter-api-key",
+				"models": ["openai/gpt-4o-mini", "anthropic/claude-3-haiku"]
+			},
+			{
+				"name": "LM Studio",
+				"baseUrl": "http://localhost:1234/v1",
+				"models": ["local-model"]
+			}
+		]
+	}
+}
+```
+
+**Common Provider Examples:**
+
+- **llama.cpp server**: `"baseUrl": "http://localhost:8080/v1"`
+- **llama-swap**: `"baseUrl": "http://localhost:9292/v1"`
+- **Ollama (Local)**:
+
+  - First run: `ollama pull qwen2.5-coder:14b`
+  - Use: `"baseUrl": "http://localhost:11434/v1"`
+
+- **OpenRouter (Cloud)**:
+
+  - Use: `"baseUrl": "https://openrouter.ai/api/v1"`
+  - Requires: `"apiKey": "your-api-key"`
+
+- **LM Studio**: `"baseUrl": "http://localhost:1234/v1"`
+- **vLLM**: `"baseUrl": "http://localhost:8000/v1"`
+- **LocalAI**: `"baseUrl": "http://localhost:8080/v1"`
+- **OpenAI**: `"baseUrl": "https://api.openai.com/v1"`
+
+**Provider Configuration:**
+
+- `name`: Display name used in `/provider` command
+- `baseUrl`: OpenAI-compatible API endpoint
+- `apiKey`: API key (optional for local servers)
+- `models`: Available model list for `/model` command
+
+### MCP (Model Context Protocol) Servers
+
+Nanocoder supports connecting to MCP servers to extend its capabilities with additional tools. Configure MCP servers in your `agents.config.json`:
+
+```json
+{
+	"nanocoder": {
+		"mcpServers": [
+			{
+				"name": "filesystem",
+				"command": "npx",
+				"args": [
+					"@modelcontextprotocol/server-filesystem",
+					"/path/to/allowed/directory"
+				]
+			},
+			{
+				"name": "github",
+				"command": "npx",
+				"args": ["@modelcontextprotocol/server-github"],
+				"env": {
+					"GITHUB_TOKEN": "your-github-token"
+				}
+			},
+			{
+				"name": "custom-server",
+				"command": "python",
+				"args": ["path/to/server.py"],
+				"env": {
+					"API_KEY": "your-api-key"
+				}
+			}
+		]
+	}
+}
+```
+
+When MCP servers are configured, Nanocoder will:
+
+- Automatically connect to all configured servers on startup
+- Make all server tools available to the AI model
+- Show connected servers and their tools with the `/mcp` command
+
+Popular MCP servers:
+
+- **Filesystem**: Enhanced file operations
+- **GitHub**: Repository management
+- **Brave Search**: Web search capabilities
+- **Memory**: Persistent context storage
+- [View more MCP servers](https://github.com/modelcontextprotocol/servers)
+
+> **Note**: The `agents.config.json` file should be placed in the directory where you run Nanocoder, allowing for project-by-project configuration with different models or API keys per repository.
+
+### User Preferences
+
+Nanocoder automatically saves your preferences to remember your choices across sessions. Preferences are stored in `~/.nanocoder-preferences.json` in your home directory.
+
+**What gets saved automatically:**
+
+- **Last provider used**: The AI provider you last selected (by name from your configuration)
+- **Last model per provider**: Your preferred model for each provider
+- **Session continuity**: Automatically switches back to your preferred provider/model when restarting
+
+**How it works:**
+
+- When you switch providers with `/provider`, your choice is saved
+- When you switch models with `/model`, the selection is saved for that specific provider
+- Next time you start Nanocoder, it will use your last provider and model
+- Each provider remembers its own preferred model independently
+
+**Manual management:**
+
+- View current preferences: The file is human-readable JSON
+- Reset preferences: Delete `~/.nanocoder-preferences.json` to start fresh
+- No manual editing needed: Use the `/provider` and `/model` commands instead
+
+### Commands
+
+#### Built-in Commands
+
+- `/help` - Show available commands
+- `/init` - Initialize project with intelligent analysis, create AGENTS.md and configuration files
+- `/clear` - Clear chat history
+- `/model` - Switch between available models
+- `/provider` - Switch between configured AI providers
+- `/mcp` - Show connected MCP servers and their tools
+- `/debug` - Toggle logging levels (silent/normal/verbose)
+- `/custom-commands` - List all custom commands
+- `/exit` - Exit the application
+- `/export` - Export current session to markdown file
+- `/theme` - Select a theme for the Nanocoder CLI
+- `/update` - Update Nanocoder to the latest version
+- `!command` - Execute bash commands directly without leaving Nanocoder (output becomes context for the LLM)
+
+#### Custom Commands
+
+Nanocoder supports custom commands defined as markdown files in the `.nanocoder/commands` directory. Like `agents.config.json`, this directory is created per codebase, allowing you to create reusable prompts with parameters and organize them by category specific to each project.
+
+**Example custom command** (`.nanocoder/commands/test.md`):
+
+```markdown
+---
+description: 'Generate comprehensive unit tests for the specified component'
+aliases: ['testing', 'spec']
+parameters:
+  - name: 'component'
+    description: 'The component or function to test'
+    required: true
+---
+
+Generate comprehensive unit tests for {{component}}. Include:
+
+- Happy path scenarios
+- Edge cases and error handling
+- Mock dependencies where appropriate
+- Clear test descriptions
+```
+
+**Usage**: `/test component="UserService"`
+
+**Features**:
+
+- YAML frontmatter for metadata (description, aliases, parameters)
+- Template variable substitution with `{{parameter}}` syntax
+- Namespace support through directories (e.g., `/refactor:dry`)
+- Autocomplete integration for command discovery
+- Parameter validation and prompting
+
+**Pre-installed Commands**:
+
+- `/test` - Generate comprehensive unit tests for components
+- `/review` - Perform thorough code reviews with suggestions
+- `/refactor:dry` - Apply DRY (Don't Repeat Yourself) principle
+- `/refactor:solid` - Apply SOLID design principles
+
+## Features
+
+### 🔌 Multi-Provider Support
+
+- **Universal OpenAI compatibility**: Works with any OpenAI-compatible API
+- **Local providers**: Ollama, LM Studio, vLLM, LocalAI, llama.cpp
+- **Cloud providers**: OpenRouter, OpenAI, and other hosted services
+- **Smart fallback**: Automatically switches to available providers if one fails
+- **Per-provider preferences**: Remembers your preferred model for each provider
+- **Dynamic configuration**: Add any provider with just a name and endpoint
+
+### 🛠️ Advanced Tool System
+
+- **Built-in tools**: File operations, bash command execution
+- **MCP (Model Context Protocol) servers**: Extend capabilities with any MCP-compatible tool
+- **Dynamic tool loading**: Tools are loaded on-demand from configured MCP servers
+- **Tool approval**: Optional confirmation before executing potentially destructive operations
+
+### 📝 Custom Command System
+
+- **Markdown-based commands**: Define reusable prompts in `.nanocoder/commands/`
+- **Template variables**: Use `{{parameter}}` syntax for dynamic content
+- **Namespace organization**: Organize commands in folders (e.g., `refactor/dry.md`)
+- **Autocomplete support**: Tab completion for command discovery
+- **Rich metadata**: YAML frontmatter for descriptions, aliases, and parameters
+
+### 🎯 Enhanced User Experience
+
+- **Smart autocomplete**: Tab completion for commands with real-time suggestions
+- **Prompt history**: Access and reuse previous prompts with `/history`
+- **Configurable logging**: Silent, normal, or verbose output levels
+- **Colorized output**: Syntax highlighting and structured display
+- **Session persistence**: Maintains context and preferences across sessions
+- **Real-time indicators**: Shows token usage, timing, and processing status
+- **First-time directory security disclaimer**: Prompts on first run and stores a per-project trust decision to prevent accidental exposure of local code or secrets.
+
+### ⚙️ Developer Features
+
+- **TypeScript-first**: Full type safety and IntelliSense support
+- **Extensible architecture**: Plugin-style system for adding new capabilities
+- **Project-specific config**: Different settings per project via `agents.config.json`
+- **Debug tools**: Built-in debugging commands and verbose logging
+- **Error resilience**: Graceful handling of provider failures and network issues
+
+## Community
+
+We're a small community-led team building Nanocoder and would love your help! Whether you're interested in contributing code, documentation, or just being part of our community, there are several ways to get involved.
+
+**If you want to contribute to the code:**
+
+- Read our detailed [CONTRIBUTING.md](CONTRIBUTING.md) guide for information on development setup, coding standards, and how to submit your changes.
+
+**If you want to be part of our community or help with other aspects like design or marketing:**
+
+- Join our Discord server to connect with other users, ask questions, share ideas, and get help: [Join our Discord server](https://discord.gg/ktPDV6rekE)
+
+- Head to our GitHub issues or discussions to open and join current conversations with others in the community.
+
+**What does Nanocoder you need help with?**
+
+Nanocoder could benefit from help all across the board. Such as:
+
+- Adding support for new AI providers
+- Improving tool functionality
+- Enhancing the user experience
+- Writing documentation
+- Reporting bugs or suggesting features
+- Marketing and getting the word out
+- Design and building more great software
+
+All contributions and community participation are welcome!

package/dist/app/hooks/useAppInitialization.d.ts

@@ -0,0 +1,26 @@
+import React from 'react';
+import { LLMClient, ProviderType } from '../../types/core.js';
+import { ToolManager } from '../../tools/tool-manager.js';
+import { CustomCommandLoader } from '../../custom-commands/loader.js';
+import { CustomCommandExecutor } from '../../custom-commands/executor.js';
+interface UseAppInitializationProps {
+    setClient: (client: LLMClient | null) => void;
+    setCurrentModel: (model: string) => void;
+    setCurrentProvider: (provider: ProviderType) => void;
+    setToolManager: (manager: ToolManager | null) => void;
+    setCustomCommandLoader: (loader: CustomCommandLoader | null) => void;
+    setCustomCommandExecutor: (executor: CustomCommandExecutor | null) => void;
+    setCustomCommandCache: (cache: Map<string, any>) => void;
+    setStartChat: (start: boolean) => void;
+    setMcpInitialized: (initialized: boolean) => void;
+    addToChatQueue: (component: React.ReactNode) => void;
+    componentKeyCounter: number;
+    customCommandCache: Map<string, any>;
+}
+export declare function useAppInitialization({ setClient, setCurrentModel, setCurrentProvider, setToolManager, setCustomCommandLoader, setCustomCommandExecutor, setCustomCommandCache, setStartChat, setMcpInitialized, addToChatQueue, componentKeyCounter, customCommandCache, }: UseAppInitializationProps): {
+    initializeClient: (preferredProvider?: ProviderType) => Promise<void>;
+    loadCustomCommands: (loader: CustomCommandLoader) => Promise<void>;
+    initializeMCPServers: (toolManager: ToolManager) => Promise<void>;
+};
+export {};
+//# sourceMappingURL=useAppInitialization.d.ts.map

package/dist/app/hooks/useAppInitialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAppInitialization.d.ts","sourceRoot":"","sources":["../../../source/app/hooks/useAppInitialization.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkB,MAAM,OAAO,CAAC;AACvC,OAAO,EAAC,SAAS,EAAE,YAAY,EAAC,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAC,WAAW,EAAC,MAAM,6BAA6B,CAAC;AACxD,OAAO,EAAC,mBAAmB,EAAC,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAC,qBAAqB,EAAC,MAAM,mCAAmC,CAAC;AAiCxE,UAAU,yBAAyB;IAClC,SAAS,EAAE,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,KAAK,IAAI,CAAC;IAC9C,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,kBAAkB,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAC;IACrD,cAAc,EAAE,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;IACtD,sBAAsB,EAAE,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,KAAK,IAAI,CAAC;IACrE,wBAAwB,EAAE,CAAC,QAAQ,EAAE,qBAAqB,GAAG,IAAI,KAAK,IAAI,CAAC;IAC3E,qBAAqB,EAAE,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC;IACzD,YAAY,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,iBAAiB,EAAE,CAAC,WAAW,EAAE,OAAO,KAAK,IAAI,CAAC;IAClD,cAAc,EAAE,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,KAAK,IAAI,CAAC;IACrD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACrC;AAED,wBAAgB,oBAAoB,CAAC,EACpC,SAAS,EACT,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,sBAAsB,EACtB,wBAAwB,EACxB,qBAAqB,EACrB,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,kBAAkB,GAClB,EAAE,yBAAyB;2CAEyB,YAAY;iCA4BtB,mBAAmB;wCA4BZ,WAAW;EAmJ5D"}

package/dist/app/hooks/useAppInitialization.js

@@ -0,0 +1,151 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useEffect } from 'react';
+import { ToolManager } from '../../tools/tool-manager.js';
+import { CustomCommandLoader } from '../../custom-commands/loader.js';
+import { CustomCommandExecutor } from '../../custom-commands/executor.js';
+import { createLLMClient } from '../../client-factory.js';
+import { getLastUsedModel, loadPreferences, updateLastUsed, } from '../../config/preferences.js';
+import { setToolManagerGetter, setToolRegistryGetter, } from '../../message-handler.js';
+import { commandRegistry } from '../../commands.js';
+import { shouldLog } from '../../config/logging.js';
+import { appConfig } from '../../config/index.js';
+import { clearCommand, commandsCommand, debugCommand, exitCommand, exportCommand, helpCommand, initCommand, mcpCommand, modelCommand, providerCommand, themeCommand, updateCommand, } from '../../commands/index.js';
+import SuccessMessage from '../../components/success-message.js';
+import ErrorMessage from '../../components/error-message.js';
+import InfoMessage from '../../components/info-message.js';
+export function useAppInitialization({ setClient, setCurrentModel, setCurrentProvider, setToolManager, setCustomCommandLoader, setCustomCommandExecutor, setCustomCommandCache, setStartChat, setMcpInitialized, addToChatQueue, componentKeyCounter, customCommandCache, }) {
+    // Initialize LLM client and model
+    const initializeClient = async (preferredProvider) => {
+        const { client, actualProvider } = await createLLMClient(preferredProvider);
+        setClient(client);
+        setCurrentProvider(actualProvider);
+        // Try to use the last used model for this provider
+        const lastUsedModel = getLastUsedModel(actualProvider);
+        let finalModel;
+        if (lastUsedModel) {
+            const availableModels = await client.getAvailableModels();
+            if (availableModels.includes(lastUsedModel)) {
+                client.setModel(lastUsedModel);
+                finalModel = lastUsedModel;
+            }
+            else {
+                finalModel = client.getCurrentModel();
+            }
+        }
+        else {
+            finalModel = client.getCurrentModel();
+        }
+        setCurrentModel(finalModel);
+        // Save the preference - use actualProvider and the model that was actually set
+        updateLastUsed(actualProvider, finalModel);
+    };
+    // Load and cache custom commands
+    const loadCustomCommands = async (loader) => {
+        await loader.loadCommands();
+        const customCommands = loader.getAllCommands() || [];
+        // Populate command cache for better performance
+        customCommandCache.clear();
+        for (const command of customCommands) {
+            customCommandCache.set(command.name, command);
+            // Also cache aliases for quick lookup
+            if (command.metadata?.aliases) {
+                for (const alias of command.metadata.aliases) {
+                    customCommandCache.set(alias, command);
+                }
+            }
+        }
+        if (customCommands.length > 0 && shouldLog('info')) {
+            addToChatQueue(_jsx(InfoMessage, { message: `Loaded ${customCommands.length} custom commands from .nanocoder/commands`, hideBox: true }, `custom-commands-loaded-${componentKeyCounter}`));
+        }
+    };
+    // Initialize MCP servers if configured
+    const initializeMCPServers = async (toolManager) => {
+        if (appConfig.mcpServers && appConfig.mcpServers.length > 0) {
+            // Add connecting message to chat queue
+            addToChatQueue(_jsx(InfoMessage, { message: `Connecting to ${appConfig.mcpServers.length} MCP server${appConfig.mcpServers.length > 1 ? 's' : ''}...`, hideBox: true }, `mcp-connecting-${componentKeyCounter}`));
+            // Define progress callback to show live updates
+            const onProgress = (result) => {
+                if (result.success) {
+                    addToChatQueue(_jsx(SuccessMessage, { message: `Connected to MCP server "${result.serverName}" with ${result.toolCount} tools`, hideBox: true }, `mcp-success-${result.serverName}-${componentKeyCounter}`));
+                }
+                else {
+                    addToChatQueue(_jsx(ErrorMessage, { message: `Failed to connect to MCP server "${result.serverName}": ${result.error}`, hideBox: true }, `mcp-error-${result.serverName}-${componentKeyCounter}`));
+                }
+            };
+            try {
+                await toolManager.initializeMCP(appConfig.mcpServers, onProgress);
+            }
+            catch (error) {
+                addToChatQueue(_jsx(ErrorMessage, { message: `Failed to initialize MCP servers: ${error}`, hideBox: true }, `mcp-fatal-error-${componentKeyCounter}`));
+            }
+            // Mark MCP as initialized whether successful or not
+            setMcpInitialized(true);
+        }
+        else {
+            // No MCP servers configured, mark as initialized immediately
+            setMcpInitialized(true);
+        }
+    };
+    const start = async (newToolManager, newCustomCommandLoader, preferences) => {
+        try {
+            await initializeClient(preferences.lastProvider);
+        }
+        catch (error) {
+            // Don't crash the app - just show the error and continue without a client
+            addToChatQueue(_jsx(ErrorMessage, { message: `No providers available: ${error}`, hideBox: true }, `init-error-${componentKeyCounter}`));
+            // Leave client as null - the UI will handle this gracefully
+        }
+        try {
+            await loadCustomCommands(newCustomCommandLoader);
+        }
+        catch (error) {
+            addToChatQueue(_jsx(ErrorMessage, { message: `Failed to load custom commands: ${error}`, hideBox: true }, `commands-error-${componentKeyCounter}`));
+        }
+    };
+    useEffect(() => {
+        const initializeApp = async () => {
+            setClient(null);
+            setCurrentModel('');
+            const newToolManager = new ToolManager();
+            const newCustomCommandLoader = new CustomCommandLoader();
+            const newCustomCommandExecutor = new CustomCommandExecutor();
+            setToolManager(newToolManager);
+            setCustomCommandLoader(newCustomCommandLoader);
+            setCustomCommandExecutor(newCustomCommandExecutor);
+            // Load preferences - we'll pass them directly to avoid state timing issues
+            const preferences = loadPreferences();
+            // Add info message to chat queue when preferences are loaded
+            addToChatQueue(_jsx(SuccessMessage, { message: "User preferences loaded...", hideBox: true }, "preferences-loaded"));
+            // Set up the tool registry getter for the message handler
+            setToolRegistryGetter(() => newToolManager.getToolRegistry());
+            // Set up the tool manager getter for commands that need it
+            setToolManagerGetter(() => newToolManager);
+            commandRegistry.register([
+                helpCommand,
+                exitCommand,
+                clearCommand,
+                modelCommand,
+                providerCommand,
+                commandsCommand,
+                debugCommand,
+                mcpCommand,
+                initCommand,
+                themeCommand,
+                exportCommand,
+                updateCommand,
+            ]);
+            // Now start with the properly initialized objects (excluding MCP)
+            await start(newToolManager, newCustomCommandLoader, preferences);
+            setStartChat(true);
+            // Initialize MCP servers after UI is shown
+            await initializeMCPServers(newToolManager);
+        };
+        initializeApp();
+    }, []);
+    return {
+        initializeClient,
+        loadCustomCommands,
+        initializeMCPServers,
+    };
+}
+//# sourceMappingURL=useAppInitialization.js.map

package/dist/app/hooks/useAppInitialization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAppInitialization.js","sourceRoot":"","sources":["../../../source/app/hooks/useAppInitialization.tsx"],"names":[],"mappings":"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"}

package/dist/app/hooks/useAppState.d.ts

@@ -0,0 +1,84 @@
+import { LLMClient, Message, ProviderType } from '../../types/core.js';
+import { ToolManager } from '../../tools/tool-manager.js';
+import { CustomCommandLoader } from '../../custom-commands/loader.js';
+import { CustomCommandExecutor } from '../../custom-commands/executor.js';
+import type { ThemePreset } from '../../types/ui.js';
+import React from 'react';
+export interface ThinkingStats {
+    tokenCount: number;
+    contextSize: number;
+    totalTokensUsed: number;
+    tokensPerSecond?: number;
+}
+export interface ConversationContext {
+    updatedMessages: Message[];
+    assistantMsg: Message;
+    systemMessage: Message;
+}
+export declare function useAppState(): {
+    client: LLMClient | null;
+    messages: Message[];
+    displayMessages: Message[];
+    messageTokenCache: Map<string, number>;
+    currentModel: string;
+    currentProvider: ProviderType;
+    currentTheme: ThemePreset;
+    toolManager: ToolManager | null;
+    customCommandLoader: CustomCommandLoader | null;
+    customCommandExecutor: CustomCommandExecutor | null;
+    customCommandCache: Map<string, any>;
+    startChat: boolean;
+    mcpInitialized: boolean;
+    isThinking: boolean;
+    isCancelling: boolean;
+    thinkingStats: ThinkingStats;
+    abortController: AbortController | null;
+    isModelSelectionMode: boolean;
+    isProviderSelectionMode: boolean;
+    isThemeSelectionMode: boolean;
+    isToolConfirmationMode: boolean;
+    isToolExecuting: boolean;
+    isBashExecuting: boolean;
+    currentBashCommand: string;
+    pendingToolCalls: any[];
+    currentToolIndex: number;
+    completedToolResults: any[];
+    currentConversationContext: ConversationContext | null;
+    chatComponents: React.ReactNode[];
+    componentKeyCounter: number;
+    setClient: React.Dispatch<React.SetStateAction<LLMClient | null>>;
+    setMessages: React.Dispatch<React.SetStateAction<Message[]>>;
+    setDisplayMessages: React.Dispatch<React.SetStateAction<Message[]>>;
+    setMessageTokenCache: React.Dispatch<React.SetStateAction<Map<string, number>>>;
+    setCurrentModel: React.Dispatch<React.SetStateAction<string>>;
+    setCurrentProvider: React.Dispatch<React.SetStateAction<ProviderType>>;
+    setCurrentTheme: React.Dispatch<React.SetStateAction<ThemePreset>>;
+    setToolManager: React.Dispatch<React.SetStateAction<ToolManager | null>>;
+    setCustomCommandLoader: React.Dispatch<React.SetStateAction<CustomCommandLoader | null>>;
+    setCustomCommandExecutor: React.Dispatch<React.SetStateAction<CustomCommandExecutor | null>>;
+    setCustomCommandCache: React.Dispatch<React.SetStateAction<Map<string, any>>>;
+    setStartChat: React.Dispatch<React.SetStateAction<boolean>>;
+    setMcpInitialized: React.Dispatch<React.SetStateAction<boolean>>;
+    setIsThinking: React.Dispatch<React.SetStateAction<boolean>>;
+    setIsCancelling: React.Dispatch<React.SetStateAction<boolean>>;
+    setThinkingStats: React.Dispatch<React.SetStateAction<ThinkingStats>>;
+    setAbortController: React.Dispatch<React.SetStateAction<AbortController | null>>;
+    setIsModelSelectionMode: React.Dispatch<React.SetStateAction<boolean>>;
+    setIsProviderSelectionMode: React.Dispatch<React.SetStateAction<boolean>>;
+    setIsThemeSelectionMode: React.Dispatch<React.SetStateAction<boolean>>;
+    setIsToolConfirmationMode: React.Dispatch<React.SetStateAction<boolean>>;
+    setIsToolExecuting: React.Dispatch<React.SetStateAction<boolean>>;
+    setIsBashExecuting: React.Dispatch<React.SetStateAction<boolean>>;
+    setCurrentBashCommand: React.Dispatch<React.SetStateAction<string>>;
+    setPendingToolCalls: React.Dispatch<React.SetStateAction<any[]>>;
+    setCurrentToolIndex: React.Dispatch<React.SetStateAction<number>>;
+    setCompletedToolResults: React.Dispatch<React.SetStateAction<any[]>>;
+    setCurrentConversationContext: React.Dispatch<React.SetStateAction<ConversationContext | null>>;
+    setChatComponents: React.Dispatch<React.SetStateAction<React.ReactNode[]>>;
+    setComponentKeyCounter: React.Dispatch<React.SetStateAction<number>>;
+    addToChatQueue: (component: React.ReactNode) => void;
+    getMessageTokens: (message: Message) => number;
+    updateMessages: (newMessages: Message[]) => void;
+    resetToolConfirmationState: () => void;
+};
+//# sourceMappingURL=useAppState.d.ts.map

package/dist/app/hooks/useAppState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAppState.d.ts","sourceRoot":"","sources":["../../../source/app/hooks/useAppState.tsx"],"names":[],"mappings":"AACA,OAAO,EAAC,SAAS,EAAE,OAAO,EAAE,YAAY,EAAC,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAC,WAAW,EAAC,MAAM,6BAA6B,CAAC;AACxD,OAAO,EAAC,mBAAmB,EAAC,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAC,qBAAqB,EAAC,MAAM,mCAAmC,CAAC;AAGxE,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,WAAW,aAAa;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IACnC,eAAe,EAAE,OAAO,EAAE,CAAC;IAC3B,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC;CACvB;AAED,wBAAgB,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAmDqB,KAAK,CAAC,SAAS;gCAmBf,OAAO;kCAaL,OAAO,EAAE;;EA6F1D"}