shield360 1.0.0

package/dist/otel/metrics.js

@@ -0,0 +1,219 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const sdk_metrics_1 = require("@opentelemetry/sdk-metrics");
+const api_1 = require("@opentelemetry/api");
+const semantic_convention_1 = __importDefault(require("../semantic-convention"));
+const exporter_metrics_otlp_http_1 = require("@opentelemetry/exporter-metrics-otlp-http");
+const utils_1 = require("./utils");
+const DB_CLIENT_OPERATION_DURATION_BUCKETS = [0.001, 0.005, 0.01, 0.05, 0.1, 0.5, 1, 5, 10];
+const GEN_AI_CLIENT_OPERATION_DURATION_BUCKETS = [
+    0.01, 0.02, 0.04, 0.08, 0.16, 0.32, 0.64, 1.28, 2.56, 5.12, 10.24, 20.48, 40.96, 81.92,
+];
+const GEN_AI_SERVER_TBT = [0.01, 0.025, 0.05, 0.075, 0.1, 0.15, 0.2, 0.3, 0.4, 0.5, 0.75, 1.0, 2.5];
+const GEN_AI_SERVER_TFTT = [
+    0.001, 0.005, 0.01, 0.02, 0.04, 0.06, 0.08, 0.1, 0.25, 0.5, 0.75, 1.0, 2.5, 5.0, 7.5, 10.0,
+];
+const GEN_AI_CLIENT_TOKEN_USAGE_BUCKETS = [
+    1, 4, 16, 64, 256, 1024, 4096, 16384, 65536, 262144, 1048576, 4194304, 16777216, 67108864,
+];
+let METER_SET = false;
+class Metrics {
+    static initializeMetrics() {
+        this.genaiClientUsageTokens = this.meter.createHistogram(semantic_convention_1.default.GEN_AI_CLIENT_TOKEN_USAGE, {
+            description: 'Measures number of input and output tokens used',
+            unit: '{token}',
+            advice: {
+                explicitBucketBoundaries: GEN_AI_CLIENT_TOKEN_USAGE_BUCKETS,
+            },
+        });
+        this.genaiClientOperationDuration = this.meter.createHistogram(semantic_convention_1.default.GEN_AI_CLIENT_OPERATION_DURATION, {
+            description: 'GenAI operation duration',
+            unit: 's',
+            advice: {
+                explicitBucketBoundaries: GEN_AI_CLIENT_OPERATION_DURATION_BUCKETS,
+            },
+        });
+        this.genaiServerTbt = this.meter.createHistogram(semantic_convention_1.default.GEN_AI_SERVER_TBT, {
+            description: 'Time per output token generated after the first token for successful responses',
+            unit: 's',
+            advice: {
+                explicitBucketBoundaries: GEN_AI_SERVER_TBT,
+            },
+        });
+        this.genaiServerTtft = this.meter.createHistogram(semantic_convention_1.default.GEN_AI_SERVER_TTFT, {
+            description: 'Time to generate first token for successful responses',
+            unit: 's',
+            advice: {
+                explicitBucketBoundaries: GEN_AI_SERVER_TFTT,
+            },
+        });
+        this.genaiClientTimeToFirstChunk = this.meter.createHistogram(semantic_convention_1.default.GEN_AI_CLIENT_OPERATION_TIME_TO_FIRST_CHUNK, {
+            description: 'Time from client request to first response chunk',
+            unit: 's',
+            advice: {
+                explicitBucketBoundaries: GEN_AI_CLIENT_OPERATION_DURATION_BUCKETS,
+            },
+        });
+        this.genaiClientTimePerOutputChunk = this.meter.createHistogram(semantic_convention_1.default.GEN_AI_CLIENT_OPERATION_TIME_PER_OUTPUT_CHUNK, {
+            description: 'Time between consecutive response chunks from client perspective',
+            unit: 's',
+            advice: {
+                explicitBucketBoundaries: GEN_AI_CLIENT_OPERATION_DURATION_BUCKETS,
+            },
+        });
+        this.genaiServerRequestDuration = this.meter.createHistogram(semantic_convention_1.default.GEN_AI_SERVER_REQUEST_DURATION, {
+            description: 'Total server-side processing time from request receipt to response transmission',
+            unit: 's',
+            advice: {
+                explicitBucketBoundaries: GEN_AI_CLIENT_OPERATION_DURATION_BUCKETS,
+            },
+        });
+        this.dbClientOperationDuration = this.meter.createHistogram(semantic_convention_1.default.DB_CLIENT_OPERATION_DURATION, {
+            description: 'DB operation duration',
+            unit: 's',
+            advice: {
+                explicitBucketBoundaries: DB_CLIENT_OPERATION_DURATION_BUCKETS,
+            },
+        });
+        this.genaiCost = this.meter.createHistogram(semantic_convention_1.default.GEN_AI_USAGE_COST, {
+            description: 'The distribution of GenAI request costs.',
+            unit: 'USD',
+        });
+        this.dbRequests = this.meter.createCounter(semantic_convention_1.default.DB_REQUESTS, {
+            description: 'Number of requests to VectorDBs.',
+            unit: '1',
+        });
+        this.guardRequests = this.meter.createCounter(semantic_convention_1.default.GUARD_REQUESTS_COUNTER, {
+            description: 'Number of guard evaluations.',
+            unit: '1',
+        });
+        // MCP metrics
+        this.mcpRequests = this.meter.createCounter(semantic_convention_1.default.MCP_REQUESTS, {
+            description: 'Number of MCP requests.',
+            unit: '1',
+        });
+        this.mcpClientOperationDuration = this.meter.createHistogram(semantic_convention_1.default.MCP_CLIENT_OPERATION_DURATION_METRIC, {
+            description: 'MCP client operation duration',
+            unit: 's',
+            advice: {
+                explicitBucketBoundaries: GEN_AI_CLIENT_OPERATION_DURATION_BUCKETS,
+            },
+        });
+        this.mcpRequestSize = this.meter.createHistogram(semantic_convention_1.default.MCP_REQUEST_SIZE, {
+            description: 'MCP request payload size in bytes',
+            unit: 'By',
+        });
+        this.mcpResponseSize = this.meter.createHistogram(semantic_convention_1.default.MCP_RESPONSE_SIZE_METRIC, {
+            description: 'MCP response payload size in bytes',
+            unit: 'By',
+        });
+        this.mcpToolCalls = this.meter.createCounter(semantic_convention_1.default.MCP_TOOL_CALLS, {
+            description: 'Number of MCP tool calls.',
+            unit: '1',
+        });
+        this.mcpResourceReads = this.meter.createCounter(semantic_convention_1.default.MCP_RESOURCE_READS, {
+            description: 'Number of MCP resource reads.',
+            unit: '1',
+        });
+        this.mcpPromptGets = this.meter.createCounter(semantic_convention_1.default.MCP_PROMPT_GETS, {
+            description: 'Number of MCP prompt gets.',
+            unit: '1',
+        });
+        this.mcpTransportUsage = this.meter.createCounter(semantic_convention_1.default.MCP_TRANSPORT_USAGE, {
+            description: 'Number of MCP transport operations.',
+            unit: '1',
+        });
+        this.mcpErrors = this.meter.createCounter(semantic_convention_1.default.MCP_ERRORS, {
+            description: 'Number of MCP errors.',
+            unit: '1',
+        });
+        this.mcpOperationSuccessRate = this.meter.createHistogram(semantic_convention_1.default.MCP_OPERATION_SUCCESS_RATE, {
+            description: 'MCP operation success rate (0.0 = failure, 1.0 = success)',
+            unit: '1',
+        });
+    }
+    static setup(options) {
+        if (options.meter) {
+            this.meter = options.meter;
+            this.initializeMetrics();
+            return this.meter;
+        }
+        try {
+            if (!METER_SET) {
+                const existingProvider = api_1.metrics.getMeterProvider();
+                const isSDKProvider = existingProvider &&
+                    typeof existingProvider.getMeter === 'function' &&
+                    existingProvider.constructor.name !== 'NoopMeterProvider';
+                if (isSDKProvider) {
+                    this.meterProvider = existingProvider;
+                }
+                else {
+                    const readers = Metrics.buildMetricReaders(options);
+                    this.meterProvider = new sdk_metrics_1.MeterProvider({
+                        resource: options.resource,
+                        readers,
+                    });
+                    api_1.metrics.setGlobalMeterProvider(this.meterProvider);
+                    this.metricReaders.push(...readers);
+                }
+                this.meter = this.meterProvider.getMeter('shield360', '1.0.0');
+                this.initializeMetrics();
+                METER_SET = true;
+            }
+            return this.meter;
+        }
+        catch (e) {
+            console.error('[Metrics] Failed to initialize metrics:', e);
+            return null;
+        }
+    }
+    static buildMetricReaders(options) {
+        const readers = [];
+        const exporterList = (0, utils_1.parseExporters)('OTEL_METRICS_EXPORTER');
+        if (exporterList) {
+            for (const name of exporterList) {
+                if (name === 'otlp') {
+                    readers.push(Metrics.createOTLPReader(options));
+                }
+                else if (name === 'console') {
+                    readers.push(Metrics.createConsoleReader(options));
+                }
+            }
+        }
+        else {
+            if (options.otlpEndpoint) {
+                readers.push(Metrics.createOTLPReader(options));
+            }
+            else {
+                readers.push(Metrics.createConsoleReader(options));
+            }
+        }
+        return readers;
+    }
+    static createOTLPReader(options) {
+        const url = (options.otlpEndpoint || '') + '/v1/metrics';
+        const exporter = new exporter_metrics_otlp_http_1.OTLPMetricExporter({
+            url,
+            headers: options.otlpHeaders,
+        });
+        return new sdk_metrics_1.PeriodicExportingMetricReader({
+            exportIntervalMillis: options.exportIntervalMillis || 60000,
+            exporter,
+        });
+    }
+    static createConsoleReader(options) {
+        return new sdk_metrics_1.PeriodicExportingMetricReader({
+            exportIntervalMillis: options.exportIntervalMillis || 60000,
+            exporter: new sdk_metrics_1.ConsoleMetricExporter(),
+        });
+    }
+    static resetForTesting() {
+        METER_SET = false;
+    }
+}
+Metrics.metricReaders = [];
+exports.default = Metrics;
+//# sourceMappingURL=metrics.js.map

package/dist/otel/metrics.js.map

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

package/dist/otel/tracing.d.ts

@@ -0,0 +1,12 @@
+import { SetupTracerOptions } from '../types';
+import { NodeTracerProvider } from '@opentelemetry/sdk-trace-node';
+import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';
+export default class Tracing {
+    static traceProvider: NodeTracerProvider;
+    static traceExporter: OTLPTraceExporter | undefined;
+    static setup(options: SetupTracerOptions): NodeTracerProvider | import("@opentelemetry/api").Tracer | null;
+    private static buildSpanProcessors;
+    private static createOTLPExporter;
+    private static wrapProcessor;
+    static resetForTesting(): void;
+}

package/dist/otel/tracing.js

@@ -0,0 +1,93 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const api_1 = require("@opentelemetry/api");
+const sdk_trace_node_1 = require("@opentelemetry/sdk-trace-node");
+const exporter_trace_otlp_http_1 = require("@opentelemetry/exporter-trace-otlp-http");
+const instrumentation_1 = __importDefault(require("../instrumentation"));
+const config_1 = __importDefault(require("../config"));
+const utils_1 = require("./utils");
+let TRACER_SET = false;
+class Tracing {
+    static setup(options) {
+        if (options.tracer)
+            return options.tracer;
+        try {
+            if (!TRACER_SET) {
+                const existingProvider = api_1.trace.getTracerProvider();
+                const isSDKProvider = existingProvider &&
+                    typeof existingProvider.addSpanProcessor === 'function';
+                if (isSDKProvider) {
+                    // Reuse existing SDK TracerProvider
+                    this.traceProvider = existingProvider;
+                }
+                else {
+                    const spanProcessors = Tracing.buildSpanProcessors(options);
+                    this.traceProvider = new sdk_trace_node_1.NodeTracerProvider({
+                        resource: options.resource,
+                        spanProcessors,
+                    });
+                    this.traceProvider.register();
+                }
+                config_1.default.updateConfig({
+                    ...options,
+                    tracer: options.tracer || Tracing.traceProvider,
+                });
+                instrumentation_1.default.setup(Tracing.traceProvider, options?.disabledInstrumentors, options?.instrumentations);
+                TRACER_SET = true;
+            }
+            return api_1.trace.getTracer('shield360');
+        }
+        catch (e) {
+            console.error('[Traces] Failed to initialize traces:', e);
+            return null;
+        }
+    }
+    static buildSpanProcessors(options) {
+        const processors = [];
+        const exporterList = (0, utils_1.parseExporters)('OTEL_TRACES_EXPORTER');
+        if (exporterList) {
+            for (const name of exporterList) {
+                if (name === 'otlp') {
+                    const exporter = Tracing.createOTLPExporter(options);
+                    this.traceExporter = exporter;
+                    processors.push(Tracing.wrapProcessor(exporter, options.disableBatch));
+                }
+                else if (name === 'console') {
+                    processors.push(new sdk_trace_node_1.SimpleSpanProcessor(new sdk_trace_node_1.ConsoleSpanExporter()));
+                }
+            }
+        }
+        else {
+            // Default: OTLP if endpoint is set, otherwise Console
+            if (options.otlpEndpoint) {
+                const exporter = Tracing.createOTLPExporter(options);
+                this.traceExporter = exporter;
+                processors.push(Tracing.wrapProcessor(exporter, options.disableBatch));
+            }
+            else {
+                processors.push(new sdk_trace_node_1.SimpleSpanProcessor(new sdk_trace_node_1.ConsoleSpanExporter()));
+            }
+        }
+        return processors;
+    }
+    static createOTLPExporter(options) {
+        const url = (options.otlpEndpoint || '') + '/v1/traces';
+        return new exporter_trace_otlp_http_1.OTLPTraceExporter({
+            url,
+            headers: options.otlpHeaders,
+        });
+    }
+    static wrapProcessor(exporter, disableBatch) {
+        return disableBatch
+            ? new sdk_trace_node_1.SimpleSpanProcessor(exporter)
+            : new sdk_trace_node_1.BatchSpanProcessor(exporter);
+    }
+    static resetForTesting() {
+        TRACER_SET = false;
+    }
+}
+exports.default = Tracing;
+//# sourceMappingURL=tracing.js.map

package/dist/otel/tracing.js.map

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

package/dist/otel/utils.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Parse a comma-separated OTel exporter env var into an array of exporter names.
+ * Returns null if the env var is not set (caller uses default logic).
+ * Matches Python's parse_exporters() in __helpers.py.
+ */
+export declare function parseExporters(envVarName: string): string[] | null;
+/**
+ * Parse a boolean-like env var (true/1/yes -> true, false/0/no -> false).
+ * Returns undefined if the env var is not set.
+ */
+export declare function parseBoolEnv(envVarName: string): boolean | undefined;

package/dist/otel/utils.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseExporters = parseExporters;
+exports.parseBoolEnv = parseBoolEnv;
+/**
+ * Parse a comma-separated OTel exporter env var into an array of exporter names.
+ * Returns null if the env var is not set (caller uses default logic).
+ * Matches Python's parse_exporters() in __helpers.py.
+ */
+function parseExporters(envVarName) {
+    const val = process.env[envVarName];
+    if (!val)
+        return null;
+    return val
+        .split(',')
+        .map((e) => e.trim().toLowerCase())
+        .filter(Boolean);
+}
+/**
+ * Parse a boolean-like env var (true/1/yes -> true, false/0/no -> false).
+ * Returns undefined if the env var is not set.
+ */
+function parseBoolEnv(envVarName) {
+    const val = process.env[envVarName];
+    if (val === undefined || val === '')
+        return undefined;
+    const lower = val.trim().toLowerCase();
+    if (['true', '1', 'yes'].includes(lower))
+        return true;
+    if (['false', '0', 'no'].includes(lower))
+        return false;
+    return undefined;
+}
+//# sourceMappingURL=utils.js.map

package/dist/otel/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/otel/utils.ts"],"names":[],"mappings":";;AAKA,wCAOC;AAMD,oCAOC;AAzBD;;;;GAIG;AACH,SAAgB,cAAc,CAAC,UAAkB;IAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACpC,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,OAAO,GAAG;SACP,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;SAClC,MAAM,CAAC,OAAO,CAAC,CAAC;AACrB,CAAC;AAED;;;GAGG;AACH,SAAgB,YAAY,CAAC,UAAkB;IAC7C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACpC,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IACtD,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACvC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACtD,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACvD,OAAO,SAAS,CAAC;AACnB,CAAC"}