orchid-ai 1.2.8 → 1.3.0

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

@@ -483,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/index.esm.js

@@ -3323,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]
@@ -3350,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) {
@@ -3365,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

@@ -3325,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]
@@ -3352,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) {
@@ -3367,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/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

@@ -483,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

@@ -483,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.8",
+  "version": "1.3.0",
   "type": "module",
   "description": "AI-powered command processing and chat interface for React applications",
   "main": "dist/index.js",