@brantrusnak/openclaw-omadeus 1.0.1 → 1.0.3

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;
 }