@chriscurrycc/memos-mcp 0.2.0 → 1.0.0

package/dist/tools/relations.js

@@ -1,40 +1,125 @@
 import { z } from "zod";
-export const registerRelationTools = (server, client) => {
-    server.tool("list_memo_relations", "List relations of a memo (references and comments)", {
-        id: z.number().int().describe("Memo ID"),
-    }, async ({ id }) => {
+async function resolveToNumericId(client, id) {
+    if (/^\d+$/.test(id)) {
+        return parseInt(id, 10);
+    }
+    const memo = await client.get(`/api/v1/memos:by-uid/${id}`);
+    const match = memo.name.match(/^memos\/(\d+)$/);
+    if (!match)
+        throw new Error(`Unexpected memo name format: ${memo.name}`);
+    return parseInt(match[1], 10);
+}
+function extractId(memoRef) {
+    const name = typeof memoRef === "string" ? memoRef : memoRef?.name;
+    if (!name || typeof name !== "string")
+        return undefined;
+    const match = name.match(/^memos\/(\d+)$/);
+    return match ? parseInt(match[1], 10) : undefined;
+}
+async function buildRelationGraph(client, startId, maxDepth) {
+    const visited = new Set();
+    const edges = [];
+    const edgeSet = new Set();
+    const queue = [{ id: startId, depth: 0 }];
+    while (queue.length > 0) {
+        const { id, depth } = queue.shift();
+        if (visited.has(id))
+            continue;
+        visited.add(id);
         const result = await client.get(`/api/v1/memos/${id}/relations`);
-        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        for (const r of result.relations || []) {
+            const fromId = extractId(r.memo);
+            const toId = extractId(r.relatedMemo);
+            if (fromId === undefined || toId === undefined)
+                continue;
+            const edgeKey = `${fromId}->${toId}:${r.type}`;
+            if (edgeSet.has(edgeKey))
+                continue;
+            edgeSet.add(edgeKey);
+            edges.push({ from: fromId, to: toId, type: r.type });
+            const neighborId = fromId === id ? toId : fromId;
+            if (depth < maxDepth && !visited.has(neighborId)) {
+                queue.push({ id: neighborId, depth: depth + 1 });
+            }
+        }
+    }
+    return { nodes: [...visited], edges };
+}
+export const registerRelationTools = (server, client) => {
+    server.registerTool("list_memo_relations", {
+        description: [
+            "List relations of a memo. Returns edges with direction (from → to) and type.",
+            "- depth=1 (default): direct relations only.",
+            "- depth=2+: recursively expand related memos to build a relation graph.",
+            "Each edge shows {from, to, type}. Use get_memo to inspect specific nodes.",
+        ].join(" "),
+        inputSchema: {
+            id: z.string().min(1).describe("Memo identifier. Numeric ID or UID string"),
+            depth: z.number().int().min(1).max(5).default(1).describe("How many levels deep to traverse. 1 = direct relations, 2+ = recursive graph"),
+        },
+        annotations: { readOnlyHint: true, openWorldHint: false },
+    }, async ({ id, depth }) => {
+        const numericId = await resolveToNumericId(client, id);
+        const { nodes, edges } = await buildRelationGraph(client, numericId, depth);
+        if (edges.length === 0) {
+            return { content: [{ type: "text", text: "No relations found." }] };
+        }
+        const output = {
+            startNode: numericId,
+            nodes,
+            edges,
+        };
+        return { content: [{ type: "text", text: JSON.stringify(output, null, 2) }] };
     });
-    server.tool("set_memo_relations", "Set relations for a memo (replaces all existing relations)", {
-        id: z.number().int().describe("Memo ID"),
-        relations: z
-            .array(z.object({
-            relatedMemoId: z.number().int().describe("Related memo ID"),
-            type: z.enum(["REFERENCE", "COMMENT"]).describe("Relation type"),
-        }))
-            .describe("List of relations to set"),
-    }, async ({ id, relations }) => {
+    server.registerTool("set_memo_relations", {
+        description: [
+            "Add or remove REFERENCE relations for a memo.",
+            "- action=\"add\": add new references without affecting existing ones.",
+            "- action=\"remove\": remove specific references.",
+            "Note: COMMENT relations are managed by the system and cannot be modified here.",
+        ].join(" "),
+        inputSchema: {
+            id: z.string().min(1).describe("Memo identifier. Numeric ID or UID string"),
+            action: z.enum(["add", "remove"]).describe("Whether to add or remove relations"),
+            targetIds: z.array(z.string().min(1)).min(1).describe("IDs of memos to add/remove as references. Numeric IDs or UID strings"),
+        },
+        annotations: { destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    }, async ({ id, action, targetIds }) => {
+        const numericId = await resolveToNumericId(client, id);
+        const resolvedTargets = await Promise.all(targetIds.map((t) => resolveToNumericId(client, t)));
+        const current = await client.get(`/api/v1/memos/${numericId}/relations`);
+        const existing = (current.relations || []).filter((r) => extractId(r.memo) === numericId && r.type === "REFERENCE");
+        let finalIds;
+        if (action === "add") {
+            const existingIds = new Set(existing.map((r) => extractId(r.relatedMemo)));
+            finalIds = [
+                ...existing.map((r) => extractId(r.relatedMemo)),
+                ...resolvedTargets.filter((t) => !existingIds.has(t)),
+            ];
+        }
+        else {
+            const removeSet = new Set(resolvedTargets);
+            finalIds = existing
+                .map((r) => extractId(r.relatedMemo))
+                .filter((rid) => !removeSet.has(rid));
+        }
         const body = {
-            relations: relations.map((r) => ({
-                memo: `memos/${id}`,
-                relatedMemo: `memos/${r.relatedMemoId}`,
-                type: r.type,
+            relations: finalIds.map((targetId) => ({
+                memo: { name: `memos/${numericId}` },
+                relatedMemo: { name: `memos/${targetId}` },
+                type: "REFERENCE",
             })),
         };
-        const result = await client.patch(`/api/v1/memos/${id}/relations`, body);
-        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
-    });
-    server.tool("delete_memo_relation", "Remove a specific relation from a memo", {
-        id: z.number().int().describe("Memo ID"),
-        relatedMemoId: z.number().int().describe("Related memo ID to unlink"),
-        type: z.enum(["REFERENCE", "COMMENT"]).describe("Relation type to remove"),
-    }, async ({ id, relatedMemoId, type }) => {
-        // Get current relations, filter out the target, set remaining
-        const current = await client.get(`/api/v1/memos/${id}/relations`);
-        const remaining = (current.relations || []).filter((r) => !(r.relatedMemo === `memos/${relatedMemoId}` && r.type === type));
-        const result = await client.patch(`/api/v1/memos/${id}/relations`, { relations: remaining });
-        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        await client.patch(`/api/v1/memos/${numericId}/relations`, body);
+        const verb = action === "add" ? "added" : "removed";
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `${resolvedTargets.length} reference(s) ${verb}. Memo ${id} now has ${finalIds.length} outgoing reference(s).`,
+                },
+            ],
+        };
     });
 };
 //# sourceMappingURL=relations.js.map

package/dist/tools/relations.js.map

@@ -1 +1 @@
-{"version":3,"file":"relations.js","sourceRoot":"","sources":["../../src/tools/relations.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"relations.js","sourceRoot":"","sources":["../../src/tools/relations.ts"],"names":[],"mappings":"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"}

package/dist/tools/resources.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../src/tools/resources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C,eAAO,MAAM,qBAAqB,GAAI,QAAQ,SAAS,EAAE,QAAQ,WAAW,SAmD3E,CAAC"}
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../src/tools/resources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAkB3C,eAAO,MAAM,qBAAqB,GAAI,QAAQ,SAAS,EAAE,QAAQ,WAAW,SAiE3E,CAAC"}

package/dist/tools/resources.js

@@ -1,28 +1,89 @@
 import { z } from "zod";
+function summarizeResource(res) {
+    const name = res.name;
+    const id = name?.match(/^resources\/(\d+)$/)?.[1];
+    const summary = {
+        id: id ? Number(id) : undefined,
+        uid: res.uid,
+        filename: res.filename,
+        type: res.type,
+        size: res.size,
+    };
+    if (res.externalLink)
+        summary.externalLink = res.externalLink;
+    if (res.memo)
+        summary.memo = res.memo;
+    return summary;
+}
 export const registerResourceTools = (server, client) => {
-    server.tool("list_resources", "List all resources (attachments)", {}, async () => {
+    server.registerTool("list_resources", {
+        description: "List all resources (attachments) owned by the current user.",
+        annotations: { readOnlyHint: true, openWorldHint: false },
+    }, async () => {
         const result = await client.get("/api/v1/resources");
-        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        const summaries = (result.resources || []).map((r) => summarizeResource(r));
+        return { content: [{ type: "text", text: JSON.stringify(summaries, null, 2) }] };
     });
-    server.tool("get_resource", "Get a resource by ID", {
-        id: z.number().int().describe("Resource ID"),
-    }, async ({ id }) => {
-        const resource = await client.get(`/api/v1/resources/${id}`);
-        return { content: [{ type: "text", text: JSON.stringify(resource, null, 2) }] };
+    server.registerTool("upload_resource", {
+        description: "Upload a file as a resource. The file content must be base64 encoded. Optionally link it to a memo.",
+        inputSchema: {
+            filename: z.string().min(1).describe("File name with extension, e.g. \"photo.jpg\""),
+            contentBase64: z.string().min(1).describe("File content as a base64 encoded string"),
+            type: z.string().optional().describe("MIME type, e.g. \"image/jpeg\". Auto-detected from extension if omitted"),
+            memoId: z.number().int().optional().describe("Memo ID to link this resource to"),
+        },
+        annotations: { destructiveHint: false, openWorldHint: false },
+    }, async ({ filename, contentBase64, type, memoId }) => {
+        const mimeType = type ?? guessMimeType(filename);
+        const body = {
+            filename,
+            content: contentBase64,
+            type: mimeType,
+        };
+        if (memoId !== undefined) {
+            body.memo = `memos/${memoId}`;
+        }
+        const resource = await client.post("/api/v1/resources", body);
+        const id = resource.name?.match(/^resources\/(\d+)$/)?.[1];
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Resource uploaded: id=${id}, filename="${resource.filename}"`,
+                },
+            ],
+        };
     });
-    server.tool("delete_resource", "Delete a resource", {
-        id: z.number().int().describe("Resource ID"),
+    server.registerTool("delete_resource", {
+        description: "Delete a resource permanently.",
+        inputSchema: {
+            id: z.number().int().describe("Resource ID"),
+        },
+        annotations: { destructiveHint: true, idempotentHint: true, openWorldHint: false },
     }, async ({ id }) => {
         await client.delete(`/api/v1/resources/${id}`);
         return { content: [{ type: "text", text: `Resource ${id} deleted.` }] };
     });
-    server.tool("link_resource_to_memo", "Link resources to a memo", {
-        memoId: z.number().int().describe("Memo ID"),
-        resourceIds: z.array(z.number().int()).min(1).describe("Resource IDs to link"),
-    }, async ({ memoId, resourceIds }) => {
-        const resources = resourceIds.map((id) => ({ name: `resources/${id}` }));
-        const result = await client.patch(`/api/v1/memos/${memoId}/resources`, { resources });
-        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
-    });
 };
+const MIME_MAP = {
+    jpg: "image/jpeg",
+    jpeg: "image/jpeg",
+    png: "image/png",
+    gif: "image/gif",
+    webp: "image/webp",
+    svg: "image/svg+xml",
+    pdf: "application/pdf",
+    mp3: "audio/mpeg",
+    mp4: "video/mp4",
+    webm: "video/webm",
+    txt: "text/plain",
+    md: "text/markdown",
+    json: "application/json",
+    csv: "text/csv",
+    zip: "application/zip",
+};
+function guessMimeType(filename) {
+    const ext = filename.split(".").pop()?.toLowerCase() ?? "";
+    return MIME_MAP[ext] ?? "application/octet-stream";
+}
 //# sourceMappingURL=resources.js.map

package/dist/tools/resources.js.map

@@ -1 +1 @@
-{"version":3,"file":"resources.js","sourceRoot":"","sources":["../../src/tools/resources.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,MAAiB,EAAE,MAAmB,EAAE,EAAE;IAC9E,MAAM,CAAC,IAAI,CACT,gBAAgB,EAChB,kCAAkC,EAClC,EAAE,EACF,KAAK,IAAI,EAAE;QACT,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAA4B,mBAAmB,CAAC,CAAC;QAChF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACzF,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,cAAc,EACd,sBAAsB,EACtB;QACE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;KAC7C,EACD,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;QACf,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAAW,qBAAqB,EAAE,EAAE,CAAC,CAAC;QACvE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAC3F,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,iBAAiB,EACjB,mBAAmB,EACnB;QACE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;KAC7C,EACD,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;QACf,MAAM,MAAM,CAAC,MAAM,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAC;QAC/C,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;IACnF,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,uBAAuB,EACvB,0BAA0B,EAC1B;QACE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC;QAC5C,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC;KAC/E,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE;QAChC,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QACzE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAC/B,iBAAiB,MAAM,YAAY,EACnC,EAAE,SAAS,EAAE,CACd,CAAC;QACF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACzF,CAAC,CACF,CAAC;AACJ,CAAC,CAAC"}
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../../src/tools/resources.ts"],"names":[],"mappings":"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"}

package/dist/tools/review.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../src/tools/review.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C,eAAO,MAAM,mBAAmB,GAAI,QAAQ,SAAS,EAAE,QAAQ,WAAW,SAiHzE,CAAC"}
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../src/tools/review.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAS3C,eAAO,MAAM,mBAAmB,GAAI,QAAQ,SAAS,EAAE,QAAQ,WAAW,SAwIzE,CAAC"}

package/dist/tools/review.js

@@ -1,72 +1,101 @@
 import { z } from "zod";
+import { summarizeMemo } from "./utils.js";
 export const registerReviewTools = (server, client) => {
-    server.tool("list_review_memos", "Get memos due for spaced-repetition review", {
-        force: z.boolean().default(false).describe("Force refresh the daily review cache"),
-    }, async ({ force }) => {
+    server.registerTool("get_review_memos", {
+        description: "Get today's batch of memos for spaced-repetition review (回顾). Returns a daily batch selected by the review algorithm.",
+        inputSchema: {
+            refresh: z.boolean().optional().describe("Load a new batch even if today's review is already completed"),
+        },
+        annotations: { readOnlyHint: true, openWorldHint: false },
+    }, async ({ refresh }) => {
         const params = {};
-        if (force)
+        if (refresh)
             params.force = "true";
         const result = await client.get("/api/v1/review/memos", params);
-        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        const summaries = (result.memos || []).map((m) => summarizeMemo(m));
+        const output = {
+            memos: summaries,
+            totalEligible: result.totalCount,
+            completed: result.completed,
+        };
+        return { content: [{ type: "text", text: JSON.stringify(output, null, 2) }] };
     });
-    server.tool("get_random_memo", "Get a random memo for surprise review", {}, async () => {
-        const memo = await client.get("/api/v1/review/random");
-        return { content: [{ type: "text", text: JSON.stringify(memo, null, 2) }] };
+    server.registerTool("complete_review", {
+        description: "Mark the current review batch as completed. Call this after the user has finished reviewing all memos from get_review_memos.",
+        inputSchema: {
+            memoIds: z.array(z.number().int()).min(1).describe("IDs of the reviewed memos"),
+        },
+        annotations: { destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    }, async ({ memoIds }) => {
+        const result = await client.post("/api/v1/review/record", {
+            memoNames: memoIds.map((id) => `memos/${id}`),
+            source: "REVIEW_SOURCE_REVIEW",
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Review completed: ${result.recordedCount} memo(s) recorded.`,
+                },
+            ],
+        };
     });
-    server.tool("list_on_this_day_memos", "Get memos created on this day in previous years", {
-        month: z.number().int().min(1).max(12).optional().describe("Month (1-12), defaults to current"),
-        day: z.number().int().min(1).max(31).optional().describe("Day (1-31), defaults to current"),
-        offset: z.number().int().min(0).default(0).describe("Pagination offset"),
-        pageSize: z.number().int().min(1).max(100).default(20).describe("Page size"),
-    }, async ({ month, day, offset, pageSize }) => {
+    server.registerTool("get_on_this_day_memos", {
+        description: "Get memos created on this day in previous years, grouped by year. Great for revisiting past thoughts and memories.",
+        inputSchema: {
+            month: z.number().int().min(1).max(12).optional().describe("Month (1-12), defaults to current month"),
+            day: z.number().int().min(1).max(31).optional().describe("Day (1-31), defaults to current day"),
+        },
+        annotations: { readOnlyHint: true, openWorldHint: false },
+    }, async ({ month, day }) => {
         const params = {
-            offset: String(offset),
-            pageSize: String(pageSize),
+            pageSize: "100",
         };
         if (month !== undefined)
             params.month = String(month);
         if (day !== undefined)
             params.day = String(day);
         const result = await client.get("/api/v1/review/on-this-day", params);
-        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        const groups = (result.groups || []).map((g) => ({
+            year: g.year,
+            memos: (g.memos || []).map((m) => summarizeMemo(m)),
+        }));
+        if (groups.length === 0) {
+            return { content: [{ type: "text", text: "No memos found on this day in previous years." }] };
+        }
+        const output = { groups, totalCount: result.totalCount };
+        return { content: [{ type: "text", text: JSON.stringify(output, null, 2) }] };
     });
-    server.tool("get_time_travel_memos", "Get memos from a random or specified time period", {
-        pageSize: z.number().int().min(1).max(100).default(20).describe("Page size"),
-        periodStart: z.string().optional().describe("ISO 8601 start date, e.g. 2024-01-01T00:00:00Z"),
-        periodEnd: z.string().optional().describe("ISO 8601 end date"),
-        offset: z.number().int().min(0).default(0).describe("Pagination offset"),
-    }, async ({ pageSize, periodStart, periodEnd, offset }) => {
-        const params = {
-            pageSize: String(pageSize),
-            offset: String(offset),
+    server.registerTool("update_review_setting", {
+        description: "Update review preferences: how many memos per batch, and which tags to include or exclude.",
+        inputSchema: {
+            sessionSize: z.number().int().min(1).max(50).optional().describe("Number of memos per review batch (default 10)"),
+            includeTags: z.array(z.string()).optional().describe("Only review memos with these tags. Empty array or omit for all tags"),
+            excludeTags: z.array(z.string()).optional().describe("Skip memos with these tags"),
+        },
+        annotations: { destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    }, async ({ sessionSize, includeTags, excludeTags }) => {
+        const currentUser = await client.getCurrentUser();
+        const userId = currentUser.match(/^users\/(\d+)$/)?.[1];
+        if (!userId)
+            throw new Error(`Unexpected user format: ${currentUser}`);
+        const current = await client.get(`/api/v1/users/${userId}/setting`);
+        const reviewSetting = {
+            sessionSize: sessionSize ?? current.reviewSetting?.sessionSize ?? 10,
+            includeTags: includeTags ?? current.reviewSetting?.includeTags ?? [],
+            excludeTags: excludeTags ?? current.reviewSetting?.excludeTags ?? [],
         };
-        if (periodStart)
-            params.periodStart = periodStart;
-        if (periodEnd)
-            params.periodEnd = periodEnd;
-        const result = await client.get("/api/v1/review/time-travel", params);
-        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
-    });
-    server.tool("record_review", "Record that memos have been reviewed", {
-        memoIds: z.array(z.number().int()).min(1).describe("IDs of reviewed memos"),
-        source: z
-            .enum([
-            "REVIEW_SOURCE_REVIEW",
-            "REVIEW_SOURCE_ON_THIS_DAY",
-            "REVIEW_SOURCE_SURPRISE",
-            "REVIEW_SOURCE_TIME_TRAVEL",
-        ])
-            .describe("Review source"),
-    }, async ({ memoIds, source }) => {
-        const result = await client.post("/api/v1/review/record", {
-            memoNames: memoIds.map((id) => `memos/${id}`),
-            source,
+        await client.patch(`/api/v1/users/${userId}/setting`, { reviewSetting }, {
+            updateMask: "review_setting",
         });
-        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
-    });
-    server.tool("get_review_stats", "Get review statistics", {}, async () => {
-        const stats = await client.get("/api/v1/review/stats");
-        return { content: [{ type: "text", text: JSON.stringify(stats, null, 2) }] };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Review setting updated: ${JSON.stringify(reviewSetting)}`,
+                },
+            ],
+        };
     });
 };
 //# sourceMappingURL=review.js.map

package/dist/tools/review.js.map

@@ -1 +1 @@
-{"version":3,"file":"review.js","sourceRoot":"","sources":["../../src/tools/review.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"review.js","sourceRoot":"","sources":["../../src/tools/review.ts"],"names":[],"mappings":"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"}

package/dist/tools/tags.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tags.d.ts","sourceRoot":"","sources":["../../src/tools/tags.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAyD3C,eAAO,MAAM,gBAAgB,GAAI,QAAQ,SAAS,EAAE,QAAQ,WAAW,SA+HtE,CAAC"}
+{"version":3,"file":"tags.d.ts","sourceRoot":"","sources":["../../src/tools/tags.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAyD3C,eAAO,MAAM,gBAAgB,GAAI,QAAQ,SAAS,EAAE,QAAQ,WAAW,SA2HtE,CAAC"}

package/dist/tools/tags.js

@@ -46,27 +46,22 @@ async function fetchAllMemoMetadata(client) {
     return result.memos || [];
 }
 export const registerTagTools = (server, client) => {
-    server.tool("list_tags", [
-        "List tags with usage counts. Returns {name, count, hasChildren, pinned, emoji} for each tag.",
-        "- No args: top-level tags only.",
-        "- recursive=true: every tag (flat list, good for recommending tags).",
-        "- parent=\"x\": direct children of tag \"x\".",
-        "- parent=\"x\" + recursive=true: all descendants under \"x\".",
-        "- pinnedOnly=true: only user-pinned tags.",
-        "Tags use \"/\" for hierarchy (e.g. \"project/work/backend\").",
-    ].join(" "), {
-        parent: z
-            .string()
-            .optional()
-            .describe("Parent tag to scope the listing (e.g. \"project\" or \"project/work\"). Omit to start from root"),
-        recursive: z
-            .boolean()
-            .optional()
-            .describe("When true, return all tags/descendants instead of only direct children"),
-        pinnedOnly: z
-            .boolean()
-            .optional()
-            .describe("When true, only return user-pinned tags"),
+    server.registerTool("list_tags", {
+        description: [
+            "List tags with usage counts. Returns {name, count, hasChildren, pinned, emoji} for each tag.",
+            "- No args: top-level tags only.",
+            "- recursive=true: every tag (flat list, good for recommending tags).",
+            "- parent=\"x\": direct children of tag \"x\".",
+            "- parent=\"x\" + recursive=true: all descendants under \"x\".",
+            "- pinnedOnly=true: only user-pinned tags.",
+            "Tags use \"/\" for hierarchy (e.g. \"project/work/backend\").",
+        ].join(" "),
+        inputSchema: {
+            parent: z.string().optional().describe("Parent tag to scope the listing (e.g. \"project\" or \"project/work\"). Omit to start from root"),
+            recursive: z.boolean().optional().describe("When true, return all tags/descendants instead of only direct children"),
+            pinnedOnly: z.boolean().optional().describe("When true, only return user-pinned tags"),
+        },
+        annotations: { readOnlyHint: true, openWorldHint: false },
     }, async ({ parent, recursive, pinnedOnly }) => {
         const [memos, pinnedResult] = await Promise.all([
             fetchAllMemoMetadata(client),
@@ -103,10 +98,14 @@ export const registerTagTools = (server, client) => {
         }
         return { content: [{ type: "text", text: JSON.stringify(results, null, 2) }] };
     });
-    server.tool("update_tag", "Update a tag's pinned status or emoji. Pinned tags are highlighted in the UI for quick access.", {
-        tagName: z.string().min(1).describe("Tag name (without #)"),
-        emoji: z.string().optional().describe("Emoji to associate with the tag (e.g. \"📅\"). Pass empty string to remove"),
-        pinned: z.boolean().optional().describe("Pin or unpin the tag"),
+    server.registerTool("update_tag", {
+        description: "Update a tag's pinned status or emoji. Pinned tags are highlighted in the UI for quick access.",
+        inputSchema: {
+            tagName: z.string().min(1).describe("Tag name (without #)"),
+            emoji: z.string().optional().describe("Emoji to associate with the tag (e.g. \"📅\"). Pass empty string to remove"),
+            pinned: z.boolean().optional().describe("Pin or unpin the tag"),
+        },
+        annotations: { destructiveHint: false, idempotentHint: true, openWorldHint: false },
     }, async ({ tagName, emoji, pinned }) => {
         const body = {};
         const updateMaskPaths = [];
@@ -130,11 +129,14 @@ export const registerTagTools = (server, client) => {
             content: [{ type: "text", text: `Tag "#${tagName}" updated: ${parts.join(", ")}.` }],
         };
     });
-    server.tool("rename_tag", "Rename a tag across ALL memos. This is a destructive operation that modifies memo content globally — use with caution.", {
-        oldTag: z.string().min(1).describe("Current tag name (without #)"),
-        newTag: z.string().min(1).describe("New tag name (without #)"),
-    }, { destructiveHint: true }, async ({ oldTag, newTag }) => {
-        // parent = "memos/-" means rename across all memos
+    server.registerTool("rename_tag", {
+        description: "Rename a tag across ALL memos. This is a destructive operation that modifies memo content globally — use with caution.",
+        inputSchema: {
+            oldTag: z.string().min(1).describe("Current tag name (without #)"),
+            newTag: z.string().min(1).describe("New tag name (without #)"),
+        },
+        annotations: { destructiveHint: true, idempotentHint: true, openWorldHint: false },
+    }, async ({ oldTag, newTag }) => {
         await client.patch(`/api/v1/memos/-/tags:rename`, {
             parent: "memos/-",
             oldTag,