galaxy-opc-plugin 0.2.0 → 0.2.2

package/src/opc/milestone-detector.ts

@@ -0,0 +1,251 @@
+/**
+ * 星环OPC中心 — 里程碑自动检测器
+ *
+ * 自动检测公司成就事件，写入 opc_celebrations 表。
+ * 检测逻辑确保同一成就只庆祝一次。
+ *
+ * 成就类型：
+ * - first_revenue        第一笔收入
+ * - revenue_10k          累计收入破万
+ * - revenue_50k          累计收入破5万
+ * - revenue_100k         累计收入破10万
+ * - revenue_500k         累计收入破50万
+ * - first_contract       第一份合同
+ * - first_customer       第一个客户
+ * - first_monthly_profit 首次月度盈利
+ * - project_completed    项目完成
+ * - canvas_complete      画布 100%
+ * - funding_closed       融资完成
+ */
+
+import type { OpcDatabase } from "../db/index.js";
+
+type CelebrationRow = { id: string };
+type CountRow = { cnt: number };
+type SumRow = { total: number };
+
+const OPB_CANVAS_FIELDS = [
+  "track", "target_customer", "pain_point", "solution",
+  "unique_value", "channels", "revenue_model", "cost_structure",
+  "key_resources", "key_activities", "key_partners", "unfair_advantage",
+  "metrics", "non_compete", "scaling_strategy", "notes",
+] as const;
+
+/** 检查某种庆祝是否已存在（防重复） */
+function celebrationExists(db: OpcDatabase, companyId: string, celebrationType: string): boolean {
+  const row = db.queryOne(
+    "SELECT id FROM opc_celebrations WHERE company_id = ? AND celebration_type = ?",
+    companyId, celebrationType,
+  ) as CelebrationRow | null;
+  return row !== null;
+}
+
+/** 写入庆祝记录 */
+function createCelebration(
+  db: OpcDatabase,
+  companyId: string,
+  celebrationType: string,
+  title: string,
+  message: string,
+  metricValue: number,
+): void {
+  db.execute(
+    `INSERT INTO opc_celebrations (id, company_id, celebration_type, title, message, metric_value, shown, created_at)
+     VALUES (?, ?, ?, ?, ?, ?, 0, datetime('now'))`,
+    db.genId(), companyId, celebrationType, title, message, metricValue,
+  );
+}
+
+/** 检测收入相关里程碑 */
+function checkRevenueMilestones(db: OpcDatabase, companyId: string, companyName: string, log: (msg: string) => void): void {
+  const totalIncome = (db.queryOne(
+    "SELECT COALESCE(SUM(amount), 0) as total FROM opc_transactions WHERE company_id = ? AND type = 'income'",
+    companyId,
+  ) as SumRow).total;
+
+  if (totalIncome <= 0) return;
+
+  // 第一笔收入
+  if (!celebrationExists(db, companyId, "first_revenue")) {
+    createCelebration(db, companyId, "first_revenue",
+      "第一笔收入！",
+      `恭喜「${companyName}」获得了第一笔收入 ${totalIncome.toLocaleString()} 元！万事开头难，这是最重要的一步。`,
+      totalIncome,
+    );
+    log(`opc-milestone: [${companyName}] 🎉 第一笔收入 ${totalIncome.toLocaleString()} 元`);
+  }
+
+  // 收入阈值里程碑
+  const thresholds: [number, string, string][] = [
+    [10_000, "revenue_10k", "累计收入突破 1 万元！"],
+    [50_000, "revenue_50k", "累计收入突破 5 万元！"],
+    [100_000, "revenue_100k", "累计收入突破 10 万元！"],
+    [500_000, "revenue_500k", "累计收入突破 50 万元！"],
+  ];
+
+  for (const [threshold, type, title] of thresholds) {
+    if (totalIncome >= threshold && !celebrationExists(db, companyId, type)) {
+      createCelebration(db, companyId, type, title,
+        `「${companyName}」累计收入达到 ${totalIncome.toLocaleString()} 元，突破 ${(threshold / 10000).toFixed(0)} 万元大关！`,
+        totalIncome,
+      );
+      log(`opc-milestone: [${companyName}] 🎉 ${title}`);
+    }
+  }
+}
+
+/** 检测首次月度盈利 */
+function checkMonthlyProfit(db: OpcDatabase, companyId: string, companyName: string, log: (msg: string) => void): void {
+  if (celebrationExists(db, companyId, "first_monthly_profit")) return;
+
+  const row = db.queryOne(
+    `SELECT strftime('%Y-%m', transaction_date) as month,
+       SUM(CASE WHEN type='income' THEN amount ELSE 0 END) as income,
+       SUM(CASE WHEN type='expense' THEN amount ELSE 0 END) as expense
+     FROM opc_transactions
+     WHERE company_id = ?
+     GROUP BY month
+     HAVING income > 0 AND income > expense
+     LIMIT 1`,
+    companyId,
+  ) as { month: string; income: number; expense: number } | null;
+
+  if (row) {
+    const profit = row.income - row.expense;
+    createCelebration(db, companyId, "first_monthly_profit",
+      "首次月度盈利！",
+      `「${companyName}」在 ${row.month} 首次实现月度盈利，净利润 ${profit.toLocaleString()} 元！`,
+      profit,
+    );
+    log(`opc-milestone: [${companyName}] 🎉 首次月度盈利 ${profit.toLocaleString()} 元`);
+  }
+}
+
+/** 检测合同里程碑 */
+function checkContractMilestones(db: OpcDatabase, companyId: string, companyName: string, log: (msg: string) => void): void {
+  if (celebrationExists(db, companyId, "first_contract")) return;
+
+  const cnt = (db.queryOne(
+    "SELECT COUNT(*) as cnt FROM opc_contracts WHERE company_id = ?",
+    companyId,
+  ) as CountRow).cnt;
+
+  if (cnt > 0) {
+    createCelebration(db, companyId, "first_contract",
+      "第一份合同！",
+      `「${companyName}」签订了第一份正式合同！业务正在走上正轨。`,
+      cnt,
+    );
+    log(`opc-milestone: [${companyName}] 🎉 第一份合同`);
+  }
+}
+
+/** 检测客户里程碑 */
+function checkCustomerMilestones(db: OpcDatabase, companyId: string, companyName: string, log: (msg: string) => void): void {
+  if (celebrationExists(db, companyId, "first_customer")) return;
+
+  const cnt = (db.queryOne(
+    "SELECT COUNT(*) as cnt FROM opc_contacts WHERE company_id = ?",
+    companyId,
+  ) as CountRow).cnt;
+
+  if (cnt > 0) {
+    createCelebration(db, companyId, "first_customer",
+      "客户池开始建立！",
+      `「${companyName}」添加了第一个客户/联系人，客户池正在建立中。`,
+      cnt,
+    );
+    log(`opc-milestone: [${companyName}] 🎉 第一个客户`);
+  }
+}
+
+/** 检测项目完成里程碑 */
+function checkProjectCompleted(db: OpcDatabase, companyId: string, companyName: string, log: (msg: string) => void): void {
+  // 找到近期完成的项目且尚未庆祝的
+  const completedProjects = db.query(
+    `SELECT id, name FROM opc_projects
+     WHERE company_id = ? AND status = 'completed'`,
+    companyId,
+  ) as { id: string; name: string }[];
+
+  for (const proj of completedProjects) {
+    const cType = `project_completed_${proj.id}`;
+    if (celebrationExists(db, companyId, cType)) continue;
+
+    createCelebration(db, companyId, cType,
+      `项目完成：${proj.name}`,
+      `「${companyName}」的项目「${proj.name}」顺利完成！`,
+      1,
+    );
+    log(`opc-milestone: [${companyName}] 🎉 项目完成: ${proj.name}`);
+  }
+}
+
+/** 检测画布完成度 */
+function checkCanvasComplete(db: OpcDatabase, companyId: string, companyName: string, log: (msg: string) => void): void {
+  if (celebrationExists(db, companyId, "canvas_complete")) return;
+
+  const canvas = db.queryOne(
+    "SELECT * FROM opc_opb_canvas WHERE company_id = ?",
+    companyId,
+  ) as Record<string, string> | null;
+
+  if (!canvas) return;
+
+  const filled = OPB_CANVAS_FIELDS.filter(f => canvas[f] && canvas[f].trim() !== "").length;
+  if (filled >= OPB_CANVAS_FIELDS.length) {
+    createCelebration(db, companyId, "canvas_complete",
+      "商业画布规划完成！",
+      `「${companyName}」的 OPB 商业画布 ${OPB_CANVAS_FIELDS.length} 个字段已全部填写完成！商业模式规划圆满。`,
+      OPB_CANVAS_FIELDS.length,
+    );
+    log(`opc-milestone: [${companyName}] 🎉 OPB 画布完成`);
+  }
+}
+
+/** 检测融资完成 */
+function checkFundingClosed(db: OpcDatabase, companyId: string, companyName: string, log: (msg: string) => void): void {
+  const closedRounds = db.query(
+    "SELECT id, round_name, amount FROM opc_investment_rounds WHERE company_id = ? AND status = 'closed'",
+    companyId,
+  ) as { id: string; round_name: string; amount: number }[];
+
+  for (const round of closedRounds) {
+    const cType = `funding_closed_${round.id}`;
+    if (celebrationExists(db, companyId, cType)) continue;
+
+    createCelebration(db, companyId, cType,
+      `融资完成：${round.round_name}`,
+      `「${companyName}」的${round.round_name}成功关闭，融资金额 ${round.amount.toLocaleString()} 元！`,
+      round.amount,
+    );
+    log(`opc-milestone: [${companyName}] 🎉 融资完成: ${round.round_name}`);
+  }
+}
+
+/** 检测单个公司的所有里程碑 */
+export function detectMilestones(db: OpcDatabase, companyId: string, log: (msg: string) => void): void {
+  try {
+    const company = db.getCompany(companyId);
+    if (!company) return;
+    const name = company.name;
+
+    checkRevenueMilestones(db, companyId, name, log);
+    checkMonthlyProfit(db, companyId, name, log);
+    checkContractMilestones(db, companyId, name, log);
+    checkCustomerMilestones(db, companyId, name, log);
+    checkProjectCompleted(db, companyId, name, log);
+    checkCanvasComplete(db, companyId, name, log);
+    checkFundingClosed(db, companyId, name, log);
+  } catch (err) {
+    log(`opc-milestone: 检测异常 [${companyId}]: ${err instanceof Error ? err.message : String(err)}`);
+  }
+}
+
+/** 检测所有公司的里程碑 */
+export function detectMilestonesForAll(db: OpcDatabase, log: (msg: string) => void): void {
+  const companies = db.query("SELECT id FROM opc_companies") as { id: string }[];
+  for (const c of companies) {
+    detectMilestones(db, c.id, log);
+  }
+}

package/src/opc/proactive-service.ts

@@ -0,0 +1,179 @@
+/**
+ * 星环OPC中心 — 主动智能后台服务
+ *
+ * 统一调度所有后台扫描任务，替代单独的 startReminderService。
+ * 30 秒后首次扫描，之后每小时执行：
+ * 1. runReminderScan()           — 已有的 4 项检查（税务、合同、现金流、融资）
+ * 2. recalculateAllStages()      — 阶段检测
+ * 3. runIntelligenceScan()       — 智能洞察分析
+ * 4. detectMilestonesForAll()    — 里程碑检测
+ * 5. expireStaleInsights()       — 清理过期洞察
+ * 6. saveDailyBriefings()        — 保存每日简报快照
+ * 7. createScheduledStaffTasks() — 创建定时员工任务（pending，等 AI 触发）
+ * 8. reapStaleTasks()             — 清理超时的 in_progress 任务（subagent 异常未被钩子捕获时的兜底）
+ */
+
+import type { OpcDatabase } from "../db/index.js";
+import { runReminderScan } from "./reminder-service.js";
+import { runIntelligenceScan, expireStaleInsights } from "./intelligence-engine.js";
+import { detectMilestonesForAll } from "./milestone-detector.js";
+import { recalculateAllStages } from "./stage-detector.js";
+import { saveDailyBriefing } from "./briefing-builder.js";
+import { TaskExecutor } from "./task-executor.js";
+import { alertsToStaffTasks, insightsToStaffTasks } from "./event-triggers.js";
+
+/** 为所有公司保存每日简报快照 */
+function saveDailyBriefings(db: OpcDatabase, log: (msg: string) => void): void {
+  const companies = db.query("SELECT id FROM opc_companies") as { id: string }[];
+  let saved = 0;
+  for (const c of companies) {
+    try {
+      saveDailyBriefing(db, c.id);
+      saved++;
+    } catch (err) {
+      log(`opc-proactive: 保存简报失败 [${c.id}]: ${err instanceof Error ? err.message : String(err)}`);
+    }
+  }
+  if (saved > 0) log(`opc-proactive: 已保存 ${saved} 家公司的每日简报快照`);
+}
+
+/** 创建定时员工任务（pending 状态，等 AI 触发执行） */
+function createScheduledStaffTasks(db: OpcDatabase, log: (msg: string) => void): void {
+  const executor = new TaskExecutor(db);
+
+  // 检查今日是否已创建过 daily 任务
+  const lastDailyRun = db.queryOne(
+    "SELECT value FROM opc_tool_config WHERE key = 'last_daily_task_run'",
+  ) as { value: string } | null;
+  const today = new Date().toISOString().slice(0, 10);
+
+  if (!lastDailyRun || lastDailyRun.value !== today) {
+    const dailyCount = executor.createPendingScheduledTasks("daily");
+    if (dailyCount > 0) {
+      log(`opc-executor: 已创建 ${dailyCount} 个每日定时任务（pending）`);
+    }
+    db.execute(
+      `INSERT INTO opc_tool_config (key, value) VALUES ('last_daily_task_run', ?)
+       ON CONFLICT(key) DO UPDATE SET value = excluded.value`,
+      today,
+    );
+  }
+
+  // 每周一创建 weekly 任务
+  const dayOfWeek = new Date().getDay();
+  if (dayOfWeek === 1) {
+    const lastWeeklyRun = db.queryOne(
+      "SELECT value FROM opc_tool_config WHERE key = 'last_weekly_task_run'",
+    ) as { value: string } | null;
+    if (!lastWeeklyRun || lastWeeklyRun.value !== today) {
+      const weeklyCount = executor.createPendingScheduledTasks("weekly");
+      if (weeklyCount > 0) {
+        log(`opc-executor: 已创建 ${weeklyCount} 个每周定时任务（pending）`);
+      }
+      db.execute(
+        `INSERT INTO opc_tool_config (key, value) VALUES ('last_weekly_task_run', ?)
+         ON CONFLICT(key) DO UPDATE SET value = excluded.value`,
+        today,
+      );
+    }
+  }
+}
+
+/** 清理超过 2 小时仍 in_progress 且有 session_key 的任务（subagent_ended 未触发时的兜底） */
+function reapStaleTasks(db: OpcDatabase, log: (msg: string) => void): void {
+  try {
+    const staleTasks = db.query(
+      `SELECT id, company_id, staff_role, title FROM opc_staff_tasks
+       WHERE status = 'in_progress'
+         AND session_key != ''
+         AND started_at != ''
+         AND started_at < datetime('now', '-2 hours')`,
+    ) as { id: string; company_id: string; staff_role: string; title: string }[];
+
+    if (staleTasks.length === 0) return;
+
+    const now = new Date().toISOString();
+    for (const task of staleTasks) {
+      db.execute(
+        `UPDATE opc_staff_tasks SET status = 'cancelled', completed_at = ?,
+         result_summary = '[系统] 任务执行超时（超过2小时未完成），已自动取消'
+         WHERE id = ? AND status = 'in_progress'`,
+        now, task.id,
+      );
+    }
+
+    log(`opc-proactive: 已清理 ${staleTasks.length} 个超时任务（in_progress 超过2小时）`);
+  } catch (err) {
+    log(`opc-proactive: 清理超时任务异常: ${err instanceof Error ? err.message : String(err)}`);
+  }
+}
+
+/** 执行一次完整的主动扫描 */
+function runFullScan(db: OpcDatabase, log: (msg: string) => void, webhookUrl?: string): void {
+  try {
+    log("opc-proactive: 开始全量扫描...");
+
+    // 1. 原有提醒扫描
+    runReminderScan(db, log, webhookUrl);
+
+    // 2. 阶段检测（先于洞察分析，因为 generateNextSteps 依赖阶段）
+    recalculateAllStages(db, log);
+
+    // 3. 智能洞察分析
+    runIntelligenceScan(db, log);
+
+    // 4. 里程碑检测
+    detectMilestonesForAll(db, log);
+
+    // 5. 清理过期洞察
+    expireStaleInsights(db, log);
+
+    // 6. 保存每日简报快照
+    saveDailyBriefings(db, log);
+
+    // 7. 创建定时员工任务
+    createScheduledStaffTasks(db, log);
+
+    // 8. 清理超时的 in_progress 任务
+    reapStaleTasks(db, log);
+
+    // 9. 将新告警自动分配给对应 AI 员工
+    alertsToStaffTasks(db, log);
+
+    // 10. 将可执行洞察转化为员工待办
+    insightsToStaffTasks(db, log);
+
+    log("opc-proactive: 全量扫描完成");
+  } catch (err) {
+    log(`opc-proactive: 扫描异常: ${err instanceof Error ? err.message : String(err)}`);
+  }
+}
+
+/**
+ * 启动主动智能后台服务，返回停止函数。
+ * 30 秒后首次扫描，之后每小时重复。
+ */
+export function startProactiveService(
+  db: OpcDatabase,
+  log: (msg: string) => void,
+  webhookUrl?: string,
+  intervalMs = 3600_000,
+): () => void {
+  // 延迟 30 秒首次扫描
+  log("opc-proactive: 首次全量扫描将在 30 秒后启动（阶段检测 + 智能洞察 + 里程碑检测）");
+  const initTimer = setTimeout(() => {
+    log("opc-proactive: 首次全量扫描启动");
+    runFullScan(db, log, webhookUrl);
+  }, 30_000);
+
+  // 每小时周期性扫描
+  const interval = setInterval(() => {
+    runFullScan(db, log, webhookUrl);
+  }, intervalMs);
+
+  return () => {
+    clearTimeout(initTimer);
+    clearInterval(interval);
+    log("opc-proactive: 主动智能服务已停止");
+  };
+}

package/src/opc/reminder-service.ts

@@ -9,8 +9,6 @@
  * 防重复：同一公司同一类别同一周期内不重复写入。
  */
 
-import https from "node:https";
-import http from "node:http";
 import type { OpcDatabase } from "../db/index.js";
 
 type AlertRow = { id: string; company_id: string; category: string; title: string };
@@ -68,42 +66,9 @@ function createAlert(db: OpcDatabase, params: {
   );
 }
 
-/** 向飞书/企业微信 Webhook 推送一条文本消息（fire-and-forget） */
-function sendWebhook(url: string, text: string, log: (msg: string) => void): void {
-  try {
-    const isFeishu = url.includes("feishu.cn") || url.includes("larksuite.com");
-    const body = isFeishu
-      ? JSON.stringify({ msg_type: "text", content: { text } })
-      : JSON.stringify({ msgtype: "text", text: { content: text } });
-
-    const parsed = new URL(url);
-    const transport = parsed.protocol === "https:" ? https : http;
-    const req = transport.request(
-      {
-        hostname: parsed.hostname,
-        port: parsed.port || (parsed.protocol === "https:" ? 443 : 80),
-        path: parsed.pathname + parsed.search,
-        method: "POST",
-        headers: { "Content-Type": "application/json", "Content-Length": Buffer.byteLength(body) },
-      },
-      (res) => {
-        res.resume(); // drain response
-        if (res.statusCode && res.statusCode >= 400) {
-          log(`opc-reminder: Webhook 响应异常 (${res.statusCode})`);
-        }
-      },
-    );
-    req.on("error", (err) => log(`opc-reminder: Webhook 请求失败: ${err.message}`));
-    req.write(body);
-    req.end();
-  } catch (err) {
-    log(`opc-reminder: Webhook 发送异常: ${err instanceof Error ? err.message : String(err)}`);
-  }
-}
-
 // ── 检查项 1：税务申报到期提醒 ────────────────────────────────
 
-function checkTaxDeadlines(db: OpcDatabase, log: (msg: string) => void, webhookUrl?: string): number {
+function checkTaxDeadlines(db: OpcDatabase, log: (msg: string) => void, _webhookUrl?: string): number {
   let count = 0;
   const rows = db.query(
     `SELECT t.*, c.name as company_name FROM opc_tax_filings t
@@ -130,14 +95,13 @@ function checkTaxDeadlines(db: OpcDatabase, log: (msg: string) => void, webhookU
     createAlert(db, { companyId: row.company_id, title, message, severity, category: "tax" });
     count++;
     log(`opc-reminder: 税务提醒 [${row.company_name}] ${title}`);
-    if (webhookUrl) sendWebhook(webhookUrl, `【税务提醒】${title}\n${message}`, log);
   }
   return count;
 }
 
 // ── 检查项 2：合同到期提醒 ─────────────────────────────────────
 
-function checkContractExpiry(db: OpcDatabase, log: (msg: string) => void, webhookUrl?: string): number {
+function checkContractExpiry(db: OpcDatabase, log: (msg: string) => void, _webhookUrl?: string): number {
   let count = 0;
   const rows = db.query(
     `SELECT t.*, c.name as company_name FROM opc_contracts t
@@ -164,14 +128,13 @@ function checkContractExpiry(db: OpcDatabase, log: (msg: string) => void, webhoo
     createAlert(db, { companyId: row.company_id, title, message, severity, category: "contract" });
     count++;
     log(`opc-reminder: 合同提醒 [${row.company_name}] ${title}`);
-    if (webhookUrl) sendWebhook(webhookUrl, `【合同提醒】${title}\n${message}`, log);
   }
   return count;
 }
 
 // ── 检查项 3：现金流预警 ──────────────────────────────────────
 
-function checkCashFlow(db: OpcDatabase, log: (msg: string) => void, webhookUrl?: string): number {
+function checkCashFlow(db: OpcDatabase, log: (msg: string) => void, _webhookUrl?: string): number {
   let count = 0;
   const start = daysAgo(30);
   const companies = db.query(
@@ -207,14 +170,13 @@ function checkCashFlow(db: OpcDatabase, log: (msg: string) => void, webhookUrl?:
     });
     count++;
     log(`opc-reminder: 现金流预警 [${company.name}] 净流出 ${Math.abs(net).toLocaleString()} 元`);
-    if (webhookUrl) sendWebhook(webhookUrl, `【现金流预警】${company.name} 近30天净流出 ${Math.abs(net).toLocaleString()} 元，请及时关注资金状况。`, log);
   }
   return count;
 }
 
 // ── 检查项 4：投资轮次跟进提醒 ──────────────────────────────────
 
-function checkInvestmentRounds(db: OpcDatabase, log: (msg: string) => void, webhookUrl?: string): number {
+function checkInvestmentRounds(db: OpcDatabase, log: (msg: string) => void, _webhookUrl?: string): number {
   let count = 0;
   // 找出 close_date 在7天内的活跃融资轮
   const rows = db.query(
@@ -241,7 +203,6 @@ function checkInvestmentRounds(db: OpcDatabase, log: (msg: string) => void, webh
     createAlert(db, { companyId: row.company_id, title, message, severity, category: "investment" });
     count++;
     log(`opc-reminder: 融资提醒 [${row.company_name}] ${title}`);
-    if (webhookUrl) sendWebhook(webhookUrl, `【融资提醒】${title}\n${message}`, log);
   }
   return count;
 }

package/src/opc/session-task-tracker.ts

@@ -0,0 +1,60 @@
+/**
+ * 星环OPC中心 — 会话-任务映射管理器
+ *
+ * 追踪 sessions_spawn 创建的子会话与 OPC 任务之间的对应关系。
+ * 当 subagent_ended 触发时，通过 childSessionKey 查找对应任务并自动更新状态。
+ *
+ * 内存 Map 作为热缓存，数据库 session_key 列作为持久化。
+ */
+
+export interface SessionTaskMapping {
+  taskId: string;
+  companyId: string;
+  staffRole: string;
+  title: string;
+  runId?: string;
+  spawnedAt: string;
+}
+
+/** 内存映射：childSessionKey → 任务信息 */
+const sessionMap = new Map<string, SessionTaskMapping>();
+
+/**
+ * 注册一个 spawn 出的子会话与任务的映射关系。
+ */
+export function registerSpawnedSession(
+  childSessionKey: string,
+  mapping: SessionTaskMapping,
+): void {
+  sessionMap.set(childSessionKey, mapping);
+}
+
+/**
+ * 根据 childSessionKey 查找对应的任务映射。
+ */
+export function getSessionTaskMapping(
+  childSessionKey: string,
+): SessionTaskMapping | undefined {
+  return sessionMap.get(childSessionKey);
+}
+
+/**
+ * 移除已完成/已取消的会话映射。
+ */
+export function removeSessionTaskMapping(childSessionKey: string): void {
+  sessionMap.delete(childSessionKey);
+}
+
+/**
+ * 获取当前所有活跃的会话映射数量（用于调试/监控）。
+ */
+export function getActiveSessionCount(): number {
+  return sessionMap.size;
+}
+
+/**
+ * 清理所有映射（服务停止时调用）。
+ */
+export function clearAllSessionMappings(): void {
+  sessionMap.clear();
+}