@minion-stack/db 0.6.0 → 0.8.0

package/dist/pg/schema/agent-memories.d.ts

@@ -0,0 +1,281 @@
+/**
+ * Org-scoped agent memory corpus with pgvector embeddings. This is the
+ * system-of-record home for agent memories (migrated off the gateway-local
+ * LanceDB store): semantic memory, session-memory summaries, and captured
+ * facts/preferences/decisions/entities. Both the hub (visualization) and the
+ * flow runner (RAG retrieval) read from here.
+ *
+ * Embedding dimension matches OpenAI `text-embedding-3-small` (1536). If the
+ * embedding model changes, add a new column / table rather than mixing
+ * dimensions in one column.
+ *
+ * RLS (org isolation) is added in the hand-written companion migration
+ * `<ts>_agent_memories_rls.sql` (role app_ledger + app.current_org_id GUC),
+ * mirroring `messages`. Drizzle does not manage roles/policies, the `vector`
+ * extension, or the HNSW index — those live in the companion SQL.
+ */
+export declare const agentMemories: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "agent_memories";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: "agent_memories";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        orgId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "org_id";
+            tableName: "agent_memories";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        gatewayId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "gateway_id";
+            tableName: "agent_memories";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        agentId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "agent_id";
+            tableName: "agent_memories";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        profileId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "profile_id";
+            tableName: "agent_memories";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        content: import("drizzle-orm/pg-core").PgColumn<{
+            name: "content";
+            tableName: "agent_memories";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        embedding: import("drizzle-orm/pg-core").PgColumn<{
+            name: "embedding";
+            tableName: "agent_memories";
+            dataType: "array";
+            columnType: "PgVector";
+            data: number[];
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            dimensions: 1536;
+        }>;
+        category: import("drizzle-orm/pg-core").PgColumn<{
+            name: "category";
+            tableName: "agent_memories";
+            dataType: "string";
+            columnType: "PgText";
+            data: "preference" | "fact" | "decision" | "entity" | "other";
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["preference", "fact", "decision", "entity", "other"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        importance: import("drizzle-orm/pg-core").PgColumn<{
+            name: "importance";
+            tableName: "agent_memories";
+            dataType: "number";
+            columnType: "PgReal";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        source: import("drizzle-orm/pg-core").PgColumn<{
+            name: "source";
+            tableName: "agent_memories";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        sourceId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "source_id";
+            tableName: "agent_memories";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        occurredAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "occurred_at";
+            tableName: "agent_memories";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        createdAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "created_at";
+            tableName: "agent_memories";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        updatedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "updated_at";
+            tableName: "agent_memories";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        metadata: import("drizzle-orm/pg-core").PgColumn<{
+            name: "metadata";
+            tableName: "agent_memories";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: unknown;
+            driverParam: unknown;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
+//# sourceMappingURL=agent-memories.d.ts.map

package/dist/pg/schema/agent-memories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-memories.d.ts","sourceRoot":"","sources":["../../../src/pg/schema/agent-memories.ts"],"names":[],"mappings":"AAaA;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2CzB,CAAC"}

package/dist/pg/schema/agent-memories.js

@@ -0,0 +1,59 @@
+import { sql } from 'drizzle-orm';
+import { pgTable, uuid, text, real, timestamp, jsonb, vector, index, uniqueIndex, } from 'drizzle-orm/pg-core';
+/**
+ * Org-scoped agent memory corpus with pgvector embeddings. This is the
+ * system-of-record home for agent memories (migrated off the gateway-local
+ * LanceDB store): semantic memory, session-memory summaries, and captured
+ * facts/preferences/decisions/entities. Both the hub (visualization) and the
+ * flow runner (RAG retrieval) read from here.
+ *
+ * Embedding dimension matches OpenAI `text-embedding-3-small` (1536). If the
+ * embedding model changes, add a new column / table rather than mixing
+ * dimensions in one column.
+ *
+ * RLS (org isolation) is added in the hand-written companion migration
+ * `<ts>_agent_memories_rls.sql` (role app_ledger + app.current_org_id GUC),
+ * mirroring `messages`. Drizzle does not manage roles/policies, the `vector`
+ * extension, or the HNSW index — those live in the companion SQL.
+ */
+export const agentMemories = pgTable('agent_memories', {
+    id: uuid('id').primaryKey().defaultRandom(),
+    // RLS pivot. Better Auth org id (text), matches messages.org_id convention.
+    orgId: text('org_id').notNull(),
+    // Producing gateway/server id (hub servers.id; text — not a PG uuid).
+    gatewayId: text('gateway_id'),
+    // Memory is agent-scoped; agentId is the gateway agent id (text).
+    agentId: text('agent_id').notNull(),
+    // Optional owner for personal memories (profiles.id); null = agent-global.
+    profileId: uuid('profile_id'),
+    // The memory content (what gets embedded + shown).
+    content: text('content').notNull(),
+    // OpenAI text-embedding-3-small dimension. Nullable so a row can be inserted
+    // before its embedding is computed (async backfill).
+    embedding: vector('embedding', { dimensions: 1536 }),
+    category: text('category', {
+        enum: ['preference', 'fact', 'decision', 'entity', 'other'],
+    })
+        .notNull()
+        .default('other'),
+    // 0..1 salience used for ranking + decay.
+    importance: real('importance').notNull().default(0.5),
+    // Which subsystem produced this row: lancedb | session | manual | kg | ledger.
+    source: text('source').notNull().default('manual'),
+    // Original id in the source system (e.g. LanceDB MemoryEntry.id) — enables
+    // idempotent migration + dedupe.
+    sourceId: text('source_id'),
+    occurredAt: timestamp('occurred_at', { withTimezone: true }),
+    createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),
+    updatedAt: timestamp('updated_at', { withTimezone: true }).notNull().defaultNow(),
+    metadata: jsonb('metadata').notNull().default({}),
+}, (t) => ({
+    // Idempotent migration / cross-source dedupe.
+    sourceUnique: uniqueIndex('agent_memories_source_uniq')
+        .on(t.orgId, t.source, t.sourceId)
+        .where(sql `source_id is not null`),
+    orgAgentIdx: index('agent_memories_org_agent_idx').on(t.orgId, t.agentId),
+    orgCategoryIdx: index('agent_memories_org_category_idx').on(t.orgId, t.category),
+    orgTimeIdx: index('agent_memories_org_time_idx').on(t.orgId, t.createdAt),
+}));
+//# sourceMappingURL=agent-memories.js.map

package/dist/pg/schema/agent-memories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-memories.js","sourceRoot":"","sources":["../../../src/pg/schema/agent-memories.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,EACL,OAAO,EACP,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,SAAS,EACT,KAAK,EACL,MAAM,EACN,KAAK,EACL,WAAW,GACZ,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,OAAO,CAClC,gBAAgB,EAChB;IACE,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC,aAAa,EAAE;IAC3C,4EAA4E;IAC5E,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE;IAC/B,sEAAsE;IACtE,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC;IAC7B,kEAAkE;IAClE,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE;IACnC,2EAA2E;IAC3E,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC;IAC7B,mDAAmD;IACnD,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE;IAClC,6EAA6E;IAC7E,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC,WAAW,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;IACpD,QAAQ,EAAE,IAAI,CAAC,UAAU,EAAE;QACzB,IAAI,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,CAAC;KAC5D,CAAC;SACC,OAAO,EAAE;SACT,OAAO,CAAC,OAAO,CAAC;IACnB,0CAA0C;IAC1C,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;IACrD,+EAA+E;IAC/E,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC;IAClD,2EAA2E;IAC3E,iCAAiC;IACjC,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC;IAC3B,UAAU,EAAE,SAAS,CAAC,aAAa,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;IAC5D,SAAS,EAAE,SAAS,CAAC,YAAY,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,UAAU,EAAE;IACjF,SAAS,EAAE,SAAS,CAAC,YAAY,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,UAAU,EAAE;IACjF,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;CAClD,EACD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACN,8CAA8C;IAC9C,YAAY,EAAE,WAAW,CAAC,4BAA4B,CAAC;SACpD,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC;SACjC,KAAK,CAAC,GAAG,CAAA,uBAAuB,CAAC;IACpC,WAAW,EAAE,KAAK,CAAC,8BAA8B,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC;IACzE,cAAc,EAAE,KAAK,CAAC,iCAAiC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC;IAChF,UAAU,EAAE,KAAK,CAAC,6BAA6B,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,SAAS,CAAC;CAC1E,CAAC,CACH,CAAC"}