@unbrained/pm-cli 2026.10.12 → 2026.10.13

package/dist/core/telemetry/runtime.d.ts

@@ -10,151 +10,151 @@ export { PM_TELEMETRY_SOURCE_CONTEXT_VALUES } from "./policy.js";
 /** Wait for the most recent background flush to settle. Test-only helper. */
 export declare function waitForPendingFlush(): Promise<void>;
 interface TelemetryEvent {
-    schema_version: number;
-    event_id: string;
-    event_type: "command_start" | "command_finish" | "command_error";
-    occurred_at: string;
-    installation_id: string;
-    session_id: string;
-    command: string;
-    payload: Record<string, unknown>;
+schema_version: number;
+event_id: string;
+event_type: "command_start" | "command_finish" | "command_error";
+occurred_at: string;
+installation_id: string;
+session_id: string;
+command: string;
+payload: Record<string, unknown>;
 }
 interface QueuedTelemetryEvent {
-    client_schema_version?: number;
-    event: TelemetryEvent;
-    attempts: number;
-    last_attempt_at?: string;
-    next_attempt_after?: string;
+client_schema_version?: number;
+event: TelemetryEvent;
+attempts: number;
+last_attempt_at?: string;
+next_attempt_after?: string;
 }
 interface TelemetryRuntimeState {
-    last_attempted_flush_at?: string;
-    last_successful_flush_at?: string;
-    last_failed_flush_at?: string;
-    last_failed_flush_error?: string;
-    endpoint?: string;
-    queue_entries?: number;
-    pending_otel_spans?: number;
-    last_otel_attempt_at?: string;
-    last_otel_success_at?: string;
-    last_otel_failure_at?: string;
-    last_otel_failure_error?: string;
+last_attempted_flush_at?: string;
+last_successful_flush_at?: string;
+last_failed_flush_at?: string;
+last_failed_flush_error?: string;
+endpoint?: string;
+queue_entries?: number;
+pending_otel_spans?: number;
+last_otel_attempt_at?: string;
+last_otel_success_at?: string;
+last_otel_failure_at?: string;
+last_otel_failure_error?: string;
 }
 /** A built OpenTelemetry span request awaiting export. Persisted to a small, bounded queue so the OTLP trace POST happens in the detached, unref'd flush worker instead of inline in the foreground command. This keeps the CLI process from staying alive while a connecting socket to an unreachable traces endpoint drains its 5s timeout (the GH-209 root cause). `payload` is the fully built OTLP resourceSpans body; `endpoint` is the per-span traces endpoint. */
 interface PendingOtelSpan {
-    /** Stable id used to reconcile the queue after the network flush: the worker re-reads the file and removes/updates only the spans it processed, by id, so spans appended by a concurrent foreground process during the flush are never overwritten. Mirrors the event-queue's event_id-based reconciliation. */
-    id: string;
-    endpoint: string;
-    payload: unknown;
-    enqueued_at: string;
-    attempts: number;
-    next_attempt_after?: string;
+/** Stable id used to reconcile the queue after the network flush: the worker re-reads the file and removes/updates only the spans it processed, by id, so spans appended by a concurrent foreground process during the flush are never overwritten. Mirrors the event-queue's event_id-based reconciliation. */
+id: string;
+endpoint: string;
+payload: unknown;
+enqueued_at: string;
+attempts: number;
+next_attempt_after?: string;
 }
 type TelemetryCaptureLevel = "minimal" | "redacted" | "max";
 type TelemetrySourceContext = (typeof PM_TELEMETRY_SOURCE_CONTEXT_VALUES)[number];
 type TelemetrySourceContextSource = "inferred" | "env_override" | "env_override_rejected";
 interface ResolvedTelemetrySourceContext {
-    source_context: TelemetrySourceContext;
-    source_context_source: TelemetrySourceContextSource;
+source_context: TelemetrySourceContext;
+source_context_source: TelemetrySourceContextSource;
 }
 /** Documents the active telemetry command payload exchanged by command, SDK, and package integrations. */
 export interface ActiveTelemetryCommand {
-    /** Inclusion probability for successful sampled reads; failures are retained at probability one. */
-    sample_rate?: number;
-    /** ISO 8601 timestamp recording when started occurred. */
-    started_at: string;
-    /** Elapsed time in milliseconds for started at. */
-    started_at_ms: number;
-    /** Value that configures or reports command for this contract. */
-    command: string;
-    /** Value that configures or reports command taxonomy for this contract. */
-    command_taxonomy: TelemetryCommandTaxonomy;
-    /** Value that configures or reports pm version for this contract. */
-    pm_version: string;
-    /** Value that configures or reports source context for this contract. */
-    source_context: TelemetrySourceContext;
-    /** Whether attribution was inferred, explicitly accepted, or inferred after rejecting an override without retaining its value. */
-    source_context_source: TelemetrySourceContextSource;
-    /** Value that configures or reports installation id for this contract. */
-    installation_id: string;
-    /** Value that configures or reports pm root hash for this contract. */
-    pm_root_hash: string;
-    /** Value that configures or reports cwd hash for this contract. */
-    cwd_hash: string;
-    /** Value that configures or reports endpoint for this contract. */
-    endpoint: string;
-    /** Value that configures or reports retention days for this contract. */
-    retention_days: number;
-    /** Value that configures or reports global pm root for this contract. */
-    global_pm_root: string;
-    /** Value that configures or reports capture level for this contract. */
-    capture_level: TelemetryCaptureLevel;
-    /** Value that configures or reports otel traces endpoint for this contract. */
-    otel_traces_endpoint?: string;
-    /** Value that configures or reports otel trace id for this contract. */
-    otel_trace_id?: string;
-    /** Value that configures or reports otel span id for this contract. */
-    otel_span_id?: string;
+/** Inclusion probability for successful sampled reads; failures are retained at probability one. */
+sample_rate?: number;
+/** ISO 8601 timestamp recording when started occurred. */
+started_at: string;
+/** Elapsed time in milliseconds for started at. */
+started_at_ms: number;
+/** Value that configures or reports command for this contract. */
+command: string;
+/** Value that configures or reports command taxonomy for this contract. */
+command_taxonomy: TelemetryCommandTaxonomy;
+/** Value that configures or reports pm version for this contract. */
+pm_version: string;
+/** Value that configures or reports source context for this contract. */
+source_context: TelemetrySourceContext;
+/** Whether attribution was inferred, explicitly accepted, or inferred after rejecting an override without retaining its value. */
+source_context_source: TelemetrySourceContextSource;
+/** Value that configures or reports installation id for this contract. */
+installation_id: string;
+/** Value that configures or reports pm root hash for this contract. */
+pm_root_hash: string;
+/** Value that configures or reports cwd hash for this contract. */
+cwd_hash: string;
+/** Value that configures or reports endpoint for this contract. */
+endpoint: string;
+/** Value that configures or reports retention days for this contract. */
+retention_days: number;
+/** Value that configures or reports global pm root for this contract. */
+global_pm_root: string;
+/** Value that configures or reports capture level for this contract. */
+capture_level: TelemetryCaptureLevel;
+/** Value that configures or reports otel traces endpoint for this contract. */
+otel_traces_endpoint?: string;
+/** Value that configures or reports otel trace id for this contract. */
+otel_trace_id?: string;
+/** Value that configures or reports otel span id for this contract. */
+otel_span_id?: string;
 }
 /** Documents the telemetry command context payload exchanged by command, SDK, and package integrations. */
 export interface TelemetryCommandContext {
-    /** Value that configures or reports command for this contract. */
-    command: string;
-    /** Value that configures or reports pm version for this contract. */
-    pm_version: string;
-    /** Value that configures or reports args for this contract. */
-    args: string[];
-    /** Value that configures or reports options for this contract. */
-    options: Record<string, unknown>;
-    /** Value that configures or reports global for this contract. */
-    global: GlobalOptions;
-    /** Value that configures or reports pm root for this contract. */
-    pm_root: string;
+/** Value that configures or reports command for this contract. */
+command: string;
+/** Value that configures or reports pm version for this contract. */
+pm_version: string;
+/** Value that configures or reports args for this contract. */
+args: string[];
+/** Value that configures or reports options for this contract. */
+options: Record<string, unknown>;
+/** Value that configures or reports global for this contract. */
+global: GlobalOptions;
+/** Value that configures or reports pm root for this contract. */
+pm_root: string;
 }
 /** Documents the telemetry command outcome payload exchanged by command, SDK, and package integrations. */
 export interface TelemetryCommandOutcome {
-    /** Whether the operation completed without a blocking failure. */
-    ok: boolean;
-    /** Value that configures or reports error for this contract. */
-    error?: string;
-    /** Value that configures or reports result for this contract. */
-    result?: unknown;
-    /** Value that configures or reports exit code for this contract. */
-    exit_code?: number;
-    /** Value that configures or reports error code for this contract. */
-    error_code?: string;
-    /** Value that configures or reports error category for this contract. */
-    error_category?: TelemetryErrorCategory;
-    /** Value that configures or reports command resolution for this contract. */
-    command_resolution?: TelemetryCommandResolution;
-    /** Value that configures or reports resolution stage for this contract. */
-    resolution_stage?: TelemetryResolutionStage;
+/** Whether the operation completed without a blocking failure. */
+ok: boolean;
+/** Value that configures or reports error for this contract. */
+error?: string;
+/** Value that configures or reports result for this contract. */
+result?: unknown;
+/** Value that configures or reports exit code for this contract. */
+exit_code?: number;
+/** Value that configures or reports error code for this contract. */
+error_code?: string;
+/** Value that configures or reports error category for this contract. */
+error_category?: TelemetryErrorCategory;
+/** Value that configures or reports command resolution for this contract. */
+command_resolution?: TelemetryCommandResolution;
+/** Value that configures or reports resolution stage for this contract. */
+resolution_stage?: TelemetryResolutionStage;
 }
 /** Documents the telemetry error event context payload exchanged by command, SDK, and package integrations. */
 export interface TelemetryErrorEventContext {
-    /** Value that configures or reports command for this contract. */
-    command: string;
-    /** Value that configures or reports args for this contract. */
-    args: string[];
-    /** Value that configures or reports options for this contract. */
-    options: Record<string, unknown>;
-    /** Value that configures or reports global for this contract. */
-    global: GlobalOptions;
-    /** Value that configures or reports pm version for this contract. */
-    pm_version: string;
-    /** Value that configures or reports pm root for this contract. */
-    pm_root: string;
-    /** Value that configures or reports error code for this contract. */
-    error_code: string;
-    /** Value that configures or reports error message for this contract. */
-    error_message: string;
-    /** Value that configures or reports exit code for this contract. */
-    exit_code: number;
-    /** Value that configures or reports error category for this contract. */
-    error_category?: TelemetryErrorCategory;
-    /** Value that configures or reports command resolution for this contract. */
-    command_resolution?: TelemetryCommandResolution;
-    /** Value that configures or reports resolution stage for this contract. */
-    resolution_stage?: TelemetryResolutionStage;
+/** Value that configures or reports command for this contract. */
+command: string;
+/** Value that configures or reports args for this contract. */
+args: string[];
+/** Value that configures or reports options for this contract. */
+options: Record<string, unknown>;
+/** Value that configures or reports global for this contract. */
+global: GlobalOptions;
+/** Value that configures or reports pm version for this contract. */
+pm_version: string;
+/** Value that configures or reports pm root for this contract. */
+pm_root: string;
+/** Value that configures or reports error code for this contract. */
+error_code: string;
+/** Value that configures or reports error message for this contract. */
+error_message: string;
+/** Value that configures or reports exit code for this contract. */
+exit_code: number;
+/** Value that configures or reports error category for this contract. */
+error_category?: TelemetryErrorCategory;
+/** Value that configures or reports command resolution for this contract. */
+command_resolution?: TelemetryCommandResolution;
+/** Value that configures or reports resolution stage for this contract. */
+resolution_stage?: TelemetryResolutionStage;
 }
 declare function otelSpansQueuePath(globalPmRoot: string): string;
 declare function runtimeStatePath(globalPmRoot: string): string;
@@ -185,9 +185,9 @@ declare function normalizeTelemetryErrorCode(value: string | undefined): string
 declare function normalizeTelemetryExitCode(exitCode: number | undefined, ok: boolean): number;
 /** Omit categories for successful outcomes; preserve explicit failure categories or derive them from a stable error code. */
 declare function normalizeTelemetryErrorCategory(params: {
-    ok: boolean;
-    errorCode?: string;
-    errorCategory?: TelemetryErrorCategory;
+ok: boolean;
+errorCode?: string;
+errorCategory?: TelemetryErrorCategory;
 }): TelemetryErrorCategory | undefined;
 /** Resolve explicit attribution and explain rejected input without retaining its value. */
 declare function resolveTelemetrySourceContext(globalOptions: GlobalOptions): ResolvedTelemetrySourceContext;
@@ -219,62 +219,62 @@ declare function resolveOtelTracesEndpoint(): string | null;
  * connecting socket (GH-209).
  */
 declare function buildOtelSpanRequest(activeCommand: ActiveTelemetryCommand, outcome: {
-    ok: boolean;
-    error?: string;
-    exit_code?: number;
-    error_code?: string;
-    error_category?: TelemetryErrorCategory;
+ok: boolean;
+error?: string;
+exit_code?: number;
+error_code?: string;
+error_category?: TelemetryErrorCategory;
 }, finishedAtIso: string, durationMs: number, sampleRate?: number): {
-    endpoint: string;
-    payload: unknown;
+endpoint: string;
+payload: unknown;
 } | null;
 /** Build a bounded telemetry-only preview, omitting linked-test collections and undefined fields while preserving the caller's receipt. */
 declare function summarizeResult(result: unknown, captureLevel?: Exclude<TelemetryCaptureLevel, "minimal">): Record<string, unknown>;
 /** Build invocation metadata for the selected capture level; minimal capture retains digests while richer levels include sanitized inputs and hashed runtime context. */
 declare function buildCommandStartPayload(params: {
-    captureLevel: TelemetryCaptureLevel;
-    context: TelemetryCommandContext;
-    pmVersion: string;
-    sourceContext: ResolvedTelemetrySourceContext;
-    pmRootHash: string;
-    cwdHash: string;
-    installationId: string;
+captureLevel: TelemetryCaptureLevel;
+context: TelemetryCommandContext;
+pmVersion: string;
+sourceContext: ResolvedTelemetrySourceContext;
+pmRootHash: string;
+cwdHash: string;
+installationId: string;
 }): Record<string, unknown>;
 /** Build completion diagnostics with sanitized errors and failure fingerprints; minimal capture omits start timestamps and result previews. */
 declare function buildCommandFinishPayload(params: {
-    captureLevel: TelemetryCaptureLevel;
-    pmVersion: string;
-    sourceContext: ResolvedTelemetrySourceContext;
-    outcome: TelemetryCommandOutcome;
-    durationMs: number;
-    startedAt: string;
-    command: string;
-    installationId: string;
-    commandTaxonomy: TelemetryCommandTaxonomy;
-    exitCode: number;
-    errorCode?: string;
-    errorCategory?: TelemetryErrorCategory;
-    commandResolution: TelemetryCommandResolution;
-    resolutionStage: TelemetryResolutionStage;
+captureLevel: TelemetryCaptureLevel;
+pmVersion: string;
+sourceContext: ResolvedTelemetrySourceContext;
+outcome: TelemetryCommandOutcome;
+durationMs: number;
+startedAt: string;
+command: string;
+installationId: string;
+commandTaxonomy: TelemetryCommandTaxonomy;
+exitCode: number;
+errorCode?: string;
+errorCategory?: TelemetryErrorCategory;
+commandResolution: TelemetryCommandResolution;
+resolutionStage: TelemetryResolutionStage;
 }): Record<string, unknown>;
 /** Build error diagnostics at the selected capture level, hashing attempted inputs and redacting error text even in minimal mode. */
 declare function buildCommandErrorPayload(params: {
-    captureLevel: TelemetryCaptureLevel;
-    pmVersion: string;
-    sourceContext: ResolvedTelemetrySourceContext;
-    command: string;
-    commandTaxonomy: TelemetryCommandTaxonomy;
-    commandResolution: TelemetryCommandResolution;
-    resolutionStage: TelemetryResolutionStage;
-    args: string[];
-    options: Record<string, unknown>;
-    pmRootHash: string;
-    cwdHash: string;
-    installationId: string;
-    errorCode: string;
-    errorMessage: string;
-    errorCategory: TelemetryErrorCategory;
-    exitCode: number;
+captureLevel: TelemetryCaptureLevel;
+pmVersion: string;
+sourceContext: ResolvedTelemetrySourceContext;
+command: string;
+commandTaxonomy: TelemetryCommandTaxonomy;
+commandResolution: TelemetryCommandResolution;
+resolutionStage: TelemetryResolutionStage;
+args: string[];
+options: Record<string, unknown>;
+pmRootHash: string;
+cwdHash: string;
+installationId: string;
+errorCode: string;
+errorMessage: string;
+errorCategory: TelemetryErrorCategory;
+exitCode: number;
 }): Record<string, unknown>;
 /** Append an event as an independent queue transaction; compound capture transactions use the private writer while already holding the mutex. */
 declare function enqueueTelemetryEvent(globalPmRoot: string, event: TelemetryEvent): Promise<void>;
@@ -290,8 +290,8 @@ declare function retentionCutoffMs(retentionDays: number): number;
 declare function isExpiredQueueEntry(entry: QueuedTelemetryEvent, cutoffMs: number): boolean;
 /** Preserve event order while removing oversized, expired, and attempt-exhausted envelopes; return the retained snapshot and removal count. */
 declare function pruneExpiredQueueEntries(entries: QueuedTelemetryEvent[], retentionDays: number): {
-    entries: QueuedTelemetryEvent[];
-    prunedCount: number;
+entries: QueuedTelemetryEvent[];
+prunedCount: number;
 };
 /** Atomically replace the event snapshot with bounded retries for transient filesystem failures; mutation callers must hold the queue mutex. */
 declare function rewriteQueue(globalPmRoot: string, entries: QueuedTelemetryEvent[]): Promise<void>;
@@ -301,8 +301,8 @@ declare function isRetryableQueueRewriteError(error: unknown): boolean;
 declare function sleep(milliseconds: number): Promise<void>;
 /** Serialize an independent pending-span append; compound completion capture calls the private writer under its existing queue transaction. */
 declare function enqueuePendingOtelSpan(globalPmRoot: string, request: {
-    endpoint: string;
-    payload: unknown;
+endpoint: string;
+payload: unknown;
 }): Promise<void>;
 /** Recover valid pending span envelopes from JSONL, skip malformed rows, and assign stable content-derived IDs to legacy entries for reconciliation. */
 declare function parsePendingOtelSpanLines(raw: string): PendingOtelSpan[];
@@ -310,15 +310,15 @@ declare function parsePendingOtelSpanLines(raw: string): PendingOtelSpan[];
 declare function isExpiredPendingOtelSpan(entry: PendingOtelSpan, cutoffMs: number): boolean;
 /** Drop oversized, expired, and attempt-exhausted spans, then keep the newest entries within the pending-span cap and report every removal. */
 declare function prunePendingOtelSpans(entries: PendingOtelSpan[], retentionDays: number): {
-    entries: PendingOtelSpan[];
-    prunedCount: number;
+entries: PendingOtelSpan[];
+prunedCount: number;
 };
 /** Atomically replace the span snapshot, retrying transient filesystem contention; callers coordinate mutations with the queue mutex. */
 declare function rewritePendingOtelSpans(globalPmRoot: string, entries: PendingOtelSpan[]): Promise<void>;
 /** Re-read the spans queue under the mutation serializer and rewrite it with the processed spans removed/updated by id, preserving any spans a concurrent foreground process appended during the (network) flush window. `succeededIds` are dropped; `failedUpdates` patch attempts/next_attempt_after by id; all other (incl. newly-appended) entries are retained, then pruned. Returns the count of spans left in the queue. Mirrors removeFlushedEntriesFromCurrentQueue. */
 declare function reconcilePendingOtelSpansAfterFlush(globalPmRoot: string, retentionDays: number, succeededIds: ReadonlySet<string>, failedUpdates: ReadonlyMap<string, {
-    attempts: number;
-    next_attempt_after: string;
+attempts: number;
+next_attempt_after: string;
 }>): Promise<number>;
 /** POST due spans outside the mutation mutex, then reconcile successes and retry metadata against the current queue; publish export diagnostics for health inspection. */
 declare function flushPendingOtelSpans(globalPmRoot: string, retentionDays: number): Promise<void>;
@@ -342,71 +342,71 @@ declare function acquireTelemetryFlushSpawnGate(globalPmRoot: string): boolean;
 declare function releaseTelemetryFlushSpawnGate(globalPmRoot: string): void;
 /** Public contract for test only, shared by SDK and presentation-layer consumers. */
 export declare const _testOnly: {
-    acquireTelemetryFlushSpawnGate: typeof acquireTelemetryFlushSpawnGate;
-    acquireTelemetryFlushLock: typeof acquireTelemetryFlushLock;
-    buildAuthorContextPayloadFields: typeof buildAuthorContextPayloadFields;
-    buildCommandErrorPayload: typeof buildCommandErrorPayload;
-    buildCommandFinishPayload: typeof buildCommandFinishPayload;
-    buildCommandStartPayload: typeof buildCommandStartPayload;
-    buildOtelSpanRequest: typeof buildOtelSpanRequest;
-    createDirectoryLock: typeof createDirectoryLock;
-    enqueuePendingOtelSpan: typeof enqueuePendingOtelSpan;
-    enqueueTelemetryEvent: typeof enqueueTelemetryEvent;
-    errorCode: typeof errorCode;
-    flushPendingOtelSpans: typeof flushPendingOtelSpans;
-    flushQueue: typeof flushQueue;
-    flushQueueWithProcessLock: typeof flushQueueWithProcessLock;
-    flushTelemetryArtifacts: typeof flushTelemetryArtifacts;
-    hashTelemetryErrorFingerprint: typeof hashTelemetryErrorFingerprint;
-    hashTelemetryValue: typeof hashTelemetryValue;
-    isEmailDomainCharacter: typeof isEmailDomainCharacter;
-    isEmailLocalCharacter: typeof isEmailLocalCharacter;
-    isExpiredPendingOtelSpan: typeof isExpiredPendingOtelSpan;
-    isExpiredQueueEntry: typeof isExpiredQueueEntry;
-    isFreshDirectoryLock: typeof isFreshDirectoryLock;
-    isDueForRetry: typeof isDueForRetry;
-    isDueForRetryAt: typeof isDueForRetryAt;
-    isRetryableQueueRewriteError: typeof isRetryableQueueRewriteError;
-    looksLikeEmailToken: typeof looksLikeEmailToken;
-    otelSpansQueuePath: typeof otelSpansQueuePath;
-    parseBooleanTrueLike: typeof parseBooleanTrueLike;
-    postTelemetryJson: typeof postTelemetryJson;
-    parsePendingOtelSpanLines: typeof parsePendingOtelSpanLines;
-    prunePendingOtelSpans: typeof prunePendingOtelSpans;
-    reconcilePendingOtelSpansAfterFlush: typeof reconcilePendingOtelSpansAfterFlush;
-    retentionCutoffMs: typeof retentionCutoffMs;
-    resolveOtelTracesEndpoint: typeof resolveOtelTracesEndpoint;
-    resolveTelemetryHttpTimeoutMs: typeof resolveTelemetryHttpTimeoutMs;
-    rewritePendingOtelSpans: typeof rewritePendingOtelSpans;
-    normalizeForHash: typeof normalizeForHash;
-    normalizeCaptureLevel: typeof normalizeCaptureLevel;
-    normalizePmVersion: typeof normalizePmVersion;
-    normalizeTelemetryErrorCategory: typeof normalizeTelemetryErrorCategory;
-    normalizeTelemetryErrorCode: typeof normalizeTelemetryErrorCode;
-    normalizeTelemetryExitCode: typeof normalizeTelemetryExitCode;
-    parseQueueLines: typeof parseQueueLines;
-    pruneExpiredQueueEntries: typeof pruneExpiredQueueEntries;
-    readRuntimeState: typeof readRuntimeState;
-    readCurrentQueueEntries: typeof readCurrentQueueEntries;
-    releaseTelemetryFlushSpawnGate: typeof releaseTelemetryFlushSpawnGate;
-    removeFlushedEntriesFromCurrentQueue: typeof removeFlushedEntriesFromCurrentQueue;
-    removeDirectoryLockBestEffort: typeof removeDirectoryLockBestEffort;
-    resolveTelemetrySourceContext: typeof resolveTelemetrySourceContext;
-    rewriteQueue: typeof rewriteQueue;
-    sanitizeCommandArgs: typeof sanitizeCommandArgs;
-    sanitizeStringMax: typeof sanitizeStringMax;
-    sanitizeStringRedacted: typeof sanitizeStringRedacted;
-    sanitizeValue: typeof sanitizeValue;
-    scheduleTelemetryFlush: typeof scheduleTelemetryFlush;
-    shouldFlushInline: typeof shouldFlushInline;
-    sleep: typeof sleep;
-    summarizeResult: typeof summarizeResult;
-    telemetryFlushRunnerPath: typeof telemetryFlushRunnerPath;
-    withQueueMutation: typeof withQueueMutation;
-    flushLockPath: typeof flushLockPath;
-    flushSpawnLockPath: typeof flushSpawnLockPath;
-    runtimeStatePath: typeof runtimeStatePath;
-    writeRuntimeState: typeof writeRuntimeState;
+acquireTelemetryFlushSpawnGate: typeof acquireTelemetryFlushSpawnGate;
+acquireTelemetryFlushLock: typeof acquireTelemetryFlushLock;
+buildAuthorContextPayloadFields: typeof buildAuthorContextPayloadFields;
+buildCommandErrorPayload: typeof buildCommandErrorPayload;
+buildCommandFinishPayload: typeof buildCommandFinishPayload;
+buildCommandStartPayload: typeof buildCommandStartPayload;
+buildOtelSpanRequest: typeof buildOtelSpanRequest;
+createDirectoryLock: typeof createDirectoryLock;
+enqueuePendingOtelSpan: typeof enqueuePendingOtelSpan;
+enqueueTelemetryEvent: typeof enqueueTelemetryEvent;
+errorCode: typeof errorCode;
+flushPendingOtelSpans: typeof flushPendingOtelSpans;
+flushQueue: typeof flushQueue;
+flushQueueWithProcessLock: typeof flushQueueWithProcessLock;
+flushTelemetryArtifacts: typeof flushTelemetryArtifacts;
+hashTelemetryErrorFingerprint: typeof hashTelemetryErrorFingerprint;
+hashTelemetryValue: typeof hashTelemetryValue;
+isEmailDomainCharacter: typeof isEmailDomainCharacter;
+isEmailLocalCharacter: typeof isEmailLocalCharacter;
+isExpiredPendingOtelSpan: typeof isExpiredPendingOtelSpan;
+isExpiredQueueEntry: typeof isExpiredQueueEntry;
+isFreshDirectoryLock: typeof isFreshDirectoryLock;
+isDueForRetry: typeof isDueForRetry;
+isDueForRetryAt: typeof isDueForRetryAt;
+isRetryableQueueRewriteError: typeof isRetryableQueueRewriteError;
+looksLikeEmailToken: typeof looksLikeEmailToken;
+otelSpansQueuePath: typeof otelSpansQueuePath;
+parseBooleanTrueLike: typeof parseBooleanTrueLike;
+postTelemetryJson: typeof postTelemetryJson;
+parsePendingOtelSpanLines: typeof parsePendingOtelSpanLines;
+prunePendingOtelSpans: typeof prunePendingOtelSpans;
+reconcilePendingOtelSpansAfterFlush: typeof reconcilePendingOtelSpansAfterFlush;
+retentionCutoffMs: typeof retentionCutoffMs;
+resolveOtelTracesEndpoint: typeof resolveOtelTracesEndpoint;
+resolveTelemetryHttpTimeoutMs: typeof resolveTelemetryHttpTimeoutMs;
+rewritePendingOtelSpans: typeof rewritePendingOtelSpans;
+normalizeForHash: typeof normalizeForHash;
+normalizeCaptureLevel: typeof normalizeCaptureLevel;
+normalizePmVersion: typeof normalizePmVersion;
+normalizeTelemetryErrorCategory: typeof normalizeTelemetryErrorCategory;
+normalizeTelemetryErrorCode: typeof normalizeTelemetryErrorCode;
+normalizeTelemetryExitCode: typeof normalizeTelemetryExitCode;
+parseQueueLines: typeof parseQueueLines;
+pruneExpiredQueueEntries: typeof pruneExpiredQueueEntries;
+readRuntimeState: typeof readRuntimeState;
+readCurrentQueueEntries: typeof readCurrentQueueEntries;
+releaseTelemetryFlushSpawnGate: typeof releaseTelemetryFlushSpawnGate;
+removeFlushedEntriesFromCurrentQueue: typeof removeFlushedEntriesFromCurrentQueue;
+removeDirectoryLockBestEffort: typeof removeDirectoryLockBestEffort;
+resolveTelemetrySourceContext: typeof resolveTelemetrySourceContext;
+rewriteQueue: typeof rewriteQueue;
+sanitizeCommandArgs: typeof sanitizeCommandArgs;
+sanitizeStringMax: typeof sanitizeStringMax;
+sanitizeStringRedacted: typeof sanitizeStringRedacted;
+sanitizeValue: typeof sanitizeValue;
+scheduleTelemetryFlush: typeof scheduleTelemetryFlush;
+shouldFlushInline: typeof shouldFlushInline;
+sleep: typeof sleep;
+summarizeResult: typeof summarizeResult;
+telemetryFlushRunnerPath: typeof telemetryFlushRunnerPath;
+withQueueMutation: typeof withQueueMutation;
+flushLockPath: typeof flushLockPath;
+flushSpawnLockPath: typeof flushSpawnLockPath;
+runtimeStatePath: typeof runtimeStatePath;
+writeRuntimeState: typeof writeRuntimeState;
 };
 declare function flushQueueWithProcessLock(globalPmRoot: string, endpoint: string, retentionDays: number): Promise<void>;
 declare function scheduleTelemetryFlush(globalPmRoot: string, endpoint: string, retentionDays: number): void;