@dexto/core 1.8.2 → 1.8.4

package/dist/session/title-generator.js

@@ -30,9 +30,12 @@ async function generateSessionTitle(config, userText, logger, opts = {}) {
     });
     const processed = postProcessTitle(result.text);
     if (!processed) {
-      return { error: "LLM returned empty title" };
+      return {
+        error: "LLM returned empty title",
+        usage: toSessionTitleTokenUsage(result.totalUsage)
+      };
     }
-    return { title: processed };
+    return { title: processed, usage: toSessionTitleTokenUsage(result.totalUsage) };
   } catch (error) {
     if (controller?.signal.aborted) {
       return { timedOut: true, error: "Timed out while waiting for LLM response" };
@@ -45,6 +48,20 @@ async function generateSessionTitle(config, userText, logger, opts = {}) {
     }
   }
 }
+function toSessionTitleTokenUsage(usage) {
+  const tokenUsage = {};
+  copyTokenUsageNumber(tokenUsage, "cachedInputTokens", usage.cachedInputTokens);
+  copyTokenUsageNumber(tokenUsage, "inputTokens", usage.inputTokens);
+  copyTokenUsageNumber(tokenUsage, "outputTokens", usage.outputTokens);
+  copyTokenUsageNumber(tokenUsage, "reasoningTokens", usage.reasoningTokens);
+  copyTokenUsageNumber(tokenUsage, "totalTokens", usage.totalTokens);
+  return tokenUsage;
+}
+function copyTokenUsageNumber(target, key, value) {
+  if (typeof value === "number" && Number.isFinite(value)) {
+    target[key] = value;
+  }
+}
 function deriveHeuristicTitle(userText) {
   const sanitized = sanitizeUserText(userText, 120);
   if (!sanitized) return void 0;

package/dist/systemPrompt/contributors.cjs

@@ -29,6 +29,7 @@ var import_promises = require("fs/promises");
 var import_path = require("path");
 var import_errors = require("./errors.js");
 var import_DextoRuntimeError = require("../errors/DextoRuntimeError.js");
+var import_operation_span = require("../telemetry/operation-span.js");
 class StaticContributor {
   constructor(id, priority, content) {
     this.id = id;
@@ -203,7 +204,15 @@ class SkillsContributor {
   logger;
   async getContent(_context) {
     try {
-      const skills = await this.skillManager.list();
+      const skills = await (0, import_operation_span.recordOperationSpan)(
+        {
+          name: "skills.list",
+          componentName: "SkillsContributor",
+          resultAttributes: (skills2) => ({ "skills.count": skills2.length })
+        },
+        () => this.skillManager.list(),
+        this.logger
+      );
       if (skills.length === 0) {
         return "";
       }

package/dist/systemPrompt/contributors.d.ts.map

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

package/dist/systemPrompt/contributors.js

@@ -3,6 +3,7 @@ import { readFile, stat } from "fs/promises";
 import { resolve, extname } from "path";
 import { SystemPromptError } from "./errors.js";
 import { DextoRuntimeError } from "../errors/DextoRuntimeError.js";
+import { recordOperationSpan } from "../telemetry/operation-span.js";
 class StaticContributor {
   constructor(id, priority, content) {
     this.id = id;
@@ -177,7 +178,15 @@ class SkillsContributor {
   logger;
   async getContent(_context) {
     try {
-      const skills = await this.skillManager.list();
+      const skills = await recordOperationSpan(
+        {
+          name: "skills.list",
+          componentName: "SkillsContributor",
+          resultAttributes: (skills2) => ({ "skills.count": skills2.length })
+        },
+        () => this.skillManager.list(),
+        this.logger
+      );
       if (skills.length === 0) {
         return "";
       }

package/dist/telemetry/browser.cjs

@@ -0,0 +1,138 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var browser_exports = {};
+__export(browser_exports, {
+  Telemetry: () => Telemetry
+});
+module.exports = __toCommonJS(browser_exports);
+var import_api = require("@opentelemetry/api");
+function isGlobalTelemetryLike(value) {
+  if (typeof value !== "object" || value === null) {
+    return false;
+  }
+  return typeof Reflect.get(value, "forceFlush") === "function" && typeof Reflect.get(value, "isInitialized") === "function" && typeof Reflect.get(value, "name") === "string" && typeof Reflect.get(value, "shutdown") === "function" && Reflect.get(value, "tracer") !== void 0;
+}
+class Telemetry {
+  tracer;
+  name;
+  _isInitialized;
+  _shutdownHandler;
+  static _initPromise;
+  constructor(config, options) {
+    const serviceName = config.serviceName ?? "dexto-service";
+    const tracerName = config.tracerName ?? serviceName;
+    this.name = serviceName;
+    this.tracer = import_api.trace.getTracer(tracerName);
+    this._shutdownHandler = options.shutdown;
+    this._isInitialized = options.initialized;
+  }
+  static async registerGlobal(options = {}) {
+    const existing = Telemetry.getGlobalInstance();
+    if (existing !== void 0) {
+      return existing;
+    }
+    if (Telemetry._initPromise !== void 0) {
+      return Telemetry._initPromise;
+    }
+    Telemetry._initPromise = Promise.resolve().then(() => {
+      const current = Telemetry.getGlobalInstance();
+      if (current !== void 0) {
+        return current;
+      }
+      const telemetry = new Telemetry(options.config ?? {}, {
+        initialized: options.initialized ?? true,
+        ...options.shutdown !== void 0 && { shutdown: options.shutdown }
+      });
+      Telemetry.setGlobalInstance(telemetry);
+      return telemetry;
+    });
+    return Telemetry._initPromise;
+  }
+  static getActiveSpan() {
+    return import_api.trace.getActiveSpan();
+  }
+  static get() {
+    const telemetry = Telemetry.getGlobalInstance();
+    if (telemetry === void 0) {
+      throw new Error("Telemetry not initialized. Call Telemetry.registerGlobal() first.");
+    }
+    return telemetry;
+  }
+  static hasGlobalInstance() {
+    return Telemetry.getGlobalInstance() !== void 0;
+  }
+  static async shutdownGlobal() {
+    const telemetry = Telemetry.getGlobalInstance();
+    if (telemetry !== void 0) {
+      await telemetry.shutdown();
+    }
+    Telemetry.setGlobalInstance(void 0);
+    Telemetry._initPromise = void 0;
+  }
+  static setBaggage(baggage, ctx = import_api.context.active()) {
+    const currentBaggage = Object.fromEntries(
+      import_api.propagation.getBaggage(ctx)?.getAllEntries() ?? []
+    );
+    return import_api.propagation.setBaggage(
+      ctx,
+      import_api.propagation.createBaggage({
+        ...currentBaggage,
+        ...baggage
+      })
+    );
+  }
+  static withContext(ctx, fn) {
+    return import_api.context.with(ctx, fn);
+  }
+  isInitialized() {
+    return this._isInitialized;
+  }
+  async forceFlush() {
+    const provider = import_api.trace.getTracerProvider();
+    const forceFlush = Reflect.get(provider, "forceFlush");
+    if (typeof forceFlush === "function") {
+      await Reflect.apply(forceFlush, provider, []);
+    }
+  }
+  async shutdown() {
+    try {
+      await this._shutdownHandler?.();
+    } finally {
+      this._isInitialized = false;
+      this._shutdownHandler = void 0;
+      Telemetry.setGlobalInstance(void 0);
+      Telemetry._initPromise = void 0;
+    }
+  }
+  static getGlobalInstance() {
+    const telemetry = Reflect.get(globalThis, "__TELEMETRY__");
+    return isGlobalTelemetryLike(telemetry) ? telemetry : void 0;
+  }
+  static setGlobalInstance(telemetry) {
+    if (telemetry === void 0) {
+      Reflect.deleteProperty(globalThis, "__TELEMETRY__");
+      return;
+    }
+    Reflect.set(globalThis, "__TELEMETRY__", telemetry);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Telemetry
+});

package/dist/telemetry/browser.d.ts

@@ -0,0 +1,30 @@
+import type { BaggageEntry, Context, Tracer } from '@opentelemetry/api';
+import type { OtelConfiguration } from './schemas.js';
+export type TelemetryShutdownHandler = () => Promise<void>;
+export type TelemetryRegistrationOptions = {
+    config?: OtelConfiguration | undefined;
+    initialized?: boolean | undefined;
+    shutdown?: TelemetryShutdownHandler | undefined;
+};
+export type BrowserTelemetryInstance = Pick<Telemetry, 'forceFlush' | 'isInitialized' | 'name' | 'shutdown' | 'tracer'>;
+export declare class Telemetry {
+    tracer: Tracer;
+    name: string;
+    private _isInitialized;
+    private _shutdownHandler?;
+    private static _initPromise?;
+    private constructor();
+    static registerGlobal(options?: TelemetryRegistrationOptions): Promise<BrowserTelemetryInstance>;
+    static getActiveSpan(): import("@opentelemetry/api").Span | undefined;
+    static get(): BrowserTelemetryInstance;
+    static hasGlobalInstance(): boolean;
+    static shutdownGlobal(): Promise<void>;
+    static setBaggage(baggage: Record<string, BaggageEntry>, ctx?: Context): Context;
+    static withContext<T>(ctx: Context, fn: () => T): T;
+    isInitialized(): boolean;
+    forceFlush(): Promise<void>;
+    shutdown(): Promise<void>;
+    private static getGlobalInstance;
+    private static setGlobalInstance;
+}
+//# sourceMappingURL=browser.d.ts.map

package/dist/telemetry/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/telemetry/browser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtD,MAAM,MAAM,wBAAwB,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;AAE3D,MAAM,MAAM,4BAA4B,GAAG;IACvC,MAAM,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACvC,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,EAAE,wBAAwB,GAAG,SAAS,CAAC;CACnD,CAAC;AAOF,MAAM,MAAM,wBAAwB,GAAG,IAAI,CACvC,SAAS,EACT,YAAY,GAAG,eAAe,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,CAClE,CAAC;AAgBF,qBAAa,SAAS;IACX,MAAM,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,cAAc,CAAU;IAChC,OAAO,CAAC,gBAAgB,CAAC,CAAuC;IAChE,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAgD;IAE5E,OAAO;WAUM,cAAc,CACvB,OAAO,GAAE,4BAAiC,GAC3C,OAAO,CAAC,wBAAwB,CAAC;IA2BpC,MAAM,CAAC,aAAa;IAIpB,MAAM,CAAC,GAAG,IAAI,wBAAwB;IAQtC,MAAM,CAAC,iBAAiB,IAAI,OAAO;WAItB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5C,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,GAAG,GAAE,OAA8B;IAa5F,MAAM,CAAC,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IAI5C,aAAa,IAAI,OAAO;IAIlB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ3B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAWtC,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAKhC,OAAO,CAAC,MAAM,CAAC,iBAAiB;CAOnC"}

package/dist/telemetry/browser.js

@@ -0,0 +1,115 @@
+import "../chunk-C6A6W6XS.js";
+import { context as otlpContext, propagation, trace } from "@opentelemetry/api";
+function isGlobalTelemetryLike(value) {
+  if (typeof value !== "object" || value === null) {
+    return false;
+  }
+  return typeof Reflect.get(value, "forceFlush") === "function" && typeof Reflect.get(value, "isInitialized") === "function" && typeof Reflect.get(value, "name") === "string" && typeof Reflect.get(value, "shutdown") === "function" && Reflect.get(value, "tracer") !== void 0;
+}
+class Telemetry {
+  tracer;
+  name;
+  _isInitialized;
+  _shutdownHandler;
+  static _initPromise;
+  constructor(config, options) {
+    const serviceName = config.serviceName ?? "dexto-service";
+    const tracerName = config.tracerName ?? serviceName;
+    this.name = serviceName;
+    this.tracer = trace.getTracer(tracerName);
+    this._shutdownHandler = options.shutdown;
+    this._isInitialized = options.initialized;
+  }
+  static async registerGlobal(options = {}) {
+    const existing = Telemetry.getGlobalInstance();
+    if (existing !== void 0) {
+      return existing;
+    }
+    if (Telemetry._initPromise !== void 0) {
+      return Telemetry._initPromise;
+    }
+    Telemetry._initPromise = Promise.resolve().then(() => {
+      const current = Telemetry.getGlobalInstance();
+      if (current !== void 0) {
+        return current;
+      }
+      const telemetry = new Telemetry(options.config ?? {}, {
+        initialized: options.initialized ?? true,
+        ...options.shutdown !== void 0 && { shutdown: options.shutdown }
+      });
+      Telemetry.setGlobalInstance(telemetry);
+      return telemetry;
+    });
+    return Telemetry._initPromise;
+  }
+  static getActiveSpan() {
+    return trace.getActiveSpan();
+  }
+  static get() {
+    const telemetry = Telemetry.getGlobalInstance();
+    if (telemetry === void 0) {
+      throw new Error("Telemetry not initialized. Call Telemetry.registerGlobal() first.");
+    }
+    return telemetry;
+  }
+  static hasGlobalInstance() {
+    return Telemetry.getGlobalInstance() !== void 0;
+  }
+  static async shutdownGlobal() {
+    const telemetry = Telemetry.getGlobalInstance();
+    if (telemetry !== void 0) {
+      await telemetry.shutdown();
+    }
+    Telemetry.setGlobalInstance(void 0);
+    Telemetry._initPromise = void 0;
+  }
+  static setBaggage(baggage, ctx = otlpContext.active()) {
+    const currentBaggage = Object.fromEntries(
+      propagation.getBaggage(ctx)?.getAllEntries() ?? []
+    );
+    return propagation.setBaggage(
+      ctx,
+      propagation.createBaggage({
+        ...currentBaggage,
+        ...baggage
+      })
+    );
+  }
+  static withContext(ctx, fn) {
+    return otlpContext.with(ctx, fn);
+  }
+  isInitialized() {
+    return this._isInitialized;
+  }
+  async forceFlush() {
+    const provider = trace.getTracerProvider();
+    const forceFlush = Reflect.get(provider, "forceFlush");
+    if (typeof forceFlush === "function") {
+      await Reflect.apply(forceFlush, provider, []);
+    }
+  }
+  async shutdown() {
+    try {
+      await this._shutdownHandler?.();
+    } finally {
+      this._isInitialized = false;
+      this._shutdownHandler = void 0;
+      Telemetry.setGlobalInstance(void 0);
+      Telemetry._initPromise = void 0;
+    }
+  }
+  static getGlobalInstance() {
+    const telemetry = Reflect.get(globalThis, "__TELEMETRY__");
+    return isGlobalTelemetryLike(telemetry) ? telemetry : void 0;
+  }
+  static setGlobalInstance(telemetry) {
+    if (telemetry === void 0) {
+      Reflect.deleteProperty(globalThis, "__TELEMETRY__");
+      return;
+    }
+    Reflect.set(globalThis, "__TELEMETRY__", telemetry);
+  }
+}
+export {
+  Telemetry
+};

package/dist/telemetry/index.cjs

@@ -19,13 +19,16 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var telemetry_exports = {};
 __export(telemetry_exports, {
   OtelConfigurationSchema: () => import_schemas.OtelConfigurationSchema,
-  Telemetry: () => import_telemetry.Telemetry
+  Telemetry: () => import_telemetry.Telemetry,
+  recordOperationSpan: () => import_operation_span.recordOperationSpan
 });
 module.exports = __toCommonJS(telemetry_exports);
 var import_telemetry = require("./telemetry.js");
 var import_schemas = require("./schemas.js");
+var import_operation_span = require("./operation-span.js");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   OtelConfigurationSchema,
-  Telemetry
+  Telemetry,
+  recordOperationSpan
 });

package/dist/telemetry/index.d.ts

@@ -1,4 +1,5 @@
 export { Telemetry, type TelemetryRegistrationOptions, type TelemetryShutdownHandler, } from './telemetry.js';
 export { OtelConfigurationSchema } from './schemas.js';
 export type { OtelConfiguration } from './schemas.js';
+export { recordOperationSpan, type OperationSpanOptions } from './operation-span.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/telemetry/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,SAAS,EACT,KAAK,4BAA4B,EACjC,KAAK,wBAAwB,GAChC,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,SAAS,EACT,KAAK,4BAA4B,EACjC,KAAK,wBAAwB,GAChC,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/telemetry/index.js

@@ -3,7 +3,9 @@ import {
   Telemetry
 } from "./telemetry.js";
 import { OtelConfigurationSchema } from "./schemas.js";
+import { recordOperationSpan } from "./operation-span.js";
 export {
   OtelConfigurationSchema,
-  Telemetry
+  Telemetry,
+  recordOperationSpan
 };

package/dist/telemetry/operation-span.cjs

@@ -0,0 +1,73 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var operation_span_exports = {};
+__export(operation_span_exports, {
+  recordOperationSpan: () => recordOperationSpan
+});
+module.exports = __toCommonJS(operation_span_exports);
+var import_api = require("@opentelemetry/api");
+var import_utils = require("./utils.js");
+async function recordOperationSpan(options, operation, logger) {
+  const skipIfNoTelemetry = options.skipIfNoTelemetry ?? true;
+  if (skipIfNoTelemetry && !(0, import_utils.hasActiveTelemetry)(logger)) {
+    return operation();
+  }
+  const span = import_api.trace.getTracer(options.tracerName ?? "dexto").startSpan(options.name, { kind: import_api.SpanKind.INTERNAL });
+  const spanContext = import_api.trace.setSpan(import_api.context.active(), span);
+  (0, import_utils.addBaggageAttributesToSpan)(span, spanContext, logger);
+  if (options.componentName !== void 0) {
+    span.setAttribute("componentName", options.componentName);
+  }
+  setOperationSpanAttributes(span, options.attributes);
+  try {
+    const result = await import_api.context.with(spanContext, operation);
+    try {
+      setOperationSpanAttributes(span, options.resultAttributes?.(result));
+    } catch (error) {
+      logger?.debug("Failed to set OpenTelemetry result attributes", {
+        error: error instanceof Error ? error.message : String(error),
+        span: options.name
+      });
+    }
+    span.setStatus({ code: import_api.SpanStatusCode.OK });
+    return result;
+  } catch (error) {
+    if (error instanceof Error) {
+      span.recordException(error);
+      span.setStatus({ code: import_api.SpanStatusCode.ERROR, message: error.message });
+    } else {
+      span.setStatus({ code: import_api.SpanStatusCode.ERROR, message: String(error) });
+    }
+    throw error;
+  } finally {
+    span.end();
+  }
+}
+function setOperationSpanAttributes(span, attributes) {
+  if (span === void 0 || attributes === void 0) {
+    return;
+  }
+  for (const [key, value] of Object.entries(attributes)) {
+    span.setAttribute(key, value);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  recordOperationSpan
+});

package/dist/telemetry/operation-span.d.ts

@@ -0,0 +1,13 @@
+import type { Logger } from '../logger/v2/types.js';
+type OperationSpanAttributes = Record<string, string | number | boolean>;
+export type OperationSpanOptions<T> = {
+    attributes?: OperationSpanAttributes;
+    componentName?: string;
+    name: string;
+    resultAttributes?: (result: T) => OperationSpanAttributes | undefined;
+    skipIfNoTelemetry?: boolean;
+    tracerName?: string;
+};
+export declare function recordOperationSpan<T>(options: OperationSpanOptions<T>, operation: () => T | Promise<T>, logger?: Logger): Promise<T>;
+export {};
+//# sourceMappingURL=operation-span.d.ts.map

package/dist/telemetry/operation-span.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-span.d.ts","sourceRoot":"","sources":["../../src/telemetry/operation-span.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAGpD,KAAK,uBAAuB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;AAEzE,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAAI;IAClC,UAAU,CAAC,EAAE,uBAAuB,CAAC;IACrC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,uBAAuB,GAAG,SAAS,CAAC;IACtE,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,wBAAsB,mBAAmB,CAAC,CAAC,EACvC,OAAO,EAAE,oBAAoB,CAAC,CAAC,CAAC,EAChC,SAAS,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAC/B,MAAM,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,CAAC,CAAC,CAyCZ"}

package/dist/telemetry/operation-span.js

@@ -0,0 +1,50 @@
+import "../chunk-C6A6W6XS.js";
+import { context, SpanKind, SpanStatusCode, trace } from "@opentelemetry/api";
+import { addBaggageAttributesToSpan, hasActiveTelemetry } from "./utils.js";
+async function recordOperationSpan(options, operation, logger) {
+  const skipIfNoTelemetry = options.skipIfNoTelemetry ?? true;
+  if (skipIfNoTelemetry && !hasActiveTelemetry(logger)) {
+    return operation();
+  }
+  const span = trace.getTracer(options.tracerName ?? "dexto").startSpan(options.name, { kind: SpanKind.INTERNAL });
+  const spanContext = trace.setSpan(context.active(), span);
+  addBaggageAttributesToSpan(span, spanContext, logger);
+  if (options.componentName !== void 0) {
+    span.setAttribute("componentName", options.componentName);
+  }
+  setOperationSpanAttributes(span, options.attributes);
+  try {
+    const result = await context.with(spanContext, operation);
+    try {
+      setOperationSpanAttributes(span, options.resultAttributes?.(result));
+    } catch (error) {
+      logger?.debug("Failed to set OpenTelemetry result attributes", {
+        error: error instanceof Error ? error.message : String(error),
+        span: options.name
+      });
+    }
+    span.setStatus({ code: SpanStatusCode.OK });
+    return result;
+  } catch (error) {
+    if (error instanceof Error) {
+      span.recordException(error);
+      span.setStatus({ code: SpanStatusCode.ERROR, message: error.message });
+    } else {
+      span.setStatus({ code: SpanStatusCode.ERROR, message: String(error) });
+    }
+    throw error;
+  } finally {
+    span.end();
+  }
+}
+function setOperationSpanAttributes(span, attributes) {
+  if (span === void 0 || attributes === void 0) {
+    return;
+  }
+  for (const [key, value] of Object.entries(attributes)) {
+    span.setAttribute(key, value);
+  }
+}
+export {
+  recordOperationSpan
+};

package/dist/telemetry/telemetry.cjs

@@ -32,7 +32,6 @@ __export(telemetry_exports, {
 });
 module.exports = __toCommonJS(telemetry_exports);
 var import_api = require("@opentelemetry/api");
-var import_logger = require("../logger/logger.js");
 var import_errors = require("./errors.js");
 var import_DextoRuntimeError = require("../errors/DextoRuntimeError.js");
 class Telemetry {
@@ -318,7 +317,7 @@ class Telemetry {
       }
     } catch (error) {
       const errorMsg = error instanceof Error ? error.message : String(error);
-      import_logger.logger.warn(`Telemetry shutdown failed to flush spans (non-blocking): ${errorMsg}`);
+      console.warn(`Telemetry shutdown failed to flush spans (non-blocking): ${errorMsg}`);
     } finally {
       this.cleanupAfterShutdown();
     }
@@ -326,7 +325,7 @@ class Telemetry {
   cleanupAfterShutdown() {
     this._isInitialized = false;
     globalThis.__TELEMETRY__ = void 0;
-    if (Telemetry._signalHandlers) {
+    if (Telemetry._signalHandlers && typeof process !== "undefined") {
       process.off("SIGTERM", Telemetry._signalHandlers.sigterm);
       process.off("SIGINT", Telemetry._signalHandlers.sigint);
       Telemetry._signalHandlers = void 0;

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

@@ -1 +1 @@
-{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../src/telemetry/telemetry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAUtD,MAAM,MAAM,wBAAwB,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;AAE3D,MAAM,MAAM,4BAA4B,GAAG;IACvC,MAAM,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACvC,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,EAAE,wBAAwB,GAAG,SAAS,CAAC;CACnD,CAAC;AASF,OAAO,CAAC,MAAM,CAAC;IACX,IAAI,aAAa,EAAE,SAAS,GAAG,SAAS,CAAC;CAC5C;AAED;;;;;;;;GAQG;AACH,qBAAa,SAAS;IACX,MAAM,EAAE,MAAM,CAA4B;IACjD,IAAI,EAAE,MAAM,CAAmB;IAC/B,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,IAAI,CAAC,CAA0B;IACvC,OAAO,CAAC,gBAAgB,CAAC,CAAuC;IAChE,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAiC;IAC7D,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,CAA0D;IAEzF,OAAO;mBAWc,kBAAkB;IA0DvC;;;;;OAKG;WACU,IAAI,CACb,MAAM,GAAE,iBAAsB,EAC9B,QAAQ,CAAC,EAAE,OAAO,+BAA+B,EAAE,YAAY,GAChE,OAAO,CAAC,SAAS,CAAC;IAiIrB;;;;OAIG;WACU,cAAc,CAAC,OAAO,GAAE,4BAAiC,GAAG,OAAO,CAAC,SAAS,CAAC;IAiC3F,MAAM,CAAC,aAAa;IAKpB;;;;OAIG;IACH,MAAM,CAAC,GAAG,IAAI,SAAS;IAOvB;;;OAGG;IACH,MAAM,CAAC,iBAAiB,IAAI,OAAO;IAInC;;;;;OAKG;WACU,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5C;;;OAGG;IACI,aAAa,IAAI,OAAO;IAI/B,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,GAAG,GAAE,OAA8B;IAc5F,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,IAAI;IAI/C;;;OAGG;IACU,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAUxC;;;;;;;;;OASG;IACU,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBtC,OAAO,CAAC,oBAAoB;CAiB/B"}
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../src/telemetry/telemetry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAStD,MAAM,MAAM,wBAAwB,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;AAE3D,MAAM,MAAM,4BAA4B,GAAG;IACvC,MAAM,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACvC,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,EAAE,wBAAwB,GAAG,SAAS,CAAC;CACnD,CAAC;AASF,OAAO,CAAC,MAAM,CAAC;IACX,IAAI,aAAa,EAAE,SAAS,GAAG,SAAS,CAAC;CAC5C;AAED;;;;;;;;GAQG;AACH,qBAAa,SAAS;IACX,MAAM,EAAE,MAAM,CAA4B;IACjD,IAAI,EAAE,MAAM,CAAmB;IAC/B,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,IAAI,CAAC,CAA0B;IACvC,OAAO,CAAC,gBAAgB,CAAC,CAAuC;IAChE,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAiC;IAC7D,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,CAA0D;IAEzF,OAAO;mBAWc,kBAAkB;IA0DvC;;;;;OAKG;WACU,IAAI,CACb,MAAM,GAAE,iBAAsB,EAC9B,QAAQ,CAAC,EAAE,OAAO,+BAA+B,EAAE,YAAY,GAChE,OAAO,CAAC,SAAS,CAAC;IAiIrB;;;;OAIG;WACU,cAAc,CAAC,OAAO,GAAE,4BAAiC,GAAG,OAAO,CAAC,SAAS,CAAC;IAiC3F,MAAM,CAAC,aAAa;IAKpB;;;;OAIG;IACH,MAAM,CAAC,GAAG,IAAI,SAAS;IAOvB;;;OAGG;IACH,MAAM,CAAC,iBAAiB,IAAI,OAAO;IAInC;;;;;OAKG;WACU,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5C;;;OAGG;IACI,aAAa,IAAI,OAAO;IAI/B,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,GAAG,GAAE,OAA8B;IAc5F,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,IAAI;IAI/C;;;OAGG;IACU,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAUxC;;;;;;;;;OASG;IACU,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBtC,OAAO,CAAC,oBAAoB;CAiB/B"}

package/dist/telemetry/telemetry.js

@@ -1,6 +1,5 @@
 import "../chunk-C6A6W6XS.js";
 import { context as otlpContext, trace, propagation } from "@opentelemetry/api";
-import { logger } from "../logger/logger.js";
 import { TelemetryError } from "./errors.js";
 import { DextoRuntimeError } from "../errors/DextoRuntimeError.js";
 class Telemetry {
@@ -286,7 +285,7 @@ class Telemetry {
       }
     } catch (error) {
       const errorMsg = error instanceof Error ? error.message : String(error);
-      logger.warn(`Telemetry shutdown failed to flush spans (non-blocking): ${errorMsg}`);
+      console.warn(`Telemetry shutdown failed to flush spans (non-blocking): ${errorMsg}`);
     } finally {
       this.cleanupAfterShutdown();
     }
@@ -294,7 +293,7 @@ class Telemetry {
   cleanupAfterShutdown() {
     this._isInitialized = false;
     globalThis.__TELEMETRY__ = void 0;
-    if (Telemetry._signalHandlers) {
+    if (Telemetry._signalHandlers && typeof process !== "undefined") {
       process.off("SIGTERM", Telemetry._signalHandlers.sigterm);
       process.off("SIGINT", Telemetry._signalHandlers.sigint);
       Telemetry._signalHandlers = void 0;