@cef-ai/cli 1.4.0 → 1.5.0

package/templates/hello-world/deployments/sandbox-canary.jsonc

@@ -0,0 +1,12 @@
+// Example audience deployment: only sandbox vaults get this pinned build;
+// everyone else falls through to default.jsonc. Edit or delete freely.
+//
+// targeting is a CEL expression over vault.id / vault.scope / event.type.
+// Among matching deployments the LOWEST priority wins; within a tier, traffic
+// splits by weight (that's how you run an A/B test).
+{
+  "priority": 10, // lower than the default (99) => wins for matching vaults
+  "targeting": "vault.scope == 'sandbox'",
+  "version": "0.1.0",
+  "weight": 1
+}

package/templates/hello-world/gitignore

@@ -0,0 +1,3 @@
+node_modules/
+dist/
+.cef/

package/templates/hello-world/migrations/history/001-init.sql

@@ -0,0 +1,5 @@
+CREATE TABLE messages (
+  id   INTEGER PRIMARY KEY,
+  text TEXT NOT NULL,
+  ts   INTEGER NOT NULL
+);

package/templates/hello-world/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "{{projectName}}",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "build": "cef build",
+    "typegen": "cef typegen",
+    "test": "vitest run",
+    "push": "cef push",
+    "deploy": "cef deploy",
+    "publish": "cef publish"
+  },
+  "dependencies": {
+    "@cef-ai/agent-sdk": "^1.4.0"
+  },
+  "devDependencies": {
+    "@cef-ai/cli": "^1.4.0",
+    "@cef-ai/testing": "^1.1.9",
+    "typescript": "^5.4.0",
+    "vitest": "^1.5.0"
+  }
+}

package/templates/hello-world/src/agent.ts

@@ -0,0 +1,44 @@
+import {
+  Engagement,
+  OnEvent,
+  OnStart,
+  OnClose,
+  type Context,
+  type Event,
+} from "@cef-ai/agent-sdk";
+
+interface UserMessage {
+  text: string;
+}
+
+@Engagement({
+  id: "default",
+  goal: "reply to a user message and remember it",
+})
+export default class HelloAgent {
+  @OnStart
+  async onStart() {
+    // Plain logging goes to the sandbox console; `ctx` is only for
+    // CEF-specific calls (cubby / publish / models / close).
+    console.info("hello-world agent started");
+  }
+
+  @OnEvent("user_message")
+  async onMessage(event: Event<UserMessage>, ctx: Context) {
+    await ctx
+      .cubby("history")
+      .exec("INSERT INTO messages(id, text, ts) VALUES (?, ?, ?)", [
+        Date.now(),
+        event.payload.text,
+        event.ts,
+      ]);
+    await ctx.publish("reply", {
+      text: `hello — you said: ${event.payload.text}`,
+    });
+  }
+
+  @OnClose
+  async onClose(_ctx: Context, reason: string) {
+    console.info("hello-world agent closing", { reason });
+  }
+}

package/templates/hello-world/test/agent.test.ts

@@ -0,0 +1,28 @@
+import { describe, it, expect, afterEach } from "vitest";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { testAgent, type TestHarness } from "@cef-ai/testing";
+import HelloAgent from "../src/agent.js";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const HISTORY_MIGRATIONS = path.resolve(__dirname, "../migrations/history");
+
+describe("hello-world agent", () => {
+  let h: TestHarness | undefined;
+  afterEach(() => h?.dispose());
+
+  it("replies to user_message and persists to history", async () => {
+    h = testAgent(HelloAgent, {
+      cubbies: [{ alias: "history", migrations: HISTORY_MIGRATIONS }],
+    });
+    const events = await h.dispatch({
+      type: "user_message",
+      payload: { text: "hi" },
+    });
+    expect(events.map((e) => e.type)).toContain("reply");
+    const rows = await h
+      .cubby("history")
+      .query<{ text: string }>("SELECT text FROM messages");
+    expect(rows.map((r) => r.text)).toEqual(["hi"]);
+  });
+});

package/templates/hello-world/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2022"],
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "isolatedModules": true,
+    "resolveJsonModule": true,
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": false,
+    "noEmit": true
+  },
+  "include": ["src/**/*", "test/**/*", "cef.config.ts"],
+  "exclude": ["dist", ".cef", "node_modules"]
+}

package/templates/hello-world/widgets/hello/app.js

@@ -0,0 +1,8 @@
+// A minimal, self-contained widget (plain HTML + JS — no build step).
+//
+// When the @cef-ai/widget-runtime ships, you can read this agent's cubby
+// and publish events from here, e.g.:
+//   const { rows } = await window.WidgetRuntime.query("SELECT text FROM messages");
+//   await window.WidgetRuntime.publish("user_message", { text: "hi" });
+document.getElementById("root").textContent =
+  "hello from {{agentId}} — this is your widget";

package/templates/hello-world/widgets/hello/hello.html

@@ -0,0 +1,5 @@
+<!doctype html>
+<meta charset="utf-8" />
+<title>Hello — {{agentId}}</title>
+<div id="root"></div>
+<script src="./app.js"></script>