chore: remove examples/demos and all references

README.md

@@ -221,12 +221,6 @@ each tutorial is a working program against a real model.
 | **Production** | [`19_guardrails_security`](examples/tutorial_19_guardrails_security.py) · [`20_checkpoint_backends`](examples/tutorial_20_checkpoint_backends.py) · [`28_agent_server`](examples/tutorial_28_agent_server.py) · [`37_termination`](examples/tutorial_37_termination.py) |
 | **OCI** | [`29_model_providers`](examples/tutorial_29_model_providers.py) · [`40_oci_dac`](examples/tutorial_40_oci_dac.py) — Dedicated AI Cluster endpoints |
 
-End-to-end demos:
-
-- [`examples/demos/po_approval/`](examples/demos/po_approval) — three agents (Procurement / Compliance / Approval Officer) debate a vendor PO against a live Oracle 26ai catalogue. Idempotent writes. Human consent gate.
-- [`examples/demos/oracle_26ai/`](examples/demos/oracle_26ai) — full Oracle stack: OCI GenAI + Oracle 26ai vectors + skills + Reflexion + idempotent submit + checkpoints to OCI Object Storage.
-- [`examples/demos/trip_team/`](examples/demos/trip_team) — same multi-agent shape on a Tokyo travel corpus.
-
 ## Repo layout
 
 ```text

docs/concepts/idempotency.md

@@ -52,5 +52,5 @@ call and the body runs.
 ## Source and tutorials
 
 - `src/locus/tools/decorator.py` — the `@tool` decorator and idempotency hook.
-- Demo: [`examples/demos/po_approval/`](https://github.com/oracle-samples/locus/tree/main/examples/demos/po_approval)
-  shows idempotent `submit_po` and `email_cfo` deduping under retries.
+- Tutorial: [`tutorial_03_tools_and_state.py`](https://github.com/oracle-samples/locus/blob/main/examples/tutorial_03_tools_and_state.py)
+  walks through `@tool(idempotent=True)` end-to-end.

docs/how-to/quickstart.md

@@ -198,9 +198,9 @@ anywhere FastAPI runs — see [Deploy](deploy.md).
 
 - **Read deeper.** [Agent Loop](../concepts/agent-loop.md) is the
   architectural reference for how all of this fits together.
-- **Browse examples.** Thirty-seven progressive tutorials at
-  [`examples/`](https://github.com/oracle-samples/locus/tree/main/examples)
-  and three end-to-end demos under
-  [`examples/demos/`](https://github.com/oracle-samples/locus/tree/main/examples/demos).
+- **Browse examples.** Forty progressive tutorials at
+  [`examples/`](https://github.com/oracle-samples/locus/tree/main/examples).
+  Each is a single runnable file that adds one idea on top of the
+  previous.
 - **Steer it.** [Hooks](../concepts/hooks.md) give you logging,
   telemetry, retry, guardrails, and steering as one-line additions.

docs/index.md

@@ -311,8 +311,9 @@ charges once. The agent stops.
 
 A three-agent vendor PO approval workflow against a live Oracle 26ai
 catalogue — Procurement and Compliance debate, hand off to an Approval
-Officer, the human approves, idempotent writes fire — is in
-[`examples/demos/po_approval/`](https://github.com/oracle-samples/locus/tree/main/examples/demos/po_approval).
+Officer, the human approves, idempotent writes fire — runs end-to-end
+in the multi-agent and idempotency tutorials under
+[`examples/`](https://github.com/oracle-samples/locus/tree/main/examples).
 
 ## Introspect
 
@@ -351,8 +352,8 @@ Read the [concepts](concepts/agent.md) for the *why*; read the
 ## Learn locus in an afternoon
 
 The [`examples/`](https://github.com/oracle-samples/locus/tree/main/examples)
-tree is **40 tutorials** plus **3 end-to-end demos**. Every tutorial
-is one runnable file and adds exactly one idea on top of the previous.
+tree is **40 progressive tutorials**. Every tutorial is one runnable
+file and adds exactly one idea on top of the previous.
 
 ### Track 1 — basics (first hour)
 
@@ -414,14 +415,6 @@ The six in-process patterns plus A2A:
 [GSAR typed grounding](https://github.com/oracle-samples/locus/blob/main/examples/tutorial_39_gsar_typed_grounding.py) ·
 [OCI Dedicated AI Cluster (DAC)](https://github.com/oracle-samples/locus/blob/main/examples/tutorial_40_oci_dac.py).
 
-### End-to-end demos
-
-| Demo | What it shows |
-|---|---|
-| [`po_approval/`](https://github.com/oracle-samples/locus/tree/main/examples/demos/po_approval) | Three agents (Procurement / Compliance / Approval Officer) debate a vendor PO against a live Oracle 26ai catalogue. Idempotent writes. Human consent gate. |
-| [`oracle_26ai/`](https://github.com/oracle-samples/locus/tree/main/examples/demos/oracle_26ai) | Full Oracle stack — OCI GenAI + Oracle 26ai vectors + skills + Reflexion + idempotent submit + checkpoints to OCI Object Storage. |
-| [`trip_team/`](https://github.com/oracle-samples/locus/tree/main/examples/demos/trip_team) | Same multi-agent shape on a Tokyo travel corpus — three personas, one orchestrator, one durable thread. |
-
 ## Then deploy
 
 When the agent is ready, ship it. `AgentServer` is a drop-in FastAPI