@dxos/tracing 0.8.4-main.ae835ea → 0.8.4-main.bc2380dfbc

package/dist/types/src/index.d.ts

@@ -1,10 +1,9 @@
 export * from './api';
 export * from './symbols';
 export * from './trace-processor';
-export * from './trace-sender';
+export * from './tracing-types';
 export * from './metrics';
 export * from './diagnostic';
 export * from './diagnostics-channel';
-export * from './remote/tracing';
 export * from './remote/metrics';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAMA,cAAc,OAAO,CAAC;AACtB,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAMA,cAAc,OAAO,CAAC;AACtB,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC"}

package/dist/types/src/metrics/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../src/metrics/base.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAEjE,8BAAsB,WAAW;IAM/B,IAAI,CAAC,EAAE,MAAM,CAAC;IAUd,QAAQ,CAAC,OAAO,IAAI,MAAM;IAE1B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAC1B"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../src/metrics/base.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAEjE,8BAAsB,WAAW;IAM/B,IAAI,CAAC,EAAE,MAAM,CAAC;IAUd,QAAQ,CAAC,OAAO,IAAI,MAAM,CAAC;IAE3B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAG;CAC7B"}

package/dist/types/src/metrics/custom-counter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"custom-counter.d.ts","sourceRoot":"","sources":["../../../../src/metrics/custom-counter.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAEjE,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC,qBAAa,aAAc,SAAQ,WAAW;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,MAAM,MAAM;IAI1C,OAAO,IAAI,MAAM;CAQ3B"}
+{"version":3,"file":"custom-counter.d.ts","sourceRoot":"","sources":["../../../../src/metrics/custom-counter.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAEjE,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC,qBAAa,aAAc,SAAQ,WAAW;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAArC,YAA6B,QAAQ,EAAE,MAAM,MAAM,EAElD;IAEQ,OAAO,IAAI,MAAM,CAOzB;CACF"}

package/dist/types/src/metrics/map-counter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"map-counter.d.ts","sourceRoot":"","sources":["../../../../src/metrics/map-counter.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAEjE,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC,qBAAa,UAAW,SAAQ,WAAW;IACzC,MAAM,sBAA6B;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;gBAEH,EAAE,KAAK,EAAE,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO;IAK9C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,SAAI,GAAG,IAAI;IAK9B,OAAO,IAAI,MAAM;CAYlB"}
+{"version":3,"file":"map-counter.d.ts","sourceRoot":"","sources":["../../../../src/metrics/map-counter.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAEjE,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC,qBAAa,UAAW,SAAQ,WAAW;IACzC,MAAM,sBAA6B;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,YAAY,EAAE,KAAK,EAAE,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,EAG7C;IAED,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,SAAI,GAAG,IAAI,CAG7B;IAED,OAAO,IAAI,MAAM,CAWhB;CACF"}

package/dist/types/src/metrics/time-series-counter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"time-series-counter.d.ts","sourceRoot":"","sources":["../../../../src/metrics/time-series-counter.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAEjE,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAIrC,qBAAa,iBAAkB,SAAQ,WAAW;IAChD,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,QAAQ,CAAgB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;gBAEH,EAAE,KAAK,EAAE,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO;IAK9C,GAAG,CAAC,EAAE,SAAI,GAAG,IAAI;IAKR,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQzB,OAAO,IAAI,MAAM;CAiB3B"}
+{"version":3,"file":"time-series-counter.d.ts","sourceRoot":"","sources":["../../../../src/metrics/time-series-counter.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAEjE,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAIrC,qBAAa,iBAAkB,SAAQ,WAAW;IAChD,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,QAAQ,CAAgB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,YAAY,EAAE,KAAK,EAAE,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,EAG7C;IAED,GAAG,CAAC,EAAE,SAAI,GAAG,IAAI,CAGhB;IAEQ,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAMjC;IAEQ,OAAO,IAAI,MAAM,CAgBzB;CACF"}

package/dist/types/src/metrics/time-usage-counter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"time-usage-counter.d.ts","sourceRoot":"","sources":["../../../../src/metrics/time-usage-counter.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAEjE,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAIrC,qBAAa,gBAAiB,SAAQ,WAAW;IAC/C,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,QAAQ,CAAgB;IAEhC,OAAO,CAAC,aAAa,CAAqB;IAE1C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK1B,cAAc,IAAI;QAAE,GAAG,EAAE,MAAM,IAAI,CAAA;KAAE;IAU5B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAYzB,OAAO,IAAI,MAAM;CAiB3B"}
+{"version":3,"file":"time-usage-counter.d.ts","sourceRoot":"","sources":["../../../../src/metrics/time-usage-counter.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAEjE,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAIrC,qBAAa,gBAAiB,SAAQ,WAAW;IAC/C,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,QAAQ,CAAgB;IAEhC,OAAO,CAAC,aAAa,CAAqB;IAE1C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAGzB;IAED,cAAc,IAAI;QAAE,GAAG,EAAE,MAAM,IAAI,CAAA;KAAE,CAQpC;IAEQ,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAUjC;IAEQ,OAAO,IAAI,MAAM,CAgBzB;CACF"}

package/dist/types/src/metrics/unary-counter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"unary-counter.d.ts","sourceRoot":"","sources":["../../../../src/metrics/unary-counter.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAEjE,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC,qBAAa,YAAa,SAAQ,WAAW;IAC3C,KAAK,SAAK;IACV,KAAK,CAAC,EAAE,MAAM,CAAC;gBAEH,EAAE,KAAK,EAAE,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO;IAK9C,GAAG,CAAC,EAAE,SAAI,GAAG,IAAI;IAIjB,OAAO,IAAI,MAAM;CASlB"}
+{"version":3,"file":"unary-counter.d.ts","sourceRoot":"","sources":["../../../../src/metrics/unary-counter.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAEjE,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC,qBAAa,YAAa,SAAQ,WAAW;IAC3C,KAAK,SAAK;IACV,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,YAAY,EAAE,KAAK,EAAE,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,EAG7C;IAED,GAAG,CAAC,EAAE,SAAI,GAAG,IAAI,CAEhB;IAED,OAAO,IAAI,MAAM,CAQhB;CACF"}

package/dist/types/src/remote/index.d.ts

@@ -1,3 +1,2 @@
 export * from './metrics';
-export * from './tracing';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/src/remote/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/remote/index.ts"],"names":[],"mappings":"AAIA,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/remote/index.ts"],"names":[],"mappings":"AAIA,cAAc,WAAW,CAAC"}

package/dist/types/src/remote/metrics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../../src/remote/metrics.ts"],"names":[],"mappings":"AAIA,KAAK,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;AAE5D,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,cAAc;IACtB;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IACjE;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IACnE;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IACnE;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;CAC7D;AAED;;GAEG;AACH,qBAAa,aAAc,YAAW,cAAc;IAClD,OAAO,CAAC,QAAQ,CAA6B;IAE7C,iBAAiB,CAAC,SAAS,EAAE,cAAc,GAAG,IAAI;IAIlD,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,EAAE;IAIlE,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,EAAE;IAIpE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,EAAE;IAIpE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,EAAE;CAG9D"}
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../../src/remote/metrics.ts"],"names":[],"mappings":"AAIA,KAAK,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;AAE5D,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,cAAc;IACtB;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IACjE;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IACnE;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IACnE;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;CAC7D;AAED;;GAEG;AACH,qBAAa,aAAc,YAAW,cAAc;IAClD,OAAO,CAAC,QAAQ,CAA6B;IAE7C,iBAAiB,CAAC,SAAS,EAAE,cAAc,GAAG,IAAI,CAEjD;IAED,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,EAAE,CAEjE;IAED,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,EAAE,CAEnE;IAED,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,EAAE,CAEnE;IAED,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,EAAE,CAE5D;CACF"}

package/dist/types/src/symbols.d.ts

@@ -7,5 +7,4 @@ export type TracingContext = {
     metricsProperties: Record<string, {}>;
 };
 export declare const getTracingContext: (target: any) => TracingContext;
-export declare const TRACE_SPAN_ATTRIBUTE = "dxos.trace-span";
 //# sourceMappingURL=symbols.d.ts.map

package/dist/types/src/symbols.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"symbols.d.ts","sourceRoot":"","sources":["../../../src/symbols.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,OAAO,CAAC;AAEzC,eAAO,MAAM,oBAAoB,eAAiC,CAAC;AAEnE,MAAM,MAAM,cAAc,GAAG;IAC3B,cAAc,EAAE,MAAM,CACpB,MAAM,EACN;QACE,OAAO,EAAE,WAAW,CAAC;KACtB,CACF,CAAC;IACF,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;CACvC,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,QAAQ,GAAG,KAAG,cAK/C,CAAC;AAEF,eAAO,MAAM,oBAAoB,oBAAoB,CAAC"}
+{"version":3,"file":"symbols.d.ts","sourceRoot":"","sources":["../../../src/symbols.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,OAAO,CAAC;AAEzC,eAAO,MAAM,oBAAoB,eAAiC,CAAC;AAEnE,MAAM,MAAM,cAAc,GAAG;IAC3B,cAAc,EAAE,MAAM,CACpB,MAAM,EACN;QACE,OAAO,EAAE,WAAW,CAAC;KACtB,CACF,CAAC;IACF,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;CACvC,CAAC;AAEF,eAAO,MAAM,iBAAiB,WAAY,GAAG,KAAG,cAK/C,CAAC"}

package/dist/types/src/trace-processor.d.ts

@@ -1,32 +1,21 @@
-import { type Context } from '@dxos/context';
 import { type LogEntry } from '@dxos/protocols/proto/dxos/client/services';
-import { type Error as SerializedError } from '@dxos/protocols/proto/dxos/error';
-import { type Metric, type Resource, type Span } from '@dxos/protocols/proto/dxos/tracing';
+import { type Metric, type Resource } from '@dxos/protocols/proto/dxos/tracing';
 import type { AddLinkOptions } from './api';
 import { DiagnosticsManager } from './diagnostic';
 import { DiagnosticsChannel } from './diagnostics-channel';
-import { RemoteMetrics, RemoteTracing } from './remote';
-import { TraceSender } from './trace-sender';
+import { RemoteMetrics } from './remote/metrics';
+import type { TracingBackend } from './tracing-types';
 export type Diagnostics = {
     resources: Record<string, Resource>;
-    spans: Span[];
     logs: LogEntry[];
 };
-export type TraceResourceConstructorParams = {
+export type TraceResourceConstructorProps = {
     constructor: {
         new (...args: any[]): {};
     };
     instance: any;
     annotation?: symbol;
 };
-export type TraceSpanParams = {
-    instance: any;
-    methodName: string;
-    parentCtx: Context | null;
-    showInBrowserTimeline: boolean;
-    op?: string;
-    attributes?: Record<string, any>;
-};
 export declare class ResourceEntry {
     readonly data: Resource;
     readonly instance: WeakRef<any>;
@@ -40,29 +29,29 @@ export declare class ResourceEntry {
     constructor(data: Resource, instance: WeakRef<any>, annotation?: symbol | undefined);
     getMetric(name: string): Metric | undefined;
 }
-export type TraceSubscription = {
-    flush: () => void;
-    dirtyResources: Set<number>;
-    dirtySpans: Set<number>;
-    newLogs: LogEntry[];
-};
 export declare class TraceProcessor {
+    #private;
     readonly diagnostics: DiagnosticsManager;
     readonly diagnosticsChannel: DiagnosticsChannel;
     readonly remoteMetrics: RemoteMetrics;
-    readonly remoteTracing: RemoteTracing;
-    readonly subscriptions: Set<TraceSubscription>;
+    /**
+     * Tracing backend. Initially a buffering backend that records spans;
+     * once the observability package sets a real backend, the buffer is drained
+     * and a thin translating wrapper is installed that resolves stale buffered
+     * parent IDs still held by in-flight {@link Context} objects.
+     *
+     * The wrapper only allocates when a `buffered-*` parent is actually encountered;
+     * the common path is a single `startsWith` check and direct passthrough.
+     */
+    get tracingBackend(): TracingBackend;
+    set tracingBackend(backend: TracingBackend | undefined);
     readonly resources: Map<number, ResourceEntry>;
     readonly resourceInstanceIndex: WeakMap<any, ResourceEntry>;
     readonly resourceIdList: number[];
-    readonly spans: Map<number, Span>;
-    readonly spanIdList: number[];
     readonly logs: LogEntry[];
     private _instanceTag;
     constructor();
     setInstanceTag(tag: string): void;
-    createTraceSender(): TraceSender;
-    traceSpan(params: TraceSpanParams): TracingSpan;
     addLink(parent: any, child: any, opts: AddLinkOptions): void;
     getDiagnostics(): Diagnostics;
     getResourceInfo(instance: any): Record<string, any>;
@@ -71,35 +60,10 @@ export declare class TraceProcessor {
     findResourcesByClassName(className: string): ResourceEntry[];
     findResourcesByAnnotation(annotation: symbol): ResourceEntry[];
     refresh(): void;
-    private _markResourceDirty;
-    private _markSpanDirty;
     private _clearResources;
-    private _clearSpans;
     private _pushLog;
     private _logProcessor;
 }
-export declare class TracingSpan {
-    private _traceProcessor;
-    static nextId: number;
-    readonly id: number;
-    readonly parentId: number | null;
-    readonly methodName: string;
-    readonly resourceId: number | null;
-    readonly op: string | undefined;
-    readonly attributes: Record<string, any>;
-    startTs: number;
-    endTs: number | null;
-    error: SerializedError | null;
-    private _showInBrowserTimeline;
-    private readonly _ctx;
-    constructor(_traceProcessor: TraceProcessor, params: TraceSpanParams);
-    get name(): string;
-    get ctx(): Context | null;
-    markSuccess(): void;
-    markError(err: unknown): void;
-    serialize(): Span;
-    private _markInBrowserTimeline;
-}
 export declare const TRACE_PROCESSOR: TraceProcessor;
 export declare const sanitizeClassName: (className: string) => string;
 //# sourceMappingURL=trace-processor.d.ts.map

package/dist/types/src/trace-processor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trace-processor.d.ts","sourceRoot":"","sources":["../../../src/trace-processor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"trace-processor.d.ts","sourceRoot":"","sources":["../../../src/trace-processor.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,4CAA4C,CAAC;AAC3E,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAGhF,OAAO,KAAK,EAAE,cAAc,EAAa,MAAM,OAAO,CAAC;AAEvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,KAAK,EAAgC,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGpF,MAAM,MAAM,WAAW,GAAG;IACxB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACpC,IAAI,EAAE,QAAQ,EAAE,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,WAAW,EAAE;QAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,CAAA;KAAE,CAAC;IAC1C,QAAQ,EAAE,GAAG,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,qBAAa,aAAa;aASN,IAAI,EAAE,QAAQ;aACd,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC;aACtB,UAAU,CAAC,EAAE,MAAM;IAVrC;;;;OAIG;IACH,SAAgB,kBAAkB,EAAE,MAAM,CAAC;IAE3C,YACkB,IAAI,EAAE,QAAQ,EACd,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,EACtB,UAAU,CAAC,EAAE,MAAM,YAAA,EAGpC;IAED,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE1C;CACF;AAOD,qBAAa,cAAc;;IACzB,SAAgB,WAAW,qBAA4B;IACvD,SAAgB,kBAAkB,qBAA4B;IAC9D,SAAgB,aAAa,gBAAuB;IAKpD;;;;;;;;OAQG;IACH,IAAI,cAAc,IAAI,cAAc,CAEnC;IAED,IAAI,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,EAmBrD;IAED,QAAQ,CAAC,SAAS,6BAAoC;IACtD,QAAQ,CAAC,qBAAqB,8BAAqC;IACnE,QAAQ,CAAC,cAAc,EAAE,MAAM,EAAE,CAAM;IAEvC,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAM;IAE/B,OAAO,CAAC,YAAY,CAAuB;IAE3C,cAOC;IAED,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAGhC;IAiCD,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI,CAAG;IAE/D,cAAc,IAAI,WAAW,CAY5B;IAED,eAAe,CAAC,QAAQ,EAAE,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAqBlD;IAED,kBAAkB,CAAC,QAAQ,EAAE,GAAG,GAAG,MAAM,EAAE,CAQ1C;IAED,aAAa,CAAC,QAAQ,EAAE,GAAG,GAAG,MAAM,GAAG,IAAI,CAG1C;IAED,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,EAAE,CAI3D;IAED,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,EAAE,CAE7D;IAED,OAAO,IAAI,IAAI,CAiBd;IAED,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,aAAa,CAiCnB;CACH;AAED,eAAO,MAAM,eAAe,EAAE,cAA+E,CAAC;AAsD9G,eAAO,MAAM,iBAAiB,cAAe,MAAM,WAQlD,CAAC"}

package/dist/types/src/tracing-types.d.ts

@@ -0,0 +1,67 @@
+import { type TraceContextData } from '@dxos/context';
+/**
+ * Opaque span handle returned by {@link TracingBackend.startSpan}.
+ *
+ * The `spanContext` field carries W3C trace context strings that are stored
+ * on the DXOS {@link Context} via `TRACE_SPAN_ATTRIBUTE`. Because these are
+ * plain strings (not live runtime objects), they survive after the span ends
+ * and across serialization boundaries.
+ */
+export type RemoteSpan = {
+    /** Signal that the span has ended. Must be called exactly once. */
+    end: (endTime?: number) => void;
+    /** Record an error on the span (e.g., OTEL `span.recordException` + `setStatus`). */
+    setError?: (err: unknown) => void;
+    /**
+     * W3C trace context identifying this span.
+     *
+     * Stored on the DXOS `Context` attribute (`TRACE_SPAN_ATTRIBUTE`) so that
+     * child `@trace.span()` methods can read it and pass it as
+     * {@link StartSpanOptions.parentContext} to create properly-parented spans.
+     */
+    spanContext?: TraceContextData;
+};
+/**
+ * Options passed to {@link TracingBackend.startSpan}.
+ */
+export type StartSpanOptions = {
+    /** Human-readable span name, typically `ClassName.methodName`. */
+    name: string;
+    /** Span category (e.g., `'function'`, `'rpc'`). */
+    op?: string;
+    /** Key-value attributes attached to the span. */
+    attributes?: Record<string, any>;
+    /**
+     * W3C trace context of the parent span.
+     *
+     * The backend extracts the trace/span IDs from these strings to establish
+     * parent-child relationships. When `undefined`, the backend creates a root span.
+     */
+    parentContext?: TraceContextData;
+    /**
+     * Epoch-millisecond timestamp for the span start.
+     * Used by the buffering backend to preserve original timing when replaying spans.
+     * When `undefined`, the backend uses the current time.
+     */
+    startTime?: number;
+};
+/**
+ * Backend-agnostic tracing interface implemented by the observability package
+ * and registered on `TRACE_PROCESSOR.tracingBackend`.
+ *
+ * The backend receives and returns {@link TraceContextData} (W3C strings) —
+ * no opaque runtime objects cross the interface boundary. The OTEL backend
+ * performs `propagation.extract/inject` internally in {@link startSpan}.
+ */
+export interface TracingBackend {
+    /**
+     * Create a new span.
+     *
+     * The backend should:
+     * 1. Extract the parent from `options.parentContext` (if present).
+     * 2. Create a span as a child of that parent.
+     * 3. Inject the new span's identity into the returned `spanContext`.
+     */
+    startSpan: (options: StartSpanOptions) => RemoteSpan;
+}
+//# sourceMappingURL=tracing-types.d.ts.map

package/dist/types/src/tracing-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing-types.d.ts","sourceRoot":"","sources":["../../../src/tracing-types.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD;;;;;;;GAOG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,mEAAmE;IACnE,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAEhC,qFAAqF;IACrF,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IAElC;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,gBAAgB,CAAC;CAChC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEjC;;;;;OAKG;IACH,aAAa,CAAC,EAAE,gBAAgB,CAAC;IAEjC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;;OAOG;IACH,SAAS,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,UAAU,CAAC;CACtD"}