@unbrained/pm-cli 2026.10.14 → 2026.10.17

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

@@ -1,196 +1,196 @@
 import { PM_TELEMETRY_SOURCE_CONTEXT_VALUES } from "./policy.js";
 import type { GlobalOptions } from "../shared/command-types.js";
 import { type TelemetryErrorCategory } from "../shared/constants.js";
-import { type TelemetryCommandResolution, type TelemetryCommandTaxonomy, type TelemetryResolutionStage } from "./observability.js";
+import { type TelemetryCommandResolution,type TelemetryCommandTaxonomy,type TelemetryResolutionStage } from "./observability.js";
 /** Public contract for telemetry schema version, shared by SDK and presentation-layer consumers. */
 export declare const TELEMETRY_SCHEMA_VERSION = 1;
 /** Public contract for telemetry max queue entry attempts, shared by SDK and presentation-layer consumers. */
 export declare const TELEMETRY_MAX_QUEUE_ENTRY_ATTEMPTS = 15;
 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>;
+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;
+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;
+sample_rate?:number;
 /** ISO 8601 timestamp recording when started occurred. */
-started_at: string;
+started_at:string;
 /** Elapsed time in milliseconds for started at. */
-started_at_ms: number;
+started_at_ms:number;
 /** Value that configures or reports command for this contract. */
-command: string;
+command:string;
 /** Value that configures or reports command taxonomy for this contract. */
-command_taxonomy: TelemetryCommandTaxonomy;
+command_taxonomy:TelemetryCommandTaxonomy;
 /** Value that configures or reports pm version for this contract. */
-pm_version: string;
+pm_version:string;
 /** Value that configures or reports source context for this contract. */
-source_context: TelemetrySourceContext;
+source_context:TelemetrySourceContext;
 /** Whether attribution was inferred, explicitly accepted, or inferred after rejecting an override without retaining its value. */
-source_context_source: TelemetrySourceContextSource;
+source_context_source:TelemetrySourceContextSource;
 /** Value that configures or reports installation id for this contract. */
-installation_id: string;
+installation_id:string;
 /** Value that configures or reports pm root hash for this contract. */
-pm_root_hash: string;
+pm_root_hash:string;
 /** Value that configures or reports cwd hash for this contract. */
-cwd_hash: string;
+cwd_hash:string;
 /** Value that configures or reports endpoint for this contract. */
-endpoint: string;
+endpoint:string;
 /** Value that configures or reports retention days for this contract. */
-retention_days: number;
+retention_days:number;
 /** Value that configures or reports global pm root for this contract. */
-global_pm_root: string;
+global_pm_root:string;
 /** Value that configures or reports capture level for this contract. */
-capture_level: TelemetryCaptureLevel;
+capture_level:TelemetryCaptureLevel;
 /** Value that configures or reports otel traces endpoint for this contract. */
-otel_traces_endpoint?: string;
+otel_traces_endpoint?:string;
 /** Value that configures or reports otel trace id for this contract. */
-otel_trace_id?: string;
+otel_trace_id?:string;
 /** Value that configures or reports otel span id for this contract. */
-otel_span_id?: string;
+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;
+command:string;
 /** Value that configures or reports pm version for this contract. */
-pm_version: string;
+pm_version:string;
 /** Value that configures or reports args for this contract. */
-args: string[];
+args:string[];
 /** Value that configures or reports options for this contract. */
-options: Record<string, unknown>;
+options:Record<string,unknown>;
 /** Value that configures or reports global for this contract. */
-global: GlobalOptions;
+global:GlobalOptions;
 /** Value that configures or reports pm root for this contract. */
-pm_root: string;
+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;
+ok:boolean;
 /** Value that configures or reports error for this contract. */
-error?: string;
+error?:string;
 /** Value that configures or reports result for this contract. */
-result?: unknown;
+result?:unknown;
 /** Value that configures or reports exit code for this contract. */
-exit_code?: number;
+exit_code?:number;
 /** Value that configures or reports error code for this contract. */
-error_code?: string;
+error_code?:string;
 /** Value that configures or reports error category for this contract. */
-error_category?: TelemetryErrorCategory;
+error_category?:TelemetryErrorCategory;
 /** Value that configures or reports command resolution for this contract. */
-command_resolution?: TelemetryCommandResolution;
+command_resolution?:TelemetryCommandResolution;
 /** Value that configures or reports resolution stage for this contract. */
-resolution_stage?: TelemetryResolutionStage;
+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;
+command:string;
 /** Value that configures or reports args for this contract. */
-args: string[];
+args:string[];
 /** Value that configures or reports options for this contract. */
-options: Record<string, unknown>;
+options:Record<string,unknown>;
 /** Value that configures or reports global for this contract. */
-global: GlobalOptions;
+global:GlobalOptions;
 /** Value that configures or reports pm version for this contract. */
-pm_version: string;
+pm_version:string;
 /** Value that configures or reports pm root for this contract. */
-pm_root: string;
+pm_root:string;
 /** Value that configures or reports error code for this contract. */
-error_code: string;
+error_code:string;
 /** Value that configures or reports error message for this contract. */
-error_message: string;
+error_message:string;
 /** Value that configures or reports exit code for this contract. */
-exit_code: number;
+exit_code:number;
 /** Value that configures or reports error category for this contract. */
-error_category?: TelemetryErrorCategory;
+error_category?:TelemetryErrorCategory;
 /** Value that configures or reports command resolution for this contract. */
-command_resolution?: TelemetryCommandResolution;
+command_resolution?:TelemetryCommandResolution;
 /** Value that configures or reports resolution stage for this contract. */
-resolution_stage?: TelemetryResolutionStage;
+resolution_stage?:TelemetryResolutionStage;
 }
-declare function otelSpansQueuePath(globalPmRoot: string): string;
-declare function runtimeStatePath(globalPmRoot: string): string;
-declare function flushLockPath(globalPmRoot: string): string;
-declare function flushSpawnLockPath(globalPmRoot: string): string;
-declare function telemetryFlushRunnerPath(): string;
-declare function shouldFlushInline(): boolean;
-declare function readRuntimeState(globalPmRoot: string): Promise<TelemetryRuntimeState>;
-declare function writeRuntimeState(globalPmRoot: string, patch: TelemetryRuntimeState): Promise<void>;
-declare function isEmailLocalCharacter(character: string | undefined): boolean;
-declare function isEmailDomainCharacter(character: string | undefined): boolean;
-declare function looksLikeEmailToken(token: string): boolean;
-declare function sanitizeStringRedacted(input: string): string;
-declare function sanitizeStringMax(input: string): string;
-declare function sanitizeValue(value: unknown, keyHint?: string, captureLevel?: Exclude<TelemetryCaptureLevel, "minimal">, depth?: number): unknown;
-declare function sanitizeCommandArgs(args: string[], captureLevel?: Exclude<TelemetryCaptureLevel, "minimal">): string[];
-declare function normalizeCaptureLevel(value: string | undefined): TelemetryCaptureLevel;
-declare function parseBooleanTrueLike(value: string | undefined): boolean;
+declare function otelSpansQueuePath(globalPmRoot:string):string;
+declare function runtimeStatePath(globalPmRoot:string):string;
+declare function flushLockPath(globalPmRoot:string):string;
+declare function flushSpawnLockPath(globalPmRoot:string):string;
+declare function telemetryFlushRunnerPath():string;
+declare function shouldFlushInline():boolean;
+declare function readRuntimeState(globalPmRoot:string):Promise<TelemetryRuntimeState>;
+declare function writeRuntimeState(globalPmRoot:string,patch:TelemetryRuntimeState):Promise<void>;
+declare function isEmailLocalCharacter(character:string | undefined):boolean;
+declare function isEmailDomainCharacter(character:string | undefined):boolean;
+declare function looksLikeEmailToken(token:string):boolean;
+declare function sanitizeStringRedacted(input:string):string;
+declare function sanitizeStringMax(input:string):string;
+declare function sanitizeValue(value:unknown,keyHint?:string,captureLevel?:Exclude<TelemetryCaptureLevel,"minimal">,depth?:number):unknown;
+declare function sanitizeCommandArgs(args:string[],captureLevel?:Exclude<TelemetryCaptureLevel,"minimal">):string[];
+declare function normalizeCaptureLevel(value:string | undefined):TelemetryCaptureLevel;
+declare function parseBooleanTrueLike(value:string | undefined):boolean;
 /** Resolve the background event and OTLP request timeout within the flush-lock safety envelope. */
-declare function resolveTelemetryHttpTimeoutMs(): number;
+declare function resolveTelemetryHttpTimeoutMs():number;
 /** POST a JSON payload with one total timeout that covers DNS, connection, TLS, and response completion. */
-declare function postTelemetryJson(endpoint: string, headers: Record<string, string>, body: string): Promise<number>;
+declare function postTelemetryJson(endpoint:string,headers:Record<string,string>,body:string):Promise<number>;
 /** Use a trimmed package version when provided, falling back to 0.0.0 for an unknown producer version. */
-declare function normalizePmVersion(value: string | undefined): string;
+declare function normalizePmVersion(value:string | undefined):string;
 /** Trim a supplied diagnostic code and omit missing or whitespace-only codes from event payloads. */
-declare function normalizeTelemetryErrorCode(value: string | undefined): string | undefined;
+declare function normalizeTelemetryErrorCode(value:string | undefined):string | undefined;
 /** Preserve finite non-negative integer exit codes; otherwise derive zero for success and one for failure. */
-declare function normalizeTelemetryExitCode(exitCode: number | undefined, ok: boolean): number;
+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;
-}): TelemetryErrorCategory | undefined;
+declare function normalizeTelemetryErrorCategory(params:{
+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;
+declare function resolveTelemetrySourceContext(globalOptions:GlobalOptions):ResolvedTelemetrySourceContext;
 /**
  * Builds privacy-bounded author and agent dimensions for a telemetry payload.
  *
@@ -206,11 +206,11 @@ declare function resolveTelemetrySourceContext(globalOptions: GlobalOptions): Re
  * invocation/session identifier is deliberately excluded at every capture
  * level. At minimal capture only presence booleans are surfaced.
  */
-declare function buildAuthorContextPayloadFields(captureLevel: TelemetryCaptureLevel, installationId: string): Record<string, unknown>;
-declare function normalizeForHash(value: unknown, depth?: number): unknown;
-declare function hashTelemetryValue(installationId: string, value: unknown): string;
-declare function hashTelemetryErrorFingerprint(installationId: string, command: string, errorCode: string | undefined, errorMessage: string | undefined): string;
-declare function resolveOtelTracesEndpoint(): string | null;
+declare function buildAuthorContextPayloadFields(captureLevel:TelemetryCaptureLevel,installationId:string):Record<string,unknown>;
+declare function normalizeForHash(value:unknown,depth?:number):unknown;
+declare function hashTelemetryValue(installationId:string,value:unknown):string;
+declare function hashTelemetryErrorFingerprint(installationId:string,command:string,errorCode:string | undefined,errorMessage:string | undefined):string;
+declare function resolveOtelTracesEndpoint():string | null;
 /**
  * Build the OTLP trace-export request for a finished command without performing
  * any network I/O. Returns `null` when OTLP export is not configured (no traces
@@ -218,203 +218,203 @@ declare function resolveOtelTracesEndpoint(): string | null;
  * via {@link enqueuePendingOtelSpan} so the foreground command never blocks on a
  * connecting socket (GH-209).
  */
-declare function buildOtelSpanRequest(activeCommand: ActiveTelemetryCommand, outcome: {
-ok: boolean;
-error?: string;
-exit_code?: number;
-error_code?: string;
-error_category?: TelemetryErrorCategory;
-}, finishedAtIso: string, durationMs: number, sampleRate?: number): {
-endpoint: string;
-payload: unknown;
+declare function buildOtelSpanRequest(activeCommand:ActiveTelemetryCommand,outcome:{
+ok:boolean;
+error?:string;
+exit_code?:number;
+error_code?:string;
+error_category?:TelemetryErrorCategory;
+},finishedAtIso:string,durationMs:number,sampleRate?:number):{
+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>;
+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;
-}): Record<string, unknown>;
+declare function buildCommandStartPayload(params:{
+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;
-}): Record<string, unknown>;
+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;
+}):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;
-}): Record<string, unknown>;
+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;
+}):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>;
+declare function enqueueTelemetryEvent(globalPmRoot:string,event:TelemetryEvent):Promise<void>;
 /** Recover well-shaped event envelopes from JSONL while discarding malformed lines so one corrupt record cannot strand delivery. */
-declare function parseQueueLines(raw: string): QueuedTelemetryEvent[];
+declare function parseQueueLines(raw:string):QueuedTelemetryEvent[];
 /** Allow immediate retry when scheduling metadata is absent or malformed; otherwise compare its timestamp with the current time. */
-declare function isDueForRetryAt(nextAttemptAfter: string | undefined): boolean;
+declare function isDueForRetryAt(nextAttemptAfter:string | undefined):boolean;
 /** Apply the shared due-time policy to an event envelope without altering its retry metadata. */
-declare function isDueForRetry(entry: QueuedTelemetryEvent): boolean;
+declare function isDueForRetry(entry:QueuedTelemetryEvent):boolean;
 /** Convert a finite retention duration to a cutoff using at least one whole day; invalid durations fall back to one day. */
-declare function retentionCutoffMs(retentionDays: number): number;
+declare function retentionCutoffMs(retentionDays:number):number;
 /** Expire only events with a valid occurrence timestamp before the cutoff; unknown dates do not establish expiration. */
-declare function isExpiredQueueEntry(entry: QueuedTelemetryEvent, cutoffMs: number): boolean;
+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;
+declare function pruneExpiredQueueEntries(entries:QueuedTelemetryEvent[],retentionDays: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>;
+declare function rewriteQueue(globalPmRoot:string,entries:QueuedTelemetryEvent[]):Promise<void>;
 /** Recognize only access, busy, and permission filesystem codes as transient atomic-rewrite failures. */
-declare function isRetryableQueueRewriteError(error: unknown): boolean;
+declare function isRetryableQueueRewriteError(error:unknown):boolean;
 /** Yield for the requested retry delay without synchronously blocking the process. */
-declare function sleep(milliseconds: number): Promise<void>;
+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;
-}): Promise<void>;
+declare function enqueuePendingOtelSpan(globalPmRoot:string,request:{
+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[];
+declare function parsePendingOtelSpanLines(raw:string):PendingOtelSpan[];
 /** Compare valid enqueue timestamps with the retention cutoff; retain unknown or malformed dates rather than inventing an age. */
-declare function isExpiredPendingOtelSpan(entry: PendingOtelSpan, cutoffMs: number): boolean;
+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;
+declare function prunePendingOtelSpans(entries:PendingOtelSpan[],retentionDays: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>;
+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;
-}>): Promise<number>;
+declare function reconcilePendingOtelSpansAfterFlush(globalPmRoot:string,retentionDays:number,succeededIds:ReadonlySet<string>,failedUpdates:ReadonlyMap<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>;
+declare function flushPendingOtelSpans(globalPmRoot:string,retentionDays:number):Promise<void>;
 /** Flush both telemetry artifacts under the same worker invocation: the event ingest queue and the pending OTLP span queue. Used by the detached flush worker and the inline (test) path so OTLP export always happens off the foreground command's critical path. */
-declare function flushTelemetryArtifacts(globalPmRoot: string, endpoint: string, retentionDays: number): Promise<void>;
+declare function flushTelemetryArtifacts(globalPmRoot:string,endpoint:string,retentionDays:number):Promise<void>;
 export { withQueueMutation as withTelemetryQueueMutation };
 /** Serialize complete queue transactions across processes. The per-acquisition wait defaults to five seconds for maintenance; foreground capture supplies a shorter budget. PM_LOCK_WAIT_MS remains an explicit override. Never hold the lock during network I/O. */
-declare function withQueueMutation<T>(operation: () => Promise<T>, globalPmRoot?: string, waitMs?: number): Promise<T>;
+declare function withQueueMutation<T>(operation:() => Promise<T>,globalPmRoot?:string,waitMs?:number):Promise<T>;
 /** Read the current event snapshot, treating a missing or blank queue as empty and dropping malformed records through the shared parser. */
-declare function readCurrentQueueEntries(globalPmRoot: string): Promise<QueuedTelemetryEvent[]>;
+declare function readCurrentQueueEntries(globalPmRoot:string):Promise<QueuedTelemetryEvent[]>;
 /** Remove acknowledged event IDs and expired entries from a fresh locked snapshot, returning the retained queue including intervening appends. */
-declare function removeFlushedEntriesFromCurrentQueue(globalPmRoot: string, flushedIds: ReadonlySet<string>, retentionDays: number): Promise<QueuedTelemetryEvent[]>;
+declare function removeFlushedEntriesFromCurrentQueue(globalPmRoot:string,flushedIds:ReadonlySet<string>,retentionDays:number):Promise<QueuedTelemetryEvent[]>;
 /** Send one due event batch without holding the mutation mutex, then reconcile its result against the current queue and record delivery diagnostics. */
-declare function flushQueue(globalPmRoot: string, endpoint: string, retentionDays: number): Promise<void>;
-declare function acquireTelemetryFlushLock(globalPmRoot: string): Promise<boolean>;
-declare function isFreshDirectoryLock(lockPath: string, staleMs: number): boolean;
-declare function removeDirectoryLockBestEffort(lockPath: string): void;
-declare function errorCode(error: unknown): string | undefined;
-declare function createDirectoryLock(lockPath: string): boolean;
-declare function acquireTelemetryFlushSpawnGate(globalPmRoot: string): boolean;
-declare function releaseTelemetryFlushSpawnGate(globalPmRoot: string): void;
+declare function flushQueue(globalPmRoot:string,endpoint:string,retentionDays:number):Promise<void>;
+declare function acquireTelemetryFlushLock(globalPmRoot:string):Promise<boolean>;
+declare function isFreshDirectoryLock(lockPath:string,staleMs:number):boolean;
+declare function removeDirectoryLockBestEffort(lockPath:string):void;
+declare function errorCode(error:unknown):string | undefined;
+declare function createDirectoryLock(lockPath:string):boolean;
+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;
+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;
 };
-declare function flushQueueWithProcessLock(globalPmRoot: string, endpoint: string, retentionDays: number): Promise<boolean>;
-declare function scheduleTelemetryFlush(globalPmRoot: string, endpoint: string, retentionDays: number): void;
+declare function flushQueueWithProcessLock(globalPmRoot:string,endpoint:string,retentionDays:number):Promise<boolean>;
+declare function scheduleTelemetryFlush(globalPmRoot:string,endpoint:string,retentionDays:number):void;
 /** Drain consented event and span queues without reviving removed storage in detached workers. Foreground SDK callers retain identity initialization; workers only read existing base settings and never scaffold directories, schemas or identities. */
-export declare function flushTelemetryQueueNow(globalPmRoot?: string): Promise<void>;
+export declare function flushTelemetryQueueNow(globalPmRoot?:string):Promise<void>;
 /** Atomically validate consent, initialize identity, and capture an invocation; defer sampled reads until their outcome determines pair retention and schedule delivery after releasing the mutex. */
-export declare function startTelemetryCommand(context: TelemetryCommandContext): Promise<ActiveTelemetryCommand | null>;
+export declare function startTelemetryCommand(context:TelemetryCommandContext):Promise<ActiveTelemetryCommand | null>;
 /** Complete an invocation only while process consent, saved consent, and its installation identity still agree; retain failed reads and weight selected successful pairs. */
-export declare function finishTelemetryCommand(activeCommand: ActiveTelemetryCommand | null, outcome: TelemetryCommandOutcome): Promise<void>;
+export declare function finishTelemetryCommand(activeCommand:ActiveTelemetryCommand | null,outcome:TelemetryCommandOutcome):Promise<void>;
 /** Atomically validate consent and append a sanitized command error with its installation identity; schedule delivery only after releasing the queue mutex. */
-export declare function emitTelemetryErrorEvent(context: TelemetryErrorEventContext): Promise<void>;
+export declare function emitTelemetryErrorEvent(context:TelemetryErrorEventContext):Promise<void>;