@loop-engine/observability

1npm install @loop-engine/observability

1interface LoopMetrics {
2  loopId: LoopId
3  period: { from: string; to: string }
4  totalInstances: number
5  openInstances: number
6  closedInstances: number
7  errorInstances: number
8  avgDurationMs: number
9  medianDurationMs: number
10  p95DurationMs: number
11  completionRate: number
12  guardFailureRate: number
13  aiActorRate: number
14  humanActorRate: number
15  avgTransitionCount: number
16}
17 
18declare function computeMetrics(
19  instances: LoopInstance[],
20  history: TransitionRecord[],
21  period: { from: string; to: string }
22): LoopMetrics

1"cmt">// @no-typecheck
2import { computeMetrics } from "@loop-engine/observability"
3 
4const metrics = computeMetrics(instances, history, {
5  from: "2026-03-01T00:00:00.000Z",
6  to: "2026-03-31T23:59:59.999Z"
7})

1declare function buildTimeline(
2  instance: LoopInstance,
3  history: TransitionRecord[]
4): LoopTimeline
5 
6declare function getStateResidency(
7  timeline: LoopTimeline
8): StateResidency[]

1declare function replayLoop(
2  definition: LoopDefinition,
3  history: TransitionRecord[]
4): { valid: boolean; errors: string[] }