@oneuptime/common 11.3.24 → 11.3.26

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":"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"}

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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"}

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

@@ -0,0 +1,167 @@
+import Incident from "../../../../Models/DatabaseModels/Incident";
+import SortOrder from "../../../../Types/BaseDatabase/SortOrder";
+import { AIChatCitationTargetType } from "../../../../Types/AI/AIChatTypes";
+import IncidentService from "../../../Services/IncidentService";
+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 Incident 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 Incident().getReadPermissions();
+    }
+    return cachedReadPermissions;
+};
+export const QueryIncidentsTool = {
+    name: "query_incidents",
+    description: "Query incidents in this project. Returns the most recent incidents with their current state and severity. Pass incidentId to get full details of one incident.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            incidentId: {
+                type: "string",
+                description: "Get one incident by its ID (includes description).",
+            },
+            createdWithinHours: {
+                type: "number",
+                description: "Only incidents created within this many hours (default 168 = 7 days, max 720).",
+            },
+            limit: {
+                type: "number",
+                description: "Maximum incidents to return (default 10, max 25).",
+            },
+        },
+    },
+    get requiredPermissions() {
+        return resolveReadPermissions();
+    },
+    execute: async (args, ctx) => {
+        var _a, _b, _c, _d;
+        const incidentId = ToolArgs.getObjectID(args, "incidentId");
+        if (incidentId) {
+            const incident = await IncidentService.findOneById({
+                id: incidentId,
+                select: {
+                    _id: true,
+                    title: true,
+                    description: true,
+                    incidentNumber: true,
+                    createdAt: true,
+                    currentIncidentState: {
+                        name: true,
+                    },
+                    incidentSeverity: {
+                        name: true,
+                    },
+                },
+                props: ctx.props,
+            });
+            const rows = incident
+                ? [
+                    {
+                        id: (_a = incident.id) === null || _a === void 0 ? void 0 : _a.toString(),
+                        incidentNumber: incident.incidentNumber,
+                        title: incident.title,
+                        description: incident.description,
+                        state: (_b = incident.currentIncidentState) === null || _b === void 0 ? void 0 : _b.name,
+                        severity: (_c = incident.incidentSeverity) === null || _c === void 0 ? void 0 : _c.name,
+                        createdAt: incident.createdAt,
+                    },
+                ]
+                : [];
+            const serialized = ToolResultSerializer.serializeRows(rows);
+            return {
+                dataForLlm: serialized.text,
+                rowCount: serialized.rowCount,
+                citationLabel: `Incident ${(incident === null || incident === void 0 ? void 0 : incident.incidentNumber) ? `#${incident.incidentNumber}` : incidentId.toString()}`,
+                citationTarget: {
+                    type: AIChatCitationTargetType.IncidentView,
+                    params: { incidentId: incidentId.toString() },
+                },
+                redactionCount: serialized.redactionCount,
+                isTruncated: serialized.isTruncated,
+                widget: rows.length > 0
+                    ? WidgetBuilder.incidentList({
+                        title: `Incident #${(_d = incident === null || incident === void 0 ? void 0 : incident.incidentNumber) !== null && _d !== void 0 ? _d : ""}`.trim(),
+                        items: rows,
+                        link: {
+                            type: AIChatCitationTargetType.IncidentView,
+                            params: { incidentId: incidentId.toString() },
+                        },
+                    })
+                    : undefined,
+            };
+        }
+        const createdWithinHours = ToolArgs.getNumber(args, "createdWithinHours", { defaultValue: 168, 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 incidents = await IncidentService.findBy({
+            query: {
+                createdAt: QueryHelper.inBetween(startTime, endTime),
+            },
+            select: {
+                _id: true,
+                title: true,
+                incidentNumber: true,
+                createdAt: true,
+                currentIncidentState: {
+                    name: true,
+                },
+                incidentSeverity: {
+                    name: true,
+                },
+            },
+            sort: {
+                createdAt: SortOrder.Descending,
+            },
+            limit: limit,
+            skip: 0,
+            props: ctx.props,
+        });
+        const rows = incidents.map((incident) => {
+            var _a, _b, _c;
+            return {
+                id: (_a = incident.id) === null || _a === void 0 ? void 0 : _a.toString(),
+                incidentNumber: incident.incidentNumber,
+                title: incident.title,
+                state: (_b = incident.currentIncidentState) === null || _b === void 0 ? void 0 : _b.name,
+                severity: (_c = incident.incidentSeverity) === null || _c === void 0 ? void 0 : _c.name,
+                createdAt: incident.createdAt,
+            };
+        });
+        const serialized = ToolResultSerializer.serializeRows(rows);
+        return {
+            dataForLlm: serialized.text,
+            rowCount: serialized.rowCount,
+            citationLabel: `Incidents, last ${createdWithinHours}h (${serialized.rowCount} found)`,
+            citationTarget: {
+                type: AIChatCitationTargetType.Incidents,
+            },
+            redactionCount: serialized.redactionCount,
+            isTruncated: serialized.isTruncated,
+            widget: rows.length > 0
+                ? WidgetBuilder.incidentList({
+                    title: `Incidents (${rows.length})`,
+                    description: `Created in the last ${createdWithinHours}h`,
+                    items: rows,
+                    link: { type: AIChatCitationTargetType.Incidents },
+                })
+                : undefined,
+        };
+    },
+};
+//# sourceMappingURL=IncidentTools.js.map

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

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