snow-flow 3.5.5 → 3.5.8

package/dist/mcp/servicenow-local-development-mcp.d.ts

@@ -8,5 +8,20 @@
  *
  * THIS IS THE KEY TO POWERFUL SERVICENOW DEVELOPMENT!
  */
-export {};
+import { EnhancedBaseMCPServer } from './shared/enhanced-base-mcp-server.js';
+export declare class ServiceNowLocalDevelopmentMCP extends EnhancedBaseMCPServer {
+    private syncManager;
+    constructor();
+    private setupSyncManager;
+    private setupHandlers;
+    private pullArtifact;
+    private pushArtifact;
+    private getSyncStatus;
+    private listSupportedArtifacts;
+    private validateArtifactCoherence;
+    private syncCleanup;
+    private convertToES5;
+    private pullWidget;
+    private pushWidget;
+}
 //# sourceMappingURL=servicenow-local-development-mcp.d.ts.map

package/dist/mcp/servicenow-local-development-mcp.js

@@ -10,6 +10,7 @@
  * THIS IS THE KEY TO POWERFUL SERVICENOW DEVELOPMENT!
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServiceNowLocalDevelopmentMCP = void 0;
 const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
 const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
 const enhanced_base_mcp_server_js_1 = require("./shared/enhanced-base-mcp-server.js");
@@ -211,7 +212,9 @@ class ServiceNowLocalDevelopmentMCP extends enhanced_base_mcp_server_js_1.Enhanc
                         throw new types_js_1.McpError(types_js_1.ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
                 }
                 this.logger.info(`✅ Tool ${name} completed successfully`);
-                return result;
+                return {
+                    content: result.content
+                };
             }
             catch (error) {
                 const errorMessage = error instanceof Error ? error.message : String(error);
@@ -417,11 +420,13 @@ class ServiceNowLocalDevelopmentMCP extends enhanced_base_mcp_server_js_1.Enhanc
         return this.pushArtifact(args);
     }
 }
+exports.ServiceNowLocalDevelopmentMCP = ServiceNowLocalDevelopmentMCP;
 // Start the server
 async function main() {
-    const server = new ServiceNowLocalDevelopmentMCP();
+    const mcpServer = new ServiceNowLocalDevelopmentMCP();
     const transport = new stdio_js_1.StdioServerTransport();
-    await server.server.connect(transport);
+    // Access server through a public method
+    await mcpServer.server.connect(transport);
     console.error('🚀 ServiceNow Local Development MCP Server started');
 }
 if (require.main === module) {

package/dist/mcp/shared/enhanced-base-mcp-server.d.ts

@@ -4,18 +4,19 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { ServiceNowClientWithTracking } from '../../utils/servicenow-client-with-tracking.js';
 import { MCPLogger } from './mcp-logger.js';
-import { SnowOAuth } from '../../utils/snow-oauth.js';
+import { ServiceNowOAuth } from '../../utils/snow-oauth.js';
 export interface MCPToolResult {
     content: Array<{
         type: string;
         text: string;
     }>;
+    [key: string]: unknown;
 }
 export declare abstract class EnhancedBaseMCPServer {
     protected server: Server;
     protected client: ServiceNowClientWithTracking;
     protected logger: MCPLogger;
-    protected oauth: SnowOAuth;
+    protected oauth: ServiceNowOAuth;
     protected isAuthenticated: boolean;
     constructor(name: string, version?: string);
     /**

package/dist/mcp/shared/enhanced-base-mcp-server.js

@@ -19,7 +19,7 @@ class EnhancedBaseMCPServer {
         // Create enhanced client with tracking
         this.client = new servicenow_client_with_tracking_js_1.ServiceNowClientWithTracking(this.logger);
         // Initialize OAuth
-        this.oauth = new snow_oauth_js_1.SnowOAuth();
+        this.oauth = new snow_oauth_js_1.ServiceNowOAuth();
         // Create server with capabilities
         this.server = new index_js_1.Server({
             name,

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

@@ -7,7 +7,7 @@
  *
  * THIS IS THE BRIDGE BETWEEN SERVICENOW AND CLAUDE CODE!
  */
-import { ServiceNowClient } from './servicenow-client';
+import { ServiceNowClient } from './servicenow-client.js';
 import { ArtifactTypeConfig, FieldMapping, ValidationResult } from './artifact-sync/artifact-registry';
 export interface LocalArtifact {
     sys_id: string;

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

@@ -46,13 +46,13 @@ exports.ArtifactLocalSync = void 0;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const os = __importStar(require("os"));
-const smart_field_fetcher_1 = require("./smart-field-fetcher");
+const smart_field_fetcher_js_1 = require("./smart-field-fetcher.js");
 const artifact_registry_1 = require("./artifact-sync/artifact-registry");
 class ArtifactLocalSync {
     constructor(client) {
         this.artifacts = new Map();
         this.client = client;
-        this.smartFetcher = new smart_field_fetcher_1.SmartFieldFetcher(client);
+        this.smartFetcher = new smart_field_fetcher_js_1.SmartFieldFetcher(client);
         // Create base directory for Snow-Flow artifacts
         this.baseDir = path.join(os.tmpdir(), 'snow-flow-artifacts');
         if (!fs.existsSync(this.baseDir)) {
@@ -84,11 +84,7 @@ class ArtifactLocalSync {
         else {
             // Generic fetch for other types
             const allFields = config.fieldMappings.map(fm => fm.serviceNowField);
-            const response = await this.client.query(tableName, {
-                query: `sys_id=${sys_id}`,
-                fields: allFields.concat(['sys_id', 'sys_created_on', 'sys_updated_on']),
-                limit: 1
-            });
+            const response = await this.client.searchRecords(tableName, `sys_id=${sys_id}`, 1);
             artifactData = response.result?.[0];
         }
         if (!artifactData) {
@@ -320,7 +316,7 @@ class ArtifactLocalSync {
         // Update in ServiceNow
         try {
             console.log(`\n📤 Updating ${config.displayName} in ServiceNow...`);
-            await this.client.update(config.tableName, sys_id, updates);
+            await this.client.updateRecord(config.tableName, sys_id, updates);
             artifact.syncStatus = 'synced';
             artifact.lastSyncedAt = new Date();
             console.log(`✅ ${config.displayName} successfully updated in ServiceNow!`);
@@ -382,7 +378,7 @@ class ArtifactLocalSync {
         // Update in ServiceNow
         try {
             console.log(`\n📤 Updating widget in ServiceNow...`);
-            await this.client.update('sp_widget', sys_id, updates);
+            await this.client.updateRecord('sp_widget', sys_id, updates);
             artifact.syncStatus = 'synced';
             artifact.lastSyncedAt = new Date();
             console.log(`✅ Widget successfully updated in ServiceNow!`);
@@ -647,11 +643,7 @@ snow-flow sync status ${widget.sys_id}
         const tables = Object.keys(artifact_registry_1.ARTIFACT_REGISTRY);
         for (const table of tables) {
             try {
-                const response = await this.client.query(table, {
-                    query: `sys_id=${sys_id}`,
-                    fields: ['sys_id'],
-                    limit: 1
-                });
+                const response = await this.client.searchRecords(table, `sys_id=${sys_id}`, 1);
                 if (response.result?.[0]) {
                     console.log(`🎆 Found artifact in table: ${table}`);
                     return this.pullArtifact(table, sys_id);

package/dist/utils/servicenow-client-with-tracking.d.ts

@@ -10,6 +10,10 @@ export declare class ServiceNowClientWithTracking extends ServiceNowClient {
      * Override makeRequest to add tracking
      */
     makeRequest(config: any): Promise<any>;
+    /**
+     * Override searchRecordsWithFields to add tracking
+     */
+    searchRecordsWithFields(table: string, query: string, fields: string[], limit?: number): Promise<any>;
     /**
      * Override searchRecords to add tracking
      */

package/dist/utils/servicenow-client-with-tracking.js

@@ -36,6 +36,27 @@ class ServiceNowClientWithTracking extends servicenow_client_js_1.ServiceNowClie
             throw error;
         }
     }
+    /**
+     * Override searchRecordsWithFields to add tracking
+     */
+    async searchRecordsWithFields(table, query, fields, limit = 10) {
+        this.mcpLogger.progress(`Searching ${table} with specific fields: ${fields.join(', ')}`);
+        try {
+            const result = await super.searchRecordsWithFields(table, query, fields, limit);
+            // Estimate tokens based on fields requested
+            const fieldCount = fields.length;
+            const estimatedTokens = Math.min(fieldCount * 100, 1000); // Rough estimate
+            this.mcpLogger.trackTokens(estimatedTokens, 0);
+            if (result?.data?.result?.length > 0) {
+                this.mcpLogger.info(`Found ${result.data.result.length} records with ${fieldCount} fields`);
+            }
+            return result;
+        }
+        catch (error) {
+            this.mcpLogger.error('Search with fields failed', error);
+            throw error;
+        }
+    }
     /**
      * Override searchRecords to add tracking
      */
@@ -106,7 +127,7 @@ class ServiceNowClientWithTracking extends servicenow_client_js_1.ServiceNowClie
     async getRecord(table, sysId, fields) {
         this.mcpLogger.progress(`Fetching ${table} record: ${sysId}`);
         try {
-            const result = await super.getRecord(table, sysId, fields);
+            const result = await super.getRecord(table, sysId);
             // Estimate tokens
             if (result?.data?.result) {
                 const responseSize = JSON.stringify(result.data.result).length;

package/dist/utils/servicenow-client.d.ts

@@ -156,6 +156,10 @@ export declare class ServiceNowClient {
      * Get multiple records from a table
      */
     getRecords(table: string, params?: any): Promise<ServiceNowAPIResponse<any[]>>;
+    /**
+     * Search records with specific fields
+     */
+    searchRecordsWithFields(table: string, query: string, fields: string[], limit?: number): Promise<ServiceNowAPIResponse<any>>;
     /**
      * Search records in a table using encoded query
      */

package/dist/utils/servicenow-client.js

@@ -1039,6 +1039,33 @@ class ServiceNowClient {
             };
         }
     }
+    /**
+     * Search records with specific fields
+     */
+    async searchRecordsWithFields(table, query, fields, limit = 10) {
+        try {
+            await this.ensureAuthenticated();
+            const url = `/api/now/table/${table}`;
+            const params = {
+                sysparm_query: query,
+                sysparm_limit: limit.toString(),
+                sysparm_fields: fields.join(',')
+            };
+            const response = await this.client.get(url, { params });
+            return {
+                success: true,
+                data: response.data
+            };
+        }
+        catch (error) {
+            console.error('API Error:', error);
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+                data: null
+            };
+        }
+    }
     /**
      * Search records in a table using encoded query
      */

package/dist/utils/smart-field-fetcher.d.ts

@@ -4,7 +4,7 @@
  * Intelligently fetches large artifacts by splitting fields into chunks
  * while maintaining context relationships between fields.
  */
-import { ServiceNowClient } from './servicenow-client';
+import { ServiceNowClient } from './servicenow-client.js';
 export interface FetchStrategy {
     table: string;
     sys_id: string;

package/dist/utils/smart-field-fetcher.js

@@ -8,7 +8,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SmartFieldFetcher = void 0;
 exports.createFetchStrategyHint = createFetchStrategyHint;
-const artifact_registry_1 = require("./artifact-sync/artifact-registry");
+const artifact_registry_js_1 = require("./artifact-sync/artifact-registry.js");
 // Widget field groups with relationship context - 20K per field for better context
 const WIDGET_FIELD_GROUPS = [
     {
@@ -112,7 +112,7 @@ class SmartFieldFetcher {
     async fetchArtifact(table, sys_id) {
         console.log(`\n🔍 Smart fetching ${table}: ${sys_id}`);
         const fieldGroups = this.getFieldGroups(table);
-        const config = (0, artifact_registry_1.getArtifactConfig)(table);
+        const config = (0, artifact_registry_js_1.getArtifactConfig)(table);
         const results = {
             _fetch_strategy: 'smart_chunked',
             _context_hint: config ? `${config.displayName} - fields fetched in groups to respect token limits` : 'Fields fetched separately but are related',
@@ -122,14 +122,10 @@ class SmartFieldFetcher {
         for (const group of fieldGroups) {
             console.log(`📦 Fetching ${group.groupName}: ${group.description}`);
             try {
-                const response = await this.client.query(table, {
-                    query: `sys_id=${sys_id}`,
-                    fields: group.fields,
-                    limit: 1
-                });
-                if (response.result?.[0]) {
+                const response = await this.client.getRecord(table, sys_id);
+                if (response) {
                     results._field_groups[group.groupName] = {
-                        data: response.result[0],
+                        data: response,
                         description: group.description,
                         fields: group.fields
                     };
@@ -156,38 +152,103 @@ class SmartFieldFetcher {
      * (Wrapper for backward compatibility)
      */
     async fetchWidget(sys_id) {
-        return this.fetchArtifact('sp_widget', sys_id);
         console.log(`\n🔍 Smart fetching widget: ${sys_id}`);
         const results = {
             _fetch_strategy: 'smart_chunked',
             _context_hint: 'Widget fields fetched separately but are interconnected: template references {{data.x}} from server script, calls methods from client script, and uses CSS classes',
             _field_groups: {}
         };
-        // Fetch each field group
-        for (const group of WIDGET_FIELD_GROUPS) {
-            console.log(`📦 Fetching ${group.groupName}: ${group.description}`);
-            try {
-                const response = await this.client.query('sp_widget', {
-                    query: `sys_id=${sys_id}`,
-                    fields: group.fields,
-                    limit: 1
-                });
-                if (response.result?.[0]) {
+        // Try to fetch all fields first, then fall back to individual fields if too large
+        console.log(`📦 Attempting to fetch complete widget data...`);
+        try {
+            // Try to get all fields at once
+            const response = await this.client.searchRecords('sp_widget', `sys_id=${sys_id}`, 1);
+            if (response && response.result && response.result.length > 0) {
+                const widgetData = response.result[0];
+                console.log(`✅ Successfully fetched complete widget`);
+                // Organize into field groups for better context
+                for (const group of WIDGET_FIELD_GROUPS) {
+                    const groupData = {};
+                    for (const fieldName of group.fields) {
+                        if (widgetData[fieldName] !== undefined) {
+                            groupData[fieldName] = widgetData[fieldName];
+                        }
+                    }
                     results._field_groups[group.groupName] = {
-                        data: response.result[0],
+                        data: groupData,
                         description: group.description,
                         fields: group.fields
                     };
-                    // Add to flat structure for easy access
-                    Object.assign(results, response.result[0]);
                 }
+                // Add complete widget data to flat structure
+                Object.assign(results, widgetData);
             }
-            catch (error) {
-                console.log(`⚠️ Failed to fetch ${group.groupName}: ${error.message}`);
-                // If group fails due to size, fetch fields individually
-                if (error.message?.includes('exceeds maximum allowed tokens')) {
-                    results._field_groups[group.groupName] = await this.fetchFieldsIndividually('sp_widget', sys_id, group.fields, group.description);
+            else {
+                throw new Error('Widget not found');
+            }
+        }
+        catch (error) {
+            console.log(`⚠️ Complete fetch failed: ${error.message}`);
+            console.log(`🔄 Switching to field-by-field fetching...`);
+            // Fall back to fetching fields per group or individually
+            for (const group of WIDGET_FIELD_GROUPS) {
+                console.log(`📦 Fetching ${group.groupName}: ${group.description}`);
+                try {
+                    // Try to fetch all fields in this group at once
+                    const groupResponse = await this.client.searchRecordsWithFields('sp_widget', `sys_id=${sys_id}`, group.fields, 1);
+                    if (groupResponse && groupResponse.success && groupResponse.data && groupResponse.data.result && groupResponse.data.result.length > 0) {
+                        const groupData = groupResponse.data.result[0];
+                        console.log(`  ✅ Successfully fetched ${group.groupName}`);
+                        results._field_groups[group.groupName] = {
+                            data: groupData,
+                            description: group.description,
+                            fields: group.fields
+                        };
+                        // Add to flat structure
+                        Object.assign(results, groupData);
+                    }
+                    else {
+                        throw new Error('No data returned for group');
+                    }
                 }
+                catch (groupError) {
+                    console.log(`  ⚠️ Group ${group.groupName} failed, fetching fields individually...`);
+                    // If group fails, fetch fields one by one
+                    const groupData = {};
+                    for (const fieldName of group.fields) {
+                        console.log(`    📄 Fetching field: ${fieldName}`);
+                        try {
+                            // Fetch just this single field
+                            const fieldResponse = await this.client.searchRecordsWithFields('sp_widget', `sys_id=${sys_id}`, [fieldName], 1);
+                            if (fieldResponse && fieldResponse.success && fieldResponse.data && fieldResponse.data.result && fieldResponse.data.result.length > 0) {
+                                const fieldValue = fieldResponse.data.result[0][fieldName];
+                                if (fieldValue !== undefined && fieldValue !== null) {
+                                    groupData[fieldName] = fieldValue;
+                                    results[fieldName] = fieldValue; // Also add to flat structure
+                                    console.log(`      ✅ Got ${fieldName} (${typeof fieldValue === 'string' ? fieldValue.length : 0} chars)`);
+                                }
+                                else {
+                                    groupData[fieldName] = '';
+                                    console.log(`      ⚠️ ${fieldName} is empty`);
+                                }
+                            }
+                        }
+                        catch (fieldError) {
+                            console.log(`      ❌ Failed to fetch ${fieldName}: ${fieldError.message}`);
+                            groupData[fieldName] = ''; // Empty string for failed fields
+                        }
+                    }
+                    results._field_groups[group.groupName] = {
+                        data: groupData,
+                        description: group.description,
+                        fields: group.fields,
+                        _fetched_individually: true
+                    };
+                }
+            }
+            // Make sure we have at least the sys_id
+            if (!results.sys_id) {
+                results.sys_id = sys_id;
             }
         }
         // Add coherence validation hints
@@ -222,13 +283,9 @@ class SmartFieldFetcher {
         for (const field of fields) {
             try {
                 console.log(`    📄 Fetching field: ${field}`);
-                const response = await this.client.query(table, {
-                    query: `sys_id=${sys_id}`,
-                    fields: [field],
-                    limit: 1
-                });
-                if (response.result?.[0]) {
-                    result.data[field] = response.result[0][field];
+                const response = await this.client.getRecord(table, sys_id);
+                if (response) {
+                    result.data[field] = response[field];
                     result._field_status[field] = 'success';
                 }
             }
@@ -284,11 +341,7 @@ class SmartFieldFetcher {
         // Use CONTAINS operator for field search
         const query = `${field}CONTAINS${searchTerm}${additionalQuery ? '^' + additionalQuery : ''}`;
         try {
-            const response = await this.client.query(table, {
-                query: query,
-                fields: ['sys_id', 'name', field.substring(0, 50)], // Get preview of field
-                limit: 10
-            });
+            const response = await this.client.searchRecords(table, query, 10);
             console.log(`  ✅ Found ${response.result?.length || 0} matches`);
             return response.result || [];
         }
@@ -311,7 +364,7 @@ class SmartFieldFetcher {
                 return BUSINESS_RULE_FIELD_GROUPS;
         }
         // Try to get from artifact registry
-        const config = (0, artifact_registry_1.getArtifactConfig)(table);
+        const config = (0, artifact_registry_js_1.getArtifactConfig)(table);
         if (config) {
             return this.createFieldGroupsFromRegistry(config);
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "snow-flow",
-  "version": "3.5.5",
+  "version": "3.5.8",
   "description": "ServiceNow development framework with MCP server integration. Executes background scripts using ES5 JavaScript only (ServiceNow Rhino engine requirement). Provides 18 MCP servers including local development sync for editing ServiceNow artifacts with Claude Code native tools, widget deployment with coherence validation, table operations, script execution, machine learning, advanced features, and comprehensive platform management.",
   "main": "dist/index.js",
   "type": "commonjs",