snow-flow 5.0.2 → 5.0.4

package/README.md

@@ -80,16 +80,31 @@ 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
+⚠️ **IMPORTANT:** Snow-Flow uses OAuth 2.0 Authorization Code Flow with browser authentication. Follow these exact steps:
+
+1. **Navigate to:** System OAuth → Application Registry
+2. **Click:** New → **"Create an OAuth API endpoint for external clients"**
+3. **Configure OAuth Application:**
+   - **Name:** `Snow-Flow Integration` (or any name you prefer)
+   - **Redirect URL:** `http://localhost:3005/callback` ⚠️ **MUST be exactly this!**
+   - **Refresh Token Lifespan:** `0` (unlimited - recommended)
+   - **Access Token Lifespan:** `1800` (30 minutes)
+4. **Save** - ServiceNow will auto-generate:
+   - Client ID (copy this)
+   - Client Secret (copy this - shown only once!)
+5. **Create `.env` file** in your project with:
+   ```bash
+   SNOW_INSTANCE=your-instance.service-now.com
+   SNOW_CLIENT_ID=<your_client_id>
+   SNOW_CLIENT_SECRET=<your_client_secret>
+   ```
+6. **Run:** `snow-flow auth login`
+   - Opens browser automatically for ServiceNow login
+   - Redirects to `http://localhost:3005/callback` after authentication
+   - Stores OAuth tokens locally for future use
+
+**Why this exact redirect URL?**
+Snow-Flow starts a local OAuth callback server on port 3005. ServiceNow must redirect to **exactly** `http://localhost:3005/callback` - any mismatch (wrong port, missing `/callback`) will cause "Invalid redirect_uri" errors.
 
 #### Common Authentication Issues
 

package/dist/cli.js

@@ -574,7 +574,7 @@ async function executeClaudeCode(prompt) {
         // SDK automatically initializes MCP servers from configuration
         if (hasMcpConfig) {
             console.log(chalk_1.default.blue('ℹ️  MCP servers managed by Claude Agent SDK v0.1.1'));
-            console.log(chalk_1.default.green('✅ 448 ServiceNow tools available via SDK integration'));
+            console.log(chalk_1.default.green('✅ 235+ ServiceNow tools available via unified MCP server'));
         }
         // Launch Claude Code with MCP config and skip permissions to avoid raw mode issues
         const claudeArgs = hasMcpConfig
@@ -1720,14 +1720,14 @@ program
         console.log(chalk_1.default.green.bold('\n✅ Snow-Flow project initialized successfully!'));
         console.log('\n📋 Created Snow-Flow configuration:');
         console.log('   ✓ .claude/ - Claude Code MCP configuration');
-        console.log('   ✓ .mcp.json - 20+ ServiceNow MCP servers (240+ tools including complete UX Workspace workflow)');
+        console.log('   ✓ .mcp.json - 2 unified MCP servers (235+ tools including complete UX Workspace workflow)');
         console.log('   ✓ CLAUDE.md - Complete development guide');
         console.log('   ✓ README.md - Current capabilities documentation');
         console.log('   ✓ .snow-flow/ - Project workspace and memory');
         if (!options.skipMcp) {
             // NOTE: MCP servers now managed by Claude Agent SDK (v4.7.0+)
             console.log(chalk_1.default.blue('\nℹ️  MCP servers now managed by Claude Agent SDK v0.1.1'));
-            console.log(chalk_1.default.green('✅ 448 ServiceNow tools automatically available via SDK'));
+            console.log(chalk_1.default.green('✅ 235+ ServiceNow tools automatically available via unified server'));
             console.log(chalk_1.default.blue('📋 SDK handles MCP server lifecycle automatically'));
         }
         console.log(chalk_1.default.blue.bold('\n🎯 Next steps:'));
@@ -1736,7 +1736,7 @@ program
         console.log('2. Authenticate Snow-Flow: ' + chalk_1.default.cyan('snow-flow auth login'));
         console.log('3. Start developing: ' + chalk_1.default.cyan('snow-flow swarm "create incident dashboard"'));
         console.log('\n📚 Complete documentation: ' + chalk_1.default.blue('https://snow-flow.dev'));
-        console.log('💡 Complete 6-step UX Workspace creation, UI Builder, and 240+ tools now available');
+        console.log('💡 Complete UX Workspace creation, UI Builder, and 235+ unified tools now available');
         // Force exit to prevent hanging
         process.exit(0);
     }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "snow-flow",
-  "version": "5.0.2",
-  "description": "CLAUDE AGENT SDK INTEGRATION - v5.0.2 with @anthropic-ai/claude-agent-sdk@0.1.1 (official latest) featuring 86% code reduction (2832→400 lines), unified MCP server (235+ tools), SDK-native execution, intelligent orchestration, advanced memory, and 2.8-4.4x parallelization speedup.",
+  "version": "5.0.4",
+  "description": "CLAUDE AGENT SDK INTEGRATION - v5.0.4 with @anthropic-ai/claude-agent-sdk@0.1.1 (official latest) featuring 86% code reduction (2832→400 lines), unified MCP server (235+ tools), SDK-native execution, intelligent orchestration, advanced memory, and 2.8-4.4x parallelization speedup.",
   "main": "dist/index.js",
   "type": "commonjs",
   "bin": {