anki-mcp-http 0.12.1 → 0.13.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "anki-mcp-http",
-  "version": "0.12.1",
+  "version": "0.13.0",
   "description": "Model Context Protocol server for Anki - enables AI assistants to interact with your Anki flashcards",
   "author": "Anatoly Tarnavsky",
   "private": false,
@@ -50,60 +50,60 @@
     "prepare": "husky"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.25.2",
-    "@nestjs/common": "^11.1.11",
+    "@modelcontextprotocol/sdk": "^1.25.3",
+    "@nestjs/common": "^11.1.12",
     "@nestjs/config": "^4.0.2",
-    "@nestjs/core": "^11.1.11",
+    "@nestjs/core": "^11.1.12",
     "@nestjs/jwt": "^11.0.2",
     "@nestjs/passport": "^11.0.5",
-    "@nestjs/platform-express": "^11.1.11",
-    "@rekog/mcp-nest": "^1.9.2",
-    "commander": "^14.0.1",
+    "@nestjs/platform-express": "^11.1.12",
+    "@rekog/mcp-nest": "^1.9.3",
+    "commander": "^14.0.3",
     "jsonwebtoken": "^9.0.3",
-    "ky": "^1.14.2",
+    "ky": "^1.14.3",
     "passport": "^0.7.0",
     "passport-jwt": "^4.0.1",
-    "pino": "^10.1.1",
+    "pino": "^10.3.0",
     "pino-pretty": "^13.1.3",
     "reflect-metadata": "^0.2.2",
     "remark-parse": "^11.0.0",
     "rxjs": "^7.8.2",
     "unified": "^11.0.5",
-    "unist-util-visit": "^5.0.0",
+    "unist-util-visit": "^5.1.0",
     "update-notifier": "^7.3.1",
-    "zod": "^4.3.5",
+    "zod": "^4.3.6",
     "zod-to-json-schema": "^3.25.1"
   },
   "devDependencies": {
     "@anthropic-ai/mcpb": "^2.1.2",
     "@eslint/eslintrc": "^3.3.3",
     "@eslint/js": "^9.39.2",
-    "@modelcontextprotocol/inspector": "^0.18.0",
-    "@nestjs/cli": "^11.0.14",
-    "@nestjs/schematics": "^11.0.7",
-    "@nestjs/testing": "^11.1.11",
+    "@modelcontextprotocol/inspector": "^0.19.0",
+    "@nestjs/cli": "^11.0.16",
+    "@nestjs/schematics": "^11.0.9",
+    "@nestjs/testing": "^11.1.12",
     "@types/express": "^5.0.6",
     "@types/jest": "^30.0.0",
     "@types/jsonwebtoken": "^9.0.10",
     "@types/mdast": "^4.0.4",
-    "@types/node": "^25.0.6",
+    "@types/node": "^25.2.0",
     "@types/supertest": "^6.0.3",
     "@types/update-notifier": "^6.0.8",
     "eslint": "^9.39.2",
     "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-prettier": "^5.5.4",
-    "globals": "^17.0.0",
+    "eslint-plugin-prettier": "^5.5.5",
+    "globals": "^17.3.0",
     "husky": "^9.1.7",
-    "jest": "^30.1.3",
-    "prettier": "^3.7.4",
+    "jest": "^30.2.0",
+    "prettier": "^3.8.1",
     "source-map-support": "^0.5.21",
     "supertest": "^7.2.2",
     "ts-jest": "^29.4.6",
     "ts-loader": "^9.5.4",
     "ts-node": "^10.9.2",
     "tsconfig-paths": "^4.2.0",
-    "typescript": "^5.9.2",
-    "typescript-eslint": "^8.53.0"
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.54.0"
   },
   "jest": {
     "moduleFileExtensions": [
@@ -152,7 +152,7 @@
     "forceExit": true
   },
   "engines": {
-    "node": ">=20.19.0"
+    "node": ">=20.19.0 <21.0.0 || >=22.12.0"
   },
   "repository": {
     "type": "git",

package/dist/mcp/primitives/essential/tools/create-deck.tool.d.ts

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

package/dist/mcp/primitives/essential/tools/create-deck.tool.js

@@ -1,121 +0,0 @@
-"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 CreateDeckTool_1;
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CreateDeckTool = 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 CreateDeckTool = CreateDeckTool_1 = class CreateDeckTool {
-    ankiClient;
-    logger = new common_1.Logger(CreateDeckTool_1.name);
-    constructor(ankiClient) {
-        this.ankiClient = ankiClient;
-    }
-    async createDeck({ deck_name }, context) {
-        try {
-            const parts = deck_name.split("::");
-            if (parts.length > 2) {
-                return (0, anki_utils_1.createErrorResponse)(new Error("Deck name can have maximum 2 levels (parent::child)"), {
-                    deckName: deck_name,
-                    levels: parts.length,
-                    maxLevels: 2,
-                });
-            }
-            if (parts.some((part) => part.trim() === "")) {
-                return (0, anki_utils_1.createErrorResponse)(new Error("Deck name parts cannot be empty"), { deckName: deck_name });
-            }
-            this.logger.log(`Creating deck: ${deck_name}`);
-            await context.reportProgress({ progress: 25, total: 100 });
-            const deckId = await this.ankiClient.invoke("createDeck", {
-                deck: deck_name,
-            });
-            await context.reportProgress({ progress: 75, total: 100 });
-            if (!deckId) {
-                this.logger.warn(`Deck may already exist: ${deck_name}`);
-                const existingDecks = await this.ankiClient.invoke("deckNames");
-                const deckExists = existingDecks.includes(deck_name);
-                await context.reportProgress({ progress: 100, total: 100 });
-                if (deckExists) {
-                    return (0, anki_utils_1.createSuccessResponse)({
-                        success: true,
-                        message: `Deck "${deck_name}" already exists`,
-                        deckName: deck_name,
-                        created: false,
-                        exists: true,
-                    });
-                }
-                return (0, anki_utils_1.createErrorResponse)(new Error("Failed to create deck - unknown error"), { deckName: deck_name });
-            }
-            await context.reportProgress({ progress: 100, total: 100 });
-            this.logger.log(`Successfully created deck: ${deck_name} with ID: ${deckId}`);
-            const response = {
-                success: true,
-                deckId: deckId,
-                deckName: deck_name,
-                message: `Successfully created deck "${deck_name}"`,
-                created: true,
-            };
-            if (parts.length === 2) {
-                response.parentDeck = parts[0];
-                response.childDeck = parts[1];
-                response.message = `Successfully created parent deck "${parts[0]}" and child deck "${parts[1]}"`;
-            }
-            return (0, anki_utils_1.createSuccessResponse)(response);
-        }
-        catch (error) {
-            this.logger.error(`Failed to create deck ${deck_name}`, error);
-            if (error instanceof Error && error.message.includes("already exists")) {
-                return (0, anki_utils_1.createSuccessResponse)({
-                    success: true,
-                    message: `Deck "${deck_name}" already exists`,
-                    deckName: deck_name,
-                    created: false,
-                    exists: true,
-                });
-            }
-            return (0, anki_utils_1.createErrorResponse)(error, {
-                deckName: deck_name,
-                hint: "Make sure Anki is running and the deck name is valid",
-            });
-        }
-    }
-};
-exports.CreateDeckTool = CreateDeckTool;
-__decorate([
-    (0, mcp_nest_1.Tool)({
-        name: "create_deck",
-        description: 'Create a new empty Anki deck. Supports parent::child structure (e.g., "Japanese::Tokyo" creates parent deck "Japanese" and child deck "Tokyo"). Maximum 2 levels of nesting allowed. Will not overwrite existing decks. ' +
-            "IMPORTANT: This tool ONLY creates an empty deck. DO NOT add cards or notes after creating a deck unless the user EXPLICITLY asks to add them. Wait for user instructions before adding any content.",
-        parameters: zod_1.z.object({
-            deck_name: zod_1.z
-                .string()
-                .min(1)
-                .describe('The name of the deck to create. Use "::" for parent::child structure (max 2 levels)')
-                .refine((name) => {
-                const parts = name.split("::");
-                return parts.length <= 2;
-            }, {
-                message: "Deck name can have maximum 2 levels (parent::child). More than 2 levels not permitted.",
-            }),
-        }),
-    }),
-    __metadata("design:type", Function),
-    __metadata("design:paramtypes", [Object, Object]),
-    __metadata("design:returntype", Promise)
-], CreateDeckTool.prototype, "createDeck", null);
-exports.CreateDeckTool = CreateDeckTool = CreateDeckTool_1 = __decorate([
-    (0, common_1.Injectable)(),
-    __metadata("design:paramtypes", [anki_connect_client_1.AnkiConnectClient])
-], CreateDeckTool);
-//# sourceMappingURL=create-deck.tool.js.map

package/dist/mcp/primitives/essential/tools/create-deck.tool.js.map

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

package/dist/mcp/primitives/essential/tools/deck-stats/deck-stats.tool.js

@@ -1,165 +0,0 @@
-"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 DeckStatsTool_1;
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DeckStatsTool = 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 stats_utils_1 = require("../../../../utils/stats.utils");
-let DeckStatsTool = DeckStatsTool_1 = class DeckStatsTool {
-    ankiClient;
-    logger = new common_1.Logger(DeckStatsTool_1.name);
-    constructor(ankiClient) {
-        this.ankiClient = ankiClient;
-    }
-    async execute(params, context) {
-        try {
-            const { deck, ease_buckets = [2.0, 2.5, 3.0], interval_buckets = [7, 21, 90], } = params;
-            this.logger.log(`Getting statistics for deck: ${deck}`);
-            await context.reportProgress({ progress: 10, total: 100 });
-            this.logger.log("Fetching deck statistics...");
-            const deckStatsResponse = await this.ankiClient.invoke("getDeckStats", {
-                decks: [deck],
-            });
-            if (!deckStatsResponse || Object.keys(deckStatsResponse).length === 0) {
-                throw new Error(`Deck "${deck}" not found`);
-            }
-            const deckStatsArray = Object.values(deckStatsResponse);
-            const deckStats = deckStatsArray.find((s) => s.name === deck);
-            if (!deckStats) {
-                throw new Error(`Deck "${deck}" not found in statistics response`);
-            }
-            const counts = {
-                total: deckStats.total_in_deck || 0,
-                new: deckStats.new_count || 0,
-                learning: deckStats.learn_count || 0,
-                review: deckStats.review_count || 0,
-            };
-            await context.reportProgress({ progress: 30, total: 100 });
-            if (counts.total === 0) {
-                this.logger.log(`Deck "${deck}" is empty`);
-                const result = {
-                    deck,
-                    counts,
-                    ease: (0, stats_utils_1.computeDistribution)([], { boundaries: ease_buckets }),
-                    intervals: (0, stats_utils_1.computeDistribution)([], {
-                        boundaries: interval_buckets,
-                        unitSuffix: "d",
-                    }),
-                };
-                await context.reportProgress({ progress: 100, total: 100 });
-                return (0, anki_utils_1.createSuccessResponse)(result);
-            }
-            this.logger.log("Finding cards in deck...");
-            const escapedDeckName = deck.replace(/"/g, '\\"');
-            const cardIds = await this.ankiClient.invoke("findCards", {
-                query: `"deck:${escapedDeckName}"`,
-            });
-            if (!cardIds || cardIds.length === 0) {
-                this.logger.warn(`No cards found via findCards for deck "${deck}", using counts from getDeckStats`);
-                const result = {
-                    deck,
-                    counts,
-                    ease: (0, stats_utils_1.computeDistribution)([], { boundaries: ease_buckets }),
-                    intervals: (0, stats_utils_1.computeDistribution)([], {
-                        boundaries: interval_buckets,
-                        unitSuffix: "d",
-                    }),
-                };
-                await context.reportProgress({ progress: 100, total: 100 });
-                return (0, anki_utils_1.createSuccessResponse)(result);
-            }
-            await context.reportProgress({ progress: 50, total: 100 });
-            this.logger.log(`Fetching ease factors for ${cardIds.length} cards...`);
-            const easeFactorsRaw = await this.ankiClient.invoke("getEaseFactors", {
-                cards: cardIds,
-            });
-            const easeValues = easeFactorsRaw
-                .map((e) => e / 1000)
-                .filter((e) => e > 0);
-            await context.reportProgress({ progress: 70, total: 100 });
-            this.logger.log(`Fetching intervals for ${cardIds.length} cards...`);
-            const intervalsRaw = await this.ankiClient.invoke("getIntervals", {
-                cards: cardIds,
-            });
-            const intervalValues = intervalsRaw.filter((i) => i > 0);
-            await context.reportProgress({ progress: 90, total: 100 });
-            this.logger.log("Computing distributions...");
-            const ease = (0, stats_utils_1.computeDistribution)(easeValues, {
-                boundaries: ease_buckets,
-            });
-            const intervals = (0, stats_utils_1.computeDistribution)(intervalValues, {
-                boundaries: interval_buckets,
-                unitSuffix: "d",
-            });
-            const result = {
-                deck,
-                counts,
-                ease,
-                intervals,
-            };
-            await context.reportProgress({ progress: 100, total: 100 });
-            this.logger.log(`Successfully retrieved statistics for deck "${deck}": ${counts.total} total cards, ` +
-                `${ease.count} cards with ease values, ${intervals.count} review cards`);
-            return (0, anki_utils_1.createSuccessResponse)(result);
-        }
-        catch (error) {
-            this.logger.error(`Failed to get deck statistics`, error);
-            return (0, anki_utils_1.createErrorResponse)(error, {
-                hint: "Make sure Anki is running and the deck name is correct. Use list_decks to see available decks.",
-            });
-        }
-    }
-};
-exports.DeckStatsTool = DeckStatsTool;
-__decorate([
-    (0, mcp_nest_1.Tool)({
-        name: "deck_stats",
-        description: "Get comprehensive statistics for a single deck including card counts, ease factor distribution, and interval distribution. " +
-            "Use this to analyze deck health, identify struggling cards (low ease), or understand review scheduling patterns. " +
-            "Ease buckets and interval buckets can be customized to focus on specific ranges.",
-        parameters: zod_1.z.object({
-            deck: zod_1.z
-                .string()
-                .min(1)
-                .describe("Deck name to get statistics for (e.g., 'Japanese::JLPT N5')"),
-            ease_buckets: zod_1.z
-                .array(zod_1.z.number().positive())
-                .optional()
-                .default([2.0, 2.5, 3.0])
-                .refine((arr) => arr.length === 0 || arr.every((v, i, a) => i === 0 || v > a[i - 1]), {
-                message: "Bucket boundaries must be in ascending order",
-            })
-                .describe("Bucket boundaries for ease factor distribution. Default: [2.0, 2.5, 3.0]. " +
-                "Example: [2.0, 2.5, 3.0] creates buckets: <2.0, 2.0-2.5, 2.5-3.0, >3.0"),
-            interval_buckets: zod_1.z
-                .array(zod_1.z.number().positive())
-                .optional()
-                .default([7, 21, 90])
-                .refine((arr) => arr.length === 0 || arr.every((v, i, a) => i === 0 || v > a[i - 1]), {
-                message: "Bucket boundaries must be in ascending order",
-            })
-                .describe("Bucket boundaries for interval distribution in days. Default: [7, 21, 90]. " +
-                "Example: [7, 21, 90] creates buckets: <7d, 7-21d, 21-90d, >90d"),
-        }),
-    }),
-    __metadata("design:type", Function),
-    __metadata("design:paramtypes", [Object, Object]),
-    __metadata("design:returntype", Promise)
-], DeckStatsTool.prototype, "execute", null);
-exports.DeckStatsTool = DeckStatsTool = DeckStatsTool_1 = __decorate([
-    (0, common_1.Injectable)(),
-    __metadata("design:paramtypes", [anki_connect_client_1.AnkiConnectClient])
-], DeckStatsTool);
-//# sourceMappingURL=deck-stats.tool.js.map

package/dist/mcp/primitives/essential/tools/deck-stats/deck-stats.tool.js.map

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

package/dist/mcp/primitives/essential/tools/deck-stats/deck-stats.types.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=deck-stats.types.js.map

package/dist/mcp/primitives/essential/tools/deck-stats/deck-stats.types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"deck-stats.types.js","sourceRoot":"","sources":["../../../../../../src/mcp/primitives/essential/tools/deck-stats/deck-stats.types.ts"],"names":[],"mappings":""}

package/dist/mcp/primitives/essential/tools/deck-stats/index.d.ts

@@ -1,2 +0,0 @@
-export { DeckStatsTool } from "./deck-stats.tool";
-export type { DeckStatsParams, DeckStatsResult } from "./deck-stats.types";

package/dist/mcp/primitives/essential/tools/deck-stats/index.js

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

package/dist/mcp/primitives/essential/tools/deck-stats/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/mcp/primitives/essential/tools/deck-stats/index.ts"],"names":[],"mappings":";;;AAAA,qDAAkD;AAAzC,gHAAA,aAAa,OAAA"}

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

@@ -1,105 +0,0 @@
-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: ({
-            type: "text";
-            text: string;
-            annotations?: {
-                audience?: ("user" | "assistant")[] | undefined;
-                priority?: number | undefined;
-                lastModified?: string | undefined;
-            } | undefined;
-            _meta?: {
-                [x: string]: unknown;
-            } | undefined;
-        } | {
-            type: "image";
-            data: string;
-            mimeType: string;
-            annotations?: {
-                audience?: ("user" | "assistant")[] | undefined;
-                priority?: number | undefined;
-                lastModified?: string | undefined;
-            } | undefined;
-            _meta?: {
-                [x: string]: unknown;
-            } | undefined;
-        } | {
-            type: "audio";
-            data: string;
-            mimeType: string;
-            annotations?: {
-                audience?: ("user" | "assistant")[] | undefined;
-                priority?: number | undefined;
-                lastModified?: string | undefined;
-            } | undefined;
-            _meta?: {
-                [x: string]: unknown;
-            } | undefined;
-        } | {
-            uri: string;
-            name: string;
-            type: "resource_link";
-            description?: string | undefined;
-            mimeType?: string | undefined;
-            annotations?: {
-                audience?: ("user" | "assistant")[] | undefined;
-                priority?: number | undefined;
-                lastModified?: string | undefined;
-            } | undefined;
-            _meta?: {
-                [x: string]: unknown;
-            } | undefined;
-            icons?: {
-                src: string;
-                mimeType?: string | undefined;
-                sizes?: string[] | undefined;
-                theme?: "light" | "dark" | undefined;
-            }[] | undefined;
-            title?: string | undefined;
-        } | {
-            type: "resource";
-            resource: {
-                uri: string;
-                text: string;
-                mimeType?: string | undefined;
-                _meta?: {
-                    [x: string]: unknown;
-                } | undefined;
-            } | {
-                uri: string;
-                blob: string;
-                mimeType?: string | undefined;
-                _meta?: {
-                    [x: string]: unknown;
-                } | undefined;
-            };
-            annotations?: {
-                audience?: ("user" | "assistant")[] | undefined;
-                priority?: number | undefined;
-                lastModified?: string | undefined;
-            } | undefined;
-            _meta?: {
-                [x: string]: unknown;
-            } | undefined;
-        })[];
-        _meta?: {
-            [x: string]: unknown;
-            progressToken?: string | number | undefined;
-            "io.modelcontextprotocol/related-task"?: {
-                taskId: string;
-            } | undefined;
-        } | undefined;
-        structuredContent?: {
-            [x: string]: unknown;
-        } | undefined;
-        isError?: boolean | undefined;
-    }>;
-}