Memory, Scratchpad, And Conclave

The harness has three state surfaces. They are intentionally separate.

Surface	Scope	TTL	Use
Agent memory	Agent/user/thread/workflow scope	Durable or collection-defined	Recall across turns and runs.
Scratchpad	`agentWallet + runId + key`	1 hour	Private per-agent/run state.
Conclave	`rootRunId + key`	24 hours	Shared swarm artifacts and coordination state.

Scratchpad

Scratchpad keys live under:

mal:scratch:{agentWallet}:{runId}:{key}

Use scratchpad for local intermediate state that other agents should not read by default.

steps:
  - op: scratch
    action: write
    key: plan.md
    value: "Draft the outline before synthesis."

  - op: scratch
    action: read
    key: plan.md
    saveAs: plan

Conclave

Conclave keys live under:

mal:conclave:{rootRunId}:k:{key}

Every agent in the same swarm shares the same rootRunId, so the coordinator and descendants can read the same bus. Each write records writtenBy, ts, and a monotonic version. Use conclave for handoff artifacts such as plan.md, phase, draft.html, or cross-agent status.

Memory

Use durable memory for user facts, workflow learnings, session summaries, patterns, and archives. Do not use scratchpad or conclave for long-term personalization.

Checkpoints Tools

Overview

Memory

Harness

Tools

Memory, Scratchpad, And Conclave

Scratchpad

Conclave

Memory

​Scratchpad

​Conclave

​Memory

​Related

Scratchpad

Conclave

Memory

Related