snow-flow 8.5.7 → 8.6.0

package/dist/mcp/clients/enterprise-remote-client.js

@@ -0,0 +1,221 @@
+"use strict";
+/**
+ * Remote MCP client for Snow-Flow Enterprise
+ * Connects to enterprise.snow-flow.dev MCP server via SSE
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnterpriseRemoteClient = void 0;
+exports.getEnterpriseClient = getEnterpriseClient;
+exports.hasEnterpriseTools = hasEnterpriseTools;
+const eventsource_1 = require("eventsource");
+const enterprise_js_1 = require("../../cli/enterprise.js");
+/**
+ * Enterprise MCP Client
+ * Connects to remote enterprise MCP server for advanced features
+ */
+class EnterpriseRemoteClient {
+    constructor() {
+        this.eventSource = null;
+        this.tools = [];
+        this.connected = false;
+        this.messageHandlers = new Map();
+        this.sseUrl = `${enterprise_js_1.ENTERPRISE_MCP_SERVER_URL}/mcp/sse`;
+    }
+    /**
+     * Connect to enterprise MCP server
+     */
+    async connect() {
+        const token = await (0, enterprise_js_1.getEnterpriseToken)();
+        if (!token) {
+            throw new Error('Not authenticated with Snow-Flow Enterprise. Run: snow-flow login <license-key>');
+        }
+        return new Promise((resolve, reject) => {
+            try {
+                // eventsource package (Node.js) supports headers, browser EventSource does not
+                // Cast to any to bypass TypeScript's browser EventSourceInit type
+                this.eventSource = new eventsource_1.EventSource(this.sseUrl, {
+                    headers: {
+                        'Authorization': `Bearer ${token}`
+                    }
+                });
+                this.eventSource.onopen = () => {
+                    this.connected = true;
+                    console.log('🌟 Connected to Snow-Flow Enterprise MCP server');
+                    resolve();
+                };
+                this.eventSource.onerror = (error) => {
+                    this.connected = false;
+                    console.error('❌ Enterprise MCP connection error:', error);
+                    reject(new Error('Failed to connect to enterprise MCP server'));
+                };
+                this.eventSource.onmessage = (event) => {
+                    try {
+                        const data = JSON.parse(event.data);
+                        this.handleMessage(data);
+                    }
+                    catch (err) {
+                        console.error('Failed to parse MCP message:', err);
+                    }
+                };
+                // Request tools list after connection
+                setTimeout(async () => {
+                    await this.listTools();
+                    resolve();
+                }, 1000);
+            }
+            catch (err) {
+                reject(err);
+            }
+        });
+    }
+    /**
+     * Handle incoming SSE messages
+     */
+    handleMessage(data) {
+        const messageId = data.id;
+        if (messageId && this.messageHandlers.has(messageId)) {
+            const handler = this.messageHandlers.get(messageId);
+            if (handler) {
+                handler(data);
+                this.messageHandlers.delete(messageId);
+            }
+        }
+        // Handle specific message types
+        if (data.method === 'tools/list' && data.result) {
+            this.tools = data.result.tools || [];
+            console.log(`📋 Loaded ${this.tools.length} enterprise tools`);
+        }
+    }
+    /**
+     * Send request to MCP server and wait for response
+     */
+    async sendRequest(method, params) {
+        if (!this.connected || !this.eventSource) {
+            throw new Error('Not connected to enterprise MCP server');
+        }
+        const messageId = `msg_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+        return new Promise((resolve, reject) => {
+            // Set up response handler
+            this.messageHandlers.set(messageId, (data) => {
+                if (data.error) {
+                    reject(new Error(data.error.message || 'Enterprise MCP error'));
+                }
+                else {
+                    resolve(data.result);
+                }
+            });
+            // Send request via POST endpoint
+            fetch(`${enterprise_js_1.ENTERPRISE_MCP_SERVER_URL}/mcp/messages`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json'
+                },
+                body: JSON.stringify({
+                    jsonrpc: '2.0',
+                    id: messageId,
+                    method,
+                    params
+                })
+            }).catch((err) => {
+                this.messageHandlers.delete(messageId);
+                reject(err);
+            });
+            // Timeout after 30 seconds
+            setTimeout(() => {
+                if (this.messageHandlers.has(messageId)) {
+                    this.messageHandlers.delete(messageId);
+                    reject(new Error('Request timeout'));
+                }
+            }, 30000);
+        });
+    }
+    /**
+     * List available enterprise tools
+     */
+    async listTools() {
+        if (this.tools.length > 0) {
+            return this.tools;
+        }
+        const result = await this.sendRequest('tools/list');
+        this.tools = result.tools || [];
+        return this.tools;
+    }
+    /**
+     * Call an enterprise tool
+     */
+    async callTool(toolName, args) {
+        const result = await this.sendRequest('tools/call', {
+            name: toolName,
+            arguments: args
+        });
+        return result;
+    }
+    /**
+     * Check if tool is available
+     */
+    async hasTool(toolName) {
+        const tools = await this.listTools();
+        return tools.some(tool => tool.name === toolName);
+    }
+    /**
+     * Get all tools by category
+     */
+    async getToolsByCategory(category) {
+        const tools = await this.listTools();
+        return tools.filter(tool => tool.name.startsWith(category.replace('-', '_')));
+    }
+    /**
+     * Disconnect from server
+     */
+    disconnect() {
+        if (this.eventSource) {
+            this.eventSource.close();
+            this.eventSource = null;
+            this.connected = false;
+            console.log('🔌 Disconnected from Enterprise MCP server');
+        }
+    }
+    /**
+     * Get connection status
+     */
+    isConnected() {
+        return this.connected;
+    }
+    /**
+     * Get available tools list (cached)
+     */
+    getTools() {
+        return this.tools;
+    }
+}
+exports.EnterpriseRemoteClient = EnterpriseRemoteClient;
+/**
+ * Singleton instance
+ */
+let enterpriseClientInstance = null;
+/**
+ * Get or create enterprise client instance
+ */
+async function getEnterpriseClient() {
+    if (!enterpriseClientInstance) {
+        enterpriseClientInstance = new EnterpriseRemoteClient();
+        await enterpriseClientInstance.connect();
+    }
+    if (!enterpriseClientInstance.isConnected()) {
+        await enterpriseClientInstance.connect();
+    }
+    return enterpriseClientInstance;
+}
+/**
+ * Check if enterprise tools are available
+ */
+async function hasEnterpriseTools() {
+    try {
+        const token = await (0, enterprise_js_1.getEnterpriseToken)();
+        return token !== null;
+    }
+    catch (err) {
+        return false;
+    }
+}
+//# sourceMappingURL=enterprise-remote-client.js.map

package/dist/mcp/clients/enterprise-remote-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enterprise-remote-client.js","sourceRoot":"","sources":["../../../src/mcp/clients/enterprise-remote-client.ts"],"names":[],"mappings":"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"}

package/dist/mcp/servicenow-mcp-unified/tools/adapters/index.d.ts

@@ -1,6 +1 @@
-export { toolDefinition as snow_ldap_sync_def, execute as snow_ldap_sync_exec } from './snow_ldap_sync.js';
-export { toolDefinition as snow_saml_config_def, execute as snow_saml_config_exec } from './snow_saml_config.js';
-export { toolDefinition as snow_oauth_provider_def, execute as snow_oauth_provider_exec } from './snow_oauth_provider.js';
-export { toolDefinition as snow_webhook_config_def, execute as snow_webhook_config_exec } from './snow_webhook_config.js';
-export { toolDefinition as snow_jira_integration_def, execute as snow_jira_integration_exec } from './snow_jira_integration.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/mcp/servicenow-mcp-unified/tools/adapters/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/mcp/servicenow-mcp-unified/tools/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,IAAI,kBAAkB,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC3G,OAAO,EAAE,cAAc,IAAI,oBAAoB,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACjH,OAAO,EAAE,cAAc,IAAI,uBAAuB,EAAE,OAAO,IAAI,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAC1H,OAAO,EAAE,cAAc,IAAI,uBAAuB,EAAE,OAAO,IAAI,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAC1H,OAAO,EAAE,cAAc,IAAI,yBAAyB,EAAE,OAAO,IAAI,0BAA0B,EAAE,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/mcp/servicenow-mcp-unified/tools/adapters/index.ts"],"names":[],"mappings":""}

package/dist/mcp/servicenow-mcp-unified/tools/adapters/index.js

@@ -1,19 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.snow_jira_integration_exec = exports.snow_jira_integration_def = exports.snow_webhook_config_exec = exports.snow_webhook_config_def = exports.snow_oauth_provider_exec = exports.snow_oauth_provider_def = exports.snow_saml_config_exec = exports.snow_saml_config_def = exports.snow_ldap_sync_exec = exports.snow_ldap_sync_def = void 0;
-var snow_ldap_sync_js_1 = require("./snow_ldap_sync.js");
-Object.defineProperty(exports, "snow_ldap_sync_def", { enumerable: true, get: function () { return snow_ldap_sync_js_1.toolDefinition; } });
-Object.defineProperty(exports, "snow_ldap_sync_exec", { enumerable: true, get: function () { return snow_ldap_sync_js_1.execute; } });
-var snow_saml_config_js_1 = require("./snow_saml_config.js");
-Object.defineProperty(exports, "snow_saml_config_def", { enumerable: true, get: function () { return snow_saml_config_js_1.toolDefinition; } });
-Object.defineProperty(exports, "snow_saml_config_exec", { enumerable: true, get: function () { return snow_saml_config_js_1.execute; } });
-var snow_oauth_provider_js_1 = require("./snow_oauth_provider.js");
-Object.defineProperty(exports, "snow_oauth_provider_def", { enumerable: true, get: function () { return snow_oauth_provider_js_1.toolDefinition; } });
-Object.defineProperty(exports, "snow_oauth_provider_exec", { enumerable: true, get: function () { return snow_oauth_provider_js_1.execute; } });
-var snow_webhook_config_js_1 = require("./snow_webhook_config.js");
-Object.defineProperty(exports, "snow_webhook_config_def", { enumerable: true, get: function () { return snow_webhook_config_js_1.toolDefinition; } });
-Object.defineProperty(exports, "snow_webhook_config_exec", { enumerable: true, get: function () { return snow_webhook_config_js_1.execute; } });
-var snow_jira_integration_js_1 = require("./snow_jira_integration.js");
-Object.defineProperty(exports, "snow_jira_integration_def", { enumerable: true, get: function () { return snow_jira_integration_js_1.toolDefinition; } });
-Object.defineProperty(exports, "snow_jira_integration_exec", { enumerable: true, get: function () { return snow_jira_integration_js_1.execute; } });
+// Enterprise adapter tools have been moved to snow-flow-enterprise
+// This directory is reserved for future open-source adapter tools
 //# sourceMappingURL=index.js.map

package/dist/mcp/servicenow-mcp-unified/tools/adapters/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/mcp/servicenow-mcp-unified/tools/adapters/index.ts"],"names":[],"mappings":";;;AAAA,yDAA2G;AAAlG,uHAAA,cAAc,OAAsB;AAAE,wHAAA,OAAO,OAAuB;AAC7E,6DAAiH;AAAxG,2HAAA,cAAc,OAAwB;AAAE,4HAAA,OAAO,OAAyB;AACjF,mEAA0H;AAAjH,iIAAA,cAAc,OAA2B;AAAE,kIAAA,OAAO,OAA4B;AACvF,mEAA0H;AAAjH,iIAAA,cAAc,OAA2B;AAAE,kIAAA,OAAO,OAA4B;AACvF,uEAAgI;AAAvH,qIAAA,cAAc,OAA6B;AAAE,sIAAA,OAAO,OAA8B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/mcp/servicenow-mcp-unified/tools/adapters/index.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,kEAAkE"}

package/dist/templates/claude-md-template.d.ts

@@ -1,3 +1,3 @@
-export declare const CLAUDE_MD_TEMPLATE = "# Snow-Flow - ServiceNow Development AI Agent\n\n## \uD83D\uDEA8 CRITICAL: YOU MUST ACTUALLY CALL THE TOOLS!\n\n**MCP tools are JavaScript functions that you MUST call directly!**\n\n```javascript\n// \u2705 CORRECT - Actually call the function:\nconst updateSet = await snow_update_set_manage({\n  action: 'create',\n  name: \"Feature: Incident Dashboard\"\n});\n// This EXECUTES the tool and returns real data from ServiceNow\n\n// \u274C WRONG - Just showing code without calling it:\nconsole.log(\"I will create an update set like this:\");\nconsole.log(`await snow_update_set_manage({ action: 'create' });`);\n// This does NOTHING - it's just a string!\n```\n\n**If you show code examples without calling tools, you are FAILING your task!**\n\nThe user wants you to:\n- \u2705 **Actually execute tools** and get real results\n- \u2705 **Make real changes** in their ServiceNow instance\n- \u274C **NOT just show code examples** or explain what you \"would\" do\n\n---\n\n## \uD83D\uDEA8 CRITICAL: NEVER USE BASH/NODE/REQUIRE FOR MCP TOOLS!\n\n**MCP tools are MCP protocol functions - NOT npm packages, NOT CLI commands!**\n\n### \u274C FORBIDDEN - THESE WILL ALWAYS FAIL:\n\n```bash\n# \u274C WRONG - Trying to require() MCP tools (WILL ALWAYS FAIL!)\nnode -e \"\nconst { snow_update_set_manage } = require('./node_modules/@snow-flow/...');\n...\"\n# ERROR: Cannot find module - @snow-flow packages DON'T EXIST!\n\n# \u274C WRONG - Trying to execute MCP tools as CLI commands\ncd /path/to/project && node -e \"const { snow_query_table } = require(...);\"\n# ERROR: Module not found - MCP tools are NOT npm packages!\n\n# \u274C WRONG - Using bash/shell to call tools\nsnow-flow mcp execute --tool snow_create_ui_page\n# ERROR: No such command - MCP tools are NOT CLI commands!\n```\n\n### \u2705 CORRECT - Just call the function directly:\n\n```javascript\n// MCP tools are ALREADY LOADED and AVAILABLE as functions!\nconst updateSet = await snow_update_set_manage({\n  action: 'create',\n  name: \"Feature: Incident Dashboard\"\n});\n// That's it! No bash, no require, no npm, no CLI!\n```\n\n### Why bash/require NEVER works:\n\n1. **MCP tools are NOT npm packages**\n   - They don't exist in node_modules\n   - You can't require() them\n   - No package.json to install them\n\n2. **MCP tools are NOT CLI commands**\n   - They're not executables\n   - No bash/shell needed\n   - Just direct function calls\n\n3. **MCP tools are loaded via MCP protocol**\n   - OpenCode/Claude Code loads them automatically\n   - They appear as callable functions\n   - No manual loading needed\n\n**REMEMBER: If you think you need bash/node/require, you're WRONG! Just call the function!**\n\n---\n\n## What is Snow-Flow?\n\n**Snow-Flow** is an AI-powered ServiceNow development framework that provides **370+ MCP tools** to automate ServiceNow development, configuration, and administration. You are an AI agent with direct access to these tools to help users build, configure, and manage ServiceNow instances.\n\n## Your Purpose\n\nYou help users:\n- **Develop** ServiceNow artifacts (widgets, business rules, UI pages, flows, etc.)\n- **Configure** ServiceNow instances (properties, update sets, integrations)\n- **Automate** tasks (scripts, workflows, scheduled jobs)\n- **Analyze** data (incidents, reports, performance analytics)\n\n**Remember:** These tools are AVAILABLE and WORKING - just call them!\n\n---\n\n## \uD83D\uDEA8 THE GOLDEN RULE: UPDATE SET WORKFLOW\n\n**EVERY ServiceNow development task MUST follow this workflow:**\n\n```javascript\n// 1. CREATE UPDATE SET (before ANY development!)\nconst updateSet = await snow_update_set_manage({\n  action: 'create',\n  name: \"Feature: [Descriptive Name]\",\n  description: \"What you're building and why\",\n  application: \"global\"\n});\n\n// 2. VERIFY UPDATE SET IS ACTIVE\nconst current = await snow_update_set_query({ action: 'current' });\nconsole.log('Active Update Set:', current.name);\n\n// 3. NOW DEVELOP (all changes auto-tracked)\nawait snow_deploy({\n  type: 'widget',\n  config: { name: 'my_widget', ... }\n});\n\n// 4. COMPLETE UPDATE SET when done\nawait snow_update_set_manage({\n  action: 'complete',\n  update_set_id: updateSet.sys_id\n});\n```\n\n### Update Set Rules:\n- \u2705 **ONE feature = ONE update set** (clear scope)\n- \u2705 **Create BEFORE any development** (not after!)\n- \u2705 **Descriptive names:** \"Feature: X\" or \"Fix: Y\", NOT \"Changes\"\n- \u2705 **Verify it's active** before making changes\n- \u2705 **All changes tracked** automatically in active update set\n\n---\n\n## Core MCP Tools (v8.2.0)\n\n### Update Set Management (MANDATORY!)\n```javascript\n// Merged tools - use 'action' parameter:\nsnow_update_set_manage({ action: 'create' })        // Create new update set\nsnow_update_set_manage({ action: 'complete' })      // Mark as complete\nsnow_update_set_manage({ action: 'export' })        // Export to XML\nsnow_update_set_query({ action: 'current' })        // Get current active\nsnow_update_set_query({ action: 'list' })           // List all update sets\nsnow_ensure_active_update_set({ sys_id })           // Ensure specific set is active\n```\n\n### Record Operations\n```javascript\nsnow_record_manage({ action: 'create', table, data })   // Create record\nsnow_record_manage({ action: 'update', sys_id, data })  // Update record\nsnow_record_manage({ action: 'delete', sys_id })        // Delete record\nsnow_query_table({ table, query, fields })              // Query any table\nsnow_get_by_sysid({ table, sys_id })                    // Get specific record\n```\n\n### Development & Deployment\n```javascript\nsnow_deploy({ type, config })                           // Deploy widgets, pages, etc.\nsnow_create_business_rule({ name, table, script })      // Business rules\nsnow_create_script_include({ name, script })            // Script includes\nsnow_create_client_script({ name, table, script })      // Client scripts\nsnow_create_ui_policy({ name, table, conditions })      // UI policies\n```\n\n### Widget Development (CRITICAL!)\n```javascript\n// ALWAYS use local sync for widgets - NEVER snow_query_table!\nsnow_pull_artifact({ sys_id, table: 'sp_widget' })      // Pull to local files\n// ... edit locally with native tools ...\nsnow_push_artifact({ sys_id })                          // Push back to ServiceNow\n```\n\n### Change Management\n```javascript\nsnow_change_manage({ action: 'create', ... })           // Create change\nsnow_change_manage({ action: 'approve', ... })          // Approve change\nsnow_change_query({ action: 'search', ... })            // Search changes\n```\n\n### Knowledge Management\n```javascript\nsnow_knowledge_article_manage({ action: 'create' })     // Create article\nsnow_knowledge_article_manage({ action: 'publish' })    // Publish article\nsnow_knowledge_article_manage({ action: 'search' })     // Search articles\n```\n\n### Performance Analytics\n```javascript\nsnow_pa_create({ action: 'indicator', ... })            // Create PA indicator\nsnow_pa_operate({ action: 'collect_data', ... })        // Collect PA data\nsnow_pa_discover({ action: 'indicators' })              // Discover indicators\n```\n\n### UI Builder\n```javascript\nsnow_create_uib_page({ name, title })                   // Create UIB page\nsnow_uib_component_manage({ action: 'create' })         // Create component\nsnow_add_uib_page_element({ page_sys_id, component })   // Add element\n```\n\n### Workspace\n```javascript\nsnow_create_complete_workspace({ workspace_name, tables }) // Complete workspace\nsnow_create_workspace_tab({ workspace, tab_config })        // Add tab\n```\n\n### Automation & Scripts\n```javascript\nsnow_execute_script_with_output({ script })             // Test/verify scripts (ES5 ONLY!)\nsnow_schedule_job({ name, script, interval })           // Scheduled jobs\nsnow_get_logs({ filter })                               // View system logs\n```\n\n### System Properties\n```javascript\nsnow_property_manage({ action: 'get', name })           // Get property\nsnow_property_manage({ action: 'set', name, value })    // Set property\nsnow_property_query({ action: 'list', pattern })        // List properties\n```\n\n---\n\n## Critical Rules\n\n### 1. ES5 JavaScript Only (ServiceNow Rhino Engine)\n**NEVER USE:**\n- \u274C `const` / `let` (use `var`)\n- \u274C Arrow functions `() => {}` (use `function() {}`)\n- \u274C Template literals \\`${}\\` (use string concatenation `+`)\n- \u274C Destructuring `{a, b} = obj` (use `obj.a`, `obj.b`)\n- \u274C `for...of` loops (use traditional `for` loops)\n\n**ALWAYS USE ES5:**\n```javascript\nvar data = [];  // NOT const or let\nfunction process() { return 'result'; }  // NOT arrow functions\nvar msg = 'Hello ' + name;  // NOT template literals\nfor (var i = 0; i < items.length; i++) { }  // NOT for...of\n```\n\n### 2. Widget Debugging = Local Sync\n**ALWAYS use `snow_pull_artifact` for widgets** - NEVER `snow_query_table`!\n- Widget too large? \u2192 `snow_pull_artifact`\n- Widget not working? \u2192 `snow_pull_artifact`\n- Need to edit widget? \u2192 `snow_pull_artifact`\n\n### 3. MCP Tools Are Functions\n**MCP tools are JavaScript functions** - call them directly!\n```javascript\n// \u2705 CORRECT\nawait snow_create_ui_page({ name: \"dashboard\", html: \"...\" });\n\n// \u274C WRONG - DO NOT USE BASH!\n// node dist/index.js mcp execute ...  // DOES NOT EXIST!\n// npx snow-flow-mcp-client ...        // DOES NOT EXIST!\n```\n\n### 4. No Mock Data\n- **FORBIDDEN:** Placeholders, TODOs, \"this would normally...\", test values\n- **REQUIRED:** Complete, production-ready, fully functional code\n\n### 5. Verify First\n- Test before claiming something is broken\n- Check if resources exist before modifying\n- Use `snow_execute_script_with_output` to verify\n\n---\n\n## The Universal Workflow\n\n**Every task follows this pattern:**\n\n1. **\uD83D\uDCE6 UPDATE SET FIRST**\n   - `snow_update_set_manage({ action: 'create', ... })`\n   - `snow_update_set_query({ action: 'current' })` to verify\n\n2. **\uD83D\uDD0D USE RIGHT TOOL**\n   - Creating? \u2192 `snow_create_*` or `snow_deploy`\n   - Updating? \u2192 `snow_record_manage({ action: 'update' })`\n   - Querying? \u2192 `snow_query_table` or specific query tool\n   - Widget? \u2192 `snow_pull_artifact` (local sync!)\n\n3. **\u2705 VERIFY**\n   - `snow_execute_script_with_output` for testing\n   - Check logs with `snow_get_logs`\n   - Validate with `snow_update_set_query({ action: 'current' })`\n\n4. **\u2714\uFE0F COMPLETE**\n   - `snow_update_set_manage({ action: 'complete' })`\n\n---\n\n## Skills & Advanced Features\n\n**Skills** are specialized capabilities you can invoke for complex tasks:\n- Use the Skill tool when available for specialized workflows\n- Skills are invoked by name only (no arguments)\n- Check available_skills in your environment\n\n---\n\n## Quick Reference\n\n| Task | Tool | Notes |\n|------|------|-------|\n| Create update set | `snow_update_set_manage({ action: 'create' })` | **DO THIS FIRST!** |\n| Create widget | `snow_deploy({ type: 'widget' })` | After update set |\n| Fix widget | `snow_pull_artifact({ sys_id })` | Local sync |\n| Create business rule | `snow_create_business_rule()` | ES5 only! |\n| Query incidents | `snow_query_incidents()` | Specialized tool |\n| Get property | `snow_property_manage({ action: 'get' })` | System properties |\n| Test script | `snow_execute_script_with_output()` | ES5 verification |\n| Complete work | `snow_update_set_manage({ action: 'complete' })` | **DO THIS LAST!** |\n\n---\n\n**Remember:** Update Set \u2192 Tool \u2192 Verify \u2192 Complete. Every. Single. Time.\n";
+export declare const CLAUDE_MD_TEMPLATE = "# Snow-Flow - ServiceNow Development AI Agent\n\n## \uD83D\uDEA8 CRITICAL: YOU MUST ACTUALLY CALL THE TOOLS!\n\n**MCP tools are JavaScript functions that you MUST call directly!**\n\n```javascript\n// \u2705 CORRECT - Actually call the function:\nconst updateSet = await snow_update_set_manage({\n  action: 'create',\n  name: \"Feature: Incident Dashboard\"\n});\n// This EXECUTES the tool and returns real data from ServiceNow\n\n// \u274C WRONG - Just showing code without calling it:\nconsole.log(\"I will create an update set like this:\");\nconsole.log(`await snow_update_set_manage({ action: 'create' });`);\n// This does NOTHING - it's just a string!\n```\n\n**If you show code examples without calling tools, you are FAILING your task!**\n\nThe user wants you to:\n- \u2705 **Actually execute tools** and get real results\n- \u2705 **Make real changes** in their ServiceNow instance\n- \u274C **NOT just show code examples** or explain what you \"would\" do\n\n---\n\n## \uD83D\uDEA8 CRITICAL: NEVER USE BASH/NODE/REQUIRE FOR MCP TOOLS!\n\n**MCP tools are MCP protocol functions - NOT npm packages, NOT CLI commands!**\n\n### \u274C FORBIDDEN - THESE WILL ALWAYS FAIL:\n\n```bash\n# \u274C WRONG - Trying to require() MCP tools (WILL ALWAYS FAIL!)\nnode -e \"\nconst { snow_update_set_manage } = require('./node_modules/@snow-flow/...');\n...\"\n# ERROR: Cannot find module - @snow-flow packages DON'T EXIST!\n\n# \u274C WRONG - Trying to execute MCP tools as CLI commands\ncd /path/to/project && node -e \"const { snow_query_table } = require(...);\"\n# ERROR: Module not found - MCP tools are NOT npm packages!\n\n# \u274C WRONG - Using bash/shell to call tools\nsnow-flow mcp execute --tool snow_create_ui_page\n# ERROR: No such command - MCP tools are NOT CLI commands!\n```\n\n### \u2705 CORRECT - Just call the function directly:\n\n```javascript\n// MCP tools are ALREADY LOADED and AVAILABLE as functions!\nconst updateSet = await snow_update_set_manage({\n  action: 'create',\n  name: \"Feature: Incident Dashboard\"\n});\n// That's it! No bash, no require, no npm, no CLI!\n```\n\n### Why bash/require NEVER works:\n\n1. **MCP tools are NOT npm packages**\n   - They don't exist in node_modules\n   - You can't require() them\n   - No package.json to install them\n\n2. **MCP tools are NOT CLI commands**\n   - They're not executables\n   - No bash/shell needed\n   - Just direct function calls\n\n3. **MCP tools are loaded via MCP protocol**\n   - SnowCode/Claude Code loads them automatically\n   - They appear as callable functions\n   - No manual loading needed\n\n**REMEMBER: If you think you need bash/node/require, you're WRONG! Just call the function!**\n\n---\n\n## What is Snow-Flow?\n\n**Snow-Flow** is an AI-powered ServiceNow development framework that provides **370+ MCP tools** to automate ServiceNow development, configuration, and administration. You are an AI agent with direct access to these tools to help users build, configure, and manage ServiceNow instances.\n\n## Your Purpose\n\nYou help users:\n- **Develop** ServiceNow artifacts (widgets, business rules, UI pages, flows, etc.)\n- **Configure** ServiceNow instances (properties, update sets, integrations)\n- **Automate** tasks (scripts, workflows, scheduled jobs)\n- **Analyze** data (incidents, reports, performance analytics)\n\n**Remember:** These tools are AVAILABLE and WORKING - just call them!\n\n---\n\n## \uD83D\uDEA8 THE GOLDEN RULE: UPDATE SET WORKFLOW\n\n**EVERY ServiceNow development task MUST follow this workflow:**\n\n```javascript\n// 1. CREATE UPDATE SET (before ANY development!)\nconst updateSet = await snow_update_set_manage({\n  action: 'create',\n  name: \"Feature: [Descriptive Name]\",\n  description: \"What you're building and why\",\n  application: \"global\"\n});\n\n// 2. VERIFY UPDATE SET IS ACTIVE\nconst current = await snow_update_set_query({ action: 'current' });\nconsole.log('Active Update Set:', current.name);\n\n// 3. NOW DEVELOP (all changes auto-tracked)\nawait snow_deploy({\n  type: 'widget',\n  config: { name: 'my_widget', ... }\n});\n\n// 4. COMPLETE UPDATE SET when done\nawait snow_update_set_manage({\n  action: 'complete',\n  update_set_id: updateSet.sys_id\n});\n```\n\n### Update Set Rules:\n- \u2705 **ONE feature = ONE update set** (clear scope)\n- \u2705 **Create BEFORE any development** (not after!)\n- \u2705 **Descriptive names:** \"Feature: X\" or \"Fix: Y\", NOT \"Changes\"\n- \u2705 **Verify it's active** before making changes\n- \u2705 **All changes tracked** automatically in active update set\n\n---\n\n## Core MCP Tools (v8.2.0)\n\n### Update Set Management (MANDATORY!)\n```javascript\n// Merged tools - use 'action' parameter:\nsnow_update_set_manage({ action: 'create' })        // Create new update set\nsnow_update_set_manage({ action: 'complete' })      // Mark as complete\nsnow_update_set_manage({ action: 'export' })        // Export to XML\nsnow_update_set_query({ action: 'current' })        // Get current active\nsnow_update_set_query({ action: 'list' })           // List all update sets\nsnow_ensure_active_update_set({ sys_id })           // Ensure specific set is active\n```\n\n### Record Operations\n```javascript\nsnow_record_manage({ action: 'create', table, data })   // Create record\nsnow_record_manage({ action: 'update', sys_id, data })  // Update record\nsnow_record_manage({ action: 'delete', sys_id })        // Delete record\nsnow_query_table({ table, query, fields })              // Query any table\nsnow_get_by_sysid({ table, sys_id })                    // Get specific record\n```\n\n### Development & Deployment\n```javascript\nsnow_deploy({ type, config })                           // Deploy widgets, pages, etc.\nsnow_create_business_rule({ name, table, script })      // Business rules\nsnow_create_script_include({ name, script })            // Script includes\nsnow_create_client_script({ name, table, script })      // Client scripts\nsnow_create_ui_policy({ name, table, conditions })      // UI policies\n```\n\n### Widget Development (CRITICAL!)\n```javascript\n// ALWAYS use local sync for widgets - NEVER snow_query_table!\nsnow_pull_artifact({ sys_id, table: 'sp_widget' })      // Pull to local files\n// ... edit locally with native tools ...\nsnow_push_artifact({ sys_id })                          // Push back to ServiceNow\n```\n\n### Change Management\n```javascript\nsnow_change_manage({ action: 'create', ... })           // Create change\nsnow_change_manage({ action: 'approve', ... })          // Approve change\nsnow_change_query({ action: 'search', ... })            // Search changes\n```\n\n### Knowledge Management\n```javascript\nsnow_knowledge_article_manage({ action: 'create' })     // Create article\nsnow_knowledge_article_manage({ action: 'publish' })    // Publish article\nsnow_knowledge_article_manage({ action: 'search' })     // Search articles\n```\n\n### Performance Analytics\n```javascript\nsnow_pa_create({ action: 'indicator', ... })            // Create PA indicator\nsnow_pa_operate({ action: 'collect_data', ... })        // Collect PA data\nsnow_pa_discover({ action: 'indicators' })              // Discover indicators\n```\n\n### UI Builder\n```javascript\nsnow_create_uib_page({ name, title })                   // Create UIB page\nsnow_uib_component_manage({ action: 'create' })         // Create component\nsnow_add_uib_page_element({ page_sys_id, component })   // Add element\n```\n\n### Workspace\n```javascript\nsnow_create_complete_workspace({ workspace_name, tables }) // Complete workspace\nsnow_create_workspace_tab({ workspace, tab_config })        // Add tab\n```\n\n### Automation & Scripts\n```javascript\nsnow_execute_script_with_output({ script })             // Test/verify scripts (ES5 ONLY!)\nsnow_schedule_job({ name, script, interval })           // Scheduled jobs\nsnow_get_logs({ filter })                               // View system logs\n```\n\n### System Properties\n```javascript\nsnow_property_manage({ action: 'get', name })           // Get property\nsnow_property_manage({ action: 'set', name, value })    // Set property\nsnow_property_query({ action: 'list', pattern })        // List properties\n```\n\n---\n\n## Critical Rules\n\n### 1. ES5 JavaScript Only (ServiceNow Rhino Engine)\n**NEVER USE:**\n- \u274C `const` / `let` (use `var`)\n- \u274C Arrow functions `() => {}` (use `function() {}`)\n- \u274C Template literals \\`${}\\` (use string concatenation `+`)\n- \u274C Destructuring `{a, b} = obj` (use `obj.a`, `obj.b`)\n- \u274C `for...of` loops (use traditional `for` loops)\n\n**ALWAYS USE ES5:**\n```javascript\nvar data = [];  // NOT const or let\nfunction process() { return 'result'; }  // NOT arrow functions\nvar msg = 'Hello ' + name;  // NOT template literals\nfor (var i = 0; i < items.length; i++) { }  // NOT for...of\n```\n\n### 2. Widget Debugging = Local Sync\n**ALWAYS use `snow_pull_artifact` for widgets** - NEVER `snow_query_table`!\n- Widget too large? \u2192 `snow_pull_artifact`\n- Widget not working? \u2192 `snow_pull_artifact`\n- Need to edit widget? \u2192 `snow_pull_artifact`\n\n### 3. MCP Tools Are Functions\n**MCP tools are JavaScript functions** - call them directly!\n```javascript\n// \u2705 CORRECT\nawait snow_create_ui_page({ name: \"dashboard\", html: \"...\" });\n\n// \u274C WRONG - DO NOT USE BASH!\n// node dist/index.js mcp execute ...  // DOES NOT EXIST!\n// npx snow-flow-mcp-client ...        // DOES NOT EXIST!\n```\n\n### 4. No Mock Data\n- **FORBIDDEN:** Placeholders, TODOs, \"this would normally...\", test values\n- **REQUIRED:** Complete, production-ready, fully functional code\n\n### 5. Verify First\n- Test before claiming something is broken\n- Check if resources exist before modifying\n- Use `snow_execute_script_with_output` to verify\n\n---\n\n## The Universal Workflow\n\n**Every task follows this pattern:**\n\n1. **\uD83D\uDCE6 UPDATE SET FIRST**\n   - `snow_update_set_manage({ action: 'create', ... })`\n   - `snow_update_set_query({ action: 'current' })` to verify\n\n2. **\uD83D\uDD0D USE RIGHT TOOL**\n   - Creating? \u2192 `snow_create_*` or `snow_deploy`\n   - Updating? \u2192 `snow_record_manage({ action: 'update' })`\n   - Querying? \u2192 `snow_query_table` or specific query tool\n   - Widget? \u2192 `snow_pull_artifact` (local sync!)\n\n3. **\u2705 VERIFY**\n   - `snow_execute_script_with_output` for testing\n   - Check logs with `snow_get_logs`\n   - Validate with `snow_update_set_query({ action: 'current' })`\n\n4. **\u2714\uFE0F COMPLETE**\n   - `snow_update_set_manage({ action: 'complete' })`\n\n---\n\n## Skills & Advanced Features\n\n**Skills** are specialized capabilities you can invoke for complex tasks:\n- Use the Skill tool when available for specialized workflows\n- Skills are invoked by name only (no arguments)\n- Check available_skills in your environment\n\n---\n\n## Quick Reference\n\n| Task | Tool | Notes |\n|------|------|-------|\n| Create update set | `snow_update_set_manage({ action: 'create' })` | **DO THIS FIRST!** |\n| Create widget | `snow_deploy({ type: 'widget' })` | After update set |\n| Fix widget | `snow_pull_artifact({ sys_id })` | Local sync |\n| Create business rule | `snow_create_business_rule()` | ES5 only! |\n| Query incidents | `snow_query_incidents()` | Specialized tool |\n| Get property | `snow_property_manage({ action: 'get' })` | System properties |\n| Test script | `snow_execute_script_with_output()` | ES5 verification |\n| Complete work | `snow_update_set_manage({ action: 'complete' })` | **DO THIS LAST!** |\n\n---\n\n**Remember:** Update Set \u2192 Tool \u2192 Verify \u2192 Complete. Every. Single. Time.\n";
 export declare const CLAUDE_MD_TEMPLATE_VERSION = "8.3.0-ENTERPRISE-THEMES";
 //# sourceMappingURL=claude-md-template.d.ts.map

package/dist/templates/claude-md-template.js

@@ -76,7 +76,7 @@ const updateSet = await snow_update_set_manage({
    - Just direct function calls
 
 3. **MCP tools are loaded via MCP protocol**
-   - OpenCode/Claude Code loads them automatically
+   - SnowCode/Claude Code loads them automatically
    - They appear as callable functions
    - No manual loading needed
 

package/dist/templates/readme-template.d.ts

@@ -1,2 +1,2 @@
-export declare const README_TEMPLATE = "# Snow-Flow: AI-Powered ServiceNow Development Platform \uD83D\uDE80\n\nSnow-Flow is a powerful AI development platform for ServiceNow that combines **22 specialized MCP servers** with **multi-agent orchestration** to revolutionize ServiceNow development. Build widgets, flows, workspaces, and complete applications using natural language commands.\n\n## \uD83C\uDFAF What Can Snow-Flow Do?\n\n- **Create ServiceNow Widgets** - \"Create an incident dashboard widget with real-time updates\"\n- **Build Agent Workspaces** - \"Create a workspace for IT support agents with incident lists\"\n- **Process Mining** - \"Discover hidden inefficiencies in ITSM workflows\"\n- **Deploy UI Builder Pages** - \"Build a customer portal page with service catalog\"\n- **Manage CMDB** - \"Find all Windows servers and update their maintenance windows\"\n- **Train ML Models** - \"Create a Predictive Intelligence solution to categorize incidents\"\n- **And much more!** - 22 MCP servers with 400+ tools for complete ServiceNow development\n\n## \uD83D\uDE80 Quick Start (5 Minutes)\n\n### 1. Install Snow-Flow\n\n```bash\nnpm install -g snow-flow\n```\n\n### 2. Initialize Your Project\n\n```bash\n# Create a new directory or use existing project\nmkdir my-servicenow-project\ncd my-servicenow-project\n\n# Initialize Snow-Flow (creates .env, CLAUDE.md, MCP config)\nsnow-flow init\n```\n\n### 3. Authenticate\n\n```bash\n# Authenticate with LLM provider (Claude/OpenAI/Gemini) AND ServiceNow\nsnow-flow auth login\n```\n\nThis will:\n- \u2705 Authenticate with your preferred LLM provider (via OpenCode)\n- \u2705 Save your provider choice to .env\n- \u2705 Configure ServiceNow OAuth credentials\n- \u2705 Test the connection and show your username\n\n### 4. Start Building!\n\n```bash\n# Use the swarm command to build anything in ServiceNow\nsnow-flow swarm \"create an incident dashboard widget\"\n\n# Or use OpenCode/Claude Code directly (MCP servers auto-configured)\nopencode  # All 22 MCP servers available automatically\n```\n\n## \uD83C\uDFAF Key Features\n\n### \uD83E\uDD16 22 Specialized MCP Servers (400+ Tools)\n\nSnow-Flow includes the most comprehensive ServiceNow MCP server collection:\n\n1. **ServiceNow Deployment** - Widget, flow, and artifact deployment\n2. **ServiceNow Operations** - Core CRUD operations and queries\n3. **ServiceNow Automation** - Background scripts and job scheduling\n4. **ServiceNow Platform Development** - Script includes, business rules, client scripts\n5. **ServiceNow Integration** - REST messages, web services, data imports\n6. **ServiceNow System Properties** - Property management and configuration\n7. **ServiceNow Update Set** - Change management and deployment tracking\n8. **ServiceNow Development Assistant** - Intelligent artifact search and editing\n9. **ServiceNow Security & Compliance** - ACLs, security policies, vulnerability scanning\n10. **ServiceNow Reporting & Analytics** - Reports, dashboards, and KPIs\n11. **ServiceNow Machine Learning** - Predictive Intelligence + TensorFlow.js\n12. **ServiceNow Knowledge & Catalog** - Knowledge base and service catalog\n13. **ServiceNow Change, Virtual Agent & PA** - Change management, chatbots, performance analytics\n14. **ServiceNow Flow, Workspace & Mobile** - Flow Designer, Agent Workspace, UI Builder\n15. **ServiceNow CMDB, Event, HR, CSM & DevOps** - Configuration management, HR services, customer service\n16. **ServiceNow Advanced Features** - Batch operations, query optimization, process mining\n17. **ServiceNow Local Development** - Artifact sync with local files for debugging\n18. **Snow-Flow Orchestration** - Multi-agent coordination and task management\n19. **Snow-Flow Memory** - Persistent memory and context management\n20. **Snow-Flow Neural** - Neural network training with TensorFlow.js\n21. **Snow-Flow Graph** - Relationship tracking and impact analysis\n22. **Snow-Flow Performance** - Performance monitoring and optimization\n\n### \uD83D\uDD04 Multi-Agent Orchestration\n\nThe `swarm` command coordinates multiple specialized agents to handle complex tasks:\n\n```bash\n# Single command handles everything: planning, execution, testing, deployment\nsnow-flow swarm \"build a complete incident management workspace with dashboards\"\n```\n\n### \uD83C\uDFA8 OpenCode + Claude Code Support\n\nSnow-Flow works seamlessly with both AI platforms:\n\n- **OpenCode**: Native Task() integration, all 22 MCP servers auto-configured\n- **Claude Code**: Full MCP support via .claude/config.json\n- **Both**: Share the same CLAUDE.md instructions and .env configuration\n\n### \uD83D\uDD10 Secure Authentication\n\n- **LLM Providers**: Authenticate via OpenCode (supports Claude, OpenAI, Google, Ollama)\n- **ServiceNow**: OAuth 2.0 with automatic token refresh\n- **Credentials**: Stored securely in .env (never committed to git)\n\n### \uD83E\uDDEA Local Development with Artifact Sync\n\nPull ServiceNow artifacts to local files, edit with your favorite tools, and push back:\n\n```bash\n# Example via OpenCode/Claude Code with MCP tools:\n# 1. Pull widget to local files\nsnow_pull_artifact({ sys_id: 'widget_sys_id', table: 'sp_widget' })\n\n# 2. Edit locally with full IDE features (search, refactor, etc.)\n# Files created in /tmp/snow-flow-artifacts/widgets/my_widget/\n\n# 3. Validate coherence\nsnow_validate_artifact_coherence({ sys_id: 'widget_sys_id' })\n\n# 4. Push changes back\nsnow_push_artifact({ sys_id: 'widget_sys_id' })\n```\n\n## \uD83D\uDCDA Usage Examples\n\n### Create a Service Portal Widget\n\n```bash\nsnow-flow swarm \"create a widget showing top 10 open incidents with priority indicators\"\n```\n\n### Build an Agent Workspace\n\n```bash\nsnow-flow swarm \"create an agent workspace for ITIL fulfillment with task lists and approvals\"\n```\n\n### Design a Flow Designer Flow\n\n```bash\nsnow-flow swarm \"create an approval flow for purchase requests over $5000\"\n```\n\n### Train a Machine Learning Model\n\n```bash\nsnow-flow swarm \"create a Predictive Intelligence solution to predict incident categories\"\n```\n\n### Build a UI Builder Page\n\n```bash\nsnow-flow swarm \"create a UI Builder page with a list of incidents and a detail panel\"\n```\n\n### Update CMDB Configuration Items\n\n```bash\nsnow-flow swarm \"find all Linux servers in Boston datacenter and update their support group\"\n```\n\n### Generate Reports and Dashboards\n\n```bash\nsnow-flow swarm \"create a dashboard showing SLA compliance trends for the last 30 days\"\n```\n\n## \uD83D\uDD27 Commands Reference\n\n### Authentication\n```bash\nsnow-flow auth login   # Authenticate with LLM provider and ServiceNow\nsnow-flow auth logout  # Logout from ServiceNow\nsnow-flow auth status  # Check authentication status\n```\n\n### Project Management\n```bash\nsnow-flow init         # Initialize Snow-Flow in current directory\nsnow-flow version      # Show Snow-Flow version\n```\n\n### Development\n```bash\nsnow-flow swarm \"<task>\"  # Multi-agent orchestration for complex tasks\n```\n\n### Direct AI Usage\n```bash\nopencode               # Start OpenCode with all 22 MCP servers\nclaude                 # Start Claude Code with MCP servers (if installed)\n```\n\n## \uD83D\uDEE0\uFE0F Configuration\n\n### .env File\n\nCreated by `snow-flow init`, configure these variables:\n\n```env\n# ServiceNow Instance\nSNOW_INSTANCE=your-instance.service-now.com\nSNOW_CLIENT_ID=your-oauth-client-id\nSNOW_CLIENT_SECRET=your-oauth-client-secret\n\n# LLM Provider (auto-set by auth login)\nDEFAULT_LLM_PROVIDER=anthropic  # or openai, google, ollama\n\n# Optional: Direct API key (skips OpenCode auth)\nANTHROPIC_API_KEY=sk-ant-...\n```\n\n### ServiceNow OAuth Setup\n\n1. Log into ServiceNow as admin\n2. Navigate to: **System OAuth > Application Registry**\n3. Click **New** > **Create an OAuth API endpoint for external clients**\n4. Fill in:\n   - **Name**: Snow-Flow\n   - **Client ID**: (auto-generated, copy this)\n   - **Client Secret**: (auto-generated, copy this)\n   - **Redirect URL**: http://localhost:3000/oauth/callback\n5. Save and copy Client ID and Secret to your .env file\n6. Run `snow-flow auth login` to complete authentication\n\n## \uD83D\uDCC1 Project Structure\n\nAfter running `snow-flow init`:\n\n```\nyour-project/\n\u251C\u2500\u2500 .env                    # Environment configuration (DO NOT COMMIT)\n\u251C\u2500\u2500 .env.example            # Example environment template\n\u251C\u2500\u2500 CLAUDE.md               # AI instructions (primary)\n\u251C\u2500\u2500 AGENTS.md               # AI instructions (OpenCode copy)\n\u251C\u2500\u2500 .opencode/              # OpenCode configuration\n\u2502   \u2514\u2500\u2500 config.json         # MCP servers for OpenCode\n\u251C\u2500\u2500 .claude/                # Claude Code configuration\n\u2502   \u2514\u2500\u2500 config.json         # MCP servers for Claude Code\n\u251C\u2500\u2500 .mcp.json               # Unified MCP server configuration\n\u251C\u2500\u2500 .snow-flow/             # Snow-Flow workspace\n\u2502   \u251C\u2500\u2500 memory/             # Persistent agent memory\n\u2502   \u2514\u2500\u2500 artifacts/          # Local artifact cache\n\u2514\u2500\u2500 README.md               # This file\n```\n\n## \uD83C\uDF93 Learning Resources\n\n### Documentation Files\n\n- **CLAUDE.md** / **AGENTS.md** - Complete AI instructions and best practices\n- **SERVICENOW-OAUTH-SETUP.md** - Detailed OAuth configuration guide\n- **TRADEMARK.md** - Brand guidelines and usage\n\n### Online Resources\n\n- [ServiceNow Developer Portal](https://developer.servicenow.com)\n- [ServiceNow Flow Designer Documentation](https://docs.servicenow.com/flow-designer)\n- [ServiceNow REST API Reference](https://docs.servicenow.com/rest-api)\n\n## \uD83D\uDD12 Security Best Practices\n\n1. **Never commit .env** - Already in .gitignore\n2. **Use OAuth 2.0** - More secure than basic authentication\n3. **Rotate credentials** - Change OAuth secrets periodically\n4. **Test in dev first** - Always test in development instances\n5. **Use Update Sets** - Track all changes professionally\n6. **Review AI output** - Always review generated code before deployment\n\n## \uD83D\uDC1B Troubleshooting\n\n### \"OpenCode is not installed\"\n\n```bash\nnpm install -g opencode-ai\n```\n\n### \"ServiceNow authentication failed\"\n\n1. Check your .env credentials are correct\n2. Verify OAuth application is configured in ServiceNow\n3. Ensure redirect URL is http://localhost:3000/oauth/callback\n4. Run `snow-flow auth status` to see detailed error\n\n### \"MCP servers not loading\"\n\n1. Make sure you ran `snow-flow init` in your project directory\n2. Check that .opencode/config.json exists\n3. Restart OpenCode/Claude Code after running init\n\n### \"Widget coherence validation failed\"\n\nThis means your widget's HTML, client script, and server script don't communicate properly. Use Local Sync to debug:\n\n```javascript\n// In OpenCode/Claude Code:\nsnow_pull_artifact({ sys_id: 'your_widget_sys_id', table: 'sp_widget' })\n// Edit locally, then push back\nsnow_push_artifact({ sys_id: 'your_widget_sys_id' })\n```\n\n## \uD83E\uDD1D Contributing\n\nWe welcome contributions! Snow-Flow is open source.\n\n## \uD83D\uDCDD License\n\nElastic License 2.0 - see LICENSE file for details\n\n**What this means:**\n- \u2705 Free to use, modify, and redistribute\n- \u2705 Can be used commercially\n- \u2705 Full source code access\n- \u26A0\uFE0F Cannot provide Snow-Flow as a managed service to third parties\n- \u26A0\uFE0F Cannot remove or obscure licensing/copyright notices\n\nFor full license details: https://www.elastic.co/licensing/elastic-license\n\n## \uD83D\uDE4F Acknowledgments\n\nBuilt with \u2764\uFE0F using:\n- [ServiceNow Platform](https://www.servicenow.com)\n- [Anthropic Claude](https://www.anthropic.com/claude)\n- [OpenCode AI](https://opencode.ai)\n- [Model Context Protocol (MCP)](https://modelcontextprotocol.io)\n\n---\n\n**Ready to revolutionize your ServiceNow development?**\n\n```bash\nnpm install -g snow-flow\nsnow-flow init\nsnow-flow auth login\nsnow-flow swarm \"create an awesome ServiceNow widget\"\n```\n\n\uD83D\uDE80 **Happy building!**\n";
+export declare const README_TEMPLATE = "# Snow-Flow: AI-Powered ServiceNow Development Platform \uD83D\uDE80\n\nSnow-Flow is a powerful AI development platform for ServiceNow that combines **22 specialized MCP servers** with **multi-agent orchestration** to revolutionize ServiceNow development. Build widgets, flows, workspaces, and complete applications using natural language commands.\n\n## \uD83C\uDFAF What Can Snow-Flow Do?\n\n- **Create ServiceNow Widgets** - \"Create an incident dashboard widget with real-time updates\"\n- **Build Agent Workspaces** - \"Create a workspace for IT support agents with incident lists\"\n- **Process Mining** - \"Discover hidden inefficiencies in ITSM workflows\"\n- **Deploy UI Builder Pages** - \"Build a customer portal page with service catalog\"\n- **Manage CMDB** - \"Find all Windows servers and update their maintenance windows\"\n- **Train ML Models** - \"Create a Predictive Intelligence solution to categorize incidents\"\n- **And much more!** - 22 MCP servers with 400+ tools for complete ServiceNow development\n\n## \uD83D\uDE80 Quick Start (5 Minutes)\n\n### 1. Install Snow-Flow\n\n```bash\nnpm install -g snow-flow\n```\n\n### 2. Initialize Your Project\n\n```bash\n# Create a new directory or use existing project\nmkdir my-servicenow-project\ncd my-servicenow-project\n\n# Initialize Snow-Flow (creates .env, CLAUDE.md, MCP config)\nsnow-flow init\n```\n\n### 3. Authenticate\n\n```bash\n# Authenticate with LLM provider (Claude/OpenAI/Gemini) AND ServiceNow\nsnow-flow auth login\n```\n\nThis will:\n- \u2705 Authenticate with your preferred LLM provider (via SnowCode)\n- \u2705 Save your provider choice to .env\n- \u2705 Configure ServiceNow OAuth credentials\n- \u2705 Test the connection and show your username\n\n### 4. Start Building!\n\n```bash\n# Use the swarm command to build anything in ServiceNow\nsnow-flow swarm \"create an incident dashboard widget\"\n\n# Or use SnowCode/Claude Code directly (MCP servers auto-configured)\nsnowcode  # All 22 MCP servers available automatically\n```\n\n## \uD83C\uDFAF Key Features\n\n### \uD83E\uDD16 22 Specialized MCP Servers (400+ Tools)\n\nSnow-Flow includes the most comprehensive ServiceNow MCP server collection:\n\n1. **ServiceNow Deployment** - Widget, flow, and artifact deployment\n2. **ServiceNow Operations** - Core CRUD operations and queries\n3. **ServiceNow Automation** - Background scripts and job scheduling\n4. **ServiceNow Platform Development** - Script includes, business rules, client scripts\n5. **ServiceNow Integration** - REST messages, web services, data imports\n6. **ServiceNow System Properties** - Property management and configuration\n7. **ServiceNow Update Set** - Change management and deployment tracking\n8. **ServiceNow Development Assistant** - Intelligent artifact search and editing\n9. **ServiceNow Security & Compliance** - ACLs, security policies, vulnerability scanning\n10. **ServiceNow Reporting & Analytics** - Reports, dashboards, and KPIs\n11. **ServiceNow Machine Learning** - Predictive Intelligence + TensorFlow.js\n12. **ServiceNow Knowledge & Catalog** - Knowledge base and service catalog\n13. **ServiceNow Change, Virtual Agent & PA** - Change management, chatbots, performance analytics\n14. **ServiceNow Flow, Workspace & Mobile** - Flow Designer, Agent Workspace, UI Builder\n15. **ServiceNow CMDB, Event, HR, CSM & DevOps** - Configuration management, HR services, customer service\n16. **ServiceNow Advanced Features** - Batch operations, query optimization, process mining\n17. **ServiceNow Local Development** - Artifact sync with local files for debugging\n18. **Snow-Flow Orchestration** - Multi-agent coordination and task management\n19. **Snow-Flow Memory** - Persistent memory and context management\n20. **Snow-Flow Neural** - Neural network training with TensorFlow.js\n21. **Snow-Flow Graph** - Relationship tracking and impact analysis\n22. **Snow-Flow Performance** - Performance monitoring and optimization\n\n### \uD83D\uDD04 Multi-Agent Orchestration\n\nThe `swarm` command coordinates multiple specialized agents to handle complex tasks:\n\n```bash\n# Single command handles everything: planning, execution, testing, deployment\nsnow-flow swarm \"build a complete incident management workspace with dashboards\"\n```\n\n### \uD83C\uDFA8 SnowCode + Claude Code Support\n\nSnow-Flow works seamlessly with both AI platforms:\n\n- **SnowCode**: Native Task() integration, all 22 MCP servers auto-configured\n- **Claude Code**: Full MCP support via .claude/config.json\n- **Both**: Share the same CLAUDE.md instructions and .env configuration\n\n### \uD83D\uDD10 Secure Authentication\n\n- **LLM Providers**: Authenticate via SnowCode (supports Claude, OpenAI, Google, Ollama)\n- **ServiceNow**: OAuth 2.0 with automatic token refresh\n- **Credentials**: Stored securely in .env (never committed to git)\n\n### \uD83E\uDDEA Local Development with Artifact Sync\n\nPull ServiceNow artifacts to local files, edit with your favorite tools, and push back:\n\n```bash\n# Example via SnowCode/Claude Code with MCP tools:\n# 1. Pull widget to local files\nsnow_pull_artifact({ sys_id: 'widget_sys_id', table: 'sp_widget' })\n\n# 2. Edit locally with full IDE features (search, refactor, etc.)\n# Files created in /tmp/snow-flow-artifacts/widgets/my_widget/\n\n# 3. Validate coherence\nsnow_validate_artifact_coherence({ sys_id: 'widget_sys_id' })\n\n# 4. Push changes back\nsnow_push_artifact({ sys_id: 'widget_sys_id' })\n```\n\n## \uD83D\uDCDA Usage Examples\n\n### Create a Service Portal Widget\n\n```bash\nsnow-flow swarm \"create a widget showing top 10 open incidents with priority indicators\"\n```\n\n### Build an Agent Workspace\n\n```bash\nsnow-flow swarm \"create an agent workspace for ITIL fulfillment with task lists and approvals\"\n```\n\n### Design a Flow Designer Flow\n\n```bash\nsnow-flow swarm \"create an approval flow for purchase requests over $5000\"\n```\n\n### Train a Machine Learning Model\n\n```bash\nsnow-flow swarm \"create a Predictive Intelligence solution to predict incident categories\"\n```\n\n### Build a UI Builder Page\n\n```bash\nsnow-flow swarm \"create a UI Builder page with a list of incidents and a detail panel\"\n```\n\n### Update CMDB Configuration Items\n\n```bash\nsnow-flow swarm \"find all Linux servers in Boston datacenter and update their support group\"\n```\n\n### Generate Reports and Dashboards\n\n```bash\nsnow-flow swarm \"create a dashboard showing SLA compliance trends for the last 30 days\"\n```\n\n## \uD83D\uDD27 Commands Reference\n\n### Authentication\n```bash\nsnow-flow auth login   # Authenticate with LLM provider and ServiceNow\nsnow-flow auth logout  # Logout from ServiceNow\nsnow-flow auth status  # Check authentication status\n```\n\n### Project Management\n```bash\nsnow-flow init         # Initialize Snow-Flow in current directory\nsnow-flow version      # Show Snow-Flow version\n```\n\n### Development\n```bash\nsnow-flow swarm \"<task>\"  # Multi-agent orchestration for complex tasks\n```\n\n### Direct AI Usage\n```bash\nsnowcode               # Start SnowCode with all 22 MCP servers\nclaude                 # Start Claude Code with MCP servers (if installed)\n```\n\n## \uD83D\uDEE0\uFE0F Configuration\n\n### .env File\n\nCreated by `snow-flow init`, configure these variables:\n\n```env\n# ServiceNow Instance\nSNOW_INSTANCE=your-instance.service-now.com\nSNOW_CLIENT_ID=your-oauth-client-id\nSNOW_CLIENT_SECRET=your-oauth-client-secret\n\n# LLM Provider (auto-set by auth login)\nDEFAULT_LLM_PROVIDER=anthropic  # or openai, google, ollama\n\n# Optional: Direct API key (skips SnowCode auth)\nANTHROPIC_API_KEY=sk-ant-...\n```\n\n### ServiceNow OAuth Setup\n\n1. Log into ServiceNow as admin\n2. Navigate to: **System OAuth > Application Registry**\n3. Click **New** > **Create an OAuth API endpoint for external clients**\n4. Fill in:\n   - **Name**: Snow-Flow\n   - **Client ID**: (auto-generated, copy this)\n   - **Client Secret**: (auto-generated, copy this)\n   - **Redirect URL**: http://localhost:3000/oauth/callback\n5. Save and copy Client ID and Secret to your .env file\n6. Run `snow-flow auth login` to complete authentication\n\n## \uD83D\uDCC1 Project Structure\n\nAfter running `snow-flow init`:\n\n```\nyour-project/\n\u251C\u2500\u2500 .env                    # Environment configuration (DO NOT COMMIT)\n\u251C\u2500\u2500 .env.example            # Example environment template\n\u251C\u2500\u2500 CLAUDE.md               # AI instructions (primary)\n\u251C\u2500\u2500 AGENTS.md               # AI instructions (SnowCode copy)\n\u251C\u2500\u2500 .snowcode/              # SnowCode configuration\n\u2502   \u2514\u2500\u2500 config.json         # MCP servers for SnowCode\n\u251C\u2500\u2500 .claude/                # Claude Code configuration\n\u2502   \u2514\u2500\u2500 config.json         # MCP servers for Claude Code\n\u251C\u2500\u2500 .mcp.json               # Unified MCP server configuration\n\u251C\u2500\u2500 .snow-flow/             # Snow-Flow workspace\n\u2502   \u251C\u2500\u2500 memory/             # Persistent agent memory\n\u2502   \u2514\u2500\u2500 artifacts/          # Local artifact cache\n\u2514\u2500\u2500 README.md               # This file\n```\n\n## \uD83C\uDF93 Learning Resources\n\n### Documentation Files\n\n- **CLAUDE.md** / **AGENTS.md** - Complete AI instructions and best practices\n- **SERVICENOW-OAUTH-SETUP.md** - Detailed OAuth configuration guide\n- **TRADEMARK.md** - Brand guidelines and usage\n\n### Online Resources\n\n- [ServiceNow Developer Portal](https://developer.servicenow.com)\n- [ServiceNow Flow Designer Documentation](https://docs.servicenow.com/flow-designer)\n- [ServiceNow REST API Reference](https://docs.servicenow.com/rest-api)\n\n## \uD83D\uDD12 Security Best Practices\n\n1. **Never commit .env** - Already in .gitignore\n2. **Use OAuth 2.0** - More secure than basic authentication\n3. **Rotate credentials** - Change OAuth secrets periodically\n4. **Test in dev first** - Always test in development instances\n5. **Use Update Sets** - Track all changes professionally\n6. **Review AI output** - Always review generated code before deployment\n\n## \uD83D\uDC1B Troubleshooting\n\n### \"SnowCode is not installed\"\n\n```bash\nnpm install -g snowcode-ai\n```\n\n### \"ServiceNow authentication failed\"\n\n1. Check your .env credentials are correct\n2. Verify OAuth application is configured in ServiceNow\n3. Ensure redirect URL is http://localhost:3000/oauth/callback\n4. Run `snow-flow auth status` to see detailed error\n\n### \"MCP servers not loading\"\n\n1. Make sure you ran `snow-flow init` in your project directory\n2. Check that .snowcode/config.json exists\n3. Restart SnowCode/Claude Code after running init\n\n### \"Widget coherence validation failed\"\n\nThis means your widget's HTML, client script, and server script don't communicate properly. Use Local Sync to debug:\n\n```javascript\n// In SnowCode/Claude Code:\nsnow_pull_artifact({ sys_id: 'your_widget_sys_id', table: 'sp_widget' })\n// Edit locally, then push back\nsnow_push_artifact({ sys_id: 'your_widget_sys_id' })\n```\n\n## \uD83E\uDD1D Contributing\n\nWe welcome contributions! Snow-Flow is open source.\n\n## \uD83D\uDCDD License\n\nElastic License 2.0 - see LICENSE file for details\n\n**What this means:**\n- \u2705 Free to use, modify, and redistribute\n- \u2705 Can be used commercially\n- \u2705 Full source code access\n- \u26A0\uFE0F Cannot provide Snow-Flow as a managed service to third parties\n- \u26A0\uFE0F Cannot remove or obscure licensing/copyright notices\n\nFor full license details: https://www.elastic.co/licensing/elastic-license\n\n## \uD83D\uDE4F Acknowledgments\n\nBuilt with \u2764\uFE0F using:\n- [ServiceNow Platform](https://www.servicenow.com)\n- [Anthropic Claude](https://www.anthropic.com/claude)\n- [SnowCode AI](https://snowcode.ai)\n- [Model Context Protocol (MCP)](https://modelcontextprotocol.io)\n\n---\n\n**Ready to revolutionize your ServiceNow development?**\n\n```bash\nnpm install -g snow-flow\nsnow-flow init\nsnow-flow auth login\nsnow-flow swarm \"create an awesome ServiceNow widget\"\n```\n\n\uD83D\uDE80 **Happy building!**\n";
 //# sourceMappingURL=readme-template.d.ts.map

package/dist/templates/readme-template.js

@@ -42,7 +42,7 @@ snow-flow auth login
 \`\`\`
 
 This will:
-- ✅ Authenticate with your preferred LLM provider (via OpenCode)
+- ✅ Authenticate with your preferred LLM provider (via SnowCode)
 - ✅ Save your provider choice to .env
 - ✅ Configure ServiceNow OAuth credentials
 - ✅ Test the connection and show your username
@@ -53,8 +53,8 @@ This will:
 # Use the swarm command to build anything in ServiceNow
 snow-flow swarm "create an incident dashboard widget"
 
-# Or use OpenCode/Claude Code directly (MCP servers auto-configured)
-opencode  # All 22 MCP servers available automatically
+# Or use SnowCode/Claude Code directly (MCP servers auto-configured)
+snowcode  # All 22 MCP servers available automatically
 \`\`\`
 
 ## 🎯 Key Features
@@ -95,17 +95,17 @@ The \`swarm\` command coordinates multiple specialized agents to handle complex
 snow-flow swarm "build a complete incident management workspace with dashboards"
 \`\`\`
 
-### 🎨 OpenCode + Claude Code Support
+### 🎨 SnowCode + Claude Code Support
 
 Snow-Flow works seamlessly with both AI platforms:
 
-- **OpenCode**: Native Task() integration, all 22 MCP servers auto-configured
+- **SnowCode**: Native Task() integration, all 22 MCP servers auto-configured
 - **Claude Code**: Full MCP support via .claude/config.json
 - **Both**: Share the same CLAUDE.md instructions and .env configuration
 
 ### 🔐 Secure Authentication
 
-- **LLM Providers**: Authenticate via OpenCode (supports Claude, OpenAI, Google, Ollama)
+- **LLM Providers**: Authenticate via SnowCode (supports Claude, OpenAI, Google, Ollama)
 - **ServiceNow**: OAuth 2.0 with automatic token refresh
 - **Credentials**: Stored securely in .env (never committed to git)
 
@@ -114,7 +114,7 @@ Snow-Flow works seamlessly with both AI platforms:
 Pull ServiceNow artifacts to local files, edit with your favorite tools, and push back:
 
 \`\`\`bash
-# Example via OpenCode/Claude Code with MCP tools:
+# Example via SnowCode/Claude Code with MCP tools:
 # 1. Pull widget to local files
 snow_pull_artifact({ sys_id: 'widget_sys_id', table: 'sp_widget' })
 
@@ -194,7 +194,7 @@ snow-flow swarm "<task>"  # Multi-agent orchestration for complex tasks
 
 ### Direct AI Usage
 \`\`\`bash
-opencode               # Start OpenCode with all 22 MCP servers
+snowcode               # Start SnowCode with all 22 MCP servers
 claude                 # Start Claude Code with MCP servers (if installed)
 \`\`\`
 
@@ -213,7 +213,7 @@ SNOW_CLIENT_SECRET=your-oauth-client-secret
 # LLM Provider (auto-set by auth login)
 DEFAULT_LLM_PROVIDER=anthropic  # or openai, google, ollama
 
-# Optional: Direct API key (skips OpenCode auth)
+# Optional: Direct API key (skips SnowCode auth)
 ANTHROPIC_API_KEY=sk-ant-...
 \`\`\`
 
@@ -239,9 +239,9 @@ your-project/
 ├── .env                    # Environment configuration (DO NOT COMMIT)
 ├── .env.example            # Example environment template
 ├── CLAUDE.md               # AI instructions (primary)
-├── AGENTS.md               # AI instructions (OpenCode copy)
-├── .opencode/              # OpenCode configuration
-│   └── config.json         # MCP servers for OpenCode
+├── AGENTS.md               # AI instructions (SnowCode copy)
+├── .snowcode/              # SnowCode configuration
+│   └── config.json         # MCP servers for SnowCode
 ├── .claude/                # Claude Code configuration
 │   └── config.json         # MCP servers for Claude Code
 ├── .mcp.json               # Unified MCP server configuration
@@ -276,10 +276,10 @@ your-project/
 
 ## 🐛 Troubleshooting
 
-### "OpenCode is not installed"
+### "SnowCode is not installed"
 
 \`\`\`bash
-npm install -g opencode-ai
+npm install -g snowcode-ai
 \`\`\`
 
 ### "ServiceNow authentication failed"
@@ -292,15 +292,15 @@ npm install -g opencode-ai
 ### "MCP servers not loading"
 
 1. Make sure you ran \`snow-flow init\` in your project directory
-2. Check that .opencode/config.json exists
-3. Restart OpenCode/Claude Code after running init
+2. Check that .snowcode/config.json exists
+3. Restart SnowCode/Claude Code after running init
 
 ### "Widget coherence validation failed"
 
 This means your widget's HTML, client script, and server script don't communicate properly. Use Local Sync to debug:
 
 \`\`\`javascript
-// In OpenCode/Claude Code:
+// In SnowCode/Claude Code:
 snow_pull_artifact({ sys_id: 'your_widget_sys_id', table: 'sp_widget' })
 // Edit locally, then push back
 snow_push_artifact({ sys_id: 'your_widget_sys_id' })
@@ -328,7 +328,7 @@ For full license details: https://www.elastic.co/licensing/elastic-license
 Built with ❤️ using:
 - [ServiceNow Platform](https://www.servicenow.com)
 - [Anthropic Claude](https://www.anthropic.com/claude)
-- [OpenCode AI](https://opencode.ai)
+- [SnowCode AI](https://snowcode.ai)
 - [Model Context Protocol (MCP)](https://modelcontextprotocol.io)
 
 ---

package/dist/utils/artifact-local-sync.d.ts

@@ -1,7 +1,7 @@
 /**
  * Artifact Local Sync System
  *
- * Creates temporary local files from ServiceNow artifacts so OpenCode
+ * Creates temporary local files from ServiceNow artifacts so SnowCode
  * (or Claude Code) can use its native tools (search, edit, multi-file operations, etc.)
  * Then syncs changes back to ServiceNow.
  *

package/dist/utils/artifact-local-sync.js

@@ -2,7 +2,7 @@
 /**
  * Artifact Local Sync System
  *
- * Creates temporary local files from ServiceNow artifacts so OpenCode
+ * Creates temporary local files from ServiceNow artifacts so SnowCode
  * (or Claude Code) can use its native tools (search, edit, multi-file operations, etc.)
  * Then syncs changes back to ServiceNow.
  *
@@ -235,7 +235,7 @@ class ArtifactLocalSync {
         console.log(`📁 Location: ${displayPath}`);
         console.log(`📄 Files created:`);
         files.forEach(f => console.log(`   - ${f.filename} (${f.type})`));
-        console.log(`\n💡 OpenCode (or Claude Code) can now use its native tools on these files!`);
+        console.log(`\n💡 SnowCode (or Claude Code) can now use its native tools on these files!`);
         console.log(`   Edit, search, refactor - then run 'pushArtifact' to sync back.`);
         return artifact;
     }
@@ -524,7 +524,7 @@ ${config.coherenceRules.map(rule => `### ${rule.name}\n${rule.description}`).joi
         const instructions = `
 ## Editing Instructions
 
-1. **Edit files** using your AI coding assistant's native tools (OpenCode, Claude Code, etc.)
+1. **Edit files** using your AI coding assistant's native tools (SnowCode, Claude Code, etc.)
 2. **Maintain coherence** between related files
 ${config.fieldMappings.some(fm => fm.validateES5) ? '3. **Use ES5 only** in server-side scripts (no modern JavaScript)' : ''}
 4. **Test locally** if possible
@@ -609,7 +609,7 @@ ${files.map(f => `- **${f.filename}** - ${f.field}`).join('\n')}
 
 ## Editing Instructions
 
-1. **Edit files** using your AI coding assistant's native tools (OpenCode, Claude Code, etc.)
+1. **Edit files** using your AI coding assistant's native tools (SnowCode, Claude Code, etc.)
 2. **Maintain coherence** between template, scripts, and CSS
 3. **Use ES5 only** in server script (no modern JavaScript)
 4. **Test locally** if possible

package/dist/utils/snow-oauth.d.ts

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 /**
- * ServiceNow OAuth Authentication Utility with Dynamic Port
- * Handles OAuth2 flow for ServiceNow integration
+ * ServiceNow OAuth Authentication Utility with Code Paste Flow
+ * Handles OAuth2 flow for ServiceNow integration (Claude-style)
  */
 export interface ServiceNowAuthResult {
     success: boolean;
@@ -45,13 +45,18 @@ export declare class ServiceNowOAuth {
      * Check if a specific port is available
      */
     private checkPortAvailable;
-    /**
-     * Initialize OAuth flow - opens browser and handles callback
-     */
     /**
      * 🔧 CRIT-002 FIX: Normalize instance URL to prevent trailing slash 400 errors
      */
     private normalizeInstanceUrl;
+    /**
+     * 🎯 NEW: Simplified OAuth flow with code paste (Claude-style)
+     * No local server required - user manually pastes authorization code
+     */
+    authenticateWithCodePaste(instance: string, clientId: string, clientSecret: string): Promise<ServiceNowAuthResult>;
+    /**
+     * Original OAuth flow with local server (fallback)
+     */
     authenticate(instance: string, clientId: string, clientSecret: string): Promise<ServiceNowAuthResult>;
     /**
      * Generate ServiceNow OAuth authorization URL
@@ -59,6 +64,7 @@ export declare class ServiceNowOAuth {
     private generateAuthUrl;
     /**
      * Start local HTTP server to handle OAuth callback
+     * Also supports manual callback URL paste as fallback
      */
     private startCallbackServer;
     /**

package/dist/utils/snow-oauth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"snow-oauth.d.ts","sourceRoot":"","sources":["../../src/utils/snow-oauth.ts"],"names":[],"mappings":";AACA;;;GAGG;AAeH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AASD,qBAAa,eAAe;IAC1B,OAAO,CAAC,WAAW,CAAC,CAAmB;IACvC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,cAAc,CAAC,CAAS;IAChC,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,aAAa,CAAC,CAAS;IAG/B,OAAO,CAAC,gBAAgB,CAAa;IACrC,OAAO,CAAC,iBAAiB,CAAa;IACtC,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAS;IACjD,OAAO,CAAC,QAAQ,CAAC,6BAA6B,CAAM;;IAQpD;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAmBlC;;OAEG;IACH,OAAO,CAAC,aAAa;IAKrB;;OAEG;IACH,OAAO,CAAC,YAAY;IAUpB;;OAEG;YACW,kBAAkB;IAiBhC;;OAEG;IACH;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAkBtB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA2F3G;;OAEG;IACH,OAAO,CAAC,eAAe;IAevB;;OAEG;YACW,mBAAmB;IAwJjC;;OAEG;YACW,qBAAqB;IA0DnC;;OAEG;YACW,UAAU;IAqBxB;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC;IAQhC;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAezC;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAoC9C;;OAEG;IACU,kBAAkB,CAAC,MAAM,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAqE5E;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAS7B;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,GAAG,CAAC;IAIrC;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;IAqH9D;;;;OAIG;IACH,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;IA+C/E;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;CAG9D"}
+{"version":3,"file":"snow-oauth.d.ts","sourceRoot":"","sources":["../../src/utils/snow-oauth.ts"],"names":[],"mappings":";AACA;;;GAGG;AAgBH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AASD,qBAAa,eAAe;IAC1B,OAAO,CAAC,WAAW,CAAC,CAAmB;IACvC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,cAAc,CAAC,CAAS;IAChC,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,aAAa,CAAC,CAAS;IAG/B,OAAO,CAAC,gBAAgB,CAAa;IACrC,OAAO,CAAC,iBAAiB,CAAa;IACtC,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAS;IACjD,OAAO,CAAC,QAAQ,CAAC,6BAA6B,CAAM;;IAQpD;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAmBlC;;OAEG;IACH,OAAO,CAAC,aAAa;IAKrB;;OAEG;IACH,OAAO,CAAC,YAAY;IAUpB;;OAEG;YACW,kBAAkB;IAiBhC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAkB5B;;;OAGG;IACG,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA2GxH;;OAEG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA6F3G;;OAEG;IACH,OAAO,CAAC,eAAe;IAevB;;;OAGG;YACW,mBAAmB;IA2OjC;;OAEG;YACW,qBAAqB;IA8FnC;;OAEG;YACW,UAAU;IAqBxB;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC;IAQhC;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAezC;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAoC9C;;OAEG;IACU,kBAAkB,CAAC,MAAM,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAqE5E;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAS7B;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,GAAG,CAAC;IAIrC;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;IAqH9D;;;;OAIG;IACH,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;IA+C/E;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;CAG9D"}