@artinet/sdk 0.5.17 → 0.5.18
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 +101 -26
- package/dist/browser/browser.d.ts +9 -0
- package/dist/browser/browser.js +10 -0
- package/dist/browser/client/a2a-client.d.ts +126 -0
- package/dist/browser/client/a2a-client.js +221 -0
- package/dist/browser/client/index.d.ts +1 -0
- package/dist/browser/client/index.js +1 -0
- package/dist/browser/services/a2a/helpers/message-builder.d.ts +12 -0
- package/dist/browser/services/a2a/helpers/message-builder.js +61 -0
- package/dist/browser/transport/rpc/parser.d.ts +15 -0
- package/dist/browser/transport/rpc/parser.js +48 -0
- package/dist/browser/transport/rpc/rpc-client.d.ts +80 -0
- package/dist/browser/transport/rpc/rpc-client.js +189 -0
- package/dist/browser/transport/streaming/event-stream.d.ts +25 -0
- package/dist/browser/transport/streaming/event-stream.js +99 -0
- package/dist/browser/types/ext.d.ts +13 -0
- package/dist/browser/types/ext.js +10 -0
- package/dist/browser/types/index.d.ts +4 -0
- package/dist/browser/types/index.js +4 -0
- package/dist/browser/types/interfaces/client.d.ts +135 -0
- package/dist/browser/types/interfaces/client.js +5 -0
- package/dist/browser/types/interfaces/index.d.ts +3 -0
- package/dist/browser/types/interfaces/index.js +3 -0
- package/dist/browser/types/interfaces/services/a2a/builder.d.ts +37 -0
- package/dist/browser/types/interfaces/services/a2a/builder.js +5 -0
- package/dist/browser/types/interfaces/services/a2a/context.d.ts +162 -0
- package/dist/browser/types/interfaces/services/a2a/context.js +5 -0
- package/dist/browser/types/interfaces/services/a2a/engine.d.ts +7 -0
- package/dist/browser/types/interfaces/services/a2a/engine.js +5 -0
- package/dist/browser/types/interfaces/services/a2a/index.d.ts +5 -0
- package/dist/browser/types/interfaces/services/a2a/index.js +5 -0
- package/dist/browser/types/interfaces/services/a2a/legacy.d.ts +93 -0
- package/dist/browser/types/interfaces/services/a2a/legacy.js +5 -0
- package/dist/browser/types/interfaces/services/a2a/service.d.ts +413 -0
- package/dist/browser/types/interfaces/services/a2a/service.js +5 -0
- package/dist/browser/types/interfaces/services/core/context/command.d.ts +25 -0
- package/dist/browser/types/interfaces/services/core/context/command.js +5 -0
- package/dist/browser/types/interfaces/services/core/context/context.d.ts +207 -0
- package/dist/browser/types/interfaces/services/core/context/context.js +5 -0
- package/dist/browser/types/interfaces/services/core/context/index.d.ts +3 -0
- package/dist/browser/types/interfaces/services/core/context/index.js +3 -0
- package/dist/browser/types/interfaces/services/core/context/types.d.ts +11 -0
- package/dist/browser/types/interfaces/services/core/context/types.js +5 -0
- package/dist/browser/types/interfaces/services/core/execution/engine.d.ts +106 -0
- package/dist/browser/types/interfaces/services/core/execution/engine.js +5 -0
- package/dist/browser/types/interfaces/services/core/execution/environment.d.ts +11 -0
- package/dist/browser/types/interfaces/services/core/execution/environment.js +5 -0
- package/dist/browser/types/interfaces/services/core/execution/execute.d.ts +7 -0
- package/dist/browser/types/interfaces/services/core/execution/execute.js +5 -0
- package/dist/browser/types/interfaces/services/core/execution/index.d.ts +3 -0
- package/dist/browser/types/interfaces/services/core/execution/index.js +3 -0
- package/dist/browser/types/interfaces/services/core/index.d.ts +4 -0
- package/dist/browser/types/interfaces/services/core/index.js +4 -0
- package/dist/browser/types/interfaces/services/core/managers/cancellation.d.ts +9 -0
- package/dist/browser/types/interfaces/services/core/managers/cancellation.js +5 -0
- package/dist/browser/types/interfaces/services/core/managers/connection.d.ts +9 -0
- package/dist/browser/types/interfaces/services/core/managers/connection.js +5 -0
- package/dist/browser/types/interfaces/services/core/managers/context.d.ts +17 -0
- package/dist/browser/types/interfaces/services/core/managers/context.js +5 -0
- package/dist/browser/types/interfaces/services/core/managers/event.d.ts +328 -0
- package/dist/browser/types/interfaces/services/core/managers/event.js +5 -0
- package/dist/browser/types/interfaces/services/core/managers/index.d.ts +6 -0
- package/dist/browser/types/interfaces/services/core/managers/index.js +6 -0
- package/dist/browser/types/interfaces/services/core/managers/stream.d.ts +217 -0
- package/dist/browser/types/interfaces/services/core/managers/stream.js +5 -0
- package/dist/browser/types/interfaces/services/core/managers/task.d.ts +9 -0
- package/dist/browser/types/interfaces/services/core/managers/task.js +1 -0
- package/dist/browser/types/interfaces/services/core/service.d.ts +115 -0
- package/dist/browser/types/interfaces/services/core/service.js +5 -0
- package/dist/browser/types/interfaces/services/index.d.ts +4 -0
- package/dist/browser/types/interfaces/services/index.js +4 -0
- package/dist/browser/types/interfaces/services/mcp/index.d.ts +1 -0
- package/dist/browser/types/interfaces/services/mcp/index.js +1 -0
- package/dist/browser/types/interfaces/services/mcp/service.d.ts +49 -0
- package/dist/browser/types/interfaces/services/mcp/service.js +5 -0
- package/dist/browser/types/interfaces/services/protocol.d.ts +33 -0
- package/dist/browser/types/interfaces/services/protocol.js +34 -0
- package/dist/browser/types/interfaces/storage.d.ts +8 -0
- package/dist/browser/types/interfaces/storage.js +5 -0
- package/dist/browser/types/schemas/a2a/agent.d.ts +2583 -0
- package/dist/browser/types/schemas/a2a/agent.js +323 -0
- package/dist/browser/types/schemas/a2a/auth.d.ts +908 -0
- package/dist/browser/types/schemas/a2a/auth.js +283 -0
- package/dist/browser/types/schemas/a2a/error.d.ts +396 -0
- package/dist/browser/types/schemas/a2a/error.js +163 -0
- package/dist/browser/types/schemas/a2a/index.d.ts +11 -0
- package/dist/browser/types/schemas/a2a/index.js +11 -0
- package/dist/browser/types/schemas/a2a/kind.d.ts +11 -0
- package/dist/browser/types/schemas/a2a/kind.js +20 -0
- package/dist/browser/types/schemas/a2a/message.d.ts +10343 -0
- package/dist/browser/types/schemas/a2a/message.js +130 -0
- package/dist/browser/types/schemas/a2a/notification.d.ts +1517 -0
- package/dist/browser/types/schemas/a2a/notification.js +203 -0
- package/dist/browser/types/schemas/a2a/parameters.d.ts +956 -0
- package/dist/browser/types/schemas/a2a/parameters.js +241 -0
- package/dist/browser/types/schemas/a2a/protocol.d.ts +14363 -0
- package/dist/browser/types/schemas/a2a/protocol.js +59 -0
- package/dist/browser/types/schemas/a2a/rpc.d.ts +182 -0
- package/dist/browser/types/schemas/a2a/rpc.js +126 -0
- package/dist/browser/types/schemas/a2a/task.d.ts +5886 -0
- package/dist/browser/types/schemas/a2a/task.js +134 -0
- package/dist/browser/types/schemas/a2a/transport.d.ts +31 -0
- package/dist/browser/types/schemas/a2a/transport.js +28 -0
- package/dist/browser/types/schemas/index.d.ts +1 -0
- package/dist/browser/types/schemas/index.js +1 -0
- package/dist/browser/types/utils/index.d.ts +1 -0
- package/dist/browser/types/utils/index.js +1 -0
- package/dist/browser/types/utils/transform.d.ts +64 -0
- package/dist/browser/types/utils/transform.js +35 -0
- package/dist/browser/utils/common/constants.d.ts +11 -0
- package/dist/browser/utils/common/constants.js +38 -0
- package/dist/browser/utils/common/errors.d.ts +24 -0
- package/dist/browser/utils/common/errors.js +42 -0
- package/dist/browser/utils/common/utils.d.ts +9 -0
- package/dist/browser/utils/common/utils.js +11 -0
- package/dist/browser/utils/logging/index.d.ts +2 -0
- package/dist/browser/utils/logging/index.js +2 -0
- package/dist/browser/utils/logging/log.d.ts +33 -0
- package/dist/browser/utils/logging/log.js +75 -0
- package/dist/browser/utils/logging/logger.d.ts +18 -0
- package/dist/browser/utils/logging/logger.js +18 -0
- package/dist/client/a2a-client.d.ts +2 -1
- package/dist/client/a2a-client.js +13 -4
- package/dist/server/express/errors.js +1 -1
- package/dist/server/express/middeware.d.ts +2 -2
- package/dist/server/express/middeware.js +26 -6
- package/dist/server/express/server.d.ts +2 -1
- package/dist/server/express/server.js +32 -6
- package/dist/services/a2a/factory/builder.js +6 -1
- package/dist/services/a2a/factory/service.js +1 -1
- package/dist/services/a2a/helpers/agentcard-builder.js +1 -0
- package/dist/services/a2a/helpers/history.d.ts +2 -0
- package/dist/services/a2a/helpers/history.js +3 -0
- package/dist/services/a2a/helpers/index.d.ts +2 -0
- package/dist/services/a2a/helpers/index.js +2 -0
- package/dist/services/a2a/methods/get-task.js +2 -0
- package/dist/services/a2a/methods/send-message.js +18 -1
- package/dist/services/a2a/service.d.ts +2 -1
- package/dist/services/a2a/service.js +20 -6
- package/dist/services/mcp/service.js +0 -1
- package/dist/transport/rpc/parser.js +2 -2
- package/dist/transport/rpc/rpc-client.js +2 -2
- package/dist/types/interfaces/services/a2a/service.d.ts +4 -0
- package/dist/utils/common/constants.js +1 -1
- package/dist/utils/common/errors.d.ts +2 -1
- package/dist/utils/common/errors.js +2 -1
- package/dist/utils/common/schema-validation.d.ts +2 -0
- package/dist/utils/common/schema-validation.js +12 -0
- package/dist/utils/index.d.ts +1 -0
- package/dist/utils/index.js +1 -0
- package/package.json +20 -17
|
@@ -0,0 +1,163 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Copyright 2025 The Artinet Project
|
|
3
|
+
* SPDX-License-Identifier: Apache-2.0
|
|
4
|
+
*/
|
|
5
|
+
import { z } from "zod";
|
|
6
|
+
import { JSONRPCErrorSchema } from "./rpc.js";
|
|
7
|
+
/**
|
|
8
|
+
* @description Error code for JSON Parse Error (-32700). Invalid JSON was received by the server.
|
|
9
|
+
*/
|
|
10
|
+
export const ErrorCodeParseError = -32700;
|
|
11
|
+
export const JSONParseErrorSchema = JSONRPCErrorSchema.extend({
|
|
12
|
+
code: z.literal(ErrorCodeParseError),
|
|
13
|
+
message: z
|
|
14
|
+
.string()
|
|
15
|
+
.describe("The error message.")
|
|
16
|
+
.default("Invalid JSON payload"),
|
|
17
|
+
}).describe("Represents a JSON-RPC error for a JSON parse error.");
|
|
18
|
+
/**
|
|
19
|
+
* @description Error code for Invalid Request (-32600). The JSON sent is not a valid Request object.
|
|
20
|
+
*/
|
|
21
|
+
export const ErrorCodeInvalidRequest = -32600;
|
|
22
|
+
export const InvalidRequestErrorSchema = JSONRPCErrorSchema.extend({
|
|
23
|
+
code: z.literal(ErrorCodeInvalidRequest),
|
|
24
|
+
message: z
|
|
25
|
+
.string()
|
|
26
|
+
.describe("The error message.")
|
|
27
|
+
.default("Request payload validation error"),
|
|
28
|
+
}).describe("Represents a JSON-RPC error for an invalid request.");
|
|
29
|
+
/**
|
|
30
|
+
* @description Error code for Method Not Found (-32601). The method does not exist / is not available.
|
|
31
|
+
*/
|
|
32
|
+
export const ErrorCodeMethodNotFound = -32601;
|
|
33
|
+
export const MethodNotFoundErrorSchema = JSONRPCErrorSchema.extend({
|
|
34
|
+
code: z.literal(ErrorCodeMethodNotFound),
|
|
35
|
+
message: z
|
|
36
|
+
.string()
|
|
37
|
+
.describe("The error message.")
|
|
38
|
+
.default("Method not found"),
|
|
39
|
+
}).describe("Represents a JSON-RPC error for a method not found.");
|
|
40
|
+
/**
|
|
41
|
+
* @description Error code for Invalid Params (-32602). Invalid method parameter(s).
|
|
42
|
+
*/
|
|
43
|
+
export const ErrorCodeInvalidParams = -32602;
|
|
44
|
+
export const InvalidParamsErrorSchema = JSONRPCErrorSchema.extend({
|
|
45
|
+
code: z.literal(ErrorCodeInvalidParams),
|
|
46
|
+
message: z
|
|
47
|
+
.string()
|
|
48
|
+
.describe("The error message.")
|
|
49
|
+
.default("Invalid parameters"),
|
|
50
|
+
}).describe("Represents a JSON-RPC error for invalid parameters.");
|
|
51
|
+
/**
|
|
52
|
+
* @description Error code for Internal Error (-32603). Internal JSON-RPC error.
|
|
53
|
+
*/
|
|
54
|
+
export const ErrorCodeInternalError = -32603;
|
|
55
|
+
export const InternalErrorSchema = JSONRPCErrorSchema.extend({
|
|
56
|
+
code: z.literal(ErrorCodeInternalError),
|
|
57
|
+
message: z.string().describe("The error message.").default("Internal error"),
|
|
58
|
+
}).describe("Represents a JSON-RPC error for an internal error.");
|
|
59
|
+
/**
|
|
60
|
+
* @description Error code for Task Not Found (-32001). The specified task was not found.
|
|
61
|
+
*/
|
|
62
|
+
export const ErrorCodeTaskNotFound = -32001;
|
|
63
|
+
export const TaskNotFoundErrorSchema = JSONRPCErrorSchema.extend({
|
|
64
|
+
code: z.literal(ErrorCodeTaskNotFound),
|
|
65
|
+
message: z.string().describe("The error message.").default("Task not found"),
|
|
66
|
+
}).describe("Represents a JSON-RPC error for a task not found.");
|
|
67
|
+
/**
|
|
68
|
+
* @description Error code for Task Not Cancelable (-32002). The specified task cannot be canceled.
|
|
69
|
+
*/
|
|
70
|
+
export const ErrorCodeTaskNotCancelable = -32002;
|
|
71
|
+
export const TaskNotCancelableErrorSchema = JSONRPCErrorSchema.extend({
|
|
72
|
+
code: z.literal(ErrorCodeTaskNotCancelable),
|
|
73
|
+
message: z
|
|
74
|
+
.string()
|
|
75
|
+
.describe("The error message.")
|
|
76
|
+
.default("Task cannot be canceled"),
|
|
77
|
+
}).describe("Represents a JSON-RPC error for a task not cancelable.");
|
|
78
|
+
/**
|
|
79
|
+
* @description Error code for Push Notification Not Supported (-32003). Push Notifications are not supported for this operation or agent.
|
|
80
|
+
*/
|
|
81
|
+
export const ErrorCodePushNotificationNotSupported = -32003;
|
|
82
|
+
export const PushNotificationNotSupportedErrorSchema = JSONRPCErrorSchema.extend({
|
|
83
|
+
code: z.literal(ErrorCodePushNotificationNotSupported),
|
|
84
|
+
message: z
|
|
85
|
+
.string()
|
|
86
|
+
.describe("The error message.")
|
|
87
|
+
.default("Push Notifications is not supported"),
|
|
88
|
+
}).describe("Represents a JSON-RPC error for push notifications not supported.");
|
|
89
|
+
/**
|
|
90
|
+
* @description Error code for Unsupported Operation (-32004). The requested operation is not supported by the agent.
|
|
91
|
+
*/
|
|
92
|
+
export const ErrorCodeUnsupportedOperation = -32004;
|
|
93
|
+
export const UnsupportedOperationErrorSchema = JSONRPCErrorSchema.extend({
|
|
94
|
+
code: z.literal(ErrorCodeUnsupportedOperation),
|
|
95
|
+
message: z
|
|
96
|
+
.string()
|
|
97
|
+
.describe("The error message.")
|
|
98
|
+
.default("This operation is not supported"),
|
|
99
|
+
}).describe("Represents a JSON-RPC error for an unsupported operation.");
|
|
100
|
+
/**
|
|
101
|
+
* @description Error code for Content Type Not Supported (-32005). The requested content type is not supported by the agent.
|
|
102
|
+
*/
|
|
103
|
+
export const ErrorCodeContentTypeNotSupported = -32005;
|
|
104
|
+
export const ContentTypeNotSupportedErrorSchema = JSONRPCErrorSchema.extend({
|
|
105
|
+
code: z.literal(ErrorCodeContentTypeNotSupported),
|
|
106
|
+
message: z
|
|
107
|
+
.string()
|
|
108
|
+
.describe("The error message.")
|
|
109
|
+
.default("Incompatible content types"),
|
|
110
|
+
}).describe("Represents a JSON-RPC error for a content type not supported.");
|
|
111
|
+
/**
|
|
112
|
+
* @description Error code for Invalid Agent Response (-32006). The agent returned an invalid response for the current method.
|
|
113
|
+
*/
|
|
114
|
+
export const ErrorCodeInvalidAgentResponse = -32006;
|
|
115
|
+
export const InvalidAgentResponseErrorSchema = JSONRPCErrorSchema.extend({
|
|
116
|
+
code: z.literal(ErrorCodeInvalidAgentResponse),
|
|
117
|
+
message: z
|
|
118
|
+
.string()
|
|
119
|
+
.describe("The error message.")
|
|
120
|
+
.default("Invalid agent response"),
|
|
121
|
+
}).describe("Represents a JSON-RPC error for an invalid agent response. This error is returned when the agent returns an invalid response for the current method.");
|
|
122
|
+
/**
|
|
123
|
+
* An A2A-specific error indicating that the agent does not have an Authenticated Extended Card configured
|
|
124
|
+
*/
|
|
125
|
+
export const ErrorCodeAuthenticatedExtendedCardNotConfigured = -32007;
|
|
126
|
+
export const AuthenticatedExtendedCardNotConfiguredErrorSchema = JSONRPCErrorSchema.extend({
|
|
127
|
+
code: z.literal(ErrorCodeAuthenticatedExtendedCardNotConfigured),
|
|
128
|
+
message: z
|
|
129
|
+
.string()
|
|
130
|
+
.describe("The error message.")
|
|
131
|
+
.default("Authenticated Extended Card is not configured."),
|
|
132
|
+
}).describe("Represents a JSON-RPC error for an authenticated extended card not configured.");
|
|
133
|
+
/**
|
|
134
|
+
* Union of all well-known A2A and standard JSON-RPC error codes defined in this schema.
|
|
135
|
+
*/
|
|
136
|
+
export const KnownErrorCodeSchema = z.union([
|
|
137
|
+
z.literal(ErrorCodeParseError),
|
|
138
|
+
z.literal(ErrorCodeInvalidRequest),
|
|
139
|
+
z.literal(ErrorCodeMethodNotFound),
|
|
140
|
+
z.literal(ErrorCodeInvalidParams),
|
|
141
|
+
z.literal(ErrorCodeInternalError),
|
|
142
|
+
z.literal(ErrorCodeTaskNotFound),
|
|
143
|
+
z.literal(ErrorCodeTaskNotCancelable),
|
|
144
|
+
z.literal(ErrorCodePushNotificationNotSupported),
|
|
145
|
+
z.literal(ErrorCodeUnsupportedOperation),
|
|
146
|
+
z.literal(ErrorCodeContentTypeNotSupported),
|
|
147
|
+
z.literal(ErrorCodeInvalidAgentResponse),
|
|
148
|
+
z.literal(ErrorCodeAuthenticatedExtendedCardNotConfigured),
|
|
149
|
+
]);
|
|
150
|
+
export const A2AErrorSchema = z.union([
|
|
151
|
+
JSONParseErrorSchema,
|
|
152
|
+
InvalidRequestErrorSchema,
|
|
153
|
+
MethodNotFoundErrorSchema,
|
|
154
|
+
InvalidParamsErrorSchema,
|
|
155
|
+
InternalErrorSchema,
|
|
156
|
+
TaskNotFoundErrorSchema,
|
|
157
|
+
TaskNotCancelableErrorSchema,
|
|
158
|
+
PushNotificationNotSupportedErrorSchema,
|
|
159
|
+
UnsupportedOperationErrorSchema,
|
|
160
|
+
ContentTypeNotSupportedErrorSchema,
|
|
161
|
+
InvalidAgentResponseErrorSchema,
|
|
162
|
+
AuthenticatedExtendedCardNotConfiguredErrorSchema,
|
|
163
|
+
]);
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
export * from "./kind.js";
|
|
2
|
+
export * from "./auth.js";
|
|
3
|
+
export * from "./error.js";
|
|
4
|
+
export * from "./message.js";
|
|
5
|
+
export * from "./notification.js";
|
|
6
|
+
export * from "./parameters.js";
|
|
7
|
+
export * from "./rpc.js";
|
|
8
|
+
export * from "./task.js";
|
|
9
|
+
export * from "./agent.js";
|
|
10
|
+
export * from "./protocol.js";
|
|
11
|
+
export * from "./transport.js";
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
export * from "./kind.js";
|
|
2
|
+
export * from "./auth.js";
|
|
3
|
+
export * from "./error.js";
|
|
4
|
+
export * from "./message.js";
|
|
5
|
+
export * from "./notification.js";
|
|
6
|
+
export * from "./parameters.js";
|
|
7
|
+
export * from "./rpc.js";
|
|
8
|
+
export * from "./task.js";
|
|
9
|
+
export * from "./agent.js";
|
|
10
|
+
export * from "./protocol.js";
|
|
11
|
+
export * from "./transport.js";
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Copyright 2025 The Artinet Project
|
|
3
|
+
* SPDX-License-Identifier: Apache-2.0
|
|
4
|
+
*/
|
|
5
|
+
import { z } from "zod";
|
|
6
|
+
/**
|
|
7
|
+
* @description Represents the type of event that occurred in the context of a task.
|
|
8
|
+
*/
|
|
9
|
+
export declare const KindSchema: z.ZodEnum<["artifact-update", "data", "file", "message", "status-update", "task", "text"]>;
|
|
10
|
+
export declare const Kind: z.Values<["artifact-update", "data", "file", "message", "status-update", "task", "text"]>;
|
|
11
|
+
export type Kind = z.infer<typeof KindSchema>;
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Copyright 2025 The Artinet Project
|
|
3
|
+
* SPDX-License-Identifier: Apache-2.0
|
|
4
|
+
*/
|
|
5
|
+
import { z } from "zod";
|
|
6
|
+
/**
|
|
7
|
+
* @description Represents the type of event that occurred in the context of a task.
|
|
8
|
+
*/
|
|
9
|
+
export const KindSchema = z
|
|
10
|
+
.enum([
|
|
11
|
+
"artifact-update",
|
|
12
|
+
"data",
|
|
13
|
+
"file",
|
|
14
|
+
"message",
|
|
15
|
+
"status-update",
|
|
16
|
+
"task",
|
|
17
|
+
"text",
|
|
18
|
+
])
|
|
19
|
+
.describe("Represents the type of event that occurred in the context of a task.");
|
|
20
|
+
export const Kind = KindSchema.enum;
|