@herjarsa/omo-meta-governor 0.1.0 → 0.4.0

package/README.md

@@ -38,6 +38,55 @@ After every tool call, MetaGovernor:
 
 See [docs/guide/meta-governor.md](docs/guide/meta-governor.md) for full docs.
 
+## Intervention (v0.3.0)
+
+MetaGovernor can inject its decisions into the active agent's context
+so the agent is aware of governance warnings, escalations, or stop signals.
+
+### Modes
+
+| Mode | Mechanism | Effect |
+|------|-----------|--------|
+| `silent` | (none) | Decision is logged only — no injection |
+| `message` | `experimental.chat.messages.transform` | Injects a synthetic user message visible to the LLM |
+| `system` | `experimental.chat.system.transform` | Appends guidance to the system prompt |
+
+### Configuration
+
+```jsonc
+{
+  "meta_governor": {
+    "enabled": true,
+    "intervention": {
+      "mode": "message",
+      "includeDecisionHistory": true,
+      "maxHistoryMessages": 5,
+      "minActionForMessage": "warn"
+    }
+  }
+}
+
+```
+
+| Field | Default | Description |
+|-------|---------|-------------|
+| `mode` | `"silent"` | How to inject: `"silent"`, `"message"`, or `"system"` |
+| `includeDecisionHistory` | `true` | Whether to include recent decision history |
+| `maxHistoryMessages` | `5` | Max history entries when includeDecisionHistory is true |
+| `minActionForMessage` | `"warn"` | Minimum action: `"warn"` (all non-continue), `"escalate"`, or `"stop"` |
+
+### How it works
+
+1. After every tool call, MetaGovernor runs the orchestrator pipeline.
+2. If the decision is non-continue and meets `minActionForMessage`, it is
+   stored in an in-memory decision store keyed by session ID.
+3. When the next LLM call starts, the appropriate transform hook fires:
+   - `message` mode: a synthetic `UserMessage` with `synthetic: true` flag
+     is prepended to the message list.
+   - `system` mode: the decision message is appended to the system prompt.
+4. The decision is removed from the store after injection (one-shot).
+
+
 ## License
 
 MIT

package/dist/config.d.ts

@@ -1,4 +1,4 @@
-import type { OrchestratorConfig } from "./types";
+import type { ModelOverrideConfig, OrchestratorConfig } from "./types";
 /**
  * MetaGovernor config schema exposed to users.
  * This is a Zod-free config interface since Zod parsing is optional
@@ -38,6 +38,15 @@ export interface MetaGovernorPluginConfig {
         saveDecisions?: boolean;
         saveLessons?: boolean;
     };
+    /** Model override for MetaGovernor internal LLM usage. */
+    modelOverride?: ModelOverrideConfig;
+    /** Intervention config for visible decision injection. */
+    intervention?: {
+        mode?: "silent" | "message" | "system";
+        includeDecisionHistory?: boolean;
+        maxHistoryMessages?: number;
+        minActionForMessage?: "warn" | "escalate" | "stop";
+    };
 }
 /**
  * Project the full MetaGovernorPluginConfig into OrchestratorConfig.

package/dist/decision-store.d.ts

@@ -0,0 +1,36 @@
+/**
+ * MetaGovernor decision store — in-memory Map for intervention feature.
+ *
+ * Stores decisions produced by tool.execute.after so they can be
+ * consumed by experimental.chat.messages.transform and
+ * experimental.chat.system.transform hooks.
+ *
+ * The store is keyed by sessionID. For hooks that receive a sessionID
+ * (system.transform), use takeDecision(sessionID). For hooks that
+ * receive no sessionID (messages.transform), use takeAnyDecision().
+ */
+import type { DecisionHandlerOutput } from "./types";
+/**
+ * Store a decision for a session.
+ * Overwrites any previous pending decision for the same session.
+ */
+export declare function storeDecision(sessionID: string, decision: DecisionHandlerOutput): void;
+/**
+ * Take (retrieve and remove) the pending decision for a session.
+ * Returns undefined if no decision is pending.
+ */
+export declare function takeDecision(sessionID: string): DecisionHandlerOutput | undefined;
+/**
+ * Check whether a session has a pending decision without consuming it.
+ */
+export declare function hasDecision(sessionID: string): boolean;
+/**
+ * Take any pending decision across all sessions.
+ * Useful for hooks that do not receive a sessionID.
+ * Returns the first pending decision found, or undefined if none.
+ */
+export declare function takeAnyDecision(): DecisionHandlerOutput | undefined;
+/**
+ * Clear all stored decisions. Useful in tests or when a session ends.
+ */
+export declare function clearAll(): void;

package/dist/index.d.ts

@@ -29,4 +29,5 @@ export { handleDecision, defaultDecisionHandlerConfig, trimHistory, countConsecu
 export { observeAndLearn, defaultClosedLoopConfig } from "./closed-loop-learning";
 export { aggregateRead } from "./memory-aggregator";
 export { recordRecovery, type RecoveryOutcome } from "./post-repair-recorder";
-export type { Decision, DecisionContext, DecisionHandlerConfig, DecisionHandlerInput, DecisionHandlerOutput, Deviation, Evidence, EvidenceContribution, LearnFromOutcomeInput, LearnFromOutcomeOutput, MemoryRead, MemoryBackends, AgentmemoryWriteBackend, MetaGovernorInput, MetaGovernorOutput, OrchestratorConfig, ScoringConfig, ScoringResult, SlotMemory, TokenPredictorConfig, TokenPredictorInput, TokenPredictorOutput, ClosedLoopConfig, } from "./types";
+export { storeDecision, takeDecision, hasDecision, takeAnyDecision, clearAll, } from "./decision-store";
+export type { Decision, DecisionContext, DecisionHandlerConfig, DecisionHandlerInput, DecisionHandlerOutput, Deviation, Evidence, EvidenceContribution, InterventionConfig, InterventionMode, LearnFromOutcomeInput, LearnFromOutcomeOutput, MemoryRead, MemoryBackends, AgentmemoryWriteBackend, MetaGovernorInput, MetaGovernorOutput, OrchestratorConfig, ScoringConfig, ScoringResult, SlotMemory, TokenPredictorConfig, TokenPredictorInput, TokenPredictorOutput, ClosedLoopConfig, } from "./types";