@@ -115,7 +115,7 @@ jobs:
           - batch: graphile-unit
             packages: 'graphile/graphile-plugin-utils graphile/graphile-realtime-subscriptions graphile/graphile-sql-expression-validator graphile/graphile-upload-plugin'
           - batch: agentic
-            packages: 'agentic/protocol agentic/agentic-kit agentic/agent agentic/harness agentic/chat agentic/cli agentic/pi agentic/react agentic/agentic-server agentic/anthropic agentic/openai agentic/ollama agentic/run-log agentic/metering'
+            packages: 'agentic/protocol agentic/agentic-kit agentic/agent agentic/harness agentic/chat agentic/cli agentic/db-tools agentic/pi agentic/react agentic/agentic-server agentic/anthropic agentic/openai agentic/ollama agentic/run-log agentic/metering'
           - batch: pgpm-unit
             packages: 'pgpm/types pgpm/naming-spec pgpm/diff pgpm/import pgpm/slice pgpm/transform'
           - batch: pglite
 
@@ -0,0 +1,68 @@
+# @agentic-kit/db-tools
+
+<p align="center" width="100%">
+  <img height="250" src="https://raw.githubusercontent.com/constructive-io/constructive/refs/heads/main/assets/outline-logo.svg" />
+</p>
+
+<p align="center" width="100%">
+  <a href="https://github.com/constructive-io/constructive/actions/workflows/run-tests.yaml">
+    <img height="20" src="https://github.com/constructive-io/constructive/actions/workflows/run-tests.yaml/badge.svg" />
+  </a>
+   <a href="https://github.com/constructive-io/constructive/blob/main/LICENSE"><img height="20" src="https://img.shields.io/badge/license-MIT-blue.svg"/></a>
+   <a href="https://www.npmjs.com/package/@agentic-kit/db-tools"><img height="20" src="https://img.shields.io/github/package-json/v/constructive-io/constructive?filename=agentic%2Fdb-tools%2Fpackage.json"/></a>
+</p>
+
+The Constructive typed database tools, as **harness-neutral** [`HarnessTool`](https://www.npmjs.com/package/@agentic-kit/harness)s: zod parameters, `execute(params, { cwd, signal })`, and no coding-agent SDK anywhere in the package. Binding them to a harness is the *adapter's* job — [`@agentic-kit/pi`](https://www.npmjs.com/package/@agentic-kit/pi) does it with `toPiTool()` — so a second, compatible harness registers the same 18 tools without a fork.
+
+```
+@agentic-kit/db-tools ──► @agentic-kit/harness (HarnessTool)
+        ▲
+        ├── @agentic-kit/pi        toPiTool()  ──► pi's ToolDefinition
+        └── your adapter           toXTool()   ──► your harness's tool shape
+```
+
+```bash
+npm install @agentic-kit/db-tools
+```
+
+## What's inside
+
+- **18 typed db tools** — `provision_database`, `provision_blueprint`, `describe_schema`, `add_relation`, `delete_table`, `create_field` / `update_field` / `delete_field`, `add_policies`, `add_records`, `manage_entity_types`, `create_api_key`, `run_codegen`, and the template suite (`list` / `create` / `apply` / `update` / `delete`). `constructiveDbTools` is the list, in registration order.
+- **Host injection** — credentials, backend endpoints and data-plane tokens come from the host application, not from the package. Call `configureHost()` once at startup; the tools read it lazily per call.
+- **Project context** — `resolveProjectContext` / `resolveDataToken` resolve the database a tool acts on from the cwd's `.env` plus the host's session, and `deriveSubdomainEndpoint` derives its per-database endpoints.
+- **Provisioning model** — the pinned `node-type-registry` presets, the provision manifest, and overlay resolution (`resolveProvisionModules`).
+- **`toolSchema`** — a tool's zod parameters as plain JSON Schema, for adapters whose harness wants JSON Schema rather than zod.
+
+## Usage
+
+```ts
+import { configureHost, constructiveDbTools } from '@agentic-kit/db-tools';
+
+configureHost({
+  account: () => ({ userId, accessToken }),
+  backendConfig: () => ({ apiEndpoint, modulesEndpoint }),
+  signInHint: 'Run `agent login` to sign in.'
+});
+
+for (const tool of constructiveDbTools) {
+  myHarness.registerTool(myToolBinding(tool));
+}
+```
+
+A tool executes against nothing but its params and a context, so it is callable directly — which is also how the tests drive it:
+
+```ts
+const result = await describeSchemaTool.execute({ database_name: 'my-app' }, { cwd: process.cwd() });
+```
+
+## Related
+
+| Package | Role |
+| --- | --- |
+| [`@agentic-kit/harness`](https://www.npmjs.com/package/@agentic-kit/harness) | the neutral contracts: `HarnessTool`, `HarnessAdapter`, the run gate |
+| [`@agentic-kit/pi`](https://www.npmjs.com/package/@agentic-kit/pi) | the pi adapter: binds these tools and attaches a run's lanes to a pi session |
+| [`@agentic-kit/cli`](https://www.npmjs.com/package/@agentic-kit/cli) | the `agent` CLI, which materializes the tools into a pi agent dir |
+
+## License
+
+SEE LICENSE IN LICENSE
@@ -0,0 +1,43 @@
+import { execFileSync } from 'node:child_process';
+import path from 'node:path';
+
+const packageRoot = path.join(__dirname, '..');
+
+describe('the db tools package', () => {
+  it('names no harness in its dependencies', () => {
+    const pkg = require(path.join(packageRoot, 'package.json')) as {
+      dependencies?: Record<string, string>;
+      peerDependencies?: Record<string, string>;
+      devDependencies?: Record<string, string>;
+    };
+    const deps = Object.keys({
+      ...pkg.dependencies,
+      ...pkg.peerDependencies,
+      ...pkg.devDependencies
+    });
+
+    expect(deps.filter((dep) => dep.startsWith('@earendil-works/'))).toEqual([]);
+    expect(deps).not.toContain('@agentic-kit/pi');
+  });
+
+  it('imports no harness SDK in any source file', () => {
+    // grep -l exits 1 with no output when nothing matches, which is the pass.
+    let matches = '';
+    try {
+      matches = execFileSync(
+        'grep',
+        [
+          '-rlE',
+          "(from|require\\()\\s*'(@earendil-works/|@agentic-kit/pi)",
+          'src'
+        ],
+        { cwd: packageRoot, encoding: 'utf8' }
+      );
+    } catch (err) {
+      const status = (err as { status?: number }).status;
+      if (status !== 1) throw err;
+    }
+
+    expect(matches.trim()).toBe('');
+  });
+});
@@ -1,6 +1,11 @@
 import { z } from 'zod';
 
-import dbTools, { configureHost, createDbTools, getHost, toolSchema } from '../src';
+import constructiveDbTools, {
+  configureHost,
+  createConstructiveDbTools,
+  getHost,
+  toolSchema
+} from '../src';
 
 describe('host configuration', () => {
   it('getHost throws before configureHost', () => {
@@ -17,12 +22,12 @@ describe('host configuration', () => {
     expect(getHost().account()?.userId).toBe('u1');
   });
 
-  it('createDbTools configures the host and returns the extension', () => {
+  it('createConstructiveDbTools configures the host and returns the tools', () => {
     const host = {
       account: (): null => null,
       backendConfig: (): null => null,
     };
-    expect(createDbTools(host)).toBe(dbTools);
+    expect(createConstructiveDbTools(host)).toBe(constructiveDbTools);
     expect(getHost()).toBe(host);
   });
 });
@@ -44,18 +49,10 @@ describe('toolSchema', () => {
   });
 });
 
-describe('dbTools extension', () => {
-  it('registers the 18 tools and both gate events', () => {
-    const registered: string[] = [];
-    const events: string[] = [];
-    const fakePi = {
-      registerTool: (tool: { name: string }) => registered.push(tool.name),
-      on: (event: string) => events.push(event),
-    };
-    (dbTools as (pi: unknown) => void)(fakePi);
-
-    expect(registered).toHaveLength(18);
-    expect(registered).toEqual(
+describe('constructiveDbTools', () => {
+  it('is the 18 db tools, harness-neutral', () => {
+    expect(constructiveDbTools).toHaveLength(18);
+    expect(constructiveDbTools.map((tool) => tool.name)).toEqual(
       expect.arrayContaining([
         'provision_database',
         'provision_blueprint',
@@ -77,6 +74,9 @@ describe('dbTools extension', () => {
         'delete_template',
       ]),
     );
-    expect(events).toEqual(['agent_start', 'tool_call']);
+    for (const tool of constructiveDbTools) {
+      expect(typeof tool.execute).toBe('function');
+      expect(tool.parameters).toBeDefined();
+    }
   });
 });