Make Codex and Claude Code subscriptions go further: a local model router that gives routine agent work to economical models and keeps your strongest model for the hard parts.
CLI request input ownership
src/request_input.rs owns selection of --request-stdin or --request-file PATH,
bounded byte reads and strict UTF-8 JSON decoding. A request file must be regular;
opening a FIFO does not wait for a writer. Relative paths use the caller's working
directory. Prefix option-shaped filenames with ./. Exactly one source is accepted;
repeated sources, mixed sources and mixtures with human options fail with
INVALID_ARGUMENTS before Local Control access. A file never reads stdin.
The parser rejects duplicate object members at every nesting level (including escaped
aliases of the same key) and trailing JSON. src/request_input/fields.rs audits the
typed request's declared object fields, including skipped optional fields and tagged
unit variants; maps/JSON Values keep free keys and typed map values remain checked.
Serde's existing positional struct arrays remain accepted and checked in field order.
Current request DTOs have matching Serialize/Deserialize names without aliases or
flatten; future asymmetric codecs require an explicit adapter and regression tests.
This CLI boundary must not tighten persisted Domain recovery readers. Command owners
then select the permitted schema/intent and retain semantic checks:
control_plane.rs: typed management requests and Preview/Apply schema unions.observation.rs: sessions, timeline, Facts, value and plan-quality intents.lib.rs: Operation idempotency lookup; legacy positional command codecs.worker/input.rs: dependency selection only;--fileremains prompt text.tasks.rsandwork_plans.rs: staged collaboration selectors and grant separation; adding a source does not promote these commands to the public command registry.
Keep each existing limit: 1 MiB by default, 64 KiB for Operation idempotency lookup
and dependency selection, 4 KiB for staged WorkPlan listing. Protected secret and
capability readers are independent; JSON/file selectors do not grant authority.
Windows uses --capability-handle, setup --spec-handle, and protected-input
--secret-handle for pointer-width inherited private pipes. The platform duplicates
the borrowed handle without taking the caller's ownership, rejects stdio and non-pipes,
and bounds EOF reads in time and bytes. Unix descriptor flags retain their contracts;
neither a request-file selector nor native handle text contains the credential itself.
The shared reader does not execute a shell, alter requests or choose a business schema.
sessions receipt RECEIPT_ID continues to serialize SessionLookupV1 and read the v1
RoutingReceipt. Both JSON sources accept only an ObservationReadRequestV2 with the
facts intent and its logical RequestId from a v2 timeline, through the existing
GetRoutingReceipt operation. The response is the v2 Facts page. Wrong intents fail
locally. Do not translate a SessionId or ReceiptId into a RequestId.
Positional resource codecs exclude empty and option-shaped values. Unknown options
must be usage errors before a lookup; a failed resource search cannot stand in for
argument validation. src/args.rs preserves the request-file path as an option value
while extracting global flags. Follow tests/request_input.rs for actual binary argv
regressions and the owner codec tests for typed projections. Generated help/channel
metadata belongs to application-api; regenerate CLI and Product E2E contracts together.
Quickstart composition and prepared files
quickstart.rs and its leaves own read-only navigation, bounded convenience flags and
composition over existing Local Control requests. They own no default editor, save transaction,
credential store or observation database. routing options authoring owns initial/reopen policy;
agent_effective_state composes current settings with authenticated receipt identity.
Supported Preview commands accept convenience flags OR one JSON input source. --apply-file
may accompany either form and creates a new private request atomically with noclobber semantics.
The opt-in result wraps the unchanged Preview with the exact Apply argv and Operation lookup tuple.
The original Apply file/key is the retry identity, not a submission journal. Advanced unsupported
Preview variants stay available as typed requests but cannot silently produce a different Apply.
A Desktop login-item requirement blocks prepared submission until the actual host handles it.
effective_status.rs preserves legacy positional output and adds explicit --effective --context ID --plan ID and typed-request forms. Native loading stays unknown without observation. Quickstart
and status never activate a process or call a model. command_schemas.rs in Application API derives
complete offline schemas from wire DTOs; unflagged descriptor output is unchanged. Detailed input
errors are opt-in and bounded; raw input, enum values and arbitrary object keys never enter hints.
The installed Quickstart scenario covers first use, smart saving, exact replay, stale submission, continuation and one-facet restore. Native caller/target activation is a separate acceptance obligation, not established by external fixtures.
Decision onboarding and human terminal input
quickstart/decision.rs presents the shared bundled provider presets and existing saved-service
query without probing them. It translates convenience save/test flags to existing typed operations;
--apply-file on decision services apply requires Preview input and never submits an Apply.
Service edits preserve omitted connection fields and require explicit credentials for endpoint
changes. Immutable Secret references and pinned Plan revisions remain owned by existing services.
The same preset asset is consumed by Desktop; it is not a current provider availability catalog.
protected_prompt.rs is a user terminal adapter for the existing protected socket. It reads only
/dev/tty with echo and signal characters disabled, restores terminal settings through the guard,
bounds/zeroizes input, and adds the selected header scheme. It never reads stdin or writes a secret
to CLI output; --secret-fd retains its released meaning. The human executes the prompt outside
Agent tools/chat and returns registration status only. Non-Unix hosts report action required.
The installed Quickstart scenario includes PTY cancellation/error/no-terminal checks and actual
saved-service test, exact retry and controlled decision-to-execution receipts.
Complete Plan recovery input
routing preview --plan ID --restore-from BEFORE_JSON [--apply-file NEW_FILE] consumes a complete
successful routing show machine response saved before the edit. It is exclusive of typed request
input and individual edit flags. The existing strict, bounded regular-file codec validates the
response/target; the saved authoring value uses the Domain editor projection and the current target
head for normal content Preview/Apply. It never restores sources/credentials/native files or rewinds
immutable metadata. An uncertain Apply retains its original file/key; stale/dependency errors remain
explicit. Both preview effects and all restored effective fields must be reviewed.
Observation content/search reads use same-user Local Control without a separate GUI ticket;
explicit grants remain checked. The CLI accepts matching V2 catalog/ancestry/content on sessions
show and search/session_search on sessions list. Request facts and plan-quality use their existing
owners. value show --basis api-equivalent --reference-binding ID --currency CNY|USD selects a new
read-only V2 intent; unflagged value calls retain the released historical response. Application pins
one current price handle, and Observation reuses normalized retained usage and integer valuation.
This does not rewrite settlement or claim subscription cash savings. See the standalone CLI guide
for the explicit reference, incomplete coverage and source-specific price restoration workflow.