anki-mcp-http 0.19.2 → 0.20.0

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

@@ -0,0 +1,95 @@
+"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 ModelTemplatesTool_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModelTemplatesTool = 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 ModelTemplatesTool = ModelTemplatesTool_1 = class ModelTemplatesTool {
+    ankiClient;
+    logger = new common_1.Logger(ModelTemplatesTool_1.name);
+    constructor(ankiClient) {
+        this.ankiClient = ankiClient;
+    }
+    async modelTemplates({ modelName }) {
+        try {
+            this.logger.log(`Retrieving templates for model: ${modelName}`);
+            const templates = await this.ankiClient.invoke("modelTemplates", {
+                modelName: modelName,
+            });
+            if (!templates || Object.keys(templates).length === 0) {
+                this.logger.warn(`No templates found for model: ${modelName}`);
+                return (0, anki_utils_1.createErrorResponse)(new Error(`Model "${modelName}" not found or has no card templates`), {
+                    modelName: modelName,
+                    hint: "Use modelNames tool to see available models",
+                });
+            }
+            const cardCount = Object.keys(templates).length;
+            this.logger.log(`Retrieved ${cardCount} templates for model ${modelName}`);
+            return {
+                success: true,
+                modelName: modelName,
+                templates: templates,
+                message: `Retrieved ${cardCount} card template(s) for model "${modelName}"`,
+                hint: "Use updateModelTemplates to modify the Front/Back HTML of these card templates",
+            };
+        }
+        catch (error) {
+            this.logger.error(`Failed to retrieve templates for model ${modelName}`, error);
+            return (0, anki_utils_1.createErrorResponse)(error, {
+                modelName: modelName,
+                hint: "Make sure the model name is correct and Anki is running",
+            });
+        }
+    }
+};
+exports.ModelTemplatesTool = ModelTemplatesTool;
+__decorate([
+    (0, mcp_nest_1.Tool)({
+        name: "modelTemplates",
+        description: "Get the card templates (Front and Back HTML) for a specific note type (model). " +
+            "Returns each card template's Front and Back HTML content. " +
+            "Use this before updateModelTemplates to see current templates and plan changes.",
+        parameters: zod_1.z.object({
+            modelName: zod_1.z
+                .string()
+                .min(1)
+                .describe("The name of the model/note type to get templates for"),
+        }),
+        outputSchema: zod_1.z.object({
+            success: zod_1.z.boolean(),
+            modelName: zod_1.z.string(),
+            templates: zod_1.z.record(zod_1.z.string(), zod_1.z.object({
+                Front: zod_1.z.string(),
+                Back: zod_1.z.string(),
+            })),
+            message: zod_1.z.string(),
+            hint: zod_1.z.string(),
+        }),
+        annotations: {
+            title: "Get Note Type Templates",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+        },
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], ModelTemplatesTool.prototype, "modelTemplates", null);
+exports.ModelTemplatesTool = ModelTemplatesTool = ModelTemplatesTool_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [anki_connect_client_1.AnkiConnectClient])
+], ModelTemplatesTool);
+//# sourceMappingURL=model-templates.tool.js.map

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

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

package/dist/mcp/primitives/essential/tools/remove-model-field.tool.d.ts

@@ -0,0 +1,112 @@
+import { AnkiConnectClient } from "../../../clients/anki-connect.client";
+export declare class RemoveModelFieldTool {
+    private readonly ankiClient;
+    private readonly logger;
+    constructor(ankiClient: AnkiConnectClient);
+    removeModelField({ modelName, fieldName, confirmDeletion, }: {
+        modelName: string;
+        fieldName: string;
+        confirmDeletion: boolean;
+    }): Promise<{
+        [x: string]: unknown;
+        content: ({
+            type: "text";
+            text: string;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            type: "image";
+            data: string;
+            mimeType: string;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            type: "audio";
+            data: string;
+            mimeType: string;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            uri: string;
+            name: string;
+            type: "resource_link";
+            description?: string | undefined;
+            mimeType?: string | undefined;
+            size?: number | undefined;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+            icons?: {
+                src: string;
+                mimeType?: string | undefined;
+                sizes?: string[] | undefined;
+                theme?: "light" | "dark" | undefined;
+            }[] | undefined;
+            title?: string | undefined;
+        } | {
+            type: "resource";
+            resource: {
+                uri: string;
+                text: string;
+                mimeType?: string | undefined;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+            } | {
+                uri: string;
+                blob: string;
+                mimeType?: string | undefined;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+            };
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        })[];
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+        structuredContent?: {
+            [x: string]: unknown;
+        } | undefined;
+        isError?: boolean | undefined;
+    } | {
+        success: boolean;
+        modelName: string;
+        fieldName: string;
+        message: string;
+    }>;
+}

package/dist/mcp/primitives/essential/tools/remove-model-field.tool.js

@@ -0,0 +1,107 @@
+"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 RemoveModelFieldTool_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RemoveModelFieldTool = 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 RemoveModelFieldTool = RemoveModelFieldTool_1 = class RemoveModelFieldTool {
+    ankiClient;
+    logger = new common_1.Logger(RemoveModelFieldTool_1.name);
+    constructor(ankiClient) {
+        this.ankiClient = ankiClient;
+    }
+    async removeModelField({ modelName, fieldName, confirmDeletion, }) {
+        try {
+            if (!confirmDeletion) {
+                return (0, anki_utils_1.createErrorResponse)(new Error("Deletion not confirmed"), {
+                    modelName,
+                    fieldName,
+                    hint: "Set confirmDeletion: true to confirm you want to permanently delete this field and all its data.",
+                });
+            }
+            this.logger.log(`Removing field "${fieldName}" from model "${modelName}"`);
+            await this.ankiClient.invoke("modelFieldRemove", {
+                modelName,
+                fieldName,
+            });
+            this.logger.log(`Successfully removed field "${fieldName}" from model "${modelName}"`);
+            return {
+                success: true,
+                modelName,
+                fieldName,
+                message: `Successfully removed field "${fieldName}" from model "${modelName}". All data in this field has been deleted.`,
+            };
+        }
+        catch (error) {
+            this.logger.error(`Failed to remove field "${fieldName}" from model "${modelName}"`, error);
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            if (errorMessage.includes("not found") ||
+                errorMessage.includes("does not exist")) {
+                return (0, anki_utils_1.createErrorResponse)(error, {
+                    modelName,
+                    fieldName,
+                    hint: "Model or field not found. Use modelNames and modelFieldNames tools to verify names.",
+                });
+            }
+            return (0, anki_utils_1.createErrorResponse)(error, {
+                modelName,
+                fieldName,
+                hint: "Make sure Anki is running and the model and field names are correct.",
+            });
+        }
+    }
+};
+exports.RemoveModelFieldTool = RemoveModelFieldTool;
+__decorate([
+    (0, mcp_nest_1.Tool)({
+        name: "removeModelField",
+        description: "Remove a field from an existing Anki note type (model). " +
+            "WARNING: All data stored in this field across every note of this type will be permanently deleted. " +
+            "Use modelFieldNames to confirm the field name before removing.",
+        parameters: zod_1.z.object({
+            modelName: zod_1.z
+                .string()
+                .min(1)
+                .describe('Name of the note type to modify (e.g., "Basic", "Latin Vocabulary")'),
+            fieldName: zod_1.z
+                .string()
+                .min(1)
+                .describe('Name of the field to remove (e.g., "Grammar", "IPA")'),
+            confirmDeletion: zod_1.z
+                .boolean()
+                .describe("Must be set to true to confirm you understand all field data will be permanently deleted."),
+        }),
+        outputSchema: zod_1.z.object({
+            success: zod_1.z.boolean(),
+            modelName: zod_1.z.string(),
+            fieldName: zod_1.z.string(),
+            message: zod_1.z.string(),
+        }),
+        annotations: {
+            title: "Remove Field from Note Type",
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: false,
+        },
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], RemoveModelFieldTool.prototype, "removeModelField", null);
+exports.RemoveModelFieldTool = RemoveModelFieldTool = RemoveModelFieldTool_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [anki_connect_client_1.AnkiConnectClient])
+], RemoveModelFieldTool);
+//# sourceMappingURL=remove-model-field.tool.js.map

package/dist/mcp/primitives/essential/tools/remove-model-field.tool.js.map

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

package/dist/mcp/primitives/essential/tools/rename-model-field.tool.d.ts

@@ -0,0 +1,114 @@
+import { AnkiConnectClient } from "../../../clients/anki-connect.client";
+export declare class RenameModelFieldTool {
+    private readonly ankiClient;
+    private readonly logger;
+    constructor(ankiClient: AnkiConnectClient);
+    renameModelField({ modelName, oldFieldName, newFieldName, }: {
+        modelName: string;
+        oldFieldName: string;
+        newFieldName: string;
+    }): Promise<{
+        [x: string]: unknown;
+        content: ({
+            type: "text";
+            text: string;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            type: "image";
+            data: string;
+            mimeType: string;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            type: "audio";
+            data: string;
+            mimeType: string;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            uri: string;
+            name: string;
+            type: "resource_link";
+            description?: string | undefined;
+            mimeType?: string | undefined;
+            size?: number | undefined;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+            icons?: {
+                src: string;
+                mimeType?: string | undefined;
+                sizes?: string[] | undefined;
+                theme?: "light" | "dark" | undefined;
+            }[] | undefined;
+            title?: string | undefined;
+        } | {
+            type: "resource";
+            resource: {
+                uri: string;
+                text: string;
+                mimeType?: string | undefined;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+            } | {
+                uri: string;
+                blob: string;
+                mimeType?: string | undefined;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+            };
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        })[];
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+        structuredContent?: {
+            [x: string]: unknown;
+        } | undefined;
+        isError?: boolean | undefined;
+    } | {
+        success: boolean;
+        modelName: string;
+        oldFieldName: string;
+        newFieldName: string;
+        message: string;
+        warning: string;
+    }>;
+}

package/dist/mcp/primitives/essential/tools/rename-model-field.tool.js

@@ -0,0 +1,156 @@
+"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 RenameModelFieldTool_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RenameModelFieldTool = 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 RenameModelFieldTool = RenameModelFieldTool_1 = class RenameModelFieldTool {
+    ankiClient;
+    logger = new common_1.Logger(RenameModelFieldTool_1.name);
+    constructor(ankiClient) {
+        this.ankiClient = ankiClient;
+    }
+    async renameModelField({ modelName, oldFieldName, newFieldName, }) {
+        try {
+            this.logger.log(`Renaming field "${oldFieldName}" → "${newFieldName}" in model "${modelName}"`);
+            if (oldFieldName === newFieldName) {
+                return (0, anki_utils_1.createErrorResponse)(new Error(`Old and new field names are identical ("${oldFieldName}") — nothing to rename`), {
+                    modelName,
+                    oldFieldName,
+                    newFieldName,
+                    hint: "Provide a new field name that differs from the current one.",
+                });
+            }
+            const fields = await this.ankiClient.invoke("modelFieldNames", {
+                modelName,
+            });
+            if (!fields || fields.length === 0) {
+                return (0, anki_utils_1.createErrorResponse)(new Error(`Model "${modelName}" has no fields or does not exist`), {
+                    modelName,
+                    oldFieldName,
+                    newFieldName,
+                    hint: "Model not found. Use modelNames tool to see available models.",
+                });
+            }
+            if (!fields.includes(oldFieldName)) {
+                return (0, anki_utils_1.createErrorResponse)(new Error(`Field "${oldFieldName}" does not exist in model "${modelName}"`), {
+                    modelName,
+                    oldFieldName,
+                    newFieldName,
+                    hint: "Field names are case-sensitive. Use modelFieldNames to see the current field names.",
+                });
+            }
+            if (fields.includes(newFieldName)) {
+                return (0, anki_utils_1.createErrorResponse)(new Error(`A field named "${newFieldName}" already exists in model "${modelName}". ` +
+                    'AnkiConnect would silently mangle the name with a "+" suffix instead of erroring.'), {
+                    modelName,
+                    oldFieldName,
+                    newFieldName,
+                    hint: `A field named "${newFieldName}" already exists in this model.`,
+                });
+            }
+            const caseVariant = fields.find((f) => f !== oldFieldName && f.toLowerCase() === newFieldName.toLowerCase());
+            if (caseVariant) {
+                return (0, anki_utils_1.createErrorResponse)(new Error(`Field "${newFieldName}" collides with existing field "${caseVariant}" ` +
+                    `in model "${modelName}" (names differ only in case)`), {
+                    modelName,
+                    oldFieldName,
+                    newFieldName,
+                    hint: `Field names are case-sensitive, but "${newFieldName}" differs from existing field "${caseVariant}" only in case. Pick a distinct name.`,
+                });
+            }
+            await this.ankiClient.invoke("modelFieldRename", {
+                modelName,
+                oldFieldName,
+                newFieldName,
+            });
+            this.logger.log(`Successfully renamed field "${oldFieldName}" to "${newFieldName}" in model "${modelName}"`);
+            return {
+                success: true,
+                modelName,
+                oldFieldName,
+                newFieldName,
+                message: `Successfully renamed field "${oldFieldName}" to "${newFieldName}" in model "${modelName}"`,
+                warning: `Card templates referencing "{{${oldFieldName}}}" must be updated manually ` +
+                    `to "{{${newFieldName}}}" using the updateModelTemplates tool.`,
+            };
+        }
+        catch (error) {
+            this.logger.error(`Failed to rename field "${oldFieldName}" in model "${modelName}"`, error);
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            if (errorMessage.includes("not found") ||
+                errorMessage.includes("does not exist")) {
+                return (0, anki_utils_1.createErrorResponse)(error, {
+                    modelName,
+                    oldFieldName,
+                    newFieldName,
+                    hint: "Model or field not found. Use modelNames and modelFieldNames tools to verify names.",
+                });
+            }
+            return (0, anki_utils_1.createErrorResponse)(error, {
+                modelName,
+                oldFieldName,
+                newFieldName,
+                hint: "Make sure Anki is running and the model and field names are correct.",
+            });
+        }
+    }
+};
+exports.RenameModelFieldTool = RenameModelFieldTool;
+__decorate([
+    (0, mcp_nest_1.Tool)({
+        name: "renameModelField",
+        description: "Rename a field in an existing Anki note type (model). " +
+            "Card templates that reference the old field name (e.g., {{OldName}}) will need to be " +
+            "updated separately using updateModelTemplates — they are not updated automatically. " +
+            "Use modelFieldNames to confirm the current field name before renaming.",
+        parameters: zod_1.z.object({
+            modelName: zod_1.z
+                .string()
+                .min(1)
+                .describe('Name of the note type to modify (e.g., "Basic", "Latin Vocabulary")'),
+            oldFieldName: zod_1.z
+                .string()
+                .min(1)
+                .describe('Current name of the field to rename (e.g., "Notes")'),
+            newFieldName: zod_1.z
+                .string()
+                .min(1)
+                .describe('New name for the field (e.g., "Grammar Notes")'),
+        }),
+        outputSchema: zod_1.z.object({
+            success: zod_1.z.boolean(),
+            modelName: zod_1.z.string(),
+            oldFieldName: zod_1.z.string(),
+            newFieldName: zod_1.z.string(),
+            message: zod_1.z.string(),
+            warning: zod_1.z.string().optional(),
+        }),
+        annotations: {
+            title: "Rename Field in Note Type",
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+        },
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], RenameModelFieldTool.prototype, "renameModelField", null);
+exports.RenameModelFieldTool = RenameModelFieldTool = RenameModelFieldTool_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [anki_connect_client_1.AnkiConnectClient])
+], RenameModelFieldTool);
+//# sourceMappingURL=rename-model-field.tool.js.map

package/dist/mcp/primitives/essential/tools/rename-model-field.tool.js.map

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