orchid-ai 1.2.7 → 1.3.0

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

@@ -1,4 +1,5 @@
 import type { ModelCapabilities } from '../types/types';
+import type { ServerConfig } from '../types/types';
 /**
  * Hook to resolve tier-based default model config to actual model
  *
@@ -8,13 +9,14 @@ import type { ModelCapabilities } from '../types/types';
  * match for the provider and tier combination.
  *
  * @param defaultModel - The model configuration to resolve
+ * @param serverConfig - Optional server config to build the models endpoint URL
  * @returns The resolved model with provider, model name, and capabilities
  */
 export declare function useResolvedDefaultModel(defaultModel?: {
     provider: string;
     model?: string;
     tier?: 'fast' | 'balanced' | 'powerful';
-}): {
+}, serverConfig?: ServerConfig): {
     provider: string;
     model: string;
     capabilities: ModelCapabilities;

package/dist/cli/index.d.ts

@@ -10,5 +10,5 @@ export { mergeWithAi } from './utils';
 export { useAiMerge } from './hooks/useAiMerge';
 export { ErrorBoundary } from './components/ErrorBoundary';
 export { Icon as CommandIcon } from './components/Icon';
-export type { CommandConfig, TrainingData, AIProvider, CommandTheme, CommandSuggestion, CommandPopupProps, ChatMessage, ChatTheme, AIStatus, Action, ModelInfo, ServerConfig, SchemaDefinition, SchemaProperty, ContextualServiceConfig, ContextualRequest, } from './types/types';
+export type { CommandConfig, TrainingData, AIProvider, CommandTheme, CommandSuggestion, CommandPopupProps, ChatMessage, ChatTheme, AIStatus, Action, ModelInfo, ServerConfig, ClientConfig, SchemaDefinition, SchemaProperty, ContextualServiceConfig, ContextualRequest, } from './types/types';
 export { defaultTheme as defaultCommandTheme } from './constants';

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

@@ -24,6 +24,7 @@ export declare class ContextualCommandService {
     private buildContextualSystemPrompt;
     /**
      * Format schema fields into readable descriptions
+     * Excludes client-generated fields from the output
      */
     private formatSchemaFields;
     /**

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

@@ -134,6 +134,24 @@ export interface ServerConfig {
     additionalContext?: string;
     stayOnPage?: boolean;
 }
+export interface ClientConfig {
+    models?: Record<string, ModelInfo[]>;
+    defaultModel?: {
+        provider: string;
+        model?: string;
+        tier?: 'fast' | 'balanced' | 'powerful';
+    };
+    showUsageStats?: boolean;
+    maxFileSize?: string;
+    features?: {
+        modelSwitching?: boolean;
+        usageTracking?: boolean;
+        imageAnalysis?: boolean;
+        fileUploads?: boolean;
+        enableImageUploads?: boolean;
+    };
+    schemas?: Record<string, SchemaDefinition>;
+}
 export interface TrainingDataPaths {
     components: string[];
     schemas: string[];
@@ -465,6 +483,8 @@ export interface SchemaProperty {
     maxLength?: number;
     minimum?: number;
     maximum?: number;
+    /** If true, this field is not to be generated by AI (e.g. auto-generated fields) */
+    skip?: boolean;
 }
 /**
  * Simplified config for ContextualCommandService

package/dist/hooks/useResolvedDefaultModel.d.ts

@@ -1,4 +1,5 @@
 import type { ModelCapabilities } from '../types/types';
+import type { ServerConfig } from '../types/types';
 /**
  * Hook to resolve tier-based default model config to actual model
  *
@@ -8,13 +9,14 @@ import type { ModelCapabilities } from '../types/types';
  * match for the provider and tier combination.
  *
  * @param defaultModel - The model configuration to resolve
+ * @param serverConfig - Optional server config to build the models endpoint URL
  * @returns The resolved model with provider, model name, and capabilities
  */
 export declare function useResolvedDefaultModel(defaultModel?: {
     provider: string;
     model?: string;
     tier?: 'fast' | 'balanced' | 'powerful';
-}): {
+}, serverConfig?: ServerConfig): {
     provider: string;
     model: string;
     capabilities: ModelCapabilities;

package/dist/index.d.ts

@@ -10,5 +10,5 @@ export { mergeWithAi } from './utils';
 export { useAiMerge } from './hooks/useAiMerge';
 export { ErrorBoundary } from './components/ErrorBoundary';
 export { Icon as CommandIcon } from './components/Icon';
-export type { CommandConfig, TrainingData, AIProvider, CommandTheme, CommandSuggestion, CommandPopupProps, ChatMessage, ChatTheme, AIStatus, Action, ModelInfo, ServerConfig, SchemaDefinition, SchemaProperty, ContextualServiceConfig, ContextualRequest, } from './types/types';
+export type { CommandConfig, TrainingData, AIProvider, CommandTheme, CommandSuggestion, CommandPopupProps, ChatMessage, ChatTheme, AIStatus, Action, ModelInfo, ServerConfig, ClientConfig, SchemaDefinition, SchemaProperty, ContextualServiceConfig, ContextualRequest, } from './types/types';
 export { defaultTheme as defaultCommandTheme } from './constants';

package/dist/index.esm.js

@@ -1100,6 +1100,22 @@ function useDebouncedSuggestions(query, options) {
     };
 }
 
+// Helper function to build URL from config (reused from useModelSwitcher)
+function buildUrlFromConfig$1(config) {
+    if (!config)
+        return '';
+    const suffix = config.suffix || '';
+    if (suffix.startsWith('http://') || suffix.startsWith('https://')) {
+        return suffix;
+    }
+    if (typeof window === 'undefined') {
+        return suffix;
+    }
+    const protocol = window.location.protocol === 'https:' ? 'https:' : 'http:';
+    const hostname = window.location.hostname;
+    const port = window.location.port ? `:${window.location.port}` : '';
+    return `${protocol}//${hostname}${port}${suffix}`;
+}
 /**
  * Hook to resolve tier-based default model config to actual model
  *
@@ -1109,9 +1125,10 @@ function useDebouncedSuggestions(query, options) {
  * match for the provider and tier combination.
  *
  * @param defaultModel - The model configuration to resolve
+ * @param serverConfig - Optional server config to build the models endpoint URL
  * @returns The resolved model with provider, model name, and capabilities
  */
-function useResolvedDefaultModel(defaultModel) {
+function useResolvedDefaultModel(defaultModel, serverConfig) {
     const [resolvedModel, setResolvedModel] = useState();
     useEffect(() => {
         if (!defaultModel || defaultModel.model) {
@@ -1128,7 +1145,11 @@ function useResolvedDefaultModel(defaultModel) {
         // Need to resolve tier to actual model
         const resolveModel = async () => {
             try {
-                const response = await fetch('/command/models');
+                // Build models endpoint URL from serverConfig if provided, otherwise use default
+                const endpoint = serverConfig
+                    ? `${buildUrlFromConfig$1(serverConfig)}/models`
+                    : '/command/models';
+                const response = await fetch(endpoint);
                 if (!response.ok)
                     throw new Error('Failed to fetch models');
                 const data = await response.json();
@@ -1155,7 +1176,7 @@ function useResolvedDefaultModel(defaultModel) {
             }
         };
         resolveModel();
-    }, [defaultModel]);
+    }, [defaultModel, serverConfig]);
     return resolvedModel;
 }
 
@@ -3302,7 +3323,7 @@ theme, isOpen, }) {
     }, [onModelSelectionChange]);
     return (jsxs("div", { className: `px-3 py-2 border-t flex flex-col gap-2 transition-all duration-500 delay-500 ${isOpen ? 'opacity-100 translate-y-0' : 'opacity-0 translate-y-4'}`, style: { borderColor: theme.colors.border.primary }, children: [attachedFiles.length > 0 && (jsx("div", { className: "flex flex-wrap gap-2 mb-2", children: attachedFiles.map((file, index) => (jsxs("div", { className: "relative group", children: [jsx("div", { className: "w-16 h-16 rounded-lg border border-gray-200 bg-gray-50 flex items-center justify-center overflow-hidden", children: file.type.startsWith('image/') ? (jsx("img", { src: URL.createObjectURL(file), alt: `Attached ${index + 1}`, className: "w-full h-full object-cover" })) : (jsx("div", { className: "flex items-center justify-center", children: FileHandler.getFileIcon(file) })) }), jsx("button", { onClick: () => removeFile(index), className: "absolute -top-2 -right-2 w-5 h-5 bg-red-500 text-white rounded-full flex items-center justify-center text-xs hover:bg-red-600 transition-colors", title: "Remove file", children: "\u00D7" }), jsx("div", { className: "absolute bottom-0 left-1/2 transform -translate-x-1/2 translate-y-full opacity-0 group-hover:opacity-100 transition-opacity duration-200 pointer-events-none z-10 mt-2", children: jsxs("div", { className: "bg-gray-900 text-white text-xs rounded-lg px-2 py-1 whitespace-nowrap shadow-lg", children: [jsx("div", { className: "font-medium truncate max-w-32", title: file.name, children: file.name }), jsxs("div", { className: "text-gray-300", children: [FileHandler.getFileTypeDescription(file), " \u2022", ' ', FileHandler.formatFileSize(file.size)] }), jsx("div", { className: "absolute -top-1 left-1/2 transform -translate-x-1/2 w-2 h-2 bg-gray-900 rotate-45" })] }) })] }, index))) })), incompatibleFiles.length > 0 && (jsxs("div", { className: "relative flex flex-col gap-1 text-sm text-orange-700 bg-orange-50 border border-orange-200 rounded px-3 py-2 mb-2", children: [jsx("button", { onClick: () => setIncompatibleFiles([]), className: "absolute top-1 right-1 w-5 h-5 flex items-center justify-center text-orange-500 hover:text-orange-700 hover:bg-orange-200 rounded-full transition-colors", title: "Dismiss", type: "button", children: "\u00D7" }), jsxs("div", { className: "flex items-center gap-2 pr-6", children: [jsx("span", { children: "\u26A0\uFE0F" }), jsx("span", { className: "font-medium", children: incompatibleFiles.length === 1
                                     ? 'File not supported'
-                                    : 'Some files not supported' })] }), jsxs("div", { className: "text-xs", children: [jsx("div", { className: "mb-1", children: "These files were skipped:" }), jsxs("ul", { className: "list-disc list-inside ml-2 space-y-0.5", children: [incompatibleFiles.slice(0, 3).map((fileName, index) => (jsx("li", { className: "truncate", children: fileName }, index))), incompatibleFiles.length > 3 && (jsxs("li", { children: ["... and ", incompatibleFiles.length - 3, " more"] }))] }), jsxs("div", { className: "mt-1 text-orange-600", children: ["\uD83D\uDCA1 Only ", FileHandler.getAcceptedTypesDescription(), " are supported", incompatibleFiles.some((name) => name.includes('images not supported by current model')) && (jsxs("div", { className: "mt-1", children: ["\uD83D\uDD04 ", jsx("strong", { children: "Switch to GPT-4O, Claude 3, or Gemini" }), " to enable image uploads"] }))] })] })] })), jsxs("div", { className: `relative flex flex-col gap-1 rounded border px-2 pt-1 pb-1 cursor-text transition-all duration-200 border-2 focus-within:shadow-sm ${isDragOver ? 'border-dashed bg-opacity-20' : 'border-transparent'}`, style: {
+                                    : 'Some files not supported' })] }), jsxs("div", { className: "text-xs", children: [jsx("div", { className: "mb-1", children: "These files were skipped:" }), jsxs("ul", { className: "list-disc list-inside ml-2 space-y-0.5", children: [incompatibleFiles.slice(0, 3).map((fileName, index) => (jsx("li", { className: "truncate", children: fileName }, index))), incompatibleFiles.length > 3 && (jsxs("li", { children: ["... and ", incompatibleFiles.length - 3, " more"] }))] }), jsxs("div", { className: "mt-1 text-orange-600", children: ["\uD83D\uDCA1 Only ", FileHandler.getAcceptedTypesDescription(), " are supported", incompatibleFiles.some((name) => name.includes('images not supported by current model')) && (jsx("div", { className: "mt-1", children: "\uD83D\uDD04 Switch to a model showing the image icon in the model switcher to enable image uploads" }))] })] })] })), jsxs("div", { className: `relative flex flex-col gap-1 rounded border px-2 pt-1 pb-1 cursor-text transition-all duration-200 border-2 focus-within:shadow-sm ${isDragOver ? 'border-dashed bg-opacity-20' : 'border-transparent'}`, style: {
                     backgroundColor: theme.colors.surface.primary,
                     borderColor: isDragOver
                         ? theme.colors.primary[400]
@@ -3329,7 +3350,7 @@ theme, isOpen, }) {
                                             e.currentTarget.style.color = theme.colors.text.tertiary;
                                         }, title: imageSupported
                                             ? 'Attach images - AI can analyze image content'
-                                            : "Current model doesn't support images. Switch to GPT-4O, Claude 3, or Gemini to use image attachments.", tabIndex: -1, type: "button", onClick: () => imageSupported && imageInputRef.current?.click(), disabled: !imageSupported, children: jsx(Icon, { name: "image", size: "sm" }) })), jsx("button", { className: "p-1 cursor-pointer disabled:opacity-50 disabled:cursor-default transition-colors", style: { color: theme.colors.text.tertiary }, title: "Record audio (coming soon)", tabIndex: -1, type: "button", onClick: handleAudioRecord, disabled: true, children: jsx(Icon, { name: "microphone", size: "sm" }) })] }), jsx("button", { onClick: () => onSend(), disabled: (!query.trim() && attachedFiles.length === 0) || isLoading, className: "rounded-full transition disabled:opacity-50 p-2", style: {
+                                            : "Current model doesn't support images. Switch to GPT-4O, Claude, or Gemini to use image attachments.", tabIndex: -1, type: "button", onClick: () => imageSupported && imageInputRef.current?.click(), disabled: !imageSupported, children: jsx(Icon, { name: "image", size: "sm" }) })), jsx("button", { className: "p-1 cursor-pointer disabled:opacity-50 disabled:cursor-default transition-colors", style: { color: theme.colors.text.tertiary }, title: "Record audio (coming soon)", tabIndex: -1, type: "button", onClick: handleAudioRecord, disabled: true, children: jsx(Icon, { name: "microphone", size: "sm" }) })] }), jsx("button", { onClick: () => onSend(), disabled: (!query.trim() && attachedFiles.length === 0) || isLoading, className: "rounded-full transition disabled:opacity-50 p-2", style: {
                                     color: theme.colors.text.primary,
                                 }, onMouseEnter: (e) => {
                                     if (!e.currentTarget.disabled) {
@@ -3344,7 +3365,7 @@ theme, isOpen, }) {
                 features.imageAnalysis !== false &&
                 features.enableImageUploads !== false &&
                 !imageSupported &&
-                !imageTipDismissed && (jsxs("div", { className: "relative px-2 py-1 bg-amber-50 border border-amber-200 rounded text-amber-700 text-xs flex items-center gap-2", children: [jsx(Icon, { name: "image", size: "xs", className: "opacity-50" }), jsxs("span", { className: "flex-1 pr-4", children: ["\uD83D\uDCA1 ", jsx("strong", { children: "Tip:" }), " Switch to GPT-4O, Claude 3, or Gemini in the model switcher below to enable image attachments"] }), jsx("button", { onClick: () => setImageTipDismissed(true), className: "absolute top-1 right-1 w-4 h-4 flex items-center justify-center text-amber-500 hover:text-amber-700 hover:bg-amber-200 rounded-full transition-colors text-xs font-bold", title: "Dismiss tip", type: "button", children: "\u00D7" })] })), jsxs("div", { className: "flex items-center justify-between text-xs px-0 pt-0", style: { color: theme.colors.text.tertiary }, children: [jsx("div", { className: "flex gap-4", children: features.modelSwitching !== false && (jsx(ModelSwitcher, { models: models, defaultModel: defaultModel, showUsageStats: features.usageTracking !== false && showUsageStats !== false, theme: theme, onModelSelectionChange: modelSelectionHandler })) }), jsx("div", { className: "flex items-center gap-2", children: jsxs("span", { children: [jsx("kbd", { className: "px-1 rounded", style: {
+                !imageTipDismissed && (jsxs("div", { className: "relative px-2 py-1 bg-amber-50 border border-amber-200 rounded text-amber-700 text-xs flex items-center gap-2", children: [jsx(Icon, { name: "image", size: "xs", className: "opacity-50" }), jsxs("span", { className: "flex-1 pr-4", children: ["\uD83D\uDCA1 ", jsx("strong", { children: "Tip:" }), " Switch to a model showing the image icon in the model switcher below to enable image uploads"] }), jsx("button", { onClick: () => setImageTipDismissed(true), className: "absolute top-1 right-1 w-4 h-4 flex items-center justify-center text-amber-500 hover:text-amber-700 hover:bg-amber-200 rounded-full transition-colors text-xs font-bold", title: "Dismiss tip", type: "button", children: "\u00D7" })] })), jsxs("div", { className: "flex items-center justify-between text-xs px-0 pt-0", style: { color: theme.colors.text.tertiary }, children: [jsx("div", { className: "flex gap-4", children: features.modelSwitching !== false && (jsx(ModelSwitcher, { models: models, defaultModel: defaultModel, showUsageStats: features.usageTracking !== false && showUsageStats !== false, theme: theme, onModelSelectionChange: modelSelectionHandler })) }), jsx("div", { className: "flex items-center gap-2", children: jsxs("span", { children: [jsx("kbd", { className: "px-1 rounded", style: {
                                         backgroundColor: theme.colors.surface.secondary,
                                         color: theme.colors.text.secondary,
                                     }, children: "\u23CE" }), ' ', "to send,", ' ', jsx("kbd", { className: "px-1 rounded", style: {

package/dist/index.js

@@ -1102,6 +1102,22 @@ function useDebouncedSuggestions(query, options) {
     };
 }
 
+// Helper function to build URL from config (reused from useModelSwitcher)
+function buildUrlFromConfig$1(config) {
+    if (!config)
+        return '';
+    const suffix = config.suffix || '';
+    if (suffix.startsWith('http://') || suffix.startsWith('https://')) {
+        return suffix;
+    }
+    if (typeof window === 'undefined') {
+        return suffix;
+    }
+    const protocol = window.location.protocol === 'https:' ? 'https:' : 'http:';
+    const hostname = window.location.hostname;
+    const port = window.location.port ? `:${window.location.port}` : '';
+    return `${protocol}//${hostname}${port}${suffix}`;
+}
 /**
  * Hook to resolve tier-based default model config to actual model
  *
@@ -1111,9 +1127,10 @@ function useDebouncedSuggestions(query, options) {
  * match for the provider and tier combination.
  *
  * @param defaultModel - The model configuration to resolve
+ * @param serverConfig - Optional server config to build the models endpoint URL
  * @returns The resolved model with provider, model name, and capabilities
  */
-function useResolvedDefaultModel(defaultModel) {
+function useResolvedDefaultModel(defaultModel, serverConfig) {
     const [resolvedModel, setResolvedModel] = React.useState();
     React.useEffect(() => {
         if (!defaultModel || defaultModel.model) {
@@ -1130,7 +1147,11 @@ function useResolvedDefaultModel(defaultModel) {
         // Need to resolve tier to actual model
         const resolveModel = async () => {
             try {
-                const response = await fetch('/command/models');
+                // Build models endpoint URL from serverConfig if provided, otherwise use default
+                const endpoint = serverConfig
+                    ? `${buildUrlFromConfig$1(serverConfig)}/models`
+                    : '/command/models';
+                const response = await fetch(endpoint);
                 if (!response.ok)
                     throw new Error('Failed to fetch models');
                 const data = await response.json();
@@ -1157,7 +1178,7 @@ function useResolvedDefaultModel(defaultModel) {
             }
         };
         resolveModel();
-    }, [defaultModel]);
+    }, [defaultModel, serverConfig]);
     return resolvedModel;
 }
 
@@ -3304,7 +3325,7 @@ theme, isOpen, }) {
     }, [onModelSelectionChange]);
     return (jsxRuntime.jsxs("div", { className: `px-3 py-2 border-t flex flex-col gap-2 transition-all duration-500 delay-500 ${isOpen ? 'opacity-100 translate-y-0' : 'opacity-0 translate-y-4'}`, style: { borderColor: theme.colors.border.primary }, children: [attachedFiles.length > 0 && (jsxRuntime.jsx("div", { className: "flex flex-wrap gap-2 mb-2", children: attachedFiles.map((file, index) => (jsxRuntime.jsxs("div", { className: "relative group", children: [jsxRuntime.jsx("div", { className: "w-16 h-16 rounded-lg border border-gray-200 bg-gray-50 flex items-center justify-center overflow-hidden", children: file.type.startsWith('image/') ? (jsxRuntime.jsx("img", { src: URL.createObjectURL(file), alt: `Attached ${index + 1}`, className: "w-full h-full object-cover" })) : (jsxRuntime.jsx("div", { className: "flex items-center justify-center", children: FileHandler.getFileIcon(file) })) }), jsxRuntime.jsx("button", { onClick: () => removeFile(index), className: "absolute -top-2 -right-2 w-5 h-5 bg-red-500 text-white rounded-full flex items-center justify-center text-xs hover:bg-red-600 transition-colors", title: "Remove file", children: "\u00D7" }), jsxRuntime.jsx("div", { className: "absolute bottom-0 left-1/2 transform -translate-x-1/2 translate-y-full opacity-0 group-hover:opacity-100 transition-opacity duration-200 pointer-events-none z-10 mt-2", children: jsxRuntime.jsxs("div", { className: "bg-gray-900 text-white text-xs rounded-lg px-2 py-1 whitespace-nowrap shadow-lg", children: [jsxRuntime.jsx("div", { className: "font-medium truncate max-w-32", title: file.name, children: file.name }), jsxRuntime.jsxs("div", { className: "text-gray-300", children: [FileHandler.getFileTypeDescription(file), " \u2022", ' ', FileHandler.formatFileSize(file.size)] }), jsxRuntime.jsx("div", { className: "absolute -top-1 left-1/2 transform -translate-x-1/2 w-2 h-2 bg-gray-900 rotate-45" })] }) })] }, index))) })), incompatibleFiles.length > 0 && (jsxRuntime.jsxs("div", { className: "relative flex flex-col gap-1 text-sm text-orange-700 bg-orange-50 border border-orange-200 rounded px-3 py-2 mb-2", children: [jsxRuntime.jsx("button", { onClick: () => setIncompatibleFiles([]), className: "absolute top-1 right-1 w-5 h-5 flex items-center justify-center text-orange-500 hover:text-orange-700 hover:bg-orange-200 rounded-full transition-colors", title: "Dismiss", type: "button", children: "\u00D7" }), jsxRuntime.jsxs("div", { className: "flex items-center gap-2 pr-6", children: [jsxRuntime.jsx("span", { children: "\u26A0\uFE0F" }), jsxRuntime.jsx("span", { className: "font-medium", children: incompatibleFiles.length === 1
                                     ? 'File not supported'
-                                    : 'Some files not supported' })] }), jsxRuntime.jsxs("div", { className: "text-xs", children: [jsxRuntime.jsx("div", { className: "mb-1", children: "These files were skipped:" }), jsxRuntime.jsxs("ul", { className: "list-disc list-inside ml-2 space-y-0.5", children: [incompatibleFiles.slice(0, 3).map((fileName, index) => (jsxRuntime.jsx("li", { className: "truncate", children: fileName }, index))), incompatibleFiles.length > 3 && (jsxRuntime.jsxs("li", { children: ["... and ", incompatibleFiles.length - 3, " more"] }))] }), jsxRuntime.jsxs("div", { className: "mt-1 text-orange-600", children: ["\uD83D\uDCA1 Only ", FileHandler.getAcceptedTypesDescription(), " are supported", incompatibleFiles.some((name) => name.includes('images not supported by current model')) && (jsxRuntime.jsxs("div", { className: "mt-1", children: ["\uD83D\uDD04 ", jsxRuntime.jsx("strong", { children: "Switch to GPT-4O, Claude 3, or Gemini" }), " to enable image uploads"] }))] })] })] })), jsxRuntime.jsxs("div", { className: `relative flex flex-col gap-1 rounded border px-2 pt-1 pb-1 cursor-text transition-all duration-200 border-2 focus-within:shadow-sm ${isDragOver ? 'border-dashed bg-opacity-20' : 'border-transparent'}`, style: {
+                                    : 'Some files not supported' })] }), jsxRuntime.jsxs("div", { className: "text-xs", children: [jsxRuntime.jsx("div", { className: "mb-1", children: "These files were skipped:" }), jsxRuntime.jsxs("ul", { className: "list-disc list-inside ml-2 space-y-0.5", children: [incompatibleFiles.slice(0, 3).map((fileName, index) => (jsxRuntime.jsx("li", { className: "truncate", children: fileName }, index))), incompatibleFiles.length > 3 && (jsxRuntime.jsxs("li", { children: ["... and ", incompatibleFiles.length - 3, " more"] }))] }), jsxRuntime.jsxs("div", { className: "mt-1 text-orange-600", children: ["\uD83D\uDCA1 Only ", FileHandler.getAcceptedTypesDescription(), " are supported", incompatibleFiles.some((name) => name.includes('images not supported by current model')) && (jsxRuntime.jsx("div", { className: "mt-1", children: "\uD83D\uDD04 Switch to a model showing the image icon in the model switcher to enable image uploads" }))] })] })] })), jsxRuntime.jsxs("div", { className: `relative flex flex-col gap-1 rounded border px-2 pt-1 pb-1 cursor-text transition-all duration-200 border-2 focus-within:shadow-sm ${isDragOver ? 'border-dashed bg-opacity-20' : 'border-transparent'}`, style: {
                     backgroundColor: theme.colors.surface.primary,
                     borderColor: isDragOver
                         ? theme.colors.primary[400]
@@ -3331,7 +3352,7 @@ theme, isOpen, }) {
                                             e.currentTarget.style.color = theme.colors.text.tertiary;
                                         }, title: imageSupported
                                             ? 'Attach images - AI can analyze image content'
-                                            : "Current model doesn't support images. Switch to GPT-4O, Claude 3, or Gemini to use image attachments.", tabIndex: -1, type: "button", onClick: () => imageSupported && imageInputRef.current?.click(), disabled: !imageSupported, children: jsxRuntime.jsx(Icon, { name: "image", size: "sm" }) })), jsxRuntime.jsx("button", { className: "p-1 cursor-pointer disabled:opacity-50 disabled:cursor-default transition-colors", style: { color: theme.colors.text.tertiary }, title: "Record audio (coming soon)", tabIndex: -1, type: "button", onClick: handleAudioRecord, disabled: true, children: jsxRuntime.jsx(Icon, { name: "microphone", size: "sm" }) })] }), jsxRuntime.jsx("button", { onClick: () => onSend(), disabled: (!query.trim() && attachedFiles.length === 0) || isLoading, className: "rounded-full transition disabled:opacity-50 p-2", style: {
+                                            : "Current model doesn't support images. Switch to GPT-4O, Claude, or Gemini to use image attachments.", tabIndex: -1, type: "button", onClick: () => imageSupported && imageInputRef.current?.click(), disabled: !imageSupported, children: jsxRuntime.jsx(Icon, { name: "image", size: "sm" }) })), jsxRuntime.jsx("button", { className: "p-1 cursor-pointer disabled:opacity-50 disabled:cursor-default transition-colors", style: { color: theme.colors.text.tertiary }, title: "Record audio (coming soon)", tabIndex: -1, type: "button", onClick: handleAudioRecord, disabled: true, children: jsxRuntime.jsx(Icon, { name: "microphone", size: "sm" }) })] }), jsxRuntime.jsx("button", { onClick: () => onSend(), disabled: (!query.trim() && attachedFiles.length === 0) || isLoading, className: "rounded-full transition disabled:opacity-50 p-2", style: {
                                     color: theme.colors.text.primary,
                                 }, onMouseEnter: (e) => {
                                     if (!e.currentTarget.disabled) {
@@ -3346,7 +3367,7 @@ theme, isOpen, }) {
                 features.imageAnalysis !== false &&
                 features.enableImageUploads !== false &&
                 !imageSupported &&
-                !imageTipDismissed && (jsxRuntime.jsxs("div", { className: "relative px-2 py-1 bg-amber-50 border border-amber-200 rounded text-amber-700 text-xs flex items-center gap-2", children: [jsxRuntime.jsx(Icon, { name: "image", size: "xs", className: "opacity-50" }), jsxRuntime.jsxs("span", { className: "flex-1 pr-4", children: ["\uD83D\uDCA1 ", jsxRuntime.jsx("strong", { children: "Tip:" }), " Switch to GPT-4O, Claude 3, or Gemini in the model switcher below to enable image attachments"] }), jsxRuntime.jsx("button", { onClick: () => setImageTipDismissed(true), className: "absolute top-1 right-1 w-4 h-4 flex items-center justify-center text-amber-500 hover:text-amber-700 hover:bg-amber-200 rounded-full transition-colors text-xs font-bold", title: "Dismiss tip", type: "button", children: "\u00D7" })] })), jsxRuntime.jsxs("div", { className: "flex items-center justify-between text-xs px-0 pt-0", style: { color: theme.colors.text.tertiary }, children: [jsxRuntime.jsx("div", { className: "flex gap-4", children: features.modelSwitching !== false && (jsxRuntime.jsx(ModelSwitcher, { models: models, defaultModel: defaultModel, showUsageStats: features.usageTracking !== false && showUsageStats !== false, theme: theme, onModelSelectionChange: modelSelectionHandler })) }), jsxRuntime.jsx("div", { className: "flex items-center gap-2", children: jsxRuntime.jsxs("span", { children: [jsxRuntime.jsx("kbd", { className: "px-1 rounded", style: {
+                !imageTipDismissed && (jsxRuntime.jsxs("div", { className: "relative px-2 py-1 bg-amber-50 border border-amber-200 rounded text-amber-700 text-xs flex items-center gap-2", children: [jsxRuntime.jsx(Icon, { name: "image", size: "xs", className: "opacity-50" }), jsxRuntime.jsxs("span", { className: "flex-1 pr-4", children: ["\uD83D\uDCA1 ", jsxRuntime.jsx("strong", { children: "Tip:" }), " Switch to a model showing the image icon in the model switcher below to enable image uploads"] }), jsxRuntime.jsx("button", { onClick: () => setImageTipDismissed(true), className: "absolute top-1 right-1 w-4 h-4 flex items-center justify-center text-amber-500 hover:text-amber-700 hover:bg-amber-200 rounded-full transition-colors text-xs font-bold", title: "Dismiss tip", type: "button", children: "\u00D7" })] })), jsxRuntime.jsxs("div", { className: "flex items-center justify-between text-xs px-0 pt-0", style: { color: theme.colors.text.tertiary }, children: [jsxRuntime.jsx("div", { className: "flex gap-4", children: features.modelSwitching !== false && (jsxRuntime.jsx(ModelSwitcher, { models: models, defaultModel: defaultModel, showUsageStats: features.usageTracking !== false && showUsageStats !== false, theme: theme, onModelSelectionChange: modelSelectionHandler })) }), jsxRuntime.jsx("div", { className: "flex items-center gap-2", children: jsxRuntime.jsxs("span", { children: [jsxRuntime.jsx("kbd", { className: "px-1 rounded", style: {
                                         backgroundColor: theme.colors.surface.secondary,
                                         color: theme.colors.text.secondary,
                                     }, children: "\u23CE" }), ' ', "to send,", ' ', jsxRuntime.jsx("kbd", { className: "px-1 rounded", style: {

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

@@ -24,6 +24,7 @@ export declare class ContextualCommandService {
     private buildContextualSystemPrompt;
     /**
      * Format schema fields into readable descriptions
+     * Excludes client-generated fields from the output
      */
     private formatSchemaFields;
     /**

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

@@ -1,4 +1,5 @@
 import type { ModelCapabilities } from '../types/types';
+import type { ServerConfig } from '../types/types';
 /**
  * Hook to resolve tier-based default model config to actual model
  *
@@ -8,13 +9,14 @@ import type { ModelCapabilities } from '../types/types';
  * match for the provider and tier combination.
  *
  * @param defaultModel - The model configuration to resolve
+ * @param serverConfig - Optional server config to build the models endpoint URL
  * @returns The resolved model with provider, model name, and capabilities
  */
 export declare function useResolvedDefaultModel(defaultModel?: {
     provider: string;
     model?: string;
     tier?: 'fast' | 'balanced' | 'powerful';
-}): {
+}, serverConfig?: ServerConfig): {
     provider: string;
     model: string;
     capabilities: ModelCapabilities;

package/dist/server/index.esm.js

@@ -8231,6 +8231,10 @@ function sanitizeFormData(formData, schema) {
         // If schema is provided, use it for validation
         if (schema && schema.properties && schema.properties[key]) {
             const fieldSchema = schema.properties[key];
+            // Skip client-generated fields - they should not be included in formState
+            if (fieldSchema.skip) {
+                return; // Skip this field
+            }
             sanitized[key] = validateAndConvertField(value, fieldSchema);
         }
         else {
@@ -13486,6 +13490,7 @@ ${allRoutesInfo}
 - Match exact field names and types from the chosen schema
 - Respect required vs optional fields
 - If a field has enum values, only use those exact values
+- **DO NOT generate fields marked with skip: true** - these are auto-generated on the client side and should never appear in your suggestions
 
 **🚨 CRITICAL CURRENCY FORMATTING:**
 - ALL currency amounts (amount, buyRate, sellRate) MUST be NUMBERS in CENTS
@@ -13565,6 +13570,7 @@ ${this.formatSchemaFields(singleSchema)}${routesInfo}
 - For nested objects/arrays, follow the nested schema structure
 - If a field has enum values, only use those exact values
 - When suggesting navigation, use the routes defined in the schema above
+- **DO NOT generate fields marked with skip: true** - these are auto-generated on the client side and should never appear in your suggestions
 
 **🚨 CRITICAL CURRENCY FORMATTING:**
 - ALL currency amounts (amount, buyRate, sellRate) MUST be NUMBERS in CENTS
@@ -13589,10 +13595,17 @@ ${additionalContext}
     }
     /**
      * Format schema fields into readable descriptions
+     * Excludes client-generated fields from the output
      */
     formatSchemaFields(schema) {
         const fields = [];
+        const clientGeneratedFields = [];
         for (const [fieldName, fieldDef] of Object.entries(schema.properties || {})) {
+            // Skip client-generated fields - they should not be shown to AI
+            if (typeof fieldDef === 'object' && fieldDef.skip) {
+                clientGeneratedFields.push(fieldName);
+                continue;
+            }
             const required = schema.required?.includes(fieldName) ? '**REQUIRED**' : 'optional';
             const type = typeof fieldDef === 'object' ? fieldDef.type || 'unknown' : 'unknown';
             const description = typeof fieldDef === 'object' ? fieldDef.description || '' : '';
@@ -13601,6 +13614,10 @@ ${additionalContext}
                 : '';
             fields.push(`- **${fieldName}** (${type}) ${required}${enumValues}${description ? `: ${description}` : ''}`);
         }
+        // Add note about client-generated fields if any exist
+        if (clientGeneratedFields.length > 0) {
+            fields.push(`\n**NOTE:** The following fields are auto-generated on the client side and should NOT be included in your suggestions: ${clientGeneratedFields.join(', ')}`);
+        }
         return fields.join('\n');
     }
     /**

package/dist/server/index.js

@@ -8251,6 +8251,10 @@ function sanitizeFormData(formData, schema) {
         // If schema is provided, use it for validation
         if (schema && schema.properties && schema.properties[key]) {
             const fieldSchema = schema.properties[key];
+            // Skip client-generated fields - they should not be included in formState
+            if (fieldSchema.skip) {
+                return; // Skip this field
+            }
             sanitized[key] = validateAndConvertField(value, fieldSchema);
         }
         else {
@@ -13506,6 +13510,7 @@ ${allRoutesInfo}
 - Match exact field names and types from the chosen schema
 - Respect required vs optional fields
 - If a field has enum values, only use those exact values
+- **DO NOT generate fields marked with skip: true** - these are auto-generated on the client side and should never appear in your suggestions
 
 **🚨 CRITICAL CURRENCY FORMATTING:**
 - ALL currency amounts (amount, buyRate, sellRate) MUST be NUMBERS in CENTS
@@ -13585,6 +13590,7 @@ ${this.formatSchemaFields(singleSchema)}${routesInfo}
 - For nested objects/arrays, follow the nested schema structure
 - If a field has enum values, only use those exact values
 - When suggesting navigation, use the routes defined in the schema above
+- **DO NOT generate fields marked with skip: true** - these are auto-generated on the client side and should never appear in your suggestions
 
 **🚨 CRITICAL CURRENCY FORMATTING:**
 - ALL currency amounts (amount, buyRate, sellRate) MUST be NUMBERS in CENTS
@@ -13609,10 +13615,17 @@ ${additionalContext}
     }
     /**
      * Format schema fields into readable descriptions
+     * Excludes client-generated fields from the output
      */
     formatSchemaFields(schema) {
         const fields = [];
+        const clientGeneratedFields = [];
         for (const [fieldName, fieldDef] of Object.entries(schema.properties || {})) {
+            // Skip client-generated fields - they should not be shown to AI
+            if (typeof fieldDef === 'object' && fieldDef.skip) {
+                clientGeneratedFields.push(fieldName);
+                continue;
+            }
             const required = schema.required?.includes(fieldName) ? '**REQUIRED**' : 'optional';
             const type = typeof fieldDef === 'object' ? fieldDef.type || 'unknown' : 'unknown';
             const description = typeof fieldDef === 'object' ? fieldDef.description || '' : '';
@@ -13621,6 +13634,10 @@ ${additionalContext}
                 : '';
             fields.push(`- **${fieldName}** (${type}) ${required}${enumValues}${description ? `: ${description}` : ''}`);
         }
+        // Add note about client-generated fields if any exist
+        if (clientGeneratedFields.length > 0) {
+            fields.push(`\n**NOTE:** The following fields are auto-generated on the client side and should NOT be included in your suggestions: ${clientGeneratedFields.join(', ')}`);
+        }
         return fields.join('\n');
     }
     /**

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

@@ -24,6 +24,7 @@ export declare class ContextualCommandService {
     private buildContextualSystemPrompt;
     /**
      * Format schema fields into readable descriptions
+     * Excludes client-generated fields from the output
      */
     private formatSchemaFields;
     /**

package/dist/server/types/types.d.ts

@@ -134,6 +134,24 @@ export interface ServerConfig {
     additionalContext?: string;
     stayOnPage?: boolean;
 }
+export interface ClientConfig {
+    models?: Record<string, ModelInfo[]>;
+    defaultModel?: {
+        provider: string;
+        model?: string;
+        tier?: 'fast' | 'balanced' | 'powerful';
+    };
+    showUsageStats?: boolean;
+    maxFileSize?: string;
+    features?: {
+        modelSwitching?: boolean;
+        usageTracking?: boolean;
+        imageAnalysis?: boolean;
+        fileUploads?: boolean;
+        enableImageUploads?: boolean;
+    };
+    schemas?: Record<string, SchemaDefinition>;
+}
 export interface TrainingDataPaths {
     components: string[];
     schemas: string[];
@@ -465,6 +483,8 @@ export interface SchemaProperty {
     maxLength?: number;
     minimum?: number;
     maximum?: number;
+    /** If true, this field is not to be generated by AI (e.g. auto-generated fields) */
+    skip?: boolean;
 }
 /**
  * Simplified config for ContextualCommandService

package/dist/types/types.d.ts

@@ -134,6 +134,24 @@ export interface ServerConfig {
     additionalContext?: string;
     stayOnPage?: boolean;
 }
+export interface ClientConfig {
+    models?: Record<string, ModelInfo[]>;
+    defaultModel?: {
+        provider: string;
+        model?: string;
+        tier?: 'fast' | 'balanced' | 'powerful';
+    };
+    showUsageStats?: boolean;
+    maxFileSize?: string;
+    features?: {
+        modelSwitching?: boolean;
+        usageTracking?: boolean;
+        imageAnalysis?: boolean;
+        fileUploads?: boolean;
+        enableImageUploads?: boolean;
+    };
+    schemas?: Record<string, SchemaDefinition>;
+}
 export interface TrainingDataPaths {
     components: string[];
     schemas: string[];
@@ -465,6 +483,8 @@ export interface SchemaProperty {
     maxLength?: number;
     minimum?: number;
     maximum?: number;
+    /** If true, this field is not to be generated by AI (e.g. auto-generated fields) */
+    skip?: boolean;
 }
 /**
  * Simplified config for ContextualCommandService

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "orchid-ai",
-  "version": "1.2.7",
+  "version": "1.3.0",
   "type": "module",
   "description": "AI-powered command processing and chat interface for React applications",
   "main": "dist/index.js",