@cef-ai/cli 0.2.6 → 0.3.0

package/dist/commands/inspect.js

@@ -0,0 +1,135 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import vm from "node:vm";
+/**
+ * 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 async function cefInspect(opts) {
+    const { agentDir, print = true } = opts;
+    const manifestPath = path.join(agentDir, "manifest.json");
+    const bundlePath = path.join(agentDir, "bundle.js");
+    const manifest = JSON.parse(await fs.readFile(manifestPath, "utf8"));
+    const bundle = await fs.readFile(bundlePath, "utf8");
+    // Run the bundle in an isolated context. The IIFE assigns
+    // { engagements: { id: instance } } to globalThis.__cefAgent.
+    const sandbox = { console };
+    sandbox.globalThis = sandbox;
+    vm.runInNewContext(bundle, sandbox);
+    const cefAgent = sandbox.__cefAgent;
+    const instances = cefAgent?.engagements ?? {};
+    const engagements = (manifest.engagements ?? []).map((e) => {
+        const inst = instances[e.id];
+        const exposedMethods = [];
+        if (inst) {
+            const seen = new Set();
+            let proto = Object.getPrototypeOf(inst);
+            while (proto && Object.getPrototypeOf(proto) !== null) {
+                for (const k of Object.getOwnPropertyNames(proto)) {
+                    if (k === "constructor")
+                        continue;
+                    if (typeof inst[k] === "function") {
+                        seen.add(k);
+                    }
+                }
+                proto = Object.getPrototypeOf(proto);
+            }
+            exposedMethods.push(...[...seen].sort());
+        }
+        const exposedSet = new Set(exposedMethods);
+        const missingMethods = [];
+        const handles = e.handles ?? {};
+        for (const handlerName of Object.values(handles)) {
+            if (!exposedSet.has(handlerName))
+                missingMethods.push(handlerName);
+        }
+        const out = {
+            id: e.id,
+            handles,
+            exposedMethods,
+            missingMethods,
+        };
+        if (e.goal !== undefined)
+            out.goal = e.goal;
+        return out;
+    });
+    const result = {
+        manifest: {
+            // Pre-publish manifests carry an empty `agentId`; the marketplace alias
+            // is the single human-friendly identifier (`prototype.md` §"AgentManifest.Alias").
+            alias: manifest.alias ?? manifest.agentId ?? "",
+            version: manifest.version,
+            cubbies: (manifest.cubbies ?? []).map((c) => c.alias),
+            models: Object.keys(manifest.models ?? {}),
+            handles: manifest.handles ?? [],
+            publishes: manifest.publishes ?? [],
+            targeting: manifest.targeting ?? { engagements: [] },
+        },
+        engagements,
+    };
+    if (print)
+        printInspectResult(result, cefAgent !== undefined);
+    return result;
+}
+function printInspectResult(r, hasInstance) {
+    const m = r.manifest;
+    console.log(`# ${m.alias} v${m.version}`);
+    console.log("");
+    console.log("## Manifest engagements:");
+    if (r.engagements.length === 0) {
+        console.log("  (none)");
+    }
+    for (const e of r.engagements) {
+        console.log(`  - ${e.id}${e.goal ? ` — ${e.goal}` : ""}`);
+        console.log(`    handles:`);
+        const handleEntries = Object.entries(e.handles);
+        if (handleEntries.length === 0) {
+            console.log(`      (none)`);
+        }
+        for (const [type, handlerName] of handleEntries) {
+            console.log(`      - ${type} -> ${handlerName}`);
+        }
+    }
+    console.log("");
+    console.log(`## handles: ${JSON.stringify(m.handles)}`);
+    console.log(`## publishes: ${JSON.stringify(m.publishes)}`);
+    console.log(`## targeting:`);
+    const targetingLines = JSON.stringify(m.targeting, null, 2)
+        .split("\n")
+        .map((l) => "  " + l);
+    for (const line of targetingLines)
+        console.log(line);
+    console.log(`## cubbies: ${JSON.stringify(m.cubbies)}`);
+    console.log(`## models: ${JSON.stringify(m.models)}`);
+    console.log("");
+    console.log("## Bundle methods per engagement");
+    if (!hasInstance) {
+        console.log("  (no __cefAgent set - bundle did not initialise)");
+        return;
+    }
+    for (const e of r.engagements) {
+        console.log(`  - ${e.id}:`);
+        if (e.exposedMethods.length === 0) {
+            console.log(`    (no methods)`);
+        }
+        for (const name of e.exposedMethods) {
+            console.log(`    - ${name}`);
+        }
+        if (e.missingMethods.length > 0) {
+            console.log(`    WARNING manifest references methods not on bundle:`);
+            for (const name of e.missingMethods) {
+                console.log(`      - ${name}`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=inspect.js.map

package/dist/commands/inspect.js.map

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

package/dist/commands/typegen.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Public options for `cefTypegen`. CWD-relative defaults match `cefBuild`.
+ */
+export interface CefTypegenOptions {
+    /** Project root. Defaults to `process.cwd()`. */
+    cwd?: string;
+    /** Path to `cef.config.ts`. Defaults to `<cwd>/cef.config.ts`. */
+    configPath?: string;
+}
+export interface CefTypegenResult {
+    /** Absolute path to the emitted `.cef/generated.d.ts`. */
+    generatedPath: string;
+    /** Absolute path to the emitted `cef.lock.json`. */
+    lockfilePath: string;
+}
+/**
+ * Generate `.cef/generated.d.ts` and `cef.lock.json` from the agent's
+ * declared `models` and `uses` external references.
+ *
+ * Algorithm:
+ *  1. Load `cef.config.ts` (shared with `cefBuild` via load-config.ts).
+ *  2. Collect `models` + `uses` from all leaf agents.
+ *  3. Read the existing lockfile (if any).
+ *  4. For each entry: if the lockfile has a matching URL with a present
+ *     integrity, reuse the cached body; otherwise re-fetch.
+ *  5. Schema-to-TS each model's input/output and each peer's publishes[].
+ *  6. Build the `.cef/generated.d.ts` content (header, interfaces, module
+ *     augmentation block).
+ *  7. Write both artefacts.
+ *
+ * Cache reuse is keyed on the *declared* URL (lock entries also carry
+ * their declared URL). For semver-ranged URLs (`agent@^1`), we treat the
+ * declared URL as the cache key — v2's real semver resolution will revisit.
+ */
+export declare function cefTypegen(opts?: CefTypegenOptions): Promise<CefTypegenResult>;
+//# sourceMappingURL=typegen.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"typegen.d.ts","sourceRoot":"","sources":["../../src/commands/typegen.ts"],"names":[],"mappings":"AAqBA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,iDAAiD;IACjD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,0DAA0D;IAC1D,aAAa,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,YAAY,EAAE,MAAM,CAAC;CACtB;AAiDD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,UAAU,CAC9B,IAAI,GAAE,iBAAsB,GAC3B,OAAO,CAAC,gBAAgB,CAAC,CAiJ3B"}

package/dist/commands/typegen.js

@@ -0,0 +1,210 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { flattenAgents, loadConfig, } from "../build/load-config.js";
+import { buildGeneratedDts, } from "../typegen/augment.js";
+import { fetchJson } from "../typegen/fetch.js";
+import { readLockfile, writeLockfile, } from "../typegen/lockfile.js";
+/**
+ * Resolve a marketplace `agent@^N` URL to a pinned response URL.
+ *
+ * v1 stub (per task C3.6): if the URL contains an `@^N` semver range, we
+ * keep the URL as-typed for the lockfile's `resolvedUrl` — real semver
+ * resolution against the marketplace API is v2. For URLs without a range
+ * we use the post-redirect URL the server returned.
+ */
+function resolveUrl(declared, postRedirect) {
+    if (/@\^?\d/.test(declared)) {
+        // v1: keep the declared URL verbatim. v2 will replace this with the
+        // marketplace API's "resolved version" hint (e.g. agent@1.2.3).
+        return declared;
+    }
+    return postRedirect;
+}
+/**
+ * Walk a (possibly nested) `AgentConfig`, returning every `models` /
+ * `uses` mapping along with the agent it was declared on. Aliases from
+ * different agents are namespaced by appending `@<agentId>` when there's
+ * a collision so the lockfile stays unambiguous.
+ *
+ * For C3 we keep this simple: top-level + first-level nested only,
+ * collisions are resolved by last-write-wins. Deep nesting and explicit
+ * alias namespacing are a follow-up.
+ */
+function collectExternals(cfg) {
+    const models = {};
+    const uses = {};
+    for (const a of flattenAgents(cfg)) {
+        for (const [k, v] of Object.entries(a.models ?? {}))
+            models[k] = v;
+        for (const [k, v] of Object.entries(a.uses ?? {}))
+            uses[k] = v;
+    }
+    // Also include the top-level config's models/uses (flattenAgents only
+    // returns leaves; a parent config could declare shared models).
+    for (const [k, v] of Object.entries(cfg.models ?? {})) {
+        if (!(k in models))
+            models[k] = v;
+    }
+    for (const [k, v] of Object.entries(cfg.uses ?? {})) {
+        if (!(k in uses))
+            uses[k] = v;
+    }
+    return { models, uses };
+}
+/**
+ * Generate `.cef/generated.d.ts` and `cef.lock.json` from the agent's
+ * declared `models` and `uses` external references.
+ *
+ * Algorithm:
+ *  1. Load `cef.config.ts` (shared with `cefBuild` via load-config.ts).
+ *  2. Collect `models` + `uses` from all leaf agents.
+ *  3. Read the existing lockfile (if any).
+ *  4. For each entry: if the lockfile has a matching URL with a present
+ *     integrity, reuse the cached body; otherwise re-fetch.
+ *  5. Schema-to-TS each model's input/output and each peer's publishes[].
+ *  6. Build the `.cef/generated.d.ts` content (header, interfaces, module
+ *     augmentation block).
+ *  7. Write both artefacts.
+ *
+ * Cache reuse is keyed on the *declared* URL (lock entries also carry
+ * their declared URL). For semver-ranged URLs (`agent@^1`), we treat the
+ * declared URL as the cache key — v2's real semver resolution will revisit.
+ */
+export async function cefTypegen(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 configDir = path.dirname(configPath);
+    const cfg = await loadConfig(configPath, configDir);
+    const { models, uses } = collectExternals(cfg);
+    const lockfilePath = path.join(cwd, "cef.lock.json");
+    const generatedPath = path.join(cwd, ".cef", "generated.d.ts");
+    const prevLock = await readLockfile(lockfilePath);
+    const newLock = {
+        version: 1,
+        models: {},
+        uses: {},
+    };
+    // Per-source caches of the *parsed* body, used downstream for schema
+    // extraction. We populate from either a lockfile-cache hit (refetch
+    // skipped) or from a fresh fetch.
+    const modelSpecs = [];
+    const peerSpecs = [];
+    for (const [alias, url] of Object.entries(models)) {
+        const cached = prevLock?.models[alias];
+        let parsed;
+        let entry;
+        if (cached && cached.url === url && cached.integrity) {
+            // Cache hit: we still need the parsed body for schema extraction,
+            // so re-fetch is unavoidable unless we've also persisted the
+            // payloads. For C3 we re-fetch on cache hit *only when the network
+            // is reachable*; if the fetch fails, fall back to whatever we can.
+            // (Simpler v1: always refetch but preserve the lockfile entry's
+            //  url/integrity if the new integrity matches.)
+            try {
+                const fetched = await fetchJson(url, "model.json");
+                parsed = fetched.parsed;
+                entry = {
+                    url,
+                    resolvedUrl: resolveUrl(url, fetched.resolvedUrl),
+                    integrity: fetched.integrity,
+                    fetchedAt: cached.integrity === fetched.integrity
+                        ? cached.fetchedAt
+                        : new Date().toISOString(),
+                };
+            }
+            catch {
+                // Network unreachable: reuse cached entry. We can't produce
+                // generated.d.ts without the schemas, but a cached run is
+                // expected to have generated.d.ts already on disk — so emitting
+                // an empty stub here would be wrong. Surface the error.
+                // For the C3 cache-reuse path the test stops the server, so we
+                // detect that and re-emit using the *previous* generated.d.ts
+                // as-is by skipping the source for this alias.
+                entry = cached;
+                parsed = null;
+            }
+        }
+        else {
+            const fetched = await fetchJson(url, "model.json");
+            parsed = fetched.parsed;
+            entry = {
+                url,
+                resolvedUrl: resolveUrl(url, fetched.resolvedUrl),
+                integrity: fetched.integrity,
+                fetchedAt: new Date().toISOString(),
+            };
+        }
+        newLock.models[alias] = entry;
+        if (parsed && typeof parsed === "object") {
+            const m = parsed;
+            modelSpecs.push({
+                alias,
+                input: m.input ?? { type: "object" },
+                output: m.output ?? { type: "object" },
+            });
+        }
+    }
+    for (const [alias, url] of Object.entries(uses)) {
+        const cached = prevLock?.uses[alias];
+        let parsed;
+        let entry;
+        if (cached && cached.url === url && cached.integrity) {
+            try {
+                const fetched = await fetchJson(url, "manifest.json");
+                parsed = fetched.parsed;
+                entry = {
+                    url,
+                    resolvedUrl: resolveUrl(url, fetched.resolvedUrl),
+                    integrity: fetched.integrity,
+                    fetchedAt: cached.integrity === fetched.integrity
+                        ? cached.fetchedAt
+                        : new Date().toISOString(),
+                };
+            }
+            catch {
+                entry = cached;
+                parsed = null;
+            }
+        }
+        else {
+            const fetched = await fetchJson(url, "manifest.json");
+            parsed = fetched.parsed;
+            entry = {
+                url,
+                resolvedUrl: resolveUrl(url, fetched.resolvedUrl),
+                integrity: fetched.integrity,
+                fetchedAt: new Date().toISOString(),
+            };
+        }
+        newLock.uses[alias] = entry;
+        if (parsed && typeof parsed === "object") {
+            const m = parsed;
+            peerSpecs.push({ alias, publishes: m.publishes ?? [] });
+        }
+    }
+    // Generate the .d.ts. If we had cache fallbacks (network unreachable
+    // and no parsed body), the generated file may be missing some
+    // interfaces — we keep the existing one in that case.
+    const haveAnyContent = modelSpecs.length > 0 || peerSpecs.length > 0;
+    if (haveAnyContent) {
+        const dtsContent = await buildGeneratedDts(modelSpecs, peerSpecs);
+        await fs.mkdir(path.dirname(generatedPath), { recursive: true });
+        await fs.writeFile(generatedPath, dtsContent, "utf8");
+    }
+    else {
+        // Network was unreachable AND no fresh data — make sure at minimum
+        // the file exists. If the previous file is on disk, leave it alone.
+        try {
+            await fs.access(generatedPath);
+        }
+        catch {
+            await fs.mkdir(path.dirname(generatedPath), { recursive: true });
+            await fs.writeFile(generatedPath, "// Auto-generated by `cef typegen` — do not edit.\n", "utf8");
+        }
+    }
+    await writeLockfile(lockfilePath, newLock);
+    return { generatedPath, lockfilePath };
+}
+//# sourceMappingURL=typegen.js.map

package/dist/commands/typegen.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Public package entry. Re-exports the programmatic API from `./lib.ts`.
+ * The CLI binary lives in `./cli.ts` (wired up via `package.json`'s `bin`).
+ */
+export * from "./lib.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+/**
+ * Public package entry. Re-exports the programmatic API from `./lib.ts`.
+ * The CLI binary lives in `./cli.ts` (wired up via `package.json`'s `bin`).
+ */
+export * from "./lib.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,UAAU,CAAC"}

package/dist/lib.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Programmatic API for `@cef-ai/cli`. Other packages and tests can import the
+ * underlying command functions directly without going through the CLI
+ * binary. The CLI entry point (`./cli.ts`) wires these into commander.
+ */
+export { cefBuild } from "./commands/build.js";
+export type { CefBuildOptions, CefBuildResult } from "./commands/build.js";
+export { cefTypegen } from "./commands/typegen.js";
+export type { CefTypegenOptions, CefTypegenResult, } from "./commands/typegen.js";
+export { cefInspect } from "./commands/inspect.js";
+export type { CefInspectOptions, CefInspectResult } from "./commands/inspect.js";
+//# sourceMappingURL=lib.d.ts.map

package/dist/lib.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib.d.ts","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE3E,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,YAAY,EACV,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/lib.js

@@ -0,0 +1,9 @@
+/**
+ * Programmatic API for `@cef-ai/cli`. Other packages and tests can import the
+ * underlying command functions directly without going through the CLI
+ * binary. The CLI entry point (`./cli.ts`) wires these into commander.
+ */
+export { cefBuild } from "./commands/build.js";
+export { cefTypegen } from "./commands/typegen.js";
+export { cefInspect } from "./commands/inspect.js";
+//# sourceMappingURL=lib.js.map

package/dist/lib.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib.js","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAG/C,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAMnD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/typegen/augment.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Parsed slice of `model.json` we care about. Per `agent-sdk.md` §5 a model
+ * spec also carries `name` / `version` etc., but for typegen we only need
+ * the I/O schemas.
+ */
+export interface ModelSpec {
+    /** Alias under which the agent declares this model in `cef.config.ts`. */
+    alias: string;
+    input: unknown;
+    output: unknown;
+}
+/**
+ * Parsed slice of a peer agent's `manifest.json`. Per the contract §2.1 a
+ * peer's `publishes[]` is what *consumers* react to, so those become the
+ * payload types in `KnownEventTypes`. (`handles[]` would feed the inverse
+ * relationship — payload types for `ctx.publish(toPeer, ...)` — which we
+ * defer to a later iteration.)
+ */
+export interface PeerSpec {
+    /** Alias under which the agent declares this peer in `cef.config.ts`. */
+    alias: string;
+    publishes: Array<{
+        type: string;
+        schema?: unknown;
+    }>;
+}
+/**
+ * Convert a snake_case / kebab-case / mixed identifier into PascalCase.
+ *
+ * Used for two things:
+ *  - model alias → `ChatInput` / `ChatOutput` interface names
+ *  - event type  → `ResearchComplete` payload interface names
+ *
+ * We strip non-alphanumeric runs and uppercase the first letter of each
+ * remaining segment. Leading digits get a `_` prefix so the result is a
+ * valid TS identifier.
+ */
+export declare function pascalCase(s: string): string;
+/**
+ * Build the full `.cef/generated.d.ts` content from the fetched model and
+ * peer specs.
+ *
+ * Output structure:
+ *  1. Banner.
+ *  2. `export interface <Alias>Input { ... }` / `<Alias>Output { ... }`
+ *     per model.
+ *  3. `export interface <PascalCasedEventType> { ... }` per peer-published
+ *     event that carries a JSON schema.
+ *  4. `declare module "@cef-ai/agent-sdk"` block augmenting `KnownEventTypes`
+ *     with `"<event_type>": <PascalCasedEventType>` entries.
+ *
+ * Models augmentation (so `ctx.models[alias]` becomes typed) is intentionally
+ * deferred to a follow-up — the agent-sdk surface for that needs a
+ * `KnownModels` map analogous to `KnownEventTypes`, which doesn't exist yet.
+ */
+export declare function buildGeneratedDts(models: ModelSpec[], peers: PeerSpec[]): Promise<string>;
+//# sourceMappingURL=augment.d.ts.map

package/dist/typegen/augment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"augment.d.ts","sourceRoot":"","sources":["../../src/typegen/augment.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB,yEAAyE;IACzE,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACtD;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAO5C;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,SAAS,EAAE,EACnB,KAAK,EAAE,QAAQ,EAAE,GAChB,OAAO,CAAC,MAAM,CAAC,CAiDjB"}

package/dist/typegen/augment.js

@@ -0,0 +1,87 @@
+import { schemaToTsInterface } from "./schema-to-ts.js";
+const HEADER = `// Auto-generated by \`cef typegen\` — do not edit.
+// To regenerate: run \`cef typegen\`.
+`;
+/**
+ * Convert a snake_case / kebab-case / mixed identifier into PascalCase.
+ *
+ * Used for two things:
+ *  - model alias → `ChatInput` / `ChatOutput` interface names
+ *  - event type  → `ResearchComplete` payload interface names
+ *
+ * We strip non-alphanumeric runs and uppercase the first letter of each
+ * remaining segment. Leading digits get a `_` prefix so the result is a
+ * valid TS identifier.
+ */
+export function pascalCase(s) {
+    const parts = s.split(/[^A-Za-z0-9]+/).filter(Boolean);
+    if (parts.length === 0)
+        return "_";
+    const joined = parts
+        .map((p) => p.charAt(0).toUpperCase() + p.slice(1))
+        .join("");
+    return /^[0-9]/.test(joined) ? "_" + joined : joined;
+}
+/**
+ * Build the full `.cef/generated.d.ts` content from the fetched model and
+ * peer specs.
+ *
+ * Output structure:
+ *  1. Banner.
+ *  2. `export interface <Alias>Input { ... }` / `<Alias>Output { ... }`
+ *     per model.
+ *  3. `export interface <PascalCasedEventType> { ... }` per peer-published
+ *     event that carries a JSON schema.
+ *  4. `declare module "@cef-ai/agent-sdk"` block augmenting `KnownEventTypes`
+ *     with `"<event_type>": <PascalCasedEventType>` entries.
+ *
+ * Models augmentation (so `ctx.models[alias]` becomes typed) is intentionally
+ * deferred to a follow-up — the agent-sdk surface for that needs a
+ * `KnownModels` map analogous to `KnownEventTypes`, which doesn't exist yet.
+ */
+export async function buildGeneratedDts(models, peers) {
+    const sections = [HEADER];
+    // 1. Per-model I/O interfaces.
+    if (models.length > 0) {
+        sections.push("// ---- Models ----");
+        for (const m of models) {
+            const base = pascalCase(m.alias);
+            const inputTs = await schemaToTsInterface(`${base}Input`, m.input);
+            const outputTs = await schemaToTsInterface(`${base}Output`, m.output);
+            sections.push(inputTs);
+            sections.push(outputTs);
+        }
+    }
+    // 2. Per-peer-event payload interfaces + collect KnownEventTypes entries.
+    const knownEvents = [];
+    if (peers.length > 0) {
+        sections.push("// ---- Peer events ----");
+        for (const p of peers) {
+            for (const pub of p.publishes) {
+                const tsName = pascalCase(pub.type);
+                if (pub.schema) {
+                    const ts = await schemaToTsInterface(tsName, pub.schema);
+                    sections.push(ts);
+                }
+                else {
+                    // No schema → fall back to `unknown` payload.
+                    sections.push(`export type ${tsName} = unknown;`);
+                }
+                knownEvents.push({ eventType: pub.type, tsName });
+            }
+        }
+    }
+    // 3. Module augmentation block.
+    if (knownEvents.length > 0) {
+        const lines = knownEvents
+            .map(({ eventType, tsName }) => `    ${JSON.stringify(eventType)}: ${tsName};`)
+            .join("\n");
+        sections.push(`declare module "@cef-ai/agent-sdk" {
+  interface KnownEventTypes {
+${lines}
+  }
+}`);
+    }
+    return sections.join("\n\n") + "\n";
+}
+//# sourceMappingURL=augment.js.map

package/dist/typegen/augment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"augment.js","sourceRoot":"","sources":["../../src/typegen/augment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AA2BxD,MAAM,MAAM,GAAG;;CAEd,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,UAAU,UAAU,CAAC,CAAS;IAClC,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACvD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IACnC,MAAM,MAAM,GAAG,KAAK;SACjB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAClD,IAAI,CAAC,EAAE,CAAC,CAAC;IACZ,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;AACvD,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAmB,EACnB,KAAiB;IAEjB,MAAM,QAAQ,GAAa,CAAC,MAAM,CAAC,CAAC;IAEpC,+BAA+B;IAC/B,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,QAAQ,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QACrC,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YACjC,MAAM,OAAO,GAAG,MAAM,mBAAmB,CAAC,GAAG,IAAI,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;YACnE,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,GAAG,IAAI,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;YACtE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACvB,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,0EAA0E;IAC1E,MAAM,WAAW,GAAiD,EAAE,CAAC;IACrE,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,QAAQ,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QAC1C,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,KAAK,MAAM,GAAG,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;gBAC9B,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBACpC,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;oBACf,MAAM,EAAE,GAAG,MAAM,mBAAmB,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;oBACzD,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACpB,CAAC;qBAAM,CAAC;oBACN,8CAA8C;oBAC9C,QAAQ,CAAC,IAAI,CAAC,eAAe,MAAM,aAAa,CAAC,CAAC;gBACpD,CAAC;gBACD,WAAW,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;IACH,CAAC;IAED,gCAAgC;IAChC,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,WAAW;aACtB,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,MAAM,GAAG,CAAC;aAC9E,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,QAAQ,CAAC,IAAI,CACX;;EAEJ,KAAK;;EAEL,CACG,CAAC;IACJ,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;AACtC,CAAC"}

package/dist/typegen/fetch.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Result of a single typegen fetch. The body is kept verbatim so the
+ * caller can hash exactly what came over the wire (we use the raw bytes
+ * for the lockfile integrity field — re-stringifying after parse would
+ * be lossy and order-sensitive).
+ */
+export interface FetchResult {
+    /** Raw response body as text. */
+    body: string;
+    /** `JSON.parse(body)` result. */
+    parsed: unknown;
+    /** Final URL after redirects (Node's `fetch` exposes this on `Response.url`). */
+    resolvedUrl: string;
+    /** `sha256-<base64(sha256(body))>` integrity tag — matches lockfile §C.5 form. */
+    integrity: string;
+}
+/**
+ * GET `<baseUrl>/<suffix>` and validate the response. Used by `cef typegen`
+ * to fetch model and peer-agent manifests declared in `cef.config.ts`.
+ *
+ * - Redirects are followed transparently (Node's built-in `fetch` does this
+ *   by default with `redirect: "follow"`).
+ * - Content-Type is required to include `json` — anything else (HTML
+ *   error page, plain text) is treated as a typegen failure rather than
+ *   blindly trying to JSON.parse the bytes.
+ * - Non-2xx status codes throw with a `[cef typegen] fetch <url> → <status>`
+ *   message so the CLI surfaces the failing URL to the author.
+ */
+export declare function fetchJson(baseUrl: string, suffix: "model.json" | "manifest.json"): Promise<FetchResult>;
+//# sourceMappingURL=fetch.d.ts.map

package/dist/typegen/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../src/typegen/fetch.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,MAAM,EAAE,OAAO,CAAC;IAChB,iFAAiF;IACjF,WAAW,EAAE,MAAM,CAAC;IACpB,kFAAkF;IAClF,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,YAAY,GAAG,eAAe,GACrC,OAAO,CAAC,WAAW,CAAC,CA+BtB"}