orchid-ai 1.2.3 → 1.2.5

package/README.md

@@ -6,7 +6,7 @@ A powerful AI-powered command interface for web applications that provides conte
 
 ### **Latest AI Model Support**
 - **OpenAI**: GPT-4 Turbo, GPT-4o, GPT-4o Mini (all with image support)
-- **Claude**: Opus 4, Sonnet 4, Haiku 3.5 (latest 2025 models)
+- **Claude**: Opus 4, Sonnet 4.5, Haiku 4.5 (latest 2025 models)
 - **Gemini**: 2.5 Pro, 2.5 Flash, 2.5 Flash Lite (newest generation)
 
 ### **Provider-Specific Training Data Optimization**
@@ -154,8 +154,8 @@ export const clientConfig = {
       { id: 'gpt-4o-mini', name: 'GPT-4o Mini', supportsImages: true, computeWeight: 0.3 },
     ],
     claude: [
-      { id: 'claude-sonnet-4-20250514', name: 'Claude Sonnet 4', supportsImages: true, computeWeight: 0.6 },
-      { id: 'claude-3-5-haiku-20241022', name: 'Claude Haiku 3.5', supportsImages: true, computeWeight: 0.2 },
+      { id: 'claude-sonnet-4-5-20250929', name: 'Claude Sonnet 4.5', supportsImages: true, computeWeight: 0.6 },
+      { id: 'claude-haiku-4-5-20251001', name: 'Claude Haiku 4.5', supportsImages: true, computeWeight: 0.2 },
     ],
     gemini: [
       { id: 'gemini-2.5-flash', name: 'Gemini 2.5 Flash', supportsImages: true, computeWeight: 0.5 },

package/dist/cli/components/ChatPanel.d.ts

@@ -20,7 +20,8 @@ interface ChatPanelProps {
     models?: Record<string, ModelInfo[]>;
     defaultModel?: {
         provider: string;
-        model: string;
+        model?: string;
+        tier?: 'fast' | 'balanced' | 'powerful';
     };
     showUsageStats?: boolean;
     maxFileSize?: string;

package/dist/cli/components/Conversation.d.ts

@@ -27,7 +27,8 @@ interface ConversationProps {
     models?: Record<string, ModelInfo[]>;
     defaultModel?: {
         provider: string;
-        model: string;
+        model?: string;
+        tier?: 'fast' | 'balanced' | 'powerful';
     };
     showUsageStats?: boolean;
     maxFileSize?: string;

package/dist/cli/components/ModelSwitcher.d.ts

@@ -4,7 +4,8 @@ interface ModelSwitcherProps {
     models?: Record<string, ModelInfo[]>;
     defaultModel?: {
         provider: string;
-        model: string;
+        model?: string;
+        tier?: 'fast' | 'balanced' | 'powerful';
     };
     showUsageStats?: boolean;
     theme?: ChatTheme;

package/dist/cli/hooks/useModelSwitcher.d.ts

@@ -1,4 +1,4 @@
-import { ModelInfo } from '../types/types';
+import { ModelInfo, ServerConfig } from '../types/types';
 interface CurrentModel {
     provider: string;
     model: string;
@@ -25,16 +25,19 @@ interface UsageStats {
 interface UseModelSwitcherOptions {
     initialProvider?: string;
     initialModel?: string;
+    initialTier?: 'fast' | 'balanced' | 'powerful';
     customModels?: Record<string, ModelInfo[]>;
+    serverConfig?: ServerConfig;
 }
-export declare function useModelSwitcher({ initialProvider, initialModel, customModels, }?: UseModelSwitcherOptions): {
+export declare function useModelSwitcher({ initialProvider, initialModel, initialTier, // Can be undefined - don't default here, let Conversation handle it
+customModels, serverConfig, }?: UseModelSwitcherOptions): {
     models: ModelInfo[];
     modelsByProvider: Record<string, ModelInfo[]>;
     currentModel: CurrentModel;
     currentCapabilities: ModelCapabilities;
     usageStats: UsageStats;
     isLoading: boolean;
-    error: null;
+    error: string | null;
     switchModel: (model: string, provider?: string) => {
         success: boolean;
         current: {
@@ -48,7 +51,7 @@ export declare function useModelSwitcher({ initialProvider, initialModel, custom
         provider: string;
         model: string;
         capabilities: ModelCapabilities;
-    };
+    } | null;
     modelState: {
         models: ModelInfo[];
         current: CurrentModel;

package/dist/cli/hooks/useResolvedDefaultModel.d.ts

@@ -0,0 +1,21 @@
+import type { ModelCapabilities } from '../types/types';
+/**
+ * Hook to resolve tier-based default model config to actual model
+ *
+ * This hook takes a default model configuration that may include a tier
+ * (like 'fast', 'balanced', 'powerful') and resolves it to an actual model
+ * by fetching the available models from the server and selecting the best
+ * match for the provider and tier combination.
+ *
+ * @param defaultModel - The model configuration to resolve
+ * @returns The resolved model with provider, model name, and capabilities
+ */
+export declare function useResolvedDefaultModel(defaultModel?: {
+    provider: string;
+    model?: string;
+    tier?: 'fast' | 'balanced' | 'powerful';
+}): {
+    provider: string;
+    model: string;
+    capabilities: ModelCapabilities;
+} | undefined;

package/dist/cli/hooks/useStreamingAI.d.ts

@@ -1,8 +1,9 @@
 import { ChatMessage, ModelCapabilities, ServerConfig } from '../types/types';
 interface ModelSelection {
     provider: string;
-    model: string;
-    capabilities: ModelCapabilities;
+    model?: string;
+    tier?: 'fast' | 'balanced' | 'powerful';
+    capabilities?: ModelCapabilities;
 }
 export declare function useStreamingAI({ userId, serverConfig, formData, chats: externalChats, setChats: externalSetChats, currentChatId: externalCurrentChatId, setCurrentChatId: externalSetCurrentChatId, modelSelection, onUsageTracked, chatLevel, additionalContext, verbose, }: {
     userId: string;

package/dist/cli/index.d.ts

@@ -1,5 +1,6 @@
 export { useStreamingAI } from './hooks/useStreamingAI';
 export { useSuggestions, useDebouncedSuggestions, } from './hooks/useSuggestions';
+export { useResolvedDefaultModel } from './hooks/useResolvedDefaultModel';
 export { ChatPanel } from './components/ChatPanel';
 export { Conversation } from './components/Conversation';
 export { SuggestionsPanel, SuggestionCard, } from './components/SuggestionsPanel';

package/dist/cli/server/contextual-service.d.ts

@@ -1,9 +1,20 @@
 import type { ContextualServiceConfig, ContextualRequest } from '../types/types.js';
 export declare class ContextualCommandService {
     private config;
+    private modelsCache;
+    private cacheFilePath;
+    private readonly CACHE_TTL_MS;
     private verboseLogging;
     private usage;
     constructor(config: ContextualServiceConfig);
+    /**
+     * Load models cache from file if it exists and is fresh
+     */
+    private loadModelsCache;
+    /**
+     * Save models cache to file
+     */
+    private saveModelsCache;
     private autoConfigureProviders;
     private log;
     private handleError;
@@ -30,14 +41,51 @@ export declare class ContextualCommandService {
      */
     getSuggestions(request: ContextualRequest): Promise<any[]>;
     /**
-     * Get available models
+     * Static utility to read cached models from file (for use in other services)
+     */
+    static getCachedModelsSync(): Array<{
+        id: string;
+        name: string;
+        provider: string;
+        available: boolean;
+        computeWeight?: number;
+        supportsImages?: boolean;
+    }>;
+    /**
+     * Static utility to get the fastest model for a provider from cache
+     */
+    static getFastestModelSync(provider: string): string | null;
+    /**
+     * Get available models from API or use cached/defaults
+     * Uses file-based cache that refreshes every 24 hours
      */
     getAvailableModels(): Promise<{
         id: string;
         name: string;
         provider: string;
         available: boolean;
+        computeWeight?: number;
+        supportsImages?: boolean;
     }[]>;
+    /**
+     * Get the latest default model for a provider (balanced tier, or fallback to hardcoded)
+     * This should be used instead of DEFAULT_CONFIG.model when possible
+     */
+    getLatestDefaultModel(provider?: string): Promise<string>;
+    /**
+     * Get default models by tier for a provider
+     * @param provider - Provider name
+     * @param tier - 'fast' (lowest computeWeight = cheapest), 'balanced' (medium), or 'powerful' (highest = most expensive)
+     */
+    getDefaultModelByTier(provider: string, tier?: 'fast' | 'balanced' | 'powerful'): Promise<string | null>;
+    /**
+     * Get latest models from each tier for all configured providers
+     */
+    getLatestModelsByTier(): Promise<Record<string, {
+        fast: string;
+        balanced: string;
+        powerful: string;
+    }>>;
     /**
      * Get usage statistics
      */

package/dist/cli/server/intent-detection.d.ts

@@ -90,10 +90,12 @@ export declare class IntentDetectionPlugin {
     constructor(config: IntentDetectionConfig);
     /**
      * Resolve model name with dynamic discovery support
+     * Uses cached models when available, falls back to defaults
      */
     private resolveModelName;
     /**
      * Dynamically discover and select the best model for the provider
+     * Uses cached models when available
      */
     private discoverBestModel;
     private createModelInstance;

package/dist/cli/server/utils.d.ts

@@ -14,18 +14,6 @@ export declare function getDefaultModelsForProvider(provider: string): {
     provider: string;
     available: boolean;
     supportsImages: boolean;
-}[] | {
-    id: string;
-    name: string;
-    provider: string;
-    available: boolean;
-    supportsImages: boolean;
-}[] | {
-    id: string;
-    name: string;
-    provider: string;
-    available: boolean;
-    supportsImages: boolean;
 }[];
 /**
  * Enhanced context analysis for better AI suggestions

package/dist/cli/types/types.d.ts

@@ -494,7 +494,8 @@ export interface ContextualRequest {
     }>;
     modelSelection?: {
         provider: string;
-        model: string;
+        model?: string;
+        tier?: 'fast' | 'balanced' | 'powerful';
     };
     chatLevel?: 'full' | 'basic' | 'none';
     additionalContext?: string;

package/dist/components/ChatPanel.d.ts

@@ -20,7 +20,8 @@ interface ChatPanelProps {
     models?: Record<string, ModelInfo[]>;
     defaultModel?: {
         provider: string;
-        model: string;
+        model?: string;
+        tier?: 'fast' | 'balanced' | 'powerful';
     };
     showUsageStats?: boolean;
     maxFileSize?: string;

package/dist/components/Conversation.d.ts

@@ -27,7 +27,8 @@ interface ConversationProps {
     models?: Record<string, ModelInfo[]>;
     defaultModel?: {
         provider: string;
-        model: string;
+        model?: string;
+        tier?: 'fast' | 'balanced' | 'powerful';
     };
     showUsageStats?: boolean;
     maxFileSize?: string;

package/dist/components/ModelSwitcher.d.ts

@@ -4,7 +4,8 @@ interface ModelSwitcherProps {
     models?: Record<string, ModelInfo[]>;
     defaultModel?: {
         provider: string;
-        model: string;
+        model?: string;
+        tier?: 'fast' | 'balanced' | 'powerful';
     };
     showUsageStats?: boolean;
     theme?: ChatTheme;

package/dist/hooks/useModelSwitcher.d.ts

@@ -1,4 +1,4 @@
-import { ModelInfo } from '../types/types';
+import { ModelInfo, ServerConfig } from '../types/types';
 interface CurrentModel {
     provider: string;
     model: string;
@@ -25,16 +25,19 @@ interface UsageStats {
 interface UseModelSwitcherOptions {
     initialProvider?: string;
     initialModel?: string;
+    initialTier?: 'fast' | 'balanced' | 'powerful';
     customModels?: Record<string, ModelInfo[]>;
+    serverConfig?: ServerConfig;
 }
-export declare function useModelSwitcher({ initialProvider, initialModel, customModels, }?: UseModelSwitcherOptions): {
+export declare function useModelSwitcher({ initialProvider, initialModel, initialTier, // Can be undefined - don't default here, let Conversation handle it
+customModels, serverConfig, }?: UseModelSwitcherOptions): {
     models: ModelInfo[];
     modelsByProvider: Record<string, ModelInfo[]>;
     currentModel: CurrentModel;
     currentCapabilities: ModelCapabilities;
     usageStats: UsageStats;
     isLoading: boolean;
-    error: null;
+    error: string | null;
     switchModel: (model: string, provider?: string) => {
         success: boolean;
         current: {
@@ -48,7 +51,7 @@ export declare function useModelSwitcher({ initialProvider, initialModel, custom
         provider: string;
         model: string;
         capabilities: ModelCapabilities;
-    };
+    } | null;
     modelState: {
         models: ModelInfo[];
         current: CurrentModel;

package/dist/hooks/useResolvedDefaultModel.d.ts

@@ -0,0 +1,21 @@
+import type { ModelCapabilities } from '../types/types';
+/**
+ * Hook to resolve tier-based default model config to actual model
+ *
+ * This hook takes a default model configuration that may include a tier
+ * (like 'fast', 'balanced', 'powerful') and resolves it to an actual model
+ * by fetching the available models from the server and selecting the best
+ * match for the provider and tier combination.
+ *
+ * @param defaultModel - The model configuration to resolve
+ * @returns The resolved model with provider, model name, and capabilities
+ */
+export declare function useResolvedDefaultModel(defaultModel?: {
+    provider: string;
+    model?: string;
+    tier?: 'fast' | 'balanced' | 'powerful';
+}): {
+    provider: string;
+    model: string;
+    capabilities: ModelCapabilities;
+} | undefined;

package/dist/hooks/useStreamingAI.d.ts

@@ -1,8 +1,9 @@
 import { ChatMessage, ModelCapabilities, ServerConfig } from '../types/types';
 interface ModelSelection {
     provider: string;
-    model: string;
-    capabilities: ModelCapabilities;
+    model?: string;
+    tier?: 'fast' | 'balanced' | 'powerful';
+    capabilities?: ModelCapabilities;
 }
 export declare function useStreamingAI({ userId, serverConfig, formData, chats: externalChats, setChats: externalSetChats, currentChatId: externalCurrentChatId, setCurrentChatId: externalSetCurrentChatId, modelSelection, onUsageTracked, chatLevel, additionalContext, verbose, }: {
     userId: string;

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export { useStreamingAI } from './hooks/useStreamingAI';
 export { useSuggestions, useDebouncedSuggestions, } from './hooks/useSuggestions';
+export { useResolvedDefaultModel } from './hooks/useResolvedDefaultModel';
 export { ChatPanel } from './components/ChatPanel';
 export { Conversation } from './components/Conversation';
 export { SuggestionsPanel, SuggestionCard, } from './components/SuggestionsPanel';