umc_direct
Start or advance a Universal Manifold Controller Long Play session for one domain (cinema, aviation, gaming or coding): seed the session, decompose the tau height into integer turns, measure the Rational torsion of each turn, shear-correct, converge, and (with checkpoint=true) seal the tip to the UMC_LONG_PLAY KV bucket so umc_resume can continue it on any cell. GRANT CLASS MESH: the call must carry a caller identity - user_vqbit_hash (32 lowercase hex), entity_id or wallet_hash - or it is refused as REFUSED_GRANT_MESH_IDENTITY_REQUIRED with the invocation still sealed. Measured 2026-09-02 with an identity: status CALORIE_GAV_LONG_PLAY; tip carries session_id, node_id, domain, turn_index, tau_height, torsion as torsion_num/torsion_den (and the string torsion), amplitudes as exact rationals, invariant_root_hex, goal_satisfied, stagnant; publish carries the KV key and NATS subject gaiaftcl.umc.state.... Stateful by session_id + node_id; tau_height and max_turns are decimal strings; floats refused. Use umc_status to read the tip without advancing it.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | No | human label for the session, <= 80 characters, informational only | |
| domain | No | which Long Play law governs the session | |
| node_id | No | caller identity for the session (any stable string, e.g. a client name or vqbit hash) | |
| max_turns | No | decimal string: hard cap on turns advanced by this call | |
| checkpoint | No | true seals the tip to the KV bucket at the end of the call so umc_resume can pick it up | |
| session_id | No | caller-chosen stable id; the same id on a later call resumes rather than restarts | |
| tau_height | No | decimal string: how far along tau to run this call (turns are integer steps of tau); omit for the domain default |