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

package/dist/esm/telemetry/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/telemetry/constants.ts"],"names":[],"mappings":"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"}

package/dist/esm/telemetry/constants.js

@@ -0,0 +1,681 @@
+// 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.
+// =============================================================================
+// 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
+ */
+export const 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
+ */
+export const 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
+ */
+export const 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
+ */
+export const 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
+ */
+export const 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
+ */
+export const 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
+ */
+export const 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
+ */
+export const TELEMETRY_CONNECTION_SOURCES = ['stored', 'environment', 'none'];
+/**
+ * `auto`: the GreptimeDB deployed with the application; `custom`: a host an
+ * administrator chose.
+ *
+ * @stability stable
+ */
+export const 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
+ */
+export const 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
+ */
+export const 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
+ */
+export const 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
+ */
+export const 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
+ */
+export const 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
+ */
+export const TELEMETRY_STACK_SERVICE_HEALTH = ['healthy', 'unhealthy', 'starting'];
+/**
+ * The status of the latest stack deploy job: the queue's own statuses.
+ *
+ * @stability stable
+ */
+export const TELEMETRY_STACK_DEPLOY_STATUSES = ['pending', 'running', 'succeeded', 'failed'];
+// =============================================================================
+// Dashboard (`/api/admin/telemetry/dashboard/*`)
+// =============================================================================
+/**
+ * The relative windows every dashboard route accepts as `range`.
+ *
+ * @stability stable
+ */
+export const DASHBOARD_RANGES = ['15m', '1h', '6h', '24h', '7d'];
+/**
+ * The length of each {@link DASHBOARD_RANGES} window, in milliseconds.
+ *
+ * @stability stable
+ */
+export const 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
+ */
+export const DEFAULT_DASHBOARD_RANGE = '1h';
+/**
+ * The longest absolute window (`from` to `to`) a dashboard route accepts: 30 days.
+ *
+ * @stability stable
+ */
+export const 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
+ */
+export const 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
+ */
+export const DASHBOARD_BUCKET_COUNTS = ['30', '60'];
+/**
+ * The longest `service`, `instance` or `host` filter value.
+ *
+ * @stability stable
+ */
+export const DASHBOARD_FILTER_VALUE_MAX = 200;
+/**
+ * The longest `cursor` the events route accepts.
+ *
+ * @stability stable
+ */
+export const DASHBOARD_CURSOR_MAX = 512;
+/**
+ * The longest `q` (log body search) the events route accepts.
+ *
+ * @stability stable
+ */
+export const DASHBOARD_SEARCH_MAX_LENGTH = 200;
+/**
+ * The severities the events route filters on, in `severity`'s comma list.
+ *
+ * @stability stable
+ */
+export const DASHBOARD_EVENT_SEVERITIES = ['error', 'warn', 'info'];
+/**
+ * The `timeseries` route's panels: `api` (status classes, p95) or `logs`
+ * (severity bands).
+ *
+ * @stability stable
+ */
+export const 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
+ */
+export const DASHBOARD_PANEL_ID_PATTERN = /^[a-z][a-z0-9_-]{1,47}$/;
+/**
+ * The most bytes a dashboard panel's `payload` may serialise to.
+ *
+ * @stability stable
+ */
+export const 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
+ */
+export const DASHBOARD_TOP_KINDS = ['routes', 'errors'];
+/**
+ * The summary's overall verdict levels, in increasing severity, `no_data`
+ * last.
+ *
+ * @stability stable
+ */
+export const 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
+ */
+export const 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
+ */
+export const METRIC_UNITS = BUILTIN_METRIC_UNITS;
+/**
+ * The pattern every metric unit id matches: a lowercase letter or `%`, then up
+ * to 31 lowercase letters, digits, `_`, `/`, `%` or `-`.
+ *
+ * @stability stable
+ */
+export const 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
+ */
+export const 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
+ */
+export const 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
+ */
+export const 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
+ */
+export const 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
+ */
+export const 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
+ */
+export const 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
+ */
+export const 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
+ */
+export const 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
+ */
+export const 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
+ */
+export const TELEMETRY_ASSISTANT_QUESTION_MAX = 4_000;
+/**
+ * The most earlier turns a request may carry in `history`.
+ *
+ * @stability stable
+ */
+export const TELEMETRY_ASSISTANT_HISTORY_MAX_TURNS = 20;
+/**
+ * The longest `content` of one `history` turn, in characters.
+ *
+ * @stability stable
+ */
+export const TELEMETRY_ASSISTANT_HISTORY_CONTENT_MAX = 8_000;
+/**
+ * Who wrote a `history` turn.
+ *
+ * @stability stable
+ */
+export const 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
+ */
+export const 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
+ */
+export const TELEMETRY_ASSISTANT_TOOLS = 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
+ */
+export const 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
+ */
+export const TELEMETRY_ASSISTANT_EXTRA_INSTRUCTIONS_MAX = 4_000;
+/**
+ * The outcome of an investigation, in its report's `status`.
+ *
+ * @stability stable
+ */
+export const TELEMETRY_ASSISTANT_REPORT_STATUSES = ['issue_found', 'no_issue_found', 'inconclusive', 'no_data'];
+/**
+ * A report finding's severity, most severe first.
+ *
+ * @stability stable
+ */
+export const TELEMETRY_ASSISTANT_SEVERITIES = ['critical', 'high', 'medium', 'low', 'info'];
+/**
+ * How sure a report is of its root cause.
+ *
+ * @stability stable
+ */
+export const TELEMETRY_ASSISTANT_CONFIDENCES = ['high', 'medium', 'low'];
+//# sourceMappingURL=constants.js.map