Reference
rn_session
Inspect and transition the fenced rn-dev-agent authority session. Status reconciles lost managed Metro authority without touching the app; bind, handoff, adoption, recovery, managed Metro cleanup, and release actions are fail-closed.
Parameters
Section titled “Parameters”| Name | Type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
action | enum: status | bind_source | bind_device | bind_metro | pin_dev_client | prepare_handoff | cancel_handoff | accept_handoff | adopt_stale | release_stale_device | recover_arbiter | preview_integration | apply_integration | restore_integration | stop_metro | release | Yes | |||
projectRoot | string | No | bind_source: same-repo worktree to rebind; other actions refuse on mismatch | ||
platform | enum: ios | android | No | Required with deviceId for foreign transfer; omit both to resume own journal | ||
deviceId | string | No | Required with platform for foreign transfer; omit both to resume own journal | ||
appId | string | No | |||
devClientUrl | string | No | |||
buildReceipt | Record<string, unknown> | No | |||
metroPort | number | No | min: 1, max: 65535, integer | ||
metroPid | number | No | integer | ||
metroInstanceId | string | No | |||
buildGeneration | number | No | integer | ||
mode | enum: managed | external | No | |||
targetHandle | string | No | |||
ttlMs | number | No | min: 5_000, max: 300_000, integer | ||
handoffId | string | No | |||
token | string | No | |||
adoptionHandle | string | No | |||
releaseHandle | string | No | Legacy release-offer capability; confirmed: true supersedes it | ||
confirmed | boolean | No | Authorizes inline proven-dead device cleanup | ||
force | boolean | No |
rn_session(action: <enum: status | bind_source | bind_device | bind_metro | pin_dev_client | prepare_handoff | cancel_handoff | accept_handoff | adopt_stale | release_stale_device | recover_arbiter | preview_integration | apply_integration | restore_integration | stop_metro | release>)