@intelligo-dev/core 1.0.0-beta.1

package/dist/db/schema/rag.d.ts

@@ -0,0 +1,171 @@
+/**
+ * RAG documents schema (Phase H).
+ *
+ * Single shared table that backs every collection in
+ * @intelligo-dev/agents/rag. Each collection (e.g., career.universities,
+ * career.scholarships, career.majors) lives as a `collection` slug
+ * filter on this table — so adding a new collection means writing a
+ * Collection<TMeta> instance, not a migration.
+ *
+ * Schema choices:
+ *  - `collection` is indexed for the per-collection filter clause.
+ *  - `metadata` is freeform JSONB; the typed Collection wrapper in
+ *    @intelligo-dev/agents validates with Zod at write time.
+ *  - `embedding` is a 1536-dim pgvector to match
+ *    OpenAI text-embedding-3-small (the embeddings module in
+ *    @intelligo-dev/ai already targets that model).
+ *  - `external_id` lets ingestion be idempotent — re-running a seed
+ *    upserts on (collection, external_id) instead of duplicating.
+ *
+ * The pgvector IVFFlat / HNSW index lives in the SQL migration
+ * because drizzle-orm doesn't expose the syntax natively, same
+ * pattern as user_memories in identity.ts.
+ */
+export declare const ragDocuments: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "rag_documents";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: "rag_documents";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        collection: import("drizzle-orm/pg-core").PgColumn<{
+            name: "collection";
+            tableName: "rag_documents";
+            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;
+        }, {}, {}>;
+        externalId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "external_id";
+            tableName: "rag_documents";
+            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;
+        }, {}, {}>;
+        content: import("drizzle-orm/pg-core").PgColumn<{
+            name: "content";
+            tableName: "rag_documents";
+            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;
+        }, {}, {}>;
+        metadata: import("drizzle-orm/pg-core").PgColumn<{
+            name: "metadata";
+            tableName: "rag_documents";
+            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;
+        }, {}, {}>;
+        embedding: import("drizzle-orm/pg-core").PgColumn<{
+            name: "embedding";
+            tableName: "rag_documents";
+            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;
+        }>;
+        createdAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "created_at";
+            tableName: "rag_documents";
+            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: "rag_documents";
+            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;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
+export type RagDocument = typeof ragDocuments.$inferSelect;
+export type InsertRagDocument = typeof ragDocuments.$inferInsert;
+//# sourceMappingURL=rag.d.ts.map

package/dist/db/schema/rag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rag.d.ts","sourceRoot":"","sources":["../../../src/db/schema/rag.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAYH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwBxB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,OAAO,YAAY,CAAC,YAAY,CAAC;AAC3D,MAAM,MAAM,iBAAiB,GAAG,OAAO,YAAY,CAAC,YAAY,CAAC"}

package/dist/db/schema/rag.js

@@ -0,0 +1,42 @@
+/**
+ * RAG documents schema (Phase H).
+ *
+ * Single shared table that backs every collection in
+ * @intelligo-dev/agents/rag. Each collection (e.g., career.universities,
+ * career.scholarships, career.majors) lives as a `collection` slug
+ * filter on this table — so adding a new collection means writing a
+ * Collection<TMeta> instance, not a migration.
+ *
+ * Schema choices:
+ *  - `collection` is indexed for the per-collection filter clause.
+ *  - `metadata` is freeform JSONB; the typed Collection wrapper in
+ *    @intelligo-dev/agents validates with Zod at write time.
+ *  - `embedding` is a 1536-dim pgvector to match
+ *    OpenAI text-embedding-3-small (the embeddings module in
+ *    @intelligo-dev/ai already targets that model).
+ *  - `external_id` lets ingestion be idempotent — re-running a seed
+ *    upserts on (collection, external_id) instead of duplicating.
+ *
+ * The pgvector IVFFlat / HNSW index lives in the SQL migration
+ * because drizzle-orm doesn't expose the syntax natively, same
+ * pattern as user_memories in identity.ts.
+ */
+import { pgTable, text, timestamp, jsonb, index, uniqueIndex, } from "drizzle-orm/pg-core";
+import { vector } from "drizzle-orm/pg-core/columns/vector_extension/vector";
+export const ragDocuments = pgTable("rag_documents", {
+    id: text("id").primaryKey(),
+    collection: text("collection").notNull(),
+    externalId: text("external_id"),
+    content: text("content").notNull(),
+    metadata: jsonb("metadata").notNull().default({}),
+    embedding: vector({ dimensions: 1536 }),
+    createdAt: timestamp("created_at").notNull().defaultNow(),
+    updatedAt: timestamp("updated_at").notNull().defaultNow(),
+}, (table) => [
+    index("rag_documents_collection_idx").on(table.collection),
+    uniqueIndex("rag_documents_collection_external_uniq").on(table.collection, table.externalId),
+    // HNSW index for vector similarity search lives in the SQL migration
+    // (0031_rag_documents_hnsw.sql) because drizzle-orm doesn't expose the
+    // HNSW index syntax natively. Pattern mirrors knowledge_chunks above.
+]);
+//# sourceMappingURL=rag.js.map

package/dist/db/schema/rag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rag.js","sourceRoot":"","sources":["../../../src/db/schema/rag.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EACL,OAAO,EACP,IAAI,EACJ,SAAS,EACT,KAAK,EACL,KAAK,EACL,WAAW,GACZ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,MAAM,EAAE,MAAM,qDAAqD,CAAC;AAE7E,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CACjC,eAAe,EACf;IACE,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE;IAC3B,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE;IACxC,UAAU,EAAE,IAAI,CAAC,aAAa,CAAC;IAE/B,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE;IAClC,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IACjD,SAAS,EAAE,MAAM,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;IAEvC,SAAS,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC,UAAU,EAAE;IACzD,SAAS,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC,UAAU,EAAE;CAC1D,EACD,CAAC,KAAK,EAAE,EAAE,CAAC;IACT,KAAK,CAAC,8BAA8B,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;IAC1D,WAAW,CAAC,wCAAwC,CAAC,CAAC,EAAE,CACtD,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,UAAU,CACjB;IACD,qEAAqE;IACrE,uEAAuE;IACvE,sEAAsE;CACvE,CACF,CAAC"}