@jcode.labs/ragmir 6.1.6 → 6.2.0

package/dist/mcp-scope.js

@@ -0,0 +1,114 @@
+import { realpathSync } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { RootsListChangedNotificationSchema } from "@modelcontextprotocol/sdk/types.js";
+import { isCaseInsensitiveFileSystem } from "./source-paths.js";
+/** Working directory of the agent that launched the server, recorded by the runner and the CLI. */
+export const RAGMIR_CLIENT_CWD_ENV = "RAGMIR_CLIENT_CWD";
+const ROOTS_TIMEOUT_MS = 2_000;
+/**
+ * Track which workspace the connected agent works in: MCP roots when the client shares them (Claude
+ * Code), its CLAUDE_PROJECT_DIR otherwise, and the directory the agent launched the server from
+ * (Codex shares neither). A server registered for every project (user scope) would otherwise answer
+ * an unrelated project with this base's documents as if they were its own.
+ */
+export class WorkspaceScope {
+    server;
+    roots = null;
+    source = null;
+    pending = null;
+    constructor(server, env = process.env) {
+        this.server = server;
+        const clientProject = env.CLAUDE_PROJECT_DIR;
+        const launchDirectory = env[RAGMIR_CLIENT_CWD_ENV];
+        if (clientProject) {
+            this.roots = [path.resolve(clientProject)];
+            this.source = "client-environment";
+        }
+        else if (launchDirectory) {
+            this.roots = [path.resolve(launchDirectory)];
+            this.source = "launch-directory";
+        }
+    }
+    attach() {
+        const previous = this.server.oninitialized;
+        this.server.oninitialized = () => {
+            previous?.();
+            this.refresh();
+        };
+        this.server.setNotificationHandler(RootsListChangedNotificationSchema, () => {
+            this.refresh();
+        });
+    }
+    refresh() {
+        if (!this.server.getClientCapabilities()?.roots) {
+            return;
+        }
+        this.pending = (async () => {
+            try {
+                const { roots } = await this.server.listRoots(undefined, { timeout: ROOTS_TIMEOUT_MS });
+                const paths = roots.flatMap((root) => root.uri.startsWith("file:") ? [fileURLToPath(root.uri)] : []);
+                if (paths.length > 0) {
+                    this.roots = paths;
+                    this.source = "mcp-roots";
+                }
+            }
+            catch {
+                // Clients may declare roots and still fail to list them; keep the previous evidence.
+            }
+        })();
+    }
+    async verdict(config) {
+        await this.pending;
+        const enforced = config.mcpAllowedRoots.length > 0;
+        const allowedRoots = enforced
+            ? config.mcpAllowedRoots.map((root) => resolveAllowedRoot(config.projectRoot, root))
+            : [config.projectRoot];
+        if (this.roots === null) {
+            return { relation: "unknown", enforced, allowed: true, workspaceRoots: [], source: null };
+        }
+        const caseInsensitive = isCaseInsensitiveFileSystem(config.projectRoot);
+        const related = this.roots.some((workspaceRoot) => allowedRoots.some((allowedRoot) => isWithin(workspaceRoot, allowedRoot, caseInsensitive) ||
+            isWithin(allowedRoot, workspaceRoot, caseInsensitive)));
+        return {
+            relation: related ? "related" : "unrelated",
+            enforced,
+            allowed: related || !enforced,
+            workspaceRoots: [...this.roots],
+            source: this.source,
+        };
+    }
+}
+export function workspaceScopeNotice(verdict, name, projectRoot) {
+    if (verdict.relation !== "unrelated") {
+        return null;
+    }
+    return `Scope notice: this Ragmir server answers from the "${name}" knowledge base (${projectRoot}), not from your workspace (${verdict.workspaceRoots.join(", ")}). Use these passages only for questions about ${name}. Register Ragmir per project, or set mcpAllowedRoots, to keep each workspace on its own base.`;
+}
+export function workspaceScopeRefusal(verdict, name, config) {
+    return `This Ragmir server serves the "${name}" knowledge base only to workspaces under ${config.mcpAllowedRoots.join(", ")} (mcpAllowedRoots). Your workspace is ${verdict.workspaceRoots.join(", ")}. Register a project-scoped Ragmir server for this workspace instead.`;
+}
+function resolveAllowedRoot(projectRoot, value) {
+    const expanded = value === "~" || value.startsWith("~/") || value.startsWith("~\\")
+        ? path.join(os.homedir(), value.slice(1))
+        : value;
+    return path.resolve(projectRoot, expanded);
+}
+function isWithin(child, parent, caseInsensitive) {
+    const normalize = (value) => {
+        const real = realPath(value).normalize("NFC");
+        return caseInsensitive ? real.toLowerCase() : real;
+    };
+    const relative = path.relative(normalize(parent), normalize(child));
+    return relative !== ".." && !relative.startsWith(`..${path.sep}`) && !path.isAbsolute(relative);
+}
+function realPath(value) {
+    try {
+        return realpathSync.native(value);
+    }
+    catch {
+        return path.resolve(value);
+    }
+}
+//# sourceMappingURL=mcp-scope.js.map

package/dist/mcp-scope.js.map

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

package/dist/mcp-session.d.ts

@@ -0,0 +1,37 @@
+import type { McpSeenResults } from "./types.js";
+/** A passage already returned in this MCP session: enough to recognize it, not to re-read it. */
+export interface SeenCitationStub {
+    citation: string;
+    relativePath: string;
+    seen: true;
+    evidence?: {
+        id: string;
+    };
+}
+interface CitedResult {
+    citation: string;
+    relativePath: string;
+    evidence?: {
+        id: string;
+    };
+}
+/**
+ * Citations returned during one MCP connection. Agents fan out related searches and receive the
+ * same passages again; a quarter of returned citations were repeats in real sessions, so repeats
+ * come back as short stubs (or not at all) and the budget goes to new evidence.
+ */
+export declare class McpSessionMemory {
+    private readonly citations;
+    get size(): number;
+    has(citation: string): boolean;
+    remember(citations: Iterable<string>): void;
+}
+/**
+ * Keep up to `topK` unseen results in rank order. Seen results ranked above the last kept one become
+ * stubs in `collapse` mode, disappear in `exclude` mode, and stay whole in `include` mode.
+ * `alsoSeen` holds citations returned earlier in the same batch.
+ */
+export declare function applySeenResults<Result extends CitedResult>(results: readonly Result[], memory: McpSessionMemory, mode: McpSeenResults, topK: number, alsoSeen?: ReadonlySet<string>): Array<Result | SeenCitationStub>;
+export declare function isSeenCitationStub(value: unknown): value is SeenCitationStub;
+export {};
+//# sourceMappingURL=mcp-session.d.ts.map

package/dist/mcp-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-session.d.ts","sourceRoot":"","sources":["../src/mcp-session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhD,iGAAiG;AACjG,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,IAAI,CAAA;IACV,QAAQ,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAA;CAC1B;AAED,UAAU,WAAW;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAA;CAC1B;AAED;;;;GAIG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAE9C,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE7B;IAED,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI,CAI1C;CACF;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,SAAS,WAAW,EACzD,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,WAAW,CAAC,MAAM,CAAa,GACxC,KAAK,CAAC,MAAM,GAAG,gBAAgB,CAAC,CAuBlC;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAE5E"}

package/dist/mcp-session.js

@@ -0,0 +1,53 @@
+/**
+ * Citations returned during one MCP connection. Agents fan out related searches and receive the
+ * same passages again; a quarter of returned citations were repeats in real sessions, so repeats
+ * come back as short stubs (or not at all) and the budget goes to new evidence.
+ */
+export class McpSessionMemory {
+    citations = new Set();
+    get size() {
+        return this.citations.size;
+    }
+    has(citation) {
+        return this.citations.has(citation);
+    }
+    remember(citations) {
+        for (const citation of citations) {
+            this.citations.add(citation);
+        }
+    }
+}
+/**
+ * Keep up to `topK` unseen results in rank order. Seen results ranked above the last kept one become
+ * stubs in `collapse` mode, disappear in `exclude` mode, and stay whole in `include` mode.
+ * `alsoSeen` holds citations returned earlier in the same batch.
+ */
+export function applySeenResults(results, memory, mode, topK, alsoSeen = new Set()) {
+    if (mode === "include") {
+        return results.slice(0, topK);
+    }
+    const selected = [];
+    let fresh = 0;
+    for (const result of results) {
+        if (fresh >= topK) {
+            break;
+        }
+        if (!memory.has(result.citation) && !alsoSeen.has(result.citation)) {
+            selected.push(result);
+            fresh += 1;
+        }
+        else if (mode === "collapse") {
+            selected.push({
+                citation: result.citation,
+                relativePath: result.relativePath,
+                seen: true,
+                ...(result.evidence === undefined ? {} : { evidence: { id: result.evidence.id } }),
+            });
+        }
+    }
+    return selected;
+}
+export function isSeenCitationStub(value) {
+    return typeof value === "object" && value !== null && "seen" in value && value.seen === true;
+}
+//# sourceMappingURL=mcp-session.js.map

package/dist/mcp-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-session.js","sourceRoot":"","sources":["../src/mcp-session.ts"],"names":[],"mappings":"AAgBA;;;;GAIG;AACH,MAAM,OAAO,gBAAgB;IACV,SAAS,GAAG,IAAI,GAAG,EAAU,CAAA;IAE9C,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAA;IAC5B,CAAC;IAED,GAAG,CAAC,QAAgB;QAClB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IACrC,CAAC;IAED,QAAQ,CAAC,SAA2B;QAClC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAC9B,CAAC;IACH,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAA0B,EAC1B,MAAwB,EACxB,IAAoB,EACpB,IAAY,EACZ,QAAQ,GAAwB,IAAI,GAAG,EAAE;IAEzC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA;IAC/B,CAAC;IACD,MAAM,QAAQ,GAAqC,EAAE,CAAA;IACrD,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;YAClB,MAAK;QACP,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YACnE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YACrB,KAAK,IAAI,CAAC,CAAA;QACZ,CAAC;aAAM,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;YAC/B,QAAQ,CAAC,IAAI,CAAC;gBACZ,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,YAAY,EAAE,MAAM,CAAC,YAAY;gBACjC,IAAI,EAAE,IAAI;gBACV,GAAG,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC;aACnF,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,CAAA;AAC9F,CAAC"}

package/dist/mcp-summaries.d.ts

@@ -16,6 +16,11 @@ export declare function compactStatusOutput(value: McpStatusOutput): CompactJson
 export declare function compactContextOutput(value: KnowledgeBaseContextReport): CompactJsonValue;
 export declare function compactSourcesOutput(value: KnowledgeBaseSourceCatalog): CompactJsonValue;
 export declare function compactAuditOutput(value: AuditReport): CompactJsonValue;
+/**
+ * Default MCP audit answer: counts, the first drifted files, and the diagnostics an agent can act
+ * on, instead of every path in the corpus.
+ */
+export declare function summarizeAuditForMcp(report: AuditReport): Record<string, unknown>;
 export declare function mcpPreviewLimit(maxBytes: number): number;
 export {};
 //# sourceMappingURL=mcp-summaries.d.ts.map

package/dist/mcp-summaries.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-summaries.d.ts","sourceRoot":"","sources":["../src/mcp-summaries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AACvD,OAAO,KAAK,EACV,WAAW,EACX,MAAM,EACN,0BAA0B,EAC1B,0BAA0B,EAC3B,MAAM,YAAY,CAAA;AAEnB,UAAU,eAAe;IACvB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,gBAAgB,EAAE,MAAM,CAAC,kBAAkB,CAAC,CAAA;IAC5C,iBAAiB,EAAE,MAAM,CAAC,mBAAmB,CAAC,CAAA;IAC9C,sBAAsB,EAAE,MAAM,CAAA;IAC9B,aAAa,EAAE,OAAO,CAAA;IACtB,UAAU,EAAE,MAAM,CAAA;IAClB,iBAAiB,EAAE,MAAM,CAAA;IACzB,KAAK,EAAE,OAAO,CAAA;IACd,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,aAAa,EAAE,MAAM,CAAA;CACtB;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,eAAe,GAAG,gBAAgB,CAkB5E;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,0BAA0B,GAAG,gBAAgB,CAsBxF;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,0BAA0B,GAAG,gBAAgB,CAuBxF;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,gBAAgB,CAiCvE;AAgBD,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExD"}
+{"version":3,"file":"mcp-summaries.d.ts","sourceRoot":"","sources":["../src/mcp-summaries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AACvD,OAAO,KAAK,EACV,WAAW,EACX,MAAM,EACN,0BAA0B,EAC1B,0BAA0B,EAC3B,MAAM,YAAY,CAAA;AAEnB,UAAU,eAAe;IACvB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,gBAAgB,EAAE,MAAM,CAAC,kBAAkB,CAAC,CAAA;IAC5C,iBAAiB,EAAE,MAAM,CAAC,mBAAmB,CAAC,CAAA;IAC9C,sBAAsB,EAAE,MAAM,CAAA;IAC9B,aAAa,EAAE,OAAO,CAAA;IACtB,UAAU,EAAE,MAAM,CAAA;IAClB,iBAAiB,EAAE,MAAM,CAAA;IACzB,KAAK,EAAE,OAAO,CAAA;IACd,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,aAAa,EAAE,MAAM,CAAA;CACtB;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,eAAe,GAAG,gBAAgB,CAkB5E;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,0BAA0B,GAAG,gBAAgB,CAsBxF;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,0BAA0B,GAAG,gBAAgB,CAuBxF;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,gBAAgB,CAiCvE;AAkBD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAwBjF;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExD"}

package/dist/mcp-summaries.js

@@ -109,6 +109,36 @@ function emptyAuditOmissions() {
         staleInIndex: 0,
     };
 }
+const AUDIT_SUMMARY_PREVIEWS = 10;
+/**
+ * Default MCP audit answer: counts, the first drifted files, and the diagnostics an agent can act
+ * on, instead of every path in the corpus.
+ */
+export function summarizeAuditForMcp(report) {
+    const omitted = report.omitted ?? emptyAuditOmissions();
+    return {
+        mode: report.mode,
+        inventoryVerified: report.inventoryVerified,
+        discoveredFiles: report.discoveredFiles,
+        totalChunks: report.totalChunks,
+        counts: {
+            indexedFiles: report.indexedFiles.length + omitted.indexedFiles,
+            supportedFiles: report.supportedFiles.length + omitted.supportedFiles,
+            skippedFiles: report.skippedFiles.length + omitted.skippedFiles,
+            emptyTextFiles: report.emptyTextFiles.length + omitted.emptyTextFiles,
+            missingFromIndex: report.missingFromIndex.length + omitted.missingFromIndex,
+            staleInIndex: report.staleInIndex.length + omitted.staleInIndex,
+        },
+        previews: {
+            missingFromIndex: report.missingFromIndex.slice(0, AUDIT_SUMMARY_PREVIEWS),
+            staleInIndex: report.staleInIndex.slice(0, AUDIT_SUMMARY_PREVIEWS),
+            emptyTextFiles: report.emptyTextFiles.slice(0, AUDIT_SUMMARY_PREVIEWS),
+        },
+        ...(report.sourceRules === undefined ? {} : { sourceRules: report.sourceRules }),
+        ...(report.concentration === undefined ? {} : { concentration: report.concentration }),
+        detail: "Call ragmir_audit with detail:true for every path.",
+    };
+}
 export function mcpPreviewLimit(maxBytes) {
     return Math.max(1, Math.min(200, Math.floor(maxBytes / 512)));
 }

package/dist/mcp-summaries.js.map

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

package/dist/mcp.d.ts

@@ -1,11 +1,17 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import type { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
 import { RagmirClient } from "./client.js";
+import { type KnowledgeBaseProfile } from "./knowledge-bases.js";
 import type { Config } from "./types.js";
 interface McpClientLifecycle {
     getClient(config?: Config): Promise<RagmirClient>;
     close(): Promise<void>;
 }
+/**
+ * Instructions name the base and its root: one generic text for every Ragmir server let agents in
+ * unrelated projects treat another project's documents as their own.
+ */
+export declare function mcpServerInstructions(profile: KnowledgeBaseProfile): string;
 export declare function createMcpClientLifecycle(cwd: string): McpClientLifecycle;
 export declare function createMcpServer(cwd?: string): McpServer;
 export declare function connectMcpServer(transport: Transport, cwd?: string): Promise<McpServer>;

package/dist/mcp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAEnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAA;AAE9E,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AA6B1C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAyDxC,UAAU,kBAAkB;IAC1B,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;IACjD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB;AAwBD,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAmExE;AAED,wBAAgB,eAAe,CAAC,GAAG,SAA0B,GAAG,SAAS,CA4NxE;AAED,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,SAAS,EACpB,GAAG,SAA0B,GAC5B,OAAO,CAAC,SAAS,CAAC,CAIpB;AAED,wBAAsB,QAAQ,CAAC,GAAG,SAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAG3E;AAED,wBAAgB,qBAAqB,CACnC,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,QAAQ,SAAgB,GACvB,MAAM,CAYR;AAiFD,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,EAClC,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,EACnC,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,EACnC,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,EACnC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,EAC7B,oBAAoB,CAAC,EAAE,MAAM,GAAG,SAAS,GACxC,OAAO,CAAC;IACT,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,CAAC,CAYD"}
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAEnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAA;AAE9E,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAK1C,OAAO,EACL,KAAK,oBAAoB,EAI1B,MAAM,sBAAsB,CAAA;AAkC7B,OAAO,KAAK,EAAE,MAAM,EAAgC,MAAM,YAAY,CAAA;AAmGtE,UAAU,kBAAkB;IAC1B,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;IACjD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB;AA8BD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,CAkB3E;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAmExE;AAsCD,wBAAgB,eAAe,CAAC,GAAG,SAA0B,GAAG,SAAS,CAgYxE;AAED,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,SAAS,EACpB,GAAG,SAA0B,GAC5B,OAAO,CAAC,SAAS,CAAC,CAIpB;AAED,wBAAsB,QAAQ,CAAC,GAAG,SAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAG3E;AAED,wBAAgB,qBAAqB,CACnC,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,QAAQ,SAAgB,GACvB,MAAM,CAYR;AAqQD,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,EAClC,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,EACnC,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,EACnC,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,EACnC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,EAC7B,oBAAoB,CAAC,EAAE,MAAM,GAAG,SAAS,GACxC,OAAO,CAAC;IACT,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,CAAC,CAYD"}