@hailer/mcp 0.0.4 → 0.0.5

package/dist/mcp/tools/app.js

@@ -43,7 +43,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.publishHailerAppTool = exports.scaffoldHailerAppTool = exports.removeAppMemberTool = exports.addAppMemberTool = exports.removeAppTool = exports.updateAppTool = exports.listAppsTool = exports.createAppTool = void 0;
+exports.getProductManifestTool = exports.getProductTool = exports.publishTemplateTool = exports.getTemplateTool = exports.installTemplateTool = exports.createTemplateTool = exports.listTemplatesTool = exports.publishHailerAppTool = exports.scaffoldHailerAppTool = exports.removeAppMemberTool = exports.addAppMemberTool = exports.removeAppTool = exports.updateAppTool = exports.listAppsTool = exports.createAppTool = void 0;
 const zod_1 = require("zod");
 const tool_registry_1 = require("../tool-registry");
 const workspace_cache_1 = require("../workspace-cache");
@@ -1485,4 +1485,1000 @@ exports.publishHailerAppTool = {
         }
     }
 };
+// ============================================================================
+// LIST TEMPLATES TOOL (MARKETPLACE)
+// ============================================================================
+const listTemplatesDescription = `🏪 [PLAYGROUND] List Templates - View marketplace templates available
+
+**What it does**:
+Lists all workflow templates available in the Hailer marketplace.
+
+**Example**:
+\`\`\`javascript
+list_templates()
+\`\`\`
+
+**Shows**:
+- Template name and description
+- Template ID
+- Creator info
+- Installation status
+
+**Use Cases**:
+- Discover available templates
+- Find template IDs for installation
+- Browse marketplace offerings
+
+**Note**: Products created with \`create_template\` are workspace-specific and won't appear here until published to the public marketplace.`;
+exports.listTemplatesTool = {
+    name: 'list_templates',
+    group: tool_registry_1.ToolGroup.PLAYGROUND,
+    description: listTemplatesDescription,
+    schema: zod_1.z.object({
+        workspaceId: zod_1.z
+            .string()
+            .optional()
+            .describe("Optional workspace ID - defaults to current workspace"),
+        publicOnly: zod_1.z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe("If true, show only public marketplace templates. If false (default), show private/workspace templates."),
+    }),
+    async execute(args, context) {
+        const showPublic = args.publicOnly ?? false;
+        logger.debug('Listing marketplace templates', {
+            workspaceId: args.workspaceId,
+            publicOnly: showPublic,
+            apiKey: context.apiKey.substring(0, 8) + '...'
+        });
+        try {
+            if (!context.workspaceCache) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: "❌ Workspace cache not available",
+                        }],
+                };
+            }
+            const workspaceId = args.workspaceId
+                ? (0, workspace_cache_1.resolveWorkspaceId)(context.workspaceCache, args.workspaceId)
+                : context.workspaceCache.currentWorkspace._id;
+            logger.debug('Calling v3.product.list', { workspaceId, public: showPublic });
+            // v3.product.list endpoint with public flag
+            const result = await context.hailer.request('v3.product.list', [
+                { cid: workspaceId, public: showPublic },
+                {} // pagination options
+            ]);
+            logger.debug('Template list response', {
+                result: JSON.stringify(result)
+            });
+            const templateType = showPublic ? 'Public Marketplace' : 'Private/Workspace';
+            let responseText = `✅ **${templateType} Templates**\n\n`;
+            responseText += `**Workspace:** ${workspaceId}\n`;
+            responseText += `**Filter:** ${showPublic ? 'Public only' : 'Private/workspace'}\n\n`;
+            // Handle response: {products: [], totalCount: 0}
+            const products = result?.products || [];
+            const totalCount = result?.totalCount || 0;
+            if (products.length === 0) {
+                responseText += `**No ${showPublic ? 'public' : 'private'} templates found.**\n\n`;
+                if (showPublic) {
+                    responseText += `💡 Try \`list_templates()\` without \`publicOnly: true\` to see private workspace templates.\n`;
+                }
+                else {
+                    responseText += `💡 Use \`create_template\` to create a new template.\n`;
+                }
+                return {
+                    content: [{
+                            type: "text",
+                            text: responseText,
+                        }],
+                };
+            }
+            const templates = products;
+            responseText += `**Total Templates:** ${templates.length}\n\n`;
+            templates.forEach((template, index) => {
+                responseText += `### ${index + 1}. ${template.name || 'Unnamed Template'}\n`;
+                responseText += `- **ID:** \`${template._id || template.id || 'N/A'}\`\n`;
+                if (template.description) {
+                    responseText += `- **Description:** ${template.description}\n`;
+                }
+                if (template.creator) {
+                    responseText += `- **Creator:** ${template.creator}\n`;
+                }
+                if (template.version) {
+                    responseText += `- **Version:** ${template.version}\n`;
+                }
+                if (template.icon) {
+                    responseText += `- **Icon:** \`${template.icon}\`\n`;
+                }
+                if (template.images && template.images.length > 0) {
+                    responseText += `- **Images:** ${template.images.map((img) => `\`${img}\``).join(', ')}\n`;
+                }
+                responseText += `\n`;
+            });
+            responseText += `💡 **Next Steps:**\n`;
+            responseText += `- Use \`install_template\` to install a template\n`;
+            responseText += `- Use \`get_template\` to see template details`;
+            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**Common Issues:**\n- API endpoint not available\n- Permission issues`,
+                    }],
+            };
+        }
+    }
+};
+// ============================================================================
+// CREATE TEMPLATE TOOL (MARKETPLACE)
+// ============================================================================
+const createTemplateDescription = `🏪 [PLAYGROUND] Create Template - Add template to marketplace
+
+**What it does**:
+Creates a new workflow template in the Hailer marketplace.
+
+**Example**:
+\`\`\`javascript
+create_template({
+  name: 'Project Management',
+  description: 'Template for managing projects',
+  workflowId: '<source-workflow-id>'
+})
+\`\`\`
+
+**Parameters**:
+- \`name\` (required) - Template name
+- \`description\` (optional) - Template description
+- \`workflowId\` (optional) - Source workflow to create template from
+
+**Requirements**:
+- User must be workspace administrator
+
+**Tips**:
+- Create template from existing workflow
+- Use descriptive names for discoverability`;
+exports.createTemplateTool = {
+    name: 'create_template',
+    group: tool_registry_1.ToolGroup.PLAYGROUND,
+    description: createTemplateDescription,
+    schema: zod_1.z.object({
+        name: zod_1.z
+            .string()
+            .min(1)
+            .describe("Template name (required)"),
+        description: zod_1.z
+            .string()
+            .optional()
+            .describe("Template description"),
+        workflowId: zod_1.z
+            .string()
+            .optional()
+            .describe("Source workflow ID to create template from"),
+    }),
+    async execute(args, context) {
+        logger.debug('Creating marketplace template', {
+            name: args.name,
+            hasWorkflowId: !!args.workflowId,
+            apiKey: context.apiKey.substring(0, 8) + '...'
+        });
+        try {
+            if (!context.workspaceCache) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: "❌ Workspace cache not available",
+                        }],
+                };
+            }
+            const workspaceId = context.workspaceCache.currentWorkspace._id;
+            // v2.network.product.create - creates a product entry (only accepts name)
+            const templateData = {
+                name: args.name
+            };
+            logger.debug('Calling v2.network.product.create', {
+                workspaceId,
+                templateData
+            });
+            const result = await context.hailer.request('v2.network.product.create', [templateData]);
+            logger.debug('Template creation response', {
+                result: JSON.stringify(result)
+            });
+            const templateId = result?.productId || result?._id || result?.id;
+            let responseText = `✅ **Template Created Successfully**\n\n`;
+            responseText += `**Template Name:** ${args.name}\n`;
+            responseText += `**Template ID:** \`${templateId || 'See response'}\`\n`;
+            responseText += `**Workspace:** ${workspaceId}\n`;
+            responseText += `\n💡 **Next Steps:**\n`;
+            responseText += `- Use Hailer marketplace UI to add workflows and description\n`;
+            responseText += `- Share the template ID with others to install\n`;
+            if (args.description || args.workflowId) {
+                responseText += `\n⚠️ **Note:** The \`v3.app.product.create\` API only accepts \`name\`.\n`;
+                responseText += `Description and workflow attachment must be done via Hailer UI.\n`;
+            }
+            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. Only workspace administrators can create templates.\n\n**Error:** ${errorMessage}`,
+                        }],
+                };
+            }
+            return {
+                content: [{
+                        type: "text",
+                        text: `❌ **Error creating template**\n\n**Error:** ${errorMessage}\n\n**Common Issues:**\n- User must be workspace administrator\n- Invalid workflow ID`,
+                    }],
+            };
+        }
+    }
+};
+// ============================================================================
+// INSTALL TEMPLATE TOOL (MARKETPLACE)
+// ============================================================================
+const installTemplateDescription = `🏪 [PLAYGROUND] Install Template - Install marketplace template to workspace
+
+**What it does**:
+Installs a template from the Hailer marketplace into your workspace.
+
+**Example**:
+\`\`\`javascript
+install_template({
+  templateId: '<template-id>'
+})
+\`\`\`
+
+**Parameters**:
+- \`templateId\` (required) - Template/Product ID from marketplace
+
+**Requirements**:
+- User must be workspace administrator
+
+**Tips**:
+- Use \`list_templates\` to find template IDs
+- Template creates new workflow(s) in workspace`;
+exports.installTemplateTool = {
+    name: 'install_template',
+    group: tool_registry_1.ToolGroup.PLAYGROUND,
+    description: installTemplateDescription,
+    schema: zod_1.z.object({
+        templateId: zod_1.z
+            .string()
+            .min(1)
+            .describe("Template/Product ID to install"),
+        workspaceId: zod_1.z
+            .string()
+            .optional()
+            .describe("Target workspace ID (defaults to current)"),
+    }),
+    async execute(args, context) {
+        logger.debug('Installing marketplace template', {
+            templateId: args.templateId,
+            workspaceId: args.workspaceId,
+            apiKey: context.apiKey.substring(0, 8) + '...'
+        });
+        try {
+            if (!context.workspaceCache) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: "❌ Workspace cache not available",
+                        }],
+                };
+            }
+            const workspaceId = args.workspaceId
+                ? (0, workspace_cache_1.resolveWorkspaceId)(context.workspaceCache, args.workspaceId)
+                : context.workspaceCache.currentWorkspace._id;
+            if (!workspaceId) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `❌ Could not resolve workspace: ${args.workspaceId}`,
+                        }],
+                };
+            }
+            logger.debug('Calling v2.network.product.install', {
+                templateId: args.templateId,
+                workspaceId
+            });
+            const result = await context.hailer.request('v2.network.product.install', [
+                args.templateId,
+                workspaceId
+            ]);
+            logger.debug('Template installation response', {
+                result: JSON.stringify(result)
+            });
+            const appId = result?.appId || result?._id;
+            let responseText = `✅ **Template Installed Successfully**\n\n`;
+            responseText += `**Template ID:** \`${args.templateId}\`\n`;
+            responseText += `**Workspace:** ${workspaceId}\n`;
+            if (appId) {
+                responseText += `**App ID:** \`${appId}\`\n`;
+            }
+            responseText += `\n💡 **Next Steps:**\n`;
+            responseText += `- Use \`list_workflows\` to see new workflow(s)\n`;
+            responseText += `- Use \`list_apps\` to see new app(s)\n`;
+            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);
+            }
+            if (errorMessage.toLowerCase().includes('not found')) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `❌ **Template Not Found**\n\nTemplate ID \`${args.templateId}\` not found in marketplace.\n\n**Check:**\n- Template ID is correct\n- Template is published and available\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 install templates. Only workspace administrators can install templates.\n\n**Error:** ${errorMessage}`,
+                        }],
+                };
+            }
+            if (errorMessage.toLowerCase().includes('already installed')) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `⚠️ **Template Already Installed**\n\nThis template is already installed in the workspace.\n\n**Template ID:** \`${args.templateId}\`\n\n💡 Use \`list_apps\` to see installed apps.`,
+                        }],
+                };
+            }
+            // Include debug info for troubleshooting
+            const debugInfo = {
+                endpoint: 'v2.network.product.install',
+                requestData: [args.templateId, args.workspaceId || 'current-workspace']
+            };
+            return {
+                content: [{
+                        type: "text",
+                        text: `❌ **Error installing template**\n\n**Error:** ${errorMessage}\n\n**Debug Info:**\n\`\`\`json\n${JSON.stringify(debugInfo, null, 2)}\n\`\`\`\n\n**Common Issues:**\n- Invalid template ID\n- Template not found\n- Permission denied\n- Already installed`,
+                    }],
+            };
+        }
+    }
+};
+// ============================================================================
+// GET TEMPLATE TOOL (MARKETPLACE)
+// ============================================================================
+const getTemplateDescription = `🏪 [PLAYGROUND] Get Template - View template details from marketplace
+
+**What it does**:
+Retrieves detailed information about a specific marketplace template.
+
+**Example**:
+\`\`\`javascript
+get_template({
+  templateId: '<template-id>'
+})
+\`\`\`
+
+**Shows**:
+- Template name and description
+- Template version
+- Included workflows
+- Manifest information
+
+**Use Cases**:
+- Preview template before installing
+- Check template version
+- View template structure`;
+exports.getTemplateTool = {
+    name: 'get_template',
+    group: tool_registry_1.ToolGroup.PLAYGROUND,
+    description: getTemplateDescription,
+    schema: zod_1.z.object({
+        templateId: zod_1.z
+            .string()
+            .min(1)
+            .describe("Template/Product ID to get details for"),
+    }),
+    async execute(args, context) {
+        logger.debug('Getting marketplace template', {
+            templateId: args.templateId,
+            apiKey: context.apiKey.substring(0, 8) + '...'
+        });
+        try {
+            logger.debug('Calling v2.network.product.get', {
+                templateId: args.templateId
+            });
+            const result = await context.hailer.request('v2.network.product.get', [args.templateId]);
+            logger.debug('Template get response', {
+                result: JSON.stringify(result)
+            });
+            const product = result?.product || result;
+            let responseText = `✅ **Template Details**\n\n`;
+            responseText += `**Template ID:** \`${args.templateId}\`\n`;
+            if (product?.name) {
+                responseText += `**Name:** ${product.name}\n`;
+            }
+            if (product?.description) {
+                responseText += `**Description:** ${product.description}\n`;
+            }
+            if (product?.version) {
+                responseText += `**Version:** ${product.version}\n`;
+            }
+            // Also try to get manifest
+            try {
+                const manifest = await context.hailer.request('v2.network.product.getManifest', [args.templateId]);
+                logger.debug('Template manifest response', {
+                    manifest: JSON.stringify(manifest)
+                });
+                if (manifest) {
+                    responseText += `\n**Manifest:**\n\`\`\`json\n${JSON.stringify(manifest, null, 2)}\n\`\`\`\n`;
+                }
+            }
+            catch (manifestError) {
+                logger.debug('Could not fetch manifest', { error: manifestError });
+            }
+            // Check if installed (needs productId and workspaceId)
+            try {
+                if (context.workspaceCache) {
+                    const workspaceId = context.workspaceCache.currentWorkspace._id;
+                    const installed = await context.hailer.request('v2.network.product.isProductInstalled', [
+                        args.templateId,
+                        workspaceId
+                    ]);
+                    logger.debug('Template installation check', {
+                        installed: JSON.stringify(installed)
+                    });
+                    if (installed?.installed) {
+                        responseText += `\n✅ **Status:** Installed in current workspace\n`;
+                        if (installed.appId) {
+                            responseText += `**App ID:** \`${installed.appId}\`\n`;
+                        }
+                    }
+                    else {
+                        responseText += `\n⚪ **Status:** Not installed in current workspace\n`;
+                    }
+                }
+            }
+            catch (installCheckError) {
+                logger.debug('Could not check installation status', { error: installCheckError });
+            }
+            responseText += `\n💡 **Next Steps:**\n`;
+            responseText += `- Use \`install_template\` to install this template\n`;
+            responseText += `- Use \`list_templates\` to see other templates`;
+            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\nTemplate ID \`${args.templateId}\` not found in marketplace.\n\n**Check:**\n- Template ID is correct\n- Template exists and is published\n\n💡 Use \`list_templates\` to see available templates.`,
+                        }],
+                };
+            }
+            return {
+                content: [{
+                        type: "text",
+                        text: `❌ **Error getting template**\n\n**Error:** ${errorMessage}\n\n**Common Issues:**\n- Invalid template ID\n- Template not found`,
+                    }],
+            };
+        }
+    }
+};
+// ============================================================================
+// PUBLISH TEMPLATE TOOL (MARKETPLACE)
+// ============================================================================
+const publishTemplateDescription = `🏪 [PLAYGROUND] Publish Template - Publish workspace to marketplace
+
+**What it does**:
+Publishes the current workspace as a template to the Hailer marketplace, making it installable by other workspaces.
+
+**Example - New Template**:
+\`\`\`javascript
+publish_template({
+  title: 'Football Manager',
+  description: 'Complete football club management workspace',
+  version: '1.0.0',
+  versionDescription: 'Initial release with Players, Matches, Training workflows',
+  publisher: 'Hailer Oy',
+  iconFileId: '692d3e66e98c7bab4af7f0a1'
+})
+\`\`\`
+
+**Example - Update Existing Template**:
+\`\`\`javascript
+publish_template({
+  productId: '692d46bfca77093f10b0c09a',  // Existing product ID
+  title: 'Football Manager',
+  description: 'Updated description',
+  version: '1.1.0',
+  versionDescription: 'Fixed icon and added new features',
+  publisher: 'Hailer Oy',
+  iconFileId: '692d47adf9383bd1a9e26d78'
+})
+\`\`\`
+
+**Required Parameters** (gather ALL before calling):
+- \`title\` - Template name (max 64 chars)
+- \`description\` - Template description (max 4096 chars)
+- \`version\` - Version string (e.g. "1.0.0")
+- \`versionDescription\` - Release notes for this version
+- \`publisher\` - Publishing company/person name
+- \`iconFileId\` - Icon file ID (upload with \`upload_files\` first)
+
+**Optional Parameters**:
+- \`productId\` - Existing product ID to UPDATE (omit to create new)
+- \`imageFileIds\` - Array of preview image file IDs
+- \`externalUrl\` - External website URL
+
+**IMPORTANT**: A PreToolUse hook will BLOCK this call if required fields are missing.
+Gather ALL information from user BEFORE calling this tool.
+
+**Workflow**:
+1. Ask user for template details (name, description, version, etc.)
+2. Ask user for icon (URL, path, or existing fileId)
+3. Upload icon with \`upload_files\`
+4. Call \`publish_template\` with ALL fields
+5. To UPDATE: include \`productId\` from previous publish
+
+**What Gets Published**:
+- The ENTIRE current workspace is published as a template
+- All workflows, fields, phases are included
+
+**After Publishing**:
+- Template appears in \`list_templates()\`
+- Other workspaces can install with \`install_template()\``;
+exports.publishTemplateTool = {
+    name: 'publish_template',
+    group: tool_registry_1.ToolGroup.PLAYGROUND,
+    description: publishTemplateDescription,
+    schema: zod_1.z.object({
+        productId: zod_1.z
+            .string()
+            .length(24)
+            .optional()
+            .describe("Existing product ID to UPDATE (omit to create new template)"),
+        title: zod_1.z
+            .string()
+            .min(1)
+            .max(64)
+            .describe("Template name (max 64 chars)"),
+        description: zod_1.z
+            .string()
+            .min(1)
+            .max(4096)
+            .describe("Template description (max 4096 chars)"),
+        version: zod_1.z
+            .string()
+            .min(1)
+            .describe("Version string (e.g. '1.0.0')"),
+        versionDescription: zod_1.z
+            .string()
+            .min(1)
+            .describe("Release notes for this version"),
+        publisher: zod_1.z
+            .string()
+            .min(1)
+            .describe("Publishing company or person name"),
+        iconFileId: zod_1.z
+            .string()
+            .length(24)
+            .describe("Icon file ID (24 chars). Upload with upload_files first"),
+        imageFileIds: zod_1.z
+            .array(zod_1.z.string().length(24))
+            .optional()
+            .describe("Optional array of preview image file IDs"),
+        externalUrl: zod_1.z
+            .string()
+            .url()
+            .optional()
+            .describe("Optional external website URL"),
+    }),
+    async execute(args, context) {
+        const isUpdate = !!args.productId;
+        logger.debug(`${isUpdate ? 'Updating' : 'Publishing'} template to marketplace`, {
+            title: args.title,
+            version: args.version,
+            productId: args.productId,
+            apiKey: context.apiKey.substring(0, 8) + '...'
+        });
+        try {
+            if (!context.workspaceCache) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: "❌ Workspace cache not available",
+                        }],
+                };
+            }
+            const workspaceId = context.workspaceCache.currentWorkspace._id;
+            let productId = args.productId;
+            // Only create new manifest if not updating existing template
+            if (!isUpdate) {
+                // Note: versionDescription is required and cannot be empty
+                const publishData = {
+                    workspaceId,
+                    version: args.version,
+                    versionDescription: args.versionDescription,
+                    title: args.title,
+                    description: args.description
+                };
+                logger.debug('Calling v2.network.product.publishTemplate', {
+                    publishData
+                });
+                // Step 1: Create the template manifest
+                const publishResult = await context.hailer.request('v2.network.product.publishTemplate', [publishData]);
+                logger.debug('Publish template response', {
+                    result: JSON.stringify(publishResult)
+                });
+                productId = publishResult?.productId || publishResult?._id || publishResult?.id;
+                if (!productId) {
+                    return {
+                        content: [{
+                                type: "text",
+                                text: `❌ **Error**: publishTemplate succeeded but no product ID returned.\n\n**Response:**\n\`\`\`json\n${JSON.stringify(publishResult, null, 2)}\n\`\`\``,
+                            }],
+                    };
+                }
+            }
+            // Step 2: Create or Update the product in marketplace
+            let productData;
+            let apiMethod;
+            let apiArgs;
+            if (isUpdate) {
+                // Update only allows specific fields
+                productData = {
+                    name: args.title,
+                    description: args.description,
+                    publisher: args.publisher,
+                    icon: args.iconFileId,
+                    images: args.imageFileIds || [args.iconFileId]
+                };
+                if (args.externalUrl) {
+                    productData.externalUrl = args.externalUrl;
+                }
+                apiMethod = 'v3.product.update';
+                apiArgs = [productId, productData];
+            }
+            else {
+                // Create requires full data
+                productData = {
+                    cid: workspaceId,
+                    targetId: productId,
+                    name: args.title,
+                    description: args.description,
+                    type: 'template',
+                    publisher: args.publisher,
+                    icon: args.iconFileId,
+                    images: args.imageFileIds || [args.iconFileId]
+                };
+                if (args.externalUrl) {
+                    productData.externalUrl = args.externalUrl;
+                }
+                apiMethod = 'v3.product.create';
+                apiArgs = [productData];
+            }
+            logger.debug(`Calling ${apiMethod}`, { productId, workspaceId, iconFileId: args.iconFileId });
+            const apiResult = await context.hailer.request(apiMethod, apiArgs);
+            logger.debug(`${apiMethod} response`, {
+                result: JSON.stringify(apiResult)
+            });
+            // Get the final product ID from the v3 API response (this is the correct marketplace ID)
+            const finalProductId = apiResult?._id || apiResult?.id || productId;
+            let responseText = `✅ **Template ${isUpdate ? 'Updated' : 'Published'} Successfully**\n\n`;
+            responseText += `**Title:** ${args.title}\n`;
+            responseText += `**Publisher:** ${args.publisher}\n`;
+            responseText += `**Version:** ${args.version}\n`;
+            responseText += `**Workspace:** ${workspaceId}\n`;
+            responseText += `**Product ID:** \`${finalProductId}\`\n`;
+            responseText += `**Release Notes:** ${args.versionDescription}\n`;
+            responseText += `\n💡 **Next Steps:**\n`;
+            responseText += `- Use \`list_templates()\` to see it in the marketplace\n`;
+            responseText += `- Share the product ID with other workspaces\n`;
+            responseText += `- They can install with \`install_template({ templateId: "${finalProductId}" })\`\n`;
+            return {
+                content: [{
+                        type: "text",
+                        text: responseText,
+                    }],
+            };
+        }
+        catch (error) {
+            logger.error("Error publishing 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 publish templates. Only workspace administrators can publish.\n\n**Error:** ${errorMessage}`,
+                        }],
+                };
+            }
+            // Always include debug info for troubleshooting
+            const debugWorkspaceId = context.workspaceCache?.currentWorkspace._id || 'unknown';
+            const debugInfo = {
+                endpoint: 'v2.network.product.publishTemplate',
+                requestData: {
+                    workspaceId: debugWorkspaceId,
+                    version: args.version,
+                    versionDescription: args.versionDescription,
+                    title: args.title,
+                    description: args.description
+                }
+            };
+            return {
+                content: [{
+                        type: "text",
+                        text: `❌ **Error publishing template**\n\n**Error:** ${errorMessage}\n\n**Debug Info:**\n\`\`\`json\n${JSON.stringify(debugInfo, null, 2)}\n\`\`\`\n\n**Common Issues:**\n- Product may need to exist first (use create_template)\n- Version format may be incorrect\n- Workflow may not be attached to product`,
+                    }],
+            };
+        }
+    }
+};
+// =============================================================================
+// GET PRODUCT (v3) TOOL
+// =============================================================================
+const getProductDescription = `🏪 [PLAYGROUND] Get Product - Get detailed product info from marketplace (v3 API)
+
+**What it does**:
+Retrieves detailed information about a marketplace product using v3 API.
+
+**Example**:
+\`\`\`javascript
+get_product({
+  productId: '692994df55996e1201963cd7'
+})
+\`\`\`
+
+**Returns**: Product details including versions, workflows, and configuration`;
+exports.getProductTool = {
+    name: 'get_product',
+    group: tool_registry_1.ToolGroup.PLAYGROUND,
+    description: getProductDescription,
+    schema: zod_1.z.object({
+        productId: zod_1.z
+            .string()
+            .length(24)
+            .describe("Product ID to get details for (24 characters)"),
+    }),
+    async execute(args, context) {
+        logger.debug('Getting product details (v3)', {
+            productId: args.productId,
+            apiKey: context.apiKey.substring(0, 8) + '...'
+        });
+        try {
+            logger.debug('Calling v3.app.product.get', {
+                productId: args.productId
+            });
+            const result = await context.hailer.request('v3.app.product.get', [args.productId]);
+            logger.debug('Product get response', {
+                result: JSON.stringify(result)
+            });
+            const product = result;
+            let responseText = `✅ **Product Details (v3)**\n\n`;
+            responseText += `**Product ID:** \`${args.productId}\`\n`;
+            if (product?.name) {
+                responseText += `**Name:** ${product.name}\n`;
+            }
+            if (product?.description) {
+                responseText += `**Description:** ${product.description}\n`;
+            }
+            if (product?.type) {
+                responseText += `**Type:** ${product.type}\n`;
+            }
+            if (product?.versions?.length) {
+                responseText += `**Versions:** ${product.versions.length}\n`;
+            }
+            return {
+                content: [{
+                        type: "text",
+                        text: responseText,
+                    }],
+            };
+        }
+        catch (error) {
+            logger.error("Error getting product", 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 getting product**\n\n**Error:** ${errorMessage}`,
+                    }],
+            };
+        }
+    }
+};
+// =============================================================================
+// GET PRODUCT MANIFEST (v3) TOOL
+// =============================================================================
+const getProductManifestDescription = `🏪 [PLAYGROUND] Get Product Manifest - Get manifest/version info from marketplace product
+
+**What it does**:
+Retrieves the manifest for a marketplace product, which may include version and workflow information.
+
+**Example**:
+\`\`\`javascript
+get_product_manifest({
+  productId: '692994df55996e1201963cd7'
+})
+\`\`\`
+
+**Returns**: Product manifest with version details`;
+exports.getProductManifestTool = {
+    name: 'get_product_manifest',
+    group: tool_registry_1.ToolGroup.PLAYGROUND,
+    description: getProductManifestDescription,
+    schema: zod_1.z.object({
+        productId: zod_1.z
+            .string()
+            .length(24)
+            .describe("Product ID to get manifest for (24 characters)"),
+    }),
+    async execute(args, context) {
+        logger.debug('Getting product manifest (v3)', {
+            productId: args.productId,
+            apiKey: context.apiKey.substring(0, 8) + '...'
+        });
+        try {
+            logger.debug('Calling v3.app.product.getManifest', {
+                productId: args.productId
+            });
+            const result = await context.hailer.request('v3.app.product.getManifest', [args.productId]);
+            logger.debug('Product manifest response', {
+                result: JSON.stringify(result)
+            });
+            const manifest = result;
+            let responseText = `✅ **Product Manifest (v3)**\n\n`;
+            responseText += `**Product ID:** \`${args.productId}\`\n`;
+            if (manifest?.version) {
+                responseText += `**Version:** ${manifest.version}\n`;
+            }
+            if (manifest?.workflows?.length) {
+                responseText += `**Workflows:** ${manifest.workflows.length}\n`;
+            }
+            return {
+                content: [{
+                        type: "text",
+                        text: responseText,
+                    }],
+            };
+        }
+        catch (error) {
+            logger.error("Error getting product manifest", 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 getting product manifest**\n\n**Error:** ${errorMessage}`,
+                    }],
+            };
+        }
+    }
+};
 //# sourceMappingURL=app.js.map