@blacksmithers/vaultforge 1.0.0

package/dist/tools/canvas/canvas-relayout.js

@@ -0,0 +1,152 @@
+import { z } from 'zod';
+import { readFile, writeFile } from 'node:fs/promises';
+import nodePath from 'node:path';
+import { ensureCanvasExt, parseCanvasFile, calculateEdgeSides } from './canvas-utils.js';
+import { runDagreLayout } from './layout-engine.js';
+export function registerCanvasRelayout(server, vaultPath, vault) {
+    server.tool('canvas_relayout', 'Re-layout an existing canvas using dagre without changing content. ' +
+        'Useful when a canvas has become visually messy. ' +
+        'Set write=false to preview dimensions before committing. ' +
+        'Preserves groups and their containment by default.', {
+        path: z.string().describe('Vault-relative path to .canvas file'),
+        direction: z.enum(['TB', 'BT', 'LR', 'RL']).default('LR').describe('Layout direction (default: LR)'),
+        nodesep: z.number().optional().describe('Pixels between nodes (default: 80)'),
+        ranksep: z.number().optional().describe('Pixels between ranks (default: 120)'),
+        root: z.string().optional().describe('Label of root node (layout hint)'),
+        preserve_groups: z.boolean().default(true).describe('Keep group containment (default: true)'),
+        write: z.boolean().default(false).describe('If false, returns preview without writing'),
+    }, async ({ path: canvasPath, direction, nodesep, ranksep, preserve_groups, write: shouldWrite }) => {
+        await vault.waitReady();
+        const rel = ensureCanvasExt(canvasPath);
+        const absPath = nodePath.join(vaultPath, rel);
+        let raw;
+        try {
+            raw = await readFile(absPath, 'utf-8');
+        }
+        catch {
+            return {
+                content: [{ type: 'text', text: `ERROR: Canvas not found: ${rel}` }],
+                isError: true,
+            };
+        }
+        const canvas = parseCanvasFile(raw);
+        if (canvas.nodes.length === 0) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            path: rel,
+                            direction,
+                            nodes_repositioned: 0,
+                            edges_recalculated: 0,
+                            new_dimensions: { width: 0, height: 0 },
+                            written: false,
+                        }, null, 2),
+                    }],
+            };
+        }
+        // Separate groups from regular nodes
+        const groupNodes = canvas.nodes.filter((n) => n.type === 'group');
+        const regularNodes = canvas.nodes.filter((n) => n.type !== 'group');
+        // Detect group membership: which regular nodes are inside which group
+        const nodeToGroup = new Map();
+        if (preserve_groups) {
+            for (const node of regularNodes) {
+                for (const group of groupNodes) {
+                    if (node.x >= group.x &&
+                        node.y >= group.y &&
+                        node.x + node.width <= group.x + group.width &&
+                        node.y + node.height <= group.y + group.height) {
+                        nodeToGroup.set(node.id, group);
+                        break;
+                    }
+                }
+            }
+        }
+        // Run dagre on regular nodes
+        const layoutNodes = regularNodes.map((n) => ({
+            id: n.id,
+            width: n.width,
+            height: n.height,
+        }));
+        const regularNodeIds = new Set(regularNodes.map((n) => n.id));
+        const layoutEdges = canvas.edges
+            .filter((e) => regularNodeIds.has(e.fromNode) && regularNodeIds.has(e.toNode))
+            .map((e) => ({ from: e.fromNode, to: e.toNode }));
+        const result = runDagreLayout(layoutNodes, layoutEdges, {
+            direction,
+            nodesep,
+            ranksep,
+        });
+        // Apply new positions to regular nodes
+        for (const node of regularNodes) {
+            const pos = result.nodes.get(node.id);
+            if (pos) {
+                node.x = pos.x;
+                node.y = pos.y;
+            }
+        }
+        // Recalculate group bounds from children
+        if (preserve_groups) {
+            for (const group of groupNodes) {
+                const children = regularNodes.filter((n) => nodeToGroup.get(n.id) === group);
+                if (children.length === 0)
+                    continue;
+                let minX = Infinity, minY = Infinity, maxX = -Infinity, maxY = -Infinity;
+                for (const child of children) {
+                    minX = Math.min(minX, child.x);
+                    minY = Math.min(minY, child.y);
+                    maxX = Math.max(maxX, child.x + child.width);
+                    maxY = Math.max(maxY, child.y + child.height);
+                }
+                const padding = 40;
+                group.x = Math.round(minX - padding);
+                group.y = Math.round(minY - padding);
+                group.width = Math.round(maxX - minX + padding * 2);
+                group.height = Math.round(maxY - minY + padding * 2);
+            }
+        }
+        // Recalculate all edge sides
+        const nodeById = new Map(canvas.nodes.map((n) => [n.id, n]));
+        for (const edge of canvas.edges) {
+            const from = nodeById.get(edge.fromNode);
+            const to = nodeById.get(edge.toNode);
+            if (from && to) {
+                const sides = calculateEdgeSides(from, to);
+                edge.fromSide = sides.fromSide;
+                edge.toSide = sides.toSide;
+            }
+        }
+        // Rebuild nodes array: groups first (lower z-index), then regular
+        canvas.nodes = [...groupNodes, ...regularNodes];
+        if (shouldWrite) {
+            await writeFile(absPath, JSON.stringify(canvas, null, '\t'), 'utf-8');
+        }
+        // Calculate new dimensions
+        let minX = Infinity, minY = Infinity, maxX = -Infinity, maxY = -Infinity;
+        for (const node of canvas.nodes) {
+            minX = Math.min(minX, node.x);
+            minY = Math.min(minY, node.y);
+            maxX = Math.max(maxX, node.x + node.width);
+            maxY = Math.max(maxY, node.y + node.height);
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        path: rel,
+                        direction,
+                        nodes_repositioned: regularNodes.length,
+                        edges_recalculated: canvas.edges.length,
+                        new_dimensions: {
+                            width: Math.round(maxX - minX),
+                            height: Math.round(maxY - minY),
+                        },
+                        written: shouldWrite,
+                        ...(result.hasCycles ? { warnings: ['Graph contains cycles — layout may be suboptimal'] } : {}),
+                    }, null, 2),
+                }],
+        };
+    });
+}
+//# sourceMappingURL=canvas-relayout.js.map

package/dist/tools/canvas/canvas-relayout.js.map

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

package/dist/tools/canvas/canvas-utils.d.ts

@@ -0,0 +1,40 @@
+import type { CanvasNode, CanvasData, CanvasSide, SemanticNode } from './types.js';
+export declare function generateId(): string;
+export declare function isImageFile(filePath: string): boolean;
+export declare function estimateTextHeight(text: string, width?: number): number;
+export declare function calculateNodeDimensions(node: SemanticNode): {
+    width: number;
+    height: number;
+};
+export declare function calculateEdgeSides(fromNode: {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}, toNode: {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}): {
+    fromSide: CanvasSide;
+    toSide: CanvasSide;
+};
+export declare function getNodeLabel(node: CanvasNode): string;
+export declare function buildLabelMap(nodes: CanvasNode[]): Map<string, CanvasNode>;
+export declare function fuzzyMatchNode(query: string, candidates: Map<string, CanvasNode>): CanvasNode | null;
+export declare function positionNear(anchor: {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}, newNode: {
+    width: number;
+    height: number;
+}, position: 'above' | 'below' | 'left' | 'right', gap?: number): {
+    x: number;
+    y: number;
+};
+export declare function parseCanvasFile(content: string): CanvasData;
+export declare function ensureCanvasExt(p: string): string;
+//# sourceMappingURL=canvas-utils.d.ts.map

package/dist/tools/canvas/canvas-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas-utils.d.ts","sourceRoot":"","sources":["../../../src/tools/canvas/canvas-utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEnF,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAID,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAErD;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAAY,GAAG,MAAM,CAM5E;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,YAAY,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAyB7F;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EACjE,MAAM,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC9D;IAAE,QAAQ,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,CAoB9C;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAarD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAM1E;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,UAAU,GAAG,IAAI,CAgBpG;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAC/D,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAC1C,QAAQ,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,EAC9C,GAAG,GAAE,MAAY,GAChB;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAuB1B;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAM3D;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAIjD"}

package/dist/tools/canvas/canvas-utils.js

@@ -0,0 +1,141 @@
+import { randomBytes } from 'node:crypto';
+import nodePath from 'node:path';
+export function generateId() {
+    return randomBytes(8).toString('hex');
+}
+const IMAGE_EXTENSIONS = new Set(['.png', '.jpg', '.jpeg', '.gif', '.webp', '.svg', '.bmp']);
+export function isImageFile(filePath) {
+    return IMAGE_EXTENSIONS.has(nodePath.extname(filePath).toLowerCase());
+}
+export function estimateTextHeight(text, width = 250) {
+    const charsPerLine = Math.floor(width / 8);
+    const lines = text.split('\n').reduce((total, line) => {
+        return total + Math.max(1, Math.ceil(line.length / charsPerLine));
+    }, 0);
+    return Math.max(60, lines * 28 + 20);
+}
+export function calculateNodeDimensions(node) {
+    if (node.width !== undefined && node.height !== undefined) {
+        return { width: node.width, height: node.height };
+    }
+    switch (node.type) {
+        case 'text': {
+            const w = node.width ?? 250;
+            const text = node.text ?? node.label;
+            const h = node.height ?? estimateTextHeight(text, w);
+            return { width: w, height: h };
+        }
+        case 'file': {
+            if (node.file && isImageFile(node.file)) {
+                return { width: node.width ?? 400, height: node.height ?? 200 };
+            }
+            return { width: node.width ?? 400, height: node.height ?? 400 };
+        }
+        case 'link':
+            return { width: node.width ?? 300, height: node.height ?? 60 };
+        case 'group':
+            return { width: node.width ?? 400, height: node.height ?? 300 };
+        default:
+            return { width: node.width ?? 250, height: node.height ?? 60 };
+    }
+}
+export function calculateEdgeSides(fromNode, toNode) {
+    const fromCx = fromNode.x + fromNode.width / 2;
+    const fromCy = fromNode.y + fromNode.height / 2;
+    const toCx = toNode.x + toNode.width / 2;
+    const toCy = toNode.y + toNode.height / 2;
+    const dx = toCx - fromCx;
+    const dy = toCy - fromCy;
+    if (Math.abs(dx) > Math.abs(dy)) {
+        return {
+            fromSide: dx > 0 ? 'right' : 'left',
+            toSide: dx > 0 ? 'left' : 'right',
+        };
+    }
+    else {
+        return {
+            fromSide: dy > 0 ? 'bottom' : 'top',
+            toSide: dy > 0 ? 'top' : 'bottom',
+        };
+    }
+}
+export function getNodeLabel(node) {
+    switch (node.type) {
+        case 'text': {
+            const text = node.text.split('\n')[0];
+            return text.length > 50 ? text.slice(0, 50) + '...' : text;
+        }
+        case 'file':
+            return nodePath.basename(node.file);
+        case 'link':
+            return node.url;
+        case 'group':
+            return node.label ?? '(unnamed group)';
+    }
+}
+export function buildLabelMap(nodes) {
+    const map = new Map();
+    for (const node of nodes) {
+        map.set(getNodeLabel(node), node);
+    }
+    return map;
+}
+export function fuzzyMatchNode(query, candidates) {
+    // 1. Exact match
+    if (candidates.has(query))
+        return candidates.get(query);
+    // 2. Case-insensitive match
+    for (const [label, node] of candidates) {
+        if (label.toLowerCase() === query.toLowerCase())
+            return node;
+    }
+    // 3. Starts with
+    for (const [label, node] of candidates) {
+        if (label.toLowerCase().startsWith(query.toLowerCase()))
+            return node;
+    }
+    // 4. Contains
+    for (const [label, node] of candidates) {
+        if (label.toLowerCase().includes(query.toLowerCase()))
+            return node;
+    }
+    return null;
+}
+export function positionNear(anchor, newNode, position, gap = 100) {
+    switch (position) {
+        case 'above':
+            return {
+                x: anchor.x + (anchor.width - newNode.width) / 2,
+                y: anchor.y - newNode.height - gap,
+            };
+        case 'below':
+            return {
+                x: anchor.x + (anchor.width - newNode.width) / 2,
+                y: anchor.y + anchor.height + gap,
+            };
+        case 'left':
+            return {
+                x: anchor.x - newNode.width - gap,
+                y: anchor.y + (anchor.height - newNode.height) / 2,
+            };
+        case 'right':
+            return {
+                x: anchor.x + anchor.width + gap,
+                y: anchor.y + (anchor.height - newNode.height) / 2,
+            };
+    }
+}
+export function parseCanvasFile(content) {
+    const data = JSON.parse(content);
+    return {
+        nodes: data.nodes ?? [],
+        edges: data.edges ?? [],
+    };
+}
+export function ensureCanvasExt(p) {
+    const normalized = p.replace(/\\/g, '/').replace(/^\/+/, '');
+    if (!normalized.endsWith('.canvas'))
+        return normalized + '.canvas';
+    return normalized;
+}
+//# sourceMappingURL=canvas-utils.js.map

package/dist/tools/canvas/canvas-utils.js.map

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

package/dist/tools/canvas/layout-engine.d.ts

@@ -0,0 +1,34 @@
+import type { CanvasSide, LayoutDirection } from './types.js';
+export interface LayoutNode {
+    id: string;
+    width: number;
+    height: number;
+}
+export interface LayoutEdge {
+    from: string;
+    to: string;
+}
+export interface LayoutOptions {
+    direction?: LayoutDirection;
+    nodesep?: number;
+    ranksep?: number;
+}
+export interface PositionedNode {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface PositionedEdge {
+    from: string;
+    to: string;
+    fromSide: CanvasSide;
+    toSide: CanvasSide;
+}
+export interface LayoutResult {
+    nodes: Map<string, PositionedNode>;
+    edges: PositionedEdge[];
+    hasCycles: boolean;
+}
+export declare function runDagreLayout(nodes: LayoutNode[], edges: LayoutEdge[], options?: LayoutOptions): LayoutResult;
+//# sourceMappingURL=layout-engine.d.ts.map

package/dist/tools/canvas/layout-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-engine.d.ts","sourceRoot":"","sources":["../../../src/tools/canvas/layout-engine.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAG9D,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,UAAU,CAAC;IACrB,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACnC,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;CACpB;AAgCD,wBAAgB,cAAc,CAC5B,KAAK,EAAE,UAAU,EAAE,EACnB,KAAK,EAAE,UAAU,EAAE,EACnB,OAAO,GAAE,aAAkB,GAC1B,YAAY,CAiDd"}

package/dist/tools/canvas/layout-engine.js

@@ -0,0 +1,75 @@
+import dagre from '@dagrejs/dagre';
+import { calculateEdgeSides } from './canvas-utils.js';
+function detectCycles(nodeIds, edges) {
+    const adj = new Map();
+    for (const e of edges) {
+        if (!adj.has(e.from))
+            adj.set(e.from, []);
+        adj.get(e.from).push(e.to);
+    }
+    const visited = new Set();
+    const inStack = new Set();
+    function dfs(node) {
+        visited.add(node);
+        inStack.add(node);
+        for (const neighbor of adj.get(node) ?? []) {
+            if (!visited.has(neighbor)) {
+                if (dfs(neighbor))
+                    return true;
+            }
+            else if (inStack.has(neighbor)) {
+                return true;
+            }
+        }
+        inStack.delete(node);
+        return false;
+    }
+    for (const node of nodeIds) {
+        if (!visited.has(node) && dfs(node))
+            return true;
+    }
+    return false;
+}
+export function runDagreLayout(nodes, edges, options = {}) {
+    const g = new dagre.graphlib.Graph().setDefaultEdgeLabel(() => ({}));
+    g.setGraph({
+        rankdir: options.direction ?? 'TB',
+        nodesep: options.nodesep ?? 80,
+        ranksep: options.ranksep ?? 120,
+        edgesep: 20,
+        marginx: 40,
+        marginy: 40,
+        acyclicer: 'greedy',
+        ranker: 'network-simplex',
+    });
+    for (const node of nodes) {
+        g.setNode(node.id, { width: node.width, height: node.height });
+    }
+    const nodeIds = new Set(nodes.map((n) => n.id));
+    const validEdges = edges.filter((e) => nodeIds.has(e.from) && nodeIds.has(e.to));
+    const hasCycles = detectCycles(nodeIds, validEdges);
+    for (const edge of validEdges) {
+        g.setEdge(edge.from, edge.to);
+    }
+    dagre.layout(g);
+    // Read results — convert center coordinates to top-left
+    const positionedNodes = new Map();
+    for (const node of nodes) {
+        const dagreNode = g.node(node.id);
+        positionedNodes.set(node.id, {
+            x: Math.round(dagreNode.x - dagreNode.width / 2),
+            y: Math.round(dagreNode.y - dagreNode.height / 2),
+            width: node.width,
+            height: node.height,
+        });
+    }
+    // Calculate edge sides based on final node positions
+    const positionedEdges = validEdges.map((edge) => {
+        const from = positionedNodes.get(edge.from);
+        const to = positionedNodes.get(edge.to);
+        const sides = calculateEdgeSides(from, to);
+        return { from: edge.from, to: edge.to, ...sides };
+    });
+    return { nodes: positionedNodes, edges: positionedEdges, hasCycles };
+}
+//# sourceMappingURL=layout-engine.js.map

package/dist/tools/canvas/layout-engine.js.map

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

package/dist/tools/canvas/types.d.ts

@@ -0,0 +1,71 @@
+export type CanvasNodeType = 'text' | 'file' | 'link' | 'group';
+export type CanvasSide = 'top' | 'right' | 'bottom' | 'left';
+export type CanvasEndShape = 'none' | 'arrow';
+export type CanvasColor = string;
+export type LayoutDirection = 'TB' | 'BT' | 'LR' | 'RL';
+export type BackgroundStyle = 'cover' | 'ratio' | 'repeat';
+export interface CanvasNodeBase {
+    id: string;
+    type: CanvasNodeType;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    color?: CanvasColor;
+}
+export interface CanvasTextNode extends CanvasNodeBase {
+    type: 'text';
+    text: string;
+}
+export interface CanvasFileNode extends CanvasNodeBase {
+    type: 'file';
+    file: string;
+    subpath?: string;
+}
+export interface CanvasLinkNode extends CanvasNodeBase {
+    type: 'link';
+    url: string;
+}
+export interface CanvasGroupNode extends CanvasNodeBase {
+    type: 'group';
+    label?: string;
+    background?: string;
+    backgroundStyle?: BackgroundStyle;
+}
+export type CanvasNode = CanvasTextNode | CanvasFileNode | CanvasLinkNode | CanvasGroupNode;
+export interface CanvasEdge {
+    id: string;
+    fromNode: string;
+    fromSide?: CanvasSide;
+    fromEnd?: CanvasEndShape;
+    toNode: string;
+    toSide?: CanvasSide;
+    toEnd?: CanvasEndShape;
+    color?: CanvasColor;
+    label?: string;
+}
+export interface CanvasData {
+    nodes: CanvasNode[];
+    edges: CanvasEdge[];
+}
+export interface SemanticNode {
+    label: string;
+    type: CanvasNodeType;
+    text?: string;
+    file?: string;
+    subpath?: string;
+    url?: string;
+    children?: string[];
+    color?: CanvasColor;
+    width?: number;
+    height?: number;
+}
+export interface SemanticEdge {
+    from: string;
+    to: string;
+    label?: string;
+    color?: CanvasColor;
+    fromEnd?: CanvasEndShape;
+    toEnd?: CanvasEndShape;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/tools/canvas/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/canvas/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAChE,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAC7D,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,OAAO,CAAC;AAC9C,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC;AACjC,MAAM,MAAM,eAAe,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AACxD,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE3D,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,cAAc,CAAC;IACrB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,cAAe,SAAQ,cAAc;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAe,SAAQ,cAAc;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAe,SAAQ,cAAc;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,eAAgB,SAAQ,cAAc;IACrD,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED,MAAM,MAAM,UAAU,GAAG,cAAc,GAAG,cAAc,GAAG,cAAc,GAAG,eAAe,CAAC;AAE5F,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,cAAc,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB"}

package/dist/tools/canvas/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/tools/canvas/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tools/canvas/types.ts"],"names":[],"mappings":""}

package/dist/tools/files/batch-rename.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { VaultIndex } from "../../vault-index.js";
+export declare function registerBatchRename(server: McpServer, vaultPath: string, vault: VaultIndex): void;
+//# sourceMappingURL=batch-rename.d.ts.map

package/dist/tools/files/batch-rename.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-rename.d.ts","sourceRoot":"","sources":["../../../src/tools/files/batch-rename.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAGvD,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,UAAU,GAChB,IAAI,CAuJN"}