@narumitw/pi-otel 0.0.0-stage → 0.54.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (57) hide show
  1. package/CHANGELOG.md +162 -0
  2. package/LICENSE +21 -0
  3. package/README.md +368 -2
  4. package/dist/chunks/chunk-DSQBXICE.ts +150 -0
  5. package/dist/chunks/chunk-DSQBXICE.ts.map +7 -0
  6. package/dist/chunks/runtime-X3YFJUNH.ts +404 -0
  7. package/dist/chunks/runtime-X3YFJUNH.ts.map +7 -0
  8. package/dist/config.d.ts +36 -0
  9. package/dist/durable-projection.d.ts +9 -0
  10. package/dist/durable-recorder.d.ts +57 -0
  11. package/dist/durable-state.d.ts +43 -0
  12. package/dist/durable.d.ts +25 -0
  13. package/dist/durable.js +897 -0
  14. package/dist/durable.js.map +7 -0
  15. package/dist/git.d.ts +5 -0
  16. package/dist/index.d.ts +2 -0
  17. package/dist/index.js +1732 -0
  18. package/dist/index.js.map +7 -0
  19. package/dist/index.ts +1874 -0
  20. package/dist/index.ts.map +7 -0
  21. package/dist/library-chunks/chunk-7DN64UHE.js +158 -0
  22. package/dist/library-chunks/chunk-7DN64UHE.js.map +7 -0
  23. package/dist/library-chunks/chunk-7JGM5RS3.js +72 -0
  24. package/dist/library-chunks/chunk-7JGM5RS3.js.map +7 -0
  25. package/dist/library-chunks/chunk-BBL32ZV5.js +84 -0
  26. package/dist/library-chunks/chunk-BBL32ZV5.js.map +7 -0
  27. package/dist/library-chunks/runtime-554E6FVF.js +406 -0
  28. package/dist/library-chunks/runtime-554E6FVF.js.map +7 -0
  29. package/dist/otel.d.ts +13 -0
  30. package/dist/otlp-settings.d.ts +8 -0
  31. package/dist/pi-session.d.ts +43 -0
  32. package/dist/public-api.d.ts +2 -0
  33. package/dist/runtime-api.d.ts +6 -0
  34. package/dist/runtime-core.d.ts +26 -0
  35. package/dist/runtime-defaults.d.ts +1 -0
  36. package/dist/runtime.d.ts +26 -0
  37. package/dist/sanitizer.d.ts +2 -0
  38. package/dist/tracing.d.ts +198 -0
  39. package/docs/durable.md +128 -0
  40. package/package.json +87 -4
  41. package/src/config.ts +330 -0
  42. package/src/durable-projection.ts +112 -0
  43. package/src/durable-recorder.ts +539 -0
  44. package/src/durable-state.ts +135 -0
  45. package/src/durable.ts +364 -0
  46. package/src/git.ts +64 -0
  47. package/src/index.ts +12 -0
  48. package/src/otel.ts +397 -0
  49. package/src/otlp-settings.ts +72 -0
  50. package/src/pi-session.ts +570 -0
  51. package/src/public-api.ts +13 -0
  52. package/src/runtime-api.ts +16 -0
  53. package/src/runtime-core.ts +114 -0
  54. package/src/runtime-defaults.ts +1 -0
  55. package/src/runtime.ts +509 -0
  56. package/src/sanitizer.ts +157 -0
  57. package/src/tracing.ts +940 -0
@@ -0,0 +1,84 @@
1
+ // @generated by scripts/build-runtime.mjs; do not edit.
2
+ // @ts-nocheck -- the generated entry uses a .ts extension for Pi's Jiti loader.
3
+
4
+ // src/runtime-core.ts
5
+ var RUNTIME_INTERNAL_KEY = /* @__PURE__ */ Symbol.for("@narumitw/pi-langfuse/runtime-internal/v2");
6
+ var ManagedLangfuseRuntime = class {
7
+ constructor(backend) {
8
+ this.backend = backend;
9
+ }
10
+ backend;
11
+ state = "open";
12
+ sessionDisposers = /* @__PURE__ */ new Set();
13
+ flushQueue = Promise.resolve();
14
+ shutdownPromise;
15
+ get closed() {
16
+ return this.state !== "open";
17
+ }
18
+ registerSession(disposer) {
19
+ if (this.state !== "open") throw new Error("Langfuse runtime is shutting down or already closed.");
20
+ this.sessionDisposers.add(disposer);
21
+ return () => this.sessionDisposers.delete(disposer);
22
+ }
23
+ flush() {
24
+ if (this.state !== "open") {
25
+ return Promise.reject(new Error("Langfuse runtime is shutting down or already closed."));
26
+ }
27
+ const operation = this.flushQueue.then(() => this.backend.forceFlush());
28
+ this.flushQueue = operation.then(
29
+ () => void 0,
30
+ () => void 0
31
+ );
32
+ return operation;
33
+ }
34
+ shutdown() {
35
+ if (this.shutdownPromise) return this.shutdownPromise;
36
+ this.state = "closing";
37
+ this.shutdownPromise = Promise.resolve().then(() => this.shutdownNow());
38
+ return this.shutdownPromise;
39
+ }
40
+ async shutdownNow() {
41
+ const errors = [];
42
+ for (const dispose of [...this.sessionDisposers]) {
43
+ try {
44
+ await dispose("Langfuse runtime shut down before the Pi session was disposed.");
45
+ } catch (error) {
46
+ errors.push(error);
47
+ }
48
+ }
49
+ this.sessionDisposers.clear();
50
+ await this.flushQueue;
51
+ try {
52
+ await this.backend.forceFlush();
53
+ } catch (error) {
54
+ errors.push(error);
55
+ }
56
+ try {
57
+ await this.backend.shutdown();
58
+ } catch (error) {
59
+ errors.push(error);
60
+ } finally {
61
+ this.state = "closed";
62
+ }
63
+ if (errors.length === 1) throw errors[0];
64
+ if (errors.length > 1) throw new AggregateError(errors, "Langfuse runtime shutdown failed.");
65
+ }
66
+ };
67
+ function getLangfuseRuntimeInternal(runtime) {
68
+ const internal = runtime[RUNTIME_INTERNAL_KEY];
69
+ if (!internal) throw new Error("The tracing runtime was not created by this package.");
70
+ return internal;
71
+ }
72
+ function createLangfuseRuntimeFromBackend(backend) {
73
+ return registerLangfuseRuntime(new ManagedLangfuseRuntime(backend));
74
+ }
75
+ function registerLangfuseRuntime(runtime) {
76
+ Object.defineProperty(runtime, RUNTIME_INTERNAL_KEY, { value: runtime });
77
+ return runtime;
78
+ }
79
+
80
+ export {
81
+ getLangfuseRuntimeInternal,
82
+ createLangfuseRuntimeFromBackend
83
+ };
84
+ //# sourceMappingURL=chunk-BBL32ZV5.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../src/runtime-core.ts"],
4
+ "sourcesContent": ["import type { TraceBackend } from \"./tracing.js\";\n\nexport interface LangfuseRuntimeConfig {\n publicKey?: string;\n secretKey?: string;\n baseUrl?: string;\n environment?: string;\n release?: string;\n}\n\nexport interface CreateLangfuseRuntimeOptions {\n config?: LangfuseRuntimeConfig;\n env?: NodeJS.ProcessEnv | false;\n}\n\nexport interface LangfuseRuntime {\n readonly closed: boolean;\n flush(): Promise<void>;\n shutdown(): Promise<void>;\n}\n\ntype RuntimeSessionDisposer = (statusMessage: string) => void | Promise<void>;\n\nexport interface LangfuseRuntimeInternal extends LangfuseRuntime {\n readonly backend: TraceBackend;\n registerSession(disposer: RuntimeSessionDisposer): () => void;\n}\n\nconst RUNTIME_INTERNAL_KEY = Symbol.for(\"@narumitw/pi-langfuse/runtime-internal/v2\");\n\nclass ManagedLangfuseRuntime implements LangfuseRuntimeInternal {\n private state: \"open\" | \"closing\" | \"closed\" = \"open\";\n private readonly sessionDisposers = new Set<RuntimeSessionDisposer>();\n private flushQueue = Promise.resolve();\n private shutdownPromise: Promise<void> | undefined;\n\n constructor(readonly backend: TraceBackend) {}\n\n get closed(): boolean {\n return this.state !== \"open\";\n }\n\n registerSession(disposer: RuntimeSessionDisposer): () => void {\n if (this.state !== \"open\") throw new Error(\"Langfuse runtime is shutting down or already closed.\");\n this.sessionDisposers.add(disposer);\n return () => this.sessionDisposers.delete(disposer);\n }\n\n flush(): Promise<void> {\n if (this.state !== \"open\") {\n return Promise.reject(new Error(\"Langfuse runtime is shutting down or already closed.\"));\n }\n const operation = this.flushQueue.then(() => this.backend.forceFlush());\n this.flushQueue = operation.then(\n () => undefined,\n () => undefined,\n );\n return operation;\n }\n\n shutdown(): Promise<void> {\n if (this.shutdownPromise) return this.shutdownPromise;\n this.state = \"closing\";\n // Publish the promise before invoking controller callbacks, which can reenter shutdown().\n this.shutdownPromise = Promise.resolve().then(() => this.shutdownNow());\n return this.shutdownPromise;\n }\n\n private async shutdownNow(): Promise<void> {\n const errors: unknown[] = [];\n for (const dispose of [...this.sessionDisposers]) {\n try {\n await dispose(\"Langfuse runtime shut down before the Pi session was disposed.\");\n } catch (error) {\n errors.push(error);\n }\n }\n this.sessionDisposers.clear();\n\n await this.flushQueue;\n try {\n await this.backend.forceFlush();\n } catch (error) {\n errors.push(error);\n }\n try {\n await this.backend.shutdown();\n } catch (error) {\n errors.push(error);\n } finally {\n this.state = \"closed\";\n }\n\n if (errors.length === 1) throw errors[0];\n if (errors.length > 1) throw new AggregateError(errors, \"Langfuse runtime shutdown failed.\");\n }\n}\n\nexport function getLangfuseRuntimeInternal(runtime: LangfuseRuntime): LangfuseRuntimeInternal {\n const internal = (runtime as LangfuseRuntime & { [key: symbol]: LangfuseRuntimeInternal | undefined })[\n RUNTIME_INTERNAL_KEY\n ];\n if (!internal) throw new Error(\"The tracing runtime was not created by this package.\");\n return internal;\n}\n\nexport function createLangfuseRuntimeFromBackend(backend: TraceBackend): LangfuseRuntime {\n return registerLangfuseRuntime(new ManagedLangfuseRuntime(backend));\n}\n\nexport function registerLangfuseRuntime(runtime: LangfuseRuntimeInternal): LangfuseRuntimeInternal {\n Object.defineProperty(runtime, RUNTIME_INTERNAL_KEY, { value: runtime });\n return runtime;\n}\n"],
5
+ "mappings": ";;;;AA4BA,IAAM,uBAAuB,uBAAO,IAAI,2CAA2C;AAEnF,IAAM,yBAAN,MAAgE;AAAA,EAM9D,YAAqB,SAAuB;AAAvB;AAAA,EAAwB;AAAA,EAAxB;AAAA,EALb,QAAuC;AAAA,EAC9B,mBAAmB,oBAAI,IAA4B;AAAA,EAC5D,aAAa,QAAQ,QAAQ;AAAA,EAC7B;AAAA,EAIR,IAAI,SAAkB;AACpB,WAAO,KAAK,UAAU;AAAA,EACxB;AAAA,EAEA,gBAAgB,UAA8C;AAC5D,QAAI,KAAK,UAAU,OAAQ,OAAM,IAAI,MAAM,sDAAsD;AACjG,SAAK,iBAAiB,IAAI,QAAQ;AAClC,WAAO,MAAM,KAAK,iBAAiB,OAAO,QAAQ;AAAA,EACpD;AAAA,EAEA,QAAuB;AACrB,QAAI,KAAK,UAAU,QAAQ;AACzB,aAAO,QAAQ,OAAO,IAAI,MAAM,sDAAsD,CAAC;AAAA,IACzF;AACA,UAAM,YAAY,KAAK,WAAW,KAAK,MAAM,KAAK,QAAQ,WAAW,CAAC;AACtE,SAAK,aAAa,UAAU;AAAA,MAC1B,MAAM;AAAA,MACN,MAAM;AAAA,IACR;AACA,WAAO;AAAA,EACT;AAAA,EAEA,WAA0B;AACxB,QAAI,KAAK,gBAAiB,QAAO,KAAK;AACtC,SAAK,QAAQ;AAEb,SAAK,kBAAkB,QAAQ,QAAQ,EAAE,KAAK,MAAM,KAAK,YAAY,CAAC;AACtE,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,MAAc,cAA6B;AACzC,UAAM,SAAoB,CAAC;AAC3B,eAAW,WAAW,CAAC,GAAG,KAAK,gBAAgB,GAAG;AAChD,UAAI;AACF,cAAM,QAAQ,gEAAgE;AAAA,MAChF,SAAS,OAAO;AACd,eAAO,KAAK,KAAK;AAAA,MACnB;AAAA,IACF;AACA,SAAK,iBAAiB,MAAM;AAE5B,UAAM,KAAK;AACX,QAAI;AACF,YAAM,KAAK,QAAQ,WAAW;AAAA,IAChC,SAAS,OAAO;AACd,aAAO,KAAK,KAAK;AAAA,IACnB;AACA,QAAI;AACF,YAAM,KAAK,QAAQ,SAAS;AAAA,IAC9B,SAAS,OAAO;AACd,aAAO,KAAK,KAAK;AAAA,IACnB,UAAE;AACA,WAAK,QAAQ;AAAA,IACf;AAEA,QAAI,OAAO,WAAW,EAAG,OAAM,OAAO,CAAC;AACvC,QAAI,OAAO,SAAS,EAAG,OAAM,IAAI,eAAe,QAAQ,mCAAmC;AAAA,EAC7F;AACF;AAEO,SAAS,2BAA2B,SAAmD;AAC5F,QAAM,WAAY,QAChB,oBACF;AACA,MAAI,CAAC,SAAU,OAAM,IAAI,MAAM,sDAAsD;AACrF,SAAO;AACT;AAEO,SAAS,iCAAiC,SAAwC;AACvF,SAAO,wBAAwB,IAAI,uBAAuB,OAAO,CAAC;AACpE;AAEO,SAAS,wBAAwB,SAA2D;AACjG,SAAO,eAAe,SAAS,sBAAsB,EAAE,OAAO,QAAQ,CAAC;AACvE,SAAO;AACT;",
6
+ "names": []
7
+ }
@@ -0,0 +1,406 @@
1
+ // @generated by scripts/build-runtime.mjs; do not edit.
2
+ // @ts-nocheck -- the generated entry uses a .ts extension for Pi's Jiti loader.
3
+ import {
4
+ DEFAULT_BASE_URL,
5
+ normalizeOtlpConnection,
6
+ otlpSecrets
7
+ } from "./chunk-7JGM5RS3.js";
8
+ import {
9
+ createLangfuseRuntimeFromBackend,
10
+ getLangfuseRuntimeInternal
11
+ } from "./chunk-BBL32ZV5.js";
12
+
13
+ // src/runtime.ts
14
+ import { Buffer } from "node:buffer";
15
+ import { createHash } from "node:crypto";
16
+ import { context, ROOT_CONTEXT, SpanKind, SpanStatusCode, trace } from "@opentelemetry/api";
17
+ import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-http";
18
+ import {
19
+ CompressionAlgorithm,
20
+ getSharedConfigurationDefaults,
21
+ OTLPExporterBase
22
+ } from "@opentelemetry/otlp-exporter-base";
23
+ import { createOtlpHttpExportDelegate, httpAgentFactoryFromOptions } from "@opentelemetry/otlp-exporter-base/node-http";
24
+ import { ProtobufTraceSerializer, TraceExporterMetricsHelper } from "@opentelemetry/otlp-transformer";
25
+ import { resourceFromAttributes } from "@opentelemetry/resources";
26
+ import { BatchSpanProcessor, TracerProvider } from "@opentelemetry/sdk-trace";
27
+ var RUNTIME_KEY = /* @__PURE__ */ Symbol.for("@narumitw/pi-langfuse/runtime/v2");
28
+ var LEGACY_RUNTIME_KEY = /* @__PURE__ */ Symbol.for("@narumitw/pi-langfuse/runtime/v1");
29
+ var LANGFUSE_SCOPE = "@narumitw/pi-langfuse";
30
+ var OTLP_SCOPE = "@narumitw/pi-otel";
31
+ var MAX_PENDING_METADATA_ATTRIBUTES = 128;
32
+ function isOtlpConfig(config) {
33
+ return "backend" in config;
34
+ }
35
+ function instrumentationScope(config) {
36
+ return isOtlpConfig(config) ? OTLP_SCOPE : LANGFUSE_SCOPE;
37
+ }
38
+ var ProductionObservation = class {
39
+ constructor(span, secrets, otlp) {
40
+ this.span = span;
41
+ this.secrets = secrets;
42
+ this.otlp = otlp;
43
+ this.observationScope = otlp ? "pi.observation" : "langfuse.observation";
44
+ this.traceScope = otlp ? "pi.trace" : "langfuse.trace";
45
+ this.traceId = span.spanContext().traceId;
46
+ }
47
+ span;
48
+ secrets;
49
+ otlp;
50
+ traceId;
51
+ metadata = /* @__PURE__ */ new Map();
52
+ observationScope;
53
+ traceScope;
54
+ update(attributes) {
55
+ const {
56
+ input,
57
+ output,
58
+ metadata,
59
+ level,
60
+ statusMessage,
61
+ model,
62
+ modelParameters,
63
+ usageDetails,
64
+ costDetails,
65
+ completionStartTime,
66
+ version,
67
+ sessionId,
68
+ userId
69
+ } = attributes;
70
+ const scope = this.observationScope;
71
+ this.span.setAttributes({
72
+ [`${scope}.input`]: serializeIO(input, this.secrets),
73
+ [`${scope}.output`]: serializeIO(output, this.secrets),
74
+ [`${scope}.level`]: level,
75
+ [`${scope}.status_message`]: this.mask(statusMessage),
76
+ [`${scope}.model.name`]: this.mask(model),
77
+ [`${scope}.model.parameters`]: serializeIO(modelParameters, this.secrets),
78
+ [`${scope}.usage_details`]: serializeIO(usageDetails, this.secrets),
79
+ [`${scope}.cost_details`]: serializeIO(costDetails, this.secrets),
80
+ [`${scope}.completion_start_time`]: serializeIO(completionStartTime, this.secrets),
81
+ [this.otlp ? "pi.version" : "langfuse.version"]: this.mask(version),
82
+ "session.id": this.mask(sessionId),
83
+ "user.id": this.mask(userId)
84
+ });
85
+ if (this.otlp && level === "ERROR") this.span.setStatus({ code: SpanStatusCode.ERROR });
86
+ this.setMetadata(scope, metadata);
87
+ return this;
88
+ }
89
+ updateTrace(attributes) {
90
+ const { input, output, metadata, name, sessionId, userId, tags, version } = attributes;
91
+ const scope = this.traceScope;
92
+ this.span.setAttributes({
93
+ [`${scope}.input`]: serializeIO(input, this.secrets),
94
+ [`${scope}.output`]: serializeIO(output, this.secrets),
95
+ [`${scope}.name`]: this.mask(name),
96
+ [`${scope}.tags`]: tags?.map((tag) => maskSecretString(tag, this.secrets)),
97
+ [this.otlp ? "pi.version" : "langfuse.version"]: this.mask(version),
98
+ "session.id": this.mask(sessionId),
99
+ "user.id": this.mask(userId)
100
+ });
101
+ this.setMetadata(scope, metadata);
102
+ return this;
103
+ }
104
+ end(endTime) {
105
+ for (const [key, value] of this.metadata) this.span.setAttribute(key, value);
106
+ this.metadata.clear();
107
+ this.span.end(endTime);
108
+ return this;
109
+ }
110
+ mask(value) {
111
+ return value === void 0 ? void 0 : maskSecretString(value, this.secrets);
112
+ }
113
+ setMetadata(scope, metadata) {
114
+ if (!metadata || !this.span.isRecording()) return;
115
+ for (const [key, value] of Object.entries(metadata)) {
116
+ if (scope === this.observationScope && value == null) continue;
117
+ const attribute = `${scope}.metadata.${maskSecretString(key, this.secrets)}`;
118
+ if (this.metadata.size >= MAX_PENDING_METADATA_ATTRIBUTES && !this.metadata.has(attribute)) continue;
119
+ const serialized = this.otlp && (typeof value === "boolean" || typeof value === "number" && Number.isFinite(value)) ? value : this.otlp && typeof value === "string" ? this.mask(value) : serializeMetadataValue(value, this.secrets);
120
+ if (serialized !== void 0) this.metadata.set(attribute, serialized);
121
+ }
122
+ }
123
+ };
124
+ var ProductionTraceBackend = class {
125
+ constructor(provider, processor, config) {
126
+ this.provider = provider;
127
+ this.processor = processor;
128
+ this.config = config;
129
+ this.tracer = provider.getTracer(instrumentationScope(config));
130
+ this.secrets = isOtlpConfig(config) ? otlpSecrets(config.headers) : [config.publicKey, config.secretKey].sort((a, b) => b.length - a.length);
131
+ }
132
+ provider;
133
+ processor;
134
+ config;
135
+ tracer;
136
+ spans = /* @__PURE__ */ new WeakSet();
137
+ secrets;
138
+ start(name, attributes, options) {
139
+ const parent = options.parent instanceof ProductionObservation ? options.parent.span : void 0;
140
+ const parentContext = parent ? trace.setSpan(ROOT_CONTEXT, parent) : context.active();
141
+ const parentSpan = trace.getSpan(parentContext);
142
+ const isAppRoot = !parentSpan || !this.spans.has(parentSpan) || !parentSpan.isRecording();
143
+ const config = this.config;
144
+ const otlp = isOtlpConfig(config);
145
+ const span = this.tracer.startSpan(
146
+ maskSecretString(name, this.secrets),
147
+ {
148
+ startTime: options.startTime,
149
+ ...otlp && options.asType === "generation" ? { kind: SpanKind.CLIENT } : {},
150
+ attributes: otlp ? { "pi.observation.type": options.asType } : {
151
+ "langfuse.observation.type": options.asType,
152
+ "langfuse.internal.is_app_root": isAppRoot ? true : void 0,
153
+ "langfuse.environment": config.environment && maskSecretString(config.environment, this.secrets),
154
+ "langfuse.release": config.release && maskSecretString(config.release, this.secrets)
155
+ }
156
+ },
157
+ parentContext
158
+ );
159
+ this.spans.add(span);
160
+ return new ProductionObservation(span, this.secrets, otlp).update(attributes);
161
+ }
162
+ forceFlush() {
163
+ return this.processor.forceFlush();
164
+ }
165
+ shutdown() {
166
+ return this.provider.shutdown();
167
+ }
168
+ };
169
+ async function createLangfuseRuntime(options = {}) {
170
+ return createSharedRuntime(resolveLangfuseRuntimeConfig(options), defaultFactories);
171
+ }
172
+ async function createOtelRuntime(config) {
173
+ return createSharedRuntime({ backend: "otlp", ...normalizeOtlpConnection({ ...config }) }, defaultFactories);
174
+ }
175
+ async function createProductionBackend(config, factoryOverrides = {}) {
176
+ const runtime = await createSharedRuntime(resolveLangfuseRuntimeConfig({ config, env: false }), {
177
+ ...defaultFactories,
178
+ ...factoryOverrides
179
+ });
180
+ return getLangfuseRuntimeInternal(runtime).backend;
181
+ }
182
+ async function createSharedRuntime(config, factories) {
183
+ const globalRuntime = globalThis;
184
+ const fingerprint = configFingerprint(config);
185
+ const existing = globalRuntime[RUNTIME_KEY];
186
+ const legacyRuntime = globalRuntime[LEGACY_RUNTIME_KEY];
187
+ if (legacyRuntime !== void 0 && legacyRuntime !== existing) {
188
+ throw new Error("An older Langfuse runtime is already loaded; restart the process before enabling this version.");
189
+ }
190
+ if (existing) {
191
+ if (legacyRuntime === void 0) globalRuntime[LEGACY_RUNTIME_KEY] = existing;
192
+ const shared = await existing;
193
+ if (shared.runtime.closed) {
194
+ throw new Error("Tracing was already shut down; restart the process to enable it again.");
195
+ }
196
+ if (shared.fingerprint !== fingerprint) {
197
+ throw new Error("Tracing configuration changed; restart the process to apply the new connection settings.");
198
+ }
199
+ return shared.runtime;
200
+ }
201
+ const initializing = initializeRuntime(config, fingerprint, factories);
202
+ globalRuntime[RUNTIME_KEY] = initializing;
203
+ globalRuntime[LEGACY_RUNTIME_KEY] = initializing;
204
+ try {
205
+ return (await initializing).runtime;
206
+ } catch (error) {
207
+ if (globalRuntime[RUNTIME_KEY] === initializing) delete globalRuntime[RUNTIME_KEY];
208
+ if (globalRuntime[LEGACY_RUNTIME_KEY] === initializing) delete globalRuntime[LEGACY_RUNTIME_KEY];
209
+ throw error;
210
+ }
211
+ }
212
+ async function initializeRuntime(config, fingerprint, factories) {
213
+ const processor = factories.createProcessor(config);
214
+ let provider;
215
+ try {
216
+ provider = factories.createProvider(processor, config);
217
+ } catch (error) {
218
+ await processor.shutdown().catch(() => void 0);
219
+ throw error;
220
+ }
221
+ const runtime = getLangfuseRuntimeInternal(
222
+ createLangfuseRuntimeFromBackend(new ProductionTraceBackend(provider, processor, config))
223
+ );
224
+ return { fingerprint, runtime, shutdown: true };
225
+ }
226
+ var PiBatchSpanProcessor = class extends BatchSpanProcessor {
227
+ constructor(config) {
228
+ super({
229
+ exporter: isOtlpConfig(config) ? createOtlpExporter(config) : createLangfuseExporter(config),
230
+ // Keep batches smaller than the SDK default because each span can carry large captured inputs and outputs.
231
+ maxExportBatchSize: 128,
232
+ scheduledDelayMillis: 5e3
233
+ });
234
+ this.scope = instrumentationScope(config);
235
+ }
236
+ scope;
237
+ onEnd(span) {
238
+ if (span.instrumentationScope.name === this.scope) super.onEnd(span);
239
+ }
240
+ };
241
+ var defaultFactories = {
242
+ createProcessor: (config) => new PiBatchSpanProcessor(config),
243
+ // The provider is private: do not register it with OpenTelemetry or replace the host's provider.
244
+ createProvider: (processor, config) => new TracerProvider({
245
+ spanProcessors: [processor],
246
+ ...isOtlpConfig(config) ? {
247
+ resource: resourceFromAttributes({
248
+ "service.name": maskSecretString(config.serviceName, otlpSecrets(config.headers))
249
+ })
250
+ } : {}
251
+ })
252
+ };
253
+ function createLangfuseExporter(config) {
254
+ return new OTLPTraceExporter({
255
+ url: `${config.baseUrl}/api/public/otel/v1/traces`,
256
+ headers: {
257
+ Authorization: `Basic ${Buffer.from(`${config.publicKey}:${config.secretKey}`).toString("base64")}`,
258
+ "x-langfuse-ingestion-version": "4"
259
+ },
260
+ timeoutMillis: 5e3,
261
+ compression: resolveCompression()
262
+ });
263
+ }
264
+ function createOtlpExporter(config) {
265
+ return new OTLPExporterBase(
266
+ createOtlpHttpExportDelegate(
267
+ {
268
+ ...getSharedConfigurationDefaults(),
269
+ url: config.endpoint,
270
+ headers: async () => ({ ...config.headers, "content-type": "application/x-protobuf" }),
271
+ timeoutMillis: 5e3,
272
+ agentFactory: httpAgentFactoryFromOptions({ keepAlive: true })
273
+ },
274
+ ProtobufTraceSerializer,
275
+ "otlp_http_span_exporter",
276
+ TraceExporterMetricsHelper,
277
+ void 0
278
+ )
279
+ );
280
+ }
281
+ function resolveCompression() {
282
+ for (const key of [
283
+ "LANGFUSE_OTEL_COMPRESSION",
284
+ "OTEL_EXPORTER_OTLP_TRACES_COMPRESSION",
285
+ "OTEL_EXPORTER_OTLP_COMPRESSION"
286
+ ]) {
287
+ const value = process.env[key]?.trim().toLowerCase();
288
+ if (value === CompressionAlgorithm.NONE || value === CompressionAlgorithm.GZIP) return value;
289
+ }
290
+ return CompressionAlgorithm.GZIP;
291
+ }
292
+ function resolveLangfuseRuntimeConfig(options) {
293
+ const env = options.env === false ? void 0 : options.env ?? process.env;
294
+ const publicKey = requiredSetting("publicKey", options.config?.publicKey, env?.LANGFUSE_PUBLIC_KEY);
295
+ const secretKey = requiredSetting("secretKey", options.config?.secretKey, env?.LANGFUSE_SECRET_KEY);
296
+ const explicitBaseUrl = options.config?.baseUrl;
297
+ if (explicitBaseUrl !== void 0 && !normalizeString(explicitBaseUrl)) {
298
+ throw new Error("Langfuse baseUrl must be a non-empty string.");
299
+ }
300
+ const rawBaseUrl = selectedSetting(explicitBaseUrl, env?.LANGFUSE_BASE_URL) ?? DEFAULT_BASE_URL;
301
+ const baseUrl = normalizeBaseUrl(rawBaseUrl);
302
+ if (!baseUrl) {
303
+ throw new Error("Langfuse baseUrl must use HTTP or HTTPS without credentials, a query, or a fragment.");
304
+ }
305
+ const environment = optionalSetting("environment", options.config?.environment, env?.LANGFUSE_TRACING_ENVIRONMENT);
306
+ if (environment && (environment.length > 40 || !/^(?!langfuse)[a-z0-9_-]+$/u.test(environment))) {
307
+ throw new Error(
308
+ "Langfuse environment must be at most 40 lowercase letters, numbers, hyphens, or underscores and must not start with langfuse."
309
+ );
310
+ }
311
+ const release = optionalSetting("release", options.config?.release, env?.LANGFUSE_RELEASE);
312
+ return { publicKey, secretKey, baseUrl, ...environment ? { environment } : {}, ...release ? { release } : {} };
313
+ }
314
+ function requiredSetting(name, explicit, environment) {
315
+ const value = selectedSetting(explicit, environment);
316
+ if (!value) throw new Error(`Langfuse ${name} is required.`);
317
+ return value;
318
+ }
319
+ function optionalSetting(name, explicit, environment) {
320
+ const selected = explicit !== void 0 ? explicit : environment;
321
+ if (selected === void 0) return void 0;
322
+ const value = normalizeString(selected);
323
+ if (!value) throw new Error(`Langfuse ${name} must be a non-empty string.`);
324
+ return value;
325
+ }
326
+ function selectedSetting(explicit, environment) {
327
+ if (explicit !== void 0) return normalizeString(explicit);
328
+ return normalizeString(environment);
329
+ }
330
+ function normalizeBaseUrl(value) {
331
+ try {
332
+ const url = new URL(value);
333
+ if (url.protocol !== "http:" && url.protocol !== "https:") return void 0;
334
+ if (url.username || url.password || url.search || url.hash) return void 0;
335
+ return url.toString().replace(/\/+$/, "");
336
+ } catch {
337
+ return void 0;
338
+ }
339
+ }
340
+ function normalizeString(value) {
341
+ return typeof value === "string" && value.trim() ? value.trim() : void 0;
342
+ }
343
+ function serializeIO(value, secrets) {
344
+ if (typeof value === "string") return maskSecretString(value, secrets);
345
+ if (value == null) return void 0;
346
+ try {
347
+ const serialized = JSON.stringify(value);
348
+ if (serialized === void 0) return void 0;
349
+ return JSON.stringify(maskSecrets(JSON.parse(serialized), secrets));
350
+ } catch {
351
+ return "<failed to serialize>";
352
+ }
353
+ }
354
+ function serializeMetadataValue(value, secrets) {
355
+ try {
356
+ return JSON.stringify(maskSecrets(value, secrets), (_, entry) => {
357
+ if (typeof entry === "number" && !Number.isFinite(entry)) return String(entry);
358
+ if (typeof entry !== "bigint") return entry;
359
+ return entry >= BigInt(Number.MIN_SAFE_INTEGER) && entry <= BigInt(Number.MAX_SAFE_INTEGER) ? Number(entry) : entry.toString();
360
+ });
361
+ } catch {
362
+ return JSON.stringify("<failed to serialize>");
363
+ }
364
+ }
365
+ function maskSecretString(value, secrets) {
366
+ let masked = value.replace(/\b(?:sk|pk)-lf-[A-Za-z0-9_-]+\b/gu, "[LANGFUSE_KEY_REDACTED]");
367
+ for (const secret of secrets) {
368
+ if (secret) masked = masked.replaceAll(secret, "[LANGFUSE_KEY_REDACTED]");
369
+ }
370
+ return masked;
371
+ }
372
+ function configFingerprint(config) {
373
+ return createHash("sha256").update(
374
+ isOtlpConfig(config) ? JSON.stringify([config.backend, config.endpoint, config.headers, config.serviceName]) : `${config.publicKey}\0${config.secretKey}\0${config.baseUrl}\0${config.environment ?? ""}\0${config.release ?? ""}`
375
+ ).digest("hex");
376
+ }
377
+ function maskSecrets(data, secrets) {
378
+ return maskSecretValue(data, secrets, /* @__PURE__ */ new WeakSet());
379
+ }
380
+ function maskSecretValue(data, secrets, active) {
381
+ if (typeof data === "string") return maskSecretString(data, secrets);
382
+ if (!data || typeof data !== "object") return data;
383
+ if (active.has(data)) return "[circular]";
384
+ active.add(data);
385
+ try {
386
+ if (Array.isArray(data)) {
387
+ return data.map((item) => maskSecretValue(item, secrets, active));
388
+ }
389
+ return Object.fromEntries(
390
+ Object.entries(data).map(([key, value]) => [
391
+ maskSecretString(key, secrets),
392
+ maskSecretValue(value, secrets, active)
393
+ ])
394
+ );
395
+ } finally {
396
+ active.delete(data);
397
+ }
398
+ }
399
+ export {
400
+ createLangfuseRuntime,
401
+ createOtelRuntime,
402
+ createProductionBackend,
403
+ maskSecrets,
404
+ resolveLangfuseRuntimeConfig
405
+ };
406
+ //# sourceMappingURL=runtime-554E6FVF.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../src/runtime.ts"],
4
+ "sourcesContent": ["import { Buffer } from \"node:buffer\";\nimport { createHash } from \"node:crypto\";\nimport { context, ROOT_CONTEXT, type Span, SpanKind, SpanStatusCode, type Tracer, trace } from \"@opentelemetry/api\";\nimport { OTLPTraceExporter } from \"@opentelemetry/exporter-trace-otlp-http\";\nimport {\n CompressionAlgorithm,\n getSharedConfigurationDefaults,\n OTLPExporterBase,\n} from \"@opentelemetry/otlp-exporter-base\";\nimport { createOtlpHttpExportDelegate, httpAgentFactoryFromOptions } from \"@opentelemetry/otlp-exporter-base/node-http\";\nimport { ProtobufTraceSerializer, TraceExporterMetricsHelper } from \"@opentelemetry/otlp-transformer\";\nimport { resourceFromAttributes } from \"@opentelemetry/resources\";\nimport { BatchSpanProcessor, type ReadableSpan, type SpanProcessor, TracerProvider } from \"@opentelemetry/sdk-trace\";\nimport type { LangfuseConfig } from \"./config.js\";\nimport { normalizeOtlpConnection, type OtlpConnection, type OtlpRuntimeConfig, otlpSecrets } from \"./otlp-settings.js\";\nimport {\n type CreateLangfuseRuntimeOptions,\n createLangfuseRuntimeFromBackend,\n getLangfuseRuntimeInternal,\n type LangfuseRuntime,\n type LangfuseRuntimeInternal,\n} from \"./runtime-core.js\";\nimport { DEFAULT_BASE_URL } from \"./runtime-defaults.js\";\nimport type { Observation, ObservationAttributes, ObservationType, TraceBackend } from \"./tracing.js\";\n\nexport type {\n CreateLangfuseRuntimeOptions,\n LangfuseRuntime,\n LangfuseRuntimeConfig,\n} from \"./runtime-core.js\";\n\n// Keep the process slots and Langfuse instrumentation scope stable across the package rename.\nconst RUNTIME_KEY = Symbol.for(\"@narumitw/pi-langfuse/runtime/v2\");\nconst LEGACY_RUNTIME_KEY = Symbol.for(\"@narumitw/pi-langfuse/runtime/v1\");\nconst LANGFUSE_SCOPE = \"@narumitw/pi-langfuse\";\nconst OTLP_SCOPE = \"@narumitw/pi-otel\";\nconst MAX_PENDING_METADATA_ATTRIBUTES = 128;\n\ninterface ResolvedLangfuseConfig {\n publicKey: string;\n secretKey: string;\n baseUrl: string;\n environment?: string;\n release?: string;\n}\n\ntype ResolvedOtlpConfig = OtlpConnection & { backend: \"otlp\" };\ntype ResolvedRuntimeConfig = ResolvedLangfuseConfig | ResolvedOtlpConfig;\n\nfunction isOtlpConfig(config: ResolvedRuntimeConfig): config is ResolvedOtlpConfig {\n return \"backend\" in config;\n}\n\nfunction instrumentationScope(config: ResolvedRuntimeConfig): string {\n return isOtlpConfig(config) ? OTLP_SCOPE : LANGFUSE_SCOPE;\n}\n\ninterface SharedRuntime {\n fingerprint: string;\n runtime: LangfuseRuntimeInternal;\n shutdown: true;\n}\n\ntype GlobalWithRuntime = typeof globalThis & {\n [RUNTIME_KEY]?: Promise<SharedRuntime>;\n [LEGACY_RUNTIME_KEY]?: unknown;\n};\n\ninterface RuntimeFactories {\n createProcessor(config: ResolvedRuntimeConfig): SpanProcessor;\n createProvider(processor: SpanProcessor, config: ResolvedRuntimeConfig): TracerProvider;\n}\n\nclass ProductionObservation implements Observation {\n readonly traceId: string;\n private readonly metadata = new Map<string, string | number | boolean>();\n private readonly observationScope: string;\n private readonly traceScope: string;\n\n constructor(\n readonly span: Span,\n private readonly secrets: readonly string[],\n private readonly otlp: boolean,\n ) {\n this.observationScope = otlp ? \"pi.observation\" : \"langfuse.observation\";\n this.traceScope = otlp ? \"pi.trace\" : \"langfuse.trace\";\n this.traceId = span.spanContext().traceId;\n }\n\n update(attributes: ObservationAttributes): Observation {\n const {\n input,\n output,\n metadata,\n level,\n statusMessage,\n model,\n modelParameters,\n usageDetails,\n costDetails,\n completionStartTime,\n version,\n sessionId,\n userId,\n } = attributes;\n const scope = this.observationScope;\n this.span.setAttributes({\n [`${scope}.input`]: serializeIO(input, this.secrets),\n [`${scope}.output`]: serializeIO(output, this.secrets),\n [`${scope}.level`]: level,\n [`${scope}.status_message`]: this.mask(statusMessage),\n [`${scope}.model.name`]: this.mask(model),\n [`${scope}.model.parameters`]: serializeIO(modelParameters, this.secrets),\n [`${scope}.usage_details`]: serializeIO(usageDetails, this.secrets),\n [`${scope}.cost_details`]: serializeIO(costDetails, this.secrets),\n [`${scope}.completion_start_time`]: serializeIO(completionStartTime, this.secrets),\n [this.otlp ? \"pi.version\" : \"langfuse.version\"]: this.mask(version),\n \"session.id\": this.mask(sessionId),\n \"user.id\": this.mask(userId),\n });\n if (this.otlp && level === \"ERROR\") this.span.setStatus({ code: SpanStatusCode.ERROR });\n this.setMetadata(scope, metadata);\n return this;\n }\n\n updateTrace(attributes: ObservationAttributes): Observation {\n const { input, output, metadata, name, sessionId, userId, tags, version } = attributes;\n // Trace IO belongs to the receiving span without changing its observation IO.\n const scope = this.traceScope;\n this.span.setAttributes({\n [`${scope}.input`]: serializeIO(input, this.secrets),\n [`${scope}.output`]: serializeIO(output, this.secrets),\n [`${scope}.name`]: this.mask(name),\n [`${scope}.tags`]: tags?.map((tag) => maskSecretString(tag, this.secrets)),\n [this.otlp ? \"pi.version\" : \"langfuse.version\"]: this.mask(version),\n \"session.id\": this.mask(sessionId),\n \"user.id\": this.mask(userId),\n });\n this.setMetadata(scope, metadata);\n return this;\n }\n\n end(endTime?: number): Observation {\n // Write metadata last so it can only use slots left by trace and observation fields.\n for (const [key, value] of this.metadata) this.span.setAttribute(key, value);\n this.metadata.clear();\n this.span.end(endTime);\n return this;\n }\n\n private mask(value: string | undefined): string | undefined {\n return value === undefined ? undefined : maskSecretString(value, this.secrets);\n }\n\n private setMetadata(scope: string, metadata: Record<string, unknown> | undefined): void {\n if (!metadata || !this.span.isRecording()) return;\n for (const [key, value] of Object.entries(metadata)) {\n if (scope === this.observationScope && value == null) continue;\n const attribute = `${scope}.metadata.${maskSecretString(key, this.secrets)}`;\n if (this.metadata.size >= MAX_PENDING_METADATA_ATTRIBUTES && !this.metadata.has(attribute)) continue;\n const serialized =\n this.otlp && (typeof value === \"boolean\" || (typeof value === \"number\" && Number.isFinite(value)))\n ? value\n : this.otlp && typeof value === \"string\"\n ? this.mask(value)\n : serializeMetadataValue(value, this.secrets);\n if (serialized !== undefined) this.metadata.set(attribute, serialized);\n }\n }\n}\n\nclass ProductionTraceBackend implements TraceBackend {\n private readonly tracer: Tracer;\n private readonly spans = new WeakSet<Span>();\n private readonly secrets: readonly string[];\n\n constructor(\n private readonly provider: TracerProvider,\n private readonly processor: SpanProcessor,\n private readonly config: ResolvedRuntimeConfig,\n ) {\n this.tracer = provider.getTracer(instrumentationScope(config));\n this.secrets = isOtlpConfig(config)\n ? otlpSecrets(config.headers)\n : [config.publicKey, config.secretKey].sort((a, b) => b.length - a.length);\n }\n\n start(\n name: string,\n attributes: ObservationAttributes,\n options: { asType: ObservationType; parent?: Observation; startTime?: Date },\n ): Observation {\n const parent = options.parent instanceof ProductionObservation ? options.parent.span : undefined;\n const parentContext = parent ? trace.setSpan(ROOT_CONTEXT, parent) : context.active();\n const parentSpan = trace.getSpan(parentContext);\n // Preserve the trace ID of an explicit parent even if it ended before this span started.\n const isAppRoot = !parentSpan || !this.spans.has(parentSpan) || !parentSpan.isRecording();\n const config = this.config;\n const otlp = isOtlpConfig(config);\n const span = this.tracer.startSpan(\n maskSecretString(name, this.secrets),\n {\n startTime: options.startTime,\n ...(otlp && options.asType === \"generation\" ? { kind: SpanKind.CLIENT } : {}),\n attributes: otlp\n ? { \"pi.observation.type\": options.asType }\n : {\n \"langfuse.observation.type\": options.asType,\n \"langfuse.internal.is_app_root\": isAppRoot ? true : undefined,\n \"langfuse.environment\": config.environment && maskSecretString(config.environment, this.secrets),\n \"langfuse.release\": config.release && maskSecretString(config.release, this.secrets),\n },\n },\n parentContext,\n );\n this.spans.add(span);\n return new ProductionObservation(span, this.secrets, otlp).update(attributes);\n }\n\n forceFlush(): Promise<void> {\n return this.processor.forceFlush();\n }\n\n shutdown(): Promise<void> {\n return this.provider.shutdown();\n }\n}\n\nexport async function createLangfuseRuntime(options: CreateLangfuseRuntimeOptions = {}): Promise<LangfuseRuntime> {\n return createSharedRuntime(resolveLangfuseRuntimeConfig(options), defaultFactories);\n}\n\nexport async function createOtelRuntime(config: OtlpRuntimeConfig): Promise<LangfuseRuntime> {\n return createSharedRuntime({ backend: \"otlp\", ...normalizeOtlpConnection({ ...config }) }, defaultFactories);\n}\n\nexport async function createProductionBackend(\n config: LangfuseConfig,\n factoryOverrides: Partial<RuntimeFactories> = {},\n): Promise<TraceBackend> {\n const runtime = await createSharedRuntime(resolveLangfuseRuntimeConfig({ config, env: false }), {\n ...defaultFactories,\n ...factoryOverrides,\n });\n return getLangfuseRuntimeInternal(runtime).backend;\n}\n\nasync function createSharedRuntime(\n config: ResolvedRuntimeConfig,\n factories: RuntimeFactories,\n): Promise<LangfuseRuntime> {\n const globalRuntime = globalThis as GlobalWithRuntime;\n const fingerprint = configFingerprint(config);\n const existing = globalRuntime[RUNTIME_KEY];\n const legacyRuntime = globalRuntime[LEGACY_RUNTIME_KEY];\n if (legacyRuntime !== undefined && legacyRuntime !== existing) {\n throw new Error(\"An older Langfuse runtime is already loaded; restart the process before enabling this version.\");\n }\n if (existing) {\n if (legacyRuntime === undefined) globalRuntime[LEGACY_RUNTIME_KEY] = existing;\n const shared = await existing;\n if (shared.runtime.closed) {\n throw new Error(\"Tracing was already shut down; restart the process to enable it again.\");\n }\n if (shared.fingerprint !== fingerprint) {\n throw new Error(\"Tracing configuration changed; restart the process to apply the new connection settings.\");\n }\n return shared.runtime;\n }\n\n const initializing = initializeRuntime(config, fingerprint, factories);\n globalRuntime[RUNTIME_KEY] = initializing;\n globalRuntime[LEGACY_RUNTIME_KEY] = initializing;\n try {\n return (await initializing).runtime;\n } catch (error) {\n if (globalRuntime[RUNTIME_KEY] === initializing) delete globalRuntime[RUNTIME_KEY];\n if (globalRuntime[LEGACY_RUNTIME_KEY] === initializing) delete globalRuntime[LEGACY_RUNTIME_KEY];\n throw error;\n }\n}\n\nasync function initializeRuntime(\n config: ResolvedRuntimeConfig,\n fingerprint: string,\n factories: RuntimeFactories,\n): Promise<SharedRuntime> {\n const processor = factories.createProcessor(config);\n let provider: TracerProvider;\n try {\n provider = factories.createProvider(processor, config);\n } catch (error) {\n await processor.shutdown().catch(() => undefined);\n throw error;\n }\n const runtime = getLangfuseRuntimeInternal(\n createLangfuseRuntimeFromBackend(new ProductionTraceBackend(provider, processor, config)),\n );\n return { fingerprint, runtime, shutdown: true };\n}\n\nclass PiBatchSpanProcessor extends BatchSpanProcessor {\n constructor(config: ResolvedRuntimeConfig) {\n super({\n exporter: isOtlpConfig(config) ? createOtlpExporter(config) : createLangfuseExporter(config),\n // Keep batches smaller than the SDK default because each span can carry large captured inputs and outputs.\n maxExportBatchSize: 128,\n scheduledDelayMillis: 5_000,\n });\n this.scope = instrumentationScope(config);\n }\n\n private readonly scope: string;\n\n override onEnd(span: ReadableSpan): void {\n if (span.instrumentationScope.name === this.scope) super.onEnd(span);\n }\n}\n\nconst defaultFactories: RuntimeFactories = {\n createProcessor: (config) => new PiBatchSpanProcessor(config),\n // The provider is private: do not register it with OpenTelemetry or replace the host's provider.\n createProvider: (processor, config) =>\n new TracerProvider({\n spanProcessors: [processor],\n ...(isOtlpConfig(config)\n ? {\n resource: resourceFromAttributes({\n \"service.name\": maskSecretString(config.serviceName, otlpSecrets(config.headers)),\n }),\n }\n : {}),\n }),\n};\n\nfunction createLangfuseExporter(config: ResolvedLangfuseConfig): OTLPTraceExporter {\n return new OTLPTraceExporter({\n url: `${config.baseUrl}/api/public/otel/v1/traces`,\n headers: {\n Authorization: `Basic ${Buffer.from(`${config.publicKey}:${config.secretKey}`).toString(\"base64\")}`,\n \"x-langfuse-ingestion-version\": \"4\",\n },\n timeoutMillis: 5_000,\n compression: resolveCompression(),\n });\n}\n\nfunction createOtlpExporter(config: ResolvedOtlpConfig): OTLPExporterBase<ReadableSpan[]> {\n // The legacy exporter constructor merges ambient OTLP headers, which can send credentials to the wrong endpoint.\n return new OTLPExporterBase(\n createOtlpHttpExportDelegate(\n {\n ...getSharedConfigurationDefaults(),\n url: config.endpoint,\n headers: async () => ({ ...config.headers, \"content-type\": \"application/x-protobuf\" }),\n timeoutMillis: 5_000,\n agentFactory: httpAgentFactoryFromOptions({ keepAlive: true }),\n },\n ProtobufTraceSerializer,\n \"otlp_http_span_exporter\",\n TraceExporterMetricsHelper,\n undefined,\n ),\n );\n}\n\nfunction resolveCompression(): CompressionAlgorithm {\n for (const key of [\n \"LANGFUSE_OTEL_COMPRESSION\",\n \"OTEL_EXPORTER_OTLP_TRACES_COMPRESSION\",\n \"OTEL_EXPORTER_OTLP_COMPRESSION\",\n ]) {\n const value = process.env[key]?.trim().toLowerCase();\n if (value === CompressionAlgorithm.NONE || value === CompressionAlgorithm.GZIP) return value;\n }\n return CompressionAlgorithm.GZIP;\n}\n\nexport function resolveLangfuseRuntimeConfig(options: CreateLangfuseRuntimeOptions): ResolvedLangfuseConfig {\n const env = options.env === false ? undefined : (options.env ?? process.env);\n const publicKey = requiredSetting(\"publicKey\", options.config?.publicKey, env?.LANGFUSE_PUBLIC_KEY);\n const secretKey = requiredSetting(\"secretKey\", options.config?.secretKey, env?.LANGFUSE_SECRET_KEY);\n const explicitBaseUrl = options.config?.baseUrl;\n if (explicitBaseUrl !== undefined && !normalizeString(explicitBaseUrl)) {\n throw new Error(\"Langfuse baseUrl must be a non-empty string.\");\n }\n const rawBaseUrl = selectedSetting(explicitBaseUrl, env?.LANGFUSE_BASE_URL) ?? DEFAULT_BASE_URL;\n const baseUrl = normalizeBaseUrl(rawBaseUrl);\n if (!baseUrl) {\n throw new Error(\"Langfuse baseUrl must use HTTP or HTTPS without credentials, a query, or a fragment.\");\n }\n const environment = optionalSetting(\"environment\", options.config?.environment, env?.LANGFUSE_TRACING_ENVIRONMENT);\n if (environment && (environment.length > 40 || !/^(?!langfuse)[a-z0-9_-]+$/u.test(environment))) {\n throw new Error(\n \"Langfuse environment must be at most 40 lowercase letters, numbers, hyphens, or underscores and must not start with langfuse.\",\n );\n }\n const release = optionalSetting(\"release\", options.config?.release, env?.LANGFUSE_RELEASE);\n return { publicKey, secretKey, baseUrl, ...(environment ? { environment } : {}), ...(release ? { release } : {}) };\n}\n\nfunction requiredSetting(name: string, explicit: string | undefined, environment: string | undefined): string {\n const value = selectedSetting(explicit, environment);\n if (!value) throw new Error(`Langfuse ${name} is required.`);\n return value;\n}\n\nfunction optionalSetting(\n name: string,\n explicit: string | undefined,\n environment: string | undefined,\n): string | undefined {\n const selected = explicit !== undefined ? explicit : environment;\n if (selected === undefined) return undefined;\n const value = normalizeString(selected);\n if (!value) throw new Error(`Langfuse ${name} must be a non-empty string.`);\n return value;\n}\n\nfunction selectedSetting(explicit: string | undefined, environment: string | undefined): string | undefined {\n if (explicit !== undefined) return normalizeString(explicit);\n return normalizeString(environment);\n}\n\nfunction normalizeBaseUrl(value: string): string | undefined {\n try {\n const url = new URL(value);\n if (url.protocol !== \"http:\" && url.protocol !== \"https:\") return undefined;\n if (url.username || url.password || url.search || url.hash) return undefined;\n return url.toString().replace(/\\/+$/, \"\");\n } catch {\n return undefined;\n }\n}\n\nfunction normalizeString(value: unknown): string | undefined {\n return typeof value === \"string\" && value.trim() ? value.trim() : undefined;\n}\n\nfunction serializeIO(value: unknown, secrets: readonly string[]): string | undefined {\n if (typeof value === \"string\") return maskSecretString(value, secrets);\n if (value == null) return undefined;\n try {\n const serialized = JSON.stringify(value);\n if (serialized === undefined) return undefined;\n // Mask decoded keys and values so escaped credentials are redacted without breaking JSON.\n return JSON.stringify(maskSecrets(JSON.parse(serialized), secrets));\n } catch {\n return \"<failed to serialize>\";\n }\n}\n\nfunction serializeMetadataValue(value: unknown, secrets: readonly string[]): string | undefined {\n try {\n return JSON.stringify(maskSecrets(value, secrets), (_, entry: unknown) => {\n if (typeof entry === \"number\" && !Number.isFinite(entry)) return String(entry);\n if (typeof entry !== \"bigint\") return entry;\n return entry >= BigInt(Number.MIN_SAFE_INTEGER) && entry <= BigInt(Number.MAX_SAFE_INTEGER)\n ? Number(entry)\n : entry.toString();\n });\n } catch {\n return JSON.stringify(\"<failed to serialize>\");\n }\n}\n\nfunction maskSecretString(value: string, secrets: readonly string[]): string {\n let masked = value.replace(/\\b(?:sk|pk)-lf-[A-Za-z0-9_-]+\\b/gu, \"[LANGFUSE_KEY_REDACTED]\");\n // Replace longer configured keys first if one key is a prefix of the other.\n for (const secret of secrets) {\n if (secret) masked = masked.replaceAll(secret, \"[LANGFUSE_KEY_REDACTED]\");\n }\n return masked;\n}\n\nfunction configFingerprint(config: ResolvedRuntimeConfig): string {\n return createHash(\"sha256\")\n .update(\n isOtlpConfig(config)\n ? JSON.stringify([config.backend, config.endpoint, config.headers, config.serviceName])\n : `${config.publicKey}\\0${config.secretKey}\\0${config.baseUrl}\\0${config.environment ?? \"\"}\\0${config.release ?? \"\"}`,\n )\n .digest(\"hex\");\n}\n\nexport function maskSecrets(data: unknown, secrets: readonly string[]): unknown {\n return maskSecretValue(data, secrets, new WeakSet<object>());\n}\n\nfunction maskSecretValue(data: unknown, secrets: readonly string[], active: WeakSet<object>): unknown {\n if (typeof data === \"string\") return maskSecretString(data, secrets);\n if (!data || typeof data !== \"object\") return data;\n if (active.has(data)) return \"[circular]\";\n\n active.add(data);\n try {\n if (Array.isArray(data)) {\n return data.map((item) => maskSecretValue(item, secrets, active));\n }\n return Object.fromEntries(\n Object.entries(data).map(([key, value]) => [\n maskSecretString(key, secrets),\n maskSecretValue(value, secrets, active),\n ]),\n );\n } finally {\n active.delete(data);\n }\n}\n"],
5
+ "mappings": "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",
6
+ "names": []
7
+ }
package/dist/otel.d.ts ADDED
@@ -0,0 +1,13 @@
1
+ import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
2
+ import { type LangfuseConfigPatch, type SettingsResult, type TracingSettings } from "./config.js";
3
+ import type { GitMetadata, TraceBackend } from "./tracing.js";
4
+ export { resolveGitMetadata } from "./git.js";
5
+ interface ExtensionDependencies {
6
+ loadConfig(path?: string): Promise<SettingsResult>;
7
+ writeConfig(config: LangfuseConfigPatch, path?: string): Promise<unknown>;
8
+ createBackend(config: TracingSettings): Promise<TraceBackend>;
9
+ resolveGitMetadata(cwd: string): Promise<GitMetadata | undefined>;
10
+ }
11
+ export declare function createOtelExtension(dependencies?: Partial<ExtensionDependencies>): (pi: ExtensionAPI) => void;
12
+ declare const _default: (pi: ExtensionAPI) => void;
13
+ export default _default;
@@ -0,0 +1,8 @@
1
+ export interface OtlpRuntimeConfig {
2
+ endpoint: string;
3
+ headers?: Readonly<Record<string, string>>;
4
+ serviceName?: string;
5
+ }
6
+ export type OtlpConnection = Required<OtlpRuntimeConfig>;
7
+ export declare function normalizeOtlpConnection(input: Readonly<Record<string, unknown>>): OtlpConnection;
8
+ export declare function otlpSecrets(headers: Readonly<Record<string, string>>): string[];
@@ -0,0 +1,43 @@
1
+ import type { ExtensionAPI, ExtensionContext, ExtensionFactory } from "@earendil-works/pi-coding-agent";
2
+ import { type LangfuseRuntime } from "./runtime-core.js";
3
+ import { type GitMetadata } from "./tracing.js";
4
+ export interface PiLangfuseSessionOptions {
5
+ traceName?: string;
6
+ sessionId?: string;
7
+ userId?: string;
8
+ tags?: readonly string[];
9
+ metadata?: Readonly<Record<string, unknown>>;
10
+ captureContent?: boolean;
11
+ onTraceId?: (traceId: string) => void;
12
+ }
13
+ export interface PiLangfuseSession {
14
+ readonly extension: ExtensionFactory;
15
+ setRequestId(requestId?: string): void;
16
+ dispose(): Promise<void>;
17
+ }
18
+ interface ResolvedSession {
19
+ runtime: LangfuseRuntime;
20
+ options?: PiLangfuseSessionOptions;
21
+ releaseIfStale?(reason: string): Promise<void>;
22
+ }
23
+ interface PiLangfuseSessionControllerOptions {
24
+ resolveSession(ctx: ExtensionContext, isCurrent: () => boolean): Promise<ResolvedSession | undefined>;
25
+ resolveGitMetadata?(pi: ExtensionAPI, cwd: string): Promise<GitMetadata | undefined>;
26
+ onSessionStart?(): void;
27
+ onSessionShutdown?(): void;
28
+ onSessionReady?(session: ResolvedSession): void;
29
+ onSessionUnavailable?(): void;
30
+ onInitializationError?(error: unknown, ctx: ExtensionContext): void;
31
+ beforeSessionDispose?(): Promise<void>;
32
+ onShutdownError?(error: unknown, ctx: ExtensionContext): void;
33
+ flushOnReplacement?: boolean;
34
+ shutdownRuntimeOnQuit?: boolean;
35
+ }
36
+ export interface PiLangfuseSessionController extends PiLangfuseSession {
37
+ readonly active: boolean;
38
+ readonly runtime: LangfuseRuntime | undefined;
39
+ flush(): Promise<void>;
40
+ }
41
+ export declare function createPiLangfuseSession(runtime: LangfuseRuntime, options?: PiLangfuseSessionOptions): PiLangfuseSession;
42
+ export declare function createPiLangfuseSessionController(options: PiLangfuseSessionControllerOptions): PiLangfuseSessionController;
43
+ export {};
@@ -0,0 +1,2 @@
1
+ export { createPiLangfuseSession, type PiLangfuseSession, type PiLangfuseSessionOptions, } from "./pi-session.js";
2
+ export { type CreateLangfuseRuntimeOptions, createLangfuseRuntime, createOtelRuntime, type LangfuseRuntime, type LangfuseRuntimeConfig, type OtlpRuntimeConfig, } from "./runtime-api.js";
@@ -0,0 +1,6 @@
1
+ import type { OtlpRuntimeConfig } from "./otlp-settings.js";
2
+ import type { CreateLangfuseRuntimeOptions, LangfuseRuntime } from "./runtime-core.js";
3
+ export type { OtlpRuntimeConfig } from "./otlp-settings.js";
4
+ export type { CreateLangfuseRuntimeOptions, LangfuseRuntime, LangfuseRuntimeConfig } from "./runtime-core.js";
5
+ export declare function createLangfuseRuntime(options?: CreateLangfuseRuntimeOptions): Promise<LangfuseRuntime>;
6
+ export declare function createOtelRuntime(config: OtlpRuntimeConfig): Promise<LangfuseRuntime>;