snow-flow 4.5.3 → 4.5.6

package/CLAUDE.md

@@ -582,28 +582,72 @@ Snow-Flow includes 18 specialized MCP servers, each providing comprehensive Serv
 - Performance Analytics setup
 - CAB meeting management
 
-### 14. ServiceNow Flow, Workspace & Mobile Server
-**Purpose:** Flow Designer, Workspace configuration, and Mobile app management
+### 14. ServiceNow Flow, Workspace & Mobile Server + UI Builder
+**Purpose:** Flow Designer, Agent Workspace configuration, Mobile app management, and complete UI Builder integration
 
-**Key Tools:**
+**Flow Designer Tools:**
 - `snow_list_flows` - List and discover Flow Designer flows
 - `snow_execute_flow` - Execute existing flows programmatically
 - `snow_get_flow_execution_status` - Monitor flow execution status
 - `snow_get_flow_execution_history` - View flow execution history
 - `snow_get_flow_details` - Get detailed flow configuration
 - `snow_import_flow_from_xml` - Import flows from XML (only programmatic creation method)
-- `snow_create_workspace` - Create workspaces
-- `snow_configure_mobile_app` - Configure mobile app
+
+**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_discover_workspaces` - Find all workspace configurations
+
+**Mobile App Tools:**
+- `snow_configure_mobile_app` - Configure mobile applications
 - `snow_send_push_notification` - Send push notifications
 - `snow_configure_offline_sync` - Configure offline sync
 
+**🆕 COMPLETE UI BUILDER INTEGRATION (15 NEW TOOLS!):**
+
+**UI Builder Page Management (sys_ux_page):**
+- `snow_create_uib_page` - Create UI Builder pages with automatic routing
+- `snow_update_uib_page` - Update page configuration and metadata
+- `snow_delete_uib_page` - Delete pages with comprehensive dependency validation
+- `snow_discover_uib_pages` - Find all UI Builder pages with filtering
+
+**UI Builder Component Library (sys_ux_lib_*):**
+- `snow_create_uib_component` - Create custom UI components with source code
+- `snow_update_uib_component` - Update component definitions and source
+- `snow_discover_uib_components` - Browse ServiceNow built-in + custom components
+- `snow_clone_uib_component` - Clone and modify existing components
+
+**UI Builder Data Integration (sys_ux_data_broker):**
+- `snow_create_uib_data_broker` - Connect ServiceNow tables/scripts/REST to pages
+- `snow_configure_uib_data_broker` - Update queries, caching, and refresh settings
+
+**UI Builder Layout Management (sys_ux_page_element):**
+- `snow_add_uib_page_element` - Add components to pages with full configuration
+- `snow_update_uib_page_element` - Update component properties and positioning  
+- `snow_remove_uib_page_element` - Remove elements with dependency checking
+
+**UI Builder Advanced Features:**
+- `snow_create_uib_page_registry` - Configure URL routing and access control
+- `snow_discover_uib_routes` - Find all page routes with security info
+- `snow_create_uib_client_script` - Add client-side JavaScript for pages
+- `snow_create_uib_client_state` - Manage page state and persistence
+- `snow_create_uib_event` - Create custom events for components
+- `snow_analyze_uib_page_performance` - Performance analysis and optimization
+- `snow_validate_uib_page_structure` - Structure validation and best practices
+- `snow_discover_uib_page_usage` - Usage analytics and complexity scoring
+
 **Important:** Flow creation is only supported through Flow Designer UI, not programmatically
 
 **Features:**
 - Flow Designer automation
-- Workspace configuration
-- Mobile app management
-- Push notification system
+- Complete Agent Workspace configuration
+- Mobile app management with push notifications
+- **Complete UI Builder/UXF integration** - Full Now Experience Framework development
+- **Conversational UI development** - Create modern ServiceNow UIs through natural language
+- **Component library management** - Custom component development and reuse
+- **Performance optimization** - Built-in UI Builder performance analysis
+- **Structure validation** - Comprehensive dependency and integrity checking
 
 ### 15. ServiceNow CMDB, Event, HR, CSM & DevOps Server
 **Purpose:** CMDB management, Event processing, HR services, Customer Service, and DevOps

package/README.md

@@ -31,9 +31,24 @@ Snow-Flow is a conversational ServiceNow development platform that bridges Claud
 
 ## Quick Start
 
+### Prerequisites 
+
+⚠️ **CRITICAL:** Claude Code must be installed and running BEFORE using Snow-Flow to prevent stdio connection errors!
+
+```bash
+# 1. FIRST: Install Claude Code
+npm install -g @anthropic-ai/claude-code
+
+# 2. Login and start Claude Code
+claude login
+cd /your/project/directory
+claude --dangerously-skip-permissions
+```
+
 ### Installation
 
 ```bash
+# 2. THEN: Install Snow-Flow (while Claude Code is running)
 npm install -g snow-flow
 ```
 
@@ -43,6 +58,9 @@ npm install -g snow-flow
 # Initialize configuration
 snow-flow init
 
+# Authenticate with ServiceNow
+snow-flow auth login
+
 # Create a ServiceNow widget with AI agents
 snow-flow swarm "create incident dashboard widget with real-time charts" --max-agents 3
 
@@ -60,6 +78,34 @@ snow-flow auth login
 snow-flow auth status
 ```
 
+#### ServiceNow OAuth Configuration
+
+To set up OAuth in your ServiceNow instance:
+
+1. **Navigate to System OAuth → Application Registry**
+2. **Click "New" → "Create an OAuth API endpoint"** (not client credentials)
+3. **Fill required fields:**
+   - Name: `Snow-Flow Integration`
+   - Client ID: `snow-flow-client`  
+   - Redirect URL: `http://localhost:3000/callback`
+4. **Save and copy the Client ID and Client Secret**
+5. **Run `snow-flow auth login`** - this opens browser for authentication
+
+#### Common Authentication Issues
+
+**❌ "Could not find artifact with sys_id xyz..."**
+- **Real cause:** OAuth token expired (misleading error message)
+- **Solution:** `snow-flow auth login`
+- **Note:** Fixed in v4.5.3 with clear OAuth error messages
+
+**❌ Stdio connection errors**
+- **Cause:** Claude Code not running before Snow-Flow  
+- **Solution:** Start Claude Code first: `claude --dangerously-skip-permissions`
+
+**❌ Permission errors**
+- **Cause:** Not logged into Claude Code
+- **Solution:** `claude login` before using Snow-Flow
+
 ## Core Features
 
 ### 🤖 Intelligent Agent Coordination

package/dist/cli.js

@@ -533,7 +533,7 @@ async function executeClaudeCode(prompt) {
         }
         // Launch Claude Code with MCP config and skip permissions to avoid raw mode issues
         const claudeArgs = hasMcpConfig
-            ? ['--mcp-config', '.mcp.json', '--dangerously-skip-permissions']
+            ? ['--mcp-config', '.mcp.json', '.', '--dangerously-skip-permissions']
             : ['--dangerously-skip-permissions'];
         // Add debug args if debug is enabled
         if (process.env.SNOW_FLOW_DEBUG === 'true' || process.env.LOG_LEVEL === 'debug' || process.env.LOG_LEVEL === 'trace') {
@@ -555,18 +555,16 @@ async function executeClaudeCode(prompt) {
             cliLogger.info(`🔍 Working Directory: ${process.cwd()}`);
             cliLogger.info(`🔍 MCP Config: ${mcpConfigPath}`);
         }
-        // Start Claude Code process in interactive mode with stdin piping
+        // Start Claude Code process - inherit all stdio to prevent raw mode issues
         const claudeProcess = (0, child_process_1.spawn)('claude', claudeArgs, {
-            stdio: ['pipe', 'inherit', 'inherit'], // pipe stdin, inherit stdout/stderr
+            stdio: 'inherit', // inherit all streams to prevent raw mode errors in Codespaces
             cwd: process.cwd(),
             env: { ...process.env }
         });
-        // Send the prompt via stdin
-        cliLogger.info('📝 Sending orchestration prompt to Claude Code...');
-        cliLogger.info('🚀 Claude Code interface opening...\n');
-        // Write prompt to stdin
-        claudeProcess.stdin.write(prompt);
-        claudeProcess.stdin.end();
+        // Claude Code will open with MCP servers ready
+        cliLogger.info('🚀 Claude Code interface opening with Snow-Flow MCP servers...\n');
+        cliLogger.info('💡 Tell Claude Code: ' + chalk_1.default.green(`"${prompt.slice(0, 100)}..."`));
+        cliLogger.info('🛠️  All 20+ MCP servers with 235+ tools are now available!');
         // Set up process monitoring
         return new Promise((resolve) => {
             claudeProcess.on('close', async (code) => {