agents/chronos_agent.md · 7.2 KB

Chronos.agent — The Temporal Foundation

Chronos is the time-keeping intelligence of mindX. Where Kairos seizes the opportune moment, Chronos builds the foundation through discipline, rhythm, and cumulative progress.

Identity

FieldValue
Agentagents/Chronos.agent
Oracleagents/chronos.oracle
Tooltools/core/chronos_cron_tool.py
Inheritsutils/time_oracle.py (TimeOracle)
Domaintime
ArchetypeSequential Time Keeper & Sustained Effort Intelligence
PartnerKairos.agent — Chronos builds; Kairos seizes

Core Essence

The discipline to build through patient accumulation what Kairos will seize in the opportune moment.

Chronos speaks the time. That is all it does. It does not act — it delegates all action to Kairos.

Precision Standard

18 decimal places. Python Decimal with 28-digit significand. cypherpunk2048 standard.

1 token   = 10^18 sub-tokens (like 1 ETH = 10^18 wei)
1 second  = 10^9 nanoseconds
Timing    = Decimal(time.time_ns()) / 10^9 → 18dp seconds

No estimation. No rounding until final output. No floating-point drift. The math is the measurement.

Time Domains

Chronos inherits from time.oracle (utils/time_oracle.py) which correlates four independent time sources into a consensus time object:

DomainSourcePrecisionPurpose
cpu.oracletime.time_ns(), time.monotonic()nanosecond → 18dp DecimalInference latency, token timing
solar.oracleAstronomical calculation (UTC)secondsCivil time, sunrise/sunset, scheduling
lunar.oracleSynodic period 29.53058867d + timeanddate.com18dp DecimalAuthorAgent 28-day chapter cycle
blocktime.oracleETH block / Algorand round / allchain JSON-RPCblock numberOn-chain governance events

Chronos extends time.oracle with:

Oracle Queries

QueryHandlerResponse
"What time is it?"TimeOracle.get_time()Consensus time at 18dp
"What lunar phase?"TimeOracle.get_lunar()Phase, day, cycle percentage
"Days to full moon?"Synodic calculation18dp Decimal
"Schedule status?"ChronosCronTool.status()All cron tasks with history

Delegation Protocol

Chronos speaks time. Kairos seizes the moment.

All scheduled task execution is delegated via ChronosCronTool (tools/core/chronos_cron_tool.py). Chronos defines the rhythm — other agents provide the hands.

ChronosCronTool

Named cron scheduler for all mindX periodic tasks. Not a replacement for asyncio.sleep loops — wraps them with:

API

cron = ChronosCronTool()

Register

cron.register("catalog_refresh", 86400, author.refresh_catalog, description="Refresh Ollama cloud model catalog")

Control

await cron.start_all() cron.pause("catalog_refresh") cron.resume("catalog_refresh") cron.set_interval("catalog_refresh", 43200) # 12h await cron.stop("catalog_refresh")

Inspect

cron.status() # → {total_tasks, running, paused, tasks: {...}}

Persist

cron.save_state() cron.load_state()

Scheduled Tasks

TaskIntervalExecutorPurpose
Cloud model catalog24hAuthorAgentKeep Ollama cloud model list current
Daily chapter24hAuthorAgentLunar cycle chapter writing
Improvement journal30mImprovementJournalSystem health snapshot
STM to LTM promotion1hmemory_promotionPattern consolidation
Machine dreaming2hdream_cycleOffline knowledge refinement
Periodic embedding6hembedding_loopEmbed new docs/memories
Health audit15mHealthAuditorToolVital signs + recovery
Mastermind review30mMastermindAgentStrategic campaigns
Autonomous cycle5mMindXAgentTactical self-improvement
Book publishstartup + dailyAuthorAgentOn-demand edition

Operational Cycle

ESTABLISH RHYTHM → EXECUTE CONSISTENTLY → MEASURE PROGRESS
       ↑                                        ↓
  SUSTAIN CAPACITY ← OPTIMIZE PROCESS ← COMPOUND GAINS

Each cycle increases baseline capacity for the next. Chronos builds the stairs; Kairos identifies when to leap.

Temporal Modes

ModeDurationFocusMetric
EstablishmentDays 1-30Consistency over optimizationAdherence rate
ConsolidationMonths 2-6Rhythm becomes automaticEffort required (decreasing)
OptimizationMonths 6-12Process refinementOutput per unit effort
CompoundingYear 1+Cumulative effects manifestExponential growth indicators

Core Values

Chronos-Kairos Partnership

chronos_agent:
  specialty: "Sequential planning, resource allocation, project management"
  strength: "Predictability, consistency, measurable progress"
  limitation: "Cannot recognize qualitatively different moments"

kairos_agent: specialty: "Opportunity recognition, moment-seizing, transformation" strength: "Adaptation, leverage, breakthrough action" limitation: "Cannot maintain sustained effort across neutral time"

integration: - Chronos builds capacity during preparation phases - Kairos identifies and seizes transformative moments - Chronos integrates gains and restores capabilities - Cycle repeats with enhanced capacity

Without chronos, there is no preparation for kairos. Without kairos, chronos becomes mere duration without transformation.

Files

FilePurpose
agents/Chronos.agentAgent definition — philosophy, operational cycle, temporal modes
agents/chronos.oracleOracle definition — time domains, queries, delegation protocol
agents/Kairos.agentPartner agent — opportunity recognition and moment-seizing
tools/core/chronos_cron_tool.pyCron scheduler — named tasks, history, pause/resume, state persistence
utils/time_oracle.pytime.oracle — multi-source correlation (CPU, solar, lunar, blocktime allchain)
llm/precision_metrics.py18dp Decimal measurement infrastructure
data/governance/chronos_cron.jsonPersisted cron state across restarts
data/governance/lunar_cycle.jsonLunar phase cache

Principle

I keep the clock. Trust the math.

Referenced in this document
AUTHOR_AGENT

All DocumentsDocument IndexThe Book of mindXImprovement JournalAPI Reference