anki-mcp-http 0.3.0 → 0.5.0

package/dist/mcp/primitives/gui/index.d.ts

@@ -1,4 +1,23 @@
-import { DynamicModule } from '@nestjs/common';
+export { ANKI_CONFIG } from '../../config/anki-config.interface';
+export type { IAnkiConfig } from '../../config/anki-config.interface';
+export * from '../../types/anki.types';
+export * from '../../utils/anki.utils';
+export { AnkiConnectClient, AnkiConnectError } from '../../clients/anki-connect.client';
+export { GuiBrowseTool } from './tools/gui-browse.tool';
+export { GuiSelectCardTool } from './tools/gui-select-card.tool';
+export { GuiSelectedNotesTool } from './tools/gui-selected-notes.tool';
+export { GuiAddCardsTool } from './tools/gui-add-cards.tool';
+export { GuiEditNoteTool } from './tools/gui-edit-note.tool';
+export { GuiDeckOverviewTool } from './tools/gui-deck-overview.tool';
+export { GuiDeckBrowserTool } from './tools/gui-deck-browser.tool';
+export { GuiCurrentCardTool } from './tools/gui-current-card.tool';
+export { GuiShowQuestionTool } from './tools/gui-show-question.tool';
+export { GuiShowAnswerTool } from './tools/gui-show-answer.tool';
+export { GuiUndoTool } from './tools/gui-undo.tool';
+import { DynamicModule, Provider } from '@nestjs/common';
+export interface McpPrimitivesAnkiGuiModuleOptions {
+    ankiConfigProvider: Provider;
+}
 export declare class McpPrimitivesAnkiGuiModule {
-    static forRoot(): DynamicModule;
+    static forRoot(options: McpPrimitivesAnkiGuiModuleOptions): DynamicModule;
 }

package/dist/mcp/primitives/gui/index.js

@@ -1,21 +1,89 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
 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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 var McpPrimitivesAnkiGuiModule_1;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.McpPrimitivesAnkiGuiModule = void 0;
+exports.McpPrimitivesAnkiGuiModule = exports.GuiUndoTool = exports.GuiShowAnswerTool = exports.GuiShowQuestionTool = exports.GuiCurrentCardTool = exports.GuiDeckBrowserTool = exports.GuiDeckOverviewTool = exports.GuiEditNoteTool = exports.GuiAddCardsTool = exports.GuiSelectedNotesTool = exports.GuiSelectCardTool = exports.GuiBrowseTool = exports.AnkiConnectError = exports.AnkiConnectClient = exports.ANKI_CONFIG = void 0;
+var anki_config_interface_1 = require("../../config/anki-config.interface");
+Object.defineProperty(exports, "ANKI_CONFIG", { enumerable: true, get: function () { return anki_config_interface_1.ANKI_CONFIG; } });
+__exportStar(require("../../types/anki.types"), exports);
+__exportStar(require("../../utils/anki.utils"), exports);
+var anki_connect_client_1 = require("../../clients/anki-connect.client");
+Object.defineProperty(exports, "AnkiConnectClient", { enumerable: true, get: function () { return anki_connect_client_1.AnkiConnectClient; } });
+Object.defineProperty(exports, "AnkiConnectError", { enumerable: true, get: function () { return anki_connect_client_1.AnkiConnectError; } });
+var gui_browse_tool_1 = require("./tools/gui-browse.tool");
+Object.defineProperty(exports, "GuiBrowseTool", { enumerable: true, get: function () { return gui_browse_tool_1.GuiBrowseTool; } });
+var gui_select_card_tool_1 = require("./tools/gui-select-card.tool");
+Object.defineProperty(exports, "GuiSelectCardTool", { enumerable: true, get: function () { return gui_select_card_tool_1.GuiSelectCardTool; } });
+var gui_selected_notes_tool_1 = require("./tools/gui-selected-notes.tool");
+Object.defineProperty(exports, "GuiSelectedNotesTool", { enumerable: true, get: function () { return gui_selected_notes_tool_1.GuiSelectedNotesTool; } });
+var gui_add_cards_tool_1 = require("./tools/gui-add-cards.tool");
+Object.defineProperty(exports, "GuiAddCardsTool", { enumerable: true, get: function () { return gui_add_cards_tool_1.GuiAddCardsTool; } });
+var gui_edit_note_tool_1 = require("./tools/gui-edit-note.tool");
+Object.defineProperty(exports, "GuiEditNoteTool", { enumerable: true, get: function () { return gui_edit_note_tool_1.GuiEditNoteTool; } });
+var gui_deck_overview_tool_1 = require("./tools/gui-deck-overview.tool");
+Object.defineProperty(exports, "GuiDeckOverviewTool", { enumerable: true, get: function () { return gui_deck_overview_tool_1.GuiDeckOverviewTool; } });
+var gui_deck_browser_tool_1 = require("./tools/gui-deck-browser.tool");
+Object.defineProperty(exports, "GuiDeckBrowserTool", { enumerable: true, get: function () { return gui_deck_browser_tool_1.GuiDeckBrowserTool; } });
+var gui_current_card_tool_1 = require("./tools/gui-current-card.tool");
+Object.defineProperty(exports, "GuiCurrentCardTool", { enumerable: true, get: function () { return gui_current_card_tool_1.GuiCurrentCardTool; } });
+var gui_show_question_tool_1 = require("./tools/gui-show-question.tool");
+Object.defineProperty(exports, "GuiShowQuestionTool", { enumerable: true, get: function () { return gui_show_question_tool_1.GuiShowQuestionTool; } });
+var gui_show_answer_tool_1 = require("./tools/gui-show-answer.tool");
+Object.defineProperty(exports, "GuiShowAnswerTool", { enumerable: true, get: function () { return gui_show_answer_tool_1.GuiShowAnswerTool; } });
+var gui_undo_tool_1 = require("./tools/gui-undo.tool");
+Object.defineProperty(exports, "GuiUndoTool", { enumerable: true, get: function () { return gui_undo_tool_1.GuiUndoTool; } });
 const common_1 = require("@nestjs/common");
-const MCP_GUI_PRIMITIVES = [];
+const anki_connect_client_2 = require("../../clients/anki-connect.client");
+const gui_browse_tool_2 = require("./tools/gui-browse.tool");
+const gui_select_card_tool_2 = require("./tools/gui-select-card.tool");
+const gui_selected_notes_tool_2 = require("./tools/gui-selected-notes.tool");
+const gui_add_cards_tool_2 = require("./tools/gui-add-cards.tool");
+const gui_edit_note_tool_2 = require("./tools/gui-edit-note.tool");
+const gui_deck_overview_tool_2 = require("./tools/gui-deck-overview.tool");
+const gui_deck_browser_tool_2 = require("./tools/gui-deck-browser.tool");
+const gui_current_card_tool_2 = require("./tools/gui-current-card.tool");
+const gui_show_question_tool_2 = require("./tools/gui-show-question.tool");
+const gui_show_answer_tool_2 = require("./tools/gui-show-answer.tool");
+const gui_undo_tool_2 = require("./tools/gui-undo.tool");
+const MCP_PRIMITIVES = [
+    anki_connect_client_2.AnkiConnectClient,
+    gui_browse_tool_2.GuiBrowseTool,
+    gui_select_card_tool_2.GuiSelectCardTool,
+    gui_selected_notes_tool_2.GuiSelectedNotesTool,
+    gui_add_cards_tool_2.GuiAddCardsTool,
+    gui_edit_note_tool_2.GuiEditNoteTool,
+    gui_deck_overview_tool_2.GuiDeckOverviewTool,
+    gui_deck_browser_tool_2.GuiDeckBrowserTool,
+    gui_current_card_tool_2.GuiCurrentCardTool,
+    gui_show_question_tool_2.GuiShowQuestionTool,
+    gui_show_answer_tool_2.GuiShowAnswerTool,
+    gui_undo_tool_2.GuiUndoTool,
+];
 let McpPrimitivesAnkiGuiModule = McpPrimitivesAnkiGuiModule_1 = class McpPrimitivesAnkiGuiModule {
-    static forRoot() {
+    static forRoot(options) {
         return {
             module: McpPrimitivesAnkiGuiModule_1,
-            providers: MCP_GUI_PRIMITIVES,
-            exports: MCP_GUI_PRIMITIVES,
+            providers: [options.ankiConfigProvider, ...MCP_PRIMITIVES],
+            exports: MCP_PRIMITIVES,
         };
     }
 };

package/dist/mcp/primitives/gui/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/mcp/primitives/gui/index.ts"],"names":[],"mappings":";;;;;;;;;;AACA,2CAAuD;AAEvD,MAAM,kBAAkB,GAAU,EAEjC,CAAC;AAGK,IAAM,0BAA0B,kCAAhC,MAAM,0BAA0B;IACrC,MAAM,CAAC,OAAO;QACZ,OAAO;YACL,MAAM,EAAE,4BAA0B;YAClC,SAAS,EAAE,kBAAkB;YAC7B,OAAO,EAAE,kBAAkB;SAC5B,CAAC;IACJ,CAAC;CACF,CAAA;AARY,gEAA0B;qCAA1B,0BAA0B;IADtC,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,0BAA0B,CAQtC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/mcp/primitives/gui/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AACA,4EAAiE;AAAxD,oHAAA,WAAW,OAAA;AAIpB,yDAAuC;AAGvC,yDAAuC;AAGvC,yEAAwF;AAA/E,wHAAA,iBAAiB,OAAA;AAAE,uHAAA,gBAAgB,OAAA;AAG5C,2DAAwD;AAA/C,gHAAA,aAAa,OAAA;AACtB,qEAAiE;AAAxD,yHAAA,iBAAiB,OAAA;AAC1B,2EAAuE;AAA9D,+HAAA,oBAAoB,OAAA;AAG7B,iEAA6D;AAApD,qHAAA,eAAe,OAAA;AACxB,iEAA6D;AAApD,qHAAA,eAAe,OAAA;AACxB,yEAAqE;AAA5D,6HAAA,mBAAmB,OAAA;AAC5B,uEAAmE;AAA1D,2HAAA,kBAAkB,OAAA;AAG3B,uEAAmE;AAA1D,2HAAA,kBAAkB,OAAA;AAC3B,yEAAqE;AAA5D,6HAAA,mBAAmB,OAAA;AAC5B,qEAAiE;AAAxD,yHAAA,iBAAiB,OAAA;AAC1B,uDAAoD;AAA3C,4GAAA,WAAW,OAAA;AAGpB,2CAAiE;AACjE,2EAAsE;AACtE,6DAAwD;AACxD,uEAAiE;AACjE,6EAAuE;AACvE,mEAA6D;AAC7D,mEAA6D;AAC7D,2EAAqE;AACrE,yEAAmE;AACnE,yEAAmE;AACnE,2EAAqE;AACrE,uEAAiE;AACjE,yDAAoD;AAEpD,MAAM,cAAc,GAAG;IAErB,uCAAiB;IAEjB,+BAAa;IACb,wCAAiB;IACjB,8CAAoB;IAEpB,oCAAe;IACf,oCAAe;IACf,4CAAmB;IACnB,0CAAkB;IAElB,0CAAkB;IAClB,4CAAmB;IACnB,wCAAiB;IACjB,2BAAW;CACZ,CAAC;AAOK,IAAM,0BAA0B,kCAAhC,MAAM,0BAA0B;IACrC,MAAM,CAAC,OAAO,CAAC,OAA0C;QACvD,OAAO;YACL,MAAM,EAAE,4BAA0B;YAClC,SAAS,EAAE,CAAC,OAAO,CAAC,kBAAkB,EAAE,GAAG,cAAc,CAAC;YAC1D,OAAO,EAAE,cAAc;SACxB,CAAC;IACJ,CAAC;CACF,CAAA;AARY,gEAA0B;qCAA1B,0BAA0B;IADtC,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,0BAA0B,CAQtC"}

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

@@ -0,0 +1,88 @@
+import type { Context } from '@rekog/mcp-nest';
+import { AnkiConnectClient } from '@/mcp/clients/anki-connect.client';
+export declare class GuiAddCardsTool {
+    private readonly ankiClient;
+    private readonly logger;
+    constructor(ankiClient: AnkiConnectClient);
+    guiAddCards({ note, }: {
+        note: {
+            deckName: string;
+            modelName: string;
+            fields: Record<string, string>;
+            tags?: string[];
+        };
+    }, 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-add-cards.tool.js

@@ -0,0 +1,111 @@
+"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 GuiAddCardsTool_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GuiAddCardsTool = 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 GuiAddCardsTool = GuiAddCardsTool_1 = class GuiAddCardsTool {
+    ankiClient;
+    logger = new common_1.Logger(GuiAddCardsTool_1.name);
+    constructor(ankiClient) {
+        this.ankiClient = ankiClient;
+    }
+    async guiAddCards({ note, }, context) {
+        try {
+            this.logger.log(`Opening Add Cards dialog for deck "${note.deckName}"`);
+            await context.reportProgress({ progress: 25, total: 100 });
+            const emptyFields = Object.entries(note.fields).filter(([_, value]) => !value || value.trim() === '');
+            if (emptyFields.length > 0) {
+                return (0, anki_utils_1.createErrorResponse)(new Error(`Fields cannot be empty: ${emptyFields.map(([key]) => key).join(', ')}`), {
+                    deckName: note.deckName,
+                    modelName: note.modelName,
+                    emptyFields: emptyFields.map(([key]) => key),
+                });
+            }
+            await context.reportProgress({ progress: 50, total: 100 });
+            const noteId = await this.ankiClient.invoke('guiAddCards', { note });
+            await context.reportProgress({ progress: 100, total: 100 });
+            this.logger.log(`Add Cards dialog opened, potential note ID: ${noteId}`);
+            return (0, anki_utils_1.createSuccessResponse)({
+                success: true,
+                noteId,
+                deckName: note.deckName,
+                modelName: note.modelName,
+                message: `Add Cards dialog opened with preset details for deck "${note.deckName}"`,
+                hint: 'The user can now review and finalize the note in the Anki GUI. The note will be created when they click Add.',
+            });
+        }
+        catch (error) {
+            this.logger.error('Failed to open Add Cards dialog', error);
+            if (error instanceof Error) {
+                const errorMessage = error.message.toLowerCase();
+                if (errorMessage.includes('field')) {
+                    return (0, anki_utils_1.createErrorResponse)(error, {
+                        modelName: note.modelName,
+                        providedFields: Object.keys(note.fields),
+                        hint: 'Field mismatch. Use modelFieldNames tool to see required fields.',
+                    });
+                }
+                if (errorMessage.includes('model')) {
+                    return (0, anki_utils_1.createErrorResponse)(error, {
+                        modelName: note.modelName,
+                        hint: 'Model not found. Use modelNames tool to see available models.',
+                    });
+                }
+                if (errorMessage.includes('deck')) {
+                    return (0, anki_utils_1.createErrorResponse)(error, {
+                        deckName: note.deckName,
+                        hint: 'Deck not found. Use list_decks tool to see available decks.',
+                    });
+                }
+            }
+            return (0, anki_utils_1.createErrorResponse)(error, {
+                deckName: note.deckName,
+                modelName: note.modelName,
+                hint: 'Make sure Anki is running and the deck/model names are correct',
+            });
+        }
+    }
+};
+exports.GuiAddCardsTool = GuiAddCardsTool;
+__decorate([
+    (0, mcp_nest_1.Tool)({
+        name: 'guiAddCards',
+        description: 'Open Anki Add Cards dialog with preset note details (deck, model, fields, tags). Returns potential note ID. ' +
+            'IMPORTANT: Only use when user explicitly requests opening the Add Cards dialog. ' +
+            'This tool is for note editing/creation workflows. Use this when user wants to manually review and finalize note creation in the GUI.',
+        parameters: zod_1.z.object({
+            note: zod_1.z.object({
+                deckName: zod_1.z.string().min(1).describe('Deck to add the note to'),
+                modelName: zod_1.z.string().min(1).describe('Note type/model (e.g., "Basic", "Cloze")'),
+                fields: zod_1.z
+                    .record(zod_1.z.string())
+                    .describe('Field values to pre-fill (e.g., {"Front": "question", "Back": "answer"})'),
+                tags: zod_1.z
+                    .array(zod_1.z.string())
+                    .optional()
+                    .describe('Optional tags to add'),
+            }),
+        }),
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], GuiAddCardsTool.prototype, "guiAddCards", null);
+exports.GuiAddCardsTool = GuiAddCardsTool = GuiAddCardsTool_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [anki_connect_client_1.AnkiConnectClient])
+], GuiAddCardsTool);
+//# sourceMappingURL=gui-add-cards.tool.js.map

package/dist/mcp/primitives/gui/tools/gui-add-cards.tool.js.map

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

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

@@ -0,0 +1,87 @@
+import type { Context } from '@rekog/mcp-nest';
+import { AnkiConnectClient } from '@/mcp/clients/anki-connect.client';
+export declare class GuiBrowseTool {
+    private readonly ankiClient;
+    private readonly logger;
+    constructor(ankiClient: AnkiConnectClient);
+    guiBrowse({ query, reorderCards, }: {
+        query: string;
+        reorderCards?: {
+            order: 'ascending' | 'descending';
+            columnId: string;
+        };
+    }, 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-browse.tool.js

@@ -0,0 +1,98 @@
+"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 GuiBrowseTool_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GuiBrowseTool = 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 GuiBrowseTool = GuiBrowseTool_1 = class GuiBrowseTool {
+    ankiClient;
+    logger = new common_1.Logger(GuiBrowseTool_1.name);
+    constructor(ankiClient) {
+        this.ankiClient = ankiClient;
+    }
+    async guiBrowse({ query, reorderCards, }, context) {
+        try {
+            this.logger.log(`Opening Card Browser with query: "${query}"`);
+            await context.reportProgress({ progress: 25, total: 100 });
+            const params = { query };
+            if (reorderCards) {
+                params.reorderCards = reorderCards;
+            }
+            const cardIds = await this.ankiClient.invoke('guiBrowse', params);
+            await context.reportProgress({ progress: 100, total: 100 });
+            this.logger.log(`Card Browser opened with ${cardIds.length} card(s) found`);
+            return (0, anki_utils_1.createSuccessResponse)({
+                success: true,
+                cardIds,
+                cardCount: cardIds.length,
+                query,
+                message: `Card Browser opened with ${cardIds.length} card(s) matching query "${query}"`,
+                hint: cardIds.length === 0
+                    ? 'No cards found. Try adjusting your search query.'
+                    : 'Use guiSelectCard to select a specific card, or guiSelectedNotes to get selected notes.',
+            });
+        }
+        catch (error) {
+            this.logger.error('Failed to open Card Browser', error);
+            if (error instanceof Error) {
+                if (error.message.includes('query') || error.message.includes('syntax')) {
+                    return (0, anki_utils_1.createErrorResponse)(error, {
+                        query,
+                        hint: 'Invalid search query. Check Anki search syntax. Examples: "deck:MyDeck", "tag:important", "is:due"',
+                    });
+                }
+            }
+            return (0, anki_utils_1.createErrorResponse)(error, {
+                query,
+                hint: 'Make sure Anki is running and the GUI is visible',
+            });
+        }
+    }
+};
+exports.GuiBrowseTool = GuiBrowseTool;
+__decorate([
+    (0, mcp_nest_1.Tool)({
+        name: 'guiBrowse',
+        description: 'Open Anki Card Browser and search for cards using Anki query syntax. Returns array of card IDs found. ' +
+            'IMPORTANT: Only use when user explicitly requests opening the browser. ' +
+            'This tool is for note editing/creation workflows, NOT for review sessions. ' +
+            'Use this to find and select cards/notes that need editing.',
+        parameters: zod_1.z.object({
+            query: zod_1.z
+                .string()
+                .min(1)
+                .describe('Anki search query using standard syntax (e.g., "deck:Spanish tag:verb", "is:due", "added:7")'),
+            reorderCards: zod_1.z
+                .object({
+                order: zod_1.z
+                    .enum(['ascending', 'descending'])
+                    .describe('Sort order for the cards in browser'),
+                columnId: zod_1.z
+                    .string()
+                    .describe('Column to sort by (e.g., "noteFld", "noteCrt", "cardDue")'),
+            })
+                .optional()
+                .describe('Optional reordering of cards in the browser'),
+        }),
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], GuiBrowseTool.prototype, "guiBrowse", null);
+exports.GuiBrowseTool = GuiBrowseTool = GuiBrowseTool_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [anki_connect_client_1.AnkiConnectClient])
+], GuiBrowseTool);
+//# sourceMappingURL=gui-browse.tool.js.map

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

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

package/dist/mcp/primitives/gui/tools/gui-current-card.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 GuiCurrentCardTool {
+    private readonly ankiClient;
+    private readonly logger;
+    constructor(ankiClient: AnkiConnectClient);
+    guiCurrentCard(_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;
+    }>;
+}