@noego/wood 0.4.9 → 0.5.0

package/dist/tracing/types/wood_trace_batch.types.d.cts

@@ -1,10 +1,18 @@
 import { MetadataSnapshotLimits } from '@noego/telemetry/core';
-import { a as TraceEvent, b as TraceInput, c as TraceLevel } from '../../trace_hub-Cob54qRx.cjs';
+import { a as TraceEvent, b as TraceInput, c as TraceLevel } from '../../trace_hub-Cpo_nVze.cjs';
 import 'rxjs';
 
 type WoodRendererTraceInput = Readonly<Omit<TraceInput, 'payload'> & {
     readonly level: TraceLevel;
     readonly payload?: Readonly<Record<string, unknown>>;
+    /**
+     * Hub-admitted identity, present when the renderer TraceHub admitted the
+     * event before it reached the transport. The transport preserves these
+     * exactly; it stamps its own only for legacy senders that omit them.
+     */
+    readonly timestamp?: string;
+    readonly traceSeq?: number;
+    readonly producerId?: string;
 }>;
 type WoodRendererTraceEvent = Readonly<Omit<TraceEvent, 'payload'> & {
     readonly payload?: Readonly<Record<string, unknown>>;
@@ -60,6 +68,12 @@ type WoodTraceBatchTransportStatus = Readonly<{
     droppedClosed: number;
     droppedRejected: number;
     droppedRetryExhausted: number;
+    /**
+     * Count of stamped events whose traceSeq regressed against this transport's
+     * sequence stream and were restamped as legacy. Nonzero means more than one
+     * admission source is feeding one transport — the invariant is broken.
+     */
+    identityRestamped: number;
     metadataTruncatedValues: number;
     metadataRedactedValues: number;
     metadataSerializationFailures: number;

package/dist/tracing/types/wood_trace_batch.types.d.ts

@@ -1,10 +1,18 @@
 import { MetadataSnapshotLimits } from '@noego/telemetry/core';
-import { a as TraceEvent, b as TraceInput, c as TraceLevel } from '../../trace_hub-Cob54qRx.js';
+import { a as TraceEvent, b as TraceInput, c as TraceLevel } from '../../trace_hub-Cpo_nVze.js';
 import 'rxjs';
 
 type WoodRendererTraceInput = Readonly<Omit<TraceInput, 'payload'> & {
     readonly level: TraceLevel;
     readonly payload?: Readonly<Record<string, unknown>>;
+    /**
+     * Hub-admitted identity, present when the renderer TraceHub admitted the
+     * event before it reached the transport. The transport preserves these
+     * exactly; it stamps its own only for legacy senders that omit them.
+     */
+    readonly timestamp?: string;
+    readonly traceSeq?: number;
+    readonly producerId?: string;
 }>;
 type WoodRendererTraceEvent = Readonly<Omit<TraceEvent, 'payload'> & {
     readonly payload?: Readonly<Record<string, unknown>>;
@@ -60,6 +68,12 @@ type WoodTraceBatchTransportStatus = Readonly<{
     droppedClosed: number;
     droppedRejected: number;
     droppedRetryExhausted: number;
+    /**
+     * Count of stamped events whose traceSeq regressed against this transport's
+     * sequence stream and were restamped as legacy. Nonzero means more than one
+     * admission source is feeding one transport — the invariant is broken.
+     */
+    identityRestamped: number;
     metadataTruncatedValues: number;
     metadataRedactedValues: number;
     metadataSerializationFailures: number;

package/dist/tracing/types/wood_trace_sink.types.d.cts

@@ -1,2 +1,2 @@
-export { W as WoodTraceEventSink, g as WoodTraceEventSnapshot, h as WoodTraceSinkDisposer } from '../../trace_hub-Cob54qRx.cjs';
+export { W as WoodTraceEventSink, g as WoodTraceEventSnapshot, h as WoodTraceSinkDisposer } from '../../trace_hub-Cpo_nVze.cjs';
 import 'rxjs';

package/dist/tracing/types/wood_trace_sink.types.d.ts

@@ -1,2 +1,2 @@
-export { W as WoodTraceEventSink, g as WoodTraceEventSnapshot, h as WoodTraceSinkDisposer } from '../../trace_hub-Cob54qRx.js';
+export { W as WoodTraceEventSink, g as WoodTraceEventSnapshot, h as WoodTraceSinkDisposer } from '../../trace_hub-Cpo_nVze.js';
 import 'rxjs';

package/dist/tracing/wood_trace_batch_contract.cjs

@@ -153,6 +153,8 @@ class WoodTraceBatchContract {
         process: "renderer",
         timestamp: input.timestamp,
         traceSeq: input.traceSeq,
+        // Durable identity passthrough: never a validation failure when absent.
+        ...typeof input.producerId === "string" && input.producerId.trim().length > 0 ? { producerId: input.producerId } : {},
         ...typeof input.message === "string" ? { message: input.message } : {},
         ...this.isConversationId(input.conversationId) ? { conversationId: input.conversationId } : {},
         ...input.payload ? { payload: input.payload } : {},

package/dist/tracing/wood_trace_batch_contract.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/tracing/wood_trace_batch_contract.ts"],"sourcesContent":["import type {\n  WoodRendererTraceEvent,\n  WoodTraceAcknowledgementParseResult,\n  WoodTraceBatch,\n  WoodTraceBatchAcknowledgement,\n  WoodTraceBatchParseResult,\n  WoodTraceEventParseResult,\n  WoodTraceEventsParseResult,\n  WoodTraceIdentityValidationResult,\n} from './types/wood_trace_batch.types.js';\n\nconst MAX_BATCH_EVENTS = 256;\n\nexport class WoodTraceBatchContract {\n  create(\n    producerId: string,\n    sequenceStart: number,\n    events: readonly WoodRendererTraceEvent[],\n  ): WoodTraceBatch {\n    const snapshots = events.map((event) => this.snapshotEvent(event));\n    const last = snapshots[snapshots.length - 1];\n    const sequenceEnd = last ? last.traceSeq - 1 : sequenceStart - 1;\n    return Object.freeze({\n      kind: 'wood.trace.batch',\n      protocolVersion: 1,\n      producerId,\n      batchId: `wtb1:${producerId}:${sequenceStart}-${sequenceEnd}`,\n      sequenceStart,\n      sequenceEnd,\n      events: Object.freeze(snapshots),\n    });\n  }\n\n  parse(input: unknown): WoodTraceBatchParseResult {\n    if (!this.isRecord(input) || input.kind !== 'wood.trace.batch') {\n      return { kind: 'not-batch' };\n    }\n\n    const batchId = typeof input.batchId === 'string' ? input.batchId : null;\n    const identity = this.validateIdentity(input);\n    if (identity.kind === 'invalid') {\n      return { kind: 'invalid', batchId, reason: identity.reason };\n    }\n    const producerId = input.producerId;\n    if (typeof producerId !== 'string') {\n      return { kind: 'invalid', batchId, reason: 'Trace batch producer identity is invalid' };\n    }\n\n    const parsedEvents = this.parseEvents(input.events);\n    if (parsedEvents.kind === 'invalid') {\n      return { kind: 'invalid', batchId, reason: parsedEvents.reason };\n    }\n    const events = parsedEvents.events;\n\n    const parsedSequenceRange = this.parseSequenceRange(input, events);\n    if (parsedSequenceRange.kind === 'invalid') {\n      return { kind: 'invalid', batchId, reason: parsedSequenceRange.reason };\n    }\n    const { sequenceStart, sequenceEnd } = parsedSequenceRange;\n    const hasTraceSequenceMismatch = events.some((event, index) => {\n      const previous = events[index - 1];\n      return previous !== undefined && event.traceSeq <= previous.traceSeq;\n    });\n    if (hasTraceSequenceMismatch) {\n      return { kind: 'invalid', batchId, reason: 'Trace event sequences are not strictly increasing' };\n    }\n    const expectedBatchId = `wtb1:${producerId}:${sequenceStart}-${sequenceEnd}`;\n    if (input.batchId !== expectedBatchId) {\n      return { kind: 'invalid', batchId, reason: 'Trace batch identity does not match its sequence range' };\n    }\n\n    return {\n      kind: 'valid',\n      batch: this.create(producerId, sequenceStart, events),\n    };\n  }\n\n  parseAcknowledgement(input: unknown): WoodTraceAcknowledgementParseResult {\n    if (!this.isRecord(input) || typeof input.kind !== 'string' || typeof input.batchId !== 'string') {\n      return { ok: false, reason: 'Trace batch acknowledgement framing is invalid' };\n    }\n\n    if (input.kind === 'committed') {\n      return this.parseCommittedAcknowledgement(input);\n    }\n    if (input.kind === 'retryable') {\n      return this.parseRetryableAcknowledgement(input);\n    }\n    if (input.kind === 'rejected' && typeof input.reason === 'string') {\n      return {\n        ok: true,\n        acknowledgement: Object.freeze({\n          kind: 'rejected',\n          batchId: input.batchId,\n          reason: input.reason,\n        }),\n      };\n    }\n    return { ok: false, reason: 'Trace batch acknowledgement kind is invalid' };\n  }\n\n  private parseCommittedAcknowledgement(\n    input: Record<string, unknown>,\n  ): WoodTraceAcknowledgementParseResult {\n    const batchId = input.batchId;\n    const committedAtMs = input.committedAtMs;\n    const acceptedEvents = input.acceptedEvents;\n    const validNumbers = typeof batchId === 'string'\n      && typeof committedAtMs === 'number'\n      && Number.isFinite(committedAtMs)\n      && typeof acceptedEvents === 'number'\n      && Number.isSafeInteger(acceptedEvents)\n      && acceptedEvents >= 0;\n    if (!validNumbers) {\n      return { ok: false, reason: 'Committed trace acknowledgement is invalid' };\n    }\n    return {\n      ok: true,\n      acknowledgement: Object.freeze({\n        kind: 'committed',\n        batchId,\n        committedAtMs,\n        acceptedEvents,\n      }),\n    };\n  }\n\n  private parseRetryableAcknowledgement(\n    input: Record<string, unknown>,\n  ): WoodTraceAcknowledgementParseResult {\n    const batchId = input.batchId;\n    const retryAfterMs = input.retryAfterMs;\n    if (typeof batchId !== 'string'\n      || typeof input.reason !== 'string'\n      || typeof retryAfterMs !== 'number'\n      || !Number.isFinite(retryAfterMs)\n      || retryAfterMs < 0) {\n      return { ok: false, reason: 'Retryable trace acknowledgement is invalid' };\n    }\n    return {\n      ok: true,\n      acknowledgement: Object.freeze({\n        kind: 'retryable',\n        batchId,\n        reason: input.reason,\n        retryAfterMs,\n      }),\n    };\n  }\n\n  private parseEvent(input: unknown): WoodTraceEventParseResult {\n    if (!this.isRecord(input)) {\n      return { kind: 'invalid', reason: 'Trace event is not an object' };\n    }\n    const hasValidIdentity = this.hasValidEventIdentity(input);\n    const hasValidTiming = this.hasValidEventTiming(input);\n    if (!hasValidIdentity || !hasValidTiming) {\n      return { kind: 'invalid', reason: 'Trace event identity or timing is invalid' };\n    }\n    if (input.payload !== undefined && !this.isRecord(input.payload)) {\n      return { kind: 'invalid', reason: 'Trace event payload is invalid' };\n    }\n    return {\n      kind: 'valid',\n      event: this.snapshotEvent({\n        source: input.source,\n        type: input.type,\n        level: input.level,\n        process: 'renderer',\n        timestamp: input.timestamp,\n        traceSeq: input.traceSeq,\n        ...(typeof input.message === 'string' ? { message: input.message } : {}),\n        ...(this.isConversationId(input.conversationId) ? { conversationId: input.conversationId } : {}),\n        ...(input.payload ? { payload: input.payload } : {}),\n        ...(typeof input.windowId === 'string' ? { windowId: input.windowId } : {}),\n        ...(typeof input.webContentsId === 'number' && Number.isFinite(input.webContentsId)\n          ? { webContentsId: input.webContentsId }\n          : {}),\n        ...(typeof input.routeKey === 'string' ? { routeKey: input.routeKey } : {}),\n        ...(typeof input.harnessId === 'string' ? { harnessId: input.harnessId } : {}),\n      }),\n    };\n  }\n\n  private hasValidEventIdentity(input: Record<string, unknown>): input is Record<string, unknown> & {\n    source: string;\n    type: string;\n    level: string;\n    process: 'renderer';\n  } {\n    return typeof input.source === 'string'\n      && input.source.trim().length > 0\n      && typeof input.type === 'string'\n      && input.type.trim().length > 0\n      && typeof input.level === 'string'\n      && input.level.trim().length > 0\n      && input.process === 'renderer';\n  }\n\n  private hasValidEventTiming(input: Record<string, unknown>): input is Record<string, unknown> & {\n    timestamp: string;\n    traceSeq: number;\n  } {\n    return typeof input.timestamp === 'string'\n      && Number.isFinite(Date.parse(input.timestamp))\n      && typeof input.traceSeq === 'number'\n      && Number.isSafeInteger(input.traceSeq)\n      && input.traceSeq >= 1;\n  }\n\n  private parseEvents(input: unknown): WoodTraceEventsParseResult {\n    if (!Array.isArray(input) || input.length === 0 || input.length > MAX_BATCH_EVENTS) {\n      return { kind: 'invalid', reason: 'Trace batch events are invalid' };\n    }\n    const events: WoodRendererTraceEvent[] = [];\n    for (const rawEvent of input) {\n      const parsedEvent = this.parseEvent(rawEvent);\n      if (parsedEvent.kind === 'invalid') {\n        return parsedEvent;\n      }\n      events.push(parsedEvent.event);\n    }\n    return { kind: 'valid', events: Object.freeze(events) };\n  }\n\n  private parseSequenceRange(\n    input: Record<string, unknown>,\n    events: readonly WoodRendererTraceEvent[],\n  ): { kind: 'invalid'; reason: string } | { kind: 'valid'; sequenceStart: number; sequenceEnd: number } {\n    const sequenceStart = input.sequenceStart;\n    const sequenceEnd = input.sequenceEnd;\n    if (typeof sequenceStart !== 'number' || typeof sequenceEnd !== 'number') {\n      return { kind: 'invalid', reason: 'Trace batch sequence range is invalid' };\n    }\n    const firstEvent = events[0];\n    const lastEvent = events[events.length - 1];\n    const hasInvalidRange = !Number.isSafeInteger(sequenceStart)\n      || sequenceStart < 0\n      || !Number.isSafeInteger(sequenceEnd)\n      || !firstEvent\n      || !lastEvent\n      || firstEvent.traceSeq !== sequenceStart + 1\n      || lastEvent.traceSeq !== sequenceEnd + 1;\n    if (hasInvalidRange) {\n      return { kind: 'invalid', reason: 'Trace batch sequence range does not match its events' };\n    }\n    return { kind: 'valid', sequenceStart, sequenceEnd };\n  }\n\n  private snapshotEvent(event: WoodRendererTraceEvent): WoodRendererTraceEvent {\n    return Object.freeze({\n      ...event,\n      ...(event.payload ? { payload: Object.freeze({ ...event.payload }) } : {}),\n    });\n  }\n\n  private validateIdentity(input: Record<string, unknown>): WoodTraceIdentityValidationResult {\n    if (input.protocolVersion !== 1) {\n      return { kind: 'invalid', reason: 'Trace batch protocol version is unsupported' };\n    }\n    if (typeof input.producerId !== 'string' || input.producerId.trim().length === 0) {\n      return { kind: 'invalid', reason: 'Trace batch producer identity is invalid' };\n    }\n    if (typeof input.batchId !== 'string' || input.batchId.trim().length === 0) {\n      return { kind: 'invalid', reason: 'Trace batch identity is invalid' };\n    }\n    return { kind: 'valid' };\n  }\n\n  private isConversationId(value: unknown): value is string | number {\n    return typeof value === 'string' || (typeof value === 'number' && Number.isFinite(value));\n  }\n\n  private isRecord(value: unknown): value is Record<string, unknown> {\n    return typeof value === 'object' && value !== null && !Array.isArray(value);\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/tracing/wood_trace_batch_contract.ts"],"sourcesContent":["import type {\n  WoodRendererTraceEvent,\n  WoodTraceAcknowledgementParseResult,\n  WoodTraceBatch,\n  WoodTraceBatchAcknowledgement,\n  WoodTraceBatchParseResult,\n  WoodTraceEventParseResult,\n  WoodTraceEventsParseResult,\n  WoodTraceIdentityValidationResult,\n} from './types/wood_trace_batch.types.js';\n\nconst MAX_BATCH_EVENTS = 256;\n\nexport class WoodTraceBatchContract {\n  create(\n    producerId: string,\n    sequenceStart: number,\n    events: readonly WoodRendererTraceEvent[],\n  ): WoodTraceBatch {\n    const snapshots = events.map((event) => this.snapshotEvent(event));\n    const last = snapshots[snapshots.length - 1];\n    const sequenceEnd = last ? last.traceSeq - 1 : sequenceStart - 1;\n    return Object.freeze({\n      kind: 'wood.trace.batch',\n      protocolVersion: 1,\n      producerId,\n      batchId: `wtb1:${producerId}:${sequenceStart}-${sequenceEnd}`,\n      sequenceStart,\n      sequenceEnd,\n      events: Object.freeze(snapshots),\n    });\n  }\n\n  parse(input: unknown): WoodTraceBatchParseResult {\n    if (!this.isRecord(input) || input.kind !== 'wood.trace.batch') {\n      return { kind: 'not-batch' };\n    }\n\n    const batchId = typeof input.batchId === 'string' ? input.batchId : null;\n    const identity = this.validateIdentity(input);\n    if (identity.kind === 'invalid') {\n      return { kind: 'invalid', batchId, reason: identity.reason };\n    }\n    const producerId = input.producerId;\n    if (typeof producerId !== 'string') {\n      return { kind: 'invalid', batchId, reason: 'Trace batch producer identity is invalid' };\n    }\n\n    const parsedEvents = this.parseEvents(input.events);\n    if (parsedEvents.kind === 'invalid') {\n      return { kind: 'invalid', batchId, reason: parsedEvents.reason };\n    }\n    const events = parsedEvents.events;\n\n    const parsedSequenceRange = this.parseSequenceRange(input, events);\n    if (parsedSequenceRange.kind === 'invalid') {\n      return { kind: 'invalid', batchId, reason: parsedSequenceRange.reason };\n    }\n    const { sequenceStart, sequenceEnd } = parsedSequenceRange;\n    const hasTraceSequenceMismatch = events.some((event, index) => {\n      const previous = events[index - 1];\n      return previous !== undefined && event.traceSeq <= previous.traceSeq;\n    });\n    if (hasTraceSequenceMismatch) {\n      return { kind: 'invalid', batchId, reason: 'Trace event sequences are not strictly increasing' };\n    }\n    const expectedBatchId = `wtb1:${producerId}:${sequenceStart}-${sequenceEnd}`;\n    if (input.batchId !== expectedBatchId) {\n      return { kind: 'invalid', batchId, reason: 'Trace batch identity does not match its sequence range' };\n    }\n\n    return {\n      kind: 'valid',\n      batch: this.create(producerId, sequenceStart, events),\n    };\n  }\n\n  parseAcknowledgement(input: unknown): WoodTraceAcknowledgementParseResult {\n    if (!this.isRecord(input) || typeof input.kind !== 'string' || typeof input.batchId !== 'string') {\n      return { ok: false, reason: 'Trace batch acknowledgement framing is invalid' };\n    }\n\n    if (input.kind === 'committed') {\n      return this.parseCommittedAcknowledgement(input);\n    }\n    if (input.kind === 'retryable') {\n      return this.parseRetryableAcknowledgement(input);\n    }\n    if (input.kind === 'rejected' && typeof input.reason === 'string') {\n      return {\n        ok: true,\n        acknowledgement: Object.freeze({\n          kind: 'rejected',\n          batchId: input.batchId,\n          reason: input.reason,\n        }),\n      };\n    }\n    return { ok: false, reason: 'Trace batch acknowledgement kind is invalid' };\n  }\n\n  private parseCommittedAcknowledgement(\n    input: Record<string, unknown>,\n  ): WoodTraceAcknowledgementParseResult {\n    const batchId = input.batchId;\n    const committedAtMs = input.committedAtMs;\n    const acceptedEvents = input.acceptedEvents;\n    const validNumbers = typeof batchId === 'string'\n      && typeof committedAtMs === 'number'\n      && Number.isFinite(committedAtMs)\n      && typeof acceptedEvents === 'number'\n      && Number.isSafeInteger(acceptedEvents)\n      && acceptedEvents >= 0;\n    if (!validNumbers) {\n      return { ok: false, reason: 'Committed trace acknowledgement is invalid' };\n    }\n    return {\n      ok: true,\n      acknowledgement: Object.freeze({\n        kind: 'committed',\n        batchId,\n        committedAtMs,\n        acceptedEvents,\n      }),\n    };\n  }\n\n  private parseRetryableAcknowledgement(\n    input: Record<string, unknown>,\n  ): WoodTraceAcknowledgementParseResult {\n    const batchId = input.batchId;\n    const retryAfterMs = input.retryAfterMs;\n    if (typeof batchId !== 'string'\n      || typeof input.reason !== 'string'\n      || typeof retryAfterMs !== 'number'\n      || !Number.isFinite(retryAfterMs)\n      || retryAfterMs < 0) {\n      return { ok: false, reason: 'Retryable trace acknowledgement is invalid' };\n    }\n    return {\n      ok: true,\n      acknowledgement: Object.freeze({\n        kind: 'retryable',\n        batchId,\n        reason: input.reason,\n        retryAfterMs,\n      }),\n    };\n  }\n\n  private parseEvent(input: unknown): WoodTraceEventParseResult {\n    if (!this.isRecord(input)) {\n      return { kind: 'invalid', reason: 'Trace event is not an object' };\n    }\n    const hasValidIdentity = this.hasValidEventIdentity(input);\n    const hasValidTiming = this.hasValidEventTiming(input);\n    if (!hasValidIdentity || !hasValidTiming) {\n      return { kind: 'invalid', reason: 'Trace event identity or timing is invalid' };\n    }\n    if (input.payload !== undefined && !this.isRecord(input.payload)) {\n      return { kind: 'invalid', reason: 'Trace event payload is invalid' };\n    }\n    return {\n      kind: 'valid',\n      event: this.snapshotEvent({\n        source: input.source,\n        type: input.type,\n        level: input.level,\n        process: 'renderer',\n        timestamp: input.timestamp,\n        traceSeq: input.traceSeq,\n        // Durable identity passthrough: never a validation failure when absent.\n        ...(typeof input.producerId === 'string' && input.producerId.trim().length > 0\n          ? { producerId: input.producerId }\n          : {}),\n        ...(typeof input.message === 'string' ? { message: input.message } : {}),\n        ...(this.isConversationId(input.conversationId) ? { conversationId: input.conversationId } : {}),\n        ...(input.payload ? { payload: input.payload } : {}),\n        ...(typeof input.windowId === 'string' ? { windowId: input.windowId } : {}),\n        ...(typeof input.webContentsId === 'number' && Number.isFinite(input.webContentsId)\n          ? { webContentsId: input.webContentsId }\n          : {}),\n        ...(typeof input.routeKey === 'string' ? { routeKey: input.routeKey } : {}),\n        ...(typeof input.harnessId === 'string' ? { harnessId: input.harnessId } : {}),\n      }),\n    };\n  }\n\n  private hasValidEventIdentity(input: Record<string, unknown>): input is Record<string, unknown> & {\n    source: string;\n    type: string;\n    level: string;\n    process: 'renderer';\n  } {\n    return typeof input.source === 'string'\n      && input.source.trim().length > 0\n      && typeof input.type === 'string'\n      && input.type.trim().length > 0\n      && typeof input.level === 'string'\n      && input.level.trim().length > 0\n      && input.process === 'renderer';\n  }\n\n  private hasValidEventTiming(input: Record<string, unknown>): input is Record<string, unknown> & {\n    timestamp: string;\n    traceSeq: number;\n  } {\n    return typeof input.timestamp === 'string'\n      && Number.isFinite(Date.parse(input.timestamp))\n      && typeof input.traceSeq === 'number'\n      && Number.isSafeInteger(input.traceSeq)\n      && input.traceSeq >= 1;\n  }\n\n  private parseEvents(input: unknown): WoodTraceEventsParseResult {\n    if (!Array.isArray(input) || input.length === 0 || input.length > MAX_BATCH_EVENTS) {\n      return { kind: 'invalid', reason: 'Trace batch events are invalid' };\n    }\n    const events: WoodRendererTraceEvent[] = [];\n    for (const rawEvent of input) {\n      const parsedEvent = this.parseEvent(rawEvent);\n      if (parsedEvent.kind === 'invalid') {\n        return parsedEvent;\n      }\n      events.push(parsedEvent.event);\n    }\n    return { kind: 'valid', events: Object.freeze(events) };\n  }\n\n  private parseSequenceRange(\n    input: Record<string, unknown>,\n    events: readonly WoodRendererTraceEvent[],\n  ): { kind: 'invalid'; reason: string } | { kind: 'valid'; sequenceStart: number; sequenceEnd: number } {\n    const sequenceStart = input.sequenceStart;\n    const sequenceEnd = input.sequenceEnd;\n    if (typeof sequenceStart !== 'number' || typeof sequenceEnd !== 'number') {\n      return { kind: 'invalid', reason: 'Trace batch sequence range is invalid' };\n    }\n    const firstEvent = events[0];\n    const lastEvent = events[events.length - 1];\n    const hasInvalidRange = !Number.isSafeInteger(sequenceStart)\n      || sequenceStart < 0\n      || !Number.isSafeInteger(sequenceEnd)\n      || !firstEvent\n      || !lastEvent\n      || firstEvent.traceSeq !== sequenceStart + 1\n      || lastEvent.traceSeq !== sequenceEnd + 1;\n    if (hasInvalidRange) {\n      return { kind: 'invalid', reason: 'Trace batch sequence range does not match its events' };\n    }\n    return { kind: 'valid', sequenceStart, sequenceEnd };\n  }\n\n  private snapshotEvent(event: WoodRendererTraceEvent): WoodRendererTraceEvent {\n    return Object.freeze({\n      ...event,\n      ...(event.payload ? { payload: Object.freeze({ ...event.payload }) } : {}),\n    });\n  }\n\n  private validateIdentity(input: Record<string, unknown>): WoodTraceIdentityValidationResult {\n    if (input.protocolVersion !== 1) {\n      return { kind: 'invalid', reason: 'Trace batch protocol version is unsupported' };\n    }\n    if (typeof input.producerId !== 'string' || input.producerId.trim().length === 0) {\n      return { kind: 'invalid', reason: 'Trace batch producer identity is invalid' };\n    }\n    if (typeof input.batchId !== 'string' || input.batchId.trim().length === 0) {\n      return { kind: 'invalid', reason: 'Trace batch identity is invalid' };\n    }\n    return { kind: 'valid' };\n  }\n\n  private isConversationId(value: unknown): value is string | number {\n    return typeof value === 'string' || (typeof value === 'number' && Number.isFinite(value));\n  }\n\n  private isRecord(value: unknown): value is Record<string, unknown> {\n    return typeof value === 'object' && value !== null && !Array.isArray(value);\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/tracing/wood_trace_batch_contract.d.cts

@@ -1,6 +1,6 @@
 import { WoodRendererTraceEvent, WoodTraceBatch, WoodTraceBatchParseResult, WoodTraceAcknowledgementParseResult } 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 WoodTraceBatchContract {

package/dist/tracing/wood_trace_batch_contract.d.ts

@@ -1,6 +1,6 @@
 import { WoodRendererTraceEvent, WoodTraceBatch, WoodTraceBatchParseResult, WoodTraceAcknowledgementParseResult } 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 WoodTraceBatchContract {

package/dist/tracing/wood_trace_batch_contract.js

@@ -130,6 +130,8 @@ class WoodTraceBatchContract {
         process: "renderer",
         timestamp: input.timestamp,
         traceSeq: input.traceSeq,
+        // Durable identity passthrough: never a validation failure when absent.
+        ...typeof input.producerId === "string" && input.producerId.trim().length > 0 ? { producerId: input.producerId } : {},
         ...typeof input.message === "string" ? { message: input.message } : {},
         ...this.isConversationId(input.conversationId) ? { conversationId: input.conversationId } : {},
         ...input.payload ? { payload: input.payload } : {},

package/dist/tracing/wood_trace_batch_contract.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/tracing/wood_trace_batch_contract.ts"],"sourcesContent":["import type {\n  WoodRendererTraceEvent,\n  WoodTraceAcknowledgementParseResult,\n  WoodTraceBatch,\n  WoodTraceBatchAcknowledgement,\n  WoodTraceBatchParseResult,\n  WoodTraceEventParseResult,\n  WoodTraceEventsParseResult,\n  WoodTraceIdentityValidationResult,\n} from './types/wood_trace_batch.types.js';\n\nconst MAX_BATCH_EVENTS = 256;\n\nexport class WoodTraceBatchContract {\n  create(\n    producerId: string,\n    sequenceStart: number,\n    events: readonly WoodRendererTraceEvent[],\n  ): WoodTraceBatch {\n    const snapshots = events.map((event) => this.snapshotEvent(event));\n    const last = snapshots[snapshots.length - 1];\n    const sequenceEnd = last ? last.traceSeq - 1 : sequenceStart - 1;\n    return Object.freeze({\n      kind: 'wood.trace.batch',\n      protocolVersion: 1,\n      producerId,\n      batchId: `wtb1:${producerId}:${sequenceStart}-${sequenceEnd}`,\n      sequenceStart,\n      sequenceEnd,\n      events: Object.freeze(snapshots),\n    });\n  }\n\n  parse(input: unknown): WoodTraceBatchParseResult {\n    if (!this.isRecord(input) || input.kind !== 'wood.trace.batch') {\n      return { kind: 'not-batch' };\n    }\n\n    const batchId = typeof input.batchId === 'string' ? input.batchId : null;\n    const identity = this.validateIdentity(input);\n    if (identity.kind === 'invalid') {\n      return { kind: 'invalid', batchId, reason: identity.reason };\n    }\n    const producerId = input.producerId;\n    if (typeof producerId !== 'string') {\n      return { kind: 'invalid', batchId, reason: 'Trace batch producer identity is invalid' };\n    }\n\n    const parsedEvents = this.parseEvents(input.events);\n    if (parsedEvents.kind === 'invalid') {\n      return { kind: 'invalid', batchId, reason: parsedEvents.reason };\n    }\n    const events = parsedEvents.events;\n\n    const parsedSequenceRange = this.parseSequenceRange(input, events);\n    if (parsedSequenceRange.kind === 'invalid') {\n      return { kind: 'invalid', batchId, reason: parsedSequenceRange.reason };\n    }\n    const { sequenceStart, sequenceEnd } = parsedSequenceRange;\n    const hasTraceSequenceMismatch = events.some((event, index) => {\n      const previous = events[index - 1];\n      return previous !== undefined && event.traceSeq <= previous.traceSeq;\n    });\n    if (hasTraceSequenceMismatch) {\n      return { kind: 'invalid', batchId, reason: 'Trace event sequences are not strictly increasing' };\n    }\n    const expectedBatchId = `wtb1:${producerId}:${sequenceStart}-${sequenceEnd}`;\n    if (input.batchId !== expectedBatchId) {\n      return { kind: 'invalid', batchId, reason: 'Trace batch identity does not match its sequence range' };\n    }\n\n    return {\n      kind: 'valid',\n      batch: this.create(producerId, sequenceStart, events),\n    };\n  }\n\n  parseAcknowledgement(input: unknown): WoodTraceAcknowledgementParseResult {\n    if (!this.isRecord(input) || typeof input.kind !== 'string' || typeof input.batchId !== 'string') {\n      return { ok: false, reason: 'Trace batch acknowledgement framing is invalid' };\n    }\n\n    if (input.kind === 'committed') {\n      return this.parseCommittedAcknowledgement(input);\n    }\n    if (input.kind === 'retryable') {\n      return this.parseRetryableAcknowledgement(input);\n    }\n    if (input.kind === 'rejected' && typeof input.reason === 'string') {\n      return {\n        ok: true,\n        acknowledgement: Object.freeze({\n          kind: 'rejected',\n          batchId: input.batchId,\n          reason: input.reason,\n        }),\n      };\n    }\n    return { ok: false, reason: 'Trace batch acknowledgement kind is invalid' };\n  }\n\n  private parseCommittedAcknowledgement(\n    input: Record<string, unknown>,\n  ): WoodTraceAcknowledgementParseResult {\n    const batchId = input.batchId;\n    const committedAtMs = input.committedAtMs;\n    const acceptedEvents = input.acceptedEvents;\n    const validNumbers = typeof batchId === 'string'\n      && typeof committedAtMs === 'number'\n      && Number.isFinite(committedAtMs)\n      && typeof acceptedEvents === 'number'\n      && Number.isSafeInteger(acceptedEvents)\n      && acceptedEvents >= 0;\n    if (!validNumbers) {\n      return { ok: false, reason: 'Committed trace acknowledgement is invalid' };\n    }\n    return {\n      ok: true,\n      acknowledgement: Object.freeze({\n        kind: 'committed',\n        batchId,\n        committedAtMs,\n        acceptedEvents,\n      }),\n    };\n  }\n\n  private parseRetryableAcknowledgement(\n    input: Record<string, unknown>,\n  ): WoodTraceAcknowledgementParseResult {\n    const batchId = input.batchId;\n    const retryAfterMs = input.retryAfterMs;\n    if (typeof batchId !== 'string'\n      || typeof input.reason !== 'string'\n      || typeof retryAfterMs !== 'number'\n      || !Number.isFinite(retryAfterMs)\n      || retryAfterMs < 0) {\n      return { ok: false, reason: 'Retryable trace acknowledgement is invalid' };\n    }\n    return {\n      ok: true,\n      acknowledgement: Object.freeze({\n        kind: 'retryable',\n        batchId,\n        reason: input.reason,\n        retryAfterMs,\n      }),\n    };\n  }\n\n  private parseEvent(input: unknown): WoodTraceEventParseResult {\n    if (!this.isRecord(input)) {\n      return { kind: 'invalid', reason: 'Trace event is not an object' };\n    }\n    const hasValidIdentity = this.hasValidEventIdentity(input);\n    const hasValidTiming = this.hasValidEventTiming(input);\n    if (!hasValidIdentity || !hasValidTiming) {\n      return { kind: 'invalid', reason: 'Trace event identity or timing is invalid' };\n    }\n    if (input.payload !== undefined && !this.isRecord(input.payload)) {\n      return { kind: 'invalid', reason: 'Trace event payload is invalid' };\n    }\n    return {\n      kind: 'valid',\n      event: this.snapshotEvent({\n        source: input.source,\n        type: input.type,\n        level: input.level,\n        process: 'renderer',\n        timestamp: input.timestamp,\n        traceSeq: input.traceSeq,\n        ...(typeof input.message === 'string' ? { message: input.message } : {}),\n        ...(this.isConversationId(input.conversationId) ? { conversationId: input.conversationId } : {}),\n        ...(input.payload ? { payload: input.payload } : {}),\n        ...(typeof input.windowId === 'string' ? { windowId: input.windowId } : {}),\n        ...(typeof input.webContentsId === 'number' && Number.isFinite(input.webContentsId)\n          ? { webContentsId: input.webContentsId }\n          : {}),\n        ...(typeof input.routeKey === 'string' ? { routeKey: input.routeKey } : {}),\n        ...(typeof input.harnessId === 'string' ? { harnessId: input.harnessId } : {}),\n      }),\n    };\n  }\n\n  private hasValidEventIdentity(input: Record<string, unknown>): input is Record<string, unknown> & {\n    source: string;\n    type: string;\n    level: string;\n    process: 'renderer';\n  } {\n    return typeof input.source === 'string'\n      && input.source.trim().length > 0\n      && typeof input.type === 'string'\n      && input.type.trim().length > 0\n      && typeof input.level === 'string'\n      && input.level.trim().length > 0\n      && input.process === 'renderer';\n  }\n\n  private hasValidEventTiming(input: Record<string, unknown>): input is Record<string, unknown> & {\n    timestamp: string;\n    traceSeq: number;\n  } {\n    return typeof input.timestamp === 'string'\n      && Number.isFinite(Date.parse(input.timestamp))\n      && typeof input.traceSeq === 'number'\n      && Number.isSafeInteger(input.traceSeq)\n      && input.traceSeq >= 1;\n  }\n\n  private parseEvents(input: unknown): WoodTraceEventsParseResult {\n    if (!Array.isArray(input) || input.length === 0 || input.length > MAX_BATCH_EVENTS) {\n      return { kind: 'invalid', reason: 'Trace batch events are invalid' };\n    }\n    const events: WoodRendererTraceEvent[] = [];\n    for (const rawEvent of input) {\n      const parsedEvent = this.parseEvent(rawEvent);\n      if (parsedEvent.kind === 'invalid') {\n        return parsedEvent;\n      }\n      events.push(parsedEvent.event);\n    }\n    return { kind: 'valid', events: Object.freeze(events) };\n  }\n\n  private parseSequenceRange(\n    input: Record<string, unknown>,\n    events: readonly WoodRendererTraceEvent[],\n  ): { kind: 'invalid'; reason: string } | { kind: 'valid'; sequenceStart: number; sequenceEnd: number } {\n    const sequenceStart = input.sequenceStart;\n    const sequenceEnd = input.sequenceEnd;\n    if (typeof sequenceStart !== 'number' || typeof sequenceEnd !== 'number') {\n      return { kind: 'invalid', reason: 'Trace batch sequence range is invalid' };\n    }\n    const firstEvent = events[0];\n    const lastEvent = events[events.length - 1];\n    const hasInvalidRange = !Number.isSafeInteger(sequenceStart)\n      || sequenceStart < 0\n      || !Number.isSafeInteger(sequenceEnd)\n      || !firstEvent\n      || !lastEvent\n      || firstEvent.traceSeq !== sequenceStart + 1\n      || lastEvent.traceSeq !== sequenceEnd + 1;\n    if (hasInvalidRange) {\n      return { kind: 'invalid', reason: 'Trace batch sequence range does not match its events' };\n    }\n    return { kind: 'valid', sequenceStart, sequenceEnd };\n  }\n\n  private snapshotEvent(event: WoodRendererTraceEvent): WoodRendererTraceEvent {\n    return Object.freeze({\n      ...event,\n      ...(event.payload ? { payload: Object.freeze({ ...event.payload }) } : {}),\n    });\n  }\n\n  private validateIdentity(input: Record<string, unknown>): WoodTraceIdentityValidationResult {\n    if (input.protocolVersion !== 1) {\n      return { kind: 'invalid', reason: 'Trace batch protocol version is unsupported' };\n    }\n    if (typeof input.producerId !== 'string' || input.producerId.trim().length === 0) {\n      return { kind: 'invalid', reason: 'Trace batch producer identity is invalid' };\n    }\n    if (typeof input.batchId !== 'string' || input.batchId.trim().length === 0) {\n      return { kind: 'invalid', reason: 'Trace batch identity is invalid' };\n    }\n    return { kind: 'valid' };\n  }\n\n  private isConversationId(value: unknown): value is string | number {\n    return typeof value === 'string' || (typeof value === 'number' && Number.isFinite(value));\n  }\n\n  private isRecord(value: unknown): value is Record<string, unknown> {\n    return typeof value === 'object' && value !== null && !Array.isArray(value);\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/tracing/wood_trace_batch_contract.ts"],"sourcesContent":["import type {\n  WoodRendererTraceEvent,\n  WoodTraceAcknowledgementParseResult,\n  WoodTraceBatch,\n  WoodTraceBatchAcknowledgement,\n  WoodTraceBatchParseResult,\n  WoodTraceEventParseResult,\n  WoodTraceEventsParseResult,\n  WoodTraceIdentityValidationResult,\n} from './types/wood_trace_batch.types.js';\n\nconst MAX_BATCH_EVENTS = 256;\n\nexport class WoodTraceBatchContract {\n  create(\n    producerId: string,\n    sequenceStart: number,\n    events: readonly WoodRendererTraceEvent[],\n  ): WoodTraceBatch {\n    const snapshots = events.map((event) => this.snapshotEvent(event));\n    const last = snapshots[snapshots.length - 1];\n    const sequenceEnd = last ? last.traceSeq - 1 : sequenceStart - 1;\n    return Object.freeze({\n      kind: 'wood.trace.batch',\n      protocolVersion: 1,\n      producerId,\n      batchId: `wtb1:${producerId}:${sequenceStart}-${sequenceEnd}`,\n      sequenceStart,\n      sequenceEnd,\n      events: Object.freeze(snapshots),\n    });\n  }\n\n  parse(input: unknown): WoodTraceBatchParseResult {\n    if (!this.isRecord(input) || input.kind !== 'wood.trace.batch') {\n      return { kind: 'not-batch' };\n    }\n\n    const batchId = typeof input.batchId === 'string' ? input.batchId : null;\n    const identity = this.validateIdentity(input);\n    if (identity.kind === 'invalid') {\n      return { kind: 'invalid', batchId, reason: identity.reason };\n    }\n    const producerId = input.producerId;\n    if (typeof producerId !== 'string') {\n      return { kind: 'invalid', batchId, reason: 'Trace batch producer identity is invalid' };\n    }\n\n    const parsedEvents = this.parseEvents(input.events);\n    if (parsedEvents.kind === 'invalid') {\n      return { kind: 'invalid', batchId, reason: parsedEvents.reason };\n    }\n    const events = parsedEvents.events;\n\n    const parsedSequenceRange = this.parseSequenceRange(input, events);\n    if (parsedSequenceRange.kind === 'invalid') {\n      return { kind: 'invalid', batchId, reason: parsedSequenceRange.reason };\n    }\n    const { sequenceStart, sequenceEnd } = parsedSequenceRange;\n    const hasTraceSequenceMismatch = events.some((event, index) => {\n      const previous = events[index - 1];\n      return previous !== undefined && event.traceSeq <= previous.traceSeq;\n    });\n    if (hasTraceSequenceMismatch) {\n      return { kind: 'invalid', batchId, reason: 'Trace event sequences are not strictly increasing' };\n    }\n    const expectedBatchId = `wtb1:${producerId}:${sequenceStart}-${sequenceEnd}`;\n    if (input.batchId !== expectedBatchId) {\n      return { kind: 'invalid', batchId, reason: 'Trace batch identity does not match its sequence range' };\n    }\n\n    return {\n      kind: 'valid',\n      batch: this.create(producerId, sequenceStart, events),\n    };\n  }\n\n  parseAcknowledgement(input: unknown): WoodTraceAcknowledgementParseResult {\n    if (!this.isRecord(input) || typeof input.kind !== 'string' || typeof input.batchId !== 'string') {\n      return { ok: false, reason: 'Trace batch acknowledgement framing is invalid' };\n    }\n\n    if (input.kind === 'committed') {\n      return this.parseCommittedAcknowledgement(input);\n    }\n    if (input.kind === 'retryable') {\n      return this.parseRetryableAcknowledgement(input);\n    }\n    if (input.kind === 'rejected' && typeof input.reason === 'string') {\n      return {\n        ok: true,\n        acknowledgement: Object.freeze({\n          kind: 'rejected',\n          batchId: input.batchId,\n          reason: input.reason,\n        }),\n      };\n    }\n    return { ok: false, reason: 'Trace batch acknowledgement kind is invalid' };\n  }\n\n  private parseCommittedAcknowledgement(\n    input: Record<string, unknown>,\n  ): WoodTraceAcknowledgementParseResult {\n    const batchId = input.batchId;\n    const committedAtMs = input.committedAtMs;\n    const acceptedEvents = input.acceptedEvents;\n    const validNumbers = typeof batchId === 'string'\n      && typeof committedAtMs === 'number'\n      && Number.isFinite(committedAtMs)\n      && typeof acceptedEvents === 'number'\n      && Number.isSafeInteger(acceptedEvents)\n      && acceptedEvents >= 0;\n    if (!validNumbers) {\n      return { ok: false, reason: 'Committed trace acknowledgement is invalid' };\n    }\n    return {\n      ok: true,\n      acknowledgement: Object.freeze({\n        kind: 'committed',\n        batchId,\n        committedAtMs,\n        acceptedEvents,\n      }),\n    };\n  }\n\n  private parseRetryableAcknowledgement(\n    input: Record<string, unknown>,\n  ): WoodTraceAcknowledgementParseResult {\n    const batchId = input.batchId;\n    const retryAfterMs = input.retryAfterMs;\n    if (typeof batchId !== 'string'\n      || typeof input.reason !== 'string'\n      || typeof retryAfterMs !== 'number'\n      || !Number.isFinite(retryAfterMs)\n      || retryAfterMs < 0) {\n      return { ok: false, reason: 'Retryable trace acknowledgement is invalid' };\n    }\n    return {\n      ok: true,\n      acknowledgement: Object.freeze({\n        kind: 'retryable',\n        batchId,\n        reason: input.reason,\n        retryAfterMs,\n      }),\n    };\n  }\n\n  private parseEvent(input: unknown): WoodTraceEventParseResult {\n    if (!this.isRecord(input)) {\n      return { kind: 'invalid', reason: 'Trace event is not an object' };\n    }\n    const hasValidIdentity = this.hasValidEventIdentity(input);\n    const hasValidTiming = this.hasValidEventTiming(input);\n    if (!hasValidIdentity || !hasValidTiming) {\n      return { kind: 'invalid', reason: 'Trace event identity or timing is invalid' };\n    }\n    if (input.payload !== undefined && !this.isRecord(input.payload)) {\n      return { kind: 'invalid', reason: 'Trace event payload is invalid' };\n    }\n    return {\n      kind: 'valid',\n      event: this.snapshotEvent({\n        source: input.source,\n        type: input.type,\n        level: input.level,\n        process: 'renderer',\n        timestamp: input.timestamp,\n        traceSeq: input.traceSeq,\n        // Durable identity passthrough: never a validation failure when absent.\n        ...(typeof input.producerId === 'string' && input.producerId.trim().length > 0\n          ? { producerId: input.producerId }\n          : {}),\n        ...(typeof input.message === 'string' ? { message: input.message } : {}),\n        ...(this.isConversationId(input.conversationId) ? { conversationId: input.conversationId } : {}),\n        ...(input.payload ? { payload: input.payload } : {}),\n        ...(typeof input.windowId === 'string' ? { windowId: input.windowId } : {}),\n        ...(typeof input.webContentsId === 'number' && Number.isFinite(input.webContentsId)\n          ? { webContentsId: input.webContentsId }\n          : {}),\n        ...(typeof input.routeKey === 'string' ? { routeKey: input.routeKey } : {}),\n        ...(typeof input.harnessId === 'string' ? { harnessId: input.harnessId } : {}),\n      }),\n    };\n  }\n\n  private hasValidEventIdentity(input: Record<string, unknown>): input is Record<string, unknown> & {\n    source: string;\n    type: string;\n    level: string;\n    process: 'renderer';\n  } {\n    return typeof input.source === 'string'\n      && input.source.trim().length > 0\n      && typeof input.type === 'string'\n      && input.type.trim().length > 0\n      && typeof input.level === 'string'\n      && input.level.trim().length > 0\n      && input.process === 'renderer';\n  }\n\n  private hasValidEventTiming(input: Record<string, unknown>): input is Record<string, unknown> & {\n    timestamp: string;\n    traceSeq: number;\n  } {\n    return typeof input.timestamp === 'string'\n      && Number.isFinite(Date.parse(input.timestamp))\n      && typeof input.traceSeq === 'number'\n      && Number.isSafeInteger(input.traceSeq)\n      && input.traceSeq >= 1;\n  }\n\n  private parseEvents(input: unknown): WoodTraceEventsParseResult {\n    if (!Array.isArray(input) || input.length === 0 || input.length > MAX_BATCH_EVENTS) {\n      return { kind: 'invalid', reason: 'Trace batch events are invalid' };\n    }\n    const events: WoodRendererTraceEvent[] = [];\n    for (const rawEvent of input) {\n      const parsedEvent = this.parseEvent(rawEvent);\n      if (parsedEvent.kind === 'invalid') {\n        return parsedEvent;\n      }\n      events.push(parsedEvent.event);\n    }\n    return { kind: 'valid', events: Object.freeze(events) };\n  }\n\n  private parseSequenceRange(\n    input: Record<string, unknown>,\n    events: readonly WoodRendererTraceEvent[],\n  ): { kind: 'invalid'; reason: string } | { kind: 'valid'; sequenceStart: number; sequenceEnd: number } {\n    const sequenceStart = input.sequenceStart;\n    const sequenceEnd = input.sequenceEnd;\n    if (typeof sequenceStart !== 'number' || typeof sequenceEnd !== 'number') {\n      return { kind: 'invalid', reason: 'Trace batch sequence range is invalid' };\n    }\n    const firstEvent = events[0];\n    const lastEvent = events[events.length - 1];\n    const hasInvalidRange = !Number.isSafeInteger(sequenceStart)\n      || sequenceStart < 0\n      || !Number.isSafeInteger(sequenceEnd)\n      || !firstEvent\n      || !lastEvent\n      || firstEvent.traceSeq !== sequenceStart + 1\n      || lastEvent.traceSeq !== sequenceEnd + 1;\n    if (hasInvalidRange) {\n      return { kind: 'invalid', reason: 'Trace batch sequence range does not match its events' };\n    }\n    return { kind: 'valid', sequenceStart, sequenceEnd };\n  }\n\n  private snapshotEvent(event: WoodRendererTraceEvent): WoodRendererTraceEvent {\n    return Object.freeze({\n      ...event,\n      ...(event.payload ? { payload: Object.freeze({ ...event.payload }) } : {}),\n    });\n  }\n\n  private validateIdentity(input: Record<string, unknown>): WoodTraceIdentityValidationResult {\n    if (input.protocolVersion !== 1) {\n      return { kind: 'invalid', reason: 'Trace batch protocol version is unsupported' };\n    }\n    if (typeof input.producerId !== 'string' || input.producerId.trim().length === 0) {\n      return { kind: 'invalid', reason: 'Trace batch producer identity is invalid' };\n    }\n    if (typeof input.batchId !== 'string' || input.batchId.trim().length === 0) {\n      return { kind: 'invalid', reason: 'Trace batch identity is invalid' };\n    }\n    return { kind: 'valid' };\n  }\n\n  private isConversationId(value: unknown): value is string | number {\n    return typeof value === 'string' || (typeof value === 'number' && Number.isFinite(value));\n  }\n\n  private isRecord(value: unknown): value is Record<string, unknown> {\n    return typeof value === 'object' && value !== null && !Array.isArray(value);\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/transport/build_transport_bridge.cjs

@@ -18,7 +18,8 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var build_transport_bridge_exports = {};
 __export(build_transport_bridge_exports, {
-  buildTransportBridge: () => buildTransportBridge
+  buildTransportBridge: () => buildTransportBridge,
+  operationHasInput: () => operationHasInput
 });
 module.exports = __toCommonJS(build_transport_bridge_exports);
 function operationHasInput(op) {
@@ -57,6 +58,7 @@ function buildTransportBridge(operations, transport) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  buildTransportBridge
+  buildTransportBridge,
+  operationHasInput
 });
 //# sourceMappingURL=build_transport_bridge.cjs.map

package/dist/transport/build_transport_bridge.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/transport/build_transport_bridge.ts"],"sourcesContent":["import type { OperationDef } from '../types/index.cjs';\nimport type { WoodRpcManifestEntry } from '../client/index.js';\nimport type { WoodRpcTransport } from './wood_rpc_transport.js';\n\n/**\n * Build a `WoodBridge`-shaped object (the global `__NOEGO_WOOD_BRIDGE__` shape)\n * backed by a `WoodRpcTransport` instead of Electron's `ipcRenderer`.\n *\n * Every operation channel (e.g. `chat.messages.send`) becomes a nested method\n * on the returned bridge that calls `transport.invoke(channel, data)`. `on()`\n * is backed by `transport.subscribe`, and `__rpcManifest` is derived from the\n * same operations map used by codegen — so the existing `getApp()` renderer\n * client can be pointed at this bridge with zero changes.\n *\n * The production Electron preload path is untouched: it still exposes its own\n * `ipcRenderer`-backed bridge. This function is the test-mode equivalent that\n * any `WoodRpcTransport` (in-process or loopback) plugs into.\n */\nexport interface TransportBridgeResult {\n  bridge: Record<string, any>;\n}\n\nfunction operationHasInput(op: OperationDef): boolean {\n  return Boolean(\n    op.inputSchema &&\n      (op.inputSchema as Record<string, unknown>).type === 'object' &&\n      Object.keys(\n        (op.inputSchema as Record<string, Record<string, unknown>>).properties ?? {},\n      ).length > 0,\n  );\n}\n\nfunction buildManifest(operations: Map<string, OperationDef>): WoodRpcManifestEntry[] {\n  return Array.from(operations.values()).map((op) => ({\n    channel: op.channel,\n    controller: op.controller,\n    action: op.action,\n    path: op.channel.split('.'),\n    hasInput: operationHasInput(op),\n  }));\n}\n\n/**\n * Build the nested bridge tree from the operations' dot-path channels.\n * Mirrors the nesting used by the preload generator and router bridge:\n * intermediate segments become namespace objects, leaf segments become\n * transport-backed invoke functions.\n */\nexport function buildTransportBridge(\n  operations: Map<string, OperationDef>,\n  transport: WoodRpcTransport,\n): TransportBridgeResult {\n  const tree: Record<string, any> = {};\n\n  for (const channel of operations.keys()) {\n    const parts = channel.split('.');\n    let current = tree;\n\n    for (let i = 0; i < parts.length - 1; i++) {\n      if (!current[parts[i]]) {\n        current[parts[i]] = {};\n      }\n      current = current[parts[i]];\n    }\n\n    const leaf = parts[parts.length - 1];\n    current[leaf] = (data?: unknown) => transport.invoke(channel, data);\n  }\n\n  tree.on = (channel: string, callback: (...args: unknown[]) => void) =>\n    transport.subscribe(channel, (payload) => callback(payload));\n\n  tree.__rpcManifest = buildManifest(operations);\n\n  return { bridge: tree };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAsBA,SAAS,kBAAkB,IAA2B;AACpD,SAAO;AAAA,IACL,GAAG,eACA,GAAG,YAAwC,SAAS,YACrD,OAAO;AAAA,MACJ,GAAG,YAAwD,cAAc,CAAC;AAAA,IAC7E,EAAE,SAAS;AAAA,EACf;AACF;AAEA,SAAS,cAAc,YAA+D;AACpF,SAAO,MAAM,KAAK,WAAW,OAAO,CAAC,EAAE,IAAI,CAAC,QAAQ;AAAA,IAClD,SAAS,GAAG;AAAA,IACZ,YAAY,GAAG;AAAA,IACf,QAAQ,GAAG;AAAA,IACX,MAAM,GAAG,QAAQ,MAAM,GAAG;AAAA,IAC1B,UAAU,kBAAkB,EAAE;AAAA,EAChC,EAAE;AACJ;AAQO,SAAS,qBACd,YACA,WACuB;AACvB,QAAM,OAA4B,CAAC;AAEnC,aAAW,WAAW,WAAW,KAAK,GAAG;AACvC,UAAM,QAAQ,QAAQ,MAAM,GAAG;AAC/B,QAAI,UAAU;AAEd,aAAS,IAAI,GAAG,IAAI,MAAM,SAAS,GAAG,KAAK;AACzC,UAAI,CAAC,QAAQ,MAAM,CAAC,CAAC,GAAG;AACtB,gBAAQ,MAAM,CAAC,CAAC,IAAI,CAAC;AAAA,MACvB;AACA,gBAAU,QAAQ,MAAM,CAAC,CAAC;AAAA,IAC5B;AAEA,UAAM,OAAO,MAAM,MAAM,SAAS,CAAC;AACnC,YAAQ,IAAI,IAAI,CAAC,SAAmB,UAAU,OAAO,SAAS,IAAI;AAAA,EACpE;AAEA,OAAK,KAAK,CAAC,SAAiB,aAC1B,UAAU,UAAU,SAAS,CAAC,YAAY,SAAS,OAAO,CAAC;AAE7D,OAAK,gBAAgB,cAAc,UAAU;AAE7C,SAAO,EAAE,QAAQ,KAAK;AACxB;","names":[]}
+{"version":3,"sources":["../../src/transport/build_transport_bridge.ts"],"sourcesContent":["import type { OperationDef } from '../types/index.cjs';\nimport type { WoodRpcManifestEntry } from '../client/index.js';\nimport type { WoodRpcTransport } from './wood_rpc_transport.js';\n\n/**\n * Build a `WoodBridge`-shaped object (the global `__NOEGO_WOOD_BRIDGE__` shape)\n * backed by a `WoodRpcTransport` instead of Electron's `ipcRenderer`.\n *\n * Every operation channel (e.g. `chat.messages.send`) becomes a nested method\n * on the returned bridge that calls `transport.invoke(channel, data)`. `on()`\n * is backed by `transport.subscribe`, and `__rpcManifest` is derived from the\n * same operations map used by codegen — so the existing `getApp()` renderer\n * client can be pointed at this bridge with zero changes.\n *\n * The production Electron preload path is untouched: it still exposes its own\n * `ipcRenderer`-backed bridge. This function is the test-mode equivalent that\n * any `WoodRpcTransport` (in-process or loopback) plugs into.\n */\nexport interface TransportBridgeResult {\n  bridge: Record<string, any>;\n}\n\n/**\n * The ONE definition of \"this operation takes an input argument\": a\n * non-empty object schema. The preload generator, transport bridge, and\n * test harnesses must agree, or renderer arity enforcement drifts.\n */\nexport function operationHasInput(op: OperationDef): boolean {\n  return Boolean(\n    op.inputSchema &&\n      (op.inputSchema as Record<string, unknown>).type === 'object' &&\n      Object.keys(\n        (op.inputSchema as Record<string, Record<string, unknown>>).properties ?? {},\n      ).length > 0,\n  );\n}\n\nfunction buildManifest(operations: Map<string, OperationDef>): WoodRpcManifestEntry[] {\n  return Array.from(operations.values()).map((op) => ({\n    channel: op.channel,\n    controller: op.controller,\n    action: op.action,\n    path: op.channel.split('.'),\n    hasInput: operationHasInput(op),\n  }));\n}\n\n/**\n * Build the nested bridge tree from the operations' dot-path channels.\n * Mirrors the nesting used by the preload generator and router bridge:\n * intermediate segments become namespace objects, leaf segments become\n * transport-backed invoke functions.\n */\nexport function buildTransportBridge(\n  operations: Map<string, OperationDef>,\n  transport: WoodRpcTransport,\n): TransportBridgeResult {\n  const tree: Record<string, any> = {};\n\n  for (const channel of operations.keys()) {\n    const parts = channel.split('.');\n    let current = tree;\n\n    for (let i = 0; i < parts.length - 1; i++) {\n      if (!current[parts[i]]) {\n        current[parts[i]] = {};\n      }\n      current = current[parts[i]];\n    }\n\n    const leaf = parts[parts.length - 1];\n    current[leaf] = (data?: unknown) => transport.invoke(channel, data);\n  }\n\n  tree.on = (channel: string, callback: (...args: unknown[]) => void) =>\n    transport.subscribe(channel, (payload) => callback(payload));\n\n  tree.__rpcManifest = buildManifest(operations);\n\n  return { bridge: tree };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA2BO,SAAS,kBAAkB,IAA2B;AAC3D,SAAO;AAAA,IACL,GAAG,eACA,GAAG,YAAwC,SAAS,YACrD,OAAO;AAAA,MACJ,GAAG,YAAwD,cAAc,CAAC;AAAA,IAC7E,EAAE,SAAS;AAAA,EACf;AACF;AAEA,SAAS,cAAc,YAA+D;AACpF,SAAO,MAAM,KAAK,WAAW,OAAO,CAAC,EAAE,IAAI,CAAC,QAAQ;AAAA,IAClD,SAAS,GAAG;AAAA,IACZ,YAAY,GAAG;AAAA,IACf,QAAQ,GAAG;AAAA,IACX,MAAM,GAAG,QAAQ,MAAM,GAAG;AAAA,IAC1B,UAAU,kBAAkB,EAAE;AAAA,EAChC,EAAE;AACJ;AAQO,SAAS,qBACd,YACA,WACuB;AACvB,QAAM,OAA4B,CAAC;AAEnC,aAAW,WAAW,WAAW,KAAK,GAAG;AACvC,UAAM,QAAQ,QAAQ,MAAM,GAAG;AAC/B,QAAI,UAAU;AAEd,aAAS,IAAI,GAAG,IAAI,MAAM,SAAS,GAAG,KAAK;AACzC,UAAI,CAAC,QAAQ,MAAM,CAAC,CAAC,GAAG;AACtB,gBAAQ,MAAM,CAAC,CAAC,IAAI,CAAC;AAAA,MACvB;AACA,gBAAU,QAAQ,MAAM,CAAC,CAAC;AAAA,IAC5B;AAEA,UAAM,OAAO,MAAM,MAAM,SAAS,CAAC;AACnC,YAAQ,IAAI,IAAI,CAAC,SAAmB,UAAU,OAAO,SAAS,IAAI;AAAA,EACpE;AAEA,OAAK,KAAK,CAAC,SAAiB,aAC1B,UAAU,UAAU,SAAS,CAAC,YAAY,SAAS,OAAO,CAAC;AAE7D,OAAK,gBAAgB,cAAc,UAAU;AAE7C,SAAO,EAAE,QAAQ,KAAK;AACxB;","names":[]}

package/dist/transport/build_transport_bridge.d.cts

@@ -18,6 +18,12 @@ import { WoodRpcTransport } from './wood_rpc_transport.cjs';
 interface TransportBridgeResult {
     bridge: Record<string, any>;
 }
+/**
+ * The ONE definition of "this operation takes an input argument": a
+ * non-empty object schema. The preload generator, transport bridge, and
+ * test harnesses must agree, or renderer arity enforcement drifts.
+ */
+declare function operationHasInput(op: OperationDef): boolean;
 /**
  * Build the nested bridge tree from the operations' dot-path channels.
  * Mirrors the nesting used by the preload generator and router bridge:
@@ -26,4 +32,4 @@ interface TransportBridgeResult {
  */
 declare function buildTransportBridge(operations: Map<string, OperationDef>, transport: WoodRpcTransport): TransportBridgeResult;
 
-export { type TransportBridgeResult, buildTransportBridge };
+export { type TransportBridgeResult, buildTransportBridge, operationHasInput };

package/dist/transport/build_transport_bridge.d.ts

@@ -18,6 +18,12 @@ import { WoodRpcTransport } from './wood_rpc_transport.js';
 interface TransportBridgeResult {
     bridge: Record<string, any>;
 }
+/**
+ * The ONE definition of "this operation takes an input argument": a
+ * non-empty object schema. The preload generator, transport bridge, and
+ * test harnesses must agree, or renderer arity enforcement drifts.
+ */
+declare function operationHasInput(op: OperationDef): boolean;
 /**
  * Build the nested bridge tree from the operations' dot-path channels.
  * Mirrors the nesting used by the preload generator and router bridge:
@@ -26,4 +32,4 @@ interface TransportBridgeResult {
  */
 declare function buildTransportBridge(operations: Map<string, OperationDef>, transport: WoodRpcTransport): TransportBridgeResult;
 
-export { type TransportBridgeResult, buildTransportBridge };
+export { type TransportBridgeResult, buildTransportBridge, operationHasInput };

package/dist/transport/build_transport_bridge.js

@@ -33,6 +33,7 @@ function buildTransportBridge(operations, transport) {
   return { bridge: tree };
 }
 export {
-  buildTransportBridge
+  buildTransportBridge,
+  operationHasInput
 };
 //# sourceMappingURL=build_transport_bridge.js.map

package/dist/transport/build_transport_bridge.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/transport/build_transport_bridge.ts"],"sourcesContent":["import type { OperationDef } from '../types/index.js';\nimport type { WoodRpcManifestEntry } from '../client/index.js';\nimport type { WoodRpcTransport } from './wood_rpc_transport.js';\n\n/**\n * Build a `WoodBridge`-shaped object (the global `__NOEGO_WOOD_BRIDGE__` shape)\n * backed by a `WoodRpcTransport` instead of Electron's `ipcRenderer`.\n *\n * Every operation channel (e.g. `chat.messages.send`) becomes a nested method\n * on the returned bridge that calls `transport.invoke(channel, data)`. `on()`\n * is backed by `transport.subscribe`, and `__rpcManifest` is derived from the\n * same operations map used by codegen — so the existing `getApp()` renderer\n * client can be pointed at this bridge with zero changes.\n *\n * The production Electron preload path is untouched: it still exposes its own\n * `ipcRenderer`-backed bridge. This function is the test-mode equivalent that\n * any `WoodRpcTransport` (in-process or loopback) plugs into.\n */\nexport interface TransportBridgeResult {\n  bridge: Record<string, any>;\n}\n\nfunction operationHasInput(op: OperationDef): boolean {\n  return Boolean(\n    op.inputSchema &&\n      (op.inputSchema as Record<string, unknown>).type === 'object' &&\n      Object.keys(\n        (op.inputSchema as Record<string, Record<string, unknown>>).properties ?? {},\n      ).length > 0,\n  );\n}\n\nfunction buildManifest(operations: Map<string, OperationDef>): WoodRpcManifestEntry[] {\n  return Array.from(operations.values()).map((op) => ({\n    channel: op.channel,\n    controller: op.controller,\n    action: op.action,\n    path: op.channel.split('.'),\n    hasInput: operationHasInput(op),\n  }));\n}\n\n/**\n * Build the nested bridge tree from the operations' dot-path channels.\n * Mirrors the nesting used by the preload generator and router bridge:\n * intermediate segments become namespace objects, leaf segments become\n * transport-backed invoke functions.\n */\nexport function buildTransportBridge(\n  operations: Map<string, OperationDef>,\n  transport: WoodRpcTransport,\n): TransportBridgeResult {\n  const tree: Record<string, any> = {};\n\n  for (const channel of operations.keys()) {\n    const parts = channel.split('.');\n    let current = tree;\n\n    for (let i = 0; i < parts.length - 1; i++) {\n      if (!current[parts[i]]) {\n        current[parts[i]] = {};\n      }\n      current = current[parts[i]];\n    }\n\n    const leaf = parts[parts.length - 1];\n    current[leaf] = (data?: unknown) => transport.invoke(channel, data);\n  }\n\n  tree.on = (channel: string, callback: (...args: unknown[]) => void) =>\n    transport.subscribe(channel, (payload) => callback(payload));\n\n  tree.__rpcManifest = buildManifest(operations);\n\n  return { bridge: tree };\n}\n"],"mappings":"AAsBA,SAAS,kBAAkB,IAA2B;AACpD,SAAO;AAAA,IACL,GAAG,eACA,GAAG,YAAwC,SAAS,YACrD,OAAO;AAAA,MACJ,GAAG,YAAwD,cAAc,CAAC;AAAA,IAC7E,EAAE,SAAS;AAAA,EACf;AACF;AAEA,SAAS,cAAc,YAA+D;AACpF,SAAO,MAAM,KAAK,WAAW,OAAO,CAAC,EAAE,IAAI,CAAC,QAAQ;AAAA,IAClD,SAAS,GAAG;AAAA,IACZ,YAAY,GAAG;AAAA,IACf,QAAQ,GAAG;AAAA,IACX,MAAM,GAAG,QAAQ,MAAM,GAAG;AAAA,IAC1B,UAAU,kBAAkB,EAAE;AAAA,EAChC,EAAE;AACJ;AAQO,SAAS,qBACd,YACA,WACuB;AACvB,QAAM,OAA4B,CAAC;AAEnC,aAAW,WAAW,WAAW,KAAK,GAAG;AACvC,UAAM,QAAQ,QAAQ,MAAM,GAAG;AAC/B,QAAI,UAAU;AAEd,aAAS,IAAI,GAAG,IAAI,MAAM,SAAS,GAAG,KAAK;AACzC,UAAI,CAAC,QAAQ,MAAM,CAAC,CAAC,GAAG;AACtB,gBAAQ,MAAM,CAAC,CAAC,IAAI,CAAC;AAAA,MACvB;AACA,gBAAU,QAAQ,MAAM,CAAC,CAAC;AAAA,IAC5B;AAEA,UAAM,OAAO,MAAM,MAAM,SAAS,CAAC;AACnC,YAAQ,IAAI,IAAI,CAAC,SAAmB,UAAU,OAAO,SAAS,IAAI;AAAA,EACpE;AAEA,OAAK,KAAK,CAAC,SAAiB,aAC1B,UAAU,UAAU,SAAS,CAAC,YAAY,SAAS,OAAO,CAAC;AAE7D,OAAK,gBAAgB,cAAc,UAAU;AAE7C,SAAO,EAAE,QAAQ,KAAK;AACxB;","names":[]}
+{"version":3,"sources":["../../src/transport/build_transport_bridge.ts"],"sourcesContent":["import type { OperationDef } from '../types/index.js';\nimport type { WoodRpcManifestEntry } from '../client/index.js';\nimport type { WoodRpcTransport } from './wood_rpc_transport.js';\n\n/**\n * Build a `WoodBridge`-shaped object (the global `__NOEGO_WOOD_BRIDGE__` shape)\n * backed by a `WoodRpcTransport` instead of Electron's `ipcRenderer`.\n *\n * Every operation channel (e.g. `chat.messages.send`) becomes a nested method\n * on the returned bridge that calls `transport.invoke(channel, data)`. `on()`\n * is backed by `transport.subscribe`, and `__rpcManifest` is derived from the\n * same operations map used by codegen — so the existing `getApp()` renderer\n * client can be pointed at this bridge with zero changes.\n *\n * The production Electron preload path is untouched: it still exposes its own\n * `ipcRenderer`-backed bridge. This function is the test-mode equivalent that\n * any `WoodRpcTransport` (in-process or loopback) plugs into.\n */\nexport interface TransportBridgeResult {\n  bridge: Record<string, any>;\n}\n\n/**\n * The ONE definition of \"this operation takes an input argument\": a\n * non-empty object schema. The preload generator, transport bridge, and\n * test harnesses must agree, or renderer arity enforcement drifts.\n */\nexport function operationHasInput(op: OperationDef): boolean {\n  return Boolean(\n    op.inputSchema &&\n      (op.inputSchema as Record<string, unknown>).type === 'object' &&\n      Object.keys(\n        (op.inputSchema as Record<string, Record<string, unknown>>).properties ?? {},\n      ).length > 0,\n  );\n}\n\nfunction buildManifest(operations: Map<string, OperationDef>): WoodRpcManifestEntry[] {\n  return Array.from(operations.values()).map((op) => ({\n    channel: op.channel,\n    controller: op.controller,\n    action: op.action,\n    path: op.channel.split('.'),\n    hasInput: operationHasInput(op),\n  }));\n}\n\n/**\n * Build the nested bridge tree from the operations' dot-path channels.\n * Mirrors the nesting used by the preload generator and router bridge:\n * intermediate segments become namespace objects, leaf segments become\n * transport-backed invoke functions.\n */\nexport function buildTransportBridge(\n  operations: Map<string, OperationDef>,\n  transport: WoodRpcTransport,\n): TransportBridgeResult {\n  const tree: Record<string, any> = {};\n\n  for (const channel of operations.keys()) {\n    const parts = channel.split('.');\n    let current = tree;\n\n    for (let i = 0; i < parts.length - 1; i++) {\n      if (!current[parts[i]]) {\n        current[parts[i]] = {};\n      }\n      current = current[parts[i]];\n    }\n\n    const leaf = parts[parts.length - 1];\n    current[leaf] = (data?: unknown) => transport.invoke(channel, data);\n  }\n\n  tree.on = (channel: string, callback: (...args: unknown[]) => void) =>\n    transport.subscribe(channel, (payload) => callback(payload));\n\n  tree.__rpcManifest = buildManifest(operations);\n\n  return { bridge: tree };\n}\n"],"mappings":"AA2BO,SAAS,kBAAkB,IAA2B;AAC3D,SAAO;AAAA,IACL,GAAG,eACA,GAAG,YAAwC,SAAS,YACrD,OAAO;AAAA,MACJ,GAAG,YAAwD,cAAc,CAAC;AAAA,IAC7E,EAAE,SAAS;AAAA,EACf;AACF;AAEA,SAAS,cAAc,YAA+D;AACpF,SAAO,MAAM,KAAK,WAAW,OAAO,CAAC,EAAE,IAAI,CAAC,QAAQ;AAAA,IAClD,SAAS,GAAG;AAAA,IACZ,YAAY,GAAG;AAAA,IACf,QAAQ,GAAG;AAAA,IACX,MAAM,GAAG,QAAQ,MAAM,GAAG;AAAA,IAC1B,UAAU,kBAAkB,EAAE;AAAA,EAChC,EAAE;AACJ;AAQO,SAAS,qBACd,YACA,WACuB;AACvB,QAAM,OAA4B,CAAC;AAEnC,aAAW,WAAW,WAAW,KAAK,GAAG;AACvC,UAAM,QAAQ,QAAQ,MAAM,GAAG;AAC/B,QAAI,UAAU;AAEd,aAAS,IAAI,GAAG,IAAI,MAAM,SAAS,GAAG,KAAK;AACzC,UAAI,CAAC,QAAQ,MAAM,CAAC,CAAC,GAAG;AACtB,gBAAQ,MAAM,CAAC,CAAC,IAAI,CAAC;AAAA,MACvB;AACA,gBAAU,QAAQ,MAAM,CAAC,CAAC;AAAA,IAC5B;AAEA,UAAM,OAAO,MAAM,MAAM,SAAS,CAAC;AACnC,YAAQ,IAAI,IAAI,CAAC,SAAmB,UAAU,OAAO,SAAS,IAAI;AAAA,EACpE;AAEA,OAAK,KAAK,CAAC,SAAiB,aAC1B,UAAU,UAAU,SAAS,CAAC,YAAY,SAAS,OAAO,CAAC;AAE7D,OAAK,gBAAgB,cAAc,UAAU;AAE7C,SAAO,EAAE,QAAQ,KAAK;AACxB;","names":[]}

package/dist/transport/in_process_router_transport.d.cts

@@ -2,6 +2,7 @@ import { WoodRouter } from '../router/wood_router.cjs';
 import { RouterBridgeEvents } from '../testing/create_router_bridge.cjs';
 import { WoodRpcTransport } from './wood_rpc_transport.cjs';
 import '../types/operations.cjs';
+import '../types/context.cjs';
 
 /**
  * A `WoodRpcTransport` that dispatches straight through a real `WoodRouter`

package/dist/transport/in_process_router_transport.d.ts

@@ -2,6 +2,7 @@ import { WoodRouter } from '../router/wood_router.js';
 import { RouterBridgeEvents } from '../testing/create_router_bridge.js';
 import { WoodRpcTransport } from './wood_rpc_transport.js';
 import '../types/operations.js';
+import '../types/context.js';
 
 /**
  * A `WoodRpcTransport` that dispatches straight through a real `WoodRouter`

package/dist/transport/index.d.cts

@@ -5,4 +5,5 @@ export { LoopbackSerializationError, assertLoopbackSerializable } from './loopba
 export { TransportBridgeResult, buildTransportBridge } from './build_transport_bridge.cjs';
 import '../router/wood_router.cjs';
 import '../types/operations.cjs';
+import '../types/context.cjs';
 import '../testing/create_router_bridge.cjs';

package/dist/transport/index.d.ts

@@ -5,4 +5,5 @@ export { LoopbackSerializationError, assertLoopbackSerializable } from './loopba
 export { TransportBridgeResult, buildTransportBridge } from './build_transport_bridge.js';
 import '../router/wood_router.js';
 import '../types/operations.js';
+import '../types/context.js';
 import '../testing/create_router_bridge.js';

package/dist/types/config.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/types/config.ts"],"sourcesContent":["/** Configuration types for wood.config.yml */\n\n/** Top-level Wood configuration parsed from wood.config.yml */\nexport interface WoodConfig {\n  root: string;\n  outDir: string;\n  app: {\n    boot: string;\n    watch: string[];\n  };\n  main: {\n    entry: string;\n    controllers: string;\n    middleware: string;\n    openapi: string;\n    watch: string[];\n  };\n  renderer: {\n    openapi: string;\n    componentDir: string;\n    controllers: string;\n    entry?: string;\n    watch?: string[];\n  };\n  windows: Record<string, WindowDef>;\n  database?: {\n    path: string;\n    migrations?: string;\n  };\n  assets?: string[];\n  dev?: DevConfig;\n  build?: ElectronBuilderConfig;\n}\n\n/** BrowserWindow definition from the `windows` section of wood.config.yml */\nexport interface WindowDef {\n  title: string;\n  width: number;\n  height: number;\n  defaultRoute: string;\n  frame?: boolean;\n  transparent?: boolean;\n  resizable?: boolean;\n  alwaysOnTop?: boolean;\n  minWidth?: number;\n  minHeight?: number;\n  maxWidth?: number;\n  maxHeight?: number;\n  show?: boolean;\n  parent?: string;\n  modal?: boolean;\n  vibrancy?: string;\n  backgroundMaterial?: string;\n  rememberBounds?: boolean;\n  contextMenu?: 'native' | 'custom';\n  acceptFirstMouse?: boolean;\n  nativeQuitFallback?: boolean;\n  titleBarStyle?: 'default' | 'hidden' | 'hiddenInset' | 'customButtonsOnHover';\n  trafficLightPosition?: { x: number; y: number };\n  titleBarOverlay?: boolean | { color?: string; symbolColor?: string; height?: number };\n}\n\n/** Dev-mode settings from the `dev` section of wood.config.yml */\nexport interface DevConfig {\n  port?: number;\n  watch?: boolean;\n  splitServe?: boolean;\n  electronArgs?: string[];\n  inspectPort?: number;\n  backendInspectPort?: number;\n}\n\n/** Electron-builder packaging configuration from the `build` section */\nexport interface ElectronBuilderConfig {\n  appId: string;\n  productName: string;\n  mac?: Record<string, unknown>;\n  win?: Record<string, unknown>;\n  linux?: Record<string, unknown>;\n  [key: string]: unknown;\n}\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}
+{"version":3,"sources":["../../src/types/config.ts"],"sourcesContent":["/** Configuration types for wood.config.yml */\n\n/** Top-level Wood configuration parsed from wood.config.yml */\nexport interface WoodConfig {\n  root: string;\n  outDir: string;\n  app: {\n    boot: string;\n    watch: string[];\n  };\n  main: {\n    entry: string;\n    controllers: string;\n    middleware: string;\n    openapi: string;\n    watch: string[];\n    testing?: MainTestingConfig;\n  };\n  renderer: {\n    openapi: string;\n    componentDir: string;\n    controllers: string;\n    entry?: string;\n    watch?: string[];\n    testing?: RendererTestingConfig;\n  };\n  windows: Record<string, WindowDef>;\n  database?: {\n    path: string;\n    migrations?: string;\n  };\n  assets?: string[];\n  dev?: DevConfig;\n  build?: ElectronBuilderConfig;\n  observability?: ObservabilityConfig;\n}\n\n/**\n * Test-composition hooks for the main process (`main.testing`). Only the\n * application can know how its backend composes on a fresh IoC root; the\n * config names the module so `@noego/wood/testing`'s `testWood(configPath)`\n * finds it without any test-site wiring.\n */\nexport interface MainTestingConfig {\n  /**\n   * Module (config-relative path) whose default export composes the app's\n   * backend on the root the test builder hands it. See `WoodComposeMain`\n   * in `@noego/wood/testing`.\n   */\n  compose?: string;\n}\n\n/** Test-composition hooks for the renderer (`renderer.testing`). */\nexport interface RendererTestingConfig {\n  /**\n   * Module (config-relative path) whose default export mounts a page's real\n   * component for a controller under a DOM driver. See `WoodPageHost` in\n   * `@noego/wood/testing`.\n   */\n  host?: string;\n}\n\n/**\n * Renderer→main IPC trace batching policy. Owned here (wood.config.yml) per\n * the NoEgo observability architecture: the generated preload embeds the\n * resolved values but is not the configuration owner, and changing this policy\n * never changes instrumentation call sites or record semantics.\n */\nexport interface RendererTraceBatchingConfig {\n  maxQueuedEvents: number;\n  maxBatchEvents: number;\n  acknowledgementTimeoutMs: number;\n  retryLimit: number;\n  retryBaseDelayMs: number;\n}\n\nexport interface ObservabilityConfig {\n  trace?: {\n    rendererToMain?: {\n      batching?: RendererTraceBatchingConfig;\n    };\n  };\n}\n\n/** BrowserWindow definition from the `windows` section of wood.config.yml */\nexport interface WindowDef {\n  title: string;\n  width: number;\n  height: number;\n  defaultRoute: string;\n  frame?: boolean;\n  transparent?: boolean;\n  resizable?: boolean;\n  alwaysOnTop?: boolean;\n  minWidth?: number;\n  minHeight?: number;\n  maxWidth?: number;\n  maxHeight?: number;\n  show?: boolean;\n  parent?: string;\n  modal?: boolean;\n  vibrancy?: string;\n  backgroundMaterial?: string;\n  rememberBounds?: boolean;\n  contextMenu?: 'native' | 'custom';\n  acceptFirstMouse?: boolean;\n  nativeQuitFallback?: boolean;\n  titleBarStyle?: 'default' | 'hidden' | 'hiddenInset' | 'customButtonsOnHover';\n  trafficLightPosition?: { x: number; y: number };\n  titleBarOverlay?: boolean | { color?: string; symbolColor?: string; height?: number };\n}\n\n/** Dev-mode settings from the `dev` section of wood.config.yml */\nexport interface DevConfig {\n  port?: number;\n  watch?: boolean;\n  splitServe?: boolean;\n  electronArgs?: string[];\n  inspectPort?: number;\n  backendInspectPort?: number;\n}\n\n/** Electron-builder packaging configuration from the `build` section */\nexport interface ElectronBuilderConfig {\n  appId: string;\n  productName: string;\n  mac?: Record<string, unknown>;\n  win?: Record<string, unknown>;\n  linux?: Record<string, unknown>;\n  [key: string]: unknown;\n}\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/types/config.d.cts

@@ -13,6 +13,7 @@ interface WoodConfig {
         middleware: string;
         openapi: string;
         watch: string[];
+        testing?: MainTestingConfig;
     };
     renderer: {
         openapi: string;
@@ -20,6 +21,7 @@ interface WoodConfig {
         controllers: string;
         entry?: string;
         watch?: string[];
+        testing?: RendererTestingConfig;
     };
     windows: Record<string, WindowDef>;
     database?: {
@@ -29,6 +31,50 @@ interface WoodConfig {
     assets?: string[];
     dev?: DevConfig;
     build?: ElectronBuilderConfig;
+    observability?: ObservabilityConfig;
+}
+/**
+ * Test-composition hooks for the main process (`main.testing`). Only the
+ * application can know how its backend composes on a fresh IoC root; the
+ * config names the module so `@noego/wood/testing`'s `testWood(configPath)`
+ * finds it without any test-site wiring.
+ */
+interface MainTestingConfig {
+    /**
+     * Module (config-relative path) whose default export composes the app's
+     * backend on the root the test builder hands it. See `WoodComposeMain`
+     * in `@noego/wood/testing`.
+     */
+    compose?: string;
+}
+/** Test-composition hooks for the renderer (`renderer.testing`). */
+interface RendererTestingConfig {
+    /**
+     * Module (config-relative path) whose default export mounts a page's real
+     * component for a controller under a DOM driver. See `WoodPageHost` in
+     * `@noego/wood/testing`.
+     */
+    host?: string;
+}
+/**
+ * Renderer→main IPC trace batching policy. Owned here (wood.config.yml) per
+ * the NoEgo observability architecture: the generated preload embeds the
+ * resolved values but is not the configuration owner, and changing this policy
+ * never changes instrumentation call sites or record semantics.
+ */
+interface RendererTraceBatchingConfig {
+    maxQueuedEvents: number;
+    maxBatchEvents: number;
+    acknowledgementTimeoutMs: number;
+    retryLimit: number;
+    retryBaseDelayMs: number;
+}
+interface ObservabilityConfig {
+    trace?: {
+        rendererToMain?: {
+            batching?: RendererTraceBatchingConfig;
+        };
+    };
 }
 /** BrowserWindow definition from the `windows` section of wood.config.yml */
 interface WindowDef {
@@ -83,4 +129,4 @@ interface ElectronBuilderConfig {
     [key: string]: unknown;
 }
 
-export type { DevConfig, ElectronBuilderConfig, WindowDef, WoodConfig };
+export type { DevConfig, ElectronBuilderConfig, MainTestingConfig, ObservabilityConfig, RendererTestingConfig, RendererTraceBatchingConfig, WindowDef, WoodConfig };

package/dist/types/config.d.ts

@@ -13,6 +13,7 @@ interface WoodConfig {
         middleware: string;
         openapi: string;
         watch: string[];
+        testing?: MainTestingConfig;
     };
     renderer: {
         openapi: string;
@@ -20,6 +21,7 @@ interface WoodConfig {
         controllers: string;
         entry?: string;
         watch?: string[];
+        testing?: RendererTestingConfig;
     };
     windows: Record<string, WindowDef>;
     database?: {
@@ -29,6 +31,50 @@ interface WoodConfig {
     assets?: string[];
     dev?: DevConfig;
     build?: ElectronBuilderConfig;
+    observability?: ObservabilityConfig;
+}
+/**
+ * Test-composition hooks for the main process (`main.testing`). Only the
+ * application can know how its backend composes on a fresh IoC root; the
+ * config names the module so `@noego/wood/testing`'s `testWood(configPath)`
+ * finds it without any test-site wiring.
+ */
+interface MainTestingConfig {
+    /**
+     * Module (config-relative path) whose default export composes the app's
+     * backend on the root the test builder hands it. See `WoodComposeMain`
+     * in `@noego/wood/testing`.
+     */
+    compose?: string;
+}
+/** Test-composition hooks for the renderer (`renderer.testing`). */
+interface RendererTestingConfig {
+    /**
+     * Module (config-relative path) whose default export mounts a page's real
+     * component for a controller under a DOM driver. See `WoodPageHost` in
+     * `@noego/wood/testing`.
+     */
+    host?: string;
+}
+/**
+ * Renderer→main IPC trace batching policy. Owned here (wood.config.yml) per
+ * the NoEgo observability architecture: the generated preload embeds the
+ * resolved values but is not the configuration owner, and changing this policy
+ * never changes instrumentation call sites or record semantics.
+ */
+interface RendererTraceBatchingConfig {
+    maxQueuedEvents: number;
+    maxBatchEvents: number;
+    acknowledgementTimeoutMs: number;
+    retryLimit: number;
+    retryBaseDelayMs: number;
+}
+interface ObservabilityConfig {
+    trace?: {
+        rendererToMain?: {
+            batching?: RendererTraceBatchingConfig;
+        };
+    };
 }
 /** BrowserWindow definition from the `windows` section of wood.config.yml */
 interface WindowDef {
@@ -83,4 +129,4 @@ interface ElectronBuilderConfig {
     [key: string]: unknown;
 }
 
-export type { DevConfig, ElectronBuilderConfig, WindowDef, WoodConfig };
+export type { DevConfig, ElectronBuilderConfig, MainTestingConfig, ObservabilityConfig, RendererTestingConfig, RendererTraceBatchingConfig, WindowDef, WoodConfig };

package/dist/types/context.cjs

@@ -3,6 +3,10 @@ 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))
@@ -13,5 +17,13 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var context_exports = {};
+__export(context_exports, {
+  WOOD_CONTEXT_OPERATION: () => WOOD_CONTEXT_OPERATION
+});
 module.exports = __toCommonJS(context_exports);
+const WOOD_CONTEXT_OPERATION = "operation";
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  WOOD_CONTEXT_OPERATION
+});
 //# sourceMappingURL=context.cjs.map