@axiom-lattice/core 2.1.45 → 2.1.46
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.mts +57 -2
- package/dist/index.d.ts +57 -2
- package/dist/index.js +307 -105
- package/dist/index.js.map +1 -1
- package/dist/index.mjs +368 -167
- package/dist/index.mjs.map +1 -1
- package/package.json +2 -2
package/dist/index.d.mts
CHANGED
|
@@ -1744,6 +1744,10 @@ declare abstract class ChunkBuffer {
|
|
|
1744
1744
|
* Chunks are appended in order
|
|
1745
1745
|
*/
|
|
1746
1746
|
abstract addChunk(threadId: string, content: MessageChunk): Promise<void>;
|
|
1747
|
+
/**
|
|
1748
|
+
* Ensure a thread buffer exists before any chunks are emitted.
|
|
1749
|
+
*/
|
|
1750
|
+
abstract ensureThread(threadId: string): Promise<void>;
|
|
1747
1751
|
/**
|
|
1748
1752
|
* Mark thread as completed (explicit call)
|
|
1749
1753
|
*/
|
|
@@ -1829,6 +1833,7 @@ declare class InMemoryChunkBuffer extends ChunkBuffer {
|
|
|
1829
1833
|
private getOrCreateBuffer;
|
|
1830
1834
|
addChunk(threadId: string, messageId: string, content: string): Promise<void>;
|
|
1831
1835
|
addChunk(threadId: string, content: MessageChunk): Promise<void>;
|
|
1836
|
+
ensureThread(threadId: string): Promise<void>;
|
|
1832
1837
|
completeThread(threadId: string): Promise<void>;
|
|
1833
1838
|
abortThread(threadId: string): Promise<void>;
|
|
1834
1839
|
isThreadActive(threadId: string): Promise<boolean>;
|
|
@@ -5105,8 +5110,9 @@ declare class Agent {
|
|
|
5105
5110
|
/**
|
|
5106
5111
|
* Abort the current agent execution
|
|
5107
5112
|
* This will cancel any ongoing invoke or stream operations
|
|
5113
|
+
* and clear all queued messages (pending + processing)
|
|
5108
5114
|
*/
|
|
5109
|
-
abort(): void
|
|
5115
|
+
abort(): Promise<void>;
|
|
5110
5116
|
/**
|
|
5111
5117
|
* Check if the agent is currently being aborted
|
|
5112
5118
|
*/
|
|
@@ -5263,4 +5269,53 @@ interface RuntimeModelConfig {
|
|
|
5263
5269
|
*/
|
|
5264
5270
|
declare function createModelSelectorMiddleware(): AgentMiddleware;
|
|
5265
5271
|
|
|
5266
|
-
|
|
5272
|
+
/**
|
|
5273
|
+
* Unknown Tool Handler Middleware
|
|
5274
|
+
*
|
|
5275
|
+
* Intercepts unknown tools selected by the model and returns error feedback
|
|
5276
|
+
* instead of throwing exceptions.
|
|
5277
|
+
*
|
|
5278
|
+
* Implementation: Uses wrapModelCall to get available tools, then afterModel
|
|
5279
|
+
* to generate error ToolMessages and jump back to the model.
|
|
5280
|
+
*
|
|
5281
|
+
* Key Design Principles:
|
|
5282
|
+
* 1. Preserve all tool_calls in AIMessage (keep model's original intent)
|
|
5283
|
+
* 2. Generate error ToolMessages for unknown tools (preserve tool_call_id mapping)
|
|
5284
|
+
* 3. Use jumpTo to loop back to model node (required for agent loop)
|
|
5285
|
+
* 4. ToolNode will skip tool calls that already have ToolMessages
|
|
5286
|
+
*
|
|
5287
|
+
* Architecture:
|
|
5288
|
+
* - Positioned first in middleware chain (before HITL)
|
|
5289
|
+
* - Shared across all agent types (ReAct, DeepAgent, TeamAgent)
|
|
5290
|
+
* - Injected via createCommonMiddlewares
|
|
5291
|
+
*
|
|
5292
|
+
* @example
|
|
5293
|
+
* ```typescript
|
|
5294
|
+
* middlewares.push(createUnknownToolHandlerMiddleware());
|
|
5295
|
+
* ```
|
|
5296
|
+
*/
|
|
5297
|
+
|
|
5298
|
+
interface UnknownToolHandlerConfig {
|
|
5299
|
+
/**
|
|
5300
|
+
* Strategy when encountering unknown tools
|
|
5301
|
+
* - 'error': Return error message to model (default)
|
|
5302
|
+
* - 'strict': Throw exception and terminate
|
|
5303
|
+
*/
|
|
5304
|
+
strategy?: 'error' | 'strict';
|
|
5305
|
+
/**
|
|
5306
|
+
* Custom error message template
|
|
5307
|
+
* @param toolName - The unknown tool name requested
|
|
5308
|
+
* @param availableTools - List of currently available tool names
|
|
5309
|
+
* @returns Error message content
|
|
5310
|
+
*/
|
|
5311
|
+
errorMessageTemplate?: (toolName: string, availableTools: string[]) => string;
|
|
5312
|
+
}
|
|
5313
|
+
/**
|
|
5314
|
+
* Create unknown tool handler middleware
|
|
5315
|
+
*
|
|
5316
|
+
* @param config - Configuration options
|
|
5317
|
+
* @returns AgentMiddleware instance
|
|
5318
|
+
*/
|
|
5319
|
+
declare function createUnknownToolHandlerMiddleware(config?: UnknownToolHandlerConfig): AgentMiddleware;
|
|
5320
|
+
|
|
5321
|
+
export { AGENT_TASK_EVENT, type AddMessageParams, Agent, type AgentClient, type AgentExecutor, AgentInstanceManager, type AgentLattice, AgentLatticeManager, type AgentLifecycleEventName, AgentManager, type AgentStreamExecutor, type AgentThreadInterface, type BackendFactory, type BackendProtocol, type BufferStats, type Chunk, ChunkBuffer, ChunkBufferLatticeManager, type ColumnInfo, CompositeBackend, ConsoleLoggerClient, type CronFields, CustomMetricsClient, type DatabaseConfig, type DatabaseType, DefaultScheduleClient, EMPTY_CONTENT_WARNING, type EditResult, type EmbeddingsLatticeInterface, EmbeddingsLatticeManager, type FileData, type FileInfo, FileSystemSkillStore, type FileSystemSkillStoreOptions, FilesystemBackend, type GrepMatch, type IMessageQueueStore, type IMetricsServerClient, type ISqlDatabase, InMemoryAssistantStore, InMemoryChunkBuffer, InMemoryDatabaseConfigStore, InMemoryMailboxStore, InMemoryTaskListStore, InMemoryTenantStore, InMemoryThreadMessageQueueStore, InMemoryThreadStore, InMemoryUserStore, InMemoryUserTenantLinkStore, type IsolatedLevel, LINE_NUMBER_WIDTH, type LangGraphStateChecker, type LoggerLattice, LoggerLatticeManager, MAX_LINE_LENGTH, type MailboxMessage, type MailboxStore, type McpLatticeInterface, McpLatticeManager, type McpServerInfo, MemoryBackend, MemoryLatticeManager, MemoryQueueClient, MemoryScheduleStorage, type MessageCompletedEvent, type MessageFailedEvent, type MessageStartedEvent, MessageType, MetricsServerManager, type ModelConfig, type ModelLatticeInterface, ModelLatticeManager, type PendingMessage, PinoLoggerClient, PostgresDatabase, PrometheusClient, type QueryResult, type QueueLattice, QueueLatticeManager, QueueMode, type QueuePendingEvent, type RunSandboxConfig, type RuntimeModelConfig, SandboxFilesystem, SandboxLatticeManager, type SandboxManagerProtocol, SandboxSkillStore, type SandboxSkillStoreOptions, type ScheduleLattice, ScheduleLatticeManager, SemanticMetricsClient, type SkillLattice, SkillLatticeManager, type SkillResource, SqlDatabaseManager, type StateAndStore, StateBackend, StoreBackend, type StoreLattice, StoreLatticeManager, type StoreType, type StoreTypeMap, TOOL_RESULT_TOKEN_LIMIT, TRUNCATION_GUIDANCE, type TableInfo, type TableSchema, type TaskEvent, type TaskListStore, type TaskSpec, TaskStatus, type TaskUpdatable, TeamAgentGraphBuilder, type TeamConfig, type TeamMiddlewareOptions, type TeamTask, type TeammateSpec, type TeammateToolsOptions, type ThreadBuffer, type ThreadBufferConfig, type ThreadBusyEvent, type ThreadIdleEvent, type ThreadInfo, type ThreadQueueConfig, type ThreadState, ThreadStatus, type ThreadStatusChangedEvent, type ToolDefinition, type ToolLattice, ToolLatticeManager, type UnknownToolHandlerConfig, type VectorStoreLatticeInterface, VectorStoreLatticeManager, type WriteResult, agentInstanceManager, agentLatticeManager, buildGrepResultsDict, checkEmptyContent, clearEncryptionKeyCache, createAgentTeam, createExecuteSqlQueryTool, createFileData, createInfoSqlTool, createListMetricsDataSourcesTool, createListMetricsServersTool, createListTablesSqlTool, createModelSelectorMiddleware, createQueryCheckerSqlTool, createQueryMetricDefinitionTool, createQueryMetricsListTool, createQuerySemanticMetricDataTool, createQuerySqlTool, createQueryTableDefinitionTool, createQueryTablesListTool, createTeamMiddleware, createTeammateTools, createUnknownToolHandlerMiddleware, createWidgetMiddleware, decrypt, describeCronExpression, embeddingsLatticeManager, encrypt, eventBus, eventBus as eventBusDefault, fileDataToString, formatContentWithLineNumbers, formatGrepMatches, formatGrepResults, formatReadResponse, getAgentClient, getAgentConfig, getAllAgentConfigs, getAllToolDefinitions, getCheckpointSaver, getChunkBuffer, getEmbeddingsClient, getEmbeddingsLattice, getEncryptionKey, getLoggerLattice, getModelLattice, getNextCronTime, getQueueLattice, getSandBoxManager, getScheduleLattice, getStoreLattice, getToolClient, getToolDefinition, getToolLattice, getVectorStoreClient, getVectorStoreLattice, globSearchFiles, grepMatchesFromFiles, grepSearchFiles, hasChunkBuffer, isUsingDefaultKey, isValidCronExpression, isValidSandboxName, isValidSkillName, loggerLatticeManager, mcpManager, metricsServerManager, modelLatticeManager, normalizeSandboxName, parseCronExpression, performStringReplacement, queueLatticeManager, registerAgentLattice, registerAgentLatticeWithTenant, registerAgentLattices, registerCheckpointSaver, registerChunkBuffer, registerEmbeddingsLattice, registerExistingTool, registerLoggerLattice, registerModelLattice, registerQueueLattice, registerScheduleLattice, registerStoreLattice, registerTeammateAgent, registerToolLattice, registerVectorStoreLattice, sandboxLatticeManager, sanitizeToolCallId, scheduleLatticeManager, skillLatticeManager, sqlDatabaseManager, storeLatticeManager, toolLatticeManager, truncateIfTooLong, unregisterTeammateAgent, updateFileData, validateAgentInput, validateEncryptionKey, validatePath, validateSkillName, validateToolInput, vectorStoreLatticeManager };
|
package/dist/index.d.ts
CHANGED
|
@@ -1744,6 +1744,10 @@ declare abstract class ChunkBuffer {
|
|
|
1744
1744
|
* Chunks are appended in order
|
|
1745
1745
|
*/
|
|
1746
1746
|
abstract addChunk(threadId: string, content: MessageChunk): Promise<void>;
|
|
1747
|
+
/**
|
|
1748
|
+
* Ensure a thread buffer exists before any chunks are emitted.
|
|
1749
|
+
*/
|
|
1750
|
+
abstract ensureThread(threadId: string): Promise<void>;
|
|
1747
1751
|
/**
|
|
1748
1752
|
* Mark thread as completed (explicit call)
|
|
1749
1753
|
*/
|
|
@@ -1829,6 +1833,7 @@ declare class InMemoryChunkBuffer extends ChunkBuffer {
|
|
|
1829
1833
|
private getOrCreateBuffer;
|
|
1830
1834
|
addChunk(threadId: string, messageId: string, content: string): Promise<void>;
|
|
1831
1835
|
addChunk(threadId: string, content: MessageChunk): Promise<void>;
|
|
1836
|
+
ensureThread(threadId: string): Promise<void>;
|
|
1832
1837
|
completeThread(threadId: string): Promise<void>;
|
|
1833
1838
|
abortThread(threadId: string): Promise<void>;
|
|
1834
1839
|
isThreadActive(threadId: string): Promise<boolean>;
|
|
@@ -5105,8 +5110,9 @@ declare class Agent {
|
|
|
5105
5110
|
/**
|
|
5106
5111
|
* Abort the current agent execution
|
|
5107
5112
|
* This will cancel any ongoing invoke or stream operations
|
|
5113
|
+
* and clear all queued messages (pending + processing)
|
|
5108
5114
|
*/
|
|
5109
|
-
abort(): void
|
|
5115
|
+
abort(): Promise<void>;
|
|
5110
5116
|
/**
|
|
5111
5117
|
* Check if the agent is currently being aborted
|
|
5112
5118
|
*/
|
|
@@ -5263,4 +5269,53 @@ interface RuntimeModelConfig {
|
|
|
5263
5269
|
*/
|
|
5264
5270
|
declare function createModelSelectorMiddleware(): AgentMiddleware;
|
|
5265
5271
|
|
|
5266
|
-
|
|
5272
|
+
/**
|
|
5273
|
+
* Unknown Tool Handler Middleware
|
|
5274
|
+
*
|
|
5275
|
+
* Intercepts unknown tools selected by the model and returns error feedback
|
|
5276
|
+
* instead of throwing exceptions.
|
|
5277
|
+
*
|
|
5278
|
+
* Implementation: Uses wrapModelCall to get available tools, then afterModel
|
|
5279
|
+
* to generate error ToolMessages and jump back to the model.
|
|
5280
|
+
*
|
|
5281
|
+
* Key Design Principles:
|
|
5282
|
+
* 1. Preserve all tool_calls in AIMessage (keep model's original intent)
|
|
5283
|
+
* 2. Generate error ToolMessages for unknown tools (preserve tool_call_id mapping)
|
|
5284
|
+
* 3. Use jumpTo to loop back to model node (required for agent loop)
|
|
5285
|
+
* 4. ToolNode will skip tool calls that already have ToolMessages
|
|
5286
|
+
*
|
|
5287
|
+
* Architecture:
|
|
5288
|
+
* - Positioned first in middleware chain (before HITL)
|
|
5289
|
+
* - Shared across all agent types (ReAct, DeepAgent, TeamAgent)
|
|
5290
|
+
* - Injected via createCommonMiddlewares
|
|
5291
|
+
*
|
|
5292
|
+
* @example
|
|
5293
|
+
* ```typescript
|
|
5294
|
+
* middlewares.push(createUnknownToolHandlerMiddleware());
|
|
5295
|
+
* ```
|
|
5296
|
+
*/
|
|
5297
|
+
|
|
5298
|
+
interface UnknownToolHandlerConfig {
|
|
5299
|
+
/**
|
|
5300
|
+
* Strategy when encountering unknown tools
|
|
5301
|
+
* - 'error': Return error message to model (default)
|
|
5302
|
+
* - 'strict': Throw exception and terminate
|
|
5303
|
+
*/
|
|
5304
|
+
strategy?: 'error' | 'strict';
|
|
5305
|
+
/**
|
|
5306
|
+
* Custom error message template
|
|
5307
|
+
* @param toolName - The unknown tool name requested
|
|
5308
|
+
* @param availableTools - List of currently available tool names
|
|
5309
|
+
* @returns Error message content
|
|
5310
|
+
*/
|
|
5311
|
+
errorMessageTemplate?: (toolName: string, availableTools: string[]) => string;
|
|
5312
|
+
}
|
|
5313
|
+
/**
|
|
5314
|
+
* Create unknown tool handler middleware
|
|
5315
|
+
*
|
|
5316
|
+
* @param config - Configuration options
|
|
5317
|
+
* @returns AgentMiddleware instance
|
|
5318
|
+
*/
|
|
5319
|
+
declare function createUnknownToolHandlerMiddleware(config?: UnknownToolHandlerConfig): AgentMiddleware;
|
|
5320
|
+
|
|
5321
|
+
export { AGENT_TASK_EVENT, type AddMessageParams, Agent, type AgentClient, type AgentExecutor, AgentInstanceManager, type AgentLattice, AgentLatticeManager, type AgentLifecycleEventName, AgentManager, type AgentStreamExecutor, type AgentThreadInterface, type BackendFactory, type BackendProtocol, type BufferStats, type Chunk, ChunkBuffer, ChunkBufferLatticeManager, type ColumnInfo, CompositeBackend, ConsoleLoggerClient, type CronFields, CustomMetricsClient, type DatabaseConfig, type DatabaseType, DefaultScheduleClient, EMPTY_CONTENT_WARNING, type EditResult, type EmbeddingsLatticeInterface, EmbeddingsLatticeManager, type FileData, type FileInfo, FileSystemSkillStore, type FileSystemSkillStoreOptions, FilesystemBackend, type GrepMatch, type IMessageQueueStore, type IMetricsServerClient, type ISqlDatabase, InMemoryAssistantStore, InMemoryChunkBuffer, InMemoryDatabaseConfigStore, InMemoryMailboxStore, InMemoryTaskListStore, InMemoryTenantStore, InMemoryThreadMessageQueueStore, InMemoryThreadStore, InMemoryUserStore, InMemoryUserTenantLinkStore, type IsolatedLevel, LINE_NUMBER_WIDTH, type LangGraphStateChecker, type LoggerLattice, LoggerLatticeManager, MAX_LINE_LENGTH, type MailboxMessage, type MailboxStore, type McpLatticeInterface, McpLatticeManager, type McpServerInfo, MemoryBackend, MemoryLatticeManager, MemoryQueueClient, MemoryScheduleStorage, type MessageCompletedEvent, type MessageFailedEvent, type MessageStartedEvent, MessageType, MetricsServerManager, type ModelConfig, type ModelLatticeInterface, ModelLatticeManager, type PendingMessage, PinoLoggerClient, PostgresDatabase, PrometheusClient, type QueryResult, type QueueLattice, QueueLatticeManager, QueueMode, type QueuePendingEvent, type RunSandboxConfig, type RuntimeModelConfig, SandboxFilesystem, SandboxLatticeManager, type SandboxManagerProtocol, SandboxSkillStore, type SandboxSkillStoreOptions, type ScheduleLattice, ScheduleLatticeManager, SemanticMetricsClient, type SkillLattice, SkillLatticeManager, type SkillResource, SqlDatabaseManager, type StateAndStore, StateBackend, StoreBackend, type StoreLattice, StoreLatticeManager, type StoreType, type StoreTypeMap, TOOL_RESULT_TOKEN_LIMIT, TRUNCATION_GUIDANCE, type TableInfo, type TableSchema, type TaskEvent, type TaskListStore, type TaskSpec, TaskStatus, type TaskUpdatable, TeamAgentGraphBuilder, type TeamConfig, type TeamMiddlewareOptions, type TeamTask, type TeammateSpec, type TeammateToolsOptions, type ThreadBuffer, type ThreadBufferConfig, type ThreadBusyEvent, type ThreadIdleEvent, type ThreadInfo, type ThreadQueueConfig, type ThreadState, ThreadStatus, type ThreadStatusChangedEvent, type ToolDefinition, type ToolLattice, ToolLatticeManager, type UnknownToolHandlerConfig, type VectorStoreLatticeInterface, VectorStoreLatticeManager, type WriteResult, agentInstanceManager, agentLatticeManager, buildGrepResultsDict, checkEmptyContent, clearEncryptionKeyCache, createAgentTeam, createExecuteSqlQueryTool, createFileData, createInfoSqlTool, createListMetricsDataSourcesTool, createListMetricsServersTool, createListTablesSqlTool, createModelSelectorMiddleware, createQueryCheckerSqlTool, createQueryMetricDefinitionTool, createQueryMetricsListTool, createQuerySemanticMetricDataTool, createQuerySqlTool, createQueryTableDefinitionTool, createQueryTablesListTool, createTeamMiddleware, createTeammateTools, createUnknownToolHandlerMiddleware, createWidgetMiddleware, decrypt, describeCronExpression, embeddingsLatticeManager, encrypt, eventBus, eventBus as eventBusDefault, fileDataToString, formatContentWithLineNumbers, formatGrepMatches, formatGrepResults, formatReadResponse, getAgentClient, getAgentConfig, getAllAgentConfigs, getAllToolDefinitions, getCheckpointSaver, getChunkBuffer, getEmbeddingsClient, getEmbeddingsLattice, getEncryptionKey, getLoggerLattice, getModelLattice, getNextCronTime, getQueueLattice, getSandBoxManager, getScheduleLattice, getStoreLattice, getToolClient, getToolDefinition, getToolLattice, getVectorStoreClient, getVectorStoreLattice, globSearchFiles, grepMatchesFromFiles, grepSearchFiles, hasChunkBuffer, isUsingDefaultKey, isValidCronExpression, isValidSandboxName, isValidSkillName, loggerLatticeManager, mcpManager, metricsServerManager, modelLatticeManager, normalizeSandboxName, parseCronExpression, performStringReplacement, queueLatticeManager, registerAgentLattice, registerAgentLatticeWithTenant, registerAgentLattices, registerCheckpointSaver, registerChunkBuffer, registerEmbeddingsLattice, registerExistingTool, registerLoggerLattice, registerModelLattice, registerQueueLattice, registerScheduleLattice, registerStoreLattice, registerTeammateAgent, registerToolLattice, registerVectorStoreLattice, sandboxLatticeManager, sanitizeToolCallId, scheduleLatticeManager, skillLatticeManager, sqlDatabaseManager, storeLatticeManager, toolLatticeManager, truncateIfTooLong, unregisterTeammateAgent, updateFileData, validateAgentInput, validateEncryptionKey, validatePath, validateSkillName, validateToolInput, vectorStoreLatticeManager };
|