Durable Engine

Uses local.WithLocalConfig(&local.LocalConfig{Engine: engine}) instead of the SDK-built default engine. You create and own the durable-go engine — required for AES-GCM payload encryption, journal MAC, and a step-token key that survives a process restart. Same split as temporal.WithTemporalClient. Source: examples/agent_with_durable_engine/

What it demonstrates

durable.NewEngine with WithPayloadCodec, WithJournalMACKey, WithStepTokenKey
local.WithLocalConfig(&local.LocalConfig{Engine: engine}) on NewAgent
Caller-owned engine lifecycle (defer engine.Close() — a.Close() does not close it)

Run

From examples/ (local runtime only — no Temporal or Restate):

go run ./agent_with_durable_engine "Hello, what can you do?"

Optional env (hex). If unset, the example generates random keys and a temp dataDir:

Variable	Purpose
`DURABLE_PAYLOAD_KEY`	AES-GCM key (16/24/32 bytes hex)
`DURABLE_JOURNAL_MAC_KEY`	Journal HMAC key
`DURABLE_STEP_TOKEN_KEY`	Approval token key (survives restart)
`DURABLE_DATA_DIR`	Journal directory (default: temp dir, deleted on exit)

Key code

engine, err := durable.NewEngine(ctx, dataDir,
    durable.WithPayloadCodec(codec),
    durable.WithJournalMACKey(macKey),
    durable.WithStepTokenKey(tokenKey),
)
defer engine.Close()

a, err := agent.NewAgent(
    local.WithLocalConfig(&local.LocalConfig{Engine: engine}),
    agent.WithLLMClient(llmClient),
)

For simple local dev without encryption or a stable token key, omit Engine — see In-Process runtime.

Expected output

I'm a helpful assistant powered by an LLM. I can answer questions, help with tasks,
and have multi-turn conversations. What would you like to explore?

The response is identical to the simple-agent — the difference is the journal (encrypted + MAC-signed) and caller-owned engine lifecycle.

Before You Begin

Basic Agents

Configuration

Tools & MCP

Streaming & AG-UI

Memory & RAG

Observability & Hooks

A2A

Multi-agent

Durable & Distributed

What it demonstrates

Run

Key code

Expected output

Learn more

In-Process Runtime

Temporal Client

​What it demonstrates

​Run

​Key code

​Expected output

​Learn more

In-Process Runtime

Temporal Client

What it demonstrates

Run

Key code

Expected output

Learn more