@addai/tables-mcp 0.7.0

package/dist/tools/comments.js

@@ -0,0 +1,63 @@
+import { z } from 'zod';
+import { mcpError, mcpResult } from '../helpers/errors.js';
+export function registerCommentTools(server, client) {
+    // ── list_comments ──
+    server.tool('list_comments', 'List comments on a row. Returns threaded comments with user info, reply counts, and emoji reactions.', {
+        table_id: z.string().uuid().describe('The table containing the row'),
+        row_id: z.string().uuid().describe('The row to get comments for'),
+    }, async ({ table_id, row_id }) => {
+        const res = await client.get(`/tables/${table_id}/rows/${row_id}/comments`);
+        if (res.error)
+            return mcpError(res.error.message);
+        return mcpResult(res.data);
+    });
+    // ── add_comment ──
+    server.tool('add_comment', 'Add a comment to a row. Supports threaded replies by providing a parent_id.', {
+        table_id: z.string().uuid().describe('The table containing the row'),
+        row_id: z.string().uuid().describe('The row to comment on'),
+        content: z.string().min(1).describe('The comment text'),
+        parent_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Parent comment ID to reply to (creates a threaded reply). Max 1 level deep.'),
+    }, async ({ table_id, row_id, content, parent_id }) => {
+        const body = { content };
+        if (parent_id)
+            body.parent_id = parent_id;
+        const res = await client.post(`/tables/${table_id}/rows/${row_id}/comments`, body);
+        if (res.error)
+            return mcpError(res.error.message);
+        return mcpResult(res.data);
+    });
+    // ── update_comment ──
+    server.tool('update_comment', 'Edit a comment. You can only edit your own comments.', {
+        comment_id: z.string().uuid().describe('The comment ID to edit'),
+        content: z.string().min(1).describe('The new comment text'),
+    }, async ({ comment_id, content }) => {
+        const res = await client.patch(`/comments/${comment_id}`, { content });
+        if (res.error)
+            return mcpError(res.error.message);
+        return mcpResult(res.data);
+    });
+    // ── delete_comment ──
+    server.tool('delete_comment', 'Delete a comment and its replies/reactions. You can only delete your own comments.', {
+        comment_id: z.string().uuid().describe('The comment ID to delete'),
+    }, async ({ comment_id }) => {
+        const res = await client.delete(`/comments/${comment_id}`);
+        if (res.error)
+            return mcpError(res.error.message);
+        return mcpResult({ message: 'Comment deleted' });
+    });
+    // ── toggle_reaction ──
+    server.tool('toggle_reaction', 'Add or remove an emoji reaction on a comment. If you already reacted with that emoji, it removes it.', {
+        comment_id: z.string().uuid().describe('The comment ID to react to'),
+        emoji: z.string().min(1).describe('The emoji to toggle (e.g. "thumbsup", "heart", "fire", "eyes")'),
+    }, async ({ comment_id, emoji }) => {
+        const res = await client.post(`/comments/${comment_id}/reactions`, { emoji });
+        if (res.error)
+            return mcpError(res.error.message);
+        return mcpResult(res.data);
+    });
+}
+//# sourceMappingURL=comments.js.map

package/dist/tools/comments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comments.js","sourceRoot":"","sources":["../../src/tools/comments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,UAAU,oBAAoB,CAAC,MAAiB,EAAE,MAAsB;IAC5E,sBAAsB;IACtB,MAAM,CAAC,IAAI,CACT,eAAe,EACf,sGAAsG,EACtG;QACE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;QACpE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;KAClE,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE;QAC7B,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,WAAW,QAAQ,SAAS,MAAM,WAAW,CAAC,CAAC;QAC5E,IAAI,GAAG,CAAC,KAAK;YAAE,OAAO,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAClD,OAAO,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC,CACF,CAAC;IAEF,oBAAoB;IACpB,MAAM,CAAC,IAAI,CACT,aAAa,EACb,6EAA6E,EAC7E;QACE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;QACpE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;QAC3D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QACvD,SAAS,EAAE,CAAC;aACT,MAAM,EAAE;aACR,IAAI,EAAE;aACN,QAAQ,EAAE;aACV,QAAQ,CAAC,6EAA6E,CAAC;KAC3F,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE;QACjD,MAAM,IAAI,GAA4B,EAAE,OAAO,EAAE,CAAC;QAClD,IAAI,SAAS;YAAE,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC1C,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,WAAW,QAAQ,SAAS,MAAM,WAAW,EAAE,IAAI,CAAC,CAAC;QACnF,IAAI,GAAG,CAAC,KAAK;YAAE,OAAO,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAClD,OAAO,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC,CACF,CAAC;IAEF,uBAAuB;IACvB,MAAM,CAAC,IAAI,CACT,gBAAgB,EAChB,sDAAsD,EACtD;QACE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;QAChE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC;KAC5D,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,EAAE;QAChC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,aAAa,UAAU,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QACvE,IAAI,GAAG,CAAC,KAAK;YAAE,OAAO,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAClD,OAAO,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC,CACF,CAAC;IAEF,uBAAuB;IACvB,MAAM,CAAC,IAAI,CACT,gBAAgB,EAChB,oFAAoF,EACpF;QACE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;KACnE,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;QACvB,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,aAAa,UAAU,EAAE,CAAC,CAAC;QAC3D,IAAI,GAAG,CAAC,KAAK;YAAE,OAAO,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAClD,OAAO,SAAS,CAAC,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC,CAAC;IACnD,CAAC,CACF,CAAC;IAEF,wBAAwB;IACxB,MAAM,CAAC,IAAI,CACT,iBAAiB,EACjB,sGAAsG,EACtG;QACE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;QACpE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,gEAAgE,CAAC;KACpG,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,EAAE;QAC9B,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,aAAa,UAAU,YAAY,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9E,IAAI,GAAG,CAAC,KAAK;YAAE,OAAO,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAClD,OAAO,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/dashboards.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AiTablesClient } from '../api-client.js';
+export declare function registerDashboardTools(server: McpServer, client: AiTablesClient): void;
+//# sourceMappingURL=dashboards.d.ts.map

package/dist/tools/dashboards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboards.d.ts","sourceRoot":"","sources":["../../src/tools/dashboards.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAwTvD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,QAsV/E"}

package/dist/tools/dashboards.js

@@ -0,0 +1,560 @@
+import { z } from 'zod';
+import { mcpError, mcpResult } from '../helpers/errors.js';
+import { buildColumnMap } from '../helpers/mapped-columns.js';
+const DEFAULT_GRID_COLS = 12;
+const FILTER_OPERATORS = [
+    'contains', 'not_contains', 'equals', 'not_equals', 'is', 'is_not',
+    'greater_than', 'less_than', 'greater_than_or_equal', 'less_than_or_equal',
+    'before', 'after', 'is_empty', 'is_not_empty',
+];
+const ScopeEnum = z.enum(['table', 'folder', 'database']);
+const ScopeFields = {
+    scope: ScopeEnum.describe('Where the dashboard lives: "table" (single table), "folder" (table folder — multi-table), or "database" (database-wide — multi-table).'),
+    parent_id: z.string().uuid().describe('The table_id / folder_id / database_id that owns the dashboard, matching `scope`.'),
+};
+const PanelFilterSchema = z.object({
+    column: z.string().optional().describe('Column name (human-readable). Omit if providing columnId.'),
+    columnId: z.string().uuid().optional().describe('Column UUID. Omit if providing column name.'),
+    operator: z.enum(FILTER_OPERATORS),
+    value: z.unknown().optional(),
+});
+const PanelSortSchema = z.object({
+    column: z.string().optional(),
+    columnId: z.string().uuid().optional(),
+    direction: z.enum(['asc', 'desc']).default('asc'),
+});
+const PanelTypeEnum = z.enum(['stat', 'chart', 'view', 'embed', 'widget']);
+const PanelInputSchema = z.object({
+    id: z.string().optional().describe('Panel ID. Auto-generated if omitted (panel_<timestamp>_<random>).'),
+    type: PanelTypeEnum,
+    title: z.string(),
+    showTitle: z.boolean().optional(),
+    table_id: z.string().uuid().optional().describe('Which table this panel reads from. Required for folder/database-scope dashboards; defaults to the dashboard\'s table for table-scope.'),
+    x: z.number().int().min(0).optional().describe('Grid X (0-indexed). Auto-placed if omitted.'),
+    y: z.number().int().min(0).optional().describe('Grid Y (0-indexed). Auto-placed if omitted.'),
+    w: z.number().int().min(1).optional().describe('Width in grid units (1-12). Defaults by type.'),
+    h: z.number().int().min(1).optional().describe('Height in grid units. Defaults by type.'),
+    minW: z.number().int().min(1).optional(),
+    minH: z.number().int().min(1).optional(),
+    config: z.record(z.string(), z.unknown()).describe('Type-specific config. Use column NAMES (not UUIDs) — tool translates. Shapes:\n' +
+        '- stat: { statType: "count"|"sum"|"average"|"min"|"max"|"unique", column?, format?: "number"|"currency"|"percentage"|"decimal", prefix?, suffix?, icon?, showChange?, changeColumn? }\n' +
+        '- chart: { chartType: "bar"|"pie"|"doughnut"|"line", groupByColumn, valueColumn?, aggregation?: "count"|"sum"|"average"|"min"|"max", showLegend?, showLabels? }\n' +
+        '- view: { viewType: "table"|"gallery"|"list"|"kanban"|"calendar"|"gantt"|"timeline"|"document", maxRows?, visibleColumns?: string[] (names) }\n' +
+        '- embed: { url, embedType?: "iframe"|"youtube"|"vimeo"|"figma"|"loom", allowFullscreen?, allowScripts? }\n' +
+        '- widget: { widgetId, widgetState?, stateMapping? }'),
+    filters: z.array(PanelFilterSchema).optional(),
+    sorts: z.array(PanelSortSchema).optional(),
+    styling: z.record(z.string(), z.unknown()).optional(),
+    customCss: z.string().optional(),
+});
+const DashboardStylingSchema = z.record(z.string(), z.unknown()).describe('Dashboard-level styling. Shape: { backgroundColor?, backgroundImage?, backgroundSize?, backgroundPosition?, ' +
+    'backgroundRepeat?, backgroundOpacity?, backgroundBlur?, backgroundOverlay?, customCss? }');
+// ── path helpers ───────────────────────────────────────────────────────────────
+function viewsBasePath(scope, parentId) {
+    if (scope === 'folder')
+        return `/folders/${parentId}/views`;
+    if (scope === 'database')
+        return `/databases/${parentId}/views`;
+    return `/tables/${parentId}/views`;
+}
+function viewPath(scope, parentId, viewId) {
+    return `${viewsBasePath(scope, parentId)}/${viewId}`;
+}
+// ── column map cache ───────────────────────────────────────────────────────────
+class ColumnMapCache {
+    client;
+    cache = new Map();
+    constructor(client) {
+        this.client = client;
+    }
+    async get(tableId) {
+        const cached = this.cache.get(tableId);
+        if (cached)
+            return cached;
+        const map = await buildColumnMap(this.client, tableId);
+        this.cache.set(tableId, map);
+        return map;
+    }
+}
+// ── helpers ────────────────────────────────────────────────────────────────────
+function generatePanelId() {
+    return `panel_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+}
+function resolveColumnRef(ref, colMap, label) {
+    if (ref.columnId)
+        return ref.columnId;
+    if (ref.column) {
+        const id = colMap.nameToId.get(ref.column);
+        if (!id)
+            throw new Error(`Unknown column "${ref.column}" referenced in ${label}`);
+        return id;
+    }
+    throw new Error(`Column reference missing in ${label} — provide column (name) or columnId`);
+}
+function resolveName(name, colMap, label) {
+    if (!name)
+        throw new Error(`Missing column name in ${label}`);
+    const id = colMap.nameToId.get(name);
+    if (!id)
+        throw new Error(`Unknown column "${name}" in ${label}`);
+    return id;
+}
+function translatePanelConfig(type, config, colMap) {
+    const out = { ...config };
+    switch (type) {
+        case 'stat': {
+            if (typeof out.column === 'string') {
+                out.columnId = resolveName(out.column, colMap, 'stat.column');
+                delete out.column;
+            }
+            if (typeof out.changeColumn === 'string') {
+                out.changeColumnId = resolveName(out.changeColumn, colMap, 'stat.changeColumn');
+                delete out.changeColumn;
+            }
+            break;
+        }
+        case 'chart': {
+            if (typeof out.groupByColumn === 'string') {
+                out.groupByColumnId = resolveName(out.groupByColumn, colMap, 'chart.groupByColumn');
+                delete out.groupByColumn;
+            }
+            if (typeof out.valueColumn === 'string') {
+                out.valueColumnId = resolveName(out.valueColumn, colMap, 'chart.valueColumn');
+                delete out.valueColumn;
+            }
+            break;
+        }
+        case 'view': {
+            if (Array.isArray(out.visibleColumns)) {
+                out.visibleColumns = out.visibleColumns.map((c) => typeof c === 'string' && colMap.nameToId.has(c) ? colMap.nameToId.get(c) : c);
+            }
+            break;
+        }
+        default:
+            break;
+    }
+    return out;
+}
+async function translatePanelForWrite(panel, cache, fallbackTableId) {
+    const tableId = panel.table_id || fallbackTableId;
+    const needsColumnMap = (panel.filters && panel.filters.length > 0) ||
+        (panel.sorts && panel.sorts.length > 0) ||
+        panel.type === 'stat' ||
+        panel.type === 'chart' ||
+        (panel.type === 'view' && Array.isArray(panel.config?.visibleColumns));
+    let colMap = null;
+    if (needsColumnMap) {
+        if (!tableId) {
+            throw new Error(`Panel "${panel.title}" references columns but has no table_id — set panel.table_id or use a table-scope dashboard.`);
+        }
+        colMap = await cache.get(tableId);
+    }
+    const config = colMap
+        ? translatePanelConfig(panel.type, panel.config || {}, colMap)
+        : { ...(panel.config || {}) };
+    const filters = (panel.filters || []).map((f) => colMap
+        ? { columnId: resolveColumnRef(f, colMap, 'filter'), operator: f.operator, value: f.value }
+        : { columnId: f.columnId, operator: f.operator, value: f.value });
+    const sorts = (panel.sorts || []).map((s) => colMap
+        ? { columnId: resolveColumnRef(s, colMap, 'sort'), direction: s.direction }
+        : { columnId: s.columnId, direction: s.direction });
+    const out = {
+        id: panel.id || generatePanelId(),
+        type: panel.type,
+        title: panel.title,
+        showTitle: panel.showTitle ?? true,
+        config,
+        filters,
+        sorts,
+    };
+    if (tableId)
+        out.tableId = tableId;
+    for (const k of ['x', 'y', 'w', 'h', 'minW', 'minH']) {
+        if (panel[k] !== undefined)
+            out[k] = panel[k];
+    }
+    if (panel.styling)
+        out.styling = panel.styling;
+    if (panel.customCss)
+        out.customCss = panel.customCss;
+    return out;
+}
+function defaultSizeForPanel(type, config) {
+    if (type === 'stat')
+        return { w: 2, h: 2 };
+    if (type === 'chart') {
+        const ct = config?.chartType || 'bar';
+        if (ct === 'pie' || ct === 'doughnut')
+            return { w: 2, h: 2 };
+        return { w: 3, h: 2 };
+    }
+    if (type === 'view') {
+        const vt = config?.viewType || 'table';
+        if (vt === 'table' || vt === 'gallery' || vt === 'list')
+            return { w: 4, h: 3 };
+        return { w: 4, h: 4 };
+    }
+    return { w: 4, h: 4 };
+}
+function findAvailablePosition(existing, w, h, gridCols = DEFAULT_GRID_COLS) {
+    const placed = existing.filter((p) => typeof p.x === 'number' && typeof p.y === 'number' &&
+        typeof p.w === 'number' && typeof p.h === 'number');
+    const maxY = placed.reduce((m, p) => Math.max(m, p.y + p.h), 0);
+    for (let y = 0; y <= maxY + 1; y++) {
+        for (let x = 0; x <= gridCols - w; x++) {
+            const collides = placed.some((p) => x < p.x + p.w && x + w > p.x && y < p.y + p.h && y + h > p.y);
+            if (!collides)
+                return { x, y };
+        }
+    }
+    return { x: 0, y: maxY };
+}
+function ensurePanelPlacement(panel, existing) {
+    const size = defaultSizeForPanel(panel.type, panel.config);
+    const w = panel.w ?? size.w;
+    const h = panel.h ?? size.h;
+    let x = panel.x;
+    let y = panel.y;
+    if (x === undefined || y === undefined) {
+        const pos = findAvailablePosition(existing, w, h);
+        x = pos.x;
+        y = pos.y;
+    }
+    return { ...panel, x, y, w, h };
+}
+async function fetchDashboard(client, scope, parentId, viewId) {
+    const res = await client.get(viewPath(scope, parentId, viewId));
+    if (res.error)
+        return { error: res.error.message };
+    return { view: res.data };
+}
+async function writeDashboardSettings(client, scope, parentId, viewId, body) {
+    const res = await client.patch(viewPath(scope, parentId, viewId), body);
+    if (res.error)
+        return { error: res.error.message };
+    return { data: res.data };
+}
+/** For panel-level ops, figure out which table a panel is pegged to.
+ *  Priority: explicit panel.table_id on the stored panel → fallback table_id (dashboard's table for table-scope).
+ */
+function panelTableId(panel, fallback) {
+    if (typeof panel.tableId === 'string')
+        return panel.tableId;
+    if (typeof panel.table_id === 'string')
+        return panel.table_id;
+    return fallback;
+}
+// ── tools ──────────────────────────────────────────────────────────────────────
+export function registerDashboardTools(server, client) {
+    // ── list_dashboards ──
+    server.tool('list_dashboards', 'List all dashboard views on a table, folder, or database. Dashboards are views with view_type="dashboard" containing panels.', ScopeFields, async ({ scope, parent_id }) => {
+        const res = await client.get(viewsBasePath(scope, parent_id));
+        if (res.error)
+            return mcpError(res.error.message);
+        const dashboards = (res.data || []).filter((v) => v.view_type === 'dashboard');
+        return mcpResult({
+            dashboards: dashboards.map((d) => ({
+                id: d.id,
+                name: d.name,
+                scope,
+                panel_count: Array.isArray(d.view_settings?.panels)
+                    ? d.view_settings.panels.length
+                    : 0,
+                created_date: d.created_date,
+                updated_date: d.updated_date,
+            })),
+        });
+    });
+    // ── get_dashboard ──
+    server.tool('get_dashboard', 'Get a dashboard view with all panels and settings.', {
+        ...ScopeFields,
+        view_id: z.string().uuid(),
+    }, async ({ scope, parent_id, view_id }) => {
+        const { view, error } = await fetchDashboard(client, scope, parent_id, view_id);
+        if (error)
+            return mcpError(error);
+        return mcpResult(view);
+    });
+    // ── create_dashboard ──
+    server.tool('create_dashboard', 'Create a dashboard on a table, folder, or database. For folder/database scopes, set panel.table_id on each panel that references columns.', {
+        ...ScopeFields,
+        name: z.string().min(1),
+        panels: z.array(PanelInputSchema).optional(),
+        dashboard_styling: DashboardStylingSchema.optional(),
+        grid_cols: z.number().int().min(1).max(24).optional(),
+        row_height: z.number().int().min(10).max(200).optional(),
+    }, async ({ scope, parent_id, name, panels, dashboard_styling, grid_cols, row_height }) => {
+        const cache = new ColumnMapCache(client);
+        const fallbackTableId = scope === 'table' ? parent_id : undefined;
+        const panelsOut = [];
+        if (panels && panels.length > 0) {
+            try {
+                for (const p of panels) {
+                    const translated = await translatePanelForWrite(p, cache, fallbackTableId);
+                    panelsOut.push(ensurePanelPlacement(translated, panelsOut));
+                }
+            }
+            catch (e) {
+                return mcpError(e.message);
+            }
+        }
+        const view_settings = {
+            panels: panelsOut,
+            gridCols: grid_cols ?? DEFAULT_GRID_COLS,
+            rowHeight: row_height ?? 40,
+            margin: [12, 12],
+            containerPadding: [0, 0],
+        };
+        if (dashboard_styling)
+            view_settings.dashboardStyling = dashboard_styling;
+        const res = await client.post(viewsBasePath(scope, parent_id), {
+            name,
+            view_type: 'dashboard',
+            view_settings,
+        });
+        if (res.error)
+            return mcpError(res.error.message);
+        return mcpResult({ message: `Dashboard "${name}" created with ${panelsOut.length} panel(s)`, dashboard: res.data });
+    });
+    // ── update_dashboard ──
+    server.tool('update_dashboard', 'Update a dashboard\'s name, panels, or styling. When panels is provided it REPLACES all panels — use add_panel/update_panel/delete_panel for incremental changes.', {
+        ...ScopeFields,
+        view_id: z.string().uuid(),
+        name: z.string().optional(),
+        panels: z.array(PanelInputSchema).optional(),
+        dashboard_styling: DashboardStylingSchema.optional(),
+        grid_cols: z.number().int().min(1).max(24).optional(),
+        row_height: z.number().int().min(10).max(200).optional(),
+    }, async ({ scope, parent_id, view_id, name, panels, dashboard_styling, grid_cols, row_height }) => {
+        const { view, error } = await fetchDashboard(client, scope, parent_id, view_id);
+        if (error)
+            return mcpError(error);
+        const current = (view?.view_settings || {});
+        const fallbackTableId = scope === 'table' ? parent_id : undefined;
+        const next = { ...current };
+        if (panels !== undefined) {
+            const cache = new ColumnMapCache(client);
+            const panelsOut = [];
+            try {
+                for (const p of panels) {
+                    const translated = await translatePanelForWrite(p, cache, fallbackTableId);
+                    panelsOut.push(ensurePanelPlacement(translated, panelsOut));
+                }
+            }
+            catch (e) {
+                return mcpError(e.message);
+            }
+            next.panels = panelsOut;
+        }
+        if (dashboard_styling !== undefined)
+            next.dashboardStyling = dashboard_styling;
+        if (grid_cols !== undefined)
+            next.gridCols = grid_cols;
+        if (row_height !== undefined)
+            next.rowHeight = row_height;
+        const body = { view_settings: next };
+        if (name !== undefined)
+            body.name = name;
+        const { data, error: writeErr } = await writeDashboardSettings(client, scope, parent_id, view_id, body);
+        if (writeErr)
+            return mcpError(writeErr);
+        return mcpResult({ message: 'Dashboard updated', dashboard: data });
+    });
+    // ── delete_dashboard ──
+    server.tool('delete_dashboard', 'Delete a dashboard view. Cannot delete the last remaining view.', {
+        ...ScopeFields,
+        view_id: z.string().uuid(),
+    }, async ({ scope, parent_id, view_id }) => {
+        const res = await client.delete(viewPath(scope, parent_id, view_id));
+        if (res.error)
+            return mcpError(res.error.message);
+        return mcpResult({ message: 'Dashboard deleted' });
+    });
+    // ── add_panel ──
+    server.tool('add_panel', 'Add a single panel to an existing dashboard. Auto-places on the grid if x/y omitted.', {
+        ...ScopeFields,
+        view_id: z.string().uuid(),
+        panel: PanelInputSchema,
+    }, async ({ scope, parent_id, view_id, panel }) => {
+        const { view, error } = await fetchDashboard(client, scope, parent_id, view_id);
+        if (error)
+            return mcpError(error);
+        const settings = (view?.view_settings || {});
+        const existing = Array.isArray(settings.panels) ? settings.panels : [];
+        const fallbackTableId = scope === 'table' ? parent_id : undefined;
+        const cache = new ColumnMapCache(client);
+        let translated;
+        try {
+            translated = await translatePanelForWrite(panel, cache, fallbackTableId);
+        }
+        catch (e) {
+            return mcpError(e.message);
+        }
+        const placed = ensurePanelPlacement(translated, existing);
+        const next = { ...settings, panels: [...existing, placed] };
+        const { error: writeErr } = await writeDashboardSettings(client, scope, parent_id, view_id, { view_settings: next });
+        if (writeErr)
+            return mcpError(writeErr);
+        return mcpResult({ message: 'Panel added', panel_id: placed.id, position: { x: placed.x, y: placed.y, w: placed.w, h: placed.h } });
+    });
+    // ── update_panel ──
+    server.tool('update_panel', 'Update fields on an existing panel. Patches merge; config merges shallowly.', {
+        ...ScopeFields,
+        view_id: z.string().uuid(),
+        panel_id: z.string(),
+        patch: z.object({
+            title: z.string().optional(),
+            showTitle: z.boolean().optional(),
+            config: z.record(z.string(), z.unknown()).optional(),
+            filters: z.array(PanelFilterSchema).optional(),
+            sorts: z.array(PanelSortSchema).optional(),
+            styling: z.record(z.string(), z.unknown()).optional(),
+            customCss: z.string().optional(),
+        }),
+    }, async ({ scope, parent_id, view_id, panel_id, patch }) => {
+        const { view, error } = await fetchDashboard(client, scope, parent_id, view_id);
+        if (error)
+            return mcpError(error);
+        const settings = (view?.view_settings || {});
+        const panels = Array.isArray(settings.panels) ? settings.panels : [];
+        const idx = panels.findIndex((p) => p.id === panel_id);
+        if (idx === -1)
+            return mcpError(`Panel "${panel_id}" not found on dashboard`);
+        const existing = panels[idx];
+        const fallbackTableId = scope === 'table' ? parent_id : undefined;
+        const panelTid = panelTableId(existing, fallbackTableId);
+        const cache = new ColumnMapCache(client);
+        let translatedConfig;
+        if (patch.config) {
+            if (!panelTid) {
+                // No table context — pass config through unchanged (user must provide raw IDs)
+                translatedConfig = patch.config;
+            }
+            else {
+                try {
+                    const colMap = await cache.get(panelTid);
+                    translatedConfig = translatePanelConfig(existing.type, patch.config, colMap);
+                }
+                catch (e) {
+                    return mcpError(e.message);
+                }
+            }
+        }
+        let translatedFilters;
+        if (patch.filters) {
+            if (!panelTid) {
+                translatedFilters = patch.filters.map((f) => ({ columnId: f.columnId, operator: f.operator, value: f.value }));
+            }
+            else {
+                const colMap = await cache.get(panelTid);
+                try {
+                    translatedFilters = patch.filters.map((f) => ({
+                        columnId: resolveColumnRef(f, colMap, 'filter'),
+                        operator: f.operator,
+                        value: f.value,
+                    }));
+                }
+                catch (e) {
+                    return mcpError(e.message);
+                }
+            }
+        }
+        let translatedSorts;
+        if (patch.sorts) {
+            if (!panelTid) {
+                translatedSorts = patch.sorts.map((s) => ({ columnId: s.columnId, direction: s.direction }));
+            }
+            else {
+                const colMap = await cache.get(panelTid);
+                try {
+                    translatedSorts = patch.sorts.map((s) => ({
+                        columnId: resolveColumnRef(s, colMap, 'sort'),
+                        direction: s.direction,
+                    }));
+                }
+                catch (e) {
+                    return mcpError(e.message);
+                }
+            }
+        }
+        const merged = { ...existing };
+        if (patch.title !== undefined)
+            merged.title = patch.title;
+        if (patch.showTitle !== undefined)
+            merged.showTitle = patch.showTitle;
+        if (translatedConfig) {
+            merged.config = { ...(existing.config || {}), ...translatedConfig };
+        }
+        if (translatedFilters)
+            merged.filters = translatedFilters;
+        if (translatedSorts)
+            merged.sorts = translatedSorts;
+        if (patch.styling !== undefined)
+            merged.styling = patch.styling;
+        if (patch.customCss !== undefined)
+            merged.customCss = patch.customCss;
+        const nextPanels = [...panels];
+        nextPanels[idx] = merged;
+        const next = { ...settings, panels: nextPanels };
+        const { error: writeErr } = await writeDashboardSettings(client, scope, parent_id, view_id, { view_settings: next });
+        if (writeErr)
+            return mcpError(writeErr);
+        return mcpResult({ message: 'Panel updated', panel_id });
+    });
+    // ── delete_panel ──
+    server.tool('delete_panel', 'Remove a panel from a dashboard.', {
+        ...ScopeFields,
+        view_id: z.string().uuid(),
+        panel_id: z.string(),
+    }, async ({ scope, parent_id, view_id, panel_id }) => {
+        const { view, error } = await fetchDashboard(client, scope, parent_id, view_id);
+        if (error)
+            return mcpError(error);
+        const settings = (view?.view_settings || {});
+        const panels = Array.isArray(settings.panels) ? settings.panels : [];
+        const nextPanels = panels.filter((p) => p.id !== panel_id);
+        if (nextPanels.length === panels.length)
+            return mcpError(`Panel "${panel_id}" not found`);
+        const next = { ...settings, panels: nextPanels };
+        const { error: writeErr } = await writeDashboardSettings(client, scope, parent_id, view_id, { view_settings: next });
+        if (writeErr)
+            return mcpError(writeErr);
+        return mcpResult({ message: 'Panel deleted', panel_id });
+    });
+    // ── move_panel ──
+    server.tool('move_panel', 'Change the position/size of a panel on the grid.', {
+        ...ScopeFields,
+        view_id: z.string().uuid(),
+        panel_id: z.string(),
+        x: z.number().int().min(0).optional(),
+        y: z.number().int().min(0).optional(),
+        w: z.number().int().min(1).optional(),
+        h: z.number().int().min(1).optional(),
+    }, async ({ scope, parent_id, view_id, panel_id, x, y, w, h }) => {
+        const { view, error } = await fetchDashboard(client, scope, parent_id, view_id);
+        if (error)
+            return mcpError(error);
+        const settings = (view?.view_settings || {});
+        const panels = Array.isArray(settings.panels) ? settings.panels : [];
+        const idx = panels.findIndex((p) => p.id === panel_id);
+        if (idx === -1)
+            return mcpError(`Panel "${panel_id}" not found`);
+        const merged = { ...panels[idx] };
+        if (x !== undefined)
+            merged.x = x;
+        if (y !== undefined)
+            merged.y = y;
+        if (w !== undefined)
+            merged.w = w;
+        if (h !== undefined)
+            merged.h = h;
+        const nextPanels = [...panels];
+        nextPanels[idx] = merged;
+        const next = { ...settings, panels: nextPanels };
+        const { error: writeErr } = await writeDashboardSettings(client, scope, parent_id, view_id, { view_settings: next });
+        if (writeErr)
+            return mcpError(writeErr);
+        return mcpResult({ message: 'Panel moved', panel_id, position: { x: merged.x, y: merged.y, w: merged.w, h: merged.h } });
+    });
+}
+//# sourceMappingURL=dashboards.js.map