@agentionai/agents 0.3.1 → 0.4.1

package/README.md

@@ -10,25 +10,38 @@ A comprehensive TypeScript toolkit for building LLM-powered agents with RAG, and
 
 ## Quick Start
 
+### 1. Install
+
+Install only what you need with selective imports:
+
 ```bash
-npm install @agentionai/agents
+# Install core library + Claude SDK
+npm install @agentionai/agents @anthropic-ai/sdk
 ```
 
-Install provider SDKs as needed:
+### 2. Get API Key
+
+Get an API key from your chosen provider:
+
+- **Claude**: [console.anthropic.com](https://console.anthropic.com/)
+- **OpenAI**: [platform.openai.com](https://platform.openai.com/api-keys)
+- **Gemini**: [aistudio.google.com](https://aistudio.google.com/app/apikey)
+- **Mistral**: [console.mistral.ai](https://console.mistral.ai/)
+
+Set it as an environment variable:
 
 ```bash
-npm install @anthropic-ai/sdk  # For Claude
-npm install openai             # For OpenAI/GPT
-npm install @google/generative-ai  # For Gemini
-npm install @mistralai/mistralai   # For Mistral
+export ANTHROPIC_API_KEY=your-key-here
 ```
 
-### Simple Agent
+### 3. Create Your First Agent
 
 ```typescript
-import { ClaudeAgent } from '@agentionai/agents';
+// Import only Claude - no other agent SDKs required!
+import { ClaudeAgent } from '@agentionai/agents/claude';
 
 const agent = new ClaudeAgent({
+  apiKey: process.env.ANTHROPIC_API_KEY,  // Or pass directly (not recommended for production)
   model: 'claude-sonnet-4-5',
   name: 'Assistant',
   description: 'You are a helpful assistant.',
@@ -38,6 +51,23 @@ const response = await agent.execute('What can you help me with?');
 console.log(response);
 ```
 
+### Selective Imports
+
+Import only the agents you need:
+
+```typescript
+import { ClaudeAgent } from '@agentionai/agents/claude';    // Requires @anthropic-ai/sdk
+import { OpenAiAgent } from '@agentionai/agents/openai';    // Requires openai
+import { GeminiAgent } from '@agentionai/agents/gemini';    // Requires @google/generative-ai
+import { MistralAgent } from '@agentionai/agents/mistral';  // Requires @mistralai/mistralai
+```
+
+Or import everything (requires all SDKs):
+
+```typescript
+import { ClaudeAgent, OpenAiAgent } from '@agentionai/agents';
+```
+
 
 ## Features
 
@@ -51,7 +81,7 @@ console.log(response);
 ### Agent with Tools
 
 ```typescript
-import { GeminiAgent, Tool } from '@agentionai/agents';
+import { GeminiAgent, Tool } from '@agentionai/agents/gemini';
 
 const weatherTool = new Tool({
   name: 'get_weather',
@@ -74,6 +104,7 @@ const weatherTool = new Tool({
 });
 
 const agent = new GeminiAgent({
+  apiKey: process.env.GEMINI_API_KEY,
   model: 'gemini-flash-lite-latest',
   name: 'Weather Agent',
   description: 'You are a weather assistant.',
@@ -88,9 +119,12 @@ const response = await agent.execute("What's the weather in Paris?");
 Chain agents together with different providers and models:
 
 ```typescript
-import { ClaudeAgent, OpenAiAgent, Pipeline } from '@agentionai/agents';
+import { ClaudeAgent } from '@agentionai/agents/claude';
+import { OpenAiAgent } from '@agentionai/agents/openai';
+import { Pipeline } from '@agentionai/agents/core';
 
 const researcher = new OpenAiAgent({
+  apiKey: process.env.OPENAI_API_KEY,
   id: 'researcher',
   name: 'Researcher',
   description: 'Research the given topic and provide key facts.',
@@ -99,6 +133,7 @@ const researcher = new OpenAiAgent({
 });
 
 const writer = new ClaudeAgent({
+  apiKey: process.env.ANTHROPIC_API_KEY,
   id: 'writer',
   name: 'Writer',
   description: 'Write a blog post based on the research provided.',
@@ -114,10 +149,12 @@ const result = await pipeline.execute('Renewable energy trends in 2024');
 Use agents as tools for hierarchical workflows:
 
 ```typescript
-import { ClaudeAgent, OpenAiAgent, Tool } from '@agentionai/agents';
+import { ClaudeAgent } from '@agentionai/agents/claude';
+import { OpenAiAgent } from '@agentionai/agents/openai';
 
 // Research assistant (cheaper model for data gathering)
 const researchAssistant = new OpenAiAgent({
+  apiKey: process.env.OPENAI_API_KEY,
   id: 'research-assistant',
   name: 'Research Assistant',
   description: 'Search and summarize information on topics.',
@@ -127,6 +164,7 @@ const researchAssistant = new OpenAiAgent({
 
 // Lead researcher delegates to assistant, synthesizes findings
 const researcher = new ClaudeAgent({
+  apiKey: process.env.ANTHROPIC_API_KEY,
   id: 'researcher',
   name: 'Lead Researcher',
   description: 'Research topics thoroughly using your assistant.',

package/dist/agents/Agent.d.ts

@@ -23,7 +23,7 @@ type MistralAgentConfig = Omit<BaseAgentConfig, "vendor" | "model"> & {
 };
 type AgentConfig = ClaudeAgentConfig | OpenAIAgentConfig | GeminiAgentConfig | MistralAgentConfig;
 export declare class Agent {
-    static create(config: AgentConfig, history?: History): ClaudeAgent | OpenAiAgent | MistralAgent | GeminiAgent;
+    static create(config: AgentConfig, history?: History): ClaudeAgent | OpenAiAgent | GeminiAgent | MistralAgent;
 }
 export {};
 //# sourceMappingURL=Agent.d.ts.map

package/dist/claude.d.ts

@@ -0,0 +1,9 @@
+export * from "./agents/BaseAgent";
+export * from "./agents/anthropic/ClaudeAgent";
+export * from "./agents/model-types";
+export { anthropicTransformer } from "./history/transformers";
+export * from "./history/History";
+export * from "./history/types";
+export * from "./tools/Tool";
+export * from "./graph/AgentGraph";
+//# sourceMappingURL=claude.d.ts.map

package/dist/claude.js

@@ -0,0 +1,29 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.anthropicTransformer = void 0;
+// Claude Agent Entry Point
+__exportStar(require("./agents/BaseAgent"), exports);
+__exportStar(require("./agents/anthropic/ClaudeAgent"), exports);
+__exportStar(require("./agents/model-types"), exports);
+var transformers_1 = require("./history/transformers");
+Object.defineProperty(exports, "anthropicTransformer", { enumerable: true, get: function () { return transformers_1.anthropicTransformer; } });
+// Re-export core functionality
+__exportStar(require("./history/History"), exports);
+__exportStar(require("./history/types"), exports);
+__exportStar(require("./tools/Tool"), exports);
+__exportStar(require("./graph/AgentGraph"), exports);
+//# sourceMappingURL=claude.js.map

package/dist/core.d.ts

@@ -0,0 +1,15 @@
+export * from "./agents/BaseAgent";
+export * from "./agents/Agent";
+export * from "./agents/model-types";
+export * from "./agents/AgentConfig";
+export * from "./agents/AgentEvent";
+export * from "./agents/errors/AgentError";
+export * from "./history/History";
+export * from "./history/types";
+export * from "./graph/AgentGraph";
+export * from "./tools/Tool";
+export * from "./viz";
+export * from "./vectorstore";
+export * from "./chunkers";
+export * from "./ingestion";
+//# sourceMappingURL=core.d.ts.map

package/dist/core.js

@@ -0,0 +1,39 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Core functionality without any agent implementations
+__exportStar(require("./agents/BaseAgent"), exports);
+__exportStar(require("./agents/Agent"), exports);
+__exportStar(require("./agents/model-types"), exports);
+__exportStar(require("./agents/AgentConfig"), exports);
+__exportStar(require("./agents/AgentEvent"), exports);
+__exportStar(require("./agents/errors/AgentError"), exports);
+// History
+__exportStar(require("./history/History"), exports);
+__exportStar(require("./history/types"), exports);
+// Graph
+__exportStar(require("./graph/AgentGraph"), exports);
+// Tools
+__exportStar(require("./tools/Tool"), exports);
+// Visualization
+__exportStar(require("./viz"), exports);
+// Vector Store
+__exportStar(require("./vectorstore"), exports);
+// Chunkers
+__exportStar(require("./chunkers"), exports);
+// Ingestion
+__exportStar(require("./ingestion"), exports);
+//# sourceMappingURL=core.js.map

package/dist/gemini.d.ts

@@ -0,0 +1,9 @@
+export * from "./agents/BaseAgent";
+export { GeminiAgent } from "./agents/google/GeminiAgent";
+export * from "./agents/model-types";
+export { geminiTransformer } from "./history/transformers";
+export * from "./history/History";
+export * from "./history/types";
+export * from "./tools/Tool";
+export * from "./graph/AgentGraph";
+//# sourceMappingURL=gemini.d.ts.map

package/dist/gemini.js

@@ -0,0 +1,30 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.geminiTransformer = exports.GeminiAgent = void 0;
+// Gemini Agent Entry Point
+__exportStar(require("./agents/BaseAgent"), exports);
+var GeminiAgent_1 = require("./agents/google/GeminiAgent");
+Object.defineProperty(exports, "GeminiAgent", { enumerable: true, get: function () { return GeminiAgent_1.GeminiAgent; } });
+__exportStar(require("./agents/model-types"), exports);
+var transformers_1 = require("./history/transformers");
+Object.defineProperty(exports, "geminiTransformer", { enumerable: true, get: function () { return transformers_1.geminiTransformer; } });
+// Re-export core functionality
+__exportStar(require("./history/History"), exports);
+__exportStar(require("./history/types"), exports);
+__exportStar(require("./tools/Tool"), exports);
+__exportStar(require("./graph/AgentGraph"), exports);
+//# sourceMappingURL=gemini.js.map

package/dist/index.js

@@ -1,4 +1,12 @@
 "use strict";
+// Main index - exports all agents (requires all peer dependencies)
+// For selective imports, use sub-paths:
+//   import { ClaudeAgent } from "@agentionai/agents/claude";
+//   import { OpenAiAgent } from "@agentionai/agents/openai";
+//   import { MistralAgent } from "@agentionai/agents/mistral";
+//   import { GeminiAgent } from "@agentionai/agents/gemini";
+// Or use core-only imports:
+//   import { BaseAgent } from "@agentionai/agents/core";
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);

package/dist/mistral.d.ts

@@ -0,0 +1,9 @@
+export * from "./agents/BaseAgent";
+export { MistralAgent } from "./agents/mistral/MistralAgent";
+export * from "./agents/model-types";
+export { mistralTransformer } from "./history/transformers";
+export * from "./history/History";
+export * from "./history/types";
+export * from "./tools/Tool";
+export * from "./graph/AgentGraph";
+//# sourceMappingURL=mistral.d.ts.map

package/dist/mistral.js

@@ -0,0 +1,30 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mistralTransformer = exports.MistralAgent = void 0;
+// Mistral Agent Entry Point
+__exportStar(require("./agents/BaseAgent"), exports);
+var MistralAgent_1 = require("./agents/mistral/MistralAgent");
+Object.defineProperty(exports, "MistralAgent", { enumerable: true, get: function () { return MistralAgent_1.MistralAgent; } });
+__exportStar(require("./agents/model-types"), exports);
+var transformers_1 = require("./history/transformers");
+Object.defineProperty(exports, "mistralTransformer", { enumerable: true, get: function () { return transformers_1.mistralTransformer; } });
+// Re-export core functionality
+__exportStar(require("./history/History"), exports);
+__exportStar(require("./history/types"), exports);
+__exportStar(require("./tools/Tool"), exports);
+__exportStar(require("./graph/AgentGraph"), exports);
+//# sourceMappingURL=mistral.js.map

package/dist/openai.d.ts

@@ -0,0 +1,9 @@
+export * from "./agents/BaseAgent";
+export { OpenAiAgent } from "./agents/openai/OpenAiAgent";
+export * from "./agents/model-types";
+export { openAiTransformer } from "./history/transformers";
+export * from "./history/History";
+export * from "./history/types";
+export * from "./tools/Tool";
+export * from "./graph/AgentGraph";
+//# sourceMappingURL=openai.d.ts.map

package/dist/openai.js

@@ -0,0 +1,30 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.openAiTransformer = exports.OpenAiAgent = void 0;
+// OpenAI Agent Entry Point
+__exportStar(require("./agents/BaseAgent"), exports);
+var OpenAiAgent_1 = require("./agents/openai/OpenAiAgent");
+Object.defineProperty(exports, "OpenAiAgent", { enumerable: true, get: function () { return OpenAiAgent_1.OpenAiAgent; } });
+__exportStar(require("./agents/model-types"), exports);
+var transformers_1 = require("./history/transformers");
+Object.defineProperty(exports, "openAiTransformer", { enumerable: true, get: function () { return transformers_1.openAiTransformer; } });
+// Re-export core functionality
+__exportStar(require("./history/History"), exports);
+__exportStar(require("./history/types"), exports);
+__exportStar(require("./tools/Tool"), exports);
+__exportStar(require("./graph/AgentGraph"), exports);
+//# sourceMappingURL=openai.js.map

package/package.json

@@ -1,10 +1,36 @@
 {
   "name": "@agentionai/agents",
   "author": "Laurent Zuijdwijk",
-  "version": "0.3.1",
+  "version": "0.4.1",
   "description": "Agent Library",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./core": {
+      "types": "./dist/core.d.ts",
+      "default": "./dist/core.js"
+    },
+    "./claude": {
+      "types": "./dist/claude.d.ts",
+      "default": "./dist/claude.js"
+    },
+    "./openai": {
+      "types": "./dist/openai.d.ts",
+      "default": "./dist/openai.js"
+    },
+    "./mistral": {
+      "types": "./dist/mistral.d.ts",
+      "default": "./dist/mistral.js"
+    },
+    "./gemini": {
+      "types": "./dist/gemini.d.ts",
+      "default": "./dist/gemini.js"
+    }
+  },
   "files": [
     "dist/**/*.js",
     "dist/**/*.d.ts",