@dexto/core 1.2.6 → 1.3.0

package/dist/telemetry/errors.cjs

@@ -0,0 +1,105 @@
+"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 errors_exports = {};
+__export(errors_exports, {
+  TelemetryError: () => TelemetryError
+});
+module.exports = __toCommonJS(errors_exports);
+var import_DextoRuntimeError = require("../errors/DextoRuntimeError.js");
+var import_types = require("../errors/types.js");
+var import_error_codes = require("./error-codes.js");
+class TelemetryError {
+  /**
+   * Required OpenTelemetry dependencies not installed
+   */
+  static dependencyNotInstalled(packages) {
+    return new import_DextoRuntimeError.DextoRuntimeError(
+      import_error_codes.TelemetryErrorCode.DEPENDENCY_NOT_INSTALLED,
+      import_types.ErrorScope.TELEMETRY,
+      import_types.ErrorType.USER,
+      "Telemetry is enabled but required OpenTelemetry packages are not installed.",
+      {
+        packages,
+        hint: `Install with: npm install ${packages.join(" ")}`,
+        recovery: "Or disable telemetry by setting enabled: false in your configuration."
+      }
+    );
+  }
+  /**
+   * Specific exporter dependency not installed (gRPC or HTTP)
+   */
+  static exporterDependencyNotInstalled(exporterType, packageName) {
+    return new import_DextoRuntimeError.DextoRuntimeError(
+      import_error_codes.TelemetryErrorCode.EXPORTER_DEPENDENCY_NOT_INSTALLED,
+      import_types.ErrorScope.TELEMETRY,
+      import_types.ErrorType.USER,
+      `OTLP ${exporterType.toUpperCase()} exporter configured but '${packageName}' is not installed.`,
+      {
+        exporterType,
+        packageName,
+        hint: `Install with: npm install ${packageName}`
+      }
+    );
+  }
+  /**
+   * Telemetry initialization failed
+   */
+  static initializationFailed(reason, originalError) {
+    return new import_DextoRuntimeError.DextoRuntimeError(
+      import_error_codes.TelemetryErrorCode.INITIALIZATION_FAILED,
+      import_types.ErrorScope.TELEMETRY,
+      import_types.ErrorType.SYSTEM,
+      `Failed to initialize telemetry: ${reason}`,
+      {
+        reason,
+        originalError: originalError instanceof Error ? originalError.message : String(originalError)
+      }
+    );
+  }
+  /**
+   * Telemetry not initialized when expected
+   */
+  static notInitialized() {
+    return new import_DextoRuntimeError.DextoRuntimeError(
+      import_error_codes.TelemetryErrorCode.NOT_INITIALIZED,
+      import_types.ErrorScope.TELEMETRY,
+      import_types.ErrorType.USER,
+      "Telemetry not initialized. Call Telemetry.init() first.",
+      {
+        hint: "Ensure telemetry is initialized before accessing the global instance."
+      }
+    );
+  }
+  /**
+   * Telemetry shutdown failed (non-blocking warning)
+   */
+  static shutdownFailed(reason) {
+    return new import_DextoRuntimeError.DextoRuntimeError(
+      import_error_codes.TelemetryErrorCode.SHUTDOWN_FAILED,
+      import_types.ErrorScope.TELEMETRY,
+      import_types.ErrorType.SYSTEM,
+      `Telemetry shutdown failed: ${reason}`,
+      { reason }
+    );
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  TelemetryError
+});

package/dist/telemetry/errors.d.ts

@@ -0,0 +1,28 @@
+import { DextoRuntimeError } from '../errors/DextoRuntimeError.js';
+/**
+ * Telemetry error factory with typed methods for creating telemetry-specific errors
+ * Each method creates a properly typed error with TELEMETRY scope
+ */
+export declare class TelemetryError {
+    /**
+     * Required OpenTelemetry dependencies not installed
+     */
+    static dependencyNotInstalled(packages: string[]): DextoRuntimeError;
+    /**
+     * Specific exporter dependency not installed (gRPC or HTTP)
+     */
+    static exporterDependencyNotInstalled(exporterType: 'grpc' | 'http', packageName: string): DextoRuntimeError;
+    /**
+     * Telemetry initialization failed
+     */
+    static initializationFailed(reason: string, originalError?: unknown): DextoRuntimeError;
+    /**
+     * Telemetry not initialized when expected
+     */
+    static notInitialized(): DextoRuntimeError;
+    /**
+     * Telemetry shutdown failed (non-blocking warning)
+     */
+    static shutdownFailed(reason: string): DextoRuntimeError;
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/telemetry/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAInE;;;GAGG;AACH,qBAAa,cAAc;IACvB;;OAEG;IACH,MAAM,CAAC,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,iBAAiB;IAcpE;;OAEG;IACH,MAAM,CAAC,8BAA8B,CACjC,YAAY,EAAE,MAAM,GAAG,MAAM,EAC7B,WAAW,EAAE,MAAM,GACpB,iBAAiB;IAcpB;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,OAAO,GAAG,iBAAiB;IAcvF;;OAEG;IACH,MAAM,CAAC,cAAc,IAAI,iBAAiB;IAY1C;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB;CAS3D"}

package/dist/telemetry/errors.js

@@ -0,0 +1,82 @@
+import "../chunk-C6A6W6XS.js";
+import { DextoRuntimeError } from "../errors/DextoRuntimeError.js";
+import { ErrorScope, ErrorType } from "../errors/types.js";
+import { TelemetryErrorCode } from "./error-codes.js";
+class TelemetryError {
+  /**
+   * Required OpenTelemetry dependencies not installed
+   */
+  static dependencyNotInstalled(packages) {
+    return new DextoRuntimeError(
+      TelemetryErrorCode.DEPENDENCY_NOT_INSTALLED,
+      ErrorScope.TELEMETRY,
+      ErrorType.USER,
+      "Telemetry is enabled but required OpenTelemetry packages are not installed.",
+      {
+        packages,
+        hint: `Install with: npm install ${packages.join(" ")}`,
+        recovery: "Or disable telemetry by setting enabled: false in your configuration."
+      }
+    );
+  }
+  /**
+   * Specific exporter dependency not installed (gRPC or HTTP)
+   */
+  static exporterDependencyNotInstalled(exporterType, packageName) {
+    return new DextoRuntimeError(
+      TelemetryErrorCode.EXPORTER_DEPENDENCY_NOT_INSTALLED,
+      ErrorScope.TELEMETRY,
+      ErrorType.USER,
+      `OTLP ${exporterType.toUpperCase()} exporter configured but '${packageName}' is not installed.`,
+      {
+        exporterType,
+        packageName,
+        hint: `Install with: npm install ${packageName}`
+      }
+    );
+  }
+  /**
+   * Telemetry initialization failed
+   */
+  static initializationFailed(reason, originalError) {
+    return new DextoRuntimeError(
+      TelemetryErrorCode.INITIALIZATION_FAILED,
+      ErrorScope.TELEMETRY,
+      ErrorType.SYSTEM,
+      `Failed to initialize telemetry: ${reason}`,
+      {
+        reason,
+        originalError: originalError instanceof Error ? originalError.message : String(originalError)
+      }
+    );
+  }
+  /**
+   * Telemetry not initialized when expected
+   */
+  static notInitialized() {
+    return new DextoRuntimeError(
+      TelemetryErrorCode.NOT_INITIALIZED,
+      ErrorScope.TELEMETRY,
+      ErrorType.USER,
+      "Telemetry not initialized. Call Telemetry.init() first.",
+      {
+        hint: "Ensure telemetry is initialized before accessing the global instance."
+      }
+    );
+  }
+  /**
+   * Telemetry shutdown failed (non-blocking warning)
+   */
+  static shutdownFailed(reason) {
+    return new DextoRuntimeError(
+      TelemetryErrorCode.SHUTDOWN_FAILED,
+      ErrorScope.TELEMETRY,
+      ErrorType.SYSTEM,
+      `Telemetry shutdown failed: ${reason}`,
+      { reason }
+    );
+  }
+}
+export {
+  TelemetryError
+};

package/dist/telemetry/telemetry.cjs

@@ -1,7 +1,9 @@
 "use strict";
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -15,6 +17,14 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var telemetry_exports = {};
 __export(telemetry_exports, {
@@ -22,15 +32,9 @@ __export(telemetry_exports, {
 });
 module.exports = __toCommonJS(telemetry_exports);
 var import_api = require("@opentelemetry/api");
-var import_sdk_node = require("@opentelemetry/sdk-node");
-var import_sdk_trace_base = require("@opentelemetry/sdk-trace-base");
-var import_exporter_trace_otlp_http = require("@opentelemetry/exporter-trace-otlp-http");
-var import_exporter_trace_otlp_grpc = require("@opentelemetry/exporter-trace-otlp-grpc");
-var import_auto_instrumentations_node = require("@opentelemetry/auto-instrumentations-node");
-var import_resources = require("@opentelemetry/resources");
-var import_semantic_conventions = require("@opentelemetry/semantic-conventions");
-var import_exporters = require("./exporters.js");
 var import_logger = require("../logger/logger.js");
+var import_errors = require("./errors.js");
+var import_DextoRuntimeError = require("../errors/DextoRuntimeError.js");
 class Telemetry {
   tracer = import_api.trace.getTracer("dexto");
   name = "dexto-service";
@@ -48,18 +52,47 @@ class Telemetry {
     }
     this._isInitialized = enabled && !!sdk;
   }
-  static buildTraceExporter(config) {
+  static async buildTraceExporter(config) {
     const e = config?.export;
     if (!e || e.type === "console") {
-      return new import_sdk_trace_base.ConsoleSpanExporter();
+      const { ConsoleSpanExporter: ConsoleSpanExporter2 } = await import("@opentelemetry/sdk-trace-base");
+      return new ConsoleSpanExporter2();
     }
     if (e.type === "otlp") {
       if (e.protocol === "grpc") {
+        let OTLPGrpcExporter;
+        try {
+          const mod = await import("@opentelemetry/exporter-trace-otlp-grpc");
+          OTLPGrpcExporter = mod.OTLPTraceExporter;
+        } catch (err) {
+          const error = err;
+          if (error.code === "ERR_MODULE_NOT_FOUND") {
+            throw import_errors.TelemetryError.exporterDependencyNotInstalled(
+              "grpc",
+              "@opentelemetry/exporter-trace-otlp-grpc"
+            );
+          }
+          throw err;
+        }
         const options2 = {};
         if (e.endpoint) {
           options2.url = e.endpoint;
         }
-        return new import_exporter_trace_otlp_grpc.OTLPTraceExporter(options2);
+        return new OTLPGrpcExporter(options2);
+      }
+      let OTLPHttpExporter;
+      try {
+        const mod = await import("@opentelemetry/exporter-trace-otlp-http");
+        OTLPHttpExporter = mod.OTLPTraceExporter;
+      } catch (err) {
+        const error = err;
+        if (error.code === "ERR_MODULE_NOT_FOUND") {
+          throw import_errors.TelemetryError.exporterDependencyNotInstalled(
+            "http",
+            "@opentelemetry/exporter-trace-otlp-http"
+          );
+        }
+        throw err;
       }
       const options = {};
       if (e.endpoint) {
@@ -68,9 +101,10 @@ class Telemetry {
       if (e.headers) {
         options.headers = e.headers;
       }
-      return new import_exporter_trace_otlp_http.OTLPTraceExporter(options);
+      return new OTLPHttpExporter(options);
     }
-    return new import_sdk_trace_base.ConsoleSpanExporter();
+    const { ConsoleSpanExporter } = await import("@opentelemetry/sdk-trace-base");
+    return new ConsoleSpanExporter();
   }
   /**
    * Initialize telemetry with the given configuration
@@ -87,15 +121,44 @@ class Telemetry {
           const enabled = config.enabled !== false;
           let sdk;
           if (enabled) {
-            const resource = new import_resources.Resource({
-              [import_semantic_conventions.ATTR_SERVICE_NAME]: config.serviceName ?? "dexto-service"
+            let NodeSDK;
+            let Resource;
+            let getNodeAutoInstrumentations;
+            let ATTR_SERVICE_NAME;
+            try {
+              const sdkModule = await import("@opentelemetry/sdk-node");
+              NodeSDK = sdkModule.NodeSDK;
+              const resourcesModule = await import("@opentelemetry/resources");
+              Resource = resourcesModule.Resource;
+              const autoInstModule = await import("@opentelemetry/auto-instrumentations-node");
+              getNodeAutoInstrumentations = autoInstModule.getNodeAutoInstrumentations;
+              const semanticModule = await import("@opentelemetry/semantic-conventions");
+              ATTR_SERVICE_NAME = semanticModule.ATTR_SERVICE_NAME;
+            } catch (importError) {
+              const err = importError;
+              if (err.code === "ERR_MODULE_NOT_FOUND") {
+                throw import_errors.TelemetryError.dependencyNotInstalled([
+                  "@opentelemetry/sdk-node",
+                  "@opentelemetry/auto-instrumentations-node",
+                  "@opentelemetry/resources",
+                  "@opentelemetry/semantic-conventions",
+                  "@opentelemetry/sdk-trace-base",
+                  "@opentelemetry/exporter-trace-otlp-http",
+                  "@opentelemetry/exporter-trace-otlp-grpc"
+                ]);
+              }
+              throw importError;
+            }
+            const resource = new Resource({
+              [ATTR_SERVICE_NAME]: config.serviceName ?? "dexto-service"
             });
-            const spanExporter = exporter || Telemetry.buildTraceExporter(config);
-            const traceExporter = spanExporter instanceof import_exporters.CompositeExporter ? spanExporter : new import_exporters.CompositeExporter([spanExporter]);
-            sdk = new import_sdk_node.NodeSDK({
+            const spanExporter = exporter || await Telemetry.buildTraceExporter(config);
+            const { CompositeExporter } = await import("./exporters.js");
+            const traceExporter = spanExporter instanceof CompositeExporter ? spanExporter : new CompositeExporter([spanExporter]);
+            sdk = new NodeSDK({
               resource,
               traceExporter,
-              instrumentations: [(0, import_auto_instrumentations_node.getNodeAutoInstrumentations)()]
+              instrumentations: [getNodeAutoInstrumentations()]
             });
             await sdk.start();
             const sigterm = () => {
@@ -112,13 +175,16 @@ class Telemetry {
         }
         return globalThis.__TELEMETRY__;
       })();
-      return Telemetry._initPromise;
+      return await Telemetry._initPromise;
     } catch (error) {
-      const wrappedError = new Error(
-        `Failed to initialize telemetry: ${error instanceof Error ? error.message : String(error)}`
-      );
       Telemetry._initPromise = void 0;
-      throw wrappedError;
+      if (error instanceof import_DextoRuntimeError.DextoRuntimeError) {
+        throw error;
+      }
+      throw import_errors.TelemetryError.initializationFailed(
+        error instanceof Error ? error.message : String(error),
+        error
+      );
     }
   }
   static getActiveSpan() {
@@ -127,12 +193,12 @@ class Telemetry {
   }
   /**
    * Get the global telemetry instance
-   * @throws {Error} If telemetry has not been initialized
+   * @throws {DextoRuntimeError} If telemetry has not been initialized
    * @returns {Telemetry} The global telemetry instance
    */
   static get() {
     if (!globalThis.__TELEMETRY__) {
-      throw new Error("Telemetry not initialized");
+      throw import_errors.TelemetryError.notInitialized();
     }
     return globalThis.__TELEMETRY__;
   }

package/dist/telemetry/telemetry.d.ts

@@ -31,7 +31,7 @@ export declare class Telemetry {
     static getActiveSpan(): import("@opentelemetry/api").Span | undefined;
     /**
      * Get the global telemetry instance
-     * @throws {Error} If telemetry has not been initialized
+     * @throws {DextoRuntimeError} If telemetry has not been initialized
      * @returns {Telemetry} The global telemetry instance
      */
     static get(): Telemetry;

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;AAYtD,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,CAAsB;IACnC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAiC;IAC7D,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,CAA0D;IAEzF,OAAO;IAYP,OAAO,CAAC,MAAM,CAAC,kBAAkB;IA0BjC;;;;;OAKG;WACU,IAAI,CACb,MAAM,GAAE,iBAAsB,EAC9B,QAAQ,CAAC,EAAE,OAAO,+BAA+B,EAAE,YAAY,GAChE,OAAO,CAAC,SAAS,CAAC;IA8DrB,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;CA8BzC"}
+{"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;AAYtD,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,MAAM,CAAC,YAAY,CAAC,CAAiC;IAC7D,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,CAA0D;IAEzF,OAAO;mBAYc,kBAAkB;IA0DvC;;;;;OAKG;WACU,IAAI,CACb,MAAM,GAAE,iBAAsB,EAC9B,QAAQ,CAAC,EAAE,OAAO,+BAA+B,EAAE,YAAY,GAChE,OAAO,CAAC,SAAS,CAAC;IAgHrB,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;CA8BzC"}

package/dist/telemetry/telemetry.js

@@ -1,14 +1,8 @@
 import "../chunk-C6A6W6XS.js";
 import { context as otlpContext, trace, propagation } from "@opentelemetry/api";
-import { NodeSDK } from "@opentelemetry/sdk-node";
-import { ConsoleSpanExporter } from "@opentelemetry/sdk-trace-base";
-import { OTLPTraceExporter as OTLPHttpExporter } from "@opentelemetry/exporter-trace-otlp-http";
-import { OTLPTraceExporter as OTLPGrpcExporter } from "@opentelemetry/exporter-trace-otlp-grpc";
-import { getNodeAutoInstrumentations } from "@opentelemetry/auto-instrumentations-node";
-import { Resource } from "@opentelemetry/resources";
-import { ATTR_SERVICE_NAME } from "@opentelemetry/semantic-conventions";
-import { CompositeExporter } from "./exporters.js";
 import { logger } from "../logger/logger.js";
+import { TelemetryError } from "./errors.js";
+import { DextoRuntimeError } from "../errors/DextoRuntimeError.js";
 class Telemetry {
   tracer = trace.getTracer("dexto");
   name = "dexto-service";
@@ -26,19 +20,48 @@ class Telemetry {
     }
     this._isInitialized = enabled && !!sdk;
   }
-  static buildTraceExporter(config) {
+  static async buildTraceExporter(config) {
     const e = config?.export;
     if (!e || e.type === "console") {
-      return new ConsoleSpanExporter();
+      const { ConsoleSpanExporter: ConsoleSpanExporter2 } = await import("@opentelemetry/sdk-trace-base");
+      return new ConsoleSpanExporter2();
     }
     if (e.type === "otlp") {
       if (e.protocol === "grpc") {
+        let OTLPGrpcExporter;
+        try {
+          const mod = await import("@opentelemetry/exporter-trace-otlp-grpc");
+          OTLPGrpcExporter = mod.OTLPTraceExporter;
+        } catch (err) {
+          const error = err;
+          if (error.code === "ERR_MODULE_NOT_FOUND") {
+            throw TelemetryError.exporterDependencyNotInstalled(
+              "grpc",
+              "@opentelemetry/exporter-trace-otlp-grpc"
+            );
+          }
+          throw err;
+        }
         const options2 = {};
         if (e.endpoint) {
           options2.url = e.endpoint;
         }
         return new OTLPGrpcExporter(options2);
       }
+      let OTLPHttpExporter;
+      try {
+        const mod = await import("@opentelemetry/exporter-trace-otlp-http");
+        OTLPHttpExporter = mod.OTLPTraceExporter;
+      } catch (err) {
+        const error = err;
+        if (error.code === "ERR_MODULE_NOT_FOUND") {
+          throw TelemetryError.exporterDependencyNotInstalled(
+            "http",
+            "@opentelemetry/exporter-trace-otlp-http"
+          );
+        }
+        throw err;
+      }
       const options = {};
       if (e.endpoint) {
         options.url = e.endpoint;
@@ -48,6 +71,7 @@ class Telemetry {
       }
       return new OTLPHttpExporter(options);
     }
+    const { ConsoleSpanExporter } = await import("@opentelemetry/sdk-trace-base");
     return new ConsoleSpanExporter();
   }
   /**
@@ -65,10 +89,39 @@ class Telemetry {
           const enabled = config.enabled !== false;
           let sdk;
           if (enabled) {
+            let NodeSDK;
+            let Resource;
+            let getNodeAutoInstrumentations;
+            let ATTR_SERVICE_NAME;
+            try {
+              const sdkModule = await import("@opentelemetry/sdk-node");
+              NodeSDK = sdkModule.NodeSDK;
+              const resourcesModule = await import("@opentelemetry/resources");
+              Resource = resourcesModule.Resource;
+              const autoInstModule = await import("@opentelemetry/auto-instrumentations-node");
+              getNodeAutoInstrumentations = autoInstModule.getNodeAutoInstrumentations;
+              const semanticModule = await import("@opentelemetry/semantic-conventions");
+              ATTR_SERVICE_NAME = semanticModule.ATTR_SERVICE_NAME;
+            } catch (importError) {
+              const err = importError;
+              if (err.code === "ERR_MODULE_NOT_FOUND") {
+                throw TelemetryError.dependencyNotInstalled([
+                  "@opentelemetry/sdk-node",
+                  "@opentelemetry/auto-instrumentations-node",
+                  "@opentelemetry/resources",
+                  "@opentelemetry/semantic-conventions",
+                  "@opentelemetry/sdk-trace-base",
+                  "@opentelemetry/exporter-trace-otlp-http",
+                  "@opentelemetry/exporter-trace-otlp-grpc"
+                ]);
+              }
+              throw importError;
+            }
             const resource = new Resource({
               [ATTR_SERVICE_NAME]: config.serviceName ?? "dexto-service"
             });
-            const spanExporter = exporter || Telemetry.buildTraceExporter(config);
+            const spanExporter = exporter || await Telemetry.buildTraceExporter(config);
+            const { CompositeExporter } = await import("./exporters.js");
             const traceExporter = spanExporter instanceof CompositeExporter ? spanExporter : new CompositeExporter([spanExporter]);
             sdk = new NodeSDK({
               resource,
@@ -90,13 +143,16 @@ class Telemetry {
         }
         return globalThis.__TELEMETRY__;
       })();
-      return Telemetry._initPromise;
+      return await Telemetry._initPromise;
     } catch (error) {
-      const wrappedError = new Error(
-        `Failed to initialize telemetry: ${error instanceof Error ? error.message : String(error)}`
-      );
       Telemetry._initPromise = void 0;
-      throw wrappedError;
+      if (error instanceof DextoRuntimeError) {
+        throw error;
+      }
+      throw TelemetryError.initializationFailed(
+        error instanceof Error ? error.message : String(error),
+        error
+      );
     }
   }
   static getActiveSpan() {
@@ -105,12 +161,12 @@ class Telemetry {
   }
   /**
    * Get the global telemetry instance
-   * @throws {Error} If telemetry has not been initialized
+   * @throws {DextoRuntimeError} If telemetry has not been initialized
    * @returns {Telemetry} The global telemetry instance
    */
   static get() {
     if (!globalThis.__TELEMETRY__) {
-      throw new Error("Telemetry not initialized");
+      throw TelemetryError.notInitialized();
     }
     return globalThis.__TELEMETRY__;
   }

package/dist/tools/schemas.cjs

@@ -60,7 +60,7 @@ const ToolConfirmationConfigSchema = import_zod.z.object({
   )
 }).strict().describe("Tool confirmation and approval configuration");
 const ElicitationConfigSchema = import_zod.z.object({
-  enabled: import_zod.z.boolean().default(true).describe(
+  enabled: import_zod.z.boolean().default(false).describe(
     "Enable elicitation support (ask_user tool and MCP server elicitations). When disabled, elicitation requests will be rejected."
   ),
   timeout: import_zod.z.number().int().positive().default(12e4).describe(

package/dist/tools/schemas.js

@@ -31,7 +31,7 @@ const ToolConfirmationConfigSchema = z.object({
   )
 }).strict().describe("Tool confirmation and approval configuration");
 const ElicitationConfigSchema = z.object({
-  enabled: z.boolean().default(true).describe(
+  enabled: z.boolean().default(false).describe(
     "Enable elicitation support (ask_user tool and MCP server elicitations). When disabled, elicitation requests will be rejected."
   ),
   timeout: z.number().int().positive().default(12e4).describe(

package/dist/tools/types.d.ts

@@ -39,17 +39,6 @@ export interface ToolResult {
     data?: any;
     error?: string;
 }
-/**
- * Tool call representation
- */
-export interface ToolCall {
-    id: string;
-    toolName: string;
-    input: any;
-    output?: any;
-    error?: string;
-    duration?: number;
-}
 /**
  * Interface for any provider of tools
  */

package/dist/tools/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAErC;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC;AAMD;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,qCAAqC;IACrC,EAAE,EAAE,MAAM,CAAC;IAEX,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IAEpB,+CAA+C;IAC/C,WAAW,EAAE,SAAS,CAAC;IAEvB,8FAA8F;IAC9F,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,oBAAoB,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CAC3F;AAED;;;GAGG;AACH,MAAM,WAAW,OAAO;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG;QACX,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,WAAW,CAAC;KAC3B,CAAC;CACL;AAMD;;GAEG;AACH,MAAM,WAAW,UAAU;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,GAAG,CAAC;IACX,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/E"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAErC;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC;AAMD;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,qCAAqC;IACrC,EAAE,EAAE,MAAM,CAAC;IAEX,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IAEpB,+CAA+C;IAC/C,WAAW,EAAE,SAAS,CAAC;IAEvB,8FAA8F;IAC9F,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,oBAAoB,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CAC3F;AAED;;;GAGG;AACH,MAAM,WAAW,OAAO;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG;QACX,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,WAAW,CAAC;KAC3B,CAAC;CACL;AAMD;;GAEG;AACH,MAAM,WAAW,UAAU;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/E"}

package/dist/utils/schema.d.ts

@@ -1,6 +1,12 @@
 import type { IDextoLogger } from '../logger/v2/types.js';
 /**
  * Convert Zod schema to JSON Schema format for tool parameters
+ *
+ * TODO: Replace zod-to-json-schema with Zod v4 native JSON schema support
+ * The zod-to-json-schema package is deprecated and adds ~19MB due to a packaging bug
+ * (includes test files with full Zod copies in dist-test-v3 and dist-test-v4 folders).
+ * Zod v4 has native toJsonSchema() support - migrate when upgrading to Zod v4.
+ * See: https://github.com/StefanTerdell/zod-to-json-schema
  */
 export declare function convertZodSchemaToJsonSchema(zodSchema: any, logger: IDextoLogger): any;
 //# sourceMappingURL=schema.d.ts.map

package/dist/utils/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/utils/schema.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,GAAG,GAAG,CActF"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/utils/schema.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,GAAG,GAAG,CActF"}