@noego/wood 0.4.9 → 0.5.0

package/dist/tracing/renderer_trace_batch_transport.cjs

@@ -38,6 +38,7 @@ class RendererTraceBatchTransport {
     this.droppedClosed = 0;
     this.droppedRejected = 0;
     this.droppedRetryExhausted = 0;
+    this.identityRestamped = 0;
     this.committedBatches = 0;
     this.retryAttempts = 0;
     this.metadataTruncatedValues = 0;
@@ -49,8 +50,8 @@ class RendererTraceBatchTransport {
     );
   }
   admit(event) {
-    const sequence = this.nextSequence;
-    this.nextSequence += 1;
+    const identity = this.resolveIdentity(event);
+    const sequence = identity.sequence;
     if (this.state !== "accepting") {
       this.droppedClosed += 1;
       return { kind: "dropped", sequence, reason: "closed" };
@@ -60,10 +61,46 @@ class RendererTraceBatchTransport {
       this.droppedCapacity += 1;
       return { kind: "dropped", sequence, reason: "capacity" };
     }
-    this.queue.push(Object.freeze({ sequence, event: this.snapshotEvent(event, sequence) }));
+    this.queue.push(Object.freeze({ sequence, event: this.snapshotEvent(event, sequence, identity) }));
     this.scheduleDrain();
     return { kind: "admitted", sequence };
   }
+  /**
+   * Resolves the queue sequence and preserved identity for an incoming event,
+   * reading identity fields from the raw input BEFORE metadata snapshotting so
+   * truncation/redaction can never alter identity.
+   *
+   * A hub-admitted event (valid timestamp + traceSeq) keeps its identity and
+   * its queue sequence is derived as traceSeq - 1 so the batch sequence range
+   * stays aligned with hub identity. A stamped event whose traceSeq regresses
+   * against the already-assigned sequence stream is restamped as legacy (its
+   * occurrence timestamp is still preserved, its producerId is dropped so a
+   * reassigned sequence cannot masquerade under the durable identity key) and
+   * counted in identityRestamped. Legacy events without identity are stamped
+   * exactly as before.
+   */
+  resolveIdentity(event) {
+    const rawTimestamp = typeof event.timestamp === "string" && Number.isFinite(Date.parse(event.timestamp)) ? event.timestamp : void 0;
+    const rawSeq = typeof event.traceSeq === "number" && Number.isSafeInteger(event.traceSeq) && event.traceSeq >= 1 ? event.traceSeq : void 0;
+    const producerId = typeof event.producerId === "string" && event.producerId.trim().length > 0 ? event.producerId : void 0;
+    if (rawTimestamp !== void 0 && rawSeq !== void 0 && rawSeq - 1 >= this.nextSequence) {
+      this.nextSequence = rawSeq;
+      return {
+        sequence: rawSeq - 1,
+        timestamp: rawTimestamp,
+        ...producerId !== void 0 ? { producerId } : {}
+      };
+    }
+    if (rawTimestamp !== void 0 && rawSeq !== void 0) {
+      this.identityRestamped += 1;
+    }
+    const sequence = this.nextSequence;
+    this.nextSequence += 1;
+    return {
+      sequence,
+      ...rawTimestamp !== void 0 ? { timestamp: rawTimestamp } : {}
+    };
+  }
   attachPort(port) {
     this.detachPort();
     this.port = port;
@@ -86,6 +123,7 @@ class RendererTraceBatchTransport {
       droppedClosed: this.droppedClosed,
       droppedRejected: this.droppedRejected,
       droppedRetryExhausted: this.droppedRetryExhausted,
+      identityRestamped: this.identityRestamped,
       metadataTruncatedValues: this.metadataTruncatedValues,
       metadataRedactedValues: this.metadataRedactedValues,
       metadataSerializationFailures: this.metadataSerializationFailures,
@@ -252,14 +290,17 @@ class RendererTraceBatchTransport {
       this.handleAcknowledgementTimeout(current.batch.batchId, attempt);
     });
   }
-  snapshotEvent(event, sequence) {
+  snapshotEvent(event, sequence, identity) {
     const snapshot = this.metadataSnapshotter.snapshot(event);
     this.metadataTruncatedValues += snapshot.stats.truncatedValues;
     this.metadataRedactedValues += snapshot.stats.redactedValues;
     this.metadataSerializationFailures += snapshot.stats.serializationFailures;
     const input = snapshot.metadata;
-    const occurredAt = new Date(this.options.now());
-    const timestamp = Number.isNaN(occurredAt.getTime()) ? (/* @__PURE__ */ new Date(0)).toISOString() : occurredAt.toISOString();
+    let timestamp = identity.timestamp;
+    if (timestamp === void 0) {
+      const occurredAt = new Date(this.options.now());
+      timestamp = Number.isNaN(occurredAt.getTime()) ? (/* @__PURE__ */ new Date(0)).toISOString() : occurredAt.toISOString();
+    }
     return Object.freeze({
       source: this.snapshotString(input.source, "unknown"),
       type: this.snapshotString(input.type, "unknown"),
@@ -267,6 +308,7 @@ class RendererTraceBatchTransport {
       process: "renderer",
       timestamp,
       traceSeq: sequence + 1,
+      ...identity.producerId !== void 0 ? { producerId: identity.producerId } : {},
       ...this.snapshotOptionalString("message", input.message),
       ...this.snapshotConversationId(input.conversationId),
       ...this.snapshotPayload(input.payload),

package/dist/tracing/renderer_trace_batch_transport.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/tracing/renderer_trace_batch_transport.ts"],"sourcesContent":["import {\n  BoundedMetadataSnapshotter,\n  DEFAULT_METADATA_SNAPSHOT_LIMITS,\n  type TelemetryJsonObject,\n  type TelemetryJsonValue,\n} from '@noego/telemetry/core';\nimport { WoodTraceBatchContract } from './wood_trace_batch_contract.js';\nimport type {\n  WoodRendererTraceEvent,\n  WoodRendererTraceInput,\n  WoodTraceBatch,\n  WoodTraceBatchAdmissionResult,\n  WoodTraceBatchPort,\n  WoodTraceBatchTransportOptions,\n  WoodTraceBatchTransportStatus,\n} from './types/wood_trace_batch.types.js';\n\ntype QueuedTraceEvent = Readonly<{\n  sequence: number;\n  event: WoodRendererTraceEvent;\n}>;\n\ntype InFlightTraceBatch = {\n  batch: WoodTraceBatch;\n  attempts: number;\n  awaitingAcknowledgement: boolean;\n  retryReady: boolean;\n  retryGeneration: number;\n};\n\nexport class RendererTraceBatchTransport {\n  private readonly contract = new WoodTraceBatchContract();\n  private readonly metadataSnapshotter: BoundedMetadataSnapshotter;\n  private readonly queue: QueuedTraceEvent[] = [];\n  private state: 'accepting' | 'draining' | 'stopped' = 'accepting';\n  private port: WoodTraceBatchPort | null = null;\n  private unsubscribePort: (() => void) | null = null;\n  private inFlight: InFlightTraceBatch | null = null;\n  private nextSequence = 0;\n  private drainScheduled = false;\n  private droppedCapacity = 0;\n  private droppedClosed = 0;\n  private droppedRejected = 0;\n  private droppedRetryExhausted = 0;\n  private committedBatches = 0;\n  private retryAttempts = 0;\n  private metadataTruncatedValues = 0;\n  private metadataRedactedValues = 0;\n  private metadataSerializationFailures = 0;\n\n  constructor(private readonly options: WoodTraceBatchTransportOptions) {\n    this.validateOptions();\n    this.metadataSnapshotter = new BoundedMetadataSnapshotter(\n      options.metadataSnapshotLimits ?? DEFAULT_METADATA_SNAPSHOT_LIMITS,\n    );\n  }\n\n  admit(event: WoodRendererTraceInput): WoodTraceBatchAdmissionResult {\n    const sequence = this.nextSequence;\n    this.nextSequence += 1;\n    if (this.state !== 'accepting') {\n      this.droppedClosed += 1;\n      return { kind: 'dropped', sequence, reason: 'closed' };\n    }\n\n    const retainedEvents = this.queue.length + (this.inFlight?.batch.events.length ?? 0);\n    if (retainedEvents >= this.options.maxQueuedEvents) {\n      this.droppedCapacity += 1;\n      return { kind: 'dropped', sequence, reason: 'capacity' };\n    }\n\n    this.queue.push(Object.freeze({ sequence, event: this.snapshotEvent(event, sequence) }));\n    this.scheduleDrain();\n    return { kind: 'admitted', sequence };\n  }\n\n  attachPort(port: WoodTraceBatchPort): void {\n    this.detachPort();\n    this.port = port;\n    this.unsubscribePort = port.subscribe((message) => this.handleAcknowledgement(message));\n    if (this.inFlight) {\n      this.inFlight.awaitingAcknowledgement = false;\n      this.inFlight.retryReady = true;\n      this.inFlight.retryGeneration += 1;\n    }\n    this.scheduleDrain();\n  }\n\n  status(): WoodTraceBatchTransportStatus {\n    return Object.freeze({\n      state: this.state,\n      producerId: this.options.producerId,\n      nextSequence: this.nextSequence,\n      queuedEvents: this.queue.length,\n      inFlightBatchId: this.inFlight?.batch.batchId ?? null,\n      droppedCapacity: this.droppedCapacity,\n      droppedClosed: this.droppedClosed,\n      droppedRejected: this.droppedRejected,\n      droppedRetryExhausted: this.droppedRetryExhausted,\n      metadataTruncatedValues: this.metadataTruncatedValues,\n      metadataRedactedValues: this.metadataRedactedValues,\n      metadataSerializationFailures: this.metadataSerializationFailures,\n      committedBatches: this.committedBatches,\n      retryAttempts: this.retryAttempts,\n    });\n  }\n\n  async flush(deadlineMs: number): Promise<void> {\n    this.scheduleDrain();\n    while (this.hasPendingEvents() && this.options.now() < deadlineMs) {\n      await this.options.delay(1);\n      this.scheduleDrain();\n    }\n  }\n\n  async close(deadlineMs: number): Promise<void> {\n    if (this.state === 'stopped') {\n      return;\n    }\n    this.state = 'draining';\n    await this.flush(deadlineMs);\n    const abandonedEvents = this.queue.length + (this.inFlight?.batch.events.length ?? 0);\n    this.droppedClosed += abandonedEvents;\n    this.queue.length = 0;\n    this.inFlight = null;\n    this.detachPort();\n    this.state = 'stopped';\n  }\n\n  private abandonRetryExhausted(): void {\n    if (!this.inFlight) {\n      return;\n    }\n    this.droppedRetryExhausted += this.inFlight.batch.events.length;\n    this.inFlight = null;\n    this.scheduleDrain();\n  }\n\n  private createInFlightBatch(): void {\n    if (this.inFlight || this.queue.length === 0 || !this.port) {\n      return;\n    }\n    const entries = this.queue.splice(0, this.options.maxBatchEvents);\n    const first = entries[0];\n    if (!first) {\n      return;\n    }\n    this.inFlight = {\n      batch: this.contract.create(\n        this.options.producerId,\n        first.sequence,\n        entries.map((entry) => entry.event),\n      ),\n      attempts: 0,\n      awaitingAcknowledgement: false,\n      retryReady: true,\n      retryGeneration: 0,\n    };\n  }\n\n  private detachPort(): void {\n    this.unsubscribePort?.();\n    this.unsubscribePort = null;\n    this.port?.close();\n    this.port = null;\n  }\n\n  private drain(): void {\n    this.createInFlightBatch();\n    this.sendInFlightBatch();\n  }\n\n  private handleAcknowledgement(message: unknown): void {\n    const parsed = this.contract.parseAcknowledgement(message);\n    if (!parsed.ok || !this.inFlight) {\n      return;\n    }\n    const acknowledgement = parsed.acknowledgement;\n    if (acknowledgement.batchId !== this.inFlight.batch.batchId) {\n      return;\n    }\n\n    this.inFlight.retryGeneration += 1;\n    this.inFlight.awaitingAcknowledgement = false;\n    if (acknowledgement.kind === 'committed') {\n      if (acknowledgement.acceptedEvents !== this.inFlight.batch.events.length) {\n        this.scheduleRetry(0);\n        return;\n      }\n      this.committedBatches += 1;\n      this.inFlight = null;\n      this.scheduleDrain();\n      return;\n    }\n    if (acknowledgement.kind === 'rejected') {\n      this.droppedRejected += this.inFlight.batch.events.length;\n      this.inFlight = null;\n      this.scheduleDrain();\n      return;\n    }\n    this.scheduleRetry(acknowledgement.retryAfterMs);\n  }\n\n  private handleAcknowledgementTimeout(batchId: string, attempt: number): void {\n    if (!this.inFlight\n      || this.inFlight.batch.batchId !== batchId\n      || this.inFlight.attempts !== attempt\n      || !this.inFlight.awaitingAcknowledgement) {\n      return;\n    }\n    this.inFlight.awaitingAcknowledgement = false;\n    this.scheduleRetry(this.retryDelay(attempt));\n  }\n\n  private hasPendingEvents(): boolean {\n    return this.queue.length > 0 || this.inFlight !== null;\n  }\n\n  private retryDelay(attempt: number): number {\n    return this.options.retryBaseDelayMs * (2 ** Math.max(0, attempt - 1));\n  }\n\n  private scheduleDrain(): void {\n    if (this.drainScheduled) {\n      return;\n    }\n    this.drainScheduled = true;\n    this.options.schedule(() => {\n      this.drainScheduled = false;\n      this.drain();\n    });\n  }\n\n  private scheduleRetry(requestedDelayMs: number): void {\n    if (!this.inFlight) {\n      return;\n    }\n    if (this.inFlight.attempts > this.options.retryLimit) {\n      this.abandonRetryExhausted();\n      return;\n    }\n\n    this.inFlight.retryReady = false;\n    const generation = this.inFlight.retryGeneration + 1;\n    this.inFlight.retryGeneration = generation;\n    const delayMs = Math.max(requestedDelayMs, this.retryDelay(this.inFlight.attempts));\n    void this.options.delay(delayMs).then(() => {\n      if (!this.inFlight || this.inFlight.retryGeneration !== generation) {\n        return;\n      }\n      this.inFlight.retryReady = true;\n      this.scheduleDrain();\n    });\n  }\n\n  private sendInFlightBatch(): void {\n    const current = this.inFlight;\n    const port = this.port;\n    if (!current || !port || current.awaitingAcknowledgement || !current.retryReady) {\n      return;\n    }\n    if (current.attempts > this.options.retryLimit) {\n      this.abandonRetryExhausted();\n      return;\n    }\n\n    current.attempts += 1;\n    if (current.attempts > 1) {\n      this.retryAttempts += 1;\n    }\n    current.awaitingAcknowledgement = true;\n    current.retryReady = false;\n    const attempt = current.attempts;\n    try {\n      port.postMessage(current.batch);\n    } catch {\n      current.awaitingAcknowledgement = false;\n      this.detachPort();\n      return;\n    }\n\n    void this.options.delay(this.options.acknowledgementTimeoutMs).then(() => {\n      this.handleAcknowledgementTimeout(current.batch.batchId, attempt);\n    });\n  }\n\n  private snapshotEvent(\n    event: WoodRendererTraceInput,\n    sequence: number,\n  ): WoodRendererTraceEvent {\n    const snapshot = this.metadataSnapshotter.snapshot(event);\n    this.metadataTruncatedValues += snapshot.stats.truncatedValues;\n    this.metadataRedactedValues += snapshot.stats.redactedValues;\n    this.metadataSerializationFailures += snapshot.stats.serializationFailures;\n    const input = snapshot.metadata;\n    const occurredAt = new Date(this.options.now());\n    const timestamp = Number.isNaN(occurredAt.getTime())\n      ? new Date(0).toISOString()\n      : occurredAt.toISOString();\n    return Object.freeze({\n      source: this.snapshotString(input.source, 'unknown'),\n      type: this.snapshotString(input.type, 'unknown'),\n      level: this.snapshotString(input.level, 'info'),\n      process: 'renderer',\n      timestamp,\n      traceSeq: sequence + 1,\n      ...this.snapshotOptionalString('message', input.message),\n      ...this.snapshotConversationId(input.conversationId),\n      ...this.snapshotPayload(input.payload),\n      ...this.snapshotOptionalString('windowId', input.windowId),\n      ...this.snapshotOptionalNumber('webContentsId', input.webContentsId),\n      ...this.snapshotOptionalString('routeKey', input.routeKey),\n      ...this.snapshotOptionalString('harnessId', input.harnessId),\n    });\n  }\n\n  private snapshotConversationId(\n    value: TelemetryJsonValue | undefined,\n  ): Pick<WoodRendererTraceEvent, 'conversationId'> | Record<string, never> {\n    return typeof value === 'string' || typeof value === 'number'\n      ? { conversationId: value }\n      : {};\n  }\n\n  private snapshotOptionalNumber<Key extends 'webContentsId'>(\n    key: Key,\n    value: TelemetryJsonValue | undefined,\n  ): Partial<Pick<WoodRendererTraceEvent, Key>> {\n    return typeof value === 'number' && Number.isFinite(value)\n      ? { [key]: value } as Pick<WoodRendererTraceEvent, Key>\n      : {};\n  }\n\n  private snapshotOptionalString<Key extends 'message' | 'windowId' | 'routeKey' | 'harnessId'>(\n    key: Key,\n    value: TelemetryJsonValue | undefined,\n  ): Partial<Pick<WoodRendererTraceEvent, Key>> {\n    return typeof value === 'string'\n      ? { [key]: value } as Pick<WoodRendererTraceEvent, Key>\n      : {};\n  }\n\n  private snapshotPayload(\n    value: TelemetryJsonValue | undefined,\n  ): Pick<WoodRendererTraceEvent, 'payload'> | Record<string, never> {\n    if (value === undefined) {\n      return {};\n    }\n    const payload: TelemetryJsonObject = this.isJsonObject(value)\n      ? value\n      : Object.freeze({ __telemetry: value });\n    return { payload };\n  }\n\n  private snapshotString(value: TelemetryJsonValue | undefined, fallback: string): string {\n    return typeof value === 'string' && value.trim().length > 0 ? value : fallback;\n  }\n\n  private isJsonObject(value: TelemetryJsonValue): value is TelemetryJsonObject {\n    return typeof value === 'object' && value !== null && !Array.isArray(value);\n  }\n\n  private validateOptions(): void {\n    const validCapacity = Number.isSafeInteger(this.options.maxQueuedEvents)\n      && this.options.maxQueuedEvents > 0\n      && Number.isSafeInteger(this.options.maxBatchEvents)\n      && this.options.maxBatchEvents > 0\n      && this.options.maxBatchEvents <= this.options.maxQueuedEvents;\n    const validRetry = Number.isSafeInteger(this.options.retryLimit)\n      && this.options.retryLimit >= 0\n      && Number.isFinite(this.options.retryBaseDelayMs)\n      && this.options.retryBaseDelayMs >= 0\n      && Number.isFinite(this.options.acknowledgementTimeoutMs)\n      && this.options.acknowledgementTimeoutMs > 0;\n    if (!this.options.producerId.trim() || !validCapacity || !validRetry) {\n      throw new Error('Renderer trace batch transport options are invalid');\n    }\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/tracing/renderer_trace_batch_transport.ts"],"sourcesContent":["import {\n  BoundedMetadataSnapshotter,\n  DEFAULT_METADATA_SNAPSHOT_LIMITS,\n  type TelemetryJsonObject,\n  type TelemetryJsonValue,\n} from '@noego/telemetry/core';\nimport { WoodTraceBatchContract } from './wood_trace_batch_contract.js';\nimport type {\n  WoodRendererTraceEvent,\n  WoodRendererTraceInput,\n  WoodTraceBatch,\n  WoodTraceBatchAdmissionResult,\n  WoodTraceBatchPort,\n  WoodTraceBatchTransportOptions,\n  WoodTraceBatchTransportStatus,\n} from './types/wood_trace_batch.types.js';\n\ntype QueuedTraceEvent = Readonly<{\n  sequence: number;\n  event: WoodRendererTraceEvent;\n}>;\n\ntype InFlightTraceBatch = {\n  batch: WoodTraceBatch;\n  attempts: number;\n  awaitingAcknowledgement: boolean;\n  retryReady: boolean;\n  retryGeneration: number;\n};\n\nexport class RendererTraceBatchTransport {\n  private readonly contract = new WoodTraceBatchContract();\n  private readonly metadataSnapshotter: BoundedMetadataSnapshotter;\n  private readonly queue: QueuedTraceEvent[] = [];\n  private state: 'accepting' | 'draining' | 'stopped' = 'accepting';\n  private port: WoodTraceBatchPort | null = null;\n  private unsubscribePort: (() => void) | null = null;\n  private inFlight: InFlightTraceBatch | null = null;\n  private nextSequence = 0;\n  private drainScheduled = false;\n  private droppedCapacity = 0;\n  private droppedClosed = 0;\n  private droppedRejected = 0;\n  private droppedRetryExhausted = 0;\n  private identityRestamped = 0;\n  private committedBatches = 0;\n  private retryAttempts = 0;\n  private metadataTruncatedValues = 0;\n  private metadataRedactedValues = 0;\n  private metadataSerializationFailures = 0;\n\n  constructor(private readonly options: WoodTraceBatchTransportOptions) {\n    this.validateOptions();\n    this.metadataSnapshotter = new BoundedMetadataSnapshotter(\n      options.metadataSnapshotLimits ?? DEFAULT_METADATA_SNAPSHOT_LIMITS,\n    );\n  }\n\n  admit(event: WoodRendererTraceInput): WoodTraceBatchAdmissionResult {\n    const identity = this.resolveIdentity(event);\n    const sequence = identity.sequence;\n    if (this.state !== 'accepting') {\n      this.droppedClosed += 1;\n      return { kind: 'dropped', sequence, reason: 'closed' };\n    }\n\n    const retainedEvents = this.queue.length + (this.inFlight?.batch.events.length ?? 0);\n    if (retainedEvents >= this.options.maxQueuedEvents) {\n      this.droppedCapacity += 1;\n      return { kind: 'dropped', sequence, reason: 'capacity' };\n    }\n\n    this.queue.push(Object.freeze({ sequence, event: this.snapshotEvent(event, sequence, identity) }));\n    this.scheduleDrain();\n    return { kind: 'admitted', sequence };\n  }\n\n  /**\n   * Resolves the queue sequence and preserved identity for an incoming event,\n   * reading identity fields from the raw input BEFORE metadata snapshotting so\n   * truncation/redaction can never alter identity.\n   *\n   * A hub-admitted event (valid timestamp + traceSeq) keeps its identity and\n   * its queue sequence is derived as traceSeq - 1 so the batch sequence range\n   * stays aligned with hub identity. A stamped event whose traceSeq regresses\n   * against the already-assigned sequence stream is restamped as legacy (its\n   * occurrence timestamp is still preserved, its producerId is dropped so a\n   * reassigned sequence cannot masquerade under the durable identity key) and\n   * counted in identityRestamped. Legacy events without identity are stamped\n   * exactly as before.\n   */\n  private resolveIdentity(event: WoodRendererTraceInput): {\n    sequence: number;\n    timestamp?: string;\n    producerId?: string;\n  } {\n    const rawTimestamp = typeof event.timestamp === 'string'\n      && Number.isFinite(Date.parse(event.timestamp))\n      ? event.timestamp\n      : undefined;\n    const rawSeq = typeof event.traceSeq === 'number'\n      && Number.isSafeInteger(event.traceSeq)\n      && event.traceSeq >= 1\n      ? event.traceSeq\n      : undefined;\n    const producerId = typeof event.producerId === 'string' && event.producerId.trim().length > 0\n      ? event.producerId\n      : undefined;\n\n    if (rawTimestamp !== undefined && rawSeq !== undefined && rawSeq - 1 >= this.nextSequence) {\n      this.nextSequence = rawSeq;\n      return {\n        sequence: rawSeq - 1,\n        timestamp: rawTimestamp,\n        ...(producerId !== undefined ? { producerId } : {}),\n      };\n    }\n\n    if (rawTimestamp !== undefined && rawSeq !== undefined) {\n      // Stamped but non-monotonic against this transport's sequence stream:\n      // protocol survival wins, durable sequence identity is sacrificed loudly.\n      this.identityRestamped += 1;\n    }\n\n    const sequence = this.nextSequence;\n    this.nextSequence += 1;\n    return {\n      sequence,\n      ...(rawTimestamp !== undefined ? { timestamp: rawTimestamp } : {}),\n    };\n  }\n\n  attachPort(port: WoodTraceBatchPort): void {\n    this.detachPort();\n    this.port = port;\n    this.unsubscribePort = port.subscribe((message) => this.handleAcknowledgement(message));\n    if (this.inFlight) {\n      this.inFlight.awaitingAcknowledgement = false;\n      this.inFlight.retryReady = true;\n      this.inFlight.retryGeneration += 1;\n    }\n    this.scheduleDrain();\n  }\n\n  status(): WoodTraceBatchTransportStatus {\n    return Object.freeze({\n      state: this.state,\n      producerId: this.options.producerId,\n      nextSequence: this.nextSequence,\n      queuedEvents: this.queue.length,\n      inFlightBatchId: this.inFlight?.batch.batchId ?? null,\n      droppedCapacity: this.droppedCapacity,\n      droppedClosed: this.droppedClosed,\n      droppedRejected: this.droppedRejected,\n      droppedRetryExhausted: this.droppedRetryExhausted,\n      identityRestamped: this.identityRestamped,\n      metadataTruncatedValues: this.metadataTruncatedValues,\n      metadataRedactedValues: this.metadataRedactedValues,\n      metadataSerializationFailures: this.metadataSerializationFailures,\n      committedBatches: this.committedBatches,\n      retryAttempts: this.retryAttempts,\n    });\n  }\n\n  async flush(deadlineMs: number): Promise<void> {\n    this.scheduleDrain();\n    while (this.hasPendingEvents() && this.options.now() < deadlineMs) {\n      await this.options.delay(1);\n      this.scheduleDrain();\n    }\n  }\n\n  async close(deadlineMs: number): Promise<void> {\n    if (this.state === 'stopped') {\n      return;\n    }\n    this.state = 'draining';\n    await this.flush(deadlineMs);\n    const abandonedEvents = this.queue.length + (this.inFlight?.batch.events.length ?? 0);\n    this.droppedClosed += abandonedEvents;\n    this.queue.length = 0;\n    this.inFlight = null;\n    this.detachPort();\n    this.state = 'stopped';\n  }\n\n  private abandonRetryExhausted(): void {\n    if (!this.inFlight) {\n      return;\n    }\n    this.droppedRetryExhausted += this.inFlight.batch.events.length;\n    this.inFlight = null;\n    this.scheduleDrain();\n  }\n\n  private createInFlightBatch(): void {\n    if (this.inFlight || this.queue.length === 0 || !this.port) {\n      return;\n    }\n    const entries = this.queue.splice(0, this.options.maxBatchEvents);\n    const first = entries[0];\n    if (!first) {\n      return;\n    }\n    this.inFlight = {\n      batch: this.contract.create(\n        this.options.producerId,\n        first.sequence,\n        entries.map((entry) => entry.event),\n      ),\n      attempts: 0,\n      awaitingAcknowledgement: false,\n      retryReady: true,\n      retryGeneration: 0,\n    };\n  }\n\n  private detachPort(): void {\n    this.unsubscribePort?.();\n    this.unsubscribePort = null;\n    this.port?.close();\n    this.port = null;\n  }\n\n  private drain(): void {\n    this.createInFlightBatch();\n    this.sendInFlightBatch();\n  }\n\n  private handleAcknowledgement(message: unknown): void {\n    const parsed = this.contract.parseAcknowledgement(message);\n    if (!parsed.ok || !this.inFlight) {\n      return;\n    }\n    const acknowledgement = parsed.acknowledgement;\n    if (acknowledgement.batchId !== this.inFlight.batch.batchId) {\n      return;\n    }\n\n    this.inFlight.retryGeneration += 1;\n    this.inFlight.awaitingAcknowledgement = false;\n    if (acknowledgement.kind === 'committed') {\n      if (acknowledgement.acceptedEvents !== this.inFlight.batch.events.length) {\n        this.scheduleRetry(0);\n        return;\n      }\n      this.committedBatches += 1;\n      this.inFlight = null;\n      this.scheduleDrain();\n      return;\n    }\n    if (acknowledgement.kind === 'rejected') {\n      this.droppedRejected += this.inFlight.batch.events.length;\n      this.inFlight = null;\n      this.scheduleDrain();\n      return;\n    }\n    this.scheduleRetry(acknowledgement.retryAfterMs);\n  }\n\n  private handleAcknowledgementTimeout(batchId: string, attempt: number): void {\n    if (!this.inFlight\n      || this.inFlight.batch.batchId !== batchId\n      || this.inFlight.attempts !== attempt\n      || !this.inFlight.awaitingAcknowledgement) {\n      return;\n    }\n    this.inFlight.awaitingAcknowledgement = false;\n    this.scheduleRetry(this.retryDelay(attempt));\n  }\n\n  private hasPendingEvents(): boolean {\n    return this.queue.length > 0 || this.inFlight !== null;\n  }\n\n  private retryDelay(attempt: number): number {\n    return this.options.retryBaseDelayMs * (2 ** Math.max(0, attempt - 1));\n  }\n\n  private scheduleDrain(): void {\n    if (this.drainScheduled) {\n      return;\n    }\n    this.drainScheduled = true;\n    this.options.schedule(() => {\n      this.drainScheduled = false;\n      this.drain();\n    });\n  }\n\n  private scheduleRetry(requestedDelayMs: number): void {\n    if (!this.inFlight) {\n      return;\n    }\n    if (this.inFlight.attempts > this.options.retryLimit) {\n      this.abandonRetryExhausted();\n      return;\n    }\n\n    this.inFlight.retryReady = false;\n    const generation = this.inFlight.retryGeneration + 1;\n    this.inFlight.retryGeneration = generation;\n    const delayMs = Math.max(requestedDelayMs, this.retryDelay(this.inFlight.attempts));\n    void this.options.delay(delayMs).then(() => {\n      if (!this.inFlight || this.inFlight.retryGeneration !== generation) {\n        return;\n      }\n      this.inFlight.retryReady = true;\n      this.scheduleDrain();\n    });\n  }\n\n  private sendInFlightBatch(): void {\n    const current = this.inFlight;\n    const port = this.port;\n    if (!current || !port || current.awaitingAcknowledgement || !current.retryReady) {\n      return;\n    }\n    if (current.attempts > this.options.retryLimit) {\n      this.abandonRetryExhausted();\n      return;\n    }\n\n    current.attempts += 1;\n    if (current.attempts > 1) {\n      this.retryAttempts += 1;\n    }\n    current.awaitingAcknowledgement = true;\n    current.retryReady = false;\n    const attempt = current.attempts;\n    try {\n      port.postMessage(current.batch);\n    } catch {\n      current.awaitingAcknowledgement = false;\n      this.detachPort();\n      return;\n    }\n\n    void this.options.delay(this.options.acknowledgementTimeoutMs).then(() => {\n      this.handleAcknowledgementTimeout(current.batch.batchId, attempt);\n    });\n  }\n\n  private snapshotEvent(\n    event: WoodRendererTraceInput,\n    sequence: number,\n    identity: { timestamp?: string; producerId?: string },\n  ): WoodRendererTraceEvent {\n    const snapshot = this.metadataSnapshotter.snapshot(event);\n    this.metadataTruncatedValues += snapshot.stats.truncatedValues;\n    this.metadataRedactedValues += snapshot.stats.redactedValues;\n    this.metadataSerializationFailures += snapshot.stats.serializationFailures;\n    const input = snapshot.metadata;\n    // A hub-preserved occurrence timestamp is authoritative; only legacy\n    // unstamped events receive a transport-stamped time.\n    let timestamp = identity.timestamp;\n    if (timestamp === undefined) {\n      const occurredAt = new Date(this.options.now());\n      timestamp = Number.isNaN(occurredAt.getTime())\n        ? new Date(0).toISOString()\n        : occurredAt.toISOString();\n    }\n    return Object.freeze({\n      source: this.snapshotString(input.source, 'unknown'),\n      type: this.snapshotString(input.type, 'unknown'),\n      level: this.snapshotString(input.level, 'info'),\n      process: 'renderer',\n      timestamp,\n      traceSeq: sequence + 1,\n      ...(identity.producerId !== undefined ? { producerId: identity.producerId } : {}),\n      ...this.snapshotOptionalString('message', input.message),\n      ...this.snapshotConversationId(input.conversationId),\n      ...this.snapshotPayload(input.payload),\n      ...this.snapshotOptionalString('windowId', input.windowId),\n      ...this.snapshotOptionalNumber('webContentsId', input.webContentsId),\n      ...this.snapshotOptionalString('routeKey', input.routeKey),\n      ...this.snapshotOptionalString('harnessId', input.harnessId),\n    });\n  }\n\n  private snapshotConversationId(\n    value: TelemetryJsonValue | undefined,\n  ): Pick<WoodRendererTraceEvent, 'conversationId'> | Record<string, never> {\n    return typeof value === 'string' || typeof value === 'number'\n      ? { conversationId: value }\n      : {};\n  }\n\n  private snapshotOptionalNumber<Key extends 'webContentsId'>(\n    key: Key,\n    value: TelemetryJsonValue | undefined,\n  ): Partial<Pick<WoodRendererTraceEvent, Key>> {\n    return typeof value === 'number' && Number.isFinite(value)\n      ? { [key]: value } as Pick<WoodRendererTraceEvent, Key>\n      : {};\n  }\n\n  private snapshotOptionalString<Key extends 'message' | 'windowId' | 'routeKey' | 'harnessId'>(\n    key: Key,\n    value: TelemetryJsonValue | undefined,\n  ): Partial<Pick<WoodRendererTraceEvent, Key>> {\n    return typeof value === 'string'\n      ? { [key]: value } as Pick<WoodRendererTraceEvent, Key>\n      : {};\n  }\n\n  private snapshotPayload(\n    value: TelemetryJsonValue | undefined,\n  ): Pick<WoodRendererTraceEvent, 'payload'> | Record<string, never> {\n    if (value === undefined) {\n      return {};\n    }\n    const payload: TelemetryJsonObject = this.isJsonObject(value)\n      ? value\n      : Object.freeze({ __telemetry: value });\n    return { payload };\n  }\n\n  private snapshotString(value: TelemetryJsonValue | undefined, fallback: string): string {\n    return typeof value === 'string' && value.trim().length > 0 ? value : fallback;\n  }\n\n  private isJsonObject(value: TelemetryJsonValue): value is TelemetryJsonObject {\n    return typeof value === 'object' && value !== null && !Array.isArray(value);\n  }\n\n  private validateOptions(): void {\n    const validCapacity = Number.isSafeInteger(this.options.maxQueuedEvents)\n      && this.options.maxQueuedEvents > 0\n      && Number.isSafeInteger(this.options.maxBatchEvents)\n      && this.options.maxBatchEvents > 0\n      && this.options.maxBatchEvents <= this.options.maxQueuedEvents;\n    const validRetry = Number.isSafeInteger(this.options.retryLimit)\n      && this.options.retryLimit >= 0\n      && Number.isFinite(this.options.retryBaseDelayMs)\n      && this.options.retryBaseDelayMs >= 0\n      && Number.isFinite(this.options.acknowledgementTimeoutMs)\n      && this.options.acknowledgementTimeoutMs > 0;\n    if (!this.options.producerId.trim() || !validCapacity || !validRetry) {\n      throw new Error('Renderer trace batch transport options are invalid');\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,kBAKO;AACP,uCAAuC;AAwBhC,MAAM,4BAA4B;AAAA,EAqBvC,YAA6B,SAAyC;AAAzC;AApB7B,SAAiB,WAAW,IAAI,wDAAuB;AAEvD,SAAiB,QAA4B,CAAC;AAC9C,SAAQ,QAA8C;AACtD,SAAQ,OAAkC;AAC1C,SAAQ,kBAAuC;AAC/C,SAAQ,WAAsC;AAC9C,SAAQ,eAAe;AACvB,SAAQ,iBAAiB;AACzB,SAAQ,kBAAkB;AAC1B,SAAQ,gBAAgB;AACxB,SAAQ,kBAAkB;AAC1B,SAAQ,wBAAwB;AAChC,SAAQ,oBAAoB;AAC5B,SAAQ,mBAAmB;AAC3B,SAAQ,gBAAgB;AACxB,SAAQ,0BAA0B;AAClC,SAAQ,yBAAyB;AACjC,SAAQ,gCAAgC;AAGtC,SAAK,gBAAgB;AACrB,SAAK,sBAAsB,IAAI;AAAA,MAC7B,QAAQ,0BAA0B;AAAA,IACpC;AAAA,EACF;AAAA,EAEA,MAAM,OAA8D;AAClE,UAAM,WAAW,KAAK,gBAAgB,KAAK;AAC3C,UAAM,WAAW,SAAS;AAC1B,QAAI,KAAK,UAAU,aAAa;AAC9B,WAAK,iBAAiB;AACtB,aAAO,EAAE,MAAM,WAAW,UAAU,QAAQ,SAAS;AAAA,IACvD;AAEA,UAAM,iBAAiB,KAAK,MAAM,UAAU,KAAK,UAAU,MAAM,OAAO,UAAU;AAClF,QAAI,kBAAkB,KAAK,QAAQ,iBAAiB;AAClD,WAAK,mBAAmB;AACxB,aAAO,EAAE,MAAM,WAAW,UAAU,QAAQ,WAAW;AAAA,IACzD;AAEA,SAAK,MAAM,KAAK,OAAO,OAAO,EAAE,UAAU,OAAO,KAAK,cAAc,OAAO,UAAU,QAAQ,EAAE,CAAC,CAAC;AACjG,SAAK,cAAc;AACnB,WAAO,EAAE,MAAM,YAAY,SAAS;AAAA,EACtC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAgBQ,gBAAgB,OAItB;AACA,UAAM,eAAe,OAAO,MAAM,cAAc,YAC3C,OAAO,SAAS,KAAK,MAAM,MAAM,SAAS,CAAC,IAC5C,MAAM,YACN;AACJ,UAAM,SAAS,OAAO,MAAM,aAAa,YACpC,OAAO,cAAc,MAAM,QAAQ,KACnC,MAAM,YAAY,IACnB,MAAM,WACN;AACJ,UAAM,aAAa,OAAO,MAAM,eAAe,YAAY,MAAM,WAAW,KAAK,EAAE,SAAS,IACxF,MAAM,aACN;AAEJ,QAAI,iBAAiB,UAAa,WAAW,UAAa,SAAS,KAAK,KAAK,cAAc;AACzF,WAAK,eAAe;AACpB,aAAO;AAAA,QACL,UAAU,SAAS;AAAA,QACnB,WAAW;AAAA,QACX,GAAI,eAAe,SAAY,EAAE,WAAW,IAAI,CAAC;AAAA,MACnD;AAAA,IACF;AAEA,QAAI,iBAAiB,UAAa,WAAW,QAAW;AAGtD,WAAK,qBAAqB;AAAA,IAC5B;AAEA,UAAM,WAAW,KAAK;AACtB,SAAK,gBAAgB;AACrB,WAAO;AAAA,MACL;AAAA,MACA,GAAI,iBAAiB,SAAY,EAAE,WAAW,aAAa,IAAI,CAAC;AAAA,IAClE;AAAA,EACF;AAAA,EAEA,WAAW,MAAgC;AACzC,SAAK,WAAW;AAChB,SAAK,OAAO;AACZ,SAAK,kBAAkB,KAAK,UAAU,CAAC,YAAY,KAAK,sBAAsB,OAAO,CAAC;AACtF,QAAI,KAAK,UAAU;AACjB,WAAK,SAAS,0BAA0B;AACxC,WAAK,SAAS,aAAa;AAC3B,WAAK,SAAS,mBAAmB;AAAA,IACnC;AACA,SAAK,cAAc;AAAA,EACrB;AAAA,EAEA,SAAwC;AACtC,WAAO,OAAO,OAAO;AAAA,MACnB,OAAO,KAAK;AAAA,MACZ,YAAY,KAAK,QAAQ;AAAA,MACzB,cAAc,KAAK;AAAA,MACnB,cAAc,KAAK,MAAM;AAAA,MACzB,iBAAiB,KAAK,UAAU,MAAM,WAAW;AAAA,MACjD,iBAAiB,KAAK;AAAA,MACtB,eAAe,KAAK;AAAA,MACpB,iBAAiB,KAAK;AAAA,MACtB,uBAAuB,KAAK;AAAA,MAC5B,mBAAmB,KAAK;AAAA,MACxB,yBAAyB,KAAK;AAAA,MAC9B,wBAAwB,KAAK;AAAA,MAC7B,+BAA+B,KAAK;AAAA,MACpC,kBAAkB,KAAK;AAAA,MACvB,eAAe,KAAK;AAAA,IACtB,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,MAAM,YAAmC;AAC7C,SAAK,cAAc;AACnB,WAAO,KAAK,iBAAiB,KAAK,KAAK,QAAQ,IAAI,IAAI,YAAY;AACjE,YAAM,KAAK,QAAQ,MAAM,CAAC;AAC1B,WAAK,cAAc;AAAA,IACrB;AAAA,EACF;AAAA,EAEA,MAAM,MAAM,YAAmC;AAC7C,QAAI,KAAK,UAAU,WAAW;AAC5B;AAAA,IACF;AACA,SAAK,QAAQ;AACb,UAAM,KAAK,MAAM,UAAU;AAC3B,UAAM,kBAAkB,KAAK,MAAM,UAAU,KAAK,UAAU,MAAM,OAAO,UAAU;AACnF,SAAK,iBAAiB;AACtB,SAAK,MAAM,SAAS;AACpB,SAAK,WAAW;AAChB,SAAK,WAAW;AAChB,SAAK,QAAQ;AAAA,EACf;AAAA,EAEQ,wBAA8B;AACpC,QAAI,CAAC,KAAK,UAAU;AAClB;AAAA,IACF;AACA,SAAK,yBAAyB,KAAK,SAAS,MAAM,OAAO;AACzD,SAAK,WAAW;AAChB,SAAK,cAAc;AAAA,EACrB;AAAA,EAEQ,sBAA4B;AAClC,QAAI,KAAK,YAAY,KAAK,MAAM,WAAW,KAAK,CAAC,KAAK,MAAM;AAC1D;AAAA,IACF;AACA,UAAM,UAAU,KAAK,MAAM,OAAO,GAAG,KAAK,QAAQ,cAAc;AAChE,UAAM,QAAQ,QAAQ,CAAC;AACvB,QAAI,CAAC,OAAO;AACV;AAAA,IACF;AACA,SAAK,WAAW;AAAA,MACd,OAAO,KAAK,SAAS;AAAA,QACnB,KAAK,QAAQ;AAAA,QACb,MAAM;AAAA,QACN,QAAQ,IAAI,CAAC,UAAU,MAAM,KAAK;AAAA,MACpC;AAAA,MACA,UAAU;AAAA,MACV,yBAAyB;AAAA,MACzB,YAAY;AAAA,MACZ,iBAAiB;AAAA,IACnB;AAAA,EACF;AAAA,EAEQ,aAAmB;AACzB,SAAK,kBAAkB;AACvB,SAAK,kBAAkB;AACvB,SAAK,MAAM,MAAM;AACjB,SAAK,OAAO;AAAA,EACd;AAAA,EAEQ,QAAc;AACpB,SAAK,oBAAoB;AACzB,SAAK,kBAAkB;AAAA,EACzB;AAAA,EAEQ,sBAAsB,SAAwB;AACpD,UAAM,SAAS,KAAK,SAAS,qBAAqB,OAAO;AACzD,QAAI,CAAC,OAAO,MAAM,CAAC,KAAK,UAAU;AAChC;AAAA,IACF;AACA,UAAM,kBAAkB,OAAO;AAC/B,QAAI,gBAAgB,YAAY,KAAK,SAAS,MAAM,SAAS;AAC3D;AAAA,IACF;AAEA,SAAK,SAAS,mBAAmB;AACjC,SAAK,SAAS,0BAA0B;AACxC,QAAI,gBAAgB,SAAS,aAAa;AACxC,UAAI,gBAAgB,mBAAmB,KAAK,SAAS,MAAM,OAAO,QAAQ;AACxE,aAAK,cAAc,CAAC;AACpB;AAAA,MACF;AACA,WAAK,oBAAoB;AACzB,WAAK,WAAW;AAChB,WAAK,cAAc;AACnB;AAAA,IACF;AACA,QAAI,gBAAgB,SAAS,YAAY;AACvC,WAAK,mBAAmB,KAAK,SAAS,MAAM,OAAO;AACnD,WAAK,WAAW;AAChB,WAAK,cAAc;AACnB;AAAA,IACF;AACA,SAAK,cAAc,gBAAgB,YAAY;AAAA,EACjD;AAAA,EAEQ,6BAA6B,SAAiB,SAAuB;AAC3E,QAAI,CAAC,KAAK,YACL,KAAK,SAAS,MAAM,YAAY,WAChC,KAAK,SAAS,aAAa,WAC3B,CAAC,KAAK,SAAS,yBAAyB;AAC3C;AAAA,IACF;AACA,SAAK,SAAS,0BAA0B;AACxC,SAAK,cAAc,KAAK,WAAW,OAAO,CAAC;AAAA,EAC7C;AAAA,EAEQ,mBAA4B;AAClC,WAAO,KAAK,MAAM,SAAS,KAAK,KAAK,aAAa;AAAA,EACpD;AAAA,EAEQ,WAAW,SAAyB;AAC1C,WAAO,KAAK,QAAQ,mBAAoB,KAAK,KAAK,IAAI,GAAG,UAAU,CAAC;AAAA,EACtE;AAAA,EAEQ,gBAAsB;AAC5B,QAAI,KAAK,gBAAgB;AACvB;AAAA,IACF;AACA,SAAK,iBAAiB;AACtB,SAAK,QAAQ,SAAS,MAAM;AAC1B,WAAK,iBAAiB;AACtB,WAAK,MAAM;AAAA,IACb,CAAC;AAAA,EACH;AAAA,EAEQ,cAAc,kBAAgC;AACpD,QAAI,CAAC,KAAK,UAAU;AAClB;AAAA,IACF;AACA,QAAI,KAAK,SAAS,WAAW,KAAK,QAAQ,YAAY;AACpD,WAAK,sBAAsB;AAC3B;AAAA,IACF;AAEA,SAAK,SAAS,aAAa;AAC3B,UAAM,aAAa,KAAK,SAAS,kBAAkB;AACnD,SAAK,SAAS,kBAAkB;AAChC,UAAM,UAAU,KAAK,IAAI,kBAAkB,KAAK,WAAW,KAAK,SAAS,QAAQ,CAAC;AAClF,SAAK,KAAK,QAAQ,MAAM,OAAO,EAAE,KAAK,MAAM;AAC1C,UAAI,CAAC,KAAK,YAAY,KAAK,SAAS,oBAAoB,YAAY;AAClE;AAAA,MACF;AACA,WAAK,SAAS,aAAa;AAC3B,WAAK,cAAc;AAAA,IACrB,CAAC;AAAA,EACH;AAAA,EAEQ,oBAA0B;AAChC,UAAM,UAAU,KAAK;AACrB,UAAM,OAAO,KAAK;AAClB,QAAI,CAAC,WAAW,CAAC,QAAQ,QAAQ,2BAA2B,CAAC,QAAQ,YAAY;AAC/E;AAAA,IACF;AACA,QAAI,QAAQ,WAAW,KAAK,QAAQ,YAAY;AAC9C,WAAK,sBAAsB;AAC3B;AAAA,IACF;AAEA,YAAQ,YAAY;AACpB,QAAI,QAAQ,WAAW,GAAG;AACxB,WAAK,iBAAiB;AAAA,IACxB;AACA,YAAQ,0BAA0B;AAClC,YAAQ,aAAa;AACrB,UAAM,UAAU,QAAQ;AACxB,QAAI;AACF,WAAK,YAAY,QAAQ,KAAK;AAAA,IAChC,QAAQ;AACN,cAAQ,0BAA0B;AAClC,WAAK,WAAW;AAChB;AAAA,IACF;AAEA,SAAK,KAAK,QAAQ,MAAM,KAAK,QAAQ,wBAAwB,EAAE,KAAK,MAAM;AACxE,WAAK,6BAA6B,QAAQ,MAAM,SAAS,OAAO;AAAA,IAClE,CAAC;AAAA,EACH;AAAA,EAEQ,cACN,OACA,UACA,UACwB;AACxB,UAAM,WAAW,KAAK,oBAAoB,SAAS,KAAK;AACxD,SAAK,2BAA2B,SAAS,MAAM;AAC/C,SAAK,0BAA0B,SAAS,MAAM;AAC9C,SAAK,iCAAiC,SAAS,MAAM;AACrD,UAAM,QAAQ,SAAS;AAGvB,QAAI,YAAY,SAAS;AACzB,QAAI,cAAc,QAAW;AAC3B,YAAM,aAAa,IAAI,KAAK,KAAK,QAAQ,IAAI,CAAC;AAC9C,kBAAY,OAAO,MAAM,WAAW,QAAQ,CAAC,KACzC,oBAAI,KAAK,CAAC,GAAE,YAAY,IACxB,WAAW,YAAY;AAAA,IAC7B;AACA,WAAO,OAAO,OAAO;AAAA,MACnB,QAAQ,KAAK,eAAe,MAAM,QAAQ,SAAS;AAAA,MACnD,MAAM,KAAK,eAAe,MAAM,MAAM,SAAS;AAAA,MAC/C,OAAO,KAAK,eAAe,MAAM,OAAO,MAAM;AAAA,MAC9C,SAAS;AAAA,MACT;AAAA,MACA,UAAU,WAAW;AAAA,MACrB,GAAI,SAAS,eAAe,SAAY,EAAE,YAAY,SAAS,WAAW,IAAI,CAAC;AAAA,MAC/E,GAAG,KAAK,uBAAuB,WAAW,MAAM,OAAO;AAAA,MACvD,GAAG,KAAK,uBAAuB,MAAM,cAAc;AAAA,MACnD,GAAG,KAAK,gBAAgB,MAAM,OAAO;AAAA,MACrC,GAAG,KAAK,uBAAuB,YAAY,MAAM,QAAQ;AAAA,MACzD,GAAG,KAAK,uBAAuB,iBAAiB,MAAM,aAAa;AAAA,MACnE,GAAG,KAAK,uBAAuB,YAAY,MAAM,QAAQ;AAAA,MACzD,GAAG,KAAK,uBAAuB,aAAa,MAAM,SAAS;AAAA,IAC7D,CAAC;AAAA,EACH;AAAA,EAEQ,uBACN,OACwE;AACxE,WAAO,OAAO,UAAU,YAAY,OAAO,UAAU,WACjD,EAAE,gBAAgB,MAAM,IACxB,CAAC;AAAA,EACP;AAAA,EAEQ,uBACN,KACA,OAC4C;AAC5C,WAAO,OAAO,UAAU,YAAY,OAAO,SAAS,KAAK,IACrD,EAAE,CAAC,GAAG,GAAG,MAAM,IACf,CAAC;AAAA,EACP;AAAA,EAEQ,uBACN,KACA,OAC4C;AAC5C,WAAO,OAAO,UAAU,WACpB,EAAE,CAAC,GAAG,GAAG,MAAM,IACf,CAAC;AAAA,EACP;AAAA,EAEQ,gBACN,OACiE;AACjE,QAAI,UAAU,QAAW;AACvB,aAAO,CAAC;AAAA,IACV;AACA,UAAM,UAA+B,KAAK,aAAa,KAAK,IACxD,QACA,OAAO,OAAO,EAAE,aAAa,MAAM,CAAC;AACxC,WAAO,EAAE,QAAQ;AAAA,EACnB;AAAA,EAEQ,eAAe,OAAuC,UAA0B;AACtF,WAAO,OAAO,UAAU,YAAY,MAAM,KAAK,EAAE,SAAS,IAAI,QAAQ;AAAA,EACxE;AAAA,EAEQ,aAAa,OAAyD;AAC5E,WAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAAA,EAC5E;AAAA,EAEQ,kBAAwB;AAC9B,UAAM,gBAAgB,OAAO,cAAc,KAAK,QAAQ,eAAe,KAClE,KAAK,QAAQ,kBAAkB,KAC/B,OAAO,cAAc,KAAK,QAAQ,cAAc,KAChD,KAAK,QAAQ,iBAAiB,KAC9B,KAAK,QAAQ,kBAAkB,KAAK,QAAQ;AACjD,UAAM,aAAa,OAAO,cAAc,KAAK,QAAQ,UAAU,KAC1D,KAAK,QAAQ,cAAc,KAC3B,OAAO,SAAS,KAAK,QAAQ,gBAAgB,KAC7C,KAAK,QAAQ,oBAAoB,KACjC,OAAO,SAAS,KAAK,QAAQ,wBAAwB,KACrD,KAAK,QAAQ,2BAA2B;AAC7C,QAAI,CAAC,KAAK,QAAQ,WAAW,KAAK,KAAK,CAAC,iBAAiB,CAAC,YAAY;AACpE,YAAM,IAAI,MAAM,oDAAoD;AAAA,IACtE;AAAA,EACF;AACF;","names":[]}

package/dist/tracing/renderer_trace_batch_transport.d.cts

@@ -1,6 +1,6 @@
 import { WoodTraceBatchTransportOptions, WoodRendererTraceInput, WoodTraceBatchAdmissionResult, WoodTraceBatchPort, WoodTraceBatchTransportStatus } from './types/wood_trace_batch.types.cjs';
 import '@noego/telemetry/core';
-import '../trace_hub-Cob54qRx.cjs';
+import '../trace_hub-Cpo_nVze.cjs';
 import 'rxjs';
 
 declare class RendererTraceBatchTransport {
@@ -18,6 +18,7 @@ declare class RendererTraceBatchTransport {
     private droppedClosed;
     private droppedRejected;
     private droppedRetryExhausted;
+    private identityRestamped;
     private committedBatches;
     private retryAttempts;
     private metadataTruncatedValues;
@@ -25,6 +26,21 @@ declare class RendererTraceBatchTransport {
     private metadataSerializationFailures;
     constructor(options: WoodTraceBatchTransportOptions);
     admit(event: WoodRendererTraceInput): WoodTraceBatchAdmissionResult;
+    /**
+     * Resolves the queue sequence and preserved identity for an incoming event,
+     * reading identity fields from the raw input BEFORE metadata snapshotting so
+     * truncation/redaction can never alter identity.
+     *
+     * A hub-admitted event (valid timestamp + traceSeq) keeps its identity and
+     * its queue sequence is derived as traceSeq - 1 so the batch sequence range
+     * stays aligned with hub identity. A stamped event whose traceSeq regresses
+     * against the already-assigned sequence stream is restamped as legacy (its
+     * occurrence timestamp is still preserved, its producerId is dropped so a
+     * reassigned sequence cannot masquerade under the durable identity key) and
+     * counted in identityRestamped. Legacy events without identity are stamped
+     * exactly as before.
+     */
+    private resolveIdentity;
     attachPort(port: WoodTraceBatchPort): void;
     status(): WoodTraceBatchTransportStatus;
     flush(deadlineMs: number): Promise<void>;

package/dist/tracing/renderer_trace_batch_transport.d.ts

@@ -1,6 +1,6 @@
 import { WoodTraceBatchTransportOptions, WoodRendererTraceInput, WoodTraceBatchAdmissionResult, WoodTraceBatchPort, WoodTraceBatchTransportStatus } from './types/wood_trace_batch.types.js';
 import '@noego/telemetry/core';
-import '../trace_hub-Cob54qRx.js';
+import '../trace_hub-Cpo_nVze.js';
 import 'rxjs';
 
 declare class RendererTraceBatchTransport {
@@ -18,6 +18,7 @@ declare class RendererTraceBatchTransport {
     private droppedClosed;
     private droppedRejected;
     private droppedRetryExhausted;
+    private identityRestamped;
     private committedBatches;
     private retryAttempts;
     private metadataTruncatedValues;
@@ -25,6 +26,21 @@ declare class RendererTraceBatchTransport {
     private metadataSerializationFailures;
     constructor(options: WoodTraceBatchTransportOptions);
     admit(event: WoodRendererTraceInput): WoodTraceBatchAdmissionResult;
+    /**
+     * Resolves the queue sequence and preserved identity for an incoming event,
+     * reading identity fields from the raw input BEFORE metadata snapshotting so
+     * truncation/redaction can never alter identity.
+     *
+     * A hub-admitted event (valid timestamp + traceSeq) keeps its identity and
+     * its queue sequence is derived as traceSeq - 1 so the batch sequence range
+     * stays aligned with hub identity. A stamped event whose traceSeq regresses
+     * against the already-assigned sequence stream is restamped as legacy (its
+     * occurrence timestamp is still preserved, its producerId is dropped so a
+     * reassigned sequence cannot masquerade under the durable identity key) and
+     * counted in identityRestamped. Legacy events without identity are stamped
+     * exactly as before.
+     */
+    private resolveIdentity;
     attachPort(port: WoodTraceBatchPort): void;
     status(): WoodTraceBatchTransportStatus;
     flush(deadlineMs: number): Promise<void>;

package/dist/tracing/renderer_trace_batch_transport.js

@@ -18,6 +18,7 @@ class RendererTraceBatchTransport {
     this.droppedClosed = 0;
     this.droppedRejected = 0;
     this.droppedRetryExhausted = 0;
+    this.identityRestamped = 0;
     this.committedBatches = 0;
     this.retryAttempts = 0;
     this.metadataTruncatedValues = 0;
@@ -29,8 +30,8 @@ class RendererTraceBatchTransport {
     );
   }
   admit(event) {
-    const sequence = this.nextSequence;
-    this.nextSequence += 1;
+    const identity = this.resolveIdentity(event);
+    const sequence = identity.sequence;
     if (this.state !== "accepting") {
       this.droppedClosed += 1;
       return { kind: "dropped", sequence, reason: "closed" };
@@ -40,10 +41,46 @@ class RendererTraceBatchTransport {
       this.droppedCapacity += 1;
       return { kind: "dropped", sequence, reason: "capacity" };
     }
-    this.queue.push(Object.freeze({ sequence, event: this.snapshotEvent(event, sequence) }));
+    this.queue.push(Object.freeze({ sequence, event: this.snapshotEvent(event, sequence, identity) }));
     this.scheduleDrain();
     return { kind: "admitted", sequence };
   }
+  /**
+   * Resolves the queue sequence and preserved identity for an incoming event,
+   * reading identity fields from the raw input BEFORE metadata snapshotting so
+   * truncation/redaction can never alter identity.
+   *
+   * A hub-admitted event (valid timestamp + traceSeq) keeps its identity and
+   * its queue sequence is derived as traceSeq - 1 so the batch sequence range
+   * stays aligned with hub identity. A stamped event whose traceSeq regresses
+   * against the already-assigned sequence stream is restamped as legacy (its
+   * occurrence timestamp is still preserved, its producerId is dropped so a
+   * reassigned sequence cannot masquerade under the durable identity key) and
+   * counted in identityRestamped. Legacy events without identity are stamped
+   * exactly as before.
+   */
+  resolveIdentity(event) {
+    const rawTimestamp = typeof event.timestamp === "string" && Number.isFinite(Date.parse(event.timestamp)) ? event.timestamp : void 0;
+    const rawSeq = typeof event.traceSeq === "number" && Number.isSafeInteger(event.traceSeq) && event.traceSeq >= 1 ? event.traceSeq : void 0;
+    const producerId = typeof event.producerId === "string" && event.producerId.trim().length > 0 ? event.producerId : void 0;
+    if (rawTimestamp !== void 0 && rawSeq !== void 0 && rawSeq - 1 >= this.nextSequence) {
+      this.nextSequence = rawSeq;
+      return {
+        sequence: rawSeq - 1,
+        timestamp: rawTimestamp,
+        ...producerId !== void 0 ? { producerId } : {}
+      };
+    }
+    if (rawTimestamp !== void 0 && rawSeq !== void 0) {
+      this.identityRestamped += 1;
+    }
+    const sequence = this.nextSequence;
+    this.nextSequence += 1;
+    return {
+      sequence,
+      ...rawTimestamp !== void 0 ? { timestamp: rawTimestamp } : {}
+    };
+  }
   attachPort(port) {
     this.detachPort();
     this.port = port;
@@ -66,6 +103,7 @@ class RendererTraceBatchTransport {
       droppedClosed: this.droppedClosed,
       droppedRejected: this.droppedRejected,
       droppedRetryExhausted: this.droppedRetryExhausted,
+      identityRestamped: this.identityRestamped,
       metadataTruncatedValues: this.metadataTruncatedValues,
       metadataRedactedValues: this.metadataRedactedValues,
       metadataSerializationFailures: this.metadataSerializationFailures,
@@ -232,14 +270,17 @@ class RendererTraceBatchTransport {
       this.handleAcknowledgementTimeout(current.batch.batchId, attempt);
     });
   }
-  snapshotEvent(event, sequence) {
+  snapshotEvent(event, sequence, identity) {
     const snapshot = this.metadataSnapshotter.snapshot(event);
     this.metadataTruncatedValues += snapshot.stats.truncatedValues;
     this.metadataRedactedValues += snapshot.stats.redactedValues;
     this.metadataSerializationFailures += snapshot.stats.serializationFailures;
     const input = snapshot.metadata;
-    const occurredAt = new Date(this.options.now());
-    const timestamp = Number.isNaN(occurredAt.getTime()) ? (/* @__PURE__ */ new Date(0)).toISOString() : occurredAt.toISOString();
+    let timestamp = identity.timestamp;
+    if (timestamp === void 0) {
+      const occurredAt = new Date(this.options.now());
+      timestamp = Number.isNaN(occurredAt.getTime()) ? (/* @__PURE__ */ new Date(0)).toISOString() : occurredAt.toISOString();
+    }
     return Object.freeze({
       source: this.snapshotString(input.source, "unknown"),
       type: this.snapshotString(input.type, "unknown"),
@@ -247,6 +288,7 @@ class RendererTraceBatchTransport {
       process: "renderer",
       timestamp,
       traceSeq: sequence + 1,
+      ...identity.producerId !== void 0 ? { producerId: identity.producerId } : {},
       ...this.snapshotOptionalString("message", input.message),
       ...this.snapshotConversationId(input.conversationId),
       ...this.snapshotPayload(input.payload),

package/dist/tracing/renderer_trace_batch_transport.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/tracing/renderer_trace_batch_transport.ts"],"sourcesContent":["import {\n  BoundedMetadataSnapshotter,\n  DEFAULT_METADATA_SNAPSHOT_LIMITS,\n  type TelemetryJsonObject,\n  type TelemetryJsonValue,\n} from '@noego/telemetry/core';\nimport { WoodTraceBatchContract } from './wood_trace_batch_contract.js';\nimport type {\n  WoodRendererTraceEvent,\n  WoodRendererTraceInput,\n  WoodTraceBatch,\n  WoodTraceBatchAdmissionResult,\n  WoodTraceBatchPort,\n  WoodTraceBatchTransportOptions,\n  WoodTraceBatchTransportStatus,\n} from './types/wood_trace_batch.types.js';\n\ntype QueuedTraceEvent = Readonly<{\n  sequence: number;\n  event: WoodRendererTraceEvent;\n}>;\n\ntype InFlightTraceBatch = {\n  batch: WoodTraceBatch;\n  attempts: number;\n  awaitingAcknowledgement: boolean;\n  retryReady: boolean;\n  retryGeneration: number;\n};\n\nexport class RendererTraceBatchTransport {\n  private readonly contract = new WoodTraceBatchContract();\n  private readonly metadataSnapshotter: BoundedMetadataSnapshotter;\n  private readonly queue: QueuedTraceEvent[] = [];\n  private state: 'accepting' | 'draining' | 'stopped' = 'accepting';\n  private port: WoodTraceBatchPort | null = null;\n  private unsubscribePort: (() => void) | null = null;\n  private inFlight: InFlightTraceBatch | null = null;\n  private nextSequence = 0;\n  private drainScheduled = false;\n  private droppedCapacity = 0;\n  private droppedClosed = 0;\n  private droppedRejected = 0;\n  private droppedRetryExhausted = 0;\n  private committedBatches = 0;\n  private retryAttempts = 0;\n  private metadataTruncatedValues = 0;\n  private metadataRedactedValues = 0;\n  private metadataSerializationFailures = 0;\n\n  constructor(private readonly options: WoodTraceBatchTransportOptions) {\n    this.validateOptions();\n    this.metadataSnapshotter = new BoundedMetadataSnapshotter(\n      options.metadataSnapshotLimits ?? DEFAULT_METADATA_SNAPSHOT_LIMITS,\n    );\n  }\n\n  admit(event: WoodRendererTraceInput): WoodTraceBatchAdmissionResult {\n    const sequence = this.nextSequence;\n    this.nextSequence += 1;\n    if (this.state !== 'accepting') {\n      this.droppedClosed += 1;\n      return { kind: 'dropped', sequence, reason: 'closed' };\n    }\n\n    const retainedEvents = this.queue.length + (this.inFlight?.batch.events.length ?? 0);\n    if (retainedEvents >= this.options.maxQueuedEvents) {\n      this.droppedCapacity += 1;\n      return { kind: 'dropped', sequence, reason: 'capacity' };\n    }\n\n    this.queue.push(Object.freeze({ sequence, event: this.snapshotEvent(event, sequence) }));\n    this.scheduleDrain();\n    return { kind: 'admitted', sequence };\n  }\n\n  attachPort(port: WoodTraceBatchPort): void {\n    this.detachPort();\n    this.port = port;\n    this.unsubscribePort = port.subscribe((message) => this.handleAcknowledgement(message));\n    if (this.inFlight) {\n      this.inFlight.awaitingAcknowledgement = false;\n      this.inFlight.retryReady = true;\n      this.inFlight.retryGeneration += 1;\n    }\n    this.scheduleDrain();\n  }\n\n  status(): WoodTraceBatchTransportStatus {\n    return Object.freeze({\n      state: this.state,\n      producerId: this.options.producerId,\n      nextSequence: this.nextSequence,\n      queuedEvents: this.queue.length,\n      inFlightBatchId: this.inFlight?.batch.batchId ?? null,\n      droppedCapacity: this.droppedCapacity,\n      droppedClosed: this.droppedClosed,\n      droppedRejected: this.droppedRejected,\n      droppedRetryExhausted: this.droppedRetryExhausted,\n      metadataTruncatedValues: this.metadataTruncatedValues,\n      metadataRedactedValues: this.metadataRedactedValues,\n      metadataSerializationFailures: this.metadataSerializationFailures,\n      committedBatches: this.committedBatches,\n      retryAttempts: this.retryAttempts,\n    });\n  }\n\n  async flush(deadlineMs: number): Promise<void> {\n    this.scheduleDrain();\n    while (this.hasPendingEvents() && this.options.now() < deadlineMs) {\n      await this.options.delay(1);\n      this.scheduleDrain();\n    }\n  }\n\n  async close(deadlineMs: number): Promise<void> {\n    if (this.state === 'stopped') {\n      return;\n    }\n    this.state = 'draining';\n    await this.flush(deadlineMs);\n    const abandonedEvents = this.queue.length + (this.inFlight?.batch.events.length ?? 0);\n    this.droppedClosed += abandonedEvents;\n    this.queue.length = 0;\n    this.inFlight = null;\n    this.detachPort();\n    this.state = 'stopped';\n  }\n\n  private abandonRetryExhausted(): void {\n    if (!this.inFlight) {\n      return;\n    }\n    this.droppedRetryExhausted += this.inFlight.batch.events.length;\n    this.inFlight = null;\n    this.scheduleDrain();\n  }\n\n  private createInFlightBatch(): void {\n    if (this.inFlight || this.queue.length === 0 || !this.port) {\n      return;\n    }\n    const entries = this.queue.splice(0, this.options.maxBatchEvents);\n    const first = entries[0];\n    if (!first) {\n      return;\n    }\n    this.inFlight = {\n      batch: this.contract.create(\n        this.options.producerId,\n        first.sequence,\n        entries.map((entry) => entry.event),\n      ),\n      attempts: 0,\n      awaitingAcknowledgement: false,\n      retryReady: true,\n      retryGeneration: 0,\n    };\n  }\n\n  private detachPort(): void {\n    this.unsubscribePort?.();\n    this.unsubscribePort = null;\n    this.port?.close();\n    this.port = null;\n  }\n\n  private drain(): void {\n    this.createInFlightBatch();\n    this.sendInFlightBatch();\n  }\n\n  private handleAcknowledgement(message: unknown): void {\n    const parsed = this.contract.parseAcknowledgement(message);\n    if (!parsed.ok || !this.inFlight) {\n      return;\n    }\n    const acknowledgement = parsed.acknowledgement;\n    if (acknowledgement.batchId !== this.inFlight.batch.batchId) {\n      return;\n    }\n\n    this.inFlight.retryGeneration += 1;\n    this.inFlight.awaitingAcknowledgement = false;\n    if (acknowledgement.kind === 'committed') {\n      if (acknowledgement.acceptedEvents !== this.inFlight.batch.events.length) {\n        this.scheduleRetry(0);\n        return;\n      }\n      this.committedBatches += 1;\n      this.inFlight = null;\n      this.scheduleDrain();\n      return;\n    }\n    if (acknowledgement.kind === 'rejected') {\n      this.droppedRejected += this.inFlight.batch.events.length;\n      this.inFlight = null;\n      this.scheduleDrain();\n      return;\n    }\n    this.scheduleRetry(acknowledgement.retryAfterMs);\n  }\n\n  private handleAcknowledgementTimeout(batchId: string, attempt: number): void {\n    if (!this.inFlight\n      || this.inFlight.batch.batchId !== batchId\n      || this.inFlight.attempts !== attempt\n      || !this.inFlight.awaitingAcknowledgement) {\n      return;\n    }\n    this.inFlight.awaitingAcknowledgement = false;\n    this.scheduleRetry(this.retryDelay(attempt));\n  }\n\n  private hasPendingEvents(): boolean {\n    return this.queue.length > 0 || this.inFlight !== null;\n  }\n\n  private retryDelay(attempt: number): number {\n    return this.options.retryBaseDelayMs * (2 ** Math.max(0, attempt - 1));\n  }\n\n  private scheduleDrain(): void {\n    if (this.drainScheduled) {\n      return;\n    }\n    this.drainScheduled = true;\n    this.options.schedule(() => {\n      this.drainScheduled = false;\n      this.drain();\n    });\n  }\n\n  private scheduleRetry(requestedDelayMs: number): void {\n    if (!this.inFlight) {\n      return;\n    }\n    if (this.inFlight.attempts > this.options.retryLimit) {\n      this.abandonRetryExhausted();\n      return;\n    }\n\n    this.inFlight.retryReady = false;\n    const generation = this.inFlight.retryGeneration + 1;\n    this.inFlight.retryGeneration = generation;\n    const delayMs = Math.max(requestedDelayMs, this.retryDelay(this.inFlight.attempts));\n    void this.options.delay(delayMs).then(() => {\n      if (!this.inFlight || this.inFlight.retryGeneration !== generation) {\n        return;\n      }\n      this.inFlight.retryReady = true;\n      this.scheduleDrain();\n    });\n  }\n\n  private sendInFlightBatch(): void {\n    const current = this.inFlight;\n    const port = this.port;\n    if (!current || !port || current.awaitingAcknowledgement || !current.retryReady) {\n      return;\n    }\n    if (current.attempts > this.options.retryLimit) {\n      this.abandonRetryExhausted();\n      return;\n    }\n\n    current.attempts += 1;\n    if (current.attempts > 1) {\n      this.retryAttempts += 1;\n    }\n    current.awaitingAcknowledgement = true;\n    current.retryReady = false;\n    const attempt = current.attempts;\n    try {\n      port.postMessage(current.batch);\n    } catch {\n      current.awaitingAcknowledgement = false;\n      this.detachPort();\n      return;\n    }\n\n    void this.options.delay(this.options.acknowledgementTimeoutMs).then(() => {\n      this.handleAcknowledgementTimeout(current.batch.batchId, attempt);\n    });\n  }\n\n  private snapshotEvent(\n    event: WoodRendererTraceInput,\n    sequence: number,\n  ): WoodRendererTraceEvent {\n    const snapshot = this.metadataSnapshotter.snapshot(event);\n    this.metadataTruncatedValues += snapshot.stats.truncatedValues;\n    this.metadataRedactedValues += snapshot.stats.redactedValues;\n    this.metadataSerializationFailures += snapshot.stats.serializationFailures;\n    const input = snapshot.metadata;\n    const occurredAt = new Date(this.options.now());\n    const timestamp = Number.isNaN(occurredAt.getTime())\n      ? new Date(0).toISOString()\n      : occurredAt.toISOString();\n    return Object.freeze({\n      source: this.snapshotString(input.source, 'unknown'),\n      type: this.snapshotString(input.type, 'unknown'),\n      level: this.snapshotString(input.level, 'info'),\n      process: 'renderer',\n      timestamp,\n      traceSeq: sequence + 1,\n      ...this.snapshotOptionalString('message', input.message),\n      ...this.snapshotConversationId(input.conversationId),\n      ...this.snapshotPayload(input.payload),\n      ...this.snapshotOptionalString('windowId', input.windowId),\n      ...this.snapshotOptionalNumber('webContentsId', input.webContentsId),\n      ...this.snapshotOptionalString('routeKey', input.routeKey),\n      ...this.snapshotOptionalString('harnessId', input.harnessId),\n    });\n  }\n\n  private snapshotConversationId(\n    value: TelemetryJsonValue | undefined,\n  ): Pick<WoodRendererTraceEvent, 'conversationId'> | Record<string, never> {\n    return typeof value === 'string' || typeof value === 'number'\n      ? { conversationId: value }\n      : {};\n  }\n\n  private snapshotOptionalNumber<Key extends 'webContentsId'>(\n    key: Key,\n    value: TelemetryJsonValue | undefined,\n  ): Partial<Pick<WoodRendererTraceEvent, Key>> {\n    return typeof value === 'number' && Number.isFinite(value)\n      ? { [key]: value } as Pick<WoodRendererTraceEvent, Key>\n      : {};\n  }\n\n  private snapshotOptionalString<Key extends 'message' | 'windowId' | 'routeKey' | 'harnessId'>(\n    key: Key,\n    value: TelemetryJsonValue | undefined,\n  ): Partial<Pick<WoodRendererTraceEvent, Key>> {\n    return typeof value === 'string'\n      ? { [key]: value } as Pick<WoodRendererTraceEvent, Key>\n      : {};\n  }\n\n  private snapshotPayload(\n    value: TelemetryJsonValue | undefined,\n  ): Pick<WoodRendererTraceEvent, 'payload'> | Record<string, never> {\n    if (value === undefined) {\n      return {};\n    }\n    const payload: TelemetryJsonObject = this.isJsonObject(value)\n      ? value\n      : Object.freeze({ __telemetry: value });\n    return { payload };\n  }\n\n  private snapshotString(value: TelemetryJsonValue | undefined, fallback: string): string {\n    return typeof value === 'string' && value.trim().length > 0 ? value : fallback;\n  }\n\n  private isJsonObject(value: TelemetryJsonValue): value is TelemetryJsonObject {\n    return typeof value === 'object' && value !== null && !Array.isArray(value);\n  }\n\n  private validateOptions(): void {\n    const validCapacity = Number.isSafeInteger(this.options.maxQueuedEvents)\n      && this.options.maxQueuedEvents > 0\n      && Number.isSafeInteger(this.options.maxBatchEvents)\n      && this.options.maxBatchEvents > 0\n      && this.options.maxBatchEvents <= this.options.maxQueuedEvents;\n    const validRetry = Number.isSafeInteger(this.options.retryLimit)\n      && this.options.retryLimit >= 0\n      && Number.isFinite(this.options.retryBaseDelayMs)\n      && this.options.retryBaseDelayMs >= 0\n      && Number.isFinite(this.options.acknowledgementTimeoutMs)\n      && this.options.acknowledgementTimeoutMs > 0;\n    if (!this.options.producerId.trim() || !validCapacity || !validRetry) {\n      throw new Error('Renderer trace batch transport options are invalid');\n    }\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/tracing/renderer_trace_batch_transport.ts"],"sourcesContent":["import {\n  BoundedMetadataSnapshotter,\n  DEFAULT_METADATA_SNAPSHOT_LIMITS,\n  type TelemetryJsonObject,\n  type TelemetryJsonValue,\n} from '@noego/telemetry/core';\nimport { WoodTraceBatchContract } from './wood_trace_batch_contract.js';\nimport type {\n  WoodRendererTraceEvent,\n  WoodRendererTraceInput,\n  WoodTraceBatch,\n  WoodTraceBatchAdmissionResult,\n  WoodTraceBatchPort,\n  WoodTraceBatchTransportOptions,\n  WoodTraceBatchTransportStatus,\n} from './types/wood_trace_batch.types.js';\n\ntype QueuedTraceEvent = Readonly<{\n  sequence: number;\n  event: WoodRendererTraceEvent;\n}>;\n\ntype InFlightTraceBatch = {\n  batch: WoodTraceBatch;\n  attempts: number;\n  awaitingAcknowledgement: boolean;\n  retryReady: boolean;\n  retryGeneration: number;\n};\n\nexport class RendererTraceBatchTransport {\n  private readonly contract = new WoodTraceBatchContract();\n  private readonly metadataSnapshotter: BoundedMetadataSnapshotter;\n  private readonly queue: QueuedTraceEvent[] = [];\n  private state: 'accepting' | 'draining' | 'stopped' = 'accepting';\n  private port: WoodTraceBatchPort | null = null;\n  private unsubscribePort: (() => void) | null = null;\n  private inFlight: InFlightTraceBatch | null = null;\n  private nextSequence = 0;\n  private drainScheduled = false;\n  private droppedCapacity = 0;\n  private droppedClosed = 0;\n  private droppedRejected = 0;\n  private droppedRetryExhausted = 0;\n  private identityRestamped = 0;\n  private committedBatches = 0;\n  private retryAttempts = 0;\n  private metadataTruncatedValues = 0;\n  private metadataRedactedValues = 0;\n  private metadataSerializationFailures = 0;\n\n  constructor(private readonly options: WoodTraceBatchTransportOptions) {\n    this.validateOptions();\n    this.metadataSnapshotter = new BoundedMetadataSnapshotter(\n      options.metadataSnapshotLimits ?? DEFAULT_METADATA_SNAPSHOT_LIMITS,\n    );\n  }\n\n  admit(event: WoodRendererTraceInput): WoodTraceBatchAdmissionResult {\n    const identity = this.resolveIdentity(event);\n    const sequence = identity.sequence;\n    if (this.state !== 'accepting') {\n      this.droppedClosed += 1;\n      return { kind: 'dropped', sequence, reason: 'closed' };\n    }\n\n    const retainedEvents = this.queue.length + (this.inFlight?.batch.events.length ?? 0);\n    if (retainedEvents >= this.options.maxQueuedEvents) {\n      this.droppedCapacity += 1;\n      return { kind: 'dropped', sequence, reason: 'capacity' };\n    }\n\n    this.queue.push(Object.freeze({ sequence, event: this.snapshotEvent(event, sequence, identity) }));\n    this.scheduleDrain();\n    return { kind: 'admitted', sequence };\n  }\n\n  /**\n   * Resolves the queue sequence and preserved identity for an incoming event,\n   * reading identity fields from the raw input BEFORE metadata snapshotting so\n   * truncation/redaction can never alter identity.\n   *\n   * A hub-admitted event (valid timestamp + traceSeq) keeps its identity and\n   * its queue sequence is derived as traceSeq - 1 so the batch sequence range\n   * stays aligned with hub identity. A stamped event whose traceSeq regresses\n   * against the already-assigned sequence stream is restamped as legacy (its\n   * occurrence timestamp is still preserved, its producerId is dropped so a\n   * reassigned sequence cannot masquerade under the durable identity key) and\n   * counted in identityRestamped. Legacy events without identity are stamped\n   * exactly as before.\n   */\n  private resolveIdentity(event: WoodRendererTraceInput): {\n    sequence: number;\n    timestamp?: string;\n    producerId?: string;\n  } {\n    const rawTimestamp = typeof event.timestamp === 'string'\n      && Number.isFinite(Date.parse(event.timestamp))\n      ? event.timestamp\n      : undefined;\n    const rawSeq = typeof event.traceSeq === 'number'\n      && Number.isSafeInteger(event.traceSeq)\n      && event.traceSeq >= 1\n      ? event.traceSeq\n      : undefined;\n    const producerId = typeof event.producerId === 'string' && event.producerId.trim().length > 0\n      ? event.producerId\n      : undefined;\n\n    if (rawTimestamp !== undefined && rawSeq !== undefined && rawSeq - 1 >= this.nextSequence) {\n      this.nextSequence = rawSeq;\n      return {\n        sequence: rawSeq - 1,\n        timestamp: rawTimestamp,\n        ...(producerId !== undefined ? { producerId } : {}),\n      };\n    }\n\n    if (rawTimestamp !== undefined && rawSeq !== undefined) {\n      // Stamped but non-monotonic against this transport's sequence stream:\n      // protocol survival wins, durable sequence identity is sacrificed loudly.\n      this.identityRestamped += 1;\n    }\n\n    const sequence = this.nextSequence;\n    this.nextSequence += 1;\n    return {\n      sequence,\n      ...(rawTimestamp !== undefined ? { timestamp: rawTimestamp } : {}),\n    };\n  }\n\n  attachPort(port: WoodTraceBatchPort): void {\n    this.detachPort();\n    this.port = port;\n    this.unsubscribePort = port.subscribe((message) => this.handleAcknowledgement(message));\n    if (this.inFlight) {\n      this.inFlight.awaitingAcknowledgement = false;\n      this.inFlight.retryReady = true;\n      this.inFlight.retryGeneration += 1;\n    }\n    this.scheduleDrain();\n  }\n\n  status(): WoodTraceBatchTransportStatus {\n    return Object.freeze({\n      state: this.state,\n      producerId: this.options.producerId,\n      nextSequence: this.nextSequence,\n      queuedEvents: this.queue.length,\n      inFlightBatchId: this.inFlight?.batch.batchId ?? null,\n      droppedCapacity: this.droppedCapacity,\n      droppedClosed: this.droppedClosed,\n      droppedRejected: this.droppedRejected,\n      droppedRetryExhausted: this.droppedRetryExhausted,\n      identityRestamped: this.identityRestamped,\n      metadataTruncatedValues: this.metadataTruncatedValues,\n      metadataRedactedValues: this.metadataRedactedValues,\n      metadataSerializationFailures: this.metadataSerializationFailures,\n      committedBatches: this.committedBatches,\n      retryAttempts: this.retryAttempts,\n    });\n  }\n\n  async flush(deadlineMs: number): Promise<void> {\n    this.scheduleDrain();\n    while (this.hasPendingEvents() && this.options.now() < deadlineMs) {\n      await this.options.delay(1);\n      this.scheduleDrain();\n    }\n  }\n\n  async close(deadlineMs: number): Promise<void> {\n    if (this.state === 'stopped') {\n      return;\n    }\n    this.state = 'draining';\n    await this.flush(deadlineMs);\n    const abandonedEvents = this.queue.length + (this.inFlight?.batch.events.length ?? 0);\n    this.droppedClosed += abandonedEvents;\n    this.queue.length = 0;\n    this.inFlight = null;\n    this.detachPort();\n    this.state = 'stopped';\n  }\n\n  private abandonRetryExhausted(): void {\n    if (!this.inFlight) {\n      return;\n    }\n    this.droppedRetryExhausted += this.inFlight.batch.events.length;\n    this.inFlight = null;\n    this.scheduleDrain();\n  }\n\n  private createInFlightBatch(): void {\n    if (this.inFlight || this.queue.length === 0 || !this.port) {\n      return;\n    }\n    const entries = this.queue.splice(0, this.options.maxBatchEvents);\n    const first = entries[0];\n    if (!first) {\n      return;\n    }\n    this.inFlight = {\n      batch: this.contract.create(\n        this.options.producerId,\n        first.sequence,\n        entries.map((entry) => entry.event),\n      ),\n      attempts: 0,\n      awaitingAcknowledgement: false,\n      retryReady: true,\n      retryGeneration: 0,\n    };\n  }\n\n  private detachPort(): void {\n    this.unsubscribePort?.();\n    this.unsubscribePort = null;\n    this.port?.close();\n    this.port = null;\n  }\n\n  private drain(): void {\n    this.createInFlightBatch();\n    this.sendInFlightBatch();\n  }\n\n  private handleAcknowledgement(message: unknown): void {\n    const parsed = this.contract.parseAcknowledgement(message);\n    if (!parsed.ok || !this.inFlight) {\n      return;\n    }\n    const acknowledgement = parsed.acknowledgement;\n    if (acknowledgement.batchId !== this.inFlight.batch.batchId) {\n      return;\n    }\n\n    this.inFlight.retryGeneration += 1;\n    this.inFlight.awaitingAcknowledgement = false;\n    if (acknowledgement.kind === 'committed') {\n      if (acknowledgement.acceptedEvents !== this.inFlight.batch.events.length) {\n        this.scheduleRetry(0);\n        return;\n      }\n      this.committedBatches += 1;\n      this.inFlight = null;\n      this.scheduleDrain();\n      return;\n    }\n    if (acknowledgement.kind === 'rejected') {\n      this.droppedRejected += this.inFlight.batch.events.length;\n      this.inFlight = null;\n      this.scheduleDrain();\n      return;\n    }\n    this.scheduleRetry(acknowledgement.retryAfterMs);\n  }\n\n  private handleAcknowledgementTimeout(batchId: string, attempt: number): void {\n    if (!this.inFlight\n      || this.inFlight.batch.batchId !== batchId\n      || this.inFlight.attempts !== attempt\n      || !this.inFlight.awaitingAcknowledgement) {\n      return;\n    }\n    this.inFlight.awaitingAcknowledgement = false;\n    this.scheduleRetry(this.retryDelay(attempt));\n  }\n\n  private hasPendingEvents(): boolean {\n    return this.queue.length > 0 || this.inFlight !== null;\n  }\n\n  private retryDelay(attempt: number): number {\n    return this.options.retryBaseDelayMs * (2 ** Math.max(0, attempt - 1));\n  }\n\n  private scheduleDrain(): void {\n    if (this.drainScheduled) {\n      return;\n    }\n    this.drainScheduled = true;\n    this.options.schedule(() => {\n      this.drainScheduled = false;\n      this.drain();\n    });\n  }\n\n  private scheduleRetry(requestedDelayMs: number): void {\n    if (!this.inFlight) {\n      return;\n    }\n    if (this.inFlight.attempts > this.options.retryLimit) {\n      this.abandonRetryExhausted();\n      return;\n    }\n\n    this.inFlight.retryReady = false;\n    const generation = this.inFlight.retryGeneration + 1;\n    this.inFlight.retryGeneration = generation;\n    const delayMs = Math.max(requestedDelayMs, this.retryDelay(this.inFlight.attempts));\n    void this.options.delay(delayMs).then(() => {\n      if (!this.inFlight || this.inFlight.retryGeneration !== generation) {\n        return;\n      }\n      this.inFlight.retryReady = true;\n      this.scheduleDrain();\n    });\n  }\n\n  private sendInFlightBatch(): void {\n    const current = this.inFlight;\n    const port = this.port;\n    if (!current || !port || current.awaitingAcknowledgement || !current.retryReady) {\n      return;\n    }\n    if (current.attempts > this.options.retryLimit) {\n      this.abandonRetryExhausted();\n      return;\n    }\n\n    current.attempts += 1;\n    if (current.attempts > 1) {\n      this.retryAttempts += 1;\n    }\n    current.awaitingAcknowledgement = true;\n    current.retryReady = false;\n    const attempt = current.attempts;\n    try {\n      port.postMessage(current.batch);\n    } catch {\n      current.awaitingAcknowledgement = false;\n      this.detachPort();\n      return;\n    }\n\n    void this.options.delay(this.options.acknowledgementTimeoutMs).then(() => {\n      this.handleAcknowledgementTimeout(current.batch.batchId, attempt);\n    });\n  }\n\n  private snapshotEvent(\n    event: WoodRendererTraceInput,\n    sequence: number,\n    identity: { timestamp?: string; producerId?: string },\n  ): WoodRendererTraceEvent {\n    const snapshot = this.metadataSnapshotter.snapshot(event);\n    this.metadataTruncatedValues += snapshot.stats.truncatedValues;\n    this.metadataRedactedValues += snapshot.stats.redactedValues;\n    this.metadataSerializationFailures += snapshot.stats.serializationFailures;\n    const input = snapshot.metadata;\n    // A hub-preserved occurrence timestamp is authoritative; only legacy\n    // unstamped events receive a transport-stamped time.\n    let timestamp = identity.timestamp;\n    if (timestamp === undefined) {\n      const occurredAt = new Date(this.options.now());\n      timestamp = Number.isNaN(occurredAt.getTime())\n        ? new Date(0).toISOString()\n        : occurredAt.toISOString();\n    }\n    return Object.freeze({\n      source: this.snapshotString(input.source, 'unknown'),\n      type: this.snapshotString(input.type, 'unknown'),\n      level: this.snapshotString(input.level, 'info'),\n      process: 'renderer',\n      timestamp,\n      traceSeq: sequence + 1,\n      ...(identity.producerId !== undefined ? { producerId: identity.producerId } : {}),\n      ...this.snapshotOptionalString('message', input.message),\n      ...this.snapshotConversationId(input.conversationId),\n      ...this.snapshotPayload(input.payload),\n      ...this.snapshotOptionalString('windowId', input.windowId),\n      ...this.snapshotOptionalNumber('webContentsId', input.webContentsId),\n      ...this.snapshotOptionalString('routeKey', input.routeKey),\n      ...this.snapshotOptionalString('harnessId', input.harnessId),\n    });\n  }\n\n  private snapshotConversationId(\n    value: TelemetryJsonValue | undefined,\n  ): Pick<WoodRendererTraceEvent, 'conversationId'> | Record<string, never> {\n    return typeof value === 'string' || typeof value === 'number'\n      ? { conversationId: value }\n      : {};\n  }\n\n  private snapshotOptionalNumber<Key extends 'webContentsId'>(\n    key: Key,\n    value: TelemetryJsonValue | undefined,\n  ): Partial<Pick<WoodRendererTraceEvent, Key>> {\n    return typeof value === 'number' && Number.isFinite(value)\n      ? { [key]: value } as Pick<WoodRendererTraceEvent, Key>\n      : {};\n  }\n\n  private snapshotOptionalString<Key extends 'message' | 'windowId' | 'routeKey' | 'harnessId'>(\n    key: Key,\n    value: TelemetryJsonValue | undefined,\n  ): Partial<Pick<WoodRendererTraceEvent, Key>> {\n    return typeof value === 'string'\n      ? { [key]: value } as Pick<WoodRendererTraceEvent, Key>\n      : {};\n  }\n\n  private snapshotPayload(\n    value: TelemetryJsonValue | undefined,\n  ): Pick<WoodRendererTraceEvent, 'payload'> | Record<string, never> {\n    if (value === undefined) {\n      return {};\n    }\n    const payload: TelemetryJsonObject = this.isJsonObject(value)\n      ? value\n      : Object.freeze({ __telemetry: value });\n    return { payload };\n  }\n\n  private snapshotString(value: TelemetryJsonValue | undefined, fallback: string): string {\n    return typeof value === 'string' && value.trim().length > 0 ? value : fallback;\n  }\n\n  private isJsonObject(value: TelemetryJsonValue): value is TelemetryJsonObject {\n    return typeof value === 'object' && value !== null && !Array.isArray(value);\n  }\n\n  private validateOptions(): void {\n    const validCapacity = Number.isSafeInteger(this.options.maxQueuedEvents)\n      && this.options.maxQueuedEvents > 0\n      && Number.isSafeInteger(this.options.maxBatchEvents)\n      && this.options.maxBatchEvents > 0\n      && this.options.maxBatchEvents <= this.options.maxQueuedEvents;\n    const validRetry = Number.isSafeInteger(this.options.retryLimit)\n      && this.options.retryLimit >= 0\n      && Number.isFinite(this.options.retryBaseDelayMs)\n      && this.options.retryBaseDelayMs >= 0\n      && Number.isFinite(this.options.acknowledgementTimeoutMs)\n      && this.options.acknowledgementTimeoutMs > 0;\n    if (!this.options.producerId.trim() || !validCapacity || !validRetry) {\n      throw new Error('Renderer trace batch transport options are invalid');\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/tracing/trace_batch_adapter.cjs

@@ -0,0 +1,110 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var trace_batch_adapter_exports = {};
+__export(trace_batch_adapter_exports, {
+  woodBatchToTraceBatch: () => woodBatchToTraceBatch
+});
+module.exports = __toCommonJS(trace_batch_adapter_exports);
+var import_trace = require("@noego/trace");
+function woodBatchToTraceBatch(batch, context = {}, options = {}) {
+  if (batch.events.length === 0) {
+    return { ok: false, reason: "Wood trace batch is empty" };
+  }
+  const producerId = resolveUniformProducerId(batch);
+  const records = [];
+  let previousSequence = 0;
+  for (const event of batch.events) {
+    const occurredAtMs = Date.parse(event.timestamp);
+    if (!Number.isFinite(occurredAtMs)) {
+      return { ok: false, reason: `Wood trace event timestamp is invalid: '${event.timestamp}'` };
+    }
+    if (!Number.isSafeInteger(event.traceSeq) || event.traceSeq < 1) {
+      return { ok: false, reason: `Wood trace event sequence is invalid: ${event.traceSeq}` };
+    }
+    if (event.traceSeq <= previousSequence) {
+      return { ok: false, reason: "Wood trace event sequences are not strictly increasing" };
+    }
+    previousSequence = event.traceSeq;
+    records.push(convertEvent(event, producerId, occurredAtMs, context));
+  }
+  const first = records[0];
+  const last = records[records.length - 1];
+  if (!first || !last) {
+    return { ok: false, reason: "Wood trace batch is empty" };
+  }
+  return {
+    ok: true,
+    batch: Object.freeze({
+      schemaVersion: 1,
+      batchId: batch.batchId,
+      producerId,
+      sequenceStart: first.sequence,
+      sequenceEnd: last.sequence,
+      createdAtMs: options.createdAtMs ?? Date.now(),
+      records: Object.freeze(records)
+    })
+  };
+}
+function resolveUniformProducerId(batch) {
+  const first = batch.events[0]?.producerId;
+  if (typeof first === "string" && first.trim().length > 0) {
+    const uniform = batch.events.every((event) => event.producerId === first);
+    if (uniform) {
+      return first;
+    }
+  }
+  return `wood:${batch.producerId}`;
+}
+function convertEvent(event, producerId, occurredAtMs, context) {
+  const extras = {
+    ...event.payload ?? {}
+  };
+  const merged = { ...pickRuntimeContext(event), ...context };
+  if (merged.windowId !== void 0) extras.windowId = merged.windowId;
+  if (merged.webContentsId !== void 0) extras.webContentsId = merged.webContentsId;
+  if (merged.routeKey !== void 0) extras.routeKey = merged.routeKey;
+  if (merged.harnessId !== void 0) extras.harnessId = merged.harnessId;
+  return Object.freeze({
+    id: `${producerId}:${event.traceSeq}`,
+    occurredAtMs,
+    timestamp: occurredAtMs,
+    producerId,
+    sequence: event.traceSeq,
+    source: event.source,
+    event: event.type,
+    level: (0, import_trace.parseTraceLevel)(event.level),
+    process: event.process,
+    ...event.conversationId !== void 0 ? { conversationId: event.conversationId } : {},
+    ...typeof event.message === "string" ? { message: event.message } : {},
+    ...Object.keys(extras).length > 0 ? { context: Object.freeze(extras) } : {}
+  });
+}
+function pickRuntimeContext(event) {
+  return {
+    ...event.windowId !== void 0 ? { windowId: event.windowId } : {},
+    ...event.webContentsId !== void 0 ? { webContentsId: event.webContentsId } : {},
+    ...event.routeKey !== void 0 ? { routeKey: event.routeKey } : {},
+    ...event.harnessId !== void 0 ? { harnessId: event.harnessId } : {}
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  woodBatchToTraceBatch
+});
+//# sourceMappingURL=trace_batch_adapter.cjs.map

package/dist/tracing/trace_batch_adapter.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/tracing/trace_batch_adapter.ts"],"sourcesContent":["import type { AdmittedTraceEvent, TraceBatch } from '@noego/trace';\nimport { parseTraceLevel } from '@noego/trace';\nimport type {\n  WoodRendererTraceEvent,\n  WoodTraceBatch,\n  WoodTraceBatchRuntimeContext,\n} from './types/wood_trace_batch.types.js';\n\nexport type WoodTraceBatchConversion =\n  | { ok: true; batch: TraceBatch }\n  | { ok: false; reason: string };\n\n/**\n * Converts a validated Wood renderer trace batch into the @noego/trace\n * TraceBatch contract for the SQLite batch receiver.\n *\n * Identity is preserved, never regenerated:\n * - occurredAtMs = the event's producer-assigned ISO timestamp, parsed;\n * - sequence = the event's hub traceSeq (Wood batch ranges are queue\n *   sequences, i.e. traceSeq - 1, so the converted range shifts by +1);\n * - producerId = the hub producerId when every event carries the same one,\n *   else a 'wood:<preload-session>' fallback uniformly for the whole batch\n *   (the TraceBatch contract requires one producer per batch);\n * - id = '<producerId>:<sequence>' — deterministic, stable across retries;\n * - batchId is reused verbatim so receiver-side duplicate detection keys on\n *   the same delivery identity the renderer retries with.\n *\n * Runtime context (windowId/webContentsId/routeKey/harnessId) merges into the\n * event context without touching identity fields.\n */\nexport function woodBatchToTraceBatch(\n  batch: WoodTraceBatch,\n  context: WoodTraceBatchRuntimeContext = {},\n  options: { createdAtMs?: number } = {},\n): WoodTraceBatchConversion {\n  if (batch.events.length === 0) {\n    return { ok: false, reason: 'Wood trace batch is empty' };\n  }\n\n  const producerId = resolveUniformProducerId(batch);\n\n  const records: AdmittedTraceEvent[] = [];\n  let previousSequence = 0;\n  for (const event of batch.events) {\n    const occurredAtMs = Date.parse(event.timestamp);\n    if (!Number.isFinite(occurredAtMs)) {\n      return { ok: false, reason: `Wood trace event timestamp is invalid: '${event.timestamp}'` };\n    }\n    if (!Number.isSafeInteger(event.traceSeq) || event.traceSeq < 1) {\n      return { ok: false, reason: `Wood trace event sequence is invalid: ${event.traceSeq}` };\n    }\n    if (event.traceSeq <= previousSequence) {\n      return { ok: false, reason: 'Wood trace event sequences are not strictly increasing' };\n    }\n    previousSequence = event.traceSeq;\n    records.push(convertEvent(event, producerId, occurredAtMs, context));\n  }\n\n  const first = records[0];\n  const last = records[records.length - 1];\n  if (!first || !last) {\n    return { ok: false, reason: 'Wood trace batch is empty' };\n  }\n\n  return {\n    ok: true,\n    batch: Object.freeze({\n      schemaVersion: 1,\n      batchId: batch.batchId,\n      producerId,\n      sequenceStart: first.sequence,\n      sequenceEnd: last.sequence,\n      createdAtMs: options.createdAtMs ?? Date.now(),\n      records: Object.freeze(records),\n    }),\n  };\n}\n\nfunction resolveUniformProducerId(batch: WoodTraceBatch): string {\n  const first = batch.events[0]?.producerId;\n  if (typeof first === 'string' && first.trim().length > 0) {\n    const uniform = batch.events.every((event) => event.producerId === first);\n    if (uniform) {\n      return first;\n    }\n  }\n  return `wood:${batch.producerId}`;\n}\n\nfunction convertEvent(\n  event: WoodRendererTraceEvent,\n  producerId: string,\n  occurredAtMs: number,\n  context: WoodTraceBatchRuntimeContext,\n): AdmittedTraceEvent {\n  const extras: Record<string, unknown> = {\n    ...(event.payload ?? {}),\n  };\n  const merged: WoodTraceBatchRuntimeContext = { ...pickRuntimeContext(event), ...context };\n  if (merged.windowId !== undefined) extras.windowId = merged.windowId;\n  if (merged.webContentsId !== undefined) extras.webContentsId = merged.webContentsId;\n  if (merged.routeKey !== undefined) extras.routeKey = merged.routeKey;\n  if (merged.harnessId !== undefined) extras.harnessId = merged.harnessId;\n\n  return Object.freeze({\n    id: `${producerId}:${event.traceSeq}`,\n    occurredAtMs,\n    timestamp: occurredAtMs,\n    producerId,\n    sequence: event.traceSeq,\n    source: event.source,\n    event: event.type,\n    level: parseTraceLevel(event.level),\n    process: event.process,\n    ...(event.conversationId !== undefined ? { conversationId: event.conversationId } : {}),\n    ...(typeof event.message === 'string' ? { message: event.message } : {}),\n    ...(Object.keys(extras).length > 0 ? { context: Object.freeze(extras) } : {}),\n  }) as AdmittedTraceEvent;\n}\n\nfunction pickRuntimeContext(event: WoodRendererTraceEvent): WoodTraceBatchRuntimeContext {\n  return {\n    ...(event.windowId !== undefined ? { windowId: event.windowId } : {}),\n    ...(event.webContentsId !== undefined ? { webContentsId: event.webContentsId } : {}),\n    ...(event.routeKey !== undefined ? { routeKey: event.routeKey } : {}),\n    ...(event.harnessId !== undefined ? { harnessId: event.harnessId } : {}),\n  };\n}\n"],"mappings":"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","names":[]}