@reveldigital/mcp-graphql-proxy 1.16.0 → 1.18.0

package/dist/index.js

@@ -19,6 +19,7 @@ import { GraphQLClient } from './core/graphql-client.js';
 import { ResponseCache } from './core/cache.js';
 import { QueryBuilder } from './core/query-builder.js';
 import { ResponseOptimizer } from './core/response-optimizer.js';
+import { generateSystemPrompt, generateCompactPrompt } from './core/system-prompt.js';
 import { defaultGraphQLProxyConfig, } from './types/graphql-proxy.js';
 // ============================================================================
 // Server Configuration
@@ -121,6 +122,8 @@ server.tool('build_query', 'Build an optimized GraphQL query with field selectio
         'alert',
         // Audit & Compliance
         'auditEvent',
+        // Data Tables
+        'dataTables', 'dataTable',
         // Device Commands & Permissions
         'displayCommands', 'permissions',
         // Analytics (aggregated metrics - optimized for AI context windows)
@@ -696,15 +699,42 @@ server.tool('add_playlist_source', 'Add a content source to an existing playlist
     source: z.object({
         name: z.string().optional().describe('Display name for the source'),
         type: z.enum([
-            'IMAGE', 'VIDEO', 'AUDIO', 'PDF', 'SVG',
-            'TEMPLATE', 'PLAYLIST', 'URL', 'WEBPAGE', 'RSS', 'TEXT', 'YOUTUBE',
-        ]).describe('The content type'),
-        mediaId: z.string().optional().describe('Media file ID (for Image, Video, Audio, Pdf, Svg types)'),
-        templateId: z.string().optional().describe('Template ID (for Template type)'),
-        playlistId: z.string().optional().describe('Embedded playlist ID (for Playlist type)'),
-        value: z.string().optional().describe('URL or text value (for Url, WebPage, Rss, Text, YouTube types)'),
+            'AUDIO', 'COMMAND', 'FLASH', 'GADGET', 'IMAGE', 'PDF',
+            'PLACE_EXCHANGE', 'PLAYLIST', 'POWER_POINT', 'RSS', 'SVG',
+            'TEMPLATE', 'TEXT', 'TWITTER', 'URL', 'VIDEO',
+            'VISTAR_MEDIA', 'WEB_PAGE', 'YOU_TUBE', 'VISTAR_MEDIA_EX',
+        ]).describe('The content type (e.g., IMAGE, VIDEO, TEMPLATE, PLAYLIST, URL, WEB_PAGE, YOU_TUBE)'),
+        mediaId: z.string().optional().describe('Media file ID (for IMAGE, VIDEO, AUDIO, PDF, SVG types)'),
+        templateId: z.string().optional().describe('Template ID (for TEMPLATE type)'),
+        playlistId: z.string().optional().describe('Embedded playlist ID (for PLAYLIST type)'),
+        value: z.string().optional().describe('URL or text value (for URL, WEB_PAGE, RSS, TEXT, YOU_TUBE types)'),
         interval: z.number().optional().describe('Duration in seconds'),
-        loopPolicyType: z.enum(['LOOP', 'PLAY_ONCE', 'PLAY_THROUGH']).optional().describe('Loop policy for fixed-duration playlists'),
+        loopPolicyType: z.enum([
+            'DEFAULT', 'OVER_SATURATE2X', 'OVER_SATURATE3X', 'OVER_SATURATE4X', 'OVER_SATURATE5X',
+            'RANDOM', 'UNDER_SATURATE2X', 'UNDER_SATURATE3X', 'UNDER_SATURATE4X', 'UNDER_SATURATE5X',
+            'PREFILL', 'POSTFILL', 'SPREADFILL',
+        ]).optional().describe('Loop policy (DEFAULT=1x per loop, OVER_SATURATE2X=2x per loop, UNDER_SATURATE2X=1 per 2 loops, RANDOM, PREFILL, POSTFILL, SPREADFILL)'),
+        conditions: z.array(z.object({
+            type: z.enum([
+                'AFTER_DATE', 'AFTER_TIME', 'ALWAYS', 'BEACON_ACTIVE', 'BEFORE_DATE', 'BEFORE_TIME',
+                'COMMAND', 'DATE_RANGE', 'DAY_OF_MONTH', 'DAYS_OF_WEEK',
+                'DEVICE_BY_GROUP', 'DEVICE_BY_NESTED_GROUP', 'DEVICE_BY_NAME', 'DEVICE_BY_TAG', 'DEVICE_BY_ORG',
+                'EVERYWHERE', 'GEO_LOCATION', 'GPS_WITHIN_RADIUS', 'KEY_EVENT',
+                'MONTH_OF_YEAR', 'MOTION', 'NEVER', 'NOWHERE',
+                'PCT_ADULT', 'PCT_CHILD', 'PCT_FEMALE', 'PCT_MALE', 'PCT_SENIOR', 'PCT_YOUNG', 'PCT_YOUNG_ADULT',
+                'PLAYLIST_BY_NAME', 'PLAYLIST_BY_TAG', 'SEND_COMMAND',
+                'SPECIFIC_DEVICE', 'SPECIFIC_PLAYLIST', 'SPECIFIC_TEMPLATE', 'SPECIFIC_ZONE',
+                'TEMPLATE_BY_NAME', 'TEMPLATE_BY_TAG',
+                'TIME_RANGE', 'TOPIC_SET', 'TOTAL_VIEWERS_GREATER_THAN', 'TOTAL_VIEWERS_LESS_THAN',
+                'TOUCH_EVENT', 'WEEK_OF_MONTH', 'WEEK_OF_YEAR',
+            ]).describe('Condition type (e.g., DATE_RANGE, TIME_RANGE, DAYS_OF_WEEK, SPECIFIC_DEVICE)'),
+            operator: z.enum(['AND', 'OR', 'AND_NOT', 'OR_NOT']).optional()
+                .describe('Logical operator for combining with previous condition (ignored for first condition)'),
+            value1: z.string().optional().describe('Value 1 - meaning depends on condition type'),
+            value2: z.string().optional().describe('Value 2 - meaning depends on condition type'),
+            value3: z.string().optional().describe('Value 3 - meaning depends on condition type'),
+            value4: z.string().optional().describe('Value 4 - meaning depends on condition type'),
+        })).optional().describe('Conditions controlling when/where this source plays (e.g., date range, time range, device targeting). If omitted, plays unconditionally.'),
     }).describe('The source to add'),
     position: z.number().optional().describe('Optional position (0-based index). If omitted, appends to end.'),
 }, async (args) => {
@@ -762,15 +792,42 @@ server.tool('update_playlist_source', 'Update a source within a playlist. Only p
     source: z.object({
         name: z.string().optional().describe('New display name'),
         type: z.enum([
-            'IMAGE', 'VIDEO', 'AUDIO', 'PDF', 'SVG',
-            'TEMPLATE', 'PLAYLIST', 'URL', 'WEBPAGE', 'RSS', 'TEXT', 'YOUTUBE',
+            'AUDIO', 'COMMAND', 'FLASH', 'GADGET', 'IMAGE', 'PDF',
+            'PLACE_EXCHANGE', 'PLAYLIST', 'POWER_POINT', 'RSS', 'SVG',
+            'TEMPLATE', 'TEXT', 'TWITTER', 'URL', 'VIDEO',
+            'VISTAR_MEDIA', 'WEB_PAGE', 'YOU_TUBE', 'VISTAR_MEDIA_EX',
         ]).optional().describe('New content type'),
         mediaId: z.string().optional().describe('New media file ID'),
         templateId: z.string().optional().describe('New template ID'),
         playlistId: z.string().optional().describe('New embedded playlist ID'),
         value: z.string().optional().describe('New URL or text value'),
         interval: z.number().optional().describe('New duration in seconds'),
-        loopPolicyType: z.enum(['LOOP', 'PLAY_ONCE', 'PLAY_THROUGH']).optional().describe('New loop policy'),
+        loopPolicyType: z.enum([
+            'DEFAULT', 'OVER_SATURATE2X', 'OVER_SATURATE3X', 'OVER_SATURATE4X', 'OVER_SATURATE5X',
+            'RANDOM', 'UNDER_SATURATE2X', 'UNDER_SATURATE3X', 'UNDER_SATURATE4X', 'UNDER_SATURATE5X',
+            'PREFILL', 'POSTFILL', 'SPREADFILL',
+        ]).optional().describe('New loop policy'),
+        conditions: z.array(z.object({
+            type: z.enum([
+                'AFTER_DATE', 'AFTER_TIME', 'ALWAYS', 'BEACON_ACTIVE', 'BEFORE_DATE', 'BEFORE_TIME',
+                'COMMAND', 'DATE_RANGE', 'DAY_OF_MONTH', 'DAYS_OF_WEEK',
+                'DEVICE_BY_GROUP', 'DEVICE_BY_NESTED_GROUP', 'DEVICE_BY_NAME', 'DEVICE_BY_TAG', 'DEVICE_BY_ORG',
+                'EVERYWHERE', 'GEO_LOCATION', 'GPS_WITHIN_RADIUS', 'KEY_EVENT',
+                'MONTH_OF_YEAR', 'MOTION', 'NEVER', 'NOWHERE',
+                'PCT_ADULT', 'PCT_CHILD', 'PCT_FEMALE', 'PCT_MALE', 'PCT_SENIOR', 'PCT_YOUNG', 'PCT_YOUNG_ADULT',
+                'PLAYLIST_BY_NAME', 'PLAYLIST_BY_TAG', 'SEND_COMMAND',
+                'SPECIFIC_DEVICE', 'SPECIFIC_PLAYLIST', 'SPECIFIC_TEMPLATE', 'SPECIFIC_ZONE',
+                'TEMPLATE_BY_NAME', 'TEMPLATE_BY_TAG',
+                'TIME_RANGE', 'TOPIC_SET', 'TOTAL_VIEWERS_GREATER_THAN', 'TOTAL_VIEWERS_LESS_THAN',
+                'TOUCH_EVENT', 'WEEK_OF_MONTH', 'WEEK_OF_YEAR',
+            ]).describe('Condition type (e.g., DATE_RANGE, TIME_RANGE, DAYS_OF_WEEK, SPECIFIC_DEVICE)'),
+            operator: z.enum(['AND', 'OR', 'AND_NOT', 'OR_NOT']).optional()
+                .describe('Logical operator for combining with previous condition (ignored for first condition)'),
+            value1: z.string().optional().describe('Value 1 - meaning depends on condition type'),
+            value2: z.string().optional().describe('Value 2 - meaning depends on condition type'),
+            value3: z.string().optional().describe('Value 3 - meaning depends on condition type'),
+            value4: z.string().optional().describe('Value 4 - meaning depends on condition type'),
+        })).optional().describe('Conditions controlling when/where this source plays. Replaces existing conditions. If omitted, conditions are unchanged.'),
     }).describe('Updated source properties (only provided fields are changed)'),
 }, async (args) => {
     try {
@@ -919,6 +976,916 @@ mutation ReorderPlaylistSources($input: ReorderPlaylistSourcesInput) {
     }
 });
 // ============================================================================
+// Tool: List Data Tables
+// ============================================================================
+server.tool('list_data_tables', 'List data tables in the account. Returns table summaries with pagination. Use to discover available tables before querying rows.', {
+    groupId: z.string().optional().describe('Optional group ID to filter by'),
+    pageSize: z.number().optional().default(50).describe('Number of tables per page (default 50)'),
+    continuationToken: z.string().optional().describe('Token for fetching the next page'),
+}, async (args) => {
+    try {
+        const query = `
+query DataTables($groupId: String, $pageSize: Int! = 50, $continuationToken: String) {
+  dataTables(groupId: $groupId, pageSize: $pageSize, continuationToken: $continuationToken) {
+    data {
+      id
+      name
+      description
+      columnCount
+      rowCount
+      groupId
+      updatedAt
+    }
+    continuationToken
+  }
+}`;
+        const variables = { pageSize: args.pageSize };
+        if (args.groupId)
+            variables.groupId = args.groupId;
+        if (args.continuationToken)
+            variables.continuationToken = args.continuationToken;
+        const response = await graphqlClient.query(query, variables);
+        if (response.errors && response.errors.length > 0) {
+            const result = {
+                success: false,
+                error: response.errors.map((e) => e.message).join('; '),
+            };
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        const result = {
+            success: true,
+            data: response.data,
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const result = {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+});
+// ============================================================================
+// Tool: Get Data Table
+// ============================================================================
+server.tool('get_data_table', 'Get a single data table definition by ID, including its full column schema. Use this to understand table structure before querying or modifying rows.', {
+    tableId: z.string().describe('The data table ID'),
+}, async (args) => {
+    try {
+        const query = `
+query DataTable($tableId: String) {
+  dataTable(tableId: $tableId) {
+    id
+    name
+    description
+    groupId
+    rowCount
+    cacheTtlSeconds
+    createdAt
+    updatedAt
+    columns {
+      id
+      name
+      key
+      type
+      required
+      sortable
+      options
+      default
+    }
+  }
+}`;
+        const response = await graphqlClient.query(query, { tableId: args.tableId });
+        if (response.errors && response.errors.length > 0) {
+            const result = {
+                success: false,
+                error: response.errors.map((e) => e.message).join('; '),
+            };
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        const result = {
+            success: true,
+            data: response.data,
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const result = {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+});
+// ============================================================================
+// Tool: List Data Table Rows
+// ============================================================================
+server.tool('list_data_table_rows', 'List rows in a data table with optional filtering, sorting, field selection, and pagination.', {
+    tableId: z.string().describe('The data table ID'),
+    filter: z.string().optional().describe('Optional filter as a JSON string (e.g., {"status":"active"})'),
+    sort: z.string().optional().describe('Column key to sort by'),
+    sortDir: z.enum(['asc', 'desc']).optional().default('asc').describe('Sort direction'),
+    pageSize: z.number().optional().default(50).describe('Number of rows per page (default 50)'),
+    continuationToken: z.string().optional().describe('Token for fetching the next page'),
+    fields: z.string().optional().describe('Comma-separated list of column keys to return'),
+}, async (args) => {
+    try {
+        const query = `
+query DataTableRows($tableId: String, $filter: String, $sort: String, $sortDir: String = "asc", $pageSize: Int! = 50, $continuationToken: String, $fields: String) {
+  dataTableRows(tableId: $tableId, filter: $filter, sort: $sort, sortDir: $sortDir, pageSize: $pageSize, continuationToken: $continuationToken, fields: $fields) {
+    data {
+      id
+      sortOrder
+      data
+      updatedAt
+    }
+    totalCount
+    continuationToken
+  }
+}`;
+        const variables = {
+            tableId: args.tableId,
+            pageSize: args.pageSize,
+            sortDir: args.sortDir,
+        };
+        if (args.filter)
+            variables.filter = args.filter;
+        if (args.sort)
+            variables.sort = args.sort;
+        if (args.continuationToken)
+            variables.continuationToken = args.continuationToken;
+        if (args.fields)
+            variables.fields = args.fields;
+        const response = await graphqlClient.query(query, variables);
+        if (response.errors && response.errors.length > 0) {
+            const result = {
+                success: false,
+                error: response.errors.map((e) => e.message).join('; '),
+            };
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        const result = {
+            success: true,
+            data: response.data,
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const result = {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+});
+// ============================================================================
+// Tool: Get Data Table Row
+// ============================================================================
+server.tool('get_data_table_row', 'Get a single row from a data table by row ID.', {
+    tableId: z.string().describe('The data table ID'),
+    rowId: z.string().describe('The row ID'),
+}, async (args) => {
+    try {
+        const query = `
+query DataTableRow($tableId: String, $rowId: String) {
+  dataTableRow(tableId: $tableId, rowId: $rowId) {
+    id
+    sortOrder
+    data
+    updatedAt
+  }
+}`;
+        const response = await graphqlClient.query(query, {
+            tableId: args.tableId,
+            rowId: args.rowId,
+        });
+        if (response.errors && response.errors.length > 0) {
+            const result = {
+                success: false,
+                error: response.errors.map((e) => e.message).join('; '),
+            };
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        const result = {
+            success: true,
+            data: response.data,
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const result = {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+});
+// ============================================================================
+// Tool: Export Data Table Rows
+// ============================================================================
+server.tool('export_data_table_rows', 'Export all rows from a data table as a CSV string. Useful for bulk data extraction or backup.', {
+    tableId: z.string().describe('The data table ID'),
+}, async (args) => {
+    try {
+        const query = `
+query ExportDataTableRows($tableId: String) {
+  exportDataTableRows(tableId: $tableId)
+}`;
+        const response = await graphqlClient.query(query, { tableId: args.tableId });
+        if (response.errors && response.errors.length > 0) {
+            const result = {
+                success: false,
+                error: response.errors.map((e) => e.message).join('; '),
+            };
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        const result = {
+            success: true,
+            data: response.data,
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const result = {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+});
+// ============================================================================
+// Tool: Get Data Table Row Versions
+// ============================================================================
+server.tool('get_data_table_row_versions', 'List version history for a data table row (newest first). Use to audit changes or before rolling back.', {
+    tableId: z.string().describe('The data table ID'),
+    rowId: z.string().describe('The row ID'),
+    pageSize: z.number().optional().default(25).describe('Number of versions per page (default 25)'),
+    continuationToken: z.string().optional().describe('Token for fetching the next page'),
+}, async (args) => {
+    try {
+        const query = `
+query DataTableRowVersions($tableId: String, $rowId: String, $pageSize: Int! = 25, $continuationToken: String) {
+  dataTableRowVersions(tableId: $tableId, rowId: $rowId, pageSize: $pageSize, continuationToken: $continuationToken) {
+    data {
+      id
+      rowId
+      version
+      action
+      data
+      changedFields
+      previousValues
+      changedBy
+      changedAt
+    }
+    totalCount
+    continuationToken
+  }
+}`;
+        const variables = {
+            tableId: args.tableId,
+            rowId: args.rowId,
+            pageSize: args.pageSize,
+        };
+        if (args.continuationToken)
+            variables.continuationToken = args.continuationToken;
+        const response = await graphqlClient.query(query, variables);
+        if (response.errors && response.errors.length > 0) {
+            const result = {
+                success: false,
+                error: response.errors.map((e) => e.message).join('; '),
+            };
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        const result = {
+            success: true,
+            data: response.data,
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const result = {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+});
+// ============================================================================
+// Tool: Get Data Table Row Version
+// ============================================================================
+server.tool('get_data_table_row_version', 'Get a specific version snapshot of a data table row. Use to inspect historical state before rollback.', {
+    tableId: z.string().describe('The data table ID'),
+    rowId: z.string().describe('The row ID'),
+    version: z.number().describe('The version number to retrieve'),
+}, async (args) => {
+    try {
+        const query = `
+query DataTableRowVersion($tableId: String, $rowId: String, $version: Int!) {
+  dataTableRowVersion(tableId: $tableId, rowId: $rowId, version: $version) {
+    id
+    rowId
+    version
+    action
+    data
+    changedFields
+    previousValues
+    changedBy
+    changedAt
+  }
+}`;
+        const response = await graphqlClient.query(query, {
+            tableId: args.tableId,
+            rowId: args.rowId,
+            version: args.version,
+        });
+        if (response.errors && response.errors.length > 0) {
+            const result = {
+                success: false,
+                error: response.errors.map((e) => e.message).join('; '),
+            };
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        const result = {
+            success: true,
+            data: response.data,
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const result = {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+});
+// ============================================================================
+// Tool: Create Data Table
+// ============================================================================
+server.tool('create_data_table', 'Create a new data table with the specified column schema. Example: Create a menu board table with columns for item name, price, description, and image.', {
+    name: z.string().describe('Table name (max 100 characters)'),
+    description: z.string().optional().describe('Optional table description (max 500 characters)'),
+    groupId: z.string().optional().describe('Optional group ID for organizing tables'),
+    columns: z.array(z.object({
+        name: z.string().describe('Display name for the column'),
+        key: z.string().describe('Unique key used in row data objects'),
+        type: z.enum(['STRING', 'NUMBER', 'BOOLEAN', 'DATE', 'SELECT', 'MEDIA', 'URL', 'RICH_TEXT', 'TIME', 'HIDDEN'])
+            .describe('Data type of the column'),
+        required: z.boolean().describe('Whether a value is required'),
+        sortable: z.boolean().describe('Whether the column supports sorting'),
+        options: z.array(z.string()).optional().describe('Allowed values for Select-type columns'),
+        default: z.unknown().optional().describe('Default value for the column'),
+    })).describe('Column definitions (at least one required)'),
+    cacheTtlSeconds: z.number().optional().describe('Optional cache TTL in seconds for gadget/player reads'),
+}, async (args) => {
+    try {
+        const mutation = `
+mutation CreateDataTable($input: CreateDataTableInput) {
+  createDataTable(input: $input) {
+    success
+    table {
+      id
+      name
+      description
+      columns {
+        id
+        name
+        key
+        type
+        required
+      }
+      rowCount
+      createdAt
+    }
+    error
+  }
+}`;
+        const input = {
+            name: args.name,
+            columns: args.columns,
+        };
+        if (args.description !== undefined)
+            input.description = args.description;
+        if (args.groupId !== undefined)
+            input.groupId = args.groupId;
+        if (args.cacheTtlSeconds !== undefined)
+            input.cacheTtlSeconds = args.cacheTtlSeconds;
+        const response = await graphqlClient.query(mutation, { input });
+        if (response.errors && response.errors.length > 0) {
+            const result = {
+                success: false,
+                error: response.errors.map((e) => e.message).join('; '),
+            };
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        const result = {
+            success: true,
+            data: response.data,
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const result = {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+});
+// ============================================================================
+// Tool: Update Data Table
+// ============================================================================
+server.tool('update_data_table', 'Update an existing data table definition. Only provided fields are changed. Example: Add a new "calories" column to a menu board table.', {
+    tableId: z.string().describe('The table ID to update'),
+    name: z.string().optional().describe('New table name (null leaves unchanged)'),
+    description: z.string().optional().describe('New description (null leaves unchanged)'),
+    groupId: z.string().optional().describe('New group ID (null leaves unchanged)'),
+    columns: z.array(z.object({
+        id: z.string().optional().describe('Column ID (only needed when updating existing columns)'),
+        name: z.string().optional().describe('Display name for the column'),
+        key: z.string().optional().describe('Unique key used in row data objects'),
+        type: z.enum(['STRING', 'NUMBER', 'BOOLEAN', 'DATE', 'SELECT', 'MEDIA', 'URL', 'RICH_TEXT', 'TIME', 'HIDDEN'])
+            .describe('Data type of the column'),
+        required: z.boolean().describe('Whether a value is required'),
+        sortable: z.boolean().describe('Whether the column supports sorting'),
+        options: z.array(z.string()).optional().describe('Allowed values for Select-type columns'),
+        default: z.unknown().optional().describe('Default value for the column'),
+    })).optional().describe('Updated column definitions (null leaves unchanged)'),
+    cacheTtlSeconds: z.number().optional().describe('New cache TTL in seconds (null leaves unchanged)'),
+}, async (args) => {
+    try {
+        const mutation = `
+mutation UpdateDataTable($input: UpdateDataTableInput) {
+  updateDataTable(input: $input) {
+    success
+    table {
+      id
+      name
+      description
+      columns {
+        id
+        name
+        key
+        type
+        required
+      }
+      rowCount
+      updatedAt
+    }
+    error
+  }
+}`;
+        const input = { tableId: args.tableId };
+        if (args.name !== undefined)
+            input.name = args.name;
+        if (args.description !== undefined)
+            input.description = args.description;
+        if (args.groupId !== undefined)
+            input.groupId = args.groupId;
+        if (args.columns !== undefined)
+            input.columns = args.columns;
+        if (args.cacheTtlSeconds !== undefined)
+            input.cacheTtlSeconds = args.cacheTtlSeconds;
+        const response = await graphqlClient.query(mutation, { input });
+        if (response.errors && response.errors.length > 0) {
+            const result = {
+                success: false,
+                error: response.errors.map((e) => e.message).join('; '),
+            };
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        const result = {
+            success: true,
+            data: response.data,
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const result = {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+});
+// ============================================================================
+// Tool: Delete Data Table
+// ============================================================================
+server.tool('delete_data_table', 'Delete a data table and all its rows. This action is irreversible.', {
+    tableId: z.string().describe('The data table ID to delete'),
+}, async (args) => {
+    try {
+        const mutation = `
+mutation DeleteDataTable($tableId: String) {
+  deleteDataTable(tableId: $tableId) {
+    success
+    error
+  }
+}`;
+        const response = await graphqlClient.query(mutation, { tableId: args.tableId });
+        if (response.errors && response.errors.length > 0) {
+            const result = {
+                success: false,
+                error: response.errors.map((e) => e.message).join('; '),
+            };
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        const result = {
+            success: true,
+            data: response.data,
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const result = {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+});
+// ============================================================================
+// Tool: Create Data Table Row
+// ============================================================================
+server.tool('create_data_table_row', 'Create a new row in a data table. Row data keys must match column keys defined in the table schema. Example: Add a new menu item to a menu board table.', {
+    tableId: z.string().describe('The table ID to add the row to'),
+    data: z.array(z.unknown()).describe('Row data as a JSON array. Keys must match column keys defined in the table schema.'),
+}, async (args) => {
+    try {
+        const mutation = `
+mutation CreateDataTableRow($input: CreateDataTableRowInput) {
+  createDataTableRow(input: $input) {
+    success
+    row {
+      id
+      sortOrder
+      data
+      updatedAt
+    }
+    error
+    validationErrors
+  }
+}`;
+        const response = await graphqlClient.query(mutation, {
+            input: {
+                tableId: args.tableId,
+                data: args.data,
+            },
+        });
+        if (response.errors && response.errors.length > 0) {
+            const result = {
+                success: false,
+                error: response.errors.map((e) => e.message).join('; '),
+            };
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        const result = {
+            success: true,
+            data: response.data,
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const result = {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+});
+// ============================================================================
+// Tool: Update Data Table Row
+// ============================================================================
+server.tool('update_data_table_row', 'Update an existing row in a data table (partial update - only provided keys are changed). Supports optimistic concurrency via eTag. Example: Update the price of a menu item.', {
+    tableId: z.string().describe('The table ID containing the row'),
+    rowId: z.string().describe('The row ID to update'),
+    data: z.array(z.unknown()).describe('Partial row data. Only provided keys are updated.'),
+    eTag: z.string().optional().describe('Optional ETag for optimistic concurrency. Pass the row\'s current ETag to prevent conflicting writes.'),
+}, async (args) => {
+    try {
+        const mutation = `
+mutation UpdateDataTableRow($input: UpdateDataTableRowInput) {
+  updateDataTableRow(input: $input) {
+    success
+    row {
+      id
+      sortOrder
+      data
+      updatedAt
+    }
+    error
+    validationErrors
+  }
+}`;
+        const input = {
+            tableId: args.tableId,
+            rowId: args.rowId,
+            data: args.data,
+        };
+        if (args.eTag !== undefined)
+            input.eTag = args.eTag;
+        const response = await graphqlClient.query(mutation, { input });
+        if (response.errors && response.errors.length > 0) {
+            const result = {
+                success: false,
+                error: response.errors.map((e) => e.message).join('; '),
+            };
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        const result = {
+            success: true,
+            data: response.data,
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const result = {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+});
+// ============================================================================
+// Tool: Delete Data Table Row
+// ============================================================================
+server.tool('delete_data_table_row', 'Delete a row from a data table.', {
+    tableId: z.string().describe('The data table ID'),
+    rowId: z.string().describe('The row ID to delete'),
+}, async (args) => {
+    try {
+        const mutation = `
+mutation DeleteDataTableRow($tableId: String, $rowId: String) {
+  deleteDataTableRow(tableId: $tableId, rowId: $rowId) {
+    success
+    error
+  }
+}`;
+        const response = await graphqlClient.query(mutation, {
+            tableId: args.tableId,
+            rowId: args.rowId,
+        });
+        if (response.errors && response.errors.length > 0) {
+            const result = {
+                success: false,
+                error: response.errors.map((e) => e.message).join('; '),
+            };
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        const result = {
+            success: true,
+            data: response.data,
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const result = {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+});
+// ============================================================================
+// Tool: Batch Create Data Table Rows
+// ============================================================================
+server.tool('batch_create_data_table_rows', 'Batch create multiple rows in a data table (max 100 rows per call). Example: Bulk-load menu items from an external data source.', {
+    tableId: z.string().describe('The table ID to add rows to'),
+    rows: z.array(z.array(z.unknown())).describe('Array of row data objects to create (max 100)'),
+}, async (args) => {
+    try {
+        const mutation = `
+mutation BatchCreateDataTableRows($input: BatchCreateDataTableRowsInput) {
+  batchCreateDataTableRows(input: $input) {
+    success
+    results {
+      rowId
+      success
+      error
+    }
+    error
+  }
+}`;
+        const response = await graphqlClient.query(mutation, {
+            input: {
+                tableId: args.tableId,
+                rows: args.rows,
+            },
+        });
+        if (response.errors && response.errors.length > 0) {
+            const result = {
+                success: false,
+                error: response.errors.map((e) => e.message).join('; '),
+            };
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        const result = {
+            success: true,
+            data: response.data,
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const result = {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+});
+// ============================================================================
+// Tool: Batch Delete Data Table Rows
+// ============================================================================
+server.tool('batch_delete_data_table_rows', 'Batch delete multiple rows from a data table (max 100 row IDs per call).', {
+    tableId: z.string().describe('The table ID containing the rows'),
+    rowIds: z.array(z.string()).describe('Row IDs to delete (max 100)'),
+}, async (args) => {
+    try {
+        const mutation = `
+mutation BatchDeleteDataTableRows($input: BatchDeleteDataTableRowsInput) {
+  batchDeleteDataTableRows(input: $input) {
+    success
+    deletedCount
+    results {
+      rowId
+      success
+      error
+    }
+    error
+  }
+}`;
+        const response = await graphqlClient.query(mutation, {
+            input: {
+                tableId: args.tableId,
+                rowIds: args.rowIds,
+            },
+        });
+        if (response.errors && response.errors.length > 0) {
+            const result = {
+                success: false,
+                error: response.errors.map((e) => e.message).join('; '),
+            };
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        const result = {
+            success: true,
+            data: response.data,
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const result = {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+});
+// ============================================================================
+// Tool: Import Data Table Rows
+// ============================================================================
+server.tool('import_data_table_rows', 'Import rows from CSV content into a data table. Use replace mode to overwrite all existing rows, or append mode to add to existing rows.', {
+    tableId: z.string().describe('The table ID to import rows into'),
+    csvContent: z.string().describe('Raw CSV content (header row + data rows)'),
+    replace: z.boolean().default(false).describe('When true, replaces all existing rows. When false (default), appends to existing rows.'),
+}, async (args) => {
+    try {
+        const mutation = `
+mutation ImportDataTableRows($input: ImportDataTableRowsInput) {
+  importDataTableRows(input: $input) {
+    success
+    successCount
+    errorCount
+    errors {
+      lineNumber
+      error
+    }
+    error
+  }
+}`;
+        const response = await graphqlClient.query(mutation, {
+            input: {
+                tableId: args.tableId,
+                csvContent: args.csvContent,
+                replace: args.replace,
+            },
+        });
+        if (response.errors && response.errors.length > 0) {
+            const result = {
+                success: false,
+                error: response.errors.map((e) => e.message).join('; '),
+            };
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        const result = {
+            success: true,
+            data: response.data,
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const result = {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+});
+// ============================================================================
+// Tool: Reorder Data Table Rows
+// ============================================================================
+server.tool('reorder_data_table_rows', 'Reorder rows in a data table by specifying the desired row ID sequence.', {
+    tableId: z.string().describe('The table ID containing the rows'),
+    rowIds: z.array(z.string()).describe('Row IDs in the desired display order'),
+}, async (args) => {
+    try {
+        const mutation = `
+mutation ReorderDataTableRows($input: ReorderDataTableRowsInput) {
+  reorderDataTableRows(input: $input) {
+    success
+    error
+  }
+}`;
+        const response = await graphqlClient.query(mutation, {
+            input: {
+                tableId: args.tableId,
+                rowIds: args.rowIds,
+            },
+        });
+        if (response.errors && response.errors.length > 0) {
+            const result = {
+                success: false,
+                error: response.errors.map((e) => e.message).join('; '),
+            };
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        const result = {
+            success: true,
+            data: response.data,
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const result = {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+});
+// ============================================================================
+// Tool: Rollback Data Table Row
+// ============================================================================
+server.tool('rollback_data_table_row', 'Roll back a data table row to a previous version, creating a new version for the rollback action. Example: Undo an accidental price change by restoring a previous version.', {
+    tableId: z.string().describe('The table ID containing the row'),
+    rowId: z.string().describe('The row ID to roll back'),
+    version: z.number().describe('The version number to restore'),
+}, async (args) => {
+    try {
+        const mutation = `
+mutation RollbackDataTableRow($input: RollbackDataTableRowInput) {
+  rollbackDataTableRow(input: $input) {
+    success
+    newVersion
+    restoredRow {
+      id
+      sortOrder
+      data
+      updatedAt
+    }
+    error
+  }
+}`;
+        const response = await graphqlClient.query(mutation, {
+            input: {
+                tableId: args.tableId,
+                rowId: args.rowId,
+                version: args.version,
+            },
+        });
+        if (response.errors && response.errors.length > 0) {
+            const result = {
+                success: false,
+                error: response.errors.map((e) => e.message).join('; '),
+            };
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        const result = {
+            success: true,
+            data: response.data,
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const result = {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+});
+// ============================================================================
 // Tool: Cache Management
 // ============================================================================
 server.tool('manage_cache', 'Manage the response cache - view statistics or clear cached data.', {
@@ -968,6 +1935,15 @@ server.resource('schema://reveldigital/graphql', 'Revel Digital GraphQL Schema',
 - templateGroups - Query template groups
 - user - Query users
 
+### Data Tables
+- list_data_tables - List data tables with pagination
+- get_data_table - Get table definition with column schema
+- list_data_table_rows - List rows with filtering, sorting, pagination
+- get_data_table_row - Get a single row by ID
+- export_data_table_rows - Export all rows as CSV
+- get_data_table_row_versions - List row version history
+- get_data_table_row_version - Get a specific version snapshot
+
 ### Device Commands & Permissions
 - displayCommands - Query available commands for the account (e.g., reboot, clear_cache)
 - permissions - Get current user/API key permissions and allowed/denied mutations
@@ -1014,6 +1990,19 @@ Raw logs return too much data for AI context windows.
 - remove_playlist_source - Remove a source from a playlist
 - reorder_playlist_sources - Reorder sources within a playlist
 
+### Data Table Management
+- create_data_table - Create a new data table with column schema
+- update_data_table - Update table definition (partial update)
+- delete_data_table - Delete a table and all its rows
+- create_data_table_row - Create a new row
+- update_data_table_row - Update a row (partial update with optimistic concurrency)
+- delete_data_table_row - Delete a row
+- batch_create_data_table_rows - Batch create rows (max 100)
+- batch_delete_data_table_rows - Batch delete rows (max 100)
+- import_data_table_rows - Import rows from CSV content
+- reorder_data_table_rows - Reorder rows
+- rollback_data_table_row - Roll back a row to a previous version
+
 ## Field Presets
 Use the build_query tool with preset parameter:
 - minimal - Just ID and name
@@ -1040,6 +2029,29 @@ or use set_auth tool at runtime.
     };
 });
 // ============================================================================
+// Prompts: System Prompts for AI Agents
+// ============================================================================
+server.prompt('system-prompt', 'Full system prompt for AI agents. Use as the system message for complete tool docs, query patterns, and domain knowledge.', { timezone: z.string().optional().describe('IANA timezone (e.g., "America/New_York"). Defaults to UTC.') }, async (args) => {
+    const prompt = generateSystemPrompt({
+        currentDateTime: new Date().toISOString(),
+        timezone: args.timezone,
+    });
+    return {
+        description: 'Revel Digital AI agent system prompt',
+        messages: [{ role: 'user', content: { type: 'text', text: prompt } }],
+    };
+});
+server.prompt('system-prompt-compact', 'Token-optimized compact system prompt for AI agents. Use when context window space is limited.', { timezone: z.string().optional().describe('IANA timezone (e.g., "America/New_York"). Defaults to UTC.') }, async (args) => {
+    const prompt = generateCompactPrompt({
+        currentDateTime: new Date().toISOString(),
+        timezone: args.timezone,
+    });
+    return {
+        description: 'Revel Digital AI agent system prompt (compact)',
+        messages: [{ role: 'user', content: { type: 'text', text: prompt } }],
+    };
+});
+// ============================================================================
 // Start Server
 // ============================================================================
 async function main() {