@ankimcp/anki-mcp-server/dist/mcp/primitives/essential/tools/are-suspended.tool.js

Model Context Protocol server for Anki - enables AI assistants to interact with your Anki flashcards

"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 __param = (this && this.__param) || function (paramIndex, decorator) {
    return function (target, key) { decorator(target, key, paramIndex); }
};
var AreSuspendedTool_1;
Object.defineProperty(exports, "__esModule", { value: true });
exports.AreSuspendedTool = exports.areSuspendedInputSchema = void 0;
const common_1 = require("@nestjs/common");
const microservices_1 = require("@nestjs/microservices");
const mcp_nest_1 = require("@rekog/mcp-nest");
const zod_1 = require("zod");
const anki_connect_client_1 = require("../../../clients/anki-connect.client.js");
const anki_utils_1 = require("../../../utils/anki.utils.js");
const card_suspension_utils_1 = require("../../../utils/card-suspension.utils.js");
exports.areSuspendedInputSchema = zod_1.z.object({
    cards: card_suspension_utils_1.cardIdsSchema,
});
let AreSuspendedTool = AreSuspendedTool_1 = class AreSuspendedTool {
    ankiClient;
    logger = new common_1.Logger(AreSuspendedTool_1.name);
    constructor(ankiClient) {
        this.ankiClient = ankiClient;
    }
    async execute(params) {
        const cards = Array.isArray(params?.cards) ? params.cards : [];
        try {
            this.logger.log(`Executing areSuspended: ${cards.length} card(s)`);
            if (cards.length === 0) {
                throw new Error("cards array is required for areSuspended action");
            }
            const statuses = await (0, card_suspension_utils_1.fetchSuspensionStatuses)(cards, this.ankiClient);
            const counts = (0, card_suspension_utils_1.summarizeSuspensionStatuses)(statuses);
            this.logger.log(`areSuspended: ${counts.suspendedCount} suspended, ${counts.unsuspendedCount} not suspended, ${counts.missingCount} missing`);
            return {
                success: true,
                message: `Checked ${counts.total} card(s): ${counts.suspendedCount} suspended, ` +
                    `${counts.unsuspendedCount} not suspended, ${counts.missingCount} missing`,
                cards: statuses,
                ...counts,
            };
        }
        catch (error) {
            this.logger.error("Failed to execute areSuspended", error);
            return (0, anki_utils_1.createErrorResponse)(error, {
                action: "areSuspended",
                cardIds: cards,
                hint: "This can happen when Anki is not running or the card IDs are invalid (note IDs are not card IDs)",
            });
        }
    }
};
exports.AreSuspendedTool = AreSuspendedTool;
__decorate([
    (0, mcp_nest_1.Tool)({
        name: "areSuspended",
        description: "Check whether cards are suspended, without changing anything. Card IDs (not note IDs) — " +
            "use get_cards, get_due_cards, or notesInfo to obtain them. The response preserves input " +
            "order; a card ID that doesn't exist comes back with suspended: null rather than being " +
            "dropped or throwing, so a single bad ID doesn't fail the whole batch.",
        parameters: exports.areSuspendedInputSchema,
        outputSchema: zod_1.z.object({
            success: zod_1.z.boolean(),
            message: zod_1.z.string(),
            cards: zod_1.z
                .array(card_suspension_utils_1.cardSuspensionStatusSchema)
                .describe("Per-card suspension status, in the same order as the input"),
            ...card_suspension_utils_1.suspensionCountsSchema.shape,
        }),
        annotations: {
            title: "Check Suspended Cards",
            readOnlyHint: true,
            destructiveHint: false,
            idempotentHint: true,
            openWorldHint: false,
        },
    }),
    __param(0, (0, microservices_1.Payload)()),
    __metadata("design:type", Function),
    __metadata("design:paramtypes", [Object]),
    __metadata("design:returntype", Promise)
], AreSuspendedTool.prototype, "execute", null);
exports.AreSuspendedTool = AreSuspendedTool = AreSuspendedTool_1 = __decorate([
    (0, mcp_nest_1.McpController)(),
    __metadata("design:paramtypes", [anki_connect_client_1.AnkiConnectClient])
], AreSuspendedTool);
//# sourceMappingURL=are-suspended.tool.js.map