snow-flow 3.3.6 → 3.3.8

package/.mcp.json.template

@@ -131,6 +131,18 @@
         "SNOW_CLIENT_ID": "{{SNOW_CLIENT_ID}}",
         "SNOW_CLIENT_SECRET": "{{SNOW_CLIENT_SECRET}}"
       }
+    },
+    "servicenow-system-properties": {
+      "command": "node",
+      "args": [
+        "{{PROJECT_ROOT}}/dist/mcp/servicenow-system-properties-mcp.js"
+      ],
+      "description": "System property management via official ServiceNow APIs: get/set/list/delete properties, bulk operations, import/export JSON, validate values, search, categories, audit history - all using standard Table API on sys_properties",
+      "env": {
+        "SNOW_INSTANCE": "{{SNOW_INSTANCE}}",
+        "SNOW_CLIENT_ID": "{{SNOW_CLIENT_ID}}",
+        "SNOW_CLIENT_SECRET": "{{SNOW_CLIENT_SECRET}}"
+      }
     }
   }
 }

package/dist/dynamic-version.js

@@ -36,7 +36,7 @@ function getDynamicVersion() {
         console.warn('Warning: Could not read version from package.json:', error);
     }
     // Fallback to hardcoded version
-    return '3.3.6';
+    return '3.3.8';
 }
 // Export a constant that uses the dynamic version
 exports.VERSION = getDynamicVersion();

package/dist/mcp/servicenow-deployment-mcp.js

@@ -1316,7 +1316,12 @@ ${is403Error ? '\n⚠️  **Possible False Negative**: Widget may have been crea
             const { updateSetId, updateSetName } = await this.ensureUpdateSet('Portal Page', args.page_id);
             // Validate portal page structure
             if (!args.page_id || !args.title) {
-                throw new Error('Portal page must have page_id and title');
+                this.logger.error('Portal page validation failed', {
+                    args,
+                    hasPageId: !!args.page_id,
+                    hasTitle: !!args.title
+                });
+                throw new Error(`Portal page must have page_id and title. Received: page_id=${args.page_id}, title=${args.title}`);
             }
             // Find widget sys_id if widget name is provided
             let widgetSysId = args.widget_sys_id;
@@ -1337,18 +1342,22 @@ ${is403Error ? '\n⚠️  **Possible False Negative**: Widget may have been crea
                 }
             }
             // Determine portal sys_id
-            let portalSysId = '';
-            try {
-                // Default to Employee Service Portal if available, otherwise standard Service Portal
-                const portalQuery = args.portal === 'esc' ? 'url_suffix=esc' : 'url_suffix=sp';
-                const portalResult = await this.client.searchRecords('sp_portal', portalQuery, 1);
-                if (portalResult.success && portalResult.data?.length > 0) {
-                    portalSysId = portalResult.data[0].sys_id;
-                    this.logger.info('Found portal', { portal: args.portal, sys_id: portalSysId });
+            let portalSysId = args.sp_portal || '';
+            // If sp_portal is already a sys_id (32 char hex), use it directly
+            if (!/^[a-f0-9]{32}$/.test(portalSysId)) {
+                // Not a sys_id, try to look it up
+                try {
+                    // Default to Employee Service Portal if available, otherwise standard Service Portal
+                    const portalQuery = args.portal === 'esc' ? 'url_suffix=esc' : 'url_suffix=sp';
+                    const portalResult = await this.client.searchRecords('sp_portal', portalQuery, 1);
+                    if (portalResult.success && portalResult.data?.result?.length > 0) {
+                        portalSysId = portalResult.data.result[0].sys_id;
+                        this.logger.info('Found portal', { portal: args.portal, sys_id: portalSysId });
+                    }
+                }
+                catch (error) {
+                    this.logger.warn('Failed to lookup portal, using provided value', { portal: args.portal, error });
                 }
-            }
-            catch (error) {
-                this.logger.warn('Failed to lookup portal, using default', { portal: args.portal, error });
             }
             // Create portal page
             let pageResult;
@@ -1381,8 +1390,35 @@ ${is403Error ? '\n⚠️  **Possible False Negative**: Widget may have been crea
             const credentials = await this.oauth.loadCredentials();
             // Create widget instances on the page if widget is provided
             const widgetInstances = [];
-            if (widgetSysId && args.widgets && args.widgets.length > 0) {
-                for (const widgetConfig of args.widgets) {
+            // Support both widgets array and single widget
+            const widgetsToCreate = args.widgets || [];
+            // If no widgets array but a single widget is specified, create one widget
+            if (widgetsToCreate.length === 0 && widgetSysId) {
+                widgetsToCreate.push({
+                    widget: args.widget_name || widgetSysId,
+                    width: 12,
+                    row: 1,
+                    column: 1,
+                    title: args.widget_title || args.title || '',
+                    options: args.widget_options || {}
+                });
+            }
+            if (widgetsToCreate.length > 0) {
+                for (const widgetConfig of widgetsToCreate) {
+                    // Determine widget sys_id for this widget
+                    let currentWidgetSysId = widgetSysId; // Default to the main widget
+                    // If widget config specifies a different widget, look it up
+                    if (widgetConfig.widget && widgetConfig.widget !== args.widget_name) {
+                        try {
+                            const widgetLookup = await this.client.searchRecords('sp_widget', `sys_id=${widgetConfig.widget}^ORname=${widgetConfig.widget}`, 1);
+                            if (widgetLookup.success && widgetLookup.data?.result?.length > 0) {
+                                currentWidgetSysId = widgetLookup.data.result[0].sys_id;
+                            }
+                        }
+                        catch (lookupError) {
+                            this.logger.warn('Could not find widget, using default', { widget: widgetConfig.widget });
+                        }
+                    }
                     try {
                         // Create container
                         const containerResult = await this.client.createRecord('sp_container', {
@@ -1417,10 +1453,10 @@ ${is403Error ? '\n⚠️  **Possible False Negative**: Widget may have been crea
                                     // Create widget instance
                                     const instanceResult = await this.client.createRecord('sp_instance', {
                                         sp_column: columnResult.data.sys_id,
-                                        sp_widget: widgetSysId,
+                                        sp_widget: currentWidgetSysId, // Use the current widget sys_id, not the main one
                                         order: widgetConfig.order || 100,
                                         title: widgetConfig.title || '',
-                                        options: JSON.stringify(widgetConfig.options || {}),
+                                        options: JSON.stringify(widgetConfig.options || widgetConfig.widget_parameters || {}),
                                         class_name: widgetConfig.instance_class || '',
                                         color: widgetConfig.color || 'default',
                                         active: true,
@@ -7260,7 +7296,23 @@ Use individual deployment tools like \`snow_deploy_${args.type}\` with manual co
             case 'widget':
                 return await this.deployWidget(scopedConfig);
             case 'portal_page':
-                return await this.deployPortalPage(scopedConfig);
+                // Map config fields to expected parameter names for portal_page
+                const portalPageArgs = {
+                    page_id: scopedConfig.id || scopedConfig.page_id,
+                    title: scopedConfig.title,
+                    widget_name: scopedConfig.widget_name,
+                    widget_sys_id: scopedConfig.widget_sys_id,
+                    description: scopedConfig.summary || scopedConfig.description,
+                    page_css: scopedConfig.css,
+                    portal: scopedConfig.portal || scopedConfig.sp_portal || 'sp',
+                    public: scopedConfig.public !== undefined ? scopedConfig.public : true,
+                    requires_authentication: scopedConfig.requires_authentication,
+                    draft: scopedConfig.draft || false,
+                    // Map containers to widgets format
+                    widgets: this.mapContainersToWidgets(scopedConfig.containers),
+                    ...scopedConfig // Include any other fields
+                };
+                return await this.deployPortalPage(portalPageArgs);
             case 'application':
                 return await this.deployApplication(scopedConfig);
             case 'xml_update_set':
@@ -8851,6 +8903,36 @@ c.$onInit = function() {
         await this.server.connect(transport);
         this.logger.info('ServiceNow Deployment MCP Server started');
     }
+    /**
+     * Map container structure to widget structure for portal page deployment
+     */
+    mapContainersToWidgets(containers) {
+        if (!containers || !Array.isArray(containers)) {
+            return [];
+        }
+        const widgets = [];
+        for (const container of containers) {
+            if (container.widget_instance) {
+                widgets.push({
+                    widget: container.widget_instance.widget,
+                    width: container.width || 12,
+                    row: container.row || 1,
+                    column: container.column || 1,
+                    title: container.widget_instance.title || '',
+                    options: container.widget_instance.widget_parameters || {},
+                    container_title: container.title || '',
+                    class_name: container.class_name || '',
+                    background_color: container.background_color || '',
+                    background_image: container.background_image || '',
+                    background_style: container.background_style || 'default',
+                    instance_class: container.widget_instance.class_name || '',
+                    color: container.widget_instance.color || 'default',
+                    order: container.widget_instance.order || 100
+                });
+            }
+        }
+        return widgets;
+    }
     /**
      * Escape XML special characters
      */

package/dist/mcp/servicenow-system-properties-mcp.d.ts

@@ -0,0 +1,68 @@
+/**
+ * ServiceNow System Properties MCP Server
+ *
+ * Provides comprehensive system property management through official ServiceNow APIs
+ * Uses the standard Table API on sys_properties table
+ */
+/**
+ * ServiceNow System Properties MCP Server
+ * Manages system properties through official ServiceNow REST APIs
+ */
+export declare class ServiceNowSystemPropertiesMCP {
+    private server;
+    private client;
+    private propertyCache;
+    constructor();
+    private setupHandlers;
+    private setupTools;
+    /**
+     * Get a system property value
+     */
+    private getProperty;
+    /**
+     * Set or create a system property
+     */
+    private setProperty;
+    /**
+     * List system properties
+     */
+    private listProperties;
+    /**
+     * Delete a system property
+     */
+    private deleteProperty;
+    /**
+     * Search properties
+     */
+    private searchProperties;
+    /**
+     * Bulk get properties
+     */
+    private bulkGetProperties;
+    /**
+     * Bulk set properties
+     */
+    private bulkSetProperties;
+    /**
+     * Export properties
+     */
+    private exportProperties;
+    /**
+     * Import properties
+     */
+    private importProperties;
+    /**
+     * Validate property value
+     */
+    private validateProperty;
+    /**
+     * Get property categories
+     */
+    private getCategories;
+    /**
+     * Get property audit history
+     */
+    private getPropertyHistory;
+    start(): Promise<void>;
+}
+//# sourceMappingURL=servicenow-system-properties-mcp.d.ts.map