awaken-stores 0.6.0

Storage backends (memory, file, PostgreSQL, SQLite mailbox) for Awaken agent state
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87

//! PostgreSQL schema for the published versioned registry store.

use awaken_server_contract::contract::storage::StorageError;

use crate::postgres::PostgresStore;
use crate::postgres_versioned_registry::RegistryTables;

pub(crate) async fn ensure_versioned_registry_schema(
    store: &PostgresStore,
) -> Result<(), StorageError> {
    let tables = RegistryTables::from_store(store);
    let statements = vec![
        format!(
            "CREATE TABLE IF NOT EXISTS {} (
                scope_id TEXT NOT NULL DEFAULT 'default',
                kind TEXT NOT NULL,
                id TEXT NOT NULL,
                current_version BIGINT CHECK (current_version IS NULL OR current_version > 0),
                archived_at_ms BIGINT CHECK (archived_at_ms IS NULL OR archived_at_ms >= 0),
                created_at_ms BIGINT NOT NULL CHECK (created_at_ms >= 0),
                updated_at_ms BIGINT NOT NULL CHECK (updated_at_ms >= 0),
                metadata_json JSONB NOT NULL DEFAULT '{{}}',
                PRIMARY KEY (scope_id, kind, id)
            )",
            tables.resources
        ),
        format!(
            "CREATE TABLE IF NOT EXISTS {} (
                scope_id TEXT NOT NULL DEFAULT 'default',
                kind TEXT NOT NULL,
                id TEXT NOT NULL,
                version BIGINT NOT NULL CHECK (version > 0),
                content_hash TEXT NOT NULL,
                value_schema_version INTEGER NOT NULL,
                canonical_value_json TEXT NOT NULL,
                value_json JSONB NOT NULL,
                metadata_json JSONB NOT NULL DEFAULT '{{}}',
                created_at_ms BIGINT NOT NULL CHECK (created_at_ms >= 0),
                PRIMARY KEY (scope_id, kind, id, version)
            )",
            tables.versions
        ),
        format!(
            "CREATE INDEX IF NOT EXISTS idx_{}_hash
             ON {} (scope_id, kind, id, content_hash)",
            tables.versions, tables.versions
        ),
        format!(
            "CREATE TABLE IF NOT EXISTS {} (
                scope_id TEXT NOT NULL DEFAULT 'default',
                snapshot_version BIGINT NOT NULL CHECK (snapshot_version > 0),
                publication_id TEXT NOT NULL,
                source_config_revisions_json JSONB NOT NULL DEFAULT '[]',
                created_by TEXT,
                metadata_json JSONB NOT NULL DEFAULT '{{}}',
                created_at_ms BIGINT NOT NULL CHECK (created_at_ms >= 0),
                PRIMARY KEY (scope_id, snapshot_version),
                UNIQUE (scope_id, publication_id)
            )",
            tables.publications
        ),
        format!(
            "CREATE TABLE IF NOT EXISTS {} (
                scope_id TEXT NOT NULL DEFAULT 'default',
                snapshot_version BIGINT NOT NULL CHECK (snapshot_version > 0),
                kind TEXT NOT NULL,
                id TEXT NOT NULL,
                version BIGINT NOT NULL CHECK (version > 0),
                content_hash TEXT NOT NULL,
                PRIMARY KEY (scope_id, snapshot_version, kind, id),
                FOREIGN KEY (scope_id, snapshot_version)
                    REFERENCES {} (scope_id, snapshot_version),
                FOREIGN KEY (scope_id, kind, id, version)
                    REFERENCES {} (scope_id, kind, id, version)
            )",
            tables.publication_entries, tables.publications, tables.versions
        ),
    ];

    for stmt in statements {
        sqlx::query(&stmt)
            .execute(&store.pool)
            .await
            .map_err(|error| StorageError::Io(error.to_string()))?;
    }
    Ok(())
}