@dxos/observability 0.8.3 → 0.8.4-main.1068cf700f

package/dist/types/src/extensions/otel/otel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel.d.ts","sourceRoot":"","sources":["../../../../../src/extensions/otel/otel.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEzD,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,MAAM;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IACzC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,QAAQ,MAAM,SAK3C,CAAC"}

package/dist/types/src/{otel → extensions/otel}/otel.js

@@ -1,7 +1,7 @@
 //
 // Copyright 2024 DXOS.org
 //
-import { diag, DiagConsoleLogger, DiagLogLevel } from '@opentelemetry/api';
+import { DiagConsoleLogger, DiagLogLevel, diag } from '@opentelemetry/api';
 export const setDiagLogger = (level) => {
     const logLevel = DiagLogLevel[level];
     if (logLevel) {

package/dist/types/src/extensions/otel/otel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel.js","sourceRoot":"","sources":["../../../../../src/extensions/otel/otel.ts"],"names":[],"mappings":"AAAA,EAAE;AACF,0BAA0B;AAC1B,EAAE;AAEF,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAW3E,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAc,EAAE,EAAE;IAC9C,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAkC,CAAC,CAAC;IAClE,IAAI,QAAQ,EAAE,CAAC;QACb,IAAI,CAAC,SAAS,CAAC,IAAI,iBAAiB,EAAE,EAAE,QAAQ,CAAC,CAAC;IACpD,CAAC;AACH,CAAC,CAAC"}

package/dist/types/src/extensions/otel/traces-browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traces-browser.d.ts","sourceRoot":"","sources":["../../../../../src/extensions/otel/traces-browser.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,QAAQ,CAAC;AAE1C,qBAAa,UAAU;IAGT,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,OAAO,CAAS;gBAEK,OAAO,EAAE,WAAW;IAsB1C,KAAK,IAAI,IAAI;CAcrB"}

package/dist/types/src/extensions/otel/traces-browser.js

@@ -0,0 +1,44 @@
+//
+// Copyright 2024 DXOS.org
+//
+import { trace } from '@opentelemetry/api';
+import { getWebAutoInstrumentations } from '@opentelemetry/auto-instrumentations-web';
+import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';
+import { registerInstrumentations } from '@opentelemetry/instrumentation';
+import { BatchSpanProcessor } from '@opentelemetry/sdk-trace-base';
+import { WebTracerProvider } from '@opentelemetry/sdk-trace-web';
+import { ATTR_SERVICE_VERSION } from '@opentelemetry/semantic-conventions';
+import { log } from '@dxos/log';
+import { TRACE_PROCESSOR } from '@dxos/tracing';
+export class OtelTraces {
+    options;
+    _tracer;
+    constructor(options) {
+        this.options = options;
+        const tracerProvider = new WebTracerProvider({
+            resource: this.options.resource,
+            spanProcessors: [
+                new BatchSpanProcessor(new OTLPTraceExporter({
+                    url: this.options.endpoint + '/v1/traces',
+                    headers: this.options.headers,
+                    concurrencyLimit: 10, // an optional limit on pending requests
+                })),
+            ],
+        });
+        trace.setGlobalTracerProvider(tracerProvider);
+        this._tracer = trace.getTracer('dxos-observability', this.options.resource.attributes[ATTR_SERVICE_VERSION]?.toString());
+    }
+    start() {
+        log('trace processor registered');
+        registerInstrumentations({
+            instrumentations: [getWebAutoInstrumentations()],
+        });
+        TRACE_PROCESSOR.remoteTracing.registerProcessor({
+            startSpan: (options) => {
+                log('begin otel trace', { options });
+                return this._tracer.startSpan(options.name, options);
+            },
+        });
+    }
+}
+//# sourceMappingURL=traces-browser.js.map

package/dist/types/src/extensions/otel/traces-browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traces-browser.js","sourceRoot":"","sources":["../../../../../src/extensions/otel/traces-browser.ts"],"names":[],"mappings":"AAAA,EAAE;AACF,0BAA0B;AAC1B,EAAE;AAEF,OAAO,EAAe,KAAK,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,0BAA0B,EAAE,MAAM,0CAA0C,CAAC;AACtF,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAC5E,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAE3E,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAChC,OAAO,EAAyB,eAAe,EAAE,MAAM,eAAe,CAAC;AAIvE,MAAM,OAAO,UAAU;IAGQ;IAFrB,OAAO,CAAS;IAExB,YAA6B,OAAoB;QAApB,YAAO,GAAP,OAAO,CAAa;QAC/C,MAAM,cAAc,GAAG,IAAI,iBAAiB,CAAC;YAC3C,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ;YAC/B,cAAc,EAAE;gBACd,IAAI,kBAAkB,CACpB,IAAI,iBAAiB,CAAC;oBACpB,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,GAAG,YAAY;oBACzC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO;oBAC7B,gBAAgB,EAAE,EAAE,EAAE,wCAAwC;iBAC/D,CAAC,CACH;aACF;SACF,CAAC,CAAC;QAEH,KAAK,CAAC,uBAAuB,CAAC,cAAc,CAAC,CAAC;QAE9C,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,SAAS,CAC5B,oBAAoB,EACpB,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,oBAAoB,CAAC,EAAE,QAAQ,EAAE,CACnE,CAAC;IACJ,CAAC;IAEM,KAAK;QACV,GAAG,CAAC,4BAA4B,CAAC,CAAC;QAElC,wBAAwB,CAAC;YACvB,gBAAgB,EAAE,CAAC,0BAA0B,EAAE,CAAC;SACjD,CAAC,CAAC;QAEH,eAAe,CAAC,aAAa,CAAC,iBAAiB,CAAC;YAC9C,SAAS,EAAE,CAAC,OAAyB,EAAE,EAAE;gBACvC,GAAG,CAAC,kBAAkB,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;gBACrC,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACvD,CAAC;SACF,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/types/src/extensions/otel/traces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traces.d.ts","sourceRoot":"","sources":["../../../../../src/extensions/otel/traces.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,QAAQ,CAAC;AAE1C,qBAAa,UAAU;IAGT,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,OAAO,CAAS;gBAEK,OAAO,EAAE,WAAW;IAqB1C,KAAK,IAAI,IAAI;CAUrB"}

package/dist/types/src/extensions/otel/traces.js

@@ -0,0 +1,38 @@
+//
+// Copyright 2024 DXOS.org
+//
+import { trace } from '@opentelemetry/api';
+import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';
+import { BasicTracerProvider, BatchSpanProcessor } from '@opentelemetry/sdk-trace-base';
+import { ATTR_SERVICE_VERSION } from '@opentelemetry/semantic-conventions';
+import { log } from 'debug';
+import { TRACE_PROCESSOR } from '@dxos/tracing';
+export class OtelTraces {
+    options;
+    _tracer;
+    constructor(options) {
+        this.options = options;
+        const tracerProvider = new BasicTracerProvider({
+            resource: this.options.resource,
+            spanProcessors: [
+                new BatchSpanProcessor(new OTLPTraceExporter({
+                    url: this.options.endpoint + '/v1/traces',
+                    headers: this.options.headers,
+                    concurrencyLimit: 10, // an optional limit on pending requests
+                })),
+            ],
+        });
+        trace.setGlobalTracerProvider(tracerProvider);
+        this._tracer = trace.getTracer('dxos-observability', this.options.resource.attributes[ATTR_SERVICE_VERSION]?.toString());
+    }
+    start() {
+        log('trace processor registered');
+        TRACE_PROCESSOR.remoteTracing.registerProcessor({
+            startSpan: (options) => {
+                log('begin otel trace', { options });
+                return this._tracer.startSpan(options.name, options);
+            },
+        });
+    }
+}
+//# sourceMappingURL=traces.js.map

package/dist/types/src/extensions/otel/traces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traces.js","sourceRoot":"","sources":["../../../../../src/extensions/otel/traces.ts"],"names":[],"mappings":"AAAA,EAAE;AACF,0BAA0B;AAC1B,EAAE;AAEF,OAAO,EAAe,KAAK,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAC5E,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACxF,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAE5B,OAAO,EAAyB,eAAe,EAAE,MAAM,eAAe,CAAC;AAIvE,MAAM,OAAO,UAAU;IAGQ;IAFrB,OAAO,CAAS;IAExB,YAA6B,OAAoB;QAApB,YAAO,GAAP,OAAO,CAAa;QAC/C,MAAM,cAAc,GAAG,IAAI,mBAAmB,CAAC;YAC7C,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ;YAC/B,cAAc,EAAE;gBACd,IAAI,kBAAkB,CACpB,IAAI,iBAAiB,CAAC;oBACpB,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,GAAG,YAAY;oBACzC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO;oBAC7B,gBAAgB,EAAE,EAAE,EAAE,wCAAwC;iBAC/D,CAAC,CACH;aACF;SACF,CAAC,CAAC;QAEH,KAAK,CAAC,uBAAuB,CAAC,cAAc,CAAC,CAAC;QAC9C,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,SAAS,CAC5B,oBAAoB,EACpB,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,oBAAoB,CAAC,EAAE,QAAQ,EAAE,CACnE,CAAC;IACJ,CAAC;IAEM,KAAK;QACV,GAAG,CAAC,4BAA4B,CAAC,CAAC;QAElC,eAAe,CAAC,aAAa,CAAC,iBAAiB,CAAC;YAC9C,SAAS,EAAE,CAAC,OAAyB,EAAE,EAAE;gBACvC,GAAG,CAAC,kBAAkB,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;gBACrC,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACvD,CAAC;SACF,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/types/src/extensions/posthog/extension.d.ts

@@ -0,0 +1,15 @@
+import * as Effect from 'effect/Effect';
+import { type PostHogConfig } from 'posthog-js';
+import { type Config } from '@dxos/config';
+import { type Extension } from '../../observability-extension';
+export type ExtensionsOptions = {
+    config: Config;
+    /** Release identifier, e.g. `composer@0.8.3`. */
+    release?: string;
+    /** Deployment environment, e.g. `production` or `staging`. */
+    environment?: string;
+    posthog?: Partial<PostHogConfig>;
+};
+/** Create a PostHog-backed observability extension for events, errors, and feedback. */
+export declare const extensions: (options: ExtensionsOptions) => Effect.Effect<Extension>;
+//# sourceMappingURL=extension.d.ts.map

package/dist/types/src/extensions/posthog/extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../../../../../src/extensions/posthog/extension.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAI3C,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAG/D,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;CAClC,CAAC;AAsBF,wFAAwF;AACxF,eAAO,MAAM,UAAU,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,MAAM,CAAC,MAAM,CAAC,SAAS,CA+H9E,CAAC"}

package/dist/types/src/extensions/posthog/extension.js

@@ -0,0 +1,143 @@
+//
+// Copyright 2025 DXOS.org
+//
+import * as Effect from 'effect/Effect';
+import { log } from '@dxos/log';
+import { LogBuffer } from '../../log-buffer';
+import { stubExtension } from '../stub';
+/** Upload serialized logs to the feedback-logs endpoint. Returns the R2 key on success. */
+const uploadLogs = async (body) => {
+    try {
+        const response = await fetch('/api/feedback-logs', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/x-ndjson' },
+            body,
+        });
+        if (!response.ok) {
+            log.warn('feedback log upload failed', { status: response.status });
+            return undefined;
+        }
+        const { key } = await response.json();
+        return key;
+    }
+    catch (err) {
+        log.warn('feedback log upload error', { error: err });
+        return undefined;
+    }
+};
+/** Create a PostHog-backed observability extension for events, errors, and feedback. */
+export const extensions = Effect.fn(function* ({ config, release, environment, posthog: posthogConfig, }) {
+    if (typeof window === 'undefined') {
+        log('PostHog is being stubbed because it is running in a worker.');
+        return stubExtension;
+    }
+    const feedbackSurveyId = config.get('runtime.app.env.DX_POSTHOG_FEEDBACK_SURVEY_ID');
+    const apiKey = config.get('runtime.app.env.DX_POSTHOG_API_KEY');
+    const api_host = config.get('runtime.app.env.DX_POSTHOG_API_HOST');
+    if (!apiKey || !api_host) {
+        log.info('Missing POSTHOG_API_KEY or POSTHOG_API_HOST');
+        return stubExtension;
+    }
+    const { default: posthog } = yield* Effect.promise(() => import('posthog-js'));
+    const { logProcessor } = yield* Effect.promise(() => import('./log-processor'));
+    const logBuffer = new LogBuffer();
+    let feedbackSurveyAvailable = null;
+    const checkFeedbackSurveyAvailable = () => feedbackSurveyId
+        ? Effect.promise(() => {
+            if (feedbackSurveyAvailable !== null) {
+                return Promise.resolve(feedbackSurveyAvailable);
+            }
+            return new Promise((resolve) => {
+                posthog.getSurveys((surveys) => {
+                    const found = surveys.some((s) => s.id === feedbackSurveyId);
+                    feedbackSurveyAvailable = found;
+                    resolve(found);
+                });
+            });
+        })
+        : Effect.succeed(false);
+    return {
+        initialize: () => Effect.sync(() => {
+            // https://posthog.com/docs/libraries/js/config
+            posthog.init(apiKey, {
+                api_host,
+                mask_all_text: true,
+                capture_exceptions: true,
+                ...posthogConfig,
+            });
+            if (release || environment) {
+                posthog.register({
+                    ...(release ? { release } : {}),
+                    ...(environment ? { environment } : {}),
+                });
+            }
+            log.runtimeConfig.processors.push(logProcessor);
+            log.runtimeConfig.processors.push(logBuffer.logProcessor);
+        }),
+        close: () => Effect.sync(() => {
+            for (const processor of [logProcessor, logBuffer.logProcessor]) {
+                const index = log.runtimeConfig.processors.indexOf(processor);
+                if (index !== -1) {
+                    log.runtimeConfig.processors.splice(index, 1);
+                }
+            }
+        }),
+        enable: () => Effect.sync(() => posthog.opt_in_capturing()),
+        disable: () => Effect.sync(() => posthog.opt_out_capturing()),
+        identify: (distinctId, attributes, setOnceAttributes) => {
+            posthog.identify(distinctId, attributes, setOnceAttributes);
+        },
+        alias: (distinctId, previousId) => {
+            posthog.alias(distinctId, previousId);
+        },
+        setTags: (tags) => {
+            posthog.register_for_session(tags);
+        },
+        get enabled() {
+            return posthog.is_capturing();
+        },
+        apis: [
+            {
+                kind: 'events',
+                isAvailable: () => Effect.succeed(true),
+                captureEvent: (event, attributes) => {
+                    posthog.capture(event, attributes);
+                },
+            },
+            {
+                kind: 'errors',
+                isAvailable: () => Effect.succeed(true),
+                captureException: (error, attributes) => {
+                    posthog.captureException(error, attributes);
+                },
+            },
+            {
+                kind: 'feedback',
+                // TODO(wittjosiah): Support custom surveys.
+                captureUserFeedback: (form) => {
+                    posthog.getSurveys(async (surveys) => {
+                        const survey = surveys.find((survey) => survey.id === feedbackSurveyId);
+                        if (!survey || survey.questions.length === 0) {
+                            log.error('Missing feedback survey or survey has no questions', { feedbackSurveyId });
+                            return;
+                        }
+                        let debugLogDumpKey;
+                        if (form.includeLogs !== false && logBuffer.size > 0) {
+                            debugLogDumpKey = await uploadLogs(logBuffer.serialize());
+                        }
+                        // https://posthog.com/docs/surveys/implementing-custom-surveys
+                        const question = survey.questions[0];
+                        posthog.capture('survey sent', {
+                            $survey_id: survey.id,
+                            $survey_questions: [{ id: question.id, question: question.question }],
+                            [`$survey_response_${question.id}`]: form.message,
+                            ...(debugLogDumpKey ? { debug_log_dump_key: debugLogDumpKey } : {}),
+                        });
+                    });
+                },
+                isAvailable: checkFeedbackSurveyAvailable,
+            },
+        ],
+    };
+});
+//# sourceMappingURL=extension.js.map

package/dist/types/src/extensions/posthog/extension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.js","sourceRoot":"","sources":["../../../../../src/extensions/posthog/extension.ts"],"names":[],"mappings":"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"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/extensions/posthog/index.ts"],"names":[],"mappings":"AAIA,cAAc,aAAa,CAAC"}

package/dist/types/src/extensions/posthog/index.js

@@ -0,0 +1,5 @@
+//
+// Copyright 2025 DXOS.org
+//
+export * from './extension';
+//# sourceMappingURL=index.js.map

package/dist/types/src/extensions/posthog/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/extensions/posthog/index.ts"],"names":[],"mappings":"AAAA,EAAE;AACF,0BAA0B;AAC1B,EAAE;AAEF,cAAc,aAAa,CAAC"}

package/dist/types/src/extensions/posthog/log-processor.d.ts

@@ -0,0 +1,3 @@
+import { type LogProcessor } from '@dxos/log';
+export declare const logProcessor: LogProcessor;
+//# sourceMappingURL=log-processor.d.ts.map

package/dist/types/src/extensions/posthog/log-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-processor.d.ts","sourceRoot":"","sources":["../../../../../src/extensions/posthog/log-processor.ts"],"names":[],"mappings":"AAOA,OAAO,EAA2C,KAAK,YAAY,EAAa,MAAM,WAAW,CAAC;AAElG,eAAO,MAAM,YAAY,EAAE,YAgC1B,CAAC"}

package/dist/types/src/extensions/posthog/log-processor.js

@@ -0,0 +1,45 @@
+//
+// Copyright 2025 DXOS.org
+//
+import posthog from 'posthog-js';
+import { InvariantViolation } from '@dxos/invariant';
+import { LogLevel, shouldLog } from '@dxos/log';
+export const logProcessor = (config, entry) => {
+    // Don't forward logs from remote sessions.
+    if (!shouldLog(entry, config.captureFilters) || entry.meta?.S?.remoteSessionId) {
+        return;
+    }
+    let capturedError = entry.error;
+    if (capturedError == null && entry.level === LogLevel.ERROR) {
+        capturedError = Object.values(entry.context ?? {}).find((v) => v instanceof Error);
+    }
+    if (!capturedError) {
+        return;
+    }
+    const additionalProperties = {};
+    if (entry.meta) {
+        additionalProperties.transaction = `${getRelativeFilename(entry.meta.F)}:${entry.meta.L}`;
+        if (entry.meta.S?.hostSessionId) {
+            additionalProperties.service_host_issue = true;
+            additionalProperties.service_host_session = entry.meta.S?.hostSessionId;
+        }
+        if (entry.meta.S?.uptimeSeconds != null) {
+            additionalProperties.uptime_seconds = entry.meta.S.uptimeSeconds;
+        }
+    }
+    if (capturedError instanceof InvariantViolation) {
+        additionalProperties.invariant_violation = true;
+    }
+    posthog.captureException(capturedError, additionalProperties);
+};
+const getRelativeFilename = (filename) => {
+    // TODO(burdon): Hack uses "packages" as an anchor (pre-parse NX?)
+    // Including `packages/` part of the path so that excluded paths (e.g. from dist) are clickable in vscode.
+    const match = filename.match(/.+\/(packages\/.+\/.+)/);
+    if (match) {
+        const [, filePath] = match;
+        return filePath;
+    }
+    return filename;
+};
+//# sourceMappingURL=log-processor.js.map

package/dist/types/src/extensions/posthog/log-processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-processor.js","sourceRoot":"","sources":["../../../../../src/extensions/posthog/log-processor.ts"],"names":[],"mappings":"AAAA,EAAE;AACF,0BAA0B;AAC1B,EAAE;AAEF,OAAO,OAAO,MAAM,YAAY,CAAC;AAEjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAiC,QAAQ,EAAqB,SAAS,EAAE,MAAM,WAAW,CAAC;AAElG,MAAM,CAAC,MAAM,YAAY,GAAiB,CAAC,MAAiB,EAAE,KAAe,EAAE,EAAE;IAC/E,2CAA2C;IAC3C,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,cAAc,CAAC,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC;QAC/E,OAAO;IACT,CAAC;IAED,IAAI,aAAa,GAAG,KAAK,CAAC,KAAK,CAAC;IAChC,IAAI,aAAa,IAAI,IAAI,IAAI,KAAK,CAAC,KAAK,KAAK,QAAQ,CAAC,KAAK,EAAE,CAAC;QAC5D,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAc,EAAE,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC;IACjG,CAAC;IAED,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO;IACT,CAAC;IAED,MAAM,oBAAoB,GAA8C,EAAE,CAAC;IAC3E,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QACf,oBAAoB,CAAC,WAAW,GAAG,GAAG,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QAC1F,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC;YAChC,oBAAoB,CAAC,kBAAkB,GAAG,IAAI,CAAC;YAC/C,oBAAoB,CAAC,oBAAoB,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,aAAa,CAAC;QAC1E,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,aAAa,IAAI,IAAI,EAAE,CAAC;YACxC,oBAAoB,CAAC,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC;QACnE,CAAC;IACH,CAAC;IAED,IAAI,aAAa,YAAY,kBAAkB,EAAE,CAAC;QAChD,oBAAoB,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAClD,CAAC;IAED,OAAO,CAAC,gBAAgB,CAAC,aAAa,EAAE,oBAAoB,CAAC,CAAC;AAChE,CAAC,CAAC;AAEF,MAAM,mBAAmB,GAAG,CAAC,QAAgB,EAAE,EAAE;IAC/C,kEAAkE;IAClE,0GAA0G;IAC1G,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;IACvD,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,CAAC,EAAE,QAAQ,CAAC,GAAG,KAAK,CAAC;QAC3B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC"}

package/dist/types/src/extensions/posthog/log-processor.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=log-processor.test.d.ts.map

package/dist/types/src/extensions/posthog/log-processor.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-processor.test.d.ts","sourceRoot":"","sources":["../../../../../src/extensions/posthog/log-processor.test.ts"],"names":[],"mappings":""}

package/dist/types/src/extensions/posthog/log-processor.test.js

@@ -0,0 +1,146 @@
+//
+// Copyright 2025 DXOS.org
+//
+import { beforeEach, describe, expect, test, vi } from 'vitest';
+import { InvariantViolation } from '@dxos/invariant';
+import { LogLevel } from '@dxos/log';
+// Replace the posthog-js module with a stub so log-processor's top-level import resolves to our mock.
+// Dynamic imports are used so that both the mock and log-processor are loaded after vi.mock is hoisted.
+vi.mock('posthog-js', () => ({
+    default: {
+        captureException: vi.fn(),
+    },
+}));
+const { default: posthog } = await import('posthog-js');
+const { logProcessor } = await import('./log-processor');
+const baseConfig = {
+    options: {},
+    captureFilters: [{ level: LogLevel.WARN }],
+    processors: [],
+};
+const createEntry = (overrides = {}) => ({
+    level: LogLevel.ERROR,
+    message: 'test error',
+    ...overrides,
+});
+describe('logProcessor', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    test('skips entries that do not pass capture filters', () => {
+        const entry = createEntry({ level: LogLevel.DEBUG });
+        logProcessor(baseConfig, entry);
+        expect(posthog.captureException).not.toHaveBeenCalled();
+    });
+    test('skips entries from remote sessions', () => {
+        const entry = createEntry({
+            error: new Error('test'),
+            meta: { F: 'test.ts', L: 1, S: { remoteSessionId: 'remote-123' } },
+        });
+        logProcessor(baseConfig, entry);
+        expect(posthog.captureException).not.toHaveBeenCalled();
+    });
+    test('skips entries without errors', () => {
+        const entry = createEntry({ error: undefined, context: {} });
+        logProcessor(baseConfig, entry);
+        expect(posthog.captureException).not.toHaveBeenCalled();
+    });
+    test('captures error from entry.error', () => {
+        const error = new Error('direct error');
+        const entry = createEntry({
+            error,
+            meta: { F: 'packages/sdk/observability/src/test.ts', L: 42, S: undefined },
+        });
+        logProcessor(baseConfig, entry);
+        expect(posthog.captureException).toHaveBeenCalledWith(error, expect.objectContaining({
+            transaction: 'packages/sdk/observability/src/test.ts:42',
+        }));
+    });
+    test('captures error from context when level is ERROR but no entry.error', () => {
+        const contextError = new Error('context error');
+        const entry = createEntry({
+            level: LogLevel.ERROR,
+            error: undefined,
+            context: { someKey: contextError },
+            meta: { F: 'test.ts', L: 10, S: undefined },
+        });
+        logProcessor(baseConfig, entry);
+        expect(posthog.captureException).toHaveBeenCalledWith(contextError, expect.any(Object));
+    });
+    test('sets transaction from file:line metadata', () => {
+        const entry = createEntry({
+            error: new Error('err'),
+            meta: { F: '/home/user/project/packages/sdk/observability/src/index.ts', L: 99, S: undefined },
+        });
+        logProcessor(baseConfig, entry);
+        expect(posthog.captureException).toHaveBeenCalledWith(expect.any(Error), expect.objectContaining({
+            transaction: 'packages/sdk/observability/src/index.ts:99',
+        }));
+    });
+    test('sets service_host_issue/session for worker entries', () => {
+        const entry = createEntry({
+            error: new Error('worker err'),
+            meta: { F: 'test.ts', L: 1, S: { hostSessionId: 'host-abc' } },
+        });
+        logProcessor(baseConfig, entry);
+        expect(posthog.captureException).toHaveBeenCalledWith(expect.any(Error), expect.objectContaining({
+            service_host_issue: true,
+            service_host_session: 'host-abc',
+        }));
+    });
+    test('sets uptime_seconds from metadata', () => {
+        const entry = createEntry({
+            error: new Error('err'),
+            meta: { F: 'test.ts', L: 1, S: { uptimeSeconds: 123 } },
+        });
+        logProcessor(baseConfig, entry);
+        expect(posthog.captureException).toHaveBeenCalledWith(expect.any(Error), expect.objectContaining({
+            uptime_seconds: 123,
+        }));
+    });
+    test('sets invariant_violation flag for InvariantViolation errors', () => {
+        const error = new InvariantViolation('broken invariant');
+        const entry = createEntry({
+            error,
+            meta: { F: 'test.ts', L: 1, S: undefined },
+        });
+        logProcessor(baseConfig, entry);
+        expect(posthog.captureException).toHaveBeenCalledWith(error, expect.objectContaining({
+            invariant_violation: true,
+        }));
+    });
+    test('does not set invariant_violation for normal errors', () => {
+        const error = new Error('normal error');
+        const entry = createEntry({
+            error,
+            meta: { F: 'test.ts', L: 1, S: undefined },
+        });
+        logProcessor(baseConfig, entry);
+        const callArgs = vi.mocked(posthog.captureException).mock.calls[0];
+        expect(callArgs[1]).not.toHaveProperty('invariant_violation');
+    });
+});
+describe('getRelativeFilename', () => {
+    // We test this indirectly through the transaction property set by logProcessor.
+    test('extracts relative path from absolute path containing packages/', () => {
+        const entry = createEntry({
+            error: new Error('err'),
+            meta: { F: '/home/user/code/packages/sdk/observability/src/file.ts', L: 5, S: undefined },
+        });
+        logProcessor(baseConfig, entry);
+        expect(posthog.captureException).toHaveBeenCalledWith(expect.any(Error), expect.objectContaining({
+            transaction: 'packages/sdk/observability/src/file.ts:5',
+        }));
+    });
+    test('returns original filename if no match', () => {
+        const entry = createEntry({
+            error: new Error('err'),
+            meta: { F: 'no-packages-here.ts', L: 1, S: undefined },
+        });
+        logProcessor(baseConfig, entry);
+        expect(posthog.captureException).toHaveBeenCalledWith(expect.any(Error), expect.objectContaining({
+            transaction: 'no-packages-here.ts:1',
+        }));
+    });
+});
+//# sourceMappingURL=log-processor.test.js.map

package/dist/types/src/extensions/posthog/log-processor.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-processor.test.js","sourceRoot":"","sources":["../../../../../src/extensions/posthog/log-processor.test.ts"],"names":[],"mappings":"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"}

package/dist/types/src/extensions/stub.d.ts

@@ -0,0 +1,3 @@
+import { type Extension } from '../observability-extension';
+export declare const stubExtension: Extension;
+//# sourceMappingURL=stub.d.ts.map

package/dist/types/src/extensions/stub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub.d.ts","sourceRoot":"","sources":["../../../../src/extensions/stub.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAE5D,eAAO,MAAM,aAAa,EAAE,SAU3B,CAAC"}

package/dist/types/src/extensions/stub.js

@@ -0,0 +1,16 @@
+//
+// Copyright 2025 DXOS.org
+//
+import * as Effect from 'effect/Effect';
+export const stubExtension = {
+    initialize: () => Effect.succeed(undefined),
+    enable: () => Effect.succeed(undefined),
+    disable: () => Effect.succeed(undefined),
+    flush: () => Effect.succeed(undefined),
+    setTags: () => undefined,
+    get enabled() {
+        return true;
+    },
+    apis: [],
+};
+//# sourceMappingURL=stub.js.map

package/dist/types/src/extensions/stub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub.js","sourceRoot":"","sources":["../../../../src/extensions/stub.ts"],"names":[],"mappings":"AAAA,EAAE;AACF,0BAA0B;AAC1B,EAAE;AAEF,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAIxC,MAAM,CAAC,MAAM,aAAa,GAAc;IACtC,UAAU,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC;IAC3C,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC;IACvC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC;IACxC,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC;IACtC,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS;IACxB,IAAI,OAAO;QACT,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,EAAE,EAAE;CACT,CAAC"}

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

@@ -1,3 +1,5 @@
-export * from './helpers';
-export * from './observability';
+export * from './log-buffer';
+export * as Observability from './observability';
+export * as ObservabilityExtension from './observability-extension';
+export * as ObservabilityProvider from './providers';
 //# 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":"AAIA,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,cAAc,CAAC;AAC7B,OAAO,KAAK,aAAa,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,sBAAsB,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,qBAAqB,MAAM,aAAa,CAAC"}

package/dist/types/src/index.js

@@ -1,6 +1,8 @@
 //
-// Copyright 2023 DXOS.org
+// Copyright 2025 DXOS.org
 //
-export * from './helpers';
-export * from './observability';
+export * from './log-buffer';
+export * as Observability from './observability';
+export * as ObservabilityExtension from './observability-extension';
+export * as ObservabilityProvider from './providers';
 //# sourceMappingURL=index.js.map

package/dist/types/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,EAAE;AACF,0BAA0B;AAC1B,EAAE;AAEF,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,EAAE;AACF,0BAA0B;AAC1B,EAAE;AAEF,cAAc,cAAc,CAAC;AAC7B,OAAO,KAAK,aAAa,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,sBAAsB,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,qBAAqB,MAAM,aAAa,CAAC"}