dsh-a2a-server 0.1.1 → 0.3.0

package/lib/protocol/index.d.ts

@@ -1,23 +1,23 @@
 /**
- * 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.ts';
 export type { A2AContextId as A2AContextIdType, A2ATaskId as A2ATaskIdType } from './brand.ts';
-export { TERMINAL_STATES, isTerminal, } from './wire.ts';
-export type { A2AAgentCard, A2AAgentSkill, A2AArtifact, A2ADataPart, A2ADialect, A2AFilePart, A2AMessage, A2AMessageSendConfiguration, A2AMessageSendParams, A2APart, A2APushNotificationConfig, A2ARole, A2AStreamEvent, A2ATask, A2ATaskArtifactUpdateEvent, A2ATaskState, A2ATaskStatus, A2ATaskStatusUpdateEvent, A2ATextPart, } from './wire.ts';
-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.ts';
+export { A2A_PROTOCOL_VERSION, TASK_STATES, TERMINAL_STATES, isTerminal, streamArtifactUpdate, streamStatusUpdate, streamTask, } from './wire.ts';
+export type { A2AAgentCapabilities, A2AAgentCard, A2AAgentInterface, A2AAgentSkill, A2AArtifact, A2ADataPart, A2AFilePart, A2AListTasksParams, A2AListTasksResult, A2AMessage, A2APart, A2APushNotificationConfig, A2ARole, A2ASecurityRequirement, A2ASendMessageConfiguration, A2ASendMessageRequest, A2ASendMessageResponse, A2AStreamResponse, A2ATask, A2ATaskArtifactUpdateEvent, A2ATaskPushNotificationConfig, A2ATaskState, A2ATaskStatus, A2ATaskStatusUpdateEvent, A2ATextPart, } from './wire.ts';
+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.ts';
 export type { JsonRpcFailure, JsonRpcRequest, JsonRpcResponse, JsonRpcSuccess } from './jsonrpc.ts';
-export { parsePart, parseSendParams, partsToText, renderArtifactUpdate, renderStatusUpdate, renderTask, resolveMethod, } from './normalize.ts';
-export type { A2AOperation } from './normalize.ts';
-export { buildAgentCard, FALLBACK_SKILL } from './card.ts';
+export { legacyMethodReplacement, parseListTasksParams, parsePart, parseSendMessageRequest, parseTenant, partsToText, resolveMethod, } from './parse.ts';
+export type { A2AOperation } from './parse.ts';
+export { buildAgentCard, buildExtendedAgentCard, FALLBACK_SKILL } from './card.ts';
 export type { CardInput } from './card.ts';
 export { sseFrame } from './sse.ts';
-/** 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 declare function nowIso(): string;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/protocol/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AACpD,YAAY,EAAE,YAAY,IAAI,gBAAgB,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,YAAY,CAAA;AAE9F,OAAO,EACL,eAAe,EACf,UAAU,GACX,MAAM,WAAW,CAAA;AAClB,YAAY,EACV,YAAY,EACZ,aAAa,EACb,WAAW,EACX,WAAW,EACX,UAAU,EACV,WAAW,EACX,UAAU,EACV,2BAA2B,EAC3B,oBAAoB,EACpB,OAAO,EACP,yBAAyB,EACzB,OAAO,EACP,cAAc,EACd,OAAO,EACP,0BAA0B,EAC1B,YAAY,EACZ,aAAa,EACb,wBAAwB,EACxB,WAAW,GACZ,MAAM,WAAW,CAAA;AAElB,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;AACrB,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAEnG,OAAO,EACL,SAAS,EACT,eAAe,EACf,WAAW,EACX,oBAAoB,EACpB,kBAAkB,EAClB,UAAU,EACV,aAAa,GACd,MAAM,gBAAgB,CAAA;AACvB,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAElD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAC1D,YAAY,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAE1C,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAEnC,6EAA6E;AAC7E,wBAAgB,MAAM,IAAI,MAAM,CAE/B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/protocol/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AACpD,YAAY,EAAE,YAAY,IAAI,gBAAgB,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,YAAY,CAAA;AAE9F,OAAO,EACL,oBAAoB,EACpB,WAAW,EACX,eAAe,EACf,UAAU,EACV,oBAAoB,EACpB,kBAAkB,EAClB,UAAU,GACX,MAAM,WAAW,CAAA;AAClB,YAAY,EACV,oBAAoB,EACpB,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,UAAU,EACV,OAAO,EACP,yBAAyB,EACzB,OAAO,EACP,sBAAsB,EACtB,2BAA2B,EAC3B,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,EACjB,OAAO,EACP,0BAA0B,EAC1B,6BAA6B,EAC7B,YAAY,EACZ,aAAa,EACb,wBAAwB,EACxB,WAAW,GACZ,MAAM,WAAW,CAAA;AAElB,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;AACrB,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAEnG,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,SAAS,EACT,uBAAuB,EACvB,WAAW,EACX,WAAW,EACX,aAAa,GACd,MAAM,YAAY,CAAA;AACnB,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAClF,YAAY,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAE1C,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAEnC,sFAAsF;AACtF,wBAAgB,MAAM,IAAI,MAAM,CAE/B"}

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":"AAAA;;;;;;;;;;;;;;;GAeG;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;AACpD,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,KAAK,CAAA;AAChD,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,KAAK,CAAA;AACtD,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,KAAK,CAAA;AACpD,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,KAAK,CAAA;AAE/C,4DAA4D;AAC5D,MAAM,CAAC,MAAM,gBAAgB,GAAG,kBAAkB,CAAA;AA2BlD;;;;;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;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY,CAC1B,MAAc,EACd,QAAiC;IAEjC,OAAO,CAAC;YACN,OAAO,EAAE,0CAA0C;YACnD,MAAM;YACN,MAAM,EAAE,gBAAgB;YACxB,GAAG,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE;SAC9C,CAAC,CAAA;AACJ,CAAC;AAED,mFAAmF;AACnF,MAAM,OAAO,WAAY,SAAQ,KAAK;IASzB;IAEA;IAVX;;;;;;OAMG;IACH,YACW,IAAY,EACrB,OAAe,EACN,UAIL,EAAE;QAEN,KAAK,CAAC,OAAO,CAAC,CAAA;QARL,SAAI,GAAJ,IAAI,CAAQ;QAEZ,YAAO,GAAP,OAAO,CAIV;QAGN,IAAI,CAAC,IAAI,GAAG,aAAa,CAAA;IAC3B,CAAC;IAED,4DAA4D;IAC5D,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,GAAG,CAAA;IACvC,CAAC;IAED,8EAA8E;IAC9E,IAAI,IAAI;QACN,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS;YAAE,OAAO,SAAS,CAAA;QACvD,OAAO,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;IACjE,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,EAAE;QACtE,MAAM,EAAE,gBAAgB;QACxB,QAAQ,EAAE,EAAE,MAAM,EAAE;KACrB,CAAC,CAAA;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,SAAiB,EAAE,SAAiB;IACtE,OAAO,IAAI,WAAW,CACpB,yBAAyB,EACzB,4BAA4B,SAAS,2BAA2B,SAAS,EAAE,EAC3E,EAAE,MAAM,EAAE,uBAAuB,EAAE,QAAQ,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,CACxE,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,OAAO,IAAI,WAAW,CAAC,yBAAyB,EAAE,MAAM,EAAE;QACxD,MAAM,EAAE,uBAAuB;KAChC,CAAC,CAAA;AACJ,CAAC"}

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"}