@hailer/mcp 0.0.1

package/dist/mcp/tools/workflow-template.js

@@ -0,0 +1,822 @@
+"use strict";
+/**
+ * Workflow Template Tools - Clean Architecture Implementation
+ *
+ * Document template management for Hailer workflows:
+ * - Templates define how to convert activity data into documents (PDF, etc.)
+ * - Templates can be workflow-specific or global
+ * - Preview and install capabilities for testing and deployment
+ *
+ * All 7 template management tools in one file for cohesion.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installTemplateTool = exports.previewTemplateTool = exports.deleteTemplateTool = exports.updateTemplateTool = exports.createTemplateTool = exports.getTemplateTool = exports.listTemplatesTool = void 0;
+const zod_1 = require("zod");
+const tool_registry_1 = require("../tool-registry");
+const logger_1 = require("../../lib/logger");
+const logger = (0, logger_1.createLogger)({ component: 'template-tools' });
+// ============================================================================
+// LIST TEMPLATES TOOL
+// ============================================================================
+const listTemplatesDescription = `🧪 [PLAYGROUND] List Templates - View all document templates in a workflow
+
+**What are Templates?**
+Templates are document generation templates in Hailer workflows. They define how to convert activity data into documents (PDF, etc.).
+
+**Purpose**: List all templates for a specific workflow.
+
+**Example**:
+\`\`\`javascript
+list_templates({
+  processId: "68446dc05b30685f67c6fcd4"
+})
+\`\`\`
+
+**Response includes**:
+- Template ID and name
+- File type (pdf, etc.)
+- Description
+- Configuration details
+- Owner information`;
+exports.listTemplatesTool = {
+    name: 'list_templates',
+    group: tool_registry_1.ToolGroup.PLAYGROUND,
+    description: listTemplatesDescription,
+    schema: zod_1.z.object({
+        processId: zod_1.z
+            .string()
+            .length(24)
+            .describe("Workflow/process ID to list templates from"),
+    }),
+    async execute(args, context) {
+        logger.debug('Listing templates', {
+            processId: args.processId,
+            apiKey: context.apiKey.substring(0, 8) + '...'
+        });
+        try {
+            logger.debug('Calling v3.template.list', {
+                processId: args.processId
+            });
+            const response = await context.hailer.request('v3.template.list', [args.processId]);
+            logger.debug('Templates list successful', {
+                count: Array.isArray(response) ? response.length : 0
+            });
+            const templates = Array.isArray(response) ? response : [];
+            let responseText = `📋 **Document Templates**\n\n`;
+            responseText += `**Workflow ID:** \`${args.processId}\`\n`;
+            responseText += `**Total Templates:** ${templates.length}\n\n`;
+            if (templates.length === 0) {
+                responseText += `No templates found for this workflow.\n\n`;
+                responseText += `💡 Use \`create_template\` to create a new template.`;
+            }
+            else {
+                templates.forEach((template, index) => {
+                    responseText += `**${index + 1}. ${template.description || 'Unnamed Template'}**\n`;
+                    responseText += `  ID: \`${template._id}\`\n`;
+                    responseText += `  Type: ${template.fileType || 'Unknown'}\n`;
+                    if (template.global)
+                        responseText += `  Global: Yes\n`;
+                    responseText += `\n`;
+                });
+                responseText += `💡 **Next Steps:**\n`;
+                responseText += `- Use \`get_template\` to view template details\n`;
+                responseText += `- Use \`preview_template\` to test with activity data\n`;
+                responseText += `- Use \`update_template\` to modify templates\n`;
+                responseText += `- Use \`delete_template\` to remove templates`;
+            }
+            return {
+                content: [{
+                        type: "text",
+                        text: responseText,
+                    }],
+            };
+        }
+        catch (error) {
+            logger.error("Error listing templates", error);
+            let errorMessage = 'Unknown error occurred';
+            if (error instanceof Error) {
+                errorMessage = error.message;
+            }
+            else if (typeof error === 'object' && error !== null) {
+                try {
+                    errorMessage = JSON.stringify(error, null, 2);
+                }
+                catch {
+                    errorMessage = String(error);
+                }
+            }
+            else {
+                errorMessage = String(error);
+            }
+            return {
+                content: [{
+                        type: "text",
+                        text: `❌ **Error listing templates**\n\n**Error:** ${errorMessage}\n\n**Workflow ID:** \`${args.processId}\``,
+                    }],
+            };
+        }
+    }
+};
+// ============================================================================
+// GET TEMPLATE TOOL
+// ============================================================================
+const getTemplateDescription = `🧪 [PLAYGROUND] Get Template - View document template details
+
+**Purpose**: Retrieve full details of a specific document template.
+
+**Example**:
+\`\`\`javascript
+get_template({
+  templateId: "68446dc05b30685f67c6fcd4"
+})
+\`\`\`
+
+**Response includes**:
+- Template ID and description
+- File type (pdf, etc.)
+- Template content/structure
+- Configuration
+- Owner and workflow information`;
+exports.getTemplateTool = {
+    name: 'get_template',
+    group: tool_registry_1.ToolGroup.PLAYGROUND,
+    description: getTemplateDescription,
+    schema: zod_1.z.object({
+        templateId: zod_1.z
+            .string()
+            .length(24)
+            .describe("Template ID to retrieve"),
+    }),
+    async execute(args, context) {
+        logger.debug('Getting template', {
+            templateId: args.templateId,
+            apiKey: context.apiKey.substring(0, 8) + '...'
+        });
+        try {
+            logger.debug('Calling v3.template.get', {
+                templateId: args.templateId
+            });
+            const template = await context.hailer.request('v3.template.get', [args.templateId]);
+            logger.debug('Template retrieval successful');
+            let responseText = `📄 **Document Template Details**\n\n`;
+            responseText += `**Description:** ${template.description || 'Unnamed'}\n`;
+            responseText += `**ID:** \`${template._id}\`\n`;
+            responseText += `**Type:** ${template.fileType || 'Unknown'}\n`;
+            responseText += `**Global:** ${template.global ? 'Yes' : 'No'}\n`;
+            if (template.processId)
+                responseText += `**Workflow ID:** \`${template.processId}\`\n`;
+            if (template.cid)
+                responseText += `**Company ID:** \`${template.cid}\`\n`;
+            responseText += `\n`;
+            if (template.configuration) {
+                responseText += `**Configuration:**\n\`\`\`json\n${JSON.stringify(template.configuration, null, 2)}\n\`\`\`\n\n`;
+            }
+            if (template.content) {
+                responseText += `**Content Preview:**\n\`\`\`\n${template.content.substring(0, 500)}${template.content.length > 500 ? '...' : ''}\n\`\`\`\n\n`;
+            }
+            responseText += `💡 **Next Steps:**\n`;
+            responseText += `- Use \`preview_template\` to test with activity data\n`;
+            responseText += `- Use \`update_template\` to modify this template\n`;
+            responseText += `- Use \`delete_template\` to remove this template`;
+            return {
+                content: [{
+                        type: "text",
+                        text: responseText,
+                    }],
+            };
+        }
+        catch (error) {
+            logger.error("Error getting template", error);
+            let errorMessage = 'Unknown error occurred';
+            if (error instanceof Error) {
+                errorMessage = error.message;
+            }
+            else if (typeof error === 'object' && error !== null) {
+                try {
+                    errorMessage = JSON.stringify(error, null, 2);
+                }
+                catch {
+                    errorMessage = String(error);
+                }
+            }
+            else {
+                errorMessage = String(error);
+            }
+            if (errorMessage.toLowerCase().includes('not found')) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `❌ **Template Not Found**\n\nThe specified template doesn't exist.\n\n**Template ID:** \`${args.templateId}\`\n\n💡 Use \`list_templates\` to see available templates.`,
+                        }],
+                };
+            }
+            return {
+                content: [{
+                        type: "text",
+                        text: `❌ **Error getting template**\n\n**Error:** ${errorMessage}\n\n**Template ID:** \`${args.templateId}\``,
+                    }],
+            };
+        }
+    }
+};
+// ============================================================================
+// CREATE TEMPLATE TOOL
+// ============================================================================
+const createTemplateDescription = `🧪 [PLAYGROUND] Create Template - Create new document template
+
+**Purpose**: Create a new document generation template for a workflow.
+
+**Example**:
+\`\`\`javascript
+create_template({
+  processId: "68446dc05b30685f67c6fcd4",
+  description: "Invoice Template",
+  fileType: "pdf",
+  content: "<template content here>",
+  global: false,
+  configuration: {
+    // Optional configuration
+  }
+})
+\`\`\`
+
+**Parameters**:
+- \`processId\` (required) - Workflow ID to attach template to
+- \`description\` (optional) - Template description/name
+- \`fileType\` (required) - File type (e.g., "pdf")
+- \`content\` (required) - Template content/structure
+- \`global\` (optional) - Whether template is globally accessible
+- \`configuration\` (optional) - Additional configuration
+- \`ownerCids\` (optional) - Owner company IDs
+- \`cid\` (optional) - Company ID`;
+exports.createTemplateTool = {
+    name: 'create_template',
+    group: tool_registry_1.ToolGroup.PLAYGROUND,
+    description: createTemplateDescription,
+    schema: zod_1.z.object({
+        processId: zod_1.z
+            .string()
+            .length(24)
+            .describe("Workflow/process ID to attach template to"),
+        description: zod_1.z
+            .string()
+            .optional()
+            .describe("Template description/name"),
+        fileType: zod_1.z
+            .string()
+            .describe("File type (e.g., 'pdf')"),
+        content: zod_1.z
+            .string()
+            .describe("Template content/structure"),
+        global: zod_1.z
+            .coerce.boolean()
+            .optional()
+            .describe("Whether template is globally accessible"),
+        configuration: zod_1.z.preprocess((val) => {
+            if (typeof val === 'string') {
+                try {
+                    return JSON.parse(val);
+                }
+                catch {
+                    return val;
+                }
+            }
+            return val;
+        }, zod_1.z.record(zod_1.z.any()).optional()).describe("Additional template configuration"),
+        ownerCids: zod_1.z.preprocess((val) => {
+            if (typeof val === 'string') {
+                try {
+                    return JSON.parse(val);
+                }
+                catch {
+                    return val;
+                }
+            }
+            return val;
+        }, zod_1.z.array(zod_1.z.string()).optional()).describe("Owner company IDs"),
+        cid: zod_1.z
+            .string()
+            .length(24)
+            .optional()
+            .describe("Company ID"),
+    }),
+    async execute(args, context) {
+        logger.debug('Creating template', {
+            processId: args.processId,
+            apiKey: context.apiKey.substring(0, 8) + '...'
+        });
+        try {
+            const templateData = {
+                processId: args.processId,
+                fileType: args.fileType,
+                content: args.content,
+            };
+            if (args.description)
+                templateData.description = args.description;
+            if (args.global !== undefined)
+                templateData.global = args.global;
+            if (args.configuration)
+                templateData.configuration = args.configuration;
+            if (args.ownerCids)
+                templateData.ownerCids = args.ownerCids;
+            if (args.cid)
+                templateData.cid = args.cid;
+            logger.debug('Calling v3.template.create', templateData);
+            const template = await context.hailer.request('v3.template.create', [templateData]);
+            logger.debug('Template creation successful', {
+                templateId: template._id
+            });
+            let responseText = `✅ **Template Created Successfully**\n\n`;
+            responseText += `**Template ID:** \`${template._id}\`\n`;
+            responseText += `**Description:** ${template.description || 'Unnamed'}\n`;
+            responseText += `**Type:** ${template.fileType}\n`;
+            responseText += `**Workflow ID:** \`${template.processId}\`\n\n`;
+            responseText += `💡 **Next Steps:**\n`;
+            responseText += `- Use \`preview_template\` to test with activity data\n`;
+            responseText += `- Use \`get_template\` to view full details\n`;
+            responseText += `- Use \`update_template\` to modify if needed`;
+            return {
+                content: [{
+                        type: "text",
+                        text: responseText,
+                    }],
+            };
+        }
+        catch (error) {
+            logger.error("Error creating template", error);
+            let errorMessage = 'Unknown error occurred';
+            if (error instanceof Error) {
+                errorMessage = error.message;
+            }
+            else if (typeof error === 'object' && error !== null) {
+                try {
+                    errorMessage = JSON.stringify(error, null, 2);
+                }
+                catch {
+                    errorMessage = String(error);
+                }
+            }
+            else {
+                errorMessage = String(error);
+            }
+            if (errorMessage.toLowerCase().includes('permission')) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `❌ **Permission Denied**\n\nYou don't have permission to create templates in this workflow.\n\n**Error:** ${errorMessage}`,
+                        }],
+                };
+            }
+            return {
+                content: [{
+                        type: "text",
+                        text: `❌ **Error creating template**\n\n**Error:** ${errorMessage}\n\n**Common Issues:**\n- Invalid workflow ID\n- Missing required fields\n- Permission denied`,
+                    }],
+            };
+        }
+    }
+};
+// ============================================================================
+// UPDATE TEMPLATE TOOL
+// ============================================================================
+const updateTemplateDescription = `🧪 [PLAYGROUND] Update Template - Modify document template
+
+**Purpose**: Update an existing document template's properties.
+
+**Example**:
+\`\`\`javascript
+update_template({
+  templateId: "68446dc05b30685f67c6fcd4",
+  description: "Updated Invoice Template",
+  content: "<updated template content>",
+  fileType: "pdf"
+})
+\`\`\`
+
+**Updatable Properties**:
+- \`description\` - Template description/name
+- \`content\` - Template content/structure
+- \`fileType\` - File type
+- \`global\` - Global accessibility
+- \`configuration\` - Configuration object
+- \`ownerCids\` - Owner company IDs
+- \`processId\` - Workflow ID
+- \`cid\` - Company ID
+
+**Note**: Only specified properties are updated.`;
+exports.updateTemplateTool = {
+    name: 'update_template',
+    group: tool_registry_1.ToolGroup.PLAYGROUND,
+    description: updateTemplateDescription,
+    schema: zod_1.z.object({
+        templateId: zod_1.z
+            .string()
+            .length(24)
+            .describe("Template ID to update"),
+        description: zod_1.z
+            .string()
+            .optional()
+            .describe("New template description"),
+        fileType: zod_1.z
+            .string()
+            .optional()
+            .describe("New file type"),
+        content: zod_1.z
+            .string()
+            .optional()
+            .describe("New template content"),
+        global: zod_1.z
+            .boolean()
+            .optional()
+            .describe("New global accessibility setting"),
+        configuration: zod_1.z
+            .record(zod_1.z.any())
+            .optional()
+            .describe("New configuration"),
+        ownerCids: zod_1.z
+            .array(zod_1.z.string())
+            .optional()
+            .describe("New owner company IDs"),
+        processId: zod_1.z
+            .string()
+            .length(24)
+            .optional()
+            .describe("New workflow/process ID"),
+        cid: zod_1.z
+            .string()
+            .length(24)
+            .optional()
+            .describe("New company ID"),
+    }),
+    async execute(args, context) {
+        logger.debug('Updating template', {
+            templateId: args.templateId,
+            apiKey: context.apiKey.substring(0, 8) + '...'
+        });
+        try {
+            const updateData = {
+                templateId: args.templateId,
+            };
+            if (args.description !== undefined)
+                updateData.description = args.description;
+            if (args.fileType !== undefined)
+                updateData.fileType = args.fileType;
+            if (args.content !== undefined)
+                updateData.content = args.content;
+            if (args.global !== undefined)
+                updateData.global = args.global;
+            if (args.configuration !== undefined)
+                updateData.configuration = args.configuration;
+            if (args.ownerCids !== undefined)
+                updateData.ownerCids = args.ownerCids;
+            if (args.processId !== undefined)
+                updateData.processId = args.processId;
+            if (args.cid !== undefined)
+                updateData.cid = args.cid;
+            logger.debug('Calling v3.template.update', updateData);
+            const template = await context.hailer.request('v3.template.update', [updateData]);
+            logger.debug('Template update successful');
+            let responseText = `✅ **Template Updated Successfully**\n\n`;
+            responseText += `**Template ID:** \`${template._id}\`\n`;
+            responseText += `**Description:** ${template.description || 'Unnamed'}\n`;
+            responseText += `**Type:** ${template.fileType}\n`;
+            if (template.processId)
+                responseText += `**Workflow ID:** \`${template.processId}\`\n`;
+            responseText += `\n💡 Use \`get_template\` to view updated details or \`preview_template\` to test.`;
+            return {
+                content: [{
+                        type: "text",
+                        text: responseText,
+                    }],
+            };
+        }
+        catch (error) {
+            logger.error("Error updating template", error);
+            let errorMessage = 'Unknown error occurred';
+            if (error instanceof Error) {
+                errorMessage = error.message;
+            }
+            else if (typeof error === 'object' && error !== null) {
+                try {
+                    errorMessage = JSON.stringify(error, null, 2);
+                }
+                catch {
+                    errorMessage = String(error);
+                }
+            }
+            else {
+                errorMessage = String(error);
+            }
+            if (errorMessage.toLowerCase().includes('not found')) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `❌ **Template Not Found**\n\nThe specified template doesn't exist.\n\n**Template ID:** \`${args.templateId}\`\n\n💡 Use \`list_templates\` to see available templates.`,
+                        }],
+                };
+            }
+            if (errorMessage.toLowerCase().includes('permission')) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `❌ **Permission Denied**\n\nYou don't have permission to update this template.\n\n**Error:** ${errorMessage}`,
+                        }],
+                };
+            }
+            return {
+                content: [{
+                        type: "text",
+                        text: `❌ **Error updating template**\n\n**Error:** ${errorMessage}`,
+                    }],
+            };
+        }
+    }
+};
+// ============================================================================
+// DELETE TEMPLATE TOOL
+// ============================================================================
+const deleteTemplateDescription = `🧪 [PLAYGROUND] Delete Template - Remove document template permanently
+
+⚠️ **MANDATORY: GATHER COMPLETE CONTEXT BEFORE CALLING THIS TOOL**
+**BEFORE calling this tool, you are REQUIRED to:**
+1. Fetch template details with \`get_template\` or \`list_templates\` to get:
+   - Template name/description and ID
+   - Workflow ID and name
+   - Template type (pdf, etc.)
+   - Whether template is global
+2. Show comprehensive confirmation message including:
+   - Template ID and name/description
+   - Workflow ID and name
+   - What will be deleted (definition, content, configuration)
+   - Clear irreversibility warning
+3. Wait for explicit user confirmation
+**FAILURE TO GATHER AND SHOW THIS CONTEXT IS AN ERROR**
+
+**Example**:
+\`\`\`javascript
+delete_template({
+  templateId: "68446dc05b30685f67c6fcd4"
+})
+\`\`\`
+
+**What gets deleted**:
+- Template definition
+- Template content
+- Template configuration
+
+**Note**: This operation cannot be undone.`;
+exports.deleteTemplateTool = {
+    name: 'delete_template',
+    group: tool_registry_1.ToolGroup.NUCLEAR,
+    description: deleteTemplateDescription,
+    schema: zod_1.z.object({
+        templateId: zod_1.z
+            .string()
+            .length(24)
+            .describe("Template ID to delete"),
+    }),
+    async execute(args, context) {
+        logger.debug('Deleting template', {
+            templateId: args.templateId,
+            apiKey: context.apiKey.substring(0, 8) + '...'
+        });
+        try {
+            logger.debug('Calling v3.template.delete', {
+                templateId: args.templateId
+            });
+            await context.hailer.request('v3.template.delete', [args.templateId]);
+            logger.debug('Template deletion successful');
+            let responseText = `✅ **Template Deleted Successfully**\n\n`;
+            responseText += `**Template ID:** \`${args.templateId}\`\n\n`;
+            responseText += `⚠️ **The template has been permanently deleted.**\n\n`;
+            responseText += `💡 Use \`list_templates\` to see remaining templates.`;
+            return {
+                content: [{
+                        type: "text",
+                        text: responseText,
+                    }],
+            };
+        }
+        catch (error) {
+            logger.error("Error deleting template", error);
+            let errorMessage = 'Unknown error occurred';
+            if (error instanceof Error) {
+                errorMessage = error.message;
+            }
+            else if (typeof error === 'object' && error !== null) {
+                try {
+                    errorMessage = JSON.stringify(error, null, 2);
+                }
+                catch {
+                    errorMessage = String(error);
+                }
+            }
+            else {
+                errorMessage = String(error);
+            }
+            if (errorMessage.toLowerCase().includes('not found')) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `❌ **Template Not Found**\n\nThe specified template doesn't exist or has already been deleted.\n\n**Template ID:** \`${args.templateId}\``,
+                        }],
+                };
+            }
+            if (errorMessage.toLowerCase().includes('permission')) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `❌ **Permission Denied**\n\nYou don't have permission to delete this template.\n\n**Error:** ${errorMessage}`,
+                        }],
+                };
+            }
+            return {
+                content: [{
+                        type: "text",
+                        text: `❌ **Error deleting template**\n\n**Error:** ${errorMessage}`,
+                    }],
+            };
+        }
+    }
+};
+// ============================================================================
+// PREVIEW TEMPLATE TOOL
+// ============================================================================
+const previewTemplateDescription = `🧪 [PLAYGROUND] Preview Template - Test template with activity data
+
+**Purpose**: Generate a preview of a template using actual activity data.
+
+**Example**:
+\`\`\`javascript
+preview_template({
+  templateId: "68446dc05b30685f67c6fcd4",
+  activityId: "68446dc05b30685f67c6fce1"
+})
+\`\`\`
+
+**Use Cases**:
+- Test template before deploying
+- Verify template logic with real data
+- Debug template issues
+- Preview document output
+
+**Response**: Preview data showing how the template renders with the activity's data.`;
+exports.previewTemplateTool = {
+    name: 'preview_template',
+    group: tool_registry_1.ToolGroup.PLAYGROUND,
+    description: previewTemplateDescription,
+    schema: zod_1.z.object({
+        templateId: zod_1.z
+            .string()
+            .length(24)
+            .describe("Template ID to preview"),
+        activityId: zod_1.z
+            .string()
+            .length(24)
+            .describe("Activity ID to use for preview data"),
+    }),
+    async execute(args, context) {
+        logger.debug('Previewing template', {
+            templateId: args.templateId,
+            activityId: args.activityId,
+            apiKey: context.apiKey.substring(0, 8) + '...'
+        });
+        try {
+            logger.debug('Calling v3.template.preview', {
+                templateId: args.templateId,
+                activityId: args.activityId
+            });
+            const previewData = await context.hailer.request('v3.template.preview', [{
+                    templateId: args.templateId,
+                    activityId: args.activityId
+                }]);
+            logger.debug('Template preview successful');
+            let responseText = `🔍 **Template Preview**\n\n`;
+            responseText += `**Template ID:** \`${args.templateId}\`\n`;
+            responseText += `**Activity ID:** \`${args.activityId}\`\n\n`;
+            responseText += `**Preview Data:**\n\`\`\`json\n${JSON.stringify(previewData, null, 2)}\n\`\`\`\n\n`;
+            responseText += `💡 **Next Steps:**\n`;
+            responseText += `- Use \`update_template\` to modify template if needed\n`;
+            responseText += `- Test with different activities to verify template logic`;
+            return {
+                content: [{
+                        type: "text",
+                        text: responseText,
+                    }],
+            };
+        }
+        catch (error) {
+            logger.error("Error previewing template", error);
+            let errorMessage = 'Unknown error occurred';
+            if (error instanceof Error) {
+                errorMessage = error.message;
+            }
+            else if (typeof error === 'object' && error !== null) {
+                try {
+                    errorMessage = JSON.stringify(error, null, 2);
+                }
+                catch {
+                    errorMessage = String(error);
+                }
+            }
+            else {
+                errorMessage = String(error);
+            }
+            if (errorMessage.toLowerCase().includes('not found')) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `❌ **Template or Activity Not Found**\n\nThe specified template or activity doesn't exist.\n\n**Template ID:** \`${args.templateId}\`\n**Activity ID:** \`${args.activityId}\`\n\n💡 Verify both IDs are correct.`,
+                        }],
+                };
+            }
+            return {
+                content: [{
+                        type: "text",
+                        text: `❌ **Error previewing template**\n\n**Error:** ${errorMessage}\n\n**Template ID:** \`${args.templateId}\`\n**Activity ID:** \`${args.activityId}\``,
+                    }],
+            };
+        }
+    }
+};
+// ============================================================================
+// INSTALL TEMPLATE TOOL
+// ============================================================================
+const installTemplateDescription = `🧪 [PLAYGROUND] Install Template - Register template in workflow
+
+**Purpose**: Install/register a template to make it available in the workflow UI.
+
+**Example**:
+\`\`\`javascript
+install_template({
+  templateId: "6915a49e43a99588c70b38f0"
+})
+\`\`\`
+
+**When to use:**
+- After creating a template with \`create_template\`
+- To make a template appear in the workflow settings UI
+- To activate a template for use in the workflow
+
+**⚠️ IMPORTANT**: Templates must be installed to appear in the workflow UI dropdown.`;
+exports.installTemplateTool = {
+    name: 'install_template',
+    group: tool_registry_1.ToolGroup.PLAYGROUND,
+    description: installTemplateDescription,
+    schema: zod_1.z.object({
+        templateId: zod_1.z
+            .string()
+            .length(24)
+            .describe("Template ID to install"),
+    }),
+    async execute(args, context) {
+        logger.debug('Installing template', {
+            templateId: args.templateId,
+            apiKey: context.apiKey.substring(0, 8) + '...'
+        });
+        try {
+            logger.debug('Calling process.install_template', {
+                templateId: args.templateId
+            });
+            await context.hailer.request('process.install_template', [args.templateId]);
+            logger.debug('Template installation successful');
+            let responseText = `✅ **Template Installed Successfully**\n\n`;
+            responseText += `**Template ID:** \`${args.templateId}\`\n\n`;
+            responseText += `💡 **Next Steps:**\n`;
+            responseText += `- Refresh your browser to see the template in the workflow UI\n`;
+            responseText += `- Use the template dropdown in workflow settings to configure it\n`;
+            responseText += `- Generate PDFs from activities using this template`;
+            return {
+                content: [{
+                        type: "text",
+                        text: responseText,
+                    }],
+            };
+        }
+        catch (error) {
+            logger.error("Error installing template", error);
+            let errorMessage = 'Unknown error occurred';
+            if (error instanceof Error) {
+                errorMessage = error.message;
+            }
+            else if (typeof error === 'object' && error !== null) {
+                try {
+                    errorMessage = JSON.stringify(error, null, 2);
+                }
+                catch {
+                    errorMessage = String(error);
+                }
+            }
+            else {
+                errorMessage = String(error);
+            }
+            return {
+                content: [{
+                        type: "text",
+                        text: `❌ **Error installing template**\n\n**Error:** ${errorMessage}\n\n**Template ID:** \`${args.templateId}\`\n\n**Debug:** Check if the template exists and is accessible in the current workspace.`,
+                    }],
+            };
+        }
+    }
+};
+//# sourceMappingURL=workflow-template.js.map