@agentic-kit/pi 0.17.1 → 0.18.1

package/index.js

@@ -1,44 +1,26 @@
 "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.configureHost = exports.piHarness = exports.PI_HARNESS_ID = exports.createUsageReportExtension = exports.MIRROR_EVENTS = exports.createRunLogExtension = exports.piProviderConfig = exports.createMeteredModelExtension = exports.createGateExtension = exports.startRun = exports.composeRun = exports.resolveProjectContext = exports.resolveDataToken = exports.fromEnvironment = exports.fromEnvFile = exports.deriveSubdomainEndpoint = exports.CONTEXT_ENV_PREFIX = exports.CONTEXT_ENV_KEYS = exports.createConfirmGate = exports.dbTools = void 0;
+exports.getModulePreset = exports.allModulePresets = exports.toolSchema = exports.resolveProvisionModules = exports.resolveProjectContext = exports.resolveDataToken = exports.PROVISION_MANIFEST_FILE = exports.parseProvisionManifest = exports.moduleKey = exports.loadProvisionManifest = exports.getHost = exports.fromEnvironment = exports.fromEnvFile = exports.deriveSubdomainEndpoint = exports.DEFAULT_PROVISION_PRESET = exports.createTemplatePreviewTables = exports.CONTEXT_ENV_PREFIX = exports.CONTEXT_ENV_KEYS = exports.constructiveDbTools = exports.configureHost = exports.toPiTools = exports.toPiTool = exports.piHarness = exports.PI_HARNESS_ID = exports.createUsageReportExtension = exports.MIRROR_EVENTS = exports.createRunLogExtension = exports.piProviderConfig = exports.createMeteredModelExtension = exports.createGateExtension = exports.startRun = exports.composeRun = exports.createConfirmGate = exports.dbTools = void 0;
 exports.createDbTools = createDbTools;
+const db_tools_1 = require("@agentic-kit/db-tools");
 const confirm_gate_1 = require("./confirm-gate");
-const context_1 = require("./context");
-const host_1 = require("./host");
-const add_policies_1 = require("./tools/add-policies");
-const add_records_1 = require("./tools/add-records");
-const add_relation_1 = require("./tools/add-relation");
-const create_api_key_1 = require("./tools/create-api-key");
-const describe_schema_1 = require("./tools/describe-schema");
-const manage_entity_types_1 = require("./tools/manage-entity-types");
-const mutations_1 = require("./tools/mutations");
-const provision_blueprint_1 = require("./tools/provision-blueprint");
-const provision_database_1 = require("./tools/provision-database");
-const run_codegen_1 = require("./tools/run-codegen");
-const templates_1 = require("./tools/templates");
+const pi_tool_1 = require("./pi-tool");
+/**
+ * The Constructive db tools bound to pi.
+ *
+ * The tools themselves live in `@agentic-kit/db-tools` and know nothing about
+ * pi; this is the binding — `toPiTool` per tool, plus the confirm gate on pi's
+ * `tool_call` event. A sibling adapter writes its own equivalent of this file
+ * and registers the same `constructiveDbTools`.
+ */
 const dbTools = (pi) => {
-    pi.registerTool(provision_database_1.provisionDatabaseTool);
-    pi.registerTool(describe_schema_1.describeSchemaTool);
-    pi.registerTool(templates_1.listTemplatesTool);
-    pi.registerTool(provision_blueprint_1.provisionBlueprintTool);
-    pi.registerTool(add_relation_1.addRelationTool);
-    pi.registerTool(mutations_1.deleteTableTool);
-    pi.registerTool(mutations_1.createFieldTool);
-    pi.registerTool(mutations_1.updateFieldTool);
-    pi.registerTool(mutations_1.deleteFieldTool);
-    pi.registerTool(add_policies_1.addPoliciesTool);
-    pi.registerTool(templates_1.applyTemplateTool);
-    pi.registerTool(templates_1.createTemplateTool);
-    pi.registerTool(templates_1.updateTemplateTool);
-    pi.registerTool(templates_1.deleteTemplateTool);
-    pi.registerTool(add_records_1.addRecordsTool);
-    pi.registerTool(manage_entity_types_1.manageEntityTypesTool);
-    pi.registerTool(create_api_key_1.createApiKeyTool);
-    pi.registerTool(run_codegen_1.runCodegenTool);
+    for (const tool of db_tools_1.constructiveDbTools) {
+        pi.registerTool((0, pi_tool_1.toPiTool)(tool));
+    }
     const gate = (0, confirm_gate_1.createConfirmGate)({
-        resolveProjectContext: context_1.resolveProjectContext,
-        resolveDataToken: context_1.resolveDataToken,
-        createTemplatePreviewTables: templates_1.createTemplatePreviewTables,
+        resolveProjectContext: db_tools_1.resolveProjectContext,
+        resolveDataToken: db_tools_1.resolveDataToken,
+        createTemplatePreviewTables: db_tools_1.createTemplatePreviewTables,
     });
     pi.on('agent_start', gate.onAgentStart);
     pi.on('tool_call', gate.onToolCall);
@@ -46,19 +28,11 @@ const dbTools = (pi) => {
 exports.dbTools = dbTools;
 /** Configure the host and get the extension in one call. */
 function createDbTools(host) {
-    (0, host_1.configureHost)(host);
+    (0, db_tools_1.configureHost)(host);
     return exports.dbTools;
 }
 var confirm_gate_2 = require("./confirm-gate");
 Object.defineProperty(exports, "createConfirmGate", { enumerable: true, get: function () { return confirm_gate_2.createConfirmGate; } });
-var context_2 = require("./context");
-Object.defineProperty(exports, "CONTEXT_ENV_KEYS", { enumerable: true, get: function () { return context_2.CONTEXT_ENV_KEYS; } });
-Object.defineProperty(exports, "CONTEXT_ENV_PREFIX", { enumerable: true, get: function () { return context_2.CONTEXT_ENV_PREFIX; } });
-Object.defineProperty(exports, "deriveSubdomainEndpoint", { enumerable: true, get: function () { return context_2.deriveSubdomainEndpoint; } });
-Object.defineProperty(exports, "fromEnvFile", { enumerable: true, get: function () { return context_2.fromEnvFile; } });
-Object.defineProperty(exports, "fromEnvironment", { enumerable: true, get: function () { return context_2.fromEnvironment; } });
-Object.defineProperty(exports, "resolveDataToken", { enumerable: true, get: function () { return context_2.resolveDataToken; } });
-Object.defineProperty(exports, "resolveProjectContext", { enumerable: true, get: function () { return context_2.resolveProjectContext; } });
 var lanes_1 = require("./embed/lanes");
 Object.defineProperty(exports, "composeRun", { enumerable: true, get: function () { return lanes_1.composeRun; } });
 var session_1 = require("./embed/session");
@@ -76,22 +50,33 @@ Object.defineProperty(exports, "createUsageReportExtension", { enumerable: true,
 var harness_1 = require("./harness");
 Object.defineProperty(exports, "PI_HARNESS_ID", { enumerable: true, get: function () { return harness_1.PI_HARNESS_ID; } });
 Object.defineProperty(exports, "piHarness", { enumerable: true, get: function () { return harness_1.piHarness; } });
-var host_2 = require("./host");
-Object.defineProperty(exports, "configureHost", { enumerable: true, get: function () { return host_2.configureHost; } });
-Object.defineProperty(exports, "getHost", { enumerable: true, get: function () { return host_2.getHost; } });
-var manifest_1 = require("./provision-database/manifest");
-Object.defineProperty(exports, "loadProvisionManifest", { enumerable: true, get: function () { return manifest_1.loadProvisionManifest; } });
-Object.defineProperty(exports, "parseProvisionManifest", { enumerable: true, get: function () { return manifest_1.parseProvisionManifest; } });
-Object.defineProperty(exports, "PROVISION_MANIFEST_FILE", { enumerable: true, get: function () { return manifest_1.PROVISION_MANIFEST_FILE; } });
-var presets_1 = require("./provision-database/presets");
-Object.defineProperty(exports, "allModulePresets", { enumerable: true, get: function () { return presets_1.allModulePresets; } });
-Object.defineProperty(exports, "DEFAULT_PROVISION_PRESET", { enumerable: true, get: function () { return presets_1.DEFAULT_PROVISION_PRESET; } });
-Object.defineProperty(exports, "getModulePreset", { enumerable: true, get: function () { return presets_1.getModulePreset; } });
-var resolve_1 = require("./provision-database/resolve");
-Object.defineProperty(exports, "moduleKey", { enumerable: true, get: function () { return resolve_1.moduleKey; } });
-Object.defineProperty(exports, "resolveProvisionModules", { enumerable: true, get: function () { return resolve_1.resolveProvisionModules; } });
-var tool_schema_1 = require("./tool-schema");
-Object.defineProperty(exports, "toolSchema", { enumerable: true, get: function () { return tool_schema_1.toolSchema; } });
-var templates_2 = require("./tools/templates");
-Object.defineProperty(exports, "createTemplatePreviewTables", { enumerable: true, get: function () { return templates_2.createTemplatePreviewTables; } });
+var pi_tool_2 = require("./pi-tool");
+Object.defineProperty(exports, "toPiTool", { enumerable: true, get: function () { return pi_tool_2.toPiTool; } });
+Object.defineProperty(exports, "toPiTools", { enumerable: true, get: function () { return pi_tool_2.toPiTools; } });
+/**
+ * The db tools' own surface, re-exported so a pi host keeps one import. The
+ * package to depend on directly is `@agentic-kit/db-tools`.
+ */
+var db_tools_2 = require("@agentic-kit/db-tools");
+Object.defineProperty(exports, "configureHost", { enumerable: true, get: function () { return db_tools_2.configureHost; } });
+Object.defineProperty(exports, "constructiveDbTools", { enumerable: true, get: function () { return db_tools_2.constructiveDbTools; } });
+Object.defineProperty(exports, "CONTEXT_ENV_KEYS", { enumerable: true, get: function () { return db_tools_2.CONTEXT_ENV_KEYS; } });
+Object.defineProperty(exports, "CONTEXT_ENV_PREFIX", { enumerable: true, get: function () { return db_tools_2.CONTEXT_ENV_PREFIX; } });
+Object.defineProperty(exports, "createTemplatePreviewTables", { enumerable: true, get: function () { return db_tools_2.createTemplatePreviewTables; } });
+Object.defineProperty(exports, "DEFAULT_PROVISION_PRESET", { enumerable: true, get: function () { return db_tools_2.DEFAULT_PROVISION_PRESET; } });
+Object.defineProperty(exports, "deriveSubdomainEndpoint", { enumerable: true, get: function () { return db_tools_2.deriveSubdomainEndpoint; } });
+Object.defineProperty(exports, "fromEnvFile", { enumerable: true, get: function () { return db_tools_2.fromEnvFile; } });
+Object.defineProperty(exports, "fromEnvironment", { enumerable: true, get: function () { return db_tools_2.fromEnvironment; } });
+Object.defineProperty(exports, "getHost", { enumerable: true, get: function () { return db_tools_2.getHost; } });
+Object.defineProperty(exports, "loadProvisionManifest", { enumerable: true, get: function () { return db_tools_2.loadProvisionManifest; } });
+Object.defineProperty(exports, "moduleKey", { enumerable: true, get: function () { return db_tools_2.moduleKey; } });
+Object.defineProperty(exports, "parseProvisionManifest", { enumerable: true, get: function () { return db_tools_2.parseProvisionManifest; } });
+Object.defineProperty(exports, "PROVISION_MANIFEST_FILE", { enumerable: true, get: function () { return db_tools_2.PROVISION_MANIFEST_FILE; } });
+Object.defineProperty(exports, "resolveDataToken", { enumerable: true, get: function () { return db_tools_2.resolveDataToken; } });
+Object.defineProperty(exports, "resolveProjectContext", { enumerable: true, get: function () { return db_tools_2.resolveProjectContext; } });
+Object.defineProperty(exports, "resolveProvisionModules", { enumerable: true, get: function () { return db_tools_2.resolveProvisionModules; } });
+Object.defineProperty(exports, "toolSchema", { enumerable: true, get: function () { return db_tools_2.toolSchema; } });
+var db_tools_3 = require("@agentic-kit/db-tools");
+Object.defineProperty(exports, "allModulePresets", { enumerable: true, get: function () { return db_tools_3.allModulePresets; } });
+Object.defineProperty(exports, "getModulePreset", { enumerable: true, get: function () { return db_tools_3.getModulePreset; } });
 exports.default = exports.dbTools;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentic-kit/pi",
-  "version": "0.17.1",
+  "version": "0.18.1",
   "author": "Dan Lynch <pyramation@gmail.com>",
   "description": "the pi adapter for agentic-kit — Constructive's typed db tools, confirm gate, and the run-log/metering/gate lanes attached to a pi coding-agent session",
   "main": "index.js",
@@ -29,21 +29,17 @@
     "test:watch": "jest --watch"
   },
   "dependencies": {
-    "12factor-env": "^1.32.0",
-    "@agentic-kit/harness": "^0.14.0",
+    "@agentic-kit/db-tools": "^0.2.1",
+    "@agentic-kit/harness": "^0.15.0",
     "@agentic-kit/metering": "^0.3.0",
-    "@agentic-kit/run-log": "^0.5.0",
-    "@constructive-io/graphql-query": "^4.14.1",
-    "@constructive-io/sdk": "^1.14.1",
-    "node-type-registry": "^1.17.0",
+    "@agentic-kit/run-log": "^0.6.0",
     "zod": "^4.4.3"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": ">=0.79.0"
   },
   "devDependencies": {
-    "@earendil-works/pi-coding-agent": "0.79.6",
-    "typebox": "^1.0.0"
+    "@earendil-works/pi-coding-agent": "0.79.6"
   },
   "keywords": [
     "agentic-kit",
@@ -51,5 +47,5 @@
     "coding-agent",
     "constructive"
   ],
-  "gitHead": "8d77dfe57bb328cbdfe10732b10ca24865adf9c0"
+  "gitHead": "d10fe91ede80a4c2dfe2c1c6dcf6fe7193784eba"
 }

package/pi-tool.d.ts

@@ -0,0 +1,16 @@
+import type { AnyHarnessTool, HarnessTool } from '@agentic-kit/harness';
+import type { ToolDefinition } from '@earendil-works/pi-coding-agent';
+import type { z } from 'zod';
+/**
+ * Bind a neutral `HarnessTool` to pi's `ToolDefinition`.
+ *
+ * This is the whole of what pi wants that a tool does not state: parameters as
+ * a typebox schema rather than zod, and an execute arity carrying pi's tool
+ * call id, update callback and `ExtensionContext`. Everything a Constructive
+ * tool actually reads out of that context is `cwd` and the abort signal, so
+ * that is all this forwards — the rest stops here, which is the point of the
+ * seam: another harness writes its own binding and the tools do not change.
+ */
+export declare function toPiTool<TParams extends z.ZodType, TDetails>(tool: HarnessTool<TParams, TDetails>): ToolDefinition<any, TDetails>;
+/** Bind a whole tool set, in registration order. */
+export declare function toPiTools(tools: readonly AnyHarnessTool[]): ToolDefinition<any, any>[];

package/pi-tool.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toPiTool = toPiTool;
+exports.toPiTools = toPiTools;
+const db_tools_1 = require("@agentic-kit/db-tools");
+/**
+ * Bind a neutral `HarnessTool` to pi's `ToolDefinition`.
+ *
+ * This is the whole of what pi wants that a tool does not state: parameters as
+ * a typebox schema rather than zod, and an execute arity carrying pi's tool
+ * call id, update callback and `ExtensionContext`. Everything a Constructive
+ * tool actually reads out of that context is `cwd` and the abort signal, so
+ * that is all this forwards — the rest stops here, which is the point of the
+ * seam: another harness writes its own binding and the tools do not change.
+ */
+function toPiTool(tool) {
+    return {
+        name: tool.name,
+        label: tool.label,
+        description: tool.description,
+        ...(tool.promptSnippet === undefined ? {} : { promptSnippet: tool.promptSnippet }),
+        ...(tool.promptGuidelines === undefined ? {} : { promptGuidelines: tool.promptGuidelines }),
+        parameters: (0, db_tools_1.toolSchema)(tool.parameters),
+        async execute(_toolCallId, params, signal, _onUpdate, ctx) {
+            const result = await tool.execute(params, {
+                cwd: ctx.cwd,
+                signal,
+            });
+            return result;
+        },
+    };
+}
+/** Bind a whole tool set, in registration order. */
+function toPiTools(tools) {
+    return tools.map((tool) => toPiTool(tool));
+}

package/app-workspace.d.ts

@@ -1,16 +0,0 @@
-export declare const NATIVE_BUILD_DEPS: string[];
-export declare const IGNORED_BUILDS_RE: RegExp;
-export declare function run(cmd: string, args: string[], cwd: string, env?: Record<string, string>): Promise<{
-    ok: boolean;
-    out: string;
-}>;
-export declare function ensureWorkspaceConfig(cwd: string): Promise<void>;
-export declare function pinCodegenLatest(appDir: string): Promise<void>;
-export declare function ensureAppScaffold(cwd: string): Promise<{
-    ok: boolean;
-    out: string;
-}>;
-export declare function prewarmAppWorkspace(cwd: string): Promise<{
-    ok: boolean;
-    out: string;
-}>;

package/app-workspace.js

@@ -1,145 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.IGNORED_BUILDS_RE = exports.NATIVE_BUILD_DEPS = void 0;
-exports.run = run;
-exports.ensureWorkspaceConfig = ensureWorkspaceConfig;
-exports.pinCodegenLatest = pinCodegenLatest;
-exports.ensureAppScaffold = ensureAppScaffold;
-exports.prewarmAppWorkspace = prewarmAppWorkspace;
-const node_child_process_1 = require("node:child_process");
-const node_fs_1 = require("node:fs");
-const promises_1 = require("node:fs/promises");
-const node_os_1 = __importDefault(require("node:os"));
-const node_path_1 = __importDefault(require("node:path"));
-const node_util_1 = require("node:util");
-const execFileAsync = (0, node_util_1.promisify)(node_child_process_1.execFile);
-// pnpm 11.8 no longer reads the `pnpm` field from a non-root package.json, so the
-// template's `pnpm.overrides.graphql` (in packages/app/package.json) is silently
-// ignored. Without that override two graphql versions (16.13.0 + 16.14.0) get
-// installed, which instantiates two copies of `grafast` under DIFFERENT
-// peer-dependency hash contexts. graphile-search then resolves in one context
-// while graphile-connection-filter was linked under the other, so codegen dies
-// with `Cannot find module 'graphile-connection-filter'`. Hoisting the override
-// to the ROOT pnpm-workspace.yaml (which pnpm 11.8 DOES read) collapses graphql —
-// and therefore grafast — to a single version, and the missing module resolves
-// (PNPM-GRAPHQL-OVERRIDE-001). We also strip the nested packages/app
-// pnpm-workspace.yaml the template ships, and keep onlyBuiltDependencies so the
-// native deps build where honored (PNPM-BUILDS-001).
-exports.NATIVE_BUILD_DEPS = ['esbuild', 'sharp', 'unrs-resolver'];
-exports.IGNORED_BUILDS_RE = /ERR_PNPM_IGNORED_BUILDS|Ignored build scripts/;
-const DEFAULT_GRAPHQL_OVERRIDE = '16.14.0';
-const TEMPLATE_REPO = 'https://github.com/constructive-io/sandbox-templates';
-const TEMPLATE_SUBDIR = node_path_1.default.join('nextjs', 'constructive-app');
-async function run(cmd, args, cwd, env) {
-    try {
-        const { stdout, stderr } = await execFileAsync(cmd, args, {
-            cwd,
-            timeout: 5 * 60_000,
-            encoding: 'utf-8',
-            maxBuffer: 32 * 1024 * 1024,
-            env: env ? { ...process.env, ...env } : process.env,
-        });
-        return { ok: true, out: `${stdout}${stderr}`.trim() };
-    }
-    catch (err) {
-        const e = err;
-        return { ok: false, out: `${e.stdout ?? ''}${e.stderr ?? ''}`.trim() || e.message || 'failed' };
-    }
-}
-// Read the graphql pin the template wants from its (now-ignored) pnpm.overrides
-// so we propagate the template's own value instead of hardcoding ours.
-async function templateGraphqlOverride(cwd) {
-    try {
-        const pkg = JSON.parse(await (0, promises_1.readFile)(node_path_1.default.join(cwd, 'packages', 'app', 'package.json'), 'utf8'));
-        const v = pkg?.pnpm?.overrides?.graphql;
-        return typeof v === 'string' && v.length > 0 ? v : DEFAULT_GRAPHQL_OVERRIDE;
-    }
-    catch {
-        return DEFAULT_GRAPHQL_OVERRIDE;
-    }
-}
-async function ensureWorkspaceConfig(cwd) {
-    const nested = node_path_1.default.join(cwd, 'packages', 'app', 'pnpm-workspace.yaml');
-    if ((0, node_fs_1.existsSync)(nested)) {
-        await (0, promises_1.rm)(nested, { force: true });
-    }
-    const graphqlPin = await templateGraphqlOverride(cwd);
-    const builds = exports.NATIVE_BUILD_DEPS.map((d) => `  - ${d}`).join('\n');
-    const text = `packages:\n  - "packages/*"\n\n` +
-        `overrides:\n  graphql: ${graphqlPin}\n\n` +
-        `onlyBuiltDependencies:\n${builds}\n`;
-    await (0, promises_1.writeFile)(node_path_1.default.join(cwd, 'pnpm-workspace.yaml'), text);
-}
-// Force @constructive-io/graphql-codegen to `latest` in the app package.json
-// before the single install — older 4.9.x throws on PostGraphile `filter` inputs
-// (TS-001).
-async function pinCodegenLatest(appDir) {
-    const pkgPath = node_path_1.default.join(appDir, 'package.json');
-    const pkg = JSON.parse(await (0, promises_1.readFile)(pkgPath, 'utf8'));
-    for (const field of ['devDependencies', 'dependencies']) {
-        if (pkg[field]?.['@constructive-io/graphql-codegen']) {
-            pkg[field]['@constructive-io/graphql-codegen'] = 'latest';
-        }
-    }
-    await (0, promises_1.writeFile)(pkgPath, `${JSON.stringify(pkg, null, 2)}\n`);
-}
-// The Constructive Next.js app is just the `nextjs/constructive-app` tree from
-// the sandbox-templates repo — it ships no `____VAR____` placeholders, so there
-// is nothing to templatize. `pgpm init` only fetches and copies that tree, but
-// its CLI is unreliable in the non-TTY agent shell, which made the agent thrash
-// for minutes. Materialize `packages/app` deterministically by shallow-cloning
-// the template instead (PGPM-001).
-async function ensureAppScaffold(cwd) {
-    const appDir = node_path_1.default.join(cwd, 'packages', 'app');
-    if ((0, node_fs_1.existsSync)(node_path_1.default.join(appDir, 'package.json'))) {
-        return { ok: true, out: 'packages/app already scaffolded' };
-    }
-    const tmp = node_path_1.default.join(node_os_1.default.tmpdir(), `airpage-app-template-${process.pid}`);
-    await (0, promises_1.rm)(tmp, { recursive: true, force: true });
-    const clone = await run('git', ['clone', '--depth', '1', TEMPLATE_REPO, tmp], cwd);
-    if (!clone.ok) {
-        await (0, promises_1.rm)(tmp, { recursive: true, force: true });
-        return { ok: false, out: `Template clone failed:\n${clone.out}` };
-    }
-    const src = node_path_1.default.join(tmp, TEMPLATE_SUBDIR);
-    if (!(0, node_fs_1.existsSync)(src)) {
-        await (0, promises_1.rm)(tmp, { recursive: true, force: true });
-        return { ok: false, out: `Template subdir ${TEMPLATE_SUBDIR} missing in ${TEMPLATE_REPO}` };
-    }
-    try {
-        await (0, promises_1.mkdir)(node_path_1.default.dirname(appDir), { recursive: true });
-        await (0, promises_1.cp)(src, appDir, { recursive: true });
-    }
-    catch (err) {
-        await (0, promises_1.rm)(tmp, { recursive: true, force: true });
-        return {
-            ok: false,
-            out: `Copying template into packages/app failed: ${err instanceof Error ? err.message : String(err)}`,
-        };
-    }
-    await (0, promises_1.rm)(tmp, { recursive: true, force: true });
-    return { ok: true, out: 'Scaffolded packages/app from the constructive-app template.' };
-}
-// Scaffold packages/app, hoist the workspace config, pin codegen, and run the one
-// clean install. All of this is database-INDEPENDENT, so it can be prewarmed
-// concurrently with the ~90s provision_database backend mutation to keep clone +
-// install off run_codegen's critical path. Best-effort and fully idempotent:
-// run_codegen re-runs the same steps, finding the scaffold present and the install
-// already satisfied (a fast no-op). Errors are swallowed by callers that prewarm —
-// run_codegen surfaces any real failure later.
-async function prewarmAppWorkspace(cwd) {
-    const scaffold = await ensureAppScaffold(cwd);
-    if (!scaffold.ok)
-        return scaffold;
-    const appDir = node_path_1.default.join(cwd, 'packages', 'app');
-    await ensureWorkspaceConfig(cwd);
-    await pinCodegenLatest(appDir);
-    const install = await run('pnpm', ['install', '--no-frozen-lockfile'], cwd);
-    if (!install.ok && !exports.IGNORED_BUILDS_RE.test(install.out)) {
-        return { ok: false, out: `pnpm install failed:\n${install.out}` };
-    }
-    return { ok: true, out: 'Prewarmed packages/app scaffold + install.' };
-}

package/context.d.ts

@@ -1,62 +0,0 @@
-import { api, modules } from '@constructive-io/sdk';
-export type ApiClient = ReturnType<typeof api.createClient>;
-export type ModulesClient = ReturnType<typeof modules.createClient>;
-export type ProjectContext = {
-    api: ApiClient;
-    modules: ModulesClient;
-    databaseId: string;
-    schemaId: string;
-    ownerId: string | undefined;
-    apiEndpoint: string;
-    modulesEndpoint: string;
-    databaseName: string;
-    accessToken: string;
-    dataEndpoint: string;
-};
-export type ProjectContextFailureCode = 'no-env' | 'missing-credentials' | 'db-missing' | 'account-mismatch' | 'backend-unreachable' | 'schema-unresolved';
-export type ResolveResult = {
-    context: ProjectContext | null;
-    reason: string;
-    code?: ProjectContextFailureCode;
-};
-export declare const CONTEXT_ENV_KEYS: readonly ["ACCESS_TOKEN", "DATABASE_ID", "API_ENDPOINT", "MODULES_ENDPOINT", "DATABASE_NAME", "OWNER_ID"];
-export type ContextEnvKey = (typeof CONTEXT_ENV_KEYS)[number];
-/** Prefix for injected variables: `ACCESS_TOKEN` is far too generic to claim in
- *  a shared process environment, `CONSTRUCTIVE_ACCESS_TOKEN` is not. Inside a
- *  project `.env` the bare names stay readable (and are what the scaffolder
- *  writes), so both spellings resolve, prefixed winning. */
-export declare const CONTEXT_ENV_PREFIX = "CONSTRUCTIVE_";
-/** Values keyed by name, or a lookup function (a host with a secret store). */
-export type ContextSource = Record<string, string | undefined> | ((name: string) => string | undefined);
-/** Use the process environment (or any injected record) as the source. */
-export declare function fromEnvironment(environment?: Record<string, string | undefined>): ContextSource;
-/** Read a project `.env` as the source. The file is authoritative here — the
- *  key in it belongs to whatever backend wrote it, so it is not merged under
- *  the ambient environment. Returns null when the file is absent. */
-export declare function fromEnvFile(cwd: string): Promise<ContextSource | null>;
-export type ResolveOptions = {
-    /** Which plane the context is for. Ownership gates the control plane only:
-     *  schema editing and provisioning act under the signed-in account, so a
-     *  foreign-owned binding is blocked ('account-mismatch'). The data plane
-     *  (real rows via app end-user tokens) never checks desktop-account
-     *  ownership — a live foreign-owned database serves data fine, exactly as
-     *  the app itself does in the Preview. */
-    plane?: 'control' | 'data';
-};
-/**
- * Resolve the project context from injected values, or from a project folder.
- *
- * Passing a `cwd` string keeps the original behavior (read `<cwd>/.env`) so
- * existing hosts — Constructive Desktop, the confirm gate — are unchanged.
- * Headless hosts pass values instead: `fromEnvironment()` for a container or
- * Job, an explicit record for anything else.
- */
-export declare function resolveProjectContext(input: string | ContextSource, options?: ResolveOptions): Promise<ResolveResult>;
-export type DataTokenResult = {
-    token?: string;
-    userId?: string;
-    reason?: string;
-};
-export declare function resolveDataToken(context: ProjectContext): Promise<DataTokenResult>;
-export declare function deriveSubdomainEndpoint(baseEndpoint: string, firstLabel: string): string;
-export declare function resolveOrgName(ownerId: string): Promise<string | undefined>;