@artinet/sdk 0.5.12 → 0.5.14
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +40 -81
- package/dist/client/a2a-client.d.ts +16 -7
- package/dist/client/a2a-client.js +25 -14
- package/dist/client/index.d.ts +0 -1
- package/dist/client/index.js +0 -1
- package/dist/index.d.ts +0 -1
- package/dist/index.js +0 -1
- package/dist/server/express/errors.d.ts +0 -1
- package/dist/server/express/errors.js +0 -1
- package/dist/server/express/index.d.ts +0 -1
- package/dist/server/express/index.js +0 -1
- package/dist/server/express/middeware.d.ts +0 -1
- package/dist/server/express/middeware.js +0 -1
- package/dist/server/express/server.d.ts +0 -1
- package/dist/server/express/server.js +0 -1
- package/dist/server/index.d.ts +0 -1
- package/dist/server/index.js +0 -1
- package/dist/services/a2a/factory/builder.d.ts +0 -1
- package/dist/services/a2a/factory/builder.js +0 -1
- package/dist/services/a2a/factory/context.d.ts +0 -1
- package/dist/services/a2a/factory/context.js +0 -1
- package/dist/services/a2a/factory/event.d.ts +0 -1
- package/dist/services/a2a/factory/event.js +0 -1
- package/dist/services/a2a/factory/index.d.ts +0 -1
- package/dist/services/a2a/factory/index.js +0 -1
- package/dist/services/a2a/factory/method.d.ts +0 -1
- package/dist/services/a2a/factory/method.js +0 -1
- package/dist/services/a2a/factory/service.d.ts +0 -1
- package/dist/services/a2a/factory/service.js +0 -1
- package/dist/services/a2a/helpers/content.d.ts +0 -1
- package/dist/services/a2a/helpers/content.js +0 -1
- package/dist/services/a2a/helpers/index.d.ts +1 -1
- package/dist/services/a2a/helpers/index.js +1 -1
- package/dist/services/a2a/helpers/message-builder.d.ts +12 -0
- package/dist/services/a2a/helpers/message-builder.js +61 -0
- package/dist/services/a2a/helpers/part.d.ts +0 -1
- package/dist/services/a2a/helpers/part.js +0 -1
- package/dist/services/a2a/index.d.ts +0 -1
- package/dist/services/a2a/index.js +0 -1
- package/dist/services/a2a/managers/cancellation.d.ts +0 -1
- package/dist/services/a2a/managers/cancellation.js +0 -1
- package/dist/services/a2a/managers/connection.d.ts +0 -1
- package/dist/services/a2a/managers/connection.js +0 -1
- package/dist/services/a2a/managers/context.d.ts +0 -1
- package/dist/services/a2a/managers/context.js +0 -1
- package/dist/services/a2a/managers/index.d.ts +0 -1
- package/dist/services/a2a/managers/index.js +0 -1
- package/dist/services/a2a/managers/task.d.ts +0 -1
- package/dist/services/a2a/managers/task.js +0 -1
- package/dist/services/a2a/methods/cancel-task.d.ts +0 -1
- package/dist/services/a2a/methods/cancel-task.js +0 -1
- package/dist/services/a2a/methods/get-task.d.ts +0 -1
- package/dist/services/a2a/methods/get-task.js +0 -1
- package/dist/services/a2a/methods/index.d.ts +0 -1
- package/dist/services/a2a/methods/index.js +0 -1
- package/dist/services/a2a/methods/resubscribe-task.d.ts +0 -1
- package/dist/services/a2a/methods/resubscribe-task.js +0 -1
- package/dist/services/a2a/methods/send-message.d.ts +0 -1
- package/dist/services/a2a/methods/send-message.js +0 -1
- package/dist/services/a2a/methods/stream-message.d.ts +0 -1
- package/dist/services/a2a/methods/stream-message.js +0 -1
- package/dist/services/a2a/service.d.ts +2 -3
- package/dist/services/a2a/service.js +3 -3
- package/dist/services/a2a/state/index.d.ts +0 -1
- package/dist/services/a2a/state/index.js +0 -1
- package/dist/services/a2a/state/load.d.ts +0 -1
- package/dist/services/a2a/state/load.js +2 -1
- package/dist/services/a2a/state/process.d.ts +0 -1
- package/dist/services/a2a/state/process.js +0 -1
- package/dist/services/a2a/state/update/artifact.d.ts +0 -1
- package/dist/services/a2a/state/update/artifact.js +0 -1
- package/dist/services/a2a/state/update/index.d.ts +0 -1
- package/dist/services/a2a/state/update/index.js +0 -1
- package/dist/services/a2a/state/update/update.d.ts +0 -1
- package/dist/services/a2a/state/update/update.js +0 -1
- package/dist/services/core/execution/execute.d.ts +0 -1
- package/dist/services/core/execution/execute.js +0 -1
- package/dist/services/core/execution/index.d.ts +0 -1
- package/dist/services/core/execution/index.js +0 -1
- package/dist/services/core/index.d.ts +0 -1
- package/dist/services/core/index.js +0 -1
- package/dist/services/core/managers/command.d.ts +0 -1
- package/dist/services/core/managers/command.js +0 -1
- package/dist/services/core/managers/event.d.ts +0 -1
- package/dist/services/core/managers/event.js +0 -1
- package/dist/services/core/managers/index.d.ts +0 -1
- package/dist/services/core/managers/index.js +0 -1
- package/dist/services/core/managers/stream.d.ts +0 -1
- package/dist/services/core/managers/stream.js +0 -1
- package/dist/services/index.d.ts +0 -1
- package/dist/services/index.js +0 -1
- package/dist/services/mcp/index.d.ts +0 -1
- package/dist/services/mcp/index.js +0 -1
- package/dist/services/mcp/service.d.ts +0 -1
- package/dist/services/mcp/service.js +0 -1
- package/dist/transport/index.d.ts +0 -1
- package/dist/transport/index.js +0 -1
- package/dist/transport/rpc/parser.d.ts +0 -1
- package/dist/transport/rpc/parser.js +0 -1
- package/dist/transport/rpc/rpc-client.d.ts +0 -1
- package/dist/transport/rpc/rpc-client.js +0 -1
- package/dist/transport/streaming/event-stream.d.ts +0 -1
- package/dist/transport/streaming/event-stream.js +0 -1
- package/dist/transport/trpc/a2a/factory/index.d.ts +0 -1
- package/dist/transport/trpc/a2a/factory/index.js +0 -1
- package/dist/transport/trpc/a2a/factory/router.d.ts +0 -1
- package/dist/transport/trpc/a2a/factory/router.js +0 -1
- package/dist/transport/trpc/a2a/index.d.ts +0 -1
- package/dist/transport/trpc/a2a/index.js +0 -1
- package/dist/transport/trpc/a2a/routes/index.d.ts +0 -1
- package/dist/transport/trpc/a2a/routes/index.js +0 -1
- package/dist/transport/trpc/a2a/routes/info.d.ts +0 -1
- package/dist/transport/trpc/a2a/routes/info.js +0 -1
- package/dist/transport/trpc/a2a/routes/message/index.d.ts +0 -1
- package/dist/transport/trpc/a2a/routes/message/index.js +0 -1
- package/dist/transport/trpc/a2a/routes/message/route.d.ts +0 -1
- package/dist/transport/trpc/a2a/routes/message/route.js +0 -1
- package/dist/transport/trpc/a2a/routes/tasks/index.d.ts +0 -1
- package/dist/transport/trpc/a2a/routes/tasks/index.js +0 -1
- package/dist/transport/trpc/a2a/routes/tasks/route.d.ts +0 -1
- package/dist/transport/trpc/a2a/routes/tasks/route.js +0 -1
- package/dist/transport/trpc/a2a/trpc.d.ts +0 -1
- package/dist/transport/trpc/a2a/trpc.js +0 -1
- package/dist/transport/trpc/index.d.ts +0 -1
- package/dist/transport/trpc/index.js +0 -1
- package/dist/types/ext.d.ts +0 -1
- package/dist/types/ext.js +0 -1
- package/dist/types/index.d.ts +0 -1
- package/dist/types/index.js +0 -1
- package/dist/types/interfaces/client.d.ts +2 -3
- package/dist/types/interfaces/client.js +0 -1
- package/dist/types/interfaces/index.d.ts +0 -1
- package/dist/types/interfaces/index.js +0 -1
- package/dist/types/interfaces/services/a2a/builder.d.ts +0 -1
- package/dist/types/interfaces/services/a2a/builder.js +0 -1
- package/dist/types/interfaces/services/a2a/context.d.ts +0 -1
- package/dist/types/interfaces/services/a2a/context.js +0 -1
- package/dist/types/interfaces/services/a2a/engine.d.ts +0 -1
- package/dist/types/interfaces/services/a2a/engine.js +0 -1
- package/dist/types/interfaces/services/a2a/index.d.ts +0 -1
- package/dist/types/interfaces/services/a2a/index.js +0 -1
- package/dist/types/interfaces/services/a2a/legacy.d.ts +0 -1
- package/dist/types/interfaces/services/a2a/legacy.js +0 -1
- package/dist/types/interfaces/services/a2a/service.d.ts +0 -1
- package/dist/types/interfaces/services/a2a/service.js +0 -1
- package/dist/types/interfaces/services/core/context/command.d.ts +0 -1
- package/dist/types/interfaces/services/core/context/command.js +0 -1
- package/dist/types/interfaces/services/core/context/context.d.ts +0 -1
- package/dist/types/interfaces/services/core/context/context.js +0 -1
- package/dist/types/interfaces/services/core/context/index.d.ts +0 -1
- package/dist/types/interfaces/services/core/context/index.js +0 -1
- package/dist/types/interfaces/services/core/context/types.d.ts +0 -1
- package/dist/types/interfaces/services/core/context/types.js +0 -1
- package/dist/types/interfaces/services/core/execution/engine.d.ts +0 -1
- package/dist/types/interfaces/services/core/execution/engine.js +0 -1
- package/dist/types/interfaces/services/core/execution/environment.d.ts +0 -1
- package/dist/types/interfaces/services/core/execution/environment.js +0 -1
- package/dist/types/interfaces/services/core/execution/execute.d.ts +0 -1
- package/dist/types/interfaces/services/core/execution/execute.js +0 -1
- package/dist/types/interfaces/services/core/execution/index.d.ts +0 -1
- package/dist/types/interfaces/services/core/execution/index.js +0 -1
- package/dist/types/interfaces/services/core/index.d.ts +0 -1
- package/dist/types/interfaces/services/core/index.js +0 -1
- package/dist/types/interfaces/services/core/managers/cancellation.d.ts +0 -1
- package/dist/types/interfaces/services/core/managers/cancellation.js +0 -1
- package/dist/types/interfaces/services/core/managers/connection.d.ts +0 -1
- package/dist/types/interfaces/services/core/managers/connection.js +0 -1
- package/dist/types/interfaces/services/core/managers/context.d.ts +0 -1
- package/dist/types/interfaces/services/core/managers/context.js +0 -1
- package/dist/types/interfaces/services/core/managers/event.d.ts +0 -1
- package/dist/types/interfaces/services/core/managers/event.js +0 -1
- package/dist/types/interfaces/services/core/managers/index.d.ts +0 -1
- package/dist/types/interfaces/services/core/managers/index.js +0 -1
- package/dist/types/interfaces/services/core/managers/stream.d.ts +0 -1
- package/dist/types/interfaces/services/core/managers/stream.js +0 -1
- package/dist/types/interfaces/services/core/managers/task.d.ts +0 -1
- package/dist/types/interfaces/services/core/managers/task.js +0 -1
- package/dist/types/interfaces/services/core/service.d.ts +0 -1
- package/dist/types/interfaces/services/core/service.js +0 -1
- package/dist/types/interfaces/services/index.d.ts +0 -1
- package/dist/types/interfaces/services/index.js +0 -1
- package/dist/types/interfaces/services/mcp/index.d.ts +0 -1
- package/dist/types/interfaces/services/mcp/index.js +0 -1
- package/dist/types/interfaces/services/mcp/service.d.ts +0 -1
- package/dist/types/interfaces/services/mcp/service.js +0 -1
- package/dist/types/interfaces/services/protocol.d.ts +0 -1
- package/dist/types/interfaces/services/protocol.js +0 -1
- package/dist/types/interfaces/storage.d.ts +0 -1
- package/dist/types/interfaces/storage.js +0 -1
- package/dist/types/schemas/a2a/agent.d.ts +0 -1
- package/dist/types/schemas/a2a/agent.js +0 -1
- package/dist/types/schemas/a2a/auth.d.ts +0 -1
- package/dist/types/schemas/a2a/auth.js +0 -1
- package/dist/types/schemas/a2a/error.d.ts +0 -1
- package/dist/types/schemas/a2a/error.js +0 -1
- package/dist/types/schemas/a2a/index.d.ts +0 -1
- package/dist/types/schemas/a2a/index.js +0 -1
- package/dist/types/schemas/a2a/kind.d.ts +0 -1
- package/dist/types/schemas/a2a/kind.js +0 -1
- package/dist/types/schemas/a2a/message.d.ts +0 -1
- package/dist/types/schemas/a2a/message.js +0 -1
- package/dist/types/schemas/a2a/notification.d.ts +0 -1
- package/dist/types/schemas/a2a/notification.js +0 -1
- package/dist/types/schemas/a2a/parameters.d.ts +0 -1
- package/dist/types/schemas/a2a/parameters.js +0 -1
- package/dist/types/schemas/a2a/protocol.d.ts +0 -1
- package/dist/types/schemas/a2a/protocol.js +0 -1
- package/dist/types/schemas/a2a/rpc.d.ts +0 -1
- package/dist/types/schemas/a2a/rpc.js +0 -1
- package/dist/types/schemas/a2a/task.d.ts +0 -1
- package/dist/types/schemas/a2a/task.js +0 -1
- package/dist/types/schemas/a2a/transport.d.ts +0 -1
- package/dist/types/schemas/a2a/transport.js +0 -1
- package/dist/types/schemas/index.d.ts +0 -1
- package/dist/types/schemas/index.js +0 -1
- package/dist/types/utils/index.d.ts +0 -1
- package/dist/types/utils/index.js +0 -1
- package/dist/types/utils/transform.d.ts +0 -1
- package/dist/types/utils/transform.js +0 -1
- package/dist/utils/common/constants.d.ts +6 -5
- package/dist/utils/common/constants.js +15 -27
- package/dist/utils/common/errors.d.ts +0 -1
- package/dist/utils/common/errors.js +0 -1
- package/dist/utils/common/utils.d.ts +0 -1
- package/dist/utils/common/utils.js +0 -1
- package/dist/utils/common/zAsyncIterable-v3.d.ts +0 -1
- package/dist/utils/common/zAsyncIterable-v3.js +0 -1
- package/dist/utils/common/zAsyncIterable.d.ts +0 -1
- package/dist/utils/common/zAsyncIterable.js +0 -1
- package/dist/utils/index.d.ts +0 -1
- package/dist/utils/index.js +0 -1
- package/dist/utils/logging/index.d.ts +0 -1
- package/dist/utils/logging/index.js +0 -1
- package/dist/utils/logging/log.d.ts +0 -1
- package/dist/utils/logging/log.js +0 -1
- package/dist/utils/logging/logger.d.ts +0 -1
- package/dist/utils/logging/logger.js +0 -1
- package/dist/utils/storage/file.d.ts +0 -1
- package/dist/utils/storage/file.js +0 -1
- package/dist/utils/storage/memory.d.ts +0 -1
- package/dist/utils/storage/memory.js +0 -1
- package/package.json +3 -2
- package/dist/client/a2a-client.d.ts.map +0 -1
- package/dist/client/a2a-client.js.map +0 -1
- package/dist/client/index.d.ts.map +0 -1
- package/dist/client/index.js.map +0 -1
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js.map +0 -1
- package/dist/server/express/errors.d.ts.map +0 -1
- package/dist/server/express/errors.js.map +0 -1
- package/dist/server/express/index.d.ts.map +0 -1
- package/dist/server/express/index.js.map +0 -1
- package/dist/server/express/middeware.d.ts.map +0 -1
- package/dist/server/express/middeware.js.map +0 -1
- package/dist/server/express/server.d.ts.map +0 -1
- package/dist/server/express/server.js.map +0 -1
- package/dist/server/index.d.ts.map +0 -1
- package/dist/server/index.js.map +0 -1
- package/dist/services/a2a/factory/builder.d.ts.map +0 -1
- package/dist/services/a2a/factory/builder.js.map +0 -1
- package/dist/services/a2a/factory/context.d.ts.map +0 -1
- package/dist/services/a2a/factory/context.js.map +0 -1
- package/dist/services/a2a/factory/event.d.ts.map +0 -1
- package/dist/services/a2a/factory/event.js.map +0 -1
- package/dist/services/a2a/factory/index.d.ts.map +0 -1
- package/dist/services/a2a/factory/index.js.map +0 -1
- package/dist/services/a2a/factory/method.d.ts.map +0 -1
- package/dist/services/a2a/factory/method.js.map +0 -1
- package/dist/services/a2a/factory/service.d.ts.map +0 -1
- package/dist/services/a2a/factory/service.js.map +0 -1
- package/dist/services/a2a/helpers/content.d.ts.map +0 -1
- package/dist/services/a2a/helpers/content.js.map +0 -1
- package/dist/services/a2a/helpers/index.d.ts.map +0 -1
- package/dist/services/a2a/helpers/index.js.map +0 -1
- package/dist/services/a2a/helpers/part.d.ts.map +0 -1
- package/dist/services/a2a/helpers/part.js.map +0 -1
- package/dist/services/a2a/index.d.ts.map +0 -1
- package/dist/services/a2a/index.js.map +0 -1
- package/dist/services/a2a/managers/cancellation.d.ts.map +0 -1
- package/dist/services/a2a/managers/cancellation.js.map +0 -1
- package/dist/services/a2a/managers/connection.d.ts.map +0 -1
- package/dist/services/a2a/managers/connection.js.map +0 -1
- package/dist/services/a2a/managers/context.d.ts.map +0 -1
- package/dist/services/a2a/managers/context.js.map +0 -1
- package/dist/services/a2a/managers/index.d.ts.map +0 -1
- package/dist/services/a2a/managers/index.js.map +0 -1
- package/dist/services/a2a/managers/task.d.ts.map +0 -1
- package/dist/services/a2a/managers/task.js.map +0 -1
- package/dist/services/a2a/methods/cancel-task.d.ts.map +0 -1
- package/dist/services/a2a/methods/cancel-task.js.map +0 -1
- package/dist/services/a2a/methods/get-task.d.ts.map +0 -1
- package/dist/services/a2a/methods/get-task.js.map +0 -1
- package/dist/services/a2a/methods/index.d.ts.map +0 -1
- package/dist/services/a2a/methods/index.js.map +0 -1
- package/dist/services/a2a/methods/resubscribe-task.d.ts.map +0 -1
- package/dist/services/a2a/methods/resubscribe-task.js.map +0 -1
- package/dist/services/a2a/methods/send-message.d.ts.map +0 -1
- package/dist/services/a2a/methods/send-message.js.map +0 -1
- package/dist/services/a2a/methods/stream-message.d.ts.map +0 -1
- package/dist/services/a2a/methods/stream-message.js.map +0 -1
- package/dist/services/a2a/service.d.ts.map +0 -1
- package/dist/services/a2a/service.js.map +0 -1
- package/dist/services/a2a/state/index.d.ts.map +0 -1
- package/dist/services/a2a/state/index.js.map +0 -1
- package/dist/services/a2a/state/load.d.ts.map +0 -1
- package/dist/services/a2a/state/load.js.map +0 -1
- package/dist/services/a2a/state/process.d.ts.map +0 -1
- package/dist/services/a2a/state/process.js.map +0 -1
- package/dist/services/a2a/state/update/artifact.d.ts.map +0 -1
- package/dist/services/a2a/state/update/artifact.js.map +0 -1
- package/dist/services/a2a/state/update/index.d.ts.map +0 -1
- package/dist/services/a2a/state/update/index.js.map +0 -1
- package/dist/services/a2a/state/update/update.d.ts.map +0 -1
- package/dist/services/a2a/state/update/update.js.map +0 -1
- package/dist/services/core/execution/execute.d.ts.map +0 -1
- package/dist/services/core/execution/execute.js.map +0 -1
- package/dist/services/core/execution/index.d.ts.map +0 -1
- package/dist/services/core/execution/index.js.map +0 -1
- package/dist/services/core/index.d.ts.map +0 -1
- package/dist/services/core/index.js.map +0 -1
- package/dist/services/core/managers/command.d.ts.map +0 -1
- package/dist/services/core/managers/command.js.map +0 -1
- package/dist/services/core/managers/event.d.ts.map +0 -1
- package/dist/services/core/managers/event.js.map +0 -1
- package/dist/services/core/managers/index.d.ts.map +0 -1
- package/dist/services/core/managers/index.js.map +0 -1
- package/dist/services/core/managers/stream.d.ts.map +0 -1
- package/dist/services/core/managers/stream.js.map +0 -1
- package/dist/services/index.d.ts.map +0 -1
- package/dist/services/index.js.map +0 -1
- package/dist/services/mcp/index.d.ts.map +0 -1
- package/dist/services/mcp/index.js.map +0 -1
- package/dist/services/mcp/service.d.ts.map +0 -1
- package/dist/services/mcp/service.js.map +0 -1
- package/dist/transport/index.d.ts.map +0 -1
- package/dist/transport/index.js.map +0 -1
- package/dist/transport/rpc/parser.d.ts.map +0 -1
- package/dist/transport/rpc/parser.js.map +0 -1
- package/dist/transport/rpc/rpc-client.d.ts.map +0 -1
- package/dist/transport/rpc/rpc-client.js.map +0 -1
- package/dist/transport/streaming/event-stream.d.ts.map +0 -1
- package/dist/transport/streaming/event-stream.js.map +0 -1
- package/dist/transport/trpc/a2a/factory/index.d.ts.map +0 -1
- package/dist/transport/trpc/a2a/factory/index.js.map +0 -1
- package/dist/transport/trpc/a2a/factory/router.d.ts.map +0 -1
- package/dist/transport/trpc/a2a/factory/router.js.map +0 -1
- package/dist/transport/trpc/a2a/index.d.ts.map +0 -1
- package/dist/transport/trpc/a2a/index.js.map +0 -1
- package/dist/transport/trpc/a2a/routes/index.d.ts.map +0 -1
- package/dist/transport/trpc/a2a/routes/index.js.map +0 -1
- package/dist/transport/trpc/a2a/routes/info.d.ts.map +0 -1
- package/dist/transport/trpc/a2a/routes/info.js.map +0 -1
- package/dist/transport/trpc/a2a/routes/message/index.d.ts.map +0 -1
- package/dist/transport/trpc/a2a/routes/message/index.js.map +0 -1
- package/dist/transport/trpc/a2a/routes/message/route.d.ts.map +0 -1
- package/dist/transport/trpc/a2a/routes/message/route.js.map +0 -1
- package/dist/transport/trpc/a2a/routes/tasks/index.d.ts.map +0 -1
- package/dist/transport/trpc/a2a/routes/tasks/index.js.map +0 -1
- package/dist/transport/trpc/a2a/routes/tasks/route.d.ts.map +0 -1
- package/dist/transport/trpc/a2a/routes/tasks/route.js.map +0 -1
- package/dist/transport/trpc/a2a/trpc.d.ts.map +0 -1
- package/dist/transport/trpc/a2a/trpc.js.map +0 -1
- package/dist/transport/trpc/index.d.ts.map +0 -1
- package/dist/transport/trpc/index.js.map +0 -1
- package/dist/types/ext.d.ts.map +0 -1
- package/dist/types/ext.js.map +0 -1
- package/dist/types/index.d.ts.map +0 -1
- package/dist/types/index.js.map +0 -1
- package/dist/types/interfaces/client.d.ts.map +0 -1
- package/dist/types/interfaces/client.js.map +0 -1
- package/dist/types/interfaces/index.d.ts.map +0 -1
- package/dist/types/interfaces/index.js.map +0 -1
- package/dist/types/interfaces/services/a2a/builder.d.ts.map +0 -1
- package/dist/types/interfaces/services/a2a/builder.js.map +0 -1
- package/dist/types/interfaces/services/a2a/context.d.ts.map +0 -1
- package/dist/types/interfaces/services/a2a/context.js.map +0 -1
- package/dist/types/interfaces/services/a2a/engine.d.ts.map +0 -1
- package/dist/types/interfaces/services/a2a/engine.js.map +0 -1
- package/dist/types/interfaces/services/a2a/index.d.ts.map +0 -1
- package/dist/types/interfaces/services/a2a/index.js.map +0 -1
- package/dist/types/interfaces/services/a2a/legacy.d.ts.map +0 -1
- package/dist/types/interfaces/services/a2a/legacy.js.map +0 -1
- package/dist/types/interfaces/services/a2a/service.d.ts.map +0 -1
- package/dist/types/interfaces/services/a2a/service.js.map +0 -1
- package/dist/types/interfaces/services/core/context/command.d.ts.map +0 -1
- package/dist/types/interfaces/services/core/context/command.js.map +0 -1
- package/dist/types/interfaces/services/core/context/context.d.ts.map +0 -1
- package/dist/types/interfaces/services/core/context/context.js.map +0 -1
- package/dist/types/interfaces/services/core/context/index.d.ts.map +0 -1
- package/dist/types/interfaces/services/core/context/index.js.map +0 -1
- package/dist/types/interfaces/services/core/context/types.d.ts.map +0 -1
- package/dist/types/interfaces/services/core/context/types.js.map +0 -1
- package/dist/types/interfaces/services/core/execution/engine.d.ts.map +0 -1
- package/dist/types/interfaces/services/core/execution/engine.js.map +0 -1
- package/dist/types/interfaces/services/core/execution/environment.d.ts.map +0 -1
- package/dist/types/interfaces/services/core/execution/environment.js.map +0 -1
- package/dist/types/interfaces/services/core/execution/execute.d.ts.map +0 -1
- package/dist/types/interfaces/services/core/execution/execute.js.map +0 -1
- package/dist/types/interfaces/services/core/execution/index.d.ts.map +0 -1
- package/dist/types/interfaces/services/core/execution/index.js.map +0 -1
- package/dist/types/interfaces/services/core/index.d.ts.map +0 -1
- package/dist/types/interfaces/services/core/index.js.map +0 -1
- package/dist/types/interfaces/services/core/managers/cancellation.d.ts.map +0 -1
- package/dist/types/interfaces/services/core/managers/cancellation.js.map +0 -1
- package/dist/types/interfaces/services/core/managers/connection.d.ts.map +0 -1
- package/dist/types/interfaces/services/core/managers/connection.js.map +0 -1
- package/dist/types/interfaces/services/core/managers/context.d.ts.map +0 -1
- package/dist/types/interfaces/services/core/managers/context.js.map +0 -1
- package/dist/types/interfaces/services/core/managers/event.d.ts.map +0 -1
- package/dist/types/interfaces/services/core/managers/event.js.map +0 -1
- package/dist/types/interfaces/services/core/managers/index.d.ts.map +0 -1
- package/dist/types/interfaces/services/core/managers/index.js.map +0 -1
- package/dist/types/interfaces/services/core/managers/stream.d.ts.map +0 -1
- package/dist/types/interfaces/services/core/managers/stream.js.map +0 -1
- package/dist/types/interfaces/services/core/managers/task.d.ts.map +0 -1
- package/dist/types/interfaces/services/core/managers/task.js.map +0 -1
- package/dist/types/interfaces/services/core/service.d.ts.map +0 -1
- package/dist/types/interfaces/services/core/service.js.map +0 -1
- package/dist/types/interfaces/services/index.d.ts.map +0 -1
- package/dist/types/interfaces/services/index.js.map +0 -1
- package/dist/types/interfaces/services/mcp/index.d.ts.map +0 -1
- package/dist/types/interfaces/services/mcp/index.js.map +0 -1
- package/dist/types/interfaces/services/mcp/service.d.ts.map +0 -1
- package/dist/types/interfaces/services/mcp/service.js.map +0 -1
- package/dist/types/interfaces/services/protocol.d.ts.map +0 -1
- package/dist/types/interfaces/services/protocol.js.map +0 -1
- package/dist/types/interfaces/storage.d.ts.map +0 -1
- package/dist/types/interfaces/storage.js.map +0 -1
- package/dist/types/schemas/a2a/agent.d.ts.map +0 -1
- package/dist/types/schemas/a2a/agent.js.map +0 -1
- package/dist/types/schemas/a2a/auth.d.ts.map +0 -1
- package/dist/types/schemas/a2a/auth.js.map +0 -1
- package/dist/types/schemas/a2a/error.d.ts.map +0 -1
- package/dist/types/schemas/a2a/error.js.map +0 -1
- package/dist/types/schemas/a2a/index.d.ts.map +0 -1
- package/dist/types/schemas/a2a/index.js.map +0 -1
- package/dist/types/schemas/a2a/kind.d.ts.map +0 -1
- package/dist/types/schemas/a2a/kind.js.map +0 -1
- package/dist/types/schemas/a2a/message.d.ts.map +0 -1
- package/dist/types/schemas/a2a/message.js.map +0 -1
- package/dist/types/schemas/a2a/notification.d.ts.map +0 -1
- package/dist/types/schemas/a2a/notification.js.map +0 -1
- package/dist/types/schemas/a2a/parameters.d.ts.map +0 -1
- package/dist/types/schemas/a2a/parameters.js.map +0 -1
- package/dist/types/schemas/a2a/protocol.d.ts.map +0 -1
- package/dist/types/schemas/a2a/protocol.js.map +0 -1
- package/dist/types/schemas/a2a/rpc.d.ts.map +0 -1
- package/dist/types/schemas/a2a/rpc.js.map +0 -1
- package/dist/types/schemas/a2a/task.d.ts.map +0 -1
- package/dist/types/schemas/a2a/task.js.map +0 -1
- package/dist/types/schemas/a2a/transport.d.ts.map +0 -1
- package/dist/types/schemas/a2a/transport.js.map +0 -1
- package/dist/types/schemas/index.d.ts.map +0 -1
- package/dist/types/schemas/index.js.map +0 -1
- package/dist/types/utils/index.d.ts.map +0 -1
- package/dist/types/utils/index.js.map +0 -1
- package/dist/types/utils/transform.d.ts.map +0 -1
- package/dist/types/utils/transform.js.map +0 -1
- package/dist/utils/common/constants.d.ts.map +0 -1
- package/dist/utils/common/constants.js.map +0 -1
- package/dist/utils/common/errors.d.ts.map +0 -1
- package/dist/utils/common/errors.js.map +0 -1
- package/dist/utils/common/utils.d.ts.map +0 -1
- package/dist/utils/common/utils.js.map +0 -1
- package/dist/utils/common/zAsyncIterable-v3.d.ts.map +0 -1
- package/dist/utils/common/zAsyncIterable-v3.js.map +0 -1
- package/dist/utils/common/zAsyncIterable.d.ts.map +0 -1
- package/dist/utils/common/zAsyncIterable.js.map +0 -1
- package/dist/utils/index.d.ts.map +0 -1
- package/dist/utils/index.js.map +0 -1
- package/dist/utils/logging/index.d.ts.map +0 -1
- package/dist/utils/logging/index.js.map +0 -1
- package/dist/utils/logging/log.d.ts.map +0 -1
- package/dist/utils/logging/log.js.map +0 -1
- package/dist/utils/logging/logger.d.ts.map +0 -1
- package/dist/utils/logging/logger.js.map +0 -1
- package/dist/utils/storage/file.d.ts.map +0 -1
- package/dist/utils/storage/file.js.map +0 -1
- package/dist/utils/storage/memory.d.ts.map +0 -1
- package/dist/utils/storage/memory.js.map +0 -1
package/README.md
CHANGED
|
@@ -6,13 +6,17 @@
|
|
|
6
6
|
[](https://github.com/the-artinet-project/artinet-sdk/stargazers)
|
|
7
7
|
[](https://discord.gg/DaxzSchmmX)
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
# artinet-sdk
|
|
10
10
|
|
|
11
|
-
|
|
11
|
+
Give your AI agent the power to communicate with any other agent, no matter the framework.
|
|
12
12
|
|
|
13
|
-
The artinet
|
|
13
|
+
The artinet-sdk is a TypeScript library that adds a standardized, interoperable communication layer to your agents.
|
|
14
14
|
|
|
15
|
-
|
|
15
|
+
## Features
|
|
16
|
+
|
|
17
|
+
- **Easy To Use:** The AgentBuilder lets you quickly create an Agent2Agent API, while handling all of the communication complexity.
|
|
18
|
+
- **No Vendor Lock-In:** Create agents that can communicate with other agents across frameworks and ecosystems with just a few lines of code.
|
|
19
|
+
- **Flexible Design:** Everything you need to build collaborative agents while remaining modular enough for advanced configuration.
|
|
16
20
|
|
|
17
21
|
## Quick Start
|
|
18
22
|
|
|
@@ -26,10 +30,10 @@ It has [serveral template projects](https://github.com/the-artinet-project/creat
|
|
|
26
30
|
|
|
27
31
|
## Table of Contents
|
|
28
32
|
|
|
29
|
-
- [artinet
|
|
33
|
+
- [artinet-sdk](#artinet-sdk)
|
|
34
|
+
- [Features](#features)
|
|
30
35
|
- [Quick Start](#quick-start)
|
|
31
36
|
- [Table of Contents](#table-of-contents)
|
|
32
|
-
- [Features](#features)
|
|
33
37
|
- [Installation](#installation)
|
|
34
38
|
- [Requirements](#requirements)
|
|
35
39
|
- [Example](#example)
|
|
@@ -62,14 +66,9 @@ It has [serveral template projects](https://github.com/the-artinet-project/creat
|
|
|
62
66
|
- AgentBuilder now prefers the contextId & taskId from the calling context.
|
|
63
67
|
- In a future release the following packages will be set as peer dependancies to reduce the size of the build: `@modelcontextprotocol/sdk`, `@trpc/server`, `cors`, `express`
|
|
64
68
|
- The `history` object from `TaskAndHistory` is deprecated and no longer being updated. Use `Task.history` instead.
|
|
65
|
-
- The A2AClient now checks `/.well-known/agent-card.json` as a opposed to `/.well-known/agent.json` in-line with the A2A spec.
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
- **Modular Design:** Everything you need to get started building collaborative agents while remaining flexible enough for advanced configuration.
|
|
70
|
-
- **Express Style Agent API:** Similar to scaffolding an Express Server, you can use the AgentBuilder to create an Agent2Agent API.
|
|
71
|
-
- Then wrap it in an actual Express Server with the `createAgentServer()` function. It handles all of the transport-layer complexity, adds A2A <-> JSON-RPC middleware, and manages Server-Sent Events (SSE) automatically.
|
|
72
|
-
- **Protocol Compliance:** Implements the complete A2A specification (v0.3.0) with support for any kind of transport layer (tRPC, WebSockets, etc).
|
|
69
|
+
- The `A2AClient` now checks `/.well-known/agent-card.json` as a opposed to `/.well-known/agent.json` in-line with the A2A spec.
|
|
70
|
+
- The `A2AClient` now uses uses the `AgentCard`.url if an `AgentCard` has been successfully retrieved, else it will default to the `baseUrl`.
|
|
71
|
+
- The examples folder will be removed in favor of [`create-agent`](https://github.com/the-artinet-project/create-agent).
|
|
73
72
|
|
|
74
73
|
## Installation
|
|
75
74
|
|
|
@@ -98,36 +97,29 @@ A basic A2A server and client interaction (For simple agents see the [AgentBuild
|
|
|
98
97
|
import {
|
|
99
98
|
createAgentServer,
|
|
100
99
|
AgentBuilder,
|
|
101
|
-
|
|
100
|
+
Task
|
|
102
101
|
} from "@artinet/sdk";
|
|
103
102
|
|
|
104
|
-
//
|
|
105
|
-
const
|
|
103
|
+
// Create an agent server
|
|
104
|
+
const { app, agent } = createAgentServer({
|
|
105
|
+
agent: AgentBuilder()
|
|
106
106
|
.text(async ({ content: userInput, context }) => {
|
|
107
|
-
const task:
|
|
107
|
+
const task: Task = context.State().task;
|
|
108
108
|
...
|
|
109
109
|
return `You said: ${userInput}`;
|
|
110
110
|
})
|
|
111
|
-
.
|
|
112
|
-
|
|
113
|
-
// Create an agent server
|
|
114
|
-
const { app, agent } = createAgentServer({
|
|
115
|
-
agent: {
|
|
116
|
-
engine: quickAgentEngine,
|
|
111
|
+
.createAgent({
|
|
117
112
|
agentCard: {
|
|
118
113
|
name: "QuickStart Agent",
|
|
114
|
+
description: "A simple agent that echoes the user's message",
|
|
119
115
|
url: "http://localhost:4000/a2a",
|
|
120
116
|
version: "0.1.0",
|
|
121
117
|
capabilities: { streaming: true },
|
|
122
118
|
skills: [{ id: "echo", name: "Echo Skill" }],
|
|
123
119
|
...
|
|
124
120
|
},
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
},
|
|
128
|
-
basePath: "/a2a",
|
|
129
|
-
agentCardPath: "/.well-known/agent-card.json"
|
|
130
|
-
...
|
|
121
|
+
}),
|
|
122
|
+
basePath: "/a2a"
|
|
131
123
|
});
|
|
132
124
|
|
|
133
125
|
app.listen(4000, () => {
|
|
@@ -143,15 +135,7 @@ import { A2AClient, TaskStatusUpdateEvent } from "@artinet/sdk";
|
|
|
143
135
|
async function runClient() {
|
|
144
136
|
const client = new A2AClient("http://localhost:4000/a2a");
|
|
145
137
|
|
|
146
|
-
|
|
147
|
-
messageId: "test-message-id",
|
|
148
|
-
kind: "message",
|
|
149
|
-
role: "user",
|
|
150
|
-
parts: [{ kind: "text", text: "Hello World!" }],
|
|
151
|
-
...
|
|
152
|
-
};
|
|
153
|
-
|
|
154
|
-
const stream = client.sendStreamingMessage({ message });
|
|
138
|
+
const stream = client.sendStreamingMessage("Hello World!");
|
|
155
139
|
|
|
156
140
|
for await (const update of stream) {
|
|
157
141
|
// process the updates
|
|
@@ -180,26 +164,16 @@ Interact with A2A-compliant agents using the `A2AClient`. See `examples/` for mo
|
|
|
180
164
|
Send a message using `message/send`.
|
|
181
165
|
|
|
182
166
|
```typescript
|
|
183
|
-
import { A2AClient,
|
|
167
|
+
import { A2AClient, Task } from "@artinet/sdk";
|
|
184
168
|
|
|
185
|
-
|
|
186
|
-
const client = new A2AClient("https://your-a2a-server.com/a2a");
|
|
187
|
-
const message: Message = {
|
|
188
|
-
messageId: "test-message",
|
|
189
|
-
kind: "message",
|
|
190
|
-
role: "user",
|
|
191
|
-
parts: [{ kind: "text", text: "What is the capital of France?" }],
|
|
192
|
-
...
|
|
193
|
-
};
|
|
169
|
+
const client = new A2AClient("https://your-a2a-server.com/a2a");
|
|
194
170
|
|
|
195
|
-
|
|
196
|
-
console.log("Task Completed:", task);
|
|
197
|
-
}
|
|
171
|
+
const task: Task = await client.sendMessage("What is the capital of France?");
|
|
198
172
|
```
|
|
199
173
|
|
|
200
174
|
#### Streaming Updates
|
|
201
175
|
|
|
202
|
-
Receive real-time updates via SSE using `message/stream
|
|
176
|
+
Receive real-time updates via SSE using `message/stream`.
|
|
203
177
|
|
|
204
178
|
```typescript
|
|
205
179
|
import {
|
|
@@ -211,15 +185,8 @@ import {
|
|
|
211
185
|
|
|
212
186
|
async function runStreamingTask() {
|
|
213
187
|
const client = new A2AClient("https://your-a2a-server.com/a2a");
|
|
214
|
-
const message: Message = {
|
|
215
|
-
role: "user",
|
|
216
|
-
parts: [{ kind: "text", text: "Tell me a short story." }],
|
|
217
|
-
...
|
|
218
|
-
};
|
|
219
188
|
|
|
220
|
-
const stream = client.sendStreamingMessage(
|
|
221
|
-
message,
|
|
222
|
-
});
|
|
189
|
+
const stream = client.sendStreamingMessage("Tell me a short story.");
|
|
223
190
|
|
|
224
191
|
for await (const update of stream) {
|
|
225
192
|
if ((update as TaskStatusUpdateEvent).status) {
|
|
@@ -261,12 +228,12 @@ The SDK provides a variety of options for creating complex ([AgentEngines](#agen
|
|
|
261
228
|
|
|
262
229
|
##### AgentBuilder
|
|
263
230
|
|
|
264
|
-
**Option 1: Using the AgentBuilder (Recommended
|
|
231
|
+
**Option 1: Using the AgentBuilder (Recommended)**
|
|
265
232
|
|
|
266
233
|
For simple agents with one or more processing steps, use the `AgentBuilder` pattern:
|
|
267
234
|
|
|
268
235
|
```typescript
|
|
269
|
-
import { createAgentServer, AgentBuilder
|
|
236
|
+
import { createAgentServer, AgentBuilder } from "@artinet/sdk";
|
|
270
237
|
|
|
271
238
|
//create a simple agent
|
|
272
239
|
const simpleAgent = AgentBuilder().text(() => "hello world!");
|
|
@@ -306,7 +273,6 @@ const { app, agent } = createAgentServer({
|
|
|
306
273
|
capabilities: { streaming: true },
|
|
307
274
|
skills: [{ id: "multi-processor", name: "Multi-Step Processor" }],
|
|
308
275
|
},
|
|
309
|
-
tasks: new TaskManager(),
|
|
310
276
|
}),
|
|
311
277
|
basePath: "/a2a",
|
|
312
278
|
});
|
|
@@ -334,7 +300,6 @@ import {
|
|
|
334
300
|
createAgentServer,
|
|
335
301
|
Context,
|
|
336
302
|
AgentEngine,
|
|
337
|
-
TaskManager,
|
|
338
303
|
} from "@artinet/sdk";
|
|
339
304
|
|
|
340
305
|
const myAgent: AgentEngine = async function* (context: Context) {
|
|
@@ -378,7 +343,6 @@ const { app, agent } = createAgentServer({
|
|
|
378
343
|
skills: [{ id: "processor", name: "Text Processor" }],
|
|
379
344
|
...
|
|
380
345
|
},
|
|
381
|
-
tasks: new TaskManager(),
|
|
382
346
|
},
|
|
383
347
|
basePath: "/a2a",
|
|
384
348
|
agentCardPath: "/.well-known/agent-card.json",
|
|
@@ -435,7 +399,7 @@ const agent = createAgent({
|
|
|
435
399
|
},
|
|
436
400
|
});
|
|
437
401
|
|
|
438
|
-
const
|
|
402
|
+
const resultPromise = agent.sendMessage({
|
|
439
403
|
contextId: "123"
|
|
440
404
|
...
|
|
441
405
|
});
|
|
@@ -448,7 +412,7 @@ currentContext.events.on("complete", () {
|
|
|
448
412
|
//errors thrown here will be triggered in the original context
|
|
449
413
|
});
|
|
450
414
|
|
|
451
|
-
//stream new commands into a running context
|
|
415
|
+
// Advanced: stream new commands into a running context
|
|
452
416
|
(currentContext.command as SendCommandInterface<Command>).send({
|
|
453
417
|
...
|
|
454
418
|
});
|
|
@@ -468,7 +432,7 @@ The EventManager supports the following event types:
|
|
|
468
432
|
|
|
469
433
|
#### Persistent Storage
|
|
470
434
|
|
|
471
|
-
For storage, use our
|
|
435
|
+
For Task storage, use one our simple storage providers like `FileStore`. Or implement the `Store` interface to create your own.
|
|
472
436
|
|
|
473
437
|
```typescript
|
|
474
438
|
import path from "path";
|
|
@@ -497,7 +461,7 @@ const { app, agent } = createAgentServer({
|
|
|
497
461
|
|
|
498
462
|
#### Advanced Server Customization
|
|
499
463
|
|
|
500
|
-
Our
|
|
464
|
+
Our architecture provides multiple ways to customize your agent server:
|
|
501
465
|
|
|
502
466
|
**1. Using `createAgentServer`:**
|
|
503
467
|
Easily spin up an A2A Express app `createAgentServer()`:
|
|
@@ -525,12 +489,12 @@ app.use("/custom", (req, res, next) => {
|
|
|
525
489
|
|
|
526
490
|
```
|
|
527
491
|
|
|
528
|
-
**2.
|
|
492
|
+
**2. Using our JSON-RPC Middleware:**
|
|
529
493
|
Directly import our preconfigured JSON-RPC middleware:
|
|
530
494
|
|
|
531
495
|
```typescript
|
|
532
496
|
import express from "express";
|
|
533
|
-
import { createAgent, jsonRPCMiddleware, errorHandler
|
|
497
|
+
import { createAgent, jsonRPCMiddleware, errorHandler } from "@artinet/sdk";
|
|
534
498
|
|
|
535
499
|
const customApp = express();
|
|
536
500
|
|
|
@@ -539,14 +503,13 @@ const agent = createAgent({
|
|
|
539
503
|
agentCard: {
|
|
540
504
|
...
|
|
541
505
|
},
|
|
542
|
-
tasks: new InMemoryTaskStore(),
|
|
543
506
|
});
|
|
544
507
|
|
|
545
508
|
customApp.use("/auth", yourAuthMiddleware);
|
|
546
509
|
customApp.use("/metrics", yourMetricsMiddleware);
|
|
547
510
|
customApp.use(express.json());
|
|
548
511
|
|
|
549
|
-
// Add
|
|
512
|
+
// Add A2A middleware
|
|
550
513
|
customApp.post("/", async (req, res, next) => {
|
|
551
514
|
return await jsonRPCMiddleware(agent, req, res, next);
|
|
552
515
|
});
|
|
@@ -565,6 +528,7 @@ const server = customApp.listen(3000, () => {
|
|
|
565
528
|
```
|
|
566
529
|
|
|
567
530
|
**3. Using Custom Transport Layers:**
|
|
531
|
+
|
|
568
532
|
Use our preconfigured TRPC router, or create your own integration with WebSockets & other protocols:
|
|
569
533
|
|
|
570
534
|
```typescript
|
|
@@ -574,6 +538,7 @@ const agentRouter = createAgentRouter();
|
|
|
574
538
|
```
|
|
575
539
|
|
|
576
540
|
**Use the Agent:**
|
|
541
|
+
|
|
577
542
|
Directly invoke the agent to use it locally:
|
|
578
543
|
|
|
579
544
|
```typescript
|
|
@@ -584,7 +549,6 @@ const agent = createAgent({
|
|
|
584
549
|
agentCard: {
|
|
585
550
|
...
|
|
586
551
|
},
|
|
587
|
-
tasks: new InMemoryTaskStore(),
|
|
588
552
|
});
|
|
589
553
|
|
|
590
554
|
// Wrap these calls in your desired transport logic
|
|
@@ -679,7 +643,7 @@ const result = await client.callTool({
|
|
|
679
643
|
- `cancel-task`: Cancel a running task
|
|
680
644
|
- `agent://card`: Retrieve the AgentCard
|
|
681
645
|
- `send-streaming-message`, `task-resubscribe` & `push-notifications` etc are currently not supported by default.
|
|
682
|
-
|
|
646
|
+
- Leverage the A2A Zod Schemas to manually implement your own tools.
|
|
683
647
|
|
|
684
648
|
## Contributing
|
|
685
649
|
|
|
@@ -694,8 +658,3 @@ This project is licensed under the Apache License 2.0 - see the `LICENSE` file f
|
|
|
694
658
|
## Acknowledgements
|
|
695
659
|
|
|
696
660
|
This SDK builds upon the concepts and specifications of the [Agent2Agent (A2A) Protocol](https://github.com/google-a2a/A2A).
|
|
697
|
-
|
|
698
|
-
Libraries used include:
|
|
699
|
-
|
|
700
|
-
- [Express.js](https://expressjs.com/) for the server framework.
|
|
701
|
-
- [EventSource Parser](https://github.com/rexxars/eventsource-parser) for SSE streaming.
|
|
@@ -13,10 +13,20 @@ export declare class A2AClient implements Client {
|
|
|
13
13
|
private cachedAgentCard;
|
|
14
14
|
private customHeaders;
|
|
15
15
|
private fallbackPath;
|
|
16
|
+
private agentUrl;
|
|
16
17
|
/**
|
|
17
18
|
* Creates a new A2AClient instance.
|
|
18
19
|
* @param baseUrl The base URL for the A2A server.
|
|
19
20
|
* @param headers Optional custom headers to include in all requests.
|
|
21
|
+
* @param fallbackPath Optional fallback path to use if the agent card is not found at the base URL.
|
|
22
|
+
* @example
|
|
23
|
+
* const client = new A2AClient("http://localhost:4000/a2a");
|
|
24
|
+
* const card = await client.agentCard();
|
|
25
|
+
* console.log(card);
|
|
26
|
+
* @example
|
|
27
|
+
* const client = new A2AClient("http://localhost:4000/a2a", {}, "/agent-card");
|
|
28
|
+
* const card = await client.agentCard();
|
|
29
|
+
* console.log(card);
|
|
20
30
|
*/
|
|
21
31
|
constructor(baseUrl: URL | string, headers?: Record<string, string>, fallbackPath?: string);
|
|
22
32
|
/**
|
|
@@ -31,11 +41,11 @@ export declare class A2AClient implements Client {
|
|
|
31
41
|
*/
|
|
32
42
|
refreshAgentCard(): Promise<AgentCard>;
|
|
33
43
|
/**
|
|
34
|
-
* Sends a
|
|
44
|
+
* Sends a Message to an agent server.
|
|
35
45
|
* @param params The parameters for the message/send method.
|
|
36
|
-
* @returns A promise resolving to the
|
|
46
|
+
* @returns A promise resolving to Message/Task response from the agent server or null.
|
|
37
47
|
*/
|
|
38
|
-
sendMessage(params: MessageSendParams): Promise<Message | Task | null>;
|
|
48
|
+
sendMessage(params: MessageSendParams | string): Promise<Message | Task | null>;
|
|
39
49
|
/**
|
|
40
50
|
* @deprecated Use sendMessage instead.
|
|
41
51
|
* Sends a task request to the agent (non-streaming).
|
|
@@ -44,11 +54,11 @@ export declare class A2AClient implements Client {
|
|
|
44
54
|
*/
|
|
45
55
|
sendTask(params: MessageSendParams): Promise<Message | Task | null>;
|
|
46
56
|
/**
|
|
47
|
-
* Sends a
|
|
57
|
+
* Sends a Message and returns a stream of status and artifact updates.
|
|
48
58
|
* @param params Task parameters for the request
|
|
49
|
-
* @returns An AsyncIterable that yields TaskStatusUpdateEvent
|
|
59
|
+
* @returns An AsyncIterable that yields TaskStatusUpdateEvent/TaskArtifactUpdateEvent/Task/Message payloads.
|
|
50
60
|
*/
|
|
51
|
-
sendStreamingMessage(params: MessageSendParams): AsyncIterable<UpdateEvent>;
|
|
61
|
+
sendStreamingMessage(params: MessageSendParams | string): AsyncIterable<UpdateEvent>;
|
|
52
62
|
/**
|
|
53
63
|
* @deprecated Use sendStreamingMessage instead.
|
|
54
64
|
* Sends a task and returns a subscription to status and artifact updates.
|
|
@@ -113,4 +123,3 @@ export declare class A2AClient implements Client {
|
|
|
113
123
|
*/
|
|
114
124
|
clearHeaders(): void;
|
|
115
125
|
}
|
|
116
|
-
//# sourceMappingURL=a2a-client.d.ts.map
|
|
@@ -5,6 +5,7 @@
|
|
|
5
5
|
import { executeJsonRpcRequest, executeGetRequest, executeStreamEvents, } from "../transport/index.js";
|
|
6
6
|
import { INTERNAL_ERROR } from "../utils/index.js";
|
|
7
7
|
import { logError } from "../utils/logging/index.js";
|
|
8
|
+
import { createMessageSendParams } from "../services/a2a/helpers/message-builder.js";
|
|
8
9
|
/**
|
|
9
10
|
* A2AClient is the main client class for interacting with Agent2Agent (A2A) protocol-compliant services.
|
|
10
11
|
* It provides methods for sending tasks, retrieving statuses, canceling operations, and handling streaming responses.
|
|
@@ -14,15 +15,26 @@ export class A2AClient {
|
|
|
14
15
|
cachedAgentCard = null;
|
|
15
16
|
customHeaders = {};
|
|
16
17
|
fallbackPath;
|
|
18
|
+
agentUrl;
|
|
17
19
|
/**
|
|
18
20
|
* Creates a new A2AClient instance.
|
|
19
21
|
* @param baseUrl The base URL for the A2A server.
|
|
20
22
|
* @param headers Optional custom headers to include in all requests.
|
|
23
|
+
* @param fallbackPath Optional fallback path to use if the agent card is not found at the base URL.
|
|
24
|
+
* @example
|
|
25
|
+
* const client = new A2AClient("http://localhost:4000/a2a");
|
|
26
|
+
* const card = await client.agentCard();
|
|
27
|
+
* console.log(card);
|
|
28
|
+
* @example
|
|
29
|
+
* const client = new A2AClient("http://localhost:4000/a2a", {}, "/agent-card");
|
|
30
|
+
* const card = await client.agentCard();
|
|
31
|
+
* console.log(card);
|
|
21
32
|
*/
|
|
22
33
|
constructor(baseUrl, headers = {}, fallbackPath) {
|
|
23
34
|
this.baseUrl = typeof baseUrl === "string" ? new URL(baseUrl) : baseUrl;
|
|
24
35
|
this.customHeaders = headers;
|
|
25
36
|
this.fallbackPath = fallbackPath ?? "/agent-card";
|
|
37
|
+
this.agentUrl = this.baseUrl;
|
|
26
38
|
}
|
|
27
39
|
/**
|
|
28
40
|
* Retrieves the AgentCard from the A2A server.
|
|
@@ -45,7 +57,6 @@ export class A2AClient {
|
|
|
45
57
|
throw new Error("No agent card found");
|
|
46
58
|
}
|
|
47
59
|
this.cachedAgentCard = card;
|
|
48
|
-
return this.cachedAgentCard;
|
|
49
60
|
}
|
|
50
61
|
catch (error) {
|
|
51
62
|
const fallbackUrl = new URL(this.fallbackPath, this.baseUrl);
|
|
@@ -56,13 +67,14 @@ export class A2AClient {
|
|
|
56
67
|
throw new Error("No fallback agent card found");
|
|
57
68
|
}
|
|
58
69
|
this.cachedAgentCard = fallbackCard;
|
|
59
|
-
return this.cachedAgentCard;
|
|
60
70
|
}
|
|
61
71
|
}
|
|
62
72
|
catch (error) {
|
|
63
73
|
logError("A2AClient:agentCard", "Failed to fetch or parse agent card:", error);
|
|
64
74
|
throw INTERNAL_ERROR(`Could not retrieve agent card: ${error instanceof Error ? error.message : String(error)}`);
|
|
65
75
|
}
|
|
76
|
+
this.agentUrl = new URL(this.cachedAgentCard.url, this.baseUrl);
|
|
77
|
+
return this.cachedAgentCard;
|
|
66
78
|
}
|
|
67
79
|
/**
|
|
68
80
|
* Refreshes the cached AgentCard by fetching it again from the server.
|
|
@@ -73,12 +85,12 @@ export class A2AClient {
|
|
|
73
85
|
return this.agentCard();
|
|
74
86
|
}
|
|
75
87
|
/**
|
|
76
|
-
* Sends a
|
|
88
|
+
* Sends a Message to an agent server.
|
|
77
89
|
* @param params The parameters for the message/send method.
|
|
78
|
-
* @returns A promise resolving to the
|
|
90
|
+
* @returns A promise resolving to Message/Task response from the agent server or null.
|
|
79
91
|
*/
|
|
80
92
|
async sendMessage(params) {
|
|
81
|
-
return await executeJsonRpcRequest(this.
|
|
93
|
+
return await executeJsonRpcRequest(this.agentUrl, "message/send", createMessageSendParams(params), this.customHeaders);
|
|
82
94
|
}
|
|
83
95
|
/**
|
|
84
96
|
* @deprecated Use sendMessage instead.
|
|
@@ -90,12 +102,12 @@ export class A2AClient {
|
|
|
90
102
|
return await this.sendMessage(params);
|
|
91
103
|
}
|
|
92
104
|
/**
|
|
93
|
-
* Sends a
|
|
105
|
+
* Sends a Message and returns a stream of status and artifact updates.
|
|
94
106
|
* @param params Task parameters for the request
|
|
95
|
-
* @returns An AsyncIterable that yields TaskStatusUpdateEvent
|
|
107
|
+
* @returns An AsyncIterable that yields TaskStatusUpdateEvent/TaskArtifactUpdateEvent/Task/Message payloads.
|
|
96
108
|
*/
|
|
97
109
|
sendStreamingMessage(params) {
|
|
98
|
-
return executeStreamEvents(this.
|
|
110
|
+
return executeStreamEvents(this.agentUrl, "message/stream", createMessageSendParams(params), this.customHeaders);
|
|
99
111
|
}
|
|
100
112
|
/**
|
|
101
113
|
* @deprecated Use sendStreamingMessage instead.
|
|
@@ -112,7 +124,7 @@ export class A2AClient {
|
|
|
112
124
|
* @returns A promise resolving to the Task object or null.
|
|
113
125
|
*/
|
|
114
126
|
async getTask(params) {
|
|
115
|
-
return await executeJsonRpcRequest(this.
|
|
127
|
+
return await executeJsonRpcRequest(this.agentUrl, "tasks/get", params, this.customHeaders);
|
|
116
128
|
}
|
|
117
129
|
/**
|
|
118
130
|
* Cancels a currently running task.
|
|
@@ -120,7 +132,7 @@ export class A2AClient {
|
|
|
120
132
|
* @returns A promise resolving to the updated Task object (usually canceled state) or null.
|
|
121
133
|
*/
|
|
122
134
|
async cancelTask(params) {
|
|
123
|
-
return await executeJsonRpcRequest(this.
|
|
135
|
+
return await executeJsonRpcRequest(this.agentUrl, "tasks/cancel", params, this.customHeaders);
|
|
124
136
|
}
|
|
125
137
|
/**
|
|
126
138
|
* Sets or updates the push notification config for a task.
|
|
@@ -128,7 +140,7 @@ export class A2AClient {
|
|
|
128
140
|
* @returns A promise resolving to the confirmed TaskPushNotificationConfig or null.
|
|
129
141
|
*/
|
|
130
142
|
async setTaskPushNotification(params) {
|
|
131
|
-
return await executeJsonRpcRequest(this.
|
|
143
|
+
return await executeJsonRpcRequest(this.agentUrl, "tasks/pushNotificationConfig/set", params, this.customHeaders);
|
|
132
144
|
}
|
|
133
145
|
/**
|
|
134
146
|
* Retrieves the currently configured push notification config for a task.
|
|
@@ -136,7 +148,7 @@ export class A2AClient {
|
|
|
136
148
|
* @returns A promise resolving to the TaskPushNotificationConfig or null.
|
|
137
149
|
*/
|
|
138
150
|
async getTaskPushNotification(params) {
|
|
139
|
-
return await executeJsonRpcRequest(this.
|
|
151
|
+
return await executeJsonRpcRequest(this.agentUrl, "tasks/pushNotificationConfig/get", params, this.customHeaders);
|
|
140
152
|
}
|
|
141
153
|
/**
|
|
142
154
|
* Resubscribes to an existing task's update stream.
|
|
@@ -144,7 +156,7 @@ export class A2AClient {
|
|
|
144
156
|
* @returns An AsyncIterable that yields TaskStatusUpdateEvent or TaskArtifactUpdateEvent payloads.
|
|
145
157
|
*/
|
|
146
158
|
resubscribeTask(params) {
|
|
147
|
-
return executeStreamEvents(this.
|
|
159
|
+
return executeStreamEvents(this.agentUrl, "tasks/resubscribe", params, this.customHeaders);
|
|
148
160
|
}
|
|
149
161
|
/**
|
|
150
162
|
* Checks if the server supports a specific capability based on the agent card.
|
|
@@ -202,4 +214,3 @@ export class A2AClient {
|
|
|
202
214
|
this.customHeaders = {};
|
|
203
215
|
}
|
|
204
216
|
}
|
|
205
|
-
//# sourceMappingURL=a2a-client.js.map
|
package/dist/client/index.d.ts
CHANGED
package/dist/client/index.js
CHANGED
package/dist/index.d.ts
CHANGED
package/dist/index.js
CHANGED
|
@@ -5,4 +5,3 @@
|
|
|
5
5
|
import { NextFunction, Request, Response } from "express";
|
|
6
6
|
import { A2AServiceInterface } from "../../types/index.js";
|
|
7
7
|
export declare function jsonRPCMiddleware(service: A2AServiceInterface, req: Request, res: Response, next: NextFunction): Promise<void>;
|
|
8
|
-
//# sourceMappingURL=middeware.d.ts.map
|
|
@@ -68,4 +68,3 @@ export declare function createAgentServer(params: ServerParams & {
|
|
|
68
68
|
}, import("../../types/index.js").TaskAndHistory, import("../../types/index.js").UpdateEvent>;
|
|
69
69
|
};
|
|
70
70
|
export type ExpressAgentServer = ReturnType<typeof createAgentServer>;
|
|
71
|
-
//# sourceMappingURL=server.d.ts.map
|
package/dist/server/index.d.ts
CHANGED
package/dist/server/index.js
CHANGED
|
@@ -130,4 +130,3 @@ export declare function createCommandChannel<TCommand extends Command = Command>
|
|
|
130
130
|
* @since 0.5.6
|
|
131
131
|
*/
|
|
132
132
|
export declare function createContext<TCommand extends Command = Command, TState extends State = State, TUpdate extends Update = Update>(request: TCommand, service: A2AServiceInterface<TCommand, TState, TUpdate>, contextManager: ContextManagerInterface<TCommand, TState, TUpdate>, abortSignal?: AbortSignal, contextId?: string, eventOverrides?: EventManagerOptions<TCommand, TState, TUpdate>): Context<TCommand, TState, TUpdate>;
|
|
133
|
-
//# sourceMappingURL=context.d.ts.map
|
|
@@ -56,4 +56,3 @@ import { Command, State, Update, A2AServiceInterface, EventManagerOptions } from
|
|
|
56
56
|
* @since 0.5.6
|
|
57
57
|
*/
|
|
58
58
|
export declare function createEventManager<TCommand extends Command = Command, TState extends State = State, TUpdate extends Update = Update>(service: A2AServiceInterface<TCommand, TState, TUpdate>, id?: string, eventOverrides?: EventManagerOptions<TCommand, TState, TUpdate>): EventManager<TCommand, TState, TUpdate>;
|
|
59
|
-
//# sourceMappingURL=event.d.ts.map
|
|
@@ -7,4 +7,3 @@ import { A2AService } from "../service.js";
|
|
|
7
7
|
export declare function createService(params: FactoryParams): A2AService;
|
|
8
8
|
export declare const createAgent: typeof createService;
|
|
9
9
|
export type AgentImpl = ReturnType<typeof createAgent>;
|
|
10
|
-
//# sourceMappingURL=service.d.ts.map
|
|
@@ -9,4 +9,3 @@ export function createService(params) {
|
|
|
9
9
|
return new A2AService(params.agentCard, params.engine, params.contexts ?? new ContextManager(), params.connections ?? new ConnectionManager(), params.cancellations ?? new CancellationManager(), params.tasks ?? new TaskManager(), createMethods(params.methods), params.events);
|
|
10
10
|
}
|
|
11
11
|
export const createAgent = createService;
|
|
12
|
-
//# sourceMappingURL=service.js.map
|