> ## Documentation Index
> Fetch the complete documentation index at: https://docs.compose.market/llms.txt
> Use this file to discover all available pages before exploring further.

# Checkpoints

> MAL checkpoints, workflow checkpoints, and agent checkpoint storage.

Manowar has several checkpoint concepts. They serve different readers.

## MAL Checkpoints

MAL checkpoints are ValKey snapshots for typed plans.

| Property      | Value                                                                                 |
| ------------- | ------------------------------------------------------------------------------------- |
| Key           | `mal:run:{agentWallet}:{runId}`                                                       |
| TTL           | 24 hours                                                                              |
| Saved after   | Each successful non-terminal top-level step.                                          |
| Cleared after | Completed, stopped, errored, or aborted plan.                                         |
| Contents      | `planId`, `runId`, completed step index, step results, saved values, aggregate usage. |

Nested `if`, `loop`, and inline fanout blocks do not create separate checkpoint streams. The top-level plan snapshot captures their step result.

## Workflow Checkpoints

Workflow checkpoints are annotations:

| Function               | Meaning                                            |
| ---------------------- | -------------------------------------------------- |
| `recordObservation()`  | What the workflow noticed.                         |
| `recordDecision()`     | A decision and its reason.                         |
| `recordInsight()`      | A reusable lesson.                                 |
| `recordError()`        | A failure signal.                                  |
| `persistCheckpoints()` | Persists run annotations to memory/feedback paths. |

## Agent Filesystem Checkpoints

`harness/checkpoint.ts` provides a local JSON checkpoint saver with retention and health helpers. It is separate from MAL ValKey checkpoints and workflow annotations.

## Related

* [Native observability](/manowar/native-observability-telemetry)
* [Harness architecture](/manowar/harness/architecture)