@everworker/oneringai 0.1.3 → 0.1.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.cts CHANGED
@@ -1,9 +1,13 @@
1
- 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-DtN780fU.cjs';
2
- 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-DtN780fU.cjs';
3
- 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-DCzFlLoN.cjs';
4
- 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-DCzFlLoN.cjs';
1
+ 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-DSY7SNsq.cjs';
2
+ 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-DSY7SNsq.cjs';
3
+ 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-NOV01LWF.cjs';
4
+ 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-NOV01LWF.cjs';
5
5
  import { EventEmitter } from 'eventemitter3';
6
+ import { V as Vendor } from './Vendor-DYh_bzwo.cjs';
7
+ export { a as VENDORS, i as isVendor } from './Vendor-DYh_bzwo.cjs';
6
8
  import { I as IProvider, P as ProviderCapabilities } from './IProvider-BP49c93d.cjs';
9
+ import { ServiceCategory } from './shared/index.cjs';
10
+ 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.cjs';
7
11
 
8
12
  /**
9
13
  * ScopedConnectorRegistry - Filtered view over the Connector registry
@@ -504,6 +508,18 @@ interface SerializedToolState {
504
508
  permissions?: Record<string, ToolPermissionConfig$1>;
505
509
  }
506
510
  type ToolManagerEvent = 'tool:registered' | 'tool:unregistered' | 'tool:enabled' | 'tool:disabled' | 'tool:executed' | 'namespace:enabled' | 'namespace:disabled';
511
+ /**
512
+ * Configuration for ToolManager
513
+ */
514
+ interface ToolManagerConfig {
515
+ /**
516
+ * Hard timeout in milliseconds for any single tool execution.
517
+ * Acts as a safety net: if a tool's own timeout mechanism fails
518
+ * (e.g. child process doesn't exit), this will force-resolve with an error.
519
+ * Default: 0 (disabled - relies on tool's own timeout)
520
+ */
521
+ toolExecutionTimeout?: number;
522
+ }
507
523
  declare class ToolManager extends EventEmitter implements IToolExecutor, IDisposable {
508
524
  private registry;
509
525
  private namespaceIndex;
@@ -513,7 +529,15 @@ declare class ToolManager extends EventEmitter implements IToolExecutor, IDispos
513
529
  private pipeline;
514
530
  /** Optional tool context for execution (set by agent before runs) */
515
531
  private _toolContext;
516
- constructor();
532
+ /** Hard timeout for tool execution (0 = disabled) */
533
+ private _toolExecutionTimeout;
534
+ constructor(config?: ToolManagerConfig);
535
+ /**
536
+ * Get or set the hard tool execution timeout in milliseconds.
537
+ * 0 = disabled (relies on tool's own timeout).
538
+ */
539
+ get toolExecutionTimeout(): number;
540
+ set toolExecutionTimeout(value: number);
517
541
  /**
518
542
  * Access the execution pipeline for plugin management.
519
543
  *
@@ -720,6 +744,11 @@ declare class ToolManager extends EventEmitter implements IToolExecutor, IDispos
720
744
  * List all registered tool names (IToolExecutor interface - delegates to list())
721
745
  */
722
746
  listTools(): string[];
747
+ /**
748
+ * Wrap a promise with a hard timeout safety net.
749
+ * If the promise doesn't resolve within the timeout, throws ToolExecutionError.
750
+ */
751
+ private withHardTimeout;
723
752
  /**
724
753
  * Get or create circuit breaker for a tool
725
754
  */
@@ -1890,6 +1919,13 @@ interface AgentContextNextGenConfig {
1890
1919
  storage?: IContextStorage;
1891
1920
  /** Plugin-specific configurations (used with features flags) */
1892
1921
  plugins?: PluginConfigs;
1922
+ /**
1923
+ * Hard timeout in milliseconds for any single tool execution.
1924
+ * Acts as a safety net: if a tool's own timeout mechanism fails
1925
+ * (e.g. a child process doesn't exit), this will force-resolve with an error.
1926
+ * Default: 0 (disabled - relies on each tool's own timeout)
1927
+ */
1928
+ toolExecutionTimeout?: number;
1893
1929
  }
1894
1930
  /**
1895
1931
  * Default configuration values
@@ -2753,6 +2789,13 @@ interface BaseAgentConfig {
2753
2789
  permissions?: AgentPermissionsConfig;
2754
2790
  /** Lifecycle hooks for customization */
2755
2791
  lifecycleHooks?: AgentLifecycleHooks;
2792
+ /**
2793
+ * Hard timeout in milliseconds for any single tool execution.
2794
+ * Acts as a safety net at the ToolManager level: if a tool's own timeout
2795
+ * mechanism fails, this will force-reject with an error.
2796
+ * Default: 0 (disabled - relies on each tool's own timeout).
2797
+ */
2798
+ toolExecutionTimeout?: number;
2756
2799
  /**
2757
2800
  * Optional AgentContextNextGen configuration.
2758
2801
  * If provided as AgentContextNextGen instance, it will be used directly.
@@ -3239,8 +3282,16 @@ interface AgentConfig$1 extends BaseAgentConfig {
3239
3282
  */
3240
3283
  context?: AgentContextNextGen | AgentContextNextGenConfig;
3241
3284
  /**
3242
- * @deprecated Tool timeouts are now handled by ToolManager per-tool.
3243
- * Configure timeouts in individual tool definitions instead.
3285
+ * Hard timeout in milliseconds for any single tool execution.
3286
+ * Acts as a safety net: if a tool's own timeout mechanism fails
3287
+ * (e.g. a spawned child process doesn't exit), this will force-resolve
3288
+ * with an error. Default: 0 (disabled - relies on each tool's own timeout).
3289
+ *
3290
+ * Example: `toolExecutionTimeout: 300000` (5 minutes hard cap per tool call)
3291
+ */
3292
+ toolExecutionTimeout?: number;
3293
+ /**
3294
+ * @deprecated Use `toolExecutionTimeout` instead.
3244
3295
  */
3245
3296
  toolTimeout?: number;
3246
3297
  hooks?: HookConfig;
@@ -4290,6 +4341,12 @@ declare class StrategyRegistry {
4290
4341
  * It extracts credentials from the connector and instantiates the appropriate SDK.
4291
4342
  */
4292
4343
 
4344
+ /**
4345
+ * Get the default API base URL for a vendor.
4346
+ * For OpenAI/Anthropic reads from the installed SDK at runtime.
4347
+ * Returns undefined for Custom or unknown vendors.
4348
+ */
4349
+ declare function getVendorDefaultBaseURL(vendor: string): string | undefined;
4293
4350
  /**
4294
4351
  * Create a text provider from a connector
4295
4352
  */
@@ -6431,6 +6488,119 @@ declare class ScrapeProvider {
6431
6488
  static createWithFallback(config: ScrapeProviderFallbackConfig): IScrapeProvider;
6432
6489
  }
6433
6490
 
6491
+ /**
6492
+ * IMediaStorage - Storage interface for multimedia outputs (images, video, audio)
6493
+ *
6494
+ * Provides CRUD operations for media files produced by generation tools.
6495
+ * Implementations can use filesystem, S3, GCS, or any other storage backend.
6496
+ *
6497
+ * This follows Clean Architecture - the interface is in domain layer,
6498
+ * implementations are in infrastructure layer.
6499
+ */
6500
+ /**
6501
+ * Metadata about media being saved
6502
+ */
6503
+ interface MediaStorageMetadata {
6504
+ /** Type of media being saved */
6505
+ type: 'image' | 'video' | 'audio';
6506
+ /** File format (png, mp4, mp3, etc.) */
6507
+ format: string;
6508
+ /** Model used for generation */
6509
+ model: string;
6510
+ /** Vendor that produced the output */
6511
+ vendor: string;
6512
+ /** Index for multi-image results */
6513
+ index?: number;
6514
+ /** Suggested filename (without path) */
6515
+ suggestedFilename?: string;
6516
+ /** User ID — set by tool when userId is known, for per-user storage organization */
6517
+ userId?: string;
6518
+ }
6519
+ /**
6520
+ * Result of a save operation
6521
+ */
6522
+ interface MediaStorageResult {
6523
+ /** Location of the saved file (file path, URL, S3 key - depends on implementation) */
6524
+ location: string;
6525
+ /** MIME type of the saved file */
6526
+ mimeType: string;
6527
+ /** File size in bytes */
6528
+ size: number;
6529
+ }
6530
+ /**
6531
+ * Entry returned by list()
6532
+ */
6533
+ interface MediaStorageEntry {
6534
+ /** Location of the file */
6535
+ location: string;
6536
+ /** MIME type */
6537
+ mimeType: string;
6538
+ /** File size in bytes */
6539
+ size: number;
6540
+ /** Media type (image, video, audio) */
6541
+ type?: 'image' | 'video' | 'audio';
6542
+ /** When the file was created */
6543
+ createdAt: Date;
6544
+ }
6545
+ /**
6546
+ * Options for listing media files
6547
+ */
6548
+ interface MediaStorageListOptions {
6549
+ /** Filter by media type */
6550
+ type?: 'image' | 'video' | 'audio';
6551
+ /** Maximum number of results */
6552
+ limit?: number;
6553
+ /** Offset for pagination */
6554
+ offset?: number;
6555
+ }
6556
+ /**
6557
+ * Storage interface for multimedia outputs
6558
+ *
6559
+ * Implementations:
6560
+ * - FileMediaStorage: File-based storage (default, uses local filesystem)
6561
+ * - (Custom) S3MediaStorage, GCSMediaStorage, etc.
6562
+ */
6563
+ interface IMediaStorage {
6564
+ /**
6565
+ * Save media data to storage
6566
+ *
6567
+ * @param data - Raw media data as Buffer
6568
+ * @param metadata - Information about the media for naming/organization
6569
+ * @returns Location and metadata of the saved file
6570
+ */
6571
+ save(data: Buffer, metadata: MediaStorageMetadata): Promise<MediaStorageResult>;
6572
+ /**
6573
+ * Read media data from storage
6574
+ *
6575
+ * @param location - Location string returned by save() or known file path
6576
+ * @returns The raw media data, or null if not found
6577
+ */
6578
+ read(location: string): Promise<Buffer | null>;
6579
+ /**
6580
+ * Delete media from storage
6581
+ *
6582
+ * @param location - Location string to delete
6583
+ * @throws Does NOT throw if the file doesn't exist
6584
+ */
6585
+ delete(location: string): Promise<void>;
6586
+ /**
6587
+ * Check if media exists in storage
6588
+ *
6589
+ * @param location - Location string to check
6590
+ */
6591
+ exists(location: string): Promise<boolean>;
6592
+ /**
6593
+ * List media files in storage (optional)
6594
+ *
6595
+ * @param options - Filtering and pagination options
6596
+ */
6597
+ list?(options?: MediaStorageListOptions): Promise<MediaStorageEntry[]>;
6598
+ /**
6599
+ * Get the storage path/location (for display/debugging)
6600
+ */
6601
+ getPath(): string;
6602
+ }
6603
+
6434
6604
  /**
6435
6605
  * WorkingMemory class - manages indexed working memory for TaskAgent
6436
6606
  *
@@ -8525,174 +8695,33 @@ declare class FileAgentDefinitionStorage implements IAgentDefinitionStorage {
8525
8695
  declare function createFileAgentDefinitionStorage(config?: FileAgentDefinitionStorageConfig): FileAgentDefinitionStorage;
8526
8696
 
8527
8697
  /**
8528
- * Complete description of an LLM model including capabilities, pricing, and features
8698
+ * FileMediaStorage - File-based media storage implementation
8699
+ *
8700
+ * Saves generated media to a configurable directory on the local filesystem.
8701
+ * Default output directory: `os.tmpdir()/oneringai-media/`
8529
8702
  */
8530
- interface ILLMDescription {
8531
- /** Model identifier (e.g., "gpt-5.2-instant") */
8532
- name: string;
8533
- /** Vendor/provider (Vendor.OpenAI, Vendor.Anthropic, etc.) */
8534
- provider: string;
8535
- /** Optional description of the model */
8536
- description?: string;
8537
- /** Whether the model is currently available for use */
8538
- isActive: boolean;
8539
- /** Release date (YYYY-MM-DD format) */
8540
- releaseDate?: string;
8541
- /** Knowledge cutoff date */
8542
- knowledgeCutoff?: string;
8543
- /** Model capabilities and pricing */
8544
- features: {
8545
- /** Supports extended reasoning/thinking */
8546
- reasoning?: boolean;
8547
- /** Supports streaming responses */
8548
- streaming: boolean;
8549
- /** Supports structured output (JSON mode) */
8550
- structuredOutput?: boolean;
8551
- /** Supports function/tool calling */
8552
- functionCalling?: boolean;
8553
- /** Supports fine-tuning */
8554
- fineTuning?: boolean;
8555
- /** Supports predicted outputs */
8556
- predictedOutputs?: boolean;
8557
- /** Supports realtime API */
8558
- realtime?: boolean;
8559
- /** Supports image input (vision) */
8560
- vision?: boolean;
8561
- /** Supports audio input/output */
8562
- audio?: boolean;
8563
- /** Supports video input */
8564
- video?: boolean;
8565
- /** Supports extended thinking (Claude-specific) */
8566
- extendedThinking?: boolean;
8567
- /** Supports batch API */
8568
- batchAPI?: boolean;
8569
- /** Supports prompt caching */
8570
- promptCaching?: boolean;
8571
- /** Parameter support - indicates which sampling parameters are supported */
8572
- parameters?: {
8573
- /** Supports temperature parameter */
8574
- temperature?: boolean;
8575
- /** Supports top_p parameter */
8576
- topP?: boolean;
8577
- /** Supports frequency_penalty parameter */
8578
- frequencyPenalty?: boolean;
8579
- /** Supports presence_penalty parameter */
8580
- presencePenalty?: boolean;
8581
- };
8582
- /** Input specifications */
8583
- input: {
8584
- /** Maximum input context window (in tokens) */
8585
- tokens: number;
8586
- /** Supports text input */
8587
- text: boolean;
8588
- /** Supports image input */
8589
- image?: boolean;
8590
- /** Supports audio input */
8591
- audio?: boolean;
8592
- /** Supports video input */
8593
- video?: boolean;
8594
- /** Cost per million tokens (input) */
8595
- cpm: number;
8596
- /** Cost per million cached tokens (if prompt caching supported) */
8597
- cpmCached?: number;
8598
- };
8599
- /** Output specifications */
8600
- output: {
8601
- /** Maximum output tokens */
8602
- tokens: number;
8603
- /** Supports text output */
8604
- text: boolean;
8605
- /** Supports image output */
8606
- image?: boolean;
8607
- /** Supports audio output */
8608
- audio?: boolean;
8609
- /** Cost per million tokens (output) */
8610
- cpm: number;
8611
- };
8612
- };
8703
+
8704
+ interface FileMediaStorageConfig {
8705
+ /** Directory to store media files. Defaults to `os.tmpdir()/oneringai-media/` */
8706
+ outputDir?: string;
8707
+ }
8708
+ declare class FileMediaStorage implements IMediaStorage {
8709
+ private outputDir;
8710
+ private initialized;
8711
+ constructor(config?: FileMediaStorageConfig);
8712
+ save(data: Buffer, metadata: MediaStorageMetadata): Promise<MediaStorageResult>;
8713
+ read(location: string): Promise<Buffer | null>;
8714
+ delete(location: string): Promise<void>;
8715
+ exists(location: string): Promise<boolean>;
8716
+ list(options?: MediaStorageListOptions): Promise<MediaStorageEntry[]>;
8717
+ getPath(): string;
8718
+ private generateFilename;
8719
+ private ensureDir;
8613
8720
  }
8614
8721
  /**
8615
- * Model name constants organized by vendor
8616
- * Updated: January 2026 - Contains only verified, currently available models
8617
- */
8618
- declare const LLM_MODELS: {
8619
- readonly openai: {
8620
- readonly GPT_5_2: "gpt-5.2";
8621
- readonly GPT_5_2_PRO: "gpt-5.2-pro";
8622
- readonly GPT_5: "gpt-5";
8623
- readonly GPT_5_MINI: "gpt-5-mini";
8624
- readonly GPT_5_NANO: "gpt-5-nano";
8625
- readonly GPT_4_1: "gpt-4.1";
8626
- readonly GPT_4_1_MINI: "gpt-4.1-mini";
8627
- readonly GPT_4_1_NANO: "gpt-4.1-nano";
8628
- readonly GPT_4O: "gpt-4o";
8629
- readonly GPT_4O_MINI: "gpt-4o-mini";
8630
- readonly O3_MINI: "o3-mini";
8631
- readonly O1: "o1";
8632
- };
8633
- readonly anthropic: {
8634
- readonly CLAUDE_OPUS_4_5: "claude-opus-4-5-20251101";
8635
- readonly CLAUDE_SONNET_4_5: "claude-sonnet-4-5-20250929";
8636
- readonly CLAUDE_HAIKU_4_5: "claude-haiku-4-5-20251001";
8637
- readonly CLAUDE_OPUS_4_1: "claude-opus-4-1-20250805";
8638
- readonly CLAUDE_SONNET_4: "claude-sonnet-4-20250514";
8639
- readonly CLAUDE_SONNET_3_7: "claude-3-7-sonnet-20250219";
8640
- readonly CLAUDE_HAIKU_3: "claude-3-haiku-20240307";
8641
- };
8642
- readonly google: {
8643
- readonly GEMINI_3_FLASH_PREVIEW: "gemini-3-flash-preview";
8644
- readonly GEMINI_3_PRO_PREVIEW: "gemini-3-pro-preview";
8645
- readonly GEMINI_3_PRO_IMAGE_PREVIEW: "gemini-3-pro-image-preview";
8646
- readonly GEMINI_2_5_PRO: "gemini-2.5-pro";
8647
- readonly GEMINI_2_5_FLASH: "gemini-2.5-flash";
8648
- readonly GEMINI_2_5_FLASH_LITE: "gemini-2.5-flash-lite";
8649
- readonly GEMINI_2_5_FLASH_IMAGE: "gemini-2.5-flash-image";
8650
- };
8651
- readonly grok: {
8652
- readonly GROK_4_1_FAST_REASONING: "grok-4-1-fast-reasoning";
8653
- readonly GROK_4_1_FAST_NON_REASONING: "grok-4-1-fast-non-reasoning";
8654
- readonly GROK_4_FAST_REASONING: "grok-4-fast-reasoning";
8655
- readonly GROK_4_FAST_NON_REASONING: "grok-4-fast-non-reasoning";
8656
- readonly GROK_4_0709: "grok-4-0709";
8657
- readonly GROK_CODE_FAST_1: "grok-code-fast-1";
8658
- readonly GROK_3: "grok-3";
8659
- readonly GROK_3_MINI: "grok-3-mini";
8660
- readonly GROK_2_VISION_1212: "grok-2-vision-1212";
8661
- };
8662
- };
8663
- /**
8664
- * Complete model registry with all model metadata
8665
- * Updated: January 2026 - Verified from official vendor documentation
8666
- */
8667
- declare const MODEL_REGISTRY: Record<string, ILLMDescription>;
8668
- /**
8669
- * Get model information by name
8670
- * @param modelName The model identifier
8671
- * @returns Model description or undefined if not found
8672
- */
8673
- declare function getModelInfo(modelName: string): ILLMDescription | undefined;
8674
- /**
8675
- * Get all models for a specific vendor
8676
- * @param vendor The vendor to filter by
8677
- * @returns Array of model descriptions for the vendor
8678
- */
8679
- declare function getModelsByVendor(vendor: Vendor): ILLMDescription[];
8680
- /**
8681
- * Get all currently active models
8682
- * @returns Array of active model descriptions
8683
- */
8684
- declare function getActiveModels(): ILLMDescription[];
8685
- /**
8686
- * Calculate the cost for a given model and token usage
8687
- * @param model Model name
8688
- * @param inputTokens Number of input tokens
8689
- * @param outputTokens Number of output tokens
8690
- * @param options Optional calculation options
8691
- * @returns Total cost in dollars, or null if model not found
8722
+ * Factory function for creating FileMediaStorage instances
8692
8723
  */
8693
- declare function calculateCost(model: string, inputTokens: number, outputTokens: number, options?: {
8694
- useCachedInput?: boolean;
8695
- }): number | null;
8724
+ declare function createFileMediaStorage(config?: FileMediaStorageConfig): FileMediaStorage;
8696
8725
 
8697
8726
  /**
8698
8727
  * Video Model Registry
@@ -9361,98 +9390,6 @@ declare class ProviderErrorMapper {
9361
9390
  private static extractRetryAfter;
9362
9391
  }
9363
9392
 
9364
- /**
9365
- * Services - Single source of truth for external service definitions
9366
- *
9367
- * All service metadata is defined in one place (SERVICE_DEFINITIONS).
9368
- * Other exports are derived from this to maintain DRY principles.
9369
- */
9370
- /**
9371
- * Service category type
9372
- */
9373
- type ServiceCategory = 'major-vendors' | 'communication' | 'development' | 'productivity' | 'crm' | 'payments' | 'cloud' | 'storage' | 'email' | 'monitoring' | 'search' | 'scrape' | 'other';
9374
- /**
9375
- * Complete service definition - single source of truth
9376
- */
9377
- interface ServiceDefinition {
9378
- /** Unique identifier (e.g., 'slack', 'github') */
9379
- id: string;
9380
- /** Human-readable name (e.g., 'Slack', 'GitHub') */
9381
- name: string;
9382
- /** Service category */
9383
- category: ServiceCategory;
9384
- /** URL pattern for auto-detection from baseURL */
9385
- urlPattern: RegExp;
9386
- /** Default base URL for API calls */
9387
- baseURL: string;
9388
- /** Documentation URL */
9389
- docsURL?: string;
9390
- /** Common OAuth scopes */
9391
- commonScopes?: string[];
9392
- }
9393
- /**
9394
- * Master list of all service definitions
9395
- * This is the SINGLE SOURCE OF TRUTH - all other exports derive from this
9396
- */
9397
- declare const SERVICE_DEFINITIONS: readonly ServiceDefinition[];
9398
- /**
9399
- * Service type - union of all service IDs
9400
- */
9401
- type ServiceType = (typeof SERVICE_DEFINITIONS)[number]['id'];
9402
- /**
9403
- * Services constant object for easy access
9404
- * Usage: Services.Slack, Services.GitHub, etc.
9405
- */
9406
- declare const Services: { [K in string]: ServiceType; };
9407
- /**
9408
- * URL patterns for auto-detection (derived from SERVICE_DEFINITIONS)
9409
- */
9410
- declare const SERVICE_URL_PATTERNS: ReadonlyArray<{
9411
- service: string;
9412
- pattern: RegExp;
9413
- }>;
9414
- /**
9415
- * Service info lookup (derived from SERVICE_DEFINITIONS)
9416
- */
9417
- interface ServiceInfo {
9418
- id: string;
9419
- name: string;
9420
- category: ServiceCategory;
9421
- baseURL: string;
9422
- docsURL?: string;
9423
- commonScopes?: string[];
9424
- }
9425
- /**
9426
- * Service info map (derived from SERVICE_DEFINITIONS)
9427
- */
9428
- declare const SERVICE_INFO: Record<string, ServiceInfo>;
9429
- /**
9430
- * Detect service type from a URL
9431
- * @param url - Base URL or full URL to check
9432
- * @returns Service type string or undefined if not recognized
9433
- */
9434
- declare function detectServiceFromURL(url: string): string | undefined;
9435
- /**
9436
- * Get service info by service type
9437
- */
9438
- declare function getServiceInfo(serviceType: string): ServiceInfo | undefined;
9439
- /**
9440
- * Get service definition by service type
9441
- */
9442
- declare function getServiceDefinition(serviceType: string): ServiceDefinition | undefined;
9443
- /**
9444
- * Get all services in a category
9445
- */
9446
- declare function getServicesByCategory(category: ServiceCategory): ServiceDefinition[];
9447
- /**
9448
- * Get all service IDs
9449
- */
9450
- declare function getAllServiceIds(): string[];
9451
- /**
9452
- * Check if a service ID is known
9453
- */
9454
- declare function isKnownService(serviceId: string): boolean;
9455
-
9456
9393
  /**
9457
9394
  * ConnectorTools - Generate tools from Connectors
9458
9395
  *
@@ -10090,6 +10027,14 @@ declare class ConnectorConfigStore {
10090
10027
  * Decrypt secrets in ConnectorAuth based on auth type
10091
10028
  */
10092
10029
  private decryptAuthSecrets;
10030
+ /**
10031
+ * Encrypt all values in an extra Record (vendor-specific credentials)
10032
+ */
10033
+ private encryptExtra;
10034
+ /**
10035
+ * Decrypt all values in an extra Record (vendor-specific credentials)
10036
+ */
10037
+ private decryptExtra;
10093
10038
  /**
10094
10039
  * Encrypt a single value if not already encrypted
10095
10040
  */
@@ -10222,7 +10167,7 @@ interface AuthTemplate {
10222
10167
  /**
10223
10168
  * Known fields that can be required/optional in auth templates
10224
10169
  */
10225
- type AuthTemplateField = 'apiKey' | 'clientId' | 'clientSecret' | 'redirectUri' | 'scope' | 'privateKey' | 'privateKeyPath' | 'appId' | 'installationId' | 'tenantId' | 'username' | 'subject' | 'audience' | 'userScope' | 'accountId' | 'subdomain' | 'region' | 'accessKeyId' | 'secretAccessKey' | 'applicationKey';
10170
+ type AuthTemplateField = 'apiKey' | 'clientId' | 'clientSecret' | 'redirectUri' | 'scope' | 'privateKey' | 'privateKeyPath' | 'appId' | 'installationId' | 'tenantId' | 'username' | 'subject' | 'audience' | 'userScope' | 'accountId' | 'subdomain' | 'region' | 'accessKeyId' | 'secretAccessKey' | 'applicationKey' | 'appToken' | 'signingSecret';
10226
10171
  /**
10227
10172
  * Vendor template definition
10228
10173
  * Complete configuration for a vendor's supported authentication methods
@@ -11624,84 +11569,34 @@ declare function createExecuteJavaScriptTool(): ToolFunction<ExecuteJSArgs, Exec
11624
11569
  declare const executeJavaScript: ToolFunction<ExecuteJSArgs, ExecuteJSResult>;
11625
11570
 
11626
11571
  /**
11627
- * Interface for handling multimedia output storage
11628
- *
11629
- * Allows library consumers to plug in custom storage backends (S3, GCS, etc.)
11630
- * Default implementation: FileMediaOutputHandler (local filesystem)
11631
- */
11632
- interface MediaOutputMetadata {
11633
- /** Type of media being saved */
11634
- type: 'image' | 'video' | 'audio';
11635
- /** File format (png, mp4, mp3, etc.) */
11636
- format: string;
11637
- /** Model used for generation */
11638
- model: string;
11639
- /** Vendor that produced the output */
11640
- vendor: string;
11641
- /** Index for multi-image results */
11642
- index?: number;
11643
- /** Suggested filename (without path) */
11644
- suggestedFilename?: string;
11645
- }
11646
- interface MediaOutputResult {
11647
- /** Location of the saved file (file path, URL, S3 key - depends on handler) */
11648
- location: string;
11649
- /** MIME type of the saved file */
11650
- mimeType: string;
11651
- /** File size in bytes */
11652
- size: number;
11653
- }
11654
- interface IMediaOutputHandler {
11655
- /**
11656
- * Save media data to storage
11657
- *
11658
- * @param data - Raw media data as Buffer
11659
- * @param metadata - Information about the media for naming/organization
11660
- * @returns Location and metadata of the saved file
11661
- */
11662
- save(data: Buffer, metadata: MediaOutputMetadata): Promise<MediaOutputResult>;
11663
- }
11664
-
11665
- /**
11666
- * Default filesystem-based media output handler
11667
- *
11668
- * Saves generated media to a configurable directory on the local filesystem.
11669
- * Default output directory: `os.tmpdir()/oneringai-media/`
11670
- */
11671
-
11672
- declare class FileMediaOutputHandler implements IMediaOutputHandler {
11673
- private outputDir;
11674
- private initialized;
11675
- constructor(outputDir?: string);
11676
- save(data: Buffer, metadata: MediaOutputMetadata): Promise<MediaOutputResult>;
11677
- private generateFilename;
11678
- }
11679
-
11680
- /**
11681
- * Module-level configuration for multimedia output handling
11572
+ * Module-level configuration for multimedia output storage
11682
11573
  *
11683
- * Provides a global default output handler used by all tool factories
11574
+ * Provides a global default media storage used by all tool factories
11684
11575
  * when called through ConnectorTools.registerService().
11685
11576
  *
11686
11577
  * @example
11687
11578
  * ```typescript
11688
- * import { setMediaOutputHandler } from '@everworker/oneringai';
11579
+ * import { setMediaStorage } from '@everworker/oneringai';
11689
11580
  *
11690
- * // Use custom S3 handler before creating agents
11691
- * setMediaOutputHandler(myS3Handler);
11581
+ * // Use custom S3 storage before creating agents
11582
+ * setMediaStorage(myS3Storage);
11692
11583
  * ```
11693
11584
  */
11694
11585
 
11695
11586
  /**
11696
- * Get the global media output handler (creates default FileMediaOutputHandler on first access)
11587
+ * Get the global media storage (creates default FileMediaStorage on first access)
11697
11588
  */
11698
- declare function getMediaOutputHandler(): IMediaOutputHandler;
11589
+ declare function getMediaStorage(): IMediaStorage;
11699
11590
  /**
11700
- * Set a custom global media output handler
11591
+ * Set a custom global media storage
11701
11592
  *
11702
11593
  * Call this before agent creation to use custom storage (S3, GCS, etc.)
11703
11594
  */
11704
- declare function setMediaOutputHandler(handler: IMediaOutputHandler): void;
11595
+ declare function setMediaStorage(storage: IMediaStorage): void;
11596
+ /** @deprecated Use `getMediaStorage()` instead */
11597
+ declare const getMediaOutputHandler: typeof getMediaStorage;
11598
+ /** @deprecated Use `setMediaStorage()` instead */
11599
+ declare const setMediaOutputHandler: typeof setMediaStorage;
11705
11600
 
11706
11601
  /**
11707
11602
  * Image generation tool factory
@@ -11728,7 +11623,7 @@ interface GenerateImageResult {
11728
11623
  }>;
11729
11624
  error?: string;
11730
11625
  }
11731
- declare function createImageGenerationTool(connector: Connector, outputHandler?: IMediaOutputHandler): ToolFunction<GenerateImageArgs, GenerateImageResult>;
11626
+ declare function createImageGenerationTool(connector: Connector, storage?: IMediaStorage, userId?: string): ToolFunction<GenerateImageArgs, GenerateImageResult>;
11732
11627
 
11733
11628
  /**
11734
11629
  * Video generation tool factories
@@ -11738,7 +11633,7 @@ declare function createImageGenerationTool(connector: Connector, outputHandler?:
11738
11633
  * so two tools are needed: one to start and one to check status/download.
11739
11634
  */
11740
11635
 
11741
- declare function createVideoTools(connector: Connector, outputHandler?: IMediaOutputHandler): ToolFunction[];
11636
+ declare function createVideoTools(connector: Connector, storage?: IMediaStorage, userId?: string): ToolFunction[];
11742
11637
 
11743
11638
  /**
11744
11639
  * Text-to-speech tool factory
@@ -11761,7 +11656,7 @@ interface TextToSpeechResult {
11761
11656
  mimeType?: string;
11762
11657
  error?: string;
11763
11658
  }
11764
- declare function createTextToSpeechTool(connector: Connector, outputHandler?: IMediaOutputHandler): ToolFunction<TextToSpeechArgs, TextToSpeechResult>;
11659
+ declare function createTextToSpeechTool(connector: Connector, storage?: IMediaStorage, userId?: string): ToolFunction<TextToSpeechArgs, TextToSpeechResult>;
11765
11660
 
11766
11661
  /**
11767
11662
  * Speech-to-text tool factory
@@ -11771,7 +11666,7 @@ declare function createTextToSpeechTool(connector: Connector, outputHandler?: IM
11771
11666
  */
11772
11667
 
11773
11668
  interface SpeechToTextArgs {
11774
- audioFilePath: string;
11669
+ audioSource: string;
11775
11670
  model?: string;
11776
11671
  language?: string;
11777
11672
  prompt?: string;
@@ -11783,13 +11678,348 @@ interface SpeechToTextResult {
11783
11678
  durationSeconds?: number;
11784
11679
  error?: string;
11785
11680
  }
11786
- declare function createSpeechToTextTool(connector: Connector): ToolFunction<SpeechToTextArgs, SpeechToTextResult>;
11681
+ declare function createSpeechToTextTool(connector: Connector, storage?: IMediaStorage, _userId?: string): ToolFunction<SpeechToTextArgs, SpeechToTextResult>;
11682
+
11683
+ /**
11684
+ * GitHub Tools - Shared Types and Helpers
11685
+ *
11686
+ * Foundation for all GitHub connector tools.
11687
+ * Provides repository resolution, authenticated fetch, and result types.
11688
+ */
11689
+
11690
+ /**
11691
+ * Parsed GitHub repository reference
11692
+ */
11693
+ interface GitHubRepository {
11694
+ owner: string;
11695
+ repo: string;
11696
+ }
11697
+ /**
11698
+ * Parse a repository string into owner and repo.
11699
+ *
11700
+ * Accepts:
11701
+ * - "owner/repo" format
11702
+ * - Full GitHub URLs: "https://github.com/owner/repo", "https://github.com/owner/repo/..."
11703
+ *
11704
+ * @throws Error if the format is not recognized
11705
+ */
11706
+ declare function parseRepository(input: string): GitHubRepository;
11707
+ /**
11708
+ * Resolve a repository from tool args or connector default.
11709
+ *
11710
+ * Priority:
11711
+ * 1. Explicit `repository` parameter
11712
+ * 2. `connector.getOptions().defaultRepository`
11713
+ *
11714
+ * @returns GitHubRepository or an error result
11715
+ */
11716
+ declare function resolveRepository(repository: string | undefined, connector: Connector): {
11717
+ success: true;
11718
+ repo: GitHubRepository;
11719
+ } | {
11720
+ success: false;
11721
+ error: string;
11722
+ };
11723
+ /**
11724
+ * Result from search_files tool
11725
+ */
11726
+ interface GitHubSearchFilesResult {
11727
+ success: boolean;
11728
+ files?: {
11729
+ path: string;
11730
+ size: number;
11731
+ type: string;
11732
+ }[];
11733
+ count?: number;
11734
+ truncated?: boolean;
11735
+ error?: string;
11736
+ }
11737
+ /**
11738
+ * Result from search_code tool
11739
+ */
11740
+ interface GitHubSearchCodeResult {
11741
+ success: boolean;
11742
+ matches?: {
11743
+ file: string;
11744
+ fragment?: string;
11745
+ }[];
11746
+ count?: number;
11747
+ truncated?: boolean;
11748
+ error?: string;
11749
+ }
11750
+ /**
11751
+ * Result from read_file tool (GitHub variant)
11752
+ */
11753
+ interface GitHubReadFileResult {
11754
+ success: boolean;
11755
+ content?: string;
11756
+ path?: string;
11757
+ size?: number;
11758
+ lines?: number;
11759
+ truncated?: boolean;
11760
+ sha?: string;
11761
+ error?: string;
11762
+ }
11763
+ /**
11764
+ * Result from get_pr tool
11765
+ */
11766
+ interface GitHubGetPRResult {
11767
+ success: boolean;
11768
+ data?: {
11769
+ number: number;
11770
+ title: string;
11771
+ body: string | null;
11772
+ state: string;
11773
+ author: string;
11774
+ labels: string[];
11775
+ reviewers: string[];
11776
+ mergeable: boolean | null;
11777
+ head: string;
11778
+ base: string;
11779
+ url: string;
11780
+ created_at: string;
11781
+ updated_at: string;
11782
+ additions: number;
11783
+ deletions: number;
11784
+ changed_files: number;
11785
+ draft: boolean;
11786
+ };
11787
+ error?: string;
11788
+ }
11789
+ /**
11790
+ * Result from pr_files tool
11791
+ */
11792
+ interface GitHubPRFilesResult {
11793
+ success: boolean;
11794
+ files?: {
11795
+ filename: string;
11796
+ status: string;
11797
+ additions: number;
11798
+ deletions: number;
11799
+ changes: number;
11800
+ patch?: string;
11801
+ }[];
11802
+ count?: number;
11803
+ error?: string;
11804
+ }
11805
+ /**
11806
+ * A unified comment/review entry
11807
+ */
11808
+ interface GitHubPRCommentEntry {
11809
+ id: number;
11810
+ type: 'review' | 'comment' | 'review_comment';
11811
+ author: string;
11812
+ body: string;
11813
+ created_at: string;
11814
+ path?: string;
11815
+ line?: number;
11816
+ state?: string;
11817
+ }
11818
+ /**
11819
+ * Result from pr_comments tool
11820
+ */
11821
+ interface GitHubPRCommentsResult {
11822
+ success: boolean;
11823
+ comments?: GitHubPRCommentEntry[];
11824
+ count?: number;
11825
+ error?: string;
11826
+ }
11827
+ /**
11828
+ * Result from create_pr tool
11829
+ */
11830
+ interface GitHubCreatePRResult {
11831
+ success: boolean;
11832
+ data?: {
11833
+ number: number;
11834
+ url: string;
11835
+ state: string;
11836
+ title: string;
11837
+ };
11838
+ error?: string;
11839
+ }
11840
+
11841
+ /**
11842
+ * GitHub Search Files Tool
11843
+ *
11844
+ * Search for files by glob pattern in a GitHub repository.
11845
+ * Mirrors the local `glob` tool for remote GitHub repos.
11846
+ *
11847
+ * Uses the Git Trees API to fetch the full file tree, then filters client-side.
11848
+ */
11849
+
11850
+ /**
11851
+ * Arguments for the search_files tool
11852
+ */
11853
+ interface SearchFilesArgs {
11854
+ /** Repository in "owner/repo" format or full GitHub URL */
11855
+ repository?: string;
11856
+ /** Glob pattern to match files (e.g., "**\/*.ts", "src/**\/*.tsx") */
11857
+ pattern: string;
11858
+ /** Branch, tag, or SHA (defaults to repo's default branch) */
11859
+ ref?: string;
11860
+ }
11861
+ /**
11862
+ * Create a GitHub search_files tool
11863
+ */
11864
+ declare function createSearchFilesTool(connector: Connector, userId?: string): ToolFunction<SearchFilesArgs, GitHubSearchFilesResult>;
11865
+
11866
+ /**
11867
+ * GitHub Search Code Tool
11868
+ *
11869
+ * Search for code content across a GitHub repository.
11870
+ * Mirrors the local `grep` tool for remote GitHub repos.
11871
+ *
11872
+ * Uses the GitHub Code Search API with text-match support.
11873
+ *
11874
+ * Note: GitHub's code search API has a rate limit of 30 requests/minute.
11875
+ */
11876
+
11877
+ /**
11878
+ * Arguments for the search_code tool
11879
+ */
11880
+ interface SearchCodeArgs {
11881
+ /** Repository in "owner/repo" format or full GitHub URL */
11882
+ repository?: string;
11883
+ /** Search query (keyword or phrase) */
11884
+ query: string;
11885
+ /** Filter by programming language (e.g., "typescript", "python") */
11886
+ language?: string;
11887
+ /** Filter by file path (e.g., "src/", "lib/utils") */
11888
+ path?: string;
11889
+ /** Filter by file extension (e.g., "ts", "py") */
11890
+ extension?: string;
11891
+ /** Maximum number of results (default: 30, max: 100) */
11892
+ limit?: number;
11893
+ }
11894
+ /**
11895
+ * Create a GitHub search_code tool
11896
+ */
11897
+ declare function createSearchCodeTool(connector: Connector, userId?: string): ToolFunction<SearchCodeArgs, GitHubSearchCodeResult>;
11898
+
11899
+ /**
11900
+ * GitHub Read File Tool
11901
+ *
11902
+ * Read file content from a GitHub repository.
11903
+ * Mirrors the local `read_file` tool for remote GitHub repos.
11904
+ *
11905
+ * Supports line range selection (offset/limit) and formats output
11906
+ * with line numbers matching the local read_file tool.
11907
+ */
11908
+
11909
+ /**
11910
+ * Arguments for the GitHub read_file tool
11911
+ */
11912
+ interface GitHubReadFileArgs {
11913
+ /** Repository in "owner/repo" format or full GitHub URL */
11914
+ repository?: string;
11915
+ /** File path within the repository (e.g., "src/index.ts") */
11916
+ path: string;
11917
+ /** Branch, tag, or commit SHA. Defaults to the repository's default branch. */
11918
+ ref?: string;
11919
+ /** Line number to start reading from (1-indexed). Useful for large files. */
11920
+ offset?: number;
11921
+ /** Number of lines to read (default: 2000). */
11922
+ limit?: number;
11923
+ }
11924
+ /**
11925
+ * Create a GitHub read_file tool
11926
+ */
11927
+ declare function createGitHubReadFileTool(connector: Connector, userId?: string): ToolFunction<GitHubReadFileArgs, GitHubReadFileResult>;
11928
+
11929
+ /**
11930
+ * GitHub Get PR Tool
11931
+ *
11932
+ * Get full details of a pull request from a GitHub repository.
11933
+ */
11934
+
11935
+ /**
11936
+ * Arguments for the get_pr tool
11937
+ */
11938
+ interface GetPRArgs {
11939
+ /** Repository in "owner/repo" format or full GitHub URL */
11940
+ repository?: string;
11941
+ /** Pull request number */
11942
+ pull_number: number;
11943
+ }
11944
+ /**
11945
+ * Create a GitHub get_pr tool
11946
+ */
11947
+ declare function createGetPRTool(connector: Connector, userId?: string): ToolFunction<GetPRArgs, GitHubGetPRResult>;
11948
+
11949
+ /**
11950
+ * GitHub PR Files Tool
11951
+ *
11952
+ * Get the files changed in a pull request, including diffs.
11953
+ */
11954
+
11955
+ /**
11956
+ * Arguments for the pr_files tool
11957
+ */
11958
+ interface PRFilesArgs {
11959
+ /** Repository in "owner/repo" format or full GitHub URL */
11960
+ repository?: string;
11961
+ /** Pull request number */
11962
+ pull_number: number;
11963
+ }
11964
+ /**
11965
+ * Create a GitHub pr_files tool
11966
+ */
11967
+ declare function createPRFilesTool(connector: Connector, userId?: string): ToolFunction<PRFilesArgs, GitHubPRFilesResult>;
11968
+
11969
+ /**
11970
+ * GitHub PR Comments Tool
11971
+ *
11972
+ * Get all comments and reviews on a pull request.
11973
+ * Merges three types: review comments (line-level), reviews, and issue comments.
11974
+ */
11975
+
11976
+ /**
11977
+ * Arguments for the pr_comments tool
11978
+ */
11979
+ interface PRCommentsArgs {
11980
+ /** Repository in "owner/repo" format or full GitHub URL */
11981
+ repository?: string;
11982
+ /** Pull request number */
11983
+ pull_number: number;
11984
+ }
11985
+ /**
11986
+ * Create a GitHub pr_comments tool
11987
+ */
11988
+ declare function createPRCommentsTool(connector: Connector, userId?: string): ToolFunction<PRCommentsArgs, GitHubPRCommentsResult>;
11989
+
11990
+ /**
11991
+ * GitHub Create PR Tool
11992
+ *
11993
+ * Create a pull request on a GitHub repository.
11994
+ */
11995
+
11996
+ /**
11997
+ * Arguments for the create_pr tool
11998
+ */
11999
+ interface CreatePRArgs {
12000
+ /** Repository in "owner/repo" format or full GitHub URL */
12001
+ repository?: string;
12002
+ /** Pull request title */
12003
+ title: string;
12004
+ /** Pull request description/body (Markdown supported) */
12005
+ body?: string;
12006
+ /** Source branch name (the branch with your changes) */
12007
+ head: string;
12008
+ /** Target branch name (the branch you want to merge into) */
12009
+ base: string;
12010
+ /** Create as a draft pull request */
12011
+ draft?: boolean;
12012
+ }
12013
+ /**
12014
+ * Create a GitHub create_pr tool
12015
+ */
12016
+ declare function createCreatePRTool(connector: Connector, userId?: string): ToolFunction<CreatePRArgs, GitHubCreatePRResult>;
11787
12017
 
11788
12018
  /**
11789
12019
  * AUTO-GENERATED FILE - DO NOT EDIT MANUALLY
11790
12020
  *
11791
12021
  * Generated by: scripts/generate-tool-registry.ts
11792
- * Generated at: 2026-02-07T08:56:13.394Z
12022
+ * Generated at: 2026-02-08T21:31:53.497Z
11793
12023
  *
11794
12024
  * To regenerate: npm run generate:tools
11795
12025
  */
@@ -11970,18 +12200,22 @@ declare const index_ConnectorTools: typeof ConnectorTools;
11970
12200
  declare const index_DEFAULT_FILESYSTEM_CONFIG: typeof DEFAULT_FILESYSTEM_CONFIG;
11971
12201
  declare const index_DEFAULT_SHELL_CONFIG: typeof DEFAULT_SHELL_CONFIG;
11972
12202
  type index_EditFileResult = EditFileResult;
11973
- type index_FileMediaOutputHandler = FileMediaOutputHandler;
11974
- declare const index_FileMediaOutputHandler: typeof FileMediaOutputHandler;
11975
12203
  type index_FilesystemToolConfig = FilesystemToolConfig;
11976
12204
  type index_GenericAPICallArgs = GenericAPICallArgs;
11977
12205
  type index_GenericAPICallResult = GenericAPICallResult;
11978
12206
  type index_GenericAPIToolOptions = GenericAPIToolOptions;
12207
+ type index_GitHubCreatePRResult = GitHubCreatePRResult;
12208
+ type index_GitHubGetPRResult = GitHubGetPRResult;
12209
+ type index_GitHubPRCommentEntry = GitHubPRCommentEntry;
12210
+ type index_GitHubPRCommentsResult = GitHubPRCommentsResult;
12211
+ type index_GitHubPRFilesResult = GitHubPRFilesResult;
12212
+ type index_GitHubReadFileResult = GitHubReadFileResult;
12213
+ type index_GitHubRepository = GitHubRepository;
12214
+ type index_GitHubSearchCodeResult = GitHubSearchCodeResult;
12215
+ type index_GitHubSearchFilesResult = GitHubSearchFilesResult;
11979
12216
  type index_GlobResult = GlobResult;
11980
12217
  type index_GrepMatch = GrepMatch;
11981
12218
  type index_GrepResult = GrepResult;
11982
- type index_IMediaOutputHandler = IMediaOutputHandler;
11983
- type index_MediaOutputMetadata = MediaOutputMetadata;
11984
- type index_MediaOutputResult = MediaOutputResult;
11985
12219
  type index_ReadFileResult = ReadFileResult;
11986
12220
  type index_SearchResult = SearchResult;
11987
12221
  type index_ServiceToolFactory = ServiceToolFactory;
@@ -11993,13 +12227,20 @@ type index_ToolRegistryEntry = ToolRegistryEntry;
11993
12227
  type index_WriteFileResult = WriteFileResult;
11994
12228
  declare const index_bash: typeof bash;
11995
12229
  declare const index_createBashTool: typeof createBashTool;
12230
+ declare const index_createCreatePRTool: typeof createCreatePRTool;
11996
12231
  declare const index_createEditFileTool: typeof createEditFileTool;
11997
12232
  declare const index_createExecuteJavaScriptTool: typeof createExecuteJavaScriptTool;
12233
+ declare const index_createGetPRTool: typeof createGetPRTool;
12234
+ declare const index_createGitHubReadFileTool: typeof createGitHubReadFileTool;
11998
12235
  declare const index_createGlobTool: typeof createGlobTool;
11999
12236
  declare const index_createGrepTool: typeof createGrepTool;
12000
12237
  declare const index_createImageGenerationTool: typeof createImageGenerationTool;
12001
12238
  declare const index_createListDirectoryTool: typeof createListDirectoryTool;
12239
+ declare const index_createPRCommentsTool: typeof createPRCommentsTool;
12240
+ declare const index_createPRFilesTool: typeof createPRFilesTool;
12002
12241
  declare const index_createReadFileTool: typeof createReadFileTool;
12242
+ declare const index_createSearchCodeTool: typeof createSearchCodeTool;
12243
+ declare const index_createSearchFilesTool: typeof createSearchFilesTool;
12003
12244
  declare const index_createSpeechToTextTool: typeof createSpeechToTextTool;
12004
12245
  declare const index_createTextToSpeechTool: typeof createTextToSpeechTool;
12005
12246
  declare const index_createVideoTools: typeof createVideoTools;
@@ -12011,6 +12252,7 @@ declare const index_expandTilde: typeof expandTilde;
12011
12252
  declare const index_getAllBuiltInTools: typeof getAllBuiltInTools;
12012
12253
  declare const index_getBackgroundOutput: typeof getBackgroundOutput;
12013
12254
  declare const index_getMediaOutputHandler: typeof getMediaOutputHandler;
12255
+ declare const index_getMediaStorage: typeof getMediaStorage;
12014
12256
  declare const index_getToolByName: typeof getToolByName;
12015
12257
  declare const index_getToolCategories: typeof getToolCategories;
12016
12258
  declare const index_getToolRegistry: typeof getToolRegistry;
@@ -12023,8 +12265,11 @@ declare const index_isExcludedExtension: typeof isExcludedExtension;
12023
12265
  declare const index_jsonManipulator: typeof jsonManipulator;
12024
12266
  declare const index_killBackgroundProcess: typeof killBackgroundProcess;
12025
12267
  declare const index_listDirectory: typeof listDirectory;
12268
+ declare const index_parseRepository: typeof parseRepository;
12026
12269
  declare const index_readFile: typeof readFile;
12270
+ declare const index_resolveRepository: typeof resolveRepository;
12027
12271
  declare const index_setMediaOutputHandler: typeof setMediaOutputHandler;
12272
+ declare const index_setMediaStorage: typeof setMediaStorage;
12028
12273
  declare const index_toolRegistry: typeof toolRegistry;
12029
12274
  declare const index_validatePath: typeof validatePath;
12030
12275
  declare const index_webFetch: typeof webFetch;
@@ -12033,7 +12278,7 @@ declare const index_webScrape: typeof webScrape;
12033
12278
  declare const index_webSearch: typeof webSearch;
12034
12279
  declare const index_writeFile: typeof writeFile;
12035
12280
  declare namespace index {
12036
- 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 };
12281
+ 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 };
12037
12282
  }
12038
12283
 
12039
12284
  /**
@@ -12088,4 +12333,4 @@ declare class ProviderConfigAgent {
12088
12333
  reset(): void;
12089
12334
  }
12090
12335
 
12091
- 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, type InstructionEntry, 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 };
12336
+ 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 };