@obsunified/collector 2.3.0 → 2.4.3

package/dist/auth.d.ts

@@ -1,2 +1,3 @@
 import 'hono';
-export { n as createIngestAuth, r as resetIngestAuthCache } from './ingest-auth-BmP5-f96.js';
+export { p as createIngestAuth, s as resetIngestAuthCache } from './ingest-auth-BTowieER.js';
+import '@obsunified/types';

package/dist/index.d.ts

@@ -2,9 +2,9 @@ import * as hono from 'hono';
 import { MiddlewareHandler, Hono, Context } from 'hono';
 import * as hono_types from 'hono/types';
 import * as _obsunified_types from '@obsunified/types';
-import { StoredSpan, TelemetryOverviewOptions, TelemetryOverviewResponse, TelemetryTraceDetailResponse, TelemetryInstrumentationGapsResponse, TelemetryIssueOptions, TelemetryIssueOverviewResponse, TelemetryIssueDetailResponse, UsageEventRecord, UsageOverviewOptions, UsageOverviewResponse, UsageSessionDetailResponse, UsageSessionSummary, AlertRuleInput, AlertRule, AlertStateRow, AlertState, AlertEvaluationsListResponse, AlertComparison, ChangeBlastRadiusResult, ContentionCandidate, ChangeEvent, ChangeEventInput, InvestigationFinding, InvestigationFindingInput, OntologyNode, OntologyEdge, CanonicalNodeIdentity, OntologyGraphResponse, RelationshipCertainty, CausalTriple, IncidentInvestigation, RemediationProposal, EvidenceEntityKind, RemediationProposalInput, JsonValue, EvidenceReference, EvidenceReferenceContract, Project, IngestKey, IngestKeyWithPlaintext } from '@obsunified/types';
-import { e as CollectorEnv, L as Logger, c as ChildSpanRunner, j as CollectorRouteContext } from './ingest-auth-BmP5-f96.js';
-export { C as COLLECTOR_HOST_MANAGED_ENV_KEYS, a as COLLECTOR_OPTIONAL_STRING_ENV_KEYS, b as COLLECTOR_STRING_ENV_MANIFEST, d as CollectorApp, f as CollectorHostManagedEnvKey, g as CollectorManifestStringEnvKey, h as CollectorObjectBindingKey, i as CollectorOptionalStringEnvKey, k as CollectorStringEnvKey, l as assertCollectorEnvManifestCompleteness, m as consoleLogger, n as createIngestAuth } from './ingest-auth-BmP5-f96.js';
+import { StoredSpan, TelemetryOverviewOptions, TelemetryOverviewResponse, TelemetryTraceDetailResponse, TelemetryInstrumentationGapsResponse, TelemetryIssueOptions, TelemetryIssueOverviewResponse, TelemetryIssueDetailResponse, UsageEventRecord, UsageOverviewOptions, UsageOverviewResponse, UsageSessionDetailResponse, UsageSessionSummary, AlertRuleInput, AlertRule, AlertStateRow, AlertState, AlertEvaluationOutcome, AlertEvaluationsListResponse, AlertComparison, ChangeBlastRadiusResult, ContentionCandidate, ChangeEvent, ChangeEventInput, InvestigationFinding, InvestigationFindingInput, OntologyNode, OntologyEdge, CanonicalNodeIdentity, OntologyGraphResponse, RelationshipCertainty, CausalTriple, IncidentInvestigation, RemediationProposal, EvidenceEntityKind, RemediationProposalInput, JsonValue, EvidenceReference, EvidenceReferenceContract, AlertQueryMetrics, AlertMetricAggregation, AlertMetricField, Project, IngestKey, IngestKeyWithPlaintext } from '@obsunified/types';
+import { g as CollectorEnv, L as Logger, e as ChildSpanRunner, l as CollectorRouteContext, a as AlertEmailTransport } from './ingest-auth-BTowieER.js';
+export { A as AlertEmailMessage, b as AlertNotificationPayload, C as COLLECTOR_HOST_MANAGED_ENV_KEYS, c as COLLECTOR_OPTIONAL_STRING_ENV_KEYS, d as COLLECTOR_STRING_ENV_MANIFEST, f as CollectorApp, h as CollectorHostManagedEnvKey, i as CollectorManifestStringEnvKey, j as CollectorObjectBindingKey, k as CollectorOptionalStringEnvKey, m as CollectorStringEnvKey, n as assertCollectorEnvManifestCompleteness, o as consoleLogger, p as createIngestAuth, q as formatAlertEmail, r as isValidEmailAddress } from './ingest-auth-BTowieER.js';
 import { ActionConfidence } from '@obsunified/types/constants';
 import { Pool } from 'pg';
 
@@ -488,15 +488,178 @@ declare const aiReceiverPlugin: CollectorPlugin;
 
 declare const aiSpanPayloadsProcessorPlugin: CollectorPlugin;
 
+/** A rule's value, and whether a metrics rule found no fresh data. */
+interface AlertRuleEvaluation {
+    value: number;
+    noData: boolean;
+}
+
+interface AlertsStoreOptions {
+    /** Permit webhook targets on loopback / private / link-local hosts. */
+    allowPrivateWebhookTargets?: boolean;
+    /**
+     * Whether this collector can send email (a transport is bound as
+     * `env.ALERT_EMAIL`). Rules with an email channel are refused otherwise.
+     */
+    emailDeliveryAvailable?: boolean;
+}
+declare function compareValue(value: number, threshold: number, comparison: AlertComparison): boolean;
+declare class AlertsStore {
+    private readonly db;
+    private readonly options;
+    constructor(db: SqlDb, options?: AlertsStoreOptions);
+    validateInput(input: AlertRuleInput): void;
+    listRules(projectId: string): Promise<AlertRule[]>;
+    /**
+     * The newest evaluation of every rule in the project, one query. Falls
+     * back to the pre-057/059 column set on older databases.
+     */
+    private lastEvaluations;
+    getRule(id: string, projectId: string): Promise<AlertRule | null>;
+    createRule(projectId: string, input: AlertRuleInput): Promise<AlertRule>;
+    updateRule(id: string, projectId: string, patch: Partial<AlertRuleInput>): Promise<AlertRule | null>;
+    /**
+     * Clears a rule's pending period. Tolerates databases that have not
+     * applied 055/058 (there is nothing to clear on them).
+     */
+    resetPending(ruleId: string, projectId: string): Promise<void>;
+    /**
+     * Runs `current`; on a database that has not applied migration 054 (no
+     * `alert_rules.pending_secs`) a rule without a pending duration is
+     * written with the legacy statement so rolling deploys keep working. A
+     * rule that needs the column is refused with a clear message instead of
+     * silently losing its pending duration.
+     */
+    private withPendingColumnFallback;
+    deleteRule(id: string, projectId: string): Promise<boolean>;
+    listEnabledRules(): Promise<AlertRule[]>;
+    getState(ruleId: string, projectId: string): Promise<AlertStateRow | null>;
+    /**
+     * Record a state transition with its notification still outstanding
+     * (`notified = 0`); `markNotified` flips it once a channel accepts the
+     * alert. On a database that has not applied migration 049 the column is
+     * missing: the transition is still written (legacy statement) so alerting
+     * keeps working through a rolling deploy, and the evaluator treats a row
+     * without the column as delivered.
+     */
+    transitionState(ruleId: string, projectId: string, newState: AlertState, now: string): Promise<void>;
+    /**
+     * Mark the transition `(state, lastStateChange)` as delivered. Scoped to
+     * the exact transition the caller notified for: if the rule changed state
+     * again while the webhook was in flight, the newer transition keeps its
+     * own outstanding flag. Returns false when nothing matched (stale or
+     * already marked). On a pre-049 schema there is nothing to mark.
+     */
+    markNotified(ruleId: string, projectId: string, state: AlertState, lastStateChange: string): Promise<boolean>;
+    /**
+     * Record (`{ since, seenAt }`) or clear (`null`) the pending period of a
+     * rule that has a pending duration (migrations 055, 058): when the
+     * condition started holding, and the last evaluation that saw it hold.
+     * A rule without a state row gets one in state `ok` since its creation,
+     * already delivered (nothing is owed for a rule that never changed
+     * state).
+     */
+    setPending(ruleId: string, projectId: string, pending: {
+        since: string;
+        seenAt: string;
+    } | null, ruleCreatedAt: string): Promise<void>;
+    recordEvaluation(ruleId: string, projectId: string, value: number, state: AlertState, notified: boolean, outcome?: AlertEvaluationOutcome, errorMessage?: string): Promise<void>;
+    listEvaluations(params: {
+        ruleId: string;
+        projectId?: string;
+        hours: number;
+        limit?: number;
+    }): Promise<AlertEvaluationsListResponse>;
+    evaluateRule(rule: AlertRule, now?: Date): Promise<number>;
+    /** Like `evaluateRule`, plus whether a metrics rule found no fresh data. */
+    evaluateRuleWithStatus(rule: AlertRule, now?: Date): Promise<AlertRuleEvaluation>;
+    private evaluateCountRule;
+    /**
+     * Stage 6 — fetch the latest narrative associated with this rule's
+     * bound analysis. Used by the evaluator when firing an analysis-bound
+     * alert so the webhook payload includes the human-readable
+     * narrative, not just a threshold crossing.
+     */
+    getAnalysisNarrative(projectId: string, analysisId: string): Promise<{
+        narrative: string | null;
+        status: string | null;
+    } | null>;
+    private evaluateSpanRule;
+    private evaluateLogRule;
+    private evaluateUsageRule;
+    private evaluateAIRule;
+}
+
 /** Resolve a hostname to its addresses (e.g. `dns.lookup(host, { all: true })`). */
 type HostLookup = (hostname: string) => Promise<string[]>;
 
+interface AlertEvaluatorStore {
+    listEnabledRules(): Promise<AlertRule[]>;
+    evaluateRule(rule: AlertRule): Promise<number>;
+    /** Preferred when present: also says whether a metrics rule had no data. */
+    evaluateRuleWithStatus?(rule: AlertRule): Promise<AlertRuleEvaluation>;
+    getState(ruleId: string, projectId: string): Promise<{
+        current_state: AlertState;
+        last_state_change: string;
+        /** 0 while the transition's notification is owed; absent pre-049 (= delivered). */
+        notified?: number;
+        /** Start of the current pending period (migration 055); null/absent when not pending. */
+        pending_since?: string | null;
+        /** Last evaluation that saw the pending condition hold (migration 058). */
+        pending_seen_at?: string | null;
+    } | null>;
+    /** Record (`{ since, seenAt }`) or clear (null) the rule's pending period. */
+    setPending(ruleId: string, projectId: string, pending: {
+        since: string;
+        seenAt: string;
+    } | null, ruleCreatedAt: string): Promise<void>;
+    /** Flip the exact transition `(state, lastStateChange)` to delivered. */
+    markNotified(ruleId: string, projectId: string, state: AlertState, lastStateChange: string): Promise<boolean>;
+    getAnalysisNarrative(projectId: string, analysisId: string): Promise<{
+        narrative: string | null;
+        status: string | null;
+    } | null>;
+    transitionState(ruleId: string, projectId: string, newState: AlertState, now: string): Promise<void>;
+    recordEvaluation(ruleId: string, projectId: string, value: number, state: AlertState, notified: boolean, outcome?: AlertEvaluationOutcome, 
+    /** With outcome `error`: why (the store sanitizes it). */
+    errorMessage?: string): Promise<void>;
+}
+declare function evaluateRuleBatch(store: AlertEvaluatorStore, rules: AlertRule[], options?: {
+    logger?: Logger;
+    tracer?: ChildSpanRunner;
+    concurrency?: number;
+    ruleTimeoutMs?: number;
+    allowPrivateWebhookTargets?: boolean;
+    hostLookup?: HostLookup;
+    email?: AlertEmailTransport;
+    onAlertFiring?: (rule: AlertRule) => Promise<void>;
+    /**
+     * Longest gap between two evaluations that still continues a pending
+     * hold. Default `DEFAULT_MAX_EVALUATION_GAP_MS` (two 5-minute ticks);
+     * pass twice the host's evaluation interval.
+     */
+    maxEvaluationGapMs?: number;
+    /**
+     * ISO start of this collector process. A hold last seen before it
+     * starts over, as Prometheus resets `for` on restart. Unset on hosts
+     * without a long-lived process (Workers), where the gap rule applies.
+     */
+    holdStartedAt?: string;
+}): Promise<{
+    evaluated: number;
+    fired: number;
+    resolved: number;
+    /** Notifications for an earlier transition that were delivered on this tick. */
+    redelivered: number;
+}>;
 declare function evaluateAllRules(env: CollectorEnv, options?: {
     logger?: Logger;
     tracer?: ChildSpanRunner;
     concurrency?: number;
     ruleTimeoutMs?: number;
     hostLookup?: HostLookup;
+    maxEvaluationGapMs?: number;
+    holdStartedAt?: string;
 }): Promise<{
     evaluated: number;
     fired: number;
@@ -1024,64 +1187,6 @@ declare class ActionStore {
     listArtifactsByAction(projectId: string, actionId: string, limit?: number): Promise<ArtifactRef[]>;
 }
 
-interface AlertsStoreOptions {
-    /** Permit webhook targets on loopback / private / link-local hosts. */
-    allowPrivateWebhookTargets?: boolean;
-}
-declare function compareValue(value: number, threshold: number, comparison: AlertComparison): boolean;
-declare class AlertsStore {
-    private readonly db;
-    private readonly options;
-    constructor(db: SqlDb, options?: AlertsStoreOptions);
-    validateInput(input: AlertRuleInput): void;
-    listRules(projectId: string): Promise<AlertRule[]>;
-    getRule(id: string, projectId: string): Promise<AlertRule | null>;
-    createRule(projectId: string, input: AlertRuleInput): Promise<AlertRule>;
-    updateRule(id: string, projectId: string, patch: Partial<AlertRuleInput>): Promise<AlertRule | null>;
-    deleteRule(id: string, projectId: string): Promise<boolean>;
-    listEnabledRules(): Promise<AlertRule[]>;
-    getState(ruleId: string, projectId: string): Promise<AlertStateRow | null>;
-    /**
-     * Record a state transition with its notification still outstanding
-     * (`notified = 0`); `markNotified` flips it once a channel accepts the
-     * alert. On a database that has not applied migration 049 the column is
-     * missing: the transition is still written (legacy statement) so alerting
-     * keeps working through a rolling deploy, and the evaluator treats a row
-     * without the column as delivered.
-     */
-    transitionState(ruleId: string, projectId: string, newState: AlertState, now: string): Promise<void>;
-    /**
-     * Mark the transition `(state, lastStateChange)` as delivered. Scoped to
-     * the exact transition the caller notified for: if the rule changed state
-     * again while the webhook was in flight, the newer transition keeps its
-     * own outstanding flag. Returns false when nothing matched (stale or
-     * already marked). On a pre-049 schema there is nothing to mark.
-     */
-    markNotified(ruleId: string, projectId: string, state: AlertState, lastStateChange: string): Promise<boolean>;
-    recordEvaluation(ruleId: string, projectId: string, value: number, state: AlertState, notified: boolean): Promise<void>;
-    listEvaluations(params: {
-        ruleId: string;
-        projectId?: string;
-        hours: number;
-        limit?: number;
-    }): Promise<AlertEvaluationsListResponse>;
-    evaluateRule(rule: AlertRule): Promise<number>;
-    /**
-     * Stage 6 — fetch the latest narrative associated with this rule's
-     * bound analysis. Used by the evaluator when firing an analysis-bound
-     * alert so the webhook payload includes the human-readable
-     * narrative, not just a threshold crossing.
-     */
-    getAnalysisNarrative(projectId: string, analysisId: string): Promise<{
-        narrative: string | null;
-        status: string | null;
-    } | null>;
-    private evaluateSpanRule;
-    private evaluateLogRule;
-    private evaluateUsageRule;
-    private evaluateAIRule;
-}
-
 declare function recordChangeEvent(db: SqlDb, projectId: string, input: ChangeEventInput): Promise<ChangeEvent>;
 declare function listChangeEvents(db: SqlDb, options: {
     projectId: string;
@@ -1698,6 +1803,103 @@ declare class EvalCasesStore {
     private buildMetadata;
 }
 
+/**
+ * `metrics` alert signal: validation and evaluation of an
+ * `AlertQueryMetrics` against `metric_series` / `metric_point`.
+ *
+ * Evaluation, per selector (numerator, then the optional denominator):
+ *
+ *   1. Series: `metric_series` rows of the project whose name is one of the
+ *      selector's names (and whose `service_name` matches, when given), kept
+ *      when every listed data-point / resource attribute equals the rule's
+ *      value. Attribute values are compared as strings, so `200` matches a
+ *      stored `"200"` and vice versa.
+ *   2. Points: the series' points whose `received_at` (the collector's clock,
+ *      as for every other alert signal) is inside the rule window, ordered by
+ *      producer time (`ts_ns`). The number read is `field` (`value`, or a
+ *      histogram/summary `count` / `sum`); points without it are skipped.
+ *   3. Staleness: for `last`, `min`, `max`, `avg` and `sum` a series takes
+ *      part only when its newest point is at most `staleSecs` (default 300)
+ *      old, so a series that stopped reporting (a renamed host, a replaced
+ *      pod) no longer adds its last value. `increase` / `rate` keep every
+ *      series with points in the window: growth that happened is real even
+ *      if the series stopped afterwards.
+ *   4. Each series is reduced on its own (`reduceSeries`), and the per-series
+ *      results are summed. A series with no usable point adds nothing.
+ *
+ * When no series takes part (in the numerator or the denominator) the
+ * result is "no data": the value is 0 and `noData` is true. The rule's
+ * `noData` policy decides what that means (`zero`: evaluate 0 as usual;
+ * `keep`: leave the alert state as it is).
+ *
+ * `age_seconds` ignores the window: it is the seconds since the newest
+ * `received_at` of any matching series. When no matching series has any
+ * stored point (never reported, or everything aged out of retention) it is
+ * the seconds since the rule was created, a finite number that grows until
+ * the threshold is crossed, so "never reported" fires after the same grace
+ * period as "stopped reporting".
+ *
+ * `age_seconds` is never "no data".
+ *
+ * Ratio: with a `denominator`, value = numerator / denominator when the
+ * denominator is > 0 and >= minDenominator (default 0), else 0.
+ *
+ * Cost bounds: at most `MAX_MATCHED_SERIES` series and `MAX_LOADED_POINTS`
+ * points per selector; past either the evaluation fails with an error (the
+ * evaluator records it as an `error` evaluation) rather than returning a
+ * value computed from part of the data. Metric rule windows are at most
+ * `MAX_METRIC_WINDOW_MINS`.
+ */
+
+/** Throws an Error with a user-facing message when `query` is malformed. */
+declare function validateMetricQuery(query: unknown): void;
+interface MetricPointSample {
+    tsNs: string;
+    startTsNs: string | null;
+    value: number | null;
+    count: number | null;
+    sum: number | null;
+    receivedAt: string;
+}
+interface SeriesReduceOptions {
+    /**
+     * The series has no history before the window (its `metric_series` row
+     * was created inside it): a cumulative counter's first point then counts
+     * as growth from 0 instead of being the baseline.
+     */
+    bornInWindow?: boolean;
+    aggregation: Exclude<AlertMetricAggregation, "age_seconds">;
+    field: AlertMetricField;
+    /** `metric_series.temporality`: 1 delta, 2 cumulative, null for gauges. */
+    temporality: number | null;
+    /** Start of the window in Unix nanoseconds. */
+    windowStartNs: bigint;
+    windowSecs: number;
+}
+/**
+ * Reduces one series' window points to a number, or null when the series
+ * has no point carrying `field` in the window.
+ */
+declare function reduceSeries(points: MetricPointSample[], opts: SeriesReduceOptions): number | null;
+interface MetricEvalContext {
+    projectId: string;
+    windowMins: number;
+    /** The rule's `createdAt`; the reference for "never reported". */
+    ruleCreatedAt: string;
+    now: Date;
+    /** Staleness bound for gauge-style aggregations; default 300. */
+    staleSecs?: number;
+    /** Point cap per selector; default MAX_LOADED_POINTS (tests lower it). */
+    maxLoadedPoints?: number;
+}
+interface MetricEvaluation {
+    value: number;
+    /** No series took part; see the module comment. Never true for age_seconds. */
+    noData: boolean;
+}
+/** Evaluates a validated metrics query to a finite number. */
+declare function evaluateMetricQuery(db: SqlDb, query: AlertQueryMetrics, ctx: MetricEvalContext): Promise<MetricEvaluation>;
+
 type MetricType = "gauge" | "sum" | "histogram" | "exp_histogram" | "summary";
 /**
  * A metric data point normalized for storage. Series-identifying fields
@@ -1855,4 +2057,4 @@ declare const _default: hono.Hono<{
     Bindings: CollectorEnv;
 }, hono_types.BlankSchema, "/">;
 
-export { type ActionGraphPurgeSummary, type ActionGraphRetentionOptions, type ActionRecord, ActionStore, type AgentRunRecord, AlertsStore, type AnalysesRunSummary, type ArtifactRecord, type BlobListOptions, type BlobListResult, type BlobObject, type BlobPutOptions, type BlobStore, BlobStoreToR2Adapter, type CollectorAuthConfig, type CollectorConfig, CollectorEnv, type CollectorPlugin, CollectorRouteContext, CollectorRuntime, CounterfactualVerificationError, D1Adapter, type DashboardAuthConfig, type EvalCase, type EvalCaseInput, type EvalCaseListOptions, type EvalCaseSourceLinks, EvalCaseSourceNotFoundError, type EvalCaseSourceType, EvalCasesStore, type EvalResultRecord, type EvalRun, type EvalRunCandidate, type EvalRunInput, type EvalRunSourceCase, type EvalRunStatus, type EvalRunsListOptions, type HostLookup, Logger, MetricsStore, PostgresAdapter, type PostgresAdapterOptions, type PostgresTypeParserRegistry, ProjectsStore, R2BlobStore, RemediationGateError, type RetentionCleanupSummary, type RetrievalEventRecord, S3BlobStore, type S3BlobStoreOptions, type ScheduledTaskHandler, type SpanProcessorPlugin, type SqlDb, type SqlDbFactory, type SqlStatement, type TailEvent, TailHub, type TailKind, type ToolCallRecord, type UsageEventProcessorPlugin, type WatchdogEvaluationSummary, acquireIncidentLease, actionRetentionCutoff, actionRoutesPlugin, aiReceiverPlugin, aiSpanPayloadsProcessorPlugin, alertsRoutesPlugin, allPlugins, analysesRoutesPlugin, approveRemediationProposal, askRoutesPlugin, autosreRoutesPlugin, botFilterPlugin, claimRemediationGrant, compareValue, completeRemediationProposal, computeChangeBlastRadius, computeTarjanScc, configurePostgresTypeParsers, connectedRoutesPlugin, createAlertEvaluatorHandler, createAnalysesRunHandler, createDashboardAuth, createDefaultCollectorApp, createRetentionCleanupHandler, createTelemetryCollectorApp, dashboardRoutesPlugin, _default as default, defaultSpanEnrichmentPlugin, dispatchIncidentWebhook, evalCasesRoutesPlugin, evaluateAllRules, evaluateRemediationWatchdogs, evidenceRetrievalRoutesPlugin, extractSpanLineageAndTopology, failRemediationProposal, findCrossTraceContention, genAiNormalizerPlugin, getChangeEvent, getIncidentInvestigation, getInvestigationFinding, getOntologyGraph, getRemediationProposal, identityReceiverPlugin, isEvalCaseSourceType, isEvalRunStatus, issueEnrichmentPlugin, issueInsightsPlugin, listChangeEvents, listIncidentInvestigations, listRemediationProposals, loadTraceFaultLocusFromDb, localizeTraceFaultLocus, logsReceiverPlugin, metricsReceiverPlugin, onboardingRoutesPlugin, openOrDeduplicateIncident, otlpReceiverPlugin, platformRoutesPlugin, profileRoutesPlugin, projectsRoutesPlugin, proposeRemediationAction, purgeExpiredActionGraph, queryRoutesPlugin, recordChangeEvent, recordInvestigationFinding, redactionProcessorPlugin, rejectRemediationProposal, replayQueryRoutesPlugin, replayReceiverPlugin, searchInvestigationFindings, tailRoutesPlugin, timelineRoutesPlugin, uaEnrichmentPlugin, upsertOntologyFromSpans, usageNormalizationPlugin, usagePrivacyPlugin, usageQueryRoutesPlugin, usageReceiverPlugin, usersQueryRoutesPlugin, utmEnrichmentPlugin, verifyPairedCounterfactualProof };
+export { type ActionGraphPurgeSummary, type ActionGraphRetentionOptions, type ActionRecord, ActionStore, type AgentRunRecord, AlertEmailTransport, AlertsStore, type AnalysesRunSummary, type ArtifactRecord, type BlobListOptions, type BlobListResult, type BlobObject, type BlobPutOptions, type BlobStore, BlobStoreToR2Adapter, type CollectorAuthConfig, type CollectorConfig, CollectorEnv, type CollectorPlugin, CollectorRouteContext, CollectorRuntime, CounterfactualVerificationError, D1Adapter, type DashboardAuthConfig, type EvalCase, type EvalCaseInput, type EvalCaseListOptions, type EvalCaseSourceLinks, EvalCaseSourceNotFoundError, type EvalCaseSourceType, EvalCasesStore, type EvalResultRecord, type EvalRun, type EvalRunCandidate, type EvalRunInput, type EvalRunSourceCase, type EvalRunStatus, type EvalRunsListOptions, type HostLookup, Logger, MetricsStore, PostgresAdapter, type PostgresAdapterOptions, type PostgresTypeParserRegistry, ProjectsStore, R2BlobStore, RemediationGateError, type RetentionCleanupSummary, type RetrievalEventRecord, S3BlobStore, type S3BlobStoreOptions, type ScheduledTaskHandler, type SpanProcessorPlugin, type SqlDb, type SqlDbFactory, type SqlStatement, type TailEvent, TailHub, type TailKind, type ToolCallRecord, type UsageEventProcessorPlugin, type WatchdogEvaluationSummary, acquireIncidentLease, actionRetentionCutoff, actionRoutesPlugin, aiReceiverPlugin, aiSpanPayloadsProcessorPlugin, alertsRoutesPlugin, allPlugins, analysesRoutesPlugin, approveRemediationProposal, askRoutesPlugin, autosreRoutesPlugin, botFilterPlugin, claimRemediationGrant, compareValue, completeRemediationProposal, computeChangeBlastRadius, computeTarjanScc, configurePostgresTypeParsers, connectedRoutesPlugin, createAlertEvaluatorHandler, createAnalysesRunHandler, createDashboardAuth, createDefaultCollectorApp, createRetentionCleanupHandler, createTelemetryCollectorApp, dashboardRoutesPlugin, _default as default, defaultSpanEnrichmentPlugin, dispatchIncidentWebhook, evalCasesRoutesPlugin, evaluateAllRules, evaluateMetricQuery, evaluateRemediationWatchdogs, evaluateRuleBatch, evidenceRetrievalRoutesPlugin, extractSpanLineageAndTopology, failRemediationProposal, findCrossTraceContention, genAiNormalizerPlugin, getChangeEvent, getIncidentInvestigation, getInvestigationFinding, getOntologyGraph, getRemediationProposal, identityReceiverPlugin, isEvalCaseSourceType, isEvalRunStatus, issueEnrichmentPlugin, issueInsightsPlugin, listChangeEvents, listIncidentInvestigations, listRemediationProposals, loadTraceFaultLocusFromDb, localizeTraceFaultLocus, logsReceiverPlugin, metricsReceiverPlugin, onboardingRoutesPlugin, openOrDeduplicateIncident, otlpReceiverPlugin, platformRoutesPlugin, profileRoutesPlugin, projectsRoutesPlugin, proposeRemediationAction, purgeExpiredActionGraph, queryRoutesPlugin, recordChangeEvent, recordInvestigationFinding, redactionProcessorPlugin, reduceSeries, rejectRemediationProposal, replayQueryRoutesPlugin, replayReceiverPlugin, searchInvestigationFindings, tailRoutesPlugin, timelineRoutesPlugin, uaEnrichmentPlugin, upsertOntologyFromSpans, usageNormalizationPlugin, usagePrivacyPlugin, usageQueryRoutesPlugin, usageReceiverPlugin, usersQueryRoutesPlugin, utmEnrichmentPlugin, validateMetricQuery, verifyPairedCounterfactualProof };