migrate-waniwani-sdk-0.24-to-0.25

Installation
SKILL.md

Migrate @waniwani/sdk 0.24 → 0.25

A self-contained migration for the hop to 0.25.x. It covers projects on 0.24.x, and projects on 0.23.x that skip 0.24. 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.24.x or @waniwani/sdk@0.23.x. On 0.23.x, do not run the migrate-waniwani-sdk-0.23-to-0.24 skill first. Read "Starting from 0.23" below, then run this procedure. On an older version, migrate up to 0.23 first. If the project is already on 0.25 and its flows were written for 0.24, run the procedure anyway: almost all of this hop is invisible to tsc, and a flow can compile on 0.25 while the model fills its consent questions.

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

To see which write rule the installed SDK runs:

grep -rhoE 'takes fields the flow (listed in `fields` or )?has asked' node_modules/@waniwani/sdk/dist | sort -u

takes fields the flow has asked is 0.24 (asked-only gate). takes fields the flow listed in `fields` or has asked is 0.25. No output is 0.23 or older.

What 0.25 changes

In 0.24 a call wrote only the fields the run had asked through an interrupt question or a widget's field. The model never saw a field name before its question, so it could not send what the user had already said, and a field no question asks could never be set from the conversation. That gate also kept the conversation away from fields the flow computes for itself.

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