@neuroverseos/governance 0.2.2 → 0.2.3

package/dist/adapters/openclaw.cjs

@@ -30,24 +30,34 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/adapters/openclaw.ts
 var openclaw_exports = {};
 __export(openclaw_exports, {
-  GovernanceBlockedError: () => GovernanceBlockedError,
+  GovernanceBlockedError: () => GovernanceBlockedError2,
   NeuroVersePlugin: () => NeuroVersePlugin,
   createNeuroVersePlugin: () => createNeuroVersePlugin,
   createNeuroVersePluginFromWorld: () => createNeuroVersePluginFromWorld
 });
 module.exports = __toCommonJS(openclaw_exports);
 
-// src/engine/plan-engine.ts
-function keywordMatch(eventText, step) {
-  const stepText = [
-    step.label,
-    step.description ?? "",
-    ...step.tags ?? []
+// src/engine/text-utils.ts
+function normalizeEventText(event) {
+  return [
+    event.intent,
+    event.tool ?? "",
+    event.scope ?? ""
   ].join(" ").toLowerCase();
-  const keywords = stepText.split(/\s+/).filter((w) => w.length > 3);
+}
+function extractKeywords(text, minLength = 3) {
+  return text.toLowerCase().split(/\s+/).filter((w) => w.length > minLength);
+}
+function matchesAllKeywords(eventText, ruleText) {
+  const keywords = extractKeywords(ruleText);
+  if (keywords.length === 0) return false;
+  return keywords.every((kw) => eventText.includes(kw));
+}
+function matchesKeywordThreshold(eventText, ruleText, threshold = 0.5) {
+  const keywords = extractKeywords(ruleText);
   if (keywords.length === 0) return false;
   const matched = keywords.filter((kw) => eventText.includes(kw));
-  return matched.length >= Math.ceil(keywords.length * 0.5);
+  return matched.length >= Math.ceil(keywords.length * threshold);
 }
 function tokenSimilarity(a, b) {
   const tokensA = new Set(a.toLowerCase().split(/\s+/).filter((w) => w.length > 2));
@@ -60,6 +70,19 @@ function tokenSimilarity(a, b) {
   const union = (/* @__PURE__ */ new Set([...tokensA, ...tokensB])).size;
   return union > 0 ? intersection / union : 0;
 }
+
+// src/engine/plan-engine.ts
+function keywordMatch(eventText, step) {
+  const stepText = [
+    step.label,
+    step.description ?? "",
+    ...step.tags ?? []
+  ].join(" ");
+  return matchesKeywordThreshold(eventText, stepText, 0.5);
+}
+function tokenSimilarity2(a, b) {
+  return tokenSimilarity(a, b);
+}
 function findMatchingStep(eventText, event, steps) {
   const pendingOrActive = steps.filter((s) => s.status === "pending" || s.status === "active");
   if (pendingOrActive.length === 0) {
@@ -78,7 +101,7 @@ function findMatchingStep(eventText, event, steps) {
   let bestScore = 0;
   for (const step of pendingOrActive) {
     const stepText = [step.label, step.description ?? "", ...step.tags ?? []].join(" ");
-    const score = tokenSimilarity(intentText, stepText);
+    const score = tokenSimilarity2(intentText, stepText);
     if (score > bestScore) {
       bestScore = score;
       bestStep = step;
@@ -119,7 +142,7 @@ function checkConstraints(event, eventText, constraints) {
       continue;
     }
     if (constraint.type === "scope" && constraint.trigger) {
-      const keywords = constraint.trigger.split(/\s+/).filter((w) => w.length > 3);
+      const keywords = extractKeywords(constraint.trigger);
       const violated = keywords.length > 0 && keywords.every((kw) => eventText.includes(kw));
       checks.push({
         constraintId: constraint.id,
@@ -200,11 +223,7 @@ function evaluatePlan(event, plan) {
       progress
     };
   }
-  const eventText = [
-    event.intent,
-    event.tool ?? "",
-    event.scope ?? ""
-  ].join(" ").toLowerCase();
+  const eventText = normalizeEventText(event);
   const { matched, closest, closestScore } = findMatchingStep(eventText, event, plan.steps);
   if (!matched) {
     return {
@@ -245,7 +264,7 @@ function evaluatePlan(event, plan) {
   };
 }
 function buildPlanCheck(event, plan, verdict) {
-  const eventText = [event.intent, event.tool ?? "", event.scope ?? ""].join(" ").toLowerCase();
+  const eventText = normalizeEventText(event);
   const { matched, closest, closestScore } = findMatchingStep(eventText, event, plan.steps);
   const { checks: constraintChecks } = checkConstraints(event, eventText, plan.constraints);
   const progress = getPlanProgress(plan);
@@ -351,7 +370,7 @@ function evaluateGuard(event, world, options = {}) {
   const startTime = performance.now();
   const level = options.level ?? "standard";
   const includeTrace = options.trace ?? false;
-  const eventText = (event.intent + " " + (event.tool ?? "") + " " + (event.scope ?? "")).toLowerCase();
+  const eventText = normalizeEventText(event);
   const invariantChecks = [];
   const safetyChecks = [];
   let planCheckResult;
@@ -364,6 +383,43 @@ function evaluateGuard(event, world, options = {}) {
   const guardsMatched = [];
   const rulesMatched = [];
   checkInvariantCoverage(world, invariantChecks);
+  if (event.roleId && options.agentStates) {
+    const agentState = options.agentStates.get(event.roleId);
+    if (agentState && agentState.cooldownRemaining > 0) {
+      decidingLayer = "safety";
+      decidingId = `penalize-cooldown-${event.roleId}`;
+      const verdict = buildVerdict(
+        "PENALIZE",
+        `Agent "${event.roleId}" is frozen for ${agentState.cooldownRemaining} more round(s) due to prior penalty.`,
+        `penalize-cooldown-${event.roleId}`,
+        void 0,
+        world,
+        level,
+        invariantChecks,
+        guardsMatched,
+        rulesMatched,
+        includeTrace ? buildTrace(
+          invariantChecks,
+          safetyChecks,
+          planCheckResult,
+          roleChecks,
+          guardChecks,
+          kernelRuleChecks,
+          levelChecks,
+          decidingLayer,
+          decidingId,
+          startTime
+        ) : void 0
+      );
+      verdict.intentRecord = {
+        originalIntent: event.intent,
+        finalAction: "blocked (agent frozen)",
+        enforcement: "PENALIZE",
+        consequence: { type: "freeze", rounds: agentState.cooldownRemaining, description: "Agent still in cooldown from prior penalty" }
+      };
+      return verdict;
+    }
+  }
   if (options.sessionAllowlist) {
     const key = eventToAllowlistKey(event);
     if (options.sessionAllowlist.has(key)) {
@@ -491,7 +547,16 @@ function evaluateGuard(event, world, options = {}) {
     if (guardVerdict.status !== "ALLOW") {
       decidingLayer = "guard";
       decidingId = guardVerdict.ruleId;
-      return buildVerdict(
+      const intentRecord = {
+        originalIntent: event.intent,
+        finalAction: guardVerdict.status === "MODIFY" ? guardVerdict.modifiedTo ?? "modified" : guardVerdict.status === "PENALIZE" ? "blocked + penalized" : guardVerdict.status === "REWARD" ? event.intent : guardVerdict.status === "NEUTRAL" ? event.intent : guardVerdict.status === "BLOCK" ? "blocked" : "paused",
+        ruleApplied: guardVerdict.ruleId,
+        enforcement: guardVerdict.status,
+        modifiedTo: guardVerdict.modifiedTo,
+        consequence: guardVerdict.consequence,
+        reward: guardVerdict.reward
+      };
+      const verdict = buildVerdict(
         guardVerdict.status,
         guardVerdict.reason,
         guardVerdict.ruleId,
@@ -514,6 +579,10 @@ function evaluateGuard(event, world, options = {}) {
           startTime
         ) : void 0
       );
+      verdict.intentRecord = intentRecord;
+      if (guardVerdict.consequence) verdict.consequence = guardVerdict.consequence;
+      if (guardVerdict.reward) verdict.reward = guardVerdict.reward;
+      return verdict;
     }
   }
   const kernelVerdict = checkKernelRules(eventText, world, kernelRuleChecks, rulesMatched);
@@ -808,6 +877,21 @@ function checkGuards(event, eventText, world, checks, guardsMatched) {
     if (actionMode === "pause") {
       return { status: "PAUSE", reason, ruleId: `guard-${guard.id}` };
     }
+    if (actionMode === "penalize") {
+      const consequence = guard.consequence ? { ...guard.consequence } : { type: "freeze", rounds: 1, description: `Penalized for violating: ${guard.label}` };
+      return { status: "PENALIZE", reason, ruleId: `guard-${guard.id}`, consequence };
+    }
+    if (actionMode === "reward") {
+      const reward = guard.reward ? { ...guard.reward } : { type: "boost_influence", magnitude: 0.1, description: `Rewarded for: ${guard.label}` };
+      return { status: "REWARD", reason, ruleId: `guard-${guard.id}`, reward };
+    }
+    if (actionMode === "modify") {
+      const modifiedTo = guard.modify_to ?? guard.redirect ?? "hold";
+      return { status: "MODIFY", reason: `${reason} \u2192 Modified to: ${modifiedTo}`, ruleId: `guard-${guard.id}`, modifiedTo };
+    }
+    if (actionMode === "neutral") {
+      return { status: "NEUTRAL", reason, ruleId: `guard-${guard.id}` };
+    }
     if (actionMode === "warn" && !warnResult) {
       warnResult = { status: "ALLOW", warning: reason, ruleId: `guard-${guard.id}` };
     }
@@ -917,9 +1001,7 @@ function checkLevelConstraints(event, level, checks) {
   return null;
 }
 function matchesKeywords(eventText, ruleText) {
-  const keywords = ruleText.toLowerCase().split(/\s+/).filter((w) => w.length > 3);
-  if (keywords.length === 0) return false;
-  return keywords.every((kw) => eventText.includes(kw));
+  return matchesAllKeywords(eventText, ruleText);
 }
 function eventToAllowlistKey(event) {
   return `${(event.tool ?? "*").toLowerCase()}::${event.intent.toLowerCase().trim()}`;
@@ -1056,14 +1138,52 @@ async function loadWorld(worldPath) {
   throw new Error(`Cannot load world from: ${worldPath} \u2014 expected a directory or .nv-world.zip`);
 }
 
-// src/adapters/openclaw.ts
+// src/adapters/shared.ts
 var GovernanceBlockedError = class extends Error {
   verdict;
-  action;
-  constructor(verdict, action) {
-    super(`[NeuroVerse] BLOCKED: ${verdict.reason ?? verdict.ruleId ?? "governance rule"}`);
+  constructor(verdict, message) {
+    super(message ?? `[NeuroVerse] BLOCKED: ${verdict.reason ?? verdict.ruleId ?? "governance rule"}`);
     this.name = "GovernanceBlockedError";
     this.verdict = verdict;
+  }
+};
+function trackPlanProgress(event, state, callbacks) {
+  if (!state.activePlan) return;
+  const planVerdict = evaluatePlan(event, state.activePlan);
+  if (planVerdict.matchedStep) {
+    const advResult = advancePlan(state.activePlan, planVerdict.matchedStep);
+    if (advResult.success && advResult.plan) {
+      state.activePlan = advResult.plan;
+      state.engineOptions.plan = state.activePlan;
+    }
+    const progress = getPlanProgress(state.activePlan);
+    callbacks.onPlanProgress?.(progress);
+    if (progress.completed === progress.total) {
+      callbacks.onPlanComplete?.();
+    }
+  }
+}
+function extractScope(args) {
+  if (typeof args.path === "string") return args.path;
+  if (typeof args.file_path === "string") return args.file_path;
+  if (typeof args.filename === "string") return args.filename;
+  if (typeof args.url === "string") return args.url;
+  if (typeof args.command === "string") return args.command;
+  return void 0;
+}
+function buildEngineOptions(options, plan) {
+  return {
+    trace: options.trace ?? false,
+    level: options.level,
+    plan: plan ?? options.plan
+  };
+}
+
+// src/adapters/openclaw.ts
+var GovernanceBlockedError2 = class extends GovernanceBlockedError {
+  action;
+  constructor(verdict, action) {
+    super(verdict);
     this.action = action;
   }
 };
@@ -1073,7 +1193,7 @@ function defaultMapAction(action, direction) {
     tool: action.tool ?? action.type,
     args: action.input,
     direction,
-    scope: typeof action.input?.path === "string" ? action.input.path : typeof action.input?.url === "string" ? action.input.url : void 0
+    scope: action.input ? extractScope(action.input) : void 0
   };
 }
 var NeuroVersePlugin = class {
@@ -1087,11 +1207,7 @@ var NeuroVersePlugin = class {
     this.world = world;
     this.options = options;
     this.activePlan = options.plan;
-    this.engineOptions = {
-      trace: options.trace ?? false,
-      level: options.level,
-      plan: this.activePlan
-    };
+    this.engineOptions = buildEngineOptions(options, this.activePlan);
     this.mapAction = options.mapAction ?? defaultMapAction;
   }
   /**
@@ -1111,22 +1227,10 @@ var NeuroVersePlugin = class {
     };
     this.options.onEvaluate?.(result);
     if (verdict.status === "BLOCK") {
-      throw new GovernanceBlockedError(verdict, action);
+      throw new GovernanceBlockedError2(verdict, action);
     }
-    if (verdict.status === "ALLOW" && this.activePlan) {
-      const planVerdict = evaluatePlan(event, this.activePlan);
-      if (planVerdict.matchedStep) {
-        const advResult = advancePlan(this.activePlan, planVerdict.matchedStep);
-        if (advResult.success && advResult.plan) {
-          this.activePlan = advResult.plan;
-          this.engineOptions.plan = this.activePlan;
-        }
-        const progress = getPlanProgress(this.activePlan);
-        this.options.onPlanProgress?.(progress);
-        if (progress.completed === progress.total) {
-          this.options.onPlanComplete?.();
-        }
-      }
+    if (verdict.status === "ALLOW") {
+      trackPlanProgress(event, this, this.options);
     }
     return result;
   }
@@ -1147,7 +1251,7 @@ var NeuroVersePlugin = class {
     };
     this.options.onEvaluate?.(result);
     if (verdict.status === "BLOCK") {
-      throw new GovernanceBlockedError(verdict, action);
+      throw new GovernanceBlockedError2(verdict, action);
     }
     return result;
   }

package/dist/adapters/openclaw.d.cts

@@ -1,4 +1,5 @@
-import { G as GuardVerdict, W as WorldDefinition, a as GuardEvent, P as PlanDefinition, b as PlanProgress } from '../guard-contract-Cm91Kp4j.cjs';
+import { a as GuardVerdict, b as GuardEngineOptions, P as PlanDefinition, W as WorldDefinition, G as GuardEvent, c as PlanProgress } from '../guard-contract-C9_zKbzd.cjs';
+import { G as GovernanceBlockedError$1 } from '../shared-HpAG90PX.cjs';
 
 /**
  * NeuroVerse Adapter — OpenClaw
@@ -45,8 +46,7 @@ interface NeuroVersePluginOptions {
     /** Called when all plan steps are completed. */
     onPlanComplete?: () => void;
 }
-declare class GovernanceBlockedError extends Error {
-    readonly verdict: GuardVerdict;
+declare class GovernanceBlockedError extends GovernanceBlockedError$1 {
     readonly action: AgentAction;
     constructor(verdict: GuardVerdict, action: AgentAction);
 }
@@ -61,9 +61,9 @@ declare class NeuroVersePlugin {
     readonly name = "neuroverse-governance";
     private world;
     private options;
-    private engineOptions;
+    engineOptions: GuardEngineOptions;
     private mapAction;
-    private activePlan?;
+    activePlan?: PlanDefinition;
     constructor(world: WorldDefinition, options?: NeuroVersePluginOptions);
     /**
      * Evaluate an action before execution.

package/dist/adapters/openclaw.d.ts

@@ -1,4 +1,5 @@
-import { G as GuardVerdict, W as WorldDefinition, a as GuardEvent, P as PlanDefinition, b as PlanProgress } from '../guard-contract-Cm91Kp4j.js';
+import { a as GuardVerdict, b as GuardEngineOptions, P as PlanDefinition, W as WorldDefinition, G as GuardEvent, c as PlanProgress } from '../guard-contract-C9_zKbzd.js';
+import { G as GovernanceBlockedError$1 } from '../shared--Q8wPBVN.js';
 
 /**
  * NeuroVerse Adapter — OpenClaw
@@ -45,8 +46,7 @@ interface NeuroVersePluginOptions {
     /** Called when all plan steps are completed. */
     onPlanComplete?: () => void;
 }
-declare class GovernanceBlockedError extends Error {
-    readonly verdict: GuardVerdict;
+declare class GovernanceBlockedError extends GovernanceBlockedError$1 {
     readonly action: AgentAction;
     constructor(verdict: GuardVerdict, action: AgentAction);
 }
@@ -61,9 +61,9 @@ declare class NeuroVersePlugin {
     readonly name = "neuroverse-governance";
     private world;
     private options;
-    private engineOptions;
+    engineOptions: GuardEngineOptions;
     private mapAction;
-    private activePlan?;
+    activePlan?: PlanDefinition;
     constructor(world: WorldDefinition, options?: NeuroVersePluginOptions);
     /**
      * Evaluate an action before execution.

package/dist/adapters/openclaw.js

@@ -3,10 +3,11 @@ import {
   NeuroVersePlugin,
   createNeuroVersePlugin,
   createNeuroVersePluginFromWorld
-} from "../chunk-SKU3GAPD.js";
-import "../chunk-4JRYGIO7.js";
+} from "../chunk-6BB55YJI.js";
+import "../chunk-5U2MQO5P.js";
+import "../chunk-IZSO75NZ.js";
+import "../chunk-QLPTHTVB.js";
 import "../chunk-JZPQGIKR.js";
-import "../chunk-4QXB6PEO.js";
 import "../chunk-YZFATT7X.js";
 export {
   GovernanceBlockedError,

package/dist/{build-P42YFKQV.js → build-X5MZY4IA.js}

@@ -2,15 +2,15 @@ import {
   DeriveInputError,
   DeriveProviderError,
   deriveWorld
-} from "./chunk-NF5POFCI.js";
+} from "./chunk-ORJ3NOE6.js";
 import {
   DERIVE_EXIT_CODES
 } from "./chunk-Q6O7ZLO2.js";
-import "./chunk-OT6PXH54.js";
 import {
   emitWorldDefinition,
   parseWorldMarkdown
 } from "./chunk-XPDMYECO.js";
+import "./chunk-OT6PXH54.js";
 import "./chunk-7P3S7MAY.js";
 import "./chunk-YZFATT7X.js";
 

package/dist/{chunk-2NICNKOM.js → chunk-4L6OPKMQ.js}

@@ -1,6 +1,6 @@
 import {
   evaluateGuard
-} from "./chunk-4JRYGIO7.js";
+} from "./chunk-IZSO75NZ.js";
 import {
   loadWorld
 } from "./chunk-JZPQGIKR.js";

package/dist/chunk-5U2MQO5P.js

@@ -0,0 +1,57 @@
+import {
+  advancePlan,
+  evaluatePlan,
+  getPlanProgress
+} from "./chunk-QLPTHTVB.js";
+
+// src/adapters/shared.ts
+var GovernanceBlockedError = class extends Error {
+  verdict;
+  constructor(verdict, message) {
+    super(message ?? `[NeuroVerse] BLOCKED: ${verdict.reason ?? verdict.ruleId ?? "governance rule"}`);
+    this.name = "GovernanceBlockedError";
+    this.verdict = verdict;
+  }
+};
+function trackPlanProgress(event, state, callbacks) {
+  if (!state.activePlan) return;
+  const planVerdict = evaluatePlan(event, state.activePlan);
+  if (planVerdict.matchedStep) {
+    const advResult = advancePlan(state.activePlan, planVerdict.matchedStep);
+    if (advResult.success && advResult.plan) {
+      state.activePlan = advResult.plan;
+      state.engineOptions.plan = state.activePlan;
+    }
+    const progress = getPlanProgress(state.activePlan);
+    callbacks.onPlanProgress?.(progress);
+    if (progress.completed === progress.total) {
+      callbacks.onPlanComplete?.();
+    }
+  }
+}
+function extractScope(args) {
+  if (typeof args.path === "string") return args.path;
+  if (typeof args.file_path === "string") return args.file_path;
+  if (typeof args.filename === "string") return args.filename;
+  if (typeof args.url === "string") return args.url;
+  if (typeof args.command === "string") return args.command;
+  return void 0;
+}
+function buildEngineOptions(options, plan) {
+  return {
+    trace: options.trace ?? false,
+    level: options.level,
+    plan: plan ?? options.plan
+  };
+}
+function defaultBlockMessage(verdict) {
+  return `Action blocked by governance policy: ${verdict.reason ?? "rule violation"}. Rule: ${verdict.ruleId ?? "unknown"}.`;
+}
+
+export {
+  GovernanceBlockedError,
+  trackPlanProgress,
+  extractScope,
+  buildEngineOptions,
+  defaultBlockMessage
+};

package/dist/{chunk-SKU3GAPD.js → chunk-6BB55YJI.js}

@@ -1,23 +1,21 @@
+import {
+  GovernanceBlockedError,
+  buildEngineOptions,
+  extractScope,
+  trackPlanProgress
+} from "./chunk-5U2MQO5P.js";
 import {
   evaluateGuard
-} from "./chunk-4JRYGIO7.js";
+} from "./chunk-IZSO75NZ.js";
 import {
   loadWorld
 } from "./chunk-JZPQGIKR.js";
-import {
-  advancePlan,
-  evaluatePlan,
-  getPlanProgress
-} from "./chunk-4QXB6PEO.js";
 
 // src/adapters/openclaw.ts
-var GovernanceBlockedError = class extends Error {
-  verdict;
+var GovernanceBlockedError2 = class extends GovernanceBlockedError {
   action;
   constructor(verdict, action) {
-    super(`[NeuroVerse] BLOCKED: ${verdict.reason ?? verdict.ruleId ?? "governance rule"}`);
-    this.name = "GovernanceBlockedError";
-    this.verdict = verdict;
+    super(verdict);
     this.action = action;
   }
 };
@@ -27,7 +25,7 @@ function defaultMapAction(action, direction) {
     tool: action.tool ?? action.type,
     args: action.input,
     direction,
-    scope: typeof action.input?.path === "string" ? action.input.path : typeof action.input?.url === "string" ? action.input.url : void 0
+    scope: action.input ? extractScope(action.input) : void 0
   };
 }
 var NeuroVersePlugin = class {
@@ -41,11 +39,7 @@ var NeuroVersePlugin = class {
     this.world = world;
     this.options = options;
     this.activePlan = options.plan;
-    this.engineOptions = {
-      trace: options.trace ?? false,
-      level: options.level,
-      plan: this.activePlan
-    };
+    this.engineOptions = buildEngineOptions(options, this.activePlan);
     this.mapAction = options.mapAction ?? defaultMapAction;
   }
   /**
@@ -65,22 +59,10 @@ var NeuroVersePlugin = class {
     };
     this.options.onEvaluate?.(result);
     if (verdict.status === "BLOCK") {
-      throw new GovernanceBlockedError(verdict, action);
+      throw new GovernanceBlockedError2(verdict, action);
     }
-    if (verdict.status === "ALLOW" && this.activePlan) {
-      const planVerdict = evaluatePlan(event, this.activePlan);
-      if (planVerdict.matchedStep) {
-        const advResult = advancePlan(this.activePlan, planVerdict.matchedStep);
-        if (advResult.success && advResult.plan) {
-          this.activePlan = advResult.plan;
-          this.engineOptions.plan = this.activePlan;
-        }
-        const progress = getPlanProgress(this.activePlan);
-        this.options.onPlanProgress?.(progress);
-        if (progress.completed === progress.total) {
-          this.options.onPlanComplete?.();
-        }
-      }
+    if (verdict.status === "ALLOW") {
+      trackPlanProgress(event, this, this.options);
     }
     return result;
   }
@@ -101,7 +83,7 @@ var NeuroVersePlugin = class {
     };
     this.options.onEvaluate?.(result);
     if (verdict.status === "BLOCK") {
-      throw new GovernanceBlockedError(verdict, action);
+      throw new GovernanceBlockedError2(verdict, action);
     }
     return result;
   }
@@ -124,7 +106,7 @@ function createNeuroVersePluginFromWorld(world, options) {
 }
 
 export {
-  GovernanceBlockedError,
+  GovernanceBlockedError2 as GovernanceBlockedError,
   NeuroVersePlugin,
   createNeuroVersePlugin,
   createNeuroVersePluginFromWorld

package/dist/{chunk-KEST3MWO.js → chunk-AF2VX4AL.js}

@@ -1,14 +1,20 @@
 import {
-  evaluateGuard
-} from "./chunk-4JRYGIO7.js";
+  applyConsequence,
+  applyReward,
+  createAgentState,
+  tickAgentStates
+} from "./chunk-D2UCV5AK.js";
 import {
-  loadWorld
-} from "./chunk-JZPQGIKR.js";
+  evaluateGuard
+} from "./chunk-IZSO75NZ.js";
 import {
   advancePlan,
   evaluatePlan,
   getPlanProgress
-} from "./chunk-4QXB6PEO.js";
+} from "./chunk-QLPTHTVB.js";
+import {
+  loadWorld
+} from "./chunk-JZPQGIKR.js";
 
 // src/runtime/session.ts
 async function defaultToolExecutor(name, args) {
@@ -35,7 +41,11 @@ var SessionManager = class {
       actionsEvaluated: 0,
       actionsAllowed: 0,
       actionsBlocked: 0,
-      actionsPaused: 0
+      actionsPaused: 0,
+      actionsModified: 0,
+      actionsPenalized: 0,
+      actionsRewarded: 0,
+      agentStates: /* @__PURE__ */ new Map()
     };
   }
   /**
@@ -57,14 +67,41 @@ var SessionManager = class {
    */
   evaluate(event) {
     this.engineOptions.plan = this.state.plan;
+    this.engineOptions.agentStates = this.state.agentStates;
     const verdict = evaluateGuard(event, this.state.world, this.engineOptions);
     this.state.actionsEvaluated++;
     if (verdict.status === "ALLOW") this.state.actionsAllowed++;
     if (verdict.status === "BLOCK") this.state.actionsBlocked++;
     if (verdict.status === "PAUSE") this.state.actionsPaused++;
+    if (verdict.status === "MODIFY") this.state.actionsModified++;
+    if (verdict.status === "PENALIZE") this.state.actionsPenalized++;
+    if (verdict.status === "REWARD") this.state.actionsRewarded++;
+    if (event.roleId) {
+      let agentState = this.state.agentStates.get(event.roleId) ?? createAgentState(event.roleId);
+      if (verdict.status === "PENALIZE" && verdict.consequence) {
+        agentState = applyConsequence(agentState, verdict.consequence, verdict.ruleId ?? "unknown");
+      }
+      if (verdict.status === "REWARD" && verdict.reward) {
+        agentState = applyReward(agentState, verdict.reward, verdict.ruleId ?? "unknown");
+      }
+      this.state.agentStates.set(event.roleId, agentState);
+    }
     this.config.onVerdict?.(verdict, event);
     return verdict;
   }
+  /**
+   * Advance all agent states by one round.
+   * Call this at the end of each simulation round to decrement cooldowns.
+   */
+  tickRound() {
+    this.state.agentStates = tickAgentStates(this.state.agentStates);
+  }
+  /**
+   * Get the behavior state for a specific agent.
+   */
+  getAgentState(agentId) {
+    return this.state.agentStates.get(agentId);
+  }
   /**
    * Evaluate and execute a tool call.
    * Returns the execution result or block reason.
@@ -83,7 +120,7 @@ var SessionManager = class {
       direction: "input"
     };
     const verdict = this.evaluate(event);
-    if (verdict.status === "BLOCK") {
+    if (verdict.status === "BLOCK" || verdict.status === "PENALIZE") {
       return { allowed: false, verdict };
     }
     if (verdict.status === "PAUSE") {
@@ -269,7 +306,9 @@ async function runInteractiveMode(config, model) {
 `);
       process.stdout.write(`  Actions: ${s.actionsEvaluated} evaluated
 `);
-      process.stdout.write(`  Allowed: ${s.actionsAllowed} | Blocked: ${s.actionsBlocked} | Paused: ${s.actionsPaused}
+      process.stdout.write(`  Allowed: ${s.actionsAllowed} | Blocked: ${s.actionsBlocked} | Modified: ${s.actionsModified} | Paused: ${s.actionsPaused}
+`);
+      process.stdout.write(`  Penalized: ${s.actionsPenalized} | Rewarded: ${s.actionsRewarded}
 `);
       if (s.progress && s.plan) {
         process.stdout.write(`  Plan: ${s.plan.plan_id} \u2014 ${s.progress.completed}/${s.progress.total} (${s.progress.percentage}%)