@everworker/oneringai 0.2.3 → 0.3.1

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)
@@ -69,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
@@ -95,6 +96,7 @@ Better to see once and then dig in the code! :)
 - 👁️ **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
@@ -621,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:
@@ -944,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
 
@@ -1523,4 +1553,4 @@ MIT License - See [LICENSE](./LICENSE) file.
 
 ---
 
-**Version:** 0.2.1 | **Last Updated:** 2026-02-17 | **[User Guide](./USER_GUIDE.md)** | **[API Reference](./API_REFERENCE.md)** | **[Changelog](./CHANGELOG.md)**
+**Version:** 0.3.1 | **Last Updated:** 2026-02-18 | **[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