Repository navigation
Stable Build v0.8.0
v0.8.0 — Upgrade to Fluent SDK v4.13.6
ServiceNow SDK v4.13.6
Bumped @servicenow/sdk 4.11.2 → 4.13.6. This release covers everything shipped across 4.12.0–4.13.6.
Only 4.12.0 and 4.13.0 published release notes, and 4.13.1, 4.13.2, 4.13.4 and 4.13.5 were never published
to npm. The surface was therefore established by diffing the installed package (types, build plugins, CLI
flag declarations) against 4.11.2.
Four new metadata types (75 total):
assessment—Assessment()defines an assessment or survey with its categories, metrics, and
metric definitions. A scored assessment also writes its scoring business rules, and a scheduled one writes
asys_triggerjob that ships inactive.risk-assessment—RiskAssessment()defines a change risk assessment with categories, metrics,
and thresholds. It requires the Change Risk Assessment plugin, which the build cannot check.database-view—DatabaseView()joins existing tables into a read-only reportable view.nameis
the identity (no top-level$id) and needs theu_(global) or<scope>_(x_scope) prefix.interceptor—Interceptor()defines a guided-question wizard (sys_wizard+
sys_wizard_answer). It appears in no upstream release note.
Existing types updated across specs, instructions, and snippets:
- Playbook — variants,
GoBack,isIdealPath,actionOverrides,publicAccess, and
automationPlan(). Potentially breaking:NewRecordForm.tableandChecklistTask.checklist_items
are now mandatory, andinterface … extends BaseActivityConfigfails with TS2312. - Flow —
tryCatch/doInParalleloutputs are hoisted,endFlowworks inside either arm, and the
old "usesetFlowVariables" rule is retired. - Table and column —
indexon augments,allowConfiguration/dbObjectId, relativeUrlColumn
values, andhint/help/pluralnow reachingsys_documentation. - ACL — the
aiux_page,aiux_widgetandaiux_experiencetypes (they requirename) and per-role
protectionPolicy. - UI Action — programmatic-only
form/list: trueand the'primary-ai'/'secondary-ai'
styles. $meta— now accepted onEmailNotification,UiPolicy,ScriptOnlyCheck,TableCheck,
CatalogClientScript,CatalogItemRecordProducer, and catalog variables.- ATF — optional
assert/catalog/categoryinputs, andatf-server-catalog-itemnow uses the
real snake_case names; the old camelCase names never built. - Dashboard — fixed long-standing errors: the grid is 48 columns, and data binds inline instead of
by report sys_id.
MCP tool changes (still 17 tools):
cicd_fluent_testgainsaction: "logs"for a single test result's logs.deploy_fluent_appgainsasyncand a 15-minute budget, because the CLI's async install poll has no
cap of its own.download_fluent_appandfluent_transformgaintimeoutSecondsfor the new--timeout(idle
seconds, CLI default 3600).fluent_transformnow rejects flag combinations the CLI forbids before spawning anything:fromwith
authorid, andidorforcewithouttable. It also exposesforceandformat.now-sdk auth --printis deliberately not wrapped, because it would put a live token into model
context.
Prompts aligned with now-sdk explain and real builds:
coding_in_fluentis now TypeScript-first. Server logic goes in TS modules undersrc/server/
importing from@servicenow/glide, with JavaScript viaNow.include()only as the fallback for
string-only fields, and ES2021 is the default.- Its syntax rules cite the real diagnostics (loops TS250,
ifTS245,+TS303) and warn that
.map()-generated records build but are corrupt. get_sys_id(...), which is not an SDK API and fails a real build, is replaced byNow.ref.- A bundled UI Page's
index.htmlmust be imported.Now.include()there builds successfully but
ships the unrewrittensrc="./main.tsx". create_custom_uinow has an endpoint that builds, the React 18.2.0 dependency set, and theclientDir
/staticContent.pathstrap.
Fix: npm run inspect, inspect:dev and inspect:published failed with could not determine executable to run, because @modelcontextprotocol/inspector@2.10.0 ships two executables. The scripts
now pin 2.10.0 and name mcp-inspector.
Corrections to upstream notes and docs, verified against the installed package:
- The 4.13.0
DatabaseViewexample does not compile (it fails in six ways). RiskAssessmenthas notableorevaluationMethod.- The string form of
displayedWhen/correctAnswerChoiceis silently written empty. publicAccessis not a public API.- The CLI
--timeoutdefault is 3600 s, not 300. transform --tablewithout--idfilters local XML and never downloads.- Table augments need
<scope>_in everyx_scope, Store apps included, so the earlier advice to use
u_for them was wrong.
Dependencies & verification
- 47 Jest suites / 903 tests green. Build, TypeScript and lint are clean, and 75/75 specs and 75/75
instructions pass. - Every new and changed snippet compiles with
now-sdk buildon 4.13.6, with 0 unexpected failures. - Driven live in the MCP Inspector: 17 tools, 224 resources, a real
build_fluent_app, and the corrected
prompts served. - New types (notably
interceptorinstall behavior) are not verified against a live instance; smoke test
them on a target instance.