@aramisfa/openclaw-a2a-outbound 1.0.0 → 3.0.0

package/dist/task-handle-registry.js

@@ -1,5 +1,13 @@
 import { randomUUID } from "node:crypto";
 import { A2AOutboundError, ERROR_CODES, } from "./errors.js";
+function continuationTargetFromResolvedTarget(target) {
+    return {
+        target_url: target.baseUrl,
+        card_path: target.cardPath,
+        preferred_transports: [...target.preferredTransports],
+        ...(target.alias !== undefined ? { target_alias: target.alias } : {}),
+    };
+}
 function cloneTarget(target) {
     return {
         baseUrl: target.baseUrl,
@@ -22,6 +30,7 @@ function cloneRecord(record) {
         taskHandle: record.taskHandle,
         target: cloneTarget(record.target),
         taskId: record.taskId,
+        ...(record.contextId !== undefined ? { contextId: record.contextId } : {}),
         createdAt: record.createdAt,
         lastAccessedAt: record.lastAccessedAt,
         expiresAt: record.expiresAt,
@@ -40,11 +49,28 @@ function unknownTaskHandleError(taskHandle) {
         suggested_action: "send",
     }));
 }
-function expiredTaskHandleError(taskHandle, expiresAt) {
-    return new A2AOutboundError(ERROR_CODES.EXPIRED_TASK_HANDLE, `task handle "${taskHandle}" has expired`, recoveryDetails(taskHandle, {
-        expiresAt,
+function expiredTaskHandleError(record) {
+    return new A2AOutboundError(ERROR_CODES.EXPIRED_TASK_HANDLE, `task handle "${record.taskHandle}" has expired`, recoveryDetails(record.taskHandle, {
+        expiresAt: record.expiresAt,
+        task_id: record.taskId,
+        ...(record.contextId !== undefined
+            ? { context_id: record.contextId }
+            : {}),
+        continuation: {
+            target: continuationTargetFromResolvedTarget(record.target),
+            task: {
+                task_id: record.taskId,
+            },
+            ...(record.contextId !== undefined
+                ? {
+                    conversation: {
+                        context_id: record.contextId,
+                    },
+                }
+                : {}),
+        },
         suggested_actions: ["status", "send"],
-        hint: "Retry with target_alias + task_id, or send a new request.",
+        hint: "Retry with the persisted continuation, or resend the original request after a restart to obtain a new handle.",
     }));
 }
 export class TaskHandleRegistry {
@@ -64,6 +90,7 @@ export class TaskHandleRegistry {
             taskHandle: `rah_${randomUUID()}`,
             target: cloneTarget(input.target),
             taskId: input.taskId,
+            ...(input.contextId !== undefined ? { contextId: input.contextId } : {}),
             createdAt: now,
             lastAccessedAt: now,
             expiresAt: now + this.ttlMs,
@@ -90,6 +117,11 @@ export class TaskHandleRegistry {
             taskHandle: entry.taskHandle,
             target: cloneTarget(input.target ?? entry.target),
             taskId: input.taskId ?? entry.taskId,
+            ...(input.contextId !== undefined
+                ? { contextId: input.contextId }
+                : entry.contextId !== undefined
+                    ? { contextId: entry.contextId }
+                    : {}),
             createdAt: entry.createdAt,
             lastAccessedAt: now,
             expiresAt: now + this.ttlMs,
@@ -103,7 +135,7 @@ export class TaskHandleRegistry {
         const wasExpired = existing !== undefined && existing.expiresAt <= now;
         this.pruneExpired(now);
         if (wasExpired && existing) {
-            throw expiredTaskHandleError(taskHandle, existing.expiresAt);
+            throw expiredTaskHandleError(existing);
         }
         const live = this.entries.get(taskHandle);
         if (!live) {

package/dist/task-handle-registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"task-handle-registry.js","sourceRoot":"","sources":["../src/task-handle-registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"task-handle-registry.js","sourceRoot":"","sources":["../src/task-handle-registry.ts"],"names":[],"mappings":"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"}

package/openclaw.plugin.json

@@ -1,15 +1,20 @@
 {
   "id": "openclaw-a2a-outbound",
   "name": "External A2A Delegation",
-  "version": "1.0.0",
+  "version": "3.0.0",
   "entry": "./dist/index.js",
   "description": "Delegate requests to external A2A agents and manage delegated tasks.",
-  "skills": ["./skills"],
+  "skills": [
+    "./skills"
+  ],
   "configSchema": {
     "type": "object",
     "additionalProperties": false,
     "properties": {
-      "enabled": { "type": "boolean", "default": false },
+      "enabled": {
+        "type": "boolean",
+        "default": false
+      },
       "defaults": {
         "type": "object",
         "additionalProperties": false,
@@ -27,13 +32,22 @@
             "type": "array",
             "items": {
               "type": "string",
-              "enum": ["JSONRPC", "HTTP+JSON", "GRPC"]
+              "enum": [
+                "JSONRPC",
+                "HTTP+JSON",
+                "GRPC"
+              ]
             },
-            "default": ["JSONRPC", "HTTP+JSON"]
+            "default": [
+              "JSONRPC",
+              "HTTP+JSON"
+            ]
           },
           "serviceParameters": {
             "type": "object",
-            "additionalProperties": { "type": "string" },
+            "additionalProperties": {
+              "type": "string"
+            },
             "default": {}
           }
         }
@@ -44,7 +58,10 @@
         "items": {
           "type": "object",
           "additionalProperties": false,
-          "required": ["alias", "baseUrl"],
+          "required": [
+            "alias",
+            "baseUrl"
+          ],
           "properties": {
             "alias": {
               "type": "string"
@@ -57,7 +74,9 @@
             },
             "tags": {
               "type": "array",
-              "items": { "type": "string" },
+              "items": {
+                "type": "string"
+              },
               "default": []
             },
             "cardPath": {
@@ -68,13 +87,22 @@
               "type": "array",
               "items": {
                 "type": "string",
-                "enum": ["JSONRPC", "HTTP+JSON", "GRPC"]
+                "enum": [
+                  "JSONRPC",
+                  "HTTP+JSON",
+                  "GRPC"
+                ]
               },
-              "default": ["JSONRPC", "HTTP+JSON"]
+              "default": [
+                "JSONRPC",
+                "HTTP+JSON"
+              ]
             },
             "examples": {
               "type": "array",
-              "items": { "type": "string" },
+              "items": {
+                "type": "string"
+              },
               "default": []
             },
             "default": {
@@ -106,7 +134,9 @@
         "properties": {
           "acceptedOutputModes": {
             "type": "array",
-            "items": { "type": "string" },
+            "items": {
+              "type": "string"
+            },
             "default": []
           },
           "normalizeBaseUrl": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aramisfa/openclaw-a2a-outbound",
-  "version": "1.0.0",
+  "version": "3.0.0",
   "description": "Outbound A2A delegation plugin for OpenClaw agents",
   "license": "MIT",
   "repository": {
@@ -41,15 +41,6 @@
       "./dist/index.js"
     ]
   },
-  "scripts": {
-    "build": "tsc -b",
-    "typecheck:src": "tsc -b --pretty false",
-    "typecheck:tests": "tsc -p tsconfig.tests.json --pretty false",
-    "typecheck": "corepack pnpm run typecheck:src && corepack pnpm run typecheck:tests",
-    "test": "corepack pnpm run build && node --import tsx --test tests/*.test.ts",
-    "clean": "rm -rf dist",
-    "prepublishOnly": "node ../../scripts/publish-guard.cjs package --package=@aramisfa/openclaw-a2a-outbound"
-  },
   "dependencies": {
     "@a2a-js/sdk": "^0.3.10",
     "ajv": "^8.18.0",
@@ -68,5 +59,13 @@
   },
   "publishConfig": {
     "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "typecheck:src": "tsc -b --pretty false",
+    "typecheck:tests": "tsc -p tsconfig.tests.json --pretty false",
+    "typecheck": "corepack pnpm run typecheck:src && corepack pnpm run typecheck:tests",
+    "test": "corepack pnpm run build && node --import tsx --test tests/*.test.ts",
+    "clean": "rm -rf dist"
   }
-}
+}

package/skills/remote-agent/SKILL.md

@@ -1,12 +1,14 @@
 ---
 name: remote-agent
 description: Delegate work to external A2A agents using the remote_agent tool.
-metadata: {"openclaw": {"requires": {"config": ["plugins.entries.openclaw-a2a-outbound.enabled"]}}}
+metadata: {"openclaw": {"requires": {"config": ["plugins.entries.openclaw-a2a-outbound.enabled", "plugins.entries.openclaw-a2a-outbound.config.enabled"]}}}
 ---
 
 # Remote Agent Delegation
 
-Use the `remote_agent` tool to delegate work to external A2A-compatible agents and manage delegated tasks.
+If the plugin is not installed or configured yet, use the `a2a-delegation-setup` skill first.
+
+Use the `remote_agent` tool to delegate work to external A2A-compatible agents and manage delegated tasks. `send` is the only action to start a new remote turn or continue an existing one.
 
 ## When to delegate
 
@@ -38,28 +40,99 @@ Discover configured targets.
 
 ### send
 
-Send a request to a remote agent.
+Send a request to a remote agent. Use it for:
+
+- a brand-new remote task
+- a follow-up turn on an existing remote task
+- a related new task that references prior work
+- a new task inside an existing remote conversation
 
 ```json
 {
   "action": "send",
   "target_alias": "my-agent",
-  "input": "Summarize the latest quarterly report.",
+  "parts": [
+    {
+      "kind": "text",
+      "text": "Summarize the latest quarterly report."
+    }
+  ],
   "follow_updates": true
 }
 ```
 
-- `input` (required): the user text to send.
+- `parts` (required): non-empty array of `text`, `file`, or `data` parts.
 - `target_alias`: configured target name. Omit when a default target exists.
-- `follow_updates`: when `true`, streams updates and returns the full event log.
-- `attachments`: optional array of file or data attachments.
+- `continuation`: canonical persisted follow-up contract from `summary.continuation`. Round-trip this subtree verbatim for `send`, `watch`, `status`, and `cancel`.
+- `task_handle`: manual compatibility input for follow-up actions when you are not replaying a persisted `continuation`.
+- `task_id`: manual compatibility continuation id for `send`; for follow-up actions it identifies the remote task only when no `task_handle` is available inside a persisted `continuation`. `task_id` continues an existing task.
+- `context_id`: manual compatibility conversation continuation id for `send`. Use it with `task_id`, or by itself to start a new task in the same conversation, only when you are not replaying a persisted `continuation`.
+- `reference_task_ids`: optional related task ids for `send`. `reference_task_ids` references prior tasks without continuing them.
+- `task_requirement`: optional durability contract. `task_requirement="required"` forces explicit task creation or fails fast.
+- `follow_updates`: when `true`, streams updates and returns the full event log. `follow_updates=true` means “stream the initial send”; it does not guarantee task creation unless `task_requirement="required"`.
+- `blocking`: only for non-stream `send`; do not combine it with `follow_updates=true`.
+
+Preferred continuation forms:
+
+```json
+{ "action": "send", "continuation": { "target": { "target_url": "https://my-agent.example/", "card_path": "/.well-known/agent-card.json", "preferred_transports": ["JSONRPC", "HTTP+JSON"], "target_alias": "my-agent" }, "task": { "task_handle": "rah_abc123", "task_id": "task-123" } }, "parts": [{ "kind": "text", "text": "Approved. Continue." }] }
+```
+
+```json
+{ "action": "send", "continuation": { "target": { "target_url": "https://my-agent.example/", "card_path": "/.well-known/agent-card.json", "preferred_transports": ["JSONRPC", "HTTP+JSON"], "target_alias": "my-agent" }, "task": { "task_id": "task-123" } }, "parts": [{ "kind": "text", "text": "Continue the task." }] }
+```
+
+```json
+{ "action": "send", "continuation": { "target": { "target_url": "https://my-agent.example/", "card_path": "/.well-known/agent-card.json", "preferred_transports": ["JSONRPC", "HTTP+JSON"], "target_alias": "my-agent" }, "conversation": { "context_id": "ctx-123", "can_send": true } }, "parts": [{ "kind": "text", "text": "Start a new task in the same conversation." }] }
+```
+
+Manual compatibility only:
+
+```json
+{ "action": "send", "target_alias": "my-agent", "context_id": "ctx-123", "reference_task_ids": ["task-1", "task-2"], "parts": [{ "kind": "text", "text": "Start related work without continuing those tasks." }] }
+```
+
+## Continuation safety
+
+Interpret follow-up capability from `result.summary.continuation`, not from prompt text, message text, or other inferred context.
+
+- `response_kind` is descriptive only. Keep follow-up logic anchored to `summary.continuation`.
+- `summary.continuation.target`: canonical persisted routing contract. Persist `summary.continuation` verbatim and pass it back directly for machine follow-up.
+- `summary.continuation.task`: trackable task continuity. Use it for follow-up `send`, `watch`, `status`, and `cancel`.
+- `summary.continuation.conversation`: conversation continuity only. Use it only with `send` to start a new task in the same conversation.
+- `summary.target_*` is descriptive only and no longer part of the machine follow-up recipe.
+- Top-level compatibility aliases stay descriptive only. Do not infer task continuity from flat `task_id`, flat `context_id`, or other top-level summary fields.
+- Branch on `summary.continuation.task` vs `summary.continuation.conversation` before choosing the next action.
+- Never infer or synthesize `summary.continuation.task` from `summary.continuation.conversation`, session ids, run ids, prior prompts, or summary text.
+- Do not call `watch`, `status`, or `cancel` from a result that has only `summary.continuation.conversation`.
+- Do not poll from conversation continuity.
+- If lifecycle tracking is required, fail fast when the peer returns only `summary.continuation.conversation`.
+
+```ts
+const task = result.summary.continuation?.task
+const conversation = result.summary.continuation?.conversation
+
+if (task) {
+  // Trackable task lifecycle.
+} else if (conversation) {
+  // Send-only conversation continuity.
+}
+```
+
+Invalid follow-up example:
+
+```json
+{ "action": "status", "context_id": "ctx-123" }
+```
+
+That is invalid because `status`, `watch`, and `cancel` require task continuity, not just conversation continuity.
 
 ### status
 
 Poll the current state of a delegated task.
 
 ```json
-{ "action": "status", "task_handle": "rah_abc123" }
+{ "action": "status", "continuation": { "target": { "target_url": "https://my-agent.example/", "card_path": "/.well-known/agent-card.json", "preferred_transports": ["JSONRPC", "HTTP+JSON"], "target_alias": "my-agent" }, "task": { "task_handle": "rah_abc123", "task_id": "task-123" } } }
 ```
 
 ### watch
@@ -67,7 +140,7 @@ Poll the current state of a delegated task.
 Subscribe to live updates from a running task.
 
 ```json
-{ "action": "watch", "task_handle": "rah_abc123" }
+{ "action": "watch", "continuation": { "target": { "target_url": "https://my-agent.example/", "card_path": "/.well-known/agent-card.json", "preferred_transports": ["JSONRPC", "HTTP+JSON"], "target_alias": "my-agent" }, "task": { "task_handle": "rah_abc123", "task_id": "task-123" } } }
 ```
 
 ### cancel
@@ -75,12 +148,12 @@ Subscribe to live updates from a running task.
 Cancel a running task.
 
 ```json
-{ "action": "cancel", "task_handle": "rah_abc123" }
+{ "action": "cancel", "continuation": { "target": { "target_url": "https://my-agent.example/", "card_path": "/.well-known/agent-card.json", "preferred_transports": ["JSONRPC", "HTTP+JSON"], "target_alias": "my-agent" }, "task": { "task_handle": "rah_abc123", "task_id": "task-123" } } }
 ```
 
 ## Task handles
 
-After a successful `send`, the result includes a `task_handle` (prefixed `rah_`). Always prefer `task_handle` over `target_alias + task_id` for follow-up actions — the handle encodes the target and task identity in one opaque token. Handles are process-local and expire after restart or TTL. If a handle expires, fall back to `target_alias` + `task_id`.
+After a successful `send`, the result usually includes `summary.continuation.task.task_handle` (prefixed `rah_`) when the remote peer exposes task continuity. `task_handle` is returned only when the peer actually created a task. Persist `summary.continuation` verbatim and pass it back directly for follow-up `send`/`watch`/`status`/`cancel` actions. Handles are process-local and expire after restart or TTL, but nested `continuation` still round-trips safely because it also carries durable `summary.continuation.target` plus `summary.continuation.task.task_id`. Treat flat `send.task_id`, `send.context_id`, and `target_alias` as manual compatibility inputs, not as a replacement for nested continuation round-tripping. If the result includes only `summary.continuation.conversation`, there is no task lifecycle to poll, watch, or cancel.
 
 ## watch vs status
 
@@ -88,6 +161,6 @@ Use `watch` when the remote agent supports streaming and you want live increment
 
 ## Errors
 
-- `UNKNOWN_TASK_HANDLE` — the handle is expired or invalid. Retry with `target_alias` + `task_id`, or re-send.
+- `UNKNOWN_TASK_HANDLE` — the handle is expired or invalid. Retry with the same nested `continuation`, or re-send. Manual callers may fall back to flat `task_id` plus target routing only when they do not have a persisted `continuation`.
 - `TARGET_RESOLUTION_ERROR` — the alias or URL did not resolve. Call `list_targets` to check available targets.
 - `VALIDATION_ERROR` — invalid parameters. Check required fields for the action.