@compilr-dev/cli 0.4.0 → 0.5.1

package/dist/utils/credentials.d.ts

@@ -6,11 +6,16 @@
  * - Machine-specific identifiers (hostname, username)
  * - A random "mk" value stored in settings.json
  */
-export type ProviderKey = 'anthropic' | 'openai' | 'google' | 'ollama';
+export type ProviderKey = 'anthropic' | 'openai' | 'google' | 'ollama' | 'together' | 'groq' | 'fireworks' | 'perplexity' | 'openrouter';
 export interface StoredCredentials {
     anthropic?: string;
     openai?: string;
     google?: string;
+    together?: string;
+    groq?: string;
+    fireworks?: string;
+    perplexity?: string;
+    openrouter?: string;
 }
 /**
  * Get API key for a provider
@@ -39,17 +44,31 @@ export declare function getMaskedKey(provider: ProviderKey): string | null;
  */
 export declare function isKeyFromEnv(provider: ProviderKey): boolean;
 /**
- * Get all provider statuses
+ * Provider category for grouping in UI
+ */
+export type ProviderCategory = 'primary' | 'local' | 'others';
+/**
+ * Provider status with category information
  */
-export declare function getAllProviderStatuses(): Array<{
+export interface ProviderStatus {
     provider: ProviderKey;
     name: string;
     hasKey: boolean;
     masked: string | null;
     fromEnv: boolean;
     keyUrl: string;
-}>;
+    category: ProviderCategory;
+    endpoint?: string;
+}
+/**
+ * Get all provider statuses
+ */
+export declare function getAllProviderStatuses(): ProviderStatus[];
+/**
+ * Get provider statuses filtered by category
+ */
+export declare function getProvidersByCategory(category: ProviderCategory): ProviderStatus[];
 /**
  * Map provider type from settings to credential provider key
  */
-export declare function settingsProviderToCredentialKey(provider: 'auto' | 'claude' | 'openai' | 'gemini' | 'ollama'): ProviderKey;
+export declare function settingsProviderToCredentialKey(provider: 'auto' | 'claude' | 'openai' | 'gemini' | 'ollama' | 'together' | 'groq' | 'fireworks' | 'perplexity' | 'openrouter' | 'custom'): ProviderKey;

package/dist/utils/credentials.js

@@ -18,6 +18,8 @@ const SETTINGS_FILE = path.join(CONFIG_DIR, 'settings.json');
 const CREDENTIALS_FILE = path.join(CONFIG_DIR, 'credentials.enc');
 const ALGORITHM = 'aes-256-gcm';
 const SALT = 'compilr-dev-v1';
+// Cache for loaded credentials (avoids repeated disk reads)
+let credentialsCache = null;
 // =============================================================================
 // Master Key Management
 // =============================================================================
@@ -98,29 +100,38 @@ function decrypt(encryptedData) {
 // Credentials Storage
 // =============================================================================
 /**
- * Load all stored credentials
+ * Load all stored credentials (cached to avoid repeated disk reads)
  */
 function loadCredentials() {
+    // Return cached credentials if available
+    if (credentialsCache !== null) {
+        return credentialsCache;
+    }
     try {
         if (!fs.existsSync(CREDENTIALS_FILE)) {
-            return {};
+            credentialsCache = {};
+            return credentialsCache;
         }
         const encryptedData = fs.readFileSync(CREDENTIALS_FILE, 'utf-8');
         const decrypted = decrypt(encryptedData);
-        return JSON.parse(decrypted);
+        credentialsCache = JSON.parse(decrypted);
+        return credentialsCache;
     }
     catch {
         // If decryption fails (e.g., key changed), return empty
-        return {};
+        credentialsCache = {};
+        return credentialsCache;
     }
 }
 /**
- * Save all credentials
+ * Save all credentials (invalidates cache)
  */
 function saveCredentials(credentials) {
     fs.mkdirSync(CONFIG_DIR, { recursive: true });
     const encrypted = encrypt(JSON.stringify(credentials));
     fs.writeFileSync(CREDENTIALS_FILE, encrypted, 'utf-8');
+    // Update cache with new credentials
+    credentialsCache = credentials;
 }
 // =============================================================================
 // Public API
@@ -136,6 +147,11 @@ export function getApiKey(provider) {
         openai: 'OPENAI_API_KEY',
         google: 'GOOGLE_API_KEY',
         ollama: '', // No key needed
+        together: 'TOGETHER_API_KEY',
+        groq: 'GROQ_API_KEY',
+        fireworks: 'FIREWORKS_API_KEY',
+        perplexity: 'PERPLEXITY_API_KEY',
+        openrouter: 'OPENROUTER_API_KEY',
     };
     const envVar = envVarMap[provider];
     if (envVar && process.env[envVar]) {
@@ -164,16 +180,33 @@ export function setApiKey(provider, key) {
  */
 export function deleteApiKey(provider) {
     const credentials = loadCredentials();
-    // Remove the key by setting to undefined and then filtering
+    // Remove the key by setting to undefined
+    // Ollama doesn't have a key to delete
     if (provider === 'anthropic') {
-        delete credentials.anthropic;
+        credentials.anthropic = undefined;
     }
     else if (provider === 'openai') {
-        delete credentials.openai;
+        credentials.openai = undefined;
     }
     else if (provider === 'google') {
-        delete credentials.google;
+        credentials.google = undefined;
+    }
+    else if (provider === 'together') {
+        credentials.together = undefined;
+    }
+    else if (provider === 'groq') {
+        credentials.groq = undefined;
+    }
+    else if (provider === 'fireworks') {
+        credentials.fireworks = undefined;
+    }
+    else if (provider === 'perplexity') {
+        credentials.perplexity = undefined;
     }
+    else if (provider === 'openrouter') {
+        credentials.openrouter = undefined;
+    }
+    // Note: ollama doesn't have a key to delete
     saveCredentials(credentials);
 }
 /**
@@ -205,6 +238,11 @@ export function isKeyFromEnv(provider) {
         openai: 'OPENAI_API_KEY',
         google: 'GOOGLE_API_KEY',
         ollama: '',
+        together: 'TOGETHER_API_KEY',
+        groq: 'GROQ_API_KEY',
+        fireworks: 'FIREWORKS_API_KEY',
+        perplexity: 'PERPLEXITY_API_KEY',
+        openrouter: 'OPENROUTER_API_KEY',
     };
     const envVar = envVarMap[provider];
     return !!(envVar && process.env[envVar]);
@@ -214,6 +252,7 @@ export function isKeyFromEnv(provider) {
  */
 export function getAllProviderStatuses() {
     return [
+        // Primary providers (main tabs)
         {
             provider: 'anthropic',
             name: 'Anthropic (Claude)',
@@ -221,6 +260,7 @@ export function getAllProviderStatuses() {
             masked: getMaskedKey('anthropic'),
             fromEnv: isKeyFromEnv('anthropic'),
             keyUrl: 'https://console.anthropic.com/settings/keys',
+            category: 'primary',
         },
         {
             provider: 'openai',
@@ -229,6 +269,7 @@ export function getAllProviderStatuses() {
             masked: getMaskedKey('openai'),
             fromEnv: isKeyFromEnv('openai'),
             keyUrl: 'https://platform.openai.com/api-keys',
+            category: 'primary',
         },
         {
             provider: 'google',
@@ -237,7 +278,9 @@ export function getAllProviderStatuses() {
             masked: getMaskedKey('google'),
             fromEnv: isKeyFromEnv('google'),
             keyUrl: 'https://aistudio.google.com/apikey',
+            category: 'primary',
         },
+        // Local provider
         {
             provider: 'ollama',
             name: 'Ollama (Local)',
@@ -245,9 +288,67 @@ export function getAllProviderStatuses() {
             masked: 'local',
             fromEnv: false,
             keyUrl: 'https://ollama.ai',
+            category: 'local',
+        },
+        // "Others" providers (OpenAI-compatible cloud APIs)
+        {
+            provider: 'together',
+            name: 'Together AI',
+            hasKey: hasApiKey('together'),
+            masked: getMaskedKey('together'),
+            fromEnv: isKeyFromEnv('together'),
+            keyUrl: 'https://api.together.xyz/settings/api-keys',
+            category: 'others',
+            endpoint: 'https://api.together.xyz/v1',
+        },
+        {
+            provider: 'groq',
+            name: 'Groq',
+            hasKey: hasApiKey('groq'),
+            masked: getMaskedKey('groq'),
+            fromEnv: isKeyFromEnv('groq'),
+            keyUrl: 'https://console.groq.com/keys',
+            category: 'others',
+            endpoint: 'https://api.groq.com/openai/v1',
+        },
+        {
+            provider: 'fireworks',
+            name: 'Fireworks AI',
+            hasKey: hasApiKey('fireworks'),
+            masked: getMaskedKey('fireworks'),
+            fromEnv: isKeyFromEnv('fireworks'),
+            keyUrl: 'https://fireworks.ai/account/api-keys',
+            category: 'others',
+            endpoint: 'https://api.fireworks.ai/inference/v1',
+        },
+        {
+            provider: 'perplexity',
+            name: 'Perplexity',
+            hasKey: hasApiKey('perplexity'),
+            masked: getMaskedKey('perplexity'),
+            fromEnv: isKeyFromEnv('perplexity'),
+            keyUrl: 'https://www.perplexity.ai/settings/api',
+            category: 'others',
+            endpoint: 'https://api.perplexity.ai',
+        },
+        {
+            provider: 'openrouter',
+            name: 'OpenRouter',
+            hasKey: hasApiKey('openrouter'),
+            masked: getMaskedKey('openrouter'),
+            fromEnv: isKeyFromEnv('openrouter'),
+            keyUrl: 'https://openrouter.ai/keys',
+            category: 'others',
+            endpoint: 'https://openrouter.ai/api/v1',
         },
     ];
 }
+/**
+ * Get provider statuses filtered by category
+ */
+export function getProvidersByCategory(category) {
+    return getAllProviderStatuses().filter(p => p.category === category);
+}
 /**
  * Map provider type from settings to credential provider key
  */
@@ -261,6 +362,19 @@ export function settingsProviderToCredentialKey(provider) {
             return 'openai';
         case 'ollama':
             return 'ollama';
+        case 'together':
+            return 'together';
+        case 'groq':
+            return 'groq';
+        case 'fireworks':
+            return 'fireworks';
+        case 'perplexity':
+            return 'perplexity';
+        case 'openrouter':
+            return 'openrouter';
+        case 'custom':
+            // Custom provider might use any key; default to openai (most common format)
+            return 'openai';
         case 'auto':
         default:
             return 'anthropic'; // Default to anthropic for auto

package/dist/utils/debug-log.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Debug Logger
+ *
+ * Writes timestamped logs to a file for debugging timing issues.
+ * Usage: import { debugLog } from './utils/debug-log.js';
+ *        debugLog('event-name', 'description');
+ *
+ * For rendering debug: set DEBUG_RENDERING=1 environment variable
+ * Usage: DEBUG_RENDERING=1 compilr
+ *        Then: tail -f /tmp/compilr-debug.log
+ */
+export declare const DEBUG_RENDERING: boolean;
+/**
+ * Log a debug message with timestamp
+ */
+export declare function debugLog(event: string, details?: string): void;
+/**
+ * Clear the log file
+ */
+export declare function clearDebugLog(): void;
+/**
+ * Get the log file path
+ */
+export declare function getDebugLogPath(): string;
+/**
+ * Log rendering-specific debug info (only if DEBUG_RENDERING=1)
+ */
+export declare function debugRender(component: string, details: string): void;

package/dist/utils/debug-log.js

@@ -0,0 +1,57 @@
+/**
+ * Debug Logger
+ *
+ * Writes timestamped logs to a file for debugging timing issues.
+ * Usage: import { debugLog } from './utils/debug-log.js';
+ *        debugLog('event-name', 'description');
+ *
+ * For rendering debug: set DEBUG_RENDERING=1 environment variable
+ * Usage: DEBUG_RENDERING=1 compilr
+ *        Then: tail -f /tmp/compilr-debug.log
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+const LOG_FILE = path.join(os.tmpdir(), 'compilr-debug.log');
+const startTime = Date.now();
+// Check if rendering debug is enabled via environment variable
+export const DEBUG_RENDERING = process.env['DEBUG_RENDERING'] === '1';
+/**
+ * Log a debug message with timestamp
+ */
+export function debugLog(event, details) {
+    const elapsed = Date.now() - startTime;
+    const timestamp = new Date().toISOString();
+    const line = `[${timestamp}] +${String(elapsed)}ms | ${event}${details ? ` | ${details}` : ''}\n`;
+    try {
+        fs.appendFileSync(LOG_FILE, line);
+    }
+    catch {
+        // Ignore errors
+    }
+}
+/**
+ * Clear the log file
+ */
+export function clearDebugLog() {
+    try {
+        fs.writeFileSync(LOG_FILE, `=== Debug Log Started ${new Date().toISOString()} ===\n`);
+    }
+    catch {
+        // Ignore errors
+    }
+}
+/**
+ * Get the log file path
+ */
+export function getDebugLogPath() {
+    return LOG_FILE;
+}
+/**
+ * Log rendering-specific debug info (only if DEBUG_RENDERING=1)
+ */
+export function debugRender(component, details) {
+    if (!DEBUG_RENDERING)
+        return;
+    debugLog(`[RENDER:${component}]`, details);
+}

package/dist/utils/format-tokens.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Format Tokens Utility
+ *
+ * Extracted from ui/base/render-utils.ts so foundation-layer code
+ * (token-tracker) can use it without importing from the domain layer.
+ */
+/**
+ * Format a token count in a human-readable way.
+ *
+ * @param tokens - Number of tokens
+ * @returns Formatted string (e.g., "1.5k" for 1500)
+ */
+export declare function formatTokens(tokens: number): string;

package/dist/utils/format-tokens.js

@@ -0,0 +1,18 @@
+/**
+ * Format Tokens Utility
+ *
+ * Extracted from ui/base/render-utils.ts so foundation-layer code
+ * (token-tracker) can use it without importing from the domain layer.
+ */
+/**
+ * Format a token count in a human-readable way.
+ *
+ * @param tokens - Number of tokens
+ * @returns Formatted string (e.g., "1.5k" for 1500)
+ */
+export function formatTokens(tokens) {
+    if (tokens >= 1000) {
+        return `${(tokens / 1000).toFixed(1)}k`;
+    }
+    return String(tokens);
+}

package/dist/utils/git-config.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Git Config Utilities
+ *
+ * Shared helpers for reading/writing git global config values.
+ * Used by onboarding wizard and new project overlay.
+ */
+export interface GitConfig {
+    userName: string | null;
+    userEmail: string | null;
+    hasName: boolean;
+    hasEmail: boolean;
+    /** True when both user.name and user.email are set */
+    isConfigured: boolean;
+}
+/**
+ * Get a single git global config value, returns null if not set.
+ */
+export declare function getGitConfigValue(key: string): string | null;
+/**
+ * Set a git global config value. Returns true on success.
+ */
+export declare function setGitConfigValue(key: string, value: string): boolean;
+/**
+ * Check git user.name and user.email configuration status.
+ */
+export declare function checkGitConfig(): GitConfig;

package/dist/utils/git-config.js

@@ -0,0 +1,54 @@
+/**
+ * Git Config Utilities
+ *
+ * Shared helpers for reading/writing git global config values.
+ * Used by onboarding wizard and new project overlay.
+ */
+import { execSync } from 'child_process';
+// =============================================================================
+// Functions
+// =============================================================================
+/**
+ * Get a single git global config value, returns null if not set.
+ */
+export function getGitConfigValue(key) {
+    try {
+        const value = execSync(`git config --global ${key}`, {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        return value || null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Set a git global config value. Returns true on success.
+ */
+export function setGitConfigValue(key, value) {
+    try {
+        execSync(`git config --global ${key} "${value.replace(/"/g, '\\"')}"`, {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check git user.name and user.email configuration status.
+ */
+export function checkGitConfig() {
+    const userName = getGitConfigValue('user.name');
+    const userEmail = getGitConfigValue('user.email');
+    return {
+        userName,
+        userEmail,
+        hasName: Boolean(userName),
+        hasEmail: Boolean(userEmail),
+        isConfigured: Boolean(userName && userEmail),
+    };
+}

package/dist/utils/message-utils.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Message Utilities
+ *
+ * Shared utilities for message manipulation across the codebase.
+ * This is the single source of truth for message transformation functions.
+ */
+/**
+ * Minimal interface for content blocks with a type property.
+ * This is structurally compatible with any type that has a 'type' field.
+ */
+interface TypedBlock {
+    type: string;
+}
+/**
+ * Strip thinking blocks from messages.
+ *
+ * Thinking blocks contain provider-specific signatures (e.g., Gemini's thought_signature)
+ * that don't transfer between sessions or when switching projects/models.
+ * This function removes them while preserving all other content blocks.
+ *
+ * Uses structural typing - works with any message that has a 'content' property
+ * that is either a string or an array of objects with 'type' fields.
+ *
+ * @param messages - Array of messages to process
+ * @returns New array with thinking blocks removed from each message
+ *
+ * @example
+ * ```ts
+ * const cleanedMessages = stripThinkingBlocks(session.messages);
+ * await agent.setHistory(cleanedMessages);
+ * ```
+ */
+export declare function stripThinkingBlocks<T extends {
+    content: string | TypedBlock[];
+}>(messages: T[]): T[];
+/**
+ * Message interface for text extraction functions.
+ */
+interface MessageForTextExtraction {
+    content: string | (TypedBlock & {
+        text?: string;
+    })[];
+}
+/**
+ * Extract text content from a message.
+ *
+ * Handles both string content and array content with text blocks.
+ *
+ * @param msg - Message to extract text from
+ * @returns The text content, or empty string if not found
+ */
+export declare function getMessageText(msg: MessageForTextExtraction): string;
+/**
+ * Create a truncated preview of message text.
+ *
+ * @param msg - Message to preview
+ * @param maxLength - Maximum length of preview (default: 60)
+ * @returns Truncated text with ellipsis if needed
+ */
+export declare function getMessagePreview(msg: MessageForTextExtraction, maxLength?: number): string;
+export {};

package/dist/utils/message-utils.js

@@ -0,0 +1,72 @@
+/**
+ * Message Utilities
+ *
+ * Shared utilities for message manipulation across the codebase.
+ * This is the single source of truth for message transformation functions.
+ */
+import { truncatePlain as truncate } from '@compilr-dev/ui-core/utils';
+/**
+ * Strip thinking blocks from messages.
+ *
+ * Thinking blocks contain provider-specific signatures (e.g., Gemini's thought_signature)
+ * that don't transfer between sessions or when switching projects/models.
+ * This function removes them while preserving all other content blocks.
+ *
+ * Uses structural typing - works with any message that has a 'content' property
+ * that is either a string or an array of objects with 'type' fields.
+ *
+ * @param messages - Array of messages to process
+ * @returns New array with thinking blocks removed from each message
+ *
+ * @example
+ * ```ts
+ * const cleanedMessages = stripThinkingBlocks(session.messages);
+ * await agent.setHistory(cleanedMessages);
+ * ```
+ */
+export function stripThinkingBlocks(messages) {
+    return messages.map((msg) => {
+        // String content - no thinking blocks to strip
+        if (typeof msg.content === 'string') {
+            return msg;
+        }
+        // Array content - filter out thinking blocks
+        return {
+            ...msg,
+            content: msg.content.filter((block) => block.type !== 'thinking'),
+        };
+    });
+}
+/**
+ * Extract text content from a message.
+ *
+ * Handles both string content and array content with text blocks.
+ *
+ * @param msg - Message to extract text from
+ * @returns The text content, or empty string if not found
+ */
+export function getMessageText(msg) {
+    if (typeof msg.content === 'string') {
+        return msg.content;
+    }
+    // Find the first text block
+    const textBlock = msg.content.find((b) => b.type === 'text');
+    if (textBlock && typeof textBlock.text === 'string') {
+        return textBlock.text;
+    }
+    return '';
+}
+/**
+ * Create a truncated preview of message text.
+ *
+ * @param msg - Message to preview
+ * @param maxLength - Maximum length of preview (default: 60)
+ * @returns Truncated text with ellipsis if needed
+ */
+export function getMessagePreview(msg, maxLength = 60) {
+    const text = getMessageText(msg);
+    if (text.length <= maxLength) {
+        return text;
+    }
+    return truncate(text, maxLength);
+}

package/dist/utils/model-tiers.d.ts

@@ -1,11 +1,18 @@
 /**
- * Model Tier Detection
+ * Model Tier Detection (Capability Tiers)
  *
  * Categorizes LLM models by capability tier (small/medium/large)
  * and provides upgrade suggestions within the same provider.
  *
  * Used by commands like /design to warn users about model limitations
  * and suggest alternatives.
+ *
+ * NOTE: This is SEPARATE from the model registry in src/models/model-registry.ts.
+ * - Registry: Model metadata, selection UI, speed tiers (fast/balanced/powerful)
+ * - This file: Command capability requirements (small/medium/large)
+ *
+ * When adding new models to the registry, also update this file if the model
+ * should be recognized for capability tier detection.
  */
 export type TierLevel = 'small' | 'medium' | 'large';
 export interface ModelTier {