@brantrusnak/openclaw-omadeus 1.0.0

package/src/types.ts

@@ -0,0 +1,186 @@
+// ---------------------------------------------------------------------------
+// Omadeus config shape (stored under channels.omadeus in OpenClaw config)
+// ---------------------------------------------------------------------------
+
+export type OmadeusChannelConfig = {
+  enabled?: boolean;
+  casUrl?: string;
+  maestroUrl?: string;
+  email?: string;
+  password?: string;
+  organizationId?: number;
+  /** Cached Omadeus session JWT obtained during onboarding/startup. */
+  sessionToken?: string;
+  /** Selected member reference ID (account) used by onboarding. */
+  selectedMemberReferenceId?: number;
+  /** Selected channel metadata used for inbound filtering. */
+  selectedChannelViewId?: number;
+  selectedChannelTitle?: string;
+  selectedChannelPrivateRoomId?: number;
+  selectedChannelPublicRoomId?: number;
+};
+
+export type ResolvedOmadeusAccount = {
+  accountId: string;
+  name?: string;
+  enabled: boolean;
+  config: OmadeusChannelConfig;
+  casUrl: string;
+  maestroUrl: string;
+  email: string;
+  password: string;
+  organizationId: number;
+  sessionToken?: string;
+  /** "none" if neither config/env credentials nor cached session token exist */
+  credentialSource: "config" | "env" | "session" | "none";
+};
+
+// ---------------------------------------------------------------------------
+// CAS auth types
+// ---------------------------------------------------------------------------
+
+export type CasTokenResponse = {
+  token?: string;
+};
+
+export type CasAuthorizationCodeResponse = {
+  authorizationCode?: string;
+  code?: string;
+};
+
+export type OmadeusSessionTokenResponse = {
+  token: string;
+};
+
+export type OmadeusOrganization = {
+  id: number;
+  title: string;
+  plan: string;
+  membersCount: number;
+  createdAt: string;
+};
+
+export type OmadeusOrganizationMember = {
+  referenceId: number;
+  id: number;
+  firstName?: string;
+  lastName?: string;
+  title?: string;
+  email?: string;
+  isSystem?: boolean;
+};
+
+export type OmadeusChannelView = {
+  id: number;
+  title: string;
+  type?: string;
+  privateRoomId?: number | null;
+  publicRoomId?: number | null;
+  privateRoomTitle?: string | null;
+  publicRoomTitle?: string | null;
+};
+
+// ---------------------------------------------------------------------------
+// JWT decoded payload (only fields we need)
+// ---------------------------------------------------------------------------
+
+export type OmadeusJwtPayload = {
+  id: number;
+  email: string;
+  firstName?: string;
+  lastName?: string;
+  title?: string;
+  referenceId: number;
+  sessionId: string;
+  organizationId: number;
+  roles: string[];
+  exp: number;
+};
+
+// ---------------------------------------------------------------------------
+// Jaguar socket message (chat — DMs, nugget rooms, task rooms, etc.)
+// ---------------------------------------------------------------------------
+
+export type OmadeusSubscribableType =
+  | "direct"
+  | "channel"
+  | "nugget"
+  | "project"
+  | "sprint"
+  | "release"
+  | "summary"
+  | "client"
+  | "folder"
+  | (string & {});
+export type OmadeusSubscribableKind =
+  | "task"
+  | "direct"
+  | "channel"
+  | "nugget"
+  | "project"
+  | "sprint"
+  | "release"
+  | "summary"
+  | "client"
+  | "folder"
+  | (string & {});
+
+export type OmadeusMessage = {
+  id: number;
+  temporaryId?: string;
+  type: "message";
+  roomId: number;
+  senderId: number;
+  senderReferenceId: number;
+  organizationId: number;
+  body: string;
+  roomName: string | null;
+  subscribableType: OmadeusSubscribableType;
+  subscribableKind: OmadeusSubscribableKind;
+  createdAtTimestamp: number;
+  mimetype: string;
+  filename: string | null;
+  fileLength: number | null;
+  duration: number | null;
+  details: string | null;
+  replyRootId: number | null;
+  attachmentUrl: string | null;
+  speechFileUrl: string | null;
+  reactions: Record<string, unknown>;
+  threadRoomId: number | null;
+  replyTo: unknown | null;
+  createdAt: string;
+  removedAt: string | null;
+  metadata: unknown | null;
+  isMute: boolean;
+  isSeen: boolean;
+};
+
+/** Parsed details.rawMessage field for @mention detection. */
+export type OmadeusMessageDetails = {
+  rawMessage?: string;
+};
+
+// ---------------------------------------------------------------------------
+// Dolphin socket events (task/data — assignments, updates, etc.)
+// ---------------------------------------------------------------------------
+
+export type DolphinSocketEvent = Record<string, unknown>;
+
+// ---------------------------------------------------------------------------
+// Inbound message (normalized for OpenClaw)
+// ---------------------------------------------------------------------------
+
+export type OmadeusInboundMessage = {
+  /** Jaguar message id (used for reactions, replies, etc.). */
+  messageId: number;
+  from: string;
+  fromReferenceId: number;
+  content: string;
+  roomId: number;
+  roomName: string | null;
+  subscribableType: OmadeusSubscribableType;
+  subscribableKind: OmadeusSubscribableKind;
+  isMention: boolean;
+  timestamp: number;
+};

package/src/utils/http.util.ts

@@ -0,0 +1,62 @@
+import { randomUUID } from "node:crypto";
+import type { OmadeusTokenManager } from "../token.js";
+
+export type OmadeusApiOptions = {
+  maestroUrl: string;
+  tokenManager: OmadeusTokenManager;
+};
+
+export function authHeaders(token: string): Record<string, string> {
+  return {
+    Authorization: `Bearer ${token}`,
+    "Content-Type": "application/json",
+  };
+}
+
+export async function apiFetch(
+  opts: OmadeusApiOptions,
+  path: string,
+  init?: RequestInit,
+): Promise<Response> {
+  const token = opts.tokenManager.getToken();
+  if (!token) throw new Error("Omadeus: not authenticated");
+  const url = `${opts.maestroUrl}${path}`;
+  try {
+    return await fetch(url, {
+      ...init,
+      headers: { ...authHeaders(token), ...(init?.headers as Record<string, string>) },
+    });
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    throw new Error(`Omadeus API request to ${url} failed: ${message}`);
+  }
+}
+
+function withApiPrefix(prefix: string, path: string): string {
+  if (!path) return prefix;
+  if (path.startsWith("/")) return `${prefix}${path}`;
+  return `${prefix}/${path}`;
+}
+
+const JAGUAR_PREFIX = "/jaguar/apiv1";
+const DOLPHIN_PREFIX = "/dolphin/apiv1";
+
+export async function jaguarFetch(
+  opts: OmadeusApiOptions,
+  path: string,
+  init?: RequestInit,
+): Promise<Response> {
+  return apiFetch(opts, withApiPrefix(JAGUAR_PREFIX, path), init);
+}
+
+export async function dolphinFetch(
+  opts: OmadeusApiOptions,
+  path: string,
+  init?: RequestInit,
+): Promise<Response> {
+  return apiFetch(opts, withApiPrefix(DOLPHIN_PREFIX, path), init);
+}
+
+export function generateTemporaryId(): string {
+  return `_${randomUUID().replace(/-/g, "").slice(0, 10)}`;
+}

package/src/utils/jwt.util.ts

@@ -0,0 +1,17 @@
+import type { OmadeusJwtPayload } from "../types.js";
+
+/** Decode the payload portion of a JWT without verifying the signature. */
+export function decodeJwtPayload(token: string): OmadeusJwtPayload {
+  const parts = token.split(".");
+  if (parts.length !== 3) {
+    throw new Error("Invalid JWT: expected 3 parts");
+  }
+  const payload = Buffer.from(parts[1]!, "base64url").toString("utf-8");
+  return JSON.parse(payload) as OmadeusJwtPayload;
+}
+
+/** Returns ms until the token expires (negative = already expired). */
+export function tokenExpiresInMs(token: string): number {
+  const { exp } = decodeJwtPayload(token);
+  return exp * 1000 - Date.now();
+}