@gopherine/obsidian-mcp 0.1.1

package/dist/lib/session-registry.js

@@ -0,0 +1,230 @@
+import { readFile, writeFile, mkdir, unlink, stat, open } from "fs/promises";
+import { resolve, dirname } from "path";
+import { randomBytes } from "crypto";
+/**
+ * Manages the session registry for multi-agent coordination.
+ * Uses PID lockfiles for safe concurrent access.
+ */
+export class SessionRegistryManager {
+    ttlHours;
+    registryPath;
+    locksDir;
+    constructor(vaultPath, ttlHours) {
+        this.ttlHours = ttlHours;
+        this.registryPath = resolve(vaultPath, "coordination/session-registry.json");
+        this.locksDir = resolve(vaultPath, "coordination/locks");
+    }
+    /**
+     * Register a new session. Returns session ID and any conflicts.
+     */
+    async register(tool, project, taskSummary = null, filesTouched = []) {
+        const sessionId = `${tool}-${randomBytes(4).toString("hex")}`;
+        const now = new Date().toISOString();
+        const session = {
+            id: sessionId,
+            tool,
+            project,
+            task_summary: taskSummary,
+            files_touched: filesTouched,
+            started_at: now,
+            last_heartbeat: now,
+            completed_at: null,
+            status: "active",
+        };
+        return await this.withLock(async () => {
+            const registry = await this.readRegistry();
+            this.cleanStale(registry);
+            this.cleanOldCompleted(registry);
+            // Detect conflicts (use Set for O(n+m) intersection)
+            const conflicts = [];
+            if (filesTouched.length > 0) {
+                const touchedSet = new Set(filesTouched);
+                for (const existing of registry.sessions) {
+                    if (existing.status !== "active")
+                        continue;
+                    const overlap = existing.files_touched.filter((f) => touchedSet.has(f));
+                    if (overlap.length > 0) {
+                        conflicts.push({
+                            session_id: existing.id,
+                            tool: existing.tool,
+                            overlapping_files: overlap,
+                            task_summary: existing.task_summary,
+                        });
+                    }
+                }
+            }
+            registry.sessions.push(session);
+            await this.writeRegistry(registry);
+            return { session_id: sessionId, conflicts };
+        });
+    }
+    /**
+     * Update heartbeat for a session. Returns false if session not found.
+     */
+    async heartbeat(sessionId) {
+        return await this.withLock(async () => {
+            const registry = await this.readRegistry();
+            const session = registry.sessions.find((s) => s.id === sessionId);
+            if (!session)
+                return false;
+            session.last_heartbeat = new Date().toISOString();
+            await this.writeRegistry(registry);
+            return true;
+        });
+    }
+    /**
+     * Mark a session as completed.
+     */
+    async complete(sessionId, summary) {
+        await this.withLock(async () => {
+            const registry = await this.readRegistry();
+            const session = registry.sessions.find((s) => s.id === sessionId);
+            if (session) {
+                session.status = "completed";
+                session.completed_at = new Date().toISOString();
+                if (summary)
+                    session.task_summary = summary;
+            }
+            this.cleanOldCompleted(registry);
+            await this.writeRegistry(registry);
+        });
+    }
+    /**
+     * List active sessions. Persists stale status changes.
+     */
+    async listActive() {
+        return await this.withLock(async () => {
+            const registry = await this.readRegistry();
+            const hadStale = this.cleanStale(registry);
+            if (hadStale) {
+                await this.writeRegistry(registry);
+            }
+            return registry.sessions.filter((s) => s.status === "active");
+        });
+    }
+    cleanOldCompleted(registry) {
+        const cutoff = Date.now() - 24 * 60 * 60 * 1000;
+        registry.sessions = registry.sessions.filter((s) => {
+            if (s.status !== "completed")
+                return true;
+            const ts = s.completed_at ?? s.started_at;
+            if (typeof ts !== "string")
+                return false;
+            const time = new Date(ts).getTime();
+            return !isNaN(time) && time > cutoff;
+        });
+    }
+    cleanStale(registry) {
+        let changed = false;
+        const cutoff = Date.now() - this.ttlHours * 60 * 60 * 1000;
+        for (const session of registry.sessions) {
+            if (session.status === "active" &&
+                new Date(session.last_heartbeat).getTime() < cutoff) {
+                session.status = "stale";
+                changed = true;
+            }
+        }
+        return changed;
+    }
+    async readRegistry() {
+        try {
+            const raw = await readFile(this.registryPath, "utf-8");
+            const parsed = JSON.parse(raw);
+            // Schema validation: ensure sessions is an array of valid objects
+            if (!parsed || !Array.isArray(parsed.sessions)) {
+                return { sessions: [] };
+            }
+            // Filter out malformed entries
+            const validSessions = parsed.sessions.filter((s) => typeof s === "object" &&
+                s !== null &&
+                typeof s.id === "string" &&
+                typeof s.tool === "string" &&
+                typeof s.status === "string" &&
+                typeof s.started_at === "string" &&
+                typeof s.last_heartbeat === "string" &&
+                !isNaN(new Date(s.last_heartbeat).getTime()) &&
+                Array.isArray(s.files_touched));
+            return { sessions: validSessions };
+        }
+        catch (e) {
+            if (e?.code !== "ENOENT") {
+                console.error("[session-registry] Error reading registry:", e.message);
+            }
+            return { sessions: [] };
+        }
+    }
+    async writeRegistry(registry) {
+        await mkdir(dirname(this.registryPath), { recursive: true });
+        await writeFile(this.registryPath, JSON.stringify(registry, null, 2), "utf-8");
+    }
+    /**
+     * PID-based lockfile for safe concurrent writes.
+     * Times out after 2 seconds with retry.
+     */
+    async withLock(fn) {
+        const lockPath = resolve(this.locksDir, "session-registry.lock");
+        await mkdir(this.locksDir, { recursive: true });
+        const maxRetries = 8;
+        const retryDelay = 100;
+        for (let attempt = 0; attempt < maxRetries; attempt++) {
+            try {
+                const lockContent = JSON.stringify({
+                    pid: process.pid,
+                    tool: "obsidian-mcp",
+                    timestamp: new Date().toISOString(),
+                });
+                const fd = await open(lockPath, "wx");
+                try {
+                    await fd.write(Buffer.from(lockContent, "utf-8"));
+                }
+                finally {
+                    await fd.close();
+                }
+                // Lock acquired — run the function
+                try {
+                    return await fn();
+                }
+                finally {
+                    await unlink(lockPath).catch(() => { });
+                }
+            }
+            catch (e) {
+                if (e.code === "EEXIST") {
+                    // Lock exists — check if it's stale
+                    try {
+                        const lockStat = await stat(lockPath);
+                        const lockAge = Date.now() - lockStat.mtimeMs;
+                        if (lockAge > 5000) {
+                            // Lock is stale (>5s), force remove
+                            await unlink(lockPath).catch(() => { });
+                            continue;
+                        }
+                        // Lock is fresh — check if PID is alive
+                        const lockData = JSON.parse(await readFile(lockPath, "utf-8"));
+                        try {
+                            process.kill(lockData.pid, 0);
+                            // PID is alive — wait and retry
+                        }
+                        catch {
+                            // PID is dead — remove stale lock
+                            await unlink(lockPath).catch(() => { });
+                            continue;
+                        }
+                    }
+                    catch {
+                        // Can't read lock — try to remove it
+                        await unlink(lockPath).catch(() => { });
+                        continue;
+                    }
+                    // Wait before retrying
+                    await new Promise((r) => setTimeout(r, retryDelay));
+                }
+                else {
+                    throw e;
+                }
+            }
+        }
+        throw new Error("Failed to acquire lock after retries");
+    }
+}
+//# sourceMappingURL=session-registry.js.map

package/dist/lib/session-registry.js.map

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

package/dist/lib/session-registry.test.d.ts

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

package/dist/lib/session-registry.test.js

@@ -0,0 +1,199 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { mkdir, writeFile as fspWriteFile, rm, readFile as fspReadFile } from "fs/promises";
+import { tmpdir } from "os";
+import { join } from "path";
+import { SessionRegistryManager } from "./session-registry.js";
+describe("SessionRegistryManager", () => {
+    let vaultRoot;
+    let manager;
+    beforeEach(async () => {
+        vaultRoot = join(tmpdir(), `session-test-${Date.now()}-${Math.random().toString(36).slice(2)}`);
+        await mkdir(vaultRoot, { recursive: true });
+        manager = new SessionRegistryManager(vaultRoot, 1);
+    });
+    afterEach(async () => {
+        await rm(vaultRoot, { recursive: true, force: true });
+    });
+    describe("register", () => {
+        it("creates session with generated ID", async () => {
+            const result = await manager.register("claude-code", "test-project");
+            expect(result.session_id).toMatch(/^claude-code-[a-f0-9]{8}$/);
+        });
+        it("creates session with all fields", async () => {
+            const result = await manager.register("opencode", "my-project", "Doing work", ["file1.ts", "file2.ts"]);
+            expect(result.session_id).toMatch(/^opencode-/);
+        });
+        it("detects file conflicts", async () => {
+            await manager.register("claude-code", "proj", "Task 1", ["a.ts", "b.ts"]);
+            const result = await manager.register("opencode", "proj", "Task 2", ["b.ts", "c.ts"]);
+            expect(result.conflicts.length).toBe(1);
+            expect(result.conflicts[0].overlapping_files).toContain("b.ts");
+        });
+        it("returns empty conflicts when no overlap", async () => {
+            await manager.register("claude-code", "proj", "Task 1", ["a.ts"]);
+            const result = await manager.register("opencode", "proj", "Task 2", ["b.ts"]);
+            expect(result.conflicts).toEqual([]);
+        });
+        it("returns empty conflicts when first session has no files", async () => {
+            await manager.register("claude-code", "proj", "Task 1", []);
+            const result = await manager.register("opencode", "proj", "Task 2", ["b.ts"]);
+            expect(result.conflicts).toEqual([]);
+        });
+        it("cleans stale sessions on register", async () => {
+            const oldManager = new SessionRegistryManager(vaultRoot, 0);
+            await oldManager.register("claude-code", "proj", "Old session");
+            await new Promise(r => setTimeout(r, 10));
+            const newManager = new SessionRegistryManager(vaultRoot, 0.000001);
+            await newManager.register("opencode", "proj", "New session");
+            const active = await newManager.listActive();
+            expect(active.every(s => s.status === "active")).toBe(true);
+        });
+        it("persists session to registry file", async () => {
+            await manager.register("claude-code", "test-project");
+            const registryPath = join(vaultRoot, "coordination/session-registry.json");
+            const raw = await fspReadFile(registryPath, "utf-8");
+            const parsed = JSON.parse(raw);
+            expect(parsed.sessions.length).toBe(1);
+            expect(parsed.sessions[0].tool).toBe("claude-code");
+        });
+    });
+    describe("heartbeat", () => {
+        it("updates heartbeat timestamp", async () => {
+            const { session_id } = await manager.register("claude-code", "proj");
+            await new Promise(r => setTimeout(r, 10));
+            const result = await manager.heartbeat(session_id);
+            expect(result).toBe(true);
+        });
+        it("returns false for missing session", async () => {
+            const result = await manager.heartbeat("nonexistent-id");
+            expect(result).toBe(false);
+        });
+        it("persists heartbeat to file", async () => {
+            const { session_id } = await manager.register("claude-code", "proj");
+            await manager.heartbeat(session_id);
+            const registryPath = join(vaultRoot, "coordination/session-registry.json");
+            const raw = await fspReadFile(registryPath, "utf-8");
+            const parsed = JSON.parse(raw);
+            const session = parsed.sessions.find((s) => s.id === session_id);
+            expect(session.last_heartbeat).toBeDefined();
+        });
+    });
+    describe("complete", () => {
+        it("marks session as completed", async () => {
+            const { session_id } = await manager.register("claude-code", "proj");
+            await manager.complete(session_id);
+            const registryPath = join(vaultRoot, "coordination/session-registry.json");
+            const raw = await fspReadFile(registryPath, "utf-8");
+            const parsed = JSON.parse(raw);
+            const session = parsed.sessions.find((s) => s.id === session_id);
+            expect(session.status).toBe("completed");
+            expect(session.completed_at).toBeDefined();
+        });
+        it("updates task summary when provided", async () => {
+            const { session_id } = await manager.register("claude-code", "proj", "Old summary");
+            await manager.complete(session_id, "New summary");
+            const registryPath = join(vaultRoot, "coordination/session-registry.json");
+            const raw = await fspReadFile(registryPath, "utf-8");
+            const parsed = JSON.parse(raw);
+            const session = parsed.sessions.find((s) => s.id === session_id);
+            expect(session.task_summary).toBe("New summary");
+        });
+        it("removes old completed sessions", async () => {
+            const { session_id } = await manager.register("claude-code", "proj");
+            await manager.complete(session_id);
+            const registryPath = join(vaultRoot, "coordination/session-registry.json");
+            let raw = await fspReadFile(registryPath, "utf-8");
+            let parsed = JSON.parse(raw);
+            const session = parsed.sessions.find((s) => s.id === session_id);
+            session.completed_at = new Date(Date.now() - 25 * 60 * 60 * 1000).toISOString();
+            await fspWriteFile(registryPath, JSON.stringify(parsed));
+            await manager.register("opencode", "proj");
+            raw = await fspReadFile(registryPath, "utf-8");
+            parsed = JSON.parse(raw);
+            expect(parsed.sessions.find((s) => s.id === session_id)).toBeUndefined();
+        });
+    });
+    describe("listActive", () => {
+        it("returns only active sessions", async () => {
+            const { session_id } = await manager.register("claude-code", "proj");
+            await manager.register("opencode", "proj2");
+            await manager.complete(session_id);
+            const active = await manager.listActive();
+            expect(active.length).toBe(1);
+            expect(active[0].tool).toBe("opencode");
+        });
+        it("returns empty array when no active sessions", async () => {
+            const active = await manager.listActive();
+            expect(active).toEqual([]);
+        });
+        it("persists stale status changes", async () => {
+            const staleManager = new SessionRegistryManager(vaultRoot, 0.000001);
+            await staleManager.register("claude-code", "proj");
+            await new Promise(r => setTimeout(r, 20));
+            const active = await staleManager.listActive();
+            expect(active).toEqual([]);
+            const registryPath = join(vaultRoot, "coordination/session-registry.json");
+            const raw = await fspReadFile(registryPath, "utf-8");
+            const parsed = JSON.parse(raw);
+            expect(parsed.sessions[0].status).toBe("stale");
+        });
+    });
+    describe("withLock", () => {
+        it("prevents concurrent access", async () => {
+            const promises = [];
+            for (let i = 0; i < 5; i++) {
+                promises.push(manager.register(`tool-${i}`, "proj"));
+            }
+            const results = await Promise.all(promises);
+            expect(results.every(r => r.session_id)).toBe(true);
+            const registryPath = join(vaultRoot, "coordination/session-registry.json");
+            const raw = await fspReadFile(registryPath, "utf-8");
+            const parsed = JSON.parse(raw);
+            expect(parsed.sessions.length).toBe(5);
+        });
+        it("removes stale locks", async () => {
+            const locksDir = join(vaultRoot, "coordination/locks");
+            await mkdir(locksDir, { recursive: true });
+            const lockPath = join(locksDir, "session-registry.lock");
+            await fspWriteFile(lockPath, JSON.stringify({ pid: 999999999, timestamp: new Date().toISOString() }));
+            const { session_id } = await manager.register("claude-code", "proj");
+            expect(session_id).toBeDefined();
+        });
+    });
+    describe("readRegistry validation", () => {
+        it("handles malformed session entries", async () => {
+            const registryPath = join(vaultRoot, "coordination/session-registry.json");
+            await mkdir(join(vaultRoot, "coordination"), { recursive: true });
+            const now = new Date().toISOString();
+            const malformedData = {
+                sessions: [
+                    { id: "valid-1", tool: "test", status: "active", started_at: now, last_heartbeat: now, files_touched: [] },
+                    { id: 123, tool: "bad" },
+                    null,
+                    "string not object",
+                    { id: "valid-2", tool: "test", status: "active", started_at: "bad-date", last_heartbeat: "2024-01-01T00:00:00Z", files_touched: [] },
+                ]
+            };
+            await fspWriteFile(registryPath, JSON.stringify(malformedData));
+            const active = await manager.listActive();
+            const validIds = active.map(s => s.id);
+            expect(validIds).toContain("valid-1");
+            expect(validIds).not.toContain("valid-2");
+        });
+        it("handles non-array sessions field", async () => {
+            const registryPath = join(vaultRoot, "coordination/session-registry.json");
+            await mkdir(join(vaultRoot, "coordination"), { recursive: true });
+            await fspWriteFile(registryPath, JSON.stringify({ sessions: "not-an-array" }));
+            const active = await manager.listActive();
+            expect(active).toEqual([]);
+        });
+        it("handles missing sessions field", async () => {
+            const registryPath = join(vaultRoot, "coordination/session-registry.json");
+            await mkdir(join(vaultRoot, "coordination"), { recursive: true });
+            await fspWriteFile(registryPath, JSON.stringify({}));
+            const active = await manager.listActive();
+            expect(active).toEqual([]);
+        });
+    });
+});
+//# sourceMappingURL=session-registry.test.js.map

package/dist/lib/session-registry.test.js.map

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

package/dist/lib/skill-registry.d.ts

@@ -0,0 +1,13 @@
+import { SkillRegistry, InstalledSkill } from "../commands/skill/schema.js";
+export declare class SkillRegistryManager {
+    private readonly registryPath;
+    private readonly installedDir;
+    constructor(vaultPath: string);
+    read(): Promise<SkillRegistry>;
+    write(registry: SkillRegistry): Promise<void>;
+    add(skill: InstalledSkill): Promise<void>;
+    remove(name: string): Promise<boolean>;
+    get(name: string): Promise<InstalledSkill | undefined>;
+    list(): Promise<InstalledSkill[]>;
+    getInstalledPath(skillName: string): string;
+}

package/dist/lib/skill-registry.js

@@ -0,0 +1,76 @@
+import { readFile, writeFile, mkdir } from "fs/promises";
+import { resolve, dirname } from "path";
+export class SkillRegistryManager {
+    registryPath;
+    installedDir;
+    constructor(vaultPath) {
+        this.registryPath = resolve(vaultPath, "skills/registry.json");
+        this.installedDir = resolve(vaultPath, "skills/installed");
+    }
+    async read() {
+        try {
+            const raw = await readFile(this.registryPath, "utf-8");
+            const parsed = JSON.parse(raw);
+            if (!parsed || !Array.isArray(parsed.skills)) {
+                return { skills: [] };
+            }
+            const validSkills = parsed.skills.filter((s) => {
+                if (typeof s !== 'object' || s === null)
+                    return false;
+                const obj = s;
+                return (typeof obj.name === 'string' &&
+                    typeof obj.source === 'string' &&
+                    typeof obj.version === 'string' &&
+                    typeof obj.installed_at === 'string' &&
+                    typeof obj.updated_at === 'string' &&
+                    typeof obj.status === 'string' &&
+                    (obj.status === 'active' || obj.status === 'deprecated') &&
+                    typeof obj.auto_update === 'boolean');
+            });
+            return { skills: validSkills };
+        }
+        catch (e) {
+            if (e.code !== "ENOENT") {
+                console.error("[skill-registry] Error reading registry:", e.message);
+            }
+            return { skills: [] };
+        }
+    }
+    async write(registry) {
+        await mkdir(dirname(this.registryPath), { recursive: true });
+        await writeFile(this.registryPath, JSON.stringify(registry, null, 2), "utf-8");
+    }
+    async add(skill) {
+        const registry = await this.read();
+        const existingIndex = registry.skills.findIndex(s => s.name === skill.name);
+        if (existingIndex >= 0) {
+            registry.skills[existingIndex] = skill;
+        }
+        else {
+            registry.skills.push(skill);
+        }
+        await this.write(registry);
+    }
+    async remove(name) {
+        const registry = await this.read();
+        const index = registry.skills.findIndex(s => s.name === name);
+        if (index < 0) {
+            return false;
+        }
+        registry.skills.splice(index, 1);
+        await this.write(registry);
+        return true;
+    }
+    async get(name) {
+        const registry = await this.read();
+        return registry.skills.find(s => s.name === name);
+    }
+    async list() {
+        const registry = await this.read();
+        return registry.skills;
+    }
+    getInstalledPath(skillName) {
+        return resolve(this.installedDir, skillName, "SKILL.md");
+    }
+}
+//# sourceMappingURL=skill-registry.js.map

package/dist/lib/skill-registry.js.map

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

package/dist/lib/token-estimator.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Rough token estimation using chars/4 heuristic with a 15% safety margin.
+ *
+ * Accuracy notes:
+ * - English prose: typically within ±10%
+ * - Code-heavy content (short tokens like brackets, operators): may undercount by 20-30%
+ * - The 1.15 multiplier provides a safety buffer; actual tokenizer counts (e.g., tiktoken)
+ *   may differ significantly. For precise budgeting, use a proper tokenizer.
+ */
+export declare function estimateTokens(text: string): number;
+/**
+ * Truncate text to fit within a token budget.
+ * Truncates at the last section boundary (## heading) before the limit.
+ * Falls back to the last paragraph boundary, then last newline.
+ */
+export declare function truncateToTokenBudget(text: string, maxTokens: number): {
+    text: string;
+    truncated: boolean;
+};

package/dist/lib/token-estimator.js

@@ -0,0 +1,58 @@
+/**
+ * Rough token estimation using chars/4 heuristic with a 15% safety margin.
+ *
+ * Accuracy notes:
+ * - English prose: typically within ±10%
+ * - Code-heavy content (short tokens like brackets, operators): may undercount by 20-30%
+ * - The 1.15 multiplier provides a safety buffer; actual tokenizer counts (e.g., tiktoken)
+ *   may differ significantly. For precise budgeting, use a proper tokenizer.
+ */
+export function estimateTokens(text) {
+    return Math.ceil(text.length / 4 * 1.15);
+}
+/**
+ * Truncate text to fit within a token budget.
+ * Truncates at the last section boundary (## heading) before the limit.
+ * Falls back to the last paragraph boundary, then last newline.
+ */
+export function truncateToTokenBudget(text, maxTokens) {
+    const estimated = estimateTokens(text);
+    if (estimated <= maxTokens) {
+        return { text, truncated: false };
+    }
+    // Reserve ~20 tokens for the truncation suffix indicator
+    const reservedTokens = 20;
+    const effectiveBudget = Math.max(0, maxTokens - reservedTokens);
+    // Convert token budget to approximate character limit
+    const charLimit = Math.floor(effectiveBudget / 1.15 * 4);
+    // Try to cut at a section boundary
+    const truncated = text.slice(0, charLimit);
+    const lastSection = truncated.lastIndexOf("\n## ");
+    if (lastSection > charLimit * 0.5) {
+        return {
+            text: truncated.slice(0, lastSection) + "\n\n[truncated — use vault_project_context for full details]",
+            truncated: true,
+        };
+    }
+    // Fall back to paragraph boundary
+    const lastParagraph = truncated.lastIndexOf("\n\n");
+    if (lastParagraph > charLimit * 0.3) {
+        return {
+            text: truncated.slice(0, lastParagraph) + "\n\n[truncated — use vault_project_context for full details]",
+            truncated: true,
+        };
+    }
+    // Fall back to last newline
+    const lastNewline = truncated.lastIndexOf("\n");
+    if (lastNewline > 0) {
+        return {
+            text: truncated.slice(0, lastNewline) + "\n\n[truncated — use vault_project_context for full details]",
+            truncated: true,
+        };
+    }
+    return {
+        text: truncated + "\n\n[truncated — use vault_project_context for full details]",
+        truncated: true,
+    };
+}
+//# sourceMappingURL=token-estimator.js.map

package/dist/lib/token-estimator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-estimator.js","sourceRoot":"","sources":["../../src/lib/token-estimator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;AAC3C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,SAAiB;IACnE,MAAM,SAAS,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,SAAS,IAAI,SAAS,EAAE,CAAC;QAC3B,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACpC,CAAC;IAED,yDAAyD;IACzD,MAAM,cAAc,GAAG,EAAE,CAAC;IAC1B,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,cAAc,CAAC,CAAC;IAEhE,sDAAsD;IACtD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC;IAEzD,mCAAmC;IACnC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IAC3C,MAAM,WAAW,GAAG,SAAS,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACnD,IAAI,WAAW,GAAG,SAAS,GAAG,GAAG,EAAE,CAAC;QAClC,OAAO;YACL,IAAI,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,GAAG,8DAA8D;YACtG,SAAS,EAAE,IAAI;SAChB,CAAC;IACJ,CAAC;IAED,kCAAkC;IAClC,MAAM,aAAa,GAAG,SAAS,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IACpD,IAAI,aAAa,GAAG,SAAS,GAAG,GAAG,EAAE,CAAC;QACpC,OAAO;YACL,IAAI,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,aAAa,CAAC,GAAG,8DAA8D;YACxG,SAAS,EAAE,IAAI;SAChB,CAAC;IACJ,CAAC;IAED,4BAA4B;IAC5B,MAAM,WAAW,GAAG,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAChD,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;QACpB,OAAO;YACL,IAAI,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,GAAG,8DAA8D;YACtG,SAAS,EAAE,IAAI;SAChB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,SAAS,GAAG,8DAA8D;QAChF,SAAS,EAAE,IAAI;KAChB,CAAC;AACJ,CAAC"}