@data-club/ai-hub-server 0.0.1

package/dist/db/schema.d.ts

@@ -0,0 +1,1902 @@
+/**
+ * Drizzle schema for the ai-hub server's SQLite database.
+ *
+ * One row per real-world entity. v1 has no tenant scoping — a deployment is
+ * one customer organization, every row belongs to that customer.
+ *
+ * The shapes here are the canonical source of truth: the migration runner
+ * (`migrate.ts`) builds tables off these definitions, and every handler reads
+ * and writes through Drizzle's typed query builder.
+ *
+ * Forward-compat seams (intentionally non-obvious — see §6.7 "Future
+ * direction"):
+ *
+ * - `user.password_hash` is **nullable**. v1 always populates it (local login is
+ *   the only flow that creates users). Future external IdPs leave it NULL.
+ * - `user.identity_source` defaults to `"local"`. v1 only ever writes
+ *   `"local"`; future external IdPs add values like `"oidc:bankxyz"`.
+ * - `agent.is_archived` and `session.is_archived` are soft-hide flags.
+ *   **Agents and sessions cannot be hard-deleted in v1** (§6.3.4 / §11) — the
+ *   FK on `session.agent_id` is therefore always satisfiable and orphan
+ *   sessions never happen.
+ *
+ * @see SPECIFICATIONS.md §11 — data model
+ * @see SPECIFICATIONS.md §6.7 — auth model + future IdPs
+ * @see SPECIFICATIONS.md §6.8 — persistence
+ */
+/**
+ * Every human in this deployment, including super admins. ai-hub owns auth.
+ *
+ * The PRD uses singular table names; we follow that exactly so SQL tooling
+ * matches what implementing agents see in the spec.
+ *
+ * @see SPECIFICATIONS.md §11
+ */
+export declare const user: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
+    name: "user";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "id";
+            tableName: "user";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        username: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "username";
+            tableName: "user";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        displayName: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "display_name";
+            tableName: "user";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        passwordHash: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "password_hash";
+            tableName: "user";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        identitySource: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "identity_source";
+            tableName: "user";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        isInitialPassword: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "is_initial_password";
+            tableName: "user";
+            dataType: "boolean";
+            columnType: "SQLiteBoolean";
+            data: boolean;
+            driverParam: number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        role: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "role";
+            tableName: "user";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: "user" | "power_user" | "admin" | "super_admin";
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["user", "power_user", "admin", "super_admin"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        themePreference: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "theme_preference";
+            tableName: "user";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: "light" | "dark";
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["light", "dark"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        passwordChangedAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "password_changed_at";
+            tableName: "user";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        createdAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "created_at";
+            tableName: "user";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        updatedAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "updated_at";
+            tableName: "user";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+    };
+    dialect: "sqlite";
+}>;
+/**
+ * `power_user`/`admin`/`super_admin`-curated catalog of ai-hub agents.
+ *
+ * Each row is a use-case (e.g. *Customer Support*) backed by exactly one Letta
+ * agent. Shared across every user in the deployment (§13.2).
+ *
+ * Cannot be hard-deleted in v1 — only archived. `is_archived = true` filters
+ * the row out of the user-facing `GET /agents` response so no new sessions can
+ * start against it; existing sessions remain readable + writable.
+ *
+ * @see SPECIFICATIONS.md §11 — `agent` table
+ * @see SPECIFICATIONS.md §6.5 — TPM recovery defaults
+ */
+export declare const agent: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
+    name: "agent";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "id";
+            tableName: "agent";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        displayName: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "display_name";
+            tableName: "agent";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        lettaAgentId: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "letta_agent_id";
+            tableName: "agent";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        tpmRecoveryEnabled: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "tpm_recovery_enabled";
+            tableName: "agent";
+            dataType: "boolean";
+            columnType: "SQLiteBoolean";
+            data: boolean;
+            driverParam: number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        maxRecoveryAttempts: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "max_recovery_attempts";
+            tableName: "agent";
+            dataType: "number";
+            columnType: "SQLiteInteger";
+            data: number;
+            driverParam: number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        defaultRetryAfterSeconds: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "default_retry_after_seconds";
+            tableName: "agent";
+            dataType: "number";
+            columnType: "SQLiteInteger";
+            data: number;
+            driverParam: number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        streamIdleTimeoutSeconds: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "stream_idle_timeout_seconds";
+            tableName: "agent";
+            dataType: "number";
+            columnType: "SQLiteInteger";
+            data: number;
+            driverParam: number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        sandboxSeedName: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "sandbox_seed_name";
+            tableName: "agent";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        forkSourceConversationId: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "fork_source_conversation_id";
+            tableName: "agent";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        isArchived: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "is_archived";
+            tableName: "agent";
+            dataType: "boolean";
+            columnType: "SQLiteBoolean";
+            data: boolean;
+            driverParam: number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        createdAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "created_at";
+            tableName: "agent";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        updatedAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "updated_at";
+            tableName: "agent";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+    };
+    dialect: "sqlite";
+}>;
+/**
+ * One row per ai-hub session — a user's chat against a given ai-hub agent.
+ *
+ * `letta_conversation_id` is server-internal: the React client sees only
+ * `id`. `letta_agent_id` is a snapshot of `agent.letta_agent_id` at session
+ * creation time (re-pointing the catalog row does not migrate existing
+ * conversations).
+ *
+ * @see SPECIFICATIONS.md §11 — `session` table
+ * @see SPECIFICATIONS.md §6.3.1 — sessions API
+ */
+export declare const session: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
+    name: "session";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "id";
+            tableName: "session";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        userId: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "user_id";
+            tableName: "session";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        agentId: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "agent_id";
+            tableName: "session";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        lettaConversationId: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "letta_conversation_id";
+            tableName: "session";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        lettaAgentId: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "letta_agent_id";
+            tableName: "session";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        title: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "title";
+            tableName: "session";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        isArchived: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "is_archived";
+            tableName: "session";
+            dataType: "boolean";
+            columnType: "SQLiteBoolean";
+            data: boolean;
+            driverParam: number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        reasoningEffort: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "reasoning_effort";
+            tableName: "session";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        verbosity: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "verbosity";
+            tableName: "session";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        thinkingBudget: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "thinking_budget";
+            tableName: "session";
+            dataType: "number";
+            columnType: "SQLiteInteger";
+            data: number;
+            driverParam: number;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        sandboxDir: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "sandbox_dir";
+            tableName: "session";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        createdAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "created_at";
+            tableName: "session";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        updatedAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "updated_at";
+            tableName: "session";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+    };
+    dialect: "sqlite";
+}>;
+/**
+ * One row per AI turn (user message + assistant response cycle).
+ *
+ * Lives in the ai-hub DB for the *streaming session* (resumption + state
+ * transitions); message history itself is Letta-owned.
+ *
+ * @see SPECIFICATIONS.md §11
+ * @see SPECIFICATIONS.md §10 — state machine
+ */
+export declare const turn: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
+    name: "turn";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "id";
+            tableName: "turn";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        sessionId: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "session_id";
+            tableName: "turn";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        status: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "status";
+            tableName: "turn";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: "running" | "done" | "cancelled" | "failed";
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["running", "done", "cancelled", "failed"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        phase: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "phase";
+            tableName: "turn";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: "model_text" | "model_reasoning" | "model_tool_input" | "tool_executing" | "waiting_provider" | "awaiting_user";
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["model_text", "model_reasoning", "model_tool_input", "tool_executing", "waiting_provider", "awaiting_user"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        lastSeq: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "last_seq";
+            tableName: "turn";
+            dataType: "number";
+            columnType: "SQLiteInteger";
+            data: number;
+            driverParam: number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        idempotencyKey: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "idempotency_key";
+            tableName: "turn";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        startedAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "started_at";
+            tableName: "turn";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        finishedAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "finished_at";
+            tableName: "turn";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+    };
+    dialect: "sqlite";
+}>;
+/**
+ * Append-only log of SSE events per turn for `/chat/{turn_id}/events`
+ * resumption. Composite PK = `(turn_id, seq)`.
+ *
+ * @see SPECIFICATIONS.md §11
+ * @see SPECIFICATIONS.md §6.6 — state machine and SSE
+ */
+export declare const turnEvent: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
+    name: "turn_event";
+    schema: undefined;
+    columns: {
+        turnId: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "turn_id";
+            tableName: "turn_event";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        seq: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "seq";
+            tableName: "turn_event";
+            dataType: "number";
+            columnType: "SQLiteInteger";
+            data: number;
+            driverParam: number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        eventName: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "event_name";
+            tableName: "turn_event";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        data: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "data";
+            tableName: "turn_event";
+            dataType: "json";
+            columnType: "SQLiteTextJson";
+            data: unknown;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        state: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "state";
+            tableName: "turn_event";
+            dataType: "json";
+            columnType: "SQLiteTextJson";
+            data: unknown;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        createdAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "created_at";
+            tableName: "turn_event";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+    };
+    dialect: "sqlite";
+}>;
+/**
+ * Singleton row holding deployment-wide settings.
+ *
+ * `id` is a fixed integer (= 1) so the singleton constraint is enforceable
+ * via PK. The encryption key (`AI_HUB_ENCRYPTION_KEY`) is **not** a column —
+ * it lives in env only (§6.8 / §12.1).
+ *
+ * Bootstrap-only env semantics for `service_token_signing_key` and
+ * `metrics_scrape_token` are documented in §6.7 / §6.10 / §12.1: on first
+ * boot, env values seed these columns; after that, env is no longer
+ * consulted. Rotation lives at `/admin/settings/rotate-{signing-key,
+ * metrics-token}`.
+ *
+ * @see SPECIFICATIONS.md §11
+ * @see SPECIFICATIONS.md §6.10 — `/metrics` bearer auth
+ * @see SPECIFICATIONS.md §6.7 — single signing key
+ * @see SPECIFICATIONS.md §12.1 — env vars
+ */
+export declare const adminSetting: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
+    name: "admin_setting";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "id";
+            tableName: "admin_setting";
+            dataType: "number";
+            columnType: "SQLiteInteger";
+            data: number;
+            driverParam: number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        lettaApiKeyEncrypted: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "letta_api_key_encrypted";
+            tableName: "admin_setting";
+            dataType: "buffer";
+            columnType: "SQLiteBlobBuffer";
+            data: Buffer<ArrayBufferLike>;
+            driverParam: Buffer<ArrayBufferLike>;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        lettaBaseUrl: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "letta_base_url";
+            tableName: "admin_setting";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        lettaAdeUrl: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "letta_ade_url";
+            tableName: "admin_setting";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        featureToggles: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "feature_toggles";
+            tableName: "admin_setting";
+            dataType: "json";
+            columnType: "SQLiteTextJson";
+            data: unknown;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        themeSwitcherEnabled: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "theme_switcher_enabled";
+            tableName: "admin_setting";
+            dataType: "boolean";
+            columnType: "SQLiteBoolean";
+            data: boolean;
+            driverParam: number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        themeDefault: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "theme_default";
+            tableName: "admin_setting";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: "light" | "dark";
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["light", "dark"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        serviceTokenSigningKey: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "service_token_signing_key";
+            tableName: "admin_setting";
+            dataType: "buffer";
+            columnType: "SQLiteBlobBuffer";
+            data: Buffer<ArrayBufferLike>;
+            driverParam: Buffer<ArrayBufferLike>;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        metricsScrapeToken: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "metrics_scrape_token";
+            tableName: "admin_setting";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        metricsScrapeTokenRotatedAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "metrics_scrape_token_rotated_at";
+            tableName: "admin_setting";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        signingKeyRotatedAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "signing_key_rotated_at";
+            tableName: "admin_setting";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        updatedAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "updated_at";
+            tableName: "admin_setting";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+    };
+    dialect: "sqlite";
+}>;
+/**
+ * Per-conversation, per-position **two-layer** content overrides for the
+ * messages rendered by `GET /sessions/:id/messages` and (forward-looking)
+ * the LLM-visible content at that position.
+ *
+ * **Why two layers.** Every message has two viewpoints that can legitimately
+ * diverge in tier-3 customizations:
+ *
+ * - **system view** (`system_override`) — what the LLM saw / should see at
+ *   this position. Today this column is *stored but inert at read time* —
+ *   we keep it because Letta owns its own conversation history and we
+ *   can't actually rewrite past rows it persisted. It exists for two
+ *   forward-looking purposes: audit/debug tooling that wants to know
+ *   what the operator intends the LLM context to look like, and a future
+ *   context-replay feature.
+ *
+ * - **user view** (`user_override`) — what the human sees in the chat
+ *   transcript at this position. This is what the messages-list route
+ *   substitutes for display.
+ *
+ * Both columns are nullable; at least one must be non-null per a CHECK
+ * constraint (enforced in the migration SQL). The "set just one column"
+ * shape lets one writer set the user-facing view without clobbering an
+ * earlier-set system-facing one and vice-versa.
+ *
+ * **Why position-keyed instead of id-keyed.** Letta rotates the
+ * `system_message.id` on every prompt recompile, so id-based keys would
+ * go stale. The chronologically-sorted index into
+ * `listMessages(conversation_id)` is stable across recompiles.
+ *
+ * **Lifecycle / writers.**
+ *
+ * - The `POST /chat` post-turn writer creates a row with `user_override`
+ *   populated (and `system_override` left null) when the request body
+ *   carried a `user_override` parameter AND the turn terminated `done`.
+ *   It runs immediately after the turn-end event, at which point we know
+ *   the user message persisted and no turn is active.
+ *
+ * - `PUT /sessions/:id/message-overrides/:position` is the manual writer
+ *   for past messages — operator / SDK callers. Gated by two checks: the
+ *   position must already exist in Letta's message list, and no turn for
+ *   the session may be live. Merge semantics: only the columns the body
+ *   provided are written; an existing column on the other layer is
+ *   preserved.
+ *
+ * @see SPECIFICATIONS.md §6.3.1 — sessions API
+ * @see SPECIFICATIONS.md §6.4 — Letta integration boundary
+ */
+export declare const messageOverride: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
+    name: "message_override";
+    schema: undefined;
+    columns: {
+        conversationId: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "conversation_id";
+            tableName: "message_override";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        ordinalPosition: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "ordinal_position";
+            tableName: "message_override";
+            dataType: "number";
+            columnType: "SQLiteInteger";
+            data: number;
+            driverParam: number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        systemOverride: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "system_override";
+            tableName: "message_override";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        userOverride: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "user_override";
+            tableName: "message_override";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        createdAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "created_at";
+            tableName: "message_override";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        updatedAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "updated_at";
+            tableName: "message_override";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+    };
+    dialect: "sqlite";
+}>;
+/** Row shape for the `user` table (Drizzle-inferred). */
+export type UserRow = typeof user.$inferSelect;
+/** Insert shape for the `user` table. */
+export type UserInsert = typeof user.$inferInsert;
+/** Row shape for the `agent` table. */
+export type AgentRow = typeof agent.$inferSelect;
+/** Insert shape for the `agent` table. */
+export type AgentInsert = typeof agent.$inferInsert;
+/** Row shape for the `session` table. */
+export type SessionRow = typeof session.$inferSelect;
+/** Insert shape for the `session` table. */
+export type SessionInsert = typeof session.$inferInsert;
+/** Row shape for the `turn` table. */
+export type TurnRow = typeof turn.$inferSelect;
+/** Insert shape for the `turn` table. */
+export type TurnInsert = typeof turn.$inferInsert;
+/** Row shape for the `turn_event` table. */
+export type TurnEventRow = typeof turnEvent.$inferSelect;
+/** Insert shape for the `turn_event` table. */
+export type TurnEventInsert = typeof turnEvent.$inferInsert;
+/** Row shape for the `admin_setting` table. */
+export type AdminSettingRow = typeof adminSetting.$inferSelect;
+/** Insert shape for the `admin_setting` table. */
+export type AdminSettingInsert = typeof adminSetting.$inferInsert;
+/** Row shape for the `message_override` table. */
+export type MessageOverrideRow = typeof messageOverride.$inferSelect;
+/** Insert shape for the `message_override` table. */
+export type MessageOverrideInsert = typeof messageOverride.$inferInsert;
+/**
+ * Provider-reported per-turn token usage, stamped on the LAST assistant
+ * message of each turn. Surfaced to the chat UI via a hover badge so
+ * users can see (a) total tokens consumed and (b) prompt-cache
+ * hit/miss split (Anthropic + OpenAI + Gemini all report
+ * `cached_input_tokens`; Anthropic also reports `cache_write_tokens`).
+ *
+ * The runner fetches Letta's `GET /v1/runs/{run_id}/messages` after
+ * the turn ends, finds the `usage_statistics`-typed message, and
+ * inserts one row here keyed by the last assistant message's Letta id.
+ *
+ * @see SPECIFICATIONS.md §9 — `usage` SSE event
+ * @see docs/server/chat-sse.md — wire protocol
+ */
+export declare const messageUsage: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
+    name: "message_usage";
+    schema: undefined;
+    columns: {
+        lettaMessageId: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "letta_message_id";
+            tableName: "message_usage";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        sessionId: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "session_id";
+            tableName: "message_usage";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        promptTokens: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "prompt_tokens";
+            tableName: "message_usage";
+            dataType: "number";
+            columnType: "SQLiteInteger";
+            data: number;
+            driverParam: number;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        completionTokens: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "completion_tokens";
+            tableName: "message_usage";
+            dataType: "number";
+            columnType: "SQLiteInteger";
+            data: number;
+            driverParam: number;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        totalTokens: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "total_tokens";
+            tableName: "message_usage";
+            dataType: "number";
+            columnType: "SQLiteInteger";
+            data: number;
+            driverParam: number;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        cachedInputTokens: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "cached_input_tokens";
+            tableName: "message_usage";
+            dataType: "number";
+            columnType: "SQLiteInteger";
+            data: number;
+            driverParam: number;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        cacheWriteTokens: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "cache_write_tokens";
+            tableName: "message_usage";
+            dataType: "number";
+            columnType: "SQLiteInteger";
+            data: number;
+            driverParam: number;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        reasoningTokens: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "reasoning_tokens";
+            tableName: "message_usage";
+            dataType: "number";
+            columnType: "SQLiteInteger";
+            data: number;
+            driverParam: number;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        contextTokens: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "context_tokens";
+            tableName: "message_usage";
+            dataType: "number";
+            columnType: "SQLiteInteger";
+            data: number;
+            driverParam: number;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        runId: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "run_id";
+            tableName: "message_usage";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        createdAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "created_at";
+            tableName: "message_usage";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+    };
+    dialect: "sqlite";
+}>;
+/** Row shape for the `message_usage` table. */
+export type MessageUsageRow = typeof messageUsage.$inferSelect;
+/** Insert shape for the `message_usage` table. */
+export type MessageUsageInsert = typeof messageUsage.$inferInsert;
+/**
+ * Admin-curated **rotating starting message** — a prompt that ai-hub runs
+ * against a Letta agent on a schedule, capturing the agent's reply as a
+ * *pre-prepared conversation* that refreshes automatically.
+ *
+ * This is an automated, self-refreshing evolution of `agent.fork_source_conversation_id`
+ * (static base-conversation forking). Instead of an operator hand-authoring a
+ * base conversation in the ADE and pasting its id, a rotation runner:
+ *
+ *   1. `createConversation(letta_agent_id)`,
+ *   2. sends `prompt` (drained to completion via the normal streaming path),
+ *   3. deletes the prompt's `user_message` so the conversation opens with the
+ *      agent's reply,
+ *   4. stores the resulting conversation id in `current_conversation_id`.
+ *
+ * The row's `id` (a `rmsg-…` token) is the identifier callers reference
+ * anywhere a conversation is referenced. Today that's the agent's **Base
+ * conversation ID** field: an `agent.fork_source_conversation_id` of
+ * `rmsg-<id>` resolves (at `POST /sessions`) to this row's
+ * `current_conversation_id`, which is then forked like any static base.
+ *
+ * **Same-agent fork constraint.** Letta's fork API requires the new
+ * conversation to share the source's agent, so a rotating message can only
+ * back ai-hub agents whose `letta_agent_id` equals this row's
+ * `letta_agent_id`. The admin agents validator enforces this at write time
+ * (mirrors the static `fork_source_agent_mismatch` check).
+ *
+ * **Resilience.** A failed rotation never blanks a working
+ * `current_conversation_id` — the runner keeps the last-good value, records
+ * `last_status = 'error'` + `last_error`, and retries on the next interval.
+ *
+ * @see docs/server/rotating-messages.md
+ */
+export declare const rotatingMessage: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
+    name: "rotating_message";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "id";
+            tableName: "rotating_message";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        displayName: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "display_name";
+            tableName: "rotating_message";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        prompt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "prompt";
+            tableName: "rotating_message";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        lettaAgentId: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "letta_agent_id";
+            tableName: "rotating_message";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        scheduleKind: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "schedule_kind";
+            tableName: "rotating_message";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: "every" | "daily" | "cron";
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["every", "daily", "cron"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        intervalSeconds: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "interval_seconds";
+            tableName: "rotating_message";
+            dataType: "number";
+            columnType: "SQLiteInteger";
+            data: number;
+            driverParam: number;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        dailyTime: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "daily_time";
+            tableName: "rotating_message";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        cronExpression: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "cron_expression";
+            tableName: "rotating_message";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        currentConversationId: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "current_conversation_id";
+            tableName: "rotating_message";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        lastStatus: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "last_status";
+            tableName: "rotating_message";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: "pending" | "ok" | "error";
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["pending", "ok", "error"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        lastError: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "last_error";
+            tableName: "rotating_message";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        lastRotatedAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "last_rotated_at";
+            tableName: "rotating_message";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        nextRotationAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "next_rotation_at";
+            tableName: "rotating_message";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        isArchived: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "is_archived";
+            tableName: "rotating_message";
+            dataType: "boolean";
+            columnType: "SQLiteBoolean";
+            data: boolean;
+            driverParam: number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        createdAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "created_at";
+            tableName: "rotating_message";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+        updatedAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "updated_at";
+            tableName: "rotating_message";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, object>;
+    };
+    dialect: "sqlite";
+}>;
+/** Row shape for the `rotating_message` table. */
+export type RotatingMessageRow = typeof rotatingMessage.$inferSelect;
+/** Insert shape for the `rotating_message` table. */
+export type RotatingMessageInsert = typeof rotatingMessage.$inferInsert;
+//# sourceMappingURL=schema.d.ts.map