@adhd/agent-engine-compiler 2.1.9 → 2.2.0

package/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 2.1.10 (2026-07-26)
+
+Re-publish fixing 2.1.9's own defects: an unsatisfiable `@adhd/agent-store-tools: ^2.1.9` dependency range (captured during a transient phantom-version-bump window on agent-store-tools that was later reverted — the real max published is 2.1.8) and a missing `README.md` in the published tarball (BUG-BUILD-ASSETS-CACHE-STALE-AFTER-CLEAN-001) — no code changes to this package itself.
+
 ## 2.1.9 (2026-07-26)
 
 Re-publish fixing an empty (1-file) tarball at 2.1.8, caused by BUG-BUILD-PUBLISH-DISTMANIFEST-CLOBBERED-001 in the shared `@adhd/nx-build:publish`/`:version` executors (see tools/nx-plugins/build/executors/publish/impl.js and .../version/impl.js) — no code changes to this package itself.

package/README.md

@@ -0,0 +1,72 @@
+# @adhd/agent-engine-compiler
+
+Compiles agent configurations from the registry into runtime-ready manifests. Resolves component compositions, tool bindings, policy constraints, and model specifications. Part of the agent registry family.
+
+**Status:** Shipped v2.1.2  
+**Platform:** `platform:node` (runs in Node/CLI, not browser)  
+**Consumers:** `@adhd/agent-mcp`, `@adhd/dispatch-cli`
+
+## What it does
+
+- **Body Resolution** — Assembles agent components from the registry composition store into a complete prompt body
+- **Tool Resolution** — Resolves tool aliases and platform-specific bindings (HTTP, MCP, CLI, etc.)
+- **Model Resolution** — Looks up model capabilities and configurations
+- **Policy Constraint Resolution** — Evaluates effective authorization policies
+- **Output Emission** — Compiles agent definitions into YAML frontmatter, JSON objects, or Markdown documents
+- **Database Migrations** — Runs schema setup via `runMigrationsOn(db)`
+
+## Usage
+
+First, resolve the shared registry database path:
+
+```typescript
+import { resolveRegistryDbPath } from '@adhd/agent-core-env';
+import Database from 'better-sqlite3';
+import { runMigrationsOn, compileAgent } from '@adhd/agent-engine-compiler';
+
+const dbPath = resolveRegistryDbPath(); // e.g., ~/.adhd/agent-registry/production/data/registry.db
+const db = new Database(dbPath);
+
+// Run migrations
+await runMigrationsOn(db);
+
+// Compile an agent from the registry
+const compiled = await compileAgent(db, {
+  agentId: 'my-agent',
+  platform: 'mcp', // or 'http', 'cli', 'json'
+  models: modelStore,
+  tools: toolStore,
+  policies: policyStore,
+  composition: compositionStore,
+});
+
+// Emit as YAML or JSON
+const yaml = emitYamlFrontmatter({
+  agentId: compiled.agentId,
+  tools: compiled.tools,
+  modelAlias: compiled.modelAlias,
+  policyConstraints: compiled.policyConstraints,
+});
+```
+
+## Key exports
+
+| Export | Purpose |
+|--------|---------|
+| `resolveBody(db, ...)` | Assemble component composition into prompt body |
+| `resolveTools(db, ...)` | Resolve tools and platform bindings |
+| `resolveModel(db, ...)` | Look up model and capabilities |
+| `resolvePolicyConstraints(db, ...)` | Resolve effective policies |
+| `compileAgent(db, input)` | Complete compilation orchestrator |
+| `emitYamlFrontmatter(input)` | Emit as YAML frontmatter + body |
+| `emitJsonObject(input)` | Emit as JSON (e.g., for REST API) |
+| `runMigrationsOn(db)` | Initialize database schema |
+
+## Architecture
+
+- **Tier**: `engine` (depends on base + core + stores)
+- **Consumption**: Reads from all registry family stores (prompts, tools, policy, provider)
+- **No import-time side effects** — DB path and connection are external (via `agent-core-env`)
+- **Part of agent registry family**: `agent-store-prompts` + `agent-store-tools` + `agent-core-policy` + `agent-core-provider` + `agent-engine-compiler`
+
+See `/entrypoint/agent-mcp/` for the agent MCP server (primary consumer).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adhd/agent-engine-compiler",
-  "version": "2.1.9",
+  "version": "2.2.0",
   "description": "Registry-family store for agent-compiler: drizzle-backed SQLite tables sharing the one registry database.",
   "type": "module",
   "publishConfig": {
@@ -18,11 +18,11 @@
   "dependencies": {
     "better-sqlite3": "12.10.0",
     "drizzle-orm": "0.45.2",
-    "@adhd/agent-store-prompts": "^2.1.7",
-    "@adhd/agent-store-tools": "^2.1.9",
-    "@adhd/agent-core-provider": "^2.1.9",
-    "@adhd/agent-core-policy": "^2.1.9",
-    "@adhd/agent-core-env": "^0.0.8"
+    "@adhd/agent-store-prompts": "^2.2.0",
+    "@adhd/agent-store-tools": "^2.2.0",
+    "@adhd/agent-core-provider": "^2.2.0",
+    "@adhd/agent-core-policy": "^2.2.0",
+    "@adhd/agent-core-env": "^0.1.0"
   },
   "license": "MIT",
   "repository": {