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. e.g. first long play | |
| domain | No | which Long Play law governs the session | |
| node_id | No | the session node: any stable string naming the client or tab that plays this session, e.g. ide-tab-1. This is NOT the caller identity; identity is user_vqbit_hash, entity_id or wallet_hash | |
| entity_id | No | caller identity, alternative to user_vqbit_hash: the wallet_geo entity id hex, e.g. 00112233445566778899aabbccddeeff | |
| max_turns | No | decimal string: hard cap on turns advanced by this call. e.g. 4 | |
| checkpoint | No | true seals the tip to the KV bucket at the end of the call so umc_resume can pick it up. e.g. true | |
| session_id | No | caller-chosen stable id; the same id on a later call resumes rather than restarts. e.g. r5-session-1 | |
| tau_height | No | decimal string: how far along tau to run this call (turns are integer steps of tau); omit for the domain default. e.g. 8 | |
| wallet_hash | No | caller identity, alternative to user_vqbit_hash: sha256 of the caller wallet, lowercase hex, e.g. 9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08 | |
| user_vqbit_hash | No | caller identity, one of the three this MESH-class tool accepts: exactly 32 lowercase hex, e.g. 0123456789abcdef0123456789abcdef. Send user_vqbit_hash, entity_id or wallet_hash or the call is REFUSED_GRANT_MESH_IDENTITY_REQUIRED (the refusal names the field under need) |