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
Question to consider
Complication
The saved conversation says “approved” but current policy denies the operation.
What would you do?
Choose the approach you would be prepared to defend in a design review.
Consider the trade-offs first.
Choose an answer, then run the scenario. You’ll see what the system checks, what happens under the complication, and where the control boundary holds or breaks.
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.