@hailer/mcp 0.1.6 → 0.1.9

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

@@ -13,31 +13,11 @@ 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 UserContextCache_1 = require("../UserContextCache");
 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.`;
+const listTemplatesDescription = `List marketplace templates`;
 exports.listTemplatesTool = {
     name: 'list_templates',
     group: tool_registry_1.ToolGroup.PLAYGROUND,
@@ -143,31 +123,7 @@ exports.listTemplatesTool = {
 // ============================================================================
 // 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`;
+const createTemplateDescription = `Create marketplace template`;
 exports.createTemplateTool = {
     name: 'create_template',
     group: tool_registry_1.ToolGroup.PLAYGROUND,
@@ -251,27 +207,7 @@ exports.createTemplateTool = {
 // ============================================================================
 // 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`;
+const installTemplateDescription = `Install marketplace template to workspace`;
 exports.installTemplateTool = {
     name: 'install_template',
     group: tool_registry_1.ToolGroup.PLAYGROUND,
@@ -308,6 +244,11 @@ exports.installTemplateTool = {
             logger.debug('Template installation response', {
                 result: JSON.stringify(result)
             });
+            // Invalidate user context cache so subsequent list_workflows calls get fresh data
+            UserContextCache_1.UserContextCache.clearContext(context.apiKey);
+            logger.info('Cleared user context cache after template install', {
+                apiKey: context.apiKey.substring(0, 8) + '...'
+            });
             const appId = result?.appId || result?._id;
             let responseText = `✅ **Template Installed Successfully**\n\n`;
             responseText += `**Template ID:** \`${args.templateId}\`\n`;
@@ -369,28 +310,7 @@ exports.installTemplateTool = {
 // ============================================================================
 // 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`;
+const getTemplateDescription = `Get template details from marketplace`;
 exports.getTemplateTool = {
     name: 'get_template',
     group: tool_registry_1.ToolGroup.PLAYGROUND,
@@ -497,66 +417,7 @@ exports.getTemplateTool = {
 // ============================================================================
 // 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()\``;
+const publishTemplateDescription = `Publish workspace as marketplace template`;
 exports.publishTemplateTool = {
     name: 'publish_template',
     group: tool_registry_1.ToolGroup.PLAYGROUND,
@@ -742,19 +603,7 @@ exports.publishTemplateTool = {
 // =============================================================================
 // 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`;
+const getProductDescription = `Get product details from marketplace`;
 exports.getProductTool = {
     name: 'get_product',
     group: tool_registry_1.ToolGroup.PLAYGROUND,
@@ -815,19 +664,7 @@ exports.getProductTool = {
 // =============================================================================
 // 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`;
+const getProductManifestDescription = `Get product manifest from marketplace`;
 exports.getProductManifestTool = {
     name: 'get_product_manifest',
     group: tool_registry_1.ToolGroup.PLAYGROUND,
@@ -882,68 +719,7 @@ exports.getProductManifestTool = {
 // =============================================================================
 // 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: "..." })\``;
+const publishAppDescription = `Publish app to Hailer marketplace`;
 exports.publishAppTool = {
     name: 'publish_app',
     group: tool_registry_1.ToolGroup.PLAYGROUND,
@@ -1153,28 +929,7 @@ exports.publishAppTool = {
 // =============================================================================
 // 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`;
+const installMarketplaceAppDescription = `Install app from marketplace`;
 exports.installMarketplaceAppTool = {
     name: 'install_marketplace_app',
     group: tool_registry_1.ToolGroup.PLAYGROUND,

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

@@ -13,48 +13,7 @@ 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-member' });
-const addAppMemberDescription = `🧪 [PLAYGROUND] Add App Member - Share app with users/teams
-
-**What it does**:
-Grants permission for users, teams, or entire workspace to access an app.
-
-**Member Formats**:
-- \`network_<workspaceId>\` - Entire workspace
-- \`team_<teamId>\` - Specific team
-- \`user_<userId>\` - Individual user
-- \`group_<groupId>\` - Custom group
-
-**Example - Share with workspace**:
-\`\`\`javascript
-add_app_member({
-  appId: '<app-id>',
-  member: 'network_68446c045b30685f67c6fc8c'
-})
-\`\`\`
-
-**Example - Share with team**:
-\`\`\`javascript
-add_app_member({
-  appId: '<app-id>',
-  member: 'team_<team-id>'
-})
-\`\`\`
-
-**Example - Share with user**:
-\`\`\`javascript
-add_app_member({
-  appId: '<app-id>',
-  member: 'user_<user-id>'
-})
-\`\`\`
-
-**Requirements**:
-- User must be app creator or workspace admin
-
-**Tips**:
-- Default: Only creator and admins see app
-- Use network_ to make app available to everyone
-- Use team_ for team-specific apps`;
+const addAppMemberDescription = `Share app with users/teams`;
 exports.addAppMemberTool = {
     name: 'add_app_member',
     group: tool_registry_1.ToolGroup.PLAYGROUND,
@@ -146,37 +105,7 @@ exports.addAppMemberTool = {
 // ============================================================================
 // REMOVE APP MEMBER TOOL
 // ============================================================================
-const removeAppMemberDescription = `🧪 [PLAYGROUND] Remove App Member - Revoke app access
-
-**What it does**:
-Revokes permission for users, teams, or workspace to access an app.
-
-**Example - Remove workspace access**:
-\`\`\`javascript
-remove_app_member({
-  appId: '<app-id>',
-  member: 'network_68446c045b30685f67c6fc8c'
-})
-\`\`\`
-
-**Example - Remove team access**:
-\`\`\`javascript
-remove_app_member({
-  appId: '<app-id>',
-  member: 'team_<team-id>'
-})
-\`\`\`
-
-**Requirements**:
-- User must be app creator or workspace admin
-
-**Notes**:
-- Creator and admins always retain access
-- Removing workspace revokes access from all members
-
-**Tips**:
-- Use \`list_apps\` to get app IDs
-- Member format same as add_app_member`;
+const removeAppMemberDescription = `Revoke app access from user/team`;
 exports.removeAppMemberTool = {
     name: 'remove_app_member',
     group: tool_registry_1.ToolGroup.PLAYGROUND,