@cef-ai/cli 0.2.7 → 0.4.0

package/dist/cli-program.js

@@ -0,0 +1,171 @@
+/**
+ * Commander program factory shared by `./cli.ts` (the bin entry) and the
+ * integration tests. Splitting it out keeps the binary itself a thin
+ * wrapper that just calls `buildProgram().parseAsync(argv)` while letting
+ * tests construct the same wiring without triggering top-level argv
+ * parsing on import.
+ */
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { Command } from "commander";
+import { cefBuild } from "./commands/build.js";
+import { cefInspect } from "./commands/inspect.js";
+import { cefKeypairGenerate } from "./commands/keypair.js";
+import { cefPublish } from "./commands/publish.js";
+import { cefTypegen } from "./commands/typegen.js";
+export const DEFAULT_MARKETPLACE_URL = "https://agent-marketplace.compute.dev.ddcdragon.com";
+function defaultOnError(err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    console.error(msg);
+    process.exit(1);
+}
+export function buildProgram(opts = {}) {
+    const onError = opts.onError ?? defaultOnError;
+    // dist/cli-program.js → ../package.json (when running compiled).
+    // src/cli-program.ts → ../package.json (when running via vitest in src/).
+    const __dirname = path.dirname(fileURLToPath(import.meta.url));
+    const pkg = JSON.parse(readFileSync(path.join(__dirname, "..", "package.json"), "utf8"));
+    const program = new Command();
+    program
+        .name("cef")
+        .description("CEF agent build & test CLI")
+        .version(pkg.version);
+    program
+        .command("build")
+        .description("Build agent bundle.js + manifest.json")
+        .option("--config <path>", "Path to cef.config.ts")
+        .option("--out <dir>", "Output directory", "dist")
+        .action(async (subOpts) => {
+        try {
+            const result = await cefBuild({
+                configPath: subOpts.config,
+                outDir: subOpts.out,
+            });
+            for (const a of result.agents) {
+                console.log(`[ok] ${a.agentId} -> ${a.bundlePath} (${a.bundleBytes} bytes)`);
+                console.log(`[ok] ${a.agentId} -> ${a.manifestPath}`);
+            }
+        }
+        catch (e) {
+            onError(e);
+        }
+    });
+    program
+        .command("typegen")
+        .description("Generate .cef/generated.d.ts and update cef.lock.json")
+        .option("--config <path>", "Path to cef.config.ts")
+        .action(async (subOpts) => {
+        try {
+            const result = await cefTypegen({ configPath: subOpts.config });
+            console.log(`[ok] ${result.generatedPath}`);
+            console.log(`[ok] ${result.lockfilePath}`);
+        }
+        catch (e) {
+            onError(e);
+        }
+    });
+    program
+        .command("inspect <agentDir>")
+        .description("Inspect a built bundle + manifest")
+        .action(async (agentDir) => {
+        try {
+            const result = await cefInspect({ agentDir });
+            const anyMissing = result.engagements.some((e) => e.missingMethods.length > 0);
+            if (anyMissing)
+                process.exit(2);
+        }
+        catch (e) {
+            onError(e);
+        }
+    });
+    // Stubs — implemented in subsequent milestones.
+    program
+        .command("test")
+        .description("(stub) run agent tests")
+        .action(() => {
+        console.log("cef test: not yet implemented (use vitest directly for now)");
+    });
+    program
+        .command("publish")
+        .description("Publish a built agent's manifest to the marketplace")
+        .option("--marketplace <url>", "Marketplace base URL (overrides $CEF_MARKETPLACE_URL)")
+        .option("--agent <id>", "Which dist/<id>/ to publish (defaults to the only built agent)")
+        .option("--privkey <hex>", "AS private key (hex, 64 chars). Pair with --pubkey.")
+        .option("--pubkey <hex>", "AS public key (hex, 64 chars). Pair with --privkey.")
+        .option("--keystore <path>", "Path to a JSON keystore file `{ pubkey, privkey }`")
+        .option("--profile <name>", "Profile section in ~/.config/cef/credentials (default: 'default')")
+        .option("--out <dir>", "Output directory the build wrote to (defaults to dist)", "dist")
+        .action(async (subOpts) => {
+        try {
+            const marketplaceUrl = subOpts.marketplace ??
+                process.env.CEF_MARKETPLACE_URL ??
+                DEFAULT_MARKETPLACE_URL;
+            const publishOpts = {
+                marketplaceUrl,
+                ...(subOpts.agent !== undefined ? { agentId: subOpts.agent } : {}),
+                ...(subOpts.privkey !== undefined ? { privkey: subOpts.privkey } : {}),
+                ...(subOpts.pubkey !== undefined ? { pubkey: subOpts.pubkey } : {}),
+                ...(subOpts.keystore !== undefined ? { keystore: subOpts.keystore } : {}),
+                ...(subOpts.profile !== undefined ? { profile: subOpts.profile } : {}),
+                ...(subOpts.out !== undefined ? { distDir: subOpts.out } : {}),
+                ...(opts.fetchImpl !== undefined ? { fetchImpl: opts.fetchImpl } : {}),
+            };
+            const result = await cefPublish(publishOpts);
+            console.log(`✓ Published ${result.agentId}@${result.version}`);
+            console.log(`  agentId:     ${result.agentId}`);
+            console.log(`  pubkey:      ${result.pubkey}`);
+            console.log(`  manifestCid: ${result.manifestCid}`);
+        }
+        catch (e) {
+            // CredentialsError carries either a single-line typo message or
+            // the canonical multi-line "no AS credentials configured" guidance
+            // block. Both ship through `onError` unchanged — the default impl
+            // writes to stderr, which is what we want.
+            onError(e);
+        }
+    });
+    const keypair = program
+        .command("keypair")
+        .description("Manage AS Ed25519 keypairs (Agent Service identity)");
+    keypair
+        .command("generate")
+        .description("Generate a new AS keypair (stdout, --out file, or --profile)")
+        .option("--out <path>", "Write the JSON keypair to <path> (mode 0600); refuses existing unless --force")
+        .option("--profile <name>", "Write/merge into ~/.config/cef/credentials under [<name>] (mode 0600)")
+        .option("--force", "Overwrite an existing --out file or --profile section")
+        .action(async (subOpts) => {
+        try {
+            const result = await cefKeypairGenerate({
+                ...(subOpts.out !== undefined ? { out: subOpts.out } : {}),
+                ...(subOpts.profile !== undefined ? { profile: subOpts.profile } : {}),
+                ...(subOpts.force !== undefined ? { force: subOpts.force } : {}),
+            });
+            if (result.path === undefined && result.profile === undefined) {
+                // Default sink: print the JSON to stdout.
+                process.stdout.write(JSON.stringify({ pubkey: result.pubkey, privkey: result.privkey }) +
+                    "\n");
+                return;
+            }
+            const profileSuffix = result.profile
+                ? ` [profile: ${result.profile}]`
+                : "";
+            console.log(`✓ AS keypair written to ${result.path}${profileSuffix}`);
+            console.log(`  Pubkey: ${result.pubkey}`);
+            console.log("  This keypair is your Agent Service identity. Keep the private key safe.");
+            console.log("  To share with your team, hand them the file or sync it through your team's");
+            console.log("  secrets manager — do NOT generate a new one for each developer.");
+        }
+        catch (e) {
+            onError(e);
+        }
+    });
+    program
+        .command("dev")
+        .description("(stub) run dev loop")
+        .action(() => {
+        console.log("cef dev: not yet implemented");
+    });
+    return program;
+}
+//# sourceMappingURL=cli-program.js.map

package/dist/cli-program.js.map

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

package/dist/cli.d.ts

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
-import { Command } from 'commander';
-export declare function createProgram(): Command;
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -1,69 +1,29 @@
 #!/usr/bin/env node
-import fs from 'fs';
-import path from 'path';
-import { fileURLToPath } from 'url';
-import { Command } from 'commander';
-import { registerAuthCommands } from './commands/auth/index.js';
-import { registerDeployCommands } from './commands/deploy/index.js';
-import { registerServiceCommands } from './commands/service/index.js';
-import { registerPlaygroundCommands } from './commands/playground/index.js';
-import { registerDevCommands } from './commands/dev/index.js';
-function getVersion() {
-    try {
-        const dir = path.dirname(fileURLToPath(import.meta.url));
-        const pkgPath = path.join(dir, '..', 'package.json');
-        const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
-        return pkg.version ?? '0.0.0';
-    }
-    catch {
-        return '0.0.0';
-    }
+/**
+ * `cef` CLI binary entry point. Wires the programmatic command functions
+ * (re-exported from `./lib.ts`) into commander subcommands.
+ *
+ * Subcommands implemented:
+ *   - build    : bundle agents per cef.config.ts
+ *   - typegen  : generate .cef/generated.d.ts + cef.lock.json
+ *   - inspect  : print manifest routing + bundle methods for a built agent
+ *   - publish  : sign + POST a built manifest to the marketplace API
+ *
+ * Stubs (planned for the next phase):
+ *   - test, dev
+ */
+import { buildProgram } from "./cli-program.js";
+function fail(err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    console.error(msg);
+    process.exit(1);
 }
-function showWelcome(version) {
-    console.log(`
-  \x1b[1mCEF AI CLI\x1b[0m \x1b[2mv${version}\x1b[0m
-
-  \x1b[36mQuick start:\x1b[0m
-
-    \x1b[33m$\x1b[0m cef login                Authenticate with CEF platform
-    \x1b[33m$\x1b[0m cef dev                  Start local dev server with UI
-    \x1b[33m$\x1b[0m cef deploy               Deploy topology to orchestrator
-    \x1b[33m$\x1b[0m cef status               Compare local vs deployed state
-
-  \x1b[36mOther commands:\x1b[0m
-
-    \x1b[33m$\x1b[0m cef service list          List agent services
-    \x1b[33m$\x1b[0m cef service create        Create a new agent service
-    \x1b[33m$\x1b[0m cef clone --pubkey <key>  Download existing service
-    \x1b[33m$\x1b[0m cef delete               Delete deployed entities
-    \x1b[33m$\x1b[0m cef --help               Show all options
-
-  \x1b[2mDocs: https://github.com/CEF-AI/deploy-sdk#readme\x1b[0m
-`);
+// Top-level await is fine: the package is "type": "module" with
+// "module": "NodeNext" which targets ES2022.
+try {
+    await buildProgram().parseAsync(process.argv);
 }
-export function createProgram() {
-    const program = new Command();
-    program
-        .name('cef')
-        .description('CEF AI command-line interface')
-        .version(getVersion(), '-V, --version');
-    registerAuthCommands(program);
-    registerDeployCommands(program);
-    registerServiceCommands(program);
-    registerPlaygroundCommands(program);
-    registerDevCommands(program);
-    return program;
-}
-const isDirectRun = process.argv[1] &&
-    (fileURLToPath(import.meta.url) === process.argv[1] ||
-        process.argv[1].endsWith('/cli.js'));
-if (isDirectRun) {
-    const program = createProgram();
-    // No args (or only node + script): show welcome instead of crashing into deploy
-    const userArgs = process.argv.slice(2);
-    if (userArgs.length === 0) {
-        showWelcome(getVersion());
-        process.exit(0);
-    }
-    program.parse();
+catch (e) {
+    fail(e);
 }
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,SAAS,IAAI,CAAC,GAAY;IACxB,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7D,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,gEAAgE;AAChE,6CAA6C;AAC7C,IAAI,CAAC;IACH,MAAM,YAAY,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAChD,CAAC;AAAC,OAAO,CAAC,EAAE,CAAC;IACX,IAAI,CAAC,CAAC,CAAC,CAAC;AACV,CAAC"}

package/dist/commands/build.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Public options for `cefBuild`. Defaults are deliberately CWD-relative so
+ * the function is usable both from the CLI binary and programmatically
+ * from tests / scripts.
+ */
+export interface CefBuildOptions {
+    /** Project root. Defaults to `process.cwd()`. */
+    cwd?: string;
+    /** Path to `cef.config.ts`. Defaults to `<cwd>/cef.config.ts`. */
+    configPath?: string;
+    /** Output root. Defaults to `<cwd>/dist`. Each agent gets `<outDir>/<agentId>/`. */
+    outDir?: string;
+}
+export interface CefBuildResult {
+    agents: Array<{
+        agentId: string;
+        bundlePath: string;
+        manifestPath: string;
+        bundleBytes: number;
+    }>;
+}
+/**
+ * Build all agents declared in `cef.config.ts` to `<outDir>/<agentId>/`.
+ *
+ * For each leaf agent we:
+ * 1. Normalize the engagement layer (`entry` shorthand → one default
+ *    engagement, or pass `engagements[]` through with absolute paths).
+ * 2. Run static lints PER ENGAGEMENT (so each entry source gets its own
+ *    publishes derivation).
+ * 3. Bundle all engagements into one IIFE (with footer that builds
+ *    `__cefAgent.engagements[id] = new Cls()`).
+ * 4. Execute the bundle in a fresh `vm` sandbox to read decorator metadata
+ *    per engagement.
+ * 5. Combine that metadata + lint output + agent-level config to emit
+ *    `manifest.json` (engagements[] + targeting + agent-level cubbies/...).
+ *
+ * Returns a list of artefact paths suitable for further pipeline stages
+ * (e.g. `cef publish` consuming the bundle/manifest pair).
+ */
+export declare function cefBuild(opts?: CefBuildOptions): Promise<CefBuildResult>;
+//# sourceMappingURL=build.d.ts.map

package/dist/commands/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/commands/build.ts"],"names":[],"mappings":"AA2BA;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,iDAAiD;IACjD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oFAAoF;IACpF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,KAAK,CAAC;QACZ,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;CACJ;AA2KD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,QAAQ,CAAC,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,CA4FlF"}

package/dist/commands/build.js

@@ -0,0 +1,252 @@
+import crypto from "node:crypto";
+import fs from "node:fs/promises";
+import path from "node:path";
+import vm from "node:vm";
+import * as esbuild from "esbuild";
+import { ENGAGEMENT_METADATA } from "@cef-ai/agent-sdk";
+import { ESBUILD_GLOBAL_NAME, IIFE_FOOTER, } from "../build/esbuild-plugin.js";
+import { lintAgentSource } from "../build/lints.js";
+import { flattenAgents, loadConfig, normalizeEngagements, } from "../build/load-config.js";
+import { emitManifest, } from "../build/manifest.js";
+import { validateTargeting } from "../build/targeting.js";
+/**
+ * Walk up from `start` looking for an existing `node_modules` directory.
+ * Mirrors {@link loadConfig}'s walk so the temp wrapper file is placed
+ * somewhere that node's ESM resolver / esbuild can locate `@cef-ai/agent-sdk`.
+ *
+ * Returns the *parent* directory (the one CONTAINING `node_modules`), or
+ * `null` if none was found.
+ */
+async function findNodeModulesParent(start) {
+    let dir = path.resolve(start);
+    while (true) {
+        try {
+            const stat = await fs.stat(path.join(dir, "node_modules"));
+            if (stat.isDirectory())
+                return dir;
+        }
+        catch {
+            // not here, keep walking up
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+}
+/**
+ * Generate the temporary wrapper module that imports each engagement's
+ * default export and re-exports the map as `engagements`. esbuild bundles
+ * this wrapper as the entry point; the IIFE footer (see esbuild-plugin.ts)
+ * picks the map up from `globalThis.__cefBundle.engagements` and
+ * instantiates each class.
+ *
+ * Imports use absolute file paths so resolution doesn't depend on the
+ * wrapper's directory.
+ */
+function renderWrapperSource(engagements) {
+    const importLines = engagements
+        .map((e, i) => `import _e${i} from ${JSON.stringify(e.entry)};`)
+        .join("\n");
+    const mapBody = engagements
+        .map((e, i) => `  ${JSON.stringify(e.id)}: _e${i}`)
+        .join(",\n");
+    return `${importLines}\nexport const engagements = {\n${mapBody}\n};\n`;
+}
+/**
+ * Bundle one agent's engagement set into `<outDir>/<agentId>/bundle.js`.
+ *
+ * The flow is:
+ *   1. Render a temp wrapper that pulls in every engagement's default
+ *      export and re-exports them under `engagements`.
+ *   2. Run esbuild on the wrapper (IIFE + footer).
+ *   3. Execute the bundle in a fresh `vm` context to read each engagement
+ *      class's decorator metadata (the `__cefAgent.engagements[id]`
+ *      instance's `constructor[ENGAGEMENT_METADATA]`).
+ *
+ * Decorators are still TC39-stage-2 syntax in our SDK, so we feed esbuild
+ * a `tsconfigRaw` that turns on `experimentalDecorators` regardless of
+ * what the host project's tsconfig says.
+ */
+async function bundleAgent(args) {
+    const { agent, engagements, configDir, outDir } = args;
+    const agentOutDir = path.join(outDir, agent.id);
+    const bundlePath = path.join(agentOutDir, "bundle.js");
+    await fs.mkdir(agentOutDir, { recursive: true });
+    // Place the wrapper inside an existing `node_modules/.cef/build-cache/`
+    // ancestor so its `@cef-ai/agent-sdk` import (transitively reached through
+    // the engagement files) resolves identically to how loadConfig does it.
+    const nmParent = await findNodeModulesParent(configDir);
+    if (!nmParent) {
+        throw new Error(`[@cef-ai/cli] could not find a node_modules ancestor of ${configDir}; install dependencies first`);
+    }
+    const cacheDir = path.join(nmParent, "node_modules", ".cef", "build-cache");
+    await fs.mkdir(cacheDir, { recursive: true });
+    const wrapperPath = path.join(cacheDir, `wrapper-${agent.id}-${process.pid}-${crypto.randomBytes(6).toString("hex")}.ts`);
+    await fs.writeFile(wrapperPath, renderWrapperSource(engagements), "utf8");
+    try {
+        await esbuild.build({
+            entryPoints: [wrapperPath],
+            bundle: true,
+            format: "iife",
+            target: "es2022",
+            platform: "neutral",
+            globalName: ESBUILD_GLOBAL_NAME,
+            outfile: bundlePath,
+            footer: { js: IIFE_FOOTER },
+            logLevel: "silent",
+            // Inline everything; the runtime sandbox has no module loader.
+            external: [],
+            tsconfigRaw: JSON.stringify({
+                compilerOptions: {
+                    experimentalDecorators: true,
+                    target: "es2022",
+                    useDefineForClassFields: false,
+                },
+            }),
+            conditions: ["import", "node"],
+        });
+    }
+    finally {
+        await fs.unlink(wrapperPath).catch(() => { });
+    }
+    // Read the metadata back by executing the bundle in a fresh vm sandbox.
+    // The IIFE constructs one instance per engagement and assigns the map to
+    // globalThis.__cefAgent.engagements[id]; ENGAGEMENT_METADATA hangs off
+    // each instance's class.
+    const bundleSource = await fs.readFile(bundlePath, "utf8");
+    const sandbox = { console };
+    sandbox.globalThis = sandbox;
+    try {
+        vm.runInNewContext(bundleSource, sandbox);
+    }
+    catch (e) {
+        const msg = e?.message ?? String(e);
+        throw new Error(`[@cef-ai/cli] agent "${agent.id}" threw while initializing for metadata extraction. ` +
+            `Constructors must be side-effect-free for cef build to read decorator metadata. ` +
+            `Original error: ${msg}`);
+    }
+    const cefAgent = sandbox.__cefAgent;
+    if (!cefAgent || !cefAgent.engagements) {
+        throw new Error(`[@cef-ai/cli] agent "${agent.id}": bundle did not set globalThis.__cefAgent.engagements`);
+    }
+    const metas = new Map();
+    for (const e of engagements) {
+        const inst = cefAgent.engagements[e.id];
+        if (!inst) {
+            throw new Error(`[@cef-ai/cli] engagement "${e.id}" in agent "${agent.id}": not present in __cefAgent.engagements`);
+        }
+        const meta = inst.constructor[ENGAGEMENT_METADATA];
+        if (!meta) {
+            throw new Error(`[@cef-ai/cli] engagement "${e.id}" in agent "${agent.id}": class has no @OnEvent/@OnStart/@OnClose/@Engagement decorators`);
+        }
+        if (meta.id !== undefined && meta.id !== e.id) {
+            throw new Error(`[@cef-ai/cli] engagement "${e.id}" in agent "${agent.id}": @Engagement decorator declares id "${meta.id}" but config declares "${e.id}"`);
+        }
+        metas.set(e.id, meta);
+    }
+    const stat = await fs.stat(bundlePath);
+    return { bundlePath, bundleBytes: stat.size, metas };
+}
+/**
+ * Build all agents declared in `cef.config.ts` to `<outDir>/<agentId>/`.
+ *
+ * For each leaf agent we:
+ * 1. Normalize the engagement layer (`entry` shorthand → one default
+ *    engagement, or pass `engagements[]` through with absolute paths).
+ * 2. Run static lints PER ENGAGEMENT (so each entry source gets its own
+ *    publishes derivation).
+ * 3. Bundle all engagements into one IIFE (with footer that builds
+ *    `__cefAgent.engagements[id] = new Cls()`).
+ * 4. Execute the bundle in a fresh `vm` sandbox to read decorator metadata
+ *    per engagement.
+ * 5. Combine that metadata + lint output + agent-level config to emit
+ *    `manifest.json` (engagements[] + targeting + agent-level cubbies/...).
+ *
+ * Returns a list of artefact paths suitable for further pipeline stages
+ * (e.g. `cef publish` consuming the bundle/manifest pair).
+ */
+export async function cefBuild(opts = {}) {
+    const cwd = opts.cwd ? path.resolve(opts.cwd) : process.cwd();
+    const configPath = opts.configPath
+        ? path.resolve(cwd, opts.configPath)
+        : path.join(cwd, "cef.config.ts");
+    const outDir = opts.outDir ? path.resolve(cwd, opts.outDir) : path.join(cwd, "dist");
+    const configDir = path.dirname(configPath);
+    const config = await loadConfig(configPath, configDir);
+    const leaves = flattenAgents(config);
+    const agents = [];
+    for (const agent of leaves) {
+        const engagements = normalizeEngagements(agent, configDir);
+        // 1. Static lints — runs BEFORE esbuild so authors get a clean error
+        //    location on the source rather than a transformed bundle line.
+        //    Per-engagement so every entry source is audited and we collect
+        //    per-engagement publishes for the manifest.
+        const declaredCubbyAliases = new Set((agent.cubbies ?? []).map((c) => c.alias));
+        const declaredModelAliases = new Set(Object.keys(agent.models ?? {}));
+        const perEngagementPublishes = new Map();
+        for (const e of engagements) {
+            const lintResult = lintAgentSource({
+                entryPath: e.entry,
+                declaredCubbyAliases,
+                declaredModelAliases,
+            });
+            perEngagementPublishes.set(e.id, lintResult.publishes);
+        }
+        // 2. Validate targeting BEFORE bundling so authors get an early failure
+        //    that points at cef.config.ts rather than wading through esbuild
+        //    output for what's a config-level mistake.
+        const { targeting } = validateTargeting({
+            agentId: agent.id,
+            engagementIds: engagements.map((e) => e.id),
+            targeting: agent.targeting,
+        });
+        const { bundlePath, bundleBytes, metas } = await bundleAgent({
+            agent,
+            engagements,
+            configDir,
+            outDir,
+        });
+        const engagementInputs = engagements.map((e) => {
+            const meta = metas.get(e.id);
+            const input = {
+                id: e.id,
+                events: meta.events ?? {},
+                lifecycle: meta.lifecycle ?? {},
+                publishes: perEngagementPublishes.get(e.id) ?? [],
+            };
+            if (meta.goal !== undefined)
+                input.goal = meta.goal;
+            return input;
+        });
+        const manifestPath = path.join(outDir, agent.id, "manifest.json");
+        await emitManifest(manifestPath, {
+            agentId: agent.id,
+            version: agent.version,
+            bundlePath,
+            engagements: engagementInputs,
+            config: {
+                alias: agent.alias,
+                source: agent.source,
+                card: agent.card,
+                requiredScopes: agent.requiredScopes,
+                idleTimeout: agent.idleTimeout,
+                cubbies: agent.cubbies,
+                settings: agent.settings,
+                models: agent.models,
+                uses: agent.uses,
+                eventSchemas: agent.eventSchemas,
+            },
+            configDir,
+            targeting,
+        });
+        agents.push({
+            agentId: agent.id,
+            bundlePath,
+            manifestPath,
+            bundleBytes,
+        });
+    }
+    return { agents };
+}
+//# sourceMappingURL=build.js.map

package/dist/commands/build.js.map

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

package/dist/commands/inspect.d.ts

@@ -0,0 +1,49 @@
+import type { Targeting } from "../build/load-config.js";
+/**
+ * Public options for `cefInspect`. The agent directory is the only required
+ * input; logging can be disabled when calling programmatically (tests).
+ */
+export interface CefInspectOptions {
+    /** Directory containing `manifest.json` and `bundle.js`. */
+    agentDir: string;
+    /** When false, suppress console output. Defaults to true. */
+    print?: boolean;
+}
+export interface InspectEngagement {
+    id: string;
+    goal?: string;
+    /** eventType → handlerName, copied from `manifest.engagements[i].handles`. */
+    handles: Record<string, string>;
+    /** Method names exposed on this engagement's instance, sorted alphabetically. */
+    exposedMethods: string[];
+    /** Names referenced by manifest routing that aren't on the engagement instance. */
+    missingMethods: string[];
+}
+export interface CefInspectResult {
+    manifest: {
+        /** Marketplace alias / build id. */
+        alias: string;
+        version: string;
+        cubbies: string[];
+        models: string[];
+        handles: string[];
+        publishes: string[];
+        targeting: Targeting;
+    };
+    engagements: InspectEngagement[];
+}
+/**
+ * Inspect a built agent directory.
+ *
+ * Reads `<agentDir>/manifest.json` for the per-engagement routing tables
+ * and executes `<agentDir>/bundle.js` in a fresh `node:vm` context to
+ * enumerate the methods actually exposed on each
+ * `globalThis.__cefAgent.engagements[id]` instance. The two views are
+ * useful for confirming that each manifest engagement's `handlerName`
+ * strings match real methods on the bundled instance.
+ *
+ * Pure exploration: no files are written, no network. Safe to run on any
+ * `dist/<agentId>/` directory.
+ */
+export declare function cefInspect(opts: CefInspectOptions): Promise<CefInspectResult>;
+//# sourceMappingURL=inspect.d.ts.map