@everworker/oneringai 0.4.1 → 0.4.3

package/README.md

@@ -69,6 +69,10 @@ Or read the more detailed installation / setup instructions [here](https://githu
 
 Better to see once and then dig in the code! :)
 
+## YOUetal
+
+Showcasing another amazing "built with oneringai": ["no saas" agentic business team](https://youetal.ai)
+
 ## Features
 
 - ✨ **Unified API** - One interface for 10+ AI providers (OpenAI, Anthropic, Google, Groq, DeepSeek, and more)
@@ -1286,13 +1290,35 @@ console.log(execution.status); // 'completed' | 'failed'
 ```
 
 **Key Features:**
-- 🔗 **Task Dependencies** - DAG-based ordering via `dependsOn`
-- 🧠 **Memory Bridging** - In-context memory (`context_set`) + working memory (`memory_store`) persist across tasks while conversation is cleared
-- 🔍 **LLM Validation** - Self-reflection against completion criteria with configurable score thresholds
-- 🔄 **Retry Logic** - Configurable `maxAttempts` per task with automatic retry on validation failure
-- 📊 **Progress Tracking** - Real-time callbacks and progress percentage
-- ⚙️ **Failure Modes** - `fail-fast` (default) or `continue` for independent tasks
-- 🎨 **Custom Prompts** - Override system, task, or validation prompts
+- **Task Dependencies** - DAG-based ordering via `dependsOn`
+- **Memory Bridging** - In-context memory (`context_set`) + working memory (`memory_store`) persist across tasks while conversation is cleared
+- **LLM Validation** - Self-reflection against completion criteria with configurable score thresholds
+- **Retry Logic** - Configurable `maxAttempts` per task with automatic retry on validation failure
+- **Smart Error Classification** - Permanent errors (auth, config, model-not-found) skip retry; transient errors retry normally
+- **Control Flow** - `map`, `fold`, and `until` flows with optional per-iteration timeout (`iterationTimeoutMs`)
+- **Progress Tracking** - Real-time callbacks and progress percentage
+- **Failure Modes** - `fail-fast` (default) or `continue` for independent tasks
+- **Custom Prompts** - Override system, task, or validation prompts
+- **`ROUTINE_KEYS` export** - Well-known ICM/WM key constants for custom integrations
+
+**Control Flow with Timeout:**
+
+```typescript
+const routine = createRoutineDefinition({
+  name: 'Process Batch',
+  tasks: [{
+    name: 'Process Each',
+    description: 'Process each item',
+    controlFlow: {
+      type: 'map',
+      sourceKey: '__items',
+      resultKey: '__results',
+      iterationTimeoutMs: 60000, // 1 min per item
+      tasks: [{ name: 'Process', description: 'Handle the current item' }],
+    },
+  }],
+});
+```
 
 **Routine Persistence:** Save and load routine definitions with `FileRoutineDefinitionStorage` (or implement `IRoutineDefinitionStorage` for custom backends). Per-user isolation via optional `userId`. Integrated into `StorageRegistry` as `routineDefinitions`.
 
@@ -1704,4 +1730,4 @@ MIT License - See [LICENSE](./LICENSE) file.
 
 ---
 
-**Version:** 0.3.2 | **Last Updated:** 2026-02-19 | **[User Guide](./USER_GUIDE.md)** | **[API Reference](./API_REFERENCE.md)** | **[Changelog](./CHANGELOG.md)**
+**Version:** 0.4.3 | **Last Updated:** 2026-02-25 | **[User Guide](./USER_GUIDE.md)** | **[API Reference](./API_REFERENCE.md)** | **[Changelog](./CHANGELOG.md)**

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

@@ -11,7 +11,7 @@ import { V as Vendor } from './Vendor-DYh_bzwo.cjs';
  */
 
 /**
- * No authentication (for testing/mock providers)
+ * No authentication (for testing/mock providers and local services like Ollama)
  */
 interface NoneConnectorAuth {
     type: 'none';
@@ -204,6 +204,13 @@ interface ITokenStorage {
      * @returns True if token exists
      */
     hasToken(key: string): Promise<boolean>;
+    /**
+     * List all storage keys (for account enumeration).
+     * Optional — implementations that support it enable multi-account listing.
+     *
+     * @returns Array of all stored token keys
+     */
+    listKeys?(): Promise<string[]>;
 }
 
 /**
@@ -406,22 +413,43 @@ declare class Connector {
     /**
      * Get the current access token (for OAuth, JWT, or API key)
      * Handles automatic refresh if needed
+     *
+     * @param userId - Optional user identifier for multi-user support
+     * @param accountId - Optional account alias for multi-account support (e.g., 'work', 'personal')
      */
-    getToken(userId?: string): Promise<string>;
+    getToken(userId?: string, accountId?: string): Promise<string>;
     /**
      * Start OAuth authorization flow
      * Returns the URL to redirect the user to
+     *
+     * @param userId - Optional user identifier for multi-user support
+     * @param accountId - Optional account alias for multi-account support (e.g., 'work', 'personal')
      */
-    startAuth(userId?: string): Promise<string>;
+    startAuth(userId?: string, accountId?: string): Promise<string>;
     /**
      * Handle OAuth callback
      * Call this after user is redirected back from OAuth provider
+     *
+     * @param callbackUrl - Full callback URL with code and state parameters
+     * @param userId - Optional user identifier (can be extracted from state if embedded)
+     * @param accountId - Optional account alias (can be extracted from state if embedded)
      */
-    handleCallback(callbackUrl: string, userId?: string): Promise<void>;
+    handleCallback(callbackUrl: string, userId?: string, accountId?: string): Promise<void>;
     /**
      * Check if the connector has a valid token
+     *
+     * @param userId - Optional user identifier for multi-user support
+     * @param accountId - Optional account alias for multi-account support
+     */
+    hasValidToken(userId?: string, accountId?: string): Promise<boolean>;
+    /**
+     * List account aliases for a user on this connector.
+     * Only applicable for OAuth connectors with multi-account support.
+     *
+     * @param userId - Optional user identifier
+     * @returns Array of account aliases (e.g., ['work', 'personal'])
      */
-    hasValidToken(userId?: string): Promise<boolean>;
+    listAccounts(userId?: string): Promise<string[]>;
     /**
      * Get vendor-specific options from config
      */
@@ -457,9 +485,10 @@ declare class Connector {
      * @param endpoint - API endpoint (relative to baseURL) or full URL
      * @param options - Fetch options with connector-specific settings
      * @param userId - Optional user ID for multi-user OAuth
+     * @param accountId - Optional account alias for multi-account OAuth
      * @returns Fetch Response
      */
-    fetch(endpoint: string, options?: ConnectorFetchOptions, userId?: string): Promise<Response>;
+    fetch(endpoint: string, options?: ConnectorFetchOptions, userId?: string, accountId?: string): Promise<Response>;
     /**
      * Make an authenticated fetch request and parse JSON response
      * Throws on non-OK responses
@@ -467,9 +496,10 @@ declare class Connector {
      * @param endpoint - API endpoint (relative to baseURL) or full URL
      * @param options - Fetch options with connector-specific settings
      * @param userId - Optional user ID for multi-user OAuth
+     * @param accountId - Optional account alias for multi-account OAuth
      * @returns Parsed JSON response
      */
-    fetchJSON<T = unknown>(endpoint: string, options?: ConnectorFetchOptions, userId?: string): Promise<T>;
+    fetchJSON<T = unknown>(endpoint: string, options?: ConnectorFetchOptions, userId?: string, accountId?: string): Promise<T>;
     private sleep;
     private logRequest;
     private logResponse;

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

@@ -11,7 +11,7 @@ import { V as Vendor } from './Vendor-DYh_bzwo.js';
  */
 
 /**
- * No authentication (for testing/mock providers)
+ * No authentication (for testing/mock providers and local services like Ollama)
  */
 interface NoneConnectorAuth {
     type: 'none';
@@ -204,6 +204,13 @@ interface ITokenStorage {
      * @returns True if token exists
      */
     hasToken(key: string): Promise<boolean>;
+    /**
+     * List all storage keys (for account enumeration).
+     * Optional — implementations that support it enable multi-account listing.
+     *
+     * @returns Array of all stored token keys
+     */
+    listKeys?(): Promise<string[]>;
 }
 
 /**
@@ -406,22 +413,43 @@ declare class Connector {
     /**
      * Get the current access token (for OAuth, JWT, or API key)
      * Handles automatic refresh if needed
+     *
+     * @param userId - Optional user identifier for multi-user support
+     * @param accountId - Optional account alias for multi-account support (e.g., 'work', 'personal')
      */
-    getToken(userId?: string): Promise<string>;
+    getToken(userId?: string, accountId?: string): Promise<string>;
     /**
      * Start OAuth authorization flow
      * Returns the URL to redirect the user to
+     *
+     * @param userId - Optional user identifier for multi-user support
+     * @param accountId - Optional account alias for multi-account support (e.g., 'work', 'personal')
      */
-    startAuth(userId?: string): Promise<string>;
+    startAuth(userId?: string, accountId?: string): Promise<string>;
     /**
      * Handle OAuth callback
      * Call this after user is redirected back from OAuth provider
+     *
+     * @param callbackUrl - Full callback URL with code and state parameters
+     * @param userId - Optional user identifier (can be extracted from state if embedded)
+     * @param accountId - Optional account alias (can be extracted from state if embedded)
      */
-    handleCallback(callbackUrl: string, userId?: string): Promise<void>;
+    handleCallback(callbackUrl: string, userId?: string, accountId?: string): Promise<void>;
     /**
      * Check if the connector has a valid token
+     *
+     * @param userId - Optional user identifier for multi-user support
+     * @param accountId - Optional account alias for multi-account support
+     */
+    hasValidToken(userId?: string, accountId?: string): Promise<boolean>;
+    /**
+     * List account aliases for a user on this connector.
+     * Only applicable for OAuth connectors with multi-account support.
+     *
+     * @param userId - Optional user identifier
+     * @returns Array of account aliases (e.g., ['work', 'personal'])
      */
-    hasValidToken(userId?: string): Promise<boolean>;
+    listAccounts(userId?: string): Promise<string[]>;
     /**
      * Get vendor-specific options from config
      */
@@ -457,9 +485,10 @@ declare class Connector {
      * @param endpoint - API endpoint (relative to baseURL) or full URL
      * @param options - Fetch options with connector-specific settings
      * @param userId - Optional user ID for multi-user OAuth
+     * @param accountId - Optional account alias for multi-account OAuth
      * @returns Fetch Response
      */
-    fetch(endpoint: string, options?: ConnectorFetchOptions, userId?: string): Promise<Response>;
+    fetch(endpoint: string, options?: ConnectorFetchOptions, userId?: string, accountId?: string): Promise<Response>;
     /**
      * Make an authenticated fetch request and parse JSON response
      * Throws on non-OK responses
@@ -467,9 +496,10 @@ declare class Connector {
      * @param endpoint - API endpoint (relative to baseURL) or full URL
      * @param options - Fetch options with connector-specific settings
      * @param userId - Optional user ID for multi-user OAuth
+     * @param accountId - Optional account alias for multi-account OAuth
      * @returns Parsed JSON response
      */
-    fetchJSON<T = unknown>(endpoint: string, options?: ConnectorFetchOptions, userId?: string): Promise<T>;
+    fetchJSON<T = unknown>(endpoint: string, options?: ConnectorFetchOptions, userId?: string, accountId?: string): Promise<T>;
     private sleep;
     private logRequest;
     private logResponse;

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

@@ -1,4 +1,4 @@
-import { e as IProvider, b as Connector } from './IProvider-Br817mKc.cjs';
+import { e as IProvider, b as Connector } from './IProvider-B8sqUzJG.cjs';
 import { V as Vendor } from './Vendor-DYh_bzwo.cjs';
 
 /**

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

@@ -1,4 +1,4 @@
-import { e as IProvider, b as Connector } from './IProvider-BUbU5UwV.js';
+import { e as IProvider, b as Connector } from './IProvider-CxDUGl6n.js';
 import { V as Vendor } from './Vendor-DYh_bzwo.js';
 
 /**

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

@@ -1,4 +1,4 @@
-export { y as AfterToolContext, z as AgentEventName, A as AgentEvents, B as AgenticLoopEventName, D as AgenticLoopEvents, G as ApprovalResult, J as ApproveToolContext, m as AuditEntry, K as BeforeToolContext, aH as ExecutionCompleteEvent, X as ExecutionConfig, E as ExecutionContext, l as ExecutionMetrics, aI as ExecutionStartEvent, j as HistoryMode, Y as Hook, H as HookConfig, Z as HookManager, n as HookName, aJ as LLMRequestEvent, aK as LLMResponseEvent, a6 as ModifyingHook, aL as ToolCompleteEvent, an as ToolModification, aM as ToolStartEvent } from '../../index-CR5PHkck.cjs';
-import '../../IProvider-Br817mKc.cjs';
+export { a2 as AfterToolContext, a3 as AgentEventName, w as AgentEvents, a4 as AgenticLoopEventName, a5 as AgenticLoopEvents, a6 as ApprovalResult, a7 as ApproveToolContext, z as AuditEntry, a8 as BeforeToolContext, b8 as ExecutionCompleteEvent, ah as ExecutionConfig, E as ExecutionContext, y as ExecutionMetrics, b9 as ExecutionStartEvent, v as HistoryMode, ai as Hook, H as HookConfig, aj as HookManager, D as HookName, ba as LLMRequestEvent, bb as LLMResponseEvent, as as ModifyingHook, bc as ToolCompleteEvent, aO as ToolModification, bd as ToolStartEvent } from '../../index-CEjKTeSb.cjs';
+import '../../IProvider-B8sqUzJG.cjs';
 import '../../Vendor-DYh_bzwo.cjs';
 import 'eventemitter3';

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

@@ -1,4 +1,4 @@
-export { y as AfterToolContext, z as AgentEventName, A as AgentEvents, B as AgenticLoopEventName, D as AgenticLoopEvents, G as ApprovalResult, J as ApproveToolContext, m as AuditEntry, K as BeforeToolContext, aH as ExecutionCompleteEvent, X as ExecutionConfig, E as ExecutionContext, l as ExecutionMetrics, aI as ExecutionStartEvent, j as HistoryMode, Y as Hook, H as HookConfig, Z as HookManager, n as HookName, aJ as LLMRequestEvent, aK as LLMResponseEvent, a6 as ModifyingHook, aL as ToolCompleteEvent, an as ToolModification, aM as ToolStartEvent } from '../../index-Cb7N9QIj.js';
-import '../../IProvider-BUbU5UwV.js';
+export { a2 as AfterToolContext, a3 as AgentEventName, w as AgentEvents, a4 as AgenticLoopEventName, a5 as AgenticLoopEvents, a6 as ApprovalResult, a7 as ApproveToolContext, z as AuditEntry, a8 as BeforeToolContext, b8 as ExecutionCompleteEvent, ah as ExecutionConfig, E as ExecutionContext, y as ExecutionMetrics, b9 as ExecutionStartEvent, v as HistoryMode, ai as Hook, H as HookConfig, aj as HookManager, D as HookName, ba as LLMRequestEvent, bb as LLMResponseEvent, as as ModifyingHook, bc as ToolCompleteEvent, aO as ToolModification, bd as ToolStartEvent } from '../../index-CzGnmqOs.js';
+import '../../IProvider-CxDUGl6n.js';
 import '../../Vendor-DYh_bzwo.js';
 import 'eventemitter3';