Skip to main content

Documentation Index

Fetch the complete documentation index at: https://solo-09d10f60.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

​
Worker configuration

A worker is the machine that runs agent jobs and exposes a wake-gate API to the control plane. In local development, the control and worker roles can point at the same 127.0.0.1:8787 app.

​
Connection fields

  • worker_wake_gate_url — base URL for the worker wake-gate API.
  • worker_wake_gate_bearer_token — bearer token the control plane uses when calling the worker.
For local development, set both worker_wake_gate_url and completion_callback_url to the local service. For production, use distinct tokens and hostnames.

​
Evidence sync fields

  • paper_evidence_sync_enabled
  • paper_evidence_sync_ssh_host
  • paper_evidence_sync_remote_root
  • paper_evidence_sync_timeout_sec
Enable evidence sync only after you know the control service user can read the worker project artifacts it needs. If sync fails or artifacts are missing, generated paper records should be treated as incomplete.

​
Stale-process reaper fields

  • stale_project_process_reaper_enabled
  • stale_project_process_grace_sec
  • stale_project_process_term_grace_sec
  • stale_project_process_command_markers
Default markers include common local inference/server commands such as llama-cli, llama-server, vllm, and sglang. Keep markers specific to avoid terminating unrelated processes.

​
Minimal worker run

scripts/install-worker.sh
OMX_WAKE_GATE_CONFIG=$HOME/.config/enoch-worker/config.json \
  uv run uvicorn omx_wake_gate.app:app --host 0.0.0.0 --port 8787

​
Verify from the control VM

curl -fsS -H "Authorization: Bearer $ENOCH_CONTROL_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"wake_gate_url":"http://<worker>:8787","bearer_token":"<worker-token>","require_paused":false,"strict":false}' \
  "$ENOCH_BASE_URL/control/api/preflight" | python3 -m json.tool