@cat-factory/observability-langfuse 0.10.106 → 0.11.0

package/README.md

@@ -8,14 +8,23 @@ when wired into a facade every LLM call: container-agent calls (through the LLM
 agent): surfaces in Langfuse as a generation grouped under its run's trace, plus
 optional container tool spans.
 
-## Why fetch-only
-
-The sink talks to Langfuse's public **ingestion API** (`POST /api/public/ingestion`,
-HTTP Basic auth, batched JSON events) using only the global `fetch` / `crypto` /
-`btoa`. It deliberately does **not** depend on the official `langfuse` Node SDK or any
-`@opentelemetry/*` package: those rely on Node-only APIs that are unavailable on the
-Cloudflare Worker runtime (workerd). Using the raw ingestion API keeps the sink
-byte-for-byte identical on both the Worker and Node facades.
+## What it is: the OTLP exporter, pointed at Langfuse
+
+The sink is `@cat-factory/observability-otel`'s fetch-based OTLP/HTTP exporter with three
+Langfuse-specific decisions in its constructor: the endpoint `{baseUrl}/api/public/otel`
+(onto which the exporter appends `/v1/traces`), HTTP Basic auth over the key pair, and the
+`x-langfuse-ingestion-version: 4` header that v4 needs for real-time ingestion. Metrics
+are off, because Langfuse implements the traces signal only.
+
+It used to be its own client speaking Langfuse's batch **ingestion API**
+(`POST /api/public/ingestion`). That API is deprecated, sunsets on Langfuse Cloud on
+**2026-11-16**, and the `trace-create` / `generation-create` / `span-create` events it sent
+are already unsupported on the v4 data model. OTLP is the supported path and this repo
+already spoke it.
+
+Neither package depends on the official `langfuse` Node SDK or on any `@opentelemetry/*`
+package: those rely on Node-only APIs unavailable on the Cloudflare Worker runtime
+(workerd), which is what keeps the sink byte-for-byte identical on both facades.
 
 ## Behaviour
 

package/dist/index.d.ts

@@ -1,4 +1,5 @@
-import type { LlmGenerationEvent, LlmToolSpan, LlmToolSpanContext, LlmTraceSink, Logger } from '@cat-factory/kernel';
+import type { Logger } from '@cat-factory/kernel';
+import { OtelTraceSink } from '@cat-factory/observability-otel';
 export interface LangfuseSinkConfig {
     /** Langfuse public key (`pk-lf-…`). */
     publicKey: string;
@@ -6,20 +7,23 @@ export interface LangfuseSinkConfig {
     secretKey: string;
     /** Host of the Langfuse instance. Default: Langfuse Cloud (`https://cloud.langfuse.com`). */
     baseUrl?: string;
+    /** OTLP resource `service.name`, as it appears on the exported spans. */
+    serviceName?: string;
     /** Optional logger for swallowed errors. */
     logger?: Logger;
     /** Injectable fetch (tests); defaults to the global `fetch`. */
     fetchImpl?: typeof fetch;
 }
-export declare class LangfuseTraceSink implements LlmTraceSink {
-    private readonly endpoint;
-    private readonly authorization;
-    private readonly logger?;
-    private readonly fetchImpl;
+/**
+ * The OTLP exporter, configured for a Langfuse project.
+ *
+ * A subclass rather than a factory returning the base type, because a facade composing several
+ * sinks has to be able to say WHICH destination it wired: `CompositeTraceSink` holds a list, and
+ * two members of the same class are indistinguishable to the wiring assertions that keep the
+ * facades symmetric.
+ */
+export declare class LangfuseTraceSink extends OtelTraceSink {
     constructor(config: LangfuseSinkConfig);
-    recordGeneration(event: LlmGenerationEvent): Promise<void>;
-    recordToolSpans(context: LlmToolSpanContext, spans: LlmToolSpan[]): Promise<void>;
-    private send;
 }
 /** Build a {@link LangfuseTraceSink}. Returns the opt-in sink wired into a facade. */
 export declare function createLangfuseSink(config: LangfuseSinkConfig): LangfuseTraceSink;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,kBAAkB,EAClB,WAAW,EACX,kBAAkB,EAClB,YAAY,EACZ,MAAM,EACP,MAAM,qBAAqB,CAAA;AAkD5B,MAAM,WAAW,kBAAkB;IACjC,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAA;IACjB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAA;IACjB,6FAA6F;IAC7F,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,gEAAgE;IAChE,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CACzB;AAkBD,qBAAa,iBAAkB,YAAW,YAAY;IACpD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAQ;IACjC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAQ;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAc;IAExC,YAAY,MAAM,EAAE,kBAAkB,EAMrC;IAEK,gBAAgB,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0D/D;IAEK,eAAe,CAAC,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAkCtF;YAEa,IAAI;CA4BnB;AAED,sFAAsF;AACtF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,iBAAiB,CAEhF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAA;AAuC/D,MAAM,WAAW,kBAAkB;IACjC,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAA;IACjB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAA;IACjB,6FAA6F;IAC7F,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,yEAAyE;IACzE,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,gEAAgE;IAChE,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CACzB;AAMD;;;;;;;GAOG;AACH,qBAAa,iBAAkB,SAAQ,aAAa;IAClD,YAAY,MAAM,EAAE,kBAAkB,EAarC;CACF;AAED,sFAAsF;AACtF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,iBAAiB,CAEhF"}

package/dist/index.js

@@ -1,192 +1,63 @@
-import { getErrorMessage } from '@cat-factory/kernel';
-// A fetch-based Langfuse trace sink. It speaks Langfuse's public **ingestion API**
-// (`POST /api/public/ingestion`, HTTP Basic auth = public:secret key, batched JSON
-// events) using only the global `fetch`/`crypto`/`btoa` — NO `langfuse` Node SDK and
-// NO `@opentelemetry/*`, both of which depend on Node-only APIs that are unavailable on
-// the Cloudflare Worker runtime (workerd). This keeps the sink byte-for-byte identical
-// across the Worker and Node facades, which is the whole reason it exists as its own
-// package: see `LlmTraceSink` in `@cat-factory/kernel`.
+import { OtelTraceSink } from '@cat-factory/observability-otel';
+// The opt-in Langfuse trace sink, which is now the OTLP exporter pointed at Langfuse.
 //
-// Observability must never break the product, so every method swallows its own errors
-// (logging at most a warning) and the caller additionally schedules the call off the
-// response path. A failed flush drops that batch; it never propagates.
+// It used to be its own fetch client speaking Langfuse's ingestion API
+// (`POST /api/public/ingestion`, batched `trace-create` / `generation-create` / `span-create`
+// events). That API is deprecated and sunsets on Langfuse Cloud on 2026-11-16, and the three event
+// types this sent are already unsupported on the v4 data model: "Trace, span, and generation events
+// via the legacy batch ingestion API are not supported on the v4 data model". The supported path is
+// OTLP, which this repo already speaks: `@cat-factory/observability-otel` hand-writes an OTLP/HTTP
+// JSON exporter for exactly the same three shapes, so the migration retargets an encoder rather
+// than writing one, and Langfuse becomes a DESTINATION instead of a second recording path.
 //
-// Each `recordGeneration` posts its own small ingestion batch rather than buffering
-// across calls. This is deliberate: the Worker runtime is stateless per request (there
-// is no durable cross-request buffer to flush, and a `waitUntil`-scheduled POST can't
-// outlive its request), so a per-call POST is the only shape that stays identical across
-// the Worker and Node facades. Tool spans, which the backend already accumulates per
-// poll, ARE sent as one batch. Langfuse's ingestion API is built for this volume.
+// What differs from a plain collector, and it is only these three things:
+//   - the endpoint is `{base}/api/public/otel`, so the exporter's own `/v1/traces` append lands on
+//     Langfuse's documented signal path;
+//   - auth is HTTP Basic over `publicKey:secretKey`, the same credential pair as before;
+//   - `x-langfuse-ingestion-version: 4` is required for real-time ingestion on v4. Without it the
+//     data still arrives, up to ten minutes late, which is the kind of delay that reads as data
+//     loss to whoever is watching a run.
 //
-// IMPACT ANALYSIS — why per-call POST is safe for the execution hot path:
-//   - NOT on the hot path. The proxied feeder runs under `executionCtx.waitUntil`
-//     (`LlmProxyController`), scheduled AFTER the container's chat-completion response
-//     is returned (on Node `waitUntil` is a plain fire-and-forget); the inline feeder
-//     (`InstrumentedModelProvider`) dispatches AFTER `generateText` resolves. Inside
-//     `LlmObservabilityService.record` the POST is then dispatched detached (not
-//     awaited), so even the `waitUntil` window never blocks on the Langfuse round trip.
-//     The only synchronous cost added to any path is one object build + `JSON.stringify`
-//     — microseconds, never the network call.
-//   - NOT a source of execution brittleness. Every error is swallowed + logged, the
-//     fetch is bounded by SEND_TIMEOUT_MS, and nothing in the run lifecycle reads the
-//     sink's result — a Langfuse outage / slowness / 4xx drops a batch and nothing else.
-//   - The costs that DO exist are telemetry-side, not run-side: +1 detached subrequest
-//     per proxy invocation (~2 of the Worker's 1000-subrequest budget), negligible
-//     `waitUntil` CPU (I/O-bound, timeout-capped), and N calls ⇒ N POSTs — a very chatty
-//     run could brush Langfuse ingestion rate limits and drop some batches, degrading
-//     telemetry COMPLETENESS only, never the run. (Tool spans are batched per poll, so
-//     they don't multiply.)
+// METRICS ARE OFF because Langfuse implements the traces signal only. Posting `/v1/metrics` there
+// would 404 once per generation, a per-call failure that says nothing about the deployment.
+//
+// The contract the two sinks share is unchanged and is documented on the exporter: observability
+// must never break the product, so every method swallows its own errors (logging at most a
+// warning), each POST is timeout-bounded, and a dropped batch is the worst case. No `langfuse` SDK
+// and no `@opentelemetry/*`: both depend on Node-only APIs that are unavailable on workerd, which
+// is why the fetch-based exporter exists at all.
+//
+// Read 2026-08-18: https://langfuse.com/docs/api, https://langfuse.com/docs/compatibility,
+// https://langfuse.com/integrations/native/opentelemetry
+/** Langfuse Cloud EU. The US, Japan and HIPAA clouds are the same shape on their own hosts. */
 const DEFAULT_BASE_URL = 'https://cloud.langfuse.com';
-/**
- * Hard ceiling on a single ingestion POST. Observability must never tie up the LLM
- * path: the proxied feeder records under the platform's `waitUntil` budget and the
- * inline feeder dispatches without awaiting, so a hung Langfuse endpoint must abort
- * rather than dangle. A dropped batch is the documented best-effort worst case.
- */
-const SEND_TIMEOUT_MS = 10_000;
-function iso(ms) {
-    return new Date(ms).toISOString();
-}
+/** Langfuse's OTLP path, onto which the exporter appends the `/v1/traces` signal segment. */
+const OTEL_PATH = '/api/public/otel';
 function basicAuth(publicKey, secretKey) {
     return `Basic ${btoa(`${publicKey}:${secretKey}`)}`;
 }
-export class LangfuseTraceSink {
-    endpoint;
-    authorization;
-    logger;
-    fetchImpl;
+/**
+ * The OTLP exporter, configured for a Langfuse project.
+ *
+ * A subclass rather than a factory returning the base type, because a facade composing several
+ * sinks has to be able to say WHICH destination it wired: `CompositeTraceSink` holds a list, and
+ * two members of the same class are indistinguishable to the wiring assertions that keep the
+ * facades symmetric.
+ */
+export class LangfuseTraceSink extends OtelTraceSink {
     constructor(config) {
         const base = (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, '');
-        this.endpoint = `${base}/api/public/ingestion`;
-        this.authorization = basicAuth(config.publicKey, config.secretKey);
-        this.logger = config.logger;
-        this.fetchImpl = config.fetchImpl ?? fetch;
-    }
-    async recordGeneration(event) {
-        // Group every call of a run under one trace (keyed by the execution id); inline
-        // single-shot calls (no execution) become their own standalone trace.
-        const traceId = event.executionId ?? crypto.randomUUID();
-        const generation = {
-            id: crypto.randomUUID(),
-            traceId,
-            name: event.agentKind,
-            startTime: iso(event.startedAt),
-            endTime: iso(event.endedAt),
-            model: event.model,
-            usage: {
-                // Langfuse's `input` is the whole input side, so the three orthogonal classes are
-                // summed back for it; the split rides the metadata below, where a cache-read-dominated
-                // generation is still distinguishable from a fresh one.
-                input: event.promptTokens + event.cacheReadTokens + event.cacheWriteTokens,
-                output: event.completionTokens,
-                total: event.totalTokens,
-                unit: 'TOKENS',
-            },
-            level: event.ok ? 'DEFAULT' : 'ERROR',
-            metadata: {
-                provider: event.provider,
-                agentKind: event.agentKind,
-                finishReason: event.finishReason,
-                freshInputTokens: event.promptTokens,
-                cacheReadTokens: event.cacheReadTokens,
-                cacheWriteTokens: event.cacheWriteTokens,
-                workspaceId: event.workspaceId,
-            },
-        };
-        // Prompt/response bodies are present only when prompt recording is on (the same
-        // `LLM_RECORD_PROMPTS` switch the local store honours): omit empty bodies entirely.
-        if (event.input)
-            generation.input = event.input;
-        if (event.output)
-            generation.output = event.output;
-        if (event.errorMessage)
-            generation.statusMessage = event.errorMessage;
-        await this.send([
-            {
-                id: crypto.randomUUID(),
-                type: 'trace-create',
-                timestamp: iso(event.endedAt),
-                body: {
-                    id: traceId,
-                    // A run trace is upserted by every call it groups, so keep the trace body
-                    // stable across them: the per-call agent kind lives on each generation
-                    // (its `name` + metadata), NOT as a trace tag that the next call would clobber.
-                    name: event.executionId ? `run ${event.executionId}` : event.agentKind,
-                    metadata: { workspaceId: event.workspaceId },
-                },
-            },
-            {
-                id: crypto.randomUUID(),
-                type: 'generation-create',
-                timestamp: iso(event.endedAt),
-                body: generation,
+        super({
+            endpoint: `${base}${OTEL_PATH}`,
+            exportMetrics: false,
+            headers: {
+                authorization: basicAuth(config.publicKey, config.secretKey),
+                'x-langfuse-ingestion-version': '4',
             },
-        ]);
-    }
-    async recordToolSpans(context, spans) {
-        // Tool spans are only meaningful as children of a run's trace.
-        if (!context.executionId || spans.length === 0)
-            return;
-        const traceId = context.executionId;
-        const batch = spans.map((span) => ({
-            id: crypto.randomUUID(),
-            type: 'span-create',
-            timestamp: iso(span.endedAt),
-            body: {
-                id: crypto.randomUUID(),
-                traceId,
-                name: span.tool,
-                startTime: iso(span.startedAt),
-                endTime: iso(span.endedAt),
-                level: span.ok ? 'DEFAULT' : 'ERROR',
-                // The call's arguments and result go in Langfuse's own input/output slots rather than
-                // metadata, so the trajectory reads in the UI the way a generation's prompt does.
-                // Present only when the double gate allowed capture (upstream blanks them otherwise).
-                ...(span.args ? { input: span.args } : {}),
-                ...(span.result ? { output: span.result } : {}),
-                metadata: {
-                    agentKind: context.agentKind,
-                    // The ordinal a trajectory orders by: a tool loop routinely fires several calls inside
-                    // one millisecond, so start time alone cannot sequence them. The dispatch rides with
-                    // it because `seq` restarts at zero on each one, so a re-run's spans would otherwise
-                    // be indistinguishable from the first round's.
-                    ...(context.jobId ? { jobId: context.jobId } : {}),
-                    ...(span.seq !== undefined ? { seq: span.seq } : {}),
-                    ...(span.argsDropped ? { argsDroppedChars: span.argsDropped } : {}),
-                    ...(span.resultDropped ? { resultDroppedChars: span.resultDropped } : {}),
-                },
-            },
-        }));
-        await this.send(batch);
-    }
-    async send(batch) {
-        try {
-            const res = await this.fetchImpl(this.endpoint, {
-                method: 'POST',
-                headers: {
-                    'content-type': 'application/json',
-                    authorization: this.authorization,
-                },
-                body: JSON.stringify({ batch }),
-                // Bound the request so a hung endpoint can't tie up the caller's waitUntil
-                // budget; an abort lands in the catch below and drops the batch (best-effort).
-                signal: AbortSignal.timeout(SEND_TIMEOUT_MS),
-            });
-            // 207 = partial success (per-event errors in the body); anything else non-2xx is
-            // a hard failure. Either way we only log — observability never breaks the caller.
-            if (!res.ok && res.status !== 207) {
-                this.logger?.warn('langfuse: ingestion rejected batch', {
-                    scope: 'langfuse',
-                    status: res.status,
-                });
-            }
-        }
-        catch (err) {
-            this.logger?.warn('langfuse: failed to post ingestion batch', {
-                scope: 'langfuse',
-                err: getErrorMessage(err),
-            });
-        }
+            ...(config.serviceName ? { serviceName: config.serviceName } : {}),
+            ...(config.logger ? { logger: config.logger } : {}),
+            ...(config.fetchImpl ? { fetchImpl: config.fetchImpl } : {}),
+        });
     }
 }
 /** Build a {@link LangfuseTraceSink}. Returns the opt-in sink wired into a facade. */

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAA;AAE/D,sFAAsF;AACtF,EAAE;AACF,uEAAuE;AACvE,8FAA8F;AAC9F,mGAAmG;AACnG,oGAAoG;AACpG,oGAAoG;AACpG,mGAAmG;AACnG,gGAAgG;AAChG,2FAA2F;AAC3F,EAAE;AACF,0EAA0E;AAC1E,mGAAmG;AACnG,yCAAyC;AACzC,yFAAyF;AACzF,kGAAkG;AAClG,gGAAgG;AAChG,yCAAyC;AACzC,EAAE;AACF,kGAAkG;AAClG,4FAA4F;AAC5F,EAAE;AACF,iGAAiG;AACjG,2FAA2F;AAC3F,mGAAmG;AACnG,kGAAkG;AAClG,iDAAiD;AACjD,EAAE;AACF,2FAA2F;AAC3F,yDAAyD;AAEzD,+FAA+F;AAC/F,MAAM,gBAAgB,GAAG,4BAA4B,CAAA;AAErD,6FAA6F;AAC7F,MAAM,SAAS,GAAG,kBAAkB,CAAA;AAiBpC,SAAS,SAAS,CAAC,SAAiB,EAAE,SAAiB;IACrD,OAAO,SAAS,IAAI,CAAC,GAAG,SAAS,IAAI,SAAS,EAAE,CAAC,EAAE,CAAA;AACrD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,iBAAkB,SAAQ,aAAa;IAClD,YAAY,MAA0B;QACpC,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,gBAAgB,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;QACrE,KAAK,CAAC;YACJ,QAAQ,EAAE,GAAG,IAAI,GAAG,SAAS,EAAE;YAC/B,aAAa,EAAE,KAAK;YACpB,OAAO,EAAE;gBACP,aAAa,EAAE,SAAS,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC;gBAC5D,8BAA8B,EAAE,GAAG;aACpC;YACD,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAClE,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnD,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC7D,CAAC,CAAA;IACJ,CAAC;CACF;AAED,sFAAsF;AACtF,MAAM,UAAU,kBAAkB,CAAC,MAA0B;IAC3D,OAAO,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAA;AACtC,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cat-factory/observability-langfuse",
-  "version": "0.10.106",
-  "description": "Opt-in Langfuse trace sink for the Agent Architecture Board. A fetch-based LlmTraceSink that streams LLM generations (and container tool spans) to Langfuse's ingestion API — runs unchanged on both the Cloudflare Worker (workerd) and Node facades.",
+  "version": "0.11.0",
+  "description": "Opt-in Langfuse trace sink for the Agent Architecture Board. The workerd-safe OTLP/HTTP exporter pointed at Langfuse's OpenTelemetry endpoint, so LLM generations and container tool spans stream unchanged on both the Cloudflare Worker and Node facades.",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/kibertoad/cat-factory.git",
@@ -24,7 +24,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@cat-factory/kernel": "0.310.0"
+    "@cat-factory/kernel": "0.313.0",
+    "@cat-factory/observability-otel": "0.22.0"
   },
   "devDependencies": {
     "typescript": "7.0.2",