@almadar/evaluator 2.6.0 → 2.7.0

package/dist/{index-Cf4WAVBs.d.ts → index-CvAGW0K_.d.ts}

@@ -1,4 +1,4 @@
-import { SExpr } from '@almadar/core';
+import { AgentContext, SExpr } from '@almadar/core';
 
 /**
  * Evaluation Context
@@ -8,6 +8,7 @@ import { SExpr } from '@almadar/core';
  *
  * @packageDocumentation
  */
+
 /**
  * User context for @user bindings (role-based UI).
  */
@@ -62,6 +63,8 @@ interface EvaluationContext {
     _probSeed?: {
         state: number;
     };
+    /** Agent context for agent/* operators (memory, LLM, tools, session) */
+    agent?: AgentContext;
     /** Mutate entity fields */
     mutateEntity?: (changes: Record<string, unknown>) => void;
     /** Emit an event */

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { SExpr } 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-Cf4WAVBs.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 evalMap, K as evalMatches, L as evalMax, M as evalMin, N as evalModulo, O as evalMultiply, P as evalNavigate, Q as evalNot, R as evalNotEqual, S as evalNotify, T as evalNth, U as evalOr, V as evalPersist, W as evalRef, X as evalRenderUI, Y as evalRound, Z as evalSet, _ as evalSetDynamic, $ as evalSpawn, a0 as evalSubtract, a1 as evalSum, a2 as evalSwap, a3 as evalWatch, a4 as evalWhen, a5 as resolveBinding } from './index-Cf4WAVBs.js';
+import { E as EvaluationContext } from './index-CvAGW0K_.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 evalMap, K as evalMatches, L as evalMax, M as evalMin, N as evalModulo, O as evalMultiply, P as evalNavigate, Q as evalNot, R as evalNotEqual, S as evalNotify, T as evalNth, U as evalOr, V as evalPersist, W as evalRef, X as evalRenderUI, Y as evalRound, Z as evalSet, _ as evalSetDynamic, $ as evalSpawn, a0 as evalSubtract, a1 as evalSum, a2 as evalSwap, a3 as evalWatch, a4 as evalWhen, a5 as resolveBinding } from './index-CvAGW0K_.js';
 
 /**
  * S-Expression Evaluator

package/dist/index.js

@@ -2436,6 +2436,120 @@ function evalOsDebounce(args, evaluate2, ctx) {
   registerTrigger(ctx, "debounce", { ms, eventType });
 }
 
+// std/agent.ts
+function evalAgentRecall(args, evaluate2, ctx) {
+  if (!ctx.agent) return [];
+  const query = evaluate2(args[0], ctx);
+  const limit = args.length > 1 ? evaluate2(args[1], ctx) : void 0;
+  return ctx.agent.recall(query, limit);
+}
+function evalAgentMemories(args, evaluate2, ctx) {
+  if (!ctx.agent) return [];
+  const category = args.length > 0 ? evaluate2(args[0], ctx) : void 0;
+  return ctx.agent.memories(category);
+}
+function evalAgentMemoryStrength(args, evaluate2, ctx) {
+  if (!ctx.agent) return 0;
+  const id = evaluate2(args[0], ctx);
+  return ctx.agent.memoryStrength(id);
+}
+function evalAgentIsPinned(args, evaluate2, ctx) {
+  if (!ctx.agent) return false;
+  const id = evaluate2(args[0], ctx);
+  return ctx.agent.isPinned(id);
+}
+function evalAgentProvider(_args, _evaluate, ctx) {
+  if (!ctx.agent) return "";
+  return ctx.agent.provider();
+}
+function evalAgentModel(_args, _evaluate, ctx) {
+  if (!ctx.agent) return "";
+  return ctx.agent.model();
+}
+function evalAgentTools(_args, _evaluate, ctx) {
+  if (!ctx.agent) return [];
+  return ctx.agent.tools();
+}
+function evalAgentTokenCount(_args, _evaluate, ctx) {
+  if (!ctx.agent) return 0;
+  return ctx.agent.tokenCount();
+}
+function evalAgentContextUsage(_args, _evaluate, ctx) {
+  if (!ctx.agent) return 0;
+  return ctx.agent.contextUsage();
+}
+function evalAgentSessionId(_args, _evaluate, ctx) {
+  if (!ctx.agent) return "";
+  return ctx.agent.sessionId();
+}
+function evalAgentMemorize(args, evaluate2, ctx) {
+  if (!ctx.agent) return null;
+  const content = evaluate2(args[0], ctx);
+  const category = evaluate2(args[1], ctx);
+  const scope = args.length > 2 ? evaluate2(args[2], ctx) : void 0;
+  return ctx.agent.memorize(content, category, scope);
+}
+function evalAgentForget(args, evaluate2, ctx) {
+  if (!ctx.agent) return null;
+  const id = evaluate2(args[0], ctx);
+  return ctx.agent.forget(id);
+}
+function evalAgentPin(args, evaluate2, ctx) {
+  if (!ctx.agent) return null;
+  const id = evaluate2(args[0], ctx);
+  return ctx.agent.pin(id);
+}
+function evalAgentReinforce(args, evaluate2, ctx) {
+  if (!ctx.agent) return null;
+  const id = evaluate2(args[0], ctx);
+  return ctx.agent.reinforce(id);
+}
+function evalAgentDecay(_args, _evaluate, ctx) {
+  if (!ctx.agent) return null;
+  return ctx.agent.decay();
+}
+function evalAgentGenerate(args, evaluate2, ctx) {
+  if (!ctx.agent) return null;
+  const prompt = evaluate2(args[0], ctx);
+  const options = args.length > 1 ? evaluate2(args[1], ctx) : void 0;
+  return ctx.agent.generate(prompt, options);
+}
+function evalAgentSwitchProvider(args, evaluate2, ctx) {
+  if (!ctx.agent) return null;
+  const provider = evaluate2(args[0], ctx);
+  const model = args.length > 1 ? evaluate2(args[1], ctx) : void 0;
+  ctx.agent.switchProvider(provider, model);
+  return null;
+}
+function evalAgentInvoke(args, evaluate2, ctx) {
+  if (!ctx.agent) return null;
+  const toolName = evaluate2(args[0], ctx);
+  const toolArgs = evaluate2(args[1], ctx);
+  return ctx.agent.invoke(toolName, toolArgs);
+}
+function evalAgentCompact(args, evaluate2, ctx) {
+  if (!ctx.agent) return null;
+  const strategy = args.length > 0 ? evaluate2(args[0], ctx) : void 0;
+  return ctx.agent.compact(strategy);
+}
+function evalAgentFork(args, evaluate2, ctx) {
+  if (!ctx.agent) return null;
+  const label = args.length > 0 ? evaluate2(args[0], ctx) : void 0;
+  return ctx.agent.fork(label);
+}
+function evalAgentLabel(args, evaluate2, ctx) {
+  if (!ctx.agent) return null;
+  const text = evaluate2(args[0], ctx);
+  ctx.agent.label(text);
+  return null;
+}
+function evalAgentSearchCode(args, evaluate2, ctx) {
+  if (!ctx.agent) return null;
+  const query = evaluate2(args[0], ctx);
+  const language = args.length > 1 ? evaluate2(args[1], ctx) : void 0;
+  return ctx.agent.searchCode(query, language);
+}
+
 // SExpressionEvaluator.ts
 var jitCache = /* @__PURE__ */ new Map();
 var MAX_JIT_CACHE_SIZE = 1e3;
@@ -3082,6 +3196,64 @@ var SExpressionEvaluator = class {
       case "os/debounce":
         evalOsDebounce(args, evaluate2, ctx);
         return void 0;
+      // ===============================
+      // Standard Library: agent/*
+      // ===============================
+      // Pure (memory)
+      case "agent/recall":
+        return evalAgentRecall(args, evaluate2, ctx);
+      case "agent/memories":
+        return evalAgentMemories(args, evaluate2, ctx);
+      case "agent/memory-strength":
+        return evalAgentMemoryStrength(args, evaluate2, ctx);
+      case "agent/is-pinned":
+        return evalAgentIsPinned(args, evaluate2, ctx);
+      // Pure (LLM)
+      case "agent/provider":
+        return evalAgentProvider(args, evaluate2, ctx);
+      case "agent/model":
+        return evalAgentModel(args, evaluate2, ctx);
+      // Pure (tools)
+      case "agent/tools":
+        return evalAgentTools(args, evaluate2, ctx);
+      // Pure (context)
+      case "agent/token-count":
+        return evalAgentTokenCount(args, evaluate2, ctx);
+      case "agent/context-usage":
+        return evalAgentContextUsage(args, evaluate2, ctx);
+      // Pure (session)
+      case "agent/session-id":
+        return evalAgentSessionId(args, evaluate2, ctx);
+      // Effects (memory)
+      case "agent/memorize":
+        return evalAgentMemorize(args, evaluate2, ctx);
+      case "agent/forget":
+        return evalAgentForget(args, evaluate2, ctx);
+      case "agent/pin":
+        return evalAgentPin(args, evaluate2, ctx);
+      case "agent/reinforce":
+        return evalAgentReinforce(args, evaluate2, ctx);
+      case "agent/decay":
+        return evalAgentDecay(args, evaluate2, ctx);
+      // Effects (LLM)
+      case "agent/generate":
+        return evalAgentGenerate(args, evaluate2, ctx);
+      case "agent/switch-provider":
+        return evalAgentSwitchProvider(args, evaluate2, ctx);
+      // Effects (tools)
+      case "agent/invoke":
+        return evalAgentInvoke(args, evaluate2, ctx);
+      // Effects (context)
+      case "agent/compact":
+        return evalAgentCompact(args, evaluate2, ctx);
+      // Effects (session)
+      case "agent/fork":
+        return evalAgentFork(args, evaluate2, ctx);
+      case "agent/label":
+        return evalAgentLabel(args, evaluate2, ctx);
+      // Effects (search)
+      case "agent/search-code":
+        return evalAgentSearchCode(args, evaluate2, ctx);
       default:
         console.warn(`Unknown operator: ${op}`);
         return void 0;