@pmate/cli 0.21.1 → 0.21.2

package/dist/index.js

@@ -12730,8 +12730,8 @@ __export(index_exports, {
   parseCommandArgs: () => parseCommandArgs
 });
 module.exports = __toCommonJS(index_exports);
-var import_node_fs17 = require("fs");
-var import_node_path22 = __toESM(require("path"));
+var import_node_fs18 = require("fs");
+var import_node_path23 = __toESM(require("path"));
 var import_chalk4 = __toESM(require("chalk"));
 
 // src/cli.ts
@@ -17630,9 +17630,9 @@ ${indent}\`\`\``;
   static richTextToPlain(richText) {
     return richText.map((item) => item.plain_text ?? item.text?.content ?? "").join("").trim();
   }
-  static async requestJson(path23, init) {
+  static async requestJson(path24, init) {
     const token = this.getToken();
-    const response = await fetch(`${this.baseUrl}${path23}`, {
+    const response = await fetch(`${this.baseUrl}${path24}`, {
       method: init.method,
       headers: {
         Authorization: `Bearer ${token}`,
@@ -19228,8 +19228,8 @@ function descriptorPathSegments(descriptor) {
   return ["chains", normalized.chain, "namespaces", normalized.ns, normalized.kind, normalized.name];
 }
 function buildPathUrl(baseUrl, pathSegments, query) {
-  const path23 = `/${pathSegments.map((segment) => encodeURIComponent(segment)).join("/")}`;
-  const url = new URL(path23, baseUrl);
+  const path24 = `/${pathSegments.map((segment) => encodeURIComponent(segment)).join("/")}`;
+  const url = new URL(path24, baseUrl);
   if (query) {
     for (const [key, value] of Object.entries(query)) {
       url.searchParams.set(key, String(value));
@@ -19759,6 +19759,160 @@ var AgentCommandHandler = class {
   }
 };
 
+// src/commands/RunnerCommandHandler.ts
+var import_node_fs13 = require("fs");
+var import_node_path18 = __toESM(require("path"));
+init_sessionStore();
+init_namespacedRef();
+var RunnerCommandHandler = class {
+  async handle(args) {
+    const token = this.readToken();
+    const baseUrl = this.resolveBaseUrl(args.baseUrl);
+    switch (args.action) {
+      case "list": {
+        const items = (await this.request(
+          baseUrl,
+          token,
+          "GET",
+          args.namespace ? `/runners?namespace=${encodeURIComponent(args.namespace)}` : "/runners/all"
+        )).items;
+        this.renderList(items, args.json);
+        return;
+      }
+      case "get":
+      case "view": {
+        const record = await this.request(
+          baseUrl,
+          token,
+          "GET",
+          `/runners/${encodeURIComponent(args.namespace)}/${encodeURIComponent(args.name)}`
+        );
+        this.renderJson(record, true);
+        return;
+      }
+      case "create": {
+        await this.requireNamespace(args.namespace, baseUrl);
+        const payload = this.readJsonFile(args.filePath);
+        const record = await this.request(
+          baseUrl,
+          token,
+          "POST",
+          `/runners/${encodeURIComponent(args.namespace)}`,
+          payload
+        );
+        ui.success(`Created runner ${record.id}`);
+        this.renderJson(record, args.json);
+        return;
+      }
+      case "update": {
+        const payload = this.readJsonFile(args.filePath);
+        const record = await this.request(
+          baseUrl,
+          token,
+          "PUT",
+          `/runners/${encodeURIComponent(args.namespace)}/${encodeURIComponent(args.name)}`,
+          payload
+        );
+        ui.success(`Updated runner ${record.id}`);
+        this.renderJson(record, args.json);
+        return;
+      }
+      case "delete": {
+        const record = await this.request(
+          baseUrl,
+          token,
+          "DELETE",
+          `/runners/${encodeURIComponent(args.namespace)}/${encodeURIComponent(args.name)}`
+        );
+        ui.success(`Disabled runner ${record.id}`);
+        this.renderJson(record, args.json);
+        return;
+      }
+    }
+  }
+  resolveBaseUrl(baseUrl) {
+    return (baseUrl || process.env.PMATE_AGENT_API_BASE_URL || "https://agent-api.pmate.chat").replace(/\/+$/, "");
+  }
+  async requireNamespace(namespace, registryBaseUrl) {
+    const registry = new NamespaceRegistry({
+      chain: "pmate",
+      registryBaseUrl: this.resolveNamespaceBaseUrl(registryBaseUrl)
+    });
+    const exists = await registry.exists(namespace);
+    if (!exists) {
+      throw new Error(`Namespace "${namespace}" is not registered. Run: pmate ns create ${namespace}`);
+    }
+  }
+  resolveNamespaceBaseUrl(baseUrl) {
+    const envBaseUrl = process.env.PMATE_NAMESPACE_API_BASE_URL || process.env.PMATE_APPS_API_BASE_URL;
+    if (envBaseUrl) {
+      return envBaseUrl.replace(/\/+$/, "");
+    }
+    return baseUrl.includes("agent-api") || baseUrl.includes("agent.local") ? baseUrl.replace("agent-api", "apps-api").replace("agent.local", "apps.local") : baseUrl;
+  }
+  readToken() {
+    return readRequiredSession({
+      preferredApp: DEFAULT_APP_ID
+    }).token;
+  }
+  readJsonFile(filePath) {
+    const absolutePath = import_node_path18.default.resolve(process.cwd(), filePath);
+    if (!(0, import_node_fs13.existsSync)(absolutePath)) {
+      throw new Error(`JSON file not found: ${absolutePath}`);
+    }
+    const raw = (0, import_node_fs13.readFileSync)(absolutePath, "utf8");
+    try {
+      return JSON.parse(raw);
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      throw new Error(`Invalid JSON in ${absolutePath}: ${message}`);
+    }
+  }
+  async request(baseUrl, token, method, pathname, body) {
+    const response = await fetch(`${baseUrl}${pathname}`, {
+      method,
+      headers: {
+        Authorization: `Bearer ${token}`,
+        "Content-Type": "application/json"
+      },
+      ...body !== void 0 ? { body: JSON.stringify(body) } : {}
+    });
+    let payload = null;
+    try {
+      payload = await response.json();
+    } catch {
+      payload = null;
+    }
+    if (!response.ok || !payload?.success) {
+      throw new Error(payload?.message || `Request failed with status ${response.status}`);
+    }
+    return payload.data;
+  }
+  renderList(items, asJson) {
+    if (asJson) {
+      ui.plain(JSON.stringify(items, null, 2));
+      return;
+    }
+    if (items.length === 0) {
+      ui.warn("No runners found.");
+      return;
+    }
+    for (const item of items) {
+      ui.info(formatNamespacedDisplayId(item.namespace, item.name), {
+        status: item.status,
+        runtime: item.payload.runtime,
+        listen: item.payload.listen
+      });
+    }
+  }
+  renderJson(value, asJson) {
+    if (!asJson) {
+      return;
+    }
+    ui.plain(JSON.stringify(value, null, 2));
+  }
+};
+
 // src/commands/NsCommandHandler.ts
 init_sessionStore();
 var NsCommandHandler = class {
@@ -19825,8 +19979,8 @@ var NsCommandHandler = class {
 };
 
 // src/commands/StoreCommandHandler.ts
-var import_node_fs13 = require("fs");
-var import_node_path18 = __toESM(require("path"));
+var import_node_fs14 = require("fs");
+var import_node_path19 = __toESM(require("path"));
 var StoreCommandHandler = class {
   async handle(args) {
     if (args.scope === "namespace") {
@@ -19968,11 +20122,11 @@ var StoreCommandHandler = class {
     return payload.data ?? [];
   }
   readJsonFile(filePath) {
-    const absolutePath = import_node_path18.default.resolve(process.cwd(), filePath);
-    if (!(0, import_node_fs13.existsSync)(absolutePath)) {
+    const absolutePath = import_node_path19.default.resolve(process.cwd(), filePath);
+    if (!(0, import_node_fs14.existsSync)(absolutePath)) {
       throw new Error(`JSON file not found: ${absolutePath}`);
     }
-    const raw = (0, import_node_fs13.readFileSync)(absolutePath, "utf8");
+    const raw = (0, import_node_fs14.readFileSync)(absolutePath, "utf8");
     try {
       return JSON.parse(raw);
     } catch (error) {
@@ -20024,8 +20178,8 @@ var StoreCommandHandler = class {
 };
 
 // src/commands/AppCommandHandler.ts
-var import_node_fs14 = require("fs");
-var import_node_path19 = __toESM(require("path"));
+var import_node_fs15 = require("fs");
+var import_node_path20 = __toESM(require("path"));
 init_sessionStore();
 init_namespacedRef();
 var AppCommandHandler = class {
@@ -20142,11 +20296,11 @@ var AppCommandHandler = class {
     }).token;
   }
   readJsonFile(filePath) {
-    const absolutePath = import_node_path19.default.resolve(process.cwd(), filePath);
-    if (!(0, import_node_fs14.existsSync)(absolutePath)) {
+    const absolutePath = import_node_path20.default.resolve(process.cwd(), filePath);
+    if (!(0, import_node_fs15.existsSync)(absolutePath)) {
       throw new Error(`JSON file not found: ${absolutePath}`);
     }
-    const raw = (0, import_node_fs14.readFileSync)(absolutePath, "utf8");
+    const raw = (0, import_node_fs15.readFileSync)(absolutePath, "utf8");
     try {
       return JSON.parse(raw);
     } catch (error) {
@@ -20226,13 +20380,13 @@ function readNamespaceFromPayload(payload) {
 }
 
 // src/commands/ServiceCommandHandler.ts
-var import_node_fs16 = require("fs");
-var import_node_path21 = __toESM(require("path"));
+var import_node_fs17 = require("fs");
+var import_node_path22 = __toESM(require("path"));
 
 // src/services/ServiceRuntimeRunner.ts
-var import_node_fs15 = require("fs");
+var import_node_fs16 = require("fs");
 var import_node_os7 = __toESM(require("os"));
-var import_node_path20 = __toESM(require("path"));
+var import_node_path21 = __toESM(require("path"));
 var import_node_child_process9 = require("child_process");
 var import_node_readline = require("readline");
 var import_chalk3 = __toESM(require("chalk"));
@@ -20345,14 +20499,14 @@ var ServiceRuntimeRunner = class {
   }
   resolveRepoRoot(service, cwd) {
     if (cwd) {
-      return import_node_path20.default.resolve(process.cwd(), cwd);
+      return import_node_path21.default.resolve(process.cwd(), cwd);
     }
     const repository = this.getDeploy(service).repository?.trim();
     if (repository) {
       const repoName = repository.replace(/\/+$/, "").split("/").pop()?.replace(/\.git$/i, "");
       if (repoName) {
-        const candidate = import_node_path20.default.join(import_node_os7.default.homedir(), "dev", "pmate", repoName);
-        if ((0, import_node_fs15.existsSync)(candidate)) {
+        const candidate = import_node_path21.default.join(import_node_os7.default.homedir(), "dev", "pmate", repoName);
+        if ((0, import_node_fs16.existsSync)(candidate)) {
           return candidate;
         }
       }
@@ -20365,12 +20519,12 @@ var ServiceRuntimeRunner = class {
     if (!dir) {
       throw new Error(`Missing deploy.dir for ${service.id}`);
     }
-    return import_node_path20.default.resolve(repoRoot, dir);
+    return import_node_path21.default.resolve(repoRoot, dir);
   }
   async deployVite(service, options) {
     const appDir = this.resolveLocalDir(service, options.cwd);
-    const packageJsonPath = import_node_path20.default.join(appDir, "package.json");
-    if (!(0, import_node_fs15.existsSync)(packageJsonPath)) {
+    const packageJsonPath = import_node_path21.default.join(appDir, "package.json");
+    if (!(0, import_node_fs16.existsSync)(packageJsonPath)) {
       throw new Error(`No package.json found at ${packageJsonPath}`);
     }
     const pkg2 = this.loadPackageJson(packageJsonPath);
@@ -20379,8 +20533,8 @@ var ServiceRuntimeRunner = class {
       throw new Error(`Missing package name in ${packageJsonPath}`);
     }
     await this.runCommand("pnpm", ["--filter", pkgName, "build"], this.resolveRepoRoot(service, options.cwd));
-    const distDir = import_node_path20.default.join(appDir, "dist");
-    if (!(0, import_node_fs15.existsSync)(distDir)) {
+    const distDir = import_node_path21.default.join(appDir, "dist");
+    if (!(0, import_node_fs16.existsSync)(distDir)) {
       throw new Error(`No dist directory found at ${distDir}`);
     }
     const bucketName = this.getDeploy(service).bucket?.trim();
@@ -20391,8 +20545,8 @@ var ServiceRuntimeRunner = class {
   }
   async deployStatic(service, options) {
     const appDir = this.resolveLocalDir(service, options.cwd);
-    const srcDir = import_node_path20.default.join(appDir, "src");
-    if (!(0, import_node_fs15.existsSync)(srcDir)) {
+    const srcDir = import_node_path21.default.join(appDir, "src");
+    if (!(0, import_node_fs16.existsSync)(srcDir)) {
       throw new Error(`No src directory found at ${srcDir}`);
     }
     const bucketName = this.getDeploy(service).bucket?.trim();
@@ -20510,7 +20664,7 @@ var ServiceRuntimeRunner = class {
       const serverAddress = await resolveServerAddress(server);
       const templateName = serviceType === "ws" ? "nginx.ws.template" : "nginx.rest.template";
       const templatePath = this.resolveTemplatePath(templateName);
-      const template = (0, import_node_fs15.readFileSync)(templatePath, "utf8");
+      const template = (0, import_node_fs16.readFileSync)(templatePath, "utf8");
       const host = `${subdomain}.${deploy.domain?.trim() || "pmate.chat"}`;
       const rendered = template.replace(/\$\{\{PORT\}\}/g, String(port)).replace(/\$\{\{HOSTS\}\}/g, host).replace(/\$\{\{HOST\}\}/g, host);
       const remotePath = `/etc/nginx/sites-enabled/${subdomain}.conf`;
@@ -20542,11 +20696,11 @@ var ServiceRuntimeRunner = class {
     }
     if (config.ensurePackageJson) {
       const appDir = this.resolveLocalDir(service, options.cwd);
-      const packageJsonPath = import_node_path20.default.join(appDir, "package.json");
-      if (!(0, import_node_fs15.existsSync)(packageJsonPath)) {
+      const packageJsonPath = import_node_path21.default.join(appDir, "package.json");
+      if (!(0, import_node_fs16.existsSync)(packageJsonPath)) {
         throw new Error(`Missing package.json at ${packageJsonPath}`);
       }
-      const pkgStat = (0, import_node_fs15.statSync)(packageJsonPath);
+      const pkgStat = (0, import_node_fs16.statSync)(packageJsonPath);
       if (!pkgStat.isFile()) {
         throw new Error(`package.json is not a file at ${packageJsonPath}`);
       }
@@ -20969,9 +21123,9 @@ var ServiceRuntimeRunner = class {
     return tokens;
   }
   readPathValue(source, pathExpr) {
-    const path23 = pathExpr.split(".").map((segment) => segment.trim()).filter(Boolean);
+    const path24 = pathExpr.split(".").map((segment) => segment.trim()).filter(Boolean);
     let cursor = source;
-    for (const segment of path23) {
+    for (const segment of path24) {
       if (!cursor || typeof cursor !== "object" || Array.isArray(cursor)) {
         return void 0;
       }
@@ -21014,12 +21168,12 @@ var ServiceRuntimeRunner = class {
   }
   resolveTemplatePath(templateName) {
     const candidates = [
-      import_node_path20.default.join(__dirname, "..", "templates", templateName),
-      import_node_path20.default.join(__dirname, "..", "src", "templates", templateName),
-      import_node_path20.default.join(__dirname, "templates", templateName)
+      import_node_path21.default.join(__dirname, "..", "templates", templateName),
+      import_node_path21.default.join(__dirname, "..", "src", "templates", templateName),
+      import_node_path21.default.join(__dirname, "templates", templateName)
     ];
     for (const candidate of candidates) {
-      if ((0, import_node_fs15.existsSync)(candidate)) {
+      if ((0, import_node_fs16.existsSync)(candidate)) {
         return candidate;
       }
     }
@@ -21051,7 +21205,7 @@ var ServiceRuntimeRunner = class {
     });
   }
   loadPackageJson(packageJsonPath) {
-    const raw = (0, import_node_fs15.readFileSync)(packageJsonPath, "utf8");
+    const raw = (0, import_node_fs16.readFileSync)(packageJsonPath, "utf8");
     const parsed = JSON.parse(raw);
     if (!parsed || typeof parsed !== "object") {
       throw new Error(`Invalid package.json at ${packageJsonPath}`);
@@ -21060,7 +21214,7 @@ var ServiceRuntimeRunner = class {
   }
   writePackageJson(packageJsonPath, data) {
     const serialized = JSON.stringify(data, null, 2);
-    (0, import_node_fs15.writeFileSync)(packageJsonPath, `${serialized}
+    (0, import_node_fs16.writeFileSync)(packageJsonPath, `${serialized}
 `, "utf8");
   }
   runCommand(command, args, cwd) {
@@ -21328,11 +21482,11 @@ var ServiceCommandHandler = class {
     return (baseUrl || process.env.PMATE_APPS_API_BASE_URL || "https://apps-api.pmate.chat").replace(/\/+$/, "");
   }
   readJsonFile(filePath) {
-    const absolutePath = import_node_path21.default.resolve(process.cwd(), filePath);
-    if (!(0, import_node_fs16.existsSync)(absolutePath)) {
+    const absolutePath = import_node_path22.default.resolve(process.cwd(), filePath);
+    if (!(0, import_node_fs17.existsSync)(absolutePath)) {
       throw new Error(`JSON file not found: ${absolutePath}`);
     }
-    const raw = (0, import_node_fs16.readFileSync)(absolutePath, "utf8");
+    const raw = (0, import_node_fs17.readFileSync)(absolutePath, "utf8");
     try {
       return JSON.parse(raw);
     } catch (error) {
@@ -22121,6 +22275,180 @@ function parseJsonObject(value, optionName) {
   return parsed;
 }
 
+// src/runnerCommandParser.ts
+init_namespacedRef();
+var DEFAULT_RUNNER_NAMESPACE = "pmate";
+function parseRunnerArgs(tokens) {
+  const rest = [...tokens];
+  const rawAction = rest.shift();
+  const action = rawAction === "view" ? "view" : rawAction;
+  if (!action) {
+    throw new Error("Missing runner action. Use: runner list|get|view|create|update|delete");
+  }
+  let baseUrl;
+  let json = false;
+  const takeSharedOptions4 = () => {
+    while (rest.length > 0) {
+      const token = rest[0];
+      if (token === "--base-url") {
+        rest.shift();
+        baseUrl = requireValue2(rest, token);
+        continue;
+      }
+      if (token === "--json") {
+        rest.shift();
+        json = true;
+        continue;
+      }
+      break;
+    }
+  };
+  if (action === "list") {
+    let namespace;
+    while (rest.length > 0) {
+      const token = rest.shift();
+      switch (token) {
+        case "--ns":
+        case "--namespace":
+          namespace = requireValue2(rest, token);
+          break;
+        case "--base-url":
+          baseUrl = requireValue2(rest, token);
+          break;
+        case "--json":
+          json = true;
+          break;
+        default:
+          throw new Error(`Unknown runner list option: ${token}`);
+      }
+    }
+    return { type: "runner" /* Runner */, action, namespace, baseUrl, json };
+  }
+  if (action === "view") {
+    const ref = rest.shift();
+    if (!ref) {
+      throw new Error("Usage: runner view <ns:objectId> [--base-url <url>]");
+    }
+    while (rest.length > 0) {
+      const token = rest.shift();
+      switch (token) {
+        case "--base-url":
+          baseUrl = requireValue2(rest, token);
+          break;
+        default:
+          throw new Error(`Unknown runner view option: ${token}`);
+      }
+    }
+    const parsed = parseNamespacedRef(ref, {
+      entityLabel: "runner ref"
+    });
+    return {
+      type: "runner" /* Runner */,
+      action,
+      namespace: parsed.namespace,
+      name: parsed.objectId,
+      baseUrl,
+      json
+    };
+  }
+  if (action === "get" || action === "delete") {
+    const ref = rest.shift();
+    if (!ref) {
+      throw new Error(
+        `Usage: runner ${action} <ns:objectId> [--base-url <url>] [--json]`
+      );
+    }
+    const parsed = parseNamespacedRef(ref, {
+      entityLabel: "runner ref"
+    });
+    takeSharedOptions4();
+    if (rest.length > 0) {
+      throw new Error(`Unknown runner ${action} option: ${rest[0]}`);
+    }
+    return {
+      type: "runner" /* Runner */,
+      action,
+      namespace: parsed.namespace,
+      name: parsed.objectId,
+      baseUrl,
+      json
+    };
+  }
+  if (action === "create") {
+    let namespace = DEFAULT_RUNNER_NAMESPACE;
+    if (rest[0] && !rest[0].startsWith("-")) {
+      namespace = rest.shift();
+    }
+    let filePath;
+    while (rest.length > 0) {
+      const token = rest.shift();
+      switch (token) {
+        case "--file":
+          filePath = requireValue2(rest, token);
+          break;
+        case "--base-url":
+          baseUrl = requireValue2(rest, token);
+          break;
+        case "--json":
+          json = true;
+          break;
+        default:
+          throw new Error(`Unknown runner create option: ${token}`);
+      }
+    }
+    if (!filePath) {
+      throw new Error("Missing required option --file for runner create");
+    }
+    return { type: "runner" /* Runner */, action, namespace, filePath, baseUrl, json };
+  }
+  if (action === "update") {
+    const ref = rest.shift();
+    if (!ref) {
+      throw new Error(
+        "Usage: runner update <ns:objectId> --file <path> [--base-url <url>] [--json]"
+      );
+    }
+    const parsed = parseNamespacedRef(ref, { entityLabel: "runner ref" });
+    let filePath;
+    while (rest.length > 0) {
+      const token = rest.shift();
+      switch (token) {
+        case "--file":
+          filePath = requireValue2(rest, token);
+          break;
+        case "--base-url":
+          baseUrl = requireValue2(rest, token);
+          break;
+        case "--json":
+          json = true;
+          break;
+        default:
+          throw new Error(`Unknown runner update option: ${token}`);
+      }
+    }
+    if (!filePath) {
+      throw new Error("Missing required option --file for runner update");
+    }
+    return {
+      type: "runner" /* Runner */,
+      action,
+      namespace: parsed.namespace,
+      name: parsed.objectId,
+      filePath,
+      baseUrl,
+      json
+    };
+  }
+  throw new Error(`Unknown runner action: ${action}`);
+}
+function requireValue2(tokens, optionName) {
+  const value = tokens.shift();
+  if (!value || value.startsWith("-")) {
+    throw new Error(`Missing value for ${optionName}`);
+  }
+  return value;
+}
+
 // src/nsCommandParser.ts
 var DEFAULT_CHAIN = "pmate";
 function parseNsArgs(tokens) {
@@ -22171,10 +22499,10 @@ function takeSharedOptions(rest, handlers) {
     const token = rest.shift();
     switch (token) {
       case "--chain":
-        handlers.onChain(requireValue2(rest, token));
+        handlers.onChain(requireValue3(rest, token));
         break;
       case "--base-url":
-        handlers.onBaseUrl(requireValue2(rest, token));
+        handlers.onBaseUrl(requireValue3(rest, token));
         break;
       case "--json":
         handlers.onJson();
@@ -22184,7 +22512,7 @@ function takeSharedOptions(rest, handlers) {
     }
   }
 }
-function requireValue2(tokens, optionName) {
+function requireValue3(tokens, optionName) {
   const value = tokens.shift();
   if (!value || value.startsWith("-")) {
     throw new Error(`Missing value for ${optionName}`);
@@ -22246,7 +22574,7 @@ function parseTableArgs(action, rest, shared) {
       const token = rest.shift();
       switch (token) {
         case "--page":
-          page = parsePage(requireValue3(rest, token));
+          page = parsePage(requireValue4(rest, token));
           break;
         default:
           pushSharedOption(token, rest, shared);
@@ -22260,7 +22588,7 @@ function parseTableArgs(action, rest, shared) {
       const token = rest.shift();
       switch (token) {
         case "--id":
-          id = requireValue3(rest, token);
+          id = requireValue4(rest, token);
           break;
         default:
           pushSharedOption(token, rest, shared);
@@ -22277,7 +22605,7 @@ function parseTableArgs(action, rest, shared) {
       const token = rest.shift();
       switch (token) {
         case "--file":
-          filePath = requireValue3(rest, token);
+          filePath = requireValue4(rest, token);
           break;
         default:
           pushSharedOption(token, rest, shared);
@@ -22301,7 +22629,7 @@ function parseKvArgs(action, rest, shared) {
       const token = rest.shift();
       switch (token) {
         case "--page":
-          page = parsePage(requireValue3(rest, token));
+          page = parsePage(requireValue4(rest, token));
           break;
         default:
           pushSharedOption(token, rest, shared);
@@ -22315,7 +22643,7 @@ function parseKvArgs(action, rest, shared) {
       const token = rest.shift();
       switch (token) {
         case "--key":
-          key = requireValue3(rest, token);
+          key = requireValue4(rest, token);
           break;
         default:
           pushSharedOption(token, rest, shared);
@@ -22334,13 +22662,13 @@ function parseKvArgs(action, rest, shared) {
       const token = rest.shift();
       switch (token) {
         case "--key":
-          key = requireValue3(rest, token);
+          key = requireValue4(rest, token);
           break;
         case "--value":
-          value = requireValue3(rest, token);
+          value = requireValue4(rest, token);
           break;
         case "--file":
-          filePath = requireValue3(rest, token);
+          filePath = requireValue4(rest, token);
           break;
         default:
           pushSharedOption(token, rest, shared);
@@ -22365,17 +22693,17 @@ function takeSharedOptions2(rest, shared) {
 function pushSharedOption(token, rest, shared) {
   switch (token) {
     case "--chain":
-      shared.chain = requireValue3(rest, token);
+      shared.chain = requireValue4(rest, token);
       break;
     case "--ns":
     case "--namespace":
-      shared.namespace = requireValue3(rest, token);
+      shared.namespace = requireValue4(rest, token);
       break;
     case "--base-url":
-      shared.baseUrl = requireValue3(rest, token);
+      shared.baseUrl = requireValue4(rest, token);
       break;
     case "--indexer-base-url":
-      shared.indexerBaseUrl = requireValue3(rest, token);
+      shared.indexerBaseUrl = requireValue4(rest, token);
       break;
     case "--json":
       shared.json = true;
@@ -22384,7 +22712,7 @@ function pushSharedOption(token, rest, shared) {
       throw new Error(`Unknown store option: ${token}`);
   }
 }
-function requireValue3(tokens, optionName) {
+function requireValue4(tokens, optionName) {
   const value = tokens.shift();
   if (!value || value.startsWith("-")) {
     throw new Error(`Missing value for ${optionName}`);
@@ -22415,7 +22743,7 @@ function parseAppArgs(tokens) {
       const token = rest[0];
       if (token === "--base-url") {
         rest.shift();
-        baseUrl = requireValue4(rest, token);
+        baseUrl = requireValue5(rest, token);
         continue;
       }
       if (token === "--json") {
@@ -22433,10 +22761,10 @@ function parseAppArgs(tokens) {
       switch (token) {
         case "--ns":
         case "--namespace":
-          namespace = requireValue4(rest, token);
+          namespace = requireValue5(rest, token);
           break;
         case "--base-url":
-          baseUrl = requireValue4(rest, token);
+          baseUrl = requireValue5(rest, token);
           break;
         case "--json":
           json = true;
@@ -22461,7 +22789,7 @@ function parseAppArgs(tokens) {
       const token = rest.shift();
       switch (token) {
         case "--base-url":
-          baseUrl = requireValue4(rest, token);
+          baseUrl = requireValue5(rest, token);
           break;
         default:
           throw new Error(`Unknown app view option: ${token}`);
@@ -22491,10 +22819,10 @@ function parseAppArgs(tokens) {
       const token = rest.shift();
       switch (token) {
         case "--file":
-          filePath = requireValue4(rest, token);
+          filePath = requireValue5(rest, token);
           break;
         case "--base-url":
-          baseUrl = requireValue4(rest, token);
+          baseUrl = requireValue5(rest, token);
           break;
         case "--json":
           json = true;
@@ -22521,10 +22849,10 @@ function parseAppArgs(tokens) {
       const token = rest.shift();
       switch (token) {
         case "--file":
-          filePath = requireValue4(rest, token);
+          filePath = requireValue5(rest, token);
           break;
         case "--base-url":
-          baseUrl = requireValue4(rest, token);
+          baseUrl = requireValue5(rest, token);
           break;
         case "--json":
           json = true;
@@ -22547,16 +22875,16 @@ function parseAppArgs(tokens) {
       switch (token) {
         case "--ns":
         case "--namespace":
-          namespace = requireValue4(rest, token);
+          namespace = requireValue5(rest, token);
           break;
         case "--from":
-          fromId = parseBareRenameId2(requireValue4(rest, token), "app");
+          fromId = parseBareRenameId2(requireValue5(rest, token), "app");
           break;
         case "--to":
-          toId = parseBareRenameId2(requireValue4(rest, token), "app");
+          toId = parseBareRenameId2(requireValue5(rest, token), "app");
           break;
         case "--base-url":
-          baseUrl = requireValue4(rest, token);
+          baseUrl = requireValue5(rest, token);
           break;
         case "--json":
           json = true;
@@ -22582,20 +22910,20 @@ function parseAppArgs(tokens) {
       switch (token) {
         case "--ns":
         case "--namespace":
-          namespace = requireValue4(rest, token);
+          namespace = requireValue5(rest, token);
           break;
         case "--from":
-          fromId = parseBareRenameId2(requireValue4(rest, token), "app");
+          fromId = parseBareRenameId2(requireValue5(rest, token), "app");
           break;
         case "--to-ns":
         case "--target-namespace":
-          targetNamespace = requireValue4(rest, token);
+          targetNamespace = requireValue5(rest, token);
           break;
         case "--to":
-          toId = parseBareRenameId2(requireValue4(rest, token), "app");
+          toId = parseBareRenameId2(requireValue5(rest, token), "app");
           break;
         case "--base-url":
-          baseUrl = requireValue4(rest, token);
+          baseUrl = requireValue5(rest, token);
           break;
         case "--json":
           json = true;
@@ -22613,7 +22941,7 @@ function parseAppArgs(tokens) {
   }
   throw new Error(`Unknown app action: ${action}`);
 }
-function requireValue4(tokens, optionName) {
+function requireValue5(tokens, optionName) {
   const value = tokens.shift();
   if (!value || value.startsWith("-")) {
     throw new Error(`Missing value for ${optionName}`);
@@ -22647,16 +22975,16 @@ function parseServiceArgs(tokens) {
       const token = rest.shift();
       switch (token) {
         case "--namespace":
-          namespace = requireValue5(rest, token);
+          namespace = requireValue6(rest, token);
           break;
         case "--repo":
-          repository = requireValue5(rest, token);
+          repository = requireValue6(rest, token);
           break;
         case "--server":
-          server = requireValue5(rest, token);
+          server = requireValue6(rest, token);
           break;
         case "--base-url":
-          baseUrl = requireValue5(rest, token);
+          baseUrl = requireValue6(rest, token);
           break;
         case "--json":
           json = true;
@@ -22676,7 +23004,7 @@ function parseServiceArgs(tokens) {
       const token = rest.shift();
       switch (token) {
         case "--base-url":
-          baseUrl = requireValue5(rest, token);
+          baseUrl = requireValue6(rest, token);
           break;
         default:
           throw new Error(`Unknown service view option: ${token}`);
@@ -22706,19 +23034,19 @@ function parseServiceArgs(tokens) {
       const token = rest.shift();
       switch (token) {
         case "--base-url":
-          baseUrl = requireValue5(rest, token);
+          baseUrl = requireValue6(rest, token);
           break;
         case "--cwd":
-          cwd = requireValue5(rest, token);
+          cwd = requireValue6(rest, token);
           break;
         case "--page":
-          page = Number.parseInt(requireValue5(rest, token), 10);
+          page = Number.parseInt(requireValue6(rest, token), 10);
           break;
         case "--history":
           history = true;
           break;
         case "--search":
-          search = requireValue5(rest, token);
+          search = requireValue6(rest, token);
           break;
         case "--follow":
         case "-f":
@@ -22748,10 +23076,10 @@ function parseServiceArgs(tokens) {
       const token = rest.shift();
       switch (token) {
         case "--file":
-          filePath = requireValue5(rest, token);
+          filePath = requireValue6(rest, token);
           break;
         case "--base-url":
-          baseUrl = requireValue5(rest, token);
+          baseUrl = requireValue6(rest, token);
           break;
         case "--json":
           json = true;
@@ -22780,10 +23108,10 @@ function parseServiceArgs(tokens) {
       const token = rest.shift();
       switch (token) {
         case "--file":
-          filePath = requireValue5(rest, token);
+          filePath = requireValue6(rest, token);
           break;
         case "--base-url":
-          baseUrl = requireValue5(rest, token);
+          baseUrl = requireValue6(rest, token);
           break;
         case "--json":
           json = true;
@@ -22806,16 +23134,16 @@ function parseServiceArgs(tokens) {
       switch (token) {
         case "--ns":
         case "--namespace":
-          namespace = requireValue5(rest, token);
+          namespace = requireValue6(rest, token);
           break;
         case "--from":
-          from = parseBareRenameId3(requireValue5(rest, token), "service");
+          from = parseBareRenameId3(requireValue6(rest, token), "service");
           break;
         case "--to":
-          to = parseBareRenameId3(requireValue5(rest, token), "service");
+          to = parseBareRenameId3(requireValue6(rest, token), "service");
           break;
         case "--base-url":
-          baseUrl = requireValue5(rest, token);
+          baseUrl = requireValue6(rest, token);
           break;
         case "--json":
           json = true;
@@ -22849,20 +23177,20 @@ function parseServiceArgs(tokens) {
       switch (token) {
         case "--ns":
         case "--namespace":
-          namespace = requireValue5(rest, token);
+          namespace = requireValue6(rest, token);
           break;
         case "--from":
-          from = parseBareRenameId3(requireValue5(rest, token), "service");
+          from = parseBareRenameId3(requireValue6(rest, token), "service");
           break;
         case "--to-ns":
         case "--target-namespace":
-          targetNamespace = requireValue5(rest, token);
+          targetNamespace = requireValue6(rest, token);
           break;
         case "--to":
-          to = parseBareRenameId3(requireValue5(rest, token), "service");
+          to = parseBareRenameId3(requireValue6(rest, token), "service");
           break;
         case "--base-url":
-          baseUrl = requireValue5(rest, token);
+          baseUrl = requireValue6(rest, token);
           break;
         case "--json":
           json = true;
@@ -22889,7 +23217,7 @@ function parseServiceArgs(tokens) {
   }
   throw new Error(`Unknown service action: ${action}`);
 }
-function requireValue5(tokens, optionName) {
+function requireValue6(tokens, optionName) {
   const value = tokens.shift();
   if (!value || value.startsWith("-")) {
     throw new Error(`Missing value for ${optionName}`);
@@ -22947,13 +23275,13 @@ function parseRoleArgs(tokens) {
       const token = rest.shift();
       switch (token) {
         case "--display-name":
-          displayName = requireValue6(rest, token);
+          displayName = requireValue7(rest, token);
           break;
         case "--description":
-          description = requireValue6(rest, token);
+          description = requireValue7(rest, token);
           break;
         case "--base-url":
-          baseUrl = requireValue6(rest, token);
+          baseUrl = requireValue7(rest, token);
           break;
         case "--json":
           json = true;
@@ -22980,7 +23308,7 @@ function takeSharedOptions3(rest, handlers) {
     const token = rest.shift();
     switch (token) {
       case "--base-url":
-        handlers.onBaseUrl(requireValue6(rest, token));
+        handlers.onBaseUrl(requireValue7(rest, token));
         break;
       case "--json":
         handlers.onJson();
@@ -22990,7 +23318,7 @@ function takeSharedOptions3(rest, handlers) {
     }
   }
 }
-function requireValue6(tokens, optionName) {
+function requireValue7(tokens, optionName) {
   const value = tokens.shift();
   if (!value || value.startsWith("-")) {
     throw new Error(`Missing value for ${optionName}`);
@@ -23017,17 +23345,17 @@ function parseAccountArgs(tokens) {
         case void 0:
           break;
         case "--account":
-          account2 = requireValue7(rest, token);
+          account2 = requireValue8(rest, token);
           break;
         case "--mobile":
-          mobile = requireValue7(rest, token);
+          mobile = requireValue8(rest, token);
           break;
         case "--nickname":
         case "--nickName":
-          nickName = requireValue7(rest, token);
+          nickName = requireValue8(rest, token);
           break;
         case "--base-url":
-          baseUrl2 = requireValue7(rest, token);
+          baseUrl2 = requireValue8(rest, token);
           break;
         case "--json":
           json2 = true;
@@ -23072,16 +23400,16 @@ function parseAccountArgs(tokens) {
     const token = rest.shift();
     switch (token) {
       case "--account":
-        account = requireValue7(rest, token);
+        account = requireValue8(rest, token);
         break;
       case "--namespace":
-        namespace = requireValue7(rest, token);
+        namespace = requireValue8(rest, token);
         break;
       case "--role":
-        role = requireValue7(rest, token);
+        role = requireValue8(rest, token);
         break;
       case "--base-url":
-        baseUrl = requireValue7(rest, token);
+        baseUrl = requireValue8(rest, token);
         break;
       case "--json":
         json = true;
@@ -23123,7 +23451,7 @@ function parseAccountArgs(tokens) {
   }
   throw new Error(`Unknown account role action: ${roleAction}`);
 }
-function requireValue7(tokens, optionName) {
+function requireValue8(tokens, optionName) {
   const value = tokens.shift();
   if (!value || value.startsWith("-")) {
     throw new Error(`Missing value for ${optionName}`);
@@ -23149,7 +23477,7 @@ function parseCollectArgs(tokens) {
     const token = rest.shift();
     switch (token) {
       case "--source": {
-        const value = requireValue8(rest, token);
+        const value = requireValue9(rest, token);
         if (value !== "cc" && value !== "yelling") {
           throw new Error(`Unsupported collect source: ${value}`);
         }
@@ -23157,7 +23485,7 @@ function parseCollectArgs(tokens) {
         break;
       }
       case "--endpoint":
-        options.endpoint = requireValue8(rest, token);
+        options.endpoint = requireValue9(rest, token);
         break;
       default:
         throw new Error(`Unknown collect option: ${token}`);
@@ -23173,7 +23501,7 @@ function parseCollectArgs(tokens) {
   }
   return { type: "collect" /* Collect */, ...options };
 }
-function requireValue8(tokens, optionName) {
+function requireValue9(tokens, optionName) {
   const value = tokens.shift();
   if (!value) {
     throw new Error(`Missing value for ${optionName}`);
@@ -23183,7 +23511,7 @@ function requireValue8(tokens, optionName) {
 
 // src/index.ts
 var pkg = JSON.parse(
-  (0, import_node_fs17.readFileSync)(import_node_path22.default.resolve(__dirname, "..", "package.json"), "utf8")
+  (0, import_node_fs18.readFileSync)(import_node_path23.default.resolve(__dirname, "..", "package.json"), "utf8")
 );
 var HELP_TEXT = [
   import_chalk4.default.bold(`pmate v${pkg.version}`),
@@ -23275,6 +23603,14 @@ var HELP_TEXT = [
   `  ${import_chalk4.default.gray("                  call <ns:objectId> [--payload <json>] [--file <path>] [--base-url <url>] [--hub-base-url <url>] [--from <id>] [--json]")}`,
   `  ${import_chalk4.default.gray("                  delete <ns:objectId> [--base-url <url>] [--json]")}`,
   `  ${import_chalk4.default.gray("                  list defaults to all namespaces; create defaults to namespace: pmate; default base URL: https://agent-api.pmate.chat; call uses pmate:cli session and default hub: https://hub.pmate.chat")}`,
+  `  ${import_chalk4.default.cyan("runner")}           Manage runner registry entries via agent-api`,
+  `  ${import_chalk4.default.gray("                  list [--namespace <ns>] [--base-url <url>] [--json]")}`,
+  `  ${import_chalk4.default.gray("                  get <ns:objectId> [--base-url <url>] [--json]")}`,
+  `  ${import_chalk4.default.gray("                  view <ns:objectId> [--base-url <url>]")}`,
+  `  ${import_chalk4.default.gray("                  create [<namespace>] --file <path> [--base-url <url>] [--json]")}`,
+  `  ${import_chalk4.default.gray("                  update <ns:objectId> --file <path> [--base-url <url>] [--json]")}`,
+  `  ${import_chalk4.default.gray("                  delete <ns:objectId> [--base-url <url>] [--json]")}`,
+  `  ${import_chalk4.default.gray("                  list defaults to all namespaces; create defaults to namespace: pmate; default base URL: https://agent-api.pmate.chat")}`,
   `  ${import_chalk4.default.cyan("ns")}               Manage registered namespaces`,
   `  ${import_chalk4.default.gray("                  list [--chain <chain>] [--base-url <url>] [--json]")}`,
   `  ${import_chalk4.default.gray("                  get <namespace> [--chain <chain>] [--base-url <url>] [--json]")}`,
@@ -23377,7 +23713,7 @@ function parseCommandArgs(args) {
       const token = rest.shift();
       switch (token) {
         case "--app":
-          app = requireValue9(rest, token);
+          app = requireValue10(rest, token);
           break;
         default:
           throw new Error(`Unknown login option: ${token}`);
@@ -23439,6 +23775,9 @@ function parseCommandArgs(args) {
   if (args.rest[0] === "agent") {
     return parseAgentArgs(args.rest.slice(1));
   }
+  if (args.rest[0] === "runner") {
+    return parseRunnerArgs(args.rest.slice(1));
+  }
   if (args.rest[0] === "ns" || args.rest[0] === "namespace") {
     return parseNsArgs(args.rest.slice(1));
   }
@@ -23474,7 +23813,7 @@ function parseVercelArgs(tokens) {
       const token = rest.shift();
       switch (token) {
         case "--scope":
-          scope = requireValue9(rest, token);
+          scope = requireValue10(rest, token);
           break;
         default:
           throw new Error(`Unknown vercel option: ${token}`);
@@ -23494,10 +23833,10 @@ function parseVercelArgs(tokens) {
       const token = rest.shift();
       switch (token) {
         case "--scope":
-          scope = requireValue9(rest, token);
+          scope = requireValue10(rest, token);
           break;
         case "--project":
-          project = requireValue9(rest, token);
+          project = requireValue10(rest, token);
           break;
         case "--last-week":
           lastWeek = true;
@@ -23528,16 +23867,16 @@ function parseAddDnsArgs(tokens) {
     const token = rest.shift();
     switch (token) {
       case "--type":
-        options.dnsType = requireValue9(rest, token);
+        options.dnsType = requireValue10(rest, token);
         break;
       case "--value":
-        options.dnsValue = requireValue9(rest, token);
+        options.dnsValue = requireValue10(rest, token);
         break;
       case "--rr":
-        options.dnsRr = requireValue9(rest, token);
+        options.dnsRr = requireValue10(rest, token);
         break;
       case "--ttl": {
-        const ttlValue = requireValue9(rest, token);
+        const ttlValue = requireValue10(rest, token);
         const ttl = Number.parseInt(ttlValue, 10);
         if (!Number.isFinite(ttl) || ttl <= 0) {
           throw new Error(`Invalid --ttl value: ${ttlValue}`);
@@ -23546,7 +23885,7 @@ function parseAddDnsArgs(tokens) {
         break;
       }
       case "--domain":
-        options.dnsDomain = requireValue9(rest, token);
+        options.dnsDomain = requireValue10(rest, token);
         break;
       default:
         throw new Error(`Unknown add-dns option: ${token}`);
@@ -23579,13 +23918,13 @@ function parseBucketArgs(tokens) {
         options.bucketCreate = true;
         break;
       case "--name":
-        options.bucketName = requireValue9(rest, token);
+        options.bucketName = requireValue10(rest, token);
         break;
       case "--subdomain":
-        options.bucketSubdomain = requireValue9(rest, token);
+        options.bucketSubdomain = requireValue10(rest, token);
         break;
       case "--domain":
-        options.bucketDomain = requireValue9(rest, token);
+        options.bucketDomain = requireValue10(rest, token);
         break;
       default:
         throw new Error(`Unknown bucket option: ${token}`);
@@ -23617,7 +23956,7 @@ function parseDevArgs(tokens) {
     const token = rest.shift();
     switch (token) {
       case "--cwd":
-        options.devCwd = requireValue9(rest, token);
+        options.devCwd = requireValue10(rest, token);
         break;
       default:
         throw new Error(`Unknown dev option: ${token}`);
@@ -23637,7 +23976,7 @@ function parseDeleteArgs(tokens) {
     const token = rest.shift();
     switch (token) {
       case "--cwd":
-        deleteCwd = requireValue9(rest, token);
+        deleteCwd = requireValue10(rest, token);
         break;
       default:
         throw new Error(`Unknown delete option: ${token}`);
@@ -23671,13 +24010,13 @@ function parseOssArgs(tokens) {
     const token = rest.shift();
     switch (token) {
       case "--bucket":
-        bucket = requireValue9(rest, token);
+        bucket = requireValue10(rest, token);
         break;
       case "--file":
-        filePath = requireValue9(rest, token);
+        filePath = requireValue10(rest, token);
         break;
       case "--key":
-        objectKey = requireValue9(rest, token);
+        objectKey = requireValue10(rest, token);
         break;
       default:
         throw new Error(`Unknown oss option: ${token}`);
@@ -23710,7 +24049,7 @@ function parseEnvArgs(tokens) {
           throw new Error("Only one env action is allowed.");
         }
         action = "set";
-        key = requireValue9(rest, token);
+        key = requireValue10(rest, token);
         break;
       case "--list":
         if (action) {
@@ -23723,17 +24062,17 @@ function parseEnvArgs(tokens) {
           throw new Error("Only one env action is allowed.");
         }
         action = "delete";
-        key = requireValue9(rest, token);
+        key = requireValue10(rest, token);
         break;
       case "--value":
-        value = requireValue9(rest, token);
+        value = requireValue10(rest, token);
         break;
       case "--verbose":
       case "-v":
         verbose = true;
         break;
       case "--cwd":
-        cwd = requireValue9(rest, token);
+        cwd = requireValue10(rest, token);
         break;
       default:
         throw new Error(`Unknown env option: ${token}`);
@@ -23791,7 +24130,7 @@ function parseCommitArgs(tokens) {
         push = true;
         break;
       case "--cwd":
-        cwd = requireValue9(rest, token);
+        cwd = requireValue10(rest, token);
         break;
       default:
         throw new Error(`Unknown commit option: ${token}`);
@@ -23807,10 +24146,10 @@ function parseSummaryArgs(tokens) {
     const token = rest.shift();
     switch (token) {
       case "--pr":
-        prRef = requireValue9(rest, token);
+        prRef = requireValue10(rest, token);
         break;
       case "--cwd":
-        cwd = requireValue9(rest, token);
+        cwd = requireValue10(rest, token);
         break;
       default:
         throw new Error(`Unknown summary option: ${token}`);
@@ -23835,13 +24174,13 @@ function parseQuizArgs(tokens) {
       const token = rest.shift();
       switch (token) {
         case "--paper-id":
-          paperId = requireValue9(rest, token);
+          paperId = requireValue10(rest, token);
           break;
         case "--base-url":
-          apiBaseUrl = requireValue9(rest, token);
+          apiBaseUrl = requireValue10(rest, token);
           break;
         case "--link-base":
-          linkBaseUrl = requireValue9(rest, token);
+          linkBaseUrl = requireValue10(rest, token);
           break;
         default:
           throw new Error(`Unknown quiz create-draft option: ${token}`);
@@ -23867,16 +24206,16 @@ function parseQuizArgs(tokens) {
       const token = rest.shift();
       switch (token) {
         case "--paper-id":
-          paperId = requireValue9(rest, token);
+          paperId = requireValue10(rest, token);
           break;
         case "--file":
-          filePath = requireValue9(rest, token);
+          filePath = requireValue10(rest, token);
           break;
         case "--base-url":
-          apiBaseUrl = requireValue9(rest, token);
+          apiBaseUrl = requireValue10(rest, token);
           break;
         case "--link-base":
-          linkBaseUrl = requireValue9(rest, token);
+          linkBaseUrl = requireValue10(rest, token);
           break;
         default:
           throw new Error(`Unknown quiz update-meta option: ${token}`);
@@ -23906,16 +24245,16 @@ function parseQuizArgs(tokens) {
       const token = rest.shift();
       switch (token) {
         case "--paper-id":
-          paperId = requireValue9(rest, token);
+          paperId = requireValue10(rest, token);
           break;
         case "--file":
-          filePath = requireValue9(rest, token);
+          filePath = requireValue10(rest, token);
           break;
         case "--base-url":
-          apiBaseUrl = requireValue9(rest, token);
+          apiBaseUrl = requireValue10(rest, token);
           break;
         case "--link-base":
-          linkBaseUrl = requireValue9(rest, token);
+          linkBaseUrl = requireValue10(rest, token);
           break;
         default:
           throw new Error(`Unknown quiz append-step option: ${token}`);
@@ -23946,19 +24285,19 @@ function parseQuizArgs(tokens) {
       const token = rest.shift();
       switch (token) {
         case "--paper-id":
-          paperId = requireValue9(rest, token);
+          paperId = requireValue10(rest, token);
           break;
         case "--step-id":
-          stepId = requireValue9(rest, token);
+          stepId = requireValue10(rest, token);
           break;
         case "--file":
-          filePath = requireValue9(rest, token);
+          filePath = requireValue10(rest, token);
           break;
         case "--base-url":
-          apiBaseUrl = requireValue9(rest, token);
+          apiBaseUrl = requireValue10(rest, token);
           break;
         case "--link-base":
-          linkBaseUrl = requireValue9(rest, token);
+          linkBaseUrl = requireValue10(rest, token);
           break;
         default:
           throw new Error(`Unknown quiz update-step option: ${token}`);
@@ -23992,16 +24331,16 @@ function parseQuizArgs(tokens) {
       const token = rest.shift();
       switch (token) {
         case "--paper-id":
-          paperId = requireValue9(rest, token);
+          paperId = requireValue10(rest, token);
           break;
         case "--step-ids":
-          stepIdsRaw = requireValue9(rest, token);
+          stepIdsRaw = requireValue10(rest, token);
           break;
         case "--base-url":
-          apiBaseUrl = requireValue9(rest, token);
+          apiBaseUrl = requireValue10(rest, token);
           break;
         case "--link-base":
-          linkBaseUrl = requireValue9(rest, token);
+          linkBaseUrl = requireValue10(rest, token);
           break;
         default:
           throw new Error(`Unknown quiz reorder option: ${token}`);
@@ -24034,13 +24373,13 @@ function parseQuizArgs(tokens) {
       const token = rest.shift();
       switch (token) {
         case "--paper-id":
-          paperId = requireValue9(rest, token);
+          paperId = requireValue10(rest, token);
           break;
         case "--base-url":
-          apiBaseUrl = requireValue9(rest, token);
+          apiBaseUrl = requireValue10(rest, token);
           break;
         case "--link-base":
-          linkBaseUrl = requireValue9(rest, token);
+          linkBaseUrl = requireValue10(rest, token);
           break;
         default:
           throw new Error(`Unknown quiz activate option: ${token}`);
@@ -24065,13 +24404,13 @@ function parseQuizArgs(tokens) {
       const token = rest.shift();
       switch (token) {
         case "--paper-id":
-          paperId = requireValue9(rest, token);
+          paperId = requireValue10(rest, token);
           break;
         case "--base-url":
-          apiBaseUrl = requireValue9(rest, token);
+          apiBaseUrl = requireValue10(rest, token);
           break;
         case "--link-base":
-          linkBaseUrl = requireValue9(rest, token);
+          linkBaseUrl = requireValue10(rest, token);
           break;
         default:
           throw new Error(`Unknown quiz view option: ${token}`);
@@ -24100,22 +24439,22 @@ function parseQuizArgs(tokens) {
       const token = rest.shift();
       switch (token) {
         case "--paper-id":
-          paperId = requireValue9(rest, token);
+          paperId = requireValue10(rest, token);
           break;
         case "--step-id":
-          stepId = requireValue9(rest, token);
+          stepId = requireValue10(rest, token);
           break;
         case "--file":
-          filePath = requireValue9(rest, token);
+          filePath = requireValue10(rest, token);
           break;
         case "--new-paper-id":
-          newPaperId = requireValue9(rest, token);
+          newPaperId = requireValue10(rest, token);
           break;
         case "--base-url":
-          apiBaseUrl = requireValue9(rest, token);
+          apiBaseUrl = requireValue10(rest, token);
           break;
         case "--link-base":
-          linkBaseUrl = requireValue9(rest, token);
+          linkBaseUrl = requireValue10(rest, token);
           break;
         case "--activate":
           activate = true;
@@ -24205,10 +24544,10 @@ function parseLinearPrArgs(tokens) {
     const token = rest.shift();
     switch (token) {
       case "--account":
-        account = requireValue9(rest, token);
+        account = requireValue10(rest, token);
         break;
       case "--cwd":
-        cwd = requireValue9(rest, token);
+        cwd = requireValue10(rest, token);
         break;
       default:
         throw new Error(`Unknown linear option: ${token}`);
@@ -24237,35 +24576,35 @@ function parseLinearCreateArgs(tokens) {
     const token = rest.shift();
     switch (token) {
       case "--account":
-        account = requireValue9(rest, token);
+        account = requireValue10(rest, token);
         break;
       case "--repl":
         useRepl = true;
         break;
       case "--title":
-        title = requireValue9(rest, token);
+        title = requireValue10(rest, token);
         break;
       case "--desc":
       case "--description":
-        description = decodeEscapedNewlines(requireValue9(rest, token));
+        description = decodeEscapedNewlines(requireValue10(rest, token));
         break;
       case "--team-id":
-        teamId = requireValue9(rest, token);
+        teamId = requireValue10(rest, token);
         break;
       case "--team-key":
-        teamKey = requireValue9(rest, token);
+        teamKey = requireValue10(rest, token);
         break;
       case "--priority":
-        priority = parseLinearPriority(requireValue9(rest, token));
+        priority = parseLinearPriority(requireValue10(rest, token));
         break;
       case "--parent-id":
-        parentId = requireValue9(rest, token);
+        parentId = requireValue10(rest, token);
         break;
       case "--state-id":
-        stateId = requireValue9(rest, token);
+        stateId = requireValue10(rest, token);
         break;
       case "--cwd":
-        cwd = requireValue9(rest, token);
+        cwd = requireValue10(rest, token);
         break;
       default:
         throw new Error(`Unknown linear option: ${token}`);
@@ -24300,10 +24639,10 @@ function parseLinearWhoamiArgs(tokens) {
     const token = rest.shift();
     switch (token) {
       case "--account":
-        account = requireValue9(rest, token);
+        account = requireValue10(rest, token);
         break;
       case "--cwd":
-        cwd = requireValue9(rest, token);
+        cwd = requireValue10(rest, token);
         break;
       default:
         throw new Error(`Unknown linear option: ${token}`);
@@ -24328,10 +24667,10 @@ function parseLinearViewArgs(tokens) {
     const token = rest.shift();
     switch (token) {
       case "--account":
-        account = requireValue9(rest, token);
+        account = requireValue10(rest, token);
         break;
       case "--cwd":
-        cwd = requireValue9(rest, token);
+        cwd = requireValue10(rest, token);
         break;
       default:
         throw new Error(`Unknown linear option: ${token}`);
@@ -24366,32 +24705,32 @@ function parseLinearUpdateArgs(tokens) {
     const token = rest.shift();
     switch (token) {
       case "--account":
-        account = requireValue9(rest, token);
+        account = requireValue10(rest, token);
         break;
       case "--title":
-        title = requireValue9(rest, token);
+        title = requireValue10(rest, token);
         break;
       case "--desc":
       case "--description":
-        description = decodeEscapedNewlines(requireValue9(rest, token));
+        description = decodeEscapedNewlines(requireValue10(rest, token));
         break;
       case "--team-id":
-        teamId = requireValue9(rest, token);
+        teamId = requireValue10(rest, token);
         break;
       case "--team-key":
-        teamKey = requireValue9(rest, token);
+        teamKey = requireValue10(rest, token);
         break;
       case "--priority":
-        priority = parseLinearPriority(requireValue9(rest, token));
+        priority = parseLinearPriority(requireValue10(rest, token));
         break;
       case "--parent-id":
-        parentId = requireValue9(rest, token);
+        parentId = requireValue10(rest, token);
         break;
       case "--state-id":
-        stateId = requireValue9(rest, token);
+        stateId = requireValue10(rest, token);
         break;
       case "--cwd":
-        cwd = requireValue9(rest, token);
+        cwd = requireValue10(rest, token);
         break;
       default:
         throw new Error(`Unknown linear option: ${token}`);
@@ -24429,10 +24768,10 @@ function parseLinearSubIssuesArgs(tokens) {
     const token = rest.shift();
     switch (token) {
       case "--account":
-        account = requireValue9(rest, token);
+        account = requireValue10(rest, token);
         break;
       case "--cwd":
-        cwd = requireValue9(rest, token);
+        cwd = requireValue10(rest, token);
         break;
       default:
         throw new Error(`Unknown linear option: ${token}`);
@@ -24459,15 +24798,15 @@ function parseLinearCommentArgs(tokens) {
     const token = rest.shift();
     switch (token) {
       case "--account":
-        account = requireValue9(rest, token);
+        account = requireValue10(rest, token);
         break;
       case "--body":
       case "--desc":
       case "--description":
-        body = decodeEscapedNewlines(requireValue9(rest, token));
+        body = decodeEscapedNewlines(requireValue10(rest, token));
         break;
       case "--cwd":
-        cwd = requireValue9(rest, token);
+        cwd = requireValue10(rest, token);
         break;
       default:
         throw new Error(`Unknown linear option: ${token}`);
@@ -24497,10 +24836,10 @@ function parseLinearCommentsArgs(tokens) {
     const token = rest.shift();
     switch (token) {
       case "--account":
-        account = requireValue9(rest, token);
+        account = requireValue10(rest, token);
         break;
       case "--cwd":
-        cwd = requireValue9(rest, token);
+        cwd = requireValue10(rest, token);
         break;
       default:
         throw new Error(`Unknown linear option: ${token}`);
@@ -24524,16 +24863,16 @@ function parseLinearCycleArgs(tokens) {
     const token = rest.shift();
     switch (token) {
       case "--account":
-        account = requireValue9(rest, token);
+        account = requireValue10(rest, token);
         break;
       case "--team-id":
-        teamId = requireValue9(rest, token);
+        teamId = requireValue10(rest, token);
         break;
       case "--team-key":
-        teamKey = requireValue9(rest, token);
+        teamKey = requireValue10(rest, token);
         break;
       case "--cwd":
-        cwd = requireValue9(rest, token);
+        cwd = requireValue10(rest, token);
         break;
       default:
         throw new Error(`Unknown linear option: ${token}`);
@@ -24556,10 +24895,10 @@ function parseLinearTeamsArgs(tokens) {
     const token = rest.shift();
     switch (token) {
       case "--account":
-        account = requireValue9(rest, token);
+        account = requireValue10(rest, token);
         break;
       case "--cwd":
-        cwd = requireValue9(rest, token);
+        cwd = requireValue10(rest, token);
         break;
       default:
         throw new Error(`Unknown linear option: ${token}`);
@@ -24586,16 +24925,16 @@ function parseLinearUserIssuesArgs(tokens) {
     const token = rest.shift();
     switch (token) {
       case "--account":
-        account = requireValue9(rest, token);
+        account = requireValue10(rest, token);
         break;
       case "--cycle":
-        cycle = parseLinearCycle(requireValue9(rest, token));
+        cycle = parseLinearCycle(requireValue10(rest, token));
         break;
       case "--status":
-        status = parseLinearStatus(requireValue9(rest, token));
+        status = parseLinearStatus(requireValue10(rest, token));
         break;
       case "--cwd":
-        cwd = requireValue9(rest, token);
+        cwd = requireValue10(rest, token);
         break;
       default:
         throw new Error(`Unknown linear option: ${token}`);
@@ -24629,28 +24968,28 @@ function parseLinearIssuesArgs(tokens) {
     const token = rest.shift();
     switch (token) {
       case "--account":
-        account = requireValue9(rest, token);
+        account = requireValue10(rest, token);
         break;
       case "--team-id":
-        teamId = requireValue9(rest, token);
+        teamId = requireValue10(rest, token);
         break;
       case "--team-key":
-        teamKey = requireValue9(rest, token);
+        teamKey = requireValue10(rest, token);
         break;
       case "--user":
-        user = requireValue9(rest, token);
+        user = requireValue10(rest, token);
         break;
       case "--cycle":
-        cycle = parseLinearCycle(requireValue9(rest, token));
+        cycle = parseLinearCycle(requireValue10(rest, token));
         break;
       case "--status":
-        status = parseLinearStatus(requireValue9(rest, token));
+        status = parseLinearStatus(requireValue10(rest, token));
         break;
       case "--query":
-        query = requireValue9(rest, token).trim();
+        query = requireValue10(rest, token).trim();
         break;
       case "--limit": {
-        const value = Number.parseInt(requireValue9(rest, token), 10);
+        const value = Number.parseInt(requireValue10(rest, token), 10);
         if (!Number.isInteger(value) || value < 1 || value > 250) {
           throw new Error("Invalid --limit. Expected an integer between 1 and 250.");
         }
@@ -24658,7 +24997,7 @@ function parseLinearIssuesArgs(tokens) {
         break;
       }
       case "--cwd":
-        cwd = requireValue9(rest, token);
+        cwd = requireValue10(rest, token);
         break;
       default:
         throw new Error(`Unknown linear option: ${token}`);
@@ -24699,10 +25038,10 @@ function parseLinearLegacyArgs(tokens) {
         useScreenshot = true;
         break;
       case "--account":
-        account = requireValue9(rest, token);
+        account = requireValue10(rest, token);
         break;
       case "--cwd":
-        cwd = requireValue9(rest, token);
+        cwd = requireValue10(rest, token);
         break;
       default:
         throw new Error(`Unknown linear option: ${token}`);
@@ -24796,19 +25135,19 @@ function parseNotionArgs(tokens) {
       const token = rest.shift();
       switch (token) {
         case "--parent":
-          parentPageId = requireValue9(rest, token);
+          parentPageId = requireValue10(rest, token);
           break;
         case "--title":
-          title = requireValue9(rest, token);
+          title = requireValue10(rest, token);
           break;
         case "--private":
           isPrivate = true;
           break;
         case "--content":
-          content2 = requireValue9(rest, token);
+          content2 = requireValue10(rest, token);
           break;
         case "--file":
-          filePath2 = requireValue9(rest, token);
+          filePath2 = requireValue10(rest, token);
           break;
         default:
           throw new Error(`Unknown notion option: ${token}`);
@@ -24852,10 +25191,10 @@ function parseNotionArgs(tokens) {
     const token = rest.shift();
     switch (token) {
       case "--content":
-        content = requireValue9(rest, token);
+        content = requireValue10(rest, token);
         break;
       case "--file":
-        filePath = requireValue9(rest, token);
+        filePath = requireValue10(rest, token);
         break;
       case "--append":
         append = true;
@@ -24900,11 +25239,11 @@ function parseRandomArgs(tokens) {
         mode = "easy";
         break;
       case "--length":
-        length = parsePositiveInt(requireValue9(rest, token), token);
+        length = parsePositiveInt(requireValue10(rest, token), token);
         seenLength = true;
         break;
       case "--charset": {
-        const value = requireValue9(rest, token);
+        const value = requireValue10(rest, token);
         if (!["base64url", "hex", "alnum", "ascii"].includes(value)) {
           throw new Error(
             `Invalid --charset value: ${value}. Use base64url|hex|alnum|ascii.`
@@ -24915,18 +25254,18 @@ function parseRandomArgs(tokens) {
         break;
       }
       case "--count":
-        count = parsePositiveInt(requireValue9(rest, token), token);
+        count = parsePositiveInt(requireValue10(rest, token), token);
         break;
       case "--words":
-        words = parsePositiveInt(requireValue9(rest, token), token);
+        words = parsePositiveInt(requireValue10(rest, token), token);
         seenWords = true;
         break;
       case "--digits":
-        digits = parseNonNegativeInt(requireValue9(rest, token), token);
+        digits = parseNonNegativeInt(requireValue10(rest, token), token);
         seenDigits = true;
         break;
       case "--separator":
-        separator = requireValue9(rest, token);
+        separator = requireValue10(rest, token);
         seenSeparator = true;
         break;
       default:
@@ -24957,7 +25296,7 @@ function parseRandomArgs(tokens) {
     count
   };
 }
-function requireValue9(tokens, optionName) {
+function requireValue10(tokens, optionName) {
   const value = tokens.shift();
   if (!value) {
     throw new Error(`Missing value for ${optionName}`);
@@ -25093,6 +25432,11 @@ async function main() {
         await handler.handle(commandArgs);
         return;
       }
+      case "runner" /* Runner */: {
+        const handler = new RunnerCommandHandler();
+        await handler.handle(commandArgs);
+        return;
+      }
       case "ns" /* Ns */: {
         const handler = new NsCommandHandler();
         await handler.handle(commandArgs);