@reveldigital/mcp-graphql-proxy 2.0.0 → 2.2.0

package/dist/index.js

@@ -533,6 +533,82 @@ mutation SendBulkDeviceCommands($input: BulkCommandInput) {
         return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
     }
 });
+const groupMutations = [
+    {
+        toolName: 'create_device_group',
+        mutationField: 'createDeviceGroup',
+        mutationName: 'CreateDeviceGroup',
+        description: 'Create a new device group (organizational folder for player devices). Example: organize newly provisioned players into a "Lobby Displays" group.',
+    },
+    {
+        toolName: 'create_media_group',
+        mutationField: 'createMediaGroup',
+        mutationName: 'CreateMediaGroup',
+        description: 'Create a new media group (organizational folder for uploaded content files).',
+    },
+    {
+        toolName: 'create_playlist_group',
+        mutationField: 'createPlaylistGroup',
+        mutationName: 'CreatePlaylistGroup',
+        description: 'Create a new playlist group (organizational folder for playlists).',
+    },
+    {
+        toolName: 'create_schedule_group',
+        mutationField: 'createScheduleGroup',
+        mutationName: 'CreateScheduleGroup',
+        description: 'Create a new schedule group (organizational folder for schedules).',
+    },
+    {
+        toolName: 'create_template_group',
+        mutationField: 'createTemplateGroup',
+        mutationName: 'CreateTemplateGroup',
+        description: 'Create a new template group (organizational folder for screen layouts/templates).',
+    },
+];
+for (const { toolName, mutationField, mutationName, description } of groupMutations) {
+    server.tool(toolName, description, {
+        name: z.string().describe('The name of the new group'),
+        parentId: z.string().optional().describe('Optional parent group ID to nest this group under. If omitted, the group is created at the root level.'),
+    }, async (args) => {
+        try {
+            const mutation = `
+mutation ${mutationName}($input: CreateGroupInput) {
+  ${mutationField}(input: $input) {
+    success
+    group {
+      id
+      name
+      parentId
+    }
+    error
+  }
+}`;
+            const input = { name: args.name };
+            if (args.parentId !== undefined)
+                input.parentId = args.parentId;
+            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: Create Media From URL
 // ============================================================================
@@ -1077,6 +1153,562 @@ mutation ReorderPlaylistSources($input: ReorderPlaylistSourcesInput) {
     }
 });
 // ============================================================================
+// Tool: Update Template
+// ============================================================================
+server.tool('update_template', "Update a template's properties (name, group, tags, dimensions, colors, orientation, script). Only provided fields are changed. Example: AI adjusts template dimensions to optimize for a new display resolution.", {
+    templateId: z.string().describe('The template ID to update'),
+    name: z.string().optional().describe('Template name'),
+    groupId: z.string().optional().describe('Group ID to assign the template to'),
+    tags: z.string().optional().describe('Tags (newline-delimited values stored in the Description field)'),
+    script: z.string().optional().describe('Template script for custom logic'),
+    backColor: z.string().optional().describe("Background color (e.g., '#000000')"),
+    width: z.number().optional().describe('Template width in pixels'),
+    height: z.number().optional().describe('Template height in pixels'),
+    orientation: z.number().optional().describe('Display orientation (0=Landscape, 1=Portrait, 2=Landscape Reversed, 3=Portrait Reversed)'),
+}, async (args) => {
+    try {
+        const mutation = `
+mutation UpdateTemplate($input: UpdateTemplateInput) {
+  updateTemplate(input: $input) {
+    success
+    template {
+      id
+      name
+      width
+      height
+      orientation
+      modules {
+        id
+        name
+        type
+        left
+        top
+        width
+        height
+        playlistId
+        sequence
+      }
+    }
+    error
+  }
+}`;
+        const input = { templateId: args.templateId };
+        if (args.name !== undefined)
+            input.name = args.name;
+        if (args.groupId !== undefined)
+            input.groupId = args.groupId;
+        if (args.tags !== undefined)
+            input.tags = args.tags;
+        if (args.script !== undefined)
+            input.script = args.script;
+        if (args.backColor !== undefined)
+            input.backColor = args.backColor;
+        if (args.width !== undefined)
+            input.width = args.width;
+        if (args.height !== undefined)
+            input.height = args.height;
+        if (args.orientation !== undefined)
+            input.orientation = args.orientation;
+        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: Add Template Module
+// ============================================================================
+server.tool('add_template_module', "Add a new module (zone/region) to a template. Modules define rectangular areas where content from a playlist is displayed. Example: AI adds a new weather module to show real-time conditions in the corner.", {
+    templateId: z.string().describe('The template ID to add the module to'),
+    module: z.object({
+        name: z.string().optional().describe('Module/zone name'),
+        type: z.string().optional().describe("Module/zone type (e.g., 'Playlist', 'Clock', 'Weather', 'Ticker', 'Web')"),
+        left: z.number().optional().describe('Left position in pixels'),
+        top: z.number().optional().describe('Top position in pixels'),
+        width: z.number().optional().describe('Width in pixels'),
+        height: z.number().optional().describe('Height in pixels'),
+        playlistId: z.string().optional().describe('Playlist ID assigned to this module'),
+        sequence: z.number().optional().describe('Z-order/sequence for overlapping modules (higher appears in front)'),
+    }).describe('The module to add'),
+}, async (args) => {
+    try {
+        const mutation = `
+mutation AddTemplateModule($input: AddTemplateModuleInput) {
+  addTemplateModule(input: $input) {
+    success
+    module {
+      id
+      name
+      type
+      left
+      top
+      width
+      height
+      playlistId
+      sequence
+      options {
+        id
+        name
+        value
+      }
+    }
+    error
+  }
+}`;
+        const response = await graphqlClient.query(mutation, {
+            input: {
+                templateId: args.templateId,
+                module: args.module,
+            },
+        });
+        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 Template Module
+// ============================================================================
+server.tool('update_template_module', 'Update a module (zone/region) within a template. Only provided fields are changed. Example: AI repositions a module based on engagement analytics, or changes the assigned playlist.', {
+    templateId: z.string().describe('The template ID containing the module'),
+    moduleId: z.string().describe('The module ID to update'),
+    name: z.string().optional().describe('Module/zone name'),
+    type: z.string().optional().describe("Module/zone type (e.g., 'Playlist', 'Clock', 'Weather', 'Ticker', 'Web')"),
+    left: z.number().optional().describe('Left position in pixels'),
+    top: z.number().optional().describe('Top position in pixels'),
+    width: z.number().optional().describe('Width in pixels'),
+    height: z.number().optional().describe('Height in pixels'),
+    playlistId: z.string().optional().describe('Playlist ID assigned to this module'),
+    sequence: z.number().optional().describe('Z-order/sequence for overlapping modules'),
+}, async (args) => {
+    try {
+        const mutation = `
+mutation UpdateTemplateModule($input: UpdateTemplateModuleInput) {
+  updateTemplateModule(input: $input) {
+    success
+    module {
+      id
+      name
+      type
+      left
+      top
+      width
+      height
+      playlistId
+      sequence
+      options {
+        id
+        name
+        value
+      }
+    }
+    error
+  }
+}`;
+        const input = {
+            templateId: args.templateId,
+            moduleId: args.moduleId,
+        };
+        if (args.name !== undefined)
+            input.name = args.name;
+        if (args.type !== undefined)
+            input.type = args.type;
+        if (args.left !== undefined)
+            input.left = args.left;
+        if (args.top !== undefined)
+            input.top = args.top;
+        if (args.width !== undefined)
+            input.width = args.width;
+        if (args.height !== undefined)
+            input.height = args.height;
+        if (args.playlistId !== undefined)
+            input.playlistId = args.playlistId;
+        if (args.sequence !== undefined)
+            input.sequence = args.sequence;
+        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: Remove Template Module
+// ============================================================================
+server.tool('remove_template_module', 'Remove a module (zone/region) from a template by module ID. Example: AI removes an underperforming ad module to optimize content flow.', {
+    templateId: z.string().describe('The template ID containing the module'),
+    moduleId: z.string().describe('The module ID to remove'),
+}, async (args) => {
+    try {
+        const mutation = `
+mutation RemoveTemplateModule($input: RemoveTemplateModuleInput) {
+  removeTemplateModule(input: $input) {
+    success
+    module {
+      id
+      name
+      type
+    }
+    error
+  }
+}`;
+        const response = await graphqlClient.query(mutation, {
+            input: {
+                templateId: args.templateId,
+                moduleId: args.moduleId,
+            },
+        });
+        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 Template Modules
+// ============================================================================
+server.tool('reorder_template_modules', 'Reorder modules (zones) within a template by updating their sequence/z-order. Higher sequence values appear in front. Example: AI reorders modules to bring important content to the front based on viewer engagement.', {
+    templateId: z.string().describe('The template ID'),
+    moduleSequences: z.array(z.object({
+        moduleId: z.string().describe('The module ID'),
+        sequence: z.number().describe('The new sequence/z-order value'),
+    })).describe('List of module IDs with their new sequence numbers'),
+}, async (args) => {
+    try {
+        const mutation = `
+mutation ReorderTemplateModules($input: ReorderTemplateModulesInput) {
+  reorderTemplateModules(input: $input) {
+    success
+    template {
+      id
+      name
+      modules {
+        id
+        name
+        type
+        sequence
+      }
+    }
+    error
+  }
+}`;
+        const response = await graphqlClient.query(mutation, {
+            input: {
+                templateId: args.templateId,
+                moduleSequences: args.moduleSequences,
+            },
+        });
+        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 Update Template Modules
+// ============================================================================
+server.tool('batch_update_template_modules', 'Batch update multiple modules in a template at once. Each entry must include the moduleId; only provided fields are changed. Example: AI repositions all modules to create a new layout optimized for viewer attention.', {
+    templateId: z.string().describe('The template ID'),
+    modules: z.array(z.object({
+        moduleId: z.string().describe('The module ID to update'),
+        name: z.string().optional().describe('Module/zone name'),
+        type: z.string().optional().describe('Module/zone type'),
+        left: z.number().optional().describe('Left position in pixels'),
+        top: z.number().optional().describe('Top position in pixels'),
+        width: z.number().optional().describe('Width in pixels'),
+        height: z.number().optional().describe('Height in pixels'),
+        playlistId: z.string().optional().describe('Playlist ID assigned to this module'),
+        sequence: z.number().optional().describe('Z-order/sequence'),
+    })).describe('List of module updates to apply (each requires moduleId)'),
+}, async (args) => {
+    try {
+        const mutation = `
+mutation BatchUpdateTemplateModules($input: BatchUpdateTemplateModulesInput) {
+  batchUpdateTemplateModules(input: $input) {
+    totalModules
+    successCount
+    failureCount
+    results {
+      success
+      module {
+        id
+        name
+        type
+        left
+        top
+        width
+        height
+        playlistId
+        sequence
+      }
+      error
+    }
+  }
+}`;
+        const modules = args.modules.map((m) => ({ ...m, templateId: args.templateId }));
+        const response = await graphqlClient.query(mutation, {
+            input: {
+                templateId: args.templateId,
+                modules,
+            },
+        });
+        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: Set Module Options
+// ============================================================================
+server.tool('set_module_options', 'Set all configuration options for a module/zone (replaces existing options). Options are key-value pairs storing type-specific settings. Example: AI configures a weather module with location, units, and API key settings.', {
+    templateId: z.string().describe('The template ID'),
+    moduleId: z.string().describe('The module ID'),
+    options: z.array(z.object({
+        name: z.string().describe("Option name/key (e.g., 'timezone', 'location', 'url')"),
+        value: z.string().describe('Option value (string representation, parsed by option type)'),
+    })).describe('List of options to set (replaces all existing options)'),
+}, async (args) => {
+    try {
+        const mutation = `
+mutation SetModuleOptions($input: SetModuleOptionsInput) {
+  setModuleOptions(input: $input) {
+    success
+    module {
+      id
+      name
+      type
+      options {
+        id
+        name
+        value
+      }
+    }
+    error
+  }
+}`;
+        const response = await graphqlClient.query(mutation, {
+            input: {
+                templateId: args.templateId,
+                moduleId: args.moduleId,
+                options: args.options,
+            },
+        });
+        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: Upsert Module Option
+// ============================================================================
+server.tool('upsert_module_option', 'Add or update a single module/zone option (matched by name). Example: AI updates the refresh interval for a web module.', {
+    templateId: z.string().describe('The template ID'),
+    moduleId: z.string().describe('The module ID'),
+    option: z.object({
+        name: z.string().describe("Option name/key (e.g., 'timezone', 'location', 'url')"),
+        value: z.string().describe('Option value (string representation, parsed by option type)'),
+    }).describe('The option to create or update (matched by name)'),
+}, async (args) => {
+    try {
+        const mutation = `
+mutation UpsertModuleOption($input: UpsertModuleOptionInput) {
+  upsertModuleOption(input: $input) {
+    success
+    option {
+      id
+      name
+      value
+    }
+    error
+  }
+}`;
+        const response = await graphqlClient.query(mutation, {
+            input: {
+                templateId: args.templateId,
+                moduleId: args.moduleId,
+                option: args.option,
+            },
+        });
+        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: Remove Module Option
+// ============================================================================
+server.tool('remove_module_option', 'Remove a module/zone option by name. Example: AI removes an outdated configuration setting from a module.', {
+    templateId: z.string().describe('The template ID'),
+    moduleId: z.string().describe('The module ID'),
+    optionName: z.string().describe('The option name to remove'),
+}, async (args) => {
+    try {
+        const mutation = `
+mutation RemoveModuleOption($input: RemoveModuleOptionInput) {
+  removeModuleOption(input: $input) {
+    success
+    option {
+      id
+      name
+      value
+    }
+    error
+  }
+}`;
+        const response = await graphqlClient.query(mutation, {
+            input: {
+                templateId: args.templateId,
+                moduleId: args.moduleId,
+                optionName: args.optionName,
+            },
+        });
+        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 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.', {
@@ -2095,6 +2727,13 @@ Raw logs return too much data for AI context windows.
 - send_device_command - Send commands to a specific device
 - send_bulk_device_commands - Send commands to multiple devices at once
 
+### Group Management
+- create_device_group - Create a new device group (optional parentId for nesting)
+- create_media_group - Create a new media group (optional parentId for nesting)
+- create_playlist_group - Create a new playlist group (optional parentId for nesting)
+- create_schedule_group - Create a new schedule group (optional parentId for nesting)
+- create_template_group - Create a new template group (optional parentId for nesting)
+
 ### Media Management
 - create_media_from_url - Create media by downloading from a URL
 - update_media - Update media metadata (name, dates, group)
@@ -2108,6 +2747,17 @@ 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
 
+### Template Management
+- update_template - Update a template's properties (name, group, tags, dimensions, colors, orientation, script)
+- add_template_module - Add a new module (zone) to a template
+- update_template_module - Update a module within a template
+- remove_template_module - Remove a module from a template
+- reorder_template_modules - Reorder modules within a template (sequence/z-order)
+- batch_update_template_modules - Update multiple modules in a template at once
+- set_module_options - Set all options for a module (replaces existing)
+- upsert_module_option - Add or update a single module option (matched by name)
+- remove_module_option - Remove a module option by name
+
 ### Data Table Management
 - create_data_table - Create a new data table with column schema
 - update_data_table - Update table definition (partial update)