dsh-a2a-server 0.1.0 → 0.2.0

package/lib/protocol/index.js

@@ -1,19 +1,19 @@
 /**
- * The A2A wire protocol as a dependency-free library.
+ * The A2A v1.0 wire protocol as a dependency-free library.
  *
  * Nothing here touches Cordis, HTTP, or the harness: it is types, framing,
- * dialect normalization, and document construction, so the spec's own JSON
- * examples can be used as golden tests without booting anything.
+ * inbound parsing, and document construction, so the spec's own JSON examples
+ * can be used as golden tests without booting anything.
  *
  * @module dsh-a2a/protocol
  */
 export { A2AContextId, A2ATaskId } from "./brand.js";
-export { TERMINAL_STATES, isTerminal, } from "./wire.js";
-export { A2ARpcError, ERR_CONTENT_TYPE_NOT_SUPPORTED, ERR_INTERNAL, ERR_INVALID_PARAMS, ERR_INVALID_REQUEST, ERR_METHOD_NOT_FOUND, ERR_PARSE, ERR_PUSH_NOT_SUPPORTED, ERR_TASK_NOT_CANCELABLE, ERR_TASK_NOT_FOUND, ERR_UNSUPPORTED_OPERATION, invalidParams, jsonRpcError, jsonRpcResult, taskNotFound, } from "./jsonrpc.js";
-export { parsePart, parseSendParams, partsToText, renderArtifactUpdate, renderStatusUpdate, renderTask, resolveMethod, } from "./normalize.js";
-export { buildAgentCard, FALLBACK_SKILL } from "./card.js";
+export { A2A_PROTOCOL_VERSION, TASK_STATES, TERMINAL_STATES, isTerminal, streamArtifactUpdate, streamStatusUpdate, streamTask, } from "./wire.js";
+export { A2A_ERROR_DOMAIN, A2ARpcError, ERR_CONTENT_TYPE_NOT_SUPPORTED, ERR_EXTENDED_CARD_NOT_CONFIGURED, ERR_EXTENSION_SUPPORT_REQUIRED, ERR_INTERNAL, ERR_INVALID_AGENT_RESPONSE, ERR_INVALID_PARAMS, ERR_INVALID_REQUEST, ERR_METHOD_NOT_FOUND, ERR_PARSE, ERR_PUSH_NOT_SUPPORTED, ERR_TASK_NOT_CANCELABLE, ERR_TASK_NOT_FOUND, ERR_UNSUPPORTED_OPERATION, ERR_VERSION_NOT_SUPPORTED, errorDetails, invalidParams, jsonRpcError, jsonRpcResult, taskNotFound, unsupportedOperation, versionNotSupported, } from "./jsonrpc.js";
+export { legacyMethodReplacement, parseListTasksParams, parsePart, parseSendMessageRequest, parseTenant, partsToText, resolveMethod, } from "./parse.js";
+export { buildAgentCard, buildExtendedAgentCard, FALLBACK_SKILL } from "./card.js";
 export { sseFrame } from "./sse.js";
-/** ISO 8601 UTC with millisecond precision, the timestamp shape A2A uses. */
+/** ISO 8601 UTC with millisecond precision, the timestamp shape A2A v1.0 requires. */
 export function nowIso() {
     return new Date().toISOString();
 }

package/lib/protocol/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/protocol/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAGpD,OAAO,EACL,eAAe,EACf,UAAU,GACX,MAAM,WAAW,CAAA;AAuBlB,OAAO,EACL,WAAW,EACX,8BAA8B,EAC9B,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,SAAS,EACT,sBAAsB,EACtB,uBAAuB,EACvB,kBAAkB,EAClB,yBAAyB,EACzB,aAAa,EACb,YAAY,EACZ,aAAa,EACb,YAAY,GACb,MAAM,cAAc,CAAA;AAGrB,OAAO,EACL,SAAS,EACT,eAAe,EACf,WAAW,EACX,oBAAoB,EACpB,kBAAkB,EAClB,UAAU,EACV,aAAa,GACd,MAAM,gBAAgB,CAAA;AAGvB,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAG1D,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAEnC,6EAA6E;AAC7E,MAAM,UAAU,MAAM;IACpB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;AACjC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/protocol/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAGpD,OAAO,EACL,oBAAoB,EACpB,WAAW,EACX,eAAe,EACf,UAAU,EACV,oBAAoB,EACpB,kBAAkB,EAClB,UAAU,GACX,MAAM,WAAW,CAAA;AA6BlB,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,8BAA8B,EAC9B,gCAAgC,EAChC,8BAA8B,EAC9B,YAAY,EACZ,0BAA0B,EAC1B,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,SAAS,EACT,sBAAsB,EACtB,uBAAuB,EACvB,kBAAkB,EAClB,yBAAyB,EACzB,yBAAyB,EACzB,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,cAAc,CAAA;AAGrB,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,SAAS,EACT,uBAAuB,EACvB,WAAW,EACX,WAAW,EACX,aAAa,GACd,MAAM,YAAY,CAAA;AAGnB,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAGlF,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAEnC,sFAAsF;AACtF,MAAM,UAAU,MAAM;IACpB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;AACjC,CAAC"}

package/lib/protocol/jsonrpc.d.ts

@@ -8,6 +8,10 @@
  * a valid JSON-RPC error envelope, so a client that blindly parses the body
  * and one that reads the status are both served.
  *
+ * v1.0 additionally requires that A2A-specific failures carry a machine-
+ * readable reason in `error.data`, as a `google.rpc.ErrorInfo` object. That is
+ * what {@link A2ARpcError.reason} feeds.
+ *
  * @module dsh-a2a/protocol/jsonrpc
  */
 /** Standard JSON-RPC 2.0 codes. */
@@ -22,6 +26,12 @@ export declare const ERR_TASK_NOT_CANCELABLE = -32002;
 export declare const ERR_PUSH_NOT_SUPPORTED = -32003;
 export declare const ERR_UNSUPPORTED_OPERATION = -32004;
 export declare const ERR_CONTENT_TYPE_NOT_SUPPORTED = -32005;
+export declare const ERR_INVALID_AGENT_RESPONSE = -32006;
+export declare const ERR_EXTENDED_CARD_NOT_CONFIGURED = -32007;
+export declare const ERR_EXTENSION_SUPPORT_REQUIRED = -32008;
+export declare const ERR_VERSION_NOT_SUPPORTED = -32009;
+/** The domain every A2A `ErrorInfo` detail is scoped to. */
+export declare const A2A_ERROR_DOMAIN = "a2a-protocol.org";
 /** A JSON-RPC request as received from a peer. */
 export interface JsonRpcRequest {
     jsonrpc?: string;
@@ -59,21 +69,46 @@ export declare function jsonRpcResult(id: string | number | null, result: unknow
  * @param id - the request id being answered, or null when unknown.
  * @param code - the JSON-RPC or A2A error code.
  * @param message - a human-readable explanation carrying no internal paths.
- * @param data - optional structured detail.
+ * @param data - optional structured detail, already in the details-array shape.
  * @returns the response envelope.
  */
 export declare function jsonRpcError(id: string | number | null, code: number, message: string, data?: unknown): JsonRpcFailure;
-/** An error carrying the JSON-RPC code a handler wants reported. */
+/**
+ * Build the `error.data` details array for an A2A-specific failure.
+ *
+ * v1.0 models error details on `google.rpc.Status`: an array of typed objects,
+ * each naming its type through `@type`. The reason is the UPPER_SNAKE_CASE form
+ * of the A2A error name, which is what lets a client branch on the failure
+ * without string-matching the human-readable message.
+ * @param reason - the A2A error reason, e.g. `TASK_NOT_FOUND`.
+ * @param metadata - additional string context, e.g. the offending id.
+ * @returns the details array.
+ */
+export declare function errorDetails(reason: string, metadata?: Record<string, string>): unknown[];
+/** An error carrying the JSON-RPC code and A2A reason a handler wants reported. */
 export declare class A2ARpcError extends Error {
     readonly code: number;
-    readonly httpStatus: number;
+    readonly options: {
+        reason?: string;
+        metadata?: Record<string, string>;
+        httpStatus?: number;
+    };
     /**
      * @param code - the JSON-RPC or A2A error code.
      * @param message - the human-readable explanation.
-     * @param httpStatus - the HTTP status to answer with; defaults to 200 because
-     * an ordinary JSON-RPC error is a successful HTTP exchange.
+     * @param options - the A2A reason and metadata for `error.data`, plus the
+     * HTTP status to answer with; the status defaults to 200 because an ordinary
+     * JSON-RPC error is a successful HTTP exchange.
      */
-    constructor(code: number, message: string, httpStatus?: number);
+    constructor(code: number, message: string, options?: {
+        reason?: string;
+        metadata?: Record<string, string>;
+        httpStatus?: number;
+    });
+    /** The HTTP status this failure should be answered with. */
+    get httpStatus(): number;
+    /** The `error.data` details array, or undefined when no reason is carried. */
+    get data(): unknown[] | undefined;
 }
 /**
  * Reject a malformed or unsupported parameter.
@@ -90,4 +125,17 @@ export declare function invalidParams(detail: string): A2ARpcError;
  * @returns the error to throw.
  */
 export declare function taskNotFound(taskId: string): A2ARpcError;
+/**
+ * Report an A2A-Version this interface does not implement.
+ * @param requested - the version the peer asked for.
+ * @param supported - the version this interface serves.
+ * @returns the error to throw.
+ */
+export declare function versionNotSupported(requested: string, supported: string): A2ARpcError;
+/**
+ * Report an operation this deployment does not perform.
+ * @param detail - what was refused, and why.
+ * @returns the error to throw.
+ */
+export declare function unsupportedOperation(detail: string): A2ARpcError;
 //# sourceMappingURL=jsonrpc.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"jsonrpc.d.ts","sourceRoot":"","sources":["../../src/protocol/jsonrpc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,mCAAmC;AACnC,eAAO,MAAM,SAAS,SAAS,CAAA;AAC/B,eAAO,MAAM,mBAAmB,SAAS,CAAA;AACzC,eAAO,MAAM,oBAAoB,SAAS,CAAA;AAC1C,eAAO,MAAM,kBAAkB,SAAS,CAAA;AACxC,eAAO,MAAM,YAAY,SAAS,CAAA;AAElC,+DAA+D;AAC/D,eAAO,MAAM,kBAAkB,SAAS,CAAA;AACxC,eAAO,MAAM,uBAAuB,SAAS,CAAA;AAC7C,eAAO,MAAM,sBAAsB,SAAS,CAAA;AAC5C,eAAO,MAAM,yBAAyB,SAAS,CAAA;AAC/C,eAAO,MAAM,8BAA8B,SAAS,CAAA;AAEpD,kDAAkD;AAClD,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,sCAAsC;AACtC,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,KAAK,CAAA;IACd,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;IAC1B,MAAM,EAAE,OAAO,CAAA;CAChB;AAED,kCAAkC;AAClC,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,KAAK,CAAA;IACd,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;IAC1B,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;CACzD;AAED,yCAAyC;AACzC,MAAM,MAAM,eAAe,GAAG,cAAc,GAAG,cAAc,CAAA;AAE7D;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,OAAO,GAAG,cAAc,CAEzF;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,EAC1B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,OAAO,GACb,cAAc,CAEhB;AAED,oEAAoE;AACpE,qBAAa,WAAY,SAAQ,KAAK;IAQlC,QAAQ,CAAC,IAAI,EAAE,MAAM;IAErB,QAAQ,CAAC,UAAU,EAAE,MAAM;IAT7B;;;;;OAKG;gBAEQ,IAAI,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EACN,UAAU,GAAE,MAAY;CAKpC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAEzD;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAExD"}
+{"version":3,"file":"jsonrpc.d.ts","sourceRoot":"","sources":["../../src/protocol/jsonrpc.ts"],"names":[],"mappings":"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"}

package/lib/protocol/jsonrpc.js

@@ -8,6 +8,10 @@
  * a valid JSON-RPC error envelope, so a client that blindly parses the body
  * and one that reads the status are both served.
  *
+ * v1.0 additionally requires that A2A-specific failures carry a machine-
+ * readable reason in `error.data`, as a `google.rpc.ErrorInfo` object. That is
+ * what {@link A2ARpcError.reason} feeds.
+ *
  * @module dsh-a2a/protocol/jsonrpc
  */
 /** Standard JSON-RPC 2.0 codes. */
@@ -22,6 +26,12 @@ export const ERR_TASK_NOT_CANCELABLE = -32002;
 export const ERR_PUSH_NOT_SUPPORTED = -32003;
 export const ERR_UNSUPPORTED_OPERATION = -32004;
 export const ERR_CONTENT_TYPE_NOT_SUPPORTED = -32005;
+export const ERR_INVALID_AGENT_RESPONSE = -32006;
+export const ERR_EXTENDED_CARD_NOT_CONFIGURED = -32007;
+export const ERR_EXTENSION_SUPPORT_REQUIRED = -32008;
+export const ERR_VERSION_NOT_SUPPORTED = -32009;
+/** The domain every A2A `ErrorInfo` detail is scoped to. */
+export const A2A_ERROR_DOMAIN = 'a2a-protocol.org';
 /**
  * Build a success envelope.
  * @param id - the request id being answered.
@@ -36,28 +46,58 @@ export function jsonRpcResult(id, result) {
  * @param id - the request id being answered, or null when unknown.
  * @param code - the JSON-RPC or A2A error code.
  * @param message - a human-readable explanation carrying no internal paths.
- * @param data - optional structured detail.
+ * @param data - optional structured detail, already in the details-array shape.
  * @returns the response envelope.
  */
 export function jsonRpcError(id, code, message, data) {
     return { jsonrpc: '2.0', id, error: { code, message, ...data === undefined ? {} : { data } } };
 }
-/** An error carrying the JSON-RPC code a handler wants reported. */
+/**
+ * Build the `error.data` details array for an A2A-specific failure.
+ *
+ * v1.0 models error details on `google.rpc.Status`: an array of typed objects,
+ * each naming its type through `@type`. The reason is the UPPER_SNAKE_CASE form
+ * of the A2A error name, which is what lets a client branch on the failure
+ * without string-matching the human-readable message.
+ * @param reason - the A2A error reason, e.g. `TASK_NOT_FOUND`.
+ * @param metadata - additional string context, e.g. the offending id.
+ * @returns the details array.
+ */
+export function errorDetails(reason, metadata) {
+    return [{
+            '@type': 'type.googleapis.com/google.rpc.ErrorInfo',
+            reason,
+            domain: A2A_ERROR_DOMAIN,
+            ...metadata === undefined ? {} : { metadata },
+        }];
+}
+/** An error carrying the JSON-RPC code and A2A reason a handler wants reported. */
 export class A2ARpcError extends Error {
     code;
-    httpStatus;
+    options;
     /**
      * @param code - the JSON-RPC or A2A error code.
      * @param message - the human-readable explanation.
-     * @param httpStatus - the HTTP status to answer with; defaults to 200 because
-     * an ordinary JSON-RPC error is a successful HTTP exchange.
+     * @param options - the A2A reason and metadata for `error.data`, plus the
+     * HTTP status to answer with; the status defaults to 200 because an ordinary
+     * JSON-RPC error is a successful HTTP exchange.
      */
-    constructor(code, message, httpStatus = 200) {
+    constructor(code, message, options = {}) {
         super(message);
         this.code = code;
-        this.httpStatus = httpStatus;
+        this.options = options;
         this.name = 'A2ARpcError';
     }
+    /** The HTTP status this failure should be answered with. */
+    get httpStatus() {
+        return this.options.httpStatus ?? 200;
+    }
+    /** The `error.data` details array, or undefined when no reason is carried. */
+    get data() {
+        if (this.options.reason === undefined)
+            return undefined;
+        return errorDetails(this.options.reason, this.options.metadata);
+    }
 }
 /**
  * Reject a malformed or unsupported parameter.
@@ -76,6 +116,28 @@ export function invalidParams(detail) {
  * @returns the error to throw.
  */
 export function taskNotFound(taskId) {
-    return new A2ARpcError(ERR_TASK_NOT_FOUND, `task not found: ${taskId}`);
+    return new A2ARpcError(ERR_TASK_NOT_FOUND, `task not found: ${taskId}`, {
+        reason: 'TASK_NOT_FOUND',
+        metadata: { taskId },
+    });
+}
+/**
+ * Report an A2A-Version this interface does not implement.
+ * @param requested - the version the peer asked for.
+ * @param supported - the version this interface serves.
+ * @returns the error to throw.
+ */
+export function versionNotSupported(requested, supported) {
+    return new A2ARpcError(ERR_VERSION_NOT_SUPPORTED, `unsupported A2A-Version: ${requested}; this interface serves ${supported}`, { reason: 'VERSION_NOT_SUPPORTED', metadata: { requested, supported } });
+}
+/**
+ * Report an operation this deployment does not perform.
+ * @param detail - what was refused, and why.
+ * @returns the error to throw.
+ */
+export function unsupportedOperation(detail) {
+    return new A2ARpcError(ERR_UNSUPPORTED_OPERATION, detail, {
+        reason: 'UNSUPPORTED_OPERATION',
+    });
 }
 //# sourceMappingURL=jsonrpc.js.map

package/lib/protocol/jsonrpc.js.map

@@ -1 +1 @@
-{"version":3,"file":"jsonrpc.js","sourceRoot":"","sources":["../../src/protocol/jsonrpc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,mCAAmC;AACnC,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAK,CAAA;AAC/B,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,KAAK,CAAA;AACzC,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,KAAK,CAAA;AAC1C,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAAK,CAAA;AACxC,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAK,CAAA;AAElC,+DAA+D;AAC/D,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAAK,CAAA;AACxC,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,KAAK,CAAA;AAC7C,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,KAAK,CAAA;AAC5C,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,KAAK,CAAA;AAC/C,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,KAAK,CAAA;AA2BpD;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,EAA0B,EAAE,MAAe;IACvE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,CAAA;AACvC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAC1B,EAA0B,EAC1B,IAAY,EACZ,OAAe,EACf,IAAc;IAEd,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAA;AAChG,CAAC;AAED,oEAAoE;AACpE,MAAM,OAAO,WAAY,SAAQ,KAAK;IAQzB;IAEA;IATX;;;;;OAKG;IACH,YACW,IAAY,EACrB,OAAe,EACN,aAAqB,GAAG;QAEjC,KAAK,CAAC,OAAO,CAAC,CAAA;QAJL,SAAI,GAAJ,IAAI,CAAQ;QAEZ,eAAU,GAAV,UAAU,CAAc;QAGjC,IAAI,CAAC,IAAI,GAAG,aAAa,CAAA;IAC3B,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,OAAO,IAAI,WAAW,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAA;AACpD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,OAAO,IAAI,WAAW,CAAC,kBAAkB,EAAE,mBAAmB,MAAM,EAAE,CAAC,CAAA;AACzE,CAAC"}
+{"version":3,"file":"jsonrpc.js","sourceRoot":"","sources":["../../src/protocol/jsonrpc.ts"],"names":[],"mappings":"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"}

package/lib/protocol/parse.d.ts

@@ -0,0 +1,79 @@
+/**
+ * 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 type { A2AListTasksParams, A2APart, A2ASendMessageRequest } from './wire.ts';
+/** The internal operation a peer's method name resolves to. */
+export type A2AOperation = 'send' | 'stream' | 'get' | 'list' | 'cancel' | 'subscribe' | 'push_create' | 'push_get' | 'push_list' | 'push_delete' | 'extended_card';
+/**
+ * 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 declare function resolveMethod(method: string): A2AOperation | undefined;
+/**
+ * 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 declare function legacyMethodReplacement(method: string): string | undefined;
+/**
+ * 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 declare function parsePart(raw: unknown): A2APart | 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 declare function partsToText(parts: readonly A2APart[]): string;
+/**
+ * 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 declare function parseSendMessageRequest(raw: unknown): A2ASendMessageRequest | undefined;
+/**
+ * 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 declare function parseListTasksParams(raw: unknown): A2AListTasksParams;
+/**
+ * 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 declare function parseTenant(raw: unknown): string | undefined;
+//# sourceMappingURL=parse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/protocol/parse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EACV,kBAAkB,EAElB,OAAO,EAEP,qBAAqB,EAEtB,MAAM,WAAW,CAAA;AAElB,+DAA+D;AAC/D,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,QAAQ,GACR,KAAK,GACL,MAAM,GACN,QAAQ,GACR,WAAW,GACX,aAAa,GACb,UAAU,GACV,WAAW,GACX,aAAa,GACb,eAAe,CAAA;AA4CnB;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEtE;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE1E;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAmB3D;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,CAc7D;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,OAAO,GAAG,qBAAqB,GAAG,SAAS,CAqCvF;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,kBAAkB,CA4BrE;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAG5D"}

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":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAwBvC;;;;;GAKG;AACH,MAAM,OAAO,GAAsC,IAAI,GAAG,CAAuB;IAC/E,CAAC,aAAa,EAAE,MAAM,CAAC;IACvB,CAAC,sBAAsB,EAAE,QAAQ,CAAC;IAClC,CAAC,SAAS,EAAE,KAAK,CAAC;IAClB,CAAC,WAAW,EAAE,MAAM,CAAC;IACrB,CAAC,YAAY,EAAE,QAAQ,CAAC;IACxB,CAAC,iBAAiB,EAAE,WAAW,CAAC;IAChC,CAAC,kCAAkC,EAAE,aAAa,CAAC;IACnD,CAAC,+BAA+B,EAAE,UAAU,CAAC;IAC7C,CAAC,iCAAiC,EAAE,WAAW,CAAC;IAChD,CAAC,kCAAkC,EAAE,aAAa,CAAC;IACnD,CAAC,sBAAsB,EAAE,eAAe,CAAC;CAC1C,CAAC,CAAA;AAEF;;;;;;;GAOG;AACH,MAAM,cAAc,GAAgC,IAAI,GAAG,CAAC;IAC1D,CAAC,cAAc,EAAE,aAAa,CAAC;IAC/B,CAAC,gBAAgB,EAAE,sBAAsB,CAAC;IAC1C,CAAC,WAAW,EAAE,SAAS,CAAC;IACxB,CAAC,cAAc,EAAE,YAAY,CAAC;IAC9B,CAAC,mBAAmB,EAAE,iBAAiB,CAAC;IACxC,CAAC,kCAAkC,EAAE,kCAAkC,CAAC;IACxE,CAAC,kCAAkC,EAAE,+BAA+B,CAAC;IACrE,CAAC,mCAAmC,EAAE,iCAAiC,CAAC;IACxE,CAAC,qCAAqC,EAAE,kCAAkC,CAAC;IAC3E,CAAC,4BAA4B,EAAE,kCAAkC,CAAC;IAClE,CAAC,oCAAoC,EAAE,sBAAsB,CAAC;CAC/D,CAAC,CAAA;AAEF;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;AAC5B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAc;IACpD,OAAO,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;AACnC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,SAAS,CAAC,GAAY;IACpC,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAA;IAC7D,MAAM,IAAI,GAAG,GAA8B,CAAA;IAC3C,MAAM,MAAM,GAAG;QACb,GAAG,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;QAChF,GAAG,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;KACpE,CAAA;IAED,IAAI,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,QAAQ;QAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,EAAE,CAAA;IAC9E,IAAI,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,QAAQ,EAAE,CAAC;QACvE,OAAO;YACL,GAAG,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;YAC9D,GAAG,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;YAC9D,GAAG,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;YAC7E,GAAG,MAAM;SACV,CAAA;IACH,CAAC;IACD,IAAI,MAAM,IAAI,IAAI;QAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,EAAE,CAAA;IAC5D,OAAO,SAAS,CAAA;AAClB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CAAC,KAAyB;IACnD,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;YACnB,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;gBAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAClD,CAAC;aAAM,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;YAC1B,MAAM,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACpD,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,GAAG,IAAI,SAAS,CAAA;YACnD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,IAAI,CAAC,SAAS,EAAE,CAAA;YAC/E,MAAM,CAAC,IAAI,CAAC,cAAc,IAAI,GAAG,IAAI,GAAG,CAAC,CAAA;QAC3C,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAC1B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,GAAY;IAClD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAA;IACpC,MAAM,MAAM,GAAG,GAAG,CAAA;IAClB,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,CAAA;IACpC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO,SAAS,CAAA;IAC3C,MAAM,OAAO,GAAG,UAAU,CAAA;IAE1B,MAAM,KAAK,GAAc,EAAE,CAAA;IAC3B,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QACpC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;YAC5B,IAAI,IAAI,KAAK,SAAS;gBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC1C,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAAG,WAAW,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAA;IACnD,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAA;IAE7C,MAAM,UAAU,GAAe;QAC7B,SAAS,EAAE,WAAW,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE;QAClD,yEAAyE;QACzE,2EAA2E;QAC3E,iDAAiD;QACjD,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW;QACnE,KAAK;QACL,GAAG,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,YAAY,CAAC,SAAS,CAAC,EAAE;QACxE,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE;KAC7D,CAAA;IAED,MAAM,aAAa,GAAG,MAAM,CAAC,eAAe,CAAC,CAAA;IAC7C,OAAO;QACL,OAAO,EAAE,UAAU;QACnB,GAAG,QAAQ,CAAC,aAAa,CAAC;YACxB,CAAC,CAAC,EAAE,aAAa,EAAE,aAAuD,EAAE;YAC5E,CAAC,CAAC,EAAE;QACN,GAAG,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;KACxE,CAAA;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAY;IAC/C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAA;IAC7B,MAAM,MAAM,GAAG,GAAG,CAAA;IAClB,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IAClF,MAAM,QAAQ,GAAG,OAAO,MAAM,CAAC,UAAU,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC5F,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC5D,CAAC,CAAC,SAAS,CAAA;IACb,OAAO;QACL,GAAG,WAAW,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,KAAK,SAAS;YAC/C,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,WAAW,CAAC,CAAE,EAAE;QACpD,GAAG,MAAM,KAAK,SAAS,IAAK,WAAiC,CAAC,QAAQ,CAAC,MAAM,CAAC;YAC5E,CAAC,CAAC,EAAE,MAAM,EAAE,MAAsB,EAAE;YACpC,CAAC,CAAC,EAAE;QACN,GAAG,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE;QAC7C,GAAG,WAAW,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,KAAK,SAAS;YAC/C,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,WAAW,CAAC,CAAE,EAAE;QACpD,GAAG,OAAO,MAAM,CAAC,eAAe,CAAC,KAAK,QAAQ;YAC5C,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,eAAe,CAAC,EAAE;YAC5C,CAAC,CAAC,EAAE;QACN,GAAG,WAAW,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC,KAAK,SAAS;YAC1D,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAE,EAAE;QAC1E,GAAG,OAAO,MAAM,CAAC,kBAAkB,CAAC,KAAK,SAAS;YAChD,CAAC,CAAC,EAAE,gBAAgB,EAAE,MAAM,CAAC,kBAAkB,CAAC,EAAE;YAClD,CAAC,CAAC,EAAE;KACP,CAAA;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CAAC,GAAY;IACtC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAA;IACpC,OAAO,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;AACnC,CAAC;AAED;;;;GAIG;AACH,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;AAC7E,CAAC;AAED;;;;GAIG;AACH,SAAS,WAAW,CAAC,GAAG,MAAiB;IACvC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,KAAK,CAAA;IACjE,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC"}

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