@alis-build/a2a 1.0.519 → 1.0.520

package/README.md

@@ -5,7 +5,7 @@ TypeScript types and a **JSON-RPC 2.0** client for the **Agent-to-Agent (A2A)**
 ## Requirements
 
 - **Runtime**: `fetch`, `TextDecoderStream`, and `AbortSignal` (e.g. **Node.js 18+** or modern browsers).
-- **Types**: Request/response shapes use `*.AsObject` types from `lf/a2a/v1/a2a_pb` (protobuf JS).
+- **Types**: JSON-RPC request/response shapes are defined in `transport/jsonrpc/wire` for the **A2A JSON-RPC wire format** (what a conforming server expects on the wire). They differ from protobuf `*.AsObject` / grpc-web JSON field names and nesting. The generated files under `lf/a2a/v1/` remain available for gRPC/protobuf workflows.
 
 ## Installation
 
@@ -31,11 +31,18 @@ const client = new A2AClient({
   extraHeaders: { "X-Custom-Header": "value" }, // optional
 });
 
-// Unary — one JSON-RPC response
+// Unary — one JSON-RPC response (wire-format fields: `parts`, `acceptedOutputModes`, `returnImmediately`, …)
 const response = await client.sendMessage({
   tenant: "",
-  message: { text: { text: "Hello" } },
-  configuration: { acceptedOutputModesList: ["text"], blocking: true },
+  message: {
+    messageId: "00000000-0000-7000-0000-000000000001",
+    role: "ROLE_USER",
+    parts: [{ text: "Hello" }],
+  },
+  configuration: {
+    acceptedOutputModes: ["text/plain"],
+    returnImmediately: true,
+  },
 });
 
 // Streaming — SSE frames, each parsed as JSON-RPC
@@ -43,8 +50,15 @@ const controller = new AbortController();
 for await (const event of client.sendStreamingMessage(
   {
     tenant: "",
-    message: { text: { text: "Hello" } },
-    configuration: { acceptedOutputModesList: ["text"], blocking: false },
+    message: {
+      messageId: "00000000-0000-7000-0000-000000000002",
+      role: "ROLE_USER",
+      parts: [{ text: "Hello" }],
+    },
+    configuration: {
+      acceptedOutputModes: ["text/plain"],
+      returnImmediately: false,
+    },
   },
   controller.signal,
 )) {
@@ -69,7 +83,7 @@ for await (const event of client.sendStreamingMessage(
 | `sendStreamingMessage`             | `SendStreamingMessage`             | Streaming (async iterator) |
 | `subscribeToTask`                  | `SubscribeToTask`                  | Streaming (async iterator) |
 
-Push-notification and extended-card helpers mirror the A2A protobuf service surface.
+Push-notification methods use the same JSON-RPC names as the protobuf RPCs, but **request bodies** follow the JSON-RPC wire shape (e.g. `createTaskPushNotificationConfig` expects `{ taskId, config }`, not a flat protobuf `AsObject`).
 
 ## Transport (`transport/jsonrpc`)
 
@@ -126,17 +140,27 @@ import type {
   JsonRpcError,
   JsonRpcRequest,
   JsonRpcResponse,
+  SendMessageRequest,
+  StreamResponse,
+  Task,
 } from "./transport/jsonrpc";
 ```
 
-Protobuf message types (e.g. `SendMessageRequest`) live under `lf/a2a/v1/a2a_pb`.
+### Protobuf vs JSON-RPC types
+
+| Use case | Types |
+| -------- | ----- |
+| **JSON-RPC client** (`A2AClient`) | Import wire types from `./transport/jsonrpc` (e.g. `SendMessageRequest`, `Task`, `StreamResponse`). These match the **A2A JSON-RPC** payloads your server accepts. |
+| **gRPC / binary protobuf** | Generated messages under `lf/a2a/v1/a2a_pb` (`*.AsObject`, `Message`, etc.). |
+
+Do not pass protobuf `AsObject` trees to `A2AClient` methods: field names differ (`parts` vs `partsList`, `acceptedOutputModes` vs `acceptedOutputModesList`, nested push `config`, flattened `Part` JSON, etc.).
 
 ## Project layout
 
 | Path                 | Purpose                                    |
 | -------------------- | ------------------------------------------ |
 | `lf/a2a/v1/`         | Generated protobuf JS/TS (A2A API)         |
-| `transport/jsonrpc/` | JSON-RPC client, SSE parser, errors, types |
+| `transport/jsonrpc/` | JSON-RPC client, SSE parser, errors, **wire types** (`wire/`) |
 
 ## Dependencies
 

package/package.json

@@ -1,6 +1,6 @@
 {
 		"name": "@alis-build/a2a",
-		"version": "1.0.519",
+		"version": "1.0.520",
 		"description": "Protobufs generated by Alis Build",
 		"dependencies": {
 			"@alis-build/google-common-protos": "^1.7.0",

package/transport/jsonrpc/client.ts

@@ -1,21 +1,22 @@
 import { A2AClientConfig, JsonRpcRequest, JsonRpcResponse } from "./types";
-import {
+import type {
   AgentCard,
   CancelTaskRequest,
-  DeleteTaskPushNotificationConfigRequest,
+  CreateTaskPushConfigRequest,
+  DeleteTaskPushConfigRequest,
   GetExtendedAgentCardRequest,
-  GetTaskPushNotificationConfigRequest,
+  GetTaskPushConfigRequest,
   GetTaskRequest,
-  ListTaskPushNotificationConfigsRequest,
-  ListTaskPushNotificationConfigsResponse,
+  ListTaskPushConfigRequest,
+  ListTaskPushConfigResponse,
   ListTasksRequest,
   ListTasksResponse,
   SendMessageRequest,
   StreamResponse,
   SubscribeToTaskRequest,
   Task,
-  TaskPushNotificationConfig,
-} from "../../lf/a2a/v1/a2a_pb";
+  TaskPushConfig,
+} from "./wire";
 import { createProtocolError, JsonRpcTransportError } from "./errors";
 import { readSseStream } from "./sse";
 
@@ -72,38 +73,36 @@ export class A2AClient {
    * Sends a message and waits for a single complete response.
    * Use sendStreamingMessage() if the agent streams partial updates.
    */
-  async sendMessage(
-    params: SendMessageRequest.AsObject,
-  ): Promise<StreamResponse.AsObject> {
-    return this.request<StreamResponse.AsObject>(Methods.sendMessage, params);
+  async sendMessage(params: SendMessageRequest): Promise<StreamResponse> {
+    return this.request<StreamResponse>(Methods.sendMessage, params);
   }
 
   /**
    * Retrieves a task by ID.
    */
-  async getTask(params: GetTaskRequest.AsObject): Promise<Task.AsObject> {
-    return this.request<Task.AsObject>(Methods.getTask, params);
+  async getTask(params: GetTaskRequest): Promise<Task> {
+    return this.request<Task>(Methods.getTask, params);
   }
 
   /**
    * Cancels a task by ID.
    */
-  async cancelTask(params: CancelTaskRequest.AsObject): Promise<Task.AsObject> {
-    return this.request<Task.AsObject>(Methods.cancelTask, params);
+  async cancelTask(params: CancelTaskRequest): Promise<Task> {
+    return this.request<Task>(Methods.cancelTask, params);
   }
 
   /** Lists tasks, with optional filtering and pagination. */
   async listTasks(
-    params: Partial<ListTasksRequest.AsObject> = {},
-  ): Promise<ListTasksResponse.AsObject> {
-    return this.request<ListTasksResponse.AsObject>(Methods.listTasks, params);
+    params: Partial<ListTasksRequest> = {},
+  ): Promise<ListTasksResponse> {
+    return this.request<ListTasksResponse>(Methods.listTasks, params);
   }
 
   /** Retrieves a push notification config by task ID and config ID. */
   async getTaskPushNotificationConfig(
-    params: GetTaskPushNotificationConfigRequest.AsObject,
-  ): Promise<TaskPushNotificationConfig.AsObject> {
-    return this.request<TaskPushNotificationConfig.AsObject>(
+    params: GetTaskPushConfigRequest,
+  ): Promise<TaskPushConfig> {
+    return this.request<TaskPushConfig>(
       Methods.getTaskPushNotificationConfig,
       params,
     );
@@ -111,12 +110,12 @@ export class A2AClient {
 
   /**
    * Creates a push notification config for a task.
-   * The config itself is the request payload.
+   * Request body: `taskId`, nested `config`, optional `tenant`.
    */
   async createTaskPushNotificationConfig(
-    params: TaskPushNotificationConfig.AsObject,
-  ): Promise<TaskPushNotificationConfig.AsObject> {
-    return this.request<TaskPushNotificationConfig.AsObject>(
+    params: CreateTaskPushConfigRequest,
+  ): Promise<TaskPushConfig> {
+    return this.request<TaskPushConfig>(
       Methods.createTaskPushNotificationConfig,
       params,
     );
@@ -124,9 +123,9 @@ export class A2AClient {
 
   /** Lists push notification configs for a task. */
   async listTaskPushNotificationConfigs(
-    params: ListTaskPushNotificationConfigsRequest.AsObject,
-  ): Promise<ListTaskPushNotificationConfigsResponse.AsObject> {
-    return this.request<ListTaskPushNotificationConfigsResponse.AsObject>(
+    params: ListTaskPushConfigRequest,
+  ): Promise<ListTaskPushConfigResponse> {
+    return this.request<ListTaskPushConfigResponse>(
       Methods.listTaskPushNotificationConfigs,
       params,
     );
@@ -134,19 +133,16 @@ export class A2AClient {
 
   /** Deletes a push notification config. Returns void — server sends an empty result. */
   async deleteTaskPushNotificationConfig(
-    params: DeleteTaskPushNotificationConfigRequest.AsObject,
+    params: DeleteTaskPushConfigRequest,
   ): Promise<void> {
     await this.request<void>(Methods.deleteTaskPushNotificationConfig, params);
   }
 
   /** Retrieves the extended agent card. */
   async getExtendedAgentCard(
-    params: Partial<GetExtendedAgentCardRequest.AsObject> = {},
-  ): Promise<AgentCard.AsObject> {
-    return this.request<AgentCard.AsObject>(
-      Methods.getExtendedAgentCard,
-      params,
-    );
+    params: Partial<GetExtendedAgentCardRequest> = {},
+  ): Promise<AgentCard> {
+    return this.request<AgentCard>(Methods.getExtendedAgentCard, params);
   }
 
   /**
@@ -164,10 +160,10 @@ export class A2AClient {
    * @throws {JsonRpcProtocolError} On a JSON-RPC error frame (terminal).
    */
   async *sendStreamingMessage(
-    params: SendMessageRequest.AsObject,
+    params: SendMessageRequest,
     signal?: AbortSignal,
-  ): AsyncGenerator<StreamResponse.AsObject> {
-    yield* this.stream<StreamResponse.AsObject>(
+  ): AsyncGenerator<StreamResponse> {
+    yield* this.stream<StreamResponse>(
       Methods.sendStreamingMessage,
       params,
       signal,
@@ -181,10 +177,10 @@ export class A2AClient {
    * @throws {JsonRpcProtocolError} On a JSON-RPC error frame (terminal).
    */
   async *subscribeToTask(
-    params: SubscribeToTaskRequest.AsObject,
+    params: SubscribeToTaskRequest,
     signal?: AbortSignal,
-  ): AsyncGenerator<StreamResponse.AsObject> {
-    yield* this.stream<StreamResponse.AsObject>(
+  ): AsyncGenerator<StreamResponse> {
+    yield* this.stream<StreamResponse>(
       Methods.subscribeToTask,
       params,
       signal,

package/transport/jsonrpc/index.ts

@@ -27,4 +27,5 @@ export type {
   JsonRpcError,
   JsonRpcRequest,
   JsonRpcResponse,
-} from "./types";
+} from "./types";
+export type * from "./wire";

package/transport/jsonrpc/wire/agent-card.ts

@@ -0,0 +1,91 @@
+import type { JsonObject } from "./json";
+
+/** Parameters for the `GetExtendedAgentCard` JSON-RPC method. */
+export interface GetExtendedAgentCardRequest {
+  tenant?: string;
+}
+
+/** Declared optional capabilities of an agent. */
+export interface AgentCapabilities {
+  extensions?: AgentExtension[];
+  pushNotifications?: boolean;
+  streaming?: boolean;
+  extendedAgentCard?: boolean;
+}
+
+/** Declaration of a protocol extension. */
+export interface AgentExtension {
+  description?: string;
+  params?: JsonObject;
+  required?: boolean;
+  uri?: string;
+}
+
+/** Transport protocol binding at an interface URL (open string; e.g. `JSONRPC`, `GRPC`). */
+export type TransportProtocol = string;
+
+/** Protocol version string (e.g. `1.0`). */
+export type ProtocolVersion = string;
+
+/** A supported URL and protocol binding for the agent. */
+export interface AgentInterface {
+  url: string;
+  protocolBinding: TransportProtocol;
+  tenant?: string;
+  protocolVersion: ProtocolVersion;
+}
+
+/** Service provider metadata (`organization` in JSON). */
+export interface AgentProvider {
+  organization: string;
+  url: string;
+}
+
+/** A skill exposed by the agent. */
+export interface AgentSkill {
+  description: string;
+  examples?: string[];
+  id: string;
+  inputModes?: string[];
+  name: string;
+  outputModes?: string[];
+  securityRequirements?: SecurityRequirementsOptions;
+  tags: string[];
+}
+
+/** JWS signature block for an agent card. */
+export interface AgentCardSignature {
+  header?: JsonObject;
+  protected: string;
+  signature: string;
+}
+
+/**
+ * Security requirements list: each item has a `schemes` map from scheme name to required scopes.
+ */
+export type SecurityRequirementsOptions = Array<{
+  schemes: Record<string, string[]>;
+}>;
+
+/**
+ * Named security scheme definitions (OpenAPI-style); keys are scheme names.
+ */
+export type NamedSecuritySchemes = Record<string, unknown>;
+
+/** Self-describing agent manifest. */
+export interface AgentCard {
+  supportedInterfaces: AgentInterface[];
+  capabilities: AgentCapabilities;
+  defaultInputModes: string[];
+  defaultOutputModes: string[];
+  description: string;
+  documentationUrl?: string;
+  iconUrl?: string;
+  name: string;
+  provider?: AgentProvider;
+  securityRequirements?: SecurityRequirementsOptions;
+  securitySchemes?: NamedSecuritySchemes;
+  signatures?: AgentCardSignature[];
+  skills: AgentSkill[];
+  version: string;
+}

package/transport/jsonrpc/wire/common.ts

@@ -0,0 +1,212 @@
+import type { JsonObject } from "./json";
+
+/** JSON string values for a message `role` in the A2A wire format. */
+export type MessageRoleJson =
+  | "ROLE_UNSPECIFIED"
+  | "ROLE_AGENT"
+  | "ROLE_USER"
+  | "";
+
+/** JSON string values for task `state` in the A2A wire format. */
+export type TaskStateJson =
+  | "TASK_STATE_UNSPECIFIED"
+  | "TASK_STATE_SUBMITTED"
+  | "TASK_STATE_WORKING"
+  | "TASK_STATE_COMPLETED"
+  | "TASK_STATE_FAILED"
+  | "TASK_STATE_CANCELED"
+  | "TASK_STATE_INPUT_REQUIRED"
+  | "TASK_STATE_REJECTED"
+  | "TASK_STATE_AUTH_REQUIRED"
+  | "";
+
+/**
+ * A content part as JSON: a single flattened variant using `text`, `raw` (base64),
+ * `data`, or `url` (A2A JSON-RPC wire format).
+ */
+export interface Part {
+  text?: string;
+  /** Base64-encoded bytes when sent as a JSON string. */
+  raw?: string;
+  data?: unknown;
+  url?: string;
+  filename?: string;
+  mediaType?: string;
+  metadata?: JsonObject;
+}
+
+export interface Message {
+  messageId: string;
+  contextId?: string;
+  extensions?: string[];
+  metadata?: JsonObject;
+  parts: Part[];
+  referenceTaskIds?: string[];
+  role: MessageRoleJson;
+  taskId?: string;
+}
+
+export interface TaskStatus {
+  message?: Message;
+  state: TaskStateJson;
+  /** RFC3339 timestamp string. */
+  timestamp?: string;
+}
+
+export interface Artifact {
+  artifactId: string;
+  description?: string;
+  extensions?: string[];
+  metadata?: JsonObject;
+  name?: string;
+  parts: Part[];
+}
+
+export interface Task {
+  id: string;
+  artifacts?: Artifact[];
+  contextId: string;
+  history?: Message[];
+  metadata?: JsonObject;
+  status: TaskStatus;
+}
+
+export interface TaskStatusUpdateEvent {
+  contextId: string;
+  status: TaskStatus;
+  taskId: string;
+  metadata?: JsonObject;
+}
+
+export interface TaskArtifactUpdateEvent {
+  append?: boolean;
+  artifact: Artifact;
+  contextId: string;
+  lastChunk?: boolean;
+  taskId: string;
+  metadata?: JsonObject;
+}
+
+/**
+ * Unary `SendMessage` and streaming frames use the same result wrapper.
+ * At most one payload field should be set.
+ */
+export interface StreamResponse {
+  message?: Message;
+  task?: Task;
+  statusUpdate?: TaskStatusUpdateEvent;
+  artifactUpdate?: TaskArtifactUpdateEvent;
+}
+
+/** Authentication details for a push notification endpoint. */
+export interface PushAuthInfo {
+  credentials?: string;
+  scheme: string;
+}
+
+/** Push notification callback configuration. */
+export interface PushConfig {
+  id?: string;
+  authentication?: PushAuthInfo;
+  token?: string;
+  url: string;
+}
+
+/** Options for `SendMessage` / `SendStreamingMessage` (`configuration` in JSON). */
+export interface SendMessageConfig {
+  acceptedOutputModes?: string[];
+  returnImmediately?: boolean;
+  historyLength?: number;
+  pushNotificationConfig?: PushConfig;
+}
+
+/** Parameters for the `SendMessage` JSON-RPC method. */
+export interface SendMessageRequest {
+  tenant?: string;
+  configuration?: SendMessageConfig;
+  message: Message;
+  metadata?: JsonObject;
+}
+
+/** Parameters for the `GetTask` JSON-RPC method. */
+export interface GetTaskRequest {
+  tenant?: string;
+  id: string;
+  historyLength?: number;
+}
+
+/** Parameters for the `ListTasks` JSON-RPC method. */
+export interface ListTasksRequest {
+  tenant?: string;
+  contextId?: string;
+  status?: TaskStateJson;
+  pageSize?: number;
+  pageToken?: string;
+  historyLength?: number;
+  /** RFC3339 timestamp string */
+  statusTimestampAfter?: string;
+  includeArtifacts?: boolean;
+}
+
+/** Result of the `ListTasks` JSON-RPC method. */
+export interface ListTasksResponse {
+  tasks: Task[];
+  totalSize: number;
+  pageSize: number;
+  nextPageToken: string;
+}
+
+/** Parameters for the `CancelTask` JSON-RPC method. */
+export interface CancelTaskRequest {
+  tenant?: string;
+  id: string;
+  metadata?: JsonObject;
+}
+
+/** Parameters for the `SubscribeToTask` JSON-RPC method. */
+export interface SubscribeToTaskRequest {
+  tenant?: string;
+  id: string;
+}
+
+/** Push configuration associated with a task. */
+export interface TaskPushConfig {
+  tenant?: string;
+  config: PushConfig;
+  taskId: string;
+}
+
+/** Parameters for `GetTaskPushNotificationConfig`. */
+export interface GetTaskPushConfigRequest {
+  tenant?: string;
+  taskId: string;
+  id: string;
+}
+
+/** Parameters for `ListTaskPushNotificationConfigs`. */
+export interface ListTaskPushConfigRequest {
+  tenant?: string;
+  taskId: string;
+  pageSize?: number;
+  pageToken?: string;
+}
+
+/** Result of `ListTaskPushNotificationConfigs`. */
+export interface ListTaskPushConfigResponse {
+  configs: TaskPushConfig[];
+  nextPageToken?: string;
+}
+
+/** Parameters for `CreateTaskPushNotificationConfig`. */
+export interface CreateTaskPushConfigRequest {
+  tenant?: string;
+  config: PushConfig;
+  taskId: string;
+}
+
+/** Parameters for `DeleteTaskPushNotificationConfig`. */
+export interface DeleteTaskPushConfigRequest {
+  tenant?: string;
+  taskId: string;
+  id: string;
+}

package/transport/jsonrpc/wire/index.ts

@@ -0,0 +1,52 @@
+/**
+ * A2A JSON-RPC wire types.
+ *
+ * Request `params` include: `SendMessageRequest`, `GetTaskRequest`, `ListTasksRequest`,
+ * `CancelTaskRequest`, `SubscribeToTaskRequest`, push config requests, `GetExtendedAgentCardRequest`.
+ *
+ * Response `result` shapes include: `StreamResponse`, `Task`, `ListTasksResponse`,
+ * `ListTaskPushConfigResponse`, `TaskPushConfig`, `AgentCard`, etc.
+ */
+
+export type { JsonObject } from "./json";
+export type {
+  Artifact,
+  CancelTaskRequest,
+  CreateTaskPushConfigRequest,
+  DeleteTaskPushConfigRequest,
+  GetTaskPushConfigRequest,
+  GetTaskRequest,
+  ListTaskPushConfigRequest,
+  ListTaskPushConfigResponse,
+  ListTasksRequest,
+  ListTasksResponse,
+  Message,
+  MessageRoleJson,
+  Part,
+  PushAuthInfo,
+  PushConfig,
+  SendMessageConfig,
+  SendMessageRequest,
+  StreamResponse,
+  SubscribeToTaskRequest,
+  Task,
+  TaskArtifactUpdateEvent,
+  TaskPushConfig,
+  TaskStateJson,
+  TaskStatus,
+  TaskStatusUpdateEvent,
+} from "./common";
+export type {
+  AgentCapabilities,
+  AgentCard,
+  AgentCardSignature,
+  AgentExtension,
+  AgentInterface,
+  AgentProvider,
+  AgentSkill,
+  GetExtendedAgentCardRequest,
+  NamedSecuritySchemes,
+  ProtocolVersion,
+  SecurityRequirementsOptions,
+  TransportProtocol,
+} from "./agent-card";

package/transport/jsonrpc/wire/json.ts

@@ -0,0 +1,5 @@
+/**
+ * Arbitrary JSON object for extension metadata and other open-ended key/value
+ * fields in the A2A JSON-RPC wire format.
+ */
+export type JsonObject = Record<string, unknown>;

package/transport/jsonrpc/wire/wire.test.ts

@@ -0,0 +1,70 @@
+import { describe, expect, it } from "vitest";
+import type { CreateTaskPushConfigRequest, Part, SendMessageRequest } from "./index";
+
+/** Golden part payloads for the JSON-RPC wire format (flattened `text` / `raw` / `data` / `url`). */
+const PARTS_JSON = [
+  `{"text":"hello, world"}`,
+  `{"data":{"foo":"bar"}}`,
+  `{"filename":"foo","url":"https://cats.com/1.png"}`,
+  `{"filename":"foo","mediaType":"image/png","raw":"//4="}`,
+  `{"metadata":{"foo":"bar"},"text":"42"}`,
+];
+
+describe("JSON-RPC wire types", () => {
+  it("round-trips Part JSON (flattened content fields)", () => {
+    const parsed: Part[] = PARTS_JSON.map((s) => JSON.parse(s) as Part);
+    expect(parsed).toHaveLength(5);
+    expect(parsed[0].text).toBe("hello, world");
+    expect(parsed[1].data).toEqual({ foo: "bar" });
+    expect(parsed[2].url).toBe("https://cats.com/1.png");
+    expect(parsed[3].raw).toBe("//4=");
+    for (let i = 0; i < PARTS_JSON.length; i++) {
+      expect(JSON.stringify(parsed[i])).toBe(PARTS_JSON[i]);
+    }
+  });
+
+  it("SendMessageRequest uses wire field names (not protobuf AsObject)", () => {
+    const req: SendMessageRequest = {
+      tenant: "",
+      configuration: {
+        acceptedOutputModes: ["text/plain"],
+        returnImmediately: true,
+        historyLength: 3,
+      },
+      message: {
+        messageId: "m1",
+        role: "ROLE_USER",
+        parts: [{ text: "hi" }],
+      },
+    };
+    const json = JSON.stringify(req);
+    const o = JSON.parse(json) as Record<string, unknown>;
+    expect(o.configuration).toBeDefined();
+    const cfg = o.configuration as Record<string, unknown>;
+    expect(cfg.acceptedOutputModes).toEqual(["text/plain"]);
+    expect(cfg.returnImmediately).toBe(true);
+    expect(cfg.historyLength).toBe(3);
+    expect("acceptedOutputModesList" in cfg).toBe(false);
+    expect("blocking" in cfg).toBe(false);
+    const msg = o.message as Record<string, unknown>;
+    expect(msg.parts).toEqual([{ text: "hi" }]);
+    expect("partsList" in msg).toBe(false);
+  });
+
+  it("CreateTaskPushConfigRequest uses nested config (not flat TaskPushNotificationConfig)", () => {
+    const req: CreateTaskPushConfigRequest = {
+      tenant: "t1",
+      taskId: "task-1",
+      config: {
+        id: "cfg-1",
+        url: "https://example.com/push",
+        token: "tok",
+        authentication: { scheme: "Bearer", credentials: "x" },
+      },
+    };
+    const o = JSON.parse(JSON.stringify(req)) as Record<string, unknown>;
+    expect(o.taskId).toBe("task-1");
+    expect(o.config).toBeDefined();
+    expect((o.config as { url: string }).url).toBe("https://example.com/push");
+  });
+});

package/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "strict": true,
+    "noEmit": true,
+    "skipLibCheck": true
+  },
+  "include": ["transport/**/*.ts", "vitest.config.ts"]
+}

package/vitest.config.ts

@@ -0,0 +1,7 @@
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  test: {
+    include: ["transport/**/*.test.ts"],
+  },
+});