orchid-ai 1.0.0

package/dist/types/types.d.ts

@@ -0,0 +1,481 @@
+export interface CommandSuggestion {
+    action?: string;
+    actionType: Action;
+    path?: string;
+    queryParams?: Record<string, string>;
+    formState?: Record<string, unknown>;
+    message?: string;
+    user?: User;
+    initials?: string;
+    color?: string;
+    shortcut?: string;
+    title?: string;
+    description?: string;
+}
+export interface CommandPopupProps {
+    isOpen: boolean;
+    onClose: () => void;
+    userId: string;
+    setFormState: (state: Record<string, unknown>) => void;
+}
+export interface User {
+    id: string;
+    name: string;
+    email: string;
+    initials: string;
+    color: string;
+}
+export interface CommandTheme {
+    primary: string;
+    primaryHover: string;
+    primaryLight: string;
+    secondary: string;
+    secondaryHover: string;
+    background: string;
+    backgroundSecondary: string;
+    backgroundTertiary: string;
+    textPrimary: string;
+    textSecondary: string;
+    textTertiary: string;
+    textInverse: string;
+    borderPrimary: string;
+    borderSecondary: string;
+    success: string;
+    warning: string;
+    error: string;
+    info: string;
+}
+export interface ChatTheme {
+    colors: {
+        primary: {
+            50: string;
+            100: string;
+            400: string;
+            500: string;
+            600: string;
+            700: string;
+            800: string;
+            900: string;
+        };
+        background: {
+            primary: string;
+            secondary: string;
+            tertiary: string;
+        };
+        text: {
+            primary: string;
+            secondary: string;
+            tertiary: string;
+            inverse: string;
+        };
+        border: {
+            primary: string;
+            secondary: string;
+        };
+        surface: {
+            primary: string;
+            secondary: string;
+            tertiary: string;
+            elevated: string;
+        };
+        state: {
+            error: {
+                background: string;
+                border: string;
+                text: string;
+            };
+            warning: {
+                background: string;
+                border: string;
+                text: string;
+            };
+            success: {
+                background: string;
+                border: string;
+                text: string;
+            };
+        };
+    };
+    spacing: {
+        xs: string;
+        sm: string;
+        md: string;
+        lg: string;
+        xl: string;
+    };
+    borderRadius: {
+        sm: string;
+        md: string;
+        lg: string;
+        full: string;
+    };
+    shadows: {
+        sm: string;
+        md: string;
+        lg: string;
+        xl: string;
+    };
+}
+export type AIProvider = 'openai' | 'claude' | 'google';
+export type Action = 'create' | 'new' | 'edit' | 'update' | 'delete' | 'remove' | 'view';
+export type AIStatus = 'none' | 'suggesting' | 'thinking' | 'typing';
+export type ChatLevel = 'full' | 'basic' | 'none';
+export interface RouteConfig {
+    path: string;
+    title: string;
+    description: string;
+}
+export interface ServerConfig {
+    domain?: string;
+    port?: number;
+    suffix?: string;
+    secure?: boolean;
+    schema?: any;
+    additionalContext?: string;
+    stayOnPage?: boolean;
+}
+export interface TrainingDataPaths {
+    components: string[];
+    schemas: string[];
+    constants: string[];
+    types: string[];
+    api: string[];
+    utils: string[];
+    training: string[];
+}
+export interface TrainingCustomData {
+    instructions?: string;
+    domain?: Record<string, any>;
+    options?: Record<string, any>;
+    businessRules?: Record<string, any>;
+}
+export interface TrainingConfig {
+    filePaths: TrainingDataPaths;
+    routes?: RouteConfig[];
+    customTrainingData?: TrainingCustomData;
+    verboseLogging?: boolean;
+}
+export interface ProcessedTrainingData {
+    components: Array<{
+        filePath: string;
+        content: {
+            componentName: string;
+            props: Array<{
+                name: string;
+                type: string;
+                required: boolean;
+            }>;
+            formFields: string[];
+        };
+    }>;
+    schemas: Array<{
+        filePath: string;
+        content: {
+            modelName: string;
+            fields: Array<{
+                name: string;
+                type: string;
+                required: boolean;
+                dataType: string;
+            }>;
+        };
+    }>;
+    constants: Array<{
+        filePath: string;
+        content: {
+            constValues: Array<{
+                name: string;
+                value: any;
+            }>;
+        };
+    }>;
+    types: Array<{
+        filePath: string;
+        content: {
+            typeName: string;
+            properties: Array<{
+                name: string;
+                type: string;
+                optional: boolean;
+            }>;
+        };
+    }>;
+    routes: RouteConfig[];
+    customTrainingData?: TrainingCustomData;
+}
+export interface TrainingData {
+    filePaths?: TrainingDataPaths;
+    verboseLogging?: boolean;
+    components?: Array<{
+        filePath: string;
+        content: {
+            componentName: string;
+            props: Array<{
+                name: string;
+                type: string;
+                required: boolean;
+            }>;
+            formFields: string[];
+        };
+    }>;
+    schemas?: Array<{
+        filePath: string;
+        content: {
+            modelName: string;
+            fields: Array<{
+                name: string;
+                type: string;
+                required: boolean;
+                dataType: string;
+            }>;
+        };
+    }>;
+    constants?: Array<{
+        filePath: string;
+        content: {
+            constValues: Array<{
+                name: string;
+                value: any;
+            }>;
+        };
+    }>;
+    types?: Array<{
+        filePath: string;
+        content: {
+            typeName: string;
+            properties: Array<{
+                name: string;
+                type: string;
+                optional: boolean;
+            }>;
+        };
+    }>;
+    routes?: RouteConfig[];
+    customTrainingData?: TrainingCustomData;
+}
+export interface AIServiceConfig {
+    providers?: Record<string, {
+        apiKey: string;
+        models: string[];
+    }>;
+    openaiApiKey?: string;
+    claudeApiKey?: string;
+    geminiApiKey?: string;
+    chatLevel?: 'full' | 'basic' | 'none';
+    verboseLogging?: boolean;
+    trainingData?: ProcessedTrainingData;
+    trainingConfig?: TrainingConfig;
+    model?: string | null;
+    maxTokens?: number;
+    temperature?: number;
+    writeConfigToFile?: boolean;
+    baseDir?: string;
+}
+export interface CommandConfig extends AIServiceConfig {
+    service?: AIProvider | null;
+    apiKey?: string | null;
+}
+export interface TextContent {
+    type: 'text';
+    content: string;
+}
+export interface SuggestionsContent {
+    type: 'suggestions';
+    content: CommandSuggestion[];
+}
+export interface LoadingSuggestionsContent {
+    type: 'loading-suggestions';
+    content: string;
+}
+export type MessageContent = TextContent | SuggestionsContent | LoadingSuggestionsContent;
+export interface ChatMessage {
+    sender: 'user' | 'ai' | 'system';
+    content: MessageContent[];
+    action?: string;
+    isLoading?: boolean;
+    aiStatus?: AIStatus;
+    isError?: boolean;
+    errorType?: string;
+    retryAfter?: number;
+    timestamp?: number;
+    files?: File[];
+    suggestions?: CommandSuggestion[];
+}
+export interface ModelCapabilities {
+    supportsImages: boolean;
+    supportsAudio?: boolean;
+    supportsVideo?: boolean;
+    maxTokens?: number;
+    contextWindow?: number;
+    computeWeight?: number;
+}
+export interface CurrentModel {
+    model: string;
+    provider: string;
+}
+export interface ModelInfo {
+    id: string;
+    name: string;
+    provider: string;
+    available: boolean;
+    error?: string;
+    supportsImages: boolean;
+    computeWeight: number;
+    description?: string;
+}
+export interface ProviderStats {
+    name: string;
+    requests: number;
+}
+export interface UsageStats {
+    requests: number;
+    totalTokens: number;
+    totalComputeUnits: number;
+    modelSwitches: number;
+    uptime: number;
+    providers: Array<{
+        name: string;
+        requests: number;
+        computeUnits: number;
+        models: string[];
+    }>;
+    currentProvider: string;
+    currentModel: string;
+}
+export interface Store {
+    ai: {
+        form: Record<string, unknown>;
+        setForm: (state: Record<string, unknown>) => void;
+    };
+}
+export interface ModelSwitcherData {
+    modelsByProvider: Record<string, ModelInfo[]>;
+    currentModel: CurrentModel | null;
+    currentCapabilities: ModelCapabilities | null;
+    usageStats: UsageStats | null;
+    isLoading: boolean;
+    error: string | null;
+    switchModel: (modelId: string, provider: string) => Promise<void>;
+    integrationMode: string;
+}
+export interface ServerOptions extends AIServiceConfig {
+    port?: number;
+    baseDir?: string;
+    service?: AIProvider;
+    apiKey?: string;
+    customTrainingData?: Partial<TrainingCustomData>;
+}
+export interface CommandServer {
+    app: any;
+    start: () => void;
+    stop: () => void;
+    getConfig: () => CommandConfig;
+}
+export interface ApiKeys {
+    openai?: string;
+    claude?: string;
+    gemini?: string;
+    [key: string]: string | undefined;
+}
+export interface DefaultModels {
+    openai: string[];
+    claude: string[];
+    gemini: string[];
+    [key: string]: string[];
+}
+export interface ImageContent {
+    type: string;
+    source?: {
+        type: string;
+        media_type: string;
+        data: string;
+    };
+    image_url?: {
+        url: string;
+    };
+    inlineData?: {
+        mimeType: string;
+        data: string;
+    };
+}
+export interface Provider {
+    apiKey: string;
+    models?: string[];
+}
+export type Intent = 'CORRECTION' | 'COMPLETION' | 'DATA_ENTRY' | 'NAVIGATION' | 'INFORMATION';
+export interface AnalysisContext {
+    entities: Map<string, any>;
+    formStates: Map<string, any>;
+    userPreferences: Map<string, any>;
+    recentActions: string[];
+    intent: Intent;
+    extractedData: Record<string, any>;
+}
+export interface DataType {
+    pattern: RegExp;
+    convert: (value: string) => any;
+}
+/**
+ * JSON Schema definition for data that the AI should generate
+ * This follows JSON Schema specification but simplified for common use cases
+ */
+export interface SchemaDefinition {
+    title?: string;
+    description?: string;
+    type: 'object' | 'array' | 'string' | 'number' | 'boolean';
+    properties?: Record<string, SchemaProperty>;
+    required?: string[];
+    items?: SchemaProperty;
+}
+/**
+ * Individual property definition in a schema
+ */
+export interface SchemaProperty {
+    type: 'string' | 'number' | 'boolean' | 'object' | 'array';
+    description?: string;
+    enum?: string[] | number[];
+    items?: SchemaProperty;
+    properties?: Record<string, SchemaProperty>;
+    required?: string[];
+    default?: any;
+    format?: string;
+    pattern?: string;
+    minLength?: number;
+    maxLength?: number;
+    minimum?: number;
+    maximum?: number;
+}
+/**
+ * Simplified config for ContextualCommandService
+ */
+export interface ContextualServiceConfig {
+    openaiApiKey?: string;
+    claudeApiKey?: string;
+    geminiApiKey?: string;
+    providers?: Record<string, {
+        apiKey: string;
+        models: string[];
+    }>;
+    chatLevel?: 'full' | 'basic' | 'none';
+    temperature?: number;
+    maxTokens?: number;
+    verboseLogging?: boolean;
+}
+/**
+ * Request structure for contextual service
+ */
+export interface ContextualRequest {
+    command: string;
+    schema?: SchemaDefinition;
+    chatHistory?: Array<{
+        role: 'user' | 'assistant';
+        content: string;
+    }>;
+    modelSelection?: {
+        provider: string;
+        model: string;
+    };
+    chatLevel?: 'full' | 'basic' | 'none';
+    additionalContext?: string;
+    images?: any[];
+}

package/dist/utils/fileHandler.d.ts

@@ -0,0 +1,20 @@
+/**
+ * File processing utility
+ */
+export declare const FileHandler: {
+    getAcceptedTypes(): {
+        mimeTypes: string[];
+        extensions: string[];
+        descriptions: string[];
+    };
+    isFileAccepted(file: File): boolean;
+    processFiles(files: File[]): {
+        acceptedFiles: File[];
+        rejectedFiles: File[];
+    };
+    getAcceptedTypesDescription(): string;
+    getInputAcceptAttribute(): string;
+    getFileIcon(file: File): React.ReactNode;
+    formatFileSize(bytes: number): string;
+    getFileTypeDescription(file: File): string;
+};

package/dist/utils/mergeWithAi.d.ts

@@ -0,0 +1,19 @@
+export type MergeConfig<T> = {
+    /**
+     * Map incoming AI keys → draft keys when they differ.
+     * Example: { originCity: 'origin' }
+     */
+    keyMap?: Partial<Record<keyof T | string, keyof T>>;
+    /**
+     * Fine-grained transforms for fields that need more than simple assignment.
+     */
+    transforms?: Partial<Record<keyof T, (val: unknown, draft: T) => unknown>>;
+};
+/**
+ * Generic helper that patches an existing object with an AI-generated payload.
+ *
+ *  • Skips undefined / null values so they never blank user input
+ *  • Coerces strings → numbers when the draft already stores a number
+ *  • Allows per-field key mapping & transform overrides
+ */
+export declare function mergeWithAi<T extends Record<string, unknown>>(draft: T, ai: Partial<T> | Record<string, unknown> | undefined, config?: MergeConfig<T>): T;

package/dist/utils.d.ts

@@ -0,0 +1,19 @@
+export type MergeConfig<T> = {
+    /**
+     * Map incoming AI keys → draft keys when they differ.
+     * Example: { originCity: 'origin' }
+     */
+    keyMap?: Partial<Record<keyof T | string, keyof T>>;
+    /**
+     * Fine-grained transforms for fields that need more than simple assignment.
+     */
+    transforms?: Partial<Record<keyof T, (val: unknown, draft: T) => unknown>>;
+};
+/**
+ * Generic helper that patches an existing object with an AI-generated payload.
+ *
+ *  • Skips undefined / null values so they never blank user input
+ *  • Coerces strings → numbers when the draft already stores a number
+ *  • Allows per-field key mapping & transform overrides
+ */
+export declare function mergeWithAi<T extends Record<string, unknown>>(draft: T, ai: Partial<T> | Record<string, unknown> | undefined, config?: MergeConfig<T>): T;

package/package.json

@@ -0,0 +1,137 @@
+{
+  "name": "orchid-ai",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "AI-powered command processing and chat interface for React applications",
+  "main": "dist/index.js",
+  "module": "dist/index.esm.js",
+  "types": "dist/index.d.ts",
+  "typings": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.esm.js",
+      "require": "./dist/index.js"
+    },
+    "./server": {
+      "types": "./dist/server/index.d.ts",
+      "import": "./dist/server/index.esm.js",
+      "require": "./dist/server/index.js"
+    },
+    "./styles.css": "./dist/styles.css",
+    "./index.css": "./dist/index.css"
+  },
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.d.ts",
+    "dist/**/*.d.ts.map",
+    "dist/**/*.css",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "npm run build:js && npm run build:types",
+    "build:js": "rollup -c",
+    "build:types": "tsc --project tsconfig.build.json --emitDeclarationOnly",
+    "dev": "rollup -c -w",
+    "type-check": "tsc --noEmit",
+    "prepublishOnly": "npm run build",
+    "deploy": "./deploy.sh",
+    "dev:server": "tsx examples/apps/react-min-server/dev-server.js",
+    "dev:server:nitro": "tsx examples/apps/react-min-nitro/server/index.js",
+    "dev:react": "vite examples/apps/react-min-server",
+    "dev:nitro": "cd examples/apps/react-min-nitro && npm run dev:client",
+    "dev:full": "concurrently \"npm run dev:server\" \"npm run dev:react\"",
+    "dev:full:nitro": "concurrently \"npm run dev:server:nitro\" \"npm run dev:nitro\"",
+    "test:themes": "node -e \"console.log('Theme testing utilities available in examples/apps/test-themes.js')\"",
+    "manual:client": "cd examples/apps/react-min-nitro-manual && npm run dev:client",
+    "manual:server": "cd examples/apps/react-min-nitro-manual && npm run dev:server",
+    "manual": "concurrently \"npm run manual:server\" \"npm run manual:client\"",
+    "nitro:client": "cd examples/apps/react-min-nitro-manual && npm run dev:client",
+    "nitro:server": "cd examples/apps/react-min-nitro-manual && npm run dev:server",
+    "nitro": "concurrently \"npm run nitro:server\" \"npm run nitro:client\""
+  },
+  "peerDependencies": {
+    "express": "^4.18.0",
+    "react": "^18.0.0",
+    "react-dom": "^18.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    },
+    "express": {
+      "optional": true
+    },
+    "monastery": {
+      "optional": true
+    },
+    "nitro-web": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.54.0",
+    "@babel/runtime": "^7.27.6",
+    "@google/generative-ai": "^0.24.1",
+    "@types/multer": "^1.4.13",
+    "dotenv": "^16.3.1",
+    "fast-glob": "^3.3.3",
+    "multer": "^2.0.1",
+    "openai": "^5.3.0",
+    "tailwind-merge": "^3.3.1",
+    "ws": "^8.18.2"
+  },
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^25.0.0",
+    "@rollup/plugin-json": "^6.0.0",
+    "@rollup/plugin-node-resolve": "^15.0.0",
+    "@rollup/plugin-typescript": "^11.0.0",
+    "@tailwindcss/postcss": "^4.1.10",
+    "@types/express": "^4.17.0",
+    "@types/react": "^18.0.0",
+    "@types/react-dom": "^18.3.7",
+    "@types/ws": "^8.18.1",
+    "@vitejs/plugin-react": "^4.2.1",
+    "autoprefixer": "^10.4.16",
+    "concurrently": "^9.1.2",
+    "http-server": "^14.1.1",
+    "postcss": "^8.4.32",
+    "postcss-cli": "^11.0.0",
+    "rollup": "^4.0.0",
+    "rollup-plugin-postcss": "^4.0.2",
+    "rollup-plugin-string": "^3.0.0",
+    "tailwindcss": "^3.4.0",
+    "tslib": "^2.8.1",
+    "tsx": "^4.7.0",
+    "typescript": "^5.0.0",
+    "vite": "^5.0.12",
+    "@types/node": "^20.0.0"
+  },
+  "keywords": [
+    "ai",
+    "command",
+    "chat",
+    "react",
+    "openai",
+    "claude",
+    "google-ai",
+    "streaming",
+    "suggestions"
+  ],
+  "author": "Tracform",
+  "license": "MIT",
+  "engines": {
+    "node": "^20"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tracform/command.git"
+  },
+  "bugs": {
+    "url": "https://github.com/tracform/command/issues"
+  },
+  "homepage": "https://github.com/tracform/command#readme"
+}