snow-flow 4.5.26 → 4.5.28

package/CLAUDE.md

@@ -94,6 +94,11 @@ User: "Create agent workspace"
 3. **User says "Custom script for Z"** → Scripts are appropriate
 4. **User says "Check/verify/test"** → Scripts for verification are good
 
+**🎯 Workspace Feature Development:**
+- **"Create workspace list"** → Use `snow_create_uib_component` (list component) + `snow_create_uib_data_broker`
+- **"Add workspace tab"** → Use `snow_create_uib_page` + `snow_add_uib_page_element`
+- **"Configure workspace panel"** → Use `snow_create_uib_component` + `snow_add_uib_page_element`
+
 ### The Verification-First Approach
 
 ```javascript
@@ -655,14 +660,13 @@ 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 (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_create_workspace` - Create agent workspace configurations (uses sys_aw_master_config with all required fields)
 - `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
+**⚠️ MODERN APPROACH:** For workspace tabs and panels, use **UI Builder tools** with correct table structure:
+- **Workspace pages** → `snow_create_uib_page` (creates sys_ux_page + sys_ux_page_registry)
+- **Workspace components** → `snow_add_uib_page_element` (adds to sys_ux_page via sys_ux_page_element)
+- **Data connections** → `snow_create_uib_data_broker` (connects via sys_ux_data_broker)
 
 **Mobile App Tools:**
 - `snow_configure_mobile_app` - Configure mobile applications

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

@@ -132,23 +132,6 @@ class ServiceNowFlowWorkspaceMobileMCP {
                         required: ['name', 'tables']
                     }
                 },
-                {
-                    name: 'snow_create_workspace_tab',
-                    description: 'Creates a custom tab in Agent Workspace for specific record types or views.',
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            workspace: { type: 'string', description: 'Parent workspace sys_id' },
-                            name: { type: 'string', description: 'Tab name' },
-                            label: { type: 'string', description: 'Tab label' },
-                            table: { type: 'string', description: 'Table for the tab' },
-                            view: { type: 'string', description: 'View to display' },
-                            order: { type: 'number', description: 'Tab order' },
-                            condition: { type: 'string', description: 'Condition to show tab' }
-                        },
-                        required: ['workspace', 'name', 'table']
-                    }
-                },
                 {
                     name: 'snow_create_workspace_list',
                     description: 'Creates a custom list configuration for Agent Workspace.',
@@ -166,23 +149,6 @@ class ServiceNowFlowWorkspaceMobileMCP {
                         required: ['workspace', 'name', 'table']
                     }
                 },
-                {
-                    name: 'snow_create_contextual_panel',
-                    description: 'Creates a contextual side panel for Agent Workspace to show related information.',
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            name: { type: 'string', description: 'Panel name' },
-                            table: { type: 'string', description: 'Table context' },
-                            type: { type: 'string', description: 'Panel type: related_records, knowledge, timeline, custom' },
-                            position: { type: 'string', description: 'Position: right, left', default: 'right' },
-                            width: { type: 'number', description: 'Panel width in pixels' },
-                            content: { type: 'string', description: 'Panel content or script' },
-                            condition: { type: 'string', description: 'Condition to show panel' }
-                        },
-                        required: ['name', 'table', 'type']
-                    }
-                },
                 {
                     name: 'snow_configure_workspace_notifications',
                     description: 'Configures notification preferences for Agent Workspace.',
@@ -741,15 +707,6 @@ class ServiceNowFlowWorkspaceMobileMCP {
                     case 'snow_create_workspace':
                         result = await this.createWorkspace(args);
                         break;
-                    case 'snow_create_workspace_tab':
-                        result = await this.createWorkspaceTab(args);
-                        break;
-                    case 'snow_create_workspace_list':
-                        result = await this.createWorkspaceList(args);
-                        break;
-                    case 'snow_create_contextual_panel':
-                        result = await this.createContextualPanel(args);
-                        break;
                     case 'snow_configure_workspace_notifications':
                         result = await this.configureWorkspaceNotifications(args);
                         break;
@@ -1376,167 +1333,6 @@ ${args.roles ? `👥 Roles: ${args.roles.join(', ')}` : ''}
             throw new types_js_1.McpError(types_js_1.ErrorCode.InternalError, `Failed to create workspace: ${error}`);
         }
     }
-    async createWorkspaceTab(args) {
-        try {
-            this.logger.info('Creating workspace tab...');
-            // Fix from user feedback: Validate workspace exists first to prevent 400 errors
-            const workspaceCheck = await this.client.getRecord('sys_aw_master_config', args.workspace);
-            if (!workspaceCheck.success) {
-                return {
-                    success: false,
-                    error: `Workspace ${args.workspace} not found. Create workspace first using snow_create_workspace.`,
-                    suggestion: 'Use snow_discover_workspaces to find available workspaces.',
-                    http_status: 404,
-                    remediation: 'Verify workspace sys_id is correct or create new workspace first'
-                };
-            }
-            const tabData = {
-                workspace: args.workspace,
-                name: args.name,
-                label: args.label || args.name,
-                table: args.table,
-                view: args.view || 'list', // Fix: use 'list' instead of 'default'
-                order: args.order || 100,
-                condition: args.condition || '', // Make condition optional to prevent 400 errors
-                active: true
-            };
-            const response = await this.client.createRecord('sys_aw_tab', tabData);
-            if (!response.success) {
-                // Enhanced error handling based on user feedback
-                if (response.error?.includes('400') || response.error?.includes('Bad Request')) {
-                    return {
-                        success: false,
-                        error: 'Invalid workspace tab configuration. Complex conditions may not be supported.',
-                        suggestion: 'Try with simpler parameters: remove complex conditions and use basic table references.',
-                        http_status: 400,
-                        remediation: 'Check ServiceNow workspace tab documentation for supported field types'
-                    };
-                }
-                return {
-                    success: false,
-                    error: response.error,
-                    suggestion: 'Check workspace tab parameters and permissions'
-                };
-            }
-            // Fix from user feedback: Return proper success object instead of content array
-            return {
-                success: true,
-                tab: response.data,
-                message: `Workspace tab '${args.name}' created successfully for table ${args.table}`,
-                sys_id: response.data.sys_id,
-                configuration: {
-                    workspace: args.workspace,
-                    table: args.table,
-                    view: args.view || 'list',
-                    order: args.order || 100,
-                    condition: args.condition || 'none'
-                }
-            };
-        }
-        catch (error) {
-            this.logger.error('Failed to create workspace tab:', error);
-            throw new types_js_1.McpError(types_js_1.ErrorCode.InternalError, `Failed to create workspace tab: ${error}`);
-        }
-    }
-    async createWorkspaceList(args) {
-        try {
-            this.logger.info('Creating workspace list...');
-            const listData = {
-                workspace: args.workspace,
-                name: args.name,
-                table: args.table,
-                filter: args.filter || '',
-                fields: args.fields ? args.fields.join(',') : '',
-                order_by: args.order_by || '',
-                max_entries: args.max_entries || 50
-            };
-            const response = await this.client.createRecord('sys_aw_list', listData);
-            if (!response.success) {
-                throw new Error(`Failed to create workspace list: ${response.error}`);
-            }
-            return {
-                content: [{
-                        type: 'text',
-                        text: `✅ Workspace List created!
-
-📋 **${args.name}**
-🆔 sys_id: ${response.data.sys_id}
-📊 Table: ${args.table}
-${args.filter ? `🔍 Filter: ${args.filter}` : ''}
-📝 Fields: ${args.fields ? args.fields.length : 'Default'}
-🔢 Max Entries: ${args.max_entries || 50}
-
-✨ List configured for workspace!`
-                    }]
-            };
-        }
-        catch (error) {
-            this.logger.error('Failed to create workspace list:', error);
-            throw new types_js_1.McpError(types_js_1.ErrorCode.InternalError, `Failed to create workspace list: ${error}`);
-        }
-    }
-    async createContextualPanel(args) {
-        try {
-            this.logger.info('Creating contextual panel...');
-            // Fix from user feedback: Validate table exists to prevent 400 errors
-            const tableCheck = await this.client.searchRecords('sys_db_object', `name=${args.table}`, 1);
-            if (!tableCheck.success || tableCheck.data.result.length === 0) {
-                return {
-                    success: false,
-                    error: `Table '${args.table}' not found or not accessible.`,
-                    suggestion: 'Verify table name is correct and you have read permissions.',
-                    remediation: 'Use standard ServiceNow tables like: incident, task, sys_user, change_request'
-                };
-            }
-            const panelData = {
-                name: args.name,
-                table: args.table,
-                type: args.type || 'related_records', // Set default type
-                position: args.position || 'right',
-                width: args.width || 300,
-                content: args.content || '',
-                condition: args.condition || '',
-                active: true
-            };
-            const response = await this.client.createRecord('sys_aw_context_panel', panelData);
-            if (!response.success) {
-                // Enhanced error handling based on user feedback
-                if (response.error?.includes('400') || response.error?.includes('Bad Request')) {
-                    return {
-                        success: false,
-                        error: 'Invalid contextual panel configuration. Check panel type and table compatibility.',
-                        suggestion: 'Try with type: "related_records" and standard ServiceNow tables.',
-                        http_status: 400,
-                        remediation: 'Verify panel type is supported and table has proper relationships'
-                    };
-                }
-                return {
-                    success: false,
-                    error: response.error,
-                    suggestion: 'Check contextual panel parameters and workspace permissions'
-                };
-            }
-            return {
-                content: [{
-                        type: 'text',
-                        text: `✅ Contextual Panel created!
-
-📊 **${args.name}**
-🆔 sys_id: ${response.data.sys_id}
-📋 Table: ${args.table}
-📊 Type: ${args.type}
-📍 Position: ${args.position || 'right'}
-📐 Width: ${args.width || 300}px
-
-✨ Panel added to workspace!`
-                    }]
-            };
-        }
-        catch (error) {
-            this.logger.error('Failed to create contextual panel:', error);
-            throw new types_js_1.McpError(types_js_1.ErrorCode.InternalError, `Failed to create contextual panel: ${error}`);
-        }
-    }
     async configureWorkspaceNotifications(args) {
         try {
             this.logger.info('Configuring workspace notifications...');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "snow-flow",
-  "version": "4.5.26",
+  "version": "4.5.28",
   "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",