@luckydraw/cumulus 0.5.1

package/dist/lib/summarizer.js

@@ -0,0 +1,213 @@
+import { existsSync } from 'fs';
+import * as fs from 'fs/promises';
+// Constants
+const MESSAGE_THRESHOLD = 50;
+const TOKEN_THRESHOLD = 10000;
+const SUMMARY_FILE_SUFFIX = '.summaries.json';
+/**
+ * Get the summary file path for a thread.
+ */
+export function getSummaryPath(threadPath) {
+    return threadPath.replace('.jsonl', SUMMARY_FILE_SUFFIX);
+}
+/**
+ * Load existing summaries for a thread.
+ */
+export async function loadSummaries(threadPath) {
+    const summaryPath = getSummaryPath(threadPath);
+    if (!existsSync(summaryPath)) {
+        return null;
+    }
+    try {
+        const content = await fs.readFile(summaryPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Save summaries to file.
+ */
+export async function saveSummaries(summaryFile, threadPath) {
+    const summaryPath = getSummaryPath(threadPath);
+    await fs.writeFile(summaryPath, JSON.stringify(summaryFile, null, 2), 'utf-8');
+}
+/**
+ * Check if summarization should be triggered.
+ */
+export function shouldSummarize(lastSummaryIndex, currentIndex, estimatedTokens = 0) {
+    const messageGap = currentIndex - lastSummaryIndex;
+    return messageGap >= MESSAGE_THRESHOLD || estimatedTokens >= TOKEN_THRESHOLD;
+}
+/**
+ * Extract topics from summary text using simple pattern matching.
+ */
+function extractTopicsFromSummary(summary) {
+    const topicPatterns = [
+        /discussed\s+(\w+(?:\s+\w+)?)/gi,
+        /implemented\s+(\w+(?:\s+\w+)?)/gi,
+        /decided\s+(?:on\s+)?(\w+(?:\s+\w+)?)/gi,
+        /working\s+on\s+(\w+(?:\s+\w+)?)/gi,
+        /about\s+(\w+(?:\s+\w+)?)/gi,
+    ];
+    const topics = new Set();
+    for (const pattern of topicPatterns) {
+        const matches = summary.matchAll(pattern);
+        for (const match of matches) {
+            if (match[1]) {
+                topics.add(match[1].toLowerCase());
+            }
+        }
+    }
+    return Array.from(topics).slice(0, 10);
+}
+/**
+ * Format messages for summarization prompt.
+ */
+function formatMessagesForSummary(messages) {
+    return messages
+        .map(m => {
+        const date = new Date(m.timestamp).toISOString().split('T')[0];
+        return `[${date}] ${m.role}: ${m.content}`;
+    })
+        .join('\n\n');
+}
+/**
+ * Generate a summary for a chunk of messages using sub_query.
+ */
+export async function generateChunkSummary(messages, fromIndex, toIndex, subQueryFn) {
+    const context = formatMessagesForSummary(messages);
+    const prompt = `Summarize this conversation segment concisely. Include:
+- Key topics discussed
+- Decisions made
+- Technical concepts or code discussed
+- Action items or next steps
+- Important context for future reference
+
+Keep the summary focused and under 500 words.`;
+    const content = await subQueryFn(prompt, context);
+    const topics = extractTopicsFromSummary(content);
+    return {
+        id: `sum_${Date.now()}_${fromIndex}`,
+        fromIndex,
+        toIndex,
+        generatedAt: Date.now(),
+        content,
+        topics,
+    };
+}
+/**
+ * Generate a high-level session summary from multiple chunk summaries.
+ */
+export async function generateSessionSummary(chunks, subQueryFn) {
+    if (chunks.length <= 1) {
+        return chunks[0]?.content ?? '';
+    }
+    const context = chunks
+        .map(c => `[Messages ${c.fromIndex}-${c.toIndex}]:\n${c.content}`)
+        .join('\n\n---\n\n');
+    const prompt = `Create a high-level summary combining these conversation segments.
+Focus on the overall narrative, major decisions, and key outcomes.
+Keep it concise but comprehensive.`;
+    return await subQueryFn(prompt, context);
+}
+/**
+ * Run summarization for a thread if needed.
+ */
+export async function runSummarization(threadPath, messages, subQueryFn) {
+    if (messages.length === 0) {
+        return;
+    }
+    const currentIndex = messages.length - 1;
+    let summaryFile = await loadSummaries(threadPath);
+    if (!summaryFile) {
+        // Extract thread ID from path
+        const threadId = threadPath.split('/').pop()?.replace('.jsonl', '') ?? 'unknown';
+        summaryFile = {
+            threadId,
+            lastMessageIndex: -1,
+            summaries: [],
+            updatedAt: Date.now(),
+        };
+    }
+    const startIndex = summaryFile.lastMessageIndex + 1;
+    if (!shouldSummarize(summaryFile.lastMessageIndex, currentIndex)) {
+        return; // Not enough new messages
+    }
+    // Get the chunk of messages to summarize
+    const chunk = messages.slice(startIndex, currentIndex + 1);
+    // Generate chunk summary
+    const summary = await generateChunkSummary(chunk, startIndex, currentIndex, subQueryFn);
+    summaryFile.summaries.push(summary);
+    summaryFile.lastMessageIndex = currentIndex;
+    summaryFile.updatedAt = Date.now();
+    // Regenerate session summary if we have multiple chunks
+    if (summaryFile.summaries.length > 1) {
+        summaryFile.sessionSummary = await generateSessionSummary(summaryFile.summaries, subQueryFn);
+    }
+    await saveSummaries(summaryFile, threadPath);
+}
+/**
+ * Get summary based on scope.
+ */
+export async function getSummary(threadPath, scope = 'recent', startIndex, endIndex) {
+    const summaryFile = await loadSummaries(threadPath);
+    if (!summaryFile || summaryFile.summaries.length === 0) {
+        return null;
+    }
+    switch (scope) {
+        case 'recent': {
+            const latest = summaryFile.summaries[summaryFile.summaries.length - 1];
+            if (!latest)
+                return null;
+            return {
+                summary: latest.content,
+                coversMessages: { from: latest.fromIndex, to: latest.toIndex },
+                topics: latest.topics,
+                generatedAt: latest.generatedAt,
+            };
+        }
+        case 'full': {
+            const allTopics = [...new Set(summaryFile.summaries.flatMap(s => s.topics))];
+            const firstChunk = summaryFile.summaries[0];
+            const lastChunk = summaryFile.summaries[summaryFile.summaries.length - 1];
+            if (!firstChunk || !lastChunk)
+                return null;
+            return {
+                summary: summaryFile.sessionSummary ?? lastChunk.content,
+                coversMessages: {
+                    from: firstChunk.fromIndex,
+                    to: lastChunk.toIndex,
+                },
+                topics: allTopics,
+                generatedAt: summaryFile.updatedAt,
+            };
+        }
+        case 'range': {
+            if (startIndex === undefined || endIndex === undefined) {
+                throw new Error('startIndex and endIndex required for range scope');
+            }
+            // Find summaries that overlap with the requested range
+            const relevantSummaries = summaryFile.summaries.filter(s => s.toIndex >= startIndex && s.fromIndex <= endIndex);
+            if (relevantSummaries.length === 0) {
+                return null;
+            }
+            const combinedTopics = [...new Set(relevantSummaries.flatMap(s => s.topics))];
+            const combinedSummary = relevantSummaries.map(s => s.content).join('\n\n');
+            const first = relevantSummaries[0];
+            const last = relevantSummaries[relevantSummaries.length - 1];
+            if (!first || !last)
+                return null;
+            return {
+                summary: combinedSummary,
+                coversMessages: {
+                    from: Math.max(startIndex, first.fromIndex),
+                    to: Math.min(endIndex, last.toIndex),
+                },
+                topics: combinedTopics,
+            };
+        }
+    }
+}
+//# sourceMappingURL=summarizer.js.map

package/dist/lib/summarizer.js.map

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

package/dist/mcp/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":""}

package/dist/mcp/index.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+import { runServer } from './server.js';
+const threadPath = process.env['CUMULUS_THREAD_PATH'];
+const contentPath = process.env['CUMULUS_CONTENT_PATH'];
+const sessionsPath = process.env['CUMULUS_SESSIONS_PATH'];
+const sessionId = process.env['CUMULUS_SESSION_ID'];
+if (!threadPath) {
+    console.error('Error: CUMULUS_THREAD_PATH environment variable is required');
+    console.error('Usage: CUMULUS_THREAD_PATH=/path/to/thread.jsonl node dist/mcp/index.js');
+    process.exit(1);
+}
+runServer(threadPath, contentPath, sessionsPath, sessionId).catch(error => {
+    console.error('MCP server error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;AACtD,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;AACxD,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;AAC1D,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;AAEpD,IAAI,CAAC,UAAU,EAAE,CAAC;IAChB,OAAO,CAAC,KAAK,CAAC,6DAA6D,CAAC,CAAC;IAC7E,OAAO,CAAC,KAAK,CAAC,yEAAyE,CAAC,CAAC;IACzF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,SAAS,CAAC,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;IACxE,OAAO,CAAC,KAAK,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAC;IAC1C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/mcp/proxy.d.ts

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+/**
+ * Lightweight stdio↔HTTP proxy for the shared MCP server.
+ *
+ * Claude CLI spawns this as a normal stdio MCP server.
+ * It forwards every JSON-RPC message to the shared HTTP server
+ * and pipes responses back over stdout.
+ *
+ * Environment variables:
+ *   CUMULUS_SHARED_URL  — Base URL of the shared server (e.g. http://127.0.0.1:3456)
+ *   CUMULUS_THREAD_NAME — Thread name for this agent (e.g. "janus", "puppet")
+ *
+ * Stdin:  newline-delimited JSON-RPC (one JSON object per line)
+ * Stdout: newline-delimited JSON-RPC responses
+ *
+ * Zero heavy deps — only uses Node built-ins (http, readline).
+ */
+export {};
+//# sourceMappingURL=proxy.d.ts.map

package/dist/mcp/proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../../src/mcp/proxy.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;GAeG"}

package/dist/mcp/proxy.js

@@ -0,0 +1,120 @@
+#!/usr/bin/env node
+/**
+ * Lightweight stdio↔HTTP proxy for the shared MCP server.
+ *
+ * Claude CLI spawns this as a normal stdio MCP server.
+ * It forwards every JSON-RPC message to the shared HTTP server
+ * and pipes responses back over stdout.
+ *
+ * Environment variables:
+ *   CUMULUS_SHARED_URL  — Base URL of the shared server (e.g. http://127.0.0.1:3456)
+ *   CUMULUS_THREAD_NAME — Thread name for this agent (e.g. "janus", "puppet")
+ *
+ * Stdin:  newline-delimited JSON-RPC (one JSON object per line)
+ * Stdout: newline-delimited JSON-RPC responses
+ *
+ * Zero heavy deps — only uses Node built-ins (http, readline).
+ */
+import * as http from 'http';
+import * as https from 'https';
+import * as readline from 'readline';
+import { URL } from 'url';
+const sharedUrl = process.env['CUMULUS_SHARED_URL'];
+const threadName = process.env['CUMULUS_THREAD_NAME'];
+if (!sharedUrl || !threadName) {
+    process.stderr.write('Error: CUMULUS_SHARED_URL and CUMULUS_THREAD_NAME environment variables are required\n');
+    process.exit(1);
+}
+const rpcUrl = new URL(`/rpc/${encodeURIComponent(threadName)}`, sharedUrl);
+const httpModule = rpcUrl.protocol === 'https:' ? https : http;
+/**
+ * POST a JSON-RPC message to the shared server and return the response body.
+ * Returns null for 204 (notification acknowledged).
+ */
+function postRpc(body) {
+    return new Promise((resolve, reject) => {
+        const req = httpModule.request(rpcUrl, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Content-Length': Buffer.byteLength(body),
+            },
+        }, res => {
+            if (res.statusCode === 204) {
+                res.resume(); // drain
+                resolve(null);
+                return;
+            }
+            const chunks = [];
+            res.on('data', (chunk) => chunks.push(chunk));
+            res.on('end', () => resolve(Buffer.concat(chunks).toString('utf-8')));
+            res.on('error', reject);
+        });
+        req.on('error', err => {
+            // If the shared server is down, return an error response
+            reject(err);
+        });
+        req.write(body);
+        req.end();
+    });
+}
+// ── Main loop ──────────────────────────────────────────
+const rl = readline.createInterface({
+    input: process.stdin,
+    terminal: false,
+});
+rl.on('line', async (line) => {
+    const trimmed = line.trim();
+    if (!trimmed)
+        return;
+    try {
+        // Parse to validate it's JSON, then forward the raw string
+        const msg = JSON.parse(trimmed);
+        const responseBody = await postRpc(trimmed);
+        if (responseBody !== null) {
+            // Write response as newline-delimited JSON
+            process.stdout.write(responseBody + '\n');
+        }
+        // For notifications (204), no stdout output — Claude doesn't expect a response
+        // If this was a notification and it's "cancelled", we could abort in-flight
+        // requests in the future. For now, just forward and move on.
+        if (msg.method === 'notifications/cancelled') {
+            // Future: could track in-flight requests and abort them
+            process.stderr.write(`[cumulus-proxy] Received cancellation for request ${msg.params?.requestId}\n`);
+        }
+    }
+    catch (err) {
+        // If the shared server is unreachable, return a JSON-RPC error
+        const message = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[cumulus-proxy] Error: ${message}\n`);
+        // Try to extract the id from the original message for the error response
+        let id;
+        try {
+            id = JSON.parse(trimmed).id;
+        }
+        catch {
+            // couldn't parse, leave id undefined
+        }
+        if (id !== undefined) {
+            const errorResponse = {
+                jsonrpc: '2.0',
+                id,
+                error: {
+                    code: -32603,
+                    message: `Proxy error: ${message}`,
+                },
+            };
+            process.stdout.write(JSON.stringify(errorResponse) + '\n');
+        }
+    }
+});
+rl.on('close', () => {
+    // stdin closed — Claude CLI terminated. Exit cleanly.
+    process.exit(0);
+});
+// Handle uncaught errors gracefully
+process.on('uncaughtException', err => {
+    process.stderr.write(`[cumulus-proxy] Uncaught exception: ${err.message}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=proxy.js.map

package/dist/mcp/proxy.js.map

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

package/dist/mcp/server.d.ts

@@ -0,0 +1,6 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { ContentStore } from '../lib/content-store.js';
+import { HistoryStore } from '../lib/history.js';
+export declare function createMcpServer(historyStore: HistoryStore, contentStore?: ContentStore, sessionsPath?: string, currentSessionId?: string): Server;
+export declare function runServer(threadPath: string, contentPath?: string, sessionsPath?: string, sessionId?: string): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAInE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAIjD,wBAAgB,eAAe,CAC7B,YAAY,EAAE,YAAY,EAC1B,YAAY,CAAC,EAAE,YAAY,EAC3B,YAAY,CAAC,EAAE,MAAM,EACrB,gBAAgB,CAAC,EAAE,MAAM,GACxB,MAAM,CAkBR;AAED,wBAAsB,SAAS,CAC7B,UAAU,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,MAAM,EACpB,YAAY,CAAC,EAAE,MAAM,EACrB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CASf"}

package/dist/mcp/server.js

@@ -0,0 +1,29 @@
+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 { ContentStore } from '../lib/content-store.js';
+import { HistoryStore } from '../lib/history.js';
+import { getToolDefinitions, handleToolCall } from './tool-handler.js';
+export function createMcpServer(historyStore, contentStore, sessionsPath, currentSessionId) {
+    const ctx = { historyStore, contentStore, sessionsPath, currentSessionId };
+    const server = new Server({ name: 'cumulus-history', version: '1.0.0' }, { capabilities: { tools: {} } });
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: getToolDefinitions(),
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        return handleToolCall(name, args, ctx);
+    });
+    return server;
+}
+export async function runServer(threadPath, contentPath, sessionsPath, sessionId) {
+    const historyStore = new HistoryStore(threadPath);
+    const contentStore = contentPath ? new ContentStore(contentPath) : undefined;
+    const server = createMcpServer(historyStore, contentStore, sessionsPath, sessionId);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    await new Promise(resolve => {
+        transport.onclose = () => resolve();
+    });
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAEnG,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAe,MAAM,mBAAmB,CAAC;AAEpF,MAAM,UAAU,eAAe,CAC7B,YAA0B,EAC1B,YAA2B,EAC3B,YAAqB,EACrB,gBAAyB;IAEzB,MAAM,GAAG,GAAgB,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,CAAC;IAExF,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,OAAO,EAAE,EAC7C,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAChC,CAAC;IAEF,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC5D,KAAK,EAAE,kBAAkB,EAAE;KAC5B,CAAC,CAAC,CAAC;IAEJ,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAC,OAAO,EAAC,EAAE;QAC9D,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QACjD,OAAO,cAAc,CAAC,IAAI,EAAE,IAA2C,EAAE,GAAG,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,UAAkB,EAClB,WAAoB,EACpB,YAAqB,EACrB,SAAkB;IAElB,MAAM,YAAY,GAAG,IAAI,YAAY,CAAC,UAAU,CAAC,CAAC;IAClD,MAAM,YAAY,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,YAAY,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7E,MAAM,MAAM,GAAG,eAAe,CAAC,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC;IACpF,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,MAAM,IAAI,OAAO,CAAO,OAAO,CAAC,EAAE;QAChC,SAAS,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;IACtC,CAAC,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,21 @@
+/**
+ * Shared MCP server — one HTTP process serving multiple threads.
+ *
+ * Exposes POST /rpc/:threadName which accepts JSON-RPC messages
+ * (the same protocol Claude CLI speaks over stdio).
+ * Caches HistoryStore/ContentStore per thread so the embeddings
+ * model loads once, not once per agent.
+ */
+export interface SharedMcpServerOptions {
+    /** Base directory containing thread data (e.g. ~/.cumulus) */
+    basePath: string;
+    /** Port to listen on. 0 = random available port. */
+    port?: number;
+}
+export interface SharedMcpServerHandle {
+    port: number;
+    url: string;
+    close: () => Promise<void>;
+}
+export declare function startSharedMcpServer(options: SharedMcpServerOptions): Promise<SharedMcpServerHandle>;
+//# sourceMappingURL=shared-server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shared-server.d.ts","sourceRoot":"","sources":["../../src/mcp/shared-server.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAaH,MAAM,WAAW,sBAAsB;IACrC,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AA6LD,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CA0EhC"}