feat(adk): overhaul ADK backend to align with v1.0.0 store (#400)

## Summary

Improved ADK integration based on upstream improvements since initial implementation.

- **Full-event JSON storage**: Replace 17-column decomposed `EventRecord` with 5-column model (`session_id`, `invocation_id`, `author`, `timestamp`, `event_json`). Eliminates column drift with upstream ADK — new Event fields are captured automatically without schema changes.
- **State persistence fix**: `append_event()` now persists session state atomically with the event via `append_event_and_update_state()`. Previously, state mutations from `event.actions.state_delta` were lost on reload.
- **Scoped state**: `temp:` keys stripped before persistence, `app:`/`user:` split/merge helpers for future cross-session state sharing.
- **Unified async contract**: All stores (including previously sync-only DuckDB, ADBC, pymysql, Oracle sync, Spanner, psycopg sync, mysqlconnector sync) now extend `BaseAsyncADKStore` and wrap sync operations via `sqlspec.utils.sync_tools.async_()`.
- **Artifact service**: New `SQLSpecArtifactService` composing SQL metadata tables with `sqlspec/storage/` content backends (S3, GCS, Azure, local filesystem).
- **BigQuery removed**: Correctness bugs (JSON_VALUE flattening, unsafe bytes encoding) and architectural mismatch (high latency, eventual consistency, per-query cost) confirmed removal.
- **CockroachDB upgraded**: GIN indexes and native tsvector FTS restored (incorrectly stripped in prior code).
- **Memory service expanded**: `add_events_to_memory()` and `add_memory()` implemented (ADK v1.25+ contract).
- **Capability config**: `ADKConfig` expanded with `fts_language`, `artifact_storage_uri`, `schema_version`, partitioning, retention, compression, and SQLite optimization sections.

Author: cofin

.github/workflows/ci.yml

@@ -108,7 +108,7 @@ jobs:
       - name: Test
         env:
           PYTHONFAULTHANDLER: "1"
-          PYTEST_ADDOPTS: "--max-worker-restart=0 -s"
+          PYTEST_ADDOPTS: "--max-worker-restart=0"
         run: timeout 900s uv run pytest -n 2 --dist=loadgroup
 
   # test-linux-freethreaded:

.gitignore

@@ -68,3 +68,4 @@ uv.toml
 .geminiignore
 .beads/
 tools/scripts/profiles/*.prof
+.agents/

docs/_tapes/migration_workflow.tape

@@ -28,31 +28,31 @@ Type "# Initialize the migration environment"
 Enter
 Sleep 500ms
 
-Type "sqlspec db init"
+Type "sqlspec init"
 Enter
 Sleep 3s
 
 Type "# Create a new migration"
 Enter
 Sleep 500ms
 
-Type 'sqlspec db create-migration -m "add users table"'
+Type 'sqlspec create-migration -m "add users table"'
 Enter
 Sleep 3s
 
 Type "# Apply the migration"
 Enter
 Sleep 500ms
 
-Type "sqlspec db upgrade"
+Type "sqlspec upgrade"
 Enter
 Sleep 3s
 
 Type "# Check current revision"
 Enter
 Sleep 500ms
 
-Type "sqlspec db show-current-revision"
+Type "sqlspec show-current-revision"
 Enter
 Sleep 3s
 

docs/extensions/adk/adapters.rst

@@ -10,11 +10,36 @@ Choosing an Adapter
 
 Use async adapters for best performance with ADK runners:
 
-- **PostgreSQL**: ``asyncpg`` (recommended), ``psycopg`` (async mode)
-- **SQLite**: ``aiosqlite``
-- **MySQL**: ``asyncmy``
+- **PostgreSQL** (recommended): ``asyncpg``, ``psycopg`` (async mode), ``psqlpy``
+- **CockroachDB**: ``cockroach_asyncpg``, ``cockroach_psycopg`` (full FTS support)
+- **MySQL/MariaDB**: ``asyncmy``
+- **SQLite**: ``aiosqlite`` (development and single-process)
+- **Oracle**: ``oracledb``
+- **DuckDB**: ``duckdb`` (analytics; reduced-scope for ADK)
+- **ADBC**: ``adbc`` (Arrow-native, driver-agnostic)
+- **Spanner**: ``spanner`` (Google Cloud, globally distributed)
 
-Sync adapters work but require wrapping with ``anyio`` for async ADK runners.
+Sync adapters (``psycopg`` sync mode, ``sqlite``, ``mysqlconnector``, ``pymysql``)
+work but require wrapping with ``anyio`` for async ADK runners.
+
+Each Adapter Provides
+=====================
+
+Every adapter with ADK support ships three store classes:
+
+- **Session store** (e.g., ``AsyncpgADKStore``) -- sessions and events.
+- **Memory store** (e.g., ``AsyncpgADKMemoryStore``) -- long-term memory with FTS.
+- **Artifact store** (e.g., ``AsyncpgADKArtifactStore``) -- artifact metadata.
+
+Import from the adapter's ``adk`` subpackage:
+
+.. code-block:: python
+
+   from sqlspec.adapters.asyncpg.adk import (
+       AsyncpgADKStore,
+       AsyncpgADKMemoryStore,
+       AsyncpgADKArtifactStore,
+   )
 
 Example
 =======
@@ -30,6 +55,6 @@ Example
 See Also
 ========
 
-- :doc:`backends` for the full adapter support matrix.
+- :doc:`backends` for the full support matrix and backend-specific notes.
 - :doc:`/usage/drivers_and_querying` for adapter configuration patterns.
 - :doc:`/reference/adapters` for the complete adapter API.

docs/extensions/adk/api.rst

@@ -19,8 +19,20 @@ Services
    :show-inheritance:
    :no-index:
 
-Base Stores
-===========
+.. autoclass:: sqlspec.extensions.adk.memory.SQLSpecSyncMemoryService
+   :members:
+   :undoc-members:
+   :show-inheritance:
+   :no-index:
+
+.. autoclass:: SQLSpecArtifactService
+   :members:
+   :undoc-members:
+   :show-inheritance:
+   :no-index:
+
+Session Stores
+==============
 
 .. autoclass:: BaseAsyncADKStore
    :members:
@@ -34,6 +46,9 @@ Base Stores
    :show-inheritance:
    :no-index:
 
+Memory Stores
+=============
+
 .. autoclass:: BaseAsyncADKMemoryStore
    :members:
    :undoc-members:
@@ -45,3 +60,57 @@ Base Stores
    :undoc-members:
    :show-inheritance:
    :no-index:
+
+Artifact Stores
+===============
+
+.. autoclass:: BaseAsyncADKArtifactStore
+   :members:
+   :undoc-members:
+   :show-inheritance:
+   :no-index:
+
+.. autoclass:: BaseSyncADKArtifactStore
+   :members:
+   :undoc-members:
+   :show-inheritance:
+   :no-index:
+
+Record Types
+============
+
+.. autoclass:: SessionRecord
+   :members:
+   :show-inheritance:
+   :no-index:
+
+.. autoclass:: EventRecord
+   :members:
+   :show-inheritance:
+   :no-index:
+
+.. autoclass:: MemoryRecord
+   :members:
+   :show-inheritance:
+   :no-index:
+
+.. autoclass:: ArtifactRecord
+   :members:
+   :show-inheritance:
+   :no-index:
+
+Configuration
+=============
+
+.. autoclass:: ADKConfig
+   :members:
+   :show-inheritance:
+   :no-index:
+
+Converters
+==========
+
+.. automodule:: sqlspec.extensions.adk.converters
+   :members:
+   :undoc-members:
+   :no-index: