@alumnium/core 0.24.0-alpha.1 → 0.24.0-alpha.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alumnium/core",
-  "version": "0.24.0-alpha.1",
+  "version": "0.24.0-alpha.2",
   "description": "Alumnium core: Alumni, agents, environment, telemetry, storage, accessibility trees, tools and driver contracts",
   "license": "MIT",
   "author": "Alex Rodionov <p0deje@gmail.com>",
@@ -47,12 +47,7 @@
     "@js-fns/xxhash": "^0.1.0",
     "@logtape/file": "^2.0.2",
     "@logtape/logtape": "^2.0.2",
-    "@logtape/otel": "^2.0.5",
     "@opentelemetry/api": "^1.9.1",
-    "@opentelemetry/exporter-trace-otlp-http": "^0.215.0",
-    "@opentelemetry/resources": "^2.7.0",
-    "@opentelemetry/sdk-trace-base": "^2.7.0",
-    "@opentelemetry/sdk-trace-node": "^2.7.0",
     "alwaysly": "^0.4.0",
     "cac": "^7.0.0",
     "case-anything": "^3.1.2",
@@ -68,9 +63,13 @@
     "zod": "^4.4.1"
   },
   "peerDependencies": {
+    "@alumnium/telemetry": "0.24.0-alpha.2",
     "ai": "^7.0.78"
   },
   "peerDependenciesMeta": {
+    "@alumnium/telemetry": {
+      "optional": true
+    },
     "ai": {
       "optional": true
     }

package/src/internal.cjs

@@ -1186,7 +1186,6 @@ var import_node_path3 = __toESM(require("node:path"), 1);
 var import_node_util = require("node:util");
 var import_file = require("@logtape/file");
 var import_logtape = require("@logtape/logtape");
-var import_otel = require("@logtape/otel");
 
 // core/src/utils/fs.ts
 var import_node_fs = require("node:fs");
@@ -1244,12 +1243,22 @@ class Instrumentation {
   }
 }
 
+// core/src/telemetry/loadTelemetry.ts
+var telemetryPromise;
+function loadTelemetry() {
+  return (telemetryPromise ??= import("@alumnium/telemetry").then(
+    (module2) => module2,
+    () => {
+      console.warn(
+        'ALUMNIUM_TRACE is enabled, but traces and logs aren\'t exported without the "@alumnium/telemetry" package. Install it, e.g. `npm install @alumnium/telemetry`.',
+      );
+      return;
+    },
+  ));
+}
+
 // core/src/telemetry/Tracer.ts
 var import_api = require("@opentelemetry/api");
-var import_exporter_trace_otlp_http = require("@opentelemetry/exporter-trace-otlp-http");
-var import_resources = require("@opentelemetry/resources");
-var import_sdk_trace_base = require("@opentelemetry/sdk-trace-base");
-var import_sdk_trace_node = require("@opentelemetry/sdk-trace-node");
 var import_nanoid = require("nanoid");
 
 // core/src/typeUtils.ts
@@ -1273,47 +1282,40 @@ class Tracer {
     }
     const spanMethod = (spanName, ...args) => {
       const [attrs, bodyFnOrKey] = this.#normalizeSpanArgs(args);
-      const provider = this.#configure();
+      const tracer = this.#configure();
       if (typeof bodyFnOrKey === "string" || !bodyFnOrKey) {
         const key = bodyFnOrKey || import_nanoid.nanoid();
-        if (!provider) {
+        if (!tracer) {
           const span = this.#dummySpan;
           this.#spans.set(key, span);
           return span;
         }
-        const otelSpan = this.#tracer(provider).startSpan(
-          spanName,
-          traceAttrs(attrs),
-        );
+        const otelSpan = tracer.startSpan(spanName, traceAttrs(attrs));
         return this.#span(otelSpan, key);
       }
       const bodyFn = bodyFnOrKey;
-      if (!provider) return bodyFn(this.#dummySpan);
-      return this.#tracer(provider).startActiveSpan(
-        spanName,
-        traceAttrs(attrs),
-        (otelSpan) => {
-          const span = this.#span(otelSpan);
-          try {
-            const result = bodyFn(span);
-            if (result instanceof Promise)
-              return result
-                .then((res) => {
-                  span.succeed();
-                  return res;
-                })
-                .catch((error) => {
-                  span.fail(error);
-                  throw error;
-                });
-            span.succeed();
-            return result;
-          } catch (error) {
-            span.fail(error);
-            throw error;
-          }
-        },
-      );
+      if (!tracer) return bodyFn(this.#dummySpan);
+      return tracer.startActiveSpan(spanName, traceAttrs(attrs), (otelSpan) => {
+        const span = this.#span(otelSpan);
+        try {
+          const result = bodyFn(span);
+          if (result instanceof Promise)
+            return result
+              .then((res) => {
+                span.succeed();
+                return res;
+              })
+              .catch((error) => {
+                span.fail(error);
+                throw error;
+              });
+          span.succeed();
+          return result;
+        } catch (error) {
+          span.fail(error);
+          throw error;
+        }
+      });
     };
     return {
       span: spanMethod,
@@ -1325,8 +1327,8 @@ class Tracer {
         }
       },
       event: (eventName, ...args) => {
-        const provider = this.#configure();
-        if (!provider) return;
+        const tracer = this.#configure();
+        if (!tracer) return;
         const attrs = args[0] || {};
         const fullEventName = `${moduleName}.${eventName}`;
         const eventAttrs = Tracer.#compactAttrs(attrs);
@@ -1337,7 +1339,7 @@ class Tracer {
           activeSpan.addEvent(fullEventName, eventAttrs);
           return;
         }
-        const span = this.#tracer(provider).startSpan(fullEventName, {
+        const span = tracer.startSpan(fullEventName, {
           attributes: eventAttrs,
         });
         span.addEvent(fullEventName, eventAttrs);
@@ -1378,9 +1380,6 @@ class Tracer {
       }),
     };
   }
-  static #tracer(provider) {
-    return provider.getTracer(this.serviceName);
-  }
   static #compactAttrs(attrs) {
     return Object.fromEntries(
       Object.entries(attrs).filter(([, value]) => value != null),
@@ -1406,10 +1405,14 @@ class Tracer {
       }
     }
   }
+  static async init() {
+    this.#configure();
+    await this.#tracing;
+  }
   static async flush() {
-    const provider = this.#configure();
-    if (!provider) return;
-    return this.#flush(provider);
+    this.#configure();
+    const tracing = await this.#tracing;
+    if (tracing) return this.#flush(tracing);
   }
   static #spans = new Map();
   static #dummySpan = {
@@ -1485,33 +1488,25 @@ class Tracer {
     );
     otelSpan.setStatus(otelStatus);
   }
-  static async #flush(provider) {
+  static async #flush(tracing) {
     this.#spans.forEach((span) => {
       span.fail("Span not ended before flush");
     });
-    await provider.forceFlush().catch(() => {});
+    await tracing.flush().catch(() => {});
   }
-  static #provider;
+  static #tracing;
   static #configure() {
-    if (this.#provider !== undefined) return this.#provider;
-    if (this.enabled) {
-      const provider = new import_sdk_trace_node.NodeTracerProvider({
-        resource: import_resources.resourceFromAttributes({
-          "service.name": Tracer.serviceName,
-        }),
-        spanProcessors: [
-          new import_sdk_trace_base.BatchSpanProcessor(
-            new import_exporter_trace_otlp_http.OTLPTraceExporter(),
-          ),
-        ],
-      });
-      provider.register();
-      process.once("beforeExit", () => void this.#flush(provider));
-      this.#provider = provider;
-    } else {
-      this.#provider = null;
+    if (this.#tracing === undefined) {
+      this.#tracing = this.enabled
+        ? loadTelemetry().then((telemetry) => {
+            const tracing = telemetry?.startTracing(this.serviceName);
+            if (tracing)
+              process.once("beforeExit", () => void this.#flush(tracing));
+            return tracing;
+          })
+        : null;
     }
-    return this.#provider;
+    return this.#tracing ? import_api.trace.getTracer(this.serviceName) : null;
   }
 }
 
@@ -1564,6 +1559,7 @@ class Logger {
       await this.#flush();
       process.exit(1);
     }
+    await Tracer.init();
   }
   static #level;
   static set level(newLevel) {
@@ -1641,11 +1637,10 @@ class Logger {
         this.#flush();
       });
     }
-    if (Tracer.enabled) {
+    const telemetry = Tracer.enabled ? await loadTelemetry() : undefined;
+    if (telemetry) {
       mainSinks.push("otel");
-      sinks.otel = import_otel.getOpenTelemetrySink({
-        serviceName: Instrumentation.serviceName,
-      });
+      sinks.otel = telemetry.getLogSink(Instrumentation.serviceName);
     }
     return {
       sinks,
@@ -9229,7 +9224,7 @@ function usesAdaptiveThinking(modelName) {
 // core/package.json
 var package_default = {
   name: "@alumnium/core",
-  version: "0.24.0-alpha.1",
+  version: "0.24.0-alpha.2",
   description:
     "Alumnium core: Alumni, agents, environment, telemetry, storage, accessibility trees, tools and driver contracts",
   license: "MIT",
@@ -9245,12 +9240,7 @@ var package_default = {
     "@js-fns/xxhash": "^0.1.0",
     "@logtape/file": "^2.0.2",
     "@logtape/logtape": "^2.0.2",
-    "@logtape/otel": "^2.0.5",
     "@opentelemetry/api": "^1.9.1",
-    "@opentelemetry/exporter-trace-otlp-http": "^0.215.0",
-    "@opentelemetry/resources": "^2.7.0",
-    "@opentelemetry/sdk-trace-base": "^2.7.0",
-    "@opentelemetry/sdk-trace-node": "^2.7.0",
     alwaysly: "^0.4.0",
     cac: "^7.0.0",
     "case-anything": "^3.1.2",
@@ -9266,13 +9256,18 @@ var package_default = {
     zod: "^4.4.1",
   },
   devDependencies: {
+    "@alumnium/telemetry": "workspace:*",
     ai: "^7.0.78",
     oxfmt: "^0.65.0",
   },
   peerDependencies: {
+    "@alumnium/telemetry": "workspace:*",
     ai: "^7.0.78",
   },
   peerDependenciesMeta: {
+    "@alumnium/telemetry": {
+      optional: true,
+    },
     ai: {
       optional: true,
     },
@@ -9291,5 +9286,5 @@ function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
 
-//# debugId=45517550D8B9A0D364756E2164756E21
+//# debugId=7F39F76FB547C9B864756E2164756E21
 //# sourceMappingURL=internal.cjs.map