@agentionai/agents 0.3.0-beta → 0.4.0

package/README.md

@@ -1,517 +1,230 @@
 # Agention
 
-> A TypeScript library for building AI-powered agents, tools, and complex workflows
+> AI Agents Without the Magic
 
 [![npm version](https://img.shields.io/npm/v/@agentionai/agents.svg)](https://www.npmjs.com/package/@agentionai/agents)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-Agention provides a clean, modular architecture for working with LLMs from multiple providers. Build single-purpose agents or orchestrate complex multi-agent workflows with built-in tools, vector search, and document processing capabilities.
+A comprehensive TypeScript toolkit for building LLM-powered agents with RAG, and multi-agent workflows. No hidden state machines, no forced abstractions—just typed agents, composable graphs, and complete control in a complete toolkit.
 
-## Features
-
-- **🤖 Multi-Provider Support** - Works with Claude, OpenAI, Mistral, and Google Gemini out of the box
-- **🔧 Powerful Tool System** - Define tools with JSON Schema validation, agents use them automatically
-- **🔀 Graph Pipelines** - Chain agents together with sequential, parallel, map, voting, and router patterns
-- **💾 Vector Search** - Built-in LanceDB integration for semantic search and RAG applications
-- **📄 Document Processing** - Intelligent chunking with token-aware splitting and metadata tracking
-- **📊 Metrics & Observability** - Track tokens, timing, and pipeline execution
-- **🔒 Type-Safe** - Full TypeScript support with strict typing throughout
-
-## Installation
+**[Documentation](https://docs.agention.ai/)** • **[Examples](https://docs.agention.ai/guide/examples)** • **[GitHub](https://github.com/laurentzuijdwijk/agention-lib)**
 
-```bash
-npm install @agentionai/agents
-```
+## Quick Start
 
-Install the SDK for your chosen LLM provider:
+Install only what you need with selective imports:
 
 ```bash
-# For Claude
-npm install @anthropic-ai/sdk
-
-# For OpenAI
-npm install openai
-
-# For vector search (optional)
-npm install @lancedb/lancedb apache-arrow
+# Install core library + Claude SDK
+npm install @agentionai/agents @anthropic-ai/sdk
 ```
 
-## Quick Start
-
-### Basic 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({
-  model: 'claude-sonnet-4-20250514',
-  systemPrompt: 'You are a helpful assistant.',
+  model: 'claude-sonnet-4-5',
+  name: 'Assistant',
+  description: 'You are a helpful assistant.',
 });
 
-const response = await agent.execute('What is the capital of France?');
+const response = await agent.execute('What can you help me with?');
 console.log(response);
 ```
 
-### Agent with Tools
+### Selective Imports
 
-```typescript
-import { ClaudeAgent, Tool } from '@agentionai/agents';
-
-const calculator = new Tool({
-  name: 'calculate',
-  description: 'Perform mathematical calculations',
-  input_schema: {
-    type: 'object',
-    properties: {
-      expression: { type: 'string', description: 'Math expression to evaluate' },
-    },
-    required: ['expression'],
-  },
-  handler: async ({ expression }) => {
-    return String(eval(expression));
-  },
-});
-
-const agent = new ClaudeAgent({
-  model: 'claude-sonnet-4-20250514',
-  systemPrompt: 'You are a helpful math assistant.',
-  tools: [calculator],
-});
-
-const response = await agent.execute('What is 15% of 230?');
-// Agent automatically uses the calculator tool
-```
-
-### Multi-Agent Pipeline
+Import only the agents you need:
 
 ```typescript
-import { Pipeline, ClaudeAgent, OpenAiAgent } from '@agentionai/agents';
-
-// Research agent with search capabilities
-const researcher = new OpenAiAgent({
-  name: 'researcher',
-  model: 'gpt-4o',
-  systemPrompt: 'Research the topic thoroughly.',
-  tools: [webSearchTool],
-});
-
-// Writing agent
-const writer = new ClaudeAgent({
-  name: 'writer',
-  model: 'claude-sonnet-4-20250514',
-  systemPrompt: 'Write a compelling blog post from the research.',
-});
-
-// Chain them together
-const pipeline = new Pipeline([researcher, writer]);
-const result = await pipeline.execute('AI in Healthcare');
-// researcher output → writer input → final blog post
+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
 ```
 
-### RAG with Vector Search
+Or import everything (requires all SDKs):
 
 ```typescript
-import { ClaudeAgent, LanceDBVectorStore, OpenAIEmbeddings } from '@agentionai/agents';
-
-// Setup vector store
-const embeddings = new OpenAIEmbeddings({ model: 'text-embedding-3-small' });
-const store = await LanceDBVectorStore.create({
-  name: 'docs',
-  uri: './data/vectors',
-  tableName: 'knowledge',
-  embeddings,
-});
-
-// Add documents
-await store.addDocuments([
-  { id: '1', content: 'Company policy on refunds...' },
-  { id: '2', content: 'Technical documentation...' },
-]);
-
-// Create search tool
-const searchTool = store.toRetrievalTool(
-  'Search company knowledge base',
-  { defaultLimit: 5 }
-);
-
-// Agent can search and answer
-const agent = new ClaudeAgent({
-  model: 'claude-sonnet-4-20250514',
-  systemPrompt: 'Answer questions using the knowledge base.',
-  tools: [searchTool],
-});
-
-const answer = await agent.execute('What is our refund policy?');
+import { ClaudeAgent, OpenAiAgent } from '@agentionai/agents';
 ```
 
-## Core Concepts
-
-### Agents
-
-Agents wrap LLM providers with a consistent interface. All agents support:
-
-- Conversation history management
-- Tool use
-- Token tracking
-- Pipeline integration
 
-```typescript
-import { ClaudeAgent, OpenAiAgent, MistralAgent, GeminiAgent } from '@agentionai/agents';
+## Features
 
-// Same interface, different providers
-const claude = new ClaudeAgent({ model: 'claude-sonnet-4-20250514' });
-const openai = new OpenAiAgent({ model: 'gpt-4o' });
-const mistral = new MistralAgent({ model: 'mistral-large-latest' });
-const gemini = new GeminiAgent({ model: 'gemini-2.0-flash' });
-```
+- **Multi-Provider, No Lock-in** - Claude, OpenAI, Gemini, Mistral—same interface. Switch models with one line.
+- **Composable, Not Magical** - Agents are objects. Pipelines are arrays. No hidden state, no surprises.
+- **Full Observability** - Per-call token counts, execution timing, pipeline structure visualization.
+- **TypeScript-Native** - Strict typing, interfaces, and generics from the ground up.
+- **RAG Ready** - LanceDB vector store, token-aware chunking, ingestion pipeline out of the box.
 
-### Tools
 
-Tools give agents abilities beyond text generation. Define them with JSON Schema:
+### Agent with Tools
 
 ```typescript
+import { GeminiAgent, Tool } from '@agentionai/agents/gemini';
+
 const weatherTool = new Tool({
   name: 'get_weather',
-  description: 'Get current weather for a city',
+  description: 'Get the current weather for a location',
   input_schema: {
     type: 'object',
     properties: {
-      city: { type: 'string' },
-      units: { type: 'string', enum: ['celsius', 'fahrenheit'] },
+      location: { type: 'string', description: 'City name' },
     },
-    required: ['city'],
+    required: ['location'],
   },
-  handler: async ({ city, units }) => {
-    const weather = await fetchWeather(city, units);
-    return JSON.stringify(weather);
+  handler: async ({ location }) => {
+    // In production, call a weather API
+    return JSON.stringify({
+      location,
+      temperature: 22,
+      conditions: 'Sunny',
+    });
   },
 });
-```
 
-**Advanced: Agents as Tools**
-
-Use agents as tools for hierarchical workflows:
-
-```typescript
-// Specialized sub-agent
-const researchAssistant = new OpenAiAgent({
-  name: 'research-assistant',
-  description: 'Expert at finding research papers',
-  tools: [pubmedSearchTool],
-  model: 'gpt-4o-mini',
-});
-
-// Main agent delegates to sub-agent
-const mainAgent = new ClaudeAgent({
-  name: 'coordinator',
-  agents: [researchAssistant],  // Sub-agents available as tools
-  model: 'claude-sonnet-4-20250514',
+const agent = new GeminiAgent({
+  model: 'gemini-flash-lite-latest',
+  name: 'Weather Agent',
+  description: 'You are a weather assistant.',
+  tools: [weatherTool],
 });
-```
-
-### Graph Pipelines
-
-Build complex workflows by combining agents and executors:
 
-#### Sequential Processing
-
-```typescript
-import { SequentialExecutor } from '@agentionai/agents';
-
-const chain = new SequentialExecutor({
-  name: 'content-pipeline',
-  agents: [researcher, writer, editor],
-});
-// researcher → writer → editor
+const response = await agent.execute("What's the weather in Paris?");
 ```
 
-#### Parallel Execution
-
-```typescript
-import { ParallelExecutor } from '@agentionai/agents';
-
-const parallel = new ParallelExecutor({
-  name: 'multi-perspective',
-  agents: [optimist, pessimist, realist],
-});
-// All run simultaneously on same input
-```
+### Multi-Agent Pipeline
 
-#### Map Operations
+Chain agents together with different providers and models:
 
 ```typescript
-import { MapExecutor } from '@agentionai/agents';
+import { ClaudeAgent } from '@agentionai/agents/claude';
+import { OpenAiAgent } from '@agentionai/agents/openai';
+import { Pipeline } from '@agentionai/agents/core';
 
-const mapper = new MapExecutor({
-  name: 'batch-process',
-  processor: summarizer,
+const researcher = new OpenAiAgent({
+  id: 'researcher',
+  name: 'Researcher',
+  description: 'Research the given topic and provide key facts.',
+  model: 'gpt-4o',
+  tools: [searchTool],
 });
 
-await mapper.execute(['doc1', 'doc2', 'doc3']);
-// Applies summarizer to each document
-```
-
-#### Voting Systems
-
-```typescript
-import { VotingSystem } from '@agentionai/agents';
-
-const voting = new VotingSystem({
-  name: 'code-review',
-  candidates: [juniorDev, seniorDev, architect],
-  judge: techLead,
+const writer = new ClaudeAgent({
+  id: 'writer',
+  name: 'Writer',
+  description: 'Write a blog post based on the research provided.',
+  model: 'claude-sonnet-4-5',
 });
-// Multiple solutions proposed, judge picks best
-```
-
-#### Router Patterns
 
-```typescript
-import { RouterExecutor } from '@agentionai/agents';
-
-const router = new RouterExecutor({
-  name: 'support-router',
-  routes: [
-    { name: 'billing', agent: billingAgent, description: 'Billing questions' },
-    { name: 'technical', agent: techAgent, description: 'Technical issues' },
-  ],
-  routerAgent: classifierAgent,
-});
-// Routes input to appropriate agent
+const pipeline = new Pipeline([researcher, writer]);
+const result = await pipeline.execute('Renewable energy trends in 2024');
 ```
 
-### Document Processing
-
-#### Chunking Strategies
+### Agent Delegation
 
-Split documents intelligently for RAG applications:
+Use agents as tools for hierarchical workflows:
 
 ```typescript
-import { RecursiveChunker, TokenChunker, TextChunker } from '@agentionai/agents';
+import { ClaudeAgent } from '@agentionai/agents/claude';
+import { OpenAiAgent } from '@agentionai/agents/openai';
 
-// Semantic chunking (best for structured docs)
-const recursiveChunker = new RecursiveChunker({
-  chunkSize: 1000,
-  chunkOverlap: 100,
-  separators: ['\n\n', '\n', '. ', ' '],
-});
-
-// Token-aware chunking (best for LLM context limits)
-const tokenChunker = new TokenChunker({
-  chunkSize: 500,  // tokens, not characters
-  chunkOverlap: 50,
+// Research assistant (cheaper model for data gathering)
+const researchAssistant = new OpenAiAgent({
+  id: 'research-assistant',
+  name: 'Research Assistant',
+  description: 'Search and summarize information on topics.',
+  model: 'gpt-4o-mini',
+  tools: [searchTool],
 });
 
-// Simple character-based chunking
-const textChunker = new TextChunker({
-  chunkSize: 1000,
-  chunkOverlap: 200,
+// Lead researcher delegates to assistant, synthesizes findings
+const researcher = new ClaudeAgent({
+  id: 'researcher',
+  name: 'Lead Researcher',
+  description: 'Research topics thoroughly using your assistant.',
+  model: 'claude-sonnet-4-5',
+  agents: [researchAssistant],  // Assistant available as a tool
 });
 
-const chunks = await recursiveChunker.chunk(documentText, {
-  sourceId: 'doc-123',
-  metadata: { author: 'Alice' },
-});
+const result = await researcher.execute('Latest developments in quantum computing');
 ```
 
-#### Ingestion Pipeline
+## Core Concepts
 
-Orchestrate chunking, embedding, and storage:
+### Agents
+Unified interface across Claude, OpenAI, Gemini, and Mistral. Tools, history, and token tracking built-in.
 
-```typescript
-import { IngestionPipeline, RecursiveChunker } from '@agentionai/agents';
-
-const chunker = new RecursiveChunker({ chunkSize: 1000 });
-const embeddings = new OpenAIEmbeddings({ model: 'text-embedding-3-small' });
-const store = await LanceDBVectorStore.create({
-  name: 'docs',
-  uri: './data',
-  tableName: 'chunks',
-  embeddings,
-});
+[Learn more →](https://docs.agention.ai/guide/agents)
 
-const pipeline = new IngestionPipeline(chunker, embeddings, store);
+### Tools
+JSON Schema + handler pattern. Unique capability: wrap any agent as a tool for delegation hierarchies.
 
-const result = await pipeline.ingest(documentText, {
-  sourceId: 'doc-001',
-  batchSize: 50,
-  onProgress: ({ phase, processed, total }) => {
-    console.log(`${phase}: ${processed}/${total}`);
-  },
-});
-```
+[Learn more →](https://docs.agention.ai/guide/tools)
 
-### Metrics & Observability
+### History
+Provider-agnostic, persistent (Redis, file, custom), shareable across agents of different providers.
 
-Track performance across your pipelines:
+[Learn more →](https://docs.agention.ai/guide/history)
 
-```typescript
-import { MetricsCollector } from '@agentionai/agents';
+### Graph Pipelines
+Compose sequential, parallel, voting, routing, and nested graphs. Mix models and providers freely.
 
-const metrics = new MetricsCollector();
-const result = await pipeline.execute('Input', { metrics });
+[Learn more →](https://docs.agention.ai/guide/graph-pipelines)
 
-const stats = metrics.getMetrics();
-console.log({
-  totalDuration: stats.totalDuration,
-  totalTokens: stats.totalInputTokens + stats.totalOutputTokens,
-  nodeCount: stats.nodes.length,
-});
+### RAG & Vector Stores
+LanceDB vector store, token-aware chunking, ingestion pipeline, and retrieval tools out of the box.
 
-// Per-node metrics
-stats.nodes.forEach(node => {
-  console.log(`${node.name}: ${node.duration}ms, ${node.tokens?.total} tokens`);
-});
-```
+[Learn more →](https://docs.agention.ai/guide/vector-stores)
 
-## Architecture
+### Observability
+Per-call and per-node token counts, duration metrics, full execution visibility.
 
-```
-┌─────────────────────────────────────────────────────────────┐
-│                        Agention                              │
-│                                                              │
-│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐   │
-│  │  Claude  │  │  OpenAI  │  │ Mistral  │  │  Gemini  │   │
-│  │  Agent   │  │  Agent   │  │  Agent   │  │  Agent   │   │
-│  └────┬─────┘  └────┬─────┘  └────┬─────┘  └────┬─────┘   │
-│       │             │               │             │          │
-│       └─────────────┴───────────────┴─────────────┘          │
-│                          │                                   │
-│                    ┌─────▼─────┐                            │
-│                    │ BaseAgent │                            │
-│                    │ Interface │                            │
-│                    └─────┬─────┘                            │
-│                          │                                   │
-│       ┌──────────────────┼──────────────────┐              │
-│       │                  │                  │              │
-│  ┌────▼────┐       ┌─────▼─────┐     ┌─────▼─────┐       │
-│  │  Tools  │       │ Pipelines │     │  History  │       │
-│  └─────────┘       └───────────┘     └───────────┘       │
-│       │                  │                                   │
-│  ┌────▼────────────┐     │                                   │
-│  │ Vector Stores   │     │                                   │
-│  │  - LanceDB      │     │                                   │
-│  │  - Embeddings   │     │                                   │
-│  └─────────────────┘     │                                   │
-│                          │                                   │
-│       ┌──────────────────┼──────────────────┐              │
-│       │                  │                  │              │
-│  ┌────▼────┐       ┌─────▼─────┐     ┌─────▼─────┐       │
-│  │Sequential│      │ Parallel  │     │   Router  │       │
-│  │Executor  │      │ Executor  │     │  Executor │       │
-│  └──────────┘      └───────────┘     └───────────┘       │
-│                                                              │
-└─────────────────────────────────────────────────────────────┘
-```
+[Learn more →](https://docs.agention.ai/guide/graph-pipelines#metrics--observability)
 
 ## Documentation
 
-- **[Getting Started](docs/guide/getting-started.md)** - Installation and first steps
-- **[Agents](docs/guide/agents.md)** - Agent configuration and providers
-- **[Tools](docs/guide/tools.md)** - Creating and using tools
-- **[Graph Pipelines](docs/guide/graph-pipelines.md)** - Building multi-agent workflows
-- **[Vector Stores](docs/guide/vector-stores.md)** - Semantic search and RAG
-- **[Chunking & Ingestion](docs/guide/chunking-and-ingestion.md)** - Document processing
-- **[Examples](docs/guide/examples.md)** - Complete example applications
-- **[API Reference](docs/api)** - Full API documentation
+- **[Getting Started](https://docs.agention.ai/guide/getting-started)** - Installation and first agent
+- **[Quick Start](https://docs.agention.ai/guide/quickstart)** - Build a weather assistant in 5 minutes
+- **[Agents](https://docs.agention.ai/guide/agents)** - Agent configuration and providers
+- **[Tools](https://docs.agention.ai/guide/tools)** - Adding capabilities and agent delegation
+- **[Graph Pipelines](https://docs.agention.ai/guide/graph-pipelines)** - Multi-agent workflows
+- **[Vector Stores](https://docs.agention.ai/guide/vector-stores)** - RAG and semantic search
+- **[Examples](https://docs.agention.ai/guide/examples)** - Real-world implementations
+- **[API Reference](https://docs.agention.ai/api)** - Full API documentation
+
+## Why Agention?
+
+|  | Raw SDKs | Heavy Frameworks | Agention |
+|---|---|---|---|
+| **Control** | Full | Limited | Full |
+| **Boilerplate** | High | Low | Low |
+| **Transparency** | Full | Limited | Full |
+| **Multi-provider** | Manual | Varies | Built-in |
+| **TypeScript** | Varies | Often partial | Native |
+
+- **Ship faster** — Stop rebuilding agent infrastructure for every project
+- **Stay flexible** — Swap providers, mix models, customize everything
+- **Keep control** — See exactly what's happening at every step
+- **Scale confidently** — Built-in metrics, token tracking, and observability
 
 ## Examples
 
-See the [examples](examples) directory for complete working examples:
-
-- **Basic Agents** - Simple agent usage with different providers
-- **Tool Usage** - Agents with custom tools
-- **Multi-Agent Pipelines** - Sequential, parallel, and voting patterns
-- **RAG Applications** - Vector search and document retrieval
-- **Document Ingestion** - Chunking and embedding pipelines
-- **Graph-based RAG** - Advanced knowledge graph integration
-
-## Development
-
-### Commands
-
-```bash
-# Build
-npm run build
-
-# Test
-npm test
-npm run test:watch
-
-# Linting
-npm run lint
-npm run lint:fix
-
-# Documentation
-npm run docs:dev      # Start docs dev server
-npm run docs:build    # Build documentation
-npm run docs:api      # Generate API docs
-
-# Examples
-npm run example       # Run example code
-```
-
-### Project Structure
-
-```
-agention-lib/
-├── lib/
-│   ├── agents/           # Agent implementations
-│   │   ├── anthropic/    # Claude agent
-│   │   ├── openai/       # OpenAI agent
-│   │   ├── mistral/      # Mistral agent
-│   │   ├── google/       # Gemini agent
-│   │   └── BaseAgent.ts  # Abstract base class
-│   ├── tools/            # Tool system
-│   ├── history/          # Conversation management
-│   ├── graph/            # Pipeline executors
-│   │   ├── executors/    # Sequential, Parallel, Map, Voting, Router
-│   │   ├── MetricsCollector.ts
-│   │   └── Pipeline.ts
-│   ├── chunking/         # Document chunking
-│   │   ├── TextChunker.ts
-│   │   ├── RecursiveChunker.ts
-│   │   └── TokenChunker.ts
-│   ├── ingestion/        # Ingestion pipeline
-│   └── vectorstore/      # Vector store implementations
-│       ├── LanceDBVectorStore.ts
-│       └── embeddings/
-├── examples/             # Example applications
-├── docs/                 # Documentation
-└── dist/                 # Build output
-```
+Check out the [examples](https://github.com/laurentzuijdwijk/agention-lib/tree/master/examples) directory for complete working examples:
 
-## Environment Variables
-
-Set API keys as environment variables:
-
-```bash
-# LLM Providers
-export ANTHROPIC_API_KEY=your-key-here
-export OPENAI_API_KEY=your-key-here
-export MISTRAL_API_KEY=your-key-here
-export GOOGLE_API_KEY=your-key-here
-```
+- Basic agents with different providers
+- Custom tools and agent delegation
+- Sequential, parallel, and voting pipelines
+- RAG applications with vector search
+- Document ingestion and chunking
 
 ## Contributing
 
-Contributions are welcome! Please see our development guidelines in [CLAUDE.md](CLAUDE.md).
-
-## License
-
-MIT
-
-## Roadmap
-
-- [ ] Streaming response support
-- [ ] Additional vector store integrations (Pinecone, Weaviate)
-- [ ] Conditional and loop executors
-- [ ] Graph visualization tools
-- [ ] Enhanced retry mechanisms
-- [ ] Middleware system for request/response processing
+Contributions are welcome! Please open an issue or submit a pull request.
 
-## Support
+## Links
 
-- **Issues**: [GitHub Issues](https://github.com/laurentzuijdwijk/agention-lib/issues)
-- **Documentation**: [docs](docs/guide/getting-started.md)
-- **Examples**: [examples](examples)
+- **[Documentation](https://docs.agention.ai/)**
+- **[GitHub](https://github.com/laurentzuijdwijk/agention-lib)**
+- **[npm](https://www.npmjs.com/package/@agentionai/agents)**
+- **[Issues](https://github.com/laurentzuijdwijk/agention-lib/issues)**

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,15 +1,40 @@
 {
   "name": "@agentionai/agents",
   "author": "Laurent Zuijdwijk",
-  "version": "0.3.0-beta",
+  "version": "0.4.0",
   "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",
-    "README.md",
-    "LICENSE"
+    "README.md"
   ],
   "repository": {
     "type": "git",
@@ -32,7 +57,7 @@
     "docs:site": "vitepress build docs",
     "docs:dev": "vitepress dev docs",
     "docs:preview": "vitepress preview docs",
-    "publish:npm": "npm publish --registry=https://registry.npmjs.org",
+    "publish:npm": "npm publish --registry=https://registry.npmjs.org --access public",
     "publish:github": "npm publish --registry=https://npm.pkg.github.com",
     "publish:all": "npm run publish:npm && npm run publish:github"
   },

package/readme.md

@@ -1 +0,0 @@
-Readme for atomic agents