car-runtime 0.33.0 → 0.35.0

package/index.d.ts

@@ -2288,6 +2288,27 @@ export function checkWorkflowPolicies(
  */
 export function checkPlan(requestJson: string): string;
 
+/**
+ * Deterministic goal-condition evaluation — the Evaluator half of CAR's goal
+ * loop (`docs/proposals/goal-loop.md`), CAR's answer to `/goal`. Decides "am I
+ * done?" over runtime ground truth instead of a model reading its own
+ * transcript.
+ *
+ * `requestJson` is `{ condition, inputs }`. `condition` is a composable
+ * `GoalCondition`: `{ kind: "all_of" | "any_of", conditions: GoalCondition[] }`
+ * or a leaf `{ kind: "tool_receipts_grounded" | "plan_achieved" |
+ * "state_consistent" }` / `{ kind: "state_predicate", key: string, equals: any }`
+ * / `{ kind: "command", id: string, expect_exit: number }` / `{ kind:
+ * "model_judge", id: string }`. `inputs` is the gathered `GoalInputs` `{
+ * receipts_grounded?: boolean, plan_achieved?: boolean, state_consistent?:
+ * boolean, state?: Record<string, any>, command_exits?: Record<string, number>,
+ * model_verdicts?: Record<string, boolean> }`. Returns the `GoalVerdict` JSON
+ * `{ met: boolean, grounded: boolean, reason: string }` — `grounded` is false
+ * iff a met verdict relied on a `model_judge`. A leaf whose input wasn't
+ * gathered fails closed (unmet). Pure.
+ */
+export function evaluateGoal(requestJson: string): string;
+
 /**
  * Intent-grounded verify-before-commit (arXiv 2601.05755 "VIGIL" — defending
  * against tool stream injection). Flags actions that drift outside the user's

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "car-runtime",
-  "version": "0.33.0",
+  "version": "0.35.0",
   "description": "Common Agent Runtime — a deterministic execution layer for AI agents",
   "main": "index.js",
   "types": "index.d.ts",