agentfootprint 10.3.1 → 10.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/AGENTS.md +2 -2
- package/CAPABILITIES.md +12 -1
- package/README.md +44 -0
- package/ai-instructions/claude-code/SKILL.md +2 -2
- package/ai-instructions/clinerules +22 -11
- package/ai-instructions/copilot-instructions.md +22 -11
- package/ai-instructions/cursor/agentfootprint.md +22 -11
- package/ai-instructions/kiro/agentfootprint.md +22 -11
- package/ai-instructions/windsurfrules +22 -11
- package/dist/adapters/llm/AnthropicProvider.js +26 -8
- package/dist/adapters/llm/AnthropicProvider.js.map +1 -1
- package/dist/adapters/llm/BedrockProvider.js +23 -7
- package/dist/adapters/llm/BedrockProvider.js.map +1 -1
- package/dist/adapters/llm/BrowserAnthropicProvider.js +57 -49
- package/dist/adapters/llm/BrowserAnthropicProvider.js.map +1 -1
- package/dist/adapters/llm/BrowserOpenAIProvider.js +50 -42
- package/dist/adapters/llm/BrowserOpenAIProvider.js.map +1 -1
- package/dist/adapters/llm/FoundryLocalProvider.js +174 -212
- package/dist/adapters/llm/FoundryLocalProvider.js.map +1 -1
- package/dist/adapters/llm/GeminiProvider.js +23 -9
- package/dist/adapters/llm/GeminiProvider.js.map +1 -1
- package/dist/adapters/llm/InvokeModelGatewayProvider.js +32 -9
- package/dist/adapters/llm/InvokeModelGatewayProvider.js.map +1 -1
- package/dist/adapters/llm/MockProvider.js +11 -3
- package/dist/adapters/llm/MockProvider.js.map +1 -1
- package/dist/adapters/llm/OllamaProvider.js +129 -167
- package/dist/adapters/llm/OllamaProvider.js.map +1 -1
- package/dist/adapters/llm/OpenAIProvider.js +36 -9
- package/dist/adapters/llm/OpenAIProvider.js.map +1 -1
- package/dist/adapters/mcp/agentcoreRuntime/errorType.js +24 -0
- package/dist/adapters/mcp/agentcoreRuntime/errorType.js.map +1 -0
- package/dist/adapters/mcp/agentcoreRuntime/invoke.js +272 -0
- package/dist/adapters/mcp/agentcoreRuntime/invoke.js.map +1 -0
- package/dist/adapters/mcp/agentcoreRuntime/safeAnswer.js +415 -0
- package/dist/adapters/mcp/agentcoreRuntime/safeAnswer.js.map +1 -0
- package/dist/adapters/mcp/agentcoreRuntime/session.js +179 -0
- package/dist/adapters/mcp/agentcoreRuntime/session.js.map +1 -0
- package/dist/adapters/mcp/agentcoreRuntime/sessionBusy.js +117 -0
- package/dist/adapters/mcp/agentcoreRuntime/sessionBusy.js.map +1 -0
- package/dist/adapters/mcp/agentcoreRuntime/strictJson.js +220 -0
- package/dist/adapters/mcp/agentcoreRuntime/strictJson.js.map +1 -0
- package/dist/adapters/mcp/agentcoreRuntime/transport.js +222 -0
- package/dist/adapters/mcp/agentcoreRuntime/transport.js.map +1 -0
- package/dist/adapters/memory/agentcore.js +435 -20
- package/dist/adapters/memory/agentcore.js.map +1 -1
- package/dist/adapters/memory/memoryBank.js +16 -3
- package/dist/adapters/memory/memoryBank.js.map +1 -1
- package/dist/adapters/memory/pgVector.js +10 -4
- package/dist/adapters/memory/pgVector.js.map +1 -1
- package/dist/adapters/memory/redis.js +11 -3
- package/dist/adapters/memory/redis.js.map +1 -1
- package/dist/adapters/memory/s3Vectors.js +8 -3
- package/dist/adapters/memory/s3Vectors.js.map +1 -1
- package/dist/adapters/memory/sqliteVector.js +10 -4
- package/dist/adapters/memory/sqliteVector.js.map +1 -1
- package/dist/ag-ui/adapter.js +126 -0
- package/dist/ag-ui/adapter.js.map +1 -0
- package/dist/ag-ui/framing.js +68 -0
- package/dist/ag-ui/framing.js.map +1 -0
- package/dist/ag-ui/frontendTools.js +69 -0
- package/dist/ag-ui/frontendTools.js.map +1 -0
- package/dist/ag-ui/ids.js +54 -0
- package/dist/ag-ui/ids.js.map +1 -0
- package/dist/ag-ui/index.js +29 -0
- package/dist/ag-ui/index.js.map +1 -0
- package/dist/ag-ui/request.js +416 -0
- package/dist/ag-ui/request.js.map +1 -0
- package/dist/ag-ui/serializer.js +899 -0
- package/dist/ag-ui/serializer.js.map +1 -0
- package/dist/ag-ui/types.js +22 -0
- package/dist/ag-ui/types.js.map +1 -0
- package/dist/answer-validation/index.js +8 -1
- package/dist/answer-validation/index.js.map +1 -1
- package/dist/answer-validation/toolLedger.js +130 -0
- package/dist/answer-validation/toolLedger.js.map +1 -0
- package/dist/answer-validation/types.js.map +1 -1
- package/dist/answer-validation/validate.js +25 -3
- package/dist/answer-validation/validate.js.map +1 -1
- package/dist/classify/typesafe.js +31 -23
- package/dist/classify/typesafe.js.map +1 -1
- package/dist/core/Agent.js +106 -20
- package/dist/core/Agent.js.map +1 -1
- package/dist/core/LLMCall.js +16 -6
- package/dist/core/LLMCall.js.map +1 -1
- package/dist/core/RunnerBase.js +99 -13
- package/dist/core/RunnerBase.js.map +1 -1
- package/dist/core/agent/buildAgentChart.js +17 -5
- package/dist/core/agent/buildAgentChart.js.map +1 -1
- package/dist/core/agent/buildAgentMessageApiChart.js +22 -2
- package/dist/core/agent/buildAgentMessageApiChart.js.map +1 -1
- package/dist/core/agent/buildDynamicAgentChart.js +23 -4
- package/dist/core/agent/buildDynamicAgentChart.js.map +1 -1
- package/dist/core/agent/buildMessageApiChart.js +22 -2
- package/dist/core/agent/buildMessageApiChart.js.map +1 -1
- package/dist/core/agent/callerIdentity.js +2 -1
- package/dist/core/agent/callerIdentity.js.map +1 -1
- package/dist/core/agent/stages/answerValidation.js +22 -1
- package/dist/core/agent/stages/answerValidation.js.map +1 -1
- package/dist/core/agent/stages/callLLM.js +19 -3
- package/dist/core/agent/stages/callLLM.js.map +1 -1
- package/dist/core/agent/stages/routeTurn.js +17 -4
- package/dist/core/agent/stages/routeTurn.js.map +1 -1
- package/dist/core/agent/stages/seed.js +58 -8
- package/dist/core/agent/stages/seed.js.map +1 -1
- package/dist/core/agent/stages/timeLayer.js +2 -2
- package/dist/core/agent/stages/timeLayer.js.map +1 -1
- package/dist/core/agent/stages/toolCalls.js +85 -25
- package/dist/core/agent/stages/toolCalls.js.map +1 -1
- package/dist/core/agent/window/strategies/summarizeOldest.js +4 -0
- package/dist/core/agent/window/strategies/summarizeOldest.js.map +1 -1
- package/dist/core/agent/window/summarize.js +6 -3
- package/dist/core/agent/window/summarize.js.map +1 -1
- package/dist/core/memberRun.js +293 -0
- package/dist/core/memberRun.js.map +1 -0
- package/dist/core/requestOfRun.js +28 -0
- package/dist/core/requestOfRun.js.map +1 -0
- package/dist/core/slots/buildToolsSlot.js +11 -25
- package/dist/core/slots/buildToolsSlot.js.map +1 -1
- package/dist/core-flow/Conditional.js +39 -12
- package/dist/core-flow/Conditional.js.map +1 -1
- package/dist/core-flow/Graph.js +48 -17
- package/dist/core-flow/Graph.js.map +1 -1
- package/dist/core-flow/Loop.js +39 -13
- package/dist/core-flow/Loop.js.map +1 -1
- package/dist/core-flow/Parallel.js +53 -21
- package/dist/core-flow/Parallel.js.map +1 -1
- package/dist/core-flow/Sequence.js +39 -12
- package/dist/core-flow/Sequence.js.map +1 -1
- package/dist/core-flow/Workflow.js +44 -14
- package/dist/core-flow/Workflow.js.map +1 -1
- package/dist/doors/ag-ui.js +36 -0
- package/dist/doors/ag-ui.js.map +1 -0
- package/dist/doors/security.js +2 -1
- package/dist/doors/security.js.map +1 -1
- package/dist/esm/adapters/llm/AnthropicProvider.d.ts +9 -2
- package/dist/esm/adapters/llm/AnthropicProvider.js +26 -8
- package/dist/esm/adapters/llm/AnthropicProvider.js.map +1 -1
- package/dist/esm/adapters/llm/BedrockProvider.d.ts +6 -1
- package/dist/esm/adapters/llm/BedrockProvider.js +23 -7
- package/dist/esm/adapters/llm/BedrockProvider.js.map +1 -1
- package/dist/esm/adapters/llm/BrowserAnthropicProvider.js +57 -49
- package/dist/esm/adapters/llm/BrowserAnthropicProvider.js.map +1 -1
- package/dist/esm/adapters/llm/BrowserOpenAIProvider.js +50 -42
- package/dist/esm/adapters/llm/BrowserOpenAIProvider.js.map +1 -1
- package/dist/esm/adapters/llm/FoundryLocalProvider.js +171 -209
- package/dist/esm/adapters/llm/FoundryLocalProvider.js.map +1 -1
- package/dist/esm/adapters/llm/GeminiProvider.js +23 -9
- package/dist/esm/adapters/llm/GeminiProvider.js.map +1 -1
- package/dist/esm/adapters/llm/InvokeModelGatewayProvider.js +32 -9
- package/dist/esm/adapters/llm/InvokeModelGatewayProvider.js.map +1 -1
- package/dist/esm/adapters/llm/MockProvider.js +11 -3
- package/dist/esm/adapters/llm/MockProvider.js.map +1 -1
- package/dist/esm/adapters/llm/OllamaProvider.js +126 -164
- package/dist/esm/adapters/llm/OllamaProvider.js.map +1 -1
- package/dist/esm/adapters/llm/OpenAIProvider.d.ts +6 -1
- package/dist/esm/adapters/llm/OpenAIProvider.js +36 -9
- package/dist/esm/adapters/llm/OpenAIProvider.js.map +1 -1
- package/dist/esm/adapters/mcp/agentcoreRuntime/errorType.d.ts +12 -0
- package/dist/esm/adapters/mcp/agentcoreRuntime/errorType.js +20 -0
- package/dist/esm/adapters/mcp/agentcoreRuntime/errorType.js.map +1 -0
- package/dist/esm/adapters/mcp/agentcoreRuntime/invoke.d.ts +116 -0
- package/dist/esm/adapters/mcp/agentcoreRuntime/invoke.js +267 -0
- package/dist/esm/adapters/mcp/agentcoreRuntime/invoke.js.map +1 -0
- package/dist/esm/adapters/mcp/agentcoreRuntime/safeAnswer.d.ts +49 -0
- package/dist/esm/adapters/mcp/agentcoreRuntime/safeAnswer.js +409 -0
- package/dist/esm/adapters/mcp/agentcoreRuntime/safeAnswer.js.map +1 -0
- package/dist/esm/adapters/mcp/agentcoreRuntime/session.d.ts +80 -0
- package/dist/esm/adapters/mcp/agentcoreRuntime/session.js +175 -0
- package/dist/esm/adapters/mcp/agentcoreRuntime/session.js.map +1 -0
- package/dist/esm/adapters/mcp/agentcoreRuntime/sessionBusy.d.ts +61 -0
- package/dist/esm/adapters/mcp/agentcoreRuntime/sessionBusy.js +112 -0
- package/dist/esm/adapters/mcp/agentcoreRuntime/sessionBusy.js.map +1 -0
- package/dist/esm/adapters/mcp/agentcoreRuntime/strictJson.d.ts +37 -0
- package/dist/esm/adapters/mcp/agentcoreRuntime/strictJson.js +215 -0
- package/dist/esm/adapters/mcp/agentcoreRuntime/strictJson.js.map +1 -0
- package/dist/esm/adapters/mcp/agentcoreRuntime/transport.d.ts +199 -0
- package/dist/esm/adapters/mcp/agentcoreRuntime/transport.js +217 -0
- package/dist/esm/adapters/mcp/agentcoreRuntime/transport.js.map +1 -0
- package/dist/esm/adapters/memory/agentcore.d.ts +152 -7
- package/dist/esm/adapters/memory/agentcore.js +433 -19
- package/dist/esm/adapters/memory/agentcore.js.map +1 -1
- package/dist/esm/adapters/memory/memoryBank.d.ts +3 -2
- package/dist/esm/adapters/memory/memoryBank.js +16 -3
- package/dist/esm/adapters/memory/memoryBank.js.map +1 -1
- package/dist/esm/adapters/memory/pgVector.js +10 -4
- package/dist/esm/adapters/memory/pgVector.js.map +1 -1
- package/dist/esm/adapters/memory/redis.d.ts +8 -3
- package/dist/esm/adapters/memory/redis.js +11 -3
- package/dist/esm/adapters/memory/redis.js.map +1 -1
- package/dist/esm/adapters/memory/s3Vectors.js +8 -3
- package/dist/esm/adapters/memory/s3Vectors.js.map +1 -1
- package/dist/esm/adapters/memory/sqliteVector.js +10 -4
- package/dist/esm/adapters/memory/sqliteVector.js.map +1 -1
- package/dist/esm/ag-ui/adapter.d.ts +118 -0
- package/dist/esm/ag-ui/adapter.js +122 -0
- package/dist/esm/ag-ui/adapter.js.map +1 -0
- package/dist/esm/ag-ui/framing.d.ts +52 -0
- package/dist/esm/ag-ui/framing.js +64 -0
- package/dist/esm/ag-ui/framing.js.map +1 -0
- package/dist/esm/ag-ui/frontendTools.d.ts +37 -0
- package/dist/esm/ag-ui/frontendTools.js +64 -0
- package/dist/esm/ag-ui/frontendTools.js.map +1 -0
- package/dist/esm/ag-ui/ids.d.ts +43 -0
- package/dist/esm/ag-ui/ids.js +49 -0
- package/dist/esm/ag-ui/ids.js.map +1 -0
- package/dist/esm/ag-ui/index.d.ts +19 -0
- package/dist/esm/ag-ui/index.js +19 -0
- package/dist/esm/ag-ui/index.js.map +1 -0
- package/dist/esm/ag-ui/request.d.ts +151 -0
- package/dist/esm/ag-ui/request.js +408 -0
- package/dist/esm/ag-ui/request.js.map +1 -0
- package/dist/esm/ag-ui/serializer.d.ts +173 -0
- package/dist/esm/ag-ui/serializer.js +895 -0
- package/dist/esm/ag-ui/serializer.js.map +1 -0
- package/dist/esm/ag-ui/types.d.ts +305 -0
- package/dist/esm/ag-ui/types.js +19 -0
- package/dist/esm/ag-ui/types.js.map +1 -0
- package/dist/esm/answer-validation/index.d.ts +2 -1
- package/dist/esm/answer-validation/index.js +1 -0
- package/dist/esm/answer-validation/index.js.map +1 -1
- package/dist/esm/answer-validation/toolLedger.d.ts +65 -0
- package/dist/esm/answer-validation/toolLedger.js +121 -0
- package/dist/esm/answer-validation/toolLedger.js.map +1 -0
- package/dist/esm/answer-validation/types.d.ts +48 -0
- package/dist/esm/answer-validation/types.js.map +1 -1
- package/dist/esm/answer-validation/validate.d.ts +2 -2
- package/dist/esm/answer-validation/validate.js +25 -3
- package/dist/esm/answer-validation/validate.js.map +1 -1
- package/dist/esm/classify/typesafe.js +30 -22
- package/dist/esm/classify/typesafe.js.map +1 -1
- package/dist/esm/core/Agent.d.ts +11 -1
- package/dist/esm/core/Agent.js +107 -21
- package/dist/esm/core/Agent.js.map +1 -1
- package/dist/esm/core/LLMCall.d.ts +2 -1
- package/dist/esm/core/LLMCall.js +17 -7
- package/dist/esm/core/LLMCall.js.map +1 -1
- package/dist/esm/core/RunnerBase.d.ts +39 -8
- package/dist/esm/core/RunnerBase.js +97 -12
- package/dist/esm/core/RunnerBase.js.map +1 -1
- package/dist/esm/core/agent/buildAgentChart.js +17 -5
- package/dist/esm/core/agent/buildAgentChart.js.map +1 -1
- package/dist/esm/core/agent/buildAgentMessageApiChart.d.ts +16 -0
- package/dist/esm/core/agent/buildAgentMessageApiChart.js +22 -2
- package/dist/esm/core/agent/buildAgentMessageApiChart.js.map +1 -1
- package/dist/esm/core/agent/buildDynamicAgentChart.js +23 -4
- package/dist/esm/core/agent/buildDynamicAgentChart.js.map +1 -1
- package/dist/esm/core/agent/buildMessageApiChart.d.ts +16 -0
- package/dist/esm/core/agent/buildMessageApiChart.js +22 -2
- package/dist/esm/core/agent/buildMessageApiChart.js.map +1 -1
- package/dist/esm/core/agent/callerIdentity.js +2 -1
- package/dist/esm/core/agent/callerIdentity.js.map +1 -1
- package/dist/esm/core/agent/stages/answerValidation.js +22 -1
- package/dist/esm/core/agent/stages/answerValidation.js.map +1 -1
- package/dist/esm/core/agent/stages/callLLM.js +19 -3
- package/dist/esm/core/agent/stages/callLLM.js.map +1 -1
- package/dist/esm/core/agent/stages/routeTurn.d.ts +1 -1
- package/dist/esm/core/agent/stages/routeTurn.js +17 -4
- package/dist/esm/core/agent/stages/routeTurn.js.map +1 -1
- package/dist/esm/core/agent/stages/seed.d.ts +18 -1
- package/dist/esm/core/agent/stages/seed.js +58 -8
- package/dist/esm/core/agent/stages/seed.js.map +1 -1
- package/dist/esm/core/agent/stages/timeLayer.js +2 -2
- package/dist/esm/core/agent/stages/timeLayer.js.map +1 -1
- package/dist/esm/core/agent/stages/toolCalls.d.ts +32 -1
- package/dist/esm/core/agent/stages/toolCalls.js +85 -25
- package/dist/esm/core/agent/stages/toolCalls.js.map +1 -1
- package/dist/esm/core/agent/types.d.ts +26 -6
- package/dist/esm/core/agent/window/strategies/summarizeOldest.js +4 -0
- package/dist/esm/core/agent/window/strategies/summarizeOldest.js.map +1 -1
- package/dist/esm/core/agent/window/summarize.js +6 -3
- package/dist/esm/core/agent/window/summarize.js.map +1 -1
- package/dist/esm/core/memberRun.d.ts +153 -0
- package/dist/esm/core/memberRun.js +273 -0
- package/dist/esm/core/memberRun.js.map +1 -0
- package/dist/esm/core/requestOfRun.d.ts +21 -0
- package/dist/esm/core/requestOfRun.js +24 -0
- package/dist/esm/core/requestOfRun.js.map +1 -0
- package/dist/esm/core/runner.d.ts +15 -3
- package/dist/esm/core/slots/buildToolsSlot.d.ts +0 -16
- package/dist/esm/core/slots/buildToolsSlot.js +11 -25
- package/dist/esm/core/slots/buildToolsSlot.js.map +1 -1
- package/dist/esm/core-flow/Conditional.d.ts +10 -1
- package/dist/esm/core-flow/Conditional.js +40 -13
- package/dist/esm/core-flow/Conditional.js.map +1 -1
- package/dist/esm/core-flow/Graph.d.ts +2 -1
- package/dist/esm/core-flow/Graph.js +49 -18
- package/dist/esm/core-flow/Graph.js.map +1 -1
- package/dist/esm/core-flow/Loop.d.ts +10 -1
- package/dist/esm/core-flow/Loop.js +40 -14
- package/dist/esm/core-flow/Loop.js.map +1 -1
- package/dist/esm/core-flow/Parallel.d.ts +10 -1
- package/dist/esm/core-flow/Parallel.js +54 -22
- package/dist/esm/core-flow/Parallel.js.map +1 -1
- package/dist/esm/core-flow/Sequence.d.ts +10 -1
- package/dist/esm/core-flow/Sequence.js +40 -13
- package/dist/esm/core-flow/Sequence.js.map +1 -1
- package/dist/esm/core-flow/Workflow.d.ts +2 -1
- package/dist/esm/core-flow/Workflow.js +45 -15
- package/dist/esm/core-flow/Workflow.js.map +1 -1
- package/dist/esm/doors/ag-ui.d.ts +19 -0
- package/dist/esm/doors/ag-ui.js +20 -0
- package/dist/esm/doors/ag-ui.js.map +1 -0
- package/dist/esm/doors/security.d.ts +2 -1
- package/dist/esm/doors/security.js +2 -1
- package/dist/esm/doors/security.js.map +1 -1
- package/dist/esm/events/payloads.d.ts +4 -2
- package/dist/esm/hosting/envelope.js +5 -0
- package/dist/esm/hosting/envelope.js.map +1 -1
- package/dist/esm/hosting/httpHost.js +5 -78
- package/dist/esm/hosting/httpHost.js.map +1 -1
- package/dist/esm/hosting/index.d.ts +5 -1
- package/dist/esm/hosting/index.js +2 -0
- package/dist/esm/hosting/index.js.map +1 -1
- package/dist/esm/hosting/pendingAsk.d.ts +19 -0
- package/dist/esm/hosting/pendingAsk.js +38 -0
- package/dist/esm/hosting/pendingAsk.js.map +1 -0
- package/dist/esm/hosting/protocolAdapter.d.ts +232 -0
- package/dist/esm/hosting/protocolAdapter.js +23 -0
- package/dist/esm/hosting/protocolAdapter.js.map +1 -0
- package/dist/esm/hosting/refusalStatus.d.ts +30 -0
- package/dist/esm/hosting/refusalStatus.js +85 -0
- package/dist/esm/hosting/refusalStatus.js.map +1 -0
- package/dist/esm/hosting/requestSealing.d.ts +65 -0
- package/dist/esm/hosting/requestSealing.js +79 -0
- package/dist/esm/hosting/requestSealing.js.map +1 -0
- package/dist/esm/hosting/standingAgent.js +24 -34
- package/dist/esm/hosting/standingAgent.js.map +1 -1
- package/dist/esm/hosting/stream.d.ts +60 -0
- package/dist/esm/hosting/stream.js +38 -2
- package/dist/esm/hosting/stream.js.map +1 -1
- package/dist/esm/hosting/streamHandler.d.ts +153 -0
- package/dist/esm/hosting/streamHandler.js +517 -0
- package/dist/esm/hosting/streamHandler.js.map +1 -0
- package/dist/esm/hosting/types.d.ts +44 -0
- package/dist/esm/hosting/types.js.map +1 -1
- package/dist/esm/hosting/verifiedThreads.d.ts +29 -0
- package/dist/esm/hosting/verifiedThreads.js +46 -0
- package/dist/esm/hosting/verifiedThreads.js.map +1 -0
- package/dist/esm/identity/requestContext.d.ts +96 -0
- package/dist/esm/identity/requestContext.js +131 -0
- package/dist/esm/identity/requestContext.js.map +1 -0
- package/dist/esm/identity/requestCredentials.d.ts +99 -0
- package/dist/esm/identity/requestCredentials.js +157 -0
- package/dist/esm/identity/requestCredentials.js.map +1 -0
- package/dist/esm/identity/types.d.ts +11 -0
- package/dist/esm/identity/types.js.map +1 -1
- package/dist/esm/identity.d.ts +2 -0
- package/dist/esm/identity.js +5 -0
- package/dist/esm/identity.js.map +1 -1
- package/dist/esm/index.d.ts +3 -1
- package/dist/esm/index.js +7 -0
- package/dist/esm/index.js.map +1 -1
- package/dist/esm/injection-engine/buildInjectionEngineSubflow.d.ts +11 -0
- package/dist/esm/injection-engine/buildInjectionEngineSubflow.js +39 -5
- package/dist/esm/injection-engine/buildInjectionEngineSubflow.js.map +1 -1
- package/dist/esm/injection-engine/constrainedEnumPick.js +4 -2
- package/dist/esm/injection-engine/constrainedEnumPick.js.map +1 -1
- package/dist/esm/injection-engine/evaluator.d.ts +6 -0
- package/dist/esm/injection-engine/evaluator.js +19 -1
- package/dist/esm/injection-engine/evaluator.js.map +1 -1
- package/dist/esm/injection-engine/skillGraph.js +26 -8
- package/dist/esm/injection-engine/skillGraph.js.map +1 -1
- package/dist/esm/injection-engine/skillIntent.d.ts +4 -2
- package/dist/esm/injection-engine/skillIntent.js +3 -0
- package/dist/esm/injection-engine/skillIntent.js.map +1 -1
- package/dist/esm/injection-engine/types.d.ts +27 -1
- package/dist/esm/injection-engine/types.js +15 -0
- package/dist/esm/injection-engine/types.js.map +1 -1
- package/dist/esm/lib/abort.d.ts +143 -0
- package/dist/esm/lib/abort.js +322 -0
- package/dist/esm/lib/abort.js.map +1 -0
- package/dist/esm/lib/humanizeLLMError.d.ts +15 -0
- package/dist/esm/lib/humanizeLLMError.js +22 -7
- package/dist/esm/lib/humanizeLLMError.js.map +1 -1
- package/dist/esm/maps/engagement/parkCard.d.ts +5 -1
- package/dist/esm/maps/engagement/parkCard.js +10 -3
- package/dist/esm/maps/engagement/parkCard.js.map +1 -1
- package/dist/esm/mcp/mcpClient.js +30 -2
- package/dist/esm/mcp/mcpClient.js.map +1 -1
- package/dist/esm/mcp/mcpServe.js +5 -1
- package/dist/esm/mcp/mcpServe.js.map +1 -1
- package/dist/esm/mcp/plainData.d.ts +44 -0
- package/dist/esm/mcp/plainData.js +204 -0
- package/dist/esm/mcp/plainData.js.map +1 -0
- package/dist/esm/mcp/sdkLoadFailure.d.ts +6 -7
- package/dist/esm/mcp/sdkLoadFailure.js +4 -4
- package/dist/esm/mcp/sdkLoadFailure.js.map +1 -1
- package/dist/esm/mcp/throttleRetry.d.ts +51 -0
- package/dist/esm/mcp/throttleRetry.js +37 -4
- package/dist/esm/mcp/throttleRetry.js.map +1 -1
- package/dist/esm/mcp/toolResult.js +8 -50
- package/dist/esm/mcp/toolResult.js.map +1 -1
- package/dist/esm/mcp/types.d.ts +10 -6
- package/dist/esm/memory/beats/llmExtractor.js +6 -3
- package/dist/esm/memory/beats/llmExtractor.js.map +1 -1
- package/dist/esm/memory/define.js +45 -1
- package/dist/esm/memory/define.js.map +1 -1
- package/dist/esm/memory/define.types.d.ts +24 -0
- package/dist/esm/memory/define.types.js.map +1 -1
- package/dist/esm/memory/facts/llmFactExtractor.js +6 -3
- package/dist/esm/memory/facts/llmFactExtractor.js.map +1 -1
- package/dist/esm/memory/stages/formatDefault.js +3 -1
- package/dist/esm/memory/stages/formatDefault.js.map +1 -1
- package/dist/esm/memory/stages/summarize.js +16 -5
- package/dist/esm/memory/stages/summarize.js.map +1 -1
- package/dist/esm/memory/store/InMemoryStore.d.ts +8 -3
- package/dist/esm/memory/store/InMemoryStore.js +12 -3
- package/dist/esm/memory/store/InMemoryStore.js.map +1 -1
- package/dist/esm/memory/store/index.d.ts +1 -0
- package/dist/esm/memory/store/index.js +5 -0
- package/dist/esm/memory/store/index.js.map +1 -1
- package/dist/esm/memory/store/types.d.ts +38 -4
- package/dist/esm/memory/store/writeOptions.d.ts +118 -0
- package/dist/esm/memory/store/writeOptions.js +242 -0
- package/dist/esm/memory/store/writeOptions.js.map +1 -0
- package/dist/esm/memory-providers.d.ts +1 -1
- package/dist/esm/memory-providers.js +4 -1
- package/dist/esm/memory-providers.js.map +1 -1
- package/dist/esm/patterns/LlmRouter.js +10 -5
- package/dist/esm/patterns/LlmRouter.js.map +1 -1
- package/dist/esm/patterns/MapReduce.js +8 -2
- package/dist/esm/patterns/MapReduce.js.map +1 -1
- package/dist/esm/redaction/conversation.js +3 -0
- package/dist/esm/redaction/conversation.js.map +1 -1
- package/dist/esm/redaction/knownStrings.js +1 -0
- package/dist/esm/redaction/knownStrings.js.map +1 -1
- package/dist/esm/reliability/buildReliabilityGateChart.js +7 -1
- package/dist/esm/reliability/buildReliabilityGateChart.js.map +1 -1
- package/dist/esm/resilience/withCircuitBreaker.js +5 -2
- package/dist/esm/resilience/withCircuitBreaker.js.map +1 -1
- package/dist/esm/resilience/withFallback.js +6 -0
- package/dist/esm/resilience/withFallback.js.map +1 -1
- package/dist/esm/resilience/withRetry.js +5 -0
- package/dist/esm/resilience/withRetry.js.map +1 -1
- package/dist/esm/time-travel/servedView.js +1 -1
- package/dist/esm/time-travel/servedView.js.map +1 -1
- package/dist/esm/tool-providers/index.d.ts +5 -0
- package/dist/esm/tool-providers/index.js +6 -0
- package/dist/esm/tool-providers/index.js.map +1 -1
- package/dist/esm/tools/hostFilled.d.ts +110 -0
- package/dist/esm/tools/hostFilled.js +509 -0
- package/dist/esm/tools/hostFilled.js.map +1 -0
- package/dist/esm/trace-toolpack/selfExplain.d.ts +8 -0
- package/dist/esm/trace-toolpack/selfExplain.js +25 -2
- package/dist/esm/trace-toolpack/selfExplain.js.map +1 -1
- package/dist/hosting/envelope.js +5 -0
- package/dist/hosting/envelope.js.map +1 -1
- package/dist/hosting/httpHost.js +5 -78
- package/dist/hosting/httpHost.js.map +1 -1
- package/dist/hosting/index.js +9 -3
- package/dist/hosting/index.js.map +1 -1
- package/dist/hosting/pendingAsk.js +42 -0
- package/dist/hosting/pendingAsk.js.map +1 -0
- package/dist/hosting/protocolAdapter.js +24 -0
- package/dist/hosting/protocolAdapter.js.map +1 -0
- package/dist/hosting/refusalStatus.js +88 -0
- package/dist/hosting/refusalStatus.js.map +1 -0
- package/dist/hosting/requestSealing.js +83 -0
- package/dist/hosting/requestSealing.js.map +1 -0
- package/dist/hosting/standingAgent.js +25 -35
- package/dist/hosting/standingAgent.js.map +1 -1
- package/dist/hosting/stream.js +39 -3
- package/dist/hosting/stream.js.map +1 -1
- package/dist/hosting/streamHandler.js +521 -0
- package/dist/hosting/streamHandler.js.map +1 -0
- package/dist/hosting/types.js.map +1 -1
- package/dist/hosting/verifiedThreads.js +50 -0
- package/dist/hosting/verifiedThreads.js.map +1 -0
- package/dist/identity/requestContext.js +139 -0
- package/dist/identity/requestContext.js.map +1 -0
- package/dist/identity/requestCredentials.js +165 -0
- package/dist/identity/requestCredentials.js.map +1 -0
- package/dist/identity/types.js.map +1 -1
- package/dist/identity.js +13 -1
- package/dist/identity.js.map +1 -1
- package/dist/index.js +20 -3
- package/dist/index.js.map +1 -1
- package/dist/injection-engine/buildInjectionEngineSubflow.js +38 -4
- package/dist/injection-engine/buildInjectionEngineSubflow.js.map +1 -1
- package/dist/injection-engine/constrainedEnumPick.js +4 -2
- package/dist/injection-engine/constrainedEnumPick.js.map +1 -1
- package/dist/injection-engine/evaluator.js +18 -0
- package/dist/injection-engine/evaluator.js.map +1 -1
- package/dist/injection-engine/skillGraph.js +25 -7
- package/dist/injection-engine/skillGraph.js.map +1 -1
- package/dist/injection-engine/skillIntent.js +3 -0
- package/dist/injection-engine/skillIntent.js.map +1 -1
- package/dist/injection-engine/types.js +17 -1
- package/dist/injection-engine/types.js.map +1 -1
- package/dist/lib/abort.js +336 -0
- package/dist/lib/abort.js.map +1 -0
- package/dist/lib/humanizeLLMError.js +23 -8
- package/dist/lib/humanizeLLMError.js.map +1 -1
- package/dist/maps/engagement/parkCard.js +10 -3
- package/dist/maps/engagement/parkCard.js.map +1 -1
- package/dist/mcp/mcpClient.js +30 -2
- package/dist/mcp/mcpClient.js.map +1 -1
- package/dist/mcp/mcpServe.js +5 -1
- package/dist/mcp/mcpServe.js.map +1 -1
- package/dist/mcp/plainData.js +208 -0
- package/dist/mcp/plainData.js.map +1 -0
- package/dist/mcp/sdkLoadFailure.js +4 -4
- package/dist/mcp/sdkLoadFailure.js.map +1 -1
- package/dist/mcp/throttleRetry.js +41 -6
- package/dist/mcp/throttleRetry.js.map +1 -1
- package/dist/mcp/toolResult.js +8 -50
- package/dist/mcp/toolResult.js.map +1 -1
- package/dist/memory/beats/llmExtractor.js +6 -3
- package/dist/memory/beats/llmExtractor.js.map +1 -1
- package/dist/memory/define.js +45 -1
- package/dist/memory/define.js.map +1 -1
- package/dist/memory/define.types.js.map +1 -1
- package/dist/memory/facts/llmFactExtractor.js +6 -3
- package/dist/memory/facts/llmFactExtractor.js.map +1 -1
- package/dist/memory/stages/formatDefault.js +3 -1
- package/dist/memory/stages/formatDefault.js.map +1 -1
- package/dist/memory/stages/summarize.js +16 -5
- package/dist/memory/stages/summarize.js.map +1 -1
- package/dist/memory/store/InMemoryStore.js +12 -3
- package/dist/memory/store/InMemoryStore.js.map +1 -1
- package/dist/memory/store/index.js +11 -1
- package/dist/memory/store/index.js.map +1 -1
- package/dist/memory/store/writeOptions.js +250 -0
- package/dist/memory/store/writeOptions.js.map +1 -0
- package/dist/memory-providers.js +4 -1
- package/dist/memory-providers.js.map +1 -1
- package/dist/patterns/LlmRouter.js +9 -4
- package/dist/patterns/LlmRouter.js.map +1 -1
- package/dist/patterns/MapReduce.js +8 -2
- package/dist/patterns/MapReduce.js.map +1 -1
- package/dist/redaction/conversation.js +3 -0
- package/dist/redaction/conversation.js.map +1 -1
- package/dist/redaction/knownStrings.js +1 -0
- package/dist/redaction/knownStrings.js.map +1 -1
- package/dist/reliability/buildReliabilityGateChart.js +7 -1
- package/dist/reliability/buildReliabilityGateChart.js.map +1 -1
- package/dist/resilience/withCircuitBreaker.js +5 -2
- package/dist/resilience/withCircuitBreaker.js.map +1 -1
- package/dist/resilience/withFallback.js +6 -0
- package/dist/resilience/withFallback.js.map +1 -1
- package/dist/resilience/withRetry.js +5 -0
- package/dist/resilience/withRetry.js.map +1 -1
- package/dist/time-travel/servedView.js +1 -1
- package/dist/time-travel/servedView.js.map +1 -1
- package/dist/tool-providers/index.js +10 -1
- package/dist/tool-providers/index.js.map +1 -1
- package/dist/tools/hostFilled.js +517 -0
- package/dist/tools/hostFilled.js.map +1 -0
- package/dist/trace-toolpack/selfExplain.js +25 -2
- package/dist/trace-toolpack/selfExplain.js.map +1 -1
- package/dist/types/adapters/llm/AnthropicProvider.d.ts +9 -2
- package/dist/types/adapters/llm/AnthropicProvider.d.ts.map +1 -1
- package/dist/types/adapters/llm/BedrockProvider.d.ts +6 -1
- package/dist/types/adapters/llm/BedrockProvider.d.ts.map +1 -1
- package/dist/types/adapters/llm/BrowserAnthropicProvider.d.ts.map +1 -1
- package/dist/types/adapters/llm/BrowserOpenAIProvider.d.ts.map +1 -1
- package/dist/types/adapters/llm/FoundryLocalProvider.d.ts.map +1 -1
- package/dist/types/adapters/llm/GeminiProvider.d.ts.map +1 -1
- package/dist/types/adapters/llm/InvokeModelGatewayProvider.d.ts.map +1 -1
- package/dist/types/adapters/llm/MockProvider.d.ts.map +1 -1
- package/dist/types/adapters/llm/OllamaProvider.d.ts.map +1 -1
- package/dist/types/adapters/llm/OpenAIProvider.d.ts +6 -1
- package/dist/types/adapters/llm/OpenAIProvider.d.ts.map +1 -1
- package/dist/types/adapters/mcp/agentcoreRuntime/errorType.d.ts +13 -0
- package/dist/types/adapters/mcp/agentcoreRuntime/errorType.d.ts.map +1 -0
- package/dist/types/adapters/mcp/agentcoreRuntime/invoke.d.ts +117 -0
- package/dist/types/adapters/mcp/agentcoreRuntime/invoke.d.ts.map +1 -0
- package/dist/types/adapters/mcp/agentcoreRuntime/safeAnswer.d.ts +50 -0
- package/dist/types/adapters/mcp/agentcoreRuntime/safeAnswer.d.ts.map +1 -0
- package/dist/types/adapters/mcp/agentcoreRuntime/session.d.ts +81 -0
- package/dist/types/adapters/mcp/agentcoreRuntime/session.d.ts.map +1 -0
- package/dist/types/adapters/mcp/agentcoreRuntime/sessionBusy.d.ts +62 -0
- package/dist/types/adapters/mcp/agentcoreRuntime/sessionBusy.d.ts.map +1 -0
- package/dist/types/adapters/mcp/agentcoreRuntime/strictJson.d.ts +38 -0
- package/dist/types/adapters/mcp/agentcoreRuntime/strictJson.d.ts.map +1 -0
- package/dist/types/adapters/mcp/agentcoreRuntime/transport.d.ts +200 -0
- package/dist/types/adapters/mcp/agentcoreRuntime/transport.d.ts.map +1 -0
- package/dist/types/adapters/memory/agentcore.d.ts +152 -7
- package/dist/types/adapters/memory/agentcore.d.ts.map +1 -1
- package/dist/types/adapters/memory/memoryBank.d.ts +3 -2
- package/dist/types/adapters/memory/memoryBank.d.ts.map +1 -1
- package/dist/types/adapters/memory/pgVector.d.ts.map +1 -1
- package/dist/types/adapters/memory/redis.d.ts +8 -3
- package/dist/types/adapters/memory/redis.d.ts.map +1 -1
- package/dist/types/adapters/memory/s3Vectors.d.ts.map +1 -1
- package/dist/types/adapters/memory/sqliteVector.d.ts.map +1 -1
- package/dist/types/ag-ui/adapter.d.ts +119 -0
- package/dist/types/ag-ui/adapter.d.ts.map +1 -0
- package/dist/types/ag-ui/framing.d.ts +53 -0
- package/dist/types/ag-ui/framing.d.ts.map +1 -0
- package/dist/types/ag-ui/frontendTools.d.ts +38 -0
- package/dist/types/ag-ui/frontendTools.d.ts.map +1 -0
- package/dist/types/ag-ui/ids.d.ts +44 -0
- package/dist/types/ag-ui/ids.d.ts.map +1 -0
- package/dist/types/ag-ui/index.d.ts +20 -0
- package/dist/types/ag-ui/index.d.ts.map +1 -0
- package/dist/types/ag-ui/request.d.ts +152 -0
- package/dist/types/ag-ui/request.d.ts.map +1 -0
- package/dist/types/ag-ui/serializer.d.ts +174 -0
- package/dist/types/ag-ui/serializer.d.ts.map +1 -0
- package/dist/types/ag-ui/types.d.ts +306 -0
- package/dist/types/ag-ui/types.d.ts.map +1 -0
- package/dist/types/answer-validation/index.d.ts +2 -1
- package/dist/types/answer-validation/index.d.ts.map +1 -1
- package/dist/types/answer-validation/toolLedger.d.ts +66 -0
- package/dist/types/answer-validation/toolLedger.d.ts.map +1 -0
- package/dist/types/answer-validation/types.d.ts +48 -0
- package/dist/types/answer-validation/types.d.ts.map +1 -1
- package/dist/types/answer-validation/validate.d.ts +2 -2
- package/dist/types/answer-validation/validate.d.ts.map +1 -1
- package/dist/types/classify/typesafe.d.ts.map +1 -1
- package/dist/types/core/Agent.d.ts +11 -1
- package/dist/types/core/Agent.d.ts.map +1 -1
- package/dist/types/core/LLMCall.d.ts +2 -1
- package/dist/types/core/LLMCall.d.ts.map +1 -1
- package/dist/types/core/RunnerBase.d.ts +39 -8
- package/dist/types/core/RunnerBase.d.ts.map +1 -1
- package/dist/types/core/agent/buildAgentChart.d.ts.map +1 -1
- package/dist/types/core/agent/buildAgentMessageApiChart.d.ts +16 -0
- package/dist/types/core/agent/buildAgentMessageApiChart.d.ts.map +1 -1
- package/dist/types/core/agent/buildDynamicAgentChart.d.ts.map +1 -1
- package/dist/types/core/agent/buildMessageApiChart.d.ts +16 -0
- package/dist/types/core/agent/buildMessageApiChart.d.ts.map +1 -1
- package/dist/types/core/agent/callerIdentity.d.ts.map +1 -1
- package/dist/types/core/agent/stages/answerValidation.d.ts.map +1 -1
- package/dist/types/core/agent/stages/callLLM.d.ts.map +1 -1
- package/dist/types/core/agent/stages/routeTurn.d.ts +1 -1
- package/dist/types/core/agent/stages/routeTurn.d.ts.map +1 -1
- package/dist/types/core/agent/stages/seed.d.ts +18 -1
- package/dist/types/core/agent/stages/seed.d.ts.map +1 -1
- package/dist/types/core/agent/stages/toolCalls.d.ts +32 -1
- package/dist/types/core/agent/stages/toolCalls.d.ts.map +1 -1
- package/dist/types/core/agent/types.d.ts +26 -6
- package/dist/types/core/agent/types.d.ts.map +1 -1
- package/dist/types/core/agent/window/strategies/summarizeOldest.d.ts.map +1 -1
- package/dist/types/core/agent/window/summarize.d.ts.map +1 -1
- package/dist/types/core/memberRun.d.ts +154 -0
- package/dist/types/core/memberRun.d.ts.map +1 -0
- package/dist/types/core/requestOfRun.d.ts +22 -0
- package/dist/types/core/requestOfRun.d.ts.map +1 -0
- package/dist/types/core/runner.d.ts +15 -3
- package/dist/types/core/runner.d.ts.map +1 -1
- package/dist/types/core/slots/buildToolsSlot.d.ts +0 -16
- package/dist/types/core/slots/buildToolsSlot.d.ts.map +1 -1
- package/dist/types/core-flow/Conditional.d.ts +10 -1
- package/dist/types/core-flow/Conditional.d.ts.map +1 -1
- package/dist/types/core-flow/Graph.d.ts +2 -1
- package/dist/types/core-flow/Graph.d.ts.map +1 -1
- package/dist/types/core-flow/Loop.d.ts +10 -1
- package/dist/types/core-flow/Loop.d.ts.map +1 -1
- package/dist/types/core-flow/Parallel.d.ts +10 -1
- package/dist/types/core-flow/Parallel.d.ts.map +1 -1
- package/dist/types/core-flow/Sequence.d.ts +10 -1
- package/dist/types/core-flow/Sequence.d.ts.map +1 -1
- package/dist/types/core-flow/Workflow.d.ts +2 -1
- package/dist/types/core-flow/Workflow.d.ts.map +1 -1
- package/dist/types/doors/ag-ui.d.ts +20 -0
- package/dist/types/doors/ag-ui.d.ts.map +1 -0
- package/dist/types/doors/security.d.ts +2 -1
- package/dist/types/doors/security.d.ts.map +1 -1
- package/dist/types/events/payloads.d.ts +4 -2
- package/dist/types/events/payloads.d.ts.map +1 -1
- package/dist/types/hosting/httpHost.d.ts.map +1 -1
- package/dist/types/hosting/index.d.ts +5 -1
- package/dist/types/hosting/index.d.ts.map +1 -1
- package/dist/types/hosting/pendingAsk.d.ts +20 -0
- package/dist/types/hosting/pendingAsk.d.ts.map +1 -0
- package/dist/types/hosting/protocolAdapter.d.ts +233 -0
- package/dist/types/hosting/protocolAdapter.d.ts.map +1 -0
- package/dist/types/hosting/refusalStatus.d.ts +31 -0
- package/dist/types/hosting/refusalStatus.d.ts.map +1 -0
- package/dist/types/hosting/requestSealing.d.ts +66 -0
- package/dist/types/hosting/requestSealing.d.ts.map +1 -0
- package/dist/types/hosting/standingAgent.d.ts.map +1 -1
- package/dist/types/hosting/stream.d.ts +60 -0
- package/dist/types/hosting/stream.d.ts.map +1 -1
- package/dist/types/hosting/streamHandler.d.ts +154 -0
- package/dist/types/hosting/streamHandler.d.ts.map +1 -0
- package/dist/types/hosting/types.d.ts +44 -0
- package/dist/types/hosting/types.d.ts.map +1 -1
- package/dist/types/hosting/verifiedThreads.d.ts +30 -0
- package/dist/types/hosting/verifiedThreads.d.ts.map +1 -0
- package/dist/types/identity/requestContext.d.ts +97 -0
- package/dist/types/identity/requestContext.d.ts.map +1 -0
- package/dist/types/identity/requestCredentials.d.ts +100 -0
- package/dist/types/identity/requestCredentials.d.ts.map +1 -0
- package/dist/types/identity/types.d.ts +11 -0
- package/dist/types/identity/types.d.ts.map +1 -1
- package/dist/types/identity.d.ts +2 -0
- package/dist/types/identity.d.ts.map +1 -1
- package/dist/types/index.d.ts +3 -1
- package/dist/types/index.d.ts.map +1 -1
- package/dist/types/injection-engine/buildInjectionEngineSubflow.d.ts +11 -0
- package/dist/types/injection-engine/buildInjectionEngineSubflow.d.ts.map +1 -1
- package/dist/types/injection-engine/constrainedEnumPick.d.ts.map +1 -1
- package/dist/types/injection-engine/evaluator.d.ts +6 -0
- package/dist/types/injection-engine/evaluator.d.ts.map +1 -1
- package/dist/types/injection-engine/skillIntent.d.ts +4 -2
- package/dist/types/injection-engine/skillIntent.d.ts.map +1 -1
- package/dist/types/injection-engine/types.d.ts +27 -1
- package/dist/types/injection-engine/types.d.ts.map +1 -1
- package/dist/types/lib/abort.d.ts +144 -0
- package/dist/types/lib/abort.d.ts.map +1 -0
- package/dist/types/lib/humanizeLLMError.d.ts +15 -0
- package/dist/types/lib/humanizeLLMError.d.ts.map +1 -1
- package/dist/types/maps/engagement/parkCard.d.ts +5 -1
- package/dist/types/maps/engagement/parkCard.d.ts.map +1 -1
- package/dist/types/mcp/mcpServe.d.ts.map +1 -1
- package/dist/types/mcp/plainData.d.ts +45 -0
- package/dist/types/mcp/plainData.d.ts.map +1 -0
- package/dist/types/mcp/sdkLoadFailure.d.ts +6 -7
- package/dist/types/mcp/sdkLoadFailure.d.ts.map +1 -1
- package/dist/types/mcp/throttleRetry.d.ts +51 -0
- package/dist/types/mcp/throttleRetry.d.ts.map +1 -1
- package/dist/types/mcp/toolResult.d.ts.map +1 -1
- package/dist/types/mcp/types.d.ts +10 -6
- package/dist/types/mcp/types.d.ts.map +1 -1
- package/dist/types/memory/beats/llmExtractor.d.ts.map +1 -1
- package/dist/types/memory/define.d.ts.map +1 -1
- package/dist/types/memory/define.types.d.ts +24 -0
- package/dist/types/memory/define.types.d.ts.map +1 -1
- package/dist/types/memory/facts/llmFactExtractor.d.ts.map +1 -1
- package/dist/types/memory/stages/formatDefault.d.ts.map +1 -1
- package/dist/types/memory/stages/summarize.d.ts.map +1 -1
- package/dist/types/memory/store/InMemoryStore.d.ts +8 -3
- package/dist/types/memory/store/InMemoryStore.d.ts.map +1 -1
- package/dist/types/memory/store/index.d.ts +1 -0
- package/dist/types/memory/store/index.d.ts.map +1 -1
- package/dist/types/memory/store/types.d.ts +38 -4
- package/dist/types/memory/store/types.d.ts.map +1 -1
- package/dist/types/memory/store/writeOptions.d.ts +119 -0
- package/dist/types/memory/store/writeOptions.d.ts.map +1 -0
- package/dist/types/memory-providers.d.ts +1 -1
- package/dist/types/memory-providers.d.ts.map +1 -1
- package/dist/types/patterns/LlmRouter.d.ts.map +1 -1
- package/dist/types/patterns/MapReduce.d.ts.map +1 -1
- package/dist/types/redaction/conversation.d.ts.map +1 -1
- package/dist/types/redaction/knownStrings.d.ts.map +1 -1
- package/dist/types/reliability/buildReliabilityGateChart.d.ts.map +1 -1
- package/dist/types/resilience/withCircuitBreaker.d.ts.map +1 -1
- package/dist/types/resilience/withFallback.d.ts.map +1 -1
- package/dist/types/resilience/withRetry.d.ts.map +1 -1
- package/dist/types/tool-providers/index.d.ts +5 -0
- package/dist/types/tool-providers/index.d.ts.map +1 -1
- package/dist/types/tools/hostFilled.d.ts +111 -0
- package/dist/types/tools/hostFilled.d.ts.map +1 -0
- package/dist/types/trace-toolpack/selfExplain.d.ts +8 -0
- package/dist/types/trace-toolpack/selfExplain.d.ts.map +1 -1
- package/package.json +25 -1
|
@@ -0,0 +1,199 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* agentCoreRuntimeMcpTransport — an MCP server hosted on AWS Bedrock
|
|
3
|
+
* **AgentCore Runtime**, reached as an ordinary MCP transport.
|
|
4
|
+
*
|
|
5
|
+
* const orders = await mcpClient({
|
|
6
|
+
* name: 'orders',
|
|
7
|
+
* transport: agentCoreRuntimeMcpTransport({
|
|
8
|
+
* agentRuntimeArn: 'arn:aws:bedrock-agentcore:us-west-2:123456789012:runtime/orders_mcp-a1b2c3',
|
|
9
|
+
* region: 'us-west-2',
|
|
10
|
+
* }),
|
|
11
|
+
* });
|
|
12
|
+
*
|
|
13
|
+
* ── Why this exists ──────────────────────────────────────────────────────────
|
|
14
|
+
* `agentCoreGatewayTransport` reaches a Gateway; `agentCoreRuntimeHost` hosts
|
|
15
|
+
* OUR agent on Runtime. Neither calls an MCP server somebody deployed TO
|
|
16
|
+
* Runtime, and that server is not reachable as a plain URL: every request goes
|
|
17
|
+
* through `InvokeAgentRuntime`, it lands in a runtime SESSION that has to be
|
|
18
|
+
* carried from call to call, and the platform answers a request that arrives
|
|
19
|
+
* while that session is still coming up with an HTTP 200 whose body says
|
|
20
|
+
* "Session operation in progress, please retry" — which no MCP client retries.
|
|
21
|
+
*
|
|
22
|
+
* ── What it is: one port, three strategies ───────────────────────────────────
|
|
23
|
+
* The port is the existing one: this returns an `http` member of
|
|
24
|
+
* `McpTransport`, so `mcpClient` builds it like any other Streamable HTTP
|
|
25
|
+
* server and knows nothing about AgentCore. Everything AgentCore-specific sits
|
|
26
|
+
* in the `fetch` it carries, composed from three choices, one file each:
|
|
27
|
+
*
|
|
28
|
+
* session (`session.ts`) 'per-call' (the default: a session per request),
|
|
29
|
+
* or 'reuse' (one session per MCP client, keyed by
|
|
30
|
+
* a handle the transport issues)
|
|
31
|
+
* retry (`sessionBusy.ts`) the session-busy refusal, retried with bounded
|
|
32
|
+
* backoff by the SAME loop `mcpClient` uses for a
|
|
33
|
+
* 429 (`mcp/throttleRetry.ts` · `retryingFetchWhen`)
|
|
34
|
+
* auth (`invoke.ts`) 'sigv4' through the AWS SDK's InvokeAgentRuntime,
|
|
35
|
+
* or a bearer token over the documented HTTPS
|
|
36
|
+
* endpoint — the SDK has no bearer scheme, and the
|
|
37
|
+
* API reference says an OAuth caller must use HTTPS
|
|
38
|
+
*
|
|
39
|
+
* in that order, outermost first: the session is applied once per request, so
|
|
40
|
+
* every attempt of it lands in the same runtime session, and every attempt is
|
|
41
|
+
* signed (or vended) afresh, the ordering `mcp/throttleRetry.ts` requires.
|
|
42
|
+
* What the MCP client reads of a failure is rewritten from the library's own
|
|
43
|
+
* fixed sentences and safe ids (`safeAnswer.ts`), never the service's text.
|
|
44
|
+
* `mcpClient`'s own 429 retry still wraps the whole thing.
|
|
45
|
+
*
|
|
46
|
+
* ── What it does NOT do ──────────────────────────────────────────────────────
|
|
47
|
+
* Deploy or manage a runtime (a control-plane job), or host one (that is
|
|
48
|
+
* `agentCoreRuntimeHost`). This is the CLIENT side of a server somebody already
|
|
49
|
+
* deployed with `--protocol MCP`.
|
|
50
|
+
*
|
|
51
|
+
* Pattern: Facade over three Strategies. Role: outer ring, vendor adapter.
|
|
52
|
+
*/
|
|
53
|
+
import { type FetchLike } from '../../../mcp/gatewayTransport.js';
|
|
54
|
+
import { type ThrottleRetryOptions } from '../../../mcp/throttleRetry.js';
|
|
55
|
+
import type { McpHttpTransport } from '../../../mcp/types.js';
|
|
56
|
+
import type { CredentialProvider } from '../../../identity/types.js';
|
|
57
|
+
import { type AgentCoreRuntimeSdkClient, type BedrockAgentCoreRuntimeSdkModule } from './invoke.js';
|
|
58
|
+
import { type AgentCoreRuntimeSession } from './session.js';
|
|
59
|
+
/**
|
|
60
|
+
* A bearer token, for a runtime whose inbound auth is OAuth (a JWT authorizer).
|
|
61
|
+
*
|
|
62
|
+
* Vended PER REQUEST by the provider — the same once-and-dropped rule as
|
|
63
|
+
* `gatewayTransport`, through the same code.
|
|
64
|
+
*/
|
|
65
|
+
export interface AgentCoreRuntimeBearerAuth {
|
|
66
|
+
/** Who vends the token. `agentCoreIdentity()` or any `CredentialProvider`. */
|
|
67
|
+
readonly bearer: CredentialProvider;
|
|
68
|
+
/** The downstream service id your provider keys on. Default `'runtime'`. */
|
|
69
|
+
readonly service?: string;
|
|
70
|
+
/** OAuth scopes, when the provider uses them. */
|
|
71
|
+
readonly scopes?: readonly string[];
|
|
72
|
+
/**
|
|
73
|
+
* `'machine'` (2-legged), the only mode. `'user'` is refused: the transport
|
|
74
|
+
* asks for its token without naming any user, so a user-delegated token
|
|
75
|
+
* would be sent for whoever calls through the client. For a token per user,
|
|
76
|
+
* build a transport per user whose provider vends that user's token.
|
|
77
|
+
*/
|
|
78
|
+
readonly mode?: 'machine';
|
|
79
|
+
/**
|
|
80
|
+
* Your own `fetch`, called UNDERNEATH the per-request vending — an HTTP
|
|
81
|
+
* agent, a proxy. It sees the final headers, the vended one included.
|
|
82
|
+
*/
|
|
83
|
+
readonly fetch?: FetchLike;
|
|
84
|
+
}
|
|
85
|
+
/**
|
|
86
|
+
* How requests are authenticated — the runtime's inbound auth decides which.
|
|
87
|
+
*
|
|
88
|
+
* - `'sigv4'` — IAM. The AWS SDK signs `InvokeAgentRuntime` with your AWS
|
|
89
|
+
* credentials (the default chain, or the `client` you pass).
|
|
90
|
+
* - `{ bearer }` — OAuth. A plain HTTPS request with `Authorization: Bearer`,
|
|
91
|
+
* because the SDK cannot send a bearer token.
|
|
92
|
+
*/
|
|
93
|
+
export type AgentCoreRuntimeAuth = 'sigv4' | AgentCoreRuntimeBearerAuth;
|
|
94
|
+
/**
|
|
95
|
+
* The session-busy retry: the same ceilings and the same `onRetry` report as
|
|
96
|
+
* `mcpClient`'s `retryOnThrottle`, applied to AgentCore's own refusal.
|
|
97
|
+
*/
|
|
98
|
+
export type AgentCoreRuntimeRetryOptions = ThrottleRetryOptions;
|
|
99
|
+
/** Options for {@link agentCoreRuntimeMcpTransport}. */
|
|
100
|
+
export interface AgentCoreRuntimeMcpTransportOptions {
|
|
101
|
+
/**
|
|
102
|
+
* The runtime hosting the MCP server — its ARN, as `agentcore deploy` prints
|
|
103
|
+
* it, or its id together with {@link accountId}.
|
|
104
|
+
*/
|
|
105
|
+
readonly agentRuntimeArn: string;
|
|
106
|
+
/** The region it runs in, e.g. `'us-west-2'`. */
|
|
107
|
+
readonly region: string;
|
|
108
|
+
/** The endpoint (version) to invoke. The runtime's default endpoint when omitted. */
|
|
109
|
+
readonly qualifier?: string;
|
|
110
|
+
/** The owning account — required by AgentCore when `agentRuntimeArn` is an id, not an ARN. */
|
|
111
|
+
readonly accountId?: string;
|
|
112
|
+
/** How requests are authenticated. Default `'sigv4'`. */
|
|
113
|
+
readonly auth?: AgentCoreRuntimeAuth;
|
|
114
|
+
/**
|
|
115
|
+
* Which runtime session each request lands in. Default `'per-call'`.
|
|
116
|
+
*
|
|
117
|
+
* - `'per-call'` — every request in a session of its own; nothing carries
|
|
118
|
+
* over, so one client can serve every user of a process. Needs a
|
|
119
|
+
* stateless server (the runtime's recommended default).
|
|
120
|
+
* - `'reuse'` — one session per CLIENT: each `mcpClient` built on this
|
|
121
|
+
* transport keeps its own runtime session for its life. **Build one
|
|
122
|
+
* client per conversation**: a client shared by two users is one
|
|
123
|
+
* session — one microVM, one server state — for both.
|
|
124
|
+
*/
|
|
125
|
+
readonly session?: AgentCoreRuntimeSession;
|
|
126
|
+
/**
|
|
127
|
+
* Retry AgentCore's "session operation in progress" refusal — the MCP
|
|
128
|
+
* contract's HTTP 200 with JSON-RPC -32005, or the API's 409
|
|
129
|
+
* `RetryableConflictException`. On by default: up to 5 attempts, never more
|
|
130
|
+
* than 10 s of waiting in total, jittered exponential backoff. `false` lets
|
|
131
|
+
* the refusal through on the first attempt.
|
|
132
|
+
*
|
|
133
|
+
* Nothing else is retried here: a 429 goes to `mcpClient`'s own throttle
|
|
134
|
+
* retry, and a 5xx, a dropped connection or any other JSON-RPC error
|
|
135
|
+
* (throttling's -32003 included) is delivered as it is — it may be the
|
|
136
|
+
* record of work that ran.
|
|
137
|
+
*/
|
|
138
|
+
readonly retry?: boolean | AgentCoreRuntimeRetryOptions;
|
|
139
|
+
/**
|
|
140
|
+
* SigV4 only: a `BedrockAgentCoreClient` you built, so its credentials,
|
|
141
|
+
* region and retry settings are the ones used. Refused with `{ bearer }`.
|
|
142
|
+
*
|
|
143
|
+
* **Build it with `maxAttempts: 1`.** The client this transport builds has
|
|
144
|
+
* the SDK's own retry off, because the SDK's standard policy re-sends a call
|
|
145
|
+
* after a 5xx or a dropped connection — work that may already have run. Your
|
|
146
|
+
* client keeps whatever policy you gave it.
|
|
147
|
+
*/
|
|
148
|
+
readonly client?: AgentCoreRuntimeSdkClient;
|
|
149
|
+
/**
|
|
150
|
+
* SigV4 only: the `@aws-sdk/client-bedrock-agentcore` module, imported by
|
|
151
|
+
* YOU. Refused with `{ bearer }`, which loads no AWS SDK.
|
|
152
|
+
*
|
|
153
|
+
* Without it the transport loads the SDK itself through a lazy `require`,
|
|
154
|
+
* which a bundler (esbuild, webpack) cannot follow. Pass it when your app is
|
|
155
|
+
* bundled, so the bundler sees a static import: import
|
|
156
|
+
* `BedrockAgentCoreClient` and `InvokeAgentRuntimeCommand` from
|
|
157
|
+
* `@aws-sdk/client-bedrock-agentcore` and pass
|
|
158
|
+
* `sdk: { BedrockAgentCoreClient, InvokeAgentRuntimeCommand }` (named
|
|
159
|
+
* imports let the bundler drop the rest of the client).
|
|
160
|
+
*
|
|
161
|
+
* The transport still builds its own client from it, with the SDK's retry
|
|
162
|
+
* off. Either way the SDK is read when the transport is built, so a missing
|
|
163
|
+
* one is refused there, not at the first tool call.
|
|
164
|
+
*/
|
|
165
|
+
readonly sdk?: BedrockAgentCoreRuntimeSdkModule;
|
|
166
|
+
/**
|
|
167
|
+
* @deprecated Use {@link AgentCoreRuntimeMcpTransportOptions.sdk}. Kept
|
|
168
|
+
* because it shipped in the published options type; it means exactly `sdk`,
|
|
169
|
+
* and passing both with different modules is refused.
|
|
170
|
+
*/
|
|
171
|
+
readonly _sdk?: BedrockAgentCoreRuntimeSdkModule;
|
|
172
|
+
}
|
|
173
|
+
/**
|
|
174
|
+
* An MCP transport for a server hosted on AgentCore Runtime.
|
|
175
|
+
*
|
|
176
|
+
* @throws when the runtime or region is missing, when a strategy is unknown,
|
|
177
|
+
* when `client` or `sdk` is given beside `{ bearer }`, or — for `'sigv4'` —
|
|
178
|
+
* when the AWS SDK peer dependency cannot be loaded and no `sdk` was passed.
|
|
179
|
+
* All of these are thrown here, when the transport is built, never at the
|
|
180
|
+
* first call.
|
|
181
|
+
*/
|
|
182
|
+
export declare function agentCoreRuntimeMcpTransport(options: AgentCoreRuntimeMcpTransportOptions): McpHttpTransport;
|
|
183
|
+
/** Where a runtime's MCP endpoint is, as {@link agentCoreRuntimeUrl} needs it. */
|
|
184
|
+
export interface AgentCoreRuntimeUrlOptions {
|
|
185
|
+
readonly agentRuntimeArn: string;
|
|
186
|
+
readonly region: string;
|
|
187
|
+
readonly qualifier?: string;
|
|
188
|
+
readonly accountId?: string;
|
|
189
|
+
}
|
|
190
|
+
/**
|
|
191
|
+
* The HTTPS endpoint of a runtime's MCP server:
|
|
192
|
+
* `https://bedrock-agentcore.{region}.amazonaws.com/runtimes/{url-encoded ARN}/invocations`,
|
|
193
|
+
* with `qualifier` / `accountId` as query parameters when given — the request
|
|
194
|
+
* line of `InvokeAgentRuntime`, and the URL AgentCore's own MCP examples dial.
|
|
195
|
+
*
|
|
196
|
+
* @throws when `agentRuntimeArn` or `region` is missing, or the region is not
|
|
197
|
+
* shaped like one (it becomes part of a hostname).
|
|
198
|
+
*/
|
|
199
|
+
export declare function agentCoreRuntimeUrl(options: AgentCoreRuntimeUrlOptions): string;
|
|
@@ -0,0 +1,217 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* agentCoreRuntimeMcpTransport — an MCP server hosted on AWS Bedrock
|
|
3
|
+
* **AgentCore Runtime**, reached as an ordinary MCP transport.
|
|
4
|
+
*
|
|
5
|
+
* const orders = await mcpClient({
|
|
6
|
+
* name: 'orders',
|
|
7
|
+
* transport: agentCoreRuntimeMcpTransport({
|
|
8
|
+
* agentRuntimeArn: 'arn:aws:bedrock-agentcore:us-west-2:123456789012:runtime/orders_mcp-a1b2c3',
|
|
9
|
+
* region: 'us-west-2',
|
|
10
|
+
* }),
|
|
11
|
+
* });
|
|
12
|
+
*
|
|
13
|
+
* ── Why this exists ──────────────────────────────────────────────────────────
|
|
14
|
+
* `agentCoreGatewayTransport` reaches a Gateway; `agentCoreRuntimeHost` hosts
|
|
15
|
+
* OUR agent on Runtime. Neither calls an MCP server somebody deployed TO
|
|
16
|
+
* Runtime, and that server is not reachable as a plain URL: every request goes
|
|
17
|
+
* through `InvokeAgentRuntime`, it lands in a runtime SESSION that has to be
|
|
18
|
+
* carried from call to call, and the platform answers a request that arrives
|
|
19
|
+
* while that session is still coming up with an HTTP 200 whose body says
|
|
20
|
+
* "Session operation in progress, please retry" — which no MCP client retries.
|
|
21
|
+
*
|
|
22
|
+
* ── What it is: one port, three strategies ───────────────────────────────────
|
|
23
|
+
* The port is the existing one: this returns an `http` member of
|
|
24
|
+
* `McpTransport`, so `mcpClient` builds it like any other Streamable HTTP
|
|
25
|
+
* server and knows nothing about AgentCore. Everything AgentCore-specific sits
|
|
26
|
+
* in the `fetch` it carries, composed from three choices, one file each:
|
|
27
|
+
*
|
|
28
|
+
* session (`session.ts`) 'per-call' (the default: a session per request),
|
|
29
|
+
* or 'reuse' (one session per MCP client, keyed by
|
|
30
|
+
* a handle the transport issues)
|
|
31
|
+
* retry (`sessionBusy.ts`) the session-busy refusal, retried with bounded
|
|
32
|
+
* backoff by the SAME loop `mcpClient` uses for a
|
|
33
|
+
* 429 (`mcp/throttleRetry.ts` · `retryingFetchWhen`)
|
|
34
|
+
* auth (`invoke.ts`) 'sigv4' through the AWS SDK's InvokeAgentRuntime,
|
|
35
|
+
* or a bearer token over the documented HTTPS
|
|
36
|
+
* endpoint — the SDK has no bearer scheme, and the
|
|
37
|
+
* API reference says an OAuth caller must use HTTPS
|
|
38
|
+
*
|
|
39
|
+
* in that order, outermost first: the session is applied once per request, so
|
|
40
|
+
* every attempt of it lands in the same runtime session, and every attempt is
|
|
41
|
+
* signed (or vended) afresh, the ordering `mcp/throttleRetry.ts` requires.
|
|
42
|
+
* What the MCP client reads of a failure is rewritten from the library's own
|
|
43
|
+
* fixed sentences and safe ids (`safeAnswer.ts`), never the service's text.
|
|
44
|
+
* `mcpClient`'s own 429 retry still wraps the whole thing.
|
|
45
|
+
*
|
|
46
|
+
* ── What it does NOT do ──────────────────────────────────────────────────────
|
|
47
|
+
* Deploy or manage a runtime (a control-plane job), or host one (that is
|
|
48
|
+
* `agentCoreRuntimeHost`). This is the CLIENT side of a server somebody already
|
|
49
|
+
* deployed with `--protocol MCP`.
|
|
50
|
+
*
|
|
51
|
+
* Pattern: Facade over three Strategies. Role: outer ring, vendor adapter.
|
|
52
|
+
*/
|
|
53
|
+
import { createVendingFetch, gatewayTransport, } from '../../../mcp/gatewayTransport.js';
|
|
54
|
+
import { retryingFetchWhen, } from '../../../mcp/throttleRetry.js';
|
|
55
|
+
import { invokeFetch, invokeSdk, } from './invoke.js';
|
|
56
|
+
import { safeAnswer } from './safeAnswer.js';
|
|
57
|
+
import { sessionStrategy } from './session.js';
|
|
58
|
+
import { sessionBusy } from './sessionBusy.js';
|
|
59
|
+
/** The session-busy retry's own ceilings, when the caller set none. */
|
|
60
|
+
const DEFAULT_RETRY = { maxAttempts: 5, maxWaitMs: 10_000 };
|
|
61
|
+
/** What a bearer token is vended for, unless the caller names another service. */
|
|
62
|
+
const DEFAULT_BEARER_SERVICE = 'runtime';
|
|
63
|
+
/** A region is a DNS label run, nothing more — it is spliced into a hostname. */
|
|
64
|
+
const REGION_SHAPE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
|
|
65
|
+
/**
|
|
66
|
+
* An MCP transport for a server hosted on AgentCore Runtime.
|
|
67
|
+
*
|
|
68
|
+
* @throws when the runtime or region is missing, when a strategy is unknown,
|
|
69
|
+
* when `client` or `sdk` is given beside `{ bearer }`, or — for `'sigv4'` —
|
|
70
|
+
* when the AWS SDK peer dependency cannot be loaded and no `sdk` was passed.
|
|
71
|
+
* All of these are thrown here, when the transport is built, never at the
|
|
72
|
+
* first call.
|
|
73
|
+
*/
|
|
74
|
+
export function agentCoreRuntimeMcpTransport(options) {
|
|
75
|
+
const url = agentCoreRuntimeUrl(options);
|
|
76
|
+
const send = authStrategy(options, url);
|
|
77
|
+
const retried = retryingFetchWhen(send, retryConfig(options.retry), sessionBusy) ?? send;
|
|
78
|
+
const session = sessionStrategy(options.session ?? 'per-call');
|
|
79
|
+
// The session is applied ONCE per request the MCP client makes, outside the
|
|
80
|
+
// retry: every attempt of one request goes to the same runtime session (a
|
|
81
|
+
// busy refusal is about THAT session coming up), and only the final answer
|
|
82
|
+
// binds anything.
|
|
83
|
+
const sessioned = async (input, init) => {
|
|
84
|
+
const headers = new Headers(init?.headers);
|
|
85
|
+
const step = session.request(headers, (init?.method ?? 'GET').toUpperCase());
|
|
86
|
+
if ('answer' in step)
|
|
87
|
+
return step.answer;
|
|
88
|
+
const response = await retried(input, { ...init, headers });
|
|
89
|
+
// What the MCP client may read of a failure is rewritten from safe parts —
|
|
90
|
+
// ONE rule for both auth paths, after the retry has read the original.
|
|
91
|
+
return step.settle(await safeAnswer(response));
|
|
92
|
+
};
|
|
93
|
+
return { transport: 'http', url, fetch: sessioned };
|
|
94
|
+
}
|
|
95
|
+
/**
|
|
96
|
+
* The HTTPS endpoint of a runtime's MCP server:
|
|
97
|
+
* `https://bedrock-agentcore.{region}.amazonaws.com/runtimes/{url-encoded ARN}/invocations`,
|
|
98
|
+
* with `qualifier` / `accountId` as query parameters when given — the request
|
|
99
|
+
* line of `InvokeAgentRuntime`, and the URL AgentCore's own MCP examples dial.
|
|
100
|
+
*
|
|
101
|
+
* @throws when `agentRuntimeArn` or `region` is missing, or the region is not
|
|
102
|
+
* shaped like one (it becomes part of a hostname).
|
|
103
|
+
*/
|
|
104
|
+
export function agentCoreRuntimeUrl(options) {
|
|
105
|
+
const { agentRuntimeArn, region, qualifier, accountId } = options;
|
|
106
|
+
if (!agentRuntimeArn || !region) {
|
|
107
|
+
throw new TypeError('agentCoreRuntimeUrl: both `agentRuntimeArn` and `region` are required — the runtime ' +
|
|
108
|
+
'is named by the first and reached through the second.');
|
|
109
|
+
}
|
|
110
|
+
if (!REGION_SHAPE.test(region)) {
|
|
111
|
+
throw new TypeError(`agentCoreRuntimeUrl: \`region\` ${JSON.stringify(region)} is not a region name ` +
|
|
112
|
+
"(lowercase letters, digits and '-', e.g. 'us-west-2'). It becomes part of the " +
|
|
113
|
+
'hostname, so it is refused rather than spliced in.');
|
|
114
|
+
}
|
|
115
|
+
const query = new URLSearchParams();
|
|
116
|
+
if (qualifier)
|
|
117
|
+
query.set('qualifier', qualifier);
|
|
118
|
+
if (accountId)
|
|
119
|
+
query.set('accountId', accountId);
|
|
120
|
+
const base = `https://bedrock-agentcore.${region}.amazonaws.com/runtimes/` +
|
|
121
|
+
`${encodeURIComponent(agentRuntimeArn)}/invocations`;
|
|
122
|
+
const search = query.toString();
|
|
123
|
+
return search === '' ? base : `${base}?${search}`;
|
|
124
|
+
}
|
|
125
|
+
// ── The auth strategy ─────────────────────────────────────────────────
|
|
126
|
+
/** The innermost `fetch`: the one that authenticates and sends. */
|
|
127
|
+
function authStrategy(options, url) {
|
|
128
|
+
const auth = options.auth ?? 'sigv4';
|
|
129
|
+
const sdk = injectedSdk(options);
|
|
130
|
+
if (auth === 'sigv4') {
|
|
131
|
+
const { client, InvokeAgentRuntimeCommand } = invokeSdk({
|
|
132
|
+
region: options.region,
|
|
133
|
+
...(options.client !== undefined && { client: options.client }),
|
|
134
|
+
...(sdk !== undefined && { sdk }),
|
|
135
|
+
});
|
|
136
|
+
return invokeFetch({
|
|
137
|
+
agentRuntimeArn: options.agentRuntimeArn,
|
|
138
|
+
...(options.qualifier !== undefined && { qualifier: options.qualifier }),
|
|
139
|
+
...(options.accountId !== undefined && { accountId: options.accountId }),
|
|
140
|
+
}, client, InvokeAgentRuntimeCommand);
|
|
141
|
+
}
|
|
142
|
+
if (auth !== null && typeof auth === 'object' && auth.bearer !== undefined) {
|
|
143
|
+
if (typeof auth.bearer.getCredential !== 'function') {
|
|
144
|
+
throw new TypeError('agentCoreRuntimeMcpTransport: `auth.bearer` must be a CredentialProvider (an object ' +
|
|
145
|
+
'with getCredential — agentCoreIdentity(), staticTokens(), your own), not the token ' +
|
|
146
|
+
'itself: a token is vended per request so it can rotate, and is never held here.');
|
|
147
|
+
}
|
|
148
|
+
if (sdk !== undefined) {
|
|
149
|
+
const given = options.sdk !== undefined ? 'sdk' : '_sdk';
|
|
150
|
+
throw new TypeError(`agentCoreRuntimeMcpTransport: \`${given}\` is the SigV4 strategy’s AWS SDK module, and ` +
|
|
151
|
+
'`auth: { bearer }` sends no AWS SDK request — this path is plain HTTPS and loads no ' +
|
|
152
|
+
`AWS SDK. Remove \`${given}\`, or use \`auth: "sigv4"\`.`);
|
|
153
|
+
}
|
|
154
|
+
if (options.client !== undefined) {
|
|
155
|
+
throw new TypeError('agentCoreRuntimeMcpTransport: `client` is the SigV4 strategy’s AWS SDK client, and ' +
|
|
156
|
+
'`auth: { bearer }` sends no AWS SDK request — the SDK cannot carry a bearer token, ' +
|
|
157
|
+
'so this path is plain HTTPS. Remove `client`, or use `auth: "sigv4"`.');
|
|
158
|
+
}
|
|
159
|
+
if (auth.mode !== undefined && auth.mode !== 'machine') {
|
|
160
|
+
// The vending request names no user: it carries `service`, `scopes` and
|
|
161
|
+
// `mode`, never an identity or the user's own token. A user-delegated
|
|
162
|
+
// token asked for that way belongs to nobody in particular — and would be
|
|
163
|
+
// sent for whoever calls through the client.
|
|
164
|
+
throw new TypeError(`agentCoreRuntimeMcpTransport: \`auth.mode\` must be 'machine' — got ${describe(auth.mode)}. ` +
|
|
165
|
+
'This transport asks its provider for a token without naming any user, so a ' +
|
|
166
|
+
'user-delegated token would be sent for whoever calls through the client. Leave ' +
|
|
167
|
+
'`mode` unset for the client credential; for a token per user, build a transport per ' +
|
|
168
|
+
'user whose `bearer` provider vends that user’s token.');
|
|
169
|
+
}
|
|
170
|
+
// The Gateway's vending fetch, reused as is: the token is vended per
|
|
171
|
+
// request, applied to that one request, and dropped.
|
|
172
|
+
return createVendingFetch(gatewayTransport({
|
|
173
|
+
url,
|
|
174
|
+
credentials: auth.bearer,
|
|
175
|
+
service: auth.service ?? DEFAULT_BEARER_SERVICE,
|
|
176
|
+
...(auth.scopes !== undefined && { scopes: auth.scopes }),
|
|
177
|
+
...(auth.mode !== undefined && { mode: auth.mode }),
|
|
178
|
+
}), auth.fetch);
|
|
179
|
+
}
|
|
180
|
+
throw new TypeError(`agentCoreRuntimeMcpTransport: \`auth\` must be 'sigv4' or { bearer: <CredentialProvider> } ` +
|
|
181
|
+
`— got ${describe(auth)}. Which one is decided by the runtime's inbound auth: IAM is ` +
|
|
182
|
+
"'sigv4', an OAuth (JWT) authorizer is a bearer token.");
|
|
183
|
+
}
|
|
184
|
+
/** The injected SDK module: `sdk`, or the older `_sdk` spelling of it. */
|
|
185
|
+
function injectedSdk(options) {
|
|
186
|
+
const { sdk, _sdk: legacy } = options;
|
|
187
|
+
if (sdk !== undefined && legacy !== undefined && sdk !== legacy) {
|
|
188
|
+
throw new TypeError('agentCoreRuntimeMcpTransport: `sdk` and `_sdk` name two different AWS SDK modules. ' +
|
|
189
|
+
'`_sdk` is the older spelling of `sdk`; pass only `sdk`.');
|
|
190
|
+
}
|
|
191
|
+
return sdk ?? legacy;
|
|
192
|
+
}
|
|
193
|
+
// ── The retry strategy's configuration ────────────────────────────────
|
|
194
|
+
function retryConfig(retry) {
|
|
195
|
+
if (retry === false)
|
|
196
|
+
return false;
|
|
197
|
+
const given = typeof retry === 'object' && retry !== null ? retry : {};
|
|
198
|
+
// An explicitly `undefined` field means "not set" — it must fall back to this
|
|
199
|
+
// transport's default, not erase it (and land on the loop's own default).
|
|
200
|
+
const set = Object.fromEntries(Object.entries(given).filter(([, v]) => v !== undefined));
|
|
201
|
+
return { ...DEFAULT_RETRY, ...set };
|
|
202
|
+
}
|
|
203
|
+
/**
|
|
204
|
+
* A refused value, described by SHAPE — never echoed. A mistyped `auth` can be
|
|
205
|
+
* the token itself (`auth: process.env.RUNTIME_TOKEN`), and an error message is
|
|
206
|
+
* the last place it should land.
|
|
207
|
+
*/
|
|
208
|
+
function describe(value) {
|
|
209
|
+
if (value === null)
|
|
210
|
+
return 'null';
|
|
211
|
+
if (typeof value === 'string')
|
|
212
|
+
return `a string of ${value.length} characters`;
|
|
213
|
+
if (typeof value === 'object')
|
|
214
|
+
return `an object with keys [${Object.keys(value).join(', ')}]`;
|
|
215
|
+
return typeof value;
|
|
216
|
+
}
|
|
217
|
+
//# sourceMappingURL=transport.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../../../../src/adapters/mcp/agentcoreRuntime/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AAEH,OAAO,EACL,kBAAkB,EAClB,gBAAgB,GAEjB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,iBAAiB,GAIlB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EACL,WAAW,EACX,SAAS,GAGV,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAgC,MAAM,cAAc,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAwH/C,uEAAuE;AACvE,MAAM,aAAa,GAAiC,EAAE,WAAW,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;AAE1F,kFAAkF;AAClF,MAAM,sBAAsB,GAAG,SAAS,CAAC;AAEzC,iFAAiF;AACjF,MAAM,YAAY,GAAG,4BAA4B,CAAC;AAElD;;;;;;;;GAQG;AACH,MAAM,UAAU,4BAA4B,CAC1C,OAA4C;IAE5C,MAAM,GAAG,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,iBAAiB,CAAC,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC,IAAI,IAAI,CAAC;IACzF,MAAM,OAAO,GAAG,eAAe,CAAC,OAAO,CAAC,OAAO,IAAI,UAAU,CAAC,CAAC;IAE/D,4EAA4E;IAC5E,0EAA0E;IAC1E,2EAA2E;IAC3E,kBAAkB;IAClB,MAAM,SAAS,GAAkB,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACrD,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC3C,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QAC7E,IAAI,QAAQ,IAAI,IAAI;YAAE,OAAO,IAAI,CAAC,MAAM,CAAC;QACzC,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,KAAK,EAAE,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QAC5D,2EAA2E;QAC3E,uEAAuE;QACvE,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;IACjD,CAAC,CAAC;IAEF,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AACtD,CAAC;AAUD;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAmC;IACrE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IAClE,IAAI,CAAC,eAAe,IAAI,CAAC,MAAM,EAAE,CAAC;QAChC,MAAM,IAAI,SAAS,CACjB,sFAAsF;YACpF,uDAAuD,CAC1D,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,SAAS,CACjB,mCAAmC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,wBAAwB;YAC/E,gFAAgF;YAChF,oDAAoD,CACvD,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,eAAe,EAAE,CAAC;IACpC,IAAI,SAAS;QAAE,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IACjD,IAAI,SAAS;QAAE,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IACjD,MAAM,IAAI,GACR,6BAA6B,MAAM,0BAA0B;QAC7D,GAAG,kBAAkB,CAAC,eAAe,CAAC,cAAc,CAAC;IACvD,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;IAChC,OAAO,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,MAAM,EAAE,CAAC;AACpD,CAAC;AAED,yEAAyE;AAEzE,mEAAmE;AACnE,SAAS,YAAY,CAAC,OAA4C,EAAE,GAAW;IAC7E,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC;IACrC,MAAM,GAAG,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACjC,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QACrB,MAAM,EAAE,MAAM,EAAE,yBAAyB,EAAE,GAAG,SAAS,CAAC;YACtD,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;YAC/D,GAAG,CAAC,GAAG,KAAK,SAAS,IAAI,EAAE,GAAG,EAAE,CAAC;SAClC,CAAC,CAAC;QACH,OAAO,WAAW,CAChB;YACE,eAAe,EAAE,OAAO,CAAC,eAAe;YACxC,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC;YACxE,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC;SACzE,EACD,MAAM,EACN,yBAAyB,CAC1B,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC3E,IAAI,OAAQ,IAAI,CAAC,MAAsC,CAAC,aAAa,KAAK,UAAU,EAAE,CAAC;YACrF,MAAM,IAAI,SAAS,CACjB,sFAAsF;gBACpF,qFAAqF;gBACrF,iFAAiF,CACpF,CAAC;QACJ,CAAC;QACD,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;YACzD,MAAM,IAAI,SAAS,CACjB,mCAAmC,KAAK,iDAAiD;gBACvF,sFAAsF;gBACtF,qBAAqB,KAAK,+BAA+B,CAC5D,CAAC;QACJ,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACjC,MAAM,IAAI,SAAS,CACjB,qFAAqF;gBACnF,qFAAqF;gBACrF,uEAAuE,CAC1E,CAAC;QACJ,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YACvD,wEAAwE;YACxE,sEAAsE;YACtE,0EAA0E;YAC1E,6CAA6C;YAC7C,MAAM,IAAI,SAAS,CACjB,uEAAuE,QAAQ,CAC7E,IAAI,CAAC,IAAI,CACV,IAAI;gBACH,6EAA6E;gBAC7E,iFAAiF;gBACjF,sFAAsF;gBACtF,uDAAuD,CAC1D,CAAC;QACJ,CAAC;QACD,qEAAqE;QACrE,qDAAqD;QACrD,OAAO,kBAAkB,CACvB,gBAAgB,CAAC;YACf,GAAG;YACH,WAAW,EAAE,IAAI,CAAC,MAAM;YACxB,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,sBAAsB;YAC/C,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;YACzD,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;SACpD,CAAC,EACF,IAAI,CAAC,KAAK,CACX,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,SAAS,CACjB,6FAA6F;QAC3F,SAAS,QAAQ,CAAC,IAAI,CAAC,+DAA+D;QACtF,uDAAuD,CAC1D,CAAC;AACJ,CAAC;AAED,0EAA0E;AAC1E,SAAS,WAAW,CAClB,OAA4C;IAE5C,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IACtC,IAAI,GAAG,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;QAChE,MAAM,IAAI,SAAS,CACjB,qFAAqF;YACnF,yDAAyD,CAC5D,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,IAAI,MAAM,CAAC;AACvB,CAAC;AAED,yEAAyE;AAEzE,SAAS,WAAW,CAAC,KAAmD;IACtE,IAAI,KAAK,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC;IAClC,MAAM,KAAK,GAAG,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACvE,8EAA8E;IAC9E,0EAA0E;IAC1E,MAAM,GAAG,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC;IACzF,OAAO,EAAE,GAAG,aAAa,EAAE,GAAG,GAAG,EAAE,CAAC;AACtC,CAAC;AAED;;;;GAIG;AACH,SAAS,QAAQ,CAAC,KAAc;IAC9B,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAClC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,eAAe,KAAK,CAAC,MAAM,aAAa,CAAC;IAC/E,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,wBAAwB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;IAC/F,OAAO,OAAO,KAAK,CAAC;AACtB,CAAC"}
|