@dxos/observability 0.13.0 → 0.14.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/observability",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "Provides a common interface for app and platform observability",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -109,27 +109,27 @@
     "posthog-node": "^5.51.4",
     "uuid": "^9.0.0",
     "zone.js": "^0.15.0",
-    "@dxos/async": "0.13.0",
-    "@dxos/client": "0.13.0",
-    "@dxos/client-protocol": "0.13.0",
-    "@dxos/config": "0.13.0",
-    "@dxos/context": "0.13.0",
-    "@dxos/echo": "0.13.0",
-    "@dxos/effect": "0.13.0",
-    "@dxos/invariant": "0.13.0",
-    "@dxos/log": "0.13.0",
-    "@dxos/log-store-idb": "0.13.0",
-    "@dxos/node-std": "0.13.0",
-    "@dxos/protocols": "0.13.0",
-    "@dxos/tracing": "0.13.0",
-    "@dxos/util": "0.13.0"
+    "@dxos/async": "0.14.0",
+    "@dxos/client": "0.14.0",
+    "@dxos/client-protocol": "0.14.0",
+    "@dxos/config": "0.14.0",
+    "@dxos/context": "0.14.0",
+    "@dxos/echo": "0.14.0",
+    "@dxos/effect": "0.14.0",
+    "@dxos/invariant": "0.14.0",
+    "@dxos/log": "0.14.0",
+    "@dxos/log-store-idb": "0.14.0",
+    "@dxos/node-std": "0.14.0",
+    "@dxos/protocols": "0.14.0",
+    "@dxos/tracing": "0.14.0",
+    "@dxos/util": "0.14.0"
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.5",
-    "@dxos/ai": "0.13.0",
-    "@dxos/client-services": "0.13.0",
-    "@dxos/errors": "0.13.0",
-    "@dxos/network-manager": "0.13.0"
+    "@dxos/ai": "0.14.0",
+    "@dxos/client-services": "0.14.0",
+    "@dxos/errors": "0.14.0",
+    "@dxos/network-manager": "0.14.0"
   },
   "peerDependencies": {
     "effect": "4.0.0"

package/src/Observability.test.ts

@@ -362,8 +362,18 @@ describe('Observability', () => {
         const uploadLogs = vi.fn(async () => 'logs/1.ndjson');
         const sessionContext = vi.fn(() => ({ distinctId: 'd', widgetSessionId: 'w' }));
         const flushLogs = vi.fn(async () => {});
+        const uploadNdjson = vi.fn(async () => 'trajectories/1.ndjson.gz');
         const supportExt = createMockExtension({
-          apis: [{ kind: 'support', isAvailable: () => Effect.succeed(true), uploadLogs, sessionContext, flushLogs }],
+          apis: [
+            {
+              kind: 'support',
+              isAvailable: () => Effect.succeed(true),
+              uploadLogs,
+              uploadNdjson,
+              sessionContext,
+              flushLogs,
+            },
+          ],
         });
         const obs = yield* Function.pipe(
           Observability.make(),
@@ -371,6 +381,10 @@ describe('Observability', () => {
           Observability.initialize,
         );
         expect(yield* Effect.promise(() => obs.support.uploadLogs())).toBe('logs/1.ndjson');
+        expect(yield* Effect.promise(() => obs.support.uploadNdjson('{}', 'trajectory'))).toBe(
+          'trajectories/1.ndjson.gz',
+        );
+        expect(uploadNdjson).toHaveBeenCalledWith('{}', 'trajectory');
         expect(obs.support.sessionContext()).toEqual({ distinctId: 'd', widgetSessionId: 'w' });
         yield* Effect.promise(() => obs.support.flushLogs({ ticketId: 'ticket-1' }));
         expect(flushLogs).toHaveBeenCalledWith({ ticketId: 'ticket-1' });

package/src/Observability.ts

@@ -277,6 +277,13 @@ class ObservabilityImpl implements Observability {
         }
         return key;
       },
+      uploadNdjson: async (ndjson, kind) => {
+        let key: string | undefined;
+        for (const extension of this._getExtensions('support')) {
+          key = (await extension.uploadNdjson(ndjson, kind)) ?? key;
+        }
+        return key;
+      },
       sessionContext: () => {
         for (const extension of this._getExtensions('support')) {
           const context = extension.sessionContext();

package/src/ObservabilityExtension.ts

@@ -184,8 +184,13 @@ export type Mcp = {
  */
 export type SupportLogTags = { ticketId: string } | { reportId: string };
 
+/** What an uploaded NDJSON bundle is, which decides where it is filed in storage. */
+export type SupportUploadKind = 'logs' | 'trajectory';
+
 export type Support = {
   uploadLogs(): Promise<string | undefined>;
+  /** Uploads an NDJSON bundle the caller built (e.g. an agent trajectory), returning its storage key. */
+  uploadNdjson(ndjson: string, kind: SupportUploadKind): Promise<string | undefined>;
   sessionContext(): SupportSessionContext | undefined;
   flushLogs(attributes: SupportLogTags): Promise<void>;
 };

package/src/extensions/otel/tail-sampling.test.ts

@@ -46,6 +46,12 @@ describe('TailSampler', () => {
     expect(new TailSampler().keep(span({ attributes: { 'dxos.ai.kind': 'tool' } }))).toEqual(true);
   });
 
+  test('keeps a span marked to keep, under either attribute namespace', ({ expect }) => {
+    expect(new TailSampler().keep(span({ attributes: { 'dxos.sampling.keep': true } }))).toEqual(true);
+    expect(new TailSampler().keep(span({ attributes: { 'ctx.dxos.sampling.keep': true } }))).toEqual(true);
+    expect(new TailSampler().keep(span({ attributes: { 'ctx.dxos.sampling.keep': false } }))).toEqual(false);
+  });
+
   test('keeps a span slower than the threshold', ({ expect }) => {
     expect(new TailSampler().keep(span({ durationMs: DEFAULT_SLOW_MS + 1 }))).toEqual(true);
   });

package/src/extensions/otel/tail-sampling.ts

@@ -30,6 +30,8 @@ import * as SpanAttributes from '@dxos/effect/SpanAttributes';
  * In order:
  * - a span that **errored** is kept, and its trace is promoted;
  * - a span slower than {@link DEFAULT_SLOW_MS} is kept, and its trace is promoted;
+ * - a span marked `dxos.sampling.keep` — a rare flow such as an invitation, which a dashboard counts
+ *   one by one and a 30% sample would mostly hide — is kept, and its trace is promoted;
  * - a span carrying `gen_ai.*` or `dxos.ai.kind` — a model call, or the turn and tool calls
  *   around it that the AI analytics sink reports — is kept, and its trace is promoted, so a model call is never a
  *   fraction of the calls that happened. This one is ours rather than canonical: the AI events are
@@ -109,6 +111,7 @@ export class TailSampler {
     return (
       span.status.code === SpanStatusCode.ERROR ||
       span.durationMs > this._slowMs ||
+      isKeepMarked(span.attributes) ||
       Object.keys(span.attributes).some(isAiAttribute)
     );
   }
@@ -136,6 +139,10 @@ const GEN_AI_PREFIX = 'gen_ai.';
 /** `gen_ai.*` marks a model call; `dxos.ai.kind` the turn around it and the tool calls inside it. */
 const isAiAttribute = (key: string): boolean => key.startsWith(GEN_AI_PREFIX) || key === SpanAttributes.AI.kind;
 
+/** Manual `@dxos/tracing` spans namespace their attributes under `ctx.`, so the marker arrives either way. */
+const isKeepMarked = (attributes: Attributes): boolean =>
+  attributes[SpanAttributes.SAMPLING.keep] === true || attributes[`ctx.${SpanAttributes.SAMPLING.keep}`] === true;
+
 /**
  * Deterministic per trace, so every span of a trace decides the same way. Reads the low 8 hex digits
  * of the 32-hex-digit trace id — the id is random, so any window is uniform, and 32 bits is well

package/src/extensions/posthog/extension.ts

@@ -84,9 +84,15 @@ export type NodeOptions = {
 const DEFAULT_FEEDBACK_LOGS_ENDPOINT = '/api/feedback-logs';
 
 /** Upload serialized logs, gzipped, to the feedback-logs endpoint. Returns the R2 key on success. */
-const uploadLogs = async (endpoint: string, ndjson: string): Promise<string | undefined> => {
+const uploadLogs = async (
+  endpoint: string,
+  ndjson: string,
+  kind: ObservabilityExtension.SupportUploadKind = 'logs',
+): Promise<string | undefined> => {
   try {
-    const response = await fetch(endpoint, {
+    // The endpoint may be relative (same-origin) or absolute (native builds), so append rather than parse.
+    const url = kind === 'logs' ? endpoint : `${endpoint}${endpoint.includes('?') ? '&' : '?'}kind=${kind}`;
+    const response = await fetch(url, {
       method: 'POST',
       headers: { 'Content-Type': 'application/gzip' },
       body: await gzip(ndjson),
@@ -225,6 +231,8 @@ export const extensions: (options: ExtensionsOptions) => Effect.Effect<Observabi
             }
             return await uploadLogs(feedbackLogsEndpoint, ndjson);
           },
+          uploadNdjson: async (ndjson, kind) =>
+            ndjson.length === 0 ? undefined : await uploadLogs(feedbackLogsEndpoint, ndjson, kind),
           sessionContext: () => {
             if (!posthog.__loaded) {
               return undefined;

package/src/version.ts

@@ -2,4 +2,4 @@
 // Copyright 2026 DXOS.org
 //
 
-export const DXOS_VERSION = '0.13.0';
+export const DXOS_VERSION = '0.14.0';