orchid-ai 1.2.8 → 1.3.1

package/README.md

@@ -119,6 +119,14 @@ npx orchid-generate-schemas init --verbose
 
 See [Schema Generation Guide](docs/SCHEMA_GENERATION.md) for detailed usage.
 
+## Publishing & `orchid-ai/headless`
+
+`npm publish` and `npm pack` run **`prepack`**, which executes **`npm run build`** and **`npm run verify-dist`**. That guarantees the registry tarball includes **`dist/headless.*`**, **`dist/server/*`**, and the main bundle — required for **`import … from 'orchid-ai/headless'`** and **`orchid-ai/server`**.
+
+If you link this repo with **`file:../…`**, run **`npm run build`** in the package after changes so `dist/` is present.
+
+See [Headless usage](docs/HEADLESS.md) for MUI / hooks-only integration.
+
 ## Documentation
 
 - [**Schema Generation**](docs/SCHEMA_GENERATION.md)  

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

@@ -11,6 +11,6 @@ export declare class ErrorBoundary extends Component<Props, State> {
     constructor(props: Props);
     static getDerivedStateFromError(error: Error): State;
     componentDidCatch(error: Error, errorInfo: ErrorInfo): void;
-    render(): string | number | boolean | import("react/jsx-runtime").JSX.Element | Iterable<React.ReactNode> | null | undefined;
+    render(): string | number | boolean | Iterable<React.ReactNode> | import("react/jsx-runtime").JSX.Element | null | undefined;
 }
 export {};

package/dist/cli/headless.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Headless API — streaming hooks, model switching, and shared types/constants
+ * without Tailwind-based components. Build your UI with MUI, plain CSS, etc.
+ *
+ * @example
+ * import { useStreamingAI, useModelSwitcher } from 'orchid-ai/headless';
+ */
+export { useStreamingAI } from './hooks/useStreamingAI';
+export type { StreamingModelSelection } from './hooks/useStreamingAI';
+export { useSuggestions, useDebouncedSuggestions, } from './hooks/useSuggestions';
+export { useResolvedDefaultModel } from './hooks/useResolvedDefaultModel';
+export { useModelSwitcher } from './hooks/useModelSwitcher';
+export { mergeWithAi } from './utils';
+export { useAiMerge } from './hooks/useAiMerge';
+export { ErrorBoundary } from './components/ErrorBoundary';
+export { DEFAULT_CONFIG, DEFAULT_MODELS } from './constants';
+export { defaultTheme as defaultCommandTheme } from './constants';
+export { defaultDarkTheme, defaultLightTheme } from './constants';
+export type { CommandConfig, TrainingData, AIProvider, CommandTheme, CommandSuggestion, CommandPopupProps, ChatMessage, ChatTheme, AIStatus, Action, ModelInfo, ServerConfig, ClientConfig, SchemaDefinition, SchemaProperty, ContextualServiceConfig, ContextualRequest, ModelCapabilities, MessageContent, TextContent, SuggestionsContent, LoadingSuggestionsContent, } from './types/types';

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

@@ -1,5 +1,5 @@
 import { ChatMessage, ModelCapabilities, ServerConfig } from '../types/types';
-interface ModelSelection {
+export interface StreamingModelSelection {
     provider: string;
     model?: string;
     tier?: 'fast' | 'balanced' | 'powerful';
@@ -13,7 +13,7 @@ export declare function useStreamingAI({ userId, serverConfig, formData, chats:
     setChats?: React.Dispatch<React.SetStateAction<Record<string, ChatMessage[]>>>;
     currentChatId?: string;
     setCurrentChatId?: React.Dispatch<React.SetStateAction<string>>;
-    modelSelection?: ModelSelection;
+    modelSelection?: StreamingModelSelection;
     onUsageTracked?: (tokens: number, computeUnits: number) => void;
     chatLevel?: 'full' | 'basic' | 'none';
     additionalContext?: string | Record<string, unknown>;
@@ -27,4 +27,3 @@ export declare function useStreamingAI({ userId, serverConfig, formData, chats:
     newChat: () => void;
     switchChat: (chatId: string) => void;
 };
-export {};

package/dist/cli/index.d.ts

@@ -1,4 +1,5 @@
 export { useStreamingAI } from './hooks/useStreamingAI';
+export type { StreamingModelSelection } from './hooks/useStreamingAI';
 export { useSuggestions, useDebouncedSuggestions, } from './hooks/useSuggestions';
 export { useResolvedDefaultModel } from './hooks/useResolvedDefaultModel';
 export { ChatPanel } from './components/ChatPanel';

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/components/ErrorBoundary.d.ts

@@ -11,6 +11,6 @@ export declare class ErrorBoundary extends Component<Props, State> {
     constructor(props: Props);
     static getDerivedStateFromError(error: Error): State;
     componentDidCatch(error: Error, errorInfo: ErrorInfo): void;
-    render(): string | number | boolean | import("react/jsx-runtime").JSX.Element | Iterable<React.ReactNode> | null | undefined;
+    render(): string | number | boolean | Iterable<React.ReactNode> | import("react/jsx-runtime").JSX.Element | null | undefined;
 }
 export {};

package/dist/headless.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Headless API — streaming hooks, model switching, and shared types/constants
+ * without Tailwind-based components. Build your UI with MUI, plain CSS, etc.
+ *
+ * @example
+ * import { useStreamingAI, useModelSwitcher } from 'orchid-ai/headless';
+ */
+export { useStreamingAI } from './hooks/useStreamingAI';
+export type { StreamingModelSelection } from './hooks/useStreamingAI';
+export { useSuggestions, useDebouncedSuggestions, } from './hooks/useSuggestions';
+export { useResolvedDefaultModel } from './hooks/useResolvedDefaultModel';
+export { useModelSwitcher } from './hooks/useModelSwitcher';
+export { mergeWithAi } from './utils';
+export { useAiMerge } from './hooks/useAiMerge';
+export { ErrorBoundary } from './components/ErrorBoundary';
+export { DEFAULT_CONFIG, DEFAULT_MODELS } from './constants';
+export { defaultTheme as defaultCommandTheme } from './constants';
+export { defaultDarkTheme, defaultLightTheme } from './constants';
+export type { CommandConfig, TrainingData, AIProvider, CommandTheme, CommandSuggestion, CommandPopupProps, ChatMessage, ChatTheme, AIStatus, Action, ModelInfo, ServerConfig, ClientConfig, SchemaDefinition, SchemaProperty, ContextualServiceConfig, ContextualRequest, ModelCapabilities, MessageContent, TextContent, SuggestionsContent, LoadingSuggestionsContent, } from './types/types';