@stackbone/sdk 0.1.0-alpha.0

package/package.json

@@ -0,0 +1,108 @@
+{
+  "name": "@stackbone/sdk",
+  "version": "0.1.0-alpha.0",
+  "license": "UNLICENSED",
+  "description": "Official TypeScript SDK for Stackbone — the marketplace and managed runtime for containerized AI agents.",
+  "type": "module",
+  "main": "./index.cjs",
+  "module": "./index.js",
+  "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./index.d.ts",
+        "default": "./index.js"
+      },
+      "require": {
+        "types": "./index.d.cts",
+        "default": "./index.cjs"
+      }
+    },
+    "./db": {
+      "import": {
+        "types": "./db/index.d.ts",
+        "default": "./db/index.js"
+      },
+      "require": {
+        "types": "./db/index.d.cts",
+        "default": "./db/index.cjs"
+      }
+    },
+    "./db/testing": {
+      "import": {
+        "types": "./db/testing/index.d.ts",
+        "default": "./db/testing/index.js"
+      },
+      "require": {
+        "types": "./db/testing/index.d.cts",
+        "default": "./db/testing/index.cjs"
+      }
+    },
+    "./queues/types": {
+      "import": {
+        "types": "./queues/types.d.ts",
+        "default": "./queues/types.js"
+      },
+      "require": {
+        "types": "./queues/types.d.cts",
+        "default": "./queues/types.cjs"
+      }
+    },
+    "./rag/migrations": {
+      "import": {
+        "types": "./rag/migrations/index.d.ts",
+        "default": "./rag/migrations/index.js"
+      },
+      "require": {
+        "types": "./rag/migrations/index.d.cts",
+        "default": "./rag/migrations/index.cjs"
+      }
+    },
+    "./rag/schema": {
+      "import": {
+        "types": "./rag/schema.d.ts",
+        "default": "./rag/schema.js"
+      },
+      "require": {
+        "types": "./rag/schema.d.cts",
+        "default": "./rag/schema.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/stackbone/stackbone.git",
+    "directory": "libs/sdk"
+  },
+  "homepage": "https://stackbone.ai",
+  "bugs": {
+    "url": "https://github.com/stackbone/stackbone/issues"
+  },
+  "keywords": [
+    "stackbone",
+    "ai-agents",
+    "agent-sdk",
+    "containerized-agents",
+    "openrouter",
+    "rag",
+    "pgvector",
+    "drizzle",
+    "openai",
+    "postgres"
+  ],
+  "dependencies": {
+    "@aws-sdk/client-s3": "^3.1038.0",
+    "@aws-sdk/s3-request-presigner": "^3.1038.0",
+    "drizzle-orm": "0.45.2",
+    "openai": "^4.104.0",
+    "postgres": "3.4.9",
+    "unpdf": "^0.12.1"
+  }
+}

package/queues/types.cjs

@@ -0,0 +1,4 @@
+'use strict';
+
+//# sourceMappingURL=types.cjs.map
+//# sourceMappingURL=types.cjs.map

package/queues/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"types.cjs"}

package/queues/types.d.cts

@@ -0,0 +1,14 @@
+/**
+ * Registry of typed queue jobs. Consumers extend this interface via module
+ * augmentation so publisher and receiver share payload shapes:
+ *
+ *   declare module '@stackbone/sdk/queues/types' {
+ *     interface QueueJobs {
+ *       'send-email': { to: string; templateId: string };
+ *     }
+ *   }
+ */
+interface QueueJobs {
+}
+
+export type { QueueJobs };

package/queues/types.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Registry of typed queue jobs. Consumers extend this interface via module
+ * augmentation so publisher and receiver share payload shapes:
+ *
+ *   declare module '@stackbone/sdk/queues/types' {
+ *     interface QueueJobs {
+ *       'send-email': { to: string; templateId: string };
+ *     }
+ *   }
+ */
+interface QueueJobs {
+}
+
+export type { QueueJobs };

package/queues/types.js

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=types.js.map
+//# sourceMappingURL=types.js.map

package/queues/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"types.js"}

package/rag/migrations/index.cjs

@@ -0,0 +1,71 @@
+'use strict';
+
+// src/modules/rag/migrations/index.ts
+var STACKBONE_RAG_MARKER_PREFIX = "-- @stackbone:rag@";
+var STACKBONE_RAG_MARKER_REGEX = /^-- @stackbone:rag@v(\d+)$/;
+var STACKBONE_RAG_V1_FILENAME_SUFFIX = "stackbone_rag_v1.sql";
+var STACKBONE_RAG_V1_SQL = `-- @stackbone:rag@v1
+CREATE EXTENSION IF NOT EXISTS vector;
+--> statement-breakpoint
+CREATE TABLE "stackbone_rag_collections" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"name" text NOT NULL,
+	"metadata" jsonb DEFAULT '{}'::jsonb NOT NULL,
+	"created_at" timestamp with time zone DEFAULT now() NOT NULL,
+	CONSTRAINT "stackbone_rag_collections_name_unique" UNIQUE("name")
+);
+--> statement-breakpoint
+CREATE TABLE "stackbone_rag_documents" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"collection_id" uuid NOT NULL,
+	"source" text NOT NULL,
+	"content_hash" text NOT NULL,
+	"metadata" jsonb DEFAULT '{}'::jsonb NOT NULL,
+	"created_at" timestamp with time zone DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE "stackbone_rag_chunks" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"document_id" uuid NOT NULL,
+	"ordinal" integer NOT NULL,
+	"content" text NOT NULL,
+	"embedding" vector(1536) NOT NULL,
+	"metadata" jsonb DEFAULT '{}'::jsonb NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE "stackbone_rag_jobs" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"collection_id" uuid NOT NULL,
+	"status" text DEFAULT 'queued' NOT NULL,
+	"progress" jsonb DEFAULT '{"totalChunks":0,"processedChunks":0}'::jsonb NOT NULL,
+	"error" text,
+	"created_at" timestamp with time zone DEFAULT now() NOT NULL,
+	"updated_at" timestamp with time zone DEFAULT now() NOT NULL,
+	CONSTRAINT "stackbone_rag_jobs_status_check" CHECK ("status" IN ('queued','running','succeeded','failed','cancelled'))
+);
+--> statement-breakpoint
+ALTER TABLE "stackbone_rag_documents" ADD CONSTRAINT "stackbone_rag_documents_collection_id_fk" FOREIGN KEY ("collection_id") REFERENCES "public"."stackbone_rag_collections"("id") ON DELETE cascade ON UPDATE no action;
+--> statement-breakpoint
+ALTER TABLE "stackbone_rag_chunks" ADD CONSTRAINT "stackbone_rag_chunks_document_id_fk" FOREIGN KEY ("document_id") REFERENCES "public"."stackbone_rag_documents"("id") ON DELETE cascade ON UPDATE no action;
+--> statement-breakpoint
+ALTER TABLE "stackbone_rag_jobs" ADD CONSTRAINT "stackbone_rag_jobs_collection_id_fk" FOREIGN KEY ("collection_id") REFERENCES "public"."stackbone_rag_collections"("id") ON DELETE cascade ON UPDATE no action;
+--> statement-breakpoint
+CREATE INDEX "stackbone_rag_documents_collection_idx" ON "stackbone_rag_documents" USING btree ("collection_id");
+--> statement-breakpoint
+CREATE INDEX "stackbone_rag_documents_hash_idx" ON "stackbone_rag_documents" USING btree ("collection_id","content_hash");
+--> statement-breakpoint
+CREATE INDEX "stackbone_rag_chunks_document_idx" ON "stackbone_rag_chunks" USING btree ("document_id");
+--> statement-breakpoint
+CREATE INDEX "stackbone_rag_chunks_embedding_hnsw" ON "stackbone_rag_chunks" USING hnsw ("embedding" vector_cosine_ops);
+--> statement-breakpoint
+CREATE INDEX "stackbone_rag_jobs_collection_idx" ON "stackbone_rag_jobs" USING btree ("collection_id");
+--> statement-breakpoint
+CREATE INDEX "stackbone_rag_jobs_status_idx" ON "stackbone_rag_jobs" USING btree ("status");
+`;
+
+exports.STACKBONE_RAG_MARKER_PREFIX = STACKBONE_RAG_MARKER_PREFIX;
+exports.STACKBONE_RAG_MARKER_REGEX = STACKBONE_RAG_MARKER_REGEX;
+exports.STACKBONE_RAG_V1_FILENAME_SUFFIX = STACKBONE_RAG_V1_FILENAME_SUFFIX;
+exports.STACKBONE_RAG_V1_SQL = STACKBONE_RAG_V1_SQL;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/rag/migrations/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../libs/sdk/src/modules/rag/migrations/index.ts"],"names":["STACKBONE_RAG_MARKER_PREFIX","STACKBONE_RAG_MARKER_REGEX","STACKBONE_RAG_V1_FILENAME_SUFFIX","STACKBONE_RAG_V1_SQL"],"mappings":";;;AAqBO,IAAMA,2BAAAA,GAA8B;AAOpC,IAAMC,0BAAAA,GAA6B;AAGnC,IAAMC,gCAAAA,GAAmC;AAUzC,IAAMC,oBAAAA,GAAuB,CAAA","file":"index.cjs","sourcesContent":["// Runtime-resolvable bundle of the canonical RAG migrations. The CLI's\n// `add-rag` installer copies `STACKBONE_RAG_V1_SQL` verbatim into the\n// creator's `.stackbone/migrations/` directory. The literal `.sql` sibling\n// (`stackbone_rag_v1.sql`) is the human-readable source — a snapshot test\n// pins the two together so they cannot drift.\n//\n// We inline the body here (instead of `readFileSync`) because tsup bundles\n// the SDK into `dist/*.{js,cjs}` and does NOT copy `.sql` assets across.\n// Inlining sidesteps the runtime-asset question: any consumer that imports\n// `@stackbone/sdk/rag/migrations` gets the SQL as a plain string, no fs\n// access required, no path-resolution edge cases inside packed CLIs.\n\n/**\n * Header marker stamped on the first line of every Stackbone-managed RAG\n * migration. The `add-rag` installer is **idempotent** by detection of this\n * exact regex on the first line of any file under\n * `.stackbone/migrations/*.sql`.\n *\n * Format locked in ADR 2026-05-10 §D3: literal `-- @stackbone:rag@v<N>` with\n * no leading/trailing whitespace and no quoting.\n */\nexport const STACKBONE_RAG_MARKER_PREFIX = '-- @stackbone:rag@';\n\n/**\n * Regex matching the marker on the first line of a migration file. Group 1\n * is the integer version. Anchored on both ends so the match is robust to\n * accidental copy-paste of the marker into a comment further down the file.\n */\nexport const STACKBONE_RAG_MARKER_REGEX = /^-- @stackbone:rag@v(\\d+)$/;\n\n/** Filename used when bundling into `.stackbone/migrations/<NNNN>_stackbone_rag_v<N>.sql`. */\nexport const STACKBONE_RAG_V1_FILENAME_SUFFIX = 'stackbone_rag_v1.sql';\n\n/**\n * Canonical body of `stackbone_rag_v1.sql`. Generated from\n * `libs/sdk/src/modules/rag/schema.ts` via `drizzle-kit generate`, then\n * prefixed with the `-- @stackbone:rag@v1` marker required by the installer.\n *\n * The literal `.sql` sibling exists for tooling (drizzle-kit studio, manual\n * inspection); a snapshot test asserts the two stay byte-equal.\n */\nexport const STACKBONE_RAG_V1_SQL = `-- @stackbone:rag@v1\nCREATE EXTENSION IF NOT EXISTS vector;\n--> statement-breakpoint\nCREATE TABLE \"stackbone_rag_collections\" (\n\\t\"id\" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,\n\\t\"name\" text NOT NULL,\n\\t\"metadata\" jsonb DEFAULT '{}'::jsonb NOT NULL,\n\\t\"created_at\" timestamp with time zone DEFAULT now() NOT NULL,\n\\tCONSTRAINT \"stackbone_rag_collections_name_unique\" UNIQUE(\"name\")\n);\n--> statement-breakpoint\nCREATE TABLE \"stackbone_rag_documents\" (\n\\t\"id\" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,\n\\t\"collection_id\" uuid NOT NULL,\n\\t\"source\" text NOT NULL,\n\\t\"content_hash\" text NOT NULL,\n\\t\"metadata\" jsonb DEFAULT '{}'::jsonb NOT NULL,\n\\t\"created_at\" timestamp with time zone DEFAULT now() NOT NULL\n);\n--> statement-breakpoint\nCREATE TABLE \"stackbone_rag_chunks\" (\n\\t\"id\" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,\n\\t\"document_id\" uuid NOT NULL,\n\\t\"ordinal\" integer NOT NULL,\n\\t\"content\" text NOT NULL,\n\\t\"embedding\" vector(1536) NOT NULL,\n\\t\"metadata\" jsonb DEFAULT '{}'::jsonb NOT NULL\n);\n--> statement-breakpoint\nCREATE TABLE \"stackbone_rag_jobs\" (\n\\t\"id\" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,\n\\t\"collection_id\" uuid NOT NULL,\n\\t\"status\" text DEFAULT 'queued' NOT NULL,\n\\t\"progress\" jsonb DEFAULT '{\"totalChunks\":0,\"processedChunks\":0}'::jsonb NOT NULL,\n\\t\"error\" text,\n\\t\"created_at\" timestamp with time zone DEFAULT now() NOT NULL,\n\\t\"updated_at\" timestamp with time zone DEFAULT now() NOT NULL,\n\\tCONSTRAINT \"stackbone_rag_jobs_status_check\" CHECK (\"status\" IN ('queued','running','succeeded','failed','cancelled'))\n);\n--> statement-breakpoint\nALTER TABLE \"stackbone_rag_documents\" ADD CONSTRAINT \"stackbone_rag_documents_collection_id_fk\" FOREIGN KEY (\"collection_id\") REFERENCES \"public\".\"stackbone_rag_collections\"(\"id\") ON DELETE cascade ON UPDATE no action;\n--> statement-breakpoint\nALTER TABLE \"stackbone_rag_chunks\" ADD CONSTRAINT \"stackbone_rag_chunks_document_id_fk\" FOREIGN KEY (\"document_id\") REFERENCES \"public\".\"stackbone_rag_documents\"(\"id\") ON DELETE cascade ON UPDATE no action;\n--> statement-breakpoint\nALTER TABLE \"stackbone_rag_jobs\" ADD CONSTRAINT \"stackbone_rag_jobs_collection_id_fk\" FOREIGN KEY (\"collection_id\") REFERENCES \"public\".\"stackbone_rag_collections\"(\"id\") ON DELETE cascade ON UPDATE no action;\n--> statement-breakpoint\nCREATE INDEX \"stackbone_rag_documents_collection_idx\" ON \"stackbone_rag_documents\" USING btree (\"collection_id\");\n--> statement-breakpoint\nCREATE INDEX \"stackbone_rag_documents_hash_idx\" ON \"stackbone_rag_documents\" USING btree (\"collection_id\",\"content_hash\");\n--> statement-breakpoint\nCREATE INDEX \"stackbone_rag_chunks_document_idx\" ON \"stackbone_rag_chunks\" USING btree (\"document_id\");\n--> statement-breakpoint\nCREATE INDEX \"stackbone_rag_chunks_embedding_hnsw\" ON \"stackbone_rag_chunks\" USING hnsw (\"embedding\" vector_cosine_ops);\n--> statement-breakpoint\nCREATE INDEX \"stackbone_rag_jobs_collection_idx\" ON \"stackbone_rag_jobs\" USING btree (\"collection_id\");\n--> statement-breakpoint\nCREATE INDEX \"stackbone_rag_jobs_status_idx\" ON \"stackbone_rag_jobs\" USING btree (\"status\");\n`;\n"]}

package/rag/migrations/index.d.cts

@@ -0,0 +1,29 @@
+/**
+ * Header marker stamped on the first line of every Stackbone-managed RAG
+ * migration. The `add-rag` installer is **idempotent** by detection of this
+ * exact regex on the first line of any file under
+ * `.stackbone/migrations/*.sql`.
+ *
+ * Format locked in ADR 2026-05-10 §D3: literal `-- @stackbone:rag@v<N>` with
+ * no leading/trailing whitespace and no quoting.
+ */
+declare const STACKBONE_RAG_MARKER_PREFIX = "-- @stackbone:rag@";
+/**
+ * Regex matching the marker on the first line of a migration file. Group 1
+ * is the integer version. Anchored on both ends so the match is robust to
+ * accidental copy-paste of the marker into a comment further down the file.
+ */
+declare const STACKBONE_RAG_MARKER_REGEX: RegExp;
+/** Filename used when bundling into `.stackbone/migrations/<NNNN>_stackbone_rag_v<N>.sql`. */
+declare const STACKBONE_RAG_V1_FILENAME_SUFFIX = "stackbone_rag_v1.sql";
+/**
+ * Canonical body of `stackbone_rag_v1.sql`. Generated from
+ * `libs/sdk/src/modules/rag/schema.ts` via `drizzle-kit generate`, then
+ * prefixed with the `-- @stackbone:rag@v1` marker required by the installer.
+ *
+ * The literal `.sql` sibling exists for tooling (drizzle-kit studio, manual
+ * inspection); a snapshot test asserts the two stay byte-equal.
+ */
+declare const STACKBONE_RAG_V1_SQL = "-- @stackbone:rag@v1\nCREATE EXTENSION IF NOT EXISTS vector;\n--> statement-breakpoint\nCREATE TABLE \"stackbone_rag_collections\" (\n\t\"id\" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,\n\t\"name\" text NOT NULL,\n\t\"metadata\" jsonb DEFAULT '{}'::jsonb NOT NULL,\n\t\"created_at\" timestamp with time zone DEFAULT now() NOT NULL,\n\tCONSTRAINT \"stackbone_rag_collections_name_unique\" UNIQUE(\"name\")\n);\n--> statement-breakpoint\nCREATE TABLE \"stackbone_rag_documents\" (\n\t\"id\" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,\n\t\"collection_id\" uuid NOT NULL,\n\t\"source\" text NOT NULL,\n\t\"content_hash\" text NOT NULL,\n\t\"metadata\" jsonb DEFAULT '{}'::jsonb NOT NULL,\n\t\"created_at\" timestamp with time zone DEFAULT now() NOT NULL\n);\n--> statement-breakpoint\nCREATE TABLE \"stackbone_rag_chunks\" (\n\t\"id\" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,\n\t\"document_id\" uuid NOT NULL,\n\t\"ordinal\" integer NOT NULL,\n\t\"content\" text NOT NULL,\n\t\"embedding\" vector(1536) NOT NULL,\n\t\"metadata\" jsonb DEFAULT '{}'::jsonb NOT NULL\n);\n--> statement-breakpoint\nCREATE TABLE \"stackbone_rag_jobs\" (\n\t\"id\" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,\n\t\"collection_id\" uuid NOT NULL,\n\t\"status\" text DEFAULT 'queued' NOT NULL,\n\t\"progress\" jsonb DEFAULT '{\"totalChunks\":0,\"processedChunks\":0}'::jsonb NOT NULL,\n\t\"error\" text,\n\t\"created_at\" timestamp with time zone DEFAULT now() NOT NULL,\n\t\"updated_at\" timestamp with time zone DEFAULT now() NOT NULL,\n\tCONSTRAINT \"stackbone_rag_jobs_status_check\" CHECK (\"status\" IN ('queued','running','succeeded','failed','cancelled'))\n);\n--> statement-breakpoint\nALTER TABLE \"stackbone_rag_documents\" ADD CONSTRAINT \"stackbone_rag_documents_collection_id_fk\" FOREIGN KEY (\"collection_id\") REFERENCES \"public\".\"stackbone_rag_collections\"(\"id\") ON DELETE cascade ON UPDATE no action;\n--> statement-breakpoint\nALTER TABLE \"stackbone_rag_chunks\" ADD CONSTRAINT \"stackbone_rag_chunks_document_id_fk\" FOREIGN KEY (\"document_id\") REFERENCES \"public\".\"stackbone_rag_documents\"(\"id\") ON DELETE cascade ON UPDATE no action;\n--> statement-breakpoint\nALTER TABLE \"stackbone_rag_jobs\" ADD CONSTRAINT \"stackbone_rag_jobs_collection_id_fk\" FOREIGN KEY (\"collection_id\") REFERENCES \"public\".\"stackbone_rag_collections\"(\"id\") ON DELETE cascade ON UPDATE no action;\n--> statement-breakpoint\nCREATE INDEX \"stackbone_rag_documents_collection_idx\" ON \"stackbone_rag_documents\" USING btree (\"collection_id\");\n--> statement-breakpoint\nCREATE INDEX \"stackbone_rag_documents_hash_idx\" ON \"stackbone_rag_documents\" USING btree (\"collection_id\",\"content_hash\");\n--> statement-breakpoint\nCREATE INDEX \"stackbone_rag_chunks_document_idx\" ON \"stackbone_rag_chunks\" USING btree (\"document_id\");\n--> statement-breakpoint\nCREATE INDEX \"stackbone_rag_chunks_embedding_hnsw\" ON \"stackbone_rag_chunks\" USING hnsw (\"embedding\" vector_cosine_ops);\n--> statement-breakpoint\nCREATE INDEX \"stackbone_rag_jobs_collection_idx\" ON \"stackbone_rag_jobs\" USING btree (\"collection_id\");\n--> statement-breakpoint\nCREATE INDEX \"stackbone_rag_jobs_status_idx\" ON \"stackbone_rag_jobs\" USING btree (\"status\");\n";
+
+export { STACKBONE_RAG_MARKER_PREFIX, STACKBONE_RAG_MARKER_REGEX, STACKBONE_RAG_V1_FILENAME_SUFFIX, STACKBONE_RAG_V1_SQL };

package/rag/migrations/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Header marker stamped on the first line of every Stackbone-managed RAG
+ * migration. The `add-rag` installer is **idempotent** by detection of this
+ * exact regex on the first line of any file under
+ * `.stackbone/migrations/*.sql`.
+ *
+ * Format locked in ADR 2026-05-10 §D3: literal `-- @stackbone:rag@v<N>` with
+ * no leading/trailing whitespace and no quoting.
+ */
+declare const STACKBONE_RAG_MARKER_PREFIX = "-- @stackbone:rag@";
+/**
+ * Regex matching the marker on the first line of a migration file. Group 1
+ * is the integer version. Anchored on both ends so the match is robust to
+ * accidental copy-paste of the marker into a comment further down the file.
+ */
+declare const STACKBONE_RAG_MARKER_REGEX: RegExp;
+/** Filename used when bundling into `.stackbone/migrations/<NNNN>_stackbone_rag_v<N>.sql`. */
+declare const STACKBONE_RAG_V1_FILENAME_SUFFIX = "stackbone_rag_v1.sql";
+/**
+ * Canonical body of `stackbone_rag_v1.sql`. Generated from
+ * `libs/sdk/src/modules/rag/schema.ts` via `drizzle-kit generate`, then
+ * prefixed with the `-- @stackbone:rag@v1` marker required by the installer.
+ *
+ * The literal `.sql` sibling exists for tooling (drizzle-kit studio, manual
+ * inspection); a snapshot test asserts the two stay byte-equal.
+ */
+declare const STACKBONE_RAG_V1_SQL = "-- @stackbone:rag@v1\nCREATE EXTENSION IF NOT EXISTS vector;\n--> statement-breakpoint\nCREATE TABLE \"stackbone_rag_collections\" (\n\t\"id\" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,\n\t\"name\" text NOT NULL,\n\t\"metadata\" jsonb DEFAULT '{}'::jsonb NOT NULL,\n\t\"created_at\" timestamp with time zone DEFAULT now() NOT NULL,\n\tCONSTRAINT \"stackbone_rag_collections_name_unique\" UNIQUE(\"name\")\n);\n--> statement-breakpoint\nCREATE TABLE \"stackbone_rag_documents\" (\n\t\"id\" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,\n\t\"collection_id\" uuid NOT NULL,\n\t\"source\" text NOT NULL,\n\t\"content_hash\" text NOT NULL,\n\t\"metadata\" jsonb DEFAULT '{}'::jsonb NOT NULL,\n\t\"created_at\" timestamp with time zone DEFAULT now() NOT NULL\n);\n--> statement-breakpoint\nCREATE TABLE \"stackbone_rag_chunks\" (\n\t\"id\" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,\n\t\"document_id\" uuid NOT NULL,\n\t\"ordinal\" integer NOT NULL,\n\t\"content\" text NOT NULL,\n\t\"embedding\" vector(1536) NOT NULL,\n\t\"metadata\" jsonb DEFAULT '{}'::jsonb NOT NULL\n);\n--> statement-breakpoint\nCREATE TABLE \"stackbone_rag_jobs\" (\n\t\"id\" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,\n\t\"collection_id\" uuid NOT NULL,\n\t\"status\" text DEFAULT 'queued' NOT NULL,\n\t\"progress\" jsonb DEFAULT '{\"totalChunks\":0,\"processedChunks\":0}'::jsonb NOT NULL,\n\t\"error\" text,\n\t\"created_at\" timestamp with time zone DEFAULT now() NOT NULL,\n\t\"updated_at\" timestamp with time zone DEFAULT now() NOT NULL,\n\tCONSTRAINT \"stackbone_rag_jobs_status_check\" CHECK (\"status\" IN ('queued','running','succeeded','failed','cancelled'))\n);\n--> statement-breakpoint\nALTER TABLE \"stackbone_rag_documents\" ADD CONSTRAINT \"stackbone_rag_documents_collection_id_fk\" FOREIGN KEY (\"collection_id\") REFERENCES \"public\".\"stackbone_rag_collections\"(\"id\") ON DELETE cascade ON UPDATE no action;\n--> statement-breakpoint\nALTER TABLE \"stackbone_rag_chunks\" ADD CONSTRAINT \"stackbone_rag_chunks_document_id_fk\" FOREIGN KEY (\"document_id\") REFERENCES \"public\".\"stackbone_rag_documents\"(\"id\") ON DELETE cascade ON UPDATE no action;\n--> statement-breakpoint\nALTER TABLE \"stackbone_rag_jobs\" ADD CONSTRAINT \"stackbone_rag_jobs_collection_id_fk\" FOREIGN KEY (\"collection_id\") REFERENCES \"public\".\"stackbone_rag_collections\"(\"id\") ON DELETE cascade ON UPDATE no action;\n--> statement-breakpoint\nCREATE INDEX \"stackbone_rag_documents_collection_idx\" ON \"stackbone_rag_documents\" USING btree (\"collection_id\");\n--> statement-breakpoint\nCREATE INDEX \"stackbone_rag_documents_hash_idx\" ON \"stackbone_rag_documents\" USING btree (\"collection_id\",\"content_hash\");\n--> statement-breakpoint\nCREATE INDEX \"stackbone_rag_chunks_document_idx\" ON \"stackbone_rag_chunks\" USING btree (\"document_id\");\n--> statement-breakpoint\nCREATE INDEX \"stackbone_rag_chunks_embedding_hnsw\" ON \"stackbone_rag_chunks\" USING hnsw (\"embedding\" vector_cosine_ops);\n--> statement-breakpoint\nCREATE INDEX \"stackbone_rag_jobs_collection_idx\" ON \"stackbone_rag_jobs\" USING btree (\"collection_id\");\n--> statement-breakpoint\nCREATE INDEX \"stackbone_rag_jobs_status_idx\" ON \"stackbone_rag_jobs\" USING btree (\"status\");\n";
+
+export { STACKBONE_RAG_MARKER_PREFIX, STACKBONE_RAG_MARKER_REGEX, STACKBONE_RAG_V1_FILENAME_SUFFIX, STACKBONE_RAG_V1_SQL };

package/rag/migrations/index.js

@@ -0,0 +1,66 @@
+// src/modules/rag/migrations/index.ts
+var STACKBONE_RAG_MARKER_PREFIX = "-- @stackbone:rag@";
+var STACKBONE_RAG_MARKER_REGEX = /^-- @stackbone:rag@v(\d+)$/;
+var STACKBONE_RAG_V1_FILENAME_SUFFIX = "stackbone_rag_v1.sql";
+var STACKBONE_RAG_V1_SQL = `-- @stackbone:rag@v1
+CREATE EXTENSION IF NOT EXISTS vector;
+--> statement-breakpoint
+CREATE TABLE "stackbone_rag_collections" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"name" text NOT NULL,
+	"metadata" jsonb DEFAULT '{}'::jsonb NOT NULL,
+	"created_at" timestamp with time zone DEFAULT now() NOT NULL,
+	CONSTRAINT "stackbone_rag_collections_name_unique" UNIQUE("name")
+);
+--> statement-breakpoint
+CREATE TABLE "stackbone_rag_documents" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"collection_id" uuid NOT NULL,
+	"source" text NOT NULL,
+	"content_hash" text NOT NULL,
+	"metadata" jsonb DEFAULT '{}'::jsonb NOT NULL,
+	"created_at" timestamp with time zone DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE "stackbone_rag_chunks" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"document_id" uuid NOT NULL,
+	"ordinal" integer NOT NULL,
+	"content" text NOT NULL,
+	"embedding" vector(1536) NOT NULL,
+	"metadata" jsonb DEFAULT '{}'::jsonb NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE "stackbone_rag_jobs" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"collection_id" uuid NOT NULL,
+	"status" text DEFAULT 'queued' NOT NULL,
+	"progress" jsonb DEFAULT '{"totalChunks":0,"processedChunks":0}'::jsonb NOT NULL,
+	"error" text,
+	"created_at" timestamp with time zone DEFAULT now() NOT NULL,
+	"updated_at" timestamp with time zone DEFAULT now() NOT NULL,
+	CONSTRAINT "stackbone_rag_jobs_status_check" CHECK ("status" IN ('queued','running','succeeded','failed','cancelled'))
+);
+--> statement-breakpoint
+ALTER TABLE "stackbone_rag_documents" ADD CONSTRAINT "stackbone_rag_documents_collection_id_fk" FOREIGN KEY ("collection_id") REFERENCES "public"."stackbone_rag_collections"("id") ON DELETE cascade ON UPDATE no action;
+--> statement-breakpoint
+ALTER TABLE "stackbone_rag_chunks" ADD CONSTRAINT "stackbone_rag_chunks_document_id_fk" FOREIGN KEY ("document_id") REFERENCES "public"."stackbone_rag_documents"("id") ON DELETE cascade ON UPDATE no action;
+--> statement-breakpoint
+ALTER TABLE "stackbone_rag_jobs" ADD CONSTRAINT "stackbone_rag_jobs_collection_id_fk" FOREIGN KEY ("collection_id") REFERENCES "public"."stackbone_rag_collections"("id") ON DELETE cascade ON UPDATE no action;
+--> statement-breakpoint
+CREATE INDEX "stackbone_rag_documents_collection_idx" ON "stackbone_rag_documents" USING btree ("collection_id");
+--> statement-breakpoint
+CREATE INDEX "stackbone_rag_documents_hash_idx" ON "stackbone_rag_documents" USING btree ("collection_id","content_hash");
+--> statement-breakpoint
+CREATE INDEX "stackbone_rag_chunks_document_idx" ON "stackbone_rag_chunks" USING btree ("document_id");
+--> statement-breakpoint
+CREATE INDEX "stackbone_rag_chunks_embedding_hnsw" ON "stackbone_rag_chunks" USING hnsw ("embedding" vector_cosine_ops);
+--> statement-breakpoint
+CREATE INDEX "stackbone_rag_jobs_collection_idx" ON "stackbone_rag_jobs" USING btree ("collection_id");
+--> statement-breakpoint
+CREATE INDEX "stackbone_rag_jobs_status_idx" ON "stackbone_rag_jobs" USING btree ("status");
+`;
+
+export { STACKBONE_RAG_MARKER_PREFIX, STACKBONE_RAG_MARKER_REGEX, STACKBONE_RAG_V1_FILENAME_SUFFIX, STACKBONE_RAG_V1_SQL };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/rag/migrations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../libs/sdk/src/modules/rag/migrations/index.ts"],"names":["STACKBONE_RAG_MARKER_PREFIX","STACKBONE_RAG_MARKER_REGEX","STACKBONE_RAG_V1_FILENAME_SUFFIX","STACKBONE_RAG_V1_SQL"],"mappings":";AAqBO,IAAMA,2BAAAA,GAA8B;AAOpC,IAAMC,0BAAAA,GAA6B;AAGnC,IAAMC,gCAAAA,GAAmC;AAUzC,IAAMC,oBAAAA,GAAuB,CAAA","file":"index.js","sourcesContent":["// Runtime-resolvable bundle of the canonical RAG migrations. The CLI's\n// `add-rag` installer copies `STACKBONE_RAG_V1_SQL` verbatim into the\n// creator's `.stackbone/migrations/` directory. The literal `.sql` sibling\n// (`stackbone_rag_v1.sql`) is the human-readable source — a snapshot test\n// pins the two together so they cannot drift.\n//\n// We inline the body here (instead of `readFileSync`) because tsup bundles\n// the SDK into `dist/*.{js,cjs}` and does NOT copy `.sql` assets across.\n// Inlining sidesteps the runtime-asset question: any consumer that imports\n// `@stackbone/sdk/rag/migrations` gets the SQL as a plain string, no fs\n// access required, no path-resolution edge cases inside packed CLIs.\n\n/**\n * Header marker stamped on the first line of every Stackbone-managed RAG\n * migration. The `add-rag` installer is **idempotent** by detection of this\n * exact regex on the first line of any file under\n * `.stackbone/migrations/*.sql`.\n *\n * Format locked in ADR 2026-05-10 §D3: literal `-- @stackbone:rag@v<N>` with\n * no leading/trailing whitespace and no quoting.\n */\nexport const STACKBONE_RAG_MARKER_PREFIX = '-- @stackbone:rag@';\n\n/**\n * Regex matching the marker on the first line of a migration file. Group 1\n * is the integer version. Anchored on both ends so the match is robust to\n * accidental copy-paste of the marker into a comment further down the file.\n */\nexport const STACKBONE_RAG_MARKER_REGEX = /^-- @stackbone:rag@v(\\d+)$/;\n\n/** Filename used when bundling into `.stackbone/migrations/<NNNN>_stackbone_rag_v<N>.sql`. */\nexport const STACKBONE_RAG_V1_FILENAME_SUFFIX = 'stackbone_rag_v1.sql';\n\n/**\n * Canonical body of `stackbone_rag_v1.sql`. Generated from\n * `libs/sdk/src/modules/rag/schema.ts` via `drizzle-kit generate`, then\n * prefixed with the `-- @stackbone:rag@v1` marker required by the installer.\n *\n * The literal `.sql` sibling exists for tooling (drizzle-kit studio, manual\n * inspection); a snapshot test asserts the two stay byte-equal.\n */\nexport const STACKBONE_RAG_V1_SQL = `-- @stackbone:rag@v1\nCREATE EXTENSION IF NOT EXISTS vector;\n--> statement-breakpoint\nCREATE TABLE \"stackbone_rag_collections\" (\n\\t\"id\" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,\n\\t\"name\" text NOT NULL,\n\\t\"metadata\" jsonb DEFAULT '{}'::jsonb NOT NULL,\n\\t\"created_at\" timestamp with time zone DEFAULT now() NOT NULL,\n\\tCONSTRAINT \"stackbone_rag_collections_name_unique\" UNIQUE(\"name\")\n);\n--> statement-breakpoint\nCREATE TABLE \"stackbone_rag_documents\" (\n\\t\"id\" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,\n\\t\"collection_id\" uuid NOT NULL,\n\\t\"source\" text NOT NULL,\n\\t\"content_hash\" text NOT NULL,\n\\t\"metadata\" jsonb DEFAULT '{}'::jsonb NOT NULL,\n\\t\"created_at\" timestamp with time zone DEFAULT now() NOT NULL\n);\n--> statement-breakpoint\nCREATE TABLE \"stackbone_rag_chunks\" (\n\\t\"id\" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,\n\\t\"document_id\" uuid NOT NULL,\n\\t\"ordinal\" integer NOT NULL,\n\\t\"content\" text NOT NULL,\n\\t\"embedding\" vector(1536) NOT NULL,\n\\t\"metadata\" jsonb DEFAULT '{}'::jsonb NOT NULL\n);\n--> statement-breakpoint\nCREATE TABLE \"stackbone_rag_jobs\" (\n\\t\"id\" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,\n\\t\"collection_id\" uuid NOT NULL,\n\\t\"status\" text DEFAULT 'queued' NOT NULL,\n\\t\"progress\" jsonb DEFAULT '{\"totalChunks\":0,\"processedChunks\":0}'::jsonb NOT NULL,\n\\t\"error\" text,\n\\t\"created_at\" timestamp with time zone DEFAULT now() NOT NULL,\n\\t\"updated_at\" timestamp with time zone DEFAULT now() NOT NULL,\n\\tCONSTRAINT \"stackbone_rag_jobs_status_check\" CHECK (\"status\" IN ('queued','running','succeeded','failed','cancelled'))\n);\n--> statement-breakpoint\nALTER TABLE \"stackbone_rag_documents\" ADD CONSTRAINT \"stackbone_rag_documents_collection_id_fk\" FOREIGN KEY (\"collection_id\") REFERENCES \"public\".\"stackbone_rag_collections\"(\"id\") ON DELETE cascade ON UPDATE no action;\n--> statement-breakpoint\nALTER TABLE \"stackbone_rag_chunks\" ADD CONSTRAINT \"stackbone_rag_chunks_document_id_fk\" FOREIGN KEY (\"document_id\") REFERENCES \"public\".\"stackbone_rag_documents\"(\"id\") ON DELETE cascade ON UPDATE no action;\n--> statement-breakpoint\nALTER TABLE \"stackbone_rag_jobs\" ADD CONSTRAINT \"stackbone_rag_jobs_collection_id_fk\" FOREIGN KEY (\"collection_id\") REFERENCES \"public\".\"stackbone_rag_collections\"(\"id\") ON DELETE cascade ON UPDATE no action;\n--> statement-breakpoint\nCREATE INDEX \"stackbone_rag_documents_collection_idx\" ON \"stackbone_rag_documents\" USING btree (\"collection_id\");\n--> statement-breakpoint\nCREATE INDEX \"stackbone_rag_documents_hash_idx\" ON \"stackbone_rag_documents\" USING btree (\"collection_id\",\"content_hash\");\n--> statement-breakpoint\nCREATE INDEX \"stackbone_rag_chunks_document_idx\" ON \"stackbone_rag_chunks\" USING btree (\"document_id\");\n--> statement-breakpoint\nCREATE INDEX \"stackbone_rag_chunks_embedding_hnsw\" ON \"stackbone_rag_chunks\" USING hnsw (\"embedding\" vector_cosine_ops);\n--> statement-breakpoint\nCREATE INDEX \"stackbone_rag_jobs_collection_idx\" ON \"stackbone_rag_jobs\" USING btree (\"collection_id\");\n--> statement-breakpoint\nCREATE INDEX \"stackbone_rag_jobs_status_idx\" ON \"stackbone_rag_jobs\" USING btree (\"status\");\n`;\n"]}

package/rag/schema.cjs

@@ -0,0 +1,124 @@
+'use strict';
+
+var drizzle_orm_star = require('drizzle-orm');
+var pg_core_star = require('drizzle-orm/pg-core');
+
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var drizzle_orm_star__namespace = /*#__PURE__*/_interopNamespace(drizzle_orm_star);
+var pg_core_star__namespace = /*#__PURE__*/_interopNamespace(pg_core_star);
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget);
+
+// src/db/index.ts
+var db_exports = {};
+__reExport(db_exports, drizzle_orm_star__namespace);
+__reExport(db_exports, pg_core_star__namespace);
+
+// src/modules/rag/schema.ts
+var RAG_EMBEDDING_DIMENSIONS = 1536;
+var STACKBONE_RAG_SCHEMA_VERSION = "v1";
+var stackboneRagCollections = (0, db_exports.pgTable)("stackbone_rag_collections", {
+  id: (0, db_exports.uuid)("id").defaultRandom().primaryKey(),
+  name: (0, db_exports.text)("name").notNull().unique(),
+  metadata: (0, db_exports.jsonb)("metadata").$type().notNull().default({}),
+  createdAt: (0, db_exports.timestamp)("created_at", {
+    withTimezone: true
+  }).notNull().defaultNow()
+});
+var stackboneRagDocuments = (0, db_exports.pgTable)("stackbone_rag_documents", {
+  id: (0, db_exports.uuid)("id").defaultRandom().primaryKey(),
+  collectionId: (0, db_exports.uuid)("collection_id").notNull().references(() => stackboneRagCollections.id, {
+    onDelete: "cascade"
+  }),
+  source: (0, db_exports.text)("source").notNull(),
+  contentHash: (0, db_exports.text)("content_hash").notNull(),
+  metadata: (0, db_exports.jsonb)("metadata").$type().notNull().default({}),
+  createdAt: (0, db_exports.timestamp)("created_at", {
+    withTimezone: true
+  }).notNull().defaultNow()
+}, (t) => ({
+  byCollection: (0, db_exports.index)("stackbone_rag_documents_collection_idx").on(t.collectionId),
+  byHash: (0, db_exports.index)("stackbone_rag_documents_hash_idx").on(t.collectionId, t.contentHash)
+}));
+var stackboneRagChunks = (0, db_exports.pgTable)("stackbone_rag_chunks", {
+  id: (0, db_exports.uuid)("id").defaultRandom().primaryKey(),
+  documentId: (0, db_exports.uuid)("document_id").notNull().references(() => stackboneRagDocuments.id, {
+    onDelete: "cascade"
+  }),
+  ordinal: (0, db_exports.integer)("ordinal").notNull(),
+  content: (0, db_exports.text)("content").notNull(),
+  embedding: (0, db_exports.vector)("embedding", {
+    dimensions: RAG_EMBEDDING_DIMENSIONS
+  }).notNull(),
+  metadata: (0, db_exports.jsonb)("metadata").$type().notNull().default({})
+}, (t) => ({
+  byDocument: (0, db_exports.index)("stackbone_rag_chunks_document_idx").on(t.documentId),
+  ann: (0, db_exports.index)("stackbone_rag_chunks_embedding_hnsw").using("hnsw", t.embedding.op("vector_cosine_ops"))
+}));
+var stackboneRagJobs = (0, db_exports.pgTable)("stackbone_rag_jobs", {
+  id: (0, db_exports.uuid)("id").defaultRandom().primaryKey(),
+  collectionId: (0, db_exports.uuid)("collection_id").notNull().references(() => stackboneRagCollections.id, {
+    onDelete: "cascade"
+  }),
+  status: (0, db_exports.text)("status", {
+    enum: [
+      "queued",
+      "running",
+      "succeeded",
+      "failed",
+      "cancelled"
+    ]
+  }).notNull().default("queued"),
+  progress: (0, db_exports.jsonb)("progress").$type().notNull().default({
+    totalChunks: 0,
+    processedChunks: 0
+  }),
+  error: (0, db_exports.text)("error"),
+  createdAt: (0, db_exports.timestamp)("created_at", {
+    withTimezone: true
+  }).notNull().defaultNow(),
+  updatedAt: (0, db_exports.timestamp)("updated_at", {
+    withTimezone: true
+  }).notNull().defaultNow()
+}, (t) => ({
+  byCollection: (0, db_exports.index)("stackbone_rag_jobs_collection_idx").on(t.collectionId),
+  byStatus: (0, db_exports.index)("stackbone_rag_jobs_status_idx").on(t.status)
+}));
+
+exports.RAG_EMBEDDING_DIMENSIONS = RAG_EMBEDDING_DIMENSIONS;
+exports.STACKBONE_RAG_SCHEMA_VERSION = STACKBONE_RAG_SCHEMA_VERSION;
+exports.stackboneRagChunks = stackboneRagChunks;
+exports.stackboneRagCollections = stackboneRagCollections;
+exports.stackboneRagDocuments = stackboneRagDocuments;
+exports.stackboneRagJobs = stackboneRagJobs;
+//# sourceMappingURL=schema.cjs.map
+//# sourceMappingURL=schema.cjs.map

package/rag/schema.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../libs/sdk/src/db/index.ts","../../../../libs/sdk/src/modules/rag/schema.ts"],"names":["pg_core_star","RAG_EMBEDDING_DIMENSIONS","STACKBONE_RAG_SCHEMA_VERSION","stackboneRagCollections","pgTable","id","uuid","defaultRandom","primaryKey","name","text","notNull","unique","metadata","jsonb","$type","default","createdAt","timestamp","withTimezone","defaultNow","stackboneRagDocuments","collectionId","references","onDelete","source","contentHash","t","byCollection","index","on","byHash","stackboneRagChunks","documentId","ordinal","integer","content","embedding","vector","dimensions","byDocument","ann","using","op","stackboneRagJobs","status","enum","progress","totalChunks","processedChunks","error","updatedAt","byStatus"],"mappings":"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","file":"schema.cjs","sourcesContent":["export * from 'drizzle-orm';\nexport * from 'drizzle-orm/pg-core';\n\n// Re-exporting both `drizzle-orm` and `drizzle-orm/pg-core` produces TS2308\n// (ambiguous re-export) for the type names below, since both barrels expose\n// them. Pinning them to the pg-core variant — the one creators write Postgres\n// schemas against — resolves the ambiguity.\nexport type {\n  ColumnsWithTable,\n  SelectedFields,\n  SelectedFieldsFlat,\n  SelectedFieldsOrdered,\n  TableConfig,\n} from 'drizzle-orm/pg-core';\n","// Single source of truth for the RAG tables installed by `stackbone db\n// migrate add-rag`. This module is **internal** — never re-exported from\n// `@stackbone/sdk`'s public barrel. Only the SDK's own RAG pipeline (slices\n// F03–F07) and the CLI (this slice) read from it.\n//\n// The bundled SQL migration in `./migrations/stackbone_rag_v1.sql` is the\n// snapshot generated from the Drizzle definitions below via\n// `drizzle-kit generate`. The two MUST stay in sync; the snapshot test in\n// `schema.spec.ts` pins the expected table/column shape so a drift in the\n// hand-maintained SQL is caught at CI.\n//\n// Column helpers come from `@stackbone/sdk/db` (its public re-export of\n// `drizzle-orm/pg-core`) so creators and the SDK use the exact same `vector`\n// implementation. Importing directly from `drizzle-orm/pg-core` here would\n// fork the chain; routing through the SDK's barrel is the canonical path\n// locked in ADR 2026-05-10 §D1.\nimport { index, integer, jsonb, pgTable, text, timestamp, uuid, vector } from '../../db';\n\nexport type RagJobStatus = 'queued' | 'running' | 'succeeded' | 'failed' | 'cancelled';\n\nexport interface RagJobProgress {\n  totalChunks: number;\n  processedChunks: number;\n  currentDocument?: { source: string; ordinal: number };\n}\n\n/** Embedding vector dimension — atado a `openai/text-embedding-3-small` (ADR §D2). */\nexport const RAG_EMBEDDING_DIMENSIONS = 1536;\n\n/** Schema major version. Bumped only on breaking change (ADR §D4). */\nexport const STACKBONE_RAG_SCHEMA_VERSION = 'v1';\n\nexport const stackboneRagCollections = pgTable('stackbone_rag_collections', {\n  id: uuid('id').defaultRandom().primaryKey(),\n  name: text('name').notNull().unique(),\n  metadata: jsonb('metadata').$type<Record<string, unknown>>().notNull().default({}),\n  createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),\n});\n\nexport const stackboneRagDocuments = pgTable(\n  'stackbone_rag_documents',\n  {\n    id: uuid('id').defaultRandom().primaryKey(),\n    collectionId: uuid('collection_id')\n      .notNull()\n      .references(() => stackboneRagCollections.id, { onDelete: 'cascade' }),\n    source: text('source').notNull(),\n    contentHash: text('content_hash').notNull(),\n    metadata: jsonb('metadata').$type<Record<string, unknown>>().notNull().default({}),\n    createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),\n  },\n  (t) => ({\n    byCollection: index('stackbone_rag_documents_collection_idx').on(t.collectionId),\n    byHash: index('stackbone_rag_documents_hash_idx').on(t.collectionId, t.contentHash),\n  }),\n);\n\nexport const stackboneRagChunks = pgTable(\n  'stackbone_rag_chunks',\n  {\n    id: uuid('id').defaultRandom().primaryKey(),\n    documentId: uuid('document_id')\n      .notNull()\n      .references(() => stackboneRagDocuments.id, { onDelete: 'cascade' }),\n    ordinal: integer('ordinal').notNull(),\n    content: text('content').notNull(),\n    embedding: vector('embedding', { dimensions: RAG_EMBEDDING_DIMENSIONS }).notNull(),\n    metadata: jsonb('metadata').$type<Record<string, unknown>>().notNull().default({}),\n  },\n  (t) => ({\n    byDocument: index('stackbone_rag_chunks_document_idx').on(t.documentId),\n    ann: index('stackbone_rag_chunks_embedding_hnsw').using(\n      'hnsw',\n      t.embedding.op('vector_cosine_ops'),\n    ),\n  }),\n);\n\nexport const stackboneRagJobs = pgTable(\n  'stackbone_rag_jobs',\n  {\n    id: uuid('id').defaultRandom().primaryKey(),\n    collectionId: uuid('collection_id')\n      .notNull()\n      .references(() => stackboneRagCollections.id, { onDelete: 'cascade' }),\n    status: text('status', {\n      enum: ['queued', 'running', 'succeeded', 'failed', 'cancelled'],\n    })\n      .notNull()\n      .default('queued'),\n    progress: jsonb('progress')\n      .$type<RagJobProgress>()\n      .notNull()\n      .default({ totalChunks: 0, processedChunks: 0 }),\n    error: text('error'),\n    createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),\n    updatedAt: timestamp('updated_at', { withTimezone: true }).notNull().defaultNow(),\n  },\n  (t) => ({\n    byCollection: index('stackbone_rag_jobs_collection_idx').on(t.collectionId),\n    byStatus: index('stackbone_rag_jobs_status_idx').on(t.status),\n  }),\n);\n"]}