@ue-shed/observability 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 UE Shed 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.

package/README.md

@@ -0,0 +1,15 @@
+# `@ue-shed/observability`
+
+Shared, headless OpenTelemetry composition, bounded runtime metrics, and schema-owned health for UE
+Shed hosts. Applications provide `runtimeObservabilityLayer` once at their root. Local use does not
+require an exporter; set `UE_SHED_TELEMETRY_MODE=console` to emit local traces, metrics, and logs.
+
+```sh
+npm install --save-exact @ue-shed/observability
+```
+
+`RuntimeHealthService` is the diagnostic authority for CLI and UI clients. Consumers report typed
+capability, connection, reader, stream, and telemetry state rather than parsing logs.
+
+Node.js 22.14 or newer is required. This is a headless Node-host package; it does not depend on
+Workbench, Electron, or any Unreal plugin.

package/dist/health.d.ts

@@ -0,0 +1,56 @@
+import { Context, Effect, Layer, Schema } from "effect";
+export declare const CapabilityHealth: Schema.Struct<{
+    readonly available: Schema.Boolean;
+    readonly name: Schema.String;
+    readonly required: Schema.Boolean;
+}>;
+export interface CapabilityHealth extends Schema.Schema.Type<typeof CapabilityHealth> {
+}
+export declare const RuntimeHealthInput: Schema.Struct<{
+    readonly capabilities: Schema.$Array<Schema.Struct<{
+        readonly available: Schema.Boolean;
+        readonly name: Schema.String;
+        readonly required: Schema.Boolean;
+    }>>;
+    readonly connection: Schema.Literals<readonly ["not_configured", "connected", "reconnecting", "failed"]>;
+    readonly reader: Schema.Literals<readonly ["not_configured", "ready", "failed"]>;
+    readonly stream: Schema.Struct<{
+        readonly drops: Schema.Number;
+        readonly gaps: Schema.Number;
+        readonly queueDepth: Schema.Number;
+    }>;
+    readonly telemetry: Schema.Literals<readonly ["disabled", "ready", "degraded"]>;
+}>;
+export interface RuntimeHealthInput extends Schema.Schema.Type<typeof RuntimeHealthInput> {
+}
+export declare const RuntimeHealth: Schema.Struct<{
+    readonly reasons: Schema.$Array<Schema.String>;
+    readonly status: Schema.Literals<readonly ["healthy", "degraded", "unhealthy"]>;
+    readonly capabilities: Schema.$Array<Schema.Struct<{
+        readonly available: Schema.Boolean;
+        readonly name: Schema.String;
+        readonly required: Schema.Boolean;
+    }>>;
+    readonly connection: Schema.Literals<readonly ["not_configured", "connected", "reconnecting", "failed"]>;
+    readonly reader: Schema.Literals<readonly ["not_configured", "ready", "failed"]>;
+    readonly stream: Schema.Struct<{
+        readonly drops: Schema.Number;
+        readonly gaps: Schema.Number;
+        readonly queueDepth: Schema.Number;
+    }>;
+    readonly telemetry: Schema.Literals<readonly ["disabled", "ready", "degraded"]>;
+}>;
+export interface RuntimeHealth extends Schema.Schema.Type<typeof RuntimeHealth> {
+}
+export declare const defaultHealthInput: RuntimeHealthInput;
+export declare function aggregateHealth(input: RuntimeHealthInput): RuntimeHealth;
+export interface RuntimeHealthServiceShape {
+    readonly report: (input: RuntimeHealthInput) => Effect.Effect<RuntimeHealth>;
+    readonly snapshot: () => Effect.Effect<RuntimeHealth>;
+}
+declare const RuntimeHealthService_base: Context.ServiceClass<RuntimeHealthService, "@ue-shed/observability/RuntimeHealthService", RuntimeHealthServiceShape>;
+export declare class RuntimeHealthService extends RuntimeHealthService_base {
+}
+export declare function runtimeHealthLayer(initial?: RuntimeHealthInput): Layer.Layer<RuntimeHealthService>;
+export {};
+//# sourceMappingURL=health.d.ts.map

package/dist/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../src/health.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAO,MAAM,EAAE,MAAM,QAAQ,CAAC;AAE7D,eAAO,MAAM,gBAAgB;;;;EAI3B,CAAC;AACH,MAAM,WAAW,gBAAiB,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,gBAAgB,CAAC;CAAG;AAExF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;EAU7B,CAAC;AACH,MAAM,WAAW,kBAAmB,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,kBAAkB,CAAC;CAAG;AAE5F,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;EAIxB,CAAC;AACH,MAAM,WAAW,aAAc,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,aAAa,CAAC;CAAG;AAElF,eAAO,MAAM,kBAAkB,EAAE,kBAMhC,CAAC;AAEF,wBAAgB,eAAe,CAAC,KAAK,EAAE,kBAAkB,GAAG,aAAa,CAsBxE;AAED,MAAM,WAAW,yBAAyB;IACzC,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAC7E,QAAQ,CAAC,QAAQ,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;CACtD;;AAED,qBAAa,oBAAqB,SAAQ,yBAGQ;CAAG;AAErD,wBAAgB,kBAAkB,CACjC,OAAO,GAAE,kBAAuC,GAC9C,KAAK,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAenC"}

package/dist/health.js

@@ -0,0 +1,58 @@
+import { Context, Effect, Layer, Ref, Schema } from "effect";
+export const CapabilityHealth = Schema.Struct({
+    available: Schema.Boolean,
+    name: Schema.String,
+    required: Schema.Boolean
+});
+export const RuntimeHealthInput = Schema.Struct({
+    capabilities: Schema.Array(CapabilityHealth),
+    connection: Schema.Literals(["not_configured", "connected", "reconnecting", "failed"]),
+    reader: Schema.Literals(["not_configured", "ready", "failed"]),
+    stream: Schema.Struct({
+        drops: Schema.Number,
+        gaps: Schema.Number,
+        queueDepth: Schema.Number
+    }),
+    telemetry: Schema.Literals(["disabled", "ready", "degraded"])
+});
+export const RuntimeHealth = Schema.Struct({
+    ...RuntimeHealthInput.fields,
+    reasons: Schema.Array(Schema.String),
+    status: Schema.Literals(["healthy", "degraded", "unhealthy"])
+});
+export const defaultHealthInput = {
+    capabilities: [],
+    connection: "not_configured",
+    reader: "not_configured",
+    stream: { drops: 0, gaps: 0, queueDepth: 0 },
+    telemetry: "disabled"
+};
+export function aggregateHealth(input) {
+    const missingRequired = input.capabilities.filter((capability) => capability.required && !capability.available);
+    const reasons = [
+        ...missingRequired.map((capability) => `Required capability unavailable: ${capability.name}`),
+        ...(input.connection === "failed" ? ["Connection failed"] : []),
+        ...(input.connection === "reconnecting" ? ["Connection is reconnecting"] : []),
+        ...(input.reader === "failed" ? ["Saved-asset reader failed"] : []),
+        ...(input.telemetry === "degraded" ? ["Telemetry export is degraded"] : []),
+        ...(input.stream.gaps > 0 ? [`Stream reported ${input.stream.gaps} gap(s)`] : []),
+        ...(input.stream.drops > 0 ? [`Stream reported ${input.stream.drops} drop(s)`] : [])
+    ];
+    const unhealthy = missingRequired.length > 0 || input.connection === "failed" || input.reader === "failed";
+    return {
+        ...input,
+        reasons,
+        status: unhealthy ? "unhealthy" : reasons.length > 0 ? "degraded" : "healthy"
+    };
+}
+export class RuntimeHealthService extends Context.Service()("@ue-shed/observability/RuntimeHealthService") {
+}
+export function runtimeHealthLayer(initial = defaultHealthInput) {
+    return Layer.effect(RuntimeHealthService, Effect.gen(function* () {
+        const state = yield* Ref.make(aggregateHealth(initial));
+        const report = Effect.fn("Observability.RuntimeHealth.report")((input) => Ref.set(state, aggregateHealth(input)).pipe(Effect.as(aggregateHealth(input))));
+        const snapshot = Effect.fn("Observability.RuntimeHealth.snapshot")(() => Ref.get(state));
+        return RuntimeHealthService.of({ report, snapshot });
+    }));
+}
+//# sourceMappingURL=health.js.map

package/dist/health.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,82 @@
+import type { SpanProcessor } from "@opentelemetry/sdk-trace-base";
+import { Config, Effect, Layer, Metric, Schema } from "effect";
+export * from "./health.js";
+export declare const TelemetryMode: Schema.Literals<readonly ["disabled", "console"]>;
+export type TelemetryMode = typeof TelemetryMode.Type;
+export declare const queueDepth: Metric.Gauge<number>;
+export declare const streamDrops: Metric.Counter<number>;
+export declare const streamGaps: Metric.Counter<number>;
+export declare const cameraReplacements: Metric.Counter<number>;
+export declare const authoringTransitions: Metric.Frequency;
+export declare const coverage: Metric.Gauge<number>;
+export declare const observatoryMetrics: {
+    actorsChanged: Metric.Counter<number>;
+    actorsSampled: Metric.Counter<number>;
+    boundsCalculations: Metric.Counter<number>;
+    bytes: Metric.Counter<number>;
+    catalogDuration: Metric.Histogram<number>;
+    decodeApplyDuration: Metric.Histogram<number>;
+    ipcReplacements: Metric.Counter<number>;
+    packets: Metric.Counter<number>;
+    paintDuration: Metric.Histogram<number>;
+    presentationHz: Metric.Gauge<number>;
+    producerReplacements: Metric.Counter<number>;
+    receiverReplacements: Metric.Counter<number>;
+    sampleHz: Metric.Gauge<number>;
+    sequenceGaps: Metric.Counter<number>;
+};
+export declare const reviewAssessmentMetrics: {
+    attempts: Metric.Counter<number>;
+    duration: Metric.Histogram<number>;
+    failures: Metric.Counter<number>;
+    samples: Metric.Histogram<number>;
+};
+export declare const operationMetrics: {
+    errors: Metric.Counter<number>;
+    latency: Metric.Histogram<number>;
+    traffic: Metric.Counter<number>;
+};
+export declare function recordStreamState(state: {
+    readonly drops: number;
+    readonly gaps: number;
+    readonly queueDepth: number;
+}): Effect.Effect<void>;
+export declare const recordCameraReplacements: (count: number) => Effect.Effect<void>;
+export declare const recordAuthoringTransition: (transition: string) => Effect.Effect<void>;
+export declare const recordCoverage: (ratio: number) => Effect.Effect<void>;
+export declare function recordObservatoryCatalog(input: {
+    readonly boundsCalculations: number;
+    readonly durationMs: number;
+}): Effect.Effect<void>;
+export declare function recordObservatoryPacket(input: {
+    readonly actorsChanged: number;
+    readonly actorsSampled: number;
+    readonly bytes: number;
+    readonly decodeApplyMs: number;
+    readonly producerReplacements?: number;
+    readonly sequenceGap?: boolean;
+}): Effect.Effect<void>;
+export declare const recordObservatoryReceiverReplacements: (count: number) => Effect.Effect<void>;
+export declare const recordObservatoryIpcReplacements: (count: number) => Effect.Effect<void>;
+export declare const recordObservatoryPaintDuration: (durationMs: number) => Effect.Effect<void>;
+export declare function recordObservatoryCadence(input: {
+    readonly presentationHz?: number;
+    readonly sampleHz?: number;
+}): Effect.Effect<void>;
+/**
+ * Aggregates only bounded assessment facts. Callers must not attach actor, view, operation, map,
+ * artifact, or filesystem identity to these metrics.
+ */
+export declare function recordReviewAssessment(input: {
+    readonly assessmentDurationMs?: number;
+    readonly sampleCount?: number;
+    readonly status: "assessed" | "assessment_failed" | "not_assessed";
+}): Effect.Effect<void>;
+export declare function observeOperation<A, E, R>(name: string, effect: Effect.Effect<A, E, R>): Effect.Effect<A, E, R>;
+export interface RuntimeObservabilityOptions {
+    readonly serviceName: string;
+    readonly serviceVersion?: string;
+    readonly spanProcessor?: SpanProcessor;
+}
+export declare function runtimeObservabilityLayer(options: RuntimeObservabilityOptions): Layer.Layer<import("./health.js").RuntimeHealthService, Config.ConfigError, never>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAQ,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGrE,cAAc,aAAa,CAAC;AAE5B,eAAO,MAAM,aAAa,mDAA2C,CAAC;AACtE,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC,IAAI,CAAC;AActD,eAAO,MAAM,UAAU,sBAErB,CAAC;AACH,eAAO,MAAM,WAAW,wBAGtB,CAAC;AACH,eAAO,MAAM,UAAU,wBAGrB,CAAC;AACH,eAAO,MAAM,kBAAkB,wBAG7B,CAAC;AACH,eAAO,MAAM,oBAAoB,kBAE/B,CAAC;AACH,eAAO,MAAM,QAAQ,sBAEnB,CAAC;AAqFH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;CAe9B,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;;;CAKnC,CAAC;AAEF,eAAO,MAAM,gBAAgB;;;;CAI5B,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC5B,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAMtB;AAED,eAAO,MAAM,wBAAwB,GAAI,OAAO,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAClC,CAAC;AAE1C,eAAO,MAAM,yBAAyB,GAAI,YAAY,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CACjC,CAAC;AAEjD,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CACR,CAAC;AAE1D,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC/C,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC5B,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAKtB;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC9C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;CAC/B,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAatB;AAED,eAAO,MAAM,qCAAqC,GAAI,OAAO,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CACrB,CAAC;AAEpE,eAAO,MAAM,gCAAgC,GAAI,OAAO,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CACrB,CAAC;AAE/D,eAAO,MAAM,8BAA8B,GAAI,YAAY,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CACrB,CAAC;AAElE,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC/C,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC3B,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAStB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC7C,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,mBAAmB,GAAG,cAAc,CAAC;CACnE,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CActB;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EACvC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAC5B,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAUxB;AAMD,MAAM,WAAW,2BAA2B;IAC3C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC;CACvC;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,2BAA2B,sFAiB7E"}

package/dist/index.js

@@ -0,0 +1,221 @@
+import { Config, Effect, Exit, Layer, Metric, Schema } from "effect";
+import { defaultHealthInput, runtimeHealthLayer } from "./health.js";
+export * from "./health.js";
+export const TelemetryMode = Schema.Literals(["disabled", "console"]);
+const operationTraffic = Metric.counter("ue_shed_operation_total", {
+    description: "Completed UE Shed runtime operations",
+    incremental: true
+});
+const operationErrors = Metric.counter("ue_shed_operation_error_total", {
+    description: "Failed UE Shed runtime operations",
+    incremental: true
+});
+const operationLatency = Metric.histogram("ue_shed_operation_duration_ms", {
+    boundaries: [1, 5, 10, 25, 50, 100, 250, 500, 1_000, 5_000, 30_000],
+    description: "UE Shed operation duration in milliseconds"
+});
+export const queueDepth = Metric.gauge("ue_shed_queue_depth", {
+    description: "Current bounded queue depth"
+});
+export const streamDrops = Metric.counter("ue_shed_stream_drop_total", {
+    description: "Dropped stream items",
+    incremental: true
+});
+export const streamGaps = Metric.counter("ue_shed_stream_gap_total", {
+    description: "Detected stream gaps",
+    incremental: true
+});
+export const cameraReplacements = Metric.counter("ue_shed_camera_replacement_total", {
+    description: "Camera frames replaced by bounded delivery",
+    incremental: true
+});
+export const authoringTransitions = Metric.frequency("ue_shed_authoring_transition_total", {
+    description: "Apply and Save authority transition outcomes"
+});
+export const coverage = Metric.gauge("ue_shed_coverage_ratio", {
+    description: "Domain coverage ratio from zero to one"
+});
+const observatoryCatalogDuration = Metric.histogram("ue_shed_observatory_catalog_duration_ms", {
+    boundaries: [1, 5, 10, 25, 50, 100, 250, 500, 1_000, 5_000],
+    description: "Unreal catalog collection duration in milliseconds"
+});
+const observatoryBoundsCalculations = Metric.counter("ue_shed_observatory_bounds_calculations_total", {
+    description: "Actor bounds calculations performed during catalog collection",
+    incremental: true
+});
+const observatoryActorsSampled = Metric.counter("ue_shed_observatory_actors_sampled_total", {
+    description: "Actors sampled by the Unreal transform producer",
+    incremental: true
+});
+const observatoryActorsChanged = Metric.counter("ue_shed_observatory_actors_changed_total", {
+    description: "Actors included in changed-transform packets",
+    incremental: true
+});
+const observatoryPackets = Metric.counter("ue_shed_observatory_packets_total", {
+    description: "Decoded Observatory transform packets",
+    incremental: true
+});
+const observatoryBytes = Metric.counter("ue_shed_observatory_bytes_total", {
+    description: "Bytes received on the Observatory actor stream",
+    incremental: true
+});
+const observatorySequenceGaps = Metric.counter("ue_shed_observatory_sequence_gap_total", {
+    description: "Detected Observatory transform sequence gaps",
+    incremental: true
+});
+const observatoryProducerReplacements = Metric.counter("ue_shed_observatory_producer_replacement_total", {
+    description: "Producer-side Observatory packet replacements",
+    incremental: true
+});
+const observatoryReceiverReplacements = Metric.counter("ue_shed_observatory_receiver_replacement_total", {
+    description: "Host receiver Observatory packet replacements",
+    incremental: true
+});
+const observatoryIpcReplacements = Metric.counter("ue_shed_observatory_ipc_replacement_total", {
+    description: "Workbench IPC Observatory event replacements",
+    incremental: true
+});
+const observatoryDecodeApplyDuration = Metric.histogram("ue_shed_observatory_decode_apply_duration_ms", {
+    boundaries: [0.1, 0.25, 0.5, 1, 2, 4, 8, 16.7, 33, 50, 100],
+    description: "Decode plus retained-state apply duration in milliseconds"
+});
+const observatoryPaintDuration = Metric.histogram("ue_shed_observatory_paint_duration_ms", {
+    boundaries: [0.1, 0.25, 0.5, 1, 2, 4, 8, 16.7, 33, 50, 100],
+    description: "World Scout Canvas paint duration in milliseconds"
+});
+const observatorySampleHz = Metric.gauge("ue_shed_observatory_sample_hz", {
+    description: "Effective Observatory transform sample cadence"
+});
+const observatoryPresentationHz = Metric.gauge("ue_shed_observatory_presentation_hz", {
+    description: "Effective World Scout presentation cadence"
+});
+const reviewAssessmentAttempts = Metric.counter("ue_shed_review_assessment_total", {
+    description: "Map Review visibility assessments with bounded producer evidence",
+    incremental: true
+});
+const reviewAssessmentFailures = Metric.counter("ue_shed_review_assessment_failure_total", {
+    description: "Map Review visibility assessments without usable raw evidence",
+    incremental: true
+});
+const reviewAssessmentDuration = Metric.histogram("ue_shed_review_assessment_duration_ms", {
+    boundaries: [0.1, 0.25, 0.5, 1, 2, 4, 8, 16, 33, 50, 100, 250, 500, 1_000, 5_000],
+    description: "Unreal auxiliary visibility assessment and readback duration in milliseconds"
+});
+const reviewAssessmentSamples = Metric.histogram("ue_shed_review_assessment_samples", {
+    boundaries: [0, 1, 9, 64, 256, 1_024, 4_096, 16_384, 57_600],
+    description: "Bounded image-space or collision samples in a Map Review visibility assessment"
+});
+export const observatoryMetrics = {
+    actorsChanged: observatoryActorsChanged,
+    actorsSampled: observatoryActorsSampled,
+    boundsCalculations: observatoryBoundsCalculations,
+    bytes: observatoryBytes,
+    catalogDuration: observatoryCatalogDuration,
+    decodeApplyDuration: observatoryDecodeApplyDuration,
+    ipcReplacements: observatoryIpcReplacements,
+    packets: observatoryPackets,
+    paintDuration: observatoryPaintDuration,
+    presentationHz: observatoryPresentationHz,
+    producerReplacements: observatoryProducerReplacements,
+    receiverReplacements: observatoryReceiverReplacements,
+    sampleHz: observatorySampleHz,
+    sequenceGaps: observatorySequenceGaps
+};
+export const reviewAssessmentMetrics = {
+    attempts: reviewAssessmentAttempts,
+    duration: reviewAssessmentDuration,
+    failures: reviewAssessmentFailures,
+    samples: reviewAssessmentSamples
+};
+export const operationMetrics = {
+    errors: operationErrors,
+    latency: operationLatency,
+    traffic: operationTraffic
+};
+export function recordStreamState(state) {
+    return Effect.all([
+        Metric.update(queueDepth, state.queueDepth),
+        Metric.update(streamDrops, state.drops),
+        Metric.update(streamGaps, state.gaps)
+    ]).pipe(Effect.asVoid);
+}
+export const recordCameraReplacements = (count) => Metric.update(cameraReplacements, count);
+export const recordAuthoringTransition = (transition) => Metric.update(authoringTransitions, transition);
+export const recordCoverage = (ratio) => Metric.update(coverage, Math.max(0, Math.min(1, ratio)));
+export function recordObservatoryCatalog(input) {
+    return Effect.all([
+        Metric.update(observatoryCatalogDuration, Math.max(0, input.durationMs)),
+        Metric.update(observatoryBoundsCalculations, Math.max(0, input.boundsCalculations))
+    ]).pipe(Effect.asVoid);
+}
+export function recordObservatoryPacket(input) {
+    return Effect.all([
+        Metric.update(observatoryPackets, 1),
+        Metric.update(observatoryBytes, Math.max(0, input.bytes)),
+        Metric.update(observatoryActorsSampled, Math.max(0, input.actorsSampled)),
+        Metric.update(observatoryActorsChanged, Math.max(0, input.actorsChanged)),
+        Metric.update(observatoryDecodeApplyDuration, Math.max(0, input.decodeApplyMs)),
+        Metric.update(observatoryProducerReplacements, Math.max(0, input.producerReplacements ?? 0)),
+        Metric.update(observatorySequenceGaps, input.sequenceGap === true ? 1 : 0)
+    ]).pipe(Effect.asVoid);
+}
+export const recordObservatoryReceiverReplacements = (count) => Metric.update(observatoryReceiverReplacements, Math.max(0, count));
+export const recordObservatoryIpcReplacements = (count) => Metric.update(observatoryIpcReplacements, Math.max(0, count));
+export const recordObservatoryPaintDuration = (durationMs) => Metric.update(observatoryPaintDuration, Math.max(0, durationMs));
+export function recordObservatoryCadence(input) {
+    const updates = [];
+    if (input.sampleHz !== undefined) {
+        updates.push(Metric.update(observatorySampleHz, Math.max(0, input.sampleHz)));
+    }
+    if (input.presentationHz !== undefined) {
+        updates.push(Metric.update(observatoryPresentationHz, Math.max(0, input.presentationHz)));
+    }
+    return updates.length === 0 ? Effect.void : Effect.all(updates).pipe(Effect.asVoid);
+}
+/**
+ * Aggregates only bounded assessment facts. Callers must not attach actor, view, operation, map,
+ * artifact, or filesystem identity to these metrics.
+ */
+export function recordReviewAssessment(input) {
+    const updates = [Metric.update(reviewAssessmentAttempts, 1)];
+    if (input.status === "assessment_failed") {
+        updates.push(Metric.update(reviewAssessmentFailures, 1));
+    }
+    if (input.assessmentDurationMs !== undefined) {
+        updates.push(Metric.update(reviewAssessmentDuration, Math.max(0, input.assessmentDurationMs)));
+    }
+    if (input.sampleCount !== undefined) {
+        updates.push(Metric.update(reviewAssessmentSamples, Math.max(0, input.sampleCount)));
+    }
+    return Effect.all(updates).pipe(Effect.asVoid);
+}
+export function observeOperation(name, effect) {
+    return Effect.gen(function* () {
+        const started = yield* Effect.clockWith((clock) => clock.currentTimeMillis);
+        const exit = yield* Effect.exit(effect);
+        const finished = yield* Effect.clockWith((clock) => clock.currentTimeMillis);
+        yield* Metric.update(operationTraffic, 1);
+        yield* Metric.update(operationLatency, Math.max(0, finished - started));
+        if (Exit.isFailure(exit))
+            yield* Metric.update(operationErrors, 1);
+        return yield* exit;
+    }).pipe(Effect.withSpan(name), Effect.annotateSpans("operation", name));
+}
+const telemetryModeConfig = Config.literals(["disabled", "console"], "UE_SHED_TELEMETRY_MODE").pipe(Config.withDefault("disabled"));
+export function runtimeObservabilityLayer(options) {
+    return Layer.unwrap(Effect.gen(function* () {
+        const mode = yield* telemetryModeConfig;
+        const health = runtimeHealthLayer({
+            ...defaultHealthInput,
+            telemetry: mode === "disabled" ? "disabled" : "ready"
+        });
+        if (mode === "disabled" && options.spanProcessor === undefined) {
+            // Telemetry is fully disabled: no OpenTelemetry services are installed and the SDK
+            // modules are never loaded. Effect spans and metrics keep their in-memory behavior.
+            return Layer.merge(Layer.empty, health);
+        }
+        const { telemetrySdkLayer } = yield* Effect.promise(() => import("./telemetry-sdk.js"));
+        return Layer.merge(telemetrySdkLayer(options, mode), health);
+    }));
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/telemetry-sdk.d.ts

@@ -0,0 +1,8 @@
+import type { RuntimeObservabilityOptions, TelemetryMode } from "./index.js";
+/**
+ * OpenTelemetry SDK wiring for `runtimeObservabilityLayer`, isolated so runtimes with telemetry
+ * disabled never pay the SDK module-evaluation cost. `index.ts` imports this module lazily and
+ * only when telemetry is enabled or an explicit span processor is provided.
+ */
+export declare function telemetrySdkLayer(options: RuntimeObservabilityOptions, mode: TelemetryMode): import("effect/Layer").Layer<import("@effect/opentelemetry/Resource").Resource, never, never>;
+//# sourceMappingURL=telemetry-sdk.d.ts.map

package/dist/telemetry-sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-sdk.d.ts","sourceRoot":"","sources":["../src/telemetry-sdk.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,2BAA2B,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE7E;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,2BAA2B,EAAE,IAAI,EAAE,aAAa,iGAuB1F"}

package/dist/telemetry-sdk.js

@@ -0,0 +1,31 @@
+import { NodeSdk } from "@effect/opentelemetry";
+import { ConsoleLogRecordExporter, SimpleLogRecordProcessor } from "@opentelemetry/sdk-logs";
+import { ConsoleMetricExporter, PeriodicExportingMetricReader } from "@opentelemetry/sdk-metrics";
+import { ConsoleSpanExporter, SimpleSpanProcessor } from "@opentelemetry/sdk-trace-base";
+/**
+ * OpenTelemetry SDK wiring for `runtimeObservabilityLayer`, isolated so runtimes with telemetry
+ * disabled never pay the SDK module-evaluation cost. `index.ts` imports this module lazily and
+ * only when telemetry is enabled or an explicit span processor is provided.
+ */
+export function telemetrySdkLayer(options, mode) {
+    const spanProcessor = options.spanProcessor ?? new SimpleSpanProcessor(new ConsoleSpanExporter());
+    return NodeSdk.layer(() => ({
+        logRecordProcessor: mode === "console"
+            ? new SimpleLogRecordProcessor(new ConsoleLogRecordExporter())
+            : undefined,
+        metricReader: mode === "console"
+            ? new PeriodicExportingMetricReader({
+                exporter: new ConsoleMetricExporter(),
+                exportIntervalMillis: 30_000
+            })
+            : undefined,
+        resource: {
+            serviceName: options.serviceName,
+            ...(options.serviceVersion === undefined
+                ? {}
+                : { serviceVersion: options.serviceVersion })
+        },
+        spanProcessor
+    }));
+}
+//# sourceMappingURL=telemetry-sdk.js.map

package/dist/telemetry-sdk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-sdk.js","sourceRoot":"","sources":["../src/telemetry-sdk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAC7F,OAAO,EAAE,qBAAqB,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAC;AAClG,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAGzF;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAoC,EAAE,IAAmB;IAC1F,MAAM,aAAa,GAClB,OAAO,CAAC,aAAa,IAAI,IAAI,mBAAmB,CAAC,IAAI,mBAAmB,EAAE,CAAC,CAAC;IAC7E,OAAO,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;QAC3B,kBAAkB,EACjB,IAAI,KAAK,SAAS;YACjB,CAAC,CAAC,IAAI,wBAAwB,CAAC,IAAI,wBAAwB,EAAE,CAAC;YAC9D,CAAC,CAAC,SAAS;QACb,YAAY,EACX,IAAI,KAAK,SAAS;YACjB,CAAC,CAAC,IAAI,6BAA6B,CAAC;gBAClC,QAAQ,EAAE,IAAI,qBAAqB,EAAE;gBACrC,oBAAoB,EAAE,MAAM;aAC5B,CAAC;YACH,CAAC,CAAC,SAAS;QACb,QAAQ,EAAE;YACT,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,GAAG,CAAC,OAAO,CAAC,cAAc,KAAK,SAAS;gBACvC,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC;SAC9C;QACD,aAAa;KACb,CAAC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@ue-shed/observability",
+  "version": "0.1.0",
+  "description": "Headless OpenTelemetry composition, bounded metrics, and runtime health for UE Shed hosts.",
+  "homepage": "https://github.com/ue-shed/ue-shed#readme",
+  "bugs": {
+    "url": "https://github.com/ue-shed/ue-shed/issues"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ue-shed/ue-shed.git",
+    "directory": "packages/observability"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./health": {
+      "types": "./dist/health.d.ts",
+      "import": "./dist/health.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@effect/opentelemetry": "4.0.0-beta.98",
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/api-logs": "^0.205.0",
+    "@opentelemetry/resources": "^2.2.0",
+    "@opentelemetry/sdk-logs": "^0.205.0",
+    "@opentelemetry/sdk-metrics": "^2.2.0",
+    "@opentelemetry/sdk-trace-base": "^2.2.0",
+    "@opentelemetry/sdk-trace-node": "^2.2.0",
+    "@opentelemetry/sdk-trace-web": "^2.2.0",
+    "@opentelemetry/semantic-conventions": "^1.38.0",
+    "effect": "4.0.0-beta.98"
+  },
+  "devDependencies": {
+    "@effect/vitest": "4.0.0-beta.98"
+  },
+  "engines": {
+    "node": ">=22.14.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit"
+  }
+}