@cef-ai/agent-sdk 0.1.0

package/README.md

@@ -0,0 +1,119 @@
+# @cef-ai/agent-sdk
+
+Author agents for the Cere Execution Fabric: a small surface of decorators
+and types that maps directly to the runtime contract.
+
+## Install
+
+```sh
+pnpm add @cef-ai/agent-sdk
+```
+
+For tests, also install the harness:
+
+```sh
+pnpm add -D @cef-ai/testing
+```
+
+## Quickstart
+
+An agent is a default-exported class with decorated methods. `@OnEvent`
+binds an event type to a handler; `@OnStart` and `@OnClose` are lifecycle
+hooks. `Context` is the single object the runtime threads through every
+call.
+
+```ts
+import {
+  OnClose,
+  OnEvent,
+  OnStart,
+  type Context,
+  type Event,
+  type OnCloseReason,
+} from "@cef-ai/agent-sdk";
+
+interface UserMessage {
+  text: string;
+}
+
+export default class Echo {
+  @OnStart
+  async onStart(ctx: Context) {
+    ctx.log.info("started");
+  }
+
+  @OnEvent("user_message")
+  async onMessage(event: Event<UserMessage>, ctx: Context) {
+    await ctx
+      .cubby("history")
+      .exec("INSERT INTO messages(text, ts) VALUES (?, ?)", [
+        event.payload.text,
+        event.ts,
+      ]);
+    await ctx.publish("ack", { for: event.id });
+  }
+
+  @OnClose
+  async onClose(ctx: Context, reason: OnCloseReason) {
+    ctx.log.info("closing", { reason });
+  }
+}
+```
+
+Pair the class with a `cef.config.ts`:
+
+```ts
+import { defineAgent } from "@cef-ai/agent-sdk/config";
+
+export default defineAgent({
+  id: "echo",
+  version: "1.0.0",
+  entry: "./agent.ts",
+  cubbies: [{ alias: "history", migrations: "./migrations/history" }],
+});
+```
+
+## API summary
+
+| Kind | Symbol | Notes |
+| --- | --- | --- |
+| 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 | `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`. |
+
+## Subpath exports
+
+| Specifier | Purpose |
+| --- | --- |
+| `@cef-ai/agent-sdk` | Decorators, `Context`, `Event`, `KnownEventTypes`, `Logger`, `ModelHandle`, `CubbyHandle`, `FetchInit`, `OnCloseReason`. |
+| `@cef-ai/agent-sdk/config` | `defineAgent` and the `AgentConfig` shape — used in `cef.config.ts`. |
+
+For testing, use `@cef-ai/testing` directly — `import { testAgent } from "@cef-ai/testing"`.
+
+## Companion packages
+
+- [`@cef-ai/cli`](../cli) — `cef build` (esbuild + manifest), `cef typegen`
+  (populates `KnownEventTypes`), `cef inspect`.
+- [`@cef-ai/testing`](../testing) — simulator harness for unit and
+  integration tests.
+- [`@cef-ai/eslint-plugin`](../eslint-plugin) — editor-time lints mirroring
+  the build-time checks.
+
+## References
+
+- Agent SDK spec: `../../../company-memory-bank/specs/platform/03-components/agent-sdk.md`
+- Runtime integration contract: `../../../company-memory-bank/specs/platform/03-components/sdk-runtime-integration-contract.md`
+- Implementation plan: `../../../company-memory-bank/plans/2026-04-27-sdk-implementation-plan.md`
+
+The `../company-memory-bank/...` paths are local references to an internal
+sibling repo and are not browsable from a fresh clone.

package/dist/config/define-agent.d.ts

@@ -0,0 +1,181 @@
+/**
+ * Declarative configuration for an agent bundle.
+ *
+ * The shape mirrors `AgentManifest` in the platform spec
+ * (`specs/platform/prototype.md` §"Marketplace API → POST
+ * /api/v1/marketplace/agents"). `cef build` consumes this config to derive
+ * the manifest body that is later signed and published; identity fields
+ * (`agentId`, `agentServicePubkey`, `signature`) are filled in by
+ * `cef publish` and are NOT authored here.
+ *
+ * Per ADR-019, an agent contains one or more **engagements** — goal-bound
+ * code units. The config exposes two equivalent shapes for declaring them:
+ *
+ * - `entry: "./src/agent.ts"` — single-engagement shorthand. Equivalent to
+ *   `engagements: [{ id: "default", entry: "./src/agent.ts" }]`.
+ * - `engagements: [{ id, entry }, ...]` — explicit multi-engagement form.
+ *
+ * Exactly one of `entry` or `engagements` must be provided; the build step
+ * enforces this.
+ */
+/** JSON Schema document; left intentionally loose (consumed verbatim). */
+export type JSONSchema = Record<string, unknown>;
+/**
+ * One row of `targeting.engagements[]` — same shape as the platform's
+ * legacy `Deployment.Engagements[]` selection table. The build step
+ * validates that every `id` references a declared engagement and every
+ * rule `name` is one of the supported names.
+ */
+export interface TargetingEngagement {
+    /** Engagement id; must match a declared engagement. */
+    id: string;
+    /** Selection rules — see {@link Rule}. Empty array → defaults applied. */
+    rules?: Rule[];
+}
+/**
+ * A single selection rule on a targeting engagement. The supported
+ * vocabulary in v1 is:
+ *
+ * - `priority` (int, default 0) — lower value = higher priority.
+ * - `weight` (int, default 100) — probabilistic split within a tier.
+ * - `limit` (int) — daily UTC cap, per-vault. Counter-backed by the
+ *   platform; treated as advisory by the in-memory simulator.
+ *
+ * Future names are additive; the build validator rejects unknown names so
+ * authors get an early error instead of silently misrouted traffic.
+ */
+export interface Rule {
+    name: "priority" | "weight" | "limit";
+    value: number;
+}
+/**
+ * Engagement-selection decision table emitted into the manifest. Same shape
+ * as legacy `Deployment.Engagements[]` (without Stream binding / Triggers);
+ * the platform's existing evaluator consumes it directly. Engagements
+ * declared on the agent but **not** listed here are not selectable for new
+ * Jobs (per the prototype spec).
+ */
+export interface Targeting {
+    engagements: TargetingEngagement[];
+}
+/** Marketplace presentation card. */
+export interface AgentCard {
+    name: string;
+    description: string;
+    iconUrl?: string;
+    /** Free-form tags used by marketplace browse. */
+    capabilities?: string[];
+}
+/** One row of `settings[]` — declared at the agent level. */
+export interface SettingDecl {
+    key: string;
+    type: "string" | "number" | "boolean" | "url" | "secret";
+    required?: boolean;
+    label?: string;
+    description?: string;
+    default?: unknown;
+}
+/** One row of `cubbies[]`. */
+export interface CubbyDecl {
+    alias: string;
+    /** Path (relative to `cef.config.ts`) of a directory of `*.sql` migrations. */
+    migrations?: string;
+}
+export interface AgentConfig {
+    /**
+     * Human-friendly identifier used as the marketplace `alias`. The signed
+     * manifest's full `agentId` is `"{agentServicePubkey}:{uuid}"`, assigned
+     * by `cef publish` — `id` here is the alias, not the composite id.
+     */
+    id: string;
+    version: string;
+    /**
+     * Optional — overrides the alias derived from {@link AgentConfig.id}
+     * when the user wants the marketplace alias to differ from the build
+     * identifier (rare). Carried verbatim into `manifest.alias`.
+     */
+    alias?: string;
+    /**
+     * Optional free-form pointer to where the source lives — git URL, tarball,
+     * CID. Carried verbatim into `manifest.source`.
+     */
+    source?: string;
+    /** Marketplace presentation card. Optional with empty defaults. */
+    card?: AgentCard;
+    /**
+     * Vault scopes the agent needs at AgentConnection time. Defaults to
+     * `["default"]` when omitted.
+     */
+    requiredScopes?: string[];
+    /**
+     * Per-Job idle timeout as a **duration string** — `"15m"`, `"30s"`,
+     * `"1h"`, `"500ms"`, `"2d"`. After this much time has passed without
+     * a new activity on a Job, the orchestrator marks the Job terminal
+     * with `terminalReason: "idle_timeout"` and dispatches the synthetic
+     * `__close__` event (per the
+     * [orchestrator jobs redesign](../../specs/platform/orchestrator-jobs-redesign.md)).
+     *
+     * The build step parses this into milliseconds and writes the integer
+     * value into `manifest.idleTimeout`. Defaults to `"30m"` when omitted.
+     * Set to `"0s"` to disable idle-based termination — the Job will only
+     * terminate on `ctx.close(reason)` or AgentConnection revocation.
+     *
+     * Accepted units: `ms`, `s`, `m`, `h`, `d`. Whitespace between the
+     * number and the unit is ignored.
+     */
+    idleTimeout?: string;
+    /**
+     * Single-engagement shorthand. Equivalent to
+     * `engagements: [{ id: "default", entry }]`. Mutually exclusive with
+     * {@link AgentConfig.engagements}.
+     */
+    entry?: string;
+    /**
+     * Multi-engagement declaration (target shape per ADR-019). Each entry
+     * has its own stable `id` (matching `[a-zA-Z][a-zA-Z0-9_-]*`) and a path
+     * to a TypeScript source file exporting an engagement class as default.
+     * Mutually exclusive with {@link AgentConfig.entry}.
+     */
+    engagements?: Array<{
+        id: string;
+        entry: string;
+    }>;
+    /** Reserved for nested multi-bundle configs (Pattern 1). */
+    agents?: AgentConfig[];
+    models?: Record<string, string>;
+    uses?: Record<string, string>;
+    cubbies?: CubbyDecl[];
+    settings?: SettingDecl[];
+    fetch?: {
+        allow?: string[];
+    };
+    /**
+     * Schemas for events this agent **owns** — events it publishes, plus
+     * events it handles whose publisher is not a declared peer. Per
+     * `prototype.md`, peer-published event schemas live in the peer's
+     * manifest and are pulled in by `cef typegen`.
+     */
+    eventSchemas?: Record<string, JSONSchema>;
+    /**
+     * Optional engagement-selection decision table (ADR-019). Pinned to a
+     * Job at creation time; subsequent events for that Job run through the
+     * pinned engagement. When omitted, the build defaults to a single
+     * targeting entry referencing the first declared engagement.
+     */
+    targeting?: Targeting;
+}
+/**
+ * Identity function with type narrowing — used at the top of a bundle's
+ * `cef.config.ts` to declare an `AgentConfig` while preserving the literal
+ * types of its fields for better downstream inference.
+ *
+ * ```ts
+ * export default defineAgent({
+ *   id: "echo",
+ *   version: "1.0.0",
+ *   entry: "./src/agent.ts",
+ * });
+ * ```
+ */
+export declare const defineAgent: <T extends AgentConfig>(c: T) => T;
+//# sourceMappingURL=define-agent.d.ts.map

package/dist/config/define-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-agent.d.ts","sourceRoot":"","sources":["../../src/config/define-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,0EAA0E;AAC1E,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,uDAAuD;IACvD,EAAE,EAAE,MAAM,CAAC;IACX,0EAA0E;IAC1E,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;CAChB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;IACtC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;GAMG;AACH,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,mBAAmB,EAAE,CAAC;CACpC;AAED,qCAAqC;AACrC,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,6DAA6D;AAC7D,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,CAAC;IACzD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,8BAA8B;AAC9B,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B;;;;;;;;;;;;;;;OAeG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,WAAW,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,4DAA4D;IAC5D,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC7B;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC1C;;;;;OAKG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,WAAW,EAAE,GAAG,CAAC,KAAG,CAAM,CAAC"}

package/dist/config/define-agent.js

@@ -0,0 +1,35 @@
+/**
+ * Declarative configuration for an agent bundle.
+ *
+ * The shape mirrors `AgentManifest` in the platform spec
+ * (`specs/platform/prototype.md` §"Marketplace API → POST
+ * /api/v1/marketplace/agents"). `cef build` consumes this config to derive
+ * the manifest body that is later signed and published; identity fields
+ * (`agentId`, `agentServicePubkey`, `signature`) are filled in by
+ * `cef publish` and are NOT authored here.
+ *
+ * Per ADR-019, an agent contains one or more **engagements** — goal-bound
+ * code units. The config exposes two equivalent shapes for declaring them:
+ *
+ * - `entry: "./src/agent.ts"` — single-engagement shorthand. Equivalent to
+ *   `engagements: [{ id: "default", entry: "./src/agent.ts" }]`.
+ * - `engagements: [{ id, entry }, ...]` — explicit multi-engagement form.
+ *
+ * Exactly one of `entry` or `engagements` must be provided; the build step
+ * enforces this.
+ */
+/**
+ * Identity function with type narrowing — used at the top of a bundle's
+ * `cef.config.ts` to declare an `AgentConfig` while preserving the literal
+ * types of its fields for better downstream inference.
+ *
+ * ```ts
+ * export default defineAgent({
+ *   id: "echo",
+ *   version: "1.0.0",
+ *   entry: "./src/agent.ts",
+ * });
+ * ```
+ */
+export const defineAgent = (c) => c;
+//# sourceMappingURL=define-agent.js.map

package/dist/config/define-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-agent.js","sourceRoot":"","sources":["../../src/config/define-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAuJH;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAwB,CAAI,EAAK,EAAE,CAAC,CAAC,CAAC"}

package/dist/config/index.d.ts

@@ -0,0 +1,3 @@
+export { defineAgent } from "./define-agent.js";
+export type { AgentCard, AgentConfig, CubbyDecl, JSONSchema, Rule, SettingDecl, Targeting, TargetingEngagement, } from "./define-agent.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EACV,SAAS,EACT,WAAW,EACX,SAAS,EACT,UAAU,EACV,IAAI,EACJ,WAAW,EACX,SAAS,EACT,mBAAmB,GACpB,MAAM,mBAAmB,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,2 @@
+export { defineAgent } from "./define-agent.js";
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/decorators.d.ts

@@ -0,0 +1,38 @@
+import type { KnownEventTypes } from "./types.js";
+/**
+ * Mark an instance method as the handler for an inbound event of type `T`.
+ *
+ * The first overload uses {@link KnownEventTypes} (declaration-merged by
+ * the typegen step in agent-sdk consumers) so authors get autocompletion
+ * for the event types declared in their agent manifest. The second
+ * overload accepts any string for ergonomic use without typegen.
+ *
+ * Duplicate registrations for the same event type keep the first handler
+ * and emit a `console.warn`. Build-time tooling will surface this as an
+ * error.
+ */
+export declare function OnEvent<T extends keyof KnownEventTypes & string>(type: T): MethodDecorator;
+export declare function OnEvent(type: string): MethodDecorator;
+/**
+ * A lifecycle decorator that supports both bare (`@OnStart`) and factory
+ * (`@OnStart()`) call forms. The bare form applies the decorator directly;
+ * the factory form returns a new decorator. Both land the same metadata.
+ */
+export type DualLifecycleDecorator = MethodDecorator & (() => MethodDecorator);
+/**
+ * Mark an instance method as the agent's `start` lifecycle hook. Called
+ * by the runtime once the agent instance has been wired with its
+ * {@link Context} and before any events are dispatched.
+ *
+ * Both bare (`@OnStart`) and factory (`@OnStart()`) forms are supported.
+ */
+export declare const OnStart: DualLifecycleDecorator;
+/**
+ * Mark an instance method as the agent's `close` lifecycle hook. Called
+ * by the runtime when the agent instance is being shut down (revoked,
+ * idle-timed-out, closed by itself, or failed).
+ *
+ * Both bare (`@OnClose`) and factory (`@OnClose()`) forms are supported.
+ */
+export declare const OnClose: DualLifecycleDecorator;
+//# sourceMappingURL=decorators.d.ts.map

package/dist/decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAsBlD;;;;;;;;;;;GAWG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,MAAM,eAAe,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,eAAe,CAAC;AAC5F,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAAC;AAevD;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,eAAe,GAAG,CAAC,MAAM,eAAe,CAAC,CAAC;AAoB/E;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,EAAE,sBAAwD,CAAC;AAE/E;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,EAAE,sBAAwD,CAAC"}

package/dist/decorators.js

@@ -0,0 +1,60 @@
+import { ENGAGEMENT_METADATA } from "./symbols.js";
+/**
+ * Resolve (or lazily create) the {@link EngagementMeta} record on a class.
+ *
+ * Method decorators run with `target` bound to the prototype for instance
+ * methods, so we attach metadata to `target.constructor` (the class itself).
+ * This keeps the metadata reachable as `MyEngagement[ENGAGEMENT_METADATA]`
+ * from outside, and shares the slot with `@Engagement` (which writes to the
+ * constructor directly).
+ */
+function ensureMeta(target) {
+    const ctor = target.constructor;
+    if (!ctor[ENGAGEMENT_METADATA]) {
+        ctor[ENGAGEMENT_METADATA] = {
+            events: {},
+            lifecycle: {},
+        };
+    }
+    return ctor[ENGAGEMENT_METADATA];
+}
+export function OnEvent(type) {
+    return (target, propertyKey) => {
+        const meta = ensureMeta(target);
+        if (meta.events[type]) {
+            // Build-time tooling will error on duplicates; at runtime, first wins.
+            console.warn(`[@cef-ai/agent-sdk] duplicate handler for "${type}" (kept: ${meta.events[type]})`);
+            return;
+        }
+        meta.events[type] = String(propertyKey);
+    };
+}
+function makeLifecycleDecorator(field) {
+    const apply = (target, propertyKey) => {
+        const meta = ensureMeta(target);
+        (meta.lifecycle ??= {})[field] = String(propertyKey);
+    };
+    function dual(...args) {
+        if (args.length === 0)
+            return apply;
+        return apply(...args);
+    }
+    return dual;
+}
+/**
+ * Mark an instance method as the agent's `start` lifecycle hook. Called
+ * by the runtime once the agent instance has been wired with its
+ * {@link Context} and before any events are dispatched.
+ *
+ * Both bare (`@OnStart`) and factory (`@OnStart()`) forms are supported.
+ */
+export const OnStart = makeLifecycleDecorator("start");
+/**
+ * Mark an instance method as the agent's `close` lifecycle hook. Called
+ * by the runtime when the agent instance is being shut down (revoked,
+ * idle-timed-out, closed by itself, or failed).
+ *
+ * Both bare (`@OnClose`) and factory (`@OnClose()`) forms are supported.
+ */
+export const OnClose = makeLifecycleDecorator("close");
+//# sourceMappingURL=decorators.js.map

package/dist/decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAuB,MAAM,cAAc,CAAC;AAGxE;;;;;;;;GAQG;AACH,SAAS,UAAU,CAAC,MAAW;IAC7B,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC;IAChC,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,EAAE,CAAC;QAC/B,IAAI,CAAC,mBAAmB,CAAC,GAAG;YAC1B,MAAM,EAAE,EAAE;YACV,SAAS,EAAE,EAAE;SACW,CAAC;IAC7B,CAAC;IACD,OAAO,IAAI,CAAC,mBAAmB,CAAC,CAAC;AACnC,CAAC;AAgBD,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE;QAC7B,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;QAChC,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YACtB,uEAAuE;YACvE,OAAO,CAAC,IAAI,CACV,8CAA8C,IAAI,YAAY,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CACnF,CAAC;YACF,OAAO;QACT,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IAC1C,CAAC,CAAC;AACJ,CAAC;AASD,SAAS,sBAAsB,CAAC,KAAwB;IACtD,MAAM,KAAK,GAAoB,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE;QACrD,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC,IAAI,CAAC,SAAS,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IACvD,CAAC,CAAC;IAOF,SAAS,IAAI,CAAC,GAAG,IAAW;QAC1B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QACpC,OAAQ,KAA8B,CAAC,GAAG,IAAI,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,IAA8B,CAAC;AACxC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,OAAO,GAA2B,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAE/E;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,OAAO,GAA2B,sBAAsB,CAAC,OAAO,CAAC,CAAC"}

package/dist/engagement.d.ts

@@ -0,0 +1,13 @@
+export interface EngagementOptions {
+    /** Stable identifier for this engagement within its agent. */
+    id: string;
+    /** Human-readable goal — what this engagement is for. */
+    goal: string;
+}
+/**
+ * Mark a class as an Engagement. Sets `id` and `goal` on the metadata slot;
+ * composes with `@OnEvent` / `@OnStart` / `@OnClose` regardless of decorator
+ * application order.
+ */
+export declare function Engagement(opts: EngagementOptions): ClassDecorator;
+//# sourceMappingURL=engagement.d.ts.map

package/dist/engagement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engagement.d.ts","sourceRoot":"","sources":["../src/engagement.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,iBAAiB;IAChC,8DAA8D;IAC9D,EAAE,EAAE,MAAM,CAAC;IACX,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;CACd;AAmBD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,cAAc,CAMlE"}

package/dist/engagement.js

@@ -0,0 +1,40 @@
+/**
+ * `@Engagement(opts)` — class decorator that marks a class as an Engagement
+ * (goal-bound code unit inside an Agent, per ADR-019).
+ *
+ * Stores `id` and `goal` on the same {@link ENGAGEMENT_METADATA} slot the
+ * method decorators (`@OnEvent` / `@OnStart` / `@OnClose`) write to. The two
+ * decorator families are order-independent: applying `@Engagement` before or
+ * after the method decorators yields identical metadata, since both lazily
+ * initialise the slot if it doesn't already exist.
+ */
+import { ENGAGEMENT_METADATA } from "./symbols.js";
+/**
+ * Resolve (or lazily create) the {@link EngagementMeta} record on a class.
+ *
+ * Class decorators receive the constructor as `target`, so we attach
+ * metadata directly. (Method decorators in `decorators.ts` get the prototype
+ * and walk to `target.constructor` — both paths land on the same slot.)
+ */
+function ensureMeta(target) {
+    if (!target[ENGAGEMENT_METADATA]) {
+        target[ENGAGEMENT_METADATA] = {
+            events: {},
+            lifecycle: {},
+        };
+    }
+    return target[ENGAGEMENT_METADATA];
+}
+/**
+ * Mark a class as an Engagement. Sets `id` and `goal` on the metadata slot;
+ * composes with `@OnEvent` / `@OnStart` / `@OnClose` regardless of decorator
+ * application order.
+ */
+export function Engagement(opts) {
+    return ((target) => {
+        const meta = ensureMeta(target);
+        meta.id = opts.id;
+        meta.goal = opts.goal;
+    });
+}
+//# sourceMappingURL=engagement.js.map

package/dist/engagement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engagement.js","sourceRoot":"","sources":["../src/engagement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,mBAAmB,EAAuB,MAAM,cAAc,CAAC;AASxE;;;;;;GAMG;AACH,SAAS,UAAU,CAAC,MAAW;IAC7B,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,EAAE,CAAC;QACjC,MAAM,CAAC,mBAAmB,CAAC,GAAG;YAC5B,MAAM,EAAE,EAAE;YACV,SAAS,EAAE,EAAE;SACW,CAAC;IAC7B,CAAC;IACD,OAAO,MAAM,CAAC,mBAAmB,CAAC,CAAC;AACrC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,IAAuB;IAChD,OAAO,CAAC,CAAC,MAAW,EAAE,EAAE;QACtB,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;QAChC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;QAClB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACxB,CAAC,CAAmB,CAAC;AACvB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+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 { AgentCard, CubbyDecl, JSONSchema, Rule, SettingDecl, Targeting, TargetingEngagement, } from "./config/define-agent.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,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"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { OnEvent, OnStart, OnClose } from "./decorators.js";
+export { Engagement } from "./engagement.js";
+export { ENGAGEMENT_METADATA } from "./symbols.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,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EAAE,mBAAmB,EAAuB,MAAM,cAAc,CAAC"}

package/dist/symbols.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Global registered symbol used to attach engagement metadata (event/lifecycle
+ * handler maps + engagement id/goal) to a class. Using `Symbol.for` ensures the
+ * same symbol is shared even if `@cef-ai/agent-sdk` is loaded from multiple
+ * locations (e.g. the agent author's bundle and the runtime that introspects it).
+ *
+ * Per ADR-019, an Engagement is a goal-bound code unit inside an Agent. The
+ * `@Engagement` class decorator and `@OnEvent` / `@OnStart` / `@OnClose` method
+ * decorators all write to this same slot on the class constructor.
+ */
+export declare const ENGAGEMENT_METADATA: unique symbol;
+export type ENGAGEMENT_METADATA = typeof ENGAGEMENT_METADATA;
+/**
+ * Shape of the metadata object that `@Engagement` / `@OnEvent` / `@OnStart` /
+ * `@OnClose` decorators attach to a class via {@link ENGAGEMENT_METADATA}.
+ *
+ * - `id` / `goal` are set by `@Engagement(opts)`. Undefined for v0.1.0-style
+ *   classes that only use the method decorators (transitional — H2 will gate
+ *   manifest emission on whether `@Engagement` was applied).
+ * - `events[type]` is the method name that handles event `type`.
+ * - `lifecycle.start` / `lifecycle.close` are method names for the
+ *   start/close lifecycle hooks.
+ */
+export interface EngagementMeta {
+    id?: string;
+    goal?: string;
+    events: Record<string, string>;
+    lifecycle?: {
+        start?: string;
+        close?: string;
+    };
+}
+//# sourceMappingURL=symbols.d.ts.map

package/dist/symbols.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbols.d.ts","sourceRoot":"","sources":["../src/symbols.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB,EAAE,OAAO,MAExC,CAAC;AACF,MAAM,MAAM,mBAAmB,GAAG,OAAO,mBAAmB,CAAC;AAE7D;;;;;;;;;;GAUG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,SAAS,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAChD"}

package/dist/symbols.js

@@ -0,0 +1,12 @@
+/**
+ * Global registered symbol used to attach engagement metadata (event/lifecycle
+ * handler maps + engagement id/goal) to a class. Using `Symbol.for` ensures the
+ * same symbol is shared even if `@cef-ai/agent-sdk` is loaded from multiple
+ * locations (e.g. the agent author's bundle and the runtime that introspects it).
+ *
+ * Per ADR-019, an Engagement is a goal-bound code unit inside an Agent. The
+ * `@Engagement` class decorator and `@OnEvent` / `@OnStart` / `@OnClose` method
+ * decorators all write to this same slot on the class constructor.
+ */
+export const ENGAGEMENT_METADATA = Symbol.for("@cef-ai/agent-sdk/engagement-metadata");
+//# sourceMappingURL=symbols.js.map

package/dist/symbols.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbols.js","sourceRoot":"","sources":["../src/symbols.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAkB,MAAM,CAAC,GAAG,CAC1D,uCAAuC,CACxC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Public type surface for `@cef-ai/agent-sdk`.
+ *
+ * Sources of truth:
+ * - `sdk-runtime-integration-contract.md` §3 (ctx surface) and §4 (close
+ *   reasons) — newer, authoritative for the `Context` shape.
+ * - `agent-sdk.md` §4 — Event / CubbyHandle / ModelHandle shapes.
+ *
+ * No imports: this module is purely declarative so it can be consumed
+ * by both the SDK runtime and downstream agent code without pulling in
+ * implementation modules.
+ */
+/**
+ * Declaration-merged interface listing the event types known to a given
+ * agent build. Populated by the typegen step from the agent manifest;
+ * empty by default.
+ *
+ * Authors / typegen extend it via:
+ * ```ts
+ * declare module "@cef-ai/agent-sdk" {
+ *   interface KnownEventTypes {
+ *     user_message: { text: string };
+ *     tool_result: { id: string; output: unknown };
+ *   }
+ * }
+ * ```
+ *
+ * Consumed by `@OnEvent` and `ctx.publish` to provide string-literal
+ * autocompletion and payload typing.
+ */
+export interface KnownEventTypes {
+}
+/**
+ * An event flowing through the runtime. `from` identifies the publisher
+ * (agent id or external source); `ts` is a unix-millis timestamp.
+ */
+export interface Event<P = unknown> {
+    id: string;
+    type: string;
+    ts: number;
+    from: string;
+    payload: P;
+}
+/**
+ * Handle returned by `ctx.cubby(alias)` — a typed, scoped SQLite-style
+ * key/value store bound to the agent instance.
+ */
+export interface CubbyHandle {
+    query<T = unknown>(sql: string, params?: unknown[]): Promise<T[]>;
+    exec(sql: string, params?: unknown[]): Promise<{
+        changes: number;
+        lastInsertRowid: number | bigint;
+    }>;
+}
+/**
+ * Handle for invoking a model bound to the agent under an alias declared
+ * in its manifest. `infer` is single-shot; `stream` yields chunks of the
+ * same output type.
+ *
+ * `I` is the input shape; `O` is the output (or stream chunk) shape.
+ * Defaults to `unknown` so the same handle type composes with raw SDKs.
+ */
+export interface ModelHandle<I = unknown, O = unknown> {
+    infer(input: I): Promise<O>;
+    stream(input: I): AsyncIterable<O>;
+}
+/**
+ * Structured logger exposed as `ctx.log`. `fields` is merged into the
+ * log record by the runtime.
+ *
+ * (Spec history: `agent-sdk.md` §4 had `ctx.log(...args)`; the
+ * sdk-runtime-integration-contract supersedes that with this leveled
+ * shape.)
+ */
+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;
+}
+/**
+ * Reason passed to the `@OnClose` handler by the runtime, per
+ * sdk-runtime-integration-contract §4.
+ *
+ * - `"revoked"`        — capability/credential revoked by the platform.
+ * - `"idle_timeout"`   — no events for the configured idle window.
+ * - `"closed_by_agent"`— agent invoked `ctx.close()`.
+ * - `"failed"`         — the runtime is tearing the agent down after an error.
+ */
+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.
+ *
+ * `publish` is overloaded so authors with typegen-populated
+ * {@link KnownEventTypes} get payload-typed publishes; the fallback
+ * untyped overload accepts any string event type.
+ */
+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>;
+    /** 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. */
+    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

@@ -0,0 +1 @@
+{"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;AAMD;;;;;;;GAOG;AACH,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC1D,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC1D,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC3D,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC5D;AAMD;;;;;;;;GAQG;AACH,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,cAAc,GACd,iBAAiB,GACjB,QAAQ,CAAC;AAMb;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;IAClC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAMD;;;;;;;GAOG;AACH,MAAM,WAAW,OAAO;IACtB,uCAAuC;IACvC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAAC;IAElC,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAEpC,4BAA4B;IAC5B,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE9D,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,sDAAsD;IACtD,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;IAEtC,8CAA8C;IAC9C,GAAG,EAAE,MAAM,CAAC;CACb"}

package/dist/types.js

@@ -0,0 +1,14 @@
+/**
+ * Public type surface for `@cef-ai/agent-sdk`.
+ *
+ * Sources of truth:
+ * - `sdk-runtime-integration-contract.md` §3 (ctx surface) and §4 (close
+ *   reasons) — newer, authoritative for the `Context` shape.
+ * - `agent-sdk.md` §4 — Event / CubbyHandle / ModelHandle shapes.
+ *
+ * No imports: this module is purely declarative so it can be consumed
+ * by both the SDK runtime and downstream agent code without pulling in
+ * implementation modules.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@cef-ai/agent-sdk",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./config": {
+      "types": "./dist/config/index.d.ts",
+      "default": "./dist/config/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.5.0"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "test": "vitest run",
+    "lint": "eslint src"
+  }
+}