@hailer/mcp 0.2.3 → 0.2.4

package/.claude/hooks/interactive-mode.cjs

@@ -52,10 +52,11 @@ function processHook(data) {
     process.exit(0);
   }
 
-  const lowerPrompt = prompt.toLowerCase();
-
   // Detect task types that benefit from questions
+  // Order matters - more specific patterns first
   const taskPatterns = [
+    { pattern: /publish.*market|market.*publish|update.*market|market.*update|market.*icon|market.*listing/i, type: 'marketplace-publish', questions: ['New listing or update existing? (need productId for update)', 'Metadata only or new version with code?', 'Do you have an icon? (must upload with isPublic: true)'], skill: 'marketplace-publishing' },
+    { pattern: /publish|deploy|release|update.*app|app.*update|republish/i, type: 'app-publish', questions: ['Workspace only OR marketplace too?', 'Which app? (path or name)', 'Version bump needed?'], skill: 'publish-hailer-app' },
     { pattern: /build|create|make.*app/i, type: 'app', questions: ['What data to display?', 'What layout/components?', 'What user actions needed?'] },
     { pattern: /create|add.*insight|report/i, type: 'insight', questions: ['What metrics/aggregations?', 'Which workflows to query?', 'Any filters needed?'] },
     { pattern: /import|create.*activit|bulk/i, type: 'data', questions: ['Which workflow?', 'What field values?', 'How many records?'] },
@@ -66,6 +67,7 @@ function processHook(data) {
   const matched = taskPatterns.find(p => p.pattern.test(prompt));
 
   if (matched) {
+    const skillLine = matched.skill ? `\nLoad skill: ${matched.skill}` : '';
     const output = `
 <interactive-mode>
 BEFORE STARTING: Consider asking clarifying questions.
@@ -75,7 +77,7 @@ Suggested questions to ask user:
 ${matched.questions.map(q => `- ${q}`).join('\n')}
 
 Use AskUserQuestion tool if requirements are unclear.
-Gather specifics before spawning agents or making changes.
+Gather specifics before spawning agents or making changes.${skillLine}
 </interactive-mode>
 `;
     console.log(output);

package/.claude/skills/marketplace-publishing.md

@@ -0,0 +1,155 @@
+# Marketplace Publishing Skill
+
+<when-to-use>
+User wants to publish an app to marketplace, update marketplace listing, or change marketplace app icon/metadata.
+</when-to-use>
+
+<prerequisites>
+- `productId` - Marketplace product ID (24-char hex)
+- `appId` - The app being published (24-char hex)
+- User must be Network Admin of the workspace
+</prerequisites>
+
+<option-a>
+## Update Metadata Only (No Version Change)
+
+For updating icon, name, description without publishing new code:
+
+<step-1>
+**Upload icon as PUBLIC file**
+```javascript
+upload_files({
+  files: [{ path: "/path/to/icon.png", isPublic: true }]
+})
+```
+</step-1>
+
+<critical>
+`isPublic: true` is REQUIRED for marketplace icons to display!
+</critical>
+
+<step-2>
+**Update product metadata**
+```javascript
+publish_app({
+  appId: "<appId>",
+  productId: "<productId>",  // REQUIRED for update
+  title: "App Name",
+  description: "Description",
+  version: "1.0.0",          // Current version (no bump needed)
+  versionDescription: "Release notes",
+  publisher: "Publisher Name",
+  iconFileId: "<public-file-id>"
+})
+```
+</step-2>
+</option-a>
+
+<option-b>
+## Publish New Version (Code Changes)
+
+For publishing new app code with version bump:
+
+<step-1>
+**Upload icon as PUBLIC file (if changing)**
+```javascript
+upload_files({
+  files: [{ path: "/path/to/icon.png", isPublic: true }]
+})
+```
+</step-1>
+
+<step-2>
+**Update manifest.json**
+- Bump version (must be > current, e.g., "1.0.31" → "1.0.32")
+- Update versionDescription
+</step-2>
+
+<step-3>
+**Publish app bundle**
+```javascript
+publish_hailer_app({
+  projectDirectory: "/path/to/app",
+  publishToMarket: true
+})
+```
+</step-3>
+
+<step-4>
+**Update product metadata**
+```javascript
+publish_app({
+  appId: "<appId>",
+  productId: "<productId>",
+  title: "App Name",
+  description: "Description",
+  version: "1.0.32",
+  versionDescription: "What's new",
+  publisher: "Publisher Name",
+  iconFileId: "<public-file-id>"
+})
+```
+</step-4>
+</option-b>
+
+<option-c>
+## First-Time Marketplace Listing
+
+For apps not yet in marketplace:
+
+<step-1>
+**Upload icon as PUBLIC**
+```javascript
+upload_files({
+  files: [{ path: "/path/to/icon.png", isPublic: true }]
+})
+```
+</step-1>
+
+<step-2>
+**Publish app with marketplace flag**
+```javascript
+publish_hailer_app({
+  projectDirectory: "/path/to/app",
+  publishToMarket: true
+})
+```
+Returns a `targetId`.
+</step-2>
+
+<step-3>
+**Create marketplace listing**
+```javascript
+publish_app({
+  appId: "<appId>",
+  versionId: "<targetId>",   // From step 2
+  title: "App Name",
+  description: "Description",
+  version: "1.0.0",
+  versionDescription: "Initial release",
+  publisher: "Publisher Name",
+  iconFileId: "<public-file-id>"
+})
+```
+</step-3>
+
+<note>
+Creating new listings requires admin permissions.
+</note>
+</option-c>
+
+<common-errors>
+| Error | Cause | Fix |
+|-------|-------|-----|
+| Icon shows placeholder | File not public | Re-upload with `isPublic: true` |
+| "You have to be a network admin" | Missing permissions | Get admin access |
+| "Version not greater than previous" | Version too low | Bump version higher |
+| POST /app/publish fails | Needs file upload | Use `publish_hailer_app` for code changes |
+</common-errors>
+
+<api-reference>
+- `v3.product.update` - Updates metadata (name, description, icon, images)
+- `v3.product.create` - Creates new listing (admin only)
+- `POST /app/publish` - Uploads app bundle (requires .tgz file)
+- `v3.app.product.install` - Installs/updates in workspace
+</api-reference>

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

@@ -812,37 +812,15 @@ exports.publishAppTool = {
                 };
             }
             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
+            const targetId = args.versionId;
+            // For new listings, we need both targetId (from publish_hailer_app) to create the product
+            if (!productId && !targetId) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `❌ **Error**: Missing required IDs.\n\n**To create a new marketplace listing:**\n1. Run \`publish_hailer_app\` with \`publishToMarket: true\` to get a targetId\n2. Then run \`publish_app\` with the \`versionId\` (targetId)\n\n**To update existing listing metadata (icon, name, etc.):**\nInclude the \`productId\` parameter - no version bump needed.`,
+                        }],
                 };
-                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;
@@ -881,9 +859,9 @@ exports.publishAppTool = {
                 apiMethod = 'v3.product.create';
                 apiArgs = [productData];
             }
-            logger.debug(`Calling ${apiMethod}`, { productId, workspaceId, appId: args.appId, targetId, iconFileId: args.iconFileId });
+            logger.info(`Calling ${apiMethod}`, { productId, workspaceId, appId: args.appId, targetId, productData });
             const apiResult = await context.hailer.request(apiMethod, apiArgs);
-            logger.debug(`${apiMethod} response`, {
+            logger.info(`${apiMethod} response`, {
                 result: JSON.stringify(apiResult)
             });
             // Get the final product ID from the v3 API response

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hailer/mcp",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "config": {
     "docker": {
       "registry": "registry.gitlab.com/hailer-repos/hailer-mcp"