@outsidedata/dolex 0.1.0

package/dist/src/mcp/tools/screenshot.js

@@ -0,0 +1,79 @@
+/**
+ * MCP Tool: screenshot
+ * Renders a visualization to PNG via headless Chromium (Playwright).
+ * Returns a base64-encoded image that Claude can see directly.
+ *
+ * Requires: npm install playwright && npx playwright install chromium
+ */
+import { z } from 'zod';
+import { isCompoundSpec } from '../../types.js';
+import { buildChartHtml, isHtmlPatternSupported } from '../../renderers/html/index.js';
+import { buildCompoundHtml } from '../../renderers/html/builders/compound.js';
+import { specStore } from '../spec-store.js';
+import { errorResponse } from './shared.js';
+export const screenshotInputSchema = z.object({
+    specId: z.string().describe('Spec ID from a previous visualize, visualize_from_source, or refine call'),
+    width: z.number().optional().describe('Image width in pixels (default: 800)'),
+    height: z.number().optional().describe('Image height in pixels (default: 600)'),
+});
+let browserInstance = null;
+async function getBrowser() {
+    if (browserInstance && browserInstance.isConnected()) {
+        return browserInstance;
+    }
+    const pw = await import('playwright');
+    browserInstance = await pw.chromium.launch();
+    return browserInstance;
+}
+export async function closeBrowser() {
+    if (browserInstance) {
+        await browserInstance.close();
+        browserInstance = null;
+    }
+}
+export function handleScreenshot() {
+    return async (args) => {
+        const stored = specStore.get(args.specId);
+        if (!stored) {
+            return errorResponse(`Spec "${args.specId}" not found or expired. Create a new visualization first.`);
+        }
+        const { spec } = stored;
+        let html;
+        if (isCompoundSpec(spec)) {
+            html = buildCompoundHtml(spec);
+        }
+        else if (isHtmlPatternSupported(spec.pattern)) {
+            html = buildChartHtml(spec);
+        }
+        else {
+            return errorResponse(`Pattern "${spec.pattern}" does not have an HTML builder.`);
+        }
+        const width = args.width ?? 800;
+        const height = args.height ?? 600;
+        let browser;
+        try {
+            browser = await getBrowser();
+        }
+        catch {
+            return errorResponse('Playwright is not installed. Run: npm install playwright && npx playwright install chromium');
+        }
+        const page = await browser.newPage({ viewport: { width, height } });
+        try {
+            await page.setContent(html, { waitUntil: 'networkidle' });
+            await page.waitForTimeout(300);
+            const buffer = await page.screenshot({ type: 'png' });
+            const base64 = buffer.toString('base64');
+            return {
+                content: [{
+                        type: 'image',
+                        data: base64,
+                        mimeType: 'image/png',
+                    }],
+            };
+        }
+        finally {
+            await page.close();
+        }
+    };
+}
+//# sourceMappingURL=screenshot.js.map

package/dist/src/mcp/tools/screenshot.js.map

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

package/dist/src/mcp/tools/server-privacy.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Server privacy tools — inspect and clear cached data.
+ *
+ * server_status: Shows what data is currently held in memory.
+ * clear_cache: Clears cached specs and query results.
+ */
+import { z } from 'zod';
+import type { SourceManager } from '../../connectors/manager.js';
+export declare const clearCacheInputSchema: z.ZodObject<{
+    scope: z.ZodDefault<z.ZodEnum<["all", "specs", "results"]>>;
+}, "strip", z.ZodTypeAny, {
+    scope: "all" | "specs" | "results";
+}, {
+    scope?: "all" | "specs" | "results" | undefined;
+}>;
+interface PrivacyDeps {
+    sourceManager: SourceManager;
+    serverStartTime: number;
+}
+export declare function handleServerStatus(deps: PrivacyDeps): () => Promise<import("./shared.js").McpResponse>;
+export declare function handleClearCache(deps: PrivacyDeps): ({ scope }: z.infer<typeof clearCacheInputSchema>) => Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+export {};
+//# sourceMappingURL=server-privacy.d.ts.map

package/dist/src/mcp/tools/server-privacy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-privacy.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/server-privacy.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAGjE,eAAO,MAAM,qBAAqB;;;;;;EAGhC,CAAC;AAEH,UAAU,WAAW;IACnB,aAAa,EAAE,aAAa,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,oDAqCnD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,IAClC,WAAW,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC;;;;;GA2B/D"}

package/dist/src/mcp/tools/server-privacy.js

@@ -0,0 +1,77 @@
+/**
+ * Server privacy tools — inspect and clear cached data.
+ *
+ * server_status: Shows what data is currently held in memory.
+ * clear_cache: Clears cached specs and query results.
+ */
+import { z } from 'zod';
+import { specStore } from '../spec-store.js';
+import { clearResultCache, resultCacheStats } from './result-cache.js';
+import { operationLog } from './operation-log.js';
+import { jsonResponse, formatUptime } from './shared.js';
+export const clearCacheInputSchema = z.object({
+    scope: z.enum(['all', 'specs', 'results']).default('all')
+        .describe('What to clear: "all" (everything), "specs" (visualization specs + data), "results" (query result cache).'),
+});
+export function handleServerStatus(deps) {
+    return async () => {
+        const specStats = specStore.stats();
+        const resultStats = resultCacheStats();
+        const sources = deps.sourceManager.list();
+        const sourcesSummary = sources.map(s => ({
+            id: s.id,
+            name: s.name,
+            type: s.type,
+            connected: deps.sourceManager.isConnected(s.id),
+        }));
+        return jsonResponse({
+            uptime: formatUptime(Date.now() - deps.serverStartTime),
+            specStore: {
+                cachedSpecs: specStats.entries,
+                maxSpecs: specStats.maxEntries,
+                totalDataRows: specStats.totalDataRows,
+                ttl: '1 hour',
+                oldestEntryAge: specStats.oldestEntryAge
+                    ? `${Math.floor(specStats.oldestEntryAge / 60000)} minutes`
+                    : null,
+            },
+            resultCache: {
+                cachedResults: resultStats.entries,
+                maxResults: resultStats.maxEntries,
+                totalDataRows: resultStats.totalRows,
+                ttl: '10 minutes',
+            },
+            sources: {
+                registered: sources.length,
+                connected: sourcesSummary.filter(s => s.connected).length,
+                list: sourcesSummary,
+            },
+        });
+    };
+}
+export function handleClearCache(deps) {
+    return async ({ scope }) => {
+        const cleared = [];
+        if (scope === 'all' || scope === 'specs') {
+            const count = specStore.size;
+            specStore.clear();
+            cleared.push(`Cleared ${count} cached visualization specs`);
+        }
+        if (scope === 'all' || scope === 'results') {
+            const stats = resultCacheStats();
+            clearResultCache();
+            cleared.push(`Cleared ${stats.entries} cached query results`);
+        }
+        if (scope === 'all') {
+            operationLog.clear();
+            cleared.push('Cleared operation log');
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: cleared.join('\n'),
+                }],
+        };
+    };
+}
+//# sourceMappingURL=server-privacy.js.map

package/dist/src/mcp/tools/server-privacy.js.map

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

package/dist/src/mcp/tools/shared.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Shared utilities for MCP tool handlers.
+ *
+ * Consolidates duplicated logic:
+ * - MCP response builders (error/success/html patterns)
+ * - Column inference from data rows
+ * - Color preference application to visualization specs
+ * - Dashboard-specific helpers (time bucket handling, auto layout)
+ * - Dashboard view execution (query + pattern selection + overrides)
+ */
+import type { DataColumn, VisualizationSpec, DashboardViewSpec } from '../../types.js';
+import type { DashboardViewData } from '../../renderers/html/builders/dashboard.js';
+type McpTextContent = {
+    type: 'text';
+    text: string;
+};
+export interface McpResponse {
+    [key: string]: unknown;
+    content: McpTextContent[];
+    isError?: boolean;
+    structuredContent?: {
+        html: string;
+    };
+}
+export declare function errorResponse(message: string): McpResponse;
+export declare function jsonResponse(body: unknown): McpResponse;
+export declare function htmlResponse(body: unknown, html: string): McpResponse;
+export declare function inferColumns(data: Record<string, any>[]): DataColumn[];
+export declare function applyColorPreferences(spec: VisualizationSpec, prefs?: DashboardViewSpec['colorPreferences']): void;
+export declare function formatUptime(ms: number): string;
+export declare function autoLayout(viewCount: number): {
+    columns: number;
+};
+export interface ViewExecutionResult {
+    viewData: DashboardViewData[];
+    viewReasonings: {
+        viewId: string;
+        pattern: string;
+        reasoning: string;
+    }[];
+}
+/**
+ * Execute queries and select patterns for each dashboard view.
+ * Shared between create_dashboard and refine_dashboard.
+ */
+export declare function executeDashboardViews(views: DashboardViewSpec[], sourceId: string, table: string, sourceManager: any): Promise<ViewExecutionResult | McpResponse>;
+export declare function isViewExecutionError(result: ViewExecutionResult | McpResponse): result is McpResponse;
+export {};
+//# sourceMappingURL=shared.d.ts.map

package/dist/src/mcp/tools/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/shared.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,UAAU,EAEV,iBAAiB,EAEjB,iBAAiB,EAClB,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AAIpF,KAAK,cAAc,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAErD,MAAM,WAAW,WAAW;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iBAAiB,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACtC;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAK1D;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,CAIvD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAKrE;AAID,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,UAAU,EAAE,CA6BtE;AAID,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,iBAAiB,EACvB,KAAK,CAAC,EAAE,iBAAiB,CAAC,kBAAkB,CAAC,GAC5C,IAAI,CAmBN;AA8BD,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAI/C;AAID,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAIjE;AAID,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,cAAc,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC1E;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,iBAAiB,EAAE,EAC1B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,GAAG,GACjB,OAAO,CAAC,mBAAmB,GAAG,WAAW,CAAC,CA8C5C;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,mBAAmB,GAAG,WAAW,GAAG,MAAM,IAAI,WAAW,CAErG"}

package/dist/src/mcp/tools/shared.js

@@ -0,0 +1,170 @@
+/**
+ * Shared utilities for MCP tool handlers.
+ *
+ * Consolidates duplicated logic:
+ * - MCP response builders (error/success/html patterns)
+ * - Column inference from data rows
+ * - Color preference application to visualization specs
+ * - Dashboard-specific helpers (time bucket handling, auto layout)
+ * - Dashboard view execution (query + pattern selection + overrides)
+ */
+import { selectPattern } from '../../patterns/selector.js';
+export function errorResponse(message) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify({ error: message }) }],
+        isError: true,
+    };
+}
+export function jsonResponse(body) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(body, null, 2) }],
+    };
+}
+export function htmlResponse(body, html) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(body, null, 2) }],
+        structuredContent: { html },
+    };
+}
+// ─── COLUMN INFERENCE ───────────────────────────────────────────────────────
+export function inferColumns(data) {
+    if (data.length === 0)
+        return [];
+    const keys = Object.keys(data[0]);
+    return keys.map(key => {
+        const values = data.map(r => r[key]).filter(v => v != null);
+        const stringValues = values.map(String);
+        const uniqueValues = [...new Set(stringValues)];
+        const numericCount = values.filter(v => typeof v === 'number' || (typeof v === 'string' && !isNaN(Number(v)) && v !== '')).length;
+        const isNumeric = numericCount > values.length * 0.7;
+        const isDate = /date|time|year|month|day/i.test(key) ||
+            values.every(v => /^\d{4}[-/]/.test(String(v)));
+        const isId = /^id$|_id$|Id$/i.test(key) && uniqueValues.length > data.length * 0.5;
+        let type = 'categorical';
+        if (isId)
+            type = 'id';
+        else if (isDate)
+            type = 'date';
+        else if (isNumeric)
+            type = 'numeric';
+        return {
+            name: key,
+            type,
+            sampleValues: uniqueValues.slice(0, 20),
+            uniqueCount: uniqueValues.length,
+            nullCount: data.length - values.length,
+            totalCount: data.length,
+        };
+    });
+}
+// ─── COLOR PREFERENCES ─────────────────────────────────────────────────────
+export function applyColorPreferences(spec, prefs) {
+    if (!prefs)
+        return;
+    if (!spec.encoding.color)
+        spec.encoding.color = {};
+    if (prefs.palette) {
+        spec.encoding.color.palette = prefs.palette;
+    }
+    if (prefs.highlight) {
+        spec.encoding.color.highlight = {
+            values: prefs.highlight.values,
+            ...(prefs.highlight.color != null ? { color: prefs.highlight.color } : {}),
+            ...(prefs.highlight.mutedColor != null ? { mutedColor: prefs.highlight.mutedColor } : {}),
+            ...(prefs.highlight.mutedOpacity != null ? { mutedOpacity: prefs.highlight.mutedOpacity } : {}),
+        };
+    }
+    if (prefs.colorField) {
+        spec.encoding.color.field = prefs.colorField;
+        if (!spec.encoding.color.type)
+            spec.encoding.color.type = 'nominal';
+    }
+}
+// ─── TIME BUCKET HELPERS ────────────────────────────────────────────────────
+function getTimeBucketedFields(groupBy) {
+    if (!groupBy)
+        return [];
+    return groupBy
+        .filter((g) => typeof g === 'object' && 'bucket' in g)
+        .map(g => g.field);
+}
+function enhanceIntentForTimeBucket(intent, groupBy) {
+    const bucketedFields = getTimeBucketedFields(groupBy);
+    if (bucketedFields.length > 0 && !/time.series|trend|over.time/i.test(intent)) {
+        return intent + ' (time series trend)';
+    }
+    return intent;
+}
+function applyTimeBucketColumnTypes(columns, groupBy) {
+    const bucketedFields = getTimeBucketedFields(groupBy);
+    for (const col of columns) {
+        if (bucketedFields.some(f => col.name.includes(f) || f.includes(col.name))) {
+            col.type = 'date';
+        }
+    }
+}
+// ─── FORMATTING ─────────────────────────────────────────────────────────────
+export function formatUptime(ms) {
+    const min = Math.floor(ms / 60000);
+    if (min < 60)
+        return `${min} minutes`;
+    return `${Math.floor(min / 60)}h ${min % 60}m`;
+}
+// ─── DASHBOARD LAYOUT ───────────────────────────────────────────────────────
+export function autoLayout(viewCount) {
+    if (viewCount <= 1)
+        return { columns: 1 };
+    if (viewCount <= 4)
+        return { columns: 2 };
+    return { columns: 3 };
+}
+/**
+ * Execute queries and select patterns for each dashboard view.
+ * Shared between create_dashboard and refine_dashboard.
+ */
+export async function executeDashboardViews(views, sourceId, table, sourceManager) {
+    const viewData = [];
+    const viewReasonings = [];
+    for (const view of views) {
+        const result = await sourceManager.queryDsl(sourceId, table, view.query);
+        if (!result.ok) {
+            return errorResponse(`Query failed for view "${view.id}": ${result.error}`);
+        }
+        const data = result.rows;
+        const columns = inferColumns(data);
+        applyTimeBucketColumnTypes(columns, view.query.groupBy);
+        const intent = enhanceIntentForTimeBucket(view.intent, view.query.groupBy);
+        const selection = selectPattern(data, columns, intent);
+        let spec;
+        let reasoning;
+        if (view.pattern) {
+            const match = [selection.recommended, ...selection.alternatives]
+                .find(r => r.pattern.id === view.pattern);
+            if (match) {
+                spec = match.spec;
+                reasoning = `Pattern: ${view.pattern}`;
+            }
+            else {
+                spec = selection.recommended.spec;
+                spec.pattern = view.pattern;
+                reasoning = `Pattern: ${view.pattern} (fallback)`;
+            }
+        }
+        else {
+            spec = selection.recommended.spec;
+            reasoning = selection.recommended.reasoning;
+        }
+        spec.title = view.title;
+        if (view.config) {
+            spec.config = { ...spec.config, ...view.config };
+        }
+        applyColorPreferences(spec, view.colorPreferences);
+        viewData.push({ viewId: view.id, data, spec });
+        viewReasonings.push({ viewId: view.id, pattern: spec.pattern, reasoning });
+    }
+    return { viewData, viewReasonings };
+}
+export function isViewExecutionError(result) {
+    return 'content' in result;
+}
+//# sourceMappingURL=shared.js.map

package/dist/src/mcp/tools/shared.js.map

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

package/dist/src/mcp/tools/sources.d.ts

@@ -0,0 +1,160 @@
+/**
+ * MCP Tools: list_sources, add_source, remove_source, describe_source
+ * Manage data source connections.
+ */
+import { z } from 'zod';
+export declare function isSandboxPath(filePath: string): boolean;
+export declare const addSourceInputSchema: z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodEnum<["csv", "sqlite", "postgres", "mysql"]>;
+    config: z.ZodUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"csv">;
+        path: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "csv";
+        path: string;
+    }, {
+        type: "csv";
+        path: string;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"sqlite">;
+        path: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "sqlite";
+        path: string;
+    }, {
+        type: "sqlite";
+        path: string;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"postgres">;
+        host: z.ZodString;
+        port: z.ZodDefault<z.ZodNumber>;
+        database: z.ZodString;
+        user: z.ZodString;
+        password: z.ZodString;
+        ssl: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        type: "postgres";
+        host: string;
+        port: number;
+        database: string;
+        user: string;
+        password: string;
+        ssl?: boolean | undefined;
+    }, {
+        type: "postgres";
+        host: string;
+        database: string;
+        user: string;
+        password: string;
+        port?: number | undefined;
+        ssl?: boolean | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"mysql">;
+        host: z.ZodString;
+        port: z.ZodDefault<z.ZodNumber>;
+        database: z.ZodString;
+        user: z.ZodString;
+        password: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "mysql";
+        host: string;
+        port: number;
+        database: string;
+        user: string;
+        password: string;
+    }, {
+        type: "mysql";
+        host: string;
+        database: string;
+        user: string;
+        password: string;
+        port?: number | undefined;
+    }>]>;
+    detail: z.ZodDefault<z.ZodEnum<["compact", "full"]>>;
+}, "strip", z.ZodTypeAny, {
+    type: "csv" | "sqlite" | "postgres" | "mysql";
+    config: {
+        type: "csv";
+        path: string;
+    } | {
+        type: "sqlite";
+        path: string;
+    } | {
+        type: "postgres";
+        host: string;
+        port: number;
+        database: string;
+        user: string;
+        password: string;
+        ssl?: boolean | undefined;
+    } | {
+        type: "mysql";
+        host: string;
+        port: number;
+        database: string;
+        user: string;
+        password: string;
+    };
+    name: string;
+    detail: "compact" | "full";
+}, {
+    type: "csv" | "sqlite" | "postgres" | "mysql";
+    config: {
+        type: "csv";
+        path: string;
+    } | {
+        type: "sqlite";
+        path: string;
+    } | {
+        type: "postgres";
+        host: string;
+        database: string;
+        user: string;
+        password: string;
+        port?: number | undefined;
+        ssl?: boolean | undefined;
+    } | {
+        type: "mysql";
+        host: string;
+        database: string;
+        user: string;
+        password: string;
+        port?: number | undefined;
+    };
+    name: string;
+    detail?: "compact" | "full" | undefined;
+}>;
+export declare const removeSourceInputSchema: z.ZodObject<{
+    sourceId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    sourceId: string;
+}, {
+    sourceId: string;
+}>;
+export declare const describeSourceInputSchema: z.ZodObject<{
+    sourceId: z.ZodString;
+    table: z.ZodOptional<z.ZodString>;
+    detail: z.ZodDefault<z.ZodEnum<["compact", "full"]>>;
+}, "strip", z.ZodTypeAny, {
+    sourceId: string;
+    detail: "compact" | "full";
+    table?: string | undefined;
+}, {
+    sourceId: string;
+    table?: string | undefined;
+    detail?: "compact" | "full" | undefined;
+}>;
+export declare function handleListSources(deps: {
+    sourceManager: any;
+}): () => Promise<import("./shared.js").McpResponse>;
+export declare function handleAddSource(deps: {
+    sourceManager: any;
+}): (args: z.infer<typeof addSourceInputSchema>) => Promise<import("./shared.js").McpResponse>;
+export declare function handleRemoveSource(deps: {
+    sourceManager: any;
+}): (args: z.infer<typeof removeSourceInputSchema>) => Promise<import("./shared.js").McpResponse>;
+export declare function handleDescribeSource(deps: {
+    sourceManager: any;
+}): (args: z.infer<typeof describeSourceInputSchema>) => Promise<import("./shared.js").McpResponse>;
+//# sourceMappingURL=sources.d.ts.map

package/dist/src/mcp/tools/sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sources.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/sources.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+B/B,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;EAElC,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;EAIpC,CAAC;AA8BH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IAAE,aAAa,EAAE,GAAG,CAAA;CAAE,oDAE7D;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE;IAAE,aAAa,EAAE,GAAG,CAAA;CAAE,IAC5C,MAAM,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,gDAkEzD;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IAAE,aAAa,EAAE,GAAG,CAAA;CAAE,IAC/C,MAAM,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,gDAY5D;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IAAE,aAAa,EAAE,GAAG,CAAA;CAAE,IACjD,MAAM,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,gDAuB9D"}