@krutai/ai-provider 0.2.13 → 0.3.5

package/AI_REFERENCE.md

@@ -3,7 +3,7 @@
 ## Package Overview
 
 - **Name**: `@krutai/ai-provider`
-- **Version**: `0.2.2`
+- **Version**: `0.2.14`
 - **Purpose**: AI provider for KrutAI — fetch-based client for your deployed LangChain server with API key validation
 - **Entry**: `src/index.ts` → `dist/index.{js,mjs,d.ts}`
 - **Build**: `tsup` (CJS + ESM, no external SDK deps)
@@ -11,7 +11,7 @@
 ## Architecture
 
 ```
-@krutai/ai-provider@0.2.2
+@krutai/ai-provider@0.2.14
  └── peerDep: krutai  (core utilities)
 
 AI Flow:
@@ -41,7 +41,7 @@ packages/ai-provider/
 | Endpoint | Method | Body | Response |
 |---|---|---|---|
 | `/validate` | POST | `{ apiKey }` | `{ valid: true/false, message? }` |
-| `/generate` | POST | `{ prompt, model, system?, maxTokens?, temperature? }` | `{ text/content/message: string }` |
+| `/generate` | POST | `{ prompt, model, system?, maxTokens?, temperature?, isStructure?, output_structure?, history?, attachments? }` | `{ text/content/message: string }` or `any` (if structured) |
 | `/stream` | POST | `{ messages, model, system?, maxTokens?, temperature? }` | SSE stream `data: <chunk>` |
 
 All AI endpoints receive `Authorization: Bearer <apiKey>` and `x-api-key: <apiKey>` headers.
@@ -68,6 +68,17 @@ Used to get a single, non-streaming text response from a string prompt.
 ```typescript
 const text = await ai.chat('Write a poem about TypeScript');
 console.log(text);
+
+// Example: Structured Output
+interface UserProfile {
+  name: string;
+  age: number;
+}
+const profile = await ai.chat<UserProfile>('Generate a profile for John Doe', {
+  isStructure: true,
+  output_structure: ['name', 'age'] // or a JSON Schema
+});
+console.log(profile.name, profile.age);
 ```
 
 ### 2. `streamChatResponse(messages: ChatMessage[])` — Multi-Turn & Streaming
@@ -102,7 +113,7 @@ import { KrutAIProvider } from '@krutai/ai-provider';
 const ai = new KrutAIProvider({
   apiKey: process.env.KRUTAI_API_KEY!,
   // serverUrl: 'https://krut.ai', // Optional: defaults to localhost:8000
-  model: 'gpt-4o',         // optional, default: 'default'
+  model: 'gemini-3.1-pro-preview',         // optional, default: 'default'
   validateOnInit: true,     // default: true
 });
 
@@ -151,6 +162,10 @@ interface GenerateOptions {
   images?: string[];     // Array of image URLs or base64 data URIs
   documents?: string[];  // Array of document URLs or base64 data URIs
   pdf?: string[];        // Array of PDF URLs or base64 data URIs
+  history?: ChatMessage[]; // Optional: conversation history
+  attachments?: any[];    // Optional: multimodal attachments
+  isStructure?: boolean;   // Whether to return structured output
+  output_structure?: any;  // The schema (JSON Schema or field array) for structured output
 }
 ```
 

package/README.md

@@ -42,7 +42,7 @@ console.log(text);
 const ai = krutAI({
   apiKey: process.env.KRUTAI_API_KEY!,
   serverUrl: 'https://krut.ai', // Override default for production
-  model: 'gpt-4o', // optional — server's default is used if omitted
+  model: 'gemini-3.1-pro-preview', // optional — server's default is used if omitted
 });
 
 await ai.initialize();
@@ -93,7 +93,7 @@ const response = await ai.chat([
     ]
   }
 ], { 
-  model: 'gpt-4o',
+  model: 'gemini-3.1-pro-preview',
   // You can also pass images, documents, or pdfs via GenerateOptions
   images: ['https://example.com/photo.jpg'],
   documents: ['https://example.com/doc.docx'],
@@ -139,6 +139,26 @@ if (reader) {
 }
 ```
 
+### Structured Output
+
+You can request the AI to return data in a specific JSON structure (e.g. for generating models, summaries, or profiles).
+
+```typescript
+interface Profile {
+  name: string;
+  age: number;
+}
+
+const profile = await ai.chat<Profile>('Generate a profile for John Doe', {
+  isStructure: true,
+  // Pass an array of field names for simple string objects...
+  output_structure: ['name', 'age'], 
+  // ...or pass a full JSON Schema for complex objects
+});
+
+console.log(profile.name, profile.age);
+```
+
 ### Skip validation (useful for tests)
 
 ```typescript
@@ -159,7 +179,7 @@ Your LangChain server must expose these endpoints:
 | Endpoint | Method | Auth | Body |
 |---|---|---|---|
 | `/validate` | POST | `x-api-key` header | `{ "apiKey": "..." }` |
-| `/generate` | POST | `Authorization: Bearer <key>` | `{ "prompt": "...", "model": "...", ... }` |
+| `/generate` | POST | `Authorization: Bearer <key>` | `{ "prompt": "...", "isStructure": boolean, "output_structure": any, ... }` |
 | `/stream` | POST | `Authorization: Bearer <key>` | `{ "messages": [...], "model": "...", ... }` |
 
 **Validation response:** `{ "valid": true }` or `{ "valid": false, "message": "reason" }`

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-export { ApiKeyValidationError as KrutAIKeyValidationError, validateApiKeyWithService as validateApiKey, validateApiKeyFormat } from 'krutai';
+export { KrutAIKeyValidationError, validateApiKeyWithService as validateApiKey, validateApiKeyFormat } from 'krutai';
 
 /**
  * Types for @krutai/ai-provider
@@ -7,7 +7,57 @@ export { ApiKeyValidationError as KrutAIKeyValidationError, validateApiKeyWithSe
  * Default model identifier sent to the LangChain server when no model is specified.
  * Your server can use this value to route to its own default model.
  */
-declare const DEFAULT_MODEL: "default";
+declare const DEFAULT_MODEL: "gemini-3.1-pro-preview";
+interface DataRecord {
+    [key: string]: unknown;
+}
+interface FileSchema {
+    name: string;
+    rowCount: number;
+    columns: string[];
+    sample: DataRecord[];
+}
+interface ComparisonSummary {
+    totalRows: number;
+    differencesFound: number;
+    matchesFound: number;
+    status: string;
+}
+interface ComparisonCodeResult {
+    code: string;
+    humanExplanation: string[];
+    constants?: Record<string, unknown>;
+}
+interface ComparisonResult {
+    summary: ComparisonSummary;
+    metadata?: {
+        file1Columns?: string[];
+        file2Columns?: string[];
+        executionTime?: number;
+    };
+}
+interface ComparisonResponse {
+    success: boolean;
+    result?: ComparisonResult;
+    generatedCode?: string;
+    humanExplanation?: string[];
+    downloadUrl?: string;
+    fileName?: string;
+    error?: string;
+}
+interface PreviewResponse {
+    success: boolean;
+    file1?: FileSchema;
+    file2?: FileSchema;
+    error?: string;
+}
+interface GenerateCodeOptions {
+    prompt?: string;
+}
+interface CompareFilesOptions {
+    code: string;
+    prompt?: string;
+}
 /**
  * Configuration options for KrutAIProvider
  */
@@ -92,6 +142,23 @@ interface GenerateOptions {
      * Array of PDF URLs or base64 data URIs to include with the request.
      */
     pdf?: string[];
+    /**
+     * Optional conversation history.
+     */
+    history?: ChatMessage[];
+    /**
+     * Optional attachments.
+     */
+    attachments?: any[];
+    /**
+     * Whether to return structured output.
+     */
+    isStructure?: boolean;
+    /**
+     * The schema for structured output.
+     * Can be a JSON Schema object or an array of field names.
+     */
+    output_structure?: any;
 }
 
 /**
@@ -164,9 +231,9 @@ declare class KrutAIProvider {
      *
      * @param prompt - The user prompt string
      * @param options - Optional overrides (model, system, maxTokens, temperature)
-     * @returns The assistant's response text
+     * @returns The assistant's response text (or an object if structured)
      */
-    chat(prompt: string, options?: GenerateOptions): Promise<string>;
+    chat<T = any>(prompt: string, options?: GenerateOptions): Promise<T>;
 }
 
 /**
@@ -195,7 +262,7 @@ declare class KrutAIProvider {
  * const ai = krutAI({
  *   apiKey: process.env.KRUTAI_API_KEY!,
  *   serverUrl: 'https://krut.ai',
- *   model: 'gpt-4o',
+ *   model: 'gemini-3.1-pro-preview',
  * });
  * await ai.initialize();
  * const text = await ai.chat('Hello!');
@@ -240,6 +307,6 @@ declare class KrutAIProvider {
 declare function krutAI(config: KrutAIProviderConfig & {
     model?: string;
 }): KrutAIProvider;
-declare const VERSION = "0.2.0";
+declare const VERSION = "0.3.4";
 
-export { type ChatMessage, DEFAULT_MODEL, type GenerateOptions, KrutAIProvider, type KrutAIProviderConfig, VERSION, krutAI };
+export { type ChatMessage, type CompareFilesOptions, type ComparisonCodeResult, type ComparisonResponse, type ComparisonResult, type ComparisonSummary, DEFAULT_MODEL, type DataRecord, type FileSchema, type GenerateCodeOptions, type GenerateOptions, KrutAIProvider, type KrutAIProviderConfig, type PreviewResponse, VERSION, krutAI };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { ApiKeyValidationError as KrutAIKeyValidationError, validateApiKeyWithService as validateApiKey, validateApiKeyFormat } from 'krutai';
+export { KrutAIKeyValidationError, validateApiKeyWithService as validateApiKey, validateApiKeyFormat } from 'krutai';
 
 /**
  * Types for @krutai/ai-provider
@@ -7,7 +7,57 @@ export { ApiKeyValidationError as KrutAIKeyValidationError, validateApiKeyWithSe
  * Default model identifier sent to the LangChain server when no model is specified.
  * Your server can use this value to route to its own default model.
  */
-declare const DEFAULT_MODEL: "default";
+declare const DEFAULT_MODEL: "gemini-3.1-pro-preview";
+interface DataRecord {
+    [key: string]: unknown;
+}
+interface FileSchema {
+    name: string;
+    rowCount: number;
+    columns: string[];
+    sample: DataRecord[];
+}
+interface ComparisonSummary {
+    totalRows: number;
+    differencesFound: number;
+    matchesFound: number;
+    status: string;
+}
+interface ComparisonCodeResult {
+    code: string;
+    humanExplanation: string[];
+    constants?: Record<string, unknown>;
+}
+interface ComparisonResult {
+    summary: ComparisonSummary;
+    metadata?: {
+        file1Columns?: string[];
+        file2Columns?: string[];
+        executionTime?: number;
+    };
+}
+interface ComparisonResponse {
+    success: boolean;
+    result?: ComparisonResult;
+    generatedCode?: string;
+    humanExplanation?: string[];
+    downloadUrl?: string;
+    fileName?: string;
+    error?: string;
+}
+interface PreviewResponse {
+    success: boolean;
+    file1?: FileSchema;
+    file2?: FileSchema;
+    error?: string;
+}
+interface GenerateCodeOptions {
+    prompt?: string;
+}
+interface CompareFilesOptions {
+    code: string;
+    prompt?: string;
+}
 /**
  * Configuration options for KrutAIProvider
  */
@@ -92,6 +142,23 @@ interface GenerateOptions {
      * Array of PDF URLs or base64 data URIs to include with the request.
      */
     pdf?: string[];
+    /**
+     * Optional conversation history.
+     */
+    history?: ChatMessage[];
+    /**
+     * Optional attachments.
+     */
+    attachments?: any[];
+    /**
+     * Whether to return structured output.
+     */
+    isStructure?: boolean;
+    /**
+     * The schema for structured output.
+     * Can be a JSON Schema object or an array of field names.
+     */
+    output_structure?: any;
 }
 
 /**
@@ -164,9 +231,9 @@ declare class KrutAIProvider {
      *
      * @param prompt - The user prompt string
      * @param options - Optional overrides (model, system, maxTokens, temperature)
-     * @returns The assistant's response text
+     * @returns The assistant's response text (or an object if structured)
      */
-    chat(prompt: string, options?: GenerateOptions): Promise<string>;
+    chat<T = any>(prompt: string, options?: GenerateOptions): Promise<T>;
 }
 
 /**
@@ -195,7 +262,7 @@ declare class KrutAIProvider {
  * const ai = krutAI({
  *   apiKey: process.env.KRUTAI_API_KEY!,
  *   serverUrl: 'https://krut.ai',
- *   model: 'gpt-4o',
+ *   model: 'gemini-3.1-pro-preview',
  * });
  * await ai.initialize();
  * const text = await ai.chat('Hello!');
@@ -240,6 +307,6 @@ declare class KrutAIProvider {
 declare function krutAI(config: KrutAIProviderConfig & {
     model?: string;
 }): KrutAIProvider;
-declare const VERSION = "0.2.0";
+declare const VERSION = "0.3.4";
 
-export { type ChatMessage, DEFAULT_MODEL, type GenerateOptions, KrutAIProvider, type KrutAIProviderConfig, VERSION, krutAI };
+export { type ChatMessage, type CompareFilesOptions, type ComparisonCodeResult, type ComparisonResponse, type ComparisonResult, type ComparisonSummary, DEFAULT_MODEL, type DataRecord, type FileSchema, type GenerateCodeOptions, type GenerateOptions, KrutAIProvider, type KrutAIProviderConfig, type PreviewResponse, VERSION, krutAI };

package/dist/index.js

@@ -3,7 +3,7 @@
 var krutai = require('krutai');
 
 // src/types.ts
-var DEFAULT_MODEL = "default";
+var DEFAULT_MODEL = "gemini-3.1-pro-preview";
 var DEFAULT_SERVER_URL = "http://localhost:8000";
 var KrutAIProvider = class {
   apiKey;
@@ -30,7 +30,7 @@ var KrutAIProvider = class {
   async initialize() {
     if (this.initialized) return;
     if (this.config.validateOnInit !== false) {
-      await krutai.validateApiKeyWithService(this.apiKey, this.serverUrl);
+      await krutai.validateApiKey(this.apiKey, this.serverUrl);
     }
     this.initialized = true;
   }
@@ -119,7 +119,7 @@ var KrutAIProvider = class {
    *
    * @param prompt - The user prompt string
    * @param options - Optional overrides (model, system, maxTokens, temperature)
-   * @returns The assistant's response text
+   * @returns The assistant's response text (or an object if structured)
    */
   async chat(prompt, options = {}) {
     this.assertInitialized();
@@ -135,7 +135,11 @@ var KrutAIProvider = class {
         ...options.documents !== void 0 ? { documents: options.documents } : {},
         ...options.pdf !== void 0 ? { pdf: options.pdf } : {},
         ...options.maxTokens !== void 0 ? { maxTokens: options.maxTokens } : {},
-        ...options.temperature !== void 0 ? { temperature: options.temperature } : {}
+        ...options.temperature !== void 0 ? { temperature: options.temperature } : {},
+        ...options.isStructure !== void 0 ? { isStructure: options.isStructure } : {},
+        ...options.output_structure !== void 0 ? { output_structure: options.output_structure } : {},
+        ...options.history !== void 0 ? { history: options.history } : {},
+        ...options.attachments !== void 0 ? { attachments: options.attachments } : {}
       })
     });
     if (!response.ok) {
@@ -149,6 +153,9 @@ var KrutAIProvider = class {
       throw new Error(errorMessage);
     }
     const data = await response.json();
+    if (options.isStructure) {
+      return data;
+    }
     return data.text ?? data.content ?? data.message ?? "";
   }
 };
@@ -158,11 +165,11 @@ function krutAI(config) {
     ...config
   });
 }
-var VERSION = "0.2.0";
+var VERSION = "0.3.4";
 
 Object.defineProperty(exports, "KrutAIKeyValidationError", {
   enumerable: true,
-  get: function () { return krutai.ApiKeyValidationError; }
+  get: function () { return krutai.KrutAIKeyValidationError; }
 });
 Object.defineProperty(exports, "validateApiKey", {
   enumerable: true,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/types.ts","../src/client.ts","../src/index.ts"],"names":["validateApiKeyFormat","validateApiKey"],"mappings":";;;;;AAQO,IAAM,aAAA,GAAgB;AAMtB,IAAM,kBAAA,GAAqB,uBAAA;ACuB3B,IAAM,iBAAN,MAAqB;AAAA,EACP,MAAA;AAAA,EACA,SAAA;AAAA,EACA,aAAA;AAAA,EACA,MAAA;AAAA,EAET,WAAA,GAAc,KAAA;AAAA,EAEtB,YAAY,MAAA,EAA8B;AACtC,IAAA,IAAA,CAAK,MAAA,GAAS,MAAA;AACd,IAAA,IAAA,CAAK,MAAA,GAAS,MAAA,CAAO,MAAA,IAAU,OAAA,CAAQ,IAAI,cAAA,IAAkB,EAAA;AAC7D,IAAA,IAAA,CAAK,aAAa,MAAA,CAAO,SAAA,IAAa,kBAAA,EAAoB,OAAA,CAAQ,OAAO,EAAE,CAAA;AAC3E,IAAA,IAAA,CAAK,aAAA,GAAgB,OAAO,KAAA,IAAS,aAAA;AAGrC,IAAAA,2BAAA,CAAqB,KAAK,MAAM,CAAA;AAGhC,IAAA,IAAI,MAAA,CAAO,mBAAmB,KAAA,EAAO;AACjC,MAAA,IAAA,CAAK,WAAA,GAAc,IAAA;AAAA,IACvB;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,UAAA,GAA4B;AAC9B,IAAA,IAAI,KAAK,WAAA,EAAa;AAEtB,IAAA,IAAI,IAAA,CAAK,MAAA,CAAO,cAAA,KAAmB,KAAA,EAAO;AACtC,MAAA,MAAMC,gCAAA,CAAe,IAAA,CAAK,MAAA,EAAQ,IAAA,CAAK,SAAS,CAAA;AAAA,IACpD;AAEA,IAAA,IAAA,CAAK,WAAA,GAAc,IAAA;AAAA,EACvB;AAAA;AAAA;AAAA;AAAA,EAKA,QAAA,GAAmB;AACf,IAAA,OAAO,IAAA,CAAK,aAAA;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA,EAKA,aAAA,GAAyB;AACrB,IAAA,OAAO,IAAA,CAAK,WAAA;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA,EAMQ,iBAAA,GAA0B;AAC9B,IAAA,IAAI,CAAC,KAAK,WAAA,EAAa;AACnB,MAAA,MAAM,IAAI,KAAA;AAAA,QACN;AAAA,OACJ;AAAA,IACJ;AAAA,EACJ;AAAA;AAAA,EAGQ,WAAA,GAAsC;AAC1C,IAAA,OAAO;AAAA,MACH,cAAA,EAAgB,kBAAA;AAAA,MAChB,aAAA,EAAe,CAAA,OAAA,EAAU,IAAA,CAAK,MAAM,CAAA,CAAA;AAAA,MACpC,aAAa,IAAA,CAAK;AAAA,KACtB;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,MAAM,kBAAA,CAAmB,QAAA,EAAyB,OAAA,GAA2B,EAAC,EAAsB;AAChG,IAAA,IAAA,CAAK,iBAAA,EAAkB;AAEvB,IAAA,IAAI,CAAC,SAAS,MAAA,EAAQ;AAClB,MAAA,MAAM,IAAI,MAAM,uDAAuD,CAAA;AAAA,IAC3E;AAEA,IAAA,MAAM,KAAA,GAAQ,OAAA,CAAQ,KAAA,IAAS,IAAA,CAAK,aAAA;AAEpC,IAAA,MAAM,WAAW,MAAM,KAAA,CAAM,CAAA,EAAG,IAAA,CAAK,SAAS,CAAA,OAAA,CAAA,EAAW;AAAA,MACrD,MAAA,EAAQ,MAAA;AAAA,MACR,OAAA,EAAS;AAAA,QACL,GAAG,KAAK,WAAA,EAAY;AAAA,QACpB,MAAA,EAAQ;AAAA,OACZ;AAAA,MACA,IAAA,EAAM,KAAK,SAAA,CAAU;AAAA,QACjB,QAAA;AAAA,QACA,KAAA;AAAA,QACA,GAAI,QAAQ,MAAA,KAAW,MAAA,GAAY,EAAE,MAAA,EAAQ,OAAA,CAAQ,MAAA,EAAO,GAAI,EAAC;AAAA,QACjE,GAAI,QAAQ,MAAA,KAAW,MAAA,GAAY,EAAE,MAAA,EAAQ,OAAA,CAAQ,MAAA,EAAO,GAAI,EAAC;AAAA,QACjE,GAAI,QAAQ,SAAA,KAAc,MAAA,GAAY,EAAE,SAAA,EAAW,OAAA,CAAQ,SAAA,EAAU,GAAI,EAAC;AAAA,QAC1E,GAAI,QAAQ,GAAA,KAAQ,MAAA,GAAY,EAAE,GAAA,EAAK,OAAA,CAAQ,GAAA,EAAI,GAAI,EAAC;AAAA,QACxD,GAAI,QAAQ,SAAA,KAAc,MAAA,GAAY,EAAE,SAAA,EAAW,OAAA,CAAQ,SAAA,EAAU,GAAI,EAAC;AAAA,QAC1E,GAAI,QAAQ,WAAA,KAAgB,MAAA,GAAY,EAAE,WAAA,EAAa,OAAA,CAAQ,WAAA,EAAY,GAAI;AAAC,OACnF;AAAA,KACJ,CAAA;AAED,IAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AACd,MAAA,IAAI,YAAA,GAAe,CAAA,wBAAA,EAA2B,QAAA,CAAS,MAAM,CAAA,YAAA,CAAA;AAC7D,MAAA,IAAI;AACA,QAAA,MAAM,SAAA,GAAa,MAAM,QAAA,CAAS,IAAA,EAAK;AACvC,QAAA,IAAI,SAAA,EAAW,KAAA,EAAO,YAAA,GAAe,SAAA,CAAU,KAAA;AAAA,aAAA,IACtC,SAAA,EAAW,OAAA,EAAS,YAAA,GAAe,SAAA,CAAU,OAAA;AAAA,MAC1D,CAAA,CAAA,MAAQ;AAAA,MAAE;AACV,MAAA,MAAM,IAAI,MAAM,YAAY,CAAA;AAAA,IAChC;AAEA,IAAA,OAAO,QAAA;AAAA,EACX;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAaA,MAAM,IAAA,CAAK,MAAA,EAAgB,OAAA,GAA2B,EAAC,EAAoB;AACvE,IAAA,IAAA,CAAK,iBAAA,EAAkB;AACvB,IAAA,MAAM,KAAA,GAAQ,OAAA,CAAQ,KAAA,IAAS,IAAA,CAAK,aAAA;AAEpC,IAAA,MAAM,WAAW,MAAM,KAAA,CAAM,CAAA,EAAG,IAAA,CAAK,SAAS,CAAA,SAAA,CAAA,EAAa;AAAA,MACvD,MAAA,EAAQ,MAAA;AAAA,MACR,OAAA,EAAS,KAAK,WAAA,EAAY;AAAA,MAC1B,IAAA,EAAM,KAAK,SAAA,CAAU;AAAA,QACjB,MAAA;AAAA,QACA,KAAA;AAAA,QACA,GAAI,QAAQ,MAAA,KAAW,MAAA,GAAY,EAAE,MAAA,EAAQ,OAAA,CAAQ,MAAA,EAAO,GAAI,EAAC;AAAA,QACjE,GAAI,QAAQ,MAAA,KAAW,MAAA,GAAY,EAAE,MAAA,EAAQ,OAAA,CAAQ,MAAA,EAAO,GAAI,EAAC;AAAA,QACjE,GAAI,QAAQ,SAAA,KAAc,MAAA,GAAY,EAAE,SAAA,EAAW,OAAA,CAAQ,SAAA,EAAU,GAAI,EAAC;AAAA,QAC1E,GAAI,QAAQ,GAAA,KAAQ,MAAA,GAAY,EAAE,GAAA,EAAK,OAAA,CAAQ,GAAA,EAAI,GAAI,EAAC;AAAA,QACxD,GAAI,QAAQ,SAAA,KAAc,MAAA,GAAY,EAAE,SAAA,EAAW,OAAA,CAAQ,SAAA,EAAU,GAAI,EAAC;AAAA,QAC1E,GAAI,QAAQ,WAAA,KAAgB,MAAA,GAAY,EAAE,WAAA,EAAa,OAAA,CAAQ,WAAA,EAAY,GAAI;AAAC,OACnF;AAAA,KACJ,CAAA;AAED,IAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AACd,MAAA,IAAI,YAAA,GAAe,CAAA,wBAAA,EAA2B,QAAA,CAAS,MAAM,CAAA,cAAA,CAAA;AAC7D,MAAA,IAAI;AACA,QAAA,MAAM,SAAA,GAAa,MAAM,QAAA,CAAS,IAAA,EAAK;AACvC,QAAA,IAAI,SAAA,EAAW,KAAA,EAAO,YAAA,GAAe,SAAA,CAAU,KAAA;AAAA,aAAA,IACtC,SAAA,EAAW,OAAA,EAAS,YAAA,GAAe,SAAA,CAAU,OAAA;AAAA,MAC1D,CAAA,CAAA,MAAQ;AAAA,MAAE;AACV,MAAA,MAAM,IAAI,MAAM,YAAY,CAAA;AAAA,IAChC;AAEA,IAAA,MAAM,IAAA,GAAQ,MAAM,QAAA,CAAS,IAAA,EAAK;AAMlC,IAAA,OAAO,IAAA,CAAK,IAAA,IAAQ,IAAA,CAAK,OAAA,IAAW,KAAK,OAAA,IAAW,EAAA;AAAA,EACxD;AACJ;AClIO,SAAS,OACZ,MAAA,EACc;AACd,EAAA,OAAO,IAAI,cAAA,CAAe;AAAA,IACtB,KAAA,EAAO,aAAA;AAAA,IACP,GAAG;AAAA,GACN,CAAA;AACL;AAGO,IAAM,OAAA,GAAU","file":"index.js","sourcesContent":["/**\n * Types for @krutai/ai-provider\n */\n\n/**\n * Default model identifier sent to the LangChain server when no model is specified.\n * Your server can use this value to route to its own default model.\n */\nexport const DEFAULT_MODEL = 'default' as const;\n\n/**\n * Default base URL for the LangChain backend server.\n * Used when no serverUrl is provided in the config.\n */\nexport const DEFAULT_SERVER_URL = 'http://localhost:8000' as const;\n\n/**\n * Configuration options for KrutAIProvider\n */\nexport interface KrutAIProviderConfig {\n    /**\n     * KrutAI API key.\n     * Validated against the LangChain server before use.\n     * Optional: defaults to process.env.KRUTAI_API_KEY\n     */\n    apiKey?: string;\n\n    /**\n     * Base URL of your deployed LangChain backend server.\n     * @default \"http://localhost:8000\"\n     * @example \"https://ai.krut.ai\"\n     */\n    serverUrl?: string;\n\n    /**\n     * The AI model to use (passed to the server).\n     * The server decides what to do with this value.\n     * @default \"default\"\n     */\n    model?: string;\n\n    /**\n     * Whether to validate the API key against the server on initialization.\n     * Set to false to skip the validation round-trip (e.g. in tests).\n     * @default true\n     */\n    validateOnInit?: boolean;\n}\n\n/**\n * A part of a multimodal message\n */\nexport interface TextContentPart {\n    type: 'text';\n    text: string;\n}\n\nexport interface ImageContentPart {\n    type: 'image_url';\n    image_url: {\n        url: string; // Base64 data URI or HTTP(S) URL\n        detail?: 'low' | 'high' | 'auto';\n    };\n}\n\nexport type ContentPart = TextContentPart | ImageContentPart;\nexport type MessageContent = string | ContentPart[];\n\n/**\n * A single chat message\n */\nexport interface ChatMessage {\n    role: 'user' | 'assistant' | 'system';\n    content: MessageContent;\n}\n\n/**\n * Options for a single generate / stream / chat call\n */\nexport interface GenerateOptions {\n    /**\n     * Override the model for this specific call.\n     */\n    model?: string;\n\n    /**\n     * System prompt (prepended as a system message).\n     */\n    system?: string;\n\n    /**\n     * Maximum tokens to generate.\n     */\n    maxTokens?: number;\n\n    /**\n     * Temperature (0–2).\n     */\n    temperature?: number;\n\n    /**\n     * Array of image URLs or base64 data URIs to include with the request.\n     */\n    images?: string[];\n\n    /**\n     * Array of document URLs or base64 data URIs (e.g. PDFs) to include with the request.\n     */\n    documents?: string[];\n\n    /**\n     * Array of PDF URLs or base64 data URIs to include with the request.\n     */\n    pdf?: string[];\n}\n","import type { KrutAIProviderConfig, GenerateOptions, ChatMessage } from './types';\nimport { DEFAULT_MODEL, DEFAULT_SERVER_URL } from './types';\nimport {\n    validateApiKeyWithService as validateApiKey,\n    validateApiKeyFormat,\n    ApiKeyValidationError as KrutAIKeyValidationError,\n} from 'krutai';\n\nexport { KrutAIKeyValidationError };\n\n/**\n * KrutAIProvider — fetch-based AI provider for KrutAI\n *\n * Calls your deployed LangChain backend server for all AI operations.\n * The API key is validated against the server before use.\n *\n * @example\n * ```typescript\n * import { KrutAIProvider } from '@krutai/ai-provider';\n *\n * // Using local dev server (http://localhost:8000 by default)\n * const ai = new KrutAIProvider({\n *   apiKey: process.env.KRUTAI_API_KEY!,\n * });\n *\n * // Or point to a production server\n * const aiProd = new KrutAIProvider({\n *   apiKey: process.env.KRUTAI_API_KEY!,\n *   serverUrl: 'https://ai.krut.ai',\n * });\n *\n * await ai.initialize(); // validates key against server\n *\n * const text = await ai.generate('Tell me a joke');\n * console.log(text);\n * ```\n */\nexport class KrutAIProvider {\n    private readonly apiKey: string;\n    private readonly serverUrl: string;\n    private readonly resolvedModel: string;\n    private readonly config: KrutAIProviderConfig;\n\n    private initialized = false;\n\n    constructor(config: KrutAIProviderConfig) {\n        this.config = config;\n        this.apiKey = config.apiKey || process.env.KRUTAI_API_KEY || '';\n        this.serverUrl = (config.serverUrl ?? DEFAULT_SERVER_URL).replace(/\\/$/, ''); // strip trailing slash\n        this.resolvedModel = config.model ?? DEFAULT_MODEL;\n\n        // Basic format check immediately on construction\n        validateApiKeyFormat(this.apiKey);\n\n        // If validation is disabled, mark as ready immediately\n        if (config.validateOnInit === false) {\n            this.initialized = true;\n        }\n    }\n\n    /**\n     * Initialize the provider.\n     * Validates the API key against the LangChain server, then marks provider as ready.\n     *\n     * @throws {KrutAIKeyValidationError} if the key is rejected or the server is unreachable\n     */\n    async initialize(): Promise<void> {\n        if (this.initialized) return;\n\n        if (this.config.validateOnInit !== false) {\n            await validateApiKey(this.apiKey, this.serverUrl);\n        }\n\n        this.initialized = true;\n    }\n\n    /**\n     * Returns the currently configured default model.\n     */\n    getModel(): string {\n        return this.resolvedModel;\n    }\n\n    /**\n     * Returns whether the provider has been initialized.\n     */\n    isInitialized(): boolean {\n        return this.initialized;\n    }\n\n    // ---------------------------------------------------------------------------\n    // Private helpers\n    // ---------------------------------------------------------------------------\n\n    private assertInitialized(): void {\n        if (!this.initialized) {\n            throw new Error(\n                'KrutAIProvider not initialized. Call initialize() first or set validateOnInit to false.'\n            );\n        }\n    }\n\n    /** Common request headers sent to the server on every AI call. */\n    private authHeaders(): Record<string, string> {\n        return {\n            'Content-Type': 'application/json',\n            Authorization: `Bearer ${this.apiKey}`,\n            'x-api-key': this.apiKey,\n        };\n    }\n\n    // ---------------------------------------------------------------------------\n    // Public AI Methods\n    // ---------------------------------------------------------------------------\n\n    /**\n     * Similar to streamChat() but returns the raw fetch Response object.\n     * Useful for proxying the Server-Sent Events stream directly to a frontend client.\n     *\n     * @param messages - Full conversation history\n     * @param options - Optional overrides (model, maxTokens, temperature)\n     * @returns A Promise resolving to the native fetch Response\n     */\n    async streamChatResponse(messages: ChatMessage[], options: GenerateOptions = {}): Promise<Response> {\n        this.assertInitialized();\n\n        if (!messages.length) {\n            throw new Error('Messages array cannot be empty for streamChatResponse');\n        }\n\n        const model = options.model ?? this.resolvedModel;\n\n        const response = await fetch(`${this.serverUrl}/stream`, {\n            method: 'POST',\n            headers: {\n                ...this.authHeaders(),\n                Accept: 'text/event-stream',\n            },\n            body: JSON.stringify({\n                messages,\n                model,\n                ...(options.system !== undefined ? { system: options.system } : {}),\n                ...(options.images !== undefined ? { images: options.images } : {}),\n                ...(options.documents !== undefined ? { documents: options.documents } : {}),\n                ...(options.pdf !== undefined ? { pdf: options.pdf } : {}),\n                ...(options.maxTokens !== undefined ? { maxTokens: options.maxTokens } : {}),\n                ...(options.temperature !== undefined ? { temperature: options.temperature } : {}),\n            }),\n        });\n\n        if (!response.ok) {\n            let errorMessage = `AI server returned HTTP ${response.status} for /stream`;\n            try {\n                const errorData = (await response.json()) as { message?: string; error?: string };\n                if (errorData?.error) errorMessage = errorData.error;\n                else if (errorData?.message) errorMessage = errorData.message;\n            } catch { }\n            throw new Error(errorMessage);\n        }\n\n        return response;\n    }\n\n    /**\n     * Generate a response for a prompt (non-streaming).\n     *\n     * Calls: POST {serverUrl}/generate\n     * Body:  { prompt, model, system?, maxTokens?, temperature? }\n     * Expected response: { text: string } or { content: string } or { message: string }\n     *\n     * @param prompt - The user prompt string\n     * @param options - Optional overrides (model, system, maxTokens, temperature)\n     * @returns The assistant's response text\n     */\n    async chat(prompt: string, options: GenerateOptions = {}): Promise<string> {\n        this.assertInitialized();\n        const model = options.model ?? this.resolvedModel;\n\n        const response = await fetch(`${this.serverUrl}/generate`, {\n            method: 'POST',\n            headers: this.authHeaders(),\n            body: JSON.stringify({\n                prompt,\n                model,\n                ...(options.system !== undefined ? { system: options.system } : {}),\n                ...(options.images !== undefined ? { images: options.images } : {}),\n                ...(options.documents !== undefined ? { documents: options.documents } : {}),\n                ...(options.pdf !== undefined ? { pdf: options.pdf } : {}),\n                ...(options.maxTokens !== undefined ? { maxTokens: options.maxTokens } : {}),\n                ...(options.temperature !== undefined ? { temperature: options.temperature } : {}),\n            }),\n        });\n\n        if (!response.ok) {\n            let errorMessage = `AI server returned HTTP ${response.status} for /generate`;\n            try {\n                const errorData = (await response.json()) as { message?: string; error?: string };\n                if (errorData?.error) errorMessage = errorData.error;\n                else if (errorData?.message) errorMessage = errorData.message;\n            } catch { }\n            throw new Error(errorMessage);\n        }\n\n        const data = (await response.json()) as {\n            text?: string;\n            content?: string;\n            message?: string;\n        };\n\n        return data.text ?? data.content ?? data.message ?? '';\n    }\n}\n","/**\n * @krutai/ai-provider — AI Provider package for KrutAI\n *\n * A fetch-based wrapper that calls your deployed LangChain backend server.\n * The user's API key is validated against the server before any AI call is made.\n *\n * @example Basic usage\n * ```typescript\n * import { krutAI } from '@krutai/ai-provider';\n *\n * const ai = krutAI({\n *   apiKey: process.env.KRUTAI_API_KEY!,\n *   serverUrl: 'https://krut.ai',\n * });\n *\n * await ai.initialize(); // validates key with server\n *\n * const text = await ai.chat('Write a poem about TypeScript');\n * console.log(text);\n * ```\n *\n * @example With custom model\n * ```typescript\n * const ai = krutAI({\n *   apiKey: process.env.KRUTAI_API_KEY!,\n *   serverUrl: 'https://krut.ai',\n *   model: 'gpt-4o',\n * });\n * await ai.initialize();\n * const text = await ai.chat('Hello!');\n * ```\n *\n * @example Streaming\n * ```typescript\n * const ai = krutAI({\n *   apiKey: process.env.KRUTAI_API_KEY!,\n *   serverUrl: 'https://krut.ai',\n * });\n * await ai.initialize();\n *\n * const response = await ai.streamChatResponse([{ role: 'user', content: 'Tell me a story' }]);\n * // Example assumes you handle the SSE stream from the response body\n * ```\n *\n * @packageDocumentation\n */\n\nimport type { KrutAIProviderConfig } from './types';\nimport { DEFAULT_MODEL } from './types';\nimport { KrutAIProvider } from './client';\n\nexport { KrutAIProvider } from './client';\nexport { KrutAIKeyValidationError } from './client';\nexport {\n    validateApiKeyWithService as validateApiKey,\n    validateApiKeyFormat,\n} from 'krutai';\nexport type { KrutAIProviderConfig, GenerateOptions, ChatMessage } from './types';\nexport { DEFAULT_MODEL } from './types';\n\n/**\n * krutAI — convenience factory (mirrors `krutAuth` in @krutai/auth).\n *\n * Creates a `KrutAIProvider` instance configured to call your LangChain server.\n *\n * @param config - Provider configuration (`apiKey` and `serverUrl` are required)\n * @returns A `KrutAIProvider` instance — call `.initialize()` before use\n *\n * @example\n * ```typescript\n * import { krutAI } from '@krutai/ai-provider';\n *\n * const ai = krutAI({\n *   apiKey: process.env.KRUTAI_API_KEY!,\n *   serverUrl: 'https://krut.ai',\n * });\n *\n * await ai.initialize();\n * const text = await ai.chat('Hello!');\n * ```\n */\nexport function krutAI(\n    config: KrutAIProviderConfig & { model?: string }\n): KrutAIProvider {\n    return new KrutAIProvider({\n        model: DEFAULT_MODEL,\n        ...config,\n    });\n}\n\n// Package metadata\nexport const VERSION = '0.2.0';\n"]}
+{"version":3,"sources":["../src/types.ts","../src/client.ts","../src/index.ts"],"names":["validateApiKeyFormat","validateApiKey"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Types for @krutai/ai-provider\n */\n\n/**\n * Default model identifier sent to the LangChain server when no model is specified.\n * Your server can use this value to route to its own default model.\n */\nexport const DEFAULT_MODEL = 'gemini-3.1-pro-preview' as const;\n\n/**\n * Default base URL for the LangChain backend server.\n * Used when no serverUrl is provided in the config.\n */\nexport const DEFAULT_SERVER_URL = 'http://localhost:8000' as const;\n\n// ============================================================================\n// Comparison Types\n// ============================================================================\n\nexport interface DataRecord {\n    [key: string]: unknown;\n}\n\nexport interface FileSchema {\n    name: string;\n    rowCount: number;\n    columns: string[];\n    sample: DataRecord[];\n}\n\nexport interface ComparisonSummary {\n    totalRows: number;\n    differencesFound: number;\n    matchesFound: number;\n    status: string;\n}\n\nexport interface ComparisonCodeResult {\n    code: string;\n    humanExplanation: string[];\n    constants?: Record<string, unknown>;\n}\n\nexport interface ComparisonResult {\n    summary: ComparisonSummary;\n    metadata?: {\n        file1Columns?: string[];\n        file2Columns?: string[];\n        executionTime?: number;\n    };\n}\n\nexport interface ComparisonResponse {\n    success: boolean;\n    result?: ComparisonResult;\n    generatedCode?: string;\n    humanExplanation?: string[];\n    downloadUrl?: string;\n    fileName?: string;\n    error?: string;\n}\n\nexport interface PreviewResponse {\n    success: boolean;\n    file1?: FileSchema;\n    file2?: FileSchema;\n    error?: string;\n}\n\nexport interface GenerateCodeOptions {\n    prompt?: string;\n}\n\nexport interface CompareFilesOptions {\n    code: string;\n    prompt?: string;\n}\n\n/**\n * Configuration options for KrutAIProvider\n */\nexport interface KrutAIProviderConfig {\n    /**\n     * KrutAI API key.\n     * Validated against the LangChain server before use.\n     * Optional: defaults to process.env.KRUTAI_API_KEY\n     */\n    apiKey?: string;\n\n    /**\n     * Base URL of your deployed LangChain backend server.\n     * @default \"http://localhost:8000\"\n     * @example \"https://ai.krut.ai\"\n     */\n    serverUrl?: string;\n\n    /**\n     * The AI model to use (passed to the server).\n     * The server decides what to do with this value.\n     * @default \"default\"\n     */\n    model?: string;\n\n    /**\n     * Whether to validate the API key against the server on initialization.\n     * Set to false to skip the validation round-trip (e.g. in tests).\n     * @default true\n     */\n    validateOnInit?: boolean;\n}\n\n/**\n * A part of a multimodal message\n */\nexport interface TextContentPart {\n    type: 'text';\n    text: string;\n}\n\nexport interface ImageContentPart {\n    type: 'image_url';\n    image_url: {\n        url: string; // Base64 data URI or HTTP(S) URL\n        detail?: 'low' | 'high' | 'auto';\n    };\n}\n\nexport type ContentPart = TextContentPart | ImageContentPart;\nexport type MessageContent = string | ContentPart[];\n\n/**\n * A single chat message\n */\nexport interface ChatMessage {\n    role: 'user' | 'assistant' | 'system';\n    content: MessageContent;\n}\n\n/**\n * Options for a single generate / stream / chat call\n */\nexport interface GenerateOptions {\n    /**\n     * Override the model for this specific call.\n     */\n    model?: string;\n\n    /**\n     * System prompt (prepended as a system message).\n     */\n    system?: string;\n\n    /**\n     * Maximum tokens to generate.\n     */\n    maxTokens?: number;\n\n    /**\n     * Temperature (0–2).\n     */\n    temperature?: number;\n\n    /**\n     * Array of image URLs or base64 data URIs to include with the request.\n     */\n    images?: string[];\n\n    /**\n     * Array of document URLs or base64 data URIs (e.g. PDFs) to include with the request.\n     */\n    documents?: string[];\n\n    /**\n     * Array of PDF URLs or base64 data URIs to include with the request.\n     */\n    pdf?: string[];\n\n    /**\n     * Optional conversation history.\n     */\n    history?: ChatMessage[];\n\n    /**\n     * Optional attachments.\n     */\n    attachments?: any[];\n\n    /**\n     * Whether to return structured output.\n     */\n    isStructure?: boolean;\n\n    /**\n     * The schema for structured output.\n     * Can be a JSON Schema object or an array of field names.\n     */\n    output_structure?: any;\n}\n","import type {\n    KrutAIProviderConfig,\n    GenerateOptions,\n    ChatMessage,\n} from './types';\nimport { DEFAULT_MODEL, DEFAULT_SERVER_URL } from './types';\nimport {\n    validateApiKey,\n    validateApiKeyFormat,\n    KrutAIKeyValidationError,\n} from 'krutai';\n\nexport { KrutAIKeyValidationError };\n\n/**\n * KrutAIProvider — fetch-based AI provider for KrutAI\n *\n * Calls your deployed LangChain backend server for all AI operations.\n * The API key is validated against the server before use.\n *\n * @example\n * ```typescript\n * import { KrutAIProvider } from '@krutai/ai-provider';\n *\n * // Using local dev server (http://localhost:8000 by default)\n * const ai = new KrutAIProvider({\n *   apiKey: process.env.KRUTAI_API_KEY!,\n * });\n *\n * // Or point to a production server\n * const aiProd = new KrutAIProvider({\n *   apiKey: process.env.KRUTAI_API_KEY!,\n *   serverUrl: 'https://ai.krut.ai',\n * });\n *\n * await ai.initialize(); // validates key against server\n *\n * const text = await ai.generate('Tell me a joke');\n * console.log(text);\n * ```\n */\nexport class KrutAIProvider {\n    private readonly apiKey: string;\n    private readonly serverUrl: string;\n    private readonly resolvedModel: string;\n    private readonly config: KrutAIProviderConfig;\n\n    private initialized = false;\n\n    constructor(config: KrutAIProviderConfig) {\n        this.config = config;\n        this.apiKey = config.apiKey || process.env.KRUTAI_API_KEY || '';\n        this.serverUrl = (config.serverUrl ?? DEFAULT_SERVER_URL).replace(/\\/$/, ''); // strip trailing slash\n        this.resolvedModel = config.model ?? DEFAULT_MODEL;\n\n        // Basic format check immediately on construction\n        validateApiKeyFormat(this.apiKey);\n\n        // If validation is disabled, mark as ready immediately\n        if (config.validateOnInit === false) {\n            this.initialized = true;\n        }\n    }\n\n    /**\n     * Initialize the provider.\n     * Validates the API key against the LangChain server, then marks provider as ready.\n     *\n     * @throws {KrutAIKeyValidationError} if the key is rejected or the server is unreachable\n     */\n    async initialize(): Promise<void> {\n        if (this.initialized) return;\n\n        if (this.config.validateOnInit !== false) {\n            await validateApiKey(this.apiKey, this.serverUrl);\n        }\n\n        this.initialized = true;\n    }\n\n    /**\n     * Returns the currently configured default model.\n     */\n    getModel(): string {\n        return this.resolvedModel;\n    }\n\n    /**\n     * Returns whether the provider has been initialized.\n     */\n    isInitialized(): boolean {\n        return this.initialized;\n    }\n\n    // ---------------------------------------------------------------------------\n    // Private helpers\n    // ---------------------------------------------------------------------------\n\n    private assertInitialized(): void {\n        if (!this.initialized) {\n            throw new Error(\n                'KrutAIProvider not initialized. Call initialize() first or set validateOnInit to false.'\n            );\n        }\n    }\n\n    /** Common request headers sent to the server on every AI call. */\n    private authHeaders(): Record<string, string> {\n        return {\n            'Content-Type': 'application/json',\n            Authorization: `Bearer ${this.apiKey}`,\n            'x-api-key': this.apiKey,\n        };\n    }\n\n    // ---------------------------------------------------------------------------\n    // Public AI Methods\n    // ---------------------------------------------------------------------------\n\n    /**\n     * Similar to streamChat() but returns the raw fetch Response object.\n     * Useful for proxying the Server-Sent Events stream directly to a frontend client.\n     *\n     * @param messages - Full conversation history\n     * @param options - Optional overrides (model, maxTokens, temperature)\n     * @returns A Promise resolving to the native fetch Response\n     */\n    async streamChatResponse(messages: ChatMessage[], options: GenerateOptions = {}): Promise<Response> {\n        this.assertInitialized();\n\n        if (!messages.length) {\n            throw new Error('Messages array cannot be empty for streamChatResponse');\n        }\n\n        const model = options.model ?? this.resolvedModel;\n\n        const response = await fetch(`${this.serverUrl}/stream`, {\n            method: 'POST',\n            headers: {\n                ...this.authHeaders(),\n                Accept: 'text/event-stream',\n            },\n            body: JSON.stringify({\n                messages,\n                model,\n                ...(options.system !== undefined ? { system: options.system } : {}),\n                ...(options.images !== undefined ? { images: options.images } : {}),\n                ...(options.documents !== undefined ? { documents: options.documents } : {}),\n                ...(options.pdf !== undefined ? { pdf: options.pdf } : {}),\n                ...(options.maxTokens !== undefined ? { maxTokens: options.maxTokens } : {}),\n                ...(options.temperature !== undefined ? { temperature: options.temperature } : {}),\n            }),\n        });\n\n        if (!response.ok) {\n            let errorMessage = `AI server returned HTTP ${response.status} for /stream`;\n            try {\n                const errorData = (await response.json()) as { message?: string; error?: string };\n                if (errorData?.error) errorMessage = errorData.error;\n                else if (errorData?.message) errorMessage = errorData.message;\n            } catch { }\n            throw new Error(errorMessage);\n        }\n\n        return response;\n    }\n\n    /**\n     * Generate a response for a prompt (non-streaming).\n     *\n     * Calls: POST {serverUrl}/generate\n     * Body:  { prompt, model, system?, maxTokens?, temperature? }\n     * Expected response: { text: string } or { content: string } or { message: string }\n     *\n     * @param prompt - The user prompt string\n     * @param options - Optional overrides (model, system, maxTokens, temperature)\n     * @returns The assistant's response text (or an object if structured)\n     */\n    async chat<T = any>(prompt: string, options: GenerateOptions = {}): Promise<T> {\n        this.assertInitialized();\n        const model = options.model ?? this.resolvedModel;\n\n        const response = await fetch(`${this.serverUrl}/generate`, {\n            method: 'POST',\n            headers: this.authHeaders(),\n            body: JSON.stringify({\n                prompt,\n                model,\n                ...(options.system !== undefined ? { system: options.system } : {}),\n                ...(options.images !== undefined ? { images: options.images } : {}),\n                ...(options.documents !== undefined ? { documents: options.documents } : {}),\n                ...(options.pdf !== undefined ? { pdf: options.pdf } : {}),\n                ...(options.maxTokens !== undefined ? { maxTokens: options.maxTokens } : {}),\n                ...(options.temperature !== undefined ? { temperature: options.temperature } : {}),\n                ...(options.isStructure !== undefined ? { isStructure: options.isStructure } : {}),\n                ...(options.output_structure !== undefined ? { output_structure: options.output_structure } : {}),\n                ...(options.history !== undefined ? { history: options.history } : {}),\n                ...(options.attachments !== undefined ? { attachments: options.attachments } : {}),\n            }),\n        });\n\n        if (!response.ok) {\n            let errorMessage = `AI server returned HTTP ${response.status} for /generate`;\n            try {\n                const errorData = (await response.json()) as { message?: string; error?: string };\n                if (errorData?.error) errorMessage = errorData.error;\n                else if (errorData?.message) errorMessage = errorData.message;\n            } catch { }\n            throw new Error(errorMessage);\n        }\n\n        const data = (await response.json()) as any;\n\n        // If isStructure was set, return the full object.\n        if (options.isStructure) {\n            return data as T;\n        }\n\n        // Otherwise return text/content/message or empty string\n        return (data.text ?? data.content ?? data.message ?? '') as T;\n    }\n}\n","/**\n * @krutai/ai-provider — AI Provider package for KrutAI\n *\n * A fetch-based wrapper that calls your deployed LangChain backend server.\n * The user's API key is validated against the server before any AI call is made.\n *\n * @example Basic usage\n * ```typescript\n * import { krutAI } from '@krutai/ai-provider';\n *\n * const ai = krutAI({\n *   apiKey: process.env.KRUTAI_API_KEY!,\n *   serverUrl: 'https://krut.ai',\n * });\n *\n * await ai.initialize(); // validates key with server\n *\n * const text = await ai.chat('Write a poem about TypeScript');\n * console.log(text);\n * ```\n *\n * @example With custom model\n * ```typescript\n * const ai = krutAI({\n *   apiKey: process.env.KRUTAI_API_KEY!,\n *   serverUrl: 'https://krut.ai',\n *   model: 'gemini-3.1-pro-preview',\n * });\n * await ai.initialize();\n * const text = await ai.chat('Hello!');\n * ```\n *\n * @example Streaming\n * ```typescript\n * const ai = krutAI({\n *   apiKey: process.env.KRUTAI_API_KEY!,\n *   serverUrl: 'https://krut.ai',\n * });\n * await ai.initialize();\n *\n * const response = await ai.streamChatResponse([{ role: 'user', content: 'Tell me a story' }]);\n * // Example assumes you handle the SSE stream from the response body\n * ```\n *\n * @packageDocumentation\n */\n\nimport type { KrutAIProviderConfig } from './types';\nimport { DEFAULT_MODEL } from './types';\nimport { KrutAIProvider } from './client';\n\nexport { KrutAIProvider } from './client';\nexport { KrutAIKeyValidationError } from './client';\nexport {\n    validateApiKeyWithService as validateApiKey,\n    validateApiKeyFormat,\n} from 'krutai';\nexport type {\n    KrutAIProviderConfig,\n    GenerateOptions,\n    ChatMessage,\n    DataRecord,\n    FileSchema,\n    ComparisonSummary,\n    ComparisonCodeResult,\n    ComparisonResult,\n    ComparisonResponse,\n    PreviewResponse,\n    GenerateCodeOptions,\n    CompareFilesOptions,\n} from './types';\nexport { DEFAULT_MODEL } from './types';\n\n/**\n * krutAI — convenience factory (mirrors `krutAuth` in @krutai/auth).\n *\n * Creates a `KrutAIProvider` instance configured to call your LangChain server.\n *\n * @param config - Provider configuration (`apiKey` and `serverUrl` are required)\n * @returns A `KrutAIProvider` instance — call `.initialize()` before use\n *\n * @example\n * ```typescript\n * import { krutAI } from '@krutai/ai-provider';\n *\n * const ai = krutAI({\n *   apiKey: process.env.KRUTAI_API_KEY!,\n *   serverUrl: 'https://krut.ai',\n * });\n *\n * await ai.initialize();\n * const text = await ai.chat('Hello!');\n * ```\n */\nexport function krutAI(\n    config: KrutAIProviderConfig & { model?: string }\n): KrutAIProvider {\n    return new KrutAIProvider({\n        model: DEFAULT_MODEL,\n        ...config,\n    });\n}\n\n// Package metadata\nexport const VERSION = '0.3.4';\n"]}

package/dist/index.mjs

@@ -1,8 +1,8 @@
-import { validateApiKeyFormat, validateApiKeyWithService } from 'krutai';
-export { ApiKeyValidationError as KrutAIKeyValidationError, validateApiKeyWithService as validateApiKey, validateApiKeyFormat } from 'krutai';
+import { validateApiKeyFormat, validateApiKey } from 'krutai';
+export { KrutAIKeyValidationError, validateApiKeyWithService as validateApiKey, validateApiKeyFormat } from 'krutai';
 
 // src/types.ts
-var DEFAULT_MODEL = "default";
+var DEFAULT_MODEL = "gemini-3.1-pro-preview";
 var DEFAULT_SERVER_URL = "http://localhost:8000";
 var KrutAIProvider = class {
   apiKey;
@@ -29,7 +29,7 @@ var KrutAIProvider = class {
   async initialize() {
     if (this.initialized) return;
     if (this.config.validateOnInit !== false) {
-      await validateApiKeyWithService(this.apiKey, this.serverUrl);
+      await validateApiKey(this.apiKey, this.serverUrl);
     }
     this.initialized = true;
   }
@@ -118,7 +118,7 @@ var KrutAIProvider = class {
    *
    * @param prompt - The user prompt string
    * @param options - Optional overrides (model, system, maxTokens, temperature)
-   * @returns The assistant's response text
+   * @returns The assistant's response text (or an object if structured)
    */
   async chat(prompt, options = {}) {
     this.assertInitialized();
@@ -134,7 +134,11 @@ var KrutAIProvider = class {
         ...options.documents !== void 0 ? { documents: options.documents } : {},
         ...options.pdf !== void 0 ? { pdf: options.pdf } : {},
         ...options.maxTokens !== void 0 ? { maxTokens: options.maxTokens } : {},
-        ...options.temperature !== void 0 ? { temperature: options.temperature } : {}
+        ...options.temperature !== void 0 ? { temperature: options.temperature } : {},
+        ...options.isStructure !== void 0 ? { isStructure: options.isStructure } : {},
+        ...options.output_structure !== void 0 ? { output_structure: options.output_structure } : {},
+        ...options.history !== void 0 ? { history: options.history } : {},
+        ...options.attachments !== void 0 ? { attachments: options.attachments } : {}
       })
     });
     if (!response.ok) {
@@ -148,6 +152,9 @@ var KrutAIProvider = class {
       throw new Error(errorMessage);
     }
     const data = await response.json();
+    if (options.isStructure) {
+      return data;
+    }
     return data.text ?? data.content ?? data.message ?? "";
   }
 };
@@ -157,7 +164,7 @@ function krutAI(config) {
     ...config
   });
 }
-var VERSION = "0.2.0";
+var VERSION = "0.3.4";
 
 export { DEFAULT_MODEL, KrutAIProvider, VERSION, krutAI };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/types.ts","../src/client.ts","../src/index.ts"],"names":["validateApiKey"],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * Types for @krutai/ai-provider\n */\n\n/**\n * Default model identifier sent to the LangChain server when no model is specified.\n * Your server can use this value to route to its own default model.\n */\nexport const DEFAULT_MODEL = 'default' as const;\n\n/**\n * Default base URL for the LangChain backend server.\n * Used when no serverUrl is provided in the config.\n */\nexport const DEFAULT_SERVER_URL = 'http://localhost:8000' as const;\n\n/**\n * Configuration options for KrutAIProvider\n */\nexport interface KrutAIProviderConfig {\n    /**\n     * KrutAI API key.\n     * Validated against the LangChain server before use.\n     * Optional: defaults to process.env.KRUTAI_API_KEY\n     */\n    apiKey?: string;\n\n    /**\n     * Base URL of your deployed LangChain backend server.\n     * @default \"http://localhost:8000\"\n     * @example \"https://ai.krut.ai\"\n     */\n    serverUrl?: string;\n\n    /**\n     * The AI model to use (passed to the server).\n     * The server decides what to do with this value.\n     * @default \"default\"\n     */\n    model?: string;\n\n    /**\n     * Whether to validate the API key against the server on initialization.\n     * Set to false to skip the validation round-trip (e.g. in tests).\n     * @default true\n     */\n    validateOnInit?: boolean;\n}\n\n/**\n * A part of a multimodal message\n */\nexport interface TextContentPart {\n    type: 'text';\n    text: string;\n}\n\nexport interface ImageContentPart {\n    type: 'image_url';\n    image_url: {\n        url: string; // Base64 data URI or HTTP(S) URL\n        detail?: 'low' | 'high' | 'auto';\n    };\n}\n\nexport type ContentPart = TextContentPart | ImageContentPart;\nexport type MessageContent = string | ContentPart[];\n\n/**\n * A single chat message\n */\nexport interface ChatMessage {\n    role: 'user' | 'assistant' | 'system';\n    content: MessageContent;\n}\n\n/**\n * Options for a single generate / stream / chat call\n */\nexport interface GenerateOptions {\n    /**\n     * Override the model for this specific call.\n     */\n    model?: string;\n\n    /**\n     * System prompt (prepended as a system message).\n     */\n    system?: string;\n\n    /**\n     * Maximum tokens to generate.\n     */\n    maxTokens?: number;\n\n    /**\n     * Temperature (0–2).\n     */\n    temperature?: number;\n\n    /**\n     * Array of image URLs or base64 data URIs to include with the request.\n     */\n    images?: string[];\n\n    /**\n     * Array of document URLs or base64 data URIs (e.g. PDFs) to include with the request.\n     */\n    documents?: string[];\n\n    /**\n     * Array of PDF URLs or base64 data URIs to include with the request.\n     */\n    pdf?: string[];\n}\n","import type { KrutAIProviderConfig, GenerateOptions, ChatMessage } from './types';\nimport { DEFAULT_MODEL, DEFAULT_SERVER_URL } from './types';\nimport {\n    validateApiKeyWithService as validateApiKey,\n    validateApiKeyFormat,\n    ApiKeyValidationError as KrutAIKeyValidationError,\n} from 'krutai';\n\nexport { KrutAIKeyValidationError };\n\n/**\n * KrutAIProvider — fetch-based AI provider for KrutAI\n *\n * Calls your deployed LangChain backend server for all AI operations.\n * The API key is validated against the server before use.\n *\n * @example\n * ```typescript\n * import { KrutAIProvider } from '@krutai/ai-provider';\n *\n * // Using local dev server (http://localhost:8000 by default)\n * const ai = new KrutAIProvider({\n *   apiKey: process.env.KRUTAI_API_KEY!,\n * });\n *\n * // Or point to a production server\n * const aiProd = new KrutAIProvider({\n *   apiKey: process.env.KRUTAI_API_KEY!,\n *   serverUrl: 'https://ai.krut.ai',\n * });\n *\n * await ai.initialize(); // validates key against server\n *\n * const text = await ai.generate('Tell me a joke');\n * console.log(text);\n * ```\n */\nexport class KrutAIProvider {\n    private readonly apiKey: string;\n    private readonly serverUrl: string;\n    private readonly resolvedModel: string;\n    private readonly config: KrutAIProviderConfig;\n\n    private initialized = false;\n\n    constructor(config: KrutAIProviderConfig) {\n        this.config = config;\n        this.apiKey = config.apiKey || process.env.KRUTAI_API_KEY || '';\n        this.serverUrl = (config.serverUrl ?? DEFAULT_SERVER_URL).replace(/\\/$/, ''); // strip trailing slash\n        this.resolvedModel = config.model ?? DEFAULT_MODEL;\n\n        // Basic format check immediately on construction\n        validateApiKeyFormat(this.apiKey);\n\n        // If validation is disabled, mark as ready immediately\n        if (config.validateOnInit === false) {\n            this.initialized = true;\n        }\n    }\n\n    /**\n     * Initialize the provider.\n     * Validates the API key against the LangChain server, then marks provider as ready.\n     *\n     * @throws {KrutAIKeyValidationError} if the key is rejected or the server is unreachable\n     */\n    async initialize(): Promise<void> {\n        if (this.initialized) return;\n\n        if (this.config.validateOnInit !== false) {\n            await validateApiKey(this.apiKey, this.serverUrl);\n        }\n\n        this.initialized = true;\n    }\n\n    /**\n     * Returns the currently configured default model.\n     */\n    getModel(): string {\n        return this.resolvedModel;\n    }\n\n    /**\n     * Returns whether the provider has been initialized.\n     */\n    isInitialized(): boolean {\n        return this.initialized;\n    }\n\n    // ---------------------------------------------------------------------------\n    // Private helpers\n    // ---------------------------------------------------------------------------\n\n    private assertInitialized(): void {\n        if (!this.initialized) {\n            throw new Error(\n                'KrutAIProvider not initialized. Call initialize() first or set validateOnInit to false.'\n            );\n        }\n    }\n\n    /** Common request headers sent to the server on every AI call. */\n    private authHeaders(): Record<string, string> {\n        return {\n            'Content-Type': 'application/json',\n            Authorization: `Bearer ${this.apiKey}`,\n            'x-api-key': this.apiKey,\n        };\n    }\n\n    // ---------------------------------------------------------------------------\n    // Public AI Methods\n    // ---------------------------------------------------------------------------\n\n    /**\n     * Similar to streamChat() but returns the raw fetch Response object.\n     * Useful for proxying the Server-Sent Events stream directly to a frontend client.\n     *\n     * @param messages - Full conversation history\n     * @param options - Optional overrides (model, maxTokens, temperature)\n     * @returns A Promise resolving to the native fetch Response\n     */\n    async streamChatResponse(messages: ChatMessage[], options: GenerateOptions = {}): Promise<Response> {\n        this.assertInitialized();\n\n        if (!messages.length) {\n            throw new Error('Messages array cannot be empty for streamChatResponse');\n        }\n\n        const model = options.model ?? this.resolvedModel;\n\n        const response = await fetch(`${this.serverUrl}/stream`, {\n            method: 'POST',\n            headers: {\n                ...this.authHeaders(),\n                Accept: 'text/event-stream',\n            },\n            body: JSON.stringify({\n                messages,\n                model,\n                ...(options.system !== undefined ? { system: options.system } : {}),\n                ...(options.images !== undefined ? { images: options.images } : {}),\n                ...(options.documents !== undefined ? { documents: options.documents } : {}),\n                ...(options.pdf !== undefined ? { pdf: options.pdf } : {}),\n                ...(options.maxTokens !== undefined ? { maxTokens: options.maxTokens } : {}),\n                ...(options.temperature !== undefined ? { temperature: options.temperature } : {}),\n            }),\n        });\n\n        if (!response.ok) {\n            let errorMessage = `AI server returned HTTP ${response.status} for /stream`;\n            try {\n                const errorData = (await response.json()) as { message?: string; error?: string };\n                if (errorData?.error) errorMessage = errorData.error;\n                else if (errorData?.message) errorMessage = errorData.message;\n            } catch { }\n            throw new Error(errorMessage);\n        }\n\n        return response;\n    }\n\n    /**\n     * Generate a response for a prompt (non-streaming).\n     *\n     * Calls: POST {serverUrl}/generate\n     * Body:  { prompt, model, system?, maxTokens?, temperature? }\n     * Expected response: { text: string } or { content: string } or { message: string }\n     *\n     * @param prompt - The user prompt string\n     * @param options - Optional overrides (model, system, maxTokens, temperature)\n     * @returns The assistant's response text\n     */\n    async chat(prompt: string, options: GenerateOptions = {}): Promise<string> {\n        this.assertInitialized();\n        const model = options.model ?? this.resolvedModel;\n\n        const response = await fetch(`${this.serverUrl}/generate`, {\n            method: 'POST',\n            headers: this.authHeaders(),\n            body: JSON.stringify({\n                prompt,\n                model,\n                ...(options.system !== undefined ? { system: options.system } : {}),\n                ...(options.images !== undefined ? { images: options.images } : {}),\n                ...(options.documents !== undefined ? { documents: options.documents } : {}),\n                ...(options.pdf !== undefined ? { pdf: options.pdf } : {}),\n                ...(options.maxTokens !== undefined ? { maxTokens: options.maxTokens } : {}),\n                ...(options.temperature !== undefined ? { temperature: options.temperature } : {}),\n            }),\n        });\n\n        if (!response.ok) {\n            let errorMessage = `AI server returned HTTP ${response.status} for /generate`;\n            try {\n                const errorData = (await response.json()) as { message?: string; error?: string };\n                if (errorData?.error) errorMessage = errorData.error;\n                else if (errorData?.message) errorMessage = errorData.message;\n            } catch { }\n            throw new Error(errorMessage);\n        }\n\n        const data = (await response.json()) as {\n            text?: string;\n            content?: string;\n            message?: string;\n        };\n\n        return data.text ?? data.content ?? data.message ?? '';\n    }\n}\n","/**\n * @krutai/ai-provider — AI Provider package for KrutAI\n *\n * A fetch-based wrapper that calls your deployed LangChain backend server.\n * The user's API key is validated against the server before any AI call is made.\n *\n * @example Basic usage\n * ```typescript\n * import { krutAI } from '@krutai/ai-provider';\n *\n * const ai = krutAI({\n *   apiKey: process.env.KRUTAI_API_KEY!,\n *   serverUrl: 'https://krut.ai',\n * });\n *\n * await ai.initialize(); // validates key with server\n *\n * const text = await ai.chat('Write a poem about TypeScript');\n * console.log(text);\n * ```\n *\n * @example With custom model\n * ```typescript\n * const ai = krutAI({\n *   apiKey: process.env.KRUTAI_API_KEY!,\n *   serverUrl: 'https://krut.ai',\n *   model: 'gpt-4o',\n * });\n * await ai.initialize();\n * const text = await ai.chat('Hello!');\n * ```\n *\n * @example Streaming\n * ```typescript\n * const ai = krutAI({\n *   apiKey: process.env.KRUTAI_API_KEY!,\n *   serverUrl: 'https://krut.ai',\n * });\n * await ai.initialize();\n *\n * const response = await ai.streamChatResponse([{ role: 'user', content: 'Tell me a story' }]);\n * // Example assumes you handle the SSE stream from the response body\n * ```\n *\n * @packageDocumentation\n */\n\nimport type { KrutAIProviderConfig } from './types';\nimport { DEFAULT_MODEL } from './types';\nimport { KrutAIProvider } from './client';\n\nexport { KrutAIProvider } from './client';\nexport { KrutAIKeyValidationError } from './client';\nexport {\n    validateApiKeyWithService as validateApiKey,\n    validateApiKeyFormat,\n} from 'krutai';\nexport type { KrutAIProviderConfig, GenerateOptions, ChatMessage } from './types';\nexport { DEFAULT_MODEL } from './types';\n\n/**\n * krutAI — convenience factory (mirrors `krutAuth` in @krutai/auth).\n *\n * Creates a `KrutAIProvider` instance configured to call your LangChain server.\n *\n * @param config - Provider configuration (`apiKey` and `serverUrl` are required)\n * @returns A `KrutAIProvider` instance — call `.initialize()` before use\n *\n * @example\n * ```typescript\n * import { krutAI } from '@krutai/ai-provider';\n *\n * const ai = krutAI({\n *   apiKey: process.env.KRUTAI_API_KEY!,\n *   serverUrl: 'https://krut.ai',\n * });\n *\n * await ai.initialize();\n * const text = await ai.chat('Hello!');\n * ```\n */\nexport function krutAI(\n    config: KrutAIProviderConfig & { model?: string }\n): KrutAIProvider {\n    return new KrutAIProvider({\n        model: DEFAULT_MODEL,\n        ...config,\n    });\n}\n\n// Package metadata\nexport const VERSION = '0.2.0';\n"]}
+{"version":3,"sources":["../src/types.ts","../src/client.ts","../src/index.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * Types for @krutai/ai-provider\n */\n\n/**\n * Default model identifier sent to the LangChain server when no model is specified.\n * Your server can use this value to route to its own default model.\n */\nexport const DEFAULT_MODEL = 'gemini-3.1-pro-preview' as const;\n\n/**\n * Default base URL for the LangChain backend server.\n * Used when no serverUrl is provided in the config.\n */\nexport const DEFAULT_SERVER_URL = 'http://localhost:8000' as const;\n\n// ============================================================================\n// Comparison Types\n// ============================================================================\n\nexport interface DataRecord {\n    [key: string]: unknown;\n}\n\nexport interface FileSchema {\n    name: string;\n    rowCount: number;\n    columns: string[];\n    sample: DataRecord[];\n}\n\nexport interface ComparisonSummary {\n    totalRows: number;\n    differencesFound: number;\n    matchesFound: number;\n    status: string;\n}\n\nexport interface ComparisonCodeResult {\n    code: string;\n    humanExplanation: string[];\n    constants?: Record<string, unknown>;\n}\n\nexport interface ComparisonResult {\n    summary: ComparisonSummary;\n    metadata?: {\n        file1Columns?: string[];\n        file2Columns?: string[];\n        executionTime?: number;\n    };\n}\n\nexport interface ComparisonResponse {\n    success: boolean;\n    result?: ComparisonResult;\n    generatedCode?: string;\n    humanExplanation?: string[];\n    downloadUrl?: string;\n    fileName?: string;\n    error?: string;\n}\n\nexport interface PreviewResponse {\n    success: boolean;\n    file1?: FileSchema;\n    file2?: FileSchema;\n    error?: string;\n}\n\nexport interface GenerateCodeOptions {\n    prompt?: string;\n}\n\nexport interface CompareFilesOptions {\n    code: string;\n    prompt?: string;\n}\n\n/**\n * Configuration options for KrutAIProvider\n */\nexport interface KrutAIProviderConfig {\n    /**\n     * KrutAI API key.\n     * Validated against the LangChain server before use.\n     * Optional: defaults to process.env.KRUTAI_API_KEY\n     */\n    apiKey?: string;\n\n    /**\n     * Base URL of your deployed LangChain backend server.\n     * @default \"http://localhost:8000\"\n     * @example \"https://ai.krut.ai\"\n     */\n    serverUrl?: string;\n\n    /**\n     * The AI model to use (passed to the server).\n     * The server decides what to do with this value.\n     * @default \"default\"\n     */\n    model?: string;\n\n    /**\n     * Whether to validate the API key against the server on initialization.\n     * Set to false to skip the validation round-trip (e.g. in tests).\n     * @default true\n     */\n    validateOnInit?: boolean;\n}\n\n/**\n * A part of a multimodal message\n */\nexport interface TextContentPart {\n    type: 'text';\n    text: string;\n}\n\nexport interface ImageContentPart {\n    type: 'image_url';\n    image_url: {\n        url: string; // Base64 data URI or HTTP(S) URL\n        detail?: 'low' | 'high' | 'auto';\n    };\n}\n\nexport type ContentPart = TextContentPart | ImageContentPart;\nexport type MessageContent = string | ContentPart[];\n\n/**\n * A single chat message\n */\nexport interface ChatMessage {\n    role: 'user' | 'assistant' | 'system';\n    content: MessageContent;\n}\n\n/**\n * Options for a single generate / stream / chat call\n */\nexport interface GenerateOptions {\n    /**\n     * Override the model for this specific call.\n     */\n    model?: string;\n\n    /**\n     * System prompt (prepended as a system message).\n     */\n    system?: string;\n\n    /**\n     * Maximum tokens to generate.\n     */\n    maxTokens?: number;\n\n    /**\n     * Temperature (0–2).\n     */\n    temperature?: number;\n\n    /**\n     * Array of image URLs or base64 data URIs to include with the request.\n     */\n    images?: string[];\n\n    /**\n     * Array of document URLs or base64 data URIs (e.g. PDFs) to include with the request.\n     */\n    documents?: string[];\n\n    /**\n     * Array of PDF URLs or base64 data URIs to include with the request.\n     */\n    pdf?: string[];\n\n    /**\n     * Optional conversation history.\n     */\n    history?: ChatMessage[];\n\n    /**\n     * Optional attachments.\n     */\n    attachments?: any[];\n\n    /**\n     * Whether to return structured output.\n     */\n    isStructure?: boolean;\n\n    /**\n     * The schema for structured output.\n     * Can be a JSON Schema object or an array of field names.\n     */\n    output_structure?: any;\n}\n","import type {\n    KrutAIProviderConfig,\n    GenerateOptions,\n    ChatMessage,\n} from './types';\nimport { DEFAULT_MODEL, DEFAULT_SERVER_URL } from './types';\nimport {\n    validateApiKey,\n    validateApiKeyFormat,\n    KrutAIKeyValidationError,\n} from 'krutai';\n\nexport { KrutAIKeyValidationError };\n\n/**\n * KrutAIProvider — fetch-based AI provider for KrutAI\n *\n * Calls your deployed LangChain backend server for all AI operations.\n * The API key is validated against the server before use.\n *\n * @example\n * ```typescript\n * import { KrutAIProvider } from '@krutai/ai-provider';\n *\n * // Using local dev server (http://localhost:8000 by default)\n * const ai = new KrutAIProvider({\n *   apiKey: process.env.KRUTAI_API_KEY!,\n * });\n *\n * // Or point to a production server\n * const aiProd = new KrutAIProvider({\n *   apiKey: process.env.KRUTAI_API_KEY!,\n *   serverUrl: 'https://ai.krut.ai',\n * });\n *\n * await ai.initialize(); // validates key against server\n *\n * const text = await ai.generate('Tell me a joke');\n * console.log(text);\n * ```\n */\nexport class KrutAIProvider {\n    private readonly apiKey: string;\n    private readonly serverUrl: string;\n    private readonly resolvedModel: string;\n    private readonly config: KrutAIProviderConfig;\n\n    private initialized = false;\n\n    constructor(config: KrutAIProviderConfig) {\n        this.config = config;\n        this.apiKey = config.apiKey || process.env.KRUTAI_API_KEY || '';\n        this.serverUrl = (config.serverUrl ?? DEFAULT_SERVER_URL).replace(/\\/$/, ''); // strip trailing slash\n        this.resolvedModel = config.model ?? DEFAULT_MODEL;\n\n        // Basic format check immediately on construction\n        validateApiKeyFormat(this.apiKey);\n\n        // If validation is disabled, mark as ready immediately\n        if (config.validateOnInit === false) {\n            this.initialized = true;\n        }\n    }\n\n    /**\n     * Initialize the provider.\n     * Validates the API key against the LangChain server, then marks provider as ready.\n     *\n     * @throws {KrutAIKeyValidationError} if the key is rejected or the server is unreachable\n     */\n    async initialize(): Promise<void> {\n        if (this.initialized) return;\n\n        if (this.config.validateOnInit !== false) {\n            await validateApiKey(this.apiKey, this.serverUrl);\n        }\n\n        this.initialized = true;\n    }\n\n    /**\n     * Returns the currently configured default model.\n     */\n    getModel(): string {\n        return this.resolvedModel;\n    }\n\n    /**\n     * Returns whether the provider has been initialized.\n     */\n    isInitialized(): boolean {\n        return this.initialized;\n    }\n\n    // ---------------------------------------------------------------------------\n    // Private helpers\n    // ---------------------------------------------------------------------------\n\n    private assertInitialized(): void {\n        if (!this.initialized) {\n            throw new Error(\n                'KrutAIProvider not initialized. Call initialize() first or set validateOnInit to false.'\n            );\n        }\n    }\n\n    /** Common request headers sent to the server on every AI call. */\n    private authHeaders(): Record<string, string> {\n        return {\n            'Content-Type': 'application/json',\n            Authorization: `Bearer ${this.apiKey}`,\n            'x-api-key': this.apiKey,\n        };\n    }\n\n    // ---------------------------------------------------------------------------\n    // Public AI Methods\n    // ---------------------------------------------------------------------------\n\n    /**\n     * Similar to streamChat() but returns the raw fetch Response object.\n     * Useful for proxying the Server-Sent Events stream directly to a frontend client.\n     *\n     * @param messages - Full conversation history\n     * @param options - Optional overrides (model, maxTokens, temperature)\n     * @returns A Promise resolving to the native fetch Response\n     */\n    async streamChatResponse(messages: ChatMessage[], options: GenerateOptions = {}): Promise<Response> {\n        this.assertInitialized();\n\n        if (!messages.length) {\n            throw new Error('Messages array cannot be empty for streamChatResponse');\n        }\n\n        const model = options.model ?? this.resolvedModel;\n\n        const response = await fetch(`${this.serverUrl}/stream`, {\n            method: 'POST',\n            headers: {\n                ...this.authHeaders(),\n                Accept: 'text/event-stream',\n            },\n            body: JSON.stringify({\n                messages,\n                model,\n                ...(options.system !== undefined ? { system: options.system } : {}),\n                ...(options.images !== undefined ? { images: options.images } : {}),\n                ...(options.documents !== undefined ? { documents: options.documents } : {}),\n                ...(options.pdf !== undefined ? { pdf: options.pdf } : {}),\n                ...(options.maxTokens !== undefined ? { maxTokens: options.maxTokens } : {}),\n                ...(options.temperature !== undefined ? { temperature: options.temperature } : {}),\n            }),\n        });\n\n        if (!response.ok) {\n            let errorMessage = `AI server returned HTTP ${response.status} for /stream`;\n            try {\n                const errorData = (await response.json()) as { message?: string; error?: string };\n                if (errorData?.error) errorMessage = errorData.error;\n                else if (errorData?.message) errorMessage = errorData.message;\n            } catch { }\n            throw new Error(errorMessage);\n        }\n\n        return response;\n    }\n\n    /**\n     * Generate a response for a prompt (non-streaming).\n     *\n     * Calls: POST {serverUrl}/generate\n     * Body:  { prompt, model, system?, maxTokens?, temperature? }\n     * Expected response: { text: string } or { content: string } or { message: string }\n     *\n     * @param prompt - The user prompt string\n     * @param options - Optional overrides (model, system, maxTokens, temperature)\n     * @returns The assistant's response text (or an object if structured)\n     */\n    async chat<T = any>(prompt: string, options: GenerateOptions = {}): Promise<T> {\n        this.assertInitialized();\n        const model = options.model ?? this.resolvedModel;\n\n        const response = await fetch(`${this.serverUrl}/generate`, {\n            method: 'POST',\n            headers: this.authHeaders(),\n            body: JSON.stringify({\n                prompt,\n                model,\n                ...(options.system !== undefined ? { system: options.system } : {}),\n                ...(options.images !== undefined ? { images: options.images } : {}),\n                ...(options.documents !== undefined ? { documents: options.documents } : {}),\n                ...(options.pdf !== undefined ? { pdf: options.pdf } : {}),\n                ...(options.maxTokens !== undefined ? { maxTokens: options.maxTokens } : {}),\n                ...(options.temperature !== undefined ? { temperature: options.temperature } : {}),\n                ...(options.isStructure !== undefined ? { isStructure: options.isStructure } : {}),\n                ...(options.output_structure !== undefined ? { output_structure: options.output_structure } : {}),\n                ...(options.history !== undefined ? { history: options.history } : {}),\n                ...(options.attachments !== undefined ? { attachments: options.attachments } : {}),\n            }),\n        });\n\n        if (!response.ok) {\n            let errorMessage = `AI server returned HTTP ${response.status} for /generate`;\n            try {\n                const errorData = (await response.json()) as { message?: string; error?: string };\n                if (errorData?.error) errorMessage = errorData.error;\n                else if (errorData?.message) errorMessage = errorData.message;\n            } catch { }\n            throw new Error(errorMessage);\n        }\n\n        const data = (await response.json()) as any;\n\n        // If isStructure was set, return the full object.\n        if (options.isStructure) {\n            return data as T;\n        }\n\n        // Otherwise return text/content/message or empty string\n        return (data.text ?? data.content ?? data.message ?? '') as T;\n    }\n}\n","/**\n * @krutai/ai-provider — AI Provider package for KrutAI\n *\n * A fetch-based wrapper that calls your deployed LangChain backend server.\n * The user's API key is validated against the server before any AI call is made.\n *\n * @example Basic usage\n * ```typescript\n * import { krutAI } from '@krutai/ai-provider';\n *\n * const ai = krutAI({\n *   apiKey: process.env.KRUTAI_API_KEY!,\n *   serverUrl: 'https://krut.ai',\n * });\n *\n * await ai.initialize(); // validates key with server\n *\n * const text = await ai.chat('Write a poem about TypeScript');\n * console.log(text);\n * ```\n *\n * @example With custom model\n * ```typescript\n * const ai = krutAI({\n *   apiKey: process.env.KRUTAI_API_KEY!,\n *   serverUrl: 'https://krut.ai',\n *   model: 'gemini-3.1-pro-preview',\n * });\n * await ai.initialize();\n * const text = await ai.chat('Hello!');\n * ```\n *\n * @example Streaming\n * ```typescript\n * const ai = krutAI({\n *   apiKey: process.env.KRUTAI_API_KEY!,\n *   serverUrl: 'https://krut.ai',\n * });\n * await ai.initialize();\n *\n * const response = await ai.streamChatResponse([{ role: 'user', content: 'Tell me a story' }]);\n * // Example assumes you handle the SSE stream from the response body\n * ```\n *\n * @packageDocumentation\n */\n\nimport type { KrutAIProviderConfig } from './types';\nimport { DEFAULT_MODEL } from './types';\nimport { KrutAIProvider } from './client';\n\nexport { KrutAIProvider } from './client';\nexport { KrutAIKeyValidationError } from './client';\nexport {\n    validateApiKeyWithService as validateApiKey,\n    validateApiKeyFormat,\n} from 'krutai';\nexport type {\n    KrutAIProviderConfig,\n    GenerateOptions,\n    ChatMessage,\n    DataRecord,\n    FileSchema,\n    ComparisonSummary,\n    ComparisonCodeResult,\n    ComparisonResult,\n    ComparisonResponse,\n    PreviewResponse,\n    GenerateCodeOptions,\n    CompareFilesOptions,\n} from './types';\nexport { DEFAULT_MODEL } from './types';\n\n/**\n * krutAI — convenience factory (mirrors `krutAuth` in @krutai/auth).\n *\n * Creates a `KrutAIProvider` instance configured to call your LangChain server.\n *\n * @param config - Provider configuration (`apiKey` and `serverUrl` are required)\n * @returns A `KrutAIProvider` instance — call `.initialize()` before use\n *\n * @example\n * ```typescript\n * import { krutAI } from '@krutai/ai-provider';\n *\n * const ai = krutAI({\n *   apiKey: process.env.KRUTAI_API_KEY!,\n *   serverUrl: 'https://krut.ai',\n * });\n *\n * await ai.initialize();\n * const text = await ai.chat('Hello!');\n * ```\n */\nexport function krutAI(\n    config: KrutAIProviderConfig & { model?: string }\n): KrutAIProvider {\n    return new KrutAIProvider({\n        model: DEFAULT_MODEL,\n        ...config,\n    });\n}\n\n// Package metadata\nexport const VERSION = '0.3.4';\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@krutai/ai-provider",
-    "version": "0.2.13",
+    "version": "0.3.5",
     "description": "AI provider package for KrutAI — fetch-based client for your deployed LangChain server with API key validation",
     "main": "./dist/index.js",
     "module": "./dist/index.mjs",