observability-toolkit 2.0.0 → 2.1.1

package/dist/tools/signoz.integration.test.js

@@ -1,141 +0,0 @@
-/**
- * Integration tests for SigNoz-dependent tools
- *
- * These tests connect to a real SigNoz instance when configured.
- * They skip gracefully when SIGNOZ_URL and SIGNOZ_API_KEY are not set.
- */
-import { describe, it } from 'node:test';
-import assert from 'node:assert';
-import { SIGNOZ_URL, SIGNOZ_API_KEY, SIGNOZ_QUERY_URL } from '../lib/constants.js';
-import { healthCheck } from './health-check.js';
-import { getTraceUrl } from './get-trace-url.js';
-import { queryTraces } from './query-traces.js';
-import { queryLogs } from './query-logs.js';
-import { queryMetrics } from './query-metrics.js';
-// Check if SigNoz Query API is configured (SIGNOZ_QUERY_URL required for queries)
-const SIGNOZ_QUERY_CONFIGURED = !!(SIGNOZ_QUERY_URL && SIGNOZ_API_KEY);
-// Check if SigNoz ingest is configured (for health check)
-const SIGNOZ_CONFIGURED = !!(SIGNOZ_URL && SIGNOZ_API_KEY);
-describe('Tool Integration Tests (SigNoz)', { skip: !SIGNOZ_QUERY_CONFIGURED }, () => {
-    describe('healthCheck with SigNoz', () => {
-        it('should include SigNoz status in health check', async () => {
-            const result = await healthCheck({ verbose: true });
-            assert.strictEqual(typeof result, 'object');
-            assert('backends' in result);
-            assert('signoz' in result.backends);
-            assert.strictEqual(result.backends.signoz.configured, true);
-            assert(['ok', 'error'].includes(result.backends.signoz.status));
-            console.log(`  SigNoz status: ${result.backends.signoz.status}`);
-            if (result.backends.signoz.message) {
-                console.log(`  Message: ${result.backends.signoz.message}`);
-            }
-        });
-        it('should report degraded status if SigNoz fails', async () => {
-            const result = await healthCheck({ verbose: false });
-            // When SigNoz is configured, overall status depends on both backends
-            assert(['healthy', 'degraded', 'unhealthy'].includes(result.status));
-            console.log(`  Overall status: ${result.status}`);
-        });
-    });
-    describe('getTraceUrl with SigNoz', () => {
-        it('should generate trace URL for valid trace ID', async () => {
-            // First, get a real trace ID from SigNoz
-            const traces = await queryTraces({ backend: 'signoz', limit: 1 });
-            if (traces.count > 0 && traces.traces.length > 0) {
-                const traceId = traces.traces[0].traceId;
-                const result = await getTraceUrl({ traceId });
-                assert('url' in result);
-                assert(result.url && result.url.includes(traceId));
-                console.log(`  Generated URL for trace: ${traceId.substring(0, 16)}...`);
-            }
-            else {
-                console.log('  No traces found to test URL generation');
-            }
-        });
-        it('should handle non-existent trace ID gracefully', async () => {
-            const result = await getTraceUrl({ traceId: 'nonexistent-trace-id-12345' });
-            // Should still return a URL (validation happens on SigNoz side)
-            assert('url' in result || 'error' in result);
-        });
-    });
-    describe('queryTraces with SigNoz backend', () => {
-        it('should query traces from SigNoz', async () => {
-            const result = await queryTraces({ backend: 'signoz', limit: 5 });
-            assert.strictEqual(result.backend, 'signoz');
-            assert(typeof result.count === 'number');
-            assert(Array.isArray(result.traces));
-            console.log(`  Found ${result.count} traces via SigNoz`);
-        });
-        it('should filter traces by duration', async () => {
-            const result = await queryTraces({
-                backend: 'signoz',
-                minDurationMs: 100,
-                limit: 5,
-            });
-            assert.strictEqual(result.backend, 'signoz');
-            console.log(`  Found ${result.count} traces with duration >= 100ms`);
-        });
-    });
-    describe('queryLogs with SigNoz backend', () => {
-        it('should query logs from SigNoz', async () => {
-            const result = await queryLogs({ backend: 'signoz', limit: 5 });
-            assert.strictEqual(result.backend, 'signoz');
-            assert(typeof result.count === 'number');
-            assert(Array.isArray(result.logs));
-            console.log(`  Found ${result.count} logs via SigNoz`);
-        });
-        it('should filter logs by severity', async () => {
-            const result = await queryLogs({
-                backend: 'signoz',
-                severity: 'INFO',
-                limit: 5,
-            });
-            assert.strictEqual(result.backend, 'signoz');
-            console.log(`  Found ${result.count} INFO logs`);
-        });
-    });
-    describe('queryMetrics with SigNoz backend', () => {
-        it('should query metrics from SigNoz', async () => {
-            const result = await queryMetrics({
-                backend: 'signoz',
-                metricName: 'signoz_calls_total',
-                limit: 5,
-            });
-            assert.strictEqual(result.backend, 'signoz');
-            assert(typeof result.count === 'number');
-            console.log(`  Found ${result.count} metric data points via SigNoz`);
-        });
-    });
-});
-describe('Tool Integration (No SigNoz Query)', { skip: SIGNOZ_QUERY_CONFIGURED || !SIGNOZ_CONFIGURED }, () => {
-    // This test only runs when ingest is configured but query is not
-    it('should show SigNoz configured but query unavailable', async () => {
-        const result = await healthCheck({ verbose: false });
-        // Ingest URL is configured, so healthCheck shows it as configured
-        // But query operations will fail without SIGNOZ_QUERY_URL
-        console.log(`  SigNoz ingest configured: ${result.backends.signoz.configured}`);
-        console.log(`  SigNoz status: ${result.backends.signoz.status}`);
-        assert(true);
-    });
-});
-describe('Tool Integration (No SigNoz At All)', { skip: SIGNOZ_CONFIGURED }, () => {
-    it('should handle missing SigNoz configuration gracefully', async () => {
-        const result = await healthCheck({ verbose: false });
-        assert.strictEqual(result.backends.signoz.configured, false);
-        assert.strictEqual(result.backends.signoz.status, 'not_configured');
-        console.log('  SigNoz not configured - tools handle gracefully');
-    });
-});
-describe('SigNoz Tool Configuration Check', () => {
-    it('should report SigNoz configuration status', () => {
-        if (SIGNOZ_QUERY_CONFIGURED) {
-            console.log('  SigNoz Query API configured - tool integration tests will run');
-        }
-        else {
-            console.log('  SigNoz Query API not configured - tool integration tests skipped');
-            console.log('  Set SIGNOZ_QUERY_URL and SIGNOZ_API_KEY to enable');
-        }
-        assert(true);
-    });
-});
-//# sourceMappingURL=signoz.integration.test.js.map

package/dist/tools/signoz.integration.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"signoz.integration.test.js","sourceRoot":"","sources":["../../src/tools/signoz.integration.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACnF,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,kFAAkF;AAClF,MAAM,uBAAuB,GAAG,CAAC,CAAC,CAAC,gBAAgB,IAAI,cAAc,CAAC,CAAC;AACvE,0DAA0D;AAC1D,MAAM,iBAAiB,GAAG,CAAC,CAAC,CAAC,UAAU,IAAI,cAAc,CAAC,CAAC;AAE3D,QAAQ,CAAC,iCAAiC,EAAE,EAAE,IAAI,EAAE,CAAC,uBAAuB,EAAE,EAAE,GAAG,EAAE;IACnF,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACvC,EAAE,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;YAC5D,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;YAEpD,MAAM,CAAC,WAAW,CAAC,OAAO,MAAM,EAAE,QAAQ,CAAC,CAAC;YAC5C,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,CAAC;YAC7B,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC;YACpC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;YAC5D,MAAM,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;YAEhE,OAAO,CAAC,GAAG,CAAC,oBAAoB,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;YACjE,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnC,OAAO,CAAC,GAAG,CAAC,cAAc,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;YAC7D,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YAErD,qEAAqE;YACrE,MAAM,CAAC,CAAC,SAAS,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;YACrE,OAAO,CAAC,GAAG,CAAC,qBAAqB,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QACpD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACvC,EAAE,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;YAC5D,yCAAyC;YACzC,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;YAElE,IAAI,MAAM,CAAC,KAAK,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACjD,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;gBACzC,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;gBAE9C,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,CAAC;gBACxB,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;gBACnD,OAAO,CAAC,GAAG,CAAC,8BAA8B,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;YAC3E,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;YAC9D,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,EAAE,OAAO,EAAE,4BAA4B,EAAE,CAAC,CAAC;YAE5E,gEAAgE;YAChE,MAAM,CAAC,KAAK,IAAI,MAAM,IAAI,OAAO,IAAI,MAAM,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,iCAAiC,EAAE,GAAG,EAAE;QAC/C,EAAE,CAAC,iCAAiC,EAAE,KAAK,IAAI,EAAE;YAC/C,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;YAElE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YAC7C,MAAM,CAAC,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC;YACzC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;YACrC,OAAO,CAAC,GAAG,CAAC,WAAW,MAAM,CAAC,KAAK,oBAAoB,CAAC,CAAC;QAC3D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;YAChD,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC;gBAC/B,OAAO,EAAE,QAAQ;gBACjB,aAAa,EAAE,GAAG;gBAClB,KAAK,EAAE,CAAC;aACT,CAAC,CAAC;YAEH,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YAC7C,OAAO,CAAC,GAAG,CAAC,WAAW,MAAM,CAAC,KAAK,gCAAgC,CAAC,CAAC;QACvE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,+BAA+B,EAAE,GAAG,EAAE;QAC7C,EAAE,CAAC,+BAA+B,EAAE,KAAK,IAAI,EAAE;YAC7C,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;YAEhE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YAC7C,MAAM,CAAC,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC;YACzC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;YACnC,OAAO,CAAC,GAAG,CAAC,WAAW,MAAM,CAAC,KAAK,kBAAkB,CAAC,CAAC;QACzD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gCAAgC,EAAE,KAAK,IAAI,EAAE;YAC9C,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC;gBAC7B,OAAO,EAAE,QAAQ;gBACjB,QAAQ,EAAE,MAAM;gBAChB,KAAK,EAAE,CAAC;aACT,CAAC,CAAC;YAEH,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YAC7C,OAAO,CAAC,GAAG,CAAC,WAAW,MAAM,CAAC,KAAK,YAAY,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAChD,EAAE,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;YAChD,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC;gBAChC,OAAO,EAAE,QAAQ;gBACjB,UAAU,EAAE,oBAAoB;gBAChC,KAAK,EAAE,CAAC;aACT,CAAC,CAAC;YAEH,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YAC7C,MAAM,CAAC,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC;YACzC,OAAO,CAAC,GAAG,CAAC,WAAW,MAAM,CAAC,KAAK,gCAAgC,CAAC,CAAC;QACvE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,oCAAoC,EAAE,EAAE,IAAI,EAAE,uBAAuB,IAAI,CAAC,iBAAiB,EAAE,EAAE,GAAG,EAAE;IAC3G,iEAAiE;IACjE,EAAE,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;QACnE,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QAErD,kEAAkE;QAClE,0DAA0D;QAC1D,OAAO,CAAC,GAAG,CAAC,+BAA+B,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;QAChF,OAAO,CAAC,GAAG,CAAC,oBAAoB,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QACjE,MAAM,CAAC,IAAI,CAAC,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,qCAAqC,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,EAAE,GAAG,EAAE;IAChF,EAAE,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;QACrE,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QAErD,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAC7D,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;QACpE,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,iCAAiC,EAAE,GAAG,EAAE;IAC/C,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,IAAI,uBAAuB,EAAE,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,iEAAiE,CAAC,CAAC;QACjF,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,oEAAoE,CAAC,CAAC;YAClF,OAAO,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAC;QACrE,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/types/evaluation-hooks.d.ts

@@ -1,176 +0,0 @@
-/**
- * Type definitions for LLM-as-Judge Hooks (Phase 4e)
- *
- * Enables external evaluators to inject quality scores via webhooks.
- * Supports multiple authentication methods and evaluation sources.
- */
-import type { EvaluatorType, StepScore, ToolVerification } from '../backends/index.js';
-/**
- * Supported authentication methods for webhook endpoints
- */
-export type WebhookAuthMethod = 'hmac-sha256' | 'bearer' | 'api-key' | 'none';
-/**
- * Configuration for a webhook endpoint that receives evaluation scores
- */
-export interface WebhookConfig {
-    /** Unique identifier for this webhook configuration */
-    id: string;
-    /** Human-readable name for the webhook */
-    name: string;
-    /** Authentication method */
-    authMethod: WebhookAuthMethod;
-    /** Secret for HMAC signature validation (required for hmac-sha256) */
-    secret?: string;
-    /** Expected bearer token (required for bearer auth) */
-    bearerToken?: string;
-    /** Expected API key (required for api-key auth) */
-    apiKey?: string;
-    /** Optional IP allowlist for additional security */
-    allowedIps?: string[];
-    /** Whether this webhook is enabled */
-    enabled: boolean;
-    /** Creation timestamp */
-    createdAt: string;
-    /** Last update timestamp */
-    updatedAt?: string;
-}
-/**
- * Payload structure for webhook-delivered evaluation results.
- * Compatible with EvaluationResult but with required fields for external injection.
- */
-export interface WebhookEvaluationPayload {
-    /** Evaluation metric name (e.g., "relevance", "faithfulness") - REQUIRED */
-    evaluationName: string;
-    /** Numeric score (0-1 normalized recommended) - one of scoreValue or scoreLabel required */
-    scoreValue?: number;
-    /** Human-readable label (e.g., "pass", "fail", "relevant") */
-    scoreLabel?: string;
-    /** Score unit/scale (e.g., "ratio_0_1", "percentage", "stars_5") */
-    scoreUnit?: string;
-    /** Explanation/rationale for the score */
-    explanation?: string;
-    /** Identity of the evaluator - REQUIRED for external webhooks */
-    evaluator: string;
-    /** Type of evaluator */
-    evaluatorType: EvaluatorType;
-    /** Response ID for correlation */
-    responseId?: string;
-    /** Trace ID for correlation */
-    traceId?: string;
-    /** Session ID for session-scoped correlation */
-    sessionId?: string;
-    /** Subject agent ID being evaluated */
-    agentId?: string;
-    /** Subject agent name being evaluated */
-    agentName?: string;
-    /** Per-step evaluation breakdown for agent trajectory */
-    stepScores?: StepScore[];
-    /** Tool call correctness verifications */
-    toolVerifications?: ToolVerification[];
-    /** Number of steps/actions in agent trajectory */
-    trajectoryLength?: number;
-    /** Optional custom metadata from external system */
-    metadata?: Record<string, unknown>;
-}
-/**
- * Batch payload for multiple evaluations in a single request
- */
-export interface WebhookBatchPayload {
-    /** Array of evaluations (max 100 per batch) */
-    evaluations: WebhookEvaluationPayload[];
-}
-/**
- * Result of webhook payload validation and processing
- */
-export interface HookResult {
-    /** Whether the operation succeeded */
-    success: boolean;
-    /** Human-readable message */
-    message: string;
-    /** Number of evaluations successfully processed */
-    processedCount?: number;
-    /** IDs of created evaluations (for deduplication tracking) */
-    evaluationIds?: string[];
-    /** Validation errors if any */
-    errors?: HookValidationError[];
-}
-/**
- * Detailed validation error for a specific field or evaluation
- */
-export interface HookValidationError {
-    /** Index in batch (for batch payloads) */
-    index?: number;
-    /** Field that failed validation */
-    field: string;
-    /** Error message */
-    message: string;
-    /** Suggested fix */
-    suggestion?: string;
-}
-/**
- * HMAC signature verification result
- */
-export interface SignatureVerificationResult {
-    /** Whether signature is valid */
-    valid: boolean;
-    /** Error message if invalid */
-    error?: string;
-    /** Detected algorithm (for diagnostic purposes) */
-    algorithm?: string;
-}
-/**
- * Options for the hook executor
- */
-export interface HookExecutorOptions {
-    /** Directory to write evaluation JSONL files */
-    telemetryDir: string;
-    /** Whether to validate signature (default: true) */
-    validateSignature?: boolean;
-    /** Maximum evaluations per batch (default: 100) */
-    maxBatchSize?: number;
-    /** Whether to deduplicate by responseId + timestamp (default: false) */
-    deduplication?: boolean;
-}
-/**
- * Statistics for hook processing
- */
-export interface HookStats {
-    /** Total evaluations received */
-    totalReceived: number;
-    /** Successfully processed */
-    successCount: number;
-    /** Failed due to validation */
-    validationFailures: number;
-    /** Failed due to signature */
-    signatureFailures: number;
-    /** Deduplicated (skipped) */
-    deduplicatedCount: number;
-    /** Last processed timestamp */
-    lastProcessedAt?: string;
-}
-/**
- * Score normalization configuration
- */
-export interface ScoreNormalizationConfig {
-    /** Unit of the input score */
-    inputUnit: string;
-    /** Target unit (usually "ratio_0_1") */
-    targetUnit: string;
-    /** Minimum value for the input scale */
-    inputMin: number;
-    /** Maximum value for the input scale */
-    inputMax: number;
-}
-/**
- * Common score units and their normalization parameters
- */
-export declare const SCORE_UNIT_CONFIGS: Record<string, ScoreNormalizationConfig>;
-/**
- * Normalize a score to 0-1 range based on its unit.
- *
- * @param value - The score value to normalize
- * @param unit - The unit/scale of the input (e.g., "percentage", "stars_5")
- * @returns Normalized score clamped to [0, 1]
- */
-export declare function normalizeScore(value: number, unit?: string): number;
-//# sourceMappingURL=evaluation-hooks.d.ts.map

package/dist/types/evaluation-hooks.d.ts.map

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

package/dist/types/evaluation-hooks.js

@@ -1,49 +0,0 @@
-/**
- * Type definitions for LLM-as-Judge Hooks (Phase 4e)
- *
- * Enables external evaluators to inject quality scores via webhooks.
- * Supports multiple authentication methods and evaluation sources.
- */
-/**
- * Common score units and their normalization parameters
- */
-export const SCORE_UNIT_CONFIGS = {
-    ratio_0_1: { inputUnit: 'ratio_0_1', targetUnit: 'ratio_0_1', inputMin: 0, inputMax: 1 },
-    percentage: { inputUnit: 'percentage', targetUnit: 'ratio_0_1', inputMin: 0, inputMax: 100 },
-    stars_5: { inputUnit: 'stars_5', targetUnit: 'ratio_0_1', inputMin: 0, inputMax: 5 },
-    stars_10: { inputUnit: 'stars_10', targetUnit: 'ratio_0_1', inputMin: 0, inputMax: 10 },
-    likert_5: { inputUnit: 'likert_5', targetUnit: 'ratio_0_1', inputMin: 1, inputMax: 5 },
-    likert_7: { inputUnit: 'likert_7', targetUnit: 'ratio_0_1', inputMin: 1, inputMax: 7 },
-};
-/**
- * Normalize a score to 0-1 range based on its unit.
- *
- * @param value - The score value to normalize
- * @param unit - The unit/scale of the input (e.g., "percentage", "stars_5")
- * @returns Normalized score clamped to [0, 1]
- */
-export function normalizeScore(value, unit) {
-    // Handle NaN, Infinity, -Infinity
-    if (!Number.isFinite(value)) {
-        return 0;
-    }
-    if (!unit || unit === 'ratio_0_1') {
-        return Math.max(0, Math.min(1, value));
-    }
-    const config = SCORE_UNIT_CONFIGS[unit];
-    if (!config) {
-        // Unknown unit - assume 0-1 and clamp
-        return Math.max(0, Math.min(1, value));
-    }
-    // Handle division by zero (inputMin === inputMax)
-    const range = config.inputMax - config.inputMin;
-    if (range === 0) {
-        // Edge case: if value equals the single valid value, return 0.5
-        // Otherwise clamp to bounds
-        return value === config.inputMin ? 0.5 : Math.max(0, Math.min(1, value));
-    }
-    // Normalize to 0-1
-    const normalized = (value - config.inputMin) / range;
-    return Math.max(0, Math.min(1, normalized));
-}
-//# sourceMappingURL=evaluation-hooks.js.map

package/dist/types/evaluation-hooks.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"evaluation-hooks.js","sourceRoot":"","sources":["../../src/types/evaluation-hooks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAyLH;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA6C;IAC1E,SAAS,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE;IACxF,UAAU,EAAE,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE;IAC5F,OAAO,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE;IACpF,QAAQ,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE;IACvF,QAAQ,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE;IACtF,QAAQ,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE;CACvF,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,IAAa;IACzD,kCAAkC;IAClC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,CAAC,IAAI,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,sCAAsC;QACtC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,kDAAkD;IAClD,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IAChD,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QAChB,gEAAgE;QAChE,4BAA4B;QAC5B,OAAO,KAAK,KAAK,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IAC3E,CAAC;IAED,mBAAmB;IACnB,MAAM,UAAU,GAAG,CAAC,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC;IACrD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;AAC9C,CAAC"}