@cef-ai/cli 0.2.7 → 0.4.0

package/dist/build/load-config.js

@@ -0,0 +1,150 @@
+import crypto from "node:crypto";
+import fs from "node:fs/promises";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+import * as esbuild from "esbuild";
+/**
+ * Walk up from `start` looking for an existing `node_modules` directory.
+ * We need this because the externalised `@cef-ai/agent-sdk` reference in the
+ * compiled config file is resolved by node's ESM loader from the file's
+ * location — so the temp file must sit somewhere whose ancestors include
+ * a `node_modules` containing `@cef-ai/agent-sdk`.
+ *
+ * Returns the *parent* directory (i.e. the directory that *contains* the
+ * `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;
+    }
+}
+/**
+ * Compile `cef.config.ts` to a temp ESM file and dynamically import it.
+ *
+ * `@cef-ai/agent-sdk` and `@cef-ai/agent-sdk/config` are externalised so the
+ * `defineAgent` identity helper resolves from the host's node_modules at
+ * runtime — we don't want to bundle the SDK into the user's config.
+ *
+ * The temp file is placed inside an existing `node_modules` ancestor of
+ * the config (under `node_modules/.cef/config-cache/`), so node's ESM
+ * resolver finds the externalised packages without us having to create a
+ * stub `node_modules` next to the user's config.
+ *
+ * Shared by `cef build` and `cef typegen`.
+ */
+export async function loadConfig(configPath, configDir) {
+    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 tmpDir = path.join(nmParent, "node_modules", ".cef", "config-cache");
+    await fs.mkdir(tmpDir, { recursive: true });
+    const tmpFile = path.join(tmpDir, `config-${process.pid}-${crypto.randomBytes(6).toString("hex")}.mjs`);
+    try {
+        await esbuild.build({
+            entryPoints: [configPath],
+            bundle: true,
+            format: "esm",
+            platform: "node",
+            target: "es2022",
+            outfile: tmpFile,
+            logLevel: "silent",
+            // Resolve these from the host package's node_modules at runtime.
+            external: ["@cef-ai/agent-sdk", "@cef-ai/agent-sdk/*"],
+        });
+        const mod = await import(pathToFileURL(tmpFile).href);
+        const cfg = mod.default;
+        if (!cfg || typeof cfg !== "object") {
+            throw new Error(`[@cef-ai/cli] ${configPath} must default-export an AgentConfig (got ${typeof cfg})`);
+        }
+        return cfg;
+    }
+    finally {
+        // Best-effort cleanup; ignore if already gone.
+        await fs.unlink(tmpFile).catch(() => { });
+    }
+}
+/**
+ * Flatten a (possibly nested) `AgentConfig` into a list of leaf agents.
+ * The single-agent case is a top-level config with `entry` (or
+ * `engagements`). The nested-agents case has an `agents[]` field; each
+ * entry is a full AgentConfig and is recursed into. We require either
+ * `entry` or `engagements[]` on every leaf.
+ */
+export function flattenAgents(cfg) {
+    if (cfg.agents && cfg.agents.length > 0) {
+        return cfg.agents.flatMap((a) => flattenAgents(a));
+    }
+    if (!cfg.entry && (!cfg.engagements || cfg.engagements.length === 0)) {
+        throw new Error(`[@cef-ai/cli] AgentConfig "${cfg.id}" has no \`entry\`, no \`engagements[]\`, and no nested \`agents[]\``);
+    }
+    return [cfg];
+}
+/** Regex for a stable engagement id. Letters/digits/underscore/dash, must
+ * start with a letter (mirrors typical identifier rules; "default" is fine). */
+const ENGAGEMENT_ID_RE = /^[a-zA-Z][a-zA-Z0-9_-]*$/;
+/**
+ * Normalize an agent's engagement-layer declaration into a list with absolute
+ * entry paths. Accepts either:
+ *
+ * - `entry: "./src/agent.ts"` shorthand → one engagement with id `"default"`.
+ * - `engagements: [{ id, entry }, ...]` explicit form → returned as-is with
+ *   relative entry paths resolved against `configDir`.
+ *
+ * Validates:
+ * - exactly one of `entry`/`engagements` is provided,
+ * - `engagements[]` has at least one entry when present,
+ * - every engagement id matches `[a-zA-Z][a-zA-Z0-9_-]*`,
+ * - engagement ids are unique within the agent.
+ *
+ * Throws on any violation with `[@cef-ai/cli]`-prefixed errors so failures point
+ * authors at their `cef.config.ts`.
+ */
+export function normalizeEngagements(agent, configDir) {
+    const hasEntry = typeof agent.entry === "string" && agent.entry.length > 0;
+    const hasList = Array.isArray(agent.engagements) && agent.engagements.length > 0;
+    if (hasEntry && hasList) {
+        throw new Error(`[@cef-ai/cli] agent "${agent.id}": specify either 'entry' or 'engagements', not both`);
+    }
+    if (!hasEntry && !hasList) {
+        throw new Error(`[@cef-ai/cli] agent "${agent.id}": missing 'entry' or 'engagements'`);
+    }
+    if (agent.engagements && agent.engagements.length === 0) {
+        throw new Error(`[@cef-ai/cli] agent "${agent.id}": 'engagements' must contain at least one entry`);
+    }
+    const list = hasList
+        ? agent.engagements
+        : [{ id: "default", entry: agent.entry }];
+    const seen = new Set();
+    const out = [];
+    for (const e of list) {
+        if (typeof e.id !== "string" || e.id.length === 0) {
+            throw new Error(`[@cef-ai/cli] agent "${agent.id}": engagement entry has empty 'id'`);
+        }
+        if (!ENGAGEMENT_ID_RE.test(e.id)) {
+            throw new Error(`[@cef-ai/cli] engagement id "${e.id}" must match /^[a-zA-Z][a-zA-Z0-9_-]*$/`);
+        }
+        if (seen.has(e.id)) {
+            throw new Error(`[@cef-ai/cli] duplicate engagement id "${e.id}"`);
+        }
+        seen.add(e.id);
+        if (typeof e.entry !== "string" || e.entry.length === 0) {
+            throw new Error(`[@cef-ai/cli] agent "${agent.id}": engagement "${e.id}" has empty 'entry'`);
+        }
+        out.push({ id: e.id, entry: path.resolve(configDir, e.entry) });
+    }
+    return out;
+}
+//# sourceMappingURL=load-config.js.map

package/dist/build/load-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-config.js","sourceRoot":"","sources":["../../src/build/load-config.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AA2EnC;;;;;;;;;GASG;AACH,KAAK,UAAU,qBAAqB,CAAC,KAAa;IAChD,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC9B,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,CAAC;YAC3D,IAAI,IAAI,CAAC,WAAW,EAAE;gBAAE,OAAO,GAAG,CAAC;QACrC,CAAC;QAAC,MAAM,CAAC;YACP,4BAA4B;QAC9B,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,MAAM,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC;QAChC,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,UAAkB,EAClB,SAAiB;IAEjB,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,SAAS,CAAC,CAAC;IACxD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CACb,2DAA2D,SAAS,8BAA8B,CACnG,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC;IAC3E,MAAM,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CACvB,MAAM,EACN,UAAU,OAAO,CAAC,GAAG,IAAI,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CACrE,CAAC;IACF,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,KAAK,CAAC;YAClB,WAAW,EAAE,CAAC,UAAU,CAAC;YACzB,MAAM,EAAE,IAAI;YACZ,MAAM,EAAE,KAAK;YACb,QAAQ,EAAE,MAAM;YAChB,MAAM,EAAE,QAAQ;YAChB,OAAO,EAAE,OAAO;YAChB,QAAQ,EAAE,QAAQ;YAClB,iEAAiE;YACjE,QAAQ,EAAE,CAAC,mBAAmB,EAAE,qBAAqB,CAAC;SACvD,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC;QACtD,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC;QACxB,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CACb,iBAAiB,UAAU,4CAA4C,OAAO,GAAG,GAAG,CACrF,CAAC;QACJ,CAAC;QACD,OAAO,GAAsB,CAAC;IAChC,CAAC;YAAS,CAAC;QACT,+CAA+C;QAC/C,MAAM,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,GAAoB;IAChD,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxC,OAAO,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,KAAK,CACb,8BAA8B,GAAG,CAAC,EAAE,sEAAsE,CAC3G,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED;gFACgF;AAChF,MAAM,gBAAgB,GAAG,0BAA0B,CAAC;AAEpD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAsB,EACtB,SAAiB;IAEjB,MAAM,QAAQ,GAAG,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IAC3E,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;IAEjF,IAAI,QAAQ,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,wBAAwB,KAAK,CAAC,EAAE,sDAAsD,CACvF,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,QAAQ,IAAI,CAAC,OAAO,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,wBAAwB,KAAK,CAAC,EAAE,qCAAqC,CACtE,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CACb,wBAAwB,KAAK,CAAC,EAAE,kDAAkD,CACnF,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,OAAO;QAClB,CAAC,CAAC,KAAK,CAAC,WAAY;QACpB,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,KAAM,EAAE,CAAC,CAAC;IAE7C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,IAAI,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ,IAAI,CAAC,CAAC,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClD,MAAM,IAAI,KAAK,CACb,wBAAwB,KAAK,CAAC,EAAE,oCAAoC,CACrE,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CACb,gCAAgC,CAAC,CAAC,EAAE,yCAAyC,CAC9E,CAAC;QACJ,CAAC;QACD,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACrE,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACf,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxD,MAAM,IAAI,KAAK,CACb,wBAAwB,KAAK,CAAC,EAAE,kBAAkB,CAAC,CAAC,EAAE,qBAAqB,CAC5E,CAAC;QACJ,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/build/manifest.d.ts

@@ -0,0 +1,156 @@
+import type { AgentCard, JSONSchema, Targeting } from "./load-config.js";
+/**
+ * Per-engagement manifest input. Each engagement carries its own routing
+ * (`events` map) and its lifecycle method names (extracted from decorator
+ * metadata). The manifest emitter:
+ *
+ * - copies `events` into the per-engagement `handles` map (eventType →
+ *   handlerName, per `prototype.md` §"AgentManifest.Engagements");
+ * - aggregates `events` keys + caller-provided `publishes` into the
+ *   top-level derived unions;
+ * - drops `lifecycle` from the manifest output entirely — `onStart` /
+ *   `onClose` are conventional method names invoked by the runtime if
+ *   defined on the class (per prototype.md §"Notes on the simplifications").
+ */
+export interface ManifestEngagementInput {
+    id: string;
+    goal?: string;
+    events: Record<string, string>;
+    /** Recorded for the simulator — not emitted into the wire manifest. */
+    lifecycle: {
+        start?: string;
+        close?: string;
+    };
+    /** Event types this engagement publishes (lint-derived or author-pinned). */
+    publishes: string[];
+}
+/**
+ * Subset of `AgentConfig` (from `@cef-ai/agent-sdk/config`) that the manifest
+ * emitter consumes at the agent level. Per-engagement state lives on
+ * {@link ManifestEngagementInput}.
+ */
+export interface ManifestConfigInput {
+    alias?: string;
+    source?: string;
+    card?: AgentCard;
+    requiredScopes?: string[];
+    /** Per-Job idle timeout as a duration string (e.g. `"15m"`); the
+     *  manifest emitter parses this into integer ms. Defaults to `"30m"`. */
+    idleTimeout?: string;
+    cubbies?: Array<{
+        alias: string;
+        migrations?: string;
+    }>;
+    settings?: Array<{
+        key: string;
+        type: "string" | "number" | "boolean" | "url" | "secret";
+        required?: boolean;
+        label?: string;
+        description?: string;
+        default?: unknown;
+    }>;
+    models?: Record<string, string>;
+    uses?: Record<string, string>;
+    eventSchemas?: Record<string, JSONSchema>;
+}
+export interface ManifestInput {
+    /** Marketplace alias / build id (becomes `manifest.alias`). */
+    agentId: string;
+    version: string;
+    /** Absolute path to the IIFE bundle whose source is embedded as
+     *  `manifest.bundle` (per prototype.md §"AgentManifest.Bundle"). */
+    bundlePath: string;
+    /** One entry per engagement. At least one required. */
+    engagements: ManifestEngagementInput[];
+    /** Declarative bits taken from cef.config.ts (agent-level). */
+    config: ManifestConfigInput;
+    /**
+     * Directory containing the user's cef.config.ts — used to resolve
+     * relative `cubbies[].migrations` paths.
+     */
+    configDir: string;
+    /**
+     * Validated targeting decision table. Caller (build pipeline) is
+     * responsible for running `validateTargeting` first; the manifest
+     * emitter just writes this verbatim into the JSON.
+     */
+    targeting: Targeting;
+}
+export interface InlinedCubby {
+    alias: string;
+    migrations?: Array<{
+        version: number;
+        up: string;
+    }>;
+}
+/**
+ * Per-engagement slice of the emitted manifest (per prototype.md
+ * §"EngagementDecl"). `handles` is a map (eventType → handlerName); per-
+ * engagement `publishes` and `lifecycleHandlers` are intentionally NOT
+ * emitted — the contract carries publishes at the agent level only and
+ * lifecycle hook resolution is conventional (instance.onStart /
+ * instance.onClose if defined).
+ */
+export interface ManifestEngagement {
+    id: string;
+    goal: string;
+    handles: Record<string, string>;
+}
+/** Settings declaration as emitted into the manifest. */
+export type ManifestSetting = NonNullable<ManifestConfigInput["settings"]>[number];
+/**
+ * Manifest body per `prototype.md` §"AgentManifest". Identity / signature
+ * fields (`agentId`, `agentServicePubkey`, `signature`) are filled in by
+ * `cef publish` after Ed25519 signing — they are emitted as empty strings
+ * by `cef build`.
+ */
+export interface CefManifest {
+    agentId: string;
+    agentServicePubkey: string;
+    version: string;
+    alias: string;
+    card: AgentCard;
+    requiredScopes: string[];
+    /** Per-Job idle timeout in milliseconds (orchestrator sweeper marks the
+     *  Job terminal after this much inactivity). `0` disables idle-based
+     *  termination. */
+    idleTimeout: number;
+    settings: ManifestSetting[];
+    bundle: string;
+    engagements: ManifestEngagement[];
+    /** Derived union of every engagement's `handles` keys (sorted). */
+    handles: string[];
+    /** Derived union of every engagement's lint-derived publishes (sorted). */
+    publishes: string[];
+    eventSchemas: Record<string, JSONSchema>;
+    cubbies: InlinedCubby[];
+    models: Record<string, string>;
+    uses: Record<string, string>;
+    targeting: Targeting;
+    source: string;
+    signature: string;
+}
+/**
+ * Build the manifest object per `prototype.md` §"AgentManifest". The shape
+ * is the single self-contained artifact used by Marketplace, Vault API,
+ * Cubby Manager, Event Runtime, Orchestrator, Agent Runtime, and `cef
+ * typegen` — everything an agent needs at runtime is inline.
+ *
+ * Per-engagement: `handles` is a map (eventType → handlerName), sorted
+ * alphabetically by key. Per-engagement publishes / lifecycleHandlers are
+ * NOT emitted — see `prototype.md` §"Notes on the simplifications" and
+ * the `EngagementDecl` go type.
+ *
+ * Agent-level: `cubbies[]` inlines each cubby's migration directory;
+ * `bundle` embeds the JS source as a JSON-escaped string (no separate
+ * `codeCid`); `handles[]` and `publishes[]` are derived unions over the
+ * engagements; identity / signature fields are placeholders to be set by
+ * `cef publish`.
+ */
+export declare function buildManifest(input: ManifestInput): Promise<CefManifest>;
+/**
+ * Build the manifest and write it as pretty-printed JSON to `out`. Returns
+ * the manifest object so callers don't need to re-read the file.
+ */
+export declare function emitManifest(out: string, input: ManifestInput): Promise<CefManifest>;
+//# sourceMappingURL=manifest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/build/manifest.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,SAAS,EACT,UAAU,EACV,SAAS,EACV,MAAM,kBAAkB,CAAC;AAE1B;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,uEAAuE;IACvE,SAAS,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,6EAA6E;IAC7E,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B;6EACyE;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxD,QAAQ,CAAC,EAAE,KAAK,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,CAAC;QACzD,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC,CAAC;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,aAAa;IAC5B,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB;wEACoE;IACpE,UAAU,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,WAAW,EAAE,uBAAuB,EAAE,CAAC;IACvC,+DAA+D;IAC/D,MAAM,EAAE,mBAAmB,CAAC;IAC5B;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,SAAS,EAAE,SAAS,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrD;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,yDAAyD;AACzD,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnF;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,SAAS,CAAC;IAChB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB;;uBAEmB;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAClC,mEAAmE;IACnE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,2EAA2E;IAC3E,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACzC,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAgCD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CA4E9E;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC,WAAW,CAAC,CAKtB"}

package/dist/build/manifest.js

@@ -0,0 +1,111 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { parseDuration } from "./duration.js";
+const EMPTY_CARD = { name: "", description: "" };
+/** Default idle timeout — author-facing string; see `AgentConfig.idleTimeout`. */
+const DEFAULT_IDLE_TIMEOUT = "30m";
+/**
+ * Read `<dir>/*.sql` in lexical order and return inlined migrations. The
+ * version is parsed from the leading integer of the filename (`001-init.sql`
+ * → 1). Files whose name does not start with digits are rejected with an
+ * Error so authors don't silently get unordered migrations.
+ */
+async function readMigrations(dir) {
+    const entries = await fs.readdir(dir);
+    const sql = entries.filter((f) => f.toLowerCase().endsWith(".sql")).sort();
+    const out = [];
+    for (const file of sql) {
+        const m = /^(\d+)/.exec(file);
+        if (!m) {
+            throw new Error(`[@cef-ai/cli] migration filename must start with digits (got "${file}" in ${dir})`);
+        }
+        const version = Number.parseInt(m[1], 10);
+        const up = await fs.readFile(path.join(dir, file), "utf8");
+        out.push({ version, up });
+    }
+    return out;
+}
+/**
+ * Build the manifest object per `prototype.md` §"AgentManifest". The shape
+ * is the single self-contained artifact used by Marketplace, Vault API,
+ * Cubby Manager, Event Runtime, Orchestrator, Agent Runtime, and `cef
+ * typegen` — everything an agent needs at runtime is inline.
+ *
+ * Per-engagement: `handles` is a map (eventType → handlerName), sorted
+ * alphabetically by key. Per-engagement publishes / lifecycleHandlers are
+ * NOT emitted — see `prototype.md` §"Notes on the simplifications" and
+ * the `EngagementDecl` go type.
+ *
+ * Agent-level: `cubbies[]` inlines each cubby's migration directory;
+ * `bundle` embeds the JS source as a JSON-escaped string (no separate
+ * `codeCid`); `handles[]` and `publishes[]` are derived unions over the
+ * engagements; identity / signature fields are placeholders to be set by
+ * `cef publish`.
+ */
+export async function buildManifest(input) {
+    const { agentId, version, bundlePath, engagements, config, configDir, targeting, } = input;
+    if (engagements.length === 0) {
+        throw new Error(`[@cef-ai/cli] agent "${agentId}": manifest needs at least one engagement`);
+    }
+    const sortedEngagements = [...engagements].sort((a, b) => a.id.localeCompare(b.id));
+    const allHandles = new Set();
+    const allPublishes = new Set();
+    const manifestEngagements = sortedEngagements.map((e) => {
+        const handles = {};
+        for (const type of Object.keys(e.events).sort()) {
+            handles[type] = e.events[type];
+            allHandles.add(type);
+        }
+        for (const t of e.publishes)
+            allPublishes.add(t);
+        return {
+            id: e.id,
+            goal: e.goal ?? "",
+            handles,
+        };
+    });
+    const cubbies = [];
+    for (const c of config.cubbies ?? []) {
+        const inlined = { alias: c.alias };
+        if (c.migrations) {
+            const dir = path.resolve(configDir, c.migrations);
+            inlined.migrations = await readMigrations(dir);
+        }
+        cubbies.push(inlined);
+    }
+    const bundle = await fs.readFile(bundlePath, "utf8");
+    return {
+        // Identity placeholders — `cef publish` sets these after signing
+        // (per prototype.md → POST /api/v1/marketplace/agents).
+        agentId: "",
+        agentServicePubkey: "",
+        version,
+        alias: config.alias ?? agentId,
+        card: config.card ?? EMPTY_CARD,
+        requiredScopes: config.requiredScopes ?? ["default"],
+        idleTimeout: parseDuration(config.idleTimeout ?? DEFAULT_IDLE_TIMEOUT, `agent "${agentId}" idleTimeout`),
+        settings: config.settings ?? [],
+        bundle,
+        engagements: manifestEngagements,
+        handles: [...allHandles].sort(),
+        publishes: [...allPublishes].sort(),
+        eventSchemas: config.eventSchemas ?? {},
+        cubbies,
+        models: config.models ?? {},
+        uses: config.uses ?? {},
+        targeting,
+        source: config.source ?? "",
+        signature: "",
+    };
+}
+/**
+ * Build the manifest and write it as pretty-printed JSON to `out`. Returns
+ * the manifest object so callers don't need to re-read the file.
+ */
+export async function emitManifest(out, input) {
+    const manifest = await buildManifest(input);
+    await fs.mkdir(path.dirname(out), { recursive: true });
+    await fs.writeFile(out, JSON.stringify(manifest, null, 2) + "\n", "utf8");
+    return manifest;
+}
+//# sourceMappingURL=manifest.js.map

package/dist/build/manifest.js.map

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

package/dist/build/targeting.d.ts

@@ -0,0 +1,15 @@
+import type { Targeting } from "./load-config.js";
+export interface ValidateTargetingInput {
+    /** Agent id used in error messages. */
+    agentId: string;
+    /** Declared engagement ids (post-normalize). At least one required. */
+    engagementIds: string[];
+    /** The user's optional targeting block. */
+    targeting?: Targeting;
+}
+export interface ValidateTargetingResult {
+    /** Validated targeting (defaulted when input was absent). */
+    targeting: Targeting;
+}
+export declare function validateTargeting(input: ValidateTargetingInput): ValidateTargetingResult;
+//# sourceMappingURL=targeting.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"targeting.d.ts","sourceRoot":"","sources":["../../src/build/targeting.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAQ,SAAS,EAAuB,MAAM,kBAAkB,CAAC;AAwB7E,MAAM,WAAW,sBAAsB;IACrC,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACtC,6DAA6D;IAC7D,SAAS,EAAE,SAAS,CAAC;CACtB;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,sBAAsB,GAC5B,uBAAuB,CA8BzB"}

package/dist/build/targeting.js

@@ -0,0 +1,69 @@
+/**
+ * Build-time targeting validator (per prototype.md → "Targeting on the
+ * Manifest body"). The user authors a `targeting` block in `cef.config.ts`
+ * matching the platform's selection-table shape; the build step:
+ *
+ * - defaults `targeting` to a single entry over the first declared
+ *   engagement when omitted (single-engagement agents don't need a block);
+ * - rejects ids that do not match a declared engagement;
+ * - rejects rule names outside the v1 vocabulary (`priority` | `weight` |
+ *   `limit`) so authors get a fail-fast message instead of silently
+ *   misrouted traffic.
+ *
+ * Failures throw with `[@cef-ai/cli]`-prefixed messages so authors get a
+ * pointer back to their config file.
+ */
+const SUPPORTED_RULE_NAMES = new Set([
+    "priority",
+    "weight",
+    "limit",
+]);
+export function validateTargeting(input) {
+    const { agentId, engagementIds, targeting } = input;
+    if (engagementIds.length === 0) {
+        throw new Error(`[@cef-ai/cli] agent "${agentId}": cannot validate targeting without any declared engagements`);
+    }
+    if (!targeting) {
+        return {
+            targeting: {
+                engagements: [{ id: engagementIds[0], rules: [] }],
+            },
+        };
+    }
+    if (!Array.isArray(targeting.engagements) || targeting.engagements.length === 0) {
+        throw new Error(`[@cef-ai/cli] agent "${agentId}": targeting.engagements must contain at least one entry`);
+    }
+    const idsSet = new Set(engagementIds);
+    const seen = new Set();
+    for (const e of targeting.engagements) {
+        validateEngagementEntry(agentId, e, idsSet, seen, engagementIds);
+    }
+    return { targeting };
+}
+function validateEngagementEntry(agentId, entry, declared, seen, declaredList) {
+    if (typeof entry.id !== "string" || entry.id.length === 0) {
+        throw new Error(`[@cef-ai/cli] agent "${agentId}": targeting engagement entry has empty 'id'`);
+    }
+    if (!declared.has(entry.id)) {
+        throw new Error(`[@cef-ai/cli] agent "${agentId}": targeting references engagement "${entry.id}" which is not declared (declared: ${declaredList.join(", ")})`);
+    }
+    if (seen.has(entry.id)) {
+        throw new Error(`[@cef-ai/cli] agent "${agentId}": targeting lists engagement "${entry.id}" more than once`);
+    }
+    seen.add(entry.id);
+    for (const rule of entry.rules ?? []) {
+        validateRule(agentId, entry.id, rule);
+    }
+}
+function validateRule(agentId, engagementId, rule) {
+    if (!rule || typeof rule !== "object") {
+        throw new Error(`[@cef-ai/cli] agent "${agentId}": targeting engagement "${engagementId}" has invalid rule ${JSON.stringify(rule)}`);
+    }
+    if (!SUPPORTED_RULE_NAMES.has(rule.name)) {
+        throw new Error(`[@cef-ai/cli] agent "${agentId}": targeting engagement "${engagementId}" has unknown rule name "${rule.name}" (supported: priority, weight, limit)`);
+    }
+    if (typeof rule.value !== "number" || !Number.isFinite(rule.value)) {
+        throw new Error(`[@cef-ai/cli] agent "${agentId}": targeting engagement "${engagementId}" rule "${rule.name}" must have a numeric value`);
+    }
+}
+//# sourceMappingURL=targeting.js.map

package/dist/build/targeting.js.map

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

package/dist/cli-program.d.ts

@@ -0,0 +1,14 @@
+import { Command } from "commander";
+export declare const DEFAULT_MARKETPLACE_URL = "https://agent-marketplace.compute.dev.ddcdragon.com";
+export interface BuildProgramOptions {
+    /** Optional fetch override threaded into `cef publish`. Tests use this. */
+    fetchImpl?: typeof fetch;
+    /**
+     * How to surface unrecoverable command errors. The bin entry uses the
+     * default (log + process.exit(1)); tests pass a function that throws so
+     * vitest's `await program.parseAsync()` rejects observably.
+     */
+    onError?: (err: unknown) => never;
+}
+export declare function buildProgram(opts?: BuildProgramOptions): Command;
+//# sourceMappingURL=cli-program.d.ts.map

package/dist/cli-program.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-program.d.ts","sourceRoot":"","sources":["../src/cli-program.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,eAAO,MAAM,uBAAuB,wDACmB,CAAC;AAExD,MAAM,WAAW,mBAAmB;IAClC,2EAA2E;IAC3E,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,KAAK,CAAC;CACnC;AAQD,wBAAgB,YAAY,CAAC,IAAI,GAAE,mBAAwB,GAAG,OAAO,CA0MpE"}