Managoat

Managoat is the hosted Fountain. Fountain is the open-source engine, and its name is on the CLI, the API, the SDK and this manual. Everything here applies to Managoat unless a page says it is for a self-hosted server.

Sandbox errors

This guide shows you how to read a failure to provision, and what the retries already tried for you.

The examples below use the Sprites path, which is the default. The shape is the same on the other providers, because each adapter normalizes the provider's errors into one taxonomy. Read the sandbox contract.

What the retries already cover

Fountain tries a transient failure on the provision path up to three times. That is the first call and two retries, with exponential backoff. Transient means a 5xx, a 429 or a timeout. SPRITES_TIMEOUT_MS bounds each call, and the default is 30s.

You see a failure only after all three attempts fail.

What a 4xx means

Fountain does not retry these, and that is deliberate.

  • 401 or 403. The provider token is invalid, revoked or absent. Check this first. It fails each conversation while everything else looks healthy.
  • 409 on create. Fountain handles this. It adopts the sandbox that already exists, so you never see the error.

During a provider outage

A new conversation fails, and so does a wake. A fresh provision marks the conversation failed. A wake leaves it resumable for later.

Sign-in, dashboards, configuration and past logs all still work.

The readiness probe deliberately leaves the sandbox provider out. A third party's uptime does not belong on the request path, so do not expect a pod to go NotReady over it.

If you scrape metrics, a failure to provision shows as fountain_stage_count{stage="provision", status="failed"}. A success shows as status="done".

Quota, and not an outage

A user at their quota for concurrent sandboxes, which is 2 by default, sees a provision fail while the provider is healthy. A crashed provision leaves a row that counts until the reaper releases it, each hour at :07. An admin can release it now with POST /api/admin/sandboxes/:id/reap, or raise the cap with POST /api/admin/users/:id/sandbox-limit. Read A conversation is stuck or failed and Admin.