nx_engine_dispatch.nx

nx_engine_dispatch.nx -- ES3 of /compare/engineshift: THE DISPATCHER. ONE verb sends a task to the cheapest engine whose terms permit its class, stops at the first engine whose output the task's declared judge passes, returns the verdict with the engine named, and appends a shift-ledger row so the engine-shift scoreboard's local column can move (ES0 nx_seat shift; ES1 nx_seat_meter_beat writes the Claude column, this organ writes the local one). MEASURED 2026-09-02 before building: three routers existed and none was wired (nx_llm_provider 0 production importers, llm_routes.conf 0 active rows, nx_clawf_route registered-dark), and the local column had read ZERO since 2026-07-20 because nothing ever wrote it. THE LADDER (the operator's order: sovereign first, rent the frontier seat only for what only it can do): 1 LOCAL the sovereign no-float seat (nx_nofloat_serve, POST /gen on --local, default 127.0.0.1:8032); any class -- the bytes never leave the machine 2 EXTERNAL a free external worker through the estate's warden (nx_extllm_call over the sovereign MCP client); class U ONLY -- a C task is SKIPPED BY NAME here and the warden re-checks at the door (extllm XL2) 3 FRONTIER the rented seat. NOT an engine this organ can call: it exits NEEDS-FRONTIER with the task summary and the seat that reads it decides. Escalation is on a RED judge, never on a budget. THE JUDGE is declared in the task, never chosen here: `judge|kat|<expected-file>` (byte-exact after trimming outer whitespace) or `judge|contains|<literal>`. An engine's answer that the judge cannot read is UNOBSERVABLE, never GREEN and never RED. ES16 (operator 2026-09-02, "minimise token use autonomously without my engagement"): WHICH engines a task may try, its clearance and its token ceiling are DATA -- knowledge/engine_classes.conf rows `class|<name>|<U or C>|<engine order>|<max_new ceiling>`, named by the task's `tclass|<name>` row. A task with neither tclass nor class is REFUSED by name; it never defaults its way onto the frontier seat. A C row that lists external is refused at load, before any task runs. nx_engine_dispatch run <task.conf> <state-dir> [--local a.b.c.d:port] [--no-external] [--dry] [--mcp <nx_mcp_call elf> --base <url> --cap <seat cap> --extcap <extllm cap>] [--keyfile <path outside the estate>] [--ledger <estate egress ledger>] [--classes <engine_classes.conf>] nx_engine_dispatch judge <candidate-file> <task.conf> task.conf rows (pipe-separated, # comments): name|<id> tclass|<class row name> or class|U or C prompt|<path> judge|kat|<expected-file> or judge|contains|<literal> max_new|N (default 24; the class row's ceiling and the seat's 96 cap both bound it) subsystem|<name for the egress ledger> Ledger: <state-dir>/engine_dispatch.jrnl, one row per engine attempt: epoch TAB task TAB engine TAB status TAB verdict TAB gen_tokens TAB ms TAB note. Shift row on a LOCAL GREEN when --mcp is given: nx_seat meter maker-local-dispatch 1 <gen_tokens> <prompt_tokens> 0 dispatch-<task>-engine=local-src=nx_engine_dispatch Exit: 0 GREEN (an engine passed) | 2 usage | 3 UNOBSERVABLE (no engine could be reached) | 4 NEEDS-FRONTIER (every engine below the seat was reached or excluded by its class row and none passed). verdict= is the last token. license_tier: ORIGINAL. Writes only the ledger under <state-dir>. No hw writes (Rule 26).