Skip to main content

Module http

Module http 

Source
Expand description

HTTP and dashboard router construction. axum HTTP/JSON workflow facade.

Module layout:

  • [router] — public router construction (the only public surface).
  • workflows — workflow management handlers.
  • children — authorized direct-child projection for one parent run.
  • schedules — schedule management handlers.
  • events — websocket event-subscription handlers.
  • deploy — operator deploy handlers (mounted only when [deploy].enabled).
  • awl_deployed — the read-only deployed-AWL studio surface (mounted only when [deploy].enabled, alongside the deploy read model it reflects).
  • authoring — server-side Gleam authoring (mounted only when [authoring].gleam_path is set).
  • dev_ui — local dev-server surface (mounted only when [dev].enabled).
  • auth — caller-identity extraction from request headers.
  • routing — shard-owner forwarding for HTTP writes (clustered builds).
  • visibility — visibility query-string parsing and namespace scoping.
  • payload — HTTP body/payload encode-decode shapes and conversions.
  • buildGET /build, the server’s own revision.
  • update_statusGET /update-status, the installed version joined with the last completed manual update check.
  • describe_live — the mid-step join: current step + attempt liveness + progress note + transcript tail, in one read.
  • assistantGET /assistant, the built-in assistant this binary carries.
  • queues — the fleet-wide unserved-queue read.
  • managed_workersGET /workers/managed, the supervision status join, and the POST /workers/managed/{name}/{start,stop,restart} lifecycle commands (mounted only when [deploy].enabled, like the gRPC DeployService counterparts they mirror).
  • unrecoverable — the fleet-wide degraded-residency read.
  • clean_dtos — clean JSON request/response DTOs for the workflow POST endpoints.
  • error — wire-error-to-HTTP response mapping.

Functions§

http_router
Build the public HTTP application: workflow-management routes first, then the ops-console static asset fallback. The ops console adds no data API.
workflow_router
Build the public workflow-management HTTP router.