snow-flow 4.5.22 → 4.5.24

package/CLAUDE.md

@@ -655,11 +655,15 @@ Snow-Flow now automatically sets its Update Set as the user's current Update Set
 - `snow_import_flow_from_xml` - Import flows from XML (only programmatic creation method)
 
 **Agent Workspace Tools:**
-- `snow_create_workspace` - Create agent workspace configurations
-- `snow_create_workspace_tab` - Add custom workspace tabs
-- `snow_create_contextual_panel` - Add contextual side panels
+- `snow_create_workspace` - Create agent workspace configurations (uses sys_aw_master_config)
+- `snow_create_workspace_tab` - **DEPRECATED:** Modern workspaces use UX pages
+- `snow_create_contextual_panel` - **DEPRECATED:** Modern workspaces use UX components  
 - `snow_discover_workspaces` - Find all workspace configurations
 
+**⚠️ IMPORTANT:** Modern ServiceNow Agent Workspaces use **UX Pages (sys_ux_*)** for configuration, not legacy sys_aw_* tables. Use UI Builder tools instead:
+- **Workspace tabs** → Use `snow_add_uib_page_element` with UX page components
+- **Contextual panels** → Use UI Builder component library with data brokers
+
 **Mobile App Tools:**
 - `snow_configure_mobile_app` - Configure mobile applications
 - `snow_send_push_notification` - Send push notifications

package/dist/mcp/servicenow-flow-workspace-mobile-mcp.js

@@ -1281,19 +1281,34 @@ ${executionList}
                     suggestion: 'Install Agent Workspace plugin: System Applications → All Available Applications → Search for "Agent Workspace"'
                 };
             }
+            // Fix from user feedback: Add ALL required fields for workspace creation
+            const workspaceUrl = this.generateWorkspaceUrl(args.name);
             const workspaceData = {
                 name: args.name,
                 description: args.description || '',
+                active: true,
+                // CRITICAL: Add missing required fields
+                workspace_url: workspaceUrl,
+                navigation_type: 'tab',
+                search_enabled: true,
+                notifications_enabled: true,
+                user_preference_controls_enabled: true,
+                // Add default colors for branding
+                primary_color: '#1F8476',
+                brand_color: '#2FC2B0',
+                // These will be updated after search config creation
+                global_search: '',
+                global_search_data: '',
+                // Optional fields with defaults
                 tables: args.tables ? args.tables.join(',') : '',
                 home_page: args.home_page || '',
                 theme: args.theme || 'default',
-                roles: args.roles ? args.roles.join(',') : '',
-                active: true
+                roles: args.roles ? args.roles.join(',') : ''
             };
             this.logger.trackAPICall('CREATE', 'sys_aw_master_config', 1);
             const response = await this.client.createRecord('sys_aw_master_config', workspaceData);
             if (!response.success) {
-                // Provide specific error guidance
+                // Enhanced error handling with required fields info
                 if (response.error?.includes('403') || response.error?.includes('Forbidden')) {
                     return {
                         success: false,
@@ -1304,12 +1319,43 @@ ${executionList}
                 if (response.error?.includes('400') || response.error?.includes('Bad Request')) {
                     return {
                         success: false,
-                        error: 'Invalid workspace configuration. Agent Workspace may not be properly configured in this instance.',
-                        suggestion: 'Verify Agent Workspace is enabled and configured. Check System Properties > Agent Workspace settings.'
+                        error: 'Invalid workspace configuration. Missing required fields detected.',
+                        suggestion: 'Verify all required fields: workspace_url, navigation_type, search settings.',
+                        remediation: 'Check ServiceNow Agent Workspace documentation for required field specifications'
                     };
                 }
                 throw new Error(`Failed to create workspace: ${response.error}`);
             }
+            const workspaceId = response.data.sys_id;
+            // Fix from user feedback: Create global search config and update workspace
+            try {
+                const searchConfig = await this.client.createRecord('sys_aw_global_search_config', {
+                    name: `${args.name} Search`,
+                    workspace: workspaceId,
+                    active: true
+                });
+                if (searchConfig.success && searchConfig.data.sys_id) {
+                    // Update workspace with search config references
+                    await this.client.updateRecord('sys_aw_master_config', workspaceId, {
+                        global_search: searchConfig.data.sys_id,
+                        global_search_data: searchConfig.data.sys_id
+                    });
+                }
+            }
+            catch (searchError) {
+                this.logger.warn('Could not create search config, workspace created without search:', searchError);
+            }
+            // UPDATED: Modern workspace tab creation guidance
+            let tabsCreated = 0;
+            let modernWorkspaceNote = '';
+            if (args.tables && args.tables.length > 0) {
+                modernWorkspaceNote = `\n\n📋 **Tab Configuration Required:**\nModern Agent Workspaces use UX Pages for tabs. Configure tabs through:\n`;
+                for (const table of args.tables) {
+                    const tabLabel = table.replace(/_/g, ' ').replace(/\b\w/g, (l) => l.toUpperCase());
+                    modernWorkspaceNote += `\n• **${tabLabel}**: Use snow_add_uib_page_element to add ${table} components`;
+                }
+                modernWorkspaceNote += `\n\n💡 **Modern Approach:**\n1. Use snow_create_uib_page for custom workspace pages\n2. Use snow_add_uib_page_element to add table components\n3. Use snow_create_uib_data_broker for data connections`;
+            }
             return {
                 content: [{
                         type: 'text',
@@ -2871,6 +2917,37 @@ ${configList}${layoutsText}${offlineText}
             throw error;
         }
     }
+    /**
+     * Generate valid workspace URL from name (fix from user feedback)
+     */
+    generateWorkspaceUrl(name) {
+        return name
+            .toLowerCase()
+            .trim()
+            .replace(/\s+/g, '-') // Spaces -> hyphens
+            .replace(/[^a-z0-9-]/g, '') // Remove special characters
+            .replace(/--+/g, '-') // Multiple hyphens -> single
+            .replace(/^-|-$/g, '') // Trim leading/trailing hyphens
+            .substring(0, 80); // Max 80 chars (ServiceNow field limit)
+    }
+    /**
+     * Validate workspace configuration (fix from user feedback)
+     */
+    validateWorkspaceConfig(config) {
+        const errors = [];
+        // Check required fields
+        if (!config.name)
+            errors.push('name is required');
+        if (!config.workspace_url)
+            errors.push('workspace_url is required');
+        if (!config.navigation_type)
+            errors.push('navigation_type is required');
+        // Validate workspace_url format
+        if (config.workspace_url && !/^[a-z0-9-]+$/.test(config.workspace_url)) {
+            errors.push('workspace_url must contain only lowercase letters, numbers and hyphens');
+        }
+        return errors;
+    }
     async run() {
         const transport = new stdio_js_1.StdioServerTransport();
         await this.server.connect(transport);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "snow-flow",
-  "version": "4.5.22",
+  "version": "4.5.24",
   "description": "Conversational ServiceNow development platform using Claude Code. Multi-agent orchestration with 20+ MCP servers providing 200+ ServiceNow tools for comprehensive platform development.",
   "main": "dist/index.js",
   "type": "commonjs",