@almadar/evaluator 2.36.0 → 2.38.0

package/dist/{index-rPqsFqVO.d.ts → index-dAA7DJ-s.d.ts}

@@ -1,4 +1,4 @@
-import { TraitConfig, AgentContext, LlmContext, WorkspaceContext, SessionContext, MemoryContext, TraceContext, IntegrationContext, SExpr } from '@almadar/core';
+import { UserContext, TraitConfig, AgentContext, LlmContext, WorkspaceContext, SessionContext, MemoryContext, TraceContext, IntegrationContext, SExpr } from '@almadar/core';
 
 /**
  * Evaluation Context
@@ -9,23 +9,6 @@ import { TraitConfig, AgentContext, LlmContext, WorkspaceContext, SessionContext
  * @packageDocumentation
  */
 
-/**
- * User context for @user bindings (role-based UI).
- */
-interface UserContext {
-    /** User's unique ID */
-    id: string;
-    /** User's email */
-    email?: string;
-    /** User's display name */
-    name?: string;
-    /** User's role (for RBAC) */
-    role?: string;
-    /** User's permissions */
-    permissions?: string[];
-    /** Additional custom profile fields */
-    [key: string]: unknown;
-}
 /**
  * Evaluation context for S-expression evaluation.
  * Provides all bindings and effect handlers needed at runtime.
@@ -456,4 +439,4 @@ declare function evalWatch(args: SExpr[], evaluate: Evaluator, ctx: EvaluationCo
  */
 declare function evalAtomic(args: SExpr[], evaluate: Evaluator, ctx: EvaluationContext): unknown;
 
-export { evalSet as $, evalGreaterThanOrEqual as A, evalIf as B, evalIncludes as C, evalIncrement as D, type EvaluationContext as E, evalLast as F, evalLessThan as G, evalLessThanOrEqual as H, evalLet as I, evalList as J, evalMap as K, evalMatches as L, evalMax as M, evalMin as N, evalModulo as O, evalMultiply as P, evalNavigate as Q, evalNot as R, evalNotEqual as S, evalNotify as T, type UserContext as U, evalNth as V, evalOr as W, evalPersist as X, evalRef as Y, evalRenderUI as Z, evalRound as _, createEffectContext as a, evalSetDynamic as a0, evalSpawn as a1, evalSubtract as a2, evalSum as a3, evalSwap as a4, evalWatch as a5, evalWhen as a6, resolveBinding as a7, createMinimalContext as b, createChildContext as c, evalAdd as d, evalAbs as e, evalAnd as f, evalAtomic as g, evalCallService as h, evalCeil as i, evalClamp as j, evalConcat as k, evalCount as l, evalDecrement as m, evalDeref as n, evalDespawn as o, evalDivide as p, evalDo as q, evalEmit as r, evalEmpty as s, evalEqual as t, evalFilter as u, evalFind as v, evalFirst as w, evalFloor as x, evalFn as y, evalGreaterThan as z };
+export { evalSetDynamic as $, evalGreaterThanOrEqual as A, evalIf as B, evalIncludes as C, evalIncrement as D, type EvaluationContext as E, evalLast as F, evalLessThan as G, evalLessThanOrEqual as H, evalLet as I, evalList as J, evalMap as K, evalMatches as L, evalMax as M, evalMin as N, evalModulo as O, evalMultiply as P, evalNavigate as Q, evalNot as R, evalNotEqual as S, evalNotify as T, evalNth as U, evalOr as V, evalPersist as W, evalRef as X, evalRenderUI as Y, evalRound as Z, evalSet as _, createEffectContext as a, evalSpawn as a0, evalSubtract as a1, evalSum as a2, evalSwap as a3, evalWatch as a4, evalWhen as a5, resolveBinding as a6, createMinimalContext as b, createChildContext as c, evalAdd as d, evalAbs as e, evalAnd as f, evalAtomic as g, evalCallService as h, evalCeil as i, evalClamp as j, evalConcat as k, evalCount as l, evalDecrement as m, evalDeref as n, evalDespawn as o, evalDivide as p, evalDo as q, evalEmit as r, evalEmpty as s, evalEqual as t, evalFilter as u, evalFind as v, evalFirst as w, evalFloor as x, evalFn as y, evalGreaterThan as z };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { SExpr, ListenPayloadEvaluator } from '@almadar/core';
-export { CORE_BINDINGS, CoreBinding, Expression, ExpressionSchema, ParsedBinding, SExpr, SExprAtom, SExprSchema, collectBindings, getArgs, getOperator, isBinding, isSExpr, isSExprAtom, isSExprCall, isValidBinding, parseBinding, sexpr, walkSExpr } from '@almadar/core';
-import { E as EvaluationContext } from './index-rPqsFqVO.js';
-export { U as UserContext, c as createChildContext, a as createEffectContext, b as createMinimalContext, e as evalAbs, d as evalAdd, f as evalAnd, g as evalAtomic, h as evalCallService, i as evalCeil, j as evalClamp, k as evalConcat, l as evalCount, m as evalDecrement, n as evalDeref, o as evalDespawn, p as evalDivide, q as evalDo, r as evalEmit, s as evalEmpty, t as evalEqual, u as evalFilter, v as evalFind, w as evalFirst, x as evalFloor, y as evalFn, z as evalGreaterThan, A as evalGreaterThanOrEqual, B as evalIf, C as evalIncludes, D as evalIncrement, F as evalLast, G as evalLessThan, H as evalLessThanOrEqual, I as evalLet, J as evalList, K as evalMap, L as evalMatches, M as evalMax, N as evalMin, O as evalModulo, P as evalMultiply, Q as evalNavigate, R as evalNot, S as evalNotEqual, T as evalNotify, V as evalNth, W as evalOr, X as evalPersist, Y as evalRef, Z as evalRenderUI, _ as evalRound, $ as evalSet, a0 as evalSetDynamic, a1 as evalSpawn, a2 as evalSubtract, a3 as evalSum, a4 as evalSwap, a5 as evalWatch, a6 as evalWhen, a7 as resolveBinding } from './index-rPqsFqVO.js';
+export { CORE_BINDINGS, CoreBinding, Expression, ExpressionSchema, ParsedBinding, SExpr, SExprAtom, SExprSchema, UserContext, collectBindings, getArgs, getOperator, isBinding, isSExpr, isSExprAtom, isSExprCall, isValidBinding, parseBinding, sexpr, walkSExpr } from '@almadar/core';
+import { E as EvaluationContext } from './index-dAA7DJ-s.js';
+export { c as createChildContext, a as createEffectContext, b as createMinimalContext, e as evalAbs, d as evalAdd, f as evalAnd, g as evalAtomic, h as evalCallService, i as evalCeil, j as evalClamp, k as evalConcat, l as evalCount, m as evalDecrement, n as evalDeref, o as evalDespawn, p as evalDivide, q as evalDo, r as evalEmit, s as evalEmpty, t as evalEqual, u as evalFilter, v as evalFind, w as evalFirst, x as evalFloor, y as evalFn, z as evalGreaterThan, A as evalGreaterThanOrEqual, B as evalIf, C as evalIncludes, D as evalIncrement, F as evalLast, G as evalLessThan, H as evalLessThanOrEqual, I as evalLet, J as evalList, K as evalMap, L as evalMatches, M as evalMax, N as evalMin, O as evalModulo, P as evalMultiply, Q as evalNavigate, R as evalNot, S as evalNotEqual, T as evalNotify, U as evalNth, V as evalOr, W as evalPersist, X as evalRef, Y as evalRenderUI, Z as evalRound, _ as evalSet, $ as evalSetDynamic, a0 as evalSpawn, a1 as evalSubtract, a2 as evalSum, a3 as evalSwap, a4 as evalWatch, a5 as evalWhen, a6 as resolveBinding } from './index-dAA7DJ-s.js';
 
 /**
  * S-Expression Evaluator

package/dist/index.js

@@ -1,4 +1,4 @@
-import { isSExpr, isBinding, getOperator, getArgs, isFieldValue, isEventPayloadValue, isSessionHistoryEntry, isPlanSnapshot, OrbitalZodSchema, safeParseOrbitalSchema } from '@almadar/core';
+import { isSExpr, isBinding, getOperator, getArgs, isTensorValue, describeTensorMismatch, contractFieldName, validateContract, isFieldValue, isEventPayloadValue, isSessionHistoryEntry, isPlanSnapshot, tensorLastDimSize, mapTensorLastDim, OrbitalZodSchema, safeParseOrbitalSchema } from '@almadar/core';
 export { CORE_BINDINGS, ExpressionSchema, SExprSchema, collectBindings, getArgs, getOperator, isBinding, isSExpr, isSExprAtom, isSExprCall, isValidBinding, parseBinding, sexpr, walkSExpr } from '@almadar/core';
 import { assertOperatorArity } from '@almadar/std/registry';
 
@@ -2587,95 +2587,21 @@ function evalOsDebounce(args, evaluate2, ctx) {
   const eventType = evaluate2(args[1], ctx);
   registerTrigger(ctx, "debounce", { ms, eventType });
 }
-
-// std/contract.ts
-function fieldName(f) {
-  return typeof f === "string" ? f : f.name;
-}
-function isTensorValue(v) {
-  if (typeof v === "number") return true;
-  return Array.isArray(v) && v.every(isTensorValue);
-}
-function describeType(v) {
-  if (v === null) return "null";
-  if (Array.isArray(v)) return "array containing non-numeric values";
-  return typeof v;
-}
-function tensorShape(t) {
-  if (typeof t === "number") return [];
-  if (t.length === 0) return [0];
-  const first = t[0];
-  if (typeof first === "number") return [t.length];
-  return [t.length, ...tensorShape(first)];
-}
-function lastDimSize(t) {
-  const shape = tensorShape(t);
-  return shape.length === 0 ? 0 : shape[shape.length - 1];
-}
-function arraysEqual(a, b) {
-  return a.length === b.length && a.every((v, i) => v === b[i]);
-}
-function gatherLastDim(t, dim) {
-  if (typeof t === "number") return [];
-  if (t.length === 0) return [];
-  if (typeof t[0] === "number") return [t[dim]];
-  const out = [];
-  for (const sub of t) out.push(...gatherLastDim(sub, dim));
-  return out;
-}
-function mapLastDim(t, dim, fn) {
-  if (typeof t === "number") return t;
-  if (t.length === 0) return t;
-  if (typeof t[0] === "number") {
-    const copy = [...t];
-    copy[dim] = fn(copy[dim]);
-    return copy;
-  }
-  return t.map((sub) => mapLastDim(sub, dim, fn));
-}
-function validateContract(tensor, contract) {
-  if (!isTensorValue(tensor)) {
-    return {
-      valid: false,
-      violations: [{ type: "not_a_tensor", actualType: describeType(tensor) }]
-    };
-  }
-  const violations = [];
-  const shape = tensorShape(tensor);
-  if (contract.shape && !arraysEqual(shape, contract.shape)) {
-    violations.push({ type: "shape_mismatch", expected: contract.shape, actual: shape });
-  }
-  const ranges = contract.ranges ?? {};
-  const size = lastDimSize(tensor);
-  for (const [dimStr, bounds] of Object.entries(ranges)) {
-    const dim = Number(dimStr);
-    if (dim >= size) continue;
-    const vals = gatherLastDim(tensor, dim);
-    const min = bounds.min ?? -Infinity;
-    const max = bounds.max ?? Infinity;
-    const actualMin = Math.min(...vals);
-    const actualMax = Math.max(...vals);
-    if (actualMin < min || actualMax > max) {
-      violations.push({ type: "range_violation", dim, min, max, actualMin, actualMax });
-    }
-  }
-  return { valid: violations.length === 0, violations };
-}
 function clampContract(tensor, contract) {
   if (!isTensorValue(tensor)) {
     throw new Error(
-      `contract/clamp-output: expected a tensor (a number, or nested arrays of numbers), received ${describeType(tensor)}. Validate with contract/validate-output before clamping.`
+      `contract/clamp-output: expected a tensor (a number, or nested arrays of numbers), received ${describeTensorMismatch(tensor)}. Validate with contract/validate-output before clamping.`
     );
   }
   const ranges = contract.ranges ?? {};
-  const size = lastDimSize(tensor);
+  const size = tensorLastDimSize(tensor);
   let result = tensor;
   for (const [dimStr, bounds] of Object.entries(ranges)) {
     const dim = Number(dimStr);
     if (dim >= size) continue;
     const min = bounds.min ?? -Infinity;
     const max = bounds.max ?? Infinity;
-    result = mapLastDim(result, dim, (v) => Math.min(Math.max(v, min), max));
+    result = mapTensorLastDim(result, dim, (v) => Math.min(Math.max(v, min), max));
   }
   return result;
 }
@@ -2702,7 +2628,7 @@ function evalContractEntityToTensor(args, evaluate2, ctx) {
   const contract = evaluate2(args[1], ctx);
   const fields = contract.fields ?? [];
   return fields.map((f) => {
-    const val = entity[fieldName(f)];
+    const val = entity[contractFieldName(f)];
     return typeof val === "number" ? val : 0;
   });
 }
@@ -2710,7 +2636,7 @@ function evalContractTensorToPayload(args, evaluate2, ctx) {
   const tensor = evaluate2(args[0], ctx);
   if (!isTensorValue(tensor)) {
     throw new Error(
-      `contract/tensor-to-payload: expected a tensor (a number, or nested arrays of numbers), received ${describeType(tensor)}.`
+      `contract/tensor-to-payload: expected a tensor (a number, or nested arrays of numbers), received ${describeTensorMismatch(tensor)}.`
     );
   }
   const contract = evaluate2(args[1], ctx);
@@ -2718,18 +2644,18 @@ function evalContractTensorToPayload(args, evaluate2, ctx) {
   const values = Array.isArray(tensor) ? tensor : [tensor];
   const result = {};
   fields.forEach((f, i) => {
-    if (i < values.length) result[fieldName(f)] = values[i];
+    if (i < values.length) result[contractFieldName(f)] = values[i];
   });
   return result;
 }
 
 // std/graph.ts
-function tensorShape2(t) {
+function tensorShape(t) {
   if (typeof t === "number") return [];
   if (t.length === 0) return [0];
   const first = t[0];
   if (typeof first === "number") return [t.length];
-  return [t.length, ...tensorShape2(first)];
+  return [t.length, ...tensorShape(first)];
 }
 function numNodes(g) {
   return g.x.length;
@@ -2789,7 +2715,7 @@ function evalGraphFromAdjacency(args, evaluate2, ctx) {
 function evalGraphFromEdgeList(args, evaluate2, ctx) {
   const edges = evaluate2(args[0], ctx);
   const features = evaluate2(args[1], ctx);
-  const shape = tensorShape2(edges);
+  const shape = tensorShape(edges);
   let edgeIndex;
   if (shape.length === 2 && shape[1] === 2) {
     const rows = edges;
@@ -2915,15 +2841,15 @@ function shuffleInPlace(arr, ctx) {
     arr[j] = tmp;
   }
 }
-function tensorShape3(t) {
+function tensorShape2(t) {
   if (typeof t === "number") return [];
   if (t.length === 0) return [0];
   const first = t[0];
   if (typeof first === "number") return [t.length];
-  return [t.length, ...tensorShape3(first)];
+  return [t.length, ...tensorShape2(first)];
 }
 function rank(t) {
-  return tensorShape3(t).length;
+  return tensorShape2(t).length;
 }
 function sampleMean(vals) {
   return vals.reduce((s, v) => s + v, 0) / vals.length;
@@ -3055,7 +2981,7 @@ function evalDataPad(args, evaluate2, ctx) {
   const data = evaluate2(args[0], ctx);
   const config = evaluate2(args[1], ctx);
   const currentLen = (() => {
-    const shape = tensorShape3(data);
+    const shape = tensorShape2(data);
     return shape.length === 0 ? 0 : shape[shape.length - 1];
   })();
   const targetLen = config.length ?? config.targetLength ?? currentLen;