@sovant/claude-code-mcp 0.3.0

package/dist/index.js

@@ -0,0 +1,332 @@
+#!/usr/bin/env node
+/**
+ * Sovant MCP Server for Claude Code
+ *
+ * Provides persistent project memory through Sovant's governed memory layer.
+ * Creates/loads a thread per git repository and exposes tools for:
+ * - Saving memories (/remember, /remember-pref, /remember-decision)
+ * - Recalling memories (/recall)
+ * - Managing memories (/memory list, /memory delete)
+ *
+ * On session start, runs a recall to load project context.
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { hasApiKey } from "./sovant.js";
+import { initializeThread, isSessionInitialized, getThreadInfo, } from "./commands/shared.js";
+import { handleRemember, handleRememberPref, handleRememberDecision, } from "./commands/remember.js";
+import { handleRecall, handleSearch } from "./commands/recall.js";
+import { handleMemory, handleMemoryUpdate } from "./commands/memory.js";
+// Tool definitions
+const TOOLS = [
+    {
+        name: "sovant_remember",
+        description: "Save a note, fact, or context to project memory. Use for general notes about the project.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                text: {
+                    type: "string",
+                    description: "The text to remember",
+                },
+            },
+            required: ["text"],
+        },
+    },
+    {
+        name: "sovant_remember_pref",
+        description: "Save a user preference to project memory. Use for coding style preferences, tool choices, etc.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                text: {
+                    type: "string",
+                    description: "The preference to remember",
+                },
+            },
+            required: ["text"],
+        },
+    },
+    {
+        name: "sovant_remember_decision",
+        description: "Save an important decision to project memory. Use for architectural decisions, tech choices, tradeoffs.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                text: {
+                    type: "string",
+                    description: "The decision to remember",
+                },
+            },
+            required: ["text"],
+        },
+    },
+    {
+        name: "sovant_recall",
+        description: "Search project memories for relevant context, scoped to the current repository's thread. Use to find past decisions, preferences, or notes.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    description: "The search query or question",
+                },
+                limit: {
+                    type: "number",
+                    description: "Max results to return (default: 10, max: 25)",
+                },
+                scope: {
+                    type: "string",
+                    enum: ["thread", "global"],
+                    description: "Search scope: 'thread' (default, current repo) or 'global' (all projects)",
+                },
+                mode: {
+                    type: "string",
+                    enum: ["smart", "exact"],
+                    description: "Recall mode: 'smart' (default, hybrid AI recall) or 'exact' (deterministic keyword match)",
+                },
+                debug: {
+                    type: "boolean",
+                    description: "Include debug info (counts, token estimates, sources)",
+                },
+                include_workspace: {
+                    type: "boolean",
+                    description: "Include non-dev memories (dashboard, CRM, smart capture). Default: false (dev memories only)",
+                },
+            },
+            required: ["query"],
+        },
+    },
+    {
+        name: "sovant_memory_list",
+        description: "List recent project memories with short IDs needed for show/update/delete.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                count: {
+                    type: "number",
+                    description: "Number of memories to list (default: 20, max: 100)",
+                },
+            },
+        },
+    },
+    {
+        name: "sovant_memory_delete",
+        description: "Delete a memory by its ID. Use the short ID from /memory list.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                memory_id: {
+                    type: "string",
+                    description: "The memory ID to delete (full or short ID)",
+                },
+            },
+            required: ["memory_id"],
+        },
+    },
+    {
+        name: "sovant_memory_update",
+        description: "Update an existing memory's content. Use the short ID from /memory list.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                memory_id: {
+                    type: "string",
+                    description: "The memory ID to update (full or short ID)",
+                },
+                text: {
+                    type: "string",
+                    description: "The new content for the memory",
+                },
+            },
+            required: ["memory_id", "text"],
+        },
+    },
+    {
+        name: "sovant_memory_show",
+        description: "Show full details of a specific memory, including tags, metadata, and creation date.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                memory_id: {
+                    type: "string",
+                    description: "The memory ID to show (full or short ID)",
+                },
+            },
+            required: ["memory_id"],
+        },
+    },
+    {
+        name: "sovant_search",
+        description: "Search memories with explicit scoping. Defaults to current repo (safe). Use scope='global' to search across all projects.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    description: "The search query",
+                },
+                scope: {
+                    type: "string",
+                    enum: ["repo", "global"],
+                    description: "Search scope: 'repo' (default, current project only) or 'global' (all projects)",
+                },
+                tags: {
+                    type: "string",
+                    description: "Comma-separated tags to filter by",
+                },
+                type: {
+                    type: "string",
+                    description: "Memory type filter (e.g. 'decision', 'preference')",
+                },
+                limit: {
+                    type: "number",
+                    description: "Max results to return (default: 10, max: 20)",
+                },
+            },
+            required: ["query"],
+        },
+    },
+    {
+        name: "sovant_thread_info",
+        description: "Get info about the current project's memory thread, including thread title, memory count, and creation date.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+    },
+];
+// Create server
+const server = new Server({
+    name: "sovant-claude-code",
+    version: "0.3.0",
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// Handle tool listing
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return { tools: TOOLS };
+});
+// Handle tool calls
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    // Check for API key first
+    if (!hasApiKey()) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "SOVANT_API_KEY environment variable is not set.\n" +
+                        "Please set it in your shell or Claude Code configuration:\n" +
+                        "  export SOVANT_API_KEY=sk_live_your_key_here\n" +
+                        "Get your API key at https://sovant.ai/dashboard/settings/api-keys",
+                },
+            ],
+            isError: true,
+        };
+    }
+    // Initialize thread on first tool call if not already done
+    if (!isSessionInitialized()) {
+        try {
+            const { summary, isNew } = await initializeThread();
+            // Log the session summary (will be visible in Claude Code)
+            console.error(`[sovant] ${isNew ? "Created new thread" : "Loaded thread"}`);
+            console.error(`[sovant] ${summary}`);
+        }
+        catch (error) {
+            console.error("[sovant] Failed to initialize thread:", error);
+        }
+    }
+    try {
+        let result;
+        switch (name) {
+            case "sovant_remember":
+                result = await handleRemember(args?.text || "");
+                break;
+            case "sovant_remember_pref":
+                result = await handleRememberPref(args?.text || "");
+                break;
+            case "sovant_remember_decision":
+                result = await handleRememberDecision(args?.text || "");
+                break;
+            case "sovant_recall":
+                result = await handleRecall(args?.query || "", args?.limit, args?.scope, args?.mode, args?.debug, args?.include_workspace);
+                break;
+            case "sovant_search":
+                result = await handleSearch({
+                    query: args?.query || "",
+                    scope: args?.scope,
+                    tags: args?.tags,
+                    type: args?.type,
+                    limit: args?.limit,
+                });
+                break;
+            case "sovant_memory_list":
+                result = await handleMemory(`list ${args?.count || ""}`);
+                break;
+            case "sovant_memory_delete":
+                result = await handleMemory(`delete ${args?.memory_id || ""}`);
+                break;
+            case "sovant_memory_update":
+                result = await handleMemoryUpdate(args?.memory_id || "", args?.text || "");
+                break;
+            case "sovant_memory_show":
+                result = await handleMemory(`show ${args?.memory_id || ""}`);
+                break;
+            case "sovant_thread_info": {
+                const info = await getThreadInfo();
+                result = [
+                    `**Project Thread Info** (${info.data_source})`,
+                    `Repo: ${info.repo}`,
+                    `Thread ID: ${info.thread_id}`,
+                    `Thread Title: ${info.thread_title}`,
+                    info.memory_count !== undefined
+                        ? `Memories: ${info.memory_count}`
+                        : null,
+                    info.created_at ? `Created: ${info.created_at}` : null,
+                    info.branch ? `Branch: ${info.branch}` : null,
+                    `Config File: ${info.config_path}`,
+                ]
+                    .filter(Boolean)
+                    .join("\n");
+                break;
+            }
+            default:
+                result = `Unknown tool: ${name}`;
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: result,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Unknown error occurred";
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error: ${message}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// Start server
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("[sovant] MCP server started");
+}
+main().catch((error) => {
+    console.error("[sovant] Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/localStore.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Local storage for Sovant thread configuration
+ *
+ * Persists the thread ID mapping in .sovant/thread.json so that
+ * memories are associated with the correct repo across sessions.
+ */
+export interface ThreadConfig {
+    /** Sovant thread UUID */
+    thread_id: string;
+    /** Repository identifier (owner/repo or folder name) */
+    repo: string;
+    /** When the thread was first created */
+    created_at: string;
+    /** Last time this config was accessed */
+    last_seen: string;
+}
+/**
+ * Get the path to the thread config file
+ */
+export declare function getConfigPath(): string;
+/**
+ * Load thread configuration from .sovant/thread.json
+ * @returns ThreadConfig or null if not found
+ */
+export declare function loadThreadConfig(): ThreadConfig | null;
+/**
+ * Save thread configuration to .sovant/thread.json
+ * @returns true if saved successfully, false otherwise
+ */
+export declare function saveThreadConfig(config: ThreadConfig): boolean;
+/**
+ * Update the last_seen timestamp in the config
+ */
+export declare function updateLastSeen(): void;
+/**
+ * Check if the .sovant directory is writable
+ */
+export declare function canWriteConfig(): boolean;
+//# sourceMappingURL=localStore.d.ts.map

package/dist/localStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localStore.d.ts","sourceRoot":"","sources":["../src/localStore.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,WAAW,YAAY;IAC3B,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;CACnB;AAKD;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,YAAY,GAAG,IAAI,CAsBtD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAkB9D;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAMrC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAoBxC"}

package/dist/localStore.js

@@ -0,0 +1,93 @@
+/**
+ * Local storage for Sovant thread configuration
+ *
+ * Persists the thread ID mapping in .sovant/thread.json so that
+ * memories are associated with the correct repo across sessions.
+ */
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from "fs";
+import { join, dirname } from "path";
+const SOVANT_DIR = ".sovant";
+const THREAD_FILE = "thread.json";
+/**
+ * Get the path to the thread config file
+ */
+export function getConfigPath() {
+    return join(process.cwd(), SOVANT_DIR, THREAD_FILE);
+}
+/**
+ * Load thread configuration from .sovant/thread.json
+ * @returns ThreadConfig or null if not found
+ */
+export function loadThreadConfig() {
+    const configPath = getConfigPath();
+    if (!existsSync(configPath)) {
+        return null;
+    }
+    try {
+        const content = readFileSync(configPath, "utf-8");
+        const config = JSON.parse(content);
+        // Validate required fields
+        if (!config.thread_id || !config.repo) {
+            console.error("[sovant] Invalid thread config, missing required fields");
+            return null;
+        }
+        return config;
+    }
+    catch (error) {
+        console.error("[sovant] Failed to load thread config:", error);
+        return null;
+    }
+}
+/**
+ * Save thread configuration to .sovant/thread.json
+ * @returns true if saved successfully, false otherwise
+ */
+export function saveThreadConfig(config) {
+    const configPath = getConfigPath();
+    const configDir = dirname(configPath);
+    try {
+        // Create .sovant directory if it doesn't exist
+        if (!existsSync(configDir)) {
+            mkdirSync(configDir, { recursive: true });
+        }
+        // Write config with pretty formatting
+        writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
+        return true;
+    }
+    catch (error) {
+        console.error("[sovant] Failed to save thread config:", error);
+        return false;
+    }
+}
+/**
+ * Update the last_seen timestamp in the config
+ */
+export function updateLastSeen() {
+    const config = loadThreadConfig();
+    if (config) {
+        config.last_seen = new Date().toISOString();
+        saveThreadConfig(config);
+    }
+}
+/**
+ * Check if the .sovant directory is writable
+ */
+export function canWriteConfig() {
+    const configDir = join(process.cwd(), SOVANT_DIR);
+    try {
+        if (!existsSync(configDir)) {
+            mkdirSync(configDir, { recursive: true });
+        }
+        // Try to write a test file
+        const testPath = join(configDir, ".write-test");
+        writeFileSync(testPath, "test", "utf-8");
+        // Clean up
+        const { unlinkSync } = require("fs");
+        unlinkSync(testPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=localStore.js.map

package/dist/localStore.js.map

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

package/dist/repo.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Git repository detection helpers
+ *
+ * Detects the current git repository and extracts identifying information
+ * like owner/repo name and current branch.
+ */
+export interface RepoInfo {
+    /** Repository identifier (owner/repo or folder name) */
+    repo: string;
+    /** Current git branch (if available) */
+    branch?: string;
+    /** Whether this is a git repository */
+    isGitRepo: boolean;
+}
+/**
+ * Get repository information for the current working directory
+ */
+export declare function getRepoInfo(): RepoInfo;
+/**
+ * Get a short identifier for the repo (last component)
+ */
+export declare function getRepoShortName(repo: string): string;
+//# sourceMappingURL=repo.d.ts.map

package/dist/repo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo.d.ts","sourceRoot":"","sources":["../src/repo.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,WAAW,QAAQ;IACvB,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CA+CtC;AAgCD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGrD"}

package/dist/repo.js

@@ -0,0 +1,93 @@
+/**
+ * Git repository detection helpers
+ *
+ * Detects the current git repository and extracts identifying information
+ * like owner/repo name and current branch.
+ */
+import { execSync } from "child_process";
+import { basename } from "path";
+/**
+ * Get repository information for the current working directory
+ */
+export function getRepoInfo() {
+    const cwd = process.cwd();
+    // Try to detect git repo
+    try {
+        // Check if we're in a git repo
+        execSync("git rev-parse --git-dir", { cwd, stdio: "pipe" });
+    }
+    catch {
+        // Not a git repo, use folder name
+        return {
+            repo: basename(cwd),
+            isGitRepo: false,
+        };
+    }
+    // Get remote URL and extract owner/repo
+    let repo;
+    try {
+        const remoteUrl = execSync("git remote get-url origin", {
+            cwd,
+            encoding: "utf-8",
+            stdio: "pipe",
+        }).trim();
+        repo = normalizeRemoteUrl(remoteUrl);
+    }
+    catch {
+        // No remote, use folder name
+        repo = basename(cwd);
+    }
+    // Get current branch
+    let branch;
+    try {
+        branch = execSync("git rev-parse --abbrev-ref HEAD", {
+            cwd,
+            encoding: "utf-8",
+            stdio: "pipe",
+        }).trim();
+    }
+    catch {
+        // Ignore branch detection errors
+    }
+    return {
+        repo,
+        branch,
+        isGitRepo: true,
+    };
+}
+/**
+ * Normalize a git remote URL to owner/repo format
+ *
+ * Handles:
+ * - https://github.com/owner/repo.git
+ * - git@github.com:owner/repo.git
+ * - https://gitlab.com/owner/repo
+ * - etc.
+ */
+function normalizeRemoteUrl(url) {
+    // Remove .git suffix
+    url = url.replace(/\.git$/, "");
+    // Handle SSH URLs (git@github.com:owner/repo)
+    const sshMatch = url.match(/^git@[^:]+:(.+)$/);
+    if (sshMatch) {
+        return sshMatch[1];
+    }
+    // Handle HTTPS URLs (https://github.com/owner/repo)
+    try {
+        const parsed = new URL(url);
+        // Remove leading slash and return path
+        return parsed.pathname.replace(/^\//, "");
+    }
+    catch {
+        // If URL parsing fails, return as-is
+        return url;
+    }
+}
+/**
+ * Get a short identifier for the repo (last component)
+ */
+export function getRepoShortName(repo) {
+    const parts = repo.split("/");
+    return parts[parts.length - 1];
+}
+//# sourceMappingURL=repo.js.map

package/dist/repo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo.js","sourceRoot":"","sources":["../src/repo.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAWhC;;GAEG;AACH,MAAM,UAAU,WAAW;IACzB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAE1B,yBAAyB;IACzB,IAAI,CAAC;QACH,+BAA+B;QAC/B,QAAQ,CAAC,yBAAyB,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9D,CAAC;IAAC,MAAM,CAAC;QACP,kCAAkC;QAClC,OAAO;YACL,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC;YACnB,SAAS,EAAE,KAAK;SACjB,CAAC;IACJ,CAAC;IAED,wCAAwC;IACxC,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,QAAQ,CAAC,2BAA2B,EAAE;YACtD,GAAG;YACH,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,MAAM;SACd,CAAC,CAAC,IAAI,EAAE,CAAC;QAEV,IAAI,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,6BAA6B;QAC7B,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IAED,qBAAqB;IACrB,IAAI,MAA0B,CAAC;IAC/B,IAAI,CAAC;QACH,MAAM,GAAG,QAAQ,CAAC,iCAAiC,EAAE;YACnD,GAAG;YACH,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,MAAM;SACd,CAAC,CAAC,IAAI,EAAE,CAAC;IACZ,CAAC;IAAC,MAAM,CAAC;QACP,iCAAiC;IACnC,CAAC;IAED,OAAO;QACL,IAAI;QACJ,MAAM;QACN,SAAS,EAAE,IAAI;KAChB,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,kBAAkB,CAAC,GAAW;IACrC,qBAAqB;IACrB,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAEhC,8CAA8C;IAC9C,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAC/C,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC;IACrB,CAAC;IAED,oDAAoD;IACpD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,uCAAuC;QACvC,OAAO,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,qCAAqC;QACrC,OAAO,GAAG,CAAC;IACb,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9B,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACjC,CAAC"}

package/dist/sovant.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Sovant client wrapper for Claude Code MCP plugin
+ *
+ * Initializes and provides access to the Sovant SDK client.
+ * Handles API key validation and error handling.
+ */
+import { Sovant, SovantError } from "@sovant/sdk";
+/**
+ * Get or initialize the Sovant client
+ * @throws Error if SOVANT_API_KEY is not set
+ */
+export declare function getSovantClient(): Sovant;
+/**
+ * Check if API key is configured
+ */
+export declare function hasApiKey(): boolean;
+/**
+ * Format Sovant errors for user display
+ */
+export declare function formatSovantError(error: unknown): string;
+export { SovantError };
+//# sourceMappingURL=sovant.d.ts.map

package/dist/sovant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sovant.d.ts","sourceRoot":"","sources":["../src/sovant.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAIlD;;;GAGG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAmBxC;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAmBxD;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}