@kronos-ts/opentelemetry 0.2.2 → 0.4.0

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export { createOpenTelemetrySpanFactory, type OpenTelemetrySpanFactoryOptions, } from "./opentelemetry-span-factory.js";
-export { openTelemetry } from "./opentelemetry.js";
+export { openTelemetry, openTelemetryMetrics } from "./opentelemetry.js";
+export { createOpenTelemetryMetricsRecorder, type OpenTelemetryMetricsRecorderOptions, } from "./opentelemetry-metrics-recorder.js";
 export { createOpenTelemetryDeadLetterListener } from "./opentelemetry-dead-letter-listener.js";
 export { createTracingCommandBus } from "@kronos-ts/messaging";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,EAC9B,KAAK,+BAA+B,GACrC,MAAM,iCAAiC,CAAA;AAExC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAElD,OAAO,EAAE,qCAAqC,EAAE,MAAM,yCAAyC,CAAA;AAG/F,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,EAC9B,KAAK,+BAA+B,GACrC,MAAM,iCAAiC,CAAA;AAExC,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAExE,OAAO,EACL,kCAAkC,EAClC,KAAK,mCAAmC,GACzC,MAAM,qCAAqC,CAAA;AAE5C,OAAO,EAAE,qCAAqC,EAAE,MAAM,yCAAyC,CAAA;AAG/F,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/index.js

@@ -1,5 +1,6 @@
 export { createOpenTelemetrySpanFactory, } from "./opentelemetry-span-factory.js";
-export { openTelemetry } from "./opentelemetry.js";
+export { openTelemetry, openTelemetryMetrics } from "./opentelemetry.js";
+export { createOpenTelemetryMetricsRecorder, } from "./opentelemetry-metrics-recorder.js";
 export { createOpenTelemetryDeadLetterListener } from "./opentelemetry-dead-letter-listener.js";
 // Re-export tracing command bus for convenience
 export { createTracingCommandBus } from "@kronos-ts/messaging";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,GAE/B,MAAM,iCAAiC,CAAA;AAExC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAElD,OAAO,EAAE,qCAAqC,EAAE,MAAM,yCAAyC,CAAA;AAE/F,gDAAgD;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,GAE/B,MAAM,iCAAiC,CAAA;AAExC,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAExE,OAAO,EACL,kCAAkC,GAEnC,MAAM,qCAAqC,CAAA;AAE5C,OAAO,EAAE,qCAAqC,EAAE,MAAM,yCAAyC,CAAA;AAE/F,gDAAgD;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/opentelemetry-metrics-recorder.d.ts

@@ -0,0 +1,17 @@
+import { type Meter } from "@opentelemetry/api";
+import type { MetricsRecorder } from "@kronos-ts/messaging";
+export interface OpenTelemetryMetricsRecorderOptions {
+    /** Meter to create instruments from. Defaults to `metrics.getMeter("kronos-framework")`. */
+    meter?: Meter;
+}
+/**
+ * MetricsRecorder implementation backed by the OpenTelemetry Metrics API.
+ *
+ * Instruments are created lazily on the configured Meter; the OTel SDK
+ * deduplicates instruments by name, so repeated `counter`/`histogram` calls for
+ * the same name write to the same series. As with the span factory, you need an
+ * OpenTelemetry MeterProvider configured (e.g. via the OTel SDK or java agent)
+ * for measurements to be exported — otherwise this is effectively a no-op.
+ */
+export declare function createOpenTelemetryMetricsRecorder(options?: OpenTelemetryMetricsRecorderOptions): MetricsRecorder;
+//# sourceMappingURL=opentelemetry-metrics-recorder.d.ts.map

package/dist/opentelemetry-metrics-recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opentelemetry-metrics-recorder.d.ts","sourceRoot":"","sources":["../src/opentelemetry-metrics-recorder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,KAAK,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,KAAK,EACV,eAAe,EAIhB,MAAM,sBAAsB,CAAA;AAE7B,MAAM,WAAW,mCAAmC;IAClD,4FAA4F;IAC5F,KAAK,CAAC,EAAE,KAAK,CAAA;CACd;AAED;;;;;;;;GAQG;AACH,wBAAgB,kCAAkC,CAChD,OAAO,GAAE,mCAAwC,GAChD,eAAe,CA2BjB"}

package/dist/opentelemetry-metrics-recorder.js

@@ -0,0 +1,38 @@
+import { metrics } from "@opentelemetry/api";
+/**
+ * MetricsRecorder implementation backed by the OpenTelemetry Metrics API.
+ *
+ * Instruments are created lazily on the configured Meter; the OTel SDK
+ * deduplicates instruments by name, so repeated `counter`/`histogram` calls for
+ * the same name write to the same series. As with the span factory, you need an
+ * OpenTelemetry MeterProvider configured (e.g. via the OTel SDK or java agent)
+ * for measurements to be exported — otherwise this is effectively a no-op.
+ */
+export function createOpenTelemetryMetricsRecorder(options = {}) {
+    const meter = options.meter ?? metrics.getMeter("kronos-framework");
+    return {
+        counter(name, opts) {
+            const instrument = meter.createCounter(name, {
+                description: opts?.description,
+                unit: opts?.unit,
+            });
+            return {
+                add(value, attributes) {
+                    instrument.add(value, attributes);
+                },
+            };
+        },
+        histogram(name, opts) {
+            const instrument = meter.createHistogram(name, {
+                description: opts?.description,
+                unit: opts?.unit,
+            });
+            return {
+                record(value, attributes) {
+                    instrument.record(value, attributes);
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=opentelemetry-metrics-recorder.js.map

package/dist/opentelemetry-metrics-recorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opentelemetry-metrics-recorder.js","sourceRoot":"","sources":["../src/opentelemetry-metrics-recorder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAc,MAAM,oBAAoB,CAAA;AAaxD;;;;;;;;GAQG;AACH,MAAM,UAAU,kCAAkC,CAChD,UAA+C,EAAE;IAEjD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAA;IAEnE,OAAO;QACL,OAAO,CAAC,IAAY,EAAE,IAAwB;YAC5C,MAAM,UAAU,GAAG,KAAK,CAAC,aAAa,CAAC,IAAI,EAAE;gBAC3C,WAAW,EAAE,IAAI,EAAE,WAAW;gBAC9B,IAAI,EAAE,IAAI,EAAE,IAAI;aACjB,CAAC,CAAA;YACF,OAAO;gBACL,GAAG,CAAC,KAAK,EAAE,UAAU;oBACnB,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,UAAU,CAAC,CAAA;gBACnC,CAAC;aACF,CAAA;QACH,CAAC;QACD,SAAS,CAAC,IAAY,EAAE,IAAwB;YAC9C,MAAM,UAAU,GAAG,KAAK,CAAC,eAAe,CAAC,IAAI,EAAE;gBAC7C,WAAW,EAAE,IAAI,EAAE,WAAW;gBAC9B,IAAI,EAAE,IAAI,EAAE,IAAI;aACjB,CAAC,CAAA;YACF,OAAO;gBACL,MAAM,CAAC,KAAK,EAAE,UAAU;oBACtB,UAAU,CAAC,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,CAAA;gBACtC,CAAC;aACF,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/opentelemetry-span-factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"opentelemetry-span-factory.d.ts","sourceRoot":"","sources":["../src/opentelemetry-span-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,MAAM,EAIZ,MAAM,oBAAoB,CAAA;AAG3B,OAAO,KAAK,EAAQ,WAAW,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAgDrF,MAAM,WAAW,+BAA+B;IAC9C,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,uCAAuC;IACvC,sBAAsB,CAAC,EAAE,sBAAsB,EAAE,CAAA;CAClD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,GAAE,+BAAoC,GAC5C,WAAW,CAgFb"}
+{"version":3,"file":"opentelemetry-span-factory.d.ts","sourceRoot":"","sources":["../src/opentelemetry-span-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,MAAM,EAIZ,MAAM,oBAAoB,CAAA;AAG3B,OAAO,KAAK,EAAQ,WAAW,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAuDrF,MAAM,WAAW,+BAA+B;IAC9C,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,uCAAuC;IACvC,sBAAsB,CAAC,EAAE,sBAAsB,EAAE,CAAA;CAClD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,GAAE,+BAAoC,GAC5C,WAAW,CAyGb"}

package/dist/opentelemetry-span-factory.js

@@ -19,7 +19,7 @@ const metadataSetter = {
 // ---------------------------------------------------------------------------
 // OpenTelemetry Span wrapper
 // ---------------------------------------------------------------------------
-function wrapOtelSpan(otelSpan, parentContext) {
+function wrapOtelSpan(otelSpan, _parentContext) {
     return {
         start() {
             // OTel spans are started at creation — nothing to do
@@ -34,6 +34,13 @@ function wrapOtelSpan(otelSpan, parentContext) {
             otelSpan.setStatus({ code: SpanStatusCode.ERROR, message: error.message });
             otelSpan.end();
         },
+        runActive(fn) {
+            // Make this span the active context for the duration of `fn`. With the
+            // AsyncLocalStorage context manager the span stays active across awaits in
+            // an async `fn`, so propagateContext / currentTraceContext and any child
+            // spans created during handling parent to it.
+            return context.with(trace.setSpan(context.active(), otelSpan), fn);
+        },
     };
 }
 /**
@@ -78,6 +85,20 @@ export function createOpenTelemetrySpanFactory(options = {}) {
             addMessageAttributes(otelSpan, parentMessage);
             return wrapOtelSpan(otelSpan, parentContext);
         },
+        createLinkedHandlerSpan(operationName, parentMessage) {
+            // New trace (root), linked to the parent message's span rather than
+            // parented to it — the originating trace may be long finished by the time
+            // an asynchronous processor handles the event.
+            const parentContext = extractContext(parentMessage);
+            const parentSpanContext = trace.getSpanContext(parentContext);
+            const otelSpan = tracer.startSpan(operationName, {
+                kind: SpanKind.CONSUMER,
+                root: true,
+                links: parentSpanContext ? [{ context: parentSpanContext }] : [],
+            });
+            addMessageAttributes(otelSpan, parentMessage);
+            return wrapOtelSpan(otelSpan, parentContext);
+        },
         createDispatchSpan(operationName, parentMessage) {
             const parentContext = extractContext(parentMessage);
             const otelSpan = tracer.startSpan(operationName, { kind: SpanKind.PRODUCER }, parentContext);
@@ -101,6 +122,11 @@ export function createOpenTelemetrySpanFactory(options = {}) {
                 metadata: { ...message.metadata, ...additionalMetadata },
             };
         },
+        currentTraceContext() {
+            const carrier = {};
+            propagation.inject(context.active(), carrier, metadataSetter);
+            return carrier;
+        },
         registerSpanAttributeProvider(provider) {
             attributeProviders.push(provider);
         },

package/dist/opentelemetry-span-factory.js.map

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

package/dist/opentelemetry.d.ts

@@ -1,5 +1,7 @@
 import type { App } from "@kronos-ts/app";
+import { type MeteringOptions } from "@kronos-ts/messaging";
 import { type OpenTelemetrySpanFactoryOptions } from "./opentelemetry-span-factory.js";
+import { type OpenTelemetryMetricsRecorderOptions } from "./opentelemetry-metrics-recorder.js";
 /**
  * OpenTelemetry tracing extension for Kronos.
  *
@@ -33,4 +35,25 @@ import { type OpenTelemetrySpanFactoryOptions } from "./opentelemetry-span-facto
  * ```
  */
 export declare function openTelemetry(options?: OpenTelemetrySpanFactoryOptions): (app: App) => void;
+/**
+ * OpenTelemetry metrics extension for Kronos.
+ *
+ * Wires a metering handler enhancer (via `app.handlerEnhancer(...)`) that
+ * records throughput, latency, error rate, and event-processing lag for every
+ * command/query/event handler invocation, using the OpenTelemetry Metrics API.
+ *
+ * Compose independently of (and alongside) {@link openTelemetry}:
+ *
+ * @example
+ * ```typescript
+ * await kronos()
+ *   .use(openTelemetry())        // tracing
+ *   .use(openTelemetryMetrics()) // metrics
+ *   .start()
+ * ```
+ *
+ * Requires an OpenTelemetry MeterProvider to be configured for measurements to
+ * be exported; without one this is effectively a no-op.
+ */
+export declare function openTelemetryMetrics(options?: OpenTelemetryMetricsRecorderOptions & MeteringOptions): (app: App) => void;
 //# sourceMappingURL=opentelemetry.d.ts.map

package/dist/opentelemetry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"opentelemetry.d.ts","sourceRoot":"","sources":["../src/opentelemetry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAA;AAKzC,OAAO,EAEL,KAAK,+BAA+B,EACrC,MAAM,iCAAiC,CAAA;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,aAAa,CAC3B,OAAO,GAAE,+BAAoC,GAC5C,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,CAQpB"}
+{"version":3,"file":"opentelemetry.d.ts","sourceRoot":"","sources":["../src/opentelemetry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAEL,KAAK,+BAA+B,EACrC,MAAM,iCAAiC,CAAA;AACxC,OAAO,EAEL,KAAK,mCAAmC,EACzC,MAAM,qCAAqC,CAAA;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,aAAa,CAC3B,OAAO,GAAE,+BAAoC,GAC5C,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,CAQpB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,GAAE,mCAAmC,GAAG,eAAoB,GAClE,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,CAKpB"}

package/dist/opentelemetry.js

@@ -1,5 +1,6 @@
-import { createTracingCommandBus, tracingHandlerEnhancerDefinition, } from "@kronos-ts/messaging";
+import { createTracingCommandBus, tracingHandlerEnhancerDefinition, meteringHandlerEnhancerDefinition, } from "@kronos-ts/messaging";
 import { createOpenTelemetrySpanFactory, } from "./opentelemetry-span-factory.js";
+import { createOpenTelemetryMetricsRecorder, } from "./opentelemetry-metrics-recorder.js";
 /**
  * OpenTelemetry tracing extension for Kronos.
  *
@@ -39,4 +40,30 @@ export function openTelemetry(options = {}) {
         app.handlerEnhancer(tracingHandlerEnhancerDefinition(spanFactory));
     };
 }
+/**
+ * OpenTelemetry metrics extension for Kronos.
+ *
+ * Wires a metering handler enhancer (via `app.handlerEnhancer(...)`) that
+ * records throughput, latency, error rate, and event-processing lag for every
+ * command/query/event handler invocation, using the OpenTelemetry Metrics API.
+ *
+ * Compose independently of (and alongside) {@link openTelemetry}:
+ *
+ * @example
+ * ```typescript
+ * await kronos()
+ *   .use(openTelemetry())        // tracing
+ *   .use(openTelemetryMetrics()) // metrics
+ *   .start()
+ * ```
+ *
+ * Requires an OpenTelemetry MeterProvider to be configured for measurements to
+ * be exported; without one this is effectively a no-op.
+ */
+export function openTelemetryMetrics(options = {}) {
+    return (app) => {
+        const recorder = createOpenTelemetryMetricsRecorder(options);
+        app.handlerEnhancer(meteringHandlerEnhancerDefinition(recorder, options));
+    };
+}
 //# sourceMappingURL=opentelemetry.js.map

package/dist/opentelemetry.js.map

@@ -1 +1 @@
-{"version":3,"file":"opentelemetry.js","sourceRoot":"","sources":["../src/opentelemetry.ts"],"names":[],"mappings":"AACA,OAAO,EACL,uBAAuB,EACvB,gCAAgC,GACjC,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,8BAA8B,GAE/B,MAAM,iCAAiC,CAAA;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,UAAU,aAAa,CAC3B,UAA2C,EAAE;IAE7C,OAAO,CAAC,GAAG,EAAE,EAAE;QACb,MAAM,WAAW,GAAG,8BAA8B,CAAC,OAAO,CAAC,CAAA;QAC3D,GAAG,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC,QAAQ,EAAE,EAAE,CACtC,uBAAuB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAC/C,CAAA;QACD,GAAG,CAAC,eAAe,CAAC,gCAAgC,CAAC,WAAW,CAAC,CAAC,CAAA;IACpE,CAAC,CAAA;AACH,CAAC"}
+{"version":3,"file":"opentelemetry.js","sourceRoot":"","sources":["../src/opentelemetry.ts"],"names":[],"mappings":"AACA,OAAO,EACL,uBAAuB,EACvB,gCAAgC,EAChC,iCAAiC,GAElC,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,8BAA8B,GAE/B,MAAM,iCAAiC,CAAA;AACxC,OAAO,EACL,kCAAkC,GAEnC,MAAM,qCAAqC,CAAA;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,UAAU,aAAa,CAC3B,UAA2C,EAAE;IAE7C,OAAO,CAAC,GAAG,EAAE,EAAE;QACb,MAAM,WAAW,GAAG,8BAA8B,CAAC,OAAO,CAAC,CAAA;QAC3D,GAAG,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC,QAAQ,EAAE,EAAE,CACtC,uBAAuB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAC/C,CAAA;QACD,GAAG,CAAC,eAAe,CAAC,gCAAgC,CAAC,WAAW,CAAC,CAAC,CAAA;IACpE,CAAC,CAAA;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,oBAAoB,CAClC,UAAiE,EAAE;IAEnE,OAAO,CAAC,GAAG,EAAE,EAAE;QACb,MAAM,QAAQ,GAAG,kCAAkC,CAAC,OAAO,CAAC,CAAA;QAC5D,GAAG,CAAC,eAAe,CAAC,iCAAiC,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAA;IAC3E,CAAC,CAAA;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kronos-ts/opentelemetry",
-  "version": "0.2.2",
+  "version": "0.4.0",
   "description": "OpenTelemetry extension for Kronos — tracing for commands and events.",
   "license": "Apache-2.0",
   "type": "module",
@@ -50,13 +50,13 @@
   },
   "dependencies": {
     "@kronos-ts/common": "0.1.1",
-    "@kronos-ts/app": "0.3.4",
-    "@kronos-ts/messaging": "0.5.1",
+    "@kronos-ts/app": "0.4.1",
+    "@kronos-ts/messaging": "0.7.0",
     "@opentelemetry/api": "^1.9"
   },
   "devDependencies": {
-    "@kronos-ts/eventsourcing": "0.2.1",
-    "@kronos-ts/modelling": "0.2.4",
+    "@kronos-ts/eventsourcing": "0.2.3",
+    "@kronos-ts/modelling": "0.2.6",
     "@opentelemetry/sdk-trace-base": "^1.30.0",
     "@opentelemetry/sdk-trace-node": "^1.30.0",
     "zod": "^4.3.6"

package/src/index.ts

@@ -3,7 +3,12 @@ export {
   type OpenTelemetrySpanFactoryOptions,
 } from "./opentelemetry-span-factory.js"
 
-export { openTelemetry } from "./opentelemetry.js"
+export { openTelemetry, openTelemetryMetrics } from "./opentelemetry.js"
+
+export {
+  createOpenTelemetryMetricsRecorder,
+  type OpenTelemetryMetricsRecorderOptions,
+} from "./opentelemetry-metrics-recorder.js"
 
 export { createOpenTelemetryDeadLetterListener } from "./opentelemetry-dead-letter-listener.js"
 

package/src/opentelemetry-metrics-recorder.ts

@@ -0,0 +1,52 @@
+import { metrics, type Meter } from "@opentelemetry/api"
+import type {
+  MetricsRecorder,
+  Counter,
+  Histogram,
+  InstrumentOptions,
+} from "@kronos-ts/messaging"
+
+export interface OpenTelemetryMetricsRecorderOptions {
+  /** Meter to create instruments from. Defaults to `metrics.getMeter("kronos-framework")`. */
+  meter?: Meter
+}
+
+/**
+ * MetricsRecorder implementation backed by the OpenTelemetry Metrics API.
+ *
+ * Instruments are created lazily on the configured Meter; the OTel SDK
+ * deduplicates instruments by name, so repeated `counter`/`histogram` calls for
+ * the same name write to the same series. As with the span factory, you need an
+ * OpenTelemetry MeterProvider configured (e.g. via the OTel SDK or java agent)
+ * for measurements to be exported — otherwise this is effectively a no-op.
+ */
+export function createOpenTelemetryMetricsRecorder(
+  options: OpenTelemetryMetricsRecorderOptions = {},
+): MetricsRecorder {
+  const meter = options.meter ?? metrics.getMeter("kronos-framework")
+
+  return {
+    counter(name: string, opts?: InstrumentOptions): Counter {
+      const instrument = meter.createCounter(name, {
+        description: opts?.description,
+        unit: opts?.unit,
+      })
+      return {
+        add(value, attributes) {
+          instrument.add(value, attributes)
+        },
+      }
+    },
+    histogram(name: string, opts?: InstrumentOptions): Histogram {
+      const instrument = meter.createHistogram(name, {
+        description: opts?.description,
+        unit: opts?.unit,
+      })
+      return {
+        record(value, attributes) {
+          instrument.record(value, attributes)
+        },
+      }
+    },
+  }
+}

package/src/opentelemetry-span-factory.ts

@@ -37,7 +37,7 @@ const metadataSetter: TextMapSetter<Record<string, unknown>> = {
 // OpenTelemetry Span wrapper
 // ---------------------------------------------------------------------------
 
-function wrapOtelSpan(otelSpan: import("@opentelemetry/api").Span, parentContext: OtelContext): Span {
+function wrapOtelSpan(otelSpan: import("@opentelemetry/api").Span, _parentContext: OtelContext): Span {
   return {
     start() {
       // OTel spans are started at creation — nothing to do
@@ -52,6 +52,13 @@ function wrapOtelSpan(otelSpan: import("@opentelemetry/api").Span, parentContext
       otelSpan.setStatus({ code: SpanStatusCode.ERROR, message: error.message })
       otelSpan.end()
     },
+    runActive<T>(fn: () => T): T {
+      // Make this span the active context for the duration of `fn`. With the
+      // AsyncLocalStorage context manager the span stays active across awaits in
+      // an async `fn`, so propagateContext / currentTraceContext and any child
+      // spans created during handling parent to it.
+      return context.with(trace.setSpan(context.active(), otelSpan), fn)
+    },
   }
 }
 
@@ -123,6 +130,21 @@ export function createOpenTelemetrySpanFactory(
       return wrapOtelSpan(otelSpan, parentContext)
     },
 
+    createLinkedHandlerSpan(operationName: string, parentMessage: Message): Span {
+      // New trace (root), linked to the parent message's span rather than
+      // parented to it — the originating trace may be long finished by the time
+      // an asynchronous processor handles the event.
+      const parentContext = extractContext(parentMessage)
+      const parentSpanContext = trace.getSpanContext(parentContext)
+      const otelSpan = tracer.startSpan(operationName, {
+        kind: SpanKind.CONSUMER,
+        root: true,
+        links: parentSpanContext ? [{ context: parentSpanContext }] : [],
+      })
+      addMessageAttributes(otelSpan, parentMessage)
+      return wrapOtelSpan(otelSpan, parentContext)
+    },
+
     createDispatchSpan(operationName: string, parentMessage: Message): Span {
       const parentContext = extractContext(parentMessage)
       const otelSpan = tracer.startSpan(
@@ -155,6 +177,16 @@ export function createOpenTelemetrySpanFactory(
       }
     },
 
+    currentTraceContext(): Record<string, string> {
+      const carrier: Record<string, string> = {}
+      propagation.inject(
+        context.active(),
+        carrier,
+        metadataSetter as TextMapSetter<Record<string, string>>,
+      )
+      return carrier
+    },
+
     registerSpanAttributeProvider(provider: SpanAttributesProvider) {
       attributeProviders.push(provider)
     },

package/src/opentelemetry.ts

@@ -2,11 +2,17 @@ import type { App } from "@kronos-ts/app"
 import {
   createTracingCommandBus,
   tracingHandlerEnhancerDefinition,
+  meteringHandlerEnhancerDefinition,
+  type MeteringOptions,
 } from "@kronos-ts/messaging"
 import {
   createOpenTelemetrySpanFactory,
   type OpenTelemetrySpanFactoryOptions,
 } from "./opentelemetry-span-factory.js"
+import {
+  createOpenTelemetryMetricsRecorder,
+  type OpenTelemetryMetricsRecorderOptions,
+} from "./opentelemetry-metrics-recorder.js"
 
 /**
  * OpenTelemetry tracing extension for Kronos.
@@ -51,3 +57,32 @@ export function openTelemetry(
     app.handlerEnhancer(tracingHandlerEnhancerDefinition(spanFactory))
   }
 }
+
+/**
+ * OpenTelemetry metrics extension for Kronos.
+ *
+ * Wires a metering handler enhancer (via `app.handlerEnhancer(...)`) that
+ * records throughput, latency, error rate, and event-processing lag for every
+ * command/query/event handler invocation, using the OpenTelemetry Metrics API.
+ *
+ * Compose independently of (and alongside) {@link openTelemetry}:
+ *
+ * @example
+ * ```typescript
+ * await kronos()
+ *   .use(openTelemetry())        // tracing
+ *   .use(openTelemetryMetrics()) // metrics
+ *   .start()
+ * ```
+ *
+ * Requires an OpenTelemetry MeterProvider to be configured for measurements to
+ * be exported; without one this is effectively a no-op.
+ */
+export function openTelemetryMetrics(
+  options: OpenTelemetryMetricsRecorderOptions & MeteringOptions = {},
+): (app: App) => void {
+  return (app) => {
+    const recorder = createOpenTelemetryMetricsRecorder(options)
+    app.handlerEnhancer(meteringHandlerEnhancerDefinition(recorder, options))
+  }
+}