@agenticmail/openclaw 0.5.37 → 0.5.39

package/README.md

@@ -184,7 +184,7 @@ Plugin configuration lives in `~/.openclaw/openclaw.json` (user config), not in
 
 | Tool | Description |
 |------|-------------|
-| `agenticmail_assign_task` | Assign a task to another agent (async, with optional expiration) |
+| `agenticmail_call_agent` | Call another agent with a task (sync or async, auto-spawns sessions) |
 | `agenticmail_check_tasks` | Check incoming tasks (assigned to me) or outgoing tasks (I assigned) |
 | `agenticmail_claim_task` | Claim a pending task |
 | `agenticmail_submit_result` | Submit result for a claimed task |

package/REFERENCE.md

@@ -446,8 +446,6 @@ Uses SSE push with polling fallback. Returns email or task events.
 
 ### Task Queue
 
-**agenticmail_assign_task:** `{assignee, taskType?, payload?, expiresInSeconds?}`
-
 **agenticmail_check_tasks:** `{direction: "incoming"|"outgoing", assignee?}`
 
 **agenticmail_claim_task:** `{id}`

package/dist/index.js

@@ -1776,39 +1776,6 @@ ${orig.text || ""}`;
       }
     }
   });
-  reg("agenticmail_assign_task", {
-    description: "Assign a task to another agent via the task queue. The target agent can claim and process it asynchronously. More efficient than sending emails for structured work assignments.",
-    parameters: {
-      assignee: { type: "string", required: true, description: "Name of the agent to assign the task to" },
-      taskType: { type: "string", description: "Task category (default: generic)" },
-      payload: { type: "object", description: "Task data/instructions as key-value pairs" },
-      expiresInSeconds: { type: "number", description: "Task expiry in seconds (optional)" }
-    },
-    handler: async (params) => {
-      try {
-        const c = await ctxForParams(ctx, params);
-        const result = await apiRequest(c, "POST", "/tasks/assign", {
-          assignee: params.assignee,
-          taskType: params.taskType,
-          payload: params.payload,
-          expiresInSeconds: params.expiresInSeconds
-        });
-        if (result?.id && coordination?.spawnForTask) {
-          const taskPayload = {
-            task: params.payload?.task || params.payload?.description || JSON.stringify(params.payload || {}),
-            _mode: "light",
-            _async: true,
-            ...params.payload || {}
-          };
-          coordination.spawnForTask(params.assignee, result.id, taskPayload).catch(() => {
-          });
-        }
-        return result;
-      } catch (err) {
-        return { success: false, error: err.message };
-      }
-    }
-  });
   reg("agenticmail_check_tasks", {
     description: "Check for pending tasks assigned to you (or a specific agent), or tasks you assigned to others.",
     parameters: {
@@ -2978,8 +2945,8 @@ function activate(api) {
       prependLines.push(
         "<agenticmail-coordination>",
         "\u{1F380} AgenticMail coordination tools available:",
-        "- agenticmail_call_agent: Call another agent and get structured JSON result",
-        "- agenticmail_assign_task / claim_task / submit_result: Task queue with lifecycle tracking",
+        "- agenticmail_call_agent: Call another agent and get structured JSON result (preferred method)",
+        "- agenticmail_check_tasks / claim_task / submit_result / complete_task: Task queue with lifecycle tracking",
         "- agenticmail_message_agent: Message an agent by name",
         "- agenticmail_list_agents: Discover available agents",
         "- agenticmail_check_tasks: Check task status (pending/claimed/completed)",
@@ -2991,11 +2958,10 @@ function activate(api) {
       prependLines.push(
         "<agenticmail-coordination>",
         "\u{1F380} AgenticMail is installed \u2014 prefer these over sessions_spawn/sessions_send:",
-        '- agenticmail_call_agent(target, task, mode?) \u2192 RPC call, returns structured JSON. Use mode="light" for simple tasks (no email overhead).',
-        "- agenticmail_assign_task \u2192 async delegation; agenticmail_check_tasks \u2192 check status",
+        '- agenticmail_call_agent(target, task, mode?) \u2192 RPC call, returns structured JSON. Use mode="light" for simple tasks (no email overhead). Use async=true for long-running tasks.',
         "- agenticmail_message_agent \u2192 message agent by name; agenticmail_list_agents \u2192 discover agents",
-        "- agenticmail_wait_for_email \u2192 push-based wait (no polling)",
-        "call_agent auto-detects complexity: simple tasks skip email account creation entirely.",
+        "- agenticmail_check_tasks \u2192 check task status; agenticmail_wait_for_email \u2192 push-based wait (no polling)",
+        "Use call_agent for ALL agent delegation (sync and async). It auto-detects complexity and spawns sessions.",
         "</agenticmail-coordination>"
       );
     }

package/openclaw.plugin.json

@@ -54,7 +54,6 @@
     "agenticmail_message_agent",
     "agenticmail_check_messages",
     "agenticmail_wait_for_email",
-    "agenticmail_assign_task",
     "agenticmail_check_tasks",
     "agenticmail_claim_task",
     "agenticmail_submit_result",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agenticmail/openclaw",
-  "version": "0.5.37",
+  "version": "0.5.39",
   "description": "OpenClaw plugin for AgenticMail \u2014 email, SMS, and phone number access for OpenClaw agents",
   "type": "module",
   "main": "dist/index.js",

package/skill/SKILL.md

@@ -84,11 +84,11 @@ That's it. The command sets up the mail server, creates an agent account, config
 ### Agent Task Queue (5 tools)
 | Tool | Description |
 |------|-------------|
-| `agenticmail_assign_task` | Assign a task to another agent via task queue |
+| `agenticmail_call_agent` | Call another agent (sync or async). Preferred method for all delegation. |
 | `agenticmail_check_tasks` | Check pending tasks (incoming or outgoing) |
 | `agenticmail_claim_task` | Claim a pending task assigned to you |
 | `agenticmail_submit_result` | Submit result for a claimed task |
-| `agenticmail_call_agent` | Synchronous RPC call to another agent with timeout |
+| `agenticmail_complete_task` | Claim + submit in one call (for light-mode tasks) |
 
 ### Account Management (6 tools)
 | Tool | Description |
@@ -124,14 +124,14 @@ That's it. The command sets up the mail server, creates an agent account, config
 | `sessions_spawn(task)` then poll `sessions_history` | `agenticmail_call_agent(target, task)` | One call, structured JSON result back. No polling. |
 | `sessions_send(sessionKey, msg)` | `agenticmail_message_agent(name, subject, text)` | By agent name, not session key. Persistent. |
 | `sessions_list` + `sessions_history` (poll) | `agenticmail_check_tasks` or `agenticmail_wait_for_email` | Structured status tracking or push-based wait. |
-| *(no equivalent)* | `agenticmail_assign_task` | Async task delegation with lifecycle tracking. |
+| *(no equivalent)* | `agenticmail_call_agent(async=true)` | Async delegation — agent runs independently and notifies when done. |
 | *(no equivalent)* | `agenticmail_claim_task` + `agenticmail_submit_result` | Agent claims work, submits structured results. |
 | *(no equivalent)* | `agenticmail_list_agents` | Discover all available agents by name and role. |
 
 ### When to Use What
 
-- **Need a result back?** → `agenticmail_call_agent` (sync RPC, up to 5 min)
-- **Delegating work for later?** → `agenticmail_assign_task` → `agenticmail_check_tasks`
+- **Need a result back?** → `agenticmail_call_agent(target, task)` (sync RPC, up to 10 min)
+- **Delegating work for later?** → `agenticmail_call_agent(target, task, async=true)` → `agenticmail_check_tasks`
 - **Messaging an agent?** → `agenticmail_message_agent` (by name)
 - **Waiting for a reply?** → `agenticmail_wait_for_email` (push, not polling)
 - **Finding agents?** → `agenticmail_list_agents`