@agentic-kit/db-tools 0.2.0 → 0.3.0

package/README.md

@@ -31,6 +31,7 @@ npm install @agentic-kit/db-tools
 - **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`).
+- **`constructiveGateDeps`** — the confirm gate's host capabilities (is the project runnable, is there a data token, what tables would a template copy) answered by these resolvers, so every adapter gates the same tools against the same project state instead of restating it.
 - **`toolSchema`** — a tool's zod parameters as plain JSON Schema, for adapters whose harness wants JSON Schema rather than zod.
 
 ## Usage

package/esm/gate.d.ts

@@ -0,0 +1,18 @@
+import type { ConstructiveGateDeps } from '@agentic-kit/harness';
+import { resolveDataToken as defaultResolveDataToken, resolveProjectContext as defaultResolveProjectContext } from './context';
+import { createTemplatePreviewTables as defaultCreateTemplatePreviewTables } from './tools/templates';
+/** The resolvers the deps are built from, so a test can substitute fakes. */
+export type ConstructiveGateResolvers = {
+    resolveProjectContext: typeof defaultResolveProjectContext;
+    resolveDataToken: typeof defaultResolveDataToken;
+    createTemplatePreviewTables: typeof defaultCreateTemplatePreviewTables;
+};
+/**
+ * The Constructive gate's host capabilities, answered by this package's own
+ * project/token/template resolvers.
+ *
+ * Every adapter gates the same tools against the same project state, so the
+ * mapping lives here rather than once per harness — an adapter's job is only
+ * to hand its harness's confirm surface to the gate.
+ */
+export declare function constructiveGateDeps(resolvers?: Partial<ConstructiveGateResolvers>): ConstructiveGateDeps;

package/esm/gate.js

@@ -0,0 +1,39 @@
+import { resolveDataToken as defaultResolveDataToken, resolveProjectContext as defaultResolveProjectContext, } from './context';
+import { createTemplatePreviewTables as defaultCreateTemplatePreviewTables } from './tools/templates';
+/**
+ * The Constructive gate's host capabilities, answered by this package's own
+ * project/token/template resolvers.
+ *
+ * Every adapter gates the same tools against the same project state, so the
+ * mapping lives here rather than once per harness — an adapter's job is only
+ * to hand its harness's confirm surface to the gate.
+ */
+export function constructiveGateDeps(resolvers = {}) {
+    const resolveProjectContext = resolvers.resolveProjectContext ?? defaultResolveProjectContext;
+    const resolveDataToken = resolvers.resolveDataToken ?? defaultResolveDataToken;
+    const createTemplatePreviewTables = resolvers.createTemplatePreviewTables ?? defaultCreateTemplatePreviewTables;
+    const context = async (cwd) => (await resolveProjectContext(cwd)).context;
+    return {
+        isProjectRunnable: async (cwd) => (await context(cwd)) !== null,
+        hasDataToken: async (cwd) => {
+            const resolved = await context(cwd);
+            if (!resolved)
+                return false;
+            return Boolean((await resolveDataToken(resolved)).token);
+        },
+        resolveTemplatePreview: async (cwd, blueprintName, displayName) => {
+            const resolved = await context(cwd);
+            if (!resolved)
+                return undefined;
+            const result = await createTemplatePreviewTables(resolved, blueprintName);
+            if (result.tables.length === 0)
+                return undefined;
+            return {
+                kind: 'template',
+                displayName,
+                blueprintName: result.blueprintName || undefined,
+                tables: result.tables,
+            };
+        },
+    };
+}

package/esm/index.d.ts

@@ -11,6 +11,7 @@ export declare const constructiveDbTools: readonly AnyHarnessTool[];
 /** Configure the host and get the tools in one call. */
 export declare function createConstructiveDbTools(host: ToolsHost): readonly AnyHarnessTool[];
 export { CONTEXT_ENV_KEYS, CONTEXT_ENV_PREFIX, type ContextEnvKey, type ContextSource, deriveSubdomainEndpoint, fromEnvFile, fromEnvironment, type ModulesClient, type ProjectContext, type ProjectContextFailureCode, resolveDataToken, resolveProjectContext, } from './context';
+export { constructiveGateDeps, type ConstructiveGateResolvers } from './gate';
 export { type ActiveDataToken, configureHost, type DataAuthBroker, DEFAULT_DATA_TOKEN_SKEW_MS, getHost, type HostAccount, type HostBackendConfig, type HostProvisionOverlay, type PreviewToken, type SecretDelivery, type StepUpRequest, type ToolsHost, } from './host';
 export { loadProvisionManifest, parseProvisionManifest, PROVISION_MANIFEST_FILE, type ProvisionManifest, } from './provision-database/manifest';
 export { allModulePresets, DEFAULT_PROVISION_PRESET, getModulePreset, type ModulePreset, type ProvisionModule, } from './provision-database/presets';

package/esm/index.js

@@ -43,6 +43,7 @@ export function createConstructiveDbTools(host) {
     return constructiveDbTools;
 }
 export { CONTEXT_ENV_KEYS, CONTEXT_ENV_PREFIX, deriveSubdomainEndpoint, fromEnvFile, fromEnvironment, resolveDataToken, resolveProjectContext, } from './context';
+export { constructiveGateDeps } from './gate';
 export { configureHost, DEFAULT_DATA_TOKEN_SKEW_MS, getHost, } from './host';
 export { loadProvisionManifest, parseProvisionManifest, PROVISION_MANIFEST_FILE, } from './provision-database/manifest';
 export { allModulePresets, DEFAULT_PROVISION_PRESET, getModulePreset, } from './provision-database/presets';

package/gate.d.ts

@@ -0,0 +1,18 @@
+import type { ConstructiveGateDeps } from '@agentic-kit/harness';
+import { resolveDataToken as defaultResolveDataToken, resolveProjectContext as defaultResolveProjectContext } from './context';
+import { createTemplatePreviewTables as defaultCreateTemplatePreviewTables } from './tools/templates';
+/** The resolvers the deps are built from, so a test can substitute fakes. */
+export type ConstructiveGateResolvers = {
+    resolveProjectContext: typeof defaultResolveProjectContext;
+    resolveDataToken: typeof defaultResolveDataToken;
+    createTemplatePreviewTables: typeof defaultCreateTemplatePreviewTables;
+};
+/**
+ * The Constructive gate's host capabilities, answered by this package's own
+ * project/token/template resolvers.
+ *
+ * Every adapter gates the same tools against the same project state, so the
+ * mapping lives here rather than once per harness — an adapter's job is only
+ * to hand its harness's confirm surface to the gate.
+ */
+export declare function constructiveGateDeps(resolvers?: Partial<ConstructiveGateResolvers>): ConstructiveGateDeps;

package/gate.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.constructiveGateDeps = constructiveGateDeps;
+const context_1 = require("./context");
+const templates_1 = require("./tools/templates");
+/**
+ * The Constructive gate's host capabilities, answered by this package's own
+ * project/token/template resolvers.
+ *
+ * Every adapter gates the same tools against the same project state, so the
+ * mapping lives here rather than once per harness — an adapter's job is only
+ * to hand its harness's confirm surface to the gate.
+ */
+function constructiveGateDeps(resolvers = {}) {
+    const resolveProjectContext = resolvers.resolveProjectContext ?? context_1.resolveProjectContext;
+    const resolveDataToken = resolvers.resolveDataToken ?? context_1.resolveDataToken;
+    const createTemplatePreviewTables = resolvers.createTemplatePreviewTables ?? templates_1.createTemplatePreviewTables;
+    const context = async (cwd) => (await resolveProjectContext(cwd)).context;
+    return {
+        isProjectRunnable: async (cwd) => (await context(cwd)) !== null,
+        hasDataToken: async (cwd) => {
+            const resolved = await context(cwd);
+            if (!resolved)
+                return false;
+            return Boolean((await resolveDataToken(resolved)).token);
+        },
+        resolveTemplatePreview: async (cwd, blueprintName, displayName) => {
+            const resolved = await context(cwd);
+            if (!resolved)
+                return undefined;
+            const result = await createTemplatePreviewTables(resolved, blueprintName);
+            if (result.tables.length === 0)
+                return undefined;
+            return {
+                kind: 'template',
+                displayName,
+                blueprintName: result.blueprintName || undefined,
+                tables: result.tables,
+            };
+        },
+    };
+}

package/index.d.ts

@@ -11,6 +11,7 @@ export declare const constructiveDbTools: readonly AnyHarnessTool[];
 /** Configure the host and get the tools in one call. */
 export declare function createConstructiveDbTools(host: ToolsHost): readonly AnyHarnessTool[];
 export { CONTEXT_ENV_KEYS, CONTEXT_ENV_PREFIX, type ContextEnvKey, type ContextSource, deriveSubdomainEndpoint, fromEnvFile, fromEnvironment, type ModulesClient, type ProjectContext, type ProjectContextFailureCode, resolveDataToken, resolveProjectContext, } from './context';
+export { constructiveGateDeps, type ConstructiveGateResolvers } from './gate';
 export { type ActiveDataToken, configureHost, type DataAuthBroker, DEFAULT_DATA_TOKEN_SKEW_MS, getHost, type HostAccount, type HostBackendConfig, type HostProvisionOverlay, type PreviewToken, type SecretDelivery, type StepUpRequest, type ToolsHost, } from './host';
 export { loadProvisionManifest, parseProvisionManifest, PROVISION_MANIFEST_FILE, type ProvisionManifest, } from './provision-database/manifest';
 export { allModulePresets, DEFAULT_PROVISION_PRESET, getModulePreset, type ModulePreset, type ProvisionModule, } from './provision-database/presets';

package/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createTemplatePreviewTables = exports.toolSchema = exports.resolveProvisionModules = exports.moduleKey = exports.getModulePreset = exports.DEFAULT_PROVISION_PRESET = exports.allModulePresets = exports.PROVISION_MANIFEST_FILE = exports.parseProvisionManifest = exports.loadProvisionManifest = exports.getHost = exports.DEFAULT_DATA_TOKEN_SKEW_MS = exports.configureHost = exports.resolveProjectContext = exports.resolveDataToken = exports.fromEnvironment = exports.fromEnvFile = exports.deriveSubdomainEndpoint = exports.CONTEXT_ENV_PREFIX = exports.CONTEXT_ENV_KEYS = exports.constructiveDbTools = void 0;
+exports.createTemplatePreviewTables = exports.toolSchema = exports.resolveProvisionModules = exports.moduleKey = exports.getModulePreset = exports.DEFAULT_PROVISION_PRESET = exports.allModulePresets = exports.PROVISION_MANIFEST_FILE = exports.parseProvisionManifest = exports.loadProvisionManifest = exports.getHost = exports.DEFAULT_DATA_TOKEN_SKEW_MS = exports.configureHost = exports.constructiveGateDeps = exports.resolveProjectContext = exports.resolveDataToken = exports.fromEnvironment = exports.fromEnvFile = exports.deriveSubdomainEndpoint = exports.CONTEXT_ENV_PREFIX = exports.CONTEXT_ENV_KEYS = exports.constructiveDbTools = void 0;
 exports.createConstructiveDbTools = createConstructiveDbTools;
 const host_1 = require("./host");
 const add_policies_1 = require("./tools/add-policies");
@@ -54,6 +54,8 @@ Object.defineProperty(exports, "fromEnvFile", { enumerable: true, get: function
 Object.defineProperty(exports, "fromEnvironment", { enumerable: true, get: function () { return context_1.fromEnvironment; } });
 Object.defineProperty(exports, "resolveDataToken", { enumerable: true, get: function () { return context_1.resolveDataToken; } });
 Object.defineProperty(exports, "resolveProjectContext", { enumerable: true, get: function () { return context_1.resolveProjectContext; } });
+var gate_1 = require("./gate");
+Object.defineProperty(exports, "constructiveGateDeps", { enumerable: true, get: function () { return gate_1.constructiveGateDeps; } });
 var host_2 = require("./host");
 Object.defineProperty(exports, "configureHost", { enumerable: true, get: function () { return host_2.configureHost; } });
 Object.defineProperty(exports, "DEFAULT_DATA_TOKEN_SKEW_MS", { enumerable: true, get: function () { return host_2.DEFAULT_DATA_TOKEN_SKEW_MS; } });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentic-kit/db-tools",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "author": "Constructive <developers@constructive.io>",
   "description": "harness-neutral Constructive database tools — provisioning, schema, policies, records, templates and codegen as HarnessTools any adapter can bind",
   "main": "index.js",
@@ -31,8 +31,8 @@
   "dependencies": {
     "12factor-env": "^1.32.0",
     "@agentic-kit/harness": "^0.15.0",
-    "@constructive-io/graphql-query": "^4.14.1",
-    "@constructive-io/sdk": "^1.14.1",
+    "@constructive-io/graphql-query": "^4.15.1",
+    "@constructive-io/sdk": "^1.14.3",
     "node-type-registry": "^1.17.0",
     "zod": "^4.4.3"
   },
@@ -45,5 +45,5 @@
     "database",
     "constructive"
   ],
-  "gitHead": "d4bb5506059e1dfb28f2766e6d18e8d946db632d"
+  "gitHead": "e35db12526094b515596ced2dd27a1ec8edd99d5"
 }