Skip to main content

MANUAL

Guidance on how to thrive in the swamp.

Swamp is an adaptive automation framework designed to be operated by AI Agents. Start by reading How Swamp Works if you're just getting started.

01Tutorialslearn
02How-to Guidessolve
03Referencelookup

CEL Expressions

Complete reference for CEL expression syntax, context variables, operators, functions, and data queries in swamp

Reference →

Model Definitions

Complete YAML schema reference for swamp model definitions — fields, types, defaults, constraints, and validation rules

Reference →

OpenTelemetry

Reference for OpenTelemetry configuration, span hierarchy, context propagation, and instrumentation points in swamp

Reference →

Workflows

Complete YAML schema reference for swamp workflows — jobs, steps, tasks, dependencies, triggers, forEach iteration, and execution ordering

Reference →

Vaults

Complete reference for swamp vaults — types, creation, key storage, retrieval, CEL integration, encryption, and environment variable mounting

Reference →

Data Outputs

Reference for swamp data outputs: resource and file specs, lifetime, garbage collection, versioning, streaming, tags, sensitive fields, and CLI

Reference →

Repository Configuration

Complete YAML schema reference for .swamp.yaml — every field, type, default, environment variable override, and validation rule

Reference →

Extension Manifest

Complete YAML schema reference for swamp extension manifests — every field, type, constraint, path resolution rule, and push validation

Reference →

Data Querying

Reference for swamp data query: CEL predicates, DataRecord fields, --select projections, tag filtering, data.query() in expressions, and interactive TUI

Reference →

Datastore Configuration

Reference for swamp datastore backends, configuration fields, environment variable overrides, sync behavior, distributed locking, and CLI commands

Reference →
04Explanationunderstand