@everworker/oneringai 0.1.3 → 0.2.0

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,14 @@
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, c as IProvider, d as ConnectorFetchOptions, P as ProviderCapabilities, e as ITokenStorage, S as StoredToken$1, f as ConnectorConfig, g as ConnectorAuth, h as ConnectorConfigResult } from './IProvider-c4QCbPjn.cjs';
2
+ export { A as APIKeyConnectorAuth, k as DEFAULT_BASE_DELAY_MS, D as DEFAULT_CONNECTOR_TIMEOUT, l as DEFAULT_MAX_DELAY_MS, i as DEFAULT_MAX_RETRIES, j as DEFAULT_RETRYABLE_STATUSES, J as JWTConnectorAuth, O as OAuthConnectorAuth } from './IProvider-c4QCbPjn.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-MJ14lkui.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-MJ14lkui.cjs';
5
5
  import { EventEmitter } from 'eventemitter3';
6
- import { I as IProvider, P as ProviderCapabilities } from './IProvider-BP49c93d.cjs';
6
+ import { V as Vendor } from './Vendor-DYh_bzwo.cjs';
7
+ export { a as VENDORS, i as isVendor } from './Vendor-DYh_bzwo.cjs';
8
+ import { A as AudioFormat, I as IBaseModelDescription, V as VendorOptionSchema, a as IImageProvider } from './ImageModel-BWN6VVS6.cjs';
9
+ export { r as AspectRatio, d as IImageModelDescription, g as IMAGE_MODELS, h as IMAGE_MODEL_REGISTRY, s as ISourceLinks, o as ImageEditOptions, n as ImageGenerateOptions, b as ImageGeneration, c as ImageGenerationCreateOptions, e as ImageModelCapabilities, f as ImageModelPricing, q as ImageResponse, p as ImageVariationOptions, O as OutputFormat, Q as QualityLevel, S as SimpleGenerateOptions, m as calculateImageCost, k as getActiveImageModels, i as getImageModelInfo, j as getImageModelsByVendor, l as getImageModelsWithFeature } from './ImageModel-BWN6VVS6.cjs';
10
+ import { ServiceCategory } from './shared/index.cjs';
11
+ 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
12
 
8
13
  /**
9
14
  * ScopedConnectorRegistry - Filtered view over the Connector registry
@@ -504,6 +509,18 @@ interface SerializedToolState {
504
509
  permissions?: Record<string, ToolPermissionConfig$1>;
505
510
  }
506
511
  type ToolManagerEvent = 'tool:registered' | 'tool:unregistered' | 'tool:enabled' | 'tool:disabled' | 'tool:executed' | 'namespace:enabled' | 'namespace:disabled';
512
+ /**
513
+ * Configuration for ToolManager
514
+ */
515
+ interface ToolManagerConfig {
516
+ /**
517
+ * Hard timeout in milliseconds for any single tool execution.
518
+ * Acts as a safety net: if a tool's own timeout mechanism fails
519
+ * (e.g. child process doesn't exit), this will force-resolve with an error.
520
+ * Default: 0 (disabled - relies on tool's own timeout)
521
+ */
522
+ toolExecutionTimeout?: number;
523
+ }
507
524
  declare class ToolManager extends EventEmitter implements IToolExecutor, IDisposable {
508
525
  private registry;
509
526
  private namespaceIndex;
@@ -513,7 +530,15 @@ declare class ToolManager extends EventEmitter implements IToolExecutor, IDispos
513
530
  private pipeline;
514
531
  /** Optional tool context for execution (set by agent before runs) */
515
532
  private _toolContext;
516
- constructor();
533
+ /** Hard timeout for tool execution (0 = disabled) */
534
+ private _toolExecutionTimeout;
535
+ constructor(config?: ToolManagerConfig);
536
+ /**
537
+ * Get or set the hard tool execution timeout in milliseconds.
538
+ * 0 = disabled (relies on tool's own timeout).
539
+ */
540
+ get toolExecutionTimeout(): number;
541
+ set toolExecutionTimeout(value: number);
517
542
  /**
518
543
  * Access the execution pipeline for plugin management.
519
544
  *
@@ -720,6 +745,11 @@ declare class ToolManager extends EventEmitter implements IToolExecutor, IDispos
720
745
  * List all registered tool names (IToolExecutor interface - delegates to list())
721
746
  */
722
747
  listTools(): string[];
748
+ /**
749
+ * Wrap a promise with a hard timeout safety net.
750
+ * If the promise doesn't resolve within the timeout, throws ToolExecutionError.
751
+ */
752
+ private withHardTimeout;
723
753
  /**
724
754
  * Get or create circuit breaker for a tool
725
755
  */
@@ -1306,6 +1336,7 @@ interface SerializedContextState {
1306
1336
  metadata: {
1307
1337
  savedAt: number;
1308
1338
  agentId?: string;
1339
+ userId?: string;
1309
1340
  model: string;
1310
1341
  };
1311
1342
  /** Agent-specific state (for TaskAgent, UniversalAgent, etc.) */
@@ -1884,12 +1915,28 @@ interface AgentContextNextGenConfig {
1884
1915
  features?: ContextFeatures;
1885
1916
  /** Agent ID (required for PersistentInstructions) */
1886
1917
  agentId?: string;
1918
+ /** User ID for multi-user scenarios. Automatically flows to ToolContext for all tool executions. */
1919
+ userId?: string;
1920
+ /**
1921
+ * Restrict this agent to a subset of registered connectors (by name).
1922
+ * When set, only these connectors are visible in ToolContext.connectorRegistry
1923
+ * and in dynamic tool descriptions (e.g., execute_javascript).
1924
+ * When not set, all connectors visible to the current userId are available.
1925
+ */
1926
+ connectors?: string[];
1887
1927
  /** Initial tools to register */
1888
1928
  tools?: ToolFunction[];
1889
1929
  /** Storage for session persistence */
1890
1930
  storage?: IContextStorage;
1891
1931
  /** Plugin-specific configurations (used with features flags) */
1892
1932
  plugins?: PluginConfigs;
1933
+ /**
1934
+ * Hard timeout in milliseconds for any single tool execution.
1935
+ * Acts as a safety net: if a tool's own timeout mechanism fails
1936
+ * (e.g. a child process doesn't exit), this will force-resolve with an error.
1937
+ * Default: 0 (disabled - relies on each tool's own timeout)
1938
+ */
1939
+ toolExecutionTimeout?: number;
1893
1940
  }
1894
1941
  /**
1895
1942
  * Default configuration values
@@ -2303,6 +2350,10 @@ declare class AgentContextNextGen extends EventEmitter<ContextEvents> {
2303
2350
  private _sessionId;
2304
2351
  /** Agent ID */
2305
2352
  private readonly _agentId;
2353
+ /** User ID for multi-user scenarios */
2354
+ private _userId;
2355
+ /** Allowed connector names (when agent is restricted to a subset) */
2356
+ private _allowedConnectors;
2306
2357
  /** Storage backend */
2307
2358
  private readonly _storage?;
2308
2359
  /** Destroyed flag */
@@ -2326,12 +2377,34 @@ declare class AgentContextNextGen extends EventEmitter<ContextEvents> {
2326
2377
  * @throws Error if any required plugin is missing
2327
2378
  */
2328
2379
  private validateStrategyDependencies;
2380
+ /**
2381
+ * Sync identity fields and connector registry to ToolContext.
2382
+ * Merges with existing ToolContext to preserve other fields (memory, signal, taskId).
2383
+ *
2384
+ * Connector registry resolution order:
2385
+ * 1. If `connectors` (allowed names) is set → filtered view of global registry
2386
+ * 2. If access policy + userId → scoped view via Connector.scoped()
2387
+ * 3. Otherwise → full global registry
2388
+ */
2389
+ private syncToolContext;
2390
+ /**
2391
+ * Build the connector registry appropriate for this agent's config.
2392
+ */
2393
+ private buildConnectorRegistry;
2329
2394
  /** Get the tool manager */
2330
2395
  get tools(): ToolManager;
2331
2396
  /** Get the model name */
2332
2397
  get model(): string;
2333
2398
  /** Get the agent ID */
2334
2399
  get agentId(): string;
2400
+ /** Get the current user ID */
2401
+ get userId(): string | undefined;
2402
+ /** Set user ID. Automatically updates ToolContext for all tool executions. */
2403
+ set userId(value: string | undefined);
2404
+ /** Get the allowed connector names (undefined = all visible connectors) */
2405
+ get connectors(): string[] | undefined;
2406
+ /** Set allowed connector names. Updates ToolContext.connectorRegistry. */
2407
+ set connectors(value: string[] | undefined);
2335
2408
  /** Get/set system prompt */
2336
2409
  get systemPrompt(): string | undefined;
2337
2410
  set systemPrompt(value: string | undefined);
@@ -2743,6 +2816,14 @@ interface BaseAgentConfig {
2743
2816
  registry?: IConnectorRegistry;
2744
2817
  /** Agent name (optional, auto-generated if not provided) */
2745
2818
  name?: string;
2819
+ /** User ID for multi-user scenarios. Flows to ToolContext automatically for all tool executions. */
2820
+ userId?: string;
2821
+ /**
2822
+ * Restrict this agent to a subset of registered connectors (by name).
2823
+ * Only these connectors will be visible in tool descriptions and sandbox execution.
2824
+ * When not set, all connectors visible to the current userId are available.
2825
+ */
2826
+ connectors?: string[];
2746
2827
  /** Tools available to the agent */
2747
2828
  tools?: ToolFunction[];
2748
2829
  /** Provide a pre-configured ToolManager (advanced) */
@@ -2753,6 +2834,13 @@ interface BaseAgentConfig {
2753
2834
  permissions?: AgentPermissionsConfig;
2754
2835
  /** Lifecycle hooks for customization */
2755
2836
  lifecycleHooks?: AgentLifecycleHooks;
2837
+ /**
2838
+ * Hard timeout in milliseconds for any single tool execution.
2839
+ * Acts as a safety net at the ToolManager level: if a tool's own timeout
2840
+ * mechanism fails, this will force-reject with an error.
2841
+ * Default: 0 (disabled - relies on each tool's own timeout).
2842
+ */
2843
+ toolExecutionTimeout?: number;
2756
2844
  /**
2757
2845
  * Optional AgentContextNextGen configuration.
2758
2846
  * If provided as AgentContextNextGen instance, it will be used directly.
@@ -2905,6 +2993,22 @@ declare abstract class BaseAgent<TConfig extends BaseAgentConfig = BaseAgentConf
2905
2993
  * This is the primary way to access tools, memory, and history.
2906
2994
  */
2907
2995
  get context(): AgentContextNextGen;
2996
+ /**
2997
+ * Get the current user ID. Delegates to AgentContextNextGen.
2998
+ */
2999
+ get userId(): string | undefined;
3000
+ /**
3001
+ * Set user ID at runtime. Automatically updates ToolContext for all tool executions.
3002
+ */
3003
+ set userId(value: string | undefined);
3004
+ /**
3005
+ * Get the allowed connector names (undefined = all visible connectors).
3006
+ */
3007
+ get connectors(): string[] | undefined;
3008
+ /**
3009
+ * Restrict this agent to a subset of connectors. Updates ToolContext.connectorRegistry.
3010
+ */
3011
+ set connectors(value: string[] | undefined);
2908
3012
  /**
2909
3013
  * Permission management. Returns ToolPermissionManager for approval control.
2910
3014
  */
@@ -3239,8 +3343,16 @@ interface AgentConfig$1 extends BaseAgentConfig {
3239
3343
  */
3240
3344
  context?: AgentContextNextGen | AgentContextNextGenConfig;
3241
3345
  /**
3242
- * @deprecated Tool timeouts are now handled by ToolManager per-tool.
3243
- * Configure timeouts in individual tool definitions instead.
3346
+ * Hard timeout in milliseconds for any single tool execution.
3347
+ * Acts as a safety net: if a tool's own timeout mechanism fails
3348
+ * (e.g. a spawned child process doesn't exit), this will force-resolve
3349
+ * with an error. Default: 0 (disabled - relies on each tool's own timeout).
3350
+ *
3351
+ * Example: `toolExecutionTimeout: 300000` (5 minutes hard cap per tool call)
3352
+ */
3353
+ toolExecutionTimeout?: number;
3354
+ /**
3355
+ * @deprecated Use `toolExecutionTimeout` instead.
3244
3356
  */
3245
3357
  toolTimeout?: number;
3246
3358
  hooks?: HookConfig;
@@ -3284,6 +3396,7 @@ declare class Agent extends BaseAgent<AgentConfig$1, AgentEvents> implements IDi
3284
3396
  * const agent = Agent.create({
3285
3397
  * connector: 'openai', // or Connector instance
3286
3398
  * model: 'gpt-4',
3399
+ * userId: 'user-123', // flows to all tool executions automatically
3287
3400
  * instructions: 'You are a helpful assistant',
3288
3401
  * tools: [myTool]
3289
3402
  * });
@@ -3819,6 +3932,8 @@ interface InContextEntry {
3819
3932
  value: unknown;
3820
3933
  updatedAt: number;
3821
3934
  priority: InContextPriority;
3935
+ /** If true, this entry is displayed in the user's side panel UI */
3936
+ showInUI?: boolean;
3822
3937
  }
3823
3938
  interface InContextMemoryConfig {
3824
3939
  /** Maximum number of entries (default: 20) */
@@ -3829,6 +3944,8 @@ interface InContextMemoryConfig {
3829
3944
  defaultPriority?: InContextPriority;
3830
3945
  /** Whether to show timestamps in output (default: false) */
3831
3946
  showTimestamps?: boolean;
3947
+ /** Callback fired when entries change. Receives all current entries. */
3948
+ onEntriesChanged?: (entries: InContextEntry[]) => void;
3832
3949
  }
3833
3950
  interface SerializedInContextMemoryState {
3834
3951
  entries: InContextEntry[];
@@ -3841,6 +3958,7 @@ declare class InContextMemoryPluginNextGen implements IContextPluginNextGen {
3841
3958
  private _destroyed;
3842
3959
  private _tokenCache;
3843
3960
  private _instructionsTokenCache;
3961
+ private _notifyTimer;
3844
3962
  constructor(config?: InContextMemoryConfig);
3845
3963
  getInstructions(): string;
3846
3964
  getContent(): Promise<string | null>;
@@ -3856,7 +3974,7 @@ declare class InContextMemoryPluginNextGen implements IContextPluginNextGen {
3856
3974
  /**
3857
3975
  * Store or update a key-value pair
3858
3976
  */
3859
- set(key: string, description: string, value: unknown, priority?: InContextPriority): void;
3977
+ set(key: string, description: string, value: unknown, priority?: InContextPriority, showInUI?: boolean): void;
3860
3978
  /**
3861
3979
  * Get a value by key
3862
3980
  */
@@ -3877,6 +3995,7 @@ declare class InContextMemoryPluginNextGen implements IContextPluginNextGen {
3877
3995
  description: string;
3878
3996
  priority: InContextPriority;
3879
3997
  updatedAt: number;
3998
+ showInUI: boolean;
3880
3999
  }>;
3881
4000
  /**
3882
4001
  * Clear all entries
@@ -3892,6 +4011,11 @@ declare class InContextMemoryPluginNextGen implements IContextPluginNextGen {
3892
4011
  * Critical entries are excluded.
3893
4012
  */
3894
4013
  private getEvictableEntries;
4014
+ /**
4015
+ * Debounced notification when entries change.
4016
+ * Calls config.onEntriesChanged with all current entries.
4017
+ */
4018
+ private notifyEntriesChanged;
3895
4019
  private assertNotDestroyed;
3896
4020
  private createContextSetTool;
3897
4021
  private createContextDeleteTool;
@@ -4290,6 +4414,12 @@ declare class StrategyRegistry {
4290
4414
  * It extracts credentials from the connector and instantiates the appropriate SDK.
4291
4415
  */
4292
4416
 
4417
+ /**
4418
+ * Get the default API base URL for a vendor.
4419
+ * For OpenAI/Anthropic reads from the installed SDK at runtime.
4420
+ * Returns undefined for Custom or unknown vendors.
4421
+ */
4422
+ declare function getVendorDefaultBaseURL(vendor: string): string | undefined;
4293
4423
  /**
4294
4424
  * Create a text provider from a connector
4295
4425
  */
@@ -5998,7 +6128,7 @@ declare function createVideoProvider(connector: Connector): IVideoProvider;
5998
6128
  /**
5999
6129
  * Search result interface
6000
6130
  */
6001
- interface SearchResult$1 {
6131
+ interface SearchResult {
6002
6132
  /** Page title */
6003
6133
  title: string;
6004
6134
  /** Direct URL to the page */
@@ -6034,7 +6164,7 @@ interface SearchResponse$1 {
6034
6164
  /** Provider name */
6035
6165
  provider: string;
6036
6166
  /** Search results */
6037
- results: SearchResult$1[];
6167
+ results: SearchResult[];
6038
6168
  /** Number of results */
6039
6169
  count: number;
6040
6170
  /** Error message if failed */
@@ -6245,8 +6375,7 @@ declare function listConnectorsByServiceTypes(serviceTypes: string[]): string[];
6245
6375
  * FALLBACK STRATEGY:
6246
6376
  * The webScrape tool uses this provider with a fallback chain:
6247
6377
  * 1. Try native fetch (webFetch) - fastest, free
6248
- * 2. Try JS rendering (webFetchJS) - handles SPAs
6249
- * 3. Try external API provider - handles bot protection, etc.
6378
+ * 2. Try external API provider - handles bot protection, SPAs, etc.
6250
6379
  */
6251
6380
 
6252
6381
  /**
@@ -6431,6 +6560,119 @@ declare class ScrapeProvider {
6431
6560
  static createWithFallback(config: ScrapeProviderFallbackConfig): IScrapeProvider;
6432
6561
  }
6433
6562
 
6563
+ /**
6564
+ * IMediaStorage - Storage interface for multimedia outputs (images, video, audio)
6565
+ *
6566
+ * Provides CRUD operations for media files produced by generation tools.
6567
+ * Implementations can use filesystem, S3, GCS, or any other storage backend.
6568
+ *
6569
+ * This follows Clean Architecture - the interface is in domain layer,
6570
+ * implementations are in infrastructure layer.
6571
+ */
6572
+ /**
6573
+ * Metadata about media being saved
6574
+ */
6575
+ interface MediaStorageMetadata {
6576
+ /** Type of media being saved */
6577
+ type: 'image' | 'video' | 'audio';
6578
+ /** File format (png, mp4, mp3, etc.) */
6579
+ format: string;
6580
+ /** Model used for generation */
6581
+ model: string;
6582
+ /** Vendor that produced the output */
6583
+ vendor: string;
6584
+ /** Index for multi-image results */
6585
+ index?: number;
6586
+ /** Suggested filename (without path) */
6587
+ suggestedFilename?: string;
6588
+ /** User ID — set by tool when userId is known, for per-user storage organization */
6589
+ userId?: string;
6590
+ }
6591
+ /**
6592
+ * Result of a save operation
6593
+ */
6594
+ interface MediaStorageResult {
6595
+ /** Location of the saved file (file path, URL, S3 key - depends on implementation) */
6596
+ location: string;
6597
+ /** MIME type of the saved file */
6598
+ mimeType: string;
6599
+ /** File size in bytes */
6600
+ size: number;
6601
+ }
6602
+ /**
6603
+ * Entry returned by list()
6604
+ */
6605
+ interface MediaStorageEntry {
6606
+ /** Location of the file */
6607
+ location: string;
6608
+ /** MIME type */
6609
+ mimeType: string;
6610
+ /** File size in bytes */
6611
+ size: number;
6612
+ /** Media type (image, video, audio) */
6613
+ type?: 'image' | 'video' | 'audio';
6614
+ /** When the file was created */
6615
+ createdAt: Date;
6616
+ }
6617
+ /**
6618
+ * Options for listing media files
6619
+ */
6620
+ interface MediaStorageListOptions {
6621
+ /** Filter by media type */
6622
+ type?: 'image' | 'video' | 'audio';
6623
+ /** Maximum number of results */
6624
+ limit?: number;
6625
+ /** Offset for pagination */
6626
+ offset?: number;
6627
+ }
6628
+ /**
6629
+ * Storage interface for multimedia outputs
6630
+ *
6631
+ * Implementations:
6632
+ * - FileMediaStorage: File-based storage (default, uses local filesystem)
6633
+ * - (Custom) S3MediaStorage, GCSMediaStorage, etc.
6634
+ */
6635
+ interface IMediaStorage {
6636
+ /**
6637
+ * Save media data to storage
6638
+ *
6639
+ * @param data - Raw media data as Buffer
6640
+ * @param metadata - Information about the media for naming/organization
6641
+ * @returns Location and metadata of the saved file
6642
+ */
6643
+ save(data: Buffer, metadata: MediaStorageMetadata): Promise<MediaStorageResult>;
6644
+ /**
6645
+ * Read media data from storage
6646
+ *
6647
+ * @param location - Location string returned by save() or known file path
6648
+ * @returns The raw media data, or null if not found
6649
+ */
6650
+ read(location: string): Promise<Buffer | null>;
6651
+ /**
6652
+ * Delete media from storage
6653
+ *
6654
+ * @param location - Location string to delete
6655
+ * @throws Does NOT throw if the file doesn't exist
6656
+ */
6657
+ delete(location: string): Promise<void>;
6658
+ /**
6659
+ * Check if media exists in storage
6660
+ *
6661
+ * @param location - Location string to check
6662
+ */
6663
+ exists(location: string): Promise<boolean>;
6664
+ /**
6665
+ * List media files in storage (optional)
6666
+ *
6667
+ * @param options - Filtering and pagination options
6668
+ */
6669
+ list?(options?: MediaStorageListOptions): Promise<MediaStorageEntry[]>;
6670
+ /**
6671
+ * Get the storage path/location (for display/debugging)
6672
+ */
6673
+ getPath(): string;
6674
+ }
6675
+
6434
6676
  /**
6435
6677
  * WorkingMemory class - manages indexed working memory for TaskAgent
6436
6678
  *
@@ -8525,174 +8767,33 @@ declare class FileAgentDefinitionStorage implements IAgentDefinitionStorage {
8525
8767
  declare function createFileAgentDefinitionStorage(config?: FileAgentDefinitionStorageConfig): FileAgentDefinitionStorage;
8526
8768
 
8527
8769
  /**
8528
- * Complete description of an LLM model including capabilities, pricing, and features
8770
+ * FileMediaStorage - File-based media storage implementation
8771
+ *
8772
+ * Saves generated media to a configurable directory on the local filesystem.
8773
+ * Default output directory: `os.tmpdir()/oneringai-media/`
8529
8774
  */
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
- };
8775
+
8776
+ interface FileMediaStorageConfig {
8777
+ /** Directory to store media files. Defaults to `os.tmpdir()/oneringai-media/` */
8778
+ outputDir?: string;
8779
+ }
8780
+ declare class FileMediaStorage implements IMediaStorage {
8781
+ private outputDir;
8782
+ private initialized;
8783
+ constructor(config?: FileMediaStorageConfig);
8784
+ save(data: Buffer, metadata: MediaStorageMetadata): Promise<MediaStorageResult>;
8785
+ read(location: string): Promise<Buffer | null>;
8786
+ delete(location: string): Promise<void>;
8787
+ exists(location: string): Promise<boolean>;
8788
+ list(options?: MediaStorageListOptions): Promise<MediaStorageEntry[]>;
8789
+ getPath(): string;
8790
+ private generateFilename;
8791
+ private ensureDir;
8613
8792
  }
8614
8793
  /**
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
8794
+ * Factory function for creating FileMediaStorage instances
8692
8795
  */
8693
- declare function calculateCost(model: string, inputTokens: number, outputTokens: number, options?: {
8694
- useCachedInput?: boolean;
8695
- }): number | null;
8796
+ declare function createFileMediaStorage(config?: FileMediaStorageConfig): FileMediaStorage;
8696
8797
 
8697
8798
  /**
8698
8799
  * Video Model Registry
@@ -9361,98 +9462,6 @@ declare class ProviderErrorMapper {
9361
9462
  private static extractRetryAfter;
9362
9463
  }
9363
9464
 
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
9465
  /**
9457
9466
  * ConnectorTools - Generate tools from Connectors
9458
9467
  *
@@ -9467,8 +9476,12 @@ declare function isKnownService(serviceId: string): boolean;
9467
9476
  */
9468
9477
 
9469
9478
  /**
9470
- * Factory function type for creating service-specific tools
9471
- * Takes a Connector and returns an array of tools that use it
9479
+ * Factory function type for creating service-specific tools.
9480
+ * Takes a Connector and returns an array of tools that use it.
9481
+ *
9482
+ * The `userId` parameter is a legacy fallback — tools should prefer reading
9483
+ * userId from ToolContext at execution time (auto-populated by Agent).
9484
+ * Factory userId is used as fallback when ToolContext is not available.
9472
9485
  */
9473
9486
  type ServiceToolFactory = (connector: Connector, userId?: string) => ToolFunction[];
9474
9487
  /**
@@ -10090,6 +10103,14 @@ declare class ConnectorConfigStore {
10090
10103
  * Decrypt secrets in ConnectorAuth based on auth type
10091
10104
  */
10092
10105
  private decryptAuthSecrets;
10106
+ /**
10107
+ * Encrypt all values in an extra Record (vendor-specific credentials)
10108
+ */
10109
+ private encryptExtra;
10110
+ /**
10111
+ * Decrypt all values in an extra Record (vendor-specific credentials)
10112
+ */
10113
+ private decryptExtra;
10093
10114
  /**
10094
10115
  * Encrypt a single value if not already encrypted
10095
10116
  */
@@ -10222,7 +10243,7 @@ interface AuthTemplate {
10222
10243
  /**
10223
10244
  * Known fields that can be required/optional in auth templates
10224
10245
  */
10225
- type AuthTemplateField = 'apiKey' | 'clientId' | 'clientSecret' | 'redirectUri' | 'scope' | 'privateKey' | 'privateKeyPath' | 'appId' | 'installationId' | 'tenantId' | 'username' | 'subject' | 'audience' | 'userScope' | 'accountId' | 'subdomain' | 'region' | 'accessKeyId' | 'secretAccessKey' | 'applicationKey';
10246
+ 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
10247
  /**
10227
10248
  * Vendor template definition
10228
10249
  * Complete configuration for a vendor's supported authentication methods
@@ -11451,47 +11472,19 @@ interface WebFetchResult {
11451
11472
  declare const webFetch: ToolFunction<WebFetchArgs, WebFetchResult>;
11452
11473
 
11453
11474
  /**
11454
- * Web Fetch with JavaScript - Uses Puppeteer for JS-rendered sites
11455
- * Optional tool - requires puppeteer to be installed
11456
- */
11457
-
11458
- interface WebFetchJSArgs {
11459
- url: string;
11460
- waitForSelector?: string;
11461
- timeout?: number;
11462
- takeScreenshot?: boolean;
11463
- }
11464
- interface WebFetchJSResult {
11465
- success: boolean;
11466
- url: string;
11467
- title: string;
11468
- content: string;
11469
- screenshot?: string;
11470
- loadTime: number;
11471
- error?: string;
11472
- suggestion?: string;
11473
- excerpt?: string;
11474
- byline?: string;
11475
- wasReadabilityUsed?: boolean;
11476
- wasTruncated?: boolean;
11477
- }
11478
- declare const webFetchJS: ToolFunction<WebFetchJSArgs, WebFetchJSResult>;
11479
-
11480
- /**
11481
- * Web Search Tool - Clean interface for LLM
11475
+ * Web Search Tool Factory
11482
11476
  *
11483
- * ARCHITECTURE:
11484
- * - LLM sees simple interface: { query, numResults, country, language }
11485
- * - Connector configuration is INTERNAL (auto-detected by serviceType)
11486
- * - Uses shared findConnectorByServiceTypes() utility
11487
- * - Fallback to environment variables if no connector configured
11477
+ * Creates a web_search tool bound to a specific Connector.
11478
+ * Follows the ConnectorTools pattern (like GitHub tools).
11488
11479
  *
11489
- * Supports: Serper.dev, Brave, Tavily, RapidAPI
11480
+ * Usage:
11481
+ * ConnectorTools.registerService('serper', (connector) => [createWebSearchTool(connector)]);
11482
+ * // or directly:
11483
+ * const tool = createWebSearchTool(myConnector);
11490
11484
  */
11491
11485
 
11492
11486
  /**
11493
11487
  * Arguments for web_search tool
11494
- * CLEAN and SIMPLE - no connector details exposed
11495
11488
  */
11496
11489
  interface WebSearchArgs {
11497
11490
  /** Search query string */
@@ -11507,27 +11500,35 @@ interface WebSearchResult {
11507
11500
  success: boolean;
11508
11501
  query: string;
11509
11502
  provider: string;
11510
- results: SearchResult$1[];
11503
+ results: SearchResult[];
11511
11504
  count: number;
11512
11505
  error?: string;
11513
11506
  }
11514
- declare const webSearch: ToolFunction<WebSearchArgs, WebSearchResult>;
11507
+ /**
11508
+ * Create a web_search tool bound to a specific connector.
11509
+ *
11510
+ * @param connector - Connector instance providing auth for the search API
11511
+ */
11512
+ declare function createWebSearchTool(connector: Connector): ToolFunction<WebSearchArgs, WebSearchResult>;
11515
11513
 
11516
11514
  /**
11517
- * Web Scrape Tool - Clean interface for LLM
11515
+ * Web Scrape Tool Factory
11518
11516
  *
11519
- * ARCHITECTURE:
11520
- * - LLM sees simple interface: { url, timeout, includeHtml, includeMarkdown, includeLinks, waitForSelector }
11521
- * - Connector configuration is INTERNAL (auto-detected by serviceType)
11522
- * - Uses shared findConnectorByServiceTypes() utility
11523
- * - Automatic fallback chain: native fetch -> JS rendering -> external API
11517
+ * Creates a web_scrape tool bound to a specific Connector.
11518
+ * Follows the ConnectorTools pattern (like GitHub tools).
11524
11519
  *
11525
- * Supports: ZenRows, Jina Reader, Firecrawl, ScrapingBee
11520
+ * Fallback chain:
11521
+ * 1. Native fetch (free/fast) via webFetch
11522
+ * 2. External API via the bound connector (e.g., ZenRows, Firecrawl)
11523
+ *
11524
+ * Usage:
11525
+ * ConnectorTools.registerService('zenrows', (connector) => [createWebScrapeTool(connector)]);
11526
+ * // or directly:
11527
+ * const tool = createWebScrapeTool(myConnector);
11526
11528
  */
11527
11529
 
11528
11530
  /**
11529
11531
  * Arguments for web_scrape tool
11530
- * CLEAN and SIMPLE - no connector/strategy details exposed
11531
11532
  */
11532
11533
  interface WebScrapeArgs {
11533
11534
  /** URL to scrape */
@@ -11550,7 +11551,7 @@ interface WebScrapeResult {
11550
11551
  url: string;
11551
11552
  /** Final URL after redirects */
11552
11553
  finalUrl?: string;
11553
- /** Method used: 'native', 'js', or external provider name */
11554
+ /** Method used: 'native' or external provider name */
11554
11555
  method: string;
11555
11556
  /** Page title */
11556
11557
  title: string;
@@ -11573,23 +11574,23 @@ interface WebScrapeResult {
11573
11574
  /** Error message if failed */
11574
11575
  error?: string;
11575
11576
  }
11576
- declare const webScrape: ToolFunction<WebScrapeArgs, WebScrapeResult>;
11577
-
11578
11577
  /**
11579
- * Serper.dev search provider
11580
- * Fast Google search results via API
11578
+ * Create a web_scrape tool bound to a specific connector.
11579
+ *
11580
+ * @param connector - Connector instance providing auth for the scrape API
11581
11581
  */
11582
- interface SearchResult {
11583
- title: string;
11584
- url: string;
11585
- snippet: string;
11586
- position: number;
11587
- }
11582
+ declare function createWebScrapeTool(connector: Connector): ToolFunction<WebScrapeArgs, WebScrapeResult>;
11588
11583
 
11589
11584
  /**
11590
11585
  * JavaScript Execution Tool
11591
- * Executes JavaScript in a sandboxed VM with connector integration
11592
- * Connectors provide authenticated access to external APIs (GitHub, Microsoft, etc.)
11586
+ * Executes JavaScript in a sandboxed VM with connector integration.
11587
+ * Connectors provide authenticated access to external APIs (GitHub, Slack, etc.)
11588
+ *
11589
+ * Key features:
11590
+ * - userId auto-injected from ToolContext into authenticatedFetch calls
11591
+ * - Connector list always scoped to current userId via global access policy
11592
+ * - Dynamic description regenerated at each LLM call with current connectors
11593
+ * - Configurable timeout per invocation
11593
11594
  */
11594
11595
 
11595
11596
  interface ExecuteJSArgs {
@@ -11604,104 +11605,70 @@ interface ExecuteJSResult {
11604
11605
  error?: string;
11605
11606
  executionTime: number;
11606
11607
  }
11608
+ /**
11609
+ * Options for creating the execute_javascript tool.
11610
+ */
11611
+ interface ExecuteJavaScriptToolOptions {
11612
+ /**
11613
+ * Maximum allowed timeout in milliseconds for code execution.
11614
+ * The LLM can request up to this value via the `timeout` parameter.
11615
+ * Default: 30000 (30s). Set higher for long-running API calls.
11616
+ */
11617
+ maxTimeout?: number;
11618
+ /**
11619
+ * Default timeout in milliseconds when not specified by the LLM.
11620
+ * Default: 10000 (10s).
11621
+ */
11622
+ defaultTimeout?: number;
11623
+ }
11607
11624
  /**
11608
11625
  * Create an execute_javascript tool.
11609
11626
  *
11610
11627
  * The tool uses `descriptionFactory` to generate a dynamic description that
11611
- * always reflects the currently registered connectors. This ensures the LLM
11612
- * sees up-to-date connector information even if connectors are registered
11613
- * after the tool is created.
11628
+ * always reflects the connectors available to the current user. Connector
11629
+ * visibility is determined by the global access policy (if set) scoped by
11630
+ * the agent's userId from ToolContext.
11631
+ *
11632
+ * @param options - Optional configuration for timeout limits
11614
11633
  */
11615
- declare function createExecuteJavaScriptTool(): ToolFunction<ExecuteJSArgs, ExecuteJSResult>;
11634
+ declare function createExecuteJavaScriptTool(options?: ExecuteJavaScriptToolOptions): ToolFunction<ExecuteJSArgs, ExecuteJSResult>;
11616
11635
  /**
11617
11636
  * Default executeJavaScript tool instance.
11618
11637
  *
11619
- * This tool uses `descriptionFactory` to generate dynamic descriptions,
11620
- * so the connector list is always current when the tool is sent to the LLM.
11621
- * You can use either this default instance or create new ones with
11622
- * `createExecuteJavaScriptTool()` - both will have dynamic descriptions.
11638
+ * Uses the global connector registry (scoped by userId at runtime).
11639
+ * For custom timeouts, use createExecuteJavaScriptTool(options).
11623
11640
  */
11624
11641
  declare const executeJavaScript: ToolFunction<ExecuteJSArgs, ExecuteJSResult>;
11625
11642
 
11626
11643
  /**
11627
- * Interface for handling multimedia output storage
11644
+ * Module-level configuration for multimedia output storage
11628
11645
  *
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
11682
- *
11683
- * Provides a global default output handler used by all tool factories
11646
+ * Provides a global default media storage used by all tool factories
11684
11647
  * when called through ConnectorTools.registerService().
11685
11648
  *
11686
11649
  * @example
11687
11650
  * ```typescript
11688
- * import { setMediaOutputHandler } from '@everworker/oneringai';
11651
+ * import { setMediaStorage } from '@everworker/oneringai';
11689
11652
  *
11690
- * // Use custom S3 handler before creating agents
11691
- * setMediaOutputHandler(myS3Handler);
11653
+ * // Use custom S3 storage before creating agents
11654
+ * setMediaStorage(myS3Storage);
11692
11655
  * ```
11693
11656
  */
11694
11657
 
11695
11658
  /**
11696
- * Get the global media output handler (creates default FileMediaOutputHandler on first access)
11659
+ * Get the global media storage (creates default FileMediaStorage on first access)
11697
11660
  */
11698
- declare function getMediaOutputHandler(): IMediaOutputHandler;
11661
+ declare function getMediaStorage(): IMediaStorage;
11699
11662
  /**
11700
- * Set a custom global media output handler
11663
+ * Set a custom global media storage
11701
11664
  *
11702
11665
  * Call this before agent creation to use custom storage (S3, GCS, etc.)
11703
11666
  */
11704
- declare function setMediaOutputHandler(handler: IMediaOutputHandler): void;
11667
+ declare function setMediaStorage(storage: IMediaStorage): void;
11668
+ /** @deprecated Use `getMediaStorage()` instead */
11669
+ declare const getMediaOutputHandler: typeof getMediaStorage;
11670
+ /** @deprecated Use `setMediaStorage()` instead */
11671
+ declare const setMediaOutputHandler: typeof setMediaStorage;
11705
11672
 
11706
11673
  /**
11707
11674
  * Image generation tool factory
@@ -11728,7 +11695,7 @@ interface GenerateImageResult {
11728
11695
  }>;
11729
11696
  error?: string;
11730
11697
  }
11731
- declare function createImageGenerationTool(connector: Connector, outputHandler?: IMediaOutputHandler): ToolFunction<GenerateImageArgs, GenerateImageResult>;
11698
+ declare function createImageGenerationTool(connector: Connector, storage?: IMediaStorage, userId?: string): ToolFunction<GenerateImageArgs, GenerateImageResult>;
11732
11699
 
11733
11700
  /**
11734
11701
  * Video generation tool factories
@@ -11738,7 +11705,7 @@ declare function createImageGenerationTool(connector: Connector, outputHandler?:
11738
11705
  * so two tools are needed: one to start and one to check status/download.
11739
11706
  */
11740
11707
 
11741
- declare function createVideoTools(connector: Connector, outputHandler?: IMediaOutputHandler): ToolFunction[];
11708
+ declare function createVideoTools(connector: Connector, storage?: IMediaStorage, userId?: string): ToolFunction[];
11742
11709
 
11743
11710
  /**
11744
11711
  * Text-to-speech tool factory
@@ -11761,7 +11728,7 @@ interface TextToSpeechResult {
11761
11728
  mimeType?: string;
11762
11729
  error?: string;
11763
11730
  }
11764
- declare function createTextToSpeechTool(connector: Connector, outputHandler?: IMediaOutputHandler): ToolFunction<TextToSpeechArgs, TextToSpeechResult>;
11731
+ declare function createTextToSpeechTool(connector: Connector, storage?: IMediaStorage, userId?: string): ToolFunction<TextToSpeechArgs, TextToSpeechResult>;
11765
11732
 
11766
11733
  /**
11767
11734
  * Speech-to-text tool factory
@@ -11771,7 +11738,7 @@ declare function createTextToSpeechTool(connector: Connector, outputHandler?: IM
11771
11738
  */
11772
11739
 
11773
11740
  interface SpeechToTextArgs {
11774
- audioFilePath: string;
11741
+ audioSource: string;
11775
11742
  model?: string;
11776
11743
  language?: string;
11777
11744
  prompt?: string;
@@ -11783,13 +11750,348 @@ interface SpeechToTextResult {
11783
11750
  durationSeconds?: number;
11784
11751
  error?: string;
11785
11752
  }
11786
- declare function createSpeechToTextTool(connector: Connector): ToolFunction<SpeechToTextArgs, SpeechToTextResult>;
11753
+ declare function createSpeechToTextTool(connector: Connector, storage?: IMediaStorage): ToolFunction<SpeechToTextArgs, SpeechToTextResult>;
11754
+
11755
+ /**
11756
+ * GitHub Tools - Shared Types and Helpers
11757
+ *
11758
+ * Foundation for all GitHub connector tools.
11759
+ * Provides repository resolution, authenticated fetch, and result types.
11760
+ */
11761
+
11762
+ /**
11763
+ * Parsed GitHub repository reference
11764
+ */
11765
+ interface GitHubRepository {
11766
+ owner: string;
11767
+ repo: string;
11768
+ }
11769
+ /**
11770
+ * Parse a repository string into owner and repo.
11771
+ *
11772
+ * Accepts:
11773
+ * - "owner/repo" format
11774
+ * - Full GitHub URLs: "https://github.com/owner/repo", "https://github.com/owner/repo/..."
11775
+ *
11776
+ * @throws Error if the format is not recognized
11777
+ */
11778
+ declare function parseRepository(input: string): GitHubRepository;
11779
+ /**
11780
+ * Resolve a repository from tool args or connector default.
11781
+ *
11782
+ * Priority:
11783
+ * 1. Explicit `repository` parameter
11784
+ * 2. `connector.getOptions().defaultRepository`
11785
+ *
11786
+ * @returns GitHubRepository or an error result
11787
+ */
11788
+ declare function resolveRepository(repository: string | undefined, connector: Connector): {
11789
+ success: true;
11790
+ repo: GitHubRepository;
11791
+ } | {
11792
+ success: false;
11793
+ error: string;
11794
+ };
11795
+ /**
11796
+ * Result from search_files tool
11797
+ */
11798
+ interface GitHubSearchFilesResult {
11799
+ success: boolean;
11800
+ files?: {
11801
+ path: string;
11802
+ size: number;
11803
+ type: string;
11804
+ }[];
11805
+ count?: number;
11806
+ truncated?: boolean;
11807
+ error?: string;
11808
+ }
11809
+ /**
11810
+ * Result from search_code tool
11811
+ */
11812
+ interface GitHubSearchCodeResult {
11813
+ success: boolean;
11814
+ matches?: {
11815
+ file: string;
11816
+ fragment?: string;
11817
+ }[];
11818
+ count?: number;
11819
+ truncated?: boolean;
11820
+ error?: string;
11821
+ }
11822
+ /**
11823
+ * Result from read_file tool (GitHub variant)
11824
+ */
11825
+ interface GitHubReadFileResult {
11826
+ success: boolean;
11827
+ content?: string;
11828
+ path?: string;
11829
+ size?: number;
11830
+ lines?: number;
11831
+ truncated?: boolean;
11832
+ sha?: string;
11833
+ error?: string;
11834
+ }
11835
+ /**
11836
+ * Result from get_pr tool
11837
+ */
11838
+ interface GitHubGetPRResult {
11839
+ success: boolean;
11840
+ data?: {
11841
+ number: number;
11842
+ title: string;
11843
+ body: string | null;
11844
+ state: string;
11845
+ author: string;
11846
+ labels: string[];
11847
+ reviewers: string[];
11848
+ mergeable: boolean | null;
11849
+ head: string;
11850
+ base: string;
11851
+ url: string;
11852
+ created_at: string;
11853
+ updated_at: string;
11854
+ additions: number;
11855
+ deletions: number;
11856
+ changed_files: number;
11857
+ draft: boolean;
11858
+ };
11859
+ error?: string;
11860
+ }
11861
+ /**
11862
+ * Result from pr_files tool
11863
+ */
11864
+ interface GitHubPRFilesResult {
11865
+ success: boolean;
11866
+ files?: {
11867
+ filename: string;
11868
+ status: string;
11869
+ additions: number;
11870
+ deletions: number;
11871
+ changes: number;
11872
+ patch?: string;
11873
+ }[];
11874
+ count?: number;
11875
+ error?: string;
11876
+ }
11877
+ /**
11878
+ * A unified comment/review entry
11879
+ */
11880
+ interface GitHubPRCommentEntry {
11881
+ id: number;
11882
+ type: 'review' | 'comment' | 'review_comment';
11883
+ author: string;
11884
+ body: string;
11885
+ created_at: string;
11886
+ path?: string;
11887
+ line?: number;
11888
+ state?: string;
11889
+ }
11890
+ /**
11891
+ * Result from pr_comments tool
11892
+ */
11893
+ interface GitHubPRCommentsResult {
11894
+ success: boolean;
11895
+ comments?: GitHubPRCommentEntry[];
11896
+ count?: number;
11897
+ error?: string;
11898
+ }
11899
+ /**
11900
+ * Result from create_pr tool
11901
+ */
11902
+ interface GitHubCreatePRResult {
11903
+ success: boolean;
11904
+ data?: {
11905
+ number: number;
11906
+ url: string;
11907
+ state: string;
11908
+ title: string;
11909
+ };
11910
+ error?: string;
11911
+ }
11912
+
11913
+ /**
11914
+ * GitHub Search Files Tool
11915
+ *
11916
+ * Search for files by glob pattern in a GitHub repository.
11917
+ * Mirrors the local `glob` tool for remote GitHub repos.
11918
+ *
11919
+ * Uses the Git Trees API to fetch the full file tree, then filters client-side.
11920
+ */
11921
+
11922
+ /**
11923
+ * Arguments for the search_files tool
11924
+ */
11925
+ interface SearchFilesArgs {
11926
+ /** Repository in "owner/repo" format or full GitHub URL */
11927
+ repository?: string;
11928
+ /** Glob pattern to match files (e.g., "**\/*.ts", "src/**\/*.tsx") */
11929
+ pattern: string;
11930
+ /** Branch, tag, or SHA (defaults to repo's default branch) */
11931
+ ref?: string;
11932
+ }
11933
+ /**
11934
+ * Create a GitHub search_files tool
11935
+ */
11936
+ declare function createSearchFilesTool(connector: Connector, userId?: string): ToolFunction<SearchFilesArgs, GitHubSearchFilesResult>;
11937
+
11938
+ /**
11939
+ * GitHub Search Code Tool
11940
+ *
11941
+ * Search for code content across a GitHub repository.
11942
+ * Mirrors the local `grep` tool for remote GitHub repos.
11943
+ *
11944
+ * Uses the GitHub Code Search API with text-match support.
11945
+ *
11946
+ * Note: GitHub's code search API has a rate limit of 30 requests/minute.
11947
+ */
11948
+
11949
+ /**
11950
+ * Arguments for the search_code tool
11951
+ */
11952
+ interface SearchCodeArgs {
11953
+ /** Repository in "owner/repo" format or full GitHub URL */
11954
+ repository?: string;
11955
+ /** Search query (keyword or phrase) */
11956
+ query: string;
11957
+ /** Filter by programming language (e.g., "typescript", "python") */
11958
+ language?: string;
11959
+ /** Filter by file path (e.g., "src/", "lib/utils") */
11960
+ path?: string;
11961
+ /** Filter by file extension (e.g., "ts", "py") */
11962
+ extension?: string;
11963
+ /** Maximum number of results (default: 30, max: 100) */
11964
+ limit?: number;
11965
+ }
11966
+ /**
11967
+ * Create a GitHub search_code tool
11968
+ */
11969
+ declare function createSearchCodeTool(connector: Connector, userId?: string): ToolFunction<SearchCodeArgs, GitHubSearchCodeResult>;
11970
+
11971
+ /**
11972
+ * GitHub Read File Tool
11973
+ *
11974
+ * Read file content from a GitHub repository.
11975
+ * Mirrors the local `read_file` tool for remote GitHub repos.
11976
+ *
11977
+ * Supports line range selection (offset/limit) and formats output
11978
+ * with line numbers matching the local read_file tool.
11979
+ */
11980
+
11981
+ /**
11982
+ * Arguments for the GitHub read_file tool
11983
+ */
11984
+ interface GitHubReadFileArgs {
11985
+ /** Repository in "owner/repo" format or full GitHub URL */
11986
+ repository?: string;
11987
+ /** File path within the repository (e.g., "src/index.ts") */
11988
+ path: string;
11989
+ /** Branch, tag, or commit SHA. Defaults to the repository's default branch. */
11990
+ ref?: string;
11991
+ /** Line number to start reading from (1-indexed). Useful for large files. */
11992
+ offset?: number;
11993
+ /** Number of lines to read (default: 2000). */
11994
+ limit?: number;
11995
+ }
11996
+ /**
11997
+ * Create a GitHub read_file tool
11998
+ */
11999
+ declare function createGitHubReadFileTool(connector: Connector, userId?: string): ToolFunction<GitHubReadFileArgs, GitHubReadFileResult>;
12000
+
12001
+ /**
12002
+ * GitHub Get PR Tool
12003
+ *
12004
+ * Get full details of a pull request from a GitHub repository.
12005
+ */
12006
+
12007
+ /**
12008
+ * Arguments for the get_pr tool
12009
+ */
12010
+ interface GetPRArgs {
12011
+ /** Repository in "owner/repo" format or full GitHub URL */
12012
+ repository?: string;
12013
+ /** Pull request number */
12014
+ pull_number: number;
12015
+ }
12016
+ /**
12017
+ * Create a GitHub get_pr tool
12018
+ */
12019
+ declare function createGetPRTool(connector: Connector, userId?: string): ToolFunction<GetPRArgs, GitHubGetPRResult>;
12020
+
12021
+ /**
12022
+ * GitHub PR Files Tool
12023
+ *
12024
+ * Get the files changed in a pull request, including diffs.
12025
+ */
12026
+
12027
+ /**
12028
+ * Arguments for the pr_files tool
12029
+ */
12030
+ interface PRFilesArgs {
12031
+ /** Repository in "owner/repo" format or full GitHub URL */
12032
+ repository?: string;
12033
+ /** Pull request number */
12034
+ pull_number: number;
12035
+ }
12036
+ /**
12037
+ * Create a GitHub pr_files tool
12038
+ */
12039
+ declare function createPRFilesTool(connector: Connector, userId?: string): ToolFunction<PRFilesArgs, GitHubPRFilesResult>;
12040
+
12041
+ /**
12042
+ * GitHub PR Comments Tool
12043
+ *
12044
+ * Get all comments and reviews on a pull request.
12045
+ * Merges three types: review comments (line-level), reviews, and issue comments.
12046
+ */
12047
+
12048
+ /**
12049
+ * Arguments for the pr_comments tool
12050
+ */
12051
+ interface PRCommentsArgs {
12052
+ /** Repository in "owner/repo" format or full GitHub URL */
12053
+ repository?: string;
12054
+ /** Pull request number */
12055
+ pull_number: number;
12056
+ }
12057
+ /**
12058
+ * Create a GitHub pr_comments tool
12059
+ */
12060
+ declare function createPRCommentsTool(connector: Connector, userId?: string): ToolFunction<PRCommentsArgs, GitHubPRCommentsResult>;
12061
+
12062
+ /**
12063
+ * GitHub Create PR Tool
12064
+ *
12065
+ * Create a pull request on a GitHub repository.
12066
+ */
12067
+
12068
+ /**
12069
+ * Arguments for the create_pr tool
12070
+ */
12071
+ interface CreatePRArgs {
12072
+ /** Repository in "owner/repo" format or full GitHub URL */
12073
+ repository?: string;
12074
+ /** Pull request title */
12075
+ title: string;
12076
+ /** Pull request description/body (Markdown supported) */
12077
+ body?: string;
12078
+ /** Source branch name (the branch with your changes) */
12079
+ head: string;
12080
+ /** Target branch name (the branch you want to merge into) */
12081
+ base: string;
12082
+ /** Create as a draft pull request */
12083
+ draft?: boolean;
12084
+ }
12085
+ /**
12086
+ * Create a GitHub create_pr tool
12087
+ */
12088
+ declare function createCreatePRTool(connector: Connector, userId?: string): ToolFunction<CreatePRArgs, GitHubCreatePRResult>;
11787
12089
 
11788
12090
  /**
11789
12091
  * AUTO-GENERATED FILE - DO NOT EDIT MANUALLY
11790
12092
  *
11791
12093
  * Generated by: scripts/generate-tool-registry.ts
11792
- * Generated at: 2026-02-07T08:56:13.394Z
12094
+ * Generated at: 2026-02-09T20:30:19.773Z
11793
12095
  *
11794
12096
  * To regenerate: npm run generate:tools
11795
12097
  */
@@ -11970,18 +12272,22 @@ declare const index_ConnectorTools: typeof ConnectorTools;
11970
12272
  declare const index_DEFAULT_FILESYSTEM_CONFIG: typeof DEFAULT_FILESYSTEM_CONFIG;
11971
12273
  declare const index_DEFAULT_SHELL_CONFIG: typeof DEFAULT_SHELL_CONFIG;
11972
12274
  type index_EditFileResult = EditFileResult;
11973
- type index_FileMediaOutputHandler = FileMediaOutputHandler;
11974
- declare const index_FileMediaOutputHandler: typeof FileMediaOutputHandler;
11975
12275
  type index_FilesystemToolConfig = FilesystemToolConfig;
11976
12276
  type index_GenericAPICallArgs = GenericAPICallArgs;
11977
12277
  type index_GenericAPICallResult = GenericAPICallResult;
11978
12278
  type index_GenericAPIToolOptions = GenericAPIToolOptions;
12279
+ type index_GitHubCreatePRResult = GitHubCreatePRResult;
12280
+ type index_GitHubGetPRResult = GitHubGetPRResult;
12281
+ type index_GitHubPRCommentEntry = GitHubPRCommentEntry;
12282
+ type index_GitHubPRCommentsResult = GitHubPRCommentsResult;
12283
+ type index_GitHubPRFilesResult = GitHubPRFilesResult;
12284
+ type index_GitHubReadFileResult = GitHubReadFileResult;
12285
+ type index_GitHubRepository = GitHubRepository;
12286
+ type index_GitHubSearchCodeResult = GitHubSearchCodeResult;
12287
+ type index_GitHubSearchFilesResult = GitHubSearchFilesResult;
11979
12288
  type index_GlobResult = GlobResult;
11980
12289
  type index_GrepMatch = GrepMatch;
11981
12290
  type index_GrepResult = GrepResult;
11982
- type index_IMediaOutputHandler = IMediaOutputHandler;
11983
- type index_MediaOutputMetadata = MediaOutputMetadata;
11984
- type index_MediaOutputResult = MediaOutputResult;
11985
12291
  type index_ReadFileResult = ReadFileResult;
11986
12292
  type index_SearchResult = SearchResult;
11987
12293
  type index_ServiceToolFactory = ServiceToolFactory;
@@ -11993,16 +12299,25 @@ type index_ToolRegistryEntry = ToolRegistryEntry;
11993
12299
  type index_WriteFileResult = WriteFileResult;
11994
12300
  declare const index_bash: typeof bash;
11995
12301
  declare const index_createBashTool: typeof createBashTool;
12302
+ declare const index_createCreatePRTool: typeof createCreatePRTool;
11996
12303
  declare const index_createEditFileTool: typeof createEditFileTool;
11997
12304
  declare const index_createExecuteJavaScriptTool: typeof createExecuteJavaScriptTool;
12305
+ declare const index_createGetPRTool: typeof createGetPRTool;
12306
+ declare const index_createGitHubReadFileTool: typeof createGitHubReadFileTool;
11998
12307
  declare const index_createGlobTool: typeof createGlobTool;
11999
12308
  declare const index_createGrepTool: typeof createGrepTool;
12000
12309
  declare const index_createImageGenerationTool: typeof createImageGenerationTool;
12001
12310
  declare const index_createListDirectoryTool: typeof createListDirectoryTool;
12311
+ declare const index_createPRCommentsTool: typeof createPRCommentsTool;
12312
+ declare const index_createPRFilesTool: typeof createPRFilesTool;
12002
12313
  declare const index_createReadFileTool: typeof createReadFileTool;
12314
+ declare const index_createSearchCodeTool: typeof createSearchCodeTool;
12315
+ declare const index_createSearchFilesTool: typeof createSearchFilesTool;
12003
12316
  declare const index_createSpeechToTextTool: typeof createSpeechToTextTool;
12004
12317
  declare const index_createTextToSpeechTool: typeof createTextToSpeechTool;
12005
12318
  declare const index_createVideoTools: typeof createVideoTools;
12319
+ declare const index_createWebScrapeTool: typeof createWebScrapeTool;
12320
+ declare const index_createWebSearchTool: typeof createWebSearchTool;
12006
12321
  declare const index_createWriteFileTool: typeof createWriteFileTool;
12007
12322
  declare const index_developerTools: typeof developerTools;
12008
12323
  declare const index_editFile: typeof editFile;
@@ -12011,6 +12326,7 @@ declare const index_expandTilde: typeof expandTilde;
12011
12326
  declare const index_getAllBuiltInTools: typeof getAllBuiltInTools;
12012
12327
  declare const index_getBackgroundOutput: typeof getBackgroundOutput;
12013
12328
  declare const index_getMediaOutputHandler: typeof getMediaOutputHandler;
12329
+ declare const index_getMediaStorage: typeof getMediaStorage;
12014
12330
  declare const index_getToolByName: typeof getToolByName;
12015
12331
  declare const index_getToolCategories: typeof getToolCategories;
12016
12332
  declare const index_getToolRegistry: typeof getToolRegistry;
@@ -12023,17 +12339,17 @@ declare const index_isExcludedExtension: typeof isExcludedExtension;
12023
12339
  declare const index_jsonManipulator: typeof jsonManipulator;
12024
12340
  declare const index_killBackgroundProcess: typeof killBackgroundProcess;
12025
12341
  declare const index_listDirectory: typeof listDirectory;
12342
+ declare const index_parseRepository: typeof parseRepository;
12026
12343
  declare const index_readFile: typeof readFile;
12344
+ declare const index_resolveRepository: typeof resolveRepository;
12027
12345
  declare const index_setMediaOutputHandler: typeof setMediaOutputHandler;
12346
+ declare const index_setMediaStorage: typeof setMediaStorage;
12028
12347
  declare const index_toolRegistry: typeof toolRegistry;
12029
12348
  declare const index_validatePath: typeof validatePath;
12030
12349
  declare const index_webFetch: typeof webFetch;
12031
- declare const index_webFetchJS: typeof webFetchJS;
12032
- declare const index_webScrape: typeof webScrape;
12033
- declare const index_webSearch: typeof webSearch;
12034
12350
  declare const index_writeFile: typeof writeFile;
12035
12351
  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 };
12352
+ 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_createWebScrapeTool as createWebScrapeTool, index_createWebSearchTool as createWebSearchTool, 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_writeFile as writeFile };
12037
12353
  }
12038
12354
 
12039
12355
  /**
@@ -12088,4 +12404,4 @@ declare class ProviderConfigAgent {
12088
12404
  reset(): void;
12089
12405
  }
12090
12406
 
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 };
12407
+ 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, 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 };