@cleocode/lafs-protocol 1.2.3 → 1.3.1

package/README.md

@@ -4,7 +4,7 @@
 
 LAFS defines a standard envelope format for structured responses from LLM-powered agents and tools. It complements transport protocols like [MCP](https://modelcontextprotocol.io/) and [A2A](https://github.com/google/A2A) by standardizing what comes back — not how it gets there.
 
-**Current version:** 1.2.3 | [📚 Documentation](https://codluv.gitbook.io/lafs-protocol/) | [Spec](lafs.md) | [Migration Guides](migrations/)
+**Current version:** 1.3.1 | [📚 Documentation](https://codluv.gitbook.io/lafs-protocol/) | [Spec](lafs.md) | [Migration Guides](migrations/)
 
 [![GitBook](https://img.shields.io/badge/docs-gitbook-blue)](https://codluv.gitbook.io/lafs-protocol/)
 [![npm](https://img.shields.io/npm/v/@cleocode/lafs-protocol)](https://www.npmjs.com/package/@cleocode/lafs-protocol)
@@ -18,7 +18,8 @@ LAFS defines a standard envelope format for structured responses from LLM-powere
 | | `schemas/v1/context-ledger.schema.json` | Context ledger for state tracking across request/response cycles |
 | | `schemas/v1/error-registry.json` | 12 registered error codes with HTTP/gRPC/CLI transport mappings |
 | **Tooling** | `src/` | TypeScript validation, conformance runner, CLI diagnostic tool |
-| **Tests** | `tests/` | 31 tests covering envelope, pagination, strict mode, error handling |
+| **A2A** | `src/a2a/` | Agent-to-Agent integration: extensions, task lifecycle, protocol bindings (JSON-RPC/HTTP/gRPC) |
+| **Tests** | `tests/` | Tests covering envelope, pagination, strict mode, error handling, A2A extensions, task lifecycle, bindings |
 | **Fixtures** | `fixtures/` | 14 JSON fixtures (valid + invalid) for conformance testing |
 | **Docs** | `docs/` | [GitBook documentation](https://codluv.gitbook.io/lafs-protocol/) with guides, SDK reference, and specs |
 
@@ -97,6 +98,47 @@ npm run typecheck
 - **Error registry** — 12 codes with category, retryability, and transport-specific status mappings
 - **Extension mechanism** — `_extensions` field for vendor metadata (`x-` prefix convention)
 - **Adoption tiers** — Core, Standard, Complete with progressive conformance requirements
+- **A2A integration** — Agent Card discovery, extension negotiation, task lifecycle management, protocol bindings
+
+## A2A Integration
+
+LAFS integrates with the [A2A Protocol](https://github.com/google/A2A) via `@a2a-js/sdk`. Import from the `@cleocode/lafs-protocol/a2a` subpath:
+
+```typescript
+import {
+  // Extensions
+  buildLafsExtension,
+  extensionNegotiationMiddleware,
+  LAFS_EXTENSION_URI,
+
+  // Task lifecycle
+  TaskManager,
+  attachLafsEnvelope,
+  isTerminalState,
+
+  // Protocol bindings
+  getErrorCodeMapping,
+  createJsonRpcRequest,
+  createProblemDetails,
+} from "@cleocode/lafs-protocol/a2a";
+```
+
+**Agent Card with LAFS extension** — use `autoIncludeLafsExtension` in discovery config:
+
+```typescript
+import { discoveryMiddleware } from "@cleocode/lafs-protocol/discovery";
+
+app.use(discoveryMiddleware({
+  agent: { name: "my-agent", /* ... */ },
+  autoIncludeLafsExtension: true,
+}));
+```
+
+**Protocol bindings** are also available as a standalone subpath:
+
+```typescript
+import { getErrorCodeMapping } from "@cleocode/lafs-protocol/a2a/bindings";
+```
 
 ## Conformance checks
 
@@ -125,9 +167,19 @@ src/
   conformance.ts                 # Conformance runner (8 checks)
   errorRegistry.ts               # Error code helpers
   flagSemantics.ts               # Format flag resolution
+  discovery.ts                   # A2A Agent Card discovery middleware
   cli.ts                         # CLI diagnostic tool
-tests/                           # 31 tests (vitest)
-fixtures/                        # 14 JSON test fixtures
+  a2a/
+    bridge.ts                    # A2A SDK integration & result wrapper
+    extensions.ts                # Extension negotiation & LAFS extension builder
+    task-lifecycle.ts            # Task state machine & lifecycle management
+    bindings/
+      jsonrpc.ts                 # JSON-RPC 2.0 method/error constants & builders
+      http.ts                    # HTTP endpoints, RFC 9457 Problem Details
+      grpc.ts                    # gRPC status codes & service definitions (types only)
+      index.ts                   # Barrel export & cross-binding error mapping
+tests/                           # Tests (vitest)
+fixtures/                        # JSON test fixtures
 docs/
   POSITIONING.md                 # MCP/A2A complementary positioning
   VISION.md                      # Project vision and primary persona
@@ -142,7 +194,8 @@ CONTRIBUTING.md                  # Contributor guidelines, RFC process
 
 | Version | Phase | Description |
 |---------|-------|-------------|
-| **v1.0.0** | **3** | **Production release: Token budgets, agent discovery, MCP integration, complete SDKs** |
+| **v1.2.3** | **4** | **A2A v1.0+ compliance: extension negotiation, task lifecycle, protocol bindings (JSON-RPC/HTTP/gRPC)** |
+| v1.0.0 | 3 | Production release: Token budgets, agent discovery, MCP integration, complete SDKs |
 | v0.5.0 | 2B | Conditional pagination, MVI field selection/expansion, context ledger schema |
 | v0.4.0 | 2A | Optional page/error, extensions, strict/lenient mode, warnings |
 | v0.3.0 | 1 | Strategic positioning, vision alignment, adoption tiers |

package/dist/examples/discovery-server.js

@@ -146,8 +146,8 @@ app.use(discoveryMiddleware(discoveryConfig));
 app.get("/health", (req, res) => {
     res.json({
         status: "healthy",
-        service: discoveryConfig.service.name,
-        version: discoveryConfig.service.version,
+        service: discoveryConfig.service?.name ?? discoveryConfig.agent?.name,
+        version: discoveryConfig.service?.version ?? discoveryConfig.agent?.version,
         timestamp: new Date().toISOString()
     });
 });
@@ -177,8 +177,8 @@ const server = app.listen(PORT, () => {
 ╔════════════════════════════════════════════════════════╗
 ║     LAFS Discovery Server Running                      ║
 ╠════════════════════════════════════════════════════════╣
-║  Service:    ${discoveryConfig.service.name.padEnd(43)}║
-║  Version:    ${discoveryConfig.service.version.padEnd(43)}║
+║  Service:    ${(discoveryConfig.service?.name ?? discoveryConfig.agent?.name ?? 'unknown').padEnd(43)}║
+║  Version:    ${(discoveryConfig.service?.version ?? discoveryConfig.agent?.version ?? 'unknown').padEnd(43)}║
 ║  Port:       ${String(PORT).padEnd(43)}║
 ╠════════════════════════════════════════════════════════╣
 ║  Endpoints:                                            ║

package/dist/src/a2a/bindings/grpc.d.ts

@@ -0,0 +1,67 @@
+/**
+ * A2A gRPC Protocol Binding
+ *
+ * Status codes, error reasons, service method definitions, and metadata
+ * constants for gRPC transport. Types and helpers only — no @grpc/grpc-js
+ * runtime dependency.
+ *
+ * Reference: A2A spec Section 10.3-10.6
+ */
+import type { A2AErrorType } from './jsonrpc.js';
+/** Standard gRPC status codes (numeric values 0-16) */
+export declare const GRPC_STATUS_CODE: {
+    readonly OK: 0;
+    readonly CANCELLED: 1;
+    readonly UNKNOWN: 2;
+    readonly INVALID_ARGUMENT: 3;
+    readonly DEADLINE_EXCEEDED: 4;
+    readonly NOT_FOUND: 5;
+    readonly ALREADY_EXISTS: 6;
+    readonly PERMISSION_DENIED: 7;
+    readonly RESOURCE_EXHAUSTED: 8;
+    readonly FAILED_PRECONDITION: 9;
+    readonly ABORTED: 10;
+    readonly OUT_OF_RANGE: 11;
+    readonly UNIMPLEMENTED: 12;
+    readonly INTERNAL: 13;
+    readonly UNAVAILABLE: 14;
+    readonly DATA_LOSS: 15;
+    readonly UNAUTHENTICATED: 16;
+};
+export type GrpcStatusCode = (typeof GRPC_STATUS_CODE)[keyof typeof GRPC_STATUS_CODE];
+export type GrpcStatusName = keyof typeof GRPC_STATUS_CODE;
+/** Maps A2A error types to gRPC status names */
+export declare const A2A_GRPC_STATUS_CODES: Record<A2AErrorType, GrpcStatusName>;
+/** UPPER_SNAKE_CASE error reasons without "Error" suffix */
+export declare const A2A_GRPC_ERROR_REASONS: Record<A2AErrorType, string>;
+/** Error domain for A2A gRPC errors */
+export declare const A2A_GRPC_ERROR_DOMAIN: "a2a-protocol.org";
+/** gRPC service method descriptor */
+export interface GrpcServiceMethod {
+    request: string;
+    response: string;
+    streaming: boolean;
+}
+/** gRPC service method definitions for the A2A protocol */
+export declare const GRPC_SERVICE_METHODS: Record<string, GrpcServiceMethod>;
+/** gRPC metadata key for A2A protocol version */
+export declare const GRPC_METADATA_VERSION_KEY: "a2a-version";
+/** gRPC metadata key for activated A2A extensions */
+export declare const GRPC_METADATA_EXTENSIONS_KEY: "a2a-extensions";
+/** gRPC Status object for A2A errors */
+export interface GrpcStatus {
+    code: GrpcStatusCode;
+    message: string;
+    details?: GrpcErrorInfo[];
+}
+/** google.rpc.ErrorInfo equivalent */
+export interface GrpcErrorInfo {
+    reason: string;
+    domain: string;
+    metadata?: Record<string, string>;
+}
+/**
+ * Create a gRPC Status object for an A2A error type.
+ * Includes ErrorInfo details with reason and domain.
+ */
+export declare function createGrpcStatus(errorType: A2AErrorType, message: string, metadata?: Record<string, string>): GrpcStatus;

package/dist/src/a2a/bindings/grpc.js

@@ -0,0 +1,148 @@
+/**
+ * A2A gRPC Protocol Binding
+ *
+ * Status codes, error reasons, service method definitions, and metadata
+ * constants for gRPC transport. Types and helpers only — no @grpc/grpc-js
+ * runtime dependency.
+ *
+ * Reference: A2A spec Section 10.3-10.6
+ */
+// ============================================================================
+// gRPC Status Codes (standard)
+// ============================================================================
+/** Standard gRPC status codes (numeric values 0-16) */
+export const GRPC_STATUS_CODE = {
+    OK: 0,
+    CANCELLED: 1,
+    UNKNOWN: 2,
+    INVALID_ARGUMENT: 3,
+    DEADLINE_EXCEEDED: 4,
+    NOT_FOUND: 5,
+    ALREADY_EXISTS: 6,
+    PERMISSION_DENIED: 7,
+    RESOURCE_EXHAUSTED: 8,
+    FAILED_PRECONDITION: 9,
+    ABORTED: 10,
+    OUT_OF_RANGE: 11,
+    UNIMPLEMENTED: 12,
+    INTERNAL: 13,
+    UNAVAILABLE: 14,
+    DATA_LOSS: 15,
+    UNAUTHENTICATED: 16,
+};
+// ============================================================================
+// A2A gRPC Status Mapping (spec Section 5.4)
+// ============================================================================
+/** Maps A2A error types to gRPC status names */
+export const A2A_GRPC_STATUS_CODES = {
+    TaskNotFound: 'NOT_FOUND',
+    TaskNotCancelable: 'FAILED_PRECONDITION',
+    PushNotificationNotSupported: 'UNIMPLEMENTED',
+    UnsupportedOperation: 'UNIMPLEMENTED',
+    ContentTypeNotSupported: 'INVALID_ARGUMENT',
+    InvalidAgentResponse: 'INTERNAL',
+    AuthenticatedExtendedCardNotConfigured: 'NOT_FOUND',
+    ExtensionSupportRequired: 'FAILED_PRECONDITION',
+    VersionNotSupported: 'FAILED_PRECONDITION',
+};
+// ============================================================================
+// Error Reasons (spec Section 10.6)
+// ============================================================================
+/** UPPER_SNAKE_CASE error reasons without "Error" suffix */
+export const A2A_GRPC_ERROR_REASONS = {
+    TaskNotFound: 'TASK_NOT_FOUND',
+    TaskNotCancelable: 'TASK_NOT_CANCELABLE',
+    PushNotificationNotSupported: 'PUSH_NOTIFICATION_NOT_SUPPORTED',
+    UnsupportedOperation: 'UNSUPPORTED_OPERATION',
+    ContentTypeNotSupported: 'CONTENT_TYPE_NOT_SUPPORTED',
+    InvalidAgentResponse: 'INVALID_AGENT_RESPONSE',
+    AuthenticatedExtendedCardNotConfigured: 'AUTHENTICATED_EXTENDED_CARD_NOT_CONFIGURED',
+    ExtensionSupportRequired: 'EXTENSION_SUPPORT_REQUIRED',
+    VersionNotSupported: 'VERSION_NOT_SUPPORTED',
+};
+/** Error domain for A2A gRPC errors */
+export const A2A_GRPC_ERROR_DOMAIN = 'a2a-protocol.org';
+/** gRPC service method definitions for the A2A protocol */
+export const GRPC_SERVICE_METHODS = {
+    SendMessage: {
+        request: 'MessageSendParams',
+        response: 'SendMessageResponse',
+        streaming: false,
+    },
+    SendStreamingMessage: {
+        request: 'MessageSendParams',
+        response: 'SendStreamingMessageResponse',
+        streaming: true,
+    },
+    GetTask: {
+        request: 'TaskQueryParams',
+        response: 'GetTaskResponse',
+        streaming: false,
+    },
+    ListTasks: {
+        request: 'TaskQueryParams',
+        response: 'ListTasksResponse',
+        streaming: false,
+    },
+    CancelTask: {
+        request: 'TaskIdParams',
+        response: 'CancelTaskResponse',
+        streaming: false,
+    },
+    SubscribeToTask: {
+        request: 'TaskIdParams',
+        response: 'SubscribeToTaskResponse',
+        streaming: true,
+    },
+    SetTaskPushNotificationConfig: {
+        request: 'TaskPushNotificationConfig',
+        response: 'SetTaskPushNotificationConfigResponse',
+        streaming: false,
+    },
+    GetTaskPushNotificationConfig: {
+        request: 'GetTaskPushNotificationConfigParams',
+        response: 'GetTaskPushNotificationConfigResponse',
+        streaming: false,
+    },
+    ListTaskPushNotificationConfig: {
+        request: 'ListTaskPushNotificationConfigParams',
+        response: 'ListTaskPushNotificationConfigResponse',
+        streaming: false,
+    },
+    DeleteTaskPushNotificationConfig: {
+        request: 'DeleteTaskPushNotificationConfigParams',
+        response: 'DeleteTaskPushNotificationConfigResponse',
+        streaming: false,
+    },
+    GetExtendedAgentCard: {
+        request: 'GetAuthenticatedExtendedCardRequest',
+        response: 'GetAuthenticatedExtendedCardResponse',
+        streaming: false,
+    },
+};
+// ============================================================================
+// gRPC Metadata Constants
+// ============================================================================
+/** gRPC metadata key for A2A protocol version */
+export const GRPC_METADATA_VERSION_KEY = 'a2a-version';
+/** gRPC metadata key for activated A2A extensions */
+export const GRPC_METADATA_EXTENSIONS_KEY = 'a2a-extensions';
+/**
+ * Create a gRPC Status object for an A2A error type.
+ * Includes ErrorInfo details with reason and domain.
+ */
+export function createGrpcStatus(errorType, message, metadata) {
+    const statusName = A2A_GRPC_STATUS_CODES[errorType];
+    const code = GRPC_STATUS_CODE[statusName];
+    return {
+        code,
+        message,
+        details: [
+            {
+                reason: A2A_GRPC_ERROR_REASONS[errorType],
+                domain: A2A_GRPC_ERROR_DOMAIN,
+                ...(metadata && { metadata }),
+            },
+        ],
+    };
+}

package/dist/src/a2a/bindings/http.d.ts

@@ -0,0 +1,92 @@
+/**
+ * A2A HTTP Protocol Binding
+ *
+ * HTTP endpoint definitions, status codes, error type URIs,
+ * and RFC 9457 Problem Details support per A2A spec Section 11.3-11.5.
+ */
+import type { A2AErrorType } from './jsonrpc.js';
+/** HTTP+JSON endpoint definitions for each A2A operation */
+export declare const HTTP_ENDPOINTS: {
+    readonly SendMessage: {
+        readonly method: "POST";
+        readonly path: "/message:send";
+    };
+    readonly SendStreamingMessage: {
+        readonly method: "POST";
+        readonly path: "/message:stream";
+    };
+    readonly GetTask: {
+        readonly method: "GET";
+        readonly path: "/tasks/:id";
+    };
+    readonly ListTasks: {
+        readonly method: "GET";
+        readonly path: "/tasks";
+    };
+    readonly CancelTask: {
+        readonly method: "POST";
+        readonly path: "/tasks/:id:cancel";
+    };
+    readonly SubscribeToTask: {
+        readonly method: "GET";
+        readonly path: "/tasks/:id:subscribe";
+    };
+    readonly SetTaskPushNotificationConfig: {
+        readonly method: "POST";
+        readonly path: "/tasks/:id/pushNotificationConfig";
+    };
+    readonly GetTaskPushNotificationConfig: {
+        readonly method: "GET";
+        readonly path: "/tasks/:id/pushNotificationConfig";
+    };
+    readonly ListTaskPushNotificationConfig: {
+        readonly method: "GET";
+        readonly path: "/tasks/:id/pushNotificationConfig:list";
+    };
+    readonly DeleteTaskPushNotificationConfig: {
+        readonly method: "DELETE";
+        readonly path: "/tasks/:id/pushNotificationConfig/:configId";
+    };
+    readonly GetExtendedAgentCard: {
+        readonly method: "GET";
+        readonly path: "/agent/authenticatedExtendedCard";
+    };
+};
+export type HttpEndpoint = (typeof HTTP_ENDPOINTS)[keyof typeof HTTP_ENDPOINTS];
+/** Maps A2A error types to HTTP status codes */
+export declare const A2A_HTTP_STATUS_CODES: Record<A2AErrorType, number>;
+/** RFC 9457 Problem Details type URIs for A2A errors */
+export declare const A2A_ERROR_TYPE_URIS: Record<A2AErrorType, string>;
+/** RFC 9457 Problem Details object */
+export interface ProblemDetails {
+    type: string;
+    title: string;
+    status: number;
+    detail: string;
+    [key: string]: unknown;
+}
+/**
+ * Create an RFC 9457 Problem Details object for an A2A error.
+ * @param errorType - The A2A error type name
+ * @param detail - Human-readable explanation of the error
+ * @param extensions - Additional members to include in the response
+ */
+export declare function createProblemDetails(errorType: A2AErrorType, detail: string, extensions?: Record<string, unknown>): ProblemDetails;
+/**
+ * Build a URL by substituting path parameters.
+ * @param endpoint - HTTP endpoint definition (from HTTP_ENDPOINTS)
+ * @param params - Path parameter values (keys without leading colon)
+ */
+export declare function buildUrl(endpoint: HttpEndpoint, params?: Record<string, string>): string;
+/** Parsed query parameters for ListTasks (spec Section 11.5) */
+export interface ListTasksQueryParams {
+    contextId?: string;
+    state?: string;
+    limit?: number;
+    pageToken?: string;
+}
+/**
+ * Parse camelCase query parameters for the ListTasks endpoint.
+ * Handles type coercion for numeric fields.
+ */
+export declare function parseListTasksQuery(query: Record<string, string | undefined>): ListTasksQueryParams;

package/dist/src/a2a/bindings/http.js

@@ -0,0 +1,99 @@
+/**
+ * A2A HTTP Protocol Binding
+ *
+ * HTTP endpoint definitions, status codes, error type URIs,
+ * and RFC 9457 Problem Details support per A2A spec Section 11.3-11.5.
+ */
+// ============================================================================
+// Endpoint Constants (spec Section 11.3)
+// ============================================================================
+/** HTTP+JSON endpoint definitions for each A2A operation */
+export const HTTP_ENDPOINTS = {
+    SendMessage: { method: 'POST', path: '/message:send' },
+    SendStreamingMessage: { method: 'POST', path: '/message:stream' },
+    GetTask: { method: 'GET', path: '/tasks/:id' },
+    ListTasks: { method: 'GET', path: '/tasks' },
+    CancelTask: { method: 'POST', path: '/tasks/:id:cancel' },
+    SubscribeToTask: { method: 'GET', path: '/tasks/:id:subscribe' },
+    SetTaskPushNotificationConfig: { method: 'POST', path: '/tasks/:id/pushNotificationConfig' },
+    GetTaskPushNotificationConfig: { method: 'GET', path: '/tasks/:id/pushNotificationConfig' },
+    ListTaskPushNotificationConfig: { method: 'GET', path: '/tasks/:id/pushNotificationConfig:list' },
+    DeleteTaskPushNotificationConfig: { method: 'DELETE', path: '/tasks/:id/pushNotificationConfig/:configId' },
+    GetExtendedAgentCard: { method: 'GET', path: '/agent/authenticatedExtendedCard' },
+};
+// ============================================================================
+// HTTP Status Codes (spec Section 5.4)
+// ============================================================================
+/** Maps A2A error types to HTTP status codes */
+export const A2A_HTTP_STATUS_CODES = {
+    TaskNotFound: 404,
+    TaskNotCancelable: 409,
+    PushNotificationNotSupported: 400,
+    UnsupportedOperation: 400,
+    ContentTypeNotSupported: 415,
+    InvalidAgentResponse: 502,
+    AuthenticatedExtendedCardNotConfigured: 404,
+    ExtensionSupportRequired: 400,
+    VersionNotSupported: 400,
+};
+// ============================================================================
+// Error Type URIs (spec Section 5.4)
+// ============================================================================
+/** RFC 9457 Problem Details type URIs for A2A errors */
+export const A2A_ERROR_TYPE_URIS = {
+    TaskNotFound: 'https://a2a-protocol.org/errors/task-not-found',
+    TaskNotCancelable: 'https://a2a-protocol.org/errors/task-not-cancelable',
+    PushNotificationNotSupported: 'https://a2a-protocol.org/errors/push-notification-not-supported',
+    UnsupportedOperation: 'https://a2a-protocol.org/errors/unsupported-operation',
+    ContentTypeNotSupported: 'https://a2a-protocol.org/errors/content-type-not-supported',
+    InvalidAgentResponse: 'https://a2a-protocol.org/errors/invalid-agent-response',
+    AuthenticatedExtendedCardNotConfigured: 'https://a2a-protocol.org/errors/authenticated-extended-card-not-configured',
+    ExtensionSupportRequired: 'https://a2a-protocol.org/errors/extension-support-required',
+    VersionNotSupported: 'https://a2a-protocol.org/errors/version-not-supported',
+};
+/**
+ * Create an RFC 9457 Problem Details object for an A2A error.
+ * @param errorType - The A2A error type name
+ * @param detail - Human-readable explanation of the error
+ * @param extensions - Additional members to include in the response
+ */
+export function createProblemDetails(errorType, detail, extensions) {
+    // Convert PascalCase to Title Case: "TaskNotFound" -> "Task Not Found"
+    const title = errorType.replace(/([A-Z])/g, ' $1').trim();
+    return {
+        type: A2A_ERROR_TYPE_URIS[errorType],
+        title,
+        status: A2A_HTTP_STATUS_CODES[errorType],
+        detail,
+        ...extensions,
+    };
+}
+// ============================================================================
+// URL Building
+// ============================================================================
+/**
+ * Build a URL by substituting path parameters.
+ * @param endpoint - HTTP endpoint definition (from HTTP_ENDPOINTS)
+ * @param params - Path parameter values (keys without leading colon)
+ */
+export function buildUrl(endpoint, params) {
+    let path = endpoint.path;
+    if (params) {
+        for (const [key, value] of Object.entries(params)) {
+            path = path.replace(`:${key}`, encodeURIComponent(value));
+        }
+    }
+    return path;
+}
+/**
+ * Parse camelCase query parameters for the ListTasks endpoint.
+ * Handles type coercion for numeric fields.
+ */
+export function parseListTasksQuery(query) {
+    return {
+        contextId: query['contextId'],
+        state: query['state'],
+        limit: query['limit'] ? parseInt(query['limit'], 10) : undefined,
+        pageToken: query['pageToken'],
+    };
+}

package/dist/src/a2a/bindings/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * A2A Protocol Bindings - Barrel Export
+ *
+ * Re-exports all binding modules and provides cross-binding
+ * error code mapping for consistent error handling across transports.
+ */
+export * from './jsonrpc.js';
+export * from './http.js';
+export * from './grpc.js';
+import { type A2AErrorType } from './jsonrpc.js';
+/** Complete error code mapping across all three transports */
+export interface ErrorCodeMapping {
+    /** JSON-RPC numeric error code */
+    jsonRpcCode: number;
+    /** HTTP response status code */
+    httpStatus: number;
+    /** RFC 9457 Problem Details type URI */
+    httpTypeUri: string;
+    /** gRPC status name (e.g. NOT_FOUND) */
+    grpcStatus: string;
+    /** gRPC numeric status code */
+    grpcCode: number;
+}
+/** Precomputed cross-binding error mapping for all 9 A2A error types */
+export declare const A2A_ERROR_MAPPINGS: ReadonlyMap<A2AErrorType, ErrorCodeMapping>;
+/**
+ * Get the complete error code mapping for a given A2A error type.
+ * Returns consistent values across JSON-RPC, HTTP, and gRPC.
+ */
+export declare function getErrorCodeMapping(errorType: A2AErrorType): ErrorCodeMapping;
+export { A2A_GRPC_ERROR_REASONS } from './grpc.js';

package/dist/src/a2a/bindings/index.js

@@ -0,0 +1,54 @@
+/**
+ * A2A Protocol Bindings - Barrel Export
+ *
+ * Re-exports all binding modules and provides cross-binding
+ * error code mapping for consistent error handling across transports.
+ */
+export * from './jsonrpc.js';
+export * from './http.js';
+export * from './grpc.js';
+import { JSONRPC_A2A_ERROR_CODES } from './jsonrpc.js';
+import { A2A_HTTP_STATUS_CODES, A2A_ERROR_TYPE_URIS } from './http.js';
+import { A2A_GRPC_STATUS_CODES, GRPC_STATUS_CODE } from './grpc.js';
+/** All 9 A2A error types */
+const ERROR_TYPES = [
+    'TaskNotFound',
+    'TaskNotCancelable',
+    'PushNotificationNotSupported',
+    'UnsupportedOperation',
+    'ContentTypeNotSupported',
+    'InvalidAgentResponse',
+    'AuthenticatedExtendedCardNotConfigured',
+    'ExtensionSupportRequired',
+    'VersionNotSupported',
+];
+function buildMappings() {
+    const map = new Map();
+    for (const errorType of ERROR_TYPES) {
+        const grpcStatusName = A2A_GRPC_STATUS_CODES[errorType];
+        map.set(errorType, {
+            jsonRpcCode: JSONRPC_A2A_ERROR_CODES[errorType],
+            httpStatus: A2A_HTTP_STATUS_CODES[errorType],
+            httpTypeUri: A2A_ERROR_TYPE_URIS[errorType],
+            grpcStatus: grpcStatusName,
+            grpcCode: GRPC_STATUS_CODE[grpcStatusName],
+        });
+    }
+    return map;
+}
+/** Precomputed cross-binding error mapping for all 9 A2A error types */
+export const A2A_ERROR_MAPPINGS = buildMappings();
+/**
+ * Get the complete error code mapping for a given A2A error type.
+ * Returns consistent values across JSON-RPC, HTTP, and gRPC.
+ */
+export function getErrorCodeMapping(errorType) {
+    const mapping = A2A_ERROR_MAPPINGS.get(errorType);
+    if (!mapping) {
+        throw new Error(`Unknown A2A error type: ${errorType}`);
+    }
+    return mapping;
+}
+// Also export A2A_GRPC_ERROR_REASONS for convenience (re-exported from grpc.ts via *)
+// but explicitly reference it here so the cross-binding module is self-documenting
+export { A2A_GRPC_ERROR_REASONS } from './grpc.js';