From 1d85aedcaecd1b1043f8efc07ba60eb0e49ebdae Mon Sep 17 00:00:00 2001
From: Mark Backman <mark@daily.co>
Date: Tue, 31 Mar 2026 13:15:06 -0400
Subject: [PATCH] Split features/ into audio/, observability/, and rag/
 subfolders

Extract focused example groups from the catch-all features/ folder:
- audio/: audio recording, background sound, sound effects
- observability/: observer, heartbeats, sentry metrics
- rag/: mem0, gemini-rag, gemini grounding metadata

Update README to document the new folders.
---
 examples/README.md                                 | 14 +++++++++++++-
 examples/{features => audio}/audio-recording.py    |  0
 .../{features => audio}/bot-background-sound.py    |  0
 examples/{features => audio}/sound-effects.py      |  0
 examples/{features => observability}/heartbeats.py |  0
 examples/{features => observability}/observer.py   |  0
 .../{features => observability}/sentry-metrics.py  |  0
 .../{features => rag}/gemini-grounding-metadata.py |  0
 examples/{features => rag}/gemini-rag.py           |  0
 examples/{features => rag}/mem0.py                 |  0
 10 files changed, 13 insertions(+), 1 deletion(-)
 rename examples/{features => audio}/audio-recording.py (100%)
 rename examples/{features => audio}/bot-background-sound.py (100%)
 rename examples/{features => audio}/sound-effects.py (100%)
 rename examples/{features => observability}/heartbeats.py (100%)
 rename examples/{features => observability}/observer.py (100%)
 rename examples/{features => observability}/sentry-metrics.py (100%)
 rename examples/{features => rag}/gemini-grounding-metadata.py (100%)
 rename examples/{features => rag}/gemini-rag.py (100%)
 rename examples/{features => rag}/mem0.py (100%)

diff --git a/examples/README.md b/examples/README.md
index f584d3768..08dc58de5 100644
--- a/examples/README.md
+++ b/examples/README.md
@@ -116,9 +116,21 @@ Video avatar integrations (Tavus, HeyGen, Simli, LemonSlice).
 
 Video processing, mirroring, GStreamer, and custom video tracks.
 
+### [`audio/`](./audio/)
+
+Audio recording, background sounds, and sound effects.
+
+### [`observability/`](./observability/)
+
+Pipeline monitoring: observers, heartbeats, and Sentry metrics.
+
+### [`rag/`](./rag/)
+
+Retrieval-augmented generation, grounding, and long-term memory (Mem0, Gemini).
+
 ### [`features/`](./features/)
 
-Miscellaneous features: sound effects, wake phrases, observers, audio recording, live translation, service switching, and more.
+Miscellaneous features: wake phrases, live translation, service switching, voice switching, and more.
 
 ## Advanced Usage
 
diff --git a/examples/features/audio-recording.py b/examples/audio/audio-recording.py
similarity index 100%
rename from examples/features/audio-recording.py
rename to examples/audio/audio-recording.py
diff --git a/examples/features/bot-background-sound.py b/examples/audio/bot-background-sound.py
similarity index 100%
rename from examples/features/bot-background-sound.py
rename to examples/audio/bot-background-sound.py
diff --git a/examples/features/sound-effects.py b/examples/audio/sound-effects.py
similarity index 100%
rename from examples/features/sound-effects.py
rename to examples/audio/sound-effects.py
diff --git a/examples/features/heartbeats.py b/examples/observability/heartbeats.py
similarity index 100%
rename from examples/features/heartbeats.py
rename to examples/observability/heartbeats.py
diff --git a/examples/features/observer.py b/examples/observability/observer.py
similarity index 100%
rename from examples/features/observer.py
rename to examples/observability/observer.py
diff --git a/examples/features/sentry-metrics.py b/examples/observability/sentry-metrics.py
similarity index 100%
rename from examples/features/sentry-metrics.py
rename to examples/observability/sentry-metrics.py
diff --git a/examples/features/gemini-grounding-metadata.py b/examples/rag/gemini-grounding-metadata.py
similarity index 100%
rename from examples/features/gemini-grounding-metadata.py
rename to examples/rag/gemini-grounding-metadata.py
diff --git a/examples/features/gemini-rag.py b/examples/rag/gemini-rag.py
similarity index 100%
rename from examples/features/gemini-rag.py
rename to examples/rag/gemini-rag.py
diff --git a/examples/features/mem0.py b/examples/rag/mem0.py
similarity index 100%
rename from examples/features/mem0.py
rename to examples/rag/mem0.py