@ai-setting/roy-agent-core 1.7.30 → 1.7.32

package/dist/shared/@ai-setting/roy-agent-core-9z6gcy77.js

@@ -0,0 +1,1520 @@
+import {
+  TaskHookPoints
+} from "./roy-agent-core-1pg0fepg.js";
+import {
+  WORKFLOW_EXTRACT_PROMPT
+} from "./roy-agent-core-skqt40yy.js";
+import {
+  validateWorkflowDefinition
+} from "./roy-agent-core-1df0grva.js";
+import {
+  enqueueToAddFakeUserMessage
+} from "./roy-agent-core-jbc1t62x.js";
+import {
+  BasePlugin
+} from "./roy-agent-core-az13yzmc.js";
+import {
+  init_context
+} from "./roy-agent-core-m2pxg5d8.js";
+import {
+  getEnvContextOrEmpty,
+  getEventFromEnvContext,
+  getLarkMessageId,
+  isLarkEvent
+} from "./roy-agent-core-7p6rny5m.js";
+import {
+  TracedAs,
+  init_decorator,
+  wrapFunction
+} from "./roy-agent-core-38rtrpk3.js";
+import {
+  createLogger,
+  init_logger
+} from "./roy-agent-core-e6dahpp2.js";
+import {
+  __legacyDecorateClassTS,
+  __require
+} from "./roy-agent-core-fs0mn2jk.js";
+
+// src/env/task/plugins/task-tag-plugin.ts
+init_logger();
+
+// src/env/task/plugins/workflow-extractor-agent.ts
+var WORKFLOW_EXTRACTOR_PROMPT = WORKFLOW_EXTRACT_PROMPT;
+function formatExtractorInput(params) {
+  const lines = [];
+  lines.push("# 任务信息");
+  lines.push(`- 标题: ${params.task.title}`);
+  if (params.task.description) {
+    lines.push(`- 描述: ${params.task.description}`);
+  }
+  if (params.task.goals_and_expected_deliverables) {
+    lines.push(`- 目标: ${params.task.goals_and_expected_deliverables}`);
+  }
+  lines.push("");
+  if (params.operations.length > 0) {
+    lines.push("# 操作记录");
+    for (const op of params.operations) {
+      lines.push(`- [${op.actionType}] ${op.actionTitle}`);
+      if (op.actionDescription) {
+        lines.push(`  ${op.actionDescription.slice(0, 200)}`);
+      }
+    }
+    lines.push("");
+  }
+  lines.push("# Session 消息历史");
+  lines.push("(以下是相关的对话历史，请从中提取 Workflow)");
+  for (const msg of params.messages.slice(-50)) {
+    const content = typeof msg.content === "string" ? msg.content : JSON.stringify(msg.content);
+    const truncated = content.slice(0, 500);
+    lines.push(`**${msg.role}**: ${truncated}${content.length > 500 ? "..." : ""}`);
+  }
+  lines.push("");
+  lines.push("## 任务");
+  lines.push("请分析以上信息，构建一个可复用的 Workflow。");
+  lines.push("使用迭代式流程：生成 YAML → validate 验证 → 修正错误 → 重复直到通过验证。");
+  return lines.join(`
+`);
+}
+function formatExtractorInputFromDescription(params) {
+  const lines = [];
+  lines.push("# Workflow 描述");
+  lines.push(params.description);
+  lines.push("");
+  lines.push("## 任务");
+  lines.push("请根据以上描述，构建一个可复用的 Workflow。");
+  lines.push("使用迭代式流程：生成 YAML → validate 验证 → 修正错误 → 重复直到通过验证。");
+  return lines.join(`
+`);
+}
+async function parseExtractorOutput(output) {
+  const yamlMatch = output.match(/```yaml\n?([\s\S]*?)\n?```/) || output.match(/```\n?([\s\S]*?)\n?```/) || output.match(/(\|[\s\S]*?)(?:\n\n|$)/);
+  const yamlContent = yamlMatch?.[1] || output;
+  try {
+    const YAML = await import("yaml");
+    const parsed = YAML.parse(yamlContent);
+    if (!parsed.name || !parsed.nodes || !Array.isArray(parsed.nodes)) {
+      return null;
+    }
+    if (parsed.nodes.length < 2) {
+      return null;
+    }
+    parsed.version = parsed.version || "1.0";
+    return parsed;
+  } catch {
+    return null;
+  }
+}
+
+// src/env/task/plugins/task-tag-plugin.ts
+var logger = createLogger("plugin:task-tag");
+
+class TaskTagPlugin extends BasePlugin {
+  name = "task-tag";
+  version = "1.0.0";
+  description = "Inject similar task information into delegate prompt and extract workflow on task completion";
+  env;
+  taskComponent = null;
+  agentComponent = null;
+  tagService = null;
+  constructor() {
+    super();
+  }
+  init(env) {
+    this.env = env;
+    this.taskComponent = env.getComponent("task");
+    if (this.taskComponent && typeof this.taskComponent.getTagService === "function") {
+      this.tagService = this.taskComponent.getTagService();
+    }
+    this.agentComponent = env.getComponent("agent");
+    env.registerHook({
+      point: TaskHookPoints.DELEGATE_BEFORE,
+      priority: 20,
+      handler: this.onDelegateBefore.bind(this)
+    });
+    env.registerHook({
+      point: TaskHookPoints.OPERATION_AFTER_CREATE,
+      priority: 10,
+      handler: this.onOperationAfterCreate.bind(this)
+    });
+    logger.info("[TaskTagPlugin] Initialized");
+  }
+  dispose() {
+    this.env = null;
+    this.taskComponent = null;
+    this.agentComponent = null;
+    this.tagService = null;
+    logger.info("[TaskTagPlugin] Disposed");
+  }
+  async onDelegateBefore(ctx) {
+    const data = ctx.data;
+    const { taskId, prompt } = data;
+    if (!taskId || !this.taskComponent) {
+      return;
+    }
+    try {
+      const currentTask = await this.taskComponent.getTask(taskId);
+      if (!currentTask)
+        return;
+      const keywords = this.extractKeywords(currentTask);
+      if (keywords.length === 0)
+        return;
+      const similarTasks = await this.tagService?.findSimilarTasksByKeywords?.(keywords, {
+        limit: 5,
+        excludeTaskId: taskId
+      }) ?? [];
+      if (similarTasks.length === 0)
+        return;
+      const hint = this.formatSimilarTasks(similarTasks);
+      data.prompt = `${hint}
+
+---
+
+## 用户指令
+
+${prompt}`;
+      logger.info(`[TaskTagPlugin] Injected ${similarTasks.length} similar tasks`);
+    } catch (error) {
+      logger.warn(`[TaskTagPlugin] Similar tasks injection failed: ${error}`);
+    }
+  }
+  extractKeywords(task) {
+    const keywords = [];
+    if (task.tags?.length) {
+      keywords.push(...task.tags);
+    }
+    if (task.title) {
+      const words = task.title.split(/[\s\-_,，。、#]+/).filter((w) => w.length > 2 && !/^\d+$/.test(w)).slice(0, 5);
+      keywords.push(...words);
+    }
+    return keywords;
+  }
+  formatSimilarTasks(tasks) {
+    const lines = [
+      "## \uD83D\uDD0D 类似任务参考",
+      "",
+      "_提示：可通过 `task_get <id>` 获取详情，`task_operation_list <id>` 获取操作记录_",
+      ""
+    ];
+    for (const task of tasks) {
+      lines.push(`### Task #${task.id}`);
+      lines.push(`**Title**: ${task.title}`);
+      if (task.description) {
+        const desc = task.description.slice(0, 100);
+        lines.push(`**Description**: ${desc}${task.description.length > 100 ? "..." : ""}`);
+      }
+      if (task.goals_and_expected_deliverables) {
+        const goal = task.goals_and_expected_deliverables.slice(0, 100);
+        lines.push(`**Goal**: ${goal}${task.goals_and_expected_deliverables.length > 100 ? "..." : ""}`);
+      }
+      lines.push("");
+    }
+    return lines.join(`
+`);
+  }
+  async onOperationAfterCreate(ctx) {
+    const data = ctx.data;
+    const operation = data?.operation ?? data?.data?.operation;
+    if (!operation || operation?.actionType !== "completed")
+      return;
+    await this.extractWorkflow(operation.taskId, operation.sessionId);
+  }
+  async extractWorkflow(taskId, sessionId) {
+    try {
+      const task = await this.taskComponent?.getTask(taskId);
+      if (!task)
+        return;
+      const operations = await this.taskComponent?.listOperations({ taskId }) ?? [];
+      const allSessionIds = [...new Set([sessionId, ...operations.map((op) => op.sessionId).filter(Boolean)])];
+      const sessionComponent = this.env.getComponent("session");
+      const allMessages = [];
+      for (const sid of allSessionIds) {
+        try {
+          const ctx = await sessionComponent?.getContext(sid, { fullHistory: false, minUserMessages: 200 });
+          if (ctx?.messages)
+            allMessages.push(...ctx.messages);
+        } catch {}
+      }
+      if (!this.agentComponent)
+        return;
+      const input = formatExtractorInput({ task, operations, messages: allMessages });
+      const result = await this.agentComponent.run("workflow-extract", input);
+      const workflowDef = await parseExtractorOutput(result.finalText || "");
+      if (!workflowDef)
+        return;
+      const validation = this.validateWorkflowDefinition(workflowDef);
+      if (!validation.valid) {
+        logger.warn(`[TaskTagPlugin] Skipping workflow creation due to validation failure: ` + `${validation.errors.join("; ")}`);
+        await this.taskComponent?.createOperation({
+          taskId,
+          sessionId,
+          actionType: "workflow_extraction_failed",
+          actionTitle: `Workflow extraction failed validation: ${workflowDef.name}`,
+          actionDescription: validation.errors.join("; ")
+        });
+        return;
+      }
+      const workflowRepo = await this.getWorkflowRepository();
+      if (!workflowRepo)
+        return;
+      let version = workflowDef.version || "1.0";
+      const existingWf = workflowRepo.getByName(workflowDef.name);
+      if (existingWf) {
+        const parts = existingWf.version?.split(".") ?? ["1", "0"];
+        version = `${parts[0]}.${parseInt(parts[1] || "0") + 1}`;
+      }
+      const workflow = workflowRepo.create({
+        name: workflowDef.name,
+        version,
+        description: workflowDef.description,
+        definition: workflowDef,
+        config: workflowDef.config || {},
+        metadata: { author: "workflow-extract", created_at: new Date().toISOString() },
+        tags: [`task:${taskId}`]
+      });
+      await this.taskComponent?.createOperation({
+        taskId,
+        sessionId,
+        actionType: "workflow_extracted",
+        actionTitle: `Workflow extracted: ${workflow.name}`,
+        actionDescription: workflow.id
+      });
+      logger.info(`[TaskTagPlugin] Workflow extracted: ${workflow.id}`);
+    } catch (error) {
+      logger.warn(`[TaskTagPlugin] Workflow extraction failed: ${error}`);
+    }
+  }
+  validateWorkflowDefinition(workflowDef) {
+    return validateWorkflowDefinition(workflowDef);
+  }
+  _workflowRepo = null;
+  async getWorkflowRepository() {
+    const workflowComponent = this.env.getComponent("workflow");
+    if (workflowComponent?.workflowService?.workflowRepository) {
+      return workflowComponent.workflowService.workflowRepository;
+    }
+    if (!this._workflowRepo) {
+      try {
+        const sqlite = await import("./roy-agent-core-89zsa89z.js");
+        this.ensureDataDir();
+        const db = sqlite.getDatabase();
+        sqlite.initializeTables();
+        const { WorkflowRepository } = await import("./roy-agent-core-pz8jvvtn.js");
+        this._workflowRepo = new WorkflowRepository(db);
+        return this._workflowRepo;
+      } catch {
+        return null;
+      }
+    }
+    return this._workflowRepo;
+  }
+  ensureDataDir() {
+    const { join } = __require("path");
+    const dataDir = join(process.env.XDG_DATA_HOME || join(process.env.HOME || "", ".local/share"), "roy-agent");
+    __require("fs").mkdirSync(dataDir, { recursive: true });
+  }
+}
+// src/env/task/plugins/auto-task-plugin.ts
+init_logger();
+init_decorator();
+var logger2 = createLogger("AutoTaskPlugin");
+function createAutoTaskPlugin(config) {
+  const threshold = config?.threshold ?? 20;
+  const agentName = config?.agentName ?? "default";
+  let lastProcessedTraceId = "";
+  async function executeImpl(ctx) {
+    try {
+      logger2.info(`[AutoTaskPlugin:ENTER] agentName=${ctx.agent.name} iteration=${ctx.iteration} threshold=${threshold}`);
+      if (ctx.agent.name !== agentName)
+        return { continue: true };
+      if (ctx.iteration !== threshold)
+        return { continue: true };
+      const traceId = ctx.context?.traceId ?? ctx.context?.sessionId ?? "unknown";
+      if (traceId === lastProcessedTraceId) {
+        logger2.debug(`[AutoTaskPlugin] skip - traceId=${traceId.slice(0, 20)}... already processed`);
+        return { continue: true };
+      }
+      lastProcessedTraceId = traceId;
+      logger2.debug(`[AutoTaskPlugin] new query detected (traceId=${traceId.slice(0, 20)}...)`);
+      const reminderContent = `⚠️ **系统提醒**: 你已经调用了 ${ctx.iteration} 次工具，达到 iteration 阈值（默认 ${threshold}）。
+` + `当前请求较为复杂，建议通过 \`delegate_task\` 工具将整个任务委托给 \`roy\` sub-agent 处理。` + `注意，需要让roy为这个任务调用task create工具来创建任务进行跟踪，这个是必走程序哈。`;
+      if (!ctx.toolResult) {
+        logger2.warn(`[AutoTaskPlugin] toolResult missing, skip meta-protocol (iteration=${ctx.iteration})`);
+        return { continue: true };
+      }
+      enqueueToAddFakeUserMessage(ctx.toolResult, {
+        role: "user",
+        content: reminderContent
+      }, "delegate");
+      logger2.info(`[AutoTaskPlugin] user reminder meta-protocol set (session=${(ctx.context?.sessionId ?? "unknown").slice(0, 12)}..., iteration=${ctx.iteration})`);
+      return { continue: true };
+    } catch (err) {
+      logger2.error(`[AutoTaskPlugin] hook failed: ${err instanceof Error ? err.message : String(err)}`);
+      return { continue: true };
+    }
+  }
+  const execute = wrapFunction(executeImpl, "plugin.auto-task.launch-agent", {
+    recordParams: false,
+    recordResult: true,
+    log: true
+  });
+  return {
+    name: "AutoTaskPlugin",
+    version: "5.2.0",
+    description: "ReAct iteration 达到阈值时通过共享 meta-protocol helper 注入 user 消息（与 MaxIterReminder 共用字段、确定性合并）",
+    hooks: [
+      { point: "agent:after.tool", priority: 50 }
+    ],
+    execute
+  };
+}
+// src/env/task/plugins/lark-cli-task-notify-plugin.ts
+init_decorator();
+init_logger();
+init_context();
+import { spawn } from "child_process";
+var logger3 = createLogger("lark-cli:task-notify");
+function isTaskNotifyDebugEnabled() {
+  return process.env.ROY_TASK_NOTIFY_DEBUG === "1" || process.env.ROY_TRACE_DEBUG === "1";
+}
+function extractLarkFields(env) {
+  const event = getEventFromEnvContext(env);
+  if (!isLarkEvent(event)) {
+    return { isLark: false };
+  }
+  return {
+    isLark: true,
+    source: event.source,
+    messageId: getLarkMessageId(event) ?? env.replyChannel?.messageId,
+    chatId: env.replyChannel?.chatId,
+    userId: env.replyChannel?.userId
+  };
+}
+var NotifyType;
+((NotifyType2) => {
+  NotifyType2["TASK_CREATED"] = "task_created";
+  NotifyType2["TASK_COMPLETED"] = "task_completed";
+  NotifyType2["TASK_UPDATED"] = "task_updated";
+  NotifyType2["TASK_FAILED"] = "task_failed";
+  NotifyType2["OPERATION_CREATED"] = "operation_created";
+})(NotifyType ||= {});
+
+class LarkCliTaskNotifyHook {
+  name;
+  priority;
+  description;
+  pluginName;
+  sourceId;
+  config;
+  lastNotifyTimestamps = new Map;
+  constructor(config = {}) {
+    this.name = config.pluginName || "LarkCliTaskNotifyHook";
+    this.priority = config.priority ?? 5;
+    this.description = "LarkCli 任务通知 Hook";
+    this.pluginName = config.pluginName;
+    this.sourceId = config.sourceId;
+    this.config = {
+      enabled: true,
+      priority: 5,
+      notifyTypes: [
+        "task_created" /* TASK_CREATED */,
+        "task_updated" /* TASK_UPDATED */,
+        "task_completed" /* TASK_COMPLETED */,
+        "operation_created" /* OPERATION_CREATED */
+      ],
+      ...config
+    };
+  }
+  async execute(ctx) {
+    if (!this.config.enabled) {
+      return;
+    }
+    const env = getEnvContextOrEmpty();
+    if (this.pluginName && this.sourceId) {
+      const key = `${this.sourceId}:${this.pluginName}`;
+      if (env.pluginEnabled && env.pluginEnabled[key] !== true) {
+        logger3.debug(`Plugin not enabled for source: ${key}`);
+        return;
+      }
+    }
+    switch (ctx.hookPoint) {
+      case TaskHookPoints.AFTER_CREATE:
+        await this.onAfterCreate(ctx);
+        break;
+      case TaskHookPoints.AFTER_UPDATE:
+        await this.onAfterUpdate(ctx);
+        break;
+      case TaskHookPoints.OPERATION_AFTER_CREATE:
+        await this.onAfterOperationCreate(ctx);
+        break;
+    }
+  }
+  async onAfterCreate(ctx) {
+    const { task } = ctx.data;
+    if (!this.shouldNotify("task_created" /* TASK_CREATED */))
+      return;
+    await this.sendNotify({
+      type: "task_created" /* TASK_CREATED */,
+      title: `\uD83D\uDCDD 任务已创建`,
+      content: this.formatTaskCreated(task)
+    });
+  }
+  async onAfterUpdate(ctx) {
+    const data = ctx.data;
+    if (!data) {
+      return;
+    }
+    const { task, changes } = data;
+    if (!task) {
+      return;
+    }
+    let notifyType;
+    let notifyChanges = changes || {};
+    if (changes?.status === "completed" || changes?.progress === 100) {
+      notifyType = "task_completed" /* TASK_COMPLETED */;
+    } else if (changes?.status) {
+      notifyType = "task_updated" /* TASK_UPDATED */;
+    } else if (task.status === "completed" || task.progress === 100) {
+      notifyType = "task_completed" /* TASK_COMPLETED */;
+      notifyChanges = { status: task.status, progress: task.progress };
+    } else if (changes && Object.keys(changes).length > 0) {
+      notifyType = "task_updated" /* TASK_UPDATED */;
+    } else {
+      return;
+    }
+    if (!this.shouldNotify(notifyType)) {
+      return;
+    }
+    await this.sendNotify({
+      type: notifyType,
+      title: this.getNotifyTitle(notifyType),
+      content: this.formatTaskUpdate(task, notifyChanges),
+      _hookContext: ctx
+    });
+  }
+  async onAfterOperationCreate(ctx) {
+    const { operation } = ctx.data;
+    if (!operation) {
+      logger3.debug("onAfterOperationCreate: operation is missing, skip");
+      return;
+    }
+    if (!this.shouldNotify("operation_created" /* OPERATION_CREATED */)) {
+      return;
+    }
+    if (this.shouldThrottleOperation(operation)) {
+      return;
+    }
+    await this.sendNotify({
+      type: "operation_created" /* OPERATION_CREATED */,
+      title: this.getNotifyTitle("operation_created" /* OPERATION_CREATED */),
+      content: await this.formatOperationCreated(operation),
+      _hookContext: ctx
+    });
+  }
+  async sendNotify(options) {
+    const { type, title, content, _hookContext } = options;
+    const env = getEnvContextOrEmpty();
+    let replyChannel = env.replyChannel;
+    const envContextFromMetadata = env.metadata?.envContext;
+    if (!replyChannel && envContextFromMetadata) {
+      replyChannel = envContextFromMetadata.replyChannel;
+    }
+    if (!replyChannel && _hookContext?.metadata?.envContext) {
+      replyChannel = _hookContext.metadata.envContext.replyChannel;
+    }
+    const larkFields = extractLarkFields(env);
+    if (!larkFields.isLark && env.event) {
+      logger3.debug(`Skipping notification for non-lark event source: ${larkFields.source}`);
+      return;
+    }
+    const chatId = replyChannel?.chatId;
+    const messageId = replyChannel?.messageId;
+    if (!chatId && !messageId) {
+      logger3.debug(`No replyChannel available for ${type}`);
+      return;
+    }
+    const message = `${title}
+
+${content}`;
+    try {
+      if (isTaskNotifyDebugEnabled()) {
+        logger3.debug(`Sending message - messageId: ${messageId}`);
+      }
+      const profile = replyChannel?.profile;
+      await this.sendLarkMessage({
+        chatId,
+        messageId,
+        content: message,
+        profile
+      });
+      logger3.info(`Notification sent: ${type}`);
+    } catch (error) {
+      logger3.error(`Failed to send notification: ${error}`);
+    }
+  }
+  sendLarkMessage(options) {
+    return new Promise((resolve, reject) => {
+      const { chatId, messageId, content, profile } = options;
+      let args;
+      if (messageId) {
+        args = [
+          "im",
+          "+messages-reply",
+          "--message-id",
+          messageId,
+          "--markdown",
+          content,
+          "--as",
+          "bot"
+        ];
+      } else {
+        args = [
+          "im",
+          "+messages-send",
+          "--chat-id",
+          chatId,
+          "--markdown",
+          content
+        ];
+      }
+      if (profile) {
+        args.unshift("--profile", profile);
+      }
+      const proc = spawn("lark-cli", args, {
+        shell: false,
+        stdio: ["pipe", "pipe", "pipe"]
+      });
+      let stdout = "";
+      let stderr = "";
+      proc.stdout?.on("data", (data) => {
+        stdout += data.toString();
+      });
+      proc.stderr?.on("data", (data) => {
+        stderr += data.toString();
+      });
+      proc.on("close", (code) => {
+        if (code === 0) {
+          logger3.debug(`lark-cli output: ${stdout}`);
+          resolve();
+        } else {
+          reject(new Error(`lark-cli exited with code ${code}: ${stderr}`));
+        }
+      });
+      proc.on("error", (error) => {
+        reject(error);
+      });
+    });
+  }
+  truncate(text, maxLen) {
+    if (text.length <= maxLen)
+      return text;
+    return text.substring(0, maxLen) + "...";
+  }
+  appendSpatiotemporalContextLines(lines, task, options = {}) {
+    if (task?.project_path) {
+      lines.push(`- \uD83D\uDCC2 项目路径: \`${task.project_path}\``);
+    }
+    const ctxStr = task?.context;
+    let parsedCtx = null;
+    if (typeof ctxStr === "string" && ctxStr.length > 0) {
+      try {
+        const obj = JSON.parse(ctxStr);
+        if (obj && typeof obj === "object" && !Array.isArray(obj)) {
+          parsedCtx = obj;
+        }
+      } catch {}
+    }
+    if (!parsedCtx) {
+      if (options.appendFullContext && typeof ctxStr === "string") {
+        lines.push(`- \uD83D\uDCCB 完整 context: \`${this.truncate(ctxStr, 200)}\``);
+      }
+      return;
+    }
+    if (parsedCtx.worktree_path && typeof parsedCtx.worktree_path === "string") {
+      lines.push(`- \uD83C\uDF3F Worktree: \`${parsedCtx.worktree_path}\``);
+    }
+    if (parsedCtx.created_at && typeof parsedCtx.created_at === "string") {
+      lines.push(`- ⏰ 时间上下文: ${parsedCtx.created_at}`);
+    }
+    if (parsedCtx.prior_context && typeof parsedCtx.prior_context === "object") {
+      const priorStr = this.formatPriorContext(parsedCtx.prior_context);
+      if (priorStr) {
+        lines.push(`- \uD83D\uDCDC 背景: ${priorStr}`);
+      }
+    }
+    if (options.appendFullContext) {
+      lines.push(`- \uD83D\uDCCB 完整 context: \`${this.truncate(JSON.stringify(parsedCtx), 300)}\``);
+    }
+  }
+  formatPriorContext(prior) {
+    if (!prior || typeof prior !== "object")
+      return "";
+    const entries = [];
+    for (const [k, v] of Object.entries(prior)) {
+      if (v === null || v === undefined)
+        continue;
+      const s = typeof v === "object" ? JSON.stringify(v) : String(v);
+      if (s === "" || s === "undefined")
+        continue;
+      entries.push(`${k}=${s}`);
+    }
+    return entries.join(", ");
+  }
+  shouldNotify(type) {
+    const { notifyTypes } = this.config;
+    if (notifyTypes && notifyTypes.length === 0)
+      return true;
+    if (notifyTypes)
+      return notifyTypes.includes(type);
+    return type === "task_completed" /* TASK_COMPLETED */;
+  }
+  getNotifyTitle(type) {
+    const template = this.config.templates?.[type];
+    if (template)
+      return template;
+    switch (type) {
+      case "task_created" /* TASK_CREATED */:
+        return "\uD83D\uDCDD 任务已创建";
+      case "task_completed" /* TASK_COMPLETED */:
+        return "✅ 任务已完成";
+      case "task_updated" /* TASK_UPDATED */:
+        return "\uD83D\uDCCB 任务已更新";
+      case "task_failed" /* TASK_FAILED */:
+        return "❌ 任务执行失败";
+      case "operation_created" /* OPERATION_CREATED */:
+        return "\uD83D\uDCCC 操作记录";
+      default:
+        return "\uD83D\uDCEC 任务通知";
+    }
+  }
+  formatTaskCreated(task) {
+    const lines = [];
+    if (task.title) {
+      lines.push(`- **标题**: ${task.title}`);
+    }
+    if (task.description) {
+      lines.push(`- **描述**: ${this.truncate(task.description, 100)}`);
+    }
+    if (task.priority) {
+      lines.push(`- **优先级**: ${task.priority}`);
+    }
+    this.appendSpatiotemporalContextLines(lines, task);
+    return lines.join(`
+`);
+  }
+  formatTaskUpdate(task, changes) {
+    const lines = [];
+    if (task.title) {
+      lines.push(`- **标题**: ${task.title}`);
+    }
+    lines.push(`- **ID**: ${task.id}`);
+    if (changes?.status) {
+      lines.push(`- **状态**: ${changes.status}`);
+    }
+    if (changes?.progress !== undefined) {
+      lines.push(`- **进度**: ${changes.progress}%`);
+    }
+    if (changes?.current_status) {
+      lines.push(`- **当前状态**: ${changes.current_status}`);
+    }
+    this.appendSpatiotemporalContextLines(lines, task);
+    const changeKeys = Object.keys(changes || {}).filter((k) => !["status", "progress", "current_status"].includes(k));
+    if (changeKeys.length > 0) {
+      lines.push(`- **变更**: ${changeKeys.join(", ")}`);
+    }
+    return lines.join(`
+`);
+  }
+  shouldThrottleOperation(operation) {
+    const throttleMs = this.config.operationThrottleMs ?? 5000;
+    if (throttleMs <= 0) {
+      return false;
+    }
+    const key = `op:${operation.taskId}`;
+    const now = Date.now();
+    const lastTime = this.lastNotifyTimestamps.get(key);
+    if (lastTime && now - lastTime < throttleMs) {
+      logger3.debug(`[throttle] Skipping OPERATION_CREATED notify for task #${operation.taskId}, last notified ${now - lastTime}ms ago`);
+      return true;
+    }
+    this.lastNotifyTimestamps.set(key, now);
+    return false;
+  }
+  async formatOperationCreated(operation, task) {
+    const resolvedTask = task ?? await this.resolveTaskForOperation(operation);
+    const lines = [];
+    if (resolvedTask?.title) {
+      lines.push(`- **任务**: ${resolvedTask.title}`);
+    }
+    if (operation.taskId !== undefined && operation.taskId !== null) {
+      lines.push(`- **任务 ID**: #${operation.taskId}`);
+    }
+    if (operation.milestoneType) {
+      lines.push(`- **里程碑类型**: ${operation.milestoneType}`);
+    }
+    if (operation.milestoneTitle) {
+      lines.push(`- **标题**: ${operation.milestoneTitle}`);
+    }
+    if (operation.milestoneDescription) {
+      lines.push(`- **里程碑描述**: ${this.truncate(String(operation.milestoneDescription), 200)}`);
+    }
+    if (operation.processDescription) {
+      lines.push(`- **过程概要**: ${this.truncate(String(operation.processDescription), 200)}`);
+    }
+    this.appendSpatiotemporalContextLines(lines, resolvedTask, {
+      appendFullContext: true
+    });
+    if (operation.sessionId) {
+      lines.push(`- **Session**: \`${operation.sessionId}\``);
+    }
+    return lines.join(`
+`);
+  }
+  async resolveTaskForOperation(operation) {
+    if (operation.taskId === undefined || operation.taskId === null) {
+      return;
+    }
+    const fetch = this.config.fetchTaskById;
+    if (!fetch) {
+      return;
+    }
+    try {
+      return await fetch(operation.taskId);
+    } catch (error) {
+      logger3.warn(`fetchTaskById failed for task #${operation.taskId}: ${error}`);
+      return;
+    }
+  }
+}
+__legacyDecorateClassTS([
+  TracedAs("lark-cli-task-notify.execute")
+], LarkCliTaskNotifyHook.prototype, "execute", null);
+__legacyDecorateClassTS([
+  TracedAs("lark-cli-task-notify.sendNotify")
+], LarkCliTaskNotifyHook.prototype, "sendNotify", null);
+__legacyDecorateClassTS([
+  TracedAs("lark-cli-task-notify.sendLarkMessage")
+], LarkCliTaskNotifyHook.prototype, "sendLarkMessage", null);
+function createLarkCliTaskNotifyHook(config = {}) {
+  return new LarkCliTaskNotifyHook(config);
+}
+// src/env/task/plugins/per-task-group-chat-plugin.ts
+init_decorator();
+init_logger();
+init_context();
+import { spawn as spawn2 } from "child_process";
+var logger4 = createLogger("lark-cli:per-task-group");
+function isPluginDebugEnabled() {
+  return process.env.ROY_TASK_NOTIFY_DEBUG === "1" || process.env.ROY_TRACE_DEBUG === "1";
+}
+var CTX_FIELD_CHAT_ID = "larkPerTaskChatId";
+var CTX_FIELD_CHAT_PROFILE = "larkPerTaskChatProfile";
+var CTX_FIELD_CHAT_CREATED_AT = "larkPerTaskChatCreatedAt";
+var CTX_FIELD_CHAT_TASK_ID = "larkPerTaskChatTaskId";
+
+class PerTaskGroupChatPlugin {
+  name;
+  priority;
+  pluginName;
+  sourceId;
+  config;
+  lastNotifyTimestamps = new Map;
+  taskUpdater;
+  constructor(config = {}) {
+    this.config = {
+      enabled: config.enabled ?? true,
+      priority: config.priority ?? 100,
+      pluginName: config.pluginName ?? "PerTaskGroupChatPlugin",
+      sourceId: config.sourceId ?? "",
+      nameTemplate: config.nameTemplate ?? "Task #{id} - #{title}",
+      descriptionTemplate: config.descriptionTemplate ?? "roy-agent task #{id} - #{project_path}",
+      botAppIds: config.botAppIds ?? [],
+      inviteUserIds: config.inviteUserIds ?? ["sender"],
+      defaultInviteUserIds: config.defaultInviteUserIds ?? [],
+      fallbackToMain: config.fallbackToMain ?? true,
+      operationThrottleMs: config.operationThrottleMs ?? 5000,
+      disableSubTaskSkip: config.disableSubTaskSkip ?? false,
+      requireReplyChannel: config.requireReplyChannel ?? true,
+      fallbackProfile: config.fallbackProfile ?? "",
+      sendWelcomeMessage: config.sendWelcomeMessage ?? true
+    };
+    this.name = this.config.pluginName;
+    this.priority = this.config.priority;
+    this.pluginName = this.config.pluginName;
+    this.sourceId = this.config.sourceId;
+  }
+  setTaskUpdater(updater) {
+    this.taskUpdater = updater;
+    logger4.debug(`TaskUpdater injected for plugin ${this.name} (sourceId=${this.sourceId})`);
+  }
+  hasTaskUpdater() {
+    return this.taskUpdater !== undefined;
+  }
+  async execute(ctx) {
+    if (!this.config.enabled) {
+      logger4.debug(`execute: plugin disabled (pluginName=${this.pluginName})`);
+      return;
+    }
+    if (this.pluginName && this.sourceId) {
+      const env = getEnvContextOrEmpty();
+      const key = `${this.sourceId}:${this.pluginName}`;
+      if (env.pluginEnabled && env.pluginEnabled[key] !== true) {
+        logger4.debug(`execute[${this.pluginName}]: plugin NOT enabled (key=${key}, ` + `env.pluginEnabled=${JSON.stringify(env.pluginEnabled)}, ` + `hookPoint=${ctx.hookPoint}). ` + `→ skip. 修复：roy-agent eventsource update <id> 必须包含 PerTaskGroupChatPlugin`);
+        return;
+      }
+      const enabledState = env.pluginEnabled ? env.pluginEnabled[key] === true ? "✅ enabled" : "❌ NOT enabled" : "⚠️  env.pluginEnabled 未设置 (env 没创建 / 插件未注册到 eventsource)";
+      logger4.debug(`execute[${this.pluginName}]: ${enabledState} (key=${key}, ` + `hookPoint=${ctx.hookPoint}, taskUpdaterInjected=${this.hasTaskUpdater()})`);
+    } else {
+      logger4.debug(`execute[${this.pluginName}]: missing pluginName/sourceId metadata ` + `(pluginName=${this.pluginName}, sourceId=${this.sourceId}), ` + `skipping pluginEnabled check. hookPoint=${ctx.hookPoint}`);
+    }
+    switch (ctx.hookPoint) {
+      case TaskHookPoints.AFTER_CREATE:
+        await this.onAfterCreate(ctx);
+        break;
+      case TaskHookPoints.AFTER_UPDATE:
+        await this.onAfterUpdate(ctx);
+        break;
+      case TaskHookPoints.OPERATION_AFTER_CREATE:
+        await this.onAfterOperationCreate(ctx);
+        break;
+      case TaskHookPoints.AFTER_COMPLETE:
+        await this.onAfterComplete(ctx);
+        break;
+      default:
+        logger4.debug(`execute: unhandled hookPoint=${ctx.hookPoint}, skip`);
+    }
+  }
+  async onAfterCreate(ctx) {
+    const data = ctx.data;
+    if (!data?.task) {
+      logger4.debug("onAfterCreate: task is missing, skip");
+      return;
+    }
+    const { task } = data;
+    logger4.debug(`onAfterCreate[${this.pluginName}]: enter task=${task.id} "${task.title}" ` + `parent_task_id=${task.parent_task_id ?? "none"} ` + `requireReplyChannel=${this.config.requireReplyChannel} ` + `disableSubTaskSkip=${this.config.disableSubTaskSkip} ` + `sendWelcomeMessage=${this.config.sendWelcomeMessage}`);
+    const replyChannel = this.getReplyChannelFromCtx(ctx);
+    if (!replyChannel?.chatId && this.config.requireReplyChannel) {
+      logger4.debug(`onAfterCreate[${this.pluginName}]: no replyChannel.chatId for task #${task.id}, skip. ` + `修复：eventsource 收到 im.message.receive_v1 事件时 replyChannel 应有值；` + `或在 plugin config 设 requireReplyChannel=false 强制创建群聊（profile 降级到 fallbackProfile/无）`);
+      return;
+    }
+    if (!replyChannel?.chatId && !this.config.requireReplyChannel) {
+      logger4.debug(`onAfterCreate[${this.pluginName}]: no replyChannel but requireReplyChannel=false, ` + `proceeding with profile fallback (fallbackProfile="${this.config.fallbackProfile}")`);
+    }
+    if (this.isSubTask(task) && !this.config.disableSubTaskSkip) {
+      logger4.debug(`onAfterCreate[${this.pluginName}]: task #${task.id} is sub-task, ` + `skip group chat creation. 关闭方式：config.disableSubTaskSkip=true`);
+      return;
+    }
+    if (this.isSubTask(task) && this.config.disableSubTaskSkip) {
+      logger4.debug(`onAfterCreate[${this.pluginName}]: task #${task.id} is sub-task but ` + `disableSubTaskSkip=true, proceeding to create group chat`);
+    }
+    const name = this.renderTemplate(this.config.nameTemplate, task);
+    const description = this.renderTemplate(this.config.descriptionTemplate, task);
+    const profile = replyChannel?.profile || (this.config.fallbackProfile || undefined);
+    const botAppIds = this.resolveBotAppIds(replyChannel ?? {});
+    const userIds = this.resolveUserIds(replyChannel);
+    logger4.debug(`onAfterCreate[${this.pluginName}]: creating group chat for task #${task.id} ` + `name="${name}" profile="${profile}" botAppIds=${JSON.stringify(botAppIds)} ` + `userIds=${JSON.stringify(userIds)}`);
+    try {
+      const chatId = await this.createGroupChat({
+        name,
+        description,
+        profile,
+        botAppIds,
+        userIds
+      });
+      await this.attachChatIdToTask(task, chatId, profile);
+      if (this.config.sendWelcomeMessage) {
+        try {
+          await this.sendToChat({
+            chatId,
+            profile,
+            content: this.formatWelcomeMessage(task, chatId)
+          });
+          logger4.debug(`onAfterCreate[${this.pluginName}]: sent welcome message to new chat ${chatId}`);
+        } catch (welcomeErr) {
+          logger4.warn(`onAfterCreate[${this.pluginName}]: failed to send welcome message to ${chatId}: ${welcomeErr}`);
+        }
+      } else {
+        logger4.debug(`onAfterCreate[${this.pluginName}]: skip welcome message (sendWelcomeMessage=false)`);
+      }
+      if (replyChannel?.chatId) {
+        await this.sendToMain(replyChannel, {
+          title: `\uD83D\uDCC2 Task #${task.id} 群聊已创建`,
+          content: [
+            `- **任务**: ${this.truncate(task.title ?? "", 60)}`,
+            `- **群聊链接**: https://applink.larkoffice.com/client/chat/chatDetail?chat_id=${chatId}`,
+            `- **任务 ID**: #${task.id}`
+          ].join(`
+`),
+          profile
+        });
+      } else {
+        logger4.debug(`onAfterCreate[${this.pluginName}]: skip "群聊已创建" main-chat notification ` + `(no replyChannel.chatId)`);
+      }
+      logger4.info(`Created per-task group chat ${chatId} for task #${task.id}`);
+    } catch (error) {
+      logger4.error(`Failed to create per-task group chat for task #${task.id}: ${error}`);
+      if (!this.config.fallbackToMain)
+        throw error;
+    }
+  }
+  async onAfterUpdate(ctx) {
+    const data = ctx.data;
+    if (!data?.task) {
+      logger4.debug("onAfterUpdate: task is missing, skip");
+      return;
+    }
+    const { task, changes } = data;
+    const chatId = this.getTaskChatId(task);
+    if (!chatId) {
+      logger4.debug(`onAfterUpdate[${this.pluginName}]: task #${task.id} has no per-task chat_id, skip. ` + `诊断：检查 task.context JSON 是否含 larkPerTaskChatId 字段 ` + `(sqlite: SELECT context FROM task WHERE id=${task.id})`);
+      return;
+    }
+    const replyChannel = this.getReplyChannelFromCtx(ctx);
+    const profile = replyChannel?.profile ?? this.getTaskChatProfile(task) ?? undefined;
+    if (!this.hasMeaningfulChange(changes)) {
+      logger4.debug(`onAfterUpdate[${this.pluginName}]: no meaningful change for task #${task.id}, skip`);
+      return;
+    }
+    logger4.debug(`onAfterUpdate[${this.pluginName}]: send update for task #${task.id} ` + `to chat_id=${chatId} profile="${profile}" changes=${JSON.stringify(changes)}`);
+    await this.sendToChat({
+      chatId,
+      profile,
+      content: this.formatUpdate(task, changes)
+    });
+  }
+  async onAfterOperationCreate(ctx) {
+    const data = ctx.data;
+    if (!data?.operation) {
+      logger4.debug("onAfterOperationCreate: operation is missing, skip");
+      return;
+    }
+    const { operation } = data;
+    if (this.shouldThrottleOperation(operation)) {
+      logger4.debug(`onAfterOperationCreate[${this.pluginName}]: operation #${operation.id} ` + `throttled for task #${operation.taskId ?? operation.task_id}`);
+      return;
+    }
+    const taskId = operation.taskId ?? operation.task_id;
+    if (!taskId) {
+      logger4.debug("onAfterOperationCreate: no taskId in operation, skip");
+      return;
+    }
+    const taskFromCtx = ctx.metadata?.task;
+    const chatId = taskFromCtx ? this.getTaskChatId(taskFromCtx) : undefined;
+    if (!chatId || !taskFromCtx) {
+      logger4.debug(`onAfterOperationCreate[${this.pluginName}]: no per-task chat_id for task #${taskId}, skip. ` + `诊断：ctx.metadata.task 是否包含完整 task 对象？task.context.larkPerTaskChatId 是否存在？`);
+      return;
+    }
+    const replyChannel = this.getReplyChannelFromCtx(ctx);
+    const profile = replyChannel?.profile ?? this.getTaskChatProfile(taskFromCtx) ?? undefined;
+    logger4.debug(`onAfterOperationCreate[${this.pluginName}]: send operation #${operation.id} ` + `for task #${taskId} to chat_id=${chatId}`);
+    await this.sendToChat({
+      chatId,
+      profile,
+      content: this.formatOperation(operation)
+    });
+  }
+  async onAfterComplete(ctx) {
+    const data = ctx.data;
+    if (!data?.task) {
+      logger4.debug("onAfterComplete: task is missing, skip");
+      return;
+    }
+    const { task, terminalStatus } = data;
+    const chatId = this.getTaskChatId(task);
+    if (!chatId) {
+      logger4.debug(`onAfterComplete[${this.pluginName}]: task #${task.id} has no per-task chat_id, skip`);
+      return;
+    }
+    const replyChannel = this.getReplyChannelFromCtx(ctx);
+    const profile = replyChannel?.profile ?? this.getTaskChatProfile(task) ?? undefined;
+    const emoji = terminalStatus === "completed" ? "✅" : terminalStatus === "failed" ? "❌" : terminalStatus === "cancelled" ? "\uD83D\uDEAB" : terminalStatus === "timeout" ? "⏰" : "\uD83C\uDFC1";
+    logger4.debug(`onAfterComplete[${this.pluginName}]: send complete notification for task #${task.id} ` + `status=${terminalStatus} to chat_id=${chatId}`);
+    await this.sendToChat({
+      chatId,
+      profile,
+      content: `${emoji} **Task #${task.id} ${terminalStatus.toUpperCase()}**
+
+` + `- **任务**: ${this.truncate(task.title, 80)}
+` + `- **最终状态**: ${terminalStatus}
+` + `- **进度**: ${task.progress ?? "?"}%
+` + `- **结束时间**: ${new Date().toISOString()}`
+    });
+  }
+  createGroupChat(opts) {
+    const args = this.buildCreateGroupChatArgs(opts);
+    if (isPluginDebugEnabled()) {
+      logger4.debug(`Creating group chat: lark-cli ${args.join(" ")}`);
+    }
+    return new Promise((resolve, reject) => {
+      const proc = spawn2("lark-cli", args, {
+        shell: false,
+        stdio: ["pipe", "pipe", "pipe"]
+      });
+      let stdout = "";
+      let stderr = "";
+      proc.stdout?.on("data", (data) => {
+        stdout += data.toString();
+      });
+      proc.stderr?.on("data", (data) => {
+        stderr += data.toString();
+      });
+      proc.on("close", (code) => {
+        if (code !== 0) {
+          reject(new Error(`lark-cli +chat-create exited with code ${code}: ${stderr}`));
+          return;
+        }
+        const chatId = this.parseChatId(stdout);
+        if (!chatId) {
+          reject(new Error(`lark-cli +chat-create did not return chat_id: ${stdout}`));
+          return;
+        }
+        resolve(chatId);
+      });
+      proc.on("error", (error) => {
+        reject(error);
+      });
+    });
+  }
+  buildCreateGroupChatArgs(opts) {
+    const nameTrimmed = this.truncate(opts.name, 60);
+    const descriptionTrimmed = this.truncate(opts.description, 100);
+    const args = [
+      "im",
+      "+chat-create",
+      "--name",
+      nameTrimmed,
+      "--description",
+      descriptionTrimmed
+    ];
+    if (opts.profile) {
+      args.push("--as", "bot");
+    }
+    if (opts.botAppIds.length > 0) {
+      args.push("--bots", opts.botAppIds.join(","));
+      args.push("--set-bot-manager");
+    }
+    if (opts.userIds && opts.userIds.length > 0) {
+      args.push("--users", opts.userIds.join(","));
+    }
+    if (opts.profile) {
+      args.unshift("--profile", opts.profile);
+    }
+    return args;
+  }
+  async attachChatIdToTask(task, chatId, profile) {
+    const contextStr = task.context ?? "{}";
+    let parsed = {};
+    try {
+      const obj = JSON.parse(contextStr);
+      if (obj && typeof obj === "object" && !Array.isArray(obj)) {
+        parsed = obj;
+      }
+    } catch {
+      parsed = {};
+    }
+    parsed[CTX_FIELD_CHAT_ID] = chatId;
+    parsed[CTX_FIELD_CHAT_PROFILE] = profile;
+    parsed[CTX_FIELD_CHAT_CREATED_AT] = new Date().toISOString();
+    parsed[CTX_FIELD_CHAT_TASK_ID] = task.id;
+    const newContext = JSON.stringify(parsed);
+    if (!this.taskUpdater) {
+      logger4.warn(`attachChatIdToTask[${this.pluginName}]: ⚠️  no taskUpdater injected, ` + `chat_id ${chatId} NOT persisted to db for task #${task.id}. ` + `后果：下次 AFTER_UPDATE 从 DB 加载 task 时 getTaskChatId() 返回 undefined，` + `所有 update/complete/operation 通知 silently 丢失。` + `修复：event-source-handlers.ts:registerPluginHooks 应自动注入 setTaskUpdater。`);
+      task.context = newContext;
+      return;
+    }
+    try {
+      await this.taskUpdater(task.id, newContext);
+      task.context = newContext;
+      logger4.debug(`attachChatIdToTask[${this.pluginName}]: ✅ persisted chat_id ${chatId} ` + `to task #${task.id} context`);
+    } catch (error) {
+      logger4.error(`Failed to persist chat_id to task #${task.id}: ${error}`);
+      task.context = newContext;
+    }
+  }
+  buildSendToChatArgs(opts) {
+    const args = [
+      "im",
+      "+messages-send",
+      "--chat-id",
+      opts.chatId,
+      "--markdown",
+      opts.content,
+      "--as",
+      "bot"
+    ];
+    if (opts.profile) {
+      args.unshift("--profile", opts.profile);
+    }
+    return args;
+  }
+  sendToChat(opts) {
+    return new Promise((resolve, reject) => {
+      const args = this.buildSendToChatArgs(opts);
+      if (isPluginDebugEnabled()) {
+        logger4.debug(`Sending to chat ${opts.chatId}: lark-cli ${args.join(" ")}`);
+      }
+      const proc = spawn2("lark-cli", args, {
+        shell: false,
+        stdio: ["pipe", "pipe", "pipe"]
+      });
+      let stderr = "";
+      proc.stderr?.on("data", (data) => {
+        stderr += data.toString();
+      });
+      proc.on("close", (code) => {
+        if (code === 0) {
+          resolve();
+        } else {
+          reject(new Error(`lark-cli +messages-send exited with code ${code}: ${stderr}`));
+        }
+      });
+      proc.on("error", (error) => {
+        reject(error);
+      });
+    });
+  }
+  sendToMain(replyChannel, opts) {
+    return new Promise((resolve, reject) => {
+      const message = `${opts.title}
+
+${opts.content}`;
+      const args = replyChannel.messageId ? ["im", "+messages-reply", "--message-id", replyChannel.messageId, "--markdown", message, "--as", "bot"] : ["im", "+messages-send", "--chat-id", replyChannel.chatId, "--markdown", message];
+      if (opts.profile) {
+        args.unshift("--profile", opts.profile);
+      }
+      const proc = spawn2("lark-cli", args, {
+        shell: false,
+        stdio: ["pipe", "pipe", "pipe"]
+      });
+      let stderr = "";
+      proc.stderr?.on("data", (data) => {
+        stderr += data.toString();
+      });
+      proc.on("close", (code) => {
+        if (code === 0) {
+          resolve();
+        } else {
+          reject(new Error(`lark-cli send-to-main exited with code ${code}: ${stderr}`));
+        }
+      });
+      proc.on("error", (error) => {
+        reject(error);
+      });
+    });
+  }
+  getReplyChannelFromCtx(ctx) {
+    const metadata = ctx.metadata;
+    const alsEnv = getEnvContextOrEmpty();
+    if (alsEnv.replyChannel?.chatId) {
+      return alsEnv.replyChannel;
+    }
+    if (!metadata)
+      return;
+    const envCtx = metadata.envContext;
+    if (envCtx?.replyChannel?.chatId) {
+      return envCtx.replyChannel;
+    }
+    const direct = metadata.replyChannel;
+    if (direct?.chatId) {
+      return direct;
+    }
+    return;
+  }
+  getTaskChatId(task) {
+    const ctxStr = task.context;
+    if (!ctxStr)
+      return;
+    try {
+      const obj = JSON.parse(ctxStr);
+      const id = obj[CTX_FIELD_CHAT_ID];
+      return typeof id === "string" ? id : undefined;
+    } catch {
+      return;
+    }
+  }
+  getTaskChatProfile(task) {
+    const ctxStr = task.context;
+    if (!ctxStr)
+      return;
+    try {
+      const obj = JSON.parse(ctxStr);
+      const profile = obj[CTX_FIELD_CHAT_PROFILE];
+      return typeof profile === "string" ? profile : undefined;
+    } catch {
+      return;
+    }
+  }
+  resolveBotAppIds(replyChannel) {
+    if (this.config.botAppIds.length > 0) {
+      logger4.debug(`resolveBotAppIds[${this.pluginName}]: using config.botAppIds=${JSON.stringify(this.config.botAppIds)}`);
+      return this.config.botAppIds;
+    }
+    const appId = replyChannel ? replyChannel.appId : undefined;
+    if (appId) {
+      logger4.debug(`resolveBotAppIds[${this.pluginName}]: using replyChannel.appId=${appId} (auto-detected from event header.app_id)`);
+      return [appId];
+    }
+    logger4.warn(`resolveBotAppIds[${this.pluginName}]: ⚠️ no botAppIds found, creating group WITHOUT --bots. ` + `Bot will NOT be invited automatically. ` + `可能原因：(1) eventsource 没有收到 im.message.receive_v1 事件（replyChannel.appId 缺失）；` + `(2) 配置了 requireReplyChannel=false 模式；` + `(3) buildReplyChannel 没透传 appId（应在 v1.10+ 修复）。` + `修复：手动设置 config.botAppIds: ["cli_xxx"] 或确认 eventsource 处理了 lark event。`);
+    return [];
+  }
+  resolveUserIds(replyChannel) {
+    const ids = new Set;
+    if (this.config.defaultInviteUserIds && this.config.defaultInviteUserIds.length > 0) {
+      for (const id of this.config.defaultInviteUserIds) {
+        if (id && id !== "sender" && id.startsWith("ou_")) {
+          ids.add(id);
+        } else if (id && id !== "sender") {
+          logger4.debug(`resolveUserIds[${this.pluginName}]: skip non-open_id in defaultInviteUserIds: "${id}"`);
+        }
+      }
+    }
+    if (this.config.inviteUserIds && this.config.inviteUserIds.length > 0) {
+      for (const id of this.config.inviteUserIds) {
+        if (id !== "sender" && id)
+          ids.add(id);
+      }
+    }
+    if (this.config.inviteUserIds?.includes("sender")) {
+      const senderId = replyChannel?.userId || replyChannel?.params?.userId || getEnvContextOrEmpty().userId;
+      if (senderId && senderId.startsWith("ou_")) {
+        ids.add(senderId);
+      }
+    }
+    if (ids.size === 0 && this.config.inviteUserIds?.includes("sender")) {
+      const alsUserId = getEnvContextOrEmpty().userId;
+      if (alsUserId && alsUserId.startsWith("ou_")) {
+        ids.add(alsUserId);
+      }
+    }
+    if (isPluginDebugEnabled()) {
+      logger4.debug(`resolveUserIds[${this.pluginName}]: ` + `defaultInviteUserIds=${JSON.stringify(this.config.defaultInviteUserIds)} ` + `inviteUserIds=${JSON.stringify(this.config.inviteUserIds)} ` + `replyChannel.userId=${replyChannel?.userId ?? "(none)"} ` + `→ final userIds=${JSON.stringify(Array.from(ids))}`);
+    }
+    return Array.from(ids);
+  }
+  isSubTask(task) {
+    const parentId = task.parent_task_id;
+    return typeof parentId === "number" && parentId > 0;
+  }
+  hasMeaningfulChange(changes) {
+    if (!changes || Object.keys(changes).length === 0)
+      return false;
+    const keys = Object.keys(changes);
+    return keys.some((k) => [
+      "status",
+      "progress",
+      "priority",
+      "title",
+      "description",
+      "current_status",
+      "tags",
+      "goals_and_expected_deliverables"
+    ].includes(k));
+  }
+  shouldThrottleOperation(operation) {
+    if (this.config.operationThrottleMs <= 0)
+      return false;
+    const taskId = operation.taskId ?? operation.task_id ?? 0;
+    if (taskId === 0)
+      return false;
+    const now = Date.now();
+    const last = this.lastNotifyTimestamps.get(taskId) ?? 0;
+    if (now - last < this.config.operationThrottleMs) {
+      return true;
+    }
+    this.lastNotifyTimestamps.set(taskId, now);
+    return false;
+  }
+  renderTemplate(template, task) {
+    const id = String(task.id);
+    const title = this.truncate(task.title ?? "", 60);
+    const projectPath = task.project_path ?? "";
+    return template.replace(/#\{id\}/g, id).replace(/(^|[^{]){id\}/g, `$1${id}`).replace(/#\{title\}/g, title).replace(/(^|[^{]){title\}/g, `$1${title}`).replace(/#\{project_path\}/g, projectPath).replace(/(^|[^{]){project_path\}/g, `$1${projectPath}`);
+  }
+  truncate(text, maxLen) {
+    if (!text)
+      return "";
+    if (text.length <= maxLen)
+      return text;
+    return text.substring(0, Math.max(0, maxLen - 3)) + "...";
+  }
+  parseChatId(stdout) {
+    if (!stdout)
+      return;
+    try {
+      const obj = JSON.parse(stdout.trim());
+      const data = obj.data;
+      if (data?.chat_id)
+        return data.chat_id;
+      if (data?.chatId)
+        return data.chatId;
+    } catch {}
+    const match = stdout.match(/oc_[a-zA-Z0-9]+/);
+    return match ? match[0] : undefined;
+  }
+  formatUpdate(task, changes) {
+    const lines = [];
+    lines.push(`\uD83D\uDD04 **Task #${task.id} 更新**`);
+    lines.push("");
+    lines.push(`- **任务**: ${this.truncate(task.title ?? "", 80)}`);
+    if (changes?.status) {
+      lines.push(`- **状态变更**: ${String(changes.status)}`);
+    }
+    if (changes?.progress !== undefined) {
+      lines.push(`- **进度变更**: ${String(changes.progress)}%`);
+    }
+    if (changes?.priority) {
+      lines.push(`- **优先级变更**: ${String(changes.priority)}`);
+    }
+    if (changes?.current_status) {
+      lines.push(`- **状态描述变更**: ${this.truncate(String(changes.current_status), 200)}`);
+    }
+    if (changes?.tags) {
+      const tags = Array.isArray(changes.tags) ? changes.tags.join(", ") : String(changes.tags);
+      lines.push(`- **标签变更**: ${tags}`);
+    }
+    if (changes?.goals_and_expected_deliverables) {
+      lines.push(`- **目标变更**: ${this.truncate(String(changes.goals_and_expected_deliverables), 200)}`);
+    }
+    if (task.progress !== undefined) {
+      lines.push(`- **当前进度**: ${task.progress}%`);
+    }
+    if (task.status) {
+      lines.push(`- **当前状态**: ${task.status}`);
+    }
+    if (task.current_status) {
+      lines.push(`- **当前状态描述**: ${this.truncate(task.current_status, 200)}`);
+    }
+    return lines.join(`
+`);
+  }
+  formatOperation(operation) {
+    const title = operation.milestoneTitle ?? operation.action_title ?? "操作记录";
+    const desc = operation.milestoneDescription ?? operation.action_description ?? "";
+    return [
+      `\uD83D\uDCCC **${this.truncate(title, 80)}**`,
+      "",
+      desc ? this.truncate(desc, 300) : ""
+    ].filter(Boolean).join(`
+`);
+  }
+  formatWelcomeMessage(task, chatId) {
+    const lines = [];
+    lines.push(`\uD83D\uDCCC **Task #${task.id} 已创建**`);
+    lines.push("");
+    lines.push(`此群聊用于追踪任务进度、记录里程碑、讨论细节。任务状态更新、进度变化、完成摘要都会发到这里。`);
+    lines.push("");
+    lines.push(`**任务信息**`);
+    lines.push(`- **任务 ID**: #${task.id}`);
+    lines.push(`- **标题**: ${this.truncate(task.title ?? "", 100)}`);
+    if (task.description) {
+      lines.push(`- **描述**: ${this.truncate(task.description, 200)}`);
+    }
+    if (task.priority) {
+      lines.push(`- **优先级**: ${task.priority}`);
+    }
+    if (task.status) {
+      lines.push(`- **状态**: ${task.status}`);
+    }
+    if (task.project_path) {
+      lines.push(`- **项目**: \`${task.project_path}\``);
+    }
+    lines.push(`- **创建时间**: ${new Date().toISOString()}`);
+    lines.push("");
+    lines.push(`\uD83D\uDCA1 在此群聊中发言会作为该 task 的输入。如需查看完整链接：\`https://applink.larkoffice.com/client/chat/chatDetail?chat_id=${chatId}\``);
+    return lines.join(`
+`);
+  }
+}
+__legacyDecorateClassTS([
+  TracedAs("per-task-group-chat.execute")
+], PerTaskGroupChatPlugin.prototype, "execute", null);
+__legacyDecorateClassTS([
+  TracedAs("per-task-group-chat.onAfterCreate", { recordParams: false })
+], PerTaskGroupChatPlugin.prototype, "onAfterCreate", null);
+__legacyDecorateClassTS([
+  TracedAs("per-task-group-chat.onAfterUpdate", { recordParams: false })
+], PerTaskGroupChatPlugin.prototype, "onAfterUpdate", null);
+__legacyDecorateClassTS([
+  TracedAs("per-task-group-chat.onAfterOperationCreate", { recordParams: false })
+], PerTaskGroupChatPlugin.prototype, "onAfterOperationCreate", null);
+__legacyDecorateClassTS([
+  TracedAs("per-task-group-chat.onAfterComplete", { recordParams: false })
+], PerTaskGroupChatPlugin.prototype, "onAfterComplete", null);
+__legacyDecorateClassTS([
+  TracedAs("per-task-group-chat.createGroupChat", {
+    recordParams: true,
+    recordResult: true,
+    flattenParamFilter: true,
+    paramFilter: (args) => ({
+      profile: args[0]?.profile,
+      botAppIdsCount: args[0]?.botAppIds?.length,
+      userIdsCount: args[0]?.userIds?.length ?? 0,
+      userIds: args[0]?.userIds,
+      name: args[0]?.name,
+      description: args[0]?.description
+    }),
+    resultFilter: (r) => ({
+      chatId: r,
+      ok: !!r
+    })
+  })
+], PerTaskGroupChatPlugin.prototype, "createGroupChat", null);
+__legacyDecorateClassTS([
+  TracedAs("per-task-group-chat.buildCreateGroupChatArgs", {
+    recordParams: false,
+    recordResult: true,
+    flattenParamFilter: true,
+    paramFilter: (args) => ({
+      hasProfile: !!args[0]?.profile,
+      botAppIdsCount: args[0]?.botAppIds?.length,
+      hasUsers: !!args[0]?.userIds?.length
+    }),
+    resultFilter: (r) => ({
+      argsSummary: r.join(" "),
+      hasAsBot: r.includes("--as") && r[r.indexOf("--as") + 1] === "bot",
+      hasBots: r.includes("--bots"),
+      hasUsers: r.includes("--users")
+    })
+  })
+], PerTaskGroupChatPlugin.prototype, "buildCreateGroupChatArgs", null);
+__legacyDecorateClassTS([
+  TracedAs("per-task-group-chat.attachChatIdToTask", {
+    recordParams: false,
+    flattenParamFilter: true,
+    paramFilter: (args) => ({
+      taskId: args[0]?.id,
+      chatId: args[1],
+      profile: args[2],
+      taskUpdaterInjected: !!args[0] && !!args[0].context
+    })
+  })
+], PerTaskGroupChatPlugin.prototype, "attachChatIdToTask", null);
+__legacyDecorateClassTS([
+  TracedAs("per-task-group-chat.sendToChat", {
+    recordParams: true,
+    recordError: true,
+    flattenParamFilter: true,
+    paramFilter: (args) => ({
+      chatId: args[0]?.chatId,
+      profile: args[0]?.profile,
+      contentLength: args[0]?.content?.length
+    })
+  })
+], PerTaskGroupChatPlugin.prototype, "sendToChat", null);
+__legacyDecorateClassTS([
+  TracedAs("per-task-group-chat.sendToMain", {
+    recordParams: true,
+    recordError: true,
+    flattenParamFilter: true,
+    paramFilter: (args) => ({
+      mode: args[0]?.messageId ? "reply" : "send",
+      chatId: args[0]?.messageId ? undefined : args[0]?.chatId,
+      profile: args[1]?.profile,
+      title: args[1]?.title
+    })
+  })
+], PerTaskGroupChatPlugin.prototype, "sendToMain", null);
+function createPerTaskGroupChatPlugin(config = {}) {
+  return new PerTaskGroupChatPlugin(config);
+}
+export { createAutoTaskPlugin, WORKFLOW_EXTRACTOR_PROMPT, formatExtractorInput, formatExtractorInputFromDescription, parseExtractorOutput, TaskTagPlugin, NotifyType, LarkCliTaskNotifyHook, createLarkCliTaskNotifyHook, PerTaskGroupChatPlugin, createPerTaskGroupChatPlugin };