observability-toolkit 2.0.0 → 2.1.0

package/dist/lib/core/logger.js

@@ -0,0 +1,104 @@
+import pino from 'pino';
+// In test environments, route each log line to the matching console method so
+// test frameworks can capture/assert on output via console mocks.
+const isTest = process.env.LOG_TRANSPORT === 'console' ||
+    process.env.NODE_TEST_CONTEXT !== undefined ||
+    process.env.VITEST_WORKER_ID !== undefined;
+const testDest = {
+    write(msg) {
+        const line = msg.trimEnd();
+        try {
+            const parsed = JSON.parse(line);
+            switch (parsed.level) {
+                case 'debug':
+                    console.log(line);
+                    break;
+                case 'info':
+                    console.info(line);
+                    break;
+                case 'warn':
+                    console.warn(line);
+                    break;
+                case 'error':
+                    console.error(line);
+                    break;
+                default: console.log(line);
+            }
+        }
+        catch {
+            process.stderr.write(msg);
+        }
+    },
+};
+const rootLogger = pino({
+    messageKey: 'message',
+    // Emit ISO timestamp under the "timestamp" key to match LogEntry shape.
+    timestamp: () => `,"timestamp":"${new Date().toISOString()}"`,
+    formatters: {
+        // Emit string level labels ("info") instead of pino's default integers.
+        level: (label) => ({ level: label }),
+    },
+    // Remove default pid/hostname bindings; component comes from child loggers.
+    base: null,
+    level: isTest ? 'debug' : 'info',
+}, isTest ? testDest : process.stderr);
+// Cache child loggers keyed by component to avoid recreating on every log() call.
+const childCache = new Map();
+function getChild(component) {
+    let child = childCache.get(component);
+    if (!child) {
+        child = rootLogger.child({ component });
+        childCache.set(component, child);
+    }
+    return child;
+}
+/**
+ * Emit a structured log entry.
+ */
+export function log(entry) {
+    const child = getChild(entry.component);
+    if (entry.metadata !== undefined) {
+        child[entry.level]({ metadata: entry.metadata }, entry.message);
+    }
+    else {
+        child[entry.level](entry.message);
+    }
+}
+/**
+ * Create a component-scoped logger.
+ *
+ * @example
+ * const logger = createLogger('security');
+ * logger.warn('SSRF attempt blocked', { url: 'http://169.254.169.254' });
+ */
+export function createLogger(component) {
+    const child = getChild(component);
+    return {
+        debug: (message, metadata) => metadata !== undefined ? child.debug({ metadata }, message) : child.debug(message),
+        info: (message, metadata) => metadata !== undefined ? child.info({ metadata }, message) : child.info(message),
+        warn: (message, metadata) => metadata !== undefined ? child.warn({ metadata }, message) : child.warn(message),
+        error: (message, metadata) => metadata !== undefined ? child.error({ metadata }, message) : child.error(message),
+    };
+}
+/**
+ * Parse a JSON log line back into a LogEntry.
+ * Returns null if parsing fails or required fields are missing.
+ */
+export function parseLogEntry(line) {
+    try {
+        const parsed = JSON.parse(line);
+        if (typeof parsed === 'object' &&
+            parsed !== null &&
+            'timestamp' in parsed &&
+            'level' in parsed &&
+            'component' in parsed &&
+            'message' in parsed) {
+            return parsed;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/lib/core/logger.js.map

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

package/dist/lib/core/logger.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.test.d.ts","sourceRoot":"","sources":["../../../src/lib/core/logger.test.ts"],"names":[],"mappings":""}

package/dist/lib/core/logger.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.test.js","sourceRoot":"","sources":["../../../src/lib/core/logger.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtE,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,aAAa,EAAiB,MAAM,aAAa,CAAC;AAE9E,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;IACtB,IAAI,YAAwC,CAAC;IAC7C,IAAI,WAAuC,CAAC;IAC5C,IAAI,WAAuC,CAAC;IAC5C,IAAI,UAAsC,CAAC;IAE3C,UAAU,CAAC,GAAG,EAAE;QACd,YAAY,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;QACzB,WAAW,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;QACxB,WAAW,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;QACxB,UAAU,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;QACvB,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,UAAU,EAAE,CAAC;IACpB,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE;QACrB,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;YAC3C,GAAG,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC;YAEnE,MAAM,CAAC,WAAW,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YACrD,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAW,CAAC;YAChE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAElC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,qBAAqB,CAAC,CAAC;YACtD,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YACzC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YAC7C,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;YAC/C,GAAG,CAAC;gBACF,KAAK,EAAE,MAAM;gBACb,SAAS,EAAE,UAAU;gBACrB,OAAO,EAAE,iBAAiB;gBAC1B,QAAQ,EAAE,EAAE,GAAG,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,EAAE;aACxD,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAW,CAAC;YAChE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAElC,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,GAAG,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QACzF,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;YAClD,GAAG,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;YAC7D,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACxD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;YAChD,GAAG,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;YACtE,MAAM,CAAC,WAAW,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACvD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;YAChD,GAAG,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,iBAAiB,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;YACxE,MAAM,CAAC,WAAW,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACvD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;YAChD,GAAG,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YAC5D,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;QAC9B,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;YACrD,MAAM,MAAM,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;YAExC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YAC1B,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACxB,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACxB,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YAE1B,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YACpD,MAAM,CAAC,WAAW,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YACrD,MAAM,CAAC,WAAW,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YACrD,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YAEtD,oCAAoC;YACpC,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAW,CAAC;YAChE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAClC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;YACtC,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;YACrC,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;YAEhD,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAW,CAAC;YAChE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAClC,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;QAChE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;QAC/B,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;YACtC,MAAM,KAAK,GAAa;gBACtB,SAAS,EAAE,0BAA0B;gBACrC,KAAK,EAAE,MAAM;gBACb,SAAS,EAAE,MAAM;gBACjB,OAAO,EAAE,SAAS;aACnB,CAAC;YAEF,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;YACpD,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;YAC1C,MAAM,KAAK,GAAa;gBACtB,SAAS,EAAE,0BAA0B;gBACrC,KAAK,EAAE,MAAM;gBACb,SAAS,EAAE,OAAO;gBAClB,OAAO,EAAE,UAAU;gBACnB,QAAQ,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE;aAC/B,CAAC;YAEF,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;YACpD,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;YAC7C,MAAM,CAAC,WAAW,CAAC,aAAa,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;YACxD,MAAM,CAAC,WAAW,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;YACrF,MAAM,CAAC,WAAW,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;YAC3E,MAAM,CAAC,WAAW,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QAC9D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;YAChD,MAAM,CAAC,WAAW,CAAC,aAAa,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC,CAAC;YACpD,MAAM,CAAC,WAAW,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC;YAC/C,MAAM,CAAC,WAAW,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/lib/core/schema-types.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Centralized Type Exports from Zod Schemas
+ *
+ * Re-exports types from schema modules to reduce import statements
+ * and provide a single source for schema-based types across the codebase.
+ *
+ * For input types with default fields, use the `*Input` suffixed types
+ * which correspond to z.input<> (pre-parse with optional defaults).
+ *
+ * @example
+ * ```typescript
+ * // Instead of:
+ * import type { AuditRecord } from '../audit/audit-record.js';
+ * import type { BudgetConfig } from '../cost/cost-estimation.js';
+ *
+ * // Use:
+ * import type { AuditRecord, BudgetConfig } from '../core/schema-types.js';
+ * ```
+ */
+export type { InstrumentationScope, SpanLink, TraceSpan, LogRecord, HistogramBucket, HistogramData, Exemplar, MetricDataPoint, HistogramDataPoint, LLMEvent, EvaluatorType, StepScore, ToolVerification, EvaluationResult, CostDataPoint, DatasetRecord, DatasetTraceRecord, DatasetRunRecord, } from '../../backends/backend-schemas.js';
+export type { AuditRecord, AuditRecordInput, AuditQueryOptions, ChainIntegrityResult, AuditRecordCategory, AuditRecordCategoryInput, } from '../audit/audit-record.js';
+export type { TokenUsage, CostBreakdown, BudgetConfig, AlertLevel, BudgetCheckResult, CostAttribution, CostSummary, TokenUsageInput, BudgetConfigInput, CostBreakdownInput, AlertLevelInput, BudgetCheckResultInput, CostAttributionInput, CostSummaryInput, } from '../cost/cost-estimation.js';
+export type { ConfidentConfigInput, ConfidentConfigParsed, DatadogConfigInput, DatadogConfigParsed, LangfuseConfigInput, LangfuseConfigParsed, PhoenixConfigInput, PhoenixConfigParsed, } from '../exports/export-config-schemas.js';
+export type { GuardrailResult, LLMJudgeLogger, HallucinationGuardrailOptions, LLMJudgeConfig, ConfiguredEvaluationResult, MetaEvalGuard, } from '../judge/llm-judge-config.js';
+export { auditRecordSchema, auditRecordInputSchema, auditQueryOptionsSchema, chainIntegrityResultSchema, auditRecordCategorySchema, } from '../audit/audit-record.js';
+export { tokenUsageSchema, budgetConfigSchema, costBreakdownSchema, alertLevelSchema, budgetCheckResultSchema, costAttributionSchema, costSummarySchema, } from '../cost/cost-estimation.js';
+export { confidentConfigSchema, datadogConfigSchema, langfuseConfigSchema, phoenixConfigSchema, } from '../exports/export-config-schemas.js';
+export { guardrailResultSchema, llmJudgeLoggerSchema, hallucinationGuardrailOptionsSchema, llmJudgeConfigSchema, configuredEvaluationResultSchema, metaEvalGuardSchema, } from '../judge/llm-judge-config.js';
+export type { WebhookAuthMethod, WebhookConfig, WebhookEvaluationPayload, WebhookBatchPayload, HookResult, HookValidationError, SignatureVerificationResult, HookExecutorOptions, HookStats, ScoreNormalizationConfig, } from '../judge/evaluation-hooks-schemas.js';
+export { webhookAuthMethodSchema, webhookConfigSchema, webhookEvaluationPayloadSchema, webhookBatchPayloadSchema, hookResultSchema, hookValidationErrorSchema, signatureVerificationResultSchema, hookExecutorOptionsSchema, hookStatsSchema, scoreNormalizationConfigSchema, } from '../judge/evaluation-hooks-schemas.js';
+export type { AlertSeverity, ThresholdDirection, QualityMetricConfig, AlertThreshold, DivergenceAlertThreshold, AlertThresholdUnion, DivergenceDetails, SeverityContext, TrendDirection, MetricTrend, ConfidenceIndicator, } from '../quality/quality-metrics.js';
+export { qualityMetricConfigSchema, metricConditionSchema, metricCorrelationRuleSchema, divergenceDetailsSchema, severityContextSchema, metricTrendSchema, confidenceIndicatorSchema, worstExplanationSchema, triggeredAlertSchema, qualityMetricResultSchema, slaWindowFormatSchema, slaStatusSchema, slaDefinitionSchema, slaComplianceResultSchema, qualityDashboardSummarySchema, } from '../quality/quality-metrics.js';
+export type { AgentAction, Evaluand, AgentEvalResult, EvaluationStep, EvaluationPlan, ConsensusConfig, } from '../agent-judge/agent-as-judge.js';
+export type { ConsensusResult, } from '../agent-judge/agent-judge-consensus.js';
+export { agentActionSchema, evaluandSchema, agentEvalResultSchema, evaluationStepSchema, evaluationPlanSchema, consensusConfigSchema, } from '../agent-judge/agent-as-judge.js';
+export { consensusResultSchema, } from '../agent-judge/agent-judge-consensus.js';
+//# sourceMappingURL=schema-types.d.ts.map

package/dist/lib/core/schema-types.d.ts.map

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

package/dist/lib/core/schema-types.js

@@ -0,0 +1,29 @@
+/**
+ * Centralized Type Exports from Zod Schemas
+ *
+ * Re-exports types from schema modules to reduce import statements
+ * and provide a single source for schema-based types across the codebase.
+ *
+ * For input types with default fields, use the `*Input` suffixed types
+ * which correspond to z.input<> (pre-parse with optional defaults).
+ *
+ * @example
+ * ```typescript
+ * // Instead of:
+ * import type { AuditRecord } from '../audit/audit-record.js';
+ * import type { BudgetConfig } from '../cost/cost-estimation.js';
+ *
+ * // Use:
+ * import type { AuditRecord, BudgetConfig } from '../core/schema-types.js';
+ * ```
+ */
+// Re-export schemas for reference in production code
+export { auditRecordSchema, auditRecordInputSchema, auditQueryOptionsSchema, chainIntegrityResultSchema, auditRecordCategorySchema, } from '../audit/audit-record.js';
+export { tokenUsageSchema, budgetConfigSchema, costBreakdownSchema, alertLevelSchema, budgetCheckResultSchema, costAttributionSchema, costSummarySchema, } from '../cost/cost-estimation.js';
+export { confidentConfigSchema, datadogConfigSchema, langfuseConfigSchema, phoenixConfigSchema, } from '../exports/export-config-schemas.js';
+export { guardrailResultSchema, llmJudgeLoggerSchema, hallucinationGuardrailOptionsSchema, llmJudgeConfigSchema, configuredEvaluationResultSchema, metaEvalGuardSchema, } from '../judge/llm-judge-config.js';
+export { webhookAuthMethodSchema, webhookConfigSchema, webhookEvaluationPayloadSchema, webhookBatchPayloadSchema, hookResultSchema, hookValidationErrorSchema, signatureVerificationResultSchema, hookExecutorOptionsSchema, hookStatsSchema, scoreNormalizationConfigSchema, } from '../judge/evaluation-hooks-schemas.js';
+export { qualityMetricConfigSchema, metricConditionSchema, metricCorrelationRuleSchema, divergenceDetailsSchema, severityContextSchema, metricTrendSchema, confidenceIndicatorSchema, worstExplanationSchema, triggeredAlertSchema, qualityMetricResultSchema, slaWindowFormatSchema, slaStatusSchema, slaDefinitionSchema, slaComplianceResultSchema, qualityDashboardSummarySchema, } from '../quality/quality-metrics.js';
+export { agentActionSchema, evaluandSchema, agentEvalResultSchema, evaluationStepSchema, evaluationPlanSchema, consensusConfigSchema, } from '../agent-judge/agent-as-judge.js';
+export { consensusResultSchema, } from '../agent-judge/agent-judge-consensus.js';
+//# sourceMappingURL=schema-types.js.map

package/dist/lib/core/schema-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-types.js","sourceRoot":"","sources":["../../../src/lib/core/schema-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AA0EH,qDAAqD;AACrD,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,EACvB,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,uBAAuB,EACvB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,qCAAqC,CAAC;AAE7C,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,mCAAmC,EACnC,oBAAoB,EACpB,gCAAgC,EAChC,mBAAmB,GACpB,MAAM,8BAA8B,CAAC;AAgBtC,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,8BAA8B,EAC9B,yBAAyB,EACzB,gBAAgB,EAChB,yBAAyB,EACzB,iCAAiC,EACjC,yBAAyB,EACzB,eAAe,EACf,8BAA8B,GAC/B,MAAM,sCAAsC,CAAC;AAiB9C,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,2BAA2B,EAC3B,uBAAuB,EACvB,qBAAqB,EACrB,iBAAiB,EACjB,yBAAyB,EACzB,sBAAsB,EACtB,oBAAoB,EACpB,yBAAyB,EACzB,qBAAqB,EACrB,eAAe,EACf,mBAAmB,EACnB,yBAAyB,EACzB,6BAA6B,GAC9B,MAAM,+BAA+B,CAAC;AAgBvC,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,qBAAqB,GACtB,MAAM,yCAAyC,CAAC"}

package/dist/lib/core/server-utils.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Server utilities - Rate limiter and error classes
+ *
+ * Extracted from server.ts to allow importing in tests without starting the MCP server.
+ *
+ * ## OTel Metrics (P3-2)
+ * When OTEL_ENABLED=true, rate limit rejections are exported as OTel metrics:
+ * - obs_toolkit.rate_limit.rejections: Counter of rejected requests
+ */
+/**
+ * Reset monotonic clock base state.
+ * @internal For testing ONLY - prevents state leaking between test instances
+ */
+export declare function resetMonotonicMs(): void;
+export declare const RATE_LIMIT: {
+    windowMs: number;
+    maxRequests: number;
+    bucketCount: number;
+    /** Maximum allowed bucketCount to prevent memory exhaustion */
+    maxBucketCount: number;
+};
+/**
+ * Sliding window counter rate limiter with O(1) operations and bounded memory.
+ * Uses fixed-size bucket array to track request counts per time slice.
+ *
+ * Memory usage: O(bucketCount) - fixed regardless of request volume
+ * Time complexity: O(bucketCount) for sum, but bucketCount is constant (60)
+ */
+export declare class RateLimiter {
+    private buckets;
+    private bucketTimestamps;
+    private readonly bucketMs;
+    private readonly windowMs;
+    private readonly maxRequests;
+    private readonly bucketCount;
+    private readonly name;
+    /** Counter for rate-limited requests (for observability) */
+    private rateLimitedCount;
+    constructor(windowMs?: number, maxRequests?: number, bucketCount?: number, name?: string);
+    /**
+     * Get the bucket index for a given timestamp.
+     * Uses modulo to create circular buffer behavior.
+     */
+    private getBucketIndex;
+    /**
+     * Clear expired buckets and return the current valid count.
+     * A bucket is expired if its timestamp is older than windowMs ago.
+     */
+    private cleanAndCount;
+    /**
+     * Check if a request is allowed and record it if so.
+     * O(bucketCount) time complexity where bucketCount is constant.
+     */
+    isAllowed(): boolean;
+    /**
+     * Get the number of remaining allowed requests in the current window.
+     */
+    getRemainingRequests(): number;
+    /**
+     * Get the current memory footprint (for testing).
+     * Returns the fixed size of internal arrays.
+     * @internal For testing ONLY - exposes internal structure, do not use in production
+     */
+    getMemoryFootprint(): {
+        bucketCount: number;
+        arraySize: number;
+    };
+    /**
+     * Get the number of rate-limited requests since startup or last reset.
+     * Useful for observability and monitoring.
+     */
+    getRateLimitedCount(): number;
+    /**
+     * Reset the rate limiter state.
+     * @internal For testing ONLY - not thread-safe, do not use in production
+     */
+    reset(): void;
+}
+/**
+ * Valid server initialization steps.
+ * Used for type-safe error reporting during server startup.
+ */
+export type ServerInitStep = 'tool-validation' | 'server-creation' | 'handler-registration' | 'transport-connection';
+/**
+ * Server initialization error with explicit step information.
+ *
+ * Steps:
+ * - tool-validation: Validating tool configuration
+ * - server-creation: Creating MCP server instance
+ * - handler-registration: Registering request handlers
+ * - transport-connection: Connecting stdio transport
+ */
+export declare class ServerInitError extends Error {
+    readonly step: ServerInitStep;
+    readonly cause: unknown;
+    constructor(step: ServerInitStep, cause: unknown, message?: string);
+}
+//# sourceMappingURL=server-utils.d.ts.map

package/dist/lib/core/server-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-utils.d.ts","sourceRoot":"","sources":["../../../src/lib/core/server-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAaH;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAsBD,eAAO,MAAM,UAAU;;;;IAIrB,+DAA+D;;CAEhE,CAAC;AAEF;;;;;;GAMG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAW;IAC1B,OAAO,CAAC,gBAAgB,CAAW;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,4DAA4D;IAC5D,OAAO,CAAC,gBAAgB,CAAK;gBAG3B,QAAQ,GAAE,MAA4B,EACtC,WAAW,GAAE,MAA+B,EAC5C,WAAW,GAAE,MAA+B,EAC5C,IAAI,GAAE,MAAe;IA4BvB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAItB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAiBrB;;;OAGG;IACH,SAAS,IAAI,OAAO;IAyBpB;;OAEG;IACH,oBAAoB,IAAI,MAAM;IAM9B;;;;OAIG;IACH,kBAAkB,IAAI;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;IAOhE;;;OAGG;IACH,mBAAmB,IAAI,MAAM;IAI7B;;;OAGG;IACH,KAAK,IAAI,IAAI;CAKd;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GACtB,iBAAiB,GACjB,iBAAiB,GACjB,sBAAsB,GACtB,sBAAsB,CAAC;AAE3B;;;;;;;;GAQG;AACH,qBAAa,eAAgB,SAAQ,KAAK;aAEtB,IAAI,EAAE,cAAc;aACpB,KAAK,EAAE,OAAO;gBADd,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,OAAO,EAC9B,OAAO,CAAC,EAAE,MAAM;CAKnB"}

package/dist/lib/core/server-utils.js

@@ -0,0 +1,193 @@
+/**
+ * Server utilities - Rate limiter and error classes
+ *
+ * Extracted from server.ts to allow importing in tests without starting the MCP server.
+ *
+ * ## OTel Metrics (P3-2)
+ * When OTEL_ENABLED=true, rate limit rejections are exported as OTel metrics:
+ * - obs_toolkit.rate_limit.rejections: Counter of rejected requests
+ */
+import { recordRateLimitRejection } from '../observability/metrics.js';
+import { MAX_DURATION_MS, } from './constants.js';
+import { NANOSECONDS_PER_MILLISECOND_BIGINT, } from './units.js';
+// Base time for monotonic clock (set on first use)
+let monotonicBase = null;
+/**
+ * Reset monotonic clock base state.
+ * @internal For testing ONLY - prevents state leaking between test instances
+ */
+export function resetMonotonicMs() {
+    monotonicBase = null;
+}
+/**
+ * Get monotonic timestamp in milliseconds.
+ * Uses process.hrtime.bigint() for consistency even if system clock changes.
+ * Falls back to Date.now() for browser compatibility.
+ */
+function getMonotonicMs() {
+    if (typeof process !== 'undefined' && process.hrtime?.bigint) {
+        if (monotonicBase === null) {
+            monotonicBase = {
+                hrtime: process.hrtime.bigint(),
+                dateNow: Date.now(),
+            };
+        }
+        const elapsed = process.hrtime.bigint() - monotonicBase.hrtime;
+        return monotonicBase.dateNow + Number(elapsed / NANOSECONDS_PER_MILLISECOND_BIGINT);
+    }
+    return Date.now();
+}
+// Rate limiting configuration
+export const RATE_LIMIT = {
+    windowMs: 60_000, // 1 minute window
+    maxRequests: 100, // max requests per window
+    bucketCount: 60, // 60 buckets for 1-second granularity
+    /** Maximum allowed bucketCount to prevent memory exhaustion */
+    maxBucketCount: 3600, // 1 hour max granularity
+};
+/**
+ * Sliding window counter rate limiter with O(1) operations and bounded memory.
+ * Uses fixed-size bucket array to track request counts per time slice.
+ *
+ * Memory usage: O(bucketCount) - fixed regardless of request volume
+ * Time complexity: O(bucketCount) for sum, but bucketCount is constant (60)
+ */
+export class RateLimiter {
+    buckets;
+    bucketTimestamps;
+    bucketMs;
+    windowMs;
+    maxRequests;
+    bucketCount;
+    name;
+    /** Counter for rate-limited requests (for observability) */
+    rateLimitedCount = 0;
+    constructor(windowMs = RATE_LIMIT.windowMs, maxRequests = RATE_LIMIT.maxRequests, bucketCount = RATE_LIMIT.bucketCount, name = 'tool') {
+        // Validate bounds to prevent memory exhaustion or invalid state
+        if (bucketCount < 1 || bucketCount > RATE_LIMIT.maxBucketCount) {
+            throw new Error(`bucketCount must be between 1 and ${RATE_LIMIT.maxBucketCount} (1 hour max granularity)`);
+        }
+        if (maxRequests < 1) {
+            throw new Error('maxRequests must be >= 1');
+        }
+        // Validate windowMs bounds: 1ms minimum, MAX_DURATION_MS maximum to prevent overflow
+        if (windowMs < 1 || windowMs > MAX_DURATION_MS) {
+            throw new Error(`windowMs must be between 1ms and ${MAX_DURATION_MS}ms`);
+        }
+        this.windowMs = windowMs;
+        this.maxRequests = maxRequests;
+        this.bucketCount = bucketCount;
+        this.bucketMs = Math.floor(windowMs / bucketCount);
+        if (this.bucketMs < 1) {
+            throw new Error(`windowMs (${windowMs}) must be >= bucketCount (${bucketCount}) to produce valid bucket intervals`);
+        }
+        this.name = name;
+        // Pre-allocate fixed-size arrays
+        this.buckets = new Array(bucketCount).fill(0);
+        this.bucketTimestamps = new Array(bucketCount).fill(0);
+    }
+    /**
+     * Get the bucket index for a given timestamp.
+     * Uses modulo to create circular buffer behavior.
+     */
+    getBucketIndex(timestamp) {
+        return Math.floor(timestamp / this.bucketMs) % this.bucketCount;
+    }
+    /**
+     * Clear expired buckets and return the current valid count.
+     * A bucket is expired if its timestamp is older than windowMs ago.
+     */
+    cleanAndCount(now) {
+        const windowStart = now - this.windowMs;
+        let count = 0;
+        for (let i = 0; i < this.bucketCount; i++) {
+            if (this.bucketTimestamps[i] < windowStart) {
+                // Bucket is expired, reset it
+                this.buckets[i] = 0;
+                this.bucketTimestamps[i] = 0;
+            }
+            else {
+                count += this.buckets[i];
+            }
+        }
+        return count;
+    }
+    /**
+     * Check if a request is allowed and record it if so.
+     * O(bucketCount) time complexity where bucketCount is constant.
+     */
+    isAllowed() {
+        const now = getMonotonicMs();
+        const currentCount = this.cleanAndCount(now);
+        if (currentCount >= this.maxRequests) {
+            this.rateLimitedCount++;
+            recordRateLimitRejection(this.name);
+            return false;
+        }
+        // Record the request in the current bucket
+        const bucketIndex = this.getBucketIndex(now);
+        // If this bucket is from a different time period, reset it
+        const bucketWindowStart = now - this.windowMs;
+        if (this.bucketTimestamps[bucketIndex] < bucketWindowStart) {
+            this.buckets[bucketIndex] = 0;
+        }
+        this.buckets[bucketIndex]++;
+        this.bucketTimestamps[bucketIndex] = now;
+        return true;
+    }
+    /**
+     * Get the number of remaining allowed requests in the current window.
+     */
+    getRemainingRequests() {
+        const now = getMonotonicMs();
+        const currentCount = this.cleanAndCount(now);
+        return Math.max(0, this.maxRequests - currentCount);
+    }
+    /**
+     * Get the current memory footprint (for testing).
+     * Returns the fixed size of internal arrays.
+     * @internal For testing ONLY - exposes internal structure, do not use in production
+     */
+    getMemoryFootprint() {
+        return {
+            bucketCount: this.bucketCount,
+            arraySize: this.buckets.length + this.bucketTimestamps.length,
+        };
+    }
+    /**
+     * Get the number of rate-limited requests since startup or last reset.
+     * Useful for observability and monitoring.
+     */
+    getRateLimitedCount() {
+        return this.rateLimitedCount;
+    }
+    /**
+     * Reset the rate limiter state.
+     * @internal For testing ONLY - not thread-safe, do not use in production
+     */
+    reset() {
+        this.buckets.fill(0);
+        this.bucketTimestamps.fill(0);
+        this.rateLimitedCount = 0;
+    }
+}
+/**
+ * Server initialization error with explicit step information.
+ *
+ * Steps:
+ * - tool-validation: Validating tool configuration
+ * - server-creation: Creating MCP server instance
+ * - handler-registration: Registering request handlers
+ * - transport-connection: Connecting stdio transport
+ */
+export class ServerInitError extends Error {
+    step;
+    cause;
+    constructor(step, cause, message) {
+        super(message || `Server initialization failed at step: ${step}`);
+        this.step = step;
+        this.cause = cause;
+        this.name = 'ServerInitError';
+    }
+}
+//# sourceMappingURL=server-utils.js.map

package/dist/lib/core/server-utils.js.map

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