@kevisual/cnb 0.0.52 → 0.0.54

package/dist/cli.js

@@ -4432,7 +4432,7 @@ var require_commander = __commonJS((exports) => {
   exports.InvalidOptionArgumentError = InvalidArgumentError3;
 });
 
-// ../../node_modules/.pnpm/@kevisual+router@0.1.3/node_modules/@kevisual/router/dist/router.js
+// ../../node_modules/.pnpm/@kevisual+router@0.1.6/node_modules/@kevisual/router/dist/router.js
 import { createRequire as createRequire2 } from "node:module";
 import { webcrypto as crypto } from "node:crypto";
 import url2 from "node:url";
@@ -21947,7 +21947,7 @@ class QueryRouter {
             console.error("=====debug====:", e);
             console.error("=====debug====:[path:key]:", `${route.path}-${route.key}`);
           }
-          if (e instanceof CustomError) {
+          if (e instanceof CustomError || e?.code) {
             ctx.code = e.code;
             ctx.message = e.message;
           } else {
@@ -22210,6 +22210,39 @@ class QueryRouterServer extends QueryRouter {
     const { path, key, id } = api2;
     return this.run({ path, key, id, payload }, ctx);
   }
+  async createAuth(fun) {
+    this.route({
+      path: "auth",
+      key: "auth",
+      id: "auth",
+      description: "token验证"
+    }).define(async (ctx) => {
+      if (fun) {
+        await fun(ctx, "auth");
+      }
+    }).addTo(this, { overwrite: false });
+    this.route({
+      path: "auth-admin",
+      key: "auth-admin",
+      id: "auth-admin",
+      description: "admin token验证",
+      middleware: ["auth"]
+    }).define(async (ctx) => {
+      if (fun) {
+        await fun(ctx, "auth-admin");
+      }
+    }).addTo(this, { overwrite: false });
+    this.route({
+      path: "auth-can",
+      key: "auth-can",
+      id: "auth-can",
+      description: "权限验证"
+    }).define(async (ctx) => {
+      if (fun) {
+        await fun(ctx, "auth-can");
+      }
+    }).addTo(this, { overwrite: false });
+  }
 }
 var isNode2 = typeof process !== "undefined" && process.versions != null && process.versions.node != null;
 var isBrowser2 = typeof window !== "undefined" && typeof document !== "undefined" && typeof document.createElement === "function";
@@ -25020,6 +25053,22 @@ class Issue extends CNBCore {
   }
 }
 
+// src/mission/modules/resources.ts
+var queryResources = async (cnb, opts) => {
+  const url3 = `${cnb.hackURL}/${opts?.repo || "kevisual/projects"}/-/mission-resource/resources`;
+  return cnb.post({
+    url: url3,
+    data: {
+      selectors: opts?.selectors,
+      slugName: opts?.repo
+    },
+    headers: {
+      Accept: "application/vnd.cnb.web+json"
+    },
+    useCookie: true
+  });
+};
+
 // src/mission/index.ts
 class Mission extends CNBCore {
   constructor(options) {
@@ -25082,6 +25131,9 @@ class Mission extends CNBCore {
       params: { visibility }
     });
   }
+  queryResources(repo, selectors) {
+    return queryResources(this, { repo, selectors });
+  }
 }
 
 // src/ai/index.ts
@@ -25101,6 +25153,78 @@ class AiBase extends CNBCore {
   }
 }
 
+// src/labels/repo-label.ts
+class RepoLabel extends CNBCore {
+  constructor(options) {
+    super(options);
+  }
+  list(repo, params) {
+    const url3 = `/${repo}/-/labels`;
+    return this.get({
+      url: url3,
+      params,
+      headers: {
+        Accept: "application/vnd.cnb.api+json"
+      }
+    });
+  }
+  create(repo, data) {
+    const url3 = `/${repo}/-/labels`;
+    return this.post({
+      url: url3,
+      data
+    });
+  }
+  update(repo, name, data) {
+    const url3 = `/${repo}/-/labels/${encodeURIComponent(name)}`;
+    return this.patch({
+      url: url3,
+      data
+    });
+  }
+  remove(repo, name) {
+    const url3 = `/${repo}/-/labels/${encodeURIComponent(name)}`;
+    return this.delete({ url: url3 });
+  }
+}
+
+class IssueLabel extends CNBCore {
+  constructor(options) {
+    super(options);
+  }
+  list(repo, number4, params) {
+    const url3 = `/${repo}/-/issues/${number4}/labels`;
+    return this.get({
+      url: url3,
+      params,
+      headers: {
+        Accept: "application/vnd.cnb.api+json"
+      }
+    });
+  }
+  set(repo, number4, data) {
+    const url3 = `/${repo}/-/issues/${number4}/labels`;
+    return this.put({
+      url: url3,
+      data
+    });
+  }
+  add(repo, number4, data) {
+    const url3 = `/${repo}/-/issues/${number4}/labels`;
+    return this.post({
+      url: url3,
+      data
+    });
+  }
+  clear(repo, number4) {
+    const url3 = `/${repo}/-/issues/${number4}/labels`;
+    return this.delete({ url: url3 });
+  }
+  remove(repo, number4, name) {
+    const url3 = `/${repo}/-/issues/${number4}/labels/${encodeURIComponent(name)}`;
+    return this.delete({ url: url3 });
+  }
+}
 // src/index.ts
 class CNB extends CNBCore {
   workspace;
@@ -25111,6 +25235,7 @@ class CNB extends CNBCore {
   issue;
   mission;
   ai;
+  labels;
   constructor(options) {
     super({ ...options, token: options.token, cookie: options.cookie, cnb: options.cnb });
     this.init(options);
@@ -25129,6 +25254,10 @@ class CNB extends CNBCore {
     this.issue = new Issue(options);
     this.mission = new Mission(options);
     this.ai = new AiBase(options);
+    this.labels = {
+      repoLabel: new RepoLabel(options),
+      issueLabel: new IssueLabel(options)
+    };
   }
   setToken(token) {
     this.token = token;
@@ -25138,6 +25267,8 @@ class CNB extends CNBCore {
     this.build.token = token;
     this.issue.token = token;
     this.mission.token = token;
+    this.labels.repoLabel.token = token;
+    this.labels.issueLabel.token = token;
   }
   setCookie(cookie) {
     this.cookie = cookie;
@@ -25147,8 +25278,15 @@ class CNB extends CNBCore {
     this.build.cookie = cookie;
     this.issue.cookie = cookie;
     this.mission.cookie = cookie;
+    this.labels.repoLabel.cookie = cookie;
+    this.labels.issueLabel.cookie = cookie;
   }
+  getCNBVersion = getCNBVersion;
 }
+var getCNBVersion = () => {
+  const url3 = "https://cnb.cool/api/version";
+  return fetch(url3).then((res) => res.json());
+};
 
 // ../../node_modules/.pnpm/@ai-sdk+provider@3.0.8/node_modules/@ai-sdk/provider/dist/index.mjs
 var marker = "vercel.ai.error";
@@ -46858,6 +46996,169 @@ app.route({
   const res = await cnb.repo.updateRepoInfo(name15, { description, license, site, topics });
   ctx.forward(res);
 }).addTo(app);
+app.route({
+  path: "cnb",
+  key: "update-repo-visibility",
+  description: "更新代码仓库的可见性, 参数name, visibility",
+  middleware: ["auth"],
+  metadata: {
+    args: {
+      name: tool.schema.string().describe("代码仓库名称"),
+      visibility: tool.schema.string().describe("代码仓库可见性, public 或 private 或 protected")
+    }
+  }
+}).define(async (ctx) => {
+  const cnb = await cnbManager.getContext(ctx);
+  const name15 = ctx.query?.name;
+  const visibility = ctx.query?.visibility;
+  if (!name15) {
+    ctx.throw(400, "缺少参数 name");
+  }
+  if (!visibility) {
+    ctx.throw(400, "缺少参数 visibility");
+  }
+  const res = await cnb.post({
+    url: `/${name15}/-/settings/set_visibility`,
+    data: { visibility }
+  });
+  ctx.forward(res);
+}).addTo(app);
+
+// agent/routes/repo/repo-label.ts
+app.route({
+  path: "cnb",
+  key: "list-repo-labels",
+  description: "查询仓库的标签列表",
+  middleware: ["auth"],
+  metadata: {
+    tags: ["opencode"],
+    ...createSkill({
+      skill: "list-repo-labels",
+      title: "查询仓库标签列表",
+      summary: "查询仓库的标签列表",
+      args: {
+        repo: tool.schema.string().describe("仓库路径, 如 my-user/my-repo"),
+        page: tool.schema.number().optional().describe("分页页码，默认 1"),
+        pageSize: tool.schema.number().optional().describe("分页每页大小，默认 30"),
+        keyword: tool.schema.string().optional().describe("标签搜索关键词")
+      }
+    })
+  }
+}).define(async (ctx) => {
+  const cnb = await cnbManager.getContext(ctx);
+  const repo2 = ctx.query?.repo;
+  const page = ctx.query?.page;
+  const pageSize = ctx.query?.pageSize;
+  const keyword = ctx.query?.keyword;
+  if (!repo2) {
+    ctx.throw(400, "缺少参数 repo");
+  }
+  const res = await cnb.labels.repoLabel.list(repo2, {
+    page,
+    page_size: pageSize,
+    keyword
+  });
+  ctx.forward(res);
+}).addTo(app);
+app.route({
+  path: "cnb",
+  key: "create-repo-label",
+  description: "创建仓库标签",
+  middleware: ["auth"],
+  metadata: {
+    tags: ["opencode"],
+    ...createSkill({
+      skill: "create-repo-label",
+      title: "创建仓库标签",
+      summary: "创建一个仓库标签",
+      args: {
+        repo: tool.schema.string().describe("仓库路径, 如 my-user/my-repo"),
+        name: tool.schema.string().describe("标签名称"),
+        color: tool.schema.string().describe("标签颜色，十六进制颜色码，不含 # 前缀"),
+        description: tool.schema.string().optional().describe("标签描述")
+      }
+    })
+  }
+}).define(async (ctx) => {
+  const cnb = await cnbManager.getContext(ctx);
+  const repo2 = ctx.query?.repo;
+  const name15 = ctx.query?.name;
+  const color = ctx.query?.color;
+  const description = ctx.query?.description;
+  if (!repo2 || !name15 || !color) {
+    ctx.throw(400, "缺少参数 repo, name 或 color");
+  }
+  const res = await cnb.labels.repoLabel.create(repo2, {
+    name: name15,
+    color,
+    description
+  });
+  ctx.forward(res);
+}).addTo(app);
+app.route({
+  path: "cnb",
+  key: "update-repo-label",
+  description: "更新仓库标签",
+  middleware: ["auth"],
+  metadata: {
+    tags: ["opencode"],
+    ...createSkill({
+      skill: "update-repo-label",
+      title: "更新仓库标签",
+      summary: "更新仓库标签信息",
+      args: {
+        repo: tool.schema.string().describe("仓库路径, 如 my-user/my-repo"),
+        name: tool.schema.string().describe("标签名称"),
+        color: tool.schema.string().optional().describe("标签颜色，十六进制颜色码，不含 # 前缀"),
+        description: tool.schema.string().optional().describe("标签描述"),
+        newName: tool.schema.string().optional().describe("新标签名称")
+      }
+    })
+  }
+}).define(async (ctx) => {
+  const cnb = await cnbManager.getContext(ctx);
+  const repo2 = ctx.query?.repo;
+  const name15 = ctx.query?.name;
+  const color = ctx.query?.color;
+  const description = ctx.query?.description;
+  const newName = ctx.query?.newName;
+  if (!repo2 || !name15) {
+    ctx.throw(400, "缺少参数 repo 或 name");
+  }
+  const res = await cnb.labels.repoLabel.update(repo2, name15, {
+    color,
+    description,
+    new_name: newName
+  });
+  ctx.forward(res);
+}).addTo(app);
+app.route({
+  path: "cnb",
+  key: "delete-repo-label",
+  description: "删除仓库标签",
+  middleware: ["auth"],
+  metadata: {
+    tags: ["opencode"],
+    ...createSkill({
+      skill: "delete-repo-label",
+      title: "删除仓库标签",
+      summary: "删除指定的仓库标签",
+      args: {
+        repo: tool.schema.string().describe("仓库路径, 如 my-user/my-repo"),
+        name: tool.schema.string().describe("标签名称")
+      }
+    })
+  }
+}).define(async (ctx) => {
+  const cnb = await cnbManager.getContext(ctx);
+  const repo2 = ctx.query?.repo;
+  const name15 = ctx.query?.name;
+  if (!repo2 || !name15) {
+    ctx.throw(400, "缺少参数 repo 或 name");
+  }
+  const res = await cnb.labels.repoLabel.remove(repo2, name15);
+  ctx.forward(res);
+}).addTo(app);
 
 // agent/routes/workspace/skills.ts
 app.route({
@@ -47948,7 +48249,7 @@ app.route({
   let repo2 = ctx.query?.repo || useKey("CNB_REPO_SLUG_LOWERCASE");
   const state = ctx.query?.state;
   const keyword = ctx.query?.keyword;
-  const labels = ctx.query?.labels;
+  const labels2 = ctx.query?.labels;
   const page = ctx.query?.page ? Number(ctx.query.page) : undefined;
   const page_size = ctx.query?.page_size ? Number(ctx.query.page_size) : undefined;
   const order_by = ctx.query?.order_by;
@@ -47960,8 +48261,8 @@ app.route({
     params.state = state;
   if (keyword)
     params.keyword = keyword;
-  if (labels)
-    params.labels = labels;
+  if (labels2)
+    params.labels = labels2;
   if (page)
     params.page = page;
   if (page_size)
@@ -48030,7 +48331,7 @@ app.route({
   const title = ctx.query?.title;
   const body = ctx.query?.body;
   const assignees = ctx.query?.assignees;
-  const labels = ctx.query?.labels;
+  const labels2 = ctx.query?.labels;
   const priority = ctx.query?.priority;
   if (!repo2 || !title) {
     ctx.throw(400, "缺少参数 repo 或 title");
@@ -48039,7 +48340,7 @@ app.route({
     title,
     body,
     assignees,
-    labels,
+    labels: labels2,
     priority
   });
   ctx.forward(res);
@@ -48296,7 +48597,7 @@ var getLiveMdContent = (opts) => {
 2. Opencode web访问说明
 Opencode打开web地址，需要在浏览器输入用户名和密码，用户名固定为root，密码为CNB_TOKEN的值. 纯连接打开包含账号密码，第一次点击后，需要把账号密码清理掉才能访问，opencode的bug导致的。
 `;
-  const labels = [
+  const labels2 = [
     {
       key: "vscodeWebUrl",
       title: "VSCode Web 地址",
@@ -48353,11 +48654,11 @@ Opencode打开web地址，需要在浏览器输入用户名和密码，用户名
     }
   ];
   const osInfoList = createOSInfo(more);
-  labels.push(...osInfoList);
-  return labels;
+  labels2.push(...osInfoList);
+  return labels2;
 };
 var createOSInfo = (more = false) => {
-  const labels = [];
+  const labels2 = [];
   const startTimer = useKey("CNB_BUILD_START_TIME") || "";
   const cpus = os2.cpus();
   let totalIdle = 0;
@@ -48417,7 +48718,7 @@ var createOSInfo = (more = false) => {
   } catch (e) {
     diskUsage = "获取失败";
   }
-  labels.push({
+  labels2.push({
     key: "cpuUsage",
     title: "CPU 使用率",
     value: `${cpuUsage}%`,
@@ -48459,7 +48760,7 @@ var createOSInfo = (more = false) => {
     const buildUptime = Date.now() - buildStartTimestamp;
     const buildUptimeStr = formatUptime(Math.floor(buildUptime / 1000));
     const maxRunTime = useKey("CNB_PIPELINE_MAX_RUN_TIME") || 0;
-    labels.push({
+    labels2.push({
       key: "buildStartTime",
       title: "构建启动时间",
       value: buildStartTime,
@@ -48478,13 +48779,13 @@ var createOSInfo = (more = false) => {
         timeTo4 = today4am.add(1, "day").valueOf() - now.valueOf();
       }
       const timeTo4Str = `[距离晚上4点重启时间: ${formatUptime(Math.floor(timeTo4 / 1000))}]`;
-      labels.push({
+      labels2.push({
         key: "buildMaxRunTime",
         title: "最大运行时间",
         value: formatUptime(Math.floor(maxRunTime / 1000)),
         description: "构建最大运行时间(限制时间)"
       });
-      labels.unshift({
+      labels2.unshift({
         key: "remainingTime",
         title: "剩余时间",
         value: maxRunTime - buildUptime,
@@ -48494,7 +48795,7 @@ var createOSInfo = (more = false) => {
   }
   if (more) {
     const loadavg = os2.loadavg();
-    labels.push({
+    labels2.push({
       key: "hostname",
       title: "主机名",
       value: os2.hostname(),
@@ -48531,7 +48832,7 @@ var createOSInfo = (more = false) => {
       description: "系统负载 (15分钟)"
     });
   }
-  return labels;
+  return labels2;
 };
 
 // agent/routes/cnb-board/cnb-dev-env.ts
@@ -48568,7 +48869,7 @@ app.route({
   if (notCNBCheck(ctx))
     return;
   const repoNameFromSlug = repoSlug.split("/").pop() || "";
-  const labels = [
+  const labels2 = [
     {
       title: "CNB_REPO_SLUG",
       value: repoSlug,
@@ -48602,7 +48903,7 @@ app.route({
   ];
   ctx.body = {
     title: "CNB_BOARD_LIVE_REPO_INFO",
-    list: labels
+    list: labels2
   };
 }).addTo(app);
 app.route({
@@ -48613,7 +48914,7 @@ app.route({
 }).define(async (ctx) => {
   if (notCNBCheck(ctx))
     return;
-  const labels = [
+  const labels2 = [
     {
       title: "CNB_BUILD_ID",
       value: useKey("CNB_BUILD_ID") || "",
@@ -48747,7 +49048,7 @@ app.route({
   ];
   ctx.body = {
     title: "CNB_BOARD_LIVE_BUILD_INFO",
-    list: labels
+    list: labels2
   };
 }).addTo(app);
 app.route({
@@ -48756,7 +49057,7 @@ app.route({
   description: "获取cnb-board live的PR信息",
   middleware: ["auth-admin"]
 }).define(async (ctx) => {
-  const labels = [
+  const labels2 = [
     {
       title: "CNB_PULL_REQUEST",
       value: useKey("CNB_PULL_REQUEST") || "",
@@ -48845,7 +49146,7 @@ app.route({
   ];
   ctx.body = {
     title: "CNB_BOARD_LIVE_PULL_INFO",
-    list: labels
+    list: labels2
   };
 }).addTo(app);
 app.route({
@@ -48856,7 +49157,7 @@ app.route({
 }).define(async (ctx) => {
   if (notCNBCheck(ctx))
     return;
-  const labels = [
+  const labels2 = [
     {
       title: "CNB_NPC_SLUG",
       value: useKey("CNB_NPC_SLUG") || "",
@@ -48890,7 +49191,7 @@ app.route({
   ];
   ctx.body = {
     title: "CNB_BOARD_LIVE_NPC_INFO",
-    list: labels
+    list: labels2
   };
 }).addTo(app);
 app.route({
@@ -48901,7 +49202,7 @@ app.route({
 }).define(async (ctx) => {
   if (notCNBCheck(ctx))
     return;
-  const labels = [
+  const labels2 = [
     {
       title: "CNB_COMMENT_ID",
       value: useKey("CNB_COMMENT_ID") || "",
@@ -48935,7 +49236,7 @@ app.route({
   ];
   ctx.body = {
     title: "CNB_BOARD_LIVE_COMMENT_INFO",
-    list: labels
+    list: labels2
   };
 }).addTo(app);
 
@@ -55074,6 +55375,44 @@ app.route({
   ctx.body = result;
 }).addTo(app);
 
+// agent/routes/missions/list.ts
+app.route({
+  path: "cnb",
+  key: "missions-list",
+  description: "查询missions列表",
+  metadata: {
+    args: {
+      repo: zod_default.string().optional().describe("missions所在的仓库，例如 kevisual/projects"),
+      selector: zod_default.array(zod_default.any()).optional().describe('查询条件，例如 [{field: "resource_type", operator: "contains", value: ["issues"]},…]')
+    }
+  }
+}).define(async (ctx) => {
+  const cnb = await cnbManager.getContext(ctx);
+  const repo2 = ctx.query?.repo || "kevisual/projects";
+  const res = await cnb.mission.queryResources(repo2, ctx.query?.selector || [
+    {
+      field: "resource_type",
+      operator: "contains",
+      value: [
+        "issues"
+      ]
+    },
+    {
+      field: "state",
+      operator: "not_equals",
+      value: [
+        "closed"
+      ]
+    },
+    {
+      field: "label",
+      operator: "contains",
+      value: ["AICoding"]
+    }
+  ]);
+  ctx.forward(res);
+}).addTo(app);
+
 // agent/routes/index.ts
 var checkAppId = (ctx, appId) => {
   const _appId = ctx?.app?.appId;
@@ -55125,7 +55464,7 @@ var {
   Help
 } = import__3.default;
 
-// ../../node_modules/.pnpm/@kevisual+remote-app@0.0.7/node_modules/@kevisual/remote-app/dist/app.js
+// ../../node_modules/.pnpm/@kevisual+remote-app@0.0.6/node_modules/@kevisual/remote-app/dist/app.js
 var __create4 = Object.create;
 var __getProtoOf4 = Object.getPrototypeOf;
 var __defProp5 = Object.defineProperty;
@@ -55340,12 +55679,10 @@ class RemoteApp {
   reconnectAttempts = 0;
   reconnectTimer = null;
   isManuallyClosed = false;
-  isInitializing = false;
-  initId = 0;
   constructor(opts) {
     this.mainApp = opts?.app;
     const token2 = opts.token;
-    const url4 = opts.url || "https://kevisual.cn/ws/proxy";
+    const url4 = opts.url;
     const id = opts.id;
     const username = opts.username;
     this.username = username;
@@ -55411,17 +55748,10 @@ class RemoteApp {
     return wsURL;
   }
   async init() {
-    if (this.isInitializing) {
-      return;
-    }
-    this.isInitializing = true;
-    const currentInitId = ++this.initId;
     if (!this.url) {
-      this.isInitializing = false;
       throw new Error("No url provided for remote app");
     }
     if (!this.id) {
-      this.isInitializing = false;
       throw new Error("No id provided for remote app");
     }
     this.isError = false;
@@ -55431,20 +55761,11 @@ class RemoteApp {
     const ws = new WebSocket(this.getWsURL(this.url));
     const that = this;
     ws.onopen = function() {
-      if (currentInitId !== that.initId) {
-        ws.close();
-        return;
-      }
       that.isConnected = true;
-      that.isInitializing = false;
       that.onOpen();
       console.log("[remote-app] WebSocket connection opened");
     };
     ws.onclose = function() {
-      if (currentInitId !== that.initId) {
-        return;
-      }
-      that.isInitializing = false;
       that.isConnected = false;
       that.onClose();
     };
@@ -55452,10 +55773,6 @@ class RemoteApp {
       that.onMessage(event.data);
     };
     ws.onerror = function(error49) {
-      if (currentInitId !== that.initId) {
-        return;
-      }
-      that.isInitializing = false;
       that.onError(error49);
     };
     this.ws = ws;
@@ -55609,7 +55926,7 @@ class RemoteApp {
   }
 }
 
-// ../../node_modules/.pnpm/@kevisual+router@0.1.3/node_modules/@kevisual/router/src/commander.ts
+// ../../node_modules/.pnpm/@kevisual+router@0.1.6/node_modules/@kevisual/router/src/commander.ts
 var groupByPath = (routes) => {
   return routes.reduce((acc, route) => {
     const path3 = route.path || "default";
@@ -55729,23 +56046,7 @@ var parse8 = async (opts) => {
     _program.version(version3);
   }
   app3.createRouteList();
-  app3.route({
-    path: "cli",
-    key: "list"
-  }).define(async () => {
-    const routes = app3.routes.map((route) => {
-      return {
-        path: route.path,
-        key: route.key,
-        description: route?.metadata?.summary || route.description || ""
-      };
-    });
-    const table = routes.map((route) => {
-      return `${route.path} ${route.key} - ${route.description}`;
-    }).join(`
-`);
-    console.log(table);
-  }).addTo(app3, { overwrite: false });
+  createCliList(app3);
   createCommand2({ app: app3, program: _program });
   if (opts.remote) {
     const { token: token2, username, id } = opts.remote;
@@ -55768,6 +56069,82 @@ var parse8 = async (opts) => {
     }
   }
 };
+var createCliList = (app3) => {
+  app3.route({
+    path: "cli",
+    key: "list",
+    description: "列出所有可用的命令",
+    metadata: {
+      summary: "列出所有可用的命令",
+      args: {
+        q: zod_default.string().optional().describe("查询关键词，支持模糊匹配命令"),
+        path: zod_default.string().optional().describe("按路径前缀过滤，如 user、admin"),
+        tags: zod_default.string().optional().describe("按标签过滤，多个标签用逗号分隔"),
+        sort: zod_default.enum(["key", "path", "name"]).optional().describe("排序方式"),
+        limit: zod_default.number().optional().describe("限制返回数量"),
+        offset: zod_default.number().optional().describe("偏移量，用于分页"),
+        format: zod_default.enum(["table", "simple", "json"]).optional().describe("输出格式")
+      }
+    }
+  }).define(async (ctx) => {
+    const { q, path: pathFilter, tags, sort, limit, offset, format } = ctx.query;
+    let routes = app3.routes.map((route) => {
+      return {
+        path: route.path,
+        key: route.key,
+        description: route?.metadata?.summary || route.description || "",
+        tags: route?.metadata?.tags || []
+      };
+    });
+    if (pathFilter) {
+      routes = routes.filter((route) => route.path.startsWith(pathFilter));
+    }
+    if (tags) {
+      const tagList = tags.split(",").map((t) => t.trim().toLowerCase()).filter(Boolean);
+      if (tagList.length > 0) {
+        routes = routes.filter((route) => {
+          const routeTags = Array.isArray(route.tags) ? route.tags.map((t) => String(t).toLowerCase()) : [];
+          return tagList.some((tag) => routeTags.includes(tag));
+        });
+      }
+    }
+    if (q) {
+      const keyword = q.toLowerCase();
+      routes = routes.filter((route) => {
+        return route.path.toLowerCase().includes(keyword) || route.key.toLowerCase().includes(keyword) || route.description.toLowerCase().includes(keyword);
+      });
+    }
+    if (sort) {
+      routes.sort((a, b) => {
+        if (sort === "path")
+          return a.path.localeCompare(b.path);
+        if (sort === "key")
+          return a.key.localeCompare(b.key);
+        return a.key.localeCompare(b.key);
+      });
+    }
+    const total = routes.length;
+    const start = offset || 0;
+    const end = limit ? start + limit : undefined;
+    routes = routes.slice(start, end);
+    const outputFormat = format || "table";
+    if (outputFormat === "json") {
+      console.log(JSON.stringify({ total, offset: start, limit, routes }, null, 2));
+      return;
+    }
+    if (outputFormat === "simple") {
+      routes.forEach((route) => {
+        console.log(`${route.path} ${route.key}`);
+      });
+      return;
+    }
+    const table = routes.map((route) => {
+      return `${route.path} ${route.key} - ${route.description}`;
+    }).join(`
+`);
+    console.log(table);
+  }).addTo(app3, { overwrite: false });
+};
 
 // agent/cli.ts
 await parse8({ app, description: "CNB控制台命令行工具", parse: true });