@ankimcp/anki-mcp-server 0.18.0 → 0.18.4-tunnel

package/dist/config/config.factory.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildConfigInput = buildConfigInput;
+exports.loadValidatedConfig = loadValidatedConfig;
+const config_schema_1 = require("./config.schema");
+function buildConfigInput(cliOverrides = {}) {
+    const input = { ...process.env };
+    if (cliOverrides.port !== undefined) {
+        input.PORT = String(cliOverrides.port);
+    }
+    if (cliOverrides.host !== undefined) {
+        input.HOST = cliOverrides.host;
+    }
+    if (cliOverrides.ankiConnect !== undefined) {
+        input.ANKI_CONNECT_URL = cliOverrides.ankiConnect;
+    }
+    if (cliOverrides.readOnly !== undefined) {
+        input.READ_ONLY = cliOverrides.readOnly ? "true" : "false";
+    }
+    if (typeof cliOverrides.tunnel === "string") {
+        input.TUNNEL_SERVER_URL = cliOverrides.tunnel;
+    }
+    if (cliOverrides.debug) {
+        input.LOG_LEVEL = "debug";
+    }
+    return input;
+}
+function loadValidatedConfig(cliOverrides = {}) {
+    const input = buildConfigInput(cliOverrides);
+    return config_schema_1.configSchema.parse((0, config_schema_1.transformEnvToConfig)(input));
+}
+//# sourceMappingURL=config.factory.js.map

package/dist/config/config.factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.factory.js","sourceRoot":"","sources":["../../src/config/config.factory.ts"],"names":[],"mappings":";;AA8BA,4CAwBC;AAMD,kDAKC;AAjED,mDAAgF;AA8BhF,SAAgB,gBAAgB,CAAC,eAA6B,EAAE;IAE9D,MAAM,KAAK,GAAgB,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAE9C,IAAI,YAAY,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACpC,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,YAAY,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACpC,KAAK,CAAC,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC;IACjC,CAAC;IACD,IAAI,YAAY,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QAC3C,KAAK,CAAC,gBAAgB,GAAG,YAAY,CAAC,WAAW,CAAC;IACpD,CAAC;IACD,IAAI,YAAY,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACxC,KAAK,CAAC,SAAS,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;IAC7D,CAAC;IACD,IAAI,OAAO,YAAY,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC5C,KAAK,CAAC,iBAAiB,GAAG,YAAY,CAAC,MAAM,CAAC;IAChD,CAAC;IACD,IAAI,YAAY,CAAC,KAAK,EAAE,CAAC;QACvB,KAAK,CAAC,SAAS,GAAG,OAAO,CAAC;IAC5B,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAMD,SAAgB,mBAAmB,CACjC,eAA6B,EAAE;IAE/B,MAAM,KAAK,GAAG,gBAAgB,CAAC,YAAY,CAAC,CAAC;IAC7C,OAAO,4BAAY,CAAC,KAAK,CAAC,IAAA,oCAAoB,EAAC,KAAK,CAAC,CAAC,CAAC;AACzD,CAAC"}

package/dist/config/config.schema.d.ts

@@ -0,0 +1,33 @@
+import { z } from "zod";
+export declare const configSchema: z.ZodObject<{
+    port: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    host: z.ZodDefault<z.ZodString>;
+    nodeEnv: z.ZodDefault<z.ZodEnum<{
+        development: "development";
+        production: "production";
+        test: "test";
+    }>>;
+    ankiConnect: z.ZodObject<{
+        url: z.ZodDefault<z.ZodString>;
+        apiKey: z.ZodOptional<z.ZodString>;
+        apiVersion: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+        timeout: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    }, z.core.$strip>;
+    auth: z.ZodObject<{
+        url: z.ZodDefault<z.ZodString>;
+        realm: z.ZodDefault<z.ZodString>;
+        clientId: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>;
+    tunnel: z.ZodObject<{
+        serverUrl: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>;
+    readOnly: z.ZodDefault<z.ZodPipe<z.ZodTransform<{} | null, unknown>, z.ZodBoolean>>;
+    logLevel: z.ZodDefault<z.ZodEnum<{
+        error: "error";
+        debug: "debug";
+        info: "info";
+        warn: "warn";
+    }>>;
+}, z.core.$strip>;
+export type AppConfig = z.infer<typeof configSchema>;
+export declare function transformEnvToConfig(env: Record<string, any>): any;

package/dist/config/config.schema.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configSchema = void 0;
+exports.transformEnvToConfig = transformEnvToConfig;
+const zod_1 = require("zod");
+exports.configSchema = zod_1.z.object({
+    port: zod_1.z.coerce.number().int().positive().default(3000),
+    host: zod_1.z.string().default("127.0.0.1"),
+    nodeEnv: zod_1.z.enum(["development", "production", "test"]).default("development"),
+    ankiConnect: zod_1.z.object({
+        url: zod_1.z.string().url().default("http://localhost:8765"),
+        apiKey: zod_1.z.string().optional(),
+        apiVersion: zod_1.z.coerce.number().int().positive().default(6),
+        timeout: zod_1.z.coerce.number().int().positive().default(5000),
+    }),
+    auth: zod_1.z.object({
+        url: zod_1.z.string().url().default("https://keycloak.anatoly.dev"),
+        realm: zod_1.z.string().default("ankimcp-dev"),
+        clientId: zod_1.z.string().default("ankimcp-cli"),
+    }),
+    tunnel: zod_1.z.object({
+        serverUrl: zod_1.z.string().url().default("wss://tunnel.ankimcp.ai"),
+    }),
+    readOnly: zod_1.z
+        .preprocess((val) => {
+        if (val === "true" || val === "1")
+            return true;
+        if (val === "false" || val === "0" || val === undefined || val === "")
+            return false;
+        return val;
+    }, zod_1.z.boolean())
+        .default(false),
+    logLevel: zod_1.z.enum(["debug", "info", "warn", "error"]).default("info"),
+});
+function transformEnvToConfig(env) {
+    return {
+        port: env.PORT,
+        host: env.HOST,
+        nodeEnv: env.NODE_ENV,
+        ankiConnect: {
+            url: env.ANKI_CONNECT_URL,
+            apiKey: env.ANKI_CONNECT_API_KEY,
+            apiVersion: env.ANKI_CONNECT_API_VERSION,
+            timeout: env.ANKI_CONNECT_TIMEOUT,
+        },
+        auth: {
+            url: env.TUNNEL_AUTH_URL,
+            realm: env.TUNNEL_AUTH_REALM,
+            clientId: env.TUNNEL_AUTH_CLIENT_ID,
+        },
+        tunnel: {
+            serverUrl: env.TUNNEL_SERVER_URL,
+        },
+        readOnly: env.READ_ONLY,
+        logLevel: env.LOG_LEVEL,
+    };
+}
+//# sourceMappingURL=config.schema.js.map

package/dist/config/config.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.schema.js","sourceRoot":"","sources":["../../src/config/config.schema.ts"],"names":[],"mappings":"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"}

package/dist/config/index.d.ts

@@ -0,0 +1,3 @@
+export { configSchema, transformEnvToConfig, type AppConfig, } from "./config.schema";
+export { buildConfigInput, loadValidatedConfig, type ConfigInput, type CliOverrides, } from "./config.factory";
+export declare const APP_CONFIG: unique symbol;

package/dist/config/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.APP_CONFIG = exports.loadValidatedConfig = exports.buildConfigInput = exports.transformEnvToConfig = exports.configSchema = void 0;
+var config_schema_1 = require("./config.schema");
+Object.defineProperty(exports, "configSchema", { enumerable: true, get: function () { return config_schema_1.configSchema; } });
+Object.defineProperty(exports, "transformEnvToConfig", { enumerable: true, get: function () { return config_schema_1.transformEnvToConfig; } });
+var config_factory_1 = require("./config.factory");
+Object.defineProperty(exports, "buildConfigInput", { enumerable: true, get: function () { return config_factory_1.buildConfigInput; } });
+Object.defineProperty(exports, "loadValidatedConfig", { enumerable: true, get: function () { return config_factory_1.loadValidatedConfig; } });
+exports.APP_CONFIG = Symbol("APP_CONFIG");
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":";;;AAIA,iDAIyB;AAHvB,6GAAA,YAAY,OAAA;AACZ,qHAAA,oBAAoB,OAAA;AAGtB,mDAK0B;AAJxB,kHAAA,gBAAgB,OAAA;AAChB,qHAAA,mBAAmB,OAAA;AASR,QAAA,UAAU,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC"}

package/dist/http/guards/origin-validation.guard.d.ts

@@ -1,5 +1,6 @@
 import { CanActivate, ExecutionContext } from "@nestjs/common";
 export declare class OriginValidationGuard implements CanActivate {
+    private readonly logger;
     private readonly allowedOrigins;
     constructor();
     canActivate(context: ExecutionContext): boolean;

package/dist/http/guards/origin-validation.guard.js

@@ -8,10 +8,12 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
+var OriginValidationGuard_1;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OriginValidationGuard = void 0;
 const common_1 = require("@nestjs/common");
-let OriginValidationGuard = class OriginValidationGuard {
+let OriginValidationGuard = OriginValidationGuard_1 = class OriginValidationGuard {
+    logger = new common_1.Logger(OriginValidationGuard_1.name);
     allowedOrigins;
     constructor() {
         const defaultOrigins = "http://localhost:*,http://127.0.0.1:*,https://localhost:*,https://127.0.0.1:*";
@@ -26,7 +28,7 @@ let OriginValidationGuard = class OriginValidationGuard {
         }
         const isAllowed = this.allowedOrigins.some((allowedOrigin) => this.matchesPattern(origin, allowedOrigin));
         if (!isAllowed) {
-            console.warn(`[OriginValidationGuard] Rejected request from unauthorized origin: ${origin}`);
+            this.logger.warn(`Rejected request from unauthorized origin: ${origin}`);
         }
         return isAllowed;
     }
@@ -45,7 +47,7 @@ let OriginValidationGuard = class OriginValidationGuard {
     }
 };
 exports.OriginValidationGuard = OriginValidationGuard;
-exports.OriginValidationGuard = OriginValidationGuard = __decorate([
+exports.OriginValidationGuard = OriginValidationGuard = OriginValidationGuard_1 = __decorate([
     (0, common_1.Injectable)(),
     __metadata("design:paramtypes", [])
 ], OriginValidationGuard);

package/dist/http/guards/origin-validation.guard.js.map

@@ -1 +1 @@
-{"version":3,"file":"origin-validation.guard.js","sourceRoot":"","sources":["../../../src/http/guards/origin-validation.guard.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA2E;AAiBpE,IAAM,qBAAqB,GAA3B,MAAM,qBAAqB;IACf,cAAc,CAAW;IAE1C;QACE,MAAM,cAAc,GAClB,+EAA+E,CAAC;QAClF,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,cAAc,CAAC;QACjE,IAAI,CAAC,cAAc,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,WAAW,CAAC,OAAyB;QACnC,MAAM,OAAO,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,UAAU,EAAW,CAAC;QAC7D,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;QAGjE,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,IAAI,CAAC;QACd,CAAC;QAGD,MAAM,SAAS,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,EAAE,CAC3D,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,aAAa,CAAC,CAC3C,CAAC;QAEF,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CACV,sEAAsE,MAAM,EAAE,CAC/E,CAAC;QACJ,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IASO,cAAc,CAAC,MAAc,EAAE,OAAe;QAEpD,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;QAGD,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,YAAY,GAAG,OAAO;iBACzB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;iBACrB,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YACxB,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,IAAI,YAAY,GAAG,CAAC,CAAC;YAC9C,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;CACF,CAAA;AAzDY,sDAAqB;gCAArB,qBAAqB;IADjC,IAAA,mBAAU,GAAE;;GACA,qBAAqB,CAyDjC"}
+{"version":3,"file":"origin-validation.guard.js","sourceRoot":"","sources":["../../../src/http/guards/origin-validation.guard.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAAA,2CAKwB;AAiBjB,IAAM,qBAAqB,6BAA3B,MAAM,qBAAqB;IACf,MAAM,GAAG,IAAI,eAAM,CAAC,uBAAqB,CAAC,IAAI,CAAC,CAAC;IAChD,cAAc,CAAW;IAE1C;QACE,MAAM,cAAc,GAClB,+EAA+E,CAAC;QAClF,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,cAAc,CAAC;QACjE,IAAI,CAAC,cAAc,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,WAAW,CAAC,OAAyB;QACnC,MAAM,OAAO,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,UAAU,EAAW,CAAC;QAC7D,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;QAGjE,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,IAAI,CAAC;QACd,CAAC;QAGD,MAAM,SAAS,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,EAAE,CAC3D,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,aAAa,CAAC,CAC3C,CAAC;QAEF,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,8CAA8C,MAAM,EAAE,CAAC,CAAC;QAC3E,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IASO,cAAc,CAAC,MAAc,EAAE,OAAe;QAEpD,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;QAGD,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,YAAY,GAAG,OAAO;iBACzB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;iBACrB,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YACxB,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,IAAI,YAAY,GAAG,CAAC,CAAC;YAC9C,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;CACF,CAAA;AAxDY,sDAAqB;gCAArB,qBAAqB;IADjC,IAAA,mBAAU,GAAE;;GACA,qBAAqB,CAwDjC"}

package/dist/main-http.js

@@ -5,17 +5,25 @@ const app_module_1 = require("./app.module");
 const bootstrap_1 = require("./bootstrap");
 const origin_validation_guard_1 = require("./http/guards/origin-validation.guard");
 const cli_1 = require("./cli");
+const cli_output_1 = require("./cli/cli-output");
 const ngrok_service_1 = require("./services/ngrok.service");
+const config_1 = require("./config");
 async function bootstrap() {
     (0, cli_1.checkForUpdates)();
     const options = (0, cli_1.parseCliArgs)();
-    process.env.PORT = options.port.toString();
-    process.env.HOST = options.host;
-    process.env.ANKI_CONNECT_URL = options.ankiConnect;
-    process.env.READ_ONLY = options.readOnly ? "true" : "false";
-    const pinoLogger = (0, bootstrap_1.createPinoLogger)(1);
+    (0, cli_output_1.setDebugMode)(options.debug);
+    const configInput = (0, config_1.buildConfigInput)({
+        port: options.port,
+        host: options.host,
+        ankiConnect: options.ankiConnect,
+        readOnly: options.readOnly,
+        tunnel: options.tunnel,
+        ngrok: options.ngrok,
+        debug: options.debug,
+    });
+    const pinoLogger = (0, bootstrap_1.createPinoLogger)(bootstrap_1.LOG_DESTINATION.STDOUT, configInput.LOG_LEVEL || "info");
     const loggerService = (0, bootstrap_1.createLoggerService)(pinoLogger);
-    const app = await core_1.NestFactory.create(app_module_1.AppModule.forHttp(), {
+    const app = await core_1.NestFactory.create(app_module_1.AppModule.forHttp(configInput), {
         logger: loggerService,
         bufferLogs: true,
     });
@@ -29,15 +37,17 @@ async function bootstrap() {
             ngrokUrl = tunnelInfo.publicUrl;
         }
         catch (err) {
-            console.error("\n❌ Failed to start ngrok:");
-            console.error(err instanceof Error ? err.message : String(err));
-            console.error("\nServer is still running locally without tunnel.\n");
+            cli_output_1.cli.blank();
+            cli_output_1.cli.error(`Failed to start ngrok: ${err instanceof Error ? err.message : String(err)}`, err instanceof Error ? err : undefined);
+            cli_output_1.cli.blank();
+            cli_output_1.cli.info("Server is still running locally without tunnel.");
+            cli_output_1.cli.blank();
         }
     }
     (0, cli_1.displayStartupBanner)(options, ngrokUrl);
 }
 bootstrap().catch((err) => {
-    console.error("Failed to start MCP HTTP server:", err);
+    cli_output_1.cli.error(`Failed to start MCP HTTP server: ${err instanceof Error ? err.message : String(err)}`, err instanceof Error ? err : undefined);
     process.exit(1);
 });
 //# sourceMappingURL=main-http.js.map

package/dist/main-http.js.map

@@ -1 +1 @@
-{"version":3,"file":"main-http.js","sourceRoot":"","sources":["../src/main-http.ts"],"names":[],"mappings":";;AAAA,uCAA2C;AAC3C,6CAAyC;AACzC,2CAAoE;AACpE,mFAA8E;AAC9E,+BAA4E;AAC5E,4DAAwD;AAExD,KAAK,UAAU,SAAS;IAEtB,IAAA,qBAAe,GAAE,CAAC;IAElB,MAAM,OAAO,GAAG,IAAA,kBAAY,GAAE,CAAC;IAG/B,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC3C,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAChC,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC;IACnD,OAAO,CAAC,GAAG,CAAC,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;IAG5D,MAAM,UAAU,GAAG,IAAA,4BAAgB,EAAC,CAAC,CAAC,CAAC;IACvC,MAAM,aAAa,GAAG,IAAA,+BAAmB,EAAC,UAAU,CAAC,CAAC;IAGtD,MAAM,GAAG,GAAG,MAAM,kBAAW,CAAC,MAAM,CAAC,sBAAS,CAAC,OAAO,EAAE,EAAE;QACxD,MAAM,EAAE,aAAa;QACrB,UAAU,EAAE,IAAI;KACjB,CAAC,CAAC;IAGH,GAAG,CAAC,eAAe,CAAC,IAAI,+CAAqB,EAAE,CAAC,CAAC;IAEjD,MAAM,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAG7C,IAAI,QAA4B,CAAC;IACjC,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,IAAI,4BAAY,EAAE,CAAC;YACxC,MAAM,UAAU,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC1D,QAAQ,GAAG,UAAU,CAAC,SAAS,CAAC;QAClC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;YAC5C,OAAO,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAChE,OAAO,CAAC,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;IAGD,IAAA,0BAAoB,EAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACxB,OAAO,CAAC,KAAK,CAAC,kCAAkC,EAAE,GAAG,CAAC,CAAC;IACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"main-http.js","sourceRoot":"","sources":["../src/main-http.ts"],"names":[],"mappings":";;AAAA,uCAA2C;AAC3C,6CAAyC;AACzC,2CAIqB;AACrB,mFAA8E;AAC9E,+BAA4E;AAC5E,iDAAqD;AACrD,4DAAwD;AACxD,qCAA4C;AAE5C,KAAK,UAAU,SAAS;IAEtB,IAAA,qBAAe,GAAE,CAAC;IAElB,MAAM,OAAO,GAAG,IAAA,kBAAY,GAAE,CAAC;IAG/B,IAAA,yBAAY,EAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAG5B,MAAM,WAAW,GAAG,IAAA,yBAAgB,EAAC;QACnC,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,KAAK,EAAE,OAAO,CAAC,KAAK;KACrB,CAAC,CAAC;IAIH,MAAM,UAAU,GAAG,IAAA,4BAAgB,EACjC,2BAAe,CAAC,MAAM,EACtB,WAAW,CAAC,SAAS,IAAI,MAAM,CAChC,CAAC;IACF,MAAM,aAAa,GAAG,IAAA,+BAAmB,EAAC,UAAU,CAAC,CAAC;IAGtD,MAAM,GAAG,GAAG,MAAM,kBAAW,CAAC,MAAM,CAAC,sBAAS,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE;QACnE,MAAM,EAAE,aAAa;QACrB,UAAU,EAAE,IAAI;KACjB,CAAC,CAAC;IAGH,GAAG,CAAC,eAAe,CAAC,IAAI,+CAAqB,EAAE,CAAC,CAAC;IAEjD,MAAM,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAG7C,IAAI,QAA4B,CAAC;IACjC,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,IAAI,4BAAY,EAAE,CAAC;YACxC,MAAM,UAAU,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC1D,QAAQ,GAAG,UAAU,CAAC,SAAS,CAAC;QAClC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,gBAAG,CAAC,KAAK,EAAE,CAAC;YACZ,gBAAG,CAAC,KAAK,CACP,0BAA0B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAC5E,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CACvC,CAAC;YACF,gBAAG,CAAC,KAAK,EAAE,CAAC;YACZ,gBAAG,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;YAC5D,gBAAG,CAAC,KAAK,EAAE,CAAC;QACd,CAAC;IACH,CAAC;IAGD,IAAA,0BAAoB,EAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACxB,gBAAG,CAAC,KAAK,CACP,oCAAoC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EACtF,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CACvC,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/main-stdio.js

@@ -3,6 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@nestjs/core");
 const app_module_1 = require("./app.module");
 const bootstrap_1 = require("./bootstrap");
+const cli_output_1 = require("./cli/cli-output");
+const config_1 = require("./config");
 function parseStdioArgs() {
     const args = process.argv.slice(2);
     let readOnly = false;
@@ -20,15 +22,13 @@ function parseStdioArgs() {
 }
 async function bootstrap() {
     const cliOptions = parseStdioArgs();
-    if (cliOptions.readOnly) {
-        process.env.READ_ONLY = "true";
-    }
-    if (cliOptions.ankiConnect) {
-        process.env.ANKI_CONNECT_URL = cliOptions.ankiConnect;
-    }
-    const pinoLogger = (0, bootstrap_1.createPinoLogger)(2);
+    const configInput = (0, config_1.buildConfigInput)({
+        ankiConnect: cliOptions.ankiConnect,
+        readOnly: cliOptions.readOnly,
+    });
+    const pinoLogger = (0, bootstrap_1.createPinoLogger)(bootstrap_1.LOG_DESTINATION.STDERR, configInput.LOG_LEVEL || "info");
     const loggerService = (0, bootstrap_1.createLoggerService)(pinoLogger);
-    await core_1.NestFactory.createApplicationContext(app_module_1.AppModule.forStdio(), {
+    await core_1.NestFactory.createApplicationContext(app_module_1.AppModule.forStdio(configInput), {
         logger: loggerService,
         bufferLogs: true,
     });
@@ -41,7 +41,7 @@ async function bootstrap() {
     await new Promise(() => { });
 }
 bootstrap().catch((err) => {
-    console.error("Failed to start MCP STDIO server:", err);
+    cli_output_1.cli.error(`Failed to start MCP STDIO server: ${err instanceof Error ? err.message : String(err)}`, err instanceof Error ? err : undefined);
     process.exit(1);
 });
 //# sourceMappingURL=main-stdio.js.map

package/dist/main-stdio.js.map

@@ -1 +1 @@
-{"version":3,"file":"main-stdio.js","sourceRoot":"","sources":["../src/main-stdio.ts"],"names":[],"mappings":";;AAAA,uCAA2C;AAC3C,6CAAyC;AACzC,2CAAoE;AAMpE,SAAS,cAAc;IACrB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,WAA+B,CAAC;IAEpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,aAAa,EAAE,CAAC;YAC9B,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;aAAM,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,gBAAgB,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YAC5D,WAAW,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC1B,CAAC,EAAE,CAAC;QACN,CAAC;IACH,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;AACnC,CAAC;AAED,KAAK,UAAU,SAAS;IAEtB,MAAM,UAAU,GAAG,cAAc,EAAE,CAAC;IAGpC,IAAI,UAAU,CAAC,QAAQ,EAAE,CAAC;QACxB,OAAO,CAAC,GAAG,CAAC,SAAS,GAAG,MAAM,CAAC;IACjC,CAAC;IACD,IAAI,UAAU,CAAC,WAAW,EAAE,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,UAAU,CAAC,WAAW,CAAC;IACxD,CAAC;IAGD,MAAM,UAAU,GAAG,IAAA,4BAAgB,EAAC,CAAC,CAAC,CAAC;IACvC,MAAM,aAAa,GAAG,IAAA,+BAAmB,EAAC,UAAU,CAAC,CAAC;IAGtD,MAAM,kBAAW,CAAC,wBAAwB,CAAC,sBAAS,CAAC,QAAQ,EAAE,EAAE;QAC/D,MAAM,EAAE,aAAa;QACrB,UAAU,EAAE,IAAI;KACjB,CAAC,CAAC;IAEH,IAAI,UAAU,CAAC,QAAQ,EAAE,CAAC;QACxB,UAAU,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;SAAM,CAAC;QACN,UAAU,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IAGD,MAAM,IAAI,OAAO,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;AAC9B,CAAC;AAED,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACxB,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,GAAG,CAAC,CAAC;IACxD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"main-stdio.js","sourceRoot":"","sources":["../src/main-stdio.ts"],"names":[],"mappings":";;AAAA,uCAA2C;AAC3C,6CAAyC;AACzC,2CAIqB;AACrB,iDAAuC;AACvC,qCAA4C;AAM5C,SAAS,cAAc;IACrB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,WAA+B,CAAC;IAEpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,aAAa,EAAE,CAAC;YAC9B,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;aAAM,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,gBAAgB,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YAC5D,WAAW,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC1B,CAAC,EAAE,CAAC;QACN,CAAC;IACH,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;AACnC,CAAC;AAED,KAAK,UAAU,SAAS;IAEtB,MAAM,UAAU,GAAG,cAAc,EAAE,CAAC;IAGpC,MAAM,WAAW,GAAG,IAAA,yBAAgB,EAAC;QACnC,WAAW,EAAE,UAAU,CAAC,WAAW;QACnC,QAAQ,EAAE,UAAU,CAAC,QAAQ;KAC9B,CAAC,CAAC;IAIH,MAAM,UAAU,GAAG,IAAA,4BAAgB,EACjC,2BAAe,CAAC,MAAM,EACtB,WAAW,CAAC,SAAS,IAAI,MAAM,CAChC,CAAC;IACF,MAAM,aAAa,GAAG,IAAA,+BAAmB,EAAC,UAAU,CAAC,CAAC;IAGtD,MAAM,kBAAW,CAAC,wBAAwB,CAAC,sBAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE;QAC1E,MAAM,EAAE,aAAa;QACrB,UAAU,EAAE,IAAI;KACjB,CAAC,CAAC;IAEH,IAAI,UAAU,CAAC,QAAQ,EAAE,CAAC;QACxB,UAAU,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;SAAM,CAAC;QACN,UAAU,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IAGD,MAAM,IAAI,OAAO,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;AAC9B,CAAC;AAED,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACxB,gBAAG,CAAC,KAAK,CACP,qCAAqC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EACvF,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CACvC,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/main-tunnel.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/main-tunnel.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const cli_1 = require("./cli");
+const cli_output_1 = require("./cli/cli-output");
+const tunnel_1 = require("./tunnel");
+async function bootstrap() {
+    (0, cli_1.checkForUpdates)();
+    const options = (0, cli_1.parseCliArgs)();
+    (0, cli_output_1.setDebugMode)(options.debug);
+    if (options.login) {
+        const loginUrl = typeof options.login === "string" ? options.login : undefined;
+        await (0, tunnel_1.handleLogin)(loginUrl);
+        process.exit(0);
+    }
+    if (options.logout) {
+        await (0, tunnel_1.handleLogout)();
+        process.exit(0);
+    }
+    const tunnelUrl = typeof options.tunnel === "string" ? options.tunnel : undefined;
+    await (0, tunnel_1.handleTunnel)(tunnelUrl, options.debug, options.readOnly);
+}
+bootstrap().catch((err) => {
+    cli_output_1.cli.error(`Failed to start tunnel: ${err instanceof Error ? err.message : String(err)}`, err instanceof Error ? err : undefined);
+    process.exit(1);
+});
+//# sourceMappingURL=main-tunnel.js.map

package/dist/main-tunnel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main-tunnel.js","sourceRoot":"","sources":["../src/main-tunnel.ts"],"names":[],"mappings":";;AAAA,+BAAsD;AACtD,iDAAqD;AACrD,qCAAmE;AAEnE,KAAK,UAAU,SAAS;IAEtB,IAAA,qBAAe,GAAE,CAAC;IAElB,MAAM,OAAO,GAAG,IAAA,kBAAY,GAAE,CAAC;IAG/B,IAAA,yBAAY,EAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAG5B,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,QAAQ,GACZ,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;QAChE,MAAM,IAAA,oBAAW,EAAC,QAAQ,CAAC,CAAC;QAC5B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,IAAA,qBAAY,GAAE,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAID,MAAM,SAAS,GACb,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IAClE,MAAM,IAAA,qBAAY,EAAC,SAAS,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;AACjE,CAAC;AAED,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACxB,gBAAG,CAAC,KAAK,CACP,2BAA2B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAC7E,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CACvC,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

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

@@ -75,6 +75,7 @@ import { SystemInfoResource } from "./resources/system-info.resource";
 export declare const ESSENTIAL_MCP_TOOLS: (typeof SyncTool | typeof GetDueCardsTool | typeof GetCardsTool | typeof PresentCardTool | typeof RateCardTool | typeof ModelNamesTool | typeof ModelFieldNamesTool | typeof ModelStylingTool | typeof CreateModelTool | typeof UpdateModelStylingTool | typeof AddNoteTool | typeof AddNotesTool | typeof FindNotesTool | typeof NotesInfoTool | typeof UpdateNoteFieldsTool | typeof DeleteNotesTool | typeof GetTagsTool | typeof ListDecksTool | typeof DeckStatsTool | typeof CreateDeckTool | typeof ChangeDeckTool | typeof RetrieveMediaFileTool | typeof GetMediaFilesNamesTool | typeof StoreMediaFileTool | typeof DeleteMediaFileTool | typeof AddTagsTool | typeof RemoveTagsTool | typeof ReplaceTagsTool | typeof ClearUnusedTagsTool | typeof CollectionStatsTool | typeof ReviewStatsTool | typeof ReviewSessionPrompt | typeof TwentyRulesPrompt | typeof SystemInfoResource)[];
 export interface McpPrimitivesAnkiEssentialModuleOptions {
     ankiConfigProvider: Provider;
+    appConfigProvider?: Provider;
 }
 export declare class McpPrimitivesAnkiEssentialModule {
     static forRoot(options: McpPrimitivesAnkiEssentialModuleOptions): DynamicModule;

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

@@ -173,9 +173,16 @@ exports.ESSENTIAL_MCP_TOOLS = [
 const ESSENTIAL_MCP_PRIMITIVES = [anki_connect_client_2.AnkiConnectClient, ...exports.ESSENTIAL_MCP_TOOLS];
 let McpPrimitivesAnkiEssentialModule = McpPrimitivesAnkiEssentialModule_1 = class McpPrimitivesAnkiEssentialModule {
     static forRoot(options) {
+        const providers = [
+            options.ankiConfigProvider,
+            ...ESSENTIAL_MCP_PRIMITIVES,
+        ];
+        if (options.appConfigProvider) {
+            providers.push(options.appConfigProvider);
+        }
         return {
             module: McpPrimitivesAnkiEssentialModule_1,
-            providers: [options.ankiConfigProvider, ...ESSENTIAL_MCP_PRIMITIVES],
+            providers,
             exports: ESSENTIAL_MCP_PRIMITIVES,
         };
     }

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

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

package/dist/mcp/primitives/essential/tools/add-note.tool.d.ts

@@ -121,7 +121,7 @@ export declare class AddNoteTool {
         details: {
             fieldsAdded: number;
             tagsAdded: number;
-            duplicateCheckScope: "deck" | "collection" | "default" | "none";
+            duplicateCheckScope: "default" | "deck" | "collection" | "none";
         };
     }>;
 }

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

@@ -16,6 +16,7 @@ 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 deck_hierarchy_utils_1 = require("../../../../utils/deck-hierarchy.utils");
 const stats_utils_1 = require("../../../../utils/stats.utils");
 let CollectionStatsTool = CollectionStatsTool_1 = class CollectionStatsTool {
     ankiClient;
@@ -61,34 +62,27 @@ let CollectionStatsTool = CollectionStatsTool_1 = class CollectionStatsTool {
             if (!deckStatsResponse || typeof deckStatsResponse !== "object") {
                 throw new Error("Invalid getDeckStats response");
             }
-            const per_deck = [];
-            const counts = {
-                total: 0,
-                new: 0,
-                learning: 0,
-                review: 0,
-                other: 0,
-            };
+            const perDeckOwnTotal = new Map();
+            const perDeckStats = new Map();
             const missingDecks = [];
             for (const deckName of deckNames) {
                 const deckId = deckNamesAndIds[deckName];
                 const deckStats = deckId != null ? deckStatsResponse[String(deckId)] : undefined;
                 if (!deckStats) {
                     missingDecks.push(deckName);
-                    per_deck.push({
-                        deck: deckName,
-                        total: 0,
-                        new: 0,
-                        learning: 0,
-                        review: 0,
-                        other: 0,
-                    });
+                    perDeckOwnTotal.set(deckName, 0);
                     continue;
                 }
-                const total = deckStats.total_in_deck ?? 0;
-                const newCount = deckStats.new_count ?? 0;
-                const learning = deckStats.learn_count ?? 0;
-                const review = deckStats.review_count ?? 0;
+                perDeckOwnTotal.set(deckName, deckStats.total_in_deck ?? 0);
+                perDeckStats.set(deckName, deckStats);
+            }
+            const per_deck = [];
+            for (const deckName of deckNames) {
+                const stats = perDeckStats.get(deckName);
+                const newCount = stats?.new_count ?? 0;
+                const learning = stats?.learn_count ?? 0;
+                const review = stats?.review_count ?? 0;
+                const total = (0, deck_hierarchy_utils_1.rollupDeckTotal)(deckName, perDeckOwnTotal);
                 const other = Math.max(0, total - newCount - learning - review);
                 per_deck.push({
                     deck: deckName,
@@ -98,17 +92,30 @@ let CollectionStatsTool = CollectionStatsTool_1 = class CollectionStatsTool {
                     review,
                     other,
                 });
-                counts.total += total;
-                counts.new += newCount;
-                counts.learning += learning;
-                counts.review += review;
-                counts.other += other;
             }
             if (missingDecks.length > 0) {
                 this.logger.warn(`getDeckStats did not return stats for ${missingDecks.length} deck(s): ` +
                     `${missingDecks.join(", ")}. Filled with zeros.`);
             }
-            this.logger.log(`Aggregated counts: ${counts.total} total cards across ${deckNames.length} decks`);
+            const rootDeckNames = new Set((0, deck_hierarchy_utils_1.getRootDeckNames)(deckNames));
+            const counts = {
+                total: 0,
+                new: 0,
+                learning: 0,
+                review: 0,
+                other: 0,
+            };
+            for (const entry of per_deck) {
+                if (!rootDeckNames.has(entry.deck))
+                    continue;
+                counts.total += entry.total;
+                counts.new += entry.new;
+                counts.learning += entry.learning;
+                counts.review += entry.review;
+                counts.other += entry.other;
+            }
+            this.logger.log(`Aggregated counts: ${counts.total} total cards across ${rootDeckNames.size} root deck(s) ` +
+                `(${deckNames.length} total decks including children)`);
             await context.reportProgress({ progress: 40, total: 100 });
             if (counts.total === 0) {
                 this.logger.log("Collection is empty (no cards)");
@@ -202,7 +209,9 @@ __decorate([
     (0, mcp_nest_1.Tool)({
         name: "collection_stats",
         description: "Get aggregated statistics across all decks in the collection including card counts, ease factor distribution, and interval distribution. " +
-            "Provides both collection-wide metrics and per-deck breakdown. " +
+            "Per-deck counts are rolled up over descendants (a parent deck includes its children), matching Anki's deck browser. " +
+            "Collection-level `counts` sum the ROOT decks only to avoid double-counting children. " +
+            "Invariant: for every deck and for the collection, total === new + learning + review + other. " +
             "Use this to analyze overall collection health and compare deck statistics. " +
             "Ease buckets and interval buckets can be customized to focus on specific ranges.",
         parameters: zod_1.z.object({
@@ -229,16 +238,32 @@ __decorate([
         }),
         outputSchema: zod_1.z.object({
             total_decks: zod_1.z.number(),
-            counts: zod_1.z.object({
-                total: zod_1.z.number(),
-                new: zod_1.z.number(),
-                learning: zod_1.z.number(),
-                review: zod_1.z.number(),
+            counts: zod_1.z
+                .object({
+                total: zod_1.z
+                    .number()
+                    .describe("Total cards in the collection. Computed as the sum of " +
+                    "ROOT-deck rolled-up totals (decks without `::` in the name), " +
+                    "which prevents double-counting children. Invariant: " +
+                    "total === new + learning + review + other."),
+                new: zod_1.z
+                    .number()
+                    .describe("New cards (never studied), summed over root decks' rolled-up counts."),
+                learning: zod_1.z
+                    .number()
+                    .describe("Learning/relearning cards, summed over root decks' rolled-up counts."),
+                review: zod_1.z
+                    .number()
+                    .describe("Review cards (mature), summed over root decks' rolled-up counts."),
                 other: zod_1.z
                     .number()
-                    .describe("Cards not in new/learning/review (typically suspended or buried). " +
+                    .describe("Cards not in new/learning/review (typically suspended or buried), " +
+                    "summed over root decks' rolled-up counts. " +
                     "Computed as total - new - learning - review."),
-            }),
+            })
+                .describe("Aggregated card counts across the collection. Summed over ROOT " +
+                "decks only (names without `::`) so that a parent's rollup is not " +
+                "added on top of its children."),
             ease: zod_1.z.object({
                 mean: zod_1.z.number(),
                 median: zod_1.z.number(),
@@ -255,14 +280,19 @@ __decorate([
                 count: zod_1.z.number(),
                 buckets: zod_1.z.record(zod_1.z.string(), zod_1.z.number()),
             }),
-            per_deck: zod_1.z.array(zod_1.z.object({
+            per_deck: zod_1.z
+                .array(zod_1.z.object({
                 deck: zod_1.z.string(),
                 total: zod_1.z.number(),
                 new: zod_1.z.number(),
                 learning: zod_1.z.number(),
                 review: zod_1.z.number(),
                 other: zod_1.z.number(),
-            })),
+            }))
+                .describe("Per-deck breakdown with one entry per deck. Each entry's counts " +
+                'are rolled up over that deck\'s descendants (entry for "German" ' +
+                'includes cards from "German::Verbs"). Invariant per row: ' +
+                "total === new + learning + review + other."),
         }),
         annotations: {
             title: "Collection Statistics",