@konglx/rotom 2.21.0

package/dist/master/db/memory.js

@@ -0,0 +1,272 @@
+import { nowBeijing } from "../../shared/time.js";
+import { buildUpdate } from "./build-update.js";
+// ─── Methods ──────────────────────────────────────────────────────────────
+export const memoryMethods = {
+    /** 列表过滤。返回轻量索引(无 value 全文)。 */
+    listMemory(filter = {}) {
+        const { scope, groupId, category, key, tags, includePending = false, agentVisible, limit = 50, } = filter;
+        const where = ["active = 1"];
+        const params = [];
+        if (scope) {
+            where.push("scope = ?");
+            params.push(scope);
+        }
+        if (groupId) {
+            where.push("group_id = ?");
+            params.push(groupId);
+        }
+        if (category) {
+            where.push("category = ?");
+            params.push(category);
+        }
+        if (key) {
+            where.push("key = ?");
+            params.push(key);
+        }
+        if (agentVisible !== undefined) {
+            where.push("agent_visible = ?");
+            params.push(agentVisible);
+        }
+        if (!includePending) {
+            where.push("pending_review = 0");
+        }
+        if (tags && tags.length > 0) {
+            // JSON array LIKE 匹配
+            const ors = tags.map(() => "tags LIKE ?");
+            where.push(`(${ors.join(" OR ")})`);
+            for (const t of tags)
+                params.push(`%"${t.replace(/"/g, '\\"')}%"`);
+        }
+        params.push(limit);
+        const rows = this.db.prepare(`SELECT id, key, summary, tags, category, scope, group_id, agent_visible,
+              created_by, created_at
+       FROM agent_memory
+       WHERE ${where.join(" AND ")}
+       ORDER BY created_at DESC
+       LIMIT ?`).all(...params);
+        return rows;
+    },
+    /**
+     * 关键词搜索(SQL LIKE)。强制 agent_visible=1 AND pending_review=0 AND active=1
+     * —— note(agent_visible=0)永远搜不到。
+     * 命中时 injected_count += 1(计入"被检索到"统计)。
+     */
+    searchMemory(keyword, filter = {}) {
+        const { scope, groupId, category, limit = 20 } = filter;
+        const where = [
+            "active = 1",
+            "agent_visible = 1",
+            "pending_review = 0",
+        ];
+        const params = [];
+        const kw = `%${keyword}%`;
+        // 在 key/value/summary/tags 上 LIKE
+        where.push("(key LIKE ? OR value LIKE ? OR summary LIKE ? OR tags LIKE ?)");
+        params.push(kw, kw, kw, kw);
+        if (scope) {
+            where.push("scope = ?");
+            params.push(scope);
+        }
+        if (groupId) {
+            where.push("group_id = ?");
+            params.push(groupId);
+        }
+        if (category) {
+            where.push("category = ?");
+            params.push(category);
+        }
+        params.push(limit);
+        const rows = this.db.prepare(`SELECT id, key, summary, tags, category, scope, group_id, agent_visible,
+              created_by, created_at
+       FROM agent_memory
+       WHERE ${where.join(" AND ")}
+       ORDER BY view_count DESC, created_at DESC
+       LIMIT ?`).all(...params);
+        // 批量 injected_count += 1
+        if (rows.length > 0) {
+            const ids = rows.map(r => r.id);
+            const placeholders = ids.map(() => "?").join(",");
+            this.db.prepare(`UPDATE agent_memory SET injected_count = injected_count + 1 WHERE id IN (${placeholders})`).run(...ids);
+        }
+        return rows;
+    },
+    /** 详情。memory(agent_visible=1) 读取时 view_count += 1;note 不计数。 */
+    getMemory(id) {
+        const row = this.db.prepare("SELECT * FROM agent_memory WHERE id = ?").get(id);
+        if (!row)
+            return undefined;
+        if (row.agent_visible === 1 && row.active === 1 && row.pending_review === 0) {
+            this.db.prepare(`UPDATE agent_memory SET view_count = view_count + 1, last_viewed_at = datetime('now') WHERE id = ?`).run(id);
+        }
+        return row;
+    },
+    /** 计数 agent_visible=1 的 memory(供 prompt 极简指针注入)。 */
+    countMemory(scope, groupId) {
+        const where = ["active = 1", "agent_visible = 1", "pending_review = 0", "scope = ?"];
+        const params = [scope];
+        if (scope === "group" && groupId) {
+            where.push("group_id = ?");
+            params.push(groupId);
+        }
+        const row = this.db.prepare(`SELECT COUNT(*) as n FROM agent_memory WHERE ${where.join(" AND ")}`).get(...params);
+        return row?.n ?? 0;
+    },
+    addMemory(input) {
+        // 硬约束:visibility=global + agent_visible=1 必须走审核(pending_review=1)。
+        // 全局 memory 不允许直接对 agent 可见,必须先 create(pending) → 人工 approve 才生效。
+        // 唯一合法直接 visible 的全局 memory 路径是 approveMemory(已审核)和 promoteMemoryVisibility(从 group 升 global 时内部强制 agent_visible=0)。
+        // 这个 guard 防止"cli 直接 addMemory(scope=global, visibility=global, agent_visible=true) 绕过审核"。
+        if ((input.scope === "global" || input.visibility === "global") &&
+            input.agentVisible === true &&
+            input.pendingReview !== true) {
+            throw new Error(`addMemory blocked: scope=global + visibility=global + agent_visible=true must go through pending review. ` +
+                `Use addMemory({ ..., scope: 'global', visibility: 'global', agentVisible: false, pendingReview: true }) ` +
+                `or addMemory({ ..., scope: 'group', visibility: 'group' }) + later promoteMemoryVisibility(id, 'global').`);
+        }
+        const now = nowBeijing();
+        const summary = input.summary ?? input.value.slice(0, 80);
+        const scope = input.scope ?? "group";
+        const groupId = scope === "global" ? null : (input.groupId ?? null);
+        this.db.prepare(`
+      INSERT INTO agent_memory (
+        id, group_id, scope, category, source_type, source_ref,
+        key, value, summary, tags, visibility, agent_visible,
+        created_by, created_at, updated_at, expires_at,
+        active, pending_review, injected_count, view_count, last_viewed_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 1, ?, 0, 0, NULL)
+    `).run(input.id, groupId, scope, input.category, input.sourceType ?? "manual", input.sourceRef ?? null, input.key, input.value, summary, JSON.stringify(input.tags ?? []), input.visibility ?? "group", input.agentVisible ? 1 : 0, input.createdBy, now, now, input.expiresAt ?? null, input.pendingReview ? 1 : 0);
+    },
+    updateMemory(id, fields) {
+        const extraSets = [];
+        // value 改了但 summary 没显式给 → 自动重算
+        if (fields.value !== undefined && fields.summary === undefined) {
+            extraSets.push({ column: "summary", value: fields.value.slice(0, 80) });
+        }
+        const built = buildUpdate({
+            table: "agent_memory",
+            sets: {
+                value: fields.value,
+                summary: fields.summary,
+                tags: fields.tags !== undefined ? JSON.stringify(fields.tags) : undefined,
+                category: fields.category,
+                visibility: fields.visibility,
+                agent_visible: fields.agentVisible !== undefined ? (fields.agentVisible ? 1 : 0) : undefined,
+                expires_at: fields.expiresAt,
+            },
+            where: "id = ?",
+            whereParams: [id],
+            updatedAt: "datetime-now",
+            extraSets,
+        });
+        if (!built)
+            return false;
+        const result = this.db.prepare(built.sql).run(...built.params);
+        return result.changes > 0;
+    },
+    /** 软删除:active=0。 */
+    deactivateMemory(id) {
+        const result = this.db.prepare("UPDATE agent_memory SET active = 0, updated_at = datetime('now') WHERE id = ?").run(id);
+        return result.changes > 0;
+    },
+    /** 标记过期(仍 active=1,但 expires_at 设为过去时间;读取时由调用方判断)。 */
+    expireMemory(id) {
+        const result = this.db.prepare("UPDATE agent_memory SET expires_at = datetime('now'), updated_at = datetime('now') WHERE id = ?").run(id);
+        return result.changes > 0;
+    },
+    /** group → global(scope 随之变 global, group_id 置 NULL)。 */
+    promoteMemoryVisibility(id, newVisibility) {
+        const built = buildUpdate({
+            table: "agent_memory",
+            sets: { visibility: newVisibility },
+            where: "id = ?",
+            whereParams: [id],
+            updatedAt: "datetime-now",
+            extraSets: newVisibility === "global" ? [{ column: "scope", value: "global" }, { sql: "group_id = NULL" }] : [],
+        });
+        if (!built)
+            return false;
+        const result = this.db.prepare(built.sql).run(...built.params);
+        return result.changes > 0;
+    },
+    /** 审核队列:pending_review=1。 */
+    listPendingMemory(scope, groupId) {
+        const where = ["active = 1", "pending_review = 1"];
+        const params = [];
+        if (scope) {
+            where.push("scope = ?");
+            params.push(scope);
+        }
+        if (groupId) {
+            where.push("group_id = ?");
+            params.push(groupId);
+        }
+        return this.db.prepare(`SELECT id, key, summary, tags, category, scope, group_id, agent_visible,
+              created_by, created_at
+       FROM agent_memory
+       WHERE ${where.join(" AND ")}
+       ORDER BY created_at DESC`).all(...params);
+    },
+    /** 审核通过:pending_review=0,隐含 agent_visible=1(审核通过即对 agent 可见)。 */
+    approveMemory(id) {
+        const result = this.db.prepare(`UPDATE agent_memory SET pending_review = 0, agent_visible = 1, updated_at = datetime('now') WHERE id = ?`).run(id);
+        return result.changes > 0;
+    },
+    /** 审核拒绝:active=0。 */
+    rejectMemory(id) {
+        const result = this.db.prepare("UPDATE agent_memory SET active = 0, updated_at = datetime('now') WHERE id = ?").run(id);
+        return result.changes > 0;
+    },
+    /** 死记忆:view_count=0 && age > minAgeDays(只看 agent_visible=1)。 */
+    listStaleMemory(filter = {}) {
+        const { scope, groupId, minAgeDays = 30 } = filter;
+        const where = [
+            "active = 1", "agent_visible = 1", "pending_review = 0", "view_count = 0",
+            `created_at < datetime('now', '-${minAgeDays} days')`,
+        ];
+        const params = [];
+        if (scope) {
+            where.push("scope = ?");
+            params.push(scope);
+        }
+        if (groupId) {
+            where.push("group_id = ?");
+            params.push(groupId);
+        }
+        return this.db.prepare(`SELECT id, key, summary, tags, category, scope, group_id, agent_visible,
+              created_by, created_at
+       FROM agent_memory
+       WHERE ${where.join(" AND ")}
+       ORDER BY created_at ASC`).all(...params);
+    },
+    /** 聚合统计。 */
+    memoryStats(scope, groupId) {
+        const where = ["1=1"];
+        const params = [];
+        if (scope) {
+            where.push("scope = ?");
+            params.push(scope);
+        }
+        if (groupId) {
+            where.push("group_id = ?");
+            params.push(groupId);
+        }
+        const base = `FROM agent_memory WHERE ${where.join(" AND ")}`;
+        const total = this.db.prepare(`SELECT COUNT(*) as n ${base}`).get(...params).n;
+        const active = this.db.prepare(`SELECT COUNT(*) as n ${base} AND active = 1`).get(...params).n;
+        const pending = this.db.prepare(`SELECT COUNT(*) as n ${base} AND active = 1 AND pending_review = 1`).get(...params).n;
+        const byCatRows = this.db.prepare(`SELECT category, COUNT(*) as n ${base} AND active = 1 GROUP BY category`).all(...params);
+        const byCategory = {};
+        for (const r of byCatRows)
+            byCategory[r.category] = r.n;
+        const noteN = this.db.prepare(`SELECT COUNT(*) as n ${base} AND active = 1 AND agent_visible = 0`).get(...params).n;
+        const memN = this.db.prepare(`SELECT COUNT(*) as n ${base} AND active = 1 AND agent_visible = 1`).get(...params).n;
+        const topViewed = this.db.prepare(`SELECT id, key, summary, tags, category, scope, group_id, agent_visible, created_by, created_at
+       ${base} AND active = 1 AND agent_visible = 1
+       ORDER BY view_count DESC LIMIT 5`).all(...params);
+        return {
+            total, active, pending, byCategory,
+            byAgentVisible: { note: noteN, memory: memN },
+            topViewed,
+        };
+    },
+};

package/dist/master/db/messages.js

@@ -0,0 +1,210 @@
+/**
+ * Messages — offline queue, audit log, message log (dashboard conversations),
+ * retention cleanup, and aggregate stats.
+ *
+ * Methods attach to a `MeshDb` instance via `Object.assign`. Cross-module
+ * calls: `enqueueOffline` → `getAgentById` (agents); `stats` → `listAgents`.
+ */
+import { LOG_RETENTION_DAYS } from "../../shared/constants.js";
+export const messageMethods = {
+    // ─────────────────────────────────────────────────────────────────────────
+    // Offline messages
+    // ─────────────────────────────────────────────────────────────────────────
+    enqueueOffline(targetAgent, fromName, fromDomain, payload, routeType) {
+        // Purge expired
+        this.db.prepare("DELETE FROM offline_messages WHERE expires_at < datetime('now')").run();
+        // Check per-agent limit
+        const row = this.db.prepare("SELECT COUNT(*) as c FROM offline_messages WHERE target_agent = ?").get(targetAgent);
+        if (row.c >= 100)
+            return false;
+        // Verify target agent exists
+        const agent = this.getAgentById(targetAgent);
+        if (!agent)
+            return false;
+        this.db.prepare(`
+      INSERT INTO offline_messages (target_agent, from_name, from_domain, payload, route_type, expires_at)
+      VALUES (?, ?, ?, ?, ?, datetime('now', '+1 day'))
+    `).run(targetAgent, fromName, fromDomain || "", payload, routeType);
+        return true;
+    },
+    popOffline(targetAgent) {
+        const msgs = this.db.prepare("SELECT * FROM offline_messages WHERE target_agent = ? AND expires_at > datetime('now') ORDER BY created_at").all(targetAgent);
+        if (msgs.length > 0) {
+            this.db.prepare("DELETE FROM offline_messages WHERE target_agent = ?").run(targetAgent);
+        }
+        return msgs;
+    },
+    // ─────────────────────────────────────────────────────────────────────────
+    // Federation offline messages (跨 master 暂存重投)
+    // ─────────────────────────────────────────────────────────────────────────
+    /**
+     * 暂存一条跨 master FedDeliver(target member 离线时由协调 master 调用)。
+     *
+     * 复用 offline_messages 表(migration 057/059 扩的 3 列),按 target_master_id 主键查重投。
+     * 不做"target agent 是否存在"的校验——member 重连后如果该 agent 还在 agent_visibility
+     * 就投,不在就由 member 端 FedClient.handleDeliver 返回 false,coord 记 route_failed。
+     *
+     * per-member 100 条上限(对齐本地 agent 离线队列)。
+     */
+    enqueueFedOffline(input) {
+        // Purge expired(同 enqueueOffline 的清理时机)
+        this.db.prepare("DELETE FROM offline_messages WHERE expires_at < datetime('now')").run();
+        const row = this.db.prepare("SELECT COUNT(*) as c FROM offline_messages WHERE target_master_id = ?").get(input.target_master_id);
+        if (row.c >= 100)
+            return false;
+        this.db.prepare(`
+      INSERT INTO offline_messages
+        (target_agent, from_name, from_domain, payload, route_type, expires_at,
+         target_hostname, source_master_id, target_master_id)
+      VALUES (?, ?, ?, ?, 'federated', datetime('now', '+1 day'), ?, ?, ?)
+    `).run(input.target_agent, input.source_agent, input.source_hostname, input.payload, input.target_hostname, input.source_master_id, input.target_master_id);
+        return true;
+    },
+    /** 取出并删除某 member 的所有 fed 暂存消息(原子,member 重连时调用) */
+    popFedOfflineByMaster(targetMasterId) {
+        const msgs = this.db.prepare(`SELECT * FROM offline_messages
+       WHERE target_master_id = ? AND expires_at > datetime('now')
+       ORDER BY created_at`).all(targetMasterId);
+        if (msgs.length > 0) {
+            this.db.prepare("DELETE FROM offline_messages WHERE target_master_id = ?").run(targetMasterId);
+        }
+        return msgs;
+    },
+    // ─────────────────────────────────────────────────────────────────────────
+    // Audit
+    // ─────────────────────────────────────────────────────────────────────────
+    audit(entry) {
+        this.db.prepare(`
+      INSERT INTO audit_log (from_name, from_domain, to_name, to_domain, route_type, result, message_summary)
+      VALUES (?, ?, ?, ?, ?, ?, ?)
+    `).run(entry.fromName || null, entry.fromDomain || null, entry.toName || null, entry.toDomain || null, entry.routeType || null, entry.result, entry.messageSummary?.slice(0, 100) || null);
+    },
+    listAudit(limit = 50) {
+        return this.db.prepare("SELECT * FROM audit_log ORDER BY timestamp DESC LIMIT ?").all(limit);
+    },
+    // ─────────────────────────────────────────────────────────────────────────
+    // Config (general key/value)
+    // ─────────────────────────────────────────────────────────────────────────
+    getConfig(key) {
+        const row = this.db.prepare("SELECT value FROM config WHERE key = ?").get(key);
+        return row?.value;
+    },
+    setConfig(key, value) {
+        this.db.prepare("INSERT OR REPLACE INTO config (key, value) VALUES (?, ?)").run(key, value);
+    },
+    // ─────────────────────────────────────────────────────────────────────────
+    // Message log (for dashboard conversations)
+    // ─────────────────────────────────────────────────────────────────────────
+    logMessage(entry) {
+        this.db.prepare(`
+      INSERT INTO message_log (request_id, from_name, from_domain, to_name, to_domain, route_type, direction, payload, status, latency_ms, group_id, source)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `).run(entry.requestId, entry.fromName, entry.fromDomain || null, entry.toName || null, entry.toDomain || null, entry.routeType || null, entry.direction, entry.payload, entry.status, entry.latencyMs ?? null, entry.groupId || null, entry.source || null);
+    },
+    listMessages(opts) {
+        let sql = "SELECT * FROM message_log WHERE 1=1";
+        const params = [];
+        if (opts?.agent) {
+            sql += " AND (from_name = ? OR to_name = ?)";
+            params.push(opts.agent, opts.agent);
+        }
+        if (opts?.from) {
+            sql += " AND from_name = ?";
+            params.push(opts.from);
+        }
+        if (opts?.to) {
+            sql += " AND to_name = ?";
+            params.push(opts.to);
+        }
+        if (opts?.status) {
+            sql += " AND status = ?";
+            params.push(opts.status);
+        }
+        if (opts?.groupId) {
+            sql += " AND group_id = ?";
+            params.push(opts.groupId);
+        }
+        if (opts?.keyword) {
+            sql += " AND payload LIKE ?";
+            params.push(`%${opts.keyword}%`);
+        }
+        if (opts?.before) {
+            sql += " AND timestamp < ?";
+            params.push(opts.before);
+        }
+        sql += " ORDER BY timestamp DESC LIMIT ? OFFSET ?";
+        params.push(Math.min(opts?.limit || 100, 500));
+        params.push(Math.max(opts?.offset || 0, 0));
+        return this.db.prepare(sql).all(...params);
+    },
+    countMessages(opts) {
+        let sql = "SELECT COUNT(*) as total FROM message_log WHERE 1=1";
+        const params = [];
+        if (opts?.agent) {
+            sql += " AND (from_name = ? OR to_name = ?)";
+            params.push(opts.agent, opts.agent);
+        }
+        if (opts?.from) {
+            sql += " AND from_name = ?";
+            params.push(opts.from);
+        }
+        if (opts?.to) {
+            sql += " AND to_name = ?";
+            params.push(opts.to);
+        }
+        if (opts?.status) {
+            sql += " AND status = ?";
+            params.push(opts.status);
+        }
+        if (opts?.groupId) {
+            sql += " AND group_id = ?";
+            params.push(opts.groupId);
+        }
+        if (opts?.keyword) {
+            sql += " AND payload LIKE ?";
+            params.push(`%${opts.keyword}%`);
+        }
+        if (opts?.before) {
+            sql += " AND timestamp < ?";
+            params.push(opts.before);
+        }
+        return this.db.prepare(sql).get(...params).total;
+    },
+    /** Per-agent message stats */
+    agentMessageStats() {
+        return this.db.prepare(`
+      SELECT
+        name,
+        (SELECT COUNT(*) FROM message_log WHERE to_name = agents.name AND direction = 'send') as received,
+        (SELECT COUNT(*) FROM message_log WHERE from_name = agents.name AND direction = 'send') as sent,
+        (SELECT COUNT(*) FROM message_log WHERE to_name = agents.name AND direction = 'reply') as replied,
+        (SELECT COUNT(*) FROM message_log WHERE (from_name = agents.name OR to_name = agents.name) AND status = 'failed') as failed,
+        (SELECT AVG(latency_ms) FROM message_log WHERE to_name = agents.name AND direction = 'reply' AND latency_ms IS NOT NULL) as avg_latency_ms
+      FROM agents
+      ORDER BY name
+    `).all();
+    },
+    // ─────────────────────────────────────────────────────────────────────────
+    // Log cleanup — prevents unbounded table growth
+    // ─────────────────────────────────────────────────────────────────────────
+    /** Delete audit_log and message_log entries older than retention period. */
+    cleanupOldLogs(retentionDays = LOG_RETENTION_DAYS) {
+        const auditResult = this.db.prepare("DELETE FROM audit_log WHERE timestamp < datetime('now', ? || ' days')").run(`-${retentionDays}`);
+        const messageResult = this.db.prepare("DELETE FROM message_log WHERE timestamp < datetime('now', ? || ' days')").run(`-${retentionDays}`);
+        return {
+            auditDeleted: auditResult.changes,
+            messageDeleted: messageResult.changes,
+        };
+    },
+    // ─────────────────────────────────────────────────────────────────────────
+    // Aggregate stats
+    // ─────────────────────────────────────────────────────────────────────────
+    stats() {
+        const agents = this.listAgents();
+        return {
+            total: agents.length,
+            online: agents.filter(a => a.status === "online").length,
+            domains: this.db.prepare("SELECT COUNT(DISTINCT domain) as c FROM agents WHERE domain IS NOT NULL AND domain != ''").get().c,
+        };
+    },
+};

package/dist/master/db/notes.js

@@ -0,0 +1,55 @@
+import { nowBeijing } from "../../shared/time.js";
+import { buildUpdate } from "./build-update.js";
+/** 把 agent_memory 行映射回旧 NoteRow 形状(title/description)。 */
+function rowToNote(row) {
+    return {
+        id: row.id,
+        group_id: row.group_id,
+        title: row.key,
+        description: row.value,
+        created_by: row.created_by ?? "",
+        created_at: row.created_at,
+        updated_at: row.updated_at,
+    };
+}
+export const noteMethods = {
+    createNote(note) {
+        const now = nowBeijing();
+        this.db.prepare(`
+      INSERT INTO agent_memory (
+        id, group_id, scope, category, source_type, source_ref,
+        key, value, summary, tags, visibility, agent_visible,
+        created_by, created_at, updated_at, expires_at,
+        active, pending_review, injected_count, view_count, last_viewed_at
+      ) VALUES (?, ?, 'group', 'note', 'manual', NULL, ?, ?, ?, '[]', 'group', 0, ?, ?, ?, NULL, 1, 0, 0, 0, NULL)
+    `).run(note.id, note.groupId, note.title, note.description || "", (note.description || "").slice(0, 80), note.createdBy, now, now);
+    },
+    getNoteById(id) {
+        const row = this.db.prepare("SELECT * FROM agent_memory WHERE id = ?").get(id);
+        return row ? rowToNote(row) : undefined;
+    },
+    listNotesByGroup(groupId) {
+        const rows = this.db.prepare("SELECT * FROM agent_memory WHERE group_id = ? AND active = 1 ORDER BY created_at DESC").all(groupId);
+        return rows.map(rowToNote);
+    },
+    updateNote(id, fields) {
+        const built = buildUpdate({
+            table: "agent_memory",
+            sets: {
+                key: fields.title,
+                value: fields.description,
+                summary: fields.description !== undefined ? fields.description.slice(0, 80) : undefined,
+            },
+            where: "id = ?",
+            whereParams: [id],
+            updatedAt: "datetime-now",
+        });
+        if (!built)
+            return false;
+        const result = this.db.prepare(built.sql).run(...built.params);
+        return result.changes > 0;
+    },
+    deleteNote(id) {
+        this.db.prepare("UPDATE agent_memory SET active = 0, updated_at = datetime('now') WHERE id = ?").run(id);
+    },
+};

package/dist/master/db/schedule-patterns.js

@@ -0,0 +1,56 @@
+/**
+ * Schedule patterns — 调度模式参考库。
+ *
+ * 常见定时任务模式的样板,供用户在配置群指导模板时学习引用。不直接
+ * 管理 scheduled_tasks 实例。schedule_config 是 JSON 字符串,形如
+ * GuidanceScheduleConfig。
+ *
+ * 种子模式 is_default=1,deleteSchedulePattern 拒绝删除,API 也兜底返回 400。
+ */
+import { buildUpdate } from "./build-update.js";
+export const schedulePatternMethods = {
+    listSchedulePatterns() {
+        return this.db.prepare("SELECT * FROM schedule_patterns ORDER BY sort_order ASC, id ASC").all();
+    },
+    getSchedulePattern(id) {
+        return this.db.prepare("SELECT * FROM schedule_patterns WHERE id = ?")
+            .get(id);
+    },
+    createSchedulePattern(input) {
+        const now = Date.now();
+        const info = this.db.prepare(`
+      INSERT INTO schedule_patterns (
+        name, description, schedule_config, sort_order, is_default, created_at, updated_at
+      ) VALUES (?, ?, ?, ?, 0, ?, ?)
+    `).run(input.name, input.description ?? "", input.schedule_config ?? null, input.sort_order ?? 0, now, now);
+        return this.getSchedulePattern(Number(info.lastInsertRowid));
+    },
+    updateSchedulePattern(id, patch) {
+        const built = buildUpdate({
+            table: "schedule_patterns",
+            sets: {
+                name: patch.name,
+                description: patch.description,
+                schedule_config: patch.schedule_config,
+                sort_order: patch.sort_order,
+            },
+            where: "id = ?",
+            whereParams: [id],
+            updatedAt: "epoch",
+        });
+        if (!built)
+            return this.getSchedulePattern(id);
+        this.db.prepare(built.sql).run(...built.params);
+        return this.getSchedulePattern(id);
+    },
+    /** 删除模式;种子模式(is_default=1)拒绝删除,返回 false。 */
+    deleteSchedulePattern(id) {
+        const row = this.getSchedulePattern(id);
+        if (!row)
+            return false;
+        if (row.is_default === 1)
+            return false;
+        this.db.prepare("DELETE FROM schedule_patterns WHERE id = ?").run(id);
+        return true;
+    },
+};