@everworker/oneringai 0.1.3 → 0.1.4

package/README.md

@@ -18,10 +18,10 @@
   - [4. Session Persistence](#4-session-persistence)
   - [5. Working Memory](#5-working-memory)
   - [6. Research with Search Tools](#6-research-with-search-tools)
-  - [6. Context Management](#6-context-management)
-  - [7. InContextMemory](#7-incontextmemory)
-  - [8. Persistent Instructions](#8-persistent-instructions)
-  - [9. Direct LLM Access](#9-direct-llm-access)
+  - [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)
@@ -605,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:
 
@@ -689,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:
 
@@ -722,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:
 
@@ -758,7 +758,7 @@ const agent = Agent.create({
 
 **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:
 
@@ -973,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
@@ -983,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
@@ -1225,21 +1227,21 @@ See [MCP_INTEGRATION.md](./MCP_INTEGRATION.md) for complete documentation.
 
 ```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
@@ -1301,4 +1303,4 @@ MIT License - See [LICENSE](./LICENSE) file.
 
 ---
 
-**Version:** 0.1.3 | **Last Updated:** 2026-02-07 | **[User Guide](./USER_GUIDE.md)** | **[API Reference](./API_REFERENCE.md)** | **[Changelog](./CHANGELOG.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 */