@marinoscar/platform-contract 0.0.0-stage → 0.1.0-next.4

package/dist/cjs/telemetry/constants.js

@@ -0,0 +1,685 @@
+"use strict";
+// The telemetry slice's plain values (issue #702). Zod-free by rule: a browser
+// that only needs a limit, an enum list or a type never pulls the schemas, and
+// with them zod, into its bundle (test/no-zod-in-constants.test.ts).
+//
+// Every number and list here is the one the schemas validate with: the
+// schemas import them, so a limit cannot drift between what the API enforces
+// and what the web form offers. Moved verbatim from the API's DTO files and
+// the web's hand-written mirrors; no value changed.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TELEMETRY_ASSISTANT_TOOL_NAME_PATTERN = exports.TELEMETRY_ASSISTANT_TOOLS = exports.BUILTIN_TELEMETRY_ASSISTANT_TOOLS = exports.TELEMETRY_ASSISTANT_TURN_ROLES = exports.TELEMETRY_ASSISTANT_HISTORY_CONTENT_MAX = exports.TELEMETRY_ASSISTANT_HISTORY_MAX_TURNS = exports.TELEMETRY_ASSISTANT_QUESTION_MAX = exports.PLATFORM_METRIC_PRESENTATIONS = exports.PLATFORM_METRIC_GROUPS = exports.METRIC_GROUP_ID_PATTERN = exports.PRESENTATION_COLUMN_DISPLAYS = exports.PRESENTATION_TABLE_SORTS = exports.VIRTUAL_COLUMN_EXPRESSIONS = exports.PRESENTATION_COLOR_TOKENS = exports.METRIC_PRESENTATION_LIMITS = exports.METRIC_UNIT_FORMATS = exports.METRIC_UNIT_ID_PATTERN = exports.METRIC_UNITS = exports.BUILTIN_METRIC_UNITS = exports.VERDICT_LEVELS = exports.DASHBOARD_TOP_KINDS = exports.DASHBOARD_PANEL_PAYLOAD_MAX_BYTES = exports.DASHBOARD_PANEL_ID_PATTERN = exports.DASHBOARD_PANELS = exports.DASHBOARD_EVENT_SEVERITIES = exports.DASHBOARD_SEARCH_MAX_LENGTH = exports.DASHBOARD_CURSOR_MAX = exports.DASHBOARD_FILTER_VALUE_MAX = exports.DASHBOARD_BUCKET_COUNTS = exports.DASHBOARD_FUTURE_SKEW_MS = exports.DASHBOARD_MAX_SPAN_MS = exports.DEFAULT_DASHBOARD_RANGE = exports.DASHBOARD_RANGE_MS = exports.DASHBOARD_RANGES = exports.TELEMETRY_STACK_DEPLOY_STATUSES = exports.TELEMETRY_STACK_SERVICE_HEALTH = exports.TELEMETRY_STACK_SERVICE_STATES = exports.TELEMETRY_STACK_AGENT_STATES = exports.TELEMETRY_HOSTNAME_PATTERN = exports.TELEMETRY_DATABASE_PATTERN = exports.TELEMETRY_CONNECTION_DEFAULTS = exports.TELEMETRY_CONNECTION_HOST_MODES = exports.TELEMETRY_CONNECTION_SOURCES = exports.TELEMETRY_EXPORT_FORMATS = exports.TELEMETRY_SEMANTIC_TYPES = exports.TELEMETRY_COLUMN_TYPES = exports.TELEMETRY_QUERY_MAX_ROWS_CEILING = exports.TELEMETRY_SQL_MAX_LENGTH = exports.TELEMETRY_LIMITS = exports.TELEMETRY_INSTANCE_ID_PATTERN = void 0;
+exports.TELEMETRY_ASSISTANT_CONFIDENCES = exports.TELEMETRY_ASSISTANT_SEVERITIES = exports.TELEMETRY_ASSISTANT_REPORT_STATUSES = exports.TELEMETRY_ASSISTANT_EXTRA_INSTRUCTIONS_MAX = void 0;
+// =============================================================================
+// Settings (`telemetry` system-settings namespace)
+// =============================================================================
+/**
+ * `telemetry.instanceId`: 1-63 characters, lowercase letters, digits, `.`,
+ * `_` or `-`, starting with a letter or digit (a DNS label's bound, valid
+ * unquoted in a PromQL matcher and a SQL literal alike).
+ *
+ * @stability stable
+ */
+exports.TELEMETRY_INSTANCE_ID_PATTERN = /^[a-z0-9][a-z0-9._-]{0,62}$/;
+/**
+ * The inclusive bounds of every numeric `telemetry` setting:
+ * `retentionDays`, `query.maxRows`, `query.timeoutSeconds`,
+ * `assistant.maxResultRowsToModel` and `assistant.maxSteps`. The settings
+ * schema is built from these numbers.
+ *
+ * @stability stable
+ */
+exports.TELEMETRY_LIMITS = {
+    /** `retentionDays`, in days. */
+    retentionDays: {
+        /** Fewest accepted. */
+        min: 1,
+        /** Most accepted. */
+        max: 3650,
+    },
+    /** `query.maxRows`, in rows. */
+    maxRows: {
+        /** Fewest accepted. */
+        min: 1,
+        /** Most accepted. */
+        max: 100000,
+    },
+    /** `query.timeoutSeconds`, in seconds. */
+    timeoutSeconds: {
+        /** Fewest accepted. */
+        min: 1,
+        /** Most accepted. */
+        max: 120,
+    },
+    /** `assistant.maxResultRowsToModel`, in rows. */
+    maxResultRowsToModel: {
+        /** Fewest accepted. */
+        min: 1,
+        /** Most accepted. */
+        max: 100,
+    },
+    /** `assistant.maxSteps`, in tool-call rounds (the AI runtime's own loop ceiling). */
+    maxSteps: {
+        /** Fewest accepted. */
+        min: 1,
+        /** Most accepted. */
+        max: 20,
+    },
+};
+// =============================================================================
+// Explorer (`/api/admin/telemetry/query`, `/schema`, `/export`)
+// =============================================================================
+/**
+ * The longest SQL text `POST /api/admin/telemetry/query` and `/export`
+ * accept. Telemetry queries are hand-written or model-written, never
+ * generated in bulk.
+ *
+ * @stability stable
+ */
+exports.TELEMETRY_SQL_MAX_LENGTH = 20_000;
+/**
+ * The absolute ceiling a query's `maxRows` may ask for; the
+ * `telemetry.query.maxRows` setting clamps it further.
+ *
+ * @stability stable
+ */
+exports.TELEMETRY_QUERY_MAX_ROWS_CEILING = 100_000;
+/**
+ * The simplified PostgreSQL-wire type of a query result column. `int8` and
+ * `numeric` values arrive as strings, `timestamp`/`date`/`time` as the
+ * server's text, `json` parsed and `bytea` as base64.
+ *
+ * @stability stable
+ */
+exports.TELEMETRY_COLUMN_TYPES = [
+    'bool',
+    'int2',
+    'int4',
+    'int8',
+    'float4',
+    'float8',
+    'numeric',
+    'text',
+    'bytea',
+    'date',
+    'time',
+    'timestamp',
+    'json',
+    'unknown',
+];
+/**
+ * GreptimeDB's role for a schema column, as `GET /api/admin/telemetry/schema`
+ * reports it in `semanticType` (which is typed as a string on the wire).
+ *
+ * @stability stable
+ */
+exports.TELEMETRY_SEMANTIC_TYPES = ['TAG', 'FIELD', 'TIMESTAMP'];
+/**
+ * The formats `POST /api/admin/telemetry/export` produces, in the order the
+ * wire enum has always listed them. A menu that wants another order keeps its
+ * own display list over this one.
+ *
+ * @stability stable
+ */
+exports.TELEMETRY_EXPORT_FORMATS = ['csv', 'ndjson', 'xlsx', 'parquet'];
+// =============================================================================
+// GreptimeDB connection (`/api/admin/telemetry/connection`)
+// =============================================================================
+/**
+ * Where the connection in force comes from: `stored` (saved on the admin
+ * page), `environment` (the deployment's own GreptimeDB) or `none`.
+ *
+ * @stability stable
+ */
+exports.TELEMETRY_CONNECTION_SOURCES = ['stored', 'environment', 'none'];
+/**
+ * `auto`: the GreptimeDB deployed with the application; `custom`: a host an
+ * administrator chose.
+ *
+ * @stability stable
+ */
+exports.TELEMETRY_CONNECTION_HOST_MODES = ['auto', 'custom'];
+/**
+ * GreptimeDB's Postgres-wire port and database when nothing says otherwise:
+ * what a custom connection that omits them gets.
+ *
+ * @stability stable
+ */
+exports.TELEMETRY_CONNECTION_DEFAULTS = {
+    /** GreptimeDB's Postgres-wire default port. */
+    pgPort: 4003,
+    /** GreptimeDB's default database. */
+    database: 'public',
+};
+/**
+ * A connection's database name: a plain identifier, because retention
+ * interpolates it unquoted into `ALTER DATABASE`.
+ *
+ * @stability stable
+ */
+exports.TELEMETRY_DATABASE_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;
+/**
+ * A connection's hostname: RFC 1123 labels, plus `_` (Docker Compose service
+ * names use it). No scheme, port or path. An IP address is accepted
+ * separately.
+ *
+ * @stability stable
+ */
+exports.TELEMETRY_HOSTNAME_PATTERN = /^[A-Za-z0-9_](?:[A-Za-z0-9_-]{0,61}[A-Za-z0-9_])?(?:\.[A-Za-z0-9_](?:[A-Za-z0-9_-]{0,61}[A-Za-z0-9_])?)*$/;
+// =============================================================================
+// Telemetry services (`/api/admin/telemetry/stack`)
+// =============================================================================
+/**
+ * Whether the API can reach the deployment agent that manages the telemetry
+ * containers: `available`, `unavailable` (configured, not reachable),
+ * `unauthorized` (it refused the API's token) or `not_configured`.
+ *
+ * @stability stable
+ */
+exports.TELEMETRY_STACK_AGENT_STATES = ['available', 'unavailable', 'unauthorized', 'not_configured'];
+/**
+ * A telemetry container's state, as the deployment agent reports it;
+ * `missing` when it has never been created.
+ *
+ * @stability stable
+ */
+exports.TELEMETRY_STACK_SERVICE_STATES = [
+    'running',
+    'restarting',
+    'exited',
+    'created',
+    'paused',
+    'dead',
+    'missing',
+];
+/**
+ * A telemetry container's health check result (absent, `null`, when it has
+ * none or is not running).
+ *
+ * @stability stable
+ */
+exports.TELEMETRY_STACK_SERVICE_HEALTH = ['healthy', 'unhealthy', 'starting'];
+/**
+ * The status of the latest stack deploy job: the queue's own statuses.
+ *
+ * @stability stable
+ */
+exports.TELEMETRY_STACK_DEPLOY_STATUSES = ['pending', 'running', 'succeeded', 'failed'];
+// =============================================================================
+// Dashboard (`/api/admin/telemetry/dashboard/*`)
+// =============================================================================
+/**
+ * The relative windows every dashboard route accepts as `range`.
+ *
+ * @stability stable
+ */
+exports.DASHBOARD_RANGES = ['15m', '1h', '6h', '24h', '7d'];
+/**
+ * The length of each {@link DASHBOARD_RANGES} window, in milliseconds.
+ *
+ * @stability stable
+ */
+exports.DASHBOARD_RANGE_MS = {
+    /** 15 minutes. */
+    '15m': 15 * 60_000,
+    /** 1 hour. */
+    '1h': 60 * 60_000,
+    /** 6 hours. */
+    '6h': 6 * 60 * 60_000,
+    /** 24 hours. */
+    '24h': 24 * 60 * 60_000,
+    /** 7 days. */
+    '7d': 7 * 24 * 60 * 60_000,
+};
+/**
+ * The window a dashboard route reads when the query names none.
+ *
+ * @stability stable
+ */
+exports.DEFAULT_DASHBOARD_RANGE = '1h';
+/**
+ * The longest absolute window (`from` to `to`) a dashboard route accepts: 30 days.
+ *
+ * @stability stable
+ */
+exports.DASHBOARD_MAX_SPAN_MS = 30 * 24 * 60 * 60_000;
+/**
+ * How far past now `to` may be (clock skew between browser and server): 1 minute.
+ *
+ * @stability stable
+ */
+exports.DASHBOARD_FUTURE_SKEW_MS = 60_000;
+/**
+ * The target bucket counts a dashboard route accepts as `buckets` (strings:
+ * every query value arrives as one).
+ *
+ * @stability stable
+ */
+exports.DASHBOARD_BUCKET_COUNTS = ['30', '60'];
+/**
+ * The longest `service`, `instance` or `host` filter value.
+ *
+ * @stability stable
+ */
+exports.DASHBOARD_FILTER_VALUE_MAX = 200;
+/**
+ * The longest `cursor` the events route accepts.
+ *
+ * @stability stable
+ */
+exports.DASHBOARD_CURSOR_MAX = 512;
+/**
+ * The longest `q` (log body search) the events route accepts.
+ *
+ * @stability stable
+ */
+exports.DASHBOARD_SEARCH_MAX_LENGTH = 200;
+/**
+ * The severities the events route filters on, in `severity`'s comma list.
+ *
+ * @stability stable
+ */
+exports.DASHBOARD_EVENT_SEVERITIES = ['error', 'warn', 'info'];
+/**
+ * The `timeseries` route's panels: `api` (status classes, p95) or `logs`
+ * (severity bands).
+ *
+ * @stability stable
+ */
+exports.DASHBOARD_PANELS = ['api', 'logs'];
+/**
+ * The pattern every dashboard panel id matches (`api`, `signups`): a lowercase
+ * letter, then up to 47 lowercase letters, digits, `_` or `-`. The panel set is
+ * open: the platform registers `api` and `logs`, an app registers its own
+ * (`registerDashboardPanel`).
+ *
+ * @stability stable
+ */
+exports.DASHBOARD_PANEL_ID_PATTERN = /^[a-z][a-z0-9_-]{1,47}$/;
+/**
+ * The most bytes a dashboard panel's `payload` may serialise to.
+ *
+ * @stability stable
+ */
+exports.DASHBOARD_PANEL_PAYLOAD_MAX_BYTES = 262_144;
+/**
+ * The `top` route's kinds: `routes` (by 5xx, then 4xx except 401, then p95)
+ * or `errors` (log messages).
+ *
+ * @stability stable
+ */
+exports.DASHBOARD_TOP_KINDS = ['routes', 'errors'];
+/**
+ * The summary's overall verdict levels, in increasing severity, `no_data`
+ * last.
+ *
+ * @stability stable
+ */
+exports.VERDICT_LEVELS = ['healthy', 'degraded', 'critical', 'no_data'];
+/**
+ * The display units the platform registers itself, as the `unit` of metric
+ * tiles, series and table columns (`/metrics`). The live set is the API's unit
+ * registry (`registerMetricUnit`): an app adds its own (`usd`, `tokens`), and
+ * the wire accepts any id matching {@link METRIC_UNIT_ID_PATTERN}.
+ *
+ * @stability stable
+ */
+exports.BUILTIN_METRIC_UNITS = [
+    '%',
+    'bytes',
+    'bytes/s',
+    'count',
+    'per_s',
+    'per_min',
+    'ms',
+    'seconds',
+    'hours',
+    'days',
+    'cores',
+    'load',
+    'timestamp',
+    'text',
+    'boolean',
+];
+/**
+ * The platform's own display units; the same list as
+ * {@link BUILTIN_METRIC_UNITS}, kept under its original name.
+ *
+ * @deprecated Use {@link BUILTIN_METRIC_UNITS}; the unit set is open since an
+ *   app can register its own.
+ * @stability stable
+ */
+exports.METRIC_UNITS = exports.BUILTIN_METRIC_UNITS;
+/**
+ * The pattern every metric unit id matches: a lowercase letter or `%`, then up
+ * to 31 lowercase letters, digits, `_`, `/`, `%` or `-`.
+ *
+ * @stability stable
+ */
+exports.METRIC_UNIT_ID_PATTERN = /^[a-z%][a-z0-9_/%-]{0,31}$/;
+/**
+ * How the web formats a value of a unit: `number` (grouped digits, `decimals`,
+ * `suffix`), `percent`, `bytes` (binary units), `duration-ms`, `duration-s`,
+ * `currency` (ISO 4217 `currency`), and the non-numeric `text`, `boolean` and
+ * `timestamp`.
+ *
+ * @stability stable
+ */
+exports.METRIC_UNIT_FORMATS = [
+    'number',
+    'percent',
+    'bytes',
+    'duration-ms',
+    'duration-s',
+    'currency',
+    'text',
+    'boolean',
+    'timestamp',
+];
+/**
+ * The bounds of a unit descriptor and of a group's presentation. The schemas
+ * are built from these numbers, so what the API enforces is what the web may
+ * rely on.
+ *
+ * @stability stable
+ */
+exports.METRIC_PRESENTATION_LIMITS = {
+    /** The longest unit `label` or `suffix`, in characters. */
+    unitLabel: 40,
+    /** The longest unit `suffix`. */
+    unitSuffix: 12,
+    /** The most fraction digits a unit may ask for. */
+    unitDecimals: 6,
+    /** The longest label, title or status word in a presentation. */
+    label: 80,
+    /** The longest metric, table or column key. */
+    key: 64,
+    /** The most tiles. */
+    tiles: 24,
+    /** The most charts (`series` entries). */
+    charts: 8,
+    /** The most metrics in one chart. */
+    chartMetrics: 8,
+    /** The most colour overrides in one chart. */
+    chartColors: 8,
+    /** The most tables. */
+    tables: 8,
+    /** The most columns in one table. */
+    columns: 24,
+    /** The most virtual columns. */
+    virtualColumns: 8,
+    /** The most options in a table's "Top N" select. */
+    topNOptions: 6,
+    /** The largest N. */
+    topNMax: 500,
+};
+/**
+ * The colours a presentation may name: a STATUS colour (`ok`, `warn`, `crit`,
+ * `info`, `neutral`: what a value means) or a categorical chart SERIES colour
+ * (`series-1` to `series-8`). They are theme tokens (`palette.status`,
+ * `palette.chart.series`), never a CSS colour, so an app restyles them in its
+ * theme and a presentation cannot inject a style.
+ *
+ * @stability stable
+ */
+exports.PRESENTATION_COLOR_TOKENS = [
+    'ok',
+    'warn',
+    'crit',
+    'info',
+    'neutral',
+    'series-1',
+    'series-2',
+    'series-3',
+    'series-4',
+    'series-5',
+    'series-6',
+    'series-7',
+    'series-8',
+];
+/**
+ * The expressions of a virtual table column: `ratio` (`a / b` as a percentage),
+ * `delta` (`a - b`) and `rate` (`a` per second over the window).
+ *
+ * @stability stable
+ */
+exports.VIRTUAL_COLUMN_EXPRESSIONS = ['ratio', 'delta', 'rate'];
+/**
+ * The row orders a presentation may ask of a table: `problems-first` (failing
+ * rows, `up === false` or a flag, before healthy ones) and `value-desc` (the
+ * table's first value column, largest first, rows with no value last; the
+ * order a "Top N" is meant for). Both are stable.
+ *
+ * @stability stable
+ */
+exports.PRESENTATION_TABLE_SORTS = ['problems-first', 'value-desc'];
+/**
+ * How a presentation renders a table cell: `utilization-bar` (a percentage as
+ * a bar), `status` (a boolean as an icon and a word) or `fraction` (`used / total`).
+ *
+ * @stability stable
+ */
+exports.PRESENTATION_COLUMN_DISPLAYS = ['utilization-bar', 'status', 'fraction'];
+/**
+ * The pattern every metric group id matches (lower snake case). Group ids are
+ * an open set: the platform registers six, an app may register more.
+ *
+ * @stability stable
+ */
+exports.METRIC_GROUP_ID_PATTERN = /^[a-z][a-z0-9_]*$/;
+/**
+ * The metric groups the platform itself registers, in dashboard order. The
+ * live set is whatever `GET /api/admin/telemetry/dashboard/metric-groups`
+ * lists.
+ *
+ * @stability stable
+ */
+exports.PLATFORM_METRIC_GROUPS = ['host', 'database', 'queue', 'nodes', 'uptime', 'pipeline'];
+/**
+ * The presentation of the six platform groups, keyed by group id. The
+ * platform's metric-group declarations take theirs from here, and the web falls
+ * back to these when an API does not serve a presentation, so a section looks
+ * the same against any API version.
+ *
+ * @stability experimental
+ */
+exports.PLATFORM_METRIC_PRESENTATIONS = Object.freeze({
+    host: {
+        tiles: [
+            { metric: 'cpuUtilization' },
+            { metric: 'memoryUtilization' },
+            { metric: 'load1m' },
+            { metric: 'filesystemUtilization' },
+        ],
+        series: [{ title: 'CPU and memory utilization', metrics: ['cpuUtilization', 'memoryUtilization'] }],
+        tables: [
+            {
+                metric: 'filesystems',
+                columns: [
+                    { key: 'key' },
+                    { key: 'utilizationPct', display: { kind: 'utilization-bar' } },
+                    { key: 'usedBytes' },
+                    { key: 'freeBytes' },
+                    { key: 'lastSeenAt' },
+                ],
+            },
+        ],
+    },
+    database: {
+        tiles: [{ metric: 'dbConnectionUtilization' }, { metric: 'dbSize' }, { metric: 'dbCommits' }, { metric: 'dbCacheHitRatio' }],
+        series: [{ title: 'Connections and the connection limit', metrics: ['dbConnections', 'dbConnectionMax'] }],
+        tables: [{ metric: 'largestTables', topN: { options: [10, 20, 50, 'all'], default: 10 } }],
+    },
+    queue: {
+        tiles: [
+            { metric: 'queueDepth.pending' },
+            { metric: 'oldestPendingAge' },
+            { metric: 'jobFailureRatio' },
+            { metric: 'jobDurationP95' },
+            { metric: 'backupAge' },
+        ],
+        series: [
+            {
+                title: 'Jobs settled per minute by outcome',
+                metrics: ['jobsSettled'],
+                colors: { succeeded: 'ok', failed: 'crit' },
+            },
+        ],
+        tables: [{ metric: 'jobTypes' }],
+    },
+    nodes: {
+        tiles: [
+            { metric: 'nodesByHealth.healthy' },
+            { metric: 'nodesByHealth.stale' },
+            { metric: 'nodesByHealth.offline' },
+            { metric: 'noEligibleNode' },
+        ],
+        series: [],
+        tables: [
+            {
+                metric: 'nodes',
+                columns: [
+                    { key: 'key' },
+                    { key: 'cpuCores' },
+                    { key: 'rssBytes' },
+                    { key: 'heapPct', display: { kind: 'utilization-bar' } },
+                    { key: 'stateDirFreePct' },
+                    { key: 'slots', label: 'Slots used', display: { kind: 'fraction', of: ['slotsUsed', 'slotsTotal'] } },
+                    { key: 'lastSeenAt' },
+                ],
+            },
+            {
+                metric: 'noEligibleNodeTypes',
+                sort: 'problems-first',
+                columns: [
+                    { key: 'key' },
+                    {
+                        key: 'noEligibleNode',
+                        label: 'Eligible node',
+                        display: { kind: 'status', okText: 'Available', badText: 'None eligible', invert: true },
+                    },
+                    { key: 'lastSeenAt' },
+                ],
+            },
+        ],
+    },
+    uptime: {
+        tiles: [{ metric: 'nginxConnections.active' }, { metric: 'nginxRequests' }, { metric: 'tlsDaysLeft' }, { metric: 'httpDuration' }],
+        series: [{ title: 'nginx connections by state', metrics: ['nginxConnections'] }],
+        tables: [
+            {
+                metric: 'uptimeTargets',
+                sort: 'problems-first',
+                columns: [
+                    { key: 'key' },
+                    { key: 'up', display: { kind: 'status', okText: 'Up', badText: 'Down' } },
+                    { key: 'statusCode' },
+                    { key: 'durationMs' },
+                    { key: 'tlsDaysLeft' },
+                    { key: 'failedChecks' },
+                    { key: 'checks' },
+                    { key: 'lastError' },
+                    { key: 'lastSeenAt' },
+                ],
+            },
+        ],
+    },
+    pipeline: {
+        tiles: [{ metric: 'exporterFailed' }, { metric: 'exporterQueueUtilization' }, { metric: 'receiverRefused' }, { metric: 'scrapeTargetsDown' }],
+        series: [],
+        tables: [
+            {
+                metric: 'scrapeTargets',
+                sort: 'problems-first',
+                columns: [{ key: 'key' }, { key: 'up', display: { kind: 'status', okText: 'Up', badText: 'Down' } }, { key: 'lastSeenAt' }],
+            },
+        ],
+    },
+});
+// =============================================================================
+// Assistant (`/api/admin/telemetry/assistant/stream`)
+// =============================================================================
+/**
+ * The longest question the assistant accepts, in characters (after trimming).
+ *
+ * @stability stable
+ */
+exports.TELEMETRY_ASSISTANT_QUESTION_MAX = 4_000;
+/**
+ * The most earlier turns a request may carry in `history`.
+ *
+ * @stability stable
+ */
+exports.TELEMETRY_ASSISTANT_HISTORY_MAX_TURNS = 20;
+/**
+ * The longest `content` of one `history` turn, in characters.
+ *
+ * @stability stable
+ */
+exports.TELEMETRY_ASSISTANT_HISTORY_CONTENT_MAX = 8_000;
+/**
+ * Who wrote a `history` turn.
+ *
+ * @stability stable
+ */
+exports.TELEMETRY_ASSISTANT_TURN_ROLES = ['user', 'assistant'];
+/**
+ * The tools the platform gives the assistant; each `step` event names one. An
+ * app adds its own (`registerTelemetryAssistantTool`): a step event's `tool`
+ * may be any name matching {@link TELEMETRY_ASSISTANT_TOOL_NAME_PATTERN}.
+ *
+ * @stability stable
+ */
+exports.BUILTIN_TELEMETRY_ASSISTANT_TOOLS = [
+    'list_tables',
+    'describe_table',
+    'run_query',
+    'get_app_context',
+    'health_overview',
+    'get_trace',
+    'metrics_overview',
+    'compare_nodes',
+];
+/**
+ * The platform's own assistant tools; the same list as
+ * {@link BUILTIN_TELEMETRY_ASSISTANT_TOOLS}, kept under its original name.
+ *
+ * @deprecated Use {@link BUILTIN_TELEMETRY_ASSISTANT_TOOLS}; the tool set is
+ *   open since an app can register its own.
+ * @stability stable
+ */
+exports.TELEMETRY_ASSISTANT_TOOLS = exports.BUILTIN_TELEMETRY_ASSISTANT_TOOLS;
+/**
+ * The pattern every assistant tool name matches: a lowercase letter, then up to
+ * 47 lowercase letters, digits or `_` (a valid function name for every model
+ * provider).
+ *
+ * @stability stable
+ */
+exports.TELEMETRY_ASSISTANT_TOOL_NAME_PATTERN = /^[a-z][a-z0-9_]{1,47}$/;
+/**
+ * The longest `extraInstructions` an app may append to the assistant's system
+ * prompt, in characters.
+ *
+ * @stability stable
+ */
+exports.TELEMETRY_ASSISTANT_EXTRA_INSTRUCTIONS_MAX = 4_000;
+/**
+ * The outcome of an investigation, in its report's `status`.
+ *
+ * @stability stable
+ */
+exports.TELEMETRY_ASSISTANT_REPORT_STATUSES = ['issue_found', 'no_issue_found', 'inconclusive', 'no_data'];
+/**
+ * A report finding's severity, most severe first.
+ *
+ * @stability stable
+ */
+exports.TELEMETRY_ASSISTANT_SEVERITIES = ['critical', 'high', 'medium', 'low', 'info'];
+/**
+ * How sure a report is of its root cause.
+ *
+ * @stability stable
+ */
+exports.TELEMETRY_ASSISTANT_CONFIDENCES = ['high', 'medium', 'low'];
+//# sourceMappingURL=constants.js.map