@dexto/core 1.8.3 → 1.8.4

package/dist/llm/executor/turn-executor.js

@@ -13,9 +13,11 @@ import { StreamProcessor } from "./stream-processor.js";
 import { truncateToolResult } from "./tool-output-truncator.js";
 import { buildProviderOptions, getEffectiveReasoningBudgetTokens } from "./provider-options.js";
 import { DextoLogComponent } from "../../logger/v2/types.js";
-import { DextoRuntimeError } from "../../errors/DextoRuntimeError.js";
-import { ErrorScope, ErrorType } from "../../errors/types.js";
-import { LLMErrorCode } from "../error-codes.js";
+import { recordOperationSpan } from "../../telemetry/operation-span.js";
+import {
+  extractProviderErrorDetails,
+  mapProviderError as mapCoreProviderError
+} from "./provider-error.js";
 import { toError } from "../../utils/error-conversion.js";
 import { isCodexBaseURL } from "../providers/codex-base-url.js";
 import { createModelToolDefinitions } from "./tool-definitions.js";
@@ -350,11 +352,19 @@ class TurnExecutor {
         this.currentModelStepId = `in-memory-model-step-${stepCount}`;
         modelStepPreparing = true;
         try {
-          preparedModelRequest = await this.prepareNextModelRequest({
-            contributorContext,
-            supportsTools: turn.supportsTools,
-            streaming: options.streaming
-          });
+          preparedModelRequest = await recordOperationSpan(
+            {
+              name: "turn.prepare_model_step",
+              componentName: "TurnExecutor",
+              attributes: { "turn.step_count": stepCount }
+            },
+            () => this.prepareNextModelRequest({
+              contributorContext,
+              supportsTools: turn.supportsTools,
+              streaming: options.streaming
+            }),
+            this.logger
+          );
         } catch (error) {
           currentStepScope[Symbol.dispose]();
           currentStepScope = null;
@@ -380,11 +390,19 @@ class TurnExecutor {
             }
             currentStepScope = this.startModelStepScope();
             this.currentModelStepId = `in-memory-model-step-${stepCount}`;
-            preparedModelRequest = await this.prepareNextModelRequest({
-              contributorContext,
-              supportsTools: turn.supportsTools,
-              streaming: options.streaming
-            });
+            preparedModelRequest = await recordOperationSpan(
+              {
+                name: "turn.prepare_model_step",
+                componentName: "TurnExecutor",
+                attributes: { "turn.step_count": stepCount }
+              },
+              () => this.prepareNextModelRequest({
+                contributorContext,
+                supportsTools: turn.supportsTools,
+                streaming: options.streaming
+              }),
+              this.logger
+            );
           }
           const modelStepRequest = preparedModelRequest;
           if (currentStepScope === null || modelStepRequest === null) {
@@ -576,7 +594,13 @@ class TurnExecutor {
     this.eventBus.emit("llm:error", {
       error: mappedError,
       context: "TurnExecutor",
-      recoverable: false
+      recoverable: false,
+      details: extractProviderErrorDetails({
+        error,
+        provider: this.llmContext.provider,
+        model: this.llmContext.model,
+        sessionId: this.sessionId
+      })
     });
     await this.contextManager.flush();
     this.eventBus.emit("run:complete", {
@@ -773,48 +797,159 @@ class TurnExecutor {
       await this.injectQueuedMessages(coalesced);
     }
     await this.pruneOldToolOutputs();
-    let prepared = await this.contextManager.getFormattedMessagesForLLM(
-      input.contributorContext,
-      this.llmContext
+    let systemPrompt = await recordOperationSpan(
+      {
+        name: "system_prompt.build",
+        componentName: "TurnExecutor",
+        attributes: {
+          "llm.model": this.llmContext.model,
+          "llm.provider": this.llmContext.provider
+        }
+      },
+      () => this.contextManager.getSystemPrompt(input.contributorContext),
+      this.logger
     );
-    const toolDefinitions = input.supportsTools ? this.toolManager.filterToolsForSession(
-      await this.toolManager.getAllTools(),
-      this.sessionId
+    let { preparedHistory, formattedMessages } = await recordOperationSpan(
+      {
+        name: "context.build_messages",
+        componentName: "TurnExecutor",
+        attributes: {
+          "llm.model": this.llmContext.model,
+          "llm.provider": this.llmContext.provider
+        }
+      },
+      async () => {
+        const preparedHistory2 = (await this.contextManager.prepareHistory()).preparedHistory;
+        const formattedMessages2 = await this.contextManager.getFormattedMessages(
+          input.contributorContext,
+          this.llmContext,
+          systemPrompt,
+          preparedHistory2
+        );
+        return { preparedHistory: preparedHistory2, formattedMessages: formattedMessages2 };
+      },
+      this.logger
+    );
+    const toolDefinitions = input.supportsTools ? await recordOperationSpan(
+      {
+        name: "tools.list",
+        componentName: "TurnExecutor",
+        attributes: { "tools.supports": input.supportsTools },
+        resultAttributes: (tools) => ({ "tools.count": Object.keys(tools).length })
+      },
+      async () => this.toolManager.filterToolsForSession(
+        await this.toolManager.getAllTools(),
+        this.sessionId
+      ),
+      this.logger
     ) : {};
-    let estimatedInputTokens = await this.contextManager.getEstimatedNextInputTokens(
-      prepared.systemPrompt,
-      prepared.preparedHistory,
-      toolDefinitions
+    let estimatedInputTokens = await recordOperationSpan(
+      {
+        name: "context.token_estimate",
+        componentName: "TurnExecutor",
+        attributes: { "tools.count": Object.keys(toolDefinitions).length },
+        resultAttributes: (tokens) => ({ "context.estimated_input_tokens": tokens })
+      },
+      () => this.contextManager.getEstimatedNextInputTokens(
+        systemPrompt,
+        preparedHistory,
+        toolDefinitions
+      ),
+      this.logger
     );
     if (this.shouldCompact(estimatedInputTokens)) {
       this.logger.debug(
         `Pre-check: estimated ${estimatedInputTokens} tokens exceeds threshold, compacting`
       );
-      const didCompact = await this.compactContext(
-        estimatedInputTokens,
-        input.contributorContext,
-        toolDefinitions
+      const didCompact = await recordOperationSpan(
+        {
+          name: "context.compact",
+          componentName: "TurnExecutor",
+          attributes: { "context.estimated_input_tokens": estimatedInputTokens }
+        },
+        () => this.compactContext(
+          estimatedInputTokens,
+          input.contributorContext,
+          toolDefinitions
+        ),
+        this.logger
       );
       if (didCompact) {
-        prepared = await this.contextManager.getFormattedMessagesForLLM(
-          input.contributorContext,
-          this.llmContext
+        systemPrompt = await recordOperationSpan(
+          {
+            name: "system_prompt.build",
+            componentName: "TurnExecutor",
+            attributes: {
+              "context.after_compaction": true,
+              "llm.model": this.llmContext.model,
+              "llm.provider": this.llmContext.provider
+            }
+          },
+          () => this.contextManager.getSystemPrompt(input.contributorContext),
+          this.logger
         );
-        estimatedInputTokens = await this.contextManager.getEstimatedNextInputTokens(
-          prepared.systemPrompt,
-          prepared.preparedHistory,
-          toolDefinitions
+        ({ preparedHistory, formattedMessages } = await recordOperationSpan(
+          {
+            name: "context.build_messages",
+            componentName: "TurnExecutor",
+            attributes: {
+              "context.after_compaction": true,
+              "llm.model": this.llmContext.model,
+              "llm.provider": this.llmContext.provider
+            }
+          },
+          async () => {
+            const preparedHistory2 = (await this.contextManager.prepareHistory()).preparedHistory;
+            const formattedMessages2 = await this.contextManager.getFormattedMessages(
+              input.contributorContext,
+              this.llmContext,
+              systemPrompt,
+              preparedHistory2
+            );
+            return { preparedHistory: preparedHistory2, formattedMessages: formattedMessages2 };
+          },
+          this.logger
+        ));
+        estimatedInputTokens = await recordOperationSpan(
+          {
+            name: "context.token_estimate",
+            componentName: "TurnExecutor",
+            attributes: {
+              "context.after_compaction": true,
+              "tools.count": Object.keys(toolDefinitions).length
+            },
+            resultAttributes: (tokens) => ({
+              "context.estimated_input_tokens": tokens
+            })
+          },
+          () => this.contextManager.getEstimatedNextInputTokens(
+            systemPrompt,
+            preparedHistory,
+            toolDefinitions
+          ),
+          this.logger
         );
         this.logger.debug(
           `Post-compaction: recomputed estimate is ${estimatedInputTokens} tokens`
         );
       }
     }
-    const providerOptions = buildProviderOptions({
-      provider: this.llmContext.provider,
-      model: this.llmContext.model,
-      reasoning: this.config.reasoning
-    });
+    const providerOptions = await recordOperationSpan(
+      {
+        name: "llm.request_setup",
+        componentName: "TurnExecutor",
+        attributes: {
+          "llm.model": this.llmContext.model,
+          "llm.provider": this.llmContext.provider
+        }
+      },
+      () => buildProviderOptions({
+        provider: this.llmContext.provider,
+        model: this.llmContext.model,
+        reasoning: this.config.reasoning
+      }),
+      this.logger
+    );
     this.logger.debug("LLM request options", {
       provider: this.llmContext.provider,
       model: this.llmContext.model,
@@ -831,7 +966,7 @@ class TurnExecutor {
       ...reasoningBudgetTokens !== void 0 && { reasoningBudgetTokens }
     } : void 0;
     return {
-      messages: prepared.formattedMessages,
+      messages: formattedMessages,
       tools: input.supportsTools ? createModelToolDefinitions(toolDefinitions) : {},
       toolDefinitions,
       estimatedInputTokens,
@@ -862,7 +997,8 @@ class TurnExecutor {
       this.stepAbortController.signal,
       this.getStreamProcessorConfig(request.estimatedInputTokens, request.reasoning),
       this.logger,
-      request.streaming
+      request.streaming,
+      false
     );
     return streamProcessor.process(
       () => streamText({
@@ -1499,84 +1635,12 @@ class TurnExecutor {
    * Map provider errors to DextoRuntimeError.
    */
   mapProviderError(err) {
-    if (APICallError.isInstance?.(err)) {
-      const status = err.statusCode;
-      const headers = err.responseHeaders || {};
-      const retryAfter = headers["retry-after"] ? Number(headers["retry-after"]) : void 0;
-      const body = typeof err.responseBody === "string" ? err.responseBody : JSON.stringify(err.responseBody ?? "");
-      if (status === 402) {
-        let balance;
-        try {
-          const parsed = JSON.parse(body);
-          const msg = parsed?.error?.message || "";
-          const match = msg.match(/Balance:\s*\$?([\d.]+)/i);
-          if (match) {
-            balance = parseFloat(match[1]);
-          }
-        } catch {
-        }
-        return new DextoRuntimeError(
-          LLMErrorCode.INSUFFICIENT_CREDITS,
-          ErrorScope.LLM,
-          ErrorType.PAYMENT_REQUIRED,
-          `Insufficient Dexto credits${balance !== void 0 ? `. Balance: $${balance.toFixed(2)}` : ""}`,
-          {
-            sessionId: this.sessionId,
-            provider: this.llmContext.provider,
-            model: this.llmContext.model,
-            status,
-            balance,
-            body
-          },
-          "Run `dexto billing` to check your balance"
-        );
-      }
-      if (status === 429) {
-        return new DextoRuntimeError(
-          LLMErrorCode.RATE_LIMIT_EXCEEDED,
-          ErrorScope.LLM,
-          ErrorType.RATE_LIMIT,
-          `Rate limit exceeded${body ? ` - ${body}` : ""}`,
-          {
-            sessionId: this.sessionId,
-            provider: this.llmContext.provider,
-            model: this.llmContext.model,
-            status,
-            retryAfter,
-            body
-          }
-        );
-      }
-      if (status === 408) {
-        return new DextoRuntimeError(
-          LLMErrorCode.GENERATION_FAILED,
-          ErrorScope.LLM,
-          ErrorType.TIMEOUT,
-          `Provider timed out${body ? ` - ${body}` : ""}`,
-          {
-            sessionId: this.sessionId,
-            provider: this.llmContext.provider,
-            model: this.llmContext.model,
-            status,
-            body
-          }
-        );
-      }
-      return new DextoRuntimeError(
-        LLMErrorCode.GENERATION_FAILED,
-        ErrorScope.LLM,
-        ErrorType.THIRD_PARTY,
-        `Provider error ${status}${body ? ` - ${body}` : ""}`,
-        {
-          sessionId: this.sessionId,
-          provider: this.llmContext.provider,
-          model: this.llmContext.model,
-          status,
-          body
-        }
-      );
-    }
-    return toError(err, this.logger);
+    return mapCoreProviderError({
+      error: err,
+      provider: this.llmContext.provider,
+      model: this.llmContext.model,
+      sessionId: this.sessionId
+    });
   }
 }
 export {

package/dist/session/title-generator.cjs

@@ -53,9 +53,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" };
@@ -68,6 +71,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/session/title-generator.d.ts

@@ -1,10 +1,18 @@
 import type { ValidatedLLMConfig } from '../llm/schemas.js';
 import type { Logger } from '../logger/v2/types.js';
 import type { DextoProviderContext, LanguageModelFactory } from '../llm/services/types.js';
+export interface GenerateSessionTitleTokenUsage {
+    cachedInputTokens?: number;
+    inputTokens?: number;
+    outputTokens?: number;
+    reasoningTokens?: number;
+    totalTokens?: number;
+}
 export interface GenerateSessionTitleResult {
     title?: string;
     error?: string;
     timedOut?: boolean;
+    usage?: GenerateSessionTitleTokenUsage;
 }
 /**
  * Generate a concise title for a chat based on the first user message.

package/dist/session/title-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"title-generator.d.ts","sourceRoot":"","sources":["../../src/session/title-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAI3F,MAAM,WAAW,0BAA0B;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACtC,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,GAAE;IACF,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,eAAe,CAAC,EAAE,oBAAoB,CAAC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;CACjB,GACP,OAAO,CAAC,0BAA0B,CAAC,CAgDrC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CA8BzE"}
+{"version":3,"file":"title-generator.d.ts","sourceRoot":"","sources":["../../src/session/title-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAI3F,MAAM,WAAW,8BAA8B;IAC3C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,0BAA0B;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,8BAA8B,CAAC;CAC1C;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACtC,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,GAAE;IACF,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,eAAe,CAAC,EAAE,oBAAoB,CAAC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;CACjB,GACP,OAAO,CAAC,0BAA0B,CAAC,CAmDrC;AAsBD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CA8BzE"}

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
+});