snow-flow 4.6.9 → 5.0.1

package/dist/mcp/servicenow-mcp-unified/tools/platform/snow_create_ui_action.js

@@ -0,0 +1,159 @@
+"use strict";
+/**
+ * snow_create_ui_action - Create UI Actions
+ *
+ * Create buttons, context menu items, and form links with client/server
+ * script execution and condition control.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.author = exports.version = exports.toolDefinition = void 0;
+exports.execute = execute;
+const auth_js_1 = require("../../shared/auth.js");
+const error_handler_js_1 = require("../../shared/error-handler.js");
+exports.toolDefinition = {
+    name: 'snow_create_ui_action',
+    description: 'Create UI Action (button, context menu, form link) with client/server scripts',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            name: {
+                type: 'string',
+                description: 'UI Action name (button label)'
+            },
+            table: {
+                type: 'string',
+                description: 'Table to attach action to'
+            },
+            action_name: {
+                type: 'string',
+                description: 'Internal action name (alphanumeric, no spaces)'
+            },
+            script: {
+                type: 'string',
+                description: 'Client or server script to execute'
+            },
+            description: {
+                type: 'string',
+                description: 'Action description'
+            },
+            action_type: {
+                type: 'string',
+                enum: ['form_button', 'form_link', 'form_context_menu', 'list_choice', 'list_banner_button', 'list_bottom_button'],
+                description: 'Where the action appears',
+                default: 'form_button'
+            },
+            client: {
+                type: 'boolean',
+                description: 'Execute as client script',
+                default: true
+            },
+            onclick: {
+                type: 'string',
+                description: 'Client-side onclick handler'
+            },
+            condition: {
+                type: 'string',
+                description: 'Condition script (must return true/false)'
+            },
+            order: {
+                type: 'number',
+                description: 'Display order',
+                default: 100
+            },
+            active: {
+                type: 'boolean',
+                description: 'Activate immediately',
+                default: true
+            },
+            show_insert: {
+                type: 'boolean',
+                description: 'Show on new record forms',
+                default: true
+            },
+            show_update: {
+                type: 'boolean',
+                description: 'Show on existing record forms',
+                default: true
+            }
+        },
+        required: ['name', 'table', 'action_name', 'script']
+    }
+};
+async function execute(args, context) {
+    const { name, table, action_name, script, description = '', action_type = 'form_button', client = true, onclick, condition = '', order = 100, active = true, show_insert = true, show_update = true } = args;
+    try {
+        const client_instance = await (0, auth_js_1.getAuthenticatedClient)(context);
+        // Create UI Action
+        const uiActionData = {
+            name,
+            table,
+            action_name,
+            script,
+            comments: description,
+            client,
+            order,
+            active,
+            show_insert,
+            show_update
+        };
+        // Set action type-specific fields
+        const typeMap = {
+            form_button: { form_button: true },
+            form_link: { form_link: true },
+            form_context_menu: { form_context_menu: true },
+            list_choice: { list_choice: true },
+            list_banner_button: { list_banner_button: true },
+            list_bottom_button: { list_bottom_button: true }
+        };
+        Object.assign(uiActionData, typeMap[action_type] || typeMap.form_button);
+        if (onclick) {
+            uiActionData.onclick = onclick;
+        }
+        if (condition) {
+            uiActionData.condition = condition;
+        }
+        const response = await client_instance.post('/api/now/table/sys_ui_action', uiActionData);
+        const uiAction = response.data.result;
+        // Provide examples based on client vs server
+        const examples = client
+            ? {
+                basic: `// Client-side (runs in browser)\nfunction ${action_name}() {\n  alert('Button clicked');\n  g_form.setValue('field', 'value');\n}`,
+                with_server: `// Client calls server\nfunction ${action_name}() {\n  var ga = new GlideAjax('ScriptIncludeName');\n  ga.addParam('sysparm_name', 'method');\n  ga.getXMLAnswer(function(answer) {\n    g_form.addInfoMessage('Server response: ' + answer);\n  });\n}`
+            }
+            : {
+                basic: `// Server-side (runs on server)\naction.setRedirectURL(current);\ngs.addInfoMessage('Action completed');`
+            };
+        return (0, error_handler_js_1.createSuccessResult)({
+            created: true,
+            ui_action: {
+                sys_id: uiAction.sys_id,
+                name: uiAction.name,
+                action_name: uiAction.action_name,
+                table: uiAction.table,
+                type: action_type,
+                client: uiAction.client === 'true',
+                order: uiAction.order,
+                active: uiAction.active === 'true'
+            },
+            visibility: {
+                show_insert: show_insert,
+                show_update: show_update,
+                has_condition: !!condition
+            },
+            examples,
+            best_practices: [
+                'Use client scripts for immediate UI updates',
+                'Use server scripts for data operations and security',
+                'Always provide user feedback (messages, redirects)',
+                'Test with different user roles and conditions',
+                'Keep scripts focused on single responsibility'
+            ]
+        });
+    }
+    catch (error) {
+        return (0, error_handler_js_1.createErrorResult)(error.message);
+    }
+}
+exports.version = '1.0.0';
+exports.author = 'Snow-Flow SDK Migration';
+//# sourceMappingURL=snow_create_ui_action.js.map

package/dist/mcp/servicenow-mcp-unified/tools/platform/snow_create_ui_page.d.ts

@@ -0,0 +1,12 @@
+/**
+ * snow_create_ui_page - Create UI Pages
+ *
+ * Create custom UI pages with Jelly/HTML templates, client scripts,
+ * and processing scripts for custom interfaces.
+ */
+import { MCPToolDefinition, ServiceNowContext, ToolResult } from '../../shared/types.js';
+export declare const toolDefinition: MCPToolDefinition;
+export declare function execute(args: any, context: ServiceNowContext): Promise<ToolResult>;
+export declare const version = "1.0.0";
+export declare const author = "Snow-Flow SDK Migration";
+//# sourceMappingURL=snow_create_ui_page.d.ts.map

package/dist/mcp/servicenow-mcp-unified/tools/platform/snow_create_ui_page.js

@@ -0,0 +1,139 @@
+"use strict";
+/**
+ * snow_create_ui_page - Create UI Pages
+ *
+ * Create custom UI pages with Jelly/HTML templates, client scripts,
+ * and processing scripts for custom interfaces.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.author = exports.version = exports.toolDefinition = void 0;
+exports.execute = execute;
+const auth_js_1 = require("../../shared/auth.js");
+const error_handler_js_1 = require("../../shared/error-handler.js");
+exports.toolDefinition = {
+    name: 'snow_create_ui_page',
+    description: 'Create custom UI Page with Jelly/HTML template and processing script',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            name: {
+                type: 'string',
+                description: 'UI Page name (alphanumeric with underscores)'
+            },
+            html: {
+                type: 'string',
+                description: 'HTML/Jelly template content'
+            },
+            description: {
+                type: 'string',
+                description: 'Page description'
+            },
+            category: {
+                type: 'string',
+                description: 'Page category for organization'
+            },
+            processing_script: {
+                type: 'string',
+                description: 'Server-side processing script (ES5)'
+            },
+            client_script: {
+                type: 'string',
+                description: 'Client-side JavaScript'
+            },
+            direct: {
+                type: 'boolean',
+                description: 'Direct rendering (skip standard UI)',
+                default: false
+            },
+            active: {
+                type: 'boolean',
+                description: 'Activate immediately',
+                default: true
+            }
+        },
+        required: ['name', 'html']
+    }
+};
+async function execute(args, context) {
+    const { name, html, description = '', category = 'general', processing_script = '', client_script = '', direct = false, active = true } = args;
+    try {
+        const client = await (0, auth_js_1.getAuthenticatedClient)(context);
+        // Create UI Page
+        const uiPageData = {
+            name,
+            html,
+            description,
+            category,
+            processing_script,
+            client_script,
+            direct,
+            active
+        };
+        const response = await client.post('/api/now/table/sys_ui_page', uiPageData);
+        const uiPage = response.data.result;
+        // Construct URL
+        const pageUrl = `${context.instanceUrl}/${name}.do`;
+        // Provide Jelly examples
+        const jellyExamples = {
+            basic_structure: `<?xml version="1.0" encoding="utf-8" ?>
+<j:jelly trim="false" xmlns:j="jelly:core" xmlns:g="glide" xmlns:j2="null" xmlns:g2="null">
+  <h1>Page Title</h1>
+  <p>\${RP.getMessage('Your message')}</p>
+</j:jelly>`,
+            with_gliderecord: `<g:evaluate var="jvar_gr">
+  var gr = new GlideRecord('incident');
+  gr.addQuery('active', true);
+  gr.setLimit(10);
+  gr.query();
+  gr;
+</g:evaluate>
+
+<j:while test="\${jvar_gr.next()}">
+  <p>\${jvar_gr.number}: \${jvar_gr.short_description}</p>
+</j:while>`,
+            with_form: `<form method="post">
+  <input type="text" name="user_input" />
+  <input type="submit" value="Submit" />
+</form>
+
+<!-- Processing script handles form submission -->
+<!-- var userInput = RP.getParameterValue('user_input'); -->`
+        };
+        return (0, error_handler_js_1.createSuccessResult)({
+            created: true,
+            ui_page: {
+                sys_id: uiPage.sys_id,
+                name: uiPage.name,
+                category: uiPage.category,
+                direct: uiPage.direct === 'true',
+                active: uiPage.active === 'true',
+                url: pageUrl
+            },
+            access: {
+                url: pageUrl,
+                direct_url: direct ? `${context.instanceUrl}/${name}.do?sysparm_direct=true` : null
+            },
+            jelly_examples: jellyExamples,
+            processing_script_context: {
+                RP: 'RequestParameters - access URL/form parameters',
+                current: 'Current GlideRecord if applicable',
+                g_user: 'Current user object',
+                gs: 'GlideSystem object'
+            },
+            best_practices: [
+                'Use Jelly for server-side rendering',
+                'Use client_script for client-side interactivity',
+                'Processing script runs before page renders',
+                'Direct pages skip standard ServiceNow UI chrome',
+                'Test with different user roles for ACL',
+                'Consider using UI Pages for custom portals/dashboards'
+            ]
+        });
+    }
+    catch (error) {
+        return (0, error_handler_js_1.createErrorResult)(error.message);
+    }
+}
+exports.version = '1.0.0';
+exports.author = 'Snow-Flow SDK Migration';
+//# sourceMappingURL=snow_create_ui_page.js.map

package/dist/mcp/servicenow-mcp-unified/tools/platform/snow_create_ui_policy.d.ts

@@ -0,0 +1,12 @@
+/**
+ * snow_create_ui_policy - Create UI Policies
+ *
+ * Create declarative form behavior policies for field visibility,
+ * mandatory state, and read-only control.
+ */
+import { MCPToolDefinition, ServiceNowContext, ToolResult } from '../../shared/types.js';
+export declare const toolDefinition: MCPToolDefinition;
+export declare function execute(args: any, context: ServiceNowContext): Promise<ToolResult>;
+export declare const version = "1.0.0";
+export declare const author = "Snow-Flow SDK Migration";
+//# sourceMappingURL=snow_create_ui_policy.d.ts.map

package/dist/mcp/servicenow-mcp-unified/tools/platform/snow_create_ui_policy.js

@@ -0,0 +1,137 @@
+"use strict";
+/**
+ * snow_create_ui_policy - Create UI Policies
+ *
+ * Create declarative form behavior policies for field visibility,
+ * mandatory state, and read-only control.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.author = exports.version = exports.toolDefinition = void 0;
+exports.execute = execute;
+const auth_js_1 = require("../../shared/auth.js");
+const error_handler_js_1 = require("../../shared/error-handler.js");
+exports.toolDefinition = {
+    name: 'snow_create_ui_policy',
+    description: 'Create UI Policy for form field control (visibility, mandatory, readonly)',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            name: {
+                type: 'string',
+                description: 'UI Policy name'
+            },
+            table: {
+                type: 'string',
+                description: 'Table to attach policy to'
+            },
+            condition: {
+                type: 'string',
+                description: 'Condition (encoded query or script)'
+            },
+            description: {
+                type: 'string',
+                description: 'Policy description'
+            },
+            on_load: {
+                type: 'boolean',
+                description: 'Run on form load',
+                default: true
+            },
+            reverse_if_false: {
+                type: 'boolean',
+                description: 'Reverse actions when condition is false',
+                default: true
+            },
+            active: {
+                type: 'boolean',
+                description: 'Activate immediately',
+                default: true
+            },
+            actions: {
+                type: 'array',
+                description: 'UI Policy actions',
+                items: {
+                    type: 'object',
+                    properties: {
+                        field_name: { type: 'string', description: 'Field to control' },
+                        visible: { type: 'boolean', description: 'Make field visible' },
+                        mandatory: { type: 'boolean', description: 'Make field mandatory' },
+                        readonly: { type: 'boolean', description: 'Make field readonly' },
+                        cleared: { type: 'boolean', description: 'Clear field value' }
+                    },
+                    required: ['field_name']
+                }
+            }
+        },
+        required: ['name', 'table', 'actions']
+    }
+};
+async function execute(args, context) {
+    const { name, table, condition = '', description = '', on_load = true, reverse_if_false = true, active = true, actions = [] } = args;
+    try {
+        const client = await (0, auth_js_1.getAuthenticatedClient)(context);
+        if (actions.length === 0) {
+            throw new Error('At least one action is required');
+        }
+        // Create UI Policy
+        const uiPolicyData = {
+            short_description: name,
+            table,
+            conditions: condition,
+            description,
+            on_load,
+            reverse_if_false,
+            active
+        };
+        const policyResponse = await client.post('/api/now/table/sys_ui_policy', uiPolicyData);
+        const uiPolicy = policyResponse.data.result;
+        // Create UI Policy Actions
+        const createdActions = [];
+        for (const action of actions) {
+            const actionData = {
+                ui_policy: uiPolicy.sys_id,
+                field: action.field_name,
+                visible: action.visible !== undefined ? action.visible : true,
+                mandatory: action.mandatory || false,
+                readonly: action.readonly || false,
+                cleared: action.cleared || false
+            };
+            const actionResponse = await client.post('/api/now/table/sys_ui_policy_action', actionData);
+            createdActions.push(actionResponse.data.result);
+        }
+        return (0, error_handler_js_1.createSuccessResult)({
+            created: true,
+            ui_policy: {
+                sys_id: uiPolicy.sys_id,
+                name: uiPolicy.short_description,
+                table: uiPolicy.table,
+                condition: uiPolicy.conditions,
+                on_load: uiPolicy.on_load === 'true',
+                reverse_if_false: uiPolicy.reverse_if_false === 'true',
+                active: uiPolicy.active === 'true'
+            },
+            actions: createdActions.map(action => ({
+                sys_id: action.sys_id,
+                field: action.field,
+                visible: action.visible === 'true',
+                mandatory: action.mandatory === 'true',
+                readonly: action.readonly === 'true',
+                cleared: action.cleared === 'true'
+            })),
+            total_actions: createdActions.length,
+            best_practices: [
+                'UI Policies are declarative - use instead of client scripts when possible',
+                'Conditions can be encoded queries or scripts',
+                'reverse_if_false makes policy bidirectional',
+                'Order matters when multiple policies affect same field',
+                'Test with different user roles and data'
+            ]
+        });
+    }
+    catch (error) {
+        return (0, error_handler_js_1.createErrorResult)(error.message);
+    }
+}
+exports.version = '1.0.0';
+exports.author = 'Snow-Flow SDK Migration';
+//# sourceMappingURL=snow_create_ui_policy.js.map

package/dist/mcp/servicenow-mcp-unified/tools/platform/snow_discover_platform_tables.d.ts

@@ -0,0 +1,12 @@
+/**
+ * snow_discover_platform_tables - Platform table discovery
+ *
+ * Discover platform development tables categorized by type
+ * (UI, script, policy, security, system).
+ */
+import { MCPToolDefinition, ServiceNowContext, ToolResult } from '../../shared/types.js';
+export declare const toolDefinition: MCPToolDefinition;
+export declare function execute(args: any, context: ServiceNowContext): Promise<ToolResult>;
+export declare const version = "1.0.0";
+export declare const author = "Snow-Flow SDK Migration";
+//# sourceMappingURL=snow_discover_platform_tables.d.ts.map

package/dist/mcp/servicenow-mcp-unified/tools/platform/snow_discover_platform_tables.js

@@ -0,0 +1,115 @@
+"use strict";
+/**
+ * snow_discover_platform_tables - Platform table discovery
+ *
+ * Discover platform development tables categorized by type
+ * (UI, script, policy, security, system).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.author = exports.version = exports.toolDefinition = void 0;
+exports.execute = execute;
+const auth_js_1 = require("../../shared/auth.js");
+const error_handler_js_1 = require("../../shared/error-handler.js");
+exports.toolDefinition = {
+    name: 'snow_discover_platform_tables',
+    description: 'Discover platform development tables by category (ui, script, policy, action)',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            category: {
+                type: 'string',
+                enum: ['all', 'ui', 'script', 'policy', 'action', 'security', 'system'],
+                description: 'Filter by table category',
+                default: 'all'
+            },
+            limit: {
+                type: 'number',
+                description: 'Maximum results per category',
+                default: 50
+            }
+        }
+    }
+};
+const TABLE_CATEGORIES = [
+    {
+        category: 'ui',
+        query: 'nameSTARTSWITHsys_ui^ORnameSTARTSWITHsp_',
+        description: 'UI pages, forms, lists, and portal widgets'
+    },
+    {
+        category: 'script',
+        query: 'nameSTARTSWITHsys_script^ORname=sys_script_include',
+        description: 'Scripts, script includes, and processors'
+    },
+    {
+        category: 'policy',
+        query: 'name=sys_ui_policy^ORname=sys_data_policy',
+        description: 'UI policies and data policies'
+    },
+    {
+        category: 'action',
+        query: 'name=sys_ui_action^ORname=sys_ui_context_menu',
+        description: 'UI actions and context menus'
+    },
+    {
+        category: 'security',
+        query: 'nameSTARTSWITHsys_security^ORname=sys_user_role',
+        description: 'Security policies and roles'
+    },
+    {
+        category: 'system',
+        query: 'name=sys_dictionary^ORname=sys_db_object^ORname=sys_choice',
+        description: 'System tables for schema and data'
+    }
+];
+async function execute(args, context) {
+    const { category = 'all', limit = 50 } = args;
+    try {
+        const client = await (0, auth_js_1.getAuthenticatedClient)(context);
+        const discoveredTables = [];
+        const categoriesToQuery = category === 'all'
+            ? TABLE_CATEGORIES
+            : TABLE_CATEGORIES.filter(cat => cat.category === category);
+        for (const cat of categoriesToQuery) {
+            const response = await client.get('/api/now/table/sys_db_object', {
+                params: {
+                    sysparm_query: cat.query,
+                    sysparm_limit: limit,
+                    sysparm_fields: 'sys_id,name,label,super_class,is_extendable,extension_model'
+                }
+            });
+            if (response.data.result && response.data.result.length > 0) {
+                discoveredTables.push({
+                    category: cat.category,
+                    description: cat.description,
+                    count: response.data.result.length,
+                    tables: response.data.result.map((table) => ({
+                        name: table.name,
+                        label: table.label,
+                        super_class: table.super_class,
+                        is_extendable: table.is_extendable === 'true',
+                        extension_model: table.extension_model,
+                        sys_id: table.sys_id
+                    }))
+                });
+            }
+        }
+        const totalTables = discoveredTables.reduce((sum, cat) => sum + cat.count, 0);
+        return (0, error_handler_js_1.createSuccessResult)({
+            discovered: true,
+            platform_tables: discoveredTables,
+            summary: {
+                total_tables: totalTables,
+                categories_found: discoveredTables.length,
+                filter_applied: category
+            },
+            message: `Discovered ${totalTables} platform development tables across ${discoveredTables.length} categories`
+        });
+    }
+    catch (error) {
+        return (0, error_handler_js_1.createErrorResult)(error.message);
+    }
+}
+exports.version = '1.0.0';
+exports.author = 'Snow-Flow SDK Migration';
+//# sourceMappingURL=snow_discover_platform_tables.js.map

package/dist/mcp/servicenow-mcp-unified/tools/platform/snow_table_schema_discovery.d.ts

@@ -0,0 +1,11 @@
+/**
+ * snow_table_schema_discovery - Discover table schemas
+ *
+ * Comprehensive table schema discovery including fields, relationships, ACLs, and business rules.
+ */
+import { MCPToolDefinition, ServiceNowContext, ToolResult } from '../../shared/types.js';
+export declare const toolDefinition: MCPToolDefinition;
+export declare function execute(args: any, context: ServiceNowContext): Promise<ToolResult>;
+export declare const version = "1.0.0";
+export declare const author = "Snow-Flow SDK Migration";
+//# sourceMappingURL=snow_table_schema_discovery.d.ts.map