@netgreener/runtime 0.1.0

package/dist/collectorMetadata.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Compatible ``service_runtime_v0.collector`` metadata values for
+ * ``@netgreener/runtime`` observation origins in legacy RunSession projections.
+ *
+ * These identify *where the observation came from* inside the Node emitter —
+ * not separate general-purpose collectors, and not APM/vendor products.
+ *
+ * N6 packaging doc twin: ``PACKAGING.md``.
+ */
+/** Known collector metadata strings emitted by this package. */
+export declare const COMPATIBLE_COLLECTOR_METADATA: readonly ["express_middleware", "fastify_middleware", "nest_express_middleware", "nest_fastify_middleware", "node_process", "bullmq_worker", "outbound_http"];
+export type CompatibleCollectorMetadata = (typeof COMPATIBLE_COLLECTOR_METADATA)[number];
+export declare function isCompatibleCollectorMetadata(value: string): boolean;
+/** Short descriptions for packaging / dogfood docs (not user-facing UI copy). */
+export declare const COLLECTOR_METADATA_NOTES: Record<CompatibleCollectorMetadata, string>;

package/dist/collectorMetadata.js

@@ -0,0 +1,33 @@
+/**
+ * Compatible ``service_runtime_v0.collector`` metadata values for
+ * ``@netgreener/runtime`` observation origins in legacy RunSession projections.
+ *
+ * These identify *where the observation came from* inside the Node emitter —
+ * not separate general-purpose collectors, and not APM/vendor products.
+ *
+ * N6 packaging doc twin: ``PACKAGING.md``.
+ */
+/** Known collector metadata strings emitted by this package. */
+export const COMPATIBLE_COLLECTOR_METADATA = [
+    'express_middleware',
+    'fastify_middleware',
+    'nest_express_middleware',
+    'nest_fastify_middleware',
+    'node_process',
+    'bullmq_worker',
+    'outbound_http',
+];
+const COLLECTOR_SET = new Set(COMPATIBLE_COLLECTOR_METADATA);
+export function isCompatibleCollectorMetadata(value) {
+    return COLLECTOR_SET.has(String(value || '').trim());
+}
+/** Short descriptions for packaging / dogfood docs (not user-facing UI copy). */
+export const COLLECTOR_METADATA_NOTES = {
+    express_middleware: 'Express middleware request/response metering origin',
+    fastify_middleware: 'Fastify plugin request/response metering origin',
+    nest_express_middleware: 'Nest on Express adapter middleware origin',
+    nest_fastify_middleware: 'Nest on Fastify adapter middleware origin',
+    node_process: 'Process/cron helper origin (no HTTP framework)',
+    bullmq_worker: 'BullMQ worker job flush origin',
+    outbound_http: 'Outbound fetch/axios/undici external API meter origin',
+};

package/dist/config.d.ts

@@ -0,0 +1,41 @@
+export type RuntimeConfig = {
+    enabled: boolean;
+    apiUrl: string;
+    token: string;
+    projectId: number;
+    organizationId: number | null;
+    flushIntervalMs: number;
+    dryRun: boolean;
+    deployEnvironment: string | null;
+    releaseTag: string | null;
+    /** Watts used for crude window energy estimate (trend accuracy). */
+    estimateTdpWatts: number;
+    tenantSource: string;
+    tenantClaim: string;
+    tenantHeader: string;
+    tenantPathRegex: string | null;
+    tenantTaskKwarg: string;
+    tenantLabelClaim: string | null;
+};
+/** Established v0 flush / TDP bounds (committed Node runtime foundation). */
+export declare const DEFAULT_RUNTIME_FLUSH_MINUTES = 5;
+export declare const MIN_RUNTIME_FLUSH_MINUTES = 1;
+export declare const MAX_RUNTIME_FLUSH_MINUTES: number;
+export declare const DEFAULT_ESTIMATE_TDP_WATTS = 65;
+export declare const MIN_ESTIMATE_TDP_WATTS = 1;
+/** Committed ceiling is 10_000 W — not the working-tree test literal 2000. */
+export declare const MAX_ESTIMATE_TDP_WATTS = 10000;
+/**
+ * Load runtime config from the supplied env object (defaults to process.env).
+ *
+ * Every field is read from that object so callers can pass an isolated map
+ * without ambient process.env leaking into tests or programmatic loads.
+ *
+ * Required when enabled: NETGREENER_TOKEN, NETGREENER_PROJECT_ID
+ * API URL: NETGREENER_API_URL (default https://core-api.netgreener.com)
+ */
+export declare function loadRuntimeConfig(env?: NodeJS.ProcessEnv): RuntimeConfig;
+export declare function configReady(config: RuntimeConfig): {
+    ok: boolean;
+    reason?: string;
+};

package/dist/config.js

@@ -0,0 +1,97 @@
+/** Established v0 flush / TDP bounds (committed Node runtime foundation). */
+export const DEFAULT_RUNTIME_FLUSH_MINUTES = 5;
+export const MIN_RUNTIME_FLUSH_MINUTES = 1;
+export const MAX_RUNTIME_FLUSH_MINUTES = 24 * 60;
+export const DEFAULT_ESTIMATE_TDP_WATTS = 65;
+export const MIN_ESTIMATE_TDP_WATTS = 1;
+/** Committed ceiling is 10_000 W — not the working-tree test literal 2000. */
+export const MAX_ESTIMATE_TDP_WATTS = 10_000;
+const MIN_RUNTIME_FLUSH_INTERVAL_MS = MIN_RUNTIME_FLUSH_MINUTES * 60 * 1000;
+const MAX_RUNTIME_FLUSH_INTERVAL_MS = MAX_RUNTIME_FLUSH_MINUTES * 60 * 1000;
+function envTruthy(env, name) {
+    const v = (env[name] || '').trim().toLowerCase();
+    return v === '1' || v === 'true' || v === 'yes' || v === 'on';
+}
+function envNumberInRange(env, name, fallback, min, max) {
+    const raw = (env[name] || '').trim();
+    if (!raw)
+        return fallback;
+    const n = Number(raw);
+    return Number.isFinite(n) && n >= min && n <= max ? n : fallback;
+}
+function envPositiveSafeInteger(env, name, fallback) {
+    const raw = (env[name] || '').trim();
+    if (!raw)
+        return fallback;
+    const n = Number(raw);
+    return Number.isSafeInteger(n) && n > 0 ? n : fallback;
+}
+function isPositiveSafeInteger(value) {
+    return Number.isSafeInteger(value) && value > 0;
+}
+/**
+ * Load runtime config from the supplied env object (defaults to process.env).
+ *
+ * Every field is read from that object so callers can pass an isolated map
+ * without ambient process.env leaking into tests or programmatic loads.
+ *
+ * Required when enabled: NETGREENER_TOKEN, NETGREENER_PROJECT_ID
+ * API URL: NETGREENER_API_URL (default https://core-api.netgreener.com)
+ */
+export function loadRuntimeConfig(env = process.env) {
+    const enabled = envTruthy(env, 'NETGREENER_SERVICE_RUNTIME');
+    const apiUrl = (env.NETGREENER_API_URL || 'https://core-api.netgreener.com').replace(/\/+$/, '');
+    const token = (env.NETGREENER_TOKEN || '').trim();
+    const projectId = envPositiveSafeInteger(env, 'NETGREENER_PROJECT_ID', 0);
+    const organizationIdRaw = envPositiveSafeInteger(env, 'NETGREENER_ORG_ID', 0);
+    const flushMinutes = envNumberInRange(env, 'NETGREENER_RUNTIME_FLUSH_MINUTES', DEFAULT_RUNTIME_FLUSH_MINUTES, MIN_RUNTIME_FLUSH_MINUTES, MAX_RUNTIME_FLUSH_MINUTES);
+    return {
+        enabled,
+        apiUrl,
+        token,
+        projectId,
+        organizationId: organizationIdRaw > 0 ? organizationIdRaw : null,
+        flushIntervalMs: flushMinutes * 60 * 1000,
+        dryRun: envTruthy(env, 'NETGREENER_RUNTIME_DRY_RUN'),
+        deployEnvironment: (env.NETGREENER_DEPLOY_ENVIRONMENT || env.DEPLOY_ENV || '').trim() || null,
+        releaseTag: (env.NETGREENER_RELEASE_TAG || env.GIT_SHA || '').trim() || null,
+        estimateTdpWatts: envNumberInRange(env, 'NETGREENER_ESTIMATE_TDP_WATTS', DEFAULT_ESTIMATE_TDP_WATTS, MIN_ESTIMATE_TDP_WATTS, MAX_ESTIMATE_TDP_WATTS),
+        tenantSource: (env.NETGREENER_TENANT_SOURCE || 'none').trim().toLowerCase(),
+        tenantClaim: (env.NETGREENER_TENANT_CLAIM || 'organization_id').trim(),
+        tenantHeader: (env.NETGREENER_TENANT_HEADER || 'X-Organization-Id').trim(),
+        tenantPathRegex: (env.NETGREENER_TENANT_PATH_REGEX || '').trim() || null,
+        tenantTaskKwarg: (env.NETGREENER_TENANT_TASK_KWARG || 'organization_id').trim(),
+        tenantLabelClaim: (env.NETGREENER_TENANT_LABEL_CLAIM || '').trim() || null,
+    };
+}
+export function configReady(config) {
+    if (!config.enabled)
+        return { ok: false, reason: 'NETGREENER_SERVICE_RUNTIME not enabled' };
+    if (!config.token)
+        return { ok: false, reason: 'NETGREENER_TOKEN missing' };
+    if (!isPositiveSafeInteger(config.projectId)) {
+        return { ok: false, reason: 'NETGREENER_PROJECT_ID must be a positive safe integer' };
+    }
+    if (config.organizationId !== null && !isPositiveSafeInteger(config.organizationId)) {
+        return { ok: false, reason: 'NETGREENER_ORG_ID must be a positive safe integer' };
+    }
+    if (!Number.isFinite(config.flushIntervalMs) ||
+        config.flushIntervalMs < MIN_RUNTIME_FLUSH_INTERVAL_MS ||
+        config.flushIntervalMs > MAX_RUNTIME_FLUSH_INTERVAL_MS) {
+        return {
+            ok: false,
+            reason: `flushIntervalMs must be between ${MIN_RUNTIME_FLUSH_INTERVAL_MS} and ${MAX_RUNTIME_FLUSH_INTERVAL_MS}`,
+        };
+    }
+    if (!Number.isFinite(config.estimateTdpWatts) ||
+        config.estimateTdpWatts < MIN_ESTIMATE_TDP_WATTS ||
+        config.estimateTdpWatts > MAX_ESTIMATE_TDP_WATTS) {
+        return {
+            ok: false,
+            reason: `estimateTdpWatts must be between ${MIN_ESTIMATE_TDP_WATTS} and ${MAX_ESTIMATE_TDP_WATTS}`,
+        };
+    }
+    if (!config.apiUrl)
+        return { ok: false, reason: 'NETGREENER_API_URL missing' };
+    return { ok: true };
+}

package/dist/contract/index.d.ts

@@ -0,0 +1 @@
+export { validateExternalApiV0, validateMeasurementProvenance, validateRuntimeSessionMetadata, validateServiceRuntimeV0, type ContractIssue, type ContractResult, } from './validate.js';

package/dist/contract/index.js

@@ -0,0 +1 @@
+export { validateExternalApiV0, validateMeasurementProvenance, validateRuntimeSessionMetadata, validateServiceRuntimeV0, } from './validate.js';

package/dist/contract/observation-envelope.schema.json

@@ -0,0 +1,331 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.netgreener.com/contracts/v1/observation-envelope.schema.json",
+  "$comment": "Semantic authoring/TCK conformance view. Canonical field/type/number source is observation/v1/source/observation.proto (ADR 0009). Structural Protobuf JSON view: observation-protobuf-view.schema.json. Dual-view migration; consumer pins not auto-updated.",
+  "title": "NetGreener Observation v1 semantic envelope (MP0 draft)",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_name",
+    "schema_version",
+    "contract_status",
+    "batch_id",
+    "batch_sequence",
+    "emitted_at",
+    "source",
+    "routing",
+    "privacy",
+    "events"
+  ],
+  "properties": {
+    "$schema": { "type": "string" },
+    "schema_name": { "const": "netgreener.observation.v1" },
+    "schema_version": { "const": 1 },
+    "contract_status": { "const": "mp0_draft" },
+    "batch_id": { "$ref": "#/$defs/batchId" },
+    "batch_sequence": { "$ref": "#/$defs/uint64String" },
+    "emitted_at": { "type": "string", "format": "date-time" },
+    "source": { "$ref": "#/$defs/source" },
+    "routing": { "$ref": "#/$defs/routing" },
+    "privacy": { "$ref": "#/$defs/privacy" },
+    "window": { "$ref": "#/$defs/window" },
+    "events": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 1000,
+      "items": {
+        "oneOf": [
+          { "$ref": "#/$defs/operationEvent" },
+          { "$ref": "#/$defs/operationSummary" },
+          { "$ref": "#/$defs/externalCall" },
+          { "$ref": "#/$defs/resourceSample" },
+          { "$ref": "#/$defs/adapterHealth" }
+        ]
+      }
+    }
+  },
+  "$defs": {
+    "uint64String": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,19})$" },
+    "positiveUint64String": { "type": "string", "pattern": "^[1-9][0-9]{0,19}$" },
+    "eventId": { "type": "string", "pattern": "^evt_[0-9a-f]{64}$" },
+    "batchId": { "type": "string", "pattern": "^bat_[0-9a-f]{64}$" },
+    "runtimeInstanceId": { "type": "string", "pattern": "^rti_[0-9a-f]{64}$" },
+    "runtimeWindowId": { "type": "string", "pattern": "^rtw_[0-9a-f]{64}$" },
+    "boundedIdentifier": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._:@/-]{0,199}$" },
+    "source": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "language",
+        "runtime_name",
+        "runtime_version",
+        "adapter_name",
+        "adapter_version",
+        "runtime_instance_id",
+        "capability_ids",
+        "deployment_mode"
+      ],
+      "properties": {
+        "language": { "type": "string", "pattern": "^[a-z][a-z0-9+-]{0,31}$" },
+        "runtime_name": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._+-]{0,63}$" },
+        "runtime_version": { "type": "string", "minLength": 1, "maxLength": 80 },
+        "adapter_name": { "type": "string", "minLength": 1, "maxLength": 120 },
+        "adapter_version": { "type": "string", "minLength": 1, "maxLength": 80 },
+        "runtime_instance_id": { "$ref": "#/$defs/runtimeInstanceId" },
+        "capability_ids": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": { "type": "string", "pattern": "^CAP-R[1-6]$" }
+        },
+        "framework": { "type": ["string", "null"], "maxLength": 80 },
+        "deployment_mode": { "enum": ["vm", "container", "kubernetes", "ci_job", "serverless_thin", "local", "unknown"] }
+      }
+    },
+    "routing": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["project_id", "workload_id", "service_name"],
+      "properties": {
+        "organization_id": { "type": "integer", "minimum": 1 },
+        "project_id": { "type": "integer", "minimum": 1 },
+        "workload_id": { "$ref": "#/$defs/boundedIdentifier" },
+        "service_name": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$" },
+        "environment": { "type": ["string", "null"], "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,49}$" },
+        "release_tag": { "type": ["string", "null"], "maxLength": 120 }
+      }
+    },
+    "privacy": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["content_capture", "dimension_policy", "route_policy", "dropped_dimension_count"],
+      "properties": {
+        "content_capture": { "const": "none" },
+        "dimension_policy": { "const": "allowlist" },
+        "route_policy": { "const": "template_or_unknown" },
+        "dropped_dimension_count": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "window": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["state", "start_time", "end_time"],
+      "properties": {
+        "runtime_window_id": { "$ref": "#/$defs/runtimeWindowId" },
+        "state": { "enum": ["open", "closed", "thin"] },
+        "start_time": { "type": "string", "format": "date-time" },
+        "end_time": { "type": ["string", "null"], "format": "date-time" }
+      }
+    },
+    "eventCommon": {
+      "type": "object",
+      "required": ["event_id", "sequence", "wall_time_unix_nano", "monotonic_time_ns", "clock_source"],
+      "properties": {
+        "event_id": { "$ref": "#/$defs/eventId" },
+        "sequence": { "$ref": "#/$defs/positiveUint64String" },
+        "wall_time_unix_nano": { "$ref": "#/$defs/positiveUint64String" },
+        "monotonic_time_ns": { "$ref": "#/$defs/uint64String" },
+        "clock_source": { "enum": ["runtime_monotonic", "process_monotonic", "unavailable"] },
+        "execution_id": { "$ref": "#/$defs/boundedIdentifier" },
+        "runtime_window_id": { "$ref": "#/$defs/runtimeWindowId" },
+        "traceparent": {
+          "type": "string",
+          "pattern": "^[0-9a-f]{2}-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$"
+        }
+      }
+    },
+    "operation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "unit_type", "name", "identity_source"],
+      "properties": {
+        "kind": { "enum": ["http.server", "task", "process", "script", "cron", "background", "unattributed"] },
+        "unit_type": { "enum": ["http_route", "task", "process", "script", "cron", "background", "unattributed"] },
+        "name": { "type": "string", "minLength": 1, "maxLength": 200, "pattern": "^[^?#\\r\\n]+$" },
+        "identity_source": { "enum": ["framework_template", "declared", "generated", "unknown_bucket"] },
+        "http_method": { "type": "string", "pattern": "^[A-Z]{3,12}$" },
+        "route_template": {
+          "oneOf": [
+            { "const": "__unknown__" },
+            { "type": "string", "pattern": "^/[^?#\\r\\n]{0,198}$" }
+          ]
+        }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "kind": { "const": "http.server" } }, "required": ["kind"] },
+          "then": { "required": ["http_method", "route_template"] }
+        }
+      ]
+    },
+    "operationEvent": {
+      "allOf": [
+        { "$ref": "#/$defs/eventCommon" },
+        {
+          "type": "object",
+          "required": ["record_type", "operation", "facts"],
+          "properties": {
+            "record_type": { "const": "operation_event" },
+            "operation": { "$ref": "#/$defs/operation" },
+            "facts": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["phase", "outcome"],
+              "properties": {
+                "phase": { "enum": ["start", "finish", "heartbeat"] },
+                "outcome": { "enum": ["ok", "error", "cancelled", "unknown"] },
+                "duration_ns": { "$ref": "#/$defs/uint64String" },
+                "status_code": { "type": ["integer", "null"], "minimum": 0, "maximum": 999 }
+              }
+            }
+          }
+        }
+      ],
+      "unevaluatedProperties": false
+    },
+    "operationSummary": {
+      "allOf": [
+        { "$ref": "#/$defs/eventCommon" },
+        {
+          "type": "object",
+          "required": ["record_type", "operation", "facts"],
+          "properties": {
+            "record_type": { "const": "operation_summary" },
+            "operation": { "$ref": "#/$defs/operation" },
+            "facts": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["calls", "errors", "duration_ns_sum", "duration_ns_max"],
+              "properties": {
+                "calls": { "type": "integer", "minimum": 1, "maximum": 1000000000 },
+                "errors": { "type": "integer", "minimum": 0, "maximum": 1000000000 },
+                "duration_ns_sum": { "$ref": "#/$defs/uint64String" },
+                "duration_ns_max": { "$ref": "#/$defs/uint64String" },
+                "concurrency_max": { "type": "integer", "minimum": 1, "maximum": 1000000 }
+              }
+            }
+          }
+        }
+      ],
+      "unevaluatedProperties": false
+    },
+    "usage": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["unit", "value", "source"],
+      "properties": {
+        "unit": {
+          "oneOf": [
+            { "enum": ["input_tokens", "output_tokens", "total_tokens", "cached_input_tokens", "reasoning_tokens", "request_bytes", "response_bytes", "provider_units"] },
+            { "type": "string", "pattern": "^x-[a-z0-9][a-z0-9_.-]{0,62}$" }
+          ]
+        },
+        "value": { "$ref": "#/$defs/uint64String" },
+        "source": { "enum": ["provider_response", "documented_header", "sdk_callback", "declared"] }
+      }
+    },
+    "externalCall": {
+      "allOf": [
+        { "$ref": "#/$defs/eventCommon" },
+        {
+          "type": "object",
+          "required": ["record_type", "facts"],
+          "properties": {
+            "record_type": { "const": "external_call" },
+            "parent_operation_event_id": { "$ref": "#/$defs/eventId" },
+            "facts": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["service", "operation", "attempts", "errors", "duration_ns"],
+              "properties": {
+                "provider": { "type": ["string", "null"], "pattern": "^[a-z0-9][a-z0-9_.-]{0,63}$" },
+                "service": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_.-]{0,63}$" },
+                "operation": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]{0,99}$" },
+                "model": { "type": ["string", "null"], "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:/-]{0,127}$" },
+                "destination_domain": { "type": ["string", "null"], "pattern": "^[a-z0-9][a-z0-9.-]{0,252}[a-z0-9]$" },
+                "attempts": { "type": "integer", "minimum": 1, "maximum": 1000000 },
+                "errors": { "type": "integer", "minimum": 0, "maximum": 1000000 },
+                "duration_ns": { "$ref": "#/$defs/uint64String" },
+                "usage": { "type": "array", "maxItems": 32, "items": { "$ref": "#/$defs/usage" } }
+              }
+            }
+          }
+        }
+      ],
+      "unevaluatedProperties": false
+    },
+    "measurement": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "value", "unit", "temporality", "source", "coverage"],
+      "properties": {
+        "name": { "enum": ["process.cpu.time", "process.memory.rss", "system.energy", "gpu.energy", "gpu.utilization"] },
+        "value": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,30})(\\.[0-9]{1,12})?$" },
+        "unit": { "enum": ["ns", "By", "J", "1"] },
+        "temporality": { "enum": ["cumulative", "delta", "gauge"] },
+        "source": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]{0,119}$" },
+        "coverage": { "type": "number", "minimum": 0, "maximum": 1 }
+      }
+    },
+    "resourceSample": {
+      "allOf": [
+        { "$ref": "#/$defs/eventCommon" },
+        {
+          "type": "object",
+          "required": ["record_type", "facts"],
+          "properties": {
+            "record_type": { "const": "resource_sample" },
+            "parent_operation_event_id": { "$ref": "#/$defs/eventId" },
+            "facts": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["scope", "sample_kind", "subject_id", "measurements"],
+              "properties": {
+                "scope": { "enum": ["process", "process_tree", "container", "cgroup", "host", "device"] },
+                "sample_kind": { "enum": ["start", "periodic", "end", "snapshot"] },
+                "subject_id": { "$ref": "#/$defs/boundedIdentifier" },
+                "measurements": { "type": "array", "minItems": 1, "maxItems": 32, "items": { "$ref": "#/$defs/measurement" } }
+              }
+            }
+          }
+        }
+      ],
+      "unevaluatedProperties": false
+    },
+    "adapterHealth": {
+      "allOf": [
+        { "$ref": "#/$defs/eventCommon" },
+        {
+          "type": "object",
+          "required": ["record_type", "facts"],
+          "properties": {
+            "record_type": { "const": "adapter_health" },
+            "facts": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["component", "status", "reason_codes", "counters"],
+              "properties": {
+                "component": { "enum": ["adapter", "exporter", "sampler", "collector"] },
+                "status": { "enum": ["ok", "degraded", "error", "disabled"] },
+                "reason_codes": { "type": "array", "maxItems": 32, "uniqueItems": true, "items": { "type": "string", "pattern": "^[A-Z][A-Z0-9_]{0,63}$" } },
+                "counters": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "properties": {
+                    "dropped_events": { "type": "integer", "minimum": 0 },
+                    "retries": { "type": "integer", "minimum": 0 },
+                    "rejected_events": { "type": "integer", "minimum": 0 },
+                    "queue_depth": { "type": "integer", "minimum": 0 },
+                    "queue_oldest_age_ms": { "type": "integer", "minimum": 0 }
+                  }
+                }
+              }
+            }
+          }
+        }
+      ],
+      "unevaluatedProperties": false
+    }
+  }
+}
+