@ankimcp/anki-mcp-server 0.8.0

package/dist/mcp/primitives/essential/tools/list-decks.tool.d.ts

@@ -0,0 +1,83 @@
+import type { Context } from "@rekog/mcp-nest";
+import { AnkiConnectClient } from "@/mcp/clients/anki-connect.client";
+export declare class ListDecksTool {
+    private readonly ankiClient;
+    private readonly logger;
+    constructor(ankiClient: AnkiConnectClient);
+    listDecks({ include_stats }: {
+        include_stats?: boolean;
+    }, 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/essential/tools/list-decks.tool.js

@@ -0,0 +1,117 @@
+"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 ListDecksTool_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ListDecksTool = 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 ListDecksTool = ListDecksTool_1 = class ListDecksTool {
+    ankiClient;
+    logger = new common_1.Logger(ListDecksTool_1.name);
+    constructor(ankiClient) {
+        this.ankiClient = ankiClient;
+    }
+    async listDecks({ include_stats }, context) {
+        try {
+            const includeStats = include_stats || false;
+            this.logger.log(`Listing Anki decks with stats: ${includeStats}`);
+            await context.reportProgress({ progress: 10, total: 100 });
+            const deckNames = await this.ankiClient.invoke("deckNames");
+            if (!deckNames || deckNames.length === 0) {
+                this.logger.log("No decks found");
+                await context.reportProgress({ progress: 100, total: 100 });
+                return (0, anki_utils_1.createSuccessResponse)({
+                    success: true,
+                    message: "No decks found in Anki",
+                    decks: [],
+                });
+            }
+            await context.reportProgress({ progress: 50, total: 100 });
+            let decks;
+            let summary;
+            if (includeStats) {
+                const deckStatsResponse = await this.ankiClient.invoke("getDeckStats", {
+                    decks: deckNames,
+                });
+                const statsArray = Object.values(deckStatsResponse);
+                decks = deckNames.map((name) => {
+                    const stats = statsArray.find((s) => s.name === name);
+                    if (stats) {
+                        return {
+                            name,
+                            stats: {
+                                deck_id: stats.deck_id || 0,
+                                name,
+                                new_count: stats.new_count || 0,
+                                learn_count: stats.learn_count || 0,
+                                review_count: stats.review_count || 0,
+                                total_new: stats.new_count || 0,
+                                total_cards: stats.total_in_deck || 0,
+                            },
+                        };
+                    }
+                    return { name };
+                });
+                summary = decks.reduce((acc, deck) => {
+                    if (deck.stats) {
+                        acc.total_cards += deck.stats.total_cards;
+                        acc.new_cards += deck.stats.new_count;
+                        acc.learning_cards += deck.stats.learn_count;
+                        acc.review_cards += deck.stats.review_count;
+                    }
+                    return acc;
+                }, { total_cards: 0, new_cards: 0, learning_cards: 0, review_cards: 0 });
+            }
+            else {
+                decks = deckNames.map((name) => ({ name }));
+            }
+            await context.reportProgress({ progress: 100, total: 100 });
+            this.logger.log(`Found ${decks.length} decks`);
+            const response = {
+                success: true,
+                decks,
+                total: decks.length,
+            };
+            if (summary) {
+                response.summary = summary;
+            }
+            return (0, anki_utils_1.createSuccessResponse)(response);
+        }
+        catch (error) {
+            this.logger.error("Failed to list decks", error);
+            return (0, anki_utils_1.createErrorResponse)(error);
+        }
+    }
+};
+exports.ListDecksTool = ListDecksTool;
+__decorate([
+    (0, mcp_nest_1.Tool)({
+        name: "list_decks",
+        description: "List all available Anki decks, optionally with statistics. Remember to sync first at the start of a review session for latest data.",
+        parameters: zod_1.z.object({
+            include_stats: zod_1.z
+                .boolean()
+                .default(false)
+                .describe("Include card count statistics for each deck"),
+        }),
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], ListDecksTool.prototype, "listDecks", null);
+exports.ListDecksTool = ListDecksTool = ListDecksTool_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [anki_connect_client_1.AnkiConnectClient])
+], ListDecksTool);
+//# sourceMappingURL=list-decks.tool.js.map

package/dist/mcp/primitives/essential/tools/list-decks.tool.js.map

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

package/dist/mcp/primitives/essential/tools/mediaActions/actions/deleteMediaFile.action.d.ts

@@ -0,0 +1,10 @@
+import { AnkiConnectClient } from "@/mcp/clients/anki-connect.client";
+export interface DeleteMediaFileParams {
+    filename: string;
+}
+export interface DeleteMediaFileResult {
+    success: boolean;
+    filename: string;
+    message: string;
+}
+export declare function deleteMediaFile(params: DeleteMediaFileParams, client: AnkiConnectClient): Promise<DeleteMediaFileResult>;

package/dist/mcp/primitives/essential/tools/mediaActions/actions/deleteMediaFile.action.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deleteMediaFile = deleteMediaFile;
+async function deleteMediaFile(params, client) {
+    const { filename } = params;
+    if (!filename || filename.trim() === "") {
+        throw new Error("Filename cannot be empty");
+    }
+    await client.invoke("deleteMediaFile", {
+        filename,
+    });
+    return {
+        success: true,
+        filename,
+        message: `Successfully deleted media file: ${filename}`,
+    };
+}
+//# sourceMappingURL=deleteMediaFile.action.js.map

package/dist/mcp/primitives/essential/tools/mediaActions/actions/deleteMediaFile.action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deleteMediaFile.action.js","sourceRoot":"","sources":["../../../../../../../src/mcp/primitives/essential/tools/mediaActions/actions/deleteMediaFile.action.ts"],"names":[],"mappings":";;AAsBA,0CAqBC;AArBM,KAAK,UAAU,eAAe,CACnC,MAA6B,EAC7B,MAAyB;IAEzB,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;IAG5B,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC9C,CAAC;IAGD,MAAM,MAAM,CAAC,MAAM,CAAO,iBAAiB,EAAE;QAC3C,QAAQ;KACT,CAAC,CAAC;IAEH,OAAO;QACL,OAAO,EAAE,IAAI;QACb,QAAQ;QACR,OAAO,EAAE,oCAAoC,QAAQ,EAAE;KACxD,CAAC;AACJ,CAAC"}

package/dist/mcp/primitives/essential/tools/mediaActions/actions/getMediaFilesNames.action.d.ts

@@ -0,0 +1,12 @@
+import { AnkiConnectClient } from "@/mcp/clients/anki-connect.client";
+export interface GetMediaFilesNamesParams {
+    pattern?: string;
+}
+export interface GetMediaFilesNamesResult {
+    success: boolean;
+    files: string[];
+    count: number;
+    message: string;
+    pattern?: string;
+}
+export declare function getMediaFilesNames(params: GetMediaFilesNamesParams, client: AnkiConnectClient): Promise<GetMediaFilesNamesResult>;

package/dist/mcp/primitives/essential/tools/mediaActions/actions/getMediaFilesNames.action.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMediaFilesNames = getMediaFilesNames;
+async function getMediaFilesNames(params, client) {
+    const { pattern } = params;
+    const ankiParams = {};
+    if (pattern) {
+        ankiParams.pattern = pattern;
+    }
+    const result = await client.invoke("getMediaFilesNames", ankiParams);
+    const message = pattern
+        ? `Found ${result.length} media file(s) matching pattern "${pattern}"`
+        : `Found ${result.length} media file(s)`;
+    return {
+        success: true,
+        files: result,
+        count: result.length,
+        message,
+        ...(pattern && { pattern }),
+    };
+}
+//# sourceMappingURL=getMediaFilesNames.action.js.map

package/dist/mcp/primitives/essential/tools/mediaActions/actions/getMediaFilesNames.action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getMediaFilesNames.action.js","sourceRoot":"","sources":["../../../../../../../src/mcp/primitives/essential/tools/mediaActions/actions/getMediaFilesNames.action.ts"],"names":[],"mappings":";;AAyBA,gDA6BC;AA7BM,KAAK,UAAU,kBAAkB,CACtC,MAAgC,EAChC,MAAyB;IAEzB,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;IAG3B,MAAM,UAAU,GAAwB,EAAE,CAAC;IAC3C,IAAI,OAAO,EAAE,CAAC;QACZ,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC;IAC/B,CAAC;IAGD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAChC,oBAAoB,EACpB,UAAU,CACX,CAAC;IAEF,MAAM,OAAO,GAAG,OAAO;QACrB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,oCAAoC,OAAO,GAAG;QACtE,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,gBAAgB,CAAC;IAE3C,OAAO;QACL,OAAO,EAAE,IAAI;QACb,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,MAAM,CAAC,MAAM;QACpB,OAAO;QACP,GAAG,CAAC,OAAO,IAAI,EAAE,OAAO,EAAE,CAAC;KAC5B,CAAC;AACJ,CAAC"}

package/dist/mcp/primitives/essential/tools/mediaActions/actions/retrieveMediaFile.action.d.ts

@@ -0,0 +1,12 @@
+import { AnkiConnectClient } from "@/mcp/clients/anki-connect.client";
+export interface RetrieveMediaFileParams {
+    filename: string;
+}
+export interface RetrieveMediaFileResult {
+    success: boolean;
+    filename: string;
+    data: string | null;
+    message: string;
+    found: boolean;
+}
+export declare function retrieveMediaFile(params: RetrieveMediaFileParams, client: AnkiConnectClient): Promise<RetrieveMediaFileResult>;

package/dist/mcp/primitives/essential/tools/mediaActions/actions/retrieveMediaFile.action.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.retrieveMediaFile = retrieveMediaFile;
+async function retrieveMediaFile(params, client) {
+    const { filename } = params;
+    if (!filename || filename.trim() === "") {
+        throw new Error("Filename cannot be empty");
+    }
+    const result = await client.invoke("retrieveMediaFile", {
+        filename,
+    });
+    if (result === false) {
+        return {
+            success: true,
+            filename,
+            data: null,
+            message: `Media file not found: ${filename}`,
+            found: false,
+        };
+    }
+    return {
+        success: true,
+        filename,
+        data: result,
+        message: `Successfully retrieved media file: ${filename}`,
+        found: true,
+    };
+}
+//# sourceMappingURL=retrieveMediaFile.action.js.map

package/dist/mcp/primitives/essential/tools/mediaActions/actions/retrieveMediaFile.action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieveMediaFile.action.js","sourceRoot":"","sources":["../../../../../../../src/mcp/primitives/essential/tools/mediaActions/actions/retrieveMediaFile.action.ts"],"names":[],"mappings":";;AAyBA,8CAkCC;AAlCM,KAAK,UAAU,iBAAiB,CACrC,MAA+B,EAC/B,MAAyB;IAEzB,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;IAG5B,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC9C,CAAC;IAGD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAiB,mBAAmB,EAAE;QACtE,QAAQ;KACT,CAAC,CAAC;IAGH,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;QACrB,OAAO;YACL,OAAO,EAAE,IAAI;YACb,QAAQ;YACR,IAAI,EAAE,IAAI;YACV,OAAO,EAAE,yBAAyB,QAAQ,EAAE;YAC5C,KAAK,EAAE,KAAK;SACb,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,IAAI;QACb,QAAQ;QACR,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,sCAAsC,QAAQ,EAAE;QACzD,KAAK,EAAE,IAAI;KACZ,CAAC;AACJ,CAAC"}

package/dist/mcp/primitives/essential/tools/mediaActions/actions/storeMediaFile.action.d.ts

@@ -0,0 +1,15 @@
+import { AnkiConnectClient } from "@/mcp/clients/anki-connect.client";
+export interface StoreMediaFileParams {
+    filename: string;
+    data?: string;
+    path?: string;
+    url?: string;
+    deleteExisting?: boolean;
+}
+export interface StoreMediaFileResult {
+    success: boolean;
+    filename: string;
+    message: string;
+    prefixedWithUnderscore: boolean;
+}
+export declare function storeMediaFile(params: StoreMediaFileParams, client: AnkiConnectClient): Promise<StoreMediaFileResult>;

package/dist/mcp/primitives/essential/tools/mediaActions/actions/storeMediaFile.action.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.storeMediaFile = storeMediaFile;
+async function storeMediaFile(params, client) {
+    const { filename, data, path, url, deleteExisting = true } = params;
+    if (!data && !path && !url) {
+        throw new Error("Must provide either data, path, or url parameter");
+    }
+    const sources = [data, path, url].filter(Boolean);
+    if (sources.length > 1) {
+        throw new Error("Cannot provide multiple sources (data, path, url). Choose one.");
+    }
+    if (!filename || filename.trim() === "") {
+        throw new Error("Filename cannot be empty");
+    }
+    const prefixedWithUnderscore = filename.startsWith("_");
+    const ankiParams = {
+        filename,
+        deleteExisting,
+    };
+    if (data) {
+        ankiParams.data = data;
+    }
+    else if (path) {
+        ankiParams.path = path;
+    }
+    else if (url) {
+        ankiParams.url = url;
+    }
+    const result = await client.invoke("storeMediaFile", ankiParams);
+    if (!result) {
+        throw new Error("Failed to store media file");
+    }
+    return {
+        success: true,
+        filename: result,
+        message: `Successfully stored media file: ${result}`,
+        prefixedWithUnderscore,
+    };
+}
+//# sourceMappingURL=storeMediaFile.action.js.map

package/dist/mcp/primitives/essential/tools/mediaActions/actions/storeMediaFile.action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storeMediaFile.action.js","sourceRoot":"","sources":["../../../../../../../src/mcp/primitives/essential/tools/mediaActions/actions/storeMediaFile.action.ts"],"names":[],"mappings":";;AAoCA,wCAuDC;AAvDM,KAAK,UAAU,cAAc,CAClC,MAA4B,EAC5B,MAAyB;IAEzB,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;IAGpE,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IAGD,MAAM,OAAO,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAClD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,gEAAgE,CACjE,CAAC;IACJ,CAAC;IAGD,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC9C,CAAC;IAGD,MAAM,sBAAsB,GAAG,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAGxD,MAAM,UAAU,GAAwB;QACtC,QAAQ;QACR,cAAc;KACf,CAAC;IAEF,IAAI,IAAI,EAAE,CAAC;QACT,UAAU,CAAC,IAAI,GAAG,IAAI,CAAC;IACzB,CAAC;SAAM,IAAI,IAAI,EAAE,CAAC;QAChB,UAAU,CAAC,IAAI,GAAG,IAAI,CAAC;IACzB,CAAC;SAAM,IAAI,GAAG,EAAE,CAAC;QACf,UAAU,CAAC,GAAG,GAAG,GAAG,CAAC;IACvB,CAAC;IAGD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAS,gBAAgB,EAAE,UAAU,CAAC,CAAC;IAGzE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAChD,CAAC;IAED,OAAO;QACL,OAAO,EAAE,IAAI;QACb,QAAQ,EAAE,MAAM;QAChB,OAAO,EAAE,mCAAmC,MAAM,EAAE;QACpD,sBAAsB;KACvB,CAAC;AACJ,CAAC"}

package/dist/mcp/primitives/essential/tools/mediaActions/index.d.ts

@@ -0,0 +1,5 @@
+export { MediaActionsTool } from "./mediaActions.tool";
+export type { StoreMediaFileParams, StoreMediaFileResult, } from "./actions/storeMediaFile.action";
+export type { RetrieveMediaFileParams, RetrieveMediaFileResult, } from "./actions/retrieveMediaFile.action";
+export type { GetMediaFilesNamesParams, GetMediaFilesNamesResult, } from "./actions/getMediaFilesNames.action";
+export type { DeleteMediaFileParams, DeleteMediaFileResult, } from "./actions/deleteMediaFile.action";

package/dist/mcp/primitives/essential/tools/mediaActions/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MediaActionsTool = void 0;
+var mediaActions_tool_1 = require("./mediaActions.tool");
+Object.defineProperty(exports, "MediaActionsTool", { enumerable: true, get: function () { return mediaActions_tool_1.MediaActionsTool; } });
+//# sourceMappingURL=index.js.map

package/dist/mcp/primitives/essential/tools/mediaActions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/mcp/primitives/essential/tools/mediaActions/index.ts"],"names":[],"mappings":";;;AAIA,yDAAuD;AAA9C,qHAAA,gBAAgB,OAAA"}

package/dist/mcp/primitives/essential/tools/mediaActions/mediaActions.tool.d.ts

@@ -0,0 +1,89 @@
+import type { Context } from "@rekog/mcp-nest";
+import { AnkiConnectClient } from "@/mcp/clients/anki-connect.client";
+export declare class MediaActionsTool {
+    private readonly ankiClient;
+    private readonly logger;
+    constructor(ankiClient: AnkiConnectClient);
+    execute(params: {
+        action: "storeMediaFile" | "retrieveMediaFile" | "getMediaFilesNames" | "deleteMediaFile";
+        filename?: string;
+        data?: string;
+        path?: string;
+        url?: string;
+        deleteExisting?: boolean;
+        pattern?: 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/essential/tools/mediaActions/mediaActions.tool.js

@@ -0,0 +1,141 @@
+"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 MediaActionsTool_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MediaActionsTool = 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");
+const storeMediaFile_action_1 = require("./actions/storeMediaFile.action");
+const retrieveMediaFile_action_1 = require("./actions/retrieveMediaFile.action");
+const getMediaFilesNames_action_1 = require("./actions/getMediaFilesNames.action");
+const deleteMediaFile_action_1 = require("./actions/deleteMediaFile.action");
+let MediaActionsTool = MediaActionsTool_1 = class MediaActionsTool {
+    ankiClient;
+    logger = new common_1.Logger(MediaActionsTool_1.name);
+    constructor(ankiClient) {
+        this.ankiClient = ankiClient;
+    }
+    async execute(params, context) {
+        try {
+            this.logger.log(`Executing media action: ${params.action}`);
+            let result;
+            switch (params.action) {
+                case "storeMediaFile":
+                    if (!params.filename) {
+                        throw new Error("filename is required for storeMediaFile action");
+                    }
+                    await context.reportProgress({ progress: 25, total: 100 });
+                    result = await (0, storeMediaFile_action_1.storeMediaFile)({
+                        filename: params.filename,
+                        data: params.data,
+                        path: params.path,
+                        url: params.url,
+                        deleteExisting: params.deleteExisting,
+                    }, this.ankiClient);
+                    await context.reportProgress({ progress: 100, total: 100 });
+                    break;
+                case "retrieveMediaFile":
+                    if (!params.filename) {
+                        throw new Error("filename is required for retrieveMediaFile action");
+                    }
+                    await context.reportProgress({ progress: 50, total: 100 });
+                    result = await (0, retrieveMediaFile_action_1.retrieveMediaFile)({ filename: params.filename }, this.ankiClient);
+                    await context.reportProgress({ progress: 100, total: 100 });
+                    break;
+                case "getMediaFilesNames":
+                    await context.reportProgress({ progress: 50, total: 100 });
+                    result = await (0, getMediaFilesNames_action_1.getMediaFilesNames)({ pattern: params.pattern }, this.ankiClient);
+                    await context.reportProgress({ progress: 100, total: 100 });
+                    break;
+                case "deleteMediaFile":
+                    if (!params.filename) {
+                        throw new Error("filename is required for deleteMediaFile action");
+                    }
+                    await context.reportProgress({ progress: 50, total: 100 });
+                    result = await (0, deleteMediaFile_action_1.deleteMediaFile)({ filename: params.filename }, this.ankiClient);
+                    await context.reportProgress({ progress: 100, total: 100 });
+                    break;
+                default: {
+                    const _exhaustive = params.action;
+                    throw new Error(`Unknown action: ${_exhaustive}`);
+                }
+            }
+            this.logger.log(`Successfully executed ${params.action}`);
+            return (0, anki_utils_1.createSuccessResponse)(result);
+        }
+        catch (error) {
+            this.logger.error(`Failed to execute ${params.action}`, error);
+            return (0, anki_utils_1.createErrorResponse)(error, {
+                action: params.action,
+                hint: "Make sure Anki is running and the media file/path is valid",
+            });
+        }
+    }
+};
+exports.MediaActionsTool = MediaActionsTool;
+__decorate([
+    (0, mcp_nest_1.Tool)({
+        name: "mediaActions",
+        description: `Manage Anki media files (audio/images). Supports four actions:
+- storeMediaFile: Upload media to Anki (supports base64 data, file paths, or URLs)
+- retrieveMediaFile: Download media from Anki as base64
+- getMediaFilesNames: List media files (optionally filter by pattern)
+- deleteMediaFile: Remove media file from Anki
+
+Perfect for workflows like ElevenLabs TTS → Anki audio flashcards.`,
+        parameters: zod_1.z.object({
+            action: zod_1.z
+                .enum([
+                "storeMediaFile",
+                "retrieveMediaFile",
+                "getMediaFilesNames",
+                "deleteMediaFile",
+            ])
+                .describe("The media action to perform"),
+            filename: zod_1.z
+                .string()
+                .optional()
+                .describe("Filename (required for storeMediaFile, retrieveMediaFile, deleteMediaFile)"),
+            data: zod_1.z
+                .string()
+                .optional()
+                .describe("[storeMediaFile only] Base64-encoded file content"),
+            path: zod_1.z
+                .string()
+                .optional()
+                .describe("[storeMediaFile only] Absolute file path"),
+            url: zod_1.z
+                .string()
+                .optional()
+                .describe("[storeMediaFile only] URL to download file from"),
+            deleteExisting: zod_1.z
+                .boolean()
+                .optional()
+                .default(true)
+                .describe("[storeMediaFile only] Overwrite existing file (default: true)"),
+            pattern: zod_1.z
+                .string()
+                .optional()
+                .describe('[getMediaFilesNames only] Filter pattern (e.g., "*.mp3")'),
+        }),
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], MediaActionsTool.prototype, "execute", null);
+exports.MediaActionsTool = MediaActionsTool = MediaActionsTool_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [anki_connect_client_1.AnkiConnectClient])
+], MediaActionsTool);
+//# sourceMappingURL=mediaActions.tool.js.map

package/dist/mcp/primitives/essential/tools/mediaActions/mediaActions.tool.js.map

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