gencode-ai 0.1.0 → 0.1.1

package/docs/providers.md

@@ -0,0 +1,220 @@
+# Providers
+
+GenCode supports multiple LLM providers and Search providers. Use the `/provider` command to manage all provider connections.
+
+## LLM Providers
+
+### Anthropic (Claude)
+
+Claude models from Anthropic with multiple connection options:
+
+| Connection Method | Environment Variables | Description |
+|-------------------|----------------------|-------------|
+| API Key | `ANTHROPIC_API_KEY` | Direct API access |
+| Google Vertex AI | `ANTHROPIC_VERTEX_PROJECT_ID` or `GOOGLE_CLOUD_PROJECT` | Claude via GCP |
+| Amazon Bedrock | `AWS_ACCESS_KEY_ID` or `AWS_PROFILE` | Claude via AWS (coming soon) |
+
+### OpenAI
+
+GPT models from OpenAI:
+
+| Connection Method | Environment Variables | Description |
+|-------------------|----------------------|-------------|
+| API Key | `OPENAI_API_KEY` | Direct API access |
+
+### Google Gemini
+
+Gemini models from Google:
+
+| Connection Method | Environment Variables | Description |
+|-------------------|----------------------|-------------|
+| API Key | `GOOGLE_API_KEY` or `GEMINI_API_KEY` | Direct API access |
+
+## Search Providers
+
+GenCode includes a WebSearch tool that can search the web for current information. Multiple search providers are supported:
+
+### Exa AI (Default)
+
+AI-native search engine using Exa's public MCP endpoint. Works out of the box without any configuration.
+
+| Connection Method | Environment Variables | Description |
+|-------------------|----------------------|-------------|
+| Public MCP | (none required) | Uses public `mcp.exa.ai` endpoint |
+
+**Features:**
+- No configuration required - works immediately
+- AI-optimized search results
+- Live crawl support for fresh content
+
+**Note:** Uses Exa's public MCP endpoint. For heavy usage, consider using Serper or Brave with your own API key.
+
+### Serper.dev
+
+Google Search results via Serper API.
+
+| Connection Method | Environment Variables | Description |
+|-------------------|----------------------|-------------|
+| API Key | `SERPER_API_KEY` | Google Search via Serper |
+
+**Features:**
+- 2,500 free queries (no credit card required)
+- Google Search quality results
+- Fast response times
+
+**Get API Key:** https://serper.dev
+
+### Brave Search
+
+Privacy-focused search from Brave.
+
+| Connection Method | Environment Variables | Description |
+|-------------------|----------------------|-------------|
+| API Key | `BRAVE_API_KEY` | Privacy-focused search |
+
+**Features:**
+- 2,000 free queries per month
+- Privacy-first approach
+- Independent search index
+
+**Get API Key:** https://brave.com/search/api
+
+### Search Provider Priority
+
+When multiple search providers are configured, the priority is:
+
+1. **Configured in `/provider`** - Explicitly selected provider
+2. **Environment variables** - `SERPER_API_KEY` > `BRAVE_API_KEY`
+3. **Default** - Exa AI (no configuration needed)
+
+## Commands
+
+### `/provider` - Provider Management
+
+Opens the provider management interface with two tabs:
+
+**[L] LLM Providers Tab:**
+- View connected and available LLM providers
+- Connect to new providers
+- Refresh model lists for connected providers
+- Remove provider connections
+
+**[S] Search Providers Tab:**
+- View available search providers
+- Select which search provider to use for WebSearch
+- See configuration status (configured/not configured)
+
+**Keyboard shortcuts:**
+- `Tab` or `L`/`S` - Switch between tabs
+- `↑↓` - Navigate between providers
+- `Enter` - Connect/Select provider
+- `r` - Remove a connected LLM provider
+- `Esc` - Exit
+
+### `/model` - Model Selection
+
+Opens the model selector to switch between models from all connected providers:
+
+- Models are grouped by provider
+- Shows cached models (fast, no API call)
+- Supports fuzzy search filtering
+
+**Keyboard shortcuts:**
+- `↑↓` - Navigate between models
+- `Enter` - Select model
+- `Esc` - Cancel
+
+## Google Vertex AI Setup
+
+To use Claude models via Google Vertex AI:
+
+### 1. Set Environment Variables
+
+```bash
+# Required: Your GCP project ID
+export ANTHROPIC_VERTEX_PROJECT_ID="your-project-id"
+
+# Optional: Region (defaults to us-east5)
+export ANTHROPIC_VERTEX_REGION="us-east5"
+```
+
+Alternative variables also supported:
+- `GOOGLE_CLOUD_PROJECT` - GCP project ID
+- `CLOUD_ML_REGION` - GCP region
+
+### 2. Authenticate with Google Cloud
+
+```bash
+# Login and set up Application Default Credentials
+gcloud auth application-default login
+
+# Verify authentication
+gcloud auth application-default print-access-token
+```
+
+### 3. Enable Vertex AI API
+
+Ensure the Vertex AI API is enabled in your GCP project:
+
+```bash
+gcloud services enable aiplatform.googleapis.com
+```
+
+### 4. Connect in GenCode
+
+```
+/provider
+# Select "Anthropic"
+# Choose "Google Vertex AI" connection method
+# Press Enter to connect
+```
+
+## Configuration Storage
+
+Provider connections and cached models are stored in:
+
+```
+~/.gencode/
+├── settings.json      # Current model and provider settings
+└── providers.json     # Provider connections and model cache
+```
+
+### providers.json Structure
+
+```json
+{
+  "connections": {
+    "anthropic": {
+      "method": "vertex",
+      "connectedAt": "2025-01-15T10:00:00Z"
+    }
+  },
+  "models": {
+    "anthropic": {
+      "cachedAt": "2025-01-15T10:00:00Z",
+      "list": [
+        { "id": "claude-sonnet-4-5@20250929", "name": "Claude Sonnet 4.5" }
+      ]
+    }
+  },
+  "searchProvider": "exa"
+}
+```
+
+The `searchProvider` field stores the selected search provider. Valid values: `exa`, `serper`, `brave`. If not set, defaults to `exa`.
+
+## Troubleshooting
+
+### "Not configured" status
+
+If a provider shows "(not configured)", set the required environment variables and restart GenCode.
+
+### Model list is empty
+
+Use `/provider` and press Enter on a connected provider to refresh the model cache.
+
+### Vertex AI authentication errors
+
+1. Verify you're logged in: `gcloud auth application-default print-access-token`
+2. Check project ID: `echo $ANTHROPIC_VERTEX_PROJECT_ID`
+3. Ensure Vertex AI API is enabled in your project

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gencode-ai",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "GenCode - An open-source, provider-agnostic AI coding assistant",
   "type": "module",
   "main": "dist/index.js",
@@ -11,7 +11,8 @@
   "scripts": {
     "build": "tsc",
     "dev": "tsc --watch",
-    "start": "npx tsx src/cli/index.tsx",
+    "start": "node dist/cli/index.js",
+    "start:dev": "npx tsx src/cli/index.tsx",
     "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js",
     "example": "npx tsx examples/basic.ts"
   },
@@ -28,16 +29,20 @@
   "dependencies": {
     "@anthropic-ai/sdk": "^0.71.2",
     "@google/generative-ai": "^0.24.1",
+    "@types/turndown": "^5.0.6",
     "chalk": "^5.6.2",
     "dotenv": "^17.2.3",
     "fast-glob": "^3.3.3",
     "glob": "^13.0.0",
+    "google-auth-library": "^10.5.0",
     "ink": "^6.6.0",
     "ink-spinner": "^5.0.0",
     "ink-text-input": "^6.0.0",
+    "marked": "^17.0.1",
     "openai": "^6.16.0",
     "ora": "^9.0.0",
     "react": "^19.2.3",
+    "turndown": "^7.2.2",
     "undici": "^7.18.2",
     "zod": "^4.3.5"
   },

package/src/agent/agent.ts

@@ -3,7 +3,7 @@
  */
 
 import type { LLMProvider, Message, ToolResultContent } from '../providers/types.js';
-import { createProvider } from '../providers/index.js';
+import { createProvider, inferProvider } from '../providers/index.js';
 import { ToolRegistry, createDefaultRegistry } from '../tools/index.js';
 import { PermissionManager } from '../permissions/index.js';
 import { SessionManager } from '../session/index.js';
@@ -64,10 +64,17 @@ export class Agent {
   }
 
   /**
-   * Set the model to use
+   * Set the model to use (auto-switches provider if needed)
    */
   setModel(model: string): void {
     this.config.model = model;
+
+    // Auto-switch provider based on model name
+    const newProvider = inferProvider(model);
+    if (newProvider !== this.config.provider) {
+      this.config.provider = newProvider;
+      this.provider = createProvider({ provider: newProvider });
+    }
   }
 
   /**

package/src/agent/types.ts

@@ -5,7 +5,7 @@
 import type { PermissionConfig } from '../permissions/types.js';
 
 export interface AgentConfig {
-  provider: 'openai' | 'anthropic' | 'gemini';
+  provider: 'openai' | 'anthropic' | 'gemini' | 'vertex-ai';
   model: string;
   systemPrompt?: string;
   tools?: string[];
@@ -35,6 +35,14 @@ export interface AgentEventToolResult {
     success: boolean;
     output: string;
     error?: string;
+    metadata?: {
+      title?: string;
+      subtitle?: string;
+      size?: number;
+      statusCode?: number;
+      contentType?: string;
+      duration?: number;
+    };
   };
 }
 

package/src/cli/components/App.tsx

@@ -11,6 +11,7 @@ import {
   AssistantMessage,
   ToolCall,
   ToolResult,
+  PendingToolCall,
   InfoMessage,
   WelcomeMessage,
   CompletionMessage,
@@ -19,8 +20,10 @@ import { Header } from './Header.js';
 import { ProgressBar } from './Spinner.js';
 import { PromptInput, ConfirmPrompt } from './Input.js';
 import { ModelSelector } from './ModelSelector.js';
+import { ProviderManager } from './ProviderManager.js';
 import { CommandSuggestions, getFilteredCommands } from './CommandSuggestions.js';
 import { colors, icons } from './theme.js';
+import type { ProviderName } from '../../providers/index.js';
 
 // Types
 interface HistoryItem {
@@ -60,12 +63,28 @@ function useAgent(config: AgentConfig) {
   return agent;
 }
 
+// ============================================================================
+// Utils
+// ============================================================================
+const genId = () => Math.random().toString(36).slice(2);
+
+const formatRelativeTime = (dateStr: string) => {
+  const diff = Date.now() - new Date(dateStr).getTime();
+  const mins = Math.floor(diff / 60000);
+  const hrs = Math.floor(mins / 60);
+  const days = Math.floor(hrs / 24);
+  if (mins < 60) return `${mins}m`;
+  if (hrs < 24) return `${hrs}h`;
+  return `${days}d`;
+};
+
 // ============================================================================
 // Help Component
 // ============================================================================
 function HelpPanel() {
   const commands: [string, string][] = [
     ['/model [name]', 'Switch model'],
+    ['/provider', 'Manage providers'],
     ['/sessions', 'List sessions'],
     ['/resume [n]', 'Resume session'],
     ['/new', 'New session'],
@@ -92,16 +111,6 @@ interface SessionsTableProps {
 }
 
 function SessionsTable({ sessions }: SessionsTableProps) {
-  const formatTime = (dateStr: string) => {
-    const diff = Date.now() - new Date(dateStr).getTime();
-    const mins = Math.floor(diff / 60000);
-    const hrs = Math.floor(mins / 60);
-    const days = Math.floor(hrs / 24);
-    if (mins < 60) return `${mins}m`;
-    if (hrs < 24) return `${hrs}h`;
-    return `${days}d`;
-  };
-
   return (
     <Box flexDirection="column">
       {sessions.slice(0, 6).map((s, i) => (
@@ -109,7 +118,7 @@ function SessionsTable({ sessions }: SessionsTableProps) {
           <Text color={colors.textMuted}>{String(i + 1).padEnd(2)}</Text>
           <Text color={colors.primary}>{s.id.slice(0, 7).padEnd(8)}</Text>
           <Text>{s.title.slice(0, 25).padEnd(26)}</Text>
-          <Text color={colors.textMuted}>{formatTime(s.updatedAt)}</Text>
+          <Text color={colors.textMuted}>{formatRelativeTime(s.updatedAt)}</Text>
         </Text>
       ))}
     </Box>
@@ -123,9 +132,6 @@ export function App({ config, settingsManager, resumeLatest }: AppProps) {
   const { exit } = useApp();
   const agent = useAgent(config);
 
-  // Generate unique ID
-  const genId = () => Math.random().toString(36).slice(2);
-
   // Initial header item
   const cwd = config.cwd || process.cwd();
   const home = process.env.HOME || '';
@@ -156,9 +162,12 @@ export function App({ config, settingsManager, resumeLatest }: AppProps) {
   const streamingTextRef = useRef(''); // Track current streaming text for closure
   const [confirmState, setConfirmState] = useState<ConfirmState | null>(null);
   const [showModelSelector, setShowModelSelector] = useState(false);
+  const [showProviderManager, setShowProviderManager] = useState(false);
   const [currentModel, setCurrentModel] = useState(config.model);
   const [cmdSuggestionIndex, setCmdSuggestionIndex] = useState(0);
   const [inputKey, setInputKey] = useState(0); // Force cursor to end after autocomplete
+  const [pendingTool, setPendingTool] = useState<{ name: string; input: Record<string, unknown> } | null>(null);
+  const pendingToolRef = useRef<{ name: string; input: Record<string, unknown> } | null>(null);
 
   // Check if showing command suggestions
   const showCmdSuggestions = input.startsWith('/') && !isProcessing;
@@ -202,11 +211,16 @@ export function App({ config, settingsManager, resumeLatest }: AppProps) {
   };
 
   // Handle model selection
-  const handleModelSelect = async (model: string) => {
+  const handleModelSelect = async (model: string, providerId?: ProviderName) => {
     agent.setModel(model);
     setCurrentModel(model);
     setShowModelSelector(false);
-    addHistory({ type: 'info', content: `Model: ${model}` });
+
+    if (providerId) {
+      addHistory({ type: 'info', content: `${providerId}: ${model}` });
+    } else {
+      addHistory({ type: 'info', content: `Model: ${model}` });
+    }
 
     // Save to settings for next startup
     if (settingsManager) {
@@ -302,6 +316,11 @@ export function App({ config, settingsManager, resumeLatest }: AppProps) {
         return true;
       }
 
+      case 'provider': {
+        setShowProviderManager(true);
+        return true;
+      }
+
       case 'init': {
         addHistory({ type: 'info', content: '/init command not available in this version' });
         return true;
@@ -350,19 +369,33 @@ export function App({ config, settingsManager, resumeLatest }: AppProps) {
               streamingTextRef.current = '';
               setStreamingText('');
             }
-            addHistory({
-              type: 'tool_call',
-              content: event.name,
-              meta: { toolName: event.name, input: event.input },
-            });
+            // Set pending tool for spinner animation (use both state and ref)
+            const toolInfo = { name: event.name, input: event.input as Record<string, unknown> };
+            pendingToolRef.current = toolInfo;
+            setPendingTool(toolInfo);
             break;
 
           case 'tool_result':
+            // Add tool_call to history (now completed) - use ref for correct value
+            if (pendingToolRef.current) {
+              addHistory({
+                type: 'tool_call',
+                content: pendingToolRef.current.name,
+                meta: { toolName: pendingToolRef.current.name, input: pendingToolRef.current.input },
+              });
+            }
+            // Add tool_result to history
             addHistory({
               type: 'tool_result',
               content: event.result.output,
-              meta: { toolName: event.name, success: event.result.success },
+              meta: {
+                toolName: event.name,
+                success: event.result.success,
+                metadata: event.result.metadata,
+              },
             });
+            pendingToolRef.current = null;
+            setPendingTool(null);
             setIsThinking(true);
             break;
 
@@ -496,6 +529,7 @@ export function App({ config, settingsManager, resumeLatest }: AppProps) {
             name={(item.meta?.toolName as string) || ''}
             success={(item.meta?.success as boolean) ?? true}
             output={item.content}
+            metadata={item.meta?.metadata as Record<string, unknown> | undefined}
           />
         );
       case 'info':
@@ -517,6 +551,8 @@ export function App({ config, settingsManager, resumeLatest }: AppProps) {
         {(item) => <Box key={item.id}>{renderHistoryItem(item)}</Box>}
       </Static>
 
+      {pendingTool && <PendingToolCall name={pendingTool.name} input={pendingTool.input} />}
+
       {streamingText && <AssistantMessage text={streamingText} streaming />}
 
       {confirmState && (
@@ -539,7 +575,20 @@ export function App({ config, settingsManager, resumeLatest }: AppProps) {
         </Box>
       )}
 
-      {!confirmState && !showModelSelector && (
+      {showProviderManager && (
+        <Box marginTop={1}>
+          <ProviderManager
+            onClose={() => setShowProviderManager(false)}
+            onProviderChange={(providerId, model) => {
+              agent.setModel(model);
+              setCurrentModel(model);
+              addHistory({ type: 'info', content: `Switched to ${providerId}: ${model}` });
+            }}
+          />
+        </Box>
+      )}
+
+      {!confirmState && !showModelSelector && !showProviderManager && (
         <Box flexDirection="column" marginTop={1}>
           <PromptInput
             key={inputKey}

package/src/cli/components/CommandSuggestions.tsx

@@ -8,6 +8,7 @@ interface Command {
 
 export const COMMANDS: Command[] = [
   { name: '/model', description: 'Switch model' },
+  { name: '/provider', description: 'Manage providers' },
   { name: '/sessions', description: 'List sessions' },
   { name: '/resume', description: 'Resume session' },
   { name: '/new', description: 'New session' },