@everworker/oneringai 0.1.2 → 0.1.4

package/dist/index.d.ts

@@ -1,9 +1,13 @@
-import { I as IConnectorRegistry, a as IConnectorAccessPolicy, C as ConnectorAccessContext, b as Connector, A as AudioFormat, c as IBaseModelDescription, V as VendorOptionSchema, d as Vendor, e as IImageProvider, f as ConnectorFetchOptions, g as ITokenStorage, S as StoredToken$1, h as ConnectorConfig, i as ConnectorAuth, j as ConnectorConfigResult } from './ImageModel-BkAX5Rr5.js';
-export { p as APIKeyConnectorAuth, G as AspectRatio, P as DEFAULT_BASE_DELAY_MS, L as DEFAULT_CONNECTOR_TIMEOUT, R as DEFAULT_MAX_DELAY_MS, M as DEFAULT_MAX_RETRIES, N as DEFAULT_RETRYABLE_STATUSES, q as IImageModelDescription, t as IMAGE_MODELS, u as IMAGE_MODEL_REGISTRY, K as ISourceLinks, D as ImageEditOptions, B as ImageGenerateOptions, m as ImageGeneration, n as ImageGenerationCreateOptions, r as ImageModelCapabilities, s as ImageModelPricing, F as ImageResponse, E as ImageVariationOptions, J as JWTConnectorAuth, O as OAuthConnectorAuth, H as OutputFormat, Q as QualityLevel, o as SimpleGenerateOptions, k as VENDORS, z as calculateImageCost, x as getActiveImageModels, v as getImageModelInfo, w as getImageModelsByVendor, y as getImageModelsWithFeature, l as isVendor } from './ImageModel-BkAX5Rr5.js';
-import { T as Tool, a as ToolFunction, b as ToolContext, c as ToolPermissionConfig$1, d as ToolCall, I as InputItem, M as MemoryEntry, e as MemoryScope, W as WorkingMemoryConfig, P as PriorityCalculator, f as MemoryPriority, g as MemoryTier, C as Content, O as OutputItem, h as ToolResult, i as ITextProvider, F as FunctionToolDefinition, L as LLMResponse, S as StreamEvent, H as HookConfig, j as HistoryMode, A as AgentEvents, k as AgentResponse, E as ExecutionContext, l as ExecutionMetrics, m as AuditEntry, n as StaleEntryInfo, o as PriorityContext, p as MemoryIndex, q as TaskStatusForMemory, r as WorkingMemoryAccess, s as TokenUsage, t as StreamEventType, u as TextGenerateOptions, v as ModelCapabilities, w as MessageRole } from './index-BmOYeqU7.js';
-export { aD as AfterToolContext, av as AgentEventName, ay as AgenticLoopEventName, ax as AgenticLoopEvents, aG as ApprovalResult, aE as ApproveToolContext, aC as BeforeToolContext, a8 as BuiltInTool, a3 as CompactionItem, Y as ContentType, D as DEFAULT_MEMORY_CONFIG, am as ErrorEvent, aw as ExecutionConfig, aA as Hook, au as HookManager, az as HookName, _ as InputImageContent, Z as InputTextContent, ak as IterationCompleteEvent, aa as JSONSchema, X as MEMORY_PRIORITY_VALUES, x as MemoryEntryInput, y as MemoryIndexEntry, a2 as Message, aB as ModifyingHook, $ as OutputTextContent, ad as OutputTextDeltaEvent, ae as OutputTextDoneEvent, a4 as ReasoningItem, al as ResponseCompleteEvent, ab as ResponseCreatedEvent, ac as ResponseInProgressEvent, B as SimpleScope, z as TaskAwareScope, ag as ToolCallArgumentsDeltaEvent, ah as ToolCallArgumentsDoneEvent, af as ToolCallStartEvent, a5 as ToolCallState, a9 as ToolExecutionContext, aj as ToolExecutionDoneEvent, ai as ToolExecutionStartEvent, aF as ToolModification, a1 as ToolResultContent, a0 as ToolUseContent, V as calculateEntrySize, a6 as defaultDescribeCall, J as forPlan, G as forTasks, a7 as getToolCallDescription, at as isErrorEvent, ao as isOutputTextDelta, as as isResponseComplete, Q as isSimpleScope, an as isStreamEvent, R as isTaskAwareScope, U as isTerminalMemoryStatus, aq as isToolCallArgumentsDelta, ar as isToolCallArgumentsDone, ap as isToolCallStart, K as scopeEquals, N as scopeMatches } from './index-BmOYeqU7.js';
+import { I as IConnectorRegistry, a as IConnectorAccessPolicy, C as ConnectorAccessContext, b as Connector, A as AudioFormat, c as IBaseModelDescription, V as VendorOptionSchema, d as IImageProvider, e as ConnectorFetchOptions, f as ITokenStorage, S as StoredToken$1, g as ConnectorConfig, h as ConnectorAuth, i as ConnectorConfigResult } from './ImageModel-qNJHPh4q.js';
+export { m as APIKeyConnectorAuth, D as AspectRatio, L as DEFAULT_BASE_DELAY_MS, G as DEFAULT_CONNECTOR_TIMEOUT, M as DEFAULT_MAX_DELAY_MS, H as DEFAULT_MAX_RETRIES, K as DEFAULT_RETRYABLE_STATUSES, n as IImageModelDescription, q as IMAGE_MODELS, r as IMAGE_MODEL_REGISTRY, F as ISourceLinks, y as ImageEditOptions, x as ImageGenerateOptions, j as ImageGeneration, k as ImageGenerationCreateOptions, o as ImageModelCapabilities, p as ImageModelPricing, B as ImageResponse, z as ImageVariationOptions, J as JWTConnectorAuth, O as OAuthConnectorAuth, E as OutputFormat, Q as QualityLevel, l as SimpleGenerateOptions, w as calculateImageCost, u as getActiveImageModels, s as getImageModelInfo, t as getImageModelsByVendor, v as getImageModelsWithFeature } from './ImageModel-qNJHPh4q.js';
+import { T as Tool, a as ToolFunction, b as ToolContext, c as ToolPermissionConfig$1, d as ToolCall, I as InputItem, M as MemoryEntry, e as MemoryScope, W as WorkingMemoryConfig, P as PriorityCalculator, f as MemoryPriority, g as MemoryTier, C as Content, O as OutputItem, h as ToolResult, i as ITextProvider, F as FunctionToolDefinition, L as LLMResponse, S as StreamEvent, H as HookConfig, j as HistoryMode, A as AgentEvents, k as AgentResponse, E as ExecutionContext, l as ExecutionMetrics, m as AuditEntry, n as StaleEntryInfo, o as PriorityContext, p as MemoryIndex, q as TaskStatusForMemory, r as WorkingMemoryAccess, s as TokenUsage, t as StreamEventType, u as TextGenerateOptions, v as ModelCapabilities, w as MessageRole } from './index-CEp1H4fV.js';
+export { aD as AfterToolContext, av as AgentEventName, ay as AgenticLoopEventName, ax as AgenticLoopEvents, aG as ApprovalResult, aE as ApproveToolContext, aC as BeforeToolContext, a8 as BuiltInTool, a3 as CompactionItem, Y as ContentType, D as DEFAULT_MEMORY_CONFIG, am as ErrorEvent, aw as ExecutionConfig, aA as Hook, au as HookManager, az as HookName, _ as InputImageContent, Z as InputTextContent, ak as IterationCompleteEvent, aa as JSONSchema, X as MEMORY_PRIORITY_VALUES, x as MemoryEntryInput, y as MemoryIndexEntry, a2 as Message, aB as ModifyingHook, $ as OutputTextContent, ad as OutputTextDeltaEvent, ae as OutputTextDoneEvent, a4 as ReasoningItem, al as ResponseCompleteEvent, ab as ResponseCreatedEvent, ac as ResponseInProgressEvent, B as SimpleScope, z as TaskAwareScope, ag as ToolCallArgumentsDeltaEvent, ah as ToolCallArgumentsDoneEvent, af as ToolCallStartEvent, a5 as ToolCallState, a9 as ToolExecutionContext, aj as ToolExecutionDoneEvent, ai as ToolExecutionStartEvent, aF as ToolModification, a1 as ToolResultContent, a0 as ToolUseContent, V as calculateEntrySize, a6 as defaultDescribeCall, J as forPlan, G as forTasks, a7 as getToolCallDescription, at as isErrorEvent, ao as isOutputTextDelta, as as isResponseComplete, Q as isSimpleScope, an as isStreamEvent, R as isTaskAwareScope, U as isTerminalMemoryStatus, aq as isToolCallArgumentsDelta, ar as isToolCallArgumentsDone, ap as isToolCallStart, K as scopeEquals, N as scopeMatches } from './index-CEp1H4fV.js';
 import { EventEmitter } from 'eventemitter3';
+import { V as Vendor } from './Vendor-DYh_bzwo.js';
+export { a as VENDORS, i as isVendor } from './Vendor-DYh_bzwo.js';
 import { I as IProvider, P as ProviderCapabilities } from './IProvider-BP49c93d.js';
+import { ServiceCategory } from './shared/index.js';
+export { ILLMDescription, LLM_MODELS, MODEL_REGISTRY, SERVICE_DEFINITIONS, SERVICE_INFO, SERVICE_URL_PATTERNS, ServiceDefinition, ServiceInfo, ServiceType, Services, calculateCost, detectServiceFromURL, getActiveModels, getAllServiceIds, getModelInfo, getModelsByVendor, getServiceDefinition, getServiceInfo, getServicesByCategory, isKnownService } from './shared/index.js';
 
 /**
  * ScopedConnectorRegistry - Filtered view over the Connector registry
@@ -504,6 +508,18 @@ interface SerializedToolState {
     permissions?: Record<string, ToolPermissionConfig$1>;
 }
 type ToolManagerEvent = 'tool:registered' | 'tool:unregistered' | 'tool:enabled' | 'tool:disabled' | 'tool:executed' | 'namespace:enabled' | 'namespace:disabled';
+/**
+ * Configuration for ToolManager
+ */
+interface ToolManagerConfig {
+    /**
+     * Hard timeout in milliseconds for any single tool execution.
+     * Acts as a safety net: if a tool's own timeout mechanism fails
+     * (e.g. child process doesn't exit), this will force-resolve with an error.
+     * Default: 0 (disabled - relies on tool's own timeout)
+     */
+    toolExecutionTimeout?: number;
+}
 declare class ToolManager extends EventEmitter implements IToolExecutor, IDisposable {
     private registry;
     private namespaceIndex;
@@ -513,7 +529,15 @@ declare class ToolManager extends EventEmitter implements IToolExecutor, IDispos
     private pipeline;
     /** Optional tool context for execution (set by agent before runs) */
     private _toolContext;
-    constructor();
+    /** Hard timeout for tool execution (0 = disabled) */
+    private _toolExecutionTimeout;
+    constructor(config?: ToolManagerConfig);
+    /**
+     * Get or set the hard tool execution timeout in milliseconds.
+     * 0 = disabled (relies on tool's own timeout).
+     */
+    get toolExecutionTimeout(): number;
+    set toolExecutionTimeout(value: number);
     /**
      * Access the execution pipeline for plugin management.
      *
@@ -720,6 +744,11 @@ declare class ToolManager extends EventEmitter implements IToolExecutor, IDispos
      * List all registered tool names (IToolExecutor interface - delegates to list())
      */
     listTools(): string[];
+    /**
+     * Wrap a promise with a hard timeout safety net.
+     * If the promise doesn't resolve within the timeout, throws ToolExecutionError.
+     */
+    private withHardTimeout;
     /**
      * Get or create circuit breaker for a tool
      */
@@ -1505,7 +1534,7 @@ interface ITokenEstimator$1 {
  * Use a consistent prefix based on plugin name:
  * - `working_memory` plugin → `memory_store`, `memory_retrieve`, `memory_delete`, `memory_list`
  * - `in_context_memory` plugin → `context_set`, `context_delete`, `context_list`
- * - `persistent_instructions` plugin → `instructions_set`, `instructions_get`, etc.
+ * - `persistent_instructions` plugin → `instructions_set`, `instructions_remove`, `instructions_list`, `instructions_clear`
  *
  * ## State Serialization
  *
@@ -1890,6 +1919,13 @@ interface AgentContextNextGenConfig {
     storage?: IContextStorage;
     /** Plugin-specific configurations (used with features flags) */
     plugins?: PluginConfigs;
+    /**
+     * Hard timeout in milliseconds for any single tool execution.
+     * Acts as a safety net: if a tool's own timeout mechanism fails
+     * (e.g. a child process doesn't exit), this will force-resolve with an error.
+     * Default: 0 (disabled - relies on each tool's own timeout)
+     */
+    toolExecutionTimeout?: number;
 }
 /**
  * Default configuration values
@@ -2753,6 +2789,13 @@ interface BaseAgentConfig {
     permissions?: AgentPermissionsConfig;
     /** Lifecycle hooks for customization */
     lifecycleHooks?: AgentLifecycleHooks;
+    /**
+     * Hard timeout in milliseconds for any single tool execution.
+     * Acts as a safety net at the ToolManager level: if a tool's own timeout
+     * mechanism fails, this will force-reject with an error.
+     * Default: 0 (disabled - relies on each tool's own timeout).
+     */
+    toolExecutionTimeout?: number;
     /**
      * Optional AgentContextNextGen configuration.
      * If provided as AgentContextNextGen instance, it will be used directly.
@@ -3239,8 +3282,16 @@ interface AgentConfig$1 extends BaseAgentConfig {
      */
     context?: AgentContextNextGen | AgentContextNextGenConfig;
     /**
-     * @deprecated Tool timeouts are now handled by ToolManager per-tool.
-     * Configure timeouts in individual tool definitions instead.
+     * Hard timeout in milliseconds for any single tool execution.
+     * Acts as a safety net: if a tool's own timeout mechanism fails
+     * (e.g. a spawned child process doesn't exit), this will force-resolve
+     * with an error. Default: 0 (disabled - relies on each tool's own timeout).
+     *
+     * Example: `toolExecutionTimeout: 300000` (5 minutes hard cap per tool call)
+     */
+    toolExecutionTimeout?: number;
+    /**
+     * @deprecated Use `toolExecutionTimeout` instead.
      */
     toolTimeout?: number;
     hooks?: HookConfig;
@@ -3904,6 +3955,19 @@ declare class InContextMemoryPluginNextGen implements IContextPluginNextGen {
  * Abstracted storage interface following Clean Architecture principles.
  * Implementations can use file system, database, or any other storage backend.
  */
+/**
+ * A single instruction entry, independently addressable by key.
+ */
+interface InstructionEntry {
+    /** User-supplied key (e.g., "style", "code_rules") */
+    id: string;
+    /** Instruction text (markdown) */
+    content: string;
+    /** Timestamp when entry was first created */
+    createdAt: number;
+    /** Timestamp when entry was last updated */
+    updatedAt: number;
+}
 /**
  * Storage interface for persistent agent instructions
  *
@@ -3912,17 +3976,17 @@ declare class InContextMemoryPluginNextGen implements IContextPluginNextGen {
  */
 interface IPersistentInstructionsStorage {
     /**
-     * Load instructions from storage
+     * Load instruction entries from storage
      *
-     * @returns The stored instructions content, or null if none exist
+     * @returns The stored instruction entries, or null if none exist
      */
-    load(): Promise<string | null>;
+    load(): Promise<InstructionEntry[] | null>;
     /**
-     * Save instructions to storage
+     * Save instruction entries to storage
      *
-     * @param content - The instructions content to save
+     * @param entries - The instruction entries to save
      */
-    save(content: string): Promise<void>;
+    save(entries: InstructionEntry[]): Promise<void>;
     /**
      * Delete instructions from storage
      */
@@ -3942,9 +4006,9 @@ interface IPersistentInstructionsStorage {
 }
 
 /**
- * PersistentInstructionsPluginNextGen - Disk-persisted instructions for NextGen context
+ * PersistentInstructionsPluginNextGen - Disk-persisted KVP instructions for NextGen context
  *
- * Stores custom instructions that persist across sessions on disk.
+ * Stores custom instructions as individually keyed entries that persist across sessions on disk.
  * These are NEVER compacted - always included in context.
  *
  * Use cases:
@@ -3953,7 +4017,7 @@ interface IPersistentInstructionsStorage {
  * - Accumulated knowledge/rules
  * - Custom tool usage guidelines
  *
- * Storage: ~/.oneringai/agents/<agentId>/custom_instructions.md
+ * Storage: ~/.oneringai/agents/<agentId>/custom_instructions.json
  */
 
 interface PersistentInstructionsConfig {
@@ -3961,20 +4025,24 @@ interface PersistentInstructionsConfig {
     agentId: string;
     /** Custom storage implementation (default: FilePersistentInstructionsStorage) */
     storage?: IPersistentInstructionsStorage;
-    /** Maximum instructions length in characters (default: 50000) */
-    maxLength?: number;
+    /** Maximum total content length across all entries in characters (default: 50000) */
+    maxTotalLength?: number;
+    /** Maximum number of entries (default: 50) */
+    maxEntries?: number;
 }
 interface SerializedPersistentInstructionsState {
-    content: string | null;
+    entries: InstructionEntry[];
     agentId: string;
+    version: 2;
 }
 declare class PersistentInstructionsPluginNextGen implements IContextPluginNextGen {
     readonly name = "persistent_instructions";
-    private _content;
+    private _entries;
     private _initialized;
     private _destroyed;
     private readonly storage;
-    private readonly maxLength;
+    private readonly maxTotalLength;
+    private readonly maxEntries;
     private readonly agentId;
     private readonly estimator;
     private _tokenCache;
@@ -3982,7 +4050,7 @@ declare class PersistentInstructionsPluginNextGen implements IContextPluginNextG
     constructor(config: PersistentInstructionsConfig);
     getInstructions(): string;
     getContent(): Promise<string | null>;
-    getContents(): string | null;
+    getContents(): Map<string, InstructionEntry>;
     getTokenSize(): number;
     getInstructionsTokenSize(): number;
     isCompactable(): boolean;
@@ -3996,19 +4064,28 @@ declare class PersistentInstructionsPluginNextGen implements IContextPluginNextG
      */
     initialize(): Promise<void>;
     /**
-     * Set entire instructions content (replaces existing)
+     * Add or update an instruction entry by key
      */
-    set(content: string): Promise<boolean>;
+    set(key: string, content: string): Promise<boolean>;
     /**
-     * Append a section to existing instructions
+     * Remove an instruction entry by key
      */
-    append(section: string): Promise<boolean>;
+    remove(key: string): Promise<boolean>;
     /**
-     * Get current content
+     * Get one entry by key, or all entries if no key provided
      */
-    get(): Promise<string | null>;
+    get(key?: string): Promise<InstructionEntry | InstructionEntry[] | null>;
     /**
-     * Clear all instructions
+     * List metadata for all entries
+     */
+    list(): Promise<{
+        key: string;
+        contentLength: number;
+        createdAt: number;
+        updatedAt: number;
+    }[]>;
+    /**
+     * Clear all instruction entries
      */
     clear(): Promise<void>;
     /**
@@ -4017,9 +4094,25 @@ declare class PersistentInstructionsPluginNextGen implements IContextPluginNextG
     get isInitialized(): boolean;
     private ensureInitialized;
     private assertNotDestroyed;
+    /**
+     * Persist current entries to storage
+     */
+    private persistToStorage;
+    /**
+     * Calculate total content length across all entries
+     */
+    private calculateTotalContentLength;
+    /**
+     * Get entries sorted by createdAt (oldest first)
+     */
+    private getSortedEntries;
+    /**
+     * Render all entries as markdown for context injection
+     */
+    private renderContent;
     private createInstructionsSetTool;
-    private createInstructionsAppendTool;
-    private createInstructionsGetTool;
+    private createInstructionsRemoveTool;
+    private createInstructionsListTool;
     private createInstructionsClearTool;
 }
 
@@ -4248,6 +4341,12 @@ declare class StrategyRegistry {
  * It extracts credentials from the connector and instantiates the appropriate SDK.
  */
 
+/**
+ * Get the default API base URL for a vendor.
+ * For OpenAI/Anthropic reads from the installed SDK at runtime.
+ * Returns undefined for Custom or unknown vendors.
+ */
+declare function getVendorDefaultBaseURL(vendor: string): string | undefined;
 /**
  * Create a text provider from a connector
  */
@@ -6389,6 +6488,119 @@ declare class ScrapeProvider {
     static createWithFallback(config: ScrapeProviderFallbackConfig): IScrapeProvider;
 }
 
+/**
+ * IMediaStorage - Storage interface for multimedia outputs (images, video, audio)
+ *
+ * Provides CRUD operations for media files produced by generation tools.
+ * Implementations can use filesystem, S3, GCS, or any other storage backend.
+ *
+ * This follows Clean Architecture - the interface is in domain layer,
+ * implementations are in infrastructure layer.
+ */
+/**
+ * Metadata about media being saved
+ */
+interface MediaStorageMetadata {
+    /** Type of media being saved */
+    type: 'image' | 'video' | 'audio';
+    /** File format (png, mp4, mp3, etc.) */
+    format: string;
+    /** Model used for generation */
+    model: string;
+    /** Vendor that produced the output */
+    vendor: string;
+    /** Index for multi-image results */
+    index?: number;
+    /** Suggested filename (without path) */
+    suggestedFilename?: string;
+    /** User ID — set by tool when userId is known, for per-user storage organization */
+    userId?: string;
+}
+/**
+ * Result of a save operation
+ */
+interface MediaStorageResult {
+    /** Location of the saved file (file path, URL, S3 key - depends on implementation) */
+    location: string;
+    /** MIME type of the saved file */
+    mimeType: string;
+    /** File size in bytes */
+    size: number;
+}
+/**
+ * Entry returned by list()
+ */
+interface MediaStorageEntry {
+    /** Location of the file */
+    location: string;
+    /** MIME type */
+    mimeType: string;
+    /** File size in bytes */
+    size: number;
+    /** Media type (image, video, audio) */
+    type?: 'image' | 'video' | 'audio';
+    /** When the file was created */
+    createdAt: Date;
+}
+/**
+ * Options for listing media files
+ */
+interface MediaStorageListOptions {
+    /** Filter by media type */
+    type?: 'image' | 'video' | 'audio';
+    /** Maximum number of results */
+    limit?: number;
+    /** Offset for pagination */
+    offset?: number;
+}
+/**
+ * Storage interface for multimedia outputs
+ *
+ * Implementations:
+ * - FileMediaStorage: File-based storage (default, uses local filesystem)
+ * - (Custom) S3MediaStorage, GCSMediaStorage, etc.
+ */
+interface IMediaStorage {
+    /**
+     * Save media data to storage
+     *
+     * @param data - Raw media data as Buffer
+     * @param metadata - Information about the media for naming/organization
+     * @returns Location and metadata of the saved file
+     */
+    save(data: Buffer, metadata: MediaStorageMetadata): Promise<MediaStorageResult>;
+    /**
+     * Read media data from storage
+     *
+     * @param location - Location string returned by save() or known file path
+     * @returns The raw media data, or null if not found
+     */
+    read(location: string): Promise<Buffer | null>;
+    /**
+     * Delete media from storage
+     *
+     * @param location - Location string to delete
+     * @throws Does NOT throw if the file doesn't exist
+     */
+    delete(location: string): Promise<void>;
+    /**
+     * Check if media exists in storage
+     *
+     * @param location - Location string to check
+     */
+    exists(location: string): Promise<boolean>;
+    /**
+     * List media files in storage (optional)
+     *
+     * @param options - Filtering and pagination options
+     */
+    list?(options?: MediaStorageListOptions): Promise<MediaStorageEntry[]>;
+    /**
+     * Get the storage path/location (for display/debugging)
+     */
+    getPath(): string;
+}
+
 /**
  * WorkingMemory class - manages indexed working memory for TaskAgent
  *
@@ -8229,15 +8441,16 @@ declare class InMemoryHistoryStorage implements IHistoryStorage {
 /**
  * FilePersistentInstructionsStorage - File-based storage for persistent instructions
  *
- * Stores custom agent instructions as markdown files on disk.
- * Path: ~/.oneringai/agents/<agentId>/custom_instructions.md
- * Windows: %APPDATA%/oneringai/agents/<agentId>/custom_instructions.md
+ * Stores custom agent instructions as a JSON file on disk.
+ * Path: ~/.oneringai/agents/<agentId>/custom_instructions.json
+ * Windows: %APPDATA%/oneringai/agents/<agentId>/custom_instructions.json
  *
  * Features:
  * - Cross-platform path handling
  * - Safe agent ID sanitization
  * - Atomic file operations
  * - Automatic directory creation
+ * - Legacy .md file migration
  */
 
 /**
@@ -8248,7 +8461,7 @@ interface FilePersistentInstructionsStorageConfig {
     agentId: string;
     /** Override the base directory (default: ~/.oneringai/agents) */
     baseDirectory?: string;
-    /** Override the filename (default: custom_instructions.md) */
+    /** Override the filename (default: custom_instructions.json) */
     filename?: string;
 }
 /**
@@ -8257,23 +8470,26 @@ interface FilePersistentInstructionsStorageConfig {
 declare class FilePersistentInstructionsStorage implements IPersistentInstructionsStorage {
     private readonly directory;
     private readonly filePath;
+    private readonly legacyFilePath;
     private readonly agentId;
     constructor(config: FilePersistentInstructionsStorageConfig);
     /**
-     * Load instructions from file
+     * Load instruction entries from file.
+     * Falls back to legacy .md file migration if JSON not found.
      */
-    load(): Promise<string | null>;
+    load(): Promise<InstructionEntry[] | null>;
     /**
-     * Save instructions to file
-     * Creates directory if it doesn't exist
+     * Save instruction entries to file as JSON.
+     * Creates directory if it doesn't exist.
+     * Cleans up legacy .md file if present.
      */
-    save(content: string): Promise<void>;
+    save(entries: InstructionEntry[]): Promise<void>;
     /**
-     * Delete instructions file
+     * Delete instructions file (and legacy .md if exists)
      */
     delete(): Promise<void>;
     /**
-     * Check if instructions file exists
+     * Check if instructions file exists (JSON or legacy .md)
      */
     exists(): Promise<boolean>;
     /**
@@ -8288,6 +8504,10 @@ declare class FilePersistentInstructionsStorage implements IPersistentInstructio
      * Ensure the directory exists
      */
     private ensureDirectory;
+    /**
+     * Remove legacy .md file if it exists
+     */
+    private removeLegacyFile;
 }
 
 /**
@@ -8475,174 +8695,33 @@ declare class FileAgentDefinitionStorage implements IAgentDefinitionStorage {
 declare function createFileAgentDefinitionStorage(config?: FileAgentDefinitionStorageConfig): FileAgentDefinitionStorage;
 
 /**
- * Complete description of an LLM model including capabilities, pricing, and features
+ * FileMediaStorage - File-based media storage implementation
+ *
+ * Saves generated media to a configurable directory on the local filesystem.
+ * Default output directory: `os.tmpdir()/oneringai-media/`
  */
-interface ILLMDescription {
-    /** Model identifier (e.g., "gpt-5.2-instant") */
-    name: string;
-    /** Vendor/provider (Vendor.OpenAI, Vendor.Anthropic, etc.) */
-    provider: string;
-    /** Optional description of the model */
-    description?: string;
-    /** Whether the model is currently available for use */
-    isActive: boolean;
-    /** Release date (YYYY-MM-DD format) */
-    releaseDate?: string;
-    /** Knowledge cutoff date */
-    knowledgeCutoff?: string;
-    /** Model capabilities and pricing */
-    features: {
-        /** Supports extended reasoning/thinking */
-        reasoning?: boolean;
-        /** Supports streaming responses */
-        streaming: boolean;
-        /** Supports structured output (JSON mode) */
-        structuredOutput?: boolean;
-        /** Supports function/tool calling */
-        functionCalling?: boolean;
-        /** Supports fine-tuning */
-        fineTuning?: boolean;
-        /** Supports predicted outputs */
-        predictedOutputs?: boolean;
-        /** Supports realtime API */
-        realtime?: boolean;
-        /** Supports image input (vision) */
-        vision?: boolean;
-        /** Supports audio input/output */
-        audio?: boolean;
-        /** Supports video input */
-        video?: boolean;
-        /** Supports extended thinking (Claude-specific) */
-        extendedThinking?: boolean;
-        /** Supports batch API */
-        batchAPI?: boolean;
-        /** Supports prompt caching */
-        promptCaching?: boolean;
-        /** Parameter support - indicates which sampling parameters are supported */
-        parameters?: {
-            /** Supports temperature parameter */
-            temperature?: boolean;
-            /** Supports top_p parameter */
-            topP?: boolean;
-            /** Supports frequency_penalty parameter */
-            frequencyPenalty?: boolean;
-            /** Supports presence_penalty parameter */
-            presencePenalty?: boolean;
-        };
-        /** Input specifications */
-        input: {
-            /** Maximum input context window (in tokens) */
-            tokens: number;
-            /** Supports text input */
-            text: boolean;
-            /** Supports image input */
-            image?: boolean;
-            /** Supports audio input */
-            audio?: boolean;
-            /** Supports video input */
-            video?: boolean;
-            /** Cost per million tokens (input) */
-            cpm: number;
-            /** Cost per million cached tokens (if prompt caching supported) */
-            cpmCached?: number;
-        };
-        /** Output specifications */
-        output: {
-            /** Maximum output tokens */
-            tokens: number;
-            /** Supports text output */
-            text: boolean;
-            /** Supports image output */
-            image?: boolean;
-            /** Supports audio output */
-            audio?: boolean;
-            /** Cost per million tokens (output) */
-            cpm: number;
-        };
-    };
+
+interface FileMediaStorageConfig {
+    /** Directory to store media files. Defaults to `os.tmpdir()/oneringai-media/` */
+    outputDir?: string;
+}
+declare class FileMediaStorage implements IMediaStorage {
+    private outputDir;
+    private initialized;
+    constructor(config?: FileMediaStorageConfig);
+    save(data: Buffer, metadata: MediaStorageMetadata): Promise<MediaStorageResult>;
+    read(location: string): Promise<Buffer | null>;
+    delete(location: string): Promise<void>;
+    exists(location: string): Promise<boolean>;
+    list(options?: MediaStorageListOptions): Promise<MediaStorageEntry[]>;
+    getPath(): string;
+    private generateFilename;
+    private ensureDir;
 }
 /**
- * Model name constants organized by vendor
- * Updated: January 2026 - Contains only verified, currently available models
- */
-declare const LLM_MODELS: {
-    readonly openai: {
-        readonly GPT_5_2: "gpt-5.2";
-        readonly GPT_5_2_PRO: "gpt-5.2-pro";
-        readonly GPT_5: "gpt-5";
-        readonly GPT_5_MINI: "gpt-5-mini";
-        readonly GPT_5_NANO: "gpt-5-nano";
-        readonly GPT_4_1: "gpt-4.1";
-        readonly GPT_4_1_MINI: "gpt-4.1-mini";
-        readonly GPT_4_1_NANO: "gpt-4.1-nano";
-        readonly GPT_4O: "gpt-4o";
-        readonly GPT_4O_MINI: "gpt-4o-mini";
-        readonly O3_MINI: "o3-mini";
-        readonly O1: "o1";
-    };
-    readonly anthropic: {
-        readonly CLAUDE_OPUS_4_5: "claude-opus-4-5-20251101";
-        readonly CLAUDE_SONNET_4_5: "claude-sonnet-4-5-20250929";
-        readonly CLAUDE_HAIKU_4_5: "claude-haiku-4-5-20251001";
-        readonly CLAUDE_OPUS_4_1: "claude-opus-4-1-20250805";
-        readonly CLAUDE_SONNET_4: "claude-sonnet-4-20250514";
-        readonly CLAUDE_SONNET_3_7: "claude-3-7-sonnet-20250219";
-        readonly CLAUDE_HAIKU_3: "claude-3-haiku-20240307";
-    };
-    readonly google: {
-        readonly GEMINI_3_FLASH_PREVIEW: "gemini-3-flash-preview";
-        readonly GEMINI_3_PRO_PREVIEW: "gemini-3-pro-preview";
-        readonly GEMINI_3_PRO_IMAGE_PREVIEW: "gemini-3-pro-image-preview";
-        readonly GEMINI_2_5_PRO: "gemini-2.5-pro";
-        readonly GEMINI_2_5_FLASH: "gemini-2.5-flash";
-        readonly GEMINI_2_5_FLASH_LITE: "gemini-2.5-flash-lite";
-        readonly GEMINI_2_5_FLASH_IMAGE: "gemini-2.5-flash-image";
-    };
-    readonly grok: {
-        readonly GROK_4_1_FAST_REASONING: "grok-4-1-fast-reasoning";
-        readonly GROK_4_1_FAST_NON_REASONING: "grok-4-1-fast-non-reasoning";
-        readonly GROK_4_FAST_REASONING: "grok-4-fast-reasoning";
-        readonly GROK_4_FAST_NON_REASONING: "grok-4-fast-non-reasoning";
-        readonly GROK_4_0709: "grok-4-0709";
-        readonly GROK_CODE_FAST_1: "grok-code-fast-1";
-        readonly GROK_3: "grok-3";
-        readonly GROK_3_MINI: "grok-3-mini";
-        readonly GROK_2_VISION_1212: "grok-2-vision-1212";
-    };
-};
-/**
- * Complete model registry with all model metadata
- * Updated: January 2026 - Verified from official vendor documentation
- */
-declare const MODEL_REGISTRY: Record<string, ILLMDescription>;
-/**
- * Get model information by name
- * @param modelName The model identifier
- * @returns Model description or undefined if not found
- */
-declare function getModelInfo(modelName: string): ILLMDescription | undefined;
-/**
- * Get all models for a specific vendor
- * @param vendor The vendor to filter by
- * @returns Array of model descriptions for the vendor
- */
-declare function getModelsByVendor(vendor: Vendor): ILLMDescription[];
-/**
- * Get all currently active models
- * @returns Array of active model descriptions
- */
-declare function getActiveModels(): ILLMDescription[];
-/**
- * Calculate the cost for a given model and token usage
- * @param model Model name
- * @param inputTokens Number of input tokens
- * @param outputTokens Number of output tokens
- * @param options Optional calculation options
- * @returns Total cost in dollars, or null if model not found
+ * Factory function for creating FileMediaStorage instances
  */
-declare function calculateCost(model: string, inputTokens: number, outputTokens: number, options?: {
-    useCachedInput?: boolean;
-}): number | null;
+declare function createFileMediaStorage(config?: FileMediaStorageConfig): FileMediaStorage;
 
 /**
  * Video Model Registry
@@ -9311,98 +9390,6 @@ declare class ProviderErrorMapper {
     private static extractRetryAfter;
 }
 
-/**
- * Services - Single source of truth for external service definitions
- *
- * All service metadata is defined in one place (SERVICE_DEFINITIONS).
- * Other exports are derived from this to maintain DRY principles.
- */
-/**
- * Service category type
- */
-type ServiceCategory = 'major-vendors' | 'communication' | 'development' | 'productivity' | 'crm' | 'payments' | 'cloud' | 'storage' | 'email' | 'monitoring' | 'search' | 'scrape' | 'other';
-/**
- * Complete service definition - single source of truth
- */
-interface ServiceDefinition {
-    /** Unique identifier (e.g., 'slack', 'github') */
-    id: string;
-    /** Human-readable name (e.g., 'Slack', 'GitHub') */
-    name: string;
-    /** Service category */
-    category: ServiceCategory;
-    /** URL pattern for auto-detection from baseURL */
-    urlPattern: RegExp;
-    /** Default base URL for API calls */
-    baseURL: string;
-    /** Documentation URL */
-    docsURL?: string;
-    /** Common OAuth scopes */
-    commonScopes?: string[];
-}
-/**
- * Master list of all service definitions
- * This is the SINGLE SOURCE OF TRUTH - all other exports derive from this
- */
-declare const SERVICE_DEFINITIONS: readonly ServiceDefinition[];
-/**
- * Service type - union of all service IDs
- */
-type ServiceType = (typeof SERVICE_DEFINITIONS)[number]['id'];
-/**
- * Services constant object for easy access
- * Usage: Services.Slack, Services.GitHub, etc.
- */
-declare const Services: { [K in string]: ServiceType; };
-/**
- * URL patterns for auto-detection (derived from SERVICE_DEFINITIONS)
- */
-declare const SERVICE_URL_PATTERNS: ReadonlyArray<{
-    service: string;
-    pattern: RegExp;
-}>;
-/**
- * Service info lookup (derived from SERVICE_DEFINITIONS)
- */
-interface ServiceInfo {
-    id: string;
-    name: string;
-    category: ServiceCategory;
-    baseURL: string;
-    docsURL?: string;
-    commonScopes?: string[];
-}
-/**
- * Service info map (derived from SERVICE_DEFINITIONS)
- */
-declare const SERVICE_INFO: Record<string, ServiceInfo>;
-/**
- * Detect service type from a URL
- * @param url - Base URL or full URL to check
- * @returns Service type string or undefined if not recognized
- */
-declare function detectServiceFromURL(url: string): string | undefined;
-/**
- * Get service info by service type
- */
-declare function getServiceInfo(serviceType: string): ServiceInfo | undefined;
-/**
- * Get service definition by service type
- */
-declare function getServiceDefinition(serviceType: string): ServiceDefinition | undefined;
-/**
- * Get all services in a category
- */
-declare function getServicesByCategory(category: ServiceCategory): ServiceDefinition[];
-/**
- * Get all service IDs
- */
-declare function getAllServiceIds(): string[];
-/**
- * Check if a service ID is known
- */
-declare function isKnownService(serviceId: string): boolean;
-
 /**
  * ConnectorTools - Generate tools from Connectors
  *
@@ -10040,6 +10027,14 @@ declare class ConnectorConfigStore {
      * Decrypt secrets in ConnectorAuth based on auth type
      */
     private decryptAuthSecrets;
+    /**
+     * Encrypt all values in an extra Record (vendor-specific credentials)
+     */
+    private encryptExtra;
+    /**
+     * Decrypt all values in an extra Record (vendor-specific credentials)
+     */
+    private decryptExtra;
     /**
      * Encrypt a single value if not already encrypted
      */
@@ -10172,7 +10167,7 @@ interface AuthTemplate {
 /**
  * Known fields that can be required/optional in auth templates
  */
-type AuthTemplateField = 'apiKey' | 'clientId' | 'clientSecret' | 'redirectUri' | 'scope' | 'privateKey' | 'privateKeyPath' | 'appId' | 'installationId' | 'tenantId' | 'username' | 'subject' | 'audience' | 'userScope' | 'accountId' | 'subdomain' | 'region' | 'accessKeyId' | 'secretAccessKey' | 'applicationKey';
+type AuthTemplateField = 'apiKey' | 'clientId' | 'clientSecret' | 'redirectUri' | 'scope' | 'privateKey' | 'privateKeyPath' | 'appId' | 'installationId' | 'tenantId' | 'username' | 'subject' | 'audience' | 'userScope' | 'accountId' | 'subdomain' | 'region' | 'accessKeyId' | 'secretAccessKey' | 'applicationKey' | 'appToken' | 'signingSecret';
 /**
  * Vendor template definition
  * Complete configuration for a vendor's supported authentication methods
@@ -11574,84 +11569,34 @@ declare function createExecuteJavaScriptTool(): ToolFunction<ExecuteJSArgs, Exec
 declare const executeJavaScript: ToolFunction<ExecuteJSArgs, ExecuteJSResult>;
 
 /**
- * Interface for handling multimedia output storage
+ * Module-level configuration for multimedia output storage
  *
- * Allows library consumers to plug in custom storage backends (S3, GCS, etc.)
- * Default implementation: FileMediaOutputHandler (local filesystem)
- */
-interface MediaOutputMetadata {
-    /** Type of media being saved */
-    type: 'image' | 'video' | 'audio';
-    /** File format (png, mp4, mp3, etc.) */
-    format: string;
-    /** Model used for generation */
-    model: string;
-    /** Vendor that produced the output */
-    vendor: string;
-    /** Index for multi-image results */
-    index?: number;
-    /** Suggested filename (without path) */
-    suggestedFilename?: string;
-}
-interface MediaOutputResult {
-    /** Location of the saved file (file path, URL, S3 key - depends on handler) */
-    location: string;
-    /** MIME type of the saved file */
-    mimeType: string;
-    /** File size in bytes */
-    size: number;
-}
-interface IMediaOutputHandler {
-    /**
-     * Save media data to storage
-     *
-     * @param data - Raw media data as Buffer
-     * @param metadata - Information about the media for naming/organization
-     * @returns Location and metadata of the saved file
-     */
-    save(data: Buffer, metadata: MediaOutputMetadata): Promise<MediaOutputResult>;
-}
-
-/**
- * Default filesystem-based media output handler
- *
- * Saves generated media to a configurable directory on the local filesystem.
- * Default output directory: `os.tmpdir()/oneringai-media/`
- */
-
-declare class FileMediaOutputHandler implements IMediaOutputHandler {
-    private outputDir;
-    private initialized;
-    constructor(outputDir?: string);
-    save(data: Buffer, metadata: MediaOutputMetadata): Promise<MediaOutputResult>;
-    private generateFilename;
-}
-
-/**
- * Module-level configuration for multimedia output handling
- *
- * Provides a global default output handler used by all tool factories
+ * Provides a global default media storage used by all tool factories
  * when called through ConnectorTools.registerService().
  *
  * @example
  * ```typescript
- * import { setMediaOutputHandler } from '@everworker/oneringai';
+ * import { setMediaStorage } from '@everworker/oneringai';
  *
- * // Use custom S3 handler before creating agents
- * setMediaOutputHandler(myS3Handler);
+ * // Use custom S3 storage before creating agents
+ * setMediaStorage(myS3Storage);
  * ```
  */
 
 /**
- * Get the global media output handler (creates default FileMediaOutputHandler on first access)
+ * Get the global media storage (creates default FileMediaStorage on first access)
  */
-declare function getMediaOutputHandler(): IMediaOutputHandler;
+declare function getMediaStorage(): IMediaStorage;
 /**
- * Set a custom global media output handler
+ * Set a custom global media storage
  *
  * Call this before agent creation to use custom storage (S3, GCS, etc.)
  */
-declare function setMediaOutputHandler(handler: IMediaOutputHandler): void;
+declare function setMediaStorage(storage: IMediaStorage): void;
+/** @deprecated Use `getMediaStorage()` instead */
+declare const getMediaOutputHandler: typeof getMediaStorage;
+/** @deprecated Use `setMediaStorage()` instead */
+declare const setMediaOutputHandler: typeof setMediaStorage;
 
 /**
  * Image generation tool factory
@@ -11678,7 +11623,7 @@ interface GenerateImageResult {
     }>;
     error?: string;
 }
-declare function createImageGenerationTool(connector: Connector, outputHandler?: IMediaOutputHandler): ToolFunction<GenerateImageArgs, GenerateImageResult>;
+declare function createImageGenerationTool(connector: Connector, storage?: IMediaStorage, userId?: string): ToolFunction<GenerateImageArgs, GenerateImageResult>;
 
 /**
  * Video generation tool factories
@@ -11688,7 +11633,7 @@ declare function createImageGenerationTool(connector: Connector, outputHandler?:
  * so two tools are needed: one to start and one to check status/download.
  */
 
-declare function createVideoTools(connector: Connector, outputHandler?: IMediaOutputHandler): ToolFunction[];
+declare function createVideoTools(connector: Connector, storage?: IMediaStorage, userId?: string): ToolFunction[];
 
 /**
  * Text-to-speech tool factory
@@ -11711,7 +11656,7 @@ interface TextToSpeechResult {
     mimeType?: string;
     error?: string;
 }
-declare function createTextToSpeechTool(connector: Connector, outputHandler?: IMediaOutputHandler): ToolFunction<TextToSpeechArgs, TextToSpeechResult>;
+declare function createTextToSpeechTool(connector: Connector, storage?: IMediaStorage, userId?: string): ToolFunction<TextToSpeechArgs, TextToSpeechResult>;
 
 /**
  * Speech-to-text tool factory
@@ -11721,7 +11666,7 @@ declare function createTextToSpeechTool(connector: Connector, outputHandler?: IM
  */
 
 interface SpeechToTextArgs {
-    audioFilePath: string;
+    audioSource: string;
     model?: string;
     language?: string;
     prompt?: string;
@@ -11733,13 +11678,348 @@ interface SpeechToTextResult {
     durationSeconds?: number;
     error?: string;
 }
-declare function createSpeechToTextTool(connector: Connector): ToolFunction<SpeechToTextArgs, SpeechToTextResult>;
+declare function createSpeechToTextTool(connector: Connector, storage?: IMediaStorage, _userId?: string): ToolFunction<SpeechToTextArgs, SpeechToTextResult>;
+
+/**
+ * GitHub Tools - Shared Types and Helpers
+ *
+ * Foundation for all GitHub connector tools.
+ * Provides repository resolution, authenticated fetch, and result types.
+ */
+
+/**
+ * Parsed GitHub repository reference
+ */
+interface GitHubRepository {
+    owner: string;
+    repo: string;
+}
+/**
+ * Parse a repository string into owner and repo.
+ *
+ * Accepts:
+ * - "owner/repo" format
+ * - Full GitHub URLs: "https://github.com/owner/repo", "https://github.com/owner/repo/..."
+ *
+ * @throws Error if the format is not recognized
+ */
+declare function parseRepository(input: string): GitHubRepository;
+/**
+ * Resolve a repository from tool args or connector default.
+ *
+ * Priority:
+ * 1. Explicit `repository` parameter
+ * 2. `connector.getOptions().defaultRepository`
+ *
+ * @returns GitHubRepository or an error result
+ */
+declare function resolveRepository(repository: string | undefined, connector: Connector): {
+    success: true;
+    repo: GitHubRepository;
+} | {
+    success: false;
+    error: string;
+};
+/**
+ * Result from search_files tool
+ */
+interface GitHubSearchFilesResult {
+    success: boolean;
+    files?: {
+        path: string;
+        size: number;
+        type: string;
+    }[];
+    count?: number;
+    truncated?: boolean;
+    error?: string;
+}
+/**
+ * Result from search_code tool
+ */
+interface GitHubSearchCodeResult {
+    success: boolean;
+    matches?: {
+        file: string;
+        fragment?: string;
+    }[];
+    count?: number;
+    truncated?: boolean;
+    error?: string;
+}
+/**
+ * Result from read_file tool (GitHub variant)
+ */
+interface GitHubReadFileResult {
+    success: boolean;
+    content?: string;
+    path?: string;
+    size?: number;
+    lines?: number;
+    truncated?: boolean;
+    sha?: string;
+    error?: string;
+}
+/**
+ * Result from get_pr tool
+ */
+interface GitHubGetPRResult {
+    success: boolean;
+    data?: {
+        number: number;
+        title: string;
+        body: string | null;
+        state: string;
+        author: string;
+        labels: string[];
+        reviewers: string[];
+        mergeable: boolean | null;
+        head: string;
+        base: string;
+        url: string;
+        created_at: string;
+        updated_at: string;
+        additions: number;
+        deletions: number;
+        changed_files: number;
+        draft: boolean;
+    };
+    error?: string;
+}
+/**
+ * Result from pr_files tool
+ */
+interface GitHubPRFilesResult {
+    success: boolean;
+    files?: {
+        filename: string;
+        status: string;
+        additions: number;
+        deletions: number;
+        changes: number;
+        patch?: string;
+    }[];
+    count?: number;
+    error?: string;
+}
+/**
+ * A unified comment/review entry
+ */
+interface GitHubPRCommentEntry {
+    id: number;
+    type: 'review' | 'comment' | 'review_comment';
+    author: string;
+    body: string;
+    created_at: string;
+    path?: string;
+    line?: number;
+    state?: string;
+}
+/**
+ * Result from pr_comments tool
+ */
+interface GitHubPRCommentsResult {
+    success: boolean;
+    comments?: GitHubPRCommentEntry[];
+    count?: number;
+    error?: string;
+}
+/**
+ * Result from create_pr tool
+ */
+interface GitHubCreatePRResult {
+    success: boolean;
+    data?: {
+        number: number;
+        url: string;
+        state: string;
+        title: string;
+    };
+    error?: string;
+}
+
+/**
+ * GitHub Search Files Tool
+ *
+ * Search for files by glob pattern in a GitHub repository.
+ * Mirrors the local `glob` tool for remote GitHub repos.
+ *
+ * Uses the Git Trees API to fetch the full file tree, then filters client-side.
+ */
+
+/**
+ * Arguments for the search_files tool
+ */
+interface SearchFilesArgs {
+    /** Repository in "owner/repo" format or full GitHub URL */
+    repository?: string;
+    /** Glob pattern to match files (e.g., "**\/*.ts", "src/**\/*.tsx") */
+    pattern: string;
+    /** Branch, tag, or SHA (defaults to repo's default branch) */
+    ref?: string;
+}
+/**
+ * Create a GitHub search_files tool
+ */
+declare function createSearchFilesTool(connector: Connector, userId?: string): ToolFunction<SearchFilesArgs, GitHubSearchFilesResult>;
+
+/**
+ * GitHub Search Code Tool
+ *
+ * Search for code content across a GitHub repository.
+ * Mirrors the local `grep` tool for remote GitHub repos.
+ *
+ * Uses the GitHub Code Search API with text-match support.
+ *
+ * Note: GitHub's code search API has a rate limit of 30 requests/minute.
+ */
+
+/**
+ * Arguments for the search_code tool
+ */
+interface SearchCodeArgs {
+    /** Repository in "owner/repo" format or full GitHub URL */
+    repository?: string;
+    /** Search query (keyword or phrase) */
+    query: string;
+    /** Filter by programming language (e.g., "typescript", "python") */
+    language?: string;
+    /** Filter by file path (e.g., "src/", "lib/utils") */
+    path?: string;
+    /** Filter by file extension (e.g., "ts", "py") */
+    extension?: string;
+    /** Maximum number of results (default: 30, max: 100) */
+    limit?: number;
+}
+/**
+ * Create a GitHub search_code tool
+ */
+declare function createSearchCodeTool(connector: Connector, userId?: string): ToolFunction<SearchCodeArgs, GitHubSearchCodeResult>;
+
+/**
+ * GitHub Read File Tool
+ *
+ * Read file content from a GitHub repository.
+ * Mirrors the local `read_file` tool for remote GitHub repos.
+ *
+ * Supports line range selection (offset/limit) and formats output
+ * with line numbers matching the local read_file tool.
+ */
+
+/**
+ * Arguments for the GitHub read_file tool
+ */
+interface GitHubReadFileArgs {
+    /** Repository in "owner/repo" format or full GitHub URL */
+    repository?: string;
+    /** File path within the repository (e.g., "src/index.ts") */
+    path: string;
+    /** Branch, tag, or commit SHA. Defaults to the repository's default branch. */
+    ref?: string;
+    /** Line number to start reading from (1-indexed). Useful for large files. */
+    offset?: number;
+    /** Number of lines to read (default: 2000). */
+    limit?: number;
+}
+/**
+ * Create a GitHub read_file tool
+ */
+declare function createGitHubReadFileTool(connector: Connector, userId?: string): ToolFunction<GitHubReadFileArgs, GitHubReadFileResult>;
+
+/**
+ * GitHub Get PR Tool
+ *
+ * Get full details of a pull request from a GitHub repository.
+ */
+
+/**
+ * Arguments for the get_pr tool
+ */
+interface GetPRArgs {
+    /** Repository in "owner/repo" format or full GitHub URL */
+    repository?: string;
+    /** Pull request number */
+    pull_number: number;
+}
+/**
+ * Create a GitHub get_pr tool
+ */
+declare function createGetPRTool(connector: Connector, userId?: string): ToolFunction<GetPRArgs, GitHubGetPRResult>;
+
+/**
+ * GitHub PR Files Tool
+ *
+ * Get the files changed in a pull request, including diffs.
+ */
+
+/**
+ * Arguments for the pr_files tool
+ */
+interface PRFilesArgs {
+    /** Repository in "owner/repo" format or full GitHub URL */
+    repository?: string;
+    /** Pull request number */
+    pull_number: number;
+}
+/**
+ * Create a GitHub pr_files tool
+ */
+declare function createPRFilesTool(connector: Connector, userId?: string): ToolFunction<PRFilesArgs, GitHubPRFilesResult>;
+
+/**
+ * GitHub PR Comments Tool
+ *
+ * Get all comments and reviews on a pull request.
+ * Merges three types: review comments (line-level), reviews, and issue comments.
+ */
+
+/**
+ * Arguments for the pr_comments tool
+ */
+interface PRCommentsArgs {
+    /** Repository in "owner/repo" format or full GitHub URL */
+    repository?: string;
+    /** Pull request number */
+    pull_number: number;
+}
+/**
+ * Create a GitHub pr_comments tool
+ */
+declare function createPRCommentsTool(connector: Connector, userId?: string): ToolFunction<PRCommentsArgs, GitHubPRCommentsResult>;
+
+/**
+ * GitHub Create PR Tool
+ *
+ * Create a pull request on a GitHub repository.
+ */
+
+/**
+ * Arguments for the create_pr tool
+ */
+interface CreatePRArgs {
+    /** Repository in "owner/repo" format or full GitHub URL */
+    repository?: string;
+    /** Pull request title */
+    title: string;
+    /** Pull request description/body (Markdown supported) */
+    body?: string;
+    /** Source branch name (the branch with your changes) */
+    head: string;
+    /** Target branch name (the branch you want to merge into) */
+    base: string;
+    /** Create as a draft pull request */
+    draft?: boolean;
+}
+/**
+ * Create a GitHub create_pr tool
+ */
+declare function createCreatePRTool(connector: Connector, userId?: string): ToolFunction<CreatePRArgs, GitHubCreatePRResult>;
 
 /**
  * AUTO-GENERATED FILE - DO NOT EDIT MANUALLY
  *
  * Generated by: scripts/generate-tool-registry.ts
- * Generated at: 2026-02-06T21:41:15.460Z
+ * Generated at: 2026-02-08T21:31:53.497Z
  *
  * To regenerate: npm run generate:tools
  */
@@ -11920,18 +12200,22 @@ declare const index_ConnectorTools: typeof ConnectorTools;
 declare const index_DEFAULT_FILESYSTEM_CONFIG: typeof DEFAULT_FILESYSTEM_CONFIG;
 declare const index_DEFAULT_SHELL_CONFIG: typeof DEFAULT_SHELL_CONFIG;
 type index_EditFileResult = EditFileResult;
-type index_FileMediaOutputHandler = FileMediaOutputHandler;
-declare const index_FileMediaOutputHandler: typeof FileMediaOutputHandler;
 type index_FilesystemToolConfig = FilesystemToolConfig;
 type index_GenericAPICallArgs = GenericAPICallArgs;
 type index_GenericAPICallResult = GenericAPICallResult;
 type index_GenericAPIToolOptions = GenericAPIToolOptions;
+type index_GitHubCreatePRResult = GitHubCreatePRResult;
+type index_GitHubGetPRResult = GitHubGetPRResult;
+type index_GitHubPRCommentEntry = GitHubPRCommentEntry;
+type index_GitHubPRCommentsResult = GitHubPRCommentsResult;
+type index_GitHubPRFilesResult = GitHubPRFilesResult;
+type index_GitHubReadFileResult = GitHubReadFileResult;
+type index_GitHubRepository = GitHubRepository;
+type index_GitHubSearchCodeResult = GitHubSearchCodeResult;
+type index_GitHubSearchFilesResult = GitHubSearchFilesResult;
 type index_GlobResult = GlobResult;
 type index_GrepMatch = GrepMatch;
 type index_GrepResult = GrepResult;
-type index_IMediaOutputHandler = IMediaOutputHandler;
-type index_MediaOutputMetadata = MediaOutputMetadata;
-type index_MediaOutputResult = MediaOutputResult;
 type index_ReadFileResult = ReadFileResult;
 type index_SearchResult = SearchResult;
 type index_ServiceToolFactory = ServiceToolFactory;
@@ -11943,13 +12227,20 @@ type index_ToolRegistryEntry = ToolRegistryEntry;
 type index_WriteFileResult = WriteFileResult;
 declare const index_bash: typeof bash;
 declare const index_createBashTool: typeof createBashTool;
+declare const index_createCreatePRTool: typeof createCreatePRTool;
 declare const index_createEditFileTool: typeof createEditFileTool;
 declare const index_createExecuteJavaScriptTool: typeof createExecuteJavaScriptTool;
+declare const index_createGetPRTool: typeof createGetPRTool;
+declare const index_createGitHubReadFileTool: typeof createGitHubReadFileTool;
 declare const index_createGlobTool: typeof createGlobTool;
 declare const index_createGrepTool: typeof createGrepTool;
 declare const index_createImageGenerationTool: typeof createImageGenerationTool;
 declare const index_createListDirectoryTool: typeof createListDirectoryTool;
+declare const index_createPRCommentsTool: typeof createPRCommentsTool;
+declare const index_createPRFilesTool: typeof createPRFilesTool;
 declare const index_createReadFileTool: typeof createReadFileTool;
+declare const index_createSearchCodeTool: typeof createSearchCodeTool;
+declare const index_createSearchFilesTool: typeof createSearchFilesTool;
 declare const index_createSpeechToTextTool: typeof createSpeechToTextTool;
 declare const index_createTextToSpeechTool: typeof createTextToSpeechTool;
 declare const index_createVideoTools: typeof createVideoTools;
@@ -11961,6 +12252,7 @@ declare const index_expandTilde: typeof expandTilde;
 declare const index_getAllBuiltInTools: typeof getAllBuiltInTools;
 declare const index_getBackgroundOutput: typeof getBackgroundOutput;
 declare const index_getMediaOutputHandler: typeof getMediaOutputHandler;
+declare const index_getMediaStorage: typeof getMediaStorage;
 declare const index_getToolByName: typeof getToolByName;
 declare const index_getToolCategories: typeof getToolCategories;
 declare const index_getToolRegistry: typeof getToolRegistry;
@@ -11973,8 +12265,11 @@ declare const index_isExcludedExtension: typeof isExcludedExtension;
 declare const index_jsonManipulator: typeof jsonManipulator;
 declare const index_killBackgroundProcess: typeof killBackgroundProcess;
 declare const index_listDirectory: typeof listDirectory;
+declare const index_parseRepository: typeof parseRepository;
 declare const index_readFile: typeof readFile;
+declare const index_resolveRepository: typeof resolveRepository;
 declare const index_setMediaOutputHandler: typeof setMediaOutputHandler;
+declare const index_setMediaStorage: typeof setMediaStorage;
 declare const index_toolRegistry: typeof toolRegistry;
 declare const index_validatePath: typeof validatePath;
 declare const index_webFetch: typeof webFetch;
@@ -11983,7 +12278,7 @@ declare const index_webScrape: typeof webScrape;
 declare const index_webSearch: typeof webSearch;
 declare const index_writeFile: typeof writeFile;
 declare namespace index {
-  export { type index_BashResult as BashResult, type index_ConnectorToolEntry as ConnectorToolEntry, index_ConnectorTools as ConnectorTools, index_DEFAULT_FILESYSTEM_CONFIG as DEFAULT_FILESYSTEM_CONFIG, index_DEFAULT_SHELL_CONFIG as DEFAULT_SHELL_CONFIG, type index_EditFileResult as EditFileResult, index_FileMediaOutputHandler as FileMediaOutputHandler, type index_FilesystemToolConfig as FilesystemToolConfig, type index_GenericAPICallArgs as GenericAPICallArgs, type index_GenericAPICallResult as GenericAPICallResult, type index_GenericAPIToolOptions as GenericAPIToolOptions, type index_GlobResult as GlobResult, type index_GrepMatch as GrepMatch, type index_GrepResult as GrepResult, type index_IMediaOutputHandler as IMediaOutputHandler, type index_MediaOutputMetadata as MediaOutputMetadata, type index_MediaOutputResult as MediaOutputResult, type index_ReadFileResult as ReadFileResult, type index_SearchResult as SearchResult, type index_ServiceToolFactory as ServiceToolFactory, type index_ShellToolConfig as ShellToolConfig, type index_ToolCategory as ToolCategory, index_ToolRegistry as ToolRegistry, type index_ToolRegistryEntry as ToolRegistryEntry, type index_WriteFileResult as WriteFileResult, index_bash as bash, index_createBashTool as createBashTool, index_createEditFileTool as createEditFileTool, index_createExecuteJavaScriptTool as createExecuteJavaScriptTool, index_createGlobTool as createGlobTool, index_createGrepTool as createGrepTool, index_createImageGenerationTool as createImageGenerationTool, index_createListDirectoryTool as createListDirectoryTool, index_createReadFileTool as createReadFileTool, index_createSpeechToTextTool as createSpeechToTextTool, index_createTextToSpeechTool as createTextToSpeechTool, index_createVideoTools as createVideoTools, index_createWriteFileTool as createWriteFileTool, index_developerTools as developerTools, index_editFile as editFile, index_executeJavaScript as executeJavaScript, index_expandTilde as expandTilde, index_getAllBuiltInTools as getAllBuiltInTools, index_getBackgroundOutput as getBackgroundOutput, index_getMediaOutputHandler as getMediaOutputHandler, index_getToolByName as getToolByName, index_getToolCategories as getToolCategories, index_getToolRegistry as getToolRegistry, index_getToolsByCategory as getToolsByCategory, index_getToolsRequiringConnector as getToolsRequiringConnector, index_glob as glob, index_grep as grep, index_isBlockedCommand as isBlockedCommand, index_isExcludedExtension as isExcludedExtension, index_jsonManipulator as jsonManipulator, index_killBackgroundProcess as killBackgroundProcess, index_listDirectory as listDirectory, index_readFile as readFile, index_setMediaOutputHandler as setMediaOutputHandler, index_toolRegistry as toolRegistry, index_validatePath as validatePath, index_webFetch as webFetch, index_webFetchJS as webFetchJS, index_webScrape as webScrape, index_webSearch as webSearch, index_writeFile as writeFile };
+  export { type index_BashResult as BashResult, type index_ConnectorToolEntry as ConnectorToolEntry, index_ConnectorTools as ConnectorTools, index_DEFAULT_FILESYSTEM_CONFIG as DEFAULT_FILESYSTEM_CONFIG, index_DEFAULT_SHELL_CONFIG as DEFAULT_SHELL_CONFIG, type index_EditFileResult as EditFileResult, FileMediaStorage as FileMediaOutputHandler, type index_FilesystemToolConfig as FilesystemToolConfig, type index_GenericAPICallArgs as GenericAPICallArgs, type index_GenericAPICallResult as GenericAPICallResult, type index_GenericAPIToolOptions as GenericAPIToolOptions, type index_GitHubCreatePRResult as GitHubCreatePRResult, type index_GitHubGetPRResult as GitHubGetPRResult, type index_GitHubPRCommentEntry as GitHubPRCommentEntry, type index_GitHubPRCommentsResult as GitHubPRCommentsResult, type index_GitHubPRFilesResult as GitHubPRFilesResult, type index_GitHubReadFileResult as GitHubReadFileResult, type index_GitHubRepository as GitHubRepository, type index_GitHubSearchCodeResult as GitHubSearchCodeResult, type index_GitHubSearchFilesResult as GitHubSearchFilesResult, type index_GlobResult as GlobResult, type index_GrepMatch as GrepMatch, type index_GrepResult as GrepResult, type IMediaStorage as IMediaOutputHandler, type MediaStorageMetadata as MediaOutputMetadata, type MediaStorageResult as MediaOutputResult, type index_ReadFileResult as ReadFileResult, type index_SearchResult as SearchResult, type index_ServiceToolFactory as ServiceToolFactory, type index_ShellToolConfig as ShellToolConfig, type index_ToolCategory as ToolCategory, index_ToolRegistry as ToolRegistry, type index_ToolRegistryEntry as ToolRegistryEntry, type index_WriteFileResult as WriteFileResult, index_bash as bash, index_createBashTool as createBashTool, index_createCreatePRTool as createCreatePRTool, index_createEditFileTool as createEditFileTool, index_createExecuteJavaScriptTool as createExecuteJavaScriptTool, index_createGetPRTool as createGetPRTool, index_createGitHubReadFileTool as createGitHubReadFileTool, index_createGlobTool as createGlobTool, index_createGrepTool as createGrepTool, index_createImageGenerationTool as createImageGenerationTool, index_createListDirectoryTool as createListDirectoryTool, index_createPRCommentsTool as createPRCommentsTool, index_createPRFilesTool as createPRFilesTool, index_createReadFileTool as createReadFileTool, index_createSearchCodeTool as createSearchCodeTool, index_createSearchFilesTool as createSearchFilesTool, index_createSpeechToTextTool as createSpeechToTextTool, index_createTextToSpeechTool as createTextToSpeechTool, index_createVideoTools as createVideoTools, index_createWriteFileTool as createWriteFileTool, index_developerTools as developerTools, index_editFile as editFile, index_executeJavaScript as executeJavaScript, index_expandTilde as expandTilde, index_getAllBuiltInTools as getAllBuiltInTools, index_getBackgroundOutput as getBackgroundOutput, index_getMediaOutputHandler as getMediaOutputHandler, index_getMediaStorage as getMediaStorage, index_getToolByName as getToolByName, index_getToolCategories as getToolCategories, index_getToolRegistry as getToolRegistry, index_getToolsByCategory as getToolsByCategory, index_getToolsRequiringConnector as getToolsRequiringConnector, index_glob as glob, index_grep as grep, index_isBlockedCommand as isBlockedCommand, index_isExcludedExtension as isExcludedExtension, index_jsonManipulator as jsonManipulator, index_killBackgroundProcess as killBackgroundProcess, index_listDirectory as listDirectory, index_parseRepository as parseRepository, index_readFile as readFile, index_resolveRepository as resolveRepository, index_setMediaOutputHandler as setMediaOutputHandler, index_setMediaStorage as setMediaStorage, index_toolRegistry as toolRegistry, index_validatePath as validatePath, index_webFetch as webFetch, index_webFetchJS as webFetchJS, index_webScrape as webScrape, index_webSearch as webSearch, index_writeFile as writeFile };
 }
 
 /**
@@ -12038,4 +12333,4 @@ declare class ProviderConfigAgent {
     reset(): void;
 }
 
-export { AGENT_DEFINITION_FORMAT_VERSION, AIError, APPROVAL_STATE_VERSION, Agent, type AgentConfig$1 as AgentConfig, AgentContextNextGen, type AgentContextNextGenConfig, type AgentDefinitionListOptions, type AgentDefinitionMetadata, type AgentDefinitionSummary, AgentEvents, type AgentMetrics, type AgentPermissionsConfig, AgentResponse, type AgentSessionConfig, type AgentState, type AgentStatus, type ApprovalCacheEntry, type ApprovalDecision, ApproximateTokenEstimator, AudioFormat, AuditEntry, type AuthTemplate, type AuthTemplateField, type BackoffConfig, type BackoffStrategyType, BaseMediaProvider, BasePluginNextGen, BaseProvider, type BaseProviderConfig$1 as BaseProviderConfig, type BaseProviderResponse, BaseTextProvider, type BashResult, type BeforeExecuteResult, BraveProvider, CONNECTOR_CONFIG_VERSION, CONTEXT_SESSION_FORMAT_VERSION, CheckpointManager, type CheckpointStrategy, CircuitBreaker, type CircuitBreakerConfig, type CircuitBreakerEvents, type CircuitBreakerMetrics, CircuitOpenError, type CircuitState, type ClipboardImageResult, type CompactionContext, type CompactionResult, Connector, ConnectorAccessContext, ConnectorAuth, ConnectorConfig, ConnectorConfigResult, ConnectorConfigStore, ConnectorFetchOptions, type ConnectorToolEntry, ConnectorTools, type ConnectorToolsOptions, ConsoleMetrics, type ConsolidationResult, Content, type ContextBudget$1 as ContextBudget, type ContextEvents, type ContextFeatures, type ContextManagerConfig, type ContextOverflowBudget, ContextOverflowError, type ContextSessionMetadata, type ContextSessionSummary, type ContextStorageListOptions, type ConversationMessage, type CreateConnectorOptions, DEFAULT_ALLOWLIST, DEFAULT_BACKOFF_CONFIG, DEFAULT_CHECKPOINT_STRATEGY, DEFAULT_CIRCUIT_BREAKER_CONFIG, DEFAULT_CONFIG, DEFAULT_CONTEXT_CONFIG, DEFAULT_FEATURES, DEFAULT_FILESYSTEM_CONFIG, DEFAULT_HISTORY_MANAGER_CONFIG, DEFAULT_PERMISSION_CONFIG, DEFAULT_RATE_LIMITER_CONFIG, DEFAULT_SHELL_CONFIG, type DefaultAllowlistedTool, DefaultCompactionStrategy, type DefaultCompactionStrategyConfig, DependencyCycleError, type DirectCallOptions, type EditFileResult, type ErrorContext, ErrorHandler, type ErrorHandlerConfig, type ErrorHandlerEvents, type EvictionStrategy, ExecutionContext, ExecutionMetrics, type ExtendedFetchOptions, type ExternalDependency, type ExternalDependencyEvents, ExternalDependencyHandler, type FetchedContent, FileAgentDefinitionStorage, type FileAgentDefinitionStorageConfig, FileConnectorStorage, type FileConnectorStorageConfig, FileContextStorage, type FileContextStorageConfig, FileMediaOutputHandler, FilePersistentInstructionsStorage, type FilePersistentInstructionsStorageConfig, FileStorage, type FileStorageConfig, type FilesystemToolConfig, FrameworkLogger, FunctionToolDefinition, type GeneratedPlan, type GenericAPICallArgs, type GenericAPICallResult, type GenericAPIToolOptions, type GlobResult, type GrepMatch, type GrepResult, type HTTPTransportConfig, type HistoryManagerEvents, type HistoryMessage, HistoryMode, HookConfig, type IAgentDefinitionStorage, type IAgentStateStorage, type IAgentStorage, type IAsyncDisposable, IBaseModelDescription, type ICapabilityProvider, type ICompactionStrategy, IConnectorAccessPolicy, type IConnectorConfigStorage, IConnectorRegistry, type IContextCompactor, type IContextComponent, type IContextPluginNextGen, type IContextStorage, type IContextStrategy, type IDisposable, type IHistoryManager, type IHistoryManagerConfig, type IHistoryStorage, IImageProvider, type ILLMDescription, type IMCPClient, type IMediaOutputHandler, type IMemoryStorage, type IPersistentInstructionsStorage, type IPlanStorage, IProvider, type IResearchSource, type ISTTModelDescription, type IScrapeProvider, type ISearchProvider, type ISpeechToTextProvider, type ITTSModelDescription, ITextProvider, type ITextToSpeechProvider, type ITokenEstimator$1 as ITokenEstimator, ITokenStorage, type IToolExecutionPipeline, type IToolExecutionPlugin, type IToolExecutor, type IVideoModelDescription, type IVideoProvider, type IVoiceInfo, type InContextEntry, type InContextMemoryConfig, InContextMemoryPluginNextGen, type InContextPriority, InMemoryAgentStateStorage, InMemoryHistoryStorage, InMemoryMetrics, InMemoryPlanStorage, InMemoryStorage, InputItem, InvalidConfigError, InvalidToolArgumentsError, type JSONExtractionResult, LLMResponse, LLM_MODELS, type LogEntry, type LogLevel, type LoggerConfig, LoggingPlugin, type LoggingPluginOptions, MCPClient, type MCPClientConnectionState, type MCPClientState, type MCPConfiguration, MCPConnectionError, MCPError, type MCPPrompt, type MCPPromptResult, MCPProtocolError, MCPRegistry, type MCPResource, type MCPResourceContent, MCPResourceError, type MCPServerCapabilities, type MCPServerConfig, MCPTimeoutError, type MCPTool, MCPToolError, type MCPToolResult, type MCPTransportType, MODEL_REGISTRY, type MediaOutputMetadata, type MediaOutputResult, MemoryConnectorStorage, MemoryEntry, MemoryEvictionCompactor, MemoryIndex, MemoryPriority, MemoryScope, MemoryStorage, MessageBuilder, MessageRole, type MetricTags, type MetricsCollector, type MetricsCollectorType, ModelCapabilities, ModelNotSupportedError, type EvictionStrategy$1 as NextGenEvictionStrategy, NoOpMetrics, type OAuthConfig, type OAuthFlow, OAuthManager, OutputItem, type OversizedInputResult, ParallelTasksError, type PermissionCheckContext, type PermissionCheckResult, type PermissionManagerEvent, type PermissionScope, type PersistentInstructionsConfig, PersistentInstructionsPluginNextGen, type Plan, type PlanConcurrency, type PlanInput, type PlanStatus, PlanningAgent, type PlanningAgentConfig, type PluginConfigs, type PluginExecutionContext, type PreparedContext, ProviderAuthError, ProviderCapabilities, ProviderConfigAgent, ProviderContextLengthError, ProviderError, ProviderErrorMapper, ProviderNotFoundError, ProviderRateLimitError, RapidAPIProvider, RateLimitError, type RateLimiterConfig, type RateLimiterMetrics, type ReadFileResult, type FetchOptions as ResearchFetchOptions, type ResearchFinding, type ResearchPlan, type ResearchProgress, type ResearchQuery, type ResearchResult, type SearchOptions as ResearchSearchOptions, type SearchResponse as ResearchSearchResponse, type RiskLevel, SERVICE_DEFINITIONS, SERVICE_INFO, SERVICE_URL_PATTERNS, SIMPLE_ICONS_CDN, type STTModelCapabilities, type STTOptions, type STTOutputFormat$1 as STTOutputFormat, type STTResponse, STT_MODELS, STT_MODEL_REGISTRY, ScopedConnectorRegistry, type ScrapeFeature, type ScrapeOptions, ScrapeProvider, type ScrapeProviderConfig, type ScrapeProviderFallbackConfig, type ScrapeResponse, type ScrapeResult, type SearchOptions$1 as SearchOptions, SearchProvider, type SearchProviderConfig, type SearchResponse$1 as SearchResponse, type SearchResult$1 as SearchResult, type SegmentTimestamp, type SerializedApprovalEntry, type SerializedApprovalState, type SerializedContextState, type SerializedHistoryState, type SerializedInContextMemoryState, type SerializedPersistentInstructionsState, type SerializedToolState, type SerializedWorkingMemoryState, SerperProvider, type ServiceCategory, type ServiceDefinition, type ServiceInfo, type ServiceToolFactory, type ServiceType, Services, type ShellToolConfig, type SimpleIcon, type SimpleVideoGenerateOptions, type SourceCapabilities, type SourceResult, SpeechToText, type SpeechToTextConfig, type StdioTransportConfig, type StoredAgentDefinition, type StoredAgentType, type StoredConnectorConfig, type StoredContextSession, type StoredToken, type StrategyInfo, StrategyRegistry, type StrategyRegistryEntry, StreamEvent, StreamEventType, StreamHelpers, StreamState, SummarizeCompactor, TERMINAL_TASK_STATUSES, type TTSModelCapabilities, type TTSOptions, type TTSResponse, TTS_MODELS, TTS_MODEL_REGISTRY, type Task, type AgentConfig as TaskAgentStateConfig, type TaskCondition, type TaskExecution, type TaskFailure, type TaskInput, type TaskStatus, TaskStatusForMemory, TaskTimeoutError, ToolContext as TaskToolContext, type TaskValidation, TaskValidationError, type TaskValidationResult, TavilyProvider, type TemplateCredentials, TextGenerateOptions, TextToSpeech, type TextToSpeechConfig, TokenBucketRateLimiter, type TokenContentType, Tool, ToolCall, type ToolCategory, type ToolCondition, ToolContext, ToolExecutionError, ToolExecutionPipeline, type ToolExecutionPipelineOptions, ToolFunction, ToolManager, type ToolManagerEvent, type ToolManagerStats, type ToolMetadata, ToolNotFoundError, type ToolOptions, type ToolPermissionConfig, ToolPermissionManager, type ToolRegistration, ToolRegistry, type ToolRegistryEntry, ToolResult, type ToolSelectionContext, ToolTimeoutError, type TransportConfig, TruncateCompactor, VENDOR_ICON_MAP, VIDEO_MODELS, VIDEO_MODEL_REGISTRY, Vendor, type VendorInfo, type VendorLogo, VendorOptionSchema, type VendorRegistryEntry, type VendorTemplate, type VideoExtendOptions, type VideoGenerateOptions, VideoGeneration, type VideoGenerationCreateOptions, type VideoJob, type VideoModelCapabilities, type VideoModelPricing, type VideoResponse, type VideoStatus, type WordTimestamp, WorkingMemory, WorkingMemoryAccess, WorkingMemoryConfig, type WorkingMemoryEvents, type WorkingMemoryPluginConfig, WorkingMemoryPluginNextGen, type WriteFileResult, addJitter, allVendorTemplates, assertNotDestroyed, authenticatedFetch, backoffSequence, backoffWait, bash, buildAuthConfig, buildEndpointWithQuery, buildQueryString, calculateBackoff, calculateCost, calculateSTTCost, calculateTTSCost, calculateVideoCost, canTaskExecute, createAgentStorage, createAuthenticatedFetch, createBashTool, createConnectorFromTemplate, createEditFileTool, createEstimator, createExecuteJavaScriptTool, createFileAgentDefinitionStorage, createFileContextStorage, createGlobTool, createGrepTool, createImageGenerationTool, createImageProvider, createListDirectoryTool, createMessageWithImages, createMetricsCollector, createPlan, createProvider, createReadFileTool, createSpeechToTextTool, createTask, createTextMessage, createTextToSpeechTool, createVideoProvider, createVideoTools, createWriteFileTool, detectDependencyCycle, detectServiceFromURL, developerTools, editFile, evaluateCondition, extractJSON, extractJSONField, extractNumber, findConnectorByServiceTypes, generateEncryptionKey, generateSimplePlan, generateWebAPITool, getActiveModels, getActiveSTTModels, getActiveTTSModels, getActiveVideoModels, getAllBuiltInTools, getAllServiceIds, getAllVendorLogos, getAllVendorTemplates, getBackgroundOutput, getConnectorTools, getCredentialsSetupURL, getDocsURL, getMediaOutputHandler, getModelInfo, getModelsByVendor, getNextExecutableTasks, getRegisteredScrapeProviders, getSTTModelInfo, getSTTModelsByVendor, getSTTModelsWithFeature, getServiceDefinition, getServiceInfo, getServicesByCategory, getTTSModelInfo, getTTSModelsByVendor, getTTSModelsWithFeature, getTaskDependencies, getToolByName, getToolCategories, getToolRegistry, getToolsByCategory, getToolsRequiringConnector, getVendorAuthTemplate, getVendorColor, getVendorInfo, getVendorLogo, getVendorLogoCdnUrl, getVendorLogoSvg, getVendorTemplate, getVideoModelInfo, getVideoModelsByVendor, getVideoModelsWithAudio, getVideoModelsWithFeature, glob, globalErrorHandler, grep, hasClipboardImage, hasVendorLogo, isBlockedCommand, isExcludedExtension, isKnownService, isTaskBlocked, isTerminalStatus, killBackgroundProcess, listConnectorsByServiceTypes, listDirectory, listVendorIds, listVendors, listVendorsByAuthType, listVendorsByCategory, listVendorsWithLogos, logger, metrics, readClipboardImage, readFile, registerScrapeProvider, resolveConnector, resolveDependencies, retryWithBackoff, setMediaOutputHandler, setMetricsCollector, simpleTokenEstimator, toConnectorOptions, toolRegistry, index as tools, updateTaskStatus, validatePath, writeFile };
+export { AGENT_DEFINITION_FORMAT_VERSION, AIError, APPROVAL_STATE_VERSION, Agent, type AgentConfig$1 as AgentConfig, AgentContextNextGen, type AgentContextNextGenConfig, type AgentDefinitionListOptions, type AgentDefinitionMetadata, type AgentDefinitionSummary, AgentEvents, type AgentMetrics, type AgentPermissionsConfig, AgentResponse, type AgentSessionConfig, type AgentState, type AgentStatus, type ApprovalCacheEntry, type ApprovalDecision, ApproximateTokenEstimator, AudioFormat, AuditEntry, type AuthTemplate, type AuthTemplateField, type BackoffConfig, type BackoffStrategyType, BaseMediaProvider, BasePluginNextGen, BaseProvider, type BaseProviderConfig$1 as BaseProviderConfig, type BaseProviderResponse, BaseTextProvider, type BashResult, type BeforeExecuteResult, BraveProvider, CONNECTOR_CONFIG_VERSION, CONTEXT_SESSION_FORMAT_VERSION, CheckpointManager, type CheckpointStrategy, CircuitBreaker, type CircuitBreakerConfig, type CircuitBreakerEvents, type CircuitBreakerMetrics, CircuitOpenError, type CircuitState, type ClipboardImageResult, type CompactionContext, type CompactionResult, Connector, ConnectorAccessContext, ConnectorAuth, ConnectorConfig, ConnectorConfigResult, ConnectorConfigStore, ConnectorFetchOptions, type ConnectorToolEntry, ConnectorTools, type ConnectorToolsOptions, ConsoleMetrics, type ConsolidationResult, Content, type ContextBudget$1 as ContextBudget, type ContextEvents, type ContextFeatures, type ContextManagerConfig, type ContextOverflowBudget, ContextOverflowError, type ContextSessionMetadata, type ContextSessionSummary, type ContextStorageListOptions, type ConversationMessage, type CreateConnectorOptions, DEFAULT_ALLOWLIST, DEFAULT_BACKOFF_CONFIG, DEFAULT_CHECKPOINT_STRATEGY, DEFAULT_CIRCUIT_BREAKER_CONFIG, DEFAULT_CONFIG, DEFAULT_CONTEXT_CONFIG, DEFAULT_FEATURES, DEFAULT_FILESYSTEM_CONFIG, DEFAULT_HISTORY_MANAGER_CONFIG, DEFAULT_PERMISSION_CONFIG, DEFAULT_RATE_LIMITER_CONFIG, DEFAULT_SHELL_CONFIG, type DefaultAllowlistedTool, DefaultCompactionStrategy, type DefaultCompactionStrategyConfig, DependencyCycleError, type DirectCallOptions, type EditFileResult, type ErrorContext, ErrorHandler, type ErrorHandlerConfig, type ErrorHandlerEvents, type EvictionStrategy, ExecutionContext, ExecutionMetrics, type ExtendedFetchOptions, type ExternalDependency, type ExternalDependencyEvents, ExternalDependencyHandler, type FetchedContent, FileAgentDefinitionStorage, type FileAgentDefinitionStorageConfig, FileConnectorStorage, type FileConnectorStorageConfig, FileContextStorage, type FileContextStorageConfig, FileMediaStorage as FileMediaOutputHandler, FileMediaStorage, type FileMediaStorageConfig, FilePersistentInstructionsStorage, type FilePersistentInstructionsStorageConfig, FileStorage, type FileStorageConfig, type FilesystemToolConfig, FrameworkLogger, FunctionToolDefinition, type GeneratedPlan, type GenericAPICallArgs, type GenericAPICallResult, type GenericAPIToolOptions, type GitHubCreatePRResult, type GitHubGetPRResult, type GitHubPRCommentEntry, type GitHubPRCommentsResult, type GitHubPRFilesResult, type GitHubReadFileResult, type GitHubRepository, type GitHubSearchCodeResult, type GitHubSearchFilesResult, type GlobResult, type GrepMatch, type GrepResult, type HTTPTransportConfig, type HistoryManagerEvents, type HistoryMessage, HistoryMode, HookConfig, type IAgentDefinitionStorage, type IAgentStateStorage, type IAgentStorage, type IAsyncDisposable, IBaseModelDescription, type ICapabilityProvider, type ICompactionStrategy, IConnectorAccessPolicy, type IConnectorConfigStorage, IConnectorRegistry, type IContextCompactor, type IContextComponent, type IContextPluginNextGen, type IContextStorage, type IContextStrategy, type IDisposable, type IHistoryManager, type IHistoryManagerConfig, type IHistoryStorage, IImageProvider, type IMCPClient, type IMediaStorage as IMediaOutputHandler, type IMediaStorage, type IMemoryStorage, type IPersistentInstructionsStorage, type IPlanStorage, IProvider, type IResearchSource, type ISTTModelDescription, type IScrapeProvider, type ISearchProvider, type ISpeechToTextProvider, type ITTSModelDescription, ITextProvider, type ITextToSpeechProvider, type ITokenEstimator$1 as ITokenEstimator, ITokenStorage, type IToolExecutionPipeline, type IToolExecutionPlugin, type IToolExecutor, type IVideoModelDescription, type IVideoProvider, type IVoiceInfo, type InContextEntry, type InContextMemoryConfig, InContextMemoryPluginNextGen, type InContextPriority, InMemoryAgentStateStorage, InMemoryHistoryStorage, InMemoryMetrics, InMemoryPlanStorage, InMemoryStorage, InputItem, type InstructionEntry, InvalidConfigError, InvalidToolArgumentsError, type JSONExtractionResult, LLMResponse, type LogEntry, type LogLevel, type LoggerConfig, LoggingPlugin, type LoggingPluginOptions, MCPClient, type MCPClientConnectionState, type MCPClientState, type MCPConfiguration, MCPConnectionError, MCPError, type MCPPrompt, type MCPPromptResult, MCPProtocolError, MCPRegistry, type MCPResource, type MCPResourceContent, MCPResourceError, type MCPServerCapabilities, type MCPServerConfig, MCPTimeoutError, type MCPTool, MCPToolError, type MCPToolResult, type MCPTransportType, type MediaStorageMetadata as MediaOutputMetadata, type MediaStorageResult as MediaOutputResult, type MediaStorageEntry, type MediaStorageListOptions, type MediaStorageMetadata, type MediaStorageResult, MemoryConnectorStorage, MemoryEntry, MemoryEvictionCompactor, MemoryIndex, MemoryPriority, MemoryScope, MemoryStorage, MessageBuilder, MessageRole, type MetricTags, type MetricsCollector, type MetricsCollectorType, ModelCapabilities, ModelNotSupportedError, type EvictionStrategy$1 as NextGenEvictionStrategy, NoOpMetrics, type OAuthConfig, type OAuthFlow, OAuthManager, OutputItem, type OversizedInputResult, ParallelTasksError, type PermissionCheckContext, type PermissionCheckResult, type PermissionManagerEvent, type PermissionScope, type PersistentInstructionsConfig, PersistentInstructionsPluginNextGen, type Plan, type PlanConcurrency, type PlanInput, type PlanStatus, PlanningAgent, type PlanningAgentConfig, type PluginConfigs, type PluginExecutionContext, type PreparedContext, ProviderAuthError, ProviderCapabilities, ProviderConfigAgent, ProviderContextLengthError, ProviderError, ProviderErrorMapper, ProviderNotFoundError, ProviderRateLimitError, RapidAPIProvider, RateLimitError, type RateLimiterConfig, type RateLimiterMetrics, type ReadFileResult, type FetchOptions as ResearchFetchOptions, type ResearchFinding, type ResearchPlan, type ResearchProgress, type ResearchQuery, type ResearchResult, type SearchOptions as ResearchSearchOptions, type SearchResponse as ResearchSearchResponse, type RiskLevel, SIMPLE_ICONS_CDN, type STTModelCapabilities, type STTOptions, type STTOutputFormat$1 as STTOutputFormat, type STTResponse, STT_MODELS, STT_MODEL_REGISTRY, ScopedConnectorRegistry, type ScrapeFeature, type ScrapeOptions, ScrapeProvider, type ScrapeProviderConfig, type ScrapeProviderFallbackConfig, type ScrapeResponse, type ScrapeResult, type SearchOptions$1 as SearchOptions, SearchProvider, type SearchProviderConfig, type SearchResponse$1 as SearchResponse, type SearchResult$1 as SearchResult, type SegmentTimestamp, type SerializedApprovalEntry, type SerializedApprovalState, type SerializedContextState, type SerializedHistoryState, type SerializedInContextMemoryState, type SerializedPersistentInstructionsState, type SerializedToolState, type SerializedWorkingMemoryState, SerperProvider, ServiceCategory, type ServiceToolFactory, type ShellToolConfig, type SimpleIcon, type SimpleVideoGenerateOptions, type SourceCapabilities, type SourceResult, SpeechToText, type SpeechToTextConfig, type StdioTransportConfig, type StoredAgentDefinition, type StoredAgentType, type StoredConnectorConfig, type StoredContextSession, type StoredToken, type StrategyInfo, StrategyRegistry, type StrategyRegistryEntry, StreamEvent, StreamEventType, StreamHelpers, StreamState, SummarizeCompactor, TERMINAL_TASK_STATUSES, type TTSModelCapabilities, type TTSOptions, type TTSResponse, TTS_MODELS, TTS_MODEL_REGISTRY, type Task, type AgentConfig as TaskAgentStateConfig, type TaskCondition, type TaskExecution, type TaskFailure, type TaskInput, type TaskStatus, TaskStatusForMemory, TaskTimeoutError, ToolContext as TaskToolContext, type TaskValidation, TaskValidationError, type TaskValidationResult, TavilyProvider, type TemplateCredentials, TextGenerateOptions, TextToSpeech, type TextToSpeechConfig, TokenBucketRateLimiter, type TokenContentType, Tool, ToolCall, type ToolCategory, type ToolCondition, ToolContext, ToolExecutionError, ToolExecutionPipeline, type ToolExecutionPipelineOptions, ToolFunction, ToolManager, type ToolManagerConfig, type ToolManagerEvent, type ToolManagerStats, type ToolMetadata, ToolNotFoundError, type ToolOptions, type ToolPermissionConfig, ToolPermissionManager, type ToolRegistration, ToolRegistry, type ToolRegistryEntry, ToolResult, type ToolSelectionContext, ToolTimeoutError, type TransportConfig, TruncateCompactor, VENDOR_ICON_MAP, VIDEO_MODELS, VIDEO_MODEL_REGISTRY, Vendor, type VendorInfo, type VendorLogo, VendorOptionSchema, type VendorRegistryEntry, type VendorTemplate, type VideoExtendOptions, type VideoGenerateOptions, VideoGeneration, type VideoGenerationCreateOptions, type VideoJob, type VideoModelCapabilities, type VideoModelPricing, type VideoResponse, type VideoStatus, type WordTimestamp, WorkingMemory, WorkingMemoryAccess, WorkingMemoryConfig, type WorkingMemoryEvents, type WorkingMemoryPluginConfig, WorkingMemoryPluginNextGen, type WriteFileResult, addJitter, allVendorTemplates, assertNotDestroyed, authenticatedFetch, backoffSequence, backoffWait, bash, buildAuthConfig, buildEndpointWithQuery, buildQueryString, calculateBackoff, calculateSTTCost, calculateTTSCost, calculateVideoCost, canTaskExecute, createAgentStorage, createAuthenticatedFetch, createBashTool, createConnectorFromTemplate, createCreatePRTool, createEditFileTool, createEstimator, createExecuteJavaScriptTool, createFileAgentDefinitionStorage, createFileContextStorage, createFileMediaStorage, createGetPRTool, createGitHubReadFileTool, createGlobTool, createGrepTool, createImageGenerationTool, createImageProvider, createListDirectoryTool, createMessageWithImages, createMetricsCollector, createPRCommentsTool, createPRFilesTool, createPlan, createProvider, createReadFileTool, createSearchCodeTool, createSearchFilesTool, createSpeechToTextTool, createTask, createTextMessage, createTextToSpeechTool, createVideoProvider, createVideoTools, createWriteFileTool, detectDependencyCycle, developerTools, editFile, evaluateCondition, extractJSON, extractJSONField, extractNumber, findConnectorByServiceTypes, generateEncryptionKey, generateSimplePlan, generateWebAPITool, getActiveSTTModels, getActiveTTSModels, getActiveVideoModels, getAllBuiltInTools, getAllVendorLogos, getAllVendorTemplates, getBackgroundOutput, getConnectorTools, getCredentialsSetupURL, getDocsURL, getMediaOutputHandler, getMediaStorage, getNextExecutableTasks, getRegisteredScrapeProviders, getSTTModelInfo, getSTTModelsByVendor, getSTTModelsWithFeature, getTTSModelInfo, getTTSModelsByVendor, getTTSModelsWithFeature, getTaskDependencies, getToolByName, getToolCategories, getToolRegistry, getToolsByCategory, getToolsRequiringConnector, getVendorAuthTemplate, getVendorColor, getVendorDefaultBaseURL, getVendorInfo, getVendorLogo, getVendorLogoCdnUrl, getVendorLogoSvg, getVendorTemplate, getVideoModelInfo, getVideoModelsByVendor, getVideoModelsWithAudio, getVideoModelsWithFeature, glob, globalErrorHandler, grep, hasClipboardImage, hasVendorLogo, isBlockedCommand, isExcludedExtension, isTaskBlocked, isTerminalStatus, killBackgroundProcess, listConnectorsByServiceTypes, listDirectory, listVendorIds, listVendors, listVendorsByAuthType, listVendorsByCategory, listVendorsWithLogos, logger, metrics, parseRepository, readClipboardImage, readFile, registerScrapeProvider, resolveConnector, resolveDependencies, resolveRepository, retryWithBackoff, setMediaOutputHandler, setMediaStorage, setMetricsCollector, simpleTokenEstimator, toConnectorOptions, toolRegistry, index as tools, updateTaskStatus, validatePath, writeFile };