Admission
| Symptom | Check |
|---|---|
401 authentication_error | Bearer header, key value, key mode, revocation and environment |
403 permission_error | Required API-key scope |
| Model not found | Active agent slug and workspace ownership |
| Billing readiness failure | Billing-owner workspace and payment state |
Deployment
| Symptom | Check |
|---|---|
| Manifest rejected | salambo manifest --path . --json diagnostics |
| Source upload failed | API authority, archive size and network |
| Managed build rejected | Unsupported image or project configuration |
| Missing secret variable | Export the fromEnv variable before deploy |
| Deployment never becomes ready | Deployment status and build Diagnostics |
Sandbox
| Symptom | Check |
|---|---|
| Sandbox cannot start | Deployment readiness, region and machine availability |
| Runtime contract error | Managed image health and runtime update guidance |
| Tool command denied | Requested path and workspace permissions |
| External request denied | Egress policy and host-only allowlist |
Provider
| Symptom | Check |
|---|---|
| Authentication failure | Provider secret and exposure target |
| Provider unavailable | Provider status and bounded retry |
| Model rejected | Provider name, model identifier and account access |
| Missing provider key in sandbox | The secret may be runtime-only by design |
Extensions and tools
| Symptom | Check |
|---|---|
| Extension missing | extensions path and manifest diagnostics |
| Tool inactive | agent/settings.json active tool list |
| Extension startup failed | Entrypoint, loading mode and contract validation |
| Tool timed out | Diagnostic deadline and external dependency |
Workspace and checkpoints
| Symptom | Check |
|---|---|
| Response failed after output | Post-turn checkpoint may have failed |
| Follow-up cannot resume | Latest ready checkpoint and sandbox recreation |
| Upgrade failed | Checkpoint, provisioning, restore or runtime validation phase |
| New seed file missing | Seeds apply only to new runs, not existing durable workspaces |