agent-pulse 1.0.0 → 1.1.0

package/README.md

@@ -36,13 +36,21 @@ import { Agent, openAI } from 'agent-pulse';
 import * as dotenv from 'dotenv';
 dotenv.config();
 
-// Instantiate the provider directly
+// Option A: Use environment variables (OPENAI_API_KEY)
 const agent = new Agent({
   name: 'my-bot',
-  provider: new openAI('gpt-4o'), // Or new google('gemini-1.5-pro'), new grok('grok-beta')
+  provider: new openAI('gpt-4o'),
   system: 'You are a helpful assistant.'
 });
 
+// Option B: Pass API key directly (Recommended for Serverless/Vercel)
+const agentWithKey = new Agent({
+  name: 'secure-bot',
+  provider: new openAI('gpt-4o', process.env.CUSTOM_KEY_NAME || 'your-key'),
+  system: 'You are a helpful assistant.'
+});
+```
+
 // Real-time typing effect
 agent.on('token', (chunk) => {
   process.stdout.write(chunk);
@@ -118,7 +126,7 @@ import { Agent, OpenAIProvider, GoogleProvider, GrokProvider } from 'agent-pulse
 | Option | Type | Description |
 |---|---|---|
 | `name` | string | Unique identifier for debugging. |
-| `provider` | LLMProvider | An instance of a provider class (e.g., `new OpenAIProvider(...)`). |
+| `provider` | LLMProvider | An instance of a provider class (e.g., `new openAI('model', 'optional_key')`). |
 | `system` | string | System instructions. |
 | `prompt` | string | Base prompt template (optional). |
 | `files` | string[] | Array of file paths or content strings to include in context. |

package/dist/providers/google.d.ts

@@ -3,6 +3,6 @@ import { z } from 'zod';
 export declare class GoogleProvider implements LLMProvider {
     private client;
     private model;
-    constructor(model: string);
+    constructor(model: string, apiKey?: string);
     generate(system: string | undefined, prompt: string | any[], files: string[] | undefined, tools: AgentTool[] | undefined, config: Record<string, any> | undefined, output_schema: z.ZodType<any> | undefined, onToken: (token: string) => void): Promise<AgentResponse>;
 }

package/dist/providers/google.js

@@ -5,10 +5,11 @@ const genai_1 = require("@google/genai");
 const zod_1 = require("zod");
 const file_utils_1 = require("../utils/file-utils");
 class GoogleProvider {
-    constructor(model) {
+    constructor(model, apiKey) {
         // Google GenAI SDK expects model names in format "models/model-name"
         this.model = model.startsWith('models/') ? model : `models/${model}`;
-        this.client = new genai_1.GoogleGenAI({ apiKey: process.env.GOOGLE_API_KEY });
+        const key = apiKey || process.env.GOOGLE_API_KEY;
+        this.client = new genai_1.GoogleGenAI({ apiKey: key });
     }
     async generate(system, prompt, files, tools, config, output_schema, onToken) {
         // 1. Prepare Tools

package/dist/providers/grok.d.ts

@@ -3,6 +3,6 @@ import { z } from 'zod';
 export declare class GrokProvider implements LLMProvider {
     private client;
     private model;
-    constructor(model: string);
+    constructor(model: string, apiKey?: string);
     generate(system: string | undefined, prompt: string | any[], files: string[] | undefined, tools: AgentTool[] | undefined, config: Record<string, any> | undefined, output_schema: z.ZodType<any> | undefined, onToken: (token: string) => void): Promise<AgentResponse>;
 }

package/dist/providers/grok.js

@@ -8,11 +8,12 @@ const openai_1 = __importDefault(require("openai"));
 const zod_1 = require("zod");
 const file_utils_1 = require("../utils/file-utils");
 class GrokProvider {
-    constructor(model) {
+    constructor(model, apiKey) {
         this.model = model;
+        const key = apiKey || process.env.GROK_API_KEY;
         // Grok uses the OpenAI SDK with a custom base URL
         this.client = new openai_1.default({
-            apiKey: process.env.GROK_API_KEY,
+            apiKey: key,
             baseURL: 'https://api.x.ai/v1',
         });
     }

package/dist/providers/openai.d.ts

@@ -3,6 +3,6 @@ import { z } from 'zod';
 export declare class OpenAIProvider implements LLMProvider {
     private client;
     private model;
-    constructor(model: string);
+    constructor(model: string, apiKey?: string);
     generate(system: string | undefined, prompt: string | any[], files: string[] | undefined, tools: AgentTool[] | undefined, config: Record<string, any> | undefined, output_schema: z.ZodType<any> | undefined, onToken: (token: string) => void): Promise<AgentResponse>;
 }

package/dist/providers/openai.js

@@ -8,10 +8,11 @@ const openai_1 = __importDefault(require("openai"));
 const zod_1 = require("zod");
 const file_utils_1 = require("../utils/file-utils");
 class OpenAIProvider {
-    constructor(model) {
+    constructor(model, apiKey) {
         this.model = model;
+        const key = apiKey || process.env.OPENAI_API_KEY;
         this.client = new openai_1.default({
-            apiKey: process.env.OPENAI_API_KEY,
+            apiKey: key,
         });
     }
     async generate(system, prompt, files, tools, config, output_schema, onToken) {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "agent-pulse",
-    "version": "1.0.0",
+    "version": "1.1.0",
     "description": "A lightweight, agentic AI framework for JavaScript/TypeScript",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",