@adhd/agent-core-provider 2.1.0

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@adhd/agent-core-provider",
+  "version": "2.1.0",
+  "description": "Provider registry: adapters, model catalog, and tool-format emitter for @adhd/agent-mcp",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "src",
+    "drizzle"
+  ],
+  "exports": {
+    ".": {
+      "types": "./src/index.d.ts",
+      "default": "./src/index.js"
+    }
+  },
+  "scripts": {
+    "build": "nx build agent-provider",
+    "dev": "nx build agent-provider --watch",
+    "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",
+    "@adhd/agent-base-types": "^2.1.0"
+  },
+  "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",
+    "vite-plugin-dts": "~3.8.3",
+    "vitest": "^1.6.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/PseudoSky/adhd.git",
+    "directory": "packages/agent/agent-core-provider"
+  },
+  "homepage": "https://github.com/PseudoSky/adhd/tree/main/packages/agent/agent-core-provider#readme",
+  "bugs": {
+    "url": "https://github.com/PseudoSky/adhd/issues"
+  },
+  "module": "./src/index.js",
+  "main": "./src/index.js"
+}

package/src/adapter/provider-adapter.d.ts

@@ -0,0 +1,21 @@
+import type { Message, ToolDefinition, StreamChunk, ProviderAdapter as IProviderAdapter } from '@adhd/agent-base-types';
+import { ModelStore } from '../store/model-store.js';
+export declare class ProviderAdapterImpl implements IProviderAdapter {
+    private readonly store;
+    private readonly platform;
+    constructor(store: ModelStore, platform: string);
+    /**
+     * Resolve the canonical model id to a per-platform string via the binding
+     * table, then yield a single informational chunk.
+     *
+     * The resolved id is surfaced in the first (and only) text chunk so that
+     * tests can assert the correct resolution without live API calls.
+     */
+    stream(_messages: Message[], _tools: ToolDefinition[] | undefined, model: string): AsyncIterable<StreamChunk>;
+    /**
+     * Expose the resolved model id without consuming the stream.
+     * Convenience method for tests to assert resolution directly.
+     */
+    resolveModelId(canonicalId: string): string;
+}
+//# sourceMappingURL=provider-adapter.d.ts.map

package/src/adapter/provider-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-adapter.d.ts","sourceRoot":"","sources":["../../../../../../packages/agent/agent-core-provider/src/adapter/provider-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,cAAc,EACd,WAAW,EACX,eAAe,IAAI,gBAAgB,EACpC,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAcrD,qBAAa,mBAAoB,YAAW,gBAAgB;IAC1D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM;IAK/C;;;;;;OAMG;IACI,MAAM,CACX,SAAS,EAAE,OAAO,EAAE,EACpB,MAAM,EAAE,cAAc,EAAE,GAAG,SAAS,EACpC,KAAK,EAAE,MAAM,GACZ,aAAa,CAAC,WAAW,CAAC;IAK7B;;;OAGG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;CAG5C"}

package/src/adapter/provider-adapter.js

@@ -0,0 +1,38 @@
+// ──────────────────────────────────────────────────────────────────────────────
+// ProviderAdapter — thin implementation
+//
+// The class IMPLEMENTS `ProviderAdapter` (from @adhd/agent-base-types) — it
+// does NOT re-declare the interface here.  Dependency direction:
+//   agent-mcp-types ← agent-provider ← agent-mcp
+//
+// The stream() body is intentionally a minimal stub: the contract this state
+// tests is MODEL RESOLUTION through the binding table, not live LLM streaming.
+// Concrete streaming is delivered by a later plan state.
+// ──────────────────────────────────────────────────────────────────────────────
+export class ProviderAdapterImpl {
+    store;
+    platform;
+    constructor(store, platform) {
+        this.store = store;
+        this.platform = platform;
+    }
+    /**
+     * Resolve the canonical model id to a per-platform string via the binding
+     * table, then yield a single informational chunk.
+     *
+     * The resolved id is surfaced in the first (and only) text chunk so that
+     * tests can assert the correct resolution without live API calls.
+     */
+    async *stream(_messages, _tools, model) {
+        const resolvedModelId = this.store.resolveModelId(model, this.platform);
+        yield { type: 'text', text: resolvedModelId };
+    }
+    /**
+     * Expose the resolved model id without consuming the stream.
+     * Convenience method for tests to assert resolution directly.
+     */
+    resolveModelId(canonicalId) {
+        return this.store.resolveModelId(canonicalId, this.platform);
+    }
+}
+//# sourceMappingURL=provider-adapter.js.map

package/src/adapter/provider-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-adapter.js","sourceRoot":"","sources":["../../../../../../packages/agent/agent-core-provider/src/adapter/provider-adapter.ts"],"names":[],"mappings":"AASA,iFAAiF;AACjF,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,iEAAiE;AACjE,iDAAiD;AACjD,EAAE;AACF,6EAA6E;AAC7E,+EAA+E;AAC/E,yDAAyD;AACzD,iFAAiF;AAEjF,MAAM,OAAO,mBAAmB;IACb,KAAK,CAAa;IAClB,QAAQ,CAAS;IAElC,YAAY,KAAiB,EAAE,QAAgB;QAC7C,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,CAAC,MAAM,CACX,SAAoB,EACpB,MAAoC,EACpC,KAAa;QAEb,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;IAChD,CAAC;IAED;;;OAGG;IACH,cAAc,CAAC,WAAmB;QAChC,OAAO,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC/D,CAAC;CACF"}

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-core-provider/src/db/client.ts"],"names":[],"mappings":"AAIA,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,19 @@
+import fs from 'node:fs';
+import os from 'node:os';
+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'] || path.join(os.homedir(), '.adhd', 'agent-core-provider', 'agents.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-core-provider/src/db/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,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,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,qBAAqB,EAAE,WAAW,CAAC,CAAC;AAE1H,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. The only way to toggle FK enforcement for the whole migration run is to
+ * disable it on the connection *before* migrate() — while no transaction is
+ * open — then 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-core-provider/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. The only way to toggle FK enforcement for the whole migration run is to
+ * disable it on the connection *before* migrate() — while no transaction is
+ * open — then 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-core-provider/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-core-provider/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-core-provider/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"}