@almadar/evaluator 2.24.0 → 2.25.0

package/dist/index.js

@@ -1,4 +1,4 @@
-import { isSExpr, isBinding, getOperator, getArgs } from '@almadar/core';
+import { isSExpr, isBinding, getOperator, getArgs, OrbitalZodSchema, safeParseOrbitalSchema } from '@almadar/core';
 export { CORE_BINDINGS, ExpressionSchema, SExprSchema, collectBindings, getArgs, getOperator, isBinding, isSExpr, isSExprAtom, isSExprCall, isValidBinding, parseBinding, sexpr, walkSExpr } from '@almadar/core';
 
 // types/expression.ts
@@ -2563,6 +2563,43 @@ function evalLlmCompact(args, evaluate2, ctx) {
   const strategy = args.length > 0 ? evaluate2(args[0], ctx) : void 0;
   return ctx.llm.compact(strategy);
 }
+function isFieldValue(value) {
+  if (value === null) return true;
+  const kind = typeof value;
+  if (kind === "string" || kind === "number" || kind === "boolean") return true;
+  if (value instanceof Date) return true;
+  if (Array.isArray(value)) return value.every((item) => isFieldValue(item));
+  if (kind === "object" && value !== null && typeof value === "object") {
+    return Object.values(value).every((item) => item === void 0 || isFieldValue(item));
+  }
+  return false;
+}
+function isEventPayloadValue(value) {
+  if (value === null || value === void 0) return true;
+  const kind = typeof value;
+  if (kind === "string" || kind === "number" || kind === "boolean") return true;
+  if (value instanceof Date) return true;
+  if (Array.isArray(value)) return value.every((item) => isEventPayloadValue(item));
+  if (kind === "object" && value !== null && typeof value === "object") {
+    return Object.values(value).every((item) => isEventPayloadValue(item));
+  }
+  return false;
+}
+function isSessionHistoryEntry(value) {
+  if (typeof value !== "object" || value === null) return false;
+  return "role" in value && typeof value.role === "string" && "content" in value && typeof value.content === "string" && "timestamp" in value && typeof value.timestamp === "number";
+}
+function isPlanSnapshot(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const statuses = ["proposed", "confirmed", "built", "failed"];
+  return "schemaVersion" in value && value.schemaVersion === 1 && "status" in value && statuses.some((s) => s === value.status) && "builtAt" in value && typeof value.builtAt === "string" && "orbitals" in value && Array.isArray(value.orbitals) && "renames" in value && Array.isArray(value.renames) && "deletedOrbitals" in value && Array.isArray(value.deletedOrbitals);
+}
+function isOrbital(value) {
+  return OrbitalZodSchema.safeParse(value).success;
+}
+function isOrbitalSchemaValue(value) {
+  return safeParseOrbitalSchema(value).success;
+}
 
 // std/workspace.ts
 function evalWorkspaceReadOrbital(args, evaluate2, ctx) {
@@ -2574,6 +2611,9 @@ function evalWorkspaceWriteOrbital(args, evaluate2, ctx) {
   if (!ctx.workspace) return null;
   const name = evaluate2(args[0], ctx);
   const content = evaluate2(args[1], ctx);
+  if (!isOrbital(content)) {
+    throw new Error(`workspace/write-orbital value for "${name}" is not a valid orbital definition`);
+  }
   return ctx.workspace.writeOrbital(name, content);
 }
 function evalWorkspaceReadFile(args, evaluate2, ctx) {
@@ -2603,6 +2643,9 @@ function evalWorkspaceReadSchema(_args, _evaluate, ctx) {
 function evalWorkspaceWriteSchema(args, evaluate2, ctx) {
   if (!ctx.workspace) return null;
   const schema = evaluate2(args[0], ctx);
+  if (!isOrbitalSchemaValue(schema)) {
+    throw new Error("workspace/write-schema value is not a valid orbital schema");
+  }
   return ctx.workspace.writeSchema(schema);
 }
 function evalWorkspaceReadPlan(_args, _evaluate, ctx) {
@@ -2612,6 +2655,9 @@ function evalWorkspaceReadPlan(_args, _evaluate, ctx) {
 function evalWorkspaceWritePlan(args, evaluate2, ctx) {
   if (!ctx.workspace) return null;
   const plan = evaluate2(args[0], ctx);
+  if (!isPlanSnapshot(plan)) {
+    throw new Error("workspace/write-plan value is not a valid plan snapshot (schemaVersion 1 envelope)");
+  }
   return ctx.workspace.writePlan(plan);
 }
 function evalWorkspaceArchiveOrbital(args, evaluate2, ctx) {
@@ -2630,6 +2676,9 @@ function evalSessionWriteSpec(args, evaluate2, ctx) {
   if (!ctx.session) return null;
   const orbitalName = evaluate2(args[0], ctx);
   const spec = evaluate2(args[1], ctx);
+  if (!isOrbital(spec)) {
+    throw new Error(`session/write-spec value for "${orbitalName}" is not a valid orbital definition`);
+  }
   return ctx.session.writeSpec(orbitalName, spec);
 }
 function evalSessionReadMemory(args, evaluate2, ctx) {
@@ -2652,6 +2701,9 @@ function evalSessionAppendHistory(args, evaluate2, ctx) {
   if (!ctx.session) return null;
   const orbitalName = evaluate2(args[0], ctx);
   const entry = evaluate2(args[1], ctx);
+  if (!isSessionHistoryEntry(entry)) {
+    throw new Error(`session/append-history entry for "${orbitalName}" must have role/content/timestamp`);
+  }
   return ctx.session.appendHistory(orbitalName, entry);
 }
 function evalSessionReadErrors(args, evaluate2, ctx) {
@@ -2696,6 +2748,9 @@ function evalTraceEmit(args, evaluate2, ctx) {
   if (!ctx.trace) return;
   const event = evaluate2(args[0], ctx);
   const payload = args.length > 1 ? evaluate2(args[1], ctx) : void 0;
+  if (!isEventPayloadValue(payload)) {
+    throw new Error(`trace/emit payload for "${event}" is not an event-payload value (JSON-like)`);
+  }
   ctx.trace.emit(event, payload);
 }
 function evalTraceLog(args, evaluate2, ctx) {
@@ -2703,6 +2758,9 @@ function evalTraceLog(args, evaluate2, ctx) {
   const message = evaluate2(args[0], ctx);
   const level = args.length > 1 ? evaluate2(args[1], ctx) : void 0;
   const data = args.length > 2 ? evaluate2(args[2], ctx) : void 0;
+  if (!isEventPayloadValue(data)) {
+    throw new Error("trace/log data is not an event-payload value (JSON-like)");
+  }
   ctx.trace.log(message, level, data);
 }
 
@@ -2712,6 +2770,9 @@ function evalIntegrationHttp(args, evaluate2, ctx) {
   const method = evaluate2(args[0], ctx);
   const url = evaluate2(args[1], ctx);
   const body = args.length > 2 ? evaluate2(args[2], ctx) : void 0;
+  if (body !== void 0 && !isFieldValue(body)) {
+    throw new Error(`integration/http body for ${method} ${url} is not a field value (JSON-like)`);
+  }
   const headers = args.length > 3 ? evaluate2(args[3], ctx) : void 0;
   return ctx.integration.http(method, url, body, headers);
 }