Governor Tools

Continuous cognition for MCP agents via passive enrichment and a unified status dashboard.

When enabled, every tool call automatically enriches the Governor’s Prolog fact space — no explicit fact injection needed. The Governor gains awareness from normal tool usage. Use logic.* tools for explicit fact management, scheduler.* tools for recurring tasks, and governor.status to see what happened since your last check.

`governor.enable@1`

Start or resume a Governor session. If one already exists, returns its current status.

Parameters

None required. The session auto-provisions at 5 credits/hour.

Example

{
  "name": "data-grout@1/governor.enable@1",
  "arguments": {}
}

Response:

{
  "status": "enabled",
  "session_id": 42,
  "agent_id": "governor-user-123",
  "billing_rate": "5.0 credits/hour",
  "message": "Governor active — percepts, symbolic reasoning, and scheduling enabled."
}

Cost: 0 credits (session billing is separate at 5 credits/hour).

`governor.status@1`

Dashboard view — the “car gauges” for your agent. Shows session uptime, active percepts, scheduled tasks, credits consumed, and token savings.

Parameters

None required.

Example

{
  "name": "data-grout@1/governor.status@1",
  "arguments": {}
}

Response:

{
  "session": {
    "active": true,
    "session_id": 42,
    "started_at": "2026-03-16T10:00:00Z",
    "uptime_hours": 2.5,
    "credits_consumed": 12.5,
    "billing_rate": 5.0,
    "status": "active"
  },
  "percepts": {
    "count": 0,
    "by_type": {},
    "percepts": []
  },
  "scheduled_tasks": {
    "total": 5,
    "by_status": { "active": 3, "completed": 2 },
    "active_tasks": [
      {
        "id": "abc-123",
        "tool": "quickbooks@1/get-all-invoices@1",
        "schedule": "every day at 9am",
        "status": "active",
        "fire_count": 12,
        "next_fire_at": "2026-03-17T09:00:00Z"
      }
    ]
  },
  "savings": {
    "reflex_queries": 150,
    "tokens_saved": 22500000,
    "estimated_dollars_saved": 337.5
  }
}

Cost: 0 credits.

`governor.disable@1`

End the Governor session. Stops billing, cleans up percepts, and returns a final billing summary.

Parameters

None required.

Example

{
  "name": "data-grout@1/governor.disable@1",
  "arguments": {}
}

Response:

{
  "status": "disabled",
  "total_credits_charged": 12.5,
  "total_hours": 2.5,
  "message": "Governor session ended. Percepts stopped, billing finalized."
}

Cost: 0 credits.

Passive enrichment

When a Governor session is active, the gateway automatically asserts facts after each tool call:

tool_executed(agent_id, tool_name, timestamp, status) — recorded for every tool call
tool_result_cached(agent_id, tool_name, cache_ref, timestamp) — when a cache_ref is produced

After each assertion, the Governor’s Reflex layer checks triggers — so event-driven tasks fire automatically based on tool activity patterns.

Governor and scheduler tools are excluded from enrichment to prevent recursion.

Interaction model

The Governor session ties together several existing tool suites:

Need	Use
Start/stop session, check dashboard	`governor.enable`, `governor.status`, `governor.disable`
Store and query facts	`logic.remember`, `logic.query`, `logic.statement`
Set up rules and triggers	`logic.constrain`
Schedule recurring/event-driven tasks	`scheduler.create`, `scheduler.list`
Passive awareness	Automatic — every tool call enriches the Governor when active

Typical workflow:

Call governor.enable to start a session
Use tools normally — the Governor observes everything
Use scheduler.create to set up recurring or event-driven tasks
Use logic.constrain to define trigger rules
Call governor.status periodically to check what happened
Use logic.query for zero-token symbolic reasoning over accumulated facts
Call governor.disable when done