@everworker/oneringai 0.3.2 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.cts CHANGED
@@ -1,7 +1,7 @@
1
1
  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-Br817mKc.cjs';
2
2
  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-Br817mKc.cjs';
3
- 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 StaleEntryInfo, o as PriorityContext, p as MemoryIndex, q as TaskStatusForMemory, r as WorkingMemoryAccess, s as TokenUsage, t as StreamEventType, u as TextGenerateOptions, v as ModelCapabilities, w as MessageRole } from './index-WlQwiNF8.cjs';
4
- export { x as AfterToolContext, y as AgentEventName, z as AgenticLoopEventName, B as AgenticLoopEvents, D as ApprovalResult, G as ApproveToolContext, J as BeforeToolContext, K as BuiltInTool, N as CompactionItem, Q as ContentType, R as DEFAULT_MEMORY_CONFIG, U as ErrorEvent, V as ExecutionConfig, X as Hook, Y as HookManager, Z as HookName, _ 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 ReasoningItem, ab as ResponseCompleteEvent, ac as ResponseCreatedEvent, ad as ResponseInProgressEvent, ae as SimpleScope, af as TaskAwareScope, ag as ToolCallArgumentsDeltaEvent, ah as ToolCallArgumentsDoneEvent, ai as ToolCallStartEvent, aj as ToolCallState, ak as ToolExecutionContext, al as ToolExecutionDoneEvent, am as ToolExecutionStartEvent, an as ToolModification, ao as ToolResultContent, ap as ToolUseContent, aq as calculateEntrySize, ar as defaultDescribeCall, as as forPlan, at as forTasks, au as getToolCallDescription, av as isErrorEvent, aw as isOutputTextDelta, ax as isResponseComplete, ay as isSimpleScope, az as isStreamEvent, aA as isTaskAwareScope, aB as isTerminalMemoryStatus, aC as isToolCallArgumentsDelta, aD as isToolCallArgumentsDone, aE as isToolCallStart, aF as scopeEquals, aG as scopeMatches } from './index-WlQwiNF8.cjs';
3
+ 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-CR5PHkck.cjs';
4
+ 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 ReasoningItem, ab as ResponseCompleteEvent, ac as ResponseCreatedEvent, ad as ResponseInProgressEvent, ae as SimpleScope, af as TaskAwareScope, ag as ToolCallArgumentsDeltaEvent, ah as ToolCallArgumentsDoneEvent, ai as ToolCallStartEvent, aj as ToolCallState, ak as ToolExecutionContext, al as ToolExecutionDoneEvent, am as ToolExecutionStartEvent, an as ToolModification, ao as ToolResultContent, ap as ToolUseContent, aq as calculateEntrySize, ar as defaultDescribeCall, as as forPlan, at as forTasks, au as getToolCallDescription, av as isErrorEvent, aw as isOutputTextDelta, ax as isResponseComplete, ay as isSimpleScope, az as isStreamEvent, aA as isTaskAwareScope, aB as isTerminalMemoryStatus, aC as isToolCallArgumentsDelta, aD as isToolCallArgumentsDone, aE as isToolCallStart, aF as scopeEquals, aG as scopeMatches } from './index-CR5PHkck.cjs';
5
5
  import { EventEmitter } from 'eventemitter3';
6
6
  import { V as Vendor } from './Vendor-DYh_bzwo.cjs';
7
7
  export { a as VENDORS, i as isVendor } from './Vendor-DYh_bzwo.cjs';
@@ -1555,6 +1555,466 @@ interface IUserInfoStorage {
1555
1555
  getPath(userId: string | undefined): string;
1556
1556
  }
1557
1557
 
1558
+ /**
1559
+ * Task and Plan entities for TaskAgent
1560
+ *
1561
+ * Defines the data structures for task-based autonomous agents.
1562
+ */
1563
+ /**
1564
+ * Task status lifecycle
1565
+ */
1566
+ type TaskStatus = 'pending' | 'blocked' | 'in_progress' | 'waiting_external' | 'completed' | 'failed' | 'skipped' | 'cancelled';
1567
+ /**
1568
+ * Terminal statuses - task will not progress further
1569
+ */
1570
+ declare const TERMINAL_TASK_STATUSES: TaskStatus[];
1571
+ /**
1572
+ * Check if a task status is terminal (task will not progress further)
1573
+ */
1574
+ declare function isTerminalStatus(status: TaskStatus): boolean;
1575
+ /**
1576
+ * Plan status
1577
+ */
1578
+ type PlanStatus = 'pending' | 'running' | 'suspended' | 'completed' | 'failed' | 'cancelled';
1579
+ /**
1580
+ * Condition operators for conditional task execution
1581
+ */
1582
+ type ConditionOperator = 'exists' | 'not_exists' | 'equals' | 'contains' | 'truthy' | 'greater_than' | 'less_than';
1583
+ /**
1584
+ * Task condition - evaluated before execution
1585
+ */
1586
+ interface TaskCondition {
1587
+ memoryKey: string;
1588
+ operator: ConditionOperator;
1589
+ value?: unknown;
1590
+ onFalse: 'skip' | 'fail' | 'wait';
1591
+ }
1592
+ /**
1593
+ * External dependency configuration
1594
+ */
1595
+ interface ExternalDependency {
1596
+ type: 'webhook' | 'poll' | 'manual' | 'scheduled';
1597
+ /** For webhook: unique ID to match incoming webhook */
1598
+ webhookId?: string;
1599
+ /** For poll: how to check if complete */
1600
+ pollConfig?: {
1601
+ toolName: string;
1602
+ toolArgs: Record<string, unknown>;
1603
+ intervalMs: number;
1604
+ maxAttempts: number;
1605
+ };
1606
+ /** For scheduled: when to resume */
1607
+ scheduledAt?: number;
1608
+ /** For manual: description of what's needed */
1609
+ manualDescription?: string;
1610
+ /** Timeout for all types */
1611
+ timeoutMs?: number;
1612
+ /** Current state */
1613
+ state: 'waiting' | 'received' | 'timeout';
1614
+ /** Data received from external source */
1615
+ receivedData?: unknown;
1616
+ receivedAt?: number;
1617
+ }
1618
+ /**
1619
+ * Task execution settings
1620
+ */
1621
+ interface TaskExecution {
1622
+ /** Can run in parallel with other parallel tasks */
1623
+ parallel?: boolean;
1624
+ /** Max concurrent if this spawns sub-work */
1625
+ maxConcurrency?: number;
1626
+ /** Priority (higher = executed first) */
1627
+ priority?: number;
1628
+ /**
1629
+ * Maximum LLM iterations (tool-call loops) per agent.run() for this task.
1630
+ * Prevents runaway agents. Default: 15.
1631
+ */
1632
+ maxIterations?: number;
1633
+ /**
1634
+ * If true (default), re-check condition immediately before LLM call
1635
+ * to protect against race conditions when parallel tasks modify memory.
1636
+ * Set to false to skip re-check for performance if you know condition won't change.
1637
+ */
1638
+ raceProtection?: boolean;
1639
+ }
1640
+ /**
1641
+ * Task completion validation settings
1642
+ *
1643
+ * Used to verify that a task actually achieved its goal before marking it complete.
1644
+ * Supports multiple validation approaches:
1645
+ * - Programmatic checks (memory keys, hooks)
1646
+ * - LLM self-reflection with completeness scoring
1647
+ * - Natural language criteria evaluation
1648
+ */
1649
+ interface TaskValidation {
1650
+ /**
1651
+ * Natural language completion criteria.
1652
+ * These are evaluated by LLM self-reflection to determine if the task is complete.
1653
+ * Examples:
1654
+ * - "The response contains at least 3 specific examples"
1655
+ * - "User's email has been validated and stored in memory"
1656
+ * - "All requested data fields are present in the output"
1657
+ *
1658
+ * This is the RECOMMENDED approach for flexible, intelligent validation.
1659
+ */
1660
+ completionCriteria?: string[];
1661
+ /**
1662
+ * Minimum completeness score (0-100) to consider task successful.
1663
+ * LLM self-reflection returns a score; if below this threshold:
1664
+ * - If requireUserApproval is set, ask user
1665
+ * - Otherwise, follow the mode setting (strict = fail, warn = continue)
1666
+ * Default: 80
1667
+ */
1668
+ minCompletionScore?: number;
1669
+ /**
1670
+ * When to require user approval:
1671
+ * - 'never': Never ask user, use automated decision (default)
1672
+ * - 'uncertain': Ask user when score is between minCompletionScore and minCompletionScore + 15
1673
+ * - 'always': Always ask user to confirm task completion
1674
+ */
1675
+ requireUserApproval?: 'never' | 'uncertain' | 'always';
1676
+ /**
1677
+ * Memory keys that must exist after task completion.
1678
+ * If the task should store data in memory, list the required keys here.
1679
+ * This is a hard requirement checked BEFORE LLM reflection.
1680
+ */
1681
+ requiredMemoryKeys?: string[];
1682
+ /**
1683
+ * Custom validation function name (registered via validateTask hook).
1684
+ * The hook will be called with this identifier to dispatch to the right validator.
1685
+ * Runs AFTER LLM reflection, can override the result.
1686
+ */
1687
+ customValidator?: string;
1688
+ /**
1689
+ * Validation mode:
1690
+ * - 'strict': Validation failure marks task as failed (default)
1691
+ * - 'warn': Validation failure logs warning but task still completes
1692
+ */
1693
+ mode?: 'strict' | 'warn';
1694
+ /**
1695
+ * Skip LLM self-reflection validation.
1696
+ * LLM validation is opt-in: set to `false` to enable it (requires completionCriteria).
1697
+ * Default: undefined (treated as true — validation auto-passes).
1698
+ */
1699
+ skipReflection?: boolean;
1700
+ }
1701
+ /**
1702
+ * Result of task validation (returned by LLM reflection)
1703
+ */
1704
+ interface TaskValidationResult {
1705
+ /** Whether the task is considered complete */
1706
+ isComplete: boolean;
1707
+ /** Completeness score from 0-100 */
1708
+ completionScore: number;
1709
+ /** LLM's explanation of why the task is/isn't complete */
1710
+ explanation: string;
1711
+ /** Per-criterion evaluation results */
1712
+ criteriaResults?: Array<{
1713
+ criterion: string;
1714
+ met: boolean;
1715
+ evidence?: string;
1716
+ }>;
1717
+ /** Whether user approval is needed */
1718
+ requiresUserApproval: boolean;
1719
+ /** Reason for requiring user approval */
1720
+ approvalReason?: string;
1721
+ }
1722
+ /**
1723
+ * A single unit of work
1724
+ */
1725
+ interface Task {
1726
+ id: string;
1727
+ name: string;
1728
+ description: string;
1729
+ status: TaskStatus;
1730
+ /** Tasks that must complete before this one (task IDs) */
1731
+ dependsOn: string[];
1732
+ /** External dependency (if waiting on external event) */
1733
+ externalDependency?: ExternalDependency;
1734
+ /** Condition for execution */
1735
+ condition?: TaskCondition;
1736
+ /** Execution settings */
1737
+ execution?: TaskExecution;
1738
+ /** Completion validation settings */
1739
+ validation?: TaskValidation;
1740
+ /** Tool names the LLM should prefer for this task (advisory, not enforced) */
1741
+ suggestedTools?: string[];
1742
+ /** Optional expected output description */
1743
+ expectedOutput?: string;
1744
+ /** Result after completion */
1745
+ result?: {
1746
+ success: boolean;
1747
+ output?: unknown;
1748
+ error?: string;
1749
+ /** Validation score (0-100) if validation was performed */
1750
+ validationScore?: number;
1751
+ /** Explanation of validation result */
1752
+ validationExplanation?: string;
1753
+ };
1754
+ /** Timestamps */
1755
+ createdAt: number;
1756
+ startedAt?: number;
1757
+ completedAt?: number;
1758
+ lastUpdatedAt: number;
1759
+ /** Retry tracking */
1760
+ attempts: number;
1761
+ maxAttempts: number;
1762
+ /** Metadata for extensions */
1763
+ metadata?: Record<string, unknown>;
1764
+ }
1765
+ /**
1766
+ * Input for creating a task
1767
+ */
1768
+ interface TaskInput {
1769
+ id?: string;
1770
+ name: string;
1771
+ description: string;
1772
+ dependsOn?: string[];
1773
+ externalDependency?: ExternalDependency;
1774
+ condition?: TaskCondition;
1775
+ execution?: TaskExecution;
1776
+ suggestedTools?: string[];
1777
+ validation?: TaskValidation;
1778
+ expectedOutput?: string;
1779
+ maxAttempts?: number;
1780
+ metadata?: Record<string, unknown>;
1781
+ }
1782
+ /**
1783
+ * Plan concurrency settings
1784
+ */
1785
+ interface PlanConcurrency {
1786
+ maxParallelTasks: number;
1787
+ strategy: 'fifo' | 'priority' | 'shortest-first';
1788
+ /**
1789
+ * How to handle failures when executing tasks in parallel
1790
+ * - 'fail-fast': Stop on first failure (Promise.all behavior) - DEFAULT
1791
+ * - 'continue': Continue other tasks on failure, mark failed ones
1792
+ * - 'fail-all': Wait for all to complete, then report all failures together
1793
+ */
1794
+ failureMode?: 'fail-fast' | 'continue' | 'fail-all';
1795
+ }
1796
+ /**
1797
+ * Execution plan - a goal with steps to achieve it
1798
+ */
1799
+ interface Plan {
1800
+ id: string;
1801
+ goal: string;
1802
+ context?: string;
1803
+ tasks: Task[];
1804
+ /** Concurrency settings */
1805
+ concurrency?: PlanConcurrency;
1806
+ /** Can agent modify the plan? */
1807
+ allowDynamicTasks: boolean;
1808
+ /** Plan status */
1809
+ status: PlanStatus;
1810
+ /** Why is the plan suspended? */
1811
+ suspendedReason?: {
1812
+ type: 'waiting_external' | 'manual_pause' | 'error';
1813
+ taskId?: string;
1814
+ message?: string;
1815
+ };
1816
+ /** Timestamps */
1817
+ createdAt: number;
1818
+ startedAt?: number;
1819
+ completedAt?: number;
1820
+ lastUpdatedAt: number;
1821
+ /** For resume: which task to continue from */
1822
+ currentTaskId?: string;
1823
+ /** Metadata */
1824
+ metadata?: Record<string, unknown>;
1825
+ }
1826
+ /**
1827
+ * Input for creating a plan
1828
+ */
1829
+ interface PlanInput {
1830
+ goal: string;
1831
+ context?: string;
1832
+ tasks: TaskInput[];
1833
+ concurrency?: PlanConcurrency;
1834
+ allowDynamicTasks?: boolean;
1835
+ metadata?: Record<string, unknown>;
1836
+ /** Skip dependency cycle detection (default: false) */
1837
+ skipCycleCheck?: boolean;
1838
+ }
1839
+ /**
1840
+ * Memory access interface for condition evaluation
1841
+ */
1842
+ interface ConditionMemoryAccess {
1843
+ get(key: string): Promise<unknown>;
1844
+ }
1845
+ /**
1846
+ * Create a task with defaults
1847
+ */
1848
+ declare function createTask(input: TaskInput): Task;
1849
+ /**
1850
+ * Create a plan with tasks
1851
+ * @throws {DependencyCycleError} If circular dependencies detected (unless skipCycleCheck is true)
1852
+ */
1853
+ declare function createPlan(input: PlanInput): Plan;
1854
+ /**
1855
+ * Check if a task can be executed (dependencies met, status is pending)
1856
+ */
1857
+ declare function canTaskExecute(task: Task, allTasks: Task[]): boolean;
1858
+ /**
1859
+ * Get the next tasks that can be executed
1860
+ */
1861
+ declare function getNextExecutableTasks(plan: Plan): Task[];
1862
+ /**
1863
+ * Evaluate a task condition against memory
1864
+ */
1865
+ declare function evaluateCondition(condition: TaskCondition, memory: ConditionMemoryAccess): Promise<boolean>;
1866
+ /**
1867
+ * Update task status and timestamps
1868
+ */
1869
+ declare function updateTaskStatus(task: Task, status: TaskStatus): Task;
1870
+ /**
1871
+ * Check if a task is blocked by dependencies
1872
+ */
1873
+ declare function isTaskBlocked(task: Task, allTasks: Task[]): boolean;
1874
+ /**
1875
+ * Get the dependency tasks for a task
1876
+ */
1877
+ declare function getTaskDependencies(task: Task, allTasks: Task[]): Task[];
1878
+ /**
1879
+ * Resolve task name dependencies to task IDs
1880
+ * Modifies taskInputs in place
1881
+ */
1882
+ declare function resolveDependencies(taskInputs: TaskInput[], tasks: Task[]): void;
1883
+ /**
1884
+ * Detect dependency cycles in tasks using depth-first search
1885
+ * @param tasks Array of tasks with resolved dependencies (IDs, not names)
1886
+ * @returns Array of task IDs forming the cycle (e.g., ['A', 'B', 'C', 'A']), or null if no cycle
1887
+ */
1888
+ declare function detectDependencyCycle(tasks: Task[]): string[] | null;
1889
+
1890
+ /**
1891
+ * Routine entities for reusable task-based workflows.
1892
+ *
1893
+ * A RoutineDefinition is a template (recipe) that can be executed multiple times.
1894
+ * A RoutineExecution is a running instance backed by an existing Plan.
1895
+ */
1896
+
1897
+ /**
1898
+ * A reusable routine definition (template).
1899
+ *
1900
+ * Defines what to do but has no runtime state.
1901
+ * Multiple RoutineExecutions can be created from one RoutineDefinition.
1902
+ */
1903
+ interface RoutineDefinition {
1904
+ /** Unique routine identifier */
1905
+ id: string;
1906
+ /** Human-readable name */
1907
+ name: string;
1908
+ /** Description of what this routine accomplishes */
1909
+ description: string;
1910
+ /** Version string for tracking routine evolution */
1911
+ version?: string;
1912
+ /** Task templates in execution order (dependencies may override order) */
1913
+ tasks: TaskInput[];
1914
+ /** Tool names that must be available before starting */
1915
+ requiredTools?: string[];
1916
+ /** Plugin names that must be enabled before starting (e.g. 'working_memory') */
1917
+ requiredPlugins?: string[];
1918
+ /** Additional instructions injected into system prompt when routine is active */
1919
+ instructions?: string;
1920
+ /** Concurrency settings for task execution */
1921
+ concurrency?: PlanConcurrency;
1922
+ /** Whether the LLM can dynamically add/modify tasks during execution. Default: false */
1923
+ allowDynamicTasks?: boolean;
1924
+ /** Tags for categorization and filtering */
1925
+ tags?: string[];
1926
+ /** Author/creator */
1927
+ author?: string;
1928
+ /** When the definition was created (ISO string) */
1929
+ createdAt: string;
1930
+ /** When the definition was last updated (ISO string) */
1931
+ updatedAt: string;
1932
+ /** Metadata for extensions */
1933
+ metadata?: Record<string, unknown>;
1934
+ }
1935
+ /**
1936
+ * Input for creating a RoutineDefinition.
1937
+ * id, createdAt, updatedAt are auto-generated if not provided.
1938
+ */
1939
+ interface RoutineDefinitionInput {
1940
+ id?: string;
1941
+ name: string;
1942
+ description: string;
1943
+ version?: string;
1944
+ tasks: TaskInput[];
1945
+ requiredTools?: string[];
1946
+ requiredPlugins?: string[];
1947
+ instructions?: string;
1948
+ concurrency?: PlanConcurrency;
1949
+ allowDynamicTasks?: boolean;
1950
+ tags?: string[];
1951
+ author?: string;
1952
+ metadata?: Record<string, unknown>;
1953
+ }
1954
+ /**
1955
+ * Execution status for a routine run
1956
+ */
1957
+ type RoutineExecutionStatus = 'pending' | 'running' | 'paused' | 'completed' | 'failed' | 'cancelled';
1958
+ /**
1959
+ * Runtime state when executing a routine.
1960
+ * Created from a RoutineDefinition, delegates task management to Plan.
1961
+ */
1962
+ interface RoutineExecution {
1963
+ /** Unique execution ID */
1964
+ id: string;
1965
+ /** Reference to the routine definition ID */
1966
+ routineId: string;
1967
+ /** The live plan managing task execution (created via createPlan) */
1968
+ plan: Plan;
1969
+ /** Current execution status */
1970
+ status: RoutineExecutionStatus;
1971
+ /** Overall progress (0-100) based on completed tasks */
1972
+ progress: number;
1973
+ /** Timestamps */
1974
+ startedAt?: number;
1975
+ completedAt?: number;
1976
+ lastUpdatedAt: number;
1977
+ /** Error message if failed */
1978
+ error?: string;
1979
+ /** Metadata */
1980
+ metadata?: Record<string, unknown>;
1981
+ }
1982
+ /**
1983
+ * Create a RoutineDefinition with defaults.
1984
+ * Validates task dependency references and detects cycles.
1985
+ */
1986
+ declare function createRoutineDefinition(input: RoutineDefinitionInput): RoutineDefinition;
1987
+ /**
1988
+ * Create a RoutineExecution from a RoutineDefinition.
1989
+ * Instantiates all tasks into a Plan via createPlan().
1990
+ */
1991
+ declare function createRoutineExecution(definition: RoutineDefinition): RoutineExecution;
1992
+ /**
1993
+ * Compute routine progress (0-100) from plan task statuses.
1994
+ */
1995
+ declare function getRoutineProgress(execution: RoutineExecution): number;
1996
+
1997
+ /**
1998
+ * IRoutineDefinitionStorage - Storage interface for routine definitions.
1999
+ *
2000
+ * Follows the same userId-optional pattern as ICustomToolStorage and IUserInfoStorage.
2001
+ * When userId is undefined, defaults to 'default' user in storage implementation.
2002
+ */
2003
+
2004
+ interface IRoutineDefinitionStorage {
2005
+ save(userId: string | undefined, definition: RoutineDefinition): Promise<void>;
2006
+ load(userId: string | undefined, id: string): Promise<RoutineDefinition | null>;
2007
+ delete(userId: string | undefined, id: string): Promise<void>;
2008
+ exists(userId: string | undefined, id: string): Promise<boolean>;
2009
+ list(userId: string | undefined, options?: {
2010
+ tags?: string[];
2011
+ search?: string;
2012
+ limit?: number;
2013
+ offset?: number;
2014
+ }): Promise<RoutineDefinition[]>;
2015
+ getPath(userId: string | undefined): string;
2016
+ }
2017
+
1558
2018
  /**
1559
2019
  * StorageRegistry - Centralized storage backend registry
1560
2020
  *
@@ -1616,6 +2076,7 @@ interface StorageConfig {
1616
2076
  persistentInstructions: (agentId: string, context?: StorageContext) => IPersistentInstructionsStorage;
1617
2077
  workingMemory: (context?: StorageContext) => IMemoryStorage;
1618
2078
  userInfo: (context?: StorageContext) => IUserInfoStorage;
2079
+ routineDefinitions: (context?: StorageContext) => IRoutineDefinitionStorage;
1619
2080
  }
1620
2081
  declare class StorageRegistry {
1621
2082
  /** Internal storage map */
@@ -3717,6 +4178,7 @@ declare abstract class BaseAgent<TConfig extends BaseAgentConfig = BaseAgentConf
3717
4178
  protected _config: TConfig;
3718
4179
  protected _agentContext: AgentContextNextGen;
3719
4180
  protected _permissionManager: ToolPermissionManager;
4181
+ protected _ownsContext: boolean;
3720
4182
  protected _isDestroyed: boolean;
3721
4183
  protected _cleanupCallbacks: Array<() => void | Promise<void>>;
3722
4184
  protected _logger: FrameworkLogger;
@@ -4249,9 +4711,113 @@ declare class Agent extends BaseAgent<AgentConfig$1, AgentEvents> implements IDi
4249
4711
  isRunning(): boolean;
4250
4712
  isPaused(): boolean;
4251
4713
  isCancelled(): boolean;
4714
+ /**
4715
+ * Clear conversation history, resetting the context for a fresh interaction.
4716
+ * Plugins (working memory, in-context memory, etc.) are NOT affected.
4717
+ */
4718
+ clearConversation(reason?: string): void;
4719
+ /**
4720
+ * Register a hook on the agent. Can be called after creation.
4721
+ */
4722
+ registerHook(name: HookName, hook: Function): void;
4723
+ /**
4724
+ * Unregister a previously registered hook by reference.
4725
+ */
4726
+ unregisterHook(name: HookName, hook: Function): boolean;
4252
4727
  destroy(): void;
4253
4728
  }
4254
4729
 
4730
+ /**
4731
+ * Routine Execution Runner
4732
+ *
4733
+ * Executes a RoutineDefinition by creating an Agent, running tasks in dependency order,
4734
+ * validating completion via LLM self-reflection, and using working/in-context memory
4735
+ * as the bridge between tasks.
4736
+ */
4737
+
4738
+ /**
4739
+ * Options for executing a routine.
4740
+ *
4741
+ * Two modes:
4742
+ * 1. **New agent**: Pass `connector` + `model` (+ optional `tools`, `hooks`).
4743
+ * An agent is created internally and destroyed after execution.
4744
+ * 2. **Existing agent**: Pass `agent` (a pre-created Agent instance).
4745
+ * The agent is NOT destroyed after execution — caller owns its lifecycle.
4746
+ * The agent's existing connector, model, tools, and hooks are used.
4747
+ */
4748
+ interface ExecuteRoutineOptions {
4749
+ /** Routine definition to execute */
4750
+ definition: RoutineDefinition;
4751
+ /**
4752
+ * Pre-created Agent instance. When provided, `connector`/`model`/`tools` are ignored.
4753
+ * The agent is NOT destroyed after execution — caller manages its lifecycle.
4754
+ */
4755
+ agent?: Agent;
4756
+ /** Connector name — required when `agent` is not provided */
4757
+ connector?: string;
4758
+ /** Model ID — required when `agent` is not provided */
4759
+ model?: string;
4760
+ /** Additional tools — only used when creating a new agent (no `agent` provided) */
4761
+ tools?: ToolFunction[];
4762
+ /** Hooks — applied to agent for the duration of routine execution.
4763
+ * For new agents: baked in at creation. For existing agents: registered before
4764
+ * execution and unregistered after. */
4765
+ hooks?: HookConfig;
4766
+ /** Called when a task starts executing (set to in_progress) */
4767
+ onTaskStarted?: (task: Task, execution: RoutineExecution) => void;
4768
+ /** Called when a task completes successfully */
4769
+ onTaskComplete?: (task: Task, execution: RoutineExecution) => void;
4770
+ /** Called when a task fails */
4771
+ onTaskFailed?: (task: Task, execution: RoutineExecution) => void;
4772
+ /** Called after each validation attempt (whether pass or fail) */
4773
+ onTaskValidation?: (task: Task, result: TaskValidationResult, execution: RoutineExecution) => void;
4774
+ /** Configurable prompts (all have sensible defaults) */
4775
+ prompts?: {
4776
+ /** Override system prompt builder. Receives definition, should return full system prompt. */
4777
+ system?: (definition: RoutineDefinition) => string;
4778
+ /** Override task prompt builder. Receives task, should return the user message for that task. */
4779
+ task?: (task: Task) => string;
4780
+ /** Override validation prompt builder. Receives task + validation context (response, memory state, tool calls). */
4781
+ validation?: (task: Task, context: ValidationContext) => string;
4782
+ };
4783
+ }
4784
+ /**
4785
+ * Context snapshot passed to the validation prompt builder.
4786
+ * Contains everything the validator needs to evaluate task completion
4787
+ * WITHOUT conversation history.
4788
+ */
4789
+ interface ValidationContext {
4790
+ /** Agent's final text output */
4791
+ responseText: string;
4792
+ /** Current in-context memory entries (key-value pairs set via context_set) */
4793
+ inContextMemory: string | null;
4794
+ /** Current working memory index (keys + descriptions of stored data) */
4795
+ workingMemoryIndex: string | null;
4796
+ /** Formatted log of all tool calls made during this task execution */
4797
+ toolCallLog: string;
4798
+ }
4799
+ /**
4800
+ * Execute a routine definition.
4801
+ *
4802
+ * Creates an Agent with working memory + in-context memory enabled, then runs
4803
+ * each task in dependency order. Between tasks, conversation history is cleared
4804
+ * but memory plugins persist, allowing tasks to share data via memory.
4805
+ *
4806
+ * @example
4807
+ * ```typescript
4808
+ * const execution = await executeRoutine({
4809
+ * definition: myRoutine,
4810
+ * connector: 'openai',
4811
+ * model: 'gpt-4',
4812
+ * tools: [myCustomTool],
4813
+ * onTaskComplete: (task) => console.log(`✓ ${task.name}`),
4814
+ * });
4815
+ *
4816
+ * console.log(execution.status); // 'completed' | 'failed'
4817
+ * ```
4818
+ */
4819
+ declare function executeRoutine(options: ExecuteRoutineOptions): Promise<RoutineExecution>;
4820
+
4255
4821
  /**
4256
4822
  * BasePluginNextGen - Base class for context plugins
4257
4823
  *
@@ -7964,344 +8530,20 @@ declare class WorkingMemory extends EventEmitter<WorkingMemoryEvents> implements
7964
8530
  *
7965
8531
  * Returns a serializable representation of all memory entries
7966
8532
  * that can be saved to storage and restored later.
7967
- *
7968
- * @returns Serialized memory state
7969
- */
7970
- serialize(): Promise<SerializedMemory>;
7971
- /**
7972
- * Restore memory entries from serialized state
7973
- *
7974
- * Clears existing memory and repopulates from the serialized state.
7975
- * Timestamps are reset to current time.
7976
- *
7977
- * @param state - Previously serialized memory state
7978
- */
7979
- restore(state: SerializedMemory): Promise<void>;
7980
- }
7981
-
7982
- /**
7983
- * Task and Plan entities for TaskAgent
7984
- *
7985
- * Defines the data structures for task-based autonomous agents.
7986
- */
7987
- /**
7988
- * Task status lifecycle
7989
- */
7990
- type TaskStatus = 'pending' | 'blocked' | 'in_progress' | 'waiting_external' | 'completed' | 'failed' | 'skipped' | 'cancelled';
7991
- /**
7992
- * Terminal statuses - task will not progress further
7993
- */
7994
- declare const TERMINAL_TASK_STATUSES: TaskStatus[];
7995
- /**
7996
- * Check if a task status is terminal (task will not progress further)
7997
- */
7998
- declare function isTerminalStatus(status: TaskStatus): boolean;
7999
- /**
8000
- * Plan status
8001
- */
8002
- type PlanStatus = 'pending' | 'running' | 'suspended' | 'completed' | 'failed' | 'cancelled';
8003
- /**
8004
- * Condition operators for conditional task execution
8005
- */
8006
- type ConditionOperator = 'exists' | 'not_exists' | 'equals' | 'contains' | 'truthy' | 'greater_than' | 'less_than';
8007
- /**
8008
- * Task condition - evaluated before execution
8009
- */
8010
- interface TaskCondition {
8011
- memoryKey: string;
8012
- operator: ConditionOperator;
8013
- value?: unknown;
8014
- onFalse: 'skip' | 'fail' | 'wait';
8015
- }
8016
- /**
8017
- * External dependency configuration
8018
- */
8019
- interface ExternalDependency {
8020
- type: 'webhook' | 'poll' | 'manual' | 'scheduled';
8021
- /** For webhook: unique ID to match incoming webhook */
8022
- webhookId?: string;
8023
- /** For poll: how to check if complete */
8024
- pollConfig?: {
8025
- toolName: string;
8026
- toolArgs: Record<string, unknown>;
8027
- intervalMs: number;
8028
- maxAttempts: number;
8029
- };
8030
- /** For scheduled: when to resume */
8031
- scheduledAt?: number;
8032
- /** For manual: description of what's needed */
8033
- manualDescription?: string;
8034
- /** Timeout for all types */
8035
- timeoutMs?: number;
8036
- /** Current state */
8037
- state: 'waiting' | 'received' | 'timeout';
8038
- /** Data received from external source */
8039
- receivedData?: unknown;
8040
- receivedAt?: number;
8041
- }
8042
- /**
8043
- * Task execution settings
8044
- */
8045
- interface TaskExecution {
8046
- /** Can run in parallel with other parallel tasks */
8047
- parallel?: boolean;
8048
- /** Max concurrent if this spawns sub-work */
8049
- maxConcurrency?: number;
8050
- /** Priority (higher = executed first) */
8051
- priority?: number;
8052
- /**
8053
- * If true (default), re-check condition immediately before LLM call
8054
- * to protect against race conditions when parallel tasks modify memory.
8055
- * Set to false to skip re-check for performance if you know condition won't change.
8056
- */
8057
- raceProtection?: boolean;
8058
- }
8059
- /**
8060
- * Task completion validation settings
8061
- *
8062
- * Used to verify that a task actually achieved its goal before marking it complete.
8063
- * Supports multiple validation approaches:
8064
- * - Programmatic checks (memory keys, hooks)
8065
- * - LLM self-reflection with completeness scoring
8066
- * - Natural language criteria evaluation
8067
- */
8068
- interface TaskValidation {
8069
- /**
8070
- * Natural language completion criteria.
8071
- * These are evaluated by LLM self-reflection to determine if the task is complete.
8072
- * Examples:
8073
- * - "The response contains at least 3 specific examples"
8074
- * - "User's email has been validated and stored in memory"
8075
- * - "All requested data fields are present in the output"
8076
- *
8077
- * This is the RECOMMENDED approach for flexible, intelligent validation.
8078
- */
8079
- completionCriteria?: string[];
8080
- /**
8081
- * Minimum completeness score (0-100) to consider task successful.
8082
- * LLM self-reflection returns a score; if below this threshold:
8083
- * - If requireUserApproval is set, ask user
8084
- * - Otherwise, follow the mode setting (strict = fail, warn = continue)
8085
- * Default: 80
8086
- */
8087
- minCompletionScore?: number;
8088
- /**
8089
- * When to require user approval:
8090
- * - 'never': Never ask user, use automated decision (default)
8091
- * - 'uncertain': Ask user when score is between minCompletionScore and minCompletionScore + 15
8092
- * - 'always': Always ask user to confirm task completion
8093
- */
8094
- requireUserApproval?: 'never' | 'uncertain' | 'always';
8095
- /**
8096
- * Memory keys that must exist after task completion.
8097
- * If the task should store data in memory, list the required keys here.
8098
- * This is a hard requirement checked BEFORE LLM reflection.
8099
- */
8100
- requiredMemoryKeys?: string[];
8101
- /**
8102
- * Custom validation function name (registered via validateTask hook).
8103
- * The hook will be called with this identifier to dispatch to the right validator.
8104
- * Runs AFTER LLM reflection, can override the result.
8105
- */
8106
- customValidator?: string;
8107
- /**
8108
- * Validation mode:
8109
- * - 'strict': Validation failure marks task as failed (default)
8110
- * - 'warn': Validation failure logs warning but task still completes
8111
- */
8112
- mode?: 'strict' | 'warn';
8113
- /**
8114
- * Skip LLM self-reflection validation.
8115
- * Set to true if you only want programmatic validation (memory keys, hooks).
8116
- * Default: false (reflection is enabled when completionCriteria is set)
8117
- */
8118
- skipReflection?: boolean;
8119
- }
8120
- /**
8121
- * Result of task validation (returned by LLM reflection)
8122
- */
8123
- interface TaskValidationResult {
8124
- /** Whether the task is considered complete */
8125
- isComplete: boolean;
8126
- /** Completeness score from 0-100 */
8127
- completionScore: number;
8128
- /** LLM's explanation of why the task is/isn't complete */
8129
- explanation: string;
8130
- /** Per-criterion evaluation results */
8131
- criteriaResults?: Array<{
8132
- criterion: string;
8133
- met: boolean;
8134
- evidence?: string;
8135
- }>;
8136
- /** Whether user approval is needed */
8137
- requiresUserApproval: boolean;
8138
- /** Reason for requiring user approval */
8139
- approvalReason?: string;
8140
- }
8141
- /**
8142
- * A single unit of work
8143
- */
8144
- interface Task {
8145
- id: string;
8146
- name: string;
8147
- description: string;
8148
- status: TaskStatus;
8149
- /** Tasks that must complete before this one (task IDs) */
8150
- dependsOn: string[];
8151
- /** External dependency (if waiting on external event) */
8152
- externalDependency?: ExternalDependency;
8153
- /** Condition for execution */
8154
- condition?: TaskCondition;
8155
- /** Execution settings */
8156
- execution?: TaskExecution;
8157
- /** Completion validation settings */
8158
- validation?: TaskValidation;
8159
- /** Optional expected output description */
8160
- expectedOutput?: string;
8161
- /** Result after completion */
8162
- result?: {
8163
- success: boolean;
8164
- output?: unknown;
8165
- error?: string;
8166
- /** Validation score (0-100) if validation was performed */
8167
- validationScore?: number;
8168
- /** Explanation of validation result */
8169
- validationExplanation?: string;
8170
- };
8171
- /** Timestamps */
8172
- createdAt: number;
8173
- startedAt?: number;
8174
- completedAt?: number;
8175
- lastUpdatedAt: number;
8176
- /** Retry tracking */
8177
- attempts: number;
8178
- maxAttempts: number;
8179
- /** Metadata for extensions */
8180
- metadata?: Record<string, unknown>;
8181
- }
8182
- /**
8183
- * Input for creating a task
8184
- */
8185
- interface TaskInput {
8186
- id?: string;
8187
- name: string;
8188
- description: string;
8189
- dependsOn?: string[];
8190
- externalDependency?: ExternalDependency;
8191
- condition?: TaskCondition;
8192
- execution?: TaskExecution;
8193
- validation?: TaskValidation;
8194
- expectedOutput?: string;
8195
- maxAttempts?: number;
8196
- metadata?: Record<string, unknown>;
8197
- }
8198
- /**
8199
- * Plan concurrency settings
8200
- */
8201
- interface PlanConcurrency {
8202
- maxParallelTasks: number;
8203
- strategy: 'fifo' | 'priority' | 'shortest-first';
8533
+ *
8534
+ * @returns Serialized memory state
8535
+ */
8536
+ serialize(): Promise<SerializedMemory>;
8204
8537
  /**
8205
- * How to handle failures when executing tasks in parallel
8206
- * - 'fail-fast': Stop on first failure (Promise.all behavior) - DEFAULT
8207
- * - 'continue': Continue other tasks on failure, mark failed ones
8208
- * - 'fail-all': Wait for all to complete, then report all failures together
8538
+ * Restore memory entries from serialized state
8539
+ *
8540
+ * Clears existing memory and repopulates from the serialized state.
8541
+ * Timestamps are reset to current time.
8542
+ *
8543
+ * @param state - Previously serialized memory state
8209
8544
  */
8210
- failureMode?: 'fail-fast' | 'continue' | 'fail-all';
8211
- }
8212
- /**
8213
- * Execution plan - a goal with steps to achieve it
8214
- */
8215
- interface Plan {
8216
- id: string;
8217
- goal: string;
8218
- context?: string;
8219
- tasks: Task[];
8220
- /** Concurrency settings */
8221
- concurrency?: PlanConcurrency;
8222
- /** Can agent modify the plan? */
8223
- allowDynamicTasks: boolean;
8224
- /** Plan status */
8225
- status: PlanStatus;
8226
- /** Why is the plan suspended? */
8227
- suspendedReason?: {
8228
- type: 'waiting_external' | 'manual_pause' | 'error';
8229
- taskId?: string;
8230
- message?: string;
8231
- };
8232
- /** Timestamps */
8233
- createdAt: number;
8234
- startedAt?: number;
8235
- completedAt?: number;
8236
- lastUpdatedAt: number;
8237
- /** For resume: which task to continue from */
8238
- currentTaskId?: string;
8239
- /** Metadata */
8240
- metadata?: Record<string, unknown>;
8241
- }
8242
- /**
8243
- * Input for creating a plan
8244
- */
8245
- interface PlanInput {
8246
- goal: string;
8247
- context?: string;
8248
- tasks: TaskInput[];
8249
- concurrency?: PlanConcurrency;
8250
- allowDynamicTasks?: boolean;
8251
- metadata?: Record<string, unknown>;
8252
- /** Skip dependency cycle detection (default: false) */
8253
- skipCycleCheck?: boolean;
8254
- }
8255
- /**
8256
- * Memory access interface for condition evaluation
8257
- */
8258
- interface ConditionMemoryAccess {
8259
- get(key: string): Promise<unknown>;
8545
+ restore(state: SerializedMemory): Promise<void>;
8260
8546
  }
8261
- /**
8262
- * Create a task with defaults
8263
- */
8264
- declare function createTask(input: TaskInput): Task;
8265
- /**
8266
- * Create a plan with tasks
8267
- * @throws {DependencyCycleError} If circular dependencies detected (unless skipCycleCheck is true)
8268
- */
8269
- declare function createPlan(input: PlanInput): Plan;
8270
- /**
8271
- * Check if a task can be executed (dependencies met, status is pending)
8272
- */
8273
- declare function canTaskExecute(task: Task, allTasks: Task[]): boolean;
8274
- /**
8275
- * Get the next tasks that can be executed
8276
- */
8277
- declare function getNextExecutableTasks(plan: Plan): Task[];
8278
- /**
8279
- * Evaluate a task condition against memory
8280
- */
8281
- declare function evaluateCondition(condition: TaskCondition, memory: ConditionMemoryAccess): Promise<boolean>;
8282
- /**
8283
- * Update task status and timestamps
8284
- */
8285
- declare function updateTaskStatus(task: Task, status: TaskStatus): Task;
8286
- /**
8287
- * Check if a task is blocked by dependencies
8288
- */
8289
- declare function isTaskBlocked(task: Task, allTasks: Task[]): boolean;
8290
- /**
8291
- * Get the dependency tasks for a task
8292
- */
8293
- declare function getTaskDependencies(task: Task, allTasks: Task[]): Task[];
8294
- /**
8295
- * Resolve task name dependencies to task IDs
8296
- * Modifies taskInputs in place
8297
- */
8298
- declare function resolveDependencies(taskInputs: TaskInput[], tasks: Task[]): void;
8299
- /**
8300
- * Detect dependency cycles in tasks using depth-first search
8301
- * @param tasks Array of tasks with resolved dependencies (IDs, not names)
8302
- * @returns Array of task IDs forming the cycle (e.g., ['A', 'B', 'C', 'A']), or null if no cycle
8303
- */
8304
- declare function detectDependencyCycle(tasks: Task[]): string[] | null;
8305
8547
 
8306
8548
  /**
8307
8549
  * ExternalDependencyHandler - handles external dependencies
@@ -9881,6 +10123,70 @@ declare class FileUserInfoStorage implements IUserInfoStorage {
9881
10123
  private ensureDirectory;
9882
10124
  }
9883
10125
 
10126
+ /**
10127
+ * FileRoutineDefinitionStorage - File-based storage for routine definitions.
10128
+ *
10129
+ * Stores routines as JSON files on disk with per-user isolation.
10130
+ * Path: ~/.oneringai/users/<userId>/routines/<sanitized-id>.json
10131
+ *
10132
+ * Features:
10133
+ * - Per-user isolation (multi-tenant safe)
10134
+ * - Cross-platform path handling
10135
+ * - Safe ID sanitization
10136
+ * - Atomic file operations (write to .tmp then rename)
10137
+ * - Per-user index file for fast listing/filtering
10138
+ * - Index auto-rebuild if missing
10139
+ */
10140
+
10141
+ /**
10142
+ * Configuration for FileRoutineDefinitionStorage
10143
+ */
10144
+ interface FileRoutineDefinitionStorageConfig {
10145
+ /** Override the base directory (default: ~/.oneringai/users) */
10146
+ baseDirectory?: string;
10147
+ /** Pretty-print JSON (default: true) */
10148
+ prettyPrint?: boolean;
10149
+ }
10150
+ /**
10151
+ * File-based storage for routine definitions.
10152
+ *
10153
+ * Single instance handles all users. UserId is passed to each method.
10154
+ */
10155
+ declare class FileRoutineDefinitionStorage implements IRoutineDefinitionStorage {
10156
+ private readonly baseDirectory;
10157
+ private readonly prettyPrint;
10158
+ constructor(config?: FileRoutineDefinitionStorageConfig);
10159
+ private getUserDirectory;
10160
+ private getIndexPath;
10161
+ private getRoutinePath;
10162
+ save(userId: string | undefined, definition: RoutineDefinition): Promise<void>;
10163
+ load(userId: string | undefined, id: string): Promise<RoutineDefinition | null>;
10164
+ delete(userId: string | undefined, id: string): Promise<void>;
10165
+ exists(userId: string | undefined, id: string): Promise<boolean>;
10166
+ list(userId: string | undefined, options?: {
10167
+ tags?: string[];
10168
+ search?: string;
10169
+ limit?: number;
10170
+ offset?: number;
10171
+ }): Promise<RoutineDefinition[]>;
10172
+ getPath(userId: string | undefined): string;
10173
+ private ensureDirectory;
10174
+ private loadIndex;
10175
+ private saveIndex;
10176
+ private updateIndex;
10177
+ private removeFromIndex;
10178
+ private definitionToIndexEntry;
10179
+ /**
10180
+ * Rebuild index by scanning directory for .json files (excluding _index.json).
10181
+ * Returns empty index if directory doesn't exist.
10182
+ */
10183
+ private rebuildIndex;
10184
+ }
10185
+ /**
10186
+ * Create a FileRoutineDefinitionStorage with default configuration
10187
+ */
10188
+ declare function createFileRoutineDefinitionStorage(config?: FileRoutineDefinitionStorageConfig): FileRoutineDefinitionStorage;
10189
+
9884
10190
  /**
9885
10191
  * Video Model Registry
9886
10192
  *
@@ -13163,6 +13469,259 @@ interface CreatePRArgs {
13163
13469
  */
13164
13470
  declare function createCreatePRTool(connector: Connector, userId?: string): ToolFunction<CreatePRArgs, GitHubCreatePRResult>;
13165
13471
 
13472
+ /**
13473
+ * Microsoft Graph Tools - Shared Types and Helpers
13474
+ *
13475
+ * Foundation for all Microsoft Graph connector tools.
13476
+ * Provides authenticated fetch, delegated/app mode switching, and result types.
13477
+ */
13478
+
13479
+ /**
13480
+ * Get the user path prefix for Microsoft Graph API requests.
13481
+ *
13482
+ * - OAuth `authorization_code` flow (delegated): returns `/me` (ignores targetUser)
13483
+ * - OAuth `client_credentials` flow (application): returns `/users/${targetUser}` (requires targetUser)
13484
+ * - API key / other: returns `/me`
13485
+ */
13486
+ declare function getUserPathPrefix(connector: Connector, targetUser?: string): string;
13487
+ /**
13488
+ * Options for microsoftFetch
13489
+ */
13490
+ interface MicrosoftFetchOptions {
13491
+ method?: string;
13492
+ body?: unknown;
13493
+ userId?: string;
13494
+ queryParams?: Record<string, string | number | boolean>;
13495
+ accept?: string;
13496
+ }
13497
+ /**
13498
+ * Make an authenticated Microsoft Graph API request through the connector.
13499
+ *
13500
+ * Adds standard headers and parses JSON response.
13501
+ * Handles empty response bodies (e.g., sendMail returns 202 with no body).
13502
+ * Throws MicrosoftAPIError on non-ok responses.
13503
+ */
13504
+ declare function microsoftFetch<T = unknown>(connector: Connector, endpoint: string, options?: MicrosoftFetchOptions): Promise<T>;
13505
+ /**
13506
+ * Normalize an email array from any format the LLM might send into plain strings.
13507
+ *
13508
+ * Accepts:
13509
+ * - Plain strings: `["alice@contoso.com"]`
13510
+ * - Graph recipient objects: `[{ emailAddress: { address: "alice@contoso.com" } }]`
13511
+ * - Graph attendee objects: `[{ emailAddress: { address: "alice@contoso.com", name: "Alice" }, type: "required" }]`
13512
+ * - Bare email objects: `[{ address: "alice@contoso.com" }]` or `[{ email: "alice@contoso.com" }]`
13513
+ *
13514
+ * Always returns `string[]` of email addresses.
13515
+ */
13516
+ declare function normalizeEmails(input: unknown[]): string[];
13517
+ /**
13518
+ * Convert an array of email addresses (any format) to Microsoft Graph recipient format.
13519
+ * Normalizes input first, so it's safe to pass LLM output directly.
13520
+ */
13521
+ declare function formatRecipients(emails: unknown[]): {
13522
+ emailAddress: {
13523
+ address: string;
13524
+ };
13525
+ }[];
13526
+ /**
13527
+ * Convert an array of email addresses (any format) to Microsoft Graph attendee format.
13528
+ * Normalizes input first, so it's safe to pass LLM output directly.
13529
+ */
13530
+ declare function formatAttendees(emails: unknown[]): {
13531
+ emailAddress: {
13532
+ address: string;
13533
+ };
13534
+ type: string;
13535
+ }[];
13536
+ /**
13537
+ * Check if a meeting ID input is a Teams join URL.
13538
+ *
13539
+ * Teams join URLs look like:
13540
+ * - `https://teams.microsoft.com/l/meetup-join/19%3ameeting_...`
13541
+ * - `https://teams.live.com/l/meetup-join/...`
13542
+ *
13543
+ * IMPORTANT: A Teams join URL does NOT contain the Graph API meeting ID.
13544
+ * To resolve a URL to a meeting ID, use `resolveMeetingId()` which calls
13545
+ * `GET /me/onlineMeetings?$filter=JoinWebUrl eq '{url}'`.
13546
+ */
13547
+ declare function isTeamsMeetingUrl(input: string): boolean;
13548
+ /**
13549
+ * Resolve a meeting input (ID or Teams URL) to a Graph API online meeting ID.
13550
+ *
13551
+ * - Raw meeting IDs are passed through as-is
13552
+ * - Teams join URLs are resolved via `GET /me/onlineMeetings?$filter=JoinWebUrl eq '{url}'`
13553
+ *
13554
+ * @returns The resolved meeting ID and optional subject
13555
+ * @throws Error if the URL cannot be resolved or input is empty
13556
+ */
13557
+ declare function resolveMeetingId(connector: Connector, input: string, prefix: string, effectiveUserId?: string): Promise<{
13558
+ meetingId: string;
13559
+ subject?: string;
13560
+ }>;
13561
+ interface MicrosoftDraftEmailResult {
13562
+ success: boolean;
13563
+ draftId?: string;
13564
+ webLink?: string;
13565
+ error?: string;
13566
+ }
13567
+ interface MicrosoftSendEmailResult {
13568
+ success: boolean;
13569
+ error?: string;
13570
+ }
13571
+ interface MicrosoftCreateMeetingResult {
13572
+ success: boolean;
13573
+ eventId?: string;
13574
+ webLink?: string;
13575
+ onlineMeetingUrl?: string;
13576
+ error?: string;
13577
+ }
13578
+ interface MicrosoftEditMeetingResult {
13579
+ success: boolean;
13580
+ eventId?: string;
13581
+ webLink?: string;
13582
+ error?: string;
13583
+ }
13584
+ interface MicrosoftGetTranscriptResult {
13585
+ success: boolean;
13586
+ transcript?: string;
13587
+ meetingSubject?: string;
13588
+ error?: string;
13589
+ }
13590
+ interface MicrosoftFindSlotsResult {
13591
+ success: boolean;
13592
+ slots?: MeetingSlotSuggestion[];
13593
+ emptySuggestionsReason?: string;
13594
+ error?: string;
13595
+ }
13596
+ interface MeetingSlotSuggestion {
13597
+ start: string;
13598
+ end: string;
13599
+ confidence: string;
13600
+ attendeeAvailability: {
13601
+ attendee: string;
13602
+ availability: string;
13603
+ }[];
13604
+ }
13605
+
13606
+ /**
13607
+ * Microsoft Graph - Create Draft Email Tool
13608
+ *
13609
+ * Create a draft email or draft reply in the user's mailbox.
13610
+ */
13611
+
13612
+ interface CreateDraftEmailArgs {
13613
+ to: string[];
13614
+ subject: string;
13615
+ body: string;
13616
+ cc?: string[];
13617
+ replyToMessageId?: string;
13618
+ targetUser?: string;
13619
+ }
13620
+ /**
13621
+ * Create a Microsoft Graph create_draft_email tool
13622
+ */
13623
+ declare function createDraftEmailTool(connector: Connector, userId?: string): ToolFunction<CreateDraftEmailArgs, MicrosoftDraftEmailResult>;
13624
+
13625
+ /**
13626
+ * Microsoft Graph - Send Email Tool
13627
+ *
13628
+ * Send an email or reply to an existing message.
13629
+ */
13630
+
13631
+ interface SendEmailArgs {
13632
+ to: string[];
13633
+ subject: string;
13634
+ body: string;
13635
+ cc?: string[];
13636
+ replyToMessageId?: string;
13637
+ targetUser?: string;
13638
+ }
13639
+ /**
13640
+ * Create a Microsoft Graph send_email tool
13641
+ */
13642
+ declare function createSendEmailTool(connector: Connector, userId?: string): ToolFunction<SendEmailArgs, MicrosoftSendEmailResult>;
13643
+
13644
+ /**
13645
+ * Microsoft Graph - Create Meeting Tool
13646
+ *
13647
+ * Create a calendar event with optional Teams online meeting.
13648
+ */
13649
+
13650
+ interface CreateMeetingArgs {
13651
+ subject: string;
13652
+ startDateTime: string;
13653
+ endDateTime: string;
13654
+ attendees: string[];
13655
+ body?: string;
13656
+ isOnlineMeeting?: boolean;
13657
+ location?: string;
13658
+ timeZone?: string;
13659
+ targetUser?: string;
13660
+ }
13661
+ /**
13662
+ * Create a Microsoft Graph create_meeting tool
13663
+ */
13664
+ declare function createMeetingTool(connector: Connector, userId?: string): ToolFunction<CreateMeetingArgs, MicrosoftCreateMeetingResult>;
13665
+
13666
+ /**
13667
+ * Microsoft Graph - Edit Meeting Tool
13668
+ *
13669
+ * Update an existing calendar event.
13670
+ */
13671
+
13672
+ interface EditMeetingArgs {
13673
+ eventId: string;
13674
+ subject?: string;
13675
+ startDateTime?: string;
13676
+ endDateTime?: string;
13677
+ attendees?: string[];
13678
+ body?: string;
13679
+ isOnlineMeeting?: boolean;
13680
+ location?: string;
13681
+ timeZone?: string;
13682
+ targetUser?: string;
13683
+ }
13684
+ /**
13685
+ * Create a Microsoft Graph edit_meeting tool
13686
+ */
13687
+ declare function createEditMeetingTool(connector: Connector, userId?: string): ToolFunction<EditMeetingArgs, MicrosoftEditMeetingResult>;
13688
+
13689
+ /**
13690
+ * Microsoft Graph - Get Meeting Transcript Tool
13691
+ *
13692
+ * Retrieve the transcript from a Teams online meeting.
13693
+ * Requires OnlineMeetingTranscript.Read.All permission.
13694
+ */
13695
+
13696
+ interface GetMeetingTranscriptArgs {
13697
+ meetingId: string;
13698
+ targetUser?: string;
13699
+ }
13700
+ /**
13701
+ * Create a Microsoft Graph get_meeting_transcript tool
13702
+ */
13703
+ declare function createGetMeetingTranscriptTool(connector: Connector, userId?: string): ToolFunction<GetMeetingTranscriptArgs, MicrosoftGetTranscriptResult>;
13704
+
13705
+ /**
13706
+ * Microsoft Graph - Find Meeting Slots Tool
13707
+ *
13708
+ * Find available meeting time slots for a set of attendees.
13709
+ */
13710
+
13711
+ interface FindMeetingSlotsArgs {
13712
+ attendees: string[];
13713
+ startDateTime: string;
13714
+ endDateTime: string;
13715
+ duration: number;
13716
+ timeZone?: string;
13717
+ maxResults?: number;
13718
+ targetUser?: string;
13719
+ }
13720
+ /**
13721
+ * Create a Microsoft Graph find_meeting_slots tool
13722
+ */
13723
+ declare function createFindMeetingSlotsTool(connector: Connector, userId?: string): ToolFunction<FindMeetingSlotsArgs, MicrosoftFindSlotsResult>;
13724
+
13166
13725
  /**
13167
13726
  * Desktop Automation Tools - Types
13168
13727
  *
@@ -13541,7 +14100,7 @@ declare const desktopTools: (ToolFunction<DesktopScreenshotArgs, DesktopScreensh
13541
14100
  * AUTO-GENERATED FILE - DO NOT EDIT MANUALLY
13542
14101
  *
13543
14102
  * Generated by: scripts/generate-tool-registry.ts
13544
- * Generated at: 2026-02-19T13:15:35.008Z
14103
+ * Generated at: 2026-02-20T17:46:07.292Z
13545
14104
  *
13546
14105
  * To regenerate: npm run generate:tools
13547
14106
  */
@@ -13980,6 +14539,13 @@ type index_IDesktopDriver = IDesktopDriver;
13980
14539
  type index_IDocumentTransformer = IDocumentTransformer;
13981
14540
  type index_IFormatHandler = IFormatHandler;
13982
14541
  type index_ImageFilterOptions = ImageFilterOptions;
14542
+ type index_MeetingSlotSuggestion = MeetingSlotSuggestion;
14543
+ type index_MicrosoftCreateMeetingResult = MicrosoftCreateMeetingResult;
14544
+ type index_MicrosoftDraftEmailResult = MicrosoftDraftEmailResult;
14545
+ type index_MicrosoftEditMeetingResult = MicrosoftEditMeetingResult;
14546
+ type index_MicrosoftFindSlotsResult = MicrosoftFindSlotsResult;
14547
+ type index_MicrosoftGetTranscriptResult = MicrosoftGetTranscriptResult;
14548
+ type index_MicrosoftSendEmailResult = MicrosoftSendEmailResult;
13983
14549
  type index_MouseButton = MouseButton;
13984
14550
  type index_NutTreeDriver = NutTreeDriver;
13985
14551
  declare const index_NutTreeDriver: typeof NutTreeDriver;
@@ -14014,19 +14580,25 @@ declare const index_createDesktopMouseScrollTool: typeof createDesktopMouseScrol
14014
14580
  declare const index_createDesktopScreenshotTool: typeof createDesktopScreenshotTool;
14015
14581
  declare const index_createDesktopWindowFocusTool: typeof createDesktopWindowFocusTool;
14016
14582
  declare const index_createDesktopWindowListTool: typeof createDesktopWindowListTool;
14583
+ declare const index_createDraftEmailTool: typeof createDraftEmailTool;
14017
14584
  declare const index_createEditFileTool: typeof createEditFileTool;
14585
+ declare const index_createEditMeetingTool: typeof createEditMeetingTool;
14018
14586
  declare const index_createExecuteJavaScriptTool: typeof createExecuteJavaScriptTool;
14587
+ declare const index_createFindMeetingSlotsTool: typeof createFindMeetingSlotsTool;
14588
+ declare const index_createGetMeetingTranscriptTool: typeof createGetMeetingTranscriptTool;
14019
14589
  declare const index_createGetPRTool: typeof createGetPRTool;
14020
14590
  declare const index_createGitHubReadFileTool: typeof createGitHubReadFileTool;
14021
14591
  declare const index_createGlobTool: typeof createGlobTool;
14022
14592
  declare const index_createGrepTool: typeof createGrepTool;
14023
14593
  declare const index_createImageGenerationTool: typeof createImageGenerationTool;
14024
14594
  declare const index_createListDirectoryTool: typeof createListDirectoryTool;
14595
+ declare const index_createMeetingTool: typeof createMeetingTool;
14025
14596
  declare const index_createPRCommentsTool: typeof createPRCommentsTool;
14026
14597
  declare const index_createPRFilesTool: typeof createPRFilesTool;
14027
14598
  declare const index_createReadFileTool: typeof createReadFileTool;
14028
14599
  declare const index_createSearchCodeTool: typeof createSearchCodeTool;
14029
14600
  declare const index_createSearchFilesTool: typeof createSearchFilesTool;
14601
+ declare const index_createSendEmailTool: typeof createSendEmailTool;
14030
14602
  declare const index_createSpeechToTextTool: typeof createSpeechToTextTool;
14031
14603
  declare const index_createTextToSpeechTool: typeof createTextToSpeechTool;
14032
14604
  declare const index_createVideoTools: typeof createVideoTools;
@@ -14056,6 +14628,8 @@ declare const index_editFile: typeof editFile;
14056
14628
  declare const index_executeInVM: typeof executeInVM;
14057
14629
  declare const index_executeJavaScript: typeof executeJavaScript;
14058
14630
  declare const index_expandTilde: typeof expandTilde;
14631
+ declare const index_formatAttendees: typeof formatAttendees;
14632
+ declare const index_formatRecipients: typeof formatRecipients;
14059
14633
  declare const index_getAllBuiltInTools: typeof getAllBuiltInTools;
14060
14634
  declare const index_getBackgroundOutput: typeof getBackgroundOutput;
14061
14635
  declare const index_getDesktopDriver: typeof getDesktopDriver;
@@ -14066,19 +14640,24 @@ declare const index_getToolCategories: typeof getToolCategories;
14066
14640
  declare const index_getToolRegistry: typeof getToolRegistry;
14067
14641
  declare const index_getToolsByCategory: typeof getToolsByCategory;
14068
14642
  declare const index_getToolsRequiringConnector: typeof getToolsRequiringConnector;
14643
+ declare const index_getUserPathPrefix: typeof getUserPathPrefix;
14069
14644
  declare const index_glob: typeof glob;
14070
14645
  declare const index_grep: typeof grep;
14071
14646
  declare const index_hydrateCustomTool: typeof hydrateCustomTool;
14072
14647
  declare const index_isBlockedCommand: typeof isBlockedCommand;
14073
14648
  declare const index_isExcludedExtension: typeof isExcludedExtension;
14649
+ declare const index_isTeamsMeetingUrl: typeof isTeamsMeetingUrl;
14074
14650
  declare const index_jsonManipulator: typeof jsonManipulator;
14075
14651
  declare const index_killBackgroundProcess: typeof killBackgroundProcess;
14076
14652
  declare const index_listDirectory: typeof listDirectory;
14077
14653
  declare const index_mergeTextPieces: typeof mergeTextPieces;
14654
+ declare const index_microsoftFetch: typeof microsoftFetch;
14655
+ declare const index_normalizeEmails: typeof normalizeEmails;
14078
14656
  declare const index_parseKeyCombo: typeof parseKeyCombo;
14079
14657
  declare const index_parseRepository: typeof parseRepository;
14080
14658
  declare const index_readFile: typeof readFile;
14081
14659
  declare const index_resetDefaultDriver: typeof resetDefaultDriver;
14660
+ declare const index_resolveMeetingId: typeof resolveMeetingId;
14082
14661
  declare const index_resolveRepository: typeof resolveRepository;
14083
14662
  declare const index_setMediaOutputHandler: typeof setMediaOutputHandler;
14084
14663
  declare const index_setMediaStorage: typeof setMediaStorage;
@@ -14087,7 +14666,7 @@ declare const index_validatePath: typeof validatePath;
14087
14666
  declare const index_webFetch: typeof webFetch;
14088
14667
  declare const index_writeFile: typeof writeFile;
14089
14668
  declare namespace index {
14090
- 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_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_createEditFileTool as createEditFileTool, index_createExecuteJavaScriptTool as createExecuteJavaScriptTool, index_createGetPRTool as createGetPRTool, index_createGitHubReadFileTool as createGitHubReadFileTool, index_createGlobTool as createGlobTool, index_createGrepTool as createGrepTool, index_createImageGenerationTool as createImageGenerationTool, index_createListDirectoryTool as createListDirectoryTool, index_createPRCommentsTool as createPRCommentsTool, index_createPRFilesTool as createPRFilesTool, index_createReadFileTool as createReadFileTool, index_createSearchCodeTool as createSearchCodeTool, index_createSearchFilesTool as createSearchFilesTool, index_createSpeechToTextTool as createSpeechToTextTool, index_createTextToSpeechTool as createTextToSpeechTool, index_createVideoTools as createVideoTools, index_createWebScrapeTool as createWebScrapeTool, index_createWebSearchTool as createWebSearchTool, index_createWriteFileTool as createWriteFileTool, index_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_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_glob as glob, index_grep as grep, index_hydrateCustomTool as hydrateCustomTool, index_isBlockedCommand as isBlockedCommand, index_isExcludedExtension as isExcludedExtension, index_jsonManipulator as jsonManipulator, index_killBackgroundProcess as killBackgroundProcess, index_listDirectory as listDirectory, index_mergeTextPieces as mergeTextPieces, index_parseKeyCombo as parseKeyCombo, index_parseRepository as parseRepository, index_readFile as readFile, index_resetDefaultDriver as resetDefaultDriver, 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 };
14669
+ 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 };
14091
14670
  }
14092
14671
 
14093
14672
  /**
@@ -14142,4 +14721,4 @@ declare class ProviderConfigAgent {
14142
14721
  reset(): void;
14143
14722
  }
14144
14723
 
14145
- 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, 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, 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, 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 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, IProvider, type IResearchSource, type ISTTModelDescription, type IScrapeProvider, type ISearchProvider, type ISpeechToTextProvider, type ITTSModelDescription, ITextProvider, type ITextToSpeechProvider, type ITokenEstimator$1 as ITokenEstimator, ITokenStorage, type IToolExecutionPipeline, type IToolExecutionPlugin, type IToolExecutor, type IUserInfoStorage, type IVideoModelDescription, type IVideoProvider, 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, MemoryConnectorStorage, MemoryEntry, MemoryEvictionCompactor, MemoryIndex, MemoryPriority, MemoryScope, MemoryStorage, MessageBuilder, MessageRole, type MetricTags, type MetricsCollector, type MetricsCollectorType, 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, 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, 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, createEditFileTool, createEstimator, createExecuteJavaScriptTool, createFileAgentDefinitionStorage, createFileContextStorage, createFileCustomToolStorage, createFileMediaStorage, createGetPRTool, createGitHubReadFileTool, createGlobTool, createGrepTool, createImageGenerationTool, createImageProvider, createListDirectoryTool, createMessageWithImages, createMetricsCollector, createPRCommentsTool, createPRFilesTool, createPlan, createProvider, createReadFileTool, createSearchCodeTool, createSearchFilesTool, 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, extractJSON, extractJSONField, extractNumber, findConnectorByServiceTypes, generateEncryptionKey, generateSimplePlan, generateWebAPITool, getActiveSTTModels, getActiveTTSModels, getActiveVideoModels, getAllBuiltInTools, getAllVendorLogos, getAllVendorTemplates, getBackgroundOutput, getConnectorTools, getCredentialsSetupURL, getDesktopDriver, getDocsURL, getMediaOutputHandler, getMediaStorage, getNextExecutableTasks, getRegisteredScrapeProviders, getSTTModelInfo, getSTTModelsByVendor, getSTTModelsWithFeature, getTTSModelInfo, getTTSModelsByVendor, getTTSModelsWithFeature, getTaskDependencies, getToolByName, getToolCategories, getToolRegistry, getToolsByCategory, getToolsRequiringConnector, getVendorAuthTemplate, getVendorColor, getVendorDefaultBaseURL, getVendorInfo, getVendorLogo, getVendorLogoCdnUrl, getVendorLogoSvg, getVendorTemplate, getVideoModelInfo, getVideoModelsByVendor, getVideoModelsWithAudio, getVideoModelsWithFeature, glob, globalErrorHandler, grep, hasClipboardImage, hasVendorLogo, hydrateCustomTool, isBlockedCommand, isExcludedExtension, isTaskBlocked, isTerminalStatus, killBackgroundProcess, listConnectorsByServiceTypes, listDirectory, listVendorIds, listVendors, listVendorsByAuthType, listVendorsByCategory, listVendorsWithLogos, logger, mergeTextPieces, metrics, parseKeyCombo, parseRepository, readClipboardImage, readDocumentAsContent, readFile, registerScrapeProvider, resetDefaultDriver, resolveConnector, resolveDependencies, resolveMaxContextTokens, resolveModelCapabilities, resolveRepository, retryWithBackoff, sanitizeToolName, setMediaOutputHandler, setMediaStorage, setMetricsCollector, simpleTokenEstimator, toConnectorOptions, toolRegistry, index as tools, updateTaskStatus, validatePath, writeFile };
14724
+ 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 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, 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 IUserInfoStorage, type IVideoModelDescription, type IVideoProvider, 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, 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 };