@groundnuty/macf-channel-server 0.2.28 → 0.2.33

package/dist/a2a-types.d.ts

@@ -0,0 +1,437 @@
+/**
+ * A2A v1.0 protocol types for inbound JSON-RPC `message/send` handling.
+ *
+ * Hand-rolled Zod schemas per A2A v1.0 spec sections:
+ * - § 4.1.1 Task
+ * - § 4.1.2 TaskStatus
+ * - § 4.1.3 TaskState (8-state enum, SCREAMING_SNAKE_CASE)
+ * - § 4.1.4 Message
+ * - § 4.1.5 Part (OneOf semantics: text | file | data; v1.0 dropped the `kind` discriminator per Appendix A.2.1)
+ * - § 9 JSON-RPC Protocol Binding (method `"message/send"`)
+ *
+ * **SDK choice**: continuing hand-rolled (per Phase 1 #370 + #385 decision).
+ * `@a2a-js/sdk` is still v0.3.13 (A2A v0.3 target); v1.0 not released.
+ * Re-evaluate at Phase 3 (outbound A2A) when the bidirectional surface
+ * pushes the build-vs-buy delta further.
+ *
+ * **Verified against spec text**: 2026-05-19 via a2a-protocol.org WebFetch.
+ * Section references in JSDoc above each schema preserve the citation
+ * trail for future re-verification.
+ *
+ * **macf#390 Phase 2a scope**: full 8-state TaskState enum + Message
+ * schema + Part text-variant; happy-path SUBMITTED → WORKING → COMPLETED.
+ * INPUT_REQUIRED / AUTH_REQUIRED transitions + file/data Part variants
+ * declared in types but exercised in Phase 2b.
+ */
+import { z } from 'zod';
+export declare const TaskStateSchema: z.ZodEnum<{
+    TASK_STATE_SUBMITTED: "TASK_STATE_SUBMITTED";
+    TASK_STATE_WORKING: "TASK_STATE_WORKING";
+    TASK_STATE_INPUT_REQUIRED: "TASK_STATE_INPUT_REQUIRED";
+    TASK_STATE_AUTH_REQUIRED: "TASK_STATE_AUTH_REQUIRED";
+    TASK_STATE_COMPLETED: "TASK_STATE_COMPLETED";
+    TASK_STATE_FAILED: "TASK_STATE_FAILED";
+    TASK_STATE_CANCELED: "TASK_STATE_CANCELED";
+    TASK_STATE_REJECTED: "TASK_STATE_REJECTED";
+}>;
+export type TaskState = z.infer<typeof TaskStateSchema>;
+/** Terminal states — no further transitions allowed once entered. */
+export declare const TERMINAL_TASK_STATES: ReadonlySet<TaskState>;
+/** Interrupted states — task pauses awaiting client follow-up via `Message.taskId`. */
+export declare const INTERRUPTED_TASK_STATES: ReadonlySet<TaskState>;
+export declare const RoleSchema: z.ZodEnum<{
+    ROLE_USER: "ROLE_USER";
+    ROLE_AGENT: "ROLE_AGENT";
+}>;
+export type Role = z.infer<typeof RoleSchema>;
+export declare const PartSchema: z.ZodUnion<readonly [z.ZodObject<{
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    filename: z.ZodOptional<z.ZodString>;
+    mediaType: z.ZodOptional<z.ZodString>;
+    text: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    filename: z.ZodOptional<z.ZodString>;
+    mediaType: z.ZodOptional<z.ZodString>;
+    raw: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    filename: z.ZodOptional<z.ZodString>;
+    mediaType: z.ZodOptional<z.ZodString>;
+    url: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    filename: z.ZodOptional<z.ZodString>;
+    mediaType: z.ZodOptional<z.ZodString>;
+    data: z.ZodUnknown;
+}, z.core.$strip>]>;
+export type Part = z.infer<typeof PartSchema>;
+export declare const MessageSchema: z.ZodObject<{
+    messageId: z.ZodString;
+    role: z.ZodEnum<{
+        ROLE_USER: "ROLE_USER";
+        ROLE_AGENT: "ROLE_AGENT";
+    }>;
+    parts: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        filename: z.ZodOptional<z.ZodString>;
+        mediaType: z.ZodOptional<z.ZodString>;
+        text: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        filename: z.ZodOptional<z.ZodString>;
+        mediaType: z.ZodOptional<z.ZodString>;
+        raw: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        filename: z.ZodOptional<z.ZodString>;
+        mediaType: z.ZodOptional<z.ZodString>;
+        url: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        filename: z.ZodOptional<z.ZodString>;
+        mediaType: z.ZodOptional<z.ZodString>;
+        data: z.ZodUnknown;
+    }, z.core.$strip>]>>;
+    contextId: z.ZodOptional<z.ZodString>;
+    taskId: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    extensions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    referenceTaskIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type Message = z.infer<typeof MessageSchema>;
+export declare const TaskStatusSchema: z.ZodObject<{
+    state: z.ZodEnum<{
+        TASK_STATE_SUBMITTED: "TASK_STATE_SUBMITTED";
+        TASK_STATE_WORKING: "TASK_STATE_WORKING";
+        TASK_STATE_INPUT_REQUIRED: "TASK_STATE_INPUT_REQUIRED";
+        TASK_STATE_AUTH_REQUIRED: "TASK_STATE_AUTH_REQUIRED";
+        TASK_STATE_COMPLETED: "TASK_STATE_COMPLETED";
+        TASK_STATE_FAILED: "TASK_STATE_FAILED";
+        TASK_STATE_CANCELED: "TASK_STATE_CANCELED";
+        TASK_STATE_REJECTED: "TASK_STATE_REJECTED";
+    }>;
+    message: z.ZodOptional<z.ZodObject<{
+        messageId: z.ZodString;
+        role: z.ZodEnum<{
+            ROLE_USER: "ROLE_USER";
+            ROLE_AGENT: "ROLE_AGENT";
+        }>;
+        parts: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            filename: z.ZodOptional<z.ZodString>;
+            mediaType: z.ZodOptional<z.ZodString>;
+            text: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            filename: z.ZodOptional<z.ZodString>;
+            mediaType: z.ZodOptional<z.ZodString>;
+            raw: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            filename: z.ZodOptional<z.ZodString>;
+            mediaType: z.ZodOptional<z.ZodString>;
+            url: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            filename: z.ZodOptional<z.ZodString>;
+            mediaType: z.ZodOptional<z.ZodString>;
+            data: z.ZodUnknown;
+        }, z.core.$strip>]>>;
+        contextId: z.ZodOptional<z.ZodString>;
+        taskId: z.ZodOptional<z.ZodString>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        extensions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        referenceTaskIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    timestamp: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type TaskStatus = z.infer<typeof TaskStatusSchema>;
+export declare const TaskSchema: z.ZodObject<{
+    id: z.ZodString;
+    status: z.ZodObject<{
+        state: z.ZodEnum<{
+            TASK_STATE_SUBMITTED: "TASK_STATE_SUBMITTED";
+            TASK_STATE_WORKING: "TASK_STATE_WORKING";
+            TASK_STATE_INPUT_REQUIRED: "TASK_STATE_INPUT_REQUIRED";
+            TASK_STATE_AUTH_REQUIRED: "TASK_STATE_AUTH_REQUIRED";
+            TASK_STATE_COMPLETED: "TASK_STATE_COMPLETED";
+            TASK_STATE_FAILED: "TASK_STATE_FAILED";
+            TASK_STATE_CANCELED: "TASK_STATE_CANCELED";
+            TASK_STATE_REJECTED: "TASK_STATE_REJECTED";
+        }>;
+        message: z.ZodOptional<z.ZodObject<{
+            messageId: z.ZodString;
+            role: z.ZodEnum<{
+                ROLE_USER: "ROLE_USER";
+                ROLE_AGENT: "ROLE_AGENT";
+            }>;
+            parts: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                filename: z.ZodOptional<z.ZodString>;
+                mediaType: z.ZodOptional<z.ZodString>;
+                text: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                filename: z.ZodOptional<z.ZodString>;
+                mediaType: z.ZodOptional<z.ZodString>;
+                raw: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                filename: z.ZodOptional<z.ZodString>;
+                mediaType: z.ZodOptional<z.ZodString>;
+                url: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                filename: z.ZodOptional<z.ZodString>;
+                mediaType: z.ZodOptional<z.ZodString>;
+                data: z.ZodUnknown;
+            }, z.core.$strip>]>>;
+            contextId: z.ZodOptional<z.ZodString>;
+            taskId: z.ZodOptional<z.ZodString>;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            extensions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            referenceTaskIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+        timestamp: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    contextId: z.ZodOptional<z.ZodString>;
+    history: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        messageId: z.ZodString;
+        role: z.ZodEnum<{
+            ROLE_USER: "ROLE_USER";
+            ROLE_AGENT: "ROLE_AGENT";
+        }>;
+        parts: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            filename: z.ZodOptional<z.ZodString>;
+            mediaType: z.ZodOptional<z.ZodString>;
+            text: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            filename: z.ZodOptional<z.ZodString>;
+            mediaType: z.ZodOptional<z.ZodString>;
+            raw: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            filename: z.ZodOptional<z.ZodString>;
+            mediaType: z.ZodOptional<z.ZodString>;
+            url: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            filename: z.ZodOptional<z.ZodString>;
+            mediaType: z.ZodOptional<z.ZodString>;
+            data: z.ZodUnknown;
+        }, z.core.$strip>]>>;
+        contextId: z.ZodOptional<z.ZodString>;
+        taskId: z.ZodOptional<z.ZodString>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        extensions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        referenceTaskIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
+    artifacts: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type Task = z.infer<typeof TaskSchema>;
+/** JSON-RPC 2.0 request envelope. `id` is required for `message/send` (not a notification). */
+export declare const JsonRpcRequestSchema: z.ZodObject<{
+    jsonrpc: z.ZodLiteral<"2.0">;
+    method: z.ZodString;
+    id: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+    params: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;
+export type JsonRpcRequest = z.infer<typeof JsonRpcRequestSchema>;
+/** Params for `message/send` — wraps a Message. */
+export declare const MessageSendParamsSchema: z.ZodObject<{
+    message: z.ZodObject<{
+        messageId: z.ZodString;
+        role: z.ZodEnum<{
+            ROLE_USER: "ROLE_USER";
+            ROLE_AGENT: "ROLE_AGENT";
+        }>;
+        parts: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            filename: z.ZodOptional<z.ZodString>;
+            mediaType: z.ZodOptional<z.ZodString>;
+            text: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            filename: z.ZodOptional<z.ZodString>;
+            mediaType: z.ZodOptional<z.ZodString>;
+            raw: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            filename: z.ZodOptional<z.ZodString>;
+            mediaType: z.ZodOptional<z.ZodString>;
+            url: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            filename: z.ZodOptional<z.ZodString>;
+            mediaType: z.ZodOptional<z.ZodString>;
+            data: z.ZodUnknown;
+        }, z.core.$strip>]>>;
+        contextId: z.ZodOptional<z.ZodString>;
+        taskId: z.ZodOptional<z.ZodString>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        extensions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        referenceTaskIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+    configuration: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type MessageSendParams = z.infer<typeof MessageSendParamsSchema>;
+/** Params for `tasks/get` + `tasks/cancel`. Accepts `{ id }` or proto-canonical `{ name: "tasks/{id}" }`. */
+export declare const TaskIdParamsSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type TaskIdParams = z.infer<typeof TaskIdParamsSchema>;
+/**
+ * Resolve a TaskIdParams to the bare task id. `id` takes precedence
+ * over `name`; if only `name` is present, strip the `tasks/` resource
+ * prefix per the proto canonical mapping. Returns `undefined` if
+ * neither was present (the refine should have rejected, but defensive).
+ */
+export declare function resolveTaskId(params: TaskIdParams): string | undefined;
+/**
+ * JSON-RPC 2.0 success response envelope. `result` for `message/send`
+ * is either a Task or a Message per spec § 9.4.1 — Phase 2a always
+ * returns a Task (synchronous happy-path COMPLETED).
+ */
+export declare const JsonRpcSuccessResponseSchema: z.ZodObject<{
+    jsonrpc: z.ZodLiteral<"2.0">;
+    id: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodNull]>;
+    result: z.ZodObject<{
+        id: z.ZodString;
+        status: z.ZodObject<{
+            state: z.ZodEnum<{
+                TASK_STATE_SUBMITTED: "TASK_STATE_SUBMITTED";
+                TASK_STATE_WORKING: "TASK_STATE_WORKING";
+                TASK_STATE_INPUT_REQUIRED: "TASK_STATE_INPUT_REQUIRED";
+                TASK_STATE_AUTH_REQUIRED: "TASK_STATE_AUTH_REQUIRED";
+                TASK_STATE_COMPLETED: "TASK_STATE_COMPLETED";
+                TASK_STATE_FAILED: "TASK_STATE_FAILED";
+                TASK_STATE_CANCELED: "TASK_STATE_CANCELED";
+                TASK_STATE_REJECTED: "TASK_STATE_REJECTED";
+            }>;
+            message: z.ZodOptional<z.ZodObject<{
+                messageId: z.ZodString;
+                role: z.ZodEnum<{
+                    ROLE_USER: "ROLE_USER";
+                    ROLE_AGENT: "ROLE_AGENT";
+                }>;
+                parts: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    filename: z.ZodOptional<z.ZodString>;
+                    mediaType: z.ZodOptional<z.ZodString>;
+                    text: z.ZodString;
+                }, z.core.$strip>, z.ZodObject<{
+                    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    filename: z.ZodOptional<z.ZodString>;
+                    mediaType: z.ZodOptional<z.ZodString>;
+                    raw: z.ZodString;
+                }, z.core.$strip>, z.ZodObject<{
+                    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    filename: z.ZodOptional<z.ZodString>;
+                    mediaType: z.ZodOptional<z.ZodString>;
+                    url: z.ZodString;
+                }, z.core.$strip>, z.ZodObject<{
+                    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    filename: z.ZodOptional<z.ZodString>;
+                    mediaType: z.ZodOptional<z.ZodString>;
+                    data: z.ZodUnknown;
+                }, z.core.$strip>]>>;
+                contextId: z.ZodOptional<z.ZodString>;
+                taskId: z.ZodOptional<z.ZodString>;
+                metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                extensions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                referenceTaskIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>>;
+            timestamp: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        contextId: z.ZodOptional<z.ZodString>;
+        history: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            messageId: z.ZodString;
+            role: z.ZodEnum<{
+                ROLE_USER: "ROLE_USER";
+                ROLE_AGENT: "ROLE_AGENT";
+            }>;
+            parts: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                filename: z.ZodOptional<z.ZodString>;
+                mediaType: z.ZodOptional<z.ZodString>;
+                text: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                filename: z.ZodOptional<z.ZodString>;
+                mediaType: z.ZodOptional<z.ZodString>;
+                raw: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                filename: z.ZodOptional<z.ZodString>;
+                mediaType: z.ZodOptional<z.ZodString>;
+                url: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                filename: z.ZodOptional<z.ZodString>;
+                mediaType: z.ZodOptional<z.ZodString>;
+                data: z.ZodUnknown;
+            }, z.core.$strip>]>>;
+            contextId: z.ZodOptional<z.ZodString>;
+            taskId: z.ZodOptional<z.ZodString>;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            extensions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            referenceTaskIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>>;
+        artifacts: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type JsonRpcSuccessResponse = z.infer<typeof JsonRpcSuccessResponseSchema>;
+/**
+ * JSON-RPC 2.0 error envelope. Per A2A v1.0 spec § 9 (and v1.0 change
+ * notes), errors use the `google.rpc.Status` representation with
+ * `ErrorInfo` extensions: `reason` in UPPER_SNAKE_CASE + domain
+ * `"a2a-protocol.org"`.
+ *
+ * Standard JSON-RPC `code`/`message` + `data.reason`/`data.domain` for
+ * the A2A-specific reason classification.
+ */
+export declare const JsonRpcErrorResponseSchema: z.ZodObject<{
+    jsonrpc: z.ZodLiteral<"2.0">;
+    id: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodNull]>;
+    error: z.ZodObject<{
+        code: z.ZodNumber;
+        message: z.ZodString;
+        data: z.ZodOptional<z.ZodObject<{
+            reason: z.ZodOptional<z.ZodString>;
+            domain: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type JsonRpcErrorResponse = z.infer<typeof JsonRpcErrorResponseSchema>;
+/** JSON-RPC 2.0 standard error codes. */
+export declare const JSONRPC_PARSE_ERROR = -32700;
+export declare const JSONRPC_INVALID_REQUEST = -32600;
+export declare const JSONRPC_METHOD_NOT_FOUND = -32601;
+export declare const JSONRPC_INVALID_PARAMS = -32602;
+export declare const JSONRPC_INTERNAL_ERROR = -32603;
+/** A2A-specific reason codes (UPPER_SNAKE_CASE per v1.0 § 9 ErrorInfo). */
+export declare const A2A_ERROR_DOMAIN = "a2a-protocol.org";
+export declare const A2A_REASON_INVALID_MESSAGE = "INVALID_MESSAGE";
+export declare const A2A_REASON_TASK_NOT_FOUND = "TASK_NOT_FOUND";
+export declare const A2A_REASON_METHOD_NOT_SUPPORTED = "METHOD_NOT_SUPPORTED";
+/** Resume attempted against a terminal task (COMPLETED/FAILED/CANCELED/REJECTED) — macf#392 Phase 2b. */
+export declare const A2A_REASON_TASK_TERMINAL_STATE = "TASK_TERMINAL_STATE";
+/** Resume attempted with non-resumable from-state (only INPUT_REQUIRED + AUTH_REQUIRED accept resume) — macf#392 Phase 2b. */
+export declare const A2A_REASON_TASK_NOT_RESUMABLE = "TASK_NOT_RESUMABLE";
+/** Canonical JSON-RPC method string for the inbound message exchange (spec § 9 examples). */
+export declare const A2A_METHOD_MESSAGE_SEND = "message/send";
+/** Canonical JSON-RPC method string for task lookup (macf#398 Phase 2d). */
+export declare const A2A_METHOD_TASKS_GET = "tasks/get";
+/** Canonical JSON-RPC method string for task cancellation (macf#398 Phase 2d). */
+export declare const A2A_METHOD_TASKS_CANCEL = "tasks/cancel";
+/** Canonical AgentCard.url path for this server's A2A endpoint. */
+export declare const A2A_ENDPOINT_PATH = "/a2a/v1";
+//# sourceMappingURL=a2a-types.d.ts.map

package/dist/a2a-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2a-types.d.ts","sourceRoot":"","sources":["../src/a2a-types.ts"],"names":[],"mappings":"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"}