@krutai/ai-provider 0.2.1 → 0.2.2

package/AI_REFERENCE.md

@@ -3,7 +3,7 @@
 ## Package Overview
 
 - **Name**: `@krutai/ai-provider`
-- **Version**: `0.2.0`
+- **Version**: `0.2.2`
 - **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.0
+@krutai/ai-provider@0.2.2
  └── peerDep: krutai  (core utilities)
 
 AI Flow:
@@ -57,7 +57,8 @@ import { krutAI } from '@krutai/ai-provider';
 
 const ai = krutAI({
   apiKey: process.env.KRUTAI_API_KEY!,
-  serverUrl: 'https://ai.yourapp.com',
+  // uses http://localhost:8000 by default for local development
+  // serverUrl: 'https://ai.yourapp.com',
 });
 
 await ai.initialize(); // validates key with server
@@ -72,7 +73,7 @@ import { KrutAIProvider } from '@krutai/ai-provider';
 
 const ai = new KrutAIProvider({
   apiKey: process.env.KRUTAI_API_KEY!,
-  serverUrl: 'https://ai.yourapp.com',
+  // serverUrl: 'https://ai.yourapp.com', // Optional: defaults to localhost:8000
   model: 'gpt-4o',         // optional, default: 'default'
   validateOnInit: true,     // default: true
 });
@@ -95,7 +96,7 @@ await ai.initialize();
 ```typescript
 interface KrutAIProviderConfig {
   apiKey: string;         // KrutAI API key — validated with server (required)
-  serverUrl: string;      // Base URL of deployed LangChain server (required)
+  serverUrl?: string;     // Base URL of deployed LangChain server (default: 'http://localhost:8000')
   model?: string;         // default: 'default'
   validateOnInit?: boolean; // default: true
 }
@@ -141,7 +142,7 @@ export { validateApiKey, validateApiKeyFormat, KrutAIKeyValidationError };
 
 ## Important Notes
 
-1. **`serverUrl` is required** — point it at your deployed LangChain backend
+1. **`serverUrl` defaults to `http://localhost:8000`** — make sure to override this with your deployed LangChain backend in production
 2. **`apiKey` is validated server-side** — the server controls what keys are valid
 3. **Streaming uses SSE** — server must respond with `Content-Type: text/event-stream`
 4. **No external SDK needed** — uses native `fetch` only (Node 18+, browser, edge runtimes)

package/README.md

@@ -23,7 +23,8 @@ import { krutAI } from '@krutai/ai-provider';
 
 const ai = krutAI({
   apiKey: 'your-krutai-api-key',
-  serverUrl: 'https://ai.yourapp.com', // your deployed LangChain server
+  // Optional: omitted to use the default local dev server ('http://localhost:8000')
+  // serverUrl: 'https://ai.yourapp.com',
 });
 
 await ai.initialize(); // validates key with your server
@@ -40,7 +41,7 @@ console.log(text);
 ```typescript
 const ai = krutAI({
   apiKey: process.env.KRUTAI_API_KEY!,
-  serverUrl: 'https://ai.yourapp.com',
+  serverUrl: 'https://ai.yourapp.com', // Override default for production
   model: 'gpt-4o', // optional — server's default is used if omitted
 });
 
@@ -60,7 +61,7 @@ console.log(text);
 ```typescript
 const ai = krutAI({
   apiKey: process.env.KRUTAI_API_KEY!,
-  serverUrl: 'https://ai.yourapp.com',
+  // uses http://localhost:8000 by default
 });
 
 await ai.initialize();
@@ -76,7 +77,6 @@ for await (const chunk of ai.stream('Tell me a short story')) {
 ```typescript
 const ai = krutAI({
   apiKey: process.env.KRUTAI_API_KEY!,
-  serverUrl: 'https://ai.yourapp.com',
 });
 
 await ai.initialize();
@@ -129,9 +129,9 @@ Factory function — preferred way to create a provider.
 
 ```typescript
 const ai = krutAI({
-  apiKey: string;      // required
-  serverUrl: string;   // required — base URL of your LangChain server
-  model?: string;      // optional — passed to server (default: 'default')
+  apiKey: string;           // required — KrutAI API key
+  serverUrl?: string;       // optional — defaults to 'http://localhost:8000'
+  model?: string;           // optional — passed to server (default: 'default')
   validateOnInit?: boolean; // optional — default: true
 });
 ```

package/package.json

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