@krutai/ai-provider 0.2.3 → 0.2.4

package/dist/index.d.mts

@@ -176,7 +176,7 @@ declare class KrutAIProvider {
  *
  * const ai = krutAI({
  *   apiKey: process.env.KRUTAI_API_KEY!,
- *   serverUrl: 'https://ai.yourapp.com',
+ *   serverUrl: 'https://krut.ai',
  * });
  *
  * await ai.initialize(); // validates key with server
@@ -189,7 +189,7 @@ declare class KrutAIProvider {
  * ```typescript
  * const ai = krutAI({
  *   apiKey: process.env.KRUTAI_API_KEY!,
- *   serverUrl: 'https://ai.yourapp.com',
+ *   serverUrl: 'https://krut.ai',
  *   model: 'gpt-4o',
  * });
  * await ai.initialize();
@@ -200,7 +200,7 @@ declare class KrutAIProvider {
  * ```typescript
  * const ai = krutAI({
  *   apiKey: process.env.KRUTAI_API_KEY!,
- *   serverUrl: 'https://ai.yourapp.com',
+ *   serverUrl: 'https://krut.ai',
  * });
  * await ai.initialize();
  *
@@ -227,7 +227,7 @@ declare class KrutAIProvider {
  *
  * const ai = krutAI({
  *   apiKey: process.env.KRUTAI_API_KEY!,
- *   serverUrl: 'https://ai.yourapp.com',
+ *   serverUrl: 'https://krut.ai',
  * });
  *
  * await ai.initialize();

package/dist/index.d.ts

@@ -176,7 +176,7 @@ declare class KrutAIProvider {
  *
  * const ai = krutAI({
  *   apiKey: process.env.KRUTAI_API_KEY!,
- *   serverUrl: 'https://ai.yourapp.com',
+ *   serverUrl: 'https://krut.ai',
  * });
  *
  * await ai.initialize(); // validates key with server
@@ -189,7 +189,7 @@ declare class KrutAIProvider {
  * ```typescript
  * const ai = krutAI({
  *   apiKey: process.env.KRUTAI_API_KEY!,
- *   serverUrl: 'https://ai.yourapp.com',
+ *   serverUrl: 'https://krut.ai',
  *   model: 'gpt-4o',
  * });
  * await ai.initialize();
@@ -200,7 +200,7 @@ declare class KrutAIProvider {
  * ```typescript
  * const ai = krutAI({
  *   apiKey: process.env.KRUTAI_API_KEY!,
- *   serverUrl: 'https://ai.yourapp.com',
+ *   serverUrl: 'https://krut.ai',
  * });
  * await ai.initialize();
  *
@@ -227,7 +227,7 @@ declare class KrutAIProvider {
  *
  * const ai = krutAI({
  *   apiKey: process.env.KRUTAI_API_KEY!,
- *   serverUrl: 'https://ai.yourapp.com',
+ *   serverUrl: 'https://krut.ai',
  * });
  *
  * await ai.initialize();

package/dist/index.js.map

@@ -1 +1 @@
-{"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 = '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 single chat message\n */\nexport interface ChatMessage {\n    role: 'user' | 'assistant' | 'system';\n    content: string;\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","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     * 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 generate(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.maxTokens !== undefined ? { maxTokens: options.maxTokens } : {}),\n                ...(options.temperature !== undefined ? { temperature: options.temperature } : {}),\n            }),\n        });\n\n        if (!response.ok) {\n            throw new Error(\n                `AI server returned HTTP ${response.status} for /generate`\n            );\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     * Generate a streaming response for a prompt via Server-Sent Events (SSE).\n     *\n     * Calls: POST {serverUrl}/stream\n     * Body:  { prompt, model, system?, maxTokens?, temperature? }\n     * Expected response: `text/event-stream` with `data: <chunk>` lines.\n     *\n     * @param prompt - The user prompt string\n     * @param options - Optional overrides (model, system, maxTokens, temperature)\n     * @returns An async generator yielding string chunks from the server\n     *\n     * @example\n     * ```typescript\n     * const stream = ai.stream('Tell me a story');\n     * for await (const chunk of stream) {\n     *   process.stdout.write(chunk);\n     * }\n     * ```\n     */\n    async *stream(prompt: string, options: GenerateOptions = {}): AsyncGenerator<string> {\n        this.assertInitialized();\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                prompt,\n                model,\n                ...(options.system !== undefined ? { system: options.system } : {}),\n                ...(options.maxTokens !== undefined ? { maxTokens: options.maxTokens } : {}),\n                ...(options.temperature !== undefined ? { temperature: options.temperature } : {}),\n            }),\n        });\n\n        if (!response.ok) {\n            throw new Error(\n                `AI server returned HTTP ${response.status} for /stream`\n            );\n        }\n\n        if (!response.body) {\n            throw new Error('AI server returned no response body for /stream');\n        }\n\n        const reader = response.body.getReader();\n        const decoder = new TextDecoder();\n        let buffer = '';\n\n        try {\n            while (true) {\n                const { done, value } = await reader.read();\n                if (done) break;\n\n                buffer += decoder.decode(value, { stream: true });\n                const lines = buffer.split('\\n');\n                // Keep the last (potentially incomplete) line in the buffer\n                buffer = lines.pop() ?? '';\n\n                for (const line of lines) {\n                    if (line.startsWith('data: ')) {\n                        const raw = line.slice(6).trim();\n                        if (raw === '[DONE]') return;\n                        try {\n                            const parsed = JSON.parse(raw) as {\n                                text?: string;\n                                content?: string;\n                                delta?: { content?: string };\n                            };\n                            const chunk =\n                                parsed.text ??\n                                parsed.content ??\n                                parsed.delta?.content ??\n                                '';\n                            if (chunk) yield chunk;\n                        } catch {\n                            // raw string chunk (non-JSON SSE)\n                            if (raw) yield raw;\n                        }\n                    }\n                }\n            }\n        } finally {\n            reader.releaseLock();\n        }\n    }\n\n    /**\n     * Multi-turn conversation: pass a full message history.\n     *\n     * Calls: POST {serverUrl}/chat\n     * Body:  { messages, model, maxTokens?, temperature? }\n     * Expected response: { text: string } or { content: string } or { message: string }\n     *\n     * @param messages - Full conversation history\n     * @param options - Optional overrides (model, maxTokens, temperature)\n     * @returns The assistant's response text\n     */\n    async chat(messages: ChatMessage[], options: GenerateOptions = {}): Promise<string> {\n        this.assertInitialized();\n        const model = options.model ?? this.resolvedModel;\n\n        const response = await fetch(`${this.serverUrl}/chat`, {\n            method: 'POST',\n            headers: this.authHeaders(),\n            body: JSON.stringify({\n                messages,\n                model,\n                ...(options.maxTokens !== undefined ? { maxTokens: options.maxTokens } : {}),\n                ...(options.temperature !== undefined ? { temperature: options.temperature } : {}),\n            }),\n        });\n\n        if (!response.ok) {\n            throw new Error(\n                `AI server returned HTTP ${response.status} for /chat`\n            );\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://ai.yourapp.com',\n * });\n *\n * await ai.initialize(); // validates key with server\n *\n * const text = await ai.generate('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://ai.yourapp.com',\n *   model: 'gpt-4o',\n * });\n * await ai.initialize();\n * const text = await ai.generate('Hello!');\n * ```\n *\n * @example Streaming\n * ```typescript\n * const ai = krutAI({\n *   apiKey: process.env.KRUTAI_API_KEY!,\n *   serverUrl: 'https://ai.yourapp.com',\n * });\n * await ai.initialize();\n *\n * const stream = ai.stream('Tell me a story');\n * for await (const chunk of stream) {\n *   process.stdout.write(chunk);\n * }\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://ai.yourapp.com',\n * });\n *\n * await ai.initialize();\n * const text = await ai.generate('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 = '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 single chat message\n */\nexport interface ChatMessage {\n    role: 'user' | 'assistant' | 'system';\n    content: string;\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","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     * 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 generate(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.maxTokens !== undefined ? { maxTokens: options.maxTokens } : {}),\n                ...(options.temperature !== undefined ? { temperature: options.temperature } : {}),\n            }),\n        });\n\n        if (!response.ok) {\n            throw new Error(\n                `AI server returned HTTP ${response.status} for /generate`\n            );\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     * Generate a streaming response for a prompt via Server-Sent Events (SSE).\n     *\n     * Calls: POST {serverUrl}/stream\n     * Body:  { prompt, model, system?, maxTokens?, temperature? }\n     * Expected response: `text/event-stream` with `data: <chunk>` lines.\n     *\n     * @param prompt - The user prompt string\n     * @param options - Optional overrides (model, system, maxTokens, temperature)\n     * @returns An async generator yielding string chunks from the server\n     *\n     * @example\n     * ```typescript\n     * const stream = ai.stream('Tell me a story');\n     * for await (const chunk of stream) {\n     *   process.stdout.write(chunk);\n     * }\n     * ```\n     */\n    async *stream(prompt: string, options: GenerateOptions = {}): AsyncGenerator<string> {\n        this.assertInitialized();\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                prompt,\n                model,\n                ...(options.system !== undefined ? { system: options.system } : {}),\n                ...(options.maxTokens !== undefined ? { maxTokens: options.maxTokens } : {}),\n                ...(options.temperature !== undefined ? { temperature: options.temperature } : {}),\n            }),\n        });\n\n        if (!response.ok) {\n            throw new Error(\n                `AI server returned HTTP ${response.status} for /stream`\n            );\n        }\n\n        if (!response.body) {\n            throw new Error('AI server returned no response body for /stream');\n        }\n\n        const reader = response.body.getReader();\n        const decoder = new TextDecoder();\n        let buffer = '';\n\n        try {\n            while (true) {\n                const { done, value } = await reader.read();\n                if (done) break;\n\n                buffer += decoder.decode(value, { stream: true });\n                const lines = buffer.split('\\n');\n                // Keep the last (potentially incomplete) line in the buffer\n                buffer = lines.pop() ?? '';\n\n                for (const line of lines) {\n                    if (line.startsWith('data: ')) {\n                        const raw = line.slice(6).trim();\n                        if (raw === '[DONE]') return;\n                        try {\n                            const parsed = JSON.parse(raw) as {\n                                text?: string;\n                                content?: string;\n                                delta?: { content?: string };\n                            };\n                            const chunk =\n                                parsed.text ??\n                                parsed.content ??\n                                parsed.delta?.content ??\n                                '';\n                            if (chunk) yield chunk;\n                        } catch {\n                            // raw string chunk (non-JSON SSE)\n                            if (raw) yield raw;\n                        }\n                    }\n                }\n            }\n        } finally {\n            reader.releaseLock();\n        }\n    }\n\n    /**\n     * Multi-turn conversation: pass a full message history.\n     *\n     * Calls: POST {serverUrl}/chat\n     * Body:  { messages, model, maxTokens?, temperature? }\n     * Expected response: { text: string } or { content: string } or { message: string }\n     *\n     * @param messages - Full conversation history\n     * @param options - Optional overrides (model, maxTokens, temperature)\n     * @returns The assistant's response text\n     */\n    async chat(messages: ChatMessage[], options: GenerateOptions = {}): Promise<string> {\n        this.assertInitialized();\n        const model = options.model ?? this.resolvedModel;\n\n        const response = await fetch(`${this.serverUrl}/chat`, {\n            method: 'POST',\n            headers: this.authHeaders(),\n            body: JSON.stringify({\n                messages,\n                model,\n                ...(options.maxTokens !== undefined ? { maxTokens: options.maxTokens } : {}),\n                ...(options.temperature !== undefined ? { temperature: options.temperature } : {}),\n            }),\n        });\n\n        if (!response.ok) {\n            throw new Error(\n                `AI server returned HTTP ${response.status} for /chat`\n            );\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.generate('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.generate('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 stream = ai.stream('Tell me a story');\n * for await (const chunk of stream) {\n *   process.stdout.write(chunk);\n * }\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.generate('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"]}

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/types.ts","../src/client.ts","../src/index.ts"],"names":["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,IAAA,oBAAA,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,MAAMA,yBAAA,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;AAAA;AAAA;AAAA,EAiBA,MAAM,QAAA,CAAS,MAAA,EAAgB,OAAA,GAA2B,EAAC,EAAoB;AAC3E,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,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,MAAM,IAAI,KAAA;AAAA,QACN,CAAA,wBAAA,EAA2B,SAAS,MAAM,CAAA,cAAA;AAAA,OAC9C;AAAA,IACJ;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;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAqBA,OAAO,MAAA,CAAO,MAAA,EAAgB,OAAA,GAA2B,EAAC,EAA2B;AACjF,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,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,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,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,MAAM,IAAI,KAAA;AAAA,QACN,CAAA,wBAAA,EAA2B,SAAS,MAAM,CAAA,YAAA;AAAA,OAC9C;AAAA,IACJ;AAEA,IAAA,IAAI,CAAC,SAAS,IAAA,EAAM;AAChB,MAAA,MAAM,IAAI,MAAM,iDAAiD,CAAA;AAAA,IACrE;AAEA,IAAA,MAAM,MAAA,GAAS,QAAA,CAAS,IAAA,CAAK,SAAA,EAAU;AACvC,IAAA,MAAM,OAAA,GAAU,IAAI,WAAA,EAAY;AAChC,IAAA,IAAI,MAAA,GAAS,EAAA;AAEb,IAAA,IAAI;AACA,MAAA,OAAO,IAAA,EAAM;AACT,QAAA,MAAM,EAAE,IAAA,EAAM,KAAA,EAAM,GAAI,MAAM,OAAO,IAAA,EAAK;AAC1C,QAAA,IAAI,IAAA,EAAM;AAEV,QAAA,MAAA,IAAU,QAAQ,MAAA,CAAO,KAAA,EAAO,EAAE,MAAA,EAAQ,MAAM,CAAA;AAChD,QAAA,MAAM,KAAA,GAAQ,MAAA,CAAO,KAAA,CAAM,IAAI,CAAA;AAE/B,QAAA,MAAA,GAAS,KAAA,CAAM,KAAI,IAAK,EAAA;AAExB,QAAA,KAAA,MAAW,QAAQ,KAAA,EAAO;AACtB,UAAA,IAAI,IAAA,CAAK,UAAA,CAAW,QAAQ,CAAA,EAAG;AAC3B,YAAA,MAAM,GAAA,GAAM,IAAA,CAAK,KAAA,CAAM,CAAC,EAAE,IAAA,EAAK;AAC/B,YAAA,IAAI,QAAQ,QAAA,EAAU;AACtB,YAAA,IAAI;AACA,cAAA,MAAM,MAAA,GAAS,IAAA,CAAK,KAAA,CAAM,GAAG,CAAA;AAK7B,cAAA,MAAM,QACF,MAAA,CAAO,IAAA,IACP,OAAO,OAAA,IACP,MAAA,CAAO,OAAO,OAAA,IACd,EAAA;AACJ,cAAA,IAAI,OAAO,MAAM,KAAA;AAAA,YACrB,CAAA,CAAA,MAAQ;AAEJ,cAAA,IAAI,KAAK,MAAM,GAAA;AAAA,YACnB;AAAA,UACJ;AAAA,QACJ;AAAA,MACJ;AAAA,IACJ,CAAA,SAAE;AACE,MAAA,MAAA,CAAO,WAAA,EAAY;AAAA,IACvB;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAaA,MAAM,IAAA,CAAK,QAAA,EAAyB,OAAA,GAA2B,EAAC,EAAoB;AAChF,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,KAAA,CAAA,EAAS;AAAA,MACnD,MAAA,EAAQ,MAAA;AAAA,MACR,OAAA,EAAS,KAAK,WAAA,EAAY;AAAA,MAC1B,IAAA,EAAM,KAAK,SAAA,CAAU;AAAA,QACjB,QAAA;AAAA,QACA,KAAA;AAAA,QACA,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,MAAM,IAAI,KAAA;AAAA,QACN,CAAA,wBAAA,EAA2B,SAAS,MAAM,CAAA,UAAA;AAAA,OAC9C;AAAA,IACJ;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;AC5MO,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.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 single chat message\n */\nexport interface ChatMessage {\n    role: 'user' | 'assistant' | 'system';\n    content: string;\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","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     * 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 generate(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.maxTokens !== undefined ? { maxTokens: options.maxTokens } : {}),\n                ...(options.temperature !== undefined ? { temperature: options.temperature } : {}),\n            }),\n        });\n\n        if (!response.ok) {\n            throw new Error(\n                `AI server returned HTTP ${response.status} for /generate`\n            );\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     * Generate a streaming response for a prompt via Server-Sent Events (SSE).\n     *\n     * Calls: POST {serverUrl}/stream\n     * Body:  { prompt, model, system?, maxTokens?, temperature? }\n     * Expected response: `text/event-stream` with `data: <chunk>` lines.\n     *\n     * @param prompt - The user prompt string\n     * @param options - Optional overrides (model, system, maxTokens, temperature)\n     * @returns An async generator yielding string chunks from the server\n     *\n     * @example\n     * ```typescript\n     * const stream = ai.stream('Tell me a story');\n     * for await (const chunk of stream) {\n     *   process.stdout.write(chunk);\n     * }\n     * ```\n     */\n    async *stream(prompt: string, options: GenerateOptions = {}): AsyncGenerator<string> {\n        this.assertInitialized();\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                prompt,\n                model,\n                ...(options.system !== undefined ? { system: options.system } : {}),\n                ...(options.maxTokens !== undefined ? { maxTokens: options.maxTokens } : {}),\n                ...(options.temperature !== undefined ? { temperature: options.temperature } : {}),\n            }),\n        });\n\n        if (!response.ok) {\n            throw new Error(\n                `AI server returned HTTP ${response.status} for /stream`\n            );\n        }\n\n        if (!response.body) {\n            throw new Error('AI server returned no response body for /stream');\n        }\n\n        const reader = response.body.getReader();\n        const decoder = new TextDecoder();\n        let buffer = '';\n\n        try {\n            while (true) {\n                const { done, value } = await reader.read();\n                if (done) break;\n\n                buffer += decoder.decode(value, { stream: true });\n                const lines = buffer.split('\\n');\n                // Keep the last (potentially incomplete) line in the buffer\n                buffer = lines.pop() ?? '';\n\n                for (const line of lines) {\n                    if (line.startsWith('data: ')) {\n                        const raw = line.slice(6).trim();\n                        if (raw === '[DONE]') return;\n                        try {\n                            const parsed = JSON.parse(raw) as {\n                                text?: string;\n                                content?: string;\n                                delta?: { content?: string };\n                            };\n                            const chunk =\n                                parsed.text ??\n                                parsed.content ??\n                                parsed.delta?.content ??\n                                '';\n                            if (chunk) yield chunk;\n                        } catch {\n                            // raw string chunk (non-JSON SSE)\n                            if (raw) yield raw;\n                        }\n                    }\n                }\n            }\n        } finally {\n            reader.releaseLock();\n        }\n    }\n\n    /**\n     * Multi-turn conversation: pass a full message history.\n     *\n     * Calls: POST {serverUrl}/chat\n     * Body:  { messages, model, maxTokens?, temperature? }\n     * Expected response: { text: string } or { content: string } or { message: string }\n     *\n     * @param messages - Full conversation history\n     * @param options - Optional overrides (model, maxTokens, temperature)\n     * @returns The assistant's response text\n     */\n    async chat(messages: ChatMessage[], options: GenerateOptions = {}): Promise<string> {\n        this.assertInitialized();\n        const model = options.model ?? this.resolvedModel;\n\n        const response = await fetch(`${this.serverUrl}/chat`, {\n            method: 'POST',\n            headers: this.authHeaders(),\n            body: JSON.stringify({\n                messages,\n                model,\n                ...(options.maxTokens !== undefined ? { maxTokens: options.maxTokens } : {}),\n                ...(options.temperature !== undefined ? { temperature: options.temperature } : {}),\n            }),\n        });\n\n        if (!response.ok) {\n            throw new Error(\n                `AI server returned HTTP ${response.status} for /chat`\n            );\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://ai.yourapp.com',\n * });\n *\n * await ai.initialize(); // validates key with server\n *\n * const text = await ai.generate('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://ai.yourapp.com',\n *   model: 'gpt-4o',\n * });\n * await ai.initialize();\n * const text = await ai.generate('Hello!');\n * ```\n *\n * @example Streaming\n * ```typescript\n * const ai = krutAI({\n *   apiKey: process.env.KRUTAI_API_KEY!,\n *   serverUrl: 'https://ai.yourapp.com',\n * });\n * await ai.initialize();\n *\n * const stream = ai.stream('Tell me a story');\n * for await (const chunk of stream) {\n *   process.stdout.write(chunk);\n * }\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://ai.yourapp.com',\n * });\n *\n * await ai.initialize();\n * const text = await ai.generate('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":["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 single chat message\n */\nexport interface ChatMessage {\n    role: 'user' | 'assistant' | 'system';\n    content: string;\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","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     * 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 generate(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.maxTokens !== undefined ? { maxTokens: options.maxTokens } : {}),\n                ...(options.temperature !== undefined ? { temperature: options.temperature } : {}),\n            }),\n        });\n\n        if (!response.ok) {\n            throw new Error(\n                `AI server returned HTTP ${response.status} for /generate`\n            );\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     * Generate a streaming response for a prompt via Server-Sent Events (SSE).\n     *\n     * Calls: POST {serverUrl}/stream\n     * Body:  { prompt, model, system?, maxTokens?, temperature? }\n     * Expected response: `text/event-stream` with `data: <chunk>` lines.\n     *\n     * @param prompt - The user prompt string\n     * @param options - Optional overrides (model, system, maxTokens, temperature)\n     * @returns An async generator yielding string chunks from the server\n     *\n     * @example\n     * ```typescript\n     * const stream = ai.stream('Tell me a story');\n     * for await (const chunk of stream) {\n     *   process.stdout.write(chunk);\n     * }\n     * ```\n     */\n    async *stream(prompt: string, options: GenerateOptions = {}): AsyncGenerator<string> {\n        this.assertInitialized();\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                prompt,\n                model,\n                ...(options.system !== undefined ? { system: options.system } : {}),\n                ...(options.maxTokens !== undefined ? { maxTokens: options.maxTokens } : {}),\n                ...(options.temperature !== undefined ? { temperature: options.temperature } : {}),\n            }),\n        });\n\n        if (!response.ok) {\n            throw new Error(\n                `AI server returned HTTP ${response.status} for /stream`\n            );\n        }\n\n        if (!response.body) {\n            throw new Error('AI server returned no response body for /stream');\n        }\n\n        const reader = response.body.getReader();\n        const decoder = new TextDecoder();\n        let buffer = '';\n\n        try {\n            while (true) {\n                const { done, value } = await reader.read();\n                if (done) break;\n\n                buffer += decoder.decode(value, { stream: true });\n                const lines = buffer.split('\\n');\n                // Keep the last (potentially incomplete) line in the buffer\n                buffer = lines.pop() ?? '';\n\n                for (const line of lines) {\n                    if (line.startsWith('data: ')) {\n                        const raw = line.slice(6).trim();\n                        if (raw === '[DONE]') return;\n                        try {\n                            const parsed = JSON.parse(raw) as {\n                                text?: string;\n                                content?: string;\n                                delta?: { content?: string };\n                            };\n                            const chunk =\n                                parsed.text ??\n                                parsed.content ??\n                                parsed.delta?.content ??\n                                '';\n                            if (chunk) yield chunk;\n                        } catch {\n                            // raw string chunk (non-JSON SSE)\n                            if (raw) yield raw;\n                        }\n                    }\n                }\n            }\n        } finally {\n            reader.releaseLock();\n        }\n    }\n\n    /**\n     * Multi-turn conversation: pass a full message history.\n     *\n     * Calls: POST {serverUrl}/chat\n     * Body:  { messages, model, maxTokens?, temperature? }\n     * Expected response: { text: string } or { content: string } or { message: string }\n     *\n     * @param messages - Full conversation history\n     * @param options - Optional overrides (model, maxTokens, temperature)\n     * @returns The assistant's response text\n     */\n    async chat(messages: ChatMessage[], options: GenerateOptions = {}): Promise<string> {\n        this.assertInitialized();\n        const model = options.model ?? this.resolvedModel;\n\n        const response = await fetch(`${this.serverUrl}/chat`, {\n            method: 'POST',\n            headers: this.authHeaders(),\n            body: JSON.stringify({\n                messages,\n                model,\n                ...(options.maxTokens !== undefined ? { maxTokens: options.maxTokens } : {}),\n                ...(options.temperature !== undefined ? { temperature: options.temperature } : {}),\n            }),\n        });\n\n        if (!response.ok) {\n            throw new Error(\n                `AI server returned HTTP ${response.status} for /chat`\n            );\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.generate('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.generate('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 stream = ai.stream('Tell me a story');\n * for await (const chunk of stream) {\n *   process.stdout.write(chunk);\n * }\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.generate('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"]}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@krutai/ai-provider",
-    "version": "0.2.3",
+    "version": "0.2.4",
     "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",