@thinkhive/sdk 3.1.0 → 3.3.0

package/dist/api/business-metrics.d.ts

@@ -0,0 +1,188 @@
+/**
+ * ThinkHive SDK v3.2 - Business Metrics API
+ *
+ * Industry-driven business metrics with historical tracking and external data support
+ */
+/**
+ * Metric trend information
+ */
+export interface MetricTrend {
+    direction: 'up' | 'down' | 'stable';
+    value: number;
+    isPositive: boolean;
+}
+/**
+ * Current metric status
+ */
+export type MetricStatus = 'ready' | 'insufficient_data' | 'awaiting_external' | 'stale';
+/**
+ * Current metric response from the API
+ */
+export interface CurrentMetricResponse {
+    metricName: string;
+    metricType: 'trace_calculated' | 'external';
+    value: number | null;
+    valueFormatted: string;
+    unit?: string;
+    status: MetricStatus;
+    statusMessage?: string;
+    trend?: MetricTrend;
+    traceCount?: number;
+    minTraceThreshold?: number;
+    progressPercent?: number;
+    lastExternalUpdate?: string;
+}
+/**
+ * Historical data point
+ */
+export interface MetricHistoryPoint {
+    periodStart: string;
+    periodEnd: string;
+    value: number;
+    valueFormatted?: string;
+    source: string;
+    traceCount?: number;
+}
+/**
+ * Historical summary statistics
+ */
+export interface MetricHistorySummary {
+    current: number | null;
+    previous: number | null;
+    changePercent: number | null;
+    isPositive: boolean;
+    dataPointCount: number;
+}
+/**
+ * Full history response
+ */
+export interface MetricHistoryResponse {
+    metricName: string;
+    unit: string;
+    higherIsBetter: boolean;
+    dataPoints: MetricHistoryPoint[];
+    summary: MetricHistorySummary;
+}
+/**
+ * Options for recording external metric values
+ */
+export interface RecordMetricOptions {
+    metricName: string;
+    value: number;
+    unit?: string;
+    periodStart: string | Date;
+    periodEnd: string | Date;
+    source?: string;
+    sourceDetails?: Record<string, unknown>;
+}
+/**
+ * Response from recording a metric value
+ */
+export interface RecordMetricResponse {
+    success: boolean;
+    id: string;
+    recordedAt: string;
+}
+/**
+ * Business Metrics API client for industry-driven metrics with historical tracking
+ */
+export declare const businessMetrics: {
+    /**
+     * Get current metric value with status information
+     *
+     * @example
+     * ```typescript
+     * const metric = await businessMetrics.current('agent_123', 'Deflection Rate');
+     * console.log(`${metric.metricName}: ${metric.valueFormatted}`);
+     *
+     * if (metric.status === 'insufficient_data') {
+     *   console.log(`Need ${metric.minTraceThreshold - metric.traceCount} more traces`);
+     * }
+     * ```
+     */
+    current(agentId: string, metricName?: string): Promise<CurrentMetricResponse>;
+    /**
+     * Get historical metric data for graphing
+     *
+     * @example
+     * ```typescript
+     * const history = await businessMetrics.history('agent_123', 'Deflection Rate', {
+     *   startDate: new Date(Date.now() - 30 * 24 * 60 * 60 * 1000),
+     *   endDate: new Date(),
+     *   granularity: 'daily',
+     * });
+     *
+     * console.log(`${history.dataPoints.length} data points`);
+     * console.log(`Change: ${history.summary.changePercent}%`);
+     * ```
+     */
+    history(agentId: string, metricName: string, options?: {
+        startDate?: string | Date;
+        endDate?: string | Date;
+        granularity?: "hourly" | "daily" | "weekly" | "monthly";
+    }): Promise<MetricHistoryResponse>;
+    /**
+     * Record an external metric value
+     *
+     * Use this to ingest metrics from external data sources (CRM, surveys, billing, etc.)
+     *
+     * @example
+     * ```typescript
+     * // Record CSAT score from survey system
+     * await businessMetrics.record('agent_123', {
+     *   metricName: 'CSAT/NPS',
+     *   value: 4.5,
+     *   unit: 'score',
+     *   periodStart: '2024-01-01T00:00:00Z',
+     *   periodEnd: '2024-01-07T23:59:59Z',
+     *   source: 'survey_system',
+     *   sourceDetails: { surveyId: 'survey_456', responseCount: 150 },
+     * });
+     * ```
+     */
+    record(agentId: string, options: RecordMetricOptions): Promise<RecordMetricResponse>;
+    /**
+     * Batch record multiple external metric values
+     *
+     * @example
+     * ```typescript
+     * await businessMetrics.recordBatch('agent_123', [
+     *   { metricName: 'CSAT/NPS', value: 4.5, ... },
+     *   { metricName: 'Hours Saved', value: 120, ... },
+     * ]);
+     * ```
+     */
+    recordBatch(agentId: string, metrics: RecordMetricOptions[]): Promise<RecordMetricResponse[]>;
+};
+/**
+ * Check if a metric is ready to display
+ */
+export declare function isMetricReady(metric: CurrentMetricResponse): boolean;
+/**
+ * Check if a metric needs more trace data
+ */
+export declare function needsMoreTraces(metric: CurrentMetricResponse): boolean;
+/**
+ * Check if a metric is waiting for external data
+ */
+export declare function awaitingExternalData(metric: CurrentMetricResponse): boolean;
+/**
+ * Check if metric data is stale
+ */
+export declare function isMetricStale(metric: CurrentMetricResponse): boolean;
+/**
+ * Get human-readable status message
+ */
+export declare function getStatusMessage(metric: CurrentMetricResponse): string;
+/**
+ * Calculate progress toward minimum trace threshold
+ */
+export declare function getTraceProgress(metric: CurrentMetricResponse): number;
+/**
+ * Format metric value for display based on unit
+ */
+export declare function formatMetricValue(value: number, unit: string): string;
+/**
+ * Get trend direction as emoji
+ */
+export declare function getTrendEmoji(trend: MetricTrend): string;

package/dist/api/business-metrics.js

@@ -0,0 +1,213 @@
+"use strict";
+/**
+ * ThinkHive SDK v3.2 - Business Metrics API
+ *
+ * Industry-driven business metrics with historical tracking and external data support
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.businessMetrics = void 0;
+exports.isMetricReady = isMetricReady;
+exports.needsMoreTraces = needsMoreTraces;
+exports.awaitingExternalData = awaitingExternalData;
+exports.isMetricStale = isMetricStale;
+exports.getStatusMessage = getStatusMessage;
+exports.getTraceProgress = getTraceProgress;
+exports.formatMetricValue = formatMetricValue;
+exports.getTrendEmoji = getTrendEmoji;
+const client_1 = require("../core/client");
+// ============================================================================
+// BUSINESS METRICS API CLIENT
+// ============================================================================
+/**
+ * Business Metrics API client for industry-driven metrics with historical tracking
+ */
+exports.businessMetrics = {
+    /**
+     * Get current metric value with status information
+     *
+     * @example
+     * ```typescript
+     * const metric = await businessMetrics.current('agent_123', 'Deflection Rate');
+     * console.log(`${metric.metricName}: ${metric.valueFormatted}`);
+     *
+     * if (metric.status === 'insufficient_data') {
+     *   console.log(`Need ${metric.minTraceThreshold - metric.traceCount} more traces`);
+     * }
+     * ```
+     */
+    async current(agentId, metricName) {
+        const params = new URLSearchParams();
+        if (metricName) {
+            params.set('metricName', metricName);
+        }
+        const queryString = params.toString();
+        const url = `/agents/${agentId}/metrics/current${queryString ? `?${queryString}` : ''}`;
+        return (0, client_1.apiRequestWithData)(url, { apiVersion: 'v3' });
+    },
+    /**
+     * Get historical metric data for graphing
+     *
+     * @example
+     * ```typescript
+     * const history = await businessMetrics.history('agent_123', 'Deflection Rate', {
+     *   startDate: new Date(Date.now() - 30 * 24 * 60 * 60 * 1000),
+     *   endDate: new Date(),
+     *   granularity: 'daily',
+     * });
+     *
+     * console.log(`${history.dataPoints.length} data points`);
+     * console.log(`Change: ${history.summary.changePercent}%`);
+     * ```
+     */
+    async history(agentId, metricName, options = {}) {
+        const params = new URLSearchParams();
+        params.set('metricName', metricName);
+        if (options.startDate) {
+            params.set('startDate', new Date(options.startDate).toISOString());
+        }
+        if (options.endDate) {
+            params.set('endDate', new Date(options.endDate).toISOString());
+        }
+        if (options.granularity) {
+            params.set('granularity', options.granularity);
+        }
+        return (0, client_1.apiRequestWithData)(`/agents/${agentId}/metrics/history?${params.toString()}`, { apiVersion: 'v3' });
+    },
+    /**
+     * Record an external metric value
+     *
+     * Use this to ingest metrics from external data sources (CRM, surveys, billing, etc.)
+     *
+     * @example
+     * ```typescript
+     * // Record CSAT score from survey system
+     * await businessMetrics.record('agent_123', {
+     *   metricName: 'CSAT/NPS',
+     *   value: 4.5,
+     *   unit: 'score',
+     *   periodStart: '2024-01-01T00:00:00Z',
+     *   periodEnd: '2024-01-07T23:59:59Z',
+     *   source: 'survey_system',
+     *   sourceDetails: { surveyId: 'survey_456', responseCount: 150 },
+     * });
+     * ```
+     */
+    async record(agentId, options) {
+        const body = {
+            metricName: options.metricName,
+            value: options.value,
+            unit: options.unit,
+            periodStart: new Date(options.periodStart).toISOString(),
+            periodEnd: new Date(options.periodEnd).toISOString(),
+            source: options.source || 'api',
+            sourceDetails: options.sourceDetails,
+        };
+        const response = await (0, client_1.apiRequest)(`/agents/${agentId}/metrics/values`, {
+            method: 'POST',
+            body,
+            apiVersion: 'v3',
+        });
+        return response.data;
+    },
+    /**
+     * Batch record multiple external metric values
+     *
+     * @example
+     * ```typescript
+     * await businessMetrics.recordBatch('agent_123', [
+     *   { metricName: 'CSAT/NPS', value: 4.5, ... },
+     *   { metricName: 'Hours Saved', value: 120, ... },
+     * ]);
+     * ```
+     */
+    async recordBatch(agentId, metrics) {
+        const results = await Promise.all(metrics.map((metric) => this.record(agentId, metric)));
+        return results;
+    },
+};
+// ============================================================================
+// HELPER FUNCTIONS
+// ============================================================================
+/**
+ * Check if a metric is ready to display
+ */
+function isMetricReady(metric) {
+    return metric.status === 'ready';
+}
+/**
+ * Check if a metric needs more trace data
+ */
+function needsMoreTraces(metric) {
+    return metric.status === 'insufficient_data';
+}
+/**
+ * Check if a metric is waiting for external data
+ */
+function awaitingExternalData(metric) {
+    return metric.status === 'awaiting_external';
+}
+/**
+ * Check if metric data is stale
+ */
+function isMetricStale(metric) {
+    return metric.status === 'stale';
+}
+/**
+ * Get human-readable status message
+ */
+function getStatusMessage(metric) {
+    switch (metric.status) {
+        case 'ready':
+            return 'Metric is up to date';
+        case 'insufficient_data':
+            return metric.statusMessage ||
+                `Need ${(metric.minTraceThreshold || 50) - (metric.traceCount || 0)} more traces`;
+        case 'awaiting_external':
+            return metric.statusMessage || 'Waiting for external data source';
+        case 'stale':
+            return metric.statusMessage || 'Data may be outdated';
+        default:
+            return 'Unknown status';
+    }
+}
+/**
+ * Calculate progress toward minimum trace threshold
+ */
+function getTraceProgress(metric) {
+    if (metric.status !== 'insufficient_data')
+        return 100;
+    return metric.progressPercent || 0;
+}
+/**
+ * Format metric value for display based on unit
+ */
+function formatMetricValue(value, unit) {
+    switch (unit) {
+        case '%':
+            return `${Math.round(value * 10) / 10}%`;
+        case '$':
+            return new Intl.NumberFormat('en-US', {
+                style: 'currency',
+                currency: 'USD',
+            }).format(value);
+        case 's':
+            return value < 60 ? `${Math.round(value)}s` : `${Math.round(value / 60)}m`;
+        case 'hrs':
+            return `${Math.round(value * 10) / 10} hrs`;
+        case 'score':
+            return value.toFixed(1);
+        default:
+            return String(Math.round(value * 100) / 100);
+    }
+}
+/**
+ * Get trend direction as emoji
+ */
+function getTrendEmoji(trend) {
+    if (trend.direction === 'up')
+        return trend.isPositive ? '📈' : '📉';
+    if (trend.direction === 'down')
+        return trend.isPositive ? '📈' : '📉';
+    return '➡️';
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYnVzaW5lc3MtbWV0cmljcy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9hcGkvYnVzaW5lc3MtbWV0cmljcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBQUE7Ozs7R0FJRzs7O0FBMFBILHNDQUVDO0FBS0QsMENBRUM7QUFLRCxvREFFQztBQUtELHNDQUVDO0FBS0QsNENBY0M7QUFLRCw0Q0FHQztBQUtELDhDQWtCQztBQUtELHNDQUlDO0FBMVVELDJDQUFnRTtBQStGaEUsK0VBQStFO0FBQy9FLDhCQUE4QjtBQUM5QiwrRUFBK0U7QUFFL0U7O0dBRUc7QUFDVSxRQUFBLGVBQWUsR0FBRztJQUM3Qjs7Ozs7Ozs7Ozs7O09BWUc7SUFDSCxLQUFLLENBQUMsT0FBTyxDQUNYLE9BQWUsRUFDZixVQUFtQjtRQUVuQixNQUFNLE1BQU0sR0FBRyxJQUFJLGVBQWUsRUFBRSxDQUFDO1FBQ3JDLElBQUksVUFBVSxFQUFFLENBQUM7WUFDZixNQUFNLENBQUMsR0FBRyxDQUFDLFlBQVksRUFBRSxVQUFVLENBQUMsQ0FBQztRQUN2QyxDQUFDO1FBRUQsTUFBTSxXQUFXLEdBQUcsTUFBTSxDQUFDLFFBQVEsRUFBRSxDQUFDO1FBQ3RDLE1BQU0sR0FBRyxHQUFHLFdBQVcsT0FBTyxtQkFBbUIsV0FBVyxDQUFDLENBQUMsQ0FBQyxJQUFJLFdBQVcsRUFBRSxDQUFDLENBQUMsQ0FBQyxFQUFFLEVBQUUsQ0FBQztRQUV4RixPQUFPLElBQUEsMkJBQWtCLEVBQXdCLEdBQUcsRUFBRSxFQUFFLFVBQVUsRUFBRSxJQUFJLEVBQUUsQ0FBQyxDQUFDO0lBQzlFLENBQUM7SUFFRDs7Ozs7Ozs7Ozs7Ozs7T0FjRztJQUNILEtBQUssQ0FBQyxPQUFPLENBQ1gsT0FBZSxFQUNmLFVBQWtCLEVBQ2xCLFVBSUksRUFBRTtRQUVOLE1BQU0sTUFBTSxHQUFHLElBQUksZUFBZSxFQUFFLENBQUM7UUFDckMsTUFBTSxDQUFDLEdBQUcsQ0FBQyxZQUFZLEVBQUUs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QUFJLENBQUMsS0FBSyxDQUFDLEtBQUssQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLEdBQUcsSUFBSSxDQUFDLEtBQUssQ0FBQyxLQUFLLEdBQUcsRUFBRSxDQUFDLEdBQUcsQ0FBQztRQUM3RSxLQUFLLEtBQUs7WUFDUixPQUFPLEdBQUcsSUFBSSxDQUFDLEtBQUssQ0FBQyxLQUFLLEdBQUcsRUFBRSxDQUFDLEdBQUcsRUFBRSxNQUFNLENBQUM7UUFDOUMsS0FBSyxPQUFPO1lBQ1YsT0FBTyxLQUFLLENBQUMsT0FBTyxDQUFDLENBQUMsQ0FBQyxDQUFDO1FBQzFCO1lBQ0UsT0FBTyxNQUFNLENBQUMsSUFBSSxDQUFDLEtBQUssQ0FBQyxLQUFLLEdBQUcsR0FBRyxDQUFDLEdBQUcsR0FBRyxDQUFDLENBQUM7SUFDakQsQ0FBQztBQUNILENBQUM7QUFFRDs7R0FFRztBQUNILFNBQWdCLGFBQWEsQ0FBQyxLQUFrQjtJQUM5QyxJQUFJLEtBQUssQ0FBQyxTQUFTLEtBQUssSUFBSTtRQUFFLE9BQU8sS0FBSyxDQUFDLFVBQVUsQ0FBQyxDQUFDLENBQUMsSUFBSSxDQUFDLENBQUMsQ0FBQyxJQUFJLENBQUM7SUFDcEUsSUFBSSxLQUFLLENBQUMsU0FBUyxLQUFLLE1BQU07UUFBRSxPQUFPLEtBQUssQ0FBQyxVQUFVLENBQUMsQ0FBQyxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsSUFBSSxDQUFDO0lBQ3RFLE9BQU8sSUFBSSxDQUFDO0FBQ2QsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogVGhpbmtIaXZlIFNESyB2My4yIC0gQnVzaW5lc3MgTWV0cmljcyBBUElcbiAqXG4gKiBJbmR1c3RyeS1kcml2ZW4gYnVzaW5lc3MgbWV0cmljcyB3aXRoIGhpc3RvcmljYWwgdHJhY2tpbmcgYW5kIGV4dGVybmFsIGRhdGEgc3VwcG9ydFxuICovXG5cbmltcG9ydCB7IGFwaVJlcXVlc3QsIGFwaVJlcXVlc3RXaXRoRGF0YSB9IGZyb20gJy4uL2NvcmUvY2xpZW50JztcbmltcG9ydCB0eXBlIHsgQXBpUmVzcG9uc2UgfSBmcm9tICcuLi9jb3JlL3R5cGVzJztcblxuLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuLy8gVFlQRVNcbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cblxuLyoqXG4gKiBNZXRyaWMgdHJlbmQgaW5mb3JtYXRpb25cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBNZXRyaWNUcmVuZCB7XG4gIGRpcmVjdGlvbjogJ3VwJyB8ICdkb3duJyB8ICdzdGFibGUnO1xuICB2YWx1ZTogbnVtYmVyO1xuICBpc1Bvc2l0aXZlOiBib29sZWFuO1xufVxuXG4vKipcbiAqIEN1cnJlbnQgbWV0cmljIHN0YXR1c1xuICovXG5leHBvcnQgdHlwZSBNZXRyaWNTdGF0dXMgPSAncmVhZHknIHwgJ2luc3VmZmljaWVudF9kYXRhJyB8ICdhd2FpdGluZ19leHRlcm5hbCcgfCAnc3RhbGUnO1xuXG4vKipcbiAqIEN1cnJlbnQgbWV0cmljIHJlc3BvbnNlIGZyb20gdGhlIEFQSVxuICovXG5leHBvcnQgaW50ZXJmYWNlIEN1cnJlbnRNZXRyaWNSZXNwb25zZSB7XG4gIG1ldHJpY05hbWU6IHN0cmluZztcbiAgbWV0cmljVHlwZTogJ3RyYWNlX2NhbGN1bGF0ZWQnIHwgJ2V4dGVybmFsJztcbiAgdmFsdWU6IG51bWJlciB8IG51bGw7XG4gIHZhbHVlRm9ybWF0dGVkOiBzdHJpbmc7XG4gIHVuaXQ/OiBzdHJpbmc7XG4gIHN0YXR1czogTWV0cmljU3RhdHVzO1xuICBzdGF0dXNNZXNzYWdlPzogc3RyaW5nO1xuICB0cmVuZD86IE1ldHJpY1RyZW5kO1xuICB0cmFjZUNvdW50PzogbnVtYmVyO1xuICBtaW5UcmFjZVRocmVzaG9sZD86IG51bWJlcjtcbiAgcHJvZ3Jlc3NQZXJjZW50PzogbnVtYmVyO1xuICBsYXN0RXh0ZXJuYWxVcGRhdGU/OiBzdHJpbmc7XG59XG5cbi8qKlxuICogSGlzdG9yaWNhbCBkYXRhIHBvaW50XG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgTWV0cmljSGlzdG9yeVBvaW50IHtcbiAgcGVyaW9kU3RhcnQ6IHN0cmluZztcbiAgcGVyaW9kRW5kOiBzdHJpbmc7XG4gIHZhbHVlOiBudW1iZXI7XG4gIHZhbHVlRm9ybWF0dGVkPzogc3RyaW5nO1xuICBzb3VyY2U6IHN0cmluZztcbiAgdHJhY2VDb3VudD86IG51bWJlcjtcbn1cblxuLyoqXG4gKiBIaXN0b3JpY2FsIHN1bW1hcnkgc3RhdGlzdGljc1xuICovXG5leHBvcnQgaW50ZXJmYWNlIE1ldHJpY0hpc3RvcnlTdW1tYXJ5IHtcbiAgY3VycmVudDogbnVtYmVyIHwgbnVsbDtcbiAgcHJldmlvdXM6IG51bWJlciB8IG51bGw7XG4gIGNoYW5nZVBlcmNlbnQ6IG51bWJlciB8IG51bGw7XG4gIGlzUG9zaXRpdmU6IGJvb2xlYW47XG4gIGRhdGFQb2ludENvdW50OiBudW1iZXI7XG59XG5cbi8qKlxuICogRnVsbCBoaXN0b3J5IHJlc3BvbnNlXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgTWV0cmljSGlzdG9yeVJlc3BvbnNlIHtcbiAgbWV0cmljTmFtZTogc3RyaW5nO1xuICB1bml0OiBzdHJpbmc7XG4gIGhpZ2hlcklzQmV0dGVyOiBib29sZWFuO1xuICBkYXRhUG9pbnRzOiBNZXRyaWNIaXN0b3J5UG9pbnRbXTtcbiAgc3VtbWFyeTogTWV0cmljSGlzdG9yeVN1bW1hcnk7XG59XG5cbi8qKlxuICogT3B0aW9ucyBmb3IgcmVjb3JkaW5nIGV4dGVybmFsIG1ldHJpYyB2YWx1ZXNcbiAqL1xuZXhwb3J0IGludGVyZmFjZSBSZWNvcmRNZXRyaWNPcHRpb25zIHtcbiAgbWV0cmljTmFtZTogc3RyaW5nO1xuICB2YWx1ZTogbnVtYmVyO1xuICB1bml0Pzogc3RyaW5nO1xuICBwZXJpb2RTdGFydDogc3RyaW5nIHwgRGF0ZTtcbiAgcGVyaW9kRW5kOiBzdHJpbmcgfCBEYXRlO1xuICBzb3VyY2U/OiBzdHJpbmc7XG4gIHNvdXJjZURldGFpbHM/OiBSZWNvcmQ8c3RyaW5nLCB1bmtub3duPjtcbn1cblxuLyoqXG4gKiBSZXNwb25zZSBmcm9tIHJlY29yZGluZyBhIG1ldHJpYyB2YWx1ZVxuICovXG5leHBvcnQgaW50ZXJmYWNlIFJlY29yZE1ldHJpY1Jlc3BvbnNlIHtcbiAgc3VjY2VzczogYm9vbGVhbjtcbiAgaWQ6IHN0cmluZztcbiAgcmVjb3JkZWRBdDogc3RyaW5nO1xufVxuXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG4vLyBCVVNJTkVTUyBNRVRSSUNTIEFQSSBDTElFTlRcbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cblxuLyoqXG4gKiBCdXNpbmVzcyBNZXRyaWNzIEFQSSBjbGllbnQgZm9yIGluZHVzdHJ5LWRyaXZlbiBtZXRyaWNzIHdpdGggaGlzdG9yaWNhbCB0cmFja2luZ1xuICovXG5leHBvcnQgY29uc3QgYnVzaW5lc3NNZXRyaWNzID0ge1xuICAvKipcbiAgICogR2V0IGN1cnJlbnQgbWV0cmljIHZhbHVlIHdpdGggc3RhdHVzIGluZm9ybWF0aW9uXG4gICAqXG4gICAqIEBleGFtcGxlXG4gICAqIGBgYHR5cGVzY3JpcHRcbiAgICogY29uc3QgbWV0cmljID0gYXdhaXQgYnVzaW5lc3NNZXRyaWNzLmN1cnJlbnQoJ2FnZW50XzEyMycsICdEZWZsZWN0aW9uIFJhdGUnKTtcbiAgICogY29uc29sZS5sb2coYCR7bWV0cmljLm1ldHJpY05hbWV9OiAke21ldHJpYy52YWx1ZUZvcm1hdHRlZH1gKTtcbiAgICpcbiAgICogaWYgKG1ldHJpYy5zdGF0dXMgPT09ICdpbnN1ZmZpY2llbnRfZGF0YScpIHtcbiAgICogICBjb25zb2xlLmxvZyhgTmVlZCAke21ldHJpYy5taW5UcmFjZVRocmVzaG9sZCAtIG1ldHJpYy50cmFjZUNvdW50fSBtb3JlIHRyYWNlc2ApO1xuICAgKiB9XG4gICAqIGBgYFxuICAgKi9cbiAgYXN5bmMgY3VycmVudChcbiAgICBhZ2VudElkOiBzdHJpbmcsXG4gICAgbWV0cmljTmFtZT86IHN0cmluZ1xuICApOiBQcm9taXNlPEN1cnJlbnRNZXRyaWNSZXNwb25zZT4ge1xuICAgIGNvbnN0IHBhcmFtcyA9IG5ldyBVUkxTZWFyY2hQYXJhbXMoKTtcbiAgICBpZiAobWV0cmljTmFtZSkge1xuICAgICAgcGFyYW1zLnNldCgnbWV0cmljTmFtZScsIG1ldHJpY05hbWUpO1xuICAgIH1cblxuICAgIGNvbnN0IHF1ZXJ5U3RyaW5nID0gcGFyYW1zLnRvU3RyaW5nKCk7XG4gICAgY29uc3QgdXJsID0gYC9hZ2VudHMvJHthZ2VudElkfS9tZXRyaWNzL2N1cnJlbnQke3F1ZXJ5U3RyaW5nID8gYD8ke3F1ZXJ5U3RyaW5nfWAgOiAnJ31gO1xuXG4gICAgcmV0dXJuIGFwaVJlcXVlc3RXaXRoRGF0YTxDdXJyZW50TWV0cmljUmVzcG9uc2U+KHVybCwgeyBhcGlWZXJzaW9uOiAndjMnIH0pO1xuICB9LFxuXG4gIC8qKlxuICAgKiBHZXQgaGlzdG9yaWNhbCBtZXRyaWMgZGF0YSBmb3IgZ3JhcGhpbmdcbiAgICpcbiAgICogQGV4YW1wbGVcbiAgICogYGBgdHlwZXNjcmlwdFxuICAgKiBjb25zdCBoaXN0b3J5ID0gYXdhaXQgYnVzaW5lc3NNZXRyaWNzLmhpc3RvcnkoJ2FnZW50XzEyMycsICdEZWZsZWN0aW9uIFJhdGUnLCB7XG4gICAqICAgc3RhcnREYXRlOiBuZXcgRGF0ZShEYXRlLm5vdygpIC0gMzAgKiAyNCAqIDYwICogNjAgKiAxMDAwKSxcbiAgICogICBlbmREYXRlOiBuZXcgRGF0ZSgpLFxuICAgKiAgIGdyYW51bGFyaXR5OiAnZGFpbHknLFxuICAgKiB9KTtcbiAgICpcbiAgICogY29uc29sZS5sb2coYCR7aGlzdG9yeS5kYXRhUG9pbnRzLmxlbmd0aH0gZGF0YSBwb2ludHNgKTtcbiAgICogY29uc29sZS5sb2coYENoYW5nZTogJHtoaXN0b3J5LnN1bW1hcnkuY2hhbmdlUGVyY2VudH0lYCk7XG4gICAqIGBgYFxuICAgKi9cbiAgYXN5bmMgaGlzdG9yeShcbiAgICBhZ2VudElkOiBzdHJpbmcsXG4gICAgbWV0cmljTmFtZTogc3RyaW5nLFxuICAgIG9wdGlvbnM6IHtcbiAgICAgIHN0YXJ0RGF0ZT86IHN0cmluZyB8IERhdGU7XG4gICAgICBlbmREYXRlPzogc3RyaW5nIHwgRGF0ZTtcbiAgICAgIGdyYW51bGFyaXR5PzogJ2hvdXJseScgfCAnZGFpbHknIHwgJ3dlZWtseScgfCAnbW9udGhseSc7XG4gICAgfSA9IHt9XG4gICk6IFByb21pc2U8TWV0cmljSGlzdG9yeVJlc3BvbnNlPiB7XG4gICAgY29uc3QgcGFyYW1zID0gbmV3IFVSTFNlYXJjaFBhcmFtcygpO1xuICAgIHBhcmFtcy5zZXQoJ21ldHJpY05hbWUnLCBtZXRyaWNOYW1lKTtcblxuICAgIGlmIChvcHRpb25zLnN0YXJ0RGF0ZSkge1xuICAgICAgcGFyYW1zLnNldCgnc3RhcnREYXRlJywgbmV3IERhdGUob3B0aW9ucy5zdGFydERhdGUpLnRvSVNPU3RyaW5nKCkpO1xuICAgIH1cbiAgICBpZiAob3B0aW9ucy5lbmREYXRlKSB7XG4gICAgICBwYXJhbXMuc2V0KCdlbmREYXRlJywgbmV3IERhdGUob3B0aW9ucy5lbmREYXRlKS50b0lTT1N0cmluZygpKTtcbiAgICB9XG4gICAgaWYgKG9wdGlvbnMuZ3JhbnVsYXJpdHkpIHtcbiAgICAgIHBhcmFtcy5zZXQoJ2dyYW51bGFyaXR5Jywgb3B0aW9ucy5ncmFudWxhcml0eSk7XG4gICAgfVxuXG4gICAgcmV0dXJuIGFwaVJlcXVlc3RXaXRoRGF0YTxNZXRyaWNIaXN0b3J5UmVzcG9uc2U+KFxuICAgICAgYC9hZ2VudHMvJHthZ2VudElkfS9tZXRyaWNzL2hpc3Rvcnk/JHtwYXJhbXMudG9TdHJpbmcoKX1gLFxuICAgICAgeyBhcGlWZXJzaW9uOiAndjMnIH1cbiAgICApO1xuICB9LFxuXG4gIC8qKlxuICAgKiBSZWNvcmQgYW4gZXh0ZXJuYWwgbWV0cmljIHZhbHVlXG4gICAqXG4gICAqIFVzZSB0aGlzIHRvIGluZ2VzdCBtZXRyaWNzIGZyb20gZXh0ZXJuYWwgZGF0YSBzb3VyY2VzIChDUk0sIHN1cnZleXMsIGJpbGxpbmcsIGV0Yy4pXG4gICAqXG4gICAqIEBleGFtcGxlXG4gICAqIGBgYHR5cGVzY3JpcHRcbiAgICogLy8gUmVjb3JkIENTQVQgc2NvcmUgZnJvbSBzdXJ2ZXkgc3lzdGVtXG4gICAqIGF3YWl0IGJ1c2luZXNzTWV0cmljcy5yZWNvcmQoJ2FnZW50XzEyMycsIHtcbiAgICogICBtZXRyaWNOYW1lOiAnQ1NBVC9OUFMnLFxuICAgKiAgIHZhbHVlOiA0LjUsXG4gICAqICAgdW5pdDogJ3Njb3JlJyxcbiAgICogICBwZXJpb2RTdGFydDogJzIwMjQtMDEtMDFUMDA6MDA6MDBaJyxcbiAgICogICBwZXJpb2RFbmQ6ICcyMDI0LTAxLTA3VDIzOjU5OjU5WicsXG4gICAqICAgc291cmNlOiAnc3VydmV5X3N5c3RlbScsXG4gICAqICAgc291cmNlRGV0YWlsczogeyBzdXJ2ZXlJZDogJ3N1cnZleV80NTYnLCByZXNwb25zZUNvdW50OiAxNTAgfSxcbiAgICogfSk7XG4gICAqIGBgYFxuICAgKi9cbiAgYXN5bmMgcmVjb3JkKFxuICAgIGFnZW50SWQ6IHN0cmluZyxcbiAgICBvcHRpb25zOiBSZWNvcmRNZXRyaWNPcHRpb25zXG4gICk6IFByb21pc2U8UmVjb3JkTWV0cmljUmVzcG9uc2U+IHtcbiAgICBjb25zdCBib2R5ID0ge1xuICAgICAgbWV0cmljTmFtZTogb3B0aW9ucy5tZXRyaWNOYW1lLFxuICAgICAgdmFsdWU6IG9wdGlvbnMudmFsdWUsXG4gICAgICB1bml0OiBvcHRpb25zLnVuaXQsXG4gICAgICBwZXJpb2RTdGFydDogbmV3IERhdGUob3B0aW9ucy5wZXJpb2RTdGFydCkudG9JU09TdHJpbmcoKSxcbiAgICAgIHBlcmlvZEVuZDogbmV3IERhdGUob3B0aW9ucy5wZXJpb2RFbmQpLnRvSVNPU3RyaW5nKCksXG4gICAgICBzb3VyY2U6IG9wdGlvbnMuc291cmNlIHx8ICdhcGknLFxuICAgICAgc291cmNlRGV0YWlsczogb3B0aW9ucy5zb3VyY2VEZXRhaWxzLFxuICAgIH07XG5cbiAgICBjb25zdCByZXNwb25zZSA9IGF3YWl0IGFwaVJlcXVlc3Q8QXBpUmVzcG9uc2U8UmVjb3JkTWV0cmljUmVzcG9uc2U+PihcbiAgICAgIGAvYWdlbnRzLyR7YWdlbnRJZH0vbWV0cmljcy92YWx1ZXNgLFxuICAgICAge1xuICAgICAgICBtZXRob2Q6ICdQT1NUJyxcbiAgICAgICAgYm9keSxcbiAgICAgICAgYXBpVmVyc2lvbjogJ3YzJyxcbiAgICAgIH1cbiAgICApO1xuXG4gICAgcmV0dXJuIHJlc3BvbnNlLmRhdGEhO1xuICB9LFxuXG4gIC8qKlxuICAgKiBCYXRjaCByZWNvcmQgbXVsdGlwbGUgZXh0ZXJuYWwgbWV0cmljIHZhbHVlc1xuICAgKlxuICAgKiBAZXhhbXBsZVxuICAgKiBgYGB0eXBlc2NyaXB0XG4gICAqIGF3YWl0IGJ1c2luZXNzTWV0cmljcy5yZWNvcmRCYXRjaCgnYWdlbnRfMTIzJywgW1xuICAgKiAgIHsgbWV0cmljTmFtZTogJ0NTQVQvTlBTJywgdmFsdWU6IDQuNSwgLi4uIH0sXG4gICAqICAgeyBtZXRyaWNOYW1lOiAnSG91cnMgU2F2ZWQnLCB2YWx1ZTogMTIwLCAuLi4gfSxcbiAgICogXSk7XG4gICAqIGBgYFxuICAgKi9cbiAgYXN5bmMgcmVjb3JkQmF0Y2goXG4gICAgYWdlbnRJZDogc3RyaW5nLFxuICAgIG1ldHJpY3M6IFJlY29yZE1ldHJpY09wdGlvbnNbXVxuICApOiBQcm9taXNlPFJlY29yZE1ldHJpY1Jlc3BvbnNlW10+IHtcbiAgICBjb25zdCByZXN1bHRzID0gYXdhaXQgUHJvbWlzZS5hbGwoXG4gICAgICBtZXRyaWNzLm1hcCgobWV0cmljKSA9PiB0aGlzLnJlY29yZChhZ2VudElkLCBtZXRyaWMpKVxuICAgICk7XG4gICAgcmV0dXJuIHJlc3VsdHM7XG4gIH0sXG59O1xuXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG4vLyBIRUxQRVIgRlVOQ1RJT05TXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG5cbi8qKlxuICogQ2hlY2sgaWYgYSBtZXRyaWMgaXMgcmVhZHkgdG8gZGlzcGxheVxuICovXG5leHBvcnQgZnVuY3Rpb24gaXNNZXRyaWNSZWFkeShtZXRyaWM6IEN1cnJlbnRNZXRyaWNSZXNwb25zZSk6IGJvb2xlYW4ge1xuICByZXR1cm4gbWV0cmljLnN0YXR1cyA9PT0gJ3JlYWR5Jztcbn1cblxuLyoqXG4gKiBDaGVjayBpZiBhIG1ldHJpYyBuZWVkcyBtb3JlIHRyYWNlIGRhdGFcbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIG5lZWRzTW9yZVRyYWNlcyhtZXRyaWM6IEN1cnJlbnRNZXRyaWNSZXNwb25zZSk6IGJvb2xlYW4ge1xuICByZXR1cm4gbWV0cmljLnN0YXR1cyA9PT0gJ2luc3VmZmljaWVudF9kYXRhJztcbn1cblxuLyoqXG4gKiBDaGVjayBpZiBhIG1ldHJpYyBpcyB3YWl0aW5nIGZvciBleHRlcm5hbCBkYXRhXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBhd2FpdGluZ0V4dGVybmFsRGF0YShtZXRyaWM6IEN1cnJlbnRNZXRyaWNSZXNwb25zZSk6IGJvb2xlYW4ge1xuICByZXR1cm4gbWV0cmljLnN0YXR1cyA9PT0gJ2F3YWl0aW5nX2V4dGVybmFsJztcbn1cblxuLyoqXG4gKiBDaGVjayBpZiBtZXRyaWMgZGF0YSBpcyBzdGFsZVxuICovXG5leHBvcnQgZnVuY3Rpb24gaXNNZXRyaWNTdGFsZShtZXRyaWM6IEN1cnJlbnRNZXRyaWNSZXNwb25zZSk6IGJvb2xlYW4ge1xuICByZXR1cm4gbWV0cmljLnN0YXR1cyA9PT0gJ3N0YWxlJztcbn1cblxuLyoqXG4gKiBHZXQgaHVtYW4tcmVhZGFibGUgc3RhdHVzIG1lc3NhZ2VcbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGdldFN0YXR1c01lc3NhZ2UobWV0cmljOiBDdXJyZW50TWV0cmljUmVzcG9uc2UpOiBzdHJpbmcge1xuICBzd2l0Y2ggKG1ldHJpYy5zdGF0dXMpIHtcbiAgICBjYXNlICdyZWFkeSc6XG4gICAgICByZXR1cm4gJ01ldHJpYyBpcyB1cCB0byBkYXRlJztcbiAgICBjYXNlICdpbnN1ZmZpY2llbnRfZGF0YSc6XG4gICAgICByZXR1cm4gbWV0cmljLnN0YXR1c01lc3NhZ2UgfHxcbiAgICAgICAgYE5lZWQgJHsobWV0cmljLm1pblRyYWNlVGhyZXNob2xkIHx8IDUwKSAtIChtZXRyaWMudHJhY2VDb3VudCB8fCAwKX0gbW9yZSB0cmFjZXNgO1xuICAgIGNhc2UgJ2F3YWl0aW5nX2V4dGVybmFsJzpcbiAgICAgIHJldHVybiBtZXRyaWMuc3RhdHVzTWVzc2FnZSB8fCAnV2FpdGluZyBmb3IgZXh0ZXJuYWwgZGF0YSBzb3VyY2UnO1xuICAgIGNhc2UgJ3N0YWxlJzpcbiAgICAgIHJldHVybiBtZXRyaWMuc3RhdHVzTWVzc2FnZSB8fCAnRGF0YSBtYXkgYmUgb3V0ZGF0ZWQnO1xuICAgIGRlZmF1bHQ6XG4gICAgICByZXR1cm4gJ1Vua25vd24gc3RhdHVzJztcbiAgfVxufVxuXG4vKipcbiAqIENhbGN1bGF0ZSBwcm9ncmVzcyB0b3dhcmQgbWluaW11bSB0cmFjZSB0aHJlc2hvbGRcbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGdldFRyYWNlUHJvZ3Jlc3MobWV0cmljOiBDdXJyZW50TWV0cmljUmVzcG9uc2UpOiBudW1iZXIge1xuICBpZiAobWV0cmljLnN0YXR1cyAhPT0gJ2luc3VmZmljaWVudF9kYXRhJykgcmV0dXJuIDEwMDtcbiAgcmV0dXJuIG1ldHJpYy5wcm9ncmVzc1BlcmNlbnQgfHwgMDtcbn1cblxuLyoqXG4gKiBGb3JtYXQgbWV0cmljIHZhbHVlIGZvciBkaXNwbGF5IGJhc2VkIG9uIHVuaXRcbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGZvcm1hdE1ldHJpY1ZhbHVlKHZhbHVlOiBudW1iZXIsIHVuaXQ6IHN0cmluZyk6IHN0cmluZyB7XG4gIHN3aXRjaCAodW5pdCkge1xuICAgIGNhc2UgJyUnOlxuICAgICAgcmV0dXJuIGAke01hdGgucm91bmQodmFsdWUgKiAxMCkgLyAxMH0lYDtcbiAgICBjYXNlICckJzpcbiAgICAgIHJldHVybiBuZXcgSW50bC5OdW1iZXJGb3JtYXQoJ2VuLVVTJywge1xuICAgICAgICBzdHlsZTogJ2N1cnJlbmN5JyxcbiAgICAgICAgY3VycmVuY3k6ICdVU0QnLFxuICAgICAgfSkuZm9ybWF0KHZhbHVlKTtcbiAgICBjYXNlICdzJzpcbiAgICAgIHJldHVybiB2YWx1ZSA8IDYwID8gYCR7TWF0aC5yb3VuZCh2YWx1ZSl9c2AgOiBgJHtNYXRoLnJvdW5kKHZhbHVlIC8gNjApfW1gO1xuICAgIGNhc2UgJ2hycyc6XG4gICAgICByZXR1cm4gYCR7TWF0aC5yb3VuZCh2YWx1ZSAqIDEwKSAvIDEwfSBocnNgO1xuICAgIGNhc2UgJ3Njb3JlJzpcbiAgICAgIHJldHVybiB2YWx1ZS50b0ZpeGVkKDEpO1xuICAgIGRlZmF1bHQ6XG4gICAgICByZXR1cm4gU3RyaW5nKE1hdGgucm91bmQodmFsdWUgKiAxMDApIC8gMTAwKTtcbiAgfVxufVxuXG4vKipcbiAqIEdldCB0cmVuZCBkaXJlY3Rpb24gYXMgZW1vamlcbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGdldFRyZW5kRW1vamkodHJlbmQ6IE1ldHJpY1RyZW5kKTogc3RyaW5nIHtcbiAgaWYgKHRyZW5kLmRpcmVjdGlvbiA9PT0gJ3VwJykgcmV0dXJuIHRyZW5kLmlzUG9zaXRpdmUgPyAn8J+TiCcgOiAn8J+TiSc7XG4gIGlmICh0cmVuZC5kaXJlY3Rpb24gPT09ICdkb3duJykgcmV0dXJuIHRyZW5kLmlzUG9zaXRpdmUgPyAn8J+TiCcgOiAn8J+TiSc7XG4gIHJldHVybiAn4p6h77iPJztcbn1cbiJdfQ==

package/dist/api/conversation-eval.d.ts

@@ -0,0 +1,200 @@
+/**
+ * ThinkHive SDK v3.0 - Conversation Evaluation API
+ *
+ * API for multi-turn conversation evaluation
+ */
+export type AggregateMethod = 'worst' | 'average' | 'weighted' | 'final_turn' | 'majority';
+export interface SessionTrace {
+    id: string;
+    sessionId: string;
+    turnNumber: number;
+    userMessage: string;
+    agentResponse: string;
+    timestamp: string;
+    metadata?: Record<string, unknown>;
+}
+export interface TurnEvaluation {
+    traceId: string;
+    turnNumber: number;
+    passed: boolean;
+    score: number;
+    reasoning: string;
+}
+export interface ConversationEvalResult {
+    sessionId: string;
+    criterionId: string;
+    turnCount: number;
+    turnResults: TurnEvaluation[];
+    aggregatePassed: boolean;
+    aggregateScore: number;
+    aggregateMethod: AggregateMethod;
+    reasoning: string;
+    metadata?: Record<string, unknown>;
+}
+export interface EvaluateConversationOptions {
+    sessionId: string;
+    criterionId: string;
+    options?: {
+        aggregateMethod?: AggregateMethod;
+        minTurns?: number;
+        maxTurns?: number;
+    };
+}
+export interface AggregationMethodInfo {
+    id: AggregateMethod;
+    name: string;
+    description: string;
+    useCase: string;
+}
+/**
+ * Conversation Evaluation API client for multi-turn evaluation
+ */
+export declare const conversationEval: {
+    /**
+     * Get traces for a conversation session
+     *
+     * @example
+     * ```typescript
+     * const traces = await conversationEval.getSessionTraces('session_123');
+     * console.log(`Conversation has ${traces.length} turns`);
+     * ```
+     */
+    getSessionTraces(sessionId: string): Promise<SessionTrace[]>;
+    /**
+     * Run conversation-level evaluation
+     *
+     * @example
+     * ```typescript
+     * const result = await conversationEval.evaluate({
+     *   sessionId: 'session_123',
+     *   criterionId: 'criterion_456',
+     *   options: {
+     *     aggregateMethod: 'average',
+     *     minTurns: 2,
+     *   },
+     * });
+     * console.log(`Conversation score: ${result.aggregateScore}`);
+     * ```
+     */
+    evaluate(options: EvaluateConversationOptions): Promise<ConversationEvalResult>;
+    /**
+     * Get available aggregation methods with descriptions
+     *
+     * @example
+     * ```typescript
+     * const methods = await conversationEval.getAggregationMethods();
+     * for (const method of methods) {
+     *   console.log(`${method.name}: ${method.description}`);
+     * }
+     * ```
+     */
+    getAggregationMethods(): Promise<AggregationMethodInfo[]>;
+};
+/**
+ * Calculate worst-turn aggregation
+ *
+ * @param turnResults - Array of turn evaluation results
+ * @returns Aggregated result using worst turn logic
+ *
+ * @example
+ * ```typescript
+ * const result = aggregateWorst(turnResults);
+ * // Fails if any turn fails
+ * ```
+ */
+export declare function aggregateWorst(turnResults: TurnEvaluation[]): {
+    passed: boolean;
+    score: number;
+};
+/**
+ * Calculate average aggregation
+ *
+ * @param turnResults - Array of turn evaluation results
+ * @returns Aggregated result using average logic
+ *
+ * @example
+ * ```typescript
+ * const result = aggregateAverage(turnResults);
+ * ```
+ */
+export declare function aggregateAverage(turnResults: TurnEvaluation[]): {
+    passed: boolean;
+    score: number;
+};
+/**
+ * Calculate weighted average aggregation (later turns weighted more)
+ *
+ * @param turnResults - Array of turn evaluation results
+ * @returns Aggregated result using weighted average logic
+ *
+ * @example
+ * ```typescript
+ * const result = aggregateWeighted(turnResults);
+ * // Later turns have higher weight
+ * ```
+ */
+export declare function aggregateWeighted(turnResults: TurnEvaluation[]): {
+    passed: boolean;
+    score: number;
+};
+/**
+ * Calculate final-turn aggregation
+ *
+ * @param turnResults - Array of turn evaluation results
+ * @returns Aggregated result using only the final turn
+ *
+ * @example
+ * ```typescript
+ * const result = aggregateFinalTurn(turnResults);
+ * // Only final turn matters
+ * ```
+ */
+export declare function aggregateFinalTurn(turnResults: TurnEvaluation[]): {
+    passed: boolean;
+    score: number;
+};
+/**
+ * Calculate majority vote aggregation
+ *
+ * @param turnResults - Array of turn evaluation results
+ * @returns Aggregated result using majority vote logic
+ *
+ * @example
+ * ```typescript
+ * const result = aggregateMajority(turnResults);
+ * // Passes if majority of turns pass
+ * ```
+ */
+export declare function aggregateMajority(turnResults: TurnEvaluation[]): {
+    passed: boolean;
+    score: number;
+};
+/**
+ * Get appropriate aggregation function for a method
+ *
+ * @param method - Aggregation method name
+ * @returns Aggregation function
+ */
+export declare function getAggregator(method: AggregateMethod): (turnResults: TurnEvaluation[]) => {
+    passed: boolean;
+    score: number;
+};
+/**
+ * Find problematic turns in a conversation
+ *
+ * @param result - Conversation evaluation result
+ * @param scoreThreshold - Minimum acceptable score (default 70)
+ * @returns Array of problematic turn results
+ */
+export declare function getProblematicTurns(result: ConversationEvalResult, scoreThreshold?: number): TurnEvaluation[];
+/**
+ * Calculate conversation quality trend
+ *
+ * @param result - Conversation evaluation result
+ * @returns Trend analysis
+ */
+export declare function analyzeConversationTrend(result: ConversationEvalResult): {
+    direction: 'improving' | 'declining' | 'stable';
+    firstHalfAvg: number;
+    secondHalfAvg: number;
+};