dsh-a2a-server 0.1.1 → 0.3.0

package/lib/protocol/parse.js

@@ -0,0 +1,249 @@
+/**
+ * Inbound parsing: peer JSON to the internal v1.0 shape.
+ *
+ * There is no outbound counterpart. v0.3 needed one because two spellings had
+ * to be reconciled; this server speaks v1.0 only, so what {@link ./wire.ts}
+ * describes is what gets serialized, and the only work left is validating what
+ * arrives.
+ *
+ * Parsing is permissive about what it IGNORES (unknown members are skipped, as
+ * the spec's forward-compatibility rule requires) and strict about what it
+ * ACCEPTS: a v0.3 spelling is not quietly translated, because a peer that
+ * believes it is talking v0.3 to a v1.0-only agent needs to be told.
+ *
+ * @module dsh-a2a/protocol/parse
+ */
+import { A2AContextId, A2ATaskId } from "./brand.js";
+import { TASK_STATES } from "./wire.js";
+/**
+ * Every method this server answers, in the v1.0 PascalCase spelling.
+ *
+ * The names match the gRPC service methods exactly, which is the point of the
+ * v1.0 renaming: one operation has one name across all three bindings.
+ */
+const METHODS = new Map([
+    ['SendMessage', 'send'],
+    ['SendStreamingMessage', 'stream'],
+    ['GetTask', 'get'],
+    ['ListTasks', 'list'],
+    ['CancelTask', 'cancel'],
+    ['SubscribeToTask', 'subscribe'],
+    ['CreateTaskPushNotificationConfig', 'push_create'],
+    ['GetTaskPushNotificationConfig', 'push_get'],
+    ['ListTaskPushNotificationConfigs', 'push_list'],
+    ['DeleteTaskPushNotificationConfig', 'push_delete'],
+    ['GetExtendedAgentCard', 'extended_card'],
+]);
+/**
+ * The v0.3 names, kept only to explain their absence.
+ *
+ * A peer that sends `message/send` gets a method-not-found naming its v1.0
+ * replacement. Answering the call would be worse: the reply would be v1.0
+ * JSON that a v0.3 client cannot read, and the failure would surface much
+ * further from its cause.
+ */
+const LEGACY_METHODS = new Map([
+    ['message/send', 'SendMessage'],
+    ['message/stream', 'SendStreamingMessage'],
+    ['tasks/get', 'GetTask'],
+    ['tasks/cancel', 'CancelTask'],
+    ['tasks/resubscribe', 'SubscribeToTask'],
+    ['tasks/pushNotificationConfig/set', 'CreateTaskPushNotificationConfig'],
+    ['tasks/pushNotificationConfig/get', 'GetTaskPushNotificationConfig'],
+    ['tasks/pushNotificationConfig/list', 'ListTaskPushNotificationConfigs'],
+    ['tasks/pushNotificationConfig/delete', 'DeleteTaskPushNotificationConfig'],
+    ['tasks/pushNotification/set', 'CreateTaskPushNotificationConfig'],
+    ['agent/getAuthenticatedExtendedCard', 'GetExtendedAgentCard'],
+]);
+/**
+ * Resolve a method name to its operation.
+ * @param method - the raw `method` string from the request.
+ * @returns the operation, or undefined for an unknown method.
+ */
+export function resolveMethod(method) {
+    return METHODS.get(method);
+}
+/**
+ * The v1.0 name that replaced a retired v0.3 method.
+ * @param method - the raw `method` string from the request.
+ * @returns the replacement name, or undefined when the method was never ours.
+ */
+export function legacyMethodReplacement(method) {
+    return LEGACY_METHODS.get(method);
+}
+/**
+ * Read one `Part`.
+ *
+ * v1.0 discriminates on which content member is present, so the probes below
+ * must each be specific enough not to claim another variant's shape. An
+ * unrecognizable part yields undefined rather than throwing: one odd part must
+ * not fail a request whose other parts are usable.
+ * @param raw - one element of a `parts` array.
+ * @returns the normalized part, or undefined when no content member is present.
+ */
+export function parsePart(raw) {
+    if (raw === null || typeof raw !== 'object')
+        return undefined;
+    const part = raw;
+    const common = {
+        ...typeof part['mediaType'] === 'string' ? { mediaType: part['mediaType'] } : {},
+        ...isObject(part['metadata']) ? { metadata: part['metadata'] } : {},
+    };
+    if (typeof part['text'] === 'string')
+        return { text: part['text'], ...common };
+    if (typeof part['url'] === 'string' || typeof part['raw'] === 'string') {
+        return {
+            ...typeof part['url'] === 'string' ? { url: part['url'] } : {},
+            ...typeof part['raw'] === 'string' ? { raw: part['raw'] } : {},
+            ...typeof part['filename'] === 'string' ? { filename: part['filename'] } : {},
+            ...common,
+        };
+    }
+    if ('data' in part)
+        return { data: part['data'], ...common };
+    return undefined;
+}
+/**
+ * Render every part as text the model can read.
+ *
+ * File and data parts become bracketed references rather than being dropped, so
+ * the agent knows something was attached and can ask about it. This is the same
+ * flattening `dsh-acp` applies to baseline resource links.
+ * @param parts - normalized parts, in order.
+ * @returns the joined text, empty when nothing rendered.
+ */
+export function partsToText(parts) {
+    const chunks = [];
+    for (const part of parts) {
+        if ('text' in part) {
+            if (part.text.length > 0)
+                chunks.push(part.text);
+        }
+        else if ('data' in part) {
+            chunks.push(`[data ${JSON.stringify(part.data)}]`);
+        }
+        else {
+            const name = part.filename ?? part.url ?? 'unnamed';
+            const type = part.mediaType === undefined ? '' : ` mediaType=${part.mediaType}`;
+            chunks.push(`[file name=${name}${type}]`);
+        }
+    }
+    return chunks.join('\n');
+}
+/**
+ * Parse the `SendMessage` / `SendStreamingMessage` request object.
+ * @param raw - the request's `params` value.
+ * @returns the normalized request, or undefined when the shape is unusable.
+ */
+export function parseSendMessageRequest(raw) {
+    if (!isObject(raw))
+        return undefined;
+    const params = raw;
+    const rawMessage = params['message'];
+    if (!isObject(rawMessage))
+        return undefined;
+    const message = rawMessage;
+    const parts = [];
+    if (Array.isArray(message['parts'])) {
+        for (const item of message['parts']) {
+            const part = parsePart(item);
+            if (part !== undefined)
+                parts.push(part);
+        }
+    }
+    const contextId = firstString(message['contextId']);
+    const taskId = firstString(message['taskId']);
+    const normalized = {
+        messageId: firstString(message['messageId']) ?? '',
+        // v1.0 spells roles ROLE_USER / ROLE_AGENT. Anything else is a peer that
+        // has not migrated; treating it as a user message keeps the request usable
+        // and the agent still sees a peer-authored turn.
+        role: message['role'] === 'ROLE_AGENT' ? 'ROLE_AGENT' : 'ROLE_USER',
+        parts,
+        ...contextId === undefined ? {} : { contextId: A2AContextId(contextId) },
+        ...taskId === undefined ? {} : { taskId: A2ATaskId(taskId) },
+    };
+    const configuration = params['configuration'];
+    return {
+        message: normalized,
+        ...isObject(configuration)
+            ? { configuration: configuration }
+            : {},
+        ...isObject(params['metadata']) ? { metadata: params['metadata'] } : {},
+    };
+}
+/**
+ * Parse `ListTasks` parameters.
+ *
+ * Every filter is optional; an absent `params` lists everything the caller may
+ * see. `pageSize` is clamped to the spec's 1..100 window rather than rejected,
+ * because a client asking for 500 wants "as many as you'll give me".
+ * @param raw - the request's `params` value.
+ * @returns the normalized filters.
+ */
+export function parseListTasksParams(raw) {
+    if (!isObject(raw))
+        return {};
+    const params = raw;
+    const status = typeof params['status'] === 'string' ? params['status'] : undefined;
+    const pageSize = typeof params['pageSize'] === 'number' && Number.isFinite(params['pageSize'])
+        ? Math.min(100, Math.max(1, Math.floor(params['pageSize'])))
+        : undefined;
+    return {
+        ...firstString(params['contextId']) === undefined
+            ? {}
+            : { contextId: firstString(params['contextId']) },
+        ...status !== undefined && TASK_STATES.includes(status)
+            ? { status: status }
+            : {},
+        ...pageSize === undefined ? {} : { pageSize },
+        ...firstString(params['pageToken']) === undefined
+            ? {}
+            : { pageToken: firstString(params['pageToken']) },
+        ...typeof params['historyLength'] === 'number'
+            ? { historyLength: params['historyLength'] }
+            : {},
+        ...firstString(params['statusTimestampAfter']) === undefined
+            ? {}
+            : { statusTimestampAfter: firstString(params['statusTimestampAfter']) },
+        ...typeof params['includeArtifacts'] === 'boolean'
+            ? { includeArtifacts: params['includeArtifacts'] }
+            : {},
+    };
+}
+/**
+ * Read the `tenant` routing member.
+ *
+ * This card declares no tenant on its interface, so the spec's rule ("clients
+ * MUST include this value ... omit the field if tenant is not set") makes any
+ * non-empty tenant a misrouted request. Reporting it beats silently serving a
+ * peer that believes it reached a different agent.
+ * @param raw - the request's `params` value.
+ * @returns the tenant a peer asked for, or undefined when correctly omitted.
+ */
+export function parseTenant(raw) {
+    if (!isObject(raw))
+        return undefined;
+    return firstString(raw['tenant']);
+}
+/**
+ * Whether a value is a plain object usable as a JSON map.
+ * @param value - the candidate.
+ * @returns true for non-null, non-array objects.
+ */
+function isObject(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+/**
+ * Return the first defined non-empty string among the candidates.
+ * @param values - candidate values in precedence order.
+ * @returns the winning string, or undefined.
+ */
+function firstString(...values) {
+    for (const value of values) {
+        if (typeof value === 'string' && value.length > 0)
+            return value;
+    }
+    return undefined;
+}
+//# sourceMappingURL=parse.js.map

package/lib/protocol/parse.js.map

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

package/lib/protocol/sse.d.ts

@@ -1,11 +1,14 @@
 /**
- * Server-Sent Events framing for `message/stream` and `tasks/resubscribe`.
+ * Server-Sent Events framing for `SendStreamingMessage` and `SubscribeToTask`.
  *
  * A2A streams JSON-RPC responses, not bare events: each frame carries the same
  * envelope the unary methods return, correlated by the original request id.
+ * The payload is always a `StreamResponse` — v1.0 identifies an event by the
+ * member it is wrapped in, so a bare event on the wire is unreadable.
  *
  * @module dsh-a2a/protocol/sse
  */
+import type { A2AStreamResponse } from './wire.ts';
 /**
  * Encode one payload as an SSE `data:` frame.
  *
@@ -13,8 +16,8 @@
  * serialized compactly (JSON.stringify emits no raw newlines) and terminated
  * with the blank line SSE requires.
  * @param id - the JSON-RPC id of the request this stream answers.
- * @param payload - the already-dialect-rendered event.
+ * @param payload - the StreamResponse to carry.
  * @returns the wire text of one frame.
  */
-export declare function sseFrame(id: string | number | null, payload: unknown): string;
+export declare function sseFrame(id: string | number | null, payload: A2AStreamResponse): string;
 //# sourceMappingURL=sse.d.ts.map

package/lib/protocol/sse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../src/protocol/sse.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAE7E"}
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../src/protocol/sse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAElD;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,EAAE,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAEvF"}

package/lib/protocol/sse.js

@@ -1,8 +1,10 @@
 /**
- * Server-Sent Events framing for `message/stream` and `tasks/resubscribe`.
+ * Server-Sent Events framing for `SendStreamingMessage` and `SubscribeToTask`.
  *
  * A2A streams JSON-RPC responses, not bare events: each frame carries the same
  * envelope the unary methods return, correlated by the original request id.
+ * The payload is always a `StreamResponse` — v1.0 identifies an event by the
+ * member it is wrapped in, so a bare event on the wire is unreadable.
  *
  * @module dsh-a2a/protocol/sse
  */
@@ -14,7 +16,7 @@ import { jsonRpcResult } from "./jsonrpc.js";
  * serialized compactly (JSON.stringify emits no raw newlines) and terminated
  * with the blank line SSE requires.
  * @param id - the JSON-RPC id of the request this stream answers.
- * @param payload - the already-dialect-rendered event.
+ * @param payload - the StreamResponse to carry.
  * @returns the wire text of one frame.
  */
 export function sseFrame(id, payload) {

package/lib/protocol/sse.js.map

@@ -1 +1 @@
-{"version":3,"file":"sse.js","sourceRoot":"","sources":["../../src/protocol/sse.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAE5C;;;;;;;;;GASG;AACH,MAAM,UAAU,QAAQ,CAAC,EAA0B,EAAE,OAAgB;IACnE,OAAO,SAAS,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,MAAM,CAAA;AAClE,CAAC"}
+{"version":3,"file":"sse.js","sourceRoot":"","sources":["../../src/protocol/sse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAG5C;;;;;;;;;GASG;AACH,MAAM,UAAU,QAAQ,CAAC,EAA0B,EAAE,OAA0B;IAC7E,OAAO,SAAS,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,MAAM,CAAA;AAClE,CAAC"}

package/lib/protocol/wire.d.ts

@@ -1,16 +1,27 @@
 /**
- * A2A wire vocabulary, normalized to the v0.3.0 spelling.
+ * The A2A v1.0 wire vocabulary.
  *
- * The server speaks one internal shape. Requests in either dialect are parsed
- * into these types on the way in ({@link ./normalize.ts}), and responses are
- * rendered back into the caller's dialect on the way out. No plugin module
- * outside `protocol/` sees a v1.0 spelling.
+ * There is exactly ONE shape in this server. v1.0 removed the `kind`
+ * discriminator, renamed every enum to its ProtoJSON spelling, and flattened
+ * `Part` into a single unified message — so the JSON these types describe is
+ * the JSON that goes on the wire, with no translation layer between them.
+ * That is the whole reason the v0.3 dialect machinery is gone: it existed only
+ * to bridge two spellings, and this server now speaks one.
  *
  * @module dsh-a2a/protocol/wire
  */
 import type { A2AContextId, A2ATaskId } from './brand.ts';
-/** Task lifecycle state, in the v0.3 JSON spelling. */
-export type A2ATaskState = 'submitted' | 'working' | 'input-required' | 'auth-required' | 'completed' | 'canceled' | 'failed' | 'rejected';
+/**
+ * The single A2A protocol version this server implements.
+ *
+ * Major.Minor only: the spec states patch numbers do not affect compatibility
+ * and SHOULD NOT appear in requests, responses, or Agent Cards.
+ */
+export declare const A2A_PROTOCOL_VERSION = "1.0";
+/** Task lifecycle state, in the ProtoJSON enum spelling v1.0 requires. */
+export type A2ATaskState = 'TASK_STATE_UNSPECIFIED' | 'TASK_STATE_SUBMITTED' | 'TASK_STATE_WORKING' | 'TASK_STATE_INPUT_REQUIRED' | 'TASK_STATE_AUTH_REQUIRED' | 'TASK_STATE_COMPLETED' | 'TASK_STATE_CANCELED' | 'TASK_STATE_FAILED' | 'TASK_STATE_REJECTED';
+/** Every state a peer may name, e.g. as the `ListTasks` status filter. */
+export declare const TASK_STATES: readonly A2ATaskState[];
 /** States after which a task accepts no further transition. */
 export declare const TERMINAL_STATES: ReadonlySet<A2ATaskState>;
 /**
@@ -19,41 +30,46 @@ export declare const TERMINAL_STATES: ReadonlySet<A2ATaskState>;
  * @returns true when no further transition is accepted.
  */
 export declare function isTerminal(state: A2ATaskState): boolean;
-/** Message author, in the v0.3 JSON spelling. */
-export type A2ARole = 'user' | 'agent';
-/** Which spelling a peer used; every response echoes the request's dialect. */
-export type A2ADialect = 'v0.3' | 'v1.0';
-/** A text segment of a message or artifact. */
+/** Message author, in the ProtoJSON enum spelling. */
+export type A2ARole = 'ROLE_USER' | 'ROLE_AGENT';
+/**
+ * A text segment of a message or artifact.
+ *
+ * v1.0 unified the three part types into one message whose content member IS
+ * the discriminator, so these three interfaces narrow on member presence
+ * (`'text' in part`) rather than on a `kind` tag that no longer exists.
+ */
 export interface A2ATextPart {
-    kind: 'text';
     text: string;
+    mediaType?: string;
+    metadata?: Record<string, unknown>;
 }
-/** A file reference or inline payload. */
+/** A file reference (`url`) or inline base64 payload (`raw`). */
 export interface A2AFilePart {
-    kind: 'file';
-    file: {
-        name?: string;
-        mimeType?: string;
-        uri?: string;
-        bytes?: string;
-    };
+    url?: string;
+    raw?: string;
+    filename?: string;
+    mediaType?: string;
+    metadata?: Record<string, unknown>;
 }
 /** Structured JSON carried beside the text. */
 export interface A2ADataPart {
-    kind: 'data';
     data: unknown;
+    mediaType?: string;
+    metadata?: Record<string, unknown>;
 }
-/** Any message or artifact segment. */
+/** Any message or artifact segment. Exactly one content member is set. */
 export type A2APart = A2ATextPart | A2AFilePart | A2ADataPart;
 /** One message in a task's history. */
 export interface A2AMessage {
-    kind: 'message';
     messageId: string;
     role: A2ARole;
     parts: A2APart[];
     taskId?: A2ATaskId;
     contextId?: A2AContextId;
     metadata?: Record<string, unknown>;
+    extensions?: string[];
+    referenceTaskIds?: string[];
 }
 /** A named output the agent produced for a task. */
 export interface A2AArtifact {
@@ -62,6 +78,7 @@ export interface A2AArtifact {
     description?: string;
     parts: A2APart[];
     metadata?: Record<string, unknown>;
+    extensions?: string[];
 }
 /** Current state plus the message that explains it. */
 export interface A2ATaskStatus {
@@ -71,7 +88,6 @@ export interface A2ATaskStatus {
 }
 /** The unit of work a peer submits and polls. */
 export interface A2ATask {
-    kind: 'task';
     id: A2ATaskId;
     contextId: A2AContextId;
     status: A2ATaskStatus;
@@ -79,27 +95,69 @@ export interface A2ATask {
     artifacts?: A2AArtifact[];
     metadata?: Record<string, unknown>;
 }
-/** A streamed state transition. `final` closes the stream. */
+/**
+ * A streamed state transition.
+ *
+ * v1.0 removed the `final` flag: the stream's own closure is what tells a peer
+ * the task reached a terminal state, so a server that keeps a stream open after
+ * a terminal status is the bug, not a missing boolean.
+ */
 export interface A2ATaskStatusUpdateEvent {
-    kind: 'status-update';
     taskId: A2ATaskId;
     contextId: A2AContextId;
     status: A2ATaskStatus;
-    final: boolean;
     metadata?: Record<string, unknown>;
 }
 /** A streamed artifact, optionally appended to an earlier chunk. */
 export interface A2ATaskArtifactUpdateEvent {
-    kind: 'artifact-update';
     taskId: A2ATaskId;
     contextId: A2AContextId;
     artifact: A2AArtifact;
+    /** Position of this artifact in the task's `artifacts` array. */
+    index?: number;
     append?: boolean;
     lastChunk?: boolean;
     metadata?: Record<string, unknown>;
 }
-/** Anything the server may push over an SSE stream. */
-export type A2AStreamEvent = A2ATask | A2AMessage | A2ATaskStatusUpdateEvent | A2ATaskArtifactUpdateEvent;
+/**
+ * One frame of a stream, wrapped so the member name identifies the event type.
+ *
+ * Exactly one member is set. This replaces v0.3's `kind` tag, and it is why
+ * the router never writes a bare event onto a stream.
+ */
+export type A2AStreamResponse = {
+    task: A2ATask;
+} | {
+    message: A2AMessage;
+} | {
+    statusUpdate: A2ATaskStatusUpdateEvent;
+} | {
+    artifactUpdate: A2ATaskArtifactUpdateEvent;
+};
+/**
+ * Wrap a task as the opening frame of a stream.
+ * @param task - the task the stream follows.
+ * @returns the StreamResponse to serialize.
+ */
+export declare function streamTask(task: A2ATask): A2AStreamResponse;
+/**
+ * Wrap a status transition as a stream frame.
+ * @param event - the transition.
+ * @returns the StreamResponse to serialize.
+ */
+export declare function streamStatusUpdate(event: A2ATaskStatusUpdateEvent): A2AStreamResponse;
+/**
+ * Wrap an artifact as a stream frame.
+ * @param event - the artifact event.
+ * @returns the StreamResponse to serialize.
+ */
+export declare function streamArtifactUpdate(event: A2ATaskArtifactUpdateEvent): A2AStreamResponse;
+/** The result of `SendMessage`: a task to track, or a direct reply. */
+export type A2ASendMessageResponse = {
+    task: A2ATask;
+} | {
+    message: A2AMessage;
+};
 /** Webhook registration a peer supplies for terminal-state callbacks. */
 export interface A2APushNotificationConfig {
     id?: string;
@@ -110,19 +168,49 @@ export interface A2APushNotificationConfig {
         credentials?: string;
     };
 }
-/** Per-request knobs carried beside the message on `message/send`. */
-export interface A2AMessageSendConfiguration {
+/** A push configuration bound to a task. Flattened in v1.0. */
+export interface A2ATaskPushNotificationConfig {
+    taskId?: string;
+    id?: string;
+    pushNotificationConfig?: A2APushNotificationConfig;
+}
+/** Per-request knobs carried beside the message on `SendMessage`. */
+export interface A2ASendMessageConfiguration {
     acceptedOutputModes?: string[];
     historyLength?: number;
-    pushNotificationConfig?: A2APushNotificationConfig;
-    blocking?: boolean;
+    taskPushNotificationConfig?: A2ATaskPushNotificationConfig;
+    /**
+     * Whether to answer before the task settles.
+     *
+     * v1.0 inverted v0.3's `blocking`: operations are BLOCKING by default, and a
+     * client opts out. Unset therefore means "wait", not "return now".
+     */
+    returnImmediately?: boolean;
 }
-/** Parameters of `message/send` and `message/stream`. */
-export interface A2AMessageSendParams {
+/** Parameters of `SendMessage` and `SendStreamingMessage`. */
+export interface A2ASendMessageRequest {
     message: A2AMessage;
-    configuration?: A2AMessageSendConfiguration;
+    configuration?: A2ASendMessageConfiguration;
     metadata?: Record<string, unknown>;
 }
+/** Parameters of `ListTasks`. */
+export interface A2AListTasksParams {
+    contextId?: string;
+    status?: A2ATaskState;
+    pageSize?: number;
+    pageToken?: string;
+    historyLength?: number;
+    statusTimestampAfter?: string;
+    includeArtifacts?: boolean;
+}
+/** The result of `ListTasks`. Cursor-paginated, newest first. */
+export interface A2AListTasksResult {
+    tasks: A2ATask[];
+    /** Empty string, never absent, when this is the last page. */
+    nextPageToken: string;
+    pageSize: number;
+    totalSize: number;
+}
 /** One capability this agent advertises on its card. */
 export interface A2AAgentSkill {
     id: string;
@@ -133,32 +221,55 @@ export interface A2AAgentSkill {
     inputModes?: string[];
     outputModes?: string[];
 }
+/**
+ * One transport this agent answers on.
+ *
+ * v1.0 folded `url`, `preferredTransport`, `additionalInterfaces`, and the
+ * card-level `protocolVersion` into this one repeated field: a version is a
+ * property of an interface, not of an agent.
+ */
+export interface A2AAgentInterface {
+    url: string;
+    protocolBinding: string;
+    protocolVersion: string;
+    tenant?: string;
+}
+/** Which schemes a caller must satisfy, and with which scopes. */
+export interface A2ASecurityRequirement {
+    schemes: Record<string, {
+        list: string[];
+    }>;
+}
+/** Optional features a peer may rely on. */
+export interface A2AAgentCapabilities {
+    streaming?: boolean;
+    pushNotifications?: boolean;
+    extensions?: {
+        uri: string;
+        description?: string;
+        required?: boolean;
+    }[];
+    /** v1.0 home of what v0.3 spelled `supportsAuthenticatedExtendedCard`. */
+    extendedAgentCard?: boolean;
+}
 /** The public description a peer fetches before talking to us. */
 export interface A2AAgentCard {
-    protocolVersion: string;
     name: string;
     description: string;
-    version: string;
-    url: string;
-    preferredTransport: string;
-    supportedInterfaces?: {
-        url: string;
-        protocolBinding: string;
-        protocolVersion: string;
-    }[];
+    /** Ordered; the first entry is the preferred interface. Required in v1.0. */
+    supportedInterfaces: A2AAgentInterface[];
     provider?: {
         organization: string;
         url: string;
     };
-    capabilities: {
-        streaming: boolean;
-        pushNotifications: boolean;
-        stateTransitionHistory: boolean;
-    };
+    version: string;
+    documentationUrl?: string;
+    capabilities: A2AAgentCapabilities;
+    securitySchemes?: Record<string, unknown>;
+    securityRequirements?: A2ASecurityRequirement[];
     defaultInputModes: string[];
     defaultOutputModes: string[];
     skills: A2AAgentSkill[];
-    securitySchemes?: Record<string, unknown>;
-    security?: Record<string, string[]>[];
+    iconUrl?: string;
 }
 //# sourceMappingURL=wire.d.ts.map