@brantrusnak/openclaw-omadeus 1.0.0

package/README.md

@@ -0,0 +1,107 @@
+# OpenClaw Omadeus Plugin
+
+Omadeus channel plugin for [OpenClaw](https://www.npmjs.com/package/openclaw).
+
+This plugin connects OpenClaw to Omadeus over WebSocket so OpenClaw can listen
+for Omadeus messages and reply through the selected Omadeus channel.
+
+## Requirements
+
+- Node.js 22 or newer
+- OpenClaw 2026.4.10 or newer
+- An Omadeus account with access to the organization and channel you want
+  OpenClaw to use
+
+## Install
+
+Install OpenClaw first:
+
+```bash
+npm install -g openclaw
+```
+
+Set up OpenClaw if you have not already:
+
+```bash
+openclaw onboard
+```
+
+Then install this plugin with the OpenClaw plugin command:
+
+```bash
+openclaw plugins install @brantrusnak/openclaw-omadeus
+```
+
+You can confirm OpenClaw discovered the plugin with:
+
+```bash
+openclaw plugins list
+openclaw plugins inspect omadeus
+```
+
+## Configure
+
+After installing the plugin, run OpenClaw configuration and choose Omadeus when
+prompted:
+
+```bash
+openclaw configure
+```
+
+The Omadeus setup flow asks for:
+
+- Omadeus email and password
+- Organization ID
+- The Omadeus member/account to listen as
+- The Omadeus channel to use for messages
+
+The plugin also supports these environment variables:
+
+```bash
+export OMADEUS_EMAIL="you@example.com"
+export OMADEUS_PASSWORD="your-password"
+export OMADEUS_ORGANIZATION_ID="123"
+```
+
+The default Omadeus endpoints are:
+
+- CAS: `https://dev1-cas.rouztech.com`
+- Maestro: `https://dev3-maestro.rouztech.com`
+
+If your Omadeus deployment uses different endpoints, configure them through the
+OpenClaw setup flow or in your OpenClaw config under `channels.omadeus`.
+
+## Start OpenClaw
+
+Once OpenClaw and the plugin are configured, start or restart the gateway:
+
+```bash
+openclaw gateway
+```
+
+Check channel health with:
+
+```bash
+openclaw channels status --deep
+openclaw plugins doctor
+```
+
+## Local Development
+
+From this repository, you can link the local plugin into OpenClaw:
+
+```bash
+openclaw plugins install . --link
+```
+
+Before publishing, inspect the npm package contents:
+
+```bash
+npm pack --dry-run
+```
+
+Publish to npm:
+
+```bash
+npm publish
+```

package/api.ts

@@ -0,0 +1,2 @@
+export * from "./src/setup-core.js";
+export * from "./src/setup-surface.js";

package/index.ts

@@ -0,0 +1,14 @@
+import { defineChannelPluginEntry } from "openclaw/plugin-sdk/core";
+import { omadeusPlugin } from "./src/channel.js";
+import { setOmadeusRuntime } from "./src/runtime.js";
+
+export { omadeusPlugin } from "./src/channel.js";
+export { setOmadeusRuntime } from "./src/runtime.js";
+
+export default defineChannelPluginEntry({
+  id: "omadeus",
+  name: "Omadeus",
+  description: "Omadeus project management channel plugin",
+  plugin: omadeusPlugin,
+  setRuntime: setOmadeusRuntime,
+});

package/openclaw.plugin.json

@@ -0,0 +1,91 @@
+{
+  "id": "omadeus",
+  "channels": ["omadeus"],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "enabled": { "type": "boolean" },
+      "casUrl": { "type": "string" },
+      "maestroUrl": { "type": "string" },
+      "email": { "type": "string" },
+      "password": { "type": "string" },
+      "organizationId": { "type": "number" },
+      "sessionToken": { "type": "string" },
+      "selectedMemberReferenceId": { "type": "number" },
+      "selectedChannelViewId": { "type": "number" },
+      "selectedChannelTitle": { "type": "string" },
+      "selectedChannelPrivateRoomId": { "type": "number" },
+      "selectedChannelPublicRoomId": { "type": "number" }
+    }
+  },
+  "channelConfigs": {
+    "omadeus": {
+      "schema": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "enabled": { "type": "boolean" },
+          "casUrl": { "type": "string" },
+          "maestroUrl": { "type": "string" },
+          "email": { "type": "string" },
+          "password": { "type": "string" },
+          "organizationId": { "type": "number" },
+          "sessionToken": { "type": "string" },
+          "selectedMemberReferenceId": { "type": "number" },
+          "selectedChannelViewId": { "type": "number" },
+          "selectedChannelTitle": { "type": "string" },
+          "selectedChannelPrivateRoomId": { "type": "number" },
+          "selectedChannelPublicRoomId": { "type": "number" }
+        }
+      },
+      "uiHints": {
+        "casUrl": {
+          "label": "CAS URL",
+          "placeholder": "https://dev1-cas.rouztech.com"
+        },
+        "maestroUrl": {
+          "label": "Maestro URL",
+          "placeholder": "https://dev3-maestro.rouztech.com"
+        },
+        "email": {
+          "label": "Email"
+        },
+        "password": {
+          "label": "Password",
+          "sensitive": true
+        },
+        "organizationId": {
+          "label": "Organization ID"
+        },
+        "sessionToken": {
+          "label": "Session token",
+          "sensitive": true,
+          "advanced": true
+        },
+        "selectedMemberReferenceId": {
+          "label": "Selected member reference ID",
+          "advanced": true
+        },
+        "selectedChannelViewId": {
+          "label": "Selected channel view ID",
+          "advanced": true
+        },
+        "selectedChannelTitle": {
+          "label": "Selected channel title",
+          "advanced": true
+        },
+        "selectedChannelPrivateRoomId": {
+          "label": "Selected private room ID",
+          "advanced": true
+        },
+        "selectedChannelPublicRoomId": {
+          "label": "Selected public room ID",
+          "advanced": true
+        }
+      },
+      "label": "Omadeus",
+      "description": "Omadeus project management channel configuration"
+    }
+  }
+}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@brantrusnak/openclaw-omadeus",
+  "version": "1.0.0",
+  "private": false,
+  "description": "OpenClaw Omadeus project management channel plugin",
+  "homepage": "https://github.com/brantrusnak/openclaw-omadeus-plugin#readme",
+  "bugs": {
+    "url": "https://github.com/brantrusnak/openclaw-omadeus-plugin/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/brantrusnak/openclaw-omadeus-plugin.git"
+  },
+  "license": "ISC",
+  "author": "Brant Rusnak",
+  "type": "module",
+  "main": "./index.ts",
+  "scripts": {
+    "test": "vitest run",
+    "prepack": "node ./scripts/verify-npm-files.mjs"
+  },
+  "dependencies": {
+    "ws": "^8.20.0"
+  },
+  "files": [
+    "index.ts",
+    "setup-entry.ts",
+    "api.ts",
+    "runtime-api.ts",
+    "openclaw.plugin.json",
+    "src",
+    "!**/*.test.ts"
+  ],
+  "devDependencies": {
+    "openclaw": ">=2026.4.10",
+    "vitest": "^4.1.5"
+  },
+  "peerDependencies": {
+    "openclaw": ">=2026.4.10"
+  },
+  "peerDependenciesMeta": {
+    "openclaw": {
+      "optional": true
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "openclaw": {
+    "extensions": [
+      "./index.ts"
+    ],
+    "setupEntry": "./setup-entry.ts",
+    "channel": {
+      "id": "omadeus",
+      "label": "Omadeus",
+      "selectionLabel": "Omadeus (WebSocket)",
+      "docsPath": "/channels/omadeus",
+      "docsLabel": "omadeus",
+      "blurb": "Omadeus project management — tasks, chat rooms, and sprints.",
+      "order": 70
+    },
+    "install": {
+      "localPath": ".",
+      "defaultChoice": "local"
+    }
+  }
+}

package/runtime-api.ts

@@ -0,0 +1,37 @@
+export { DEFAULT_ACCOUNT_ID } from "openclaw/plugin-sdk/core";
+export type {
+  ChannelPlugin,
+  OpenClawConfig,
+  PluginRuntime,
+} from "openclaw/plugin-sdk/core";
+export {
+  type ChannelStatusIssue,
+  createReplyPrefixContext,
+} from "openclaw/plugin-sdk/channel-runtime";
+export { logInboundDrop } from "openclaw/plugin-sdk/channel-inbound";
+export { resolveControlCommandGate } from "openclaw/plugin-sdk/command-auth";
+export { createChannelPairingController } from "openclaw/plugin-sdk/channel-pairing";
+export {
+  readStoreAllowFromForDmPolicy,
+  resolveDmGroupAccessWithLists,
+} from "openclaw/plugin-sdk/channel-policy";
+export type { RuntimeEnv } from "openclaw/plugin-sdk/runtime";
+export type { ReplyPayload } from "openclaw/plugin-sdk/reply-runtime";
+export {
+  addWildcardAllowFrom,
+  formatDocsLink,
+  mergeAllowFromEntries,
+} from "openclaw/plugin-sdk/setup";
+export type {
+  ChannelSetupDmPolicy,
+  ChannelSetupWizard,
+  DmPolicy,
+  WizardPrompter,
+} from "openclaw/plugin-sdk/setup";
+
+export function missingTargetError(provider: string, hint?: string): Error {
+  const normalizedHint = hint?.trim();
+  return new Error(
+    `Delivering to ${provider} requires target${normalizedHint ? ` ${normalizedHint}` : ""}`,
+  );
+}

package/setup-entry.ts

@@ -0,0 +1,4 @@
+import { defineSetupPluginEntry } from "openclaw/plugin-sdk/core";
+import { omadeusPlugin } from "./src/channel.js";
+
+export default defineSetupPluginEntry(omadeusPlugin);

package/src/allowed-reaction-emojis.ts

@@ -0,0 +1,22 @@
+/**
+ * Omadeus only accepts these exact reaction strings; any other value is ignored (no API call).
+ */
+export const ALLOWED_OMADEUS_REACTION_EMOJI_LIST = [
+  "👍",
+  "👎",
+  "❤️",
+  "😂",
+  "😮",
+  "😢",
+  "🙏",
+] as const;
+
+const ALLOWED = new Set<string>(ALLOWED_OMADEUS_REACTION_EMOJI_LIST);
+
+export function isAllowedOmadeusReactionEmoji(raw: string): boolean {
+  const trimmed = raw.trim();
+  if (!trimmed) {
+    return false;
+  }
+  return ALLOWED.has(trimmed);
+}

package/src/api/auth.api.ts

@@ -0,0 +1,189 @@
+import { getCasSession, setCasSession } from "../store.js";
+import type {
+  CasAuthorizationCodeResponse,
+  OmadeusChannelView,
+  OmadeusOrganizationMember,
+  OmadeusOrganization,
+  OmadeusSessionTokenResponse,
+} from "../types.js";
+
+const CAS_APPLICATION_ID = 1;
+const CAS_SCOPES = "title,email,avatar,firstName,lastName,birth,phone,countryCode";
+
+export async function createCasToken(params: {
+  casUrl: string;
+  email: string;
+  password: string;
+}): Promise<{ token: string; refreshCookie: string }> {
+  const { casUrl, email, password } = params;
+  const url = `${casUrl}/apiv1/tokens`;
+  const jsonBody = JSON.stringify({ email, password });
+  const res = await fetch(url, {
+    method: "CREATE",
+    headers: {
+      "Content-Type": "application/json;charset=UTF-8",
+      "Content-Length": String(jsonBody.length),
+    },
+    body: jsonBody,
+  });
+  if (!res.ok) {
+    const text = await res.text().catch(() => "");
+    throw new Error(`CAS token request failed (${res.status}): ${text}`);
+  }
+  const body = (await res.json()) as { token: string };
+  const refreshCookie = res.headers.get("set-cookie") ?? "";
+
+  setCasSession({ token: body.token, refreshCookie });
+
+  return { token: body.token, refreshCookie };
+}
+
+export async function getMe(params: {
+  casUrl: string;
+  casToken: string;
+  refreshCookie?: string;
+}): Promise<{ email: string }> {
+  const { casUrl, casToken, refreshCookie } = params;
+  const url = `${casUrl}/apiv1/members/me`;
+  const res = await fetch(url, {
+    method: "GET",
+    headers: {
+      Authorization: `Bearer ${casToken}`,
+      "Content-Type": "application/json;charset=UTF-8",
+      ...(refreshCookie ? { Cookie: refreshCookie } : {}),
+    },
+  });
+  if (!res.ok) {
+    const text = await res.text().catch(() => "");
+    throw new Error(`CAS get member failed (${res.status}): ${text}`);
+  }
+  return (await res.json()) as { email: string };
+}
+
+export async function createAuthorizationCode(params: {
+  casUrl: string;
+  token: string;
+  email: string;
+  redirectUri?: string;
+}): Promise<string> {
+  const { casUrl, token, email, redirectUri } = params;
+  const casSession = getCasSession();
+  const qs = new URLSearchParams({
+    applicationId: String(CAS_APPLICATION_ID),
+    scopes: CAS_SCOPES,
+    state: email,
+    redirectUri: redirectUri ?? "",
+  });
+  if (redirectUri) qs.set("redirectUri", redirectUri);
+  const url = `${casUrl}/apiv1/authorizationcodes?${qs}`;
+  const body = "";
+  const headers: Record<string, string> = {
+    Authorization: `Bearer ${token}`,
+    ...(casSession?.refreshCookie ? { Cookie: casSession.refreshCookie } : {}),
+  };
+  const res = await fetch(url, {
+    method: "CREATE",
+    body,
+    headers,
+  });
+  if (!res.ok) {
+    const text = await res.text().catch(() => "");
+    throw new Error(`CAS authorization code request failed (${res.status}): ${text}`);
+  }
+  const jsonResponse = (await res.json()) as CasAuthorizationCodeResponse;
+  const code = jsonResponse.authorizationCode ?? jsonResponse.code;
+  if (!code) {
+    throw new Error("CAS authorization code response missing code");
+  }
+  return code;
+}
+
+export async function obtainSessionToken(params: {
+  maestroUrl: string;
+  authorizationCode: string;
+  organizationId: number;
+}): Promise<string> {
+  const { maestroUrl, authorizationCode, organizationId } = params;
+  const url = `${maestroUrl}/dolphin/apiv1/oauth2/tokens`;
+  const res = await fetch(url, {
+    method: "OBTAIN",
+    headers: { "Content-Type": "application/json;charset=UTF-8" },
+    body: JSON.stringify({ authorizationCode, organizationId }),
+  });
+  if (!res.ok) {
+    const text = await res.text().catch(() => "");
+    throw new Error(`Omadeus session token request failed (${res.status}): ${text}`);
+  }
+  const body = (await res.json()) as OmadeusSessionTokenResponse;
+  if (!body.token) {
+    throw new Error("Omadeus session token response missing token");
+  }
+  return body.token;
+}
+
+export async function listOrganizations(params: {
+  maestroUrl: string;
+  email: string;
+}): Promise<OmadeusOrganization[]> {
+  const { maestroUrl, email } = params;
+  const url = `${maestroUrl}/dolphin/apiv1/organizations`;
+  const res = await fetch(url, {
+    method: "LIST",
+    headers: { "Content-Type": "application/json;charset=UTF-8" },
+    body: JSON.stringify({ email }),
+  });
+  if (!res.ok) {
+    const text = await res.text().catch(() => "");
+    throw new Error(`Omadeus list organizations failed (${res.status}): ${text}`);
+  }
+  return (await res.json()) as OmadeusOrganization[];
+}
+
+export async function listMemberChannelViews(params: {
+  maestroUrl: string;
+  sessionToken: string;
+  memberReferenceId: number;
+  skip?: number;
+  take?: number;
+}): Promise<OmadeusChannelView[]> {
+  const { maestroUrl, sessionToken, memberReferenceId, skip = 0, take = 100 } = params;
+  const qs = new URLSearchParams({
+    skip: String(skip),
+    take: String(take),
+    sort: "-recentMessageAt",
+  });
+  const url = `${maestroUrl}/jaguar/apiv1/members/${memberReferenceId}/channelviews?${qs.toString()}`;
+  const res = await fetch(url, {
+    method: "LIST",
+    headers: {
+      Authorization: `Bearer ${sessionToken}`,
+      "Content-Type": "application/json;charset=UTF-8",
+    },
+  });
+  if (!res.ok) {
+    const text = await res.text().catch(() => "");
+    throw new Error(`Omadeus list channel views failed (${res.status}): ${text}`);
+  }
+  return (await res.json()) as OmadeusChannelView[];
+}
+
+export async function listOrganizationMembers(params: {
+  maestroUrl: string;
+  sessionToken: string;
+  organizationId: number;
+}): Promise<OmadeusOrganizationMember[]> {
+  const { maestroUrl, sessionToken, organizationId } = params;
+  const url = `${maestroUrl}/dolphin/apiv1/organizations/${organizationId}/members`;
+  const res = await fetch(url, {
+    method: "LIST",
+    headers: {
+      Authorization: `Bearer ${sessionToken}`,
+      "Content-Type": "application/json;charset=UTF-8",
+    },
+  });
+  if (!res.ok) {
+    const text = await res.text().catch(() => "");
+    throw new Error(`Omadeus list organization members failed (${res.status}): ${text}`);
+  }
+  return (await res.json()) as OmadeusOrganizationMember[];
+}