@resolveio/server-lib 22.2.34 → 22.2.36

package/managers/openai-usage-ledger.manager.d.ts

@@ -0,0 +1,15 @@
+export interface OpenAIUsageRecordInput {
+    id_client?: string;
+    model: string;
+    input_tokens: number;
+    cached_input_tokens?: number;
+    output_tokens: number;
+    total_tokens: number;
+    billable?: boolean;
+    category?: string;
+    id_request?: string;
+    id_conversation?: string;
+    timestamp?: Date;
+    cost_estimate?: number;
+}
+export declare function recordOpenAIUsage(input: OpenAIUsageRecordInput): Promise<void>;

package/managers/openai-usage-ledger.manager.js

@@ -0,0 +1,144 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.recordOpenAIUsage = recordOpenAIUsage;
+var common_1 = require("../util/common");
+var resolveio_server_app_1 = require("../resolveio-server-app");
+var openai_usage_ledger_collection_1 = require("../collections/openai-usage-ledger.collection");
+var toNumber = function (value) {
+    var parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : 0;
+};
+var normalizeModelKey = function (value) {
+    return String(value || '').trim().toLowerCase();
+};
+var parsePricingJson = function (raw) {
+    if (!raw) {
+        return {};
+    }
+    try {
+        var parsed_1 = JSON.parse(raw);
+        if (!parsed_1 || typeof parsed_1 !== 'object') {
+            return {};
+        }
+        var out_1 = {};
+        Object.keys(parsed_1).forEach(function (key) {
+            var _a, _b, _c, _d, _e, _f;
+            var entry = parsed_1[key] || {};
+            var inputPer1k = toNumber((_c = (_b = (_a = entry.inputPer1k) !== null && _a !== void 0 ? _a : entry.input) !== null && _b !== void 0 ? _b : entry.prompt) !== null && _c !== void 0 ? _c : 0);
+            var outputPer1k = toNumber((_f = (_e = (_d = entry.outputPer1k) !== null && _d !== void 0 ? _d : entry.output) !== null && _e !== void 0 ? _e : entry.completion) !== null && _f !== void 0 ? _f : 0);
+            if (inputPer1k || outputPer1k) {
+                out_1[normalizeModelKey(key)] = { inputPer1k: inputPer1k, outputPer1k: outputPer1k };
+            }
+        });
+        return out_1;
+    }
+    catch (_a) {
+        return {};
+    }
+};
+var resolvePricingConfig = function () {
+    var _a, _b, _c, _d, _e, _f;
+    var config = resolveio_server_app_1.ResolveIOServer.getServerConfig() || {};
+    var rawJson = String((_b = (_a = config['OPENAI_MODEL_PRICING']) !== null && _a !== void 0 ? _a : process.env.OPENAI_MODEL_PRICING) !== null && _b !== void 0 ? _b : '').trim();
+    var defaultInput = toNumber((_d = (_c = config['OPENAI_COST_PER_1K_INPUT_TOKENS']) !== null && _c !== void 0 ? _c : process.env.OPENAI_COST_PER_1K_INPUT_TOKENS) !== null && _d !== void 0 ? _d : 0);
+    var defaultOutput = toNumber((_f = (_e = config['OPENAI_COST_PER_1K_OUTPUT_TOKENS']) !== null && _e !== void 0 ? _e : process.env.OPENAI_COST_PER_1K_OUTPUT_TOKENS) !== null && _f !== void 0 ? _f : 0);
+    return {
+        perModel: parsePricingJson(rawJson),
+        defaultPricing: { inputPer1k: defaultInput, outputPer1k: defaultOutput }
+    };
+};
+var estimateCost = function (model, inputTokens, outputTokens, cachedInputTokens) {
+    if (cachedInputTokens === void 0) { cachedInputTokens = 0; }
+    var _a = resolvePricingConfig(), perModel = _a.perModel, defaultPricing = _a.defaultPricing;
+    var normalizedModel = normalizeModelKey(model);
+    var pricing = perModel[normalizedModel] || defaultPricing;
+    if (!pricing.inputPer1k && !pricing.outputPer1k) {
+        return 0;
+    }
+    // Cached prompt tokens are typically discounted or free; only uncached input should use full input pricing.
+    var uncachedInputTokens = Math.max(0, toNumber(inputTokens) - toNumber(cachedInputTokens));
+    var inputCost = (uncachedInputTokens / 1000) * pricing.inputPer1k;
+    var outputCost = (toNumber(outputTokens) / 1000) * pricing.outputPer1k;
+    return (0, common_1.round)(inputCost + outputCost, 6);
+};
+function recordOpenAIUsage(input) {
+    return __awaiter(this, void 0, void 0, function () {
+        var idClient, inputTokens, cachedInputTokens, outputTokens, totalTokens, model, normalizedInputCostEstimate, costEstimate;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    if (!input) {
+                        return [2 /*return*/];
+                    }
+                    idClient = String(input.id_client || '').trim();
+                    inputTokens = toNumber(input.input_tokens);
+                    cachedInputTokens = toNumber(input.cached_input_tokens);
+                    outputTokens = toNumber(input.output_tokens);
+                    totalTokens = toNumber(input.total_tokens);
+                    if (!totalTokens && (!inputTokens && !outputTokens)) {
+                        return [2 /*return*/];
+                    }
+                    model = String(input.model || '').trim() || 'unknown';
+                    normalizedInputCostEstimate = toNumber(input.cost_estimate);
+                    costEstimate = normalizedInputCostEstimate > 0
+                        ? normalizedInputCostEstimate
+                        : estimateCost(model, inputTokens, outputTokens, cachedInputTokens);
+                    return [4 /*yield*/, openai_usage_ledger_collection_1.OpenAIUsageLedger.insertOne({
+                            id_client: idClient,
+                            timestamp: input.timestamp || new Date(),
+                            model: model,
+                            input_tokens: inputTokens,
+                            cached_input_tokens: cachedInputTokens,
+                            output_tokens: outputTokens,
+                            total_tokens: totalTokens || (inputTokens + outputTokens),
+                            cost_estimate: costEstimate,
+                            billable: input.billable !== false,
+                            category: input.category || '',
+                            id_request: input.id_request || '',
+                            id_conversation: input.id_conversation || ''
+                        })];
+                case 1:
+                    _a.sent();
+                    return [2 /*return*/];
+            }
+        });
+    });
+}
+
+//# sourceMappingURL=openai-usage-ledger.manager.js.map

package/managers/openai-usage-ledger.manager.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/managers/openai-usage-ledger.manager.ts"],"names":[],"mappings":"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","file":"openai-usage-ledger.manager.js","sourcesContent":["import { round } from '../util/common';\nimport { ResolveIOServer } from '../resolveio-server-app';\nimport { OpenAIUsageLedger } from '../collections/openai-usage-ledger.collection';\n\nexport interface OpenAIUsageRecordInput {\n\tid_client?: string;\n\tmodel: string;\n\tinput_tokens: number;\n\tcached_input_tokens?: number;\n\toutput_tokens: number;\n\ttotal_tokens: number;\n\tbillable?: boolean;\n\tcategory?: string;\n\tid_request?: string;\n\tid_conversation?: string;\n\ttimestamp?: Date;\n\tcost_estimate?: number;\n}\n\ntype PricingConfig = {\n\tinputPer1k: number;\n\toutputPer1k: number;\n};\n\nconst toNumber = (value: any): number => {\n\tconst parsed = Number(value);\n\treturn Number.isFinite(parsed) ? parsed : 0;\n};\n\nconst normalizeModelKey = (value: string): string => {\n\treturn String(value || '').trim().toLowerCase();\n};\n\nconst parsePricingJson = (raw: string): Record<string, PricingConfig> => {\n\tif (!raw) {\n\t\treturn {};\n\t}\n\ttry {\n\t\tconst parsed = JSON.parse(raw);\n\t\tif (!parsed || typeof parsed !== 'object') {\n\t\t\treturn {};\n\t\t}\n\t\tconst out: Record<string, PricingConfig> = {};\n\t\tObject.keys(parsed).forEach((key) => {\n\t\t\tconst entry = parsed[key] || {};\n\t\t\tconst inputPer1k = toNumber(entry.inputPer1k ?? entry.input ?? entry.prompt ?? 0);\n\t\t\tconst outputPer1k = toNumber(entry.outputPer1k ?? entry.output ?? entry.completion ?? 0);\n\t\t\tif (inputPer1k || outputPer1k) {\n\t\t\t\tout[normalizeModelKey(key)] = { inputPer1k, outputPer1k };\n\t\t\t}\n\t\t});\n\t\treturn out;\n\t}\n\tcatch {\n\t\treturn {};\n\t}\n};\n\nconst resolvePricingConfig = (): { perModel: Record<string, PricingConfig>; defaultPricing: PricingConfig } => {\n\tconst config = ResolveIOServer.getServerConfig() || {};\n\tconst rawJson = String(config['OPENAI_MODEL_PRICING'] ?? process.env.OPENAI_MODEL_PRICING ?? '').trim();\n\tconst defaultInput = toNumber(config['OPENAI_COST_PER_1K_INPUT_TOKENS'] ?? process.env.OPENAI_COST_PER_1K_INPUT_TOKENS ?? 0);\n\tconst defaultOutput = toNumber(config['OPENAI_COST_PER_1K_OUTPUT_TOKENS'] ?? process.env.OPENAI_COST_PER_1K_OUTPUT_TOKENS ?? 0);\n\treturn {\n\t\tperModel: parsePricingJson(rawJson),\n\t\tdefaultPricing: { inputPer1k: defaultInput, outputPer1k: defaultOutput }\n\t};\n};\n\nconst estimateCost = (model: string, inputTokens: number, outputTokens: number, cachedInputTokens = 0): number => {\n\tconst { perModel, defaultPricing } = resolvePricingConfig();\n\tconst normalizedModel = normalizeModelKey(model);\n\tconst pricing = perModel[normalizedModel] || defaultPricing;\n\tif (!pricing.inputPer1k && !pricing.outputPer1k) {\n\t\treturn 0;\n\t}\n\t// Cached prompt tokens are typically discounted or free; only uncached input should use full input pricing.\n\tconst uncachedInputTokens = Math.max(0, toNumber(inputTokens) - toNumber(cachedInputTokens));\n\tconst inputCost = (uncachedInputTokens / 1000) * pricing.inputPer1k;\n\tconst outputCost = (toNumber(outputTokens) / 1000) * pricing.outputPer1k;\n\treturn round(inputCost + outputCost, 6);\n};\n\nexport async function recordOpenAIUsage(input: OpenAIUsageRecordInput): Promise<void> {\n\tif (!input) {\n\t\treturn;\n\t}\n\tconst idClient = String(input.id_client || '').trim();\n\tconst inputTokens = toNumber(input.input_tokens);\n\tconst cachedInputTokens = toNumber(input.cached_input_tokens);\n\tconst outputTokens = toNumber(input.output_tokens);\n\tconst totalTokens = toNumber(input.total_tokens);\n\tif (!totalTokens && (!inputTokens && !outputTokens)) {\n\t\treturn;\n\t}\n\tconst model = String(input.model || '').trim() || 'unknown';\n\tconst normalizedInputCostEstimate = toNumber(input.cost_estimate);\n\tconst costEstimate = normalizedInputCostEstimate > 0\n\t\t? normalizedInputCostEstimate\n\t\t: estimateCost(model, inputTokens, outputTokens, cachedInputTokens);\n\n\tawait OpenAIUsageLedger.insertOne({\n\t\tid_client: idClient,\n\t\ttimestamp: input.timestamp || new Date(),\n\t\tmodel,\n\t\tinput_tokens: inputTokens,\n\t\tcached_input_tokens: cachedInputTokens,\n\t\toutput_tokens: outputTokens,\n\t\ttotal_tokens: totalTokens || (inputTokens + outputTokens),\n\t\tcost_estimate: costEstimate,\n\t\tbillable: input.billable !== false,\n\t\tcategory: input.category || '',\n\t\tid_request: input.id_request || '',\n\t\tid_conversation: input.id_conversation || ''\n\t});\n}\n"]}

package/managers/slow-query-verifier.manager.d.ts

@@ -0,0 +1,144 @@
+type SlowQueryExecutionOverride = Record<string, any>;
+type SlowQueryLogModel = Record<string, any>;
+export interface TokenEligibilityResult {
+    eligible: boolean;
+    reason?: string;
+}
+export type CheckAICoderTokenEligibilityFn = Function;
+export interface SlowQueryVerifierDependencies {
+    ClientDBs?: any;
+    Clients?: any;
+    SlowQueryLogs: any;
+    AICoderApps?: any;
+    AIDashboardJobs?: any;
+    checkAICoderTokenEligibility?: CheckAICoderTokenEligibilityFn;
+}
+export declare function registerSlowQueryVerifierDependencies(dependencies: SlowQueryVerifierDependencies): void;
+interface ExplainStageSummary {
+    stage: string;
+    path: string;
+    executionTimeMs?: number;
+    docsExamined?: number;
+    keysExamined?: number;
+    nReturned?: number;
+}
+export declare function ensureSlowQueryVerifier(serverConfig?: any): SlowQueryVerifier | null;
+interface ExplainResult {
+    durationMs: number;
+    explainPlan: Record<string, any>;
+    explainStats: Record<string, any>;
+    stageSummaries: ExplainStageSummary[];
+}
+export declare class SlowQueryVerifier {
+    private readonly _timer?;
+    private readonly config;
+    private readonly autoOptimizeInFlight;
+    private readonly autoOptimizeDependenciesAvailable;
+    private static readonly APP_SETTINGS_CACHE_TTL_MS;
+    private appSettingsAutoOptimizeCacheExpiresAt;
+    private appSettingsAutoOptimizeCacheValue;
+    constructor(serverConfig?: any, dependencies?: Partial<SlowQueryVerifierDependencies>);
+    private static resolveConfig;
+    private parseBooleanEnv;
+    private resolveAutoOptimizeEnabled;
+    private poll;
+    private processCandidate;
+    generateExplainForLog(logId: string): Promise<void>;
+    runLog(logId: string, options?: {
+        force?: boolean;
+    }): Promise<{
+        status: 'in_progress' | 'success' | 'failed' | 'updated' | 'not_found';
+        reason?: string;
+        log?: SlowQueryLogModel;
+    }>;
+    queueLogRun(logId: string, options?: {
+        force?: boolean;
+    }): Promise<{
+        status: 'in_progress' | 'not_found' | 'failed';
+        reason?: string;
+        log?: SlowQueryLogModel;
+    }>;
+    deployLog(logId: string): Promise<{
+        status: 'success' | 'failed' | 'not_found';
+        reason?: string;
+        log?: SlowQueryLogModel;
+    }>;
+    private runLogWithRetries;
+    private shouldRetryForOutputMismatch;
+    private runExplain;
+    measureQuery(log: SlowQueryLogModel, overrides?: SlowQueryExecutionOverride): Promise<ExplainResult>;
+    private handleExplainResult;
+    private handleExplainError;
+    private assignSlowQueryCounter;
+    private scheduleAutoOptimization;
+    private runAutoOptimizationInBackground;
+    private escapeRegex;
+    private getEscalationRecipients;
+    private sendSlowQueryEscalationNotice;
+    private resolveSlowQueryClientTarget;
+    private buildLocalInternalUserCriteria;
+    private buildLocalAdminUserCriteria;
+    private resolveLocalNotificationUserIds;
+    private isGeneratedAICoderClient;
+    private buildAICoderSlowQuerySummary;
+    private buildResolveIOProjectSlowQueryDetails;
+    private notifyCustomerSlowQueryStatus;
+    private parseDate;
+    private resolveFingerprintScopeKey;
+    private buildFingerprintMatchQuery;
+    private countAttemptsWithinWindow;
+    private resolveFingerprintAttemptsInWindow;
+    private resolveCooldownDeadline;
+    private markAutoOptimizeCooldownActive;
+    private markAutoOptimizeTokenIneligible;
+    private markAutoOptimizeBudgetExceeded;
+    private maybeStopAutoOptimizeAfterFailure;
+    private shouldFallbackDashboardMethod;
+    private createDashboardJob;
+    private waitForDashboardJobStop;
+    private isDashboardJobRunning;
+    private publishDashboardJob;
+    private evaluateDashboardPublishOutcome;
+    private resolveBaselineDurationMs;
+    private static collectMetricValues;
+    private static asNonNegativeNumber;
+    private static maxNumber;
+    private static sortStageSummaries;
+    private static collectExecutionTreeStages;
+    private static extractStageSummaries;
+    private resolveExecutionMetrics;
+    private evaluateOptimizationOutcome;
+    private formatStageSummaryForPrompt;
+    private buildSlowQueryAutoOptimizeDescription;
+    private resolveAutoOptimizeRepoSlug;
+    private resolveAutoOptimizeRepoPath;
+    private static queryHasExplicitSort;
+    private static countLookupExprInPattern;
+    private static buildBoundedPipelineForOutputCompare;
+    private static buildBoundedFindOptionsForOutputCompare;
+    private static normalizeOutputValue;
+    private static digestOutputDocument;
+    private captureOutputFingerprint;
+    private compareOutputEquivalence;
+    private resolveAutoOptimizeApp;
+    private runAutoOptimization;
+    private resolveClientDB;
+    private resolveExplainTarget;
+    private static extractPipelineFromLog;
+    private static applyQueryOverrides;
+    private static extractPipelineOptions;
+    private static extractFindOptions;
+    private static resolveDurationMs;
+    private static pipelineHasWriteStage;
+    private static extractAggregateOptions;
+    private static buildAggregateExplainCommand;
+    private static isAggregateExplainWriteConcernError;
+    private static isBsonObjectTooLargeError;
+    private static isValidDuration;
+    private static buildFindCursor;
+    private static measureExecution;
+    private static normalizeExplainPayload;
+    private static sanitizeExplainPayload;
+    private static deepClone;
+}
+export {};