@hailer/mcp 0.1.6 → 0.1.9

package/dist/mcp/UserContextCache.js

@@ -95,7 +95,7 @@ class UserContextCache {
      * Separated from getContext to support Promise memoization.
      */
     static async createContextInternal(apiKey) {
-        logger.info('Creating new user context', { apiKey: apiKey.substring(0, 8) + '...' });
+        logger.debug('Creating new user context', { apiKey: apiKey.substring(0, 8) + '...' });
         try {
             // Create client connection (uses existing connection pool)
             const client = await (0, hailer_clients_1.createHailerClientByApiKey)(apiKey);
@@ -124,7 +124,7 @@ class UserContextCache {
             const rawInitSize = Buffer.byteLength(JSON.stringify(init), 'utf8');
             const workspaceCacheSize = Buffer.byteLength(JSON.stringify(workspaceCache), 'utf8');
             const totalContextSize = Buffer.byteLength(JSON.stringify({ init, workspaceCache }), 'utf8');
-            logger.info('User context created and cached', {
+            logger.debug('User context created and cached', {
                 apiKey: apiKey.substring(0, 8) + '...',
                 workflowCount: init.processes?.length || 0,
                 userCount: workspaceCache.users.length,

package/dist/mcp/hailer-clients.js

@@ -20,7 +20,7 @@ async function getCurrentUserId(client) {
         ]));
         // Check if there's a user field (this is the current authenticated user)
         if (init.user && init.user._id) {
-            logger.info('Retrieved user ID from init', { userId: init.user._id });
+            logger.debug('Retrieved user ID from init', { userId: init.user._id });
             return init.user._id;
         }
         // Fallback: Try with different parameters if the above doesn't work
@@ -33,7 +33,7 @@ async function getCurrentUserId(client) {
             if (profileResponse.ok) {
                 const profile = (await profileResponse.json());
                 if (profile && profile._id) {
-                    logger.info('Retrieved user ID from profile endpoint', { userId: profile._id });
+                    logger.debug('Retrieved user ID from profile endpoint', { userId: profile._id });
                     return profile._id;
                 }
             }
@@ -52,7 +52,7 @@ async function getCurrentUserId(client) {
                 const member = members[0];
                 const userId = member.uid || member._id || member.id;
                 if (userId) {
-                    logger.info('Inferred user ID from single workspace member', { userId });
+                    logger.debug('Inferred user ID from single workspace member', { userId });
                     return userId;
                 }
             }
@@ -205,7 +205,7 @@ const createHailerClientByApiKey = async (apiKey) => {
     // Check if we have an existing connection
     let clientManager = connectionPool.get(connectionKey);
     if (clientManager && clientManager.isConnected()) {
-        logger.info('Reusing existing connection', {
+        logger.debug('Reusing existing connection', {
             apiKey: apiKey.substring(0, 8) + '...',
             email: account.email
         });
@@ -213,7 +213,7 @@ const createHailerClientByApiKey = async (apiKey) => {
     }
     // Clear any stale connection
     if (clientManager) {
-        logger.info('Cleaning up stale connection', {
+        logger.debug('Cleaning up stale connection', {
             apiKey: apiKey.substring(0, 8) + '...',
             email: account.email
         });

package/dist/mcp/signal-handler.js

@@ -24,11 +24,34 @@ class SignalHandler {
     handleIncomingSignal(rawSignal) {
         try {
             const [eventType, eventData] = rawSignal;
+            // Extract workspaceId from signal data (sid) - required for multi-workspace isolation
+            // Falls back to currentWorkspace only if signal doesn't include workspace info
+            const signalWorkspaceId = eventData.sid;
+            const workspaceId = signalWorkspaceId || this.workspaceCache?.currentWorkspace._id;
+            // Log if workspace mismatch detected (signal from different workspace)
+            if (signalWorkspaceId && this.workspaceCache?.currentWorkspace._id &&
+                signalWorkspaceId !== this.workspaceCache.currentWorkspace._id) {
+                logger.debug('Signal from different workspace', {
+                    signalType: eventType,
+                    signalWorkspaceId,
+                    currentWorkspaceId: this.workspaceCache.currentWorkspace._id,
+                });
+            }
+            // Debug: log raw signal data to discover available fields
+            if (eventType === 'messenger.new') {
+                const data = eventData;
+                logger.debug('Raw messenger.new signal data', {
+                    eventType,
+                    dataKeys: Object.keys(eventData),
+                    sid: String(data.sid || ''),
+                    workspaceId: String(data.workspaceId || ''),
+                });
+            }
             const signal = {
                 type: eventType,
                 data: eventData,
                 timestamp: Date.now(),
-                workspaceId: this.workspaceCache?.currentWorkspace._id,
+                workspaceId,
             };
             // Add to history
             this.addToHistory(signal);
@@ -134,14 +157,13 @@ class SignalHandler {
             logger.debug('No workspace cache available, skipping cache invalidation');
             return;
         }
-        const meta = signal.data || {};
         logger.debug('Cache invalidate signal received', {
             workspaceId: signal.workspaceId,
-            meta
+            meta: signal.data
         });
         try {
-            // Refresh cache by fetching fresh data - pass meta to let backend decide what to return
-            const init = await this.client.socket.request('v2.core.init', [meta]);
+            // Refresh cache by fetching fresh data - API requires array of keys to fetch
+            const init = await this.client.socket.request('v2.core.init', [['users', 'network', 'networks']]);
             // Update workspace cache with fresh data
             if (init.processes) {
                 this.workspaceCache.rawInit.processes = init.processes;

package/dist/mcp/tools/activity.js

@@ -318,21 +318,74 @@ function buildActivityUpdate(args, context) {
             throw new Error(`Invalid fields JSON: ${args.fields}`);
         }
     }
-    if (parsedFields &&
-        typeof parsedFields === "object" &&
-        context.workspaceCache) {
+    // Auto-fix activitylink fields: if LLM passes an object instead of just the ID string
+    if (parsedFields && typeof parsedFields === "object") {
+        for (const [fieldId, fieldValue] of Object.entries(parsedFields)) {
+            if (fieldValue && typeof fieldValue === "object" && !Array.isArray(fieldValue)) {
+                const obj = fieldValue;
+                let extractedId = null;
+                // Case 1: {type: "activitylink", value: {_id: "...", name: "..."}}
+                if (obj.type && obj.value && typeof obj.value === "object" && obj.value._id) {
+                    extractedId = obj.value._id;
+                }
+                // Case 2: {_id: "...", name: "..."}
+                else if (obj._id && typeof obj._id === "string") {
+                    extractedId = obj._id;
+                }
+                // Case 3: {value: "..."} where value is the ID string
+                else if (obj.value && typeof obj.value === "string" && /^[a-f0-9]{24}$/i.test(obj.value)) {
+                    extractedId = obj.value;
+                }
+                if (extractedId) {
+                    logger.warn("Auto-fixing activitylink field - extracting ID from object", {
+                        fieldId,
+                        original: JSON.stringify(fieldValue),
+                        extracted: extractedId,
+                    });
+                    parsedFields[fieldId] = extractedId;
+                }
+            }
+        }
+    }
+    // Field-type aware validation: only validate user fields as users
+    if (parsedFields && typeof parsedFields === "object" && context.workspaceCache) {
         const invalidUsers = [];
         for (const [fieldId, fieldValue] of Object.entries(parsedFields)) {
-            if (typeof fieldValue === "string" &&
-                /^[a-f0-9]{24}$/i.test(fieldValue)) {
+            // Only check string values that look like IDs
+            if (typeof fieldValue !== "string" || !/^[a-f0-9]{24}$/i.test(fieldValue)) {
+                continue;
+            }
+            // Find the field definition to check its type
+            let fieldType;
+            for (const workflow of context.workspaceCache.rawInit.processes) {
+                const workflowFields = workflow.fields;
+                if (!workflowFields)
+                    continue;
+                // Handle both array and object formats for fields
+                let field;
+                if (Array.isArray(workflowFields)) {
+                    field = workflowFields.find((f) => f._id === fieldId || f.id === fieldId);
+                }
+                else if (typeof workflowFields === 'object') {
+                    // Fields as object: { fieldId: fieldData, ... }
+                    field = workflowFields[fieldId];
+                }
+                if (field) {
+                    fieldType = field.type;
+                    break;
+                }
+            }
+            // Only validate as user ID if the field type is 'user'
+            if (fieldType === 'user') {
                 const user = (0, workspace_cache_1.getUserById)(context.workspaceCache, fieldValue);
                 if (!user) {
                     invalidUsers.push(`${fieldId}: ${fieldValue}`);
                 }
             }
+            // Skip validation for 'activitylink' and other field types
         }
         if (invalidUsers.length > 0) {
-            throw new Error(`Invalid user IDs in fields: ${invalidUsers.join(", ")}. Use search_workspace_users to find valid user IDs.`);
+            throw new Error(`Invalid user IDs in user fields: ${invalidUsers.join(", ")}. Use search_workspace_users to find valid user IDs.`);
         }
     }
     return {
@@ -369,7 +422,7 @@ function formatUpdateActivityResponse(args, result) {
 exports.listActivitiesTool = {
     name: 'list_activities',
     group: tool_registry_1.ToolGroup.READ,
-    description: `📋 Retrieves list of activities for a specific workflow phase. ⚠️ CRITICAL: phaseId is MANDATORY string parameter, must match workflow's current phase. ✅ CORRECT: {"workflowId":"6756e099410306cab03a7dfb","phaseId":"specific_phase_identifier"} ❌ WRONG: {"workflowId":"6756e099410306cab03a7dfb"} (missing required phaseId)`,
+    description: `List activities from workflow phase`,
     schema: zod_1.z.object({
         workflowId: zod_1.z.string().describe("Workflow ID to list activities from"),
         phaseId: zod_1.z.string().describe("Phase ID to filter activities (required - use list_workflow_phases to get available phases)"),
@@ -399,7 +452,7 @@ exports.listActivitiesTool = {
             value: zod_1.z.union([zod_1.z.string(), zod_1.z.number()]).optional().describe("Value to filter by - REQUIRED for text_search, equals, not_equals, contains, greater_than, less_than operators. NOT USED for range operator (use start/end instead). For text_search: use the text/name to search for. For equals: use the entity ID."),
             start: zod_1.z.coerce.number().optional().describe("Start value - ONLY for range operator (NOT in 'value' field). Unix timestamp in milliseconds for date ranges. Example: for June 2025 date range, use start=1717200000000 directly here, NOT nested in 'value'."),
             end: zod_1.z.coerce.number().optional().describe("End value - ONLY for range operator (NOT in 'value' field). Unix timestamp in milliseconds for date ranges. Example: for June 2025 date range, use end=1719791999000 directly here, NOT nested in 'value'."),
-        })).optional().describe("Field-based filters - PREFERRED over search parameter for reliable results. Key is the field ID from get_workflow_schema. CRITICAL: For range operator, use 'start' and 'end' as direct properties, NOT nested inside 'value'. Example: {fieldId: {operator: 'range', start: 1717200000000, end: 1719791999000}}. BEST use cases: 1) Date ranges: use range operator with created/updated field IDs, 2) Company/site by NAME: use text_search operator, 3) Exact ID matches: use equals operator."),
+        })).optional().describe("Filter by field values. STRUCTURE: {\"fieldId\": {\"operator\": \"...\", \"value\": \"...\"}}. EXAMPLE: To find player named 'Harry Kane', use: {\"691ffdf84217e9e8434e5694\": {\"operator\": \"text_search\", \"value\": \"Harry Kane\"}}. WRONG: {\"playerName\": \"Harry Kane\"} or {\"fieldId\": \"Harry Kane\"}. Operators: text_search (partial text match), equals (exact ID match), range (use start/end instead of value)."),
         search: zod_1.z.string().optional().describe("Text search across activity content - USE FILTERS INSTEAD when possible for reliable results. Only use search for truly exploratory queries."),
         limit: zod_1.z.coerce.number().optional().default(50).describe("Maximum number of activities to return (default: 50, max: 20000)"),
         page: zod_1.z.coerce.number().optional().default(0).describe("Page number for pagination (0-based)"),
@@ -500,7 +553,7 @@ exports.listActivitiesTool = {
 exports.showActivityByIdTool = {
     name: 'show_activity_by_id',
     group: tool_registry_1.ToolGroup.READ,
-    description: `📄 Load specific activity by ID with full details`,
+    description: `Get activity by ID`,
     schema: zod_1.z.object({
         activityId: zod_1.z.string().describe("Activity ID to load"),
     }),
@@ -535,33 +588,7 @@ exports.showActivityByIdTool = {
 // ============================================================================
 // TOOL 3: CREATE ACTIVITY
 // ============================================================================
-const createActivityDescription = `Create one or multiple activities - Supports both single and bulk creation
-
-**BULK CREATION (3+ activities):**
-Use the 'activities' parameter to create multiple activities efficiently:
-- activities: [{ name, fields, phaseId }, { name, fields, phaseId }, ...]
-- All activities created in one API call
-- Much faster for creating 10, 50, or 100+ activities
-- Recommended for sample data generation and batch imports
-
-**SINGLE CREATION:**
-Use individual parameters (name, fields, phaseId) for creating one activity
-
-**IMPORTANT - Field Type Rules:**
-- textpredefinedoptions: MUST be a single STRING value (e.g., "Option1"), NOT an array
-- activitylink: MUST be a STRING (activity ID), NOT an array
-- users/teams: STRING user/team ID
-- numeric/date: NUMBER (timestamp for dates)
-- text/textarea: STRING
-
-**Field Keys vs Field IDs:**
-If workflow uses field 'key' (recommended), you can use readable names:
-- With keys: { "vendor": "activity-id", "priority": "High" }
-- Without keys: { "507f191e810c19729de860ea": "activity-id" }
-
-**Examples:**
-Single: { workflowId, name: "Customer Lead", fields: { customerName: "John" } }
-Bulk: { workflowId, activities: [{ name: "Lead 1", fields: {...} }, { name: "Lead 2", fields: {...} }] }`;
+const createActivityDescription = `Create activity (single or bulk via activities array)`;
 exports.createActivityTool = {
     name: 'create_activity',
     group: tool_registry_1.ToolGroup.WRITE,
@@ -835,31 +862,7 @@ ${createdActivities.slice(0, 10).map((act, idx) => `${idx + 1}. "${act.name}" (I
 // ============================================================================
 // TOOL 4: UPDATE ACTIVITY
 // ============================================================================
-const updateActivityDescription = `Update one or multiple activities in any Hailer workflow
-
-**BULK UPDATE (3+ activities):**
-Use the 'activities' parameter to update multiple activities efficiently:
-- activities: [{ _id, name?, fields? }, { _id, name?, fields? }, ...]
-- All activities updated in one API call
-- Much faster for updating 10, 50, or 100+ activities
-- Recommended for batch operations and data migrations
-
-**SINGLE UPDATE:**
-Use individual parameters (_id or activityId, name, fields, phaseId) for updating one activity
-
-**IMPORTANT - ActivityLink Field Values:**
-When updating activitylink fields, use STRING values (the activity ID to link to), NOT arrays:
-- ✅ Correct: { "vendorField": "507f1f77bcf86cd799439011" }
-- ❌ Wrong: { "vendorField": ["507f1f77bcf86cd799439011"] }
-
-**Field Keys vs Field IDs:**
-If workflow uses field 'key' (recommended), you can use readable names:
-- With keys: { "vendor": "new-activity-id", "priority": "High" }
-- Without keys: { "507f191e810c19729de860ea": "new-activity-id" }
-
-**Examples:**
-Single: update_activity({ activityId: "xxx", fields: { status: "Active" } })
-Bulk: update_activity({ activities: [{ _id: "xxx", fields: { status: "Active" } }, { _id: "yyy", fields: { status: "Inactive" } }] })`;
+const updateActivityDescription = `Update activity (single or bulk via activities array)`;
 exports.updateActivityTool = {
     name: 'update_activity',
     group: tool_registry_1.ToolGroup.WRITE,
@@ -876,7 +879,7 @@ exports.updateActivityTool = {
         }))
             .min(1))
             .optional()
-            .describe("BULK: Array of activities to update. Use this for updating 3+ activities efficiently. If provided, single activity parameters (activityId, name, fields) are ignored."),
+            .describe("BULK: Array of activities to update. Each object MUST have: '_id' (NOT 'activityId'), and optionally 'fields' (NOT 'fieldsAndValues'). ❌ WRONG: {activityId: 'x', fieldsAndValues: {...}} ✅ CORRECT: {_id: 'x', fields: {...}}"),
         // SINGLE: Individual activity parameters
         activityId: zod_1.z
             .string()
@@ -887,7 +890,7 @@ exports.updateActivityTool = {
         fields: zod_1.z
             .union([zod_1.z.record(zod_1.z.any()), zod_1.z.string()])
             .optional()
-            .describe("SINGLE: Updated field values as key-value pairs. IMPORTANT: activitylink values must be STRINGS (activity IDs), not arrays. Example: { 'vendor': 'activity-id-string', 'priority': 'High' }. Can be object or JSON string"),
+            .describe("SINGLE: Updated field values as key-value pairs. CRITICAL for activitylink fields: pass ONLY the activity ID as a plain STRING, NOT an object! ❌ WRONG: {'fieldId': {'_id': 'abc', 'name': 'X'}} ✅ CORRECT: {'fieldId': 'abc123...'}. Example: { '691fff...': '691ffe...' } for linking to another activity. Can be object or JSON string."),
         phaseId: zod_1.z
             .string()
             .optional()
@@ -897,7 +900,35 @@ exports.updateActivityTool = {
         try {
             // BULK MODE: Update multiple activities
             if (args.activities && Array.isArray(args.activities)) {
-                logger.debug("Bulk update mode", { activityCount: args.activities.length });
+                logger.debug("Bulk update mode", {
+                    activityCount: args.activities.length,
+                    activities: JSON.stringify(args.activities, null, 2)
+                });
+                // Auto-fix common parameter name mistakes
+                for (const activity of args.activities) {
+                    // Fix activityId -> _id
+                    if (!activity._id && activity.activityId) {
+                        logger.warn("Auto-fixing: activityId -> _id", { activityId: activity.activityId });
+                        activity._id = activity.activityId;
+                        delete activity.activityId;
+                    }
+                    // Fix fieldsAndValues -> fields
+                    if (!activity.fields && activity.fieldsAndValues) {
+                        logger.warn("Auto-fixing: fieldsAndValues -> fields", { activityId: activity._id });
+                        activity.fields = activity.fieldsAndValues;
+                        delete activity.fieldsAndValues;
+                    }
+                }
+                // Validate that all activities have _id
+                const invalidActivities = args.activities.filter((a) => !a._id || typeof a._id !== 'string' || a._id.length < 24);
+                if (invalidActivities.length > 0) {
+                    return {
+                        content: [{
+                                type: "text",
+                                text: `❌ **Error: Invalid bulk update request**\n\nEach activity in the "activities" array MUST have a valid "_id" field (24-character activity ID).\n\n**What you sent:** ${JSON.stringify(args.activities, null, 2)}\n\n**Correct format:**\n\`\`\`json\n{\n  "activities": [\n    { "_id": "691ffe654217e9e8434e577c", "fields": { "fieldId": "value" } },\n    { "_id": "691ffe654217e9e8434e5774", "name": "New Name" }\n  ]\n}\n\`\`\`\n\n**Tip:** First use list_activities to get the activity IDs, then pass them in the _id field.`,
+                            }],
+                    };
+                }
                 // Build updates for each activity
                 const updates = args.activities.map((activity) => {
                     const activityUpdate = { _id: activity._id };
@@ -905,9 +936,26 @@ exports.updateActivityTool = {
                         activityUpdate.name = activity.name;
                     if (activity.fields) {
                         // Parse fields if string
-                        const parsedFields = typeof activity.fields === 'string'
+                        let parsedFields = typeof activity.fields === 'string'
                             ? JSON.parse(activity.fields)
                             : activity.fields;
+                        // Auto-fix activitylink fields: if LLM passes object with _id, extract just the ID
+                        if (parsedFields && typeof parsedFields === "object") {
+                            for (const [fieldId, fieldValue] of Object.entries(parsedFields)) {
+                                if (fieldValue &&
+                                    typeof fieldValue === "object" &&
+                                    !Array.isArray(fieldValue) &&
+                                    "_id" in fieldValue &&
+                                    typeof fieldValue._id === "string") {
+                                    logger.warn("Auto-fixing activitylink field in bulk mode", {
+                                        activityId: activity._id,
+                                        fieldId,
+                                        extracted: fieldValue._id,
+                                    });
+                                    parsedFields[fieldId] = fieldValue._id;
+                                }
+                            }
+                        }
                         activityUpdate.fields = parsedFields;
                     }
                     return activityUpdate;
@@ -931,6 +979,30 @@ exports.updateActivityTool = {
                 };
             }
             // SINGLE MODE: Update one activity
+            // Validate activityId is provided for single mode
+            if (!args.activityId || typeof args.activityId !== 'string' || args.activityId.length < 24) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `❌ **Error: Missing or invalid activityId**\n\nFor single activity updates, you must provide a valid "activityId" (24-character hex string).\n\n**What you sent:** activityId = ${JSON.stringify(args.activityId)}\n\n**Correct format:**\n\`\`\`json\n{\n  "activityId": "691ffe654217e9e8434e577c",\n  "name": "New Name",\n  "fields": { "fieldId": "value" }\n}\n\`\`\`\n\n**For bulk updates (3+ activities), use:**\n\`\`\`json\n{\n  "activities": [\n    { "_id": "activity-id-1", "fields": {...} },\n    { "_id": "activity-id-2", "name": "New Name" }\n  ]\n}\n\`\`\`\n\n**Tip:** Use list_activities or show_activity_by_id to find activity IDs first.`,
+                        }],
+                };
+            }
+            // Validate that at least one update field is provided
+            if (!args.name && !args.fields && !args.phaseId) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `❌ **Error: No update data provided**\n\nYou called update_activity with activityId="${args.activityId}" but didn't provide any data to update.\n\n**You must provide at least one of:**\n- "name" - to update the activity name\n- "fields" - to update field values\n- "phaseId" - to move to a different phase\n\n**Example:**\n\`\`\`json\n{\n  "activityId": "${args.activityId}",\n  "fields": {\n    "fieldId123": "new value"\n  }\n}\n\`\`\``,
+                        }],
+                };
+            }
+            logger.debug("Single update mode", {
+                activityId: args.activityId,
+                name: args.name,
+                fields: JSON.stringify(args.fields, null, 2),
+                phaseId: args.phaseId
+            });
             const updates = buildActivityUpdate(args, context);
             const options = args.phaseId ? { phaseId: args.phaseId } : undefined;
             const result = await context.hailer.updateActivities([updates], options);

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

@@ -18,47 +18,7 @@ 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`;
+const createAppDescription = `Create Hailer app entry in workspace`;
 exports.createAppTool = {
     name: 'create_app',
     group: tool_registry_1.ToolGroup.PLAYGROUND,
@@ -176,28 +136,7 @@ exports.createAppTool = {
 // ============================================================================
 // 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`;
+const listAppsDescription = `List all apps in workspace`;
 exports.listAppsTool = {
     name: 'list_apps',
     group: tool_registry_1.ToolGroup.PLAYGROUND,
@@ -290,41 +229,7 @@ exports.listAppsTool = {
 // ============================================================================
 // 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`;
+const updateAppDescription = `Update app properties`;
 exports.updateAppTool = {
     name: 'update_app',
     group: tool_registry_1.ToolGroup.PLAYGROUND,
@@ -437,48 +342,7 @@ exports.updateAppTool = {
 // ============================================================================
 // 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`;
+const removeAppDescription = `Delete app permanently`;
 exports.removeAppTool = {
     name: 'remove_app',
     group: tool_registry_1.ToolGroup.NUCLEAR,