Repository navigation
Commit f084853
committed
feat: add FirestoreSessionService for serverless session persistence
Adds a BaseSessionService implementation backed by Google Cloud
Firestore, providing persistent, serverless session storage suitable
for Cloud Run, Cloud Functions, and other GCP environments.
Key design decisions:
- Events stored in Firestore subcollections to avoid 1MB doc limit
- Three-tier state management (app/user/session) matching ADK conventions
- Atomic state updates via Firestore transactions (race-condition safe)
- Batch writes for bulk event deletion (500-doc chunks)
- Server-side query limits via limit_to_last() for num_recent_events
- google-cloud-firestore as an optional dependency
Includes 19 unit tests with a lightweight in-memory Firestore mock.
Fixes google#103
Ref: google/adk-python#3776, google/adk-python#44391 parent 0d10dd9 commit f084853
4 files changed
Lines changed: 975 additions & 1 deletion
File tree
- src/google/adk_community/sessions
- tests/unittests/sessions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
41 | 41 | | |
42 | 42 | | |
43 | 43 | | |
| 44 | + | |
| 45 | + | |
| 46 | + | |
44 | 47 | | |
45 | 48 | | |
46 | 49 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
14 | 14 | | |
15 | 15 | | |
16 | 16 | | |
| 17 | + | |
17 | 18 | | |
18 | 19 | | |
19 | | - | |
| 20 | + | |
0 commit comments