@andocorp/openclaw-plugin 0.0.1 → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ando Corp
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,35 @@
+# @andocorp/openclaw-plugin
+
+OpenClaw adapter for Ando.
+
+Configure `channels.ando.apiKey` in OpenClaw. REST requests use
+`https://api.ando.so` unless `channels.ando.baseUrl` is set. Realtime monitoring
+uses `sokachu.ando.so` unless `channels.ando.realtimeHost` is set. MCP tool
+proxying uses `https://mcp.ando.so/mcp` unless `channels.ando.mcpUrl` is set.
+
+## Publish
+
+This package is published from the open-source Ando package monorepo. Publish
+with `pnpm` so the `@andocorp/sdk` workspace dependency is rewritten in the
+published tarball.
+
+Before publishing, publish `@andocorp/sdk@<current version>` first.
+
+From the package directory:
+
+```sh
+pnpm publish --access public --no-git-checks
+```
+
+From the repo root:
+
+```sh
+pnpm --filter @andocorp/openclaw-plugin publish --access public --no-git-checks
+```
+
+Do not publish this package with `npm`:
+
+```sh
+npm pack
+npm publish
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@andocorp/openclaw-plugin",
-  "version": "0.0.1",
+  "version": "0.1.0",
   "description": "OpenClaw adapter for Ando",
   "license": "MIT",
   "type": "module",
@@ -13,14 +13,9 @@
   "engines": {
     "node": ">=22"
   },
-  "scripts": {
-    "typecheck": "pnpm --filter @andocorp/sdk build && tsc --noEmit",
-    "test": "pnpm --filter @andocorp/sdk build && vitest run",
-    "test:boundaries": "pnpm --filter @andocorp/sdk build && vitest run src/monitor.test.ts src/channel.test.ts"
-  },
   "dependencies": {
-    "@andocorp/sdk": "workspace:*",
-    "zod": "^4.3.6"
+    "zod": "^4.3.6",
+    "@andocorp/sdk": "0.1.0"
   },
   "peerDependencies": {
     "openclaw": ">=2026.3.23"
@@ -31,13 +26,13 @@
     }
   },
   "publishConfig": {
-    "access": "restricted"
+    "access": "public"
   },
   "devDependencies": {
     "@types/node": "^24.10.9",
     "openclaw": "2026.3.23",
     "typescript": "^5.9.3",
-    "vitest": "^3.2.4"
+    "vitest": "^4.1.5"
   },
   "openclaw": {
     "extensions": [
@@ -50,5 +45,12 @@
       "docsPath": "/channels/ando",
       "blurb": "Live agent membership inside Ando conversations."
     }
+  },
+  "scripts": {
+    "build": "tsc --noEmit",
+    "lint": "tsc --noEmit",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:boundaries": "vitest run src/monitor.test.ts src/channel.test.ts"
   }
-}
+}

package/src/channel.ts

@@ -6,7 +6,10 @@ import {
 import packageJson from "../package.json" with { type: "json" };
 import { DEFAULT_ACCOUNT_ID } from "openclaw/plugin-sdk/account-resolution";
 import { createTopLevelChannelConfigBase } from "openclaw/plugin-sdk/channel-config-helpers";
-import { formatAndoTarget, parseAndoTarget } from "@andocorp/sdk";
+import {
+  DEFAULT_ANDO_BASE_URL, DEFAULT_ANDO_REALTIME_HOST, formatAndoTarget,
+  parseAndoTarget
+} from "@andocorp/sdk";
 import { z } from "zod";
 import { postAndoMessage } from "./client.js";
 import { monitorAndoProvider } from "./monitor.js";
@@ -20,6 +23,8 @@ const meta = packageJson.openclaw.channel as {
   blurb: string;
 };
 
+export const DEFAULT_ANDO_MCP_URL = "https://mcp.ando.so/mcp";
+
 type AndoConfig = {
   baseUrl?: string;
   apiKey?: string;
@@ -35,20 +40,8 @@ function normalizeUrl(value?: string | null): string {
   return trimValue(value).replace(/\/+$/, "");
 }
 
-function waitForAbort(signal?: AbortSignal): Promise<void> {
-  return new Promise((resolve) => {
-    if (signal?.aborted) {
-      resolve();
-      return;
-    }
-
-    signal?.addEventListener("abort", () => resolve(), {
-      once: true,
-    });
-  });
-}
 export function resolveAndoMcpUrl(params: {
-  baseUrl: string;
+  baseUrl?: string | null;
   mcpUrl?: string | null;
 }): string {
   const explicitMcpUrl = normalizeUrl(params.mcpUrl);
@@ -56,8 +49,7 @@ export function resolveAndoMcpUrl(params: {
     return explicitMcpUrl;
   }
 
-  const baseUrl = normalizeUrl(params.baseUrl);
-  return baseUrl ? `${baseUrl}/mcp` : "";
+  return DEFAULT_ANDO_MCP_URL;
 }
 export function resolveAndoAccount(cfg: OpenClawConfig): ResolvedAndoAccount {
   const config = (cfg.channels?.ando ?? {}) as AndoConfig;
@@ -65,9 +57,9 @@ export function resolveAndoAccount(cfg: OpenClawConfig): ResolvedAndoAccount {
 
   return {
     accountId: DEFAULT_ACCOUNT_ID,
-    baseUrl: normalizeUrl(config.baseUrl),
+    baseUrl: normalizeUrl(config.baseUrl) || DEFAULT_ANDO_BASE_URL,
     apiKey: trimValue(config.apiKey),
-    realtimeHost: realtimeHost || null,
+    realtimeHost: realtimeHost || DEFAULT_ANDO_REALTIME_HOST,
     mcpUrl: resolveAndoMcpUrl({
       baseUrl: config.baseUrl ?? "",
       mcpUrl: config.mcpUrl,
@@ -105,25 +97,19 @@ type AndoOutboundParams = {
 };
 
 function isAndoRestConfigured(account: ResolvedAndoAccount): boolean {
-  return Boolean(account.baseUrl && account.apiKey);
+  return Boolean(account.apiKey);
 }
 
 function assertAndoRestConfigured(account: ResolvedAndoAccount): void {
   if (!isAndoRestConfigured(account)) {
     throw new Error(
-      `[ando] account "${account.accountId}" is missing baseUrl or apiKey`,
+      `[ando] account "${account.accountId}" is missing apiKey`,
     );
   }
 }
 
 function assertAndoRealtimeConfigured(account: ResolvedAndoAccount): void {
   assertAndoRestConfigured(account);
-
-  if (!account.realtimeHost) {
-    throw new Error(
-      `[ando] account "${account.accountId}" is missing realtimeHost for realtime monitoring`,
-    );
-  }
 }
 
 export function resolveThreadRootId(params: {
@@ -213,8 +199,8 @@ export const andoPlugin: ChannelPlugin<ResolvedAndoAccount> = {
     ...andoConfigBase,
     isConfigured: isAndoRestConfigured,
     unconfiguredReason: (account) => {
-      if (!account.baseUrl || !account.apiKey) {
-        return "baseUrl and apiKey are required";
+      if (!account.apiKey) {
+        return "apiKey is required";
       }
       return "Ando channel is configured";
     },
@@ -261,14 +247,6 @@ export const andoPlugin: ChannelPlugin<ResolvedAndoAccount> = {
   gateway: {
     startAccount: async (ctx) => {
       const account = ctx.account;
-      if (!account.realtimeHost) {
-        ctx.runtime.log?.(
-          `[ando] skipping realtime monitoring for account "${account.accountId}" because realtimeHost is not configured`
-        );
-        await waitForAbort(ctx.abortSignal);
-        return;
-      }
-
       assertAndoRealtimeConfigured(account);
       const channelRuntime = ctx.channelRuntime;
       if (!channelRuntime) {

package/src/client.ts

@@ -4,7 +4,7 @@ import { ResolvedAndoAccount } from "./types.js";
 export function createAndoSdkClient(account: ResolvedAndoAccount) {
   return new AndoClient({
     baseUrl: account.baseUrl,
-    realtimeHost: account.realtimeHost ?? undefined,
+    realtimeHost: account.realtimeHost,
     auth: {
       apiKey: account.apiKey,
     },

package/src/mcp-tool-catalog.ts

@@ -38,7 +38,7 @@ const CURATED_ANDO_MCP_TOOLS: ToolDefinition[] = [
   {
     name: "search_messages",
     description:
-      "Search messages across conversations by keyword or semantic similarity. Requires a real search query — do not use wildcards like '*'. To browse recent messages or filter by author without a keyword, use get_conversation_messages instead.",
+      "Search messages across conversations by keyword. Requires a real search query — do not use wildcards like '*'. To browse recent messages or filter by author without a keyword, use get_conversation_messages instead.",
     inputSchema: objectSchema(
       {
         q: stringProperty(
@@ -61,7 +61,7 @@ const CURATED_ANDO_MCP_TOOLS: ToolDefinition[] = [
           type: "string",
           enum: ["full-text", "semantic"],
           description:
-            "Search mode: 'full-text' for keyword search (default), 'semantic' for AI-powered similarity",
+            "Accepted for backwards compatibility; message search uses Convex keyword search",
         },
       },
       ["q"]
@@ -89,6 +89,17 @@ const CURATED_ANDO_MCP_TOOLS: ToolDefinition[] = [
       ["q"]
     ),
   },
+  {
+    name: "list_conversations",
+    description:
+      "List conversations (channels and DMs) that the MCP caller is a member of. Optionally filter by conversation name or description.",
+    inputSchema: objectSchema({
+      q: stringProperty("Optional query text to filter conversations"),
+      limit: numberProperty(
+        "Maximum number of conversations to return (default 50, max 100)"
+      ),
+    }),
+  },
   {
     name: "search_clipboard",
     description:
@@ -216,6 +227,44 @@ const CURATED_ANDO_MCP_TOOLS: ToolDefinition[] = [
       ["message_id"]
     ),
   },
+  {
+    name: "list_conversation_members",
+    description:
+      "List active members in a conversation the MCP caller can access. Returns member IDs, display names, member types, and workspace roles.",
+    inputSchema: objectSchema(
+      {
+        conversation_id: stringProperty("The conversation ID"),
+      },
+      ["conversation_id"]
+    ),
+  },
+  {
+    name: "react_to_message",
+    description:
+      "React to a message with a supported standard emoji or active workspace custom emoji.",
+    inputSchema: objectSchema(
+      {
+        message_id: stringProperty("The message ID to react to"),
+        emoji: stringProperty(
+          "Emoji to react with, such as :thumbs_up: or :ship-it:"
+        ),
+      },
+      ["message_id", "emoji"]
+    ),
+  },
+  {
+    name: "delete_message",
+    description:
+      "Delete one of your own sent messages. This tool can only delete messages authored by the MCP caller; it cannot delete messages from other members or agents.",
+    inputSchema: objectSchema(
+      {
+        message_id: stringProperty(
+          "The ID of one of your own sent messages to delete"
+        ),
+      },
+      ["message_id"]
+    ),
+  },
 ];
 
 export function listCuratedAndoMcpTools(): ToolDefinition[] {

package/src/mcp-tools.ts

@@ -227,7 +227,10 @@ async function closeMcpSession(params: {
   );
 }
 
-async function initializeMcpSession(mcpUrl: string, apiKey: string): Promise<string> {
+async function initializeMcpSession(
+  mcpUrl: string,
+  apiKey: string,
+): Promise<string | null> {
   const response = await runMcpJsonRpc({
     mcpUrl,
     apiKey,
@@ -250,11 +253,7 @@ async function initializeMcpSession(mcpUrl: string, apiKey: string): Promise<str
   ensureMcpOk(payload);
 
   const sessionId = response.sessionId?.trim();
-  if (!sessionId) {
-    throw new Error("Missing MCP session ID");
-  }
-
-  return sessionId;
+  return sessionId || null;
 }
 
 async function notifyMcpSessionInitialized(params: {
@@ -281,16 +280,18 @@ async function callAndoMcpTool(params: {
 }): Promise<string> {
   const sessionId = await initializeMcpSession(params.mcpUrl, params.apiKey);
   try {
-    await notifyMcpSessionInitialized({
-      mcpUrl: params.mcpUrl,
-      apiKey: params.apiKey,
-      sessionId,
-    });
+    if (sessionId) {
+      await notifyMcpSessionInitialized({
+        mcpUrl: params.mcpUrl,
+        apiKey: params.apiKey,
+        sessionId,
+      });
+    }
 
     const response = await runMcpJsonRpc({
       mcpUrl: params.mcpUrl,
       apiKey: params.apiKey,
-      sessionId,
+      ...(sessionId ? { sessionId } : {}),
       action: `tools/call(${params.name})`,
       request: buildMcpJsonRpcRequest({
         id: "2",
@@ -306,11 +307,13 @@ async function callAndoMcpTool(params: {
     ensureMcpOk(payload);
     return formatMcpToolResultText(asMcpToolResult(payload.result));
   } finally {
-    await closeMcpSession({
-      mcpUrl: params.mcpUrl,
-      apiKey: params.apiKey,
-      sessionId,
-    }).catch(() => undefined);
+    if (sessionId) {
+      await closeMcpSession({
+        mcpUrl: params.mcpUrl,
+        apiKey: params.apiKey,
+        sessionId,
+      }).catch(() => undefined);
+    }
   }
 }
 
@@ -356,7 +359,10 @@ export function registerAndoMcpTools(
           } catch (error) {
             const message =
               error instanceof Error ? error.message : String(error);
-            throw new Error(`Error calling Ando MCP tool ${tool.name}: ${message}`);
+            throw new Error(
+              `Error calling Ando MCP tool ${tool.name}: ${message}`,
+              { cause: error }
+            );
           }
         },
       };

package/src/types.ts

@@ -2,6 +2,6 @@ export type ResolvedAndoAccount = {
   accountId: string;
   baseUrl: string;
   apiKey: string;
-  realtimeHost: string | null;
+  realtimeHost: string;
   mcpUrl: string;
 };