@brantrusnak/openclaw-omadeus 1.0.3 → 1.0.5

package/README.md

@@ -1,61 +1,44 @@
 # OpenClaw Omadeus Plugin
 
-[Omadeus](https://omadeus.com) plugin for [OpenClaw](https://www.npmjs.com/package/openclaw).
+[![Socket Badge](https://badge.socket.dev/npm/package/@brantrusnak/openclaw-omadeus)](https://badge.socket.dev/npm/package/@brantrusnak/openclaw-omadeus)
+[![CI](https://github.com/brantrusnak/openclaw-omadeus-plugin/actions/workflows/npm-publish.yml/badge.svg)](https://github.com/brantrusnak/openclaw-omadeus-plugin/actions/workflows/npm-publish.yml)
+[![npm version](https://img.shields.io/npm/v/@brantrusnak/openclaw-omadeus)](https://www.npmjs.com/package/@brantrusnak/openclaw-omadeus)
+[![License: ISC](https://img.shields.io/npm/l/@brantrusnak/openclaw-omadeus)](https://www.npmjs.com/package/@brantrusnak/openclaw-omadeus)
 
-This plugin connects OpenClaw to Omadeus over WebSocket so OpenClaw can listen
-for Omadeus messages and reply through the selected Omadeus channel.
+[Omadeus](https://omadeus.com) plugin for [OpenClaw](https://www.npmjs.com/package/openclaw).
 
 ## 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
+- An Omadeus account
 
 ## Install
 
-Install OpenClaw first:
-
 ```bash
 npm install -g openclaw
+openclaw plugins install @brantrusnak/openclaw-omadeus
 ```
 
-Set up OpenClaw if you have not already:
-
-```bash
-openclaw onboard
-```
-
-Then install this plugin with the OpenClaw plugin command:
+Verify the plugin was installed:
 
 ```bash
-openclaw plugins install @brantrusnak/openclaw-omadeus
+openclaw plugins list
 ```
 
-You can confirm OpenClaw discovered the plugin with:
+Then run setup:
 
 ```bash
-openclaw plugins list
-openclaw plugins inspect omadeus
+openclaw onboard
 ```
 
 ## 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:
+You can also set credentials via environment variables:
 
 ```bash
 export OMADEUS_EMAIL="you@example.com"
@@ -63,48 +46,16 @@ 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:
+## Start
 
 ```bash
 openclaw gateway
 ```
 
-Check channel health with:
-
-```bash
-openclaw channels status --deep
-openclaw plugins doctor
-```
-
 ## Local Development
 
-Build the runtime files before linking a local checkout into OpenClaw:
-
 ```bash
 npm install
 npm run build
 openclaw plugins install . --link
 ```
-
-Before publishing, inspect the npm package contents:
-
-```bash
-npm run prepack
-npm pack --dry-run
-```
-
-Publish to npm:
-
-```bash
-npm publish
-```

package/dist/src/api/auth.api.js

@@ -2,20 +2,29 @@ import { getCasSession, setCasSession } from "../store.js";
 //#region src/api/auth.api.ts
 const CAS_APPLICATION_ID = 1;
 const CAS_SCOPES = "title,email,avatar,firstName,lastName,birth,phone,countryCode";
+function formatFetchError(label, url, method, err) {
+	const base = err instanceof Error ? err.message : String(err);
+	const cause = err instanceof Error && err.cause instanceof Error ? err.cause.message : void 0;
+	const detail = cause && cause !== base ? `${base} (${cause})` : base;
+	return /* @__PURE__ */ new Error(`${label} (${method} ${url}) failed: ${detail}`);
+}
+async function omadeusFetch(label, url, init) {
+	const method = init.method ?? "GET";
+	try {
+		return await fetch(url, init);
+	} catch (err) {
+		throw formatFetchError(label, url, method, err);
+	}
+}
 async function createCasToken(params) {
 	const { casUrl, email, password } = params;
-	const url = `${casUrl}/apiv1/tokens`;
-	const jsonBody = JSON.stringify({
-		email,
-		password
-	});
-	const res = await fetch(url, {
+	const res = await omadeusFetch("CAS token request", `${casUrl}/apiv1/tokens`, {
 		method: "CREATE",
-		headers: {
-			"Content-Type": "application/json;charset=UTF-8",
-			"Content-Length": String(jsonBody.length)
-		},
-		body: jsonBody
+		headers: { "Content-Type": "application/json;charset=UTF-8" },
+		body: JSON.stringify({
+			email,
+			password
+		})
 	});
 	if (!res.ok) {
 		const text = await res.text().catch(() => "");
@@ -42,16 +51,13 @@ async function createAuthorizationCode(params) {
 		redirectUri: redirectUri ?? ""
 	});
 	if (redirectUri) qs.set("redirectUri", redirectUri);
-	const url = `${casUrl}/apiv1/authorizationcodes?${qs}`;
-	const body = "";
-	const headers = {
-		Authorization: `Bearer ${token}`,
-		...casSession?.refreshCookie ? { Cookie: casSession.refreshCookie } : {}
-	};
-	const res = await fetch(url, {
+	const res = await omadeusFetch("CAS authorization code request", `${casUrl}/apiv1/authorizationcodes?${qs}`, {
 		method: "CREATE",
-		body,
-		headers
+		body: "",
+		headers: {
+			Authorization: `Bearer ${token}`,
+			...casSession?.refreshCookie ? { Cookie: casSession.refreshCookie } : {}
+		}
 	});
 	if (!res.ok) {
 		const text = await res.text().catch(() => "");
@@ -64,8 +70,7 @@ async function createAuthorizationCode(params) {
 }
 async function obtainSessionToken(params) {
 	const { maestroUrl, authorizationCode, organizationId } = params;
-	const url = `${maestroUrl}/dolphin/apiv1/oauth2/tokens`;
-	const res = await fetch(url, {
+	const res = await omadeusFetch("Omadeus session token request", `${maestroUrl}/dolphin/apiv1/oauth2/tokens`, {
 		method: "OBTAIN",
 		headers: { "Content-Type": "application/json;charset=UTF-8" },
 		body: JSON.stringify({
@@ -83,8 +88,7 @@ async function obtainSessionToken(params) {
 }
 async function listOrganizations(params) {
 	const { maestroUrl, email } = params;
-	const url = `${maestroUrl}/dolphin/apiv1/organizations`;
-	const res = await fetch(url, {
+	const res = await omadeusFetch("Omadeus list organizations", `${maestroUrl}/dolphin/apiv1/organizations`, {
 		method: "LIST",
 		headers: { "Content-Type": "application/json;charset=UTF-8" },
 		body: JSON.stringify({ email })
@@ -97,8 +101,7 @@ async function listOrganizations(params) {
 }
 async function listOrganizationMembers(params) {
 	const { maestroUrl, sessionToken, organizationId } = params;
-	const url = `${maestroUrl}/dolphin/apiv1/organizations/${organizationId}/members`;
-	const res = await fetch(url, {
+	const res = await omadeusFetch("Omadeus list organization members", `${maestroUrl}/dolphin/apiv1/organizations/${organizationId}/members`, {
 		method: "LIST",
 		headers: {
 			Authorization: `Bearer ${sessionToken}`,

package/dist/src/channel.js

@@ -27,10 +27,11 @@ const gatewayState = {
 };
 const isUnconfigured = (account) => account.credentialSource === "none";
 let lastPersistedToken = null;
-async function persistSessionToken(token) {
+async function persistSessionToken(token, environment) {
 	if (lastPersistedToken === token) return;
 	const runtime = getOmadeusRuntime();
-	if ((getOmadeusChannelConfig(runtime.config.current()) ?? {}).sessionToken === token) {
+	const section = getOmadeusChannelConfig(runtime.config.current()) ?? {};
+	if (section.sessionToken === token && section.sessionTokenEnvironment === environment) {
 		lastPersistedToken = token;
 		return;
 	}
@@ -41,7 +42,8 @@ async function persistSessionToken(token) {
 				...draft.channels ?? {},
 				omadeus: {
 					...getOmadeusChannelConfig(draft) ?? {},
-					sessionToken: token
+					sessionToken: token,
+					sessionTokenEnvironment: environment
 				}
 			};
 		}
@@ -82,12 +84,12 @@ const omadeusConfigAdapter = createTopLevelChannelConfigAdapter({
 	defaultAccountId: resolveDefaultOmadeusAccountId,
 	deleteMode: "clear-fields",
 	clearBaseFields: [
-		"casUrl",
-		"maestroUrl",
+		"environment",
 		"email",
 		"password",
 		"organizationId",
 		"sessionToken",
+		"sessionTokenEnvironment",
 		"inbound"
 	],
 	resolveAllowFrom: () => [],
@@ -473,7 +475,7 @@ const omadeusPlugin = {
 			initialToken: account.sessionToken,
 			onRefresh: (token) => {
 				log.info("[omadeus] token refreshed");
-				persistSessionToken(token).catch((err) => log.warn(`[omadeus] failed to persist session token: ${String(err)}`));
+				persistSessionToken(token, account.environment).catch((err) => log.warn(`[omadeus] failed to persist session token: ${String(err)}`));
 			},
 			onError: (err) => {
 				log.error(`[omadeus] token refresh failed: ${err.message}`);

package/dist/src/config.js

@@ -1,5 +1,5 @@
 import { DEFAULT_ACCOUNT_ID } from "../runtime-api.js";
-import "./defaults.js";
+import { getOmadeusEnvironmentUrls, resolveOmadeusEnvironment } from "./defaults.js";
 //#region src/config.ts
 function getOmadeusChannelConfig(cfg) {
 	return cfg.channels?.["omadeus"];
@@ -14,11 +14,15 @@ function resolveDefaultOmadeusAccountId(_cfg) {
 function resolveOmadeusAccount(params) {
 	const { cfg } = params;
 	const section = getOmadeusChannelConfig(cfg) ?? {};
+	const environment = resolveOmadeusEnvironment(section.environment);
+	const { casUrl, maestroUrl } = getOmadeusEnvironmentUrls(environment);
 	const envCredentials = resolveOmadeusEnvCredentials();
 	const email = section.email?.trim() || envCredentials?.email || "";
 	const password = section.password?.trim() || envCredentials?.password || "";
 	const orgId = section.organizationId ?? envCredentials?.organizationId;
-	const sessionToken = section.sessionToken?.trim() ?? "";
+	const rawSessionToken = section.sessionToken?.trim() ?? "";
+	const sessionTokenEnvironment = resolveOmadeusEnvironment(section.sessionTokenEnvironment);
+	const sessionToken = Boolean(rawSessionToken) && sessionTokenEnvironment === environment ? rawSessionToken : "";
 	const hasCredentials = Boolean(email && password && orgId);
 	const hasSessionToken = Boolean(sessionToken);
 	const credentialSource = Boolean(section.email?.trim() && section.password?.trim() && section.organizationId) ? "config" : hasCredentials ? "env" : hasSessionToken ? "session" : "none";
@@ -27,8 +31,9 @@ function resolveOmadeusAccount(params) {
 		name: "Omadeus",
 		enabled: section.enabled !== false,
 		config: section,
-		casUrl: section.casUrl?.trim() || "https://dev1-cas.rouztech.com",
-		maestroUrl: section.maestroUrl?.trim() || "https://dev3-maestro.rouztech.com",
+		environment,
+		casUrl,
+		maestroUrl,
 		email,
 		password,
 		organizationId: orgId ?? 0,

package/dist/src/defaults.js

@@ -1,5 +1,31 @@
-//#region src/defaults.ts
-const OMADEUS_CAS_URL = "https://dev1-cas.rouztech.com";
-const OMADEUS_MAESTRO_URL = "https://dev3-maestro.rouztech.com";
+const OMADEUS_ENVIRONMENTS = {
+	production: {
+		label: "Production",
+		casUrl: "https://xas.xeba.tech",
+		maestroUrl: "https://maestro.xeba.tech"
+	},
+	staging: {
+		label: "Staging",
+		casUrl: "https://staging-xas.xeba.tech",
+		maestroUrl: "https://staging.xeba.tech"
+	},
+	dev: {
+		label: "Dev",
+		casUrl: "https://dev1-cas.rouztech.com",
+		maestroUrl: "https://dev1-maestro.rouztech.com"
+	}
+};
+const OMADEUS_ENVIRONMENT_SET = new Set(Object.keys(OMADEUS_ENVIRONMENTS));
+function resolveOmadeusEnvironment(value) {
+	if (typeof value === "string" && OMADEUS_ENVIRONMENT_SET.has(value)) return value;
+	return "dev";
+}
+function getOmadeusEnvironmentUrls(env) {
+	const config = OMADEUS_ENVIRONMENTS[env];
+	return {
+		casUrl: config.casUrl,
+		maestroUrl: config.maestroUrl
+	};
+}
 //#endregion
-export { OMADEUS_CAS_URL, OMADEUS_MAESTRO_URL };
+export { OMADEUS_ENVIRONMENTS, getOmadeusEnvironmentUrls, resolveOmadeusEnvironment };

package/dist/src/onboarding.js

@@ -1,4 +1,4 @@
-import { OMADEUS_CAS_URL, OMADEUS_MAESTRO_URL } from "./defaults.js";
+import { OMADEUS_ENVIRONMENTS, getOmadeusEnvironmentUrls, resolveOmadeusEnvironment } from "./defaults.js";
 import { getOmadeusChannelConfig, resolveOmadeusAccount } from "./config.js";
 import { listOrganizationMembers, listOrganizations } from "./api/auth.api.js";
 import { formatMemberLabel } from "./member-resolve.js";
@@ -8,18 +8,37 @@ import { authenticate } from "./auth.js";
 import { DEFAULT_ACCOUNT_ID } from "openclaw/plugin-sdk/setup";
 //#region src/onboarding.ts
 const channel = "omadeus";
-const DONE = "__done__";
-async function noteOmadeusAuthHelp(prompter) {
+function formatAuthError(err) {
+	if (!(err instanceof Error)) return String(err);
+	const parts = [err.message];
+	const { cause } = err;
+	if (cause instanceof Error) {
+		parts.push(cause.message);
+		const code = cause.code;
+		if (typeof code === "string" && code) parts.push(`(${code})`);
+	} else if (typeof cause === "string" && cause.trim()) parts.push(cause);
+	return parts.join(" — ");
+}
+async function noteOmadeusAuthHelp(prompter, environment) {
+	const envLabel = OMADEUS_ENVIRONMENTS[environment].label;
 	await prompter.note([
-		"Omadeus authenticates via CAS + Maestro (email + password + organization).",
-		"You need:",
-		"  - Email + password",
-		"  - Organization ID (we can look it up for you)",
-		`CAS URL: ${OMADEUS_CAS_URL}`,
-		`Maestro URL: ${OMADEUS_MAESTRO_URL}`,
-		"Env vars supported: OMADEUS_EMAIL, OMADEUS_PASSWORD, OMADEUS_ORGANIZATION_ID."
+		`Connect OpenClaw to Omadeus (${envLabel}).`,
+		"",
+		"We'll ask for your email and password, then show the organizations on your account so you can pick one."
 	].join("\n"), "Omadeus setup");
 }
+async function promptEnvironment(prompter, existing) {
+	const initial = existing ?? "dev";
+	return resolveOmadeusEnvironment(await prompter.select({
+		message: "Select Omadeus environment",
+		options: Object.keys(OMADEUS_ENVIRONMENTS).map((env) => ({
+			value: env,
+			label: OMADEUS_ENVIRONMENTS[env].label,
+			hint: getOmadeusEnvironmentUrls(env).maestroUrl
+		})),
+		initialValue: initial
+	}));
+}
 async function promptOrganizationId(params) {
 	const { prompter, maestroUrl, email, existing } = params;
 	try {
@@ -66,7 +85,14 @@ async function promptChannelSelection(params) {
 		skip: 0,
 		take: 100
 	});
-	if (channels.length === 0) throw new Error("No channels found for this account.");
+	if (channels.length === 0) {
+		await prompter.note("No channels found for this account. Channel listening will stay disabled.", "Omadeus channels");
+		return [];
+	}
+	if (!await prompter.confirm({
+		message: "Listen for messages in Omadeus channels?",
+		initialValue: (existingChannelViewIds?.length ?? 0) > 0
+	})) return [];
 	const selected = await promptMultiSelect({
 		prompter,
 		message: "Which channels should OpenClaw listen to?",
@@ -75,11 +101,9 @@ async function promptChannelSelection(params) {
 			label: item.title || `Channel ${item.id}`,
 			hint: [item.privateRoomId ? `private:${item.privateRoomId}` : void 0, item.publicRoomId ? `public:${item.publicRoomId}` : void 0].filter(Boolean).join(" | ")
 		})),
-		initialValues: existingChannelViewIds && existingChannelViewIds.length > 0 ? existingChannelViewIds.map(String) : [String(channels[0].id)]
+		initialValues: existingChannelViewIds && existingChannelViewIds.length > 0 ? existingChannelViewIds.map(String) : void 0
 	});
-	const chosen = channels.filter((item) => selected.includes(String(item.id)));
-	if (chosen.length === 0) throw new Error("At least one channel must be selected.");
-	return chosen;
+	return channels.filter((item) => selected.includes(String(item.id)));
 }
 function memberHint(member) {
 	const parts = [
@@ -90,32 +114,11 @@ function memberHint(member) {
 	return parts.length > 0 ? parts.join(" | ") : void 0;
 }
 async function promptMultiSelect(params) {
-	const multi = params.prompter;
-	const runMulti = multi.multiSelect ?? multi.multiselect;
-	if (runMulti) return runMulti({
+	return params.prompter.multiselect({
 		message: params.message,
 		options: params.options,
-		initialValues: params.initialValues,
-		initialValue: params.initialValues
+		initialValues: params.initialValues
 	});
-	const selected = new Set(params.initialValues ?? []);
-	while (true) {
-		const next = await params.prompter.select({
-			message: `${params.message} (${selected.size} selected)`,
-			options: [{
-				value: DONE,
-				label: selected.size > 0 ? "Done" : "Done (select none)"
-			}, ...params.options.map((option) => ({
-				...option,
-				label: selected.has(option.value) ? `[selected] ${option.label}` : option.label
-			}))],
-			initialValue: DONE
-		});
-		const value = String(next);
-		if (value === DONE) return [...selected];
-		if (selected.has(value)) selected.delete(value);
-		else selected.add(value);
-	}
 }
 async function loadSelectableMembers(params) {
 	const excluded = new Set(params.excludeReferenceIds ?? []);
@@ -214,11 +217,11 @@ const omadeusSetupWizard = {
 		const account = resolveOmadeusAccount({ cfg });
 		const section = getOmadeusChannelConfig(cfg) ?? {};
 		let next = cfg;
-		if (account.credentialSource === "none") await noteOmadeusAuthHelp(prompter);
+		const environment = await promptEnvironment(prompter, section.environment ? resolveOmadeusEnvironment(section.environment) : void 0);
+		const { casUrl, maestroUrl } = getOmadeusEnvironmentUrls(environment);
+		if (account.credentialSource === "none") await noteOmadeusAuthHelp(prompter, environment);
 		const envEmail = process.env.OMADEUS_EMAIL?.trim();
 		const envPassword = process.env.OMADEUS_PASSWORD?.trim();
-		const casUrl = OMADEUS_CAS_URL;
-		const maestroUrl = OMADEUS_MAESTRO_URL;
 		let { email, password } = await promptCredentials(prompter, {
 			email: section.email ?? envEmail,
 			password: section.password ?? envPassword
@@ -244,8 +247,7 @@ const omadeusSetupWizard = {
 			await prompter.note(`Authenticated as ${payload.email}`, "Omadeus authentication");
 			break;
 		} catch (err) {
-			const msg = err instanceof Error ? err.message : String(err);
-			await prompter.note(`Authentication failed: ${msg}`, "Omadeus authentication");
+			await prompter.note(`Authentication failed: ${formatAuthError(err)}`, "Omadeus authentication");
 			if (!await prompter.confirm({
 				message: "Re-enter email/password and try again?",
 				initialValue: true
@@ -280,12 +282,12 @@ const omadeusSetupWizard = {
 			memberReferenceId: selfReferenceId,
 			existingChannelViewIds: existingInbound?.channels?.allowedChannelViewIds
 		});
-		const channelSenderIds = await promptSenderAllowlist({
+		const channelSenderIds = selectedChannels.length > 0 ? await promptSenderAllowlist({
 			prompter,
 			message: "Which users can trigger OpenClaw from allowed channels?",
 			members,
 			existingReferenceIds: existingInbound?.channels?.allowedSenderReferenceIds
-		});
+		}) : void 0;
 		const entityKinds = await promptEntityKindSelection({
 			prompter,
 			existingKinds: existingInbound?.entities?.allowedKinds
@@ -301,10 +303,11 @@ const omadeusSetupWizard = {
 		const channelTitles = selectedChannels.map((selectedChannel) => selectedChannel.title || `Channel ${selectedChannel.id}`).join(", ");
 		const senderSummary = (ids) => ids && ids.length > 0 ? ids.join(", ") : "all users";
 		const entityKindSummary = entityKinds.length > 0 ? entityKinds.join(", ") : "none (entity rooms disabled)";
+		const channelSummary = selectedChannels.length > 0 ? `- Channels "${channelTitles}": rooms ${channelRoomIds.join(", ") || "(no room ids)"} from ${senderSummary(channelSenderIds)}; @mention not required in those rooms.` : "- Channels: disabled (none selected).";
 		await prompter.note([
 			`Inbound policy (Jaguar chat):`,
 			`- Direct messages: enabled for ${senderSummary(directSenderIds)} (no @mention required).`,
-			`- Channels "${channelTitles}": rooms ${channelRoomIds.join(", ") || "(no room ids)"} from ${senderSummary(channelSenderIds)}; @mention not required in those rooms.`,
+			channelSummary,
 			`- Entity rooms (${entityKindSummary}): ${senderSummary(entitySenderIds)}; @mention required.`
 		].join("\n"), "Omadeus inbound policy");
 		next = {
@@ -313,12 +316,12 @@ const omadeusSetupWizard = {
 				...next.channels,
 				omadeus: {
 					enabled: true,
-					casUrl,
-					maestroUrl,
+					environment,
 					email,
 					password,
 					organizationId,
 					sessionToken,
+					sessionTokenEnvironment: environment,
 					inbound: {
 						version: 1,
 						direct: {
@@ -327,7 +330,7 @@ const omadeusSetupWizard = {
 							requireMention: "never"
 						},
 						channels: {
-							enabled: true,
+							enabled: selectedChannels.length > 0,
 							allowedRoomIds: channelRoomIds,
 							allowedChannelViewIds: channelViewIds,
 							...channelSenderIds ? { allowedSenderReferenceIds: channelSenderIds } : {},

package/dist/src/setup-core.js

@@ -1,3 +1,4 @@
+import { resolveOmadeusEnvironment } from "./defaults.js";
 //#region src/setup-core.ts
 function readSetupStringField(input, key) {
 	const value = input[key];
@@ -18,8 +19,8 @@ const omadeusSetupAdapter = {
 	},
 	applyAccountConfig: ({ cfg, input }) => {
 		const rawInput = input;
-		const casUrl = input.httpUrl?.trim() || void 0;
-		const maestroUrl = input.url?.trim() || void 0;
+		const environmentRaw = readSetupStringField(rawInput, "environment");
+		const environment = environmentRaw ? resolveOmadeusEnvironment(environmentRaw) : void 0;
 		const email = readSetupStringField(rawInput, "email");
 		const password = input.password?.trim() || void 0;
 		const organizationId = readSetupNumberField(rawInput, "organizationId");
@@ -32,8 +33,7 @@ const omadeusSetupAdapter = {
 				omadeus: {
 					...omadeusPrevious,
 					enabled: true,
-					...casUrl ? { casUrl } : {},
-					...maestroUrl ? { maestroUrl } : {},
+					...environment ? { environment } : {},
 					...email ? { email } : {},
 					...password ? { password } : {},
 					...organizationId ? { organizationId } : {}

package/openclaw.plugin.json

@@ -6,12 +6,18 @@
     "additionalProperties": false,
     "properties": {
       "enabled": { "type": "boolean" },
-      "casUrl": { "type": "string" },
-      "maestroUrl": { "type": "string" },
+      "environment": {
+        "type": "string",
+        "enum": ["production", "staging", "dev"]
+      },
       "email": { "type": "string" },
       "password": { "type": "string" },
       "organizationId": { "type": "number" },
       "sessionToken": { "type": "string" },
+      "sessionTokenEnvironment": {
+        "type": "string",
+        "enum": ["production", "staging", "dev"]
+      },
       "inbound": {
         "type": "object",
         "additionalProperties": false,
@@ -92,12 +98,18 @@
         "additionalProperties": false,
         "properties": {
           "enabled": { "type": "boolean" },
-          "casUrl": { "type": "string" },
-          "maestroUrl": { "type": "string" },
+          "environment": {
+            "type": "string",
+            "enum": ["production", "staging", "dev"]
+          },
           "email": { "type": "string" },
           "password": { "type": "string" },
           "organizationId": { "type": "number" },
           "sessionToken": { "type": "string" },
+          "sessionTokenEnvironment": {
+            "type": "string",
+            "enum": ["production", "staging", "dev"]
+          },
           "inbound": {
             "type": "object",
             "additionalProperties": false,
@@ -172,13 +184,8 @@
         }
       },
       "uiHints": {
-        "casUrl": {
-          "label": "CAS URL",
-          "placeholder": "https://dev1-cas.rouztech.com"
-        },
-        "maestroUrl": {
-          "label": "Maestro URL",
-          "placeholder": "https://dev3-maestro.rouztech.com"
+        "environment": {
+          "label": "Environment"
         },
         "email": {
           "label": "Email"
@@ -195,6 +202,10 @@
           "sensitive": true,
           "advanced": true
         },
+        "sessionTokenEnvironment": {
+          "label": "Session token environment",
+          "advanced": true
+        },
         "inbound": {
           "label": "Inbound policy (Jaguar chat)",
           "advanced": true

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brantrusnak/openclaw-omadeus",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "private": false,
   "description": "OpenClaw Omadeus project management channel plugin",
   "homepage": "https://github.com/brantrusnak/openclaw-omadeus-plugin#readme",

package/src/api/auth.api.ts

@@ -9,6 +9,27 @@ import type {
 const CAS_APPLICATION_ID = 1;
 const CAS_SCOPES = "title,email,avatar,firstName,lastName,birth,phone,countryCode";
 
+function formatFetchError(label: string, url: string, method: string, err: unknown): Error {
+  const base = err instanceof Error ? err.message : String(err);
+  const cause =
+    err instanceof Error && err.cause instanceof Error ? err.cause.message : undefined;
+  const detail = cause && cause !== base ? `${base} (${cause})` : base;
+  return new Error(`${label} (${method} ${url}) failed: ${detail}`);
+}
+
+async function omadeusFetch(
+  label: string,
+  url: string,
+  init: RequestInit,
+): Promise<Response> {
+  const method = init.method ?? "GET";
+  try {
+    return await fetch(url, init);
+  } catch (err) {
+    throw formatFetchError(label, url, method, err);
+  }
+}
+
 export async function createCasToken(params: {
   casUrl: string;
   email: string;
@@ -17,11 +38,10 @@ export async function createCasToken(params: {
   const { casUrl, email, password } = params;
   const url = `${casUrl}/apiv1/tokens`;
   const jsonBody = JSON.stringify({ email, password });
-  const res = await fetch(url, {
+  const res = await omadeusFetch("CAS token request", url, {
     method: "CREATE",
     headers: {
       "Content-Type": "application/json;charset=UTF-8",
-      "Content-Length": String(jsonBody.length),
     },
     body: jsonBody,
   });
@@ -44,7 +64,7 @@ export async function getMe(params: {
 }): Promise<{ email: string }> {
   const { casUrl, casToken, refreshCookie } = params;
   const url = `${casUrl}/apiv1/members/me`;
-  const res = await fetch(url, {
+  const res = await omadeusFetch("CAS get member", url, {
     method: "GET",
     headers: {
       Authorization: `Bearer ${casToken}`,
@@ -80,7 +100,7 @@ export async function createAuthorizationCode(params: {
     Authorization: `Bearer ${token}`,
     ...(casSession?.refreshCookie ? { Cookie: casSession.refreshCookie } : {}),
   };
-  const res = await fetch(url, {
+  const res = await omadeusFetch("CAS authorization code request", url, {
     method: "CREATE",
     body,
     headers,
@@ -104,7 +124,7 @@ export async function obtainSessionToken(params: {
 }): Promise<string> {
   const { maestroUrl, authorizationCode, organizationId } = params;
   const url = `${maestroUrl}/dolphin/apiv1/oauth2/tokens`;
-  const res = await fetch(url, {
+  const res = await omadeusFetch("Omadeus session token request", url, {
     method: "OBTAIN",
     headers: { "Content-Type": "application/json;charset=UTF-8" },
     body: JSON.stringify({ authorizationCode, organizationId }),
@@ -126,7 +146,7 @@ export async function listOrganizations(params: {
 }): Promise<OmadeusOrganization[]> {
   const { maestroUrl, email } = params;
   const url = `${maestroUrl}/dolphin/apiv1/organizations`;
-  const res = await fetch(url, {
+  const res = await omadeusFetch("Omadeus list organizations", url, {
     method: "LIST",
     headers: { "Content-Type": "application/json;charset=UTF-8" },
     body: JSON.stringify({ email }),
@@ -145,7 +165,7 @@ export async function listOrganizationMembers(params: {
 }): Promise<OmadeusOrganizationMember[]> {
   const { maestroUrl, sessionToken, organizationId } = params;
   const url = `${maestroUrl}/dolphin/apiv1/organizations/${organizationId}/members`;
-  const res = await fetch(url, {
+  const res = await omadeusFetch("Omadeus list organization members", url, {
     method: "LIST",
     headers: {
       Authorization: `Bearer ${sessionToken}`,

package/src/channel.ts

@@ -57,12 +57,15 @@ const isUnconfigured = (account: Account) => account.credentialSource === "none"
 
 let lastPersistedToken: string | null = null;
 
-async function persistSessionToken(token: string): Promise<void> {
+async function persistSessionToken(
+  token: string,
+  environment: Account["environment"],
+): Promise<void> {
   if (lastPersistedToken === token) return;
   const runtime = getOmadeusRuntime();
   const cfg = runtime.config.current() as OpenClawConfig;
   const section = getOmadeusChannelConfig(cfg) ?? {};
-  if (section.sessionToken === token) {
+  if (section.sessionToken === token && section.sessionTokenEnvironment === environment) {
     lastPersistedToken = token;
     return;
   }
@@ -74,6 +77,7 @@ async function persistSessionToken(token: string): Promise<void> {
         omadeus: {
           ...(getOmadeusChannelConfig(draft) ?? {}),
           sessionToken: token,
+          sessionTokenEnvironment: environment,
         },
       };
     },
@@ -103,12 +107,12 @@ const omadeusConfigAdapter = createTopLevelChannelConfigAdapter<Account>({
   defaultAccountId: resolveDefaultOmadeusAccountId,
   deleteMode: "clear-fields",
   clearBaseFields: [
-    "casUrl",
-    "maestroUrl",
+    "environment",
     "email",
     "password",
     "organizationId",
     "sessionToken",
+    "sessionTokenEnvironment",
     "inbound",
   ],
   // Keep adapter contract satisfied even though Omadeus no longer uses DM allowlists.
@@ -561,7 +565,7 @@ export const omadeusPlugin: ChannelPlugin<Account> = {
         initialToken: account.sessionToken,
         onRefresh: (token) => {
           log.info("[omadeus] token refreshed");
-          void persistSessionToken(token).catch((err) =>
+          void persistSessionToken(token, account.environment).catch((err) =>
             log.warn(`[omadeus] failed to persist session token: ${String(err)}`),
           );
         },

package/src/config.ts

@@ -1,5 +1,8 @@
 import { DEFAULT_ACCOUNT_ID, type OpenClawConfig } from "../runtime-api.js";
-import { OMADEUS_CAS_URL, OMADEUS_MAESTRO_URL } from "./defaults.js";
+import {
+  getOmadeusEnvironmentUrls,
+  resolveOmadeusEnvironment,
+} from "./defaults.js";
 import type { OmadeusChannelConfig, ResolvedOmadeusAccount } from "./types.js";
 
 export function getOmadeusChannelConfig(cfg: OpenClawConfig): OmadeusChannelConfig | undefined {
@@ -24,11 +27,17 @@ export function resolveOmadeusAccount(params: {
 }): ResolvedOmadeusAccount {
   const { cfg } = params;
   const section = getOmadeusChannelConfig(cfg) ?? {};
+  const environment = resolveOmadeusEnvironment(section.environment);
+  const { casUrl, maestroUrl } = getOmadeusEnvironmentUrls(environment);
   const envCredentials = resolveOmadeusEnvCredentials();
   const email = section.email?.trim() || envCredentials?.email || "";
   const password = section.password?.trim() || envCredentials?.password || "";
   const orgId = section.organizationId ?? envCredentials?.organizationId;
-  const sessionToken = section.sessionToken?.trim() ?? "";
+  const rawSessionToken = section.sessionToken?.trim() ?? "";
+  const sessionTokenEnvironment = resolveOmadeusEnvironment(section.sessionTokenEnvironment);
+  const sessionTokenValid =
+    Boolean(rawSessionToken) && sessionTokenEnvironment === environment;
+  const sessionToken = sessionTokenValid ? rawSessionToken : "";
   const hasCredentials = Boolean(email && password && orgId);
   const hasSessionToken = Boolean(sessionToken);
   const hasConfigCredentials = Boolean(
@@ -47,8 +56,9 @@ export function resolveOmadeusAccount(params: {
     name: "Omadeus",
     enabled: section.enabled !== false,
     config: section,
-    casUrl: section.casUrl?.trim() || OMADEUS_CAS_URL,
-    maestroUrl: section.maestroUrl?.trim() || OMADEUS_MAESTRO_URL,
+    environment,
+    casUrl,
+    maestroUrl,
     email,
     password,
     organizationId: orgId ?? 0,

package/src/defaults.ts

@@ -1,2 +1,44 @@
-export const OMADEUS_CAS_URL = "https://dev1-cas.rouztech.com";
-export const OMADEUS_MAESTRO_URL = "https://dev3-maestro.rouztech.com";
+export type OmadeusEnvironment = "production" | "staging" | "dev";
+
+export const OMADEUS_DEFAULT_ENVIRONMENT: OmadeusEnvironment = "dev";
+
+export type OmadeusEnvironmentConfig = {
+  label: string;
+  casUrl: string;
+  maestroUrl: string;
+};
+
+export const OMADEUS_ENVIRONMENTS: Record<OmadeusEnvironment, OmadeusEnvironmentConfig> = {
+  production: {
+    label: "Production",
+    casUrl: "https://xas.xeba.tech",
+    maestroUrl: "https://maestro.xeba.tech",
+  },
+  staging: {
+    label: "Staging",
+    casUrl: "https://staging-xas.xeba.tech",
+    maestroUrl: "https://staging.xeba.tech",
+  },
+  dev: {
+    label: "Dev",
+    casUrl: "https://dev1-cas.rouztech.com",
+    maestroUrl: "https://dev1-maestro.rouztech.com",
+  },
+};
+
+const OMADEUS_ENVIRONMENT_SET = new Set<string>(Object.keys(OMADEUS_ENVIRONMENTS));
+
+export function resolveOmadeusEnvironment(value: unknown): OmadeusEnvironment {
+  if (typeof value === "string" && OMADEUS_ENVIRONMENT_SET.has(value)) {
+    return value as OmadeusEnvironment;
+  }
+  return OMADEUS_DEFAULT_ENVIRONMENT;
+}
+
+export function getOmadeusEnvironmentUrls(env: OmadeusEnvironment): {
+  casUrl: string;
+  maestroUrl: string;
+} {
+  const config = OMADEUS_ENVIRONMENTS[env];
+  return { casUrl: config.casUrl, maestroUrl: config.maestroUrl };
+}

package/src/onboarding.ts

@@ -7,7 +7,13 @@ import {
 import { listMemberChannelViews } from "./api/channel.api.js";
 import { authenticate } from "./auth.js";
 import { getOmadeusChannelConfig, resolveOmadeusAccount } from "./config.js";
-import { OMADEUS_CAS_URL, OMADEUS_MAESTRO_URL } from "./defaults.js";
+import {
+  getOmadeusEnvironmentUrls,
+  OMADEUS_DEFAULT_ENVIRONMENT,
+  OMADEUS_ENVIRONMENTS,
+  resolveOmadeusEnvironment,
+  type OmadeusEnvironment,
+} from "./defaults.js";
 import { formatMemberLabel } from "./member-resolve.js";
 import type {
   OmadeusChannelConfig,
@@ -18,7 +24,6 @@ import type {
 import { OMADEUS_INBOUND_ENTITY_KINDS } from "./types.js";
 
 const channel = "omadeus" as const;
-const DONE = "__done__";
 
 type SelectOption = {
   value: string;
@@ -26,33 +31,54 @@ type SelectOption = {
   hint?: string;
 };
 
-type MultiSelectFn = (args: {
-  message: string;
-  options: SelectOption[];
-  initialValues?: string[];
-  initialValue?: string[];
-}) => Promise<string[]>;
-
-type MultiSelectPrompter = {
-  multiSelect?: MultiSelectFn;
-  multiselect?: MultiSelectFn;
-};
+function formatAuthError(err: unknown): string {
+  if (!(err instanceof Error)) return String(err);
+  const parts = [err.message];
+  const { cause } = err;
+  if (cause instanceof Error) {
+    parts.push(cause.message);
+    const code = (cause as Error & { code?: unknown }).code;
+    if (typeof code === "string" && code) {
+      parts.push(`(${code})`);
+    }
+  } else if (typeof cause === "string" && cause.trim()) {
+    parts.push(cause);
+  }
+  return parts.join(" — ");
+}
 
-async function noteOmadeusAuthHelp(prompter: WizardPrompter): Promise<void> {
+async function noteOmadeusAuthHelp(
+  prompter: WizardPrompter,
+  environment: OmadeusEnvironment,
+): Promise<void> {
+  const envLabel = OMADEUS_ENVIRONMENTS[environment].label;
   await prompter.note(
     [
-      "Omadeus authenticates via CAS + Maestro (email + password + organization).",
-      "You need:",
-      "  - Email + password",
-      "  - Organization ID (we can look it up for you)",
-      `CAS URL: ${OMADEUS_CAS_URL}`,
-      `Maestro URL: ${OMADEUS_MAESTRO_URL}`,
-      "Env vars supported: OMADEUS_EMAIL, OMADEUS_PASSWORD, OMADEUS_ORGANIZATION_ID.",
+      `Connect OpenClaw to Omadeus (${envLabel}).`,
+      "",
+      "We'll ask for your email and password, then show the organizations on your account so you can pick one.",
     ].join("\n"),
     "Omadeus setup",
   );
 }
 
+async function promptEnvironment(
+  prompter: WizardPrompter,
+  existing?: OmadeusEnvironment,
+): Promise<OmadeusEnvironment> {
+  const initial = existing ?? OMADEUS_DEFAULT_ENVIRONMENT;
+  const choice = await prompter.select({
+    message: "Select Omadeus environment",
+    options: (Object.keys(OMADEUS_ENVIRONMENTS) as OmadeusEnvironment[]).map((env) => ({
+      value: env,
+      label: OMADEUS_ENVIRONMENTS[env].label,
+      hint: getOmadeusEnvironmentUrls(env).maestroUrl,
+    })),
+    initialValue: initial,
+  });
+  return resolveOmadeusEnvironment(choice);
+}
+
 async function promptOrganizationId(params: {
   prompter: WizardPrompter;
   maestroUrl: string;
@@ -118,8 +144,21 @@ async function promptChannelSelection(params: {
     take: 100,
   });
   if (channels.length === 0) {
-    throw new Error("No channels found for this account.");
+    await prompter.note(
+      "No channels found for this account. Channel listening will stay disabled.",
+      "Omadeus channels",
+    );
+    return [];
+  }
+
+  const listenToChannels = await prompter.confirm({
+    message: "Listen for messages in Omadeus channels?",
+    initialValue: (existingChannelViewIds?.length ?? 0) > 0,
+  });
+  if (!listenToChannels) {
+    return [];
   }
+
   const selected = await promptMultiSelect({
     prompter,
     message: "Which channels should OpenClaw listen to?",
@@ -133,13 +172,9 @@ async function promptChannelSelection(params: {
     initialValues:
       existingChannelViewIds && existingChannelViewIds.length > 0
         ? existingChannelViewIds.map(String)
-        : [String(channels[0]!.id)],
+        : undefined,
   });
-  const chosen = channels.filter((item) => selected.includes(String(item.id)));
-  if (chosen.length === 0) {
-    throw new Error("At least one channel must be selected.");
-  }
-  return chosen;
+  return channels.filter((item) => selected.includes(String(item.id)));
 }
 
 function memberHint(member: OmadeusOrganizationMember): string | undefined {
@@ -154,40 +189,11 @@ async function promptMultiSelect(params: {
   options: SelectOption[];
   initialValues?: string[];
 }): Promise<string[]> {
-  const multi = params.prompter as unknown as MultiSelectPrompter;
-  const runMulti = multi.multiSelect ?? multi.multiselect;
-  if (runMulti) {
-    return runMulti({
-      message: params.message,
-      options: params.options,
-      initialValues: params.initialValues,
-      initialValue: params.initialValues,
-    });
-  }
-
-  const selected = new Set(params.initialValues ?? []);
-  while (true) {
-    const next = await params.prompter.select({
-      message: `${params.message} (${selected.size} selected)`,
-      options: [
-        { value: DONE, label: selected.size > 0 ? "Done" : "Done (select none)" },
-        ...params.options.map((option) => ({
-          ...option,
-          label: selected.has(option.value) ? `[selected] ${option.label}` : option.label,
-        })),
-      ],
-      initialValue: DONE,
-    });
-    const value = String(next);
-    if (value === DONE) {
-      return [...selected];
-    }
-    if (selected.has(value)) {
-      selected.delete(value);
-    } else {
-      selected.add(value);
-    }
-  }
+  return params.prompter.multiselect({
+    message: params.message,
+    options: params.options,
+    initialValues: params.initialValues,
+  });
 }
 
 async function loadSelectableMembers(params: {
@@ -332,16 +338,19 @@ export const omadeusSetupWizard: ChannelSetupWizard = {
     const section = getOmadeusChannelConfig(cfg) ?? {};
     let next = cfg;
 
+    const environment = await promptEnvironment(
+      prompter,
+      section.environment ? resolveOmadeusEnvironment(section.environment) : undefined,
+    );
+    const { casUrl, maestroUrl } = getOmadeusEnvironmentUrls(environment);
+
     if (account.credentialSource === "none") {
-      await noteOmadeusAuthHelp(prompter);
+      await noteOmadeusAuthHelp(prompter, environment);
     }
 
     const envEmail = process.env.OMADEUS_EMAIL?.trim();
     const envPassword = process.env.OMADEUS_PASSWORD?.trim();
 
-    const casUrl = OMADEUS_CAS_URL;
-    const maestroUrl = OMADEUS_MAESTRO_URL;
-
     let { email, password } = await promptCredentials(prompter, {
       email: section.email ?? envEmail,
       password: section.password ?? envPassword,
@@ -370,8 +379,10 @@ export const omadeusSetupWizard: ChannelSetupWizard = {
         await prompter.note(`Authenticated as ${payload.email}`, "Omadeus authentication");
         break;
       } catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        await prompter.note(`Authentication failed: ${msg}`, "Omadeus authentication");
+        await prompter.note(
+          `Authentication failed: ${formatAuthError(err)}`,
+          "Omadeus authentication",
+        );
         const retry = await prompter.confirm({
           message: "Re-enter email/password and try again?",
           initialValue: true,
@@ -418,12 +429,15 @@ export const omadeusSetupWizard: ChannelSetupWizard = {
       existingChannelViewIds: existingInbound?.channels?.allowedChannelViewIds,
     });
 
-    const channelSenderIds = await promptSenderAllowlist({
-      prompter,
-      message: "Which users can trigger OpenClaw from allowed channels?",
-      members,
-      existingReferenceIds: existingInbound?.channels?.allowedSenderReferenceIds,
-    });
+    const channelSenderIds =
+      selectedChannels.length > 0
+        ? await promptSenderAllowlist({
+            prompter,
+            message: "Which users can trigger OpenClaw from allowed channels?",
+            members,
+            existingReferenceIds: existingInbound?.channels?.allowedSenderReferenceIds,
+          })
+        : undefined;
 
     const entityKinds = await promptEntityKindSelection({
       prompter,
@@ -456,11 +470,16 @@ export const omadeusSetupWizard: ChannelSetupWizard = {
     const entityKindSummary =
       entityKinds.length > 0 ? entityKinds.join(", ") : "none (entity rooms disabled)";
 
+    const channelSummary =
+      selectedChannels.length > 0
+        ? `- Channels "${channelTitles}": rooms ${channelRoomIds.join(", ") || "(no room ids)"} from ${senderSummary(channelSenderIds)}; @mention not required in those rooms.`
+        : "- Channels: disabled (none selected).";
+
     await prompter.note(
       [
         `Inbound policy (Jaguar chat):`,
         `- Direct messages: enabled for ${senderSummary(directSenderIds)} (no @mention required).`,
-        `- Channels "${channelTitles}": rooms ${channelRoomIds.join(", ") || "(no room ids)"} from ${senderSummary(channelSenderIds)}; @mention not required in those rooms.`,
+        channelSummary,
         `- Entity rooms (${entityKindSummary}): ${senderSummary(entitySenderIds)}; @mention required.`,
       ].join("\n"),
       "Omadeus inbound policy",
@@ -472,12 +491,12 @@ export const omadeusSetupWizard: ChannelSetupWizard = {
         ...next.channels,
         omadeus: {
           enabled: true,
-          casUrl,
-          maestroUrl,
+          environment,
           email,
           password,
           organizationId,
           sessionToken,
+          sessionTokenEnvironment: environment,
           inbound: {
             version: 1,
             direct: {
@@ -486,7 +505,7 @@ export const omadeusSetupWizard: ChannelSetupWizard = {
               requireMention: "never",
             },
             channels: {
-              enabled: true,
+              enabled: selectedChannels.length > 0,
               allowedRoomIds: channelRoomIds,
               allowedChannelViewIds: channelViewIds,
               ...(channelSenderIds ? { allowedSenderReferenceIds: channelSenderIds } : {}),

package/src/setup-core.ts

@@ -1,5 +1,6 @@
 import type { ChannelSetupAdapter } from "openclaw/plugin-sdk/setup";
 import type { OpenClawConfig } from "../runtime-api.js";
+import { resolveOmadeusEnvironment } from "./defaults.js";
 
 function readSetupStringField(input: Record<string, unknown>, key: string): string | undefined {
   const value = input[key];
@@ -29,8 +30,8 @@ export const omadeusSetupAdapter: ChannelSetupAdapter = {
   },
   applyAccountConfig: ({ cfg, input }) => {
     const rawInput = input as Record<string, unknown>;
-    const casUrl = input.httpUrl?.trim() || undefined;
-    const maestroUrl = input.url?.trim() || undefined;
+    const environmentRaw = readSetupStringField(rawInput, "environment");
+    const environment = environmentRaw ? resolveOmadeusEnvironment(environmentRaw) : undefined;
     const email = readSetupStringField(rawInput, "email");
     const password = input.password?.trim() || undefined;
     const organizationId = readSetupNumberField(rawInput, "organizationId");
@@ -51,8 +52,7 @@ export const omadeusSetupAdapter: ChannelSetupAdapter = {
         omadeus: {
           ...omadeusPrevious,
           enabled: true,
-          ...(casUrl ? { casUrl } : {}),
-          ...(maestroUrl ? { maestroUrl } : {}),
+          ...(environment ? { environment } : {}),
           ...(email ? { email } : {}),
           ...(password ? { password } : {}),
           ...(organizationId ? { organizationId } : {}),

package/src/types.ts

@@ -1,3 +1,5 @@
+import type { OmadeusEnvironment } from "./defaults.js";
+
 // ---------------------------------------------------------------------------
 // Omadeus config shape (stored under channels.omadeus in OpenClaw config)
 // ---------------------------------------------------------------------------
@@ -61,13 +63,14 @@ export type OmadeusInboundPolicy = {
 
 export type OmadeusChannelConfig = {
   enabled?: boolean;
-  casUrl?: string;
-  maestroUrl?: string;
+  environment?: OmadeusEnvironment;
   email?: string;
   password?: string;
   organizationId?: number;
   /** Cached Omadeus session JWT obtained during onboarding/startup. */
   sessionToken?: string;
+  /** Environment the cached sessionToken was minted under (must match `environment`). */
+  sessionTokenEnvironment?: OmadeusEnvironment;
   /** Jaguar chat ingress allowlists and mention rules. */
   inbound?: OmadeusInboundPolicy;
 };
@@ -77,6 +80,7 @@ export type ResolvedOmadeusAccount = {
   name?: string;
   enabled: boolean;
   config: OmadeusChannelConfig;
+  environment: OmadeusEnvironment;
   casUrl: string;
   maestroUrl: string;
   email: string;