Docs

Changelog

Developer-facing changes to the smart-app API, the integration SDK and the Flow Editor, by platform snapshot.

The reference section is generated from a snapshot of the platform source. Each entry below names the snapshot and summarises what changed for developers; npm run docs:diff in the docs repo produces the raw list.

2026-10-07 — friendly state comparisons

Platform working tree after 4667bd8c (uncommitted at the time of writing; the snapshot sha is updated when the change lands).

  • Smart apps: subscribe from / to accept the friendly label the app shows for an entity as well as the raw token; new entity.is() / isNot() and matchesState(). getState() stays raw. Needs a hub on the new runtime; see Raw tokens and friendly labels.
  • Flows: typed states (AI builder, imports, Manual-start test values) are normalised to raw tokens on save; new unknown state warning; trigger.state / trigger.friendlyState comparisons fold case and separators.
  • Reference: capability pages now list the friendly label per raw token and device class.

2026-10-06 — initial publication

Platform snapshot 2c92c87f (2026-10-05).

  • First publication of the developer documentation: smart-app API, integration SDK, Flow Editor guide and generated reference.
  • Reference coverage: 45 smart-app globals and EntityWrapper members, 33 entity domains, 20 input types, 42 Flow steps.
  • Known gaps are listed on Known discrepancies.

On this page