@squadrules/mcp 4.8.6

package/dist/services/redis.js

@@ -0,0 +1,272 @@
+/**
+ * Redis Service for KAIROS persistence
+ *
+ * Provides Redis-based persistence for game data and other shared state.
+ * Uses configurable key prefix (default: 'kb:') via KAIROS_REDIS_PREFIX env var for isolation.
+ * Use keyValueStore from key-value-store-factory.js unless you need Redis-specific behavior.
+ */
+import { createClient } from 'redis';
+import { logger } from '../utils/structured-logger.js';
+import { REDIS_URL, KAIROS_REDIS_PREFIX, MEMORY_CACHE_KEY_PREFIX, OIDC_STATE_KEY_PREFIX } from '../config.js';
+import { getSpaceIdFromStorage } from '../utils/tenant-context.js';
+function maskRedisUrl(url) {
+    if (!url)
+        return url;
+    try {
+        const parsed = new URL(url);
+        const authPrefix = parsed.username || parsed.password ? '***@' : '';
+        return `${parsed.protocol}//${authPrefix}${parsed.host}${parsed.pathname}${parsed.search}${parsed.hash}`;
+    }
+    catch {
+        return url.replace(/\/\/([^@/]+)@/, '//***@');
+    }
+}
+export class RedisService {
+    client;
+    prefix;
+    connected = false;
+    redisUrl;
+    maskedRedisUrl;
+    constructor() {
+        const redisUrl = REDIS_URL;
+        this.redisUrl = redisUrl;
+        this.maskedRedisUrl = maskRedisUrl(redisUrl);
+        this.prefix = KAIROS_REDIS_PREFIX;
+        logger.debug(`[RedisService] Initializing with REDIS_URL="${this.maskedRedisUrl}" and KAIROS_REDIS_PREFIX="${this.prefix}"`);
+        this.client = createClient({
+            url: redisUrl
+        });
+        this.client.on('error', (err) => {
+            logger.error('Redis Client Error', err);
+            logger.debug(`[RedisService] Error details: ${err?.message || err} | code=${(err && err.code) || 'n/a'} ` +
+                `errno=${(err && err.errno) || 'n/a'} address=${(err && err.address) || 'n/a'} ` +
+                `port=${(err && err.port) || 'n/a'} target="${this.maskedRedisUrl}"`);
+            // If this is an AggregateError, log each inner error for deep diagnostics
+            const innerErrors = err && typeof err === 'object' && 'errors' in err ? err.errors : undefined;
+            if (Array.isArray(innerErrors) && innerErrors.length > 0) {
+                innerErrors.forEach((inner, index) => {
+                    logger.debug(`[RedisService] Inner error[${index}] code=${inner?.code || 'n/a'} ` +
+                        `errno=${inner?.errno || 'n/a'} address=${inner?.address || 'n/a'} ` +
+                        `port=${inner?.port || 'n/a'} message=${inner?.message || inner}`);
+                });
+            }
+        });
+        this.client.on('connect', () => {
+            logger.info('Connecting to Redis...');
+            logger.debug(`[RedisService] Attempting connection to ${this.maskedRedisUrl}`);
+        });
+        this.client.on('ready', () => {
+            logger.info('Redis client ready');
+            logger.debug('[RedisService] Redis client is ready and operational');
+            this.connected = true;
+        });
+        this.client.on('end', () => {
+            logger.info('Redis connection closed');
+            logger.debug('[RedisService] Redis connection ended');
+            this.connected = false;
+        });
+    }
+    async connect() {
+        if (!this.connected) {
+            logger.info(`[RedisService] connect() called, attempting connection to "${this.maskedRedisUrl}"`);
+            try {
+                await this.client.connect();
+            }
+            catch (error) {
+                logger.error(`[RedisService] connect() failed for "${this.maskedRedisUrl}"`, error);
+                throw error;
+            }
+        }
+    }
+    async disconnect() {
+        if (this.connected) {
+            await this.client.quit();
+        }
+    }
+    /** Key is namespaced by current space (AsyncLocalStorage) so cache and proof-of-work do not collide across spaces. Memory cache keys (mem:*) and OIDC state keys (oidc-state:*) are global. */
+    getKey(key) {
+        if (key.startsWith(MEMORY_CACHE_KEY_PREFIX) || key.startsWith(OIDC_STATE_KEY_PREFIX)) {
+            return `${this.prefix}${key}`;
+        }
+        const spaceId = getSpaceIdFromStorage();
+        return `${this.prefix}${spaceId}:${key}`;
+    }
+    async get(key) {
+        try {
+            return await this.client.get(this.getKey(key));
+        }
+        catch (error) {
+            logger.error(`Redis GET error for key ${key}:`, error);
+            return null;
+        }
+    }
+    async getdel(key) {
+        try {
+            return await this.client.getDel(this.getKey(key));
+        }
+        catch (error) {
+            logger.error(`Redis GETDEL error for key ${key}:`, error);
+            return null;
+        }
+    }
+    async set(key, value, ttl) {
+        try {
+            if (ttl) {
+                await this.client.setEx(this.getKey(key), ttl, value);
+            }
+            else {
+                await this.client.set(this.getKey(key), value);
+            }
+        }
+        catch (error) {
+            logger.error(`Redis SET error for key ${key}:`, error);
+        }
+    }
+    async del(key) {
+        try {
+            await this.client.del(this.getKey(key));
+        }
+        catch (error) {
+            logger.error(`Redis DEL error for key ${key}:`, error);
+        }
+    }
+    async hget(hash, field) {
+        try {
+            return await this.client.hGet(this.getKey(hash), field);
+        }
+        catch (error) {
+            logger.error(`Redis HGET error for hash ${hash} field ${field}:`, error);
+            return null;
+        }
+    }
+    async hset(hash, field, value) {
+        try {
+            await this.client.hSet(this.getKey(hash), field, value);
+        }
+        catch (error) {
+            logger.error(`Redis HSET error for hash ${hash} field ${field}:`, error);
+        }
+    }
+    async hgetall(hash) {
+        try {
+            return await this.client.hGetAll(this.getKey(hash));
+        }
+        catch (error) {
+            logger.error(`Redis HGETALL error for hash ${hash}:`, error);
+            return null;
+        }
+    }
+    async hsetall(hash, data) {
+        try {
+            await this.client.hSet(this.getKey(hash), data);
+        }
+        catch (error) {
+            logger.error(`Redis HSETALL error for hash ${hash}:`, error);
+        }
+    }
+    async incr(key) {
+        try {
+            return await this.client.incr(this.getKey(key));
+        }
+        catch (error) {
+            logger.error(`Redis INCR error for key ${key}:`, error);
+            return 0;
+        }
+    }
+    async exists(key) {
+        try {
+            const result = await this.client.exists(this.getKey(key));
+            return result === 1;
+        }
+        catch (error) {
+            logger.error(`Redis EXISTS error for key ${key}:`, error);
+            return false;
+        }
+    }
+    async keys(pattern) {
+        try {
+            return await this.client.keys(this.getKey(pattern));
+        }
+        catch (error) {
+            logger.error(`Redis KEYS error for pattern ${pattern}:`, error);
+            return [];
+        }
+    }
+    /**
+     * Publish a message to a Redis channel (pub/sub)
+     * Note: Channel names are NOT prefixed to allow cross-instance communication
+     * @param channel Channel name to publish to
+     * @param message Message to publish
+     * @returns Number of subscribers that received the message
+     */
+    async publish(channel, message) {
+        try {
+            const result = await this.client.publish(channel, message);
+            logger.debug(`[RedisService] Published message to channel "${channel}", ${result} subscribers notified`);
+            return result;
+        }
+        catch (error) {
+            logger.error(`Redis PUBLISH error for channel ${channel}:`, error);
+            return 0;
+        }
+    }
+    // Utility methods for JSON objects
+    async getJson(key) {
+        const value = await this.get(key);
+        if (!value)
+            return null;
+        try {
+            return JSON.parse(value);
+        }
+        catch (error) {
+            logger.error(`JSON parse error for key ${key}:`, error);
+            return null;
+        }
+    }
+    async getdelJson(key) {
+        const value = await this.getdel(key);
+        if (!value)
+            return null;
+        try {
+            return JSON.parse(value);
+        }
+        catch (error) {
+            logger.error(`JSON parse error for key ${key}:`, error);
+            return null;
+        }
+    }
+    async setJson(key, value, ttl) {
+        try {
+            const jsonValue = JSON.stringify(value);
+            await this.set(key, jsonValue, ttl);
+        }
+        catch (error) {
+            logger.error(`JSON stringify error for key ${key}:`, error);
+        }
+    }
+    async hgetJson(hash, field) {
+        const value = await this.hget(hash, field);
+        if (!value)
+            return null;
+        try {
+            return JSON.parse(value);
+        }
+        catch (error) {
+            logger.error(`JSON parse error for hash ${hash} field ${field}:`, error);
+            return null;
+        }
+    }
+    async hsetJson(hash, field, value) {
+        try {
+            const jsonValue = JSON.stringify(value);
+            await this.hset(hash, field, jsonValue);
+        }
+        catch (error) {
+            logger.error(`JSON stringify error for hash ${hash} field ${field}:`, error);
+        }
+    }
+    isConnected() {
+        return this.connected;
+    }
+}
+//# sourceMappingURL=redis.js.map

package/dist/services/redis.js.map

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

package/dist/services/reward-evals.d.ts

@@ -0,0 +1,29 @@
+import type { RewardRecord } from '../types/memory.js';
+export type RewardGraderKind = 'human' | 'model' | 'unknown';
+export type RewardEvaluationLabel = 'gold' | 'silver' | 'bronze' | 'rejected';
+export type RewardEligibilityBlocker = 'missing_rubric_version' | 'missing_evaluator_identity' | 'outcome_not_success' | 'score_below_sft_threshold' | 'score_below_preference_threshold';
+export interface RewardEligibility {
+    eligible: boolean;
+    blockers: RewardEligibilityBlocker[];
+}
+export interface RewardEvaluation {
+    normalizedScore: number;
+    signedScore: number;
+    qualityBonus: number;
+    label: RewardEvaluationLabel;
+    graderKind: RewardGraderKind;
+    sftEligibility: RewardEligibility;
+    preferenceEligibility: RewardEligibility;
+    exportableForSft: boolean;
+    exportableForPreference: boolean;
+}
+export declare function evaluateReward(params: {
+    outcome: 'success' | 'failure';
+    score?: number;
+    rater?: string;
+    rubricVersion?: string;
+    llmModelId?: string;
+}): RewardEvaluation;
+export declare function isRewardEligibleForSft(reward?: RewardRecord | null): boolean;
+export declare function isRewardEligibleForPreference(reward?: RewardRecord | null): boolean;
+//# sourceMappingURL=reward-evals.d.ts.map

package/dist/services/reward-evals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reward-evals.d.ts","sourceRoot":"","sources":["../../src/services/reward-evals.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;AAC7D,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;AAC9E,MAAM,MAAM,wBAAwB,GAChC,wBAAwB,GACxB,4BAA4B,GAC5B,qBAAqB,GACrB,2BAA2B,GAC3B,kCAAkC,CAAC;AAEvC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,wBAAwB,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,gBAAgB;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,qBAAqB,CAAC;IAC7B,UAAU,EAAE,gBAAgB,CAAC;IAC7B,cAAc,EAAE,iBAAiB,CAAC;IAClC,qBAAqB,EAAE,iBAAiB,CAAC;IACzC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,uBAAuB,EAAE,OAAO,CAAC;CAClC;AA8ED,wBAAgB,cAAc,CAAC,MAAM,EAAE;IACrC,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,gBAAgB,CAoCnB;AAED,wBAAgB,sBAAsB,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,GAAG,OAAO,CAQ5E;AAED,wBAAgB,6BAA6B,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,GAAG,OAAO,CAQnF"}

package/dist/services/reward-evals.js

@@ -0,0 +1,116 @@
+const DEFAULT_SUCCESS_SCORE = 1;
+const DEFAULT_FAILURE_SCORE = 0;
+const MIN_SFT_SCORE = 0.65;
+const MIN_PREFERENCE_SCORE = 0.7;
+function clampScore(value) {
+    if (!Number.isFinite(value)) {
+        return 0;
+    }
+    return Math.max(0, Math.min(1, value));
+}
+function inferGraderKind(params) {
+    if (params.llmModelId) {
+        return 'model';
+    }
+    if (params.rater) {
+        return 'human';
+    }
+    return 'unknown';
+}
+function hasEvaluatorIdentity(params) {
+    return Boolean(params.rater?.trim() || params.llmModelId?.trim());
+}
+function buildEligibility(params) {
+    const sharedBlockers = [];
+    if (!params.rubricVersion?.trim()) {
+        sharedBlockers.push('missing_rubric_version');
+    }
+    if (!hasEvaluatorIdentity(params)) {
+        sharedBlockers.push('missing_evaluator_identity');
+    }
+    const sftBlockers = [...sharedBlockers];
+    if (params.outcome !== 'success') {
+        sftBlockers.push('outcome_not_success');
+    }
+    if (params.normalizedScore < MIN_SFT_SCORE) {
+        sftBlockers.push('score_below_sft_threshold');
+    }
+    const preferenceBlockers = [...sharedBlockers];
+    if (params.normalizedScore < MIN_PREFERENCE_SCORE) {
+        preferenceBlockers.push('score_below_preference_threshold');
+    }
+    return {
+        sftEligibility: {
+            eligible: sftBlockers.length === 0,
+            blockers: sftBlockers
+        },
+        preferenceEligibility: {
+            eligible: preferenceBlockers.length === 0,
+            blockers: preferenceBlockers
+        }
+    };
+}
+function evaluateRewardRecord(reward) {
+    return evaluateReward({
+        outcome: reward.outcome,
+        ...(reward.score !== undefined ? { score: reward.score } : {}),
+        ...(reward.rater !== undefined ? { rater: reward.rater } : {}),
+        ...(reward.rubric_version !== undefined ? { rubricVersion: reward.rubric_version } : {}),
+        ...(reward.llm_model_id !== undefined ? { llmModelId: reward.llm_model_id } : {})
+    });
+}
+export function evaluateReward(params) {
+    const normalizedScore = clampScore(params.score ?? (params.outcome === 'success' ? DEFAULT_SUCCESS_SCORE : DEFAULT_FAILURE_SCORE));
+    const signedScore = params.outcome === 'success' ? normalizedScore : -normalizedScore;
+    const qualityBonus = signedScore;
+    const { sftEligibility, preferenceEligibility } = buildEligibility({
+        outcome: params.outcome,
+        normalizedScore,
+        ...(params.rater !== undefined ? { rater: params.rater } : {}),
+        ...(params.rubricVersion !== undefined ? { rubricVersion: params.rubricVersion } : {}),
+        ...(params.llmModelId !== undefined ? { llmModelId: params.llmModelId } : {})
+    });
+    let label;
+    if (params.outcome === 'failure') {
+        label = 'rejected';
+    }
+    else if (normalizedScore >= 0.85) {
+        label = 'gold';
+    }
+    else if (normalizedScore >= MIN_SFT_SCORE) {
+        label = 'silver';
+    }
+    else {
+        label = 'bronze';
+    }
+    return {
+        normalizedScore,
+        signedScore,
+        qualityBonus,
+        label,
+        graderKind: inferGraderKind(params),
+        sftEligibility,
+        preferenceEligibility,
+        exportableForSft: sftEligibility.eligible,
+        exportableForPreference: preferenceEligibility.eligible
+    };
+}
+export function isRewardEligibleForSft(reward) {
+    if (!reward) {
+        return false;
+    }
+    if (reward.exportable_for_sft !== undefined) {
+        return reward.exportable_for_sft === true;
+    }
+    return evaluateRewardRecord(reward).exportableForSft;
+}
+export function isRewardEligibleForPreference(reward) {
+    if (!reward) {
+        return false;
+    }
+    if (reward.exportable_for_preference !== undefined) {
+        return reward.exportable_for_preference === true;
+    }
+    return evaluateRewardRecord(reward).exportableForPreference;
+}
+//# sourceMappingURL=reward-evals.js.map

package/dist/services/reward-evals.js.map

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

package/dist/services/reward-metrics.d.ts

@@ -0,0 +1,20 @@
+import type { QdrantService } from './qdrant/service.js';
+export interface RewardMetricsResult {
+    results: Array<{
+        uri: string;
+        outcome: 'success' | 'failure';
+        quality_bonus: number;
+        feedback?: string;
+        rated_at: string;
+    }>;
+    total_rated: number;
+    total_failed: number;
+}
+export declare function applyRewardMetrics(qdrantService: QdrantService, input: {
+    uri: string;
+    outcome: 'success' | 'failure';
+    feedback?: string;
+    qualityBonus?: number;
+    evaluatorId?: string;
+}): Promise<RewardMetricsResult>;
+//# sourceMappingURL=reward-metrics.d.ts.map

package/dist/services/reward-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reward-metrics.d.ts","sourceRoot":"","sources":["../../src/services/reward-metrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAOzD,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,KAAK,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC;QAC/B,aAAa,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,kBAAkB,CACtC,aAAa,EAAE,aAAa,EAC5B,KAAK,EAAE;IACL,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GACA,OAAO,CAAC,mBAAmB,CAAC,CA0F9B"}

package/dist/services/reward-metrics.js

@@ -0,0 +1,72 @@
+import { redisCacheService } from './redis-cache.js';
+import { IDGenerator } from './id-generator.js';
+import { modelStats } from './stats/model-stats.js';
+import { logger } from '../utils/structured-logger.js';
+import { KairosError } from '../types/index.js';
+export async function applyRewardMetrics(qdrantService, input) {
+    const { uri, outcome, feedback, qualityBonus = 0, evaluatorId } = input;
+    const modelIdentity = {
+        modelId: evaluatorId || 'reward',
+        provider: 'unknown',
+        family: 'unknown'
+    };
+    const uris = [uri];
+    const results = [];
+    let totalRated = 0;
+    logger.tool('reward', 'rate', `single rating of ${uri} with outcome="${outcome}" model="${modelIdentity.modelId}"`);
+    for (const currentUri of uris) {
+        try {
+            const qdrantUuid = IDGenerator.qdrantIdFromUri(currentUri);
+            const basicQualityBonus = outcome === 'success' ? 1 : -0.2;
+            const currentPoint = await qdrantService.retrieveById(qdrantUuid);
+            const currentMetrics = currentPoint?.payload?.quality_metrics || {};
+            const implementationBonus = await modelStats.calculateImplementationBonus(currentMetrics, modelIdentity.modelId, outcome);
+            const totalQualityBonus = basicQualityBonus + implementationBonus + qualityBonus;
+            const metricsUpdate = {
+                retrievalCount: 1,
+                successCount: outcome === 'success' ? 1 : 0,
+                failureCount: outcome === 'failure' ? 1 : 0,
+                lastRated: new Date().toISOString(),
+                lastRater: modelIdentity.modelId,
+                qualityBonus: totalQualityBonus
+            };
+            if (feedback) {
+                metricsUpdate['usageContext'] = feedback;
+            }
+            await qdrantService.updateQualityMetrics(qdrantUuid, metricsUpdate);
+            await qdrantService.propagateRewardToAdapterHead(qdrantUuid, metricsUpdate);
+            await redisCacheService.invalidateBeginCache();
+            if (currentPoint?.payload) {
+                const { label, domain, task, type, tags } = currentPoint.payload;
+                const updatedQualityMetadata = modelStats.calculateStepQualityMetadata(label || 'Knowledge step', domain || 'general', task || 'general', type || 'context', tags || [], outcome);
+                await qdrantService.updateQualityMetadata(qdrantUuid, {
+                    step_quality_score: updatedQualityMetadata.step_quality_score,
+                    step_quality: updatedQualityMetadata.step_quality
+                });
+                logger.info(`reward: Updated quality metadata for ${currentUri} with execution ${outcome} - score: ${updatedQualityMetadata.step_quality_score} (${updatedQualityMetadata.step_quality})`);
+            }
+            await modelStats.processQualityFeedback(modelIdentity.modelId, currentUri, outcome, totalQualityBonus);
+            if (implementationBonus > 0) {
+                await modelStats.updateImplementationBonus(modelIdentity.modelId, implementationBonus);
+            }
+            results.push({
+                uri: currentUri,
+                outcome,
+                quality_bonus: totalQualityBonus,
+                ...(feedback ? { feedback } : {}),
+                rated_at: new Date().toISOString()
+            });
+            totalRated++;
+            logger.success('reward', `rated ${currentUri} with ${outcome} (${totalQualityBonus} bonus)`);
+        }
+        catch (error) {
+            logger.error(`reward failed for ${currentUri}`, error);
+            if (error instanceof KairosError) {
+                throw error;
+            }
+            throw new Error(`Failed to persist reward metrics for ${currentUri}. No reward was stored.`, { cause: error instanceof Error ? error : undefined });
+        }
+    }
+    return { results, total_rated: totalRated, total_failed: 0 };
+}
+//# sourceMappingURL=reward-metrics.js.map

package/dist/services/reward-metrics.js.map

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

package/dist/services/stats/bonuses.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Implementation bonus core algorithms (statistical adjustments, rarity/comparative)
+ * These functions are pure/near-pure and operate on supplied data structures so the
+ * orchestrator can handle persistence and state mutation.
+ */
+import type { ModelImplementationData } from '../../types/index.js';
+export declare function calculateWilsonAdjustment(modelData: ModelImplementationData): number;
+/**
+ * Compute implementation bonus given a qualityMetrics object.
+ *
+ * This function mutates qualityMetrics to record attempts/successes for the specific model.
+ * It returns an object describing the awarded bonus and whether a "rare success" occurred.
+ *
+ * Parameters:
+ * - qualityMetrics: the QualityMetrics object from memory payload (may be created by caller)
+ * - llm_model_id: model identifier
+ * - outcome: 'success' | 'partial' | 'failure'
+ *
+ * Returns:
+ * { finalBonus, comparativeBonus, rarityMultiplier, rareSuccess }
+ */
+export declare function computeImplementationBonus(qualityMetrics: any, llm_model_id: string, outcome: 'success' | 'partial' | 'failure'): {
+    finalBonus: number;
+    comparativeBonus: number;
+    rarityMultiplier: number;
+    rareSuccess: boolean;
+};
+//# sourceMappingURL=bonuses.d.ts.map

package/dist/services/stats/bonuses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bonuses.d.ts","sourceRoot":"","sources":["../../../src/services/stats/bonuses.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAEpE,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,uBAAuB,GAAG,MAAM,CAWpF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,0BAA0B,CACtC,cAAc,EAAE,GAAG,EACnB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAC3C;IACC,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,OAAO,CAAC;CACxB,CA0EA"}