@hailer/mcp 0.0.6 → 0.1.0

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

@@ -0,0 +1,609 @@
+"use strict";
+/**
+ * App Tools - Core CRUD Operations
+ *
+ * Core app management tools:
+ * - Create apps (development and published)
+ * - List all apps in workspace
+ * - Update app properties
+ * - Remove apps
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.removeAppTool = exports.updateAppTool = exports.listAppsTool = exports.createAppTool = 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-core' });
+// ============================================================================
+// CREATE APP TOOL
+// ============================================================================
+const createAppDescription = `🧪 [PLAYGROUND] Create App - Create Hailer app entry in workspace
+
+**What are Apps?**
+Apps are custom web applications that extend Hailer workspace functionality. Think React/vanilla JS apps running within Hailer.
+
+**App Types**:
+- **Development Apps**: URL points to localhost (e.g., http://localhost:3000)
+- **Published Apps**: URL empty or points to production
+
+**Example 1 - Development App**:
+\`\`\`javascript
+create_app({
+  name: 'Local Development',
+  description: 'App pointing to local server',
+  url: 'http://localhost:3000'
+})
+\`\`\`
+
+**Example 2 - Published App**:
+\`\`\`javascript
+create_app({
+  name: 'Task Manager',
+  description: 'Production task management app',
+  url: '' // Empty for auto URL
+})
+\`\`\`
+
+**Properties**:
+- \`name\` (required) - App display name
+- \`description\` (optional) - App description
+- \`url\` (optional) - App URL or empty for auto-generated
+- \`image\` (optional) - Image/icon ID
+
+**Requirements**:
+- User must be workspace administrator
+- For published apps, leave URL empty
+
+**Tips**:
+- Use development apps for local testing
+- Published apps get automatic URLs from Hailer
+- Use \`add_app_member\` to share with others`;
+exports.createAppTool = {
+    name: 'create_app',
+    group: tool_registry_1.ToolGroup.PLAYGROUND,
+    description: createAppDescription,
+    schema: zod_1.z.object({
+        workspaceId: zod_1.z
+            .string()
+            .optional()
+            .describe("Optional workspace ID - defaults to current workspace"),
+        name: zod_1.z
+            .string()
+            .min(1)
+            .describe("App name (required)"),
+        description: zod_1.z
+            .string()
+            .optional()
+            .describe("App description"),
+        url: zod_1.z
+            .string()
+            .optional()
+            .describe("App URL (empty for published apps, localhost for dev)"),
+        image: zod_1.z
+            .string()
+            .optional()
+            .describe("Image/icon ID (24 characters)"),
+        config: zod_1.z
+            .record(zod_1.z.unknown())
+            .optional()
+            .describe("Optional app configuration"),
+    }),
+    async execute(args, context) {
+        logger.debug('Creating app', {
+            name: args.name,
+            workspaceId: args.workspaceId,
+            hasUrl: !!args.url,
+            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.app.create', {
+                workspaceId,
+                name: args.name
+            });
+            const appData = {
+                cid: workspaceId,
+                name: args.name
+            };
+            if (args.description)
+                appData.description = args.description;
+            if (args.url !== undefined)
+                appData.url = args.url;
+            if (args.image)
+                appData.image = args.image;
+            if (args.config)
+                appData.config = args.config;
+            const result = await context.hailer.request('v3.app.create', [appData]);
+            logger.debug('App creation successful', {
+                appId: result.appId || result._id
+            });
+            const appId = result.appId || result._id;
+            let responseText = `✅ **App Created Successfully**\n\n`;
+            responseText += `**App Name:** ${args.name}\n`;
+            responseText += `**App ID:** \`${appId}\`\n`;
+            responseText += `**Workspace:** ${workspaceId}\n`;
+            if (args.description) {
+                responseText += `**Description:** ${args.description}\n`;
+            }
+            if (args.url) {
+                responseText += `**URL:** ${args.url}\n`;
+                responseText += `**Type:** Development App (points to ${args.url})\n`;
+            }
+            else {
+                responseText += `**URL:** Auto-generated by Hailer\n`;
+                responseText += `**Type:** Published App\n`;
+            }
+            responseText += `\n💡 **Next Steps:**\n`;
+            responseText += `- Use \`list_apps\` to see all apps\n`;
+            responseText += `- Use \`add_app_member\` to share with users/teams\n`;
+            responseText += `- Use \`update_app\` to modify properties\n`;
+            if (!args.url) {
+                responseText += `\n📦 **Publishing:**\n`;
+                responseText += `1. Configure manifest.json with this appId: \`${appId}\`\n`;
+                responseText += `2. Run: \`EMAIL=your@email.com npm run publish-production\`\n`;
+            }
+            return {
+                content: [{
+                        type: "text",
+                        text: responseText,
+                    }],
+            };
+        }
+        catch (error) {
+            logger.error("Error creating 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 create apps. Only workspace administrators can create apps.\n\n**Error:** ${errorMessage}`,
+                        }],
+                };
+            }
+            return {
+                content: [{
+                        type: "text",
+                        text: `❌ **Error creating app**\n\n**Error:** ${errorMessage}\n\n**Common Issues:**\n- User must be workspace administrator\n- Invalid workspace ID\n- Image ID must be 24 characters if provided`,
+                    }],
+            };
+        }
+    }
+};
+// ============================================================================
+// LIST APPS TOOL
+// ============================================================================
+const listAppsDescription = `🧪 [PLAYGROUND] List Apps - View all apps in workspace
+
+**What it does**:
+Lists all Hailer apps in the current workspace that you have access to.
+
+**Example**:
+\`\`\`javascript
+list_apps()
+\`\`\`
+
+**Shows**:
+- App name and description
+- App ID
+- URL (localhost for dev, auto for published)
+- Creator and timestamps
+- Configuration
+
+**Use Cases**:
+- See all workspace apps
+- Find app IDs for updates
+- Check which apps are development vs published
+- Audit app configuration`;
+exports.listAppsTool = {
+    name: 'list_apps',
+    group: tool_registry_1.ToolGroup.PLAYGROUND,
+    description: listAppsDescription,
+    schema: zod_1.z.object({
+        workspaceId: zod_1.z
+            .string()
+            .optional()
+            .describe("Optional workspace ID - defaults to current workspace"),
+    }),
+    async execute(args, context) {
+        logger.debug('Listing apps', {
+            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 v3.app.list');
+            const result = await context.hailer.request('v3.app.list', [{}]);
+            // Handle multiple possible response structures:
+            // - { apps: [...] } - direct response
+            // - { details: { apps: [...] } } - wrapped in details
+            // - [...] - raw array
+            const apps = result?.apps || result?.details?.apps || (Array.isArray(result) ? result : []);
+            logger.debug('List apps successful', {
+                appCount: apps.length,
+                resultKeys: result ? Object.keys(result) : 'null'
+            });
+            let responseText = `✅ **Apps Retrieved**\n\n`;
+            responseText += `**Workspace:** ${workspaceId}\n\n`;
+            if (!apps || apps.length === 0) {
+                responseText += `**No apps found** in this workspace.\n\n`;
+                responseText += `💡 Use \`create_app\` to create your first app.`;
+                return {
+                    content: [{
+                            type: "text",
+                            text: responseText,
+                        }],
+                };
+            }
+            responseText += `**Total Apps:** ${apps.length}\n\n`;
+            apps.forEach((app) => {
+                responseText += `### ${app.name || 'Unnamed App'}\n`;
+                responseText += `- **App ID:** \`${app._id}\`\n`;
+                if (app.description) {
+                    responseText += `- **Description:** ${app.description}\n`;
+                }
+                if (app.url) {
+                    responseText += `- **URL:** ${app.url}\n`;
+                    responseText += `- **Type:** ${app.url.includes('localhost') ? 'Development' : 'Custom URL'}\n`;
+                }
+                else {
+                    responseText += `- **URL:** Auto-generated (Published App)\n`;
+                    responseText += `- **Type:** Published\n`;
+                }
+                if (app.created) {
+                    responseText += `- **Created:** ${new Date(app.created * 1000).toLocaleString()}\n`;
+                }
+                if (app.config && Object.keys(app.config).length > 0) {
+                    responseText += `- **Config:** Present\n`;
+                }
+                responseText += `\n`;
+            });
+            responseText += `💡 **Next Steps:**\n`;
+            responseText += `- Use \`update_app\` to modify an app\n`;
+            responseText += `- Use \`add_app_member\` to share apps\n`;
+            responseText += `- Use \`remove_app\` to delete apps`;
+            return {
+                content: [{
+                        type: "text",
+                        text: responseText,
+                    }],
+            };
+        }
+        catch (error) {
+            logger.error("Error listing apps", error);
+            const errorMessage = (0, tool_helpers_1.extractErrorMessage)(error);
+            return {
+                content: [{
+                        type: "text",
+                        text: `❌ **Error listing apps**\n\n**Error:** ${errorMessage}\n\n**Common Issues:**\n- Workspace not accessible\n- Permission issues`,
+                    }],
+            };
+        }
+    }
+};
+// ============================================================================
+// UPDATE APP TOOL
+// ============================================================================
+const updateAppDescription = `🧪 [PLAYGROUND] Update App - Modify app properties
+
+**What it does**:
+Updates an existing app's properties (name, description, URL, etc.).
+
+**Example - Update name and description**:
+\`\`\`javascript
+update_app({
+  appId: '<app-id>',
+  name: 'Updated App Name',
+  description: 'New description'
+})
+\`\`\`
+
+**Example - Change URL (dev to prod)**:
+\`\`\`javascript
+update_app({
+  appId: '<app-id>',
+  url: '' // Empty for published
+})
+\`\`\`
+
+**Updatable Properties**:
+- \`name\` - App display name
+- \`description\` - App description
+- \`url\` - App URL
+- \`image\` - App icon ID
+- \`config\` - App configuration
+
+**Requirements**:
+- User must be app creator or workspace admin
+
+**Tips**:
+- Only specified properties are updated
+- Use \`list_apps\` to get app IDs`;
+exports.updateAppTool = {
+    name: 'update_app',
+    group: tool_registry_1.ToolGroup.PLAYGROUND,
+    description: updateAppDescription,
+    schema: zod_1.z.object({
+        appId: zod_1.z
+            .string()
+            .min(1)
+            .describe("App ID to update"),
+        name: zod_1.z
+            .string()
+            .optional()
+            .describe("New app name"),
+        description: zod_1.z
+            .string()
+            .optional()
+            .describe("New description"),
+        url: zod_1.z
+            .string()
+            .optional()
+            .describe("New URL"),
+        image: zod_1.z
+            .string()
+            .optional()
+            .describe("New image ID"),
+        config: zod_1.z
+            .record(zod_1.z.unknown())
+            .optional()
+            .describe("New configuration"),
+    }),
+    async execute(args, context) {
+        logger.debug('Updating app', {
+            appId: args.appId,
+            apiKey: context.apiKey.substring(0, 8) + '...'
+        });
+        try {
+            const updateData = {};
+            if (args.name !== undefined)
+                updateData.name = args.name;
+            if (args.description !== undefined)
+                updateData.description = args.description;
+            if (args.url !== undefined)
+                updateData.url = args.url;
+            if (args.image !== undefined)
+                updateData.image = args.image;
+            if (args.config !== undefined)
+                updateData.config = args.config;
+            logger.debug('Calling v3.app.update', {
+                appId: args.appId,
+                updates: Object.keys(updateData)
+            });
+            await context.hailer.request('v3.app.update', [
+                args.appId,
+                updateData
+            ]);
+            logger.debug('App update successful');
+            let responseText = `✅ **App Updated Successfully**\n\n`;
+            responseText += `**App ID:** \`${args.appId}\`\n\n`;
+            responseText += `**Updated Properties:**\n`;
+            const updatedFields = [];
+            if (args.name)
+                updatedFields.push(`name → "${args.name}"`);
+            if (args.description)
+                updatedFields.push(`description → "${args.description}"`);
+            if (args.url !== undefined)
+                updatedFields.push(`url → "${args.url || 'auto-generated'}"`);
+            if (args.image)
+                updatedFields.push(`image → "${args.image}"`);
+            if (args.config)
+                updatedFields.push(`config (updated)`);
+            updatedFields.forEach(field => {
+                responseText += `- ${field}\n`;
+            });
+            responseText += `\n💡 Use \`list_apps\` to verify changes.`;
+            return {
+                content: [{
+                        type: "text",
+                        text: responseText,
+                    }],
+            };
+        }
+        catch (error) {
+            logger.error("Error updating app", error);
+            const errorMessage = (0, tool_helpers_1.extractErrorMessage)(error);
+            if (errorMessage.toLowerCase().includes('not found')) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `❌ **App Not Found**\n\nThe specified app doesn't exist.\n\n**App ID:** \`${args.appId}\`\n\n💡 Use \`list_apps\` to see available apps.`,
+                        }],
+                };
+            }
+            if (errorMessage.toLowerCase().includes('permission')) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `❌ **Permission Denied**\n\nYou don't have permission to update this app. Only app creator or workspace admin can update apps.\n\n**Error:** ${errorMessage}`,
+                        }],
+                };
+            }
+            return {
+                content: [{
+                        type: "text",
+                        text: `❌ **Error updating app**\n\n**Error:** ${errorMessage}\n\n**Common Issues:**\n- App ID invalid\n- Not app creator or admin\n- Invalid property values`,
+                    }],
+            };
+        }
+    }
+};
+// ============================================================================
+// REMOVE APP TOOL
+// ============================================================================
+const removeAppDescription = `🧪 [PLAYGROUND] Remove App - ⚠️ DANGER: Permanently deletes app entry from Hailer
+
+⚠️ **MANDATORY: GATHER COMPLETE CONTEXT BEFORE CALLING THIS TOOL**
+**BEFORE calling this tool, you are REQUIRED to:**
+1. Load the skill: \`get_skill({ skillName: "remove-app-skill" })\`
+2. Fetch app details with \`list_apps\` to get:
+   - App name and ID
+   - Workspace ID and name
+   - App type (development/published)
+   - App configuration
+3. Show comprehensive confirmation message including:
+   - Workspace ID and name
+   - App ID and name
+   - What will be deleted (entry, permissions, configuration)
+   - What won't be deleted (published code remains)
+   - Clear irreversibility warning
+4. Wait for explicit user confirmation
+**FAILURE TO GATHER AND SHOW THIS CONTEXT IS AN ERROR**
+
+**Required**: appId
+**Permission**: App creator or workspace administrator
+
+**What gets deleted**:
+- App entry (name, description, URL, metadata)
+- App permissions
+- App configuration
+
+**What doesn't get deleted**:
+- Published app code (remains on server)
+- App data (if any)
+
+**Example**:
+\`\`\`javascript
+remove_app({
+  appId: '<app-id>'
+})
+\`\`\`
+
+**Tips**:
+- Use \`list_apps\` to get app IDs
+- Published app code must be removed separately
+- Operation cannot be undone`;
+exports.removeAppTool = {
+    name: 'remove_app',
+    group: tool_registry_1.ToolGroup.NUCLEAR,
+    description: removeAppDescription,
+    schema: zod_1.z.object({
+        appId: zod_1.z
+            .string()
+            .min(1)
+            .describe("App ID to remove"),
+        confirmed: zod_1.z
+            .boolean()
+            .optional()
+            .describe("First confirmation - must be true to proceed"),
+        secondConfirmed: zod_1.z
+            .boolean()
+            .optional()
+            .describe("Second confirmation - must be true to proceed (required for double-check safety)"),
+    }),
+    async execute(args, context) {
+        logger.debug('Removing app', {
+            appId: args.appId,
+            confirmed: args.confirmed,
+            secondConfirmed: args.secondConfirmed,
+            apiKey: context.apiKey.substring(0, 8) + '...'
+        });
+        try {
+            // Fetch app info and workspace info
+            const [appListResult, initData] = await Promise.all([
+                context.hailer.request('v3.app.list', [{}]),
+                context.hailer.request('v2.core.init', [["network"]])
+            ]);
+            // Handle multiple possible response structures
+            const appsList = appListResult?.apps || appListResult?.details?.apps || (Array.isArray(appListResult) ? appListResult : []);
+            const app = appsList.find((a) => a._id === args.appId);
+            const appName = app?.name || 'Unknown';
+            const workspaceId = initData.network?._id || 'Unknown';
+            const workspaceName = initData.network?.name || 'Unknown';
+            // SAFETY CHECK: Require double confirmation
+            if (!args.confirmed || !args.secondConfirmed) {
+                let warningText = `⚠️ **DESTRUCTIVE OPERATION - CONFIRMATION REQUIRED**\n\n`;
+                warningText += `You are about to **permanently delete** the following:\n\n`;
+                warningText += `**App:** ${appName}\n`;
+                warningText += `**App ID:** \`${args.appId}\`\n`;
+                warningText += `**Workspace:** ${workspaceName} (\`${workspaceId}\`)\n\n`;
+                warningText += `**⚠️ This will permanently delete:**\n`;
+                warningText += `- App entry (name, description, URL)\n`;
+                warningText += `- App permissions\n`;
+                warningText += `- App configuration\n\n`;
+                warningText += `**🚨 THIS CANNOT BE UNDONE! 🚨**\n\n`;
+                warningText += `**To proceed, you must:**\n`;
+                warningText += `1. Review the \`remove-app-skill\` (REQUIRED)\n`;
+                warningText += `2. Call this tool again with BOTH confirmations:\n\n`;
+                warningText += `\`\`\`javascript\n`;
+                warningText += `remove_app({\n`;
+                warningText += `  appId: "${args.appId}",\n`;
+                warningText += `  confirmed: true,\n`;
+                warningText += `  secondConfirmed: true\n`;
+                warningText += `})\n`;
+                warningText += `\`\`\`\n\n`;
+                warningText += `💡 **Before proceeding:**\n`;
+                warningText += `- Load \`remove-app-skill\` to review safety checklist\n`;
+                warningText += `- Verify with user that this is intentional\n`;
+                warningText += `- Note: Published app code remains on server`;
+                return {
+                    content: [{
+                            type: "text",
+                            text: warningText,
+                        }],
+                };
+            }
+            logger.debug('Calling v3.app.remove', {
+                appId: args.appId,
+                appName,
+                workspaceId,
+                workspaceName
+            });
+            await context.hailer.request('v3.app.remove', [args.appId]);
+            logger.debug('App removal successful', {
+                appId: args.appId,
+                appName
+            });
+            let responseText = `✅ **App Removed Successfully**\n\n`;
+            responseText += `**App:** ${appName}\n`;
+            responseText += `**App ID:** \`${args.appId}\`\n`;
+            responseText += `**Workspace:** ${workspaceName} (\`${workspaceId}\`)\n\n`;
+            responseText += `⚠️ **The app entry has been permanently deleted.**\n\n`;
+            responseText += `**What was deleted:**\n`;
+            responseText += `- App entry (name, description, URL)\n`;
+            responseText += `- App permissions\n`;
+            responseText += `- App configuration\n\n`;
+            responseText += `**Note:** Published app code remains on server (if applicable).\n\n`;
+            responseText += `💡 Use \`list_apps\` to see remaining apps.`;
+            return {
+                content: [{
+                        type: "text",
+                        text: responseText,
+                    }],
+            };
+        }
+        catch (error) {
+            logger.error("Error removing app", error);
+            const errorMessage = (0, tool_helpers_1.extractErrorMessage)(error);
+            if (errorMessage.toLowerCase().includes('not found')) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `❌ **App Not Found**\n\nThe specified app doesn't exist or has already been deleted.\n\n**App ID:** \`${args.appId}\`\n\n💡 Use \`list_apps\` to see available apps.`,
+                        }],
+                };
+            }
+            if (errorMessage.toLowerCase().includes('permission')) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `❌ **Permission Denied**\n\nYou don't have permission to remove this app. Only app creator or workspace admin can delete apps.\n\n**Error:** ${errorMessage}`,
+                        }],
+                };
+            }
+            return {
+                content: [{
+                        type: "text",
+                        text: `❌ **Error removing app**\n\n**Error:** ${errorMessage}\n\n**Common Issues:**\n- App ID invalid\n- App already deleted\n- Not app creator or admin`,
+                    }],
+            };
+        }
+    }
+};
+//# sourceMappingURL=app-core.js.map

package/dist/mcp/tools/app-marketplace.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 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
+ */
+import { Tool } from '../tool-registry';
+export declare const listTemplatesTool: Tool;
+export declare const createTemplateTool: Tool;
+export declare const installTemplateTool: Tool;
+export declare const getTemplateTool: Tool;
+export declare const publishTemplateTool: Tool;
+export declare const getProductTool: Tool;
+export declare const getProductManifestTool: Tool;
+export declare const publishAppTool: Tool;
+export declare const installMarketplaceAppTool: Tool;
+//# sourceMappingURL=app-marketplace.d.ts.map