API lesson 05 · Place conversation state
Shared system · deterministic provider fixtures
Harbor Support Drafting API. One bounded request moves through typed items, tools, state, budgets, and evidence without live provider calls.
01 · Smallest useful mechanism
APIs support manually replayed items, response chaining, or durable conversation objects. Each choice changes retention, portability, observability, token cost, and recovery.
A model conversation is not the system of record.
02 · Experiment
Deterministic protocol fixture
This workbench uses inspectable provider-event fixtures and injected failures. It does not make live calls or execute external effects.
Protocol workbench · harbor-state-v2
Injected failure
The saved conversation says “approved” but current policy denies the operation.
The trace has not run.
Commit to an implementation, then inject the failure and inspect the actual state transitions.
03 · Implementation brief
Your learning artifact
Stored only in this browser. No account required; course reset does not delete it.
04 · Check your understanding
Primary sources · verified 2026-08-02
Hidden or stale conversation state can leak data, preserve revoked preferences, lose tool evidence, or make incidents impossible to reproduce.
Common mistake: Passing a previous-response ID means earlier tokens are free and current. Continuation can simplify state handling, but prior context may still be processed or billed and external facts still require freshness checks.
Transfer exercise: Resume a case after the policy version and user authorization have changed; decide which information must be refreshed rather than replayed.
Next: State placement makes recovery possible; reliability engineering decides when to retry, shed load, cache, or stop.