@adhd/agent-engine-compiler 2.1.0

package/src/compile.js

@@ -0,0 +1,279 @@
+// ──────────────────────────────────────────────
+// compileAgent — public orchestrator.
+//
+// Turns an agent definition + runtime context into a flat, platform-shaped
+// artifact by composing the four resolve layers and dispatching to the
+// platform's header builder.
+//
+// Decision B (decisions.md) defines three header builders keyed on a
+// platform's `header_format` column:
+//
+//   yaml_frontmatter → emit/markdown.ts  (claude_code)
+//   json_object      → emit/json.ts      (claude_api / openai / bedrock)
+//   none             → body text only    (cursor / vscode)
+//
+// The builder is selected by DATA (header_format), never by a hard-coded
+// platform name check.  Adding a platform that shares an existing
+// header_format requires no code change here.
+//
+// \n\n section separator advisory (carry-forward, decisions.md Decision B.1):
+//   resolve/composition.ts:72 joins body sections with a single '\n'.
+//   composition.ts is read-only.  To produce the '\n\n'-separated body
+//   mandated by Decision B.1, this function calls CompositionStore.resolveComposition
+//   directly and owns the join, bypassing resolveBody's pre-joined string.
+//   This is the emit-layer fix authorised by the advisory — no composition.ts
+//   edit required.
+//
+// [def:compile-input]  — {agentSlug, platform, context, db}
+// [def:composed-output] — {id, content, tools, componentVersions}
+// [inv:one-db-handle]  — ONE shared SQLite handle, all four table prefixes.
+// [inv:real-rows-not-mocks] — the caller seeds real rows; this function
+//   reads them through the upstream stores.
+// ──────────────────────────────────────────────
+import { AgentStore, CompositionStore } from '@adhd/agent-store-prompts';
+import { ToolStore, BindingStore } from '@adhd/agent-store-tools';
+import { ToolFormatStore, emitToolsForProvider } from '@adhd/agent-core-provider';
+import { resolveTools } from './resolve/tools.js';
+import { resolveModel } from './resolve/model.js';
+import { resolvePolicyConstraints } from './resolve/policy.js';
+import { emitYamlFrontmatter } from './emit/markdown.js';
+import { emitJsonObject } from './emit/json.js';
+import { lookup as cacheL, write as cacheW, } from './cache/composed-prompt-cache.js';
+// ──────────────────────────────────────────────
+// Internal helpers
+// ──────────────────────────────────────────────
+/**
+ * Look up the `header_format` for a platform from `tool_platform_bindings.platforms`.
+ * Returns the platform's `headerFormat` column, or 'none' if no row is found.
+ */
+function getPlatformHeaderFormat(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+db, platform) {
+    const bindingStore = new BindingStore(db);
+    // BindingStore.readPlatform throws PLATFORM_NOT_FOUND when absent — treat
+    // an unknown platform as 'none' (body-only compile).
+    try {
+        const p = bindingStore.readPlatform(platform);
+        return p.headerFormat;
+    }
+    catch {
+        // Unknown platform — treat as 'none' (body-only).
+        return 'none';
+    }
+}
+/**
+ * Extract body sections (in junction order) and componentVersions directly from
+ * CompositionStore — bypassing resolveBody's '\n'-joined string so we can
+ * join sections with '\n\n' as Decision B.1 mandates.
+ *
+ * This is the emit-layer fix for the advisory noted in decisions.md.
+ */
+function extractBodyParts(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+db, agentSlug, context) {
+    const store = new CompositionStore(
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    db);
+    const resolved = store.resolveComposition(agentSlug, context);
+    const componentVersions = {};
+    const bodySections = [];
+    for (const rc of resolved) {
+        bodySections.push(rc.component.content);
+        componentVersions[rc.componentSlug] = rc.resolvedVersion;
+    }
+    return { bodySections, componentVersions };
+}
+// ──────────────────────────────────────────────
+// Public API
+// ──────────────────────────────────────────────
+/**
+ * Compile an agent to a flat, platform-shaped artifact.
+ *
+ * Orchestrates the four resolve layers:
+ *   1. body + componentVersions — CompositionStore.resolveComposition (junction order)
+ *   2. tools                    — resolveTools (platform aliases)
+ *   3. model                    — resolveModel (platform binding or canonical fallback)
+ *   4. constraints              — resolvePolicyConstraints (direct + inherited)
+ *
+ * Then dispatches on the platform's `header_format` column to the matching
+ * emit function.  The `id` field is null until `composed-prompt-caching`
+ * wires the cache write ([def:composed-output]).
+ *
+ * @param input - Agent slug, target platform, runtime context, shared DB handle.
+ * @returns Compiled platform artifact plus metadata.
+ *
+ * @throws {AgentError}       AGENT_NOT_FOUND — agentSlug not in registry_agents.
+ * @throws {CompositionError} REQUIRED_COMPONENT_EXCLUDED — a required component
+ *   was excluded by the runtime context.
+ */
+export function compileAgent(input) {
+    const { agentSlug, platform, context = {}, db } = input;
+    // ── 1. Agent metadata (description for frontmatter, model_hint for model step) ──
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const agentStore = new AgentStore(db);
+    const agent = agentStore.read(agentSlug);
+    // ── 2. Determine header_format from the platform row ────────────────────
+    const headerFormat = getPlatformHeaderFormat(db, platform);
+    // ── 3. Body sections in junction order with '\n\n' separator ────────────
+    // Direct call to CompositionStore — bypasses resolveBody's '\n' join so
+    // we can apply Decision B.1's '\n\n' between sections at the emit layer.
+    // NOTE: extractBodyParts is a cheap read; we run it before the cache check
+    // so we have `componentVersions` to fold into the combined context_hash
+    // (Decision D: the hash covers BOTH context AND resolved version set).
+    const { bodySections, componentVersions } = extractBodyParts(db, agentSlug, context);
+    // ── 3b. Cache lookup (BEFORE assembly — [dod.4] negative-control) ────────
+    // Decision D: lookup by (agentSlug, platform, context, componentVersions).
+    // On HIT: return the persisted {id, content} WITHOUT re-running the resolve
+    // layers (steps 4-7 are bypassed).  Removing this SELECT causes a duplicate
+    // row on every compile — that is the [dod.4] negative-control.
+    const hit = cacheL(db, agentSlug, platform, context, componentVersions);
+    if (hit !== null) {
+        // Cache HIT: serve the persisted artifact.  `tools` and `componentVersions`
+        // are reconstructed from the already-resolved data (they are cheap reads
+        // and do not require re-running the full assembly).
+        const resolvedToolsForHit = resolveTools(db, agentSlug, platform);
+        if (headerFormat === 'yaml_frontmatter') {
+            return {
+                id: hit.id,
+                content: hit.content,
+                tools: resolvedToolsForHit.map((t) => t.platformAlias),
+                componentVersions: hit.componentVersions,
+            };
+        }
+        if (headerFormat === 'json_object') {
+            // For JSON platforms, tools is a structured array; reconstruct from the
+            // same resolve path so the return shape is consistent.
+            const toolStore = new ToolStore(db);
+            const toolFormatStore = new ToolFormatStore(db);
+            const lookupFmt = (pid, ct) => toolFormatStore.getShape(pid, ct);
+            const platformToProvider = {
+                claude_api: 'anthropic',
+                openai: 'openai',
+                bedrock: 'bedrock',
+            };
+            const providerId = platformToProvider[platform] ?? platform;
+            const toolDefs = resolvedToolsForHit.map((rt) => {
+                let description = '';
+                try {
+                    description = toolStore.read(rt.canonicalName).description;
+                }
+                catch {
+                    description = rt.canonicalName;
+                }
+                return {
+                    name: rt.canonicalName,
+                    description,
+                    inputSchema: {},
+                };
+            });
+            const emittedTools = emitToolsForProvider(toolDefs, providerId, lookupFmt);
+            return {
+                id: hit.id,
+                content: hit.content,
+                tools: emittedTools,
+                componentVersions: hit.componentVersions,
+            };
+        }
+        // none format — no tools
+        return {
+            id: hit.id,
+            content: hit.content,
+            tools: [],
+            componentVersions: hit.componentVersions,
+        };
+    }
+    // ── 4. Resolve tools (platform aliases) ─────────────────────────────────
+    const resolvedTools = resolveTools(db, agentSlug, platform);
+    // ── 5. Resolve model ─────────────────────────────────────────────────────
+    const model = resolveModel(db, agentSlug, platform);
+    // ── 6. Resolve policy constraints ────────────────────────────────────────
+    const constraints = resolvePolicyConstraints(db, agentSlug);
+    // ── 7. Dispatch on header_format ─────────────────────────────────────────
+    // yaml_frontmatter (claude_code) ──────────────────────────────────────────
+    if (headerFormat === 'yaml_frontmatter') {
+        const content = emitYamlFrontmatter({
+            agentSlug,
+            description: agent.description,
+            tools: resolvedTools,
+            model,
+            bodySections,
+            constraints,
+        });
+        // Tools return: string[] of platform aliases for claude_code.
+        const toolAliases = resolvedTools.map((t) => t.platformAlias);
+        // ── 7a. Cache WRITE (MISS path) ────────────────────────────────────────
+        const written = cacheW(db, agentSlug, platform, context, componentVersions, content);
+        return { id: written.id, content, tools: toolAliases, componentVersions };
+    }
+    // json_object (claude_api / openai / bedrock) ─────────────────────────────
+    if (headerFormat === 'json_object') {
+        // Build structured tool array for the API.
+        // We construct minimal ToolDefinition objects from the tool catalog so
+        // emitToolsForProvider can shape them.  inputSchema defaults to {} since
+        // the registry doesn't store JSON schemas for tool grants.
+        const toolStore = new ToolStore(db);
+        const toolFormatStore = new ToolFormatStore(db);
+        const lookupFmt = (providerId, canonicalTool) => toolFormatStore.getShape(providerId, canonicalTool);
+        // Map the target platform id to the provider id (Decision B.2: tools shaped
+        // via provider_tool_formats).  claude_api → 'anthropic' is the seed mapping
+        // from SEED_DATA.md §5; openai → 'openai'.  Unknown platforms default to
+        // the platform id itself as the provider id.
+        const platformToProvider = {
+            claude_api: 'anthropic',
+            openai: 'openai',
+            bedrock: 'bedrock',
+        };
+        const providerId = platformToProvider[platform] ?? platform;
+        // Build ToolDefinition[] from the resolved (available) tools.
+        const toolDefinitions = resolvedTools.map((rt) => {
+            let description = '';
+            try {
+                const catalogTool = toolStore.read(rt.canonicalName);
+                description = catalogTool.description;
+            }
+            catch {
+                // No catalog row — use the canonical name as a fallback description.
+                description = rt.canonicalName;
+            }
+            return {
+                name: rt.canonicalName,
+                description,
+                inputSchema: {},
+            };
+        });
+        // emitToolsForProvider shapes each tool per the provider_tool_formats row.
+        // Double-cast via unknown: EmittedTool[] (EmittedServerSideTool lacks an
+        // index signature) → unknown[] → StructuredTool[].  Both types are
+        // compatible at runtime — all EmittedTool shapes are plain objects.
+        const emittedTools = emitToolsForProvider(toolDefinitions, providerId, lookupFmt);
+        const content = emitJsonObject({
+            agentSlug,
+            bodySections,
+            constraints,
+            tools: resolvedTools,
+            structuredTools: emittedTools,
+            model,
+        });
+        // ── 7a. Cache WRITE (MISS path) ────────────────────────────────────────
+        const written = cacheW(db, agentSlug, platform, context, componentVersions, content);
+        return { id: written.id, content, tools: emittedTools, componentVersions };
+    }
+    // none (cursor / vscode) — body only, no tools declaration ─────────────────
+    // Decision B.3: content = flat body + policy block, tools: [].
+    const bodyParts = [...bodySections];
+    if (constraints.length > 0) {
+        const policyLines = ['## Policies', ''];
+        for (const c of constraints) {
+            const prefix = c.inheritedFrom
+                ? `(inherited from ${c.inheritedFrom}) `
+                : '';
+            policyLines.push(`- ${prefix}${c.text}`);
+        }
+        bodyParts.push(policyLines.join('\n'));
+    }
+    const content = bodyParts.join('\n\n') + '\n';
+    // ── 7a. Cache WRITE (MISS path) ─────────────────────────────────────────
+    const written = cacheW(db, agentSlug, platform, context, componentVersions, content);
+    return { id: written.id, content, tools: [], componentVersions };
+}
+//# sourceMappingURL=compile.js.map

package/src/compile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.js","sourceRoot":"","sources":["../../../../../packages/agent/agent-engine-compiler/src/compile.ts"],"names":[],"mappings":"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"}

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-engine-compiler/src/db/client.ts"],"names":[],"mappings":"AAGA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAGtC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAwBtC,eAAO,MAAM,MAAM,EAAE,QAAQ,CAAC,QAAqC,CAAC;AASpE,eAAO,MAAM,EAAE;;CAA8B,CAAC"}

package/src/db/client.js

@@ -0,0 +1,31 @@
+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';
+// One shared SQLite file for the whole registry family. This package opens ONE
+// handle and queries all four registry prefixes (registry_*, tool_*, provider_*,
+// policy_*) through it — NO ATTACH DATABASE, NO second DB file, NO cross-package
+// SQLite foreign keys. Cross-prefix reads go through the upstream store classes
+// (CompositionStore, BindingStore, ModelStore, AgentPolicyStore) which are
+// constructed with this same `sqlite` / `db` handle in compileAgent({..., db}).
+// See decisions.md Decision C and REGISTRY-PACKAGE-RULES.md §2.
+const databasePath = process.env['REGISTRY_DATABASE_PATH'] ||
+    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');
+// The compiler's Drizzle instance covers the compiler_ prefix tables only.
+// Upstream schemas are accessed through the upstream packages' store classes
+// (passed the same `db` / `sqlite` handle), not merged here. This keeps each
+// package's schema namespace isolated while sharing one physical connection.
+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-engine-compiler/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,+EAA+E;AAC/E,iFAAiF;AACjF,iFAAiF;AACjF,gFAAgF;AAChF,2EAA2E;AAC3E,gFAAgF;AAChF,gEAAgE;AAChE,MAAM,YAAY,GAChB,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC;IACrC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IAC5B,oBAAoB,CAAC;AAEvB,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,2EAA2E;AAC3E,6EAA6E;AAC7E,6EAA6E;AAC7E,6EAA6E;AAC7E,MAAM,CAAC,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC"}

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

@@ -0,0 +1,31 @@
+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: SQLite ignores `PRAGMA foreign_keys` inside a transaction, and drizzle's
+ * migrator wraps each migration file in one. Table-recreate migrations (ALTER
+ * TABLE via CREATE-INSERT-DROP-RENAME) fire ON DELETE CASCADE when FK enforcement
+ * is ON, wiping child rows. Disabling 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-engine-compiler/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;;;;;;;;;;GAUG;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,35 @@
+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: SQLite ignores `PRAGMA foreign_keys` inside a transaction, and drizzle's
+ * migrator wraps each migration file in one. Table-recreate migrations (ALTER
+ * TABLE via CREATE-INSERT-DROP-RENAME) fire ON DELETE CASCADE when FK enforcement
+ * is ON, wiping child rows. Disabling 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-engine-compiler/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;;;;;;;;;;GAUG;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 registry is used.
+ * 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-engine-compiler/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 registry is used.
+ * 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-engine-compiler/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"}

package/src/db/schema.d.ts

@@ -0,0 +1,3 @@
+import { index, integer, primaryKey, sqliteTable, text, uniqueIndex } from 'drizzle-orm/sqlite-core';
+export { index, integer, primaryKey, sqliteTable, text, uniqueIndex };
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../../../packages/agent/agent-engine-compiler/src/db/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EACL,OAAO,EACP,UAAU,EACV,WAAW,EACX,IAAI,EACJ,WAAW,EACZ,MAAM,yBAAyB,CAAC;AAuBjC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC"}

package/src/db/schema.js

@@ -0,0 +1,30 @@
+import { index, integer, primaryKey, sqliteTable, text, uniqueIndex, } from 'drizzle-orm/sqlite-core';
+// ──────────────────────────────────────────────
+// @adhd/agent-engine-compiler — table prefix: compiler_
+//
+// Every table in THIS package MUST be named with the `compiler_` prefix.
+// All registry-family packages share ONE SQLite file, so the prefix is the only
+// thing preventing cross-package table-name collisions. See REGISTRY-PACKAGE-RULES.md.
+//
+// Invariants enforced here (do not break them):
+//   • Cross-package keys are LOGICAL ONLY — plain text columns, no .references()
+//     across package prefixes. In-package FKs use .references() normally.
+//   • Controlled vocabularies are lookup tables (text PK) or plain text columns,
+//     NEVER SQL enums — a new value is a new row, no migration.
+//   • Composite PKs use `primaryKey({ columns: [...] })`, never a non-unique index().
+//   • Bump-don't-delete: if you retain versions, never delete a prior version row.
+//
+// The drizzle-orm/sqlite-core helpers are re-exported so a downstream module can
+// `import { sqliteTable, text } from "@adhd/agent-engine-compiler"` without re-importing the
+// dependency directly, and so this skeleton's import is exercised before any table
+// exists. Define real tables here and add them to the barrel in ../index.ts.
+// ──────────────────────────────────────────────
+export { index, integer, primaryKey, sqliteTable, text, uniqueIndex };
+// Example (delete this comment, add real tables prefixed `compiler_`):
+//
+// export const exampleTable = sqliteTable("compiler_example", {
+//     slug: text("slug").primaryKey(),
+//     label: text("label").notNull(),
+//     createdAt: text("created_at").notNull(),
+// });
+//# sourceMappingURL=schema.js.map

package/src/db/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../../../../packages/agent/agent-engine-compiler/src/db/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EACL,OAAO,EACP,UAAU,EACV,WAAW,EACX,IAAI,EACJ,WAAW,GACZ,MAAM,yBAAyB,CAAC;AAEjC,iDAAiD;AACjD,wDAAwD;AACxD,EAAE;AACF,yEAAyE;AACzE,gFAAgF;AAChF,uFAAuF;AACvF,EAAE;AACF,gDAAgD;AAChD,iFAAiF;AACjF,0EAA0E;AAC1E,iFAAiF;AACjF,gEAAgE;AAChE,sFAAsF;AACtF,mFAAmF;AACnF,EAAE;AACF,iFAAiF;AACjF,6FAA6F;AAC7F,mFAAmF;AACnF,6EAA6E;AAC7E,iDAAiD;AAEjD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;AAEtE,uEAAuE;AACvE,EAAE;AACF,gEAAgE;AAChE,uCAAuC;AACvC,sCAAsC;AACtC,+CAA+C;AAC/C,MAAM"}

package/src/emit/json.d.ts

@@ -0,0 +1,50 @@
+import type { ResolvedTool } from '../resolve/tools.js';
+import type { Constraint } from '../resolve/policy.js';
+/**
+ * A structured tool entry in the json_object output.
+ *
+ * For claude_api / openai this mirrors the standard `{name, description,
+ * input_schema}` custom tool shape.  Server-side type-tagged tools are
+ * emitted with the `{type, name}` shape (no input_schema).
+ *
+ * The compile layer passes the already-shaped objects from emitToolsForProvider
+ * directly — this type covers both discriminated variants.
+ */
+export type StructuredTool = Record<string, unknown>;
+/** Inputs to the json_object emitter. */
+export interface JsonObjectInput {
+    /** Agent slug — the `name` key. */
+    agentSlug: string;
+    /**
+     * Body sections in junction order (ascending position), each the raw content
+     * of one resolved component.  Joined with '\n\n' to form systemPrompt,
+     * with the policy block appended (Decision B.2).
+     */
+    bodySections: string[];
+    /** Effective policy constraints (direct + inherited). */
+    constraints: Constraint[];
+    /**
+     * Resolved platform tools — passed through from resolveTools; used here only
+     * to confirm 'unavailable' tools are already absent.  The STRUCTURED array
+     * passed to `tools` is the caller-supplied `structuredTools`.
+     */
+    tools: ResolvedTool[];
+    /**
+     * Pre-shaped structured tool array produced by emitToolsForProvider (or the
+     * compile layer's equivalent).  This is what lands in `tools` in the JSON.
+     */
+    structuredTools: StructuredTool[];
+    /** Resolved full platform model id (e.g. 'claude-sonnet-4-6'), or '' if absent. */
+    model: string;
+}
+/**
+ * Emit a `json_object` platform artifact for claude_api / openai / bedrock.
+ *
+ * Returns a JSON STRING (`content = JSON.stringify(...)`) — callers must not
+ * wrap it further.  The object shape is frozen per Decision B.2.
+ *
+ * @param input - Resolved compiler inputs; all fields already platform-shaped.
+ * @returns JSON string ready to pass as the API system prompt payload.
+ */
+export declare function emitJsonObject(input: JsonObjectInput): string;
+//# sourceMappingURL=json.d.ts.map

package/src/emit/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../../../../../packages/agent/agent-engine-compiler/src/emit/json.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAMvD;;;;;;;;;GASG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAErD,yCAAyC;AACzC,MAAM,WAAW,eAAe;IAC9B,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,yDAAyD;IACzD,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B;;;;OAIG;IACH,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB;;;OAGG;IACH,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,mFAAmF;IACnF,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAuC7D"}

package/src/emit/json.js

@@ -0,0 +1,66 @@
+// ──────────────────────────────────────────────
+// json_object emitter (claude_api / openai / bedrock — header_format = 'json_object')
+//
+// Emits a JSON STRING (content = JSON.stringify(...)) — NOT YAML, no '---'.
+//
+// Shape per Decision B.2 (decisions.md):
+//
+//   {
+//     "name":         "<agent.slug>",
+//     "systemPrompt": "<flat body: composed sections + policy block, joined '\n\n'>",
+//     "model":        "<resolveModelId(model_hint, platform)>",   // full id
+//     "tools":        [ /* structured tool array (EmittedTool[]) */ ]
+//   }
+//
+// Rules:
+//   - `systemPrompt` is the FLAT body (same composed sections as yaml_frontmatter,
+//     minus the YAML header; policy constraints folded into the prompt text).
+//   - `tools` is a STRUCTURED ARRAY via EmittedTool (from agent-provider's
+//     emitToolsForProvider), NOT a comma string.
+//   - `model` resolves to the FULL platform id (e.g. 'claude-sonnet-4-6'),
+//     distinct from the claude_code alias.
+//   - Tools whose platform binding is 'unavailable' are omitted by resolveTools
+//     before they reach this emitter — this function does NOT re-filter.
+//
+// [dod.7] audit greps for 'json_object' + 'JSON.stringify' + 'systemPrompt' —
+// all three tokens are present in this file.
+// ──────────────────────────────────────────────
+/**
+ * Emit a `json_object` platform artifact for claude_api / openai / bedrock.
+ *
+ * Returns a JSON STRING (`content = JSON.stringify(...)`) — callers must not
+ * wrap it further.  The object shape is frozen per Decision B.2.
+ *
+ * @param input - Resolved compiler inputs; all fields already platform-shaped.
+ * @returns JSON string ready to pass as the API system prompt payload.
+ */
+export function emitJsonObject(input) {
+    const { agentSlug, bodySections, constraints, structuredTools, model } = input;
+    // ── systemPrompt: flat body with policy block folded in ──────────────────
+    // Same composition logic as yaml_frontmatter body — sections '\n\n'-joined,
+    // policy constraints appended as text (Decision B.2).
+    const bodyParts = [...bodySections];
+    if (constraints.length > 0) {
+        const policyLines = ['## Policies', ''];
+        for (const c of constraints) {
+            const prefix = c.inheritedFrom
+                ? `(inherited from ${c.inheritedFrom}) `
+                : '';
+            policyLines.push(`- ${prefix}${c.text}`);
+        }
+        bodyParts.push(policyLines.join('\n'));
+    }
+    const systemPrompt = bodyParts.join('\n\n');
+    // ── Assemble the JSON payload ─────────────────────────────────────────────
+    // Field order: name → systemPrompt → model → tools.
+    // `model` key is always present (empty string when no model_hint).
+    const payload = {
+        name: agentSlug,
+        systemPrompt,
+        model,
+        tools: structuredTools,
+    };
+    // json_object format: JSON.stringify the payload (Decision B.2).
+    return JSON.stringify(payload);
+}
+//# sourceMappingURL=json.js.map

package/src/emit/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../../../../../packages/agent/agent-engine-compiler/src/emit/json.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,sFAAsF;AACtF,EAAE;AACF,4EAA4E;AAC5E,EAAE;AACF,yCAAyC;AACzC,EAAE;AACF,MAAM;AACN,sCAAsC;AACtC,sFAAsF;AACtF,6EAA6E;AAC7E,sEAAsE;AACtE,MAAM;AACN,EAAE;AACF,SAAS;AACT,mFAAmF;AACnF,8EAA8E;AAC9E,2EAA2E;AAC3E,iDAAiD;AACjD,2EAA2E;AAC3E,2CAA2C;AAC3C,gFAAgF;AAChF,yEAAyE;AACzE,EAAE;AACF,8EAA8E;AAC9E,6CAA6C;AAC7C,iDAAiD;AAgDjD;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,KAAsB;IACnD,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,KAAK,EAAE,GACpE,KAAK,CAAC;IAER,4EAA4E;IAC5E,4EAA4E;IAC5E,sDAAsD;IACtD,MAAM,SAAS,GAAa,CAAC,GAAG,YAAY,CAAC,CAAC;IAE9C,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,WAAW,GAAG,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;QACxC,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAG,CAAC,CAAC,aAAa;gBAC5B,CAAC,CAAC,mBAAmB,CAAC,CAAC,aAAa,IAAI;gBACxC,CAAC,CAAC,EAAE,CAAC;YACP,WAAW,CAAC,IAAI,CAAC,KAAK,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3C,CAAC;QACD,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,YAAY,GAAG,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAE5C,6EAA6E;IAC7E,oDAAoD;IACpD,mEAAmE;IACnE,MAAM,OAAO,GAKT;QACF,IAAI,EAAE,SAAS;QACf,YAAY;QACZ,KAAK;QACL,KAAK,EAAE,eAAe;KACvB,CAAC;IAEF,iEAAiE;IACjE,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC"}