@runtypelabs/a2a-aisdk-example 0.2.4 → 0.3.1

package/README.md

@@ -24,7 +24,7 @@ npx @runtypelabs/a2a-aisdk-example serve --echo
 
 This starts a server at:
 
-- Agent Card: `http://localhost:9999/.well-known/agent.json`
+- Agent Card: `http://localhost:9999/.well-known/agent-card.json`
 - A2A Endpoint: `http://localhost:9999/a2a`
 
 ### Test a time skill
@@ -35,16 +35,20 @@ curl -X POST http://localhost:9999/a2a \
   -d '{
     "jsonrpc": "2.0",
     "id": "1",
-    "method": "tasks/send",
+    "method": "message/send",
     "params": {
-      "skill": "time/day_of_week",
       "message": {
         "role": "user",
-        "parts": [{"type": "data", "data": {"date": "2025-02-04"}}]
-      }
+        "parts": [{"data": {"date": "2025-02-04"}}]
+      },
+      "metadata": { "skill": "time/day_of_week" }
     }
   }'
-# Returns: { "result": { "day": "Tuesday", ... }, "computed": { "method": "deterministic" } }
+```
+
+Returns:
+```bash
+{ "result": { "day": "Tuesday", ... }, "computed": { "method": "deterministic" } }
 ```
 
 ### Run with LLM
@@ -66,7 +70,9 @@ The server must be running first. Use two terminals:
 ```bash
 # Echo mode (no API key needed)
 npx @runtypelabs/a2a-aisdk-example serve --echo
+```
 
+```bash
 # Or with LLM (requires OPENAI_API_KEY or ANTHROPIC_API_KEY)
 OPENAI_API_KEY=sk-xxx npx @runtypelabs/a2a-aisdk-example serve
 ```
@@ -143,7 +149,7 @@ npx @runtypelabs/a2a-aisdk-example test http://localhost:9999 \
    - Go to your Product
    - Click "Add Capability" > "Connect External"
    - Enter:
-     - Agent Card URL: `http://localhost:9999/.well-known/agent.json`
+     - Agent Card URL: `http://localhost:9999/.well-known/agent-card.json`
      - A2A Endpoint URL: `http://localhost:9999/a2a`
    - Click "Connect & Add"
 
@@ -296,20 +302,22 @@ Options:
 
 ## A2A Protocol
 
-This package implements [A2A Protocol v0.3](https://a2aproject.github.io/A2A/specification/).
+This package implements [A2A Protocol v0.3](https://a2a-protocol.org/v0.3.0/specification/).
 
 ### Endpoints
 
-- `GET /.well-known/agent.json` - Agent Card discovery
+- `GET /.well-known/agent-card.json` - Agent Card discovery (also serves `/.well-known/agent.json` for backward compat)
 - `POST /a2a` - JSON-RPC endpoint
 
 ### Supported Methods
 
-- `tasks/send` - Create and execute a task (synchronous)
-- `tasks/sendSubscribe` - Create and execute a task with SSE streaming
-- `tasks/get` - Get task status
-- `tasks/cancel` - Cancel a running task
-- `ping` - Health check
+| Spec Method (preferred) | Legacy Alias | Description |
+| --- | --- | --- |
+| `message/send` | `tasks/send`, `SendMessage` | Send a message (synchronous) |
+| `message/stream` | `tasks/sendSubscribe`, `SendStreamingMessage` | Send a message with SSE streaming |
+| `GetTask` | `tasks/get` | Get task status |
+| `CancelTask` | `tasks/cancel` | Cancel a running task |
+| `ping` | | Health check |
 
 ## Vercel Deployment
 
@@ -337,7 +345,7 @@ export const POST = createA2AHandler({
   llmConfig: { provider: 'openai', model: 'gpt-4o-mini' },
 })
 
-// app/.well-known/agent.json/route.ts
+// app/.well-known/agent-card.json/route.ts
 import { createAgentCardHandler } from '@runtypelabs/a2a-aisdk-example/vercel'
 
 export const GET = createAgentCardHandler({
@@ -350,9 +358,9 @@ export const GET = createAgentCardHandler({
 
 Since Vercel functions are stateless:
 
-- `tasks/get` returns "not available" (no task storage)
-- `tasks/cancel` returns "not available" (can't cancel in-flight tasks)
-- Use `tasks/sendSubscribe` for streaming responses
+- `GetTask` returns "not available" (no task storage)
+- `CancelTask` returns "not available" (can't cancel in-flight tasks)
+- Use `message/stream` for streaming responses
 
 ## Development