libero-mcp 0.2.26 → 0.3.0

package/data/migrations/017_ap_wallet.sql

@@ -0,0 +1,25 @@
+-- INT-AP-tools R2 (2026-08-14): AP 账真源在 libero.db
+-- 契约: libero-homm/docs/specs/INT-AP-tools.md §3
+CREATE TABLE IF NOT EXISTS ap_wallet (
+  user_id TEXT PRIMARY KEY,
+  balance INTEGER NOT NULL DEFAULT 0,
+  updated_at TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS ap_credit_log (
+  user_id TEXT NOT NULL,
+  idempotency_key TEXT NOT NULL,
+  amount INTEGER NOT NULL,
+  source TEXT NOT NULL,
+  created_at TEXT NOT NULL,
+  UNIQUE(user_id, idempotency_key)
+);
+
+-- spend 幂等同 credit：同 key 只扣一次（spec §2b）
+CREATE TABLE IF NOT EXISTS ap_spend_log (
+  user_id TEXT NOT NULL,
+  idempotency_key TEXT NOT NULL,
+  amount INTEGER NOT NULL,
+  created_at TEXT NOT NULL,
+  UNIQUE(user_id, idempotency_key)
+);

package/data/migrations/018_ap_rewards.sql

@@ -0,0 +1,21 @@
+-- INT-ap-rewards (2026-08-19): AP 换算引擎计数与事件幂等
+-- 契约: libero-homm/docs/specs/INT-ap-rewards.md §4
+CREATE TABLE IF NOT EXISTS ap_reward_log (
+  user_id TEXT NOT NULL,
+  event_id TEXT NOT NULL,
+  action_type TEXT NOT NULL,
+  period_key TEXT NOT NULL,
+  nth INTEGER NOT NULL,
+  amount INTEGER NOT NULL,
+  created_at TEXT NOT NULL,
+  UNIQUE(user_id, event_id)
+);
+
+CREATE TABLE IF NOT EXISTS ap_reward_counter (
+  user_id TEXT NOT NULL,
+  action_type TEXT NOT NULL,
+  period_key TEXT NOT NULL,
+  count INTEGER NOT NULL DEFAULT 0,
+  updated_at TEXT NOT NULL,
+  PRIMARY KEY (user_id, action_type, period_key)
+);

package/data/migrations/019_ap_bounty.sql

@@ -0,0 +1,10 @@
+-- INT-ap-rewards 悬赏（方案 A，2026-08-19）：每日任务完成奖金，一日一任务只发一次
+-- 契约: libero-homm/docs/specs/INT-ap-rewards.md §悬赏
+CREATE TABLE IF NOT EXISTS ap_bounty_log (
+  user_id TEXT NOT NULL,
+  date_key TEXT NOT NULL,
+  quest_id TEXT NOT NULL,
+  bonus INTEGER NOT NULL,
+  created_at TEXT NOT NULL,
+  UNIQUE(user_id, date_key, quest_id)
+);

package/data/migrations/020_chat_turns.sql

@@ -0,0 +1,10 @@
+-- 微信/REST chat 多轮上下文（2026-08-19）
+-- 只存 user/assistant 正文；tool 轮次不落盘
+CREATE TABLE IF NOT EXISTS chat_turns (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  conversation_key TEXT NOT NULL,
+  role TEXT NOT NULL,
+  content TEXT NOT NULL,
+  created_at TEXT NOT NULL
+);
+CREATE INDEX IF NOT EXISTS idx_chat_turns_key_id ON chat_turns (conversation_key, id);

package/data/migrations/021_portrait.sql

@@ -0,0 +1,4 @@
+-- 账户画像：习惯与个人设置（非近期动作）。200 字硬顶，脏标记 + 刷新时间。
+ALTER TABLE user_profile ADD COLUMN portrait TEXT;
+ALTER TABLE user_profile ADD COLUMN portrait_refreshed_at TEXT;
+ALTER TABLE user_profile ADD COLUMN portrait_dirty INTEGER NOT NULL DEFAULT 0;

package/data/migrations/022_family_emoji_single.sql

@@ -0,0 +1,3 @@
+-- 2026-09-02: 陪伴分类 👨‍👩‍👧（ZWJ 三人组）在 emoji 矩阵里占 3 格宽导致错位，
+-- 统一为单字素 👶（用户拍板：照顾孩子类用单一 emoji）。
+UPDATE categories SET emoji = '👶' WHERE id = 'cat-family';

package/data/migrations/023_ap_balance_view_log.sql

@@ -0,0 +1,9 @@
+-- S3：看余额埋点（INT-mvp-100 游戏拉动信号）。只追加，不幂等去重——每次查询都是一次「看」。
+CREATE TABLE IF NOT EXISTS ap_balance_view_log (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  user_id TEXT NOT NULL,
+  balance INTEGER NOT NULL,
+  created_at TEXT NOT NULL
+);
+CREATE INDEX IF NOT EXISTS idx_ap_balance_view_user_created
+  ON ap_balance_view_log (user_id, created_at);

package/dist/data/migrations/017_ap_wallet.sql

@@ -0,0 +1,25 @@
+-- INT-AP-tools R2 (2026-08-14): AP 账真源在 libero.db
+-- 契约: libero-homm/docs/specs/INT-AP-tools.md §3
+CREATE TABLE IF NOT EXISTS ap_wallet (
+  user_id TEXT PRIMARY KEY,
+  balance INTEGER NOT NULL DEFAULT 0,
+  updated_at TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS ap_credit_log (
+  user_id TEXT NOT NULL,
+  idempotency_key TEXT NOT NULL,
+  amount INTEGER NOT NULL,
+  source TEXT NOT NULL,
+  created_at TEXT NOT NULL,
+  UNIQUE(user_id, idempotency_key)
+);
+
+-- spend 幂等同 credit：同 key 只扣一次（spec §2b）
+CREATE TABLE IF NOT EXISTS ap_spend_log (
+  user_id TEXT NOT NULL,
+  idempotency_key TEXT NOT NULL,
+  amount INTEGER NOT NULL,
+  created_at TEXT NOT NULL,
+  UNIQUE(user_id, idempotency_key)
+);

package/dist/data/migrations/018_ap_rewards.sql

@@ -0,0 +1,21 @@
+-- INT-ap-rewards (2026-08-19): AP 换算引擎计数与事件幂等
+-- 契约: libero-homm/docs/specs/INT-ap-rewards.md §4
+CREATE TABLE IF NOT EXISTS ap_reward_log (
+  user_id TEXT NOT NULL,
+  event_id TEXT NOT NULL,
+  action_type TEXT NOT NULL,
+  period_key TEXT NOT NULL,
+  nth INTEGER NOT NULL,
+  amount INTEGER NOT NULL,
+  created_at TEXT NOT NULL,
+  UNIQUE(user_id, event_id)
+);
+
+CREATE TABLE IF NOT EXISTS ap_reward_counter (
+  user_id TEXT NOT NULL,
+  action_type TEXT NOT NULL,
+  period_key TEXT NOT NULL,
+  count INTEGER NOT NULL DEFAULT 0,
+  updated_at TEXT NOT NULL,
+  PRIMARY KEY (user_id, action_type, period_key)
+);

package/dist/data/migrations/019_ap_bounty.sql

@@ -0,0 +1,10 @@
+-- INT-ap-rewards 悬赏（方案 A，2026-08-19）：每日任务完成奖金，一日一任务只发一次
+-- 契约: libero-homm/docs/specs/INT-ap-rewards.md §悬赏
+CREATE TABLE IF NOT EXISTS ap_bounty_log (
+  user_id TEXT NOT NULL,
+  date_key TEXT NOT NULL,
+  quest_id TEXT NOT NULL,
+  bonus INTEGER NOT NULL,
+  created_at TEXT NOT NULL,
+  UNIQUE(user_id, date_key, quest_id)
+);

package/dist/data/migrations/020_chat_turns.sql

@@ -0,0 +1,10 @@
+-- 微信/REST chat 多轮上下文（2026-08-19）
+-- 只存 user/assistant 正文；tool 轮次不落盘
+CREATE TABLE IF NOT EXISTS chat_turns (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  conversation_key TEXT NOT NULL,
+  role TEXT NOT NULL,
+  content TEXT NOT NULL,
+  created_at TEXT NOT NULL
+);
+CREATE INDEX IF NOT EXISTS idx_chat_turns_key_id ON chat_turns (conversation_key, id);

package/dist/data/migrations/021_portrait.sql

@@ -0,0 +1,4 @@
+-- 账户画像：习惯与个人设置（非近期动作）。200 字硬顶，脏标记 + 刷新时间。
+ALTER TABLE user_profile ADD COLUMN portrait TEXT;
+ALTER TABLE user_profile ADD COLUMN portrait_refreshed_at TEXT;
+ALTER TABLE user_profile ADD COLUMN portrait_dirty INTEGER NOT NULL DEFAULT 0;

package/dist/data/migrations/022_family_emoji_single.sql

@@ -0,0 +1,3 @@
+-- 2026-09-02: 陪伴分类 👨‍👩‍👧（ZWJ 三人组）在 emoji 矩阵里占 3 格宽导致错位，
+-- 统一为单字素 👶（用户拍板：照顾孩子类用单一 emoji）。
+UPDATE categories SET emoji = '👶' WHERE id = 'cat-family';

package/dist/data/migrations/023_ap_balance_view_log.sql

@@ -0,0 +1,9 @@
+-- S3：看余额埋点（INT-mvp-100 游戏拉动信号）。只追加，不幂等去重——每次查询都是一次「看」。
+CREATE TABLE IF NOT EXISTS ap_balance_view_log (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  user_id TEXT NOT NULL,
+  balance INTEGER NOT NULL,
+  created_at TEXT NOT NULL
+);
+CREATE INDEX IF NOT EXISTS idx_ap_balance_view_user_created
+  ON ap_balance_view_log (user_id, created_at);

package/dist/mcp/contract/v1/rest.js

@@ -0,0 +1,56 @@
+/**
+ * MC-0b REST contract v1 — single source of truth (api-contract-first).
+ *
+ * REST adapter and tests bind these schemas. Do not invent parallel field names.
+ */
+import { z } from "zod";
+export const restErrorCodeSchema = z.enum([
+    "unauthorized",
+    "forbidden",
+    "not_found",
+    "invalid_input",
+    "tool_error",
+    "internal",
+    "unavailable",
+    "llm_error",
+]);
+export const restErrorBodySchema = z.object({
+    ok: z.literal(false),
+    error: z.object({
+        code: restErrorCodeSchema,
+        message: z.string().min(1),
+    }),
+});
+export const restSuccessBodySchema = z.object({
+    ok: z.literal(true),
+    data: z.unknown(),
+});
+export const restHealthBodySchema = z.object({
+    ok: z.literal(true),
+});
+export const chatRequestBodySchema = z.object({
+    message: z.string().min(1),
+});
+export const chatSuccessBodySchema = z.object({
+    ok: z.literal(true),
+    reply: z.string().min(1),
+    tools_called: z.array(z.string()),
+});
+/** INT-AP-tools — request/response data (fields bind to libero-homm spec). */
+export const apCreditDataSchema = z.object({
+    balance: z.number().int().nonnegative(),
+    credited: z.number().int().positive(),
+    source: z.string().min(1),
+});
+export const apBalanceDataSchema = z.object({
+    balance: z.number().int().nonnegative(),
+});
+export const apSpendDataSchema = z.object({
+    balance: z.number().int().nonnegative(),
+    spent: z.number().int().positive(),
+});
+export const REST_V1 = {
+    health: { method: "GET", path: "/api/v1/health" },
+    invokeTool: { method: "POST", path: "/api/v1/tools/:toolName" },
+    chat: { method: "POST", path: "/api/v1/chat" },
+};

package/dist/mcp/rest-server.js

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+/**
+ * libero REST server — HTTP adapter over the same tool registry (MC-0b).
+ *
+ * Usage:
+ *   LIBERO_REST_TOKENS='{"<token>":"<libero_user_id>"}' libero-rest
+ *   DB_PATH=/path/to/libero.db LIBERO_REST_PORT=8787 libero-rest
+ *
+ * Default bind 127.0.0.1 (local trial). Same DB_PATH as MCP → same ledger.
+ */
+import { serve } from "@hono/node-server";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { initDb, closeDb } from "../data/db.js";
+import { createToolRuntime } from "./server-core.js";
+import { createRestApp } from "./src/rest/app.js";
+import { parseRestTokens } from "./src/rest/tokens.js";
+import { chatLlmFromEnv } from "./src/chat/from-env.js";
+const DB_PATH = process.env.DB_PATH ?? join(homedir(), ".libero", "libero.db");
+const PORT = Number(process.env.LIBERO_REST_PORT ?? "8787");
+const HOST = process.env.LIBERO_REST_HOST ?? "127.0.0.1";
+let tokenMap;
+try {
+    tokenMap = parseRestTokens(process.env);
+}
+catch (e) {
+    console.error(`[libero-rest] FATAL: ${e.message}`);
+    process.exit(1);
+}
+const db = initDb(DB_PATH);
+console.error(`[libero-rest] DB initialized at ${DB_PATH}`);
+const { registry } = createToolRuntime(db);
+const chatLlm = chatLlmFromEnv(process.env);
+if (!chatLlm) {
+    console.error("[libero-rest] chat disabled: set LIBERO_CHAT_BASE_URL, LIBERO_CHAT_API_KEY, LIBERO_CHAT_MODEL");
+}
+const linkSecret = process.env.LIBERO_LINK_TOKEN_SECRET?.trim() || undefined;
+const linkBaseUrl = process.env.LIBERO_HOMM_LINK_BASE?.trim() || undefined;
+const ttlSec = process.env.LIBERO_LINK_TOKEN_TTL_SEC ? Number(process.env.LIBERO_LINK_TOKEN_TTL_SEC) : undefined;
+if (!linkSecret)
+    console.warn("[libero-rest] LIBERO_LINK_TOKEN_SECRET 未配置：homm 链接回退 tk_main（无逐用户短 token）");
+const app = createRestApp({ registry, tokenMap, chatLlm: chatLlm ?? undefined, linkSecret, linkBaseUrl, ttlSec });
+serve({ fetch: app.fetch, port: PORT, hostname: HOST }, (info) => {
+    console.error(`[libero-rest] listening on http://${info.address}:${info.port}`);
+});
+function shutdown() {
+    console.error("[libero-rest] Shutting down…");
+    closeDb();
+    process.exit(0);
+}
+process.on("SIGINT", shutdown);
+process.on("SIGTERM", shutdown);