@everworker/oneringai 0.4.8 → 0.5.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/README.md +423 -43
- package/dist/{ImageModel-1uP-2vk7.d.ts → ImageModel-CV8OuP3Z.d.ts} +10 -4
- package/dist/{ImageModel-BDI37OED.d.cts → ImageModel-OjV5NvLY.d.cts} +10 -4
- package/dist/capabilities/agents/index.cjs +9 -0
- package/dist/capabilities/agents/index.cjs.map +1 -1
- package/dist/capabilities/agents/index.d.cts +1 -1
- package/dist/capabilities/agents/index.d.ts +1 -1
- package/dist/capabilities/agents/index.js +9 -0
- package/dist/capabilities/agents/index.js.map +1 -1
- package/dist/capabilities/images/index.cjs +262 -15
- package/dist/capabilities/images/index.cjs.map +1 -1
- package/dist/capabilities/images/index.d.cts +1 -1
- package/dist/capabilities/images/index.d.ts +1 -1
- package/dist/capabilities/images/index.js +262 -15
- package/dist/capabilities/images/index.js.map +1 -1
- package/dist/index-BlEwczd4.d.ts +320 -0
- package/dist/index-DrJYI_0l.d.cts +320 -0
- package/dist/{index-13HQuxEB.d.ts → index-hmTj59TM.d.ts} +352 -29
- package/dist/{index-Cbd5vY_8.d.cts → index-t4cRhBZW.d.cts} +352 -29
- package/dist/index.cjs +15543 -4232
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +3043 -586
- package/dist/index.d.ts +3043 -586
- package/dist/index.js +14567 -3281
- package/dist/index.js.map +1 -1
- package/dist/shared/index.cjs +596 -7
- package/dist/shared/index.cjs.map +1 -1
- package/dist/shared/index.d.cts +2 -284
- package/dist/shared/index.d.ts +2 -284
- package/dist/shared/index.js +596 -7
- package/dist/shared/index.js.map +1 -1
- package/package.json +1 -1
|
@@ -515,6 +515,10 @@ interface ToolContext {
|
|
|
515
515
|
identities?: AuthIdentity[];
|
|
516
516
|
/** Connector registry scoped to this agent's allowed connectors and userId */
|
|
517
517
|
connectorRegistry?: IConnectorRegistry;
|
|
518
|
+
/** User roles for permission policy evaluation */
|
|
519
|
+
roles?: string[];
|
|
520
|
+
/** Session ID for approval cache scoping */
|
|
521
|
+
sessionId?: string;
|
|
518
522
|
/** Working memory access (if agent has memory feature enabled) */
|
|
519
523
|
memory?: WorkingMemoryAccess;
|
|
520
524
|
/** Abort signal for cancellation */
|
|
@@ -585,6 +589,47 @@ interface ToolExecutionContext {
|
|
|
585
589
|
pendingNonBlocking: Set<string>;
|
|
586
590
|
completedResults: Map<string, ToolResult>;
|
|
587
591
|
}
|
|
592
|
+
/**
|
|
593
|
+
* Configuration for async (non-blocking) tool behavior
|
|
594
|
+
*/
|
|
595
|
+
interface AsyncToolConfig {
|
|
596
|
+
/**
|
|
597
|
+
* If true, the agent automatically re-enters the agentic loop
|
|
598
|
+
* when async tool results arrive. If false, results are queued
|
|
599
|
+
* and the caller must call `continueWithAsyncResults()` manually.
|
|
600
|
+
* @default true
|
|
601
|
+
*/
|
|
602
|
+
autoContinue?: boolean;
|
|
603
|
+
/**
|
|
604
|
+
* Window in ms to batch multiple async results before triggering
|
|
605
|
+
* a continuation. If multiple async tools complete within this window,
|
|
606
|
+
* their results are delivered together in a single user message.
|
|
607
|
+
* @default 500
|
|
608
|
+
*/
|
|
609
|
+
batchWindowMs?: number;
|
|
610
|
+
/**
|
|
611
|
+
* Timeout in ms for async tool execution. If a tool doesn't complete
|
|
612
|
+
* within this window, it's treated as a timeout error.
|
|
613
|
+
* @default 300000 (5 minutes)
|
|
614
|
+
*/
|
|
615
|
+
asyncTimeout?: number;
|
|
616
|
+
}
|
|
617
|
+
/**
|
|
618
|
+
* Status of a pending async tool execution
|
|
619
|
+
*/
|
|
620
|
+
type PendingAsyncToolStatus = 'running' | 'completed' | 'failed' | 'timeout' | 'cancelled';
|
|
621
|
+
/**
|
|
622
|
+
* Tracks a single async tool execution in flight
|
|
623
|
+
*/
|
|
624
|
+
interface PendingAsyncTool {
|
|
625
|
+
toolCallId: string;
|
|
626
|
+
toolName: string;
|
|
627
|
+
args: Record<string, unknown>;
|
|
628
|
+
startTime: number;
|
|
629
|
+
status: PendingAsyncToolStatus;
|
|
630
|
+
result?: ToolResult;
|
|
631
|
+
error?: Error;
|
|
632
|
+
}
|
|
588
633
|
/**
|
|
589
634
|
* Output handling hints for context management
|
|
590
635
|
*/
|
|
@@ -1555,6 +1600,140 @@ interface IContextPluginNextGen {
|
|
|
1555
1600
|
*/
|
|
1556
1601
|
restoreState(state: unknown): void;
|
|
1557
1602
|
}
|
|
1603
|
+
/**
|
|
1604
|
+
* Describes a store's schema for dynamic tool description generation.
|
|
1605
|
+
* The `descriptionFactory` on each store tool uses this to build
|
|
1606
|
+
* a comparison table so the LLM knows which store to use.
|
|
1607
|
+
*/
|
|
1608
|
+
interface StoreEntrySchema {
|
|
1609
|
+
/** Short identifier used as the `store` parameter value (e.g., "memory", "context") */
|
|
1610
|
+
storeId: string;
|
|
1611
|
+
/** Human-readable store name (e.g., "Working Memory", "Live Context") */
|
|
1612
|
+
displayName: string;
|
|
1613
|
+
/** One-line description of what this store holds */
|
|
1614
|
+
description: string;
|
|
1615
|
+
/**
|
|
1616
|
+
* "Use for:" guidance — tells the LLM when to pick this store.
|
|
1617
|
+
* Should include explicit "NOT for:" guidance referencing other stores.
|
|
1618
|
+
*/
|
|
1619
|
+
usageHint: string;
|
|
1620
|
+
/**
|
|
1621
|
+
* Human-readable description of the data fields accepted by storeSet.
|
|
1622
|
+
* Shown in the store_set tool description. One line per field.
|
|
1623
|
+
* Example: "description (required): Brief description of the data"
|
|
1624
|
+
*/
|
|
1625
|
+
setDataFields: string;
|
|
1626
|
+
/**
|
|
1627
|
+
* Available actions for store_action, keyed by action name.
|
|
1628
|
+
* If undefined or empty, this store has no actions.
|
|
1629
|
+
*/
|
|
1630
|
+
actions?: Record<string, {
|
|
1631
|
+
/** What this action does */
|
|
1632
|
+
description: string;
|
|
1633
|
+
/** Human-readable params description */
|
|
1634
|
+
paramsDescription?: string;
|
|
1635
|
+
/** If true, requires confirm: true parameter */
|
|
1636
|
+
destructive?: boolean;
|
|
1637
|
+
}>;
|
|
1638
|
+
}
|
|
1639
|
+
/**
|
|
1640
|
+
* Result types for store operations.
|
|
1641
|
+
* These are intentionally loose (Record-based) to accommodate
|
|
1642
|
+
* store-specific fields in responses.
|
|
1643
|
+
*/
|
|
1644
|
+
interface StoreGetResult {
|
|
1645
|
+
found: boolean;
|
|
1646
|
+
key?: string;
|
|
1647
|
+
/** Single entry data (when key provided) */
|
|
1648
|
+
entry?: Record<string, unknown>;
|
|
1649
|
+
/** All entries (when no key provided) */
|
|
1650
|
+
entries?: Array<Record<string, unknown>>;
|
|
1651
|
+
}
|
|
1652
|
+
interface StoreSetResult {
|
|
1653
|
+
success: boolean;
|
|
1654
|
+
key: string;
|
|
1655
|
+
message?: string;
|
|
1656
|
+
[k: string]: unknown;
|
|
1657
|
+
}
|
|
1658
|
+
interface StoreDeleteResult {
|
|
1659
|
+
deleted: boolean;
|
|
1660
|
+
key: string;
|
|
1661
|
+
}
|
|
1662
|
+
interface StoreListResult {
|
|
1663
|
+
entries: Array<Record<string, unknown>>;
|
|
1664
|
+
total?: number;
|
|
1665
|
+
}
|
|
1666
|
+
interface StoreActionResult {
|
|
1667
|
+
success: boolean;
|
|
1668
|
+
action: string;
|
|
1669
|
+
[k: string]: unknown;
|
|
1670
|
+
}
|
|
1671
|
+
/**
|
|
1672
|
+
* Interface for plugins that provide CRUD storage.
|
|
1673
|
+
*
|
|
1674
|
+
* When a plugin implements both `IContextPluginNextGen` and `IStoreHandler`,
|
|
1675
|
+
* it automatically gets the 5 generic `store_*` tools — no tool creation needed.
|
|
1676
|
+
*
|
|
1677
|
+
* ## How to implement a custom CRUD plugin
|
|
1678
|
+
*
|
|
1679
|
+
* 1. Create a class that extends `BasePluginNextGen` and implements `IStoreHandler`
|
|
1680
|
+
* 2. Implement `getStoreSchema()` — describes your store for tool descriptions
|
|
1681
|
+
* 3. Implement the 5 handler methods (storeGet, storeSet, storeDelete, storeList)
|
|
1682
|
+
* 4. Optionally implement `storeAction()` for non-CRUD operations
|
|
1683
|
+
* 5. Write `getInstructions()` — explains when to use YOUR store vs others
|
|
1684
|
+
* 6. Register with `ctx.registerPlugin(yourPlugin)` — store tools auto-include it
|
|
1685
|
+
*
|
|
1686
|
+
* Your plugin does NOT need to define any tools via `getTools()`.
|
|
1687
|
+
* The `StoreToolsManager` creates the 5 `store_*` tools once and routes
|
|
1688
|
+
* calls to the correct handler based on the `store` parameter.
|
|
1689
|
+
*
|
|
1690
|
+
* @example
|
|
1691
|
+
* ```typescript
|
|
1692
|
+
* class NotesPlugin extends BasePluginNextGen implements IStoreHandler {
|
|
1693
|
+
* readonly name = 'notes';
|
|
1694
|
+
* private notes = new Map<string, { text: string; tag?: string }>();
|
|
1695
|
+
*
|
|
1696
|
+
* getStoreSchema(): StoreEntrySchema {
|
|
1697
|
+
* return {
|
|
1698
|
+
* storeId: 'notes',
|
|
1699
|
+
* displayName: 'Notes',
|
|
1700
|
+
* description: 'Simple text notes with optional tags',
|
|
1701
|
+
* usageHint: 'Use for: quick notes. NOT for structured data (use "memory").',
|
|
1702
|
+
* setDataFields: 'text (required): Note content\ntag?: Optional category tag',
|
|
1703
|
+
* };
|
|
1704
|
+
* }
|
|
1705
|
+
*
|
|
1706
|
+
* async storeGet(key?: string) { ... }
|
|
1707
|
+
* async storeSet(key: string, data: Record<string, unknown>) { ... }
|
|
1708
|
+
* async storeDelete(key: string) { ... }
|
|
1709
|
+
* async storeList(filter?: Record<string, unknown>) { ... }
|
|
1710
|
+
*
|
|
1711
|
+
* getInstructions() {
|
|
1712
|
+
* return 'Store name: "notes". Use store_set("notes", key, { text, tag? }).';
|
|
1713
|
+
* }
|
|
1714
|
+
* async getContent() { ... }
|
|
1715
|
+
* getContents() { return Object.fromEntries(this.notes); }
|
|
1716
|
+
* }
|
|
1717
|
+
* ```
|
|
1718
|
+
*/
|
|
1719
|
+
interface IStoreHandler {
|
|
1720
|
+
/** Return the store's schema for dynamic tool descriptions */
|
|
1721
|
+
getStoreSchema(): StoreEntrySchema;
|
|
1722
|
+
/** Get one entry by key, or all entries if key is undefined */
|
|
1723
|
+
storeGet(key?: string, context?: ToolContext): Promise<StoreGetResult>;
|
|
1724
|
+
/** Create or update an entry */
|
|
1725
|
+
storeSet(key: string, data: Record<string, unknown>, context?: ToolContext): Promise<StoreSetResult>;
|
|
1726
|
+
/** Delete an entry by key */
|
|
1727
|
+
storeDelete(key: string, context?: ToolContext): Promise<StoreDeleteResult>;
|
|
1728
|
+
/** List entries with optional filter */
|
|
1729
|
+
storeList(filter?: Record<string, unknown>, context?: ToolContext): Promise<StoreListResult>;
|
|
1730
|
+
/** Execute a store-specific action (optional — only needed if store has actions) */
|
|
1731
|
+
storeAction?(action: string, params?: Record<string, unknown>, context?: ToolContext): Promise<StoreActionResult>;
|
|
1732
|
+
}
|
|
1733
|
+
/**
|
|
1734
|
+
* Type guard to check if a plugin implements IStoreHandler.
|
|
1735
|
+
*/
|
|
1736
|
+
declare function isStoreHandler(plugin: IContextPluginNextGen): plugin is IContextPluginNextGen & IStoreHandler;
|
|
1558
1737
|
/**
|
|
1559
1738
|
* Token budget breakdown - clear and simple
|
|
1560
1739
|
*/
|
|
@@ -1621,7 +1800,11 @@ interface OversizedInputResult {
|
|
|
1621
1800
|
/**
|
|
1622
1801
|
* Feature flags for enabling/disabling plugins
|
|
1623
1802
|
*/
|
|
1624
|
-
|
|
1803
|
+
/**
|
|
1804
|
+
* Known feature flags for built-in plugins (provides autocomplete/docs).
|
|
1805
|
+
* External plugins register via PluginRegistry and use arbitrary string keys.
|
|
1806
|
+
*/
|
|
1807
|
+
interface KnownContextFeatures {
|
|
1625
1808
|
/** Enable WorkingMemory plugin (default: true) */
|
|
1626
1809
|
workingMemory?: boolean;
|
|
1627
1810
|
/** Enable InContextMemory plugin (default: false) */
|
|
@@ -1632,44 +1815,56 @@ interface ContextFeatures {
|
|
|
1632
1815
|
userInfo?: boolean;
|
|
1633
1816
|
/** Enable ToolCatalog plugin for dynamic tool loading/unloading (default: false) */
|
|
1634
1817
|
toolCatalog?: boolean;
|
|
1818
|
+
/** Enable SharedWorkspace plugin for multi-agent coordination (default: false) */
|
|
1819
|
+
sharedWorkspace?: boolean;
|
|
1635
1820
|
}
|
|
1636
1821
|
/**
|
|
1637
|
-
*
|
|
1822
|
+
* Feature flags for enabling/disabling plugins.
|
|
1823
|
+
* Known keys provide autocomplete; arbitrary string keys are also accepted
|
|
1824
|
+
* for externally registered plugins (via PluginRegistry).
|
|
1825
|
+
*/
|
|
1826
|
+
type ContextFeatures = KnownContextFeatures & {
|
|
1827
|
+
[key: string]: boolean | undefined;
|
|
1828
|
+
};
|
|
1829
|
+
/**
|
|
1830
|
+
* Resolved features — all known keys guaranteed present, plus any extras.
|
|
1831
|
+
* Used internally after merging with DEFAULT_FEATURES.
|
|
1638
1832
|
*/
|
|
1639
|
-
|
|
1833
|
+
type ResolvedContextFeatures = Required<KnownContextFeatures> & Record<string, boolean>;
|
|
1834
|
+
/**
|
|
1835
|
+
* Default feature configuration for built-in plugins.
|
|
1836
|
+
*/
|
|
1837
|
+
declare const DEFAULT_FEATURES: Required<KnownContextFeatures>;
|
|
1640
1838
|
/**
|
|
1641
1839
|
* Plugin configurations for auto-initialization.
|
|
1642
1840
|
* When features are enabled, plugins are created with these configs.
|
|
1643
1841
|
* The config shapes match each plugin's constructor parameter.
|
|
1644
1842
|
*/
|
|
1645
|
-
|
|
1646
|
-
|
|
1647
|
-
|
|
1648
|
-
|
|
1649
|
-
|
|
1843
|
+
/**
|
|
1844
|
+
* Known plugin configurations for built-in plugins (provides autocomplete/docs).
|
|
1845
|
+
*/
|
|
1846
|
+
interface KnownPluginConfigs {
|
|
1847
|
+
/** Working memory plugin config. See WorkingMemoryPluginConfig. */
|
|
1650
1848
|
workingMemory?: Record<string, unknown>;
|
|
1651
|
-
/**
|
|
1652
|
-
* In-context memory plugin config (used when features.inContextMemory=true).
|
|
1653
|
-
* See InContextMemoryConfig for full options.
|
|
1654
|
-
*/
|
|
1849
|
+
/** In-context memory plugin config. See InContextMemoryConfig. */
|
|
1655
1850
|
inContextMemory?: Record<string, unknown>;
|
|
1656
|
-
/**
|
|
1657
|
-
* Persistent instructions plugin config (used when features.persistentInstructions=true).
|
|
1658
|
-
* Note: agentId is auto-filled from context config if not provided.
|
|
1659
|
-
* See PersistentInstructionsConfig for full options.
|
|
1660
|
-
*/
|
|
1851
|
+
/** Persistent instructions plugin config. See PersistentInstructionsConfig. Note: agentId auto-filled. */
|
|
1661
1852
|
persistentInstructions?: Record<string, unknown>;
|
|
1662
|
-
/**
|
|
1663
|
-
* User info plugin config (used when features.userInfo=true).
|
|
1664
|
-
* See UserInfoPluginConfig for full options.
|
|
1665
|
-
*/
|
|
1853
|
+
/** User info plugin config. See UserInfoPluginConfig. */
|
|
1666
1854
|
userInfo?: Record<string, unknown>;
|
|
1667
|
-
/**
|
|
1668
|
-
* Tool catalog plugin config (used when features.toolCatalog=true).
|
|
1669
|
-
* See ToolCatalogPluginConfig for full options.
|
|
1670
|
-
*/
|
|
1855
|
+
/** Tool catalog plugin config. See ToolCatalogPluginConfig. */
|
|
1671
1856
|
toolCatalog?: Record<string, unknown>;
|
|
1857
|
+
/** Shared workspace plugin config. See SharedWorkspaceConfig. */
|
|
1858
|
+
sharedWorkspace?: Record<string, unknown>;
|
|
1672
1859
|
}
|
|
1860
|
+
/**
|
|
1861
|
+
* Plugin configurations for auto-initialization.
|
|
1862
|
+
* Known keys provide autocomplete; arbitrary string keys accepted
|
|
1863
|
+
* for externally registered plugins (via PluginRegistry).
|
|
1864
|
+
*/
|
|
1865
|
+
type PluginConfigs = KnownPluginConfigs & {
|
|
1866
|
+
[key: string]: Record<string, unknown> | undefined;
|
|
1867
|
+
};
|
|
1673
1868
|
/**
|
|
1674
1869
|
* AgentContextNextGen configuration
|
|
1675
1870
|
*/
|
|
@@ -1832,6 +2027,12 @@ interface CompactionContext {
|
|
|
1832
2027
|
readonly plugins: ReadonlyArray<IContextPluginNextGen>;
|
|
1833
2028
|
/** Strategy name for logging */
|
|
1834
2029
|
readonly strategyName: string;
|
|
2030
|
+
/**
|
|
2031
|
+
* Describe a tool call using the tool's describeCall function.
|
|
2032
|
+
* Returns a human-readable summary of the tool call args (e.g., "src/core/Agent.ts [lines 100-200]").
|
|
2033
|
+
* Returns undefined if the tool is not found or has no describeCall.
|
|
2034
|
+
*/
|
|
2035
|
+
describeToolCall?(toolName: string, toolArgs: unknown): string | undefined;
|
|
1835
2036
|
/**
|
|
1836
2037
|
* Remove messages by indices.
|
|
1837
2038
|
* Handles tool pair preservation internally.
|
|
@@ -1913,8 +2114,50 @@ interface ICompactionStrategy {
|
|
|
1913
2114
|
}
|
|
1914
2115
|
|
|
1915
2116
|
/**
|
|
1916
|
-
*
|
|
2117
|
+
* Interface for objects that manage resources and need explicit cleanup.
|
|
2118
|
+
*
|
|
2119
|
+
* Implementing classes should release all resources (event listeners, timers,
|
|
2120
|
+
* connections, etc.) when destroy() is called. After destruction, the instance
|
|
2121
|
+
* should not be used.
|
|
2122
|
+
*/
|
|
2123
|
+
interface IDisposable {
|
|
2124
|
+
/**
|
|
2125
|
+
* Releases all resources held by this instance.
|
|
2126
|
+
*
|
|
2127
|
+
* After calling destroy():
|
|
2128
|
+
* - All event listeners should be removed
|
|
2129
|
+
* - All timers/intervals should be cleared
|
|
2130
|
+
* - All internal state should be cleaned up
|
|
2131
|
+
* - The instance should not be reused
|
|
2132
|
+
*
|
|
2133
|
+
* Multiple calls to destroy() should be safe (idempotent).
|
|
2134
|
+
*/
|
|
2135
|
+
destroy(): void;
|
|
2136
|
+
/**
|
|
2137
|
+
* Returns true if destroy() has been called.
|
|
2138
|
+
* Methods should check this before performing operations.
|
|
2139
|
+
*/
|
|
2140
|
+
readonly isDestroyed: boolean;
|
|
2141
|
+
}
|
|
2142
|
+
/**
|
|
2143
|
+
* Async version of IDisposable for resources requiring async cleanup.
|
|
2144
|
+
*/
|
|
2145
|
+
interface IAsyncDisposable {
|
|
2146
|
+
/**
|
|
2147
|
+
* Asynchronously releases all resources held by this instance.
|
|
2148
|
+
*/
|
|
2149
|
+
destroy(): Promise<void>;
|
|
2150
|
+
/**
|
|
2151
|
+
* Returns true if destroy() has been called.
|
|
2152
|
+
*/
|
|
2153
|
+
readonly isDestroyed: boolean;
|
|
2154
|
+
}
|
|
2155
|
+
/**
|
|
2156
|
+
* Helper to check if an object is destroyed and throw if so.
|
|
2157
|
+
* @param obj - The disposable object to check
|
|
2158
|
+
* @param operation - Name of the operation being attempted
|
|
1917
2159
|
*/
|
|
2160
|
+
declare function assertNotDestroyed(obj: IDisposable | IAsyncDisposable, operation: string): void;
|
|
1918
2161
|
|
|
1919
2162
|
/**
|
|
1920
2163
|
* Token usage statistics
|
|
@@ -1931,7 +2174,17 @@ interface LLMResponse {
|
|
|
1931
2174
|
id: string;
|
|
1932
2175
|
object: 'response';
|
|
1933
2176
|
created_at: number;
|
|
1934
|
-
|
|
2177
|
+
/**
|
|
2178
|
+
* Response status:
|
|
2179
|
+
* - `completed` — Generation finished successfully
|
|
2180
|
+
* - `failed` — Generation failed with an error
|
|
2181
|
+
* - `incomplete` — Generation stopped early (e.g. max tokens reached)
|
|
2182
|
+
* - `cancelled` — Generation was cancelled by the caller
|
|
2183
|
+
* - `in_progress` — Async/streaming generation still running (used by StreamState, video generation)
|
|
2184
|
+
* - `queued` — Queued for processing (used by async video generation via Sora)
|
|
2185
|
+
* - `suspended` — Agent loop suspended waiting for external input (via SuspendSignal)
|
|
2186
|
+
*/
|
|
2187
|
+
status: 'completed' | 'failed' | 'in_progress' | 'cancelled' | 'queued' | 'incomplete' | 'suspended';
|
|
1935
2188
|
model: string;
|
|
1936
2189
|
output: OutputItem[];
|
|
1937
2190
|
output_text?: string;
|
|
@@ -1942,6 +2195,28 @@ interface LLMResponse {
|
|
|
1942
2195
|
message: string;
|
|
1943
2196
|
};
|
|
1944
2197
|
metadata?: Record<string, string>;
|
|
2198
|
+
/** Non-empty when async tools are still executing in the background */
|
|
2199
|
+
pendingAsyncTools?: Array<{
|
|
2200
|
+
toolCallId: string;
|
|
2201
|
+
toolName: string;
|
|
2202
|
+
startTime: number;
|
|
2203
|
+
status: PendingAsyncToolStatus;
|
|
2204
|
+
}>;
|
|
2205
|
+
/** Present when status is 'suspended' — contains info needed to resume the session */
|
|
2206
|
+
suspension?: {
|
|
2207
|
+
/** Correlation ID for routing external events back to this session */
|
|
2208
|
+
correlationId: string;
|
|
2209
|
+
/** Session ID where the agent state is persisted */
|
|
2210
|
+
sessionId: string;
|
|
2211
|
+
/** Agent ID for reconstructing the agent via Agent.hydrate() */
|
|
2212
|
+
agentId: string;
|
|
2213
|
+
/** How the external response should be injected on resume */
|
|
2214
|
+
resumeAs: 'user_message' | 'tool_result';
|
|
2215
|
+
/** ISO timestamp when this suspension expires */
|
|
2216
|
+
expiresAt: string;
|
|
2217
|
+
/** Application-specific metadata from the SuspendSignal */
|
|
2218
|
+
metadata?: Record<string, unknown>;
|
|
2219
|
+
};
|
|
1945
2220
|
}
|
|
1946
2221
|
type AgentResponse = LLMResponse;
|
|
1947
2222
|
|
|
@@ -2546,6 +2821,44 @@ interface CircuitClosedEvent {
|
|
|
2546
2821
|
successCount: number;
|
|
2547
2822
|
timestamp: Date;
|
|
2548
2823
|
}
|
|
2824
|
+
interface AsyncToolStartedEvent {
|
|
2825
|
+
executionId: string;
|
|
2826
|
+
toolCallId: string;
|
|
2827
|
+
toolName: string;
|
|
2828
|
+
args: Record<string, unknown>;
|
|
2829
|
+
timestamp: Date;
|
|
2830
|
+
}
|
|
2831
|
+
interface AsyncToolCompleteEvent {
|
|
2832
|
+
executionId: string;
|
|
2833
|
+
toolCallId: string;
|
|
2834
|
+
toolName: string;
|
|
2835
|
+
result: ToolResult;
|
|
2836
|
+
duration: number;
|
|
2837
|
+
timestamp: Date;
|
|
2838
|
+
}
|
|
2839
|
+
interface AsyncToolErrorEvent {
|
|
2840
|
+
executionId: string;
|
|
2841
|
+
toolCallId: string;
|
|
2842
|
+
toolName: string;
|
|
2843
|
+
error: Error;
|
|
2844
|
+
duration: number;
|
|
2845
|
+
timestamp: Date;
|
|
2846
|
+
}
|
|
2847
|
+
interface AsyncToolTimeoutEvent {
|
|
2848
|
+
executionId: string;
|
|
2849
|
+
toolCallId: string;
|
|
2850
|
+
toolName: string;
|
|
2851
|
+
timeout: number;
|
|
2852
|
+
timestamp: Date;
|
|
2853
|
+
}
|
|
2854
|
+
interface AsyncContinuationStartEvent {
|
|
2855
|
+
executionId: string;
|
|
2856
|
+
results: Array<{
|
|
2857
|
+
toolCallId: string;
|
|
2858
|
+
toolName: string;
|
|
2859
|
+
}>;
|
|
2860
|
+
timestamp: Date;
|
|
2861
|
+
}
|
|
2549
2862
|
/**
|
|
2550
2863
|
* Map of all event names to their payload types
|
|
2551
2864
|
*/
|
|
@@ -2573,6 +2886,11 @@ interface AgenticLoopEvents {
|
|
|
2573
2886
|
'circuit:opened': CircuitOpenedEvent;
|
|
2574
2887
|
'circuit:half-open': CircuitHalfOpenEvent;
|
|
2575
2888
|
'circuit:closed': CircuitClosedEvent;
|
|
2889
|
+
'async:tool:started': AsyncToolStartedEvent;
|
|
2890
|
+
'async:tool:complete': AsyncToolCompleteEvent;
|
|
2891
|
+
'async:tool:error': AsyncToolErrorEvent;
|
|
2892
|
+
'async:tool:timeout': AsyncToolTimeoutEvent;
|
|
2893
|
+
'async:continuation:start': AsyncContinuationStartEvent;
|
|
2576
2894
|
}
|
|
2577
2895
|
type AgenticLoopEventName = keyof AgenticLoopEvents;
|
|
2578
2896
|
/**
|
|
@@ -2731,7 +3049,8 @@ interface HookSignatures {
|
|
|
2731
3049
|
* Includes error isolation, timeouts, and optional parallel execution
|
|
2732
3050
|
*/
|
|
2733
3051
|
|
|
2734
|
-
declare class HookManager {
|
|
3052
|
+
declare class HookManager implements IDisposable {
|
|
3053
|
+
private _isDestroyed;
|
|
2735
3054
|
private hooks;
|
|
2736
3055
|
private timeout;
|
|
2737
3056
|
private parallel;
|
|
@@ -2787,6 +3106,10 @@ declare class HookManager {
|
|
|
2787
3106
|
* Clear all hooks and reset error tracking
|
|
2788
3107
|
*/
|
|
2789
3108
|
clear(): void;
|
|
3109
|
+
/**
|
|
3110
|
+
* Check if the hook manager has been destroyed
|
|
3111
|
+
*/
|
|
3112
|
+
get isDestroyed(): boolean;
|
|
2790
3113
|
/**
|
|
2791
3114
|
* Destroy the hook manager and release all references
|
|
2792
3115
|
*/
|
|
@@ -2801,4 +3124,4 @@ declare class HookManager {
|
|
|
2801
3124
|
getDisabledHooks(): string[];
|
|
2802
3125
|
}
|
|
2803
3126
|
|
|
2804
|
-
export { type
|
|
3127
|
+
export { type ITokenEstimator as $, type AgentContextNextGenConfig as A, type BeforeCompactionCallback as B, type ContextFeatures as C, type StoredContextSession as D, type ITextProvider as E, type ContextSessionMetadata as F, type FunctionToolDefinition as G, type StreamEvent as H, type IContextStorage as I, type HookConfig as J, type HistoryMode as K, type LLMResponse as L, type MemoryEntry as M, type AsyncToolConfig as N, type OutputItem as O, type PriorityCalculator as P, type AgentEvents as Q, type ResolvedContextFeatures as R, type StoreEntrySchema as S, type ToolCall as T, type AgentResponse as U, type PendingAsyncTool as V, type WorkingMemoryConfig as W, ExecutionContext as X, type ExecutionMetrics as Y, type AuditEntry as Z, type HookName as _, type MemoryScope as a, type ResponseCompleteEvent as a$, type ToolCategoryScope as a0, type CompactionContext as a1, type CompactionResult as a2, type PluginConfigs as a3, type AudioChunkReadyEvent as a4, type ContextStorageListOptions as a5, type ContextSessionSummary as a6, type HistoryEntry as a7, type HistoryReadOptions as a8, type StaleEntryInfo as a9, DEFAULT_FEATURES as aA, DEFAULT_MEMORY_CONFIG as aB, type ErrorEvent as aC, type ExecutionConfig as aD, type HistoryEntryType as aE, type Hook as aF, HookManager as aG, type IAsyncDisposable as aH, type InputImageContent as aI, type InputTextContent as aJ, type IterationCompleteEvent$1 as aK, type JSONSchema as aL, type KnownContextFeatures as aM, type KnownPluginConfigs as aN, MEMORY_PRIORITY_VALUES as aO, type MemoryEntryInput as aP, type MemoryIndexEntry as aQ, type Message as aR, type ModifyingHook as aS, type OutputTextContent as aT, type OutputTextDeltaEvent as aU, type OutputTextDoneEvent as aV, type OversizedInputResult as aW, type PendingAsyncToolStatus as aX, type ReasoningDeltaEvent as aY, type ReasoningDoneEvent as aZ, type ReasoningItem as a_, type PriorityContext as aa, type MemoryIndex as ab, type TaskStatusForMemory as ac, type WorkingMemoryAccess as ad, type TokenUsage as ae, StreamEventType as af, type TextGenerateOptions as ag, type ModelCapabilities as ah, MessageRole as ai, type AfterToolContext as aj, type AgentEventName as ak, type AgenticLoopEventName as al, type AgenticLoopEvents as am, type ApprovalResult as an, type ApproveToolContext as ao, type AudioChunkErrorEvent as ap, type AudioStreamCompleteEvent as aq, type BeforeToolContext as ar, type BuiltInTool as as, CONTEXT_SESSION_FORMAT_VERSION as at, type ToolRegistryEntry as au, type CatalogToolEntry as av, type CompactionItem as aw, type ConnectorCategoryInfo as ax, ContentType as ay, DEFAULT_CONFIG as az, type Tool as b, type ResponseCreatedEvent as b0, type ResponseInProgressEvent as b1, type SimpleScope as b2, type TaskAwareScope as b3, type ThinkingContent as b4, type ToolCallArgumentsDeltaEvent as b5, type ToolCallArgumentsDoneEvent as b6, type ToolCallStartEvent as b7, ToolCallState as b8, ToolCatalogRegistry as b9, isToolCallArgumentsDelta as bA, isToolCallArgumentsDone as bB, isToolCallStart as bC, scopeEquals as bD, scopeMatches as bE, type AsyncContinuationStartEvent as bF, type AsyncToolCompleteEvent as bG, type AsyncToolErrorEvent as bH, type AsyncToolStartedEvent as bI, type AsyncToolTimeoutEvent as bJ, type ExecutionCompleteEvent as bK, type ExecutionStartEvent as bL, type LLMRequestEvent as bM, type LLMResponseEvent as bN, type ToolCompleteEvent as bO, type ToolStartEvent as bP, type ToolCategoryDefinition as ba, type ToolExecutionContext as bb, type ToolExecutionDoneEvent as bc, type ToolExecutionStartEvent as bd, type ToolModification as be, type ToolResultContent as bf, type ToolUseContent as bg, assertNotDestroyed as bh, calculateEntrySize as bi, defaultDescribeCall as bj, forPlan as bk, forTasks as bl, getToolCallDescription as bm, isAudioChunkError as bn, isAudioChunkReady as bo, isAudioStreamComplete as bp, isErrorEvent as bq, isOutputTextDelta as br, isReasoningDelta as bs, isReasoningDone as bt, isResponseComplete as bu, isSimpleScope as bv, isStoreHandler as bw, isStreamEvent as bx, isTaskAwareScope as by, isTerminalMemoryStatus as bz, type ToolFunction as c, type IDisposable as d, type ToolContext as e, type ToolPermissionConfig as f, type ContextBudget as g, type IContextPluginNextGen as h, type IStoreHandler as i, type MemoryPriority as j, type StoreGetResult as k, type StoreSetResult as l, type StoreDeleteResult as m, type StoreListResult as n, type StoreActionResult as o, type MemoryTier as p, type ContextEvents as q, type AuthIdentity as r, type ICompactionStrategy as s, type InputItem as t, type Content as u, type PreparedContext as v, type ToolResult as w, type IHistoryJournal as x, type ConsolidationResult as y, type SerializedContextState as z };
|