@reftrixmcp/mcp-server 0.1.7

package/dist/services/brief/schemas/brief-parser-schemas.js

@@ -0,0 +1,116 @@
+"use strict";
+// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
+// SPDX-License-Identifier: AGPL-3.0-only
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseOptionsSchema = exports.parsedBriefSchema = exports.requiredAssetSchema = exports.colorTokenSchema = exports.okExpressionSchema = exports.ngExpressionSchema = void 0;
+/**
+ * BriefParser Zodスキーマ定義
+ *
+ * DESIGN_BRIEF.mdのパース結果を表す型定義
+ *
+ * @module services/brief/schemas/brief-parser-schemas
+ */
+const zod_1 = require("zod");
+// =============================================================================
+// NG表現スキーマ
+// =============================================================================
+/**
+ * NG表現スキーマ
+ * Anti-AI Expression List や NG Examples から抽出される表現
+ */
+exports.ngExpressionSchema = zod_1.z.object({
+    /** NG表現のキーワード/パターン */
+    expression: zod_1.z.string().min(1),
+    /** なぜNGなのか */
+    reason: zod_1.z.string().min(1),
+    /** 代替表現（任意） */
+    alternative: zod_1.z.string().optional(),
+});
+// =============================================================================
+// OK表現スキーマ
+// =============================================================================
+/**
+ * OK表現スキーマ
+ * OK Examples から抽出される推奨表現
+ */
+exports.okExpressionSchema = zod_1.z.object({
+    /** OK表現のキーワード/パターン */
+    expression: zod_1.z.string().min(1),
+    /** なぜOKなのか */
+    reason: zod_1.z.string().min(1),
+});
+// =============================================================================
+// カラートークンスキーマ
+// =============================================================================
+/**
+ * カラートークンスキーマ
+ * Color Palette テーブルから抽出されるトークン
+ */
+exports.colorTokenSchema = zod_1.z.object({
+    /** トークン名（backtick除去済み） */
+    name: zod_1.z.string().min(1),
+    /** 役割（Background Primary等） */
+    role: zod_1.z.string().optional(),
+    /** HEXカラー値 */
+    hex: zod_1.z.string().regex(/^#[0-9A-Fa-f]{6}$/),
+    /** OKLCHカラー値（参照用） */
+    oklch: zod_1.z.string().optional(),
+    /** 使用用途 */
+    usage: zod_1.z.string().optional(),
+});
+// =============================================================================
+// 必要アセットスキーマ
+// =============================================================================
+/**
+ * 必要アセットスキーマ
+ * Asset Categories テーブルから抽出されるアセット要件
+ */
+exports.requiredAssetSchema = zod_1.z.object({
+    /** カテゴリ（icon, illustration等） */
+    category: zod_1.z.string().min(1),
+    /** 説明（Source列の内容） */
+    description: zod_1.z.string().min(1),
+    /** 検索クエリの提案（Usage列の内容） */
+    suggested_query: zod_1.z.string().optional(),
+});
+// =============================================================================
+// パース済みブリーフスキーマ
+// =============================================================================
+/**
+ * パース済みブリーフスキーマ
+ * BriefParserService.parse() の出力形式
+ */
+exports.parsedBriefSchema = zod_1.z.object({
+    /** プロジェクト名（H1見出しから抽出） */
+    project_name: zod_1.z.string(),
+    /** カラーパレット情報 */
+    color_palette: zod_1.z.object({
+        /** カラートークン配列 */
+        tokens: zod_1.z.array(exports.colorTokenSchema),
+        /** Reftrixに登録済みのパレットID（任意） */
+        palette_id: zod_1.z.string().uuid().optional(),
+    }),
+    /** NG表現リスト */
+    ng_expressions: zod_1.z.array(exports.ngExpressionSchema),
+    /** OK表現リスト */
+    ok_expressions: zod_1.z.array(exports.okExpressionSchema),
+    /** 必要アセットリスト */
+    required_assets: zod_1.z.array(exports.requiredAssetSchema),
+    /** パース元ファイルパス（任意） */
+    source_path: zod_1.z.string().optional(),
+    /** パース時刻（ISO 8601形式） */
+    parsed_at: zod_1.z.string().datetime(),
+});
+// =============================================================================
+// パースオプションスキーマ
+// =============================================================================
+/**
+ * パースオプションスキーマ
+ */
+exports.parseOptionsSchema = zod_1.z.object({
+    /** パース元のファイルパス（メタデータ用） */
+    sourcePath: zod_1.z.string().optional(),
+    /** 厳格モード: 必須セクションがない場合にエラー */
+    strict: zod_1.z.boolean().optional(),
+});
+//# sourceMappingURL=brief-parser-schemas.js.map

package/dist/services/brief/schemas/brief-parser-schemas.js.map

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

package/dist/services/browser-process-manager.d.ts

@@ -0,0 +1,116 @@
+/**
+ * BrowserProcessManager
+ *
+ * Playwrightブラウザプロセスの安全な終了と強制終了を管理するクラス
+ *
+ * WebGL重いサイト（Three.js使用サイト等）では、ブラウザがハングして
+ * Playwright APIでのclose()が効かない場合があります。
+ * このクラスは、タイムアウト時にブラウザプロセスを確実に強制終了する機能を提供します。
+ *
+ * ## 特徴
+ * - SIGTERM -> SIGKILL の順序でグレースフルシャットダウンを優先
+ * - プロセスが存在しない場合のエラー（ESRCH）を正常系として扱う
+ * - 子プロセス（レンダラー、GPU等）の一括終了もサポート（Linux）
+ *
+ * ## 使用例
+ * ```typescript
+ * const browser = await chromium.launch({ ... });
+ * const processManager = new BrowserProcessManager({
+ *   browser,
+ *   forceKillOnTimeout: true,
+ *   killGracePeriodMs: 5000,
+ * });
+ *
+ * // タイムアウト付きクローズ
+ * const closed = await processManager.closeWithTimeout(10000);
+ * if (!closed) {
+ *   console.warn('Browser close timed out, force killed');
+ * }
+ * ```
+ *
+ * @module services/browser-process-manager
+ */
+import { type Browser } from "playwright";
+/**
+ * BrowserProcessManager 設定オプション
+ */
+export interface BrowserProcessManagerOptions {
+    /** Playwrightブラウザインスタンス */
+    browser: Browser;
+    /** タイムアウト時にプロセスを強制終了するかどうか */
+    forceKillOnTimeout: boolean;
+    /** SIGTERM送信後、SIGKILLまでの待機時間（ms）。デフォルト: 5000ms */
+    killGracePeriodMs?: number;
+}
+/**
+ * ブラウザプロセス管理クラス
+ *
+ * Playwrightブラウザの安全な終了と、必要に応じた強制終了を担当
+ */
+export declare class BrowserProcessManager {
+    private browser;
+    private forceKillOnTimeout;
+    private killGracePeriodMs;
+    private browserPid;
+    /**
+     * コンストラクタ
+     *
+     * @param options - 設定オプション
+     */
+    constructor(options: BrowserProcessManagerOptions);
+    /**
+     * ブラウザプロセスのPIDを取得
+     *
+     * Playwrightの内部APIを使用してPIDを取得します。
+     * 内部APIが利用できない場合はnullを返します。
+     *
+     * @returns ブラウザプロセスのPID、または取得できない場合はnull
+     */
+    private getBrowserPid;
+    /**
+     * 安全なブラウザ終了を試みる
+     *
+     * まず通常のclose()を試行し、失敗した場合は
+     * forceKillOnTimeoutが有効であれば強制終了を行います。
+     */
+    safeClose(): Promise<void>;
+    /**
+     * タイムアウト付きブラウザクローズ
+     *
+     * 指定時間内にclose()が完了しない場合、タイムアウトとして扱い、
+     * forceKillOnTimeoutが有効であれば強制終了を行います。
+     *
+     * @param timeoutMs - タイムアウト時間（ms）
+     * @returns 正常に終了した場合true、タイムアウトまたは強制終了した場合false
+     */
+    closeWithTimeout(timeoutMs: number): Promise<boolean>;
+    /**
+     * プロセスを強制終了
+     *
+     * SIGTERM -> SIGKILL の順序でグレースフルシャットダウンを試みます。
+     * SIGTERMを送信後、killGracePeriodMs待機し、プロセスがまだ存在する場合は
+     * SIGKILLを送信します。
+     *
+     * プロセスが既に存在しない場合（ESRCH）は正常系として扱います。
+     */
+    forceKill(): Promise<void>;
+    /**
+     * プロセスが生存しているか確認
+     *
+     * signal 0を送信することでプロセスの存在を確認します。
+     * 成功すればプロセスが存在、ESRCHエラーならプロセスが存在しません。
+     *
+     * @returns プロセスが生存している場合true
+     */
+    private isProcessAlive;
+    /**
+     * 子プロセス（レンダラー、GPU等）も含めて全て終了
+     *
+     * Linuxではpkillを使用して、指定PIDの子プロセスも全て終了します。
+     * SIGTERM -> SIGKILL の順序で処理します。
+     *
+     * 注意: Windows対応は不要（Reftrixはリサンプル環境）
+     */
+    killAllChildren(): Promise<void>;
+}
+//# sourceMappingURL=browser-process-manager.d.ts.map

package/dist/services/browser-process-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-process-manager.d.ts","sourceRoot":"","sources":["../../src/services/browser-process-manager.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAQ1C;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,2BAA2B;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,8BAA8B;IAC9B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,kDAAkD;IAClD,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAgBD;;;;GAIG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,kBAAkB,CAAU;IACpC,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,UAAU,CAAuB;IAEzC;;;;OAIG;gBACS,OAAO,EAAE,4BAA4B;IAejD;;;;;;;OAOG;IACH,OAAO,CAAC,aAAa;IAYrB;;;;;OAKG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAyBhC;;;;;;;;OAQG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAiD3D;;;;;;;;OAQG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAoDhC;;;;;;;OAOG;IACH,OAAO,CAAC,cAAc;IAWtB;;;;;;;OAOG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;CAmCvC"}

package/dist/services/browser-process-manager.js

@@ -0,0 +1,259 @@
+"use strict";
+// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
+// SPDX-License-Identifier: AGPL-3.0-only
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrowserProcessManager = void 0;
+const child_process_1 = require("child_process");
+const logger_1 = require("../utils/logger");
+// =============================================
+// 定数
+// =============================================
+/**
+ * デフォルトのグレース期間（ms）
+ * SIGTERM送信後、プロセスが自発的に終了するまで待機する時間
+ */
+const DEFAULT_KILL_GRACE_PERIOD_MS = 5000;
+// =============================================
+// BrowserProcessManager クラス
+// =============================================
+/**
+ * ブラウザプロセス管理クラス
+ *
+ * Playwrightブラウザの安全な終了と、必要に応じた強制終了を担当
+ */
+class BrowserProcessManager {
+    browser;
+    forceKillOnTimeout;
+    killGracePeriodMs;
+    browserPid = null;
+    /**
+     * コンストラクタ
+     *
+     * @param options - 設定オプション
+     */
+    constructor(options) {
+        this.browser = options.browser;
+        this.forceKillOnTimeout = options.forceKillOnTimeout;
+        this.killGracePeriodMs = options.killGracePeriodMs ?? DEFAULT_KILL_GRACE_PERIOD_MS;
+        this.browserPid = this.getBrowserPid();
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.debug("[BrowserProcessManager] Initialized", {
+                pid: this.browserPid,
+                forceKillOnTimeout: this.forceKillOnTimeout,
+                killGracePeriodMs: this.killGracePeriodMs,
+            });
+        }
+    }
+    /**
+     * ブラウザプロセスのPIDを取得
+     *
+     * Playwrightの内部APIを使用してPIDを取得します。
+     * 内部APIが利用できない場合はnullを返します。
+     *
+     * @returns ブラウザプロセスのPID、または取得できない場合はnull
+     */
+    getBrowserPid() {
+        try {
+            // Playwrightの内部APIを使用
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const browserAny = this.browser;
+            const launchedProcess = browserAny._browserType?._launchedProcess;
+            return launchedProcess?.pid ?? null;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * 安全なブラウザ終了を試みる
+     *
+     * まず通常のclose()を試行し、失敗した場合は
+     * forceKillOnTimeoutが有効であれば強制終了を行います。
+     */
+    async safeClose() {
+        try {
+            // まず通常のclose()を試行
+            await this.browser.close();
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.debug("[BrowserProcessManager] browser.close() succeeded");
+            }
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.warn("[BrowserProcessManager] browser.close() failed", {
+                    error: errorMessage,
+                    forceKillOnTimeout: this.forceKillOnTimeout,
+                    pid: this.browserPid,
+                });
+            }
+            if (this.forceKillOnTimeout && this.browserPid) {
+                await this.forceKill();
+            }
+        }
+    }
+    /**
+     * タイムアウト付きブラウザクローズ
+     *
+     * 指定時間内にclose()が完了しない場合、タイムアウトとして扱い、
+     * forceKillOnTimeoutが有効であれば強制終了を行います。
+     *
+     * @param timeoutMs - タイムアウト時間（ms）
+     * @returns 正常に終了した場合true、タイムアウトまたは強制終了した場合false
+     */
+    async closeWithTimeout(timeoutMs) {
+        return new Promise((resolve) => {
+            let resolved = false;
+            const timeout = setTimeout(async () => {
+                if (resolved)
+                    return;
+                resolved = true;
+                if ((0, logger_1.isDevelopment)()) {
+                    logger_1.logger.warn(`[BrowserProcessManager] close() timed out after ${timeoutMs}ms`, {
+                        forceKillOnTimeout: this.forceKillOnTimeout,
+                        pid: this.browserPid,
+                    });
+                }
+                if (this.forceKillOnTimeout && this.browserPid) {
+                    await this.forceKill();
+                }
+                resolve(false);
+            }, timeoutMs);
+            this.browser
+                .close()
+                .then(() => {
+                if (resolved)
+                    return;
+                resolved = true;
+                clearTimeout(timeout);
+                if ((0, logger_1.isDevelopment)()) {
+                    logger_1.logger.debug("[BrowserProcessManager] close() completed within timeout");
+                }
+                resolve(true);
+            })
+                .catch(async () => {
+                if (resolved)
+                    return;
+                resolved = true;
+                clearTimeout(timeout);
+                if (this.forceKillOnTimeout && this.browserPid) {
+                    await this.forceKill();
+                }
+                resolve(false);
+            });
+        });
+    }
+    /**
+     * プロセスを強制終了
+     *
+     * SIGTERM -> SIGKILL の順序でグレースフルシャットダウンを試みます。
+     * SIGTERMを送信後、killGracePeriodMs待機し、プロセスがまだ存在する場合は
+     * SIGKILLを送信します。
+     *
+     * プロセスが既に存在しない場合（ESRCH）は正常系として扱います。
+     */
+    async forceKill() {
+        if (!this.browserPid) {
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.warn("[BrowserProcessManager] No PID available for force kill");
+            }
+            return;
+        }
+        try {
+            // SIGTERM を送信（グレースフルシャットダウン試行）
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.debug(`[BrowserProcessManager] Sending SIGTERM to PID ${this.browserPid}`);
+            }
+            process.kill(this.browserPid, "SIGTERM");
+            // グレースフルシャットダウンを待機
+            await new Promise((resolve) => setTimeout(resolve, this.killGracePeriodMs));
+            // プロセスがまだ存在するか確認
+            if (this.isProcessAlive()) {
+                // SIGKILL を送信（強制終了）
+                if ((0, logger_1.isDevelopment)()) {
+                    logger_1.logger.warn(`[BrowserProcessManager] SIGTERM failed, sending SIGKILL to PID ${this.browserPid}`);
+                }
+                process.kill(this.browserPid, "SIGKILL");
+            }
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.info(`[BrowserProcessManager] Successfully killed browser process PID ${this.browserPid}`);
+            }
+        }
+        catch (error) {
+            // ESRCH: プロセスが存在しない（既に終了している）
+            const errnoError = error;
+            if (errnoError.code !== "ESRCH") {
+                if ((0, logger_1.isDevelopment)()) {
+                    logger_1.logger.error("[BrowserProcessManager] forceKill error", {
+                        error: error instanceof Error ? error.message : String(error),
+                        pid: this.browserPid,
+                    });
+                }
+            }
+            else if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.debug(`[BrowserProcessManager] Process ${this.browserPid} already terminated (ESRCH)`);
+            }
+        }
+    }
+    /**
+     * プロセスが生存しているか確認
+     *
+     * signal 0を送信することでプロセスの存在を確認します。
+     * 成功すればプロセスが存在、ESRCHエラーならプロセスが存在しません。
+     *
+     * @returns プロセスが生存している場合true
+     */
+    isProcessAlive() {
+        if (!this.browserPid)
+            return false;
+        try {
+            process.kill(this.browserPid, 0); // シグナル0はプロセス存在確認
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * 子プロセス（レンダラー、GPU等）も含めて全て終了
+     *
+     * Linuxではpkillを使用して、指定PIDの子プロセスも全て終了します。
+     * SIGTERM -> SIGKILL の順序で処理します。
+     *
+     * 注意: Windows対応は不要（Reftrixはリサンプル環境）
+     */
+    async killAllChildren() {
+        if (!this.browserPid)
+            return;
+        try {
+            // Linuxではpkillを使用して子プロセスも終了
+            if (process.platform === "linux") {
+                if ((0, logger_1.isDevelopment)()) {
+                    logger_1.logger.debug(`[BrowserProcessManager] Killing child processes of PID ${this.browserPid}`);
+                }
+                // SEC-H3: execSync with PID interpolation
+                // セキュリティ: browserPidはPlaywright内部API由来のnumber型であり、
+                // ユーザー入力を含まない。コマンドインジェクションのリスクは存在しない。
+                // stdio: デフォルト（pipe）のため、子プロセス出力は親に流れない。
+                (0, child_process_1.execSync)(`pkill -TERM -P ${this.browserPid} || true`);
+                // 待機
+                await new Promise((resolve) => setTimeout(resolve, 1000));
+                // SIGKILL を子プロセスに送信
+                (0, child_process_1.execSync)(`pkill -KILL -P ${this.browserPid} || true`);
+                if ((0, logger_1.isDevelopment)()) {
+                    logger_1.logger.debug("[BrowserProcessManager] Child processes killed");
+                }
+            }
+        }
+        catch (error) {
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.error("[BrowserProcessManager] killAllChildren error", {
+                    error: error instanceof Error ? error.message : String(error),
+                    pid: this.browserPid,
+                });
+            }
+        }
+    }
+}
+exports.BrowserProcessManager = BrowserProcessManager;
+//# sourceMappingURL=browser-process-manager.js.map

package/dist/services/browser-process-manager.js.map

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

package/dist/services/cache.d.ts

@@ -0,0 +1,119 @@
+/**
+ * キャッシュ統計情報の型定義
+ */
+export interface CacheStats {
+    hits: number;
+    misses: number;
+    hitRate: number;
+    size: number;
+    maxSize: number;
+}
+/**
+ * LRUキャッシュの設定オプション
+ */
+interface LRUCacheOptions {
+    maxSize: number;
+    ttlMs: number;
+}
+/**
+ * LRUキャッシュクラス
+ * 最も長くアクセスされていないエントリから削除する
+ */
+export declare class LRUCache<T> {
+    private cache;
+    private maxSize;
+    private defaultTTL;
+    private hits;
+    private misses;
+    constructor(options: LRUCacheOptions);
+    /**
+     * キャッシュから値を取得
+     * @param key キャッシュキー
+     * @returns 値が存在すれば値、なければundefined
+     */
+    get(key: string): T | undefined;
+    /**
+     * キャッシュに値を設定
+     * @param key キャッシュキー
+     * @param value 保存する値
+     * @param ttlMs オプションのTTL（ミリ秒）
+     */
+    set(key: string, value: T, ttlMs?: number): void;
+    /**
+     * キーが存在するかチェック（期限切れは無視）
+     * @param key キャッシュキー
+     * @returns 存在すればtrue
+     */
+    has(key: string): boolean;
+    /**
+     * キャッシュからエントリを削除
+     * @param key キャッシュキー
+     * @returns 削除成功ならtrue
+     */
+    delete(key: string): boolean;
+    /**
+     * キャッシュをクリア
+     */
+    clear(): void;
+    /**
+     * 現在のキャッシュサイズを取得
+     * @returns キャッシュサイズ
+     */
+    size(): number;
+    /**
+     * ヒット率を取得
+     * @returns ヒット率（0-1）
+     */
+    getHitRate(): number;
+    /**
+     * キャッシュ統計を取得
+     * @returns キャッシュ統計情報
+     */
+    getStats(): CacheStats;
+    /**
+     * LRUエントリを削除（最も長くアクセスされていないエントリ）
+     */
+    private evictLRU;
+    /**
+     * エントリが期限切れかチェック
+     * @param entry キャッシュエントリ
+     * @returns 期限切れならtrue
+     */
+    private isExpired;
+}
+/**
+ * 検索結果の型定義
+ */
+export interface SearchResult {
+    id: string;
+    name: string;
+    embedding?: number[];
+    similarity?: number;
+    metadata?: Record<string, unknown>;
+}
+export declare class SearchCache extends LRUCache<SearchResult[]> {
+    constructor(options: LRUCacheOptions);
+    /**
+     * クエリからキャッシュキーを生成
+     * @param query 検索クエリ
+     * @param filters オプションのフィルター
+     * @returns ハッシュ化されたキー
+     */
+    generateKey(query: string, filters?: Record<string, unknown>): string;
+}
+export declare class EmbeddingCache extends LRUCache<number[]> {
+    constructor(options: LRUCacheOptions);
+    /**
+     * テキストからキャッシュキーを生成
+     * @param text テキスト
+     * @returns ハッシュ化されたキー
+     */
+    generateKey(text: string): string;
+}
+/**
+ * シングルトンインスタンス
+ */
+export declare const searchCache: SearchCache;
+export declare const embeddingCache: EmbeddingCache;
+export {};
+//# sourceMappingURL=cache.d.ts.map

package/dist/services/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/services/cache.ts"],"names":[],"mappings":"AA2BA;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,UAAU,eAAe;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,qBAAa,QAAQ,CAAC,CAAC;IACrB,OAAO,CAAC,KAAK,CAAyC;IACtD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,MAAM,CAAa;gBAEf,OAAO,EAAE,eAAe;IAUpC;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IA2B/B;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAwBhD;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAazB;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAQ5B;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;;OAGG;IACH,IAAI,IAAI,MAAM;IAId;;;OAGG;IACH,UAAU,IAAI,MAAM;IAKpB;;;OAGG;IACH,QAAQ,IAAI,UAAU;IAUtB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAShB;;;;OAIG;IACH,OAAO,CAAC,SAAS;CAGlB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAQD,qBAAa,WAAY,SAAQ,QAAQ,CAAC,YAAY,EAAE,CAAC;gBAC3C,OAAO,EAAE,eAAe;IAKpC;;;;;OAKG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;CAKtE;AAQD,qBAAa,cAAe,SAAQ,QAAQ,CAAC,MAAM,EAAE,CAAC;gBACxC,OAAO,EAAE,eAAe;IAKpC;;;;OAIG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAIlC;AAED;;GAEG;AAGH,eAAO,MAAM,WAAW,aAGtB,CAAC;AAGH,eAAO,MAAM,cAAc,gBAGzB,CAAC"}