@mu-cabin/muc-cli 0.3.0 → 0.3.1

package/README.md

@@ -223,9 +223,15 @@ muc history --team 9009876543210000 --before 2026-04-20 --json | jq .
 | `muc wait-react --mid <MID> [--from-uid UID] [--sticker-id ID] [--timeout 300]` | Block until someone reacts with an emoticon to `--mid`, then exit. Useful as a "human-in-the-loop approval" gate after `muc send`. Exits with `TIMEOUT` (exit 5) if no matching reaction arrives within `--timeout` seconds. |
 | `muc listen [--from-uid UID] [--team TEAM] [--peer UID] [--contains TEXT] [--regex …] [--at-me] [--max N]` | Long-lived TCP tap that emits one **NDJSON line per matching inbound message** (in `--json` mode each line is the standard envelope; in human mode it's a one-line summary). Supports repeatable filters (OR semantics within each kind, AND across kinds), `--at-me` to restrict to group messages where another user @-mentions you (implies excluding self), `--include-self` to include your own sends, `--include-reactions` to also surface type=3 sub=300/301 frames, `--max N` to exit after N matches. Stop with `^C`. |
 
-`--os` defaults to `iOS`. Valid values: `Windows`, `OS X`, `Mac`, `iOS`,
-`Android`. **`--os` does not provide coexistence — read the section below
-before using any chat-channel command if you have a real device logged in.**
+`--os` resolves as **per-call `--os` → `defaultChatOs` in `~/.muc/config.json`
+→ built-in `iOS`**. Valid values: `Windows`, `OS X`, `Mac`, `iOS`, `Android`.
+Set the per-machine default once with `muc init --default-os <os>` (or the
+`MUC_DEFAULT_OS` env var, or the interactive prompt during `muc init`). Useful
+if your real device is an iPhone — flip the CLI default to `windows` so
+chat-channel commands park on the PC slot instead of kicking your phone.
+**`--os` / `defaultChatOs` does not provide coexistence — read the section
+below before using any chat-channel command if you have a real device
+logged in.**
 
 Sending to anyone other than yourself requires the explicit `--yes-not-self`
 flag — a guard against accidentally messaging real humans during testing.
@@ -286,7 +292,9 @@ in as `iOS` (Mobile slot).
 
 The CLI defaults to `--os iOS` so it coexists with a Mac desktop. If your
 iPhone is also signed in, both slots are taken and any TCP command will
-kick one of them — fall back to REST-only commands.
+kick one of them — fall back to REST-only commands, or run
+`muc init --default-os windows` to flip the per-machine default to the PC
+slot (which kicks the desktop instead of the phone).
 
 `tcp-ping` only does TCP connect + NEGOTIATE (no `auth/login`), so it can't
 kick anything. Run it first to confirm the wire protocol is happy on your
@@ -361,6 +369,10 @@ first use; you should never need to edit them by hand.
 
 ## Changelog
 
+#### `0.3.1`
+`2026.04.29`
+- Add `defaultChatOs` to `~/.muc/config.json`: per-machine fallback for the chat-channel `--os` slot. Configure via `muc init --default-os <windows|osx|mac|ios|android>`, the `MUC_DEFAULT_OS` env var, or the interactive prompt during `muc init`. Resolution order: per-call `--os` → `defaultChatOs` → built-in `iOS`. Use this when your real device is on the Mobile slot (e.g. iPhone) so chat-channel commands park on PC instead of kicking your phone.
+
 #### `0.3.0`
 `2026.04.29`
 - Add `muc react` / `muc unreact` / `muc reactions` to add, revoke, and list emoticon reactions on existing messages

package/dist/muc.mjs

@@ -21288,6 +21288,7 @@ import { join } from "node:path";
 var DIR = join(homedir(), ".muc");
 var FILE = join(DIR, "config.json");
 var CONFIG_SCHEMA_VERSION = 1;
+var CHAT_OS_VALUES = ["Windows", "OS X", "Mac", "iOS", "Android"];
 var MucConfigSchema = external_exports.object({
   appKey: external_exports.string().regex(/^[0-9a-f]{8}$/, "appKey must be 8 lowercase hex chars"),
   appId: external_exports.string().regex(/^[0-9a-f]{24}$/, "appId must be 24 lowercase hex chars"),
@@ -21307,6 +21308,10 @@ var MucConfigSchema = external_exports.object({
   //   any other → that literal string (e.g. "\n— bot")
   // Per-call `--tail` / `--no-tail` flags on `muc send` override this.
   messageTail: external_exports.string().max(200).optional(),
+  // Default chat-channel `os` slot for TCP commands when --os is not passed.
+  // PC ({Windows, OS X, Mac}) vs Mobile ({iOS, Android}); same slot as the
+  // running desktop will kick it. Built-in fallback is 'iOS' (Mobile).
+  defaultChatOs: external_exports.enum(CHAT_OS_VALUES).optional(),
   savedAt: external_exports.number().int().nonnegative(),
   schemaVersion: external_exports.literal(CONFIG_SCHEMA_VERSION)
 });
@@ -21394,6 +21399,47 @@ function saveCredentials(c) {
 }
 var credentialsPath = FILE2;
 
+// src/lib/constants.ts
+var APP_NAME = "MUC";
+var APP_VERSION = "3.3.1-250925001";
+var APP_VERSION_IOS = "3.3.0301";
+var PLATFORM_IOS = 1;
+var PLATFORM_ANDROID = 2;
+var PLATFORM_WIN = 4;
+var PLATFORM_MAC = 5;
+var SECURE_SYS_KEY = "mx_app_key";
+var PWD_DES_IV = Buffer.from([1, 2, 3, 4, 5, 6, 7, 8]);
+var DEFAULT_CHAT_OS = "iOS";
+var DEFAULT_REST_PLATFORM = PLATFORM_IOS;
+function defaultMessageTail(userName) {
+  const name = userName.trim() || "unknown";
+  return `
+\u2014\u2014 \u6765\u81EA${name}\u7684muc-cli`;
+}
+var DEFAULTS = {
+  // Hosts/ports for the 东航 deployment. Other tenants override at init.
+  restHost: "https://muc.ceair.com/",
+  ssoHost: "https://store.ceair.com/",
+  imHost: "muc.ceair.com",
+  imPort: 8101,
+  fileHost: "muc.ceair.com",
+  filePort: 6101
+};
+function apiUrls(cfg) {
+  const host = cfg.restHost.endsWith("/") ? cfg.restHost : `${cfg.restHost}/`;
+  return {
+    SYS: `${host}sysconfig/v5/app`,
+    MUC: `${host}muc/v5/app`,
+    MAM: `${host}mam/v5/app`,
+    MAS: `${host}mas/v5/app`,
+    MPM: `${host}mpm/v5/app`,
+    IMM: `${host}imm/v5/app`,
+    MRM: `${host}mrm/v5/app`,
+    CONTACT: `${host}contacts/v5/app`,
+    SECURE: `${host}contacts/secure/v5/app`
+  };
+}
+
 // src/lib/cli.ts
 var SCHEMA_VERSION = 1;
 var EXIT_CODES = {
@@ -21573,6 +21619,11 @@ function parseChatOs(raw) {
     "expected windows|osx|mac|ios|android"
   );
 }
+function resolveChatOs(optsOs, cfg) {
+  if (optsOs !== void 0) return optsOs;
+  if (cfg.defaultChatOs !== void 0) return cfg.defaultChatOs;
+  return DEFAULT_CHAT_OS;
+}
 function parseMoment(label) {
   return (raw) => {
     if (/^\d+$/.test(raw)) {
@@ -21717,47 +21768,6 @@ function getDeviceName() {
   return `${hostname()} (muc-cli)`;
 }
 
-// src/lib/constants.ts
-var APP_NAME = "MUC";
-var APP_VERSION = "3.3.1-250925001";
-var APP_VERSION_IOS = "3.3.0301";
-var PLATFORM_IOS = 1;
-var PLATFORM_ANDROID = 2;
-var PLATFORM_WIN = 4;
-var PLATFORM_MAC = 5;
-var SECURE_SYS_KEY = "mx_app_key";
-var PWD_DES_IV = Buffer.from([1, 2, 3, 4, 5, 6, 7, 8]);
-var DEFAULT_CHAT_OS = "iOS";
-var DEFAULT_REST_PLATFORM = PLATFORM_IOS;
-function defaultMessageTail(userName) {
-  const name = userName.trim() || "unknown";
-  return `
-\u2014\u2014 \u6765\u81EA${name}\u7684muc-cli`;
-}
-var DEFAULTS = {
-  // Hosts/ports for the 东航 deployment. Other tenants override at init.
-  restHost: "https://muc.ceair.com/",
-  ssoHost: "https://store.ceair.com/",
-  imHost: "muc.ceair.com",
-  imPort: 8101,
-  fileHost: "muc.ceair.com",
-  filePort: 6101
-};
-function apiUrls(cfg) {
-  const host = cfg.restHost.endsWith("/") ? cfg.restHost : `${cfg.restHost}/`;
-  return {
-    SYS: `${host}sysconfig/v5/app`,
-    MUC: `${host}muc/v5/app`,
-    MAM: `${host}mam/v5/app`,
-    MAS: `${host}mas/v5/app`,
-    MPM: `${host}mpm/v5/app`,
-    IMM: `${host}imm/v5/app`,
-    MRM: `${host}mrm/v5/app`,
-    CONTACT: `${host}contacts/v5/app`,
-    SECURE: `${host}contacts/secure/v5/app`
-  };
-}
-
 // src/lib/http.ts
 var UA = `MUC/${APP_VERSION} (CLI; muc-cli/${CLI_VERSION})`;
 var SENSITIVE_QS = /* @__PURE__ */ new Set(["accessToken", "tokenPwd", "sign"]);
@@ -22136,6 +22146,8 @@ var FingerprintShape = external_exports.object({
   filePort: external_exports.number(),
   messageTail: external_exports.string(),
   // summary: "default" / "none" / "custom (N chars)"
+  defaultChatOs: external_exports.string(),
+  // summary: explicit value or "default (iOS)"
   savedAt: external_exports.number(),
   schemaVersion: external_exports.literal(CONFIG_SCHEMA_VERSION)
 });
@@ -22161,6 +22173,10 @@ function summarizeTail(t) {
   if (t === "") return "none";
   return `custom (${t.length} chars)`;
 }
+function summarizeChatOs(v) {
+  if (v === void 0) return `default (${DEFAULT_CHAT_OS})`;
+  return v;
+}
 function redactConfig(c) {
   return {
     appKey: fingerprint2(c.appKey),
@@ -22175,6 +22191,7 @@ function redactConfig(c) {
     fileHost: c.fileHost,
     filePort: c.filePort,
     messageTail: summarizeTail(c.messageTail),
+    defaultChatOs: summarizeChatOs(c.defaultChatOs),
     savedAt: c.savedAt,
     schemaVersion: c.schemaVersion
   };
@@ -22320,7 +22337,7 @@ function register2(program3) {
     description: "Bootstrap or update ~/.muc/config.json (tenant config: APP_KEY, APP_ID, signing secrets, hosts/ports). Interactive prompts by default; non-interactive via flags or MUC_* env vars. WARNING: env vars are visible to other processes via /proc/<pid>/environ and shell history \u2014 prefer interactive or flag-based for production.",
     output: Output2,
     configure: (cmd) => {
-      cmd.option("--check", "verify config presence and validity (exit 0 ok / 6 missing / 7 invalid); does not modify").option("--show", "print the saved config (secrets are always redacted in both human and JSON output; cat ~/.muc/config.json for raw values)").option("--reset", "delete ~/.muc/config.json (requires --yes)").option("--yes", "confirm a destructive action like --reset").option("--no-interactive", "fail rather than prompt for missing fields").option("--app-key <hex>", "tenant APP_KEY (8 lowercase hex)").option("--app-id <hex>", "tenant APP_ID (24 lowercase hex)").option("--sign-secret-rest <s>", "REST signing secret").option("--sign-secret-secure <s>", "secure-API signing secret").option("--pwd-des-key <s>", "password DES key (defaults to APP_KEY)").option("--rest-host <url>", "REST host URL").option("--sso-host <url>", "SSO host URL (optional)").option("--im-host <h>", "IM TCP host").option("--im-port <n>", "IM TCP port").option("--file-host <h>", "file-channel TCP host").option("--file-port <n>", "file-channel TCP port").option("--message-tail <text>", "custom signature appended to outbound `muc send` text (max 200 chars)").option("--no-message-tail", "explicitly disable the message tail (no signature appended)");
+      cmd.option("--check", "verify config presence and validity (exit 0 ok / 6 missing / 7 invalid); does not modify").option("--show", "print the saved config (secrets are always redacted in both human and JSON output; cat ~/.muc/config.json for raw values)").option("--reset", "delete ~/.muc/config.json (requires --yes)").option("--yes", "confirm a destructive action like --reset").option("--no-interactive", "fail rather than prompt for missing fields").option("--app-key <hex>", "tenant APP_KEY (8 lowercase hex)").option("--app-id <hex>", "tenant APP_ID (24 lowercase hex)").option("--sign-secret-rest <s>", "REST signing secret").option("--sign-secret-secure <s>", "secure-API signing secret").option("--pwd-des-key <s>", "password DES key (defaults to APP_KEY)").option("--rest-host <url>", "REST host URL").option("--sso-host <url>", "SSO host URL (optional)").option("--im-host <h>", "IM TCP host").option("--im-port <n>", "IM TCP port").option("--file-host <h>", "file-channel TCP host").option("--file-port <n>", "file-channel TCP port").option("--message-tail <text>", "custom signature appended to outbound `muc send` text (max 200 chars)").option("--no-message-tail", "explicitly disable the message tail (no signature appended)").option("--default-os <os>", "default chat-channel os slot for TCP commands when --os is not passed (windows|osx|mac|ios|android); built-in fallback is iOS");
     },
     run: async (cmd) => {
       const opts = cmd.opts();
@@ -22430,6 +22447,26 @@ function register2(program3) {
       } else if (existing && "messageTail" in existing) {
         messageTail = existing.messageTail;
       }
+      let defaultChatOs;
+      let dcoRaw;
+      const dcoFlag = opts.defaultOs;
+      const dcoEnv = process.env.MUC_DEFAULT_OS;
+      if (typeof dcoFlag === "string" && dcoFlag.length > 0) {
+        dcoRaw = dcoFlag;
+      } else if (dcoEnv !== void 0 && dcoEnv.length > 0) {
+        dcoRaw = dcoEnv;
+      } else if (existing?.defaultChatOs !== void 0) {
+        defaultChatOs = existing.defaultChatOs;
+      } else if (interactive) {
+        const answer = await readLine(
+          "Default chat OS slot (windows|osx|mac|ios|android)",
+          DEFAULT_CHAT_OS.toLowerCase()
+        );
+        if (answer.length > 0) dcoRaw = answer;
+      }
+      if (dcoRaw !== void 0) {
+        defaultChatOs = parseChatOs(dcoRaw);
+      }
       const draft = {
         appKey: String(partial.appKey ?? ""),
         appId: String(partial.appId ?? ""),
@@ -22443,6 +22480,7 @@ function register2(program3) {
         fileHost: String(partial.fileHost ?? ""),
         filePort: Number(partial.filePort ?? 0),
         messageTail,
+        defaultChatOs,
         savedAt: Date.now(),
         schemaVersion: CONFIG_SCHEMA_VERSION
       };
@@ -23220,13 +23258,14 @@ function register9(program3) {
     description: 'Search groups the current user belongs to (TCP chat channel sid="team", cid="search_own_teams"). Pass --enrich for names + member counts. Will kick a session in the same online-slot.',
     output: Output9,
     configure: (cmd) => {
-      cmd.argument("<keyword>", "team name fragment").option("--enrich", "follow up with team/get_team per id").option("--os <os>", "chat-channel os slot", parseChatOs, DEFAULT_CHAT_OS).option("--debug", "forward wire-level debug events to stderr");
+      cmd.argument("<keyword>", "team name fragment").option("--enrich", "follow up with team/get_team per id").option("--os <os>", "chat-channel os slot (default: cfg.defaultChatOs ?? iOS)", parseChatOs).option("--debug", "forward wire-level debug events to stderr");
     },
     run: async (cmd) => {
       const [kw] = cmd.args;
-      const { enrich, os, debug } = cmd.opts();
+      const { enrich, os: optsOs, debug } = cmd.opts();
       const cfg = requireConfig();
       const cred = requireAuth(loadCredentials());
+      const os = resolveChatOs(optsOs, cfg);
       const session = await openChatSession(cred, { os, debug });
       const { socket } = session;
       try {
@@ -23412,11 +23451,13 @@ function register13(program3) {
     description: "After chat-login, run sync/syncDone, sync/syncSession, sync/syncWithdraws and return the raw responses.",
     output: Output13,
     configure: (cmd) => {
-      cmd.option("--os <os>", "chat-channel os slot", parseChatOs, DEFAULT_CHAT_OS).option("--debug", "forward wire-level debug events to stderr");
+      cmd.option("--os <os>", "chat-channel os slot (default: cfg.defaultChatOs ?? iOS)", parseChatOs).option("--debug", "forward wire-level debug events to stderr");
     },
     run: async (cmd) => {
-      const { os, debug } = cmd.opts();
+      const { os: optsOs, debug } = cmd.opts();
+      const cfg = requireConfig();
       const cred = requireAuth(loadCredentials());
+      const os = resolveChatOs(optsOs, cfg);
       const session = await openChatSession(cred, { os, debug });
       const { socket } = session;
       try {
@@ -23670,7 +23711,7 @@ function register15(program3) {
     description: "Send a plain-text chat message via the TCP chat channel. VISIBLE TO THE RECIPIENT \u2014 non-self targets require --yes-not-self.",
     output: Output15,
     configure: (cmd) => {
-      cmd.argument("<text...>", "message text (variadic; words rejoined with spaces)").option("--peer <uid>", "1:1 chat with a peer uid").option("--team <id>", "group chat with a team id").option("--to-self", "send to your own uid (default if no target given)").option("--yes-not-self", "required to confirm sending to anyone other than yourself").option("--dry-run", "build the frame but do not connect").option("--os <os>", "chat-channel os slot", parseChatOs, DEFAULT_CHAT_OS).option("--tail <text>", "override message tail for this call only").option("--no-tail", "do not append a message tail for this call").option("--debug", "forward wire-level debug events to stderr");
+      cmd.argument("<text...>", "message text (variadic; words rejoined with spaces)").option("--peer <uid>", "1:1 chat with a peer uid").option("--team <id>", "group chat with a team id").option("--to-self", "send to your own uid (default if no target given)").option("--yes-not-self", "required to confirm sending to anyone other than yourself").option("--dry-run", "build the frame but do not connect").option("--os <os>", "chat-channel os slot (default: cfg.defaultChatOs ?? iOS)", parseChatOs).option("--tail <text>", "override message tail for this call only").option("--no-tail", "do not append a message tail for this call").option("--debug", "forward wire-level debug events to stderr");
     },
     run: async (cmd) => {
       const text = cmd.args.join(" ").trim();
@@ -23678,6 +23719,7 @@ function register15(program3) {
       const opts = cmd.opts();
       const cfg = requireConfig();
       const cred = requireAuth(loadCredentials());
+      const os = resolveChatOs(opts.os, cfg);
       requireSingleTarget(opts, "send");
       const conflict = detectFlagConflict(process.argv.slice(2), "tail");
       if (conflict.sawValueForm && conflict.sawNegatedForm) {
@@ -23716,7 +23758,7 @@ function register15(program3) {
         subType: 1,
         body: finalText,
         fName: cred.name,
-        platform: opts.os === "Mac" || opts.os === "OS X" ? "Mac" : "Windows",
+        platform: os === "Mac" || os === "OS X" ? "Mac" : "Windows",
         appKey: cfg.appKey
       });
       if (opts.dryRun) {
@@ -23728,7 +23770,7 @@ function register15(program3) {
           frame: { sid: "talk", cid: "sendMsg", data: { msg } }
         };
       }
-      const session = await openChatSession(cred, { os: opts.os, debug: opts.debug });
+      const session = await openChatSession(cred, { os, debug: opts.debug });
       const { socket } = session;
       let res;
       try {
@@ -24468,7 +24510,7 @@ function register16(program3) {
     description: "Upload a local file (TCP 6101) and broadcast as MESSAGE_CHAT_FILE (subType=7). VISIBLE \u2014 non-self targets require --yes-not-self.",
     output: Output16,
     configure: (cmd) => {
-      cmd.argument("<file>", "absolute or relative path to a local file").option("--peer <uid>", "1:1 chat with a peer uid").option("--team <id>", "group chat with a team id").option("--to-self", "send to your own uid (default if no target given)").option("--yes-not-self", "required to confirm sending to anyone other than yourself").option("--dry-run", "resolve target + sanity-check the local file but do not upload or send").option("--os <os>", "chat-channel os slot for the talk/sendMsg", parseChatOs, DEFAULT_CHAT_OS).option("--debug", "forward wire-level debug events to stderr");
+      cmd.argument("<file>", "absolute or relative path to a local file").option("--peer <uid>", "1:1 chat with a peer uid").option("--team <id>", "group chat with a team id").option("--to-self", "send to your own uid (default if no target given)").option("--yes-not-self", "required to confirm sending to anyone other than yourself").option("--dry-run", "resolve target + sanity-check the local file but do not upload or send").option("--os <os>", "chat-channel os slot for the talk/sendMsg (default: cfg.defaultChatOs ?? iOS)", parseChatOs).option("--debug", "forward wire-level debug events to stderr");
     },
     run: async (cmd) => {
       const filePath = path2.resolve(String(cmd.args[0] ?? ""));
@@ -24476,6 +24518,7 @@ function register16(program3) {
       const opts = cmd.opts();
       const cfg = requireConfig();
       const cred = requireAuth(loadCredentials());
+      const os = resolveChatOs(opts.os, cfg);
       requireSingleTarget(opts, "send-file");
       let scene;
       let toId;
@@ -24526,10 +24569,10 @@ function register16(program3) {
           expiredDay: up.expiredDay
         }),
         fName: cred.name,
-        platform: opts.os === "Mac" || opts.os === "OS X" ? "Mac" : "Windows",
+        platform: os === "Mac" || os === "OS X" ? "Mac" : "Windows",
         appKey: cfg.appKey
       });
-      const session = await openChatSession(cred, { os: opts.os, debug: opts.debug });
+      const session = await openChatSession(cred, { os, debug: opts.debug });
       let res;
       try {
         res = await session.socket.send("talk", "sendMsg", { msg });
@@ -24642,13 +24685,14 @@ function register17(program3) {
     description: "Upload an image (TCP 6101) and broadcast as MESSAGE_CHAT_IMAGE (subType=8). VISIBLE \u2014 non-self targets require --yes-not-self.",
     output: Output17,
     configure: (cmd) => {
-      cmd.argument("<file>", "PNG/JPEG/GIF/BMP image path").option("--peer <uid>", "1:1 chat with a peer uid").option("--team <id>", "group chat with a team id").option("--to-self", "send to your own uid (default)").option("--yes-not-self", "required for non-self targets").option("--width <px>", "override probed image width", parsePosInt("--width")).option("--height <px>", "override probed image height", parsePosInt("--height")).option("--dry-run", "sanity-check the local file (probe + stat) but do not upload or send").option("--os <os>", "chat-channel os slot", parseChatOs, DEFAULT_CHAT_OS).option("--debug", "forward wire-level debug events to stderr");
+      cmd.argument("<file>", "PNG/JPEG/GIF/BMP image path").option("--peer <uid>", "1:1 chat with a peer uid").option("--team <id>", "group chat with a team id").option("--to-self", "send to your own uid (default)").option("--yes-not-self", "required for non-self targets").option("--width <px>", "override probed image width", parsePosInt("--width")).option("--height <px>", "override probed image height", parsePosInt("--height")).option("--dry-run", "sanity-check the local file (probe + stat) but do not upload or send").option("--os <os>", "chat-channel os slot (default: cfg.defaultChatOs ?? iOS)", parseChatOs).option("--debug", "forward wire-level debug events to stderr");
     },
     run: async (cmd) => {
       const filePath = path3.resolve(String(cmd.args[0] ?? ""));
       const opts = cmd.opts();
       const cfg = requireConfig();
       const cred = requireAuth(loadCredentials());
+      const os = resolveChatOs(opts.os, cfg);
       requireSingleTarget(opts, "send-image");
       let scene;
       let toId;
@@ -24714,10 +24758,10 @@ function register17(program3) {
           height
         }),
         fName: cred.name,
-        platform: opts.os === "Mac" || opts.os === "OS X" ? "Mac" : "Windows",
+        platform: os === "Mac" || os === "OS X" ? "Mac" : "Windows",
         appKey: cfg.appKey
       });
-      const session = await openChatSession(cred, { os: opts.os, debug: opts.debug });
+      const session = await openChatSession(cred, { os, debug: opts.debug });
       let res;
       try {
         res = await session.socket.send("talk", "sendMsg", { msg });
@@ -24796,13 +24840,14 @@ function register18(program3) {
     description: "Upload an audio clip (TCP 6101) and broadcast as MESSAGE_CHAT_AUDIO (subType=9). VISIBLE \u2014 non-self targets require --yes-not-self.",
     output: Output18,
     configure: (cmd) => {
-      cmd.argument("<file>", "audio file path (typically .amr)").requiredOption("--duration <ms>", "clip duration in milliseconds", parsePosInt("--duration")).option("--peer <uid>", "1:1 chat with a peer uid").option("--team <id>", "group chat with a team id").option("--to-self", "send to your own uid (default)").option("--yes-not-self", "required for non-self targets").option("--dry-run", "sanity-check the local file but do not upload or send").option("--os <os>", "chat-channel os slot", parseChatOs, DEFAULT_CHAT_OS).option("--debug", "forward wire-level debug events to stderr");
+      cmd.argument("<file>", "audio file path (typically .amr)").requiredOption("--duration <ms>", "clip duration in milliseconds", parsePosInt("--duration")).option("--peer <uid>", "1:1 chat with a peer uid").option("--team <id>", "group chat with a team id").option("--to-self", "send to your own uid (default)").option("--yes-not-self", "required for non-self targets").option("--dry-run", "sanity-check the local file but do not upload or send").option("--os <os>", "chat-channel os slot (default: cfg.defaultChatOs ?? iOS)", parseChatOs).option("--debug", "forward wire-level debug events to stderr");
     },
     run: async (cmd) => {
       const filePath = path4.resolve(String(cmd.args[0] ?? ""));
       const opts = cmd.opts();
       const cfg = requireConfig();
       const cred = requireAuth(loadCredentials());
+      const os = resolveChatOs(opts.os, cfg);
       requireSingleTarget(opts, "send-voice");
       let scene;
       let toId;
@@ -24861,10 +24906,10 @@ function register18(program3) {
           duration: opts.duration
         }),
         fName: cred.name,
-        platform: opts.os === "Mac" || opts.os === "OS X" ? "Mac" : "Windows",
+        platform: os === "Mac" || os === "OS X" ? "Mac" : "Windows",
         appKey: cfg.appKey
       });
-      const session = await openChatSession(cred, { os: opts.os, debug: opts.debug });
+      const session = await openChatSession(cred, { os, debug: opts.debug });
       let res;
       try {
         res = await session.socket.send("talk", "sendMsg", { msg });
@@ -25033,12 +25078,13 @@ function register20(program3) {
     description: "Withdraw a previously-sent message (P2P_MSG_CANCEL). VISIBLE TO THE RECIPIENT \u2014 non-self targets require --yes-not-self.",
     output: Output20,
     configure: (cmd) => {
-      cmd.requiredOption("--mid <mid>", "message id to withdraw").option("--peer <uid>", "1:1 chat with a peer uid").option("--team <id>", "group chat with a team id").option("--to-self", "withdraw in your self-chat (default if no target)").option("--yes-not-self", "required to confirm withdrawing in a non-self conversation").option("--dry-run", "build the frame but do not connect").option("--os <os>", "chat-channel os slot", parseChatOs, DEFAULT_CHAT_OS).option("--debug", "forward wire-level debug events to stderr");
+      cmd.requiredOption("--mid <mid>", "message id to withdraw").option("--peer <uid>", "1:1 chat with a peer uid").option("--team <id>", "group chat with a team id").option("--to-self", "withdraw in your self-chat (default if no target)").option("--yes-not-self", "required to confirm withdrawing in a non-self conversation").option("--dry-run", "build the frame but do not connect").option("--os <os>", "chat-channel os slot (default: cfg.defaultChatOs ?? iOS)", parseChatOs).option("--debug", "forward wire-level debug events to stderr");
     },
     run: async (cmd) => {
       const opts = cmd.opts();
       const cfg = requireConfig();
       const cred = requireAuth(loadCredentials());
+      const os = resolveChatOs(opts.os, cfg);
       requireSingleTarget(opts, "withdraw");
       let scene;
       let toId;
@@ -25068,7 +25114,7 @@ function register20(program3) {
         subType: 2,
         body: { mids: [opts.mid] },
         fName: cred.name,
-        platform: opts.os === "Mac" || opts.os === "OS X" ? "Mac" : "Windows",
+        platform: os === "Mac" || os === "OS X" ? "Mac" : "Windows",
         appKey: cfg.appKey
       });
       if (opts.dryRun) {
@@ -25080,7 +25126,7 @@ function register20(program3) {
           frame: { sid: "talk", cid: "sendMsg", data: { msg } }
         };
       }
-      const session = await openChatSession(cred, { os: opts.os, debug: opts.debug });
+      const session = await openChatSession(cred, { os, debug: opts.debug });
       const { socket } = session;
       let res;
       try {
@@ -25123,11 +25169,13 @@ function register21(program3) {
     description: "Send user/delSession to drop the local session record on all of the user's devices.",
     output: Output21,
     configure: (cmd) => {
-      cmd.option("--peer <uid>", "session with a peer uid").option("--team <id>", "session with a team id").option("--to-self", "self-chat session (default if no target)").option("--yes-not-self", "required to confirm clearing a non-self session").option("--dry-run", "build the frame but do not connect").option("--os <os>", "chat-channel os slot", parseChatOs, DEFAULT_CHAT_OS).option("--debug", "forward wire-level debug events to stderr");
+      cmd.option("--peer <uid>", "session with a peer uid").option("--team <id>", "session with a team id").option("--to-self", "self-chat session (default if no target)").option("--yes-not-self", "required to confirm clearing a non-self session").option("--dry-run", "build the frame but do not connect").option("--os <os>", "chat-channel os slot (default: cfg.defaultChatOs ?? iOS)", parseChatOs).option("--debug", "forward wire-level debug events to stderr");
     },
     run: async (cmd) => {
       const opts = cmd.opts();
+      const cfg = requireConfig();
       const cred = requireAuth(loadCredentials());
+      const os = resolveChatOs(opts.os, cfg);
       requireSingleTarget(opts, "clear-session");
       let scene;
       let toId;
@@ -25154,7 +25202,7 @@ function register21(program3) {
       if (opts.dryRun) {
         return { scene, toId, sId, dryRun: true, frame };
       }
-      const session = await openChatSession(cred, { os: opts.os, debug: opts.debug });
+      const session = await openChatSession(cred, { os, debug: opts.debug });
       const { socket } = session;
       let res;
       try {
@@ -25442,13 +25490,15 @@ function register25(program3) {
     description: "Block until someone adds an emoticon reaction (subType=300) to --mid. Consumes a TCP slot \u2014 defaults to --os iOS (Mobile slot).",
     output: Output25,
     configure: (cmd) => {
-      cmd.requiredOption("--mid <mid>", "message id to wait for a reaction on").option("--from-uid <uid>", "only consider reactions from this UID (case-insensitive match against fId of the type=3 notification)").option("--sticker-id <id>", "only consider reactions whose stickerId matches").option("--timeout <seconds>", "give up after this many seconds (default 300)", parsePosInt("--timeout"), 300).option("--os <os>", "chat-channel os slot", parseChatOs, DEFAULT_CHAT_OS).option("--debug", "forward wire-level debug events to stderr");
+      cmd.requiredOption("--mid <mid>", "message id to wait for a reaction on").option("--from-uid <uid>", "only consider reactions from this UID (case-insensitive match against fId of the type=3 notification)").option("--sticker-id <id>", "only consider reactions whose stickerId matches").option("--timeout <seconds>", "give up after this many seconds (default 300)", parsePosInt("--timeout"), 300).option("--os <os>", "chat-channel os slot (default: cfg.defaultChatOs ?? iOS)", parseChatOs).option("--debug", "forward wire-level debug events to stderr");
     },
     run: async (cmd) => {
       const opts = cmd.opts();
+      const cfg = requireConfig();
       const cred = requireAuth(loadCredentials());
+      const os = resolveChatOs(opts.os, cfg);
       const wantedFrom = opts.fromUid?.toUpperCase();
-      const session = await openChatSession(cred, { os: opts.os, debug: opts.debug });
+      const session = await openChatSession(cred, { os, debug: opts.debug });
       const { socket } = session;
       try {
         return await new Promise((resolve2, reject) => {
@@ -25588,7 +25638,7 @@ function register26(program3) {
     description: "Tail incoming chat messages, filtered by sender / team / peer / keyword / regex / @-mention. Emit one line per match \u2014 NDJSON envelope under `--json`, human summary otherwise. Consumes a TCP slot.",
     streamSchema: STREAM_SCHEMA,
     configure: (cmd) => {
-      cmd.option("--from-uid <uid>", "only emit messages from this UID (repeat for OR; matched against fId, case-insensitive)", collect, []).option("--team <id>", "only emit messages in this team (repeat for OR)", collect, []).option("--peer <uid>", "only emit p2p messages with this peer UID (repeat for OR)", collect, []).option("--contains <text>", "only emit messages whose text contains this substring, case-insensitive (repeat for OR)", collect, []).option("--regex <pattern>", "only emit messages whose text matches this RE2-flavoured regex (repeat for OR)", collect, []).option("--type <n>", "only emit messages of this `type` field (default 1; repeat for OR)", collectInt("--type"), []).option("--subtype <n>", "only emit messages of this `subType` field (repeat for OR; default = any)", collectInt("--subtype"), []).option("--max <n>", "exit after emitting this many matching lines", parsePosInt("--max")).option("--at-me", "only emit group messages that @-mention you (mirrors the desktop SDK isAtMe: scene=team_g, fId\u2260self, atIds includes self uid). Implies excluding self.").option("--include-self", "do not filter out messages whose fId is your own UID").option("--include-reactions", "also emit type=3 sub=300/301 (reaction add/remove) frames").option("--include-offline", "also emit messages flushed via cid=offMsg on connect (default: only post-connect msg)").option("--os <os>", "chat-channel os slot", parseChatOs, DEFAULT_CHAT_OS).option("--debug", "forward wire-level debug events to stderr");
+      cmd.option("--from-uid <uid>", "only emit messages from this UID (repeat for OR; matched against fId, case-insensitive)", collect, []).option("--team <id>", "only emit messages in this team (repeat for OR)", collect, []).option("--peer <uid>", "only emit p2p messages with this peer UID (repeat for OR)", collect, []).option("--contains <text>", "only emit messages whose text contains this substring, case-insensitive (repeat for OR)", collect, []).option("--regex <pattern>", "only emit messages whose text matches this RE2-flavoured regex (repeat for OR)", collect, []).option("--type <n>", "only emit messages of this `type` field (default 1; repeat for OR)", collectInt("--type"), []).option("--subtype <n>", "only emit messages of this `subType` field (repeat for OR; default = any)", collectInt("--subtype"), []).option("--max <n>", "exit after emitting this many matching lines", parsePosInt("--max")).option("--at-me", "only emit group messages that @-mention you (mirrors the desktop SDK isAtMe: scene=team_g, fId\u2260self, atIds includes self uid). Implies excluding self.").option("--include-self", "do not filter out messages whose fId is your own UID").option("--include-reactions", "also emit type=3 sub=300/301 (reaction add/remove) frames").option("--include-offline", "also emit messages flushed via cid=offMsg on connect (default: only post-connect msg)").option("--os <os>", "chat-channel os slot (default: cfg.defaultChatOs ?? iOS)", parseChatOs).option("--debug", "forward wire-level debug events to stderr");
     },
     run: async (cmd) => {
       const opts = cmd.opts();
@@ -25615,8 +25665,10 @@ function register26(program3) {
       }
       const includeSelf = !!opts.includeSelf;
       const selfUidUpper = cred.uid.toUpperCase();
-      const selfAppKey = requireConfig().appKey;
-      const session = await openChatSession(cred, { os: opts.os, debug: opts.debug });
+      const cfg = requireConfig();
+      const selfAppKey = cfg.appKey;
+      const os = resolveChatOs(opts.os, cfg);
+      const session = await openChatSession(cred, { os, debug: opts.debug });
       const { socket } = session;
       const json = isJsonMode();
       let matched = 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mu-cabin/muc-cli",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Terminal client for MUC IM (com.meicloud.im.dh).",
   "license": "MIT",
   "type": "module",