@downcity/city 1.1.39 → 1.1.47

package/src/platform/store/schema.ts

@@ -48,8 +48,8 @@ export const modelsTable = sqliteTable(
  * 平台 Env 统一存储表。
  *
  * 关键点（中文）
- * - 全局 env 与 agent env 共用一张表，通过 `scope` + `agentId` 区分。
- * - `agentId` 在 `scope=global` 时固定为空字符串，避免 SQLite 复合主键中的 NULL 语义问题。
+ * - 当前只保留平台全局 env。
+ * - 仍使用 `scope + agent_id + key` 复合主键，其中运行时固定写入 `global + ''`。
  * - value 采用密文存储，解密仅在运行时内存中进行。
  */
 export const envEntriesTable = sqliteTable(

package/src/process/daemon/Api.ts

@@ -39,7 +39,7 @@ export type DaemonJsonApiCallParams = {
    * 单次调用超时（毫秒）。
    *
    * 说明（中文）
-   * - 仅本地 IPC transport 当前会消费该参数。
+   * - 当前 HTTP daemon client 会消费该参数。
    * - 用于 `session execute`、`plugin command` 这类可能持续几十秒的请求，
    *   避免被默认短超时误判成“Agent server 未启动”。
    */

package/src/process/daemon/CliArgs.ts

@@ -4,6 +4,7 @@
  * 关键点
  * - daemon（来自 `agent start` / `agent restart`）会拉起一个前台 `agent start`
  *   进程（显式 `--foreground true`），这里负责拼装其 argv。
+ * - city 托管的 HTTP gateway 与 agent 本机 RPC 使用不同端口，避免职责混用。
  */
 
 import type { StartOptions } from "@downcity/agent";
@@ -26,13 +27,35 @@ export const buildRunArgsFromOptions = async (
   // 关键点（中文）：host 未指定时统一落到 0.0.0.0，保持历史监听行为。
   const host = String(options.host || "0.0.0.0").trim() || "0.0.0.0";
 
-  // 关键点（中文）：agent 端口统一由 console 分配，不接受命令行显式覆盖。
+  // 关键点（中文）：外层 HTTP gateway 端口统一由 city 分配。
   const port = await allocateAvailablePort({ host });
   if (!Number.isFinite(port) || Number.isNaN(port) || port <= 0 || port > 65535) {
     throw new Error(`Invalid allocated port: ${String(port)}`);
   }
 
+  // 关键点（中文）：本机 RPC 端口独立分配到另一段端口区间，避免和 HTTP gateway 冲突。
+  const rpc_port =
+    typeof options.rpcPort === "number" && Number.isInteger(options.rpcPort)
+      ? options.rpcPort
+      : await allocateAvailablePort({
+          host: "127.0.0.1",
+          start: 15314,
+          end: 16399,
+        });
+  if (
+    !Number.isFinite(rpc_port) ||
+    Number.isNaN(rpc_port) ||
+    rpc_port <= 0 ||
+    rpc_port > 65535
+  ) {
+    throw new Error(`Invalid allocated rpc port: ${String(rpc_port)}`);
+  }
+  if (rpc_port === port) {
+    throw new Error(`HTTP port and RPC port must be different: ${port}`);
+  }
+
   args.push("--port", String(port));
+  args.push("--rpc-port", String(rpc_port));
   args.push("--host", host);
 
   return args;

package/src/process/daemon/Client.ts

@@ -3,7 +3,7 @@
  *
  * 关键点（中文）
  * - 业务模块统一通过 daemon API 与运行时通信。
- * - 地址解析优先级：CLI 参数 > 环境变量 > daemon meta > 默认值。
+ * - HTTP gateway 与本机 RPC 的地址解析分开，避免端口语义混淆。
  */
 
 import fs from "fs-extra";
@@ -62,29 +62,27 @@ function pickArgValue(args: string[], key: string): string | undefined {
   return next || undefined;
 }
 
-/**
- * 解析 daemon endpoint。
- *
- * 优先级（中文）
- * 1) 显式入参 `host/port`
- * 2) 环境变量 `DC_SERVER_*` / `DC_CTX_SERVER_*`
- * 3) daemon meta args（`downcity.daemon.json`）
- * 4) 默认 `127.0.0.1:5314`
- */
-export function resolveDaemonEndpoint(params: {
+type ResolveDaemonEndpointParams = {
   projectRoot: string;
   host?: string;
   port?: number;
+};
+
+function resolveDaemonEndpointFromSources(params: {
+  projectRoot: string;
+  explicit_host?: string;
+  explicit_port?: number;
+  env_host_name: string;
+  env_port_name: string;
+  arg_port_name: string;
+  default_host: string;
+  default_port: number;
 }): DaemonEndpoint {
-  const explicitHost = normalizeHost(params.host);
-  const explicitPort = parsePortLike(params.port);
+  const explicitHost = normalizeHost(params.explicit_host);
+  const explicitPort = parsePortLike(params.explicit_port);
 
-  const envHost =
-    normalizeHost(process.env.DC_SERVER_HOST) ||
-    normalizeHost(process.env.DC_CTX_SERVER_HOST);
-  const envPort =
-    parsePortLike(process.env.DC_SERVER_PORT) ||
-    parsePortLike(process.env.DC_CTX_SERVER_PORT);
+  const envHost = normalizeHost(process.env[params.env_host_name]);
+  const envPort = parsePortLike(process.env[params.env_port_name]);
 
   let daemonArgHost: string | undefined;
   let daemonArgPort: number | undefined;
@@ -96,14 +94,14 @@ export function resolveDaemonEndpoint(params: {
         ? raw.args.map((item) => String(item))
         : [];
       daemonArgHost = normalizeHost(pickArgValue(args, "--host"));
-      daemonArgPort = parsePortLike(pickArgValue(args, "--port"));
+      daemonArgPort = parsePortLike(pickArgValue(args, params.arg_port_name));
     }
   } catch {
     // ignore daemon meta errors, fallback to other sources
   }
 
-  const host = explicitHost || envHost || daemonArgHost || "127.0.0.1";
-  const port = explicitPort || envPort || daemonArgPort || 5314;
+  const host = explicitHost || envHost || daemonArgHost || params.default_host;
+  const port = explicitPort || envPort || daemonArgPort || params.default_port;
 
   return {
     host,
@@ -112,6 +110,56 @@ export function resolveDaemonEndpoint(params: {
   };
 }
 
+/**
+ * 解析 daemon endpoint。
+ *
+ * 优先级（中文）
+ * 1) 显式入参 `host/port`
+ * 2) 环境变量 `DC_CITY_HOST/DC_CITY_PORT`
+ * 3) daemon meta args（`downcity.daemon.json`）
+ * 4) 默认 `127.0.0.1:5314`
+ */
+export function resolveDaemonEndpoint(params: {
+  projectRoot: string;
+  host?: string;
+  port?: number;
+}): DaemonEndpoint {
+  return resolveDaemonEndpointFromSources({
+    projectRoot: params.projectRoot,
+    explicit_host: params.host,
+    explicit_port: params.port,
+    env_host_name: "DC_CITY_HOST",
+    env_port_name: "DC_CITY_PORT",
+    arg_port_name: "--port",
+    default_host: "127.0.0.1",
+    default_port: 5314,
+  });
+}
+
+/**
+ * 解析 daemon 本机 RPC endpoint。
+ *
+ * 优先级（中文）
+ * 1) 显式入参 `host/port`
+ * 2) 环境变量 `DC_AGENT_RPC_HOST/DC_AGENT_RPC_PORT`
+ * 3) daemon meta args（`downcity.daemon.json`）
+ * 4) 默认 `127.0.0.1:15314`
+ */
+export function resolveDaemonRpcEndpoint(
+  params: ResolveDaemonEndpointParams,
+): DaemonEndpoint {
+  return resolveDaemonEndpointFromSources({
+    projectRoot: params.projectRoot,
+    explicit_host: params.host,
+    explicit_port: params.port,
+    env_host_name: "DC_AGENT_RPC_HOST",
+    env_port_name: "DC_AGENT_RPC_PORT",
+    arg_port_name: "--rpc-port",
+    default_host: "127.0.0.1",
+    default_port: 15314,
+  });
+}
+
 /**
  * 调用 daemon JSON API。
  *
@@ -132,6 +180,12 @@ export async function callServer<T>(
   const method = params.method || "GET";
   const hasBody = params.body !== undefined && method !== "GET";
   const headers: Record<string, string> = {};
+  const timeoutMs =
+    typeof params.timeoutMs === "number" &&
+    Number.isFinite(params.timeoutMs) &&
+    params.timeoutMs > 0
+      ? Math.floor(params.timeoutMs)
+      : undefined;
   const authHeaderValue = formatCliBearerHeaderValue(
     resolveCliAuthToken({
       explicitToken: params.authToken,
@@ -145,11 +199,19 @@ export async function callServer<T>(
   }
 
   try {
+    const abortController = timeoutMs ? new AbortController() : undefined;
+    const timeoutHandle = timeoutMs
+      ? setTimeout(() => abortController?.abort(), timeoutMs)
+      : undefined;
     const response = await fetch(url, {
       method,
       headers: Object.keys(headers).length > 0 ? headers : undefined,
       body: hasBody ? JSON.stringify(params.body) : undefined,
+      signal: abortController?.signal,
     });
+    if (timeoutHandle) {
+      clearTimeout(timeoutHandle);
+    }
 
     let data: JsonValue | null = null;
     try {
@@ -174,6 +236,12 @@ export async function callServer<T>(
       data: data as T,
     };
   } catch (error) {
+    if (timeoutMs && error instanceof Error && error.name === "AbortError") {
+      return {
+        success: false,
+        error: `Failed to call ${url}: timeout after ${timeoutMs}ms`,
+      };
+    }
     return {
       success: false,
       error: `Failed to call ${url}: ${String(error)}`,

package/src/process/daemon/Manager.ts

@@ -28,6 +28,7 @@ import {
   upsertManagedAgentEntry,
 } from "@/process/registry/CityRegistry.js";
 import { signalDetachedProcess } from "@/process/registry/ProcessSweep.js";
+import { mergeProcessEnvWithPlatformGlobalEnv } from "@/env/ProcessEnv.js";
 
 /**
  * 异步睡眠工具。
@@ -239,7 +240,7 @@ export const startDaemonProcess = async (params: {
   const logFd = fs.openSync(logPath, "a");
 
   const childEnv: NodeJS.ProcessEnv = {
-    ...process.env,
+    ...mergeProcessEnvWithPlatformGlobalEnv(process.env),
     DOWNCITY_DAEMON: "1",
   };
 

package/src/terminal/admin/auth-error.ts

@@ -0,0 +1,62 @@
+/**
+ * Admin 鉴权错误工具。
+ *
+ * 关键说明（中文）
+ * - 当 admin key 不正确或已失效时，SDK 会把请求失败包装成带 `status` 的 Error。
+ * - 这里统一把 401 转成可识别的 AdminAuthError，方便外层清理缓存 session 并提示重新输入。
+ */
+
+/**
+ * admin key 无效时给用户展示的统一提示。
+ */
+export const ADMIN_AUTH_INVALID_MESSAGE =
+  "Current server admin key is incorrect or expired. Please set it again.";
+
+interface HttpClientError extends Error {
+  /** HTTP 状态码 */
+  status?: number;
+}
+
+/**
+ * 判断服务端是否缺少新接口。
+ */
+export function isAdminNotFoundError(error: unknown): boolean {
+  return (error as HttpClientError | undefined)?.status === 404;
+}
+
+/**
+ * admin 鉴权失效错误。
+ */
+export class AdminAuthError extends Error {
+  constructor(message = ADMIN_AUTH_INVALID_MESSAGE) {
+    super(message);
+    this.name = "AdminAuthError";
+  }
+}
+
+/**
+ * 判断当前错误是否是 admin 鉴权失效。
+ */
+export function isAdminAuthError(error: unknown): error is AdminAuthError {
+  return error instanceof AdminAuthError;
+}
+
+/**
+ * 如果底层错误是 401，则提升为 AdminAuthError。
+ */
+export function rethrowAdminAuthError(error: unknown): void {
+  const status = (error as HttpClientError | undefined)?.status;
+  if (status === 401) {
+    throw new AdminAuthError();
+  }
+}
+
+/**
+ * 提取可展示的错误文本。
+ */
+export function adminErrorMessage(error: unknown): string {
+  if (error instanceof Error) {
+    return error.message;
+  }
+  return String(error);
+}

package/src/terminal/admin/commands/accounts.ts

@@ -0,0 +1,44 @@
+/**
+ * Admin Accounts 管理命令。
+ */
+
+import { AdminClient } from "@downcity/conduit";
+import { select, isCancel } from "@clack/prompts";
+import { showError } from "../../core/ui.js";
+import { adminErrorMessage, rethrowAdminAuthError } from "../auth-error.js";
+
+export async function manageAccounts(a: AdminClient): Promise<void> {
+  const svc = a.service("accounts");
+  while (true) {
+    const act = await select({
+      message: "Accounts",
+      options: [
+        { label: "List users", value: "users" },
+        { label: "List sessions", value: "sessions" },
+        { label: "Back", value: "back" },
+      ],
+    });
+    if (!act || isCancel(act) || act === "back") return;
+
+    try {
+      if (act === "users") {
+        const b = await svc.get<{ items: { user_id: string; email: string; created_at: string }[] }>("users");
+        console.log(`\n${b.items.length} users:\n`);
+        for (const u of b.items) {
+          console.log(`  ${u.user_id.padEnd(30)} ${u.email.padEnd(30)} ${u.created_at.slice(0, 10)}`);
+        }
+        console.log("");
+      } else {
+        const b = await svc.get<{ items: { session_id: string; user_id: string; status: string }[] }>("sessions");
+        console.log(`\n${b.items.length} sessions:\n`);
+        for (const s of b.items) {
+          console.log(`  ${s.session_id.padEnd(36)} ${s.user_id.padEnd(30)} [${s.status}]`);
+        }
+        console.log("");
+      }
+    } catch (e) {
+      rethrowAdminAuthError(e);
+      showError(adminErrorMessage(e));
+    }
+  }
+}

package/src/terminal/admin/commands/balance.ts

@@ -0,0 +1,160 @@
+/**
+ * Admin Balance 管理命令。
+ */
+
+import { AdminClient } from "@downcity/conduit";
+import { isCancel, select } from "@clack/prompts";
+import { askText, showError, showSuccess } from "../../core/ui.js";
+import { adminErrorMessage, rethrowAdminAuthError } from "../auth-error.js";
+
+export async function manageBalance(a: AdminClient): Promise<void> {
+  while (true) {
+    const act = await select({
+      message: "Balance",
+      options: [
+        { label: "List users", value: "users" },
+        { label: "History", value: "history" },
+        { label: "Topups", value: "topups" },
+        { label: "Redeem codes", value: "redeem_codes" },
+        { label: "Add balance", value: "add" },
+        { label: "Subtract balance", value: "sub" },
+        { label: "Finish topup", value: "finish" },
+        { label: "Cancel topup", value: "cancel" },
+        { label: "Create redeem code", value: "create_redeem_code" },
+        { label: "Disable redeem code", value: "disable_redeem_code" },
+        { label: "Back", value: "back" },
+      ],
+    });
+    if (!act || isCancel(act) || act === "back") return;
+
+    try {
+      if (act === "users") {
+        const items = await a.balance.listUsers(30);
+        console.log(`\n${items.length} balance accounts:\n`);
+        for (const item of items) {
+          console.log(`  ${item.user_id.padEnd(28)} ${String(item.balance).padStart(8)} ${item.unit.padEnd(10)} ${item.updated_at.slice(0, 19)}`);
+        }
+        console.log("");
+        continue;
+      }
+
+      if (act === "history") {
+        const userId = await askText("user_id (optional)");
+        const items = await a.balance.listHistory({
+          limit: 30,
+          user_id: userId ?? "",
+        });
+        console.log(`\n${items.length} balance history entries:\n`);
+        for (const item of items) {
+          console.log(`  ${item.created_at.slice(0, 19)}  ${item.user_id.padEnd(20)} ${item.kind.padEnd(8)} ${String(item.amount).padStart(6)} -> ${String(item.balance_after).padStart(6)}  ${item.note}`);
+        }
+        console.log("");
+        continue;
+      }
+
+      if (act === "topups") {
+        const userId = await askText("user_id (optional)");
+        const items = await a.balance.listTopups({
+          limit: 30,
+          user_id: userId ?? "",
+        });
+        console.log(`\n${items.length} topup orders:\n`);
+        for (const item of items) {
+          console.log(`  ${item.topup_id.padEnd(24)} ${item.user_id.padEnd(20)} ${String(item.amount).padStart(6)} ${item.unit.padEnd(10)} [${item.status}] ${item.note}`);
+        }
+        console.log("");
+        continue;
+      }
+
+      if (act === "redeem_codes") {
+        const status = await askText("status (optional: active/redeemed/disabled)");
+        const userId = await askText("redeemed_by_user_id (optional)");
+        const items = await a.balance.redeemCodes.list({
+          limit: 30,
+          status: normalizeRedeemCodeStatus(status),
+          user_id: userId ?? "",
+        });
+        console.log(`\n${items.length} redeem codes:\n`);
+        for (const item of items) {
+          const owner = item.redeemed_by_user_id || "-";
+          console.log(`  ${item.redeem_code_id.padEnd(24)} ${item.code_mask.padEnd(22)} ${String(item.amount).padStart(6)} ${item.unit.padEnd(10)} [${item.status.padEnd(8)}] ${owner.padEnd(20)} ${item.note}`);
+        }
+        console.log("");
+        continue;
+      }
+
+      if (act === "add" || act === "sub") {
+        const userId = await askText("user_id");
+        if (!userId) continue;
+        const rawAmount = await askText("amount");
+        if (!rawAmount) continue;
+
+        const amount = Number(rawAmount);
+        if (!Number.isInteger(amount) || amount <= 0) {
+          showError("amount must be a positive integer");
+          continue;
+        }
+
+        const note = await askText("note (optional)");
+        const account = act === "add"
+          ? await a.balance.add({ user_id: userId, amount, note: note ?? "" })
+          : await a.balance.sub({ user_id: userId, amount, note: note ?? "" });
+        showSuccess(`balance updated: ${account.user_id} -> ${account.balance} ${account.unit}`);
+        continue;
+      }
+
+      if (act === "create_redeem_code") {
+        const rawAmount = await askText("amount");
+        if (!rawAmount) continue;
+
+        const amount = Number(rawAmount);
+        if (!Number.isInteger(amount) || amount <= 0) {
+          showError("amount must be a positive integer");
+          continue;
+        }
+
+        const code = await askText("custom redeem_code (optional)");
+        const note = await askText("note (optional)");
+        const issued = await a.balance.redeemCodes.create({
+          amount,
+          code: code ?? "",
+          note: note ?? "",
+        });
+        showSuccess(`redeem_code created: ${issued.redeem_code_id} -> ${issued.code} (+${issued.amount} ${issued.unit})`);
+        continue;
+      }
+
+      if (act === "disable_redeem_code") {
+        const redeemCodeId = await askText("redeem_code_id");
+        if (!redeemCodeId) continue;
+        const note = await askText("note (optional)");
+        const item = await a.balance.redeemCodes.disable({
+          redeem_code_id: redeemCodeId,
+          note: note ?? "",
+        });
+        showSuccess(`redeem_code updated: ${item.redeem_code_id} -> ${item.status}`);
+        continue;
+      }
+
+      const topupId = await askText("topup_id");
+      if (!topupId) continue;
+      const note = await askText("note (optional)");
+      const topup = act === "finish"
+        ? await a.balance.finishTopup({ topup_id: topupId, note: note ?? "" })
+        : await a.balance.cancelTopup({ topup_id: topupId, note: note ?? "" });
+      showSuccess(`topup updated: ${topup.topup_id} -> ${topup.status}`);
+    } catch (e) {
+      rethrowAdminAuthError(e);
+      showError(adminErrorMessage(e));
+    }
+  }
+}
+
+function normalizeRedeemCodeStatus(value: string | undefined): "active" | "redeemed" | "disabled" | undefined {
+  const normalized = String(value ?? "").trim();
+  if (!normalized) return undefined;
+  if (normalized === "active" || normalized === "redeemed" || normalized === "disabled") {
+    return normalized;
+  }
+  throw new TypeError("status must be active, redeemed, or disabled");
+}

package/src/terminal/admin/commands/config.ts

@@ -0,0 +1,13 @@
+/**
+ * 旧的 Admin Server URL 命令兼容壳。
+ *
+ * 关键说明（中文）
+ * - 新交互下，server 管理已经提升到顶层 Manage Servers
+ * - 这里保留空壳是为了避免历史导入直接报错
+ */
+
+import { type AdminSession } from "../../core/session.js";
+
+export async function changeServerUrl(_session: AdminSession): Promise<boolean> {
+  return false;
+}

package/src/terminal/admin/commands/custom.ts

@@ -0,0 +1,46 @@
+/**
+ * Admin Custom Service 命令。
+ */
+
+import { AdminClient } from "@downcity/conduit";
+import { select, isCancel } from "@clack/prompts";
+import { askText, showError } from "../../core/ui.js";
+import { adminErrorMessage, rethrowAdminAuthError } from "../auth-error.js";
+
+export async function manageCustom(a: AdminClient): Promise<void> {
+  while (true) {
+    const name = await askText("service name (empty to go back)");
+    if (!name) return;
+
+    const act = await select({
+      message: name,
+      options: [
+        { label: "GET", value: "get" },
+        { label: "POST", value: "post" },
+        { label: "Back", value: "back" },
+      ],
+    });
+    if (!act || isCancel(act) || act === "back") return;
+
+    try {
+      const svc = a.service(name);
+      if (act === "get") {
+        const path = await askText("path") ?? "";
+        console.log(JSON.stringify(await svc.get(path), null, 2));
+      } else {
+        const raw = await askText("body (JSON)") ?? "{}";
+        let body: Record<string, unknown>;
+        try {
+          body = JSON.parse(raw);
+        } catch {
+          showError("Invalid JSON body");
+          continue;
+        }
+        console.log(JSON.stringify(await svc.action("").invoke(body), null, 2));
+      }
+    } catch (e) {
+      rethrowAdminAuthError(e);
+      showError(adminErrorMessage(e));
+    }
+  }
+}

package/src/terminal/admin/commands/instruction.ts

@@ -0,0 +1,12 @@
+/**
+ * Admin Infra 说明文档查看命令。
+ */
+
+import { AdminClient } from "@downcity/conduit";
+
+/**
+ * 展示当前 InfraRuntime 聚合后的说明文档。
+ */
+export async function manageInstruction(a: AdminClient): Promise<void> {
+  console.log(`\n${await a.instruction()}\n`);
+}

package/src/terminal/admin/commands/models.ts

@@ -0,0 +1,64 @@
+/**
+ * Admin Models 只读视图。
+ *
+ * 关键说明（中文）
+ * - 这里不提供模型新增、删除、启停。
+ * - 模型定义仍然来自代码注册；admin 只负责查看当前可用状态。
+ * - 如果模型缺少 provider key，会在这里直接显示缺失项。
+ */
+
+import { AdminClient } from "@downcity/conduit";
+import { show, showError } from "../../core/ui.js";
+import { adminErrorMessage, isAdminNotFoundError, rethrowAdminAuthError } from "../auth-error.js";
+
+/**
+ * 展示全部代码注册模型及其运行状态。
+ */
+export async function manageModels(a: AdminClient): Promise<void> {
+  try {
+    const [modelResp, envCatalog] = await Promise.all([
+      a.listModels(),
+      a.env.catalog(),
+    ]);
+    const items = modelResp ?? [];
+    const aiScope = envCatalog.find((item) => item.id === "ai-models");
+    const envMap = new Map(aiScope?.env.map((item) => [item.key, item.configured]) ?? []);
+
+    if (items.length === 0) {
+      show("No models registered on server.");
+      return;
+    }
+
+    console.log(`\n${items.length} models:\n`);
+    for (const model of items) {
+      const requirements = model.env_requirements ?? [];
+      const missingEnv = requirements
+        .filter((item) => item.required && !envMap.get(item.key))
+        .map((item) => item.key);
+      const status = missingEnv.length === 0 ? "READY" : `MISSING ${missingEnv.join(", ")}`;
+      const defaults = (model.default_modes ?? []).length > 0
+        ? `default: ${(model.default_modes ?? []).join(", ")}`
+        : "default: none";
+      const envText = requirements.length > 0
+        ? requirements
+          .map((item) => `${item.key}${envMap.get(item.key) ? "✓" : "✗"}`)
+          .join(", ")
+        : "none";
+
+      console.log(`  ${model.name} (${model.id})`);
+      console.log(`    status: ${status}`);
+      console.log(`    modalities: ${model.modalities.join(", ") || "none"}`);
+      console.log(`    ${defaults}`);
+      console.log(`    env: ${envText}`);
+      if (model.description) console.log(`    desc: ${model.description}`);
+      console.log("");
+    }
+  } catch (e) {
+    rethrowAdminAuthError(e);
+    if (isAdminNotFoundError(e)) {
+      showError("Connected InfraRuntime is too old and does not expose /v1/env/catalog yet. Deploy the latest worker/server first.");
+      return;
+    }
+    showError(adminErrorMessage(e));
+  }
+}