okengine 0.2.6 → 0.3.2

package/src/elements/ai/runtime.ts

@@ -6,19 +6,11 @@
  * Agent denials are recorded on the denial ledger — not errors.
  */
 
-import type {
-  AiDriver,
-  AiModelClient,
-} from "../../drivers/ai-types.ts";
+import type { AiDriver, AiModelClient } from "../../drivers/ai-types.ts";
 import type { IndexStore } from "../../drivers/types.ts";
 import type { GatePolicyContext } from "../gate/declare.ts";
 import type { GateRuntime } from "../gate/runtime.ts";
-import type {
-  AiAgentDecl,
-  AiEmbedDecl,
-  AiModelDecl,
-  AiPromptDecl,
-} from "./declare.ts";
+import type { AiAgentDecl, AiEmbedDecl, AiModelDecl, AiPromptDecl } from "./declare.ts";
 import {
   AiSchemaValidationError,
   coerceModelObject,
@@ -37,14 +29,7 @@ export interface AgentDenial {
 
 /** Effect on a tool flow — same vocabulary as Flows / Traces. */
 export interface AgentToolEffect {
-  readonly kind:
-    | "read"
-    | "write"
-    | "emit"
-    | "send"
-    | "ask"
-    | "secret"
-    | "call";
+  readonly kind: "read" | "write" | "emit" | "send" | "ask" | "secret" | "call";
   readonly resource: string;
 }
 
@@ -122,10 +107,7 @@ export interface CreateAiRuntimeOptions {
    * @param name - Flow name
    * @param input - Tool input
    */
-  readonly callFlow?: (
-    name: string,
-    input: unknown,
-  ) => Promise<unknown>;
+  readonly callFlow?: (name: string, input: unknown) => Promise<unknown>;
   /**
    * Resolve gates required for a tool flow.
    *
@@ -186,11 +168,7 @@ export interface AiRuntime {
    * @param input - Prompt input
    * @param opts - via / allowPii
    */
-  ask(
-    prompt: string,
-    input?: unknown,
-    opts?: AiAskOptions,
-  ): Promise<Record<string, unknown>>;
+  ask(prompt: string, input?: unknown, opts?: AiAskOptions): Promise<Record<string, unknown>>;
   /**
    * Run a bounded agent; tool calls that fail gates are denied + recorded.
    *
@@ -215,11 +193,7 @@ export interface AiRuntime {
    * @param id - Document id
    * @param text - Text to embed
    */
-  embed(
-    embed: string,
-    id: string,
-    text: string,
-  ): Promise<void>;
+  embed(embed: string, id: string, text: string): Promise<void>;
 }
 
 /**
@@ -227,9 +201,7 @@ export interface AiRuntime {
  *
  * @param options - Declarations + clients + gates
  */
-export function createAiRuntime(
-  options: CreateAiRuntimeOptions = {},
-): AiRuntime {
+export function createAiRuntime(options: CreateAiRuntimeOptions = {}): AiRuntime {
   const prompts = new Map<string, AiPromptDecl>();
   for (const p of options.prompts ?? []) prompts.set(p.name, p);
   const agents = new Map<string, AiAgentDecl>();
@@ -239,9 +211,7 @@ export function createAiRuntime(
   const models = new Map<string, AiModelDecl>();
   for (const m of options.models ?? []) models.set(m.name, m);
 
-  const clients = new Map<string, AiModelClient>(
-    Object.entries(options.clients ?? {}),
-  );
+  const clients = new Map<string, AiModelClient>(Object.entries(options.clients ?? {}));
   const denials: AgentDenial[] = [];
   const agentRuns: AgentRunRecord[] = [];
   const journal: AiJournalEntry[] = [];
@@ -297,9 +267,7 @@ export function createAiRuntime(
         }
       }
 
-      const via =
-        opts?.via ??
-        (decl.model ? [decl.model] : [...models.keys()].slice(0, 1));
+      const via = opts?.via ?? (decl.model ? [decl.model] : [...models.keys()].slice(0, 1));
       const attempts: AiFallbackAttempt[] = [];
       let lastError: string | undefined;
       let lastSchema: AiSchemaMismatch | undefined;
@@ -314,10 +282,7 @@ export function createAiRuntime(
             messages: [
               {
                 role: "user",
-                content:
-                  typeof input === "string"
-                    ? input
-                    : JSON.stringify(input ?? {}),
+                content: typeof input === "string" ? input : JSON.stringify(input ?? {}),
               },
             ],
             responseFormat: decl.out,
@@ -325,8 +290,7 @@ export function createAiRuntime(
           const attemptCost = result.usage?.cost ?? 0;
           totalCost += attemptCost;
           const latencyMs = Math.max(0, now() - attemptStart);
-          const raw =
-            result.raw !== undefined ? result.raw : result.text;
+          const raw = result.raw !== undefined ? result.raw : result.text;
 
           try {
             const output = decl.out
@@ -409,9 +373,7 @@ export function createAiRuntime(
           at: now(),
         });
       }
-      throw new Error(
-        `ai: all models failed for prompt "${prompt}": ${lastError}`,
-      );
+      throw new Error(`ai: all models failed for prompt "${prompt}": ${lastError}`);
     },
 
     async runAgent(agent, runOpts) {

package/src/elements/ai/schema.ts

@@ -63,9 +63,7 @@ export class AiSchemaValidationError extends Error {
  *
  * @param schema - Declared `out`
  */
-export function isObjectSchema(
-  schema: unknown,
-): schema is {
+export function isObjectSchema(schema: unknown): schema is {
   readonly properties?: Record<string, unknown>;
   readonly required?: readonly string[];
   readonly type?: string;
@@ -114,15 +112,10 @@ export function matchOutSchema(
   if (!isObjectSchema(schema)) return null;
 
   const props = (schema.properties ?? {}) as Record<string, unknown>;
-  const required = Array.isArray(schema.required)
-    ? [...schema.required]
-    : Object.keys(props);
+  const required = Array.isArray(schema.required) ? [...schema.required] : Object.keys(props);
   const keys = new Set(Object.keys(value));
   const missing = required.filter((k) => !keys.has(k));
-  const extra =
-    Object.keys(props).length > 0
-      ? [...keys].filter((k) => !(k in props))
-      : [];
+  const extra = Object.keys(props).length > 0 ? [...keys].filter((k) => !(k in props)) : [];
   const typeMismatches: string[] = [];
   for (const [key, propSchema] of Object.entries(props)) {
     if (!(key in value)) continue;
@@ -140,11 +133,7 @@ export function matchOutSchema(
     }
   }
 
-  if (
-    missing.length === 0 &&
-    extra.length === 0 &&
-    typeMismatches.length === 0
-  ) {
+  if (missing.length === 0 && extra.length === 0 && typeMismatches.length === 0) {
     return null;
   }
   return { missing, extra, typeMismatches };

package/src/elements/ai.test.ts

@@ -9,11 +9,7 @@
  */
 
 import { describe, expect, test } from "bun:test";
-import {
-  createMockAiDriver,
-  memoryIndexDriver,
-  mockAiDriver,
-} from "../drivers/index.ts";
+import { createMockAiDriver, memoryIndexDriver, mockAiDriver } from "../drivers/index.ts";
 import { createFx } from "../kernel/fx.ts";
 import {
   ai,
@@ -43,10 +39,7 @@ describe("ai declaration", () => {
       maxSteps: 6,
       model: smart,
     });
-    expect(agent.tools).toEqual([
-      "bookings.getBooking",
-      "bookings.refundBooking",
-    ]);
+    expect(agent.tools).toEqual(["bookings.getBooking", "bookings.refundBooking"]);
 
     const embed = ai.embed("docs", {
       model: smart,
@@ -70,8 +63,7 @@ describe("agent gate denial is recorded", () => {
     const runtime = createAiRuntime({
       agents: [refund],
       gates,
-      gatesForFlow: (name) =>
-        name === "bookings.refundBooking" ? ["member"] : [],
+      gatesForFlow: (name) => (name === "bookings.refundBooking" ? ["member"] : []),
       callFlow: async (name) => {
         called.push(name);
         return { ok: true };
@@ -95,9 +87,7 @@ describe("agent gate denial is recorded", () => {
     const member = gate.policy("member", ({ auth }) => !!auth.verified);
     const gates = createGateRuntime({ gates: [member] });
     const runtime = createAiRuntime({
-      agents: [
-        ai.agent("support", { tools: ["bookings.getBooking"], maxSteps: 1 }),
-      ],
+      agents: [ai.agent("support", { tools: ["bookings.getBooking"], maxSteps: 1 })],
       gates,
       gatesForFlow: () => ["member"],
       callFlow: async () => ({ booking: "B1" }),
@@ -270,10 +260,7 @@ describe("embeddings into store.index", () => {
       indexes: { kb: index },
     });
     await runtime.embed("docs", "doc-1", "hello world");
-    const hits = await index.search(
-      (await client.embed!({ input: "hello world" })).vectors[0]!,
-      1,
-    );
+    const hits = await index.search((await client.embed!({ input: "hello world" })).vectors[0]!, 1);
     expect(hits[0]?.id).toBe("doc-1");
   });
 });
@@ -300,9 +287,13 @@ describe("model fallback chain", () => {
       clients: { smart: failing, fast: ok },
     });
 
-    const out = await runtime.ask("ticket-triage", { subject: "x" }, {
-      via: ["smart", "fast"],
-    });
+    const out = await runtime.ask(
+      "ticket-triage",
+      { subject: "x" },
+      {
+        via: ["smart", "fast"],
+      },
+    );
     expect(out.urgency).toBe("low");
     const entry = runtime.journal[0]!;
     expect(entry.attempts).toHaveLength(2);
@@ -343,9 +334,7 @@ describe("schema-validation is its own class", () => {
     }
     expect(thrown).toBeInstanceOf(AiSchemaValidationError);
     expect((thrown as AiSchemaValidationError).code).toBe("AiSchemaInvalid");
-    expect((thrown as AiSchemaValidationError).mismatch.missing).toContain(
-      "team",
-    );
+    expect((thrown as AiSchemaValidationError).mismatch.missing).toContain("team");
     expect(runtime.journal[0]!.outcome).toBe("schema_invalid");
     expect(runtime.journal[0]!.outcome).not.toBe("provider_error");
   });

package/src/elements/ai.ts

@@ -41,11 +41,7 @@ export type {
   CreateAiRuntimeOptions,
 } from "./ai/runtime.ts";
 
-export {
-  assertAllowPiiForAsk,
-  AiPiiBuildError,
-  type PiiAskCheckInput,
-} from "./ai/pii.ts";
+export { assertAllowPiiForAsk, AiPiiBuildError, type PiiAskCheckInput } from "./ai/pii.ts";
 
 export {
   runPromptEvals,

package/src/elements/channel/consent.ts

@@ -44,15 +44,8 @@ export interface ConsentStore {
 export function createConsentStore(): ConsentStore {
   const rows: OptOut[] = [];
 
-  function matches(
-    subject: string,
-    medium: ChannelMedium,
-  ): boolean {
-    return rows.some(
-      (r) =>
-        r.subject === subject &&
-        (r.medium === "all" || r.medium === medium),
-    );
+  function matches(subject: string, medium: ChannelMedium): boolean {
+    return rows.some((r) => r.subject === subject && (r.medium === "all" || r.medium === medium));
   }
 
   return {
@@ -60,9 +53,7 @@ export function createConsentStore(): ConsentStore {
       return matches(subject, medium);
     },
     optOut(subject, medium) {
-      if (
-        !rows.some((r) => r.subject === subject && r.medium === medium)
-      ) {
+      if (!rows.some((r) => r.subject === subject && r.medium === medium)) {
         rows.push({ subject, medium, at: Date.now() });
       }
     },

package/src/elements/channel/costs.ts

@@ -42,10 +42,7 @@ export interface FallbackWeeklyCostDelta {
  * @param medium - Channel medium
  * @param costs - Unit cost table
  */
-export function costOf(
-  medium: string,
-  costs: MediumCosts = DEFAULT_MEDIUM_COSTS,
-): number {
+export function costOf(medium: string, costs: MediumCosts = DEFAULT_MEDIUM_COSTS): number {
   return costs[medium as ChannelMedium] ?? costs.any ?? 0.005;
 }
 
@@ -69,9 +66,7 @@ export function fallbackWeeklyCostDelta(
 ): FallbackWeeklyCostDelta {
   const costs = options.costs ?? DEFAULT_MEDIUM_COSTS;
   const end = options.weekEndMs ?? options.now ?? Date.now();
-  const inWeek = receipts.filter(
-    (r) => r.at >= options.weekStartMs && r.at <= end,
-  );
+  const inWeek = receipts.filter((r) => r.at >= options.weekStartMs && r.at <= end);
   const fallbacks = inWeek.filter((r) => r.status === "fallback");
 
   let weeklyDeltaUsd = 0;
@@ -80,8 +75,7 @@ export function fallbackWeeklyCostDelta(
 
   for (const r of fallbacks) {
     const first = r.attempts[0];
-    const winner =
-      [...r.attempts].reverse().find((a) => a.ok) ?? r.attempts.at(-1);
+    const winner = [...r.attempts].reverse().find((a) => a.ok) ?? r.attempts.at(-1);
     if (!first || !winner) continue;
     const primary = mediumFromDriver(first.driverId, r.medium);
     const fb = mediumFromDriver(winner.driverId, r.medium);
@@ -118,12 +112,7 @@ function mediumFromDriver(driverId: string, receiptMedium: string): string {
   if (id.includes("push") || id.includes("fcm") || id.includes("webpush")) {
     return "push";
   }
-  if (
-    id.includes("smtp") ||
-    id.includes("resend") ||
-    id.includes("ses") ||
-    id.includes("email")
-  ) {
+  if (id.includes("smtp") || id.includes("resend") || id.includes("ses") || id.includes("email")) {
     return "email";
   }
   return receiptMedium === "any" ? "email" : receiptMedium;

package/src/elements/channel/declare.ts

@@ -104,10 +104,7 @@ export const channel: ChannelNamespace = {
    * @param name - Template id
    * @param options - Medium / locales / schema
    */
-  template(
-    name: string,
-    options: ChannelTemplateOptions = {},
-  ): ChannelTemplateDecl {
+  template(name: string, options: ChannelTemplateOptions = {}): ChannelTemplateDecl {
     if (!name) throw new TypeError("channel.template: name is required");
     return {
       kind: "template",

package/src/elements/channel/email-auth.ts

@@ -73,10 +73,7 @@ export async function verifyEmailAuth(
   };
 }
 
-async function safeLookup(
-  lookup: DnsTxtLookup,
-  name: string,
-): Promise<readonly string[]> {
+async function safeLookup(lookup: DnsTxtLookup, name: string): Promise<readonly string[]> {
   try {
     return await lookup(name);
   } catch {

package/src/elements/channel/locale.ts

@@ -30,13 +30,7 @@ export interface ResolveLocaleOptions {
  */
 export function isRtlLocale(locale: string): boolean {
   const base = locale.toLowerCase().split("-")[0] ?? locale;
-  return (
-    base === "ar" ||
-    base === "he" ||
-    base === "fa" ||
-    base === "ur" ||
-    base === "yi"
-  );
+  return base === "ar" || base === "he" || base === "fa" || base === "ur" || base === "yi";
 }
 
 /**
@@ -59,9 +53,7 @@ export function parseAcceptLanguage(header: string | undefined): string | undefi
  *
  * @param options - Resolution inputs
  */
-export function resolveLocale(
-  options: ResolveLocaleOptions = {},
-): LocaleResolution {
+export function resolveLocale(options: ResolveLocaleOptions = {}): LocaleResolution {
   const defaultLocale = options.defaultLocale ?? "en";
   const chain: LocaleChainStep[] = [];
 

package/src/elements/channel/mask.ts

@@ -38,9 +38,7 @@ export function maskEmail(email: string): string {
   const name = parts[0] ?? domain;
   const tld = parts.length > 1 ? parts.slice(1).join(".") : "";
   const domainMask =
-    name.length <= 1
-      ? "*"
-      : `${name[0]!}${"*".repeat(Math.min(3, name.length - 1))}`;
+    name.length <= 1 ? "*" : `${name[0]!}${"*".repeat(Math.min(3, name.length - 1))}`;
   return tld ? `${localMask}@${domainMask}.${tld}` : `${localMask}@${domainMask}`;
 }
 

package/src/elements/channel/mime.ts

@@ -6,18 +6,8 @@
  * transports; OKE does not re-implement it.
  */
 
-export type {
-  Attachment,
-  MailOptions,
-  SendResult,
-  Transport,
-  RetryConfig,
-} from "sently";
+export type { Attachment, MailOptions, SendResult, Transport, RetryConfig } from "sently";
 
 export { SentlyError } from "sently/errors";
 export { RetryTransport } from "sently/transports/retry";
-export {
-  FallbackTransport,
-  FallbackError,
-  type FallbackAttempt,
-} from "sently/transports/fallback";
+export { FallbackTransport, FallbackError, type FallbackAttempt } from "sently/transports/fallback";

package/src/elements/channel/outcomes.test.ts

@@ -3,11 +3,7 @@
  */
 
 import { describe, expect, test } from "bun:test";
-import {
-  buildOutcomeRows,
-  formatAttemptChain,
-  VERDICT_BY_STATE,
-} from "./outcomes.ts";
+import { buildOutcomeRows, formatAttemptChain, VERDICT_BY_STATE } from "./outcomes.ts";
 
 describe("delivery outcome taxonomy", () => {
   test("every state carries a verdict", () => {

package/src/elements/channel/outcomes.ts

@@ -18,9 +18,7 @@ export type DeliveryOutcomeState =
 export type DeliveryVerdict = "correct" | "retry" | "suppress" | "review";
 
 /** Verdict for each of the seven states. */
-export const VERDICT_BY_STATE: Readonly<
-  Record<DeliveryOutcomeState, DeliveryVerdict>
-> = {
+export const VERDICT_BY_STATE: Readonly<Record<DeliveryOutcomeState, DeliveryVerdict>> = {
   "suppressed/opted-out": "correct",
   "suppressed/prior-bounce": "correct",
   "blocked/invalid-address": "review",
@@ -34,9 +32,7 @@ export const VERDICT_BY_STATE: Readonly<
  * Consequence weight — higher is worse for sender reputation.
  * Complaints outrank many hard bounces.
  */
-export const CONSEQUENCE_WEIGHT: Readonly<
-  Record<DeliveryOutcomeState, number>
-> = {
+export const CONSEQUENCE_WEIGHT: Readonly<Record<DeliveryOutcomeState, number>> = {
   "suppressed/opted-out": 0,
   "suppressed/prior-bounce": 1,
   "blocked/invalid-address": 3,
@@ -70,9 +66,7 @@ export interface OutcomeRow {
  *
  * @param rows - Taxonomy rows with counts
  */
-export function rankByConsequence(
-  rows: readonly OutcomeRow[],
-): readonly OutcomeRow[] {
+export function rankByConsequence(rows: readonly OutcomeRow[]): readonly OutcomeRow[] {
   return [...rows].sort((a, b) => {
     if (b.weight !== a.weight) return b.weight - a.weight;
     return b.count - a.count;
@@ -101,9 +95,7 @@ export function buildOutcomeRows(
  *
  * @param status - Receipt status
  */
-export function isDeliveryOutcomeState(
-  status: string,
-): status is DeliveryOutcomeState {
+export function isDeliveryOutcomeState(status: string): status is DeliveryOutcomeState {
   return (DELIVERY_OUTCOME_STATES as readonly string[]).includes(status);
 }
 
@@ -120,7 +112,5 @@ export function formatAttemptChain(
   }[],
 ): string {
   if (attempts.length === 0) return "";
-  return attempts
-    .map((a) => `${a.driverId} ${a.ok ? "succeeded" : "failed"}`)
-    .join(" → ");
+  return attempts.map((a) => `${a.driverId} ${a.ok ? "succeeded" : "failed"}`).join(" → ");
 }

package/src/elements/channel/receipts.ts

@@ -13,10 +13,7 @@ export type DeliverySuccessStatus = "sent" | "fallback";
 export type DeliveryLegacyStatus = "failed" | "opted-out";
 
 /** Full receipt status — success paths + seven-state taxonomy. */
-export type DeliveryStatus =
-  | DeliverySuccessStatus
-  | DeliveryLegacyStatus
-  | DeliveryOutcomeState;
+export type DeliveryStatus = DeliverySuccessStatus | DeliveryLegacyStatus | DeliveryOutcomeState;
 
 /** Delivery receipt. */
 export interface DeliveryReceipt {
@@ -103,9 +100,7 @@ export function createReceiptLedger(): ReceiptLedger {
       return undefined;
     },
     updateStatus(messageId, patch) {
-      const idx = rows.findIndex(
-        (r) => r.messageId === messageId || r.id === messageId,
-      );
+      const idx = rows.findIndex((r) => r.messageId === messageId || r.id === messageId);
       if (idx < 0) return undefined;
       const prev = rows[idx]!;
       const next: DeliveryReceipt = {