@everworker/oneringai 0.4.2 → 0.4.4

package/dist/index.d.cts

@@ -1,12 +1,12 @@
-import { I as IConnectorRegistry, a as IConnectorAccessPolicy, C as ConnectorAccessContext, b as Connector, c as ConnectorConfig, d as ITokenStorage, e as IProvider, f as ConnectorFetchOptions, P as ProviderCapabilities, S as StoredToken$1, g as ConnectorAuth, h as ConnectorConfigResult } from './IProvider-CNJqZItJ.cjs';
-export { A as APIKeyConnectorAuth, D as DEFAULT_BASE_DELAY_MS, i as DEFAULT_CONNECTOR_TIMEOUT, j as DEFAULT_MAX_DELAY_MS, k as DEFAULT_MAX_RETRIES, l as DEFAULT_RETRYABLE_STATUSES, J as JWTConnectorAuth, O as OAuthConnectorAuth } from './IProvider-CNJqZItJ.cjs';
-import { I as InputItem, T as ToolFunction, M as MemoryEntry, a as MemoryScope, b as Tool, c as ToolContext, d as ToolPermissionConfig$1, e as ToolCall, 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 HookName, o as StaleEntryInfo, p as PriorityContext, q as MemoryIndex, r as TaskStatusForMemory, s as WorkingMemoryAccess, t as TokenUsage, u as StreamEventType, v as TextGenerateOptions, w as ModelCapabilities, x as MessageRole } from './index-BMjyFNJQ.cjs';
-export { y as AfterToolContext, z as AgentEventName, B as AgenticLoopEventName, D as AgenticLoopEvents, G as ApprovalResult, J as ApproveToolContext, K as BeforeToolContext, N as BuiltInTool, Q as CompactionItem, R as ContentType, U as DEFAULT_MEMORY_CONFIG, V as ErrorEvent, X as ExecutionConfig, Y as Hook, Z as HookManager, _ as InputImageContent, $ as InputTextContent, a0 as IterationCompleteEvent, a1 as JSONSchema, a2 as MEMORY_PRIORITY_VALUES, a3 as MemoryEntryInput, a4 as MemoryIndexEntry, a5 as Message, a6 as ModifyingHook, a7 as OutputTextContent, a8 as OutputTextDeltaEvent, a9 as OutputTextDoneEvent, aa as ReasoningDeltaEvent, ab as ReasoningDoneEvent, ac as ReasoningItem, ad as ResponseCompleteEvent, ae as ResponseCreatedEvent, af as ResponseInProgressEvent, ag as SimpleScope, ah as TaskAwareScope, ai as ThinkingContent, aj as ToolCallArgumentsDeltaEvent, ak as ToolCallArgumentsDoneEvent, al as ToolCallStartEvent, am as ToolCallState, an as ToolExecutionContext, ao as ToolExecutionDoneEvent, ap as ToolExecutionStartEvent, aq as ToolModification, ar as ToolResultContent, as as ToolUseContent, at as calculateEntrySize, au as defaultDescribeCall, av as forPlan, aw as forTasks, ax as getToolCallDescription, ay as isErrorEvent, az as isOutputTextDelta, aA as isReasoningDelta, aB as isReasoningDone, aC as isResponseComplete, aD as isSimpleScope, aE as isStreamEvent, aF as isTaskAwareScope, aG as isTerminalMemoryStatus, aH as isToolCallArgumentsDelta, aI as isToolCallArgumentsDone, aJ as isToolCallStart, aK as scopeEquals, aL as scopeMatches } from './index-BMjyFNJQ.cjs';
+import { I as IConnectorRegistry, a as IConnectorAccessPolicy, C as ConnectorAccessContext, b as Connector, c as ConnectorConfig, d as ITokenStorage, e as IProvider, f as ConnectorFetchOptions, P as ProviderCapabilities, S as StoredToken$1, g as ConnectorAuth, h as ConnectorConfigResult } from './IProvider-B8sqUzJG.cjs';
+export { A as APIKeyConnectorAuth, D as DEFAULT_BASE_DELAY_MS, i as DEFAULT_CONNECTOR_TIMEOUT, j as DEFAULT_MAX_DELAY_MS, k as DEFAULT_MAX_RETRIES, l as DEFAULT_RETRYABLE_STATUSES, J as JWTConnectorAuth, O as OAuthConnectorAuth } from './IProvider-B8sqUzJG.cjs';
+import { C as ContextFeatures, M as MemoryEntry, a as MemoryScope, I as IContextStorage, T as Tool, b as ToolFunction, c as ToolContext, d as ToolPermissionConfig$1, e as ContextBudget$1, f as ToolCall, g as IContextPluginNextGen, W as WorkingMemoryConfig, P as PriorityCalculator, h as MemoryPriority, i as MemoryTier, j as ContextEvents, A as AgentContextNextGenConfig, k as AuthIdentity, l as ICompactionStrategy, B as BeforeCompactionCallback, m as InputItem, n as Content, o as PreparedContext, O as OutputItem, p as ToolResult, q as ConsolidationResult, S as SerializedContextState, r as StoredContextSession, s as ITextProvider, t as ContextSessionMetadata, F as FunctionToolDefinition, L as LLMResponse, u as StreamEvent, H as HookConfig, v as HistoryMode, w as AgentEvents, x as AgentResponse, E as ExecutionContext, y as ExecutionMetrics, z as AuditEntry, D as HookName, G as ITokenEstimator$1, J as ToolCategoryScope, K as CompactionContext, N as CompactionResult, Q as StaleEntryInfo, R as PriorityContext, U as MemoryIndex, V as TaskStatusForMemory, X as WorkingMemoryAccess, Y as ContextStorageListOptions, Z as ContextSessionSummary, _ as TokenUsage, $ as StreamEventType, a0 as TextGenerateOptions, a1 as ModelCapabilities, a2 as MessageRole } from './index-DmYrHH7d.cjs';
+export { a3 as AfterToolContext, a4 as AgentEventName, a5 as AgenticLoopEventName, a6 as AgenticLoopEvents, a7 as ApprovalResult, a8 as ApproveToolContext, a9 as BeforeToolContext, aa as BuiltInTool, ab as CONTEXT_SESSION_FORMAT_VERSION, ac as CatalogRegistryEntry, ad as CatalogToolEntry, ae as CompactionItem, af as ConnectorCategoryInfo, ag as ContentType, ah as DEFAULT_CONFIG, ai as DEFAULT_FEATURES, aj as DEFAULT_MEMORY_CONFIG, ak as ErrorEvent, al as ExecutionConfig, am as Hook, an as HookManager, ao as InputImageContent, ap as InputTextContent, aq as IterationCompleteEvent, ar as JSONSchema, as as MEMORY_PRIORITY_VALUES, at as MemoryEntryInput, au as MemoryIndexEntry, av as Message, aw as ModifyingHook, ax as OutputTextContent, ay as OutputTextDeltaEvent, az as OutputTextDoneEvent, aA as OversizedInputResult, aB as PluginConfigs, aC as ReasoningDeltaEvent, aD as ReasoningDoneEvent, aE as ReasoningItem, aF as ResponseCompleteEvent, aG as ResponseCreatedEvent, aH as ResponseInProgressEvent, aI as SimpleScope, aJ as TaskAwareScope, aK as ThinkingContent, aL as ToolCallArgumentsDeltaEvent, aM as ToolCallArgumentsDoneEvent, aN as ToolCallStartEvent, aO as ToolCallState, aP as ToolCatalogRegistry, aQ as ToolCategoryDefinition, aR as ToolExecutionContext, aS as ToolExecutionDoneEvent, aT as ToolExecutionStartEvent, aU as ToolModification, aV as ToolResultContent, aW as ToolUseContent, aX as calculateEntrySize, aY as defaultDescribeCall, aZ as forPlan, a_ as forTasks, a$ as getToolCallDescription, b0 as isErrorEvent, b1 as isOutputTextDelta, b2 as isReasoningDelta, b3 as isReasoningDone, b4 as isResponseComplete, b5 as isSimpleScope, b6 as isStreamEvent, b7 as isTaskAwareScope, b8 as isTerminalMemoryStatus, b9 as isToolCallArgumentsDelta, ba as isToolCallArgumentsDone, bb as isToolCallStart, bc as scopeEquals, bd as scopeMatches } from './index-DmYrHH7d.cjs';
 import { EventEmitter } from 'eventemitter3';
 import { V as Vendor } from './Vendor-DYh_bzwo.cjs';
 export { a as VENDORS, i as isVendor } from './Vendor-DYh_bzwo.cjs';
-import { A as AudioFormat, I as IBaseModelDescription, V as VendorOptionSchema, a as IImageProvider } from './ImageModel-B64HX3lN.cjs';
-export { b as AspectRatio, c as IImageModelDescription, d as IMAGE_MODELS, e as IMAGE_MODEL_REGISTRY, f as ISourceLinks, g as ImageEditOptions, h as ImageGenerateOptions, i as ImageGeneration, j as ImageGenerationCreateOptions, k as ImageModelCapabilities, l as ImageModelPricing, m as ImageResponse, n as ImageVariationOptions, O as OutputFormat, Q as QualityLevel, S as SimpleGenerateOptions, o as calculateImageCost, p as getActiveImageModels, q as getImageModelInfo, r as getImageModelsByVendor, s as getImageModelsWithFeature } from './ImageModel-B64HX3lN.cjs';
+import { A as AudioFormat, I as IBaseModelDescription, V as VendorOptionSchema, a as IImageProvider } from './ImageModel-Ds5_6sf7.cjs';
+export { b as AspectRatio, c as IImageModelDescription, d as IMAGE_MODELS, e as IMAGE_MODEL_REGISTRY, f as ISourceLinks, g as ImageEditOptions, h as ImageGenerateOptions, i as ImageGeneration, j as ImageGenerationCreateOptions, k as ImageModelCapabilities, l as ImageModelPricing, m as ImageResponse, n as ImageVariationOptions, O as OutputFormat, Q as QualityLevel, S as SimpleGenerateOptions, o as calculateImageCost, p as getActiveImageModels, q as getImageModelInfo, r as getImageModelsByVendor, s as getImageModelsWithFeature } from './ImageModel-Ds5_6sf7.cjs';
 import { ServiceCategory } from './shared/index.cjs';
 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';
 
@@ -316,844 +316,6 @@ interface IMediaStorage {
     getPath(): string;
 }
 
-/**
- * IContextStorage - Storage interface for AgentContext persistence
- *
- * Provides persistence operations for AgentContext sessions.
- * Implementations can use filesystem, database, cloud storage, etc.
- *
- * This follows Clean Architecture - the interface is in domain layer,
- * implementations are in infrastructure layer.
- */
-
-/**
- * Serialized context state for persistence.
- * This is the canonical definition - core layer re-exports this type.
- */
-interface SerializedContextState {
-    /** Conversation history */
-    conversation: InputItem[];
-    /** Plugin states (keyed by plugin name) */
-    pluginStates: Record<string, unknown>;
-    /** System prompt */
-    systemPrompt?: string;
-    /** Metadata */
-    metadata: {
-        savedAt: number;
-        agentId?: string;
-        userId?: string;
-        model: string;
-    };
-    /** Agent-specific state (for TaskAgent, UniversalAgent, etc.) */
-    agentState?: Record<string, unknown>;
-}
-/**
- * Session summary for listing (lightweight, no full state)
- */
-interface ContextSessionSummary {
-    /** Session identifier */
-    sessionId: string;
-    /** When the session was created */
-    createdAt: Date;
-    /** When the session was last saved */
-    lastSavedAt: Date;
-    /** Number of messages in history */
-    messageCount: number;
-    /** Number of memory entries */
-    memoryEntryCount: number;
-    /** Optional metadata */
-    metadata?: ContextSessionMetadata;
-}
-/**
- * Session metadata (stored with session)
- */
-interface ContextSessionMetadata {
-    /** Human-readable title */
-    title?: string;
-    /** Auto-generated or user-provided description */
-    description?: string;
-    /** Tags for filtering */
-    tags?: string[];
-    /** Custom key-value data */
-    [key: string]: unknown;
-}
-/**
- * Full session state wrapper (includes metadata)
- */
-interface StoredContextSession {
-    /** Format version for migration support */
-    version: number;
-    /** Session identifier */
-    sessionId: string;
-    /** When the session was created */
-    createdAt: string;
-    /** When the session was last saved */
-    lastSavedAt: string;
-    /** The serialized AgentContext state */
-    state: SerializedContextState;
-    /** Session metadata */
-    metadata: ContextSessionMetadata;
-}
-/**
- * Current format version for stored sessions
- */
-declare const CONTEXT_SESSION_FORMAT_VERSION = 1;
-/**
- * Storage interface for AgentContext persistence
- *
- * Implementations:
- * - FileContextStorage: File-based storage at ~/.oneringai/agents/<agentId>/sessions/
- * - (Future) RedisContextStorage, PostgresContextStorage, S3ContextStorage, etc.
- */
-interface IContextStorage {
-    /**
-     * Save context state to a session
-     *
-     * @param sessionId - Unique session identifier
-     * @param state - Serialized AgentContext state
-     * @param metadata - Optional session metadata
-     */
-    save(sessionId: string, state: SerializedContextState, metadata?: ContextSessionMetadata): Promise<void>;
-    /**
-     * Load context state from a session
-     *
-     * @param sessionId - Session identifier to load
-     * @returns The stored session, or null if not found
-     */
-    load(sessionId: string): Promise<StoredContextSession | null>;
-    /**
-     * Delete a session
-     *
-     * @param sessionId - Session identifier to delete
-     */
-    delete(sessionId: string): Promise<void>;
-    /**
-     * Check if a session exists
-     *
-     * @param sessionId - Session identifier to check
-     */
-    exists(sessionId: string): Promise<boolean>;
-    /**
-     * List all sessions (summaries only, not full state)
-     *
-     * @param options - Optional filtering and pagination
-     * @returns Array of session summaries, sorted by lastSavedAt descending
-     */
-    list(options?: ContextStorageListOptions): Promise<ContextSessionSummary[]>;
-    /**
-     * Update session metadata without loading full state
-     *
-     * @param sessionId - Session identifier
-     * @param metadata - Metadata to merge (existing keys preserved unless overwritten)
-     */
-    updateMetadata?(sessionId: string, metadata: Partial<ContextSessionMetadata>): Promise<void>;
-    /**
-     * Get the storage path (for display/debugging)
-     * @deprecated Use getLocation() instead - getPath() assumes filesystem storage
-     */
-    getPath(): string;
-    /**
-     * Get a human-readable storage location string (for display/debugging).
-     * Examples: file path, MongoDB URI, Redis key prefix, S3 bucket, etc.
-     * Falls back to getPath() if not implemented.
-     */
-    getLocation?(): string;
-}
-/**
- * Options for listing sessions
- */
-interface ContextStorageListOptions {
-    /** Filter by tags (any match) */
-    tags?: string[];
-    /** Filter by creation date range */
-    createdAfter?: Date;
-    createdBefore?: Date;
-    /** Filter by last saved date range */
-    savedAfter?: Date;
-    savedBefore?: Date;
-    /** Maximum number of results */
-    limit?: number;
-    /** Offset for pagination */
-    offset?: number;
-}
-
-/**
- * AgentContextNextGen - Type Definitions
- *
- * Clean, minimal type definitions for the next-generation context manager.
- */
-
-/**
- * Token estimator interface - used for conversation and input estimation
- * Plugins handle their own token estimation internally.
- */
-interface ITokenEstimator$1 {
-    /** Estimate tokens for a string */
-    estimateTokens(text: string): number;
-    /** Estimate tokens for arbitrary data (will be JSON stringified) */
-    estimateDataTokens(data: unknown): number;
-    /**
-     * Estimate tokens for an image. Provider-specific implementations can override.
-     *
-     * Default heuristic (matches OpenAI's image token pricing):
-     * - detail='low': 85 tokens
-     * - detail='high' with known dimensions: 85 + 170 * ceil(w/512) * ceil(h/512)
-     * - Unknown dimensions: ~1000 tokens (conservative default)
-     *
-     * @param width - Image width in pixels (if known)
-     * @param height - Image height in pixels (if known)
-     * @param detail - Image detail level: 'low', 'high', or 'auto' (default 'auto')
-     */
-    estimateImageTokens?(width?: number, height?: number, detail?: string): number;
-}
-/**
- * Context plugin interface for NextGen context management.
- *
- * ## Implementing a Custom Plugin
- *
- * 1. **Extend BasePluginNextGen** - provides token caching helpers
- * 2. **Implement getInstructions()** - return LLM usage guide (static, cached)
- * 3. **Implement getContent()** - return formatted content (Markdown with `##` header)
- * 4. **Call updateTokenCache()** - after any state change that affects content
- * 5. **Implement getTools()** - return tools with `<plugin_prefix>_*` naming
- *
- * ## Plugin Contributions
- *
- * Plugins provide three types of content to the system message:
- * 1. **Instructions** - static usage guide for the LLM (NEVER compacted)
- * 2. **Content** - dynamic plugin data/state (may be compacted)
- * 3. **Tools** - registered with ToolManager (NEVER compacted)
- *
- * ## Token Cache Lifecycle
- *
- * Plugins must track their own token size for budget calculation. The pattern:
- *
- * ```typescript
- * // When state changes:
- * this._entries.set(key, value);
- * this.invalidateTokenCache();  // Clear cached size
- *
- * // In getContent():
- * const content = this.formatContent();
- * this.updateTokenCache(this.estimator.estimateTokens(content));  // Update cache
- * return content;
- * ```
- *
- * ## Content Format
- *
- * `getContent()` should return Markdown with a descriptive header:
- *
- * ```markdown
- * ## Plugin Display Name (optional stats)
- *
- * Formatted content here...
- * - Entry 1: value
- * - Entry 2: value
- * ```
- *
- * Built-in plugins use these headers:
- * - WorkingMemory: `## Working Memory (N entries)`
- * - InContextMemory: `## Live Context (N entries)`
- * - PersistentInstructions: No header (user's raw instructions)
- *
- * ## Tool Naming Convention
- *
- * Use a consistent prefix based on plugin name:
- * - `working_memory` plugin → `memory_store`, `memory_retrieve`, `memory_delete`, `memory_list`
- * - `in_context_memory` plugin → `context_set`, `context_delete`, `context_list`
- * - `persistent_instructions` plugin → `instructions_set`, `instructions_remove`, `instructions_list`, `instructions_clear`
- *
- * ## State Serialization
- *
- * `getState()` and `restoreState()` are **synchronous** for simplicity.
- * If your plugin has async data, consider:
- * - Storing only references/keys in state
- * - Using a separate async initialization method
- *
- * @example
- * ```typescript
- * class MyPlugin extends BasePluginNextGen {
- *   readonly name = 'my_plugin';
- *   private _data = new Map<string, string>();
- *
- *   getInstructions(): string {
- *     return '## My Plugin\n\nUse my_plugin_set to store data...';
- *   }
- *
- *   async getContent(): Promise<string | null> {
- *     if (this._data.size === 0) return null;
- *     const lines = [...this._data].map(([k, v]) => `- ${k}: ${v}`);
- *     const content = `## My Plugin (${this._data.size} entries)\n\n${lines.join('\n')}`;
- *     this.updateTokenCache(this.estimator.estimateTokens(content));
- *     return content;
- *   }
- *
- *   getTools(): ToolFunction[] {
- *     return [myPluginSetTool, myPluginGetTool];
- *   }
- *
- *   getState(): unknown {
- *     return { data: Object.fromEntries(this._data) };
- *   }
- *
- *   restoreState(state: unknown): void {
- *     const s = state as { data: Record<string, string> };
- *     this._data = new Map(Object.entries(s.data || {}));
- *     this.invalidateTokenCache();
- *   }
- * }
- * ```
- */
-interface IContextPluginNextGen {
-    /** Unique plugin name (used for lookup and tool prefixing) */
-    readonly name: string;
-    /**
-     * Get usage instructions for the LLM.
-     *
-     * Returns static text explaining how to use this plugin's tools
-     * and data. This is placed in the system message and is NEVER
-     * compacted - it persists throughout the conversation.
-     *
-     * Instructions should include:
-     * - What the plugin does
-     * - How to use available tools
-     * - Best practices and conventions
-     *
-     * @returns Instructions string or null if no instructions needed
-     *
-     * @example
-     * ```typescript
-     * getInstructions(): string {
-     *   return `## Working Memory
-     *
-     * Use memory_store to save important data for later retrieval.
-     * Use memory_retrieve to recall previously stored data.
-     *
-     * Best practices:
-     * - Use descriptive keys like 'user_preferences' not 'data1'
-     * - Store intermediate results that may be needed later`;
-     * }
-     * ```
-     */
-    getInstructions(): string | null;
-    /**
-     * Get formatted content to include in system message.
-     *
-     * Returns the plugin's current state formatted for LLM consumption.
-     * Should be Markdown with a `## Header`. This content CAN be compacted
-     * if `isCompactable()` returns true.
-     *
-     * **IMPORTANT:** Call `updateTokenCache()` with the content's token size
-     * before returning to keep budget calculations accurate.
-     *
-     * @returns Formatted content string or null if empty
-     *
-     * @example
-     * ```typescript
-     * async getContent(): Promise<string | null> {
-     *   if (this._entries.size === 0) return null;
-     *
-     *   const lines = this._entries.map(e => `- ${e.key}: ${e.value}`);
-     *   const content = `## My Plugin (${this._entries.size} entries)\n\n${lines.join('\n')}`;
-     *
-     *   // IMPORTANT: Update token cache before returning
-     *   this.updateTokenCache(this.estimator.estimateTokens(content));
-     *   return content;
-     * }
-     * ```
-     */
-    getContent(): Promise<string | null>;
-    /**
-     * Get the full raw contents of this plugin for inspection.
-     *
-     * Used by library clients to programmatically inspect plugin state.
-     * Returns the actual data structure, not the formatted string.
-     *
-     * @returns Raw plugin data (entries map, array, etc.)
-     */
-    getContents(): unknown;
-    /**
-     * Get current token size of plugin content.
-     *
-     * Returns the cached token count from the last `updateTokenCache()` call.
-     * This is used for budget calculation in `prepare()`.
-     *
-     * The cache should be updated via `updateTokenCache()` whenever content
-     * changes. If cache is null, returns 0.
-     *
-     * @returns Current token count (0 if no content or cache not set)
-     */
-    getTokenSize(): number;
-    /**
-     * Get token size of instructions (cached after first call).
-     *
-     * Instructions are static, so this is computed once and cached.
-     * Used for budget calculation.
-     *
-     * @returns Token count for instructions (0 if no instructions)
-     */
-    getInstructionsTokenSize(): number;
-    /**
-     * Whether this plugin's content can be compacted when context is tight.
-     *
-     * Return true if the plugin can reduce its content size when requested.
-     * Examples: evicting low-priority entries, summarizing, removing old data.
-     *
-     * Return false if content cannot be reduced (e.g., critical state).
-     *
-     * @returns true if compact() can free tokens
-     */
-    isCompactable(): boolean;
-    /**
-     * Compact plugin content to free tokens.
-     *
-     * Called by compaction strategies when context is too full.
-     * Should attempt to free **approximately** `targetTokensToFree` tokens.
-     *
-     * This is a **best effort** operation:
-     * - May free more or less than requested
-     * - May return 0 if nothing can be compacted (e.g., all entries are critical)
-     * - Should prioritize removing lowest-priority/oldest data first
-     *
-     * Strategies may include:
-     * - Evicting low-priority entries
-     * - Summarizing verbose content
-     * - Removing oldest data
-     * - Truncating large values
-     *
-     * **IMPORTANT:** Call `invalidateTokenCache()` or `updateTokenCache()`
-     * after modifying content.
-     *
-     * @param targetTokensToFree - Approximate tokens to free (best effort)
-     * @returns Actual tokens freed (may be 0 if nothing can be compacted)
-     *
-     * @example
-     * ```typescript
-     * async compact(targetTokensToFree: number): Promise<number> {
-     *   const before = this.getTokenSize();
-     *   let freed = 0;
-     *
-     *   // Remove low-priority entries until target reached
-     *   const sorted = [...this._entries].sort(byPriority);
-     *   for (const entry of sorted) {
-     *     if (entry.priority === 'critical') continue; // Never remove critical
-     *     if (freed >= targetTokensToFree) break;
-     *
-     *     freed += entry.tokens;
-     *     this._entries.delete(entry.key);
-     *   }
-     *
-     *   this.invalidateTokenCache();
-     *   return freed;
-     * }
-     * ```
-     */
-    compact(targetTokensToFree: number): Promise<number>;
-    /**
-     * Get tools provided by this plugin.
-     *
-     * Tools are automatically registered with ToolManager when the plugin
-     * is added to the context. Use a consistent naming convention:
-     * `<prefix>_<action>` (e.g., `memory_store`, `context_set`).
-     *
-     * @returns Array of tool definitions (empty array if no tools)
-     */
-    getTools(): ToolFunction[];
-    /**
-     * Cleanup resources when context is destroyed.
-     *
-     * Called when AgentContextNextGen.destroy() is invoked.
-     * Use for releasing resources, closing connections, etc.
-     */
-    destroy(): void;
-    /**
-     * Serialize plugin state for session persistence.
-     *
-     * **MUST be synchronous.** Return a JSON-serializable object representing
-     * the plugin's current state. This is called when saving a session.
-     *
-     * For plugins with async data (e.g., external storage), return only
-     * references/keys here and handle async restoration separately.
-     *
-     * @returns Serializable state object
-     *
-     * @example
-     * ```typescript
-     * getState(): unknown {
-     *   return {
-     *     entries: [...this._entries].map(([k, v]) => ({ key: k, ...v })),
-     *     version: 1,  // Include version for future migrations
-     *   };
-     * }
-     * ```
-     */
-    getState(): unknown;
-    /**
-     * Restore plugin state from serialized data.
-     *
-     * Called when loading a saved session. The state comes from a previous
-     * `getState()` call on the same plugin type.
-     *
-     * **IMPORTANT:** Call `invalidateTokenCache()` after restoring state
-     * to ensure token counts are recalculated.
-     *
-     * @param state - Previously serialized state from getState()
-     *
-     * @example
-     * ```typescript
-     * restoreState(state: unknown): void {
-     *   const s = state as { entries: Array<{ key: string; value: unknown }> };
-     *   this._entries.clear();
-     *   for (const entry of s.entries || []) {
-     *     this._entries.set(entry.key, entry);
-     *   }
-     *   this.invalidateTokenCache(); // IMPORTANT: refresh token cache
-     * }
-     * ```
-     */
-    restoreState(state: unknown): void;
-}
-/**
- * Token budget breakdown - clear and simple
- */
-interface ContextBudget$1 {
-    /** Maximum context tokens for the model */
-    maxTokens: number;
-    /** Tokens reserved for LLM response */
-    responseReserve: number;
-    /** Tokens used by system message (prompt + instructions + plugin content) */
-    systemMessageTokens: number;
-    /** Tokens used by tool definitions (NEVER compacted) */
-    toolsTokens: number;
-    /** Tokens used by conversation history */
-    conversationTokens: number;
-    /** Tokens used by current input (user message or tool results) */
-    currentInputTokens: number;
-    /** Total tokens used */
-    totalUsed: number;
-    /** Available tokens (maxTokens - responseReserve - totalUsed) */
-    available: number;
-    /** Usage percentage (totalUsed / (maxTokens - responseReserve)) */
-    utilizationPercent: number;
-    /** Breakdown by component for debugging */
-    breakdown: {
-        systemPrompt: number;
-        persistentInstructions: number;
-        pluginInstructions: number;
-        pluginContents: Record<string, number>;
-        tools: number;
-        conversation: number;
-        currentInput: number;
-    };
-}
-/**
- * Result of prepare() - ready for LLM call
- */
-interface PreparedContext {
-    /** Final input items array for LLM */
-    input: InputItem[];
-    /** Token budget breakdown */
-    budget: ContextBudget$1;
-    /** Whether compaction was performed */
-    compacted: boolean;
-    /** Log of compaction actions taken */
-    compactionLog: string[];
-}
-/**
- * Result of handling oversized current input
- */
-interface OversizedInputResult {
-    /** Whether the input was accepted (possibly truncated) */
-    accepted: boolean;
-    /** Processed content (truncated if needed) */
-    content: string;
-    /** Error message if rejected */
-    error?: string;
-    /** Warning message if truncated */
-    warning?: string;
-    /** Original size in bytes */
-    originalSize: number;
-    /** Final size in bytes */
-    finalSize: number;
-}
-/**
- * Feature flags for enabling/disabling plugins
- */
-interface ContextFeatures {
-    /** Enable WorkingMemory plugin (default: true) */
-    workingMemory?: boolean;
-    /** Enable InContextMemory plugin (default: false) */
-    inContextMemory?: boolean;
-    /** Enable PersistentInstructions plugin (default: false) */
-    persistentInstructions?: boolean;
-    /** Enable UserInfo plugin (default: false) */
-    userInfo?: boolean;
-}
-/**
- * Default feature configuration
- */
-declare const DEFAULT_FEATURES: Required<ContextFeatures>;
-/**
- * Plugin configurations for auto-initialization.
- * When features are enabled, plugins are created with these configs.
- * The config shapes match each plugin's constructor parameter.
- */
-interface PluginConfigs {
-    /**
-     * Working memory plugin config (used when features.workingMemory=true).
-     * See WorkingMemoryPluginConfig for full options.
-     */
-    workingMemory?: Record<string, unknown>;
-    /**
-     * In-context memory plugin config (used when features.inContextMemory=true).
-     * See InContextMemoryConfig for full options.
-     */
-    inContextMemory?: Record<string, unknown>;
-    /**
-     * Persistent instructions plugin config (used when features.persistentInstructions=true).
-     * Note: agentId is auto-filled from context config if not provided.
-     * See PersistentInstructionsConfig for full options.
-     */
-    persistentInstructions?: Record<string, unknown>;
-    /**
-     * User info plugin config (used when features.userInfo=true).
-     * See UserInfoPluginConfig for full options.
-     */
-    userInfo?: Record<string, unknown>;
-}
-/**
- * AgentContextNextGen configuration
- */
-interface AgentContextNextGenConfig {
-    /** Model name (used for context window lookup) */
-    model: string;
-    /** Maximum context tokens (auto-detected from model if not provided) */
-    maxContextTokens?: number;
-    /** Tokens to reserve for response (default: 4096) */
-    responseReserve?: number;
-    /** System prompt provided by user */
-    systemPrompt?: string;
-    /**
-     * Compaction strategy name (default: 'default').
-     * Used to create strategy from StrategyRegistry if compactionStrategy not provided.
-     */
-    strategy?: string;
-    /**
-     * Custom compaction strategy instance.
-     * If provided, overrides the `strategy` option.
-     */
-    compactionStrategy?: ICompactionStrategy;
-    /** Feature flags */
-    features?: ContextFeatures;
-    /** Agent ID (required for PersistentInstructions) */
-    agentId?: string;
-    /** User ID for multi-user scenarios. Automatically flows to ToolContext for all tool executions. */
-    userId?: string;
-    /**
-     * Restrict this agent to a subset of registered connectors (by name).
-     * When set, only these connectors are visible in ToolContext.connectorRegistry
-     * and in dynamic tool descriptions (e.g., execute_javascript).
-     * When not set, all connectors visible to the current userId are available.
-     */
-    connectors?: string[];
-    /** Initial tools to register */
-    tools?: ToolFunction[];
-    /** Storage for session persistence */
-    storage?: IContextStorage;
-    /** Plugin-specific configurations (used with features flags) */
-    plugins?: PluginConfigs;
-    /**
-     * Hard timeout in milliseconds for any single tool execution.
-     * Acts as a safety net: if a tool's own timeout mechanism fails
-     * (e.g. a child process doesn't exit), this will force-resolve with an error.
-     * Default: 0 (disabled - relies on each tool's own timeout)
-     */
-    toolExecutionTimeout?: number;
-}
-/**
- * Default configuration values
- */
-declare const DEFAULT_CONFIG: {
-    responseReserve: number;
-    strategy: string;
-};
-
-/**
- * Events emitted by AgentContextNextGen
- */
-interface ContextEvents {
-    /** Emitted when context is prepared */
-    'context:prepared': {
-        budget: ContextBudget$1;
-        compacted: boolean;
-    };
-    /** Emitted when compaction is performed */
-    'context:compacted': {
-        tokensFreed: number;
-        log: string[];
-    };
-    /** Emitted right after budget is calculated in prepare() - for reactive monitoring */
-    'budget:updated': {
-        budget: ContextBudget$1;
-        timestamp: number;
-    };
-    /** Emitted when budget reaches warning threshold (>70%) */
-    'budget:warning': {
-        budget: ContextBudget$1;
-    };
-    /** Emitted when budget reaches critical threshold (>90%) */
-    'budget:critical': {
-        budget: ContextBudget$1;
-    };
-    /** Emitted when compaction is about to start */
-    'compaction:starting': {
-        budget: ContextBudget$1;
-        targetTokensToFree: number;
-        timestamp: number;
-    };
-    /** Emitted when current input is too large */
-    'input:oversized': {
-        result: OversizedInputResult;
-    };
-    /** Emitted when a message is added */
-    'message:added': {
-        role: string;
-        index: number;
-    };
-    /** Emitted when conversation is cleared */
-    'conversation:cleared': {
-        reason?: string;
-    };
-}
-/**
- * Callback type for beforeCompaction hook.
- * Called before compaction starts, allowing agents to save important data.
- */
-type BeforeCompactionCallback = (info: {
-    budget: ContextBudget$1;
-    targetTokensToFree: number;
-    strategy: string;
-}) => Promise<void>;
-/**
- * Result of compact() operation.
- */
-interface CompactionResult {
-    /** Tokens actually freed by compaction */
-    tokensFreed: number;
-    /** Number of messages removed from conversation */
-    messagesRemoved: number;
-    /** Names of plugins that were compacted */
-    pluginsCompacted: string[];
-    /** Log of actions taken during compaction */
-    log: string[];
-}
-/**
- * Result of consolidate() operation.
- */
-interface ConsolidationResult {
-    /** Whether any consolidation was performed */
-    performed: boolean;
-    /** Net token change (negative = freed, positive = added, e.g., summaries) */
-    tokensChanged: number;
-    /** Description of actions taken */
-    actions: string[];
-}
-/**
- * Read-only context passed to compaction strategies.
- * Provides access to data needed for compaction decisions and
- * controlled methods to modify state.
- */
-interface CompactionContext {
-    /** Current budget (from prepare) */
-    readonly budget: ContextBudget$1;
-    /** Current conversation history (read-only) */
-    readonly conversation: ReadonlyArray<InputItem>;
-    /** Current input (read-only) */
-    readonly currentInput: ReadonlyArray<InputItem>;
-    /** Registered plugins (for querying state) */
-    readonly plugins: ReadonlyArray<IContextPluginNextGen>;
-    /** Strategy name for logging */
-    readonly strategyName: string;
-    /**
-     * Remove messages by indices.
-     * Handles tool pair preservation internally.
-     *
-     * @param indices - Array of message indices to remove
-     * @returns Tokens actually freed
-     */
-    removeMessages(indices: number[]): Promise<number>;
-    /**
-     * Compact a specific plugin.
-     *
-     * @param pluginName - Name of the plugin to compact
-     * @param targetTokens - Approximate tokens to free
-     * @returns Tokens actually freed
-     */
-    compactPlugin(pluginName: string, targetTokens: number): Promise<number>;
-    /**
-     * Estimate tokens for an item.
-     *
-     * @param item - Input item to estimate
-     * @returns Estimated token count
-     */
-    estimateTokens(item: InputItem): number;
-}
-/**
- * Compaction strategy interface.
- *
- * Strategies implement two methods:
- * - `compact()`: Emergency compaction when thresholds exceeded (called from prepare())
- * - `consolidate()`: Post-cycle cleanup and optimization (called after agentic loop)
- *
- * Use `compact()` for quick, threshold-based token reduction.
- * Use `consolidate()` for more expensive operations like summarization.
- */
-interface ICompactionStrategy {
-    /** Strategy name (unique identifier) for identification and logging */
-    readonly name: string;
-    /** Human-readable display name for UI */
-    readonly displayName: string;
-    /** Description explaining the strategy behavior */
-    readonly description: string;
-    /** Threshold percentage (0-1) at which compact() is triggered */
-    readonly threshold: number;
-    /**
-     * Plugin names this strategy requires to function.
-     * Validation is performed when strategy is assigned to context.
-     * If any required plugin is missing, an error is thrown.
-     *
-     * @example
-     * ```typescript
-     * readonly requiredPlugins = ['working_memory'] as const;
-     * ```
-     */
-    readonly requiredPlugins?: readonly string[];
-    /**
-     * Emergency compaction - triggered when context usage exceeds threshold.
-     * Called from prepare() when utilization > threshold.
-     *
-     * Should be fast and focus on freeing tokens quickly.
-     *
-     * @param context - Compaction context with controlled access to state
-     * @param targetToFree - Approximate tokens to free
-     * @returns Result describing what was done
-     */
-    compact(context: CompactionContext, targetToFree: number): Promise<CompactionResult>;
-    /**
-     * Post-cycle consolidation - run after agentic cycle completes.
-     * Called from Agent after run()/stream() finishes (before session save).
-     *
-     * Use for more expensive operations:
-     * - Summarizing long conversations
-     * - Memory optimization and deduplication
-     * - Promoting important data to persistent storage
-     *
-     * @param context - Compaction context with controlled access to state
-     * @returns Result describing what was done
-     */
-    consolidate(context: CompactionContext): Promise<ConsolidationResult>;
-}
-
 /**
  * IAgentDefinitionStorage - Storage interface for Agent configuration persistence
  *
@@ -1560,6 +722,7 @@ interface IUserInfoStorage {
  *
  * Defines the data structures for task-based autonomous agents.
  */
+
 /**
  * Task status lifecycle
  */
@@ -1615,6 +778,65 @@ interface ExternalDependency {
     receivedData?: unknown;
     receivedAt?: number;
 }
+/** Sub-routine specification: either inline tasks or a full RoutineDefinition */
+type SubRoutineSpec = TaskInput[] | RoutineDefinition;
+/** Reference to a source value for control flow operations. */
+interface TaskSourceRef {
+    /** Reference the output of a named task (resolves to __task_output_{name}) */
+    task?: string;
+    /** Direct memory key lookup */
+    key?: string;
+    /** JSON path to extract from the resolved value (e.g., 'data.items', 'results[0].entries') */
+    path?: string;
+}
+/** Source can be a simple key string (legacy) or a structured reference. */
+type ControlFlowSource = string | TaskSourceRef;
+/** Map: execute a sub-routine for each element in an array */
+interface TaskMapFlow {
+    type: 'map';
+    /** Source array reference — task name, memory key, or structured ref. */
+    source: ControlFlowSource;
+    /** Sub-routine to run per element */
+    tasks: SubRoutineSpec;
+    /** Memory key for collected results array */
+    resultKey?: string;
+    /** Cap iterations (default: array.length, hard max: 1000) */
+    maxIterations?: number;
+    /** Timeout per sub-execution iteration in ms (default: no timeout) */
+    iterationTimeoutMs?: number;
+}
+/** Fold: accumulate a result across array elements */
+interface TaskFoldFlow {
+    type: 'fold';
+    /** Source array reference — task name, memory key, or structured ref. */
+    source: ControlFlowSource;
+    /** Sub-routine to run per element */
+    tasks: SubRoutineSpec;
+    /** Starting accumulator value */
+    initialValue: unknown;
+    /** Memory key for final accumulated result */
+    resultKey: string;
+    /** Cap iterations (default: array.length, hard max: 1000) */
+    maxIterations?: number;
+    /** Timeout per sub-execution iteration in ms (default: no timeout) */
+    iterationTimeoutMs?: number;
+}
+/** Until: repeat a sub-routine until a condition is met */
+interface TaskUntilFlow {
+    type: 'until';
+    /** Sub-routine to run each iteration */
+    tasks: SubRoutineSpec;
+    /** Checked AFTER each iteration (reuses existing TaskCondition type) */
+    condition: TaskCondition;
+    /** Maximum iterations (required — no default) */
+    maxIterations: number;
+    /** Optional ICM key for current iteration index */
+    iterationKey?: string;
+    /** Timeout per sub-execution iteration in ms (default: no timeout) */
+    iterationTimeoutMs?: number;
+}
+/** Union of all control flow types */
+type TaskControlFlow = TaskMapFlow | TaskFoldFlow | TaskUntilFlow;
 /**
  * Task execution settings
  */
@@ -1741,6 +963,8 @@ interface Task {
     suggestedTools?: string[];
     /** Optional expected output description */
     expectedOutput?: string;
+    /** Control flow: map, fold, or until (replaces normal LLM execution for this task) */
+    controlFlow?: TaskControlFlow;
     /** Result after completion */
     result?: {
         success: boolean;
@@ -1776,6 +1000,7 @@ interface TaskInput {
     suggestedTools?: string[];
     validation?: TaskValidation;
     expectedOutput?: string;
+    controlFlow?: TaskControlFlow;
     maxAttempts?: number;
     metadata?: Record<string, unknown>;
 }
@@ -1894,6 +1119,20 @@ declare function detectDependencyCycle(tasks: Task[]): string[] | null;
  * A RoutineExecution is a running instance backed by an existing Plan.
  */
 
+/**
+ * A parameter that a routine accepts as input.
+ * Enables parameterized, reusable routines.
+ */
+interface RoutineParameter {
+    /** Parameter name (used as {{param.name}} in templates) */
+    name: string;
+    /** Human-readable description */
+    description: string;
+    /** Whether this parameter must be provided (default: false) */
+    required?: boolean;
+    /** Default value when not provided */
+    default?: unknown;
+}
 /**
  * A reusable routine definition (template).
  *
@@ -1921,6 +1160,8 @@ interface RoutineDefinition {
     concurrency?: PlanConcurrency;
     /** Whether the LLM can dynamically add/modify tasks during execution. Default: false */
     allowDynamicTasks?: boolean;
+    /** Input parameters this routine accepts (templates use {{param.name}}) */
+    parameters?: RoutineParameter[];
     /** Tags for categorization and filtering */
     tags?: string[];
     /** Author/creator */
@@ -1947,6 +1188,7 @@ interface RoutineDefinitionInput {
     instructions?: string;
     concurrency?: PlanConcurrency;
     allowDynamicTasks?: boolean;
+    parameters?: RoutineParameter[];
     tags?: string[];
     author?: string;
     metadata?: Record<string, unknown>;
@@ -1964,55 +1206,151 @@ interface RoutineExecution {
     id: string;
     /** Reference to the routine definition ID */
     routineId: string;
-    /** The live plan managing task execution (created via createPlan) */
-    plan: Plan;
-    /** Current execution status */
+    /** The live plan managing task execution (created via createPlan) */
+    plan: Plan;
+    /** Current execution status */
+    status: RoutineExecutionStatus;
+    /** Overall progress (0-100) based on completed tasks */
+    progress: number;
+    /** Timestamps */
+    startedAt?: number;
+    completedAt?: number;
+    lastUpdatedAt: number;
+    /** Error message if failed */
+    error?: string;
+    /** Metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Create a RoutineDefinition with defaults.
+ * Validates task dependency references and detects cycles.
+ */
+declare function createRoutineDefinition(input: RoutineDefinitionInput): RoutineDefinition;
+/**
+ * Create a RoutineExecution from a RoutineDefinition.
+ * Instantiates all tasks into a Plan via createPlan().
+ */
+declare function createRoutineExecution(definition: RoutineDefinition): RoutineExecution;
+/**
+ * Compute routine progress (0-100) from plan task statuses.
+ */
+declare function getRoutineProgress(execution: RoutineExecution): number;
+
+/**
+ * IRoutineDefinitionStorage - Storage interface for routine definitions.
+ *
+ * Follows the same userId-optional pattern as ICustomToolStorage and IUserInfoStorage.
+ * When userId is undefined, defaults to 'default' user in storage implementation.
+ */
+
+interface IRoutineDefinitionStorage {
+    save(userId: string | undefined, definition: RoutineDefinition): Promise<void>;
+    load(userId: string | undefined, id: string): Promise<RoutineDefinition | null>;
+    delete(userId: string | undefined, id: string): Promise<void>;
+    exists(userId: string | undefined, id: string): Promise<boolean>;
+    list(userId: string | undefined, options?: {
+        tags?: string[];
+        search?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<RoutineDefinition[]>;
+    getPath(userId: string | undefined): string;
+}
+
+/**
+ * Routine Execution Record — persisted record for tracking/history.
+ *
+ * Unlike RoutineExecution (runtime state with live Plan), this is a
+ * storage-agnostic snapshot meant for persistence and querying.
+ * Timestamps are `number` (epoch ms), no framework dependencies.
+ */
+
+type RoutineStepType = 'task.started' | 'task.completed' | 'task.failed' | 'task.validation' | 'tool.call' | 'tool.start' | 'llm.start' | 'llm.complete' | 'iteration.complete' | 'execution.error' | 'control_flow.started' | 'control_flow.completed';
+interface RoutineExecutionStep {
+    timestamp: number;
+    taskName: string;
+    type: RoutineStepType;
+    data?: Record<string, unknown>;
+}
+interface RoutineTaskResult {
+    success: boolean;
+    output?: string;
+    error?: string;
+    validationScore?: number;
+    validationExplanation?: string;
+}
+interface RoutineTaskSnapshot {
+    taskId: string;
+    name: string;
+    description: string;
+    status: 'pending' | 'blocked' | 'in_progress' | 'completed' | 'failed' | 'skipped' | 'cancelled';
+    attempts: number;
+    maxAttempts: number;
+    result?: RoutineTaskResult;
+    startedAt?: number;
+    completedAt?: number;
+    controlFlowType?: 'map' | 'fold' | 'until';
+}
+interface RoutineExecutionRecord {
+    executionId: string;
+    routineId: string;
+    routineName: string;
     status: RoutineExecutionStatus;
-    /** Overall progress (0-100) based on completed tasks */
     progress: number;
-    /** Timestamps */
+    tasks: RoutineTaskSnapshot[];
+    steps: RoutineExecutionStep[];
+    taskCount: number;
+    connectorName: string;
+    model: string;
+    error?: string;
     startedAt?: number;
     completedAt?: number;
-    lastUpdatedAt: number;
-    /** Error message if failed */
-    error?: string;
-    /** Metadata */
+    lastActivityAt?: number;
+    trigger?: {
+        type: 'schedule' | 'event' | 'manual';
+        source?: string;
+        event?: string;
+        payload?: unknown;
+    };
     metadata?: Record<string, unknown>;
 }
 /**
- * Create a RoutineDefinition with defaults.
- * Validates task dependency references and detects cycles.
- */
-declare function createRoutineDefinition(input: RoutineDefinitionInput): RoutineDefinition;
-/**
- * Create a RoutineExecution from a RoutineDefinition.
- * Instantiates all tasks into a Plan via createPlan().
+ * Create initial task snapshots from a routine definition.
  */
-declare function createRoutineExecution(definition: RoutineDefinition): RoutineExecution;
+declare function createTaskSnapshots(definition: RoutineDefinition): RoutineTaskSnapshot[];
 /**
- * Compute routine progress (0-100) from plan task statuses.
+ * Create an initial RoutineExecutionRecord from a definition.
+ * Status is set to 'running' with empty steps.
  */
-declare function getRoutineProgress(execution: RoutineExecution): number;
+declare function createRoutineExecutionRecord(definition: RoutineDefinition, connectorName: string, model: string, trigger?: RoutineExecutionRecord['trigger']): RoutineExecutionRecord;
 
 /**
- * IRoutineDefinitionStorage - Storage interface for routine definitions.
+ * Storage interface for routine execution records.
  *
- * Follows the same userId-optional pattern as ICustomToolStorage and IUserInfoStorage.
- * When userId is undefined, defaults to 'default' user in storage implementation.
+ * Designed to be storage-agnostic — implementations can back this with
+ * MongoDB, PostgreSQL, file system, etc.
  */
 
-interface IRoutineDefinitionStorage {
-    save(userId: string | undefined, definition: RoutineDefinition): Promise<void>;
-    load(userId: string | undefined, id: string): Promise<RoutineDefinition | null>;
-    delete(userId: string | undefined, id: string): Promise<void>;
-    exists(userId: string | undefined, id: string): Promise<boolean>;
+interface IRoutineExecutionStorage {
+    /** Insert a new execution record. Returns the record ID. */
+    insert(userId: string | undefined, record: RoutineExecutionRecord): Promise<string>;
+    /** Update top-level fields on an execution record. */
+    update(id: string, updates: Partial<Pick<RoutineExecutionRecord, 'status' | 'progress' | 'error' | 'completedAt' | 'lastActivityAt'>>): Promise<void>;
+    /** Append a step to the execution's steps array. */
+    pushStep(id: string, step: RoutineExecutionStep): Promise<void>;
+    /** Update a specific task snapshot within the execution record. */
+    updateTask(id: string, taskName: string, updates: Partial<RoutineTaskSnapshot>): Promise<void>;
+    /** Load a single execution record by ID. */
+    load(id: string): Promise<RoutineExecutionRecord | null>;
+    /** List execution records with optional filters. */
     list(userId: string | undefined, options?: {
-        tags?: string[];
-        search?: string;
+        routineId?: string;
+        status?: RoutineExecutionStatus;
         limit?: number;
         offset?: number;
-    }): Promise<RoutineDefinition[]>;
-    getPath(userId: string | undefined): string;
+    }): Promise<RoutineExecutionRecord[]>;
+    /** Check if a routine has a currently running execution. */
+    hasRunning(userId: string | undefined, routineId: string): Promise<boolean>;
 }
 
 /**
@@ -2077,6 +1415,7 @@ interface StorageConfig {
     workingMemory: (context?: StorageContext) => IMemoryStorage;
     userInfo: (context?: StorageContext) => IUserInfoStorage;
     routineDefinitions: (context?: StorageContext) => IRoutineDefinitionStorage;
+    routineExecutions: (context?: StorageContext) => IRoutineExecutionStorage;
 }
 declare class StorageRegistry {
     /** Internal storage map */
@@ -2724,6 +2063,14 @@ declare class ToolManager extends EventEmitter implements IToolExecutor, IDispos
      * Register multiple tools at once
      */
     registerMany(tools: ToolFunction[], options?: Omit<ToolOptions, 'conditions'>): void;
+    /**
+     * Register tools produced by a specific connector.
+     * Sets `source: 'connector:<connectorName>'` (or `'connector:<name>:<accountId>'` for identity-bound tools)
+     * so agent-level filtering can restrict which connector tools are visible to a given agent.
+     */
+    registerConnectorTools(connectorName: string, tools: ToolFunction[], options?: Omit<ToolOptions, 'source'> & {
+        accountId?: string;
+    }): void;
     /**
      * Unregister a tool by name
      */
@@ -2801,6 +2148,12 @@ declare class ToolManager extends EventEmitter implements IToolExecutor, IDispos
      * Get all enabled tools (sorted by priority)
      */
     getEnabled(): ToolFunction[];
+    /**
+     * Get all enabled registrations (sorted by priority).
+     * Includes full registration metadata (source, namespace, etc.)
+     * for use in connector-aware filtering.
+     */
+    getEnabledRegistrations(): ToolRegistration[];
     /**
      * Get all tools (enabled and disabled)
      */
@@ -2809,6 +2162,11 @@ declare class ToolManager extends EventEmitter implements IToolExecutor, IDispos
      * Get tools by namespace
      */
     getByNamespace(namespace: string): ToolFunction[];
+    /**
+     * Get all registered tool names in a category.
+     * Used by ToolCatalogPlugin for bulk enable/disable.
+     */
+    getByCategory(category: string): string[];
     /**
      * Get tool registration info
      */
@@ -3736,8 +3094,8 @@ declare class AgentContextNextGen extends EventEmitter<ContextEvents> {
     private readonly _agentId;
     /** User ID for multi-user scenarios */
     private _userId;
-    /** Allowed connector names (when agent is restricted to a subset) */
-    private _allowedConnectors;
+    /** Auth identities this agent is scoped to (connector + optional accountId) */
+    private _identities;
     /** Storage backend */
     private readonly _storage?;
     /** Destroyed flag */
@@ -3768,7 +3126,7 @@ declare class AgentContextNextGen extends EventEmitter<ContextEvents> {
      * Merges with existing ToolContext to preserve other fields (memory, signal, taskId).
      *
      * Connector registry resolution order:
-     * 1. If `connectors` (allowed names) is set → filtered view of global registry
+     * 1. If `identities` is set → filtered view showing only identity connectors
      * 2. If access policy + userId → scoped view via Connector.scoped()
      * 3. Otherwise → full global registry
      */
@@ -3787,10 +3145,10 @@ declare class AgentContextNextGen extends EventEmitter<ContextEvents> {
     get userId(): string | undefined;
     /** Set user ID. Automatically updates ToolContext for all tool executions. */
     set userId(value: string | undefined);
-    /** Get the allowed connector names (undefined = all visible connectors) */
-    get connectors(): string[] | undefined;
-    /** Set allowed connector names. Updates ToolContext.connectorRegistry. */
-    set connectors(value: string[] | undefined);
+    /** Get the auth identities this agent is scoped to (undefined = all visible connectors) */
+    get identities(): AuthIdentity[] | undefined;
+    /** Set auth identities. Updates ToolContext.connectorRegistry and identity-aware descriptions. */
+    set identities(value: AuthIdentity[] | undefined);
     /** Get/set system prompt */
     get systemPrompt(): string | undefined;
     set systemPrompt(value: string | undefined);
@@ -4239,11 +3597,11 @@ interface BaseAgentConfig {
     /** User ID for multi-user scenarios. Flows to ToolContext automatically for all tool executions. */
     userId?: string;
     /**
-     * Restrict this agent to a subset of registered connectors (by name).
-     * Only these connectors will be visible in tool descriptions and sandbox execution.
+     * Restrict this agent to specific auth identities (connector + optional account alias).
+     * Each identity produces its own tool set (e.g., microsoft_work_api, microsoft_personal_api).
      * When not set, all connectors visible to the current userId are available.
      */
-    connectors?: string[];
+    identities?: AuthIdentity[];
     /** Tools available to the agent */
     tools?: ToolFunction[];
     /** Provide a pre-configured ToolManager (advanced) */
@@ -4423,13 +3781,13 @@ declare abstract class BaseAgent<TConfig extends BaseAgentConfig = BaseAgentConf
      */
     set userId(value: string | undefined);
     /**
-     * Get the allowed connector names (undefined = all visible connectors).
+     * Get the auth identities this agent is scoped to (undefined = all visible connectors).
      */
-    get connectors(): string[] | undefined;
+    get identities(): AuthIdentity[] | undefined;
     /**
-     * Restrict this agent to a subset of connectors. Updates ToolContext.connectorRegistry.
+     * Set auth identities at runtime. Updates ToolContext.connectorRegistry and tool descriptions.
      */
-    set connectors(value: string[] | undefined);
+    set identities(value: AuthIdentity[] | undefined);
     /**
      * Permission management. Returns ToolPermissionManager for approval control.
      */
@@ -4437,8 +3795,11 @@ declare abstract class BaseAgent<TConfig extends BaseAgentConfig = BaseAgentConf
     /**
      * Add a tool to the agent.
      * Tools are registered with AgentContext (single source of truth).
+     *
+     * @param tool - The tool function to register
+     * @param options - Optional registration options (namespace, source, priority, etc.)
      */
-    addTool(tool: ToolFunction): void;
+    addTool(tool: ToolFunction, options?: ToolOptions): void;
     /**
      * Remove a tool from the agent.
      * Tools are unregistered from AgentContext (single source of truth).
@@ -4925,6 +4286,8 @@ interface ExecuteRoutineOptions {
     model?: string;
     /** Additional tools — only used when creating a new agent (no `agent` provided) */
     tools?: ToolFunction[];
+    /** Input parameter values for parameterized routines */
+    inputs?: Record<string, unknown>;
     /** Hooks — applied to agent for the duration of routine execution.
      *  For new agents: baked in at creation. For existing agents: registered before
      *  execution and unregistered after. */
@@ -4941,8 +4304,8 @@ interface ExecuteRoutineOptions {
     prompts?: {
         /** Override system prompt builder. Receives definition, should return full system prompt. */
         system?: (definition: RoutineDefinition) => string;
-        /** Override task prompt builder. Receives task, should return the user message for that task. */
-        task?: (task: Task) => string;
+        /** Override task prompt builder. Receives task and optional execution context, should return the user message for that task. */
+        task?: (task: Task, execution?: RoutineExecution) => string;
         /** Override validation prompt builder. Receives task + validation context (response, memory state, tool calls). */
         validation?: (task: Task, context: ValidationContext) => string;
     };
@@ -4984,6 +4347,64 @@ interface ValidationContext {
  */
 declare function executeRoutine(options: ExecuteRoutineOptions): Promise<RoutineExecution>;
 
+/**
+ * Execution Recorder Factory
+ *
+ * Creates ready-to-use hooks + callbacks for `executeRoutine()` that
+ * persist execution state to an IRoutineExecutionStorage backend.
+ *
+ * Replaces the manual hook wiring previously done in v25's
+ * RoutineExecutionService._runInBackground().
+ *
+ * @example
+ * ```typescript
+ * const record = createRoutineExecutionRecord(definition, connector, model);
+ * const execId = await storage.insert(userId, record);
+ * const recorder = createExecutionRecorder({ storage, executionId: execId });
+ *
+ * executeRoutine({
+ *   definition, agent, inputs,
+ *   hooks: recorder.hooks,
+ *   onTaskStarted: recorder.onTaskStarted,
+ *   onTaskComplete: recorder.onTaskComplete,
+ *   onTaskFailed: recorder.onTaskFailed,
+ *   onTaskValidation: recorder.onTaskValidation,
+ * })
+ *   .then(exec => recorder.finalize(exec))
+ *   .catch(err => recorder.finalize(null, err));
+ * ```
+ */
+
+interface ExecutionRecorderOptions {
+    /** Storage backend for persisting execution state. */
+    storage: IRoutineExecutionStorage;
+    /** ID of the execution record (must already be inserted). */
+    executionId: string;
+    /** Optional prefix for log messages. */
+    logPrefix?: string;
+    /** Max length for truncated tool args/results in steps. Default: 500. */
+    maxTruncateLength?: number;
+}
+interface ExecutionRecorder {
+    /** Hook config to pass to executeRoutine(). */
+    hooks: HookConfig;
+    /** Callback for onTaskStarted. */
+    onTaskStarted: (task: Task, execution: RoutineExecution) => void;
+    /** Callback for onTaskComplete. */
+    onTaskComplete: (task: Task, execution: RoutineExecution) => void;
+    /** Callback for onTaskFailed. */
+    onTaskFailed: (task: Task, execution: RoutineExecution) => void;
+    /** Callback for onTaskValidation. */
+    onTaskValidation: (task: Task, result: TaskValidationResult, execution: RoutineExecution) => void;
+    /** Call after executeRoutine() resolves/rejects to write final status. */
+    finalize: (execution: RoutineExecution | null, error?: Error) => Promise<void>;
+}
+/**
+ * Create an ExecutionRecorder that wires hooks + callbacks to persist
+ * execution state via the provided storage backend.
+ */
+declare function createExecutionRecorder(options: ExecutionRecorderOptions): ExecutionRecorder;
+
 /**
  * BasePluginNextGen - Base class for context plugins
  *
@@ -5545,12 +4966,15 @@ declare class PersistentInstructionsPluginNextGen implements IContextPluginNextG
  * - User preferences (theme, language, timezone)
  * - User context (location, role, permissions)
  * - User metadata (name, email, profile info)
+ * - TODO tracking (stored as entries with `todo_` key prefix)
  *
  * Storage: ~/.oneringai/users/<userId>/user_info.json
  *
  * Design:
  * - UserId passed at construction time from AgentContextNextGen._userId
  * - User data IS injected into context via getContent() (entries rendered as markdown)
+ * - TODOs rendered in a separate "## Current TODOs" section as a checklist
+ * - Internal entries (key starts with `_`) hidden from rendered output
  * - In-memory cache with lazy loading + write-through to storage
  * - Tools access current user's data only (no cross-user access)
  */
@@ -5623,6 +5047,82 @@ declare class UserInfoPluginNextGen implements IContextPluginNextGen {
     private createUserInfoGetTool;
     private createUserInfoRemoveTool;
     private createUserInfoClearTool;
+    private createTodoAddTool;
+    private createTodoUpdateTool;
+    private createTodoRemoveTool;
+}
+
+/**
+ * ToolCatalogPluginNextGen - Dynamic Tool Loading/Unloading for Agents
+ *
+ * When agents need 100+ tools, sending all tool definitions to the LLM wastes
+ * tokens and degrades performance. This plugin provides 3 metatools that let
+ * agents discover and load only the tool categories they need.
+ *
+ * Categories come from ToolCatalogRegistry (static global) and ConnectorTools
+ * (runtime discovery). The plugin manages loaded/unloaded state via ToolManager.
+ *
+ * @example
+ * ```typescript
+ * const ctx = AgentContextNextGen.create({
+ *   model: 'gpt-4',
+ *   features: { toolCatalog: true },
+ *   toolCategories: ['filesystem', 'web'],  // optional scope
+ * });
+ * ```
+ */
+
+interface ToolCatalogPluginConfig {
+    /** Scope filter for which categories are visible */
+    categoryScope?: ToolCategoryScope;
+    /** Categories to pre-load on initialization */
+    autoLoadCategories?: string[];
+    /** Maximum loaded categories at once (default: 10) */
+    maxLoadedCategories?: number;
+    /** Auth identities for connector filtering */
+    identities?: AuthIdentity[];
+}
+declare class ToolCatalogPluginNextGen extends BasePluginNextGen {
+    readonly name = "tool_catalog";
+    /** category name → array of tool names that were loaded */
+    private _loadedCategories;
+    /** Reference to the ToolManager for registering/disabling tools */
+    private _toolManager;
+    /** Cached connector categories — discovered once in setToolManager() */
+    private _connectorCategories;
+    /** Whether this plugin has been destroyed */
+    private _destroyed;
+    /** WeakMap cache for tool definition token estimates */
+    private _toolTokenCache;
+    private _config;
+    constructor(config?: ToolCatalogPluginConfig);
+    getInstructions(): string;
+    getContent(): Promise<string | null>;
+    getContents(): unknown;
+    getTools(): ToolFunction[];
+    isCompactable(): boolean;
+    compact(targetTokensToFree: number): Promise<number>;
+    getState(): unknown;
+    restoreState(state: unknown): void;
+    destroy(): void;
+    /**
+     * Set the ToolManager reference. Called by AgentContextNextGen after plugin registration.
+     */
+    setToolManager(tm: ToolManager): void;
+    /** Get list of currently loaded category names */
+    get loadedCategories(): string[];
+    private executeSearch;
+    executeLoad(category: string): Record<string, unknown>;
+    private executeUnload;
+    private getAllowedCategories;
+    /**
+     * Get connector categories from cache (populated once in setToolManager).
+     */
+    private getConnectorCategories;
+    private keywordSearch;
+    private searchConnectorCategory;
+    private getCategoriesSortedByLastUsed;
+    private estimateToolDefinitionTokens;
 }
 
 /**
@@ -9846,6 +9346,66 @@ declare class InMemoryHistoryStorage implements IHistoryStorage {
     restoreState(state: SerializedHistoryState): Promise<void>;
 }
 
+/**
+ * Routine Control Flow — map, fold, until handlers + template resolution
+ *
+ * Control flow tasks delegate to executeRoutine() recursively with the shared agent,
+ * using ICM keys (__map_item, __map_index, etc.) to pass iteration state.
+ */
+
+/** Well-known ICM/WM keys used by the routine execution framework. */
+declare const ROUTINE_KEYS: {
+    /** Plan overview with task statuses (ICM) */
+    readonly PLAN: "__routine_plan";
+    /** Dependency results location guide (ICM) */
+    readonly DEPS: "__routine_deps";
+    /** Prefix for per-dependency result keys (ICM/WM) */
+    readonly DEP_RESULT_PREFIX: "__dep_result_";
+    /** Current map/fold item (ICM) */
+    readonly MAP_ITEM: "__map_item";
+    /** Current map/fold index, 0-based (ICM) */
+    readonly MAP_INDEX: "__map_index";
+    /** Total items in map/fold (ICM) */
+    readonly MAP_TOTAL: "__map_total";
+    /** Running fold accumulator (ICM) */
+    readonly FOLD_ACCUMULATOR: "__fold_accumulator";
+    /** Prefix for large dep results stored in WM findings tier */
+    readonly WM_DEP_FINDINGS_PREFIX: "findings/__dep_result_";
+    /** Prefix for auto-stored task outputs (set by output contracts) */
+    readonly TASK_OUTPUT_PREFIX: "__task_output_";
+};
+interface ControlFlowResult {
+    completed: boolean;
+    result?: unknown;
+    error?: string;
+}
+/**
+ * Resolve template placeholders in text.
+ *
+ * Supported namespaces:
+ * - {{param.name}} → inputs[name]
+ * - {{map.item}} / {{map.index}} / {{map.total}} → ICM keys
+ * - {{fold.accumulator}} → ICM key
+ *
+ * Non-string values are JSON.stringify'd. Unresolved templates are left as-is.
+ */
+declare function resolveTemplates(text: string, inputs: Record<string, unknown>, icmPlugin: InContextMemoryPluginNextGen | null): string;
+/**
+ * Resolve the source array for a map/fold control flow using layered resolution:
+ * 1. Determine lookup key(s) from source config
+ * 2. Read from ICM/WM with fallback chain
+ * 3. Apply JSON path extraction if specified
+ * 4. Coerce to array algorithmically (JSON parse, common field names)
+ * 5. LLM extraction fallback if still not an array
+ */
+declare function resolveFlowSource(flow: {
+    source: ControlFlowSource;
+    maxIterations?: number;
+}, flowType: string, agent: Agent, execution: RoutineExecution | undefined, icmPlugin: InContextMemoryPluginNextGen | null, wmPlugin: WorkingMemoryPluginNextGen | null): Promise<{
+    array: unknown[];
+    maxIter: number;
+} | ControlFlowResult>;
+
 /**
  * FilePersistentInstructionsStorage - File-based storage for persistent instructions
  *
@@ -11113,6 +10673,8 @@ interface GenericAPIToolOptions {
     description?: string;
     /** User ID for multi-user OAuth */
     userId?: string;
+    /** Account alias for multi-account OAuth (baked into tool name and context) */
+    accountId?: string;
     /** Permission config for the tool */
     permission?: ToolPermissionConfig$1;
 }
@@ -11141,6 +10703,8 @@ interface GenericAPICallResult {
 interface ConnectorToolsOptions {
     /** Optional scoped registry for access-controlled connector lookup */
     registry?: IConnectorRegistry;
+    /** Account alias for multi-account OAuth. When set, tools are prefixed with accountId and context is bound. */
+    accountId?: string;
 }
 /**
  * ConnectorTools - Main API for vendor-dependent tools
@@ -11284,6 +10848,34 @@ declare class ConnectorTools {
      */
     private static maintainCacheSize;
     private static resolveConnector;
+    /**
+     * Generate tools for a set of auth identities.
+     * Each identity gets its own tool set with unique name prefixes.
+     *
+     * @param identities - Array of auth identities
+     * @param userId - Optional user ID for multi-user OAuth
+     * @param options - Optional registry for scoped connector lookup
+     * @returns Map of identity key to tool array
+     *
+     * @example
+     * ```typescript
+     * const toolsByIdentity = ConnectorTools.forIdentities([
+     *   { connector: 'microsoft', accountId: 'work' },
+     *   { connector: 'microsoft', accountId: 'personal' },
+     *   { connector: 'github' },
+     * ]);
+     * // Keys: 'microsoft:work', 'microsoft:personal', 'github'
+     * ```
+     */
+    static forIdentities(identities: AuthIdentity[], userId?: string, options?: {
+        registry?: IConnectorRegistry;
+    }): Map<string, ToolFunction[]>;
+    /**
+     * Wrap a tool to inject accountId into ToolContext at execute time.
+     * This allows identity-bound tools to use the correct account without
+     * modifying every service tool factory.
+     */
+    private static bindAccountId;
     private static createGenericAPITool;
 }
 
@@ -11333,43 +10925,56 @@ declare class OAuthManager {
      * Automatically refreshes if expired
      *
      * @param userId - User identifier for multi-user support (optional)
+     * @param accountId - Account alias for multi-account support (optional)
      */
-    getToken(userId?: string): Promise<string>;
+    getToken(userId?: string, accountId?: string): Promise<string>;
     /**
      * Force refresh the token
      *
      * @param userId - User identifier for multi-user support (optional)
+     * @param accountId - Account alias for multi-account support (optional)
      */
-    refreshToken(userId?: string): Promise<string>;
+    refreshToken(userId?: string, accountId?: string): Promise<string>;
     /**
      * Check if current token is valid
      *
      * @param userId - User identifier for multi-user support (optional)
+     * @param accountId - Account alias for multi-account support (optional)
      */
-    isTokenValid(userId?: string): Promise<boolean>;
+    isTokenValid(userId?: string, accountId?: string): Promise<boolean>;
     /**
      * Start authorization flow (Authorization Code only)
      * Returns URL for user to visit
      *
      * @param userId - User identifier for multi-user support (optional)
+     * @param accountId - Account alias for multi-account support (optional)
      * @returns Authorization URL for the user to visit
      */
-    startAuthFlow(userId?: string): Promise<string>;
+    startAuthFlow(userId?: string, accountId?: string): Promise<string>;
     /**
      * Handle OAuth callback (Authorization Code only)
      * Call this with the callback URL after user authorizes
      *
      * @param callbackUrl - Full callback URL with code and state parameters
      * @param userId - Optional user identifier (can be extracted from state if embedded)
+     * @param accountId - Optional account alias (can be extracted from state if embedded)
      */
-    handleCallback(callbackUrl: string, userId?: string): Promise<void>;
+    handleCallback(callbackUrl: string, userId?: string, accountId?: string): Promise<void>;
     /**
      * Revoke token (if supported by provider)
      *
      * @param revocationUrl - Optional revocation endpoint URL
      * @param userId - User identifier for multi-user support (optional)
+     * @param accountId - Account alias for multi-account support (optional)
+     */
+    revokeToken(revocationUrl?: string, userId?: string, accountId?: string): Promise<void>;
+    /**
+     * List account aliases for a user (Authorization Code only)
+     *
+     * @param userId - User identifier (optional)
+     * @returns Array of account aliases (e.g., ['work', 'personal'])
      */
-    revokeToken(revocationUrl?: string, userId?: string): Promise<void>;
+    listAccounts(userId?: string): Promise<string[]>;
     private validateConfig;
 }
 
@@ -11392,6 +10997,10 @@ declare class MemoryStorage implements ITokenStorage {
      * Get number of stored tokens
      */
     size(): number;
+    /**
+     * List all storage keys (for account enumeration)
+     */
+    listKeys(): Promise<string[]>;
 }
 
 /**
@@ -11416,6 +11025,11 @@ declare class FileStorage implements ITokenStorage {
     getToken(key: string): Promise<StoredToken$1 | null>;
     deleteToken(key: string): Promise<void>;
     hasToken(key: string): Promise<boolean>;
+    /**
+     * List all storage keys by decrypting each token file and reading _storageKey.
+     * Falls back to returning hashed filenames for tokens stored before multi-account support.
+     */
+    listKeys(): Promise<string[]>;
     /**
      * List all token keys (for debugging)
      */
@@ -11438,7 +11052,7 @@ declare class FileStorage implements ITokenStorage {
 /**
  * Fetch with automatic authentication using connector's configured auth scheme
  *
- * Same API as standard fetch(), but with additional authProvider and optional userId parameters.
+ * Same API as standard fetch(), but with additional authProvider and optional userId/accountId parameters.
  * Authentication is handled automatically based on the connector's configuration:
  * - Bearer tokens (GitHub, Slack, Stripe)
  * - Bot tokens (Discord)
@@ -11449,6 +11063,7 @@ declare class FileStorage implements ITokenStorage {
  * @param options - Standard fetch options (DO NOT set Authorization header - it's added automatically)
  * @param authProvider - Name of registered connector (e.g., 'github', 'slack')
  * @param userId - Optional user identifier for multi-user support (omit for single-user mode)
+ * @param accountId - Optional account alias for multi-account OAuth (e.g., 'work', 'personal')
  * @returns Promise<Response> - Same as standard fetch
  *
  * @example Single-user mode:
@@ -11461,37 +11076,28 @@ declare class FileStorage implements ITokenStorage {
  * const data = await response.json();
  * ```
  *
- * @example With relative URL (uses connector's baseURL):
+ * @example Multi-account mode:
  * ```typescript
  * const response = await authenticatedFetch(
- *   '/user/repos',  // Resolves to https://api.github.com/user/repos
- *   { method: 'GET' },
- *   'github'
- * );
- * const repos = await response.json();
- * ```
- *
- * @example Multi-user mode:
- * ```typescript
- * const response = await authenticatedFetch(
- *   '/user/repos',
+ *   'https://graph.microsoft.com/v1.0/me',
  *   { method: 'GET' },
- *   'github',
- *   'user123'  // Get token for specific user
+ *   'microsoft',
+ *   'alice',
+ *   'work'  // Use Alice's work Microsoft account
  * );
- * const repos = await response.json();
  * ```
  */
-declare function authenticatedFetch(url: string | URL, options: RequestInit | undefined, authProvider: string, userId?: string): Promise<Response>;
+declare function authenticatedFetch(url: string | URL, options: RequestInit | undefined, authProvider: string, userId?: string, accountId?: string): Promise<Response>;
 /**
- * Create an authenticated fetch function bound to a specific connector and optionally a user
+ * Create an authenticated fetch function bound to a specific connector and optionally a user/account
  *
  * Useful for creating reusable fetch functions for a specific API and/or user.
  * Uses connector's configured auth scheme (Bearer, Bot, Basic, custom headers).
  *
  * @param authProvider - Name of registered connector
  * @param userId - Optional user identifier to bind to (omit for single-user mode)
- * @returns Fetch function bound to that connector (and user)
+ * @param accountId - Optional account alias for multi-account OAuth (e.g., 'work', 'personal')
+ * @returns Fetch function bound to that connector (and user/account)
  *
  * @example Single-user mode:
  * ```typescript
@@ -11502,27 +11108,17 @@ declare function authenticatedFetch(url: string | URL, options: RequestInit | un
  * const emails = await msftFetch('https://graph.microsoft.com/v1.0/me/messages');
  * ```
  *
- * @example With relative URLs:
+ * @example Multi-account mode:
  * ```typescript
- * const githubFetch = createAuthenticatedFetch('github');
+ * // Create fetch for Alice's work Microsoft account
+ * const workFetch = createAuthenticatedFetch('microsoft', 'alice', 'work');
+ * const personalFetch = createAuthenticatedFetch('microsoft', 'alice', 'personal');
  *
- * // Relative URLs resolved against connector's baseURL
- * const repos = await githubFetch('/user/repos');
- * const issues = await githubFetch('/user/issues');
- * ```
- *
- * @example Multi-user mode:
- * ```typescript
- * // Create fetch functions for different users
- * const aliceFetch = createAuthenticatedFetch('github', 'user123');
- * const bobFetch = createAuthenticatedFetch('github', 'user456');
- *
- * // Each uses their own token
- * const aliceRepos = await aliceFetch('/user/repos');
- * const bobRepos = await bobFetch('/user/repos');
+ * const workEmails = await workFetch('/me/messages');
+ * const personalEmails = await personalFetch('/me/messages');
  * ```
  */
-declare function createAuthenticatedFetch(authProvider: string, userId?: string): (url: string | URL, options?: RequestInit) => Promise<Response>;
+declare function createAuthenticatedFetch(authProvider: string, userId?: string, accountId?: string): (url: string | URL, options?: RequestInit) => Promise<Response>;
 
 /**
  * Tool Generator - Auto-generate tools for registered connectors
@@ -12985,7 +12581,7 @@ declare const writeFile: ToolFunction<WriteFileArgs, WriteFileResult>;
 /**
  * Arguments for the read file tool
  */
-interface ReadFileArgs {
+interface ReadFileArgs$1 {
     /** Absolute path to the file to read */
     file_path: string;
     /** Line number to start reading from (1-indexed). Only provide if the file is too large. */
@@ -12996,11 +12592,11 @@ interface ReadFileArgs {
 /**
  * Create a Read File tool with the given configuration
  */
-declare function createReadFileTool(config?: FilesystemToolConfig): ToolFunction<ReadFileArgs, ReadFileResult>;
+declare function createReadFileTool(config?: FilesystemToolConfig): ToolFunction<ReadFileArgs$1, ReadFileResult>;
 /**
  * Default Read File tool instance
  */
-declare const readFile: ToolFunction<ReadFileArgs, ReadFileResult>;
+declare const readFile: ToolFunction<ReadFileArgs$1, ReadFileResult>;
 
 /**
  * JSON Manipulation Tool
@@ -13506,7 +13102,7 @@ interface GitHubCreatePRResult {
 /**
  * Arguments for the search_files tool
  */
-interface SearchFilesArgs {
+interface SearchFilesArgs$1 {
     /** Repository in "owner/repo" format or full GitHub URL */
     repository?: string;
     /** Glob pattern to match files (e.g., "**\/*.ts", "src/**\/*.tsx") */
@@ -13517,7 +13113,7 @@ interface SearchFilesArgs {
 /**
  * Create a GitHub search_files tool
  */
-declare function createSearchFilesTool(connector: Connector, userId?: string): ToolFunction<SearchFilesArgs, GitHubSearchFilesResult>;
+declare function createSearchFilesTool(connector: Connector, userId?: string): ToolFunction<SearchFilesArgs$1, GitHubSearchFilesResult>;
 
 /**
  * GitHub Search Code Tool
@@ -13693,6 +13289,7 @@ interface MicrosoftFetchOptions {
     method?: string;
     body?: unknown;
     userId?: string;
+    accountId?: string;
     queryParams?: Record<string, string | number | boolean>;
     accept?: string;
 }
@@ -13756,7 +13353,7 @@ declare function isTeamsMeetingUrl(input: string): boolean;
  * @returns The resolved meeting ID and optional subject
  * @throws Error if the URL cannot be resolved or input is empty
  */
-declare function resolveMeetingId(connector: Connector, input: string, prefix: string, effectiveUserId?: string): Promise<{
+declare function resolveMeetingId(connector: Connector, input: string, prefix: string, effectiveUserId?: string, effectiveAccountId?: string): Promise<{
     meetingId: string;
     subject?: string;
 }>;
@@ -13804,6 +13401,129 @@ interface MeetingSlotSuggestion {
         availability: string;
     }[];
 }
+/** @internal Graph driveItem metadata */
+interface GraphDriveItem {
+    id: string;
+    name: string;
+    size: number;
+    webUrl?: string;
+    lastModifiedDateTime?: string;
+    createdDateTime?: string;
+    file?: {
+        mimeType?: string;
+        hashes?: Record<string, string>;
+    };
+    folder?: {
+        childCount?: number;
+    };
+    parentReference?: {
+        driveId?: string;
+        driveType?: string;
+        id?: string;
+        name?: string;
+        path?: string;
+        siteId?: string;
+    };
+    '@microsoft.graph.downloadUrl'?: string;
+}
+interface MicrosoftReadFileResult {
+    success: boolean;
+    filename?: string;
+    sizeBytes?: number;
+    mimeType?: string;
+    markdown?: string;
+    webUrl?: string;
+    error?: string;
+}
+interface MicrosoftListFilesResult {
+    success: boolean;
+    items?: {
+        name: string;
+        type: 'file' | 'folder';
+        size: number;
+        sizeFormatted: string;
+        mimeType?: string;
+        lastModified?: string;
+        webUrl?: string;
+        id: string;
+        childCount?: number;
+    }[];
+    totalCount?: number;
+    hasMore?: boolean;
+    error?: string;
+}
+interface MicrosoftSearchFilesResult {
+    success: boolean;
+    results?: {
+        name: string;
+        path?: string;
+        site?: string;
+        snippet?: string;
+        size: number;
+        sizeFormatted: string;
+        webUrl?: string;
+        id: string;
+        lastModified?: string;
+    }[];
+    totalCount?: number;
+    hasMore?: boolean;
+    error?: string;
+}
+/**
+ * Encode a sharing URL into the Graph API sharing token format.
+ *
+ * Microsoft Graph's `/shares/{token}` endpoint accepts base64url-encoded URLs
+ * prefixed with `u!`. This is the documented way to access files via sharing links
+ * or direct web URLs without knowing the driveId/itemId.
+ *
+ * @see https://learn.microsoft.com/en-us/graph/api/shares-get
+ */
+declare function encodeSharingUrl(webUrl: string): string;
+/**
+ * Check if a string looks like a web URL (http/https).
+ */
+declare function isWebUrl(source: string): boolean;
+/**
+ * Check if a string looks like a OneDrive/SharePoint web URL.
+ *
+ * Matches:
+ * - `*.sharepoint.com/*`
+ * - `onedrive.live.com/*`
+ * - `1drv.ms/*`
+ * - `*.sharepoint-df.com/*` (dogfood/test)
+ */
+declare function isMicrosoftFileUrl(source: string): boolean;
+/**
+ * Determine the drive prefix for Graph API calls.
+ *
+ * Priority:
+ * 1. siteId → `/sites/{siteId}/drive`
+ * 2. driveId → `/drives/{driveId}`
+ * 3. fallback → `{userPrefix}/drive` (e.g., `/me/drive`)
+ */
+declare function getDrivePrefix(userPrefix: string, options?: {
+    siteId?: string;
+    driveId?: string;
+}): string;
+/**
+ * Build the Graph API endpoint and metadata endpoint for a file source.
+ *
+ * Handles three input types:
+ * 1. Web URL (SharePoint/OneDrive link) → uses `/shares/{token}/driveItem`
+ * 2. Path (starts with `/`) → uses `/drive/root:{path}:`
+ * 3. Item ID → uses `/drive/items/{id}`
+ *
+ * @returns Object with `metadataEndpoint` (for item info) and `contentEndpoint` (for download)
+ */
+declare function resolveFileEndpoints(source: string, drivePrefix: string): {
+    metadataEndpoint: string;
+    contentEndpoint: string;
+    isSharedUrl: boolean;
+};
+/**
+ * Format a file size in bytes to a human-readable string.
+ */
+declare function formatFileSize(bytes: number): string;
 
 /**
  * Microsoft Graph - Create Draft Email Tool
@@ -13924,6 +13644,61 @@ interface FindMeetingSlotsArgs {
  */
 declare function createFindMeetingSlotsTool(connector: Connector, userId?: string): ToolFunction<FindMeetingSlotsArgs, MicrosoftFindSlotsResult>;
 
+/**
+ * Microsoft Graph - Read File Tool
+ *
+ * Downloads a file from OneDrive or SharePoint and converts it to markdown
+ * using DocumentReader. Never returns raw binary content.
+ */
+
+interface ReadFileArgs {
+    source: string;
+    driveId?: string;
+    siteId?: string;
+    targetUser?: string;
+}
+interface MicrosoftReadFileConfig {
+    /** Default max file size in bytes (default: 50 MB). Applied when no per-extension limit matches. */
+    maxFileSizeBytes?: number;
+    /** Per-extension size limits in bytes, e.g. `{ '.pptx': 200 * 1024 * 1024 }`. Merged with built-in defaults. */
+    fileSizeLimits?: Record<string, number>;
+}
+declare function createMicrosoftReadFileTool(connector: Connector, userId?: string, config?: MicrosoftReadFileConfig): ToolFunction<ReadFileArgs, MicrosoftReadFileResult>;
+
+/**
+ * Microsoft Graph - List Files Tool
+ *
+ * Lists files and folders in a OneDrive or SharePoint directory.
+ * Returns metadata only — never file contents.
+ */
+
+interface ListFilesArgs {
+    path?: string;
+    driveId?: string;
+    siteId?: string;
+    search?: string;
+    limit?: number;
+    targetUser?: string;
+}
+declare function createMicrosoftListFilesTool(connector: Connector, userId?: string): ToolFunction<ListFilesArgs, MicrosoftListFilesResult>;
+
+/**
+ * Microsoft Graph - Search Files Tool
+ *
+ * Searches across OneDrive and SharePoint for files matching a query.
+ * Uses the Microsoft Search API with KQL support.
+ * Returns metadata and snippets only — never file contents.
+ */
+
+interface SearchFilesArgs {
+    query: string;
+    siteId?: string;
+    fileTypes?: string[];
+    limit?: number;
+    targetUser?: string;
+}
+declare function createMicrosoftSearchFilesTool(connector: Connector, userId?: string): ToolFunction<SearchFilesArgs, MicrosoftSearchFilesResult>;
+
 /**
  * Desktop Automation Tools - Types
  *
@@ -14302,13 +14077,13 @@ declare const desktopTools: (ToolFunction<DesktopScreenshotArgs, DesktopScreensh
  * AUTO-GENERATED FILE - DO NOT EDIT MANUALLY
  *
  * Generated by: scripts/generate-tool-registry.ts
- * Generated at: 2026-02-22T21:55:57.315Z
+ * Generated at: 2026-02-26T21:46:20.180Z
  *
  * To regenerate: npm run generate:tools
  */
 
 /** Tool category for grouping */
-type ToolCategory = 'filesystem' | 'shell' | 'web' | 'code' | 'json' | 'connector' | 'desktop' | 'custom-tools' | 'other';
+type ToolCategory = 'filesystem' | 'shell' | 'web' | 'code' | 'json' | 'connector' | 'desktop' | 'custom-tools' | 'routines' | 'other';
 /** Metadata for a tool in the registry */
 interface ToolRegistryEntry {
     /** Tool name (matches definition.function.name) */
@@ -14345,6 +14120,24 @@ declare function getToolsRequiringConnector(): ToolRegistryEntry[];
 /** Get all unique category names */
 declare function getToolCategories(): ToolCategory[];
 
+/**
+ * generate_routine - Generates and persists a complete RoutineDefinition from LLM output.
+ */
+
+interface GenerateRoutineArgs {
+    definition: RoutineDefinitionInput;
+}
+interface GenerateRoutineResult {
+    success: boolean;
+    id?: string;
+    name?: string;
+    storagePath?: string;
+    error?: string;
+}
+declare function createGenerateRoutine(storage?: IRoutineDefinitionStorage): ToolFunction<GenerateRoutineArgs, GenerateRoutineResult>;
+/** Default generate_routine instance (resolves storage from StorageRegistry at execution time) */
+declare const generateRoutine: ToolFunction<GenerateRoutineArgs, GenerateRoutineResult>;
+
 /**
  * custom_tool_draft - Validates a draft custom tool structure
  *
@@ -14667,7 +14460,7 @@ declare class ToolRegistry {
  * });
  * ```
  */
-declare const developerTools: (ToolFunction<ReadFileArgs, ReadFileResult> | ToolFunction<WriteFileArgs, WriteFileResult> | ToolFunction<EditFileArgs, EditFileResult> | ToolFunction<GlobArgs, GlobResult> | ToolFunction<GrepArgs, GrepResult> | ToolFunction<ListDirectoryArgs, ListDirectoryResult> | ToolFunction<BashArgs, BashResult>)[];
+declare const developerTools: (ToolFunction<ReadFileArgs$1, ReadFileResult> | ToolFunction<WriteFileArgs, WriteFileResult> | ToolFunction<EditFileArgs, EditFileResult> | ToolFunction<GlobArgs, GlobResult> | ToolFunction<GrepArgs, GrepResult> | ToolFunction<ListDirectoryArgs, ListDirectoryResult> | ToolFunction<BashArgs, BashResult>)[];
 
 type index_BashResult = BashResult;
 type index_ConnectorToolEntry = ConnectorToolEntry;
@@ -14734,6 +14527,7 @@ type index_GitHubRepository = GitHubRepository;
 type index_GitHubSearchCodeResult = GitHubSearchCodeResult;
 type index_GitHubSearchFilesResult = GitHubSearchFilesResult;
 type index_GlobResult = GlobResult;
+type index_GraphDriveItem = GraphDriveItem;
 type index_GrepMatch = GrepMatch;
 type index_GrepResult = GrepResult;
 type index_HydrateOptions = HydrateOptions;
@@ -14747,6 +14541,9 @@ type index_MicrosoftDraftEmailResult = MicrosoftDraftEmailResult;
 type index_MicrosoftEditMeetingResult = MicrosoftEditMeetingResult;
 type index_MicrosoftFindSlotsResult = MicrosoftFindSlotsResult;
 type index_MicrosoftGetTranscriptResult = MicrosoftGetTranscriptResult;
+type index_MicrosoftListFilesResult = MicrosoftListFilesResult;
+type index_MicrosoftReadFileResult = MicrosoftReadFileResult;
+type index_MicrosoftSearchFilesResult = MicrosoftSearchFilesResult;
 type index_MicrosoftSendEmailResult = MicrosoftSendEmailResult;
 type index_MouseButton = MouseButton;
 type index_NutTreeDriver = NutTreeDriver;
@@ -14787,6 +14584,7 @@ declare const index_createEditFileTool: typeof createEditFileTool;
 declare const index_createEditMeetingTool: typeof createEditMeetingTool;
 declare const index_createExecuteJavaScriptTool: typeof createExecuteJavaScriptTool;
 declare const index_createFindMeetingSlotsTool: typeof createFindMeetingSlotsTool;
+declare const index_createGenerateRoutine: typeof createGenerateRoutine;
 declare const index_createGetMeetingTranscriptTool: typeof createGetMeetingTranscriptTool;
 declare const index_createGetPRTool: typeof createGetPRTool;
 declare const index_createGitHubReadFileTool: typeof createGitHubReadFileTool;
@@ -14795,6 +14593,9 @@ declare const index_createGrepTool: typeof createGrepTool;
 declare const index_createImageGenerationTool: typeof createImageGenerationTool;
 declare const index_createListDirectoryTool: typeof createListDirectoryTool;
 declare const index_createMeetingTool: typeof createMeetingTool;
+declare const index_createMicrosoftListFilesTool: typeof createMicrosoftListFilesTool;
+declare const index_createMicrosoftReadFileTool: typeof createMicrosoftReadFileTool;
+declare const index_createMicrosoftSearchFilesTool: typeof createMicrosoftSearchFilesTool;
 declare const index_createPRCommentsTool: typeof createPRCommentsTool;
 declare const index_createPRFilesTool: typeof createPRFilesTool;
 declare const index_createReadFileTool: typeof createReadFileTool;
@@ -14827,14 +14628,18 @@ declare const index_desktopWindowFocus: typeof desktopWindowFocus;
 declare const index_desktopWindowList: typeof desktopWindowList;
 declare const index_developerTools: typeof developerTools;
 declare const index_editFile: typeof editFile;
+declare const index_encodeSharingUrl: typeof encodeSharingUrl;
 declare const index_executeInVM: typeof executeInVM;
 declare const index_executeJavaScript: typeof executeJavaScript;
 declare const index_expandTilde: typeof expandTilde;
 declare const index_formatAttendees: typeof formatAttendees;
+declare const index_formatFileSize: typeof formatFileSize;
 declare const index_formatRecipients: typeof formatRecipients;
+declare const index_generateRoutine: typeof generateRoutine;
 declare const index_getAllBuiltInTools: typeof getAllBuiltInTools;
 declare const index_getBackgroundOutput: typeof getBackgroundOutput;
 declare const index_getDesktopDriver: typeof getDesktopDriver;
+declare const index_getDrivePrefix: typeof getDrivePrefix;
 declare const index_getMediaOutputHandler: typeof getMediaOutputHandler;
 declare const index_getMediaStorage: typeof getMediaStorage;
 declare const index_getToolByName: typeof getToolByName;
@@ -14848,7 +14653,9 @@ declare const index_grep: typeof grep;
 declare const index_hydrateCustomTool: typeof hydrateCustomTool;
 declare const index_isBlockedCommand: typeof isBlockedCommand;
 declare const index_isExcludedExtension: typeof isExcludedExtension;
+declare const index_isMicrosoftFileUrl: typeof isMicrosoftFileUrl;
 declare const index_isTeamsMeetingUrl: typeof isTeamsMeetingUrl;
+declare const index_isWebUrl: typeof isWebUrl;
 declare const index_jsonManipulator: typeof jsonManipulator;
 declare const index_killBackgroundProcess: typeof killBackgroundProcess;
 declare const index_listDirectory: typeof listDirectory;
@@ -14859,6 +14666,7 @@ declare const index_parseKeyCombo: typeof parseKeyCombo;
 declare const index_parseRepository: typeof parseRepository;
 declare const index_readFile: typeof readFile;
 declare const index_resetDefaultDriver: typeof resetDefaultDriver;
+declare const index_resolveFileEndpoints: typeof resolveFileEndpoints;
 declare const index_resolveMeetingId: typeof resolveMeetingId;
 declare const index_resolveRepository: typeof resolveRepository;
 declare const index_setMediaOutputHandler: typeof setMediaOutputHandler;
@@ -14868,7 +14676,7 @@ declare const index_validatePath: typeof validatePath;
 declare const index_webFetch: typeof webFetch;
 declare const index_writeFile: typeof writeFile;
 declare namespace index {
-  export { type index_BashResult as BashResult, type index_ConnectorToolEntry as ConnectorToolEntry, index_ConnectorTools as ConnectorTools, type index_CustomToolMetaToolsOptions as CustomToolMetaToolsOptions, index_DEFAULT_DESKTOP_CONFIG as DEFAULT_DESKTOP_CONFIG, index_DEFAULT_FILESYSTEM_CONFIG as DEFAULT_FILESYSTEM_CONFIG, index_DEFAULT_SHELL_CONFIG as DEFAULT_SHELL_CONFIG, index_DESKTOP_TOOL_NAMES as DESKTOP_TOOL_NAMES, type index_DesktopGetCursorResult as DesktopGetCursorResult, type index_DesktopGetScreenSizeResult as DesktopGetScreenSizeResult, type index_DesktopKeyboardKeyArgs as DesktopKeyboardKeyArgs, type index_DesktopKeyboardKeyResult as DesktopKeyboardKeyResult, type index_DesktopKeyboardTypeArgs as DesktopKeyboardTypeArgs, type index_DesktopKeyboardTypeResult as DesktopKeyboardTypeResult, type index_DesktopMouseClickArgs as DesktopMouseClickArgs, type index_DesktopMouseClickResult as DesktopMouseClickResult, type index_DesktopMouseDragArgs as DesktopMouseDragArgs, type index_DesktopMouseDragResult as DesktopMouseDragResult, type index_DesktopMouseMoveArgs as DesktopMouseMoveArgs, type index_DesktopMouseMoveResult as DesktopMouseMoveResult, type index_DesktopMouseScrollArgs as DesktopMouseScrollArgs, type index_DesktopMouseScrollResult as DesktopMouseScrollResult, type index_DesktopPoint as DesktopPoint, type index_DesktopScreenSize as DesktopScreenSize, type index_DesktopScreenshot as DesktopScreenshot, type index_DesktopScreenshotArgs as DesktopScreenshotArgs, type index_DesktopScreenshotResult as DesktopScreenshotResult, type index_DesktopToolConfig as DesktopToolConfig, type index_DesktopToolName as DesktopToolName, type index_DesktopWindow as DesktopWindow, type index_DesktopWindowFocusArgs as DesktopWindowFocusArgs, type index_DesktopWindowFocusResult as DesktopWindowFocusResult, type index_DesktopWindowListResult as DesktopWindowListResult, type index_DocumentFamily as DocumentFamily, type index_DocumentFormat as DocumentFormat, type index_DocumentImagePiece as DocumentImagePiece, type index_DocumentMetadata as DocumentMetadata, type index_DocumentPiece as DocumentPiece, type index_DocumentReadOptions as DocumentReadOptions, index_DocumentReader as DocumentReader, type index_DocumentReaderConfig as DocumentReaderConfig, type index_DocumentResult as DocumentResult, type index_DocumentSource as DocumentSource, type index_DocumentTextPiece as DocumentTextPiece, type index_DocumentToContentOptions as DocumentToContentOptions, type index_EditFileResult as EditFileResult, FileMediaStorage as FileMediaOutputHandler, type index_FilesystemToolConfig as FilesystemToolConfig, type index_FormatDetectionResult as FormatDetectionResult, index_FormatDetector as FormatDetector, 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 index_HydrateOptions as HydrateOptions, type index_IDesktopDriver as IDesktopDriver, type index_IDocumentTransformer as IDocumentTransformer, type index_IFormatHandler as IFormatHandler, type IMediaStorage as IMediaOutputHandler, type index_ImageFilterOptions as ImageFilterOptions, type MediaStorageMetadata as MediaOutputMetadata, type MediaStorageResult as MediaOutputResult, type index_MeetingSlotSuggestion as MeetingSlotSuggestion, type index_MicrosoftCreateMeetingResult as MicrosoftCreateMeetingResult, type index_MicrosoftDraftEmailResult as MicrosoftDraftEmailResult, type index_MicrosoftEditMeetingResult as MicrosoftEditMeetingResult, type index_MicrosoftFindSlotsResult as MicrosoftFindSlotsResult, type index_MicrosoftGetTranscriptResult as MicrosoftGetTranscriptResult, type index_MicrosoftSendEmailResult as MicrosoftSendEmailResult, type index_MouseButton as MouseButton, index_NutTreeDriver as NutTreeDriver, 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_applyHumanDelay as applyHumanDelay, index_bash as bash, index_createBashTool as createBashTool, index_createCreatePRTool as createCreatePRTool, index_createCustomToolDelete as createCustomToolDelete, index_createCustomToolDraft as createCustomToolDraft, index_createCustomToolList as createCustomToolList, index_createCustomToolLoad as createCustomToolLoad, index_createCustomToolMetaTools as createCustomToolMetaTools, index_createCustomToolSave as createCustomToolSave, index_createCustomToolTest as createCustomToolTest, index_createDesktopGetCursorTool as createDesktopGetCursorTool, index_createDesktopGetScreenSizeTool as createDesktopGetScreenSizeTool, index_createDesktopKeyboardKeyTool as createDesktopKeyboardKeyTool, index_createDesktopKeyboardTypeTool as createDesktopKeyboardTypeTool, index_createDesktopMouseClickTool as createDesktopMouseClickTool, index_createDesktopMouseDragTool as createDesktopMouseDragTool, index_createDesktopMouseMoveTool as createDesktopMouseMoveTool, index_createDesktopMouseScrollTool as createDesktopMouseScrollTool, index_createDesktopScreenshotTool as createDesktopScreenshotTool, index_createDesktopWindowFocusTool as createDesktopWindowFocusTool, index_createDesktopWindowListTool as createDesktopWindowListTool, index_createDraftEmailTool as createDraftEmailTool, index_createEditFileTool as createEditFileTool, index_createEditMeetingTool as createEditMeetingTool, index_createExecuteJavaScriptTool as createExecuteJavaScriptTool, index_createFindMeetingSlotsTool as createFindMeetingSlotsTool, index_createGetMeetingTranscriptTool as createGetMeetingTranscriptTool, 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_createMeetingTool as createMeetingTool, index_createPRCommentsTool as createPRCommentsTool, index_createPRFilesTool as createPRFilesTool, index_createReadFileTool as createReadFileTool, index_createSearchCodeTool as createSearchCodeTool, index_createSearchFilesTool as createSearchFilesTool, index_createSendEmailTool as createSendEmailTool, 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_customToolDelete as customToolDelete, index_customToolDraft as customToolDraft, index_customToolList as customToolList, index_customToolLoad as customToolLoad, index_customToolSave as customToolSave, index_customToolTest as customToolTest, index_desktopGetCursor as desktopGetCursor, index_desktopGetScreenSize as desktopGetScreenSize, index_desktopKeyboardKey as desktopKeyboardKey, index_desktopKeyboardType as desktopKeyboardType, index_desktopMouseClick as desktopMouseClick, index_desktopMouseDrag as desktopMouseDrag, index_desktopMouseMove as desktopMouseMove, index_desktopMouseScroll as desktopMouseScroll, index_desktopScreenshot as desktopScreenshot, index_desktopTools as desktopTools, index_desktopWindowFocus as desktopWindowFocus, index_desktopWindowList as desktopWindowList, index_developerTools as developerTools, index_editFile as editFile, index_executeInVM as executeInVM, index_executeJavaScript as executeJavaScript, index_expandTilde as expandTilde, index_formatAttendees as formatAttendees, index_formatRecipients as formatRecipients, index_getAllBuiltInTools as getAllBuiltInTools, index_getBackgroundOutput as getBackgroundOutput, index_getDesktopDriver as getDesktopDriver, 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_getUserPathPrefix as getUserPathPrefix, index_glob as glob, index_grep as grep, index_hydrateCustomTool as hydrateCustomTool, index_isBlockedCommand as isBlockedCommand, index_isExcludedExtension as isExcludedExtension, index_isTeamsMeetingUrl as isTeamsMeetingUrl, index_jsonManipulator as jsonManipulator, index_killBackgroundProcess as killBackgroundProcess, index_listDirectory as listDirectory, index_mergeTextPieces as mergeTextPieces, index_microsoftFetch as microsoftFetch, index_normalizeEmails as normalizeEmails, index_parseKeyCombo as parseKeyCombo, index_parseRepository as parseRepository, index_readFile as readFile, index_resetDefaultDriver as resetDefaultDriver, index_resolveMeetingId as resolveMeetingId, 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 };
+  export { type index_BashResult as BashResult, type index_ConnectorToolEntry as ConnectorToolEntry, index_ConnectorTools as ConnectorTools, type index_CustomToolMetaToolsOptions as CustomToolMetaToolsOptions, index_DEFAULT_DESKTOP_CONFIG as DEFAULT_DESKTOP_CONFIG, index_DEFAULT_FILESYSTEM_CONFIG as DEFAULT_FILESYSTEM_CONFIG, index_DEFAULT_SHELL_CONFIG as DEFAULT_SHELL_CONFIG, index_DESKTOP_TOOL_NAMES as DESKTOP_TOOL_NAMES, type index_DesktopGetCursorResult as DesktopGetCursorResult, type index_DesktopGetScreenSizeResult as DesktopGetScreenSizeResult, type index_DesktopKeyboardKeyArgs as DesktopKeyboardKeyArgs, type index_DesktopKeyboardKeyResult as DesktopKeyboardKeyResult, type index_DesktopKeyboardTypeArgs as DesktopKeyboardTypeArgs, type index_DesktopKeyboardTypeResult as DesktopKeyboardTypeResult, type index_DesktopMouseClickArgs as DesktopMouseClickArgs, type index_DesktopMouseClickResult as DesktopMouseClickResult, type index_DesktopMouseDragArgs as DesktopMouseDragArgs, type index_DesktopMouseDragResult as DesktopMouseDragResult, type index_DesktopMouseMoveArgs as DesktopMouseMoveArgs, type index_DesktopMouseMoveResult as DesktopMouseMoveResult, type index_DesktopMouseScrollArgs as DesktopMouseScrollArgs, type index_DesktopMouseScrollResult as DesktopMouseScrollResult, type index_DesktopPoint as DesktopPoint, type index_DesktopScreenSize as DesktopScreenSize, type index_DesktopScreenshot as DesktopScreenshot, type index_DesktopScreenshotArgs as DesktopScreenshotArgs, type index_DesktopScreenshotResult as DesktopScreenshotResult, type index_DesktopToolConfig as DesktopToolConfig, type index_DesktopToolName as DesktopToolName, type index_DesktopWindow as DesktopWindow, type index_DesktopWindowFocusArgs as DesktopWindowFocusArgs, type index_DesktopWindowFocusResult as DesktopWindowFocusResult, type index_DesktopWindowListResult as DesktopWindowListResult, type index_DocumentFamily as DocumentFamily, type index_DocumentFormat as DocumentFormat, type index_DocumentImagePiece as DocumentImagePiece, type index_DocumentMetadata as DocumentMetadata, type index_DocumentPiece as DocumentPiece, type index_DocumentReadOptions as DocumentReadOptions, index_DocumentReader as DocumentReader, type index_DocumentReaderConfig as DocumentReaderConfig, type index_DocumentResult as DocumentResult, type index_DocumentSource as DocumentSource, type index_DocumentTextPiece as DocumentTextPiece, type index_DocumentToContentOptions as DocumentToContentOptions, type index_EditFileResult as EditFileResult, FileMediaStorage as FileMediaOutputHandler, type index_FilesystemToolConfig as FilesystemToolConfig, type index_FormatDetectionResult as FormatDetectionResult, index_FormatDetector as FormatDetector, 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_GraphDriveItem as GraphDriveItem, type index_GrepMatch as GrepMatch, type index_GrepResult as GrepResult, type index_HydrateOptions as HydrateOptions, type index_IDesktopDriver as IDesktopDriver, type index_IDocumentTransformer as IDocumentTransformer, type index_IFormatHandler as IFormatHandler, type IMediaStorage as IMediaOutputHandler, type index_ImageFilterOptions as ImageFilterOptions, type MediaStorageMetadata as MediaOutputMetadata, type MediaStorageResult as MediaOutputResult, type index_MeetingSlotSuggestion as MeetingSlotSuggestion, type index_MicrosoftCreateMeetingResult as MicrosoftCreateMeetingResult, type index_MicrosoftDraftEmailResult as MicrosoftDraftEmailResult, type index_MicrosoftEditMeetingResult as MicrosoftEditMeetingResult, type index_MicrosoftFindSlotsResult as MicrosoftFindSlotsResult, type index_MicrosoftGetTranscriptResult as MicrosoftGetTranscriptResult, type index_MicrosoftListFilesResult as MicrosoftListFilesResult, type index_MicrosoftReadFileResult as MicrosoftReadFileResult, type index_MicrosoftSearchFilesResult as MicrosoftSearchFilesResult, type index_MicrosoftSendEmailResult as MicrosoftSendEmailResult, type index_MouseButton as MouseButton, index_NutTreeDriver as NutTreeDriver, 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_applyHumanDelay as applyHumanDelay, index_bash as bash, index_createBashTool as createBashTool, index_createCreatePRTool as createCreatePRTool, index_createCustomToolDelete as createCustomToolDelete, index_createCustomToolDraft as createCustomToolDraft, index_createCustomToolList as createCustomToolList, index_createCustomToolLoad as createCustomToolLoad, index_createCustomToolMetaTools as createCustomToolMetaTools, index_createCustomToolSave as createCustomToolSave, index_createCustomToolTest as createCustomToolTest, index_createDesktopGetCursorTool as createDesktopGetCursorTool, index_createDesktopGetScreenSizeTool as createDesktopGetScreenSizeTool, index_createDesktopKeyboardKeyTool as createDesktopKeyboardKeyTool, index_createDesktopKeyboardTypeTool as createDesktopKeyboardTypeTool, index_createDesktopMouseClickTool as createDesktopMouseClickTool, index_createDesktopMouseDragTool as createDesktopMouseDragTool, index_createDesktopMouseMoveTool as createDesktopMouseMoveTool, index_createDesktopMouseScrollTool as createDesktopMouseScrollTool, index_createDesktopScreenshotTool as createDesktopScreenshotTool, index_createDesktopWindowFocusTool as createDesktopWindowFocusTool, index_createDesktopWindowListTool as createDesktopWindowListTool, index_createDraftEmailTool as createDraftEmailTool, index_createEditFileTool as createEditFileTool, index_createEditMeetingTool as createEditMeetingTool, index_createExecuteJavaScriptTool as createExecuteJavaScriptTool, index_createFindMeetingSlotsTool as createFindMeetingSlotsTool, index_createGenerateRoutine as createGenerateRoutine, index_createGetMeetingTranscriptTool as createGetMeetingTranscriptTool, 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_createMeetingTool as createMeetingTool, index_createMicrosoftListFilesTool as createMicrosoftListFilesTool, index_createMicrosoftReadFileTool as createMicrosoftReadFileTool, index_createMicrosoftSearchFilesTool as createMicrosoftSearchFilesTool, index_createPRCommentsTool as createPRCommentsTool, index_createPRFilesTool as createPRFilesTool, index_createReadFileTool as createReadFileTool, index_createSearchCodeTool as createSearchCodeTool, index_createSearchFilesTool as createSearchFilesTool, index_createSendEmailTool as createSendEmailTool, 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_customToolDelete as customToolDelete, index_customToolDraft as customToolDraft, index_customToolList as customToolList, index_customToolLoad as customToolLoad, index_customToolSave as customToolSave, index_customToolTest as customToolTest, index_desktopGetCursor as desktopGetCursor, index_desktopGetScreenSize as desktopGetScreenSize, index_desktopKeyboardKey as desktopKeyboardKey, index_desktopKeyboardType as desktopKeyboardType, index_desktopMouseClick as desktopMouseClick, index_desktopMouseDrag as desktopMouseDrag, index_desktopMouseMove as desktopMouseMove, index_desktopMouseScroll as desktopMouseScroll, index_desktopScreenshot as desktopScreenshot, index_desktopTools as desktopTools, index_desktopWindowFocus as desktopWindowFocus, index_desktopWindowList as desktopWindowList, index_developerTools as developerTools, index_editFile as editFile, index_encodeSharingUrl as encodeSharingUrl, index_executeInVM as executeInVM, index_executeJavaScript as executeJavaScript, index_expandTilde as expandTilde, index_formatAttendees as formatAttendees, index_formatFileSize as formatFileSize, index_formatRecipients as formatRecipients, index_generateRoutine as generateRoutine, index_getAllBuiltInTools as getAllBuiltInTools, index_getBackgroundOutput as getBackgroundOutput, index_getDesktopDriver as getDesktopDriver, index_getDrivePrefix as getDrivePrefix, 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_getUserPathPrefix as getUserPathPrefix, index_glob as glob, index_grep as grep, index_hydrateCustomTool as hydrateCustomTool, index_isBlockedCommand as isBlockedCommand, index_isExcludedExtension as isExcludedExtension, index_isMicrosoftFileUrl as isMicrosoftFileUrl, index_isTeamsMeetingUrl as isTeamsMeetingUrl, index_isWebUrl as isWebUrl, index_jsonManipulator as jsonManipulator, index_killBackgroundProcess as killBackgroundProcess, index_listDirectory as listDirectory, index_mergeTextPieces as mergeTextPieces, index_microsoftFetch as microsoftFetch, index_normalizeEmails as normalizeEmails, index_parseKeyCombo as parseKeyCombo, index_parseRepository as parseRepository, index_readFile as readFile, index_resetDefaultDriver as resetDefaultDriver, index_resolveFileEndpoints as resolveFileEndpoints, index_resolveMeetingId as resolveMeetingId, 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 };
 }
 
 /**
@@ -14923,4 +14731,76 @@ declare class ProviderConfigAgent {
     reset(): void;
 }
 
-export { AGENT_DEFINITION_FORMAT_VERSION, AIError, APPROVAL_STATE_VERSION, Agent, type AgentConfig$1 as AgentConfig, AgentContextNextGen, type AgentContextNextGenConfig, type AgentDefinitionListOptions, type AgentDefinitionMetadata, type AgentDefinitionSummary, AgentEvents, type AgentMetrics, type AgentPermissionsConfig, AgentResponse, type AgentSessionConfig, type AgentState, type AgentStatus, type ApprovalCacheEntry, type ApprovalDecision, ApproximateTokenEstimator, AudioFormat, AuditEntry, type AuthTemplate, type AuthTemplateField, type BackoffConfig, type BackoffStrategyType, BaseMediaProvider, BasePluginNextGen, BaseProvider, type BaseProviderConfig$1 as BaseProviderConfig, type BaseProviderResponse, BaseTextProvider, type BashResult, type BeforeExecuteResult, BraveProvider, CONNECTOR_CONFIG_VERSION, CONTEXT_SESSION_FORMAT_VERSION, CUSTOM_TOOL_DEFINITION_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, type CustomToolDefinition, type CustomToolListOptions, type CustomToolMetaToolsOptions, type CustomToolMetadata, type CustomToolSummary, type CustomToolTestCase, DEFAULT_ALLOWLIST, DEFAULT_BACKOFF_CONFIG, DEFAULT_CHECKPOINT_STRATEGY, DEFAULT_CIRCUIT_BREAKER_CONFIG, DEFAULT_CONFIG, DEFAULT_CONTEXT_CONFIG, DEFAULT_DESKTOP_CONFIG, DEFAULT_FEATURES, DEFAULT_FILESYSTEM_CONFIG, DEFAULT_HISTORY_MANAGER_CONFIG, DEFAULT_PERMISSION_CONFIG, DEFAULT_RATE_LIMITER_CONFIG, DEFAULT_SHELL_CONFIG, DESKTOP_TOOL_NAMES, type DefaultAllowlistedTool, DefaultCompactionStrategy, type DefaultCompactionStrategyConfig, DependencyCycleError, type DesktopGetCursorResult, type DesktopGetScreenSizeResult, type DesktopKeyboardKeyArgs, type DesktopKeyboardKeyResult, type DesktopKeyboardTypeArgs, type DesktopKeyboardTypeResult, type DesktopMouseClickArgs, type DesktopMouseClickResult, type DesktopMouseDragArgs, type DesktopMouseDragResult, type DesktopMouseMoveArgs, type DesktopMouseMoveResult, type DesktopMouseScrollArgs, type DesktopMouseScrollResult, type DesktopPoint, type DesktopScreenSize, type DesktopScreenshot, type DesktopScreenshotArgs, type DesktopScreenshotResult, type DesktopToolConfig, type DesktopToolName, type DesktopWindow, type DesktopWindowFocusArgs, type DesktopWindowFocusResult, type DesktopWindowListResult, type DirectCallOptions, type DocumentFamily, type DocumentFormat, type DocumentImagePiece, type DocumentMetadata, type DocumentPiece, type DocumentReadOptions, DocumentReader, type DocumentReaderConfig, type DocumentResult, type DocumentSource, type DocumentTextPiece, type DocumentToContentOptions, type EditFileResult, type ErrorContext, ErrorHandler, type ErrorHandlerConfig, type ErrorHandlerEvents, type EvictionStrategy, type ExecuteRoutineOptions, ExecutionContext, ExecutionMetrics, type ExtendedFetchOptions, type ExternalDependency, type ExternalDependencyEvents, ExternalDependencyHandler, type FetchedContent, FileAgentDefinitionStorage, type FileAgentDefinitionStorageConfig, FileConnectorStorage, type FileConnectorStorageConfig, FileContextStorage, type FileContextStorageConfig, FileCustomToolStorage, type FileCustomToolStorageConfig, FileMediaStorage as FileMediaOutputHandler, FileMediaStorage, type FileMediaStorageConfig, FilePersistentInstructionsStorage, type FilePersistentInstructionsStorageConfig, FileRoutineDefinitionStorage, type FileRoutineDefinitionStorageConfig, FileStorage, type FileStorageConfig, FileUserInfoStorage, type FileUserInfoStorageConfig, type FilesystemToolConfig, type FormatDetectionResult, FormatDetector, 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, HookName, type HydrateOptions, type IAgentDefinitionStorage, type IAgentStateStorage, type IAgentStorage, type IAsyncDisposable, IBaseModelDescription, type ICapabilityProvider, type ICompactionStrategy, IConnectorAccessPolicy, type IConnectorConfigStorage, IConnectorRegistry, type IContextCompactor, type IContextComponent, type IContextPluginNextGen, type IContextSnapshot, type IContextStorage, type IContextStrategy, type ICustomToolStorage, type IDesktopDriver, type IDisposable, type IDocumentTransformer, type IFormatHandler, type IHistoryManager, type IHistoryManagerConfig, type IHistoryStorage, IImageProvider, type IMCPClient, type IMediaStorage as IMediaOutputHandler, type IMediaStorage, type IMemoryStorage, type IPersistentInstructionsStorage, type IPlanStorage, type IPluginSnapshot, IProvider, type IResearchSource, type IRoutineDefinitionStorage, 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 IToolSnapshot, type IUserInfoStorage, type IVideoModelDescription, type IVideoProvider, type IViewContextComponent, type IViewContextData, type IVoiceInfo, type ImageFilterOptions, 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, type MeetingSlotSuggestion, MemoryConnectorStorage, MemoryEntry, MemoryEvictionCompactor, MemoryIndex, MemoryPriority, MemoryScope, MemoryStorage, MessageBuilder, MessageRole, type MetricTags, type MetricsCollector, type MetricsCollectorType, type MicrosoftCreateMeetingResult, type MicrosoftDraftEmailResult, type MicrosoftEditMeetingResult, type MicrosoftFindSlotsResult, type MicrosoftGetTranscriptResult, type MicrosoftSendEmailResult, ModelCapabilities, ModelNotSupportedError, type MouseButton, type EvictionStrategy$1 as NextGenEvictionStrategy, NoOpMetrics, NutTreeDriver, type OAuthConfig, type OAuthFlow, OAuthManager, OutputItem, type OversizedInputResult, ParallelTasksError, type PermissionCheckContext, type PermissionCheckResult, type PermissionManagerEvent, type PermissionScope, type PersistentInstructionsConfig, PersistentInstructionsPluginNextGen, type PieceMetadata, 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, type RoutineDefinition, type RoutineDefinitionInput, type RoutineExecution, type RoutineExecutionStatus, 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 SerializedUserInfoState, type SerializedWorkingMemoryState, SerperProvider, ServiceCategory, type ServiceToolFactory, type ShellToolConfig, type SimpleIcon, type SimpleVideoGenerateOptions, type SourceCapabilities, type SourceResult, SpeechToText, type SpeechToTextConfig, type StdioTransportConfig, type StorageConfig, type StorageContext, StorageRegistry, 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, type ToolSource, ToolTimeoutError, type TransportConfig, TruncateCompactor, type UserInfoEntry, type UserInfoPluginConfig, UserInfoPluginNextGen, VENDOR_ICON_MAP, VIDEO_MODELS, VIDEO_MODEL_REGISTRY, type ValidationContext, 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, createCustomToolDelete, createCustomToolDraft, createCustomToolList, createCustomToolLoad, createCustomToolMetaTools, createCustomToolSave, createCustomToolTest, createDesktopGetCursorTool, createDesktopGetScreenSizeTool, createDesktopKeyboardKeyTool, createDesktopKeyboardTypeTool, createDesktopMouseClickTool, createDesktopMouseDragTool, createDesktopMouseMoveTool, createDesktopMouseScrollTool, createDesktopScreenshotTool, createDesktopWindowFocusTool, createDesktopWindowListTool, createDraftEmailTool, createEditFileTool, createEditMeetingTool, createEstimator, createExecuteJavaScriptTool, createFileAgentDefinitionStorage, createFileContextStorage, createFileCustomToolStorage, createFileMediaStorage, createFileRoutineDefinitionStorage, createFindMeetingSlotsTool, createGetMeetingTranscriptTool, createGetPRTool, createGitHubReadFileTool, createGlobTool, createGrepTool, createImageGenerationTool, createImageProvider, createListDirectoryTool, createMeetingTool, createMessageWithImages, createMetricsCollector, createPRCommentsTool, createPRFilesTool, createPlan, createProvider, createReadFileTool, createRoutineDefinition, createRoutineExecution, createSearchCodeTool, createSearchFilesTool, createSendEmailTool, createSpeechToTextTool, createTask, createTextMessage, createTextToSpeechTool, createVideoProvider, createVideoTools, createWriteFileTool, customToolDelete, customToolDraft, customToolList, customToolLoad, customToolSave, customToolTest, desktopGetCursor, desktopGetScreenSize, desktopKeyboardKey, desktopKeyboardType, desktopMouseClick, desktopMouseDrag, desktopMouseMove, desktopMouseScroll, desktopScreenshot, desktopTools, desktopWindowFocus, desktopWindowList, detectDependencyCycle, developerTools, documentToContent, editFile, evaluateCondition, executeRoutine, extractJSON, extractJSONField, extractNumber, findConnectorByServiceTypes, formatAttendees, formatPluginDisplayName, formatRecipients, generateEncryptionKey, generateSimplePlan, generateWebAPITool, getActiveSTTModels, getActiveTTSModels, getActiveVideoModels, getAllBuiltInTools, getAllVendorLogos, getAllVendorTemplates, getBackgroundOutput, getConnectorTools, getCredentialsSetupURL, getDesktopDriver, getDocsURL, getMediaOutputHandler, getMediaStorage, getNextExecutableTasks, getRegisteredScrapeProviders, getRoutineProgress, getSTTModelInfo, getSTTModelsByVendor, getSTTModelsWithFeature, getTTSModelInfo, getTTSModelsByVendor, getTTSModelsWithFeature, getTaskDependencies, getToolByName, getToolCategories, getToolRegistry, getToolsByCategory, getToolsRequiringConnector, getUserPathPrefix, getVendorAuthTemplate, getVendorColor, getVendorDefaultBaseURL, getVendorInfo, getVendorLogo, getVendorLogoCdnUrl, getVendorLogoSvg, getVendorTemplate, getVideoModelInfo, getVideoModelsByVendor, getVideoModelsWithAudio, getVideoModelsWithFeature, glob, globalErrorHandler, grep, hasClipboardImage, hasVendorLogo, hydrateCustomTool, isBlockedCommand, isExcludedExtension, isTaskBlocked, isTeamsMeetingUrl, isTerminalStatus, killBackgroundProcess, listConnectorsByServiceTypes, listDirectory, listVendorIds, listVendors, listVendorsByAuthType, listVendorsByCategory, listVendorsWithLogos, logger, mergeTextPieces, metrics, microsoftFetch, normalizeEmails, parseKeyCombo, parseRepository, readClipboardImage, readDocumentAsContent, readFile, registerScrapeProvider, resetDefaultDriver, resolveConnector, resolveDependencies, resolveMaxContextTokens, resolveMeetingId, resolveModelCapabilities, resolveRepository, retryWithBackoff, sanitizeToolName, setMediaOutputHandler, setMediaStorage, setMetricsCollector, simpleTokenEstimator, toConnectorOptions, toolRegistry, index as tools, updateTaskStatus, validatePath, writeFile };
+/**
+ * Scheduler interface for running routines on a timer.
+ *
+ * Supports interval, one-time (timestamp), and cron schedules.
+ * Implementations may support all or a subset of schedule types.
+ */
+
+interface ScheduleHandle {
+    id: string;
+    cancel(): void;
+}
+interface ScheduleSpec {
+    /** Cron expression (e.g. '0 9 * * 1-5'). Not all implementations support this. */
+    cron?: string;
+    /** Repeat every N milliseconds. */
+    intervalMs?: number;
+    /** Fire once at this Unix timestamp (ms). */
+    once?: number;
+    /** IANA timezone for cron expressions (e.g. 'America/New_York'). */
+    timezone?: string;
+}
+interface IScheduler extends IDisposable {
+    /** Schedule a callback. Returns a handle to cancel it. */
+    schedule(id: string, spec: ScheduleSpec, callback: () => void | Promise<void>): ScheduleHandle;
+    /** Cancel a scheduled callback by ID. */
+    cancel(id: string): void;
+    /** Cancel all scheduled callbacks. */
+    cancelAll(): void;
+    /** Check if a schedule exists by ID. */
+    has(id: string): boolean;
+}
+
+/**
+ * SimpleScheduler — built-in scheduler using setInterval / setTimeout.
+ *
+ * Supports `intervalMs` and `once` schedule types.
+ * Throws for `cron` — use a cron-capable implementation instead.
+ */
+
+declare class SimpleScheduler implements IScheduler {
+    private timers;
+    private _isDestroyed;
+    schedule(id: string, spec: ScheduleSpec, callback: () => void | Promise<void>): ScheduleHandle;
+    cancel(id: string): void;
+    cancelAll(): void;
+    has(id: string): boolean;
+    destroy(): void;
+    get isDestroyed(): boolean;
+}
+
+/**
+ * EventEmitterTrigger — simple typed event emitter for routine triggers.
+ *
+ * Consumers call `emit()` from their webhook/queue/signal handlers
+ * to trigger routine execution.
+ */
+
+declare class EventEmitterTrigger implements IDisposable {
+    private listeners;
+    private _isDestroyed;
+    /**
+     * Register a listener for an event. Returns an unsubscribe function.
+     */
+    on(event: string, callback: (payload: unknown) => void | Promise<void>): () => void;
+    /**
+     * Emit an event to all registered listeners.
+     */
+    emit(event: string, payload?: unknown): void;
+    destroy(): void;
+    get isDestroyed(): boolean;
+}
+
+export { AGENT_DEFINITION_FORMAT_VERSION, AIError, APPROVAL_STATE_VERSION, Agent, type AgentConfig$1 as AgentConfig, AgentContextNextGen, 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, AuthIdentity, 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, CUSTOM_TOOL_DEFINITION_VERSION, CheckpointManager, type CheckpointStrategy, CircuitBreaker, type CircuitBreakerConfig, type CircuitBreakerEvents, type CircuitBreakerMetrics, CircuitOpenError, type CircuitState, type ClipboardImageResult, CompactionContext, CompactionResult, Connector, ConnectorAccessContext, ConnectorAuth, ConnectorConfig, ConnectorConfigResult, ConnectorConfigStore, ConnectorFetchOptions, type ConnectorToolEntry, ConnectorTools, type ConnectorToolsOptions, ConsoleMetrics, ConsolidationResult, Content, ContextBudget$1 as ContextBudget, ContextEvents, ContextFeatures, type ContextManagerConfig, type ContextOverflowBudget, ContextOverflowError, ContextSessionMetadata, ContextSessionSummary, ContextStorageListOptions, type ControlFlowResult, type ControlFlowSource, type ConversationMessage, type CreateConnectorOptions, type CustomToolDefinition, type CustomToolListOptions, type CustomToolMetaToolsOptions, type CustomToolMetadata, type CustomToolSummary, type CustomToolTestCase, DEFAULT_ALLOWLIST, DEFAULT_BACKOFF_CONFIG, DEFAULT_CHECKPOINT_STRATEGY, DEFAULT_CIRCUIT_BREAKER_CONFIG, DEFAULT_CONTEXT_CONFIG, DEFAULT_DESKTOP_CONFIG, DEFAULT_FILESYSTEM_CONFIG, DEFAULT_HISTORY_MANAGER_CONFIG, DEFAULT_PERMISSION_CONFIG, DEFAULT_RATE_LIMITER_CONFIG, DEFAULT_SHELL_CONFIG, DESKTOP_TOOL_NAMES, type DefaultAllowlistedTool, DefaultCompactionStrategy, type DefaultCompactionStrategyConfig, DependencyCycleError, type DesktopGetCursorResult, type DesktopGetScreenSizeResult, type DesktopKeyboardKeyArgs, type DesktopKeyboardKeyResult, type DesktopKeyboardTypeArgs, type DesktopKeyboardTypeResult, type DesktopMouseClickArgs, type DesktopMouseClickResult, type DesktopMouseDragArgs, type DesktopMouseDragResult, type DesktopMouseMoveArgs, type DesktopMouseMoveResult, type DesktopMouseScrollArgs, type DesktopMouseScrollResult, type DesktopPoint, type DesktopScreenSize, type DesktopScreenshot, type DesktopScreenshotArgs, type DesktopScreenshotResult, type DesktopToolConfig, type DesktopToolName, type DesktopWindow, type DesktopWindowFocusArgs, type DesktopWindowFocusResult, type DesktopWindowListResult, type DirectCallOptions, type DocumentFamily, type DocumentFormat, type DocumentImagePiece, type DocumentMetadata, type DocumentPiece, type DocumentReadOptions, DocumentReader, type DocumentReaderConfig, type DocumentResult, type DocumentSource, type DocumentTextPiece, type DocumentToContentOptions, type EditFileResult, type ErrorContext, ErrorHandler, type ErrorHandlerConfig, type ErrorHandlerEvents, EventEmitterTrigger, type EvictionStrategy, type ExecuteRoutineOptions, ExecutionContext, ExecutionMetrics, type ExecutionRecorder, type ExecutionRecorderOptions, type ExtendedFetchOptions, type ExternalDependency, type ExternalDependencyEvents, ExternalDependencyHandler, type FetchedContent, FileAgentDefinitionStorage, type FileAgentDefinitionStorageConfig, FileConnectorStorage, type FileConnectorStorageConfig, FileContextStorage, type FileContextStorageConfig, FileCustomToolStorage, type FileCustomToolStorageConfig, FileMediaStorage as FileMediaOutputHandler, FileMediaStorage, type FileMediaStorageConfig, FilePersistentInstructionsStorage, type FilePersistentInstructionsStorageConfig, FileRoutineDefinitionStorage, type FileRoutineDefinitionStorageConfig, FileStorage, type FileStorageConfig, FileUserInfoStorage, type FileUserInfoStorageConfig, type FilesystemToolConfig, type FormatDetectionResult, FormatDetector, 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 GraphDriveItem, type GrepMatch, type GrepResult, type HTTPTransportConfig, type HistoryManagerEvents, type HistoryMessage, HistoryMode, HookConfig, HookName, type HydrateOptions, type IAgentDefinitionStorage, type IAgentStateStorage, type IAgentStorage, type IAsyncDisposable, IBaseModelDescription, type ICapabilityProvider, ICompactionStrategy, IConnectorAccessPolicy, type IConnectorConfigStorage, IConnectorRegistry, type IContextCompactor, type IContextComponent, IContextPluginNextGen, type IContextSnapshot, IContextStorage, type IContextStrategy, type ICustomToolStorage, type IDesktopDriver, type IDisposable, type IDocumentTransformer, type IFormatHandler, type IHistoryManager, type IHistoryManagerConfig, type IHistoryStorage, IImageProvider, type IMCPClient, type IMediaStorage as IMediaOutputHandler, type IMediaStorage, type IMemoryStorage, type IPersistentInstructionsStorage, type IPlanStorage, type IPluginSnapshot, IProvider, type IResearchSource, type IRoutineDefinitionStorage, type IRoutineExecutionStorage, type ISTTModelDescription, type IScheduler, type IScrapeProvider, type ISearchProvider, type ISpeechToTextProvider, type ITTSModelDescription, ITextProvider, type ITextToSpeechProvider, ITokenEstimator$1 as ITokenEstimator, ITokenStorage, type IToolExecutionPipeline, type IToolExecutionPlugin, type IToolExecutor, type IToolSnapshot, type IUserInfoStorage, type IVideoModelDescription, type IVideoProvider, type IViewContextComponent, type IViewContextData, type IVoiceInfo, type ImageFilterOptions, 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, type MeetingSlotSuggestion, MemoryConnectorStorage, MemoryEntry, MemoryEvictionCompactor, MemoryIndex, MemoryPriority, MemoryScope, MemoryStorage, MessageBuilder, MessageRole, type MetricTags, type MetricsCollector, type MetricsCollectorType, type MicrosoftCreateMeetingResult, type MicrosoftDraftEmailResult, type MicrosoftEditMeetingResult, type MicrosoftFindSlotsResult, type MicrosoftGetTranscriptResult, type MicrosoftListFilesResult, type MicrosoftReadFileResult, type MicrosoftSearchFilesResult, type MicrosoftSendEmailResult, ModelCapabilities, ModelNotSupportedError, type MouseButton, type EvictionStrategy$1 as NextGenEvictionStrategy, NoOpMetrics, NutTreeDriver, type OAuthConfig, type OAuthFlow, OAuthManager, OutputItem, ParallelTasksError, type PermissionCheckContext, type PermissionCheckResult, type PermissionManagerEvent, type PermissionScope, type PersistentInstructionsConfig, PersistentInstructionsPluginNextGen, type PieceMetadata, type Plan, type PlanConcurrency, type PlanInput, type PlanStatus, PlanningAgent, type PlanningAgentConfig, type PluginExecutionContext, PreparedContext, ProviderAuthError, ProviderCapabilities, ProviderConfigAgent, ProviderContextLengthError, ProviderError, ProviderErrorMapper, ProviderNotFoundError, ProviderRateLimitError, ROUTINE_KEYS, 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, type RoutineDefinition, type RoutineDefinitionInput, type RoutineExecution, type RoutineExecutionRecord, type RoutineExecutionStatus, type RoutineExecutionStep, type RoutineParameter, type RoutineStepType, type RoutineTaskResult, type RoutineTaskSnapshot, SIMPLE_ICONS_CDN, type STTModelCapabilities, type STTOptions, type STTOutputFormat$1 as STTOutputFormat, type STTResponse, STT_MODELS, STT_MODEL_REGISTRY, type ScheduleHandle, type ScheduleSpec, 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, SerializedContextState, type SerializedHistoryState, type SerializedInContextMemoryState, type SerializedPersistentInstructionsState, type SerializedToolState, type SerializedUserInfoState, type SerializedWorkingMemoryState, SerperProvider, ServiceCategory, type ServiceToolFactory, type ShellToolConfig, type SimpleIcon, SimpleScheduler, type SimpleVideoGenerateOptions, type SourceCapabilities, type SourceResult, SpeechToText, type SpeechToTextConfig, type StdioTransportConfig, type StorageConfig, type StorageContext, StorageRegistry, type StoredAgentDefinition, type StoredAgentType, type StoredConnectorConfig, StoredContextSession, type StoredToken, type StrategyInfo, StrategyRegistry, type StrategyRegistryEntry, StreamEvent, StreamEventType, StreamHelpers, StreamState, type SubRoutineSpec, SummarizeCompactor, TERMINAL_TASK_STATUSES, type TTSModelCapabilities, type TTSOptions, type TTSResponse, TTS_MODELS, TTS_MODEL_REGISTRY, type Task, type AgentConfig as TaskAgentStateConfig, type TaskCondition, type TaskControlFlow, type TaskExecution, type TaskFailure, type TaskFoldFlow, type TaskInput, type TaskMapFlow, type TaskSourceRef, type TaskStatus, TaskStatusForMemory, TaskTimeoutError, ToolContext as TaskToolContext, type TaskUntilFlow, type TaskValidation, TaskValidationError, type TaskValidationResult, TavilyProvider, type TemplateCredentials, TextGenerateOptions, TextToSpeech, type TextToSpeechConfig, TokenBucketRateLimiter, type TokenContentType, Tool, ToolCall, type ToolCatalogPluginConfig, ToolCatalogPluginNextGen, type ToolCategory, ToolCategoryScope, 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, type ToolSource, ToolTimeoutError, type TransportConfig, TruncateCompactor, type UserInfoEntry, type UserInfoPluginConfig, UserInfoPluginNextGen, VENDOR_ICON_MAP, VIDEO_MODELS, VIDEO_MODEL_REGISTRY, type ValidationContext, 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, createCustomToolDelete, createCustomToolDraft, createCustomToolList, createCustomToolLoad, createCustomToolMetaTools, createCustomToolSave, createCustomToolTest, createDesktopGetCursorTool, createDesktopGetScreenSizeTool, createDesktopKeyboardKeyTool, createDesktopKeyboardTypeTool, createDesktopMouseClickTool, createDesktopMouseDragTool, createDesktopMouseMoveTool, createDesktopMouseScrollTool, createDesktopScreenshotTool, createDesktopWindowFocusTool, createDesktopWindowListTool, createDraftEmailTool, createEditFileTool, createEditMeetingTool, createEstimator, createExecuteJavaScriptTool, createExecutionRecorder, createFileAgentDefinitionStorage, createFileContextStorage, createFileCustomToolStorage, createFileMediaStorage, createFileRoutineDefinitionStorage, createFindMeetingSlotsTool, createGetMeetingTranscriptTool, createGetPRTool, createGitHubReadFileTool, createGlobTool, createGrepTool, createImageGenerationTool, createImageProvider, createListDirectoryTool, createMeetingTool, createMessageWithImages, createMetricsCollector, createMicrosoftListFilesTool, createMicrosoftReadFileTool, createMicrosoftSearchFilesTool, createPRCommentsTool, createPRFilesTool, createPlan, createProvider, createReadFileTool, createRoutineDefinition, createRoutineExecution, createRoutineExecutionRecord, createSearchCodeTool, createSearchFilesTool, createSendEmailTool, createSpeechToTextTool, createTask, createTaskSnapshots, createTextMessage, createTextToSpeechTool, createVideoProvider, createVideoTools, createWriteFileTool, customToolDelete, customToolDraft, customToolList, customToolLoad, customToolSave, customToolTest, desktopGetCursor, desktopGetScreenSize, desktopKeyboardKey, desktopKeyboardType, desktopMouseClick, desktopMouseDrag, desktopMouseMove, desktopMouseScroll, desktopScreenshot, desktopTools, desktopWindowFocus, desktopWindowList, detectDependencyCycle, developerTools, documentToContent, editFile, encodeSharingUrl, evaluateCondition, executeRoutine, extractJSON, extractJSONField, extractNumber, findConnectorByServiceTypes, formatAttendees, formatFileSize, formatPluginDisplayName, formatRecipients, generateEncryptionKey, generateSimplePlan, generateWebAPITool, getActiveSTTModels, getActiveTTSModels, getActiveVideoModels, getAllBuiltInTools, getAllVendorLogos, getAllVendorTemplates, getBackgroundOutput, getConnectorTools, getCredentialsSetupURL, getDesktopDriver, getDocsURL, getDrivePrefix, getMediaOutputHandler, getMediaStorage, getNextExecutableTasks, getRegisteredScrapeProviders, getRoutineProgress, getSTTModelInfo, getSTTModelsByVendor, getSTTModelsWithFeature, getTTSModelInfo, getTTSModelsByVendor, getTTSModelsWithFeature, getTaskDependencies, getToolByName, getToolCategories, getToolRegistry, getToolsByCategory, getToolsRequiringConnector, getUserPathPrefix, getVendorAuthTemplate, getVendorColor, getVendorDefaultBaseURL, getVendorInfo, getVendorLogo, getVendorLogoCdnUrl, getVendorLogoSvg, getVendorTemplate, getVideoModelInfo, getVideoModelsByVendor, getVideoModelsWithAudio, getVideoModelsWithFeature, glob, globalErrorHandler, grep, hasClipboardImage, hasVendorLogo, hydrateCustomTool, isBlockedCommand, isExcludedExtension, isMicrosoftFileUrl, isTaskBlocked, isTeamsMeetingUrl, isTerminalStatus, isWebUrl, killBackgroundProcess, listConnectorsByServiceTypes, listDirectory, listVendorIds, listVendors, listVendorsByAuthType, listVendorsByCategory, listVendorsWithLogos, logger, mergeTextPieces, metrics, microsoftFetch, normalizeEmails, parseKeyCombo, parseRepository, readClipboardImage, readDocumentAsContent, readFile, registerScrapeProvider, resetDefaultDriver, resolveConnector, resolveDependencies, resolveFileEndpoints, resolveFlowSource, resolveMaxContextTokens, resolveMeetingId, resolveModelCapabilities, resolveRepository, resolveTemplates, retryWithBackoff, sanitizeToolName, setMediaOutputHandler, setMediaStorage, setMetricsCollector, simpleTokenEstimator, toConnectorOptions, toolRegistry, index as tools, updateTaskStatus, validatePath, writeFile };