@servicenow/sdk-build-plugins 4.4.1 → 4.6.0

package/src/flow/utils/flow-constants.ts

@@ -21,24 +21,64 @@ export const UNSUPPORTED_FLOW_DESCENDANTS = [
     ACTION_INSTANCE_TABLE,
     SUBFLOW_INSTANCE_TABLE,
     FLOW_LOGIC_INSTANCE_TABLE,
-    SUBFLOW_INSTANCE_TABLE_V2,
 ]
 
 //Plugins callee names
 export const FLOW_API_NAME = 'Flow'
 export const SUBFLOW_API_NAME = 'Subflow'
-export const ACTION_DEFINITION_API_NAME = 'ActionDefinition'
+export const ACTION_DEFINITION_API_NAME = 'Action'
 export const TRIGGER_DEFINITION_API_NAME = 'TriggerDefinition'
 
 export const TRIGGER_INSTANCE_API_NAME = 'wfa.trigger'
 export const ACTION_INSTANCE_API_NAME = 'wfa.action'
 export const SUBFLOW_INSTANCE_API_NAME = 'wfa.subflow'
-export const ACTION_STEP_INSTANCE_API_NAME = 'wfa.action_step'
+export const ACTION_STEP_INSTANCE_API_NAME = 'wfa.actionStep'
 export const APPROVAL_RULES_API_NAME = 'wfa.approvalRules'
 export const APPROVAL_DUE_DATE_API_NAME = 'wfa.approvalDueDate'
 
+export const FLOW_OBJECT_API_NAME = 'FlowObject'
+export const FLOW_ARRAY_API_NAME = 'FlowArray'
+
 export const ELEMENT_MAPPING_PROVIDER = 'com.glide.flow_design.action.data.FlowDesignVariableMapper'
 
+const UI_TYPE_LABEL: { [key: string]: string } = {
+    string: 'String',
+    integer: 'Integer',
+    boolean: 'True/False',
+    decimal: 'Decimal',
+    float: 'Float',
+    date: 'Date',
+    glide_date: 'Date',
+    glide_date_time: 'Date/Time',
+    datetime: 'Date/Time',
+    reference: 'Reference',
+    choice: 'Choice',
+    table_name: 'Table Name',
+    field_name: 'Field Name',
+    document_id: 'Document ID',
+    json: 'JSON',
+    script: 'Script',
+    url: 'URL',
+    html: 'HTML',
+    email: 'Email',
+    password2: 'Password',
+    glide_duration: 'Duration',
+    conditions: 'Conditions',
+    template_value: 'Template Value',
+    records: 'Records',
+}
+
+/** Returns the human-readable uiTypeLabel for a given internal_type (e.g. 'integer' → 'Integer') */
+export function getUiTypeLabel(internalType: string): string {
+    return UI_TYPE_LABEL[internalType] ?? internalType.charAt(0).toUpperCase() + internalType.slice(1)
+}
+
+/** Builds the attributes string for sys_hub_step_ext_input/output records */
+export function buildExtVarAttributes(internalType: string): string {
+    const uiTypeLabel = getUiTypeLabel(internalType)
+    return `element_mapping_provider=${ELEMENT_MAPPING_PROVIDER},uiType=${internalType},uiTypeLabel=${uiTypeLabel}`
+}
+
 export const TRIGGER_TYPE_KEY_NAME = 'trigger_type'
 export const ACTION_TYPE_KEY_NAME = 'action_type'
 
@@ -67,8 +107,9 @@ export const CORE_ACTIONS_PREFIX = 'action.core'
 export const RUN_ON_EXTENDED = 'run_on_extended'
 
 export const APPROVAL_DUE_DATE_INPUT_FIELD_ACTIONS = [
-    'f8f2e9920b10030085c083eb37673abd',
-    'cd04ac7573011010791f94596bf6a716',
+    'f8f2e9920b10030085c083eb37673abd', // askForApproval action definition sys_id (flow context)
+    'cd04ac7573011010791f94596bf6a716', // originally added in DEF0789002 — sys_id identity unknown, needs investigation
+    'a4eb47900b22320085c083eb37673acc', // askForApproval step definition sys_id (action definition context)
 ]
 
 export const CORE_ACTIONS_SYS_ID_NAME_MAP: { [sysId: string]: string } = {
@@ -99,7 +140,7 @@ export const CORE_ACTIONS_SYS_ID_NAME_MAP: { [sysId: string]: string } = {
     '0d8dd9f10f11101051218e8ebc767e27': 'sendNotification',
     '027499be7333001099792f163cf6a7a7': 'sendSms',
     a1a50c4573873300d70877186bf6a762: 'slaPercentageTimer',
-    c7a04c4607312001098e194596bf6a72a: 'submitCatalogItemRequest',
+    c7a04c607312001098e194596bf6a72a: 'submitCatalogItemRequest',
     '9daf2a72c75100105312134c95c26073': 'updateMultipleRecords',
     f9d01dd2c31332002841b63b12d3aea1: 'updateRecord',
     '89ce8a4187120010663ca1bb36cb0be3': 'waitForCondition',
@@ -107,12 +148,387 @@ export const CORE_ACTIONS_SYS_ID_NAME_MAP: { [sysId: string]: string } = {
     '605d0ab8931012105cd18166448918db': 'waitForMessage',
 }
 
+/**
+ * Prefix for built-in action step references in generated Fluent code.
+ * Produces identifiers like `actionStep.createRecord`, `actionStep.log`, etc.
+ */
+export const BUILT_IN_STEP_PREFIX = 'actionStep'
+
+/**
+ * Maps built-in step definition sys_ids to their `actionStep.xxx` property name.
+ * Used during XML→Fluent transform to emit typed references instead of strings.
+ * Follows the same pattern as CORE_ACTIONS_SYS_ID_NAME_MAP for actions.
+ */
+export const BUILT_IN_STEP_SYS_ID_NAME_MAP: { [sysId: string]: string } = {
+    a03fea9bc712220061f553c6f09763b1: 'log',
+    '9cbaa0f267003200553fafb49585ef69': 'createRecord',
+    '106afb6647032200b4fad7527c9a71e7': 'script',
+
+    '07973e960b233200cbd9e240e0ea604e': 'createTask',
+    '05a6e480a301311029c4d1f3e31e61f1': 'collectActivityContext',
+    '092bb996ff30311077a95dac793bf166': 'fireEvent',
+    '0d9746f0931012105cd181664489188c': 'waitForMessage',
+    '0e07df020f13101051218e8ebc767e57': 'getLatestResponseTextFromEmail',
+
+    '48526b2dc32a32002841b63b12d3ae72': 'lookUpRecords',
+    '4c5f36a37f0b32005f58108c3ffa9126': 'email',
+    '4c9234ca0b18030085c083eb37673aaa': 'waitForCondition',
+    '5d31f8f37f1322004d145212bdfa9145': 'notification',
+    '65a40b525b12101083f30f216581c787': 'createAppFromPayload',
+    '81e15fbd7fcb12108e688c90ac866541': 'waitForEmailReply',
+    '8c6b7466c71100105312134c95c2602a': 'deleteMultipleRecords',
+    '8f5c107a53a3230034c6ddeeff7b129d': 'createOrUpdateRecord',
+    a3dfc066c7dd00105312134c95c26014: 'updateMultipleRecords',
+    a4eb47900b22320085c083eb37673acc: 'askForApproval',
+    b51f683667003200553fafb49585ef3f: 'updateRecord',
+    b67821c1c723220061f553c6f09763c2: 'deleteRecord',
+    dc9c26043b23220057a4a2e334efc447: 'lookUpRecord',
+    e0b9272d53112110aba6ddeeff7b1224: 'createRecordForRemoteTable',
+    f760b5c2737c001086592f163cf6a758: 'sms',
+}
+
+/**
+ * A step variable entry: either a plain element name (string)
+ * or an object with element name + uiType for value coercion during transform.
+ */
+export type StepVarEntry = string | { name: string; uiType: string }
+
+/** Extract the element name from a StepVarEntry */
+export function getVarEntryName(entry: StepVarEntry): string {
+    return typeof entry === 'string' ? entry : entry.name
+}
+
+/** Extract the uiType from a StepVarEntry (undefined for plain strings) */
+export function getVarEntryType(entry: StepVarEntry): string | undefined {
+    return typeof entry === 'string' ? undefined : entry.uiType
+}
+
+/**
+ * Maps built-in step definition sys_ids to their metadata including
+ * input/output variable sys_id → element name mappings.
+ * Used during XML→Fluent transform to resolve OOB step definitions
+ * and their sys_variable_value records into proper element names.
+ */
+export const BUILT_IN_STEP_DEFINITIONS: {
+    [sysId: string]: {
+        name: string
+        inputs: { [varSysId: string]: StepVarEntry }
+        outputs: { [varSysId: string]: StepVarEntry }
+    }
+} = {
+    a03fea9bc712220061f553c6f09763b1: {
+        name: 'Log',
+        inputs: {
+            '4fc2fadbc712220061f553c6f0976388': 'log_message',
+            ab123adbc712220061f553c6f0976387: 'log_level',
+        },
+        outputs: {},
+    },
+    '9cbaa0f267003200553fafb49585ef69': {
+        name: 'Create Record',
+        inputs: {
+            '9e5f9d85536333003bf1d9109ec587c6': { name: 'skip_insert', uiType: 'boolean' },
+            e78d203667003200553fafb49585ef63: { name: 'create_record_field_values', uiType: 'template_value' },
+            f0fb68f267003200553fafb49585efa0: 'create_record_table_name',
+        },
+        outputs: {
+            '795c557267003200553fafb49585efb0': 'table_name',
+            '966cd57267003200553fafb49585efa0': 'record',
+        },
+    },
+    '106afb6647032200b4fad7527c9a71e7': {
+        name: 'Script',
+        inputs: {
+            '0d2db9e653310110d3a8ddeeff7b1208': 'mid_cluster',
+            '28e4e579b3101300176b051a16a8dc0f': 'host',
+            '2b2ba571b3101300176b051a16a8dc8f': 'connection_alias',
+            '2c226939b3101300176b051a16a8dc83': 'mid_selection_type',
+            '71aa7f6647032200b4fad7527c9a719b': 'script',
+            '74315b04b3201300176b051a16a8dc2b': 'required_run_time',
+            '7d36ed79b3101300176b051a16a8dceb': 'capabilities',
+            cbd1070373531010791f94596bf6a776: 'mid_selection',
+            f0d58b8373531010791f94596bf6a7be: 'mid_server',
+            f5e56d79b3101300176b051a16a8dce4: 'application',
+        },
+        outputs: {},
+    },
+    '07973e960b233200cbd9e240e0ea604e': {
+        name: 'Create Task',
+        inputs: {
+            '1aeb688553af33003bf1d9109ec58710': { name: 'skip_insert', uiType: 'boolean' },
+            '2a7872d60b233200cbd9e240e0ea601e': { name: 'create_record_field_values', uiType: 'template_value' },
+            '9b6832d60b233200cbd9e240e0ea601c': 'create_record_table_name',
+            a498b2d60b233200cbd9e240e0ea6004: { name: 'wait', uiType: 'boolean' },
+        },
+        outputs: {
+            '19efa6b653333200f5bf435723dc340e': 'table',
+            '9f0b036353233200f5bf435723dc3475': 'task',
+        },
+    },
+    '092bb996ff30311077a95dac793bf166': {
+        name: 'Fire Event',
+        inputs: {
+            '020ebd5aff30311077a95dac793bf1ea': 'table',
+            '077ef59aff30311077a95dac793bf1ba': 'parm1',
+            '17be7d9aff30311077a95dac793bf18f': 'parm2',
+            '599cf11aff30311077a95dac793bf1d2': 'event_name',
+            a3ad395aff30311077a95dac793bf12e: 'record',
+        },
+        outputs: {},
+    },
+    b51f683667003200553fafb49585ef3f: {
+        name: 'Update Record',
+        inputs: {
+            '3930d57267003200553fafb49585efc5': 'table_name',
+            aab0ddb267003200553fafb49585ef30: 'record',
+            fcbf6c3667003200553fafb49585ef2e: { name: 'update_record_field_values', uiType: 'template_value' },
+        },
+        outputs: {
+            '2fb3d57267003200553fafb49585ef43': 'table_name',
+            ffd3197267003200553fafb49585ef5a: 'record',
+        },
+    },
+    b67821c1c723220061f553c6f09763c2: {
+        name: 'Delete Record',
+        inputs: {
+            '995a2105c723220061f553c6f0976301': 'record',
+            ab19a9c1c723220061f553c6f0976383: 'table_name',
+        },
+        outputs: {},
+    },
+    dc9c26043b23220057a4a2e334efc447: {
+        name: 'Look Up Record',
+        inputs: {
+            '0cfca6043b23220057a4a2e334efc43b': { name: 'conditions', uiType: 'conditions' },
+            '3b9387923b23220057a4a2e334efc4e4': 'multiple_records_found',
+            a6da115587003300663ca1bb36cb0bc0: 'sort_column',
+            b019356673110010d70877186bf6a780: { name: 'dont_fail_flow_on_error', uiType: 'boolean' },
+            c62b915587003300663ca1bb36cb0bd2: 'sort_type',
+            f9cc66043b23220057a4a2e334efc42f: 'lookup_table_name',
+        },
+        outputs: {
+            '145a3da673110010d70877186bf6a7a5': 'error_message',
+            '14bd89c673310010d70877186bf6a7be': 'status',
+            a64d6a043b23220057a4a2e334efc4e8: 'table_name',
+            d3e627913b23220057a4a2e334efc45e: 'record',
+        },
+    },
+    '48526b2dc32a32002841b63b12d3ae72': {
+        name: 'Look Up Records',
+        inputs: {
+            '0677f8e053200300f5bf435723dc34e3': { name: 'limit', uiType: 'integer' },
+            '2df79dd187003300663ca1bb36cb0b33': 'sort_column',
+            '4d19bb21c36a32002841b63b12d3aeef': 'table_name',
+            '6a88151587003300663ca1bb36cb0b14': 'sort_type',
+            '95f8bb21c36a32002841b63b12d3ae0c': { name: 'conditions', uiType: 'conditions' },
+        },
+        outputs: {
+            '5db8f721c36a32002841b63b12d3aeb7': 'records',
+            c576f2a2c32232002841b63b12d3ae66: 'table_name',
+            f6700274c32b32002841b63b12d3ae37: { name: 'count', uiType: 'integer' },
+        },
+    },
+    a3dfc066c7dd00105312134c95c26014: {
+        name: 'Update Multiple Records',
+        inputs: {
+            '0f7194a6c7dd00105312134c95c26028': { name: 'set_autosysfields', uiType: 'boolean' },
+            '168d8069c7ee00105312134c95c260a7': 'sort_column',
+            '66401866c7dd00105312134c95c2607e': { name: 'conditions', uiType: 'conditions' },
+            '71ad0469c7ee00105312134c95c26027': 'sort_type',
+            '8a6154a6c7dd00105312134c95c26019': { name: 'set_workflow', uiType: 'boolean' },
+            a5505866c7dd00105312134c95c26065: { name: 'field_values', uiType: 'template_value' },
+            c530d466c7dd00105312134c95c26066: 'table_name',
+            e2214bd6c72a40105312134c95c2600c: { name: 'dont_fail_flow_on_error', uiType: 'boolean' },
+        },
+        outputs: {
+            '10209466c7dd00105312134c95c26031': 'error_message',
+            '4f814fd6c72a40105312134c95c26001': 'status',
+            a4101466c7dd00105312134c95c260a8: { name: 'count', uiType: 'integer' },
+        },
+    },
+    '8c6b7466c71100105312134c95c2602a': {
+        name: 'Delete Multiple Records',
+        inputs: {
+            '156c34a6c71100105312134c95c26068': { name: 'set_workflow', uiType: 'boolean' },
+            '693c70a6c71100105312134c95c26011': 'table_name',
+            '76207652c72a40105312134c95c26083': { name: 'dont_fail_flow_on_error', uiType: 'boolean' },
+            '79fb8029c7ee00105312134c95c26042': 'sort_column',
+            a34cb0a6c71100105312134c95c260a3: { name: 'conditions', uiType: 'conditions' },
+            a85c8429c7ee00105312134c95c26033: 'sort_type',
+        },
+        outputs: {
+            '60fbbc66c71100105312134c95c26033': 'error_message',
+            ce41be52c72a40105312134c95c2606b: 'status',
+            e7db3c66c71100105312134c95c26031: { name: 'count', uiType: 'integer' },
+        },
+    },
+    '4c5f36a37f0b32005f58108c3ffa9126': {
+        name: 'Email',
+        inputs: {
+            '0fba76757303230082999cfd7bf6a7f2': { name: 'watermark_email', uiType: 'boolean' },
+            '33c003277f0b32005f58108c3ffa91e8': 'cc',
+            '40cf3ae37f0b32005f58108c3ffa91f3': 'to',
+            '4d0183277f0b32005f58108c3ffa9197': 'subject',
+            '8ef44f277f0b32005f58108c3ffa91f7': 'body',
+            '9971a338a70323008299b39f08790195': 'record',
+            e1312338a70323008299b39f087901f5: 'table_name',
+            e8f043277f0b32005f58108c3ffa91d1: 'bcc',
+        },
+        outputs: {
+            f4a503677f0b32005f58108c3ffa91cf: 'email',
+        },
+    },
+    '5d31f8f37f1322004d145212bdfa9145': {
+        name: 'Notification',
+        inputs: {
+            '4d1cbc717f0332004d145212bdfa91b8': 'record',
+            b8a793697f2a32005f58108c3ffa910b: 'table_name',
+            cc7fb8b17f0332004d145212bdfa91da: 'notification',
+        },
+        outputs: {},
+    },
+    a4eb47900b22320085c083eb37673acc: {
+        name: 'Ask for Approval',
+        inputs: {
+            '30a496c67f3012108e688c90ac8665a0': 'approval_reason',
+            '745c0f900b22320085c083eb37673a79': { name: 'approval_conditions', uiType: 'approval_rules' },
+            '982c8b900b22320085c083eb37673a7c': 'record',
+            a44ccb900b22320085c083eb37673ab4: 'table',
+            d3dac4860b333200c438ee6537673a5a: { name: 'due_date', uiType: 'schedule_date_time' },
+            db521c5567323200c4098c7942415a67: 'approval_field',
+            f7b3d09567323200c4098c7942415a65: 'journal_field',
+        },
+        outputs: {
+            aa7568070b23320085c083eb37673a73: 'state',
+        },
+    },
+    '4c9234ca0b18030085c083eb37673aaa': {
+        name: 'Wait For Condition',
+        inputs: {
+            '1fac6063876100102fa5a1bb36cb0bac': { name: 'timeout_duration', uiType: 'glide_duration' },
+            '72b2bcca0b18030085c083eb37673a0b': 'table_name',
+            '7de2fcca0b18030085c083eb37673aed': { name: 'conditions', uiType: 'conditions' },
+            ae1d6463876100102fa5a1bb36cb0b56: 'timeout_schedule',
+            bc93428187120010663ca1bb36cb0b83: { name: 'timeout_flag', uiType: 'boolean' },
+            c5d2fcca0b18030085c083eb37673a1c: 'record',
+        },
+        outputs: {
+            '1fbdac63876100102fa5a1bb36cb0ba2': 'state',
+        },
+    },
+    '81e15fbd7fcb12108e688c90ac866541': {
+        name: 'Wait For Email Reply',
+        inputs: {
+            '391597b17f0f12108e688c90ac866571': 'record',
+            '3e78d3b57f0f12108e688c90ac86653b': { name: 'timeout_duration', uiType: 'glide_duration' },
+            b3285f757f0f12108e688c90ac866575: { name: 'enable_timeout', uiType: 'boolean' },
+            b7a8d7b57f0f12108e688c90ac86659f: 'timeout_schedule',
+        },
+        outputs: {
+            '10991bf57f0f12108e688c90ac866577': 'email_reply',
+            '752ad3397f0f12108e688c90ac866579': 'state',
+        },
+    },
+    '0d9746f0931012105cd181664489188c': {
+        name: 'Wait For Message',
+        inputs: {
+            '15a942b4931012105cd18166448918bc': { name: 'timeout_duration', uiType: 'glide_duration' },
+            '83e74ef0931012105cd181664489182b': 'message',
+            d728c634931012105cd18166448918b0: { name: 'enable_timeout', uiType: 'boolean' },
+        },
+        outputs: {
+            '640b4ef4931012105cd181664489180b': 'payload',
+        },
+    },
+    '8f5c107a53a3230034c6ddeeff7b129d': {
+        name: 'Create or Update Record',
+        inputs: {
+            '5eac547a53a3230034c6ddeeff7b12c7': { name: 'fields', uiType: 'template_value' },
+            '728c907a53a3230034c6ddeeff7b12e9': 'table',
+        },
+        outputs: {
+            '5d0ade9c537b230034c6ddeeff7b12ac': 'record',
+            '9c9ad6dc537b230034c6ddeeff7b127e': 'table_name',
+            '9dbbda1053bb230034c6ddeeff7b12c8': 'error_message',
+            b32b521053bb230034c6ddeeff7b12d2: 'status',
+        },
+    },
+    f760b5c2737c001086592f163cf6a758: {
+        name: 'SMS',
+        inputs: {
+            c951b106737c001086592f163cf6a75a: 'message',
+            dd317dc2737c001086592f163cf6a7fe: 'recipients',
+        },
+        outputs: {
+            '29817506737c001086592f163cf6a72d': 'email',
+        },
+    },
+    '05a6e480a301311029c4d1f3e31e61f1': {
+        name: 'Collect Activity Context',
+        inputs: {},
+        outputs: {
+            '89e202b9a3013110fc7ad1f3e31e616d': 'activity_context',
+        },
+    },
+    '65a40b525b12101083f30f216581c787': {
+        name: 'Create App From Payload',
+        inputs: {
+            '03c116415b03101083f30f216581c74d': 'template_instance_id',
+            c74f30905b33101083f30f216581c7f0: 'scan_id',
+        },
+        outputs: {
+            f343f3925b12101083f30f216581c739: 'sys_app_id',
+        },
+    },
+    e0b9272d53112110aba6ddeeff7b1224: {
+        name: 'Create Record For Remote Table',
+        inputs: {
+            '8d068211a3913110aba698e6d31e61b6': 'query_id',
+            c442d88a53912110aba6ddeeff7b1277: 'create_record_table_name',
+            e5d96b2d53112110aba6ddeeff7b1236: { name: 'create_record_field_values', uiType: 'template_value' },
+        },
+        outputs: {
+            '2b3a236d53112110aba6ddeeff7b129d': 'table_name',
+        },
+    },
+    '0e07df020f13101051218e8ebc767e57': {
+        name: 'Get Latest Response Text From Email',
+        inputs: {
+            '44d757420f13101051218e8ebc767eee': 'email_record',
+        },
+        outputs: {
+            '6f88df420f13101051218e8ebc767e67': 'latest_response_text',
+        },
+    },
+}
+
+/**
+ * Reverse lookup: step definition name → first matching sys_id.
+ * Used during Fluent→XML build to resolve string step type names
+ * back to their platform sys_ids.
+ */
+export const BUILT_IN_STEP_NAME_TO_SYSID: { [name: string]: string } = {}
+for (const [sysId, def] of Object.entries(BUILT_IN_STEP_DEFINITIONS)) {
+    if (!BUILT_IN_STEP_NAME_TO_SYSID[def.name]) {
+        BUILT_IN_STEP_NAME_TO_SYSID[def.name] = sysId
+    }
+}
+
 export const COLUMN_DEFAULTS = {
     string: '',
     boolean: false,
     integer: 0,
 }
 
+/**
+ * Maps platform-internal sys_element_mapping field names to their Fluent API names.
+ * Some step inputs are stored in sys_element_mapping using platform-internal names
+ * (e.g. __snc_dont_fail_on_error) that differ from the Fluent API property names.
+ */
+export const ELEMENT_MAPPING_FIELD_ALIASES: { [platformName: string]: string } = {
+    __snc_dont_fail_on_error: 'dont_fail_flow_on_error',
+}
+
 export enum ChoiceDropdown {
     DROPDOWN_WITH_NONE = 1,
     DROPDOWN_WITHOUT_NONE = 3,
@@ -283,3 +699,32 @@ export function slugifyString(value: unknown, opts: SlugifyOptions = {}): string
  * Core actions that require special catalog variable handling
  */
 export const CATALOG_VARIABLE_ACTIONS = ['getCatalogVariables', 'createCatalogTask']
+
+/**
+ * Input types that do not support inline scripting (wfa.inlineScript()).
+ * These types have special parsing/handling that is incompatible with dynamic script execution.
+ * - 'template_value': Uses template-based field mapping
+ * - 'dynamic_inputs': Inputs are dynamically generated at runtime
+ * - 'glide_variables': ServiceNow-specific variable structures
+ */
+export const INLINE_SCRIPT_UNSUPPORTED_TYPES = ['template_value', 'dynamic_inputs', 'glide_variables']
+
+/**
+ * Per-action field-level blocklist for inline scripts.
+ *
+ * These fields reference catalog metadata (items, variables, variable sets) that must be
+ * resolved at design time for the Flow Designer UI. Dynamic script execution would prevent
+ * proper catalog item selection and variable mapping in the UI.
+ *
+ * Used when the input type alone is insufficient to determine supportability
+ * (e.g., reference/slushbucket fields that are catalog-specific).
+ *
+ * Keys: action names from CORE_ACTIONS_SYS_ID_NAME_MAP
+ * Values: blocked input field names for that action
+ */
+export const INLINE_SCRIPT_UNSUPPORTED_FIELDS: { [actionName: string]: string[] } = {
+    getCatalogVariables: ['template_catalog_item', 'catalog_variables'],
+    createCatalogTask: ['template_catalog_item', 'catalog_variables', 'ah_table_name'],
+    recordProducer: ['catalog_item'],
+    submitCatalogItemRequest: ['catalog_item'],
+}

package/src/flow/utils/flow-io-to-record.ts

@@ -168,7 +168,7 @@ export async function buildVariableRecords(options: {
                 internal_type = COLUMN_API_TO_TYPE[callExpr.getCallee() as keyof typeof COLUMN_API_TO_TYPE] ?? 'string'
             }
             // Handle reference columns - extract reference table
-            if (internal_type === 'reference') {
+            if (internal_type === 'reference' || internal_type === 'records') {
                 const referenceTable = config.get('referenceTable')?.ifString()?.getValue()
                 if (referenceTable) {
                     additionalProperties['reference'] = referenceTable
@@ -223,7 +223,8 @@ export async function buildVariableRecords(options: {
 export function buildVariableShapes(
     variableRecords: Record[],
     descendants: Database,
-    logger?: Logger
+    logger?: Logger,
+    snapshotValues?: Map<string, string>
 ): globalThis.Record<string, CallExpressionShape> | undefined {
     const shapes: globalThis.Record<string, CallExpressionShape> = {}
 
@@ -271,12 +272,15 @@ export function buildVariableShapes(
 
             // Only include $id and co_type_name if NOT deterministically generated
             const schema = JSON.parse(serializedContent)
+            const snapshotValue =
+                snapshotValues?.get(name) ?? variable.get('default_value')?.ifString()?.ifNotEmpty()?.getValue()
             shapes[name] = buildComplexObjectFromSchema(
                 variable,
                 schema,
                 attributes,
                 isDeterministic ? undefined : complexObjectSysId,
-                isDeterministic ? undefined : maybeCoTypeName
+                isDeterministic ? undefined : maybeCoTypeName,
+                snapshotValue
             )
         } else {
             const variableName = variable.get('name').ifString()?.getValue()
@@ -289,7 +293,8 @@ export function buildVariableShapes(
                 variable,
                 additionalProps,
                 descendants,
-                documentation
+                documentation,
+                snapshotValues?.get(name)
             )
         }
     }
@@ -297,12 +302,38 @@ export function buildVariableShapes(
     return shapes
 }
 
+/**
+ * Coerces a raw string value to the appropriate type for the given field type.
+ * Datapill template strings (e.g. {{action.field}}) are returned as-is.
+ * Returns undefined if the value is undefined or empty.
+ */
+function coerceValue(raw: string | undefined, fieldType: string): unknown {
+    if (raw === undefined || raw === '') {
+        return undefined
+    }
+    const strVal = String(raw)
+    if (strVal.includes('{{')) {
+        return strVal
+    }
+    if (fieldType === 'string') {
+        return strVal
+    }
+    if (fieldType === 'boolean') {
+        return strVal === 'true' || strVal === '1'
+    }
+    if (fieldType === 'integer') {
+        return Number(raw)
+    }
+    return raw
+}
+
 function buildBasicVariableShape(
     callExpressionName: string,
     variable: Record,
     additionalProps: globalThis.Record<string, unknown>,
     descendants: Database,
-    documentation: Record[]
+    documentation: Record[],
+    snapshotValue?: string
 ) {
     if (callExpressionName === ChoiceColumn.name) {
         // choice column with choices from other table
@@ -376,20 +407,15 @@ function buildBasicVariableShape(
                         .def(choiceDropdown[1]),
                     default: $.from('default_value')
                         .map((value) => {
-                            if (!value.isDefined()) {
-                                return undefined
+                            // Snapshot output value (datapill or static) takes priority
+                            if (snapshotValue !== undefined && snapshotValue !== '') {
+                                return coerceValue(snapshotValue, fieldType)
                             }
-
-                            if (fieldType === 'string') {
-                                return value.toString().getValue()
-                            }
-                            if (fieldType === 'boolean') {
-                                return Boolean(value.getValue())
-                            }
-                            if (fieldType === 'integer') {
-                                return Number(value.getValue())
+                            const raw = value.isDefined() ? value.getValue() : undefined
+                            if (raw === undefined || raw === null || raw === '') {
+                                return undefined
                             }
-                            return value.getValue()
+                            return coerceValue(String(raw), fieldType)
                         })
                         .def(COLUMN_DEFAULTS[fieldType as keyof typeof COLUMN_DEFAULTS] ?? ''),
                     ...(hint ? { hint: $.val(hint) } : {}),

package/src/flow/utils/flow-shapes.ts

@@ -247,6 +247,10 @@ export class ApprovalDueDateShape extends ObjectShape {
             duration: 1,
             duration_type: 'days',
             schedule: '',
+            // schedule_label is a display-only field derived by ServiceNow from the schedule sys_id at runtime.
+            // It is always serialized as '' here because it is not stored in ApprovalDueDateType —
+            // ServiceNow ignores the stored value and recomputes it from the schedule sys_id on load.
+            schedule_label: '',
         }
 
         //Convert the Due Date to the format expected by Flow Designer and populate with default values

package/src/flow/utils/flow-to-xml.ts

@@ -5,9 +5,9 @@ import {
     unloadBuilder,
     type Database,
     type Relationships,
+    type Plugin,
 } from '@servicenow/sdk-build-core'
 import type { Element } from 'xml-js'
-import { FlowDefinitionPlugin } from '../plugins/flow-definition-plugin'
 
 /**
  * Tables to exclude from delete_multiple generation.
@@ -40,9 +40,9 @@ type DeleteMultipleConfig = {
 
 export function generateXML(
     record: Record,
-    { config, database }: { config: { scope: string; scopeId: string }; database: Database }
+    { config, database, plugin }: { config: { scope: string; scopeId: string }; database: Database; plugin: Plugin }
 ) {
-    const relationships = FlowDefinitionPlugin.getRelationships()[record.getTable()] ?? {}
+    const relationships = plugin.getRelationships()[record.getTable()] ?? {}
     const updateName = `${record.getTable()}_${record.getId().getValue()}`
     const recordBuilder = unloadBuilder(config)
     const table = record.getTable()
@@ -54,7 +54,7 @@ export function generateXML(
         .forEach(([prop, shape]) => builder.field(prop, shape, {}))
 
     // Get descendants using plugin's getDescendants method and group by table
-    const descendants = FlowDefinitionPlugin.getDescendants(record, database)
+    const descendants = plugin.getDescendants(record, database)
     const recordMap = descendants.reduce(
         (acc, rec) => {
             const t = rec.getTable()