libero3 0.3.0

package/dist/mcp/server.js

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+/**
+ * libero MCP server — stdio transport entry point (S10 §3.3).
+ *
+ * Usage:
+ *   libero-mcp                            # 默认 DB 在 ~/.libero/libero.db
+ *   DB_PATH=/path/to/libero.db libero-mcp  # 自定义 DB 路径
+ */
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { initDb, closeDb } from "../data/db.js";
+import { buildServer } from "./server-core.js";
+// 默认 DB 在用户家目录的 ~/.libero/libero.db（跨平台、不污染 cwd、符合 XDG-ish 约定）
+// 2026-07-17：原默认 "./data/libero.db" 是相对路径，hermes 启动 libero-mcp 时 cwd 无 ./data/
+// → better-sqlite3 抛 SQLITE_CANTOPEN → 用户看到"缺少数据库目录"。改绝对路径根治。
+const DB_PATH = process.env.DB_PATH ?? join(homedir(), ".libero", "libero.db");
+if (!DB_PATH) {
+    console.error("FATAL: DB_PATH environment variable not set.");
+    process.exit(1);
+}
+const db = initDb(DB_PATH);
+console.error(`[libero-mcp] DB initialized at ${DB_PATH}`);
+const server = buildServer(db);
+const transport = new StdioServerTransport();
+await server.connect(transport);
+console.error(`[libero-mcp] Server connected via stdio`);
+function shutdown() {
+    console.error("[libero-mcp] Shutting down…");
+    closeDb();
+    process.exit(0);
+}
+process.on("SIGINT", shutdown);
+process.on("SIGTERM", shutdown);

package/dist/mcp/src/ap/index.js

@@ -0,0 +1,14 @@
+export function createApTools(repo) {
+    return {
+        credit(input) {
+            return repo.credit(input);
+        },
+        async balance(input) {
+            const balance = await repo.balance(input.user_id);
+            return { balance };
+        },
+        spend(input) {
+            return repo.spend(input);
+        },
+    };
+}

package/dist/mcp/src/ap/rewards.js

@@ -0,0 +1,44 @@
+/**
+ * INT-ap-rewards — 换算曲线纯逻辑（无 IO）。
+ * Spec: libero-homm/docs/specs/INT-ap-rewards.md §3/§4
+ * 原则：单类型第 n 次递减（高频归零防刷，低频保底）；多类型独立计数；周期跟动作频率。
+ * 数值全部占位可调，调参依据 = 粘性数据，不拍脑袋。
+ */
+export const REWARD_CONFIG = {
+    timer: { period: "daily", curve: [5, 4, 3, 2, 1], floor: 0 },
+    schedule: { period: "daily", curve: [4, 3, 2, 1], floor: 0 },
+    task: { period: "daily", curve: [3, 2, 1], floor: 0 },
+    review: { period: "weekly", curve: [5, 3, 1], floor: 1 },
+};
+export const BOUNTY_QUESTS = [
+    { id: "timer-1", action_type: "timer", target: 1, bonus: 3 },
+    { id: "block-3", action_type: "schedule", target: 3, bonus: 3 },
+    { id: "review-1", action_type: "review", target: 1, bonus: 3 },
+];
+export function rewardForNth(type, nth) {
+    const cfg = REWARD_CONFIG[type];
+    return nth <= cfg.curve.length ? cfg.curve[nth - 1] : cfg.floor;
+}
+/** 计时实绩门槛（分钟）：默认 10，env 可调（调参旋钮，spec §2 用户拍板） */
+export function timerMinMinutes(env = process.env) {
+    const v = Number(env.LIBERO_REWARD_TIMER_MIN);
+    return Number.isFinite(v) && v > 0 ? v : 10;
+}
+export function dayKey(d) {
+    const y = d.getFullYear();
+    const m = String(d.getMonth() + 1).padStart(2, "0");
+    const day = String(d.getDate()).padStart(2, "0");
+    return `D:${y}-${m}-${day}`;
+}
+/** ISO 周（周一为周首，含 1/1 的周归属周四所在年） */
+export function isoWeekKey(d) {
+    const date = new Date(Date.UTC(d.getFullYear(), d.getMonth(), d.getDate()));
+    const dayNum = date.getUTCDay() || 7; // 周日=7
+    date.setUTCDate(date.getUTCDate() + 4 - dayNum); // 最近周四
+    const yearStart = new Date(Date.UTC(date.getUTCFullYear(), 0, 1));
+    const week = Math.ceil(((date.getTime() - yearStart.getTime()) / 86400000 + 1) / 7);
+    return `W:${date.getUTCFullYear()}-${String(week).padStart(2, "0")}`;
+}
+export function periodKeyFor(type, now) {
+    return REWARD_CONFIG[type].period === "daily" ? dayKey(now) : isoWeekKey(now);
+}

package/dist/mcp/src/categories/index.js

@@ -0,0 +1,12 @@
+/** Create categories tools backed by the given repository.
+ *  ADR-0001: Dependency-injected — the caller provides the repo, not getDb(). */
+export function createCategoryTools(repo) {
+    return {
+        async getAllCategories() {
+            return repo.getAll();
+        },
+        async getCategoryById(id) {
+            return repo.getById(id);
+        },
+    };
+}

package/dist/mcp/src/chat/from-env.js

@@ -0,0 +1,111 @@
+export function chatLlmFromEnv(env = process.env) {
+    const baseUrl = env.LIBERO_CHAT_BASE_URL?.trim();
+    const apiKey = env.LIBERO_CHAT_API_KEY?.trim();
+    const model = env.LIBERO_CHAT_MODEL?.trim();
+    if (!baseUrl || !apiKey || !model)
+        return null;
+    return new OpenAiCompatChatLlm({ baseUrl, apiKey, model });
+}
+function toOpenAiMessages(messages) {
+    return messages.map((m) => {
+        if (m.role === "tool") {
+            return {
+                role: "tool",
+                tool_call_id: m.toolCallId,
+                name: m.name,
+                content: m.content,
+            };
+        }
+        if (m.role === "assistant") {
+            const tool_calls = m.toolCalls?.map((c) => ({
+                id: c.id,
+                type: "function",
+                function: {
+                    name: c.name,
+                    arguments: JSON.stringify(c.arguments ?? {}),
+                },
+            }));
+            return {
+                role: "assistant",
+                content: m.content,
+                ...(tool_calls && tool_calls.length > 0 ? { tool_calls } : {}),
+            };
+        }
+        return { role: m.role, content: m.content };
+    });
+}
+function parseArgs(raw) {
+    if (typeof raw === "string") {
+        try {
+            const parsed = JSON.parse(raw);
+            if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+                return parsed;
+            }
+        }
+        catch {
+            return {};
+        }
+        return {};
+    }
+    if (raw && typeof raw === "object" && !Array.isArray(raw)) {
+        return raw;
+    }
+    return {};
+}
+export class OpenAiCompatChatLlm {
+    cfg;
+    constructor(cfg) {
+        this.cfg = cfg;
+    }
+    async complete(input) {
+        const url = `${this.cfg.baseUrl.replace(/\/$/, "")}/v1/chat/completions`;
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 90000);
+        try {
+            const res = await fetch(url, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    Authorization: `Bearer ${this.cfg.apiKey}`,
+                },
+                body: JSON.stringify({
+                    model: this.cfg.model,
+                    messages: toOpenAiMessages(input.messages),
+                    tools: input.tools.map((t) => ({
+                        type: "function",
+                        function: {
+                            name: t.name,
+                            description: t.description,
+                            parameters: t.parameters ?? {
+                                type: "object",
+                                additionalProperties: true,
+                            },
+                        },
+                    })),
+                }),
+                signal: controller.signal,
+            });
+            if (!res.ok) {
+                const detail = (await res.text()).slice(0, 240);
+                throw new Error(`chat llm HTTP ${res.status}${detail ? `: ${detail}` : ""}`);
+            }
+            const data = (await res.json());
+            const msg = data.choices?.[0]?.message;
+            const toolCalls = (msg?.tool_calls ?? [])
+                .filter((c) => c.function?.name)
+                .map((c, i) => ({
+                id: c.id || `call_${i}`,
+                name: c.function.name,
+                arguments: parseArgs(c.function.arguments),
+            }));
+            const text = msg?.content?.trim() ? msg.content : undefined;
+            return {
+                ...(text ? { text } : {}),
+                ...(toolCalls.length > 0 ? { toolCalls } : {}),
+            };
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+}

package/dist/mcp/src/chat/history.js

@@ -0,0 +1,35 @@
+/** 20 轮 = 40 条 user/assistant。ponytail: 截断不摘要，爆了再上 summarizer。 */
+export const CHAT_HISTORY_MAX_MESSAGES = 40;
+export function loadRecent(db, conversationKey, limit = CHAT_HISTORY_MAX_MESSAGES) {
+    const rows = db
+        .prepare("SELECT role, content FROM chat_turns WHERE conversation_key = ? ORDER BY id DESC LIMIT ?")
+        .all(conversationKey, limit);
+    rows.reverse();
+    return rows.map((r) => {
+        if (r.role === "assistant") {
+            return { role: "assistant", content: r.content };
+        }
+        return { role: "user", content: r.content };
+    });
+}
+export function appendTurn(db, conversationKey, userText, assistantText) {
+    const now = new Date().toISOString();
+    const ins = db.prepare("INSERT INTO chat_turns (conversation_key, role, content, created_at) VALUES (?, ?, ?, ?)");
+    const prune = db.prepare(`
+    DELETE FROM chat_turns
+    WHERE conversation_key = ?
+      AND id NOT IN (
+        SELECT id FROM (
+          SELECT id FROM chat_turns
+          WHERE conversation_key = ?
+          ORDER BY id DESC
+          LIMIT ?
+        )
+      )
+  `);
+    db.transaction(() => {
+        ins.run(conversationKey, "user", userText, now);
+        ins.run(conversationKey, "assistant", assistantText, now);
+        prune.run(conversationKey, conversationKey, CHAT_HISTORY_MAX_MESSAGES);
+    })();
+}

package/dist/mcp/src/chat/loop.js

@@ -0,0 +1,131 @@
+import { invokeRegisteredTool } from "../rest/invoke-tool.js";
+import { buildChatSystemPrompt } from "./system-prompt.js";
+import { toChatToolParameters } from "./tool-schema.js";
+import { assertUniqueLlmToolNames, fromLlmToolName, toLlmToolName, } from "./tool-names.js";
+import { getDb } from "../../../data/db.js";
+import { appendTurn, loadRecent } from "./history.js";
+import { ensurePortrait } from "./portrait.js";
+function dbOrNull() {
+    try {
+        return getDb();
+    }
+    catch {
+        return null;
+    }
+}
+export const CHAT_MAX_ROUNDS = 8;
+function isManagedChild(db, managerId, childId) {
+    const row = db
+        .prepare("SELECT managed_by FROM user_identity WHERE libero_user_id = ?")
+        .get(childId);
+    return !!row && row.managed_by === managerId;
+}
+export class ChatLoopError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ChatLoopError";
+    }
+}
+function asRecord(args) {
+    if (args && typeof args === "object" && !Array.isArray(args)) {
+        return args;
+    }
+    return {};
+}
+export async function runChatTurn(opts) {
+    const byName = new Map(opts.registry.map((t) => [t.name, t]));
+    const registryNames = opts.registry.map((t) => t.name);
+    assertUniqueLlmToolNames(registryNames);
+    const tools = opts.registry.map((t) => ({
+        name: toLlmToolName(t.name),
+        description: `${t.name}: ${t.description}`,
+        parameters: toChatToolParameters(t.inputSchema),
+    }));
+    const db = dbOrNull();
+    const prior = db && opts.conversationKey ? loadRecent(db, opts.conversationKey) : [];
+    const hommLink = opts.mintLink ? opts.mintLink(opts.userId) : undefined;
+    let system = buildChatSystemPrompt(hommLink);
+    if (db) {
+        const portrait = await ensurePortrait({
+            db,
+            llm: opts.llm,
+            userId: opts.userId,
+        });
+        if (portrait) {
+            system += `\n用户画像（习惯与设置，非近期流水）：${portrait}`;
+        }
+    }
+    const messages = [
+        { role: "system", content: system },
+        ...prior,
+        { role: "user", content: opts.message },
+    ];
+    const toolsCalled = [];
+    for (let round = 0; round < CHAT_MAX_ROUNDS; round++) {
+        const out = await opts.llm.complete({ messages, tools });
+        const calls = out.toolCalls ?? [];
+        if (calls.length > 0) {
+            messages.push({
+                role: "assistant",
+                content: out.text ?? null,
+                toolCalls: calls,
+            });
+            for (const call of calls) {
+                const toolName = fromLlmToolName(call.name, registryNames);
+                toolsCalled.push(toolName);
+                // 身份护栏（2026-08-20 生产教训）：LLM 不得指定身份——user_id/target_user_id
+                // 一律剥掉，由服务端注入。否则计时等写入会落到影子账户（如 "current"），
+                // 用户侧表现为"会话丢失、AP 丢失"。
+                const rawArgs = asRecord(call.arguments);
+                const requestedTarget = typeof rawArgs.target_user_id === "string"
+                    ? rawArgs.target_user_id.trim()
+                    : "";
+                delete rawArgs.user_id;
+                delete rawArgs.target_user_id;
+                if (requestedTarget &&
+                    db &&
+                    isManagedChild(db, opts.userId, requestedTarget)) {
+                    rawArgs.target_user_id = requestedTarget;
+                }
+                const invoked = await invokeRegisteredTool({
+                    byName,
+                    toolName,
+                    rawArgs,
+                    userId: opts.userId,
+                });
+                const content = invoked.ok
+                    ? JSON.stringify(invoked.data)
+                    : JSON.stringify({ error: invoked.message, code: invoked.code });
+                messages.push({
+                    role: "tool",
+                    toolCallId: call.id,
+                    name: call.name,
+                    content,
+                });
+            }
+            continue;
+        }
+        const text = out.text?.trim();
+        if (text) {
+            if (db && opts.conversationKey) {
+                appendTurn(db, opts.conversationKey, opts.message, text);
+            }
+            return { reply: text, toolsCalled };
+        }
+        throw new ChatLoopError("llm returned empty reply");
+    }
+    // 工具环打满时再要一句纯文本，避免微信「刚才没办完（tool loop exceeded）」
+    messages.push({
+        role: "user",
+        content: "停止调工具，用中文直接回复用户：已办成什么、还缺什么确认。",
+    });
+    const wrap = await opts.llm.complete({ messages, tools: [] });
+    const wrapText = wrap.text?.trim();
+    if (wrapText) {
+        if (db && opts.conversationKey) {
+            appendTurn(db, opts.conversationKey, opts.message, wrapText);
+        }
+        return { reply: wrapText, toolsCalled };
+    }
+    throw new ChatLoopError("tool loop exceeded");
+}

package/dist/mcp/src/chat/portrait.js

@@ -0,0 +1,133 @@
+export const PORTRAIT_MAX_CHARS = 200;
+export const PORTRAIT_TTL_MS = 7 * 24 * 60 * 60 * 1000;
+const ACTIVITY_SETTING_KEYS = new Set(["last_inactivity_nudge_at"]);
+export function clipPortrait(text) {
+    return Array.from(text.trim()).slice(0, PORTRAIT_MAX_CHARS).join("");
+}
+export function composePortraitLine(opts) {
+    const parts = [opts.display_name];
+    const fa = opts.settings.focus_areas;
+    if (Array.isArray(fa) && fa.length > 0)
+        parts.push(fa.map(String).join("、"));
+    if (typeof opts.settings.goals === "string" && opts.settings.goals.trim()) {
+        parts.push(opts.settings.goals.trim());
+    }
+    if (opts.expectations?.trim())
+        parts.push(opts.expectations.trim());
+    for (const c of opts.children ?? []) {
+        const bits = [c.display_name?.trim() || "代管对象"];
+        const cfa = c.settings.focus_areas;
+        if (Array.isArray(cfa) && cfa.length > 0)
+            bits.push(cfa.map(String).join("、"));
+        if (typeof c.settings.goals === "string" && c.settings.goals.trim()) {
+            bits.push(c.settings.goals.trim());
+        }
+        parts.push(`代管${bits.join(" ")}`);
+    }
+    return clipPortrait(parts.join("｜"));
+}
+export function settingsForPortrait(settings) {
+    if (!settings)
+        return {};
+    const out = {};
+    for (const [k, v] of Object.entries(settings)) {
+        if (ACTIVITY_SETTING_KEYS.has(k) || v == null)
+            continue;
+        out[k] = v;
+    }
+    return out;
+}
+export function needsPortraitRefresh(row, now = new Date()) {
+    if (row.dirty)
+        return true;
+    if (!row.portrait)
+        return false;
+    if (!row.refreshedAt)
+        return true;
+    const t = Date.parse(row.refreshedAt);
+    if (Number.isNaN(t))
+        return true;
+    return now.getTime() - t >= PORTRAIT_TTL_MS;
+}
+export function markPortraitDirty(db, userId) {
+    db.prepare("UPDATE user_profile SET portrait_dirty = 1 WHERE id = ?").run(userId);
+}
+function loadRow(db, userId) {
+    return db
+        .prepare(`SELECT display_name, expectations, settings, portrait, portrait_refreshed_at, portrait_dirty
+       FROM user_profile WHERE id = ? AND deleted_at IS NULL`)
+        .get(userId);
+}
+export async function ensurePortrait(opts) {
+    const row = loadRow(opts.db, opts.userId);
+    if (!row)
+        return null;
+    if (!needsPortraitRefresh({
+        dirty: row.portrait_dirty,
+        portrait: row.portrait,
+        refreshedAt: row.portrait_refreshed_at,
+    }, opts.now)) {
+        return row.portrait;
+    }
+    const settings = row.settings
+        ? settingsForPortrait(JSON.parse(row.settings))
+        : {};
+    const children = loadManagedChildren(opts.db, opts.userId);
+    const fallback = composePortraitLine({
+        display_name: row.display_name,
+        expectations: row.expectations,
+        settings,
+        children,
+    });
+    const payload = {
+        display_name: row.display_name,
+        expectations: row.expectations,
+        settings,
+        children: children.map((c) => c.display_name),
+    };
+    let text = "";
+    try {
+        const out = await opts.llm.complete({
+            tools: [],
+            messages: [
+                {
+                    role: "system",
+                    content: "把用户的习惯和个人设置压成一行画像，不超过200字。格式：称呼｜领域｜诉求｜固定节奏｜代管。只写稳定习惯与设置，不要写近期做过的具体事、不要写某天日程。只输出画像正文。",
+                },
+                { role: "user", content: JSON.stringify(payload) },
+            ],
+        });
+        text = clipPortrait(out.text ?? "");
+    }
+    catch {
+        text = "";
+    }
+    const saved = text || fallback || row.portrait;
+    const nowIso = (opts.now ?? new Date()).toISOString();
+    opts.db
+        .prepare(`UPDATE user_profile
+       SET portrait = ?, portrait_refreshed_at = ?, portrait_dirty = 0
+       WHERE id = ?`)
+        .run(saved, nowIso, opts.userId);
+    return saved;
+}
+function loadManagedChildren(db, managerId) {
+    try {
+        const rows = db
+            .prepare(`SELECT ui.display_name, up.settings
+         FROM user_identity ui
+         LEFT JOIN user_profile up
+           ON up.id = ui.libero_user_id AND up.deleted_at IS NULL
+         WHERE ui.managed_by = ?`)
+            .all(managerId);
+        return rows.map((r) => ({
+            display_name: r.display_name,
+            settings: r.settings
+                ? settingsForPortrait(JSON.parse(r.settings))
+                : {},
+        }));
+    }
+    catch {
+        return [];
+    }
+}

package/dist/mcp/src/chat/system-prompt.js

@@ -0,0 +1,23 @@
+/** Short system prompt for MC-CHAT tracer. Full skill files are not loaded. */
+const DEFAULT_HOMM_LINK = "https://homm.kuibu.studio/camp.html?t=tk_main";
+export function buildChatSystemPrompt(hommLink = DEFAULT_HOMM_LINK) {
+    return `你是 libero 教练助理。用户的账在服务端工具里。
+问今天/日程/时间表时调用 schedule.timeline，并把返回的 rendered_text 原样给用户，不要改格式。
+需要列表时用 timeblock.list。不要编造用户没有的时间块。
+建日程用 scheduler.createSchedule（title + start_time + end_time，ISO 带时区）。只用于还没发生的计划。
+补录已经发生的事用 timeblock.create（status=completed，尽量带 category_id）。先 schedule.timeline 或 timeblock.list，同一标题+起止已存在就不要再创建。
+问「今天」时不要把 to 截到「现在」导致晚上的块查丢；默认窗口即可，或 to 用当天结束。
+给孩子建档：profile.createUser（display_name，可选 focus_areas/goals）。同一家长下同名会复用已有档案并自动代管，不要反复建、不要再调 setManager。
+查/写孩子账：target_user_id 填 createUser 返回的 libero_user_id（仅代管的孩子）。问孩子今天日程用 schedule.timeline + target_user_id。不要把孩子的事写到家长自己账上。
+提前提醒用 scheduler.setIntent：intent_type=pre_start_reminder、schedule_id、trigger={kind:"absolute",at:ISO}、action_prompt（必填，提醒正文）。不要用 prompt 字段名。
+不要填 user_id（由服务注入）。办完后用一两句话确认给用户。
+
+INT-ap-rewards（用户面只说"任务 + AP"，不解释曲线/递减规则）：
+- 会话首次回复前调 bounties.status：有未完成任务就在回答末尾顺带一句「今天悬赏：专注计时 {n}/1、时间块 {n}/3、复盘 {n}/1，做日常攒 AP」；同一会话只播一次；三项全完成或调用失败就闭嘴不提。
+- 工具返回里带 ap 字段（{amount, bonus?}）时，回复中顺带一句「+{amount} AP 已入账」（有 bonus 再加「，悬赏 +{bonus}」）。没带 ap 字段就不要编造 AP 数字。
+- 本次对话完成了计时（timer.stop）、确认/补录了时间块或复盘收尾后，回答末尾另起一行完整附上（要么整行原样、要么不加，禁止只写图标不写链接）：
+⚔️ 攒 AP 出击：${hommLink}
+- 复盘对话真正收尾时（用户确认到这/方案定了）：先调一次 review.complete 再发收尾语，顺带一句「复盘 +{amount} AP」（amount 用返回值；同一次复盘只调一次）。`;
+}
+/** @deprecated 兼容旧引用；等价 buildChatSystemPrompt() */
+export const CHAT_SYSTEM_PROMPT = buildChatSystemPrompt();

package/dist/mcp/src/chat/tool-names.js

@@ -0,0 +1,27 @@
+/**
+ * OpenAI-compatible function names: ^[a-zA-Z0-9_-]+$
+ * Registry names use dots (schedule.timeline). Map at the LLM boundary only.
+ */
+export function toLlmToolName(name) {
+    return name.replace(/\./g, "_");
+}
+export function fromLlmToolName(wire, registryNames) {
+    const names = [...registryNames];
+    if (names.includes(wire))
+        return wire;
+    const mapped = names.filter((n) => toLlmToolName(n) === wire);
+    if (mapped.length === 1)
+        return mapped[0];
+    return wire;
+}
+export function assertUniqueLlmToolNames(names) {
+    const seen = new Map();
+    for (const n of names) {
+        const w = toLlmToolName(n);
+        const prev = seen.get(w);
+        if (prev && prev !== n) {
+            throw new Error(`LLM tool name collision: ${prev} and ${n} → ${w}`);
+        }
+        seen.set(w, n);
+    }
+}

package/dist/mcp/src/chat/tool-schema.js

@@ -0,0 +1,20 @@
+/**
+ * Convert ToolModule.inputSchema (Zod raw shape or ZodType) → JSON Schema
+ * for OpenAI-compatible tool calling. Without this, models guess args and loop.
+ */
+import { z } from "zod";
+function isZodType(x) {
+    return (!!x &&
+        typeof x === "object" &&
+        "safeParse" in x &&
+        typeof x.safeParse === "function");
+}
+export function toChatToolParameters(inputSchema) {
+    const schema = isZodType(inputSchema)
+        ? inputSchema
+        : z.object(inputSchema);
+    const json = z.toJSONSchema(schema);
+    // OpenAI-compat clients don't need draft $schema; strip to keep payload small.
+    const { $schema: _s, ...rest } = json;
+    return rest;
+}

package/dist/mcp/src/chat/types.js

@@ -0,0 +1 @@
+export {};

package/dist/mcp/src/clock/index.js

@@ -0,0 +1,78 @@
+export function nowUTC() {
+    return new Date().toISOString();
+}
+export function nowLocal(offsetMinutes) {
+    const d = new Date();
+    // Bug 4 修复（2026-07-31）：旧实现多算了一次 getTimezoneOffset()：
+    //   旧代码 utc = d.getTime() + d.getTimezoneOffset()*60000   // ← 把 UTC 毫秒减回本地墙钟当 UTC
+    //   旧代码 local = utc + offset*60000                         // ← 又加 offset
+    // 在生产 TZ=+08 服务器不传参时 offset=480，被双偏移抵消，返回 UTC 墙钟+08:00 后缀
+    // （错位 8 小时）。实测：7/30 22:02:51 北京时间触发的复盘 cron 收到 "14:02:51+08:00"。
+    // 正确逻辑：UTC 毫秒 + offset = 该时区墙钟时间（视为 UTC 格式化）+ 拼后缀。
+    const offset = offsetMinutes ?? -d.getTimezoneOffset();
+    if (offset < -720 || offset > 720) {
+        throw new Error(`Timezone offset ${offset} out of range (must be ±720 minutes)`);
+    }
+    const sign = offset >= 0 ? "+" : "-";
+    const abs = Math.abs(offset);
+    const h = String(Math.floor(abs / 60)).padStart(2, "0");
+    const m = String(abs % 60).padStart(2, "0");
+    const shifted = new Date(d.getTime() + offset * 60000);
+    const iso = shifted.toISOString().replace("Z", "");
+    return `${iso}${sign}${h}:${m}`;
+}
+export function formatTime(isoString, format) {
+    const p = parseTime(isoString);
+    const pad = (n) => String(n).padStart(2, "0");
+    return format
+        .replace("YYYY", String(p.year))
+        .replace("MM", pad(p.month))
+        .replace("DD", pad(p.day))
+        .replace("HH", pad(p.hour))
+        .replace("mm", pad(p.minute))
+        .replace("ss", pad(p.second));
+}
+export function parseTime(isoString) {
+    // Match ISO 8601 with timezone offset
+    const m = isoString.match(/^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})(?:\.\d+)?([+-]\d{2}:\d{2}|Z)$/);
+    if (!m) {
+        throw new Error(`Invalid ISO time string: ${isoString}`);
+    }
+    let offsetMinutes = 0;
+    if (m[7] === "Z") {
+        offsetMinutes = 0;
+    }
+    else {
+        const sign = m[7][0] === "+" ? 1 : -1;
+        const [h, min] = m[7].slice(1).split(":").map(Number);
+        offsetMinutes = sign * (h * 60 + min);
+    }
+    return {
+        year: parseInt(m[1]),
+        month: parseInt(m[2]),
+        day: parseInt(m[3]),
+        hour: parseInt(m[4]),
+        minute: parseInt(m[5]),
+        second: parseInt(m[6]),
+        offsetMinutes,
+    };
+}
+export function getLocalOffset() {
+    return -new Date().getTimezoneOffset();
+}
+/** Convert any ISO string (UTC or with offset) to local timezone ISO string with offset suffix. */
+export function toLocalIso(isoString) {
+    const d = new Date(isoString);
+    if (isNaN(d.getTime())) {
+        throw new Error(`Invalid ISO time string: ${isoString}`);
+    }
+    const offset = getLocalOffset();
+    const sign = offset >= 0 ? "+" : "-";
+    const abs = Math.abs(offset);
+    const h = String(Math.floor(abs / 60)).padStart(2, "0");
+    const m = String(abs % 60).padStart(2, "0");
+    // Shift UTC timestamp by local offset to get "fake UTC" representing local time
+    const local = new Date(d.getTime() + offset * 60000);
+    const iso = local.toISOString().replace("Z", "");
+    return `${iso}${sign}${h}:${m}`;
+}