devlens-mcp 0.3.0

package/dist/src/snapshot/snapshot-differ.js

@@ -0,0 +1,153 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.diffSnapshots = diffSnapshots;
+exports.formatDiff = formatDiff;
+/**
+ * Content-based signature — used for element identity.
+ * Intentionally excludes position/size so moved elements are matched
+ * to their previous version rather than treated as add+remove.
+ */
+function contentSignature(node) {
+    return [node.type, node.resourceId || "", node.text || "", node.label || ""].join("|");
+}
+/**
+ * Compute a diff between two snapshot trees.
+ *
+ * Identity matching: uses content signature (type + resourceId + text + label).
+ * Elements with matching content but different position are reported as "moved".
+ * Elements with matching content+position but different size are reported as "resized".
+ * Elements present in current but not previous are "added".
+ * Elements present in previous but not current are "removed".
+ */
+function diffSnapshots(previous, current) {
+    const prevNodes = flattenTree(previous);
+    const currNodes = flattenTree(current);
+    const prevByContent = new Map();
+    for (const node of prevNodes) {
+        prevByContent.set(contentSignature(node), node);
+    }
+    const currByContent = new Map();
+    for (const node of currNodes) {
+        currByContent.set(contentSignature(node), node);
+    }
+    const added = [];
+    const removed = [];
+    const changed = [];
+    const moved = [];
+    const resized = [];
+    // Pass 1: find added, moved, resized, changed nodes
+    for (const [sig, currNode] of currByContent) {
+        const prevNode = prevByContent.get(sig);
+        if (!prevNode) {
+            added.push(currNode);
+            continue;
+        }
+        const posChanged = prevNode.bounds.x !== currNode.bounds.x ||
+            prevNode.bounds.y !== currNode.bounds.y;
+        const sizeChanged = prevNode.bounds.width !== currNode.bounds.width ||
+            prevNode.bounds.height !== currNode.bounds.height;
+        if (posChanged) {
+            moved.push({
+                node: currNode,
+                from: { x: prevNode.bounds.x, y: prevNode.bounds.y },
+                to: { x: currNode.bounds.x, y: currNode.bounds.y },
+                deltaX: currNode.bounds.x - prevNode.bounds.x,
+                deltaY: currNode.bounds.y - prevNode.bounds.y,
+            });
+        }
+        if (sizeChanged) {
+            resized.push({
+                node: currNode,
+                from: { width: prevNode.bounds.width, height: prevNode.bounds.height },
+                to: { width: currNode.bounds.width, height: currNode.bounds.height },
+            });
+        }
+        const changes = detectChanges(prevNode, currNode);
+        if (changes.length > 0) {
+            changed.push({ node: currNode, changes });
+        }
+    }
+    // Pass 2: find removed nodes
+    for (const [sig, node] of prevByContent) {
+        if (!currByContent.has(sig)) {
+            removed.push(node);
+        }
+    }
+    const structuralChange = added.length > prevNodes.length * 0.3 ||
+        removed.length > prevNodes.length * 0.3;
+    return { added, removed, changed, moved, resized, structuralChange };
+}
+/** Detect property-level changes between two nodes with the same identity */
+function detectChanges(prev, curr) {
+    const changes = [];
+    if (prev.text !== curr.text) {
+        changes.push(`text: "${prev.text}" → "${curr.text}"`);
+    }
+    if (prev.value !== curr.value) {
+        changes.push(`value: "${prev.value}" → "${curr.value}"`);
+    }
+    if (prev.focused !== curr.focused) {
+        changes.push(`focused: ${prev.focused} → ${curr.focused}`);
+    }
+    if (prev.enabled !== curr.enabled) {
+        changes.push(`enabled: ${prev.enabled} → ${curr.enabled}`);
+    }
+    if (prev.label !== curr.label) {
+        changes.push(`label: "${prev.label}" → "${curr.label}"`);
+    }
+    return changes;
+}
+/** Flatten a tree into a list of all nodes */
+function flattenTree(node) {
+    const result = [node];
+    for (const child of node.children) {
+        result.push(...flattenTree(child));
+    }
+    return result;
+}
+/** Format a diff for LLM consumption */
+function formatDiff(diff) {
+    if (diff.structuralChange) {
+        return "[Major structural change — use full snapshot]";
+    }
+    const lines = [];
+    if (diff.added.length > 0) {
+        lines.push("ADDED:");
+        for (const node of diff.added) {
+            lines.push(`  + ${node.type} ${node.text ? `"${node.text}"` : ""}`);
+        }
+    }
+    if (diff.removed.length > 0) {
+        lines.push("REMOVED:");
+        for (const node of diff.removed) {
+            lines.push(`  - ${node.type} ${node.text ? `"${node.text}"` : ""}`);
+        }
+    }
+    if (diff.moved.length > 0) {
+        lines.push("MOVED:");
+        for (const m of diff.moved) {
+            const label = m.node.text ? `"${m.node.text}"` : m.node.type;
+            const dx = m.deltaX > 0 ? `+${m.deltaX}` : `${m.deltaX}`;
+            const dy = m.deltaY > 0 ? `+${m.deltaY}` : `${m.deltaY}`;
+            lines.push(`  -> ${label} moved by (${dx}, ${dy})px`);
+        }
+    }
+    if (diff.resized.length > 0) {
+        lines.push("RESIZED:");
+        for (const r of diff.resized) {
+            const label = r.node.text ? `"${r.node.text}"` : r.node.type;
+            lines.push(`  <> ${label}: ${r.from.width}x${r.from.height} → ${r.to.width}x${r.to.height}`);
+        }
+    }
+    if (diff.changed.length > 0) {
+        lines.push("CHANGED:");
+        for (const { node, changes } of diff.changed) {
+            lines.push(`  ~ ${node.type} ${node.text ? `"${node.text}"` : ""}: ${changes.join(", ")}`);
+        }
+    }
+    if (lines.length === 0) {
+        return "[No changes detected]";
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=snapshot-differ.js.map

package/dist/src/snapshot/snapshot-differ.js.map

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

package/dist/src/tools/app-tools.d.ts

@@ -0,0 +1,71 @@
+import { z } from "zod";
+import type { DeviceManager } from "../platform/device-manager.js";
+export declare const appToolSchemas: {
+    devlens_launch_app: {
+        description: string;
+        parameters: z.ZodObject<{
+            appId: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            appId: string;
+        }, {
+            appId: string;
+        }>;
+    };
+    devlens_terminate_app: {
+        description: string;
+        parameters: z.ZodObject<{
+            appId: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            appId: string;
+        }, {
+            appId: string;
+        }>;
+    };
+    devlens_install_app: {
+        description: string;
+        parameters: z.ZodObject<{
+            path: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            path: string;
+        }, {
+            path: string;
+        }>;
+    };
+    devlens_list_apps: {
+        description: string;
+        parameters: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+    };
+};
+export declare function createAppToolHandlers(deviceManager: DeviceManager): {
+    devlens_launch_app: (params: {
+        appId: string;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+    devlens_terminate_app: (params: {
+        appId: string;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+    devlens_install_app: (params: {
+        path: string;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+    devlens_list_apps: () => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};
+//# sourceMappingURL=app-tools.d.ts.map

package/dist/src/tools/app-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/app-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAEnE,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgC1B,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,aAAa;iCAE3B;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE;;;;;;oCAcd;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE;;;;;;kCAcnB;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;;;;;;;;;;;;EA2CvD"}

package/dist/src/tools/app-tools.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.appToolSchemas = void 0;
+exports.createAppToolHandlers = createAppToolHandlers;
+const zod_1 = require("zod");
+exports.appToolSchemas = {
+    devlens_launch_app: {
+        description: "Launch an app on the device by its bundle ID (iOS) or package name (Android). The app must already be installed.",
+        parameters: zod_1.z.object({
+            appId: zod_1.z
+                .string()
+                .describe("Bundle ID (iOS, e.g., com.example.app) or package name (Android, e.g., com.example.app)"),
+        }),
+    },
+    devlens_terminate_app: {
+        description: "Force stop a running app on the device.",
+        parameters: zod_1.z.object({
+            appId: zod_1.z.string().describe("Bundle ID or package name of the app to stop"),
+        }),
+    },
+    devlens_install_app: {
+        description: "Install an app from a local file path. Supports .apk (Android), .app/.ipa (iOS).",
+        parameters: zod_1.z.object({
+            path: zod_1.z
+                .string()
+                .describe("Local file path to the app binary (.apk, .app, or .ipa)"),
+        }),
+    },
+    devlens_list_apps: {
+        description: "List all third-party apps installed on the device. Returns app IDs and names.",
+        parameters: zod_1.z.object({}),
+    },
+};
+function createAppToolHandlers(deviceManager) {
+    return {
+        devlens_launch_app: async (params) => {
+            const device = await deviceManager.getDevice();
+            await device.launchApp(params.appId);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Launched app: ${params.appId}`,
+                    },
+                ],
+            };
+        },
+        devlens_terminate_app: async (params) => {
+            const device = await deviceManager.getDevice();
+            await device.terminateApp(params.appId);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Terminated app: ${params.appId}`,
+                    },
+                ],
+            };
+        },
+        devlens_install_app: async (params) => {
+            const device = await deviceManager.getDevice();
+            await device.installApp(params.path);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Installed app from: ${params.path}`,
+                    },
+                ],
+            };
+        },
+        devlens_list_apps: async () => {
+            const device = await deviceManager.getDevice();
+            const apps = await device.listApps();
+            if (apps.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "No third-party apps found on the device.",
+                        },
+                    ],
+                };
+            }
+            const lines = apps.map((app) => `${app.name} — ${app.appId}${app.isRunning ? " (running)" : ""}`);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Installed apps (${apps.length}):\n\n${lines.join("\n")}`,
+                    },
+                ],
+            };
+        },
+    };
+}
+//# sourceMappingURL=app-tools.js.map

package/dist/src/tools/app-tools.js.map

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

package/dist/src/tools/device-tools.d.ts

@@ -0,0 +1,53 @@
+import { z } from "zod";
+import type { DeviceManager } from "../platform/device-manager.js";
+export declare const deviceToolSchemas: {
+    devlens_list_devices: {
+        description: string;
+        parameters: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+    };
+    devlens_device_info: {
+        description: string;
+        parameters: z.ZodObject<{
+            deviceId: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            deviceId?: string | undefined;
+        }, {
+            deviceId?: string | undefined;
+        }>;
+    };
+    devlens_set_orientation: {
+        description: string;
+        parameters: z.ZodObject<{
+            orientation: z.ZodEnum<["portrait", "landscape"]>;
+        }, "strip", z.ZodTypeAny, {
+            orientation: "portrait" | "landscape";
+        }, {
+            orientation: "portrait" | "landscape";
+        }>;
+    };
+};
+export declare function createDeviceToolHandlers(deviceManager: DeviceManager): {
+    devlens_list_devices: () => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+    devlens_device_info: (params: {
+        deviceId?: string;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+    devlens_set_orientation: (params: {
+        orientation: "portrait" | "landscape";
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};
+//# sourceMappingURL=device-tools.d.ts.map

package/dist/src/tools/device-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/device-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAEnE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;CAwB7B,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,aAAa,EAAE,aAAa;;;;;;;kCA8B7B;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE;;;;;;sCAqBjB;QACtC,WAAW,EAAE,UAAU,GAAG,WAAW,CAAC;KACvC;;;;;;EAaJ"}

package/dist/src/tools/device-tools.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deviceToolSchemas = void 0;
+exports.createDeviceToolHandlers = createDeviceToolHandlers;
+const zod_1 = require("zod");
+exports.deviceToolSchemas = {
+    devlens_list_devices: {
+        description: "List all running iOS Simulators and Android Emulators. Returns device IDs, names, platforms, and OS versions.",
+        parameters: zod_1.z.object({}),
+    },
+    devlens_device_info: {
+        description: "Get detailed information about a specific device: screen size, OS version, orientation. If no deviceId is provided, uses the first available device.",
+        parameters: zod_1.z.object({
+            deviceId: zod_1.z
+                .string()
+                .optional()
+                .describe("Device ID from devlens_list_devices. Optional."),
+        }),
+    },
+    devlens_set_orientation: {
+        description: "Set the device orientation to portrait or landscape.",
+        parameters: zod_1.z.object({
+            orientation: zod_1.z
+                .enum(["portrait", "landscape"])
+                .describe("Target orientation"),
+        }),
+    },
+};
+function createDeviceToolHandlers(deviceManager) {
+    return {
+        devlens_list_devices: async () => {
+            const devices = await deviceManager.discoverDevices();
+            if (devices.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "No running simulators or emulators found.\n\nTo start a device:\n- Android: Open Android Studio → Device Manager → Start an emulator\n- iOS: Open Xcode → Window → Devices and Simulators → Boot a simulator",
+                        },
+                    ],
+                };
+            }
+            const lines = devices.map((d) => `${d.isBooted ? "●" : "○"} ${d.name} (${d.platform}, ${d.osVersion}) — id: ${d.id}`);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Found ${devices.length} device(s):\n\n${lines.join("\n")}`,
+                    },
+                ],
+            };
+        },
+        devlens_device_info: async (params) => {
+            const device = await deviceManager.getDevice(params.deviceId);
+            const info = await device.getInfo();
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: [
+                            `Device: ${info.name}`,
+                            `Platform: ${info.platform}`,
+                            `OS Version: ${info.osVersion}`,
+                            `Screen: ${info.screenWidth}x${info.screenHeight}`,
+                            `Orientation: ${info.orientation}`,
+                            `ID: ${info.id}`,
+                        ].join("\n"),
+                    },
+                ],
+            };
+        },
+        devlens_set_orientation: async (params) => {
+            const device = await deviceManager.getDevice();
+            await device.setOrientation(params.orientation);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Orientation set to ${params.orientation}.`,
+                    },
+                ],
+            };
+        },
+    };
+}
+//# sourceMappingURL=device-tools.js.map

package/dist/src/tools/device-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-tools.js","sourceRoot":"","sources":["../../../src/tools/device-tools.ts"],"names":[],"mappings":";;;AA6BA,4DAkEC;AA/FD,6BAAwB;AAGX,QAAA,iBAAiB,GAAG;IAC/B,oBAAoB,EAAE;QACpB,WAAW,EACT,+GAA+G;QACjH,UAAU,EAAE,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC;KACzB;IACD,mBAAmB,EAAE;QACnB,WAAW,EACT,sJAAsJ;QACxJ,UAAU,EAAE,OAAC,CAAC,MAAM,CAAC;YACnB,QAAQ,EAAE,OAAC;iBACR,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,gDAAgD,CAAC;SAC9D,CAAC;KACH;IACD,uBAAuB,EAAE;QACvB,WAAW,EAAE,sDAAsD;QACnE,UAAU,EAAE,OAAC,CAAC,MAAM,CAAC;YACnB,WAAW,EAAE,OAAC;iBACX,IAAI,CAAC,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;iBAC/B,QAAQ,CAAC,oBAAoB,CAAC;SAClC,CAAC;KACH;CACF,CAAC;AAEF,SAAgB,wBAAwB,CAAC,aAA4B;IACnE,OAAO;QACL,oBAAoB,EAAE,KAAK,IAAI,EAAE;YAC/B,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,eAAe,EAAE,CAAC;YACtD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,8MAA8M;yBACrN;qBACF;iBACF,CAAC;YACJ,CAAC;YAED,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CACvB,CAAC,CAAC,EAAE,EAAE,CACJ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,SAAS,WAAW,CAAC,CAAC,EAAE,EAAE,CACtF,CAAC;YAEF,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,SAAS,OAAO,CAAC,MAAM,kBAAkB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;qBAClE;iBACF;aACF,CAAC;QACJ,CAAC;QAED,mBAAmB,EAAE,KAAK,EAAE,MAA6B,EAAE,EAAE;YAC3D,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC9D,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;YAEpC,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE;4BACJ,WAAW,IAAI,CAAC,IAAI,EAAE;4BACtB,aAAa,IAAI,CAAC,QAAQ,EAAE;4BAC5B,eAAe,IAAI,CAAC,SAAS,EAAE;4BAC/B,WAAW,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,YAAY,EAAE;4BAClD,gBAAgB,IAAI,CAAC,WAAW,EAAE;4BAClC,OAAO,IAAI,CAAC,EAAE,EAAE;yBACjB,CAAC,IAAI,CAAC,IAAI,CAAC;qBACb;iBACF;aACF,CAAC;QACJ,CAAC;QAED,uBAAuB,EAAE,KAAK,EAAE,MAE/B,EAAE,EAAE;YACH,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,SAAS,EAAE,CAAC;YAC/C,MAAM,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;YAChD,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,sBAAsB,MAAM,CAAC,WAAW,GAAG;qBAClD;iBACF;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/src/tools/ds-tools.d.ts

@@ -0,0 +1,65 @@
+import { z } from "zod";
+import type { DesignSystemConfig } from "../config/devlens-config.js";
+/**
+ * Design System Context tool.
+ *
+ * When devlens.config.json is configured with a designSystem block,
+ * this tool scans the consumer project and returns:
+ *   - Design token values (colors, spacing, typography, etc.)
+ *   - TypeScript prop interfaces for DS components
+ *   - Component usage patterns found in the codebase
+ *
+ * The AI uses this context to write DS-compliant code when fixing
+ * differences found by devlens_compare_with_figma.
+ */
+export interface TokenEntry {
+    name: string;
+    value: string;
+    group: string;
+}
+export interface ComponentUsagePattern {
+    componentName: string;
+    importedFrom: string;
+    usageCount: number;
+    /** prop name → distinct values seen in the codebase */
+    sampleProps: Record<string, string[]>;
+    sourceFiles: string[];
+}
+export declare const dsToolSchemas: {
+    devlens_ds_context: {
+        description: string;
+        parameters: z.ZodObject<{
+            includeTokens: z.ZodDefault<z.ZodBoolean>;
+            includeComponents: z.ZodDefault<z.ZodBoolean>;
+            includeInterfaces: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            includeTokens: boolean;
+            includeComponents: boolean;
+            includeInterfaces: boolean;
+        }, {
+            includeTokens?: boolean | undefined;
+            includeComponents?: boolean | undefined;
+            includeInterfaces?: boolean | undefined;
+        }>;
+    };
+};
+export declare function createDsToolHandlers(dsConfig: DesignSystemConfig | undefined): {
+    devlens_ds_context: (params: {
+        includeTokens: boolean;
+        includeComponents: boolean;
+        includeInterfaces: boolean;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        isError: boolean;
+    } | {
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        isError?: undefined;
+    }>;
+};
+//# sourceMappingURL=ds-tools.d.ts.map

package/dist/src/tools/ds-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ds-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/ds-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEtE;;;;;;;;;;;GAWG;AAIH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACtC,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAID,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;CAmBzB,CAAC;AAsQF,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,SAAS;iCAEtC;QACjC,aAAa,EAAE,OAAO,CAAC;QACvB,iBAAiB,EAAE,OAAO,CAAC;QAC3B,iBAAiB,EAAE,OAAO,CAAC;KAC5B;;;;;;;;;;;;;EAsEJ"}