Skip to content

Conversation

cofin
Copy link
Member

@cofin cofin commented Oct 6, 2025

Introduce a Google ADK session backend extension for SQLSpec. This enhances the framework's capabilities for managing sessions and events in applications using the Google Agent Development Kit.

cofin and others added 27 commits October 6, 2025 14:25
Add the 'litestar db migrations downgrade' command to quickstart.rst
to complete the CLI migration workflow documentation. This provides
users with the full set of essential migration commands:
- generate: Create new migrations
- upgrade: Apply migrations
- downgrade: Rollback migrations (NEW)

Addresses completeness requirement from PR #101 verification.
Updated ADK examples to follow current API patterns and CLAUDE.md standards:

**adk_basic_aiosqlite.py:**
- Fixed Session object attribute access (session.id instead of session['id'])
- Fixed delete_session() API to include required app_name and user_id parameters
- Fixed ListSessionsResponse access (.sessions property)

**adk_litestar_asyncpg.py:**
- Moved uvicorn import to module level (CLAUDE.md compliance)
- Removed nested import from main() function

**Verified (no changes needed):**
- adk_basic_asyncpg.py - Already compliant
- adk_multi_tenant.py - Already compliant
- adk_duckdb_user_fk.py - Already compliant (canonical owner_id_column example)

All examples now:
- Use correct owner_id_column naming (not deprecated user_fk_column)
- Use Session object attributes correctly (.id, .app_name, .user_id)
- Follow CLAUDE.md import standards (no nested imports)
- Pass Python syntax validation
- Follow current SQLSpecSessionService API

See ADK_EXAMPLES_VERIFICATION_REPORT.md for detailed verification.
- Change section titles from marketing style to neutral
  - 'Production-Ready' -> 'Production Features'
  - 'Developer-Friendly' -> 'Development Features'
  - 'Performance Optimized' -> 'Performance Features'
- Replace casual language with professional terminology
  - 'Blazing Fast' -> 'High Performance'
- Maintain consistent, technical, helpful tone throughout

These changes align documentation with professional technical writing
standards while preserving clarity and usefulness.
- Remove duplicate examples (mysql, duckdb, bigquery, sqlite sync)
- Keep asyncpg, aiosqlite, litestar integration, multi-tenant examples
- Update all documentation cross-references to removed examples
- Fix broken literalinclude and :doc: references
- Exclude STYLE_GUIDE.md and VOICE_AUDIT_REPORT.md from Sphinx build
@cofin cofin changed the title feat(adk): Implement Google Agent Dev Kit Session Store feat(adk): Implement Google ADK Session Backend Oct 8, 2025
@cofin cofin merged commit 1cfb6b8 into main Oct 8, 2025
15 checks passed
@cofin cofin deleted the adk-session branch October 8, 2025 03:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant