recoder-a2a-sdk 1.0.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.
Files changed (59) hide show
  1. package/dist/audit-helpers.d.mts +209 -0
  2. package/dist/audit-helpers.d.ts +209 -0
  3. package/dist/audit-helpers.js +905 -0
  4. package/dist/audit-helpers.js.map +1 -0
  5. package/dist/audit-helpers.mjs +34 -0
  6. package/dist/audit-helpers.mjs.map +1 -0
  7. package/dist/chunk-7GY5FFBI.mjs +117 -0
  8. package/dist/chunk-7GY5FFBI.mjs.map +1 -0
  9. package/dist/chunk-AGD6G5N6.mjs +141 -0
  10. package/dist/chunk-AGD6G5N6.mjs.map +1 -0
  11. package/dist/chunk-BWCRJDUB.mjs +357 -0
  12. package/dist/chunk-BWCRJDUB.mjs.map +1 -0
  13. package/dist/chunk-DPFH2JIC.mjs +141 -0
  14. package/dist/chunk-DPFH2JIC.mjs.map +1 -0
  15. package/dist/chunk-EP2GHC3R.mjs +116 -0
  16. package/dist/chunk-EP2GHC3R.mjs.map +1 -0
  17. package/dist/chunk-JOZQDX7A.mjs +359 -0
  18. package/dist/chunk-JOZQDX7A.mjs.map +1 -0
  19. package/dist/chunk-MAA7JZ2Q.mjs +142 -0
  20. package/dist/chunk-MAA7JZ2Q.mjs.map +1 -0
  21. package/dist/chunk-QVOOBAUA.mjs +140 -0
  22. package/dist/chunk-QVOOBAUA.mjs.map +1 -0
  23. package/dist/chunk-T5GUBIFZ.mjs +358 -0
  24. package/dist/chunk-T5GUBIFZ.mjs.map +1 -0
  25. package/dist/chunk-WLNW7Y2H.mjs +636 -0
  26. package/dist/chunk-WLNW7Y2H.mjs.map +1 -0
  27. package/dist/chunk-XSELW6DU.mjs +356 -0
  28. package/dist/chunk-XSELW6DU.mjs.map +1 -0
  29. package/dist/envelope-builders.d.mts +189 -0
  30. package/dist/envelope-builders.d.ts +189 -0
  31. package/dist/envelope-builders.js +652 -0
  32. package/dist/envelope-builders.js.map +1 -0
  33. package/dist/envelope-builders.mjs +20 -0
  34. package/dist/envelope-builders.mjs.map +1 -0
  35. package/dist/error-mapping.d.mts +132 -0
  36. package/dist/error-mapping.d.ts +132 -0
  37. package/dist/error-mapping.js +642 -0
  38. package/dist/error-mapping.js.map +1 -0
  39. package/dist/error-mapping.mjs +16 -0
  40. package/dist/error-mapping.mjs.map +1 -0
  41. package/dist/index.d.mts +7 -0
  42. package/dist/index.d.ts +7 -0
  43. package/dist/index.js +1798 -0
  44. package/dist/index.js.map +1 -0
  45. package/dist/index.mjs +153 -0
  46. package/dist/index.mjs.map +1 -0
  47. package/dist/state-mapping.d.mts +139 -0
  48. package/dist/state-mapping.d.ts +139 -0
  49. package/dist/state-mapping.js +641 -0
  50. package/dist/state-mapping.js.map +1 -0
  51. package/dist/state-mapping.mjs +28 -0
  52. package/dist/state-mapping.mjs.map +1 -0
  53. package/dist/validation.d.mts +117 -0
  54. package/dist/validation.d.ts +117 -0
  55. package/dist/validation.js +850 -0
  56. package/dist/validation.js.map +1 -0
  57. package/dist/validation.mjs +22 -0
  58. package/dist/validation.mjs.map +1 -0
  59. package/package.json +18 -0
@@ -0,0 +1,642 @@
1
+ "use strict";
2
+ var __defProp = Object.defineProperty;
3
+ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
4
+ var __getOwnPropNames = Object.getOwnPropertyNames;
5
+ var __hasOwnProp = Object.prototype.hasOwnProperty;
6
+ var __export = (target, all) => {
7
+ for (var name in all)
8
+ __defProp(target, name, { get: all[name], enumerable: true });
9
+ };
10
+ var __copyProps = (to, from, except, desc) => {
11
+ if (from && typeof from === "object" || typeof from === "function") {
12
+ for (let key of __getOwnPropNames(from))
13
+ if (!__hasOwnProp.call(to, key) && key !== except)
14
+ __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
15
+ }
16
+ return to;
17
+ };
18
+ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
19
+
20
+ // src/error-mapping.ts
21
+ var error_mapping_exports = {};
22
+ __export(error_mapping_exports, {
23
+ mapClaudeError: () => mapClaudeError,
24
+ mapCodexError: () => mapCodexError,
25
+ mapConnectorError: () => mapConnectorError,
26
+ mapHttpError: () => mapHttpError,
27
+ wrapUnknownError: () => wrapUnknownError
28
+ });
29
+ module.exports = __toCommonJS(error_mapping_exports);
30
+
31
+ // ../../shared/src/a2a/schemas/task-envelope.ts
32
+ var TaskStateEnum = {
33
+ /** Task has been created and is awaiting execution. */
34
+ Submitted: "submitted",
35
+ /** Task is actively being processed by the assignee agent. */
36
+ Working: "working",
37
+ /** The assignee needs additional input before it can continue. */
38
+ InputRequired: "input-required",
39
+ /** Task finished successfully. */
40
+ Completed: "completed",
41
+ /** Task terminated with an error. */
42
+ Failed: "failed",
43
+ /** Task was explicitly cancelled by a requester or operator. */
44
+ Cancelled: "cancelled"
45
+ };
46
+ var TASK_STATES = [
47
+ TaskStateEnum.Submitted,
48
+ TaskStateEnum.Working,
49
+ TaskStateEnum.InputRequired,
50
+ TaskStateEnum.Completed,
51
+ TaskStateEnum.Failed,
52
+ TaskStateEnum.Cancelled
53
+ ];
54
+ var TERMINAL_TASK_STATES = /* @__PURE__ */ new Set([
55
+ TaskStateEnum.Completed,
56
+ TaskStateEnum.Failed,
57
+ TaskStateEnum.Cancelled
58
+ ]);
59
+ var ALLOWED_STATE_TRANSITIONS = {
60
+ [TaskStateEnum.Submitted]: [TaskStateEnum.Working, TaskStateEnum.Cancelled, TaskStateEnum.Failed],
61
+ [TaskStateEnum.Working]: [
62
+ TaskStateEnum.Completed,
63
+ TaskStateEnum.Failed,
64
+ TaskStateEnum.Cancelled,
65
+ TaskStateEnum.InputRequired
66
+ ],
67
+ [TaskStateEnum.InputRequired]: [TaskStateEnum.Working, TaskStateEnum.Cancelled, TaskStateEnum.Failed],
68
+ [TaskStateEnum.Completed]: [],
69
+ [TaskStateEnum.Failed]: [],
70
+ [TaskStateEnum.Cancelled]: []
71
+ };
72
+
73
+ // ../../shared/src/a2a/schemas/audit-event.ts
74
+ var AuditEventTypeEnum = {
75
+ // -- task lifecycle ---------------------------------------------------------
76
+ /** A new task was submitted. */
77
+ TaskSubmitted: "task.submitted",
78
+ /** Task execution started. */
79
+ TaskStarted: "task.started",
80
+ /** Task made progress (intermediate update). */
81
+ TaskProgress: "task.progress",
82
+ /** Assignee agent needs additional input. */
83
+ TaskInputRequired: "task.input_required",
84
+ /** Task completed successfully. */
85
+ TaskCompleted: "task.completed",
86
+ /** Task failed with an error. */
87
+ TaskFailed: "task.failed",
88
+ /** Task was cancelled. */
89
+ TaskCancelled: "task.cancelled",
90
+ // -- policy decisions -------------------------------------------------------
91
+ /** A policy check was performed. */
92
+ PolicyChecked: "policy.checked",
93
+ /** A policy action was approved (auto or prompt). */
94
+ PolicyApproved: "policy.approved",
95
+ /** A policy action was denied. */
96
+ PolicyDenied: "policy.denied",
97
+ // -- connector events -------------------------------------------------------
98
+ /** A connector was attached to an agent. */
99
+ ConnectorAttached: "connector.attached",
100
+ /** A connector was detached from an agent. */
101
+ ConnectorDetached: "connector.detached",
102
+ /** A connector emitted a diagnostic or health event. */
103
+ ConnectorHealth: "connector.health",
104
+ /** A connector encountered an error. */
105
+ ConnectorError: "connector.error",
106
+ // -- agent registry ---------------------------------------------------------
107
+ /** An agent was registered. */
108
+ AgentRegistered: "agent.registered",
109
+ /** An agent was unregistered. */
110
+ AgentUnregistered: "agent.unregistered",
111
+ /** An agent's capabilities were updated. */
112
+ AgentUpdated: "agent.updated",
113
+ // -- collaboration ----------------------------------------------------------
114
+ /** A collaboration channel was created. */
115
+ ChannelCreated: "collaboration.channel_created",
116
+ /** A collaboration thread was created. */
117
+ ThreadCreated: "collaboration.thread_created",
118
+ /** A message was sent in a collaboration thread. */
119
+ MessageSent: "collaboration.message_sent",
120
+ // -- system -----------------------------------------------------------------
121
+ /** A system-level configuration change. */
122
+ SystemConfig: "system.config",
123
+ /** A system-level error or warning. */
124
+ SystemError: "system.error"
125
+ };
126
+ var AUDIT_EVENT_TYPES = Object.values(AuditEventTypeEnum);
127
+
128
+ // ../../shared/src/a2a/schemas/error-taxonomy.ts
129
+ var A2AErrorSeverityEnum = {
130
+ /** Low impact -- informational or gracefully handled. */
131
+ Low: "low",
132
+ /** Medium impact -- degraded functionality but system continues. */
133
+ Medium: "medium",
134
+ /** High impact -- a key operation failed and needs attention. */
135
+ High: "high",
136
+ /** Critical -- system stability at risk, immediate action required. */
137
+ Critical: "critical"
138
+ };
139
+ var A2AErrorCategoryEnum = {
140
+ /** Errors in the envelope or message format (validation, parsing). */
141
+ Envelope: "envelope",
142
+ /** Errors in the connector/adapter layer. */
143
+ Connector: "connector",
144
+ /** Errors in the policy/approval plane. */
145
+ Policy: "policy",
146
+ /** Errors in the task orchestration layer. */
147
+ Task: "task",
148
+ /** Errors in the agent registry. */
149
+ Registry: "registry",
150
+ /** Errors in the collaboration service. */
151
+ Collaboration: "collaboration",
152
+ /** Transport/network-level errors. */
153
+ Transport: "transport",
154
+ /** Authentication and authorization errors. */
155
+ Auth: "auth",
156
+ /** Rate-limiting and quota errors. */
157
+ RateLimit: "rate_limit",
158
+ /** Internal / unexpected errors. */
159
+ Internal: "internal"
160
+ };
161
+ var A2AErrorCodeEnum = {
162
+ // -- envelope ---------------------------------------------------------------
163
+ /** The envelope failed structural validation. */
164
+ InvalidEnvelope: "INVALID_ENVELOPE",
165
+ /** The envelope version is unsupported. */
166
+ UnsupportedEnvelopeVersion: "UNSUPPORTED_ENVELOPE_VERSION",
167
+ /** A required field is missing from the envelope. */
168
+ MissingEnvelopeField: "MISSING_ENVELOPE_FIELD",
169
+ /** The payload kind is unknown or malformed. */
170
+ InvalidPayload: "INVALID_PAYLOAD",
171
+ /** Compatibility alias used by older gateway/workspace routes. */
172
+ InvalidParams: "INVALID_ENVELOPE",
173
+ // -- connector --------------------------------------------------------------
174
+ /** No connector is attached for the target agent. */
175
+ ConnectorNotFound: "CONNECTOR_NOT_FOUND",
176
+ /** The connector timed out during task execution. */
177
+ ConnectorTimeout: "CONNECTOR_TIMEOUT",
178
+ /** The connector returned an unexpected error. */
179
+ ConnectorError: "CONNECTOR_ERROR",
180
+ /** The connector is temporarily unavailable. */
181
+ ConnectorUnavailable: "CONNECTOR_UNAVAILABLE",
182
+ /** Protocol mismatch between connector and remote agent. */
183
+ ProtocolMismatch: "PROTOCOL_MISMATCH",
184
+ // -- policy -----------------------------------------------------------------
185
+ /** The policy plane denied the requested action. */
186
+ PolicyDenied: "POLICY_DENIED",
187
+ /** No prompt handler is configured for the policy rule. */
188
+ PolicyHandlerMissing: "POLICY_HANDLER_MISSING",
189
+ /** The policy evaluation timed out. */
190
+ PolicyTimeout: "POLICY_TIMEOUT",
191
+ // -- task -------------------------------------------------------------------
192
+ /** The task was not found. */
193
+ TaskNotFound: "TASK_NOT_FOUND",
194
+ /** An invalid state transition was attempted. */
195
+ InvalidStateTransition: "INVALID_STATE_TRANSITION",
196
+ /** The task has already reached a terminal state. */
197
+ TaskAlreadyTerminal: "TASK_ALREADY_TERMINAL",
198
+ /** The task failed during execution. */
199
+ TaskExecutionFailed: "TASK_EXECUTION_FAILED",
200
+ /** The task was cancelled. */
201
+ TaskCancelled: "TASK_CANCELLED",
202
+ // -- registry ---------------------------------------------------------------
203
+ /** The agent was not found in the registry. */
204
+ AgentNotFound: "AGENT_NOT_FOUND",
205
+ /** The agent is already registered. */
206
+ AgentAlreadyRegistered: "AGENT_ALREADY_REGISTERED",
207
+ /** The agent does not have the requested capability. */
208
+ CapabilityNotFound: "CAPABILITY_NOT_FOUND",
209
+ // -- collaboration ----------------------------------------------------------
210
+ /** The channel was not found. */
211
+ ChannelNotFound: "CHANNEL_NOT_FOUND",
212
+ /** The thread was not found. */
213
+ ThreadNotFound: "THREAD_NOT_FOUND",
214
+ /** The message was not found. */
215
+ MessageNotFound: "MESSAGE_NOT_FOUND",
216
+ /** The sender is not a member of the target channel. */
217
+ NotChannelMember: "NOT_CHANNEL_MEMBER",
218
+ // -- transport --------------------------------------------------------------
219
+ /** A network request failed. */
220
+ NetworkError: "NETWORK_ERROR",
221
+ /** The remote endpoint returned an unexpected status. */
222
+ UnexpectedStatus: "UNEXPECTED_STATUS",
223
+ /** The request or response body could not be parsed. */
224
+ SerializationError: "SERIALIZATION_ERROR",
225
+ // -- auth -------------------------------------------------------------------
226
+ /** Authentication failed (invalid or missing credentials). */
227
+ AuthenticationFailed: "AUTHENTICATION_FAILED",
228
+ /** The caller is not authorized for the requested operation. */
229
+ AuthorizationDenied: "AUTHORIZATION_DENIED",
230
+ /** The access token has expired. */
231
+ TokenExpired: "TOKEN_EXPIRED",
232
+ // -- rate limit -------------------------------------------------------------
233
+ /** The caller has exceeded the rate limit. */
234
+ RateLimitExceeded: "RATE_LIMIT_EXCEEDED",
235
+ /** The caller has exceeded their usage quota. */
236
+ QuotaExceeded: "QUOTA_EXCEEDED",
237
+ // -- internal ---------------------------------------------------------------
238
+ /** An unexpected internal error occurred. */
239
+ InternalError: "INTERNAL_ERROR",
240
+ /** A configuration error was detected. */
241
+ ConfigurationError: "CONFIGURATION_ERROR"
242
+ };
243
+ var A2A_ERROR_CODE_REGISTRY = {
244
+ // envelope
245
+ [A2AErrorCodeEnum.InvalidEnvelope]: {
246
+ code: A2AErrorCodeEnum.InvalidEnvelope,
247
+ category: A2AErrorCategoryEnum.Envelope,
248
+ severity: A2AErrorSeverityEnum.Medium,
249
+ retryable: false,
250
+ description: "The envelope failed structural validation."
251
+ },
252
+ [A2AErrorCodeEnum.UnsupportedEnvelopeVersion]: {
253
+ code: A2AErrorCodeEnum.UnsupportedEnvelopeVersion,
254
+ category: A2AErrorCategoryEnum.Envelope,
255
+ severity: A2AErrorSeverityEnum.Medium,
256
+ retryable: false,
257
+ description: "The envelope version is not supported by this service."
258
+ },
259
+ [A2AErrorCodeEnum.MissingEnvelopeField]: {
260
+ code: A2AErrorCodeEnum.MissingEnvelopeField,
261
+ category: A2AErrorCategoryEnum.Envelope,
262
+ severity: A2AErrorSeverityEnum.Medium,
263
+ retryable: false,
264
+ description: "A required field is missing from the envelope."
265
+ },
266
+ [A2AErrorCodeEnum.InvalidPayload]: {
267
+ code: A2AErrorCodeEnum.InvalidPayload,
268
+ category: A2AErrorCategoryEnum.Envelope,
269
+ severity: A2AErrorSeverityEnum.Medium,
270
+ retryable: false,
271
+ description: "The payload kind is unknown or malformed."
272
+ },
273
+ // connector
274
+ [A2AErrorCodeEnum.ConnectorNotFound]: {
275
+ code: A2AErrorCodeEnum.ConnectorNotFound,
276
+ category: A2AErrorCategoryEnum.Connector,
277
+ severity: A2AErrorSeverityEnum.High,
278
+ retryable: false,
279
+ description: "No connector is attached for the target agent."
280
+ },
281
+ [A2AErrorCodeEnum.ConnectorTimeout]: {
282
+ code: A2AErrorCodeEnum.ConnectorTimeout,
283
+ category: A2AErrorCategoryEnum.Connector,
284
+ severity: A2AErrorSeverityEnum.High,
285
+ retryable: true,
286
+ description: "The connector timed out during task execution."
287
+ },
288
+ [A2AErrorCodeEnum.ConnectorError]: {
289
+ code: A2AErrorCodeEnum.ConnectorError,
290
+ category: A2AErrorCategoryEnum.Connector,
291
+ severity: A2AErrorSeverityEnum.High,
292
+ retryable: true,
293
+ description: "The connector returned an unexpected error."
294
+ },
295
+ [A2AErrorCodeEnum.ConnectorUnavailable]: {
296
+ code: A2AErrorCodeEnum.ConnectorUnavailable,
297
+ category: A2AErrorCategoryEnum.Connector,
298
+ severity: A2AErrorSeverityEnum.High,
299
+ retryable: true,
300
+ description: "The connector is temporarily unavailable."
301
+ },
302
+ [A2AErrorCodeEnum.ProtocolMismatch]: {
303
+ code: A2AErrorCodeEnum.ProtocolMismatch,
304
+ category: A2AErrorCategoryEnum.Connector,
305
+ severity: A2AErrorSeverityEnum.High,
306
+ retryable: false,
307
+ description: "Protocol mismatch between connector and remote agent."
308
+ },
309
+ // policy
310
+ [A2AErrorCodeEnum.PolicyDenied]: {
311
+ code: A2AErrorCodeEnum.PolicyDenied,
312
+ category: A2AErrorCategoryEnum.Policy,
313
+ severity: A2AErrorSeverityEnum.Medium,
314
+ retryable: false,
315
+ description: "The policy plane denied the requested action."
316
+ },
317
+ [A2AErrorCodeEnum.PolicyHandlerMissing]: {
318
+ code: A2AErrorCodeEnum.PolicyHandlerMissing,
319
+ category: A2AErrorCategoryEnum.Policy,
320
+ severity: A2AErrorSeverityEnum.Medium,
321
+ retryable: false,
322
+ description: "No prompt handler is configured for the policy rule."
323
+ },
324
+ [A2AErrorCodeEnum.PolicyTimeout]: {
325
+ code: A2AErrorCodeEnum.PolicyTimeout,
326
+ category: A2AErrorCategoryEnum.Policy,
327
+ severity: A2AErrorSeverityEnum.High,
328
+ retryable: true,
329
+ description: "The policy evaluation timed out."
330
+ },
331
+ // task
332
+ [A2AErrorCodeEnum.TaskNotFound]: {
333
+ code: A2AErrorCodeEnum.TaskNotFound,
334
+ category: A2AErrorCategoryEnum.Task,
335
+ severity: A2AErrorSeverityEnum.Medium,
336
+ retryable: false,
337
+ description: "The task was not found."
338
+ },
339
+ [A2AErrorCodeEnum.InvalidStateTransition]: {
340
+ code: A2AErrorCodeEnum.InvalidStateTransition,
341
+ category: A2AErrorCategoryEnum.Task,
342
+ severity: A2AErrorSeverityEnum.Medium,
343
+ retryable: false,
344
+ description: "An invalid state transition was attempted."
345
+ },
346
+ [A2AErrorCodeEnum.TaskAlreadyTerminal]: {
347
+ code: A2AErrorCodeEnum.TaskAlreadyTerminal,
348
+ category: A2AErrorCategoryEnum.Task,
349
+ severity: A2AErrorSeverityEnum.Low,
350
+ retryable: false,
351
+ description: "The task has already reached a terminal state."
352
+ },
353
+ [A2AErrorCodeEnum.TaskExecutionFailed]: {
354
+ code: A2AErrorCodeEnum.TaskExecutionFailed,
355
+ category: A2AErrorCategoryEnum.Task,
356
+ severity: A2AErrorSeverityEnum.High,
357
+ retryable: true,
358
+ description: "The task failed during execution."
359
+ },
360
+ [A2AErrorCodeEnum.TaskCancelled]: {
361
+ code: A2AErrorCodeEnum.TaskCancelled,
362
+ category: A2AErrorCategoryEnum.Task,
363
+ severity: A2AErrorSeverityEnum.Low,
364
+ retryable: false,
365
+ description: "The task was cancelled."
366
+ },
367
+ // registry
368
+ [A2AErrorCodeEnum.AgentNotFound]: {
369
+ code: A2AErrorCodeEnum.AgentNotFound,
370
+ category: A2AErrorCategoryEnum.Registry,
371
+ severity: A2AErrorSeverityEnum.Medium,
372
+ retryable: false,
373
+ description: "The agent was not found in the registry."
374
+ },
375
+ [A2AErrorCodeEnum.AgentAlreadyRegistered]: {
376
+ code: A2AErrorCodeEnum.AgentAlreadyRegistered,
377
+ category: A2AErrorCategoryEnum.Registry,
378
+ severity: A2AErrorSeverityEnum.Low,
379
+ retryable: false,
380
+ description: "The agent is already registered."
381
+ },
382
+ [A2AErrorCodeEnum.CapabilityNotFound]: {
383
+ code: A2AErrorCodeEnum.CapabilityNotFound,
384
+ category: A2AErrorCategoryEnum.Registry,
385
+ severity: A2AErrorSeverityEnum.Medium,
386
+ retryable: false,
387
+ description: "The agent does not have the requested capability."
388
+ },
389
+ // collaboration
390
+ [A2AErrorCodeEnum.ChannelNotFound]: {
391
+ code: A2AErrorCodeEnum.ChannelNotFound,
392
+ category: A2AErrorCategoryEnum.Collaboration,
393
+ severity: A2AErrorSeverityEnum.Medium,
394
+ retryable: false,
395
+ description: "The channel was not found."
396
+ },
397
+ [A2AErrorCodeEnum.ThreadNotFound]: {
398
+ code: A2AErrorCodeEnum.ThreadNotFound,
399
+ category: A2AErrorCategoryEnum.Collaboration,
400
+ severity: A2AErrorSeverityEnum.Medium,
401
+ retryable: false,
402
+ description: "The thread was not found."
403
+ },
404
+ [A2AErrorCodeEnum.MessageNotFound]: {
405
+ code: A2AErrorCodeEnum.MessageNotFound,
406
+ category: A2AErrorCategoryEnum.Collaboration,
407
+ severity: A2AErrorSeverityEnum.Medium,
408
+ retryable: false,
409
+ description: "The message was not found."
410
+ },
411
+ [A2AErrorCodeEnum.NotChannelMember]: {
412
+ code: A2AErrorCodeEnum.NotChannelMember,
413
+ category: A2AErrorCategoryEnum.Collaboration,
414
+ severity: A2AErrorSeverityEnum.Medium,
415
+ retryable: false,
416
+ description: "The sender is not a member of the target channel."
417
+ },
418
+ // transport
419
+ [A2AErrorCodeEnum.NetworkError]: {
420
+ code: A2AErrorCodeEnum.NetworkError,
421
+ category: A2AErrorCategoryEnum.Transport,
422
+ severity: A2AErrorSeverityEnum.High,
423
+ retryable: true,
424
+ description: "A network request failed."
425
+ },
426
+ [A2AErrorCodeEnum.UnexpectedStatus]: {
427
+ code: A2AErrorCodeEnum.UnexpectedStatus,
428
+ category: A2AErrorCategoryEnum.Transport,
429
+ severity: A2AErrorSeverityEnum.Medium,
430
+ retryable: true,
431
+ description: "The remote endpoint returned an unexpected status."
432
+ },
433
+ [A2AErrorCodeEnum.SerializationError]: {
434
+ code: A2AErrorCodeEnum.SerializationError,
435
+ category: A2AErrorCategoryEnum.Transport,
436
+ severity: A2AErrorSeverityEnum.Medium,
437
+ retryable: false,
438
+ description: "The request or response body could not be parsed."
439
+ },
440
+ // auth
441
+ [A2AErrorCodeEnum.AuthenticationFailed]: {
442
+ code: A2AErrorCodeEnum.AuthenticationFailed,
443
+ category: A2AErrorCategoryEnum.Auth,
444
+ severity: A2AErrorSeverityEnum.High,
445
+ retryable: false,
446
+ description: "Authentication failed (invalid or missing credentials)."
447
+ },
448
+ [A2AErrorCodeEnum.AuthorizationDenied]: {
449
+ code: A2AErrorCodeEnum.AuthorizationDenied,
450
+ category: A2AErrorCategoryEnum.Auth,
451
+ severity: A2AErrorSeverityEnum.Medium,
452
+ retryable: false,
453
+ description: "The caller is not authorized for the requested operation."
454
+ },
455
+ [A2AErrorCodeEnum.TokenExpired]: {
456
+ code: A2AErrorCodeEnum.TokenExpired,
457
+ category: A2AErrorCategoryEnum.Auth,
458
+ severity: A2AErrorSeverityEnum.Medium,
459
+ retryable: true,
460
+ description: "The access token has expired."
461
+ },
462
+ // rate limit
463
+ [A2AErrorCodeEnum.RateLimitExceeded]: {
464
+ code: A2AErrorCodeEnum.RateLimitExceeded,
465
+ category: A2AErrorCategoryEnum.RateLimit,
466
+ severity: A2AErrorSeverityEnum.Medium,
467
+ retryable: true,
468
+ description: "The caller has exceeded the rate limit."
469
+ },
470
+ [A2AErrorCodeEnum.QuotaExceeded]: {
471
+ code: A2AErrorCodeEnum.QuotaExceeded,
472
+ category: A2AErrorCategoryEnum.RateLimit,
473
+ severity: A2AErrorSeverityEnum.Medium,
474
+ retryable: false,
475
+ description: "The caller has exceeded their usage quota."
476
+ },
477
+ // internal
478
+ [A2AErrorCodeEnum.InternalError]: {
479
+ code: A2AErrorCodeEnum.InternalError,
480
+ category: A2AErrorCategoryEnum.Internal,
481
+ severity: A2AErrorSeverityEnum.Critical,
482
+ retryable: false,
483
+ description: "An unexpected internal error occurred."
484
+ },
485
+ [A2AErrorCodeEnum.ConfigurationError]: {
486
+ code: A2AErrorCodeEnum.ConfigurationError,
487
+ category: A2AErrorCategoryEnum.Internal,
488
+ severity: A2AErrorSeverityEnum.High,
489
+ retryable: false,
490
+ description: "A configuration error was detected."
491
+ }
492
+ };
493
+ function buildA2AError(input) {
494
+ const meta = A2A_ERROR_CODE_REGISTRY[input.code];
495
+ return {
496
+ code: input.code,
497
+ category: meta.category,
498
+ message: input.message,
499
+ severity: input.severity ?? meta.severity,
500
+ retryable: input.retryable ?? meta.retryable,
501
+ details: input.details,
502
+ timestamp: input.now ?? (/* @__PURE__ */ new Date()).toISOString(),
503
+ trace_id: input.trace_id
504
+ };
505
+ }
506
+
507
+ // src/error-mapping.ts
508
+ var CODEX_ERROR_MAP = {
509
+ timeout: A2AErrorCodeEnum.ConnectorTimeout,
510
+ rate_limit: A2AErrorCodeEnum.RateLimitExceeded,
511
+ quota_exceeded: A2AErrorCodeEnum.QuotaExceeded,
512
+ auth_error: A2AErrorCodeEnum.AuthenticationFailed,
513
+ connection_error: A2AErrorCodeEnum.NetworkError,
514
+ invalid_request: A2AErrorCodeEnum.InvalidPayload,
515
+ execution_error: A2AErrorCodeEnum.TaskExecutionFailed,
516
+ model_error: A2AErrorCodeEnum.ConnectorError,
517
+ internal_error: A2AErrorCodeEnum.InternalError,
518
+ cancelled: A2AErrorCodeEnum.TaskCancelled
519
+ };
520
+ function mapCodexError(input) {
521
+ const code = CODEX_ERROR_MAP[input.type] ?? A2AErrorCodeEnum.ConnectorError;
522
+ return buildA2AError({
523
+ code,
524
+ message: input.message,
525
+ details: {
526
+ ...input.details,
527
+ connector_platform: "codex",
528
+ original_error_type: input.type,
529
+ ...input.statusCode !== void 0 ? { status_code: input.statusCode } : {}
530
+ },
531
+ trace_id: input.traceId
532
+ });
533
+ }
534
+ var CLAUDE_ERROR_MAP = {
535
+ overloaded: A2AErrorCodeEnum.ConnectorUnavailable,
536
+ rate_limit: A2AErrorCodeEnum.RateLimitExceeded,
537
+ authentication_error: A2AErrorCodeEnum.AuthenticationFailed,
538
+ permission_error: A2AErrorCodeEnum.AuthorizationDenied,
539
+ invalid_request: A2AErrorCodeEnum.InvalidPayload,
540
+ api_error: A2AErrorCodeEnum.ConnectorError,
541
+ timeout: A2AErrorCodeEnum.ConnectorTimeout,
542
+ connection_error: A2AErrorCodeEnum.NetworkError,
543
+ tool_execution_error: A2AErrorCodeEnum.TaskExecutionFailed,
544
+ context_length_exceeded: A2AErrorCodeEnum.QuotaExceeded,
545
+ cancelled: A2AErrorCodeEnum.TaskCancelled,
546
+ aborted: A2AErrorCodeEnum.TaskCancelled
547
+ };
548
+ function mapClaudeError(input) {
549
+ const code = CLAUDE_ERROR_MAP[input.type] ?? A2AErrorCodeEnum.ConnectorError;
550
+ return buildA2AError({
551
+ code,
552
+ message: input.message,
553
+ details: {
554
+ ...input.details,
555
+ connector_platform: "claude_code",
556
+ original_error_type: input.type,
557
+ ...input.statusCode !== void 0 ? { status_code: input.statusCode } : {}
558
+ },
559
+ trace_id: input.traceId
560
+ });
561
+ }
562
+ var HTTP_STATUS_MAP = {
563
+ 400: A2AErrorCodeEnum.InvalidPayload,
564
+ 401: A2AErrorCodeEnum.AuthenticationFailed,
565
+ 403: A2AErrorCodeEnum.AuthorizationDenied,
566
+ 404: A2AErrorCodeEnum.ConnectorNotFound,
567
+ 408: A2AErrorCodeEnum.ConnectorTimeout,
568
+ 409: A2AErrorCodeEnum.InvalidStateTransition,
569
+ 422: A2AErrorCodeEnum.InvalidEnvelope,
570
+ 429: A2AErrorCodeEnum.RateLimitExceeded,
571
+ 500: A2AErrorCodeEnum.InternalError,
572
+ 502: A2AErrorCodeEnum.NetworkError,
573
+ 503: A2AErrorCodeEnum.ConnectorUnavailable,
574
+ 504: A2AErrorCodeEnum.ConnectorTimeout
575
+ };
576
+ function mapHttpError(statusCode, message, options) {
577
+ const code = HTTP_STATUS_MAP[statusCode] ?? A2AErrorCodeEnum.UnexpectedStatus;
578
+ return buildA2AError({
579
+ code,
580
+ message,
581
+ details: {
582
+ ...options?.details,
583
+ http_status: statusCode,
584
+ ...options?.platform ? { connector_platform: options.platform } : {}
585
+ },
586
+ trace_id: options?.traceId
587
+ });
588
+ }
589
+ function mapConnectorError(input) {
590
+ switch (input.platform) {
591
+ case "codex":
592
+ return mapCodexError(input);
593
+ case "claude_code":
594
+ return mapClaudeError(input);
595
+ default:
596
+ if (input.statusCode !== void 0) {
597
+ return mapHttpError(input.statusCode, input.message, {
598
+ traceId: input.traceId,
599
+ details: { ...input.details, original_error_type: input.type },
600
+ platform: input.platform
601
+ });
602
+ }
603
+ return buildA2AError({
604
+ code: A2AErrorCodeEnum.ConnectorError,
605
+ message: input.message,
606
+ details: {
607
+ ...input.details,
608
+ connector_platform: input.platform,
609
+ original_error_type: input.type
610
+ },
611
+ trace_id: input.traceId
612
+ });
613
+ }
614
+ }
615
+ function wrapUnknownError(err, options) {
616
+ const message = err instanceof Error ? err.message : typeof err === "string" ? err : "Unknown error";
617
+ const details = {};
618
+ if (options?.platform) {
619
+ details.connector_platform = options.platform;
620
+ }
621
+ if (err instanceof Error) {
622
+ details.error_name = err.name;
623
+ if (err.stack) {
624
+ details.stack_preview = err.stack.split("\n").slice(0, 3).join("\n");
625
+ }
626
+ }
627
+ return buildA2AError({
628
+ code: A2AErrorCodeEnum.InternalError,
629
+ message,
630
+ details,
631
+ trace_id: options?.traceId
632
+ });
633
+ }
634
+ // Annotate the CommonJS export names for ESM import in node:
635
+ 0 && (module.exports = {
636
+ mapClaudeError,
637
+ mapCodexError,
638
+ mapConnectorError,
639
+ mapHttpError,
640
+ wrapUnknownError
641
+ });
642
+ //# sourceMappingURL=error-mapping.js.map