@cat-factory/observability-otel 0.2.10

package/dist/platform.js

@@ -0,0 +1,73 @@
+import { ATTR, DEFAULT_SERVICE_NAME, SCOPE_NAME, mapPlatformMetrics, toUnixNano, } from './mapping.js';
+import { keyValues, postOtlp } from './otlp.js';
+/** Encode one {@link MappedGauge} as an OTLP metric with a `gauge` data-point list. */
+function encodeGauge(gauge, timeUnixNano) {
+    return {
+        name: gauge.name,
+        unit: gauge.unit,
+        gauge: {
+            dataPoints: gauge.points.map((point) => ({
+                attributes: keyValues(point.attributes),
+                timeUnixNano,
+                ...(point.isInt ? { asInt: String(Math.round(point.value)) } : { asDouble: point.value }),
+            })),
+        },
+    };
+}
+export class PlatformMetricsOtelExporter {
+    metricsEndpoint;
+    headers;
+    serviceName;
+    logger;
+    fetchImpl;
+    constructor(config) {
+        const base = config.endpoint.replace(/\/+$/, '');
+        this.metricsEndpoint = `${base}/v1/metrics`;
+        this.headers = { 'content-type': 'application/json', ...config.headers };
+        this.serviceName = config.serviceName || DEFAULT_SERVICE_NAME;
+        this.logger = config.logger;
+        this.fetchImpl = config.fetchImpl ?? fetch;
+    }
+    resourceAttributes() {
+        return [{ key: ATTR.serviceName, value: { stringValue: this.serviceName } }];
+    }
+    /**
+     * Export one account's platform-observability snapshot as OTLP gauge metrics. Gauges are
+     * stamped with the snapshot's `generatedAt` (the clock the projection was computed at), so
+     * no wall-clock read is needed here. In practice a snapshot always yields the run-count and
+     * live-depth gauges (even all-zero — a zero-valued gauge is meaningful, not misleading), so
+     * a POST is always sent; the empty-batch guard below is defensive only, in case the mapping
+     * ever becomes fully conditional. Best-effort — see the file header.
+     */
+    async export(snapshot, dims) {
+        const gauges = mapPlatformMetrics(snapshot, dims);
+        if (gauges.length === 0)
+            return;
+        const timeUnixNano = toUnixNano(snapshot.generatedAt);
+        const payload = {
+            resourceMetrics: [
+                {
+                    resource: { attributes: this.resourceAttributes() },
+                    scopeMetrics: [
+                        {
+                            scope: { name: SCOPE_NAME },
+                            metrics: gauges.map((gauge) => encodeGauge(gauge, timeUnixNano)),
+                        },
+                    ],
+                },
+            ],
+        };
+        await postOtlp({
+            fetchImpl: this.fetchImpl,
+            endpoint: this.metricsEndpoint,
+            headers: this.headers,
+            payload,
+            logger: this.logger,
+        });
+    }
+}
+/** Build a fetch-based {@link PlatformMetricsOtelExporter}. The workerd-safe opt-in exporter. */
+export function createPlatformMetricsOtelExporter(config) {
+    return new PlatformMetricsOtelExporter(config);
+}
+//# sourceMappingURL=platform.js.map

package/dist/platform.js.map

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

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@cat-factory/observability-otel",
+  "version": "0.2.10",
+  "description": "Opt-in OpenTelemetry (OTLP) trace + metrics publisher for the Agent Architecture Board. Streams LLM generations and container tool spans to any OTLP/HTTP backend — the workerd-safe fetch exporter on the Cloudflare Worker facade, the official @opentelemetry/* SDK on Node — kept conformant by a shared mapping layer + tests. Also publishes deployment-level (platform-operator) run-health aggregates as OTLP gauge metrics.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kibertoad/cat-factory.git",
+    "directory": "backend/packages/observability-otel"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./node": {
+      "types": "./dist/node.d.ts",
+      "default": "./dist/node.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@opentelemetry/api": "^1.9.1",
+    "@opentelemetry/exporter-metrics-otlp-http": "^0.220.0",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.220.0",
+    "@opentelemetry/resources": "^2.9.0",
+    "@opentelemetry/sdk-metrics": "^2.9.0",
+    "@opentelemetry/sdk-trace-base": "^2.9.0",
+    "@opentelemetry/sdk-trace-node": "^2.9.0",
+    "@cat-factory/contracts": "0.148.1",
+    "@cat-factory/kernel": "0.140.1"
+  },
+  "devDependencies": {
+    "typescript": "7.0.2",
+    "vitest": "^4.1.10"
+  },
+  "scripts": {
+    "build": "tsc -b tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test:run": "vitest run"
+  }
+}