@oneuptime/common 11.5.4 → 11.5.5

package/build/dist/Server/Utils/AI/SRE/Insights/InsightTriageRunner.js

@@ -0,0 +1,206 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import OneUptimeDate from "../../../../../Types/Date";
+import AIInsightService from "../../../../Services/AIInsightService";
+import { AI_INSIGHT_TRIAGE_FEATURE } from "../../../../Services/AIService";
+import AIInvestigationEngine from "../AIInvestigationEngine";
+import AIInvestigationQueue from "../InvestigationQueue";
+import logger from "../../../Logger";
+import CaptureSpan from "../../../Telemetry/CaptureSpan";
+/*
+ * AI SRE — per-insight preventive triage.
+ *
+ * A deterministic detector filed a AIInsight; this runner executes the
+ * budgeted, read-only Investigation AIRun that triages it: most likely root
+ * cause, estimated blast radius, ONE recommended next action — every claim
+ * cited. Structurally a sibling of IncidentInvestigationRunner: the queue
+ * claims the run and dispatches here; the shared engine owns the run
+ * lifecycle, the agent loop and the confidence signal.
+ *
+ * The difference is the OUTPUT SINK. Insights never page and never open
+ * incidents (the roadmap's Preventive-lane rule), so postAnalysis writes the
+ * summary onto the insight row and NOTHING else — the quiet inbox.
+ */
+/*
+ * Cap on the rendered evidence JSON embedded in the triage prompt. Latency
+ * evidence carries span-tree findings that can be large; the numbers matter,
+ * an exhaustive span listing does not.
+ */
+const MAX_RENDERED_EVIDENCE_CHARS = 4000;
+/*
+ * The preventive-triage framing, prepended to the subject description. The
+ * engine's persona is written for a just-declared incident/alert, so the
+ * request context must recast the situation before the insight is described
+ * (the engine embeds contextSummary into the investigation question — the
+ * same mechanism the incident runner uses to convey its subject).
+ */
+const PREVENTIVE_TRIAGE_FRAMING = `IMPORTANT — this is PREVENTIVE TRIAGE, not an incident investigation: NO incident or alert exists and nobody has been paged. A deterministic statistical sensor (no AI involved) watched this project's telemetry and filed the finding described below, with the evidence it computed. Your job:
+- Establish the most likely root cause of the finding.
+- Estimate the blast radius: which services/users/operations are affected, and how badly.
+- Recommend exactly ONE next action (the single most useful thing an engineer should do first).
+Cite the evidence for every factual claim. If the telemetry cannot support a conclusion, say so plainly. Do not refer to "the incident" — there is none.`;
+export default class InsightTriageRunner {
+    /*
+     * Execute a claimed triage run: load the insight, build its description
+     * and hand it to the shared engine. Called by AIInvestigationQueue
+     * after a successful claim. Never throws — failures are handed to the
+     * queue's retry policy so a claimed run is always finalized or requeued.
+     */
+    static async executeTriage(data) {
+        const { aiRunId, projectId, sentinelInsightId, attemptCount } = data;
+        let contextSummary;
+        try {
+            const insight = await AIInsightService.findOneById({
+                id: sentinelInsightId,
+                select: {
+                    _id: true,
+                    insightType: true,
+                    severity: true,
+                    title: true,
+                    detailMarkdown: true,
+                    evidence: true,
+                    serviceName: true,
+                    traceId: true,
+                    metricName: true,
+                    firstSeenAt: true,
+                    lastSeenAt: true,
+                    occurrenceCount: true,
+                },
+                props: { isRoot: true },
+            });
+            if (!insight) {
+                throw new Error("AI insight not found — it may have been deleted after the triage run was enqueued.");
+            }
+            contextSummary = this.buildInsightSummary(insight);
+        }
+        catch (error) {
+            /*
+             * Context assembly failed — the run is claimed, so hand it to the
+             * retry policy rather than leaving it Running until the sweeper.
+             */
+            await AIInvestigationQueue.failOrRequeue({
+                aiRunId,
+                attemptCount,
+                errorMessage: `Failed to build insight context: ${error instanceof Error ? error.message : String(error)}`,
+                isPermanent: false,
+            });
+            return;
+        }
+        await AIInvestigationEngine.executeRun({
+            aiRunId,
+            projectId,
+            attemptCount,
+            request: {
+                feature: AI_INSIGHT_TRIAGE_FEATURE,
+                contextSummary,
+                postAnalysis: async (postData) => {
+                    /*
+                     * The quiet inbox — deliberately the ONLY write: no feed items,
+                     * no workspace notification, no owner/on-call ping, no metrics,
+                     * and no instrumentation-task trigger. Insights never page and
+                     * never enter the notification pipeline (Preventive-lane rule);
+                     * the summary waits on the Insights page until a human looks.
+                     */
+                    await AIInsightService.updateOneById({
+                        id: sentinelInsightId,
+                        data: {
+                            triageSummaryMarkdown: postData.analysisMarkdown,
+                            triageCompletedAt: OneUptimeDate.getCurrentDate(),
+                        },
+                        props: { isRoot: true },
+                    });
+                    logger.debug(`AI insights: triage summary posted for insight ${sentinelInsightId.toString()} (run ${aiRunId.toString()}, confident=${postData.confidence.confident} via ${postData.confidence.source}).`);
+                },
+            },
+        });
+    }
+    // Build the compact insight record that seeds the triage.
+    static buildInsightSummary(insight) {
+        const lines = [];
+        lines.push(PREVENTIVE_TRIAGE_FRAMING);
+        lines.push("");
+        lines.push("# Insight finding");
+        lines.push(`Finding type: ${insight.insightType || "N/A"}`);
+        lines.push(`Title: ${insight.title || "N/A"}`);
+        lines.push(`Severity: ${insight.severity || "N/A"}`);
+        if (insight.serviceName) {
+            lines.push(`Attributed service: ${insight.serviceName}`);
+        }
+        if (insight.metricName) {
+            lines.push(`Metric: ${insight.metricName}`);
+        }
+        if (insight.traceId) {
+            lines.push(`Representative trace id: ${insight.traceId}`);
+        }
+        if (insight.firstSeenAt) {
+            lines.push(`First seen: ${OneUptimeDate.getDateAsFormattedString(insight.firstSeenAt)}`);
+        }
+        if (insight.lastSeenAt) {
+            lines.push(`Last seen: ${OneUptimeDate.getDateAsFormattedString(insight.lastSeenAt)}`);
+        }
+        if (insight.occurrenceCount) {
+            lines.push(`Times detected: ${insight.occurrenceCount}`);
+        }
+        if (insight.detailMarkdown) {
+            lines.push("");
+            lines.push("## Detector's evidence (deterministic, computed at detect time)");
+            lines.push(insight.detailMarkdown);
+        }
+        const renderedEvidence = this.renderEvidence(insight.evidence);
+        if (renderedEvidence) {
+            lines.push("");
+            lines.push("## Raw evidence values");
+            lines.push(renderedEvidence);
+        }
+        return lines.join("\n");
+    }
+    /*
+     * Render the stored evidence JSON compactly: one line per populated
+     * section, values verbatim (the numbers ARE the evidence), capped so a
+     * large span-tree finding cannot flood the prompt.
+     */
+    static renderEvidence(evidence) {
+        if (!evidence) {
+            return "";
+        }
+        const lines = [];
+        const sections = [
+            "exception",
+            "logSpike",
+            "latency",
+            "metricDrift",
+        ];
+        for (const section of sections) {
+            const value = evidence[section];
+            if (!value) {
+                continue;
+            }
+            let rendered;
+            try {
+                rendered = JSON.stringify(value);
+            }
+            catch (_a) {
+                continue;
+            }
+            if (rendered.length > MAX_RENDERED_EVIDENCE_CHARS) {
+                rendered = `${rendered.substring(0, MAX_RENDERED_EVIDENCE_CHARS)}… (truncated)`;
+            }
+            lines.push(`- ${section}: ${rendered}`);
+        }
+        return lines.join("\n");
+    }
+}
+__decorate([
+    CaptureSpan(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], InsightTriageRunner, "executeTriage", null);
+//# sourceMappingURL=InsightTriageRunner.js.map

package/build/dist/Server/Utils/AI/SRE/Insights/InsightTriageRunner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InsightTriageRunner.js","sourceRoot":"","sources":["../../../../../../../Server/Utils/AI/SRE/Insights/InsightTriageRunner.ts"],"names":[],"mappings":"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"}

package/build/dist/Server/Utils/AI/SRE/Insights/Triage.js

@@ -0,0 +1,121 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import AIRunType from "../../../../../Types/AI/AIRunType";
+import AIRunStatus from "../../../../../Types/AI/AIRunStatus";
+import ProjectService from "../../../../Services/ProjectService";
+import LlmProviderService from "../../../../Services/LlmProviderService";
+import AIRunService from "../../../../Services/AIRunService";
+import AIInsightService from "../../../../Services/AIInsightService";
+import AIInvestigationQueue from "../InvestigationQueue";
+import QueryHelper from "../../../../Types/Database/QueryHelper";
+import logger from "../../../Logger";
+import CaptureSpan from "../../../Telemetry/CaptureSpan";
+export default class InsightTriage {
+    /*
+     * NEVER throws — this runs inside the scanner's per-insight routing and a
+     * failed triage enqueue must not fail the scan itself. Every failure is
+     * logged and swallowed; an empty result means "no triage enqueued".
+     */
+    static async enqueueInsightTriage(data) {
+        var _a;
+        const { insight } = data;
+        try {
+            if (!insight.id || !insight.projectId) {
+                return {};
+            }
+            const projectId = insight.projectId;
+            const project = await ProjectService.findOneById({
+                id: projectId,
+                select: {
+                    enableAi: true,
+                    enableAiInsights: true,
+                },
+                props: { isRoot: true },
+            });
+            if (!project) {
+                logger.debug(`AI insights: not enqueueing triage for insight ${insight.id.toString()} — project not found.`);
+                return {};
+            }
+            if (project.enableAi === false) {
+                logger.debug(`AI insights: not enqueueing triage for insight ${insight.id.toString()} — AI is disabled for the project.`);
+                return {};
+            }
+            /*
+             * Strict opt-in — the column defaults to false. A triage run only
+             * exists because insights exist, so it shares the insights flag; the
+             * fix-tasks flag is a separate, stricter opt-in.
+             */
+            if (project.enableAiInsights !== true) {
+                logger.debug(`AI insights: not enqueueing triage for insight ${insight.id.toString()} — project has not opted in to AI insights.`);
+                return {};
+            }
+            const llmProvider = await LlmProviderService.getLLMProviderForProject(projectId);
+            if (!llmProvider) {
+                logger.debug(`AI insights: not enqueueing triage for insight ${insight.id.toString()} — no LLM provider configured.`);
+                return {};
+            }
+            /*
+             * Dedupe: at most one non-terminal triage run per insight — the
+             * scanner refreshes recurring insights every tick, and a refresh must
+             * not fan out into duplicate triage runs.
+             */
+            const nonTerminalTriageRunCount = (await AIRunService.countBy({
+                query: {
+                    runType: AIRunType.Investigation,
+                    triggeredByAiInsightId: insight.id,
+                    status: QueryHelper.notIn([
+                        AIRunStatus.Completed,
+                        AIRunStatus.Error,
+                        AIRunStatus.Cancelled,
+                        AIRunStatus.Stale,
+                    ]),
+                },
+                props: { isRoot: true },
+            })).toNumber();
+            if (nonTerminalTriageRunCount > 0) {
+                logger.debug(`AI insights: not enqueueing triage for insight ${insight.id.toString()} — a non-terminal triage run already exists.`);
+                return {};
+            }
+            /*
+             * Record the durable intent. The queue's own budget quiet-skip
+             * applies here too — a null result means no run was created (budget
+             * exhausted or the create failed) and the insight simply gets no
+             * triage this tick.
+             */
+            const triageAiRunId = await AIInvestigationQueue.enqueue({
+                projectId,
+                subjectAIInsightId: insight.id,
+            });
+            if (!triageAiRunId) {
+                return {};
+            }
+            // Link the insight to its triage run for the dashboard's live panel.
+            await AIInsightService.updateOneById({
+                id: insight.id,
+                data: {
+                    triageAiRunId,
+                },
+                props: { isRoot: true },
+            });
+            return { triageAiRunId };
+        }
+        catch (error) {
+            logger.error(`AI insights: failed to enqueue triage for insight ${(_a = insight.id) === null || _a === void 0 ? void 0 : _a.toString()}: ${error}`);
+            return {};
+        }
+    }
+}
+__decorate([
+    CaptureSpan(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], InsightTriage, "enqueueInsightTriage", null);
+//# sourceMappingURL=Triage.js.map

package/build/dist/Server/Utils/AI/SRE/Insights/Triage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Triage.js","sourceRoot":"","sources":["../../../../../../../Server/Utils/AI/SRE/Insights/Triage.ts"],"names":[],"mappings":"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"}

package/build/dist/Server/Utils/AI/SRE/Insights/Types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Types.js.map

package/build/dist/Server/Utils/AI/SRE/Insights/Types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Types.js","sourceRoot":"","sources":["../../../../../../../Server/Utils/AI/SRE/Insights/Types.ts"],"names":[],"mappings":""}

package/build/dist/Server/Utils/AI/SRE/InstrumentationTaskTrigger.js

@@ -0,0 +1,148 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import CodeFixTaskType from "../../../../Types/AI/CodeFixTaskType";
+import ProjectService from "../../../Services/ProjectService";
+import SubjectCodeFixRun from "./SubjectCodeFixRun";
+import FixRunBudget from "../CodeFix/FixRunBudget";
+import logger from "../../Logger";
+import CaptureSpan from "../../Telemetry/CaptureSpan";
+export default class InstrumentationTaskTrigger {
+    /*
+     * The pure trigger decision, separated from IO so it can be tested
+     * directly: opt-in (default FALSE), a repository the agent can actually
+     * open a PR against, and the per-subject dedupe guard.
+     */
+    static shouldEnqueueInstrumentationTask(input) {
+        if (!input.project) {
+            return { enqueue: false, reason: "project not found" };
+        }
+        if (input.project.enableAi === false) {
+            return { enqueue: false, reason: "AI is disabled for the project" };
+        }
+        /*
+         * Strict opt-in — the column defaults to false, so unset/legacy rows
+         * never enqueue. Autonomous PR creation must never be default-on.
+         */
+        if (input.project.enableInstrumentationFixTasks !== true) {
+            return {
+                enqueue: false,
+                reason: "project has not opted in to instrumentation fix tasks",
+            };
+        }
+        if (!input.hasConnectedRepository) {
+            return {
+                enqueue: false,
+                reason: "project has no GitHub-App-connected repository",
+            };
+        }
+        /*
+         * Dedupe: at most one non-terminal ImproveInstrumentation run per
+         * incident/alert — repeated inconclusive attempts on the same subject
+         * must not fan out into duplicate PRs.
+         */
+        if (input.existingRun) {
+            return {
+                enqueue: false,
+                reason: "a non-terminal ImproveInstrumentation run already exists for this subject",
+            };
+        }
+        return {
+            enqueue: true,
+            reason: "passed opt-in, repository and dedupe gates",
+        };
+    }
+    /*
+     * Record the durable intent as a Queued CodeFix AIRun that the external
+     * agent worker claims via /ai-agent-task/get-pending-task. Exactly one of
+     * incidentId/alertId is expected (the investigation's subject). NEVER
+     * throws — every failure is logged and swallowed, because this runs
+     * inside the investigation's postAnalysis and must not fail it.
+     */
+    static async enqueueForInconclusiveInvestigation(data) {
+        var _a, _b;
+        const { projectId } = data;
+        try {
+            if (!data.incidentId && !data.alertId) {
+                return;
+            }
+            const project = await ProjectService.findOneById({
+                id: projectId,
+                select: {
+                    enableAi: true,
+                    enableInstrumentationFixTasks: true,
+                },
+                props: { isRoot: true },
+            });
+            /*
+             * Cheapest gate first: skip the repository count for the (default)
+             * not-opted-in case.
+             */
+            const optInDecision = this.shouldEnqueueInstrumentationTask({
+                project,
+                hasConnectedRepository: true,
+                existingRun: null,
+            });
+            if (!optInDecision.enqueue) {
+                logger.debug(`AI: not enqueueing instrumentation task for project ${projectId.toString()} — ${optInDecision.reason}.`);
+                return;
+            }
+            /*
+             * G11 guardrail: the per-project daily fix-run budget. For this
+             * AUTOMATIC trigger, over-budget is a logged skip — never an error
+             * thrown into the investigation (enqueueSubjectCodeFixRun would
+             * throw the same rejection, but that lands in the catch below as an
+             * error log; a budget skip is expected behavior, not a failure).
+             */
+            const budget = await FixRunBudget.getBudgetStatus(projectId);
+            if (!budget.allowed) {
+                logger.debug(`AI: not enqueueing instrumentation task for project ${projectId.toString()} — ${FixRunBudget.describeRejection(budget)}`);
+                return;
+            }
+            /*
+             * Repository + per-subject dedupe checks are the enqueue idiom shared
+             * with the FixFromIncident sibling — see SubjectCodeFixRun.
+             */
+            const hasConnectedRepository = await SubjectCodeFixRun.hasGitHubAppConnectedRepository(projectId);
+            const existingRun = await SubjectCodeFixRun.findNonTerminalRunForSubject({
+                taskType: CodeFixTaskType.ImproveInstrumentation,
+                incidentId: data.incidentId,
+                alertId: data.alertId,
+            });
+            const decision = this.shouldEnqueueInstrumentationTask({
+                project,
+                hasConnectedRepository,
+                existingRun,
+            });
+            if (!decision.enqueue) {
+                logger.debug(`AI: not enqueueing instrumentation task for project ${projectId.toString()} — ${decision.reason}.`);
+                return;
+            }
+            const createdRun = await SubjectCodeFixRun.enqueueSubjectCodeFixRun({
+                projectId,
+                taskType: CodeFixTaskType.ImproveInstrumentation,
+                incidentId: data.incidentId,
+                alertId: data.alertId,
+            });
+            logger.debug(`AI: enqueued ImproveInstrumentation run ${(_a = createdRun.id) === null || _a === void 0 ? void 0 : _a.toString()} for ${data.incidentId
+                ? `incident ${data.incidentId.toString()}`
+                : `alert ${(_b = data.alertId) === null || _b === void 0 ? void 0 : _b.toString()}`} after an inconclusive investigation.`);
+        }
+        catch (error) {
+            logger.error(`AI: failed to enqueue instrumentation task for project ${projectId.toString()}: ${error}`);
+        }
+    }
+}
+__decorate([
+    CaptureSpan(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], InstrumentationTaskTrigger, "enqueueForInconclusiveInvestigation", null);
+//# sourceMappingURL=InstrumentationTaskTrigger.js.map

package/build/dist/Server/Utils/AI/SRE/InstrumentationTaskTrigger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InstrumentationTaskTrigger.js","sourceRoot":"","sources":["../../../../../../Server/Utils/AI/SRE/InstrumentationTaskTrigger.ts"],"names":[],"mappings":"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"}