@amodalai/runtime 0.1.26 → 0.2.0

package/dist/src/stores/pglite-store-backend.js

@@ -3,279 +3,125 @@
  * Copyright 2025 Amodal Labs, Inc.
  * SPDX-License-Identifier: MIT
  */
-import { resolveTtl } from './ttl-resolver.js';
-import { log } from '../logger.js';
 /**
  * PGLite-backed store backend.
  *
- * Uses in-process WASM Postgres via @electric-sql/pglite.
- * Data is stored in a configurable directory (default: .amodal/store-data/).
+ * Uses in-process WASM Postgres via @electric-sql/pglite + Drizzle ORM.
+ * Data is stored in a configurable directory (default: in-memory).
  *
- * All writes are serialized through a queue to prevent concurrent access
- * issues with PGLite's single-threaded WASM engine.
+ * This file is a thin factory over DrizzleStoreBackend — it constructs
+ * the PGLite client, runs DDL, wraps it in drizzle(), and hands off all
+ * query logic to the shared backend.
  */
+import { drizzle } from 'drizzle-orm/pglite';
+import { DrizzleStoreBackend } from './drizzle-store-backend.js';
+import { StoreError } from '../errors.js';
+import { log as defaultLogger } from '../logger.js';
+const CREATE_TABLES_DDL = `
+  CREATE TABLE IF NOT EXISTS store_documents (
+    app_id TEXT NOT NULL,
+    store TEXT NOT NULL,
+    key TEXT NOT NULL,
+    version INTEGER NOT NULL DEFAULT 1,
+    payload JSONB NOT NULL,
+    meta JSONB NOT NULL,
+    expires_at TIMESTAMPTZ,
+    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    PRIMARY KEY (app_id, store, key)
+  );
+
+  CREATE INDEX IF NOT EXISTS idx_store_documents_store
+    ON store_documents (app_id, store);
+
+  CREATE INDEX IF NOT EXISTS idx_store_documents_expires
+    ON store_documents (expires_at)
+    WHERE expires_at IS NOT NULL;
+
+  CREATE TABLE IF NOT EXISTS store_document_versions (
+    id SERIAL PRIMARY KEY,
+    app_id TEXT NOT NULL,
+    store TEXT NOT NULL,
+    key TEXT NOT NULL,
+    version INTEGER NOT NULL,
+    payload JSONB NOT NULL,
+    meta JSONB NOT NULL,
+    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+  );
+
+  CREATE INDEX IF NOT EXISTS idx_store_versions_lookup
+    ON store_document_versions (app_id, store, key, version DESC);
+`;
 export class PGLiteStoreBackend {
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    db = null;
     dataDir;
-    stores = new Map();
-    writeQueue = Promise.resolve();
-    constructor(dataDir) {
-        this.dataDir = dataDir;
-    }
-    /**
-     * Serialize a write operation through the queue.
-     * Ensures PGLite only processes one write at a time.
-     */
-    enqueue(fn) {
-        const task = this.writeQueue.then(fn, fn);
-        this.writeQueue = task.then(() => { }, () => { });
-        return task;
+    logger;
+    inner = null;
+    constructor(dataDirOrOpts) {
+        const opts = typeof dataDirOrOpts === 'string' || dataDirOrOpts === undefined
+            ? { dataDir: dataDirOrOpts }
+            : dataDirOrOpts;
+        this.dataDir = opts.dataDir;
+        this.logger = opts.logger ?? defaultLogger;
     }
     async initialize(stores) {
+        if (this.inner)
+            return;
         if (this.dataDir) {
             const { mkdirSync } = await import('node:fs');
             mkdirSync(this.dataDir, { recursive: true });
         }
         const { PGlite } = await import('@electric-sql/pglite');
-        this.db = new PGlite(this.dataDir ?? undefined);
-        for (const store of stores) {
-            this.stores.set(store.name, store);
-        }
-        await this.db.exec(`
-      CREATE TABLE IF NOT EXISTS store_documents (
-        app_id TEXT NOT NULL,
-        store TEXT NOT NULL,
-        key TEXT NOT NULL,
-        version INTEGER NOT NULL DEFAULT 1,
-        payload JSONB NOT NULL,
-        meta JSONB NOT NULL,
-        expires_at TIMESTAMPTZ,
-        created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
-        updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
-        PRIMARY KEY (app_id, store, key)
-      );
-
-      CREATE INDEX IF NOT EXISTS idx_store_documents_store
-        ON store_documents (app_id, store);
-
-      CREATE INDEX IF NOT EXISTS idx_store_documents_expires
-        ON store_documents (expires_at)
-        WHERE expires_at IS NOT NULL;
-
-      CREATE TABLE IF NOT EXISTS store_document_versions (
-        id SERIAL PRIMARY KEY,
-        app_id TEXT NOT NULL,
-        store TEXT NOT NULL,
-        key TEXT NOT NULL,
-        version INTEGER NOT NULL,
-        payload JSONB NOT NULL,
-        meta JSONB NOT NULL,
-        created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
-      );
-
-      CREATE INDEX IF NOT EXISTS idx_store_versions_lookup
-        ON store_document_versions (app_id, store, key, version DESC);
-    `);
+        const pglite = new PGlite(this.dataDir ?? undefined);
+        await pglite.exec(CREATE_TABLES_DDL);
+        const db = drizzle(pglite);
+        this.inner = new DrizzleStoreBackend({
+            db,
+            stores,
+            logger: this.logger,
+            onClose: async () => {
+                await pglite.close();
+            },
+        });
     }
-    ensureDb() {
-        if (!this.db) {
-            throw new Error('PGLite store backend is not initialized or was closed');
+    ensure() {
+        if (!this.inner) {
+            throw new StoreError('PGLite store backend is not initialized or was closed', {
+                store: '(uninitialized)',
+                operation: 'ensure',
+            });
         }
+        return this.inner;
     }
     async get(appId, store, key) {
-        this.ensureDb();
-        try {
-            const result = await this.db.query(`SELECT key, app_id, store, version, payload, meta, expires_at
-         FROM store_documents
-         WHERE app_id = $1 AND store = $2 AND key = $3`, [appId, store, key]);
-            if (result.rows.length === 0)
-                return null;
-            return this.rowToDocument(result.rows[0]);
-        }
-        catch (err) {
-            log.error(`get error: ${err instanceof Error ? err.message : String(err)}`, 'store');
-            return null;
-        }
+        return this.ensure().get(appId, store, key);
     }
     async put(appId, store, key, payload, meta) {
-        this.ensureDb();
-        return this.enqueue(async () => {
-            const storeConfig = this.stores.get(store);
-            const ttlSeconds = resolveTtl(storeConfig?.ttl, payload);
-            const maxVersions = storeConfig?.history?.versions;
-            const fullMeta = {
-                computedAt: new Date().toISOString(),
-                stale: false,
-                ...meta,
-                ttl: ttlSeconds,
-            };
-            const expiresAt = ttlSeconds
-                ? new Date(Date.now() + ttlSeconds * 1000).toISOString()
-                : null;
-            try {
-                // Use upsert to avoid read-then-write race
-                const existing = await this.db.query(`SELECT version, payload, meta FROM store_documents
-           WHERE app_id = $1 AND store = $2 AND key = $3`, [appId, store, key]);
-                if (existing.rows.length > 0) {
-                    const oldVersion = Number(existing.rows[0].version);
-                    const newVersion = oldVersion + 1;
-                    if (maxVersions && maxVersions > 0) {
-                        await this.db.query(`INSERT INTO store_document_versions (app_id, store, key, version, payload, meta)
-               VALUES ($1, $2, $3, $4, $5, $6)`, [appId, store, key, oldVersion, JSON.stringify(existing.rows[0].payload), JSON.stringify(existing.rows[0].meta)]);
-                        await this.db.query(`DELETE FROM store_document_versions
-               WHERE app_id = $1 AND store = $2 AND key = $3
-                 AND version <= (
-                   SELECT COALESCE(MAX(version), 0) - $4
-                   FROM store_document_versions
-                   WHERE app_id = $1 AND store = $2 AND key = $3
-                 )`, [appId, store, key, maxVersions]);
-                    }
-                    await this.db.query(`UPDATE store_documents
-             SET version = $4, payload = $5, meta = $6, expires_at = $7, updated_at = NOW()
-             WHERE app_id = $1 AND store = $2 AND key = $3`, [appId, store, key, newVersion, JSON.stringify(payload), JSON.stringify(fullMeta), expiresAt]);
-                    return { stored: true, key, version: newVersion, previousVersion: oldVersion };
-                }
-                await this.db.query(`INSERT INTO store_documents (app_id, store, key, version, payload, meta, expires_at)
-           VALUES ($1, $2, $3, 1, $4, $5, $6)`, [appId, store, key, JSON.stringify(payload), JSON.stringify(fullMeta), expiresAt]);
-                return { stored: true, key, version: 1 };
-            }
-            catch (err) {
-                log.error(`put error (${store}/${key}): ${err instanceof Error ? err.message : String(err)}`, 'store');
-                return { stored: false, key, version: 0 };
-            }
-        });
+        return this.ensure().put(appId, store, key, payload, meta);
     }
-    async list(appId, store, options = {}) {
-        this.ensureDb();
-        const { filter, sort, limit = 100, offset = 0, includeStale = false } = options;
-        try {
-            let where = 'WHERE app_id = $1 AND store = $2';
-            const params = [appId, store];
-            let paramIndex = 3;
-            if (!includeStale) {
-                where += ` AND (expires_at IS NULL OR expires_at > NOW())`;
-            }
-            if (filter) {
-                for (const [field, value] of Object.entries(filter)) {
-                    if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(field)) {
-                        throw new Error(`Invalid store filter field name: ${field}`);
-                    }
-                    where += ` AND payload->>'${field}' = $${paramIndex}`;
-                    params.push(String(value));
-                    paramIndex++;
-                }
-            }
-            const countResult = await this.db.query(`SELECT COUNT(*)::int AS total FROM store_documents ${where}`, params);
-            const total = Number(countResult.rows[0].total);
-            let orderBy = 'ORDER BY updated_at DESC';
-            if (sort) {
-                const desc = sort.startsWith('-');
-                const field = desc ? sort.slice(1) : sort;
-                if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(field)) {
-                    throw new Error(`Invalid store sort field name: ${field}`);
-                }
-                const dir = desc ? 'DESC' : 'ASC';
-                orderBy = `ORDER BY payload->>'${field}' ${dir}`;
-            }
-            const result = await this.db.query(`SELECT key, app_id, store, version, payload, meta, expires_at
-         FROM store_documents ${where} ${orderBy}
-         LIMIT $${paramIndex} OFFSET $${paramIndex + 1}`, [...params, limit, offset]);
-            const documents = result.rows.map((row) => this.rowToDocument(row));
-            return { documents, total, hasMore: offset + documents.length < total };
-        }
-        catch (err) {
-            log.error(`list error (${store}): ${err instanceof Error ? err.message : String(err)}`, 'store');
-            return { documents: [], total: 0, hasMore: false };
-        }
+    async list(appId, store, options) {
+        return this.ensure().list(appId, store, options);
     }
     async delete(appId, store, key) {
-        this.ensureDb();
-        return this.enqueue(async () => {
-            try {
-                await this.db.query(`DELETE FROM store_document_versions WHERE app_id = $1 AND store = $2 AND key = $3`, [appId, store, key]);
-                const result = await this.db.query(`DELETE FROM store_documents WHERE app_id = $1 AND store = $2 AND key = $3`, [appId, store, key]);
-                return (result.affectedRows ?? 0) > 0;
-            }
-            catch (err) {
-                log.error(`delete error (${store}/${key}): ${err instanceof Error ? err.message : String(err)}`, 'store');
-                return false;
-            }
-        });
+        return this.ensure().delete(appId, store, key);
     }
     async history(appId, store, key) {
-        this.ensureDb();
-        try {
-            const result = await this.db.query(`SELECT key, $1::text AS app_id, store, version, payload, meta
-         FROM store_document_versions
-         WHERE app_id = $1 AND store = $2 AND key = $3
-         ORDER BY version DESC`, [appId, store, key]);
-            return result.rows.map((row) => ({
-                key: String(row['key']),
-                appId: String(row['app_id']),
-                store: String(row['store']),
-                version: Number(row['version']),
-                // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
-                payload: (typeof row['payload'] === 'string' ? JSON.parse(row['payload']) : row['payload']),
-                // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
-                meta: (typeof row['meta'] === 'string' ? JSON.parse(row['meta']) : row['meta']),
-            }));
-        }
-        catch (err) {
-            log.error(`history error (${store}/${key}): ${err instanceof Error ? err.message : String(err)}`, 'store');
-            return [];
-        }
+        return this.ensure().history(appId, store, key);
     }
     async purgeExpired(appId, store) {
-        this.ensureDb();
-        return this.enqueue(async () => {
-            try {
-                let query = `DELETE FROM store_documents WHERE app_id = $1 AND expires_at IS NOT NULL AND expires_at <= NOW()`;
-                const params = [appId];
-                if (store) {
-                    query += ` AND store = $2`;
-                    params.push(store);
-                }
-                const result = await this.db.query(query, params);
-                return result.affectedRows ?? 0;
-            }
-            catch (err) {
-                log.error(`purgeExpired error: ${err instanceof Error ? err.message : String(err)}`, 'store');
-                return 0;
-            }
-        });
+        return this.ensure().purgeExpired(appId, store);
     }
     async close() {
-        if (this.db) {
-            try {
-                await this.db.close();
-            }
-            catch { /* best effort */ }
-            this.db = null;
-        }
-    }
-    rowToDocument(row) {
-        const expiresAt = row['expires_at'];
-        const isStale = expiresAt ? new Date(String(expiresAt)) <= new Date() : false;
-        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
-        const meta = (typeof row['meta'] === 'string' ? JSON.parse(row['meta']) : row['meta']);
-        meta.stale = isStale;
-        return {
-            key: String(row['key']),
-            appId: String(row['app_id']),
-            store: String(row['store']),
-            version: Number(row['version']),
-            // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
-            payload: (typeof row['payload'] === 'string' ? JSON.parse(row['payload']) : row['payload']),
-            meta,
-        };
+        if (!this.inner)
+            return;
+        await this.inner.close();
+        this.inner = null;
     }
 }
 /**
  * Create a PGLite store backend.
  */
-export async function createPGLiteStoreBackend(stores, dataDir) {
-    const backend = new PGLiteStoreBackend(dataDir);
+export async function createPGLiteStoreBackend(stores, dataDirOrOpts) {
+    const backend = new PGLiteStoreBackend(dataDirOrOpts);
     await backend.initialize(stores);
     return backend;
 }

package/dist/src/stores/pglite-store-backend.js.map

@@ -1 +1 @@
-{"version":3,"file":"pglite-store-backend.js","sourceRoot":"","sources":["../../../src/stores/pglite-store-backend.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"pglite-store-backend.js","sourceRoot":"","sources":["../../../src/stores/pglite-store-backend.ts"],"names":[],"mappings":"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"}

package/dist/src/stores/postgres-store-backend.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { LoadedStore } from '@amodalai/core';
+import { DrizzleStoreBackend } from './drizzle-store-backend.js';
+import type { Logger } from '../logger.js';
+export interface PostgresStoreBackendOptions {
+    /** Postgres connection string, e.g. `postgres://user:pass@host:5432/db`. */
+    connectionString: string;
+    /** Pool size (default 10). */
+    max?: number;
+    /** Per-statement timeout in ms (default 30_000). */
+    statementTimeoutMs?: number;
+    /** Logger. Defaults to the runtime's global logger. */
+    logger?: Logger;
+}
+/**
+ * Create a Postgres store backend.
+ *
+ * Opens a connection pool with `statement_timeout` set so hung queries
+ * can't block the write queue, runs idempotent DDL, and returns a
+ * DrizzleStoreBackend wired to the pool. The returned backend's
+ * `close()` will drain and end the pool.
+ *
+ * Accepts either a connection string (shorthand) or a full options
+ * object — matches `createPGLiteStoreBackend`'s call-site ergonomics.
+ */
+export declare function createPostgresStoreBackend(stores: LoadedStore[], optsOrUrl: PostgresStoreBackendOptions | string): Promise<DrizzleStoreBackend>;

package/dist/src/stores/postgres-store-backend.js

@@ -0,0 +1,100 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Postgres-backed store backend for the hosted runtime.
+ *
+ * Thin factory over DrizzleStoreBackend using drizzle-orm/node-postgres.
+ * Shares all query logic and DDL with the PGLite backend via the
+ * `stores/schema.ts` Drizzle schema.
+ *
+ * Tables are created in the connection's default schema (typically
+ * `public`). Callers who need isolation should use a dedicated database
+ * per tenant/environment rather than schema namespacing — that avoids
+ * the search_path / connection-pool interaction hazards that
+ * schema-scoping introduces.
+ */
+import { drizzle } from 'drizzle-orm/node-postgres';
+import { DrizzleStoreBackend } from './drizzle-store-backend.js';
+import { log as defaultLogger } from '../logger.js';
+// Default per-statement timeout. Protects against hung queries blocking
+// the write queue — satisfies the CLAUDE.md "External calls (fetch,
+// database, MCP) without AbortSignal.timeout()" rule at the pool level.
+const DEFAULT_STATEMENT_TIMEOUT_MS = 30_000;
+const CREATE_TABLES_DDL = `
+  CREATE TABLE IF NOT EXISTS store_documents (
+    app_id TEXT NOT NULL,
+    store TEXT NOT NULL,
+    key TEXT NOT NULL,
+    version INTEGER NOT NULL DEFAULT 1,
+    payload JSONB NOT NULL,
+    meta JSONB NOT NULL,
+    expires_at TIMESTAMPTZ,
+    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    PRIMARY KEY (app_id, store, key)
+  );
+
+  CREATE INDEX IF NOT EXISTS idx_store_documents_store
+    ON store_documents (app_id, store);
+
+  CREATE INDEX IF NOT EXISTS idx_store_documents_expires
+    ON store_documents (expires_at)
+    WHERE expires_at IS NOT NULL;
+
+  CREATE TABLE IF NOT EXISTS store_document_versions (
+    id SERIAL PRIMARY KEY,
+    app_id TEXT NOT NULL,
+    store TEXT NOT NULL,
+    key TEXT NOT NULL,
+    version INTEGER NOT NULL,
+    payload JSONB NOT NULL,
+    meta JSONB NOT NULL,
+    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+  );
+
+  CREATE INDEX IF NOT EXISTS idx_store_versions_lookup
+    ON store_document_versions (app_id, store, key, version DESC);
+`;
+/**
+ * Create a Postgres store backend.
+ *
+ * Opens a connection pool with `statement_timeout` set so hung queries
+ * can't block the write queue, runs idempotent DDL, and returns a
+ * DrizzleStoreBackend wired to the pool. The returned backend's
+ * `close()` will drain and end the pool.
+ *
+ * Accepts either a connection string (shorthand) or a full options
+ * object — matches `createPGLiteStoreBackend`'s call-site ergonomics.
+ */
+export async function createPostgresStoreBackend(stores, optsOrUrl) {
+    const opts = typeof optsOrUrl === 'string' ? { connectionString: optsOrUrl } : optsOrUrl;
+    const logger = opts.logger ?? defaultLogger;
+    // Dynamic import so `pg` stays an optional peer at the package level —
+    // PGLite users don't need it installed.
+    const pg = await import('pg');
+    const { Pool } = pg.default ?? pg;
+    const pool = new Pool({
+        connectionString: opts.connectionString,
+        max: opts.max ?? 10,
+        statement_timeout: opts.statementTimeoutMs ?? DEFAULT_STATEMENT_TIMEOUT_MS,
+    });
+    await pool.query(CREATE_TABLES_DDL);
+    const db = drizzle(pool);
+    logger.info('postgres_store_backend_ready', {
+        max: opts.max ?? 10,
+        statementTimeoutMs: opts.statementTimeoutMs ?? DEFAULT_STATEMENT_TIMEOUT_MS,
+        storeCount: stores.length,
+    });
+    return new DrizzleStoreBackend({
+        db,
+        stores,
+        logger,
+        onClose: async () => {
+            await pool.end();
+        },
+    });
+}
+//# sourceMappingURL=postgres-store-backend.js.map

package/dist/src/stores/postgres-store-backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-store-backend.js","sourceRoot":"","sources":["../../../src/stores/postgres-store-backend.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAC,OAAO,EAAC,MAAM,2BAA2B,CAAC;AAGlD,OAAO,EAAC,mBAAmB,EAAC,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAC,GAAG,IAAI,aAAa,EAAC,MAAM,cAAc,CAAC;AAGlD,wEAAwE;AACxE,oEAAoE;AACpE,wEAAwE;AACxE,MAAM,4BAA4B,GAAG,MAAM,CAAC;AAE5C,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkCzB,CAAC;AAaF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,MAAqB,EACrB,SAA+C;IAE/C,MAAM,IAAI,GACR,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAC,gBAAgB,EAAE,SAAS,EAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAE5E,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,aAAa,CAAC;IAE5C,uEAAuE;IACvE,wCAAwC;IACxC,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;IAC9B,MAAM,EAAC,IAAI,EAAC,GAAG,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC;IAEhC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC;QACpB,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;QACvC,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,EAAE;QACnB,iBAAiB,EAAE,IAAI,CAAC,kBAAkB,IAAI,4BAA4B;KAC3E,CAAC,CAAC;IAEH,MAAM,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAEpC,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB,MAAM,CAAC,IAAI,CAAC,8BAA8B,EAAE;QAC1C,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,EAAE;QACnB,kBAAkB,EAAE,IAAI,CAAC,kBAAkB,IAAI,4BAA4B;QAC3E,UAAU,EAAE,MAAM,CAAC,MAAM;KAC1B,CAAC,CAAC;IAEH,OAAO,IAAI,mBAAmB,CAAC;QAC7B,EAAE;QACF,MAAM;QACN,MAAM;QACN,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC;QACnB,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}