agentquad 0.3.0

package/src/routes/git.js

@@ -0,0 +1,89 @@
+import { Router } from 'express'
+import { resolve, isAbsolute } from 'node:path'
+import { readGitStatus, readGitDiff } from '../git/gitStatus.js'
+
+export function createGitRouter() {
+  const cache = new Map()
+
+  function invalidate(workDir) {
+    if (!workDir) return
+    cache.delete(resolve(workDir))
+  }
+
+  function validateAbsolute(workDir) {
+    if (!workDir || typeof workDir !== 'string') return null
+    if (!isAbsolute(workDir)) return null
+    return resolve(workDir)
+  }
+
+  async function computeStatus(key) {
+    const status = await readGitStatus(key)
+    const entry = { status, timestamp: Date.now(), inflight: null }
+    cache.set(key, entry)
+    return entry
+  }
+
+  async function getOrComputeStatus(key) {
+    const existing = cache.get(key)
+    if (existing) {
+      if (existing.inflight) {
+        const status = await existing.inflight
+        return cache.get(key) || { status, timestamp: Date.now(), inflight: null }
+      }
+      return existing
+    }
+    const placeholder = { status: null, timestamp: 0, inflight: null }
+    placeholder.inflight = readGitStatus(key)
+    cache.set(key, placeholder)
+    const status = await placeholder.inflight
+    const entry = { status, timestamp: Date.now(), inflight: null }
+    cache.set(key, entry)
+    return entry
+  }
+
+  const router = Router()
+
+  router.get('/status', async (req, res) => {
+    const key = validateAbsolute(req.query.workDir)
+    if (!key) {
+      res.status(400).json({ ok: false, error: 'bad_request' })
+      return
+    }
+    try {
+      const entry = await getOrComputeStatus(key)
+      res.json({ ok: true, status: entry.status, timestamp: entry.timestamp })
+    } catch (e) {
+      res.status(500).json({ ok: false, error: e?.message || 'internal_error' })
+    }
+  })
+
+  router.post('/refresh', async (req, res) => {
+    const key = validateAbsolute(req.body?.workDir)
+    if (!key) {
+      res.status(400).json({ ok: false, error: 'bad_request' })
+      return
+    }
+    try {
+      const entry = await computeStatus(key)
+      res.json({ ok: true, status: entry.status, timestamp: entry.timestamp })
+    } catch (e) {
+      res.status(500).json({ ok: false, error: e?.message || 'internal_error' })
+    }
+  })
+
+  router.get('/diff', async (req, res) => {
+    const key = validateAbsolute(req.query.workDir)
+    if (!key) {
+      res.status(400).json({ ok: false, error: 'bad_request' })
+      return
+    }
+    try {
+      const diff = await readGitDiff(key)
+      res.json({ ok: true, diff })
+    } catch (e) {
+      res.status(500).json({ ok: false, error: e?.message || 'internal_error' })
+    }
+  })
+
+  return { router, invalidate }
+}

package/src/routes/openclaw-hook.js

@@ -0,0 +1,67 @@
+import { Router } from 'express'
+
+/**
+ * POST /api/openclaw/hook
+ *   body: { source?, path?, event, sessionId, targetUserId?, todoId?, todoTitle?, hookPayload?,
+ *           nativeId?, transcript_path?, cwd?, raw_event_payload?, promptText?, matchedPattern? }
+ *
+ * Claude Code hook 脚本（~/.agentquad/claude-hooks/notify.js）调用此端点（默认 source=claude）。
+ * Codex 事件来源（jsonl emitter / detector）也走同一端点，通过 source/path 字段区分。
+ * 端到端逻辑都委托给 openclaw-hook handler，路由层只做 body 校验与字段转发。
+ */
+export function createOpenClawHookRouter({ hookHandler } = {}) {
+  if (!hookHandler) throw new Error('hookHandler required')
+  const router = Router()
+
+  router.post('/', async (req, res) => {
+    try {
+      const {
+        source = 'claude',
+        path = null,
+        event,
+        sessionId,
+        nativeId,
+        targetUserId,
+        todoId,
+        todoTitle,
+        hookPayload,
+        transcript_path,
+        cwd,
+        raw_event_payload,
+        promptText,
+        matchedPattern,
+      } = req.body || {}
+
+      if (source === 'codex' && path !== 'jsonl' && path !== 'detector') {
+        return res.status(400).json({ ok: false, error: 'unsupported_body_shape' })
+      }
+
+      if (!event || typeof event !== 'string') {
+        return res.status(400).json({ ok: false, error: 'event_required' })
+      }
+
+      const result = await hookHandler.handle({
+        source,
+        path,
+        event,
+        sessionId: sessionId || null,
+        nativeId: nativeId || null,
+        todoId: todoId || null,
+        todoTitle: todoTitle || null,
+        targetUserId: targetUserId || null,
+        hookPayload: hookPayload || null,
+        transcript_path: transcript_path || null,
+        cwd: cwd || null,
+        raw_event_payload: raw_event_payload || null,
+        promptText: promptText || null,
+        matchedPattern: matchedPattern || null,
+      })
+
+      return res.json({ ok: result.ok, ...result })
+    } catch (e) {
+      return res.status(500).json({ ok: false, error: e?.message || 'hook_handle_failed' })
+    }
+  })
+
+  return router
+}

package/src/routes/openclaw-inbound.js

@@ -0,0 +1,36 @@
+import { Router } from 'express'
+
+/**
+ * POST /api/openclaw/inbound
+ *   body: { from: string, text: string }
+ *
+ * OpenClaw skill 把每条用户微信消息转发到这里，由 wizard 状态机
+ * 自己决定怎么响应。返回 { reply: string, action?: string, ... }，
+ * skill 把 reply 转发给用户即可。
+ */
+export function createOpenClawInboundRouter({ wizard } = {}) {
+  if (!wizard) throw new Error('wizard required')
+  const router = Router()
+
+  router.post('/', async (req, res) => {
+    try {
+      const { from, text } = req.body || {}
+      if (!from || typeof from !== 'string') {
+        return res.status(400).json({ ok: false, error: 'from_required' })
+      }
+      if (!text || typeof text !== 'string') {
+        return res.status(400).json({ ok: false, error: 'text_required' })
+      }
+      const result = await wizard.handleInbound({ peer: from, text })
+      return res.json({ ok: true, ...result })
+    } catch (e) {
+      return res.status(500).json({ ok: false, error: e?.message || 'inbound_failed' })
+    }
+  })
+
+  router.get('/state', (_req, res) => {
+    return res.json({ ok: true, ...wizard.describe() })
+  })
+
+  return router
+}

package/src/routes/recurringRules.js

@@ -0,0 +1,80 @@
+import { Router } from 'express'
+
+const USER_ERRORS = new Set([
+  'invalid_frequency',
+  'weekdays_required',
+  'month_days_required',
+  'invalid_quadrant',
+  'title_required',
+])
+
+function handleError(res, e) {
+  if (USER_ERRORS.has(e?.message)) {
+    res.status(400).json({ ok: false, error: e.message })
+    return
+  }
+  res.status(500).json({ ok: false, error: e?.message || 'internal_error' })
+}
+
+export function createRecurringRulesRouter({ db }) {
+  const router = Router()
+
+  router.get('/:id', (req, res) => {
+    try {
+      const rule = db.getRecurringRule(req.params.id)
+      if (!rule) {
+        res.status(404).json({ ok: false, error: 'not_found' })
+        return
+      }
+      res.json({ ok: true, rule })
+    } catch (e) {
+      handleError(res, e)
+    }
+  })
+
+  router.post('/', (req, res) => {
+    try {
+      const result = db.createRecurringRule(req.body || {})
+      res.json({ ok: true, ...result })
+    } catch (e) {
+      handleError(res, e)
+    }
+  })
+
+  router.put('/:id', (req, res) => {
+    try {
+      const rule = db.updateRecurringRule(req.params.id, req.body || {})
+      if (!rule) {
+        res.status(404).json({ ok: false, error: 'not_found' })
+        return
+      }
+      res.json({ ok: true, rule })
+    } catch (e) {
+      handleError(res, e)
+    }
+  })
+
+  router.post('/:id/deactivate', (req, res) => {
+    try {
+      const rule = db.setRecurringRuleActive(req.params.id, false)
+      if (!rule) {
+        res.status(404).json({ ok: false, error: 'not_found' })
+        return
+      }
+      res.json({ ok: true, rule })
+    } catch (e) {
+      handleError(res, e)
+    }
+  })
+
+  router.delete('/:id', (req, res) => {
+    try {
+      db.deleteRecurringRule(req.params.id)
+      res.json({ ok: true })
+    } catch (e) {
+      handleError(res, e)
+    }
+  })
+
+  return router
+}

package/src/routes/reports.js

@@ -0,0 +1,50 @@
+import express from 'express'
+
+// 把时间戳按"本地日期"分桶（key 形如 '2026-04-22'）
+function localDateKey(ts) {
+  const d = new Date(ts)
+  const y = d.getFullYear()
+  const m = String(d.getMonth() + 1).padStart(2, '0')
+  const day = String(d.getDate()).padStart(2, '0')
+  return `${y}-${m}-${day}`
+}
+
+export function createReportsRouter({ db }) {
+  const router = express.Router()
+
+  router.get('/done', (req, res) => {
+    try {
+      const since = Number(req.query.since)
+      const until = Number(req.query.until)
+      if (!Number.isFinite(since) || !Number.isFinite(until) || since >= until) {
+        res.status(400).json({ ok: false, error: 'invalid_range' })
+        return
+      }
+
+      const list = db.listCompletedTodos({ since, until })
+      const byDay = new Map()
+      for (const t of list) {
+        const key = localDateKey(t.completedAt)
+        byDay.set(key, (byDay.get(key) || 0) + 1)
+      }
+      const dailyCounts = [...byDay.entries()]
+        .map(([date, count]) => ({ date, count }))
+        .sort((a, b) => (a.date < b.date ? 1 : -1))
+
+      const missedCount = db.countMissedInRange({ since, until })
+
+      res.json({
+        ok: true,
+        range: { since, until },
+        list,
+        dailyCounts,
+        missedCount,
+        total: list.length,
+      })
+    } catch (e) {
+      res.status(500).json({ ok: false, error: e.message })
+    }
+  })
+
+  return router
+}

package/src/routes/search.js

@@ -0,0 +1,46 @@
+import { Router } from 'express'
+
+/**
+ * 统一搜索 HTTP 端点。
+ *
+ * GET /api/search?q=...&scopes=todos,comments,wiki,ai_sessions&includeArchived=false&limit=20
+ *
+ * 返回:
+ *   {
+ *     ok: true,
+ *     total: 37,
+ *     results: [{ scope, todoId, todoTitle, snippet, score, ...scope-specific-ids }, ...]
+ *   }
+ */
+export function createSearchRouter({ searchService } = {}) {
+  if (!searchService || typeof searchService.search !== 'function') {
+    throw new Error('searchService_required')
+  }
+  const router = Router()
+
+  router.get('/', (req, res) => {
+    try {
+      const q = String(req.query.q || '').trim()
+      if (!q) {
+        res.status(400).json({ ok: false, error: 'query_required' })
+        return
+      }
+      let scopes
+      const rawScopes = req.query.scopes
+      if (typeof rawScopes === 'string' && rawScopes.length) {
+        scopes = rawScopes.split(',').map((s) => s.trim()).filter(Boolean)
+      }
+      const includeArchived =
+        req.query.includeArchived === 'true' || req.query.includeArchived === '1'
+      const limit = req.query.limit == null ? undefined : Number(req.query.limit)
+      const out = searchService.search({ query: q, scopes, includeArchived, limit })
+      res.json({ ok: true, ...out })
+    } catch (e) {
+      const msg = e?.message || String(e)
+      const status = msg === 'query_required' ? 400 : 500
+      res.status(status).json({ ok: false, error: msg })
+    }
+  })
+
+  return router
+}

package/src/routes/stats.js

@@ -0,0 +1,31 @@
+import express from 'express'
+import { buildReport } from '../stats/report.js'
+import { renderMarkdown } from '../stats/markdown.js'
+
+export function createStatsRouter({ db, getPricing }) {
+	const router = express.Router()
+
+	function parseRange(req) {
+		const s = Number(req.query.since)
+		const u = Number(req.query.until)
+		if (!Number.isFinite(s) || !Number.isFinite(u) || s >= u) return null
+		return { since: s, until: u }
+	}
+
+	router.get('/report', (req, res) => {
+		const range = parseRange(req)
+		if (!range) return res.status(400).json({ ok: false, error: 'invalid_range' })
+		const report = buildReport(db, { ...range, pricing: getPricing() })
+		res.json({ ok: true, report })
+	})
+
+	router.get('/report.md', (req, res) => {
+		const range = parseRange(req)
+		if (!range) return res.status(400).send('invalid range')
+		const report = buildReport(db, { ...range, pricing: getPricing() })
+		res.set('Content-Type', 'text/markdown; charset=utf-8')
+		res.send(renderMarkdown(report))
+	})
+
+	return router
+}

package/src/routes/telegram-config.js

@@ -0,0 +1,152 @@
+/**
+ * /api/config/telegram/* 路由：
+ *   POST /test           —— getMe 连通性测试
+ *   POST /probe-chat-id  —— 启动一个 probe 窗口（Task 9 添加）
+ *   GET  /probe-chat-id/stream —— SSE 实时推命中（Task 9 添加）
+ *
+ * 依赖：
+ *   - getConfig: () => 当前配置
+ *   - getTelegramBot: () => 当前 telegramBot 实例（可能 null，比如 enabled=false）
+ *   - probeRegistry: createProbeRegistry() 返回的对象（Task 9 用）
+ */
+import { Router } from 'express'
+import { isMaskedToken } from '../telegram-config-service.js'
+import * as telegramBot from '../telegram-bot.js'
+
+const { readBotTokenWithSource } = telegramBot
+
+const TELEGRAM_API = 'https://api.telegram.org'
+
+async function getMeWithToken(token, fetchFn) {
+  const res = await fetchFn(`${TELEGRAM_API}/bot${token}/getMe`, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({}),
+  })
+  const data = await res.json().catch(() => null)
+  if (!res.ok || !data?.ok) throw new Error(data?.description || `HTTP ${res.status}`)
+  return data.result
+}
+
+// Node 的 undici fetch 失败时 e.message 只有光秃秃的 "fetch failed"，真正的网络
+// 原因藏在 e.cause.message。前端只展示 e.message 没法排查（用户截图就是这个症状）。
+function describeFetchError(e) {
+  const base = e?.message || 'unknown'
+  const causeMsg = e?.cause?.message
+  if (causeMsg && causeMsg !== base) return `${base}: ${causeMsg}`
+  return base
+}
+
+export function createTelegramConfigRouter({ getConfig, getTelegramBot, probeRegistry, fetchFn }) {
+  if (typeof getConfig !== 'function') throw new Error('getConfig required')
+  if (typeof getTelegramBot !== 'function') throw new Error('getTelegramBot required')
+
+  // 没注入 fetchFn 时按需取 proxy-aware fetcher，跟 telegram-bot.js 一致；
+  // 这样设置页"测试"按钮和 bot 长轮询走同一条出口，不会一个能连一个 fetch failed。
+  // 每次请求都 resolve 一遍：让 HTTPS_PROXY 改了之后不用重启 AgentQuad。
+  const resolveFetch = fetchFn
+    ? async () => fetchFn
+    : () => telegramBot.getProxyFetch()
+
+  const router = Router()
+
+  // POST /test —— getMe 探测
+  router.post('/test', async (req, res) => {
+    const inputToken = typeof req.body?.botToken === 'string' ? req.body.botToken.trim() : ''
+    if (inputToken && !isMaskedToken(inputToken)) {
+      try {
+        const f = await resolveFetch()
+        const me = await getMeWithToken(inputToken, f)
+        return res.json({
+          ok: true,
+          botId: me.id,
+          botUsername: me.username || null,
+          botFirstName: me.first_name || null,
+          source: 'input',
+        })
+      } catch (e) {
+        return res.json({ ok: false, errorReason: describeFetchError(e), source: 'input' })
+      }
+    }
+
+    const { token, source } = readBotTokenWithSource(getConfig)
+    if (!token) {
+      return res.json({ ok: false, errorReason: 'token_missing', source })
+    }
+    try {
+      const f = await resolveFetch()
+      const me = await getMeWithToken(token, f)
+      res.json({
+        ok: true,
+        botId: me.id,
+        botUsername: me.username || null,
+        botFirstName: me.first_name || null,
+        source,
+      })
+    } catch (e) {
+      res.json({ ok: false, errorReason: describeFetchError(e), source })
+    }
+  })
+
+  // POST /probe-chat-id —— 启动 probe 窗口
+  router.post('/probe-chat-id', (req, res) => {
+    if (!probeRegistry) {
+      return res.status(500).json({ ok: false, reason: 'no_registry' })
+    }
+    const bot = getTelegramBot()
+    if (!bot || typeof bot.setProbeListener !== 'function') {
+      return res.json({ ok: false, reason: 'bot_not_running' })
+    }
+    const r = probeRegistry.startProbe(Number(req.body?.durationSec) || 60)
+    if (!r.ok) {
+      return res.json({ ok: false, reason: r.reason })
+    }
+    bot.setProbeListener((hit) => probeRegistry.record(hit))
+    res.json({ ok: true, durationSec: r.durationSec, expiresAt: r.expiresAt })
+  })
+
+  // GET /probe-chat-id/stream —— SSE 推命中
+  router.get('/probe-chat-id/stream', (req, res) => {
+    if (!probeRegistry) {
+      return res.status(500).json({ ok: false, reason: 'no_registry' })
+    }
+    res.setHeader('Content-Type', 'text/event-stream')
+    res.setHeader('Cache-Control', 'no-cache')
+    res.setHeader('Connection', 'keep-alive')
+    res.flushHeaders()
+
+    // 立即把 snapshot 推一遍（让重连客户端看到已有 hits）
+    for (const hit of probeRegistry.snapshot().hits) {
+      res.write(`data: ${JSON.stringify(hit)}\n\n`)
+    }
+
+    const unsub = probeRegistry.subscribe((hit) => {
+      if (hit === null) {
+        res.write(`event: done\ndata: {}\n\n`)
+        res.end()
+        return
+      }
+      res.write(`data: ${JSON.stringify(hit)}\n\n`)
+    })
+
+    // 每 25 秒发个 ping 防止反向代理掐
+    const pingInterval = setInterval(() => {
+      try { res.write(`: ping\n\n`) } catch {}
+    }, 25_000)
+
+    req.on('close', () => {
+      clearInterval(pingInterval)
+      unsub()
+    })
+  })
+
+  // POST /probe-chat-id/stop —— 主动停
+  router.post('/probe-chat-id/stop', (_req, res) => {
+    const bot = getTelegramBot()
+    if (bot && typeof bot.setProbeListener === 'function') bot.setProbeListener(null)
+    if (probeRegistry) probeRegistry.stopProbe()
+    res.json({ ok: true })
+  })
+
+  return router
+}