aamp-openclaw-plugin 0.1.33 → 0.1.35

package/openclaw.plugin.json

@@ -2,6 +2,49 @@
   "id": "aamp-openclaw-plugin",
   "kind": "channel",
   "channels": ["aamp"],
+  "channelConfigs": {
+    "aamp": {
+      "label": "AAMP",
+      "description": "AAMP mailbox channel for receiving and replying to tasks over email.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "aampHost": { "type": "string" },
+          "slug": { "type": "string", "default": "openclaw-agent" },
+          "summary": { "type": "string" },
+          "cardText": { "type": "string" },
+          "cardFile": { "type": "string" },
+          "credentialsFile": { "type": "string", "default": "~/.openclaw/extensions/aamp-openclaw-plugin/.credentials.json" },
+          "senderPolicies": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": ["sender"],
+              "properties": {
+                "sender": { "type": "string" },
+                "dispatchContextRules": {
+                  "type": "object",
+                  "additionalProperties": {
+                    "type": "array",
+                    "items": { "type": "string" }
+                  }
+                }
+              }
+            }
+          }
+        }
+      },
+      "uiHints": {
+        "aampHost": { "label": "AAMP Host", "placeholder": "https://meshmail.ai", "promptOnInstall": true },
+        "slug": { "label": "Agent Slug", "placeholder": "openclaw-agent", "promptOnInstall": false },
+        "summary": { "label": "Directory Summary", "placeholder": "Code review, debugging, and incident summaries", "promptOnInstall": false },
+        "cardText": { "label": "Card Text", "placeholder": "Detailed capability card text", "promptOnInstall": false },
+        "cardFile": { "label": "Card File", "placeholder": "/absolute/path/to/card.md", "promptOnInstall": false },
+        "credentialsFile": { "label": "Credentials File", "placeholder": "~/.openclaw/extensions/aamp-openclaw-plugin/.credentials.json", "promptOnInstall": false },
+        "senderPolicies": { "label": "Sender Policies", "placeholder": "[{\"sender\":\"meegle-bot@meshmail.ai\",\"dispatchContextRules\":{\"project_key\":[\"proj_123\"]}}]", "promptOnInstall": true }
+      }
+    }
+  },
   "extensions": ["./dist/index.js"],
   "configSchema": {
     "type": "object",

package/package.json

@@ -7,7 +7,7 @@
     "skills"
   ],
   "license": "MIT",
-  "version": "0.1.33",
+  "version": "0.1.35",
   "description": "AAMP Agent Mail Protocol — OpenClaw plugin. Gives OpenClaw an AAMP mailbox identity and lets it receive, process and reply to AAMP tasks.",
   "type": "module",
   "main": "dist/index.js",
@@ -19,6 +19,104 @@
     "extensions": [
       "./dist/index.js"
     ],
+    "channelConfigs": {
+      "aamp": {
+        "label": "AAMP",
+        "description": "AAMP mailbox channel for receiving and replying to tasks over email.",
+        "schema": {
+          "type": "object",
+          "properties": {
+            "aampHost": {
+              "type": "string",
+              "description": "AAMP service host, e.g. https://meshmail.ai"
+            },
+            "slug": {
+              "type": "string",
+              "default": "openclaw-agent",
+              "description": "Agent name prefix used in the mailbox address"
+            },
+            "summary": {
+              "type": "string",
+              "description": "Directory summary shown when other agents search for this agent"
+            },
+            "cardText": {
+              "type": "string",
+              "description": "Inline card text used for automatic card.response replies"
+            },
+            "cardFile": {
+              "type": "string",
+              "description": "Absolute path to a card text file used when cardText is not set"
+            },
+            "credentialsFile": {
+              "type": "string",
+              "default": "~/.openclaw/extensions/aamp-openclaw-plugin/.credentials.json",
+              "description": "Path to persist AAMP credentials between restarts"
+            },
+            "senderPolicies": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "required": [
+                  "sender"
+                ],
+                "properties": {
+                  "sender": {
+                    "type": "string"
+                  },
+                  "dispatchContextRules": {
+                    "type": "object",
+                    "additionalProperties": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    }
+                  }
+                }
+              },
+              "description": "Per-sender authorization policies. Each sender can optionally require exact-match X-AAMP-Dispatch-Context key/value pairs."
+            }
+          }
+        },
+        "uiHints": {
+          "aampHost": {
+            "label": "AAMP Host",
+            "placeholder": "https://meshmail.ai",
+            "promptOnInstall": true
+          },
+          "slug": {
+            "label": "Agent Slug",
+            "placeholder": "openclaw-agent",
+            "promptOnInstall": false
+          },
+          "summary": {
+            "label": "Directory Summary",
+            "placeholder": "Code review, debugging, and incident summaries",
+            "promptOnInstall": false
+          },
+          "cardText": {
+            "label": "Card Text",
+            "placeholder": "Detailed capability card text",
+            "promptOnInstall": false
+          },
+          "cardFile": {
+            "label": "Card File",
+            "placeholder": "/absolute/path/to/card.md",
+            "promptOnInstall": false
+          },
+          "credentialsFile": {
+            "label": "Credentials File",
+            "placeholder": "~/.openclaw/extensions/aamp-openclaw-plugin/.credentials.json",
+            "promptOnInstall": false
+          },
+          "senderPolicies": {
+            "label": "Sender Policies",
+            "placeholder": "[{\"sender\":\"meegle-bot@meshmail.ai\",\"dispatchContextRules\":{\"project_key\":[\"proj_123\"]}}]",
+            "promptOnInstall": true
+          }
+        }
+      }
+    },
     "configSchema": {
       "type": "object",
       "properties": {

package/skills/SKILL.md

@@ -210,6 +210,136 @@ the human to respond quickly.
 
 ---
 
+## Registered Command Node Mode
+
+Some AAMP nodes are backed by `aamp-cli node serve` and expose a **registered
+command** surface instead of a free-form natural-language task runner. When
+calling one of these nodes, the `task.dispatch` **email body must be JSON** and
+must follow the schema below:
+
+```json
+{
+  "kind": "registered-command/v1",
+  "command": "git.apply",
+  "args": {},
+  "inputs": [
+    {
+      "slot": "patch_file",
+      "attachmentName": "fix.diff"
+    }
+  ],
+  "stream": {
+    "mode": "full"
+  }
+}
+```
+
+Rules:
+
+1. `kind` must be exactly `registered-command/v1`.
+2. `command` must match the remote node's registered command name from its
+   directory card / capability card.
+3. `args` must conform to the schema published by that node.
+4. `inputs` are optional and only reference attachments already included with
+   the dispatch email. Use them only when the remote command card declares the
+   slot.
+5. Do **not** send raw shell commands, working directories, environment
+   variables, redirections, or arbitrary file paths.
+
+If the registered command declares a file input, attach the file to the email
+and reference it through `inputs[].attachmentName`. Example:
+
+```json
+{
+  "kind": "registered-command/v1",
+  "command": "git.apply",
+  "inputs": [
+    {
+      "slot": "patch_file",
+      "attachmentName": "fix.diff"
+    }
+  ],
+  "stream": {
+    "mode": "full"
+  }
+}
+```
+
+### Expected Result Shape
+
+The remote node replies with a `task.result` whose body is JSON:
+
+```json
+{
+  "kind": "registered-command-result/v1",
+  "command": "git.apply",
+  "status": "completed",
+  "exitCode": 0,
+  "summary": "Command git.apply completed successfully.",
+  "stdout": "",
+  "stderr": "",
+  "truncated": {
+    "stdout": false,
+    "stderr": false
+  },
+  "timing": {
+    "startedAt": "2026-04-27T08:00:00.000Z",
+    "finishedAt": "2026-04-27T08:00:00.420Z",
+    "durationMs": 420
+  }
+}
+```
+
+When `truncated.stdout` or `truncated.stderr` is `true`, the full output may be
+returned as one or more email attachments such as `git.apply-stdout.txt` or
+`git.apply-stderr.txt`. Check the result email attachments in addition to the
+JSON body.
+
+### Stream Expectations
+
+If `stream.mode` is `full` or `status-only`, expect the remote node to send:
+
+- `task.stream.opened`
+- stream `status` events
+- stream `text.delta` events for stdout/stderr when mode is `full`
+- a final stream `done` event before or near the terminal `task.result`
+
+### Detect Node Type via `card.query`
+
+Before dispatching to an unfamiliar AAMP node, send `card.query` and inspect
+the returned card text.
+
+Classify the node as a **registered-command node** only when the card clearly
+advertises the local CLI command surface. In the current implementation, the
+strongest signal is a card body that starts with `# Local Registered Commands`.
+Other supporting signals are:
+
+- one or more command sections like `## git.apply`
+- `- Working directory: ...`
+- `- Exec: ...`
+- embedded JSON blocks for `Args schema` or `Attachment slots`
+
+If those markers are present, treat the node as an `aamp-cli node serve` node
+and send `task.dispatch` with a JSON body shaped like
+`registered-command/v1`.
+
+If those markers are absent, treat the node as a normal **agent node** and
+send a natural-language task request instead of registered-command JSON.
+
+Rules:
+
+1. `card.query` is the source of truth when available. If the directory
+   summary and card disagree, trust the card.
+2. Only use registered-command mode when the card explicitly advertises it.
+   Do not guess.
+3. If the card is missing, empty, or ambiguous, prefer agent-node behavior
+   over registered-command behavior.
+
+Before calling a registered-command node, inspect its card to learn the
+accepted `command` names, argument schemas, and attachment slots.
+
+---
+
 ## Error Handling
 
 - **401** on any endpoint → credentials invalid. Delete the credentials file