@brantrusnak/openclaw-omadeus 1.0.1 → 1.0.2

package/README.md

@@ -1,6 +1,6 @@
 # OpenClaw Omadeus Plugin
 
-Omadeus channel plugin for [OpenClaw](https://www.npmjs.com/package/openclaw).
+[Omadeus](https://omadeus.com) 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.

package/openclaw.plugin.json

@@ -12,11 +12,77 @@
       "password": { "type": "string" },
       "organizationId": { "type": "number" },
       "sessionToken": { "type": "string" },
-      "selectedMemberReferenceId": { "type": "number" },
-      "selectedChannelViewId": { "type": "number" },
-      "selectedChannelTitle": { "type": "string" },
-      "selectedChannelPrivateRoomId": { "type": "number" },
-      "selectedChannelPublicRoomId": { "type": "number" }
+      "inbound": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "version": { "type": "integer", "minimum": 1 },
+          "direct": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "enabled": { "type": "boolean" },
+              "allowedSenderReferenceIds": {
+                "type": "array",
+                "items": { "type": "number" }
+              },
+              "requireMention": { "type": "string", "enum": ["never", "always"] }
+            },
+            "required": ["enabled"]
+          },
+          "channels": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "enabled": { "type": "boolean" },
+              "allowedRoomIds": { "type": "array", "items": { "type": "number" } },
+              "allowedChannelViewIds": { "type": "array", "items": { "type": "number" } },
+              "allowedSenderReferenceIds": {
+                "type": "array",
+                "items": { "type": "number" }
+              },
+              "requireMention": {
+                "type": "string",
+                "enum": ["never", "always", "outsideAllowlist"]
+              }
+            },
+            "required": ["enabled"]
+          },
+          "entities": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "enabled": { "type": "boolean" },
+              "allowedKinds": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "enum": [
+                    "task",
+                    "nugget",
+                    "project",
+                    "release",
+                    "sprint",
+                    "summary",
+                    "client",
+                    "folder"
+                  ]
+                }
+              },
+              "allowedRoomIds": { "type": "array", "items": { "type": "number" } },
+              "allowedSenderReferenceIds": {
+                "type": "array",
+                "items": { "type": "number" }
+              },
+              "requireMention": {
+                "type": "string",
+                "enum": ["never", "always", "outsideAllowlist"]
+              }
+            },
+            "required": ["enabled"]
+          }
+        }
+      }
     }
   },
   "channelConfigs": {
@@ -32,11 +98,77 @@
           "password": { "type": "string" },
           "organizationId": { "type": "number" },
           "sessionToken": { "type": "string" },
-          "selectedMemberReferenceId": { "type": "number" },
-          "selectedChannelViewId": { "type": "number" },
-          "selectedChannelTitle": { "type": "string" },
-          "selectedChannelPrivateRoomId": { "type": "number" },
-          "selectedChannelPublicRoomId": { "type": "number" }
+          "inbound": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "version": { "type": "integer", "minimum": 1 },
+              "direct": {
+                "type": "object",
+                "additionalProperties": false,
+                "properties": {
+                  "enabled": { "type": "boolean" },
+                  "allowedSenderReferenceIds": {
+                    "type": "array",
+                    "items": { "type": "number" }
+                  },
+                  "requireMention": { "type": "string", "enum": ["never", "always"] }
+                },
+                "required": ["enabled"]
+              },
+              "channels": {
+                "type": "object",
+                "additionalProperties": false,
+                "properties": {
+                  "enabled": { "type": "boolean" },
+                  "allowedRoomIds": { "type": "array", "items": { "type": "number" } },
+                  "allowedChannelViewIds": { "type": "array", "items": { "type": "number" } },
+                  "allowedSenderReferenceIds": {
+                    "type": "array",
+                    "items": { "type": "number" }
+                  },
+                  "requireMention": {
+                    "type": "string",
+                    "enum": ["never", "always", "outsideAllowlist"]
+                  }
+                },
+                "required": ["enabled"]
+              },
+              "entities": {
+                "type": "object",
+                "additionalProperties": false,
+                "properties": {
+                  "enabled": { "type": "boolean" },
+                  "allowedKinds": {
+                    "type": "array",
+                    "items": {
+                      "type": "string",
+                      "enum": [
+                        "task",
+                        "nugget",
+                        "project",
+                        "release",
+                        "sprint",
+                        "summary",
+                        "client",
+                        "folder"
+                      ]
+                    }
+                  },
+                  "allowedRoomIds": { "type": "array", "items": { "type": "number" } },
+                  "allowedSenderReferenceIds": {
+                    "type": "array",
+                    "items": { "type": "number" }
+                  },
+                  "requireMention": {
+                    "type": "string",
+                    "enum": ["never", "always", "outsideAllowlist"]
+                  }
+                },
+                "required": ["enabled"]
+              }
+            }
+          }
         }
       },
       "uiHints": {
@@ -63,24 +195,8 @@
           "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",
+        "inbound": {
+          "label": "Inbound policy (Jaguar chat)",
           "advanced": true
         }
       },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brantrusnak/openclaw-omadeus",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "private": false,
   "description": "OpenClaw Omadeus project management channel plugin",
   "homepage": "https://github.com/brantrusnak/openclaw-omadeus-plugin#readme",
@@ -54,10 +54,8 @@
     "channel": {
       "id": "omadeus",
       "label": "Omadeus",
-      "selectionLabel": "Omadeus (WebSocket)",
-      "docsPath": "/channels/omadeus",
-      "docsLabel": "omadeus",
-      "blurb": "Omadeus project management — tasks, chat rooms, and sprints.",
+      "selectionLabel": "Omadeus (API + WebSocket)",
+      "blurb": "AI-native project management that knows your role, speaks your language, and keeps your team in sync. No noise.",
       "order": 70
     },
     "install": {

package/src/api/auth.api.ts

@@ -1,7 +1,6 @@
 import { getCasSession, setCasSession } from "../store.js";
 import type {
   CasAuthorizationCodeResponse,
-  OmadeusChannelView,
   OmadeusOrganizationMember,
   OmadeusOrganization,
   OmadeusSessionTokenResponse,
@@ -139,34 +138,6 @@ export async function listOrganizations(params: {
   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;

package/src/api/channel.api.ts

@@ -0,0 +1,29 @@
+import type { OmadeusChannelView } from "../types.js";
+
+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[];
+}

package/src/api/nugget.api.ts

@@ -85,20 +85,23 @@ function extractRows(payload: unknown): Record<string, unknown>[] {
 }
 
 /**
- * Dolphin SEARCH on nuggetviews returns an array of nugget/task rows.
- * User-facing `N111` corresponds to `number: 111` on each row (not `id`).
+ * Dolphin SEARCH on nuggetviews — arbitrary text query (e.g. N###, task title, or room id string).
+ * Prefer filtering results with `findNuggetRowByNumber` or `findNuggetRowByRoomId`.
  */
-export async function searchNuggetByNumber(
+export async function searchNuggetRowsByTextQuery(
   opts: OmadeusApiOptions,
-  params: NuggetSearchParams,
-): Promise<Record<string, unknown> | null> {
-  const query = `N${params.nuggetNumber}`;
+  params: { query: string; take?: number; signal?: AbortSignal },
+): Promise<Record<string, unknown>[]> {
+  const take = params.take ?? 100;
+  const q = params.query.trim();
+  if (!q) {
+    return [];
+  }
   const search = new URLSearchParams();
-  search.set("take", "100");
-
+  search.set("take", String(take));
   const res = await dolphinFetch(opts, `/nuggetviews?${search.toString()}`, {
     method: "SEARCH",
-    body: JSON.stringify({ query }),
+    body: JSON.stringify({ query: q }),
     signal: params.signal,
   });
   if (!res.ok) {
@@ -106,7 +109,75 @@ export async function searchNuggetByNumber(
     throw new Error(`Omadeus nugget search failed (${res.status}): ${text.slice(0, 200)}`);
   }
   const payload = (await res.json()) as unknown;
-  const rows = extractRows(payload);
+  return extractRows(payload);
+}
+
+/**
+ * Picks a row whose private/public/shared task room id matches a Jaguar `roomId`.
+ */
+export function findNuggetRowByRoomId(
+  rows: Record<string, unknown>[],
+  roomId: number,
+): Record<string, unknown> | undefined {
+  for (const row of rows) {
+    for (const key of ["privateRoomId", "publicRoomId", "sharedRoomId"] as const) {
+      if (readNumberField(row, key) === roomId) {
+        return row;
+      }
+    }
+  }
+  return undefined;
+}
+
+export type FindNuggetByTaskRoomParams = {
+  roomId: number;
+  roomName?: string | null;
+  signal?: AbortSignal;
+};
+
+/**
+ * Resolve the nugget/task row for a Jaguar Task or Nugget **chat room** by matching
+ * `privateRoomId` / `publicRoomId` / `sharedRoomId` to `roomId` in Dolphin `nuggetviews` search results.
+ * Tries search by `roomName` first (usually matches the task title), then by the numeric `roomId` as text.
+ */
+export async function findNuggetByTaskChannelRoom(
+  opts: OmadeusApiOptions,
+  params: FindNuggetByTaskRoomParams,
+): Promise<Record<string, unknown> | null> {
+  const { roomId, roomName, signal } = params;
+  const tryQueries: string[] = [];
+  if (typeof roomName === "string" && roomName.trim()) {
+    tryQueries.push(roomName.trim());
+  }
+  tryQueries.push(String(roomId));
+  const tried = new Set<string>();
+  for (const query of tryQueries) {
+    if (tried.has(query)) {
+      continue;
+    }
+    tried.add(query);
+    const rows = await searchNuggetRowsByTextQuery(opts, { query, take: 100, signal });
+    const match = findNuggetRowByRoomId(rows, roomId);
+    if (match) {
+      return match;
+    }
+  }
+  return null;
+}
+
+/**
+ * Dolphin SEARCH on nuggetviews returns an array of nugget/task rows.
+ * User-facing `N111` corresponds to `number: 111` on each row (not `id`).
+ */
+export async function searchNuggetByNumber(
+  opts: OmadeusApiOptions,
+  params: NuggetSearchParams,
+): Promise<Record<string, unknown> | null> {
+  const rows = await searchNuggetRowsByTextQuery(opts, {
+    query: `N${params.nuggetNumber}`,
+    take: 100,
+    signal: params.signal,
+  });
   const match = findNuggetRowByNumber(rows, params.nuggetNumber);
   return match ?? null;
 }

package/src/channel.ts

@@ -83,11 +83,7 @@ const omadeusConfigAdapter = createTopLevelChannelConfigAdapter<Account>({
     "password",
     "organizationId",
     "sessionToken",
-    "selectedMemberReferenceId",
-    "selectedChannelViewId",
-    "selectedChannelTitle",
-    "selectedChannelPrivateRoomId",
-    "selectedChannelPublicRoomId",
+    "inbound",
   ],
   // Keep adapter contract satisfied even though Omadeus no longer uses DM allowlists.
   resolveAllowFrom: () => [],
@@ -188,10 +184,10 @@ export const omadeusPlugin: ChannelPlugin<Account> = {
   meta: {
     id: "omadeus",
     label: "Omadeus",
-    selectionLabel: "Omadeus (WebSocket)",
-    docsPath: "/channels/omadeus",
-    docsLabel: "omadeus",
-    blurb: "Omadeus project management — tasks, chat rooms, and sprints.",
+    selectionLabel: "Omadeus (API + WebSocket)",
+    docsPath: "",
+    docsLabel: "",
+    blurb: "AI-native project management that knows your role, speaks your language, and keeps your team in sync. No noise.",
   },
   capabilities: {
     chatTypes: ["direct", "group"],
@@ -205,6 +201,9 @@ export const omadeusPlugin: ChannelPlugin<Account> = {
     messageToolHints: () => [
       "- Omadeus routing: **send** uses **room id** (`to` / `target`, e.g. `room:117947` or `117947`). **edit**, **delete**, **react** use the Jaguar **message** `id` (`messageId`, or the current inbound message from context).",
       "- Create Omadeus task/nugget: use `action=send` with params `{ op: \"create_task\"|\"create_nugget\", title, description, priority?, stage?, kind?, memberReferenceId?, clientId?, folderId? }`.",
+      "- Omadeus **Task** and **Nugget** are distinct product types (Jaguar `subscribableKind`). **Project**, **Sprint**, **Release**, **Folder**, **Client**, **Summary**, etc. also have entity chat rooms. User \"task\" / \"the task\" → map to **this room's** `subscribableKind` (Task vs Nugget vs other), not an OpenClaw background task.",
+      "- In Task or Nugget rooms, inbound may include **Dolphin nuggetviews** JSON for this chat's `roomId` — **summarize that** for status questions. The payload may include a **`people`** object (Omadeus member names). Use those for assignees; do not read `referenceId` numbers as names. Do not tell the user to go use the Omadeus app instead of answering from that data or the thread.",
+      "- `session_status` / SessionKey: **OpenClaw** gateway only. Use the inbound SessionKey, \"current\", or the hint in **entity** rooms — never a fake `task/<...>` string from a title.",
       `- Reactions only allow these emojis (others are ignored): ${ALLOWED_OMADEUS_REACTION_EMOJI_LIST.join(" ")}`,
       "- Reply in chat with plain text; use the message tool for proactive sends, edits, deletes, or reactions.",
     ],
@@ -711,6 +710,7 @@ export const omadeusPlugin: ChannelPlugin<Account> = {
         runtime: ctx.runtime,
         log,
         outboundDeps,
+        selfReferenceId,
       });
 
       // Jaguar socket (chat — DMs, nugget/task/project rooms)