snow-flow 8.41.9 → 8.41.15

package/dist/mcp/servicenow-mcp-unified/tools/flow-designer/snow_manage_flow.d.ts

@@ -0,0 +1,125 @@
+/**
+ * snow_manage_flow - Unified Flow Designer Management via Direct Table API
+ *
+ * ⚠️ EXPERIMENTAL: Manages flows by directly manipulating Flow Designer tables.
+ * This approach is NOT officially supported by ServiceNow but enables programmatic flow management.
+ *
+ * Supported Actions:
+ * - create: Create a new flow with triggers, actions, conditions, loops, variables
+ * - update: Update an existing flow's properties
+ * - delete: Delete a flow and all related records
+ * - clone: Clone an existing flow
+ * - activate: Activate a flow
+ * - deactivate: Deactivate a flow
+ * - add_action: Add an action to an existing flow
+ * - remove_action: Remove an action from a flow
+ * - add_condition: Add a conditional logic block (if/then/else)
+ * - add_loop: Add a loop construct (for_each/do_until)
+ * - get_details: Get detailed flow structure including decompressed values
+ *
+ * Features:
+ * - Xanadu+ compression support (GlideCompressionUtil compatible)
+ * - Nested actions within conditions and loops
+ * - Parent-child relationship management
+ * - Version detection for table compatibility
+ *
+ * Flow Designer Table Structure:
+ * - sys_hub_flow: Main flow record
+ * - sys_hub_flow_snapshot: Flow version/snapshot
+ * - sys_hub_trigger_instance_v2: Trigger configuration
+ * - sys_hub_action_instance_v2: Action instances (with compressed values)
+ * - sys_hub_flow_logic_instance_v2: Conditions, loops (with parent_logic_instance)
+ * - sys_hub_flow_variable: Input/output variables
+ * - sys_hub_sub_flow_instance: Subflow references
+ *
+ * @version 2.0.0-experimental
+ * @author Snow-Flow v8.3.0 - Flow Designer Direct Table API
+ */
+import { MCPToolDefinition, ServiceNowContext, ToolResult } from '../../shared/types.js';
+type ManageFlowAction = 'create' | 'update' | 'delete' | 'clone' | 'activate' | 'deactivate' | 'add_action' | 'remove_action' | 'add_condition' | 'add_loop' | 'add_variable' | 'get_details' | 'publish';
+interface FlowConfig {
+    name: string;
+    internal_name?: string;
+    description?: string;
+    active?: boolean;
+    application_scope?: string;
+    run_as?: 'system' | 'user_who_triggers' | 'specific_user';
+    run_as_user?: string;
+}
+interface TriggerConfig {
+    type: 'record' | 'scheduled' | 'api' | 'inbound_email' | 'service_catalog';
+    table?: string;
+    condition?: string;
+    when?: 'created' | 'updated' | 'deleted' | 'created_or_updated';
+    schedule?: {
+        frequency: 'daily' | 'weekly' | 'monthly' | 'custom';
+        time?: string;
+        days?: number[];
+        cron?: string;
+    };
+}
+interface ActionConfig {
+    type: string;
+    name?: string;
+    description?: string;
+    order?: number;
+    inputs?: Record<string, any>;
+    parent_logic_instance?: string;
+    branch?: 'then' | 'else';
+}
+interface ConditionConfig {
+    name?: string;
+    condition: string;
+    order?: number;
+    then_actions?: ActionConfig[];
+    else_actions?: ActionConfig[];
+    parent_logic_instance?: string;
+}
+interface LoopConfig {
+    name?: string;
+    type: 'for_each' | 'do_until';
+    data_source?: string;
+    condition?: string;
+    max_iterations?: number;
+    order?: number;
+    actions?: ActionConfig[];
+    parent_logic_instance?: string;
+}
+interface VariableConfig {
+    name: string;
+    type: 'string' | 'integer' | 'boolean' | 'reference' | 'object' | 'array' | 'glide_date_time';
+    direction: 'input' | 'output' | 'scratch';
+    label?: string;
+    description?: string;
+    mandatory?: boolean;
+    default_value?: string;
+    reference_table?: string;
+}
+interface ManageFlowArgs {
+    action: ManageFlowAction;
+    flow?: FlowConfig;
+    trigger?: TriggerConfig;
+    actions?: ActionConfig[];
+    conditions?: ConditionConfig[];
+    loops?: LoopConfig[];
+    variables?: VariableConfig[];
+    flow_id?: string;
+    flow_name?: string;
+    updates?: Partial<FlowConfig>;
+    new_name?: string;
+    action_config?: ActionConfig;
+    condition_config?: ConditionConfig;
+    loop_config?: LoopConfig;
+    variable_config?: VariableConfig;
+    action_id?: string;
+    auto_activate?: boolean;
+    create_snapshot?: boolean;
+    use_compression?: boolean;
+    validate_only?: boolean;
+}
+export declare const toolDefinition: MCPToolDefinition;
+export declare function execute(args: ManageFlowArgs, context: ServiceNowContext): Promise<ToolResult>;
+export declare const version = "2.1.0";
+export declare const author = "Snow-Flow v8.41.13 - Flow Designer Management (snapshot fix)";
+export {};
+//# sourceMappingURL=snow_manage_flow.d.ts.map

package/dist/mcp/servicenow-mcp-unified/tools/flow-designer/snow_manage_flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snow_manage_flow.d.ts","sourceRoot":"","sources":["../../../../../src/mcp/servicenow-mcp-unified/tools/flow-designer/snow_manage_flow.ts"],"names":[],"mappings":"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"}