@pmate/cli 0.28.1 → 0.28.3

package/dist/index.d.ts

@@ -32,8 +32,19 @@ declare enum Command {
     App = "app",
     Service = "service",
     Vercel = "vercel",
+    Host = "host",
     Quiz = "quiz"
 }
+type HostCommandArgs = {
+    type: Command.Host;
+    action: "env-list" | "env-set" | "env-unset" | "apply";
+    host?: string;
+    key?: string;
+    value?: string;
+    secret?: boolean;
+    baseUrl?: string;
+    json: boolean;
+};
 type NoneCommandArgs = {
     type: Command.None;
 };
@@ -1163,7 +1174,7 @@ type VercelDeploysCommandArgs = {
     lastWeek: boolean;
 };
 type VercelCommandArgs = VercelProjectsCommandArgs | VercelDeploysCommandArgs;
-type CommandArgs = NoneCommandArgs | ListCommandArgs | LoginCommandArgs | AddDnsCommandArgs | StsCommandArgs | BucketCommandArgs | DeployCommandArgs | LogCommandArgs | InitCommandArgs | DeleteCommandArgs | DevCommandArgs | EnvCommandArgs | PrCommandArgs | CommitCommandArgs | SummaryCommandArgs | QuizCommandArgs | ServiceCommandArgs | LinearCommandArgs | NotionCommandArgs | OssCommandArgs | QrcodeCommandArgs | RandomCommandArgs | CollectCommandArgs | ChatRoomCommandArgs | AgentCommandArgs | RunnerCommandArgs | NsCommandArgs | RoleCommandArgs | AccountCommandArgs | OrgCommandArgs | StoreCommandArgs | AppCommandArgs | VercelCommandArgs;
+type CommandArgs = NoneCommandArgs | ListCommandArgs | LoginCommandArgs | AddDnsCommandArgs | StsCommandArgs | BucketCommandArgs | DeployCommandArgs | LogCommandArgs | InitCommandArgs | DeleteCommandArgs | DevCommandArgs | EnvCommandArgs | PrCommandArgs | CommitCommandArgs | SummaryCommandArgs | QuizCommandArgs | ServiceCommandArgs | LinearCommandArgs | NotionCommandArgs | OssCommandArgs | QrcodeCommandArgs | RandomCommandArgs | CollectCommandArgs | ChatRoomCommandArgs | AgentCommandArgs | RunnerCommandArgs | NsCommandArgs | RoleCommandArgs | AccountCommandArgs | OrgCommandArgs | StoreCommandArgs | AppCommandArgs | VercelCommandArgs | HostCommandArgs;
 
 interface ParsedArgs {
     help: boolean;

package/dist/index.js

@@ -10288,8 +10288,8 @@ __export(index_exports, {
   parseCommandArgs: () => parseCommandArgs
 });
 module.exports = __toCommonJS(index_exports);
-var import_node_fs25 = require("fs");
-var import_node_path30 = __toESM(require("path"));
+var import_node_fs26 = require("fs");
+var import_node_path31 = __toESM(require("path"));
 var import_chalk4 = __toESM(require("chalk"));
 
 // src/cli.ts
@@ -15708,9 +15708,9 @@ ${indent}\`\`\``;
   static richTextToPlain(richText) {
     return richText.map((item) => item.plain_text ?? item.text?.content ?? "").join("").trim();
   }
-  static async requestJson(path31, init) {
+  static async requestJson(path32, init) {
     const token = this.getToken();
-    const response = await fetch(`${this.baseUrl}${path31}`, {
+    const response = await fetch(`${this.baseUrl}${path32}`, {
       method: init.method,
       headers: {
         Authorization: `Bearer ${token}`,
@@ -18254,8 +18254,8 @@ function descriptorPathSegments(descriptor) {
   return ["chains", normalized.chain, "namespaces", normalized.ns, normalized.kind, normalized.name];
 }
 function buildPathUrl(baseUrl, pathSegments, query) {
-  const path31 = `/${pathSegments.map((segment) => encodeURIComponent(segment)).join("/")}`;
-  const url = new URL(path31, baseUrl);
+  const path32 = `/${pathSegments.map((segment) => encodeURIComponent(segment)).join("/")}`;
+  const url = new URL(path32, baseUrl);
   if (query) {
     for (const [key, value] of Object.entries(query)) {
       url.searchParams.set(key, String(value));
@@ -20351,6 +20351,33 @@ var ServiceRegistryClient = class {
   constructor(baseUrl) {
     this.baseUrl = baseUrl;
   }
+  async listHostEnv(hostId) {
+    const payload = await this.request(
+      "GET",
+      `/hosts/${encodeURIComponent(hostId)}/env-vars`
+    );
+    return payload.items;
+  }
+  async setHostEnv(hostId, key, value, kind) {
+    const payload = await this.requestWithBody(
+      "PUT",
+      `/hosts/${encodeURIComponent(hostId)}/env-vars/${encodeURIComponent(key)}`,
+      { value, kind }
+    );
+    return payload.item;
+  }
+  async deleteHostEnv(hostId, key) {
+    return this.request(
+      "DELETE",
+      `/hosts/${encodeURIComponent(hostId)}/env-vars/${encodeURIComponent(key)}`
+    );
+  }
+  async resolveHostEnv(hostId) {
+    return this.request(
+      "GET",
+      `/hosts/${encodeURIComponent(hostId)}/env-vars/resolve`
+    );
+  }
   async listServices(filters) {
     const searchParams = new URLSearchParams();
     const repository = normalizeRepository(filters?.repository);
@@ -21685,9 +21712,9 @@ var ServiceRuntimeRunner = class {
     return tokens;
   }
   readPathValue(source, pathExpr) {
-    const path31 = pathExpr.split(".").map((segment) => segment.trim()).filter(Boolean);
+    const path32 = pathExpr.split(".").map((segment) => segment.trim()).filter(Boolean);
     let cursor = source;
-    for (const segment of path31) {
+    for (const segment of path32) {
       if (!cursor || typeof cursor !== "object" || Array.isArray(cursor)) {
         return void 0;
       }
@@ -24356,6 +24383,125 @@ function encodePathSegment3(value) {
   return value.split("/").map((segment) => encodeURIComponent(segment)).join("/");
 }
 
+// src/commands/HostCommandHandler.ts
+var import_node_fs25 = require("fs");
+var import_node_os11 = require("os");
+var import_node_path30 = __toESM(require("path"));
+var import_node_child_process13 = require("child_process");
+var BLOCK_START = "# >>> pmate host env >>>";
+var BLOCK_END = "# <<< pmate host env <<<";
+var PROFILE_BLOCK = `${BLOCK_START}
+if [ -f "$HOME/.pmate/host/host.env" ]; then
+  set -a
+  . "$HOME/.pmate/host/host.env"
+  set +a
+fi
+${BLOCK_END}`;
+var HostCommandHandler = class {
+  async handle(args) {
+    const hostId = normalizeHostId(args.host ?? process.env.PMATE_HOST_ID ?? (0, import_node_os11.hostname)());
+    const client = new ServiceRegistryClient(args.baseUrl);
+    if (args.action === "env-list") {
+      const items = await client.listHostEnv(hostId);
+      if (args.json) ui.plain(JSON.stringify({ hostId, items }, null, 2));
+      else for (const item of items) ui.plain(`${item.key}	${item.kind}	${item.value}`);
+      return;
+    }
+    if (args.action === "env-set") {
+      const item = await client.setHostEnv(hostId, requireArg(args.key, "key"), requireArg(args.value, "value"), args.secret ? "secret" : "plain");
+      if (args.json) ui.plain(JSON.stringify({ hostId, item }, null, 2));
+      else ui.success(`Set host env ${item.key}`, hostId);
+      return;
+    }
+    if (args.action === "env-unset") {
+      const result2 = await client.deleteHostEnv(hostId, requireArg(args.key, "key"));
+      if (args.json) ui.plain(JSON.stringify(result2, null, 2));
+      else ui.success(`Unset host env ${result2.key}`, hostId);
+      return;
+    }
+    const resolved = await client.resolveHostEnv(hostId);
+    const result = await applyHostEnvRemote(hostId, resolved.values);
+    if (args.json) ui.plain(JSON.stringify({ hostId, ...result }, null, 2));
+    else ui.success(`Applied ${Object.keys(resolved.values).length} host env vars`, result.envFile);
+  }
+};
+async function applyHostEnvRemote(host, values) {
+  const target = `pmate@${normalizeHostId(host)}`;
+  const content = serializeHostEnv(values);
+  const script = buildRemoteApplyScript(Buffer.from(content, "utf8").toString("base64"));
+  await new Promise((resolve, reject) => {
+    const child = (0, import_node_child_process13.spawn)("ssh", [target, "bash -s"], { stdio: ["pipe", "pipe", "pipe"] });
+    let stdout = "";
+    let stderr = "";
+    child.stdout.on("data", (chunk) => {
+      stdout += chunk.toString();
+    });
+    child.stderr.on("data", (chunk) => {
+      stderr += chunk.toString();
+    });
+    child.on("error", reject);
+    child.on("close", (code) => {
+      if (code === 0) resolve();
+      else reject(new Error(`ssh to ${host} failed${stderr.trim() ? `: ${stderr.trim()}` : ` with code ${code}`}
+${stdout.trim()}`.trim()));
+    });
+    child.stdin.end(script);
+  });
+  return {
+    envFile: "~/.pmate/host/host.env",
+    profileFile: "~/.profile",
+    refreshed: true
+  };
+}
+function buildRemoteApplyScript(contentBase64) {
+  return `set -euo pipefail
+host_dir="$HOME/.pmate/host"
+env_file="$host_dir/host.env"
+profile_file="$HOME/.profile"
+mkdir -p "$host_dir"
+env_tmp="$(mktemp "$host_dir/.host.env.XXXXXX")"
+profile_tmp=""
+cleanup() { rm -f "$env_tmp"; [ -z "$profile_tmp" ] || rm -f "$profile_tmp"; }
+trap cleanup EXIT
+printf '%s' '${contentBase64}' | base64 --decode > "$env_tmp"
+chmod 600 "$env_tmp"
+mv "$env_tmp" "$env_file"
+touch "$profile_file"
+profile_tmp="$(mktemp "$HOME/.profile.XXXXXX")"
+awk '
+  $0 == "${BLOCK_START}" { managed = 1; next }
+  $0 == "${BLOCK_END}" { managed = 0; next }
+  !managed { print }
+' "$profile_file" > "$profile_tmp"
+while [ -s "$profile_tmp" ] && [ "$(tail -c 1 "$profile_tmp" | wc -l)" -eq 0 ]; do printf '\\n' >> "$profile_tmp"; done
+cat >> "$profile_tmp" <<'PMATE_PROFILE_BLOCK'
+${PROFILE_BLOCK}
+PMATE_PROFILE_BLOCK
+mv "$profile_tmp" "$profile_file"
+bash -lc '. "$HOME/.profile"'
+printf 'applied %s\\n' "$env_file"
+`;
+}
+function serializeHostEnv(values) {
+  return Object.entries(values).sort(([a], [b]) => a.localeCompare(b)).map(([key, value]) => `${normalizeEnvKey(key)}=${shellQuote3(value)}`).join("\n") + "\n";
+}
+function normalizeHostId(value) {
+  const normalized = value.trim();
+  if (!/^[A-Za-z0-9._-]+$/.test(normalized)) throw new Error("Invalid host id");
+  return normalized;
+}
+function normalizeEnvKey(value) {
+  if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(value)) throw new Error(`Invalid env key: ${value}`);
+  return value;
+}
+function shellQuote3(value) {
+  return `'${value.replace(/'/g, `'"'"'`)}'`;
+}
+function requireArg(value, name) {
+  if (value === void 0) throw new Error(`Missing ${name}`);
+  return value;
+}
+
 // src/agentCommandParser.ts
 init_namespacedRef();
 var DEFAULT_AGENT_NAMESPACE = "pmate";
@@ -27342,6 +27488,47 @@ function requireValue9(tokens, optionName) {
   return value;
 }
 
+// src/hostCommandParser.ts
+function parseHostArgs(tokens) {
+  const rest = [...tokens];
+  const first = rest.shift();
+  let action;
+  let key;
+  let value;
+  if (first === "apply") action = "apply";
+  else if (first === "env") {
+    const envAction = rest.shift();
+    if (envAction === "list") action = "env-list";
+    else if (envAction === "set") {
+      action = "env-set";
+      key = requireValue10(rest, "key");
+      value = requireValue10(rest, "value");
+    } else if (envAction === "unset") {
+      action = "env-unset";
+      key = requireValue10(rest, "key");
+    } else throw new Error("Usage: host env list|set|unset ... | host apply");
+  } else throw new Error("Usage: host env list|set|unset ... | host apply");
+  let host;
+  let secret = false;
+  let baseUrl;
+  let json = false;
+  while (rest.length > 0) {
+    const token = rest.shift();
+    if (token === "--host") host = requireValue10(rest, token);
+    else if (token === "--secret") secret = true;
+    else if (token === "--base-url") baseUrl = requireValue10(rest, token);
+    else if (token === "--json") json = true;
+    else throw new Error(`Unknown host option: ${token}`);
+  }
+  if (secret && action !== "env-set") throw new Error("--secret is only valid for host env set");
+  return { type: "host" /* Host */, action, host, key, value, secret, baseUrl, json };
+}
+function requireValue10(tokens, label) {
+  const value = tokens.shift();
+  if (!value || value.startsWith("--")) throw new Error(`Missing value for ${label}`);
+  return value;
+}
+
 // src/collectCommandParser.ts
 function parseCollectArgs(tokens) {
   const rest = [...tokens];
@@ -27361,7 +27548,7 @@ function parseCollectArgs(tokens) {
     const token = rest.shift();
     switch (token) {
       case "--source": {
-        const value = requireValue10(rest, token);
+        const value = requireValue11(rest, token);
         if (value !== "cc" && value !== "yelling") {
           throw new Error(`Unsupported collect source: ${value}`);
         }
@@ -27369,11 +27556,11 @@ function parseCollectArgs(tokens) {
         break;
       }
       case "--endpoint":
-        options.endpoint = requireValue10(rest, token);
+        options.endpoint = requireValue11(rest, token);
         break;
       case "--thread":
       case "--channel":
-        options.thread = requireValue10(rest, token);
+        options.thread = requireValue11(rest, token);
         break;
       default:
         throw new Error(`Unknown collect option: ${token}`);
@@ -27389,7 +27576,7 @@ function parseCollectArgs(tokens) {
   }
   return { type: "collect" /* Collect */, ...options };
 }
-function requireValue10(tokens, optionName) {
+function requireValue11(tokens, optionName) {
   const value = tokens.shift();
   if (!value) {
     throw new Error(`Missing value for ${optionName}`);
@@ -27447,13 +27634,13 @@ function parseIm1ThreadsArgs(tokens) {
     switch (token) {
       case "--q":
       case "--query":
-        query = requireValue11(rest, token);
+        query = requireValue12(rest, token);
         break;
       case "--search":
-        search = requireValue11(rest, token);
+        search = requireValue12(rest, token);
         break;
       case "--limit":
-        limit = parsePositiveInt2(requireValue11(rest, token), token);
+        limit = parsePositiveInt2(requireValue12(rest, token), token);
         break;
       case "--json":
         json = true;
@@ -27477,10 +27664,10 @@ function parseIm1MessagesArgs(tokens) {
     switch (token) {
       case "--thread":
       case "--channel":
-        thread = requireValue11(rest, token);
+        thread = requireValue12(rest, token);
         break;
       case "--limit":
-        limit = parsePositiveInt2(requireValue11(rest, token), token);
+        limit = parsePositiveInt2(requireValue12(rest, token), token);
         break;
       case "--json":
         json = true;
@@ -27507,14 +27694,14 @@ function parseIm1ReplyArgs(tokens) {
     const token = rest.shift();
     switch (token) {
       case "--thread":
-        thread = requireValue11(rest, token);
+        thread = requireValue12(rest, token);
         break;
       case "--text":
-        text = requireValue11(rest, token);
+        text = requireValue12(rest, token);
         break;
       case "--file":
       case "--image":
-        file = requireValue11(rest, token);
+        file = requireValue12(rest, token);
         break;
       case "--dryrun":
       case "--dry-run":
@@ -27547,13 +27734,13 @@ function parseIm1ReactArgs(tokens) {
     const token = rest.shift();
     switch (token) {
       case "--thread":
-        thread = requireValue11(rest, token);
+        thread = requireValue12(rest, token);
         break;
       case "--emoji":
-        emoji = requireValue11(rest, token);
+        emoji = requireValue12(rest, token);
         break;
       case "--message":
-        message = requireValue11(rest, token);
+        message = requireValue12(rest, token);
         break;
       case "--remove":
         remove = true;
@@ -27571,7 +27758,7 @@ function parseIm1ReactArgs(tokens) {
   }
   return { type: "collect" /* Collect */, action: "react", thread, emoji, message, remove, dryRun };
 }
-function requireValue11(tokens, optionName) {
+function requireValue12(tokens, optionName) {
   const value = tokens.shift();
   if (!value || value.startsWith("--")) {
     throw new Error(`Missing value for ${optionName}`);
@@ -27685,12 +27872,12 @@ function parseShared(tokens) {
       case "--title":
       case "--bot-a":
       case "--bot-b":
-        options.set(token, requireValue12(tokens, token));
+        options.set(token, requireValue13(tokens, token));
         break;
       case "--member":
       case "--recipient": {
         const values = multiOptions.get(token) ?? [];
-        values.push(requireValue12(tokens, token));
+        values.push(requireValue13(tokens, token));
         multiOptions.set(token, values);
         break;
       }
@@ -27716,7 +27903,7 @@ function requiredOption(options, option) {
   }
   return value;
 }
-function requireValue12(tokens, option) {
+function requireValue13(tokens, option) {
   const value = tokens.shift();
   if (!value || value.startsWith("--")) {
     throw new Error(`Missing value for ${option}`);
@@ -27726,7 +27913,7 @@ function requireValue12(tokens, option) {
 
 // src/index.ts
 var pkg = JSON.parse(
-  (0, import_node_fs25.readFileSync)(import_node_path30.default.resolve(__dirname, "..", "package.json"), "utf8")
+  (0, import_node_fs26.readFileSync)(import_node_path31.default.resolve(__dirname, "..", "package.json"), "utf8")
 );
 var HELP_TEXT = [
   import_chalk4.default.bold(`pmate v${pkg.version}`),
@@ -27920,6 +28107,11 @@ var HELP_TEXT = [
   `  ${import_chalk4.default.gray("                  ssl refresh <ns:objectId> [--cert <key>] [--dry-run] [--base-url <url>] [--json]")}`,
   `  ${import_chalk4.default.gray("                  log <ns:objectId> [--page <n>] [--history] [--search <keyword>] [--follow|-f] [--base-url <url>]")}`,
   `  ${import_chalk4.default.gray("                  default base URL: https://apps-api.pmate.chat")}`,
+  `  ${import_chalk4.default.cyan("host")}             Manage host-level environment variables`,
+  `  ${import_chalk4.default.gray("                  env list [--host <id>] [--json]")}`,
+  `  ${import_chalk4.default.gray("                  env set <key> <value> [--host <id>] [--secret]")}`,
+  `  ${import_chalk4.default.gray("                  env unset <key> [--host <id>]")}`,
+  `  ${import_chalk4.default.gray("                  apply [--host <id>] [--json]")}`,
   `  ${import_chalk4.default.cyan("vercel")}           Wrap common Vercel CLI inspection commands`,
   `  ${import_chalk4.default.gray("                  projects [--scope <scope>]")}`,
   `  ${import_chalk4.default.gray("                  deploys --project <name> [--last-week] [--scope <scope>]")}`
@@ -27985,10 +28177,10 @@ function parseCommandArgs(args) {
       const token = rest.shift();
       switch (token) {
         case "--app":
-          app = requireValue13(rest, token);
+          app = requireValue14(rest, token);
           break;
         case "--profile-id":
-          profileId = requireValue13(rest, token);
+          profileId = requireValue14(rest, token);
           break;
         case "--access-key":
           if (rest[0] && !rest[0].startsWith("--")) {
@@ -27998,7 +28190,7 @@ function parseCommandArgs(args) {
           }
           break;
         case "--access-key-file":
-          accessKeyFile = requireValue13(rest, token);
+          accessKeyFile = requireValue14(rest, token);
           break;
         case "--select-profile":
           selectProfile = true;
@@ -28099,6 +28291,9 @@ function parseCommandArgs(args) {
   if (args.rest[0] === "service") {
     return parseServiceArgs(args.rest.slice(1));
   }
+  if (args.rest[0] === "host") {
+    return parseHostArgs(args.rest.slice(1));
+  }
   if (args.rest[0] === "vercel") {
     return parseVercelArgs(args.rest.slice(1));
   }
@@ -28116,7 +28311,7 @@ function parseVercelArgs(tokens) {
       const token = rest.shift();
       switch (token) {
         case "--scope":
-          scope = requireValue13(rest, token);
+          scope = requireValue14(rest, token);
           break;
         default:
           throw new Error(`Unknown vercel option: ${token}`);
@@ -28136,10 +28331,10 @@ function parseVercelArgs(tokens) {
       const token = rest.shift();
       switch (token) {
         case "--scope":
-          scope = requireValue13(rest, token);
+          scope = requireValue14(rest, token);
           break;
         case "--project":
-          project = requireValue13(rest, token);
+          project = requireValue14(rest, token);
           break;
         case "--last-week":
           lastWeek = true;
@@ -28170,16 +28365,16 @@ function parseAddDnsArgs(tokens) {
     const token = rest.shift();
     switch (token) {
       case "--type":
-        options.dnsType = requireValue13(rest, token);
+        options.dnsType = requireValue14(rest, token);
         break;
       case "--value":
-        options.dnsValue = requireValue13(rest, token);
+        options.dnsValue = requireValue14(rest, token);
         break;
       case "--rr":
-        options.dnsRr = requireValue13(rest, token);
+        options.dnsRr = requireValue14(rest, token);
         break;
       case "--ttl": {
-        const ttlValue = requireValue13(rest, token);
+        const ttlValue = requireValue14(rest, token);
         const ttl = Number.parseInt(ttlValue, 10);
         if (!Number.isFinite(ttl) || ttl <= 0) {
           throw new Error(`Invalid --ttl value: ${ttlValue}`);
@@ -28188,7 +28383,7 @@ function parseAddDnsArgs(tokens) {
         break;
       }
       case "--domain":
-        options.dnsDomain = requireValue13(rest, token);
+        options.dnsDomain = requireValue14(rest, token);
         break;
       default:
         throw new Error(`Unknown add-dns option: ${token}`);
@@ -28221,13 +28416,13 @@ function parseBucketArgs(tokens) {
         options.bucketCreate = true;
         break;
       case "--name":
-        options.bucketName = requireValue13(rest, token);
+        options.bucketName = requireValue14(rest, token);
         break;
       case "--subdomain":
-        options.bucketSubdomain = requireValue13(rest, token);
+        options.bucketSubdomain = requireValue14(rest, token);
         break;
       case "--domain":
-        options.bucketDomain = requireValue13(rest, token);
+        options.bucketDomain = requireValue14(rest, token);
         break;
       default:
         throw new Error(`Unknown bucket option: ${token}`);
@@ -28259,7 +28454,7 @@ function parseDevArgs(tokens) {
     const token = rest.shift();
     switch (token) {
       case "--cwd":
-        options.devCwd = requireValue13(rest, token);
+        options.devCwd = requireValue14(rest, token);
         break;
       default:
         throw new Error(`Unknown dev option: ${token}`);
@@ -28279,7 +28474,7 @@ function parseDeleteArgs(tokens) {
     const token = rest.shift();
     switch (token) {
       case "--cwd":
-        deleteCwd = requireValue13(rest, token);
+        deleteCwd = requireValue14(rest, token);
         break;
       default:
         throw new Error(`Unknown delete option: ${token}`);
@@ -28313,13 +28508,13 @@ function parseOssArgs(tokens) {
     const token = rest.shift();
     switch (token) {
       case "--bucket":
-        bucket = requireValue13(rest, token);
+        bucket = requireValue14(rest, token);
         break;
       case "--file":
-        filePath = requireValue13(rest, token);
+        filePath = requireValue14(rest, token);
         break;
       case "--key":
-        objectKey = requireValue13(rest, token);
+        objectKey = requireValue14(rest, token);
         break;
       default:
         throw new Error(`Unknown oss option: ${token}`);
@@ -28352,7 +28547,7 @@ function parseEnvArgs(tokens) {
           throw new Error("Only one env action is allowed.");
         }
         action = "set";
-        key = requireValue13(rest, token);
+        key = requireValue14(rest, token);
         break;
       case "--list":
         if (action) {
@@ -28365,17 +28560,17 @@ function parseEnvArgs(tokens) {
           throw new Error("Only one env action is allowed.");
         }
         action = "delete";
-        key = requireValue13(rest, token);
+        key = requireValue14(rest, token);
         break;
       case "--value":
-        value = requireValue13(rest, token);
+        value = requireValue14(rest, token);
         break;
       case "--verbose":
       case "-v":
         verbose = true;
         break;
       case "--cwd":
-        cwd = requireValue13(rest, token);
+        cwd = requireValue14(rest, token);
         break;
       default:
         throw new Error(`Unknown env option: ${token}`);
@@ -28433,7 +28628,7 @@ function parseCommitArgs(tokens) {
         push = true;
         break;
       case "--cwd":
-        cwd = requireValue13(rest, token);
+        cwd = requireValue14(rest, token);
         break;
       default:
         throw new Error(`Unknown commit option: ${token}`);
@@ -28449,10 +28644,10 @@ function parseSummaryArgs(tokens) {
     const token = rest.shift();
     switch (token) {
       case "--pr":
-        prRef = requireValue13(rest, token);
+        prRef = requireValue14(rest, token);
         break;
       case "--cwd":
-        cwd = requireValue13(rest, token);
+        cwd = requireValue14(rest, token);
         break;
       default:
         throw new Error(`Unknown summary option: ${token}`);
@@ -28477,13 +28672,13 @@ function parseQuizArgs(tokens) {
       const token = rest.shift();
       switch (token) {
         case "--paper-id":
-          paperId = requireValue13(rest, token);
+          paperId = requireValue14(rest, token);
           break;
         case "--base-url":
-          apiBaseUrl = requireValue13(rest, token);
+          apiBaseUrl = requireValue14(rest, token);
           break;
         case "--link-base":
-          linkBaseUrl = requireValue13(rest, token);
+          linkBaseUrl = requireValue14(rest, token);
           break;
         default:
           throw new Error(`Unknown quiz create-draft option: ${token}`);
@@ -28509,16 +28704,16 @@ function parseQuizArgs(tokens) {
       const token = rest.shift();
       switch (token) {
         case "--paper-id":
-          paperId = requireValue13(rest, token);
+          paperId = requireValue14(rest, token);
           break;
         case "--file":
-          filePath = requireValue13(rest, token);
+          filePath = requireValue14(rest, token);
           break;
         case "--base-url":
-          apiBaseUrl = requireValue13(rest, token);
+          apiBaseUrl = requireValue14(rest, token);
           break;
         case "--link-base":
-          linkBaseUrl = requireValue13(rest, token);
+          linkBaseUrl = requireValue14(rest, token);
           break;
         default:
           throw new Error(`Unknown quiz update-meta option: ${token}`);
@@ -28548,16 +28743,16 @@ function parseQuizArgs(tokens) {
       const token = rest.shift();
       switch (token) {
         case "--paper-id":
-          paperId = requireValue13(rest, token);
+          paperId = requireValue14(rest, token);
           break;
         case "--file":
-          filePath = requireValue13(rest, token);
+          filePath = requireValue14(rest, token);
           break;
         case "--base-url":
-          apiBaseUrl = requireValue13(rest, token);
+          apiBaseUrl = requireValue14(rest, token);
           break;
         case "--link-base":
-          linkBaseUrl = requireValue13(rest, token);
+          linkBaseUrl = requireValue14(rest, token);
           break;
         default:
           throw new Error(`Unknown quiz append-step option: ${token}`);
@@ -28588,19 +28783,19 @@ function parseQuizArgs(tokens) {
       const token = rest.shift();
       switch (token) {
         case "--paper-id":
-          paperId = requireValue13(rest, token);
+          paperId = requireValue14(rest, token);
           break;
         case "--step-id":
-          stepId = requireValue13(rest, token);
+          stepId = requireValue14(rest, token);
           break;
         case "--file":
-          filePath = requireValue13(rest, token);
+          filePath = requireValue14(rest, token);
           break;
         case "--base-url":
-          apiBaseUrl = requireValue13(rest, token);
+          apiBaseUrl = requireValue14(rest, token);
           break;
         case "--link-base":
-          linkBaseUrl = requireValue13(rest, token);
+          linkBaseUrl = requireValue14(rest, token);
           break;
         default:
           throw new Error(`Unknown quiz update-step option: ${token}`);
@@ -28634,16 +28829,16 @@ function parseQuizArgs(tokens) {
       const token = rest.shift();
       switch (token) {
         case "--paper-id":
-          paperId = requireValue13(rest, token);
+          paperId = requireValue14(rest, token);
           break;
         case "--step-ids":
-          stepIdsRaw = requireValue13(rest, token);
+          stepIdsRaw = requireValue14(rest, token);
           break;
         case "--base-url":
-          apiBaseUrl = requireValue13(rest, token);
+          apiBaseUrl = requireValue14(rest, token);
           break;
         case "--link-base":
-          linkBaseUrl = requireValue13(rest, token);
+          linkBaseUrl = requireValue14(rest, token);
           break;
         default:
           throw new Error(`Unknown quiz reorder option: ${token}`);
@@ -28677,16 +28872,16 @@ function parseQuizArgs(tokens) {
       const token = rest.shift();
       switch (token) {
         case "--paper-id":
-          paperId = requireValue13(rest, token);
+          paperId = requireValue14(rest, token);
           break;
         case "--step-id":
-          stepId = requireValue13(rest, token);
+          stepId = requireValue14(rest, token);
           break;
         case "--base-url":
-          apiBaseUrl = requireValue13(rest, token);
+          apiBaseUrl = requireValue14(rest, token);
           break;
         case "--link-base":
-          linkBaseUrl = requireValue13(rest, token);
+          linkBaseUrl = requireValue14(rest, token);
           break;
         default:
           throw new Error(`Unknown quiz delete-step option: ${token}`);
@@ -28715,13 +28910,13 @@ function parseQuizArgs(tokens) {
       const token = rest.shift();
       switch (token) {
         case "--paper-id":
-          paperId = requireValue13(rest, token);
+          paperId = requireValue14(rest, token);
           break;
         case "--base-url":
-          apiBaseUrl = requireValue13(rest, token);
+          apiBaseUrl = requireValue14(rest, token);
           break;
         case "--link-base":
-          linkBaseUrl = requireValue13(rest, token);
+          linkBaseUrl = requireValue14(rest, token);
           break;
         default:
           throw new Error(`Unknown quiz activate option: ${token}`);
@@ -28746,13 +28941,13 @@ function parseQuizArgs(tokens) {
       const token = rest.shift();
       switch (token) {
         case "--paper-id":
-          paperId = requireValue13(rest, token);
+          paperId = requireValue14(rest, token);
           break;
         case "--base-url":
-          apiBaseUrl = requireValue13(rest, token);
+          apiBaseUrl = requireValue14(rest, token);
           break;
         case "--link-base":
-          linkBaseUrl = requireValue13(rest, token);
+          linkBaseUrl = requireValue14(rest, token);
           break;
         default:
           throw new Error(`Unknown quiz view option: ${token}`);
@@ -28781,22 +28976,22 @@ function parseQuizArgs(tokens) {
       const token = rest.shift();
       switch (token) {
         case "--paper-id":
-          paperId = requireValue13(rest, token);
+          paperId = requireValue14(rest, token);
           break;
         case "--step-id":
-          stepId = requireValue13(rest, token);
+          stepId = requireValue14(rest, token);
           break;
         case "--file":
-          filePath = requireValue13(rest, token);
+          filePath = requireValue14(rest, token);
           break;
         case "--new-paper-id":
-          newPaperId = requireValue13(rest, token);
+          newPaperId = requireValue14(rest, token);
           break;
         case "--base-url":
-          apiBaseUrl = requireValue13(rest, token);
+          apiBaseUrl = requireValue14(rest, token);
           break;
         case "--link-base":
-          linkBaseUrl = requireValue13(rest, token);
+          linkBaseUrl = requireValue14(rest, token);
           break;
         case "--activate":
           activate = true;
@@ -28886,10 +29081,10 @@ function parseLinearPrArgs(tokens) {
     const token = rest.shift();
     switch (token) {
       case "--account":
-        account = requireValue13(rest, token);
+        account = requireValue14(rest, token);
         break;
       case "--cwd":
-        cwd = requireValue13(rest, token);
+        cwd = requireValue14(rest, token);
         break;
       default:
         throw new Error(`Unknown linear option: ${token}`);
@@ -28918,35 +29113,35 @@ function parseLinearCreateArgs(tokens) {
     const token = rest.shift();
     switch (token) {
       case "--account":
-        account = requireValue13(rest, token);
+        account = requireValue14(rest, token);
         break;
       case "--repl":
         useRepl = true;
         break;
       case "--title":
-        title = requireValue13(rest, token);
+        title = requireValue14(rest, token);
         break;
       case "--desc":
       case "--description":
-        description = decodeEscapedNewlines(requireValue13(rest, token));
+        description = decodeEscapedNewlines(requireValue14(rest, token));
         break;
       case "--team-id":
-        teamId = requireValue13(rest, token);
+        teamId = requireValue14(rest, token);
         break;
       case "--team-key":
-        teamKey = requireValue13(rest, token);
+        teamKey = requireValue14(rest, token);
         break;
       case "--priority":
-        priority = parseLinearPriority(requireValue13(rest, token));
+        priority = parseLinearPriority(requireValue14(rest, token));
         break;
       case "--parent-id":
-        parentId = requireValue13(rest, token);
+        parentId = requireValue14(rest, token);
         break;
       case "--state-id":
-        stateId = requireValue13(rest, token);
+        stateId = requireValue14(rest, token);
         break;
       case "--cwd":
-        cwd = requireValue13(rest, token);
+        cwd = requireValue14(rest, token);
         break;
       default:
         throw new Error(`Unknown linear option: ${token}`);
@@ -28981,10 +29176,10 @@ function parseLinearWhoamiArgs(tokens) {
     const token = rest.shift();
     switch (token) {
       case "--account":
-        account = requireValue13(rest, token);
+        account = requireValue14(rest, token);
         break;
       case "--cwd":
-        cwd = requireValue13(rest, token);
+        cwd = requireValue14(rest, token);
         break;
       default:
         throw new Error(`Unknown linear option: ${token}`);
@@ -29009,10 +29204,10 @@ function parseLinearViewArgs(tokens) {
     const token = rest.shift();
     switch (token) {
       case "--account":
-        account = requireValue13(rest, token);
+        account = requireValue14(rest, token);
         break;
       case "--cwd":
-        cwd = requireValue13(rest, token);
+        cwd = requireValue14(rest, token);
         break;
       default:
         throw new Error(`Unknown linear option: ${token}`);
@@ -29047,32 +29242,32 @@ function parseLinearUpdateArgs(tokens) {
     const token = rest.shift();
     switch (token) {
       case "--account":
-        account = requireValue13(rest, token);
+        account = requireValue14(rest, token);
         break;
       case "--title":
-        title = requireValue13(rest, token);
+        title = requireValue14(rest, token);
         break;
       case "--desc":
       case "--description":
-        description = decodeEscapedNewlines(requireValue13(rest, token));
+        description = decodeEscapedNewlines(requireValue14(rest, token));
         break;
       case "--team-id":
-        teamId = requireValue13(rest, token);
+        teamId = requireValue14(rest, token);
         break;
       case "--team-key":
-        teamKey = requireValue13(rest, token);
+        teamKey = requireValue14(rest, token);
         break;
       case "--priority":
-        priority = parseLinearPriority(requireValue13(rest, token));
+        priority = parseLinearPriority(requireValue14(rest, token));
         break;
       case "--parent-id":
-        parentId = requireValue13(rest, token);
+        parentId = requireValue14(rest, token);
         break;
       case "--state-id":
-        stateId = requireValue13(rest, token);
+        stateId = requireValue14(rest, token);
         break;
       case "--cwd":
-        cwd = requireValue13(rest, token);
+        cwd = requireValue14(rest, token);
         break;
       default:
         throw new Error(`Unknown linear option: ${token}`);
@@ -29110,10 +29305,10 @@ function parseLinearSubIssuesArgs(tokens) {
     const token = rest.shift();
     switch (token) {
       case "--account":
-        account = requireValue13(rest, token);
+        account = requireValue14(rest, token);
         break;
       case "--cwd":
-        cwd = requireValue13(rest, token);
+        cwd = requireValue14(rest, token);
         break;
       default:
         throw new Error(`Unknown linear option: ${token}`);
@@ -29140,15 +29335,15 @@ function parseLinearCommentArgs(tokens) {
     const token = rest.shift();
     switch (token) {
       case "--account":
-        account = requireValue13(rest, token);
+        account = requireValue14(rest, token);
         break;
       case "--body":
       case "--desc":
       case "--description":
-        body = decodeEscapedNewlines(requireValue13(rest, token));
+        body = decodeEscapedNewlines(requireValue14(rest, token));
         break;
       case "--cwd":
-        cwd = requireValue13(rest, token);
+        cwd = requireValue14(rest, token);
         break;
       default:
         throw new Error(`Unknown linear option: ${token}`);
@@ -29178,10 +29373,10 @@ function parseLinearCommentsArgs(tokens) {
     const token = rest.shift();
     switch (token) {
       case "--account":
-        account = requireValue13(rest, token);
+        account = requireValue14(rest, token);
         break;
       case "--cwd":
-        cwd = requireValue13(rest, token);
+        cwd = requireValue14(rest, token);
         break;
       default:
         throw new Error(`Unknown linear option: ${token}`);
@@ -29205,16 +29400,16 @@ function parseLinearCycleArgs(tokens) {
     const token = rest.shift();
     switch (token) {
       case "--account":
-        account = requireValue13(rest, token);
+        account = requireValue14(rest, token);
         break;
       case "--team-id":
-        teamId = requireValue13(rest, token);
+        teamId = requireValue14(rest, token);
         break;
       case "--team-key":
-        teamKey = requireValue13(rest, token);
+        teamKey = requireValue14(rest, token);
         break;
       case "--cwd":
-        cwd = requireValue13(rest, token);
+        cwd = requireValue14(rest, token);
         break;
       default:
         throw new Error(`Unknown linear option: ${token}`);
@@ -29237,10 +29432,10 @@ function parseLinearTeamsArgs(tokens) {
     const token = rest.shift();
     switch (token) {
       case "--account":
-        account = requireValue13(rest, token);
+        account = requireValue14(rest, token);
         break;
       case "--cwd":
-        cwd = requireValue13(rest, token);
+        cwd = requireValue14(rest, token);
         break;
       default:
         throw new Error(`Unknown linear option: ${token}`);
@@ -29267,16 +29462,16 @@ function parseLinearUserIssuesArgs(tokens) {
     const token = rest.shift();
     switch (token) {
       case "--account":
-        account = requireValue13(rest, token);
+        account = requireValue14(rest, token);
         break;
       case "--cycle":
-        cycle = parseLinearCycle(requireValue13(rest, token));
+        cycle = parseLinearCycle(requireValue14(rest, token));
         break;
       case "--status":
-        status = parseLinearStatus(requireValue13(rest, token));
+        status = parseLinearStatus(requireValue14(rest, token));
         break;
       case "--cwd":
-        cwd = requireValue13(rest, token);
+        cwd = requireValue14(rest, token);
         break;
       default:
         throw new Error(`Unknown linear option: ${token}`);
@@ -29310,28 +29505,28 @@ function parseLinearIssuesArgs(tokens) {
     const token = rest.shift();
     switch (token) {
       case "--account":
-        account = requireValue13(rest, token);
+        account = requireValue14(rest, token);
         break;
       case "--team-id":
-        teamId = requireValue13(rest, token);
+        teamId = requireValue14(rest, token);
         break;
       case "--team-key":
-        teamKey = requireValue13(rest, token);
+        teamKey = requireValue14(rest, token);
         break;
       case "--user":
-        user = requireValue13(rest, token);
+        user = requireValue14(rest, token);
         break;
       case "--cycle":
-        cycle = parseLinearCycle(requireValue13(rest, token));
+        cycle = parseLinearCycle(requireValue14(rest, token));
         break;
       case "--status":
-        status = parseLinearStatus(requireValue13(rest, token));
+        status = parseLinearStatus(requireValue14(rest, token));
         break;
       case "--query":
-        query = requireValue13(rest, token).trim();
+        query = requireValue14(rest, token).trim();
         break;
       case "--limit": {
-        const value = Number.parseInt(requireValue13(rest, token), 10);
+        const value = Number.parseInt(requireValue14(rest, token), 10);
         if (!Number.isInteger(value) || value < 1 || value > 250) {
           throw new Error("Invalid --limit. Expected an integer between 1 and 250.");
         }
@@ -29339,7 +29534,7 @@ function parseLinearIssuesArgs(tokens) {
         break;
       }
       case "--cwd":
-        cwd = requireValue13(rest, token);
+        cwd = requireValue14(rest, token);
         break;
       default:
         throw new Error(`Unknown linear option: ${token}`);
@@ -29380,10 +29575,10 @@ function parseLinearLegacyArgs(tokens) {
         useScreenshot = true;
         break;
       case "--account":
-        account = requireValue13(rest, token);
+        account = requireValue14(rest, token);
         break;
       case "--cwd":
-        cwd = requireValue13(rest, token);
+        cwd = requireValue14(rest, token);
         break;
       default:
         throw new Error(`Unknown linear option: ${token}`);
@@ -29477,19 +29672,19 @@ function parseNotionArgs(tokens) {
       const token = rest.shift();
       switch (token) {
         case "--parent":
-          parentPageId = requireValue13(rest, token);
+          parentPageId = requireValue14(rest, token);
           break;
         case "--title":
-          title = requireValue13(rest, token);
+          title = requireValue14(rest, token);
           break;
         case "--private":
           isPrivate = true;
           break;
         case "--content":
-          content2 = requireValue13(rest, token);
+          content2 = requireValue14(rest, token);
           break;
         case "--file":
-          filePath2 = requireValue13(rest, token);
+          filePath2 = requireValue14(rest, token);
           break;
         default:
           throw new Error(`Unknown notion option: ${token}`);
@@ -29533,10 +29728,10 @@ function parseNotionArgs(tokens) {
     const token = rest.shift();
     switch (token) {
       case "--content":
-        content = requireValue13(rest, token);
+        content = requireValue14(rest, token);
         break;
       case "--file":
-        filePath = requireValue13(rest, token);
+        filePath = requireValue14(rest, token);
         break;
       case "--append":
         append = true;
@@ -29581,11 +29776,11 @@ function parseRandomArgs(tokens) {
         mode = "easy";
         break;
       case "--length":
-        length = parsePositiveInt3(requireValue13(rest, token), token);
+        length = parsePositiveInt3(requireValue14(rest, token), token);
         seenLength = true;
         break;
       case "--charset": {
-        const value = requireValue13(rest, token);
+        const value = requireValue14(rest, token);
         if (!["base64url", "hex", "alnum", "ascii"].includes(value)) {
           throw new Error(
             `Invalid --charset value: ${value}. Use base64url|hex|alnum|ascii.`
@@ -29596,18 +29791,18 @@ function parseRandomArgs(tokens) {
         break;
       }
       case "--count":
-        count = parsePositiveInt3(requireValue13(rest, token), token);
+        count = parsePositiveInt3(requireValue14(rest, token), token);
         break;
       case "--words":
-        words = parsePositiveInt3(requireValue13(rest, token), token);
+        words = parsePositiveInt3(requireValue14(rest, token), token);
         seenWords = true;
         break;
       case "--digits":
-        digits = parseNonNegativeInt(requireValue13(rest, token), token);
+        digits = parseNonNegativeInt(requireValue14(rest, token), token);
         seenDigits = true;
         break;
       case "--separator":
-        separator = requireValue13(rest, token);
+        separator = requireValue14(rest, token);
         seenSeparator = true;
         break;
       default:
@@ -29638,7 +29833,7 @@ function parseRandomArgs(tokens) {
     count
   };
 }
-function requireValue13(tokens, optionName) {
+function requireValue14(tokens, optionName) {
   const value = tokens.shift();
   if (!value) {
     throw new Error(`Missing value for ${optionName}`);
@@ -29819,6 +30014,11 @@ async function main() {
         await handler.handle(commandArgs);
         return;
       }
+      case "host" /* Host */: {
+        const handler = new HostCommandHandler();
+        await handler.handle(commandArgs);
+        return;
+      }
       case "vercel" /* Vercel */: {
         const handler = new VercelCommandHandler();
         await handler.handle(commandArgs);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pmate/cli",
-  "version": "0.28.1",
+  "version": "0.28.3",
   "description": "CLI utilities for the pMate project",
   "license": "MIT",
   "bin": {