npm - @ai-setting/roy-agent-cli - Versions diffs - 1.5.113 → 1.5.115 - Mend

@ai-setting/roy-agent-cli 1.5.113 → 1.5.115

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (4) hide show

package/dist/bin/roy-agent.js +1029 -725
package/dist/index.js +1029 -725
package/dist/roy-agent-linux-x64/bin/roy-agent +0 -0
package/package.json +1 -1

package/dist/bin/roy-agent.js CHANGED Viewed

@@ -7427,7 +7427,7 @@ var require_dist = __commonJS((exports) => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "@ai-setting/roy-agent-cli",
-    version: "1.5.113",
+    version: "1.5.115",
     type: "module",
     description: "CLI for roy-agent - Non-interactive command execution",
     main: "./dist/index.js",
@@ -9495,7 +9495,6 @@ class EventHandler {
         console.error(`[EventHandler] 处理事件失败:`, error);
       }
     }
-    this.clearActiveSession();
     this.isProcessing = false;
   }
   async ensureActiveSession() {
@@ -9512,13 +9511,29 @@ class EventHandler {
             return null;
           }
           this.activeEventSessionId = existing.id;
+          await this.sessionComponent.setActiveSession(existing.id);
           return existing.id;
         }
-        console.warn(`[EventHandler] Parent session ${triggerSessionId} not found, creating new session`);
+        console.warn(`[EventHandler] Parent session ${triggerSessionId} not found, trying global active session`);
       } catch (error) {
         console.error(`[EventHandler] Failed to lookup parent session ${triggerSessionId}:`, error);
       }
     }
+    try {
+      const activeId = this.sessionComponent.getActiveSessionId();
+      if (activeId) {
+        const existing = await this.sessionComponent.get(activeId);
+        if (existing) {
+          if (this.isStopped) {
+            return null;
+          }
+          this.activeEventSessionId = existing.id;
+          return existing.id;
+        }
+      }
+    } catch (error) {
+      console.error(`[EventHandler] Failed to lookup global active session:`, error);
+    }
     return this.createNewEventSession();
   }
   async createNewEventSession() {
@@ -9531,6 +9546,7 @@ class EventHandler {
         return null;
       }
       this.activeEventSessionId = session.id;
+      await this.sessionComponent.setActiveSession(session.id);
       return session.id;
     } catch (error) {
       console.error(`[EventHandler] 创建事件 session 失败:`, error);
@@ -9953,6 +9969,7 @@ class REPL {
   inputHandler;
   keypressHandler;
   sessionManager = null;
+  sessionComponent = null;
   lastAttachPath = undefined;
   lastUsage = null;
   setLastUsage(usage) {
@@ -10191,9 +10208,22 @@ ${COLORS.system("⏳ 上一次请求尚未完成，请稍候...")}
 `);
       return;
     }
+    await this.ensureActiveSession();
     const payload = this.sessionManager ? await this.sessionManager.getQueryPayload(message) : message;
     await this.executeInternal(payload, { showPrompt: false });
   }
+  async ensureActiveSession() {
+    if (!this.sessionComponent)
+      return;
+    try {
+      const activeId = this.sessionComponent.getActiveSessionId();
+      if (!activeId && this.sessionManager) {
+        await this.sessionManager.init(undefined, false);
+      }
+    } catch (error) {
+      console.error(`[REPL] Failed to ensure active session:`, error);
+    }
+  }
   async handleEventMessage(message) {
     console.log(`
 ${COLORS.system("[通知] ❯ " + message.replace(/\n/g, `
@@ -10207,6 +10237,7 @@ ${COLORS.system("[通知] ❯ " + message.replace(/\n/g, `
 ${COLORS.system("[通知2] ❯ " + message.replace(/\n/g, `
 ` + COLORS.system("[通知2] ❯ ")))}
 `);
+    await this.ensureActiveSession();
     const sourceId = envEvent.metadata?.sourceId;
     let pluginEnabled = envEvent.metadata?.pluginEnabled;
     let plugins = envEvent.metadata?.plugins;
@@ -10775,6 +10806,7 @@ function createInteractiveCommand(externalEnvService) {
         };
         process.on("SIGINT", sigintHandler);
         repl.sessionManager = sessionManager;
+        repl.sessionComponent = sessionComponent;
         await repl.start();
         process.removeListener("SIGINT", sigintHandler);
         console.log("正在清理资源...");
@@ -10819,8 +10851,56 @@ function createInteractiveCommand(externalEnvService) {
 }
 var InteractiveCommand = createInteractiveCommand();
-// src/commands/sessions/list.ts
+// src/commands/shared/list-output.ts
 import chalk6 from "chalk";
+var PAGINATION_OPTIONS = {
+  limit: {
+    alias: "n",
+    type: "number",
+    default: 20,
+    description: "每页数量（-n alias）"
+  },
+  offset: {
+    alias: "o",
+    type: "number",
+    default: 0,
+    description: "分页偏移（-o alias）"
+  }
+};
+function applyPagination(items, args) {
+  const offset = Math.max(0, args.offset);
+  const limit = Math.max(1, args.limit);
+  return items.slice(offset, offset + limit);
+}
+function renderPaginationFooter(opts) {
+  const { total, count, offset, limit, itemName, extras = [] } = opts;
+  const start = total === 0 ? 0 : offset + 1;
+  const end = offset + count;
+  const items = `${itemName}${count === 1 ? "" : "s"}`;
+  const base = `Showing ${start}-${end} of ${total} ${items}`;
+  const suffix = extras.length > 0 ? ` (${extras.join(", ")})` : "";
+  const truncatedHint = total > count && offset + count < total ? chalk6.cyan(` — use -o ${offset + limit} for next page`) : "";
+  return chalk6.gray(base + suffix + truncatedHint);
+}
+function renderQuietHeader(total, itemName) {
+  const items = `${itemName}${total === 1 ? "" : "s"}`;
+  return `# Total: ${total} ${items}`;
+}
+function renderQuietLine(id, name) {
+  return `${id}	${name}`;
+}
+function renderQuietPaginationHint(opts) {
+  const { count, total, offset, limit } = opts;
+  if (total <= count) {
+    return "";
+  }
+  const start = offset + 1;
+  const end = offset + count;
+  return `# (showing ${start}-${end} of ${total}, use -o ${offset + limit} for next page)`;
+}
+// src/commands/sessions/list.ts
+import chalk7 from "chalk";
 // src/commands/sessions/session-graph.ts
 function buildSessionTree(sessions) {
@@ -10983,14 +11063,9 @@ var ListCommand = {
   command: "list [options]",
   aliases: ["ls"],
   describe: "列出所有会话",
-  builder: (yargs) => yargs.option("limit", { alias: "n", type: "number", default: 20 }).option("offset", { type: "number", default: 0 }).option("sort", { type: "string", default: "updatedAt" }).option("order", { type: "string", default: "desc" }).option("json", { alias: "j", type: "boolean", default: false }).option("quiet", { alias: "q", type: "boolean", hidden: true }).option("id", { alias: "i", type: "boolean", default: false, description: "显示 Session ID" }).option("type", { alias: "t", type: "string", description: "按 session 类型过滤 (如 workflow)" }).option("status", { alias: "s", type: "string", description: "按状态过滤 (如 running, paused)" }).option("graph", { alias: "g", type: "boolean", default: false, description: "以层次化树形结构展示 session 父子关系" }).option("short-id", { type: "boolean", default: false, description: "[graph] 用 8 字符截断 id 显示（默认显示完整 sessionId）" }),
+  builder: (yargs) => yargs.option("limit", { alias: "n", type: "number", default: 20 }).option("offset", { alias: "o", type: "number", default: 0, description: "分页偏移（-o alias）" }).option("sort", { type: "string", default: "updatedAt" }).option("order", { type: "string", default: "desc" }).option("json", { alias: "j", type: "boolean", default: false }).option("quiet", { alias: "q", type: "boolean", hidden: true }).option("id", { alias: "i", type: "boolean", default: false, description: "显示 Session ID" }).option("type", { alias: "t", type: "string", description: "按 session 类型过滤 (如 workflow)" }).option("status", { alias: "s", type: "string", description: "按状态过滤 (如 running, paused)" }).option("graph", { alias: "g", type: "boolean", default: false, description: "以层次化树形结构展示 session 父子关系" }).option("short-id", { type: "boolean", default: false, description: "[graph] 用 8 字符截断 id 显示（默认显示完整 sessionId）" }),
   async handler(args) {
-    const isQuiet = args.quiet === true;
-    if (isQuiet) {
-      CliQuietModeService.getInstance().setQuiet(true);
-    }
     const output = new OutputService2;
-    output.configure({ quiet: isQuiet });
     const envService = new EnvironmentService(output);
     try {
       await envService.create({ configPath: args.config });
@@ -11031,8 +11106,11 @@ var ListCommand = {
       }
       if (args.json) {
         output.json({
-          total: sessions.length,
-          totalCount,
+          total: totalCount,
+          count: sessions.length,
+          truncated: totalCount > sessions.length,
+          limit: args.limit,
+          offset: args.offset,
           sessions: sessions.map((s) => {
             const workflowMeta = s.metadata?.type === "workflow" ? s.metadata : null;
             return {
@@ -11053,48 +11131,58 @@ var ListCommand = {
             };
           })
         });
-      } else if (args.quiet || args.id) {
+      } else if (args.id) {
         sessions.forEach((s) => output.log(s.id));
+      } else if (args.quiet) {
+        output.log(renderQuietHeader(totalCount, "session"));
+        sessions.forEach((s) => output.log(renderQuietLine(s.id, s.title)));
+        const hint = renderQuietPaginationHint({
+          count: sessions.length,
+          total: totalCount,
+          offset: args.offset ?? 0,
+          limit: args.limit ?? 20
+        });
+        if (hint)
+          output.log(hint);
       } else {
         const hasTypeFilter = !!args.type;
         const hasStatusFilter = !!args.status;
         const header = [
-          chalk6.bold("#"),
-          chalk6.bold("Title"),
-          chalk6.bold("ID"),
-          chalk6.bold("Parent"),
-          hasTypeFilter || hasStatusFilter ? chalk6.bold("Status") : null,
-          chalk6.bold("Msgs"),
-          chalk6.bold("CP")
+          chalk7.bold("#"),
+          chalk7.bold("Title"),
+          chalk7.bold("ID"),
+          chalk7.bold("Parent"),
+          hasTypeFilter || hasStatusFilter ? chalk7.bold("Status") : null,
+          chalk7.bold("Msgs"),
+          chalk7.bold("CP")
         ].filter(Boolean).join(" │ ");
         const rows = sessions.map((s, i) => {
-          const marker = s.id === activeSessionId ? chalk6.green("▶") : " ";
+          const marker = s.id === activeSessionId ? chalk7.green("▶") : " ";
           const hasCp = (s.metadata?.checkpoints?.checkpoints?.length ?? 0) > 0;
           const title = s.title.length > 20 ? s.title.slice(0, 17) + "..." : s.title;
           const idStr = s.id;
           const useShortId = args.shortId === true;
-          const parentStr = s.parentSessionId ? chalk6.gray(useShortId ? shortSessionId(s.parentSessionId) : s.parentSessionId) : chalk6.gray("-");
+          const parentStr = s.parentSessionId ? chalk7.gray(useShortId ? shortSessionId(s.parentSessionId) : s.parentSessionId) : chalk7.gray("-");
           const workflowMeta = s.metadata?.type === "workflow" ? s.metadata : null;
           const statusStr = workflowMeta?.status || "";
           let statusDisplay = "";
           if (hasTypeFilter || hasStatusFilter) {
             if (workflowMeta) {
-              statusDisplay = workflowMeta.status === "running" ? chalk6.green("running") : workflowMeta.status === "paused" ? chalk6.yellow("paused") : workflowMeta.status === "completed" ? chalk6.gray("completed") : workflowMeta.status === "failed" ? chalk6.red("failed") : statusStr;
+              statusDisplay = workflowMeta.status === "running" ? chalk7.green("running") : workflowMeta.status === "paused" ? chalk7.yellow("paused") : workflowMeta.status === "completed" ? chalk7.gray("completed") : workflowMeta.status === "failed" ? chalk7.red("failed") : statusStr;
             }
           }
           const cells = [
             marker + " " + (args.offset + i + 1),
             title,
-            chalk6.gray(idStr),
+            chalk7.gray(idStr),
             parentStr
           ];
           if (hasTypeFilter || hasStatusFilter) {
-            cells.push(statusDisplay || chalk6.gray("-"));
+            cells.push(statusDisplay || chalk7.gray("-"));
           }
-          cells.push(s.messageCount.toString(), hasCp ? chalk6.green("✓") : chalk6.gray("-"));
+          cells.push(s.messageCount.toString(), hasCp ? chalk7.green("✓") : chalk7.gray("-"));
           return cells.join(" │ ");
         });
-        const showingInfo = totalCount > sessions.length ? `Showing ${sessions.length} of ${totalCount} sessions` : `${totalCount} sessions`;
         output.log([
           `┌─ Sessions ${"─".repeat(50)}┐`,
           `│${header}│`,
@@ -11102,7 +11190,17 @@ var ListCommand = {
           ...rows.map((r) => `│${r}│`),
           "└" + "─".repeat(header.length + 2) + "┘",
           "",
-          chalk6.gray(showingInfo)
+          renderPaginationFooter({
+            total: totalCount,
+            count: sessions.length,
+            offset: args.offset ?? 0,
+            limit: args.limit ?? 20,
+            itemName: "session",
+            extras: [
+              ...args.type ? [`type=${args.type}`] : [],
+              ...args.status ? [`status=${args.status}`] : []
+            ]
+          })
         ].join(`
 `));
       }
@@ -11116,7 +11214,7 @@ var ListCommand = {
 };
 // src/commands/sessions/get.ts
-import chalk7 from "chalk";
+import chalk8 from "chalk";
 var GetCommand = {
   command: "get <session-id>",
   aliases: ["show"],
@@ -11172,29 +11270,29 @@ var GetCommand = {
         });
       } else {
         const lines = [
-          chalk7.bold("┌─ Session Details ─────────────────────────────────┐"),
+          chalk8.bold("┌─ Session Details ─────────────────────────────────┐"),
           `│ ID:          ${session.id}`,
           `│ Title:       ${session.title}`,
           `│ Directory:   ${session.directory}`,
           `│ Messages:    ${session.messageCount}`,
-          `│ Active:      ${session.id === activeSessionId ? chalk7.green("✓") : chalk7.gray("-")}`,
+          `│ Active:      ${session.id === activeSessionId ? chalk8.green("✓") : chalk8.gray("-")}`,
           `│ Created:     ${new Date(session.createdAt).toLocaleString("zh-CN")}`,
           `│ Updated:     ${new Date(session.updatedAt).toLocaleString("zh-CN")}`
         ];
         const workflowMeta = session.metadata?.type === "workflow" ? session.metadata : null;
         if (workflowMeta) {
           lines.push("├─ Workflow Info ─────────────────────────────────────┤");
-          lines.push(`│ Type:        ${chalk7.cyan("workflow")}`);
+          lines.push(`│ Type:        ${chalk8.cyan("workflow")}`);
           lines.push(`│ Workflow:    ${workflowMeta.workflowName}`);
           if (workflowMeta.workflowId) {
             lines.push(`│ Workflow ID: ${workflowMeta.workflowId}`);
           }
-          const statusColor = workflowMeta.status === "running" ? chalk7.green : workflowMeta.status === "paused" ? chalk7.yellow : workflowMeta.status === "completed" ? chalk7.gray : chalk7.red;
+          const statusColor = workflowMeta.status === "running" ? chalk8.green : workflowMeta.status === "paused" ? chalk8.yellow : workflowMeta.status === "completed" ? chalk8.gray : chalk8.red;
           lines.push(`│ Status:      ${statusColor(workflowMeta.status)}`);
           if (workflowMeta.agentSessions && workflowMeta.agentSessions.length > 0) {
             lines.push("├─ Agent Sub-sessions ─────────────────────────────────┤");
             workflowMeta.agentSessions.forEach((agent) => {
-              const agentStatusColor = agent.status === "active" ? chalk7.green : agent.status === "paused" ? chalk7.yellow : chalk7.gray;
+              const agentStatusColor = agent.status === "active" ? chalk8.green : agent.status === "paused" ? chalk8.yellow : chalk8.gray;
               lines.push(`│ ${agent.nodeId}: ${agent.sessionId} (${agentStatusColor(agent.status)})`);
             });
           }
@@ -11221,7 +11319,7 @@ var GetCommand = {
 };
 // src/commands/sessions/new.ts
-import chalk8 from "chalk";
+import chalk9 from "chalk";
 var NewCommand = {
   command: "new [options]",
   aliases: ["create"],
@@ -11260,7 +11358,7 @@ var NewCommand = {
           }
         });
       } else {
-        output.success(chalk8.green("✓") + " Session created: " + session.id);
+        output.success(chalk9.green("✓") + " Session created: " + session.id);
         output.info("Title: " + session.title);
         output.info("Directory: " + session.directory);
       }
@@ -11274,7 +11372,7 @@ var NewCommand = {
 };
 // src/commands/sessions/rename.ts
-import chalk9 from "chalk";
+import chalk10 from "chalk";
 var RenameCommand = {
   command: "rename <session-id> <title>",
   aliases: ["mv"],
@@ -11329,7 +11427,7 @@ var RenameCommand = {
           }
         });
       } else {
-        output.success(`Session renamed: ${chalk9.green(a.title)}`);
+        output.success(`Session renamed: ${chalk10.green(a.title)}`);
         output.info(`ID: ${a.sessionId}`);
       }
     } catch (error) {
@@ -11342,7 +11440,7 @@ var RenameCommand = {
 };
 // src/commands/sessions/delete.ts
-import chalk10 from "chalk";
+import chalk11 from "chalk";
 var DeleteCommand = {
   command: "delete [session-ids...]",
   aliases: ["rm"],
@@ -11421,7 +11519,7 @@ var DeleteCommand = {
           return true;
         });
         if (a.keepActive && sessionsToDelete.length > 0) {
-          output.log(chalk10.yellow(`Keeping active session: ${activeSessionId}`));
+          output.log(chalk11.yellow(`Keeping active session: ${activeSessionId}`));
         }
       } else if (a.olderThan !== undefined) {
         const cutoffDate = new Date;
@@ -11438,7 +11536,7 @@ var DeleteCommand = {
           }
           return false;
         });
-        output.log(chalk10.gray(`Deleting sessions not updated since ${cutoffDate.toISOString().split("T")[0]} (${a.olderThan} days ago)`));
+        output.log(chalk11.gray(`Deleting sessions not updated since ${cutoffDate.toISOString().split("T")[0]} (${a.olderThan} days ago)`));
       } else {
         output.log("No sessions to delete");
         return;
@@ -11448,10 +11546,10 @@ var DeleteCommand = {
         return;
       }
       if (a.dryRun) {
-        output.log(chalk10.yellow(`[DRY RUN] Would delete ${sessionsToDelete.length} session(s):
+        output.log(chalk11.yellow(`[DRY RUN] Would delete ${sessionsToDelete.length} session(s):
 `));
         sessionsToDelete.forEach((s, i) => {
-          const marker = s.id === activeSessionId ? chalk10.green("▶") : " ";
+          const marker = s.id === activeSessionId ? chalk11.green("▶") : " ";
           output.log(`  ${marker} ${s.id}`);
           output.log(`     Title: ${s.title}`);
           output.log(`     Updated: ${new Date(s.updatedAt).toLocaleString()}`);
@@ -11461,11 +11559,11 @@ var DeleteCommand = {
         return;
       }
       if (!a.force) {
-        output.log(chalk10.red(`
+        output.log(chalk11.red(`
 ⚠️  About to delete ${sessionsToDelete.length} session(s):
 `));
         sessionsToDelete.forEach((s, i) => {
-          const marker = s.id === activeSessionId ? chalk10.green("▶") : " ";
+          const marker = s.id === activeSessionId ? chalk11.green("▶") : " ";
           output.log(`  ${marker} ${s.id} - ${s.title}`);
         });
         output.log("");
@@ -11475,7 +11573,7 @@ var DeleteCommand = {
             input: process.stdin,
             output: process.stdout
           });
-          rl.question(chalk10.red("Type 'yes' to confirm deletion: "), (res) => {
+          rl.question(chalk11.red("Type 'yes' to confirm deletion: "), (res) => {
             rl.close();
             resolve(res);
           });
@@ -11503,7 +11601,7 @@ var DeleteCommand = {
         }
       }
       if (successCount > 0) {
-        output.success(chalk10.green(`✓`) + ` Deleted ${successCount} session(s)`);
+        output.success(chalk11.green(`✓`) + ` Deleted ${successCount} session(s)`);
       }
       if (failCount > 0) {
         output.error(`✗ Failed to delete ${failCount} session(s)`);
@@ -11522,7 +11620,7 @@ var DeleteCommand = {
 };
 // src/commands/sessions/messages.ts
-import chalk11 from "chalk";
+import chalk12 from "chalk";
 // src/commands/sessions/format-message-content.ts
 var TEXT_MAX_CHARS = 300;
@@ -11734,20 +11832,20 @@ var MessagesCommand = {
       } else {
         const detail = a.detail === true;
         const roleColors = {
-          user: chalk11.blue,
-          assistant: chalk11.green,
-          system: chalk11.gray,
-          tool: chalk11.yellow
+          user: chalk12.blue,
+          assistant: chalk12.green,
+          system: chalk12.gray,
+          tool: chalk12.yellow
         };
-        output.log(chalk11.bold(`┌─ Messages (${a.sessionId}) ────────────────────────┐`));
+        output.log(chalk12.bold(`┌─ Messages (${a.sessionId}) ────────────────────────┐`));
         messages.forEach((m, i) => {
-          const roleColor = roleColors[m.role] || chalk11.white;
+          const roleColor = roleColors[m.role] || chalk12.white;
           const time = new Date(m.timestamp).toLocaleTimeString("zh-CN", {
             hour: "2-digit",
             minute: "2-digit"
           });
           if (m.metadata?.isCheckpoint) {
-            output.log(chalk11.cyan("├─ #" + (a.offset + i + 1) + "  checkpoint") + "  " + chalk11.gray(time));
+            output.log(chalk12.cyan("├─ #" + (a.offset + i + 1) + "  checkpoint") + "  " + chalk12.gray(time));
             output.log("│");
             const checkpointContent = formatCheckpointContent(m.content, { detail });
             output.log("│ " + checkpointContent.split(`
@@ -11755,7 +11853,7 @@ var MessagesCommand = {
 │ `));
             output.log("│");
           } else {
-            output.log(chalk11.cyan("├─ #" + (a.offset + i + 1) + "  ") + roleColor(m.role.padEnd(10)) + "  " + chalk11.gray(time));
+            output.log(chalk12.cyan("├─ #" + (a.offset + i + 1) + "  ") + roleColor(m.role.padEnd(10)) + "  " + chalk12.gray(time));
             const rawLines = formatMessageContent(m, { detail });
             const contentLines = colorizeContentLines(rawLines, m);
             const finalLines = detail ? contentLines : contentLines.slice(0, MAX_CONTENT_LINES);
@@ -11763,7 +11861,7 @@ var MessagesCommand = {
               output.log("│ " + line);
             }
             if (!detail && contentLines.length > MAX_CONTENT_LINES) {
-              output.log("│ " + chalk11.gray(`... (truncated, total ${contentLines.length} lines)`));
+              output.log("│ " + chalk12.gray(`... (truncated, total ${contentLines.length} lines)`));
             }
             output.log("│");
           }
@@ -11771,7 +11869,7 @@ var MessagesCommand = {
         output.log("└" + "─".repeat(51) + "┘");
         const hasMore = a.offset + a.limit < totalMessages;
         const showingEnd = Math.min(a.offset + a.limit, totalMessages);
-        output.log(chalk11.gray(`Showing ${a.offset + 1}-${showingEnd} of ${totalMessages} messages` + (hasMore ? " (more available)" : "")));
+        output.log(chalk12.gray(`Showing ${a.offset + 1}-${showingEnd} of ${totalMessages} messages` + (hasMore ? " (more available)" : "")));
       }
     } catch (error) {
       output.error(`Failed to get messages: ${error instanceof Error ? error.message : String(error)}`);
@@ -11784,43 +11882,43 @@ var MessagesCommand = {
 function colorizeContentLines(lines, _m) {
   return lines.map((line) => {
     if (line.startsWith("[Tool Call]"))
-      return chalk11.cyan(line);
+      return chalk12.cyan(line);
     if (line.startsWith("[Tool Result]"))
-      return chalk11.yellow(line);
+      return chalk12.yellow(line);
     if (line === "[Reasoning]")
-      return chalk11.magenta(line);
+      return chalk12.magenta(line);
     if (line === "[Checkpoint]")
-      return chalk11.cyan(line);
+      return chalk12.cyan(line);
     if (line.startsWith("[Node Call]"))
-      return chalk11.blue(line);
+      return chalk12.blue(line);
     if (line.startsWith("[Node Interrupt]"))
-      return chalk11.yellow(line);
+      return chalk12.yellow(line);
     if (line.startsWith("[Node Resume]"))
-      return chalk11.green(line);
+      return chalk12.green(line);
     if (line.startsWith("[Node Start]"))
-      return chalk11.blue(line);
+      return chalk12.blue(line);
     if (line.startsWith("✅") || line.startsWith("❌")) {
       if (line.includes("[Node Result]"))
-        return chalk11.green(line);
+        return chalk12.green(line);
       if (line.includes("[Node End]"))
-        return chalk11.green(line);
+        return chalk12.green(line);
       return line;
     }
     if (line.startsWith("  ")) {
       if (line.startsWith("  Error:"))
-        return chalk11.red(line);
+        return chalk12.red(line);
       if (line.startsWith("  Query:"))
-        return chalk11.bold(line);
+        return chalk12.bold(line);
       if (line.startsWith("  Options:") || line.startsWith("  agentSessionId:") || line.startsWith("  Duration:"))
-        return chalk11.gray(line);
-      return chalk11.gray(line);
+        return chalk12.gray(line);
+      return chalk12.gray(line);
     }
     return line;
   });
 }
 // src/commands/sessions/compact.ts
-import chalk12 from "chalk";
+import chalk13 from "chalk";
 var CompactCommand = {
   command: "compact <session-id>",
   aliases: ["compress", "checkpoint"],
@@ -11874,13 +11972,13 @@ var CompactCommand = {
             dryRun: true
           });
         } else {
-          output.log(chalk12.bold("┌─ Compact Preview ─────────────────────────────────┐"));
+          output.log(chalk13.bold("┌─ Compact Preview ─────────────────────────────────┐"));
           output.log(`│ Session: ${session.title}`);
-          output.log(`│ Messages to compact: ${chalk12.yellow(preview.messageCountToCompact)}`);
+          output.log(`│ Messages to compact: ${chalk13.yellow(preview.messageCountToCompact)}`);
           output.log(`│ Estimated checkpoint tokens: ${preview.estimatedCheckpointTokens}`);
-          output.log(`│ Would trigger: ${preview.wouldTrigger ? chalk12.green("Yes") : chalk12.gray("No")}`);
+          output.log(`│ Would trigger: ${preview.wouldTrigger ? chalk13.green("Yes") : chalk13.gray("No")}`);
           output.log("│");
-          output.log("│ " + chalk12.gray("(Dry run - no changes made)"));
+          output.log("│ " + chalk13.gray("(Dry run - no changes made)"));
           output.log("└" + "─".repeat(51) + "┘");
         }
         return;
@@ -11895,10 +11993,10 @@ var CompactCommand = {
         try {
           scenarioHint = await sessionComponent.generateCompactHint(a.sessionId);
           if (!a.json) {
-            output.log(chalk12.bold("├─ Auto-generated Scenario Hint ──────────────────────────┤"));
-            output.log("│ " + chalk12.cyan(scenarioHint.substring(0, 70)));
+            output.log(chalk13.bold("├─ Auto-generated Scenario Hint ──────────────────────────┤"));
+            output.log("│ " + chalk13.cyan(scenarioHint.substring(0, 70)));
             if (scenarioHint.length > 70) {
-              output.log(chalk12.gray("│ ") + scenarioHint.substring(70, 140));
+              output.log(chalk13.gray("│ ") + scenarioHint.substring(70, 140));
             }
           }
         } catch (hintError) {
@@ -11945,29 +12043,29 @@ var CompactCommand = {
           }
         });
       } else {
-        output.log(chalk12.bold.green("┌─ Checkpoint Created ────────────────────────────────┐"));
+        output.log(chalk13.bold.green("┌─ Checkpoint Created ────────────────────────────────┐"));
         output.log(`│ ID:      ${result.checkpoint.id}`);
         output.log(`│ Title:   ${result.checkpoint.title}`);
         output.log(`│ Type:    compact`);
         output.log(`│ Created: ${new Date(result.checkpoint.createdAt).toLocaleString("zh-CN")}`);
-        output.log(chalk12.bold("├─ Scenario Hint ────────────────────────────────────┤"));
+        output.log(chalk13.bold("├─ Scenario Hint ────────────────────────────────────┤"));
         if (scenarioHint) {
           const hintLines = scenarioHint.split(`
 `);
           hintLines.forEach((line, i) => {
             if (i === 0) {
-              output.log(chalk12.cyan("│ " + line.substring(0, 48)));
+              output.log(chalk13.cyan("│ " + line.substring(0, 48)));
               if (line.length > 48) {
                 for (let j = 48;j < line.length; j += 48) {
-                  output.log(chalk12.gray("│ ") + line.substring(j, j + 48));
+                  output.log(chalk13.gray("│ ") + line.substring(j, j + 48));
                 }
               }
             } else {
-              output.log(chalk12.gray("│ ") + line);
+              output.log(chalk13.gray("│ ") + line);
             }
           });
         } else {
-          output.log(chalk12.gray("│ (no hint)"));
+          output.log(chalk13.gray("│ (no hint)"));
         }
         output.log("├─ Process Key Points ─────────────────────────────────┤");
         result.checkpoint.processKeyPoints.forEach((p, i) => {
@@ -11992,11 +12090,11 @@ var CompactCommand = {
           result.checkpoint.recentMessages.forEach((msg) => {
             const prefix = msg.role === "user" ? "\uD83D\uDC64" : "\uD83E\uDD16";
             const content = msg.content.length > 60 ? msg.content.substring(0, 60) + "..." : msg.content;
-            output.log(chalk12.gray(`│ ${prefix} [${msg.role}] ${content}`));
+            output.log(chalk13.gray(`│ ${prefix} [${msg.role}] ${content}`));
           });
         }
         output.log("├─ Stats ─────────────────────────────────────────────┤");
-        output.log(`│ Messages compacted: ${chalk12.yellow(result.deletedMessageCount)}`);
+        output.log(`│ Messages compacted: ${chalk13.yellow(result.deletedMessageCount)}`);
         output.log(`│ Remaining messages: ${result.remainingMessageCount}`);
         output.log(`│ Total checkpoints: ${result.checkpointCount}`);
         output.log("└" + "─".repeat(51) + "┘");
@@ -12014,7 +12112,7 @@ var CompactCommand = {
 };
 // src/commands/sessions/checkpoints.ts
-import chalk13 from "chalk";
+import chalk14 from "chalk";
 var CheckpointsCommand = {
   command: "checkpoints <session-id>",
   aliases: ["cps"],
@@ -12047,7 +12145,7 @@ var CheckpointsCommand = {
       }
       const checkpoints = await sessionComponent.getCheckpoints(a.sessionId);
       if (checkpoints.length === 0) {
-        output.log(chalk13.gray("No checkpoints for this session"));
+        output.log(chalk14.gray("No checkpoints for this session"));
         return;
       }
       if (a.json) {
@@ -12072,7 +12170,7 @@ var CheckpointsCommand = {
       if (a.detail) {
         checkpoints.reverse().forEach((cp, i) => {
           const isLatest = i === 0;
-          output.log(chalk13.bold(`┌─ Checkpoint: ${cp.title} ${isLatest ? chalk13.green("✓") : ""} ──────` + "─".repeat(Math.max(0, 30 - cp.title.length)) + "┐"));
+          output.log(chalk14.bold(`┌─ Checkpoint: ${cp.title} ${isLatest ? chalk14.green("✓") : ""} ──────` + "─".repeat(Math.max(0, 30 - cp.title.length)) + "┐"));
           output.log(`│ ID:            ${cp.id}`);
           output.log(`│ Type:          ${cp.type}`);
           output.log(`│ Message Index: ${cp.messageIndex} (${cp.messageCountBefore} messages)`);
@@ -12100,18 +12198,18 @@ var CheckpointsCommand = {
         });
       } else {
         const header = [
-          chalk13.bold("#"),
-          chalk13.bold("Title"),
-          chalk13.bold("Type"),
-          chalk13.bold("Messages"),
-          chalk13.bold("Created")
+          chalk14.bold("#"),
+          chalk14.bold("Title"),
+          chalk14.bold("Type"),
+          chalk14.bold("Messages"),
+          chalk14.bold("Created")
         ].join(" │ ");
         output.log(`┌─ Checkpoints (${checkpoints.length}) ${"─".repeat(40)}┐`);
         output.log(`│${header}│`);
         output.log("├" + "─".repeat(header.length + 2) + "┤");
         checkpoints.reverse().forEach((cp, i) => {
           const isLatest = i === 0;
-          const marker = isLatest ? chalk13.green("✓ ") : "  ";
+          const marker = isLatest ? chalk14.green("✓ ") : "  ";
           const title = cp.title.length > 25 ? cp.title.slice(0, 22) + "..." : cp.title;
           const created = new Date(cp.createdAt).toLocaleString("zh-CN", {
             month: "2-digit",
@@ -12119,7 +12217,7 @@ var CheckpointsCommand = {
             hour: "2-digit",
             minute: "2-digit"
           });
-          output.log(`│${marker}${i + 1}  ${title.padEnd(25)} │ ${cp.type.padEnd(5)} │ ${cp.messageCountBefore.toString().padStart(8)} │ ${chalk13.gray(created)}│`);
+          output.log(`│${marker}${i + 1}  ${title.padEnd(25)} │ ${cp.type.padEnd(5)} │ ${cp.messageCountBefore.toString().padStart(8)} │ ${chalk14.gray(created)}│`);
         });
         output.log("└" + "─".repeat(header.length + 2) + "┘");
       }
@@ -12133,7 +12231,7 @@ var CheckpointsCommand = {
 };
 // src/commands/sessions/active.ts
-import chalk14 from "chalk";
+import chalk15 from "chalk";
 var ActiveCommand = {
   command: "active",
   aliases: ["current"],
@@ -12160,7 +12258,7 @@ var ActiveCommand = {
         return;
       }
       if (!activeId) {
-        output.log(chalk14.gray("No active session set"));
+        output.log(chalk15.gray("No active session set"));
         return;
       }
       const session = await sessionComponent.get(activeId);
@@ -12178,10 +12276,10 @@ var ActiveCommand = {
         });
       } else {
         if (!session) {
-          output.log(chalk14.gray("Active session not found: " + activeId));
+          output.log(chalk15.gray("Active session not found: " + activeId));
           return;
         }
-        output.log(chalk14.bold.green("┌─ Active Session ─────────────────────────────────┐"));
+        output.log(chalk15.bold.green("┌─ Active Session ─────────────────────────────────┐"));
         output.log(`│ ID:          ${session.id}`);
         output.log(`│ Title:       ${session.title}`);
         output.log(`│ Directory:   ${session.directory}`);
@@ -12263,7 +12361,7 @@ var AddMessageCommand = {
 };
 // src/commands/sessions/mock.ts
-import chalk15 from "chalk";
+import chalk16 from "chalk";
 var MOCK_SEQUENCES = [
   {
     name: "文件操作流程",
@@ -12396,7 +12494,7 @@ var MockCommand = {
       for (let seqIdx = 0;seqIdx < count; seqIdx++) {
         const sequence = MOCK_SEQUENCES[seqIdx];
         if (!a.json) {
-          output.log(chalk15.bold(`
+          output.log(chalk16.bold(`
 \uD83D\uDCDD Sequence ${seqIdx + 1}: ${sequence.name}`));
         }
         for (const msg of sequence.messages) {
@@ -12414,7 +12512,7 @@ ${JSON.stringify(tc.args, null, 2)}
             if (assistantMsgId)
               addedMessages.push(assistantMsgId);
             if (!a.json) {
-              output.log(chalk15.cyan(`  [${addedMessages.length}] assistant: \uD83D\uDD27 Tool call`));
+              output.log(chalk16.cyan(`  [${addedMessages.length}] assistant: \uD83D\uDD27 Tool call`));
             }
             const toolMsgId = await sessionComponent.addMessage(a.sessionId, {
               role: "tool",
@@ -12423,7 +12521,7 @@ ${JSON.stringify(tc.args, null, 2)}
             if (toolMsgId)
               addedMessages.push(toolMsgId);
             if (!a.json) {
-              output.log(chalk15.yellow(`  [${addedMessages.length}] tool: ${msg.content.substring(0, 50)}...`));
+              output.log(chalk16.yellow(`  [${addedMessages.length}] tool: ${msg.content.substring(0, 50)}...`));
             }
           } else {
             const msgId = await sessionComponent.addMessage(a.sessionId, {
@@ -12433,7 +12531,7 @@ ${JSON.stringify(tc.args, null, 2)}
             if (msgId)
               addedMessages.push(msgId);
             if (!a.json) {
-              const roleColor = msg.role === "user" ? chalk15.green : msg.role === "assistant" ? chalk15.cyan : chalk15.gray;
+              const roleColor = msg.role === "user" ? chalk16.green : msg.role === "assistant" ? chalk16.cyan : chalk16.gray;
               output.log(roleColor(`  [${addedMessages.length}] ${msg.role}: ${msg.content.substring(0, 50)}...`));
             }
           }
@@ -12449,14 +12547,14 @@ ${JSON.stringify(tc.args, null, 2)}
         });
       } else {
         output.log(`
-` + chalk15.bold.green("✅ Mock data inserted successfully!"));
+` + chalk16.bold.green("✅ Mock data inserted successfully!"));
         output.log(`   Session: ${a.sessionId}`);
         output.log(`   Sequences: ${count}`);
         output.log(`   Messages: ${addedMessages.length}`);
         output.log("");
-        output.log(chalk15.gray("   Now run: "));
-        output.log(chalk15.gray(`   roy-agent sessions compact ${a.sessionId}`));
-        output.log(chalk15.gray("   to trigger checkpoint generation"));
+        output.log(chalk16.gray("   Now run: "));
+        output.log(chalk16.gray(`   roy-agent sessions compact ${a.sessionId}`));
+        output.log(chalk16.gray("   to trigger checkpoint generation"));
       }
     } finally {
       await envService.dispose();
@@ -12465,7 +12563,7 @@ ${JSON.stringify(tc.args, null, 2)}
 };
 // src/commands/sessions/grep.ts
-import chalk16 from "chalk";
+import chalk17 from "chalk";
 var GrepCommand = {
   command: "grep <query...>",
   aliases: ["search"],
@@ -12545,7 +12643,7 @@ var GrepCommand = {
       const results = await sessionComponent.searchMessages(searchOptions);
       if (results.length === 0) {
         if (!a.quiet) {
-          output.log(chalk16.yellow(`No results found for: ${query}`));
+          output.log(chalk17.yellow(`No results found for: ${query}`));
         }
         return;
       }
@@ -12572,7 +12670,7 @@ var GrepCommand = {
         for (const result of results) {
           for (const match of result.matches) {
             const time = new Date(match.timestamp).toLocaleString("zh-CN");
-            output.log(`${chalk16.gray(result.sessionId)} ${chalk16.blue(result.sessionTitle)} ${chalk16.gray(time)}`);
+            output.log(`${chalk17.gray(result.sessionId)} ${chalk17.blue(result.sessionTitle)} ${chalk17.gray(time)}`);
             output.log(`  ${match.content}`);
             output.log("");
           }
@@ -12584,40 +12682,40 @@ var GrepCommand = {
           totalMatches += result.matches.length;
           const time = new Date(result.updatedAt).toLocaleString("zh-CN");
           const titleStr = `─ ${result.sessionTitle} (${result.sessionId})`;
-          output.log(chalk16.bold(`
+          output.log(chalk17.bold(`
 ┌${titleStr}${"─".repeat(Math.max(0, 50 - titleStr.length))}┐`));
-          output.log(`│ ${chalk16.gray(`Updated: ${time} | ${result.messageCount} messages | ${result.matches.length} matches`)}${" ".repeat(Math.max(0, 50 - 60))}│`);
+          output.log(`│ ${chalk17.gray(`Updated: ${time} | ${result.messageCount} messages | ${result.matches.length} matches`)}${" ".repeat(Math.max(0, 50 - 60))}│`);
           for (let i = 0;i < result.matches.length; i++) {
             const match = result.matches[i];
-            const roleColor = match.role === "user" ? chalk16.blue : match.role === "assistant" ? chalk16.green : chalk16.gray;
+            const roleColor = match.role === "user" ? chalk17.blue : match.role === "assistant" ? chalk17.green : chalk17.gray;
             const msgTime = new Date(match.timestamp).toLocaleTimeString("zh-CN", {
               hour: "2-digit",
               minute: "2-digit"
             });
-            output.log(`├─ #${i + 1} ${roleColor(match.role.padEnd(10))} ${chalk16.gray(msgTime)}`);
+            output.log(`├─ #${i + 1} ${roleColor(match.role.padEnd(10))} ${chalk17.gray(msgTime)}`);
             output.log("│");
             const lines = match.content.split(`
 `).map((line) => line.trim()).filter((line) => line.length > 0);
             const maxLines = 5;
             const displayLines = lines.slice(0, maxLines);
             if (displayLines.length === 0) {
-              output.log("│   " + chalk16.gray("(empty content)"));
+              output.log("│   " + chalk17.gray("(empty content)"));
             } else {
               for (const line of displayLines) {
                 const truncated = line.length > 76 ? line.slice(0, 73) + "..." : line;
-                output.log(`│   ${chalk16.gray(truncated)}`);
+                output.log(`│   ${chalk17.gray(truncated)}`);
               }
             }
             if (lines.length > maxLines) {
-              output.log("│   " + chalk16.gray(`... (${lines.length - maxLines} more lines)`));
+              output.log("│   " + chalk17.gray(`... (${lines.length - maxLines} more lines)`));
             }
             output.log("│");
           }
           output.log(`└${"─".repeat(52)}┘`);
         }
         output.log(`
-${chalk16.green("✓")} Found ${chalk16.bold(totalMatches.toString())} matches in ${chalk16.bold(results.length.toString())} sessions`);
-        output.log(chalk16.gray(`Query: "${query}"`));
+${chalk17.green("✓")} Found ${chalk17.bold(totalMatches.toString())} matches in ${chalk17.bold(results.length.toString())} sessions`);
+        output.log(chalk17.gray(`Query: "${query}"`));
       }
     } catch (error) {
       output.error(`Search failed: ${error instanceof Error ? error.message : String(error)}`);
@@ -12656,7 +12754,7 @@ var SessionsCommand = {
 };
 // src/commands/tasks/list.ts
-import chalk17 from "chalk";
+import chalk18 from "chalk";
 // src/commands/tasks/_build-list-json.ts
 function buildListTasksJson(tasks, total, args, extras) {
@@ -12704,7 +12802,7 @@ var ListCommand2 = {
     type: "string",
     choices: ["normal", "cycle", "longterm"],
     description: "按任务类型筛选"
-  }).option("limit", { alias: "n", type: "number", default: 20, description: "返回数量" }).option("offset", { type: "number", default: 0, description: "偏移量" }).option("depth", {
+  }).option("limit", { alias: "n", type: "number", default: 20, description: "返回数量" }).option("offset", { alias: "o", type: "number", default: 0, description: "分页偏移（-o alias）" }).option("depth", {
     type: "number",
     description: "检索层级深度：0=只根任务（无父任务），1=根+一层子任务，2=根+二层子任务，-1 或忽略=全部"
   }).option("include-archived", {
@@ -12742,20 +12840,29 @@ var ListCommand2 = {
       if (args.json) {
         output.json(buildListTasksJson(tasks, total, args));
       } else if (args.quiet) {
-        tasks.forEach((t) => output.log(t.id.toString()));
+        output.log(renderQuietHeader(total, "task"));
+        tasks.forEach((t) => output.log(renderQuietLine(t.id, t.title)));
+        const hint = renderQuietPaginationHint({
+          count: tasks.length,
+          total,
+          offset: args.offset ?? 0,
+          limit: args.limit ?? 20
+        });
+        if (hint)
+          output.log(hint);
       } else {
         const header = [
-          chalk17.bold("#"),
-          chalk17.bold("Title"),
-          chalk17.bold("Status"),
-          chalk17.bold("Priority"),
-          chalk17.bold("Type"),
-          chalk17.bold("Progress"),
-          chalk17.bold("Parent")
+          chalk18.bold("#"),
+          chalk18.bold("Title"),
+          chalk18.bold("Status"),
+          chalk18.bold("Priority"),
+          chalk18.bold("Type"),
+          chalk18.bold("Progress"),
+          chalk18.bold("Parent")
         ].join(" │ ");
         const rows = tasks.map((t, i) => {
-          const statusColor = t.status === "completed" ? chalk17.green : t.status === "active" ? chalk17.blue : t.status === "paused" ? chalk17.yellow : t.status === "cancelled" ? chalk17.strikethrough : chalk17.gray;
-          const priorityColor = t.priority === "high" ? chalk17.red : t.priority === "medium" ? chalk17.yellow : chalk17.gray;
+          const statusColor = t.status === "completed" ? chalk18.green : t.status === "active" ? chalk18.blue : t.status === "paused" ? chalk18.yellow : t.status === "cancelled" ? chalk18.strikethrough : chalk18.gray;
+          const priorityColor = t.priority === "high" ? chalk18.red : t.priority === "medium" ? chalk18.yellow : chalk18.gray;
           return [
             (args.offset + i + 1).toString(),
             t.title.length > 30 ? t.title.slice(0, 27) + "..." : t.title,
@@ -12763,11 +12870,11 @@ var ListCommand2 = {
             priorityColor(t.priority),
             t.type || "normal",
             `${t.progress}%`,
-            t.parent_task_id ? `#${t.parent_task_id}` : chalk17.gray("root")
+            t.parent_task_id ? `#${t.parent_task_id}` : chalk18.gray("root")
           ].join(" │ ");
         });
-        const depthNote = args.depth !== undefined ? chalk17.gray(` depth=${args.depth}`) : "";
-        const archivedNote = args.includeArchived ? chalk17.gray(" include-archived") : "";
+        const depthNote = args.depth !== undefined ? chalk18.gray(` depth=${args.depth}`) : "";
+        const archivedNote = args.includeArchived ? chalk18.gray(" include-archived") : "";
         output.log([
           `┌─ Tasks ${"─".repeat(55)}┐`,
           `│${header}│`,
@@ -12775,7 +12882,7 @@ var ListCommand2 = {
           ...rows.map((r) => `│${r}│`),
           "└" + "─".repeat(header.length + 2) + "┘",
           "",
-          chalk17.gray(`Showing ${tasks.length} of ${total} tasks (offset=${args.offset}, limit=${args.limit})${depthNote}${archivedNote}`)
+          chalk18.gray(`Showing ${tasks.length} of ${total} tasks (offset=${args.offset}, limit=${args.limit})${depthNote}${archivedNote}`)
         ].join(`
 `));
       }
@@ -12789,7 +12896,7 @@ var ListCommand2 = {
 };
 // src/commands/tasks/get.ts
-import chalk18 from "chalk";
+import chalk19 from "chalk";
 var GetCommand2 = {
   command: "get <id>",
   aliases: ["show"],
@@ -12828,10 +12935,10 @@ var GetCommand2 = {
         if (args.json) {
           output.json(result);
         } else {
-          output.log(chalk18.bold(`
+          output.log(chalk19.bold(`
 Task #${result.task.id}: ${result.task.title}
 `));
-          output.log(`Status: ${chalk18.blue(result.task.status)} | Priority: ${result.task.priority} | Type: ${result.task.type} | Progress: ${result.task.progress}%`);
+          output.log(`Status: ${chalk19.blue(result.task.status)} | Priority: ${result.task.priority} | Type: ${result.task.type} | Progress: ${result.task.progress}%`);
           output.log(`Created: ${result.task.createdAt} | Updated: ${result.task.updatedAt}`);
           output.log(`Project Path: ${result.task.project_path}`);
           output.log(`Context: ${result.task.context}`);
@@ -12839,7 +12946,7 @@ Task #${result.task.id}: ${result.task.title}
             output.log(`
 Current Status: ${result.task.current_status}`);
           }
-          output.log(chalk18.bold(`
+          output.log(chalk19.bold(`
 Operations (${result.operations.length}):
 `));
           result.operations.forEach((op, i) => {
@@ -12859,10 +12966,10 @@ Operations (${result.operations.length}):
         if (args.json) {
           output.json(task);
         } else {
-          output.log(chalk18.bold(`
+          output.log(chalk19.bold(`
 Task #${task.id}: ${task.title}
 `));
-          output.log(`Status: ${chalk18.blue(task.status)} | Priority: ${task.priority} | Type: ${task.type} | Progress: ${task.progress}%`);
+          output.log(`Status: ${chalk19.blue(task.status)} | Priority: ${task.priority} | Type: ${task.type} | Progress: ${task.progress}%`);
           output.log(`Created: ${task.createdAt} | Updated: ${task.updatedAt}`);
           output.log(`Project Path: ${task.project_path}`);
           output.log(`Context: ${task.context}`);
@@ -12886,7 +12993,7 @@ Description: ${task.description}`);
 };
 // src/commands/tasks/create.ts
-import chalk19 from "chalk";
+import chalk20 from "chalk";
 var CreateCommand = {
   command: "create <title>",
   aliases: ["add", "new"],
@@ -12964,7 +13071,7 @@ var CreateCommand = {
       if (args.json) {
         output.json(task);
       } else {
-        output.log(chalk19.green(`
+        output.log(chalk20.green(`
 ✓ Task created: #${task.id}`));
         output.log(`  Title: ${task.title}`);
         output.log(`  Status: ${task.status}`);
@@ -12982,7 +13089,7 @@ var CreateCommand = {
 };
 // src/commands/tasks/update.ts
-import chalk20 from "chalk";
+import chalk21 from "chalk";
 var UpdateCommand = {
   command: "update <id>",
   aliases: ["set"],
@@ -13040,7 +13147,7 @@ var UpdateCommand = {
       if (args.json) {
         output.json(task);
       } else {
-        output.log(chalk20.green(`
+        output.log(chalk21.green(`
 ✓ Task updated: #${task.id}`));
         output.log(`  Title: ${task.title}`);
         output.log(`  Status: ${task.status}`);
@@ -13063,7 +13170,7 @@ var UpdateCommand = {
 };
 // src/commands/tasks/delete.ts
-import chalk21 from "chalk";
+import chalk22 from "chalk";
 var DeleteCommand2 = {
   command: "delete <id>",
   aliases: ["remove", "rm", "del"],
@@ -13099,16 +13206,16 @@ var DeleteCommand2 = {
         process.exit(1);
       }
       if (!args.force) {
-        output.log(chalk21.yellow(`Are you sure you want to delete task #${args.id}?`));
-        output.log(chalk21.yellow(`  Title: ${task.title}`));
-        output.log(chalk21.yellow(`  Status: ${task.status}`));
-        output.log(chalk21.yellow(`
+        output.log(chalk22.yellow(`Are you sure you want to delete task #${args.id}?`));
+        output.log(chalk22.yellow(`  Title: ${task.title}`));
+        output.log(chalk22.yellow(`  Status: ${task.status}`));
+        output.log(chalk22.yellow(`
 Use --force to skip this confirmation`));
         process.exit(1);
       }
       const deleted = await taskComponent.deleteTask(args.id);
       if (deleted) {
-        output.log(chalk21.green(`
+        output.log(chalk22.green(`
 ✓ Task deleted: #${args.id}`));
       } else {
         output.error(`Failed to delete task: ${args.id}`);
@@ -13124,7 +13231,7 @@ Use --force to skip this confirmation`));
 };
 // src/commands/tasks/complete.ts
-import chalk22 from "chalk";
+import chalk23 from "chalk";
 var CompleteCommand = {
   command: "complete <id>",
   aliases: ["done", "finish"],
@@ -13181,7 +13288,7 @@ var CompleteCommand = {
       if (args.json) {
         output.json(task);
       } else {
-        output.log(chalk22.green(`
+        output.log(chalk23.green(`
 ✓ Task completed: #${task.id}`));
         output.log(`  Title: ${task.title}`);
         output.log(`  Progress: ${task.progress}%`);
@@ -13197,7 +13304,7 @@ var CompleteCommand = {
 };
 // src/commands/tasks/operations.ts
-import chalk23 from "chalk";
+import chalk24 from "chalk";
 var OperationsCommand = {
   command: "operations <task-id>",
   aliases: ["ops", "log"],
@@ -13247,23 +13354,23 @@ var OperationsCommand = {
           operations
         });
       } else {
-        output.log(chalk23.bold(`
+        output.log(chalk24.bold(`
 Operations for Task #${task.id}: ${task.title}
 `));
         if (operations.length === 0) {
-          output.log(chalk23.gray("No operations found."));
+          output.log(chalk24.gray("No operations found."));
         } else {
           operations.forEach((op, i) => {
-            const actionColor = op.actionType === "completed" ? chalk23.green : op.actionType === "milestone" ? chalk23.blue : op.actionType === "problem" ? chalk23.red : chalk23.gray;
-            output.log(`${chalk23.bold(a.offset + i + 1)}. ` + actionColor(`[${op.actionType}]`) + ` ${op.actionTitle}`);
-            output.log(`   Session: ${chalk23.cyan(op.sessionId)} | Time: ${op.timestamp}`);
+            const actionColor = op.actionType === "completed" ? chalk24.green : op.actionType === "milestone" ? chalk24.blue : op.actionType === "problem" ? chalk24.red : chalk24.gray;
+            output.log(`${chalk24.bold(a.offset + i + 1)}. ` + actionColor(`[${op.actionType}]`) + ` ${op.actionTitle}`);
+            output.log(`   Session: ${chalk24.cyan(op.sessionId)} | Time: ${op.timestamp}`);
             if (op.actionDescription) {
               output.log(`   ${op.actionDescription}`);
             }
             output.log("");
           });
         }
-        output.log(chalk23.gray(`Total: ${operations.length} operations`));
+        output.log(chalk24.gray(`Total: ${operations.length} operations`));
       }
     } catch (error) {
       output.error(`Failed to list operations: ${error}`);
@@ -13275,7 +13382,7 @@ Operations for Task #${task.id}: ${task.title}
 };
 // src/commands/tasks/tree.ts
-import chalk24 from "chalk";
+import chalk25 from "chalk";
 function buildTree(tasks) {
   const byParent = new Map;
   const nodeById = new Map;
@@ -13310,7 +13417,7 @@ function printTree(nodes, prefix, isRoot, output, currentDepth, maxDepth) {
     const statusColor = colorByStatus(node.task.status);
     const typeLabel = node.task.type ? ` [${node.task.type}]` : "";
     const progressLabel = node.task.progress > 0 ? ` (${node.task.progress}%)` : "";
-    const header = `#${node.task.id}${typeLabel} ${node.task.title} ${chalk24.gray("[" + node.task.status + "]")}${progressLabel}`;
+    const header = `#${node.task.id}${typeLabel} ${node.task.title} ${chalk25.gray("[" + node.task.status + "]")}${progressLabel}`;
     output.log(prefix + connector + statusColor(header));
     if (node.children.length > 0) {
       const childPrefix = isRoot ? prefix : prefix + (isLast ? "   " : "│  ");
@@ -13321,15 +13428,15 @@ function printTree(nodes, prefix, isRoot, output, currentDepth, maxDepth) {
 function colorByStatus(status) {
   switch (status) {
     case "completed":
-      return chalk24.green;
+      return chalk25.green;
     case "active":
-      return chalk24.blue;
+      return chalk25.blue;
     case "paused":
-      return chalk24.yellow;
+      return chalk25.yellow;
     case "cancelled":
-      return chalk24.strikethrough;
+      return chalk25.strikethrough;
     default:
-      return chalk24.gray;
+      return chalk25.gray;
   }
 }
 var TreeCommand = {
@@ -13416,10 +13523,10 @@ var TreeCommand = {
       }
       const tree = buildTree(tasks);
       if (tree.length === 0) {
-        output.log(chalk24.gray("No tasks to display."));
+        output.log(chalk25.gray("No tasks to display."));
         return;
       }
-      output.log(chalk24.bold(`Task Tree (${tasks.length} tasks, ${tree.length} roots)`) + (args.rootId !== undefined ? chalk24.gray(` — subtree of #${args.rootId}`) : ""));
+      output.log(chalk25.bold(`Task Tree (${tasks.length} tasks, ${tree.length} roots)`) + (args.rootId !== undefined ? chalk25.gray(` — subtree of #${args.rootId}`) : ""));
       output.log("");
       printTree(tree, "", true, output, 0, args.maxDepth);
     } catch (error) {
@@ -13432,7 +13539,7 @@ var TreeCommand = {
 };
 // src/commands/tasks/search.ts
-import chalk25 from "chalk";
+import chalk26 from "chalk";
 var SearchCommand = {
   command: "search <keywords..>",
   aliases: ["find", "grep"],
@@ -13442,7 +13549,7 @@ var SearchCommand = {
     array: true,
     describe: "搜索关键词（多个关键词 AND 逻辑）",
     demandOption: true
-  }).option("limit", { alias: "n", type: "number", default: 20, description: "返回数量" }).option("offset", { type: "number", default: 0, description: "偏移量" }).option("status", {
+  }).option("limit", { alias: "n", type: "number", default: 20, description: "返回数量" }).option("offset", { alias: "o", type: "number", default: 0, description: "分页偏移（-o alias）" }).option("status", {
     alias: "s",
     type: "string",
     choices: ["todo", "active", "completed", "paused", "cancelled", "archived"],
@@ -13493,29 +13600,38 @@ var SearchCommand = {
       if (args.json) {
         output.json(buildListTasksJson(tasks, total, { limit: args.limit, offset: args.offset }, { keywords: args.keywords }));
       } else if (args.quiet) {
-        tasks.forEach((t) => output.log(t.id.toString()));
+        output.log(renderQuietHeader(total, "task"));
+        tasks.forEach((t) => output.log(renderQuietLine(t.id, t.title)));
+        const hint = renderQuietPaginationHint({
+          count: tasks.length,
+          total,
+          offset: args.offset ?? 0,
+          limit: args.limit ?? 20
+        });
+        if (hint)
+          output.log(hint);
       } else {
         const keywordStr = args.keywords.join(" ");
-        output.log(chalk25.bold(`
+        output.log(chalk26.bold(`
 \uD83D\uDD0D Search: "${keywordStr}" — ${total} results
 `));
         if (tasks.length === 0) {
-          output.log(chalk25.gray("  No matching tasks found."));
+          output.log(chalk26.gray("  No matching tasks found."));
           return;
         }
         for (const t of tasks) {
-          const statusColor = t.status === "completed" ? chalk25.green : t.status === "active" ? chalk25.blue : t.status === "paused" ? chalk25.yellow : t.status === "cancelled" ? chalk25.strikethrough : t.status === "archived" ? chalk25.gray : chalk25.gray;
-          const pid = t.parent_task_id ? chalk25.gray(` (#${t.parent_task_id})`) : "";
+          const statusColor = t.status === "completed" ? chalk26.green : t.status === "active" ? chalk26.blue : t.status === "paused" ? chalk26.yellow : t.status === "cancelled" ? chalk26.strikethrough : t.status === "archived" ? chalk26.gray : chalk26.gray;
+          const pid = t.parent_task_id ? chalk26.gray(` (#${t.parent_task_id})`) : "";
           output.log(`  #${t.id} ${statusColor("[" + t.status + "]")} ${t.title}${pid}`);
           if (t.current_status) {
-            output.log(`       ${chalk25.gray(t.current_status.slice(0, 80))}`);
+            output.log(`       ${chalk26.gray(t.current_status.slice(0, 80))}`);
           }
         }
         if (total > tasks.length) {
-          output.log(chalk25.gray(`
+          output.log(chalk26.gray(`
   ... and ${total - tasks.length} more. Use --offset and --limit to paginate.`));
         }
-        output.log(chalk25.gray(`  Page: ${Math.floor((args.offset || 0) / (args.limit || 20)) + 1}/${Math.ceil(total / (args.limit || 20))}`));
+        output.log(chalk26.gray(`  Page: ${Math.floor((args.offset || 0) / (args.limit || 20)) + 1}/${Math.ceil(total / (args.limit || 20))}`));
       }
     } catch (error) {
       output.error(`Failed to search tasks: ${error}`);
@@ -13775,7 +13891,7 @@ var TasksCommand = {
 };
 // src/commands/skills/list.ts
-import chalk26 from "chalk";
+import chalk27 from "chalk";
 var ListCommand3 = {
   command: "list",
   aliases: ["ls"],
@@ -13791,12 +13907,7 @@ var ListCommand3 = {
     type: "boolean",
     default: false,
     description: "JSON 输出"
-  }).option("quiet", {
-    alias: "q",
-    type: "boolean",
-    default: false,
-    description: "简洁输出"
-  }),
+  }).option("limit", PAGINATION_OPTIONS.limit).option("offset", PAGINATION_OPTIONS.offset).option("quiet", { alias: "q", type: "boolean", hidden: true }),
   async handler(args) {
     const a = args;
     const output = new OutputService2;
@@ -13813,41 +13924,61 @@ var ListCommand3 = {
         output.error("SkillComponent not available");
         process.exit(1);
       }
-      const skills = skillComponent.getSkillList();
-      const filtered = a.source && a.source !== "all" ? skills.filter((s) => s.source === a.source) : skills;
+      const allSkills = skillComponent.getSkillList();
+      const filtered = a.source && a.source !== "all" ? allSkills.filter((s) => s.source === a.source) : allSkills;
+      const total = filtered.length;
+      const page = {
+        limit: a.limit ?? 20,
+        offset: a.offset ?? 0
+      };
+      const skills = applyPagination(filtered, page);
       if (a.json) {
         output.json({
-          count: filtered.length,
-          skills: filtered.map((s) => ({
+          total,
+          count: skills.length,
+          truncated: total > skills.length,
+          limit: page.limit,
+          offset: page.offset,
+          source: a.source ?? "all",
+          skills: skills.map((s) => ({
             name: s.name,
             description: s.description,
             source: s.source
           }))
         });
       } else if (a.quiet) {
-        filtered.forEach((s) => output.log(s.name));
+        output.log(renderQuietHeader(total, "skill"));
+        skills.forEach((s) => output.log(renderQuietLine(s.name, s.name)));
+        const hint = renderQuietPaginationHint({
+          count: skills.length,
+          total,
+          offset: page.offset,
+          limit: page.limit
+        });
+        if (hint)
+          output.log(hint);
       } else {
         const header = [
-          chalk26.bold("Name"),
-          chalk26.bold("Description"),
-          chalk26.bold("Source")
+          chalk27.bold("Name"),
+          chalk27.bold("Description"),
+          chalk27.bold("Source")
         ].join(" | ");
         const sourceColor = (source) => {
           switch (source) {
             case "project":
-              return chalk26.green;
+              return chalk27.green;
             case "user":
-              return chalk26.blue;
+              return chalk27.blue;
             case "built-in":
-              return chalk26.gray;
+              return chalk27.gray;
             default:
-              return chalk26.white;
+              return chalk27.white;
           }
         };
-        const rows = filtered.map((s) => {
+        const rows = skills.map((s) => {
           const desc2 = s.description.length > 50 ? s.description.slice(0, 47) + "..." : s.description;
           return [
-            chalk26.cyan(s.name),
+            chalk27.cyan(s.name),
             desc2,
             sourceColor(s.source)(`[${s.source}]`)
           ].join(" | ");
@@ -13859,7 +13990,14 @@ var ListCommand3 = {
           ...rows.map((r) => `│${r}│`),
           "└" + "─".repeat(header.length + 2) + "┘",
           "",
-          chalk26.gray(`Total: ${filtered.length} skills`)
+          renderPaginationFooter({
+            total,
+            count: skills.length,
+            offset: page.offset,
+            limit: page.limit,
+            itemName: "skill",
+            extras: a.source && a.source !== "all" ? [`source=${a.source}`] : []
+          })
         ].join(`
 `));
       }
@@ -13873,7 +14011,7 @@ var ListCommand3 = {
 };
 // src/commands/skills/get.ts
-import chalk27 from "chalk";
+import chalk28 from "chalk";
 var GetCommand3 = {
   command: "get <name>",
   describe: "获取指定技能内容",
@@ -13917,13 +14055,13 @@ var GetCommand3 = {
           content: skill.content
         });
       } else {
-        output.log(chalk27.bold.cyan(`# ${skill.name}`));
+        output.log(chalk28.bold.cyan(`# ${skill.name}`));
         output.log("");
-        output.log(`${chalk27.gray("Description:")} ${skill.description}`);
-        output.log(`${chalk27.gray("Source:")} ${skill.source}`);
-        output.log(`${chalk27.gray("File:")} ${skill.filePath}`);
+        output.log(`${chalk28.gray("Description:")} ${skill.description}`);
+        output.log(`${chalk28.gray("Source:")} ${skill.source}`);
+        output.log(`${chalk28.gray("File:")} ${skill.filePath}`);
         output.log("");
-        output.log(chalk27.bold("--- Content ---"));
+        output.log(chalk28.bold("--- Content ---"));
         output.log("");
         output.log(skill.content);
       }
@@ -13937,7 +14075,7 @@ var GetCommand3 = {
 };
 // src/commands/skills/search.ts
-import chalk28 from "chalk";
+import chalk29 from "chalk";
 var SearchCommand2 = {
   command: "search <term>",
   aliases: ["find"],
@@ -13976,7 +14114,7 @@ var SearchCommand2 = {
       const term = args.term.toLowerCase();
       const results = allSkills.filter((s) => s.name.toLowerCase().includes(term) || s.description.toLowerCase().includes(term));
       if (results.length === 0) {
-        output.log(chalk28.yellow(`No skills found matching: ${args.term}`));
+        output.log(chalk29.yellow(`No skills found matching: ${args.term}`));
         return;
       }
       if (args.json) {
@@ -13993,19 +14131,19 @@ var SearchCommand2 = {
       } else if (args.quiet) {
         results.forEach((s) => output.log(s.name));
       } else {
-        output.log(chalk28.bold(`Search results for "${args.term}":`));
+        output.log(chalk29.bold(`Search results for "${args.term}":`));
         output.log("");
         const header = [
-          chalk28.bold("Name"),
-          chalk28.bold("Description"),
-          chalk28.bold("Match")
+          chalk29.bold("Name"),
+          chalk29.bold("Description"),
+          chalk29.bold("Match")
         ].join(" | ");
         const rows = results.map((s) => {
           const matchedIn = s.name.toLowerCase().includes(term) ? "name" : "description";
-          const matchColor = matchedIn === "name" ? chalk28.green : chalk28.blue;
+          const matchColor = matchedIn === "name" ? chalk29.green : chalk29.blue;
           const desc2 = s.description.length > 40 ? s.description.slice(0, 37) + "..." : s.description;
           return [
-            chalk28.cyan(s.name),
+            chalk29.cyan(s.name),
             desc2,
             matchColor(`[${matchedIn}]`)
           ].join(" | ");
@@ -14017,7 +14155,7 @@ var SearchCommand2 = {
           ...rows.map((r) => `│${r}│`),
           "└" + "─".repeat(header.length + 2) + "┘",
           "",
-          chalk28.gray(`${results.length} matching skill(s) found.`)
+          chalk29.gray(`${results.length} matching skill(s) found.`)
         ].join(`
 `));
       }
@@ -14031,7 +14169,7 @@ var SearchCommand2 = {
 };
 // src/commands/skills/reload.ts
-import chalk29 from "chalk";
+import chalk30 from "chalk";
 var ReloadCommand = {
   command: "reload",
   describe: "重新扫描并更新 SkillTool",
@@ -14054,10 +14192,10 @@ var ReloadCommand = {
         output.error("SkillComponent not available");
         process.exit(1);
       }
-      output.log(chalk29.blue("Reloading skills..."));
+      output.log(chalk30.blue("Reloading skills..."));
       await skillComponent.reload();
       const skills = skillComponent.getSkillList();
-      output.log(chalk29.green(`Successfully reloaded ${skills.length} skills`));
+      output.log(chalk30.green(`Successfully reloaded ${skills.length} skills`));
     } catch (error) {
       output.error(`Failed to reload skills: ${error}`);
       process.exit(1);
@@ -14068,7 +14206,7 @@ var ReloadCommand = {
 };
 // src/commands/skills/show-config.ts
-import chalk30 from "chalk";
+import chalk31 from "chalk";
 var ShowConfigCommand = {
   command: "show-config",
   aliases: ["config"],
@@ -14093,38 +14231,38 @@ var ShowConfigCommand = {
         process.exit(1);
       }
       const defaultConfig = skillComponent.getConfig?.();
-      output.log(chalk30.bold.cyan(`# Skills Configuration
+      output.log(chalk31.bold.cyan(`# Skills Configuration
 `));
-      output.log(chalk30.bold(`## Scan Paths
+      output.log(chalk31.bold(`## Scan Paths
 `));
       const paths = [
         { type: "user", desc: "用户路径", path: "~/.config/roy-agent/skills/" },
         { type: "project", desc: "项目路径", path: ".roy/skills/" }
       ];
       for (const p of paths) {
-        const typeColor = p.type === "project" ? chalk30.green : chalk30.blue;
-        output.log(`  ${typeColor("[ " + p.type + " ]")} ${chalk30.gray(p.desc)}`);
-        output.log(`         ${chalk30.cyan(p.path)}
+        const typeColor = p.type === "project" ? chalk31.green : chalk31.blue;
+        output.log(`  ${typeColor("[ " + p.type + " ]")} ${chalk31.gray(p.desc)}`);
+        output.log(`         ${chalk31.cyan(p.path)}
 `);
       }
-      output.log(chalk30.bold(`## Scan Rules
+      output.log(chalk31.bold(`## Scan Rules
 `));
-      output.log(`  ${chalk30.gray("Pattern:")} ${chalk30.cyan("**/SKILL.md")}`);
-      output.log(`  ${chalk30.gray("Recursive:")} ${chalk30.green("true")}`);
-      output.log(`  ${chalk30.gray("Ignore:")} ${chalk30.cyan("**/node_modules/**")}
+      output.log(`  ${chalk31.gray("Pattern:")} ${chalk31.cyan("**/SKILL.md")}`);
+      output.log(`  ${chalk31.gray("Recursive:")} ${chalk31.green("true")}`);
+      output.log(`  ${chalk31.gray("Ignore:")} ${chalk31.cyan("**/node_modules/**")}
 `);
-      output.log(chalk30.bold(`## Priority (High to Low)
+      output.log(chalk31.bold(`## Priority (High to Low)
 `));
-      output.log(`  ${chalk30.green("1. project")} - 项目路径（最高优先级）`);
-      output.log(`  ${chalk30.blue("2. user")} - 用户路径`);
-      output.log(`  ${chalk30.gray("3. built-in")} - 内置路径（预留）
+      output.log(`  ${chalk31.green("1. project")} - 项目路径（最高优先级）`);
+      output.log(`  ${chalk31.blue("2. user")} - 用户路径`);
+      output.log(`  ${chalk31.gray("3. built-in")} - 内置路径（预留）
 `);
-      output.log(chalk30.bold(`## Usage
+      output.log(chalk31.bold(`## Usage
 `));
-      output.log(`  ${chalk30.cyan("roy-agent skills list")} ${chalk30.gray("- 列出所有技能")}`);
-      output.log(`  ${chalk30.cyan("roy-agent skills get <name>")} ${chalk30.gray("- 获取技能内容")}`);
-      output.log(`  ${chalk30.cyan("roy-agent skills search <term>")} ${chalk30.gray("- 搜索技能")}`);
-      output.log(`  ${chalk30.cyan("roy-agent skills reload")} ${chalk30.gray("- 重新扫描技能")}`);
+      output.log(`  ${chalk31.cyan("roy-agent skills list")} ${chalk31.gray("- 列出所有技能")}`);
+      output.log(`  ${chalk31.cyan("roy-agent skills get <name>")} ${chalk31.gray("- 获取技能内容")}`);
+      output.log(`  ${chalk31.cyan("roy-agent skills search <term>")} ${chalk31.gray("- 搜索技能")}`);
+      output.log(`  ${chalk31.cyan("roy-agent skills reload")} ${chalk31.gray("- 重新扫描技能")}`);
     } catch (error) {
       output.error(`Failed to show config: ${error}`);
       process.exit(1);
@@ -14145,7 +14283,7 @@ var SkillsCommand = {
 };
 // src/commands/agents/list.ts
-import chalk31 from "chalk";
+import chalk32 from "chalk";
 var ListCommand4 = {
   command: "list",
   aliases: ["ls"],
@@ -14161,12 +14299,7 @@ var ListCommand4 = {
     type: "boolean",
     default: false,
     description: "JSON 输出"
-  }).option("quiet", {
-    alias: "q",
-    type: "boolean",
-    default: false,
-    description: "简洁输出"
-  }),
+  }).option("limit", PAGINATION_OPTIONS.limit).option("offset", PAGINATION_OPTIONS.offset).option("quiet", { alias: "q", type: "boolean", hidden: true }),
   async handler(args) {
     const output = new OutputService2;
     const envService = new EnvironmentService(output);
@@ -14198,10 +14331,21 @@ var ListCommand4 = {
       } else {
         agents = registry.list();
       }
+      const total = agents.length;
+      const page = {
+        limit: args.limit ?? 20,
+        offset: args.offset ?? 0
+      };
+      const pagedAgents = applyPagination(agents, page);
       if (args.json) {
         output.json({
-          count: agents.length,
-          agents: agents.map((a) => ({
+          total,
+          count: pagedAgents.length,
+          truncated: total > pagedAgents.length,
+          limit: page.limit,
+          offset: page.offset,
+          type: args.type ?? "all",
+          agents: pagedAgents.map((a) => ({
             name: a.name,
             type: a.type,
             source: builtInSubAgentNames.has(a.name) ? "built-in" : "user",
@@ -14213,30 +14357,39 @@ var ListCommand4 = {
           }))
         });
       } else if (args.quiet) {
-        agents.forEach((a) => output.log(a.name));
+        output.log(renderQuietHeader(total, "agent"));
+        pagedAgents.forEach((a) => output.log(renderQuietLine(a.name, a.name)));
+        const hint = renderQuietPaginationHint({
+          count: pagedAgents.length,
+          total,
+          offset: page.offset,
+          limit: page.limit
+        });
+        if (hint)
+          output.log(hint);
       } else {
         const header = [
-          chalk31.bold("Name"),
-          chalk31.bold("Type"),
-          chalk31.bold("Source"),
-          chalk31.bold("Model"),
-          chalk31.bold("Workflow"),
-          chalk31.bold("Description")
+          chalk32.bold("Name"),
+          chalk32.bold("Type"),
+          chalk32.bold("Source"),
+          chalk32.bold("Model"),
+          chalk32.bold("Workflow"),
+          chalk32.bold("Description")
         ].join(" | ");
         const typeColor = (type) => {
           if (type === "primary")
-            return chalk31.yellow;
+            return chalk32.yellow;
           if (type === "workflow")
-            return chalk31.magenta;
-          return chalk31.blue;
+            return chalk32.magenta;
+          return chalk32.blue;
         };
-        const rows = agents.map((a) => {
+        const rows = pagedAgents.map((a) => {
           const desc2 = (a.description || "").length > 40 ? (a.description || "").slice(0, 37) + "..." : a.description || "-";
-          const workflowDisplay = a.type === "workflow" && a.workflow ? chalk31.cyan(a.workflow.length > 30 ? a.workflow.slice(0, 27) + "..." : a.workflow) : chalk31.gray("-");
-          const modelDisplay = a.model ? chalk31.yellow(a.model.length > 20 ? a.model.slice(0, 17) + "..." : a.model) : chalk31.gray("-");
-          const sourceDisplay = builtInSubAgentNames.has(a.name) ? chalk31.green("built-in") : chalk31.gray("user");
+          const workflowDisplay = a.type === "workflow" && a.workflow ? chalk32.cyan(a.workflow.length > 30 ? a.workflow.slice(0, 27) + "..." : a.workflow) : chalk32.gray("-");
+          const modelDisplay = a.model ? chalk32.yellow(a.model.length > 20 ? a.model.slice(0, 17) + "..." : a.model) : chalk32.gray("-");
+          const sourceDisplay = builtInSubAgentNames.has(a.name) ? chalk32.green("built-in") : chalk32.gray("user");
           return [
-            chalk31.cyan(a.name),
+            chalk32.cyan(a.name),
             typeColor(a.type)(a.type),
             sourceDisplay,
             modelDisplay,
@@ -14245,9 +14398,9 @@ var ListCommand4 = {
           ].join(" | ");
         });
         if (rows.length === 0) {
-          output.log(chalk31.yellow("No agents found."));
+          output.log(chalk32.yellow("No agents found."));
           output.log("");
-          output.log(chalk31.gray("Tip: Create agent configs in ~/.local/share/roy-agent/agents/"));
+          output.log(chalk32.gray("Tip: Create agent configs in ~/.local/share/roy-agent/agents/"));
         } else {
           output.log([
             `┌─ Agents ${"─".repeat(50)}┐`,
@@ -14256,7 +14409,14 @@ var ListCommand4 = {
             ...rows.map((r) => `│${r}│`),
             "└" + "─".repeat(header.length + 2) + "┘",
             "",
-            chalk31.gray(`Total: ${agents.length} agents`)
+            renderPaginationFooter({
+              total,
+              count: pagedAgents.length,
+              offset: page.offset,
+              limit: page.limit,
+              itemName: "agent",
+              extras: args.type && args.type !== "all" ? [`type=${args.type}`] : []
+            })
           ].join(`
 `));
         }
@@ -14271,7 +14431,7 @@ var ListCommand4 = {
 };
 // src/commands/agents/get.ts
-import chalk32 from "chalk";
+import chalk33 from "chalk";
 var GetCommand4 = {
   command: "get <name>",
   describe: "获取指定 agent 的详细信息",
@@ -14330,69 +14490,69 @@ var GetCommand4 = {
           filterHistory: agent.filterHistory
         });
       } else {
-        output.log(chalk32.bold.cyan(`# Agent: ${agent.name}`));
+        output.log(chalk33.bold.cyan(`# Agent: ${agent.name}`));
         output.log("");
-        output.log(chalk32.bold("Basic Info:"));
-        output.log(`  ${chalk32.cyan("name:")} ${agent.name}`);
-        output.log(`  ${chalk32.cyan("type:")} ${agent.type}`);
+        output.log(chalk33.bold("Basic Info:"));
+        output.log(`  ${chalk33.cyan("name:")} ${agent.name}`);
+        output.log(`  ${chalk33.cyan("type:")} ${agent.type}`);
         if (agent.description) {
-          output.log(`  ${chalk32.cyan("description:")} ${agent.description}`);
+          output.log(`  ${chalk33.cyan("description:")} ${agent.description}`);
         }
         output.log("");
         if (agent.type === "workflow") {
-          output.log(chalk32.bold("Workflow:"));
+          output.log(chalk33.bold("Workflow:"));
           if (agent.workflow) {
-            output.log(`  ${chalk32.cyan("workflow:")} ${agent.workflow}`);
-            output.log(`  ${chalk32.gray("→")} ${chalk32.gray(`roy-agent workflow run ${agent.workflow} --input '{"query":"..."}'`)}`);
+            output.log(`  ${chalk33.cyan("workflow:")} ${agent.workflow}`);
+            output.log(`  ${chalk33.gray("→")} ${chalk33.gray(`roy-agent workflow run ${agent.workflow} --input '{"query":"..."}'`)}`);
           } else {
-            output.log(`  ${chalk32.gray("(no workflow configured)")}`);
+            output.log(`  ${chalk33.gray("(no workflow configured)")}`);
           }
           output.log("");
         }
-        output.log(chalk32.bold("System Prompt:"));
+        output.log(chalk33.bold("System Prompt:"));
         if (agent.systemPromptRef) {
-          output.log(`  ${chalk32.green("[ref]")} ${chalk32.cyan("systemPromptRef:")} ${agent.systemPromptRef}`);
+          output.log(`  ${chalk33.green("[ref]")} ${chalk33.cyan("systemPromptRef:")} ${agent.systemPromptRef}`);
         }
         if (agent.systemPrompt && !agent.systemPromptRef) {
           const promptPreview = agent.systemPrompt.length > 100 ? agent.systemPrompt.slice(0, 97) + "..." : agent.systemPrompt;
-          output.log(`  ${chalk32.gray("[inline]")}`);
-          output.log(`  ${chalk32.gray(promptPreview.split(`
+          output.log(`  ${chalk33.gray("[inline]")}`);
+          output.log(`  ${chalk33.gray(promptPreview.split(`
 `).join(`
   `))}`);
         }
         if (resolvedSystemPrompt) {
           const resolvedPreview = resolvedSystemPrompt.length > 200 ? resolvedSystemPrompt.slice(0, 197) + "..." : resolvedSystemPrompt;
-          output.log(`  ${chalk32.green("[resolved]")}`);
-          output.log(`  ${chalk32.gray(resolvedPreview.split(`
+          output.log(`  ${chalk33.green("[resolved]")}`);
+          output.log(`  ${chalk33.gray(resolvedPreview.split(`
 `).join(`
   `))}`);
         }
         if (!agent.systemPromptRef && !agent.systemPrompt && !resolvedSystemPrompt) {
-          output.log(`  ${chalk32.gray("(none)")}`);
+          output.log(`  ${chalk33.gray("(none)")}`);
         }
         output.log("");
         const hasOptions = agent.model || agent.maxIterations || agent.toolTimeout;
         if (hasOptions) {
-          output.log(chalk32.bold("Options:"));
+          output.log(chalk33.bold("Options:"));
           if (agent.model) {
-            output.log(`  ${chalk32.cyan("model:")} ${agent.model}`);
+            output.log(`  ${chalk33.cyan("model:")} ${agent.model}`);
           }
           if (agent.maxIterations) {
-            output.log(`  ${chalk32.cyan("maxIterations:")} ${agent.maxIterations}`);
+            output.log(`  ${chalk33.cyan("maxIterations:")} ${agent.maxIterations}`);
           }
           if (agent.toolTimeout) {
-            output.log(`  ${chalk32.cyan("toolTimeout:")} ${agent.toolTimeout}ms`);
+            output.log(`  ${chalk33.cyan("toolTimeout:")} ${agent.toolTimeout}ms`);
           }
           output.log("");
         }
         const hasTools = agent.allowedTools?.length || agent.deniedTools?.length;
         if (hasTools) {
-          output.log(chalk32.bold("Tool Permissions:"));
+          output.log(chalk33.bold("Tool Permissions:"));
           if (agent.allowedTools?.length) {
-            output.log(`  ${chalk32.green("allowed:")} ${agent.allowedTools.join(", ")}`);
+            output.log(`  ${chalk33.green("allowed:")} ${agent.allowedTools.join(", ")}`);
           }
           if (agent.deniedTools?.length) {
-            output.log(`  ${chalk32.red("denied:")} ${agent.deniedTools.join(", ")}`);
+            output.log(`  ${chalk33.red("denied:")} ${agent.deniedTools.join(", ")}`);
           }
           output.log("");
         }
@@ -14407,7 +14567,7 @@ var GetCommand4 = {
 };
 // src/commands/agents/add.ts
-import chalk33 from "chalk";
+import chalk34 from "chalk";
 function parseToolList(value) {
   if (!value?.trim()) {
     return;
@@ -14499,8 +14659,8 @@ var AddCommand = {
       if (args.json) {
         output.json({ agent, filePath });
       } else {
-        output.log(chalk33.green(`✓ Agent '${args.name}' created`));
-        output.log(chalk33.gray(`  ${filePath}`));
+        output.log(chalk34.green(`✓ Agent '${args.name}' created`));
+        output.log(chalk34.gray(`  ${filePath}`));
       }
     } catch (error) {
       output.error(`Failed to add agent: ${error}`);
@@ -14512,7 +14672,7 @@ var AddCommand = {
 };
 // src/commands/agents/delete.ts
-import chalk34 from "chalk";
+import chalk35 from "chalk";
 var DeleteCommand3 = {
   command: "delete <name>",
   describe: "删除 agent 配置文件",
@@ -14554,7 +14714,7 @@ var DeleteCommand3 = {
       }
       const filePath = registry.getAgentFilePath(args.name);
       if (!args.yes) {
-        output.log(chalk34.yellow(`Delete agent '${args.name}'? This removes ${filePath} (use --yes to skip confirmation)`));
+        output.log(chalk35.yellow(`Delete agent '${args.name}'? This removes ${filePath} (use --yes to skip confirmation)`));
         process.exit(1);
       }
       const deleted = await registry.deleteAgent(args.name);
@@ -14565,7 +14725,7 @@ var DeleteCommand3 = {
       if (args.json) {
         output.json({ deleted: true, name: args.name, filePath });
       } else {
-        output.log(chalk34.green(`✓ Agent '${args.name}' deleted`));
+        output.log(chalk35.green(`✓ Agent '${args.name}' deleted`));
       }
     } catch (error) {
       output.error(`Failed to delete agent: ${error}`);
@@ -14577,7 +14737,7 @@ var DeleteCommand3 = {
 };
 // src/commands/agents/config-dir.ts
-import chalk35 from "chalk";
+import chalk36 from "chalk";
 var ConfigDirCommand = {
   command: "config-dir",
   describe: "显示 agent 配置目录路径",
@@ -14608,8 +14768,8 @@ var ConfigDirCommand = {
       if (args.json) {
         output.json({ configDir, exists });
       } else {
-        output.log(`${chalk35.cyan("Agent Config Directory:")} ${configDir}`);
-        output.log(`${chalk35.gray("Exists:")} ${exists ? "yes" : "no"}`);
+        output.log(`${chalk36.cyan("Agent Config Directory:")} ${configDir}`);
+        output.log(`${chalk36.gray("Exists:")} ${exists ? "yes" : "no"}`);
       }
     } catch (error) {
       output.error(`Failed to get config dir: ${error}`);
@@ -14632,7 +14792,7 @@ var AgentsCommand = {
 };
 // src/commands/prompt/list.ts
-import chalk36 from "chalk";
+import chalk37 from "chalk";
 var ListCommand5 = {
   command: "list",
   aliases: ["ls"],
@@ -14648,12 +14808,7 @@ var ListCommand5 = {
     type: "boolean",
     default: false,
     description: "JSON 输出"
-  }).option("quiet", {
-    alias: "q",
-    type: "boolean",
-    default: false,
-    description: "简洁输出"
-  }),
+  }).option("limit", PAGINATION_OPTIONS.limit).option("offset", PAGINATION_OPTIONS.offset).option("quiet", { alias: "q", type: "boolean", hidden: true }),
   async handler(args) {
     const output = new OutputService2;
     const envService = new EnvironmentService(output);
@@ -14669,36 +14824,54 @@ var ListCommand5 = {
         output.error("PromptComponent not available");
         process.exit(1);
       }
-      let prompts = promptComponent.listEntries().map((entry) => ({
+      const allPrompts = promptComponent.listEntries().map((entry) => ({
         name: entry.name,
         source: entry.source
       }));
-      if (args.source && args.source !== "all") {
-        prompts = prompts.filter((p) => p.source === args.source);
-      }
+      const filtered = args.source && args.source !== "all" ? allPrompts.filter((p) => p.source === args.source) : allPrompts;
+      const total = filtered.length;
+      const page = {
+        limit: args.limit ?? 20,
+        offset: args.offset ?? 0
+      };
+      const prompts = applyPagination(filtered, page);
       if (args.json) {
         output.json({
+          total,
+          count: prompts.length,
+          truncated: total > prompts.length,
+          limit: page.limit,
+          offset: page.offset,
+          source: args.source ?? "all",
           prompts: prompts.map((p) => ({
             name: p.name,
             source: p.source
-          })),
-          count: prompts.length
+          }))
         });
       } else if (args.quiet) {
-        prompts.forEach((p) => output.log(p.name));
+        output.log(renderQuietHeader(total, "prompt"));
+        prompts.forEach((p) => output.log(renderQuietLine(p.name, p.name)));
+        const hint = renderQuietPaginationHint({
+          count: prompts.length,
+          total,
+          offset: page.offset,
+          limit: page.limit
+        });
+        if (hint)
+          output.log(hint);
       } else {
         const header = [
-          chalk36.bold("Name"),
-          chalk36.bold("Source")
+          chalk37.bold("Name"),
+          chalk37.bold("Source")
         ].join(" | ");
         const rows = prompts.map((p) => {
           return [
-            chalk36.cyan(p.name),
-            chalk36.gray(`[${p.source}]`)
+            chalk37.cyan(p.name),
+            chalk37.gray(`[${p.source}]`)
           ].join(" | ");
         });
         if (rows.length === 0) {
-          output.log(chalk36.yellow("No prompts found."));
+          output.log(chalk37.yellow("No prompts found."));
         } else {
           output.log([
             `┌─ Prompts ${"─".repeat(50)}┐`,
@@ -14707,7 +14880,14 @@ var ListCommand5 = {
             ...rows.map((r) => `│${r}│`),
             "└" + "─".repeat(header.length + 2) + "┘",
             "",
-            chalk36.gray(`Total: ${prompts.length} prompts`)
+            renderPaginationFooter({
+              total,
+              count: prompts.length,
+              offset: page.offset,
+              limit: page.limit,
+              itemName: "prompt",
+              extras: args.source && args.source !== "all" ? [`source=${args.source}`] : []
+            })
           ].join(`
 `));
         }
@@ -14722,7 +14902,7 @@ var ListCommand5 = {
 };
 // src/commands/prompt/get.ts
-import chalk37 from "chalk";
+import chalk38 from "chalk";
 var GetCommand5 = {
   command: "get <name>",
   describe: "获取指定 prompt 的内容",
@@ -14769,16 +14949,16 @@ var GetCommand5 = {
           variables: vars
         });
       } else {
-        output.log(chalk37.bold.cyan(`# Prompt: ${args.name}`));
+        output.log(chalk38.bold.cyan(`# Prompt: ${args.name}`));
         output.log("");
         if (Object.keys(vars).length > 0) {
-          output.log(chalk37.gray("Variables:"));
+          output.log(chalk38.gray("Variables:"));
           for (const [key, value] of Object.entries(vars)) {
-            output.log(`  ${chalk37.cyan(key + ":")} ${value}`);
+            output.log(`  ${chalk38.cyan(key + ":")} ${value}`);
           }
           output.log("");
         }
-        output.log(chalk37.bold("Content:"));
+        output.log(chalk38.bold("Content:"));
         output.log("─".repeat(60));
         output.log(prompt);
         output.log("─".repeat(60));
@@ -14808,7 +14988,7 @@ function parseVars(vars) {
 // src/commands/prompt/add.ts
 import { readFile as readFile2 } from "fs/promises";
-import chalk38 from "chalk";
+import chalk39 from "chalk";
 var AddCommand2 = {
   command: "add <name>",
   describe: "添加 prompt 并持久化到 ~/.local/share/roy-agent/prompts/",
@@ -14859,8 +15039,8 @@ var AddCommand2 = {
           length: content.trim().length
         });
       } else {
-        output.log(chalk38.green(`✓ Prompt '${args.name}' saved`));
-        output.log(chalk38.gray(`  ${filePath}`));
+        output.log(chalk39.green(`✓ Prompt '${args.name}' saved`));
+        output.log(chalk39.gray(`  ${filePath}`));
       }
     } catch (error) {
       output.error(`Failed to add prompt: ${error}`);
@@ -14872,7 +15052,7 @@ var AddCommand2 = {
 };
 // src/commands/prompt/config-dir.ts
-import chalk39 from "chalk";
+import chalk40 from "chalk";
 var ConfigDirCommand2 = {
   command: "config-dir",
   describe: "显示 prompt 持久化目录路径",
@@ -14902,8 +15082,8 @@ var ConfigDirCommand2 = {
       if (args.json) {
         output.json({ configDir, exists });
       } else {
-        output.log(`${chalk39.cyan("Prompt Config Directory:")} ${configDir}`);
-        output.log(`${chalk39.gray("Exists:")} ${exists ? "yes" : "no"}`);
+        output.log(`${chalk40.cyan("Prompt Config Directory:")} ${configDir}`);
+        output.log(`${chalk40.gray("Exists:")} ${exists ? "yes" : "no"}`);
       }
     } catch (error) {
       output.error(`Failed to get config dir: ${error}`);
@@ -14925,7 +15105,7 @@ var PromptCommand = {
 };
 // src/commands/commands-list.ts
-import chalk40 from "chalk";
+import chalk41 from "chalk";
 function truncateVisual(str, maxWidth) {
   let result = "";
   let width = 0;
@@ -14940,16 +15120,16 @@ function truncateVisual(str, maxWidth) {
 }
 function formatCommandsTable(commands) {
   if (commands.length === 0) {
-    return chalk40.yellow("命令目录为空，使用 'roy-agent commands add' 添加命令");
+    return chalk41.yellow("命令目录为空，使用 'roy-agent commands add' 添加命令");
   }
   const NAME_WIDTH = 20;
   const SOURCE_WIDTH = 10;
   const DESC_WIDTH = 50;
   const GAP = "  ";
   const headerLine = [
-    chalk40.bold("NAME".padEnd(NAME_WIDTH)),
-    chalk40.bold("SOURCE".padEnd(SOURCE_WIDTH)),
-    chalk40.bold("DESCRIPTION")
+    chalk41.bold("NAME".padEnd(NAME_WIDTH)),
+    chalk41.bold("SOURCE".padEnd(SOURCE_WIDTH)),
+    chalk41.bold("DESCRIPTION")
   ].join(GAP);
   const sepLine = "─".repeat(NAME_WIDTH + SOURCE_WIDTH + DESC_WIDTH + GAP.length * 2);
   const formatRow = (cmd) => {
@@ -14973,7 +15153,7 @@ var CommandsListCommand = {
     describe: "JSON 格式输出",
     type: "boolean",
     default: false
-  }).option("config", {
+  }).option("limit", PAGINATION_OPTIONS.limit).option("offset", PAGINATION_OPTIONS.offset).option("quiet", { alias: "q", type: "boolean", hidden: true }).option("config", {
     describe: "配置文件路径",
     type: "string"
   }),
@@ -14993,18 +15173,41 @@ var CommandsListCommand = {
         process.exit(1);
       }
       const result = await commandsComponent.discover({ pattern: args.pattern });
+      const total = result.commands.length;
+      const page = {
+        limit: args.limit ?? 20,
+        offset: args.offset ?? 0
+      };
+      const commands = applyPagination(result.commands, page);
       if (args.json) {
         output.json({
-          commands: result.commands.map((cmd) => ({
+          total,
+          count: commands.length,
+          truncated: total > commands.length,
+          limit: page.limit,
+          offset: page.offset,
+          pattern: args.pattern ?? null,
+          stats: result.stats,
+          commands: commands.map((cmd) => ({
             name: cmd.name,
             path: cmd.path,
             source: cmd.source,
             description: cmd.shortDescription
-          })),
-          stats: result.stats
+          }))
+        });
+      } else if (args.quiet) {
+        output.log(renderQuietHeader(total, "command"));
+        commands.forEach((cmd) => output.log(renderQuietLine(cmd.name, cmd.name)));
+        const hint = renderQuietPaginationHint({
+          count: commands.length,
+          total,
+          offset: page.offset,
+          limit: page.limit
         });
+        if (hint)
+          output.log(hint);
       } else {
-        const rows = result.commands.map((cmd) => ({
+        const rows = commands.map((cmd) => ({
           name: cmd.name,
           path: cmd.path,
           source: cmd.source === "user" ? "USER" : "PROJECT",
@@ -15012,7 +15215,17 @@ var CommandsListCommand = {
         }));
         output.log(formatCommandsTable(rows));
         output.info("");
-        output.log(chalk40.green(`✅ 共 ${result.commands.length} 个命令`) + chalk40.gray(` (user: ${result.stats.userCount}, project: ${result.stats.projectCount})`));
+        output.log(renderPaginationFooter({
+          total,
+          count: commands.length,
+          offset: page.offset,
+          limit: page.limit,
+          itemName: "command",
+          extras: [
+            `user:${result.stats.userCount}`,
+            `project:${result.stats.projectCount}`
+          ]
+        }));
       }
     } catch (error) {
       output.error(`Failed to list commands: ${error}`);
@@ -15024,7 +15237,7 @@ var CommandsListCommand = {
 };
 // src/commands/commands-add.ts
-import chalk41 from "chalk";
+import chalk42 from "chalk";
 var CommandsAddCommand = {
   command: "add <name> <target>",
   describe: "添加收藏命令（自动创建 symlink）",
@@ -15085,10 +15298,10 @@ var CommandsAddCommand = {
       });
       const dirs = await commandsComponent.getCommandDirs();
       const targetDir = source === "user" ? dirs.user : dirs.project;
-      output.log(chalk41.green(`✅ 已添加命令 '${args.name}'`));
-      output.log(chalk41.gray(`   目标: ${args.target}`));
-      output.log(chalk41.gray(`   位置: ${targetDir}/${args.name}`));
-      output.log(chalk41.gray(`   级别: ${source === "user" ? "USER" : "PROJECT"}`));
+      output.log(chalk42.green(`✅ 已添加命令 '${args.name}'`));
+      output.log(chalk42.gray(`   目标: ${args.target}`));
+      output.log(chalk42.gray(`   位置: ${targetDir}/${args.name}`));
+      output.log(chalk42.gray(`   级别: ${source === "user" ? "USER" : "PROJECT"}`));
     } catch (error) {
       output.error(`添加失败: ${error.message}`);
       process.exit(1);
@@ -15099,7 +15312,7 @@ var CommandsAddCommand = {
 };
 // src/commands/commands-remove.ts
-import chalk42 from "chalk";
+import chalk43 from "chalk";
 var CommandsRemoveCommand = {
   command: "remove <name>",
   aliases: ["rm"],
@@ -15143,7 +15356,7 @@ var CommandsRemoveCommand = {
             name: args.name,
             source: "user"
           });
-          output.log(chalk42.green(`✅ 已从用户目录移除命令 '${args.name}'`));
+          output.log(chalk43.green(`✅ 已从用户目录移除命令 '${args.name}'`));
         } catch (error) {
           if (!error.message?.includes("不存在")) {
             throw error;
@@ -15156,7 +15369,7 @@ var CommandsRemoveCommand = {
             name: args.name,
             source: "project"
           });
-          output.log(chalk42.green(`✅ 已从项目目录移除命令 '${args.name}'`));
+          output.log(chalk43.green(`✅ 已从项目目录移除命令 '${args.name}'`));
         } catch (error) {
           if (!error.message?.includes("不存在")) {
             throw error;
@@ -15170,7 +15383,7 @@ var CommandsRemoveCommand = {
             name: args.name,
             source: "user"
           });
-          output.log(chalk42.green(`✅ 已从用户目录移除命令 '${args.name}'`));
+          output.log(chalk43.green(`✅ 已从用户目录移除命令 '${args.name}'`));
           removed = true;
         } catch (error) {
           if (!error.message?.includes("不存在")) {
@@ -15182,7 +15395,7 @@ var CommandsRemoveCommand = {
             name: args.name,
             source: "project"
           });
-          output.log(chalk42.green(`✅ 已从项目目录移除命令 '${args.name}'`));
+          output.log(chalk43.green(`✅ 已从项目目录移除命令 '${args.name}'`));
           removed = true;
         } catch (error) {
           if (!error.message?.includes("不存在")) {
@@ -15204,7 +15417,7 @@ var CommandsRemoveCommand = {
 };
 // src/commands/commands-info.ts
-import chalk43 from "chalk";
+import chalk44 from "chalk";
 import { exec as exec2 } from "child_process";
 import { promisify } from "util";
 var execAsync2 = promisify(exec2);
@@ -15239,12 +15452,12 @@ var CommandsInfoCommand = {
         output.error(`命令 '${args.name}' 不存在`);
         process.exit(1);
       }
-      output.log(chalk43.bold("Name:") + ` ${info.name}`);
-      output.log(chalk43.bold("Path:") + ` ${info.path}`);
-      output.log(chalk43.bold("Source:") + ` ${info.source.toUpperCase()}`);
-      output.log(chalk43.bold("Description:") + ` ${info.shortDescription || "-"}`);
+      output.log(chalk44.bold("Name:") + ` ${info.name}`);
+      output.log(chalk44.bold("Path:") + ` ${info.path}`);
+      output.log(chalk44.bold("Source:") + ` ${info.source.toUpperCase()}`);
+      output.log(chalk44.bold("Description:") + ` ${info.shortDescription || "-"}`);
       output.log();
-      output.log(chalk43.gray("─".repeat(50)));
+      output.log(chalk44.gray("─".repeat(50)));
       output.log();
       try {
         const { stdout } = await execAsync2(`${info.path} --help`, { timeout: 5000 });
@@ -15254,7 +15467,7 @@ var CommandsInfoCommand = {
           const { stdout } = await execAsync2(`${info.path} -h`, { timeout: 5000 });
           output.log(stdout);
         } catch {
-          output.log(chalk43.gray("（无法获取帮助信息）"));
+          output.log(chalk44.gray("（无法获取帮助信息）"));
         }
       }
     } catch (error) {
@@ -15267,7 +15480,7 @@ var CommandsInfoCommand = {
 };
 // src/commands/commands-dirs.ts
-import chalk44 from "chalk";
+import chalk45 from "chalk";
 var CommandsDirsCommand = {
   command: "dirs",
   describe: "显示命令目录",
@@ -15299,10 +15512,10 @@ var CommandsDirsCommand = {
       if (args.json) {
         output.json(dirs);
       } else {
-        output.log(chalk44.bold("命令目录:"));
+        output.log(chalk45.bold("命令目录:"));
         output.log();
-        output.log(chalk44.cyan("USER:") + `   ${dirs.user}`);
-        output.log(chalk44.cyan("PROJECT:") + ` ${dirs.project}`);
+        output.log(chalk45.cyan("USER:") + `   ${dirs.user}`);
+        output.log(chalk45.cyan("PROJECT:") + ` ${dirs.project}`);
       }
     } catch (error) {
       output.error(`错误: ${error.message}`);
@@ -15322,7 +15535,7 @@ var CommandsCommand = {
 };
 // src/commands/config/list.ts
-import chalk45 from "chalk";
+import chalk46 from "chalk";
 // src/commands/config/config-service.ts
 import * as fsSync from "fs";
@@ -15626,7 +15839,7 @@ var ConfigListCommand = {
         output.log("");
         output.log("Supported components:");
         for (const comp of SUPPORTED_COMPONENTS) {
-          output.log(`  ${chalk45.cyan(comp.padEnd(15))} ${COMPONENT_DESCRIPTIONS[comp] || ""}`);
+          output.log(`  ${chalk46.cyan(comp.padEnd(15))} ${COMPONENT_DESCRIPTIONS[comp] || ""}`);
         }
         process.exit(1);
       }
@@ -15644,27 +15857,27 @@ var ConfigListCommand = {
   }
 };
 function showHelp(output) {
-  output.log(chalk45.bold.cyan("# roy-agent config list"));
+  output.log(chalk46.bold.cyan("# roy-agent config list"));
   output.log("");
   output.log("查看 roy-agent 组件配置信息");
   output.log("");
-  output.log(chalk45.bold("Usage:"));
-  output.log(`  ${chalk45.cyan("roy-agent config list [component] [options]")}`);
+  output.log(chalk46.bold("Usage:"));
+  output.log(`  ${chalk46.cyan("roy-agent config list [component] [options]")}`);
   output.log("");
-  output.log(chalk45.bold("Components:"));
+  output.log(chalk46.bold("Components:"));
   for (const comp of SUPPORTED_COMPONENTS) {
-    output.log(`  ${chalk45.cyan(comp.padEnd(15))} ${chalk45.gray(COMPONENT_DESCRIPTIONS[comp] || "")}`);
+    output.log(`  ${chalk46.cyan(comp.padEnd(15))} ${chalk46.gray(COMPONENT_DESCRIPTIONS[comp] || "")}`);
   }
-  output.log(`  ${chalk45.cyan("all".padEnd(15))} 显示所有 components 概览`);
+  output.log(`  ${chalk46.cyan("all".padEnd(15))} 显示所有 components 概览`);
   output.log("");
-  output.log(chalk45.bold("Options:"));
-  output.log(`  ${chalk45.cyan("-j, --json")}     JSON 格式输出`);
-  output.log(`  ${chalk45.cyan("-k, --keys")}     只显示配置键`);
-  output.log(`  ${chalk45.cyan("-s, --sources")}  只显示配置源`);
+  output.log(chalk46.bold("Options:"));
+  output.log(`  ${chalk46.cyan("-j, --json")}     JSON 格式输出`);
+  output.log(`  ${chalk46.cyan("-k, --keys")}     只显示配置键`);
+  output.log(`  ${chalk46.cyan("-s, --sources")}  只显示配置源`);
   output.log("");
-  output.log(chalk45.bold("Examples:"));
+  output.log(chalk46.bold("Examples:"));
   for (const { command: command2, description } of USAGE_COMMANDS) {
-    output.log(`  ${chalk45.cyan(command2.padEnd(40))} ${chalk45.gray(description)}`);
+    output.log(`  ${chalk46.cyan(command2.padEnd(40))} ${chalk46.gray(description)}`);
   }
 }
 async function showAllComponents(output, configService) {
@@ -15673,13 +15886,13 @@ async function showAllComponents(output, configService) {
     const config = configService.getComponentConfig(compName);
     components.push({ name: compName, config });
   }
-  output.log(chalk45.bold.cyan("# All Components Overview"));
+  output.log(chalk46.bold.cyan("# All Components Overview"));
   output.log("");
-  output.log(`  ${chalk45.cyan("Component".padEnd(15))} ${chalk45.cyan("Keys".padEnd(10))} ${chalk45.gray("Description")}`);
-  output.log(`  ${chalk45.gray("─".repeat(60))}`);
+  output.log(`  ${chalk46.cyan("Component".padEnd(15))} ${chalk46.cyan("Keys".padEnd(10))} ${chalk46.gray("Description")}`);
+  output.log(`  ${chalk46.gray("─".repeat(60))}`);
   for (const comp of components) {
     const keyCount = Object.keys(comp.config).length;
-    output.log(`  ${chalk45.cyan(comp.name.padEnd(15))} ${keyCount.toString().padEnd(10)} ${chalk45.gray(COMPONENT_DESCRIPTIONS[comp.name] || "")}`);
+    output.log(`  ${chalk46.cyan(comp.name.padEnd(15))} ${keyCount.toString().padEnd(10)} ${chalk46.gray(COMPONENT_DESCRIPTIONS[comp.name] || "")}`);
   }
 }
 async function showComponentConfig(componentName, output, configService, options) {
@@ -15701,22 +15914,22 @@ async function showComponentConfig(componentName, output, configService, options
     });
     return;
   }
-  output.log(chalk45.bold.cyan(`# ${componentName} Component Configuration`));
+  output.log(chalk46.bold.cyan(`# ${componentName} Component Configuration`));
   output.log("");
   if (filePath) {
-    output.log(chalk45.bold("File:"));
-    output.log(`  ${chalk45.cyan(filePath)}`);
+    output.log(chalk46.bold("File:"));
+    output.log(`  ${chalk46.cyan(filePath)}`);
     output.log("");
   }
   if (!options.sources) {
-    output.log(chalk45.bold("Configuration:"));
+    output.log(chalk46.bold("Configuration:"));
     if (Object.keys(config).length === 0) {
-      output.log(`  ${chalk45.gray("（无配置）")}`);
+      output.log(`  ${chalk46.gray("（无配置）")}`);
     } else {
       const flatConfig = flattenConfig(config);
       for (const [key, value] of flatConfig) {
         const displayValue = formatValue(value);
-        output.log(`  ${chalk45.cyan(key + ":")} ${displayValue}`);
+        output.log(`  ${chalk46.cyan(key + ":")} ${displayValue}`);
       }
     }
     output.log("");
@@ -15731,17 +15944,17 @@ async function showAgentComponentConfig(output, configService, options) {
     });
     return;
   }
-  output.log(chalk45.bold.cyan("# Agent Component Configuration"));
+  output.log(chalk46.bold.cyan("# Agent Component Configuration"));
   output.log("");
   if (!options.sources) {
-    output.log(chalk45.bold("Configuration:"));
+    output.log(chalk46.bold("Configuration:"));
     if (Object.keys(config).length === 0) {
-      output.log(`  ${chalk45.gray("（无配置，使用默认值）")}`);
+      output.log(`  ${chalk46.gray("（无配置，使用默认值）")}`);
     } else {
       const flatConfig = flattenConfig(config);
       for (const [key, value] of flatConfig) {
         const displayValue = formatValue(value);
-        output.log(`  ${chalk45.cyan(key + ":")} ${displayValue}`);
+        output.log(`  ${chalk46.cyan(key + ":")} ${displayValue}`);
       }
     }
     output.log("");
@@ -15755,10 +15968,10 @@ async function showAgentComponentConfig(output, configService, options) {
       const configDir = registry.getConfigDir();
       const exists = registry.configDirExists();
       const agentCount = registry.list().length;
-      output.log(chalk45.bold("Agent Config Directory:"));
-      output.log(`  ${chalk45.cyan("path:")} ${configDir}`);
-      output.log(`  ${chalk45.cyan("exists:")} ${exists ? chalk45.green("yes") : chalk45.red("no")}`);
-      output.log(`  ${chalk45.cyan("agents:")} ${agentCount} loaded`);
+      output.log(chalk46.bold("Agent Config Directory:"));
+      output.log(`  ${chalk46.cyan("path:")} ${configDir}`);
+      output.log(`  ${chalk46.cyan("exists:")} ${exists ? chalk46.green("yes") : chalk46.red("no")}`);
+      output.log(`  ${chalk46.cyan("agents:")} ${agentCount} loaded`);
       output.log("");
     }
   }
@@ -15774,41 +15987,41 @@ async function showPromptComponentConfig(output, configService, options, envServ
     });
     return;
   }
-  output.log(chalk45.bold.cyan("# Prompt Component Configuration"));
+  output.log(chalk46.bold.cyan("# Prompt Component Configuration"));
   output.log("");
   if (filePath) {
-    output.log(chalk45.bold("File:"));
-    output.log(`  ${chalk45.cyan(filePath)}`);
+    output.log(chalk46.bold("File:"));
+    output.log(`  ${chalk46.cyan(filePath)}`);
     output.log("");
   }
   if (!options.sources) {
-    output.log(chalk45.bold("Configuration:"));
+    output.log(chalk46.bold("Configuration:"));
     if (Object.keys(config).length === 0) {
-      output.log(`  ${chalk45.gray("（无配置，使用默认值）")}`);
+      output.log(`  ${chalk46.gray("（无配置，使用默认值）")}`);
     } else {
       const flatConfig = flattenConfig(config);
       for (const [key, value] of flatConfig) {
         const displayValue = formatValue(value);
-        output.log(`  ${chalk45.cyan(key + ":")} ${displayValue}`);
+        output.log(`  ${chalk46.cyan(key + ":")} ${displayValue}`);
       }
     }
     output.log("");
   }
-  output.log(chalk45.bold("Prompts:"));
-  output.log(`  ${chalk45.gray("- 内置: 5 个（default, coding, review, project-memory, global-memory）")}`);
+  output.log(chalk46.bold("Prompts:"));
+  output.log(`  ${chalk46.gray("- 内置: 5 个（default, coding, review, project-memory, global-memory）")}`);
   const promptPaths = config?.promptPaths;
   if (promptPaths && Array.isArray(promptPaths) && promptPaths.length > 0) {
-    output.log(`  ${chalk45.gray("- 外部: " + promptPaths.length + " 个路径")}`);
+    output.log(`  ${chalk46.gray("- 外部: " + promptPaths.length + " 个路径")}`);
     for (const p of promptPaths) {
-      output.log(`    ${chalk45.cyan(p.path)} ${chalk45.gray("(type: " + p.type + ")")}`);
+      output.log(`    ${chalk46.cyan(p.path)} ${chalk46.gray("(type: " + p.type + ")")}`);
     }
   } else {
-    output.log(`  ${chalk45.gray("- 外部: 0 个（未配置 promptPaths）")}`);
+    output.log(`  ${chalk46.gray("- 外部: 0 个（未配置 promptPaths）")}`);
   }
   output.log("");
   const defaultName = config?.defaultName || "default";
-  output.log(chalk45.bold("Default Prompt:"));
-  output.log(`  ${chalk45.cyan("defaultName:")} ${defaultName}`);
+  output.log(chalk46.bold("Default Prompt:"));
+  output.log(`  ${chalk46.cyan("defaultName:")} ${defaultName}`);
   output.log("");
   const env = envService?.getEnvironment?.();
   if (env) {
@@ -15823,10 +16036,10 @@ async function showPromptComponentConfig(output, configService, options, envServ
           const stored = await store?.loadAll?.();
           promptCount = Array.isArray(stored) ? stored.length : 0;
         } catch {}
-        output.log(chalk45.bold("Prompt Storage Directory:"));
-        output.log(`  ${chalk45.cyan("path:")} ${configDir}`);
-        output.log(`  ${chalk45.cyan("exists:")} ${exists ? chalk45.green("yes") : chalk45.red("no")}`);
-        output.log(`  ${chalk45.cyan("prompts:")} ${promptCount} loaded`);
+        output.log(chalk46.bold("Prompt Storage Directory:"));
+        output.log(`  ${chalk46.cyan("path:")} ${configDir}`);
+        output.log(`  ${chalk46.cyan("exists:")} ${exists ? chalk46.green("yes") : chalk46.red("no")}`);
+        output.log(`  ${chalk46.cyan("prompts:")} ${promptCount} loaded`);
         output.log("");
       }
     }
@@ -15852,19 +16065,19 @@ function flattenConfig(obj, prefix = "") {
 }
 function formatValue(value) {
   if (value === undefined) {
-    return chalk45.gray("undefined");
+    return chalk46.gray("undefined");
   }
   if (value === null) {
-    return chalk45.gray("null");
+    return chalk46.gray("null");
   }
   if (typeof value === "object") {
-    return chalk45.gray(JSON.stringify(value));
+    return chalk46.gray(JSON.stringify(value));
   }
   return String(value);
 }
 // src/commands/config/export.ts
-import chalk46 from "chalk";
+import chalk47 from "chalk";
 var ConfigExportCommand = {
   command: "export <component>",
   describe: "导出组件配置到文件",
@@ -15909,7 +16122,7 @@ var ConfigExportCommand = {
         output.log("");
         output.log("Supported components:");
         for (const comp of SUPPORTED_COMPONENTS) {
-          output.log(`  ${chalk46.cyan(comp)}`);
+          output.log(`  ${chalk47.cyan(comp)}`);
         }
         process.exit(1);
       }
@@ -15927,7 +16140,7 @@ var ConfigExportCommand = {
 };
 // src/commands/config/import.ts
-import chalk47 from "chalk";
+import chalk48 from "chalk";
 var ConfigImportCommand = {
   command: "import <component>",
   describe: "从文件导入配置到组件的 file source",
@@ -15977,7 +16190,7 @@ var ConfigImportCommand = {
         output.log("");
         output.log("Supported components:");
         for (const comp of SUPPORTED_COMPONENTS) {
-          output.log(`  ${chalk47.cyan(comp)}`);
+          output.log(`  ${chalk48.cyan(comp)}`);
         }
         process.exit(1);
       }
@@ -15992,7 +16205,7 @@ var ConfigImportCommand = {
       }
       if (result.merged && result.changes.length > 0 && args.verbose) {
         output.log("");
-        output.log(chalk47.bold("变更详情:"));
+        output.log(chalk48.bold("变更详情:"));
         for (const change of result.changes) {
           output.log(`  ${change.key}: ${JSON.stringify(change.oldValue)} → ${JSON.stringify(change.newValue)}`);
         }
@@ -16016,7 +16229,7 @@ var ConfigCommand = {
 };
 // src/commands/mcp/list.ts
-import chalk48 from "chalk";
+import chalk49 from "chalk";
 var ListCommand6 = {
   command: "list",
   aliases: ["ls"],
@@ -16026,12 +16239,7 @@ var ListCommand6 = {
     type: "boolean",
     default: false,
     description: "JSON 输出"
-  }).option("quiet", {
-    alias: "q",
-    type: "boolean",
-    default: false,
-    description: "简洁输出"
-  }),
+  }).option("limit", PAGINATION_OPTIONS.limit).option("offset", PAGINATION_OPTIONS.offset).option("quiet", { alias: "q", type: "boolean", hidden: true }),
   async handler(args) {
     const output = new OutputService2;
     const envService = new EnvironmentService(output);
@@ -16047,45 +16255,64 @@ var ListCommand6 = {
         output.error("McpComponent not available");
         process.exit(1);
       }
-      const servers = mcpComponent.listServers();
+      const allServers = mcpComponent.listServers();
+      const total = allServers.length;
+      const page = {
+        limit: args.limit ?? 20,
+        offset: args.offset ?? 0
+      };
+      const servers = applyPagination(allServers, page);
       if (args.json) {
         output.json({
+          total,
+          count: servers.length,
+          truncated: total > servers.length,
+          limit: page.limit,
+          offset: page.offset,
           servers: servers.map((s) => ({
             name: s.name,
             status: s.status,
             error: s.error,
             toolsCount: s.toolsCount
-          })),
-          count: servers.length
+          }))
         });
       } else if (args.quiet) {
-        servers.forEach((s) => output.log(s.name));
+        output.log(renderQuietHeader(total, "mcp server"));
+        servers.forEach((s) => output.log(renderQuietLine(s.name, s.name)));
+        const hint = renderQuietPaginationHint({
+          count: servers.length,
+          total,
+          offset: page.offset,
+          limit: page.limit
+        });
+        if (hint)
+          output.log(hint);
       } else {
         if (servers.length === 0) {
-          output.log(chalk48.yellow("No MCP servers configured"));
+          output.log(chalk49.yellow("No MCP servers configured"));
           return;
         }
         const statusColor = (status) => {
           switch (status) {
             case "connected":
-              return chalk48.green;
+              return chalk49.green;
             case "connecting":
-              return chalk48.yellow;
+              return chalk49.yellow;
             case "error":
-              return chalk48.red;
+              return chalk49.red;
             case "disconnected":
-              return chalk48.gray;
+              return chalk49.gray;
             default:
-              return chalk48.white;
+              return chalk49.white;
           }
         };
         const header = [
-          chalk48.bold("Name"),
-          chalk48.bold("Status"),
-          chalk48.bold("Tools")
+          chalk49.bold("Name"),
+          chalk49.bold("Status"),
+          chalk49.bold("Tools")
         ].join(" | ");
         const rows = servers.map((s) => [
-          chalk48.cyan(s.name),
+          chalk49.cyan(s.name),
           statusColor(s.status)(`[${s.status}]`),
           s.toolsCount !== undefined ? String(s.toolsCount) : "-"
         ].join(" | "));
@@ -16096,7 +16323,13 @@ var ListCommand6 = {
           ...rows.map((r) => `│${r}│`),
           "└" + "─".repeat(header.length + 2) + "┘",
           "",
-          chalk48.gray(`Total: ${servers.length} servers`)
+          renderPaginationFooter({
+            total,
+            count: servers.length,
+            offset: page.offset,
+            limit: page.limit,
+            itemName: "mcp server"
+          })
         ].join(`
 `));
       }
@@ -16110,7 +16343,7 @@ var ListCommand6 = {
 };
 // src/commands/mcp/tools.ts
-import chalk49 from "chalk";
+import chalk50 from "chalk";
 var ToolsCommand = {
   command: "tools",
   aliases: ["t"],
@@ -16163,7 +16396,7 @@ var ToolsCommand = {
         tools.forEach((t) => output.log(t.name));
       } else {
         if (tools.length === 0) {
-          output.log(chalk49.yellow("No MCP tools available"));
+          output.log(chalk50.yellow("No MCP tools available"));
           return;
         }
         const byServer = new Map;
@@ -16175,15 +16408,15 @@ var ToolsCommand = {
           byServer.get(serverName).push(tool);
         }
         for (const [serverName, serverTools] of byServer) {
-          output.log(chalk49.bold.cyan(`
+          output.log(chalk50.bold.cyan(`
 [${serverName}] ${serverTools.length} tools`));
           for (const tool of serverTools) {
             const desc2 = tool.description.length > 80 ? tool.description.slice(0, 77) + "..." : tool.description;
-            output.log(`  ${chalk49.green("+")} ${chalk49.white(tool.name)}`);
-            output.log(`    ${chalk49.gray(desc2)}`);
+            output.log(`  ${chalk50.green("+")} ${chalk50.white(tool.name)}`);
+            output.log(`    ${chalk50.gray(desc2)}`);
           }
         }
-        output.log(chalk49.gray(`
+        output.log(chalk50.gray(`
 Total: ${tools.length} tools across ${byServer.size} servers`));
       }
     } catch (error) {
@@ -16196,7 +16429,7 @@ Total: ${tools.length} tools across ${byServer.size} servers`));
 };
 // src/commands/mcp/reload.ts
-import chalk50 from "chalk";
+import chalk51 from "chalk";
 var ReloadCommand2 = {
   command: "reload",
   aliases: ["r"],
@@ -16217,19 +16450,19 @@ var ReloadCommand2 = {
         output.error("McpComponent not available");
         process.exit(1);
       }
-      output.log(chalk50.cyan("Reloading MCP servers..."));
+      output.log(chalk51.cyan("Reloading MCP servers..."));
       await mcpComponent.reload();
       const servers = mcpComponent.listServers();
       const connected = servers.filter((s) => s.status === "connected").length;
       const errors = servers.filter((s) => s.status === "error").length;
-      output.log(chalk50.green(`✓ Reloaded ${servers.length} servers`));
+      output.log(chalk51.green(`✓ Reloaded ${servers.length} servers`));
       if (connected > 0) {
-        output.log(chalk50.green(`  • ${connected} connected`));
+        output.log(chalk51.green(`  • ${connected} connected`));
       }
       if (errors > 0) {
         output.warn(`  • ${errors} failed`);
         for (const server of servers.filter((s) => s.status === "error")) {
-          output.log(chalk50.gray(`    - ${server.name}: ${server.error}`));
+          output.log(chalk51.gray(`    - ${server.name}: ${server.error}`));
         }
       }
     } catch (error) {
@@ -16250,7 +16483,7 @@ var McpCommand = {
 };
 // src/commands/tools/list.ts
-import chalk51 from "chalk";
+import chalk52 from "chalk";
 var ListCommand7 = {
   command: "list",
   aliases: ["ls"],
@@ -16260,12 +16493,7 @@ var ListCommand7 = {
     type: "boolean",
     default: false,
     description: "JSON 输出"
-  }).option("quiet", {
-    alias: "q",
-    type: "boolean",
-    default: false,
-    description: "简洁输出（仅名称）"
-  }),
+  }).option("limit", PAGINATION_OPTIONS.limit).option("offset", PAGINATION_OPTIONS.offset).option("quiet", { alias: "q", type: "boolean", hidden: true }),
   async handler(args) {
     const output = new OutputService2;
     const envService = new EnvironmentService(output);
@@ -16281,10 +16509,20 @@ var ListCommand7 = {
         output.error("ToolComponent not available");
         process.exit(1);
       }
-      const tools = toolComponent.listTools();
+      const allTools = toolComponent.listTools();
+      const total = allTools.length;
+      const page = {
+        limit: args.limit ?? 20,
+        offset: args.offset ?? 0
+      };
+      const tools = applyPagination(allTools, page);
       if (args.json) {
         output.json({
+          total,
           count: tools.length,
+          truncated: total > tools.length,
+          limit: page.limit,
+          offset: page.offset,
           tools: tools.map((t) => ({
             name: t.name,
             description: t.description,
@@ -16292,19 +16530,28 @@ var ListCommand7 = {
           }))
         });
       } else if (args.quiet) {
-        tools.forEach((t) => output.log(t.name));
+        output.log(renderQuietHeader(total, "tool"));
+        tools.forEach((t) => output.log(renderQuietLine(t.name, t.name)));
+        const hint = renderQuietPaginationHint({
+          count: tools.length,
+          total,
+          offset: page.offset,
+          limit: page.limit
+        });
+        if (hint)
+          output.log(hint);
       } else {
         const header = [
-          chalk51.bold("Name"),
-          chalk51.bold("Description"),
-          chalk51.bold("Category")
+          chalk52.bold("Name"),
+          chalk52.bold("Description"),
+          chalk52.bold("Category")
         ].join(" | ");
         const rows = tools.map((t) => {
           const desc2 = t.description.length > 40 ? t.description.slice(0, 37) + "..." : t.description;
           return [
-            chalk51.cyan(t.name),
+            chalk52.cyan(t.name),
             desc2,
-            t.metadata?.category ? chalk51.gray(`[${t.metadata.category}]`) : "-"
+            t.metadata?.category ? chalk52.gray(`[${t.metadata.category}]`) : "-"
           ].join(" | ");
         });
         output.log([
@@ -16314,7 +16561,13 @@ var ListCommand7 = {
           ...rows.map((r) => `│${r}│`),
           "└" + "─".repeat(header.length + 2) + "┘",
           "",
-          chalk51.gray(`Total: ${tools.length} tools`)
+          renderPaginationFooter({
+            total,
+            count: tools.length,
+            offset: page.offset,
+            limit: page.limit,
+            itemName: "tool"
+          })
         ].join(`
 `));
       }
@@ -16328,7 +16581,7 @@ var ListCommand7 = {
 };
 // src/commands/tools/get.ts
-import chalk52 from "chalk";
+import chalk53 from "chalk";
 // src/commands/tools/shared/schema-helper.ts
 import { zodToJsonSchema } from "zod-to-json-schema";
@@ -16403,8 +16656,8 @@ var GetCommand6 = {
           }))
         });
       } else {
-        output.log(chalk52.bold.cyan(`Tool: ${tool.name}`));
-        output.log(chalk52.gray("─".repeat(60)));
+        output.log(chalk53.bold.cyan(`Tool: ${tool.name}`));
+        output.log(chalk53.gray("─".repeat(60)));
         output.log(`Description: ${tool.description}`);
         if (tool.metadata?.category) {
           output.log(`Category: ${tool.metadata.category}`);
@@ -16413,9 +16666,9 @@ var GetCommand6 = {
           output.log(`Tags: ${tool.metadata.tags.join(", ")}`);
         }
         output.log("");
-        output.log(chalk52.bold("Parameters:"));
+        output.log(chalk53.bold("Parameters:"));
         for (const param of params) {
-          const required = param.required ? chalk52.red("(required)") : chalk52.gray("(optional)");
+          const required = param.required ? chalk53.red("(required)") : chalk53.gray("(optional)");
           const defaultVal = param.default !== undefined ? ` [default: ${JSON.stringify(param.default)}]` : "";
           output.log(`  --${param.name} <${param.type}> ${required}`);
           output.log(`      ${param.description}${defaultVal}`);
@@ -16524,14 +16777,14 @@ var ToolsCommand2 = {
 };
 // src/commands/memory/record.ts
-import chalk53 from "chalk";
+import chalk54 from "chalk";
 import { createMemoryAgentTools, getBuiltInPrompt } from "@ai-setting/roy-agent-core";
 import { bashTool, globTool, readFileTool } from "@ai-setting/roy-agent-core";
 async function runExtractMode(output, memoryComponent, agentComponent, sessionComponent, env, options) {
   const { scope, sessionId, require: userRequirement } = options;
-  output.log(chalk53.blue(`
+  output.log(chalk54.blue(`
 \uD83D\uDD0D Memory Extract Mode (${scope})`));
-  output.log(chalk53.gray(`正在分析会话历史，生成记忆...
+  output.log(chalk54.gray(`正在分析会话历史，生成记忆...
 `));
   try {
     const currentMemory = await memoryComponent.recallMemory(scope) || "(无现有记忆)";
@@ -16577,13 +16830,13 @@ async function runExtractMode(output, memoryComponent, agentComponent, sessionCo
       for (const tool of agentTools) {
         try {
           toolComponent.register(tool);
-          output.log(chalk53.gray(`Tool registered: ${tool.name}`));
+          output.log(chalk54.gray(`Tool registered: ${tool.name}`));
         } catch (err) {
-          output.log(chalk53.gray(`Tool already registered: ${tool.name}`));
+          output.log(chalk54.gray(`Tool already registered: ${tool.name}`));
         }
       }
     }
-    output.log(chalk53.gray(`Agent "${agentName}" registered with ${agentTools.length} tools`));
+    output.log(chalk54.gray(`Agent "${agentName}" registered with ${agentTools.length} tools`));
     const query = `请分析会话历史，提炼${scope === "project" ? "项目" : "全局"}记忆并写入记忆文件。`;
     let result;
     try {
@@ -16597,12 +16850,12 @@ async function runExtractMode(output, memoryComponent, agentComponent, sessionCo
     if (result && result.startsWith("执行失败")) {
       output.error(`提取失败: ${result}`);
     } else if (result) {
-      output.log(chalk53.green(`
+      output.log(chalk54.green(`
 ✅ 记忆提取完成`));
-      output.log(chalk53.gray(`记忆已保存到 memory 文件。
+      output.log(chalk54.gray(`记忆已保存到 memory 文件。
 `));
       if (result.length > 0 && result !== "✅ 记忆提取完成") {
-        output.log(chalk53.gray(`执行摘要: ${result.substring(0, 200)}${result.length > 200 ? "..." : ""}`));
+        output.log(chalk54.gray(`执行摘要: ${result.substring(0, 200)}${result.length > 200 ? "..." : ""}`));
       }
     }
     agentComponent.unregisterAgent(agentName);
@@ -16720,11 +16973,11 @@ var RecordCommand = {
         prepend: "已插入内容到记忆文件开头",
         delete: "已删除记忆文件"
       };
-      output.log(chalk53.green(`✓ ${actionMessages[result.action]}`));
-      output.log(chalk53.gray(`路径: ${result.path}`));
+      output.log(chalk54.green(`✓ ${actionMessages[result.action]}`));
+      output.log(chalk54.gray(`路径: ${result.path}`));
       if (result.action !== "delete" && a.content) {
         const preview = a.content.substring(0, 100);
-        output.log(chalk53.gray(`内容预览: ${preview}${a.content.length > 100 ? "..." : ""}`));
+        output.log(chalk54.gray(`内容预览: ${preview}${a.content.length > 100 ? "..." : ""}`));
       }
     } catch (error) {
       output.error(`Failed to record memory: ${error}`);
@@ -16736,7 +16989,7 @@ var RecordCommand = {
 };
 // src/commands/memory/recall.ts
-import chalk54 from "chalk";
+import chalk55 from "chalk";
 var RecallCommand = {
   command: "recall",
   aliases: ["load"],
@@ -16772,7 +17025,7 @@ var RecallCommand = {
       }
       const content = await memoryComponent.recallMemory(a.scope);
       if (!content) {
-        output.log(chalk54.gray("(No memory files found)"));
+        output.log(chalk55.gray("(No memory files found)"));
         return;
       }
       if (a.json) {
@@ -16798,7 +17051,7 @@ var MemoryCommand = {
   handler: () => {}
 };
 // src/commands/eventsource/list.ts
-import chalk55 from "chalk";
+import chalk56 from "chalk";
 function truncateVisual2(str, maxWidth) {
   let result = "";
   let width = 0;
@@ -16813,7 +17066,7 @@ function truncateVisual2(str, maxWidth) {
 }
 function formatSourcesTable(sources) {
   if (sources.length === 0) {
-    return chalk55.yellow("没有配置的事件源，使用 'roy-agent eventsource add' 添加");
+    return chalk56.yellow("没有配置的事件源，使用 'roy-agent eventsource add' 添加");
   }
   const ID_WIDTH = 10;
   const NAME_WIDTH = 20;
@@ -16822,11 +17075,11 @@ function formatSourcesTable(sources) {
   const ENABLED_WIDTH = 8;
   const GAP = "  ";
   const headerLine = [
-    chalk55.bold("ID".padEnd(ID_WIDTH)),
-    chalk55.bold("NAME".padEnd(NAME_WIDTH)),
-    chalk55.bold("TYPE".padEnd(TYPE_WIDTH)),
-    chalk55.bold("STATUS".padEnd(STATUS_WIDTH)),
-    chalk55.bold("ENABLED".padEnd(ENABLED_WIDTH))
+    chalk56.bold("ID".padEnd(ID_WIDTH)),
+    chalk56.bold("NAME".padEnd(NAME_WIDTH)),
+    chalk56.bold("TYPE".padEnd(TYPE_WIDTH)),
+    chalk56.bold("STATUS".padEnd(STATUS_WIDTH)),
+    chalk56.bold("ENABLED".padEnd(ENABLED_WIDTH))
   ].join(GAP);
   const sepLine = "─".repeat(ID_WIDTH + NAME_WIDTH + TYPE_WIDTH + STATUS_WIDTH + ENABLED_WIDTH + GAP.length * 4);
   const formatRow = (src) => {
@@ -16850,15 +17103,9 @@ var EventSourceListCommand = {
     describe: "JSON 格式输出",
     type: "boolean",
     default: false
-  }).option("quiet", {
-    alias: "q",
-    describe: "静默模式",
-    type: "boolean",
-    default: false
-  }),
+  }).option("limit", PAGINATION_OPTIONS.limit).option("offset", PAGINATION_OPTIONS.offset).option("quiet", { alias: "q", type: "boolean", hidden: true }),
   async handler(args) {
     const output = new OutputService2;
-    output.configure({ quiet: args.quiet });
     const envService = new EnvironmentService(output);
     try {
       await envService.create({ configPath: args.config });
@@ -16867,53 +17114,90 @@ var EventSourceListCommand = {
         output.error("Failed to create environment");
         process.exit(1);
       }
-      const components = env.listComponents().map((c) => c.name);
-      output.log("Available components: " + components.join(", "));
       const esComponent = env.getComponent("event-source");
       if (!esComponent) {
         output.error("EventSourceComponent not available");
         process.exit(1);
       }
-      const sources = esComponent.list();
-      if (!sources || sources.length === 0) {
+      const allSources = esComponent.list() ?? [];
+      const total = allSources.length;
+      const page = {
+        limit: args.limit ?? 20,
+        offset: args.offset ?? 0
+      };
+      const sources = applyPagination(allSources, page);
+      if (total === 0) {
         if (args.json) {
-          output.json({ sources: [], count: 0 });
+          output.json({
+            total: 0,
+            count: 0,
+            truncated: false,
+            limit: page.limit,
+            offset: page.offset,
+            sources: []
+          });
         } else {
-          output.log(chalk55.yellow("没有配置的事件源，使用 'roy-agent eventsource add' 添加"));
+          output.log(chalk56.yellow("没有配置的事件源，使用 'roy-agent eventsource add' 添加"));
         }
         return;
       }
+      const sourcesWithStatus = sources.map((s) => ({
+        ...s,
+        status: esComponent.getStatus(s.id) || "unknown"
+      }));
       if (args.json) {
-        const sourcesWithStatus = sources.map((s) => ({
-          ...s,
-          status: esComponent.getStatus(s.id) || "unknown"
-        }));
-        output.json({ sources: sourcesWithStatus, count: sources.length });
+        output.json({
+          total,
+          count: sourcesWithStatus.length,
+          truncated: total > sourcesWithStatus.length,
+          limit: page.limit,
+          offset: page.offset,
+          sources: sourcesWithStatus
+        });
+        return;
+      }
+      if (args.quiet) {
+        output.log(renderQuietHeader(total, "event source"));
+        sources.forEach((s) => output.log(renderQuietLine(s.id, s.name)));
+        const hint = renderQuietPaginationHint({
+          count: sources.length,
+          total,
+          offset: page.offset,
+          limit: page.limit
+        });
+        if (hint)
+          output.log(hint);
         return;
       }
       const rows = sources.map((s) => {
         const status = esComponent.getStatus(s.id) || "unknown";
         const statusColorMap = {
-          running: chalk55.green,
-          stopped: chalk55.gray,
-          error: chalk55.red,
-          starting: chalk55.yellow,
-          created: chalk55.gray,
-          stopping: chalk55.yellow,
-          unknown: chalk55.gray
+          running: chalk56.green,
+          stopped: chalk56.gray,
+          error: chalk56.red,
+          starting: chalk56.yellow,
+          created: chalk56.gray,
+          stopping: chalk56.yellow,
+          unknown: chalk56.gray
         };
-        const statusColor = statusColorMap[status] || chalk55.gray;
+        const statusColor = statusColorMap[status] || chalk56.gray;
         return {
           id: s.id.substring(0, 8),
           name: s.name,
           type: s.type,
           status: statusColor(status),
-          enabled: s.enabled ? chalk55.green("✓") : chalk55.gray("✗")
+          enabled: s.enabled ? chalk56.green("✓") : chalk56.gray("✗")
         };
       });
       output.log(formatSourcesTable(rows));
-      output.info("");
-      output.log(chalk55.green(`✅ 共 ${sources.length} 个事件源`));
+      output.log("");
+      output.log(renderPaginationFooter({
+        total,
+        count: sources.length,
+        offset: page.offset,
+        limit: page.limit,
+        itemName: "event source"
+      }));
     } catch (error) {
       output.error(`Failed to list event sources: ${error}`);
       process.exit(1);
@@ -16924,11 +17208,11 @@ var EventSourceListCommand = {
 };
 // src/commands/eventsource/add.ts
-import chalk57 from "chalk";
+import chalk58 from "chalk";
 import { generateId } from "@ai-setting/roy-agent-core";
 // src/commands/eventsource/server-url-option.ts
-import chalk56 from "chalk";
+import chalk57 from "chalk";
 function addServerUrlOption(yargs) {
   return yargs.option("server-url", {
     alias: "s",
@@ -16944,7 +17228,7 @@ function resolveServerUrl(serverUrl, fallback) {
     return fallback;
   const trimmed = serverUrl.replace(/\/+$/, "");
   if (!/^(https?|wss?):\/\//.test(trimmed)) {
-    console.error(chalk56.red(`
+    console.error(chalk57.red(`
 ✗ Invalid --server-url: "${serverUrl}". Must start with http://, https://, ws://, or wss://
 `));
     process.exit(1);
@@ -17037,39 +17321,39 @@ var EventSourceAddCommand = {
         options: a.prompt ? { prompt: a.prompt } : undefined
       };
       esComponent.register(config);
-      output.success(chalk57.green(`事件源 '${a.name}' 添加成功！`));
+      output.success(chalk58.green(`事件源 '${a.name}' 添加成功！`));
       output.log("");
-      output.log(`  ID: ${chalk57.gray(config.id)}`);
-      output.log(`  Type: ${chalk57.cyan(a.type)}`);
+      output.log(`  ID: ${chalk58.gray(config.id)}`);
+      output.log(`  Type: ${chalk58.cyan(a.type)}`);
       if (eventTypes?.length) {
-        output.log(`  Event Types: ${chalk57.gray(eventTypes.join(", "))}`);
+        output.log(`  Event Types: ${chalk58.gray(eventTypes.join(", "))}`);
       }
       if (a.command) {
-        output.log(`  Command: ${chalk57.gray(a.command)}`);
+        output.log(`  Command: ${chalk58.gray(a.command)}`);
       }
       if (a.interval) {
-        output.log(`  Interval: ${chalk57.gray(`${a.interval}ms`)}`);
+        output.log(`  Interval: ${chalk58.gray(`${a.interval}ms`)}`);
       }
       if (a.profile) {
-        output.log(`  Profile: ${chalk57.gray(a.profile)}`);
+        output.log(`  Profile: ${chalk58.gray(a.profile)}`);
       }
       if (a.address) {
-        output.log(`  Address: ${chalk57.gray(a.address)}`);
+        output.log(`  Address: ${chalk58.gray(a.address)}`);
       }
       if (a.imServerUrl) {
-        output.log(`  IM Server URL: ${chalk57.gray(a.imServerUrl)}`);
+        output.log(`  IM Server URL: ${chalk58.gray(a.imServerUrl)}`);
       }
       if (resolvedServerUrl) {
-        output.log(`  Server URL: ${chalk57.gray(resolvedServerUrl)}`);
+        output.log(`  Server URL: ${chalk58.gray(resolvedServerUrl)}`);
       }
       if (a.tlsSkipVerify) {
-        output.log(`  TLS Skip Verify: ${chalk57.yellow("⚠ true (自签名场景)")}`);
+        output.log(`  TLS Skip Verify: ${chalk58.yellow("⚠ true (自签名场景)")}`);
       }
       if (a.prompt) {
-        output.log(`  Prompt: ${chalk57.gray(a.prompt.length > 60 ? a.prompt.slice(0, 60) + "..." : a.prompt)}`);
+        output.log(`  Prompt: ${chalk58.gray(a.prompt.length > 60 ? a.prompt.slice(0, 60) + "..." : a.prompt)}`);
       }
       output.log("");
-      output.log(chalk57.gray(`使用 'roy-agent eventsource start ${config.id.substring(0, 8)}' 启动它。`));
+      output.log(chalk58.gray(`使用 'roy-agent eventsource start ${config.id.substring(0, 8)}' 启动它。`));
     } finally {
       await envService.dispose();
     }
@@ -17077,7 +17361,7 @@ var EventSourceAddCommand = {
 };
 // src/commands/eventsource/update.ts
-import chalk58 from "chalk";
+import chalk59 from "chalk";
 function findSource(esComponent, id) {
   const sources = esComponent.list();
   const matched = sources.find((s) => s.id === id || s.id.startsWith(id));
@@ -17149,7 +17433,7 @@ var EventSourceUpdateCommand = {
         const all = esComponent.list();
         if (all.length > 0) {
           output.info("");
-          output.info(chalk58.gray("可用的事件源:"));
+          output.info(chalk59.gray("可用的事件源:"));
           for (const s of all) {
             output.info(`  - ${s.id.substring(0, 8)}: ${s.name} (${s.type})`);
           }
@@ -17191,19 +17475,19 @@ var EventSourceUpdateCommand = {
       }
       try {
         const result = await esComponent.update(match.fullId, partial);
-        output.success(chalk58.green(`✅ 事件源已更新: ${match.source.name}`));
+        output.success(chalk59.green(`✅ 事件源已更新: ${match.source.name}`));
         output.log("");
-        output.log(chalk58.bold("修改字段:"));
+        output.log(chalk59.bold("修改字段:"));
         const before = match.source;
         const after = result.updated;
         for (const field of result.fields) {
           const beforeVal = JSON.stringify(before[field] ?? before.options?.[field]);
           const afterVal = JSON.stringify(after[field] ?? after.options?.[field]);
-          output.log(`  ${chalk58.cyan(field)}: ${chalk58.gray(beforeVal)} ${chalk58.gray("→")} ${chalk58.green(afterVal)}`);
+          output.log(`  ${chalk59.cyan(field)}: ${chalk59.gray(beforeVal)} ${chalk59.gray("→")} ${chalk59.green(afterVal)}`);
         }
         output.log("");
         if (result.wasRunning) {
-          output.info(chalk58.yellow(`⚠️  事件源在更新前正在运行，已自动停止。请使用 'roy-agent eventsource start ${match.fullId.substring(0, 8)}' 手动启动以应用新配置。`));
+          output.info(chalk59.yellow(`⚠️  事件源在更新前正在运行，已自动停止。请使用 'roy-agent eventsource start ${match.fullId.substring(0, 8)}' 手动启动以应用新配置。`));
         }
       } catch (error) {
         output.error(`❌ 更新失败: ${error instanceof Error ? error.message : String(error)}`);
@@ -17216,7 +17500,7 @@ var EventSourceUpdateCommand = {
 };
 // src/commands/eventsource/remove.ts
-import chalk59 from "chalk";
+import chalk60 from "chalk";
 var EventSourceRemoveCommand = {
   command: "remove <id>",
   aliases: ["rm"],
@@ -17255,7 +17539,7 @@ var EventSourceRemoveCommand = {
       const status = esComponent.getStatus(matchedSource.id);
       if (status === "running" && !args.force) {
         output.error(`事件源正在运行中，请先停止: ${matchedSource.name} (${status})`);
-        output.log(chalk59.gray(`使用 --force 强制移除或 'roy-agent eventsource stop ${matchedSource.id.substring(0, 8)}' 先停止`));
+        output.log(chalk60.gray(`使用 --force 强制移除或 'roy-agent eventsource stop ${matchedSource.id.substring(0, 8)}' 先停止`));
         process.exit(1);
       }
       if (status === "running") {
@@ -17264,7 +17548,7 @@ var EventSourceRemoveCommand = {
       }
       const result = esComponent.unregister(matchedSource.id);
       if (result) {
-        output.success(chalk59.green(`事件源已移除: ${matchedSource.name}`));
+        output.success(chalk60.green(`事件源已移除: ${matchedSource.name}`));
       } else {
         output.error("移除失败");
         process.exit(1);
@@ -17276,7 +17560,7 @@ var EventSourceRemoveCommand = {
 };
 // src/commands/eventsource/start.ts
-import chalk60 from "chalk";
+import chalk61 from "chalk";
 var EventSourceStartCommand = {
   command: "start <id>",
   describe: "启动指定的事件源",
@@ -17313,15 +17597,15 @@ var EventSourceStartCommand = {
       }
       const status = esComponent.getStatus(matchedSource.id);
       if (status === "running") {
-        output.log(chalk60.yellow(`事件源已在运行: ${matchedSource.name}`));
+        output.log(chalk61.yellow(`事件源已在运行: ${matchedSource.name}`));
         return;
       }
       output.info(`正在启动事件源 '${matchedSource.name}'...`);
       try {
         await esComponent.startSource(matchedSource.id);
-        output.success(chalk60.green(`事件源已启动: ${matchedSource.name}`));
+        output.success(chalk61.green(`事件源已启动: ${matchedSource.name}`));
         if (!args.background) {
-          output.log(chalk60.gray("按 Ctrl+C 停止..."));
+          output.log(chalk61.gray("按 Ctrl+C 停止..."));
           await new Promise((resolve) => {
             const cleanup = () => {
               process.removeListener("SIGINT", cleanup);
@@ -17343,7 +17627,7 @@ var EventSourceStartCommand = {
 };
 // src/commands/eventsource/stop.ts
-import chalk61 from "chalk";
+import chalk62 from "chalk";
 var EventSourceStopCommand = {
   command: "stop <id>",
   aliases: ["kill"],
@@ -17381,13 +17665,13 @@ var EventSourceStopCommand = {
       }
       const status = esComponent.getStatus(matchedSource.id);
       if (status !== "running") {
-        output.log(chalk61.yellow(`事件源未运行: ${matchedSource.name} (${status || "unknown"})`));
+        output.log(chalk62.yellow(`事件源未运行: ${matchedSource.name} (${status || "unknown"})`));
         return;
       }
       output.info(`正在停止事件源 '${matchedSource.name}'...`);
       try {
         await esComponent.stopSource(matchedSource.id);
-        output.success(chalk61.green(`事件源已停止: ${matchedSource.name}`));
+        output.success(chalk62.green(`事件源已停止: ${matchedSource.name}`));
       } catch (error) {
         output.error(`停止失败: ${error}`);
         process.exit(1);
@@ -17399,14 +17683,14 @@ var EventSourceStopCommand = {
 };
 // src/commands/eventsource/status.ts
-import chalk62 from "chalk";
+import chalk63 from "chalk";
 var STATUS_COLORS = {
-  created: chalk62.gray,
-  starting: chalk62.yellow,
-  running: chalk62.green,
-  stopping: chalk62.yellow,
-  stopped: chalk62.gray,
-  error: chalk62.red
+  created: chalk63.gray,
+  starting: chalk63.yellow,
+  running: chalk63.green,
+  stopping: chalk63.yellow,
+  stopped: chalk63.gray,
+  error: chalk63.red
 };
 var STATUS_ICONS = {
   created: "○",
@@ -17460,7 +17744,7 @@ var EventSourceStatusCommand = {
           process.exit(1);
         }
         const status = esComponent.getStatus(matchedSource.id) || "unknown";
-        const statusColor = STATUS_COLORS[status] || chalk62.gray;
+        const statusColor = STATUS_COLORS[status] || chalk63.gray;
         if (args.json) {
           output.json({
             id: matchedSource.id,
@@ -17477,31 +17761,31 @@ var EventSourceStatusCommand = {
           });
           return;
         }
-        output.log(chalk62.bold("事件源详情"));
+        output.log(chalk63.bold("事件源详情"));
         output.log("─".repeat(50));
-        output.log(`  ID:       ${chalk62.gray(matchedSource.id)}`);
-        output.log(`  Name:     ${chalk62.cyan(matchedSource.name)}`);
-        output.log(`  Type:     ${chalk62.cyan(matchedSource.type)}`);
+        output.log(`  ID:       ${chalk63.gray(matchedSource.id)}`);
+        output.log(`  Name:     ${chalk63.cyan(matchedSource.name)}`);
+        output.log(`  Type:     ${chalk63.cyan(matchedSource.type)}`);
         output.log(`  Status:   ${statusColor(`${STATUS_ICONS[status]} ${STATUS_LABELS[status]}`)}`);
-        output.log(`  Enabled:  ${matchedSource.enabled ? chalk62.green("是") : chalk62.gray("否")}`);
+        output.log(`  Enabled:  ${matchedSource.enabled ? chalk63.green("是") : chalk63.gray("否")}`);
         if (matchedSource.eventTypes?.length) {
-          output.log(`  Events:   ${chalk62.gray(matchedSource.eventTypes.join(", "))}`);
+          output.log(`  Events:   ${chalk63.gray(matchedSource.eventTypes.join(", "))}`);
         }
         if (matchedSource.command) {
-          output.log(`  Command:  ${chalk62.gray(matchedSource.command)}`);
+          output.log(`  Command:  ${chalk63.gray(matchedSource.command)}`);
         }
         if (matchedSource.interval) {
-          output.log(`  Interval: ${chalk62.gray(`${matchedSource.interval}ms`)}`);
+          output.log(`  Interval: ${chalk63.gray(`${matchedSource.interval}ms`)}`);
         }
         if (matchedSource.url) {
-          output.log(`  URL:      ${chalk62.gray(matchedSource.url)}`);
+          output.log(`  URL:      ${chalk63.gray(matchedSource.url)}`);
         }
         output.log("");
         return;
       }
       const sources = esComponent.list();
       if (sources.length === 0) {
-        output.log(chalk62.yellow("没有配置的事件源"));
+        output.log(chalk63.yellow("没有配置的事件源"));
         return;
       }
       if (args.json) {
@@ -17515,21 +17799,21 @@ var EventSourceStatusCommand = {
         output.json({ sources: sourcesWithStatus, count: sources.length });
         return;
       }
-      output.log(chalk62.bold("事件源状态概览"));
+      output.log(chalk63.bold("事件源状态概览"));
       output.log("─".repeat(60));
       for (const source of sources) {
         const status = esComponent.getStatus(source.id) || "unknown";
-        const statusColor = STATUS_COLORS[status] || chalk62.gray;
+        const statusColor = STATUS_COLORS[status] || chalk63.gray;
         const icon = STATUS_ICONS[status] || "?";
         const label = STATUS_LABELS[status] || status;
         output.log("");
-        output.log(`  ${chalk62.cyan(source.name)} ${chalk62.gray(`(${source.type})`)}`);
+        output.log(`  ${chalk63.cyan(source.name)} ${chalk63.gray(`(${source.type})`)}`);
         output.log(`  └─ Status: ${statusColor(`${icon} ${label}`)}`);
-        output.log(`     ID: ${chalk62.gray(source.id.substring(0, 8))}...`);
+        output.log(`     ID: ${chalk63.gray(source.id.substring(0, 8))}...`);
       }
       output.log("");
       const runningCount = sources.filter((s) => esComponent.getStatus(s.id) === "running").length;
-      output.log(chalk62.green(`✅ ${runningCount}/${sources.length} 运行中`));
+      output.log(chalk63.green(`✅ ${runningCount}/${sources.length} 运行中`));
     } finally {
       await envService.dispose();
     }
@@ -17842,7 +18126,7 @@ var DebugCommand = {
 };
 // src/commands/workflow/renderers.ts
-import chalk63 from "chalk";
+import chalk64 from "chalk";
 function truncateVisual3(str, maxWidth) {
   if (!str)
     return "-";
@@ -17877,18 +18161,18 @@ function formatDuration(ms) {
 function statusColor(status) {
   switch (status) {
     case "completed":
-      return chalk63.green;
+      return chalk64.green;
     case "running":
     case "idle":
-      return chalk63.blue;
+      return chalk64.blue;
     case "paused":
-      return chalk63.yellow;
+      return chalk64.yellow;
     case "failed":
-      return chalk63.red;
+      return chalk64.red;
     case "stopped":
-      return chalk63.gray;
+      return chalk64.gray;
     default:
-      return chalk63.white;
+      return chalk64.white;
   }
 }
 function renderWorkflowList(workflows, options) {
@@ -17907,7 +18191,7 @@ function renderWorkflowList(workflows, options) {
     }, null, 2);
   }
   if (workflows.length === 0) {
-    return chalk63.yellow("No workflows found");
+    return chalk64.yellow("No workflows found");
   }
   const NAME_WIDTH = 30;
   const VERSION_WIDTH = 10;
@@ -17915,10 +18199,10 @@ function renderWorkflowList(workflows, options) {
   const UPDATED_WIDTH = 20;
   const GAP = "  ";
   const headerLine = [
-    chalk63.bold("NAME".padEnd(NAME_WIDTH)),
-    chalk63.bold("VER".padEnd(VERSION_WIDTH)),
-    chalk63.bold("TAGS".padEnd(TAGS_WIDTH)),
-    chalk63.bold("UPDATED")
+    chalk64.bold("NAME".padEnd(NAME_WIDTH)),
+    chalk64.bold("VER".padEnd(VERSION_WIDTH)),
+    chalk64.bold("TAGS".padEnd(TAGS_WIDTH)),
+    chalk64.bold("UPDATED")
   ].join(GAP);
   const sepLine = "─".repeat(NAME_WIDTH + VERSION_WIDTH + TAGS_WIDTH + UPDATED_WIDTH + GAP.length * 3);
   const rows = workflows.map((w) => {
@@ -17933,18 +18217,18 @@ function renderWorkflowList(workflows, options) {
 }
 function renderWorkflowDetail(workflow, options) {
   const lines = [];
-  lines.push(chalk63.bold(`
+  lines.push(chalk64.bold(`
 \uD83D\uDCCB Workflow Details
 `));
-  lines.push(`  ${chalk63.cyan("ID:")}          ${workflow.id}`);
-  lines.push(`  ${chalk63.cyan("Name:")}        ${workflow.name}`);
-  lines.push(`  ${chalk63.cyan("Version:")}     ${workflow.version}`);
-  lines.push(`  ${chalk63.cyan("Description:")} ${workflow.description || "-"}`);
-  lines.push(`  ${chalk63.cyan("Tags:")}        ${workflow.tags.join(", ") || "-"}`);
-  lines.push(`  ${chalk63.cyan("Created:")}     ${formatDate(workflow.createdAt)}`);
-  lines.push(`  ${chalk63.cyan("Updated:")}     ${formatDate(workflow.updatedAt)}`);
+  lines.push(`  ${chalk64.cyan("ID:")}          ${workflow.id}`);
+  lines.push(`  ${chalk64.cyan("Name:")}        ${workflow.name}`);
+  lines.push(`  ${chalk64.cyan("Version:")}     ${workflow.version}`);
+  lines.push(`  ${chalk64.cyan("Description:")} ${workflow.description || "-"}`);
+  lines.push(`  ${chalk64.cyan("Tags:")}        ${workflow.tags.join(", ") || "-"}`);
+  lines.push(`  ${chalk64.cyan("Created:")}     ${formatDate(workflow.createdAt)}`);
+  lines.push(`  ${chalk64.cyan("Updated:")}     ${formatDate(workflow.updatedAt)}`);
   const nodeCount = workflow.definition.nodes.length;
-  lines.push(chalk63.bold(`
+  lines.push(chalk64.bold(`
 \uD83D\uDCCA Nodes Summary
 `));
   lines.push(`  Total: ${nodeCount} nodes`);
@@ -17956,7 +18240,7 @@ function renderWorkflowDetail(workflow, options) {
     lines.push(`    - ${type}: ${count}`);
   }
   if (workflow.definition.config) {
-    lines.push(chalk63.bold(`
+    lines.push(chalk64.bold(`
 ⚙️  Configuration
 `));
     if (workflow.definition.config.parallel_limit !== undefined) {
@@ -17970,7 +18254,7 @@ function renderWorkflowDetail(workflow, options) {
     }
   }
   if (options?.includeRuns && options.includeRuns.length > 0) {
-    lines.push(chalk63.bold(`
+    lines.push(chalk64.bold(`
 \uD83D\uDCDC Recent Runs
 `));
     lines.push(renderRunsList(options.includeRuns.slice(0, 5)));
@@ -17994,7 +18278,7 @@ function renderRunsList(runs, options) {
     }, null, 2);
   }
   if (runs.length === 0) {
-    return chalk63.yellow("No runs found");
+    return chalk64.yellow("No runs found");
   }
   const ID_WIDTH = 20;
   const STATUS_WIDTH = 12;
@@ -18002,10 +18286,10 @@ function renderRunsList(runs, options) {
   const UPDATED_WIDTH = 20;
   const GAP = "  ";
   const headerLine = [
-    chalk63.bold("RUN ID".padEnd(ID_WIDTH)),
-    chalk63.bold("STATUS".padEnd(STATUS_WIDTH)),
-    chalk63.bold("DURATION".padEnd(DURATION_WIDTH)),
-    chalk63.bold("STARTED")
+    chalk64.bold("RUN ID".padEnd(ID_WIDTH)),
+    chalk64.bold("STATUS".padEnd(STATUS_WIDTH)),
+    chalk64.bold("DURATION".padEnd(DURATION_WIDTH)),
+    chalk64.bold("STARTED")
   ].join(GAP);
   const sepLine = "─".repeat(ID_WIDTH + STATUS_WIDTH + DURATION_WIDTH + UPDATED_WIDTH + GAP.length * 3);
   const rows = runs.map((r) => {
@@ -18020,34 +18304,34 @@ function renderRunsList(runs, options) {
 }
 function renderRunDetail(run) {
   const lines = [];
-  lines.push(chalk63.bold(`
+  lines.push(chalk64.bold(`
 \uD83C\uDFC3 Run Details
 `));
-  lines.push(`  ${chalk63.cyan("Run ID:")}     ${run.id}`);
-  lines.push(`  ${chalk63.cyan("Workflow:")}  ${run.workflowId}`);
-  lines.push(`  ${chalk63.cyan("Status:")}    ${statusColor(run.status)(run.status)}`);
-  lines.push(`  ${chalk63.cyan("Started:")}   ${formatDate(run.startedAt)}`);
+  lines.push(`  ${chalk64.cyan("Run ID:")}     ${run.id}`);
+  lines.push(`  ${chalk64.cyan("Workflow:")}  ${run.workflowId}`);
+  lines.push(`  ${chalk64.cyan("Status:")}    ${statusColor(run.status)(run.status)}`);
+  lines.push(`  ${chalk64.cyan("Started:")}   ${formatDate(run.startedAt)}`);
   if (run.pausedAt) {
-    lines.push(`  ${chalk63.cyan("Paused:")}    ${formatDate(run.pausedAt)}`);
+    lines.push(`  ${chalk64.cyan("Paused:")}    ${formatDate(run.pausedAt)}`);
   }
   if (run.resumedAt) {
-    lines.push(`  ${chalk63.cyan("Resumed:")}   ${formatDate(run.resumedAt)}`);
+    lines.push(`  ${chalk64.cyan("Resumed:")}   ${formatDate(run.resumedAt)}`);
   }
   if (run.stoppedAt) {
-    lines.push(`  ${chalk63.cyan("Stopped:")}   ${formatDate(run.stoppedAt)}`);
+    lines.push(`  ${chalk64.cyan("Stopped:")}   ${formatDate(run.stoppedAt)}`);
   }
   if (run.completedAt) {
-    lines.push(`  ${chalk63.cyan("Completed:")} ${formatDate(run.completedAt)}`);
+    lines.push(`  ${chalk64.cyan("Completed:")} ${formatDate(run.completedAt)}`);
   }
-  lines.push(`  ${chalk63.cyan("Duration:")}  ${formatDuration(run.durationMs)}`);
+  lines.push(`  ${chalk64.cyan("Duration:")}  ${formatDuration(run.durationMs)}`);
   if (run.error) {
-    lines.push(chalk63.bold(`
+    lines.push(chalk64.bold(`
 ❌ Error
 `));
-    lines.push(`  ${chalk63.red(run.error)}`);
+    lines.push(`  ${chalk64.red(run.error)}`);
   }
   if (run.output) {
-    lines.push(chalk63.bold(`
+    lines.push(chalk64.bold(`
 \uD83D\uDCE4 Output
 `));
     lines.push("  " + JSON.stringify(run.output, null, 2).split(`
@@ -18058,36 +18342,36 @@ function renderRunDetail(run) {
 `);
 }
 function renderWorkflowAdded(workflow) {
-  return chalk63.green(`
+  return chalk64.green(`
 ✅ Workflow '${workflow.name}' added successfully
 `) + `   ID: ${workflow.id}
 ` + `   Version: ${workflow.version}
 `;
 }
 function renderWorkflowUpdated(workflow) {
-  return chalk63.green(`
+  return chalk64.green(`
 ✅ Workflow '${workflow.name}' updated successfully
 `) + `   ID: ${workflow.id}
 `;
 }
 function renderWorkflowDeleted(name) {
-  return chalk63.green(`
+  return chalk64.green(`
 ✅ Workflow '${name}' deleted successfully
 `);
 }
 function renderRunResult(result) {
   const lines = [];
   if (result.status === "completed") {
-    lines.push(chalk63.green(`
+    lines.push(chalk64.green(`
 ✅ Workflow completed successfully`));
   } else if (result.status === "failed") {
-    lines.push(chalk63.red(`
+    lines.push(chalk64.red(`
 ❌ Workflow failed`));
   } else if (result.status === "stopped") {
-    lines.push(chalk63.yellow(`
+    lines.push(chalk64.yellow(`
 ⚠️  Workflow stopped`));
   } else {
-    lines.push(chalk63.blue(`
+    lines.push(chalk64.blue(`
 \uD83D\uDD04 Workflow ${result.status}`));
   }
   lines.push(`   Run ID: ${result.runId}`);
@@ -18095,11 +18379,11 @@ function renderRunResult(result) {
     lines.push(`   Duration: ${formatDuration(result.durationMs)}`);
   }
   if (result.error) {
-    lines.push(chalk63.red(`
+    lines.push(chalk64.red(`
    Error: ${result.error}`));
   }
   if (result.output) {
-    lines.push(chalk63.bold(`
+    lines.push(chalk64.bold(`
 \uD83D\uDCE4 Output:`));
     lines.push(JSON.stringify(result.output, null, 2));
   }
@@ -18113,10 +18397,10 @@ function renderNodesList(nodes) {
   const DEPS_WIDTH = 20;
   const GAP = "  ";
   const headerLine = [
-    chalk63.bold("NODE ID".padEnd(ID_WIDTH)),
-    chalk63.bold("TYPE".padEnd(TYPE_WIDTH)),
-    chalk63.bold("NAME".padEnd(NAME_WIDTH)),
-    chalk63.bold("DEPENDS ON")
+    chalk64.bold("NODE ID".padEnd(ID_WIDTH)),
+    chalk64.bold("TYPE".padEnd(TYPE_WIDTH)),
+    chalk64.bold("NAME".padEnd(NAME_WIDTH)),
+    chalk64.bold("DEPENDS ON")
   ].join(GAP);
   const sepLine = "─".repeat(ID_WIDTH + TYPE_WIDTH + NAME_WIDTH + DEPS_WIDTH + GAP.length * 3);
   const rows = nodes.map((n) => {
@@ -18131,7 +18415,7 @@ function renderNodesList(nodes) {
 }
 // src/commands/workflow/commands/list.ts
-import chalk64 from "chalk";
+import chalk65 from "chalk";
 import { createWorkflowListTool } from "@ai-setting/roy-agent-core/env/workflow/tools";
 function buildListWorkflowsJson(workflows, total, args, availableTags) {
   const output = {
@@ -18162,10 +18446,10 @@ var WorkflowListCommand = {
     describe: "搜索 description 和 tags（支持 AND/OR/NOT 语法）",
     type: "string"
   }).option("limit", {
-    alias: "l",
-    describe: "返回数量限制",
+    alias: ["l", "n"],
+    describe: "返回数量限制（-l 旧 alias, -n 新统一 alias）",
     type: "number",
-    default: 50
+    default: 20
   }).option("offset", {
     alias: "o",
     describe: "分页偏移",
@@ -18263,6 +18547,18 @@ var WorkflowListCommand = {
           offset: finalOffset,
           page: page > 1 ? page : Math.floor(finalOffset / pageSize) + 1
         }, availableTags));
+      } else if (args.quiet) {
+        output.log(renderQuietHeader(total, "workflow"));
+        workflows.forEach((w) => output.log(renderQuietLine(w.name, w.name)));
+        const hint = renderQuietPaginationHint({
+          count: workflows.length,
+          total,
+          offset: finalOffset,
+          limit: pageSize
+        });
+        if (hint)
+          output.log(hint);
+        return;
       } else {
         const renderWorkflows = workflows.map((w) => ({
           id: w.name,
@@ -18279,20 +18575,20 @@ var WorkflowListCommand = {
         if (total > workflows.length) {
           const start = finalOffset + 1;
           const end = finalOffset + workflows.length;
-          output.log(chalk64.green(`
+          output.log(chalk65.green(`
 ✅ 显示 ${start}-${end} / 共 ${total} 个 Workflow`));
           const totalPages = Math.ceil(total / pageSize);
           const currentPage = Math.floor(finalOffset / pageSize) + 1;
           if (totalPages > 1) {
-            output.log(chalk64.cyan(`\uD83D\uDCC4 第 ${currentPage} / ${totalPages} 页`));
+            output.log(chalk65.cyan(`\uD83D\uDCC4 第 ${currentPage} / ${totalPages} 页`));
           }
         } else {
-          output.log(chalk64.green(`
+          output.log(chalk65.green(`
 ✅ 共 ${total} 个 Workflow`));
         }
         if (availableTags.length > 0) {
           const tagsLine = availableTags.map((t) => `${t.name}(${t.count})`).join(", ");
-          output.log(chalk64.cyan(`
+          output.log(chalk65.cyan(`
 \uD83C\uDFF7️  Available tags: ${tagsLine}`));
         }
       }
@@ -18896,7 +19192,7 @@ class WorkflowValidator {
 // src/commands/workflow/commands/add.ts
 import { validateWorkflowDefinition } from "@ai-setting/roy-agent-core/env/workflow/utils";
-import chalk65 from "chalk";
+import chalk66 from "chalk";
 import fs3 from "fs";
 import path6 from "path";
 async function parseWorkflowContent(content, filename) {
@@ -19038,7 +19334,7 @@ var WorkflowAddCommand = {
         definition = await parseWorkflowContent(content, filePath);
         workflowName = a.name || definition.name || path6.basename(filePath);
         if (a.validate) {
-          output.log(chalk65.blue("\uD83D\uDD0D Validating workflow..."));
+          output.log(chalk66.blue("\uD83D\uDD0D Validating workflow..."));
           const dagResult = validateWorkflowDefinition(definition);
           if (!dagResult.valid) {
             output.error(`
@@ -19062,11 +19358,11 @@ var WorkflowAddCommand = {
             });
             process.exit(1);
           }
-          output.log(chalk65.green(`✅ Workflow validation passed
+          output.log(chalk66.green(`✅ Workflow validation passed
 `));
         }
       } else if (a.desc) {
-        output.log(chalk65.blue(`\uD83E\uDD16 Generating workflow from description...
+        output.log(chalk66.blue(`\uD83E\uDD16 Generating workflow from description...
 `));
         const agentComponent = env.getComponent("agent");
         if (!agentComponent) {
@@ -19088,20 +19384,20 @@ ${a.desc}
 1. 先用 \`roy-agent workflow nodes\` 查看可用的节点类型
 2. 生成的 YAML 必须通过 \`roy-agent workflow validate --yaml "<yaml>"\` 验证
 3. 验证通过后才输出最终 YAML`;
-        output.log(chalk65.gray("Running workflow-extract agent..."));
+        output.log(chalk66.gray("Running workflow-extract agent..."));
         const result = await agentComponent.run("workflow-extract", prompt);
         const agentOutput = result.finalText || "";
         definition = parseYamlFromAgentOutput(agentOutput);
         if (definition === null) {
           output.error("Failed to parse workflow from agent output");
-          output.log(chalk65.gray(`
+          output.log(chalk66.gray(`
 Agent output:
 ` + agentOutput.slice(0, 500)));
           process.exit(1);
         }
         workflowName = a.name || definition.name;
         if (a.validate) {
-          output.log(chalk65.blue(`
+          output.log(chalk66.blue(`
 \uD83D\uDD0D Validating generated workflow...`));
           const dagResult = validateWorkflowDefinition(definition);
           if (!dagResult.valid) {
@@ -19110,7 +19406,7 @@ Agent output:
             dagResult.errors.forEach((msg, i) => {
               output.error(`[Error ${i + 1}/${dagResult.errors.length}] ${msg}`);
             });
-            output.log(chalk65.yellow("请修正描述后重新尝试，或使用 --file 选项直接提供 YAML"));
+            output.log(chalk66.yellow("请修正描述后重新尝试，或使用 --file 选项直接提供 YAML"));
             process.exit(1);
           }
           const validator = new WorkflowValidator;
@@ -19125,16 +19421,16 @@ Agent output:
               output.error(`  Fix: ${error.fix}
 `);
             });
-            output.log(chalk65.yellow("请修正描述后重新尝试，或使用 --file 选项直接提供 YAML"));
+            output.log(chalk66.yellow("请修正描述后重新尝试，或使用 --file 选项直接提供 YAML"));
             process.exit(1);
           }
-          output.log(chalk65.green(`✅ Generated workflow validation passed
+          output.log(chalk66.green(`✅ Generated workflow validation passed
 `));
         }
         const yaml = await Promise.resolve().then(() => __toESM(require_dist(), 1));
-        output.log(chalk65.gray("--- Generated YAML ---"));
+        output.log(chalk66.gray("--- Generated YAML ---"));
         output.log(yaml.stringify(definition));
-        output.log(chalk65.gray(`------------------------
+        output.log(chalk66.gray(`------------------------
 `));
       } else {
         output.error("Please provide --file or --desc option");
@@ -19160,10 +19456,10 @@ Agent output:
         force: a.force
       });
       output.log(renderWorkflowAdded(workflow));
-      output.log(chalk65.bold(`
+      output.log(chalk66.bold(`
 \uD83D\uDCCA Nodes Summary:`));
       output.log(renderNodesList(definition.nodes));
-      output.log(chalk65.green(`
+      output.log(chalk66.green(`
 ✅ Workflow '${workflowName}' added successfully`));
     } catch (error) {
       if (error.message?.includes("already exists") && !a.force) {
@@ -19180,7 +19476,7 @@ Agent output:
 };
 // src/commands/workflow/commands/get.ts
-import chalk66 from "chalk";
+import chalk67 from "chalk";
 import { createWorkflowGetTool } from "@ai-setting/roy-agent-core/env/workflow/tools";
 var WorkflowGetCommand = {
   command: "get <identifier>",
@@ -19318,15 +19614,15 @@ var WorkflowGetCommand = {
         } else {
           output.log(renderWorkflowDetail(workflow, { includeRuns: runs }));
           if (args.includeNodes) {
-            output.log(chalk66.bold(`
+            output.log(chalk67.bold(`
 \uD83D\uDCCB All Nodes:`));
             output.log(renderNodesList(data.nodes || []));
           }
           const yaml = await Promise.resolve().then(() => __toESM(require_dist(), 1));
           const defYaml = yaml.stringify(data.definition || {}, { indent: 2 });
-          output.log(chalk66.bold(`
+          output.log(chalk67.bold(`
 \uD83D\uDCC4 Definition (YAML):`));
-          output.log(chalk66.gray(defYaml));
+          output.log(chalk67.gray(defYaml));
         }
       }
     } catch (error) {
@@ -19339,7 +19635,7 @@ var WorkflowGetCommand = {
 };
 // src/commands/workflow/commands/update.ts
-import chalk67 from "chalk";
+import chalk68 from "chalk";
 import fs4 from "fs";
 import path7 from "path";
 import { parseWorkflowFile } from "@ai-setting/roy-agent-core/env/workflow/types";
@@ -19412,7 +19708,7 @@ var WorkflowUpdateCommand = {
       const tags = a.tags ? a.tags.split(",").map((t) => t.trim()) : undefined;
       const workflow = await service.updateWorkflow(a.name, updates, { tags });
       output.log(renderWorkflowUpdated(workflow));
-      output.log(chalk67.green(`
+      output.log(chalk68.green(`
 ✅ Workflow '${a.name}' updated successfully`));
     } catch (error) {
       output.error(`Failed to update workflow: ${error}`);
@@ -19424,7 +19720,7 @@ var WorkflowUpdateCommand = {
 };
 // src/commands/workflow/commands/remove.ts
-import chalk68 from "chalk";
+import chalk69 from "chalk";
 var WorkflowRemoveCommand = {
   command: "remove <name>",
   describe: "删除 Workflow",
@@ -19463,8 +19759,8 @@ var WorkflowRemoveCommand = {
         process.exit(1);
       }
       if (!args.force) {
-        output.log(chalk68.yellow(`Are you sure you want to delete workflow '${args.name}'?`));
-        output.log(chalk68.gray("Use --force to skip confirmation"));
+        output.log(chalk69.yellow(`Are you sure you want to delete workflow '${args.name}'?`));
+        output.log(chalk69.gray("Use --force to skip confirmation"));
         process.exit(1);
       }
       const deleted = await service.deleteWorkflow(args.name);
@@ -19484,7 +19780,7 @@ var WorkflowRemoveCommand = {
 // src/commands/workflow/commands/run.ts
 var import_yaml = __toESM(require_dist(), 1);
-import chalk69 from "chalk";
+import chalk70 from "chalk";
 import fs5 from "fs";
 import path8 from "path";
 import { createRunWorkflowTool } from "@ai-setting/roy-agent-core/env/workflow/tools";
@@ -19571,7 +19867,7 @@ var runWorkflow = wrapFunction(async function runWorkflowImpl(args) {
     }
     if (args.session) {
       const sessionId = args.session;
-      output.log(chalk69.blue(`\uD83D\uDD04 Resuming workflow from session: ${sessionId}`));
+      output.log(chalk70.blue(`\uD83D\uDD04 Resuming workflow from session: ${sessionId}`));
       const sessionComponent = workflowComponent.sessionComponent;
       if (!sessionComponent) {
         output.error("SessionComponent not available");
@@ -19633,17 +19929,17 @@ var runWorkflow = wrapFunction(async function runWorkflowImpl(args) {
         definition = { ...definition, name: args.name };
       }
       const workflow = await service.createWorkflow(definition, { force: true });
-      output.log(chalk69.blue(`\uD83D\uDCDD Registering workflow: ${registrationName}`));
-      output.log(chalk69.green(`✅ Workflow registered: ${workflow.name} (${workflow.id})`));
+      output.log(chalk70.blue(`\uD83D\uDCDD Registering workflow: ${registrationName}`));
+      output.log(chalk70.green(`✅ Workflow registered: ${workflow.name} (${workflow.id})`));
       if (args.registerOnly) {
-        output.log(chalk69.gray("ℹ️  Use --register-only, skipping execution"));
+        output.log(chalk70.gray("ℹ️  Use --register-only, skipping execution"));
         if (workflowSpan) {
           workflowSpan.end();
         }
         await envService.dispose();
         process.exit(0);
       }
-      output.log(chalk69.blue(`\uD83D\uDE80 Running workflow: ${workflow.name}`));
+      output.log(chalk70.blue(`\uD83D\uDE80 Running workflow: ${workflow.name}`));
       const result = await service.runWorkflow(definition, input, runOptions);
       output.log(renderRunResult({
         runId: result.runId,
@@ -19653,7 +19949,7 @@ var runWorkflow = wrapFunction(async function runWorkflowImpl(args) {
         durationMs: result.durationMs
       }));
       if (result.status === "paused") {
-        output.log(chalk69.gray(`
+        output.log(chalk70.gray(`
 \uD83D\uDCA1 Use "roy-agent workflow run ${result.runId} --session ${result.runId} --input '<response>'" to resume`));
       }
     } else {
@@ -19676,7 +19972,7 @@ var runWorkflow = wrapFunction(async function runWorkflowImpl(args) {
         durationMs: runData.duration_ms
       }));
       if (runData.status === "paused") {
-        output.log(chalk69.gray(`
+        output.log(chalk70.gray(`
 \uD83D\uDCA1 Use "roy-agent workflow run ${runData.run_id} --session ${runData.run_id} --input '<response>'" to resume`));
       }
     }
@@ -19748,7 +20044,7 @@ var WorkflowRunCommand = {
 };
 // src/commands/workflow/commands/stop.ts
-import chalk70 from "chalk";
+import chalk71 from "chalk";
 import { createWorkflowRunStopTool } from "@ai-setting/roy-agent-core/env/workflow/tools";
 import { wrapFunction as wrapFunction2 } from "@ai-setting/roy-agent-core";
 var stopWorkflow = wrapFunction2(async function stopWorkflowImpl(args) {
@@ -19773,7 +20069,7 @@ var stopWorkflow = wrapFunction2(async function stopWorkflowImpl(args) {
       output.error(result.error || `Failed to stop workflow: ${args.runId}`);
       process.exit(1);
     }
-    output.log(chalk70.red(`
+    output.log(chalk71.red(`
 ⏹️  Workflow stopped: ${args.runId}`));
   } catch (error) {
     output.error(`Failed to stop workflow: ${error}`);
@@ -19797,7 +20093,7 @@ var WorkflowStopCommand = {
 };
 // src/commands/workflow/commands/status.ts
-import chalk71 from "chalk";
+import chalk72 from "chalk";
 import { createWorkflowRunStatusTool } from "@ai-setting/roy-agent-core/env/workflow/tools";
 var WorkflowStatusCommand = {
   command: "status <runId>",
@@ -19890,7 +20186,7 @@ var WorkflowStatusCommand = {
           stopped: "⏹️"
         };
         const emoji = statusEmoji[status] || "❓";
-        output.log(chalk71.bold(`
+        output.log(chalk72.bold(`
 ${emoji} Status: ${status.toUpperCase()}`));
       }
     } catch (error) {
@@ -19903,7 +20199,7 @@ ${emoji} Status: ${status.toUpperCase()}`));
 };
 // src/commands/workflow/commands/nodes.ts
-import chalk72 from "chalk";
+import chalk73 from "chalk";
 var BUILT_IN_NODES = [
   {
     name: "ToolNode",
@@ -20240,7 +20536,7 @@ nodes:
 ];
 function renderNodeTypesTable(nodes) {
   const lines = [];
-  lines.push(chalk72.bold(`
+  lines.push(chalk73.bold(`
 \uD83D\uDCE6 Built-in Node Types
 `));
   lines.push("┌────────────┬────────────────────┬─────────────────────────────────────────────────────────────┐");
@@ -20258,29 +20554,29 @@ function renderNodeTypesTable(nodes) {
 }
 function renderNodeDetail(node) {
   const lines = [];
-  lines.push(chalk72.bold(`
+  lines.push(chalk73.bold(`
 [${node.type}] ${node.name}`));
-  lines.push(chalk72.dim("─".repeat(60)) + `
+  lines.push(chalk73.dim("─".repeat(60)) + `
 `);
-  lines.push(chalk72.bold("Description:"));
+  lines.push(chalk73.bold("Description:"));
   lines.push(`  ${node.description}
 `);
-  lines.push(chalk72.bold("Configuration:"));
+  lines.push(chalk73.bold("Configuration:"));
   lines.push('  type: "' + node.type + '"');
   lines.push("  config:");
   for (const input of node.inputs) {
-    const required = input.required ? chalk72.red("*") : " ";
+    const required = input.required ? chalk73.red("*") : " ";
     lines.push(`    ${input.name} (${input.type})${required}`);
     lines.push(`      ${input.description}`);
   }
   lines.push(`
-${chalk72.bold("Output:")} ${node.output}`);
+${chalk73.bold("Output:")} ${node.output}`);
   if (node.example) {
-    lines.push(chalk72.bold(`
+    lines.push(chalk73.bold(`
 Example:`));
-    lines.push(chalk72.gray("```yaml"));
+    lines.push(chalk73.gray("```yaml"));
     lines.push(node.example);
-    lines.push(chalk72.gray("```"));
+    lines.push(chalk73.gray("```"));
   }
   return lines.join(`
 `);
@@ -20296,16 +20592,16 @@ var WorkflowNodesCommand = {
     const nodeType = args.type?.toLowerCase();
     if (!nodeType) {
       console.log(renderNodeTypesTable(BUILT_IN_NODES));
-      console.log(chalk72.gray(`
-Use `) + chalk72.cyan("roy-agent workflow nodes <type>") + chalk72.gray(" for detailed information"));
-      console.log(chalk72.gray("Available types: ") + chalk72.yellow(BUILT_IN_NODES.map((n) => n.type).join(", ")));
+      console.log(chalk73.gray(`
+Use `) + chalk73.cyan("roy-agent workflow nodes <type>") + chalk73.gray(" for detailed information"));
+      console.log(chalk73.gray("Available types: ") + chalk73.yellow(BUILT_IN_NODES.map((n) => n.type).join(", ")));
       return;
     }
     const node = BUILT_IN_NODES.find((n) => n.type === nodeType);
     if (!node) {
-      console.log(chalk72.red(`
+      console.log(chalk73.red(`
 ❌ Unknown node type: ${nodeType}`));
-      console.log(chalk72.gray("Available types: ") + chalk72.yellow(BUILT_IN_NODES.map((n) => n.type).join(", ")));
+      console.log(chalk73.gray("Available types: ") + chalk73.yellow(BUILT_IN_NODES.map((n) => n.type).join(", ")));
       process.exit(1);
     }
     console.log(renderNodeDetail(node));
@@ -20313,7 +20609,7 @@ Use `) + chalk72.cyan("roy-agent workflow nodes <type>") + chalk72.gray(" for de
 };
 // src/commands/workflow/commands/validate.ts
-import chalk73 from "chalk";
+import chalk74 from "chalk";
 import { readFileSync } from "fs";
 async function parseWorkflowInput(input, yamlStr) {
   const parseYaml = async (content) => {
@@ -20346,25 +20642,25 @@ function renderResult(result, options) {
     return;
   }
   if (result.valid) {
-    console.log(chalk73.green(`
+    console.log(chalk74.green(`
 ✅ Workflow validation PASSED
 `));
-    console.log(chalk73.bold(`Workflow: ${result.workflowName}`));
+    console.log(chalk74.bold(`Workflow: ${result.workflowName}`));
     console.log(`Nodes: ${result.nodeCount}`);
     console.log(`
 Valid nodes:`);
-    console.log(chalk73.green("  ✓ All nodes passed validation"));
+    console.log(chalk74.green("  ✓ All nodes passed validation"));
   } else {
-    console.log(chalk73.red(`
+    console.log(chalk74.red(`
 ❌ Workflow validation FAILED (${result.errors.length} errors found)
 `));
     result.errors.forEach((error, index) => {
-      console.log(chalk73.red(`[Error ${index + 1}/${result.errors.length}]${error.nodeId ? ` Node "${error.nodeId}"` : ""}`));
-      console.log(`  ${chalk73.bold("Type:")} ${error.type}`);
-      console.log(`  ${chalk73.bold("Description:")} ${error.description}`);
-      console.log(`  ${chalk73.bold("Expected:")} ${error.expected}`);
-      console.log(`  ${chalk73.bold("Actual:")} ${error.actual}`);
-      console.log(`  ${chalk73.green("Fix:")} ${error.fix}`);
+      console.log(chalk74.red(`[Error ${index + 1}/${result.errors.length}]${error.nodeId ? ` Node "${error.nodeId}"` : ""}`));
+      console.log(`  ${chalk74.bold("Type:")} ${error.type}`);
+      console.log(`  ${chalk74.bold("Description:")} ${error.description}`);
+      console.log(`  ${chalk74.bold("Expected:")} ${error.expected}`);
+      console.log(`  ${chalk74.bold("Actual:")} ${error.actual}`);
+      console.log(`  ${chalk74.green("Fix:")} ${error.fix}`);
       console.log();
     });
   }
@@ -20389,7 +20685,7 @@ var WorkflowValidateCommand = {
     try {
       const workflow = await parseWorkflowInput(options.input, options.yaml);
       if (!workflow) {
-        console.error(chalk73.red("Failed to parse workflow input"));
+        console.error(chalk74.red("Failed to parse workflow input"));
         process.exit(1);
       }
       const validator = new WorkflowValidator;
@@ -20397,7 +20693,7 @@ var WorkflowValidateCommand = {
       renderResult(result, options);
       process.exit(result.valid ? 0 : 1);
     } catch (error) {
-      console.error(chalk73.red(`
+      console.error(chalk74.red(`
 Error: ${error.message}`));
       process.exit(1);
     }
@@ -20405,7 +20701,7 @@ Error: ${error.message}`));
 };
 // src/commands/workflow/commands/search.ts
-import chalk74 from "chalk";
+import chalk75 from "chalk";
 import { wrapFunction as wrapFunction3 } from "@ai-setting/roy-agent-core";
 var WorkflowSearchCommand = {
   command: "search",
@@ -20562,22 +20858,22 @@ var _runWorkflowSearchImpl = async function(opts) {
     metadata: {}
   }));
   if (renderWorkflows.length === 0) {
-    output.log(chalk74.yellow("\uD83D\uDD0D No workflows matched the search criteria."));
-    output.log(chalk74.gray(`   keyword: ${keyword || "(none)"}`));
-    output.log(chalk74.gray(`   tags: ${tags && tags.length > 0 ? tags.join(", ") : "(none)"}`));
+    output.log(chalk75.yellow("\uD83D\uDD0D No workflows matched the search criteria."));
+    output.log(chalk75.gray(`   keyword: ${keyword || "(none)"}`));
+    output.log(chalk75.gray(`   tags: ${tags && tags.length > 0 ? tags.join(", ") : "(none)"}`));
   } else {
-    output.log(chalk74.bold(`\uD83D\uDD0D Search results (${renderWorkflows.length}):`));
+    output.log(chalk75.bold(`\uD83D\uDD0D Search results (${renderWorkflows.length}):`));
     output.log(renderWorkflowList(renderWorkflows));
-    output.log(chalk74.green(`
+    output.log(chalk75.green(`
 ✅ Found ${renderWorkflows.length} workflow(s)`));
   }
   if (availableTags.length > 0) {
     output.log("");
-    output.log(chalk74.bold("\uD83D\uDCDA Available tags (sorted by usage_count):"));
+    output.log(chalk75.bold("\uD83D\uDCDA Available tags (sorted by usage_count):"));
     for (const t of availableTags) {
       const name = t.name ?? t.tag;
       const count = t.count ?? t.usage_count;
-      output.log(chalk74.gray(`   - ${name} (${count})`));
+      output.log(chalk75.gray(`   - ${name} (${count})`));
     }
   }
 };
@@ -20589,7 +20885,7 @@ var runWorkflowSearch = wrapFunction3(_runWorkflowSearchImpl, "workflow.cli.sear
 // src/commands/workflow/commands/tag.ts
 import { wrapFunction as wrapFunction4 } from "@ai-setting/roy-agent-core";
-import chalk75 from "chalk";
+import chalk76 from "chalk";
 var WorkflowTagListCommand = {
   command: "list",
   describe: "List all workflow tags from the workflow_tags table (sorted by usage_count DESC by default). Use this BEFORE `workflow add` to discover existing tags and reuse them for semantic consistency.",
@@ -20710,17 +21006,17 @@ var _runWorkflowTagListImpl = async function(opts) {
     return;
   }
   if (result.tags.length === 0) {
-    output.log(chalk75.yellow("\uD83C\uDFF7️  No tags in the workflow_tags table yet."));
-    output.log(chalk75.gray("   Tags are created automatically when you run `workflow add --tags <name>`."));
+    output.log(chalk76.yellow("\uD83C\uDFF7️  No tags in the workflow_tags table yet."));
+    output.log(chalk76.gray("   Tags are created automatically when you run `workflow add --tags <name>`."));
     return;
   }
-  output.log(chalk75.bold(`\uD83C\uDFF7️  Workflow tags (${result.total}):`));
-  output.log(chalk75.gray(`   ${padRight("NAME", 24)}${padRight("USAGE", 8)}${padRight("CREATED", 22)}`));
+  output.log(chalk76.bold(`\uD83C\uDFF7️  Workflow tags (${result.total}):`));
+  output.log(chalk76.gray(`   ${padRight("NAME", 24)}${padRight("USAGE", 8)}${padRight("CREATED", 22)}`));
   for (const t of result.tags) {
     const line = `   ${padRight(t.name, 24)}${padRight(String(t.usage_count), 8)}${padRight(formatDate2(t.created_at), 22)}`;
     output.log(line);
   }
-  output.log(chalk75.gray(`
+  output.log(chalk76.gray(`
 \uD83D\uDCA1 Tip: when adding a new workflow, prefer tags from this list to ensure semantic consistency.`));
 };
 var _runWorkflowTagGetImpl = async function(opts) {
@@ -20747,7 +21043,7 @@ var _runWorkflowTagGetImpl = async function(opts) {
       output.json({ error: "Tag not found", name: opts.name });
     } else {
       output.error(`Tag "${opts.name}" not found in the workflow_tags table.`);
-      output.log(chalk75.gray(`Tip: run \`roy-agent workflow tag list\` to see available tags.`));
+      output.log(chalk76.gray(`Tip: run \`roy-agent workflow tag list\` to see available tags.`));
     }
     process.exitCode = 1;
     return;
@@ -20756,10 +21052,10 @@ var _runWorkflowTagGetImpl = async function(opts) {
     output.json(tag);
     return;
   }
-  output.log(chalk75.bold(`\uD83C\uDFF7️  Tag: ${tag.name}`));
-  output.log(chalk75.gray(`   usage_count: ${tag.usage_count}`));
-  output.log(chalk75.gray(`   created_at:  ${tag.created_at}`));
-  output.log(chalk75.gray(`   updated_at:  ${tag.updated_at}`));
+  output.log(chalk76.bold(`\uD83C\uDFF7️  Tag: ${tag.name}`));
+  output.log(chalk76.gray(`   usage_count: ${tag.usage_count}`));
+  output.log(chalk76.gray(`   created_at:  ${tag.created_at}`));
+  output.log(chalk76.gray(`   updated_at:  ${tag.updated_at}`));
 };
 async function callListTags(service, options) {
   if (typeof service.listTags !== "function") {
@@ -21413,6 +21709,10 @@ var InstallCommand = {
 // src/cli.ts
 function quietModeMiddleware(argv) {
+  if (argv.noquiet === true) {
+    argv.quiet = false;
+    delete argv.noquiet;
+  }
   const quietService = CliQuietModeService.getInstance();
   if (argv.quiet === true) {
     quietService.setQuiet(true);
@@ -21454,6 +21754,10 @@ async function runCli() {
     type: "boolean",
     default: true,
     global: true
+  }).option("noquiet", {
+    type: "boolean",
+    description: "Alias for --no-quiet (no hyphen form). Disables quiet mode.",
+    global: true
   }).option("plugin", {
     alias: "p",
     type: "string",