@falai/agent 0.3.23 → 0.3.25

package/README.md

@@ -9,8 +9,9 @@
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.3+-blue.svg)](https://www.typescriptlang.org/)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](./LICENSE)
 [![Bun](https://img.shields.io/badge/bun-compatible-orange.svg)](https://bun.sh)
+[![Website](https://img.shields.io/badge/🌐-falai.dev-brightgreen.svg)](https://falai.dev)
 
-[Features](#-features) • [Installation](#-installation) • [Quick Start](#-quick-start) • [Documentation](#-documentation) • [Examples](#-examples)
+[🌐 Website](https://falai.dev) • [Features](#-features) • [Installation](#-installation) • [Quick Start](#-quick-start) • [Documentation](#-documentation) • [Examples](#-examples)
 
 </div>
 

package/docs/STRUCTURE.md

@@ -1,8 +1,17 @@
 # Package Structure
 
-\`\`\`
+```
 src/
 ├── types/          # Type definitions (interfaces, types, enums)
+│   ├── agent.ts           # Agent types and configuration
+│   ├── ai.ts              # AI provider interfaces
+│   ├── history.ts         # Event and message history types
+│   ├── observation.ts     # Observation and disambiguation types
+│   ├── persistence.ts     # Persistence adapter interfaces
+│   ├── prompt.ts          # Prompt building types
+│   ├── route.ts           # Route and state types
+│   ├── tool.ts            # Tool definition types
+│   └── index.ts           # Type exports
 ├── core/           # Core framework classes
 │   ├── Agent.ts           # Main agent class
 │   ├── Route.ts           # Route/Journey DSL
@@ -12,21 +21,38 @@ src/
 │   ├── Tool.ts            # Tool definitions
 │   ├── PromptBuilder.ts   # Prompt construction
 │   ├── Events.ts          # Event history
-│   └── DomainRegistry.ts  # Domain organization
+│   ├── DomainRegistry.ts  # Domain organization
+│   └── PersistenceManager.ts  # Persistence lifecycle management
 ├── providers/      # AI provider implementations
-│   └── GeminiProvider.ts  # Google Gemini AI
+│   ├── AnthropicProvider.ts   # Claude (Anthropic)
+│   ├── GeminiProvider.ts      # Google Gemini
+│   ├── OpenAIProvider.ts      # OpenAI GPT
+│   ├── OpenRouterProvider.ts  # OpenRouter (200+ models)
+│   └── index.ts               # Provider exports
+├── adapters/       # Database persistence adapters
+│   ├── MemoryAdapter.ts       # In-memory (testing/dev)
+│   ├── PrismaAdapter.ts       # Prisma ORM
+│   ├── RedisAdapter.ts        # Redis
+│   ├── MongoAdapter.ts        # MongoDB
+│   ├── PostgreSQLAdapter.ts   # PostgreSQL
+│   ├── SQLiteAdapter.ts       # SQLite
+│   ├── OpenSearchAdapter.ts   # OpenSearch/Elasticsearch
+│   └── index.ts               # Adapter exports
 ├── utils/          # Utility functions
-│   └── retry.ts           # Retry/timeout logic
+│   ├── retry.ts           # Retry/timeout logic
+│   └── id.ts              # Deterministic ID generation
 ├── constants/      # Constants and symbols
-│   └── index.ts           # END_ROUTE, etc.
+│   └── index.ts           # END_ROUTE, EventSource, etc.
 └── index.ts        # Public API exports
-\`\`\`
+```
 
 ## Design Principles
 
 1. **Flat, organized structure** - Clear separation by purpose
 2. **Types-first** - All types in dedicated folder
 3. **Core logic isolated** - Business logic in \`core/\`
-4. **Provider pattern** - Pluggable AI backends
-5. **Path aliases** - Clean imports with \`@/types\`, \`@/core\`, etc.
-6. **Fluent API** - Methods return \`this\` for chaining
+4. **Provider pattern** - Pluggable AI backends and database adapters
+5. **Optional persistence** - Multiple database adapters following the same pattern
+6. **Extensibility** - Easy to add new providers, adapters, and tools
+7. **Path aliases** - Clean imports with \`@/types\`, \`@/core\`, etc.
+8. **Fluent API** - Methods return \`this\` for chaining

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@falai/agent",
-  "version": "0.3.23",
+  "version": "0.3.25",
   "description": "Standalone, strongly-typed AI Agent framework with route DSL and AI provider strategy",
   "type": "module",
   "main": "./dist/cjs/index.js",