agentquad 0.4.5 → 0.4.8

package/src/mcp/tools/destructive/index.js

@@ -195,12 +195,15 @@ export function registerDestructiveTools(server, { db, audit }) {
     'bulk_update',
     {
       description:
-        '对一组 todo id 批量 patch。允许字段：quadrant / status / archived / dueDate。默认 confirm:false 返回 preview（列出将要修改的 todos，最多 20 条）。',
+        '对一组 todo id 批量 patch。允许字段：status / archived / dueDate。' +
+        '（quadrant 字段保留接口以兼容旧调用方，传入会被忽略。）' +
+        '默认 confirm:false 返回 preview（列出将要修改的 todos，最多 20 条）。',
       inputSchema: {
         ids: z.array(z.string().min(1)).min(1),
         patch: z
           .object({
-            quadrant: z.number().int().min(1).max(4).optional(),
+            quadrant: z.number().int().min(1).max(4).optional()
+              .describe('【已退役】象限概念已移除，传入会被忽略'),
             status: z.enum(['todo', 'done']).optional(),
             archived: z.boolean().optional(),
             dueDate: z.number().int().nullable().optional(),
@@ -211,40 +214,43 @@ export function registerDestructiveTools(server, { db, audit }) {
       },
     },
     async (args) => {
+      // 剥掉退役字段，避免 db 层试图写 quadrant
+      const { quadrant: _ignored, ...effectivePatch } = args.patch || {}
+      const sanitizedArgs = { ...args, patch: effectivePatch }
       try {
         const preview = {
-          ids: args.ids,
-          patch: args.patch,
+          ids: sanitizedArgs.ids,
+          patch: sanitizedArgs.patch,
           affected: [],
           missing: [],
         }
-        for (const id of args.ids.slice(0, 20)) {
+        for (const id of sanitizedArgs.ids.slice(0, 20)) {
           const t = db.getTodo(id)
-          if (t) preview.affected.push({ id: t.id, title: t.title, quadrant: t.quadrant, status: t.status })
+          if (t) preview.affected.push({ id: t.id, title: t.title, status: t.status })
           else preview.missing.push(id)
         }
-        preview.totalTargeted = args.ids.length
-        preview.previewTruncated = args.ids.length > 20
-        if (!args.confirm) {
-          const patchKeys = Object.keys(args.patch).join(', ')
+        preview.totalTargeted = sanitizedArgs.ids.length
+        preview.previewTruncated = sanitizedArgs.ids.length > 20
+        if (!sanitizedArgs.confirm) {
+          const patchKeys = Object.keys(sanitizedArgs.patch).join(', ') || '(空 — quadrant 已退役)'
           return previewResponse({
             toolName: 'bulk_update',
-            summary: `将对 ${args.ids.length} 条 todo 批量 patch 以下字段：${patchKeys}。命中 ${preview.affected.length} 条、未找到 ${preview.missing.length} 条。`,
+            summary: `将对 ${sanitizedArgs.ids.length} 条 todo 批量 patch 以下字段：${patchKeys}。命中 ${preview.affected.length} 条、未找到 ${preview.missing.length} 条。`,
             impact: preview,
-            args,
+            args: sanitizedArgs,
           })
         }
-        const result = db.bulkUpdateTodos({ ids: args.ids, patch: args.patch })
+        const result = db.bulkUpdateTodos({ ids: sanitizedArgs.ids, patch: sanitizedArgs.patch })
         audit?.append({
           tool: 'bulk_update',
           ok: true,
-          args: { ids: args.ids, patch: args.patch },
+          args: { ids: sanitizedArgs.ids, patch: sanitizedArgs.patch },
           result: { changedCount: result.count, changedIds: result.changedIds },
-          confirmNote: args.confirmNote || null,
+          confirmNote: sanitizedArgs.confirmNote || null,
         })
         return asText({ ok: true, result })
       } catch (e) {
-        audit?.append({ tool: 'bulk_update', ok: false, args: { ids: args.ids, patch: args.patch }, error: e?.message })
+        audit?.append({ tool: 'bulk_update', ok: false, args: { ids: sanitizedArgs.ids, patch: sanitizedArgs.patch }, error: e?.message })
         return asError(e?.message || 'bulk_update_failed')
       }
     },

package/src/mcp/tools/openclaw/index.js

@@ -1,10 +1,10 @@
 /**
- * OpenClaw 双向桥接的 MCP 工具集（8 个）：
+ * OpenClaw 双向桥接的 MCP 工具集：
  *
  * 创建任务向导（OpenClaw skill 调）：
  *   - list_workdir_options
- *   - list_quadrants
- *   - list_templates
+ *   - list_quadrants       （已废弃，仅为兼容旧 skill；返回空数组 + deprecated 标记）
+ *   - list_templates       （用户面叫 "agent / 员工"，工具名保留向后兼容）
  *
  * 启动 PTY（OpenClaw skill 调）：
  *   - start_ai_session
@@ -37,13 +37,6 @@ function asError(message, extra = null) {
   }
 }
 
-const QUADRANTS = [
-  { id: 1, label: '重要紧急', shortLabel: 'Q1', isDefault: false },
-  { id: 2, label: '重要不紧急', shortLabel: 'Q2', isDefault: true },
-  { id: 3, label: '紧急不重要', shortLabel: 'Q3', isDefault: false },
-  { id: 4, label: '不重要不紧急', shortLabel: 'Q4', isDefault: false },
-]
-
 function expandHome(p) {
   if (!p) return p
   if (p === '~' || p.startsWith('~/')) return p === '~' ? homedir() : join(homedir(), p.slice(2))
@@ -105,22 +98,25 @@ export function registerOpenClawTools(server, deps) {
     },
   )
 
-  // ─── 2. list_quadrants ──────────────────────────────────────────
+  // ─── 2. list_quadrants（已废弃；保留以兼容旧版 OpenClaw skill）──
   server.registerTool(
     'list_quadrants',
     {
-      description: '返回 4 个象限的元数据（id/label/isDefault），创建向导第二步用。',
+      description:
+        '【已废弃】象限概念已从 AgentQuad 移除。本工具仅为兼容旧 skill 而保留，' +
+        '返回空数组 + deprecated 标记。新创建任务无需再选象限。',
       inputSchema: {},
     },
-    async () => asText({ quadrants: QUADRANTS }),
+    async () => asText({ quadrants: [], deprecated: true }),
   )
 
-  // ─── 3. list_templates ──────────────────────────────────────────
+  // ─── 3. list_templates (用户面叫 agent / 员工) ─────────────────────
   server.registerTool(
     'list_templates',
     {
       description:
-        '返回所有提示词模板（id/name/description/builtin/contentPreview），创建向导第三步用。' +
+        '返回所有可指派的 agent / 员工（id/name/description/builtin/contentPreview），' +
+        '创建向导选 agent 那一步用。' +
         '完整 content 不返回（避免上下文爆）；启动会话时按 templateId 自动注入。',
       inputSchema: {},
     },
@@ -315,7 +311,7 @@ export function registerOpenClawTools(server, deps) {
           // 拼按钮失败不阻塞；纯文本兜底（用户照样能数字回复）
         }
 
-        const sendResult = await openclaw.postText({
+        const sendResult = await openclaw.broadcastText({
           sessionId,
           message: lines.join('\n'),
           replyMarkup: askUserMarkup,

package/src/mcp/tools/read/index.js

@@ -53,7 +53,8 @@ export function registerReadTools(server, { db, searchService, wikiDir, transcri
       description:
         '按过滤条件列出 todos。不做全文搜索——用 search 做模糊搜索。返回元数据数组，不含 AI 会话详情（用 get_todo 取）。',
       inputSchema: {
-        quadrant: z.number().int().min(1).max(4).optional().describe('1=重要且紧急 2=重要不紧急 3=紧急不重要 4=不重要不紧急'),
+        quadrant: z.number().int().min(1).max(4).optional()
+          .describe('【已退役】象限概念已移除；保留参数用于兼容旧调用方，传入会被忽略'),
         status: z.enum(['todo', 'done', 'all']).optional().describe('默认 all'),
         archived: z.union([z.boolean(), z.literal('all')]).optional().describe('默认 false 只看未归档；"all" 两者都要'),
         parentId: z.string().optional().describe('仅列某 parent 下的子任务'),
@@ -63,8 +64,8 @@ export function registerReadTools(server, { db, searchService, wikiDir, transcri
     async (args = {}) => {
       try {
         const rawStatus = args.status === 'all' ? '' : args.status
+        // quadrant 已退役，不再透传 db 层
         const list = db.listTodos({
-          quadrant: args.quadrant,
           status: rawStatus,
           archived: args.archived,
         })
@@ -78,7 +79,6 @@ export function registerReadTools(server, { db, searchService, wikiDir, transcri
           id: t.id,
           parentId: t.parentId,
           title: t.title,
-          quadrant: t.quadrant,
           status: t.status,
           dueDate: t.dueDate,
           workDir: t.workDir,
@@ -151,7 +151,7 @@ export function registerReadTools(server, { db, searchService, wikiDir, transcri
     'get_stats',
     {
       description:
-        '一个当前快照：按象限/状态的分布、今日截止、本周完成、最近 7 天活跃度、归档数量。轻量实时计算。',
+        '一个当前快照：按 todo 状态分布、今日截止、本周完成、最近 7 天活跃度、归档数量。轻量实时计算。',
       inputSchema: {},
     },
     async () => {
@@ -162,15 +162,15 @@ export function registerReadTools(server, { db, searchService, wikiDir, transcri
         const all = db.listTodos({ archived: 'all' })
         const open = all.filter((t) => t.status !== 'done' && t.status !== 'missed' && t.archivedAt == null)
         const archivedCount = all.filter((t) => t.archivedAt != null).length
-        const byQuadrant = {}
-        for (const t of open) byQuadrant[t.quadrant] = (byQuadrant[t.quadrant] || 0) + 1
+        const byStatus = {}
+        for (const t of open) byStatus[t.status] = (byStatus[t.status] || 0) + 1
         const overdue = open.filter((t) => t.dueDate && t.dueDate < now)
         const dueToday = open.filter((t) => t.dueDate && t.dueDate >= startOfDay.getTime() && t.dueDate < startOfDay.getTime() + 86_400_000)
         const weekDone = db.listCompletedTodos({ since: startOfWeek.getTime(), until: now + 1 })
         return asText({
           openCount: open.length,
           archivedCount,
-          byQuadrant,
+          byStatus,
           overdue: { count: overdue.length, ids: overdue.slice(0, 10).map((t) => t.id) },
           dueToday: { count: dueToday.length, ids: dueToday.map((t) => t.id) },
           completedThisWeek: weekDone.length,

package/src/mcp/tools/write/index.js

@@ -23,12 +23,14 @@ export function registerWriteTools(server, { db }) {
     'create_todo',
     {
       description:
-        '新建一条 todo。至少需要 title + quadrant。象限语义：1=重要且紧急，2=重要不紧急，3=紧急不重要，4=不重要不紧急。',
+        '新建一条 todo。只需 title。' +
+        '（quadrant 字段已退役但接口仍接受以兼容旧调用方；传入会被忽略，DB 写入默认值。）',
       inputSchema: {
         title: z.string().min(1).describe('标题，必填'),
-        quadrant: z.number().int().min(1).max(4).describe('1 / 2 / 3 / 4'),
+        quadrant: z.number().int().min(1).max(4).optional()
+          .describe('【已退役】象限概念已移除，传入会被忽略'),
         description: z.string().optional(),
-        parentId: z.string().optional().describe('如果是子任务，指定父 todo id（子任务会继承父的象限）'),
+        parentId: z.string().optional().describe('已退役：子任务概念已从 UI 移除；接口保留但不再分组展示'),
         dueDate: z.number().int().optional().describe('截止时间戳（毫秒 epoch）'),
         workDir: z.string().optional().describe('关联的代码仓路径'),
         brainstorm: z.boolean().optional(),
@@ -39,7 +41,7 @@ export function registerWriteTools(server, { db }) {
         if (!args.title?.trim()) return asError('title_required')
         const created = db.createTodo({
           title: args.title.trim(),
-          quadrant: args.quadrant,
+          // quadrant 不再透传 —— 让 db 层用默认值
           description: args.description || '',
           parentId: args.parentId,
           dueDate: args.dueDate,
@@ -63,7 +65,8 @@ export function registerWriteTools(server, { db }) {
         id: z.string().min(1),
         title: z.string().optional(),
         description: z.string().optional(),
-        quadrant: z.number().int().min(1).max(4).optional(),
+        quadrant: z.number().int().min(1).max(4).optional()
+          .describe('【已退役】象限概念已移除，传入会被忽略'),
         dueDate: z.number().int().nullable().optional().describe('传 null 显式清除'),
         workDir: z.string().nullable().optional(),
         parentId: z.string().nullable().optional().describe('传 null 升为顶层 todo'),
@@ -71,7 +74,7 @@ export function registerWriteTools(server, { db }) {
     },
     async (args) => {
       try {
-        const { id, ...patch } = args
+        const { id, quadrant: _ignored, ...patch } = args
         if (!id) return asError('id_required')
         // 禁止通过此工具改 status，status 变更有专用工具（complete/archive）
         const cleanPatch = {}

package/src/openclaw-bridge.js

@@ -132,6 +132,7 @@ export function createOpenClawBridge({
   telegramSender = sendViaTelegramAPI,                // 测试用：可 mock fake fetch
   telegramBot: initialTelegramBot = null,              // 可选：用于 sendDocument 附件
   larkBot: initialLarkBot = null,
+  getRoutesForSession = null,                          // 注入：读 db 双路由（telegram + lark），broadcastEcho 用
 } = {}) {
   let telegramBot = initialTelegramBot
   let larkBot = initialLarkBot
@@ -140,7 +141,8 @@ export function createOpenClawBridge({
 
   // 出站限流环形缓冲：每分钟 ≤ rateLimitPerMin 条
   const sendTimestamps = []
-  // sessionId → { targetUserId, account, channel }
+  // sessionId → Map<channel, route> —— 一个 session 可同时绑 telegram + lark + weixin
+  // Map 保留插入顺序，"最新注册的那条"可以靠遍历最后一个值拿到，用于无 channel hint 的 fallback。
   const sessionRoutes = new Map()
   // peerUserId → { sessionId, sentAt } — 最近一次推到该 peer 的 session
   // 用于 PTY stdin proxy：用户在微信回话时知道往哪个 PTY 写
@@ -168,18 +170,38 @@ export function createOpenClawBridge({
     sendTimestamps.push(nowMs())
   }
 
+  function getRoutesInner(sessionId) {
+    return sessionRoutes.get(sessionId) || null
+  }
+
+  function ensureRoutesInner(sessionId) {
+    let inner = sessionRoutes.get(sessionId)
+    if (!inner) {
+      inner = new Map()
+      sessionRoutes.set(sessionId, inner)
+    }
+    return inner
+  }
+
+  function allRoutesForSession(sessionId) {
+    const inner = getRoutesInner(sessionId)
+    return inner ? Array.from(inner.values()) : []
+  }
+
   function registerSessionRoute(sessionId, { targetUserId, account, channel, threadId, rootMessageId, topicName, triggerMessageId, messageAppLink } = {}) {
     if (!sessionId || !targetUserId) return
-    sessionRoutes.set(sessionId, {
+    const effectiveChannel = channel || getOpenClawConfig().channel || 'openclaw-weixin'
+    const route = {
       targetUserId,
       account: account || null,
-      channel: channel || getOpenClawConfig().channel || 'openclaw-weixin',
-      threadId: threadId != null ? threadId : null,    // ← Telegram Topic 路由用
+      channel: effectiveChannel,
+      threadId: threadId != null ? threadId : null,
       rootMessageId: rootMessageId || null,
-      topicName: topicName || null,                     // ← SessionEnd 改名 ✅ 用
-      triggerMessageId: triggerMessageId != null ? triggerMessageId : null,  // D 方案：reaction 加在用户触发消息上
+      topicName: topicName || null,
+      triggerMessageId: triggerMessageId != null ? triggerMessageId : null,
       messageAppLink: messageAppLink || null,
-    })
+    }
+    ensureRoutesInner(sessionId).set(effectiveChannel, route)
   }
 
   function clearSessionRoute(sessionId, reason = 'unknown') {
@@ -190,12 +212,20 @@ export function createOpenClawBridge({
   }
 
   function hasExplicitRoute(sessionId) {
-    return Boolean(sessionId && sessionRoutes.has(sessionId))
+    if (!sessionId) return false
+    const inner = sessionRoutes.get(sessionId)
+    return Boolean(inner && inner.size > 0)
   }
 
-  function resolveRoute(sessionId) {
-    const explicit = sessionRoutes.get(sessionId)
-    if (explicit) return explicit
+  function resolveRoute(sessionId, channel = null) {
+    const inner = getRoutesInner(sessionId)
+    if (inner && inner.size > 0) {
+      if (channel) return inner.get(channel) || null
+      // 无 channel hint：返回最新注册的（Map 保留插入顺序，最后一个 value 是 latest）
+      let last = null
+      for (const r of inner.values()) last = r
+      return last
+    }
     const oc = getOpenClawConfig()
     if (!oc.targetUserId) return null
     return {
@@ -219,7 +249,7 @@ export function createOpenClawBridge({
     if (!rateLimitOk()) return { ok: false, reason: 'rate_limited' }
 
     const oc = getOpenClawConfig()
-    const route = sessionId ? resolveRoute(sessionId) : null
+    const route = sessionId ? resolveRoute(sessionId, channel || null) : null
     const effectiveChannel = channel || route?.channel || oc.channel || 'openclaw-weixin'
     const rawTarget = target || route?.targetUserId || oc.targetUserId
     const effectiveTarget = normalizeTarget(rawTarget, effectiveChannel)
@@ -269,8 +299,8 @@ export function createOpenClawBridge({
         const threadIdForSend = route?.threadId || null
         // 防御兜底：sessionId-routed 但没拿到 thread → fallback 路径，不能静默落 General。
         // 仅当 caller 传了 sessionId 时启用（无 sessionId 是显式 broadcast，允许直发默认 chat）。
-        if (!threadIdForSend && sessionId && !sessionRoutes.has(sessionId)) {
-          logger.warn?.(`[openclaw-bridge] refuse send to telegram general: sid=${sessionId} has no registered route (routesSize=${sessionRoutes.size}); would have leaked to General. msgLen=${message.length}`)
+        if (!threadIdForSend && sessionId && !hasExplicitRoute(sessionId)) {
+          logger.warn?.(`[openclaw-bridge] refuse send to telegram general: sid=${sessionId} has no registered route (routesSize=${sessionRoutes.size}); would have leaked to General. msgLen=${message.length}`)  // sessionRoutes.size = outer Map size (number of sessions)
           return { ok: false, reason: 'no_thread_id_route_missing' }
         }
         logger.info?.(`[openclaw-bridge] telegram send sessionId=${sessionId} chatId=${effectiveTarget} threadId=${threadIdForSend} (route=${route ? JSON.stringify({tid: route.threadId, tn: route.topicName}) : 'null'}) attachment=${attachment ? 'yes' : 'no'} msgLen=${message.length}`)
@@ -445,12 +475,16 @@ export function createOpenClawBridge({
   function findSessionsByTarget(peer) {
     if (!peer) return []
     const out = []
-    for (const [sid, info] of sessionRoutes) {
-      // 同一个 peer 可能有多个 session；route 里 targetUserId 可能带或不带后缀
-      const tgt = info?.targetUserId || ''
-      if (tgt === peer || tgt.startsWith(peer + '@') || peer.startsWith(tgt + '@')) {
-        out.push(sid)
+    for (const [sid, inner] of sessionRoutes) {
+      let matched = false
+      for (const info of inner.values()) {
+        const tgt = info?.targetUserId || ''
+        if (tgt === peer || tgt.startsWith(peer + '@') || peer.startsWith(tgt + '@')) {
+          matched = true
+          break
+        }
       }
+      if (matched) out.push(sid)
     }
     return out
   }
@@ -479,15 +513,17 @@ export function createOpenClawBridge({
   function findSessionByRoute({ channel = null, chatId, threadId = null, rootMessageId = null } = {}) {
     if (!chatId) return null
     const targetStr = String(chatId)
-    for (const [sid, info] of sessionRoutes) {
-      if (channel && info?.channel !== channel) continue
-      if (String(info?.targetUserId || '') !== targetStr) continue
-      if (rootMessageId) {
-        if (info?.rootMessageId === rootMessageId) return sid
-        continue
+    for (const [sid, inner] of sessionRoutes) {
+      for (const info of inner.values()) {
+        if (channel && info?.channel !== channel) continue
+        if (String(info?.targetUserId || '') !== targetStr) continue
+        if (rootMessageId) {
+          if (info?.rootMessageId === rootMessageId) return sid
+          continue
+        }
+        if ((info?.threadId || null) !== (threadId || null)) continue
+        return sid
       }
-      if ((info?.threadId || null) !== (threadId || null)) continue
-      return sid
     }
     return null
   }
@@ -535,15 +571,127 @@ export function createOpenClawBridge({
     }
   }
 
+  /**
+   * 把 user prompt echo 到所有已绑定的 IM thread，排除 origin channel。
+   * 路由从注入的 getRoutesForSession 拿（读 db 双路由），不依赖 in-memory sessionRoutes
+   * （后者每 session 只有一条 route，无法跨 telegram + lark 同时发）。
+   *
+   * 失败一律静默 warn —— echo 是辅助路径，不能影响 agent 的 Stop hook 主流程。
+   */
+  async function broadcastEcho({ sessionId, message, excludeChannel } = {}) {
+    if (!sessionId || !message) return { skipped: true, reason: 'missing_args' }
+    if (typeof getRoutesForSession !== 'function') return { skipped: true, reason: 'no_routes_fn' }
+    if (!rateLimitOk()) return { skipped: true, reason: 'rate_limited' }
+
+    let routes
+    try {
+      routes = getRoutesForSession(sessionId) || {}
+    } catch (e) {
+      logger?.warn?.(`[openclaw-bridge] broadcastEcho getRoutesForSession threw: ${e.message}`)
+      return { skipped: true, reason: 'routes_lookup_failed' }
+    }
+    const { telegram: tg, lark: lk } = routes
+    const results = { telegram: null, lark: null }
+
+    if (excludeChannel === 'telegram') {
+      results.telegram = { skipped: true, reason: 'excluded' }
+    } else if (!tg?.threadId || !tg?.targetUserId) {
+      results.telegram = { skipped: true, reason: 'no_route' }
+    } else {
+      const token = getTelegramTokenFromConfig(getConfig())
+      if (!token) {
+        results.telegram = { ok: false, reason: 'no_token' }
+      } else {
+        try {
+          results.telegram = await telegramSender({
+            token,
+            chatId: String(tg.targetUserId),
+            threadId: Number(tg.threadId),
+            text: message,
+            logger,
+          })
+          if (results.telegram?.ok) recordSend()
+        } catch (e) {
+          logger?.warn?.(`[openclaw-bridge] broadcastEcho telegram threw: ${e.message}`)
+          results.telegram = { ok: false, reason: 'threw', detail: e.message }
+        }
+      }
+    }
+
+    if (excludeChannel === 'lark') {
+      results.lark = { skipped: true, reason: 'excluded' }
+    } else if (!lk?.rootMessageId || !larkBot?.replyInThread) {
+      results.lark = { skipped: true, reason: 'no_route' }
+    } else {
+      try {
+        results.lark = await larkBot.replyInThread({
+          rootMessageId: String(lk.rootMessageId),
+          text: message,
+        })
+        if (results.lark?.ok) recordSend()
+      } catch (e) {
+        logger?.warn?.(`[openclaw-bridge] broadcastEcho lark threw: ${e.message}`)
+        results.lark = { ok: false, reason: 'threw', detail: e.message }
+      }
+    }
+
+    return results
+  }
+
+  /**
+   * Fan-out 文本到 sessionId 当前所有绑定的 channel。Stop hook / ask_user / dispatcher 警告类
+   * 消息走这里，确保 telegram + lark 都能看到（cross-channel mirror 对齐）。
+   *
+   * 实现：对每个绑定的 channel 调用一次 postText（显式带 channel），复用现有的限流、
+   * fast-path、CLI fallback。返回 byChannel 聚合结果。
+   */
+  async function broadcastText({ sessionId, message, replyMarkup = null, attachment = null, excludeChannel = null } = {}) {
+    if (!sessionId || !message) return { skipped: true, reason: 'missing_args' }
+    const routes = allRoutesForSession(sessionId)
+    if (!routes.length) {
+      // session 没有任何 in-memory 路由 → 退回单 postText（用 config 默认 target）。
+      // 行为对齐改造前的 postText({sessionId, message}) 老语义。
+      const r = await postText({ sessionId, message, replyMarkup, attachment })
+      return { ok: !!r?.ok, byChannel: { default: r }, fanout: false }
+    }
+    const byChannel = {}
+    let anyOk = false
+    for (const route of routes) {
+      if (route.channel === excludeChannel) {
+        byChannel[route.channel] = { skipped: true, reason: 'excluded' }
+        continue
+      }
+      const r = await postText({
+        sessionId,
+        message,
+        channel: route.channel,
+        target: route.targetUserId,
+        replyMarkup,
+        attachment,
+      })
+      byChannel[route.channel] = r
+      if (r?.ok) anyOk = true
+    }
+    return { ok: anyOk, byChannel, fanout: true }
+  }
+
   function setTelegramBot(bot) { telegramBot = bot }
   function setLarkBot(bot) { larkBot = bot || null }
   function setTopicGoneHandler(fn) { topicGoneHandler = typeof fn === 'function' ? fn : null }
   function listSessionRoutes() {
-    return Array.from(sessionRoutes.entries()).map(([sessionId, info]) => ({ sessionId, ...info }))
+    const out = []
+    for (const [sid, inner] of sessionRoutes) {
+      for (const route of inner.values()) {
+        out.push({ sessionId: sid, ...route })
+      }
+    }
+    return out
   }
 
   return {
     postText,
+    broadcastText,
+    broadcastEcho,
     healthCheck,
     isEnabled,
     registerSessionRoute,

package/src/openclaw-hook-installer.js

@@ -23,7 +23,7 @@ import { fileURLToPath } from 'node:url'
 import { DEFAULT_ROOT_DIR } from './config.js'
 
 const QUADTODO_MANAGED_KEY = '_quadtodoManaged'
-const HOOK_EVENTS = ['Stop', 'Notification', 'SessionEnd']
+const HOOK_EVENTS = ['Stop', 'Notification', 'SessionEnd', 'UserPromptSubmit']
 const HOOK_VERSION_RE = /quadtodo-hook-version:\s*(\d+)/
 
 function defaultHookScriptPath() {
@@ -52,6 +52,7 @@ function buildHookEntry(event, hookScriptPath) {
   // Claude Code hook 格式（参考其文档）：matchers 数组里每项有 type+command
   const eventLower = event === 'SessionEnd' ? 'session-end'
     : event === 'Notification' ? 'notification'
+    : event === 'UserPromptSubmit' ? 'user-prompt-submit'
     : 'stop'
   return {
     matcher: '*',