@cef-ai/agent-sdk 1.0.0 → 1.2.0

package/README.md

@@ -38,8 +38,9 @@ interface UserMessage {
 
 export default class Echo {
   @OnStart
-  async onStart(ctx: Context) {
-    ctx.log.info("started");
+  async onStart() {
+    // Logging + HTTP are plain Web globals, not ctx members:
+    console.info("started");
   }
 
   @OnEvent("user_message")
@@ -54,12 +55,16 @@ export default class Echo {
   }
 
   @OnClose
-  async onClose(ctx: Context, reason: OnCloseReason) {
-    ctx.log.info("closing", { reason });
+  async onClose(_ctx: Context, reason: OnCloseReason) {
+    console.info("closing", { reason });
   }
 }
 ```
 
+`ctx` carries only the CEF-specific platform calls. For plain capabilities,
+use the sandbox globals directly: **`console.*`** for logging (the runtime
+captures it) and **`fetch`** for HTTP.
+
 Pair the class with a `cef.config.ts`:
 
 ```ts
@@ -80,23 +85,51 @@ export default defineAgent({
 | Decorator | `@OnEvent(type)` | Bind an event type (string literal) to a handler. |
 | Decorator | `@OnStart` | Mark the start lifecycle hook. |
 | Decorator | `@OnClose` | Mark the close lifecycle hook. |
-| Type | `Context` | Per-instance ctx — `cubby`, `models`, `fetch`, `publish`, `settings`, `close`, `log`. |
+| Type | `Context` | CEF-specific platform calls only — `cubby`, `models`, `publish`, `settings`, `close`. (Log/HTTP are the globals `console` / `fetch`.) |
 | Type | `Event<P>` | `{ id, type, ts, from, payload: P }`. |
 | Type | `CubbyHandle` | `query(sql, params)` / `exec(sql, params)` over per-alias storage. |
 | Type | `ModelHandle<I,O>` | `infer(input)` / `stream(input)` per declared model alias. |
-| Type | `Logger` | Leveled structured log: `info` / `warn` / `error` / `debug`. |
 | Type | `OnCloseReason` | `"revoked" \| "idle_timeout" \| "closed_by_agent" \| "failed"`. |
-| Type | `FetchInit` | Subset of `RequestInit` accepted by `ctx.fetch`. |
 | Interface | `KnownEventTypes` | Declaration-merged event-type map populated by typegen. |
 | Function | `defineAgent(config)` | Identity helper that preserves literal types of `AgentConfig`. |
 | Type | `AgentConfig` | Top-level config: `id`, `version`, `entry`, `cubbies`, `models`, `settings`, `fetch`, `publishes`, `lifecycle`. |
 
+## How it runs (runtime model)
+
+Per Agent Runtime ADR-001, the Cere Network runtime is a **CEF-agnostic
+bundle executor**: it exposes only Web-platform globals (`fetch`, `console`,
+`URL`, `crypto`, `TextEncoder`, timers, …) plus one opaque
+`globalThis.context` object, and dispatches invocations as
+`globalThis.__handlers[name](event, context)`.
+
+`ctx` is **CEF-specific add-ons only** — SDK code compiled into your bundle by
+`cef build`, not a runtime-provided binding:
+
+- `ctx.publish` / `ctx.cubby` / `ctx.models[…].infer` / `ctx.close` → `fetch`
+  calls to the endpoints the orchestrator places in `globalThis.context`
+  (`context.endpoints.*`, with `context.auth` headers).
+- `ctx.settings` → `context.settings`.
+
+Plain Web-platform capabilities are **not** mirrored on `ctx` — use the
+sandbox globals directly: `console.*` for logging (captured out-of-band by
+the runtime) and `fetch` for HTTP.
+
+You never write the shim code — you author the decorated class, and the
+shims (the `@cef-ai/agent-sdk/runtime` subpath) are bundled in automatically.
+
+**Inference usage is reported automatically.** Each `ctx.models[…].infer`
+call captures the gateway's usage and the SDK folds a `_modelCalls` array
+into your handler's return value; the orchestrator reads it to record
+per-model token/GPU usage (ADR-004). `_modelCalls` is a reserved result key —
+don't set it yourself.
+
 ## Subpath exports
 
 | Specifier | Purpose |
 | --- | --- |
-| `@cef-ai/agent-sdk` | Decorators, `Context`, `Event`, `KnownEventTypes`, `Logger`, `ModelHandle`, `CubbyHandle`, `FetchInit`, `OnCloseReason`. |
+| `@cef-ai/agent-sdk` | Decorators, `Context`, `Event`, `KnownEventTypes`, `ModelHandle`, `CubbyHandle`, `OnCloseReason`. |
 | `@cef-ai/agent-sdk/config` | `defineAgent` and the `AgentConfig` shape — used in `cef.config.ts`. |
+| `@cef-ai/agent-sdk/runtime` | Build-internal: the `ctx` shims + `registerHandlers` that `cef build` compiles into the bundle. Authors never import this directly. |
 
 For testing, use `@cef-ai/testing` directly — `import { testAgent } from "@cef-ai/testing"`.
 

package/dist/index.d.ts

@@ -2,6 +2,6 @@ export { OnEvent, OnStart, OnClose } from "./decorators.js";
 export { Engagement } from "./engagement.js";
 export type { EngagementOptions } from "./engagement.js";
 export { ENGAGEMENT_METADATA, type EngagementMeta } from "./symbols.js";
-export type { Context, CubbyHandle, Event, FetchInit, KnownEventTypes, Logger, ModelHandle, OnCloseReason, } from "./types.js";
+export type { Context, CubbyHandle, Event, KnownEventTypes, KnownModels, ModelHandle, OnCloseReason, } from "./types.js";
 export type { AgentCard, CubbyDecl, JSONSchema, Rule, SettingDecl, Targeting, TargetingEngagement, } from "./config/define-agent.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AACxE,YAAY,EACV,OAAO,EACP,WAAW,EACX,KAAK,EACL,SAAS,EACT,eAAe,EACf,MAAM,EACN,WAAW,EACX,aAAa,GACd,MAAM,YAAY,CAAC;AAIpB,YAAY,EACV,SAAS,EACT,SAAS,EACT,UAAU,EACV,IAAI,EACJ,WAAW,EACX,SAAS,EACT,mBAAmB,GACpB,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AACxE,YAAY,EACV,OAAO,EACP,WAAW,EACX,KAAK,EACL,eAAe,EACf,WAAW,EACX,WAAW,EACX,aAAa,GACd,MAAM,YAAY,CAAC;AAIpB,YAAY,EACV,SAAS,EACT,SAAS,EACT,UAAU,EACV,IAAI,EACJ,WAAW,EACX,SAAS,EACT,mBAAmB,GACpB,MAAM,0BAA0B,CAAC"}

package/dist/runtime/ctx.d.ts

@@ -0,0 +1,29 @@
+/**
+ * `buildContext` — assembles the developer-facing `ctx` object from the
+ * opaque `globalThis.context` the Agent Runtime injects.
+ *
+ * Architecture (AR ADR-001): AR exposes only Web-platform globals
+ * (`fetch`, `console`, `URL`, `crypto`, …) plus one opaque `context`
+ * object. `ctx` carries ONLY the CEF-specific platform add-ons
+ * (`ctx.cubby` / `.publish` / `.models` / `.close` / `.settings`) — each a
+ * JS shim compiled into the bundle by `cef build` that reads endpoints +
+ * auth from `context` and calls back over `fetch`. Plain Web capabilities
+ * are NOT mirrored on `ctx`: agents log with `console.*` (the runtime
+ * captures it) and make HTTP calls with the sandbox `fetch` directly.
+ *
+ * Endpoint URLs and auth come from {@link InvokeContext} (written by the
+ * orchestrator's `buildInvokeContext`). A blank/absent endpoint disables
+ * its feature: the corresponding shim throws a clear error rather than
+ * calling an empty URL.
+ */
+import type { Context } from "../types.js";
+import type { InvokeContext, ModelRef } from "./types.js";
+import { UsageAccumulator } from "./usage.js";
+/**
+ * Build the `ctx` object for one invocation. `raw` is whatever AR exposed
+ * as `globalThis.context`; `usage` collects inference calls for the
+ * `_modelCalls` fold (see {@link mergeModelCalls}); `modelRefs` is the
+ * `alias → ModelRef` map `cef build` baked into the bundle.
+ */
+export declare function buildContext(raw: InvokeContext, usage: UsageAccumulator, modelRefs?: Record<string, ModelRef>): Context;
+//# sourceMappingURL=ctx.d.ts.map

package/dist/runtime/ctx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ctx.d.ts","sourceRoot":"","sources":["../../src/runtime/ctx.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EAAE,OAAO,EAA4B,MAAM,aAAa,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAkB,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAwI9D;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,aAAa,EAClB,KAAK,EAAE,gBAAgB,EACvB,SAAS,GAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAM,GACvC,OAAO,CAkDT"}

package/dist/runtime/ctx.js

@@ -0,0 +1,142 @@
+const JSON_HEADERS = { "content-type": "application/json" };
+function authHeaders(ctx) {
+    const h = ctx.auth?.headers ?? {};
+    const token = ctx.auth?.token;
+    return token ? { ...h, authorization: `Bearer ${token}` } : { ...h };
+}
+/** Map a columnar cubby query response into an array of row objects. */
+function zipRows(columns, rows) {
+    if (!columns || !rows)
+        return [];
+    return rows.map((row) => {
+        const obj = {};
+        columns.forEach((col, i) => {
+            obj[col] = row[i];
+        });
+        return obj;
+    });
+}
+async function postJSON(url, body, headers, label) {
+    const res = await fetch(url, {
+        method: "POST",
+        headers: { ...JSON_HEADERS, ...headers },
+        body: JSON.stringify(body),
+    });
+    if (!res.ok) {
+        const text = await res.text().catch(() => "");
+        throw new Error(`[@cef-ai/agent-sdk] ${label} failed: HTTP ${res.status} ${text}`.trim());
+    }
+    const ct = res.headers.get("content-type") ?? "";
+    return ct.includes("application/json") ? res.json() : res.text();
+}
+function buildCubby(ctx, headers, alias) {
+    const base = ctx.endpoints?.orchestrator;
+    const { vaultId, scope, agentId } = ctx.correlation ?? {};
+    // Endpoint absence is reported at call time (async rejection) rather than
+    // when the handle is created, matching the other shims.
+    if (!base) {
+        const fail = async () => {
+            throw new Error(`[@cef-ai/agent-sdk] ctx.cubby("${alias}"): no orchestrator endpoint in context`);
+        };
+        return { query: fail, exec: fail };
+    }
+    const root = `${base}/api/v1/vaults/${vaultId ?? ""}/scopes/${scope ?? ""}` +
+        `/agents/${agentId ?? ""}/cubbies/${encodeURIComponent(alias)}`;
+    return {
+        async query(sql, params = []) {
+            const data = (await postJSON(`${root}/query`, { sql, params }, headers, `ctx.cubby("${alias}").query`));
+            return zipRows(data.columns, data.rows);
+        },
+        async exec(sql, params = []) {
+            const data = (await postJSON(`${root}/exec`, { sql, params }, headers, `ctx.cubby("${alias}").exec`));
+            return {
+                changes: data.rowsAffected ?? 0,
+                lastInsertRowid: data.lastInsertId ?? 0,
+            };
+        },
+    };
+}
+function buildModelHandle(ctx, headers, usage, alias, ref) {
+    // The IG native endpoint is orchestrator-supplied; the model identity is
+    // baked into the bundle by `cef build` (the alias → ModelRef map).
+    const url = ctx.endpoints?.inference;
+    async function infer(input) {
+        if (!url) {
+            throw new Error(`[@cef-ai/agent-sdk] ctx.models.${alias}: no inference endpoint in context`);
+        }
+        if (!ref) {
+            throw new Error(`[@cef-ai/agent-sdk] ctx.models.${alias}: model not declared in cef.config.ts`);
+        }
+        const started = Date.now();
+        const data = (await postJSON(url, { model: ref, input }, headers, `ctx.models.${alias}.infer`));
+        const call = {
+            model: alias,
+            bucket: ref.bucket,
+            version: ref.version,
+            durationMs: Date.now() - started,
+        };
+        if (data.usage) {
+            call.inputTokens = data.usage.inputTokens;
+            call.outputTokens = data.usage.outputTokens;
+            call.gpuUnits = data.usage.gpuUnits;
+        }
+        usage.record(call);
+        return data.output ?? data;
+    }
+    return {
+        infer,
+        // Streaming responses are deferred in AR v1 (no ReadableStream in the
+        // sandbox; ADR-001 §Out of scope). Degrade to a single-shot yield so
+        // `for await` consumers keep working; usage is still recorded.
+        stream(input) {
+            return {
+                async *[Symbol.asyncIterator]() {
+                    yield await infer(input);
+                },
+            };
+        },
+    };
+}
+/**
+ * Build the `ctx` object for one invocation. `raw` is whatever AR exposed
+ * as `globalThis.context`; `usage` collects inference calls for the
+ * `_modelCalls` fold (see {@link mergeModelCalls}); `modelRefs` is the
+ * `alias → ModelRef` map `cef build` baked into the bundle.
+ */
+export function buildContext(raw, usage, modelRefs = {}) {
+    const headers = authHeaders(raw);
+    // Pre-build declared model handles from the baked refs; a Proxy lets agents
+    // reference any alias (the handle throws a clear error at call time if the
+    // alias wasn't declared in cef.config.ts).
+    const models = new Proxy(Object.fromEntries(Object.entries(modelRefs).map(([a, ref]) => [
+        a,
+        buildModelHandle(raw, headers, usage, a, ref),
+    ])), {
+        get(target, prop) {
+            if (typeof prop !== "string" || prop in target)
+                return target[prop];
+            return buildModelHandle(raw, headers, usage, prop, modelRefs[prop]);
+        },
+    });
+    return {
+        cubby: (alias) => buildCubby(raw, headers, alias),
+        models,
+        async publish(type, payload) {
+            const url = raw.endpoints?.vault?.publish;
+            if (!url) {
+                throw new Error("[@cef-ai/agent-sdk] ctx.publish: no vault publish endpoint in context");
+            }
+            await postJSON(url, { events: [{ type, payload, role: "agent" }] }, headers, "ctx.publish");
+        },
+        settings: Object.freeze({ ...(raw.settings ?? {}) }),
+        async close(reason) {
+            const base = raw.endpoints?.orchestrator;
+            const jobId = raw.correlation?.jobId;
+            if (!base || !jobId) {
+                throw new Error("[@cef-ai/agent-sdk] ctx.close: no orchestrator endpoint or jobId in context");
+            }
+            await postJSON(`${base}/api/v1/jobs/${encodeURIComponent(jobId)}/close`, { reason: reason ?? "closed_by_agent" }, headers, "ctx.close");
+        },
+    };
+}
+//# sourceMappingURL=ctx.js.map

package/dist/runtime/ctx.js.map

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

package/dist/runtime/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `@cef-ai/agent-sdk/runtime` — the in-bundle runtime shim layer.
+ *
+ * This subpath is compiled INTO the agent bundle by `cef build` (unlike the
+ * package root, which is author-time types + decorators). It implements the
+ * `ctx` surface on top of the Agent Runtime's Web-platform sandbox + opaque
+ * `globalThis.context`, and exposes `registerHandlers`, which the build's
+ * generated wrapper calls to install `globalThis.__handlers`.
+ *
+ * Agent authors never import this directly — `cef build` wires it in.
+ */
+export { handlerKey, LIFECYCLE_CLOSE_KEY, LIFECYCLE_START_KEY, registerHandlers, SYNTHETIC_CLOSE_EVENT, SYNTHETIC_START_EVENT, } from "./register.js";
+export type { BuildEngagementMeta, RegisterOptions } from "./register.js";
+export { buildContext } from "./ctx.js";
+export type { InvokeContext, ModelRef } from "./types.js";
+export { type ModelCall, RESULT_MODEL_CALLS_KEY, UsageAccumulator } from "./usage.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EACL,UAAU,EACV,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,KAAK,SAAS,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/runtime/index.js

@@ -0,0 +1,15 @@
+/**
+ * `@cef-ai/agent-sdk/runtime` — the in-bundle runtime shim layer.
+ *
+ * This subpath is compiled INTO the agent bundle by `cef build` (unlike the
+ * package root, which is author-time types + decorators). It implements the
+ * `ctx` surface on top of the Agent Runtime's Web-platform sandbox + opaque
+ * `globalThis.context`, and exposes `registerHandlers`, which the build's
+ * generated wrapper calls to install `globalThis.__handlers`.
+ *
+ * Agent authors never import this directly — `cef build` wires it in.
+ */
+export { handlerKey, LIFECYCLE_CLOSE_KEY, LIFECYCLE_START_KEY, registerHandlers, SYNTHETIC_CLOSE_EVENT, SYNTHETIC_START_EVENT, } from "./register.js";
+export { buildContext } from "./ctx.js";
+export { RESULT_MODEL_CALLS_KEY, UsageAccumulator } from "./usage.js";
+//# sourceMappingURL=index.js.map

package/dist/runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EACL,UAAU,EACV,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,OAAO,EAAkB,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/runtime/register.d.ts

@@ -0,0 +1,55 @@
+import type { ModelRef } from "./types.js";
+/** Lifecycle handler keys — must match orchestrator marketplace constants. */
+export declare const LIFECYCLE_START_KEY = "onStart";
+export declare const LIFECYCLE_CLOSE_KEY = "onClose";
+/**
+ * Synthetic event-type sentinels the orchestrator injects when an engagement
+ * starts / closes — must match ddc-node marketplace `EventTypeSyntheticStart`
+ * / `EventTypeSyntheticClose`. `cef build` keys lifecycle dispatch in the
+ * manifest's `handlers` map under these (mapping them to the fixed
+ * `LIFECYCLE_*_KEY` handler names), so the orchestrator resolves lifecycle via
+ * the same `handlers[eventType]` lookup as ordinary events.
+ */
+export declare const SYNTHETIC_START_EVENT = "__start__";
+export declare const SYNTHETIC_CLOSE_EVENT = "__close__";
+/**
+ * Key under which an engagement's event handler is exposed on `__handlers`
+ * (and stored as a value in the manifest's `handlers` map). Event-handler
+ * keys are namespaced by engagement id so two engagements can each declare a
+ * method of the same name without colliding in the flat map — the
+ * orchestrator returns this string verbatim from `HandlerFor`, so AR looks up
+ * exactly this key. Lifecycle handlers are NOT namespaced: the orchestrator
+ * resolves them to the fixed `onStart` / `onClose` keys, so those remain
+ * agent-global.
+ *
+ * Used by BOTH the runtime (to build `__handlers`) and `cef build` (to emit
+ * the `handlers` map); the two MUST agree, hence the single helper.
+ */
+export declare function handlerKey(engagementId: string, method: string): string;
+type EngagementClass = new () => Record<string, unknown>;
+/**
+ * Build-time metadata the CLI reads (non-enumerable, off `__handlers`) to
+ * emit the manifest. Mirrors the per-engagement decorator metadata.
+ */
+export interface BuildEngagementMeta {
+    id: string;
+    goal?: string;
+    events: Record<string, string>;
+    lifecycle: {
+        start?: string;
+        close?: string;
+    };
+}
+/** Options `cef build` passes alongside the engagement classes. */
+export interface RegisterOptions {
+    /** `alias → ModelRef`, resolved from `defineAgent({ models })` at build. */
+    models?: Record<string, ModelRef>;
+}
+/**
+ * Install `globalThis.__handlers` from the engagement classes. Called once
+ * per isolate when the bundle's top-level code runs. `options.models` (the
+ * baked `alias → ModelRef` map) is captured for the `ctx.models` shims.
+ */
+export declare function registerHandlers(engagements: Record<string, EngagementClass>, options?: RegisterOptions): void;
+export {};
+//# sourceMappingURL=register.d.ts.map

package/dist/runtime/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../src/runtime/register.ts"],"names":[],"mappings":"AA+BA,OAAO,KAAK,EAAiB,QAAQ,EAAE,MAAM,YAAY,CAAC;AAW1D,8EAA8E;AAC9E,eAAO,MAAM,mBAAmB,YAAY,CAAC;AAC7C,eAAO,MAAM,mBAAmB,YAAY,CAAC;AAE7C;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,cAAc,CAAC;AACjD,eAAO,MAAM,qBAAqB,cAAc,CAAC;AAEjD;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED,KAAK,eAAe,GAAG,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAGzD;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,SAAS,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/C;AA0CD,mEAAmE;AACnE,MAAM,WAAW,eAAe;IAC9B,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;CACnC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,EAC5C,OAAO,GAAE,eAAoB,GAC5B,IAAI,CAyCN"}

package/dist/runtime/register.js

@@ -0,0 +1,139 @@
+/**
+ * `registerHandlers` — the bundle's entry point. `cef build` emits a wrapper
+ * that imports each engagement class and calls this with `{ id: Class }`;
+ * running the bundle installs `globalThis.__handlers`, the flat map the
+ * Agent Runtime dispatches against (AR ADR-001: `__handlers[name](event,
+ * context)`).
+ *
+ * Handler-key scheme (must match what the manifest's `handlers` map +
+ * orchestrator `HandlerFor` expect):
+ *  - Event handlers are keyed `<engagementId>::<method>` (the value the
+ *    manifest's `engagements[].handlers{eventType → key}` carries; the
+ *    orchestrator returns it verbatim from `HandlerFor`).
+ *  - Lifecycle handlers are keyed by the fixed constants `onStart` /
+ *    `onClose`; the manifest's `handlers` map points the synthetic
+ *    `__start__` / `__close__` event types at these keys, so lifecycle
+ *    dispatch flows through the same `handlers[eventType]` lookup as
+ *    ordinary events (no separate `hooks` array).
+ *
+ * Because the key space is flat across all engagements, two engagements
+ * declaring the same handler key collide; we throw at registration with a
+ * message naming both owners. `cef build` runs this in a vm, so the
+ * collision surfaces as a build error (not a runtime fault).
+ *
+ * Instances are constructed PER INVOCATION inside each wrapper — never
+ * cached — so no instance state survives across invocations (AR isolates
+ * are reused across Jobs/Vaults with no affinity; a cached instance would
+ * leak state across tenants). Durable state belongs in cubbies.
+ */
+import { ENGAGEMENT_METADATA } from "../symbols.js";
+import { buildContext } from "./ctx.js";
+import { mergeModelCalls, UsageAccumulator } from "./usage.js";
+/**
+ * `alias → ModelRef` map baked into the bundle by `cef build` and passed to
+ * {@link registerHandlers}. Captured here so the per-invocation `ctx.models`
+ * shims know which model each alias points at, without the orchestrator
+ * carrying model identity.
+ */
+let bakedModels = {};
+/** Lifecycle handler keys — must match orchestrator marketplace constants. */
+export const LIFECYCLE_START_KEY = "onStart";
+export const LIFECYCLE_CLOSE_KEY = "onClose";
+/**
+ * Synthetic event-type sentinels the orchestrator injects when an engagement
+ * starts / closes — must match ddc-node marketplace `EventTypeSyntheticStart`
+ * / `EventTypeSyntheticClose`. `cef build` keys lifecycle dispatch in the
+ * manifest's `handlers` map under these (mapping them to the fixed
+ * `LIFECYCLE_*_KEY` handler names), so the orchestrator resolves lifecycle via
+ * the same `handlers[eventType]` lookup as ordinary events.
+ */
+export const SYNTHETIC_START_EVENT = "__start__";
+export const SYNTHETIC_CLOSE_EVENT = "__close__";
+/**
+ * Key under which an engagement's event handler is exposed on `__handlers`
+ * (and stored as a value in the manifest's `handlers` map). Event-handler
+ * keys are namespaced by engagement id so two engagements can each declare a
+ * method of the same name without colliding in the flat map — the
+ * orchestrator returns this string verbatim from `HandlerFor`, so AR looks up
+ * exactly this key. Lifecycle handlers are NOT namespaced: the orchestrator
+ * resolves them to the fixed `onStart` / `onClose` keys, so those remain
+ * agent-global.
+ *
+ * Used by BOTH the runtime (to build `__handlers`) and `cef build` (to emit
+ * the `handlers` map); the two MUST agree, hence the single helper.
+ */
+export function handlerKey(engagementId, method) {
+    return `${engagementId}::${method}`;
+}
+/**
+ * Wrap a user method as an AR handler: fresh instance + ctx per call,
+ * `args` chosen by the caller, result folded with accumulated usage.
+ */
+function makeHandler(Cls, method, args) {
+    return async (event, rawContext) => {
+        const usage = new UsageAccumulator();
+        const ctx = buildContext(rawContext ?? {}, usage, bakedModels);
+        const instance = new Cls();
+        const fn = instance[method];
+        if (typeof fn !== "function") {
+            throw new Error(`[@cef-ai/agent-sdk] handler "${method}" is not a function`);
+        }
+        const result = await fn.apply(instance, args(event, ctx));
+        return mergeModelCalls(result, usage);
+    };
+}
+/** Event handler: invoked as `method(event, ctx)`. */
+function eventHandler(Cls, method) {
+    return makeHandler(Cls, method, (event, ctx) => [event, ctx]);
+}
+/** Start lifecycle hook: invoked as `method(ctx)`. */
+function startHandler(Cls, method) {
+    return makeHandler(Cls, method, (_event, ctx) => [ctx]);
+}
+/** Close lifecycle hook: invoked as `method(ctx, reason)`. */
+function closeHandler(Cls, method) {
+    return makeHandler(Cls, method, (event, ctx) => [
+        ctx,
+        event?.payload?.reason ?? "closed_by_agent",
+    ]);
+}
+/**
+ * Install `globalThis.__handlers` from the engagement classes. Called once
+ * per isolate when the bundle's top-level code runs. `options.models` (the
+ * baked `alias → ModelRef` map) is captured for the `ctx.models` shims.
+ */
+export function registerHandlers(engagements, options = {}) {
+    bakedModels = options.models ?? {};
+    const handlers = {};
+    const owners = {};
+    const meta = [];
+    const claim = (key, owner, fn) => {
+        if (owners[key]) {
+            throw new Error(`[@cef-ai/agent-sdk] handler key "${key}" is claimed by both ${owners[key]} and ${owner}; ` +
+                `handler method names (and lifecycle hooks) must be unique across engagements`);
+        }
+        owners[key] = owner;
+        handlers[key] = fn;
+    };
+    for (const [id, Cls] of Object.entries(engagements)) {
+        const m = Cls[ENGAGEMENT_METADATA];
+        if (!m) {
+            throw new Error(`[@cef-ai/agent-sdk] engagement "${id}": class has no @OnEvent/@OnStart/@OnClose/@Engagement decorators`);
+        }
+        const events = m.events ?? {};
+        const lifecycle = m.lifecycle ?? {};
+        meta.push({ id, goal: m.goal, events, lifecycle });
+        for (const method of new Set(Object.values(events))) {
+            claim(handlerKey(id, method), `${id}.${method}`, eventHandler(Cls, method));
+        }
+        if (lifecycle.start) {
+            claim(LIFECYCLE_START_KEY, `${id}.${lifecycle.start}`, startHandler(Cls, lifecycle.start));
+        }
+        if (lifecycle.close) {
+            claim(LIFECYCLE_CLOSE_KEY, `${id}.${lifecycle.close}`, closeHandler(Cls, lifecycle.close));
+        }
+    }
+    Object.defineProperty(handlers, "__engagements", { value: meta, enumerable: false });
+    globalThis.__handlers = handlers;
+}
+//# sourceMappingURL=register.js.map

package/dist/runtime/register.js.map

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

package/dist/runtime/types.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Shape of `globalThis.context` — the single opaque object the Agent
+ * Runtime injects into the V8 isolate per invocation (AR ADR-001 §V8
+ * sandbox surface). AR treats it as pass-through JSON; this is the
+ * *convention* the orchestrator writes and the SDK shims read.
+ *
+ * Source of truth (orchestrator side):
+ * `ddc-node/internal/compute/orchestrator/job/invoke.go` →
+ * `buildInvokeContext`. Keep this in sync with that function.
+ *
+ * Every field is optional because AR performs no validation and tests /
+ * non-CEF callers may send partial contexts; the shims throw a clear
+ * error at call time when a required endpoint is missing rather than
+ * assuming structure here.
+ */
+export interface InvokeContext {
+    /** Externally-reachable service URLs the shims call via `fetch`. */
+    endpoints?: {
+        /** Orchestrator root — used for cubby ops and `ctx.close`. */
+        orchestrator?: string;
+        /** Vault API — `publish` is the fully-formed events URL for this vault+scope. */
+        vault?: {
+            publish?: string;
+        };
+        /**
+         * Inference Gateway native endpoint (e.g. `<ig-base>/api/v1/inference`),
+         * configured by the orchestrator. The model identity per alias is baked
+         * into the bundle by `cef build` (see {@link ModelRef}), not carried
+         * here — the orchestrator stays model-agnostic.
+         */
+        inference?: string;
+    };
+    /**
+     * Trusted-identity auth the shims attach to every callback `fetch`.
+     * `headers` carries `X-Vault-Id` / `X-Agent-Id` / `X-AS-PubKey`
+     * (network-trust boundary). `token` is reserved for the ADR-020
+     * per-invocation capability token; blank until that lands.
+     */
+    auth?: {
+        headers?: Record<string, string>;
+        token?: string;
+    };
+    /** Decrypted ConnectionSettings, surfaced as `ctx.settings`. */
+    settings?: Record<string, unknown>;
+    /** Correlation identifiers for the running Job/Task. */
+    correlation?: {
+        jobId?: string;
+        taskId?: string;
+        vaultId?: string;
+        scope?: string;
+        agentId?: string;
+    };
+}
+/**
+ * A DDC model identity, as the Inference Gateway's native `/api/v1/inference`
+ * expects it (`{ model: { bucket, name, version }, input }`). `cef build`
+ * resolves each `defineAgent({ models })` entry into one of these and bakes
+ * the `alias → ModelRef` map into the bundle, so `ctx.models.<alias>` knows
+ * which model to call without the orchestrator carrying it.
+ */
+export interface ModelRef {
+    bucket: number;
+    name: string;
+    version: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/runtime/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/runtime/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,aAAa;IAC5B,oEAAoE;IACpE,SAAS,CAAC,EAAE;QACV,8DAA8D;QAC9D,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,iFAAiF;QACjF,KAAK,CAAC,EAAE;YAAE,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAC7B;;;;;WAKG;QACH,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF;;;;;OAKG;IACH,IAAI,CAAC,EAAE;QACL,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,wDAAwD;IACxD,WAAW,CAAC,EAAE;QACZ,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/runtime/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/runtime/types.js.map

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

package/dist/runtime/usage.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Inference-usage accumulation, propagated back to the orchestrator via a
+ * reserved key on the handler's return value.
+ *
+ * AR's `/v1/invoke` response carries only V8-profiler metrics (CPU / memory
+ * / wall-clock) — it does NOT meter inference. Per ADR-002 §Resource
+ * accounting / ADR-004, the SDK accumulates per-call inference usage from
+ * `ctx.models.*` calls and folds it into the handler result under
+ * `_modelCalls`; AR passes the result through opaquely; the orchestrator
+ * parses it at task-terminal and records it on the Task/Job.
+ *
+ * Source of truth (orchestrator side):
+ * `ddc-node/internal/compute/orchestrator/job/recorder.go`
+ * (`resultModelCallsKey = "_modelCalls"`). Keep `ModelCall` in sync with the
+ * struct it unmarshals into there.
+ */
+/** The reserved result key the orchestrator reads inference usage from. */
+export declare const RESULT_MODEL_CALLS_KEY = "_modelCalls";
+/** One per-model inference-usage record (the `_modelCalls[]` entry shape). */
+export interface ModelCall {
+    /** Model identifier the usage is attributed to (the manifest alias). */
+    model: string;
+    /** DDC bucket id, when known. */
+    bucket?: number;
+    /** Model version, when known. */
+    version?: string;
+    /** Per-call duration in milliseconds, when measured. */
+    durationMs?: number;
+    /** Normalised GPU units consumed, when reported by the gateway. */
+    gpuUnits?: number;
+    /** Input/prompt token count. */
+    inputTokens?: number;
+    /** Output/completion token count. */
+    outputTokens?: number;
+}
+/**
+ * Per-invocation collector. One instance is created per handler call and
+ * threaded into the `ctx.models.*` shims; whatever they record is folded
+ * into the result by {@link mergeModelCalls}.
+ */
+export declare class UsageAccumulator {
+    readonly calls: ModelCall[];
+    record(call: ModelCall): void;
+}
+/**
+ * Fold accumulated inference usage into a handler's return value under
+ * {@link RESULT_MODEL_CALLS_KEY}. No usage → the result passes through
+ * unchanged (normalising `undefined` to `null`, matching how AR serialises
+ * an empty return). The result object is shallow-copied, never mutated.
+ *
+ * Edge case: when usage exists but the handler returned a primitive or an
+ * array (can't carry a `_modelCalls` property), the value is wrapped as
+ * `{ result, _modelCalls }` so usage is never silently dropped.
+ */
+export declare function mergeModelCalls(result: unknown, usage: UsageAccumulator): unknown;
+//# sourceMappingURL=usage.d.ts.map

package/dist/runtime/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/runtime/usage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,2EAA2E;AAC3E,eAAO,MAAM,sBAAsB,gBAAgB,CAAC;AAEpD,8EAA8E;AAC9E,MAAM,WAAW,SAAS;IACxB,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,qBAAa,gBAAgB;IAC3B,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,CAAM;IAEjC,MAAM,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;CAG9B;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAWjF"}

package/dist/runtime/usage.js

@@ -0,0 +1,52 @@
+/**
+ * Inference-usage accumulation, propagated back to the orchestrator via a
+ * reserved key on the handler's return value.
+ *
+ * AR's `/v1/invoke` response carries only V8-profiler metrics (CPU / memory
+ * / wall-clock) — it does NOT meter inference. Per ADR-002 §Resource
+ * accounting / ADR-004, the SDK accumulates per-call inference usage from
+ * `ctx.models.*` calls and folds it into the handler result under
+ * `_modelCalls`; AR passes the result through opaquely; the orchestrator
+ * parses it at task-terminal and records it on the Task/Job.
+ *
+ * Source of truth (orchestrator side):
+ * `ddc-node/internal/compute/orchestrator/job/recorder.go`
+ * (`resultModelCallsKey = "_modelCalls"`). Keep `ModelCall` in sync with the
+ * struct it unmarshals into there.
+ */
+/** The reserved result key the orchestrator reads inference usage from. */
+export const RESULT_MODEL_CALLS_KEY = "_modelCalls";
+/**
+ * Per-invocation collector. One instance is created per handler call and
+ * threaded into the `ctx.models.*` shims; whatever they record is folded
+ * into the result by {@link mergeModelCalls}.
+ */
+export class UsageAccumulator {
+    calls = [];
+    record(call) {
+        this.calls.push(call);
+    }
+}
+/**
+ * Fold accumulated inference usage into a handler's return value under
+ * {@link RESULT_MODEL_CALLS_KEY}. No usage → the result passes through
+ * unchanged (normalising `undefined` to `null`, matching how AR serialises
+ * an empty return). The result object is shallow-copied, never mutated.
+ *
+ * Edge case: when usage exists but the handler returned a primitive or an
+ * array (can't carry a `_modelCalls` property), the value is wrapped as
+ * `{ result, _modelCalls }` so usage is never silently dropped.
+ */
+export function mergeModelCalls(result, usage) {
+    if (usage.calls.length === 0) {
+        return result === undefined ? null : result;
+    }
+    if (result === undefined || result === null) {
+        return { [RESULT_MODEL_CALLS_KEY]: usage.calls };
+    }
+    if (typeof result === "object" && !Array.isArray(result)) {
+        return { ...result, [RESULT_MODEL_CALLS_KEY]: usage.calls };
+    }
+    return { result, [RESULT_MODEL_CALLS_KEY]: usage.calls };
+}
+//# sourceMappingURL=usage.js.map

package/dist/runtime/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/runtime/usage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,2EAA2E;AAC3E,MAAM,CAAC,MAAM,sBAAsB,GAAG,aAAa,CAAC;AAoBpD;;;;GAIG;AACH,MAAM,OAAO,gBAAgB;IAClB,KAAK,GAAgB,EAAE,CAAC;IAEjC,MAAM,CAAC,IAAe;QACpB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;CACF;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAAC,MAAe,EAAE,KAAuB;IACtE,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;IAC9C,CAAC;IACD,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QAC5C,OAAO,EAAE,CAAC,sBAAsB,CAAC,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;IACnD,CAAC;IACD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACzD,OAAO,EAAE,GAAI,MAAkC,EAAE,CAAC,sBAAsB,CAAC,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;IAC3F,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,CAAC,sBAAsB,CAAC,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;AAC3D,CAAC"}

package/dist/types.d.ts

@@ -65,18 +65,21 @@ export interface ModelHandle<I = unknown, O = unknown> {
     stream(input: I): AsyncIterable<O>;
 }
 /**
- * Structured logger exposed as `ctx.log`. `fields` is merged into the
- * log record by the runtime.
+ * Declaration-merged map of the agent's declared model aliases to typed
+ * {@link ModelHandle}s. Populated by `cef typegen` from each model's
+ * `model.json` (`schema.inputs` / `schema.outputs`), so `ctx.models.<alias>`
+ * is typed end-to-end. Empty by default.
  *
- * (Spec history: `agent-sdk.md` §4 had `ctx.log(...args)`; the
- * sdk-runtime-integration-contract supersedes that with this leveled
- * shape.)
+ * Typegen extends it via:
+ * ```ts
+ * declare module "@cef-ai/agent-sdk" {
+ *   interface KnownModels {
+ *     gemma: ModelHandle<GemmaInput, GemmaOutput>;
+ *   }
+ * }
+ * ```
  */
-export interface Logger {
-    info(msg: string, fields?: Record<string, unknown>): void;
-    warn(msg: string, fields?: Record<string, unknown>): void;
-    error(msg: string, fields?: Record<string, unknown>): void;
-    debug(msg: string, fields?: Record<string, unknown>): void;
+export interface KnownModels {
 }
 /**
  * Reason passed to the `@OnClose` handler by the runtime, per
@@ -89,20 +92,14 @@ export interface Logger {
  */
 export type OnCloseReason = "revoked" | "idle_timeout" | "closed_by_agent" | "failed";
 /**
- * Subset of the standard `RequestInit` that the runtime's sandboxed
- * `ctx.fetch` accepts. Bodies are restricted to strings or raw bytes
- * (no streams, FormData, or Blobs) to keep the cross-isolate marshalling
- * predictable.
- */
-export interface FetchInit {
-    method?: string;
-    headers?: Record<string, string>;
-    body?: string | Uint8Array | null;
-    signal?: AbortSignal;
-}
-/**
- * The single object passed to lifecycle / event handlers. Surface defined
- * by sdk-runtime-integration-contract §3.
+ * The single object passed to event / lifecycle handlers — the CEF-specific
+ * platform surface only.
+ *
+ * Everything here genuinely needs the platform: each member is a shim that
+ * reads endpoints/auth/settings from the Agent Runtime's `globalThis.context`
+ * and calls back over `fetch`. Plain Web-platform capabilities are NOT
+ * mirrored here — agents use the sandbox globals directly: `console.*` for
+ * logging (the runtime captures it out-of-band) and `fetch` for HTTP.
  *
  * `publish` is overloaded so authors with typegen-populated
  * {@link KnownEventTypes} get payload-typed publishes; the fallback
@@ -111,19 +108,19 @@ export interface FetchInit {
 export interface Context {
     /** Per-alias scoped storage handle. */
     cubby(alias: string): CubbyHandle;
-    /** Map of model handles keyed by manifest-declared alias. */
-    models: Record<string, ModelHandle>;
-    /** Sandboxed HTTP fetch. */
-    fetch(url: string | URL, init?: FetchInit): Promise<Response>;
+    /**
+     * Model handles keyed by manifest-declared alias. Declared aliases are
+     * typed via {@link KnownModels} (filled in by `cef typegen`); any other
+     * alias falls back to an untyped `ModelHandle`.
+     */
+    models: KnownModels & Record<string, ModelHandle>;
     /** Publish a typed event. */
     publish<T extends keyof KnownEventTypes & string>(type: T, payload: KnownEventTypes[T]): Promise<void>;
     /** Publish an event with an arbitrary string type. */
     publish(type: string, payload: unknown): Promise<void>;
-    /** Frozen settings record from the agent manifest. */
+    /** Frozen ConnectionSettings supplied by the user at connect time. */
     settings: Readonly<Record<string, unknown>>;
     /** Ask the runtime to close this agent. `reason` is surfaced to telemetry. */
     close(reason?: string): Promise<void>;
-    /** Structured logger (see {@link Logger}). */
-    log: Logger;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,WAAW,eAAe;CAAG;AAEnC;;;GAGG;AACH,MAAM,WAAW,KAAK,CAAC,CAAC,GAAG,OAAO;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,CAAC,CAAC;CACZ;AAMD;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAClE,IAAI,CACF,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,OAAO,EAAE,GACjB,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC,CAAC;CACnE;AAMD;;;;;;;GAOG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO;IACnD,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5B,MAAM,CAAC,KAAK,EAAE,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;CACpC;AAED;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,WAAW;CAAG;AAM/B;;;;;;;;GAQG;AACH,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,cAAc,GACd,iBAAiB,GACjB,QAAQ,CAAC;AAMb;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,OAAO;IACtB,uCAAuC;IACvC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAAC;IAElC;;;;OAIG;IACH,MAAM,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAElD,6BAA6B;IAC7B,OAAO,CAAC,CAAC,SAAS,MAAM,eAAe,GAAG,MAAM,EAC9C,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,GAC1B,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,sDAAsD;IACtD,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvD,sEAAsE;IACtE,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAE5C,8EAA8E;IAC9E,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cef-ai/agent-sdk",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -12,6 +12,10 @@
     "./config": {
       "types": "./dist/config/index.d.ts",
       "default": "./dist/config/index.js"
+    },
+    "./runtime": {
+      "types": "./dist/runtime/index.d.ts",
+      "default": "./dist/runtime/index.js"
     }
   },
   "files": [