@loop-engine/observability 0.1.0 → 0.1.2

package/LICENSE

@@ -1,21 +1,203 @@
-MIT License
-
-Copyright (c) Loop Engine Contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+Copyright 2026 Better Data, Inc.
+
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+"License" shall mean the terms and conditions for use, reproduction,
+and distribution as defined by Sections 1 through 9 of this document.
+
+"Licensor" shall mean the copyright owner or entity authorized by
+the copyright owner that is granting the License.
+
+"Legal Entity" shall mean the union of the acting entity and all
+other entities that control, are controlled by, or are under common
+control with that entity. For the purposes of this definition,
+"control" means (i) the power, direct or indirect, to cause the
+direction or management of such entity, whether by contract or
+otherwise, or (ii) ownership of fifty percent (50%) or more of the
+outstanding shares, or (iii) beneficial ownership of such entity.
+
+"You" (or "Your") shall mean an individual or Legal Entity
+exercising permissions granted by this License.
+
+"Source" form shall mean the preferred form for making modifications,
+including but not limited to software source code, documentation
+source, and configuration files.
+
+"Object" form shall mean any form resulting from mechanical
+transformation or translation of a Source form, including but
+not limited to compiled object code, generated documentation,
+and conversions to other media types.
+
+"Work" shall mean the work of authorship, whether in Source or
+Object form, made available under the License, as indicated by a
+copyright notice that is included in or attached to the work
+(an example is provided in the Appendix below).
+
+"Derivative Works" shall mean any work, whether in Source or Object
+form, that is based on (or derived from) the Work and for which the
+editorial revisions, annotations, elaborations, or other modifications
+represent, as a whole, an original work of authorship. For the purposes
+of this License, Derivative Works shall not include works that remain
+separable from, or merely link (or bind by name) to the interfaces of,
+the Work and Derivative Works thereof.
+
+"Contribution" shall mean any work of authorship, including
+the original version of the Work and any modifications or additions
+to that Work or Derivative Works thereof, that is intentionally
+submitted to Licensor for inclusion in the Work by the copyright owner
+or by an individual or Legal Entity authorized to submit on behalf of
+the copyright owner. For the purposes of this definition, "submitted"
+means any form of electronic, verbal, or written communication sent
+to the Licensor or its representatives, including but not limited to
+communication on electronic mailing lists, source code control systems,
+and issue tracking systems that are managed by, or on behalf of, the
+Licensor for the purpose of discussing and improving the Work, but
+excluding communication that is conspicuously marked or otherwise
+designated in writing by the copyright owner as "Not a Contribution."
+
+"Contributor" shall mean Licensor and any individual or Legal Entity
+on behalf of whom a Contribution has been received by Licensor and
+subsequently incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of
+this License, each Contributor hereby grants to You a perpetual,
+worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+copyright license to reproduce, prepare Derivative Works of,
+publicly display, publicly perform, sublicense, and distribute the
+Work and such Derivative Works in Source or Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of
+this License, each Contributor hereby grants to You a perpetual,
+worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+(except as stated in this section) patent license to make, have made,
+use, offer to sell, sell, import, and otherwise transfer the Work,
+where such license applies only to those patent claims licensable
+by such Contributor that are necessarily infringed by their
+Contribution(s) alone or by combination of their Contribution(s)
+with the Work to which such Contribution(s) was submitted. If You
+institute patent litigation against any entity (including a
+cross-claim or counterclaim in a lawsuit) alleging that the Work
+or a Contribution incorporated within the Work constitutes direct
+or contributory patent infringement, then any patent licenses
+granted to You under this License for that Work shall terminate
+as of the date such litigation is filed.
+
+4. Redistribution. You may reproduce and distribute copies of the
+Work or Derivative Works thereof in any medium, with or without
+modifications, and in Source or Object form, provided that You
+meet the following conditions:
+
+(a) You must give any other recipients of the Work or
+Derivative Works a copy of this License; and
+
+(b) You must cause any modified files to carry prominent notices
+stating that You changed the files; and
+
+(c) You must retain, in the Source form of any Derivative Works
+that You distribute, all copyright, patent, trademark, and
+attribution notices from the Source form of the Work,
+excluding those notices that do not pertain to any part of
+the Derivative Works; and
+
+(d) If the Work includes a "NOTICE" text file as part of its
+distribution, then any Derivative Works that You distribute must
+include a readable copy of the attribution notices contained
+within such NOTICE file, excluding those notices that do not
+pertain to any part of the Derivative Works, in at least one
+of the following places: within a NOTICE text file distributed
+as part of the Derivative Works; within the Source form or
+documentation, if provided along with the Derivative Works; or,
+within a display generated by the Derivative Works, if and
+wherever such third-party notices normally appear. The contents
+of the NOTICE file are for informational purposes only and
+do not modify the License. You may add Your own attribution
+notices within Derivative Works that You distribute, alongside
+or as an addendum to the NOTICE text from the Work, provided
+that such additional attribution notices cannot be construed
+as modifying the License.
+
+You may add Your own copyright statement to Your modifications and
+may provide additional or different license terms and conditions
+for use, reproduction, or distribution of Your modifications, or
+for any such Derivative Works as a whole, provided Your use,
+reproduction, and distribution of the Work otherwise complies with
+the conditions stated in this License.
+
+5. Submission of Contributions. Unless You explicitly state otherwise,
+any Contribution intentionally submitted for inclusion in the Work
+by You to the Licensor shall be under the terms and conditions of
+this License, without any additional terms or conditions.
+Notwithstanding the above, nothing herein shall supersede or modify
+the terms of any separate license agreement you may have executed
+with Licensor regarding such Contributions.
+
+6. Trademarks. This License does not grant permission to use the trade
+names, trademarks, service marks, or product names of the Licensor,
+except as required for reasonable and customary use in describing the
+origin of the Work and reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or
+agreed to in writing, Licensor provides the Work (and each
+Contributor provides its Contributions) on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+implied, including, without limitation, any warranties or conditions
+of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+PARTICULAR PURPOSE. You are solely responsible for determining the
+appropriateness of using or redistributing the Work and assume any
+risks associated with Your exercise of permissions under this License.
+
+8. Limitation of Liability. In no event and under no legal theory,
+whether in tort (including negligence), contract, or otherwise,
+unless required by applicable law (such as deliberate and grossly
+negligent acts) or agreed to in writing, shall any Contributor be
+liable to You for damages, including any direct, indirect, special,
+incidental, or consequential damages of any character arising as a
+result of this License or out of the use or inability to use the
+Work (including but not limited to damages for loss of goodwill,
+work stoppage, computer failure or malfunction, or any and all
+other commercial damages or losses), even if such Contributor
+has been advised of the possibility of such damages.
+
+9. Accepting Warranty or Additional Liability. While redistributing
+the Work or Derivative Works thereof, You may choose to offer,
+and charge a fee for, acceptance of support, warranty, indemnity,
+or other liability obligations and/or rights consistent with this
+License. However, in accepting such obligations, You may act only
+on Your own behalf and on Your sole responsibility, not on behalf
+of any other Contributor, and only if You agree to indemnify,
+defend, and hold each Contributor harmless for any liability
+incurred by, or claims asserted against, such Contributor by reason
+of your accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS
+
+APPENDIX: How to apply the Apache License to your work.
+
+To apply the Apache License to your work, attach the following
+boilerplate notice, with the fields enclosed by brackets "[]"
+replaced with your own identifying information. (Don't include
+the brackets!) The text should be enclosed in the appropriate
+comment syntax for the file format. We also recommend that a
+file or class name and description of purpose be included on the
+same "printed page" as the copyright notice for easier
+identification within third-party archives.
+
+Copyright [yyyy] [name of copyright owner]
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,37 @@
+# @loop-engine/observability
+
+[![npm](https://img.shields.io/npm/v/@loop-engine/observability.svg)](https://www.npmjs.com/package/@loop-engine/observability)
+[![Apache-2.0](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
+[![Loop Engine](https://img.shields.io/badge/loopengine.io-docs-blue)](https://loopengine.io/docs)
+
+Loop timeline reconstruction, replay validation, and observability helpers for Loop Engine.
+
+## Install
+
+```bash
+npm install @loop-engine/observability
+```
+
+## Quick Start
+
+```ts
+import { buildTimeline, replayLoop } from "@loop-engine/observability";
+
+const timeline = buildTimeline(instance, history);
+const replay = replayLoop(definition, history);
+
+console.log({
+  aggregateId: timeline.aggregateId,
+  durationMs: timeline.durationMs,
+  transitions: timeline.transitions.length,
+  replayValid: replay.valid
+});
+```
+
+## Documentation link
+
+https://loopengine.io/docs/packages/observability
+
+## License
+
+Apache-2.0 © Better Data, Inc.

package/dist/index.cjs

@@ -0,0 +1,134 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  buildTimeline: () => buildTimeline,
+  computeMetrics: () => computeMetrics,
+  getStateResidency: () => getStateResidency,
+  replayLoop: () => replayLoop
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/metrics.ts
+function percentile(values, p) {
+  if (values.length === 0) return 0;
+  const sorted = [...values].sort((a, b) => a - b);
+  const idx = Math.min(sorted.length - 1, Math.floor(p / 100 * sorted.length));
+  return sorted[idx] ?? 0;
+}
+function computeMetrics(instances, history, period) {
+  const first = instances[0];
+  const loop = first?.loopId ?? "unknown.loop";
+  const total = instances.length;
+  const open = instances.filter((instance) => instance.status === "active").length;
+  const closed = instances.filter((instance) => instance.status === "completed").length;
+  const error = instances.filter((instance) => instance.status === "failed").length;
+  const durations = instances.map(
+    (instance) => instance.completedAt ? Date.parse(instance.completedAt) - Date.parse(instance.startedAt) : 0
+  ).filter((duration) => duration > 0);
+  const avg = durations.length ? durations.reduce((a, b) => a + b, 0) / durations.length : 0;
+  const aiTransitions = history.filter((record) => record.actor.type === "ai-agent").length;
+  const humanTransitions = history.filter((record) => record.actor.type === "human").length;
+  const totalTransitions = history.length;
+  const byAggregate = /* @__PURE__ */ new Map();
+  for (const record of history) {
+    byAggregate.set(record.aggregateId, (byAggregate.get(record.aggregateId) ?? 0) + 1);
+  }
+  return {
+    loopId: loop,
+    period,
+    totalInstances: total,
+    openInstances: open,
+    closedInstances: closed,
+    errorInstances: error,
+    avgDurationMs: avg,
+    medianDurationMs: percentile(durations, 50),
+    p95DurationMs: percentile(durations, 95),
+    completionRate: closed + error > 0 ? closed / (closed + error) : 0,
+    guardFailureRate: 0,
+    aiActorRate: totalTransitions > 0 ? aiTransitions / totalTransitions : 0,
+    humanActorRate: totalTransitions > 0 ? humanTransitions / totalTransitions : 0,
+    avgTransitionCount: byAggregate.size > 0 ? [...byAggregate.values()].reduce((a, b) => a + b, 0) / byAggregate.size : 0
+  };
+}
+
+// src/timeline.ts
+function buildTimeline(instance, history) {
+  const end = instance.completedAt ?? (/* @__PURE__ */ new Date()).toISOString();
+  return {
+    aggregateId: instance.aggregateId,
+    loopId: instance.loopId,
+    instance,
+    transitions: [...history].sort(
+      (left, right) => Date.parse(left.occurredAt) - Date.parse(right.occurredAt)
+    ),
+    durationMs: Math.max(0, Date.parse(end) - Date.parse(instance.startedAt)),
+    isComplete: instance.status === "completed"
+  };
+}
+function getStateResidency(timeline) {
+  const out = [];
+  let currentState = timeline.instance.currentState;
+  let enteredAt = timeline.instance.startedAt;
+  for (const t of timeline.transitions) {
+    out.push({
+      stateId: currentState,
+      enteredAt,
+      exitedAt: t.occurredAt,
+      durationMs: Math.max(0, Date.parse(t.occurredAt) - Date.parse(enteredAt))
+    });
+    currentState = t.toState;
+    enteredAt = t.occurredAt;
+  }
+  out.push({
+    stateId: currentState,
+    enteredAt,
+    ...timeline.instance.completedAt ? { exitedAt: timeline.instance.completedAt } : {},
+    ...timeline.instance.completedAt ? { durationMs: Math.max(0, Date.parse(timeline.instance.completedAt) - Date.parse(enteredAt)) } : {}
+  });
+  return out;
+}
+
+// src/replay.ts
+function replayLoop(definition, history) {
+  const errors = [];
+  let state = definition.initialState;
+  for (const record of history) {
+    const match = definition.transitions.find(
+      (transition) => transition.transitionId === record.transitionId && transition.from === state && transition.to === record.toState
+    );
+    if (!match) {
+      errors.push(`Invalid transition ${record.transitionId} from ${state} to ${record.toState}`);
+      continue;
+    }
+    state = record.toState;
+  }
+  return { valid: errors.length === 0, errors };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  buildTimeline,
+  computeMetrics,
+  getStateResidency,
+  replayLoop
+});
+// @license Apache-2.0
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/metrics.ts","../src/timeline.ts","../src/replay.ts"],"sourcesContent":["// @license Apache-2.0\n// SPDX-License-Identifier: Apache-2.0\nexport * from \"./metrics\";\nexport * from \"./timeline\";\nexport * from \"./replay\";\n","// @license Apache-2.0\n// SPDX-License-Identifier: Apache-2.0\nimport type { LoopId } from \"@loop-engine/core\";\nimport type { RuntimeLoopInstance, RuntimeTransitionRecord } from \"@loop-engine/runtime\";\n\nexport interface LoopMetrics {\n  loopId: LoopId;\n  period: { from: string; to: string };\n  totalInstances: number;\n  openInstances: number;\n  closedInstances: number;\n  errorInstances: number;\n  avgDurationMs: number;\n  medianDurationMs: number;\n  p95DurationMs: number;\n  completionRate: number;\n  guardFailureRate: number;\n  aiActorRate: number;\n  humanActorRate: number;\n  avgTransitionCount: number;\n}\n\nfunction percentile(values: number[], p: number): number {\n  if (values.length === 0) return 0;\n  const sorted = [...values].sort((a, b) => a - b);\n  const idx = Math.min(sorted.length - 1, Math.floor((p / 100) * sorted.length));\n  return sorted[idx] ?? 0;\n}\n\nexport function computeMetrics(\n  instances: RuntimeLoopInstance[],\n  history: RuntimeTransitionRecord[],\n  period: { from: string; to: string }\n): LoopMetrics {\n  const first = instances[0];\n  const loop = (first?.loopId ?? \"unknown.loop\") as LoopId;\n  const total = instances.length;\n  const open = instances.filter((instance) => instance.status === \"active\").length;\n  const closed = instances.filter((instance) => instance.status === \"completed\").length;\n  const error = instances.filter((instance) => instance.status === \"failed\").length;\n\n  const durations = instances\n    .map((instance) =>\n      instance.completedAt ? Date.parse(instance.completedAt) - Date.parse(instance.startedAt) : 0\n    )\n    .filter((duration) => duration > 0);\n  const avg = durations.length ? durations.reduce((a, b) => a + b, 0) / durations.length : 0;\n  const aiTransitions = history.filter((record) => record.actor.type === \"ai-agent\").length;\n  const humanTransitions = history.filter((record) => record.actor.type === \"human\").length;\n  const totalTransitions = history.length;\n\n  const byAggregate = new Map<string, number>();\n  for (const record of history) {\n    byAggregate.set(record.aggregateId, (byAggregate.get(record.aggregateId) ?? 0) + 1);\n  }\n\n  return {\n    loopId: loop,\n    period,\n    totalInstances: total,\n    openInstances: open,\n    closedInstances: closed,\n    errorInstances: error,\n    avgDurationMs: avg,\n    medianDurationMs: percentile(durations, 50),\n    p95DurationMs: percentile(durations, 95),\n    completionRate: closed + error > 0 ? closed / (closed + error) : 0,\n    guardFailureRate: 0,\n    aiActorRate: totalTransitions > 0 ? aiTransitions / totalTransitions : 0,\n    humanActorRate: totalTransitions > 0 ? humanTransitions / totalTransitions : 0,\n    avgTransitionCount:\n      byAggregate.size > 0\n        ? [...byAggregate.values()].reduce((a, b) => a + b, 0) / byAggregate.size\n        : 0\n  };\n}\n","// @license Apache-2.0\n// SPDX-License-Identifier: Apache-2.0\nimport type { AggregateId, StateId } from \"@loop-engine/core\";\nimport type { RuntimeLoopInstance, RuntimeTransitionRecord } from \"@loop-engine/runtime\";\n\nexport interface LoopTimeline {\n  aggregateId: AggregateId;\n  loopId: RuntimeLoopInstance[\"loopId\"];\n  instance: RuntimeLoopInstance;\n  transitions: RuntimeTransitionRecord[];\n  durationMs: number;\n  isComplete: boolean;\n}\n\nexport interface StateResidency {\n  stateId: StateId;\n  enteredAt: string;\n  exitedAt?: string;\n  durationMs?: number;\n}\n\nexport function buildTimeline(\n  instance: RuntimeLoopInstance,\n  history: RuntimeTransitionRecord[]\n): LoopTimeline {\n  const end = instance.completedAt ?? new Date().toISOString();\n  return {\n    aggregateId: instance.aggregateId,\n    loopId: instance.loopId,\n    instance,\n    transitions: [...history].sort(\n      (left, right) => Date.parse(left.occurredAt) - Date.parse(right.occurredAt)\n    ),\n    durationMs: Math.max(0, Date.parse(end) - Date.parse(instance.startedAt)),\n    isComplete: instance.status === \"completed\"\n  };\n}\n\nexport function getStateResidency(timeline: LoopTimeline): StateResidency[] {\n  const out: StateResidency[] = [];\n  let currentState = timeline.instance.currentState;\n  let enteredAt = timeline.instance.startedAt;\n  for (const t of timeline.transitions) {\n    out.push({\n      stateId: currentState,\n      enteredAt,\n      exitedAt: t.occurredAt,\n      durationMs: Math.max(0, Date.parse(t.occurredAt) - Date.parse(enteredAt))\n    });\n    currentState = t.toState;\n    enteredAt = t.occurredAt;\n  }\n  out.push({\n    stateId: currentState,\n    enteredAt,\n    ...(timeline.instance.completedAt ? { exitedAt: timeline.instance.completedAt } : {}),\n    ...(timeline.instance.completedAt\n      ? { durationMs: Math.max(0, Date.parse(timeline.instance.completedAt) - Date.parse(enteredAt)) }\n      : {})\n  });\n  return out;\n}\n","// @license Apache-2.0\n// SPDX-License-Identifier: Apache-2.0\nimport type { LoopDefinition } from \"@loop-engine/core\";\nimport type { RuntimeTransitionRecord } from \"@loop-engine/runtime\";\n\nexport function replayLoop(\n  definition: LoopDefinition,\n  history: RuntimeTransitionRecord[]\n): { valid: boolean; errors: string[] } {\n  const errors: string[] = [];\n  let state = definition.initialState;\n  for (const record of history) {\n    const match = definition.transitions.find(\n      (transition) =>\n        transition.transitionId === record.transitionId &&\n        transition.from === state &&\n        transition.to === record.toState\n    );\n    if (!match) {\n      errors.push(`Invalid transition ${record.transitionId} from ${state} to ${record.toState}`);\n      continue;\n    }\n    state = record.toState;\n  }\n  return { valid: errors.length === 0, errors };\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,50 @@
+import { LoopId, AggregateId, StateId, LoopDefinition } from '@loop-engine/core';
+import { RuntimeLoopInstance, RuntimeTransitionRecord } from '@loop-engine/runtime';
+
+interface LoopMetrics {
+    loopId: LoopId;
+    period: {
+        from: string;
+        to: string;
+    };
+    totalInstances: number;
+    openInstances: number;
+    closedInstances: number;
+    errorInstances: number;
+    avgDurationMs: number;
+    medianDurationMs: number;
+    p95DurationMs: number;
+    completionRate: number;
+    guardFailureRate: number;
+    aiActorRate: number;
+    humanActorRate: number;
+    avgTransitionCount: number;
+}
+declare function computeMetrics(instances: RuntimeLoopInstance[], history: RuntimeTransitionRecord[], period: {
+    from: string;
+    to: string;
+}): LoopMetrics;
+
+interface LoopTimeline {
+    aggregateId: AggregateId;
+    loopId: RuntimeLoopInstance["loopId"];
+    instance: RuntimeLoopInstance;
+    transitions: RuntimeTransitionRecord[];
+    durationMs: number;
+    isComplete: boolean;
+}
+interface StateResidency {
+    stateId: StateId;
+    enteredAt: string;
+    exitedAt?: string;
+    durationMs?: number;
+}
+declare function buildTimeline(instance: RuntimeLoopInstance, history: RuntimeTransitionRecord[]): LoopTimeline;
+declare function getStateResidency(timeline: LoopTimeline): StateResidency[];
+
+declare function replayLoop(definition: LoopDefinition, history: RuntimeTransitionRecord[]): {
+    valid: boolean;
+    errors: string[];
+};
+
+export { type LoopMetrics, type LoopTimeline, type StateResidency, buildTimeline, computeMetrics, getStateResidency, replayLoop };

package/dist/index.d.ts

@@ -1,4 +1,50 @@
-export * from "./metrics";
-export * from "./timeline";
-export * from "./replay";
-//# sourceMappingURL=index.d.ts.map
+import { LoopId, AggregateId, StateId, LoopDefinition } from '@loop-engine/core';
+import { RuntimeLoopInstance, RuntimeTransitionRecord } from '@loop-engine/runtime';
+
+interface LoopMetrics {
+    loopId: LoopId;
+    period: {
+        from: string;
+        to: string;
+    };
+    totalInstances: number;
+    openInstances: number;
+    closedInstances: number;
+    errorInstances: number;
+    avgDurationMs: number;
+    medianDurationMs: number;
+    p95DurationMs: number;
+    completionRate: number;
+    guardFailureRate: number;
+    aiActorRate: number;
+    humanActorRate: number;
+    avgTransitionCount: number;
+}
+declare function computeMetrics(instances: RuntimeLoopInstance[], history: RuntimeTransitionRecord[], period: {
+    from: string;
+    to: string;
+}): LoopMetrics;
+
+interface LoopTimeline {
+    aggregateId: AggregateId;
+    loopId: RuntimeLoopInstance["loopId"];
+    instance: RuntimeLoopInstance;
+    transitions: RuntimeTransitionRecord[];
+    durationMs: number;
+    isComplete: boolean;
+}
+interface StateResidency {
+    stateId: StateId;
+    enteredAt: string;
+    exitedAt?: string;
+    durationMs?: number;
+}
+declare function buildTimeline(instance: RuntimeLoopInstance, history: RuntimeTransitionRecord[]): LoopTimeline;
+declare function getStateResidency(timeline: LoopTimeline): StateResidency[];
+
+declare function replayLoop(definition: LoopDefinition, history: RuntimeTransitionRecord[]): {
+    valid: boolean;
+    errors: string[];
+};
+
+export { type LoopMetrics, type LoopTimeline, type StateResidency, buildTimeline, computeMetrics, getStateResidency, replayLoop };

package/dist/index.js

@@ -1,6 +1,104 @@
-// @license MIT
-// SPDX-License-Identifier: MIT
-export * from "./metrics";
-export * from "./timeline";
-export * from "./replay";
+// src/metrics.ts
+function percentile(values, p) {
+  if (values.length === 0) return 0;
+  const sorted = [...values].sort((a, b) => a - b);
+  const idx = Math.min(sorted.length - 1, Math.floor(p / 100 * sorted.length));
+  return sorted[idx] ?? 0;
+}
+function computeMetrics(instances, history, period) {
+  const first = instances[0];
+  const loop = first?.loopId ?? "unknown.loop";
+  const total = instances.length;
+  const open = instances.filter((instance) => instance.status === "active").length;
+  const closed = instances.filter((instance) => instance.status === "completed").length;
+  const error = instances.filter((instance) => instance.status === "failed").length;
+  const durations = instances.map(
+    (instance) => instance.completedAt ? Date.parse(instance.completedAt) - Date.parse(instance.startedAt) : 0
+  ).filter((duration) => duration > 0);
+  const avg = durations.length ? durations.reduce((a, b) => a + b, 0) / durations.length : 0;
+  const aiTransitions = history.filter((record) => record.actor.type === "ai-agent").length;
+  const humanTransitions = history.filter((record) => record.actor.type === "human").length;
+  const totalTransitions = history.length;
+  const byAggregate = /* @__PURE__ */ new Map();
+  for (const record of history) {
+    byAggregate.set(record.aggregateId, (byAggregate.get(record.aggregateId) ?? 0) + 1);
+  }
+  return {
+    loopId: loop,
+    period,
+    totalInstances: total,
+    openInstances: open,
+    closedInstances: closed,
+    errorInstances: error,
+    avgDurationMs: avg,
+    medianDurationMs: percentile(durations, 50),
+    p95DurationMs: percentile(durations, 95),
+    completionRate: closed + error > 0 ? closed / (closed + error) : 0,
+    guardFailureRate: 0,
+    aiActorRate: totalTransitions > 0 ? aiTransitions / totalTransitions : 0,
+    humanActorRate: totalTransitions > 0 ? humanTransitions / totalTransitions : 0,
+    avgTransitionCount: byAggregate.size > 0 ? [...byAggregate.values()].reduce((a, b) => a + b, 0) / byAggregate.size : 0
+  };
+}
+
+// src/timeline.ts
+function buildTimeline(instance, history) {
+  const end = instance.completedAt ?? (/* @__PURE__ */ new Date()).toISOString();
+  return {
+    aggregateId: instance.aggregateId,
+    loopId: instance.loopId,
+    instance,
+    transitions: [...history].sort(
+      (left, right) => Date.parse(left.occurredAt) - Date.parse(right.occurredAt)
+    ),
+    durationMs: Math.max(0, Date.parse(end) - Date.parse(instance.startedAt)),
+    isComplete: instance.status === "completed"
+  };
+}
+function getStateResidency(timeline) {
+  const out = [];
+  let currentState = timeline.instance.currentState;
+  let enteredAt = timeline.instance.startedAt;
+  for (const t of timeline.transitions) {
+    out.push({
+      stateId: currentState,
+      enteredAt,
+      exitedAt: t.occurredAt,
+      durationMs: Math.max(0, Date.parse(t.occurredAt) - Date.parse(enteredAt))
+    });
+    currentState = t.toState;
+    enteredAt = t.occurredAt;
+  }
+  out.push({
+    stateId: currentState,
+    enteredAt,
+    ...timeline.instance.completedAt ? { exitedAt: timeline.instance.completedAt } : {},
+    ...timeline.instance.completedAt ? { durationMs: Math.max(0, Date.parse(timeline.instance.completedAt) - Date.parse(enteredAt)) } : {}
+  });
+  return out;
+}
+
+// src/replay.ts
+function replayLoop(definition, history) {
+  const errors = [];
+  let state = definition.initialState;
+  for (const record of history) {
+    const match = definition.transitions.find(
+      (transition) => transition.transitionId === record.transitionId && transition.from === state && transition.to === record.toState
+    );
+    if (!match) {
+      errors.push(`Invalid transition ${record.transitionId} from ${state} to ${record.toState}`);
+      continue;
+    }
+    state = record.toState;
+  }
+  return { valid: errors.length === 0, errors };
+}
+export {
+  buildTimeline,
+  computeMetrics,
+  getStateResidency,
+  replayLoop
+};
+// @license Apache-2.0
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAe;AACf,+BAA+B;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC"}
+{"version":3,"sources":["../src/metrics.ts","../src/timeline.ts","../src/replay.ts"],"sourcesContent":["// @license Apache-2.0\n// SPDX-License-Identifier: Apache-2.0\nimport type { LoopId } from \"@loop-engine/core\";\nimport type { RuntimeLoopInstance, RuntimeTransitionRecord } from \"@loop-engine/runtime\";\n\nexport interface LoopMetrics {\n  loopId: LoopId;\n  period: { from: string; to: string };\n  totalInstances: number;\n  openInstances: number;\n  closedInstances: number;\n  errorInstances: number;\n  avgDurationMs: number;\n  medianDurationMs: number;\n  p95DurationMs: number;\n  completionRate: number;\n  guardFailureRate: number;\n  aiActorRate: number;\n  humanActorRate: number;\n  avgTransitionCount: number;\n}\n\nfunction percentile(values: number[], p: number): number {\n  if (values.length === 0) return 0;\n  const sorted = [...values].sort((a, b) => a - b);\n  const idx = Math.min(sorted.length - 1, Math.floor((p / 100) * sorted.length));\n  return sorted[idx] ?? 0;\n}\n\nexport function computeMetrics(\n  instances: RuntimeLoopInstance[],\n  history: RuntimeTransitionRecord[],\n  period: { from: string; to: string }\n): LoopMetrics {\n  const first = instances[0];\n  const loop = (first?.loopId ?? \"unknown.loop\") as LoopId;\n  const total = instances.length;\n  const open = instances.filter((instance) => instance.status === \"active\").length;\n  const closed = instances.filter((instance) => instance.status === \"completed\").length;\n  const error = instances.filter((instance) => instance.status === \"failed\").length;\n\n  const durations = instances\n    .map((instance) =>\n      instance.completedAt ? Date.parse(instance.completedAt) - Date.parse(instance.startedAt) : 0\n    )\n    .filter((duration) => duration > 0);\n  const avg = durations.length ? durations.reduce((a, b) => a + b, 0) / durations.length : 0;\n  const aiTransitions = history.filter((record) => record.actor.type === \"ai-agent\").length;\n  const humanTransitions = history.filter((record) => record.actor.type === \"human\").length;\n  const totalTransitions = history.length;\n\n  const byAggregate = new Map<string, number>();\n  for (const record of history) {\n    byAggregate.set(record.aggregateId, (byAggregate.get(record.aggregateId) ?? 0) + 1);\n  }\n\n  return {\n    loopId: loop,\n    period,\n    totalInstances: total,\n    openInstances: open,\n    closedInstances: closed,\n    errorInstances: error,\n    avgDurationMs: avg,\n    medianDurationMs: percentile(durations, 50),\n    p95DurationMs: percentile(durations, 95),\n    completionRate: closed + error > 0 ? closed / (closed + error) : 0,\n    guardFailureRate: 0,\n    aiActorRate: totalTransitions > 0 ? aiTransitions / totalTransitions : 0,\n    humanActorRate: totalTransitions > 0 ? humanTransitions / totalTransitions : 0,\n    avgTransitionCount:\n      byAggregate.size > 0\n        ? [...byAggregate.values()].reduce((a, b) => a + b, 0) / byAggregate.size\n        : 0\n  };\n}\n","// @license Apache-2.0\n// SPDX-License-Identifier: Apache-2.0\nimport type { AggregateId, StateId } from \"@loop-engine/core\";\nimport type { RuntimeLoopInstance, RuntimeTransitionRecord } from \"@loop-engine/runtime\";\n\nexport interface LoopTimeline {\n  aggregateId: AggregateId;\n  loopId: RuntimeLoopInstance[\"loopId\"];\n  instance: RuntimeLoopInstance;\n  transitions: RuntimeTransitionRecord[];\n  durationMs: number;\n  isComplete: boolean;\n}\n\nexport interface StateResidency {\n  stateId: StateId;\n  enteredAt: string;\n  exitedAt?: string;\n  durationMs?: number;\n}\n\nexport function buildTimeline(\n  instance: RuntimeLoopInstance,\n  history: RuntimeTransitionRecord[]\n): LoopTimeline {\n  const end = instance.completedAt ?? new Date().toISOString();\n  return {\n    aggregateId: instance.aggregateId,\n    loopId: instance.loopId,\n    instance,\n    transitions: [...history].sort(\n      (left, right) => Date.parse(left.occurredAt) - Date.parse(right.occurredAt)\n    ),\n    durationMs: Math.max(0, Date.parse(end) - Date.parse(instance.startedAt)),\n    isComplete: instance.status === \"completed\"\n  };\n}\n\nexport function getStateResidency(timeline: LoopTimeline): StateResidency[] {\n  const out: StateResidency[] = [];\n  let currentState = timeline.instance.currentState;\n  let enteredAt = timeline.instance.startedAt;\n  for (const t of timeline.transitions) {\n    out.push({\n      stateId: currentState,\n      enteredAt,\n      exitedAt: t.occurredAt,\n      durationMs: Math.max(0, Date.parse(t.occurredAt) - Date.parse(enteredAt))\n    });\n    currentState = t.toState;\n    enteredAt = t.occurredAt;\n  }\n  out.push({\n    stateId: currentState,\n    enteredAt,\n    ...(timeline.instance.completedAt ? { exitedAt: timeline.instance.completedAt } : {}),\n    ...(timeline.instance.completedAt\n      ? { durationMs: Math.max(0, Date.parse(timeline.instance.completedAt) - Date.parse(enteredAt)) }\n      : {})\n  });\n  return out;\n}\n","// @license Apache-2.0\n// SPDX-License-Identifier: Apache-2.0\nimport type { LoopDefinition } from \"@loop-engine/core\";\nimport type { RuntimeTransitionRecord } from \"@loop-engine/runtime\";\n\nexport function replayLoop(\n  definition: LoopDefinition,\n  history: RuntimeTransitionRecord[]\n): { valid: boolean; errors: string[] } {\n  const errors: string[] = [];\n  let state = definition.initialState;\n  for (const record of history) {\n    const match = definition.transitions.find(\n      (transition) =>\n        transition.transitionId === record.transitionId &&\n        transition.from === state &&\n        transition.to === record.toState\n    );\n    if (!match) {\n      errors.push(`Invalid transition ${record.transitionId} from ${state} to ${record.toState}`);\n      continue;\n    }\n    state = record.toState;\n  }\n  return { valid: errors.length === 0, errors };\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,29 +1,51 @@
 {
   "name": "@loop-engine/observability",
-  "version": "0.1.0",
-  "license": "MIT",
+  "version": "0.1.2",
+  "description": "Metrics, timelines, and replay utilities for Loop Engine execution traces",
+  "license": "Apache-2.0",
+  "keywords": [
+    "loop-engine",
+    "workflow",
+    "governance",
+    "state-machine",
+    "audit-trail",
+    "actors",
+    "guards",
+    "enterprise",
+    "supply-chain",
+    "decision-governance",
+    "observability",
+    "timeline",
+    "replay",
+    "devtools"
+  ],
   "type": "module",
-  "main": "./dist/index.js",
+  "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
       "import": "./dist/index.js",
-      "require": "./dist/index.js",
+      "require": "./dist/index.cjs",
       "types": "./dist/index.d.ts"
     }
   },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  },
   "dependencies": {
-    "@loop-engine/core": "0.1.0"
+    "@loop-engine/core": "workspace:*",
+    "@loop-engine/runtime": "workspace:*"
   },
+  "devDependencies": {},
   "files": [
     "dist/",
     "README.md",
     "LICENSE"
   ],
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test": "vitest run"
+  "engines": {
+    "node": ">=18.0.0"
   }
-}
+}

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC"}

package/dist/metrics.d.ts

@@ -1,25 +0,0 @@
-import type { LoopId, LoopInstance, TransitionRecord } from "@loop-engine/core";
-export interface LoopMetrics {
-    loopId: LoopId;
-    period: {
-        from: string;
-        to: string;
-    };
-    totalInstances: number;
-    openInstances: number;
-    closedInstances: number;
-    errorInstances: number;
-    avgDurationMs: number;
-    medianDurationMs: number;
-    p95DurationMs: number;
-    completionRate: number;
-    guardFailureRate: number;
-    aiActorRate: number;
-    humanActorRate: number;
-    avgTransitionCount: number;
-}
-export declare function computeMetrics(instances: LoopInstance[], history: TransitionRecord[], period: {
-    from: string;
-    to: string;
-}): LoopMetrics;
-//# sourceMappingURL=metrics.d.ts.map

package/dist/metrics.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAEhF,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AASD,wBAAgB,cAAc,CAC5B,SAAS,EAAE,YAAY,EAAE,EACzB,OAAO,EAAE,gBAAgB,EAAE,EAC3B,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GACnC,WAAW,CAwCb"}

package/dist/metrics.js

@@ -1,45 +0,0 @@
-function percentile(values, p) {
-    if (values.length === 0)
-        return 0;
-    const sorted = [...values].sort((a, b) => a - b);
-    const idx = Math.min(sorted.length - 1, Math.floor((p / 100) * sorted.length));
-    return sorted[idx] ?? 0;
-}
-export function computeMetrics(instances, history, period) {
-    const first = instances[0];
-    const loop = (first?.loopId ?? "unknown.loop");
-    const total = instances.length;
-    const open = instances.filter((i) => i.status === "OPEN" || i.status === "IN_PROGRESS").length;
-    const closed = instances.filter((i) => i.status === "CLOSED").length;
-    const error = instances.filter((i) => i.status === "ERROR").length;
-    const durations = instances
-        .map((i) => (i.closedAt ? Date.parse(i.closedAt) - Date.parse(i.startedAt) : 0))
-        .filter((d) => d > 0);
-    const avg = durations.length ? durations.reduce((a, b) => a + b, 0) / durations.length : 0;
-    const aiTransitions = history.filter((r) => r.actor.type === "ai-agent").length;
-    const humanTransitions = history.filter((r) => r.actor.type === "human").length;
-    const totalTransitions = history.length;
-    const byAggregate = new Map();
-    for (const r of history) {
-        byAggregate.set(r.aggregateId, (byAggregate.get(r.aggregateId) ?? 0) + 1);
-    }
-    return {
-        loopId: loop,
-        period,
-        totalInstances: total,
-        openInstances: open,
-        closedInstances: closed,
-        errorInstances: error,
-        avgDurationMs: avg,
-        medianDurationMs: percentile(durations, 50),
-        p95DurationMs: percentile(durations, 95),
-        completionRate: closed + error > 0 ? closed / (closed + error) : 0,
-        guardFailureRate: 0,
-        aiActorRate: totalTransitions > 0 ? aiTransitions / totalTransitions : 0,
-        humanActorRate: totalTransitions > 0 ? humanTransitions / totalTransitions : 0,
-        avgTransitionCount: byAggregate.size > 0
-            ? [...byAggregate.values()].reduce((a, b) => a + b, 0) / byAggregate.size
-            : 0
-    };
-}
-//# sourceMappingURL=metrics.js.map

package/dist/metrics.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"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"}

package/dist/replay.d.ts

@@ -1,6 +0,0 @@
-import type { LoopDefinition, TransitionRecord } from "@loop-engine/core";
-export declare function replayLoop(definition: LoopDefinition, history: TransitionRecord[]): {
-    valid: boolean;
-    errors: string[];
-};
-//# sourceMappingURL=replay.d.ts.map

package/dist/replay.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../src/replay.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1E,wBAAgB,UAAU,CACxB,UAAU,EAAE,cAAc,EAC1B,OAAO,EAAE,gBAAgB,EAAE,GAC1B;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CActC"}

package/dist/replay.js

@@ -1,14 +0,0 @@
-export function replayLoop(definition, history) {
-    const errors = [];
-    let state = definition.initialState;
-    for (const record of history) {
-        const match = definition.transitions.find((t) => t.id === record.transitionId && t.from === state && t.to === record.toState);
-        if (!match) {
-            errors.push(`Invalid transition ${record.transitionId} from ${state} to ${record.toState}`);
-            continue;
-        }
-        state = record.toState;
-    }
-    return { valid: errors.length === 0, errors };
-}
-//# sourceMappingURL=replay.js.map

package/dist/replay.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"replay.js","sourceRoot":"","sources":["../src/replay.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,UAAU,CACxB,UAA0B,EAC1B,OAA2B;IAE3B,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,KAAK,GAAG,UAAU,CAAC,YAAY,CAAC;IACpC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,UAAU,CAAC,WAAW,CAAC,IAAI,CACvC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,YAAY,IAAI,CAAC,CAAC,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,OAAO,CACnF,CAAC;QACF,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,CAAC,IAAI,CAAC,sBAAsB,MAAM,CAAC,YAAY,SAAS,KAAK,OAAO,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;YAC5F,SAAS;QACX,CAAC;QACD,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC;IACzB,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;AAChD,CAAC"}

package/dist/timeline.d.ts

@@ -1,18 +0,0 @@
-import type { AggregateId, LoopInstance, StateId, TransitionRecord } from "@loop-engine/core";
-export interface LoopTimeline {
-    aggregateId: AggregateId;
-    loopId: string;
-    instance: LoopInstance;
-    transitions: TransitionRecord[];
-    durationMs: number;
-    isComplete: boolean;
-}
-export interface StateResidency {
-    stateId: StateId;
-    enteredAt: string;
-    exitedAt?: string;
-    durationMs?: number;
-}
-export declare function buildTimeline(instance: LoopInstance, history: TransitionRecord[]): LoopTimeline;
-export declare function getStateResidency(timeline: LoopTimeline): StateResidency[];
-//# sourceMappingURL=timeline.d.ts.map

package/dist/timeline.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"timeline.d.ts","sourceRoot":"","sources":["../src/timeline.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE9F,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,WAAW,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,YAAY,CAAC;IACvB,WAAW,EAAE,gBAAgB,EAAE,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,gBAAgB,EAAE,GAAG,YAAY,CAU/F;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,YAAY,GAAG,cAAc,EAAE,CAuB1E"}

package/dist/timeline.js

@@ -1,36 +0,0 @@
-export function buildTimeline(instance, history) {
-    const end = instance.closedAt ?? new Date().toISOString();
-    return {
-        aggregateId: instance.aggregateId,
-        loopId: instance.loopId,
-        instance,
-        transitions: [...history].sort((a, b) => Date.parse(a.occurredAt) - Date.parse(b.occurredAt)),
-        durationMs: Math.max(0, Date.parse(end) - Date.parse(instance.startedAt)),
-        isComplete: instance.status === "CLOSED"
-    };
-}
-export function getStateResidency(timeline) {
-    const out = [];
-    let currentState = timeline.instance.currentState;
-    let enteredAt = timeline.instance.startedAt;
-    for (const t of timeline.transitions) {
-        out.push({
-            stateId: currentState,
-            enteredAt,
-            exitedAt: t.occurredAt,
-            durationMs: Math.max(0, Date.parse(t.occurredAt) - Date.parse(enteredAt))
-        });
-        currentState = t.toState;
-        enteredAt = t.occurredAt;
-    }
-    out.push({
-        stateId: currentState,
-        enteredAt,
-        ...(timeline.instance.closedAt ? { exitedAt: timeline.instance.closedAt } : {}),
-        ...(timeline.instance.closedAt
-            ? { durationMs: Math.max(0, Date.parse(timeline.instance.closedAt) - Date.parse(enteredAt)) }
-            : {})
-    });
-    return out;
-}
-//# sourceMappingURL=timeline.js.map

package/dist/timeline.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"timeline.js","sourceRoot":"","sources":["../src/timeline.ts"],"names":[],"mappings":"AAoBA,MAAM,UAAU,aAAa,CAAC,QAAsB,EAAE,OAA2B;IAC/E,MAAM,GAAG,GAAG,QAAQ,CAAC,QAAQ,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC1D,OAAO;QACL,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,QAAQ;QACR,WAAW,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;QAC7F,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACzE,UAAU,EAAE,QAAQ,CAAC,MAAM,KAAK,QAAQ;KACzC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAsB;IACtD,MAAM,GAAG,GAAqB,EAAE,CAAC;IACjC,IAAI,YAAY,GAAG,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC;IAClD,IAAI,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC;IAC5C,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC;QACrC,GAAG,CAAC,IAAI,CAAC;YACP,OAAO,EAAE,YAAY;YACrB,SAAS;YACT,QAAQ,EAAE,CAAC,CAAC,UAAU;YACtB,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;SAC1E,CAAC,CAAC;QACH,YAAY,GAAG,CAAC,CAAC,OAAO,CAAC;QACzB,SAAS,GAAG,CAAC,CAAC,UAAU,CAAC;IAC3B,CAAC;IACD,GAAG,CAAC,IAAI,CAAC;QACP,OAAO,EAAE,YAAY;QACrB,SAAS;QACT,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/E,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ;YAC5B,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE;YAC7F,CAAC,CAAC,EAAE,CAAC;KACR,CAAC,CAAC;IACH,OAAO,GAAG,CAAC;AACb,CAAC"}