Google ADK Extension

SQLSpec provides SQL-backed persistence for Google Agent Development Kit, covering session, event, and memory storage across 15 backend packages. The artifact service contracts are available for deployments that provide a concrete artifact metadata store.

Key capabilities:

  • Session and event storage with atomic append_event_and_update_state() ensuring events and state are always consistent.

  • Full-event JSON storage (EventRecord) that captures the entire ADK Event in a single column, eliminating schema drift with upstream ADK releases.

  • Scoped state semantics (app:, user:, temp:) for controlling state visibility and persistence across sessions.

  • Memory service with database-native full-text search (tsvector, FTS5, InnoDB FT) for long-term agent context.

  • Artifact service contracts for append-only versioning, SQL metadata, and pluggable object storage backends.

Choose a guide

Installation

Install the extension and configure the service.

Installation
Quickstart

Persist sessions and memory with minimal setup.

Quickstart
Support Matrix

See which backends are recommended, supported, or reduced-scope.

Backends
Adapters

Configure supported SQLSpec adapters for ADK.

Adapters
Schema

Table layouts, EventRecord, scoped state, and artifact metadata.

Schema
API Reference

Services, stores, and record types.

API
Migrations

Apply schema changes safely over time.

Migrations