@hailer/mcp 0.0.6 → 0.1.0

package/dist/mcp/tools/app-marketplace.js

@@ -0,0 +1,1284 @@
+"use strict";
+/**
+ * App Tools - Marketplace & Templates
+ *
+ * App marketplace and template management tools:
+ * - List, create, get, and install templates
+ * - Publish templates to marketplace
+ * - Publish apps to marketplace
+ * - Install marketplace apps
+ * - Get product info and manifests
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installMarketplaceAppTool = exports.publishAppTool = exports.getProductManifestTool = exports.getProductTool = exports.publishTemplateTool = exports.getTemplateTool = exports.installTemplateTool = exports.createTemplateTool = exports.listTemplatesTool = void 0;
+const zod_1 = require("zod");
+const tool_registry_1 = require("../tool-registry");
+const logger_1 = require("../../lib/logger");
+const tool_helpers_1 = require("../utils/tool-helpers");
+const logger = (0, logger_1.createLogger)({ component: 'app-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 {
+            const workspaceId = (0, tool_helpers_1.getResolvedWorkspaceId)(args, context);
+            if (!workspaceId) {
+                return (0, tool_helpers_1.missingWorkspaceCacheResponse)();
+            }
+            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);
+            const errorMessage = (0, tool_helpers_1.extractErrorMessage)(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 {
+            const workspaceId = (0, tool_helpers_1.getResolvedWorkspaceId)({}, context);
+            if (!workspaceId) {
+                return (0, tool_helpers_1.missingWorkspaceCacheResponse)();
+            }
+            // 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);
+            const errorMessage = (0, tool_helpers_1.extractErrorMessage)(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 {
+            const workspaceId = (0, tool_helpers_1.getResolvedWorkspaceId)(args, context);
+            if (!workspaceId) {
+                return (0, tool_helpers_1.missingWorkspaceCacheResponse)();
+            }
+            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);
+            const errorMessage = (0, tool_helpers_1.extractErrorMessage)(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);
+            const errorMessage = (0, tool_helpers_1.extractErrorMessage)(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 {
+            const workspaceId = (0, tool_helpers_1.getResolvedWorkspaceId)({}, context);
+            if (!workspaceId) {
+                return (0, tool_helpers_1.missingWorkspaceCacheResponse)();
+            }
+            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);
+            const errorMessage = (0, tool_helpers_1.extractErrorMessage)(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);
+            const errorMessage = (0, tool_helpers_1.extractErrorMessage)(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);
+            const errorMessage = (0, tool_helpers_1.extractErrorMessage)(error);
+            return {
+                content: [{
+                        type: "text",
+                        text: `❌ **Error getting product manifest**\n\n**Error:** ${errorMessage}`,
+                    }],
+            };
+        }
+    }
+};
+// =============================================================================
+// PUBLISH APP TO MARKETPLACE TOOL
+// =============================================================================
+const publishAppDescription = `🏪 [PLAYGROUND] Publish App - Publish app to Hailer marketplace
+
+**What it does**:
+Publishes an existing app to the Hailer marketplace, making it installable by other workspaces.
+
+**IMPORTANT**: This is different from \`publish_hailer_app\` which deploys code to Hailer hosting.
+This tool creates a **marketplace listing** so other workspaces can discover and install your app.
+
+**Example - New Marketplace Listing**:
+\`\`\`javascript
+publish_app({
+  appId: '692d3e66e98c7bab4af7f0a1',
+  versionId: '692d3e66e98c7bab4af7f0a3',  // From publish_hailer_app response
+  title: 'Task Manager Pro',
+  description: 'Advanced task management with Kanban boards',
+  version: '1.0.0',
+  versionDescription: 'Initial release with drag-drop support',
+  publisher: 'Hailer Oy',
+  iconFileId: '692d3e66e98c7bab4af7f0a2'
+})
+\`\`\`
+
+**Example - Update Existing Listing**:
+\`\`\`javascript
+publish_app({
+  appId: '692d3e66e98c7bab4af7f0a1',
+  versionId: '692d3e66e98c7bab4af7f0a3',
+  productId: '692d46bfca77093f10b0c09a',  // Existing product ID
+  title: 'Task Manager Pro',
+  description: 'Updated description',
+  version: '1.1.0',
+  versionDescription: 'Added dark mode support',
+  publisher: 'Hailer Oy',
+  iconFileId: '692d47adf9383bd1a9e26d78'
+})
+\`\`\`
+
+**Required Parameters** (gather ALL before calling):
+- \`appId\` - App ID to publish (must be a published app, not dev)
+- \`versionId\` - Version ID from \`publish_hailer_app\` response (the targetId for marketplace)
+- \`title\` - Marketplace listing name (max 64 chars)
+- \`description\` - Full 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 documentation URL
+
+**Workflow**:
+1. Create and publish app with \`publish_hailer_app\` (deploys code, returns versionId)
+2. Upload icon with \`upload_files\`
+3. Call \`publish_app\` with versionId to create marketplace listing
+4. Other workspaces can install with \`install_marketplace_app\`
+
+**After Publishing**:
+- App appears in marketplace
+- Share the product ID with other workspaces
+- They install with \`install_marketplace_app({ productId: "..." })\``;
+exports.publishAppTool = {
+    name: 'publish_app',
+    group: tool_registry_1.ToolGroup.PLAYGROUND,
+    description: publishAppDescription,
+    schema: zod_1.z.object({
+        appId: zod_1.z
+            .string()
+            .length(24)
+            .describe("App ID to publish (24 characters)"),
+        versionId: zod_1.z
+            .string()
+            .length(24)
+            .optional()
+            .describe("Optional version ID. If not provided, uses appId as targetId."),
+        productId: zod_1.z
+            .string()
+            .length(24)
+            .optional()
+            .describe("Existing product ID to UPDATE (omit to create new listing)"),
+        title: zod_1.z
+            .string()
+            .min(1)
+            .max(64)
+            .describe("Marketplace listing name (max 64 chars)"),
+        description: zod_1.z
+            .string()
+            .min(1)
+            .max(4096)
+            .describe("Full 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 documentation URL"),
+    }),
+    async execute(args, context) {
+        const isUpdate = !!args.productId;
+        logger.debug(`${isUpdate ? 'Updating' : 'Publishing'} app to marketplace`, {
+            appId: args.appId,
+            title: args.title,
+            version: args.version,
+            productId: args.productId,
+            apiKey: context.apiKey.substring(0, 8) + '...'
+        });
+        try {
+            const workspaceId = (0, tool_helpers_1.getResolvedWorkspaceId)({}, context);
+            if (!workspaceId) {
+                return (0, tool_helpers_1.missingWorkspaceCacheResponse)();
+            }
+            // Verify app exists and get details
+            logger.debug('Fetching app details', { appId: args.appId });
+            const appResult = await context.hailer.request('v3.app.list', [{}]);
+            const apps = appResult?.apps || appResult?.details?.apps || (Array.isArray(appResult) ? appResult : []);
+            const app = Array.isArray(apps) ? apps.find((a) => a._id === args.appId) : null;
+            if (!app) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `❌ **App Not Found**\n\nApp ID \`${args.appId}\` was not found in the current workspace.\n\n**Tips:**\n- Use \`list_apps()\` to see available apps\n- Ensure the app exists and you have access`,
+                        }],
+                };
+            }
+            // Warn if app is a dev app (has localhost URL)
+            if (app.url && app.url.includes('localhost')) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `⚠️ **Cannot Publish Development App**\n\nApp "${app.name}" is a development app (URL: ${app.url}).\n\n**To publish to marketplace:**\n1. First publish the app code with \`publish_hailer_app\`\n2. Or create a production app with empty URL\n3. Then call \`publish_app\` again`,
+                        }],
+                };
+            }
+            let productId = args.productId;
+            let targetId = args.versionId;
+            // Step 1: If no versionId provided and not updating, create app version manifest
+            if (!targetId && !productId) {
+                const publishData = {
+                    appId: args.appId,
+                    workspaceId,
+                    version: args.version,
+                    versionDescription: args.versionDescription,
+                    title: args.title,
+                    description: args.description
+                };
+                logger.debug('Calling v2.network.product.publishAppVersion', { publishData });
+                try {
+                    const publishResult = await context.hailer.request('v2.network.product.publishAppVersion', [publishData]);
+                    logger.debug('publishAppVersion response', { result: JSON.stringify(publishResult) });
+                    targetId = publishResult?.productId || publishResult?._id || publishResult?.id;
+                }
+                catch (err) {
+                    logger.debug('v2.network.product.publishAppVersion failed', {
+                        error: err instanceof Error ? err.message : String(err)
+                    });
+                    // If publishAppVersion doesn't exist, the error will be caught below
+                }
+                if (!targetId) {
+                    return {
+                        content: [{
+                                type: "text",
+                                text: `❌ **Error**: Could not create app version for marketplace.\n\n**Note:** The app marketplace publishing API may not be available. Make sure the app has been published with \`publish_hailer_app\` first.\n\nYou can share the app directly with \`add_app_member\` instead.`,
+                            }],
+                    };
+                }
+            }
+            // Step 2: Create or Update the product in marketplace
+            let productData;
+            let apiMethod;
+            let apiArgs;
+            if (isUpdate && productId) {
+                // 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 - targetId comes from versionId param or publishAppVersion call
+                productData = {
+                    cid: workspaceId,
+                    targetId, // Version ID from publishAppVersion or provided versionId
+                    name: args.title,
+                    description: args.description,
+                    type: 'app',
+                    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, appId: args.appId, targetId, 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
+            const finalProductId = apiResult?._id || apiResult?.id || productId;
+            let responseText = `✅ **App ${isUpdate ? 'Updated' : 'Published'} to Marketplace**\n\n`;
+            responseText += `**App:** ${app.name} (\`${args.appId}\`)\n`;
+            responseText += `**Title:** ${args.title}\n`;
+            responseText += `**Publisher:** ${args.publisher}\n`;
+            responseText += `**Version:** ${args.version}\n`;
+            responseText += `**Product ID:** \`${finalProductId}\`\n`;
+            responseText += `**Release Notes:** ${args.versionDescription}\n`;
+            responseText += `\n💡 **Next Steps:**\n`;
+            responseText += `- Share the product ID with other workspaces\n`;
+            responseText += `- They can install with \`install_marketplace_app({ productId: "${finalProductId}" })\`\n`;
+            responseText += `- To update, include \`productId: "${finalProductId}"\` in next publish\n`;
+            return {
+                content: [{
+                        type: "text",
+                        text: responseText,
+                    }],
+            };
+        }
+        catch (error) {
+            logger.error("Error publishing app to marketplace", error);
+            const errorMessage = (0, tool_helpers_1.extractErrorMessage)(error);
+            if (errorMessage.toLowerCase().includes('permission')) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `❌ **Permission Denied**\n\nYou don't have permission to publish apps to marketplace. Only workspace administrators can publish.\n\n**Error:** ${errorMessage}`,
+                        }],
+                };
+            }
+            return {
+                content: [{
+                        type: "text",
+                        text: `❌ **Error publishing app to marketplace**\n\n**Error:** ${errorMessage}\n\n**Common Issues:**\n- App must be a production app (not dev/localhost)\n- Must be workspace administrator\n- Icon file must be uploaded first\n- Invalid version format`,
+                    }],
+            };
+        }
+    }
+};
+// =============================================================================
+// INSTALL MARKETPLACE APP TOOL
+// =============================================================================
+const installMarketplaceAppDescription = `🏪 [PLAYGROUND] Install Marketplace App - Install app from Hailer marketplace
+
+**What it does**:
+Installs an app from the Hailer marketplace into your workspace.
+
+**Example**:
+\`\`\`javascript
+install_marketplace_app({
+  productId: '692d46bfca77093f10b0c09a'
+})
+\`\`\`
+
+**Parameters**:
+- \`productId\` (required) - Marketplace product ID
+
+**Requirements**:
+- User must be workspace administrator
+
+**Tips**:
+- Get product ID from app publisher or marketplace
+- Use \`get_product\` to preview app details before installing
+- Installed app appears in workspace app list`;
+exports.installMarketplaceAppTool = {
+    name: 'install_marketplace_app',
+    group: tool_registry_1.ToolGroup.PLAYGROUND,
+    description: installMarketplaceAppDescription,
+    schema: zod_1.z.object({
+        productId: zod_1.z
+            .string()
+            .length(24)
+            .describe("Marketplace product ID to install (24 characters)"),
+        workspaceId: zod_1.z
+            .string()
+            .optional()
+            .describe("Target workspace ID (defaults to current)"),
+    }),
+    async execute(args, context) {
+        logger.debug('Installing marketplace app', {
+            productId: args.productId,
+            apiKey: context.apiKey.substring(0, 8) + '...'
+        });
+        try {
+            const workspaceId = (0, tool_helpers_1.getResolvedWorkspaceId)(args, context);
+            if (!workspaceId) {
+                return (0, tool_helpers_1.missingWorkspaceCacheResponse)();
+            }
+            // Check if already installed
+            logger.debug('Checking if product is already installed', { productId: args.productId, workspaceId });
+            try {
+                const isInstalledResult = await context.hailer.request('v3.app.product.isProductInstalled', [args.productId, workspaceId]);
+                if (isInstalledResult?.installed) {
+                    return {
+                        content: [{
+                                type: "text",
+                                text: `ℹ️ **App Already Installed**\n\nThis app is already installed in your workspace.\n\n**App ID:** \`${isInstalledResult.appId || 'unknown'}\`\n\n**Tips:**\n- Use \`list_apps()\` to see installed apps\n- Use \`get_product({ productId: "${args.productId}" })\` to view product details`,
+                            }],
+                    };
+                }
+            }
+            catch (checkError) {
+                // Ignore check errors and proceed with installation
+                logger.debug('Could not check installation status, proceeding', {
+                    error: checkError instanceof Error ? checkError.message : String(checkError)
+                });
+            }
+            // Get product details first
+            logger.debug('Fetching product details', { productId: args.productId });
+            let productName = 'Unknown';
+            try {
+                const productResult = await context.hailer.request('v3.app.product.get', [args.productId]);
+                productName = productResult?.name || productResult?.title || 'Unknown';
+            }
+            catch (productError) {
+                logger.debug('Could not fetch product details', {
+                    error: productError instanceof Error ? productError.message : String(productError)
+                });
+            }
+            // Install the app
+            logger.debug('Calling v3.app.product.install', { productId: args.productId, workspaceId });
+            const installResult = await context.hailer.request('v3.app.product.install', [args.productId, workspaceId]);
+            logger.debug('Install result', { result: JSON.stringify(installResult) });
+            const installedAppId = installResult?.appId || installResult?.details?.appId || installResult?._id;
+            let responseText = `✅ **App Installed Successfully**\n\n`;
+            responseText += `**Product:** ${productName}\n`;
+            responseText += `**Product ID:** \`${args.productId}\`\n`;
+            if (installedAppId) {
+                responseText += `**Installed App ID:** \`${installedAppId}\`\n`;
+            }
+            responseText += `**Workspace:** \`${workspaceId}\`\n`;
+            responseText += `\n💡 **Next Steps:**\n`;
+            responseText += `- Use \`list_apps()\` to see the installed app\n`;
+            responseText += `- Use \`add_app_member\` to share with workspace members\n`;
+            responseText += `- Open the app from Hailer workspace menu\n`;
+            return {
+                content: [{
+                        type: "text",
+                        text: responseText,
+                    }],
+            };
+        }
+        catch (error) {
+            logger.error("Error installing marketplace app", error);
+            const errorMessage = (0, tool_helpers_1.extractErrorMessage)(error);
+            if (errorMessage.toLowerCase().includes('permission')) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `❌ **Permission Denied**\n\nYou don't have permission to install apps. Only workspace administrators can install marketplace apps.\n\n**Error:** ${errorMessage}`,
+                        }],
+                };
+            }
+            if (errorMessage.toLowerCase().includes('not found')) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `❌ **Product Not Found**\n\nThe marketplace product \`${args.productId}\` was not found.\n\n**Tips:**\n- Verify the product ID is correct\n- Use \`get_product\` to check if the product exists\n\n**Error:** ${errorMessage}`,
+                        }],
+                };
+            }
+            return {
+                content: [{
+                        type: "text",
+                        text: `❌ **Error installing marketplace app**\n\n**Error:** ${errorMessage}\n\n**Common Issues:**\n- Invalid product ID\n- Product not found in marketplace\n- Insufficient permissions`,
+                    }],
+            };
+        }
+    }
+};
+//# sourceMappingURL=app-marketplace.js.map