@everworker/oneringai 0.2.2 → 0.3.0

package/README.md

@@ -16,6 +16,7 @@
   - [2. Dynamic Tool Management](#2-dynamic-tool-management-new)
   - [3. Tool Execution Plugins](#3-tool-execution-plugins-new)
   - [4. Session Persistence](#4-session-persistence)
+  - [Storage Registry](#storage-registry)
   - [5. Working Memory](#5-working-memory)
   - [6. Research with Search Tools](#6-research-with-search-tools)
   - [7. Context Management](#7-context-management)
@@ -27,8 +28,9 @@
   - [13. Streaming](#13-streaming)
   - [14. OAuth for External APIs](#14-oauth-for-external-apis)
   - [15. Developer Tools](#15-developer-tools)
-  - [16. Document Reader](#16-document-reader-new) — PDF, DOCX, XLSX, PPTX, CSV, HTML, images
-  - [17. External API Integration](#17-external-api-integration) — Scoped Registry, Vendor Templates, Tool Discovery
+  - [16. Custom Tool Generation](#16-custom-tool-generation-new) — Agents create, test, and persist their own tools
+  - [17. Document Reader](#17-document-reader) — PDF, DOCX, XLSX, PPTX, CSV, HTML, images
+  - [18. External API Integration](#18-external-api-integration) — Scoped Registry, Vendor Templates, Tool Discovery
 - [MCP Integration](#mcp-model-context-protocol-integration)
 - [Documentation](#documentation)
 - [Examples](#examples)
@@ -58,7 +60,7 @@
 ## HOSEA APP
 We realize that library alone in these times is not enough to get you excited, so we built a FREE FOREVER desktop app on top of this library to showcase its power! It's as easy to start using as cloning this library's repo, and then `cd apps/hosea` and then `npm install` and then `npm run dev`. Or watch the video first:
 
-![Watch the demo](https://img.youtube.com/vi/_LzDiuOQD8Y/maxresdefault.jpg)](https://www.youtube.com/watch?v=_LzDiuOQD8Y)
+[![Watch the demo](https://img.youtube.com/vi/_LzDiuOQD8Y/maxresdefault.jpg)](https://www.youtube.com/watch?v=_LzDiuOQD8Y)
 
 Or read the more detailed installation / setup instructions [here](https://github.com/Integrail/oneringai/blob/main/apps/hosea/README.md)
 
@@ -68,7 +70,7 @@ Better to see once and then dig in the code! :)
 
 - ✨ **Unified API** - One interface for 10+ AI providers (OpenAI, Anthropic, Google, Groq, DeepSeek, and more)
 - 🔑 **Connector-First Architecture** - Single auth system with support for multiple keys per vendor
-- 📊 **Model Registry** - Complete metadata for 23+ latest (2026) models with pricing and features
+- 📊 **Model Registry** - Complete metadata for 35+ latest (2026) models with pricing and features
 - 🎤 **Audio Capabilities** - Text-to-Speech (TTS) and Speech-to-Text (STT) with OpenAI and Groq
 - 🖼️ **Image Generation** - DALL-E 3, gpt-image-1, Google Imagen 4 with editing and variations
 - 🎬 **Video Generation** - NEW: OpenAI Sora 2 and Google Veo 3 for AI video creation
@@ -87,12 +89,14 @@ Better to see once and then dig in the code! :)
 - 📝 **Persistent Instructions** - NEW: Agent-level custom instructions that persist across sessions on disk
 - 🛠️ **Agentic Workflows** - Built-in tool calling and multi-turn conversations
 - 🔧 **Developer Tools** - NEW: Filesystem and shell tools for coding assistants (read, write, edit, grep, glob, bash)
+- 🧰 **Custom Tool Generation** - NEW: Let agents create, test, and persist their own reusable tools at runtime — complete meta-tool system with VM sandbox
 - 🖥️ **Desktop Automation** - NEW: OS-level computer use — screenshot, mouse, keyboard, and window control for vision-driven agent loops
 - 📄 **Document Reader** - NEW: Universal file-to-text converter — PDF, DOCX, XLSX, PPTX, CSV, HTML, images auto-converted to markdown
 - 🔌 **MCP Integration** - NEW: Model Context Protocol client for seamless tool discovery from local and remote servers
 - 👁️ **Vision Support** - Analyze images with AI across all providers
 - 📋 **Clipboard Integration** - Paste screenshots directly (like Claude Code!)
 - 🔐 **Scoped Connector Registry** - NEW: Pluggable access control for multi-tenant connector isolation
+- 💾 **StorageRegistry** - Centralized storage configuration — swap all backends (sessions, media, custom tools, etc.) with one `configure()` call
 - 🔐 **OAuth 2.0** - Full OAuth support for external APIs with encrypted token storage
 - 📦 **Vendor Templates** - NEW: Pre-configured auth templates for 43+ services (GitHub, Slack, Stripe, etc.)
 - 🔄 **Streaming** - Real-time responses with event streams
@@ -320,7 +324,7 @@ const response = await agent.run([
 Connector-based web search with multiple providers:
 
 ```typescript
-import { Connector, SearchProvider, Services, webSearch, Agent } from '@everworker/oneringai';
+import { Connector, SearchProvider, ConnectorTools, Services, Agent, tools } from '@everworker/oneringai';
 
 // Create search connector
 Connector.create({
@@ -338,11 +342,13 @@ const results = await search.search('latest AI developments 2026', {
   language: 'en',
 });
 
-// Option 2: Use with Agent
+// Option 2: Use with Agent via ConnectorTools
+const searchTools = ConnectorTools.for('serper-main');
+
 const agent = Agent.create({
   connector: 'openai',
   model: 'gpt-4',
-  tools: [webSearch],
+  tools: [...searchTools, tools.webFetch],
 });
 
 await agent.run('Search for quantum computing news and summarize');
@@ -359,7 +365,7 @@ await agent.run('Search for quantum computing news and summarize');
 Enterprise web scraping with automatic fallback and bot protection bypass:
 
 ```typescript
-import { Connector, ScrapeProvider, Services, webScrape, Agent } from '@everworker/oneringai';
+import { Connector, ScrapeProvider, ConnectorTools, Services, Agent, tools } from '@everworker/oneringai';
 
 // Create ZenRows connector for bot-protected sites
 Connector.create({
@@ -379,19 +385,24 @@ const result = await scraper.scrape('https://protected-site.com', {
   },
 });
 
-// Option 2: Use webScrape tool with Agent
+// Option 2: Use web_scrape tool with Agent via ConnectorTools
+const scrapeTools = ConnectorTools.for('zenrows');
+
 const agent = Agent.create({
   connector: 'openai',
   model: 'gpt-4',
-  tools: [webScrape],
+  tools: [...scrapeTools, tools.webFetch],
 });
 
-// webScrape auto-falls back: native → JS → API
+// web_scrape auto-falls back: native → API
 await agent.run('Scrape https://example.com and summarize');
 ```
 
 **Supported Scrape Providers:**
 - **ZenRows** - Enterprise scraping with JS rendering, residential proxies, anti-bot bypass
+- **Jina Reader** - Clean content extraction with AI-powered readability
+- **Firecrawl** - Web scraping with JavaScript rendering
+- **ScrapingBee** - Headless browser scraping with proxy rotation
 
 ## Supported Providers
 
@@ -401,7 +412,7 @@ await agent.run('Scrape https://example.com and summarize');
 | **Anthropic (Claude)** | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ✅ | 200K |
 | **Google (Gemini)** | ✅ | ✅ | ✅ | ❌ | ✅ | ✅ | ✅ | 1M |
 | **Google Vertex AI** | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ✅ | 1M |
-| **Grok (xAI)** | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ✅ | 128K |
+| **Grok (xAI)** | ✅ | ✅ | ❌ | ❌ | ✅ | ✅ | ✅ | 128K |
 | **Groq** | ✅ | ❌ | ❌ | ✅ | ❌ | ❌ | ✅ | 128K |
 | **Together AI** | ✅ | Some | ❌ | ❌ | ❌ | ❌ | ✅ | 128K |
 | **DeepSeek** | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ | 64K |
@@ -612,6 +623,33 @@ if (loaded) {
 
 **Storage Location:** `~/.oneringai/agents/<agentId>/sessions/<sessionId>.json`
 
+### Storage Registry
+
+Swap all storage backends (sessions, media, custom tools, OAuth tokens, etc.) with a single `configure()` call at init time. No breaking changes — all existing APIs continue to work.
+
+```typescript
+import { StorageRegistry } from '@everworker/oneringai';
+
+StorageRegistry.configure({
+  media: new S3MediaStorage(),
+  oauthTokens: new EncryptedFileTokenStorage(),
+  // Context-aware factories — optional StorageContext for multi-tenant partitioning
+  customTools: (ctx) => new MongoCustomToolStorage(ctx?.userId),
+  sessions: (agentId, ctx) => new RedisContextStorage(agentId, ctx?.tenantId),
+  persistentInstructions: (agentId, ctx) => new DBInstructionsStorage(agentId, ctx?.userId),
+  workingMemory: (ctx) => new RedisMemoryStorage(ctx?.tenantId),
+});
+
+// All agents and tools automatically use these backends
+const agent = Agent.create({ connector: 'openai', model: 'gpt-4' });
+```
+
+**Resolution order:** explicit constructor param > `StorageRegistry` > file-based default.
+
+**Multi-tenant:** Factories receive an optional `StorageContext` (opaque, like `ConnectorAccessContext`). Set via `StorageRegistry.setContext({ userId, tenantId })` — auto-forwarded to all factory calls for per-user/per-tenant storage partitioning.
+
+See the [User Guide](./USER_GUIDE.md#centralized-storage-registry) for full documentation.
+
 ### 5. Working Memory
 
 Use the `WorkingMemoryPluginNextGen` for agents that need to store and retrieve data:
@@ -643,7 +681,7 @@ await agent.run('Check weather for SF and remember the result');
 Use `Agent` with search tools and `WorkingMemoryPluginNextGen` for research workflows:
 
 ```typescript
-import { Agent, webSearch, SearchProvider, Connector, Services } from '@everworker/oneringai';
+import { Agent, ConnectorTools, Connector, Services, tools } from '@everworker/oneringai';
 
 // Setup search connector
 Connector.create({
@@ -654,10 +692,12 @@ Connector.create({
 });
 
 // Create agent with search and memory
+const searchTools = ConnectorTools.for('serper-main');
+
 const agent = Agent.create({
   connector: 'openai',
   model: 'gpt-4',
-  tools: [webSearch],
+  tools: [...searchTools, tools.webFetch],
   context: {
     features: { workingMemory: true },
   },
@@ -933,25 +973,26 @@ Complete metadata for 23+ models:
 import { getModelInfo, calculateCost, LLM_MODELS, Vendor } from '@everworker/oneringai';
 
 // Get model information
-const model = getModelInfo('gpt-5.2-thinking');
+const model = getModelInfo('gpt-5.2');
 console.log(model.features.input.tokens);  // 400000
 console.log(model.features.input.cpm);     // 1.75 (cost per million)
 
 // Calculate costs
-const cost = calculateCost('gpt-5.2-thinking', 50_000, 2_000);
+const cost = calculateCost('gpt-5.2', 50_000, 2_000);
 console.log(`Cost: $${cost}`);  // $0.1155
 
 // With caching
-const cachedCost = calculateCost('gpt-5.2-thinking', 50_000, 2_000, {
+const cachedCost = calculateCost('gpt-5.2', 50_000, 2_000, {
   useCachedInput: true
 });
 console.log(`Cached: $${cachedCost}`);  // $0.0293 (90% discount)
 ```
 
 **Available Models:**
-- **OpenAI (11)**: GPT-5.2 series, GPT-5 family, GPT-4.1, o3-mini
-- **Anthropic (5)**: Claude 4.5 series, Claude 4.x
+- **OpenAI (12)**: GPT-5.2 series, GPT-5 family, GPT-4.1, GPT-4o, o3-mini, o1
+- **Anthropic (7)**: Claude 4.5 series, Claude 4.x, Claude 3.7 Sonnet, Claude 3 Haiku
 - **Google (7)**: Gemini 3, Gemini 2.5
+- **Grok (9)**: Grok 4.1, Grok 4, Grok Code, Grok 3, Grok 2 Vision
 
 ### 13. Streaming
 
@@ -1024,7 +1065,42 @@ await agent.run('Run npm test and report any failures');
 - Timeout protection (default 2 min)
 - Output truncation for large outputs
 
-### 16. Desktop Automation Tools (NEW)
+### 16. Custom Tool Generation (NEW)
+
+Let agents **create their own tools** at runtime — draft, test, iterate, save, and reuse. The agent writes JavaScript code, validates it, tests it in the VM sandbox, and persists it for future use. All 6 meta-tools are auto-registered and visible in Hosea.
+
+```typescript
+import { createCustomToolMetaTools, hydrateCustomTool } from '@everworker/oneringai';
+
+// Give an agent the ability to create tools
+const agent = Agent.create({
+  connector: 'openai',
+  model: 'gpt-4',
+  tools: [...createCustomToolMetaTools()],
+});
+
+// The agent can now: draft → test → save tools autonomously
+await agent.run('Create a tool that fetches weather data from the OpenWeather API');
+
+// Later: load and use a saved tool
+import { createFileCustomToolStorage } from '@everworker/oneringai';
+const storage = createFileCustomToolStorage();
+const definition = await storage.load('fetch_weather');
+const weatherTool = hydrateCustomTool(definition!);
+
+// Register on any agent
+agent.tools.register(weatherTool, { source: 'custom', tags: ['weather', 'api'] });
+```
+
+**Meta-Tools:** `custom_tool_draft` (validate), `custom_tool_test` (execute in sandbox), `custom_tool_save` (persist), `custom_tool_list` (search), `custom_tool_load` (retrieve), `custom_tool_delete` (remove)
+
+**Dynamic Descriptions:** Draft and test tools use `descriptionFactory` to show all available connectors and the full sandbox API — automatically updated when connectors are added or removed.
+
+**Pluggable Storage:** Default `FileCustomToolStorage` saves to `~/.oneringai/custom-tools/`. Implement `ICustomToolStorage` for MongoDB, S3, or any backend.
+
+> See the [User Guide](./USER_GUIDE.md#custom-tool-generation) for the complete workflow, sandbox API reference, and examples.
+
+### 17. Desktop Automation Tools (NEW)
 
 OS-level desktop automation for building "computer use" agents — screenshot the screen, send to a vision model, receive tool calls (click, type, etc.), execute them, repeat:
 
@@ -1060,7 +1136,7 @@ await agent.run('Open Safari and search for "weather forecast"');
 - Screenshots use the `__images` convention for automatic multimodal handling across all providers (Anthropic, OpenAI, Google)
 - Requires `@nut-tree-fork/nut-js` as an optional peer dependency: `npm install @nut-tree-fork/nut-js`
 
-### 17. Document Reader (NEW)
+### 18. Document Reader
 
 Universal file-to-LLM-content converter. Reads arbitrary document formats and produces clean markdown text with optional image extraction:
 
@@ -1125,7 +1201,7 @@ await agent.run([
 
 See the [User Guide](./USER_GUIDE.md#document-reader) for complete API reference and configuration options.
 
-### 18. External API Integration
+### 19. External API Integration
 
 Connect your AI agents to 35+ external services with enterprise-grade resilience:
 
@@ -1477,4 +1553,4 @@ MIT License - See [LICENSE](./LICENSE) file.
 
 ---
 
-**Version:** 0.2.1 | **Last Updated:** 2026-02-11 | **[User Guide](./USER_GUIDE.md)** | **[API Reference](./API_REFERENCE.md)** | **[Changelog](./CHANGELOG.md)**
+**Version:** 0.2.1 | **Last Updated:** 2026-02-17 | **[User Guide](./USER_GUIDE.md)** | **[API Reference](./API_REFERENCE.md)** | **[Changelog](./CHANGELOG.md)**

package/dist/{IProvider-DcYJ3YE-.d.ts → IProvider-BUbU5UwV.d.ts}

@@ -295,7 +295,6 @@ interface ConnectorFetchOptions extends RequestInit {
  */
 declare class Connector {
     private static registry;
-    private static defaultStorage;
     /**
      * Create and register a new connector
      * @param config - Must include `name` field
@@ -323,6 +322,11 @@ declare class Connector {
      * Clear all connectors (useful for testing)
      */
     static clear(): void;
+    /**
+     * Get the default token storage for OAuth connectors.
+     * Resolves from StorageRegistry, falling back to MemoryStorage.
+     */
+    private static get defaultStorage();
     /**
      * Set default token storage for OAuth connectors
      */
@@ -502,4 +506,4 @@ interface IProvider {
     validateConfig(): Promise<boolean>;
 }
 
-export { type APIKeyConnectorAuth as A, type ConnectorAccessContext as C, DEFAULT_CONNECTOR_TIMEOUT as D, type IConnectorRegistry as I, type JWTConnectorAuth as J, type OAuthConnectorAuth as O, type ProviderCapabilities as P, type StoredToken as S, type IConnectorAccessPolicy as a, Connector as b, type IProvider as c, type ConnectorFetchOptions as d, type ITokenStorage as e, type ConnectorConfig as f, type ConnectorAuth as g, type ConnectorConfigResult as h, DEFAULT_MAX_RETRIES as i, DEFAULT_RETRYABLE_STATUSES as j, DEFAULT_BASE_DELAY_MS as k, DEFAULT_MAX_DELAY_MS as l };
+export { type APIKeyConnectorAuth as A, type ConnectorAccessContext as C, DEFAULT_BASE_DELAY_MS as D, type IConnectorRegistry as I, type JWTConnectorAuth as J, type OAuthConnectorAuth as O, type ProviderCapabilities as P, type StoredToken as S, type IConnectorAccessPolicy as a, Connector as b, type ConnectorConfig as c, type ITokenStorage as d, type IProvider as e, type ConnectorFetchOptions as f, type ConnectorAuth as g, type ConnectorConfigResult as h, DEFAULT_CONNECTOR_TIMEOUT as i, DEFAULT_MAX_DELAY_MS as j, DEFAULT_MAX_RETRIES as k, DEFAULT_RETRYABLE_STATUSES as l };

package/dist/{IProvider-c4QCbPjn.d.cts → IProvider-Br817mKc.d.cts}

@@ -295,7 +295,6 @@ interface ConnectorFetchOptions extends RequestInit {
  */
 declare class Connector {
     private static registry;
-    private static defaultStorage;
     /**
      * Create and register a new connector
      * @param config - Must include `name` field
@@ -323,6 +322,11 @@ declare class Connector {
      * Clear all connectors (useful for testing)
      */
     static clear(): void;
+    /**
+     * Get the default token storage for OAuth connectors.
+     * Resolves from StorageRegistry, falling back to MemoryStorage.
+     */
+    private static get defaultStorage();
     /**
      * Set default token storage for OAuth connectors
      */
@@ -502,4 +506,4 @@ interface IProvider {
     validateConfig(): Promise<boolean>;
 }
 
-export { type APIKeyConnectorAuth as A, type ConnectorAccessContext as C, DEFAULT_CONNECTOR_TIMEOUT as D, type IConnectorRegistry as I, type JWTConnectorAuth as J, type OAuthConnectorAuth as O, type ProviderCapabilities as P, type StoredToken as S, type IConnectorAccessPolicy as a, Connector as b, type IProvider as c, type ConnectorFetchOptions as d, type ITokenStorage as e, type ConnectorConfig as f, type ConnectorAuth as g, type ConnectorConfigResult as h, DEFAULT_MAX_RETRIES as i, DEFAULT_RETRYABLE_STATUSES as j, DEFAULT_BASE_DELAY_MS as k, DEFAULT_MAX_DELAY_MS as l };
+export { type APIKeyConnectorAuth as A, type ConnectorAccessContext as C, DEFAULT_BASE_DELAY_MS as D, type IConnectorRegistry as I, type JWTConnectorAuth as J, type OAuthConnectorAuth as O, type ProviderCapabilities as P, type StoredToken as S, type IConnectorAccessPolicy as a, Connector as b, type ConnectorConfig as c, type ITokenStorage as d, type IProvider as e, type ConnectorFetchOptions as f, type ConnectorAuth as g, type ConnectorConfigResult as h, DEFAULT_CONNECTOR_TIMEOUT as i, DEFAULT_MAX_DELAY_MS as j, DEFAULT_MAX_RETRIES as k, DEFAULT_RETRYABLE_STATUSES as l };

package/dist/{ImageModel-BJ2mVPGV.d.ts → ImageModel-B2KUs-ps.d.ts}

@@ -1,4 +1,4 @@
-import { c as IProvider, b as Connector } from './IProvider-DcYJ3YE-.js';
+import { e as IProvider, b as Connector } from './IProvider-BUbU5UwV.js';
 import { V as Vendor } from './Vendor-DYh_bzwo.js';
 
 /**
@@ -334,4 +334,4 @@ declare function getImageModelsWithFeature(feature: keyof IImageModelDescription
  */
 declare function calculateImageCost(modelName: string, imageCount: number, quality?: 'standard' | 'hd'): number | null;
 
-export { type AudioFormat as A, type IBaseModelDescription as I, type OutputFormat as O, type QualityLevel as Q, type SimpleGenerateOptions as S, type VendorOptionSchema as V, type IImageProvider as a, ImageGeneration as b, type ImageGenerationCreateOptions as c, type IImageModelDescription as d, type ImageModelCapabilities as e, type ImageModelPricing as f, IMAGE_MODELS as g, IMAGE_MODEL_REGISTRY as h, getImageModelInfo as i, getImageModelsByVendor as j, getActiveImageModels as k, getImageModelsWithFeature as l, calculateImageCost as m, type ImageGenerateOptions as n, type ImageEditOptions as o, type ImageVariationOptions as p, type ImageResponse as q, type AspectRatio$1 as r, type ISourceLinks as s };
+export { type AudioFormat as A, type IBaseModelDescription as I, type OutputFormat as O, type QualityLevel as Q, type SimpleGenerateOptions as S, type VendorOptionSchema as V, type IImageProvider as a, type AspectRatio$1 as b, type IImageModelDescription as c, IMAGE_MODELS as d, IMAGE_MODEL_REGISTRY as e, type ISourceLinks as f, type ImageEditOptions as g, type ImageGenerateOptions as h, ImageGeneration as i, type ImageGenerationCreateOptions as j, type ImageModelCapabilities as k, type ImageModelPricing as l, type ImageResponse as m, type ImageVariationOptions as n, calculateImageCost as o, getActiveImageModels as p, getImageModelInfo as q, getImageModelsByVendor as r, getImageModelsWithFeature as s };

package/dist/{ImageModel-BWN6VVS6.d.cts → ImageModel-zh19LiVM.d.cts}

@@ -1,4 +1,4 @@
-import { c as IProvider, b as Connector } from './IProvider-c4QCbPjn.cjs';
+import { e as IProvider, b as Connector } from './IProvider-Br817mKc.cjs';
 import { V as Vendor } from './Vendor-DYh_bzwo.cjs';
 
 /**
@@ -334,4 +334,4 @@ declare function getImageModelsWithFeature(feature: keyof IImageModelDescription
  */
 declare function calculateImageCost(modelName: string, imageCount: number, quality?: 'standard' | 'hd'): number | null;
 
-export { type AudioFormat as A, type IBaseModelDescription as I, type OutputFormat as O, type QualityLevel as Q, type SimpleGenerateOptions as S, type VendorOptionSchema as V, type IImageProvider as a, ImageGeneration as b, type ImageGenerationCreateOptions as c, type IImageModelDescription as d, type ImageModelCapabilities as e, type ImageModelPricing as f, IMAGE_MODELS as g, IMAGE_MODEL_REGISTRY as h, getImageModelInfo as i, getImageModelsByVendor as j, getActiveImageModels as k, getImageModelsWithFeature as l, calculateImageCost as m, type ImageGenerateOptions as n, type ImageEditOptions as o, type ImageVariationOptions as p, type ImageResponse as q, type AspectRatio$1 as r, type ISourceLinks as s };
+export { type AudioFormat as A, type IBaseModelDescription as I, type OutputFormat as O, type QualityLevel as Q, type SimpleGenerateOptions as S, type VendorOptionSchema as V, type IImageProvider as a, type AspectRatio$1 as b, type IImageModelDescription as c, IMAGE_MODELS as d, IMAGE_MODEL_REGISTRY as e, type ISourceLinks as f, type ImageEditOptions as g, type ImageGenerateOptions as h, ImageGeneration as i, type ImageGenerationCreateOptions as j, type ImageModelCapabilities as k, type ImageModelPricing as l, type ImageResponse as m, type ImageVariationOptions as n, calculateImageCost as o, getActiveImageModels as p, getImageModelInfo as q, getImageModelsByVendor as r, getImageModelsWithFeature as s };

package/dist/capabilities/agents/index.d.cts

@@ -1,4 +1,4 @@
-export { aD as AfterToolContext, av as AgentEventName, A as AgentEvents, ay as AgenticLoopEventName, ax as AgenticLoopEvents, aG as ApprovalResult, aE as ApproveToolContext, m as AuditEntry, aC as BeforeToolContext, aI as ExecutionCompleteEvent, aw as ExecutionConfig, E as ExecutionContext, l as ExecutionMetrics, aH as ExecutionStartEvent, j as HistoryMode, aA as Hook, H as HookConfig, au as HookManager, az as HookName, aL as LLMRequestEvent, aM as LLMResponseEvent, aB as ModifyingHook, aK as ToolCompleteEvent, aF as ToolModification, aJ as ToolStartEvent } from '../../index-D62LXWdW.cjs';
-import '../../IProvider-c4QCbPjn.cjs';
+export { x as AfterToolContext, y as AgentEventName, A as AgentEvents, z as AgenticLoopEventName, B as AgenticLoopEvents, D as ApprovalResult, G as ApproveToolContext, m as AuditEntry, J as BeforeToolContext, aH as ExecutionCompleteEvent, V as ExecutionConfig, E as ExecutionContext, l as ExecutionMetrics, aI as ExecutionStartEvent, j as HistoryMode, X as Hook, H as HookConfig, Y as HookManager, Z as HookName, aJ as LLMRequestEvent, aK as LLMResponseEvent, a6 as ModifyingHook, aL as ToolCompleteEvent, an as ToolModification, aM as ToolStartEvent } from '../../index-WlQwiNF8.cjs';
+import '../../IProvider-Br817mKc.cjs';
 import '../../Vendor-DYh_bzwo.cjs';
 import 'eventemitter3';

package/dist/capabilities/agents/index.d.ts

@@ -1,4 +1,4 @@
-export { aD as AfterToolContext, av as AgentEventName, A as AgentEvents, ay as AgenticLoopEventName, ax as AgenticLoopEvents, aG as ApprovalResult, aE as ApproveToolContext, m as AuditEntry, aC as BeforeToolContext, aI as ExecutionCompleteEvent, aw as ExecutionConfig, E as ExecutionContext, l as ExecutionMetrics, aH as ExecutionStartEvent, j as HistoryMode, aA as Hook, H as HookConfig, au as HookManager, az as HookName, aL as LLMRequestEvent, aM as LLMResponseEvent, aB as ModifyingHook, aK as ToolCompleteEvent, aF as ToolModification, aJ as ToolStartEvent } from '../../index-DVb6vfA3.js';
-import '../../IProvider-DcYJ3YE-.js';
+export { x as AfterToolContext, y as AgentEventName, A as AgentEvents, z as AgenticLoopEventName, B as AgenticLoopEvents, D as ApprovalResult, G as ApproveToolContext, m as AuditEntry, J as BeforeToolContext, aH as ExecutionCompleteEvent, V as ExecutionConfig, E as ExecutionContext, l as ExecutionMetrics, aI as ExecutionStartEvent, j as HistoryMode, X as Hook, H as HookConfig, Y as HookManager, Z as HookName, aJ as LLMRequestEvent, aK as LLMResponseEvent, a6 as ModifyingHook, aL as ToolCompleteEvent, an as ToolModification, aM as ToolStartEvent } from '../../index-BeZcWDiq.js';
+import '../../IProvider-BUbU5UwV.js';
 import '../../Vendor-DYh_bzwo.js';
 import 'eventemitter3';

package/dist/capabilities/images/index.cjs

@@ -816,6 +816,109 @@ var OAuthManager = class {
     }
   }
 };
+
+// src/core/StorageRegistry.ts
+var StorageRegistry = class _StorageRegistry {
+  /** Internal storage map */
+  static entries = /* @__PURE__ */ new Map();
+  /** Default context passed to all factory calls (set via setContext) */
+  static _context;
+  /**
+   * Configure multiple storage backends at once.
+   *
+   * @example
+   * ```typescript
+   * // Single-tenant
+   * StorageRegistry.configure({
+   *   customTools: new MongoCustomToolStorage(),
+   *   sessions: (agentId) => new RedisContextStorage(agentId),
+   * });
+   *
+   * // Multi-tenant
+   * StorageRegistry.configure({
+   *   sessions: (agentId, ctx) => new TenantContextStorage(agentId, ctx?.tenantId),
+   *   persistentInstructions: (agentId, ctx) => new TenantInstructionsStorage(agentId, ctx?.userId),
+   * });
+   * ```
+   */
+  static configure(config) {
+    for (const [key, value] of Object.entries(config)) {
+      if (value !== void 0) {
+        _StorageRegistry.entries.set(key, value);
+      }
+    }
+  }
+  /**
+   * Set the default StorageContext.
+   *
+   * This context is automatically passed to all per-agent factory calls
+   * (sessions, persistentInstructions, workingMemory) when no explicit
+   * context is provided. Typically set once at app startup with global
+   * tenant/environment info, or per-request in multi-tenant servers.
+   *
+   * @example
+   * ```typescript
+   * // Single-tenant app — set once at init
+   * StorageRegistry.setContext({ tenantId: 'acme', environment: 'production' });
+   *
+   * // Multi-tenant server — set per-request
+   * app.use((req, res, next) => {
+   *   StorageRegistry.setContext({ userId: req.user.id, tenantId: req.tenant.id });
+   *   next();
+   * });
+   * ```
+   */
+  static setContext(context) {
+    _StorageRegistry._context = context;
+  }
+  /**
+   * Get the current default StorageContext.
+   */
+  static getContext() {
+    return _StorageRegistry._context;
+  }
+  /**
+   * Set a single storage backend.
+   */
+  static set(key, value) {
+    _StorageRegistry.entries.set(key, value);
+  }
+  /**
+   * Get a storage backend (or undefined if not configured).
+   */
+  static get(key) {
+    return _StorageRegistry.entries.get(key);
+  }
+  /**
+   * Resolve a storage backend, lazily creating and caching a default if needed.
+   *
+   * If a value has been configured via `set()` or `configure()`, returns that.
+   * Otherwise, calls `defaultFactory()`, caches the result, and returns it.
+   */
+  static resolve(key, defaultFactory) {
+    const existing = _StorageRegistry.entries.get(key);
+    if (existing !== void 0) {
+      return existing;
+    }
+    const value = defaultFactory();
+    _StorageRegistry.entries.set(key, value);
+    return value;
+  }
+  /**
+   * Check if a storage backend has been configured.
+   */
+  static has(key) {
+    return _StorageRegistry.entries.has(key);
+  }
+  /**
+   * Clear all configured storage backends and context.
+   * Useful for testing.
+   */
+  static reset() {
+    _StorageRegistry.entries.clear();
+    _StorageRegistry._context = void 0;
+  }
+};
 var DEFAULT_CIRCUIT_BREAKER_CONFIG = {
   failureThreshold: 5,
   successThreshold: 2,
@@ -1553,7 +1656,6 @@ var DEFAULT_MAX_DELAY_MS = 3e4;
 var Connector = class _Connector {
   // ============ Static Registry ============
   static registry = /* @__PURE__ */ new Map();
-  static defaultStorage = new MemoryStorage();
   /**
    * Create and register a new connector
    * @param config - Must include `name` field
@@ -1611,11 +1713,18 @@ var Connector = class _Connector {
     }
     _Connector.registry.clear();
   }
+  /**
+   * Get the default token storage for OAuth connectors.
+   * Resolves from StorageRegistry, falling back to MemoryStorage.
+   */
+  static get defaultStorage() {
+    return StorageRegistry.resolve("oauthTokens", () => new MemoryStorage());
+  }
   /**
    * Set default token storage for OAuth connectors
    */
   static setDefaultStorage(storage) {
-    _Connector.defaultStorage = storage;
+    StorageRegistry.set("oauthTokens", storage);
   }
   /**
    * Get all registered connectors