anki-mcp-http 0.19.2 → 0.20.1

package/dist/mcp/primitives/essential/tools/update-model-templates.tool.js

@@ -0,0 +1,140 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var UpdateModelTemplatesTool_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateModelTemplatesTool = void 0;
+const common_1 = require("@nestjs/common");
+const mcp_nest_1 = require("@rekog/mcp-nest");
+const zod_1 = require("zod");
+const anki_connect_client_1 = require("../../../clients/anki-connect.client");
+const anki_utils_1 = require("../../../utils/anki.utils");
+let UpdateModelTemplatesTool = UpdateModelTemplatesTool_1 = class UpdateModelTemplatesTool {
+    ankiClient;
+    logger = new common_1.Logger(UpdateModelTemplatesTool_1.name);
+    constructor(ankiClient) {
+        this.ankiClient = ankiClient;
+    }
+    async updateModelTemplates({ modelName, templates, }) {
+        try {
+            this.logger.log(`Updating templates for model: ${modelName}`);
+            const existingTemplates = await this.ankiClient.invoke("modelTemplates", {
+                modelName,
+            });
+            if (!existingTemplates || Object.keys(existingTemplates).length === 0) {
+                return (0, anki_utils_1.createErrorResponse)(new Error(`Model "${modelName}" has no templates or does not exist`), {
+                    modelName,
+                    hint: "Model not found. Use modelNames tool to see available models.",
+                });
+            }
+            const existingNames = new Set(Object.keys(existingTemplates));
+            const unknownNames = Object.keys(templates).filter((name) => !existingNames.has(name));
+            if (unknownNames.length > 0) {
+                const offending = unknownNames.map((name) => `"${name}"`).join(", ");
+                const validNames = Object.keys(existingTemplates)
+                    .map((name) => `"${name}"`)
+                    .join(", ");
+                return (0, anki_utils_1.createErrorResponse)(new Error(`Card template(s) not found in model "${modelName}": ${offending}. ` +
+                    `Valid templates: ${validNames}. ` +
+                    "Use modelTemplates to see current names."), {
+                    modelName,
+                    hint: `Card template names are case-sensitive and must match exactly. Valid templates: ${validNames}.`,
+                });
+            }
+            const templateCount = Object.keys(templates).length;
+            await this.ankiClient.invoke("updateModelTemplates", {
+                model: {
+                    name: modelName,
+                    templates,
+                },
+            });
+            this.logger.log(`Successfully updated ${templateCount} templates for model: ${modelName}`);
+            return {
+                success: true,
+                modelName,
+                templateCount,
+                message: `Successfully updated ${templateCount} card template(s) for model "${modelName}"`,
+                hint: "Template changes apply to all cards using this model. Use guiBrowse to preview changes.",
+            };
+        }
+        catch (error) {
+            this.logger.error(`Failed to update templates for model ${modelName}`, error);
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            if (errorMessage.includes("not found") ||
+                errorMessage.includes("does not exist") ||
+                errorMessage.includes("model not found")) {
+                return (0, anki_utils_1.createErrorResponse)(error, {
+                    modelName,
+                    hint: "Model not found. Use modelNames tool to see available models.",
+                });
+            }
+            return (0, anki_utils_1.createErrorResponse)(error, {
+                modelName,
+                hint: "Make sure Anki is running and the model name is correct.",
+            });
+        }
+    }
+};
+exports.UpdateModelTemplatesTool = UpdateModelTemplatesTool;
+__decorate([
+    (0, mcp_nest_1.Tool)({
+        name: "updateModelTemplates",
+        description: "Update the card templates (Front and Back HTML) for an existing note type (model). " +
+            "Each card template defines how the card's front and back sides are rendered. " +
+            "Use modelTemplates first to see current templates, then modify and pass back the templates object. " +
+            "Changes apply to all cards using this model. " +
+            "WARNING: Invalid HTML or missing required fields may break card rendering. " +
+            "Card template names are validated against the model's existing templates (case-sensitive) — unknown or mis-cased names are rejected before any update. " +
+            "An empty string cannot be used to blank a side.",
+        parameters: zod_1.z.object({
+            modelName: zod_1.z
+                .string()
+                .min(1)
+                .describe('Name of the model to update (e.g., "Basic", "Cloze")'),
+            templates: zod_1.z
+                .record(zod_1.z.string(), zod_1.z.object({
+                Front: zod_1.z
+                    .string()
+                    .min(1)
+                    .describe("HTML template for the front/question side"),
+                Back: zod_1.z
+                    .string()
+                    .min(1)
+                    .describe("HTML template for the back/answer side"),
+            }))
+                .refine((t) => Object.keys(t).length > 0, {
+                message: "At least one card template is required",
+            })
+                .describe('Card templates keyed by card name (e.g., { "Card 1": { Front: "...", Back: "..." } }). ' +
+                "Use modelTemplates first to get the current structure, then modify the Front/Back HTML as needed."),
+        }),
+        outputSchema: zod_1.z.object({
+            success: zod_1.z.boolean(),
+            modelName: zod_1.z.string(),
+            templateCount: zod_1.z.number(),
+            message: zod_1.z.string(),
+            hint: zod_1.z.string(),
+        }),
+        annotations: {
+            title: "Update Note Type Templates",
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+        },
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], UpdateModelTemplatesTool.prototype, "updateModelTemplates", null);
+exports.UpdateModelTemplatesTool = UpdateModelTemplatesTool = UpdateModelTemplatesTool_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [anki_connect_client_1.AnkiConnectClient])
+], UpdateModelTemplatesTool);
+//# sourceMappingURL=update-model-templates.tool.js.map

package/dist/mcp/primitives/essential/tools/update-model-templates.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-model-templates.tool.js","sourceRoot":"","sources":["../../../../../src/mcp/primitives/essential/tools/update-model-templates.tool.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "anki-mcp-http",
   "mcpName": "ai.ankimcp/anki-mcp-server",
-  "version": "0.19.2",
+  "version": "0.20.1",
   "description": "Model Context Protocol server for Anki - enables AI assistants to interact with your Anki flashcards",
   "author": "Anatoly Tarnavsky",
   "private": false,
@@ -57,13 +57,14 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.29.0",
-    "@nestjs/common": "^11.1.24",
+    "@nestjs/common": "^11.1.26",
     "@nestjs/config": "^4.0.4",
-    "@nestjs/core": "11.1.24",
+    "@nestjs/core": "11.1.26",
     "@nestjs/jwt": "^11.0.2",
     "@nestjs/passport": "^11.0.5",
-    "@nestjs/platform-express": "^11.1.24",
+    "@nestjs/platform-express": "^11.1.26",
     "@rekog/mcp-nest": "^1.9.10",
+    "async-mutex": "^0.5.0",
     "commander": "^15.0.0",
     "ipaddr.js": "^2.4.0",
     "jsonwebtoken": "^9.0.3",
@@ -87,15 +88,15 @@
     "@anthropic-ai/mcpb": "^2.1.2",
     "@eslint/eslintrc": "^3.3.5",
     "@eslint/js": "^10.0.1",
-    "@modelcontextprotocol/inspector": "^0.21.2",
-    "@nestjs/cli": "^11.0.21",
+    "@modelcontextprotocol/inspector": "^0.22.0",
+    "@nestjs/cli": "^11.0.23",
     "@nestjs/schematics": "^11.1.0",
-    "@nestjs/testing": "^11.1.24",
+    "@nestjs/testing": "^11.1.26",
     "@types/express": "^5.0.6",
     "@types/jest": "^30.0.0",
     "@types/jsonwebtoken": "^9.0.10",
     "@types/mdast": "^4.0.4",
-    "@types/node": "^25.9.1",
+    "@types/node": "^25.9.3",
     "@types/supertest": "^7.2.0",
     "@types/update-notifier": "^6.0.8",
     "@types/ws": "^8.18.1",
@@ -105,8 +106,8 @@
     "globals": "^17.6.0",
     "husky": "^9.1.7",
     "jest": "^30.4.2",
-    "prettier": "^3.8.3",
-    "sharp": "^0.34.5",
+    "prettier": "^3.8.4",
+    "sharp": "^0.35.0",
     "source-map-support": "^0.5.21",
     "supertest": "^7.2.2",
     "ts-jest": "^29.4.11",
@@ -114,7 +115,7 @@
     "ts-node": "^10.9.2",
     "tsconfig-paths": "^4.2.0",
     "typescript": "^6.0.3",
-    "typescript-eslint": "^8.60.1"
+    "typescript-eslint": "^8.61.0"
   },
   "jest": {
     "moduleFileExtensions": [