migrate-waniwani-sdk-0.23-to-0.24

Installation
SKILL.md

Migrate @waniwani/sdk 0.23 → 0.24

A self-contained migration for the single hop from 0.23.x to 0.24.x. It covers only that jump; for other version boundaries use the matching migrate-waniwani-sdk-<from>-to-<to> skill, or the general procedure in the SDK's changelog.

Precondition: the project is on @waniwani/sdk@0.23.x. If it is on an older version, migrate up to 0.23 first; if it is already on 0.24+, run the procedure anyway, since most of this hop is invisible to tsc and a project can compile on 0.24 while its flows lose answers.

Projects with no createFlow call have nothing to migrate. Bump the dependency, run the completion check, and stop.

What 0.24 changes

In 0.23 a flow tool listed its whole Zod state schema under stateUpdates in tools/list, and any call could write any state field. A model told to "always include locale on start" set it, and so could text injected into the conversation, including fields the flow computes for itself, such as a vehicle id that decides what gets priced.

In 0.24 the listing names no field. Each interrupt or widget response names the fields it asks for, with their fieldSchema. The engine records the fields a run has asked (asked on the session record) and merges stateUpdates only for those. A question on a z.object group accepts every key inside it.

A value sent for a field the run has not asked yet is dropped. When the flow later asks that question, the model answers it from earlier messages with one silent continue, and the user is not asked again.

This skill covers 0.24.0 to 0.24.2. 0.25.0 sends every state field to the model once per conversation, in fields, and writes any declared field again. A project going from 0.23 straight to 0.25 skips this skill and runs migrate-waniwani-sdk-0.24-to-0.25, which covers that jump and does not need rewrites 1 to 3 below.

Breaking, and visible to tsc:

Installs
1
Repository
waniwani-ai/sdk
GitHub Stars
18
First Seen
Oct 28, 2026