Documentació tècnica — la porta dels agents
Una taula de mescles que un agent pot llegir i escriure amb el mateix contracte que fan servir tots els altres clients.
OpenMixer inclou un servidor MCP per stdio. Les seves eines llegeixen i escriuen una taula de mescles en marxa a través del contracte REST de la mateixa taula i llegeixen els contractes que declara cada etapa del canal en el moment en què se'ls demana. No decideix res: cada resposta són dades que la taula o l'arbre ja tenen, amb l'indicació d'on surten.
01
Com s'executa.
omx-mcp parla MCP per stdio: un client MCP engega el procés i s’hi comunica per la canonada. D’aquesta manera no hi ha cap port ni cap dimoni, ni res que calgui deixar en marxa.
# stdio: un client MCP l'engega i s'hi comunica per la canonada.
omx-mcp
Per a un client que no pot engegar un procés, omx-mcp-http serveix les mateixes eines per l’HTTP Streamable d’MCP. Escolta a loopback tret que MCP_HOST indiqui una altra adreça, al port que indica MCP_PORT. Amb MCP_TOKEN definit, es refusa qualsevol petició sense aquest testimoni bearer. Fora de loopback i sense testimoni, arrenca sense les eines que escriuen i ho diu en arrencar: qui arribi al port pot llegir la consola, però ningú no la pot canviar.
| Variable | Significat | Per defecte |
|---|---|---|
| OPENMIXER_CONSOLE | base URL of the console the console_*/rig_* tools talk to; named in every result | http://127.0.0.1:8080 (core's DEFAULT_WEB_PORT) |
02
6 eines, en dues famílies.
Una família és la porta REST de les entitats tal com és ara: la llista, una fila, els seus recorreguts declarats, un fotograma d'una fila amb mesura i una escriptura. L'altra llegeix els contractes que declaren les etapes de DSP d'un canal: les lleis, els paràmetres i els seus límits. La taula següent es genera a partir de la taula d'eines registrades del paquet, no s'escriu a mà. La prova del mateix paquet rebutja qualsevol descripció que s'hagi desviat del registre.
La taula de mescles
| Eina | Arguments | Què respon |
|---|---|---|
| console_discover | filter | The served entity roster from the console's own contract (OPTIONS /api/): every path template it serves, which rows are pump-fed (measured only while watched), and which carry declared travels and defaults. Optional substring filter over paths. |
| console_meters | strips | One reading of the meter frame, decoded through the windows /meters declares on OPTIONS, projected to the strips asked for (channel keys like "input/1"; all strips when omitted). A pump-fed row measures only while watched, so an unmeasured GET is followed by ONE watch that is closed the moment the first measured frame lands — no stream is held. |
| console_get | path | GET one row by path (e.g. /channel/input/3/fader). The console's status, Allow header and body come back as they are. |
| console_options | path | OPTIONS one row: what it MAY be — its methods, fields, travels (limit/taper), writability and instances, as the console declares them. |
| console_patchescriu | path, body, confirm | PATCH one row with a JSON delta. A REAL WRITE to a desk, sent exactly once and never retried; the console's answer — status, Allow, and the body with its fault, refusal and reason — is returned verbatim. A fire on a confirm-gated row (a channel-config apply that would move gain/trim/pan) is REFUSED BY THE CONSOLE with 409 CONFIRM_REQUIRED while its preview lists moves and the operator's sign-off is on; the body carries the preview. Re-call with confirm: true — it rides the delta as the row's own confirm argument — to apply anyway. |
Els contractes declarats
| Eina | Arguments | Què respon |
|---|---|---|
| contract_laws | stage | The declared DSP contracts for a channel fact (eq, gate, dynamics, delay, reverb, drive, pan, toMain) or a raw C function name: the closed-vocabulary laws with their operator-facing sentence, the parameters and their declared limits where the fact resolves to a numeric table, the C file:line where a contract sits, and whether the rt_contracts.test.c battery exercises it. Read from CHANNEL_CONTRACT and rt-callgraph.mjs's own function map at call time -- never a second copy. |
03
Només una eina escriu i ho fa una sola vegada.
Totes les eines llegeixen menys una. console_patch envia una escriptura real a una taula real. Per això envia exactament una petició, no la reintenta mai i retorna l'estat de la taula de mescles, la seva capçalera Allow i el cos tal com han arribat. Un refús és la decisió de la taula i es retorna literalment, sense interpretar-lo: és el mateix contracte amb què treballen tots els altres clients. La taula de mescles decideix i el que torna és el que ha decidit.
L'eina no retén res pel seu compte. Una escriptura que dispara una operació controlada per la fitxa confirms de la mateixa taula (l'exemple és aplicar una configuració de canal que mouria el guany, el trim o el pan) s'envia igualment. La taula la refusa amb CONFIRM_REQUIRED mentre la previsualització mostri moviments i la conformitat de l'operador estigui activada. El refús torna amb la previsualització al cos, com qualsevol altra resposta. Si es torna a cridar amb confirm: true (que viatja dins el delta com a argument de confirmació de la mateixa fila), s'aplica, perquè ara a l'agent ja se li ha mostrat què accepta. El control és de la taula, de manera que un agent, un navegador i una superfície OSC reben el mateix refús i responen de la mateixa manera: no hi ha cap política al costat del client que calgui mantenir sincronitzada.
La fila amb mesura és l'únic cas en què una lectura no és un simple GET. Una fila alimentada per bombament només mesura mentre algú l'observa. Per això, a un fotograma sense mesurar el segueix una sola observació que es tanca en el moment en què arriba el primer fotograma mesurat. No queda cap flux obert.
Les eines es proven sobre una taula de mescles falsa amb les formes de la real. Es comproven a través del cable amb valors, no amb formes: una lectura de −20 dBFS s'ha de descodificar com a −20. Una taula en directe no forma part d'aquesta bateria de proves.