a2a-mesh 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,1589 @@
+import { A as AuthScheme, J as JwtAuthMiddleware, a as JwtAuthMiddlewareOptions } from './shared/a2a-mesh.CDuHtAfx.js';
+export { b as ApiKeyAuthScheme, c as ApiKeyCredentialSource, d as AuthValidationResult, B as BaseAuthScheme, H as HttpAuthScheme, O as OpenIdConnectAuthScheme } from './shared/a2a-mesh.CDuHtAfx.js';
+import { z } from 'zod';
+import * as node_http from 'node:http';
+import { Response as Response$1, Express, Request } from 'express';
+import { EventEmitter } from 'node:events';
+import { RateLimitConfig, RateLimitStore } from './middleware/index.js';
+export { InMemoryRateLimitStore, RateLimitState, RedisRateLimitClient, RedisRateLimitStore, createRateLimiter } from './middleware/index.js';
+import EventSource from 'eventsource';
+export { SpanStatusCode } from '@opentelemetry/api';
+export { a2aMeshTracer, withA2ABaggage } from './telemetry/index.js';
+
+/**
+ * @file extensions.ts
+ * Extension metadata shared across A2A runtime objects.
+ */
+interface A2AExtension {
+    /**
+     * Globally unique URI for the extension.
+     */
+    uri: string;
+    /**
+     * Optional semantic version string for the extension contract.
+     */
+    version?: string;
+    /**
+     * Whether the extension is required for successful request handling.
+     */
+    required?: boolean;
+}
+
+/**
+ * @file agent-card.ts
+ * Types defining the Agent Card structure.
+ */
+
+type ProtocolVersion = '0.3' | '1.0';
+/**
+ * Agent capabilities.
+ */
+interface AgentCapabilities {
+    streaming?: boolean;
+    pushNotifications?: boolean;
+    stateTransitionHistory?: boolean;
+    extendedAgentCard?: boolean;
+}
+/**
+ * Definition of an agent skill.
+ */
+interface AgentSkill {
+    id: string;
+    name: string;
+    description: string;
+    tags?: string[];
+    examples?: string[];
+    inputModes?: string[];
+    outputModes?: string[];
+}
+/**
+ * Legacy v0.3 Agent Card structure.
+ */
+interface AgentCardV03 {
+    protocolVersion: '0.3';
+    name: string;
+    description: string;
+    url: string;
+    iconUrl?: string;
+    provider?: {
+        name: string;
+        url: string;
+    };
+    version: string;
+    capabilities?: AgentCapabilities;
+    skills?: AgentSkill[];
+    defaultInputMode?: string;
+    defaultOutputMode?: string;
+    authentication?: AuthScheme[];
+    supportsAuthenticatedExtendedCard?: boolean;
+}
+/**
+ * The Canonical v1.0 Agent Card structure.
+ */
+interface AgentCard {
+    protocolVersion: '1.0';
+    name: string;
+    description: string;
+    url: string;
+    iconUrl?: string;
+    documentationUrl?: string;
+    provider?: {
+        name: string;
+        url: string;
+    };
+    version: string;
+    capabilities?: AgentCapabilities;
+    supportedInterfaces?: string[];
+    protocolBinding?: string;
+    defaultInputModes?: string[];
+    defaultOutputModes?: string[];
+    skills?: AgentSkill[];
+    securitySchemes?: AuthScheme[];
+    security?: Record<string, string[]>[];
+    signatures?: string[];
+    extensions?: A2AExtension[];
+}
+type AnyAgentCard = AgentCard | AgentCardV03;
+declare function normalizeAgentCard(card: AnyAgentCard): AgentCard;
+
+/**
+ * @file jsonrpc.ts
+ * JSON-RPC 2.0 request/response helpers for A2A endpoints.
+ */
+type JsonRpcId = string | number | null;
+interface JsonRpcRequest {
+    jsonrpc: '2.0';
+    method: string;
+    params?: Record<string, unknown> | unknown[];
+    id?: JsonRpcId;
+}
+interface JsonRpcSuccessResponse<T = unknown> {
+    jsonrpc: '2.0';
+    result: T;
+    id: JsonRpcId;
+}
+interface JsonRpcFailureResponse {
+    jsonrpc: '2.0';
+    error: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+    id: JsonRpcId;
+}
+type JsonRpcResponse<T = unknown> = JsonRpcSuccessResponse<T> | JsonRpcFailureResponse;
+declare const ErrorCodes: {
+    readonly ParseError: -32700;
+    readonly InvalidRequest: -32600;
+    readonly MethodNotFound: -32601;
+    readonly InvalidParams: -32602;
+    readonly InternalError: -32603;
+    readonly TaskNotFound: -32004;
+    readonly PushNotificationNotSupported: -32010;
+    readonly UnsupportedOperation: -32011;
+    readonly RateLimitExceeded: -32029;
+    readonly Unauthorized: -32040;
+    readonly ExtensionRequired: -32041;
+};
+declare class JsonRpcError extends Error {
+    readonly code: number;
+    readonly data?: unknown;
+    constructor(code: number, message: string, data?: unknown);
+}
+
+/**
+ * @file task.ts
+ * Core task, message and artifact types used by the A2A runtime.
+ */
+
+interface TextPart {
+    type: 'text';
+    text: string;
+}
+interface FilePart {
+    type: 'file';
+    file: {
+        name?: string;
+        mimeType: string;
+        bytes?: string;
+        uri?: string;
+    };
+}
+interface DataPart {
+    type: 'data';
+    data: Record<string, unknown>;
+}
+type Part = TextPart | FilePart | DataPart;
+interface Message {
+    kind?: 'message';
+    role: 'user' | 'agent';
+    parts: Part[];
+    messageId: string;
+    timestamp: string;
+    contextId?: string;
+}
+interface PushNotificationConfig {
+    id?: string;
+    url: string;
+    token?: string;
+    authentication?: AuthScheme;
+}
+interface Artifact {
+    artifactId: string;
+    name?: string;
+    description?: string;
+    parts: Part[];
+    index: number;
+    lastChunk?: boolean;
+}
+interface ExtensibleArtifact extends Artifact {
+    extensions?: string[];
+    metadata?: Record<string, unknown>;
+}
+interface TaskStatus {
+    state: 'submitted' | 'working' | 'input-required' | 'completed' | 'failed' | 'canceled';
+    timestamp: string;
+    message?: string;
+}
+interface Task {
+    kind?: 'task';
+    id: string;
+    sessionId?: string;
+    contextId?: string;
+    status: TaskStatus;
+    history: Message[];
+    artifacts?: ExtensibleArtifact[];
+    metadata?: Record<string, unknown>;
+    extensions?: string[];
+}
+interface TaskListParams {
+    contextId?: string;
+    limit?: number;
+    offset?: number;
+}
+interface TaskListResult {
+    tasks: Task[];
+    total: number;
+}
+interface TaskCounts {
+    total: number;
+    active: number;
+    completed: number;
+    failed: number;
+    canceled: number;
+    submitted: number;
+    inputRequired: number;
+    working: number;
+}
+interface MessageRequestConfiguration {
+    blocking?: boolean;
+    acceptedOutputModes?: string[];
+    pushNotificationConfig?: PushNotificationConfig;
+    extensions?: A2AExtension[];
+}
+interface MessageSendParams {
+    message: Message;
+    taskId?: string;
+    sessionId?: string;
+    contextId?: string;
+    configuration?: MessageRequestConfiguration;
+}
+interface A2AHealthResponse {
+    status: 'healthy';
+    version: string;
+    protocol: 'A2A/1.0';
+    uptime: number;
+    tasks: Pick<TaskCounts, 'active' | 'completed' | 'failed' | 'total'>;
+    memory: {
+        heapUsedMb: number;
+        heapTotalMb: number;
+    };
+}
+
+/**
+ * @file logger.ts
+ * Small structured logger with request/task/context correlation support.
+ */
+interface LogContext {
+    requestId?: string;
+    taskId?: string;
+    contextId?: string;
+    method?: string;
+    agentName?: string;
+    durationMs?: number;
+    [key: string]: unknown;
+}
+declare const logger: {
+    debug(message: string, context?: LogContext): void;
+    info(message: string, context?: LogContext): void;
+    warn(message: string, context?: LogContext): void;
+    error(message: string, context?: LogContext): void;
+};
+
+/**
+ * @file schema-validator.ts
+ * Zod-based validation for A2A messages and configurations.
+ */
+
+declare const JsonRpcRequestSchema: z.ZodObject<{
+    jsonrpc: z.ZodLiteral<"2.0">;
+    method: z.ZodString;
+    params: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodArray<z.ZodUnknown, "many">]>>;
+    id: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodNull]>>;
+}, "strip", z.ZodTypeAny, {
+    jsonrpc: "2.0";
+    method: string;
+    params?: unknown[] | Record<string, unknown> | undefined;
+    id?: string | number | null | undefined;
+}, {
+    jsonrpc: "2.0";
+    method: string;
+    params?: unknown[] | Record<string, unknown> | undefined;
+    id?: string | number | null | undefined;
+}>;
+declare const PartSchema: z.ZodUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"text">;
+    text: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "text";
+    text: string;
+}, {
+    type: "text";
+    text: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"file">;
+    file: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        mimeType: z.ZodString;
+        bytes: z.ZodOptional<z.ZodString>;
+        uri: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        mimeType: string;
+        name?: string | undefined;
+        bytes?: string | undefined;
+        uri?: string | undefined;
+    }, {
+        mimeType: string;
+        name?: string | undefined;
+        bytes?: string | undefined;
+        uri?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    type: "file";
+    file: {
+        mimeType: string;
+        name?: string | undefined;
+        bytes?: string | undefined;
+        uri?: string | undefined;
+    };
+}, {
+    type: "file";
+    file: {
+        mimeType: string;
+        name?: string | undefined;
+        bytes?: string | undefined;
+        uri?: string | undefined;
+    };
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"data">;
+    data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    type: "data";
+    data: Record<string, unknown>;
+}, {
+    type: "data";
+    data: Record<string, unknown>;
+}>]>;
+declare const MessageSchema: z.ZodObject<{
+    kind: z.ZodOptional<z.ZodLiteral<"message">>;
+    role: z.ZodEnum<["user", "agent"]>;
+    parts: z.ZodArray<z.ZodUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"text">;
+        text: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "text";
+        text: string;
+    }, {
+        type: "text";
+        text: string;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"file">;
+        file: z.ZodObject<{
+            name: z.ZodOptional<z.ZodString>;
+            mimeType: z.ZodString;
+            bytes: z.ZodOptional<z.ZodString>;
+            uri: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            mimeType: string;
+            name?: string | undefined;
+            bytes?: string | undefined;
+            uri?: string | undefined;
+        }, {
+            mimeType: string;
+            name?: string | undefined;
+            bytes?: string | undefined;
+            uri?: string | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        type: "file";
+        file: {
+            mimeType: string;
+            name?: string | undefined;
+            bytes?: string | undefined;
+            uri?: string | undefined;
+        };
+    }, {
+        type: "file";
+        file: {
+            mimeType: string;
+            name?: string | undefined;
+            bytes?: string | undefined;
+            uri?: string | undefined;
+        };
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"data">;
+        data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        type: "data";
+        data: Record<string, unknown>;
+    }, {
+        type: "data";
+        data: Record<string, unknown>;
+    }>]>, "many">;
+    messageId: z.ZodString;
+    timestamp: z.ZodString;
+    contextId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    role: "user" | "agent";
+    parts: ({
+        type: "text";
+        text: string;
+    } | {
+        type: "file";
+        file: {
+            mimeType: string;
+            name?: string | undefined;
+            bytes?: string | undefined;
+            uri?: string | undefined;
+        };
+    } | {
+        type: "data";
+        data: Record<string, unknown>;
+    })[];
+    messageId: string;
+    timestamp: string;
+    kind?: "message" | undefined;
+    contextId?: string | undefined;
+}, {
+    role: "user" | "agent";
+    parts: ({
+        type: "text";
+        text: string;
+    } | {
+        type: "file";
+        file: {
+            mimeType: string;
+            name?: string | undefined;
+            bytes?: string | undefined;
+            uri?: string | undefined;
+        };
+    } | {
+        type: "data";
+        data: Record<string, unknown>;
+    })[];
+    messageId: string;
+    timestamp: string;
+    kind?: "message" | undefined;
+    contextId?: string | undefined;
+}>;
+declare const PushNotificationConfigSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    url: z.ZodString;
+    token: z.ZodOptional<z.ZodString>;
+    authentication: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"apiKey">;
+        id: z.ZodString;
+        in: z.ZodEnum<["header", "query"]>;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "apiKey";
+        id: string;
+        name: string;
+        in: "header" | "query";
+        description?: string | undefined;
+    }, {
+        type: "apiKey";
+        id: string;
+        name: string;
+        in: "header" | "query";
+        description?: string | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"http">;
+        id: z.ZodString;
+        scheme: z.ZodLiteral<"bearer">;
+        bearerFormat: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "http";
+        id: string;
+        scheme: "bearer";
+        description?: string | undefined;
+        bearerFormat?: string | undefined;
+    }, {
+        type: "http";
+        id: string;
+        scheme: "bearer";
+        description?: string | undefined;
+        bearerFormat?: string | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"openIdConnect">;
+        id: z.ZodString;
+        openIdConnectUrl: z.ZodString;
+        audience: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+        issuer: z.ZodOptional<z.ZodString>;
+        jwksUri: z.ZodOptional<z.ZodString>;
+        algorithms: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "openIdConnect";
+        id: string;
+        openIdConnectUrl: string;
+        description?: string | undefined;
+        audience?: string | string[] | undefined;
+        issuer?: string | undefined;
+        jwksUri?: string | undefined;
+        algorithms?: string[] | undefined;
+    }, {
+        type: "openIdConnect";
+        id: string;
+        openIdConnectUrl: string;
+        description?: string | undefined;
+        audience?: string | string[] | undefined;
+        issuer?: string | undefined;
+        jwksUri?: string | undefined;
+        algorithms?: string[] | undefined;
+    }>]>>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    id?: string | undefined;
+    token?: string | undefined;
+    authentication?: {
+        type: "apiKey";
+        id: string;
+        name: string;
+        in: "header" | "query";
+        description?: string | undefined;
+    } | {
+        type: "http";
+        id: string;
+        scheme: "bearer";
+        description?: string | undefined;
+        bearerFormat?: string | undefined;
+    } | {
+        type: "openIdConnect";
+        id: string;
+        openIdConnectUrl: string;
+        description?: string | undefined;
+        audience?: string | string[] | undefined;
+        issuer?: string | undefined;
+        jwksUri?: string | undefined;
+        algorithms?: string[] | undefined;
+    } | undefined;
+}, {
+    url: string;
+    id?: string | undefined;
+    token?: string | undefined;
+    authentication?: {
+        type: "apiKey";
+        id: string;
+        name: string;
+        in: "header" | "query";
+        description?: string | undefined;
+    } | {
+        type: "http";
+        id: string;
+        scheme: "bearer";
+        description?: string | undefined;
+        bearerFormat?: string | undefined;
+    } | {
+        type: "openIdConnect";
+        id: string;
+        openIdConnectUrl: string;
+        description?: string | undefined;
+        audience?: string | string[] | undefined;
+        issuer?: string | undefined;
+        jwksUri?: string | undefined;
+        algorithms?: string[] | undefined;
+    } | undefined;
+}>;
+declare const MessageRequestConfigurationSchema: z.ZodObject<{
+    blocking: z.ZodOptional<z.ZodBoolean>;
+    acceptedOutputModes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    pushNotificationConfig: z.ZodOptional<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        url: z.ZodString;
+        token: z.ZodOptional<z.ZodString>;
+        authentication: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"apiKey">;
+            id: z.ZodString;
+            in: z.ZodEnum<["header", "query"]>;
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: "apiKey";
+            id: string;
+            name: string;
+            in: "header" | "query";
+            description?: string | undefined;
+        }, {
+            type: "apiKey";
+            id: string;
+            name: string;
+            in: "header" | "query";
+            description?: string | undefined;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"http">;
+            id: z.ZodString;
+            scheme: z.ZodLiteral<"bearer">;
+            bearerFormat: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: "http";
+            id: string;
+            scheme: "bearer";
+            description?: string | undefined;
+            bearerFormat?: string | undefined;
+        }, {
+            type: "http";
+            id: string;
+            scheme: "bearer";
+            description?: string | undefined;
+            bearerFormat?: string | undefined;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"openIdConnect">;
+            id: z.ZodString;
+            openIdConnectUrl: z.ZodString;
+            audience: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+            issuer: z.ZodOptional<z.ZodString>;
+            jwksUri: z.ZodOptional<z.ZodString>;
+            algorithms: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            description: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: "openIdConnect";
+            id: string;
+            openIdConnectUrl: string;
+            description?: string | undefined;
+            audience?: string | string[] | undefined;
+            issuer?: string | undefined;
+            jwksUri?: string | undefined;
+            algorithms?: string[] | undefined;
+        }, {
+            type: "openIdConnect";
+            id: string;
+            openIdConnectUrl: string;
+            description?: string | undefined;
+            audience?: string | string[] | undefined;
+            issuer?: string | undefined;
+            jwksUri?: string | undefined;
+            algorithms?: string[] | undefined;
+        }>]>>;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        id?: string | undefined;
+        token?: string | undefined;
+        authentication?: {
+            type: "apiKey";
+            id: string;
+            name: string;
+            in: "header" | "query";
+            description?: string | undefined;
+        } | {
+            type: "http";
+            id: string;
+            scheme: "bearer";
+            description?: string | undefined;
+            bearerFormat?: string | undefined;
+        } | {
+            type: "openIdConnect";
+            id: string;
+            openIdConnectUrl: string;
+            description?: string | undefined;
+            audience?: string | string[] | undefined;
+            issuer?: string | undefined;
+            jwksUri?: string | undefined;
+            algorithms?: string[] | undefined;
+        } | undefined;
+    }, {
+        url: string;
+        id?: string | undefined;
+        token?: string | undefined;
+        authentication?: {
+            type: "apiKey";
+            id: string;
+            name: string;
+            in: "header" | "query";
+            description?: string | undefined;
+        } | {
+            type: "http";
+            id: string;
+            scheme: "bearer";
+            description?: string | undefined;
+            bearerFormat?: string | undefined;
+        } | {
+            type: "openIdConnect";
+            id: string;
+            openIdConnectUrl: string;
+            description?: string | undefined;
+            audience?: string | string[] | undefined;
+            issuer?: string | undefined;
+            jwksUri?: string | undefined;
+            algorithms?: string[] | undefined;
+        } | undefined;
+    }>>;
+    extensions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        uri: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+        required: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        uri: string;
+        version?: string | undefined;
+        required?: boolean | undefined;
+    }, {
+        uri: string;
+        version?: string | undefined;
+        required?: boolean | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    blocking?: boolean | undefined;
+    acceptedOutputModes?: string[] | undefined;
+    pushNotificationConfig?: {
+        url: string;
+        id?: string | undefined;
+        token?: string | undefined;
+        authentication?: {
+            type: "apiKey";
+            id: string;
+            name: string;
+            in: "header" | "query";
+            description?: string | undefined;
+        } | {
+            type: "http";
+            id: string;
+            scheme: "bearer";
+            description?: string | undefined;
+            bearerFormat?: string | undefined;
+        } | {
+            type: "openIdConnect";
+            id: string;
+            openIdConnectUrl: string;
+            description?: string | undefined;
+            audience?: string | string[] | undefined;
+            issuer?: string | undefined;
+            jwksUri?: string | undefined;
+            algorithms?: string[] | undefined;
+        } | undefined;
+    } | undefined;
+    extensions?: {
+        uri: string;
+        version?: string | undefined;
+        required?: boolean | undefined;
+    }[] | undefined;
+}, {
+    blocking?: boolean | undefined;
+    acceptedOutputModes?: string[] | undefined;
+    pushNotificationConfig?: {
+        url: string;
+        id?: string | undefined;
+        token?: string | undefined;
+        authentication?: {
+            type: "apiKey";
+            id: string;
+            name: string;
+            in: "header" | "query";
+            description?: string | undefined;
+        } | {
+            type: "http";
+            id: string;
+            scheme: "bearer";
+            description?: string | undefined;
+            bearerFormat?: string | undefined;
+        } | {
+            type: "openIdConnect";
+            id: string;
+            openIdConnectUrl: string;
+            description?: string | undefined;
+            audience?: string | string[] | undefined;
+            issuer?: string | undefined;
+            jwksUri?: string | undefined;
+            algorithms?: string[] | undefined;
+        } | undefined;
+    } | undefined;
+    extensions?: {
+        uri: string;
+        version?: string | undefined;
+        required?: boolean | undefined;
+    }[] | undefined;
+}>;
+declare const MessageSendParamsSchema: z.ZodObject<{
+    message: z.ZodObject<{
+        kind: z.ZodOptional<z.ZodLiteral<"message">>;
+        role: z.ZodEnum<["user", "agent"]>;
+        parts: z.ZodArray<z.ZodUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"text">;
+            text: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            type: "text";
+            text: string;
+        }, {
+            type: "text";
+            text: string;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"file">;
+            file: z.ZodObject<{
+                name: z.ZodOptional<z.ZodString>;
+                mimeType: z.ZodString;
+                bytes: z.ZodOptional<z.ZodString>;
+                uri: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                mimeType: string;
+                name?: string | undefined;
+                bytes?: string | undefined;
+                uri?: string | undefined;
+            }, {
+                mimeType: string;
+                name?: string | undefined;
+                bytes?: string | undefined;
+                uri?: string | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            type: "file";
+            file: {
+                mimeType: string;
+                name?: string | undefined;
+                bytes?: string | undefined;
+                uri?: string | undefined;
+            };
+        }, {
+            type: "file";
+            file: {
+                mimeType: string;
+                name?: string | undefined;
+                bytes?: string | undefined;
+                uri?: string | undefined;
+            };
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"data">;
+            data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, "strip", z.ZodTypeAny, {
+            type: "data";
+            data: Record<string, unknown>;
+        }, {
+            type: "data";
+            data: Record<string, unknown>;
+        }>]>, "many">;
+        messageId: z.ZodString;
+        timestamp: z.ZodString;
+        contextId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        role: "user" | "agent";
+        parts: ({
+            type: "text";
+            text: string;
+        } | {
+            type: "file";
+            file: {
+                mimeType: string;
+                name?: string | undefined;
+                bytes?: string | undefined;
+                uri?: string | undefined;
+            };
+        } | {
+            type: "data";
+            data: Record<string, unknown>;
+        })[];
+        messageId: string;
+        timestamp: string;
+        kind?: "message" | undefined;
+        contextId?: string | undefined;
+    }, {
+        role: "user" | "agent";
+        parts: ({
+            type: "text";
+            text: string;
+        } | {
+            type: "file";
+            file: {
+                mimeType: string;
+                name?: string | undefined;
+                bytes?: string | undefined;
+                uri?: string | undefined;
+            };
+        } | {
+            type: "data";
+            data: Record<string, unknown>;
+        })[];
+        messageId: string;
+        timestamp: string;
+        kind?: "message" | undefined;
+        contextId?: string | undefined;
+    }>;
+    taskId: z.ZodOptional<z.ZodString>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    contextId: z.ZodOptional<z.ZodString>;
+    configuration: z.ZodOptional<z.ZodObject<{
+        blocking: z.ZodOptional<z.ZodBoolean>;
+        acceptedOutputModes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        pushNotificationConfig: z.ZodOptional<z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            url: z.ZodString;
+            token: z.ZodOptional<z.ZodString>;
+            authentication: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"apiKey">;
+                id: z.ZodString;
+                in: z.ZodEnum<["header", "query"]>;
+                name: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                type: "apiKey";
+                id: string;
+                name: string;
+                in: "header" | "query";
+                description?: string | undefined;
+            }, {
+                type: "apiKey";
+                id: string;
+                name: string;
+                in: "header" | "query";
+                description?: string | undefined;
+            }>, z.ZodObject<{
+                type: z.ZodLiteral<"http">;
+                id: z.ZodString;
+                scheme: z.ZodLiteral<"bearer">;
+                bearerFormat: z.ZodOptional<z.ZodString>;
+                description: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                type: "http";
+                id: string;
+                scheme: "bearer";
+                description?: string | undefined;
+                bearerFormat?: string | undefined;
+            }, {
+                type: "http";
+                id: string;
+                scheme: "bearer";
+                description?: string | undefined;
+                bearerFormat?: string | undefined;
+            }>, z.ZodObject<{
+                type: z.ZodLiteral<"openIdConnect">;
+                id: z.ZodString;
+                openIdConnectUrl: z.ZodString;
+                audience: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+                issuer: z.ZodOptional<z.ZodString>;
+                jwksUri: z.ZodOptional<z.ZodString>;
+                algorithms: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+                description: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                type: "openIdConnect";
+                id: string;
+                openIdConnectUrl: string;
+                description?: string | undefined;
+                audience?: string | string[] | undefined;
+                issuer?: string | undefined;
+                jwksUri?: string | undefined;
+                algorithms?: string[] | undefined;
+            }, {
+                type: "openIdConnect";
+                id: string;
+                openIdConnectUrl: string;
+                description?: string | undefined;
+                audience?: string | string[] | undefined;
+                issuer?: string | undefined;
+                jwksUri?: string | undefined;
+                algorithms?: string[] | undefined;
+            }>]>>;
+        }, "strip", z.ZodTypeAny, {
+            url: string;
+            id?: string | undefined;
+            token?: string | undefined;
+            authentication?: {
+                type: "apiKey";
+                id: string;
+                name: string;
+                in: "header" | "query";
+                description?: string | undefined;
+            } | {
+                type: "http";
+                id: string;
+                scheme: "bearer";
+                description?: string | undefined;
+                bearerFormat?: string | undefined;
+            } | {
+                type: "openIdConnect";
+                id: string;
+                openIdConnectUrl: string;
+                description?: string | undefined;
+                audience?: string | string[] | undefined;
+                issuer?: string | undefined;
+                jwksUri?: string | undefined;
+                algorithms?: string[] | undefined;
+            } | undefined;
+        }, {
+            url: string;
+            id?: string | undefined;
+            token?: string | undefined;
+            authentication?: {
+                type: "apiKey";
+                id: string;
+                name: string;
+                in: "header" | "query";
+                description?: string | undefined;
+            } | {
+                type: "http";
+                id: string;
+                scheme: "bearer";
+                description?: string | undefined;
+                bearerFormat?: string | undefined;
+            } | {
+                type: "openIdConnect";
+                id: string;
+                openIdConnectUrl: string;
+                description?: string | undefined;
+                audience?: string | string[] | undefined;
+                issuer?: string | undefined;
+                jwksUri?: string | undefined;
+                algorithms?: string[] | undefined;
+            } | undefined;
+        }>>;
+        extensions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            uri: z.ZodString;
+            version: z.ZodOptional<z.ZodString>;
+            required: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            uri: string;
+            version?: string | undefined;
+            required?: boolean | undefined;
+        }, {
+            uri: string;
+            version?: string | undefined;
+            required?: boolean | undefined;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        blocking?: boolean | undefined;
+        acceptedOutputModes?: string[] | undefined;
+        pushNotificationConfig?: {
+            url: string;
+            id?: string | undefined;
+            token?: string | undefined;
+            authentication?: {
+                type: "apiKey";
+                id: string;
+                name: string;
+                in: "header" | "query";
+                description?: string | undefined;
+            } | {
+                type: "http";
+                id: string;
+                scheme: "bearer";
+                description?: string | undefined;
+                bearerFormat?: string | undefined;
+            } | {
+                type: "openIdConnect";
+                id: string;
+                openIdConnectUrl: string;
+                description?: string | undefined;
+                audience?: string | string[] | undefined;
+                issuer?: string | undefined;
+                jwksUri?: string | undefined;
+                algorithms?: string[] | undefined;
+            } | undefined;
+        } | undefined;
+        extensions?: {
+            uri: string;
+            version?: string | undefined;
+            required?: boolean | undefined;
+        }[] | undefined;
+    }, {
+        blocking?: boolean | undefined;
+        acceptedOutputModes?: string[] | undefined;
+        pushNotificationConfig?: {
+            url: string;
+            id?: string | undefined;
+            token?: string | undefined;
+            authentication?: {
+                type: "apiKey";
+                id: string;
+                name: string;
+                in: "header" | "query";
+                description?: string | undefined;
+            } | {
+                type: "http";
+                id: string;
+                scheme: "bearer";
+                description?: string | undefined;
+                bearerFormat?: string | undefined;
+            } | {
+                type: "openIdConnect";
+                id: string;
+                openIdConnectUrl: string;
+                description?: string | undefined;
+                audience?: string | string[] | undefined;
+                issuer?: string | undefined;
+                jwksUri?: string | undefined;
+                algorithms?: string[] | undefined;
+            } | undefined;
+        } | undefined;
+        extensions?: {
+            uri: string;
+            version?: string | undefined;
+            required?: boolean | undefined;
+        }[] | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    message: {
+        role: "user" | "agent";
+        parts: ({
+            type: "text";
+            text: string;
+        } | {
+            type: "file";
+            file: {
+                mimeType: string;
+                name?: string | undefined;
+                bytes?: string | undefined;
+                uri?: string | undefined;
+            };
+        } | {
+            type: "data";
+            data: Record<string, unknown>;
+        })[];
+        messageId: string;
+        timestamp: string;
+        kind?: "message" | undefined;
+        contextId?: string | undefined;
+    };
+    contextId?: string | undefined;
+    taskId?: string | undefined;
+    sessionId?: string | undefined;
+    configuration?: {
+        blocking?: boolean | undefined;
+        acceptedOutputModes?: string[] | undefined;
+        pushNotificationConfig?: {
+            url: string;
+            id?: string | undefined;
+            token?: string | undefined;
+            authentication?: {
+                type: "apiKey";
+                id: string;
+                name: string;
+                in: "header" | "query";
+                description?: string | undefined;
+            } | {
+                type: "http";
+                id: string;
+                scheme: "bearer";
+                description?: string | undefined;
+                bearerFormat?: string | undefined;
+            } | {
+                type: "openIdConnect";
+                id: string;
+                openIdConnectUrl: string;
+                description?: string | undefined;
+                audience?: string | string[] | undefined;
+                issuer?: string | undefined;
+                jwksUri?: string | undefined;
+                algorithms?: string[] | undefined;
+            } | undefined;
+        } | undefined;
+        extensions?: {
+            uri: string;
+            version?: string | undefined;
+            required?: boolean | undefined;
+        }[] | undefined;
+    } | undefined;
+}, {
+    message: {
+        role: "user" | "agent";
+        parts: ({
+            type: "text";
+            text: string;
+        } | {
+            type: "file";
+            file: {
+                mimeType: string;
+                name?: string | undefined;
+                bytes?: string | undefined;
+                uri?: string | undefined;
+            };
+        } | {
+            type: "data";
+            data: Record<string, unknown>;
+        })[];
+        messageId: string;
+        timestamp: string;
+        kind?: "message" | undefined;
+        contextId?: string | undefined;
+    };
+    contextId?: string | undefined;
+    taskId?: string | undefined;
+    sessionId?: string | undefined;
+    configuration?: {
+        blocking?: boolean | undefined;
+        acceptedOutputModes?: string[] | undefined;
+        pushNotificationConfig?: {
+            url: string;
+            id?: string | undefined;
+            token?: string | undefined;
+            authentication?: {
+                type: "apiKey";
+                id: string;
+                name: string;
+                in: "header" | "query";
+                description?: string | undefined;
+            } | {
+                type: "http";
+                id: string;
+                scheme: "bearer";
+                description?: string | undefined;
+                bearerFormat?: string | undefined;
+            } | {
+                type: "openIdConnect";
+                id: string;
+                openIdConnectUrl: string;
+                description?: string | undefined;
+                audience?: string | string[] | undefined;
+                issuer?: string | undefined;
+                jwksUri?: string | undefined;
+                algorithms?: string[] | undefined;
+            } | undefined;
+        } | undefined;
+        extensions?: {
+            uri: string;
+            version?: string | undefined;
+            required?: boolean | undefined;
+        }[] | undefined;
+    } | undefined;
+}>;
+declare const TaskListParamsSchema: z.ZodObject<{
+    contextId: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    contextId?: string | undefined;
+    limit?: number | undefined;
+    offset?: number | undefined;
+}, {
+    contextId?: string | undefined;
+    limit?: number | undefined;
+    offset?: number | undefined;
+}>;
+/**
+ * Validates a payload against a zod schema.
+ * Throws a JsonRpcError if validation fails.
+ * @param schema The zod schema to validate against.
+ * @param data The payload to validate.
+ * @returns The validated data.
+ */
+declare function validateRequest<T>(schema: z.ZodType<T>, data: unknown): T;
+declare function validateMessageSendParams(data: unknown): MessageSendParams;
+declare function validateTaskListParams(data: unknown): TaskListParams;
+
+interface ITaskStorage {
+    insertTask(task: Task): Task;
+    getTask(taskId: string): Task | undefined;
+    saveTask(task: Task): void;
+    getAllTasks(): Task[];
+    getTasksByContextId(contextId: string): Task[];
+    setPushNotification(taskId: string, config: PushNotificationConfig): PushNotificationConfig | undefined;
+    getPushNotification(taskId: string): PushNotificationConfig | undefined;
+}
+
+/**
+ * @file TaskManager.ts
+ * Task lifecycle manager backed by a pluggable storage engine.
+ */
+
+type TaskUpdateReason = 'created' | 'message' | 'artifact' | 'state' | 'push-config';
+interface TaskUpdatedEvent {
+    task: Task;
+    reason: TaskUpdateReason;
+}
+declare class TaskManager extends EventEmitter {
+    private readonly storage;
+    constructor(storage?: ITaskStorage);
+    /**
+     * Creates a new task and stores it in memory.
+     *
+     * @param sessionId Optional session identifier.
+     * @param contextId Optional conversation context identifier.
+     * @returns Newly created task.
+     */
+    createTask(sessionId?: string, contextId?: string): Task;
+    getTask(taskId: string): Task | undefined;
+    getAllTasks(): Task[];
+    getTasksByContext(contextId: string): Task[];
+    getTasksByContextId(contextId: string): Task[];
+    addHistoryMessage(taskId: string, message: Message): Task | undefined;
+    addArtifact(taskId: string, artifact: ExtensibleArtifact): Task | undefined;
+    updateTaskState(taskId: string, state: TaskStatus['state'], historyMessage?: Message, metadata?: Record<string, unknown>): Task | undefined;
+    cancelTask(taskId: string): Task | undefined;
+    setPushNotification(taskId: string, config: PushNotificationConfig): PushNotificationConfig | undefined;
+    getPushNotification(taskId: string): PushNotificationConfig | undefined;
+    setTaskExtensions(taskId: string, extensions: string[]): Task | undefined;
+    getTaskCounts(): TaskCounts;
+    private emitTaskUpdated;
+}
+
+/**
+ * @file SSEStreamer.ts
+ * Server-Sent Events handler for task progress streaming.
+ */
+
+declare class SSEStreamer {
+    private clients;
+    /**
+     * Add a client to the stream map (allows multiple subscribers per task).
+     * @param taskId The task ID associated with the stream.
+     * @param res The Express Response object.
+     */
+    addClient(taskId: string, res: Response$1): void;
+    /**
+     * Broadcast an event to all subscribers of a specific task.
+     * @param taskId The task ID.
+     * @param event The SSE event type (e.g. 'task_updated').
+     * @param data The JSON data payload.
+     */
+    sendEvent(taskId: string, event: string, data: unknown): void;
+    /**
+     * Send a task update and complete the streams if terminal state reached.
+     * @param taskId The task ID.
+     * @param task The updated task object.
+     */
+    sendTaskUpdate(taskId: string, task: Task): void;
+    /**
+     * Close all streams for a specific task.
+     * @param taskId The task ID.
+     */
+    closeStream(taskId: string): void;
+    /**
+     * Remove a specific client from the map.
+     * @param taskId The task ID.
+     * @param res The specific Response object.
+     */
+    removeClient(taskId: string, res: Response$1): void;
+}
+
+/**
+ * @file CircuitBreaker.ts
+ * Simple circuit breaker for non-critical downstream integrations.
+ */
+type CircuitState = 'CLOSED' | 'OPEN' | 'HALF_OPEN';
+interface CircuitBreakerOptions {
+    failureThreshold?: number;
+    recoveryTimeoutMs?: number;
+    successThreshold?: number;
+}
+declare class CircuitOpenError extends Error {
+    constructor(message: string);
+}
+declare class CircuitBreaker {
+    private readonly name;
+    private state;
+    private failureCount;
+    private successCount;
+    private nextAttemptAt;
+    private readonly failureThreshold;
+    private readonly recoveryTimeoutMs;
+    private readonly successThreshold;
+    constructor(name: string, options?: CircuitBreakerOptions);
+    getState(): CircuitState;
+    execute<T>(fn: () => Promise<T>): Promise<T>;
+    private onSuccess;
+    private onFailure;
+}
+
+/**
+ * @file PushNotificationService.ts
+ * Delivery of A2A task updates to client webhooks.
+ */
+
+interface PushNotificationServiceOptions {
+    circuitBreaker?: CircuitBreakerOptions;
+}
+declare class PushNotificationService {
+    private readonly options;
+    private readonly breakers;
+    constructor(options?: PushNotificationServiceOptions);
+    private getBreakerFor;
+    /**
+     * Sends a task snapshot to the configured webhook endpoint.
+     *
+     * @param config Webhook delivery configuration.
+     * @param task Current task snapshot to deliver.
+     * @returns Resolves when delivery succeeds.
+     * @throws When the endpoint responds with a non-2xx status.
+     */
+    sendNotification(config: PushNotificationConfig, task: Task): Promise<void>;
+    /**
+     * Executes an async action with exponential backoff.
+     *
+     * @param fn Async operation to retry.
+     * @param maxRetries Maximum number of retry attempts.
+     * @returns Resolves when the operation succeeds.
+     * @throws Re-throws the last failure when retries are exhausted.
+     */
+    retryWithBackoff(fn: () => Promise<void>, maxRetries?: number): Promise<void>;
+}
+
+interface A2AServerOptions {
+    rateLimit?: Partial<RateLimitConfig>;
+    rateLimitStore?: RateLimitStore;
+    auth?: JwtAuthMiddlewareOptions;
+    taskStorage?: ITaskStorage;
+}
+interface RequestContext {
+    req: Request;
+}
+declare abstract class A2AServer {
+    private readonly options;
+    protected app: Express;
+    protected agentCard: AgentCard;
+    protected taskManager: TaskManager;
+    protected streamer: SSEStreamer;
+    protected pushNotificationService: PushNotificationService;
+    protected authMiddleware: JwtAuthMiddleware | undefined;
+    private readonly startedAt;
+    constructor(agentCard: AgentCard, options?: A2AServerOptions);
+    private setupMiddleware;
+    private setupRoutes;
+    private bindTaskObservers;
+    protected handleRpc(req: JsonRpcRequest, context: RequestContext): Promise<unknown>;
+    private handleMessageRequest;
+    private negotiateExtensions;
+    protected normalizeArtifacts(task: Task, artifacts: Artifact[]): ExtensibleArtifact[];
+    getExpressApp(): Express;
+    getAgentCard(): AgentCard;
+    getTaskManager(): TaskManager;
+    static fromCard(card: AnyAgentCard): AgentCard;
+    protected processTaskInternal(task: Task, message: Message): Promise<void>;
+    /**
+     * Adapter implementation entry point. Must be implemented by specific adapters.
+     */
+    abstract handleTask(task: Task, message: Message): Promise<Artifact[]>;
+    start(port: number): node_http.Server<typeof node_http.IncomingMessage, typeof node_http.ServerResponse>;
+}
+
+declare class InMemoryTaskStorage implements ITaskStorage {
+    private readonly tasks;
+    private readonly contextIndex;
+    private readonly pushNotifications;
+    insertTask(task: Task): Task;
+    getTask(taskId: string): Task | undefined;
+    saveTask(task: Task): void;
+    getAllTasks(): Task[];
+    getTasksByContextId(contextId: string): Task[];
+    setPushNotification(taskId: string, config: PushNotificationConfig): PushNotificationConfig | undefined;
+    getPushNotification(taskId: string): PushNotificationConfig | undefined;
+    private syncContextIndex;
+}
+
+declare class SqliteTaskStorage implements ITaskStorage {
+    private readonly db;
+    constructor(path: string);
+    insertTask(task: Task): Task;
+    getTask(taskId: string): Task | undefined;
+    saveTask(task: Task): void;
+    getAllTasks(): Task[];
+    getTasksByContextId(contextId: string): Task[];
+    setPushNotification(taskId: string, config: PushNotificationConfig): PushNotificationConfig | undefined;
+    getPushNotification(taskId: string): PushNotificationConfig | undefined;
+}
+
+/**
+ * @file interceptors.ts
+ * Transport-agnostic request interception helpers for client calls.
+ */
+interface ClientCallOptions {
+    headers?: Record<string, string>;
+    serviceParameters?: Record<string, string>;
+    signal?: AbortSignal;
+}
+interface BeforeArgs {
+    method: string;
+    body?: unknown;
+    options: ClientCallOptions;
+}
+interface AfterArgs<T = unknown> {
+    method: string;
+    response: T;
+}
+interface CallInterceptor {
+    before(args: BeforeArgs): Promise<void> | void;
+    after?(args: AfterArgs): Promise<void> | void;
+}
+interface AuthenticationHandler {
+    headers(): Promise<Record<string, string>>;
+    shouldRetryWithHeaders?(requestInit: RequestInit, response: Response): Promise<Record<string, string> | undefined>;
+}
+declare function createAuthenticatingFetchWithRetry(baseFetch: typeof fetch, handler: AuthenticationHandler): typeof fetch;
+
+/**
+ * @file A2AClient.ts
+ * Basic HTTP + SSE client for A2A-compatible agents.
+ */
+
+interface A2AClientOptions {
+    fetchImplementation?: typeof fetch;
+    cardPath?: string;
+    rpcPath?: string;
+    streamPath?: string;
+    eventSourceImplementation?: typeof EventSource;
+    interceptors?: CallInterceptor[];
+    headers?: Record<string, string>;
+    retry?: {
+        maxAttempts?: number;
+        backoffMs?: number;
+        retryOn?: number[];
+    };
+}
+/**
+ * HTTP and SSE client for interacting with A2A-compatible agents.
+ *
+ * @example
+ * ```ts
+ * const client = new A2AClient('http://localhost:3000');
+ * const task = await client.sendMessage({
+ *   role: 'user',
+ *   parts: [{ type: 'text', text: 'Summarize this' }],
+ *   messageId: crypto.randomUUID(),
+ *   timestamp: new Date().toISOString(),
+ * });
+ * ```
+ * @since 1.0.0
+ */
+declare class A2AClient {
+    readonly baseUrl: string;
+    private readonly fetchImplementation;
+    private readonly cardPath;
+    private readonly rpcPath;
+    private readonly streamPath;
+    private readonly eventSourceImplementation;
+    private readonly interceptors;
+    private readonly headers;
+    private readonly retry;
+    constructor(baseUrl: string, options?: A2AClientOptions);
+    resolveCard(): Promise<AgentCard>;
+    sendMessage(params: Message | MessageSendParams): Promise<Task>;
+    sendMessageStream(params: Message | MessageSendParams): Promise<AsyncGenerator<unknown>>;
+    getTask(taskId: string): Promise<Task>;
+    listTasks(params?: TaskListParams): Promise<TaskListResult>;
+    cancelTask(taskId: string): Promise<Task>;
+    setPushNotification(taskId: string, pushNotificationConfig: PushNotificationConfig): Promise<PushNotificationConfig>;
+    getPushNotification(taskId: string): Promise<PushNotificationConfig | null>;
+    health(): Promise<A2AHealthResponse>;
+    private rpc;
+    private normalizeParams;
+    private subscribeToTask;
+    private fetchWithRetry;
+}
+
+/**
+ * @file AgentRegistryClient.ts
+ * Client for the local registry REST/SSE endpoints.
+ */
+
+interface RegisteredAgent {
+    id: string;
+    url: string;
+    card: AgentCard;
+    status: 'healthy' | 'unhealthy' | 'unknown';
+    tags: string[];
+    skills: string[];
+    registeredAt: string;
+    lastHeartbeatAt?: string;
+}
+/**
+ * Client for the registry REST and SSE endpoints.
+ *
+ * @example
+ * ```ts
+ * const registry = new AgentRegistryClient('http://localhost:3099');
+ * const agents = await registry.listAgents();
+ * ```
+ * @since 1.0.0
+ */
+declare class AgentRegistryClient {
+    private readonly baseUrl;
+    private readonly fetchImplementation;
+    constructor(baseUrl: string, fetchImplementation?: typeof fetch);
+    register(agentUrl: string, agentCard: AgentCard): Promise<RegisteredAgent>;
+    listAgents(): Promise<RegisteredAgent[]>;
+    getAgent(id: string): Promise<RegisteredAgent>;
+    searchAgents(query: string, filters?: Record<string, string>): Promise<RegisteredAgent[]>;
+    sendHeartbeat(id: string): Promise<RegisteredAgent>;
+    health(): Promise<Record<string, unknown>>;
+    events(): AsyncGenerator<unknown>;
+}
+
+export { A2AClient, A2AServer, AgentRegistryClient, AuthScheme, CircuitBreaker, CircuitOpenError, ErrorCodes, InMemoryTaskStorage, JsonRpcError, JsonRpcRequestSchema, JwtAuthMiddleware, JwtAuthMiddlewareOptions, MessageRequestConfigurationSchema, MessageSchema, MessageSendParamsSchema, PartSchema, PushNotificationConfigSchema, PushNotificationService, RateLimitConfig, RateLimitStore, SSEStreamer, SqliteTaskStorage, TaskListParamsSchema, TaskManager, createAuthenticatingFetchWithRetry, logger, normalizeAgentCard, validateMessageSendParams, validateRequest, validateTaskListParams };
+export type { A2AClientOptions, A2AExtension, A2AHealthResponse, A2AServerOptions, AfterArgs, AgentCapabilities, AgentCard, AgentCardV03, AgentSkill, AnyAgentCard, Artifact, AuthenticationHandler, BeforeArgs, CallInterceptor, CircuitBreakerOptions, CircuitState, ClientCallOptions, DataPart, ExtensibleArtifact, FilePart, ITaskStorage, JsonRpcFailureResponse, JsonRpcId, JsonRpcRequest, JsonRpcResponse, JsonRpcSuccessResponse, LogContext, Message, MessageRequestConfiguration, MessageSendParams, Part, ProtocolVersion, PushNotificationConfig, PushNotificationServiceOptions, RegisteredAgent, Task, TaskCounts, TaskListParams, TaskListResult, TaskStatus, TaskUpdateReason, TaskUpdatedEvent, TextPart };