@oneuptime/common 11.3.25 → 11.3.28

package/build/dist/Server/Utils/AI/Toolbox/AlertTools.js

@@ -0,0 +1,167 @@
+import Alert from "../../../../Models/DatabaseModels/Alert";
+import SortOrder from "../../../../Types/BaseDatabase/SortOrder";
+import { AIChatCitationTargetType } from "../../../../Types/AI/AIChatTypes";
+import AlertService from "../../../Services/AlertService";
+import QueryHelper from "../../../Types/Database/QueryHelper";
+import OneUptimeDate from "../../../../Types/Date";
+import ToolResultSerializer from "./Serializer";
+import WidgetBuilder from "./WidgetBuilder";
+import { ToolArgs, } from "./ToolTypes";
+/*
+ * Derived from the model ACL so the tool gate can never drift from RBAC.
+ * Resolved lazily rather than at module load: this module is pulled in through
+ * the service import graph before the Alert model class is fully wired up, so
+ * calling a model method at import time throws a circular-dependency
+ * TypeError. By the time a tool actually executes, every module is loaded.
+ */
+let cachedReadPermissions = null;
+const resolveReadPermissions = () => {
+    if (!cachedReadPermissions) {
+        cachedReadPermissions = new Alert().getReadPermissions();
+    }
+    return cachedReadPermissions;
+};
+export const QueryAlertsTool = {
+    name: "query_alerts",
+    description: "Query alerts in this project. Returns the most recent alerts with their current state and severity. Pass alertId to get full details of one alert.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            alertId: {
+                type: "string",
+                description: "Get one alert by its ID (includes description).",
+            },
+            createdWithinHours: {
+                type: "number",
+                description: "Only alerts created within this many hours (default 24, max 720).",
+            },
+            limit: {
+                type: "number",
+                description: "Maximum alerts to return (default 10, max 25).",
+            },
+        },
+    },
+    get requiredPermissions() {
+        return resolveReadPermissions();
+    },
+    execute: async (args, ctx) => {
+        var _a, _b, _c, _d;
+        const alertId = ToolArgs.getObjectID(args, "alertId");
+        if (alertId) {
+            const alert = await AlertService.findOneById({
+                id: alertId,
+                select: {
+                    _id: true,
+                    title: true,
+                    description: true,
+                    alertNumber: true,
+                    createdAt: true,
+                    currentAlertState: {
+                        name: true,
+                    },
+                    alertSeverity: {
+                        name: true,
+                    },
+                },
+                props: ctx.props,
+            });
+            const rows = alert
+                ? [
+                    {
+                        id: (_a = alert.id) === null || _a === void 0 ? void 0 : _a.toString(),
+                        alertNumber: alert.alertNumber,
+                        title: alert.title,
+                        description: alert.description,
+                        state: (_b = alert.currentAlertState) === null || _b === void 0 ? void 0 : _b.name,
+                        severity: (_c = alert.alertSeverity) === null || _c === void 0 ? void 0 : _c.name,
+                        createdAt: alert.createdAt,
+                    },
+                ]
+                : [];
+            const serialized = ToolResultSerializer.serializeRows(rows);
+            return {
+                dataForLlm: serialized.text,
+                rowCount: serialized.rowCount,
+                citationLabel: `Alert ${(alert === null || alert === void 0 ? void 0 : alert.alertNumber) ? `#${alert.alertNumber}` : alertId.toString()}`,
+                citationTarget: {
+                    type: AIChatCitationTargetType.AlertView,
+                    params: { alertId: alertId.toString() },
+                },
+                redactionCount: serialized.redactionCount,
+                isTruncated: serialized.isTruncated,
+                widget: rows.length > 0
+                    ? WidgetBuilder.alertList({
+                        title: `Alert #${(_d = alert === null || alert === void 0 ? void 0 : alert.alertNumber) !== null && _d !== void 0 ? _d : ""}`.trim(),
+                        items: rows,
+                        link: {
+                            type: AIChatCitationTargetType.AlertView,
+                            params: { alertId: alertId.toString() },
+                        },
+                    })
+                    : undefined,
+            };
+        }
+        const createdWithinHours = ToolArgs.getNumber(args, "createdWithinHours", { defaultValue: 24, min: 1, max: 720 });
+        const limit = ToolArgs.getNumber(args, "limit", {
+            defaultValue: 10,
+            min: 1,
+            max: 25,
+        });
+        const endTime = OneUptimeDate.getCurrentDate();
+        const startTime = OneUptimeDate.addRemoveHours(endTime, -1 * createdWithinHours);
+        const alerts = await AlertService.findBy({
+            query: {
+                createdAt: QueryHelper.inBetween(startTime, endTime),
+            },
+            select: {
+                _id: true,
+                title: true,
+                alertNumber: true,
+                createdAt: true,
+                currentAlertState: {
+                    name: true,
+                },
+                alertSeverity: {
+                    name: true,
+                },
+            },
+            sort: {
+                createdAt: SortOrder.Descending,
+            },
+            limit: limit,
+            skip: 0,
+            props: ctx.props,
+        });
+        const rows = alerts.map((alert) => {
+            var _a, _b, _c;
+            return {
+                id: (_a = alert.id) === null || _a === void 0 ? void 0 : _a.toString(),
+                alertNumber: alert.alertNumber,
+                title: alert.title,
+                state: (_b = alert.currentAlertState) === null || _b === void 0 ? void 0 : _b.name,
+                severity: (_c = alert.alertSeverity) === null || _c === void 0 ? void 0 : _c.name,
+                createdAt: alert.createdAt,
+            };
+        });
+        const serialized = ToolResultSerializer.serializeRows(rows);
+        return {
+            dataForLlm: serialized.text,
+            rowCount: serialized.rowCount,
+            citationLabel: `Alerts, last ${createdWithinHours}h (${serialized.rowCount} found)`,
+            citationTarget: {
+                type: AIChatCitationTargetType.Alerts,
+            },
+            redactionCount: serialized.redactionCount,
+            isTruncated: serialized.isTruncated,
+            widget: rows.length > 0
+                ? WidgetBuilder.alertList({
+                    title: `Alerts (${rows.length})`,
+                    description: `Created in the last ${createdWithinHours}h`,
+                    items: rows,
+                    link: { type: AIChatCitationTargetType.Alerts },
+                })
+                : undefined,
+        };
+    },
+};
+//# sourceMappingURL=AlertTools.js.map

package/build/dist/Server/Utils/AI/Toolbox/AlertTools.js.map

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

package/build/dist/Server/Utils/AI/Toolbox/AlertWriteTools.js

@@ -0,0 +1,136 @@
+import Alert from "../../../../Models/DatabaseModels/Alert";
+import BadDataException from "../../../../Types/Exception/BadDataException";
+import { AIChatCitationTargetType } from "../../../../Types/AI/AIChatTypes";
+import AlertService from "../../../Services/AlertService";
+import ToolResultSerializer from "./Serializer";
+import WidgetBuilder from "./WidgetBuilder";
+import { ToolArgs, } from "./ToolTypes";
+/*
+ * Derived from the model ACL so the tool gate can never drift from RBAC.
+ * Resolved lazily rather than at module load: this module is pulled in through
+ * the service import graph before the Alert model class is fully wired up, so
+ * calling a model method at import time throws a circular-dependency
+ * TypeError. By the time a tool actually executes, every module is loaded.
+ */
+let cachedUpdatePermissions = null;
+const resolveUpdatePermissions = () => {
+    if (!cachedUpdatePermissions) {
+        cachedUpdatePermissions = new Alert().getUpdatePermissions();
+    }
+    return cachedUpdatePermissions;
+};
+async function changeAlertStateTool(data) {
+    var _a;
+    const { args, ctx, verb } = data;
+    const alertId = ToolArgs.getObjectID(args, "alertId");
+    if (!alertId) {
+        throw new BadDataException("alertId is required. Use query_alerts to find it first.");
+    }
+    const userId = ctx.props.userId;
+    if (!userId) {
+        throw new BadDataException("No authenticated user in context; cannot change the alert.");
+    }
+    // Confirm the alert is visible to this user under their RBAC.
+    const alert = await AlertService.findOneById({
+        id: alertId,
+        select: {
+            _id: true,
+            alertNumber: true,
+            title: true,
+        },
+        props: ctx.props,
+    });
+    if (!alert) {
+        throw new BadDataException("Alert not found (or you do not have access to it).");
+    }
+    if (verb === "acknowledge") {
+        await AlertService.acknowledgeAlert(alertId, userId);
+    }
+    else {
+        await AlertService.resolveAlert(alertId, userId);
+    }
+    const newStateName = verb === "acknowledge" ? "Acknowledged" : "Resolved";
+    const alertIdString = alertId.toString();
+    const serialized = ToolResultSerializer.serializeRows([
+        {
+            id: alertIdString,
+            alertNumber: alert.alertNumber,
+            title: alert.title,
+            newState: newStateName,
+        },
+    ]);
+    return {
+        dataForLlm: `Alert #${alert.alertNumber} ("${alert.title}") is now ${newStateName}.\n${serialized.text}`,
+        rowCount: 1,
+        citationLabel: `${newStateName} alert #${alert.alertNumber}`,
+        citationTarget: {
+            type: AIChatCitationTargetType.AlertView,
+            params: { alertId: alertIdString },
+        },
+        redactionCount: serialized.redactionCount,
+        isTruncated: false,
+        widget: WidgetBuilder.resourceCard({
+            title: `Alert ${newStateName.toLowerCase()}`,
+            resourceType: "Alert",
+            heading: `#${alert.alertNumber} · ${alert.title}`,
+            subheading: `Now ${newStateName}`,
+            fields: [
+                { label: "Number", value: `#${(_a = alert.alertNumber) !== null && _a !== void 0 ? _a : ""}` },
+                { label: "State", value: newStateName },
+            ],
+            link: {
+                type: AIChatCitationTargetType.AlertView,
+                params: { alertId: alertIdString },
+            },
+        }),
+    };
+}
+export const AcknowledgeAlertTool = {
+    name: "acknowledge_alert",
+    description: "Acknowledge an alert (move it to the acknowledged state) by its alertId. Find the alertId with query_alerts first.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            alertId: {
+                type: "string",
+                description: "The alert's ID (required).",
+            },
+        },
+        required: ["alertId"],
+    },
+    get requiredPermissions() {
+        return resolveUpdatePermissions();
+    },
+    isMutation: true,
+    buildActionTitle: (args) => {
+        return `Acknowledge alert ${ToolArgs.getString(args, "alertId") || ""}`.trim();
+    },
+    execute: async (args, ctx) => {
+        return changeAlertStateTool({ args, ctx, verb: "acknowledge" });
+    },
+};
+export const ResolveAlertTool = {
+    name: "resolve_alert",
+    description: "Resolve an alert (move it to the resolved state) by its alertId. Find the alertId with query_alerts first.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            alertId: {
+                type: "string",
+                description: "The alert's ID (required).",
+            },
+        },
+        required: ["alertId"],
+    },
+    get requiredPermissions() {
+        return resolveUpdatePermissions();
+    },
+    isMutation: true,
+    buildActionTitle: (args) => {
+        return `Resolve alert ${ToolArgs.getString(args, "alertId") || ""}`.trim();
+    },
+    execute: async (args, ctx) => {
+        return changeAlertStateTool({ args, ctx, verb: "resolve" });
+    },
+};
+//# sourceMappingURL=AlertWriteTools.js.map

package/build/dist/Server/Utils/AI/Toolbox/AlertWriteTools.js.map

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

package/build/dist/Server/Utils/AI/Toolbox/ContextTools.js

@@ -0,0 +1,141 @@
+import SortOrder from "../../../../Types/BaseDatabase/SortOrder";
+import BadDataException from "../../../../Types/Exception/BadDataException";
+import Permission from "../../../../Types/Permission";
+import TelemetryType from "../../../../Types/Telemetry/TelemetryType";
+import MetricTypeService from "../../../Services/MetricTypeService";
+import ServiceService from "../../../Services/ServiceService";
+import TelemetryAttributeService from "../../../Services/TelemetryAttributeService";
+import QueryHelper from "../../../Types/Database/QueryHelper";
+import ToolResultSerializer from "./Serializer";
+import { ToolArgs, } from "./ToolTypes";
+const CONTEXT_READ_PERMISSIONS = [
+    Permission.ProjectOwner,
+    Permission.ProjectAdmin,
+    Permission.ProjectMember,
+    Permission.Viewer,
+    Permission.TelemetryAdmin,
+    Permission.TelemetryMember,
+    Permission.TelemetryViewer,
+];
+export const LookupContextTool = {
+    name: "lookup_context",
+    description: "Discover what exists in this project so other tools can be called with exact identifiers: telemetry services (name → ID), metric names, and attribute keys for logs/traces/metrics. ALWAYS resolve a service name to its ID here before filtering other tools by service.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            type: {
+                type: "string",
+                enum: ["services", "metricNames", "attributeKeys"],
+                description: "What to look up (required).",
+            },
+            nameSearch: {
+                type: "string",
+                description: "Filter results whose name contains this text.",
+            },
+            telemetryType: {
+                type: "string",
+                enum: ["Log", "Trace", "Metric", "Exception"],
+                description: "For attributeKeys lookups: which signal's attribute keys to list.",
+            },
+        },
+        required: ["type"],
+    },
+    requiredPermissions: CONTEXT_READ_PERMISSIONS,
+    execute: async (args, ctx) => {
+        const lookupType = ToolArgs.getString(args, "type");
+        const nameSearch = ToolArgs.getString(args, "nameSearch");
+        if (lookupType === "services") {
+            const services = await ServiceService.findBy({
+                query: nameSearch
+                    ? {
+                        name: QueryHelper.search(nameSearch),
+                    }
+                    : {},
+                select: {
+                    _id: true,
+                    name: true,
+                },
+                sort: {
+                    name: SortOrder.Ascending,
+                },
+                limit: 100,
+                skip: 0,
+                props: ctx.props,
+            });
+            const rows = services.map((service) => {
+                var _a;
+                return {
+                    id: (_a = service.id) === null || _a === void 0 ? void 0 : _a.toString(),
+                    name: service.name,
+                };
+            });
+            const serialized = ToolResultSerializer.serializeRows(rows);
+            return {
+                dataForLlm: serialized.text,
+                rowCount: serialized.rowCount,
+                citationLabel: `Telemetry services (${serialized.rowCount} found)`,
+                citationTarget: undefined,
+                redactionCount: serialized.redactionCount,
+                isTruncated: serialized.isTruncated,
+            };
+        }
+        if (lookupType === "metricNames") {
+            const metricTypes = await MetricTypeService.findBy({
+                query: nameSearch
+                    ? {
+                        name: QueryHelper.search(nameSearch),
+                    }
+                    : {},
+                select: {
+                    name: true,
+                },
+                sort: {
+                    name: SortOrder.Ascending,
+                },
+                limit: 200,
+                skip: 0,
+                props: ctx.props,
+            });
+            const rows = metricTypes.map((metricType) => {
+                return {
+                    name: metricType.name,
+                };
+            });
+            const serialized = ToolResultSerializer.serializeRows(rows);
+            return {
+                dataForLlm: serialized.text,
+                rowCount: serialized.rowCount,
+                citationLabel: `Metric names (${serialized.rowCount} found)`,
+                citationTarget: undefined,
+                redactionCount: serialized.redactionCount,
+                isTruncated: serialized.isTruncated,
+            };
+        }
+        if (lookupType === "attributeKeys") {
+            const telemetryTypeString = ToolArgs.getString(args, "telemetryType") || "Log";
+            if (!Object.values(TelemetryType).includes(telemetryTypeString)) {
+                throw new BadDataException(`Invalid telemetryType: ${telemetryTypeString}`);
+            }
+            const attributes = await TelemetryAttributeService.fetchAttributes({
+                projectId: ctx.projectId,
+                telemetryType: telemetryTypeString,
+            });
+            const filtered = nameSearch
+                ? attributes.filter((attribute) => {
+                    return attribute.toLowerCase().includes(nameSearch.toLowerCase());
+                })
+                : attributes;
+            const serialized = ToolResultSerializer.serializeText(filtered.slice(0, 200).join("\n"), filtered.length);
+            return {
+                dataForLlm: serialized.text,
+                rowCount: serialized.rowCount,
+                citationLabel: `${telemetryTypeString} attribute keys (${filtered.length} found)`,
+                citationTarget: undefined,
+                redactionCount: serialized.redactionCount,
+                isTruncated: serialized.isTruncated,
+            };
+        }
+        throw new BadDataException(`Invalid lookup type: ${lookupType}. Use one of: services, metricNames, attributeKeys.`);
+    },
+};
+//# sourceMappingURL=ContextTools.js.map

package/build/dist/Server/Utils/AI/Toolbox/ContextTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContextTools.js","sourceRoot":"","sources":["../../../../../../Server/Utils/AI/Toolbox/ContextTools.ts"],"names":[],"mappings":"AAEA,OAAO,SAAS,MAAM,0CAA0C,CAAC;AACjE,OAAO,gBAAgB,MAAM,8CAA8C,CAAC;AAE5E,OAAO,UAAU,MAAM,8BAA8B,CAAC;AACtD,OAAO,aAAa,MAAM,2CAA2C,CAAC;AACtE,OAAO,iBAAiB,MAAM,qCAAqC,CAAC;AACpE,OAAO,cAAc,MAAM,kCAAkC,CAAC;AAC9D,OAAO,yBAAyB,MAAM,6CAA6C,CAAC;AACpF,OAAO,WAAW,MAAM,qCAAqC,CAAC;AAC9D,OAAO,oBAA0C,MAAM,cAAc,CAAC;AACtE,OAAO,EAEL,QAAQ,GAGT,MAAM,aAAa,CAAC;AAErB,MAAM,wBAAwB,GAAsB;IAClD,UAAU,CAAC,YAAY;IACvB,UAAU,CAAC,YAAY;IACvB,UAAU,CAAC,aAAa;IACxB,UAAU,CAAC,MAAM;IACjB,UAAU,CAAC,cAAc;IACzB,UAAU,CAAC,eAAe;IAC1B,UAAU,CAAC,eAAe;CAC3B,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAsB;IAClD,IAAI,EAAE,gBAAgB;IACtB,WAAW,EACT,2QAA2Q;IAC7Q,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,UAAU,EAAE,aAAa,EAAE,eAAe,CAAC;gBAClD,WAAW,EAAE,6BAA6B;aAC3C;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+CAA+C;aAC7D;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,CAAC;gBAC7C,WAAW,EACT,mEAAmE;aACtE;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;IACD,mBAAmB,EAAE,wBAAwB;IAC7C,OAAO,EAAE,KAAK,EACZ,IAAgB,EAChB,GAAgB,EACc,EAAE;QAChC,MAAM,UAAU,GAAuB,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACxE,MAAM,UAAU,GAAuB,QAAQ,CAAC,SAAS,CACvD,IAAI,EACJ,YAAY,CACb,CAAC;QAEF,IAAI,UAAU,KAAK,UAAU,EAAE,CAAC;YAC9B,MAAM,QAAQ,GAAmB,MAAM,cAAc,CAAC,MAAM,CAAC;gBAC3D,KAAK,EAAE,UAAU;oBACf,CAAC,CAAC;wBACE,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC;qBACrC;oBACH,CAAC,CAAC,EAAE;gBACN,MAAM,EAAE;oBACN,GAAG,EAAE,IAAI;oBACT,IAAI,EAAE,IAAI;iBACX;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,SAAS,CAAC,SAAS;iBAC1B;gBACD,KAAK,EAAE,GAAG;gBACV,IAAI,EAAE,CAAC;gBACP,KAAK,EAAE,GAAG,CAAC,KAAK;aACjB,CAAC,CAAC;YAEH,MAAM,IAAI,GAAsB,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAgB,EAAE,EAAE;;gBAChE,OAAO;oBACL,EAAE,EAAE,MAAA,OAAO,CAAC,EAAE,0CAAE,QAAQ,EAAE;oBAC1B,IAAI,EAAE,OAAO,CAAC,IAAI;iBACnB,CAAC;YACJ,CAAC,CAAC,CAAC;YAEH,MAAM,UAAU,GACd,oBAAoB,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;YAE3C,OAAO;gBACL,UAAU,EAAE,UAAU,CAAC,IAAI;gBAC3B,QAAQ,EAAE,UAAU,CAAC,QAAQ;gBAC7B,aAAa,EAAE,uBAAuB,UAAU,CAAC,QAAQ,SAAS;gBAClE,cAAc,EAAE,SAAS;gBACzB,cAAc,EAAE,UAAU,CAAC,cAAc;gBACzC,WAAW,EAAE,UAAU,CAAC,WAAW;aACpC,CAAC;QACJ,CAAC;QAED,IAAI,UAAU,KAAK,aAAa,EAAE,CAAC;YACjC,MAAM,WAAW,GAAsB,MAAM,iBAAiB,CAAC,MAAM,CAAC;gBACpE,KAAK,EAAE,UAAU;oBACf,CAAC,CAAC;wBACE,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC;qBACrC;oBACH,CAAC,CAAC,EAAE;gBACN,MAAM,EAAE;oBACN,IAAI,EAAE,IAAI;iBACX;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,SAAS,CAAC,SAAS;iBAC1B;gBACD,KAAK,EAAE,GAAG;gBACV,IAAI,EAAE,CAAC;gBACP,KAAK,EAAE,GAAG,CAAC,KAAK;aACjB,CAAC,CAAC;YAEH,MAAM,IAAI,GAAsB,WAAW,CAAC,GAAG,CAC7C,CAAC,UAAsB,EAAE,EAAE;gBACzB,OAAO;oBACL,IAAI,EAAE,UAAU,CAAC,IAAI;iBACtB,CAAC;YACJ,CAAC,CACF,CAAC;YAEF,MAAM,UAAU,GACd,oBAAoB,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;YAE3C,OAAO;gBACL,UAAU,EAAE,UAAU,CAAC,IAAI;gBAC3B,QAAQ,EAAE,UAAU,CAAC,QAAQ;gBAC7B,aAAa,EAAE,iBAAiB,UAAU,CAAC,QAAQ,SAAS;gBAC5D,cAAc,EAAE,SAAS;gBACzB,cAAc,EAAE,UAAU,CAAC,cAAc;gBACzC,WAAW,EAAE,UAAU,CAAC,WAAW;aACpC,CAAC;QACJ,CAAC;QAED,IAAI,UAAU,KAAK,eAAe,EAAE,CAAC;YACnC,MAAM,mBAAmB,GACvB,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,eAAe,CAAC,IAAI,KAAK,CAAC;YAErD,IACE,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,QAAQ,CACpC,mBAAoC,CACrC,EACD,CAAC;gBACD,MAAM,IAAI,gBAAgB,CACxB,0BAA0B,mBAAmB,EAAE,CAChD,CAAC;YACJ,CAAC;YAED,MAAM,UAAU,GACd,MAAM,yBAAyB,CAAC,eAAe,CAAC;gBAC9C,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,aAAa,EAAE,mBAAoC;aACpD,CAAC,CAAC;YAEL,MAAM,QAAQ,GAAkB,UAAU;gBACxC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,SAAiB,EAAE,EAAE;oBACtC,OAAO,SAAS,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC;gBACpE,CAAC,CAAC;gBACJ,CAAC,CAAC,UAAU,CAAC;YAEf,MAAM,UAAU,GAAqB,oBAAoB,CAAC,aAAa,CACrE,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EACjC,QAAQ,CAAC,MAAM,CAChB,CAAC;YAEF,OAAO;gBACL,UAAU,EAAE,UAAU,CAAC,IAAI;gBAC3B,QAAQ,EAAE,UAAU,CAAC,QAAQ;gBAC7B,aAAa,EAAE,GAAG,mBAAmB,oBAAoB,QAAQ,CAAC,MAAM,SAAS;gBACjF,cAAc,EAAE,SAAS;gBACzB,cAAc,EAAE,UAAU,CAAC,cAAc;gBACzC,WAAW,EAAE,UAAU,CAAC,WAAW;aACpC,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,gBAAgB,CACxB,wBAAwB,UAAU,qDAAqD,CACxF,CAAC;IACJ,CAAC;CACF,CAAC"}

package/build/dist/Server/Utils/AI/Toolbox/ExceptionTools.js

@@ -0,0 +1,117 @@
+import TelemetryException from "../../../../Models/DatabaseModels/TelemetryException";
+import SortOrder from "../../../../Types/BaseDatabase/SortOrder";
+import { AIChatCitationTargetType } from "../../../../Types/AI/AIChatTypes";
+import TelemetryExceptionService from "../../../Services/TelemetryExceptionService";
+import QueryHelper from "../../../Types/Database/QueryHelper";
+import OneUptimeDate from "../../../../Types/Date";
+import ToolResultSerializer from "./Serializer";
+import WidgetBuilder from "./WidgetBuilder";
+import { ToolArgs, } from "./ToolTypes";
+/*
+ * Derived from the model ACL so the tool gate can never drift from RBAC.
+ * Resolved lazily rather than at module load: this module is pulled in through
+ * the service import graph before the TelemetryException model class is fully
+ * wired up, so calling a model method at import time throws a
+ * circular-dependency TypeError. By the time a tool actually executes, every
+ * module is loaded.
+ */
+let cachedReadPermissions = null;
+const resolveReadPermissions = () => {
+    if (!cachedReadPermissions) {
+        cachedReadPermissions = new TelemetryException().getReadPermissions();
+    }
+    return cachedReadPermissions;
+};
+export const TopExceptionsTool = {
+    name: "top_exceptions",
+    description: "Get the top exceptions (grouped by fingerprint) in this project, sorted by occurrence count. Includes first/last seen timestamps so you can tell if an exception is new or recurring.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            lastSeenWithinHours: {
+                type: "number",
+                description: "Only exceptions last seen within this many hours (default 168 = 7 days, max 720).",
+            },
+            includeResolved: {
+                type: "boolean",
+                description: "Include resolved exceptions (default false).",
+            },
+            limit: {
+                type: "number",
+                description: "Maximum exception groups to return (default 10, max 25).",
+            },
+        },
+    },
+    get requiredPermissions() {
+        return resolveReadPermissions();
+    },
+    execute: async (args, ctx) => {
+        var _a;
+        const lastSeenWithinHours = ToolArgs.getNumber(args, "lastSeenWithinHours", { defaultValue: 168, min: 1, max: 720 });
+        const includeResolved = (_a = ToolArgs.getBoolean(args, "includeResolved")) !== null && _a !== void 0 ? _a : false;
+        const limit = ToolArgs.getNumber(args, "limit", {
+            defaultValue: 10,
+            min: 1,
+            max: 25,
+        });
+        const since = OneUptimeDate.addRemoveHours(OneUptimeDate.getCurrentDate(), -1 * lastSeenWithinHours);
+        const query = {
+            lastSeenAt: QueryHelper.greaterThanEqualTo(since),
+        };
+        if (!includeResolved) {
+            query["isResolved"] = false;
+        }
+        const exceptions = await TelemetryExceptionService.findBy({
+            query: query,
+            select: {
+                _id: true,
+                message: true,
+                exceptionType: true,
+                fingerprint: true,
+                occuranceCount: true,
+                firstSeenAt: true,
+                lastSeenAt: true,
+                isResolved: true,
+            },
+            sort: {
+                occuranceCount: SortOrder.Descending,
+            },
+            limit: limit,
+            skip: 0,
+            props: ctx.props,
+        });
+        const rows = exceptions.map((exception) => {
+            var _a;
+            return {
+                id: (_a = exception.id) === null || _a === void 0 ? void 0 : _a.toString(),
+                type: exception.exceptionType,
+                message: exception.message,
+                occurrences: exception.occuranceCount,
+                firstSeenAt: exception.firstSeenAt,
+                lastSeenAt: exception.lastSeenAt,
+                isResolved: exception.isResolved,
+                fingerprint: exception.fingerprint,
+            };
+        });
+        const serialized = ToolResultSerializer.serializeRows(rows);
+        return {
+            dataForLlm: serialized.text,
+            rowCount: serialized.rowCount,
+            citationLabel: `Top exceptions, last ${lastSeenWithinHours}h (${serialized.rowCount} found)`,
+            citationTarget: {
+                type: AIChatCitationTargetType.Exceptions,
+            },
+            redactionCount: serialized.redactionCount,
+            isTruncated: serialized.isTruncated,
+            widget: rows.length > 0
+                ? WidgetBuilder.exceptionList({
+                    title: `Top exceptions (${rows.length})`,
+                    description: `Last ${lastSeenWithinHours}h, by occurrence count`,
+                    items: rows,
+                    link: { type: AIChatCitationTargetType.Exceptions },
+                })
+                : undefined,
+        };
+    },
+};
+//# sourceMappingURL=ExceptionTools.js.map

package/build/dist/Server/Utils/AI/Toolbox/ExceptionTools.js.map

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