@konglx/rotom 2.21.0

package/dist/master/api/guidance-templates.js

@@ -0,0 +1,147 @@
+/**
+ * /api/guidance-templates — 群指导 prompt 模板库 CRUD
+ *
+ * - 列表: GET /api/guidance-templates
+ * - 新建: POST /api/guidance-templates
+ * - 改:   PATCH /api/guidance-templates/:id
+ * - 删:   DELETE /api/guidance-templates/:id  (种子模板 is_default=1 返回 400)
+ *
+ * 身份验证沿用 api/index.ts 的 permissive middleware。
+ */
+import { createLogger } from "../../shared/logger.js";
+const log = createLogger("mesh-api-guidance-templates");
+function asString(v) {
+    return typeof v === "string" && v.trim() ? v.trim() : undefined;
+}
+function asInt(v) {
+    if (typeof v === "number" && Number.isFinite(v))
+        return Math.trunc(v);
+    if (typeof v === "string" && /^-?\d+$/.test(v.trim()))
+        return parseInt(v.trim(), 10);
+    return undefined;
+}
+/**
+ * schedule_config 接受对象或 JSON 字符串;null/空串/缺省=不设置(返回 null)。
+ * 返回 undefined 表示「格式非法」,由调用方返回 400。
+ */
+function normalizeScheduleConfig(v) {
+    if (v === null || v === undefined)
+        return null;
+    if (typeof v === "string") {
+        if (v.trim() === "")
+            return null;
+        try {
+            JSON.parse(v);
+            return v;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    if (typeof v === "object") {
+        return JSON.stringify(v);
+    }
+    return undefined;
+}
+export function registerGuidanceTemplateRoutes(apiRouter, db) {
+    // ── 列表 ─────────────────────────────────────────────────────────────────
+    apiRouter.get("/guidance-templates", (_req, res) => {
+        res.json(db.listGuidanceTemplates());
+    });
+    // ── 新建 ─────────────────────────────────────────────────────────────────
+    apiRouter.post("/guidance-templates", (req, res) => {
+        const b = req.body;
+        const name = asString(b.name);
+        const promptText = asString(b.prompt_text);
+        if (!name) {
+            res.status(400).json({ error: "name is required" });
+            return;
+        }
+        if (!promptText) {
+            res.status(400).json({ error: "prompt_text is required" });
+            return;
+        }
+        const scheduleConfig = normalizeScheduleConfig(b.schedule_config);
+        if (scheduleConfig === undefined) {
+            res.status(400).json({ error: "schedule_config must be a JSON object or JSON string" });
+            return;
+        }
+        const tpl = db.createGuidanceTemplate({
+            name,
+            description: typeof b.description === "string" ? b.description : "",
+            prompt_text: promptText,
+            schedule_config: scheduleConfig,
+            sort_order: asInt(b.sort_order) ?? 0,
+        });
+        log.info(`Guidance template created: #${tpl.id} "${tpl.name}"`);
+        res.status(201).json(tpl);
+    });
+    // ── 改 ───────────────────────────────────────────────────────────────────
+    apiRouter.patch("/guidance-templates/:id", (req, res) => {
+        const id = asInt(req.params.id);
+        if (id === undefined) {
+            res.status(400).json({ error: "id must be an integer" });
+            return;
+        }
+        const existing = db.getGuidanceTemplate(id);
+        if (!existing) {
+            res.status(404).json({ error: "Template not found" });
+            return;
+        }
+        const b = req.body;
+        const patch = {};
+        if (b.name !== undefined) {
+            const s = asString(b.name);
+            if (!s) {
+                res.status(400).json({ error: "name cannot be empty" });
+                return;
+            }
+            patch.name = s;
+        }
+        if (b.description !== undefined) {
+            patch.description = typeof b.description === "string" ? b.description : "";
+        }
+        if (b.prompt_text !== undefined) {
+            const s = asString(b.prompt_text);
+            if (!s) {
+                res.status(400).json({ error: "prompt_text cannot be empty" });
+                return;
+            }
+            patch.prompt_text = s;
+        }
+        if (b.schedule_config !== undefined) {
+            const v = normalizeScheduleConfig(b.schedule_config);
+            if (v === undefined) {
+                res.status(400).json({ error: "schedule_config must be a JSON object or JSON string" });
+                return;
+            }
+            patch.schedule_config = v;
+        }
+        if (b.sort_order !== undefined) {
+            patch.sort_order = asInt(b.sort_order) ?? 0;
+        }
+        const tpl = db.updateGuidanceTemplate(id, patch);
+        log.info(`Guidance template updated: #${id}`);
+        res.json(tpl);
+    });
+    // ── 删 ───────────────────────────────────────────────────────────────────
+    apiRouter.delete("/guidance-templates/:id", (req, res) => {
+        const id = asInt(req.params.id);
+        if (id === undefined) {
+            res.status(400).json({ error: "id must be an integer" });
+            return;
+        }
+        const existing = db.getGuidanceTemplate(id);
+        if (!existing) {
+            res.status(404).json({ error: "Template not found" });
+            return;
+        }
+        if (existing.is_default === 1) {
+            res.status(400).json({ error: "Cannot delete default template" });
+            return;
+        }
+        db.deleteGuidanceTemplate(id);
+        log.info(`Guidance template deleted: #${id}`);
+        res.json({ ok: true });
+    });
+}

package/dist/master/api/index.js

@@ -0,0 +1,89 @@
+/**
+ * Digital Employee Mesh — REST API
+ *
+ * Dashboard endpoints are open (no login). Agent-token endpoints expect a
+ * `Bearer mesh_xxx` header and reject anonymous calls inline.
+ */
+import { Router as ExpressRouter } from "express";
+import { AuthService, hashToken } from "../auth.js";
+import { ShareTokenStore } from "../share-tokens.js";
+import { createLogger } from "../../shared/logger.js";
+import { registerAgentRoutes } from "./agents.js";
+import { registerDomainRoutes } from "./domains.js";
+import { registerTeamRoutes } from "./teams.js";
+import { registerMessageRoutes } from "./messages.js";
+import { registerGroupRoutes } from "./groups.js";
+import { registerIssueRoutes } from "./issues.js";
+import { registerNoteRoutes } from "./notes.js";
+import { registerMemoryRoutes } from "./memory.js";
+import { registerSkillRoutes } from "./skills.js";
+import { registerArtifactRoutes } from "./artifacts.js";
+import { registerUploadRoutes } from "./uploads.js";
+import { registerSessionRoutes } from "./sessions.js";
+import { registerScheduleRoutes } from "./schedules.js";
+import { registerShareRoutes } from "./share.js";
+import { registerGuidanceTemplateRoutes } from "./guidance-templates.js";
+import { registerSchedulePatternRoutes } from "./schedule-patterns.js";
+import { registerIssuePatrolRoutes } from "./issues-patrol.js";
+import { registerLinkPatrolRoutes } from "./links-patrol.js";
+import { registerLinkRoutes } from "./links.js";
+const log = createLogger("mesh-api");
+// ---------------------------------------------------------------------------
+// Create API router
+// ---------------------------------------------------------------------------
+export function createApi(db, sharedAuth, hub, router, serverPort, shareStore) {
+    const apiRouter = ExpressRouter();
+    const auth = sharedAuth ?? new AuthService(db);
+    const shareTokens = shareStore ?? new ShareTokenStore();
+    // ── Request logging middleware ──────────────────────────────────────────
+    apiRouter.use((req, res, next) => {
+        const start = Date.now();
+        res.on("finish", () => {
+            const ms = Date.now() - start;
+            log.info(`${req.method} ${req.originalUrl} ${res.statusCode} ${ms}ms`);
+        });
+        next();
+    });
+    // ── Permissive auth middleware ──────────────────────────────────────────
+    apiRouter.use((req, res, next) => {
+        if (req.method === "OPTIONS") {
+            res.setHeader("Access-Control-Allow-Origin", "*");
+            res.setHeader("Access-Control-Allow-Methods", "GET, POST, PUT, DELETE, OPTIONS");
+            res.setHeader("Access-Control-Allow-Headers", "Content-Type, Authorization");
+            res.status(200).end();
+            return;
+        }
+        const header = req.headers.authorization;
+        if (header && header.startsWith("Bearer ")) {
+            const token = header.slice(7);
+            if (token.startsWith("mesh_")) {
+                const agent = db.getAgentByTokenHash(hashToken(token));
+                if (agent) {
+                    req.agentAuth = { name: agent.name, id: agent.id };
+                }
+            }
+        }
+        next();
+    });
+    // ── Register route modules ─────────────────────────────────────────────
+    registerAgentRoutes(apiRouter, db, auth, hub, serverPort);
+    registerDomainRoutes(apiRouter, db);
+    registerTeamRoutes(apiRouter, db);
+    registerMessageRoutes(apiRouter, db, auth, hub, router);
+    registerGroupRoutes(apiRouter, db, auth, hub);
+    registerIssueRoutes(apiRouter, db, auth, hub);
+    registerNoteRoutes(apiRouter, db);
+    registerMemoryRoutes(apiRouter, db);
+    registerSkillRoutes(apiRouter, db);
+    registerArtifactRoutes(apiRouter, db);
+    registerUploadRoutes(apiRouter, db);
+    registerSessionRoutes(apiRouter, db, auth, hub);
+    registerScheduleRoutes(apiRouter, db);
+    registerShareRoutes(apiRouter, db, shareTokens);
+    registerGuidanceTemplateRoutes(apiRouter, db);
+    registerSchedulePatternRoutes(apiRouter, db);
+    registerIssuePatrolRoutes(apiRouter, db);
+    registerLinkPatrolRoutes(apiRouter, db);
+    registerLinkRoutes(apiRouter, db);
+    return apiRouter;
+}

package/dist/master/api/issues-patrol.js

@@ -0,0 +1,172 @@
+/**
+ * Issue 巡检 REST —— 工具箱 Issue 巡检 tab 用。
+ *
+ * - GET  /api/issues-patrol/state           — 当前 patrol 群 + 其 scheduled_task 配置
+ * - PATCH /api/issues-patrol/config         — 改 enabled / intervalSec / 节流参数
+ * - GET  /api/issues-patrol/runs            — 最近 runs
+ * - GET  /api/issues-patrol/runs/:runId/logs — 单轮日志
+ * - GET  /api/issues-patrol/logs            — 全局日志(可按 verdict / candidateGroupId 过滤)
+ */
+import { createLogger } from "../../shared/logger.js";
+const log = createLogger("mesh-api-issues-patrol");
+function parsePayload(raw) {
+    if (!raw)
+        return {};
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return {};
+    }
+}
+function findPatrolGroup(db) {
+    const groups = db.listGroupsByType("patrol").filter((g) => g.archived_at == null);
+    if (groups.length === 0)
+        return null;
+    const group = groups[0];
+    const members = db.getGroupMembers(group.id);
+    // patrol 群成员 = creator(人) + 巡检员(1 个 AI agent)。优先取 scheduled_task.agent_name,
+    // 否则取第一个非空成员。
+    const task = db.listScheduledTasks({ groupId: group.id }).find((t) => t.handler_key === "issue-patrol");
+    const agentName = task?.agent_name ?? members[0]?.agent_name ?? "";
+    return { groupId: group.id, groupName: group.name, agentName };
+}
+export function registerIssuePatrolRoutes(apiRouter, db) {
+    // ── state ────────────────────────────────────────────────────────────────
+    apiRouter.get("/issues-patrol/state", (_req, res) => {
+        const patrol = findPatrolGroup(db);
+        if (!patrol) {
+            res.json({ enabled: false, hasPatrolGroup: false });
+            return;
+        }
+        const task = db.listScheduledTasks({ groupId: patrol.groupId }).find((t) => t.handler_key === "issue-patrol");
+        if (!task) {
+            res.json({
+                hasPatrolGroup: true,
+                patrolGroupId: patrol.groupId,
+                patrolGroupName: patrol.groupName,
+                patrolAgentName: patrol.agentName,
+                enabled: false,
+            });
+            return;
+        }
+        const payload = parsePayload(task.handler_payload);
+        res.json({
+            hasPatrolGroup: true,
+            patrolGroupId: patrol.groupId,
+            patrolGroupName: patrol.groupName,
+            patrolAgentName: patrol.agentName,
+            taskId: task.id,
+            enabled: task.enabled === 1,
+            intervalSec: task.interval_sec,
+            nextRunAt: task.next_run_at,
+            lastRunAt: task.last_run_at,
+            lastStatus: task.last_status,
+            lastError: task.last_error,
+            throughputCap: payload.throughputCap ?? 3,
+            candidateCap: payload.candidateCap ?? 3,
+            scanBatch: payload.scanBatch ?? 10,
+        });
+    });
+    // ── config ────────────────────────────────────────────────────────────────
+    apiRouter.patch("/issues-patrol/config", (req, res) => {
+        const patrol = findPatrolGroup(db);
+        if (!patrol) {
+            res.status(400).json({ error: "未创建巡检群,请先建一个 type=patrol 的群" });
+            return;
+        }
+        const task = db.listScheduledTasks({ groupId: patrol.groupId }).find((t) => t.handler_key === "issue-patrol");
+        if (!task) {
+            res.status(404).json({ error: "巡检定时任务不存在" });
+            return;
+        }
+        const body = req.body ?? {};
+        const patch = {};
+        const payload = parsePayload(task.handler_payload);
+        if (typeof body.enabled === "boolean") {
+            patch.enabled = body.enabled;
+        }
+        if (typeof body.intervalSec === "number") {
+            if (body.intervalSec < 60) {
+                res.status(400).json({ error: "intervalSec 必须 >= 60" });
+                return;
+            }
+            patch.intervalSec = Math.floor(body.intervalSec);
+            patch.scheduleKind = "interval";
+        }
+        if (typeof body.throughputCap === "number") {
+            if (body.throughputCap < 1 || body.throughputCap > 20) {
+                res.status(400).json({ error: "throughputCap 取值 1-20" });
+                return;
+            }
+            payload.throughputCap = Math.floor(body.throughputCap);
+        }
+        if (typeof body.candidateCap === "number") {
+            if (body.candidateCap < 1 || body.candidateCap > 20) {
+                res.status(400).json({ error: "candidateCap 取值 1-20" });
+                return;
+            }
+            payload.candidateCap = Math.floor(body.candidateCap);
+        }
+        if (typeof body.scanBatch === "number") {
+            if (body.scanBatch < 1 || body.scanBatch > 50) {
+                res.status(400).json({ error: "scanBatch 取值 1-50" });
+                return;
+            }
+            payload.scanBatch = Math.floor(body.scanBatch);
+        }
+        // patrolGroupId / patrolAgentName 不可改,从原 payload 继承
+        payload.patrolGroupId = payload.patrolGroupId ?? patrol.groupId;
+        payload.patrolAgentName = payload.patrolAgentName ?? patrol.agentName;
+        patch.handlerPayload = JSON.stringify(payload);
+        const updated = db.updateScheduledTask(task.id, patch);
+        if (!updated) {
+            res.status(500).json({ error: "更新失败" });
+            return;
+        }
+        log.info(`Patrol config updated (task #${task.id}): ${JSON.stringify(patch)}`);
+        res.json({
+            ok: true,
+            enabled: updated.enabled === 1,
+            intervalSec: updated.interval_sec,
+            throughputCap: payload.throughputCap,
+            candidateCap: payload.candidateCap,
+            scanBatch: payload.scanBatch,
+            nextRunAt: updated.next_run_at,
+        });
+    });
+    // ── runs ──────────────────────────────────────────────────────────────────
+    apiRouter.get("/issues-patrol/runs", (req, res) => {
+        const limit = parseLimit(req.query.limit, 50);
+        const patrol = findPatrolGroup(db);
+        const runs = db.listPatrolRuns({
+            patrolGroupId: patrol?.groupId,
+            limit,
+        });
+        res.json({ runs });
+    });
+    apiRouter.get("/issues-patrol/runs/:runId/logs", (req, res) => {
+        const logs = db.listPatrolLogsForRun(req.params.runId);
+        res.json({ logs });
+    });
+    // ── logs ──────────────────────────────────────────────────────────────────
+    apiRouter.get("/issues-patrol/logs", (req, res) => {
+        const limit = parseLimit(req.query.limit, 200);
+        const verdict = typeof req.query.verdict === "string" ? req.query.verdict : undefined;
+        const candidateGroupId = typeof req.query.candidateGroupId === "string" ? req.query.candidateGroupId : undefined;
+        const patrol = findPatrolGroup(db);
+        const logs = db.listPatrolLogs({
+            patrolGroupId: patrol?.groupId,
+            verdict: verdict,
+            candidateGroupId,
+            limit,
+        });
+        res.json({ logs });
+    });
+}
+function parseLimit(v, fallback) {
+    const n = typeof v === "string" ? parseInt(v, 10) : Number(v);
+    if (!Number.isFinite(n) || n <= 0)
+        return fallback;
+    return Math.min(n, 1000);
+}