@oneuptime/common 11.3.25 → 11.3.28

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

@@ -0,0 +1,153 @@
+import { PermissionHelper, } from "../../../../Types/Permission";
+import DatabaseCommonInteractionPropsUtil, { PermissionType, } from "../../../../Types/BaseDatabase/DatabaseCommonInteractionPropsUtil";
+import logger from "../../Logger";
+import { QueryIncidentsTool, SearchIncidentsTool } from "./IncidentTools";
+import { QueryAlertsTool } from "./AlertTools";
+import { QueryMonitorsTool } from "./MonitorTools";
+import { TopExceptionsTool } from "./ExceptionTools";
+import { LogHistogramTool, SearchLogsTool } from "./LogTools";
+import { RecentChangesTool } from "./RecentChangesTools";
+import { QueryMetricsTool } from "./MetricTools";
+import { GetTraceTool, QueryTracesTool } from "./TraceTools";
+import { LookupContextTool } from "./ContextTools";
+import { AcknowledgeIncidentTool, CreateIncidentTool, ResolveIncidentTool, } from "./IncidentWriteTools";
+import { AcknowledgeAlertTool, ResolveAlertTool } from "./AlertWriteTools";
+import AIChatPermissionMode from "../../../../Types/AI/AIChatPermissionMode";
+const TOOL_EXECUTION_TIMEOUT_MS = 45 * 1000;
+/*
+ * The curated tool belt for AI features (chat today, the Investigation Engine
+ * later). Read tools wrap an existing deterministic query; write tools mutate
+ * the project (create/acknowledge/resolve). Every tool executes under the
+ * requesting user's permission props, and write tools are additionally gated by
+ * the conversation's permission mode (see ChatAgentRunner).
+ */
+class AIToolbox {
+    static getTools() {
+        return this.tools;
+    }
+    static getToolByName(name) {
+        return this.tools.find((tool) => {
+            return tool.name === name;
+        });
+    }
+    static isMutationTool(name) {
+        const tool = this.getToolByName(name);
+        return Boolean(tool === null || tool === void 0 ? void 0 : tool.isMutation);
+    }
+    /*
+     * The tool definitions offered to the model for a given permission mode. In
+     * ReadOnly mode the mutating tools are withheld entirely, so the model never
+     * even proposes an action it isn't allowed to take.
+     */
+    static getLlmToolDefinitions(mode) {
+        const cached = this.llmToolDefinitionsByMode.get(mode);
+        if (cached) {
+            return cached;
+        }
+        const includeMutations = mode !== AIChatPermissionMode.ReadOnly;
+        const definitions = this.tools
+            .filter((tool) => {
+            return includeMutations || !tool.isMutation;
+        })
+            .map((tool) => {
+            return {
+                name: tool.name,
+                description: tool.description,
+                inputSchema: tool.inputSchema,
+            };
+        });
+        this.llmToolDefinitionsByMode.set(mode, definitions);
+        return definitions;
+    }
+    static hasPermissionForTool(tool, ctx) {
+        if (ctx.props.isRoot || ctx.props.isMasterAdmin) {
+            return true;
+        }
+        /*
+         * Fail closed on block permissions: if any of the tool's permissions is
+         * block-listed for this user, deny the tool outright. This is coarser
+         * than the label-scoped block filtering the model layer applies, but the
+         * raw-SQL aggregation tools have no model layer — this gate is their
+         * only authorization.
+         */
+        const blockedPermissions = DatabaseCommonInteractionPropsUtil.getUserPermissions(ctx.props, PermissionType.Block).map((userPermission) => {
+            return userPermission.permission;
+        });
+        if (PermissionHelper.doesPermissionsIntersect(blockedPermissions, tool.requiredPermissions)) {
+            return false;
+        }
+        const userPermissions = DatabaseCommonInteractionPropsUtil.getUserPermissions(ctx.props, PermissionType.Allow).map((userPermission) => {
+            return userPermission.permission;
+        });
+        return PermissionHelper.doesPermissionsIntersect(userPermissions, tool.requiredPermissions);
+    }
+    static async executeTool(data) {
+        const tool = this.getToolByName(data.name);
+        if (!tool) {
+            return {
+                success: false,
+                textForLlm: `Error: unknown tool "${data.name}". Available tools: ${this.tools
+                    .map((availableTool) => {
+                    return availableTool.name;
+                })
+                    .join(", ")}.`,
+                errorMessage: `Unknown tool: ${data.name}`,
+            };
+        }
+        if (!this.hasPermissionForTool(tool, data.ctx)) {
+            return {
+                success: false,
+                textForLlm: `Error: the current user does not have permission to use ${data.name}. Answer with the data you already have, and tell the user which permission is missing.`,
+                errorMessage: `Permission denied for tool: ${data.name}`,
+            };
+        }
+        try {
+            const result = await Promise.race([
+                tool.execute(data.args, data.ctx),
+                new Promise((_resolve, reject) => {
+                    setTimeout(() => {
+                        reject(new Error("Tool execution timed out."));
+                    }, TOOL_EXECUTION_TIMEOUT_MS);
+                }),
+            ]);
+            return {
+                success: true,
+                textForLlm: result.dataForLlm,
+                result: result,
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            logger.error(`AI toolbox tool ${data.name} failed: ${message}`);
+            return {
+                success: false,
+                textForLlm: `Error executing ${data.name}: ${message}. Adjust the arguments and try again, or answer with the data you already have.`,
+                errorMessage: message,
+            };
+        }
+    }
+}
+AIToolbox.tools = [
+    LookupContextTool,
+    QueryIncidentsTool,
+    SearchIncidentsTool,
+    QueryAlertsTool,
+    QueryMonitorsTool,
+    TopExceptionsTool,
+    SearchLogsTool,
+    LogHistogramTool,
+    QueryMetricsTool,
+    QueryTracesTool,
+    GetTraceTool,
+    RecentChangesTool,
+    // Write tools (mutations). Gated by conversation permission mode.
+    CreateIncidentTool,
+    AcknowledgeIncidentTool,
+    ResolveIncidentTool,
+    AcknowledgeAlertTool,
+    ResolveAlertTool,
+];
+// LLM tool definitions cached per permission mode (ReadOnly hides mutations).
+AIToolbox.llmToolDefinitionsByMode = new Map();
+export default AIToolbox;
+//# sourceMappingURL=Index.js.map

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

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

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

@@ -0,0 +1,246 @@
+import Log from "../../../../Models/AnalyticsModels/Log";
+import DatabaseRequestType from "../../../Types/BaseDatabase/DatabaseRequestType";
+import ModelPermission from "../../../Types/AnalyticsDatabase/ModelPermission";
+import InBetween from "../../../../Types/BaseDatabase/InBetween";
+import Includes from "../../../../Types/BaseDatabase/Includes";
+import Search from "../../../../Types/BaseDatabase/Search";
+import SortOrder from "../../../../Types/BaseDatabase/SortOrder";
+import Permission from "../../../../Types/Permission";
+import { AIChatCitationTargetType, } from "../../../../Types/AI/AIChatTypes";
+import LogService from "../../../Services/LogService";
+import LogAggregationService from "../../../Services/LogAggregationService";
+import ToolResultSerializer from "./Serializer";
+import WidgetBuilder from "./WidgetBuilder";
+import { TimeRangeSchemaProperties, ToolArgs, } from "./ToolTypes";
+// Keep pivoted histogram rows under the serializer's 50-row cap.
+const MAX_HISTOGRAM_BUCKETS = 48;
+const LOG_READ_PERMISSIONS = [
+    Permission.ProjectOwner,
+    Permission.ProjectAdmin,
+    Permission.ProjectMember,
+    Permission.Viewer,
+    Permission.TelemetryAdmin,
+    Permission.TelemetryMember,
+    Permission.TelemetryViewer,
+    Permission.ReadTelemetryServiceLog,
+];
+export const SearchLogsTool = {
+    name: "search_logs",
+    description: "Search raw log lines. Filter by time range, severity, body text, trace ID or service. Returns the most recent matching lines. Always pass an explicit time range when investigating a specific window.",
+    inputSchema: {
+        type: "object",
+        properties: Object.assign(Object.assign({}, TimeRangeSchemaProperties), { severityTexts: {
+                type: "array",
+                items: { type: "string" },
+                description: 'Filter by severity, e.g. ["Error", "Fatal"] or ["Warn"].',
+            }, bodySearchText: {
+                type: "string",
+                description: "Only logs whose body contains this text.",
+            }, traceId: {
+                type: "string",
+                description: "Only logs belonging to this trace.",
+            }, serviceId: {
+                type: "string",
+                description: "Only logs from this telemetry service (resolve names via lookup_context first).",
+            }, limit: {
+                type: "number",
+                description: "Maximum log lines to return (default 25, max 50).",
+            } }),
+    },
+    requiredPermissions: LOG_READ_PERMISSIONS,
+    execute: async (args, ctx) => {
+        const { startTime, endTime } = ToolArgs.getTimeRange(args, {
+            defaultHours: 1,
+            maxDays: 30,
+        });
+        const limit = ToolArgs.getNumber(args, "limit", {
+            defaultValue: 25,
+            min: 1,
+            max: 50,
+        });
+        const query = {
+            time: new InBetween(startTime, endTime),
+        };
+        const severityTexts = ToolArgs.getStringArray(args, "severityTexts");
+        if (severityTexts) {
+            query["severityText"] = new Includes(severityTexts);
+        }
+        const bodySearchText = ToolArgs.getString(args, "bodySearchText");
+        if (bodySearchText) {
+            query["body"] = new Search(bodySearchText);
+        }
+        const traceId = ToolArgs.getString(args, "traceId");
+        if (traceId) {
+            query["traceId"] = traceId;
+        }
+        const serviceId = ToolArgs.getObjectID(args, "serviceId");
+        if (serviceId) {
+            query["primaryEntityId"] = serviceId;
+        }
+        const logs = await LogService.findBy({
+            query: query,
+            select: {
+                time: true,
+                severityText: true,
+                body: true,
+                traceId: true,
+                spanId: true,
+                primaryEntityId: true,
+            },
+            sort: {
+                time: SortOrder.Descending,
+            },
+            limit: limit,
+            skip: 0,
+            props: ctx.props,
+        });
+        const rows = logs.map((log) => {
+            return {
+                time: log.time,
+                severity: log.severityText,
+                body: log.body,
+                traceId: log.traceId,
+                spanId: log.spanId,
+            };
+        });
+        const serialized = ToolResultSerializer.serializeRows(rows);
+        const logsLink = {
+            type: AIChatCitationTargetType.Logs,
+        };
+        return {
+            dataForLlm: serialized.text,
+            rowCount: serialized.rowCount,
+            citationLabel: `Logs ${startTime.toISOString()} – ${endTime.toISOString()} (${serialized.rowCount} shown)`,
+            citationTarget: logsLink,
+            redactionCount: serialized.redactionCount,
+            isTruncated: serialized.isTruncated,
+            widget: rows.length > 0
+                ? WidgetBuilder.table({
+                    title: `Logs (${rows.length})`,
+                    description: `${startTime.toISOString()} – ${endTime.toISOString()}`,
+                    columns: [
+                        { key: "time", title: "Time", type: "date" },
+                        { key: "severity", title: "Severity", type: "text" },
+                        { key: "body", title: "Message", type: "text" },
+                        { key: "traceId", title: "Trace", type: "text" },
+                    ],
+                    rows: rows,
+                    link: logsLink,
+                })
+                : undefined,
+        };
+    },
+};
+export const LogHistogramTool = {
+    name: "log_histogram",
+    description: "Get log volume over time, split by severity. Use this to spot error spikes and quiet periods before drilling into raw logs.",
+    inputSchema: {
+        type: "object",
+        properties: Object.assign(Object.assign({}, TimeRangeSchemaProperties), { severityTexts: {
+                type: "array",
+                items: { type: "string" },
+                description: "Filter to these severities before bucketing.",
+            }, bodySearchText: {
+                type: "string",
+                description: "Only count logs whose body contains this text.",
+            }, serviceId: {
+                type: "string",
+                description: "Only logs from this telemetry service.",
+            } }),
+    },
+    requiredPermissions: LOG_READ_PERMISSIONS,
+    execute: async (args, ctx) => {
+        const { startTime, endTime } = ToolArgs.getTimeRange(args, {
+            defaultHours: 24,
+            maxDays: 30,
+        });
+        const windowMinutes = (endTime.getTime() - startTime.getTime()) / (60 * 1000);
+        /*
+         * Bound the number of time buckets. getHistogram returns one row per
+         * (bucket, severity); after we pivot to one row per bucket that is at most
+         * MAX_HISTOGRAM_BUCKETS rows, which stays under the serializer's row cap so
+         * the most recent buckets are never dropped (spike detection reads the tail
+         * of the window).
+         */
+        const bucketSizeInMinutes = Math.max(1, Math.ceil(windowMinutes / MAX_HISTOGRAM_BUCKETS));
+        const serviceId = ToolArgs.getObjectID(args, "serviceId");
+        /*
+         * getHistogram builds raw aggregation SQL and skips the model layer's
+         * owned-scope filter, so a label-restricted user would otherwise see
+         * project-wide volume. Constrain to the services this user may read.
+         */
+        const accessibleServiceIds = await ModelPermission.getAccessibleServiceIdsForAnalyticsModel(Log, ctx.props, DatabaseRequestType.Read);
+        const buckets = await LogAggregationService.getHistogram({
+            projectId: ctx.projectId,
+            startTime: startTime,
+            endTime: endTime,
+            bucketSizeInMinutes: bucketSizeInMinutes,
+            severityTexts: ToolArgs.getStringArray(args, "severityTexts"),
+            bodySearchText: ToolArgs.getString(args, "bodySearchText"),
+            serviceIds: ToolArgs.scopeServiceIds(accessibleServiceIds, serviceId),
+        });
+        /*
+         * Pivot (time, severity, count) rows into one row per time bucket with a
+         * column per severity, e.g. "time=… | Error=12 | Warn=3". This is both more
+         * compact for the model and collapses the row count from
+         * buckets×severities down to just buckets.
+         */
+        const rowsByTime = new Map();
+        for (const bucket of buckets) {
+            let row = rowsByTime.get(bucket.time);
+            if (!row) {
+                row = { time: bucket.time };
+                rowsByTime.set(bucket.time, row);
+            }
+            row[bucket.severity || "Unspecified"] = bucket.count;
+        }
+        const rows = Array.from(rowsByTime.values()).sort((a, b) => {
+            return String(a["time"]).localeCompare(String(b["time"]));
+        });
+        const serialized = ToolResultSerializer.serializeRows(rows);
+        /*
+         * Pivot the per-bucket rows into one series per severity so the widget can
+         * render a stacked bar chart (Error on top of Warn on top of Info, etc).
+         */
+        const severityKeys = Array.from(new Set(rows.flatMap((row) => {
+            return Object.keys(row).filter((key) => {
+                return key !== "time";
+            });
+        })));
+        const series = severityKeys.map((severity) => {
+            return {
+                name: severity,
+                points: rows.map((row) => {
+                    return {
+                        x: String(row["time"]),
+                        y: typeof row[severity] === "number"
+                            ? row[severity]
+                            : 0,
+                    };
+                }),
+            };
+        });
+        return {
+            dataForLlm: serialized.text,
+            rowCount: serialized.rowCount,
+            citationLabel: `Log volume by severity, ${startTime.toISOString()} – ${endTime.toISOString()}`,
+            citationTarget: {
+                type: AIChatCitationTargetType.Logs,
+            },
+            redactionCount: serialized.redactionCount,
+            isTruncated: serialized.isTruncated,
+            widget: series.length > 0 && rows.length > 0
+                ? WidgetBuilder.bars({
+                    title: "Log volume by severity",
+                    description: `${startTime.toISOString()} – ${endTime.toISOString()}`,
+                    series: series,
+                    stacked: true,
+                    xIsTime: true,
+                    unit: "logs",
+                    link: { type: AIChatCitationTargetType.Logs },
+                })
+                : undefined,
+        };
+    },
+};
+//# sourceMappingURL=LogTools.js.map

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

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

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

@@ -0,0 +1,120 @@
+import AggregationType from "../../../../Types/BaseDatabase/AggregationType";
+import InBetween from "../../../../Types/BaseDatabase/InBetween";
+import Permission from "../../../../Types/Permission";
+import BadDataException from "../../../../Types/Exception/BadDataException";
+import { AIChatCitationTargetType, } from "../../../../Types/AI/AIChatTypes";
+import MetricService from "../../../Services/MetricService";
+import ToolResultSerializer from "./Serializer";
+import WidgetBuilder from "./WidgetBuilder";
+import OneUptimeDate from "../../../../Types/Date";
+import { TimeRangeSchemaProperties, ToolArgs, } from "./ToolTypes";
+/*
+ * Note: metric read access is gated on ReadTelemetryServiceTraces — this
+ * mirrors the guard on the dashboard's /telemetry/metrics/* routes.
+ */
+const METRIC_READ_PERMISSIONS = [
+    Permission.ProjectOwner,
+    Permission.ProjectAdmin,
+    Permission.ProjectMember,
+    Permission.Viewer,
+    Permission.TelemetryAdmin,
+    Permission.TelemetryMember,
+    Permission.TelemetryViewer,
+    Permission.ReadTelemetryServiceTraces,
+];
+export const QueryMetricsTool = {
+    name: "query_metrics",
+    description: "Aggregate a metric over time: Avg, Max, Min, Sum, Count or P50/P90/P95/P99 percentiles (histogram-aware). Requires the exact metric name — discover names via lookup_context. Monitor metrics use reserved names like oneuptime.monitor.response.time with the monitor's ID as entityId.",
+    inputSchema: {
+        type: "object",
+        properties: Object.assign(Object.assign({}, TimeRangeSchemaProperties), { metricName: {
+                type: "string",
+                description: "Exact metric name (required).",
+            }, aggregationType: {
+                type: "string",
+                enum: ["Avg", "Max", "Min", "Sum", "Count", "P50", "P90", "P95", "P99"],
+                description: "How to aggregate (default Avg).",
+            }, entityId: {
+                type: "string",
+                description: "Only data points from this service/host/monitor (its OneUptime ID).",
+            } }),
+        required: ["metricName"],
+    },
+    requiredPermissions: METRIC_READ_PERMISSIONS,
+    execute: async (args, ctx) => {
+        const metricName = ToolArgs.getString(args, "metricName");
+        if (!metricName) {
+            throw new BadDataException("metricName is required. Use lookup_context with type 'metricNames' to discover metric names.");
+        }
+        const { startTime, endTime } = ToolArgs.getTimeRange(args, {
+            defaultHours: 24,
+            maxDays: 30,
+        });
+        const aggregationTypeString = ToolArgs.getString(args, "aggregationType") || "Avg";
+        if (!Object.values(AggregationType).includes(aggregationTypeString)) {
+            throw new BadDataException(`Invalid aggregationType: ${aggregationTypeString}`);
+        }
+        /*
+         * The time filter must be part of the query's WHERE clause. aggregateBy's
+         * startTimestamp/endTimestamp only define the bucket grid — without an
+         * explicit `time` filter the percentile/aggregate scans the metric's whole
+         * retention and mixes in data outside the requested window.
+         */
+        const query = {
+            name: metricName,
+            time: new InBetween(startTime, endTime),
+        };
+        const entityId = ToolArgs.getObjectID(args, "entityId");
+        if (entityId) {
+            query["primaryEntityId"] = entityId;
+        }
+        const aggregateBy = {
+            aggregateColumnName: "value",
+            aggregationType: aggregationTypeString,
+            aggregationTimestampColumnName: "time",
+            startTimestamp: startTime,
+            endTimestamp: endTime,
+            query: query,
+            limit: 200,
+            skip: 0,
+            props: ctx.props,
+        };
+        const result = await MetricService.aggregateBy(aggregateBy);
+        const rows = result.data.map((item) => {
+            return {
+                timestamp: item.timestamp,
+                value: item.value,
+            };
+        });
+        const serialized = ToolResultSerializer.serializeRows(rows);
+        const points = result.data.map((item) => {
+            return {
+                x: OneUptimeDate.toString(OneUptimeDate.fromString(item.timestamp)),
+                y: typeof item.value === "number" ? item.value : null,
+            };
+        });
+        const seriesName = entityId
+            ? `${aggregationTypeString}(${metricName}) · ${entityId.toString()}`
+            : `${aggregationTypeString}(${metricName})`;
+        return {
+            dataForLlm: serialized.text,
+            rowCount: serialized.rowCount,
+            citationLabel: `${aggregationTypeString}(${metricName}), ${startTime.toISOString()} – ${endTime.toISOString()}`,
+            citationTarget: {
+                type: AIChatCitationTargetType.Metrics,
+            },
+            redactionCount: serialized.redactionCount,
+            isTruncated: serialized.isTruncated,
+            widget: points.length > 0
+                ? WidgetBuilder.timeSeries({
+                    title: `${aggregationTypeString} of ${metricName}`,
+                    description: `${startTime.toISOString()} – ${endTime.toISOString()}`,
+                    series: [{ name: seriesName, points: points }],
+                    valueLabel: aggregationTypeString,
+                    link: { type: AIChatCitationTargetType.Metrics },
+                })
+                : undefined,
+        };
+    },
+};
+//# sourceMappingURL=MetricTools.js.map

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

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