← All tools

Scheduler + Governor

Schedule tasks with time-based or event-driven triggers. When the Governor is enabled, every tool call passively enriches its awareness — building a live picture of what your agent is doing without explicit fact injection.

Scheduler — 3 tools

  • scheduler.create — Create scheduled tasks from natural language goals. Supports cron-like time schedules and event-driven triggers (e.g. "when I get 10 new leads"). Auto-decomposes event goals into sensor + conditional task pairs
  • scheduler.list — View all active, completed, and pending scheduled tasks with their status, next run time, and execution history
  • scheduler.cancel — Cancel a scheduled task by ID, stopping future executions

Governor — 3 tools

  • governor.enable — Start or resume a Governor session. Auto-provisions at 5 credits/hour
  • governor.status — Dashboard: session uptime, scheduled tasks, credits consumed, token savings. The gauges for your agent
  • governor.disable — End the session, stop billing, clean up percepts

Event-driven sensor pipeline

When you describe an event-based goal like "notify me when I get 10 new leads", the scheduler automatically creates two linked tasks:

Sensor task — polls the configured integration at regular intervals using optimized count queries (e.g. SELECT COUNT() FROM Lead) instead of fetching full records. Asserts delta metrics into the Logic Cell for threshold evaluation.

Conditional task — evaluates preconditions against Logic Cell metrics before executing the action. Reschedules itself if the threshold hasn't been met yet.

Passive enrichment

When a Governor session is active, every tool call automatically asserts facts into the Governor's Prolog knowledge base — tool name, timestamp, success/failure, and cache_ref if produced. The Reflex layer checks triggers after each fact, so event-driven tasks fire automatically based on tool activity.

Use Logic tools for explicit fact management and constraints. The Governor session ties scheduling, enrichment, and symbolic reasoning together.

Sessions auto-provision on first use at 5 credits/hour. No agent_id required.

Example

// Schedule a task to run daily
{ "name": "data-grout@1/scheduler.create@1",
  "arguments": {
    "goal": "send me a summary of new leads every morning",
    "schedule": "daily",
    "tool": "salesforce@v1/soql@v1",
    "tool_args": {
      "query": "SELECT Id, Name, Email FROM Lead WHERE CreatedDate = TODAY"
    }
  }
}

// Event-driven: run when a threshold is met
{ "name": "data-grout@1/scheduler.create@1",
  "arguments": {
    "goal": "notify me when I get 10 new leads"
  }
}

Composes with

Scheduled tasks can execute any tool or workflow — combine with Toolsmith-forged queries, Flow plans, or Prism refractions. Event-driven sensors use Logic for threshold evaluation. All tool calls auto-enrich the Governor when active. Use Warden for verified autonomous decisions.