@brantrusnak/openclaw-omadeus 1.0.0

package/src/api/message.api.ts

@@ -0,0 +1,241 @@
+import type { OmadeusMessage } from "../types.js";
+import { jaguarFetch, generateTemporaryId, type OmadeusApiOptions } from "../utils/http.util.js";
+
+async function readJsonOrEmpty(res: Response): Promise<unknown> {
+  if (res.status === 204) {
+    return undefined;
+  }
+  const text = await res.text();
+  const trimmed = text.trim();
+  if (!trimmed) {
+    return undefined;
+  }
+  try {
+    return JSON.parse(trimmed) as unknown;
+  } catch {
+    return trimmed;
+  }
+}
+
+export async function sendRoomMessage(
+  opts: OmadeusApiOptions,
+  params: { roomId: number | string; body: string },
+): Promise<{ ok: boolean; message?: OmadeusMessage; error?: string }> {
+  try {
+    const res = await jaguarFetch(opts, `/rooms/${params.roomId}/messages`, {
+      method: "SEND",
+      body: JSON.stringify({
+        body: params.body,
+        temporaryId: generateTemporaryId(),
+        links: "[]",
+      }),
+    });
+    if (!res.ok) {
+      const text = await res.text().catch(() => "");
+      return { ok: false, error: `${res.status}: ${text.slice(0, 200)}` };
+    }
+    const data = (await res.json()) as OmadeusMessage;
+    return { ok: true, message: data };
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    return { ok: false, error: message.slice(0, 300) };
+  }
+}
+
+export async function listRoomMessages(
+  opts: OmadeusApiOptions,
+  params: { roomId: number | string; skip?: number; take?: number; sort?: string },
+): Promise<OmadeusMessage[]> {
+  const search = new URLSearchParams();
+  if (params.sort) search.set("sort", params.sort);
+  if (typeof params.skip === "number") search.set("skip", String(params.skip));
+  if (typeof params.take === "number") search.set("take", String(params.take));
+  const qs = search.toString();
+
+  const res = await jaguarFetch(opts, `/rooms/${params.roomId}/messageviews${qs ? `?${qs}` : ""}`, {
+    method: "LIST",
+  });
+  if (!res.ok) {
+    const text = await res.text().catch(() => "");
+    throw new Error(`Omadeus list room messages failed (${res.status}): ${text.slice(0, 200)}`);
+  }
+  return (await res.json()) as OmadeusMessage[];
+}
+
+export async function seeMessage(
+  opts: OmadeusApiOptions,
+  params: { messageId: number | string },
+): Promise<OmadeusMessage> {
+  const res = await jaguarFetch(opts, `/messages/${params.messageId}`, {
+    method: "SEE",
+  });
+  if (!res.ok) {
+    const text = await res.text().catch(() => "");
+    throw new Error(`Omadeus see message failed (${res.status}): ${text.slice(0, 200)}`);
+  }
+  return (await res.json()) as OmadeusMessage;
+}
+
+export async function getMessageById(
+  opts: OmadeusApiOptions,
+  params: { messageId: number | string },
+): Promise<OmadeusMessage> {
+  const res = await jaguarFetch(opts, `/messages/${params.messageId}`, {
+    method: "GET",
+  });
+  if (!res.ok) {
+    const text = await res.text().catch(() => "");
+    throw new Error(`Omadeus get message failed (${res.status}): ${text.slice(0, 200)}`);
+  }
+  return (await res.json()) as OmadeusMessage;
+}
+
+export type OmadeusMessageLink = { title: string; url: string };
+
+export async function replyToMessage(
+  opts: OmadeusApiOptions,
+  params: {
+    messageId: number | string;
+    body: string;
+    temporaryId?: string;
+    links?: OmadeusMessageLink[];
+  },
+): Promise<OmadeusMessage> {
+  const res = await jaguarFetch(opts, `/messages/${params.messageId}`, {
+    method: "REPLY",
+    body: JSON.stringify({
+      body: params.body,
+      temporaryId: params.temporaryId ?? generateTemporaryId(),
+      links: JSON.stringify(params.links ?? []),
+    }),
+  });
+  if (!res.ok) {
+    const text = await res.text().catch(() => "");
+    throw new Error(`Omadeus reply message failed (${res.status}): ${text.slice(0, 200)}`);
+  }
+  return (await res.json()) as OmadeusMessage;
+}
+
+export async function editMessage(
+  opts: OmadeusApiOptions,
+  params: {
+    messageId: number | string;
+    body: string;
+    temporaryId?: string;
+    links?: OmadeusMessageLink[];
+  },
+): Promise<OmadeusMessage> {
+  const res = await jaguarFetch(opts, `/messages/${params.messageId}`, {
+    method: "EDIT",
+    body: JSON.stringify({
+      body: params.body,
+      ...(params.temporaryId ? { temporaryId: params.temporaryId } : {}),
+      ...(params.links ? { links: JSON.stringify(params.links) } : {}),
+    }),
+  });
+  if (!res.ok) {
+    const text = await res.text().catch(() => "");
+    throw new Error(`Omadeus edit message failed (${res.status}): ${text.slice(0, 200)}`);
+  }
+  return (await res.json()) as OmadeusMessage;
+}
+
+export async function deleteMessage(
+  opts: OmadeusApiOptions,
+  params: { messageId: number | string },
+): Promise<OmadeusMessage> {
+  const res = await jaguarFetch(opts, `/messages/${params.messageId}`, {
+    method: "DELETE",
+  });
+  if (!res.ok) {
+    const text = await res.text().catch(() => "");
+    throw new Error(`Omadeus delete message failed (${res.status}): ${text.slice(0, 200)}`);
+  }
+  return (await res.json()) as OmadeusMessage;
+}
+
+export async function pinMessage(
+  opts: OmadeusApiOptions,
+  params: { messageId: number | string },
+): Promise<OmadeusMessage> {
+  const res = await jaguarFetch(opts, `/messages/${params.messageId}`, {
+    method: "PIN",
+  });
+  if (!res.ok) {
+    const text = await res.text().catch(() => "");
+    throw new Error(`Omadeus pin message failed (${res.status}): ${text.slice(0, 200)}`);
+  }
+  return (await res.json()) as OmadeusMessage;
+}
+
+export async function unpinMessage(
+  opts: OmadeusApiOptions,
+  params: { messageId: number | string },
+): Promise<OmadeusMessage> {
+  const res = await jaguarFetch(opts, `/messages/${params.messageId}`, {
+    method: "UNPIN",
+  });
+  if (!res.ok) {
+    const text = await res.text().catch(() => "");
+    throw new Error(`Omadeus unpin message failed (${res.status}): ${text.slice(0, 200)}`);
+  }
+  return (await res.json()) as OmadeusMessage;
+}
+
+export async function listMessageViewers(
+  opts: OmadeusApiOptions,
+  params: { messageId: number | string },
+): Promise<unknown[]> {
+  const res = await jaguarFetch(opts, `/messages/${params.messageId}/seen/members`, {
+    method: "LIST",
+  });
+  if (!res.ok) {
+    const text = await res.text().catch(() => "");
+    throw new Error(`Omadeus list message viewers failed (${res.status}): ${text.slice(0, 200)}`);
+  }
+  return (await res.json()) as unknown[];
+}
+
+export async function addMessageReaction(
+  opts: OmadeusApiOptions,
+  params: { messageId: number | string; emoji: string },
+): Promise<unknown> {
+  const res = await jaguarFetch(opts, `/messages/${params.messageId}/reactions`, {
+    method: "ADD",
+    body: JSON.stringify({ emoji: params.emoji }),
+  });
+  if (!res.ok) {
+    const text = await res.text().catch(() => "");
+    throw new Error(`Omadeus add reaction failed (${res.status}): ${text.slice(0, 200)}`);
+  }
+  // Success is often 204 No Content with no body.
+  return readJsonOrEmpty(res);
+}
+
+export async function listMessageReactions(
+  opts: OmadeusApiOptions,
+  params: { messageId: number | string },
+): Promise<unknown[]> {
+  const res = await jaguarFetch(opts, `/messages/${params.messageId}/reactions`, {
+    method: "LIST",
+  });
+  if (!res.ok) {
+    const text = await res.text().catch(() => "");
+    throw new Error(`Omadeus list reactions failed (${res.status}): ${text.slice(0, 200)}`);
+  }
+  return (await res.json()) as unknown[];
+}
+
+export async function removeMessageReactions(
+  opts: OmadeusApiOptions,
+  params: { messageId: number | string },
+): Promise<unknown> {
+  const res = await jaguarFetch(opts, `/messages/${params.messageId}/reactions`, {
+    method: "REMOVE",
+  });
+  if (!res.ok) {
+    const text = await res.text().catch(() => "");
+    throw new Error(`Omadeus remove reactions failed (${res.status}): ${text.slice(0, 200)}`);
+  }
+  return readJsonOrEmpty(res);
+}

package/src/api/nugget.api.ts

@@ -0,0 +1,148 @@
+import { dolphinFetch, type OmadeusApiOptions } from "../utils/http.util.js";
+
+type NuggetSearchParams = {
+  /** Display nugget id from user text (e.g. N111 → 111). Matches API field `number`, not internal `id`. */
+  nuggetNumber: number;
+  signal?: AbortSignal;
+};
+
+export type OmadeusNuggetPriority = "low" | "medium" | "high" | "urgent";
+export type OmadeusNuggetKind = "task" | "nugget";
+
+export type CreateNuggetParams = {
+  title: string;
+  description: string;
+  stage: string;
+  kind: OmadeusNuggetKind;
+  priority: OmadeusNuggetPriority;
+  memberReferenceId: number;
+  clientId: number;
+  folderId: number;
+  signal?: AbortSignal;
+};
+
+/** Omadeus nugget/task display number (`N###` in UI maps to this field). */
+export function readNuggetNumber(record: Record<string, unknown>): number | undefined {
+  const value = record["number"];
+  if (typeof value === "number" && Number.isFinite(value)) {
+    return value;
+  }
+  if (typeof value === "string" && /^\d+$/.test(value.trim())) {
+    return Number(value.trim());
+  }
+  return undefined;
+}
+
+function readNumberField(
+  record: Record<string, unknown>,
+  key: string,
+): number | undefined {
+  const value = record[key];
+  if (typeof value === "number" && Number.isFinite(value)) {
+    return value;
+  }
+  if (typeof value === "string" && /^\d+$/.test(value.trim())) {
+    return Number(value.trim());
+  }
+  return undefined;
+}
+
+export function findNuggetRowByNumber(
+  rows: Record<string, unknown>[],
+  nuggetNumber: number,
+): Record<string, unknown> | undefined {
+  return rows.find((row) => readNuggetNumber(row) === nuggetNumber);
+}
+
+export function resolveTaskChannelRoomId(record: Record<string, unknown>): number | undefined {
+  return (
+    readNumberField(record, "privateRoomId") ??
+    readNumberField(record, "publicRoomId") ??
+    readNumberField(record, "sharedRoomId")
+  );
+}
+
+function extractRows(payload: unknown): Record<string, unknown>[] {
+  if (Array.isArray(payload)) {
+    return payload.filter(
+      (entry): entry is Record<string, unknown> => !!entry && typeof entry === "object",
+    );
+  }
+  if (!payload || typeof payload !== "object") {
+    return [];
+  }
+  const envelope = payload as Record<string, unknown>;
+  const candidateKeys = ["data", "results", "items", "rows"];
+  for (const key of candidateKeys) {
+    const value = envelope[key];
+    if (Array.isArray(value)) {
+      return value.filter(
+        (entry): entry is Record<string, unknown> => !!entry && typeof entry === "object",
+      );
+    }
+  }
+  return [];
+}
+
+/**
+ * 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 query = `N${params.nuggetNumber}`;
+  const search = new URLSearchParams();
+  search.set("take", "100");
+
+  const res = await dolphinFetch(opts, `/nuggetviews?${search.toString()}`, {
+    method: "SEARCH",
+    body: JSON.stringify({ query }),
+    signal: params.signal,
+  });
+  if (!res.ok) {
+    const text = await res.text().catch(() => "");
+    throw new Error(`Omadeus nugget search failed (${res.status}): ${text.slice(0, 200)}`);
+  }
+  const payload = (await res.json()) as unknown;
+  const rows = extractRows(payload);
+  const match = findNuggetRowByNumber(rows, params.nuggetNumber);
+  return match ?? null;
+}
+
+export async function resolveTaskRoomIdByNumber(
+  opts: OmadeusApiOptions,
+  params: NuggetSearchParams,
+): Promise<number | null> {
+  const row = await searchNuggetByNumber(opts, params);
+  if (!row) {
+    return null;
+  }
+  return resolveTaskChannelRoomId(row) ?? null;
+}
+
+export async function createNugget(
+  opts: OmadeusApiOptions,
+  params: CreateNuggetParams,
+): Promise<Record<string, unknown>> {
+  const res = await dolphinFetch(opts, "/nuggets", {
+    method: "CREATE",
+    body: JSON.stringify({
+      title: params.title,
+      stage: params.stage,
+      description: params.description,
+      kind: params.kind,
+      priority: params.priority,
+      memberReferenceId: params.memberReferenceId,
+      clientId: params.clientId,
+      folderId: params.folderId,
+    }),
+    signal: params.signal,
+  });
+  if (!res.ok) {
+    const text = await res.text().catch(() => "");
+    throw new Error(`Omadeus nugget create failed (${res.status}): ${text.slice(0, 200)}`);
+  }
+  return (await res.json()) as Record<string, unknown>;
+}

package/src/auth.ts

@@ -0,0 +1,33 @@
+import { createAuthorizationCode, createCasToken, obtainSessionToken } from "./api/auth.api.js";
+import { clearCasSession } from "./store.js";
+import type { OmadeusJwtPayload } from "./types.js";
+import { decodeJwtPayload } from "./utils/jwt.util.js";
+
+export async function authenticate(params: {
+  casUrl: string;
+  maestroUrl: string;
+  email: string;
+  password: string;
+  organizationId: number;
+}): Promise<{ dolphinToken: string; payload: OmadeusJwtPayload }> {
+  const { casUrl, maestroUrl, email, password, organizationId } = params;
+  const { token } = await createCasToken({ casUrl, email, password });
+
+  const authorizationCode = await createAuthorizationCode({
+    casUrl,
+    token,
+    email,
+    redirectUri: maestroUrl,
+  });
+  // CAS session no longer needed after obtaining the authorization code
+  clearCasSession();
+
+  const dolphinToken = await obtainSessionToken({
+    maestroUrl,
+    authorizationCode,
+    organizationId,
+  });
+  const payload = decodeJwtPayload(dolphinToken);
+
+  return { dolphinToken, payload };
+}