okengine 0.23.2 → 0.24.0

package/src/release/measure.ts

@@ -54,7 +54,7 @@ export const EXPORT_BUILD_EXTERNALS = [
 ] as const;
 
 /** How a sample is gated. */
-export type BudgetGate = "absolute" | "regression";
+export type BudgetGate = "absolute" | "regression" | "report";
 
 /** Report section headings. */
 const GROUP_HEADINGS: Readonly<Record<BudgetGroup, string>> = {
@@ -239,6 +239,26 @@ export async function measureHttpPingAppBytes(): Promise<HttpPingBudgetSample> {
 /**
  * Gzip size of the kernel edge profile bundle.
  */
+/**
+ * Gzip size of the lazy decision module. Reported, not gated.
+ */
+export async function measureDecisionChunkGzipBytes(): Promise<number> {
+  const entry = `${import.meta.dir}/../kernel/decision-budget-entry.ts`;
+  const result = await Bun.build({
+    entrypoints: [entry],
+    minify: true,
+    target: "bun",
+    format: "esm",
+  });
+  if (!result.success) {
+    throw new Error(`decision chunk build failed:\n${result.logs.map(String).join("\n")}`);
+  }
+  const artifact = result.outputs[0];
+  if (!artifact) throw new Error("decision chunk build produced no output");
+  const raw = await artifact.arrayBuffer();
+  return Bun.gzipSync(new Uint8Array(raw)).byteLength;
+}
+
 export async function measureKernelEdgeGzipBytes(): Promise<number> {
   try {
     return await gzipKernelEdgeInProcess();
@@ -640,13 +660,19 @@ export async function measureAllBudgets(): Promise<BudgetsSnapshot> {
     "ms",
   );
   const coldStartMedianMs = await measureColdStartMedianMs(coldCeiling ?? COLD_START_BUDGET_MS);
-  const [kernelEdgeGzipBytes, clientGzipBytes, consoleInitialGzipBytes, httpPing] =
-    await Promise.all([
-      measureKernelEdgeGzipBytes(),
-      measureClientGzipBytes(),
-      measureConsoleInitialGzipBytes(),
-      measureHttpPingAppBytes(),
-    ]);
+  const [
+    kernelEdgeGzipBytes,
+    clientGzipBytes,
+    consoleInitialGzipBytes,
+    httpPing,
+    decisionChunkGzipBytes,
+  ] = await Promise.all([
+    measureKernelEdgeGzipBytes(),
+    measureClientGzipBytes(),
+    measureConsoleInitialGzipBytes(),
+    measureHttpPingAppBytes(),
+    measureDecisionChunkGzipBytes(),
+  ]);
   const routingP99Ms = measureRoutingP99Ms();
 
   const budgets: BudgetSample[] = [
@@ -660,6 +686,16 @@ export async function measureAllBudgets(): Promise<BudgetsSnapshot> {
       "core",
       previous,
     ),
+    sample(
+      "decisionChunkGzipBytes",
+      "Decision module",
+      decisionChunkGzipBytes,
+      decisionChunkGzipBytes,
+      "bytes",
+      "report",
+      "core",
+      previous,
+    ),
     sample(
       "clientGzipBytes",
       "Client runtime",
@@ -860,6 +896,9 @@ function sample(
   previous?: ReadonlyMap<string, number>,
 ): BudgetSample {
   const rounded = unit === "bytes" ? Math.round(value) : Math.round(value * 1000) / 1000;
+  if (gate === "report") {
+    return { id, label, value: rounded, limit: rounded, unit, gate, group, ok: true };
+  }
   const regressionLimit =
     gate === "absolute" ? absoluteRegressionCeiling(previous?.get(id), limit, unit) : undefined;
   return {

package/src/test/create-test-app.ts

@@ -23,7 +23,13 @@ import {
   type ChannelInbox,
   type ChannelInboxEntry,
 } from "../drivers/index.ts";
-import { createAiRuntime, type AiPromptDecl, type AiRuntime } from "../elements/ai.ts";
+import {
+  createAiRuntime,
+  type AiDecisionDecl,
+  type AiPromptDecl,
+  type AiRuntime,
+} from "../elements/ai.ts";
+import { setDecisionScript, type DecisionScriptAnswer } from "../kernel/fx-decide.ts";
 import { createChannelRuntime, type DeliveryReceipt } from "../elements/channel.ts";
 import { createTestClockRuntime } from "../elements/clock.ts";
 import type { GateDecl } from "../elements/gate.ts";
@@ -154,6 +160,16 @@ export interface TestAi {
    * @param output - JSON-serialisable output
    */
   mock(prompt: AiPromptDecl | string, output: unknown): void;
+  /**
+   * Script one decision. `{ refusal: string }` is the test signal and is not stored.
+   *
+   * @param decision - Decision decl or name
+   * @param answers - Probabilities, or a refusal, per question
+   */
+  decide(
+    decision: AiDecisionDecl | string,
+    answers: Readonly<Record<string, DecisionScriptAnswer>>,
+  ): void;
   /** Accumulated AI cost across asks in this harness. */
   cost(): number;
 }
@@ -461,6 +477,10 @@ export async function createTestApp<App extends OkeApp>(
       cost() {
         return aiCost;
       },
+      decide(decision, answers) {
+        const name = typeof decision === "string" ? decision : decision.name;
+        setDecisionScript(name, answers);
+      },
     },
     effects: {
       of(id) {