r3fresh

Version Tracking

Version Fields

All events include version information for drift detection and traceability:

  • schema_version – Event schema version
  • sdk_version – r3fresh SDK version
  • agent_version – Your agent version
  • policy_version – Your policy version

Configuring Versions

Pass version strings when initializing the ALM instance:

alm = ALM(
    agent_id="my-agent",
    agent_version=__version__,      # Your app version
    policy_version="2.0.0",         # Policy config version
)

Event Shape

Every event has a common shape with timestamps in RFC3339 format:

{
  "event_id": "550e8400-e29b-41d4-a716-446655440000",
  "timestamp": "2026-01-21T12:00:00.123Z",
  "event_type": "tool.request",
  "agent_id": "agent-123",
  "env": "production",
  "run_id": "run-456",
  "schema_version": "1.0",
  "sdk_version": "0.1.0",
  "agent_version": "1.0.0",
  "policy_version": "2.0.0",
  "metadata": {}
}