level-up-mcp-server-cn 0.4.0

package/dist/tools/xp.js

@@ -0,0 +1,670 @@
+// ============================================================
+// tools/xp.ts — Section 8: XP & Progression (5 tools)
+// ============================================================
+// The "read" side of XP — history, summaries, projections,
+// split rules, weekly recaps.
+// ============================================================
+import { z } from "zod";
+import { supabase } from "../services/supabase.js";
+import { ok, handleSupabaseError } from "../services/errors.js";
+import { paginate } from "../services/format.js";
+import { toMcpResponse, logRegistered } from "../services/register.js";
+import { uuidSchema, entityTypeSchema, performerTypeSchema, offsetSchema } from "../schemas/common.js";
+import { verifyOwnership } from "../services/ownership.js";
+// ============================================================
+// Exported handler functions for dispatcher use
+// ============================================================
+export async function handleGetXpHistory(params) {
+    const caller_user_id = params.caller_user_id;
+    const entity_type = params.entity_type;
+    const entity_id = params.entity_id;
+    const source_type = params.source_type;
+    const since = params.since;
+    const limit = params.limit ?? 50;
+    const offset = params.offset ?? 0;
+    const denied = await verifyOwnership({
+        caller_user_id,
+        target_user_id: entity_type === "user" ? entity_id : undefined,
+        target_agent_id: entity_type === "agent" ? entity_id : undefined,
+    });
+    if (denied)
+        return denied;
+    let query = supabase
+        .from("xp_ledger")
+        .select("id, entity_type, entity_id, xp_type, amount, source_type, source_id, description, running_total, tx_hash, chain_verified, chain_id, created_at", { count: "exact" })
+        .eq("entity_type", entity_type)
+        .eq("entity_id", entity_id);
+    if (source_type)
+        query = query.eq("source_type", source_type);
+    if (since)
+        query = query.gte("created_at", since);
+    query = query.order("created_at", { ascending: false }).range(offset, offset + limit - 1);
+    const { data, count, error } = await query;
+    if (error)
+        return toMcpResponse(handleSupabaseError(error, "get_xp_history"));
+    return toMcpResponse(ok(paginate(data || [], count || 0, offset)));
+}
+export async function handleGetXpSummary(params) {
+    const caller_user_id = params.caller_user_id;
+    const entity_type = params.entity_type;
+    const entity_id = params.entity_id;
+    const period = params.period || "all_time";
+    const denied = await verifyOwnership({
+        caller_user_id,
+        target_user_id: entity_type === "user" ? entity_id : undefined,
+        target_agent_id: entity_type === "agent" ? entity_id : undefined,
+    });
+    if (denied)
+        return denied;
+    let query = supabase
+        .from("xp_ledger")
+        .select("amount, source_type, xp_type, chain_verified")
+        .eq("entity_type", entity_type)
+        .eq("entity_id", entity_id);
+    if (period === "week") {
+        const weekAgo = new Date(Date.now() - 7 * 24 * 60 * 60 * 1000).toISOString();
+        query = query.gte("created_at", weekAgo);
+    }
+    else if (period === "month") {
+        const monthAgo = new Date(Date.now() - 30 * 24 * 60 * 60 * 1000).toISOString();
+        query = query.gte("created_at", monthAgo);
+    }
+    const { data: entries, error } = await query;
+    if (error)
+        return toMcpResponse(handleSupabaseError(error, "get_xp_summary"));
+    const rows = entries || [];
+    const totalXp = rows.reduce((sum, r) => sum + (r.amount || 0), 0);
+    const bySource = {};
+    for (const r of rows) {
+        bySource[r.source_type] = (bySource[r.source_type] || 0) + r.amount;
+    }
+    const byType = {};
+    for (const r of rows) {
+        byType[r.xp_type || "main"] = (byType[r.xp_type || "main"] || 0) + r.amount;
+    }
+    const chainVerified = rows.filter((r) => r.chain_verified).reduce((sum, r) => sum + r.amount, 0);
+    return toMcpResponse(ok({
+        entity_type, entity_id, period,
+        total_xp: totalXp,
+        entry_count: rows.length,
+        by_source: bySource,
+        by_type: byType,
+        verification: { chain_verified_xp: chainVerified, unverified_xp: totalXp - chainVerified },
+    }));
+}
+export async function handleGetSplitRules(params) {
+    const performer_type = params.performer_type;
+    const rule_id = params.rule_id;
+    let query = supabase.from("xp_split_rules").select("*");
+    if (performer_type)
+        query = query.eq("performer_type", performer_type);
+    if (rule_id)
+        query = query.eq("id", rule_id);
+    query = query.order("performer_type");
+    const { data: rules, error } = await query;
+    if (error)
+        return toMcpResponse(handleSupabaseError(error, "get_split_rules"));
+    const enriched = await Promise.all((rules || []).map(async (rule) => {
+        const { data: entries } = await supabase
+            .from("xp_split_rule_entries").select("recipient_role, split_pct, sort_order")
+            .eq("rule_id", rule.id).order("sort_order");
+        return { ...rule, entries: entries || [] };
+    }));
+    return toMcpResponse(ok(enriched));
+}
+export async function handleGetXpProjection(params) {
+    const caller_user_id = params.caller_user_id;
+    const entity_type = params.entity_type;
+    const entity_id = params.entity_id;
+    const target_level = params.target_level;
+    const denied = await verifyOwnership({
+        caller_user_id,
+        target_user_id: entity_type === "user" ? entity_id : undefined,
+        target_agent_id: entity_type === "agent" ? entity_id : undefined,
+    });
+    if (denied)
+        return denied;
+    let currentLevel = 1;
+    let currentXp = 0;
+    if (entity_type === "user") {
+        const { data } = await supabase.from("users").select("main_level, main_xp").eq("id", entity_id).single();
+        if (data) {
+            currentLevel = data.main_level;
+            currentXp = data.main_xp;
+        }
+    }
+    else {
+        const { data } = await supabase.from("agents").select("level, xp").eq("id", entity_id).single();
+        if (data) {
+            currentLevel = data.level;
+            currentXp = data.xp;
+        }
+    }
+    const fourWeeksAgo = new Date(Date.now() - 28 * 24 * 60 * 60 * 1000).toISOString();
+    const twoWeeksAgo = new Date(Date.now() - 14 * 24 * 60 * 60 * 1000).toISOString();
+    const { data: recentEntries } = await supabase
+        .from("xp_ledger").select("amount, created_at")
+        .eq("entity_type", entity_type).eq("entity_id", entity_id)
+        .gte("created_at", fourWeeksAgo);
+    const rows = recentEntries || [];
+    const totalRecent = rows.reduce((sum, r) => sum + (r.amount || 0), 0);
+    const weeklyRate = Math.round(totalRecent / 4);
+    const firstHalf = rows.filter((r) => r.created_at < twoWeeksAgo).reduce((s, r) => s + r.amount, 0);
+    const secondHalf = rows.filter((r) => r.created_at >= twoWeeksAgo).reduce((s, r) => s + r.amount, 0);
+    const trend = secondHalf > firstHalf * 1.1 ? "increasing" : secondHalf < firstHalf * 0.9 ? "decreasing" : "stable";
+    const { data: nextCurve } = await supabase
+        .from("level_curves").select("xp_required")
+        .eq("entity_type", entity_type).eq("level", currentLevel + 1).maybeSingle();
+    const xpForNext = nextCurve?.xp_required || 0;
+    const xpRemaining = Math.max(0, xpForNext - currentXp);
+    const weeksToNext = weeklyRate > 0 ? Math.ceil(xpRemaining / weeklyRate) : null;
+    let weeksToTarget = null;
+    if (target_level && target_level > currentLevel) {
+        const { data: targetCurve } = await supabase
+            .from("level_curves").select("cumulative_xp")
+            .eq("entity_type", entity_type).eq("level", target_level).maybeSingle();
+        if (targetCurve && weeklyRate > 0) {
+            const xpToTarget = Math.max(0, targetCurve.cumulative_xp - currentXp);
+            weeksToTarget = Math.ceil(xpToTarget / weeklyRate);
+        }
+    }
+    return toMcpResponse(ok({
+        entity_type, entity_id,
+        current_level: currentLevel,
+        current_xp: currentXp,
+        weekly_xp_rate: weeklyRate,
+        trend,
+        next_level: {
+            level: currentLevel + 1,
+            xp_required: xpForNext,
+            xp_remaining: xpRemaining,
+            estimated_weeks: weeksToNext,
+        },
+        target: target_level ? {
+            level: target_level,
+            estimated_weeks: weeksToTarget,
+        } : null,
+    }));
+}
+export async function handleGetWeeklyRecap(params) {
+    const caller_user_id = params.caller_user_id;
+    const user_id = params.user_id;
+    const include_agents = params.include_agents ?? true;
+    const week_of = params.week_of;
+    const denied = await verifyOwnership({
+        caller_user_id,
+        target_user_id: user_id,
+    });
+    if (denied)
+        return denied;
+    const refDate = week_of ? new Date(week_of) : new Date();
+    const dayOfWeek = refDate.getDay();
+    const mondayOffset = dayOfWeek === 0 ? -6 : 1 - dayOfWeek;
+    const weekStart = new Date(refDate);
+    weekStart.setDate(refDate.getDate() + mondayOffset);
+    weekStart.setHours(0, 0, 0, 0);
+    const weekEnd = new Date(weekStart);
+    weekEnd.setDate(weekStart.getDate() + 7);
+    const startIso = weekStart.toISOString();
+    const endIso = weekEnd.toISOString();
+    const { data: xpEntries } = await supabase
+        .from("xp_ledger").select("amount, source_type, xp_type")
+        .eq("entity_type", "user").eq("entity_id", user_id)
+        .gte("created_at", startIso).lt("created_at", endIso);
+    const xpRows = xpEntries || [];
+    const totalXp = xpRows.reduce((s, r) => s + r.amount, 0);
+    const bySource = {};
+    for (const r of xpRows)
+        bySource[r.source_type] = (bySource[r.source_type] || 0) + r.amount;
+    const { data: tasks } = await supabase
+        .from("tasks").select("id, status, completion_pct, output_type")
+        .eq("user_id", user_id)
+        .gte("created_at", startIso).lt("created_at", endIso);
+    const taskRows = tasks || [];
+    const taskStats = {
+        total: taskRows.length,
+        completed: taskRows.filter((t) => t.status === "completed").length,
+        failed: taskRows.filter((t) => t.status === "failed").length,
+        in_progress: taskRows.filter((t) => t.status === "in_progress").length,
+    };
+    const { data: user } = await supabase
+        .from("users").select("main_level, main_xp, username").eq("id", user_id).single();
+    const { data: classes } = await supabase
+        .from("user_class_progress").select("class_name, class_level, class_xp").eq("user_id", user_id);
+    let agentSummaries = [];
+    if (include_agents) {
+        const { data: agents } = await supabase
+            .from("agents").select("id, name").eq("owner_user_id", user_id).eq("status", "active");
+        agentSummaries = await Promise.all((agents || []).map(async (agent) => {
+            const { data: agentXp } = await supabase
+                .from("xp_ledger").select("amount")
+                .eq("entity_type", "agent").eq("entity_id", agent.id)
+                .gte("created_at", startIso).lt("created_at", endIso);
+            const { count: agentTasks } = await supabase
+                .from("tasks").select("id", { count: "exact", head: true })
+                .eq("agent_id", agent.id).gte("created_at", startIso).lt("created_at", endIso);
+            return {
+                id: agent.id, name: agent.name,
+                xp_this_week: (agentXp || []).reduce((s, r) => s + r.amount, 0),
+                tasks_this_week: agentTasks || 0,
+            };
+        }));
+    }
+    const highlights = [];
+    if (totalXp > 0)
+        highlights.push(`本周获得 ${totalXp} 经验值`);
+    if (taskStats.completed > 0)
+        highlights.push(`完成了 ${taskStats.completed} 个任务`);
+    if (agentSummaries.length > 0) {
+        const topAgent = agentSummaries.sort((a, b) => b.xp_this_week - a.xp_this_week)[0];
+        if (topAgent.xp_this_week > 0)
+            highlights.push(`最佳智能体: ${topAgent.name} (${topAgent.xp_this_week} 经验值)`);
+    }
+    return toMcpResponse(ok({
+        user_id,
+        username: user?.username,
+        week_start: startIso,
+        week_end: endIso,
+        xp: { total: totalXp, by_source: bySource },
+        tasks: taskStats,
+        progress: {
+            main: { level: user?.main_level, xp: user?.main_xp },
+            classes: (classes || []).reduce((m, c) => {
+                m[c.class_name] = { level: c.class_level, xp: c.class_xp };
+                return m;
+            }, {}),
+        },
+        agents: agentSummaries,
+        highlights,
+    }));
+}
+export function registerXpTools(server) {
+    console.error("\n📋 Section 8: XP & Progression");
+    // ================================================================
+    // Tool 52: levelup_get_xp_history
+    // ================================================================
+    server.registerTool("levelup_get_xp_history", {
+        title: "获取经验值历史",
+        description: `获取用户或智能体的经验值账本 — 类似银行对账单的每笔经验值交易。
+
+参数:
+  - caller_user_id (uuid): 你的用户ID（必填 — 用于验证所有权）。
+  - entity_type (string): "user" 或 "agent"。
+  - entity_id (uuid): 哪个用户或智能体。
+  - source_type (string, 可选): 按来源筛选（如 "task"、"quest"、"weekly_bonus"）。
+  - since (string, 可选): ISO时间戳 — 此时间之后的条目。
+  - limit (integer, 可选): 默认 50，最大 100。
+  - offset (integer, 可选): 分页。
+
+返回:
+  包含来源、金额、xp_type、累计总额、区块链字段的分页账本条目。`,
+        inputSchema: {
+            caller_user_id: uuidSchema.describe("Your user ID (ownership verification)"),
+            entity_type: entityTypeSchema,
+            entity_id: uuidSchema.describe("User or agent ID"),
+            source_type: z.string().optional().describe("Filter: task, quest, weekly_bonus, etc."),
+            since: z.string().optional().describe("ISO timestamp"),
+            limit: z.number().int().min(1).max(100).default(50).describe("Max results"),
+            offset: offsetSchema,
+        },
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    }, async (params) => {
+        // Ownership check
+        const denied = await verifyOwnership({
+            caller_user_id: params.caller_user_id,
+            target_user_id: params.entity_type === "user" ? params.entity_id : undefined,
+            target_agent_id: params.entity_type === "agent" ? params.entity_id : undefined,
+        });
+        if (denied)
+            return denied;
+        let query = supabase
+            .from("xp_ledger")
+            .select("id, entity_type, entity_id, xp_type, amount, source_type, source_id, description, running_total, tx_hash, chain_verified, chain_id, created_at", { count: "exact" })
+            .eq("entity_type", params.entity_type)
+            .eq("entity_id", params.entity_id);
+        if (params.source_type)
+            query = query.eq("source_type", params.source_type);
+        if (params.since)
+            query = query.gte("created_at", params.since);
+        query = query.order("created_at", { ascending: false }).range(params.offset, params.offset + params.limit - 1);
+        const { data, count, error } = await query;
+        if (error)
+            return toMcpResponse(handleSupabaseError(error, "get_xp_history"));
+        return toMcpResponse(ok(paginate(data || [], count || 0, params.offset)));
+    });
+    logRegistered("levelup_get_xp_history");
+    // ================================================================
+    // Tool 53: levelup_get_xp_summary
+    // ================================================================
+    server.registerTool("levelup_get_xp_summary", {
+        title: "获取经验值摘要",
+        description: `获取用户或智能体在某时间段的汇总经验值摘要。
+
+参数:
+  - caller_user_id (uuid): 你的用户ID（必填 — 用于验证所有权）。
+  - entity_type (string): "user" 或 "agent"。
+  - entity_id (uuid): 哪个。
+  - period (string, 可选): "week"、"month" 或 "all_time"（默认: "all_time"）。
+
+返回:
+  总经验值、按来源类型分解、按 xp_type（main/class）分解、条目数。`,
+        inputSchema: {
+            caller_user_id: uuidSchema.describe("Your user ID (ownership verification)"),
+            entity_type: entityTypeSchema,
+            entity_id: uuidSchema.describe("User or agent ID"),
+            period: z.enum(["week", "month", "all_time"]).default("all_time").describe("Time period"),
+        },
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    }, async (params) => {
+        // Ownership check
+        const denied = await verifyOwnership({
+            caller_user_id: params.caller_user_id,
+            target_user_id: params.entity_type === "user" ? params.entity_id : undefined,
+            target_agent_id: params.entity_type === "agent" ? params.entity_id : undefined,
+        });
+        if (denied)
+            return denied;
+        let query = supabase
+            .from("xp_ledger")
+            .select("amount, source_type, xp_type, chain_verified")
+            .eq("entity_type", params.entity_type)
+            .eq("entity_id", params.entity_id);
+        // Apply time filter
+        if (params.period === "week") {
+            const weekAgo = new Date(Date.now() - 7 * 24 * 60 * 60 * 1000).toISOString();
+            query = query.gte("created_at", weekAgo);
+        }
+        else if (params.period === "month") {
+            const monthAgo = new Date(Date.now() - 30 * 24 * 60 * 60 * 1000).toISOString();
+            query = query.gte("created_at", monthAgo);
+        }
+        const { data: entries, error } = await query;
+        if (error)
+            return toMcpResponse(handleSupabaseError(error, "get_xp_summary"));
+        const rows = entries || [];
+        const totalXp = rows.reduce((sum, r) => sum + (r.amount || 0), 0);
+        // Breakdown by source
+        const bySource = {};
+        for (const r of rows) {
+            bySource[r.source_type] = (bySource[r.source_type] || 0) + r.amount;
+        }
+        // Breakdown by xp_type
+        const byType = {};
+        for (const r of rows) {
+            byType[r.xp_type || "main"] = (byType[r.xp_type || "main"] || 0) + r.amount;
+        }
+        // Chain verification stats
+        const chainVerified = rows.filter((r) => r.chain_verified).reduce((sum, r) => sum + r.amount, 0);
+        return toMcpResponse(ok({
+            entity_type: params.entity_type,
+            entity_id: params.entity_id,
+            period: params.period,
+            total_xp: totalXp,
+            entry_count: rows.length,
+            by_source: bySource,
+            by_type: byType,
+            verification: { chain_verified_xp: chainVerified, unverified_xp: totalXp - chainVerified },
+        }));
+    });
+    logRegistered("levelup_get_xp_summary");
+    // ================================================================
+    // Tool 54: levelup_get_split_rules
+    // ================================================================
+    server.registerTool("levelup_get_split_rules", {
+        title: "获取分配规则",
+        description: `查看经验值分配规则 — 经验值如何在参与者之间分配。
+
+参数:
+  - performer_type (string, 可选): 按执行者类型筛选。
+  - rule_id (uuid, 可选): 获取特定规则。
+
+返回:
+  包含各接收者百分比、默认标志、区块链可执行性的规则条目。`,
+        inputSchema: {
+            performer_type: performerTypeSchema.optional(),
+            rule_id: uuidSchema.optional().describe("Specific rule ID"),
+        },
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    }, async (params) => {
+        let query = supabase.from("xp_split_rules").select("*");
+        if (params.performer_type)
+            query = query.eq("performer_type", params.performer_type);
+        if (params.rule_id)
+            query = query.eq("id", params.rule_id);
+        query = query.order("performer_type");
+        const { data: rules, error } = await query;
+        if (error)
+            return toMcpResponse(handleSupabaseError(error, "get_split_rules"));
+        // Enrich with entries
+        const enriched = await Promise.all((rules || []).map(async (rule) => {
+            const { data: entries } = await supabase
+                .from("xp_split_rule_entries").select("recipient_role, split_pct, sort_order")
+                .eq("rule_id", rule.id).order("sort_order");
+            return { ...rule, entries: entries || [] };
+        }));
+        return toMcpResponse(ok(enriched));
+    });
+    logRegistered("levelup_get_split_rules");
+    // ================================================================
+    // Tool 55: levelup_get_xp_projection
+    // ================================================================
+    server.registerTool("levelup_get_xp_projection", {
+        title: "获取经验值预测",
+        description: `预测用户或智能体何时达到下一等级（或目标等级）。
+
+根据近期活动计算经验值速率并估算剩余时间。
+
+参数:
+  - caller_user_id (uuid): 你的用户ID（必填 — 用于验证所有权）。
+  - entity_type (string): "user" 或 "agent"。
+  - entity_id (uuid): 哪个。
+  - target_level (integer, 可选): 预测到指定等级。
+
+返回:
+  当前经验值速率（每周）、到下一等级的时间、到目标等级的时间、趋势方向。`,
+        inputSchema: {
+            caller_user_id: uuidSchema.describe("Your user ID (ownership verification)"),
+            entity_type: entityTypeSchema,
+            entity_id: uuidSchema.describe("User or agent ID"),
+            target_level: z.number().int().min(2).max(30).optional().describe("Target level to project to"),
+        },
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    }, async (params) => {
+        // Ownership check
+        const denied = await verifyOwnership({
+            caller_user_id: params.caller_user_id,
+            target_user_id: params.entity_type === "user" ? params.entity_id : undefined,
+            target_agent_id: params.entity_type === "agent" ? params.entity_id : undefined,
+        });
+        if (denied)
+            return denied;
+        // Get current level and XP
+        let currentLevel = 1;
+        let currentXp = 0;
+        if (params.entity_type === "user") {
+            const { data } = await supabase.from("users").select("main_level, main_xp").eq("id", params.entity_id).single();
+            if (data) {
+                currentLevel = data.main_level;
+                currentXp = data.main_xp;
+            }
+        }
+        else {
+            const { data } = await supabase.from("agents").select("level, xp").eq("id", params.entity_id).single();
+            if (data) {
+                currentLevel = data.level;
+                currentXp = data.xp;
+            }
+        }
+        // Get XP earned in last 4 weeks for rate calculation
+        const fourWeeksAgo = new Date(Date.now() - 28 * 24 * 60 * 60 * 1000).toISOString();
+        const twoWeeksAgo = new Date(Date.now() - 14 * 24 * 60 * 60 * 1000).toISOString();
+        const { data: recentEntries } = await supabase
+            .from("xp_ledger").select("amount, created_at")
+            .eq("entity_type", params.entity_type).eq("entity_id", params.entity_id)
+            .gte("created_at", fourWeeksAgo);
+        const rows = recentEntries || [];
+        const totalRecent = rows.reduce((sum, r) => sum + (r.amount || 0), 0);
+        const weeklyRate = Math.round(totalRecent / 4);
+        // Trend: compare first 2 weeks vs last 2 weeks
+        const firstHalf = rows.filter((r) => r.created_at < twoWeeksAgo).reduce((s, r) => s + r.amount, 0);
+        const secondHalf = rows.filter((r) => r.created_at >= twoWeeksAgo).reduce((s, r) => s + r.amount, 0);
+        const trend = secondHalf > firstHalf * 1.1 ? "increasing" : secondHalf < firstHalf * 0.9 ? "decreasing" : "stable";
+        // Get level curve for next level
+        const { data: nextCurve } = await supabase
+            .from("level_curves").select("xp_required")
+            .eq("entity_type", params.entity_type).eq("level", currentLevel + 1).maybeSingle();
+        const xpForNext = nextCurve?.xp_required || 0;
+        const xpRemaining = Math.max(0, xpForNext - currentXp);
+        const weeksToNext = weeklyRate > 0 ? Math.ceil(xpRemaining / weeklyRate) : null;
+        // Target level projection
+        let weeksToTarget = null;
+        if (params.target_level && params.target_level > currentLevel) {
+            const { data: targetCurve } = await supabase
+                .from("level_curves").select("cumulative_xp")
+                .eq("entity_type", params.entity_type).eq("level", params.target_level).maybeSingle();
+            if (targetCurve && weeklyRate > 0) {
+                const xpToTarget = Math.max(0, targetCurve.cumulative_xp - currentXp);
+                weeksToTarget = Math.ceil(xpToTarget / weeklyRate);
+            }
+        }
+        return toMcpResponse(ok({
+            entity_type: params.entity_type,
+            entity_id: params.entity_id,
+            current_level: currentLevel,
+            current_xp: currentXp,
+            weekly_xp_rate: weeklyRate,
+            trend,
+            next_level: {
+                level: currentLevel + 1,
+                xp_required: xpForNext,
+                xp_remaining: xpRemaining,
+                estimated_weeks: weeksToNext,
+            },
+            target: params.target_level ? {
+                level: params.target_level,
+                estimated_weeks: weeksToTarget,
+            } : null,
+        }));
+    });
+    logRegistered("levelup_get_xp_projection");
+    // ================================================================
+    // Tool 56: levelup_get_weekly_recap
+    // ================================================================
+    server.registerTool("levelup_get_weekly_recap", {
+        title: "获取每周回顾",
+        description: `用户的每周摘要 — 经验值、任务、技能、连续记录、智能体活动、亮点。
+
+参数:
+  - caller_user_id (uuid): 你的用户ID（必填 — 用于验证所有权）。
+  - user_id (uuid): 哪个用户（必须是你自己）。
+  - include_agents (boolean, 可选): 包含智能体摘要（默认: true）。
+  - week_of (string, 可选): 该周的ISO日期（默认: 当前周）。
+
+返回:
+  经验值分解、任务统计、等级进度、智能体摘要、预计算亮点。`,
+        inputSchema: {
+            caller_user_id: uuidSchema.describe("Your user ID (ownership verification)"),
+            user_id: uuidSchema.describe("The user (must be you)"),
+            include_agents: z.boolean().default(true).describe("Include agent summaries"),
+            week_of: z.string().optional().describe("ISO date for the week (default: current)"),
+        },
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    }, async (params) => {
+        // Ownership check
+        const denied = await verifyOwnership({
+            caller_user_id: params.caller_user_id,
+            target_user_id: params.user_id,
+        });
+        if (denied)
+            return denied;
+        // Determine week boundaries (Monday to Sunday)
+        const refDate = params.week_of ? new Date(params.week_of) : new Date();
+        const dayOfWeek = refDate.getDay();
+        const mondayOffset = dayOfWeek === 0 ? -6 : 1 - dayOfWeek;
+        const weekStart = new Date(refDate);
+        weekStart.setDate(refDate.getDate() + mondayOffset);
+        weekStart.setHours(0, 0, 0, 0);
+        const weekEnd = new Date(weekStart);
+        weekEnd.setDate(weekStart.getDate() + 7);
+        const startIso = weekStart.toISOString();
+        const endIso = weekEnd.toISOString();
+        // User XP this week
+        const { data: xpEntries } = await supabase
+            .from("xp_ledger").select("amount, source_type, xp_type")
+            .eq("entity_type", "user").eq("entity_id", params.user_id)
+            .gte("created_at", startIso).lt("created_at", endIso);
+        const xpRows = xpEntries || [];
+        const totalXp = xpRows.reduce((s, r) => s + r.amount, 0);
+        const bySource = {};
+        for (const r of xpRows)
+            bySource[r.source_type] = (bySource[r.source_type] || 0) + r.amount;
+        // Tasks this week
+        const { data: tasks } = await supabase
+            .from("tasks").select("id, status, completion_pct, output_type")
+            .eq("user_id", params.user_id)
+            .gte("created_at", startIso).lt("created_at", endIso);
+        const taskRows = tasks || [];
+        const taskStats = {
+            total: taskRows.length,
+            completed: taskRows.filter((t) => t.status === "completed").length,
+            failed: taskRows.filter((t) => t.status === "failed").length,
+            in_progress: taskRows.filter((t) => t.status === "in_progress").length,
+        };
+        // User progress
+        const { data: user } = await supabase
+            .from("users").select("main_level, main_xp, username").eq("id", params.user_id).single();
+        const { data: classes } = await supabase
+            .from("user_class_progress").select("class_name, class_level, class_xp").eq("user_id", params.user_id);
+        // Agent summaries
+        let agentSummaries = [];
+        if (params.include_agents) {
+            const { data: agents } = await supabase
+                .from("agents").select("id, name").eq("owner_user_id", params.user_id).eq("status", "active");
+            agentSummaries = await Promise.all((agents || []).map(async (agent) => {
+                const { data: agentXp } = await supabase
+                    .from("xp_ledger").select("amount")
+                    .eq("entity_type", "agent").eq("entity_id", agent.id)
+                    .gte("created_at", startIso).lt("created_at", endIso);
+                const { count: agentTasks } = await supabase
+                    .from("tasks").select("id", { count: "exact", head: true })
+                    .eq("agent_id", agent.id).gte("created_at", startIso).lt("created_at", endIso);
+                return {
+                    id: agent.id, name: agent.name,
+                    xp_this_week: (agentXp || []).reduce((s, r) => s + r.amount, 0),
+                    tasks_this_week: agentTasks || 0,
+                };
+            }));
+        }
+        // Build highlights
+        const highlights = [];
+        if (totalXp > 0)
+            highlights.push(`本周获得 ${totalXp} 经验值`);
+        if (taskStats.completed > 0)
+            highlights.push(`完成了 ${taskStats.completed} 个任务`);
+        if (agentSummaries.length > 0) {
+            const topAgent = agentSummaries.sort((a, b) => b.xp_this_week - a.xp_this_week)[0];
+            if (topAgent.xp_this_week > 0)
+                highlights.push(`最佳智能体: ${topAgent.name} (${topAgent.xp_this_week} 经验值)`);
+        }
+        return toMcpResponse(ok({
+            user_id: params.user_id,
+            username: user?.username,
+            week_start: startIso,
+            week_end: endIso,
+            xp: { total: totalXp, by_source: bySource },
+            tasks: taskStats,
+            progress: {
+                main: { level: user?.main_level, xp: user?.main_xp },
+                classes: (classes || []).reduce((m, c) => {
+                    m[c.class_name] = { level: c.class_level, xp: c.class_xp };
+                    return m;
+                }, {}),
+            },
+            agents: agentSummaries,
+            highlights,
+        }));
+    });
+    logRegistered("levelup_get_weekly_recap");
+    console.error(`  → 5 of 5 XP tools registered ✅`);
+}
+//# sourceMappingURL=xp.js.map