@reftrixmcp/mcp-server 0.1.7

package/dist/config/redis.js

@@ -0,0 +1,234 @@
+"use strict";
+// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
+// SPDX-License-Identifier: AGPL-3.0-only
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_REDIS_CONFIG = void 0;
+exports.getRedisConfig = getRedisConfig;
+exports.createRedisClient = createRedisClient;
+exports.getRedisClient = getRedisClient;
+exports.checkRedisConnection = checkRedisConnection;
+exports.closeRedisClient = closeRedisClient;
+exports.isRedisAvailable = isRedisAvailable;
+/**
+ * Redis Connection Configuration for BullMQ
+ *
+ * Provides Redis connection factory with:
+ * - Environment variable configuration (REDIS_HOST, REDIS_PORT)
+ * - Port offset convention (27379 = 6379 + 21000)
+ * - Graceful degradation when Redis is unavailable
+ *
+ * @module config/redis
+ */
+const ioredis_1 = __importDefault(require("ioredis"));
+/**
+ * Default Redis configuration with port offset
+ *
+ * Port offset: 21000 (standard Redis 6379 -> 27379)
+ */
+exports.DEFAULT_REDIS_CONFIG = {
+    host: "localhost",
+    port: 27379, // 6379 + 21000 (port offset)
+    maxRetriesPerRequest: 3,
+    connectTimeout: 5000,
+    lazyConnect: true,
+};
+/**
+ * Parse REDIS_URL environment variable
+ *
+ * @param url - Redis URL (e.g., "redis://localhost:27379")
+ * @returns Partial Redis configuration or null if invalid
+ */
+function parseRedisUrl(url) {
+    try {
+        const parsed = new URL(url);
+        if (parsed.protocol !== "redis:" && parsed.protocol !== "rediss:") {
+            return null;
+        }
+        return {
+            host: parsed.hostname || "localhost",
+            port: parsed.port ? parseInt(parsed.port, 10) : 27379,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Get Redis configuration from environment variables
+ *
+ * Priority:
+ * 1. REDIS_URL (full URL)
+ * 2. REDIS_HOST + REDIS_PORT (individual settings)
+ * 3. Default values (localhost:27379)
+ *
+ * @param overrides - Optional configuration overrides
+ * @returns Complete Redis configuration
+ */
+function getRedisConfig(overrides) {
+    const envConfig = {};
+    // Parse REDIS_URL if available
+    const redisUrl = process.env.REDIS_URL;
+    if (redisUrl) {
+        const parsed = parseRedisUrl(redisUrl);
+        if (parsed) {
+            Object.assign(envConfig, parsed);
+        }
+    }
+    // Override with individual environment variables
+    if (process.env.REDIS_HOST) {
+        envConfig.host = process.env.REDIS_HOST;
+    }
+    if (process.env.REDIS_PORT) {
+        const port = parseInt(process.env.REDIS_PORT, 10);
+        if (!isNaN(port) && port > 0 && port <= 65535) {
+            envConfig.port = port;
+        }
+    }
+    return {
+        ...exports.DEFAULT_REDIS_CONFIG,
+        ...envConfig,
+        ...overrides,
+    };
+}
+/**
+ * Singleton Redis client instance
+ */
+let redisClient = null;
+/**
+ * Create a new Redis client with the given configuration
+ *
+ * Features:
+ * - Lazy connection (doesn't connect immediately)
+ * - Graceful error handling
+ * - Automatic reconnection
+ *
+ * @param config - Optional configuration overrides
+ * @returns Redis client instance
+ */
+function createRedisClient(config) {
+    const finalConfig = getRedisConfig(config);
+    const client = new ioredis_1.default({
+        host: finalConfig.host,
+        port: finalConfig.port,
+        maxRetriesPerRequest: finalConfig.maxRetriesPerRequest,
+        connectTimeout: finalConfig.connectTimeout,
+        lazyConnect: finalConfig.lazyConnect,
+        // Disable offline queue to fail fast when Redis is unavailable
+        enableOfflineQueue: false,
+        // Retry strategy: exponential backoff with max 3 retries
+        retryStrategy: (times) => {
+            if (times > 3) {
+                // Stop retrying after 3 attempts
+                return null;
+            }
+            // Exponential backoff: 100ms, 200ms, 400ms
+            return Math.min(times * 100, 1000);
+        },
+    });
+    // Log connection events in development
+    if (process.env.NODE_ENV === "development") {
+        client.on("connect", () => {
+            console.warn(`[Redis] Connected to ${finalConfig.host}:${finalConfig.port}`);
+        });
+        client.on("error", (err) => {
+            console.error("[Redis] Connection error:", err.message);
+        });
+        client.on("close", () => {
+            console.warn("[Redis] Connection closed");
+        });
+    }
+    return client;
+}
+/**
+ * Get or create the singleton Redis client
+ *
+ * @returns Redis client instance (may not be connected yet)
+ */
+function getRedisClient() {
+    if (!redisClient) {
+        redisClient = createRedisClient();
+    }
+    return redisClient;
+}
+/**
+ * Check Redis connection status
+ *
+ * @param client - Optional Redis client (uses singleton if not provided)
+ * @returns Connection status with optional server info
+ */
+async function checkRedisConnection(client) {
+    const redis = client || getRedisClient();
+    try {
+        // Try to connect if not already connected
+        if (redis.status !== "ready") {
+            await redis.connect();
+        }
+        // Ping to verify connection
+        const pong = await redis.ping();
+        if (pong !== "PONG") {
+            return {
+                connected: false,
+                error: `Unexpected ping response: ${pong}`,
+            };
+        }
+        // Get server info
+        const info = await redis.info("server");
+        const versionMatch = info.match(/redis_version:(\S+)/);
+        const modeMatch = info.match(/redis_mode:(\S+)/);
+        const clientsInfo = await redis.info("clients");
+        const clientsMatch = clientsInfo.match(/connected_clients:(\d+)/);
+        // Build info object, only including defined values
+        const redisInfo = {};
+        if (versionMatch?.[1]) {
+            redisInfo.version = versionMatch[1];
+        }
+        if (modeMatch?.[1]) {
+            redisInfo.mode = modeMatch[1];
+        }
+        if (clientsMatch && clientsMatch[1]) {
+            redisInfo.connectedClients = parseInt(clientsMatch[1], 10);
+        }
+        return {
+            connected: true,
+            info: redisInfo,
+        };
+    }
+    catch (err) {
+        const error = err instanceof Error ? err.message : String(err);
+        return {
+            connected: false,
+            error,
+        };
+    }
+}
+/**
+ * Close the singleton Redis client
+ *
+ * Call this during graceful shutdown
+ */
+async function closeRedisClient() {
+    if (redisClient) {
+        await redisClient.quit();
+        redisClient = null;
+    }
+}
+/**
+ * Check if Redis is available without throwing
+ *
+ * Useful for graceful degradation when Redis is optional
+ *
+ * @returns true if Redis is available, false otherwise
+ */
+async function isRedisAvailable() {
+    try {
+        const status = await checkRedisConnection();
+        return status.connected;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=redis.js.map

package/dist/config/redis.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+export { createServer, start } from "./server";
+export { createTransport } from "./transport";
+export { ErrorCode, McpError } from "./utils/errors";
+export { Logger, logger, createLogger } from "./utils/logger";
+export type { ILogger } from "./utils/logger";
+export { registerTool, handleToolCall, getRegisteredTools, setAuthMiddleware, clearAuthMiddleware, getAuthMiddleware, TOOL_NAMES, ALL_TOOL_NAMES, } from "./router";
+export type { ToolHandler, ToolCallResult } from "./router";
+export { createAuthMiddleware, validateApiKey, checkPermission, PERMISSIONS, ROLES, TOOL_PERMISSIONS, PUBLIC_TOOLS, } from "./middleware/auth";
+export type { AuthContext, AuthMiddlewareOptions, AuthResult, AuthMiddlewareInstance, Role, } from "./middleware/auth";
+export { ServiceClient, serviceClient, API_BASE_URL } from "./services/service-client";
+export type { ProjectBrandSettingInfo, ProjectResponse, ProjectListParams, ProjectListResponse, ColorToken, PaletteResponse, } from "./services/service-client";
+export { webPageService, createWebPageService } from "./services/web-page.service";
+export type { IWebPageService, WebPageResult } from "./services/web-page.service";
+export { assertProductionAuthEnabled, isMcpAuthEnabled, isInsecureProductionAllowed, isProductionEnvironment, ProductionAuthRequiredError, ProductionGuardError, } from "./services/production-guard";
+export { executePageAnalyze, type PageAnalyzeInput, type PageAnalyzeOutput, type PageAnalyzeData, type PageAnalyzeError, type LayoutResult, type MotionResult, type QualityResult, type PageMetadata, type AnalysisWarning, sourceTypeSchema, usageScopeSchema, waitUntilSchema, gradeSchema, type SourceType, type UsageScope, type WaitUntil, type Grade, pageAnalyzeInputSchema, pageAnalyzeOutputSchema, analysisFeaturesSchema, viewportSchema, layoutOptionsSchema, motionOptionsSchema, qualityOptionsSchema, type AnalysisFeatures, type Viewport, type LayoutOptions, type MotionOptions, type QualityOptions, PAGE_ANALYZE_ERROR_CODES, type PageAnalyzeErrorCode, executeLayoutSearch, type LayoutSearchInput, type LayoutSearchOutput, type LayoutSearchData, type LayoutSearchErrorInfo, type LayoutSearchResultItem, type LayoutSearchFilters, type LayoutSearchPreview, type LayoutSearchSource, executeMotionSearch, type MotionSearchInput, type MotionSearchOutput, type MotionSearchParams, type MotionSearchResult, type MotionSearchData, type MotionSearchError, type MotionSearchResultItem, type MotionSearchFilters, type MotionSearchType, type MotionSearchTrigger, type MotionSearchSource, type MotionSearchQueryInfo, executeMotionDetect, resetMotionDetectService, type MotionDetectInput, type MotionDetectOutput, type MotionDetectData, type MotionDetectOptions, type MotionDetectErrorInfo, type MotionPatternApi, type MotionWarningApi, type MotionPattern, type MotionWarning, type MotionDetectionResult, type MotionDetectionOptions, executeQualityEvaluate, resetQualityEvaluateService, type QualityEvaluateInput, type QualityEvaluateOutput, type QualityEvaluateData, type QualityEvaluateErrorInfo, type QualityEvaluatorOptions, type QualityEvaluatorResult, executeGetPalette, type GetPaletteInput, type GetPaletteResult, type GetPaletteOptions, type PaletteDetail, type PaletteListItem, type ColorTokenApi, type GradientApi, executeLayoutGenerateCode, setPrismaClientFactory, type LayoutToCodeInput, type LayoutToCodeOutput, type LayoutToCodeData, type LayoutToCodeOptions, type LayoutToCodeErrorInfo, type Framework, } from "./services";
+export { initializeAllServices, initializeMotionServices, initializeLayoutServices, initializeQualityServices, type ServiceInitializerConfig, type ServiceInitializerResult, type IEmbeddingService, type IWebPageService as IWebPageServiceInitializer, type IPrismaClientMinimal, } from "./services/service-initializer";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,247 @@
+#!/usr/bin/env node
+"use strict";
+// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
+// SPDX-License-Identifier: AGPL-3.0-only
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeMotionDetect = exports.executeMotionSearch = exports.executeLayoutSearch = exports.PAGE_ANALYZE_ERROR_CODES = exports.qualityOptionsSchema = exports.motionOptionsSchema = exports.layoutOptionsSchema = exports.viewportSchema = exports.analysisFeaturesSchema = exports.pageAnalyzeOutputSchema = exports.pageAnalyzeInputSchema = exports.gradeSchema = exports.waitUntilSchema = exports.usageScopeSchema = exports.sourceTypeSchema = exports.executePageAnalyze = exports.ProductionGuardError = exports.ProductionAuthRequiredError = exports.isProductionEnvironment = exports.isInsecureProductionAllowed = exports.isMcpAuthEnabled = exports.assertProductionAuthEnabled = exports.createWebPageService = exports.webPageService = exports.API_BASE_URL = exports.serviceClient = exports.ServiceClient = exports.PUBLIC_TOOLS = exports.TOOL_PERMISSIONS = exports.ROLES = exports.PERMISSIONS = exports.checkPermission = exports.validateApiKey = exports.createAuthMiddleware = exports.ALL_TOOL_NAMES = exports.TOOL_NAMES = exports.getAuthMiddleware = exports.clearAuthMiddleware = exports.setAuthMiddleware = exports.getRegisteredTools = exports.handleToolCall = exports.registerTool = exports.createLogger = exports.logger = exports.Logger = exports.McpError = exports.ErrorCode = exports.createTransport = exports.start = exports.createServer = void 0;
+exports.initializeQualityServices = exports.initializeLayoutServices = exports.initializeMotionServices = exports.initializeAllServices = exports.setPrismaClientFactory = exports.executeLayoutGenerateCode = exports.executeGetPalette = exports.resetQualityEvaluateService = exports.executeQualityEvaluate = exports.resetMotionDetectService = void 0;
+/**
+ * @reftrixmcp/mcp-server
+ * MCP Server for Reftrix - AI agent integration
+ *
+ * エントリポイント
+ *
+ * 認証ミドルウェア統合対応
+ *
+ * MCP-INIT-01: サービス初期化の一本化
+ * - initializeAllServices() による統合初期化
+ * - 起動ログの可視化（有効化されたカテゴリ表示）
+ * - 配線漏れ検出（必須サービス未初期化の警告）
+ */
+const server_1 = require("./server");
+const transport_1 = require("./transport");
+const logger_1 = require("./utils/logger");
+const router_1 = require("./router");
+const tools_1 = require("./tools");
+const auth_1 = require("./middleware/auth");
+const production_guard_1 = require("./services/production-guard");
+const ml_1 = require("@reftrixmcp/ml");
+const database_1 = require("@reftrixmcp/database");
+const web_page_service_1 = require("./services/web-page.service");
+const service_initializer_1 = require("./services/service-initializer");
+const worker_supervisor_service_1 = require("./services/worker-supervisor.service");
+/**
+ * メイン関数
+ * MCPサーバーを起動
+ */
+async function main() {
+    // 環境変数を検証（最優先で実行）
+    // NODE_ENV が未設定/空の場合はエラーをスローしてサーバー起動を中止
+    const environment = (0, logger_1.validateEnvironment)();
+    logger_1.logger.info(`Environment validated: ${environment}`);
+    logger_1.logger.info("Reftrix MCP Server starting...");
+    logger_1.logger.info(`Server: ${server_1.SERVER_CONFIG.name} v${server_1.SERVER_CONFIG.version}`);
+    try {
+        // =====================================================
+        // サービス初期化（統合化: MCP-INIT-01）
+        // =====================================================
+        // 以前は個別に set*Factory() を呼び出していたが、
+        // service-initializer.ts の initializeAllServices() に統合。
+        // これにより配線漏れリスクを低減し、起動ログを可視化。
+        const serviceConfig = {
+            embeddingService: ml_1.embeddingService,
+            prisma: database_1.prisma,
+            webPageService: web_page_service_1.webPageService,
+        };
+        const initResult = (0, service_initializer_1.initializeAllServices)(serviceConfig);
+        if (!initResult.success) {
+            logger_1.logger.error("[Main] Service initialization failed", { error: initResult.error });
+            throw new Error(`Service initialization failed: ${initResult.error}`);
+        }
+        logger_1.logger.info("[Main] Service factories registered via initializeAllServices()");
+        // 本番環境では認証を強制（MCP-AUTH-01）
+        // NODE_ENV=production かつ MCP_AUTH_ENABLED!==true の場合、起動を失敗させる
+        // 回避オプション: MCP_ALLOW_INSECURE_PRODUCTION=true（非推奨）
+        (0, production_guard_1.assertProductionAuthEnabled)();
+        // 認証ミドルウェアを設定（環境変数で制御）
+        const authEnabled = process.env.MCP_AUTH_ENABLED === "true";
+        if (authEnabled) {
+            const authMiddleware = (0, auth_1.createAuthMiddleware)({
+                enabled: true,
+                publicTools: auth_1.PUBLIC_TOOLS,
+            });
+            (0, router_1.setAuthMiddleware)(authMiddleware);
+            logger_1.logger.info("[Main] Authentication middleware enabled");
+            logger_1.logger.info(`[Main] Public tools: ${auth_1.PUBLIC_TOOLS.join(", ")}`);
+        }
+        else {
+            logger_1.logger.info("[Main] Authentication middleware disabled (set MCP_AUTH_ENABLED=true to enable)");
+        }
+        // =====================================================
+        // ツール定義一致チェック（MCP-SSoT-02）
+        // =====================================================
+        // allToolDefinitions と toolHandlers の間で不一致がないか検証
+        // 手動二重管理による登録漏れを起動時に検出
+        const toolCheck = (0, tools_1.checkToolConsistency)();
+        if (!toolCheck.isConsistent) {
+            const errorMsgParts = ["Tool definition mismatch detected:"];
+            if (toolCheck.missingHandlers.length > 0) {
+                errorMsgParts.push(`Missing handlers: ${toolCheck.missingHandlers.join(", ")}`);
+            }
+            if (toolCheck.extraHandlers.length > 0) {
+                errorMsgParts.push(`Extra handlers: ${toolCheck.extraHandlers.join(", ")}`);
+            }
+            const errorMsg = errorMsgParts.join(" ");
+            if ((0, production_guard_1.isProductionEnvironment)()) {
+                logger_1.logger.error(`FATAL: ${errorMsg}`);
+                process.exit(1);
+            }
+            else {
+                logger_1.logger.warn(`[MCP-SSoT-02] ${errorMsg}`);
+            }
+        }
+        logger_1.logger.info(`[MCP-SSoT-02] Tool consistency check passed: ${toolCheck.definedTools.length} tools registered`);
+        // ツールハンドラーを登録
+        for (const [name, handler] of Object.entries(tools_1.toolHandlers)) {
+            (0, router_1.registerTool)(name, handler);
+        }
+        logger_1.logger.info(`Registered ${Object.keys(tools_1.toolHandlers).length} tools`);
+        // サーバーを作成
+        const server = (0, server_1.createServer)();
+        // トランスポートを作成（StdIO）
+        const transport = (0, transport_1.createTransport)();
+        // サーバーを起動（StdIO）
+        await (0, server_1.start)(server, transport);
+        logger_1.logger.info("StdIO transport is ready to accept connections");
+        logger_1.logger.info("MCP Server is ready (StdIO Mode)");
+        // プロセス終了シグナルのハンドリング
+        const handleShutdown = async () => {
+            logger_1.logger.info("Shutting down server...");
+            try {
+                // WorkerSupervisor を先にシャットダウン（3-Phase Shutdown Protocol）
+                // server.close() より前に実行し、ワーカーの graceful shutdown を確保する
+                try {
+                    const supervisor = (0, worker_supervisor_service_1.getWorkerSupervisor)();
+                    await supervisor.shutdown();
+                    logger_1.logger.info("WorkerSupervisor shutdown complete");
+                }
+                catch (supervisorError) {
+                    // WorkerSupervisor が未初期化（page.analyze未実行）の場合はエラーではない
+                    logger_1.logger.warn("WorkerSupervisor shutdown skipped or failed", {
+                        error: supervisorError instanceof Error ? supervisorError.message : String(supervisorError),
+                    });
+                }
+                // StdIO Serverを停止
+                await server.close();
+                logger_1.logger.info("StdIO transport shutdown complete");
+                logger_1.logger.info("MCP Server shutdown complete");
+                process.exit(0);
+            }
+            catch (error) {
+                logger_1.logger.error("Error during shutdown", error);
+                process.exit(1);
+            }
+        };
+        process.on("SIGINT", handleShutdown);
+        process.on("SIGTERM", handleShutdown);
+    }
+    catch (error) {
+        // ProductionAuthRequiredErrorの場合は既にログ出力済み
+        if (error instanceof production_guard_1.ProductionAuthRequiredError) {
+            process.exit(1);
+        }
+        logger_1.logger.error("Failed to start MCP server", error);
+        process.exit(1);
+    }
+}
+// エントリポイント
+main().catch((error) => {
+    logger_1.logger.error("Unhandled error in main", error);
+    process.exit(1);
+});
+// 公開API
+var server_2 = require("./server");
+Object.defineProperty(exports, "createServer", { enumerable: true, get: function () { return server_2.createServer; } });
+Object.defineProperty(exports, "start", { enumerable: true, get: function () { return server_2.start; } });
+var transport_2 = require("./transport");
+Object.defineProperty(exports, "createTransport", { enumerable: true, get: function () { return transport_2.createTransport; } });
+var errors_1 = require("./utils/errors");
+Object.defineProperty(exports, "ErrorCode", { enumerable: true, get: function () { return errors_1.ErrorCode; } });
+Object.defineProperty(exports, "McpError", { enumerable: true, get: function () { return errors_1.McpError; } });
+var logger_2 = require("./utils/logger");
+Object.defineProperty(exports, "Logger", { enumerable: true, get: function () { return logger_2.Logger; } });
+Object.defineProperty(exports, "logger", { enumerable: true, get: function () { return logger_2.logger; } });
+Object.defineProperty(exports, "createLogger", { enumerable: true, get: function () { return logger_2.createLogger; } });
+var router_2 = require("./router");
+Object.defineProperty(exports, "registerTool", { enumerable: true, get: function () { return router_2.registerTool; } });
+Object.defineProperty(exports, "handleToolCall", { enumerable: true, get: function () { return router_2.handleToolCall; } });
+Object.defineProperty(exports, "getRegisteredTools", { enumerable: true, get: function () { return router_2.getRegisteredTools; } });
+Object.defineProperty(exports, "setAuthMiddleware", { enumerable: true, get: function () { return router_2.setAuthMiddleware; } });
+Object.defineProperty(exports, "clearAuthMiddleware", { enumerable: true, get: function () { return router_2.clearAuthMiddleware; } });
+Object.defineProperty(exports, "getAuthMiddleware", { enumerable: true, get: function () { return router_2.getAuthMiddleware; } });
+Object.defineProperty(exports, "TOOL_NAMES", { enumerable: true, get: function () { return router_2.TOOL_NAMES; } });
+Object.defineProperty(exports, "ALL_TOOL_NAMES", { enumerable: true, get: function () { return router_2.ALL_TOOL_NAMES; } });
+var auth_2 = require("./middleware/auth");
+Object.defineProperty(exports, "createAuthMiddleware", { enumerable: true, get: function () { return auth_2.createAuthMiddleware; } });
+Object.defineProperty(exports, "validateApiKey", { enumerable: true, get: function () { return auth_2.validateApiKey; } });
+Object.defineProperty(exports, "checkPermission", { enumerable: true, get: function () { return auth_2.checkPermission; } });
+Object.defineProperty(exports, "PERMISSIONS", { enumerable: true, get: function () { return auth_2.PERMISSIONS; } });
+Object.defineProperty(exports, "ROLES", { enumerable: true, get: function () { return auth_2.ROLES; } });
+Object.defineProperty(exports, "TOOL_PERMISSIONS", { enumerable: true, get: function () { return auth_2.TOOL_PERMISSIONS; } });
+Object.defineProperty(exports, "PUBLIC_TOOLS", { enumerable: true, get: function () { return auth_2.PUBLIC_TOOLS; } });
+var service_client_1 = require("./services/service-client");
+Object.defineProperty(exports, "ServiceClient", { enumerable: true, get: function () { return service_client_1.ServiceClient; } });
+Object.defineProperty(exports, "serviceClient", { enumerable: true, get: function () { return service_client_1.serviceClient; } });
+Object.defineProperty(exports, "API_BASE_URL", { enumerable: true, get: function () { return service_client_1.API_BASE_URL; } });
+var web_page_service_2 = require("./services/web-page.service");
+Object.defineProperty(exports, "webPageService", { enumerable: true, get: function () { return web_page_service_2.webPageService; } });
+Object.defineProperty(exports, "createWebPageService", { enumerable: true, get: function () { return web_page_service_2.createWebPageService; } });
+var production_guard_2 = require("./services/production-guard");
+Object.defineProperty(exports, "assertProductionAuthEnabled", { enumerable: true, get: function () { return production_guard_2.assertProductionAuthEnabled; } });
+Object.defineProperty(exports, "isMcpAuthEnabled", { enumerable: true, get: function () { return production_guard_2.isMcpAuthEnabled; } });
+Object.defineProperty(exports, "isInsecureProductionAllowed", { enumerable: true, get: function () { return production_guard_2.isInsecureProductionAllowed; } });
+Object.defineProperty(exports, "isProductionEnvironment", { enumerable: true, get: function () { return production_guard_2.isProductionEnvironment; } });
+Object.defineProperty(exports, "ProductionAuthRequiredError", { enumerable: true, get: function () { return production_guard_2.ProductionAuthRequiredError; } });
+Object.defineProperty(exports, "ProductionGuardError", { enumerable: true, get: function () { return production_guard_2.ProductionGuardError; } });
+// ====================================================
+// Service Export Layer（外部モジュールから利用可能）
+// ====================================================
+var services_1 = require("./services");
+// Page Analyze
+Object.defineProperty(exports, "executePageAnalyze", { enumerable: true, get: function () { return services_1.executePageAnalyze; } });
+Object.defineProperty(exports, "sourceTypeSchema", { enumerable: true, get: function () { return services_1.sourceTypeSchema; } });
+Object.defineProperty(exports, "usageScopeSchema", { enumerable: true, get: function () { return services_1.usageScopeSchema; } });
+Object.defineProperty(exports, "waitUntilSchema", { enumerable: true, get: function () { return services_1.waitUntilSchema; } });
+Object.defineProperty(exports, "gradeSchema", { enumerable: true, get: function () { return services_1.gradeSchema; } });
+Object.defineProperty(exports, "pageAnalyzeInputSchema", { enumerable: true, get: function () { return services_1.pageAnalyzeInputSchema; } });
+Object.defineProperty(exports, "pageAnalyzeOutputSchema", { enumerable: true, get: function () { return services_1.pageAnalyzeOutputSchema; } });
+Object.defineProperty(exports, "analysisFeaturesSchema", { enumerable: true, get: function () { return services_1.analysisFeaturesSchema; } });
+Object.defineProperty(exports, "viewportSchema", { enumerable: true, get: function () { return services_1.viewportSchema; } });
+Object.defineProperty(exports, "layoutOptionsSchema", { enumerable: true, get: function () { return services_1.layoutOptionsSchema; } });
+Object.defineProperty(exports, "motionOptionsSchema", { enumerable: true, get: function () { return services_1.motionOptionsSchema; } });
+Object.defineProperty(exports, "qualityOptionsSchema", { enumerable: true, get: function () { return services_1.qualityOptionsSchema; } });
+Object.defineProperty(exports, "PAGE_ANALYZE_ERROR_CODES", { enumerable: true, get: function () { return services_1.PAGE_ANALYZE_ERROR_CODES; } });
+// Layout Search
+Object.defineProperty(exports, "executeLayoutSearch", { enumerable: true, get: function () { return services_1.executeLayoutSearch; } });
+// Motion Search
+Object.defineProperty(exports, "executeMotionSearch", { enumerable: true, get: function () { return services_1.executeMotionSearch; } });
+// Motion Detect
+Object.defineProperty(exports, "executeMotionDetect", { enumerable: true, get: function () { return services_1.executeMotionDetect; } });
+Object.defineProperty(exports, "resetMotionDetectService", { enumerable: true, get: function () { return services_1.resetMotionDetectService; } });
+// Quality Evaluate
+Object.defineProperty(exports, "executeQualityEvaluate", { enumerable: true, get: function () { return services_1.executeQualityEvaluate; } });
+Object.defineProperty(exports, "resetQualityEvaluateService", { enumerable: true, get: function () { return services_1.resetQualityEvaluateService; } });
+// Palette
+Object.defineProperty(exports, "executeGetPalette", { enumerable: true, get: function () { return services_1.executeGetPalette; } });
+// Layout Generate Code
+Object.defineProperty(exports, "executeLayoutGenerateCode", { enumerable: true, get: function () { return services_1.executeLayoutGenerateCode; } });
+Object.defineProperty(exports, "setPrismaClientFactory", { enumerable: true, get: function () { return services_1.setPrismaClientFactory; } });
+// ====================================================
+// Service Initializer Export（統合初期化API）
+// ====================================================
+var service_initializer_2 = require("./services/service-initializer");
+Object.defineProperty(exports, "initializeAllServices", { enumerable: true, get: function () { return service_initializer_2.initializeAllServices; } });
+Object.defineProperty(exports, "initializeMotionServices", { enumerable: true, get: function () { return service_initializer_2.initializeMotionServices; } });
+Object.defineProperty(exports, "initializeLayoutServices", { enumerable: true, get: function () { return service_initializer_2.initializeLayoutServices; } });
+Object.defineProperty(exports, "initializeQualityServices", { enumerable: true, get: function () { return service_initializer_2.initializeQualityServices; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/lib/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Lib module exports
+ * @module lib
+ */
+export { resolveProjectId, isValidUUIDv7, getDefaultProjectId } from "./project-context";
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAGA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/lib/index.js

@@ -0,0 +1,14 @@
+"use strict";
+// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
+// SPDX-License-Identifier: AGPL-3.0-only
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDefaultProjectId = exports.isValidUUIDv7 = exports.resolveProjectId = void 0;
+/**
+ * Lib module exports
+ * @module lib
+ */
+var project_context_1 = require("./project-context");
+Object.defineProperty(exports, "resolveProjectId", { enumerable: true, get: function () { return project_context_1.resolveProjectId; } });
+Object.defineProperty(exports, "isValidUUIDv7", { enumerable: true, get: function () { return project_context_1.isValidUUIDv7; } });
+Object.defineProperty(exports, "getDefaultProjectId", { enumerable: true, get: function () { return project_context_1.getDefaultProjectId; } });
+//# sourceMappingURL=index.js.map

package/dist/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":";AAAA,6DAA6D;AAC7D,yCAAyC;;;AAEzC;;;GAGG;AAEH,qDAAyF;AAAhF,mHAAA,gBAAgB,OAAA;AAAE,gHAAA,aAAa,OAAA;AAAE,sHAAA,mBAAmB,OAAA"}

package/dist/lib/project-context.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Validates if a string is a valid UUIDv7 format
+ *
+ * @param id - String to validate
+ * @returns true if valid UUIDv7 format, false otherwise
+ *
+ * @example
+ * ```typescript
+ * isValidUUIDv7('019acd22-c570-706c-8906-6c855874bc4d') // true
+ * isValidUUIDv7('not-a-uuid') // false
+ * isValidUUIDv7(null) // false
+ * ```
+ */
+export declare const isValidUUIDv7: (id: string | null | undefined) => boolean;
+/**
+ * Resolves project_id with automatic fallback to DEFAULT_PROJECT_ID
+ *
+ * Priority:
+ * 1. If inputProjectId is provided and valid, use it
+ * 2. If DEFAULT_PROJECT_ID env var is set and valid, use it
+ * 3. Otherwise, return undefined
+ *
+ * @param inputProjectId - Explicit project_id from tool input
+ * @returns Resolved project_id or undefined
+ *
+ * @example
+ * ```typescript
+ * // With explicit input
+ * resolveProjectId('019acd22-c570-706c-8906-6c855874bc4d')
+ * // Returns: '019acd22-c570-706c-8906-6c855874bc4d'
+ *
+ * // Without input, uses DEFAULT_PROJECT_ID from env
+ * process.env.DEFAULT_PROJECT_ID = '019acd22-c570-706c-8906-6c855874bc4d'
+ * resolveProjectId(undefined)
+ * // Returns: '019acd22-c570-706c-8906-6c855874bc4d'
+ *
+ * // Neither input nor env set
+ * delete process.env.DEFAULT_PROJECT_ID
+ * resolveProjectId(undefined)
+ * // Returns: undefined
+ * ```
+ */
+export declare const resolveProjectId: (inputProjectId?: string) => string | undefined;
+/**
+ * Gets the DEFAULT_PROJECT_ID from environment
+ * Useful for debugging and logging
+ *
+ * @returns DEFAULT_PROJECT_ID value or undefined
+ */
+export declare const getDefaultProjectId: () => string | undefined;
+//# sourceMappingURL=project-context.d.ts.map

package/dist/lib/project-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-context.d.ts","sourceRoot":"","sources":["../../src/lib/project-context.ts"],"names":[],"mappings":"AA2BA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,aAAa,GAAI,IAAI,MAAM,GAAG,IAAI,GAAG,SAAS,KAAG,OAK7D,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,gBAAgB,GAAI,iBAAiB,MAAM,KAAG,MAAM,GAAG,SAuBnE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,QAAO,MAAM,GAAG,SAE/C,CAAC"}