@reveldigital/mcp-graphql-proxy 2.1.0 → 2.2.0

package/dist/core/system-prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system-prompt.d.ts","sourceRoot":"","sources":["../../src/core/system-prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,kBAAkB;IACjC,2CAA2C;IAC3C,eAAe,EAAE,MAAM,CAAC;IACxB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CA+gBxE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAyHzE"}
+{"version":3,"file":"system-prompt.d.ts","sourceRoot":"","sources":["../../src/core/system-prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,kBAAkB;IACjC,2CAA2C;IAC3C,eAAe,EAAE,MAAM,CAAC;IACxB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CA8hBxE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CA0HzE"}

package/dist/core/system-prompt.js

@@ -247,6 +247,21 @@ Organizational folders for each resource type. All five tools take the same para
 | \`remove_playlist_source\` | Remove a source from a playlist. Params: \`playlistId\`, \`sourceId\`. |
 | \`reorder_playlist_sources\` | Reorder sources within a playlist. Params: \`playlistId\`, \`sourceIds\` (ordered array). |
 
+### Template Management
+Templates are screen layouts composed of **modules** (also called **zones** or **regions**) — rectangular areas that display content from a playlist. The terms "module" and "zone" are interchangeable. Module positions (\`left\`, \`top\`, \`width\`, \`height\`) are in pixels; \`sequence\` is the z-order (higher appears in front). Each module can carry **options** (key-value pairs) for type-specific settings (e.g., \`timezone\` for a Clock zone, \`location\` for a Weather zone).
+
+| Tool | Description |
+|------|-------------|
+| \`update_template\` | Update a template's properties. Params: \`templateId\`, plus any of \`name?\`, \`groupId?\`, \`tags?\` (newline-delimited), \`script?\`, \`backColor?\` (e.g. \`#000000\`), \`width?\`, \`height?\`, \`orientation?\` (0=Landscape, 1=Portrait, 2=Landscape Reversed, 3=Portrait Reversed). |
+| \`add_template_module\` | Add a new module/zone to a template. Params: \`templateId\`, \`module\` (object: \`name?\`, \`type?\`, \`left?\`, \`top?\`, \`width?\`, \`height?\`, \`playlistId?\`, \`sequence?\`). |
+| \`update_template_module\` | Update a module within a template (partial). Params: \`templateId\`, \`moduleId\`, plus any of \`name?\`, \`type?\`, \`left?\`, \`top?\`, \`width?\`, \`height?\`, \`playlistId?\`, \`sequence?\`. |
+| \`remove_template_module\` | Remove a module from a template. Params: \`templateId\`, \`moduleId\`. |
+| \`reorder_template_modules\` | Reorder modules by z-order. Params: \`templateId\`, \`moduleSequences\` (array of \`{moduleId, sequence}\`). |
+| \`batch_update_template_modules\` | Update multiple modules at once. Params: \`templateId\`, \`modules\` (array of \`{moduleId, ...partial fields}\`). Returns per-module success/failure counts. |
+| \`set_module_options\` | Replace all options for a module. Params: \`templateId\`, \`moduleId\`, \`options\` (array of \`{name, value}\`). |
+| \`upsert_module_option\` | Add or update a single option (matched by name). Params: \`templateId\`, \`moduleId\`, \`option\` (\`{name, value}\`). |
+| \`remove_module_option\` | Remove an option by name. Params: \`templateId\`, \`moduleId\`, \`optionName\`. |
+
 ### Data Table Management
 | Tool | Description |
 |------|-------------|
@@ -615,6 +630,7 @@ Types: \`device\`, \`template\`, \`schedule\`, \`playlist\`, \`media\`, \`device
 **Media**: \`create_media_from_url\`, \`update_media\`, \`approve_media\` (id), \`decline_media\` (id, reason?) — both reversible — \`delete_media\` (currently no-op)
 **Playlists**: \`add_playlist_source\`, \`update_playlist_source\`, \`remove_playlist_source\`, \`reorder_playlist_sources\`
 Playlist sources support optional \`conditions\` (array) to control when/where they play — e.g., \`DATE_RANGE\`, \`TIME_RANGE\`, \`DAYS_OF_WEEK\`, \`SPECIFIC_DEVICE\`, \`DEVICE_BY_GROUP\`. Each condition has \`type\`, optional \`operator\` (AND/OR/AND_NOT/OR_NOT), and \`value1\`–\`value4\`.
+**Templates**: \`update_template\` (name, group, tags, dimensions, backColor, orientation, script), \`add_template_module\`, \`update_template_module\`, \`remove_template_module\`, \`reorder_template_modules\`, \`batch_update_template_modules\`, \`set_module_options\`, \`upsert_module_option\`, \`remove_module_option\`. Modules (aka zones) are rectangular content areas: \`left\`/\`top\`/\`width\`/\`height\` in px, \`sequence\` = z-order, \`playlistId\` = content; options are \`{name, value}\` key-value settings.
 **Data Tables**: \`create_data_table\` (column types: STRING, NUMBER, BOOLEAN, DATE, SELECT, MEDIA, URL, RICHTEXT, TIME, HIDDEN), \`update_data_table\`, \`delete_data_table\`, \`create_data_table_row\`, \`update_data_table_row\` (supports \`eTag\` for optimistic concurrency), \`delete_data_table_row\`, \`batch_create_data_table_rows\`, \`batch_delete_data_table_rows\`, \`import_data_table_rows\` (CSV), \`reorder_data_table_rows\`, \`rollback_data_table_row\`. Row mutations return \`structuredValidationErrors\` on validation failure.
 
 **Workflow**: Check permissions → describe action to user → get confirmation → execute → report result

package/dist/core/system-prompt.js.map

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

package/dist/index.js

@@ -1153,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.', {
@@ -2191,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)