@a2a-js/sdk 0.3.7 → 0.3.8

package/dist/server/express/index.js

@@ -1,19 +1,30 @@
 import {
   A2A_ERROR_CODE,
+  AgentCard,
+  FromProto,
+  ListTaskPushNotificationConfigResponse,
   SSE_HEADERS,
+  SendMessageRequest,
+  SendMessageResponse,
+  StreamResponse,
+  Task,
+  TaskPushNotificationConfig,
+  ToProto,
   formatSSEErrorEvent,
   formatSSEEvent
-} from "../../chunk-SJNAG4AL.js";
+} from "../../chunk-DHC2REQH.js";
 import {
   AGENT_CARD_PATH,
   HTTP_EXTENSION_HEADER
 } from "../../chunk-3QDLXHKS.js";
 import {
-  A2AError,
   JsonRpcTransportHandler,
   ServerCallContext,
   UnauthenticatedUser
-} from "../../chunk-LTPINR5K.js";
+} from "../../chunk-NUQQPJNY.js";
+import {
+  A2AError
+} from "../../chunk-UHZEIZLS.js";
 import {
   Extensions
 } from "../../chunk-ZX6KNMCP.js";
@@ -469,13 +480,16 @@ function restHandler(options) {
       res.setHeader(HTTP_EXTENSION_HEADER, Array.from(context.activatedExtensions));
     }
   };
-  const sendResponse = (res, statusCode, context, body) => {
+  const sendResponse = (res, statusCode, context, body, responseType) => {
     setExtensionsHeader(res, context);
     res.status(statusCode);
     if (statusCode === HTTP_STATUS.NO_CONTENT) {
       res.end();
     } else {
-      res.json(body);
+      if (!responseType) {
+        throw new Error("Bug: toJson serializer must be provided for non-204 responses.");
+      }
+      res.json(responseType.toJSON(body));
     }
   };
   const sendStreamResponse = async (res, stream, context) => {
@@ -496,10 +510,14 @@ function restHandler(options) {
     res.flushHeaders();
     try {
       if (!firstResult.done) {
-        res.write(formatSSEEvent(firstResult.value));
+        const proto = ToProto.messageStreamResult(firstResult.value);
+        const result = StreamResponse.toJSON(proto);
+        res.write(formatSSEEvent(result));
       }
       for await (const event of { [Symbol.asyncIterator]: () => iterator }) {
-        res.write(formatSSEEvent(event));
+        const proto = ToProto.messageStreamResult(event);
+        const result = StreamResponse.toJSON(proto);
+        res.write(formatSSEEvent(result));
       }
     } catch (streamError) {
       console.error("SSE streaming error:", streamError);
@@ -540,22 +558,34 @@ function restHandler(options) {
     asyncHandler(async (req, res) => {
       const context = await buildContext(req);
       const result = await restTransportHandler.getAuthenticatedExtendedAgentCard(context);
-      sendResponse(res, HTTP_STATUS.OK, context, result);
+      const protoResult = ToProto.agentCard(result);
+      sendResponse(res, HTTP_STATUS.OK, context, protoResult, AgentCard);
     })
   );
   router.post(
     "/v1/message\\:send",
     asyncHandler(async (req, res) => {
       const context = await buildContext(req);
-      const result = await restTransportHandler.sendMessage(req.body, context);
-      sendResponse(res, HTTP_STATUS.CREATED, context, result);
+      const protoReq = SendMessageRequest.fromJSON(req.body);
+      const params = FromProto.messageSendParams(protoReq);
+      const result = await restTransportHandler.sendMessage(params, context);
+      const protoResult = ToProto.messageSendResult(result);
+      sendResponse(
+        res,
+        HTTP_STATUS.CREATED,
+        context,
+        protoResult,
+        SendMessageResponse
+      );
     })
   );
   router.post(
     "/v1/message\\:stream",
     asyncHandler(async (req, res) => {
       const context = await buildContext(req);
-      const stream = await restTransportHandler.sendMessageStream(req.body, context);
+      const protoReq = SendMessageRequest.fromJSON(req.body);
+      const params = FromProto.messageSendParams(protoReq);
+      const stream = await restTransportHandler.sendMessageStream(params, context);
       await sendStreamResponse(res, stream, context);
     })
   );
@@ -566,9 +596,11 @@ function restHandler(options) {
       const result = await restTransportHandler.getTask(
         req.params.taskId,
         context,
-        req.query.historyLength
+        //TODO: clarify for version 1.0.0 the format of the historyLength query parameter, and if history should always be added to the returned object
+        req.query.historyLength ?? req.query.history_length
       );
-      sendResponse(res, HTTP_STATUS.OK, context, result);
+      const protoResult = ToProto.task(result);
+      sendResponse(res, HTTP_STATUS.OK, context, protoResult, Task);
     })
   );
   router.post(
@@ -576,7 +608,8 @@ function restHandler(options) {
     asyncHandler(async (req, res) => {
       const context = await buildContext(req);
       const result = await restTransportHandler.cancelTask(req.params.taskId, context);
-      sendResponse(res, HTTP_STATUS.ACCEPTED, context, result);
+      const protoResult = ToProto.task(result);
+      sendResponse(res, HTTP_STATUS.ACCEPTED, context, protoResult, Task);
     })
   );
   router.post(
@@ -597,7 +630,14 @@ function restHandler(options) {
         task_id: req.params.taskId
       };
       const result = await restTransportHandler.setTaskPushNotificationConfig(config, context);
-      sendResponse(res, HTTP_STATUS.CREATED, context, result);
+      const protoResult = ToProto.taskPushNotificationConfig(result);
+      sendResponse(
+        res,
+        HTTP_STATUS.CREATED,
+        context,
+        protoResult,
+        TaskPushNotificationConfig
+      );
     })
   );
   router.get(
@@ -608,7 +648,14 @@ function restHandler(options) {
         req.params.taskId,
         context
       );
-      sendResponse(res, HTTP_STATUS.OK, context, result);
+      const protoResult = ToProto.listTaskPushNotificationConfig(result);
+      sendResponse(
+        res,
+        HTTP_STATUS.OK,
+        context,
+        protoResult,
+        ListTaskPushNotificationConfigResponse
+      );
     })
   );
   router.get(
@@ -620,7 +667,14 @@ function restHandler(options) {
         req.params.configId,
         context
       );
-      sendResponse(res, HTTP_STATUS.OK, context, result);
+      const protoResult = ToProto.taskPushNotificationConfig(result);
+      sendResponse(
+        res,
+        HTTP_STATUS.OK,
+        context,
+        protoResult,
+        TaskPushNotificationConfig
+      );
     })
   );
   router.delete(

package/dist/server/index.js

@@ -1,9 +1,11 @@
 import {
-  A2AError,
   JsonRpcTransportHandler,
   ServerCallContext,
   UnauthenticatedUser
-} from "../chunk-LTPINR5K.js";
+} from "../chunk-NUQQPJNY.js";
+import {
+  A2AError
+} from "../chunk-UHZEIZLS.js";
 import "../chunk-ZX6KNMCP.js";
 
 // src/server/agent_execution/request_context.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a2a-js/sdk",
-  "version": "0.3.7",
+  "version": "0.3.8",
   "description": "Server & Client SDK for Agent2Agent protocol",
   "license": "Apache-2.0",
   "repository": {
@@ -13,6 +13,19 @@
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "module",
+  "typesVersions": {
+    "*": {
+      "server": [
+        "./dist/server/index.d.ts"
+      ],
+      "server/express": [
+        "./dist/server/express/index.d.ts"
+      ],
+      "client": [
+        "./dist/client/index.d.ts"
+      ]
+    }
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",

package/dist/chunk-SJNAG4AL.js

@@ -1,122 +0,0 @@
-// src/errors.ts
-var A2A_ERROR_CODE = {
-  PARSE_ERROR: -32700,
-  INVALID_REQUEST: -32600,
-  METHOD_NOT_FOUND: -32601,
-  INVALID_PARAMS: -32602,
-  INTERNAL_ERROR: -32603,
-  TASK_NOT_FOUND: -32001,
-  TASK_NOT_CANCELABLE: -32002,
-  PUSH_NOTIFICATION_NOT_SUPPORTED: -32003,
-  UNSUPPORTED_OPERATION: -32004,
-  CONTENT_TYPE_NOT_SUPPORTED: -32005,
-  INVALID_AGENT_RESPONSE: -32006,
-  AUTHENTICATED_EXTENDED_CARD_NOT_CONFIGURED: -32007
-};
-var TaskNotFoundError = class extends Error {
-  constructor(message) {
-    super(message ?? "Task not found");
-    this.name = "TaskNotFoundError";
-  }
-};
-var TaskNotCancelableError = class extends Error {
-  constructor(message) {
-    super(message ?? "Task cannot be canceled");
-    this.name = "TaskNotCancelableError";
-  }
-};
-var PushNotificationNotSupportedError = class extends Error {
-  constructor(message) {
-    super(message ?? "Push Notification is not supported");
-    this.name = "PushNotificationNotSupportedError";
-  }
-};
-var UnsupportedOperationError = class extends Error {
-  constructor(message) {
-    super(message ?? "This operation is not supported");
-    this.name = "UnsupportedOperationError";
-  }
-};
-var ContentTypeNotSupportedError = class extends Error {
-  constructor(message) {
-    super(message ?? "Incompatible content types");
-    this.name = "ContentTypeNotSupportedError";
-  }
-};
-var InvalidAgentResponseError = class extends Error {
-  constructor(message) {
-    super(message ?? "Invalid agent response type");
-    this.name = "InvalidAgentResponseError";
-  }
-};
-var AuthenticatedExtendedCardNotConfiguredError = class extends Error {
-  constructor(message) {
-    super(message ?? "Authenticated Extended Card not configured");
-    this.name = "AuthenticatedExtendedCardNotConfiguredError";
-  }
-};
-
-// src/sse_utils.ts
-var SSE_HEADERS = {
-  "Content-Type": "text/event-stream",
-  "Cache-Control": "no-cache",
-  Connection: "keep-alive",
-  "X-Accel-Buffering": "no"
-  // Disable buffering in nginx
-};
-function formatSSEEvent(event) {
-  return `data: ${JSON.stringify(event)}
-
-`;
-}
-function formatSSEErrorEvent(error) {
-  return `event: error
-data: ${JSON.stringify(error)}
-
-`;
-}
-async function* parseSseStream(response) {
-  if (!response.body) {
-    throw new Error("SSE response body is undefined. Cannot read stream.");
-  }
-  let buffer = "";
-  let eventType = "message";
-  let eventData = "";
-  for await (const value of response.body.pipeThrough(new TextDecoderStream())) {
-    buffer += value;
-    let lineEndIndex;
-    while ((lineEndIndex = buffer.indexOf("\n")) >= 0) {
-      const line = buffer.substring(0, lineEndIndex).trim();
-      buffer = buffer.substring(lineEndIndex + 1);
-      if (line === "") {
-        if (eventData) {
-          yield { type: eventType, data: eventData };
-          eventData = "";
-          eventType = "message";
-        }
-      } else if (line.startsWith("event:")) {
-        eventType = line.substring("event:".length).trim();
-      } else if (line.startsWith("data:")) {
-        eventData = line.substring("data:".length).trim();
-      }
-    }
-  }
-  if (eventData) {
-    yield { type: eventType, data: eventData };
-  }
-}
-
-export {
-  A2A_ERROR_CODE,
-  TaskNotFoundError,
-  TaskNotCancelableError,
-  PushNotificationNotSupportedError,
-  UnsupportedOperationError,
-  ContentTypeNotSupportedError,
-  InvalidAgentResponseError,
-  AuthenticatedExtendedCardNotConfiguredError,
-  SSE_HEADERS,
-  formatSSEEvent,
-  formatSSEErrorEvent,
-  parseSseStream
-};