@a2a-js/sdk 0.3.7 → 0.3.9

package/README.md

@@ -29,10 +29,28 @@ If you plan to use the Express integration (imports from `@a2a-js/sdk/server/exp
 npm install express
 ```
 
+### For gRPC Usage
+
+If you plan to use the GRPC transport (imports from `@a2a-js/sdk/server/grpc` or `@a2a-js/sdk/client/grpc`), you must install the required peer dependencies:
+
+```bash
+npm install @grpc/grpc-js @bufbuild/protobuf
+```
+
 You can also find some samples [here](https://github.com/a2aproject/a2a-js/tree/main/src/samples).
 
 ---
 
+## Compatibility
+
+This SDK implements the A2A Protocol Specification [`v0.3.0`](https://a2a-protocol.org/v0.3.0/specification).
+
+| Transport | Client | Server |
+| :--- | :---: | :---: |
+| **JSON-RPC** | ✅ | ✅ |
+| **HTTP+JSON/REST** | ✅ | ✅ |
+| **GRPC** (Node.js only) | ✅ | ✅ |
+
 ## Quickstart
 
 This example shows how to create a simple "Hello World" agent server and a client to interact with it.
@@ -44,6 +62,7 @@ The core of an A2A server is the `AgentExecutor`, which contains your agent's lo
 ```typescript
 // server.ts
 import express from 'express';
+import { Server, ServerCredentials } from '@grpc/grpc-js';
 import { v4 as uuidv4 } from 'uuid';
 import { AgentCard, Message, AGENT_CARD_PATH } from '@a2a-js/sdk';
 import {
@@ -54,6 +73,7 @@ import {
   InMemoryTaskStore,
 } from '@a2a-js/sdk/server';
 import { agentCardHandler, jsonRpcHandler, restHandler, UserBuilder } from '@a2a-js/sdk/server/express';
+import { grpcService, A2AService } from '@a2a-js/sdk/server/grpc';
 
 // 1. Define your agent's identity card.
 const helloAgentCard: AgentCard = {
@@ -71,6 +91,7 @@ const helloAgentCard: AgentCard = {
   additionalInterfaces: [
     { url: 'http://localhost:4000/a2a/jsonrpc', transport: 'JSONRPC' }, // Default JSON-RPC transport
     { url: 'http://localhost:4000/a2a/rest', transport: 'HTTP+JSON' }, // HTTP+JSON/REST transport
+    { url: 'localhost:4001', transport: 'GRPC' }, // GRPC transport
   ],
 };
 
@@ -113,6 +134,15 @@ app.use('/a2a/rest', restHandler({ requestHandler, userBuilder: UserBuilder.noAu
 app.listen(4000, () => {
   console.log(`🚀 Server started on http://localhost:4000`);
 });
+
+const server = new Server();
+server.addService(A2AService, grpcService({
+  requestHandler,
+  userBuilder: UserBuilder.noAuthentication,
+}));
+server.bindAsync(`localhost:4001`, ServerCredentials.createInsecure(), () => {
+  console.log(`🚀 Server started on localhost:4001`);
+});
 ```
 
 ### Client: Sending a Message
@@ -153,6 +183,46 @@ async function run() {
 await run();
 ```
 
+### gRPC Client: Sending a Message
+
+The [`ClientFactory`](src/client/factory.ts) has to be created explicitly passing the [`GrpcTransportFactory`](src/client/transports/grpc/grpc_transport.ts).
+
+```typescript
+// client.ts
+import { ClientFactory, ClientFactoryOptions } from '@a2a-js/sdk/client';
+import { GrpcTransportFactory } from '@a2a-js/sdk/client/grpc';
+import { Message, MessageSendParams, SendMessageSuccessResponse } from '@a2a-js/sdk';
+import { v4 as uuidv4 } from 'uuid';
+
+async function run() {
+  const factory = new ClientFactory({
+    transports: [new GrpcTransportFactory()]
+  });
+
+  // createFromUrl accepts baseUrl and optional path,
+  // (the default path is /.well-known/agent-card.json)
+  const client = await factory.createFromUrl('http://localhost:4000');
+
+  const sendParams: MessageSendParams = {
+    message: {
+      messageId: uuidv4(),
+      role: 'user',
+      parts: [{ kind: 'text', text: 'Hi there!' }],
+      kind: 'message',
+    },
+  };
+
+  try {
+    const response = await client.sendMessage(sendParams);
+    const result = response as Message;
+    console.log('Agent response:', result.parts[0].text); // "Hello, world!"
+  } catch(e) {
+    console.error('Error:', e);
+  }
+}
+
+await run();
+```
 ---
 
 ## A2A `Task` Support

package/dist/{chunk-SJNAG4AL.js → chunk-EGOOH5HP.js}

@@ -56,56 +56,6 @@ var AuthenticatedExtendedCardNotConfiguredError = class extends Error {
   }
 };
 
-// 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,
@@ -114,9 +64,5 @@ export {
   UnsupportedOperationError,
   ContentTypeNotSupportedError,
   InvalidAgentResponseError,
-  AuthenticatedExtendedCardNotConfiguredError,
-  SSE_HEADERS,
-  formatSSEEvent,
-  formatSSEErrorEvent,
-  parseSseStream
+  AuthenticatedExtendedCardNotConfiguredError
 };

package/dist/chunk-F6ACNKFR.js

@@ -0,0 +1,41 @@
+import {
+  Extensions
+} from "./chunk-ZX6KNMCP.js";
+
+// src/server/context.ts
+var ServerCallContext = class {
+  _requestedExtensions;
+  _user;
+  _activatedExtensions;
+  constructor(requestedExtensions, user) {
+    this._requestedExtensions = requestedExtensions;
+    this._user = user;
+  }
+  get user() {
+    return this._user;
+  }
+  get activatedExtensions() {
+    return this._activatedExtensions;
+  }
+  get requestedExtensions() {
+    return this._requestedExtensions;
+  }
+  addActivatedExtension(uri) {
+    this._activatedExtensions = Extensions.createFrom(this._activatedExtensions, uri);
+  }
+};
+
+// src/server/authentication/user.ts
+var UnauthenticatedUser = class {
+  get isAuthenticated() {
+    return false;
+  }
+  get userName() {
+    return "";
+  }
+};
+
+export {
+  ServerCallContext,
+  UnauthenticatedUser
+};