@nxuss/lemma 0.2.1 → 0.3.0

package/dist/esm/proxy/KeyManager.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Lemma KeyManager
+ *
+ * Handles Pro license key lifecycle:
+ * - Activation via remote validation (https://lemma.nxus.studio/api/v1/validate)
+ * - Graceful fallback to local format check when endpoint is unreachable
+ * - Persistence to ~/.lemma-cache/license.json
+ * - Auto-migration from legacy license.key format
+ *
+ * TODO(v0.4.0): Replace HTTP validate call with direct PostgreSQL check.
+ */
+export interface LicenseData {
+    key: string;
+    tier: 'pro' | 'free';
+    isPro: boolean;
+    activatedAt: string;
+    expiresAt?: string;
+    validatedRemotely: boolean;
+    email?: string;
+}
+export interface ActivationResult {
+    success: boolean;
+    isPro: boolean;
+    message: string;
+    license?: LicenseData;
+    validatedRemotely: boolean;
+}
+export declare class KeyManager {
+    private license;
+    constructor();
+    isPro(): boolean;
+    getLicenseKey(): string | null;
+    getLicense(): LicenseData | null;
+    /**
+     * Activate a license key.
+     * Attempts remote validation first; falls back to format-check if unreachable.
+     */
+    activate(key: string): Promise<ActivationResult>;
+    /**
+     * Deactivate / remove the current license.
+     */
+    deactivate(): void;
+    /**
+     * Reload license from disk (used after activate from another process).
+     */
+    reload(): void;
+    private load;
+    private save;
+    private ensureCacheDir;
+    /**
+     * POST to https://lemma.nxus.studio/api/v1/validate with a timeout.
+     * Returns the JSON response body.
+     */
+    private validateRemote;
+}
+//# sourceMappingURL=KeyManager.d.ts.map

package/dist/esm/proxy/KeyManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KeyManager.d.ts","sourceRoot":"","sources":["../../../src/proxy/KeyManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAiBH,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC;IACrB,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAID,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAA4B;;IAS3C,KAAK,IAAI,OAAO;IAYhB,aAAa,IAAI,MAAM,GAAG,IAAI;IAI9B,UAAU,IAAI,WAAW,GAAG,IAAI;IAIhC;;;OAGG;IACG,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA0DtD;;OAEG;IACH,UAAU,IAAI,IAAI;IAOlB;;OAEG;IACH,MAAM,IAAI,IAAI;IAMd,OAAO,CAAC,IAAI;IAoCZ,OAAO,CAAC,IAAI;IASZ,OAAO,CAAC,cAAc;IAMtB;;;OAGG;IACH,OAAO,CAAC,cAAc;CAyCvB"}

package/dist/esm/proxy/KeyManager.js

@@ -0,0 +1,213 @@
+/**
+ * Lemma KeyManager
+ *
+ * Handles Pro license key lifecycle:
+ * - Activation via remote validation (https://lemma.nxus.studio/api/v1/validate)
+ * - Graceful fallback to local format check when endpoint is unreachable
+ * - Persistence to ~/.lemma-cache/license.json
+ * - Auto-migration from legacy license.key format
+ *
+ * TODO(v0.4.0): Replace HTTP validate call with direct PostgreSQL check.
+ */
+import fs from 'fs';
+import path from 'path';
+import https from 'https';
+// ─── Constants ────────────────────────────────────────────────────────────────
+const CACHE_DIR = path.join(process.env.HOME || process.env.USERPROFILE || '~', '.lemma-cache');
+const LICENSE_FILE = path.join(CACHE_DIR, 'license.json');
+const LEGACY_LICENSE_FILE = path.join(CACHE_DIR, 'license.key');
+const VALIDATE_URL = 'https://lemma.nxus.studio/api/v1/validate';
+const VALIDATE_TIMEOUT_MS = 5000;
+const KEY_FORMAT_REGEX = /^LEMMA-PRO-[A-Z0-9]{4}-[A-Z0-9]{4}-[A-Z0-9]{4}$/;
+// ─── KeyManager ───────────────────────────────────────────────────────────────
+export class KeyManager {
+    constructor() {
+        this.license = null;
+        this.ensureCacheDir();
+        this.license = this.load();
+    }
+    // ── Public API ──────────────────────────────────────────────────────────────
+    isPro() {
+        if (!this.license)
+            return false;
+        if (!this.license.isPro)
+            return false;
+        // Check expiry if set
+        if (this.license.expiresAt) {
+            if (Date.now() > new Date(this.license.expiresAt).getTime()) {
+                return false;
+            }
+        }
+        return true;
+    }
+    getLicenseKey() {
+        return this.license?.key || null;
+    }
+    getLicense() {
+        return this.license;
+    }
+    /**
+     * Activate a license key.
+     * Attempts remote validation first; falls back to format-check if unreachable.
+     */
+    async activate(key) {
+        // Basic format validation first
+        if (!KEY_FORMAT_REGEX.test(key.trim())) {
+            return {
+                success: false,
+                isPro: false,
+                validatedRemotely: false,
+                message: `Invalid key format. Pro keys look like: LEMMA-PRO-XXXX-XXXX-XXXX`,
+            };
+        }
+        // Attempt remote validation
+        let validatedRemotely = false;
+        let remoteData = null;
+        try {
+            remoteData = await this.validateRemote(key.trim());
+            validatedRemotely = true;
+            if (!remoteData.valid) {
+                return {
+                    success: false,
+                    isPro: false,
+                    validatedRemotely: true,
+                    message: remoteData.reason || 'License key is not valid.',
+                };
+            }
+        }
+        catch (err) {
+            // Network/endpoint unavailable — fall back to local format check
+            console.warn(`[KeyManager] Remote validation unavailable: ${err.message}`);
+            console.warn(`[KeyManager] Falling back to local format validation.`);
+        }
+        // Build and persist license
+        const license = {
+            key: key.trim(),
+            tier: 'pro',
+            isPro: true,
+            activatedAt: new Date().toISOString(),
+            validatedRemotely,
+            expiresAt: remoteData?.expiresAt,
+            email: remoteData?.email,
+        };
+        this.license = license;
+        this.save(license);
+        return {
+            success: true,
+            isPro: true,
+            validatedRemotely,
+            message: validatedRemotely
+                ? `✅ Lemma Pro activated (server-verified). Semantic Mode enabled.`
+                : `✅ Lemma Pro activated (format-validated, server offline). Semantic Mode enabled.`,
+            license,
+        };
+    }
+    /**
+     * Deactivate / remove the current license.
+     */
+    deactivate() {
+        this.license = null;
+        if (fs.existsSync(LICENSE_FILE)) {
+            fs.unlinkSync(LICENSE_FILE);
+        }
+    }
+    /**
+     * Reload license from disk (used after activate from another process).
+     */
+    reload() {
+        this.license = this.load();
+    }
+    // ── Private helpers ─────────────────────────────────────────────────────────
+    load() {
+        // Try new JSON format
+        if (fs.existsSync(LICENSE_FILE)) {
+            try {
+                const data = JSON.parse(fs.readFileSync(LICENSE_FILE, 'utf8'));
+                if (data.key && data.isPro)
+                    return data;
+            }
+            catch {
+                // Corrupt file — ignore
+            }
+        }
+        // Migrate from legacy format
+        if (fs.existsSync(LEGACY_LICENSE_FILE)) {
+            try {
+                const legacy = JSON.parse(fs.readFileSync(LEGACY_LICENSE_FILE, 'utf8'));
+                if (legacy.key && (legacy.isPro || legacy.tier === 'pro')) {
+                    const migrated = {
+                        key: legacy.key,
+                        tier: 'pro',
+                        isPro: true,
+                        activatedAt: legacy.activatedAt || new Date().toISOString(),
+                        validatedRemotely: false,
+                    };
+                    this.save(migrated);
+                    fs.unlinkSync(LEGACY_LICENSE_FILE); // Remove legacy file
+                    console.log('[KeyManager] Migrated license from legacy format.');
+                    return migrated;
+                }
+            }
+            catch {
+                // Ignore
+            }
+        }
+        return null;
+    }
+    save(license) {
+        try {
+            this.ensureCacheDir();
+            fs.writeFileSync(LICENSE_FILE, JSON.stringify(license, null, 2));
+        }
+        catch (err) {
+            console.error(`[KeyManager] Failed to save license: ${err.message}`);
+        }
+    }
+    ensureCacheDir() {
+        if (!fs.existsSync(CACHE_DIR)) {
+            fs.mkdirSync(CACHE_DIR, { recursive: true });
+        }
+    }
+    /**
+     * POST to https://lemma.nxus.studio/api/v1/validate with a timeout.
+     * Returns the JSON response body.
+     */
+    validateRemote(key) {
+        return new Promise((resolve, reject) => {
+            const body = JSON.stringify({ key });
+            const url = new URL(VALIDATE_URL);
+            const options = {
+                hostname: url.hostname,
+                port: url.port || 443,
+                path: url.pathname,
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Content-Length': Buffer.byteLength(body),
+                    'User-Agent': 'lemma-proxy/0.3.0',
+                },
+            };
+            const req = https.request(options, (res) => {
+                let data = '';
+                res.on('data', (chunk) => { data += chunk; });
+                res.on('end', () => {
+                    try {
+                        resolve(JSON.parse(data));
+                    }
+                    catch {
+                        reject(new Error(`Invalid JSON response from validate endpoint`));
+                    }
+                });
+            });
+            req.on('error', reject);
+            const timer = setTimeout(() => {
+                req.destroy();
+                reject(new Error(`Validation endpoint timed out after ${VALIDATE_TIMEOUT_MS}ms`));
+            }, VALIDATE_TIMEOUT_MS);
+            req.on('close', () => clearTimeout(timer));
+            req.write(body);
+            req.end();
+        });
+    }
+}
+//# sourceMappingURL=KeyManager.js.map

package/dist/esm/proxy/KeyManager.js.map

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

package/dist/esm/proxy/ProjectStore.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Lemma ProjectStore
+ *
+ * Project-aware storage resolver:
+ * - Detects project identity from package.json → cwd basename fallback
+ * - Hashes project name to a 12-char hex prefix for path safety
+ * - Provides Stats and Usage persistence helpers
+ *
+ * Layout:
+ *   ~/.lemma-cache/
+ *     proxy.pid
+ *     proxy.port
+ *     stats.json          (global, cross-project)
+ *     usage.json          (global free-tier counter)
+ *     license.json        (KeyManager)
+ *     <12-char hash>/     (per-project)
+ *       cache.db          (future SQLite)
+ *       project-stats.json
+ */
+export declare const CACHE_DIR: string;
+export declare const PID_FILE: string;
+export declare const PORT_FILE: string;
+export declare const STATS_FILE: string;
+export declare const USAGE_FILE: string;
+export declare const FREE_TIER_LIMIT = 300;
+export declare const WARNING_THRESHOLD = 0.8;
+export interface ProjectInfo {
+    name: string;
+    hash: string;
+    cacheDir: string;
+    dbFile: string;
+    statsFile: string;
+}
+export interface ProjectStats {
+    total: number;
+    hits: number;
+    misses: number;
+    totalLatency: number;
+    totalTokensSaved: number;
+    providers: Record<string, {
+        hits: number;
+        misses: number;
+    }>;
+}
+export interface UsageRecord {
+    count: number;
+    lastReset: string;
+    history: Array<{
+        month: string;
+        count: number;
+    }>;
+}
+export declare class ProjectStore {
+    private project;
+    private stats;
+    private usage;
+    constructor(overrideName?: string);
+    getProject(): ProjectInfo;
+    private resolveProject;
+    private detectProjectName;
+    getStats(): Record<string, ProjectStats>;
+    getProjectStats(): ProjectStats;
+    recordRequest(opts: {
+        fromCache: boolean;
+        latencyMs: number;
+        provider: string;
+        tokensSaved?: number;
+    }): void;
+    private emptyProjectStats;
+    private loadStats;
+    saveStats(): void;
+    getUsage(): UsageRecord;
+    incrementUsage(): void;
+    checkUsageLimit(): {
+        allowed: boolean;
+        warning?: string;
+        remaining: number;
+    };
+    getNextResetDate(): string;
+    private loadUsage;
+    saveUsage(override?: UsageRecord): void;
+    private ensureCacheDir;
+}
+//# sourceMappingURL=ProjectStore.d.ts.map

package/dist/esm/proxy/ProjectStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectStore.d.ts","sourceRoot":"","sources":["../../../src/proxy/ProjectStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AASH,eAAO,MAAM,SAAS,QAAkC,CAAC;AACzD,eAAO,MAAM,QAAQ,QAAoC,CAAC;AAC1D,eAAO,MAAM,SAAS,QAAqC,CAAC;AAC5D,eAAO,MAAM,UAAU,QAAqC,CAAC;AAC7D,eAAO,MAAM,UAAU,QAAqC,CAAC;AAE7D,eAAO,MAAM,eAAe,MAAM,CAAC;AACnC,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAIrC,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClD;AAID,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,KAAK,CAAc;gBAEf,YAAY,CAAC,EAAE,MAAM;IASjC,UAAU,IAAI,WAAW;IAIzB,OAAO,CAAC,cAAc;IAwBtB,OAAO,CAAC,iBAAiB;IAkBzB,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC;IAIxC,eAAe,IAAI,YAAY;IAI/B,aAAa,CAAC,IAAI,EAAE;QAClB,SAAS,EAAE,OAAO,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,IAAI;IA4BR,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,SAAS;IAWjB,SAAS,IAAI,IAAI;IAUjB,QAAQ,IAAI,WAAW;IAIvB,cAAc,IAAI,IAAI;IAUtB,eAAe,IAAI;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;IAuB5E,gBAAgB,IAAI,MAAM;IAK1B,OAAO,CAAC,SAAS;IAwBjB,SAAS,CAAC,QAAQ,CAAC,EAAE,WAAW,GAAG,IAAI;IAUvC,OAAO,CAAC,cAAc;CAKvB"}

package/dist/esm/proxy/ProjectStore.js

@@ -0,0 +1,207 @@
+/**
+ * Lemma ProjectStore
+ *
+ * Project-aware storage resolver:
+ * - Detects project identity from package.json → cwd basename fallback
+ * - Hashes project name to a 12-char hex prefix for path safety
+ * - Provides Stats and Usage persistence helpers
+ *
+ * Layout:
+ *   ~/.lemma-cache/
+ *     proxy.pid
+ *     proxy.port
+ *     stats.json          (global, cross-project)
+ *     usage.json          (global free-tier counter)
+ *     license.json        (KeyManager)
+ *     <12-char hash>/     (per-project)
+ *       cache.db          (future SQLite)
+ *       project-stats.json
+ */
+import fs from 'fs';
+import path from 'path';
+import crypto from 'crypto';
+// ─── Constants ────────────────────────────────────────────────────────────────
+const HOME = process.env.HOME || process.env.USERPROFILE || '~';
+export const CACHE_DIR = path.join(HOME, '.lemma-cache');
+export const PID_FILE = path.join(CACHE_DIR, 'proxy.pid');
+export const PORT_FILE = path.join(CACHE_DIR, 'proxy.port');
+export const STATS_FILE = path.join(CACHE_DIR, 'stats.json');
+export const USAGE_FILE = path.join(CACHE_DIR, 'usage.json');
+export const FREE_TIER_LIMIT = 300; // queries per month
+export const WARNING_THRESHOLD = 0.8; // warn at 80%
+// ─── ProjectStore ─────────────────────────────────────────────────────────────
+export class ProjectStore {
+    constructor(overrideName) {
+        this.ensureCacheDir();
+        this.project = this.resolveProject(overrideName);
+        this.stats = this.loadStats();
+        this.usage = this.loadUsage();
+    }
+    // ── Project Resolution ──────────────────────────────────────────────────────
+    getProject() {
+        return this.project;
+    }
+    resolveProject(overrideName) {
+        const name = overrideName || this.detectProjectName();
+        const hash = crypto.createHash('sha1').update(name).digest('hex').slice(0, 12);
+        const dir = path.join(CACHE_DIR, hash);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        // Write a human-readable marker inside the hash dir
+        const markerFile = path.join(dir, 'project-name.txt');
+        if (!fs.existsSync(markerFile)) {
+            fs.writeFileSync(markerFile, name);
+        }
+        return {
+            name,
+            hash,
+            cacheDir: dir,
+            dbFile: path.join(dir, 'cache.db'),
+            statsFile: path.join(dir, 'project-stats.json'),
+        };
+    }
+    detectProjectName() {
+        const cwd = process.cwd();
+        const pkgPath = path.join(cwd, 'package.json');
+        if (fs.existsSync(pkgPath)) {
+            try {
+                const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+                if (pkg.name)
+                    return pkg.name;
+            }
+            catch {
+                // Ignore parse errors
+            }
+        }
+        return path.basename(cwd);
+    }
+    // ── Stats ───────────────────────────────────────────────────────────────────
+    getStats() {
+        return this.stats;
+    }
+    getProjectStats() {
+        return this.stats[this.project.name] || this.emptyProjectStats();
+    }
+    recordRequest(opts) {
+        if (!this.stats[this.project.name]) {
+            this.stats[this.project.name] = this.emptyProjectStats();
+        }
+        const s = this.stats[this.project.name];
+        s.total++;
+        s.totalLatency += opts.latencyMs;
+        if (opts.fromCache) {
+            s.hits++;
+            s.totalTokensSaved += opts.tokensSaved || 0;
+        }
+        else {
+            s.misses++;
+        }
+        if (!s.providers[opts.provider]) {
+            s.providers[opts.provider] = { hits: 0, misses: 0 };
+        }
+        if (opts.fromCache) {
+            s.providers[opts.provider].hits++;
+        }
+        else {
+            s.providers[opts.provider].misses++;
+        }
+        this.saveStats();
+    }
+    emptyProjectStats() {
+        return { total: 0, hits: 0, misses: 0, totalLatency: 0, totalTokensSaved: 0, providers: {} };
+    }
+    loadStats() {
+        try {
+            if (fs.existsSync(STATS_FILE)) {
+                return JSON.parse(fs.readFileSync(STATS_FILE, 'utf8'));
+            }
+        }
+        catch {
+            // Ignore
+        }
+        return {};
+    }
+    saveStats() {
+        try {
+            fs.writeFileSync(STATS_FILE, JSON.stringify(this.stats, null, 2));
+        }
+        catch {
+            // Ignore
+        }
+    }
+    // ── Usage (Free Tier) ───────────────────────────────────────────────────────
+    getUsage() {
+        return this.usage;
+    }
+    incrementUsage() {
+        this.usage.count++;
+        this.saveUsage();
+        if (this.usage.count === Math.floor(FREE_TIER_LIMIT * WARNING_THRESHOLD)) {
+            console.log(`\n⚠️  Free tier: ${this.usage.count}/${FREE_TIER_LIMIT} queries used this month`);
+            console.log(`💡 Upgrade to Pro: https://lemma.nxus.studio/upgrade\n`);
+        }
+    }
+    checkUsageLimit() {
+        const remaining = FREE_TIER_LIMIT - this.usage.count;
+        if (remaining <= 0) {
+            return {
+                allowed: false,
+                remaining: 0,
+                warning: `Free tier limit reached (${FREE_TIER_LIMIT}/month). Upgrade: https://lemma.nxus.studio/upgrade`,
+            };
+        }
+        const percentUsed = this.usage.count / FREE_TIER_LIMIT;
+        if (percentUsed >= WARNING_THRESHOLD) {
+            return {
+                allowed: true,
+                remaining,
+                warning: `Approaching free tier limit: ${remaining} queries remaining.`,
+            };
+        }
+        return { allowed: true, remaining };
+    }
+    getNextResetDate() {
+        const now = new Date();
+        return new Date(now.getFullYear(), now.getMonth() + 1, 1).toISOString();
+    }
+    loadUsage() {
+        try {
+            if (fs.existsSync(USAGE_FILE)) {
+                const u = JSON.parse(fs.readFileSync(USAGE_FILE, 'utf8'));
+                // Check if we need to reset (new month)
+                const now = new Date();
+                const lastReset = new Date(u.lastReset || 0);
+                if (now.getMonth() !== lastReset.getMonth() || now.getFullYear() !== lastReset.getFullYear()) {
+                    const newRecord = {
+                        count: 0,
+                        lastReset: now.toISOString(),
+                        history: [...(u.history || []), { month: lastReset.toISOString().slice(0, 7), count: u.count }],
+                    };
+                    this.saveUsage(newRecord);
+                    return newRecord;
+                }
+                return u;
+            }
+        }
+        catch {
+            // Ignore
+        }
+        return { count: 0, lastReset: new Date().toISOString(), history: [] };
+    }
+    saveUsage(override) {
+        try {
+            fs.writeFileSync(USAGE_FILE, JSON.stringify(override || this.usage, null, 2));
+        }
+        catch {
+            // Ignore
+        }
+    }
+    // ── Utilities ───────────────────────────────────────────────────────────────
+    ensureCacheDir() {
+        if (!fs.existsSync(CACHE_DIR)) {
+            fs.mkdirSync(CACHE_DIR, { recursive: true });
+        }
+    }
+}
+//# sourceMappingURL=ProjectStore.js.map

package/dist/esm/proxy/ProjectStore.js.map

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

package/dist/esm/proxy/SseRelay.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Lemma SseRelay
+ *
+ * Handles Server-Sent Events (SSE) streaming in two modes:
+ *
+ * MISS mode: Pipes upstream SSE response from OpenAI/Anthropic to the client
+ *            in real-time (transparent relay).
+ *
+ * HIT mode:  Simulates an SSE stream from a cached response by chunking the
+ *            text into ~5-word pieces and emitting them with a small delay.
+ *            Visually identical to a real stream for IDEs like Cursor.
+ *
+ * Both modes:
+ *   - Set correct SSE headers (text/event-stream, no-cache)
+ *   - Inject X-Lemma-Cache, X-Lemma-Similarity, X-Lemma-Tier headers
+ *   - Append the `data: [DONE]` sentinel
+ *   - Support both OpenAI and Anthropic SSE envelope formats
+ */
+import { Request, Response } from 'express';
+export type Provider = 'openai' | 'anthropic';
+export interface SseRelayOptions {
+    provider: Provider;
+    tier: 'standard' | 'pro';
+    similarity?: number;
+    latencyMs?: number;
+}
+export declare class SseRelay {
+    /**
+     * Simulate an SSE stream from a cached response.
+     */
+    static simulateHit(res: Response, cachedResponse: any, opts: SseRelayOptions): Promise<void>;
+    /**
+     * Relay a live upstream SSE stream transparently.
+     */
+    static relayMiss(req: Request, res: Response, upstreamBody: any, provider: Provider, opts: SseRelayOptions): Promise<void>;
+    private static setSseHeaders;
+    private static buildUpstreamRequest;
+    private static buildChunkEvent;
+    private static extractTextFromResponse;
+}
+//# sourceMappingURL=SseRelay.d.ts.map

package/dist/esm/proxy/SseRelay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SseRelay.d.ts","sourceRoot":"","sources":["../../../src/proxy/SseRelay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAS5C,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC;AAE9C,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,EAAE,UAAU,GAAG,KAAK,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID,qBAAa,QAAQ;IACnB;;OAEG;WACU,WAAW,CACtB,GAAG,EAAE,QAAQ,EACb,cAAc,EAAE,GAAG,EACnB,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,IAAI,CAAC;IAuBhB;;OAEG;WACU,SAAS,CACpB,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,QAAQ,EACb,YAAY,EAAE,GAAG,EACjB,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,IAAI,CAAC;IA0DhB,OAAO,CAAC,MAAM,CAAC,aAAa;IAa5B,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAmBnC,OAAO,CAAC,MAAM,CAAC,eAAe;IA+B9B,OAAO,CAAC,MAAM,CAAC,uBAAuB;CAevC"}