Sessions

Keep what was actually played before editing makes it seem inevitable. A take preserves one armed performance; a jam adds participants, mapped clocks, and the conditions under which their responses could be heard.

Arm and capture

riffmaw.capture_take@2 requires explicit arming and pins device, clocks, sample rate, latency, monitoring, channels, plug-in state, session revision, and consent. Retain immutable raw audio/MIDI before transcription, timing correction, comping, cleanup, or transformation.

PerformanceTake@1 separates performance from attributed tempo, pitch, timing, score/lyric transcription, and other observations. Their source regions and uncertainty remain visible. Audio governs visible, bounded, revocable capture, custody, and hostile input. A later MusicalPerformanceSession@1 may reference settled takes; shared file formats do not create a jam.

Choose without erasing

A comp names each source take and selected region. Rejected takes retain their own retention; acceptance cannot rewrite them. Device, clock, plug-in, and session changes are explicit revisions. If failure leaves capture uncertain, stop the device and reconcile artifacts/session state before retry; silence cannot prove nothing was recorded.

Music receives artifacts and observations without an open DAW, microphone authority, or credentials. Ordinary spoken replacement/localization remains Language Edition work.

Jam in shared time

riffmaw.open_jam@2 brings participants into one bounded musical session. Spellweaver admits its Invocation/Scroll; the Pattern cannot admit its own Circle or nested production.

Microphones, instruments, MIDI/controllers, clips, remote performers, and machine players each declare monitor, recording, retention, analysis, transformation, remote transmission, and response scope. Required preservation without admitted recording/retention refuses the route or jam. Network presence does not grant recording consent; one performer cannot change another's participation or monitor scope.

“follow behind my attack,” “answer only at phrase endings,” and “that distortion is energy, not a key change” can create successor FeelProfile@1 revisions. They correct interpretation without rewriting performance or earlier observations. This is the long road toward performance-native direction through timing, touch, phrasing, dynamics, repetition, and contrast. Persistent personalization/training still requires separate corpus admission and model promotion.

MusicalPerformanceSession@1 binds revision, participants/roles, assistance policy, model/tool allowlist, and these exact records:

Mix, individual sources, MIDI/control events, responses, and route/clock changes remain attributable. Graph checkpoints keep typed references, bounded sequence state, and receipts—not PCM/MIDI streams, device handles, or plug-in state.

A route's participation is observe (correctable observations, no audible reply), accompany (bounded musical answer), transform (process the selected live route while preserving dry source), or conduct (propose structural/tempo/cue changes). Escalation needs new visible admission by every affected Principal; proposals cannot silently become changes to a human performance.

Performance as a correctable language

MusicalGestureObservation@1 may interpret notes/chords, key/tuning, beat/pocket, accents, articulation, dynamics, timbre, phrases, repetition, tension/release, and player relations. Preserve source regions, feature/model revisions, latency, confidence, and competing readings. It grants no access to emotion or unspoken intent.

JamResponse@1 binds source-time cutoff and lookahead, jam/route epochs, turn sequence, answered observation/cue, controls, ready-by deadline, scheduled window, planned/actual first audible sample, measured latency, output acknowledgement, omission reason, and audio/MIDI artifact.

The realtime stopping line

Audio owns callback, clock-epoch, output-fence, monitoring, reconnect, and uncertain-playback law. Riffmaw adds musical beat/bar mapping and deadline windows. A late machine entrance may be safely omitted; the human monitor remains available without a model. Partial sessions retain acknowledged takes/events. Continuation is a newly armed Invocation with new musical clock and route epoch.

Proving the jam

Use armed dry guitar DI, keyboard MIDI, two local performer roles, and a synthetic remote leg with controlled jitter, loss, and clock-rate divergence. Capture every named clock/graph/MIDI/manifest record and a scheduled response. Exercise xrun, removal, epoch loss, plug-in crash/latency change, late output, and uncertain remote acknowledgement. Prove continued direct monitoring, stale-output fencing, raw audio/MIDI reconciliation, and newly admitted continuation. Export session, sources, stems, MIDI, tempo, and marker maps. This fixture proves state and recovery; measured device latency and musical usefulness need a separate hardware bake.