@shadowob/cli 1.1.7 → 1.1.9

package/dist/index.js

@@ -9,7 +9,7 @@ import {
 } from "./chunk-S6XCO6ZW.js";
 
 // src/index.ts
-import { Command as Command28 } from "commander";
+import { Command as Command29 } from "commander";
 
 // src/commands/api-tokens.ts
 import { Command } from "commander";
@@ -183,6 +183,115 @@ function commandHandlerError(error, json) {
   outputError(error instanceof Error ? error.message : String(error), { json });
   process.exit(1);
 }
+function prettyJson(value) {
+  return JSON.stringify(value, null, 2);
+}
+function commandSummary(command) {
+  return command.help?.summary ?? command.description ?? command.title ?? command.permission;
+}
+function formatAppCommandHelp(input) {
+  const { appKey, serverId, manifest, commandName } = input;
+  const command = commandName ? manifest.commands.find((item) => item.name === commandName) : void 0;
+  if (commandName && !command) throw new Error(`App command not found: ${commandName}`);
+  if (!command) {
+    const lines2 = [
+      `${manifest.name} (${appKey})`,
+      manifest.description ?? "",
+      manifest.help?.overview ?? "",
+      "",
+      "Usage:",
+      `  shadowob app call ${appKey} <command> --server "${serverId}" --json-input '<input-json>' --json`,
+      `  shadowob app call ${appKey} <command> --server "${serverId}" --help`,
+      manifest.binary?.supported ? `  shadowob app call ${appKey} <command> --server "${serverId}" --file ./asset.png --json-input '<input-json>' --json` : "",
+      "",
+      "Commands:",
+      ...manifest.commands.map((item) => `  ${item.name.padEnd(24)} ${commandSummary(item)}`),
+      manifest.realtime ? [
+        "",
+        "Realtime:",
+        `  shadowob app events ${appKey} --server "${serverId}" --json`,
+        manifest.realtime.subscribe?.help ?? "",
+        manifest.realtime.publish?.help ?? ""
+      ].join("\n") : ""
+    ];
+    return lines2.filter(Boolean).join("\n");
+  }
+  const help = command.help;
+  const usage = help?.usage ?? `shadowob app call ${appKey} ${command.name} --server "${serverId}" --json-input '<input-json>' --json`;
+  const lines = [
+    `${manifest.name} ${command.name}`,
+    commandSummary(command),
+    "",
+    "Usage:",
+    `  ${usage}`,
+    command.binary?.supported || command.input === "multipart" ? `  shadowob app call ${appKey} ${command.name} --server "${serverId}" --file ./asset.png --json-input '<input-json>' --json` : "",
+    help?.details ? ["", help.details].join("\n") : "",
+    help?.examples?.length ? [
+      "",
+      "Examples:",
+      ...help.examples.flatMap((example) => {
+        const rendered = example.command ? [`  ${example.command}`] : example.input !== void 0 ? [`  ${prettyJson(example.input).replace(/\n/g, "\n  ")}`] : [];
+        return example.title ? [`  # ${example.title}`, ...rendered] : rendered;
+      })
+    ].join("\n") : "",
+    command.inputSchema ? ["", "Input schema:", prettyJson(command.inputSchema)].join("\n") : ""
+  ];
+  return lines.filter(Boolean).join("\n");
+}
+function parseSseEvents(chunk, carry) {
+  const frames = `${carry}${chunk}`.split(/\r?\n\r?\n/u);
+  return {
+    complete: frames.slice(0, -1),
+    carry: frames.at(-1) ?? ""
+  };
+}
+function decodeSseFrame(frame) {
+  let event = "message";
+  const data = [];
+  for (const line of frame.split(/\r?\n/u)) {
+    if (line.startsWith("event:")) event = line.slice(6).trim();
+    if (line.startsWith("data:")) data.push(line.slice(5).trimStart());
+  }
+  return { event, data: data.join("\n") };
+}
+async function streamServerAppEvents(input) {
+  const response = await fetch(input.url, { headers: { Accept: "text/event-stream" } });
+  if (!response.ok || !response.body) {
+    throw new Error(`Event stream failed (${response.status})`);
+  }
+  const reader = response.body.getReader();
+  const decoder = new TextDecoder();
+  let carry = "";
+  let count = 0;
+  const stop = () => reader.cancel().catch(() => void 0);
+  process.once("SIGINT", stop);
+  try {
+    while (true) {
+      const next = await reader.read();
+      if (next.done) break;
+      const parsed = parseSseEvents(decoder.decode(next.value, { stream: true }), carry);
+      carry = parsed.carry;
+      for (const frame of parsed.complete) {
+        const decoded = decodeSseFrame(frame);
+        if (!decoded.data || input.event && decoded.event !== input.event) continue;
+        let payload = decoded.data;
+        try {
+          payload = JSON.parse(decoded.data);
+        } catch {
+        }
+        if (input.json) console.log(JSON.stringify({ event: decoded.event, data: payload }));
+        else
+          console.log(
+            `[${decoded.event}] ${typeof payload === "string" ? payload : prettyJson(payload)}`
+          );
+        count += 1;
+        if (input.limit && count >= input.limit) return;
+      }
+    }
+  } finally {
+    process.off("SIGINT", stop);
+  }
+}
 function createAppCommand() {
   const app = new Command2("app").description("Server App integration commands");
   app.command("list").description("List apps installed in a server").requiredOption("--server <server>", "Server ID or slug").option("--profile <name>", "Profile to use").option("--json", "Output as JSON").action(async (options) => {
@@ -336,21 +445,80 @@ function createAppCommand() {
       }
     }
   );
-  app.command("call").description("Call a server App command").argument("<app-key>", "App key").argument("<command>", "Command name").requiredOption("--server <server>", "Server ID or slug").option("--json-input <json>", "JSON command input").option("--input-file <path>", "Read JSON command input from file").option("--channel-id <id>", "Current Shadow channel ID for approval prompts and app context").option("--file <path>", "Attach a binary file").option("--field <field>", "Multipart file field name", "file").option("--output <path>", "Write binary dataBase64 response to this path").option("--profile <name>", "Profile to use").option("--json", "Output as JSON").action(
+  app.command("events").description("Subscribe to an installed server App event stream").argument("<app-key>", "App key").requiredOption("--server <server>", "Server ID or slug").option("--event <event>", "Only print one event type").option("--limit <count>", "Stop after this many matching events").option("--profile <name>", "Profile to use").option("--json", "Output as JSON lines").action(
+    async (appKey, options) => {
+      try {
+        const client = await getClient(options.profile);
+        const launch = await client.createServerAppLaunch(
+          resolveServerFlag(options.server),
+          appKey
+        );
+        const limit = options.limit ? Number.parseInt(options.limit, 10) : void 0;
+        if (limit !== void 0 && (!Number.isFinite(limit) || limit < 1)) {
+          throw new Error("--limit must be a positive integer");
+        }
+        await streamServerAppEvents({
+          url: client.serverAppEventStreamUrl(launch.eventStreamPath),
+          event: options.event,
+          limit,
+          json: options.json
+        });
+      } catch (error) {
+        commandHandlerError(error, options.json);
+      }
+    }
+  );
+  app.command("call").description("Call a server App command").helpOption(false).argument("[app-key]", "App key").argument("[command]", "Command name").option("--server <server>", "Server ID or slug").option("--json-input <json>", "JSON command input").option("--input-file <path>", "Read JSON command input from file").option("--channel-id <id>", "Current Shadow channel ID for approval prompts and app context").option("--task-message-id <id>", "Inbox task message ID to bind this app command to").option("--task-card-id <id>", "Inbox task card ID to bind this app command to").option("--task-claim-id <id>", "Inbox task claim ID to bind this app command to").option("--file <path>", "Attach a binary file").option("--field <field>", "Multipart file field name", "file").option("--output <path>", "Write binary dataBase64 response to this path").option("--profile <name>", "Profile to use").option("--json", "Output as JSON").option("-h, --help", "Show app or command help from the installed manifest").action(
     async (appKey, commandName, options) => {
       try {
+        if (options.help) {
+          if (!appKey) {
+            console.log(
+              [
+                "Usage:",
+                "  shadowob app call <app-key> <command> --server <server> --json-input '<input-json>' --json",
+                "  shadowob app call <app-key> <command> --server <server> --help"
+              ].join("\n")
+            );
+            return;
+          }
+          const client2 = await getClient(options.profile);
+          const server2 = resolveServerFlag(options.server);
+          const app2 = await client2.getServerApp(server2, appKey);
+          console.log(
+            formatAppCommandHelp({
+              appKey,
+              serverId: app2.serverId,
+              manifest: app2.manifest,
+              commandName
+            })
+          );
+          return;
+        }
+        if (!appKey) throw new Error("Missing app key");
+        if (!commandName) throw new Error("Missing command name");
         const client = await getClient(options.profile);
         const input = options.inputFile ? await readJsonFile(options.inputFile) : parseJsonInput(options.jsonInput);
         const server = resolveServerFlag(options.server);
+        if ((options.taskMessageId || options.taskCardId || options.taskClaimId) && !(options.taskMessageId && options.taskCardId)) {
+          throw new Error("--task-message-id and --task-card-id are required together");
+        }
+        const task = options.taskMessageId && options.taskCardId ? {
+          messageId: options.taskMessageId,
+          cardId: options.taskCardId,
+          ...options.taskClaimId ? { claimId: options.taskClaimId } : {}
+        } : void 0;
         const result = options.file ? await client.callServerAppCommandMultipart(server, appKey, commandName, {
           input,
           channelId: options.channelId,
+          task,
           file: new Blob([await readFile(options.file)]),
           filename: basename(options.file),
           field: options.field
         }) : await client.callServerAppCommand(server, appKey, commandName, {
           input,
-          channelId: options.channelId
+          channelId: options.channelId,
+          task
         });
         if (options.output && result && typeof result === "object" && "dataBase64" in result && typeof result.dataBase64 === "string") {
           await writeFile(
@@ -1320,10 +1488,213 @@ function createFriendsCommand() {
   return friends;
 }
 
-// src/commands/invites.ts
+// src/commands/inbox.ts
 import { Command as Command12 } from "commander";
+var TASK_STATUSES = /* @__PURE__ */ new Set([
+  "queued",
+  "claimed",
+  "running",
+  "completed",
+  "failed",
+  "canceled",
+  "transferred"
+]);
+function parseTaskStatus(value) {
+  if (!TASK_STATUSES.has(value)) {
+    throw new Error(`Invalid task status: ${value}`);
+  }
+  return value;
+}
+function parseJsonOption(value, label) {
+  if (!value) return void 0;
+  try {
+    return JSON.parse(value);
+  } catch {
+    throw new Error(`Invalid JSON for ${label}`);
+  }
+}
+function parseTaskSourceOption(value) {
+  const source = parseJsonOption(value, "source-json");
+  if (!source) return void 0;
+  if (typeof source.kind !== "string" || !source.kind.trim()) {
+    throw new Error("Invalid source-json: kind is required");
+  }
+  return source;
+}
+function createInboxCommand() {
+  const inbox = new Command12("inbox").description("Buddy Inbox task-card commands");
+  inbox.command("list").description("List Buddy Inbox entries").option("--server <server>", "Server ID or slug").option("--profile <name>", "Profile to use").option("--json", "Output as JSON").action(async (options) => {
+    try {
+      const client = await getClient(options.profile);
+      const result = options.server ? await client.listServerBuddyInboxes(resolveServerFlag(options.server)) : await client.listBuddyInboxes();
+      output(result, { json: options.json });
+    } catch (error) {
+      outputError(error instanceof Error ? error.message : String(error), {
+        json: options.json
+      });
+      process.exit(1);
+    }
+  });
+  inbox.command("ensure").description("Create or repair a Buddy Inbox channel").requiredOption("--server <server>", "Server ID or slug").requiredOption("--agent <agent-id>", "Buddy agent ID").option("--profile <name>", "Profile to use").option("--json", "Output as JSON").action(
+    async (options) => {
+      try {
+        const client = await getClient(options.profile);
+        const result = await client.ensureBuddyInbox(
+          resolveServerFlag(options.server),
+          options.agent
+        );
+        output(result, { json: options.json });
+      } catch (error) {
+        outputError(error instanceof Error ? error.message : String(error), {
+          json: options.json
+        });
+        process.exit(1);
+      }
+    }
+  );
+  inbox.command("enqueue").description("Enqueue a new task card into a Buddy Inbox").requiredOption("--title <title>", "Task title").option("--body <text>", "Task body").option("--priority <priority>", "low|normal|high|urgent").option("--idempotency-key <key>", "Idempotency key").option("--server <server>", "Server ID or slug; required with --agent").option("--agent <agent-id>", "Buddy agent ID").option("--channel <channel-id>", "Buddy Inbox channel ID").option("--source-json <json>", "Task source JSON").option("--data-json <json>", "Task data JSON").option("--profile <name>", "Profile to use").option("--json", "Output as JSON").action(
+    async (options) => {
+      try {
+        const client = await getClient(options.profile);
+        const task = {
+          title: options.title
+        };
+        if (options.body) task.body = options.body;
+        if (options.priority) task.priority = options.priority;
+        if (options.idempotencyKey) task.idempotencyKey = options.idempotencyKey;
+        const source = parseTaskSourceOption(options.sourceJson);
+        if (source) task.source = source;
+        const data = parseJsonOption(options.dataJson, "data-json");
+        if (data) task.data = data;
+        const result = options.channel ? await client.enqueueInboxTask(options.channel, task) : options.server && options.agent ? await client.enqueueInboxTaskForAgent(
+          resolveServerFlag(options.server),
+          options.agent,
+          task
+        ) : null;
+        if (!result) throw new Error("Provide either --channel or both --server and --agent");
+        output(result, { json: options.json });
+      } catch (error) {
+        outputError(error instanceof Error ? error.message : String(error), {
+          json: options.json
+        });
+        process.exit(1);
+      }
+    }
+  );
+  inbox.command("policy").description("Read or update a Buddy Inbox admission policy").requiredOption("--server <server>", "Server ID or slug").requiredOption("--agent <agent-id>", "Buddy agent ID").option("--set-json <json>", "Admission policy JSON to write").option("--profile <name>", "Profile to use").option("--json", "Output as JSON").action(
+    async (options) => {
+      try {
+        const client = await getClient(options.profile);
+        const server = resolveServerFlag(options.server);
+        const policy = options.setJson ? parseJsonOption(options.setJson, "set-json") : null;
+        const result = options.setJson ? await client.updateBuddyInboxAdmissionPolicy(server, options.agent, policy) : await client.getBuddyInboxAdmissionPolicy(server, options.agent);
+        output(result, { json: options.json });
+      } catch (error) {
+        outputError(error instanceof Error ? error.message : String(error), {
+          json: options.json
+        });
+        process.exit(1);
+      }
+    }
+  );
+  inbox.command("claim").description("Claim an Inbox task card by message/card id").argument("<message-id>", "Message ID containing the task card").argument("<card-id>", "Task card ID").option("--ttl-seconds <n>", "Claim TTL in seconds", "3600").option("--note <text>", "Progress note").option("--profile <name>", "Profile to use").option("--json", "Output as JSON").action(
+    async (messageId, cardId, options) => {
+      try {
+        const client = await getClient(options.profile);
+        const message = await client.claimTaskCard(messageId, cardId, {
+          ttlSeconds: parsePositiveInt(options.ttlSeconds ?? "3600", "ttl-seconds"),
+          note: options.note
+        });
+        output(message, { json: options.json });
+      } catch (error) {
+        outputError(error instanceof Error ? error.message : String(error), {
+          json: options.json
+        });
+        process.exit(1);
+      }
+    }
+  );
+  inbox.command("update").description("Update an Inbox task card status").argument("<message-id>", "Message ID containing the task card").argument("<card-id>", "Task card ID").requiredOption(
+    "--status <status>",
+    "queued|claimed|running|completed|failed|canceled|transferred"
+  ).option("--note <text>", "Progress note").option("--profile <name>", "Profile to use").option("--json", "Output as JSON").action(
+    async (messageId, cardId, options) => {
+      try {
+        const client = await getClient(options.profile);
+        const message = await client.updateTaskCard(messageId, cardId, {
+          status: parseTaskStatus(options.status),
+          note: options.note
+        });
+        output(message, { json: options.json });
+      } catch (error) {
+        outputError(error instanceof Error ? error.message : String(error), {
+          json: options.json
+        });
+        process.exit(1);
+      }
+    }
+  );
+  inbox.command("retry").description("Copy a failed task card into a new queued task and mark the original transferred").argument("<message-id>", "Message ID containing the task card").argument("<card-id>", "Task card ID").option("--note <text>", "Transfer note").option("--profile <name>", "Profile to use").option("--json", "Output as JSON").action(
+    async (messageId, cardId, options) => {
+      try {
+        const client = await getClient(options.profile);
+        const result = await client.retryTaskCard(messageId, cardId, { note: options.note });
+        output(result, { json: options.json });
+      } catch (error) {
+        outputError(error instanceof Error ? error.message : String(error), {
+          json: options.json
+        });
+        process.exit(1);
+      }
+    }
+  );
+  inbox.command("claim-next").description("Claim the next available task in a Buddy Inbox").requiredOption("--server <server>", "Server ID or slug").requiredOption("--agent <agent-id>", "Buddy agent ID").option("--ttl-seconds <n>", "Claim TTL in seconds", "3600").option("--note <text>", "Progress note").option("--profile <name>", "Profile to use").option("--json", "Output as JSON").action(
+    async (options) => {
+      try {
+        const client = await getClient(options.profile);
+        const result = await client.claimNextInboxTask(
+          resolveServerFlag(options.server),
+          options.agent,
+          {
+            ttlSeconds: parsePositiveInt(options.ttlSeconds ?? "3600", "ttl-seconds"),
+            note: options.note
+          }
+        );
+        output(result, { json: options.json });
+      } catch (error) {
+        outputError(error instanceof Error ? error.message : String(error), {
+          json: options.json
+        });
+        process.exit(1);
+      }
+    }
+  );
+  inbox.command("promote").description("Promote a chat message into a Buddy Inbox task").argument("<message-id>", "Source message ID").requiredOption("--server <server>", "Server ID or slug").requiredOption("--agent <agent-id>", "Buddy agent ID").option("--title <title>", "Task title override").option("--priority <priority>", "low|normal|high|urgent").option("--profile <name>", "Profile to use").option("--json", "Output as JSON").action(
+    async (messageId, options) => {
+      try {
+        const client = await getClient(options.profile);
+        const message = await client.promoteMessageToInboxTask(messageId, {
+          serverId: resolveServerFlag(options.server),
+          agentId: options.agent,
+          title: options.title,
+          priority: options.priority
+        });
+        output(message, { json: options.json });
+      } catch (error) {
+        outputError(error instanceof Error ? error.message : String(error), {
+          json: options.json
+        });
+        process.exit(1);
+      }
+    }
+  );
+  return inbox;
+}
+
+// src/commands/invites.ts
+import { Command as Command13 } from "commander";
 function createInvitesCommand() {
-  const invites = new Command12("invites").description("Invite code management commands");
+  const invites = new Command13("invites").description("Invite code management commands");
   invites.command("list").description("List your invite codes").option("--profile <name>", "Profile to use").option("--json", "Output as JSON").action(async (options) => {
     try {
       const client = await getClient(options.profile);
@@ -1374,9 +1745,9 @@ function createInvitesCommand() {
 }
 
 // src/commands/listen.ts
-import { Command as Command13 } from "commander";
+import { Command as Command14 } from "commander";
 function createListenCommand() {
-  const listen = new Command13("listen").description("Listen to real-time events");
+  const listen = new Command14("listen").description("Listen to real-time events");
   listen.command("channel").description("Listen to events in a channel").argument("<channel-id>", "Channel ID").option("--mode <mode>", "Listen mode: stream or poll", "stream").option("--timeout <seconds>", "Timeout in seconds (stream mode)", "60").option("--count <n>", "Stop after N events (stream mode)").option("--since <duration>", "Poll events since duration (e.g., 5m, 1h)", "5m").option("--last <n>", "Poll last N messages", "50").option("--event-type <type>", "Filter by event type (comma-separated)").option("--profile <name>", "Profile to use").option("--json", "Output as JSON (one per line)").action(
     async (channelId, options) => {
       try {
@@ -1496,9 +1867,9 @@ function createListenCommand() {
 }
 
 // src/commands/marketplace.ts
-import { Command as Command14 } from "commander";
+import { Command as Command15 } from "commander";
 function createMarketplaceCommand() {
-  const marketplace = new Command14("marketplace").description("Marketplace commands");
+  const marketplace = new Command15("marketplace").description("Marketplace commands");
   const listings = marketplace.command("listings").description("Listing commands");
   listings.command("list").description("Browse marketplace listings").option("--search <text>", "Search query").option("--tags <tags>", "Comma-separated tags").option("--min-price <n>", "Minimum price per hour").option("--max-price <n>", "Maximum price per hour").option("--limit <n>", "Number of results", "20").option("--offset <n>", "Pagination offset", "0").option("--profile <name>", "Profile to use").option("--json", "Output as JSON").action(
     async (options) => {
@@ -1643,9 +2014,9 @@ function createMarketplaceCommand() {
 
 // src/commands/media.ts
 import { readFileSync } from "fs";
-import { Command as Command15 } from "commander";
+import { Command as Command16 } from "commander";
 function createMediaCommand() {
-  const media = new Command15("media").description("Media management commands");
+  const media = new Command16("media").description("Media management commands");
   media.command("upload").description("Upload a file").requiredOption("--file <path>", "File path to upload").option("--message-id <id>", "Associate with message").option("--profile <name>", "Profile to use").option("--json", "Output as JSON").action(
     async (options) => {
       try {
@@ -1711,9 +2082,9 @@ function createMediaCommand() {
 }
 
 // src/commands/notifications.ts
-import { Command as Command16 } from "commander";
+import { Command as Command17 } from "commander";
 function createNotificationsCommand() {
-  const notifications = new Command16("notifications").description("Notification commands");
+  const notifications = new Command17("notifications").description("Notification commands");
   notifications.command("list").description("List notifications").option("--unread-only", "Show only unread notifications").option("--limit <n>", "Number of notifications", "20").option("--profile <name>", "Profile to use").option("--json", "Output as JSON").action(
     async (options) => {
       try {
@@ -1792,7 +2163,7 @@ function splitIds(value) {
 }
 
 // src/commands/oauth.ts
-import { Command as Command17 } from "commander";
+import { Command as Command18 } from "commander";
 function resolveOAuthAccessToken(options) {
   const token = options.accessToken || process.env.SHADOWOB_OAUTH_TOKEN;
   if (!token) {
@@ -1809,7 +2180,7 @@ function parseMetadata2(value) {
   return parsed;
 }
 function createOAuthCommand() {
-  const oauth = new Command17("oauth").description("OAuth management commands");
+  const oauth = new Command18("oauth").description("OAuth management commands");
   oauth.command("list").description("List OAuth apps").option("--profile <name>", "Profile to use").option("--json", "Output as JSON").action(async (options) => {
     try {
       const client = await getClient(options.profile);
@@ -1942,9 +2313,9 @@ function createOAuthCommand() {
 }
 
 // src/commands/ping.ts
-import { Command as Command18 } from "commander";
+import { Command as Command19 } from "commander";
 function createPingCommand() {
-  const ping = new Command18("ping").description("Test connection to Shadow server");
+  const ping = new Command19("ping").description("Test connection to Shadow server");
   ping.option("--profile <name>", "Profile to use").option("--json", "Output as JSON").action(async (options) => {
     const startTime = Date.now();
     const outputOpts = { json: options.json };
@@ -1993,9 +2364,9 @@ function createPingCommand() {
 }
 
 // src/commands/profile-comments.ts
-import { Command as Command19 } from "commander";
+import { Command as Command20 } from "commander";
 function createProfileCommentsCommand() {
-  const comments = new Command19("profile-comments").description(
+  const comments = new Command20("profile-comments").description(
     "Profile comment management commands"
   );
   comments.command("get").description("Get comments for a user profile").argument("<user-id>", "Profile user ID").option("--limit <n>", "Number of results", "20").option("--offset <n>", "Offset for pagination", "0").option("--profile <name>", "Profile to use").option("--json", "Output as JSON").action(async (userId, options) => {
@@ -2045,9 +2416,9 @@ function createProfileCommentsCommand() {
 }
 
 // src/commands/search.ts
-import { Command as Command20 } from "commander";
+import { Command as Command21 } from "commander";
 function createSearchCommand() {
-  const search = new Command20("search").description("Search commands");
+  const search = new Command21("search").description("Search commands");
   search.command("messages").description("Search messages").requiredOption("--query <text>", "Search query").option("--server <server>", "Limit to server").option("--channel-id <id>", "Limit to channel").option("--limit <n>", "Number of results (1-100)", "20").option("--profile <name>", "Profile to use").option("--json", "Output as JSON").action(
     async (options) => {
       try {
@@ -2072,9 +2443,9 @@ function createSearchCommand() {
 }
 
 // src/commands/servers.ts
-import { Command as Command21 } from "commander";
+import { Command as Command22 } from "commander";
 function createServersCommand() {
-  const servers = new Command21("servers").description("Server management commands");
+  const servers = new Command22("servers").description("Server management commands");
   servers.command("list").description("List all servers you have joined").option("--profile <name>", "Profile to use").option("--json", "Output as JSON").action(async (options) => {
     try {
       const client = await getClient(options.profile);
@@ -2181,7 +2552,7 @@ function createServersCommand() {
 }
 
 // src/commands/shop.ts
-import { Command as Command22 } from "commander";
+import { Command as Command23 } from "commander";
 function parseJsonObject(value, optionName) {
   if (!value) return {};
   const parsed = JSON.parse(value);
@@ -2199,7 +2570,7 @@ function parseOptionalNumber(value, optionName) {
   return parsed;
 }
 function createShopCommand() {
-  const shop = new Command22("shop").description("Shop commands");
+  const shop = new Command23("shop").description("Shop commands");
   shop.command("get").description("Get shop info").argument("<server-id>", "Server ID").option("--profile <name>", "Profile to use").option("--json", "Output as JSON").action(async (serverId, options) => {
     try {
       const client = await getClient(options.profile);
@@ -2541,9 +2912,9 @@ function createShopCommand() {
 }
 
 // src/commands/status.ts
-import { Command as Command23 } from "commander";
+import { Command as Command24 } from "commander";
 function createStatusCommand() {
-  const status = new Command23("status").description("Show detailed status information");
+  const status = new Command24("status").description("Show detailed status information");
   status.option("--profile <name>", "Profile to use").option("--json", "Output as JSON").action(async (options) => {
     const outputOpts = { json: options.json };
     try {
@@ -2621,9 +2992,9 @@ function createStatusCommand() {
 }
 
 // src/commands/threads.ts
-import { Command as Command24 } from "commander";
+import { Command as Command25 } from "commander";
 function createThreadsCommand() {
-  const threads = new Command24("threads").description("Thread commands");
+  const threads = new Command25("threads").description("Thread commands");
   threads.command("list").description("List threads in a channel").argument("<channel-id>", "Channel ID").option("--profile <name>", "Profile to use").option("--json", "Output as JSON").action(async (channelId, options) => {
     try {
       const client = await getClient(options.profile);
@@ -2706,7 +3077,7 @@ function createThreadsCommand() {
 
 // src/commands/voice.ts
 import { join as join2 } from "path";
-import { Command as Command25 } from "commander";
+import { Command as Command26 } from "commander";
 
 // src/utils/voice-media-bridge.ts
 import { execFileSync as execFileSync2, spawn } from "child_process";
@@ -3841,7 +4212,7 @@ function resolveProfileOption(options, command) {
   return options.profile ?? command.optsWithGlobals().profile;
 }
 function createVoiceCommand() {
-  const voice = new Command25("voice").description("Voice channel commands");
+  const voice = new Command26("voice").description("Voice channel commands");
   voice.command("join").description("Join a voice channel and print Agora connection info").argument("<channel-id>", "Voice channel ID").option("--muted", "Join muted").option("--deafened", "Join deafened").option("--watch", "Keep the process attached and print voice events").option("--profile <name>", "Profile to use").option("--json", "Output as JSON").action(
     async (channelId, options, command) => {
       try {
@@ -3981,7 +4352,7 @@ function createVoiceCommand() {
       }
     }
   );
-  const browser = new Command25("browser").description("Voice bridge browser runtime commands");
+  const browser = new Command26("browser").description("Voice bridge browser runtime commands");
   browser.command("install").description("Install an isolated Chromium runtime for voice bridge tests").option("--json", "Output as JSON").action(async (options) => {
     try {
       const executable = await installVoiceTestBrowser({ json: options.json });
@@ -4012,9 +4383,9 @@ function createVoiceCommand() {
 }
 
 // src/commands/voice-enhance.ts
-import { Command as Command26 } from "commander";
+import { Command as Command27 } from "commander";
 function createVoiceEnhanceCommand() {
-  const voice = new Command26("voice-enhance").description("Voice enhancement commands");
+  const voice = new Command27("voice-enhance").description("Voice enhancement commands");
   voice.command("enhance").description("Enhance a voice transcript").requiredOption("--transcript <text>", "Transcript text to enhance").option("--language <lang>", "Language code (e.g. zh-CN, en-US)").option("--no-self-correction", "Disable self-correction").option("--no-list-formatting", "Disable list formatting").option("--no-filler-removal", "Disable filler word removal").option("--tone-adjustment", "Enable tone adjustment").option("--target-tone <tone>", "Target tone (formal, casual, professional)").option("--profile <name>", "Profile to use").option("--json", "Output as JSON").action(async (options) => {
     try {
       const client = await getClient(options.profile);
@@ -4054,9 +4425,9 @@ function createVoiceEnhanceCommand() {
 
 // src/commands/workspace.ts
 import { readFile as readFile3 } from "fs/promises";
-import { Command as Command27 } from "commander";
+import { Command as Command28 } from "commander";
 function createWorkspaceCommand() {
-  const workspace = new Command27("workspace").description("Workspace file management commands");
+  const workspace = new Command28("workspace").description("Workspace file management commands");
   workspace.command("get").description("Get workspace info").argument("<server-id>", "Server ID or slug").option("--profile <name>", "Profile to use").option("--json", "Output as JSON").action(async (serverId, options) => {
     try {
       const client = await getClient(options.profile);
@@ -4238,7 +4609,7 @@ function createWorkspaceCommand() {
 }
 
 // src/index.ts
-var program = new Command28();
+var program = new Command29();
 program.name("shadowob").description("Shadow CLI \u2014 command-line interface for Shadow servers").version("0.1.0").configureHelp({
   sortSubcommands: true
 });
@@ -4249,6 +4620,7 @@ program.addCommand(createServersCommand());
 program.addCommand(createChannelsCommand());
 program.addCommand(createThreadsCommand());
 program.addCommand(createBuddiesCommand());
+program.addCommand(createInboxCommand());
 program.addCommand(createListenCommand());
 program.addCommand(createDirectMessagesCommand());
 program.addCommand(createWorkspaceCommand());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shadowob/cli",
-  "version": "1.1.7",
+  "version": "1.1.9",
   "description": "Shadow CLI — command-line interface for Shadow servers",
   "license": "MIT",
   "type": "module",
@@ -13,7 +13,7 @@
   "dependencies": {
     "commander": "^13.1.0",
     "chalk": "^5.4.1",
-    "@shadowob/sdk": "1.1.7"
+    "@shadowob/sdk": "1.1.9"
   },
   "devDependencies": {
     "@types/node": "^22.15.21",