okengine 0.18.4 → 0.19.0

package/src/compiler/fixtures/skyport/src/flows/bookings/index.ts

@@ -14,11 +14,14 @@ void 0;
 void 0;
 
 export const create = on(
-  http.post("/bookings").gate(book),
+  http
+    .post("/bookings", {
+      in: BookingIn,
+      out: BookingOut,
+      errors: { FlightFull },
+    })
+    .gate(book),
   flow("bookings.create", {
-    in: BookingIn,
-    out: BookingOut,
-    errors: { FlightFull },
     slo: { availability: "99.9%", latency: { p99: "200ms" } },
     plane: "user",
     do: async (input, fx) => {

package/src/compiler/fixtures/skyport/src/flows/bookings/signals.ts

@@ -1,11 +1,5 @@
 import { signal } from "okengine";
 
-export const orderPlaced = signal("order-placed", {
-  delivery: "once",
-  retries: 5,
-  deadLetter: true,
-});
+export const orderPlaced = signal.once("order-placed", { retries: 5, deadLetter: true });
 
-export const seatFeed = signal("seat-feed", {
-  delivery: "live",
-});
+export const seatFeed = signal.live("seat-feed");

package/src/compiler/fixtures/skyport.expected.json

@@ -19,7 +19,7 @@
         "emits": ["order-placed", "seat-feed"],
         "secrets": []
       },
-      "source": "src/flows/bookings/index.ts:18",
+      "source": "src/flows/bookings/index.ts:24",
       "slo": {
         "availability": "99.9%",
         "latency": {
@@ -32,7 +32,7 @@
       "effects": {
         "reads": ["sql:bookings"]
       },
-      "source": "src/flows/bookings/index.ts:47"
+      "source": "src/flows/bookings/index.ts:50"
     },
     "bookings.mine": {
       "trigger": {
@@ -45,7 +45,7 @@
       "effects": {
         "reads": ["sql:bookings"]
       },
-      "source": "src/flows/bookings/index.ts:37",
+      "source": "src/flows/bookings/index.ts:40",
       "cacheKeys": "computed:sql:bookings/userId"
     },
     "bookings.refundBooking": {
@@ -53,7 +53,7 @@
         "reads": ["sql:bookings"],
         "writes": ["sql:bookings"]
       },
-      "source": "src/flows/bookings/index.ts:51"
+      "source": "src/flows/bookings/index.ts:54"
     },
     "payments.chargeBooking": {
       "effects": {

package/src/compiler/fixtures/triggers/five-triggers.ts

@@ -1,18 +1,21 @@
 /**
  * All five trigger kinds — effects inferred through `fx` for each.
  */
-import { on, flow, http, every, internal, table, signal, store } from "okengine";
+import { on, flow, http, internal, signal, store, clock, field } from "okengine";
 
 export const db = store.sql("db");
-export const orders = { name: "orders" };
-export const links = { name: "links" };
-
-export const linkClicked = signal("link-clicked", {
-  delivery: "once",
-  retries: 3,
-  deadLetter: true,
+export const orders = store.schema.table("orders", {
+  id: field.text().primaryKey(),
+  status: field.text(),
+});
+export const links = store.schema.table("links", {
+  code: field.text().primaryKey(),
+  clicks: field.integer(),
+  createdAt: field.integer(),
 });
 
+export const linkClicked = signal.once("link-clicked", { retries: 3, deadLetter: true });
+
 // ① HTTP
 export const create = on(
   http.post("/orders"),
@@ -25,8 +28,9 @@ export const create = on(
 );
 
 // ② CLOCK / every
+export const cleanup = clock("cleanup", { every: "10m" });
 on(
-  every("10m"),
+  cleanup,
   flow("triggers.every", {
     do: (_, fx) => fx.store(db).delete(links).where({ createdAt: 0 }),
   }),
@@ -45,7 +49,7 @@ on(
 
 // ④ CDC
 on(
-  table("orders").changed("status"),
+  db.table(orders).changed("status"),
   flow("triggers.cdc", {
     do: ({ before, after }, fx) => fx.store(db).insert(orders).values({ before, after }),
   }),

package/src/compiler/response.ts

@@ -98,7 +98,7 @@ function loadFxJson(): {
 /**
  * Encode an execute-style result (response / failure / output).
  *
- * Awaits {@link JsonStreamResult.ready} before the 200 SSE body so OKE1014
+ * Awaits {@link JsonStreamResult.ready} before the 200 SSE body so OKE1210
  * can return 410 instead of a half-open stream.
  *
  * @param result - Pipeline outcome pieces
@@ -119,7 +119,7 @@ export async function encodeExecuteResult(result: {
       result.error !== null &&
       typeof result.error === "object" &&
       "code" in result.error &&
-      (result.error as { code: unknown }).code === 1014
+      (result.error as { code: unknown }).code === 1210
         ? loadFxLiveStream().encodeGap(result.error)
         : undefined;
     if (gap) return gap;

package/src/compiler/search-writer-isolation.test.ts

@@ -0,0 +1,40 @@
+/**
+ * Writer flows that only DML must not infer effects.embeds.
+ */
+
+import { describe, expect, test } from "bun:test";
+import { extractFromSources } from "./extract.ts";
+
+describe("hybrid search — writer effect isolation", () => {
+  test("insert-only flow has no embeds effect", async () => {
+    const source = `
+import { on, flow, http, store, field, ai } from "okengine";
+
+export const embedder = ai.model("embedder", { provider: "openai-compatible", model: "nomic-embed-text" });
+
+export const articles = store.schema.table("articles", {
+  id: field.text().primaryKey(),
+  body: field.text().searchable().embed({ dims: 8, model: embedder }),
+});
+export const db = store.sql("app", { schema: { articles } });
+
+export const create = on(
+  http.post("/articles"),
+  flow("articles.create", {
+    do: async (input, fx) => {
+      await fx.store(db).insert(articles).values(input);
+      return { ok: true };
+    },
+  }),
+);
+`;
+    const manifest = await extractFromSources({
+      "src/schema.decl.ts": source,
+      "src/flows/articles.ts": source,
+    });
+    const effects = manifest.flows?.["articles.create"]?.effects;
+    expect(effects?.embeds).toBeUndefined();
+    expect(effects?.asks).toBeUndefined();
+    expect(effects?.writes).toContain("sql:articles");
+  });
+});

package/src/config/index.ts

@@ -136,6 +136,15 @@ export interface I18nConfig {
   readonly dir?: Readonly<Record<string, "ltr" | "rtl">>;
 }
 
+/** Clock element defaults in {@link defineConfig}. */
+export interface ClockConfig {
+  /**
+   * Default IANA timezone for `clock()` declarations that omit `timezone`.
+   * Overridden by `oke({ clock: { timezone } })` and by per-clock `timezone`.
+   */
+  readonly timezone?: string;
+}
+
 /** Context passed to {@link TenancyConfig.resolve} (Skyport / multi-tenant). */
 export interface TenancyResolveContext {
   readonly auth: {
@@ -229,6 +238,8 @@ export interface OkeConfig {
   readonly drivers?: DriversConfig;
   readonly images?: ImagesConfig;
   readonly i18n?: I18nConfig;
+  /** Default Clock timezone (and future clock element defaults). */
+  readonly clock?: ClockConfig;
   readonly tenancy?: TenancyConfig;
   /**
    * Privacy tooling / redact policy. Presence (or {@link RunsConfig.redact})

package/src/console/server/app.ts

@@ -4,7 +4,7 @@
 
 import { resolve } from "node:path";
 import { memorySignalDriver } from "../../drivers/signal-memory.ts";
-import { signal as declareSignal } from "../../elements/signal/declare.ts";
+import { signal } from "../../elements/signal/declare.ts";
 import { createSignalRuntime } from "../../elements/signal/runtime.ts";
 import { oke, type OkeApp } from "../../kernel/index.ts";
 import {
@@ -439,28 +439,22 @@ export async function bindManifestSignalBus(state: ConsoleState): Promise<void>
     now: state.now,
   });
   for (const [name, s] of declared) {
-    if (s.delivery === "live") {
-      runtime.register(
-        declareSignal(name, {
-          delivery: "live",
-          retries: s.retries,
-          deadLetter: s.deadLetter,
-          schema: s.schema,
-          optional: s.optional,
-          ...(s.retention !== undefined ? { retention: s.retention } : {}),
-        }),
-      );
-    } else {
-      runtime.register(
-        declareSignal(name, {
-          delivery: s.delivery,
-          retries: s.retries,
-          deadLetter: s.deadLetter,
-          schema: s.schema,
-          optional: s.optional,
-        }),
-      );
-    }
+    const opts = {
+      retries: s.retries,
+      deadLetter: s.deadLetter,
+      schema: s.schema,
+      optional: s.optional,
+    };
+    const decl =
+      s.delivery === "live"
+        ? signal.live(name, {
+            ...opts,
+            ...(s.retention !== undefined ? { retention: s.retention } : {}),
+          })
+        : s.delivery === "broadcast"
+          ? signal.broadcast(name, opts)
+          : signal.once(name, opts);
+    runtime.register(decl);
   }
   state.signalBus = await runtime.start();
 }

package/src/console/server/bind.ts

@@ -2,6 +2,7 @@
  * Local HTTP bindings that do not touch the global {@link on} registry.
  */
 
+import { applyBoundaryContract, stampBoundaryContract } from "../../kernel/boundary-contract.ts";
 import type { AnyFlowDef } from "../../kernel/flow.ts";
 import type { Binding } from "../../kernel/on.ts";
 import { normalizeTrigger, type HttpTrigger, type Trigger } from "../../kernel/triggers.ts";
@@ -27,5 +28,8 @@ export function bindHttp(trigger: HttpTrigger, flowDef: AnyFlowDef): Binding {
   const list = flowDef.triggers as Trigger[];
   list.push(normalized);
   (flowDef as { $trigger: Trigger }).$trigger = normalized;
+  if (normalized.kind === "http" && normalized.contract !== undefined) {
+    applyBoundaryContract(flowDef, stampBoundaryContract(normalized.contract));
+  }
   return { trigger: normalized, flow: flowDef };
 }

package/src/console/server/console.test.ts

@@ -502,7 +502,7 @@ describe("console boot under oke dev compose env", () => {
     },
   } as const;
 
-  test("docker:true + env:dev hard-fails OKE1008 on undeclared console flows", async () => {
+  test("docker:true + env:dev hard-fails OKE1020 on undeclared console flows", async () => {
     const cwd = await mkdtemp(join(tmpdir(), "oke-console-docker-strict-"));
     const handle = createConsoleApp({
       cwd,
@@ -511,7 +511,7 @@ describe("console boot under oke dev compose env", () => {
     });
     await expect(
       handle.app.boot({ env: "dev", docker: true, config: isolatedDevConfig }),
-    ).rejects.toThrow(/OKE1008/);
+    ).rejects.toThrow(/OKE1020/);
   });
 
   test("docker:false + env:dev boots even when OKE_DOCKER=1 (serveConsole contract)", async () => {

package/src/console/server/flows-invoke.test.ts

@@ -77,17 +77,21 @@ async function bootInvokeHost() {
   resetFlowSeq();
 
   on(
-    http.post("/bookings").gate(member).gate(bookingCreate),
+    http
+      .post("/bookings", {
+        in: z.object({
+          flightId: z.string(),
+          seats: z.number().int().min(1),
+        }),
+        out: z.object({
+          id: z.string(),
+          userId: z.string(),
+          scopes: z.array(z.string()),
+        }),
+      })
+      .gate(member)
+      .gate(bookingCreate),
     flow("bookings.create", {
-      in: z.object({
-        flightId: z.string(),
-        seats: z.number().int().min(1),
-      }),
-      out: z.object({
-        id: z.string(),
-        userId: z.string(),
-        scopes: z.array(z.string()),
-      }),
       do: (input, fx) => ({
         id: `real_${input.flightId}_${input.seats}`,
         userId: fx.auth.userId ?? "missing",
@@ -97,10 +101,13 @@ async function bootInvokeHost() {
   );
 
   on(
-    http.get("/notes/:id").gate(member),
+    http
+      .get("/notes/:id", {
+        in: z.object({ id: z.string() }),
+        out: z.object({ id: z.string(), title: z.string() }),
+      })
+      .gate(member),
     flow("notes.get", {
-      in: z.object({ id: z.string() }),
-      out: z.object({ id: z.string(), title: z.string() }),
       do: (input) => ({ id: input.id, title: `note-${input.id}` }),
     }),
   );
@@ -562,14 +569,17 @@ describe("console flows invoke", () => {
     resetBindings();
     resetFlowSeq();
     on(
-      http.post("/views").gate(member),
+      http
+        .post("/views", {
+          in: z.object({
+            id: z.string(),
+            name: z.string(),
+            ownerEmail: z.string(),
+          }),
+          out: z.object({ id: z.string() }),
+        })
+        .gate(member),
       flow("views.seed", {
-        in: z.object({
-          id: z.string(),
-          name: z.string(),
-          ownerEmail: z.string(),
-        }),
-        out: z.object({ id: z.string() }),
         do: async (input, fx) => {
           await fx.store(db).insert(views).values(input);
           return { id: input.id };
@@ -577,18 +587,21 @@ describe("console flows invoke", () => {
       }),
     );
     on(
-      http.get("/views").gate(member),
+      http
+        .get("/views", {
+          in: z.object({}),
+          out: z.object({
+            items: z.array(
+              z.object({
+                id: z.string(),
+                name: z.string(),
+                ownerEmail: z.string().nullable(),
+              }),
+            ),
+          }),
+        })
+        .gate(member),
       flow("views.list", {
-        in: z.object({}),
-        out: z.object({
-          items: z.array(
-            z.object({
-              id: z.string(),
-              name: z.string(),
-              ownerEmail: z.string().nullable(),
-            }),
-          ),
-        }),
         do: async (_input, fx) => {
           const items = await fx.store(db).select().from(views);
           return {
@@ -696,10 +709,13 @@ describe("console flows invoke", () => {
     resetBindings();
     resetFlowSeq();
     on(
-      http.get("/notes").gate(member),
+      http
+        .get("/notes", {
+          in: z.object({}),
+          out: z.array(z.object({ id: z.string(), title: z.string() })),
+        })
+        .gate(member),
       flow("notes.list", {
-        in: z.object({}),
-        out: z.array(z.object({ id: z.string(), title: z.string() })),
         effects: { reads: ["sql:notes"] },
         do: () => [{ id: "n1", title: "Harbor" }],
       }),