anki-mcp-http 0.3.0 → 0.5.0

package/dist/mcp/primitives/gui/tools/gui-select-card.tool.js

@@ -0,0 +1,87 @@
+"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 GuiSelectCardTool_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GuiSelectCardTool = 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 GuiSelectCardTool = GuiSelectCardTool_1 = class GuiSelectCardTool {
+    ankiClient;
+    logger = new common_1.Logger(GuiSelectCardTool_1.name);
+    constructor(ankiClient) {
+        this.ankiClient = ankiClient;
+    }
+    async guiSelectCard({ card }, context) {
+        try {
+            this.logger.log(`Selecting card ${card} in Card Browser`);
+            await context.reportProgress({ progress: 50, total: 100 });
+            const success = await this.ankiClient.invoke('guiSelectCard', { card });
+            await context.reportProgress({ progress: 100, total: 100 });
+            if (!success) {
+                this.logger.warn('Card Browser is not open');
+                return (0, anki_utils_1.createErrorResponse)(new Error('Card Browser is not open'), {
+                    cardId: card,
+                    hint: 'Use guiBrowse to open the Card Browser first, then try selecting the card again.',
+                });
+            }
+            this.logger.log(`Successfully selected card ${card} in Card Browser`);
+            return (0, anki_utils_1.createSuccessResponse)({
+                success: true,
+                cardId: card,
+                browserOpen: true,
+                message: `Successfully selected card ${card} in Card Browser`,
+                hint: 'The card is now selected. Use guiEditNote to edit the associated note, or guiSelectedNotes to get note IDs.',
+            });
+        }
+        catch (error) {
+            this.logger.error('Failed to select card in browser', error);
+            if (error instanceof Error) {
+                if (error.message.includes('not found') || error.message.includes('invalid')) {
+                    return (0, anki_utils_1.createErrorResponse)(error, {
+                        cardId: card,
+                        hint: 'Card ID not found. Make sure the card exists and is visible in the current browser search.',
+                    });
+                }
+            }
+            return (0, anki_utils_1.createErrorResponse)(error, {
+                cardId: card,
+                hint: 'Make sure Anki is running, the Card Browser is open, and the card ID is valid',
+            });
+        }
+    }
+};
+exports.GuiSelectCardTool = GuiSelectCardTool;
+__decorate([
+    (0, mcp_nest_1.Tool)({
+        name: 'guiSelectCard',
+        description: 'Select a specific card in an open Card Browser window. Returns true if browser is open and card was selected, false if browser is not open. ' +
+            'IMPORTANT: Only use when user explicitly requests selecting a card in the browser. ' +
+            'This tool is for note editing/creation workflows, NOT for review sessions. ' +
+            'The Card Browser must already be open (use guiBrowse first).',
+        parameters: zod_1.z.object({
+            card: zod_1.z
+                .number()
+                .positive()
+                .describe('Card ID to select in the browser (get from guiBrowse results)'),
+        }),
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], GuiSelectCardTool.prototype, "guiSelectCard", null);
+exports.GuiSelectCardTool = GuiSelectCardTool = GuiSelectCardTool_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [anki_connect_client_1.AnkiConnectClient])
+], GuiSelectCardTool);
+//# sourceMappingURL=gui-select-card.tool.js.map

package/dist/mcp/primitives/gui/tools/gui-select-card.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gui-select-card.tool.js","sourceRoot":"","sources":["../../../../../src/mcp/primitives/gui/tools/gui-select-card.tool.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAAA,2CAAoD;AACpD,8CAAuC;AAEvC,6BAAwB;AACxB,8EAAsE;AACtE,0DAAoF;AAM7E,IAAM,iBAAiB,yBAAvB,MAAM,iBAAiB;IAGC;IAFZ,MAAM,GAAG,IAAI,eAAM,CAAC,mBAAiB,CAAC,IAAI,CAAC,CAAC;IAE7D,YAA6B,UAA6B;QAA7B,eAAU,GAAV,UAAU,CAAmB;IAAG,CAAC;IAgBxD,AAAN,KAAK,CAAC,aAAa,CAAC,EAAE,IAAI,EAAoB,EAAE,OAAgB;QAC9D,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,kBAAkB,IAAI,kBAAkB,CAAC,CAAC;YAC1D,MAAM,OAAO,CAAC,cAAc,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;YAG3D,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAU,eAAe,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;YAEjF,MAAM,OAAO,CAAC,cAAc,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;YAE5D,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;gBAC7C,OAAO,IAAA,gCAAmB,EACxB,IAAI,KAAK,CAAC,0BAA0B,CAAC,EACrC;oBACE,MAAM,EAAE,IAAI;oBACZ,IAAI,EAAE,kFAAkF;iBACzF,CACF,CAAC;YACJ,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,8BAA8B,IAAI,kBAAkB,CAAC,CAAC;YAEtE,OAAO,IAAA,kCAAqB,EAAC;gBAC3B,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,IAAI;gBACZ,WAAW,EAAE,IAAI;gBACjB,OAAO,EAAE,8BAA8B,IAAI,kBAAkB;gBAC7D,IAAI,EAAE,6GAA6G;aACpH,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,kCAAkC,EAAE,KAAK,CAAC,CAAC;YAE7D,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;gBAC3B,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;oBAC7E,OAAO,IAAA,gCAAmB,EAAC,KAAK,EAAE;wBAChC,MAAM,EAAE,IAAI;wBACZ,IAAI,EAAE,4FAA4F;qBACnG,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAED,OAAO,IAAA,gCAAmB,EAAC,KAAK,EAAE;gBAChC,MAAM,EAAE,IAAI;gBACZ,IAAI,EAAE,+EAA+E;aACtF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF,CAAA;AAnEY,8CAAiB;AAmBtB;IAdL,IAAA,eAAI,EAAC;QACJ,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,8IAA8I;YAC9I,qFAAqF;YACrF,6EAA6E;YAC7E,8DAA8D;QAChE,UAAU,EAAE,OAAC,CAAC,MAAM,CAAC;YACnB,IAAI,EAAE,OAAC;iBACJ,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,+DAA+D,CAAC;SAC7E,CAAC;KACH,CAAC;;;;sDAgDD;4BAlEU,iBAAiB;IAD7B,IAAA,mBAAU,GAAE;qCAI8B,uCAAiB;GAH/C,iBAAiB,CAmE7B"}

package/dist/mcp/primitives/gui/tools/gui-selected-notes.tool.d.ts

@@ -0,0 +1,81 @@
+import type { Context } from '@rekog/mcp-nest';
+import { AnkiConnectClient } from '@/mcp/clients/anki-connect.client';
+export declare class GuiSelectedNotesTool {
+    private readonly ankiClient;
+    private readonly logger;
+    constructor(ankiClient: AnkiConnectClient);
+    guiSelectedNotes(_args: {}, context: Context): Promise<{
+        [x: string]: unknown;
+        content: ({
+            [x: string]: unknown;
+            type: "text";
+            text: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "image";
+            data: string;
+            mimeType: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "audio";
+            data: string;
+            mimeType: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "resource_link";
+            name: string;
+            uri: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+            mimeType?: string | undefined;
+            title?: string | undefined;
+            description?: string | undefined;
+            icons?: {
+                [x: string]: unknown;
+                src: string;
+                mimeType?: string | undefined;
+                sizes?: string[] | undefined;
+            }[] | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "resource";
+            resource: {
+                [x: string]: unknown;
+                text: string;
+                uri: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+                mimeType?: string | undefined;
+            } | {
+                [x: string]: unknown;
+                uri: string;
+                blob: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+                mimeType?: string | undefined;
+            };
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        })[];
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+        structuredContent?: {
+            [x: string]: unknown;
+        } | undefined;
+        isError?: boolean | undefined;
+    }>;
+}

package/dist/mcp/primitives/gui/tools/gui-selected-notes.tool.js

@@ -0,0 +1,82 @@
+"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 GuiSelectedNotesTool_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GuiSelectedNotesTool = 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 GuiSelectedNotesTool = GuiSelectedNotesTool_1 = class GuiSelectedNotesTool {
+    ankiClient;
+    logger = new common_1.Logger(GuiSelectedNotesTool_1.name);
+    constructor(ankiClient) {
+        this.ankiClient = ankiClient;
+    }
+    async guiSelectedNotes(_args, context) {
+        try {
+            this.logger.log('Getting selected notes from Card Browser');
+            await context.reportProgress({ progress: 50, total: 100 });
+            const noteIds = await this.ankiClient.invoke('guiSelectedNotes');
+            await context.reportProgress({ progress: 100, total: 100 });
+            this.logger.log(`Retrieved ${noteIds.length} selected note(s) from Card Browser`);
+            if (noteIds.length === 0) {
+                return (0, anki_utils_1.createSuccessResponse)({
+                    success: true,
+                    noteIds: [],
+                    noteCount: 0,
+                    message: 'No notes are currently selected in the Card Browser',
+                    hint: 'Open the Card Browser (guiBrowse) and select some cards/notes first.',
+                });
+            }
+            return (0, anki_utils_1.createSuccessResponse)({
+                success: true,
+                noteIds,
+                noteCount: noteIds.length,
+                message: `Retrieved ${noteIds.length} selected note ID(s) from Card Browser`,
+                hint: 'Use notesInfo to get details about these notes, or updateNoteFields/deleteNotes to modify them.',
+            });
+        }
+        catch (error) {
+            this.logger.error('Failed to get selected notes', error);
+            if (error instanceof Error) {
+                if (error.message.includes('browser') || error.message.includes('not open')) {
+                    return (0, anki_utils_1.createErrorResponse)(error, {
+                        hint: 'Card Browser is not open. Use guiBrowse to open it first.',
+                    });
+                }
+            }
+            return (0, anki_utils_1.createErrorResponse)(error, {
+                hint: 'Make sure Anki is running and the Card Browser is open',
+            });
+        }
+    }
+};
+exports.GuiSelectedNotesTool = GuiSelectedNotesTool;
+__decorate([
+    (0, mcp_nest_1.Tool)({
+        name: 'guiSelectedNotes',
+        description: 'Get the IDs of notes currently selected in the Card Browser. Returns array of note IDs (empty if no selection). ' +
+            'IMPORTANT: Only use when user explicitly requests getting selected notes. ' +
+            'This tool is for note editing/creation workflows, NOT for review sessions. ' +
+            'The Card Browser must be open with cards selected.',
+        parameters: zod_1.z.object({}),
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], GuiSelectedNotesTool.prototype, "guiSelectedNotes", null);
+exports.GuiSelectedNotesTool = GuiSelectedNotesTool = GuiSelectedNotesTool_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [anki_connect_client_1.AnkiConnectClient])
+], GuiSelectedNotesTool);
+//# sourceMappingURL=gui-selected-notes.tool.js.map

package/dist/mcp/primitives/gui/tools/gui-selected-notes.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gui-selected-notes.tool.js","sourceRoot":"","sources":["../../../../../src/mcp/primitives/gui/tools/gui-selected-notes.tool.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAAA,2CAAoD;AACpD,8CAAuC;AAEvC,6BAAwB;AACxB,8EAAsE;AACtE,0DAAoF;AAM7E,IAAM,oBAAoB,4BAA1B,MAAM,oBAAoB;IAGF;IAFZ,MAAM,GAAG,IAAI,eAAM,CAAC,sBAAoB,CAAC,IAAI,CAAC,CAAC;IAEhE,YAA6B,UAA6B;QAA7B,eAAU,GAAV,UAAU,CAAmB;IAAG,CAAC;IAWxD,AAAN,KAAK,CAAC,gBAAgB,CAAC,KAAS,EAAE,OAAgB;QAChD,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;YAC5D,MAAM,OAAO,CAAC,cAAc,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;YAG3D,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAW,kBAAkB,CAAC,CAAC;YAE3E,MAAM,OAAO,CAAC,cAAc,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;YAC5D,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,OAAO,CAAC,MAAM,qCAAqC,CAAC,CAAC;YAElF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO,IAAA,kCAAqB,EAAC;oBAC3B,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE,EAAE;oBACX,SAAS,EAAE,CAAC;oBACZ,OAAO,EAAE,qDAAqD;oBAC9D,IAAI,EAAE,sEAAsE;iBAC7E,CAAC,CAAC;YACL,CAAC;YAED,OAAO,IAAA,kCAAqB,EAAC;gBAC3B,OAAO,EAAE,IAAI;gBACb,OAAO;gBACP,SAAS,EAAE,OAAO,CAAC,MAAM;gBACzB,OAAO,EAAE,aAAa,OAAO,CAAC,MAAM,wCAAwC;gBAC5E,IAAI,EAAE,iGAAiG;aACxG,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,8BAA8B,EAAE,KAAK,CAAC,CAAC;YAEzD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;gBAC3B,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;oBAC5E,OAAO,IAAA,gCAAmB,EAAC,KAAK,EAAE;wBAChC,IAAI,EAAE,2DAA2D;qBAClE,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAED,OAAO,IAAA,gCAAmB,EAAC,KAAK,EAAE;gBAChC,IAAI,EAAE,wDAAwD;aAC/D,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF,CAAA;AA1DY,oDAAoB;AAczB;IATL,IAAA,eAAI,EAAC;QACJ,IAAI,EAAE,kBAAkB;QACxB,WAAW,EACT,kHAAkH;YAClH,4EAA4E;YAC5E,6EAA6E;YAC7E,oDAAoD;QACtD,UAAU,EAAE,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC;KACzB,CAAC;;;;4DA4CD;+BAzDU,oBAAoB;IADhC,IAAA,mBAAU,GAAE;qCAI8B,uCAAiB;GAH/C,oBAAoB,CA0DhC"}

package/dist/mcp/primitives/gui/tools/gui-show-answer.tool.d.ts

@@ -0,0 +1,81 @@
+import type { Context } from '@rekog/mcp-nest';
+import { AnkiConnectClient } from '@/mcp/clients/anki-connect.client';
+export declare class GuiShowAnswerTool {
+    private readonly ankiClient;
+    private readonly logger;
+    constructor(ankiClient: AnkiConnectClient);
+    guiShowAnswer(_args: {}, context: Context): Promise<{
+        [x: string]: unknown;
+        content: ({
+            [x: string]: unknown;
+            type: "text";
+            text: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "image";
+            data: string;
+            mimeType: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "audio";
+            data: string;
+            mimeType: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "resource_link";
+            name: string;
+            uri: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+            mimeType?: string | undefined;
+            title?: string | undefined;
+            description?: string | undefined;
+            icons?: {
+                [x: string]: unknown;
+                src: string;
+                mimeType?: string | undefined;
+                sizes?: string[] | undefined;
+            }[] | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "resource";
+            resource: {
+                [x: string]: unknown;
+                text: string;
+                uri: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+                mimeType?: string | undefined;
+            } | {
+                [x: string]: unknown;
+                uri: string;
+                blob: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+                mimeType?: string | undefined;
+            };
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        })[];
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+        structuredContent?: {
+            [x: string]: unknown;
+        } | undefined;
+        isError?: boolean | undefined;
+    }>;
+}

package/dist/mcp/primitives/gui/tools/gui-show-answer.tool.js

@@ -0,0 +1,74 @@
+"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 GuiShowAnswerTool_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GuiShowAnswerTool = 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 GuiShowAnswerTool = GuiShowAnswerTool_1 = class GuiShowAnswerTool {
+    ankiClient;
+    logger = new common_1.Logger(GuiShowAnswerTool_1.name);
+    constructor(ankiClient) {
+        this.ankiClient = ankiClient;
+    }
+    async guiShowAnswer(_args, context) {
+        try {
+            this.logger.log('Showing answer side of current card');
+            await context.reportProgress({ progress: 50, total: 100 });
+            const inReview = await this.ankiClient.invoke('guiShowAnswer');
+            await context.reportProgress({ progress: 100, total: 100 });
+            if (!inReview) {
+                this.logger.warn('Not in review mode');
+                return (0, anki_utils_1.createSuccessResponse)({
+                    success: true,
+                    inReview: false,
+                    message: 'Not in review mode - answer cannot be shown',
+                    hint: 'Start reviewing a deck in Anki to use this tool.',
+                });
+            }
+            this.logger.log('Answer side shown');
+            return (0, anki_utils_1.createSuccessResponse)({
+                success: true,
+                inReview: true,
+                message: 'Answer side is now displayed',
+                hint: 'Use guiCurrentCard to get full card details including the answer content.',
+            });
+        }
+        catch (error) {
+            this.logger.error('Failed to show answer', error);
+            return (0, anki_utils_1.createErrorResponse)(error, {
+                hint: 'Make sure Anki is running, GUI is visible, and you are in review mode',
+            });
+        }
+    }
+};
+exports.GuiShowAnswerTool = GuiShowAnswerTool;
+__decorate([
+    (0, mcp_nest_1.Tool)({
+        name: 'guiShowAnswer',
+        description: 'Show the answer side of the current card in review mode. Returns true if in review mode, false otherwise. ' +
+            'CRITICAL: This tool is ONLY for note editing/creation workflows when user needs to view the answer side to verify content. ' +
+            'NEVER use this for conducting review sessions. Use the dedicated review tools (present_card) instead. ' +
+            'IMPORTANT: Only use when user explicitly requests showing the answer.',
+        parameters: zod_1.z.object({}),
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], GuiShowAnswerTool.prototype, "guiShowAnswer", null);
+exports.GuiShowAnswerTool = GuiShowAnswerTool = GuiShowAnswerTool_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [anki_connect_client_1.AnkiConnectClient])
+], GuiShowAnswerTool);
+//# sourceMappingURL=gui-show-answer.tool.js.map

package/dist/mcp/primitives/gui/tools/gui-show-answer.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gui-show-answer.tool.js","sourceRoot":"","sources":["../../../../../src/mcp/primitives/gui/tools/gui-show-answer.tool.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAAA,2CAAoD;AACpD,8CAAuC;AAEvC,6BAAwB;AACxB,8EAAsE;AACtE,0DAAoF;AAM7E,IAAM,iBAAiB,yBAAvB,MAAM,iBAAiB;IAGC;IAFZ,MAAM,GAAG,IAAI,eAAM,CAAC,mBAAiB,CAAC,IAAI,CAAC,CAAC;IAE7D,YAA6B,UAA6B;QAA7B,eAAU,GAAV,UAAU,CAAmB;IAAG,CAAC;IAWxD,AAAN,KAAK,CAAC,aAAa,CAAC,KAAS,EAAE,OAAgB;QAC7C,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;YACvD,MAAM,OAAO,CAAC,cAAc,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;YAG3D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAU,eAAe,CAAC,CAAC;YAExE,MAAM,OAAO,CAAC,cAAc,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;YAE5D,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;gBACvC,OAAO,IAAA,kCAAqB,EAAC;oBAC3B,OAAO,EAAE,IAAI;oBACb,QAAQ,EAAE,KAAK;oBACf,OAAO,EAAE,6CAA6C;oBACtD,IAAI,EAAE,kDAAkD;iBACzD,CAAC,CAAC;YACL,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;YAErC,OAAO,IAAA,kCAAqB,EAAC;gBAC3B,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE,IAAI;gBACd,OAAO,EAAE,8BAA8B;gBACvC,IAAI,EAAE,2EAA2E;aAClF,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,KAAK,CAAC,CAAC;YAElD,OAAO,IAAA,gCAAmB,EAAC,KAAK,EAAE;gBAChC,IAAI,EAAE,uEAAuE;aAC9E,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF,CAAA;AAlDY,8CAAiB;AActB;IATL,IAAA,eAAI,EAAC;QACJ,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,4GAA4G;YAC5G,6HAA6H;YAC7H,wGAAwG;YACxG,uEAAuE;QACzE,UAAU,EAAE,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC;KACzB,CAAC;;;;sDAoCD;4BAjDU,iBAAiB;IAD7B,IAAA,mBAAU,GAAE;qCAI8B,uCAAiB;GAH/C,iBAAiB,CAkD7B"}

package/dist/mcp/primitives/gui/tools/gui-show-question.tool.d.ts

@@ -0,0 +1,81 @@
+import type { Context } from '@rekog/mcp-nest';
+import { AnkiConnectClient } from '@/mcp/clients/anki-connect.client';
+export declare class GuiShowQuestionTool {
+    private readonly ankiClient;
+    private readonly logger;
+    constructor(ankiClient: AnkiConnectClient);
+    guiShowQuestion(_args: {}, context: Context): Promise<{
+        [x: string]: unknown;
+        content: ({
+            [x: string]: unknown;
+            type: "text";
+            text: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "image";
+            data: string;
+            mimeType: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "audio";
+            data: string;
+            mimeType: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "resource_link";
+            name: string;
+            uri: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+            mimeType?: string | undefined;
+            title?: string | undefined;
+            description?: string | undefined;
+            icons?: {
+                [x: string]: unknown;
+                src: string;
+                mimeType?: string | undefined;
+                sizes?: string[] | undefined;
+            }[] | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "resource";
+            resource: {
+                [x: string]: unknown;
+                text: string;
+                uri: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+                mimeType?: string | undefined;
+            } | {
+                [x: string]: unknown;
+                uri: string;
+                blob: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+                mimeType?: string | undefined;
+            };
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        })[];
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+        structuredContent?: {
+            [x: string]: unknown;
+        } | undefined;
+        isError?: boolean | undefined;
+    }>;
+}

package/dist/mcp/primitives/gui/tools/gui-show-question.tool.js

@@ -0,0 +1,74 @@
+"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 GuiShowQuestionTool_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GuiShowQuestionTool = 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 GuiShowQuestionTool = GuiShowQuestionTool_1 = class GuiShowQuestionTool {
+    ankiClient;
+    logger = new common_1.Logger(GuiShowQuestionTool_1.name);
+    constructor(ankiClient) {
+        this.ankiClient = ankiClient;
+    }
+    async guiShowQuestion(_args, context) {
+        try {
+            this.logger.log('Showing question side of current card');
+            await context.reportProgress({ progress: 50, total: 100 });
+            const inReview = await this.ankiClient.invoke('guiShowQuestion');
+            await context.reportProgress({ progress: 100, total: 100 });
+            if (!inReview) {
+                this.logger.warn('Not in review mode');
+                return (0, anki_utils_1.createSuccessResponse)({
+                    success: true,
+                    inReview: false,
+                    message: 'Not in review mode - question cannot be shown',
+                    hint: 'Start reviewing a deck in Anki to use this tool.',
+                });
+            }
+            this.logger.log('Question side shown');
+            return (0, anki_utils_1.createSuccessResponse)({
+                success: true,
+                inReview: true,
+                message: 'Question side is now displayed',
+                hint: 'Use guiCurrentCard to get the card details, or guiShowAnswer to reveal the answer.',
+            });
+        }
+        catch (error) {
+            this.logger.error('Failed to show question', error);
+            return (0, anki_utils_1.createErrorResponse)(error, {
+                hint: 'Make sure Anki is running, GUI is visible, and you are in review mode',
+            });
+        }
+    }
+};
+exports.GuiShowQuestionTool = GuiShowQuestionTool;
+__decorate([
+    (0, mcp_nest_1.Tool)({
+        name: 'guiShowQuestion',
+        description: 'Show the question side of the current card in review mode. Returns true if in review mode, false otherwise. ' +
+            'CRITICAL: This tool is ONLY for note editing/creation workflows when user needs to view the question side to verify content. ' +
+            'NEVER use this for conducting review sessions. Use the dedicated review tools (present_card) instead. ' +
+            'IMPORTANT: Only use when user explicitly requests showing the question.',
+        parameters: zod_1.z.object({}),
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], GuiShowQuestionTool.prototype, "guiShowQuestion", null);
+exports.GuiShowQuestionTool = GuiShowQuestionTool = GuiShowQuestionTool_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [anki_connect_client_1.AnkiConnectClient])
+], GuiShowQuestionTool);
+//# sourceMappingURL=gui-show-question.tool.js.map

package/dist/mcp/primitives/gui/tools/gui-show-question.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gui-show-question.tool.js","sourceRoot":"","sources":["../../../../../src/mcp/primitives/gui/tools/gui-show-question.tool.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAAA,2CAAoD;AACpD,8CAAuC;AAEvC,6BAAwB;AACxB,8EAAsE;AACtE,0DAAoF;AAM7E,IAAM,mBAAmB,2BAAzB,MAAM,mBAAmB;IAGD;IAFZ,MAAM,GAAG,IAAI,eAAM,CAAC,qBAAmB,CAAC,IAAI,CAAC,CAAC;IAE/D,YAA6B,UAA6B;QAA7B,eAAU,GAAV,UAAU,CAAmB;IAAG,CAAC;IAWxD,AAAN,KAAK,CAAC,eAAe,CAAC,KAAS,EAAE,OAAgB;QAC/C,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC;YACzD,MAAM,OAAO,CAAC,cAAc,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;YAG3D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAU,iBAAiB,CAAC,CAAC;YAE1E,MAAM,OAAO,CAAC,cAAc,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;YAE5D,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;gBACvC,OAAO,IAAA,kCAAqB,EAAC;oBAC3B,OAAO,EAAE,IAAI;oBACb,QAAQ,EAAE,KAAK;oBACf,OAAO,EAAE,+CAA+C;oBACxD,IAAI,EAAE,kDAAkD;iBACzD,CAAC,CAAC;YACL,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;YAEvC,OAAO,IAAA,kCAAqB,EAAC;gBAC3B,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE,IAAI;gBACd,OAAO,EAAE,gCAAgC;gBACzC,IAAI,EAAE,oFAAoF;aAC3F,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;YAEpD,OAAO,IAAA,gCAAmB,EAAC,KAAK,EAAE;gBAChC,IAAI,EAAE,uEAAuE;aAC9E,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF,CAAA;AAlDY,kDAAmB;AAcxB;IATL,IAAA,eAAI,EAAC;QACJ,IAAI,EAAE,iBAAiB;QACvB,WAAW,EACT,8GAA8G;YAC9G,+HAA+H;YAC/H,wGAAwG;YACxG,yEAAyE;QAC3E,UAAU,EAAE,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC;KACzB,CAAC;;;;0DAoCD;8BAjDU,mBAAmB;IAD/B,IAAA,mBAAU,GAAE;qCAI8B,uCAAiB;GAH/C,mBAAmB,CAkD/B"}

package/dist/mcp/primitives/gui/tools/gui-undo.tool.d.ts

@@ -0,0 +1,81 @@
+import type { Context } from '@rekog/mcp-nest';
+import { AnkiConnectClient } from '@/mcp/clients/anki-connect.client';
+export declare class GuiUndoTool {
+    private readonly ankiClient;
+    private readonly logger;
+    constructor(ankiClient: AnkiConnectClient);
+    guiUndo(_args: {}, context: Context): Promise<{
+        [x: string]: unknown;
+        content: ({
+            [x: string]: unknown;
+            type: "text";
+            text: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "image";
+            data: string;
+            mimeType: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "audio";
+            data: string;
+            mimeType: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "resource_link";
+            name: string;
+            uri: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+            mimeType?: string | undefined;
+            title?: string | undefined;
+            description?: string | undefined;
+            icons?: {
+                [x: string]: unknown;
+                src: string;
+                mimeType?: string | undefined;
+                sizes?: string[] | undefined;
+            }[] | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "resource";
+            resource: {
+                [x: string]: unknown;
+                text: string;
+                uri: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+                mimeType?: string | undefined;
+            } | {
+                [x: string]: unknown;
+                uri: string;
+                blob: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+                mimeType?: string | undefined;
+            };
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        })[];
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+        structuredContent?: {
+            [x: string]: unknown;
+        } | undefined;
+        isError?: boolean | undefined;
+    }>;
+}