@otterware/openclaw-otter 0.0.0-stage → 0.1.1

package/index.js

@@ -0,0 +1,62 @@
+import { randomUUID } from "node:crypto";
+import {
+  createChannelPluginBase,
+  createChatChannelPlugin,
+  defineChannelPluginEntry,
+} from "openclaw/plugin-sdk/channel-core";
+import { accountOf, inboxKey, OTTER_TARGET, pointerOf, tell } from "./otter.js";
+
+async function deliver(ctx, payload) {
+  const account = accountOf(ctx.cfg);
+  const pointer = pointerOf({ sessionKey: ctx.sessionKey, payload });
+  await tell(account, pointer, { signal: ctx.signal });
+  return { channel: "otter", messageId: randomUUID(), timestamp: pointer.at };
+}
+
+export const otterChannel = createChatChannelPlugin({
+  base: {
+    ...createChannelPluginBase({
+      id: "otter",
+      meta: { label: "Otter", blurb: "Send what your agents want you to see to Otter." },
+      capabilities: { chatTypes: ["direct"] },
+      config: {
+        listAccountIds: (cfg) => (cfg?.channels?.otter ? ["default"] : []),
+        resolveAccount: (cfg) => accountOf(cfg),
+        inspectAccount: (cfg) => {
+          const account = accountOf(cfg);
+          return {
+            enabled: account.enabled,
+            configured: Boolean(cfg?.channels?.otter),
+            tokenStatus: account.token ? "available" : "missing",
+          };
+        },
+      },
+    }),
+    messaging: {
+      targetResolver: { looksLikeId: () => true, hint: `"${OTTER_TARGET}"` },
+      // Every delivery to Otter lands in the agent's Otter session, whatever the gateway's DM scope.
+      resolveOutboundSessionRoute: ({ agentId }) => ({
+        sessionKey: inboxKey(agentId),
+        baseSessionKey: inboxKey(agentId),
+        recipientSessionExact: true,
+        peer: { kind: "direct", id: OTTER_TARGET },
+        chatType: "direct",
+        from: "otter",
+        to: OTTER_TARGET,
+      }),
+    },
+  },
+  outbound: {
+    deliveryMode: "direct",
+    resolveTarget: () => ({ ok: true, to: OTTER_TARGET }),
+    sendText: (ctx) => deliver(ctx),
+    sendPayload: (ctx) => deliver(ctx, ctx.payload),
+  },
+});
+
+export default defineChannelPluginEntry({
+  id: "otter",
+  name: "Otter",
+  description: "Send what your agents want you to see to Otter.",
+  plugin: otterChannel,
+});

package/openclaw.plugin.json

@@ -0,0 +1,25 @@
+{
+  "id": "otter",
+  "name": "Otter",
+  "description": "Send what your agents want you to see to Otter.",
+  "activation": { "onStartup": true },
+  "channels": ["otter"],
+  "configSchema": { "type": "object", "additionalProperties": false, "properties": {} },
+  "channelConfigs": {
+    "otter": {
+      "schema": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "enabled": { "type": "boolean" },
+          "relayUrl": { "type": "string" },
+          "token": { "type": "string" }
+        }
+      },
+      "uiHints": {
+        "relayUrl": { "label": "Otter relay" },
+        "token": { "label": "Otter channel token", "sensitive": true }
+      }
+    }
+  }
+}

package/otter.js

@@ -0,0 +1,58 @@
+// What the plugin does, apart from OpenClaw's SDK, so Otter's tests can run it.
+
+/** Where an agent's deliveries to Otter are kept: one session per agent, read by Otter's apps. */
+export const inboxKey = (agentId) => `agent:${agentId}:otter:inbox`;
+
+export const OTTER_TARGET = "inbox";
+
+export const agentOf = (sessionKey) =>
+  typeof sessionKey === "string" && sessionKey.startsWith("agent:")
+    ? sessionKey.split(":")[1]
+    : undefined;
+
+/**
+ * What the relay is told of a delivery: never its text, only where to read it.
+ * Otter's apps read it from the gateway themselves.
+ */
+export function pointerOf({ sessionKey, payload, at = Date.now() }) {
+  const data = payload?.channelData ?? {};
+  const approval = data.execApproval;
+  const question = data.askUser;
+  const session = approval?.sessionKey ?? sessionKey;
+  const agentId = approval?.agentId ?? agentOf(session) ?? "main";
+  return {
+    kind: approval ? "approval" : question ? "question" : "message",
+    agentId,
+    sessionKey: approval || question ? (session ?? null) : inboxKey(agentId),
+    ...(approval && {
+      approvalId: String(approval.approvalId),
+      approvalKind: approval.approvalKind === "plugin" ? "plugin" : "exec",
+      resolved: approval.state === "resolved",
+    }),
+    ...(question && { questionId: String(question.questionId) }),
+    at,
+  };
+}
+
+export function accountOf(cfg) {
+  const section = cfg?.channels?.otter ?? {};
+  return {
+    accountId: "default",
+    enabled: section.enabled !== false,
+    relayUrl: typeof section.relayUrl === "string" ? section.relayUrl.replace(/\/+$/, "") : "",
+    token: typeof section.token === "string" ? section.token : "",
+  };
+}
+
+/** Tells Otter's devices; the delivery itself is already kept on the gateway. */
+export async function tell(account, pointer, { fetch = globalThis.fetch, signal } = {}) {
+  if (!account.relayUrl || !account.token) return false;
+  const response = await fetch(`${account.relayUrl}/channel/v1/pointers`, {
+    method: "POST",
+    signal,
+    headers: { "content-type": "application/json", authorization: `Bearer ${account.token}` },
+    body: JSON.stringify(pointer),
+  });
+  if (!response.ok) throw new Error(`Otter's relay answered ${response.status}`);
+  return true;
+}

package/package.json

@@ -1,6 +1,36 @@
 {
   "name": "@otterware/openclaw-otter",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "Otter as an OpenClaw channel: what your agents send you waits in Otter, and Otter tells your devices.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/otterware-app/otter-mail.git",
+    "directory": "extensions/openclaw/gateway"
+  },
+  "files": [
+    "index.js",
+    "otter.js",
+    "openclaw.plugin.json"
+  ],
+  "type": "module",
+  "peerDependencies": {
+    "openclaw": ">=2026.11.1"
+  },
+  "openclaw": {
+    "extensions": [
+      "./index.js"
+    ],
+    "channel": {
+      "id": "otter",
+      "label": "Otter",
+      "blurb": "Send what your agents want you to see to Otter."
+    },
+    "compat": {
+      "pluginApi": ">=2026.11.1"
+    },
+    "build": {
+      "openclawVersion": "2026.11.1"
+    }
+  }
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.