@kenkaiiii/ggcoder 5.26.2 → 5.27.0

package/dist/core/foreign-session-import.test.js

@@ -0,0 +1,220 @@
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { detectForeignFormat, importForeignSession, parseForeignTranscript, } from "./foreign-session-import.js";
+import { extractCursorUserQuery } from "./foreign-transcript-blocks.js";
+import { APP_MARKER_CUSTOM_KIND, SessionManager } from "./session-manager.js";
+const FIXTURES = path.join(path.dirname(fileURLToPath(import.meta.url)), "__fixtures__");
+const FIXTURE_FILE = {
+    claude: path.join(FIXTURES, "claude-transcript.jsonl"),
+    codex: path.join(FIXTURES, "codex-transcript.jsonl"),
+    cursor: path.join(FIXTURES, "cursor-transcript.jsonl"),
+};
+async function parseFixture(format) {
+    return parseForeignTranscript(await fs.readFile(FIXTURE_FILE[format], "utf-8"));
+}
+function assistantParts(message) {
+    if (!message || message.role !== "assistant")
+        throw new Error("expected an assistant message");
+    return message.content;
+}
+function allText(messages) {
+    return JSON.stringify(messages);
+}
+describe("detectForeignFormat", () => {
+    it("identifies each format from its record shapes", async () => {
+        for (const format of ["claude", "codex", "cursor"]) {
+            const text = await fs.readFile(FIXTURE_FILE[format], "utf-8");
+            expect(detectForeignFormat(text)).toBe(format);
+        }
+    });
+    it("returns undefined for an unrelated JSONL file", () => {
+        expect(detectForeignFormat('{"hello":"world"}\n{"a":1}')).toBeUndefined();
+    });
+    it("throws a clear error when asked to parse an unknown format", () => {
+        expect(() => parseForeignTranscript('{"hello":"world"}')).toThrow(/Unrecognized transcript/);
+    });
+});
+describe("Claude Code import", () => {
+    it("maps prompts, thinking, tool calls and tool results", async () => {
+        const result = await parseFixture("claude");
+        expect(result.cwd).toBe("/Users/dev/widgets");
+        expect(result.preview).toBe("Add a retry to the fetch helper.");
+        expect(result.messages.map((m) => m.role)).toEqual(["user", "assistant", "tool", "assistant"]);
+        const parts = assistantParts(result.messages[1]);
+        expect(Array.isArray(parts)).toBe(true);
+        expect(parts.map((p) => p.type)).toEqual([
+            "thinking",
+            "text",
+            "tool_call",
+        ]);
+        const toolMessage = result.messages[2];
+        expect(toolMessage?.role).toBe("tool");
+        if (toolMessage?.role === "tool") {
+            expect(toolMessage.content[0]?.toolCallId).toBe("toolu_1");
+            expect(toolMessage.content[0]?.content).toContain("export async function get");
+        }
+    });
+    it("skips sidechain (subagent) records", async () => {
+        const result = await parseFixture("claude");
+        expect(allText(result.messages)).not.toContain("subagent chatter");
+    });
+    it("drops an orphan tool result rather than inventing a pairing", async () => {
+        const result = await parseFixture("claude");
+        expect(allText(result.messages)).not.toContain("no matching call");
+        expect(result.dropped.toolResults).toBe(1);
+    });
+    it("counts unparseable lines instead of failing the import", async () => {
+        const result = await parseFixture("claude");
+        expect(result.dropped.records).toBe(1);
+    });
+});
+describe("Codex import", () => {
+    it("maps the conversation without duplicating event_msg mirrors", async () => {
+        const result = await parseFixture("codex");
+        expect(result.cwd).toBe("/Users/dev/widgets");
+        expect(result.preview).toBe("Why is the build slow?");
+        expect(result.messages.map((m) => m.role)).toEqual(["user", "assistant", "tool", "assistant"]);
+        // "Why is the build slow?" appears in both an event_msg and a response_item.
+        const userMessages = result.messages.filter((m) => m.role === "user");
+        expect(userMessages).toHaveLength(1);
+    });
+    it("skips Codex's own harness context turns", async () => {
+        const result = await parseFixture("codex");
+        expect(allText(result.messages)).not.toContain("permissions instructions");
+    });
+    it("parses a JSON-string function_call into structured args", async () => {
+        const result = await parseFixture("codex");
+        const parts = assistantParts(result.messages[1]);
+        const call = parts.find((part) => part.type === "tool_call");
+        expect(call?.args).toEqual({ command: ["bash", "-lc", "cat tsup.config.ts"] });
+    });
+});
+describe("Cursor import", () => {
+    it("strips recognized context wrappers from the user query", async () => {
+        const result = await parseFixture("cursor");
+        expect(result.preview).toBe("Rename the Button component to IconButton.");
+        expect(result.preview).not.toContain("cursor_commands");
+        expect(result.preview).not.toContain("<timestamp>");
+    });
+    it("carries no wrapper text anywhere in the imported messages", async () => {
+        const result = await parseFixture("cursor");
+        const serialized = allText(result.messages);
+        expect(serialized).not.toContain("<cursor_commands>");
+        expect(serialized).not.toContain("<timestamp>");
+        expect(serialized).not.toContain("user opened src/index.ts");
+    });
+    it("keeps a message with unrecognized leading context intact", async () => {
+        const result = await parseFixture("cursor");
+        const users = result.messages.filter((m) => m.role === "user");
+        expect(users[1]?.content).toContain("<mystery_context>");
+        expect(users[1]?.content).toContain("Now add a size prop.");
+    });
+    it("pairs tool calls with their results", async () => {
+        const result = await parseFixture("cursor");
+        const toolMessage = result.messages.find((m) => m.role === "tool");
+        expect(toolMessage?.role).toBe("tool");
+        if (toolMessage?.role === "tool") {
+            expect(toolMessage.content[0]?.toolCallId).toBe("tc_1");
+            expect(toolMessage.content[0]?.content).toBe("1 file changed");
+        }
+    });
+    it("normalizes second-precision timestamps to millis", async () => {
+        const result = await parseFixture("cursor");
+        expect(result.startedAt).toBe(1784544000 * 1000);
+    });
+});
+describe("extractCursorUserQuery", () => {
+    it("returns plain text unchanged", () => {
+        expect(extractCursorUserQuery("just a prompt")).toBe("just a prompt");
+    });
+    it("unwraps a bare user_query", () => {
+        expect(extractCursorUserQuery("<user_query>hello</user_query>")).toBe("hello");
+    });
+    it("refuses to truncate unknown leading context", () => {
+        const raw = "<unknown>ctx</unknown>\n<user_query>hi</user_query>";
+        expect(extractCursorUserQuery(raw)).toBe(raw);
+    });
+    it("leaves an unterminated wrapper alone", () => {
+        const raw = "<cursor_commands>oops\n<user_query>hi</user_query>";
+        expect(extractCursorUserQuery(raw)).toBe(raw);
+    });
+});
+describe("importForeignSession", () => {
+    let root;
+    let sessionManager;
+    beforeEach(async () => {
+        root = await fs.mkdtemp(path.join(os.tmpdir(), "gg-import-"));
+        sessionManager = new SessionManager(path.join(root, "sessions"));
+    });
+    afterEach(async () => {
+        await fs.rm(root, { recursive: true, force: true });
+    });
+    it("writes a resumable session that round-trips through the normal loader", async () => {
+        const imported = await importForeignSession({
+            filePath: FIXTURE_FILE.claude,
+            sessionManager,
+            provider: "anthropic",
+            model: "claude-sonnet-5",
+        });
+        expect(imported.cwd).toBe("/Users/dev/widgets");
+        expect(imported.messageCount).toBe(4);
+        const loaded = await sessionManager.load(imported.sessionPath);
+        expect(loaded).not.toBeNull();
+        expect(loaded.header.cwd).toBe("/Users/dev/widgets");
+        expect(loaded.header.preview).toBe("Add a retry to the fetch helper.");
+        const messages = sessionManager.getMessages(loaded.entries, loaded.header.leafId);
+        expect(messages.map((m) => m.role)).toEqual(["user", "assistant", "tool", "assistant"]);
+    });
+    it("records an import marker naming the source and what was dropped", async () => {
+        const imported = await importForeignSession({
+            filePath: FIXTURE_FILE.claude,
+            sessionManager,
+            provider: "anthropic",
+            model: "claude-sonnet-5",
+        });
+        const loaded = await sessionManager.load(imported.sessionPath);
+        const markers = sessionManager.getAppMarkers(loaded.entries, loaded.header.leafId);
+        const importMarker = markers.find((marker) => marker.kind === "import");
+        expect(importMarker).toBeDefined();
+        expect(importMarker?.data.source).toBe("claude");
+        expect(String(importMarker?.data.dropped)).toContain("tool result");
+        // The marker must stay OFF the message DAG so the model never sees it.
+        const custom = loaded.entries.filter((entry) => entry.type === "custom" && entry.kind === APP_MARKER_CUSTOM_KIND);
+        expect(custom).toHaveLength(1);
+        expect(custom[0]?.parentId).toBeNull();
+    });
+    it("imports a Cursor thread with no wrapper text in its preview", async () => {
+        const imported = await importForeignSession({
+            filePath: FIXTURE_FILE.cursor,
+            sessionManager,
+            provider: "anthropic",
+            model: "claude-sonnet-5",
+        });
+        expect(imported.preview).toBe("Rename the Button component to IconButton.");
+        const loaded = await sessionManager.load(imported.sessionPath);
+        expect(loaded.header.preview).not.toContain("cursor_commands");
+        expect(loaded.header.preview).not.toContain("<timestamp>");
+    });
+    it("prefers an explicit cwd over the one recorded by the source agent", async () => {
+        const imported = await importForeignSession({
+            filePath: FIXTURE_FILE.codex,
+            sessionManager,
+            provider: "anthropic",
+            model: "claude-sonnet-5",
+            cwd: "/Users/dev/elsewhere",
+        });
+        expect(imported.cwd).toBe("/Users/dev/elsewhere");
+    });
+    it("fails clearly on a missing file", async () => {
+        await expect(importForeignSession({
+            filePath: path.join(root, "nope.jsonl"),
+            sessionManager,
+            provider: "anthropic",
+            model: "claude-sonnet-5",
+        })).rejects.toThrow(/Could not read transcript/);
+    });
+});
+//# sourceMappingURL=foreign-session-import.test.js.map

package/dist/core/foreign-session-import.test.js.map

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

package/dist/core/foreign-transcript-blocks.d.ts

@@ -0,0 +1,51 @@
+import type { ContentPart, TextContent, ToolCall } from "@kenkaiiii/gg-ai";
+/**
+ * Primitives shared by every foreign-transcript parser (Claude Code, Codex,
+ * Cursor): content-block normalization, tool-call extraction and timestamps.
+ *
+ * The formats differ in their envelopes but agree on the substance — text,
+ * thinking, tool calls and tool results — so the per-format parsers stay thin
+ * and the risky normalization lives in exactly one place.
+ */
+/** Loose JSON object guard; foreign records are untrusted input. */
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export declare function asString(value: unknown): string | undefined;
+/** Parse one JSONL line, returning undefined for blank or malformed lines. */
+export declare function parseJsonLine(line: string): Record<string, unknown> | undefined;
+/**
+ * Normalize a record's timestamp to epoch millis. Foreign formats use ISO
+ * strings (Claude, Codex) or numeric epochs in seconds or millis (Cursor).
+ * Returns undefined rather than guessing when the value is unusable.
+ */
+export declare function normalizeTimestamp(value: unknown): number | undefined;
+/** Collapse a text block list into one string, dropping empties. */
+export declare function joinText(parts: readonly string[]): string;
+export declare function textPart(text: string): TextContent;
+/**
+ * Build a tool-call part from a foreign record. `args` may arrive as an object
+ * (Claude `input`) or a JSON string (Codex `arguments`); an unparseable string
+ * is preserved verbatim under `raw` rather than dropped, so a resumed thread
+ * still shows what was attempted.
+ */
+export declare function toolCallPart(id: string, name: string, args: unknown): ToolCall;
+export declare function normalizeToolArgs(args: unknown): Record<string, unknown>;
+/**
+ * Flatten a foreign tool result into plain text. Import is lossy by design: we
+ * never fabricate structure we did not read, so anything that is not text
+ * becomes a short placeholder instead of an invented block.
+ */
+export declare function toolResultText(content: unknown): string;
+/** Drop empty text parts so an import never produces a blank message. */
+export declare function compactParts(parts: ContentPart[]): ContentPart[];
+/**
+ * Extract the real prompt from a Cursor user message.
+ *
+ * Cursor wraps the typed prompt in `<user_query>` and prepends context blocks
+ * (`<cursor_commands>`, `<timestamp>`, …). Importing the raw string leaks that
+ * scaffolding into the session preview and title. We take the trailing
+ * `<user_query>` only when everything before it is recognized context;
+ * otherwise the message is returned unchanged, because unknown leading context
+ * may be part of what the user actually said.
+ */
+export declare function extractCursorUserQuery(raw: string): string;
+//# sourceMappingURL=foreign-transcript-blocks.d.ts.map

package/dist/core/foreign-transcript-blocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"foreign-transcript-blocks.d.ts","sourceRoot":"","sources":["../../src/core/foreign-transcript-blocks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE3E;;;;;;;GAOG;AAEH,oEAAoE;AACpE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAE3D;AAED,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAS/E;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CASrE;AAED,oEAAoE;AACpE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAKzD;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAElD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,QAAQ,CAE9E;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUxE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAkBvD;AAED,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,CAIhE;AAYD;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM1D"}

package/dist/core/foreign-transcript-blocks.js

@@ -0,0 +1,151 @@
+/**
+ * Primitives shared by every foreign-transcript parser (Claude Code, Codex,
+ * Cursor): content-block normalization, tool-call extraction and timestamps.
+ *
+ * The formats differ in their envelopes but agree on the substance — text,
+ * thinking, tool calls and tool results — so the per-format parsers stay thin
+ * and the risky normalization lives in exactly one place.
+ */
+/** Loose JSON object guard; foreign records are untrusted input. */
+export function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export function asString(value) {
+    return typeof value === "string" ? value : undefined;
+}
+/** Parse one JSONL line, returning undefined for blank or malformed lines. */
+export function parseJsonLine(line) {
+    const trimmed = line.trim();
+    if (!trimmed)
+        return undefined;
+    try {
+        const parsed = JSON.parse(trimmed);
+        return isRecord(parsed) ? parsed : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Normalize a record's timestamp to epoch millis. Foreign formats use ISO
+ * strings (Claude, Codex) or numeric epochs in seconds or millis (Cursor).
+ * Returns undefined rather than guessing when the value is unusable.
+ */
+export function normalizeTimestamp(value) {
+    if (typeof value === "number" && Number.isFinite(value)) {
+        // Anything below ~1e12 is seconds, not millis (1e12 ms ≈ 2001-09-09).
+        return value < 1e12 ? Math.round(value * 1000) : Math.round(value);
+    }
+    const text = asString(value);
+    if (!text)
+        return undefined;
+    const parsed = Date.parse(text);
+    return Number.isNaN(parsed) ? undefined : parsed;
+}
+/** Collapse a text block list into one string, dropping empties. */
+export function joinText(parts) {
+    return parts
+        .map((part) => part.trim())
+        .filter(Boolean)
+        .join("\n\n");
+}
+export function textPart(text) {
+    return { type: "text", text };
+}
+/**
+ * Build a tool-call part from a foreign record. `args` may arrive as an object
+ * (Claude `input`) or a JSON string (Codex `arguments`); an unparseable string
+ * is preserved verbatim under `raw` rather than dropped, so a resumed thread
+ * still shows what was attempted.
+ */
+export function toolCallPart(id, name, args) {
+    return { type: "tool_call", id, name, args: normalizeToolArgs(args) };
+}
+export function normalizeToolArgs(args) {
+    if (isRecord(args))
+        return args;
+    const text = asString(args);
+    if (text === undefined)
+        return {};
+    try {
+        const parsed = JSON.parse(text);
+        return isRecord(parsed) ? parsed : { raw: text };
+    }
+    catch {
+        return { raw: text };
+    }
+}
+/**
+ * Flatten a foreign tool result into plain text. Import is lossy by design: we
+ * never fabricate structure we did not read, so anything that is not text
+ * becomes a short placeholder instead of an invented block.
+ */
+export function toolResultText(content) {
+    const direct = asString(content);
+    if (direct !== undefined)
+        return direct;
+    if (Array.isArray(content)) {
+        const parts = [];
+        for (const item of content) {
+            if (!isRecord(item))
+                continue;
+            const text = asString(item.text);
+            if (text !== undefined)
+                parts.push(text);
+            else if (item.type === "image")
+                parts.push("[image omitted on import]");
+        }
+        return joinText(parts);
+    }
+    if (isRecord(content)) {
+        const text = asString(content.text) ?? asString(content.output);
+        if (text !== undefined)
+            return text;
+    }
+    return "";
+}
+/** Drop empty text parts so an import never produces a blank message. */
+export function compactParts(parts) {
+    return parts.filter((part) => !((part.type === "text" || part.type === "thinking") && !part.text.trim()));
+}
+/**
+ * Context wrappers Cursor prepends to a user turn before the real prompt.
+ * Each is stripped only when it sits before a trailing `<user_query>`; a
+ * message carrying context we do NOT recognize is left completely intact
+ * rather than silently truncated.
+ */
+const RECOGNIZED_CURSOR_WRAPPERS = ["cursor_commands", "timestamp", "additional_data"];
+const USER_QUERY_RE = /<user_query>([\s\S]*)<\/user_query>\s*$/;
+/**
+ * Extract the real prompt from a Cursor user message.
+ *
+ * Cursor wraps the typed prompt in `<user_query>` and prepends context blocks
+ * (`<cursor_commands>`, `<timestamp>`, …). Importing the raw string leaks that
+ * scaffolding into the session preview and title. We take the trailing
+ * `<user_query>` only when everything before it is recognized context;
+ * otherwise the message is returned unchanged, because unknown leading context
+ * may be part of what the user actually said.
+ */
+export function extractCursorUserQuery(raw) {
+    const match = USER_QUERY_RE.exec(raw);
+    if (!match)
+        return raw;
+    const lead = raw.slice(0, match.index).trim();
+    if (lead && !isRecognizedCursorContext(lead))
+        return raw;
+    return match[1].trim();
+}
+function isRecognizedCursorContext(lead) {
+    let rest = lead;
+    while (rest) {
+        const tag = RECOGNIZED_CURSOR_WRAPPERS.find((name) => rest.startsWith(`<${name}>`));
+        if (!tag)
+            return false;
+        const close = rest.indexOf(`</${tag}>`);
+        if (close === -1)
+            return false;
+        rest = rest.slice(close + tag.length + 3).trim();
+    }
+    return true;
+}
+//# sourceMappingURL=foreign-transcript-blocks.js.map

package/dist/core/foreign-transcript-blocks.js.map

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

package/dist/core/mcp/catalog-cache.d.ts

@@ -0,0 +1,63 @@
+import type { MCPServerConfig } from "./types.js";
+/**
+ * On-disk cache of MCP tool definitions, so a cold start can answer
+ * `tool_search` honestly before any server has finished connecting.
+ *
+ * With `backgroundMcpConnect` on (the desktop default) the first turns run
+ * against an empty `DeferredToolCatalog`, and `tool_search` reports "the
+ * catalog is empty — every catalog tool is already available" for capabilities
+ * that genuinely exist. That is a wrong answer, not a slow one.
+ *
+ * Entries are keyed by server name plus a hash of the resolved server config,
+ * so editing a server's command, URL, headers or env invalidates its cache
+ * instead of serving tools that server no longer exposes.
+ */
+/**
+ * Negotiated MCP protocol era for a server, using the SDK's own vocabulary:
+ * `legacy` = the 2025 `initialize` handshake, `modern` = 2026-07-28+. Feeds the
+ * connect-time `prior` hint that lets a later connect skip the discovery probe.
+ */
+export type ProtocolEra = "legacy" | "modern";
+export interface CachedTool {
+    name: string;
+    description: string;
+    rawInputSchema?: Record<string, unknown>;
+}
+export interface CachedServerEntry {
+    configHash: string;
+    savedAt: number;
+    protocolEra?: ProtocolEra;
+    tools: CachedTool[];
+}
+/**
+ * Stable hash of everything that can change which tools a server exposes.
+ * Key order is normalized so a reordered config file is not a cache miss.
+ */
+export declare function hashServerConfig(config: MCPServerConfig): string;
+/**
+ * File-backed MCP tool catalog cache at `~/.gg/mcp-catalog.json`. Every read
+ * re-reads the file so concurrent sidecars/windows see each other's writes;
+ * writes are read-modify-write so two servers don't clobber one another.
+ * Malformed files are treated as empty — a broken cache must never break a run.
+ */
+export declare class McpCatalogCache {
+    private readonly filePath;
+    /** Serializes read-modify-write cycles within one process. */
+    private writeQueue;
+    constructor(filePath?: string);
+    private readAll;
+    private writeAll;
+    /**
+     * Cached tools for the given configs, skipping any server whose config hash
+     * changed or whose entry has aged out. Servers with no usable entry are
+     * simply absent from the result.
+     */
+    entriesFor(configs: readonly MCPServerConfig[]): Promise<Map<string, CachedServerEntry>>;
+    /** Negotiated protocol era recorded for a server, if its config still matches. */
+    protocolEraFor(config: MCPServerConfig): Promise<ProtocolEra | undefined>;
+    /** Record a server's live tool list. Serialized against concurrent saves. */
+    save(config: MCPServerConfig, tools: readonly CachedTool[], protocolEra?: ProtocolEra): Promise<void>;
+    /** Drop a server's cached tools (removal, or a connect that found none). */
+    clear(name: string): Promise<void>;
+}
+//# sourceMappingURL=catalog-cache.d.ts.map

package/dist/core/mcp/catalog-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-cache.d.ts","sourceRoot":"","sources":["../../../src/core/mcp/catalog-cache.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;;;;;;;;;;;GAYG;AAEH;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE9C,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAUD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAUhE;AAoCD;;;;;GAKG;AACH,qBAAa,eAAe;IAId,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAHrC,8DAA8D;IAC9D,OAAO,CAAC,UAAU,CAAoC;gBAEzB,QAAQ,GAAE,MAAqC;YAE9D,OAAO;YAiBP,QAAQ;IAatB;;;;OAIG;IACG,UAAU,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAc9F,kFAAkF;IAC5E,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAK/E,6EAA6E;IACvE,IAAI,CACR,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,SAAS,UAAU,EAAE,EAC5B,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,IAAI,CAAC;IAmBhB,4EAA4E;IACtE,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAUzC"}