artemys 0.2.0 → 0.2.1

package/dist/mcp-server/persistence.d.ts

@@ -0,0 +1,37 @@
+import type { CandidateSnapshot, ProtocolMessage } from "../protocol/index.js";
+import { ConversationTracker, ProfileStore, type ConversationRecord, type ConversationTrackerOptions } from "./state.js";
+export declare const DEFAULT_MCP_STATE_DB_PATH: string;
+export interface SqliteMcpPersistenceOptions {
+    path?: string;
+}
+export declare function resolveMcpStateDbPath(pathValue?: string): string;
+export declare class SqliteMcpPersistence {
+    readonly path: string;
+    private readonly db;
+    constructor(options?: SqliteMcpPersistenceOptions);
+    private initialize;
+    loadProfile(): CandidateSnapshot | null;
+    saveProfile(snapshot: CandidateSnapshot | null): void;
+    loadConversations(): ConversationRecord[];
+    saveConversations(records: ConversationRecord[]): void;
+    close(): void;
+}
+export interface PersistentConversationTrackerOptions extends ConversationTrackerOptions {
+    initialRecords?: ConversationRecord[];
+    onPersist?: (records: ConversationRecord[]) => void;
+}
+export declare class PersistentConversationTracker extends ConversationTracker {
+    private readonly onPersist?;
+    private readonly persistOnRead;
+    constructor(options?: PersistentConversationTrackerOptions);
+    private persistSnapshot;
+    getState(conversationId: string): ConversationRecord["state"];
+    getConversation(conversationId: string): ConversationRecord | null;
+    recordMessage(message: ProtocolMessage): {
+        newState: ConversationRecord["state"];
+    };
+    listConversations(): Array<Pick<ConversationRecord, "conversation_id" | "state" | "message_count">>;
+}
+export declare function createPersistentConversationTracker(persistence: SqliteMcpPersistence, options?: ConversationTrackerOptions): PersistentConversationTracker;
+export declare function createPersistentProfileStore(persistence: SqliteMcpPersistence): ProfileStore;
+//# sourceMappingURL=persistence.d.ts.map

package/dist/mcp-server/persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../../src/mcp-server/persistence.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC9E,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,KAAK,kBAAkB,EACvB,KAAK,0BAA0B,EAChC,MAAM,YAAY,CAAA;AAInB,eAAO,MAAM,yBAAyB,QAA0C,CAAA;AA0GhF,MAAM,WAAW,2BAA2B;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,wBAAgB,qBAAqB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAehE;AAED,qBAAa,oBAAoB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAgB;gBAEvB,OAAO,GAAE,2BAAgC;IAOrD,OAAO,CAAC,UAAU;IAkClB,WAAW,IAAI,iBAAiB,GAAG,IAAI;IAavC,WAAW,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,GAAG,IAAI;IAmBrD,iBAAiB,IAAI,kBAAkB,EAAE;IAiDzC,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,IAAI;IA+CtD,KAAK,IAAI,IAAI;CAGd;AAED,MAAM,WAAW,oCAAqC,SAAQ,0BAA0B;IACtF,cAAc,CAAC,EAAE,kBAAkB,EAAE,CAAA;IACrC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,kBAAkB,EAAE,KAAK,IAAI,CAAA;CACpD;AAED,qBAAa,6BAA8B,SAAQ,mBAAmB;IACpE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAyC;IACpE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;gBAE3B,OAAO,GAAE,oCAAyC;IAoB9D,OAAO,CAAC,eAAe;IAuBd,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,kBAAkB,CAAC,OAAO,CAAC;IAQ7D,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI;IAQlE,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG;QAAE,QAAQ,EAAE,kBAAkB,CAAC,OAAO,CAAC,CAAA;KAAE;IAMlF,iBAAiB,IAAI,KAAK,CAAC,IAAI,CAAC,kBAAkB,EAAE,iBAAiB,GAAG,OAAO,GAAG,eAAe,CAAC,CAAC;CAO7G;AAED,wBAAgB,mCAAmC,CACjD,WAAW,EAAE,oBAAoB,EACjC,OAAO,GAAE,0BAA+B,GACvC,6BAA6B,CAQ/B;AAED,wBAAgB,4BAA4B,CAAC,WAAW,EAAE,oBAAoB,GAAG,YAAY,CAO5F"}

package/dist/mcp-server/persistence.js

@@ -0,0 +1,309 @@
+import { mkdirSync } from "node:fs";
+import { createRequire } from "node:module";
+import { homedir } from "node:os";
+import { dirname, join, resolve } from "node:path";
+import { ConversationTracker, ProfileStore, } from "./state.js";
+const require = createRequire(import.meta.url);
+export const DEFAULT_MCP_STATE_DB_PATH = join(homedir(), ".artemys", "state.db");
+function createNodeSqliteDatabase(pathValue) {
+    try {
+        const module = require("node:sqlite");
+        const db = new module.DatabaseSync(pathValue);
+        return {
+            exec: (sql) => db.exec(sql),
+            prepare: (sql) => {
+                const statement = db.prepare(sql);
+                return {
+                    run: (...params) => statement.run(...params),
+                    get: (...params) => statement.get(...params),
+                    all: (...params) => statement.all(...params),
+                };
+            },
+            close: () => db.close(),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function createBunSqliteDatabase(pathValue) {
+    if (typeof globalThis.Bun === "undefined") {
+        return null;
+    }
+    try {
+        const module = require("bun:sqlite");
+        const db = new module.Database(pathValue);
+        return {
+            exec: (sql) => {
+                if (typeof db.exec === "function") {
+                    db.exec(sql);
+                    return;
+                }
+                db.run(sql);
+            },
+            prepare: (sql) => {
+                const statement = db.query(sql);
+                return {
+                    run: (...params) => statement.run(...params),
+                    get: (...params) => statement.get(...params),
+                    all: (...params) => statement.all(...params),
+                };
+            },
+            close: () => db.close(),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function openSqliteDatabase(pathValue) {
+    const nodeDatabase = createNodeSqliteDatabase(pathValue);
+    if (nodeDatabase) {
+        return nodeDatabase;
+    }
+    const bunDatabase = createBunSqliteDatabase(pathValue);
+    if (bunDatabase) {
+        return bunDatabase;
+    }
+    throw new Error("SQLite persistence is unavailable. Use Node 22+ (node:sqlite) or Bun runtime with bun:sqlite support.");
+}
+export function resolveMcpStateDbPath(pathValue) {
+    if (!pathValue || pathValue.trim().length === 0) {
+        return DEFAULT_MCP_STATE_DB_PATH;
+    }
+    const trimmed = pathValue.trim();
+    if (trimmed === "~") {
+        return DEFAULT_MCP_STATE_DB_PATH;
+    }
+    if (trimmed.startsWith("~/")) {
+        return join(homedir(), trimmed.slice(2));
+    }
+    return resolve(trimmed);
+}
+export class SqliteMcpPersistence {
+    path;
+    db;
+    constructor(options = {}) {
+        this.path = resolveMcpStateDbPath(options.path);
+        mkdirSync(dirname(this.path), { recursive: true });
+        this.db = openSqliteDatabase(this.path);
+        this.initialize();
+    }
+    initialize() {
+        this.db.exec(`
+      PRAGMA foreign_keys = ON;
+
+      CREATE TABLE IF NOT EXISTS conversations (
+        conversation_id TEXT PRIMARY KEY,
+        state TEXT NOT NULL,
+        message_count INTEGER NOT NULL,
+        updated_at TEXT NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS messages (
+        conversation_id TEXT NOT NULL,
+        message_index INTEGER NOT NULL,
+        message_id TEXT NOT NULL,
+        timestamp TEXT NOT NULL,
+        payload TEXT NOT NULL,
+        PRIMARY KEY (conversation_id, message_index),
+        FOREIGN KEY (conversation_id) REFERENCES conversations(conversation_id) ON DELETE CASCADE
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_messages_conversation
+      ON messages (conversation_id, message_index);
+
+      CREATE TABLE IF NOT EXISTS profile (
+        id INTEGER PRIMARY KEY CHECK (id = 1),
+        snapshot TEXT,
+        updated_at TEXT NOT NULL
+      );
+      `);
+    }
+    loadProfile() {
+        const row = this.db.prepare("SELECT snapshot FROM profile WHERE id = 1 LIMIT 1").get();
+        if (!row || typeof row.snapshot !== "string") {
+            return null;
+        }
+        try {
+            return JSON.parse(row.snapshot);
+        }
+        catch {
+            return null;
+        }
+    }
+    saveProfile(snapshot) {
+        if (snapshot === null) {
+            this.db.prepare("DELETE FROM profile WHERE id = 1").run();
+            return;
+        }
+        this.db
+            .prepare(`
+        INSERT INTO profile (id, snapshot, updated_at)
+        VALUES (1, ?, ?)
+        ON CONFLICT(id) DO UPDATE SET
+          snapshot = excluded.snapshot,
+          updated_at = excluded.updated_at
+        `)
+            .run(JSON.stringify(snapshot), new Date().toISOString());
+    }
+    loadConversations() {
+        const rows = this.db
+            .prepare("SELECT conversation_id, state, message_count FROM conversations ORDER BY updated_at ASC")
+            .all();
+        const records = [];
+        for (const row of rows) {
+            if (typeof row.conversation_id !== "string") {
+                continue;
+            }
+            const messageRows = this.db
+                .prepare("SELECT payload FROM messages WHERE conversation_id = ? ORDER BY message_index ASC")
+                .all(row.conversation_id);
+            const messages = [];
+            for (const messageRow of messageRows) {
+                if (typeof messageRow.payload !== "string") {
+                    continue;
+                }
+                try {
+                    messages.push(JSON.parse(messageRow.payload));
+                }
+                catch {
+                    // Skip malformed persisted payloads.
+                }
+            }
+            records.push({
+                conversation_id: row.conversation_id,
+                state: (typeof row.state === "string" ? row.state : "NEW"),
+                message_count: (() => {
+                    const parsed = typeof row.message_count === "number"
+                        ? row.message_count
+                        : Number.parseInt(String(row.message_count ?? messages.length), 10);
+                    return Number.isFinite(parsed) ? parsed : messages.length;
+                })(),
+                messages,
+            });
+        }
+        return records;
+    }
+    saveConversations(records) {
+        this.db.exec("BEGIN");
+        try {
+            this.db.prepare("DELETE FROM messages").run();
+            this.db.prepare("DELETE FROM conversations").run();
+            const insertConversation = this.db.prepare(`
+        INSERT INTO conversations (conversation_id, state, message_count, updated_at)
+        VALUES (?, ?, ?, ?)
+        `);
+            const insertMessage = this.db.prepare(`
+        INSERT INTO messages (conversation_id, message_index, message_id, timestamp, payload)
+        VALUES (?, ?, ?, ?, ?)
+        `);
+            for (const record of records) {
+                const updatedAt = record.messages[record.messages.length - 1]?.timestamp ?? new Date().toISOString();
+                insertConversation.run(record.conversation_id, record.state, record.messages.length, updatedAt);
+                for (let index = 0; index < record.messages.length; index += 1) {
+                    const message = record.messages[index];
+                    insertMessage.run(record.conversation_id, index, message.message_id, message.timestamp, JSON.stringify(message));
+                }
+            }
+            this.db.exec("COMMIT");
+        }
+        catch (error) {
+            try {
+                this.db.exec("ROLLBACK");
+            }
+            catch {
+                // Ignore rollback failures.
+            }
+            throw error;
+        }
+    }
+    close() {
+        this.db.close();
+    }
+}
+export class PersistentConversationTracker extends ConversationTracker {
+    onPersist;
+    persistOnRead;
+    constructor(options = {}) {
+        const { initialRecords = [], onPersist, ...trackerOptions } = options;
+        super(trackerOptions);
+        this.onPersist = onPersist;
+        this.persistOnRead =
+            typeof trackerOptions.conversationTtlMs === "number" && Number.isFinite(trackerOptions.conversationTtlMs);
+        for (const record of initialRecords) {
+            for (const message of record.messages) {
+                try {
+                    super.recordMessage(message);
+                }
+                catch {
+                    break;
+                }
+            }
+        }
+        this.persistSnapshot();
+    }
+    persistSnapshot() {
+        if (!this.onPersist) {
+            return;
+        }
+        const records = [];
+        for (const summary of super.listConversations()) {
+            const record = super.getConversation(summary.conversation_id);
+            if (!record) {
+                continue;
+            }
+            records.push({
+                conversation_id: record.conversation_id,
+                state: record.state,
+                message_count: record.message_count,
+                messages: [...record.messages],
+            });
+        }
+        this.onPersist(records);
+    }
+    getState(conversationId) {
+        const state = super.getState(conversationId);
+        if (this.persistOnRead) {
+            this.persistSnapshot();
+        }
+        return state;
+    }
+    getConversation(conversationId) {
+        const record = super.getConversation(conversationId);
+        if (this.persistOnRead) {
+            this.persistSnapshot();
+        }
+        return record;
+    }
+    recordMessage(message) {
+        const result = super.recordMessage(message);
+        this.persistSnapshot();
+        return result;
+    }
+    listConversations() {
+        const summaries = super.listConversations();
+        if (this.persistOnRead) {
+            this.persistSnapshot();
+        }
+        return summaries;
+    }
+}
+export function createPersistentConversationTracker(persistence, options = {}) {
+    return new PersistentConversationTracker({
+        ...options,
+        initialRecords: persistence.loadConversations(),
+        onPersist: (records) => {
+            persistence.saveConversations(records);
+        },
+    });
+}
+export function createPersistentProfileStore(persistence) {
+    return new ProfileStore({
+        initialProfile: persistence.loadProfile(),
+        onPersist: (snapshot) => {
+            persistence.saveProfile(snapshot);
+        },
+    });
+}
+//# sourceMappingURL=persistence.js.map

package/dist/mcp-server/persistence.js.map

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

package/dist/mcp-server/resources.d.ts

@@ -0,0 +1,20 @@
+import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { AgentCard } from "../discovery/index.js";
+import type { ConversationTracker } from "./state.js";
+export interface ResourceServer {
+    registerResource: (name: string, uriOrTemplate: string | ResourceTemplate, config: {
+        title?: string;
+        description?: string;
+        mimeType?: string;
+    }, readCallback: (uri: URL, variables?: Record<string, string>) => Promise<{
+        contents: Array<{
+            uri: string;
+            text: string;
+        }>;
+    }>) => unknown;
+}
+export declare function registerMcpResources(server: ResourceServer, deps: {
+    agentCard: AgentCard;
+    tracker: ConversationTracker;
+}): void;
+//# sourceMappingURL=resources.d.ts.map

package/dist/mcp-server/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../src/mcp-server/resources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAA;AAC1E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAErD,MAAM,WAAW,cAAc;IAC7B,gBAAgB,EAAE,CAChB,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,MAAM,GAAG,gBAAgB,EACxC,MAAM,EAAE;QACN,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;KAClB,EACD,YAAY,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,OAAO,CAAC;QACtE,QAAQ,EAAE,KAAK,CAAC;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAC/C,CAAC,KACC,OAAO,CAAA;CACb;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE;IAAE,SAAS,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,mBAAmB,CAAA;CAAE,GAC3D,IAAI,CA+DN"}

package/dist/mcp-server/resources.js

@@ -0,0 +1,49 @@
+import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+export function registerMcpResources(server, deps) {
+    server.registerResource("agent-card", "artemys://agent-card", {
+        title: "Artemys Agent Card",
+        description: "This agent's registered card",
+        mimeType: "application/json",
+    }, async () => {
+        return {
+            contents: [
+                {
+                    uri: "artemys://agent-card",
+                    text: JSON.stringify(deps.agentCard, null, 2),
+                },
+            ],
+        };
+    });
+    server.registerResource("conversations", "artemys://conversations", {
+        title: "Active Conversations",
+        description: "List of tracked conversations",
+        mimeType: "application/json",
+    }, async () => {
+        return {
+            contents: [
+                {
+                    uri: "artemys://conversations",
+                    text: JSON.stringify(deps.tracker.listConversations(), null, 2),
+                },
+            ],
+        };
+    });
+    const template = new ResourceTemplate("artemys://conversations/{id}", { list: undefined });
+    server.registerResource("conversation-by-id", template, {
+        title: "Conversation Details",
+        description: "Conversation state and message history",
+        mimeType: "application/json",
+    }, async (_uri, variables) => {
+        const conversationId = variables?.id ?? "";
+        const record = deps.tracker.getConversation(conversationId);
+        return {
+            contents: [
+                {
+                    uri: `artemys://conversations/${conversationId}`,
+                    text: JSON.stringify(record, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=resources.js.map

package/dist/mcp-server/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../../src/mcp-server/resources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAA;AAmB1E,MAAM,UAAU,oBAAoB,CAClC,MAAsB,EACtB,IAA4D;IAE5D,MAAM,CAAC,gBAAgB,CACrB,YAAY,EACZ,sBAAsB,EACtB;QACE,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EAAE,8BAA8B;QAC3C,QAAQ,EAAE,kBAAkB;KAC7B,EACD,KAAK,IAAI,EAAE;QACT,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,sBAAsB;oBAC3B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;iBAC9C;aACF;SACF,CAAA;IACH,CAAC,CACF,CAAA;IAED,MAAM,CAAC,gBAAgB,CACrB,eAAe,EACf,yBAAyB,EACzB;QACE,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EAAE,+BAA+B;QAC5C,QAAQ,EAAE,kBAAkB;KAC7B,EACD,KAAK,IAAI,EAAE;QACT,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,yBAAyB;oBAC9B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;iBAChE;aACF;SACF,CAAA;IACH,CAAC,CACF,CAAA;IAED,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,8BAA8B,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAA;IAC1F,MAAM,CAAC,gBAAgB,CACrB,oBAAoB,EACpB,QAAQ,EACR;QACE,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EAAE,wCAAwC;QACrD,QAAQ,EAAE,kBAAkB;KAC7B,EACD,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE;QACxB,MAAM,cAAc,GAAG,SAAS,EAAE,EAAE,IAAI,EAAE,CAAA;QAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,cAAc,CAAC,CAAA;QAC3D,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,2BAA2B,cAAc,EAAE;oBAChD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;iBACtC;aACF;SACF,CAAA;IACH,CAAC,CACF,CAAA;AACH,CAAC"}

package/dist/mcp-server/server.d.ts

@@ -0,0 +1,33 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { AgentCard } from "../discovery/index.js";
+import type { CoffeeShopClient } from "../coffeeshop/index.js";
+import type { ProtocolTransportClient } from "../transport/index.js";
+import { SqliteMcpPersistence } from "./persistence.js";
+import { ConversationTracker, ProfileStore } from "./state.js";
+export interface CreateArtemysMcpServerOptions {
+    agentCard: AgentCard;
+    coffeeShopClient: CoffeeShopClient;
+    transportClient: ProtocolTransportClient;
+    tracker?: ConversationTracker;
+    profileStore?: ProfileStore;
+    persist?: boolean | string;
+    enableIntroTools?: boolean;
+    maxTrackedConversations?: number;
+    conversationTtlMs?: number;
+}
+export interface StartArtemysMcpServerOptions extends CreateArtemysMcpServerOptions {
+    transport?: "stdio" | "sse";
+    port?: number;
+    host?: string;
+}
+export interface StartedMcpServer {
+    close: () => Promise<void>;
+}
+export declare function createArtemysMcpServer(options: CreateArtemysMcpServerOptions): {
+    server: McpServer;
+    tracker: ConversationTracker;
+    profileStore: ProfileStore;
+    persistence?: SqliteMcpPersistence;
+};
+export declare function startArtemysMcpServer(options: StartArtemysMcpServerOptions): Promise<StartedMcpServer>;
+//# sourceMappingURL=server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp-server/server.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAGnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAC9D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AACpE,OAAO,EACL,oBAAoB,EAGrB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAI9D,MAAM,WAAW,6BAA6B;IAC5C,SAAS,EAAE,SAAS,CAAA;IACpB,gBAAgB,EAAE,gBAAgB,CAAA;IAClC,eAAe,EAAE,uBAAuB,CAAA;IACxC,OAAO,CAAC,EAAE,mBAAmB,CAAA;IAC7B,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;IAC1B,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,uBAAuB,CAAC,EAAE,MAAM,CAAA;IAChC,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,4BAA6B,SAAQ,6BAA6B;IACjF,SAAS,CAAC,EAAE,OAAO,GAAG,KAAK,CAAA;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3B;AA0ED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,6BAA6B,GAAG;IAC9E,MAAM,EAAE,SAAS,CAAA;IACjB,OAAO,EAAE,mBAAmB,CAAA;IAC5B,YAAY,EAAE,YAAY,CAAA;IAC1B,WAAW,CAAC,EAAE,oBAAoB,CAAA;CACnC,CAsCA;AAED,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,gBAAgB,CAAC,CA+I3B"}