Management jobs and protected review
Submit, inspect and cancel jobs with management credentials and review authorized material.
Management credentials
Set RSIA_MANAGEMENT_TOKEN in the client environment. Its permissions come from the server's registered identity. Keep it separate from an ordinary Agent credential. The current CLI has no --auth-token option.
Submit and inspect
rsia manage OPERATION --url http://127.0.0.1:7788 --request-file /absolute/path/to/request.json
rsia manage job.status --url http://127.0.0.1:7788 --job-id JOB_ID
rsia manage job.cancel --url http://127.0.0.1:7788 --job-id JOB_IDrsia manage OPERATION --url http://127.0.0.1:7788 --request-file /absolute/path/to/request.json
rsia manage job.status --url http://127.0.0.1:7788 --job-id JOB_ID
rsia manage job.cancel --url http://127.0.0.1:7788 --job-id JOB_IDReplace OPERATION with a concrete operation below and supply its versioned request JSON. An empty object is not a substitute for business inputs. The current public dispatcher connects these 24 submission operations:
| Operations | Purpose | Identity |
|---|---|---|
experiment.register, evaluation.start, evaluation.status | Register experiments, start evaluations and inspect evaluation tickets | Evaluator |
exploration.start, replay.run, curriculum.step, meta.start, optimization.step | Exploration, replay, curriculum, meta and optimization jobs | Admin |
trace.export, backup.create | Prepare/publish trace exports and create backups | Admin |
import.register, import.execute | Register and execute imports | Admin |
asset.stage, asset.abort, asset.handoff | Stage, abort and hand off assets | Admin |
export.prepare, export.complete, export.abort | Prepare, complete and abort exports | Admin |
budget.root.authorize, budget.stage_plan.bind | Authorize root budgets and bind stage plans | Admin |
budget.calls.list_open, budget.call.reconcile | Inspect open calls and reconcile budget facts | Admin |
seed.install, monitoring.drift.record | Install seeds and record drift observations | Admin |
Use the request structures and parse_request in the matching public dispatch.rs for fields and schema_version. The server also checks targets, input material, budget and authorization. Registration alone does not make an operation callable: seed.reset_stage and monitoring.environment.record, for example, are not connected through this dispatcher.
job.status and job.cancel operate on an existing --job-id and require its owner identity. They do not submit another business job. Keep the returned ID and inspect terminal status after submission or cancellation.
Review
rsia review --kind typed_candidate --id OBJECT_ID --detail metadata
rsia review --kind stage_fact --id OBJECT_ID --detail metadata
rsia review --kind formal_report --id OBJECT_ID --detail metadatarsia review --kind typed_candidate --id OBJECT_ID --detail metadata
rsia review --kind stage_fact --id OBJECT_ID --detail metadata
rsia review --kind formal_report --id OBJECT_ID --detail metadataStart with metadata. Request --detail exact only when needed; authorization and protected-read rules still apply. This is not arbitrary database-file access.
Recovery
A restored directory needs trusted revocation checks. --trusted-revocations-db is for a restored directory not yet admitted, not an ordinary startup requirement or a way to bypass revocation with an old database.
Use the same-version operational contract and public ledger for recovery and bulk management. Do not delete state or recreate keys as a substitute for admission.