@adonis-agora/agent 0.61.0 → 0.63.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/CHANGELOG.md +91 -0
- package/README.md +12 -7
- package/dist/configure.d.ts +7 -5
- package/dist/configure.d.ts.map +1 -1
- package/dist/configure.js +7 -5
- package/dist/configure.js.map +1 -1
- package/dist/providers/a2a_provider.d.ts +14 -0
- package/dist/providers/a2a_provider.d.ts.map +1 -0
- package/dist/providers/a2a_provider.js +136 -0
- package/dist/providers/a2a_provider.js.map +1 -0
- package/dist/providers/agent_provider.d.ts.map +1 -1
- package/dist/providers/agent_provider.js +81 -25
- package/dist/providers/agent_provider.js.map +1 -1
- package/dist/providers/mcp_provider.d.ts +3 -0
- package/dist/providers/mcp_provider.d.ts.map +1 -1
- package/dist/providers/mcp_provider.js +147 -62
- package/dist/providers/mcp_provider.js.map +1 -1
- package/dist/src/a2a/auth.d.ts +67 -0
- package/dist/src/a2a/auth.d.ts.map +1 -0
- package/dist/src/a2a/auth.js +47 -0
- package/dist/src/a2a/auth.js.map +1 -0
- package/dist/src/a2a/define_config.d.ts +74 -0
- package/dist/src/a2a/define_config.d.ts.map +1 -0
- package/dist/src/a2a/define_config.js +5 -0
- package/dist/src/a2a/define_config.js.map +1 -0
- package/dist/src/a2a/gate.d.ts +23 -0
- package/dist/src/a2a/gate.d.ts.map +1 -0
- package/dist/src/a2a/gate.js +56 -0
- package/dist/src/a2a/gate.js.map +1 -0
- package/dist/src/a2a/handler.d.ts +65 -0
- package/dist/src/a2a/handler.d.ts.map +1 -0
- package/dist/src/a2a/handler.js +322 -0
- package/dist/src/a2a/handler.js.map +1 -0
- package/dist/src/a2a/index.d.ts +15 -0
- package/dist/src/a2a/index.d.ts.map +1 -0
- package/dist/src/a2a/index.js +9 -0
- package/dist/src/a2a/index.js.map +1 -0
- package/dist/src/a2a/permission-tool.d.ts +17 -0
- package/dist/src/a2a/permission-tool.d.ts.map +1 -0
- package/dist/src/a2a/permission-tool.js +70 -0
- package/dist/src/a2a/permission-tool.js.map +1 -0
- package/dist/src/a2a/protocol.d.ts +100 -0
- package/dist/src/a2a/protocol.d.ts.map +1 -0
- package/dist/src/a2a/protocol.js +106 -0
- package/dist/src/a2a/protocol.js.map +1 -0
- package/dist/src/a2a/runtime.d.ts +6 -0
- package/dist/src/a2a/runtime.d.ts.map +1 -0
- package/dist/src/a2a/runtime.js +13 -0
- package/dist/src/a2a/runtime.js.map +1 -0
- package/dist/src/a2a/server_middleware.d.ts +13 -0
- package/dist/src/a2a/server_middleware.d.ts.map +1 -0
- package/dist/src/a2a/server_middleware.js +18 -0
- package/dist/src/a2a/server_middleware.js.map +1 -0
- package/dist/src/a2a/store.d.ts +79 -0
- package/dist/src/a2a/store.d.ts.map +1 -0
- package/dist/src/a2a/store.js +151 -0
- package/dist/src/a2a/store.js.map +1 -0
- package/dist/src/a2a/turn.d.ts +80 -0
- package/dist/src/a2a/turn.d.ts.map +1 -0
- package/dist/src/a2a/turn.js +211 -0
- package/dist/src/a2a/turn.js.map +1 -0
- package/dist/src/action-proposal-executor.d.ts +3 -0
- package/dist/src/action-proposal-executor.d.ts.map +1 -1
- package/dist/src/action-proposal-executor.js +10 -0
- package/dist/src/action-proposal-executor.js.map +1 -1
- package/dist/src/action-proposal-service.d.ts +7 -2
- package/dist/src/action-proposal-service.d.ts.map +1 -1
- package/dist/src/action-proposal-service.js +21 -16
- package/dist/src/action-proposal-service.js.map +1 -1
- package/dist/src/action-proposal-text.d.ts +42 -3
- package/dist/src/action-proposal-text.d.ts.map +1 -1
- package/dist/src/action-proposal-text.js +80 -12
- package/dist/src/action-proposal-text.js.map +1 -1
- package/dist/src/action-proposal-worker.d.ts +2 -1
- package/dist/src/action-proposal-worker.d.ts.map +1 -1
- package/dist/src/action-proposal-worker.js +9 -2
- package/dist/src/action-proposal-worker.js.map +1 -1
- package/dist/src/actor-resolver.d.ts +12 -4
- package/dist/src/actor-resolver.d.ts.map +1 -1
- package/dist/src/actor-resolver.js +24 -7
- package/dist/src/actor-resolver.js.map +1 -1
- package/dist/src/ag-ui/adapter.d.ts.map +1 -1
- package/dist/src/ag-ui/adapter.js +115 -17
- package/dist/src/ag-ui/adapter.js.map +1 -1
- package/dist/src/ag-ui/core/encoder.d.ts +106 -0
- package/dist/src/ag-ui/core/encoder.d.ts.map +1 -0
- package/dist/src/ag-ui/core/encoder.js +534 -0
- package/dist/src/ag-ui/core/encoder.js.map +1 -0
- package/dist/src/ag-ui/core/index.d.ts +12 -0
- package/dist/src/ag-ui/core/index.d.ts.map +1 -0
- package/dist/src/ag-ui/core/index.js +12 -0
- package/dist/src/ag-ui/core/index.js.map +1 -0
- package/dist/src/ag-ui/core/input.d.ts +92 -0
- package/dist/src/ag-ui/core/input.d.ts.map +1 -0
- package/dist/src/ag-ui/core/input.js +246 -0
- package/dist/src/ag-ui/core/input.js.map +1 -0
- package/dist/src/ag-ui/core/interrupt-id.d.ts +31 -0
- package/dist/src/ag-ui/core/interrupt-id.d.ts.map +1 -0
- package/dist/src/ag-ui/core/interrupt-id.js +48 -0
- package/dist/src/ag-ui/core/interrupt-id.js.map +1 -0
- package/dist/src/ag-ui/{proposal-decision.d.ts → core/proposal-decision.d.ts} +1 -1
- package/dist/src/ag-ui/core/proposal-decision.d.ts.map +1 -0
- package/dist/src/ag-ui/{proposal-decision.js → core/proposal-decision.js} +3 -6
- package/dist/src/ag-ui/core/proposal-decision.js.map +1 -0
- package/dist/src/ag-ui/core/stream.d.ts +49 -0
- package/dist/src/ag-ui/core/stream.d.ts.map +1 -0
- package/dist/src/ag-ui/core/stream.js +90 -0
- package/dist/src/ag-ui/core/stream.js.map +1 -0
- package/dist/src/ag-ui/core/types.d.ts +249 -0
- package/dist/src/ag-ui/core/types.d.ts.map +1 -0
- package/dist/src/ag-ui/core/types.js +35 -0
- package/dist/src/ag-ui/core/types.js.map +1 -0
- package/dist/src/ag-ui/encoder.d.ts +3 -4
- package/dist/src/ag-ui/encoder.d.ts.map +1 -1
- package/dist/src/ag-ui/encoder.js +10 -11
- package/dist/src/ag-ui/encoder.js.map +1 -1
- package/dist/src/ag-ui/frames.d.ts +8 -5
- package/dist/src/ag-ui/frames.d.ts.map +1 -1
- package/dist/src/ag-ui/frames.js +21 -7
- package/dist/src/ag-ui/frames.js.map +1 -1
- package/dist/src/ag-ui/index.d.ts +3 -5
- package/dist/src/ag-ui/index.d.ts.map +1 -1
- package/dist/src/ag-ui/index.js +3 -5
- package/dist/src/ag-ui/index.js.map +1 -1
- package/dist/src/ag-ui/stream.d.ts +3 -4
- package/dist/src/ag-ui/stream.d.ts.map +1 -1
- package/dist/src/ag-ui/stream.js +4 -5
- package/dist/src/ag-ui/stream.js.map +1 -1
- package/dist/src/agent-deps-factory.d.ts +3 -0
- package/dist/src/agent-deps-factory.d.ts.map +1 -1
- package/dist/src/agent-deps-factory.js +3 -0
- package/dist/src/agent-deps-factory.js.map +1 -1
- package/dist/src/agent-deps.d.ts +3 -0
- package/dist/src/agent-deps.d.ts.map +1 -1
- package/dist/src/agent-deps.js.map +1 -1
- package/dist/src/agent-loop.d.ts +4 -3
- package/dist/src/agent-loop.d.ts.map +1 -1
- package/dist/src/agent-loop.js +50 -25
- package/dist/src/agent-loop.js.map +1 -1
- package/dist/src/agent-service.d.ts +46 -4
- package/dist/src/agent-service.d.ts.map +1 -1
- package/dist/src/agent-service.js +87 -11
- package/dist/src/agent-service.js.map +1 -1
- package/dist/src/ai-sdk/ai-sdk-model.js +4 -1
- package/dist/src/ai-sdk/ai-sdk-model.js.map +1 -1
- package/dist/src/ai-tool-ref.d.ts +4 -0
- package/dist/src/ai-tool-ref.d.ts.map +1 -1
- package/dist/src/ai-tool-ref.js +10 -14
- package/dist/src/ai-tool-ref.js.map +1 -1
- package/dist/src/attachment-limits.d.ts +10 -0
- package/dist/src/attachment-limits.d.ts.map +1 -0
- package/dist/src/attachment-limits.js +13 -0
- package/dist/src/attachment-limits.js.map +1 -0
- package/dist/src/channels/adapters/evolution_api.d.ts +49 -0
- package/dist/src/channels/adapters/evolution_api.d.ts.map +1 -0
- package/dist/src/channels/adapters/evolution_api.js +241 -0
- package/dist/src/channels/adapters/evolution_api.js.map +1 -0
- package/dist/src/channels/adapters/telegram.d.ts +34 -0
- package/dist/src/channels/adapters/telegram.d.ts.map +1 -0
- package/dist/src/channels/adapters/telegram.js +196 -0
- package/dist/src/channels/adapters/telegram.js.map +1 -0
- package/dist/src/channels/adapters/whatsapp_cloud.d.ts +31 -0
- package/dist/src/channels/adapters/whatsapp_cloud.d.ts.map +1 -0
- package/dist/src/channels/adapters/whatsapp_cloud.js +177 -0
- package/dist/src/channels/adapters/whatsapp_cloud.js.map +1 -0
- package/dist/src/channels/handler.d.ts +167 -0
- package/dist/src/channels/handler.d.ts.map +1 -0
- package/dist/src/channels/handler.js +569 -0
- package/dist/src/channels/handler.js.map +1 -0
- package/dist/src/channels/http.d.ts +45 -0
- package/dist/src/channels/http.d.ts.map +1 -0
- package/dist/src/channels/http.js +147 -0
- package/dist/src/channels/http.js.map +1 -0
- package/dist/src/channels/index.d.ts +16 -0
- package/dist/src/channels/index.d.ts.map +1 -0
- package/dist/src/channels/index.js +15 -0
- package/dist/src/channels/index.js.map +1 -0
- package/dist/src/channels/markdown.d.ts +12 -0
- package/dist/src/channels/markdown.d.ts.map +1 -0
- package/dist/src/channels/markdown.js +120 -0
- package/dist/src/channels/markdown.js.map +1 -0
- package/dist/src/channels/questions.d.ts +43 -0
- package/dist/src/channels/questions.d.ts.map +1 -0
- package/dist/src/channels/questions.js +90 -0
- package/dist/src/channels/questions.js.map +1 -0
- package/dist/src/channels/split.d.ts +8 -0
- package/dist/src/channels/split.d.ts.map +1 -0
- package/dist/src/channels/split.js +45 -0
- package/dist/src/channels/split.js.map +1 -0
- package/dist/src/channels/store.d.ts +78 -0
- package/dist/src/channels/store.d.ts.map +1 -0
- package/dist/src/channels/store.js +151 -0
- package/dist/src/channels/store.js.map +1 -0
- package/dist/src/channels/types.d.ts +138 -0
- package/dist/src/channels/types.d.ts.map +1 -0
- package/dist/src/channels/types.js +7 -0
- package/dist/src/channels/types.js.map +1 -0
- package/dist/src/chat-queue-service.d.ts.map +1 -1
- package/dist/src/chat-queue-service.js +2 -0
- package/dist/src/chat-queue-service.js.map +1 -1
- package/dist/src/define_config.d.ts +61 -12
- package/dist/src/define_config.d.ts.map +1 -1
- package/dist/src/define_config.js.map +1 -1
- package/dist/src/engine.d.ts +77 -0
- package/dist/src/engine.d.ts.map +1 -0
- package/dist/src/engine.js +27 -0
- package/dist/src/engine.js.map +1 -0
- package/dist/src/genui/builtins.d.ts +73 -3
- package/dist/src/genui/builtins.d.ts.map +1 -1
- package/dist/src/genui/builtins.js +357 -3
- package/dist/src/genui/builtins.js.map +1 -1
- package/dist/src/genui/capabilities.d.ts +24 -0
- package/dist/src/genui/capabilities.d.ts.map +1 -0
- package/dist/src/genui/capabilities.js +81 -0
- package/dist/src/genui/capabilities.js.map +1 -0
- package/dist/src/genui/catalog.d.ts +86 -0
- package/dist/src/genui/catalog.d.ts.map +1 -0
- package/dist/src/genui/catalog.js +96 -0
- package/dist/src/genui/catalog.js.map +1 -0
- package/dist/src/genui/factory.d.ts +7 -14
- package/dist/src/genui/factory.d.ts.map +1 -1
- package/dist/src/genui/factory.js.map +1 -1
- package/dist/src/genui/index.d.ts +4 -12
- package/dist/src/genui/index.d.ts.map +1 -1
- package/dist/src/genui/index.js +5 -18
- package/dist/src/genui/index.js.map +1 -1
- package/dist/src/genui/public.d.ts +9 -0
- package/dist/src/genui/public.d.ts.map +1 -0
- package/dist/src/genui/public.js +9 -0
- package/dist/src/genui/public.js.map +1 -0
- package/dist/src/genui/registry.d.ts +65 -0
- package/dist/src/genui/registry.d.ts.map +1 -0
- package/dist/src/genui/registry.js +151 -0
- package/dist/src/genui/registry.js.map +1 -0
- package/dist/src/genui/schema.d.ts +71 -0
- package/dist/src/genui/schema.d.ts.map +1 -0
- package/dist/src/genui/schema.js +304 -0
- package/dist/src/genui/schema.js.map +1 -0
- package/dist/src/genui/text.d.ts +36 -0
- package/dist/src/genui/text.d.ts.map +1 -0
- package/dist/src/genui/text.js +157 -0
- package/dist/src/genui/text.js.map +1 -0
- package/dist/src/genui/tools.d.ts +92 -0
- package/dist/src/genui/tools.d.ts.map +1 -0
- package/dist/src/genui/tools.js +291 -0
- package/dist/src/genui/tools.js.map +1 -0
- package/dist/src/genui/tree.d.ts +56 -0
- package/dist/src/genui/tree.d.ts.map +1 -0
- package/dist/src/genui/tree.js +188 -0
- package/dist/src/genui/tree.js.map +1 -0
- package/dist/src/index.d.ts +6 -3
- package/dist/src/index.d.ts.map +1 -1
- package/dist/src/index.js +4 -2
- package/dist/src/index.js.map +1 -1
- package/dist/src/mcp/auth.d.ts +17 -1
- package/dist/src/mcp/auth.d.ts.map +1 -1
- package/dist/src/mcp/auth.js +14 -3
- package/dist/src/mcp/auth.js.map +1 -1
- package/dist/src/mcp/define_config.d.ts +81 -2
- package/dist/src/mcp/define_config.d.ts.map +1 -1
- package/dist/src/mcp/define_config.js.map +1 -1
- package/dist/src/mcp/index.d.ts +1 -1
- package/dist/src/mcp/index.d.ts.map +1 -1
- package/dist/src/mcp/index.js.map +1 -1
- package/dist/src/mcp/oauth-resource.d.ts +9 -0
- package/dist/src/mcp/oauth-resource.d.ts.map +1 -0
- package/dist/src/mcp/oauth-resource.js +16 -0
- package/dist/src/mcp/oauth-resource.js.map +1 -0
- package/dist/src/mcp/server.d.ts +5 -0
- package/dist/src/mcp/server.d.ts.map +1 -1
- package/dist/src/mcp/server.js +48 -16
- package/dist/src/mcp/server.js.map +1 -1
- package/dist/src/negotiated-tool-ui.d.ts.map +1 -1
- package/dist/src/negotiated-tool-ui.js +12 -8
- package/dist/src/negotiated-tool-ui.js.map +1 -1
- package/dist/src/opencode/client.d.ts +202 -0
- package/dist/src/opencode/client.d.ts.map +1 -0
- package/dist/src/opencode/client.js +2 -0
- package/dist/src/opencode/client.js.map +1 -0
- package/dist/src/opencode/durable/index.d.ts +33 -0
- package/dist/src/opencode/durable/index.d.ts.map +1 -0
- package/dist/src/opencode/durable/index.js +38 -0
- package/dist/src/opencode/durable/index.js.map +1 -0
- package/dist/src/opencode/durable/runner.d.ts +36 -0
- package/dist/src/opencode/durable/runner.d.ts.map +1 -0
- package/dist/src/opencode/durable/runner.js +88 -0
- package/dist/src/opencode/durable/runner.js.map +1 -0
- package/dist/src/opencode/durable/workflow.d.ts +40 -0
- package/dist/src/opencode/durable/workflow.d.ts.map +1 -0
- package/dist/src/opencode/durable/workflow.js +106 -0
- package/dist/src/opencode/durable/workflow.js.map +1 -0
- package/dist/src/opencode/engine.d.ts +48 -0
- package/dist/src/opencode/engine.d.ts.map +1 -0
- package/dist/src/opencode/engine.js +98 -0
- package/dist/src/opencode/engine.js.map +1 -0
- package/dist/src/opencode/event-hub.d.ts +23 -0
- package/dist/src/opencode/event-hub.d.ts.map +1 -0
- package/dist/src/opencode/event-hub.js +99 -0
- package/dist/src/opencode/event-hub.js.map +1 -0
- package/dist/src/opencode/forms.d.ts +19 -0
- package/dist/src/opencode/forms.d.ts.map +1 -0
- package/dist/src/opencode/forms.js +82 -0
- package/dist/src/opencode/forms.js.map +1 -0
- package/dist/src/opencode/host.d.ts +179 -0
- package/dist/src/opencode/host.d.ts.map +1 -0
- package/dist/src/opencode/host.js +34 -0
- package/dist/src/opencode/host.js.map +1 -0
- package/dist/src/opencode/index.d.ts +15 -0
- package/dist/src/opencode/index.d.ts.map +1 -0
- package/dist/src/opencode/index.js +9 -0
- package/dist/src/opencode/index.js.map +1 -0
- package/dist/src/opencode/log.d.ts +9 -0
- package/dist/src/opencode/log.d.ts.map +1 -0
- package/dist/src/opencode/log.js +15 -0
- package/dist/src/opencode/log.js.map +1 -0
- package/dist/src/opencode/mcp.d.ts +60 -0
- package/dist/src/opencode/mcp.d.ts.map +1 -0
- package/dist/src/opencode/mcp.js +258 -0
- package/dist/src/opencode/mcp.js.map +1 -0
- package/dist/src/opencode/runner.d.ts +40 -0
- package/dist/src/opencode/runner.d.ts.map +1 -0
- package/dist/src/opencode/runner.js +125 -0
- package/dist/src/opencode/runner.js.map +1 -0
- package/dist/src/opencode/turn.d.ts +167 -0
- package/dist/src/opencode/turn.d.ts.map +1 -0
- package/dist/src/opencode/turn.js +761 -0
- package/dist/src/opencode/turn.js.map +1 -0
- package/dist/src/opencode/turns.d.ts +247 -0
- package/dist/src/opencode/turns.d.ts.map +1 -0
- package/dist/src/opencode/turns.js +867 -0
- package/dist/src/opencode/turns.js.map +1 -0
- package/dist/src/personas.d.ts.map +1 -1
- package/dist/src/personas.js +4 -1
- package/dist/src/personas.js.map +1 -1
- package/dist/src/react/ag-ui.d.ts +4 -2
- package/dist/src/react/ag-ui.d.ts.map +1 -1
- package/dist/src/react/ag-ui.js +2 -2
- package/dist/src/react/ag-ui.js.map +1 -1
- package/dist/src/react/client.d.ts +1 -1
- package/dist/src/react/client.d.ts.map +1 -1
- package/dist/src/react/client.js +1 -1
- package/dist/src/react/client.js.map +1 -1
- package/dist/src/react/core/ag-ui-backend.d.ts +109 -0
- package/dist/src/react/core/ag-ui-backend.d.ts.map +1 -0
- package/dist/src/react/core/ag-ui-backend.js +574 -0
- package/dist/src/react/core/ag-ui-backend.js.map +1 -0
- package/dist/src/react/core/agent-chat-transport.d.ts +187 -0
- package/dist/src/react/core/agent-chat-transport.d.ts.map +1 -0
- package/dist/src/react/core/agent-chat-transport.js +817 -0
- package/dist/src/react/core/agent-chat-transport.js.map +1 -0
- package/dist/src/react/core/approvals/countdown.d.ts +22 -0
- package/dist/src/react/core/approvals/countdown.d.ts.map +1 -0
- package/dist/src/react/core/approvals/countdown.js +39 -0
- package/dist/src/react/core/approvals/countdown.js.map +1 -0
- package/dist/src/react/core/approvals/proposals.d.ts +15 -0
- package/dist/src/react/core/approvals/proposals.d.ts.map +1 -0
- package/dist/src/react/core/approvals/proposals.js +82 -0
- package/dist/src/react/core/approvals/proposals.js.map +1 -0
- package/dist/src/react/core/approvals/use-action-proposals.d.ts +10 -0
- package/dist/src/react/core/approvals/use-action-proposals.d.ts.map +1 -0
- package/dist/src/react/core/approvals/use-action-proposals.js +86 -0
- package/dist/src/react/core/approvals/use-action-proposals.js.map +1 -0
- package/dist/src/react/core/attachments/files.d.ts +39 -0
- package/dist/src/react/core/attachments/files.d.ts.map +1 -0
- package/dist/src/react/core/attachments/files.js +89 -0
- package/dist/src/react/core/attachments/files.js.map +1 -0
- package/dist/src/react/core/attachments/use-attachments.d.ts +106 -0
- package/dist/src/react/core/attachments/use-attachments.d.ts.map +1 -0
- package/dist/src/react/core/attachments/use-attachments.js +217 -0
- package/dist/src/react/core/attachments/use-attachments.js.map +1 -0
- package/dist/src/react/core/backend.d.ts +245 -0
- package/dist/src/react/core/backend.d.ts.map +1 -0
- package/dist/src/react/core/backend.js +21 -0
- package/dist/src/react/core/backend.js.map +1 -0
- package/dist/src/react/core/background-runs.d.ts +32 -0
- package/dist/src/react/core/background-runs.d.ts.map +1 -0
- package/dist/src/react/core/background-runs.js +47 -0
- package/dist/src/react/core/background-runs.js.map +1 -0
- package/dist/src/react/core/catalog/use-agents.d.ts +31 -0
- package/dist/src/react/core/catalog/use-agents.d.ts.map +1 -0
- package/dist/src/react/core/catalog/use-agents.js +28 -0
- package/dist/src/react/core/catalog/use-agents.js.map +1 -0
- package/dist/src/react/core/catalog/use-models.d.ts +41 -0
- package/dist/src/react/core/catalog/use-models.d.ts.map +1 -0
- package/dist/src/react/core/catalog/use-models.js +35 -0
- package/dist/src/react/core/catalog/use-models.js.map +1 -0
- package/dist/src/react/core/catalog/use-resource.d.ts +12 -0
- package/dist/src/react/core/catalog/use-resource.d.ts.map +1 -0
- package/dist/src/react/core/catalog/use-resource.js +41 -0
- package/dist/src/react/core/catalog/use-resource.js.map +1 -0
- package/dist/src/react/core/client-wire.d.ts +14 -0
- package/dist/src/react/core/client-wire.d.ts.map +1 -0
- package/dist/src/react/core/client-wire.js +2 -0
- package/dist/src/react/core/client-wire.js.map +1 -0
- package/dist/src/react/core/client.d.ts +222 -0
- package/dist/src/react/core/client.d.ts.map +1 -0
- package/dist/src/react/core/client.js +435 -0
- package/dist/src/react/core/client.js.map +1 -0
- package/dist/src/react/core/components/ambient-ui.d.ts +22 -0
- package/dist/src/react/core/components/ambient-ui.d.ts.map +1 -0
- package/dist/src/react/core/components/ambient-ui.js +30 -0
- package/dist/src/react/core/components/ambient-ui.js.map +1 -0
- package/dist/src/react/core/components/chat-input.d.ts +44 -0
- package/dist/src/react/core/components/chat-input.d.ts.map +1 -0
- package/dist/src/react/core/components/chat-input.js +69 -0
- package/dist/src/react/core/components/chat-input.js.map +1 -0
- package/dist/src/react/core/components/index.d.ts +7 -0
- package/dist/src/react/core/components/index.d.ts.map +1 -0
- package/dist/src/react/core/components/index.js +7 -0
- package/dist/src/react/core/components/index.js.map +1 -0
- package/dist/src/react/core/components/message-item.d.ts +101 -0
- package/dist/src/react/core/components/message-item.d.ts.map +1 -0
- package/dist/src/react/core/components/message-item.js +118 -0
- package/dist/src/react/core/components/message-item.js.map +1 -0
- package/dist/src/react/core/components/message-list.d.ts +85 -0
- package/dist/src/react/core/components/message-list.d.ts.map +1 -0
- package/dist/src/react/core/components/message-list.js +45 -0
- package/dist/src/react/core/components/message-list.js.map +1 -0
- package/dist/src/react/core/components/speech-languages.d.ts +22 -0
- package/dist/src/react/core/components/speech-languages.d.ts.map +1 -0
- package/dist/src/react/core/components/speech-languages.js +38 -0
- package/dist/src/react/core/components/speech-languages.js.map +1 -0
- package/dist/src/react/core/components/use-speech-recognition.d.ts +19 -0
- package/dist/src/react/core/components/use-speech-recognition.d.ts.map +1 -0
- package/dist/src/react/core/components/use-speech-recognition.js +92 -0
- package/dist/src/react/core/components/use-speech-recognition.js.map +1 -0
- package/dist/src/react/core/composer/index.d.ts +4 -0
- package/dist/src/react/core/composer/index.d.ts.map +1 -0
- package/dist/src/react/core/composer/index.js +4 -0
- package/dist/src/react/core/composer/index.js.map +1 -0
- package/dist/src/react/core/composer/model.d.ts +83 -0
- package/dist/src/react/core/composer/model.d.ts.map +1 -0
- package/dist/src/react/core/composer/model.js +53 -0
- package/dist/src/react/core/composer/model.js.map +1 -0
- package/dist/src/react/core/composer/skills-source.d.ts +29 -0
- package/dist/src/react/core/composer/skills-source.d.ts.map +1 -0
- package/dist/src/react/core/composer/skills-source.js +61 -0
- package/dist/src/react/core/composer/skills-source.js.map +1 -0
- package/dist/src/react/core/composer/use-composer-autocomplete.d.ts +78 -0
- package/dist/src/react/core/composer/use-composer-autocomplete.d.ts.map +1 -0
- package/dist/src/react/core/composer/use-composer-autocomplete.js +244 -0
- package/dist/src/react/core/composer/use-composer-autocomplete.js.map +1 -0
- package/dist/src/react/core/config/use-agent-config.d.ts +21 -0
- package/dist/src/react/core/config/use-agent-config.d.ts.map +1 -0
- package/dist/src/react/core/config/use-agent-config.js +57 -0
- package/dist/src/react/core/config/use-agent-config.js.map +1 -0
- package/dist/src/react/core/elicitation/answers.d.ts +22 -0
- package/dist/src/react/core/elicitation/answers.d.ts.map +1 -0
- package/dist/src/react/core/elicitation/answers.js +65 -0
- package/dist/src/react/core/elicitation/answers.js.map +1 -0
- package/dist/src/react/core/feedback/use-message-feedback.d.ts +32 -0
- package/dist/src/react/core/feedback/use-message-feedback.d.ts.map +1 -0
- package/dist/src/react/core/feedback/use-message-feedback.js +106 -0
- package/dist/src/react/core/feedback/use-message-feedback.js.map +1 -0
- package/dist/src/react/core/genui/generative-ui.d.ts +76 -0
- package/dist/src/react/core/genui/generative-ui.d.ts.map +1 -0
- package/dist/src/react/core/genui/generative-ui.js +210 -0
- package/dist/src/react/core/genui/generative-ui.js.map +1 -0
- package/dist/src/react/core/genui/index.d.ts +5 -0
- package/dist/src/react/core/genui/index.d.ts.map +1 -0
- package/dist/src/react/core/genui/index.js +5 -0
- package/dist/src/react/core/genui/index.js.map +1 -0
- package/dist/src/react/core/genui/json-render.d.ts +54 -0
- package/dist/src/react/core/genui/json-render.d.ts.map +1 -0
- package/dist/src/react/core/genui/json-render.js +64 -0
- package/dist/src/react/core/genui/json-render.js.map +1 -0
- package/dist/src/react/core/genui/playwright.d.ts +12 -0
- package/dist/src/react/core/genui/playwright.d.ts.map +1 -0
- package/dist/src/react/core/genui/playwright.js +141 -0
- package/dist/src/react/core/genui/playwright.js.map +1 -0
- package/dist/src/react/core/genui/react-registry.d.ts +22 -0
- package/dist/src/react/core/genui/react-registry.d.ts.map +1 -0
- package/dist/src/react/core/genui/react-registry.js +72 -0
- package/dist/src/react/core/genui/react-registry.js.map +1 -0
- package/dist/src/react/core/genui/server.d.ts +32 -0
- package/dist/src/react/core/genui/server.d.ts.map +1 -0
- package/dist/src/react/core/genui/server.js +66 -0
- package/dist/src/react/core/genui/server.js.map +1 -0
- package/dist/src/react/core/genui/types.d.ts +98 -0
- package/dist/src/react/core/genui/types.d.ts.map +1 -0
- package/dist/src/react/core/genui/types.js +3 -0
- package/dist/src/react/core/genui/types.js.map +1 -0
- package/dist/src/react/core/genui/use-generative-ui.d.ts +42 -0
- package/dist/src/react/core/genui/use-generative-ui.d.ts.map +1 -0
- package/dist/src/react/core/genui/use-generative-ui.js +186 -0
- package/dist/src/react/core/genui/use-generative-ui.js.map +1 -0
- package/dist/src/react/core/http-error.d.ts +33 -0
- package/dist/src/react/core/http-error.d.ts.map +1 -0
- package/dist/src/react/core/http-error.js +47 -0
- package/dist/src/react/core/http-error.js.map +1 -0
- package/dist/src/react/core/index.d.ts +35 -0
- package/dist/src/react/core/index.d.ts.map +1 -0
- package/dist/src/react/core/index.js +34 -0
- package/dist/src/react/core/index.js.map +1 -0
- package/dist/src/react/core/markdown/agent-markdown.d.ts +39 -0
- package/dist/src/react/core/markdown/agent-markdown.d.ts.map +1 -0
- package/dist/src/react/core/markdown/agent-markdown.js +22 -0
- package/dist/src/react/core/markdown/agent-markdown.js.map +1 -0
- package/dist/src/react/core/markdown/index.d.ts +2 -0
- package/dist/src/react/core/markdown/index.d.ts.map +1 -0
- package/dist/src/react/core/markdown/index.js +2 -0
- package/dist/src/react/core/markdown/index.js.map +1 -0
- package/dist/src/react/core/media/index.d.ts +64 -0
- package/dist/src/react/core/media/index.d.ts.map +1 -0
- package/dist/src/react/core/media/index.js +135 -0
- package/dist/src/react/core/media/index.js.map +1 -0
- package/dist/src/react/core/media/tus.d.ts +13 -0
- package/dist/src/react/core/media/tus.d.ts.map +1 -0
- package/dist/src/react/core/media/tus.js +59 -0
- package/dist/src/react/core/media/tus.js.map +1 -0
- package/dist/src/react/core/presentation/phrasing.d.ts +25 -0
- package/dist/src/react/core/presentation/phrasing.d.ts.map +1 -0
- package/dist/src/react/core/presentation/phrasing.js +58 -0
- package/dist/src/react/core/presentation/phrasing.js.map +1 -0
- package/dist/src/react/core/presentation/result-view.d.ts +43 -0
- package/dist/src/react/core/presentation/result-view.d.ts.map +1 -0
- package/dist/src/react/core/presentation/result-view.js +90 -0
- package/dist/src/react/core/presentation/result-view.js.map +1 -0
- package/dist/src/react/core/presentation/tool-activity.d.ts +106 -0
- package/dist/src/react/core/presentation/tool-activity.d.ts.map +1 -0
- package/dist/src/react/core/presentation/tool-activity.js +165 -0
- package/dist/src/react/core/presentation/tool-activity.js.map +1 -0
- package/dist/src/react/core/presentation/use-tool-catalog.d.ts +39 -0
- package/dist/src/react/core/presentation/use-tool-catalog.d.ts.map +1 -0
- package/dist/src/react/core/presentation/use-tool-catalog.js +77 -0
- package/dist/src/react/core/presentation/use-tool-catalog.js.map +1 -0
- package/dist/src/react/core/provider.d.ts +68 -0
- package/dist/src/react/core/provider.d.ts.map +1 -0
- package/dist/src/react/core/provider.js +61 -0
- package/dist/src/react/core/provider.js.map +1 -0
- package/dist/src/react/core/queue/model.d.ts +73 -0
- package/dist/src/react/core/queue/model.d.ts.map +1 -0
- package/dist/src/react/core/queue/model.js +2 -0
- package/dist/src/react/core/queue/model.js.map +1 -0
- package/dist/src/react/core/quota/use-quota.d.ts +35 -0
- package/dist/src/react/core/quota/use-quota.d.ts.map +1 -0
- package/dist/src/react/core/quota/use-quota.js +47 -0
- package/dist/src/react/core/quota/use-quota.js.map +1 -0
- package/dist/src/react/core/reasoning/timing.d.ts +38 -0
- package/dist/src/react/core/reasoning/timing.d.ts.map +1 -0
- package/dist/src/react/core/reasoning/timing.js +73 -0
- package/dist/src/react/core/reasoning/timing.js.map +1 -0
- package/dist/src/react/core/run-errors.d.ts +37 -0
- package/dist/src/react/core/run-errors.d.ts.map +1 -0
- package/dist/src/react/core/run-errors.js +37 -0
- package/dist/src/react/core/run-errors.js.map +1 -0
- package/dist/src/react/core/stored-message-to-ui-message.d.ts +4 -0
- package/dist/src/react/core/stored-message-to-ui-message.d.ts.map +1 -0
- package/dist/src/react/core/stored-message-to-ui-message.js +216 -0
- package/dist/src/react/core/stored-message-to-ui-message.js.map +1 -0
- package/dist/src/react/core/stored-thread-to-ui-messages.d.ts +82 -0
- package/dist/src/react/core/stored-thread-to-ui-messages.d.ts.map +1 -0
- package/dist/src/react/core/stored-thread-to-ui-messages.js +116 -0
- package/dist/src/react/core/stored-thread-to-ui-messages.js.map +1 -0
- package/dist/src/react/core/threads/threads-events.d.ts +22 -0
- package/dist/src/react/core/threads/threads-events.d.ts.map +1 -0
- package/dist/src/react/core/threads/threads-events.js +21 -0
- package/dist/src/react/core/threads/threads-events.js.map +1 -0
- package/dist/src/react/core/threads/use-threads.d.ts +31 -0
- package/dist/src/react/core/threads/use-threads.d.ts.map +1 -0
- package/dist/src/react/core/threads/use-threads.js +81 -0
- package/dist/src/react/core/threads/use-threads.js.map +1 -0
- package/dist/src/react/core/transcript/index.d.ts +4 -0
- package/dist/src/react/core/transcript/index.d.ts.map +1 -0
- package/dist/src/react/core/transcript/index.js +4 -0
- package/dist/src/react/core/transcript/index.js.map +1 -0
- package/dist/src/react/core/transcript/model.d.ts +399 -0
- package/dist/src/react/core/transcript/model.d.ts.map +1 -0
- package/dist/src/react/core/transcript/model.js +725 -0
- package/dist/src/react/core/transcript/model.js.map +1 -0
- package/dist/src/react/core/transcript/use-chat-transcript.d.ts +254 -0
- package/dist/src/react/core/transcript/use-chat-transcript.d.ts.map +1 -0
- package/dist/src/react/core/transcript/use-chat-transcript.js +572 -0
- package/dist/src/react/core/transcript/use-chat-transcript.js.map +1 -0
- package/dist/src/react/core/transcript/use-stick-to-bottom.d.ts +33 -0
- package/dist/src/react/core/transcript/use-stick-to-bottom.d.ts.map +1 -0
- package/dist/src/react/core/transcript/use-stick-to-bottom.js +48 -0
- package/dist/src/react/core/transcript/use-stick-to-bottom.js.map +1 -0
- package/dist/src/react/core/use-agent-chat.d.ts +341 -0
- package/dist/src/react/core/use-agent-chat.d.ts.map +1 -0
- package/dist/src/react/core/use-agent-chat.js +1118 -0
- package/dist/src/react/core/use-agent-chat.js.map +1 -0
- package/dist/src/react/genui/index.d.ts +1 -7
- package/dist/src/react/genui/index.d.ts.map +1 -1
- package/dist/src/react/genui/index.js +1 -7
- package/dist/src/react/genui/index.js.map +1 -1
- package/dist/src/react/genui/json-render.d.ts +1 -5
- package/dist/src/react/genui/json-render.d.ts.map +1 -1
- package/dist/src/react/genui/json-render.js +1 -5
- package/dist/src/react/genui/json-render.js.map +1 -1
- package/dist/src/react/genui/server.d.ts +2 -0
- package/dist/src/react/genui/server.d.ts.map +1 -0
- package/dist/src/react/genui/server.js +2 -0
- package/dist/src/react/genui/server.js.map +1 -0
- package/dist/src/react/genui/server_playwright.d.ts +2 -0
- package/dist/src/react/genui/server_playwright.d.ts.map +1 -0
- package/dist/src/react/genui/server_playwright.js +2 -0
- package/dist/src/react/genui/server_playwright.js.map +1 -0
- package/dist/src/react/index.d.ts +5 -7
- package/dist/src/react/index.d.ts.map +1 -1
- package/dist/src/react/index.js +5 -7
- package/dist/src/react/index.js.map +1 -1
- package/dist/src/react/markdown.d.ts +1 -6
- package/dist/src/react/markdown.d.ts.map +1 -1
- package/dist/src/react/markdown.js +1 -6
- package/dist/src/react/markdown.js.map +1 -1
- package/dist/src/react/media.d.ts +1 -17
- package/dist/src/react/media.d.ts.map +1 -1
- package/dist/src/react/media.js +1 -17
- package/dist/src/react/media.js.map +1 -1
- package/dist/src/refusal.d.ts +3 -0
- package/dist/src/refusal.d.ts.map +1 -0
- package/dist/src/refusal.js +3 -0
- package/dist/src/refusal.js.map +1 -0
- package/dist/src/spi/agent-runner.d.ts +6 -0
- package/dist/src/spi/agent-runner.d.ts.map +1 -1
- package/dist/src/spi/chat-queue.d.ts +4 -1
- package/dist/src/spi/chat-queue.d.ts.map +1 -1
- package/dist/src/spi/chat-queue.js.map +1 -1
- package/dist/src/spi/protocol-adapter.d.ts +3 -3
- package/dist/src/spi/roles-policy.d.ts +7 -0
- package/dist/src/spi/roles-policy.d.ts.map +1 -1
- package/dist/src/spi/tool.d.ts +18 -3
- package/dist/src/spi/tool.d.ts.map +1 -1
- package/dist/src/stores/lucid-schema.d.ts +24 -6
- package/dist/src/stores/lucid-schema.d.ts.map +1 -1
- package/dist/src/stores/lucid-schema.js +49 -6
- package/dist/src/stores/lucid-schema.js.map +1 -1
- package/dist/src/stores/lucid.d.ts +2 -0
- package/dist/src/stores/lucid.d.ts.map +1 -1
- package/dist/src/stores/lucid.js +7 -0
- package/dist/src/stores/lucid.js.map +1 -1
- package/dist/src/testing/chat-queue-store-contract.d.ts.map +1 -1
- package/dist/src/testing/chat-queue-store-contract.js +4 -0
- package/dist/src/testing/chat-queue-store-contract.js.map +1 -1
- package/dist/src/testing/in-memory-store.d.ts.map +1 -1
- package/dist/src/testing/in-memory-store.js +1 -0
- package/dist/src/testing/in-memory-store.js.map +1 -1
- package/dist/src/tool-discovery.d.ts +1 -1
- package/dist/src/tool-discovery.d.ts.map +1 -1
- package/dist/src/tool-discovery.js +5 -1
- package/dist/src/tool-discovery.js.map +1 -1
- package/dist/src/tool-registry.d.ts +3 -0
- package/dist/src/tool-registry.d.ts.map +1 -1
- package/dist/src/tool-registry.js +15 -3
- package/dist/src/tool-registry.js.map +1 -1
- package/dist/src/tool-result-presentation.d.ts +12 -0
- package/dist/src/tool-result-presentation.d.ts.map +1 -0
- package/dist/src/tool-result-presentation.js +44 -0
- package/dist/src/tool-result-presentation.js.map +1 -0
- package/dist/src/types.d.ts +20 -0
- package/dist/src/types.d.ts.map +1 -1
- package/dist/src/ui-capabilities.d.ts +1 -8
- package/dist/src/ui-capabilities.d.ts.map +1 -1
- package/dist/src/ui-capabilities.js +3 -24
- package/dist/src/ui-capabilities.js.map +1 -1
- package/package.json +128 -22
- package/skills/agent-governance/SKILL.md +12 -4
- package/skills/agent-personas-agents/SKILL.md +2 -1
- package/skills/agent-setup/SKILL.md +73 -14
- package/skills/agent-testing/SKILL.md +22 -0
- package/skills/agent-tools/SKILL.md +57 -9
- package/dist/src/ag-ui/proposal-decision.d.ts.map +0 -1
- package/dist/src/ag-ui/proposal-decision.js.map +0 -1
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
import { defaultScopeResolver } from '../skills.js';
|
|
2
|
+
import { PERSONAL_AGENT_ROLE } from './permission-tool.js';
|
|
3
|
+
/** The role a delegated scope becomes. Namespaced, so a scope can never pose as an app role. */
|
|
4
|
+
export const SCOPE_ROLE_PREFIX = 'scope:';
|
|
5
|
+
export function scopeRole(scope) {
|
|
6
|
+
return `${SCOPE_ROLE_PREFIX}${scope}`;
|
|
7
|
+
}
|
|
8
|
+
function isPersonalAgent(actor) {
|
|
9
|
+
return (actor.roles ?? []).includes(PERSONAL_AGENT_ROLE);
|
|
10
|
+
}
|
|
11
|
+
/**
|
|
12
|
+
* Wrap a {@link RolesPolicy} so personal agents reach only what was written for them.
|
|
13
|
+
*
|
|
14
|
+
* An A2A actor carries {@link PERSONAL_AGENT_ROLE}, plus one {@link scopeRole} per delegated scope.
|
|
15
|
+
* For it, a tool must DECLARE one of those roles, and the wrapped policy must agree too. A tool with
|
|
16
|
+
* no `roles` is unreachable: under the default policy "no roles" means "anyone", and an app's
|
|
17
|
+
* existing tools were never written with an outside caller in mind. Every other actor is decided by
|
|
18
|
+
* the wrapped policy alone, unchanged.
|
|
19
|
+
*/
|
|
20
|
+
export function personalAgentGate(inner) {
|
|
21
|
+
return {
|
|
22
|
+
async can(actor, tool) {
|
|
23
|
+
if (isPersonalAgent(actor)) {
|
|
24
|
+
const roles = actor.roles ?? [];
|
|
25
|
+
if (!(tool.roles ?? []).some((role) => roles.includes(role)))
|
|
26
|
+
return false;
|
|
27
|
+
}
|
|
28
|
+
return inner.can(actor, tool);
|
|
29
|
+
},
|
|
30
|
+
/**
|
|
31
|
+
* A personal agent is OFFERED every tool written for personal agents — `personal_agent`, or a
|
|
32
|
+
* `scope:` role even when that scope was not delegated. Running it still needs {@link can}; the
|
|
33
|
+
* denied call is what the A2A turn turns into a permission request (step-up), so the model asks
|
|
34
|
+
* for a permission by doing what it would do anyway, not by remembering a separate tool.
|
|
35
|
+
*/
|
|
36
|
+
async canOffer(actor, tool) {
|
|
37
|
+
if (!isPersonalAgent(actor)) {
|
|
38
|
+
return inner.canOffer ? inner.canOffer(actor, tool) : inner.can(actor, tool);
|
|
39
|
+
}
|
|
40
|
+
return (tool.roles ?? []).some((role) => role === PERSONAL_AGENT_ROLE || role.startsWith(SCOPE_ROLE_PREFIX));
|
|
41
|
+
},
|
|
42
|
+
};
|
|
43
|
+
}
|
|
44
|
+
/**
|
|
45
|
+
* Wrap the {@link ScopeResolver} of memory or skills so a personal agent resolves NO scope. Under
|
|
46
|
+
* delegation its actor id is the account's — without this it would read the account's memories
|
|
47
|
+
* (and its tenant's) and could write new ones, a standing instruction to the user's own assistant.
|
|
48
|
+
* Built-ins like `remember` come from config, not the registry, so the tool gate never sees them.
|
|
49
|
+
*/
|
|
50
|
+
export function personalAgentScopes(inner) {
|
|
51
|
+
const resolver = inner ?? defaultScopeResolver;
|
|
52
|
+
return {
|
|
53
|
+
resolve: (ctx) => (isPersonalAgent(ctx.actor) ? [] : resolver.resolve(ctx)),
|
|
54
|
+
};
|
|
55
|
+
}
|
|
56
|
+
//# sourceMappingURL=gate.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"gate.js","sourceRoot":"","sources":["../../../src/a2a/gate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAsB,MAAM,cAAc,CAAC;AAGxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,gGAAgG;AAChG,MAAM,CAAC,MAAM,iBAAiB,GAAG,QAAQ,CAAC;AAE1C,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,OAAO,GAAG,iBAAiB,GAAG,KAAK,EAAE,CAAC;AACxC,CAAC;AAED,SAAS,eAAe,CAAC,KAAY;IACnC,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC;AAC3D,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAkB;IAClD,OAAO;QACL,KAAK,CAAC,GAAG,CAAC,KAAY,EAAE,IAAc;YACpC,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC3B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;gBAChC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;oBAAE,OAAO,KAAK,CAAC;YAC7E,CAAC;YACD,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAChC,CAAC;QACD;;;;;WAKG;QACH,KAAK,CAAC,QAAQ,CAAC,KAAY,EAAE,IAAc;YACzC,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC5B,OAAO,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YAC/E,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAC5B,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,mBAAmB,IAAI,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAC7E,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAgC;IAClE,MAAM,QAAQ,GAAG,KAAK,IAAI,oBAAoB,CAAC;IAC/C,OAAO;QACL,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;KAC5E,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
import type { HttpContext } from '@adonisjs/core/http';
|
|
2
|
+
import type { ToolRegistry } from '../tool-registry.js';
|
|
3
|
+
import type { Actor } from '../types.js';
|
|
4
|
+
import type { A2aAuth, A2aCaller } from './auth.js';
|
|
5
|
+
import type { A2aStore } from './store.js';
|
|
6
|
+
import { type A2aActionPolicy, type A2aTurnService } from './turn.js';
|
|
7
|
+
/** What an Agent Card says about the agent, beyond what the surface fills in. */
|
|
8
|
+
export interface A2aCardInput {
|
|
9
|
+
name: string;
|
|
10
|
+
description: string;
|
|
11
|
+
version?: string;
|
|
12
|
+
provider?: {
|
|
13
|
+
organization: string;
|
|
14
|
+
url: string;
|
|
15
|
+
};
|
|
16
|
+
documentationUrl?: string;
|
|
17
|
+
iconUrl?: string;
|
|
18
|
+
skills?: {
|
|
19
|
+
id: string;
|
|
20
|
+
name: string;
|
|
21
|
+
description: string;
|
|
22
|
+
tags: string[];
|
|
23
|
+
examples?: string[];
|
|
24
|
+
}[];
|
|
25
|
+
}
|
|
26
|
+
/** One agent exposed over A2A — a "brand" in PACT terms, at `/{path}/{id}`. */
|
|
27
|
+
export interface A2aBrand {
|
|
28
|
+
id: string;
|
|
29
|
+
/** The registered agent that answers. */
|
|
30
|
+
agentName: string;
|
|
31
|
+
card: A2aCardInput;
|
|
32
|
+
}
|
|
33
|
+
export interface A2aHandlerOptions {
|
|
34
|
+
/** Mount prefix, no slashes (`'a2a'` → `/a2a/{brand}/…`). */
|
|
35
|
+
path: string;
|
|
36
|
+
/** Public origin the card's interface URL is built on. Omitted → the request's. */
|
|
37
|
+
baseUrl?: string;
|
|
38
|
+
brands: ReadonlyMap<string, A2aBrand>;
|
|
39
|
+
/** Serve this brand's card at `/.well-known/agent-card.json` too (PACT §2.1's standard place). */
|
|
40
|
+
rootCardBrand?: string;
|
|
41
|
+
auth: A2aAuth;
|
|
42
|
+
store: A2aStore;
|
|
43
|
+
service: A2aTurnService;
|
|
44
|
+
/** Where a tool's roles are read when the service does not answer them. */
|
|
45
|
+
registry: ToolRegistry;
|
|
46
|
+
actions: A2aActionPolicy;
|
|
47
|
+
timeoutMs: number;
|
|
48
|
+
maxBodyBytes: number;
|
|
49
|
+
/** Roles of the actor a turn runs as. Default: the personal-agent role plus the delegated scopes. */
|
|
50
|
+
roles?: (caller: A2aCaller) => string[];
|
|
51
|
+
/** Map the caller to the app's actor (see `A2aConfig.actor`). */
|
|
52
|
+
actor?: (caller: A2aCaller, defaults: Actor) => Actor | Promise<Actor>;
|
|
53
|
+
}
|
|
54
|
+
/**
|
|
55
|
+
* The actor of an identity-only turn: stable per (personal agent, its user), never an account id —
|
|
56
|
+
* the `pa:` prefix keeps it from ever colliding with one.
|
|
57
|
+
*/
|
|
58
|
+
export declare function personalAgentActorId(issuer: string, sub: string): string;
|
|
59
|
+
/**
|
|
60
|
+
* The A2A 1.0 HTTP+JSON surface (PACT §2, §4, §5.5) over the agent runtime. Returns a request
|
|
61
|
+
* handler that answers everything under `/{path}/` and reports `false` for anything else, so it can
|
|
62
|
+
* sit in front of the router.
|
|
63
|
+
*/
|
|
64
|
+
export declare function createA2aHandler(options: A2aHandlerOptions): (ctx: HttpContext) => Promise<boolean>;
|
|
65
|
+
//# sourceMappingURL=handler.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../src/a2a/handler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAUpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,cAAc,EAAc,MAAM,WAAW,CAAC;AAElF,iFAAiF;AACjF,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACjD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE;QACP,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,EAAE,CAAC;CACL;AAED,+EAA+E;AAC/E,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,YAAY,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,mFAAmF;IACnF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACtC,kGAAkG;IAClG,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,EAAE,cAAc,CAAC;IACxB,2EAA2E;IAC3E,QAAQ,EAAE,YAAY,CAAC;IACvB,OAAO,EAAE,eAAe,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,qGAAqG;IACrG,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,MAAM,EAAE,CAAC;IACxC,iEAAiE;IACjE,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,KAAK,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;CACxE;AAID;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAExE;AAmGD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,SA2KvB,WAAW,KAAG,OAAO,CAAC,OAAO,CAAC,CAiEjE"}
|
|
@@ -0,0 +1,322 @@
|
|
|
1
|
+
import { createHash, randomUUID } from 'node:crypto';
|
|
2
|
+
import { scopeRole } from './gate.js';
|
|
3
|
+
import { PERSONAL_AGENT_ROLE } from './permission-tool.js';
|
|
4
|
+
import { A2A_CONTENT_TYPE, A2aError, parseSendMessage, } from './protocol.js';
|
|
5
|
+
import { runA2aTurn } from './turn.js';
|
|
6
|
+
const DEFAULT_PAGE_SIZE = 50;
|
|
7
|
+
/**
|
|
8
|
+
* The actor of an identity-only turn: stable per (personal agent, its user), never an account id —
|
|
9
|
+
* the `pa:` prefix keeps it from ever colliding with one.
|
|
10
|
+
*/
|
|
11
|
+
export function personalAgentActorId(issuer, sub) {
|
|
12
|
+
return `pa:${createHash('sha256').update(`${issuer}\n${sub}`).digest('hex').slice(0, 40)}`;
|
|
13
|
+
}
|
|
14
|
+
async function actorFor(caller, options) {
|
|
15
|
+
const extra = options.roles?.(caller) ?? (caller.delegation?.scopes ?? []).map(scopeRole);
|
|
16
|
+
const defaults = {
|
|
17
|
+
id: caller.delegation?.accountId ?? personalAgentActorId(caller.issuer, caller.sub),
|
|
18
|
+
roles: [...new Set([PERSONAL_AGENT_ROLE, ...extra])],
|
|
19
|
+
};
|
|
20
|
+
const actor = options.actor ? await options.actor(caller, defaults) : defaults;
|
|
21
|
+
// `personal_agent` is ALWAYS there, whatever the hook returned: it is what puts the actor behind
|
|
22
|
+
// `personalAgentGate`.
|
|
23
|
+
return { ...actor, roles: [...new Set([PERSONAL_AGENT_ROLE, ...(actor.roles ?? [])])] };
|
|
24
|
+
}
|
|
25
|
+
/**
|
|
26
|
+
* Where the FIRST message of a conversation is claimed: it has no `contextId` yet, so a retry of it
|
|
27
|
+
* could only be told apart from a new conversation by this per-(brand, personal-agent user) slot.
|
|
28
|
+
*/
|
|
29
|
+
function newConversationKey(brand, caller) {
|
|
30
|
+
return `new:${brand}:${personalAgentActorId(caller.issuer, caller.sub)}`;
|
|
31
|
+
}
|
|
32
|
+
function sendA2a(ctx, status, body) {
|
|
33
|
+
ctx.response.status(status);
|
|
34
|
+
ctx.response.header('Content-Type', A2A_CONTENT_TYPE);
|
|
35
|
+
ctx.response.send(JSON.stringify(body));
|
|
36
|
+
}
|
|
37
|
+
/** A bare status, no A2A body — unmatched routes and unknown brands (PACT §2.2). */
|
|
38
|
+
function sendBare(ctx, status) {
|
|
39
|
+
ctx.response.status(status);
|
|
40
|
+
ctx.response.header('Content-Type', 'text/plain; charset=utf-8');
|
|
41
|
+
ctx.response.send(status === 404 ? 'Not Found' : 'Method Not Allowed');
|
|
42
|
+
}
|
|
43
|
+
/** The request body, read straight off the socket: no bodyparser runs ahead of this surface. */
|
|
44
|
+
async function readBody(ctx, limit) {
|
|
45
|
+
const parsed = ctx.request.raw?.();
|
|
46
|
+
if (typeof parsed === 'string')
|
|
47
|
+
return parsed;
|
|
48
|
+
const chunks = [];
|
|
49
|
+
let size = 0;
|
|
50
|
+
for await (const chunk of ctx.request.request) {
|
|
51
|
+
const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
|
|
52
|
+
size += buffer.length;
|
|
53
|
+
if (size > limit)
|
|
54
|
+
throw new A2aError('INVALID_PARAMS', 'Request body is too large');
|
|
55
|
+
chunks.push(buffer);
|
|
56
|
+
}
|
|
57
|
+
return Buffer.concat(chunks).toString('utf8');
|
|
58
|
+
}
|
|
59
|
+
/** The request path without the query string. */
|
|
60
|
+
function pathOf(ctx) {
|
|
61
|
+
return (ctx.request.url() ?? '').split('?')[0] ?? '';
|
|
62
|
+
}
|
|
63
|
+
/**
|
|
64
|
+
* Match `rest` (the path after `/{path}/{brand}/`) against the A2A operations. `null` → 404, a
|
|
65
|
+
* method mismatch → 405 — both decided before any authentication (PACT §2.2).
|
|
66
|
+
*/
|
|
67
|
+
function matchRoute(method, rest) {
|
|
68
|
+
const allow = (methods, route) => (methods.includes(method) ? route : 405);
|
|
69
|
+
if (rest === '.well-known/agent-card.json')
|
|
70
|
+
return allow(['GET'], { kind: 'card' });
|
|
71
|
+
if (rest === 'message:send')
|
|
72
|
+
return allow(['POST'], { kind: 'send' });
|
|
73
|
+
if (rest === 'message:stream')
|
|
74
|
+
return allow(['POST'], { kind: 'unsupported' });
|
|
75
|
+
if (rest === 'extendedAgentCard')
|
|
76
|
+
return allow(['GET'], { kind: 'unsupported' });
|
|
77
|
+
if (rest === 'tasks')
|
|
78
|
+
return allow(['GET'], { kind: 'listTasks' });
|
|
79
|
+
const segments = rest.split('/');
|
|
80
|
+
if (segments[0] !== 'tasks' || !segments[1])
|
|
81
|
+
return 404;
|
|
82
|
+
const [, taskSegment, sub, configId, ...extra] = segments;
|
|
83
|
+
if (extra.length > 0)
|
|
84
|
+
return 404;
|
|
85
|
+
if (sub === undefined) {
|
|
86
|
+
const action = /^(.+):(cancel|subscribe)$/.exec(taskSegment);
|
|
87
|
+
if (action?.[2] === 'cancel') {
|
|
88
|
+
return allow(['POST'], { kind: 'task', taskId: action[1] ?? taskSegment });
|
|
89
|
+
}
|
|
90
|
+
if (action?.[2] === 'subscribe')
|
|
91
|
+
return allow(['POST', 'GET'], { kind: 'unsupported' });
|
|
92
|
+
return allow(['GET'], { kind: 'task', taskId: taskSegment });
|
|
93
|
+
}
|
|
94
|
+
if (sub !== 'pushNotificationConfigs')
|
|
95
|
+
return 404;
|
|
96
|
+
return configId === undefined
|
|
97
|
+
? allow(['GET', 'POST'], { kind: 'push' })
|
|
98
|
+
: allow(['GET', 'DELETE'], { kind: 'push' });
|
|
99
|
+
}
|
|
100
|
+
/**
|
|
101
|
+
* The A2A 1.0 HTTP+JSON surface (PACT §2, §4, §5.5) over the agent runtime. Returns a request
|
|
102
|
+
* handler that answers everything under `/{path}/` and reports `false` for anything else, so it can
|
|
103
|
+
* sit in front of the router.
|
|
104
|
+
*/
|
|
105
|
+
export function createA2aHandler(options) {
|
|
106
|
+
const prefix = `/${options.path}/`;
|
|
107
|
+
const toolRoles = (name) => options.service.toolRoles?.(name) ?? options.registry.spec(name)?.roles;
|
|
108
|
+
const interfaceUrl = (ctx, brand) => {
|
|
109
|
+
const origin = options.baseUrl?.replace(/\/+$/, '') ??
|
|
110
|
+
`${ctx.request.protocol()}://${ctx.request.host() ?? 'localhost'}`;
|
|
111
|
+
return `${origin}/${options.path}/${encodeURIComponent(brand.id)}`;
|
|
112
|
+
};
|
|
113
|
+
async function card(ctx, brand) {
|
|
114
|
+
const url = interfaceUrl(ctx, brand);
|
|
115
|
+
ctx.response.header('Content-Type', 'application/json');
|
|
116
|
+
ctx.response.header('Access-Control-Allow-Origin', '*');
|
|
117
|
+
ctx.response.send(JSON.stringify({
|
|
118
|
+
name: brand.card.name,
|
|
119
|
+
description: brand.card.description,
|
|
120
|
+
supportedInterfaces: [{ url, protocolBinding: 'HTTP+JSON', protocolVersion: '1.0' }],
|
|
121
|
+
...(brand.card.provider ? { provider: brand.card.provider } : {}),
|
|
122
|
+
version: brand.card.version ?? '1.0.0',
|
|
123
|
+
...(brand.card.documentationUrl ? { documentationUrl: brand.card.documentationUrl } : {}),
|
|
124
|
+
...(brand.card.iconUrl ? { iconUrl: brand.card.iconUrl } : {}),
|
|
125
|
+
capabilities: { streaming: false, pushNotifications: false, extendedAgentCard: false },
|
|
126
|
+
...(await options.auth.cardSecurity(ctx, url)),
|
|
127
|
+
defaultInputModes: ['text/plain'],
|
|
128
|
+
defaultOutputModes: ['text/plain'],
|
|
129
|
+
skills: brand.card.skills ?? [],
|
|
130
|
+
}));
|
|
131
|
+
}
|
|
132
|
+
async function send(ctx, brand, caller) {
|
|
133
|
+
const input = parseSendMessage(await readBody(ctx, options.maxBodyBytes));
|
|
134
|
+
const actor = await actorFor(caller, options);
|
|
135
|
+
const accountId = caller.delegation?.accountId ?? null;
|
|
136
|
+
if (input.contextId !== undefined) {
|
|
137
|
+
const context = await options.store.getContext(input.contextId);
|
|
138
|
+
// Another user's or another brand's context is indistinguishable from none (PACT §4.2).
|
|
139
|
+
if (!context ||
|
|
140
|
+
context.brand !== brand.id ||
|
|
141
|
+
context.agentIssuer !== caller.issuer ||
|
|
142
|
+
context.agentSub !== caller.sub) {
|
|
143
|
+
throw new A2aError('INVALID_PARAMS', 'Unknown contextId');
|
|
144
|
+
}
|
|
145
|
+
// A conversation that ran as an account holds that account's data: it continues only under
|
|
146
|
+
// a delegation for it — not identity-only (a revoked grant), not another account (§5.5).
|
|
147
|
+
if (context.accountRef !== null && accountId === null) {
|
|
148
|
+
throw new A2aError('INVALID_PARAMS', 'contextId needs the delegation it ran under');
|
|
149
|
+
}
|
|
150
|
+
if (accountId !== null && !(await options.store.bindAccount(input.contextId, accountId))) {
|
|
151
|
+
throw new A2aError('INVALID_PARAMS', 'contextId belongs to another account');
|
|
152
|
+
}
|
|
153
|
+
}
|
|
154
|
+
const claimKey = input.contextId ?? newConversationKey(brand.id, caller);
|
|
155
|
+
const claim = await options.store.claimMessage(claimKey, input.messageId);
|
|
156
|
+
if (claim.status === 'done') {
|
|
157
|
+
const stored = claim.reply;
|
|
158
|
+
return sendA2a(ctx, stored.status, stored.body);
|
|
159
|
+
}
|
|
160
|
+
if (claim.status === 'pending') {
|
|
161
|
+
throw new A2aError('INVALID_PARAMS', 'messageId is already in use in this context');
|
|
162
|
+
}
|
|
163
|
+
let threadId = input.contextId;
|
|
164
|
+
const finish = async (reply) => {
|
|
165
|
+
await options.store.completeMessage(claimKey, input.messageId, reply);
|
|
166
|
+
// A first message is also answerable from its new context — a retry may carry it by now.
|
|
167
|
+
if (threadId !== undefined && threadId !== claimKey) {
|
|
168
|
+
await options.store.claimMessage(threadId, input.messageId);
|
|
169
|
+
await options.store.completeMessage(threadId, input.messageId, reply);
|
|
170
|
+
}
|
|
171
|
+
sendA2a(ctx, reply.status, reply.body);
|
|
172
|
+
};
|
|
173
|
+
let turn;
|
|
174
|
+
try {
|
|
175
|
+
turn = await runA2aTurn(options.service, toolRoles, {
|
|
176
|
+
actor,
|
|
177
|
+
text: input.text,
|
|
178
|
+
agentName: brand.agentName,
|
|
179
|
+
...(input.contextId !== undefined ? { threadId: input.contextId } : {}),
|
|
180
|
+
delegatedScopes: caller.delegation?.scopes ?? null,
|
|
181
|
+
actions: options.actions,
|
|
182
|
+
timeoutMs: options.timeoutMs,
|
|
183
|
+
onStarted: async (id) => {
|
|
184
|
+
threadId = id;
|
|
185
|
+
if (input.contextId !== undefined)
|
|
186
|
+
return;
|
|
187
|
+
await options.store.createContext({
|
|
188
|
+
id,
|
|
189
|
+
brand: brand.id,
|
|
190
|
+
agentIssuer: caller.issuer,
|
|
191
|
+
agentSub: caller.sub,
|
|
192
|
+
accountRef: accountId,
|
|
193
|
+
});
|
|
194
|
+
},
|
|
195
|
+
});
|
|
196
|
+
}
|
|
197
|
+
catch (error) {
|
|
198
|
+
await options.store.releaseMessage(claimKey, input.messageId);
|
|
199
|
+
if (error.code === 'run_active') {
|
|
200
|
+
throw new A2aError('INVALID_PARAMS', 'contextId already has a message in progress');
|
|
201
|
+
}
|
|
202
|
+
throw error;
|
|
203
|
+
}
|
|
204
|
+
if (turn.error !== null) {
|
|
205
|
+
const failure = new A2aError('INTERNAL', 'The agent could not answer');
|
|
206
|
+
// Something already ran on the account: a retry must get this failure back, not run it again.
|
|
207
|
+
if (turn.actions.length > 0) {
|
|
208
|
+
return finish({ status: failure.httpStatus, body: failure.toJSON() });
|
|
209
|
+
}
|
|
210
|
+
await options.store.releaseMessage(claimKey, input.messageId);
|
|
211
|
+
throw failure;
|
|
212
|
+
}
|
|
213
|
+
const receipt = caller.delegation
|
|
214
|
+
? await options.auth.receipt(ctx, {
|
|
215
|
+
scopesUsed: [...new Set(turn.actions.flatMap((action) => action.scopes))],
|
|
216
|
+
actions: turn.actions.map(({ tool, argsHash }) => ({ tool, argsHash })),
|
|
217
|
+
})
|
|
218
|
+
: {};
|
|
219
|
+
const message = {
|
|
220
|
+
messageId: randomUUID(),
|
|
221
|
+
contextId: turn.threadId,
|
|
222
|
+
role: 'ROLE_AGENT',
|
|
223
|
+
parts: [
|
|
224
|
+
...(turn.text !== '' || turn.outcomes.length === 0 ? [{ text: turn.text }] : []),
|
|
225
|
+
...turn.outcomes.map((outcome) => ({
|
|
226
|
+
data: { action: outcome },
|
|
227
|
+
mediaType: 'application/json',
|
|
228
|
+
})),
|
|
229
|
+
],
|
|
230
|
+
...(Object.keys(receipt).length > 0 ? { metadata: receipt } : {}),
|
|
231
|
+
};
|
|
232
|
+
let reply = { message };
|
|
233
|
+
const missing = (turn.permission ?? []).filter((scope) => !(caller.delegation?.scopes ?? []).includes(scope));
|
|
234
|
+
if (missing.length > 0) {
|
|
235
|
+
const stepUp = await options.auth.stepUp(ctx, missing);
|
|
236
|
+
if (stepUp !== null) {
|
|
237
|
+
reply = {
|
|
238
|
+
task: {
|
|
239
|
+
id: `t-${randomUUID()}`,
|
|
240
|
+
contextId: turn.threadId,
|
|
241
|
+
status: { state: 'TASK_STATE_AUTH_REQUIRED', message },
|
|
242
|
+
metadata: { ...receipt, ...stepUp },
|
|
243
|
+
},
|
|
244
|
+
};
|
|
245
|
+
}
|
|
246
|
+
}
|
|
247
|
+
await finish({ status: 200, body: reply });
|
|
248
|
+
}
|
|
249
|
+
function listTasks(ctx) {
|
|
250
|
+
const raw = ctx.request.qs().pageSize;
|
|
251
|
+
const pageSize = raw === undefined ? DEFAULT_PAGE_SIZE : Number(raw);
|
|
252
|
+
if (!Number.isInteger(pageSize) || pageSize < 1 || pageSize > 100) {
|
|
253
|
+
throw new A2aError('INVALID_PARAMS', 'pageSize must be an integer from 1 to 100');
|
|
254
|
+
}
|
|
255
|
+
// Ordinary turns create no task (PACT §4.2) and step-up tasks are ephemeral.
|
|
256
|
+
sendA2a(ctx, 200, { tasks: [], nextPageToken: '', pageSize, totalSize: 0 });
|
|
257
|
+
}
|
|
258
|
+
return async function handle(ctx) {
|
|
259
|
+
const path = pathOf(ctx);
|
|
260
|
+
const method = ctx.request.method().toUpperCase();
|
|
261
|
+
if (path === '/.well-known/agent-card.json' && options.rootCardBrand !== undefined) {
|
|
262
|
+
const brand = options.brands.get(options.rootCardBrand);
|
|
263
|
+
if (!brand)
|
|
264
|
+
return false;
|
|
265
|
+
if (method !== 'GET') {
|
|
266
|
+
sendBare(ctx, 405);
|
|
267
|
+
return true;
|
|
268
|
+
}
|
|
269
|
+
await card(ctx, brand);
|
|
270
|
+
return true;
|
|
271
|
+
}
|
|
272
|
+
if (!path.startsWith(prefix))
|
|
273
|
+
return false;
|
|
274
|
+
const [brandSegment = '', ...restSegments] = path.slice(prefix.length).split('/');
|
|
275
|
+
let brandId;
|
|
276
|
+
try {
|
|
277
|
+
brandId = decodeURIComponent(brandSegment);
|
|
278
|
+
}
|
|
279
|
+
catch {
|
|
280
|
+
brandId = '';
|
|
281
|
+
}
|
|
282
|
+
const brand = options.brands.get(brandId);
|
|
283
|
+
const route = brand ? matchRoute(method, restSegments.join('/')) : 404;
|
|
284
|
+
if (!brand || route === 404 || route === 405) {
|
|
285
|
+
sendBare(ctx, route === 405 ? 405 : 404);
|
|
286
|
+
return true;
|
|
287
|
+
}
|
|
288
|
+
try {
|
|
289
|
+
if (route.kind === 'card') {
|
|
290
|
+
await card(ctx, brand);
|
|
291
|
+
return true;
|
|
292
|
+
}
|
|
293
|
+
// Authenticate before reading the body (PACT §3.4).
|
|
294
|
+
const caller = await options.auth.authenticate(ctx);
|
|
295
|
+
if (!caller)
|
|
296
|
+
return true;
|
|
297
|
+
switch (route.kind) {
|
|
298
|
+
case 'send':
|
|
299
|
+
await send(ctx, brand, caller);
|
|
300
|
+
break;
|
|
301
|
+
case 'listTasks':
|
|
302
|
+
listTasks(ctx);
|
|
303
|
+
break;
|
|
304
|
+
case 'task':
|
|
305
|
+
throw new A2aError('TASK_NOT_FOUND', `Task not found: ${route.taskId}`);
|
|
306
|
+
case 'unsupported':
|
|
307
|
+
throw new A2aError('UNSUPPORTED_OPERATION', 'This operation is not supported');
|
|
308
|
+
case 'push':
|
|
309
|
+
throw new A2aError('PUSH_NOTIFICATION_NOT_SUPPORTED', 'Push notifications are not supported');
|
|
310
|
+
}
|
|
311
|
+
}
|
|
312
|
+
catch (error) {
|
|
313
|
+
const a2a = error instanceof A2aError ? error : new A2aError('INTERNAL', 'Internal error');
|
|
314
|
+
if (!(error instanceof A2aError)) {
|
|
315
|
+
ctx.logger?.error({ err: error }, 'a2a: request failed');
|
|
316
|
+
}
|
|
317
|
+
sendA2a(ctx, a2a.httpStatus, a2a.toJSON());
|
|
318
|
+
}
|
|
319
|
+
return true;
|
|
320
|
+
};
|
|
321
|
+
}
|
|
322
|
+
//# sourceMappingURL=handler.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../../src/a2a/handler.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
export type { A2aAuth, A2aAuthContext, A2aAuthFactory, A2aCaller, A2aReceiptInput, } from './auth.js';
|
|
2
|
+
export { authKitPersonalAgents, resolveA2aAuth } from './auth.js';
|
|
3
|
+
export type { A2aAgentConfig, A2aConfig } from './define_config.js';
|
|
4
|
+
export { defineA2aConfig } from './define_config.js';
|
|
5
|
+
export { personalAgentGate } from './gate.js';
|
|
6
|
+
export type { A2aBrand, A2aCardInput, A2aHandlerOptions } from './handler.js';
|
|
7
|
+
export { createA2aHandler, personalAgentActorId } from './handler.js';
|
|
8
|
+
export { PERMISSION_COMPONENT, PERSONAL_AGENT_ROLE, REQUEST_PERMISSION_TOOL, registerRequestPermissionTool, } from './permission-tool.js';
|
|
9
|
+
export type { A2aDataPart, A2aErrorReason, A2aMessage, A2aSendResult, A2aTask, } from './protocol.js';
|
|
10
|
+
export { A2A_CONTENT_TYPE, A2aError, parseSendMessage } from './protocol.js';
|
|
11
|
+
export type { A2aContext, A2aStore, MessageClaim } from './store.js';
|
|
12
|
+
export { A2A_TABLES, a2aTableStatements, ensureA2aTables, InMemoryA2aStore, LucidA2aStore, } from './store.js';
|
|
13
|
+
export type { A2aActionPolicy, A2aTurnOutcome, A2aTurnResult, A2aTurnService, } from './turn.js';
|
|
14
|
+
export { runA2aTurn } from './turn.js';
|
|
15
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/a2a/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,OAAO,EACP,cAAc,EACd,cAAc,EACd,SAAS,EACT,eAAe,GAChB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAClE,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,uBAAuB,EACvB,6BAA6B,GAC9B,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,WAAW,EACX,cAAc,EACd,UAAU,EACV,aAAa,EACb,OAAO,GACR,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC7E,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,EACL,UAAU,EACV,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,eAAe,EACf,cAAc,EACd,aAAa,EACb,cAAc,GACf,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC"}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
export { authKitPersonalAgents, resolveA2aAuth } from './auth.js';
|
|
2
|
+
export { defineA2aConfig } from './define_config.js';
|
|
3
|
+
export { personalAgentGate } from './gate.js';
|
|
4
|
+
export { createA2aHandler, personalAgentActorId } from './handler.js';
|
|
5
|
+
export { PERMISSION_COMPONENT, PERSONAL_AGENT_ROLE, REQUEST_PERMISSION_TOOL, registerRequestPermissionTool, } from './permission-tool.js';
|
|
6
|
+
export { A2A_CONTENT_TYPE, A2aError, parseSendMessage } from './protocol.js';
|
|
7
|
+
export { A2A_TABLES, a2aTableStatements, ensureA2aTables, InMemoryA2aStore, LucidA2aStore, } from './store.js';
|
|
8
|
+
export { runA2aTurn } from './turn.js';
|
|
9
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/a2a/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAElE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,uBAAuB,EACvB,6BAA6B,GAC9B,MAAM,sBAAsB,CAAC;AAQ9B,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAE7E,OAAO,EACL,UAAU,EACV,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,aAAa,GACd,MAAM,YAAY,CAAC;AAOpB,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC"}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import type { ToolRegistry } from '../tool-registry.js';
|
|
2
|
+
/** The role every A2A caller carries — what a tool names to be reachable by personal agents at all. */
|
|
3
|
+
export declare const PERSONAL_AGENT_ROLE = "personal_agent";
|
|
4
|
+
export declare const REQUEST_PERMISSION_TOOL = "request_permission";
|
|
5
|
+
/** The component the tool pushes into the stream; the A2A turn reads it back as a step-up. */
|
|
6
|
+
export declare const PERMISSION_COMPONENT = "a2a.permission";
|
|
7
|
+
/**
|
|
8
|
+
* Register `request_permission`: the tool a personal agent's turn calls when what it was asked to do
|
|
9
|
+
* needs a permission the user has not delegated. It pushes the requested scopes into the stream and
|
|
10
|
+
* ENDS the turn; the A2A handler answers with a step-up task (PACT §5.5) carrying a consent link for
|
|
11
|
+
* exactly those scopes. The conversation stays open — the agent re-sends once the user approves.
|
|
12
|
+
*
|
|
13
|
+
* Only personal agents reach it ({@link PERSONAL_AGENT_ROLE}), and only scopes the deployment
|
|
14
|
+
* offers can be asked for.
|
|
15
|
+
*/
|
|
16
|
+
export declare function registerRequestPermissionTool(registry: ToolRegistry, scopes: Record<string, string>): void;
|
|
17
|
+
//# sourceMappingURL=permission-tool.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"permission-tool.d.ts","sourceRoot":"","sources":["../../../src/a2a/permission-tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,uGAAuG;AACvG,eAAO,MAAM,mBAAmB,mBAAmB,CAAC;AAEpD,eAAO,MAAM,uBAAuB,uBAAuB,CAAC;AAE5D,8FAA8F;AAC9F,eAAO,MAAM,oBAAoB,mBAAmB,CAAC;AA4CrD;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,YAAY,EACtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,IAAI,CAoBN"}
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
/** The role every A2A caller carries — what a tool names to be reachable by personal agents at all. */
|
|
2
|
+
export const PERSONAL_AGENT_ROLE = 'personal_agent';
|
|
3
|
+
export const REQUEST_PERMISSION_TOOL = 'request_permission';
|
|
4
|
+
/** The component the tool pushes into the stream; the A2A turn reads it back as a step-up. */
|
|
5
|
+
export const PERMISSION_COMPONENT = 'a2a.permission';
|
|
6
|
+
function inputSchema(scopeIds) {
|
|
7
|
+
const known = new Set(scopeIds);
|
|
8
|
+
return {
|
|
9
|
+
'~standard': {
|
|
10
|
+
version: 1,
|
|
11
|
+
vendor: 'adonis-agora-agent',
|
|
12
|
+
validate: (value) => {
|
|
13
|
+
const scopes = value?.scopes;
|
|
14
|
+
if (!Array.isArray(scopes) || scopes.length === 0) {
|
|
15
|
+
return { issues: [{ message: 'must be a non-empty array', path: ['scopes'] }] };
|
|
16
|
+
}
|
|
17
|
+
const unknownScope = scopes.find((id) => typeof id !== 'string' || !known.has(id));
|
|
18
|
+
if (unknownScope !== undefined) {
|
|
19
|
+
return {
|
|
20
|
+
issues: [{ message: `unknown scope ${String(unknownScope)}`, path: ['scopes'] }],
|
|
21
|
+
};
|
|
22
|
+
}
|
|
23
|
+
return { value: { scopes: [...new Set(scopes)] } };
|
|
24
|
+
},
|
|
25
|
+
jsonSchema: {
|
|
26
|
+
input: () => ({
|
|
27
|
+
type: 'object',
|
|
28
|
+
properties: {
|
|
29
|
+
scopes: {
|
|
30
|
+
type: 'array',
|
|
31
|
+
items: { type: 'string', enum: scopeIds },
|
|
32
|
+
minItems: 1,
|
|
33
|
+
description: 'The permissions this request needs and the user has not granted yet.',
|
|
34
|
+
},
|
|
35
|
+
},
|
|
36
|
+
required: ['scopes'],
|
|
37
|
+
additionalProperties: false,
|
|
38
|
+
}),
|
|
39
|
+
},
|
|
40
|
+
},
|
|
41
|
+
};
|
|
42
|
+
}
|
|
43
|
+
/**
|
|
44
|
+
* Register `request_permission`: the tool a personal agent's turn calls when what it was asked to do
|
|
45
|
+
* needs a permission the user has not delegated. It pushes the requested scopes into the stream and
|
|
46
|
+
* ENDS the turn; the A2A handler answers with a step-up task (PACT §5.5) carrying a consent link for
|
|
47
|
+
* exactly those scopes. The conversation stays open — the agent re-sends once the user approves.
|
|
48
|
+
*
|
|
49
|
+
* Only personal agents reach it ({@link PERSONAL_AGENT_ROLE}), and only scopes the deployment
|
|
50
|
+
* offers can be asked for.
|
|
51
|
+
*/
|
|
52
|
+
export function registerRequestPermissionTool(registry, scopes) {
|
|
53
|
+
const ids = Object.keys(scopes);
|
|
54
|
+
const catalog = ids.map((id) => `- ${id}: ${scopes[id]}`).join('\n');
|
|
55
|
+
registry.register({
|
|
56
|
+
name: REQUEST_PERMISSION_TOOL,
|
|
57
|
+
kind: 'read',
|
|
58
|
+
terminal: true,
|
|
59
|
+
roles: [PERSONAL_AGENT_ROLE],
|
|
60
|
+
description: `Ask the user to grant permissions you do not have yet. Call it when the request needs one of these and it is not among your current permissions — the user approves on their own account page and you continue afterwards:\n${catalog}`,
|
|
61
|
+
inputSchema: inputSchema(ids),
|
|
62
|
+
}, {
|
|
63
|
+
async execute(input, ctx) {
|
|
64
|
+
const { scopes: requested } = input;
|
|
65
|
+
await ctx.emitComponent?.(PERMISSION_COMPONENT, { scopes: requested });
|
|
66
|
+
return { requested, status: 'awaiting_user_approval' };
|
|
67
|
+
},
|
|
68
|
+
});
|
|
69
|
+
}
|
|
70
|
+
//# sourceMappingURL=permission-tool.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"permission-tool.js","sourceRoot":"","sources":["../../../src/a2a/permission-tool.ts"],"names":[],"mappings":"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"}
|