Skip to main content
agentscope-extensions-mysql provides full-stack JDBC-based distributed storage for teams with existing relational database infrastructure.

Dependency

Add your database driver separately (e.g. mysql-connector-j, postgresql).

One-Line Setup

Components Provided

1. MysqlAgentStateStore

Agent state persisted to a MySQL table.

2. JdbcStore (BaseStore)

Workspace filesystem KV storage with auto-detected dialect.
Supported dialects (auto-detected): MySQL, PostgreSQL, H2, SQLite.

3. JdbcSnapshotSpec

Sandbox snapshots as LONGBLOB in a database table.

4. JdbcSandboxExecutionGuard

Distributed lock via MySQL GET_LOCK() / RELEASE_LOCK().
Lock is tied to the JDBC connection — auto-released on connection close.

When to Use