Skip to content

SDK 4.11.0

Latest

Choose a tag to compare

@bryce-godfrey bryce-godfrey released this 19 Aug 23:54

@servicenow/sdk — Release Notes

Version: 4.11.0
Availability: npm — https://www.npmjs.com/package/@servicenow/sdk


🚀 Overview

Version 4.11.0 adds a new TestSuite() API for defining ATF Test Suites in Fluent, table support for Field Styles and schedule entries, and expanded Playbook capabilities including Stage Level Permissions, optional activities, Agentic Activity configuration, and input-dependent resolution. This release includes a comprehensive batch of build/transform reliability fixes for sys_ui_list, sys_dictionary, Data Policy Rules, form sections, and UI Page apps — plus notable fixes to Flow's doTheFollowingUntil logic, AI Agent version handling, and NowAssist skill input naming.


ATF Testing

TestSuite() API (#71)
A new API for defining ATF Test Suites and the tests that belong to them, directly in Fluent.

import { TestSuite } from '@servicenow/sdk/core'

TestSuite({
    $id: Now.ID['my-test-suite'],
    name: 'My Test Suite',
    description: 'Regression suite for the incident workflow',
    tests: [
        { test: 'existing-test-sys-id-or-reference' },
    ],
})

Bug Fixes and Enhancements

Front End Development

Tables

  • Added table support for sys_ui_style, so Field Styles (conditional list/form styling rules) can now be defined with Record().

Lists & Forms

  • Fixed sys_ui_list records being lost during install due to missing root XML attributes; added support for setting a domain on lists.
  • Fixed form sections created via Record() breaking on rebuild when they referenced the platform's built-in Default view.
  • Fixed table-level documentation (hint/help/URL text) being dropped or incorrectly merged with column-level documentation during build/transform.
  • Form, list, and choice-set generated XML now correctly sets apply_defaults on child elements.

References & Data

  • Fixed reference fields on sys_dictionary records (e.g. dictionary overrides) being serialized incorrectly on update.
  • Fixed Data Policy Rule fields at their default (unenforced) state round-tripping to an invalid XML value instead of the correct platform default.
  • Fixed builds generating unsafe delete instructions for table, column, and index definitions.
  • Fixed an incorrect view reference on sysrule_view_workspace records, and documented how to work around similar reference issues.

UI Pages

  • Fixed UI Page apps loading legacy platform scripts that could silently break modern client libraries relying on native Array.from behavior (e.g. overlay dismissal and keyboard navigation in Radix UI-based components).

App Packaging & CLI

  • Fixed app logo images not converting correctly when transforming a sys_app record from XML.
  • CLI error logs now include the underlying cause of fetch failures (e.g. network/auth errors), making them easier to diagnose.
  • Fixed CLI OAuth login unexpectedly requesting an id_token.

Flow

  • Reworked the doTheFollowingUntil flow logic with an improved design, and added a validation error for using until outside of doTheFollowingUntil.
  • Fixed complex output handling in assignActionOutputs.
  • Fixed an inline-script issue in setFlowVariables.
  • Allowed Decimal values inside FlowObject/FlowArray structures.
  • Added a rawInputs property to the flow Action type for dependent-field resolution.

AI Agents

  • Fixed AI Agent version details being silently dropped for legacy/migrated agents that store instructions directly on the agent record instead of a version record.

NowAssist Skill Kit

  • Fixed skill input/output names incorrectly rendering as empty instead of falling back to the attribute name.

Playbook

  • Added support for adding/editing Playbook and Stage Level Permissions.
  • Added optional activity support.
  • Added Set Playbook Outputs Activity definition support.
  • Added support for adding/editing Agentic Activity configuration on Hybrid Agentic Activities.
  • Added On-Demand launcher configurations.
  • Updated build to output a single XML artifact similar to the platform.
  • Added support for input-dependent resolution in Playbook activities.
  • Fixed removed lanes and activities being left orphaned instead of properly deleted.
  • Fixed reference qualifiers being dropped for playbook inputs during transform.
  • Fixed global optional activity variables being incorrectly renamed on transform.
  • Fixed startWithDelay duration transform issues.
  • Fixed TemplateValue pills transform not updating the pill value.
  • Playbook warnings for unsupported features now include the playbook's name for easier troubleshooting.

Documentation

  • Added an SDLC whitepaper and build-support guide.