Skip to content

Example Catalog

Use this page to choose the sample closest to what you are building. Each example has a focused page in the Examples section, plus a source link for copying the actual runnable file.

Run From The Repo

Install the local checkout once:

python -m pip install -e "./coactra[all,dev]"

Then run examples from the repository root:

python3 examples/incident_response_handoff.py
python3 examples/work/release_work_lifecycle.py
If you are building... Start here Source
a normal single-agent app Basic Incident Triage source
explicit function-first composition Support Desk source
a higher-level SDK loop Offline Agent SDK source
support or helpdesk memory Resolution Memory source
combined helpdesk (agent + work + memory) Ticket Triage source
durable jobs or releases Work Order Lifecycle source
procedure-backed work orders Procedure-Backed Work source
release project layout Release Checkpoint source
a file-backed agent desk Research Workspace source
multi-agent collaboration Approval Routing source

Naming Style

Docs examples use a small naming convention:

Prefix Use for
make_* local port factories and backend adapters
build_* composition roots that assemble ports and facades
submit_* durable work creation
draft_* model-generated first-pass output
triage_*, run_*, handle_* application behavior

Application behavior should stay function-first:

def triage_incident(agent, work, incident: str):
    ...

Use classes when they own durable state or an external boundary, such as WorkManager, SqlWorkStore, memory backends, workspace backends, A2A transports, or OAuth/Keycloak exchangers.