@adhd/agent-store-tools 2.1.0

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@adhd/agent-store-tools",
+  "version": "2.1.0",
+  "description": "Canonical tool and platform registry for agent runtimes — Drizzle-backed SQLite store",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "src",
+    "drizzle"
+  ],
+  "exports": {
+    ".": {
+      "types": "./src/index.d.ts",
+      "default": "./src/index.js"
+    }
+  },
+  "scripts": {
+    "build": "nx build agent-tool-registry",
+    "typecheck": "tsc -p tsconfig.lib.json --noEmit",
+    "db:generate": "drizzle-kit generate",
+    "db:migrate": "drizzle-kit migrate"
+  },
+  "dependencies": {
+    "better-sqlite3": "12.10.0",
+    "drizzle-orm": "0.45.2"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@vitest/coverage-v8": "^1.0.4",
+    "drizzle-kit": "^0.31.10",
+    "tslib": "^2.6.0",
+    "typescript": "^5.5.0",
+    "vite": "~5.0.13",
+    "vitest": "^1.6.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/PseudoSky/adhd.git",
+    "directory": "packages/agent/agent-store-tools"
+  },
+  "homepage": "https://github.com/PseudoSky/adhd/tree/main/packages/agent/agent-store-tools#readme",
+  "bugs": {
+    "url": "https://github.com/PseudoSky/adhd/issues"
+  },
+  "module": "./src/index.js",
+  "main": "./src/index.js"
+}

package/src/db/client.d.ts

@@ -0,0 +1,7 @@
+import Database from 'better-sqlite3';
+import * as schema from './schema.js';
+export declare const sqlite: Database.Database;
+export declare const db: import("drizzle-orm/better-sqlite3").BetterSQLite3Database<typeof schema> & {
+    $client: Database.Database;
+};
+//# sourceMappingURL=client.d.ts.map

package/src/db/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../../../packages/agent/agent-store-tools/src/db/client.ts"],"names":[],"mappings":"AAGA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAGtC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AActC,eAAO,MAAM,MAAM,EAAE,QAAQ,CAAC,QAAqC,CAAC;AAKpE,eAAO,MAAM,EAAE;;CAA8B,CAAC"}

package/src/db/client.js

@@ -0,0 +1,18 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import Database from 'better-sqlite3';
+import { drizzle } from 'drizzle-orm/better-sqlite3';
+import * as schema from './schema.js';
+const databasePath = process.env['DATABASE_PATH'] || './data/registry.db';
+const resolvedPath = path.resolve(databasePath);
+const directory = path.dirname(resolvedPath);
+if (!fs.existsSync(directory)) {
+    fs.mkdirSync(directory, {
+        recursive: true,
+    });
+}
+export const sqlite = new Database(resolvedPath);
+sqlite.pragma('journal_mode = WAL');
+sqlite.pragma('foreign_keys = ON');
+export const db = drizzle(sqlite, { schema });
+//# sourceMappingURL=client.js.map

package/src/db/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../../../../packages/agent/agent-store-tools/src/db/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAErD,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAEtC,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,oBAAoB,CAAC;AAE1E,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;AAEhD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;AAE7C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;IAC9B,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE;QACtB,SAAS,EAAE,IAAI;KAChB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAsB,IAAI,QAAQ,CAAC,YAAY,CAAC,CAAC;AAEpE,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;AACpC,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;AAEnC,MAAM,CAAC,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC"}

package/src/db/migrate-runner.d.ts

@@ -0,0 +1,30 @@
+import { migrate } from 'drizzle-orm/better-sqlite3/migrator';
+/**
+ * Folder holding the drizzle-kit generated migrations (../../drizzle relative
+ * to this compiled module). Kept here — with no `client.js` import — so test
+ * harnesses can reuse the FK-safe runner without dragging in the production
+ * singleton connection (which opens a DB file at import time).
+ */
+export declare const MIGRATIONS_FOLDER: string;
+/**
+ * Minimal structural type for the bits of a better-sqlite3 connection we need.
+ * Avoids importing the better-sqlite3 type just to call `pragma`.
+ */
+interface PragmaConn {
+    pragma(source: string, options?: {
+        simple: boolean;
+    }): unknown;
+}
+/**
+ * Run Drizzle migrations against an explicit connection with foreign-key
+ * enforcement disabled for the duration of the run.
+ *
+ * WHY THIS WRAPPER EXISTS: SQLite silently ignores `PRAGMA foreign_keys`
+ * **inside a transaction**, and drizzle's migrator wraps each migration file in
+ * one. Disabling enforcement on the connection *before* migrate() — while no
+ * transaction is open — is the only way to make it hold for the whole run;
+ * we restore the prior setting afterwards.
+ */
+export declare function runMigrationsOn(conn: PragmaConn, drizzleDb: Parameters<typeof migrate>[0], migrationsFolder?: string): void;
+export {};
+//# sourceMappingURL=migrate-runner.d.ts.map

package/src/db/migrate-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-runner.d.ts","sourceRoot":"","sources":["../../../../../../packages/agent/agent-store-tools/src/db/migrate-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,qCAAqC,CAAC;AAE9D;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,QACnB,CAAC;AAEZ;;;GAGG;AACH,UAAU,UAAU;IAClB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC;CAChE;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,UAAU,EAChB,SAAS,EAAE,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,EACxC,gBAAgB,GAAE,MAA0B,GAC3C,IAAI,CAcN"}

package/src/db/migrate-runner.js

@@ -0,0 +1,34 @@
+import { migrate } from 'drizzle-orm/better-sqlite3/migrator';
+/**
+ * Folder holding the drizzle-kit generated migrations (../../drizzle relative
+ * to this compiled module). Kept here — with no `client.js` import — so test
+ * harnesses can reuse the FK-safe runner without dragging in the production
+ * singleton connection (which opens a DB file at import time).
+ */
+export const MIGRATIONS_FOLDER = new URL('../../drizzle', import.meta.url)
+    .pathname;
+/**
+ * Run Drizzle migrations against an explicit connection with foreign-key
+ * enforcement disabled for the duration of the run.
+ *
+ * WHY THIS WRAPPER EXISTS: SQLite silently ignores `PRAGMA foreign_keys`
+ * **inside a transaction**, and drizzle's migrator wraps each migration file in
+ * one. Disabling enforcement on the connection *before* migrate() — while no
+ * transaction is open — is the only way to make it hold for the whole run;
+ * we restore the prior setting afterwards.
+ */
+export function runMigrationsOn(conn, drizzleDb, migrationsFolder = MIGRATIONS_FOLDER) {
+    const fkWasOn = conn.pragma('foreign_keys', { simple: true }) === 1;
+    if (fkWasOn) {
+        conn.pragma('foreign_keys = OFF');
+    }
+    try {
+        migrate(drizzleDb, { migrationsFolder });
+    }
+    finally {
+        if (fkWasOn) {
+            conn.pragma('foreign_keys = ON');
+        }
+    }
+}
+//# sourceMappingURL=migrate-runner.js.map

package/src/db/migrate-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-runner.js","sourceRoot":"","sources":["../../../../../../packages/agent/agent-store-tools/src/db/migrate-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,qCAAqC,CAAC;AAE9D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,eAAe,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;KACvE,QAAQ,CAAC;AAUZ;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAgB,EAChB,SAAwC,EACxC,mBAA2B,iBAAiB;IAE5C,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC;IAEpE,IAAI,OAAO,EAAE,CAAC;QACZ,IAAI,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IACpC,CAAC;IAED,IAAI,CAAC;QACH,OAAO,CAAC,SAAS,EAAE,EAAE,gBAAgB,EAAE,CAAC,CAAC;IAC3C,CAAC;YAAS,CAAC;QACT,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;AACH,CAAC"}

package/src/db/migrate.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Runs pending Drizzle migrations synchronously before the server starts.
+ * Migrations are read from the ./drizzle folder (generated by drizzle-kit).
+ *
+ * Delegates to the FK-safe {@link runMigrationsOn} runner (see that module for
+ * why foreign-key enforcement must be toggled around the migration run).
+ */
+export declare function runMigrations(): void;
+//# sourceMappingURL=migrate.d.ts.map

package/src/db/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../../../../../packages/agent/agent-store-tools/src/db/migrate.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAEpC"}

package/src/db/migrate.js

@@ -0,0 +1,13 @@
+import { db, sqlite } from './client.js';
+import { runMigrationsOn } from './migrate-runner.js';
+/**
+ * Runs pending Drizzle migrations synchronously before the server starts.
+ * Migrations are read from the ./drizzle folder (generated by drizzle-kit).
+ *
+ * Delegates to the FK-safe {@link runMigrationsOn} runner (see that module for
+ * why foreign-key enforcement must be toggled around the migration run).
+ */
+export function runMigrations() {
+    runMigrationsOn(sqlite, db);
+}
+//# sourceMappingURL=migrate.js.map

package/src/db/migrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.js","sourceRoot":"","sources":["../../../../../../packages/agent/agent-store-tools/src/db/migrate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD;;;;;;GAMG;AACH,MAAM,UAAU,aAAa;IAC3B,eAAe,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAC9B,CAAC"}