@ai-setting/roy-agent-cli 1.5.84 → 1.5.86

package/dist/bin/roy-agent.js

@@ -7320,7 +7320,7 @@ var require_dist = __commonJS((exports) => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "@ai-setting/roy-agent-cli",
-    version: "1.5.84",
+    version: "1.5.86",
     type: "module",
     description: "CLI for roy-agent - Non-interactive command execution",
     main: "./dist/index.js",
@@ -9000,16 +9000,13 @@ class EventMessageFormatter {
   }
   formatTaskProgress(payload) {
     const desc = payload.description || "未命名任务";
-    const progress = payload.progress !== undefined ? `${payload.progress}%` : "";
     const message = payload.progressMessage || "";
     const taskId = payload.associatedTaskId;
     let result = `${this.prefix} \uD83D\uDD04 后台任务「${desc}」`;
     if (taskId !== undefined) {
       result += `[Task #${taskId}] `;
     }
-    result += `进度更新`;
-    if (progress)
-      result += `: ${progress}`;
+    result += `还在进行中，请耐心等待。需查询具体进度可调用 task_get / task_operation_list 等工具`;
     if (message)
       result += ` - ${message}`;
     return result;
@@ -9255,8 +9252,16 @@ class InputHandler {
   buffer = [];
   static USER_PROMPT = "❯ ";
   static CONTINUATION_PROMPT = "... ";
+  static filterControlChars(input) {
+    if (!input)
+      return "";
+    return input.replace(/[\x00-\x08\x0b\x0c\x0e-\x1f\x7f]/g, "");
+  }
   pushLine(line) {
-    this.buffer.push(line);
+    if (line == null) {
+      return;
+    }
+    this.buffer.push(InputHandler.filterControlChars(line));
   }
   getBuffer() {
     return this.buffer.join(`
@@ -9341,6 +9346,7 @@ class REPL {
   isShuttingDown = false;
   env = null;
   inputHandler;
+  keypressHandler;
   constructor(options, env) {
     this.options = options;
     this.env = env ?? null;
@@ -9361,6 +9367,17 @@ class REPL {
       return;
     }
     this.isShuttingDown = true;
+    if (process.stdin.isTTY) {
+      try {
+        process.stdin.setRawMode?.(false);
+      } catch {}
+    }
+    if (this.keypressHandler) {
+      try {
+        process.stdin.removeListener("keypress", this.keypressHandler);
+      } catch {}
+      this.keypressHandler = undefined;
+    }
     this.rl.close();
     await this.options.onShutdown();
   }
@@ -9428,7 +9445,9 @@ ${COLORS.system("[没有正在执行的请求]")}`);
     if (process.stdin.isTTY) {
       process.stdin.setRawMode?.(true);
     }
-    process.stdin.on("keypress", (str, key) => {
+    this.keypressHandler = (str, key) => {
+      if (this.isShuttingDown)
+        return;
       if (key.meta && key.name === "return") {
         readline2.moveCursor(process.stdout, 0, -1);
         readline2.clearLine(process.stdout, 0);
@@ -9438,7 +9457,8 @@ ${COLORS.system("[没有正在执行的请求]")}`);
       if (key.name === "escape") {
         this.handleEscKey();
       }
-    });
+    };
+    process.stdin.on("keypress", this.keypressHandler);
     return new Promise((resolve) => {
       this.rl.on("line", async (line) => {
         await this.handleLine(line.trim());
@@ -9452,6 +9472,9 @@ ${COLORS.system("[没有正在执行的请求]")}`);
     });
   }
   async handleLine(line) {
+    if (this.isShuttingDown) {
+      return;
+    }
     if (line.startsWith("/") && this.inputHandler.getBuffer() === "") {
       await this.handleCommand(line.slice(1));
       this.inputHandler.reset();
@@ -17002,7 +17025,7 @@ var WorkflowListCommand = {
   describe: "列出所有已注册的 Workflow",
   builder: (yargs) => yargs.option("tag", {
     alias: "t",
-    describe: "按标签筛选",
+    describe: "按标签筛选（可多次 --tag ai --tag cli 表示 AND）",
     type: "string"
   }).option("task-id", {
     alias: "i",
@@ -17022,6 +17045,27 @@ var WorkflowListCommand = {
     describe: "分页偏移",
     type: "number",
     default: 0
+  }).option("page", {
+    describe: "页码（1-based，与 --page-size 配合；与 --offset 互斥）",
+    type: "number",
+    default: 1
+  }).option("page-size", {
+    describe: "每页大小（与 --page 配合；等价于 --limit）",
+    type: "number"
+  }).check((argv) => {
+    if (typeof argv.page === "number" && argv.page < 1) {
+      throw new Error("--page must be >= 1");
+    }
+    if (typeof argv.pageSize === "number" && argv.pageSize < 1) {
+      throw new Error("--page-size must be >= 1");
+    }
+    if (typeof argv.limit === "number" && argv.limit < 1) {
+      throw new Error("--limit must be >= 1");
+    }
+    if (typeof argv.offset === "number" && argv.offset < 0) {
+      throw new Error("--offset must be >= 0");
+    }
+    return true;
   }).option("json", {
     alias: "j",
     describe: "JSON 格式输出",
@@ -17056,12 +17100,20 @@ var WorkflowListCommand = {
         output.error('WorkflowService not initialized. Please run "roy-agent workflow init" first.');
         process.exit(1);
       }
+      const tagsArg = args.tag;
+      const tagsList = Array.isArray(tagsArg) ? tagsArg : tagsArg ? [tagsArg] : [];
+      const pageSize = typeof args.pageSize === "number" ? args.pageSize : typeof args.limit === "number" ? args.limit : 50;
+      const page = typeof args.page === "number" ? args.page : 1;
+      const effectiveOffset = (page - 1) * pageSize;
+      const userOffset = typeof args.offset === "number" ? args.offset : 0;
+      const finalOffset = page > 1 ? effectiveOffset : userOffset;
       const tool = createWorkflowListTool(service);
       const result = await tool.execute({
-        tag: args.tag,
-        search: args.search,
-        limit: args.limit,
-        offset: args.offset
+        tag: tagsList.length === 1 ? tagsList[0] : undefined,
+        tags: tagsList.length > 1 ? tagsList : undefined,
+        search: args.search !== undefined && typeof args.search === "string" ? args.search : undefined,
+        limit: pageSize,
+        offset: finalOffset
       }, {});
       if (!result.success) {
         output.error(result.error || "Failed to list workflows");
@@ -17069,6 +17121,8 @@ var WorkflowListCommand = {
       }
       const data = JSON.parse(result.output);
       const workflows = data.workflows || [];
+      const availableTags = data.available_tags || [];
+      const total = typeof data.total === "number" ? data.total : workflows.length;
       if (args.json) {
         output.json({
           workflows: workflows.map((w) => ({
@@ -17079,7 +17133,12 @@ var WorkflowListCommand = {
             createdAt: w.created_at,
             updatedAt: w.created_at
           })),
-          total: data.total || workflows.length
+          available_tags: availableTags,
+          total,
+          count: workflows.length,
+          limit: pageSize,
+          offset: finalOffset,
+          page: page > 1 ? page : Math.floor(finalOffset / pageSize) + 1
         });
       } else {
         const renderWorkflows = workflows.map((w) => ({
@@ -17094,8 +17153,25 @@ var WorkflowListCommand = {
           metadata: {}
         }));
         output.log(renderWorkflowList(renderWorkflows));
-        output.log(chalk61.green(`
-✅ 共 ${workflows.length} 个 Workflow`));
+        if (total > workflows.length) {
+          const start = finalOffset + 1;
+          const end = finalOffset + workflows.length;
+          output.log(chalk61.green(`
+✅ 显示 ${start}-${end} / 共 ${total} 个 Workflow`));
+          const totalPages = Math.ceil(total / pageSize);
+          const currentPage = Math.floor(finalOffset / pageSize) + 1;
+          if (totalPages > 1) {
+            output.log(chalk61.cyan(`\uD83D\uDCC4 第 ${currentPage} / ${totalPages} 页`));
+          }
+        } else {
+          output.log(chalk61.green(`
+✅ 共 ${total} 个 Workflow`));
+        }
+        if (availableTags.length > 0) {
+          const tagsLine = availableTags.map((t) => `${t.name}(${t.count})`).join(", ");
+          output.log(chalk61.cyan(`
+\uD83C\uDFF7️  Available tags: ${tagsLine}`));
+        }
       }
     } catch (error) {
       output.error(`Failed to list workflows: ${error}`);
@@ -17763,8 +17839,9 @@ var WorkflowAddCommand = {
     type: "string"
   }).option("tags", {
     alias: "t",
-    describe: "标签（逗号分隔）",
-    type: "string"
+    describe: 'Tags (1-3 required). Select from existing tag pool when possible. Run "roy-agent workflow tag list" first to see available tags. Supports both --tags "a,b,c" and --tags a --tags b --tags c forms.',
+    type: "array",
+    string: true
   }).option("task-id", {
     alias: "i",
     describe: "关联任务 ID",
@@ -17791,6 +17868,29 @@ var WorkflowAddCommand = {
     const output = new OutputService;
     const envService = new EnvironmentService(output);
     try {
+      let parseTags = function(input) {
+        if (input === undefined || input === null)
+          return;
+        const list = [];
+        if (Array.isArray(input)) {
+          for (const item of input) {
+            if (typeof item === "string") {
+              for (const t of item.split(",")) {
+                const trimmed = t.trim();
+                if (trimmed)
+                  list.push(trimmed);
+              }
+            }
+          }
+        } else if (typeof input === "string") {
+          for (const t of input.split(",")) {
+            const trimmed = t.trim();
+            if (trimmed)
+              list.push(trimmed);
+          }
+        }
+        return list.length > 0 ? list : undefined;
+      };
       await envService.create({ configPath: a.config });
       const env = envService.getEnvironment();
       if (!env) {
@@ -17902,7 +18002,19 @@ Agent output:
         output.error('Usage: roy-agent workflow add --file <path> | --desc "<description>"');
         process.exit(1);
       }
-      const tags = a.tags ? a.tags.split(",").map((t) => t.trim()) : undefined;
+      const tags = parseTags(a.tags);
+      if (!tags || tags.length === 0) {
+        output.error("❌ --tags is required.");
+        output.error('   Please provide 1-3 tags using --tags "tag1,tag2,tag3"');
+        output.error('   Example: roy-agent workflow add --file my.yaml --tags "ai,ml,etl"');
+        process.exit(1);
+      }
+      if (tags.length > 3) {
+        output.error(`❌ Too many tags: received ${tags.length}, maximum is 3.`);
+        output.error('   Please reduce to 1-3 tags using --tags "tag1,tag2,tag3"');
+        output.error('   Example: roy-agent workflow add --file my.yaml --tags "ai,ml,etl"');
+        process.exit(1);
+      }
       const workflow = await service.createWorkflow(definition, {
         tags,
         taskId: a.taskId,
@@ -19140,11 +19252,412 @@ Error: ${error.message}`));
   }
 };
 
+// src/commands/workflow/commands/search.ts
+import chalk71 from "chalk";
+import { wrapFunction as wrapFunction3 } from "@ai-setting/roy-agent-core";
+var WorkflowSearchCommand = {
+  command: "search",
+  describe: "Search workflows by keyword and/or tags (multiple tags use AND filter). v2: returns available_tags.",
+  builder: (yargs) => yargs.option("keyword", {
+    alias: "k",
+    describe: "Search keyword in name and description",
+    type: "string"
+  }).option("tag", {
+    alias: "t",
+    describe: "Filter by tag (can be specified multiple times for AND filter)",
+    type: "array",
+    string: true
+  }).option("limit", {
+    alias: "l",
+    describe: "Maximum number of results",
+    type: "number",
+    default: 50
+  }).option("offset", {
+    alias: "o",
+    describe: "Pagination offset",
+    type: "number",
+    default: 0
+  }).option("json", {
+    alias: "j",
+    describe: "Output as JSON",
+    type: "boolean",
+    default: false
+  }).option("yaml", {
+    alias: "y",
+    describe: "Output as YAML",
+    type: "boolean",
+    default: false
+  }).option("config", {
+    describe: "Config file path",
+    type: "string"
+  }).check((argv) => {
+    const hasKeyword = typeof argv.keyword === "string" && argv.keyword.length > 0;
+    const hasTags = Array.isArray(argv.tag) && argv.tag.length > 0;
+    if (!hasKeyword && !hasTags) {
+      throw new Error("At least one of --keyword or --tag must be provided");
+    }
+    if (Array.isArray(argv.tag)) {
+      for (const t of argv.tag) {
+        if (typeof t !== "string" || t.length === 0) {
+          throw new Error("Empty tag values are not allowed");
+        }
+        if (t.length > 50) {
+          throw new Error(`Tag "${t}" exceeds 50 characters`);
+        }
+        if (t.includes(",")) {
+          throw new Error(`Tag "${t}" contains comma; pass them as separate --tags`);
+        }
+      }
+    }
+    return true;
+  }),
+  async handler(args) {
+    const a = args;
+    const output = new OutputService;
+    const envService = new EnvironmentService(output);
+    try {
+      await runWorkflowSearch({
+        keyword: a.keyword,
+        tags: a.tag,
+        limit: a.limit,
+        offset: a.offset,
+        asJson: a.json,
+        asYaml: a.yaml,
+        configPath: a.config,
+        output,
+        envService
+      });
+    } catch (error) {
+      output.error(`Failed to search workflows: ${error}`);
+      process.exit(1);
+    } finally {
+      await envService.dispose();
+    }
+  }
+};
+var _runWorkflowSearchImpl = async function(opts) {
+  const { keyword, tags, limit, offset, asJson, asYaml, configPath, output, envService } = opts;
+  await envService.create({ configPath });
+  const env = envService.getEnvironment();
+  if (!env) {
+    output.error("Failed to create environment");
+    process.exit(1);
+  }
+  const workflowComponent = env.getComponent("workflow");
+  if (!workflowComponent) {
+    output.error("WorkflowComponent not available");
+    process.exit(1);
+  }
+  const service = workflowComponent.getService();
+  if (!service) {
+    output.error('WorkflowService not initialized. Please run "roy-agent workflow init" first.');
+    process.exit(1);
+  }
+  const useWithTags = typeof service.searchWorkflowsWithTags === "function";
+  const result = useWithTags ? await service.searchWorkflowsWithTags({
+    keyword,
+    tags,
+    limit,
+    offset
+  }) : {
+    workflows: service.searchWorkflows({ keyword, tags, limit, offset }),
+    available_tags: []
+  };
+  const workflows = result.workflows ?? [];
+  const availableTags = result.available_tags ?? [];
+  if (asJson) {
+    output.json({
+      workflows: workflows.map((w) => ({
+        name: w.name,
+        version: w.version,
+        description: w.description,
+        tags: w.tags,
+        createdAt: w.createdAt,
+        updatedAt: w.updatedAt
+      })),
+      available_tags: availableTags,
+      total: workflows.length,
+      keyword,
+      tags
+    });
+    return;
+  }
+  if (asYaml) {
+    const yaml = await Promise.resolve().then(() => __toESM(require_dist(), 1));
+    output.log(yaml.stringify({
+      workflows: workflows.map((w) => ({
+        name: w.name,
+        version: w.version,
+        description: w.description,
+        tags: w.tags
+      })),
+      available_tags: availableTags,
+      total: workflows.length,
+      keyword,
+      tags
+    }));
+    return;
+  }
+  const renderWorkflows = workflows.map((w) => ({
+    id: w.name,
+    name: w.name,
+    version: w.version,
+    description: w.description,
+    tags: w.tags || [],
+    createdAt: w.createdAt ? new Date(w.createdAt) : new Date,
+    updatedAt: w.updatedAt ? new Date(w.updatedAt) : new Date,
+    definition: { nodes: [], config: {}, inputs: {} },
+    metadata: {}
+  }));
+  if (renderWorkflows.length === 0) {
+    output.log(chalk71.yellow("\uD83D\uDD0D No workflows matched the search criteria."));
+    output.log(chalk71.gray(`   keyword: ${keyword || "(none)"}`));
+    output.log(chalk71.gray(`   tags: ${tags && tags.length > 0 ? tags.join(", ") : "(none)"}`));
+  } else {
+    output.log(chalk71.bold(`\uD83D\uDD0D Search results (${renderWorkflows.length}):`));
+    output.log(renderWorkflowList(renderWorkflows));
+    output.log(chalk71.green(`
+✅ Found ${renderWorkflows.length} workflow(s)`));
+  }
+  if (availableTags.length > 0) {
+    output.log("");
+    output.log(chalk71.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(chalk71.gray(`   - ${name} (${count})`));
+    }
+  }
+};
+var runWorkflowSearch = wrapFunction3(_runWorkflowSearchImpl, "workflow.cli.search", {
+  recordParams: true,
+  recordResult: false,
+  log: false
+});
+
+// src/commands/workflow/commands/tag.ts
+import { wrapFunction as wrapFunction4 } from "@ai-setting/roy-agent-core";
+import chalk72 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.",
+  builder: (yargs) => yargs.option("sort-by", {
+    describe: "Sort field",
+    choices: ["usage_count", "name", "created_at"],
+    default: "usage_count"
+  }).option("order", {
+    describe: "Sort order",
+    choices: ["asc", "desc"],
+    default: "desc"
+  }).option("limit", {
+    describe: "Max number of tags to return",
+    type: "number",
+    default: 100
+  }).option("json", {
+    alias: "j",
+    describe: "Output as JSON",
+    type: "boolean",
+    default: false
+  }).option("config", {
+    describe: "Config file path",
+    type: "string"
+  }),
+  async handler(args) {
+    const a = args;
+    const output = new OutputService;
+    const envService = new EnvironmentService(output);
+    try {
+      await runWorkflowTagList({
+        sortBy: a.sortBy,
+        order: a.order,
+        limit: a.limit,
+        asJson: a.json,
+        configPath: a.config,
+        output,
+        envService
+      });
+    } catch (error) {
+      output.error(`Failed to list workflow tags: ${error}`);
+      process.exit(1);
+    } finally {
+      await envService.dispose();
+    }
+  }
+};
+var WorkflowTagGetCommand = {
+  command: "get <name>",
+  describe: "Get details of a single workflow tag (usage_count, created_at, updated_at). Returns error if tag not in the workflow_tags table.",
+  builder: (yargs) => yargs.positional("name", {
+    describe: "Tag name",
+    type: "string"
+  }).option("json", {
+    alias: "j",
+    describe: "Output as JSON",
+    type: "boolean",
+    default: false
+  }).option("config", {
+    describe: "Config file path",
+    type: "string"
+  }).check((argv) => {
+    if (typeof argv.name !== "string" || argv.name.length === 0) {
+      throw new Error("Tag name is required");
+    }
+    if (argv.name.length > 50) {
+      throw new Error(`Tag name exceeds 50 characters`);
+    }
+    return true;
+  }),
+  async handler(args) {
+    const a = args;
+    const output = new OutputService;
+    const envService = new EnvironmentService(output);
+    try {
+      await runWorkflowTagGet({
+        name: a.name,
+        asJson: a.json,
+        configPath: a.config,
+        output,
+        envService
+      });
+    } catch (error) {
+      output.error(`Failed to get tag: ${error}`);
+      process.exit(1);
+    } finally {
+      await envService.dispose();
+    }
+  }
+};
+var _runWorkflowTagListImpl = async function(opts) {
+  const { output, envService } = opts;
+  await envService.create({ configPath: opts.configPath });
+  const env = envService.getEnvironment();
+  if (!env) {
+    output.error("Failed to create environment");
+    process.exit(1);
+  }
+  const workflowComponent = env.getComponent("workflow");
+  if (!workflowComponent) {
+    output.error("WorkflowComponent not available");
+    process.exit(1);
+  }
+  const service = workflowComponent.getService();
+  if (!service) {
+    output.error('WorkflowService not initialized. Please run "roy-agent workflow init" first.');
+    process.exit(1);
+  }
+  const result = await callListTags(service, {
+    sortBy: opts.sortBy ?? "usage_count",
+    order: opts.order ?? "desc",
+    limit: opts.limit ?? 100
+  });
+  if (opts.asJson) {
+    output.json({
+      tags: result.tags,
+      total: result.total
+    });
+    return;
+  }
+  if (result.tags.length === 0) {
+    output.log(chalk72.yellow("\uD83C\uDFF7️  No tags in the workflow_tags table yet."));
+    output.log(chalk72.gray("   Tags are created automatically when you run `workflow add --tags <name>`."));
+    return;
+  }
+  output.log(chalk72.bold(`\uD83C\uDFF7️  Workflow tags (${result.total}):`));
+  output.log(chalk72.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(chalk72.gray(`
+\uD83D\uDCA1 Tip: when adding a new workflow, prefer tags from this list to ensure semantic consistency.`));
+};
+var _runWorkflowTagGetImpl = async function(opts) {
+  const { output, envService } = opts;
+  await envService.create({ configPath: opts.configPath });
+  const env = envService.getEnvironment();
+  if (!env) {
+    output.error("Failed to create environment");
+    process.exit(1);
+  }
+  const workflowComponent = env.getComponent("workflow");
+  if (!workflowComponent) {
+    output.error("WorkflowComponent not available");
+    process.exit(1);
+  }
+  const service = workflowComponent.getService();
+  if (!service) {
+    output.error('WorkflowService not initialized. Please run "roy-agent workflow init" first.');
+    process.exit(1);
+  }
+  const tag = callGetTag(service, opts.name);
+  if (!tag) {
+    if (opts.asJson) {
+      output.json({ error: "Tag not found", name: opts.name });
+    } else {
+      output.error(`Tag "${opts.name}" not found in the workflow_tags table.`);
+      output.log(chalk72.gray(`Tip: run \`roy-agent workflow tag list\` to see available tags.`));
+    }
+    process.exitCode = 1;
+    return;
+  }
+  if (opts.asJson) {
+    output.json(tag);
+    return;
+  }
+  output.log(chalk72.bold(`\uD83C\uDFF7️  Tag: ${tag.name}`));
+  output.log(chalk72.gray(`   usage_count: ${tag.usage_count}`));
+  output.log(chalk72.gray(`   created_at:  ${tag.created_at}`));
+  output.log(chalk72.gray(`   updated_at:  ${tag.updated_at}`));
+};
+async function callListTags(service, options) {
+  if (typeof service.listTags !== "function") {
+    return { tags: [], total: 0 };
+  }
+  return await service.listTags(options);
+}
+function callGetTag(service, name) {
+  if (typeof service.getTag !== "function") {
+    return;
+  }
+  return service.getTag(name);
+}
+function padRight(str, width) {
+  if (str.length >= width)
+    return str.slice(0, width - 1) + " ";
+  return str + " ".repeat(width - str.length);
+}
+function formatDate2(iso) {
+  try {
+    const d = new Date(iso);
+    if (isNaN(d.getTime()))
+      return iso;
+    return d.toISOString().replace("T", " ").slice(0, 19);
+  } catch {
+    return iso;
+  }
+}
+var runWorkflowTagList = wrapFunction4(_runWorkflowTagListImpl, "workflow.cli.tag.list", {
+  recordParams: true,
+  recordResult: false,
+  log: false
+});
+var runWorkflowTagGet = wrapFunction4(_runWorkflowTagGetImpl, "workflow.cli.tag.get", {
+  recordParams: true,
+  recordResult: false,
+  log: false
+});
+
 // src/commands/workflow/index.ts
+var WorkflowTagCommand = {
+  command: "tag",
+  describe: "Manage workflow tags — list and get from the workflow_tags table. Use BEFORE `workflow add` to discover existing tags.",
+  builder: (yargs) => yargs.command(WorkflowTagListCommand).command(WorkflowTagGetCommand).demandCommand(1, "请指定 tag 子命令：list 或 get <name>").help(),
+  handler() {}
+};
 var WorkflowCommand = {
   command: "workflow",
   describe: "Workflow DAG management and execution - create, run, and monitor workflows",
-  builder: (yargs) => yargs.command(WorkflowListCommand).command(WorkflowAddCommand).command(WorkflowNodesCommand).command(WorkflowValidateCommand).command(WorkflowGetCommand).command(WorkflowUpdateCommand).command(WorkflowRemoveCommand).command(WorkflowRunCommand).command(WorkflowStopCommand).command(WorkflowStatusCommand).demandCommand(1, "请指定子命令：list、add、validate、nodes、get、update、remove、run、stop、status\n\nResume: 使用 `workflow run -s <sessionId>` 恢复暂停的工作流").help(),
+  builder: (yargs) => yargs.command(WorkflowListCommand).command(WorkflowAddCommand).command(WorkflowSearchCommand).command(WorkflowTagCommand).command(WorkflowNodesCommand).command(WorkflowValidateCommand).command(WorkflowGetCommand).command(WorkflowUpdateCommand).command(WorkflowRemoveCommand).command(WorkflowRunCommand).command(WorkflowStopCommand).command(WorkflowStatusCommand).demandCommand(1, "请指定子命令：list、add、search、tag、validate、nodes、get、update、remove、run、stop、status\n\nResume: 使用 `workflow run -s <sessionId>` 恢复暂停的工作流").help(),
   handler() {}
 };
 

package/dist/index.js

@@ -7319,7 +7319,7 @@ var require_dist = __commonJS((exports) => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "@ai-setting/roy-agent-cli",
-    version: "1.5.84",
+    version: "1.5.86",
     type: "module",
     description: "CLI for roy-agent - Non-interactive command execution",
     main: "./dist/index.js",
@@ -8999,16 +8999,13 @@ class EventMessageFormatter {
   }
   formatTaskProgress(payload) {
     const desc = payload.description || "未命名任务";
-    const progress = payload.progress !== undefined ? `${payload.progress}%` : "";
     const message = payload.progressMessage || "";
     const taskId = payload.associatedTaskId;
     let result = `${this.prefix} \uD83D\uDD04 后台任务「${desc}」`;
     if (taskId !== undefined) {
       result += `[Task #${taskId}] `;
     }
-    result += `进度更新`;
-    if (progress)
-      result += `: ${progress}`;
+    result += `还在进行中，请耐心等待。需查询具体进度可调用 task_get / task_operation_list 等工具`;
     if (message)
       result += ` - ${message}`;
     return result;
@@ -9254,8 +9251,16 @@ class InputHandler {
   buffer = [];
   static USER_PROMPT = "❯ ";
   static CONTINUATION_PROMPT = "... ";
+  static filterControlChars(input) {
+    if (!input)
+      return "";
+    return input.replace(/[\x00-\x08\x0b\x0c\x0e-\x1f\x7f]/g, "");
+  }
   pushLine(line) {
-    this.buffer.push(line);
+    if (line == null) {
+      return;
+    }
+    this.buffer.push(InputHandler.filterControlChars(line));
   }
   getBuffer() {
     return this.buffer.join(`
@@ -9340,6 +9345,7 @@ class REPL {
   isShuttingDown = false;
   env = null;
   inputHandler;
+  keypressHandler;
   constructor(options, env) {
     this.options = options;
     this.env = env ?? null;
@@ -9360,6 +9366,17 @@ class REPL {
       return;
     }
     this.isShuttingDown = true;
+    if (process.stdin.isTTY) {
+      try {
+        process.stdin.setRawMode?.(false);
+      } catch {}
+    }
+    if (this.keypressHandler) {
+      try {
+        process.stdin.removeListener("keypress", this.keypressHandler);
+      } catch {}
+      this.keypressHandler = undefined;
+    }
     this.rl.close();
     await this.options.onShutdown();
   }
@@ -9427,7 +9444,9 @@ ${COLORS.system("[没有正在执行的请求]")}`);
     if (process.stdin.isTTY) {
       process.stdin.setRawMode?.(true);
     }
-    process.stdin.on("keypress", (str, key) => {
+    this.keypressHandler = (str, key) => {
+      if (this.isShuttingDown)
+        return;
       if (key.meta && key.name === "return") {
         readline2.moveCursor(process.stdout, 0, -1);
         readline2.clearLine(process.stdout, 0);
@@ -9437,7 +9456,8 @@ ${COLORS.system("[没有正在执行的请求]")}`);
       if (key.name === "escape") {
         this.handleEscKey();
       }
-    });
+    };
+    process.stdin.on("keypress", this.keypressHandler);
     return new Promise((resolve) => {
       this.rl.on("line", async (line) => {
         await this.handleLine(line.trim());
@@ -9451,6 +9471,9 @@ ${COLORS.system("[没有正在执行的请求]")}`);
     });
   }
   async handleLine(line) {
+    if (this.isShuttingDown) {
+      return;
+    }
     if (line.startsWith("/") && this.inputHandler.getBuffer() === "") {
       await this.handleCommand(line.slice(1));
       this.inputHandler.reset();
@@ -17001,7 +17024,7 @@ var WorkflowListCommand = {
   describe: "列出所有已注册的 Workflow",
   builder: (yargs) => yargs.option("tag", {
     alias: "t",
-    describe: "按标签筛选",
+    describe: "按标签筛选（可多次 --tag ai --tag cli 表示 AND）",
     type: "string"
   }).option("task-id", {
     alias: "i",
@@ -17021,6 +17044,27 @@ var WorkflowListCommand = {
     describe: "分页偏移",
     type: "number",
     default: 0
+  }).option("page", {
+    describe: "页码（1-based，与 --page-size 配合；与 --offset 互斥）",
+    type: "number",
+    default: 1
+  }).option("page-size", {
+    describe: "每页大小（与 --page 配合；等价于 --limit）",
+    type: "number"
+  }).check((argv) => {
+    if (typeof argv.page === "number" && argv.page < 1) {
+      throw new Error("--page must be >= 1");
+    }
+    if (typeof argv.pageSize === "number" && argv.pageSize < 1) {
+      throw new Error("--page-size must be >= 1");
+    }
+    if (typeof argv.limit === "number" && argv.limit < 1) {
+      throw new Error("--limit must be >= 1");
+    }
+    if (typeof argv.offset === "number" && argv.offset < 0) {
+      throw new Error("--offset must be >= 0");
+    }
+    return true;
   }).option("json", {
     alias: "j",
     describe: "JSON 格式输出",
@@ -17055,12 +17099,20 @@ var WorkflowListCommand = {
         output.error('WorkflowService not initialized. Please run "roy-agent workflow init" first.');
         process.exit(1);
       }
+      const tagsArg = args.tag;
+      const tagsList = Array.isArray(tagsArg) ? tagsArg : tagsArg ? [tagsArg] : [];
+      const pageSize = typeof args.pageSize === "number" ? args.pageSize : typeof args.limit === "number" ? args.limit : 50;
+      const page = typeof args.page === "number" ? args.page : 1;
+      const effectiveOffset = (page - 1) * pageSize;
+      const userOffset = typeof args.offset === "number" ? args.offset : 0;
+      const finalOffset = page > 1 ? effectiveOffset : userOffset;
       const tool = createWorkflowListTool(service);
       const result = await tool.execute({
-        tag: args.tag,
-        search: args.search,
-        limit: args.limit,
-        offset: args.offset
+        tag: tagsList.length === 1 ? tagsList[0] : undefined,
+        tags: tagsList.length > 1 ? tagsList : undefined,
+        search: args.search !== undefined && typeof args.search === "string" ? args.search : undefined,
+        limit: pageSize,
+        offset: finalOffset
       }, {});
       if (!result.success) {
         output.error(result.error || "Failed to list workflows");
@@ -17068,6 +17120,8 @@ var WorkflowListCommand = {
       }
       const data = JSON.parse(result.output);
       const workflows = data.workflows || [];
+      const availableTags = data.available_tags || [];
+      const total = typeof data.total === "number" ? data.total : workflows.length;
       if (args.json) {
         output.json({
           workflows: workflows.map((w) => ({
@@ -17078,7 +17132,12 @@ var WorkflowListCommand = {
             createdAt: w.created_at,
             updatedAt: w.created_at
           })),
-          total: data.total || workflows.length
+          available_tags: availableTags,
+          total,
+          count: workflows.length,
+          limit: pageSize,
+          offset: finalOffset,
+          page: page > 1 ? page : Math.floor(finalOffset / pageSize) + 1
         });
       } else {
         const renderWorkflows = workflows.map((w) => ({
@@ -17093,8 +17152,25 @@ var WorkflowListCommand = {
           metadata: {}
         }));
         output.log(renderWorkflowList(renderWorkflows));
-        output.log(chalk61.green(`
-✅ 共 ${workflows.length} 个 Workflow`));
+        if (total > workflows.length) {
+          const start = finalOffset + 1;
+          const end = finalOffset + workflows.length;
+          output.log(chalk61.green(`
+✅ 显示 ${start}-${end} / 共 ${total} 个 Workflow`));
+          const totalPages = Math.ceil(total / pageSize);
+          const currentPage = Math.floor(finalOffset / pageSize) + 1;
+          if (totalPages > 1) {
+            output.log(chalk61.cyan(`\uD83D\uDCC4 第 ${currentPage} / ${totalPages} 页`));
+          }
+        } else {
+          output.log(chalk61.green(`
+✅ 共 ${total} 个 Workflow`));
+        }
+        if (availableTags.length > 0) {
+          const tagsLine = availableTags.map((t) => `${t.name}(${t.count})`).join(", ");
+          output.log(chalk61.cyan(`
+\uD83C\uDFF7️  Available tags: ${tagsLine}`));
+        }
       }
     } catch (error) {
       output.error(`Failed to list workflows: ${error}`);
@@ -17762,8 +17838,9 @@ var WorkflowAddCommand = {
     type: "string"
   }).option("tags", {
     alias: "t",
-    describe: "标签（逗号分隔）",
-    type: "string"
+    describe: 'Tags (1-3 required). Select from existing tag pool when possible. Run "roy-agent workflow tag list" first to see available tags. Supports both --tags "a,b,c" and --tags a --tags b --tags c forms.',
+    type: "array",
+    string: true
   }).option("task-id", {
     alias: "i",
     describe: "关联任务 ID",
@@ -17790,6 +17867,29 @@ var WorkflowAddCommand = {
     const output = new OutputService;
     const envService = new EnvironmentService(output);
     try {
+      let parseTags = function(input) {
+        if (input === undefined || input === null)
+          return;
+        const list = [];
+        if (Array.isArray(input)) {
+          for (const item of input) {
+            if (typeof item === "string") {
+              for (const t of item.split(",")) {
+                const trimmed = t.trim();
+                if (trimmed)
+                  list.push(trimmed);
+              }
+            }
+          }
+        } else if (typeof input === "string") {
+          for (const t of input.split(",")) {
+            const trimmed = t.trim();
+            if (trimmed)
+              list.push(trimmed);
+          }
+        }
+        return list.length > 0 ? list : undefined;
+      };
       await envService.create({ configPath: a.config });
       const env = envService.getEnvironment();
       if (!env) {
@@ -17901,7 +18001,19 @@ Agent output:
         output.error('Usage: roy-agent workflow add --file <path> | --desc "<description>"');
         process.exit(1);
       }
-      const tags = a.tags ? a.tags.split(",").map((t) => t.trim()) : undefined;
+      const tags = parseTags(a.tags);
+      if (!tags || tags.length === 0) {
+        output.error("❌ --tags is required.");
+        output.error('   Please provide 1-3 tags using --tags "tag1,tag2,tag3"');
+        output.error('   Example: roy-agent workflow add --file my.yaml --tags "ai,ml,etl"');
+        process.exit(1);
+      }
+      if (tags.length > 3) {
+        output.error(`❌ Too many tags: received ${tags.length}, maximum is 3.`);
+        output.error('   Please reduce to 1-3 tags using --tags "tag1,tag2,tag3"');
+        output.error('   Example: roy-agent workflow add --file my.yaml --tags "ai,ml,etl"');
+        process.exit(1);
+      }
       const workflow = await service.createWorkflow(definition, {
         tags,
         taskId: a.taskId,
@@ -19139,11 +19251,412 @@ Error: ${error.message}`));
   }
 };
 
+// src/commands/workflow/commands/search.ts
+import chalk71 from "chalk";
+import { wrapFunction as wrapFunction3 } from "@ai-setting/roy-agent-core";
+var WorkflowSearchCommand = {
+  command: "search",
+  describe: "Search workflows by keyword and/or tags (multiple tags use AND filter). v2: returns available_tags.",
+  builder: (yargs) => yargs.option("keyword", {
+    alias: "k",
+    describe: "Search keyword in name and description",
+    type: "string"
+  }).option("tag", {
+    alias: "t",
+    describe: "Filter by tag (can be specified multiple times for AND filter)",
+    type: "array",
+    string: true
+  }).option("limit", {
+    alias: "l",
+    describe: "Maximum number of results",
+    type: "number",
+    default: 50
+  }).option("offset", {
+    alias: "o",
+    describe: "Pagination offset",
+    type: "number",
+    default: 0
+  }).option("json", {
+    alias: "j",
+    describe: "Output as JSON",
+    type: "boolean",
+    default: false
+  }).option("yaml", {
+    alias: "y",
+    describe: "Output as YAML",
+    type: "boolean",
+    default: false
+  }).option("config", {
+    describe: "Config file path",
+    type: "string"
+  }).check((argv) => {
+    const hasKeyword = typeof argv.keyword === "string" && argv.keyword.length > 0;
+    const hasTags = Array.isArray(argv.tag) && argv.tag.length > 0;
+    if (!hasKeyword && !hasTags) {
+      throw new Error("At least one of --keyword or --tag must be provided");
+    }
+    if (Array.isArray(argv.tag)) {
+      for (const t of argv.tag) {
+        if (typeof t !== "string" || t.length === 0) {
+          throw new Error("Empty tag values are not allowed");
+        }
+        if (t.length > 50) {
+          throw new Error(`Tag "${t}" exceeds 50 characters`);
+        }
+        if (t.includes(",")) {
+          throw new Error(`Tag "${t}" contains comma; pass them as separate --tags`);
+        }
+      }
+    }
+    return true;
+  }),
+  async handler(args) {
+    const a = args;
+    const output = new OutputService;
+    const envService = new EnvironmentService(output);
+    try {
+      await runWorkflowSearch({
+        keyword: a.keyword,
+        tags: a.tag,
+        limit: a.limit,
+        offset: a.offset,
+        asJson: a.json,
+        asYaml: a.yaml,
+        configPath: a.config,
+        output,
+        envService
+      });
+    } catch (error) {
+      output.error(`Failed to search workflows: ${error}`);
+      process.exit(1);
+    } finally {
+      await envService.dispose();
+    }
+  }
+};
+var _runWorkflowSearchImpl = async function(opts) {
+  const { keyword, tags, limit, offset, asJson, asYaml, configPath, output, envService } = opts;
+  await envService.create({ configPath });
+  const env = envService.getEnvironment();
+  if (!env) {
+    output.error("Failed to create environment");
+    process.exit(1);
+  }
+  const workflowComponent = env.getComponent("workflow");
+  if (!workflowComponent) {
+    output.error("WorkflowComponent not available");
+    process.exit(1);
+  }
+  const service = workflowComponent.getService();
+  if (!service) {
+    output.error('WorkflowService not initialized. Please run "roy-agent workflow init" first.');
+    process.exit(1);
+  }
+  const useWithTags = typeof service.searchWorkflowsWithTags === "function";
+  const result = useWithTags ? await service.searchWorkflowsWithTags({
+    keyword,
+    tags,
+    limit,
+    offset
+  }) : {
+    workflows: service.searchWorkflows({ keyword, tags, limit, offset }),
+    available_tags: []
+  };
+  const workflows = result.workflows ?? [];
+  const availableTags = result.available_tags ?? [];
+  if (asJson) {
+    output.json({
+      workflows: workflows.map((w) => ({
+        name: w.name,
+        version: w.version,
+        description: w.description,
+        tags: w.tags,
+        createdAt: w.createdAt,
+        updatedAt: w.updatedAt
+      })),
+      available_tags: availableTags,
+      total: workflows.length,
+      keyword,
+      tags
+    });
+    return;
+  }
+  if (asYaml) {
+    const yaml = await Promise.resolve().then(() => __toESM(require_dist(), 1));
+    output.log(yaml.stringify({
+      workflows: workflows.map((w) => ({
+        name: w.name,
+        version: w.version,
+        description: w.description,
+        tags: w.tags
+      })),
+      available_tags: availableTags,
+      total: workflows.length,
+      keyword,
+      tags
+    }));
+    return;
+  }
+  const renderWorkflows = workflows.map((w) => ({
+    id: w.name,
+    name: w.name,
+    version: w.version,
+    description: w.description,
+    tags: w.tags || [],
+    createdAt: w.createdAt ? new Date(w.createdAt) : new Date,
+    updatedAt: w.updatedAt ? new Date(w.updatedAt) : new Date,
+    definition: { nodes: [], config: {}, inputs: {} },
+    metadata: {}
+  }));
+  if (renderWorkflows.length === 0) {
+    output.log(chalk71.yellow("\uD83D\uDD0D No workflows matched the search criteria."));
+    output.log(chalk71.gray(`   keyword: ${keyword || "(none)"}`));
+    output.log(chalk71.gray(`   tags: ${tags && tags.length > 0 ? tags.join(", ") : "(none)"}`));
+  } else {
+    output.log(chalk71.bold(`\uD83D\uDD0D Search results (${renderWorkflows.length}):`));
+    output.log(renderWorkflowList(renderWorkflows));
+    output.log(chalk71.green(`
+✅ Found ${renderWorkflows.length} workflow(s)`));
+  }
+  if (availableTags.length > 0) {
+    output.log("");
+    output.log(chalk71.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(chalk71.gray(`   - ${name} (${count})`));
+    }
+  }
+};
+var runWorkflowSearch = wrapFunction3(_runWorkflowSearchImpl, "workflow.cli.search", {
+  recordParams: true,
+  recordResult: false,
+  log: false
+});
+
+// src/commands/workflow/commands/tag.ts
+import { wrapFunction as wrapFunction4 } from "@ai-setting/roy-agent-core";
+import chalk72 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.",
+  builder: (yargs) => yargs.option("sort-by", {
+    describe: "Sort field",
+    choices: ["usage_count", "name", "created_at"],
+    default: "usage_count"
+  }).option("order", {
+    describe: "Sort order",
+    choices: ["asc", "desc"],
+    default: "desc"
+  }).option("limit", {
+    describe: "Max number of tags to return",
+    type: "number",
+    default: 100
+  }).option("json", {
+    alias: "j",
+    describe: "Output as JSON",
+    type: "boolean",
+    default: false
+  }).option("config", {
+    describe: "Config file path",
+    type: "string"
+  }),
+  async handler(args) {
+    const a = args;
+    const output = new OutputService;
+    const envService = new EnvironmentService(output);
+    try {
+      await runWorkflowTagList({
+        sortBy: a.sortBy,
+        order: a.order,
+        limit: a.limit,
+        asJson: a.json,
+        configPath: a.config,
+        output,
+        envService
+      });
+    } catch (error) {
+      output.error(`Failed to list workflow tags: ${error}`);
+      process.exit(1);
+    } finally {
+      await envService.dispose();
+    }
+  }
+};
+var WorkflowTagGetCommand = {
+  command: "get <name>",
+  describe: "Get details of a single workflow tag (usage_count, created_at, updated_at). Returns error if tag not in the workflow_tags table.",
+  builder: (yargs) => yargs.positional("name", {
+    describe: "Tag name",
+    type: "string"
+  }).option("json", {
+    alias: "j",
+    describe: "Output as JSON",
+    type: "boolean",
+    default: false
+  }).option("config", {
+    describe: "Config file path",
+    type: "string"
+  }).check((argv) => {
+    if (typeof argv.name !== "string" || argv.name.length === 0) {
+      throw new Error("Tag name is required");
+    }
+    if (argv.name.length > 50) {
+      throw new Error(`Tag name exceeds 50 characters`);
+    }
+    return true;
+  }),
+  async handler(args) {
+    const a = args;
+    const output = new OutputService;
+    const envService = new EnvironmentService(output);
+    try {
+      await runWorkflowTagGet({
+        name: a.name,
+        asJson: a.json,
+        configPath: a.config,
+        output,
+        envService
+      });
+    } catch (error) {
+      output.error(`Failed to get tag: ${error}`);
+      process.exit(1);
+    } finally {
+      await envService.dispose();
+    }
+  }
+};
+var _runWorkflowTagListImpl = async function(opts) {
+  const { output, envService } = opts;
+  await envService.create({ configPath: opts.configPath });
+  const env = envService.getEnvironment();
+  if (!env) {
+    output.error("Failed to create environment");
+    process.exit(1);
+  }
+  const workflowComponent = env.getComponent("workflow");
+  if (!workflowComponent) {
+    output.error("WorkflowComponent not available");
+    process.exit(1);
+  }
+  const service = workflowComponent.getService();
+  if (!service) {
+    output.error('WorkflowService not initialized. Please run "roy-agent workflow init" first.');
+    process.exit(1);
+  }
+  const result = await callListTags(service, {
+    sortBy: opts.sortBy ?? "usage_count",
+    order: opts.order ?? "desc",
+    limit: opts.limit ?? 100
+  });
+  if (opts.asJson) {
+    output.json({
+      tags: result.tags,
+      total: result.total
+    });
+    return;
+  }
+  if (result.tags.length === 0) {
+    output.log(chalk72.yellow("\uD83C\uDFF7️  No tags in the workflow_tags table yet."));
+    output.log(chalk72.gray("   Tags are created automatically when you run `workflow add --tags <name>`."));
+    return;
+  }
+  output.log(chalk72.bold(`\uD83C\uDFF7️  Workflow tags (${result.total}):`));
+  output.log(chalk72.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(chalk72.gray(`
+\uD83D\uDCA1 Tip: when adding a new workflow, prefer tags from this list to ensure semantic consistency.`));
+};
+var _runWorkflowTagGetImpl = async function(opts) {
+  const { output, envService } = opts;
+  await envService.create({ configPath: opts.configPath });
+  const env = envService.getEnvironment();
+  if (!env) {
+    output.error("Failed to create environment");
+    process.exit(1);
+  }
+  const workflowComponent = env.getComponent("workflow");
+  if (!workflowComponent) {
+    output.error("WorkflowComponent not available");
+    process.exit(1);
+  }
+  const service = workflowComponent.getService();
+  if (!service) {
+    output.error('WorkflowService not initialized. Please run "roy-agent workflow init" first.');
+    process.exit(1);
+  }
+  const tag = callGetTag(service, opts.name);
+  if (!tag) {
+    if (opts.asJson) {
+      output.json({ error: "Tag not found", name: opts.name });
+    } else {
+      output.error(`Tag "${opts.name}" not found in the workflow_tags table.`);
+      output.log(chalk72.gray(`Tip: run \`roy-agent workflow tag list\` to see available tags.`));
+    }
+    process.exitCode = 1;
+    return;
+  }
+  if (opts.asJson) {
+    output.json(tag);
+    return;
+  }
+  output.log(chalk72.bold(`\uD83C\uDFF7️  Tag: ${tag.name}`));
+  output.log(chalk72.gray(`   usage_count: ${tag.usage_count}`));
+  output.log(chalk72.gray(`   created_at:  ${tag.created_at}`));
+  output.log(chalk72.gray(`   updated_at:  ${tag.updated_at}`));
+};
+async function callListTags(service, options) {
+  if (typeof service.listTags !== "function") {
+    return { tags: [], total: 0 };
+  }
+  return await service.listTags(options);
+}
+function callGetTag(service, name) {
+  if (typeof service.getTag !== "function") {
+    return;
+  }
+  return service.getTag(name);
+}
+function padRight(str, width) {
+  if (str.length >= width)
+    return str.slice(0, width - 1) + " ";
+  return str + " ".repeat(width - str.length);
+}
+function formatDate2(iso) {
+  try {
+    const d = new Date(iso);
+    if (isNaN(d.getTime()))
+      return iso;
+    return d.toISOString().replace("T", " ").slice(0, 19);
+  } catch {
+    return iso;
+  }
+}
+var runWorkflowTagList = wrapFunction4(_runWorkflowTagListImpl, "workflow.cli.tag.list", {
+  recordParams: true,
+  recordResult: false,
+  log: false
+});
+var runWorkflowTagGet = wrapFunction4(_runWorkflowTagGetImpl, "workflow.cli.tag.get", {
+  recordParams: true,
+  recordResult: false,
+  log: false
+});
+
 // src/commands/workflow/index.ts
+var WorkflowTagCommand = {
+  command: "tag",
+  describe: "Manage workflow tags — list and get from the workflow_tags table. Use BEFORE `workflow add` to discover existing tags.",
+  builder: (yargs) => yargs.command(WorkflowTagListCommand).command(WorkflowTagGetCommand).demandCommand(1, "请指定 tag 子命令：list 或 get <name>").help(),
+  handler() {}
+};
 var WorkflowCommand = {
   command: "workflow",
   describe: "Workflow DAG management and execution - create, run, and monitor workflows",
-  builder: (yargs) => yargs.command(WorkflowListCommand).command(WorkflowAddCommand).command(WorkflowNodesCommand).command(WorkflowValidateCommand).command(WorkflowGetCommand).command(WorkflowUpdateCommand).command(WorkflowRemoveCommand).command(WorkflowRunCommand).command(WorkflowStopCommand).command(WorkflowStatusCommand).demandCommand(1, "请指定子命令：list、add、validate、nodes、get、update、remove、run、stop、status\n\nResume: 使用 `workflow run -s <sessionId>` 恢复暂停的工作流").help(),
+  builder: (yargs) => yargs.command(WorkflowListCommand).command(WorkflowAddCommand).command(WorkflowSearchCommand).command(WorkflowTagCommand).command(WorkflowNodesCommand).command(WorkflowValidateCommand).command(WorkflowGetCommand).command(WorkflowUpdateCommand).command(WorkflowRemoveCommand).command(WorkflowRunCommand).command(WorkflowStopCommand).command(WorkflowStatusCommand).demandCommand(1, "请指定子命令：list、add、search、tag、validate、nodes、get、update、remove、run、stop、status\n\nResume: 使用 `workflow run -s <sessionId>` 恢复暂停的工作流").help(),
   handler() {}
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-setting/roy-agent-cli",
-  "version": "1.5.84",
+  "version": "1.5.86",
   "type": "module",
   "description": "CLI for roy-agent - Non-interactive command execution",
   "main": "./dist/index.js",