@everworker/oneringai 0.1.2 → 0.1.4

package/README.md

@@ -6,6 +6,54 @@
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.3-blue.svg)](https://www.typescriptlang.org/)
 [![Node.js](https://img.shields.io/badge/Node.js-18+-green.svg)](https://nodejs.org/)
 
+## Table of Contents
+
+- [Features](#features)
+- [Quick Start](#quick-start) — Installation, basic usage, tools, vision, audio, images, video, search, scraping
+- [Supported Providers](#supported-providers)
+- [Key Features](#key-features)
+  - [1. Agent with Plugins](#1-agent-with-plugins)
+  - [2. Dynamic Tool Management](#2-dynamic-tool-management-new)
+  - [3. Tool Execution Plugins](#3-tool-execution-plugins-new)
+  - [4. Session Persistence](#4-session-persistence)
+  - [5. Working Memory](#5-working-memory)
+  - [6. Research with Search Tools](#6-research-with-search-tools)
+  - [7. Context Management](#7-context-management)
+  - [8. InContextMemory](#8-incontextmemory)
+  - [9. Persistent Instructions](#9-persistent-instructions)
+  - [10. Direct LLM Access](#10-direct-llm-access)
+  - [11. Audio Capabilities](#11-audio-capabilities)
+  - [12. Model Registry](#12-model-registry)
+  - [13. Streaming](#13-streaming)
+  - [14. OAuth for External APIs](#14-oauth-for-external-apis)
+  - [15. Developer Tools](#15-developer-tools)
+  - [16. External API Integration](#16-external-api-integration) — Scoped Registry, Vendor Templates, Tool Discovery
+- [MCP Integration](#mcp-model-context-protocol-integration)
+- [Documentation](#documentation)
+- [Examples](#examples)
+- [Development](#development)
+- [Architecture](#architecture)
+- [Troubleshooting](#troubleshooting)
+- [Contributing](#contributing)
+- [License](#license)
+
+<!-- For in-depth guides and full API reference, see the docs section below -->
+
+## Documentation
+
+> **Start here if you're looking for detailed docs or the full API reference.**
+
+| Document | Description |
+|----------|-------------|
+| **[User Guide](./USER_GUIDE.md)** | Comprehensive guide covering every feature with examples — connectors, agents, context, plugins, audio, video, search, MCP, OAuth, and more |
+| **[API Reference](./API_REFERENCE.md)** | Auto-generated reference for all 600+ public exports — classes, interfaces, types, and functions with signatures |
+| [CHANGELOG](./CHANGELOG.md) | Version history and migration notes |
+| [MCP Integration](./MCP_INTEGRATION.md) | Model Context Protocol setup and usage |
+| [Architecture (CLAUDE.md)](./CLAUDE.md) | Internal architecture guide |
+| [Testing Guide](./TESTING.md) | How to run and write tests |
+
+---
+
 ## Features
 
 - ✨ **Unified API** - One interface for 10+ AI providers (OpenAI, Anthropic, Google, Groq, DeepSeek, and more)
@@ -557,7 +605,7 @@ await agent.run('Research AI developments in 2026 and store key findings');
 - 📝 **Working Memory** - Store findings with priority-based eviction
 - 🏗️ **Tiered Memory** - Raw → Summary → Findings pattern
 
-### 6. Context Management
+### 7. Context Management
 
 **AgentContextNextGen** is the modern, plugin-based context manager. It provides clean separation of concerns with composable plugins:
 
@@ -621,7 +669,7 @@ const agent = Agent.create({
 |---------|---------|--------|------------------|
 | `workingMemory` | `true` | WorkingMemoryPluginNextGen | `memory_store/retrieve/delete/list` |
 | `inContextMemory` | `false` | InContextMemoryPluginNextGen | `context_set/delete/list` |
-| `persistentInstructions` | `false` | PersistentInstructionsPluginNextGen | `instructions_set/get/append/clear` |
+| `persistentInstructions` | `false` | PersistentInstructionsPluginNextGen | `instructions_set/remove/list/clear` |
 
 **AgentContextNextGen architecture:**
 - **Plugin-first design** - All features are composable plugins
@@ -641,7 +689,7 @@ console.log(budget.available);           // Remaining tokens
 console.log(budget.utilizationPercent);  // Usage percentage
 ```
 
-### 7. InContextMemory
+### 8. InContextMemory
 
 Store key-value pairs **directly in context** for instant LLM access without retrieval calls:
 
@@ -674,7 +722,7 @@ const state = plugin.get('current_state');  // { step: 2, status: 'active' }
 
 **Use cases:** Session state, user preferences, counters, flags, small accumulated results.
 
-### 8. Persistent Instructions
+### 9. Persistent Instructions
 
 Store agent-level custom instructions that persist across sessions on disk:
 
@@ -692,8 +740,8 @@ const agent = Agent.create({
   },
 });
 
-// LLM can now use instructions_set/append/get/clear tools
-// Instructions persist to ~/.oneringai/agents/my-assistant/custom_instructions.md
+// LLM can now use instructions_set/remove/list/clear tools
+// Instructions persist to ~/.oneringai/agents/my-assistant/custom_instructions.json
 ```
 
 **Key Features:**
@@ -703,14 +751,14 @@ const agent = Agent.create({
 - 🛡️ **Never Compacted** - Critical instructions always preserved in context
 
 **Available Tools:**
-- `instructions_set` - Replace all custom instructions
-- `instructions_append` - Add a new section to existing instructions
-- `instructions_get` - Read current instructions
+- `instructions_set` - Add or update a single instruction by key
+- `instructions_remove` - Remove a single instruction by key
+- `instructions_list` - List all instructions with keys and content
 - `instructions_clear` - Remove all instructions (requires confirmation)
 
 **Use cases:** Agent personality/behavior, user preferences, learned rules, tool usage patterns.
 
-### 9. Direct LLM Access
+### 10. Direct LLM Access
 
 Bypass all context management for simple, stateless LLM calls:
 
@@ -925,7 +973,8 @@ Connector.create({
 });
 
 // Generate tools from the connector
-// Tools are prefixed with connector name: github_api, github_list_repos, etc.
+// GitHub connectors get 7 dedicated tools + generic API automatically:
+// search_files, search_code, read_file, get_pr, pr_files, pr_comments, create_pr
 const tools = ConnectorTools.for('github');
 
 // Use with an agent
@@ -935,12 +984,13 @@ const agent = Agent.create({
   tools: tools,
 });
 
-await agent.run('List all open issues in owner/repo');
+await agent.run('Find all TypeScript files in src/ and show me the entry point');
+await agent.run('Show me PR #42 and summarize the review comments');
 ```
 
 **Supported Services (35+):**
 - **Communication**: Slack, Discord, Microsoft Teams, Twilio
-- **Development**: GitHub, GitLab, Jira, Linear, Bitbucket
+- **Development**: GitHub *(7 built-in tools)*, GitLab, Jira, Linear, Bitbucket
 - **Productivity**: Notion, Asana, Monday, Airtable, Trello
 - **CRM**: Salesforce, HubSpot, Zendesk, Intercom
 - **Payments**: Stripe, PayPal, Square
@@ -1173,37 +1223,25 @@ await agent.run('List files and analyze them');
 
 See [MCP_INTEGRATION.md](./MCP_INTEGRATION.md) for complete documentation.
 
-## Documentation
-
-📖 **[Complete User Guide](./USER_GUIDE.md)** - Comprehensive guide covering all features
-
-### Additional Resources
-
-- **[MCP_INTEGRATION.md](./MCP_INTEGRATION.md)** - Model Context Protocol integration guide
-- **[CLAUDE.md](./CLAUDE.md)** - Architecture guide for AI assistants
-- **[MULTIMODAL_ARCHITECTURE.md](./MULTIMODAL_ARCHITECTURE.md)** - Multimodal implementation details
-- **[MICROSOFT_GRAPH_SETUP.md](./MICROSOFT_GRAPH_SETUP.md)** - Microsoft Graph OAuth setup
-- **[TESTING.md](./TESTING.md)** - Testing guide for contributors
-
 ## Examples
 
 ```bash
 # Basic examples
-npm run example:basic              # Simple text generation
-npm run example:streaming          # Streaming responses
+npm run example:text               # Simple text generation
+npm run example:agent              # Basic agent with tools
+npm run example:conversation       # Multi-turn conversation
+npm run example:chat               # Interactive chat
 npm run example:vision             # Image analysis
-npm run example:tools              # Tool calling
+npm run example:providers          # Multi-provider comparison
 
-# Audio examples
-npm run example:audio              # TTS and STT demo
+# Tools and hooks
+npm run example:json-tool          # JSON manipulation tool
+npm run example:hooks              # Agent lifecycle hooks
+npm run example:web                # Web research agent
 
-# Task Agent examples
-npm run example:task-agent         # Basic task agent
-npm run example:task-agent-demo    # Full demo with memory
-npm run example:planning-agent     # AI-driven planning
-
-# Context management
-npm run example:context-management # All strategies demo
+# OAuth examples
+npm run example:oauth              # OAuth demo
+npm run example:oauth-registry     # OAuth registry
 ```
 
 ## Development
@@ -1265,9 +1303,4 @@ MIT License - See [LICENSE](./LICENSE) file.
 
 ---
 
-**Version:** 0.1.2
-**Last Updated:** 2026-02-06
-
-For detailed documentation on all features, see the **[Complete User Guide](./USER_GUIDE.md)**.
-
-For internal development and architecture improvement plans, see **[IMPROVEMENT_PLAN.md](./IMPROVEMENT_PLAN.md)**.
+**Version:** 0.1.4 | **Last Updated:** 2026-02-08 | **[User Guide](./USER_GUIDE.md)** | **[API Reference](./API_REFERENCE.md)** | **[Changelog](./CHANGELOG.md)**

package/dist/{ImageModel-DtN780fU.d.cts → ImageModel-DSY7SNsq.d.cts}

@@ -1,35 +1,6 @@
+import { V as Vendor } from './Vendor-DYh_bzwo.cjs';
 import { I as IProvider } from './IProvider-BP49c93d.cjs';
 
-/**
- * Supported AI Vendors
- *
- * Use this enum instead of string literals for type safety.
- * These map to specific provider implementations.
- */
-declare const Vendor: {
-    readonly OpenAI: "openai";
-    readonly Anthropic: "anthropic";
-    readonly Google: "google";
-    readonly GoogleVertex: "google-vertex";
-    readonly Groq: "groq";
-    readonly Together: "together";
-    readonly Perplexity: "perplexity";
-    readonly Grok: "grok";
-    readonly DeepSeek: "deepseek";
-    readonly Mistral: "mistral";
-    readonly Ollama: "ollama";
-    readonly Custom: "custom";
-};
-type Vendor = (typeof Vendor)[keyof typeof Vendor];
-/**
- * All vendor values as array (useful for validation)
- */
-declare const VENDORS: ("openai" | "anthropic" | "google" | "google-vertex" | "groq" | "together" | "perplexity" | "grok" | "deepseek" | "mistral" | "ollama" | "custom")[];
-/**
- * Check if a string is a valid vendor
- */
-declare function isVendor(value: string): value is Vendor;
-
 /**
  * Connector - Represents authenticated connection to ANY API
  *
@@ -72,6 +43,8 @@ interface OAuthConnectorAuth {
     audience?: string;
     refreshBeforeExpiry?: number;
     storageKey?: string;
+    /** Vendor-specific extra credentials */
+    extra?: Record<string, string>;
 }
 /**
  * Static API key authentication
@@ -82,6 +55,11 @@ interface APIKeyConnectorAuth {
     apiKey: string;
     headerName?: string;
     headerPrefix?: string;
+    /**
+     * Vendor-specific extra credentials beyond the primary API key.
+     * E.g., Slack Socket Mode needs { appToken: 'xapp-...', signingSecret: '...' }
+     */
+    extra?: Record<string, string>;
 }
 /**
  * JWT Bearer token authentication
@@ -97,6 +75,8 @@ interface JWTConnectorAuth {
     issuer?: string;
     subject?: string;
     audience?: string;
+    /** Vendor-specific extra credentials */
+    extra?: Record<string, string>;
 }
 /**
  * Complete connector configuration
@@ -835,4 +815,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 ImageGenerateOptions as B, type ConnectorAccessContext as C, type ImageEditOptions as D, type ImageVariationOptions as E, type ImageResponse as F, type AspectRatio$1 as G, type OutputFormat as H, type IConnectorRegistry as I, type JWTConnectorAuth as J, type ISourceLinks as K, DEFAULT_CONNECTOR_TIMEOUT as L, DEFAULT_MAX_RETRIES as M, DEFAULT_RETRYABLE_STATUSES as N, type OAuthConnectorAuth as O, DEFAULT_BASE_DELAY_MS as P, type QualityLevel as Q, DEFAULT_MAX_DELAY_MS as R, type StoredToken as S, type VendorOptionSchema as V, type IConnectorAccessPolicy as a, Connector as b, type IBaseModelDescription as c, Vendor as d, type IImageProvider as e, type ConnectorFetchOptions as f, type ITokenStorage as g, type ConnectorConfig as h, type ConnectorAuth as i, type ConnectorConfigResult as j, VENDORS as k, isVendor as l, ImageGeneration as m, type ImageGenerationCreateOptions as n, type SimpleGenerateOptions as o, type APIKeyConnectorAuth as p, type IImageModelDescription as q, type ImageModelCapabilities as r, type ImageModelPricing as s, IMAGE_MODELS as t, IMAGE_MODEL_REGISTRY as u, getImageModelInfo as v, getImageModelsByVendor as w, getActiveImageModels as x, getImageModelsWithFeature as y, calculateImageCost as z };
+export { type AudioFormat as A, type ImageResponse as B, type ConnectorAccessContext as C, type AspectRatio$1 as D, type OutputFormat as E, type ISourceLinks as F, DEFAULT_CONNECTOR_TIMEOUT as G, DEFAULT_MAX_RETRIES as H, type IConnectorRegistry as I, type JWTConnectorAuth as J, DEFAULT_RETRYABLE_STATUSES as K, DEFAULT_BASE_DELAY_MS as L, DEFAULT_MAX_DELAY_MS as M, type OAuthConnectorAuth as O, type QualityLevel as Q, type StoredToken as S, type VendorOptionSchema as V, type IConnectorAccessPolicy as a, Connector as b, type IBaseModelDescription as c, type IImageProvider as d, type ConnectorFetchOptions as e, type ITokenStorage as f, type ConnectorConfig as g, type ConnectorAuth as h, type ConnectorConfigResult as i, ImageGeneration as j, type ImageGenerationCreateOptions as k, type SimpleGenerateOptions as l, type APIKeyConnectorAuth as m, type IImageModelDescription as n, type ImageModelCapabilities as o, type ImageModelPricing as p, IMAGE_MODELS as q, IMAGE_MODEL_REGISTRY as r, getImageModelInfo as s, getImageModelsByVendor as t, getActiveImageModels as u, getImageModelsWithFeature as v, calculateImageCost as w, type ImageGenerateOptions as x, type ImageEditOptions as y, type ImageVariationOptions as z };

package/dist/{ImageModel-BkAX5Rr5.d.ts → ImageModel-qNJHPh4q.d.ts}

@@ -1,35 +1,6 @@
+import { V as Vendor } from './Vendor-DYh_bzwo.js';
 import { I as IProvider } from './IProvider-BP49c93d.js';
 
-/**
- * Supported AI Vendors
- *
- * Use this enum instead of string literals for type safety.
- * These map to specific provider implementations.
- */
-declare const Vendor: {
-    readonly OpenAI: "openai";
-    readonly Anthropic: "anthropic";
-    readonly Google: "google";
-    readonly GoogleVertex: "google-vertex";
-    readonly Groq: "groq";
-    readonly Together: "together";
-    readonly Perplexity: "perplexity";
-    readonly Grok: "grok";
-    readonly DeepSeek: "deepseek";
-    readonly Mistral: "mistral";
-    readonly Ollama: "ollama";
-    readonly Custom: "custom";
-};
-type Vendor = (typeof Vendor)[keyof typeof Vendor];
-/**
- * All vendor values as array (useful for validation)
- */
-declare const VENDORS: ("openai" | "anthropic" | "google" | "google-vertex" | "groq" | "together" | "perplexity" | "grok" | "deepseek" | "mistral" | "ollama" | "custom")[];
-/**
- * Check if a string is a valid vendor
- */
-declare function isVendor(value: string): value is Vendor;
-
 /**
  * Connector - Represents authenticated connection to ANY API
  *
@@ -72,6 +43,8 @@ interface OAuthConnectorAuth {
     audience?: string;
     refreshBeforeExpiry?: number;
     storageKey?: string;
+    /** Vendor-specific extra credentials */
+    extra?: Record<string, string>;
 }
 /**
  * Static API key authentication
@@ -82,6 +55,11 @@ interface APIKeyConnectorAuth {
     apiKey: string;
     headerName?: string;
     headerPrefix?: string;
+    /**
+     * Vendor-specific extra credentials beyond the primary API key.
+     * E.g., Slack Socket Mode needs { appToken: 'xapp-...', signingSecret: '...' }
+     */
+    extra?: Record<string, string>;
 }
 /**
  * JWT Bearer token authentication
@@ -97,6 +75,8 @@ interface JWTConnectorAuth {
     issuer?: string;
     subject?: string;
     audience?: string;
+    /** Vendor-specific extra credentials */
+    extra?: Record<string, string>;
 }
 /**
  * Complete connector configuration
@@ -835,4 +815,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 ImageGenerateOptions as B, type ConnectorAccessContext as C, type ImageEditOptions as D, type ImageVariationOptions as E, type ImageResponse as F, type AspectRatio$1 as G, type OutputFormat as H, type IConnectorRegistry as I, type JWTConnectorAuth as J, type ISourceLinks as K, DEFAULT_CONNECTOR_TIMEOUT as L, DEFAULT_MAX_RETRIES as M, DEFAULT_RETRYABLE_STATUSES as N, type OAuthConnectorAuth as O, DEFAULT_BASE_DELAY_MS as P, type QualityLevel as Q, DEFAULT_MAX_DELAY_MS as R, type StoredToken as S, type VendorOptionSchema as V, type IConnectorAccessPolicy as a, Connector as b, type IBaseModelDescription as c, Vendor as d, type IImageProvider as e, type ConnectorFetchOptions as f, type ITokenStorage as g, type ConnectorConfig as h, type ConnectorAuth as i, type ConnectorConfigResult as j, VENDORS as k, isVendor as l, ImageGeneration as m, type ImageGenerationCreateOptions as n, type SimpleGenerateOptions as o, type APIKeyConnectorAuth as p, type IImageModelDescription as q, type ImageModelCapabilities as r, type ImageModelPricing as s, IMAGE_MODELS as t, IMAGE_MODEL_REGISTRY as u, getImageModelInfo as v, getImageModelsByVendor as w, getActiveImageModels as x, getImageModelsWithFeature as y, calculateImageCost as z };
+export { type AudioFormat as A, type ImageResponse as B, type ConnectorAccessContext as C, type AspectRatio$1 as D, type OutputFormat as E, type ISourceLinks as F, DEFAULT_CONNECTOR_TIMEOUT as G, DEFAULT_MAX_RETRIES as H, type IConnectorRegistry as I, type JWTConnectorAuth as J, DEFAULT_RETRYABLE_STATUSES as K, DEFAULT_BASE_DELAY_MS as L, DEFAULT_MAX_DELAY_MS as M, type OAuthConnectorAuth as O, type QualityLevel as Q, type StoredToken as S, type VendorOptionSchema as V, type IConnectorAccessPolicy as a, Connector as b, type IBaseModelDescription as c, type IImageProvider as d, type ConnectorFetchOptions as e, type ITokenStorage as f, type ConnectorConfig as g, type ConnectorAuth as h, type ConnectorConfigResult as i, ImageGeneration as j, type ImageGenerationCreateOptions as k, type SimpleGenerateOptions as l, type APIKeyConnectorAuth as m, type IImageModelDescription as n, type ImageModelCapabilities as o, type ImageModelPricing as p, IMAGE_MODELS as q, IMAGE_MODEL_REGISTRY as r, getImageModelInfo as s, getImageModelsByVendor as t, getActiveImageModels as u, getImageModelsWithFeature as v, calculateImageCost as w, type ImageGenerateOptions as x, type ImageEditOptions as y, type ImageVariationOptions as z };

package/dist/Vendor-DYh_bzwo.d.cts

@@ -0,0 +1,31 @@
+/**
+ * Supported AI Vendors
+ *
+ * Use this enum instead of string literals for type safety.
+ * These map to specific provider implementations.
+ */
+declare const Vendor: {
+    readonly OpenAI: "openai";
+    readonly Anthropic: "anthropic";
+    readonly Google: "google";
+    readonly GoogleVertex: "google-vertex";
+    readonly Groq: "groq";
+    readonly Together: "together";
+    readonly Perplexity: "perplexity";
+    readonly Grok: "grok";
+    readonly DeepSeek: "deepseek";
+    readonly Mistral: "mistral";
+    readonly Ollama: "ollama";
+    readonly Custom: "custom";
+};
+type Vendor = (typeof Vendor)[keyof typeof Vendor];
+/**
+ * All vendor values as array (useful for validation)
+ */
+declare const VENDORS: ("openai" | "anthropic" | "google" | "google-vertex" | "groq" | "together" | "perplexity" | "grok" | "deepseek" | "mistral" | "ollama" | "custom")[];
+/**
+ * Check if a string is a valid vendor
+ */
+declare function isVendor(value: string): value is Vendor;
+
+export { Vendor as V, VENDORS as a, isVendor as i };

package/dist/Vendor-DYh_bzwo.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Supported AI Vendors
+ *
+ * Use this enum instead of string literals for type safety.
+ * These map to specific provider implementations.
+ */
+declare const Vendor: {
+    readonly OpenAI: "openai";
+    readonly Anthropic: "anthropic";
+    readonly Google: "google";
+    readonly GoogleVertex: "google-vertex";
+    readonly Groq: "groq";
+    readonly Together: "together";
+    readonly Perplexity: "perplexity";
+    readonly Grok: "grok";
+    readonly DeepSeek: "deepseek";
+    readonly Mistral: "mistral";
+    readonly Ollama: "ollama";
+    readonly Custom: "custom";
+};
+type Vendor = (typeof Vendor)[keyof typeof Vendor];
+/**
+ * All vendor values as array (useful for validation)
+ */
+declare const VENDORS: ("openai" | "anthropic" | "google" | "google-vertex" | "groq" | "together" | "perplexity" | "grok" | "deepseek" | "mistral" | "ollama" | "custom")[];
+/**
+ * Check if a string is a valid vendor
+ */
+declare function isVendor(value: string): value is Vendor;
+
+export { Vendor as V, VENDORS as a, isVendor as i };

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

@@ -1,3 +1,3 @@
-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-DCzFlLoN.cjs';
+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-NOV01LWF.cjs';
 import '../../IProvider-BP49c93d.cjs';
 import 'eventemitter3';

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

@@ -1,3 +1,3 @@
-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-BmOYeqU7.js';
+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-CEp1H4fV.js';
 import '../../IProvider-BP49c93d.js';
 import 'eventemitter3';

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

@@ -1,2 +1,3 @@
-export { D as ImageEditOptions, B as ImageGenerateOptions, m as ImageGeneration, n as ImageGenerationCreateOptions, F as ImageResponse, E as ImageVariationOptions, o as SimpleGenerateOptions } from '../../ImageModel-DtN780fU.cjs';
+export { y as ImageEditOptions, x as ImageGenerateOptions, j as ImageGeneration, k as ImageGenerationCreateOptions, B as ImageResponse, z as ImageVariationOptions, l as SimpleGenerateOptions } from '../../ImageModel-DSY7SNsq.cjs';
+import '../../Vendor-DYh_bzwo.cjs';
 import '../../IProvider-BP49c93d.cjs';

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

@@ -1,2 +1,3 @@
-export { D as ImageEditOptions, B as ImageGenerateOptions, m as ImageGeneration, n as ImageGenerationCreateOptions, F as ImageResponse, E as ImageVariationOptions, o as SimpleGenerateOptions } from '../../ImageModel-BkAX5Rr5.js';
+export { y as ImageEditOptions, x as ImageGenerateOptions, j as ImageGeneration, k as ImageGenerationCreateOptions, B as ImageResponse, z as ImageVariationOptions, l as SimpleGenerateOptions } from '../../ImageModel-qNJHPh4q.js';
+import '../../Vendor-DYh_bzwo.js';
 import '../../IProvider-BP49c93d.js';

package/dist/{index-BmOYeqU7.d.ts → index-CEp1H4fV.d.ts}

@@ -268,6 +268,8 @@ interface ToolContext {
     agentId?: string;
     /** Task ID (if running in TaskAgent) */
     taskId?: string;
+    /** User ID — set by host app via agent.tools.setToolContext() for per-user operations */
+    userId?: string;
     /** Working memory access (if agent has memory feature enabled) */
     memory?: WorkingMemoryAccess;
     /** Abort signal for cancellation */

package/dist/{index-DCzFlLoN.d.cts → index-NOV01LWF.d.cts}

@@ -268,6 +268,8 @@ interface ToolContext {
     agentId?: string;
     /** Task ID (if running in TaskAgent) */
     taskId?: string;
+    /** User ID — set by host app via agent.tools.setToolContext() for per-user operations */
+    userId?: string;
     /** Working memory access (if agent has memory feature enabled) */
     memory?: WorkingMemoryAccess;
     /** Abort signal for cancellation */