@adhd/agent-engine-compiler 2.1.8 → 2.1.10

package/src/cli/compile.js

@@ -0,0 +1,300 @@
+#!/usr/bin/env node
+// ──────────────────────────────────────────────
+// cli/compile.ts — argv parser + dispatcher for the agent-compiler bin.
+//
+// Usage:
+//   node cli/compile.js compile <slug> [options]
+//
+// Options:
+//   --platform <p>      Target platform (default: claude_code).
+//                       Must match a row in tool_platforms.
+//   --context '<json>'  Runtime context key/value object (JSON string).
+//   --format json       Emit JSON instead of platform default.
+//   --out-dir <d>       Write <slug>.md (or <slug>.json) under <d>
+//                       instead of printing to stdout.
+//   --all               Compile every agent in the registry (use with
+//                       --category to limit scope).
+//   --category <c>      Filter to agents in this taxonomy category slug.
+//   --db <path>         Path to the SQLite registry file. Defaults to
+//                       AGENT_REGISTRY_DB env var, then ~/.agent-registry/registry.db.
+//
+// Exit codes:
+//   0  — success
+//   1  — unknown slug / unknown platform / bad argument / I/O error
+//
+// [ref:cli-bin] — mirrors agent-mcp's bin entry in package.json;
+//   parses compile <slug> ... and writes content to stdout or --out-dir.
+// [inv:platform-node] — no browser imports; pure Node + SQLite.
+// [inv:one-db-handle] — opens ONE better-sqlite3 handle for the shared DB.
+// ──────────────────────────────────────────────
+import fs from 'node:fs';
+import path from 'node:path';
+import process from 'node:process';
+import { fileURLToPath } from 'node:url';
+import Database from 'better-sqlite3';
+import { drizzle } from 'drizzle-orm/better-sqlite3';
+import { migrate } from 'drizzle-orm/better-sqlite3/migrator';
+import { resolveRegistryDbPath } from '@adhd/agent-core-env';
+import { AgentStore } from '@adhd/agent-store-prompts';
+import { compileAgent } from '../compile.js';
+// ── Migration folders ─────────────────────────────────────────────────────
+//
+// Resolved relative to this compiled file's __dirname at runtime so the bin
+// works from the dist layout without referencing source paths.
+//
+// dist/packages/agent/agent-engine-compiler/src/cli/compile.js
+//   → ../../               = dist/packages/agent/agent-engine-compiler/
+//   → ../../../            = dist/packages/agent/
+//   → ../../../<pkg>/drizzle = dist/packages/agent/<pkg>/drizzle
+//
+// Timestamp order (ascending) matters so Drizzle's journal bookkeeping
+// doesn't skip a migration set:
+//   provider (1750*)  →  registry (1782193*)  →  tool-registry (1782250*)
+//     →  policy (1782256*)  →  compiler (18*)
+//
+// This mirrors the migration order in compile-agent.test.ts.
+const __dirname = fileURLToPath(new URL('.', import.meta.url));
+const AI_DIST = path.resolve(__dirname, '../../../');
+const PROVIDER_MIGRATIONS = path.join(AI_DIST, 'agent-core-provider/drizzle');
+const REGISTRY_MIGRATIONS = path.join(AI_DIST, 'agent-store-prompts/drizzle');
+const TOOL_REGISTRY_MIGRATIONS = path.join(AI_DIST, 'agent-store-tools/drizzle');
+const POLICY_MIGRATIONS = path.join(AI_DIST, 'agent-core-policy/drizzle');
+const COMPILER_MIGRATIONS = path.join(AI_DIST, 'agent-engine-compiler/drizzle');
+// ──────────────────────────────────────────────
+// argv parser
+// ──────────────────────────────────────────────
+/**
+ * Parse process.argv into a CliArgs object.
+ * Exits 1 with a usage message on any parse error.
+ */
+function parseArgs(argv) {
+    // argv: [ node, compile.js, 'compile', <slug?>, ...flags ]
+    const args = argv.slice(2); // strip node + script path
+    if (args[0] !== 'compile') {
+        die(`Expected sub-command 'compile', got: ${args[0] ?? '(nothing)'}`);
+    }
+    let slug = null;
+    let platform = 'claude_code';
+    let context = {};
+    let formatJson = false;
+    let outDir = null;
+    let all = false;
+    let category = null;
+    // AGENT_REGISTRY_DB is this CLI's own pre-existing, bin-specific legacy
+    // override (kept for back-compat) — it wins over the shared resolver's
+    // canonical default but not over an explicit --db flag (applied below).
+    // resolveRegistryDbPath() itself still checks the 3 documented
+    // registry-family env vars (ADHD_AGENT_REGISTRY_DB_PATH,
+    // REGISTRY_DATABASE_PATH, DATABASE_PATH) before falling back to the
+    // @adhd/environment-resolved canonical default.
+    let dbPath = process.env['AGENT_REGISTRY_DB'] ?? resolveRegistryDbPath();
+    const flags = args.slice(1); // everything after 'compile'
+    let i = 0;
+    while (i < flags.length) {
+        const tok = flags[i];
+        if (tok === '--platform') {
+            platform = requireNext(flags, i, '--platform');
+            i += 2;
+        }
+        else if (tok === '--context') {
+            const raw = requireNext(flags, i, '--context');
+            try {
+                // Parse as unknown first, then cast to CompositionContext (Record<string, string>).
+                // The runtime contract is that --context values are string-keyed, string-valued.
+                context = JSON.parse(raw);
+            }
+            catch {
+                die(`--context must be valid JSON; got: ${raw}`);
+            }
+            i += 2;
+        }
+        else if (tok === '--format') {
+            const fmt = requireNext(flags, i, '--format');
+            if (fmt !== 'json') {
+                die(`--format only supports 'json'; got: '${fmt}'`);
+            }
+            formatJson = true;
+            i += 2;
+        }
+        else if (tok === '--out-dir') {
+            outDir = requireNext(flags, i, '--out-dir');
+            i += 2;
+        }
+        else if (tok === '--all') {
+            all = true;
+            i++;
+        }
+        else if (tok === '--category') {
+            category = requireNext(flags, i, '--category');
+            i += 2;
+        }
+        else if (tok === '--db') {
+            dbPath = requireNext(flags, i, '--db');
+            i += 2;
+        }
+        else if (tok != null && !tok.startsWith('-')) {
+            // Positional slug — only accepted once.
+            if (slug !== null) {
+                die(`Unexpected extra positional argument: '${tok}'`);
+            }
+            slug = tok;
+            i++;
+        }
+        else {
+            die(`Unknown flag: '${tok}'`);
+        }
+    }
+    if (!all && slug === null) {
+        die('Provide a slug (compile <slug>) or use --all [--category <c>]');
+    }
+    if (all && slug !== null) {
+        die('--all and a positional slug are mutually exclusive');
+    }
+    return { slug, platform, context, formatJson, outDir, all, category, dbPath };
+}
+function requireNext(flags, i, flag) {
+    const val = flags[i + 1];
+    if (val == null || val.startsWith('-')) {
+        die(`${flag} requires a value`);
+    }
+    return val;
+}
+// ──────────────────────────────────────────────
+// DB open helper
+// ──────────────────────────────────────────────
+/**
+ * Open the shared SQLite registry file and apply migrations so the schema is
+ * always current ([inv:one-db-handle]).
+ *
+ * Runs all five migration sets in ascending timestamp order so Drizzle's
+ * journal does not skip any set.
+ */
+function openDb(dbPath) {
+    if (!fs.existsSync(dbPath)) {
+        const parent = path.dirname(dbPath);
+        if (!fs.existsSync(parent)) {
+            fs.mkdirSync(parent, { recursive: true });
+        }
+    }
+    const conn = new Database(dbPath);
+    conn.pragma('journal_mode = WAL');
+    conn.pragma('foreign_keys = OFF');
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const db = drizzle(conn, { schema: {} });
+    // Migrate in ascending timestamp order — same pattern as the test suite.
+    for (const folder of [
+        PROVIDER_MIGRATIONS,
+        REGISTRY_MIGRATIONS,
+        TOOL_REGISTRY_MIGRATIONS,
+        POLICY_MIGRATIONS,
+        COMPILER_MIGRATIONS,
+    ]) {
+        if (fs.existsSync(folder)) {
+            migrate(db, { migrationsFolder: folder });
+        }
+        else {
+            process.stderr.write(`agent-compiler: warning: migration folder not found: ${folder}\n`);
+        }
+    }
+    conn.pragma('foreign_keys = ON');
+    return { conn, db };
+}
+// ──────────────────────────────────────────────
+// Compile a single agent → string artifact
+// ──────────────────────────────────────────────
+function compileSingle(slug, args, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+db) {
+    let result;
+    try {
+        result = compileAgent({
+            agentSlug: slug,
+            platform: args.platform,
+            context: args.context,
+            db,
+        });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        // Distinguish AGENT_NOT_FOUND / PLATFORM_NOT_FOUND from other errors.
+        if (msg.includes('not found') || msg.includes('NOT_FOUND')) {
+            die(`Error: ${msg}`);
+        }
+        die(`Compilation failed for '${slug}' on platform '${args.platform}': ${msg}`);
+    }
+    // --format json overrides the platform's default header format.
+    if (args.formatJson) {
+        // If content is already JSON (json_object platforms), return as-is.
+        try {
+            JSON.parse(result.content);
+            return result.content; // already valid JSON
+        }
+        catch {
+            // Wrap markdown in a JSON envelope.
+            return JSON.stringify({
+                systemPrompt: result.content,
+                tools: result.tools,
+                componentVersions: result.componentVersions,
+            }, null, 2);
+        }
+    }
+    return result.content;
+}
+// ──────────────────────────────────────────────
+// Output helper
+// ──────────────────────────────────────────────
+/**
+ * Write content either to stdout or to <outDir>/<slug>.<ext>.
+ */
+function writeOutput(slug, content, args) {
+    if (args.outDir === null) {
+        process.stdout.write(content);
+        return;
+    }
+    fs.mkdirSync(args.outDir, { recursive: true });
+    const ext = args.formatJson ? 'json' : 'md';
+    const dest = path.join(args.outDir, `${slug}.${ext}`);
+    fs.writeFileSync(dest, content, 'utf8');
+}
+// ──────────────────────────────────────────────
+// Fatal error helper
+// ──────────────────────────────────────────────
+function die(msg) {
+    process.stderr.write(`agent-compiler: ${msg}\n`);
+    process.exit(1);
+}
+// ──────────────────────────────────────────────
+// Main
+// ──────────────────────────────────────────────
+function main() {
+    const args = parseArgs(process.argv);
+    const { conn, db } = openDb(args.dbPath);
+    try {
+        if (args.all) {
+            // Compile every agent in the registry, optionally filtered by category.
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const agentStore = new AgentStore(db);
+            const agents = agentStore.list(args.category ? { category: args.category } : {});
+            if (agents.length === 0) {
+                const scope = args.category ? ` in category '${args.category}'` : '';
+                process.stderr.write(`agent-compiler: no agents found${scope}\n`);
+                // Exit 0 — empty category is not an error.
+            }
+            for (const agent of agents) {
+                const content = compileSingle(agent.slug, args, db);
+                writeOutput(agent.slug, content, args);
+            }
+        }
+        else {
+            // Single-slug path.
+            // slug is guaranteed non-null here by parseArgs.
+            const content = compileSingle(args.slug, args, db);
+            writeOutput(args.slug, content, args);
+        }
+    }
+    finally {
+        conn.close();
+    }
+}
+main();
+//# sourceMappingURL=compile.js.map

package/src/cli/compile.js.map

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

package/src/compile.d.ts

@@ -0,0 +1,61 @@
+import type { BetterSQLite3Database } from 'drizzle-orm/better-sqlite3';
+import type { CompositionContext } from '@adhd/agent-store-prompts';
+import type { ComponentVersionMap } from './resolve/composition.js';
+import type { StructuredTool } from './emit/json.js';
+/** Input to compileAgent ([def:compile-input]). */
+export interface CompileInput {
+    /** Slug of the agent to compile. */
+    agentSlug: string;
+    /** Target platform id (e.g. 'claude_code', 'claude_api'). */
+    platform: string;
+    /** Runtime context key/value map for context-conditioned components. */
+    context?: CompositionContext;
+    /** Shared registry Drizzle handle (all four table prefixes — [inv:one-db-handle]). */
+    db: BetterSQLite3Database<any>;
+}
+/** Return value of compileAgent ([def:composed-output]). */
+export interface CompiledAgent {
+    /**
+     * `composed_prompts` row id (audit/cache handle).
+     * The inserted `registry_composed_prompts` row id (on MISS, written by the
+     * cache layer) or the existing row id (on HIT, served from the cache).
+     * Wired by the composed-prompt-caching state ([def:composed-output]).
+     */
+    id: number;
+    /** Flat platform artifact (markdown for claude_code, JSON string for claude_api/openai). */
+    content: string;
+    /**
+     * Resolved platform-shaped tools.
+     * For claude_code: string[] of aliases (e.g. ['Read','Grep','WebSearch']).
+     * For claude_api: StructuredTool[] (EmittedTool[]) shaped for the API.
+     * For none-format: [] (platform does not support tool selection).
+     */
+    tools: string[] | StructuredTool[];
+    /**
+     * Map of componentSlug → resolvedVersion for cache-key computation
+     * ([def:context-hash]).
+     */
+    componentVersions: ComponentVersionMap;
+}
+/**
+ * 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 declare function compileAgent(input: CompileInput): CompiledAgent;
+//# sourceMappingURL=compile.d.ts.map

package/src/compile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../src/compile.ts"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAGxE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAUpE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAUrD,mDAAmD;AACnD,MAAM,WAAW,YAAY;IAC3B,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,sFAAsF;IAEtF,EAAE,EAAE,qBAAqB,CAAC,GAAG,CAAC,CAAC;CAChC;AAED,4DAA4D;AAC5D,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,EAAE,EAAE,MAAM,CAAC;IACX,4FAA4F;IAC5F,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,KAAK,EAAE,MAAM,EAAE,GAAG,cAAc,EAAE,CAAC;IACnC;;;OAGG;IACH,iBAAiB,EAAE,mBAAmB,CAAC;CACxC;AA6DD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,aAAa,CA6N/D"}

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