@ap3x/a2a 1.0.0 → 2.1.0

package/dist/model.d.ts

@@ -0,0 +1,480 @@
+/**
+ * Canonical A2A v1.0.0 data model.
+ *
+ * One TypeBox schema source drives both directions of the wire: servers
+ * validate inbound payloads and clients validate responses against these same
+ * schemas. All transport bindings (JSON-RPC, REST, gRPC) are mappings of this
+ * model — nothing binding-specific lives here.
+ */
+import { type Static } from "@sinclair/typebox";
+/** The A2A protocol version this model implements. */
+export declare const A2A_PROTOCOL_VERSION = "1.0.0";
+/**
+ * The protocol version advertised on the Agent Card. The deployed reference
+ * SDK ecosystem is 0.3.x (slash wire dialect) — the card states what we
+ * actually interoperate with, and the SDK client accepts any string here.
+ */
+export declare const A2A_CARD_PROTOCOL_VERSION = "0.3.0";
+/** Every task lifecycle state defined by the A2A spec. */
+export declare const TASK_STATES: readonly ["submitted", "working", "input_required", "auth_required", "completed", "failed", "canceled", "rejected"];
+export type TaskState = (typeof TASK_STATES)[number];
+/** States a task can never leave once entered. */
+export declare const TERMINAL_TASK_STATES: ReadonlySet<TaskState>;
+/** Whether `state` is terminal (no further transitions are legal). */
+export declare function isTerminal(state: TaskState): boolean;
+export declare const TaskStateSchema: import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<"submitted" | "working" | "input_required" | "auth_required" | "completed" | "failed" | "canceled" | "rejected">[]>;
+/** Canonicalize one task-state spelling; non-aliased values pass through. */
+export declare function normalizeTaskState(state: unknown): unknown;
+/**
+ * The wire-parse boundary for task states: recursively canonicalize every
+ * `state` field in a value received from a remote peer (Task.status.state,
+ * status-update events, list filters) BEFORE schema validation, so both the
+ * SDK's hyphenated spellings and our snake_case validate. Opaque payload
+ * subtrees (`metadata`, `data`) are carried through untouched.
+ */
+export declare function normalizeWireTaskStates(value: unknown): unknown;
+/** Plain text content. */
+export declare const TextPartSchema: import("@sinclair/typebox").TObject<{
+    mediaType: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+    kind: import("@sinclair/typebox").TLiteral<"text">;
+    text: import("@sinclair/typebox").TString;
+}>;
+/** Structured JSON content. */
+export declare const DataPartSchema: import("@sinclair/typebox").TObject<{
+    mediaType: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+    kind: import("@sinclair/typebox").TLiteral<"data">;
+    data: import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>;
+}>;
+/** Content referenced by URL. */
+export declare const UrlPartSchema: import("@sinclair/typebox").TObject<{
+    mediaType: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+    kind: import("@sinclair/typebox").TLiteral<"url">;
+    url: import("@sinclair/typebox").TString;
+}>;
+/** Inline binary content, base64-encoded. */
+export declare const RawPartSchema: import("@sinclair/typebox").TObject<{
+    mediaType: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+    kind: import("@sinclair/typebox").TLiteral<"raw">;
+    data: import("@sinclair/typebox").TString;
+}>;
+/** Discriminated (on `kind`) union of all part shapes. */
+export declare const PartSchema: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+    mediaType: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+    kind: import("@sinclair/typebox").TLiteral<"text">;
+    text: import("@sinclair/typebox").TString;
+}>, import("@sinclair/typebox").TObject<{
+    mediaType: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+    kind: import("@sinclair/typebox").TLiteral<"data">;
+    data: import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>;
+}>, import("@sinclair/typebox").TObject<{
+    mediaType: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+    kind: import("@sinclair/typebox").TLiteral<"url">;
+    url: import("@sinclair/typebox").TString;
+}>, import("@sinclair/typebox").TObject<{
+    mediaType: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+    kind: import("@sinclair/typebox").TLiteral<"raw">;
+    data: import("@sinclair/typebox").TString;
+}>]>;
+export type TextPart = Static<typeof TextPartSchema>;
+export type DataPart = Static<typeof DataPartSchema>;
+export type UrlPart = Static<typeof UrlPartSchema>;
+export type RawPart = Static<typeof RawPartSchema>;
+export type Part = Static<typeof PartSchema>;
+export declare const MessageSchema: import("@sinclair/typebox").TObject<{
+    messageId: import("@sinclair/typebox").TString;
+    contextId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    taskId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    role: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"user">, import("@sinclair/typebox").TLiteral<"agent">]>;
+    parts: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+        mediaType: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+        kind: import("@sinclair/typebox").TLiteral<"text">;
+        text: import("@sinclair/typebox").TString;
+    }>, import("@sinclair/typebox").TObject<{
+        mediaType: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+        kind: import("@sinclair/typebox").TLiteral<"data">;
+        data: import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>;
+    }>, import("@sinclair/typebox").TObject<{
+        mediaType: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+        kind: import("@sinclair/typebox").TLiteral<"url">;
+        url: import("@sinclair/typebox").TString;
+    }>, import("@sinclair/typebox").TObject<{
+        mediaType: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+        kind: import("@sinclair/typebox").TLiteral<"raw">;
+        data: import("@sinclair/typebox").TString;
+    }>]>>;
+    metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+}>;
+export type Message = Static<typeof MessageSchema>;
+export declare const TaskStatusSchema: import("@sinclair/typebox").TObject<{
+    state: import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<"submitted" | "working" | "input_required" | "auth_required" | "completed" | "failed" | "canceled" | "rejected">[]>;
+    /** Agent message accompanying the state (final text, error, or a streamed chunk). */
+    message: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+        messageId: import("@sinclair/typebox").TString;
+        contextId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        taskId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        role: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"user">, import("@sinclair/typebox").TLiteral<"agent">]>;
+        parts: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+            mediaType: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+            metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+            kind: import("@sinclair/typebox").TLiteral<"text">;
+            text: import("@sinclair/typebox").TString;
+        }>, import("@sinclair/typebox").TObject<{
+            mediaType: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+            metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+            kind: import("@sinclair/typebox").TLiteral<"data">;
+            data: import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>;
+        }>, import("@sinclair/typebox").TObject<{
+            mediaType: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+            metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+            kind: import("@sinclair/typebox").TLiteral<"url">;
+            url: import("@sinclair/typebox").TString;
+        }>, import("@sinclair/typebox").TObject<{
+            mediaType: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+            metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+            kind: import("@sinclair/typebox").TLiteral<"raw">;
+            data: import("@sinclair/typebox").TString;
+        }>]>>;
+        metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+    }>>;
+    /** ISO-8601 timestamp of when the state was entered. */
+    timestamp: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+export type TaskStatus = Static<typeof TaskStatusSchema>;
+export declare const ArtifactSchema: import("@sinclair/typebox").TObject<{
+    artifactId: import("@sinclair/typebox").TString;
+    name: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    description: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    parts: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+        mediaType: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+        kind: import("@sinclair/typebox").TLiteral<"text">;
+        text: import("@sinclair/typebox").TString;
+    }>, import("@sinclair/typebox").TObject<{
+        mediaType: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+        kind: import("@sinclair/typebox").TLiteral<"data">;
+        data: import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>;
+    }>, import("@sinclair/typebox").TObject<{
+        mediaType: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+        kind: import("@sinclair/typebox").TLiteral<"url">;
+        url: import("@sinclair/typebox").TString;
+    }>, import("@sinclair/typebox").TObject<{
+        mediaType: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+        kind: import("@sinclair/typebox").TLiteral<"raw">;
+        data: import("@sinclair/typebox").TString;
+    }>]>>;
+    metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+}>;
+export type Artifact = Static<typeof ArtifactSchema>;
+export declare const TaskSchema: import("@sinclair/typebox").TObject<{
+    id: import("@sinclair/typebox").TString;
+    contextId: import("@sinclair/typebox").TString;
+    status: import("@sinclair/typebox").TObject<{
+        state: import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<"submitted" | "working" | "input_required" | "auth_required" | "completed" | "failed" | "canceled" | "rejected">[]>;
+        /** Agent message accompanying the state (final text, error, or a streamed chunk). */
+        message: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+            messageId: import("@sinclair/typebox").TString;
+            contextId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+            taskId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+            role: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"user">, import("@sinclair/typebox").TLiteral<"agent">]>;
+            parts: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+                mediaType: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+                kind: import("@sinclair/typebox").TLiteral<"text">;
+                text: import("@sinclair/typebox").TString;
+            }>, import("@sinclair/typebox").TObject<{
+                mediaType: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+                kind: import("@sinclair/typebox").TLiteral<"data">;
+                data: import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>;
+            }>, import("@sinclair/typebox").TObject<{
+                mediaType: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+                kind: import("@sinclair/typebox").TLiteral<"url">;
+                url: import("@sinclair/typebox").TString;
+            }>, import("@sinclair/typebox").TObject<{
+                mediaType: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+                kind: import("@sinclair/typebox").TLiteral<"raw">;
+                data: import("@sinclair/typebox").TString;
+            }>]>>;
+            metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+        }>>;
+        /** ISO-8601 timestamp of when the state was entered. */
+        timestamp: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    }>;
+    artifacts: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        artifactId: import("@sinclair/typebox").TString;
+        name: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        description: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        parts: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+            mediaType: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+            metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+            kind: import("@sinclair/typebox").TLiteral<"text">;
+            text: import("@sinclair/typebox").TString;
+        }>, import("@sinclair/typebox").TObject<{
+            mediaType: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+            metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+            kind: import("@sinclair/typebox").TLiteral<"data">;
+            data: import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>;
+        }>, import("@sinclair/typebox").TObject<{
+            mediaType: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+            metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+            kind: import("@sinclair/typebox").TLiteral<"url">;
+            url: import("@sinclair/typebox").TString;
+        }>, import("@sinclair/typebox").TObject<{
+            mediaType: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+            metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+            kind: import("@sinclair/typebox").TLiteral<"raw">;
+            data: import("@sinclair/typebox").TString;
+        }>]>>;
+        metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+    }>>>;
+    history: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        messageId: import("@sinclair/typebox").TString;
+        contextId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        taskId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        role: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"user">, import("@sinclair/typebox").TLiteral<"agent">]>;
+        parts: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+            mediaType: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+            metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+            kind: import("@sinclair/typebox").TLiteral<"text">;
+            text: import("@sinclair/typebox").TString;
+        }>, import("@sinclair/typebox").TObject<{
+            mediaType: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+            metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+            kind: import("@sinclair/typebox").TLiteral<"data">;
+            data: import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>;
+        }>, import("@sinclair/typebox").TObject<{
+            mediaType: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+            metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+            kind: import("@sinclair/typebox").TLiteral<"url">;
+            url: import("@sinclair/typebox").TString;
+        }>, import("@sinclair/typebox").TObject<{
+            mediaType: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+            metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+            kind: import("@sinclair/typebox").TLiteral<"raw">;
+            data: import("@sinclair/typebox").TString;
+        }>]>>;
+        metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+    }>>>;
+}>;
+export type Task = Static<typeof TaskSchema>;
+export declare const TaskStatusUpdateEventSchema: import("@sinclair/typebox").TObject<{
+    kind: import("@sinclair/typebox").TLiteral<"status-update">;
+    taskId: import("@sinclair/typebox").TString;
+    contextId: import("@sinclair/typebox").TString;
+    status: import("@sinclair/typebox").TObject<{
+        state: import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<"submitted" | "working" | "input_required" | "auth_required" | "completed" | "failed" | "canceled" | "rejected">[]>;
+        /** Agent message accompanying the state (final text, error, or a streamed chunk). */
+        message: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+            messageId: import("@sinclair/typebox").TString;
+            contextId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+            taskId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+            role: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"user">, import("@sinclair/typebox").TLiteral<"agent">]>;
+            parts: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+                mediaType: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+                kind: import("@sinclair/typebox").TLiteral<"text">;
+                text: import("@sinclair/typebox").TString;
+            }>, import("@sinclair/typebox").TObject<{
+                mediaType: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+                kind: import("@sinclair/typebox").TLiteral<"data">;
+                data: import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>;
+            }>, import("@sinclair/typebox").TObject<{
+                mediaType: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+                kind: import("@sinclair/typebox").TLiteral<"url">;
+                url: import("@sinclair/typebox").TString;
+            }>, import("@sinclair/typebox").TObject<{
+                mediaType: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+                kind: import("@sinclair/typebox").TLiteral<"raw">;
+                data: import("@sinclair/typebox").TString;
+            }>]>>;
+            metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+        }>>;
+        /** ISO-8601 timestamp of when the state was entered. */
+        timestamp: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    }>;
+    /** True exactly when `status.state` is terminal — the stream ends here. */
+    final: import("@sinclair/typebox").TBoolean;
+    metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+}>;
+export type TaskStatusUpdateEvent = Static<typeof TaskStatusUpdateEventSchema>;
+export declare const TaskArtifactUpdateEventSchema: import("@sinclair/typebox").TObject<{
+    kind: import("@sinclair/typebox").TLiteral<"artifact-update">;
+    taskId: import("@sinclair/typebox").TString;
+    contextId: import("@sinclair/typebox").TString;
+    artifact: import("@sinclair/typebox").TObject<{
+        artifactId: import("@sinclair/typebox").TString;
+        name: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        description: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        parts: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+            mediaType: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+            metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+            kind: import("@sinclair/typebox").TLiteral<"text">;
+            text: import("@sinclair/typebox").TString;
+        }>, import("@sinclair/typebox").TObject<{
+            mediaType: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+            metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+            kind: import("@sinclair/typebox").TLiteral<"data">;
+            data: import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>;
+        }>, import("@sinclair/typebox").TObject<{
+            mediaType: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+            metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+            kind: import("@sinclair/typebox").TLiteral<"url">;
+            url: import("@sinclair/typebox").TString;
+        }>, import("@sinclair/typebox").TObject<{
+            mediaType: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+            metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+            kind: import("@sinclair/typebox").TLiteral<"raw">;
+            data: import("@sinclair/typebox").TString;
+        }>]>>;
+        metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+    }>;
+    append: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    lastChunk: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+}>;
+export type TaskArtifactUpdateEvent = Static<typeof TaskArtifactUpdateEventSchema>;
+export declare const AgentSkillSchema: import("@sinclair/typebox").TObject<{
+    name: import("@sinclair/typebox").TString;
+    description: import("@sinclair/typebox").TString;
+    tags: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    examples: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+}>;
+export type AgentSkill = Static<typeof AgentSkillSchema>;
+/** A transport binding the agent serves, per spec transport identifiers. */
+export declare const AgentInterfaceSchema: import("@sinclair/typebox").TObject<{
+    transport: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"JSONRPC">, import("@sinclair/typebox").TLiteral<"HTTP+JSON">, import("@sinclair/typebox").TLiteral<"GRPC">]>;
+    url: import("@sinclair/typebox").TString;
+}>;
+export type AgentInterface = Static<typeof AgentInterfaceSchema>;
+/** v1 security subset: bearer/API-key over HTTP. OAuth2/mTLS/OIDC deferred. */
+export declare const BearerSecuritySchemeSchema: import("@sinclair/typebox").TObject<{
+    type: import("@sinclair/typebox").TLiteral<"http">;
+    scheme: import("@sinclair/typebox").TLiteral<"bearer">;
+    description: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+export type BearerSecurityScheme = Static<typeof BearerSecuritySchemeSchema>;
+export declare const AgentCapabilitiesSchema: import("@sinclair/typebox").TObject<{
+    streaming: import("@sinclair/typebox").TBoolean;
+    pushNotifications: import("@sinclair/typebox").TBoolean;
+}>;
+export type AgentCapabilities = Static<typeof AgentCapabilitiesSchema>;
+export declare const AgentProviderSchema: import("@sinclair/typebox").TObject<{
+    name: import("@sinclair/typebox").TString;
+    url: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+export type AgentProvider = Static<typeof AgentProviderSchema>;
+export declare const AgentCardSchema: import("@sinclair/typebox").TObject<{
+    /** AP3X-assigned card id. Optional: reference-SDK cards carry no id. */
+    id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    name: import("@sinclair/typebox").TString;
+    description: import("@sinclair/typebox").TString;
+    capabilities: import("@sinclair/typebox").TObject<{
+        streaming: import("@sinclair/typebox").TBoolean;
+        pushNotifications: import("@sinclair/typebox").TBoolean;
+    }>;
+    skills: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        name: import("@sinclair/typebox").TString;
+        description: import("@sinclair/typebox").TString;
+        tags: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+        examples: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    }>>;
+    interfaces: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        transport: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"JSONRPC">, import("@sinclair/typebox").TLiteral<"HTTP+JSON">, import("@sinclair/typebox").TLiteral<"GRPC">]>;
+        url: import("@sinclair/typebox").TString;
+    }>>;
+    securitySchemes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TObject<{
+        type: import("@sinclair/typebox").TLiteral<"http">;
+        scheme: import("@sinclair/typebox").TLiteral<"bearer">;
+        description: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    }>>>;
+    provider: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+        name: import("@sinclair/typebox").TString;
+        url: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    }>>;
+    /** The preferred endpoint URL (mirrors the first/preferred interface). */
+    url: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    /** Transport served at `url` (e.g. "JSONRPC"). */
+    preferredTransport: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    /** A2A protocol version, e.g. {@link A2A_CARD_PROTOCOL_VERSION}. */
+    protocolVersion: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    /** The agent's own version string. */
+    version: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    defaultInputModes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    defaultOutputModes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+}>;
+export type AgentCard = Static<typeof AgentCardSchema>;
+/**
+ * LIBERAL accept-side card schema — what a REMOTE peer's card must minimally
+ * look like to be usable. The reference SDK's card has required fields and
+ * extras we don't model (signatures, security, extensions, …); rejecting on
+ * those would break interop, so everything here is optional except `name`,
+ * and unknown fields pass through. `A2aClient.connect` normalizes a card
+ * matching this schema into a full {@link AgentCard}.
+ */
+export declare const RemoteAgentInterfaceSchema: import("@sinclair/typebox").TObject<{
+    transport: import("@sinclair/typebox").TString;
+    url: import("@sinclair/typebox").TString;
+}>;
+export declare const RemoteAgentCardSchema: import("@sinclair/typebox").TObject<{
+    name: import("@sinclair/typebox").TString;
+    description: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    capabilities: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+        streaming: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+        pushNotifications: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    }>>;
+    skills: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnknown>>;
+    interfaces: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        transport: import("@sinclair/typebox").TString;
+        url: import("@sinclair/typebox").TString;
+    }>>>;
+    /** Reference-SDK name for extra transport/URL combinations. */
+    additionalInterfaces: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        transport: import("@sinclair/typebox").TString;
+        url: import("@sinclair/typebox").TString;
+    }>>>;
+    url: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    preferredTransport: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    securitySchemes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnknown>;
+    provider: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnknown>;
+}>;
+export type RemoteAgentCard = Static<typeof RemoteAgentCardSchema>;
+/**
+ * Spec-defined JSON-RPC 2.0 error codes: the standard range plus the
+ * A2A-specific `-32000`-block errors.
+ */
+export declare const A2A_ERROR_CODES: {
+    readonly parseError: -32700;
+    readonly invalidRequest: -32600;
+    readonly methodNotFound: -32601;
+    readonly invalidParams: -32602;
+    readonly internalError: -32603;
+    readonly taskNotFound: -32001;
+    readonly taskNotCancelable: -32002;
+    readonly pushNotificationNotSupported: -32003;
+    readonly unsupportedOperation: -32004;
+    readonly contentTypeNotSupported: -32005;
+    readonly invalidAgentResponse: -32006;
+};
+export type A2aErrorCode = (typeof A2A_ERROR_CODES)[keyof typeof A2A_ERROR_CODES];
+//# sourceMappingURL=model.d.ts.map

package/dist/model.d.ts.map

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

package/dist/server.d.ts

@@ -0,0 +1,60 @@
+import { type Server, type ServerResponse } from "node:http";
+import { type AgentBackend } from "@ap3x/agent-core";
+import { A2aExecutor } from "./executor";
+import { type AgentCard, type AgentProvider, type AgentSkill } from "./model";
+/** The spec-mandated, always-unauthenticated Agent Card location. */
+export declare const AGENT_CARD_PATH = "/.well-known/agent-card.json";
+/** A transport binding the server can mount. */
+export type A2aBinding = "jsonrpc" | "rest" | "grpc";
+export interface A2aServerOptions {
+    /** Identity half of the Agent Card; capabilities derive from the backend. */
+    card: {
+        name: string;
+        description: string;
+        skills?: AgentSkill[];
+        provider?: AgentProvider;
+    };
+    /** Port to bind; 0 (the default) picks an ephemeral port. */
+    port?: number;
+    /** Host to bind. Default `127.0.0.1`; non-loopback without auth logs a warning. */
+    host?: string;
+    /** When set, every non-card route requires `Authorization: Bearer <token>`. */
+    auth?: {
+        bearerToken: string;
+    };
+    /**
+     * Transport bindings to mount. Default `["jsonrpc"]` — identical to the
+     * pre-REST behavior. The card's `interfaces` list exactly what is mounted.
+     */
+    bindings?: A2aBinding[];
+    /**
+     * Port for the gRPC binding's OWN listener (only used when `bindings`
+     * includes `"grpc"`). 0 (the default) picks an ephemeral port.
+     */
+    grpcPort?: number;
+    /** Cap on concurrently running backend tasks. */
+    maxConcurrentTasks?: number;
+    /** Retain at most this many TERMINAL tasks (default: unbounded). */
+    maxRetainedTasks?: number;
+    /** Retain at most this many contextId transcripts, LRU-evicted (default: unbounded). */
+    maxRetainedContexts?: number;
+    /** Injected clock (epoch millis). Defaults to `Date.now` at this I/O edge. */
+    now?: () => number;
+}
+/** Constant-time string comparison via fixed-length digests (trust boundary). */
+export declare function constantTimeEqual(a: string, b: string): boolean;
+export declare class A2aServer {
+    readonly card: AgentCard;
+    /** Base URL of the bound server (ephemeral port resolved). */
+    readonly url: string;
+    readonly executor: A2aExecutor;
+    private readonly httpServer;
+    private readonly sseStreams;
+    private readonly closeGrpc?;
+    constructor(card: AgentCard, url: string, executor: A2aExecutor, httpServer: Server, sseStreams: Set<ServerResponse>, closeGrpc?: () => Promise<void>);
+    /** Stop listening and tear down any open SSE streams (+ the gRPC listener). */
+    close(): Promise<void>;
+}
+/** Serve `backend` as an A2A agent; resolves once the server is listening. */
+export declare function serveA2a(backend: AgentBackend, options: A2aServerOptions): Promise<A2aServer>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAQA,OAAO,EAAwB,KAAK,MAAM,EAAE,KAAK,cAAc,EAAgB,MAAM,WAAW,CAAC;AACjG,OAAO,EAAE,KAAK,YAAY,EAAkB,MAAM,kBAAkB,CAAC;AAGrE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAEL,KAAK,SAAS,EAEd,KAAK,aAAa,EAClB,KAAK,UAAU,EAChB,MAAM,SAAS,CAAC;AAEjB,qEAAqE;AACrE,eAAO,MAAM,eAAe,iCAAiC,CAAC;AAU9D,gDAAgD;AAChD,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;AAErD,MAAM,WAAW,gBAAgB;IAC/B,6EAA6E;IAC7E,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;QACtB,QAAQ,CAAC,EAAE,aAAa,CAAC;KAC1B,CAAC;IACF,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mFAAmF;IACnF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+EAA+E;IAC/E,IAAI,CAAC,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/B;;;OAGG;IACH,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oEAAoE;IACpE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wFAAwF;IACxF,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,8EAA8E;IAC9E,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAI/D;AAOD,qBAAa,SAAS;IACpB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,8DAA8D;IAC9D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsB;IACjD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAsB;gBAG/C,IAAI,EAAE,SAAS,EACf,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,WAAW,EACrB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,GAAG,CAAC,cAAc,CAAC,EAC/B,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC;IAUjC,+EAA+E;IACzE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAS7B;AAED,8EAA8E;AAC9E,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,SAAS,CAAC,CA8KpB"}