@mosse-ai/cli 0.1.0 → 0.1.2

package/dist/index.js

@@ -22626,9 +22626,9 @@ var InboxWaitTool = {
   summary: "Wait quietly for a realtime Inbox event for the signed-in user's ID (server checks ownership). Read Inbox before waiting and after every result, including timeout/reconnect, to recover missed events. Timeout is normal: do not send a chat update for it. This bounded call does not wake an idle host or schedule another turn. Coalesce new notifications; do not repeatedly report already handled items.",
   input: external_exports.strictObject({ userId: external_exports.uuid(), timeoutMs: external_exports.number().int().min(1e3).max(25e3).default(25e3) }),
   effect: "read",
-  transport: { kind: "stream" },
+  transport: { kind: "rest", method: "GET", path: "/api/inbox/wait" },
   mcpName: "inbox_wait",
-  cliOmitted: "long-poll needs a streaming endpoint; MD-461 \u672C\u8F6E\u4E0D\u7ED9 CLI(MD-462 \u4E4B\u540E\u53E6\u8BAE)"
+  cli: { path: ["inbox", "wait"], example: "mosse inbox wait --timeout-ms 25000 --json" }
 };
 var SESSION_TOOLS = [
   WorkspaceListTool,
@@ -23159,7 +23159,7 @@ function buildCommandTree(options = {}) {
 }
 
 // src/api.ts
-var CLI_VERSION = true ? "0.1.0" : "0.0.0";
+var CLI_VERSION = true ? "0.1.2" : "0.0.0";
 var CLI_USER_AGENT = `mosse-cli/${CLI_VERSION}`;
 async function callApi(request) {
   const headers = {
@@ -23615,9 +23615,182 @@ function packagedSkillMd(version3 = CLI_VERSION) {
   return renderSkillMd(buildCommandTree({ sessionTools: SESSION_TOOLS }), version3);
 }
 
+// src/completions.ts
+var COMPLETION_SHELLS = ["bash", "zsh", "fish"];
+var LOCAL_COMMANDS = [
+  "auth login",
+  "auth logout",
+  "auth status",
+  "auth token",
+  "auth whoami",
+  "skill",
+  "skill install",
+  "skill status",
+  "skill upgrade",
+  "doctor",
+  "completions",
+  "update",
+  "help",
+  "inbox list",
+  "inbox read",
+  "workspace list"
+];
+var GLOBAL_FLAGS = [
+  "--json",
+  "--format",
+  "--workspace",
+  "--dry-run",
+  "--yes",
+  "--help",
+  "--version",
+  "--api-url",
+  "--token"
+];
+function completionWords(tree) {
+  const words = new Set(LOCAL_COMMANDS);
+  for (const command of tree.commands) {
+    for (let length = 1; length <= command.path.length; length += 1) words.add(command.path.slice(0, length).join(" "));
+  }
+  for (const flag of GLOBAL_FLAGS) words.add(flag);
+  return [...words].sort((a, b) => a.localeCompare(b));
+}
+var quote = (value) => `'${value.replaceAll("'", `'\\''`)}'`;
+function bashScript(words) {
+  const list = words.map(quote).join(" ");
+  return `# bash completion for mosse (generated by \`mosse completions bash\`)
+_mosse_complete() {
+  local cur prefix candidate rest next i
+  cur="\${COMP_WORDS[COMP_CWORD]}"
+  prefix=""
+  for ((i = 1; i < COMP_CWORD; i++)); do
+    prefix+="\${COMP_WORDS[i]} "
+  done
+  prefix="\${prefix% }"
+  COMPREPLY=()
+  for candidate in ${list}; do
+    if [[ -z "$prefix" ]]; then
+      rest="$candidate"
+    else
+      [[ "$candidate" == "$prefix "* ]] || continue
+      rest="\${candidate#"$prefix "}"
+    fi
+    next="\${rest%% *}"
+    [[ -z "$next" ]] && continue
+    if [[ "$next" == "$cur"* ]]; then
+      COMPREPLY+=("$next")
+    fi
+  done
+  # \u53BB\u91CD(\u540C\u4E00\u5C42\u53EF\u80FD\u6765\u81EA\u591A\u6761\u547D\u4EE4)
+  if ((\${#COMPREPLY[@]} > 0)); then
+    COMPREPLY=($(printf '%s\\n' "\${COMPREPLY[@]}" | sort -u))
+  fi
+}
+complete -o nosort -F _mosse_complete mosse
+`;
+}
+function zshScript(words) {
+  const list = words.map(quote).join(" ");
+  return `#compdef mosse (generated by \`mosse completions zsh\`)
+_mosse() {
+  local -a candidates
+  candidates=(${list})
+  local prefix rest next cur
+  cur="\${words[CURRENT]}"
+  prefix=""
+  local i
+  for ((i = 2; i < CURRENT; i++)); do
+    prefix+="\${words[i]} "
+  done
+  prefix="\${prefix% }"
+  if [[ -z "$prefix" ]]; then
+    _describe -t commands 'mosse command' candidates
+    return
+  fi
+  local -a matches
+  for candidate in "\${candidates[@]}"; do
+    [[ "$candidate" == "$prefix "* ]] || continue
+    rest="\${candidate#"$prefix "}"
+    next="\${rest%% *}"
+    [[ -z "$next" ]] && continue
+    matches+=("$next")
+  done
+  if ((\${#matches[@]} > 0)); then
+    compadd -a matches
+  fi
+}
+_mosse "$@"
+`;
+}
+function fishScript(words) {
+  const list = words.map(quote).join(" ");
+  return `# fish completion for mosse (generated by \`mosse completions fish\`)
+function __mosse_complete
+  set -l tokens (commandline -opc)
+  set -e tokens[1]
+  set -l prefix (string join " " $tokens)
+  for candidate in ${list}
+    if test -n "$prefix"
+      string match -q -- "$prefix *" $candidate; or continue
+      set -l rest (string replace -- "$prefix " "" $candidate)
+      set -l next (string split -m 1 " " $rest)[1]
+      echo $next
+    else
+      echo (string split -m 1 " " $candidate)[1]
+    end
+  end | sort -u
+end
+complete -c mosse -f -a '(__mosse_complete)'
+`;
+}
+function renderCompletions(tree, shell) {
+  const words = completionWords(tree);
+  if (shell === "bash") return bashScript(words);
+  if (shell === "zsh") return zshScript(words);
+  return fishScript(words);
+}
+
+// src/help.ts
+function editDistance(a, b) {
+  const rows = a.length + 1;
+  const cols = b.length + 1;
+  let prev = Array.from({ length: cols }, (_, i) => i);
+  for (let i = 1; i < rows; i += 1) {
+    const next = [i];
+    for (let j = 1; j < cols; j += 1) {
+      const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+      next[j] = Math.min(prev[j] + 1, next[j - 1] + 1, prev[j - 1] + cost);
+    }
+    prev = next;
+  }
+  return prev[b.length];
+}
+function suggestCommands(tree, tokens, limit2 = 3) {
+  const typed = tokens.join(" ");
+  if (!typed) return [];
+  const typedTokens = new Set(tokens);
+  const scored = tree.commands.map((command) => {
+    const path = command.path.join(" ");
+    const overlap = command.path.filter((segment) => typedTokens.has(segment)).length;
+    const distance = editDistance(typed, path);
+    const startsWith = path.startsWith(typed) ? 1 : 0;
+    return { command, score: distance - overlap * 2 - startsWith * 2 };
+  }).filter((entry) => entry.score <= 4).sort((a, b) => a.score - b.score || a.command.path.length - b.command.path.length);
+  return scored.slice(0, limit2).map((entry) => entry.command);
+}
+function searchCommands(tree, query) {
+  const q = query.trim().toLowerCase();
+  if (!q) return [];
+  return tree.commands.filter(
+    (command) => command.path.join(" ").includes(q) || command.summary.toLowerCase().includes(q)
+  );
+}
+
 // src/cli.ts
 var EXIT_USAGE = 2;
 var EXIT_AUTH = 3;
+var EXIT_NOT_FOUND = 4;
+var INBOX_WAIT_DEFAULT_MS = 25e3;
+var INBOX_WAIT_MAX_MS = 25e3;
 var UsageError = class extends Error {
 };
 function fullTree() {
@@ -23715,12 +23888,12 @@ function suggestFlag(name, flags) {
   let best = null;
   for (const flag of flags) {
     const candidate = flag.name.replace(/^--/, "").replace(/-/g, "");
-    const distance = editDistance(target, candidate);
+    const distance = editDistance2(target, candidate);
     if (distance <= 2 && (!best || distance < best.distance)) best = { name: flag.name, distance };
   }
   return best ? `; did you mean ${best.name}?` : "";
 }
-function editDistance(a, b) {
+function editDistance2(a, b) {
   const rows = a.length + 1;
   const cols = b.length + 1;
   let prev = Array.from({ length: cols }, (_, j) => j);
@@ -23897,11 +24070,31 @@ async function runCli(argv, deps) {
   }
   const envWorkspace = deps.env.MOSSE_WORKSPACE?.trim();
   const workspaceOf = () => globals.workspace ?? envWorkspace;
-  const { head, tail } = splitHead(rest);
+  const effective = rest[0] === "workspace" && rest[1] === "list" ? ["auth", "whoami"].concat(rest.slice(2)) : rest;
+  if (rest[0] === "workspace" && rest.length === 1) {
+    deps.stdout(workspaceHelp(tree));
+    return 0;
+  }
+  const { head, tail } = splitHead(effective);
+  const rootHelp = () => `${tree.rootHelp}
+Local commands:
+  auth <login|logout|status|token>  credentials (not part of the tool surface)
+  skill [install|status|upgrade]    agent cheatsheet (mosse skill for the one-pager)
+  doctor                            local environment check
+  completions <bash|zsh|fish>       shell completion script
+  workspace list                    list workspaces (alias of auth whoami)
+  inbox wait [--timeout-ms <ms>]    long-poll one inbox notification (exit 4 on timeout)
+  update                            check npm for a newer @mosse-ai/cli
+  help [query]                      search commands by path / description
+`;
   if (!head.length) {
-    deps.stdout(tree.rootHelp);
+    deps.stdout(rootHelp());
     return 0;
   }
+  if (head[0] === "inbox" && head[1] === "wait") return handleInboxWait(rest.slice(2), deps, config2, globals);
+  if (head[0] === "update") return handleUpdate(rest.slice(1), deps, globals);
+  if (head[0] === "help") return handleHelpSearch(rest.slice(1), deps, tree, rootHelp());
+  if (head[0] === "completions") return handleCompletions(rest.slice(1), deps, tree, globals);
   if (head[0] === "skill") return handleSkill(rest.slice(1), deps, configPath, config2, tree, globals);
   if (head[0] === "doctor") return handleDoctor(deps, config2, globals);
   if (head[0] === "auth" && (head[1] === void 0 || AUTH_SUBCOMMANDS.has(head[1])))
@@ -23912,7 +24105,11 @@ async function runCli(argv, deps) {
       deps.stdout(renderGroupHelp(tree.commands, head));
       return 0;
     }
-    deps.stderr(structuredError(globals, EXIT_USAGE, "unknown_command", `no such command: mosse ${head.join(" ")}`));
+    const suggestions = suggestCommands(tree, head);
+    const hint = suggestions.length ? `; did you mean: ${suggestions.map((item) => `mosse ${item.path.join(" ")}`).join(", ")}` : "";
+    deps.stderr(
+      structuredError(globals, EXIT_USAGE, "unknown_command", `no such command: mosse ${head.join(" ")}${hint}`)
+    );
     deps.stderr(tree.rootHelp);
     return EXIT_USAGE;
   }
@@ -24075,6 +24272,216 @@ function sessionPath(tool, input2) {
     return encodeURIComponent(String(value));
   });
 }
+async function handleUpdate(args, deps, globals) {
+  if (args[0] === "--help" || args[0] === "-h") {
+    deps.stdout("mosse update\n\n\u68C0\u67E5 npm \u4E0A\u7684\u6700\u65B0\u7248;\u4E0D\u81EA\u52A8\u5B89\u88C5,\u53EA\u6253\u5370\u5347\u7EA7\u547D\u4EE4\u3002\n");
+    return 0;
+  }
+  const registry2 = "https://registry.npmjs.org/@mosse-ai/cli/latest";
+  let latest;
+  try {
+    const response = await deps.fetch(registry2, { headers: { accept: "application/json" } });
+    if (!response.ok) throw new Error(`registry responded ${response.status}`);
+    const body = await response.json();
+    if (!body.version) throw new Error("registry response has no version");
+    latest = body.version;
+  } catch (error62) {
+    deps.stderr(
+      structuredError(
+        globals,
+        1,
+        "update_check_failed",
+        `could not check the npm registry: ${error62.message}`
+      )
+    );
+    return 1;
+  }
+  const upToDate = compareVersions(latest, CLI_VERSION) <= 0;
+  if (globals.json !== void 0) {
+    deps.stdout(renderOutput({ current: CLI_VERSION, latest, upToDate }, outputOptions(globals)));
+  } else {
+    deps.stdout(
+      upToDate ? `mosse ${CLI_VERSION} is up to date (latest ${latest})` : `mosse ${CLI_VERSION} \u2192 ${latest} available
+  npm i -g @mosse-ai/cli@${latest}
+  # or: npx @mosse-ai/cli@latest <command>`
+    );
+  }
+  return 0;
+}
+function compareVersions(a, b) {
+  const pa = a.split(".").map((part) => Number(part) || 0);
+  const pb = b.split(".").map((part) => Number(part) || 0);
+  for (let i = 0; i < Math.max(pa.length, pb.length); i += 1) {
+    const diff = (pa[i] ?? 0) - (pb[i] ?? 0);
+    if (diff !== 0) return diff;
+  }
+  return 0;
+}
+async function handleHelpSearch(args, deps, tree, root) {
+  const query = args.filter((arg) => !arg.startsWith("-")).join(" ").trim();
+  if (!query) {
+    deps.stdout(root);
+    return 0;
+  }
+  const matches = searchCommands(tree, query);
+  if (!matches.length) {
+    deps.stderr(`no commands match "${query}" (try \`mosse --help\`)`);
+    return 0;
+  }
+  deps.stdout(matches.map((command) => `mosse ${command.path.join(" ")}
+    ${command.summary}`).join("\n\n"));
+  return 0;
+}
+async function handleInboxWait(args, deps, config2, globals) {
+  if (args[0] === "--help" || args[0] === "-h") {
+    deps.stdout(
+      [
+        "mosse inbox wait [options]",
+        "",
+        "\u957F\u8F6E\u8BE2\u7B49\u4E00\u6761\u6536\u4EF6\u7BB1\u901A\u77E5(\u4E0E MCP \u7684 inbox_wait \u540C\u4E00\u8BED\u4E49)\u3002",
+        "",
+        "Options:",
+        "  --timeout-ms <ms>   \u7B49\u5F85\u4E0A\u9650 1000\u201325000(\u9ED8\u8BA4 25000;--timeout \u662F\u522B\u540D)",
+        "  --user-id <uuid>    token \u6240\u6709\u8005(\u7F3A\u7701\u81EA\u52A8\u4ECE token \u89E3\u6790)",
+        "  --workspace <id>    \u5DE5\u4F5C\u533A(\u7F3A\u7701\u6309 token \u552F\u4E00 workspace \u63A8\u65AD)",
+        "",
+        "\u9000\u51FA\u7801:0 \u6536\u5230\u901A\u77E5 \xB7 2 \u7528\u6CD5 \xB7 3 \u8BA4\u8BC1/\u6743\u9650 \xB7 4 \u8D85\u65F6(\u672A\u6536\u5230\u901A\u77E5)",
+        ""
+      ].join("\n")
+    );
+    return 0;
+  }
+  let timeoutMs = INBOX_WAIT_DEFAULT_MS;
+  let userId;
+  for (let i = 0; i < args.length; i += 1) {
+    const arg = args[i];
+    if (arg === "--timeout-ms" || arg === "--timeout") {
+      const raw = args[i + 1];
+      i += 1;
+      timeoutMs = Number(raw);
+      if (!Number.isInteger(timeoutMs) || timeoutMs < 1e3 || timeoutMs > INBOX_WAIT_MAX_MS)
+        return waitUsage(deps, globals, `--timeout-ms must be an integer between 1000 and ${INBOX_WAIT_MAX_MS}`);
+    } else if (arg === "--user-id") {
+      userId = args[i + 1];
+      i += 1;
+      if (!userId) return waitUsage(deps, globals, "--user-id needs a value");
+    } else {
+      return waitUsage(deps, globals, `unknown flag: ${arg}`);
+    }
+  }
+  const apiUrl = globals.apiUrl ?? deps.env.MOSSE_API_URL?.trim() ?? config2.apiUrl ?? DEFAULT_API_URL;
+  const token = globals.token ?? deps.env.MOSSE_TOKEN?.trim() ?? hostConfigOf(config2, apiUrl).token;
+  if (!token) {
+    deps.stderr(structuredError(globals, EXIT_AUTH, "unauthenticated", "run `mosse auth login` (or set MOSSE_TOKEN)"));
+    return EXIT_AUTH;
+  }
+  let workspaceId = globals.workspace?.trim() || deps.env.MOSSE_WORKSPACE?.trim() || void 0;
+  if (!userId || !workspaceId) {
+    const listed = await callApi({ fetchImpl: deps.fetch, apiUrl, method: "GET", path: "/api/me/workspaces", token });
+    if (!listed.ok) {
+      const exit = exitCodeForStatus(listed.status);
+      deps.stderr(structuredError(globals, exit, listed.error, withHttpHint(listed.message)));
+      return exit;
+    }
+    const body = listed.body;
+    userId = userId ?? body.userId;
+    if (!userId) {
+      deps.stderr(structuredError(globals, 1, "internal", "token lookup returned no userId"));
+      return 1;
+    }
+    const workspaces = body.workspaces ?? [];
+    if (!workspaceId) {
+      if (workspaces.length === 1) workspaceId = workspaces[0].id;
+      else if (workspaces.length === 0) {
+        deps.stderr(structuredError(globals, EXIT_AUTH, "no_workspace", "this token cannot use any workspace"));
+        return EXIT_AUTH;
+      } else {
+        const list = workspaces.map((workspace) => `${workspace.id} (${workspace.name})`).join(", ");
+        deps.stderr(
+          structuredError(
+            globals,
+            EXIT_USAGE,
+            "workspace_required",
+            `this token covers several workspaces; pass --workspace. Available: ${list}`
+          )
+        );
+        return EXIT_USAGE;
+      }
+    }
+  }
+  const result = await callApi({
+    fetchImpl: deps.fetch,
+    apiUrl,
+    method: "GET",
+    path: `/api/inbox/wait?timeoutMs=${timeoutMs}`,
+    token,
+    ...workspaceId ? { workspaceId } : {}
+  });
+  if (!result.ok) {
+    const exit = exitCodeForStatus(result.status);
+    deps.stderr(structuredError(globals, exit, result.error, withHttpHint(result.message)));
+    return exit;
+  }
+  const status = result.body.status;
+  if (globals.json !== void 0) deps.stdout(renderOutput(result.body, outputOptions(globals)));
+  else deps.stdout(status === "notification" ? "notification" : "timeout");
+  if (status === "timeout") {
+    deps.stderr("inbox wait timed out (no notification)");
+    return EXIT_NOT_FOUND;
+  }
+  return 0;
+}
+function waitUsage(deps, globals, message) {
+  deps.stderr(structuredError(globals, EXIT_USAGE, "usage", message));
+  return EXIT_USAGE;
+}
+function workspaceHelp(tree) {
+  const whoami2 = tree.byPath.get("auth whoami");
+  return [
+    "mosse workspace \u2014 workspaces available to this token",
+    "",
+    "  mosse workspace list [--json]    list workspaces (alias of `mosse auth whoami`)",
+    "",
+    whoami2 ? whoami2.help.trim() : "",
+    ""
+  ].join("\n");
+}
+async function handleCompletions(args, deps, tree, globals) {
+  const shell = args[0];
+  if (!shell || shell === "--help" || shell === "-h") {
+    deps.stdout(
+      [
+        "mosse completions <shell>",
+        "",
+        "\u6253\u5370 shell \u8865\u5168\u811A\u672C(\u547D\u4EE4\u8BCD\u8868\u4E0E help / skill \u540C\u6E90)\u3002",
+        "",
+        `Shells: ${COMPLETION_SHELLS.join(", ")}`,
+        "",
+        "  # zsh",
+        '  mosse completions zsh > "${fpath[1]}/_mosse"',
+        "  # bash",
+        "  mosse completions bash > /etc/bash_completion.d/mosse",
+        "  # fish",
+        "  mosse completions fish > ~/.config/fish/completions/mosse.fish",
+        ""
+      ].join("\n")
+    );
+    return 0;
+  }
+  if (!COMPLETION_SHELLS.includes(shell)) {
+    deps.stderr(
+      structuredError(
+        globals,
+        EXIT_USAGE,
+        "usage",
+        `unknown shell: ${shell} (expected ${COMPLETION_SHELLS.join("|")})`
+      )
+    );
+    return EXIT_USAGE;
+  }
+  deps.stdout(renderCompletions(tree, shell));
+  return 0;
+}
 async function handleSkill(tokens, deps, configPath, _config, tree, globals) {
   const flagValue = (name) => {
     for (let i = 0; i < tokens.length; i += 1) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mosse-ai/cli",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "type": "module",
   "bin": {
     "mosse": "./dist/index.js"