sqlite

Documentation

Overview

Package sqlite provides the official local SQLite adapter for agent.Store. It owns one dedicated database and its cross-process ownership lock until the returned framework.Resource is released.

Index

• Variables
• func Open(ctx context.Context, config Config) (framework.Resource[agent.Store], error)
• type Config

Variables

var ErrDatabaseInUse = errors.New("agent/sqlite: database is already in use")

ErrDatabaseInUse means another live resource owns the same SQLite file.

var ErrUnsupportedSchema = errors.New("unsupported HumanAgent sqlite schema; use a dedicated database")

ErrUnsupportedSchema reports a non-empty database that does not carry the exact clean-break HumanAgent schema identity required by this adapter.

Functions

func Open

func Open(ctx context.Context, config Config) (framework.Resource[agent.Store], error)

Open constructs an owned SQLite Store resource. The returned Resource must either be passed to an Agent as owned configuration or released explicitly. ctx bounds construction only and is not retained.

Types

type Config

type Config struct {
	Path string
}

Config selects one dedicated HumanAgent SQLite persistence identity. Path may be an ordinary filesystem path or an independent :memory: database. Shared-memory SQLite DSNs are rejected because they cannot provide the adapter's single-owner lifecycle guarantee.