@illuma-ai/agents 1.4.0-alpha.6 → 1.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 +62 -0
- package/dist/cjs/agents/AgentContext.cjs +274 -67
- package/dist/cjs/agents/AgentContext.cjs.map +1 -1
- package/dist/cjs/common/enum.cjs +44 -13
- package/dist/cjs/common/enum.cjs.map +1 -1
- package/dist/cjs/graphs/Graph.cjs +182 -5
- package/dist/cjs/graphs/Graph.cjs.map +1 -1
- package/dist/cjs/graphs/MultiAgentGraph.cjs +152 -1167
- package/dist/cjs/graphs/MultiAgentGraph.cjs.map +1 -1
- package/dist/cjs/hooks/HookRegistry.cjs +162 -0
- package/dist/cjs/hooks/HookRegistry.cjs.map +1 -0
- package/dist/cjs/hooks/executeHooks.cjs +276 -0
- package/dist/cjs/hooks/executeHooks.cjs.map +1 -0
- package/dist/cjs/hooks/matchers.cjs +256 -0
- package/dist/cjs/hooks/matchers.cjs.map +1 -0
- package/dist/cjs/hooks/types.cjs +27 -0
- package/dist/cjs/hooks/types.cjs.map +1 -0
- package/dist/cjs/langchain/google-common.cjs +3 -0
- package/dist/cjs/langchain/google-common.cjs.map +1 -0
- package/dist/cjs/langchain/index.cjs +86 -0
- package/dist/cjs/langchain/index.cjs.map +1 -0
- package/dist/cjs/langchain/language_models/chat_models.cjs +3 -0
- package/dist/cjs/langchain/language_models/chat_models.cjs.map +1 -0
- package/dist/cjs/langchain/messages/tool.cjs +3 -0
- package/dist/cjs/langchain/messages/tool.cjs.map +1 -0
- package/dist/cjs/langchain/messages.cjs +51 -0
- package/dist/cjs/langchain/messages.cjs.map +1 -0
- package/dist/cjs/langchain/openai.cjs +3 -0
- package/dist/cjs/langchain/openai.cjs.map +1 -0
- package/dist/cjs/langchain/prompts.cjs +11 -0
- package/dist/cjs/langchain/prompts.cjs.map +1 -0
- package/dist/cjs/langchain/runnables.cjs +19 -0
- package/dist/cjs/langchain/runnables.cjs.map +1 -0
- package/dist/cjs/langchain/tools.cjs +23 -0
- package/dist/cjs/langchain/tools.cjs.map +1 -0
- package/dist/cjs/langchain/utils/env.cjs +11 -0
- package/dist/cjs/langchain/utils/env.cjs.map +1 -0
- package/dist/cjs/llm/anthropic/utils/message_inputs.cjs +5 -1
- package/dist/cjs/llm/anthropic/utils/message_inputs.cjs.map +1 -1
- package/dist/cjs/llm/bedrock/cacheSupport.cjs +55 -0
- package/dist/cjs/llm/bedrock/cacheSupport.cjs.map +1 -0
- package/dist/cjs/llm/bedrock/index.cjs +61 -33
- package/dist/cjs/llm/bedrock/index.cjs.map +1 -1
- package/dist/cjs/llm/openai/index.cjs +0 -3
- package/dist/cjs/llm/openai/index.cjs.map +1 -1
- package/dist/cjs/llm/openai/utils/index.cjs +27 -10
- package/dist/cjs/llm/openai/utils/index.cjs.map +1 -1
- package/dist/cjs/main.cjs +178 -127
- package/dist/cjs/main.cjs.map +1 -1
- package/dist/cjs/messages/cache.cjs +89 -0
- package/dist/cjs/messages/cache.cjs.map +1 -1
- package/dist/cjs/messages/contextPruning.cjs +156 -0
- package/dist/cjs/messages/contextPruning.cjs.map +1 -0
- package/dist/cjs/messages/contextPruningSettings.cjs +53 -0
- package/dist/cjs/messages/contextPruningSettings.cjs.map +1 -0
- package/dist/cjs/messages/format.cjs +144 -20
- package/dist/cjs/messages/format.cjs.map +1 -1
- package/dist/cjs/messages/prune.cjs +505 -4
- package/dist/cjs/messages/prune.cjs.map +1 -1
- package/dist/cjs/run.cjs +141 -1
- package/dist/cjs/run.cjs.map +1 -1
- package/dist/cjs/tools/BashExecutor.cjs +235 -0
- package/dist/cjs/tools/BashExecutor.cjs.map +1 -0
- package/dist/cjs/tools/BashProgrammaticToolCalling.cjs +297 -0
- package/dist/cjs/tools/BashProgrammaticToolCalling.cjs.map +1 -0
- package/dist/cjs/tools/CodeExecutor.cjs +44 -47
- package/dist/cjs/tools/CodeExecutor.cjs.map +1 -1
- package/dist/cjs/tools/ProgrammaticToolCalling.cjs +16 -11
- package/dist/cjs/tools/ProgrammaticToolCalling.cjs.map +1 -1
- package/dist/cjs/tools/ReadFile.cjs +44 -0
- package/dist/cjs/tools/ReadFile.cjs.map +1 -0
- package/dist/cjs/tools/SkillTool.cjs +51 -0
- package/dist/cjs/tools/SkillTool.cjs.map +1 -0
- package/dist/cjs/tools/SubagentTool.cjs +93 -0
- package/dist/cjs/tools/SubagentTool.cjs.map +1 -0
- package/dist/cjs/tools/ToolNode.cjs +450 -24
- package/dist/cjs/tools/ToolNode.cjs.map +1 -1
- package/dist/cjs/tools/search/search.cjs +11 -3
- package/dist/cjs/tools/search/search.cjs.map +1 -1
- package/dist/cjs/tools/search/tavily-scraper.cjs +189 -0
- package/dist/cjs/tools/search/tavily-scraper.cjs.map +1 -0
- package/dist/cjs/tools/search/tavily-search.cjs +372 -0
- package/dist/cjs/tools/search/tavily-search.cjs.map +1 -0
- package/dist/cjs/tools/search/tool.cjs +28 -4
- package/dist/cjs/tools/search/tool.cjs.map +1 -1
- package/dist/cjs/tools/search/utils.cjs +10 -3
- package/dist/cjs/tools/search/utils.cjs.map +1 -1
- package/dist/cjs/tools/skillCatalog.cjs +84 -0
- package/dist/cjs/tools/skillCatalog.cjs.map +1 -0
- package/dist/cjs/tools/subagent/SubagentExecutor.cjs +512 -0
- package/dist/cjs/tools/subagent/SubagentExecutor.cjs.map +1 -0
- package/dist/cjs/tools/toolOutputReferences.cjs +670 -0
- package/dist/cjs/tools/toolOutputReferences.cjs.map +1 -0
- package/dist/cjs/types/agent-cache.cjs +53 -0
- package/dist/cjs/types/agent-cache.cjs.map +1 -0
- package/dist/cjs/types/graph.cjs.map +1 -1
- package/dist/cjs/utils/truncation.cjs +135 -0
- package/dist/cjs/utils/truncation.cjs.map +1 -0
- package/dist/esm/agents/AgentContext.mjs +274 -67
- package/dist/esm/agents/AgentContext.mjs.map +1 -1
- package/dist/esm/common/enum.mjs +44 -12
- package/dist/esm/common/enum.mjs.map +1 -1
- package/dist/esm/graphs/Graph.mjs +182 -5
- package/dist/esm/graphs/Graph.mjs.map +1 -1
- package/dist/esm/graphs/MultiAgentGraph.mjs +155 -1170
- package/dist/esm/graphs/MultiAgentGraph.mjs.map +1 -1
- package/dist/esm/hooks/HookRegistry.mjs +160 -0
- package/dist/esm/hooks/HookRegistry.mjs.map +1 -0
- package/dist/esm/hooks/executeHooks.mjs +273 -0
- package/dist/esm/hooks/executeHooks.mjs.map +1 -0
- package/dist/esm/hooks/matchers.mjs +251 -0
- package/dist/esm/hooks/matchers.mjs.map +1 -0
- package/dist/esm/hooks/types.mjs +25 -0
- package/dist/esm/hooks/types.mjs.map +1 -0
- package/dist/esm/langchain/google-common.mjs +2 -0
- package/dist/esm/langchain/google-common.mjs.map +1 -0
- package/dist/esm/langchain/index.mjs +5 -0
- package/dist/esm/langchain/language_models/chat_models.mjs +2 -0
- package/dist/esm/langchain/language_models/chat_models.mjs.map +1 -0
- package/dist/esm/langchain/messages/tool.mjs +2 -0
- package/dist/esm/langchain/messages/tool.mjs.map +1 -0
- package/dist/esm/langchain/messages.mjs +2 -0
- package/dist/esm/langchain/messages.mjs.map +1 -0
- package/dist/esm/langchain/openai.mjs +2 -0
- package/dist/esm/langchain/openai.mjs.map +1 -0
- package/dist/esm/langchain/prompts.mjs +2 -0
- package/dist/esm/langchain/prompts.mjs.map +1 -0
- package/dist/esm/langchain/runnables.mjs +2 -0
- package/dist/esm/langchain/runnables.mjs.map +1 -0
- package/dist/esm/langchain/tools.mjs +2 -0
- package/dist/esm/langchain/tools.mjs.map +1 -0
- package/dist/esm/langchain/utils/env.mjs +2 -0
- package/dist/esm/langchain/utils/env.mjs.map +1 -0
- package/dist/esm/llm/anthropic/utils/message_inputs.mjs +5 -1
- package/dist/esm/llm/anthropic/utils/message_inputs.mjs.map +1 -1
- package/dist/esm/llm/bedrock/cacheSupport.mjs +52 -0
- package/dist/esm/llm/bedrock/cacheSupport.mjs.map +1 -0
- package/dist/esm/llm/bedrock/index.mjs +61 -34
- package/dist/esm/llm/bedrock/index.mjs.map +1 -1
- package/dist/esm/llm/openai/index.mjs +0 -3
- package/dist/esm/llm/openai/index.mjs.map +1 -1
- package/dist/esm/llm/openai/utils/index.mjs +27 -10
- package/dist/esm/llm/openai/utils/index.mjs.map +1 -1
- package/dist/esm/main.mjs +21 -27
- package/dist/esm/main.mjs.map +1 -1
- package/dist/esm/messages/cache.mjs +89 -0
- package/dist/esm/messages/cache.mjs.map +1 -1
- package/dist/esm/messages/contextPruning.mjs +154 -0
- package/dist/esm/messages/contextPruning.mjs.map +1 -0
- package/dist/esm/messages/contextPruningSettings.mjs +50 -0
- package/dist/esm/messages/contextPruningSettings.mjs.map +1 -0
- package/dist/esm/messages/format.mjs +136 -12
- package/dist/esm/messages/format.mjs.map +1 -1
- package/dist/esm/messages/prune.mjs +504 -7
- package/dist/esm/messages/prune.mjs.map +1 -1
- package/dist/esm/run.mjs +141 -1
- package/dist/esm/run.mjs.map +1 -1
- package/dist/esm/tools/BashExecutor.mjs +227 -0
- package/dist/esm/tools/BashExecutor.mjs.map +1 -0
- package/dist/esm/tools/BashProgrammaticToolCalling.mjs +288 -0
- package/dist/esm/tools/BashProgrammaticToolCalling.mjs.map +1 -0
- package/dist/esm/tools/CodeExecutor.mjs +44 -48
- package/dist/esm/tools/CodeExecutor.mjs.map +1 -1
- package/dist/esm/tools/ProgrammaticToolCalling.mjs +17 -12
- package/dist/esm/tools/ProgrammaticToolCalling.mjs.map +1 -1
- package/dist/esm/tools/ReadFile.mjs +39 -0
- package/dist/esm/tools/ReadFile.mjs.map +1 -0
- package/dist/esm/tools/SkillTool.mjs +46 -0
- package/dist/esm/tools/SkillTool.mjs.map +1 -0
- package/dist/esm/tools/SubagentTool.mjs +86 -0
- package/dist/esm/tools/SubagentTool.mjs.map +1 -0
- package/dist/esm/tools/ToolNode.mjs +452 -26
- package/dist/esm/tools/ToolNode.mjs.map +1 -1
- package/dist/esm/tools/search/search.mjs +11 -3
- package/dist/esm/tools/search/search.mjs.map +1 -1
- package/dist/esm/tools/search/tavily-scraper.mjs +186 -0
- package/dist/esm/tools/search/tavily-scraper.mjs.map +1 -0
- package/dist/esm/tools/search/tavily-search.mjs +370 -0
- package/dist/esm/tools/search/tavily-search.mjs.map +1 -0
- package/dist/esm/tools/search/tool.mjs +28 -4
- package/dist/esm/tools/search/tool.mjs.map +1 -1
- package/dist/esm/tools/search/utils.mjs +10 -3
- package/dist/esm/tools/search/utils.mjs.map +1 -1
- package/dist/esm/tools/skillCatalog.mjs +82 -0
- package/dist/esm/tools/skillCatalog.mjs.map +1 -0
- package/dist/esm/tools/subagent/SubagentExecutor.mjs +506 -0
- package/dist/esm/tools/subagent/SubagentExecutor.mjs.map +1 -0
- package/dist/esm/tools/toolOutputReferences.mjs +662 -0
- package/dist/esm/tools/toolOutputReferences.mjs.map +1 -0
- package/dist/esm/types/agent-cache.mjs +51 -0
- package/dist/esm/types/agent-cache.mjs.map +1 -0
- package/dist/esm/types/graph.mjs.map +1 -1
- package/dist/esm/utils/truncation.mjs +128 -0
- package/dist/esm/utils/truncation.mjs.map +1 -0
- package/dist/types/agents/AgentContext.d.ts +101 -8
- package/dist/types/common/enum.d.ts +39 -12
- package/dist/types/common/index.d.ts +0 -1
- package/dist/types/graphs/Graph.d.ts +43 -0
- package/dist/types/graphs/MultiAgentGraph.d.ts +26 -150
- package/dist/types/graphs/index.d.ts +0 -1
- package/dist/types/hooks/HookRegistry.d.ts +56 -0
- package/dist/types/hooks/executeHooks.d.ts +79 -0
- package/dist/types/hooks/index.d.ts +6 -0
- package/dist/types/hooks/matchers.d.ts +95 -0
- package/dist/types/hooks/types.d.ts +320 -0
- package/dist/types/index.d.ts +9 -9
- package/dist/types/langchain/google-common.d.ts +1 -0
- package/dist/types/langchain/index.d.ts +8 -0
- package/dist/types/langchain/language_models/chat_models.d.ts +1 -0
- package/dist/types/langchain/messages/tool.d.ts +1 -0
- package/dist/types/langchain/messages.d.ts +2 -0
- package/dist/types/langchain/openai.d.ts +1 -0
- package/dist/types/langchain/prompts.d.ts +1 -0
- package/dist/types/langchain/runnables.d.ts +2 -0
- package/dist/types/langchain/tools.d.ts +2 -0
- package/dist/types/langchain/utils/env.d.ts +1 -0
- package/dist/types/llm/bedrock/cacheSupport.d.ts +35 -0
- package/dist/types/llm/bedrock/index.d.ts +54 -1
- package/dist/types/messages/contextPruning.d.ts +42 -0
- package/dist/types/messages/contextPruningSettings.d.ts +44 -0
- package/dist/types/messages/format.d.ts +9 -1
- package/dist/types/messages/index.d.ts +2 -0
- package/dist/types/messages/prune.d.ts +91 -1
- package/dist/types/run.d.ts +2 -0
- package/dist/types/tools/BashExecutor.d.ts +76 -0
- package/dist/types/tools/BashProgrammaticToolCalling.d.ts +72 -0
- package/dist/types/tools/CodeExecutor.d.ts +8 -26
- package/dist/types/tools/ReadFile.d.ts +28 -0
- package/dist/types/tools/SkillTool.d.ts +40 -0
- package/dist/types/tools/SubagentTool.d.ts +36 -0
- package/dist/types/tools/ToolNode.d.ts +77 -5
- package/dist/types/tools/search/tavily-scraper.d.ts +19 -0
- package/dist/types/tools/search/tavily-search.d.ts +4 -0
- package/dist/types/tools/search/types.d.ts +99 -5
- package/dist/types/tools/search/utils.d.ts +2 -2
- package/dist/types/tools/skillCatalog.d.ts +19 -0
- package/dist/types/tools/subagent/SubagentExecutor.d.ts +137 -0
- package/dist/types/tools/subagent/index.d.ts +2 -0
- package/dist/types/tools/subagent/types.d.ts +84 -0
- package/dist/types/tools/toolOutputReferences.d.ts +236 -0
- package/dist/types/types/agent-cache.d.ts +70 -0
- package/dist/types/types/graph.d.ts +162 -22
- package/dist/types/types/index.d.ts +3 -0
- package/dist/types/types/messages.d.ts +26 -0
- package/dist/types/types/run.d.ts +22 -0
- package/dist/types/types/skill.d.ts +9 -0
- package/dist/types/types/tools.d.ts +111 -0
- package/dist/types/utils/index.d.ts +1 -3
- package/dist/types/utils/truncation.d.ts +70 -0
- package/package.json +57 -17
- package/src/agents/AgentContext.js.map +1 -0
- package/src/agents/AgentContext.test.js.map +1 -0
- package/src/agents/AgentContext.ts +321 -78
- package/src/agents/__tests__/AgentContext.cacheTtl.live.test.ts +259 -0
- package/src/agents/__tests__/AgentContext.crossAgentTier1.live.test.ts +264 -0
- package/src/agents/__tests__/AgentContext.crossUserCache.live.test.ts +342 -0
- package/src/agents/__tests__/AgentContext.test.js.map +1 -0
- package/src/agents/__tests__/AgentContext.test.ts +632 -0
- package/src/agents/__tests__/resolveStructuredOutputMode.test.js.map +1 -0
- package/src/common/__tests__/enum.test.ts +7 -17
- package/src/common/enum.js.map +1 -0
- package/src/common/enum.ts +43 -12
- package/src/common/index.js.map +1 -0
- package/src/common/index.ts +0 -1
- package/src/events.js.map +1 -0
- package/src/graphs/Graph.js.map +1 -0
- package/src/graphs/Graph.ts +222 -2
- package/src/graphs/MultiAgentGraph.js.map +1 -0
- package/src/graphs/MultiAgentGraph.ts +154 -1466
- package/src/graphs/__tests__/MultiAgentGraph.test.ts +91 -0
- package/src/graphs/__tests__/structured-output.integration.test.js.map +1 -0
- package/src/graphs/__tests__/structured-output.test.js.map +1 -0
- package/src/graphs/contextManagement.e2e.test.js.map +1 -0
- package/src/graphs/contextManagement.test.js.map +1 -0
- package/src/graphs/handoffValidation.test.js.map +1 -0
- package/src/graphs/index.js.map +1 -0
- package/src/graphs/index.ts +0 -1
- package/src/hooks/HookRegistry.ts +208 -0
- package/src/hooks/__tests__/HookRegistry.test.ts +190 -0
- package/src/hooks/__tests__/compactHooks.test.ts +214 -0
- package/src/hooks/__tests__/executeHooks.test.ts +1013 -0
- package/src/hooks/__tests__/integration.test.ts +337 -0
- package/src/hooks/__tests__/matchers.test.ts +238 -0
- package/src/hooks/__tests__/toolHooks.test.ts +665 -0
- package/src/hooks/executeHooks.ts +375 -0
- package/src/hooks/index.ts +57 -0
- package/src/hooks/matchers.ts +280 -0
- package/src/hooks/types.ts +404 -0
- package/src/index.js.map +1 -0
- package/src/index.ts +15 -24
- package/src/instrumentation.js.map +1 -0
- package/src/langchain/google-common.ts +1 -0
- package/src/langchain/index.ts +8 -0
- package/src/langchain/language_models/chat_models.ts +1 -0
- package/src/langchain/messages/tool.ts +5 -0
- package/src/langchain/messages.ts +21 -0
- package/src/langchain/openai.ts +1 -0
- package/src/langchain/prompts.ts +1 -0
- package/src/langchain/runnables.ts +7 -0
- package/src/langchain/tools.ts +8 -0
- package/src/langchain/utils/env.ts +1 -0
- package/src/llm/anthropic/index.js.map +1 -0
- package/src/llm/anthropic/types.js.map +1 -0
- package/src/llm/anthropic/utils/message_inputs.js.map +1 -0
- package/src/llm/anthropic/utils/message_inputs.ts +10 -1
- package/src/llm/anthropic/utils/message_outputs.js.map +1 -0
- package/src/llm/anthropic/utils/output_parsers.js.map +1 -0
- package/src/llm/anthropic/utils/server-tool-inputs.test.ts +436 -0
- package/src/llm/anthropic/utils/tools.js.map +1 -0
- package/src/llm/bedrock/__tests__/bedrock-caching.test.js.map +1 -0
- package/src/llm/bedrock/__tests__/bedrock-caching.test.ts +166 -18
- package/src/llm/bedrock/cacheSupport.test.ts +99 -0
- package/src/llm/bedrock/cacheSupport.ts +53 -0
- package/src/llm/bedrock/index.js.map +1 -0
- package/src/llm/bedrock/index.ts +116 -41
- package/src/llm/bedrock/types.js.map +1 -0
- package/src/llm/bedrock/utils/index.js.map +1 -0
- package/src/llm/bedrock/utils/message_inputs.js.map +1 -0
- package/src/llm/bedrock/utils/message_outputs.js.map +1 -0
- package/src/llm/fake.js.map +1 -0
- package/src/llm/google/index.js.map +1 -0
- package/src/llm/google/types.js.map +1 -0
- package/src/llm/google/utils/common.js.map +1 -0
- package/src/llm/google/utils/tools.js.map +1 -0
- package/src/llm/google/utils/zod_to_genai_parameters.js.map +1 -0
- package/src/llm/openai/index.js.map +1 -0
- package/src/llm/openai/types.js.map +1 -0
- package/src/llm/openai/utils/index.js.map +1 -0
- package/src/llm/openai/utils/index.ts +31 -14
- package/src/llm/openai/utils/isReasoningModel.test.js.map +1 -0
- package/src/llm/openrouter/index.js.map +1 -0
- package/src/llm/openrouter/reasoning.test.js.map +1 -0
- package/src/llm/providers.js.map +1 -0
- package/src/llm/text.js.map +1 -0
- package/src/llm/vertexai/index.js.map +1 -0
- package/src/messages/__tests__/contextPruning.test.ts +228 -0
- package/src/messages/__tests__/tools.test.js.map +1 -0
- package/src/messages/cache.js.map +1 -0
- package/src/messages/cache.test.js.map +1 -0
- package/src/messages/cache.test.ts +62 -24
- package/src/messages/cache.ts +112 -0
- package/src/messages/content.js.map +1 -0
- package/src/messages/content.test.js.map +1 -0
- package/src/messages/contextPruning.ts +191 -0
- package/src/messages/contextPruningSettings.ts +90 -0
- package/src/messages/core.js.map +1 -0
- package/src/messages/ensureThinkingBlock.test.js.map +1 -0
- package/src/messages/format.js.map +1 -0
- package/src/messages/format.ts +164 -12
- package/src/messages/formatAgentMessages.skills.test.ts +413 -0
- package/src/messages/formatAgentMessages.test.js.map +1 -0
- package/src/messages/formatAgentMessages.tools.test.js.map +1 -0
- package/src/messages/formatMessage.test.js.map +1 -0
- package/src/messages/ids.js.map +1 -0
- package/src/messages/index.js.map +1 -0
- package/src/messages/index.ts +2 -0
- package/src/messages/labelContentByAgent.test.js.map +1 -0
- package/src/messages/prune.js.map +1 -0
- package/src/messages/prune.ts +661 -4
- package/src/messages/reducer.js.map +1 -0
- package/src/messages/shiftIndexTokenCountMap.test.js.map +1 -0
- package/src/messages/summarize.js.map +1 -0
- package/src/messages/summarize.test.js.map +1 -0
- package/src/messages/tools.js.map +1 -0
- package/src/mockStream.js.map +1 -0
- package/src/prompts/collab.js.map +1 -0
- package/src/prompts/index.js.map +1 -0
- package/src/prompts/taskmanager.js.map +1 -0
- package/src/run.js.map +1 -0
- package/src/run.ts +155 -1
- package/src/schemas/index.js.map +1 -0
- package/src/schemas/schema-preparation.test.js.map +1 -0
- package/src/schemas/validate.js.map +1 -0
- package/src/schemas/validate.test.js.map +1 -0
- package/src/scripts/abort.js.map +1 -0
- package/src/scripts/ant_web_search.js.map +1 -0
- package/src/scripts/ant_web_search_edge_case.js.map +1 -0
- package/src/scripts/ant_web_search_error_edge_case.js.map +1 -0
- package/src/scripts/args.js.map +1 -0
- package/src/scripts/bedrock-cache-debug.js.map +1 -0
- package/src/scripts/bedrock-content-aggregation-test.js.map +1 -0
- package/src/scripts/bedrock-merge-test.js.map +1 -0
- package/src/scripts/bedrock-parallel-tools-test.js.map +1 -0
- package/src/scripts/caching.js.map +1 -0
- package/src/scripts/cli.js.map +1 -0
- package/src/scripts/cli2.js.map +1 -0
- package/src/scripts/cli3.js.map +1 -0
- package/src/scripts/cli4.js.map +1 -0
- package/src/scripts/cli5.js.map +1 -0
- package/src/scripts/code_exec.js.map +1 -0
- package/src/scripts/code_exec_files.js.map +1 -0
- package/src/scripts/code_exec_multi_session.js.map +1 -0
- package/src/scripts/code_exec_ptc.js.map +1 -0
- package/src/scripts/code_exec_session.js.map +1 -0
- package/src/scripts/code_exec_simple.js.map +1 -0
- package/src/scripts/content.js.map +1 -0
- package/src/scripts/empty_input.js.map +1 -0
- package/src/scripts/handoff-test.js.map +1 -0
- package/src/scripts/image.js.map +1 -0
- package/src/scripts/memory.js.map +1 -0
- package/src/scripts/multi-agent-chain.js.map +1 -0
- package/src/scripts/multi-agent-chain.ts +2 -2
- package/src/scripts/multi-agent-conditional.js.map +1 -0
- package/src/scripts/multi-agent-document-review-chain.js.map +1 -0
- package/src/scripts/multi-agent-document-review-chain.ts +2 -2
- package/src/scripts/multi-agent-hybrid-flow.js.map +1 -0
- package/src/scripts/multi-agent-hybrid-flow.ts +4 -4
- package/src/scripts/multi-agent-parallel-start.js.map +1 -0
- package/src/scripts/multi-agent-parallel.js.map +1 -0
- package/src/scripts/multi-agent-parallel.ts +3 -3
- package/src/scripts/multi-agent-sequence.js.map +1 -0
- package/src/scripts/multi-agent-sequence.ts +3 -3
- package/src/scripts/multi-agent-subagent.ts +246 -0
- package/src/scripts/multi-agent-supervisor.js.map +1 -0
- package/src/scripts/multi-agent-supervisor.ts +5 -5
- package/src/scripts/multi-agent-test.js.map +1 -0
- package/src/scripts/parallel-asymmetric-tools-test.js.map +1 -0
- package/src/scripts/parallel-full-metadata-test.js.map +1 -0
- package/src/scripts/parallel-tools-test.js.map +1 -0
- package/src/scripts/poc-multi-agent-comprehensive.ts +8 -8
- package/src/scripts/programmatic_exec.js.map +1 -0
- package/src/scripts/programmatic_exec_agent.js.map +1 -0
- package/src/scripts/search.js.map +1 -0
- package/src/scripts/sequential-full-metadata-test.js.map +1 -0
- package/src/scripts/sequential-full-metadata-test.ts +2 -2
- package/src/scripts/simple.js.map +1 -0
- package/src/scripts/single-agent-metadata-test.js.map +1 -0
- package/src/scripts/stream.js.map +1 -0
- package/src/scripts/subagent-event-driven-debug.ts +190 -0
- package/src/scripts/subagent-tools-debug.ts +160 -0
- package/src/scripts/test-custom-prompt-key.js.map +1 -0
- package/src/scripts/test-custom-prompt-key.ts +3 -3
- package/src/scripts/test-handoff-input.js.map +1 -0
- package/src/scripts/test-handoff-input.ts +1 -1
- package/src/scripts/test-handoff-preamble.js.map +1 -0
- package/src/scripts/test-handoff-steering.js.map +1 -0
- package/src/scripts/test-handoff-steering.ts +3 -3
- package/src/scripts/test-multi-agent-list-handoff.js.map +1 -0
- package/src/scripts/test-multi-agent-list-handoff.ts +1 -1
- package/src/scripts/test-parallel-agent-labeling.js.map +1 -0
- package/src/scripts/test-parallel-agent-labeling.ts +3 -3
- package/src/scripts/test-parallel-handoffs.js.map +1 -0
- package/src/scripts/test-parallel-handoffs.ts +2 -2
- package/src/scripts/test-thinking-handoff-bedrock.js.map +1 -0
- package/src/scripts/test-thinking-handoff-bedrock.ts +1 -1
- package/src/scripts/test-thinking-handoff.js.map +1 -0
- package/src/scripts/test-thinking-handoff.ts +1 -1
- package/src/scripts/test-thinking-to-thinking-handoff-bedrock.js.map +1 -0
- package/src/scripts/test-thinking-to-thinking-handoff-bedrock.ts +1 -1
- package/src/scripts/test-tool-before-handoff-role-order.js.map +1 -0
- package/src/scripts/test-tool-before-handoff-role-order.ts +1 -1
- package/src/scripts/test-tools-before-handoff.js.map +1 -0
- package/src/scripts/test-tools-before-handoff.ts +1 -1
- package/src/scripts/test_code_api.js.map +1 -0
- package/src/scripts/thinking-bedrock.js.map +1 -0
- package/src/scripts/thinking-vertexai.js.map +1 -0
- package/src/scripts/thinking.js.map +1 -0
- package/src/scripts/tool_search.js.map +1 -0
- package/src/scripts/tools.js.map +1 -0
- package/src/specs/agent-handoffs-bedrock.integration.test.js.map +1 -0
- package/src/specs/agent-handoffs.test.js.map +1 -0
- package/src/specs/agent-handoffs.test.ts +26 -483
- package/src/specs/anthropic.simple.test.js.map +1 -0
- package/src/specs/anthropic.simple.test.ts +61 -0
- package/src/specs/azure.simple.test.js.map +1 -0
- package/src/specs/cache.simple.test.js.map +1 -0
- package/src/specs/custom-event-await.test.js.map +1 -0
- package/src/specs/deepseek.simple.test.js.map +1 -0
- package/src/specs/emergency-prune.test.js.map +1 -0
- package/src/specs/moonshot.simple.test.js.map +1 -0
- package/src/specs/multi-agent-summarization.test.ts +396 -0
- package/src/specs/observability.integration.test.js.map +1 -0
- package/src/specs/openai.simple.test.js.map +1 -0
- package/src/specs/openrouter.simple.test.js.map +1 -0
- package/src/specs/prune.orphans.test.ts +248 -0
- package/src/specs/prune.test.js.map +1 -0
- package/src/specs/prune.test.ts +104 -16
- package/src/specs/reasoning.test.js.map +1 -0
- package/src/specs/spec.utils.js.map +1 -0
- package/src/specs/thinking-handoff.test.js.map +1 -0
- package/src/specs/thinking-handoff.test.ts +19 -19
- package/src/specs/thinking-prune.test.js.map +1 -0
- package/src/specs/token-distribution-edge-case.test.js.map +1 -0
- package/src/specs/token-memoization.test.js.map +1 -0
- package/src/specs/tokens.test.js.map +1 -0
- package/src/specs/tool-error.test.js.map +1 -0
- package/src/splitStream.js.map +1 -0
- package/src/splitStream.test.js.map +1 -0
- package/src/stream.js.map +1 -0
- package/src/stream.test.js.map +1 -0
- package/src/test/mockTools.js.map +1 -0
- package/src/tools/BashExecutor.ts +281 -0
- package/src/tools/BashProgrammaticToolCalling.ts +397 -0
- package/src/tools/BrowserTools.js.map +1 -0
- package/src/tools/Calculator.js.map +1 -0
- package/src/tools/Calculator.test.js.map +1 -0
- package/src/tools/CodeExecutor.js.map +1 -0
- package/src/tools/CodeExecutor.ts +62 -54
- package/src/tools/ProgrammaticToolCalling.js.map +1 -0
- package/src/tools/ProgrammaticToolCalling.ts +29 -14
- package/src/tools/ReadFile.ts +39 -0
- package/src/tools/SkillTool.ts +46 -0
- package/src/tools/StreamingToolCallBuffer.js.map +1 -0
- package/src/tools/SubagentTool.ts +100 -0
- package/src/tools/ToolNode.js.map +1 -0
- package/src/tools/ToolNode.ts +548 -26
- package/src/tools/ToolSearch.js.map +1 -0
- package/src/tools/__tests__/BashExecutor.test.ts +49 -0
- package/src/tools/__tests__/BrowserTools.test.js.map +1 -0
- package/src/tools/__tests__/CodeExecutor.test.ts +37 -36
- package/src/tools/__tests__/ProgrammaticToolCalling.integration.test.js.map +1 -0
- package/src/tools/__tests__/ProgrammaticToolCalling.test.js.map +1 -0
- package/src/tools/__tests__/ProgrammaticToolCalling.test.ts +60 -0
- package/src/tools/__tests__/ReadFile.test.ts +44 -0
- package/src/tools/__tests__/SkillTool.test.ts +442 -0
- package/src/tools/__tests__/StreamingToolCallBuffer.test.js.map +1 -0
- package/src/tools/__tests__/SubagentExecutor.test.ts +1148 -0
- package/src/tools/__tests__/SubagentTool.test.ts +149 -0
- package/src/tools/__tests__/ToolApproval.test.js.map +1 -0
- package/src/tools/__tests__/ToolNode.outputReferences.test.ts +1438 -0
- package/src/tools/__tests__/ToolNode.recovery.test.js.map +1 -0
- package/src/tools/__tests__/ToolNode.session.test.js.map +1 -0
- package/src/tools/__tests__/ToolSearch.integration.test.js.map +1 -0
- package/src/tools/__tests__/ToolSearch.test.js.map +1 -0
- package/src/tools/__tests__/annotateMessagesForLLM.test.ts +479 -0
- package/src/tools/__tests__/handlers.test.js.map +1 -0
- package/src/tools/__tests__/skillCatalog.test.ts +161 -0
- package/src/tools/__tests__/subagentHooks.test.ts +210 -0
- package/src/tools/__tests__/toolOutputReferences.test.ts +415 -0
- package/src/tools/__tests__/truncation-recovery.integration.test.js.map +1 -0
- package/src/tools/handlers.js.map +1 -0
- package/src/tools/schema.js.map +1 -0
- package/src/tools/search/anthropic.js.map +1 -0
- package/src/tools/search/content.js.map +1 -0
- package/src/tools/search/content.test.js.map +1 -0
- package/src/tools/search/firecrawl.js.map +1 -0
- package/src/tools/search/format.js.map +1 -0
- package/src/tools/search/highlights.js.map +1 -0
- package/src/tools/search/index.js.map +1 -0
- package/src/tools/search/jina-reranker.test.js.map +1 -0
- package/src/tools/search/rerankers.js.map +1 -0
- package/src/tools/search/schema.js.map +1 -0
- package/src/tools/search/search.js.map +1 -0
- package/src/tools/search/search.ts +12 -2
- package/src/tools/search/serper-scraper.js.map +1 -0
- package/src/tools/search/tavily-scraper.ts +235 -0
- package/src/tools/search/tavily-search.ts +424 -0
- package/src/tools/search/tavily.test.ts +965 -0
- package/src/tools/search/test.js.map +1 -0
- package/src/tools/search/tool.js.map +1 -0
- package/src/tools/search/tool.ts +36 -2
- package/src/tools/search/types.js.map +1 -0
- package/src/tools/search/types.ts +133 -8
- package/src/tools/search/utils.js.map +1 -0
- package/src/tools/search/utils.ts +13 -5
- package/src/tools/skillCatalog.ts +126 -0
- package/src/tools/subagent/SubagentExecutor.ts +676 -0
- package/src/tools/subagent/index.ts +13 -0
- package/src/tools/subagent/types.test.ts +70 -0
- package/src/tools/subagent/types.ts +115 -0
- package/src/tools/toolOutputReferences.ts +825 -0
- package/src/types/agent-cache.ts +73 -0
- package/src/types/graph.js.map +1 -0
- package/src/types/graph.test.js.map +1 -0
- package/src/types/graph.ts +171 -20
- package/src/types/index.js.map +1 -0
- package/src/types/index.ts +3 -0
- package/src/types/llm.js.map +1 -0
- package/src/types/messages.js.map +1 -0
- package/src/types/messages.ts +27 -0
- package/src/types/run.js.map +1 -0
- package/src/types/run.ts +22 -0
- package/src/types/skill.ts +11 -0
- package/src/types/stream.js.map +1 -0
- package/src/types/tools.js.map +1 -0
- package/src/types/tools.ts +118 -0
- package/src/utils/__tests__/truncation.test.ts +66 -0
- package/src/utils/contextAnalytics.js.map +1 -0
- package/src/utils/contextAnalytics.test.js.map +1 -0
- package/src/utils/events.js.map +1 -0
- package/src/utils/graph.js.map +1 -0
- package/src/utils/handlers.js.map +1 -0
- package/src/utils/index.js.map +1 -0
- package/src/utils/index.ts +1 -3
- package/src/utils/llm.js.map +1 -0
- package/src/utils/llmConfig.js.map +1 -0
- package/src/utils/logging.js.map +1 -0
- package/src/utils/misc.js.map +1 -0
- package/src/utils/run.js.map +1 -0
- package/src/utils/schema.js.map +1 -0
- package/src/utils/title.js.map +1 -0
- package/src/utils/tokens.js.map +1 -0
- package/src/utils/toonFormat.js.map +1 -0
- package/src/utils/truncation.ts +154 -0
- package/dist/cjs/common/spawnPath.cjs +0 -104
- package/dist/cjs/common/spawnPath.cjs.map +0 -1
- package/dist/cjs/content/ArtifactStore.cjs +0 -579
- package/dist/cjs/content/ArtifactStore.cjs.map +0 -1
- package/dist/cjs/content/ContentStore.cjs +0 -638
- package/dist/cjs/content/ContentStore.cjs.map +0 -1
- package/dist/cjs/content/contentAnalyzer.cjs +0 -91
- package/dist/cjs/content/contentAnalyzer.cjs.map +0 -1
- package/dist/cjs/content/index.cjs +0 -20
- package/dist/cjs/content/index.cjs.map +0 -1
- package/dist/cjs/content/mcpAutoCache.cjs +0 -115
- package/dist/cjs/content/mcpAutoCache.cjs.map +0 -1
- package/dist/cjs/graphs/HandoffRegistry.cjs +0 -143
- package/dist/cjs/graphs/HandoffRegistry.cjs.map +0 -1
- package/dist/cjs/providers/a2a/A2ACapabilityProvider.cjs +0 -288
- package/dist/cjs/providers/a2a/A2ACapabilityProvider.cjs.map +0 -1
- package/dist/cjs/providers/a2a/client.cjs +0 -92
- package/dist/cjs/providers/a2a/client.cjs.map +0 -1
- package/dist/cjs/providers/a2a/config.cjs +0 -38
- package/dist/cjs/providers/a2a/config.cjs.map +0 -1
- package/dist/cjs/providers/capabilityNaming.cjs +0 -43
- package/dist/cjs/providers/capabilityNaming.cjs.map +0 -1
- package/dist/cjs/providers/mcp/MCPCapabilityProvider.cjs +0 -244
- package/dist/cjs/providers/mcp/MCPCapabilityProvider.cjs.map +0 -1
- package/dist/cjs/providers/mcp/config.cjs +0 -42
- package/dist/cjs/providers/mcp/config.cjs.map +0 -1
- package/dist/cjs/providers/mcp/transport.cjs +0 -65
- package/dist/cjs/providers/mcp/transport.cjs.map +0 -1
- package/dist/cjs/providers/tools-server/ToolsServerCapabilityProvider.cjs +0 -128
- package/dist/cjs/providers/tools-server/ToolsServerCapabilityProvider.cjs.map +0 -1
- package/dist/cjs/providers/types.cjs +0 -51
- package/dist/cjs/providers/types.cjs.map +0 -1
- package/dist/cjs/tools/artifacts/schema.cjs +0 -86
- package/dist/cjs/tools/artifacts/schema.cjs.map +0 -1
- package/dist/cjs/tools/artifacts/tool.cjs +0 -219
- package/dist/cjs/tools/artifacts/tool.cjs.map +0 -1
- package/dist/cjs/tools/fileSearch/formatter.cjs +0 -93
- package/dist/cjs/tools/fileSearch/formatter.cjs.map +0 -1
- package/dist/cjs/tools/fileSearch/ragClient.cjs +0 -102
- package/dist/cjs/tools/fileSearch/ragClient.cjs.map +0 -1
- package/dist/cjs/tools/fileSearch/schema.cjs +0 -18
- package/dist/cjs/tools/fileSearch/schema.cjs.map +0 -1
- package/dist/cjs/tools/fileSearch/tool.cjs +0 -155
- package/dist/cjs/tools/fileSearch/tool.cjs.map +0 -1
- package/dist/cjs/tools/proxyTool.cjs +0 -102
- package/dist/cjs/tools/proxyTool.cjs.map +0 -1
- package/dist/cjs/utils/childAgentContext.cjs +0 -242
- package/dist/cjs/utils/childAgentContext.cjs.map +0 -1
- package/dist/cjs/utils/credentials.cjs +0 -142
- package/dist/cjs/utils/credentials.cjs.map +0 -1
- package/dist/cjs/utils/httpClient.cjs +0 -74
- package/dist/cjs/utils/httpClient.cjs.map +0 -1
- package/dist/cjs/utils/toolManifest.cjs +0 -100
- package/dist/cjs/utils/toolManifest.cjs.map +0 -1
- package/dist/esm/common/spawnPath.mjs +0 -95
- package/dist/esm/common/spawnPath.mjs.map +0 -1
- package/dist/esm/content/ArtifactStore.mjs +0 -576
- package/dist/esm/content/ArtifactStore.mjs.map +0 -1
- package/dist/esm/content/ContentStore.mjs +0 -635
- package/dist/esm/content/ContentStore.mjs.map +0 -1
- package/dist/esm/content/contentAnalyzer.mjs +0 -87
- package/dist/esm/content/contentAnalyzer.mjs.map +0 -1
- package/dist/esm/content/index.mjs +0 -5
- package/dist/esm/content/mcpAutoCache.mjs +0 -111
- package/dist/esm/content/mcpAutoCache.mjs.map +0 -1
- package/dist/esm/graphs/HandoffRegistry.mjs +0 -141
- package/dist/esm/graphs/HandoffRegistry.mjs.map +0 -1
- package/dist/esm/providers/a2a/A2ACapabilityProvider.mjs +0 -281
- package/dist/esm/providers/a2a/A2ACapabilityProvider.mjs.map +0 -1
- package/dist/esm/providers/a2a/client.mjs +0 -88
- package/dist/esm/providers/a2a/client.mjs.map +0 -1
- package/dist/esm/providers/a2a/config.mjs +0 -35
- package/dist/esm/providers/a2a/config.mjs.map +0 -1
- package/dist/esm/providers/capabilityNaming.mjs +0 -39
- package/dist/esm/providers/capabilityNaming.mjs.map +0 -1
- package/dist/esm/providers/mcp/MCPCapabilityProvider.mjs +0 -240
- package/dist/esm/providers/mcp/MCPCapabilityProvider.mjs.map +0 -1
- package/dist/esm/providers/mcp/config.mjs +0 -39
- package/dist/esm/providers/mcp/config.mjs.map +0 -1
- package/dist/esm/providers/mcp/transport.mjs +0 -63
- package/dist/esm/providers/mcp/transport.mjs.map +0 -1
- package/dist/esm/providers/tools-server/ToolsServerCapabilityProvider.mjs +0 -126
- package/dist/esm/providers/tools-server/ToolsServerCapabilityProvider.mjs.map +0 -1
- package/dist/esm/providers/types.mjs +0 -51
- package/dist/esm/providers/types.mjs.map +0 -1
- package/dist/esm/tools/artifacts/schema.mjs +0 -79
- package/dist/esm/tools/artifacts/schema.mjs.map +0 -1
- package/dist/esm/tools/artifacts/tool.mjs +0 -213
- package/dist/esm/tools/artifacts/tool.mjs.map +0 -1
- package/dist/esm/tools/fileSearch/formatter.mjs +0 -90
- package/dist/esm/tools/fileSearch/formatter.mjs.map +0 -1
- package/dist/esm/tools/fileSearch/ragClient.mjs +0 -98
- package/dist/esm/tools/fileSearch/ragClient.mjs.map +0 -1
- package/dist/esm/tools/fileSearch/schema.mjs +0 -15
- package/dist/esm/tools/fileSearch/schema.mjs.map +0 -1
- package/dist/esm/tools/fileSearch/tool.mjs +0 -152
- package/dist/esm/tools/fileSearch/tool.mjs.map +0 -1
- package/dist/esm/tools/proxyTool.mjs +0 -100
- package/dist/esm/tools/proxyTool.mjs.map +0 -1
- package/dist/esm/utils/childAgentContext.mjs +0 -237
- package/dist/esm/utils/childAgentContext.mjs.map +0 -1
- package/dist/esm/utils/credentials.mjs +0 -135
- package/dist/esm/utils/credentials.mjs.map +0 -1
- package/dist/esm/utils/httpClient.mjs +0 -70
- package/dist/esm/utils/httpClient.mjs.map +0 -1
- package/dist/esm/utils/toolManifest.mjs +0 -96
- package/dist/esm/utils/toolManifest.mjs.map +0 -1
- package/dist/types/common/spawnPath.d.ts +0 -59
- package/dist/types/content/ArtifactStore.d.ts +0 -223
- package/dist/types/content/ContentStore.d.ts +0 -140
- package/dist/types/content/contentAnalyzer.d.ts +0 -38
- package/dist/types/content/index.d.ts +0 -24
- package/dist/types/content/mcpAutoCache.d.ts +0 -89
- package/dist/types/content/types.d.ts +0 -75
- package/dist/types/graphs/HandoffRegistry.d.ts +0 -97
- package/dist/types/providers/a2a/A2ACapabilityProvider.d.ts +0 -89
- package/dist/types/providers/a2a/client.d.ts +0 -47
- package/dist/types/providers/a2a/config.d.ts +0 -18
- package/dist/types/providers/a2a/index.d.ts +0 -6
- package/dist/types/providers/a2a/types.d.ts +0 -173
- package/dist/types/providers/capabilityNaming.d.ts +0 -25
- package/dist/types/providers/index.d.ts +0 -12
- package/dist/types/providers/mcp/MCPCapabilityProvider.d.ts +0 -54
- package/dist/types/providers/mcp/config.d.ts +0 -20
- package/dist/types/providers/mcp/index.d.ts +0 -5
- package/dist/types/providers/mcp/transport.d.ts +0 -18
- package/dist/types/providers/mcp/types.d.ts +0 -112
- package/dist/types/providers/tools-server/ToolsServerCapabilityProvider.d.ts +0 -59
- package/dist/types/providers/tools-server/index.d.ts +0 -1
- package/dist/types/providers/types.d.ts +0 -184
- package/dist/types/tools/artifacts/index.d.ts +0 -3
- package/dist/types/tools/artifacts/schema.d.ts +0 -63
- package/dist/types/tools/artifacts/tool.d.ts +0 -16
- package/dist/types/tools/artifacts/types.d.ts +0 -127
- package/dist/types/tools/fileSearch/formatter.d.ts +0 -25
- package/dist/types/tools/fileSearch/index.d.ts +0 -5
- package/dist/types/tools/fileSearch/ragClient.d.ts +0 -32
- package/dist/types/tools/fileSearch/schema.d.ts +0 -13
- package/dist/types/tools/fileSearch/tool.d.ts +0 -18
- package/dist/types/tools/fileSearch/types.d.ts +0 -139
- package/dist/types/tools/proxyTool.d.ts +0 -62
- package/dist/types/utils/childAgentContext.d.ts +0 -99
- package/dist/types/utils/credentials.d.ts +0 -77
- package/dist/types/utils/httpClient.d.ts +0 -46
- package/dist/types/utils/toolManifest.d.ts +0 -49
- package/src/common/__tests__/spawnPath.test.ts +0 -110
- package/src/common/spawnPath.ts +0 -101
- package/src/content/ArtifactStore.ts +0 -782
- package/src/content/ContentStore.ts +0 -753
- package/src/content/contentAnalyzer.ts +0 -105
- package/src/content/index.ts +0 -51
- package/src/content/mcpAutoCache.ts +0 -185
- package/src/content/types.ts +0 -82
- package/src/graphs/HandoffRegistry.ts +0 -199
- package/src/graphs/__tests__/HandoffRegistry.test.ts +0 -410
- package/src/graphs/__tests__/multi-agent-delegate.test.ts +0 -458
- package/src/graphs/__tests__/multi-agent-edges.test.ts +0 -276
- package/src/graphs/__tests__/multi-agent-nested-subgraph.test.ts +0 -221
- package/src/graphs/handoffValidation.test.ts +0 -353
- package/src/providers/__tests__/ToolsServerCapabilityProvider.integration.spec.ts +0 -79
- package/src/providers/__tests__/ToolsServerCapabilityProvider.test.ts +0 -271
- package/src/providers/__tests__/types.test.ts +0 -64
- package/src/providers/a2a/A2ACapabilityProvider.ts +0 -384
- package/src/providers/a2a/__tests__/A2ACapabilityProvider.integration.spec.ts +0 -345
- package/src/providers/a2a/__tests__/A2ACapabilityProvider.test.ts +0 -460
- package/src/providers/a2a/client.ts +0 -115
- package/src/providers/a2a/config.ts +0 -40
- package/src/providers/a2a/index.ts +0 -29
- package/src/providers/a2a/types.ts +0 -191
- package/src/providers/capabilityNaming.ts +0 -42
- package/src/providers/index.ts +0 -68
- package/src/providers/mcp/MCPCapabilityProvider.ts +0 -345
- package/src/providers/mcp/__tests__/MCPCapabilityProvider.integration.spec.ts +0 -386
- package/src/providers/mcp/__tests__/MCPCapabilityProvider.test.ts +0 -371
- package/src/providers/mcp/config.ts +0 -45
- package/src/providers/mcp/index.ts +0 -21
- package/src/providers/mcp/transport.ts +0 -76
- package/src/providers/mcp/types.ts +0 -139
- package/src/providers/tools-server/ToolsServerCapabilityProvider.ts +0 -249
- package/src/providers/tools-server/index.ts +0 -1
- package/src/providers/types.ts +0 -204
- package/src/scripts/test-bedrock-handoff-autonomous.ts +0 -267
- package/src/scripts/test-handoff-preamble.ts +0 -278
- package/src/specs/agent-handoffs-bedrock.integration.test.ts +0 -415
- package/src/tools/artifacts/__tests__/tool.test.ts +0 -259
- package/src/tools/artifacts/index.ts +0 -33
- package/src/tools/artifacts/schema.ts +0 -99
- package/src/tools/artifacts/tool.ts +0 -289
- package/src/tools/artifacts/types.ts +0 -162
- package/src/tools/fileSearch/__tests__/tool.test.ts +0 -261
- package/src/tools/fileSearch/formatter.ts +0 -129
- package/src/tools/fileSearch/index.ts +0 -23
- package/src/tools/fileSearch/ragClient.ts +0 -137
- package/src/tools/fileSearch/schema.ts +0 -19
- package/src/tools/fileSearch/tool.ts +0 -207
- package/src/tools/fileSearch/types.ts +0 -149
- package/src/tools/proxyTool.ts +0 -166
- package/src/utils/__tests__/childAgentContext.test.ts +0 -217
- package/src/utils/__tests__/credentials.test.ts +0 -130
- package/src/utils/__tests__/httpClient.test.ts +0 -75
- package/src/utils/__tests__/toolManifest.test.ts +0 -116
- package/src/utils/childAgentContext.ts +0 -259
- package/src/utils/credentials.ts +0 -157
- package/src/utils/httpClient.ts +0 -92
- package/src/utils/toolManifest.ts +0 -109
- /package/dist/esm/{content → langchain}/index.mjs.map +0 -0
|
@@ -1,353 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Unit tests for MultiAgentGraph handoff validation and pre-handoff compaction.
|
|
3
|
-
*
|
|
4
|
-
* These tests exercise the handoff logic (destination validation, compaction threshold,
|
|
5
|
-
* briefing generation, error formatting) without instantiating the full MultiAgentGraph.
|
|
6
|
-
* We test the helper functions directly and verify the behavioral patterns that
|
|
7
|
-
* the graph's agent node closure relies on.
|
|
8
|
-
*/
|
|
9
|
-
import {
|
|
10
|
-
HumanMessage,
|
|
11
|
-
AIMessage,
|
|
12
|
-
SystemMessage,
|
|
13
|
-
ToolMessage,
|
|
14
|
-
} from '@langchain/core/messages';
|
|
15
|
-
import {
|
|
16
|
-
summarize,
|
|
17
|
-
createEmergencySummary,
|
|
18
|
-
buildFullSummaryPrompt,
|
|
19
|
-
formatMessagesForSummary,
|
|
20
|
-
} from '@/messages';
|
|
21
|
-
|
|
22
|
-
// ---------------------------------------------------------------------------
|
|
23
|
-
// 1. Handoff destination validation logic
|
|
24
|
-
// ---------------------------------------------------------------------------
|
|
25
|
-
describe('handoff destination validation', () => {
|
|
26
|
-
it('detects non-existent agent in contexts map', () => {
|
|
27
|
-
const agentContexts = new Map([
|
|
28
|
-
['agent-a', { agentId: 'agent-a', name: 'Agent A' }],
|
|
29
|
-
['agent-b', { agentId: 'agent-b', name: 'Agent B' }],
|
|
30
|
-
]);
|
|
31
|
-
|
|
32
|
-
const handoffDest = 'agent-c';
|
|
33
|
-
expect(agentContexts.has(handoffDest)).toBe(false);
|
|
34
|
-
|
|
35
|
-
const availableAgents = Array.from(agentContexts.keys()).join(', ');
|
|
36
|
-
expect(availableAgents).toBe('agent-a, agent-b');
|
|
37
|
-
});
|
|
38
|
-
|
|
39
|
-
it('passes validation for existing agent', () => {
|
|
40
|
-
const agentContexts = new Map([
|
|
41
|
-
['agent-a', { agentId: 'agent-a', name: 'Agent A' }],
|
|
42
|
-
]);
|
|
43
|
-
|
|
44
|
-
expect(agentContexts.has('agent-a')).toBe(true);
|
|
45
|
-
});
|
|
46
|
-
|
|
47
|
-
it('handles empty contexts map', () => {
|
|
48
|
-
const agentContexts = new Map<string, { agentId: string; name: string }>();
|
|
49
|
-
expect(agentContexts.has('any-agent')).toBe(false);
|
|
50
|
-
|
|
51
|
-
const availableAgents = Array.from(agentContexts.keys()).join(', ');
|
|
52
|
-
expect(availableAgents).toBe('');
|
|
53
|
-
});
|
|
54
|
-
});
|
|
55
|
-
|
|
56
|
-
// ---------------------------------------------------------------------------
|
|
57
|
-
// 2. Pre-handoff compaction threshold
|
|
58
|
-
// ---------------------------------------------------------------------------
|
|
59
|
-
describe('pre-handoff compaction threshold', () => {
|
|
60
|
-
it('triggers compaction when context exceeds 70% of receiver budget', () => {
|
|
61
|
-
const receiverBudget = 100000;
|
|
62
|
-
const currentSize = 75000; // 75%
|
|
63
|
-
expect(currentSize > receiverBudget * 0.7).toBe(true);
|
|
64
|
-
});
|
|
65
|
-
|
|
66
|
-
it('skips compaction when context fits within 70% of receiver budget', () => {
|
|
67
|
-
const receiverBudget = 100000;
|
|
68
|
-
const currentSize = 60000; // 60%
|
|
69
|
-
expect(currentSize > receiverBudget * 0.7).toBe(false);
|
|
70
|
-
});
|
|
71
|
-
|
|
72
|
-
it('triggers compaction at exactly the boundary (>70%)', () => {
|
|
73
|
-
const receiverBudget = 100000;
|
|
74
|
-
// Exactly 70% should NOT trigger (condition is strictly >)
|
|
75
|
-
expect(70000 > receiverBudget * 0.7).toBe(false);
|
|
76
|
-
// Just above 70% should trigger
|
|
77
|
-
expect(70001 > receiverBudget * 0.7).toBe(true);
|
|
78
|
-
});
|
|
79
|
-
|
|
80
|
-
it('computes summary budget as 20% of receiver budget', () => {
|
|
81
|
-
const receiverBudget = 100000;
|
|
82
|
-
const summaryBudget = Math.floor(receiverBudget * 0.2);
|
|
83
|
-
expect(summaryBudget).toBe(20000);
|
|
84
|
-
});
|
|
85
|
-
});
|
|
86
|
-
|
|
87
|
-
// ---------------------------------------------------------------------------
|
|
88
|
-
// 3. Handoff briefing via summarize (multi-agent aware)
|
|
89
|
-
// ---------------------------------------------------------------------------
|
|
90
|
-
describe('handoff briefing generation', () => {
|
|
91
|
-
it('generates multi-agent aware briefing', async () => {
|
|
92
|
-
const messages = [
|
|
93
|
-
new HumanMessage('Analyze the data'),
|
|
94
|
-
new AIMessage('I found 3 key patterns...'),
|
|
95
|
-
new HumanMessage('Can you elaborate on pattern 2?'),
|
|
96
|
-
new AIMessage('Pattern 2 shows...'),
|
|
97
|
-
];
|
|
98
|
-
|
|
99
|
-
const callback = jest
|
|
100
|
-
.fn()
|
|
101
|
-
.mockResolvedValue(
|
|
102
|
-
'## 5. Agent Workflow State\n- Agent A analyzed data and found 3 patterns'
|
|
103
|
-
);
|
|
104
|
-
|
|
105
|
-
const result = await summarize(messages, callback, {
|
|
106
|
-
isMultiAgent: true,
|
|
107
|
-
agentWorkflowState: {
|
|
108
|
-
currentAgentId: 'agent-b',
|
|
109
|
-
agentChain: ['agent-a', 'agent-b'],
|
|
110
|
-
pendingAgents: [],
|
|
111
|
-
},
|
|
112
|
-
summaryBudget: 2000,
|
|
113
|
-
});
|
|
114
|
-
|
|
115
|
-
// Without a tokenCounter the budget check is skipped, so full tier is returned
|
|
116
|
-
expect(result.tier).toBe('full');
|
|
117
|
-
expect(result.summary).toContain('Agent Workflow State');
|
|
118
|
-
// Verify callback was called with the full prompt containing agent workflow info
|
|
119
|
-
expect(callback).toHaveBeenCalledWith(
|
|
120
|
-
expect.stringContaining('Agent Workflow State'),
|
|
121
|
-
expect.any(Number)
|
|
122
|
-
);
|
|
123
|
-
});
|
|
124
|
-
|
|
125
|
-
it('includes agent chain in the prompt', () => {
|
|
126
|
-
const conversation = formatMessagesForSummary([new HumanMessage('Hello')]);
|
|
127
|
-
const prompt = buildFullSummaryPrompt(conversation, {
|
|
128
|
-
isMultiAgent: true,
|
|
129
|
-
agentWorkflowState: {
|
|
130
|
-
currentAgentId: 'agent-b',
|
|
131
|
-
agentChain: ['agent-a', 'agent-b'],
|
|
132
|
-
pendingAgents: ['agent-c'],
|
|
133
|
-
},
|
|
134
|
-
});
|
|
135
|
-
|
|
136
|
-
expect(prompt).toContain('Current agent: agent-b');
|
|
137
|
-
expect(prompt).toContain('Agent chain: agent-a -> agent-b');
|
|
138
|
-
expect(prompt).toContain('Pending agents: agent-c');
|
|
139
|
-
});
|
|
140
|
-
|
|
141
|
-
it('shows N/A for single-agent conversations', () => {
|
|
142
|
-
const conversation = formatMessagesForSummary([new HumanMessage('Hello')]);
|
|
143
|
-
const prompt = buildFullSummaryPrompt(conversation);
|
|
144
|
-
|
|
145
|
-
expect(prompt).toContain('N/A (single-agent conversation)');
|
|
146
|
-
});
|
|
147
|
-
});
|
|
148
|
-
|
|
149
|
-
// ---------------------------------------------------------------------------
|
|
150
|
-
// 4. Emergency briefing fallback
|
|
151
|
-
// ---------------------------------------------------------------------------
|
|
152
|
-
describe('emergency briefing fallback', () => {
|
|
153
|
-
it('generates briefing without LLM when callback fails', async () => {
|
|
154
|
-
const messages = [
|
|
155
|
-
new HumanMessage('Analyze this'),
|
|
156
|
-
new AIMessage('Here is the analysis...'),
|
|
157
|
-
];
|
|
158
|
-
|
|
159
|
-
const failingCallback = jest
|
|
160
|
-
.fn()
|
|
161
|
-
.mockRejectedValue(new Error('LLM timeout'));
|
|
162
|
-
const result = await summarize(messages, failingCallback);
|
|
163
|
-
|
|
164
|
-
expect(result.tier).toBe('emergency');
|
|
165
|
-
expect(result.summary).toContain('[Emergency Context Summary]');
|
|
166
|
-
expect(result.summary).toContain('Analyze this');
|
|
167
|
-
});
|
|
168
|
-
|
|
169
|
-
it('falls to emergency when both full and simple callbacks fail', async () => {
|
|
170
|
-
let callCount = 0;
|
|
171
|
-
const failingCallback = jest.fn().mockImplementation(() => {
|
|
172
|
-
callCount++;
|
|
173
|
-
throw new Error(`Failure #${callCount}`);
|
|
174
|
-
});
|
|
175
|
-
|
|
176
|
-
const messages = [
|
|
177
|
-
new HumanMessage('Do something'),
|
|
178
|
-
new AIMessage('Working on it...'),
|
|
179
|
-
new ToolMessage({
|
|
180
|
-
content: 'result',
|
|
181
|
-
tool_call_id: 'tc-1',
|
|
182
|
-
name: 'search',
|
|
183
|
-
}),
|
|
184
|
-
];
|
|
185
|
-
|
|
186
|
-
const result = await summarize(messages, failingCallback);
|
|
187
|
-
|
|
188
|
-
expect(result.tier).toBe('emergency');
|
|
189
|
-
expect(result.summary).toContain('Do something');
|
|
190
|
-
expect(result.summary).toContain('Working on it...');
|
|
191
|
-
expect(result.summary).toContain('search');
|
|
192
|
-
expect(result.messagesCompacted).toBe(3);
|
|
193
|
-
});
|
|
194
|
-
|
|
195
|
-
it('createEmergencySummary captures first user message and last AI message', () => {
|
|
196
|
-
const messages = [
|
|
197
|
-
new HumanMessage('First user message'),
|
|
198
|
-
new AIMessage('First AI response'),
|
|
199
|
-
new HumanMessage('Second user message'),
|
|
200
|
-
new AIMessage('Second AI response'),
|
|
201
|
-
];
|
|
202
|
-
|
|
203
|
-
const summary = createEmergencySummary(messages);
|
|
204
|
-
|
|
205
|
-
expect(summary).toContain('[Emergency Context Summary]');
|
|
206
|
-
expect(summary).toContain('Original request: First user message');
|
|
207
|
-
expect(summary).toContain('Last response: Second AI response');
|
|
208
|
-
expect(summary).toContain('Tools used: none');
|
|
209
|
-
expect(summary).toContain('Messages compacted: 4');
|
|
210
|
-
});
|
|
211
|
-
|
|
212
|
-
it('createEmergencySummary collects unique tool names', () => {
|
|
213
|
-
const messages = [
|
|
214
|
-
new HumanMessage('Test'),
|
|
215
|
-
new ToolMessage({ content: 'ok', tool_call_id: 'tc-1', name: 'search' }),
|
|
216
|
-
new ToolMessage({ content: 'ok', tool_call_id: 'tc-2', name: 'search' }),
|
|
217
|
-
new ToolMessage({
|
|
218
|
-
content: 'ok',
|
|
219
|
-
tool_call_id: 'tc-3',
|
|
220
|
-
name: 'calculator',
|
|
221
|
-
}),
|
|
222
|
-
];
|
|
223
|
-
|
|
224
|
-
const summary = createEmergencySummary(messages);
|
|
225
|
-
|
|
226
|
-
expect(summary).toContain('search');
|
|
227
|
-
expect(summary).toContain('calculator');
|
|
228
|
-
});
|
|
229
|
-
});
|
|
230
|
-
|
|
231
|
-
// ---------------------------------------------------------------------------
|
|
232
|
-
// 5. Handoff error ToolMessage format
|
|
233
|
-
// ---------------------------------------------------------------------------
|
|
234
|
-
describe('handoff error message format', () => {
|
|
235
|
-
it('creates properly formatted error ToolMessage', () => {
|
|
236
|
-
const availableAgents = 'agent-a, agent-b, agent-c';
|
|
237
|
-
const handoffDest = 'nonexistent-agent';
|
|
238
|
-
|
|
239
|
-
const errorMsg = new ToolMessage({
|
|
240
|
-
content: `Transfer failed: agent "${handoffDest}" does not exist. Available agents: ${availableAgents}. Please choose a valid agent to transfer to.`,
|
|
241
|
-
tool_call_id: 'call-123',
|
|
242
|
-
name: `transfer_to_${handoffDest}`,
|
|
243
|
-
});
|
|
244
|
-
|
|
245
|
-
expect(errorMsg.content).toContain('does not exist');
|
|
246
|
-
expect(errorMsg.content).toContain(availableAgents);
|
|
247
|
-
expect(errorMsg.tool_call_id).toBe('call-123');
|
|
248
|
-
expect(errorMsg.name).toBe('transfer_to_nonexistent-agent');
|
|
249
|
-
});
|
|
250
|
-
|
|
251
|
-
it('error message includes all available agents', () => {
|
|
252
|
-
const agentContexts = new Map([
|
|
253
|
-
['alpha', {}],
|
|
254
|
-
['beta', {}],
|
|
255
|
-
['gamma', {}],
|
|
256
|
-
]);
|
|
257
|
-
const availableAgents = Array.from(agentContexts.keys()).join(', ');
|
|
258
|
-
|
|
259
|
-
const errorMsg = new ToolMessage({
|
|
260
|
-
content: `Transfer failed: agent "delta" does not exist. Available agents: ${availableAgents}. Please choose a valid agent to transfer to.`,
|
|
261
|
-
tool_call_id: 'call-456',
|
|
262
|
-
name: 'lc_transfer_to_delta',
|
|
263
|
-
});
|
|
264
|
-
|
|
265
|
-
expect(errorMsg.content).toContain('alpha, beta, gamma');
|
|
266
|
-
expect(errorMsg.getType()).toBe('tool');
|
|
267
|
-
});
|
|
268
|
-
});
|
|
269
|
-
|
|
270
|
-
// ---------------------------------------------------------------------------
|
|
271
|
-
// 6. Compacted handoff message structure
|
|
272
|
-
// ---------------------------------------------------------------------------
|
|
273
|
-
describe('compacted handoff message structure', () => {
|
|
274
|
-
it('keeps briefing + last 3 messages', () => {
|
|
275
|
-
const originalMessages = [
|
|
276
|
-
new HumanMessage('msg 1'),
|
|
277
|
-
new AIMessage('msg 2'),
|
|
278
|
-
new HumanMessage('msg 3'),
|
|
279
|
-
new AIMessage('msg 4'),
|
|
280
|
-
new HumanMessage('msg 5'),
|
|
281
|
-
new AIMessage('msg 6'),
|
|
282
|
-
];
|
|
283
|
-
|
|
284
|
-
const briefingMsg = new SystemMessage(
|
|
285
|
-
'[Handoff Briefing]\nAgent A completed analysis'
|
|
286
|
-
);
|
|
287
|
-
const keepCount = Math.min(3, originalMessages.length);
|
|
288
|
-
const compacted = [
|
|
289
|
-
briefingMsg,
|
|
290
|
-
...originalMessages.slice(originalMessages.length - keepCount),
|
|
291
|
-
];
|
|
292
|
-
|
|
293
|
-
expect(compacted).toHaveLength(4); // briefing + 3 messages
|
|
294
|
-
expect(compacted[0].getType()).toBe('system');
|
|
295
|
-
expect(compacted[0].content).toContain('Handoff Briefing');
|
|
296
|
-
expect(compacted[3].getType()).toBe('ai'); // last message preserved
|
|
297
|
-
});
|
|
298
|
-
|
|
299
|
-
it('keeps all messages when fewer than 3 remain', () => {
|
|
300
|
-
const originalMessages = [
|
|
301
|
-
new HumanMessage('only message'),
|
|
302
|
-
new AIMessage('only response'),
|
|
303
|
-
];
|
|
304
|
-
|
|
305
|
-
const briefingMsg = new SystemMessage('[Handoff Briefing]\nBriefing text');
|
|
306
|
-
const keepCount = Math.min(3, originalMessages.length);
|
|
307
|
-
const compacted = [
|
|
308
|
-
briefingMsg,
|
|
309
|
-
...originalMessages.slice(originalMessages.length - keepCount),
|
|
310
|
-
];
|
|
311
|
-
|
|
312
|
-
// briefing + 2 original messages
|
|
313
|
-
expect(compacted).toHaveLength(3);
|
|
314
|
-
expect(compacted[1].content).toBe('only message');
|
|
315
|
-
expect(compacted[2].content).toBe('only response');
|
|
316
|
-
});
|
|
317
|
-
|
|
318
|
-
it('preserves the handoff tool message as the last message', () => {
|
|
319
|
-
const originalMessages = [
|
|
320
|
-
new HumanMessage('do X'),
|
|
321
|
-
new AIMessage('calling agent-b'),
|
|
322
|
-
new ToolMessage({
|
|
323
|
-
content: 'Transferred to agent-b',
|
|
324
|
-
tool_call_id: 'tc-handoff',
|
|
325
|
-
name: 'lc_transfer_to_agent-b',
|
|
326
|
-
}),
|
|
327
|
-
];
|
|
328
|
-
|
|
329
|
-
const briefingMsg = new SystemMessage('[Handoff Briefing]\nContext');
|
|
330
|
-
const keepCount = Math.min(3, originalMessages.length);
|
|
331
|
-
const compacted = [
|
|
332
|
-
briefingMsg,
|
|
333
|
-
...originalMessages.slice(originalMessages.length - keepCount),
|
|
334
|
-
];
|
|
335
|
-
|
|
336
|
-
const lastMsg = compacted[compacted.length - 1];
|
|
337
|
-
expect(lastMsg.getType()).toBe('tool');
|
|
338
|
-
expect((lastMsg as ToolMessage).name).toContain('lc_transfer_to_');
|
|
339
|
-
});
|
|
340
|
-
|
|
341
|
-
it('briefing contains sender name in the expected format', () => {
|
|
342
|
-
const senderName = 'Research Agent';
|
|
343
|
-
const summaryText = 'User asked about market trends. Found 5 data points.';
|
|
344
|
-
const briefingMsg = new SystemMessage(
|
|
345
|
-
`[Handoff Briefing from "${senderName}"]\n${summaryText}`
|
|
346
|
-
);
|
|
347
|
-
|
|
348
|
-
expect(briefingMsg.content).toContain(
|
|
349
|
-
'Handoff Briefing from "Research Agent"'
|
|
350
|
-
);
|
|
351
|
-
expect(briefingMsg.content).toContain(summaryText);
|
|
352
|
-
});
|
|
353
|
-
});
|
|
@@ -1,79 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Integration test — exercises ToolsServerCapabilityProvider against a live
|
|
3
|
-
* tools-server instance.
|
|
4
|
-
*
|
|
5
|
-
* RUN REQUIREMENTS:
|
|
6
|
-
* 1. tools-server must be running locally at TOOLS_SERVER_URL
|
|
7
|
-
* 2. TOOLS_SERVER_API_KEY must match the server's configured key
|
|
8
|
-
*
|
|
9
|
-
* The suite is skipped when TOOLS_SERVER_URL is not set so unit CI passes.
|
|
10
|
-
* To run: TOOLS_SERVER_URL=http://localhost:3500 TOOLS_SERVER_API_KEY=test \
|
|
11
|
-
* npx jest --testPathPatterns=integration
|
|
12
|
-
*/
|
|
13
|
-
|
|
14
|
-
import { ToolsServerCapabilityProvider } from '../tools-server/ToolsServerCapabilityProvider';
|
|
15
|
-
import { CapabilityKind } from '../types';
|
|
16
|
-
|
|
17
|
-
const baseUrl = process.env.TOOLS_SERVER_URL;
|
|
18
|
-
const apiKey = process.env.TOOLS_SERVER_API_KEY;
|
|
19
|
-
|
|
20
|
-
const describeIfLive = baseUrl && apiKey ? describe : describe.skip;
|
|
21
|
-
|
|
22
|
-
describeIfLive('ToolsServerCapabilityProvider (live integration)', () => {
|
|
23
|
-
let provider: ToolsServerCapabilityProvider;
|
|
24
|
-
|
|
25
|
-
beforeAll(() => {
|
|
26
|
-
provider = new ToolsServerCapabilityProvider({
|
|
27
|
-
baseUrl: baseUrl as string,
|
|
28
|
-
apiKey: apiKey as string,
|
|
29
|
-
manifestTtlMs: 0, // always fresh for tests
|
|
30
|
-
});
|
|
31
|
-
});
|
|
32
|
-
|
|
33
|
-
it('fetches manifest from live server', async () => {
|
|
34
|
-
const caps = await provider.fetchManifest();
|
|
35
|
-
expect(caps.length).toBeGreaterThan(0);
|
|
36
|
-
for (const cap of caps) {
|
|
37
|
-
expect(cap.kind).toBe(CapabilityKind.TOOL);
|
|
38
|
-
expect(typeof cap.name).toBe('string');
|
|
39
|
-
expect(typeof cap.description).toBe('string');
|
|
40
|
-
expect(Array.isArray(cap.authConfig)).toBe(true);
|
|
41
|
-
}
|
|
42
|
-
});
|
|
43
|
-
|
|
44
|
-
it('live manifest contains wikipedia', async () => {
|
|
45
|
-
const caps = await provider.fetchManifest();
|
|
46
|
-
const wikipedia = caps.find((c) => c.name === 'wikipedia');
|
|
47
|
-
expect(wikipedia).toBeDefined();
|
|
48
|
-
expect(wikipedia?.schema).toBeDefined();
|
|
49
|
-
});
|
|
50
|
-
|
|
51
|
-
it('builds runnables that invoke wikipedia end-to-end', async () => {
|
|
52
|
-
const caps = await provider.fetchManifest({ names: ['wikipedia'] });
|
|
53
|
-
expect(caps).toHaveLength(1);
|
|
54
|
-
|
|
55
|
-
const [tool] = await provider.createRunnables(caps, {});
|
|
56
|
-
const result = await tool.invoke({ action: 'search', query: 'TypeScript' });
|
|
57
|
-
|
|
58
|
-
// Wikipedia returns JSON-serialized results; just check it's non-empty
|
|
59
|
-
expect(typeof result).toBe('string');
|
|
60
|
-
expect((result as string).length).toBeGreaterThan(0);
|
|
61
|
-
});
|
|
62
|
-
|
|
63
|
-
it('surfaces backend failure as thrown error', async () => {
|
|
64
|
-
// Invoke wikipedia with missing required field → backend returns success:false
|
|
65
|
-
const caps = await provider.fetchManifest({ names: ['wikipedia'] });
|
|
66
|
-
const [tool] = await provider.createRunnables(caps, {});
|
|
67
|
-
await expect(tool.invoke({})).rejects.toThrow();
|
|
68
|
-
});
|
|
69
|
-
|
|
70
|
-
it('filters manifest by names correctly', async () => {
|
|
71
|
-
const caps = await provider.fetchManifest({
|
|
72
|
-
names: ['wikipedia', 'arxiv_search'],
|
|
73
|
-
});
|
|
74
|
-
expect(caps.length).toBeLessThanOrEqual(2);
|
|
75
|
-
for (const cap of caps) {
|
|
76
|
-
expect(['wikipedia', 'arxiv_search']).toContain(cap.name);
|
|
77
|
-
}
|
|
78
|
-
});
|
|
79
|
-
});
|
|
@@ -1,271 +0,0 @@
|
|
|
1
|
-
import axios from 'axios';
|
|
2
|
-
import { ToolsServerCapabilityProvider } from '../tools-server/ToolsServerCapabilityProvider';
|
|
3
|
-
import { CapabilityKind } from '../types';
|
|
4
|
-
|
|
5
|
-
/**
|
|
6
|
-
* Tests use a stub axios instance passed via config — no real HTTP.
|
|
7
|
-
*/
|
|
8
|
-
function makeStubClient(response: {
|
|
9
|
-
status: number;
|
|
10
|
-
data: unknown;
|
|
11
|
-
}): ReturnType<typeof axios.create> {
|
|
12
|
-
const stub = {
|
|
13
|
-
get: jest.fn().mockResolvedValue(response),
|
|
14
|
-
post: jest.fn().mockResolvedValue(response),
|
|
15
|
-
defaults: { baseURL: 'http://stub', headers: {} },
|
|
16
|
-
};
|
|
17
|
-
return stub as unknown as ReturnType<typeof axios.create>;
|
|
18
|
-
}
|
|
19
|
-
|
|
20
|
-
const manifestFixture = [
|
|
21
|
-
{
|
|
22
|
-
pluginKey: 'wikipedia',
|
|
23
|
-
name: 'Wikipedia',
|
|
24
|
-
description: 'Search Wikipedia',
|
|
25
|
-
icon: '/assets/icons/wikipedia.svg',
|
|
26
|
-
authConfig: [],
|
|
27
|
-
schema: { type: 'object', properties: { query: { type: 'string' } } },
|
|
28
|
-
tags: ['search', 'knowledge'],
|
|
29
|
-
},
|
|
30
|
-
{
|
|
31
|
-
pluginKey: 'dalle',
|
|
32
|
-
name: 'DALL-E 3',
|
|
33
|
-
description: 'Generate images',
|
|
34
|
-
authConfig: [
|
|
35
|
-
{
|
|
36
|
-
authField: 'OPENAI_API_KEY',
|
|
37
|
-
label: 'OpenAI API Key',
|
|
38
|
-
source: 'user',
|
|
39
|
-
required: true,
|
|
40
|
-
},
|
|
41
|
-
],
|
|
42
|
-
jsonSchema: { type: 'object', properties: { prompt: { type: 'string' } } },
|
|
43
|
-
tags: ['image'],
|
|
44
|
-
},
|
|
45
|
-
];
|
|
46
|
-
|
|
47
|
-
describe('ToolsServerCapabilityProvider construction', () => {
|
|
48
|
-
it('throws when baseUrl missing', () => {
|
|
49
|
-
expect(
|
|
50
|
-
() => new ToolsServerCapabilityProvider({ baseUrl: '', apiKey: 'k' })
|
|
51
|
-
).toThrow(/baseUrl is required/);
|
|
52
|
-
});
|
|
53
|
-
it('throws when apiKey missing', () => {
|
|
54
|
-
expect(
|
|
55
|
-
() =>
|
|
56
|
-
new ToolsServerCapabilityProvider({ baseUrl: 'http://x', apiKey: '' })
|
|
57
|
-
).toThrow(/apiKey is required/);
|
|
58
|
-
});
|
|
59
|
-
it('composes providerId from baseUrl', () => {
|
|
60
|
-
const p = new ToolsServerCapabilityProvider({
|
|
61
|
-
baseUrl: 'http://localhost:3500',
|
|
62
|
-
apiKey: 'k',
|
|
63
|
-
client: makeStubClient({ status: 200, data: [] }),
|
|
64
|
-
});
|
|
65
|
-
expect(p.providerId).toBe('tools-server:http://localhost:3500');
|
|
66
|
-
});
|
|
67
|
-
});
|
|
68
|
-
|
|
69
|
-
describe('ToolsServerCapabilityProvider.fetchManifest', () => {
|
|
70
|
-
it('normalizes manifest entries into Capability shape', async () => {
|
|
71
|
-
const client = makeStubClient({ status: 200, data: manifestFixture });
|
|
72
|
-
const p = new ToolsServerCapabilityProvider({
|
|
73
|
-
baseUrl: 'http://x',
|
|
74
|
-
apiKey: 'k',
|
|
75
|
-
client,
|
|
76
|
-
});
|
|
77
|
-
const caps = await p.fetchManifest();
|
|
78
|
-
expect(caps).toHaveLength(2);
|
|
79
|
-
expect(caps[0].kind).toBe(CapabilityKind.TOOL);
|
|
80
|
-
expect(caps[0].name).toBe('wikipedia');
|
|
81
|
-
expect(caps[0].metadata.tags).toEqual(['search', 'knowledge']);
|
|
82
|
-
expect(caps[1].authConfig[0].authField).toBe('OPENAI_API_KEY');
|
|
83
|
-
expect(caps[1].authConfig[0].required).toBe(true);
|
|
84
|
-
});
|
|
85
|
-
|
|
86
|
-
it('caches manifest between calls', async () => {
|
|
87
|
-
const client = makeStubClient({ status: 200, data: manifestFixture });
|
|
88
|
-
const p = new ToolsServerCapabilityProvider({
|
|
89
|
-
baseUrl: 'http://x',
|
|
90
|
-
apiKey: 'k',
|
|
91
|
-
client,
|
|
92
|
-
});
|
|
93
|
-
await p.fetchManifest();
|
|
94
|
-
await p.fetchManifest();
|
|
95
|
-
expect((client.get as jest.Mock).mock.calls).toHaveLength(1);
|
|
96
|
-
});
|
|
97
|
-
|
|
98
|
-
it('invalidateCache forces refetch', async () => {
|
|
99
|
-
const client = makeStubClient({ status: 200, data: manifestFixture });
|
|
100
|
-
const p = new ToolsServerCapabilityProvider({
|
|
101
|
-
baseUrl: 'http://x',
|
|
102
|
-
apiKey: 'k',
|
|
103
|
-
client,
|
|
104
|
-
});
|
|
105
|
-
await p.fetchManifest();
|
|
106
|
-
p.invalidateCache();
|
|
107
|
-
await p.fetchManifest();
|
|
108
|
-
expect((client.get as jest.Mock).mock.calls).toHaveLength(2);
|
|
109
|
-
});
|
|
110
|
-
|
|
111
|
-
it('filters by name', async () => {
|
|
112
|
-
const client = makeStubClient({ status: 200, data: manifestFixture });
|
|
113
|
-
const p = new ToolsServerCapabilityProvider({
|
|
114
|
-
baseUrl: 'http://x',
|
|
115
|
-
apiKey: 'k',
|
|
116
|
-
client,
|
|
117
|
-
});
|
|
118
|
-
const caps = await p.fetchManifest({ names: ['wikipedia'] });
|
|
119
|
-
expect(caps).toHaveLength(1);
|
|
120
|
-
expect(caps[0].name).toBe('wikipedia');
|
|
121
|
-
});
|
|
122
|
-
|
|
123
|
-
it('throws HttpError on non-2xx', async () => {
|
|
124
|
-
const client = makeStubClient({ status: 500, data: { error: 'boom' } });
|
|
125
|
-
const p = new ToolsServerCapabilityProvider({
|
|
126
|
-
baseUrl: 'http://x',
|
|
127
|
-
apiKey: 'k',
|
|
128
|
-
client,
|
|
129
|
-
});
|
|
130
|
-
await expect(p.fetchManifest()).rejects.toThrow(/HTTP 500/);
|
|
131
|
-
});
|
|
132
|
-
});
|
|
133
|
-
|
|
134
|
-
describe('ToolsServerCapabilityProvider.createRunnables', () => {
|
|
135
|
-
it('returns one StructuredTool per capability', async () => {
|
|
136
|
-
const client = makeStubClient({ status: 200, data: manifestFixture });
|
|
137
|
-
const p = new ToolsServerCapabilityProvider({
|
|
138
|
-
baseUrl: 'http://x',
|
|
139
|
-
apiKey: 'k',
|
|
140
|
-
client,
|
|
141
|
-
});
|
|
142
|
-
const caps = await p.fetchManifest();
|
|
143
|
-
const tools = await p.createRunnables(caps, {});
|
|
144
|
-
expect(tools).toHaveLength(2);
|
|
145
|
-
expect(tools[0].name).toBe('wikipedia');
|
|
146
|
-
expect(tools[1].name).toBe('dalle');
|
|
147
|
-
});
|
|
148
|
-
|
|
149
|
-
it('proxy tool invocation POSTs to /execute/:name with credentials', async () => {
|
|
150
|
-
const client = {
|
|
151
|
-
get: jest.fn().mockResolvedValue({ status: 200, data: manifestFixture }),
|
|
152
|
-
post: jest.fn().mockResolvedValue({
|
|
153
|
-
status: 200,
|
|
154
|
-
data: {
|
|
155
|
-
success: true,
|
|
156
|
-
result: 'Node.js is a JS runtime',
|
|
157
|
-
timing: { durationMs: 42 },
|
|
158
|
-
},
|
|
159
|
-
}),
|
|
160
|
-
defaults: { baseURL: 'http://stub', headers: {} },
|
|
161
|
-
};
|
|
162
|
-
const p = new ToolsServerCapabilityProvider({
|
|
163
|
-
baseUrl: 'http://x',
|
|
164
|
-
apiKey: 'k',
|
|
165
|
-
client: client as unknown as ReturnType<typeof axios.create>,
|
|
166
|
-
});
|
|
167
|
-
const caps = await p.fetchManifest();
|
|
168
|
-
const [wikipedia] = await p.createRunnables(
|
|
169
|
-
caps.filter((c) => c.name === 'wikipedia'),
|
|
170
|
-
{ WIKIPEDIA_API_KEY: 'test' }
|
|
171
|
-
);
|
|
172
|
-
const result = await wikipedia.invoke({ query: 'Node.js' });
|
|
173
|
-
expect(result).toBe('Node.js is a JS runtime');
|
|
174
|
-
expect((client.post as jest.Mock).mock.calls[0][0]).toBe(
|
|
175
|
-
'/execute/wikipedia'
|
|
176
|
-
);
|
|
177
|
-
expect((client.post as jest.Mock).mock.calls[0][1]).toEqual({
|
|
178
|
-
input: { query: 'Node.js' },
|
|
179
|
-
credentials: { WIKIPEDIA_API_KEY: 'test' },
|
|
180
|
-
});
|
|
181
|
-
});
|
|
182
|
-
|
|
183
|
-
it('proxy tool surfaces backend success:false as thrown error', async () => {
|
|
184
|
-
const client = {
|
|
185
|
-
get: jest.fn().mockResolvedValue({ status: 200, data: manifestFixture }),
|
|
186
|
-
post: jest.fn().mockResolvedValue({
|
|
187
|
-
status: 200,
|
|
188
|
-
data: { success: false, error: 'missing API key' },
|
|
189
|
-
}),
|
|
190
|
-
defaults: { baseURL: 'http://stub', headers: {} },
|
|
191
|
-
};
|
|
192
|
-
const p = new ToolsServerCapabilityProvider({
|
|
193
|
-
baseUrl: 'http://x',
|
|
194
|
-
apiKey: 'k',
|
|
195
|
-
client: client as unknown as ReturnType<typeof axios.create>,
|
|
196
|
-
});
|
|
197
|
-
const caps = await p.fetchManifest();
|
|
198
|
-
const [dalle] = await p.createRunnables(
|
|
199
|
-
caps.filter((c) => c.name === 'dalle'),
|
|
200
|
-
{}
|
|
201
|
-
);
|
|
202
|
-
await expect(dalle.invoke({ prompt: 'cat' })).rejects.toThrow(
|
|
203
|
-
/missing API key/
|
|
204
|
-
);
|
|
205
|
-
});
|
|
206
|
-
|
|
207
|
-
it('getExecuteAuthHeaders is invoked per call and forwarded as HTTP headers', async () => {
|
|
208
|
-
const client = {
|
|
209
|
-
get: jest.fn().mockResolvedValue({ status: 200, data: manifestFixture }),
|
|
210
|
-
post: jest.fn().mockResolvedValue({
|
|
211
|
-
status: 200,
|
|
212
|
-
data: {
|
|
213
|
-
success: true,
|
|
214
|
-
result: 'ok',
|
|
215
|
-
timing: { durationMs: 1 },
|
|
216
|
-
},
|
|
217
|
-
}),
|
|
218
|
-
defaults: { baseURL: 'http://stub', headers: {} },
|
|
219
|
-
};
|
|
220
|
-
|
|
221
|
-
let mintCount = 0;
|
|
222
|
-
const p = new ToolsServerCapabilityProvider({
|
|
223
|
-
baseUrl: 'http://x',
|
|
224
|
-
apiKey: 'k',
|
|
225
|
-
client: client as unknown as ReturnType<typeof axios.create>,
|
|
226
|
-
getExecuteAuthHeaders: async () => {
|
|
227
|
-
mintCount += 1;
|
|
228
|
-
return { Authorization: `Bearer TOKEN-${mintCount}` };
|
|
229
|
-
},
|
|
230
|
-
});
|
|
231
|
-
const caps = await p.fetchManifest();
|
|
232
|
-
const [wikipedia] = await p.createRunnables(
|
|
233
|
-
caps.filter((c) => c.name === 'wikipedia'),
|
|
234
|
-
{}
|
|
235
|
-
);
|
|
236
|
-
|
|
237
|
-
await wikipedia.invoke({ query: 'a' });
|
|
238
|
-
await wikipedia.invoke({ query: 'b' });
|
|
239
|
-
|
|
240
|
-
// Two invocations → two mints (fresh token each call)
|
|
241
|
-
expect(mintCount).toBe(2);
|
|
242
|
-
|
|
243
|
-
// Each POST includes the Authorization header from the mint
|
|
244
|
-
const firstCall = (client.post as jest.Mock).mock.calls[0];
|
|
245
|
-
const secondCall = (client.post as jest.Mock).mock.calls[1];
|
|
246
|
-
expect(firstCall[2]?.headers).toEqual({ Authorization: 'Bearer TOKEN-1' });
|
|
247
|
-
expect(secondCall[2]?.headers).toEqual({ Authorization: 'Bearer TOKEN-2' });
|
|
248
|
-
});
|
|
249
|
-
|
|
250
|
-
it('getExecuteAuthHeaders is NOT called during manifest fetch (service-to-service)', async () => {
|
|
251
|
-
const client = {
|
|
252
|
-
get: jest.fn().mockResolvedValue({ status: 200, data: manifestFixture }),
|
|
253
|
-
post: jest.fn(),
|
|
254
|
-
defaults: { baseURL: 'http://stub', headers: {} },
|
|
255
|
-
};
|
|
256
|
-
|
|
257
|
-
const authBuilder = jest
|
|
258
|
-
.fn()
|
|
259
|
-
.mockReturnValue({ Authorization: 'Bearer X' });
|
|
260
|
-
const p = new ToolsServerCapabilityProvider({
|
|
261
|
-
baseUrl: 'http://x',
|
|
262
|
-
apiKey: 'k',
|
|
263
|
-
client: client as unknown as ReturnType<typeof axios.create>,
|
|
264
|
-
getExecuteAuthHeaders: authBuilder,
|
|
265
|
-
});
|
|
266
|
-
|
|
267
|
-
await p.fetchManifest();
|
|
268
|
-
// Manifest fetch is service-to-service — no per-user auth headers
|
|
269
|
-
expect(authBuilder).not.toHaveBeenCalled();
|
|
270
|
-
});
|
|
271
|
-
});
|