@warlock.js/ai-panoptic 5.31.0 → 5.33.0

package/esm/evaluate/evaluate.type.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"evaluate.type.d.mts","names":[],"sources":["../../../../../../../../packages/ai-panoptic/src/evaluate/evaluate.type.ts"],"mappings":";;;;;AAuBA;;;;;;;;;;;;;;;;AAgBc;AAId;;KApBY,cAAA;EAoB8B;AAAA;;;;;;EAZxC,KAAA,EAAO,aAAA,UAAuB,aAAA,GAAgB,OAAA,CAAQ,aAAA;;;;;;;;EAQtD,YAAA;AAAA;;KAIU,eAAA,GAAkB,YAAY"}
+{"version":3,"file":"evaluate.type.d.mts","names":[],"sources":["../../../../../../../../packages/ai-panoptic/src/evaluate/evaluate.type.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;YAuBY;;;;;;;;EAQV,OAAO,uBAAuB,gBAAgB,QAAQ;;;;;;;;EAQtD;;;YAIU,kBAAkB"}

package/esm/evaluate/extract-last-system-prompt.d.mts

@@ -1,5 +1,4 @@
 import { TraceSpan } from "../contracts/trace.type.mjs";
-
 //#region ../../packages/ai-panoptic/src/evaluate/extract-last-system-prompt.d.ts
 /**
  * Pull the LAST `{role: "system"}` message off a span's captured `input`.
@@ -13,7 +12,6 @@ import { TraceSpan } from "../contracts/trace.type.mjs";
  * `undefined` for a tool span, an agent with no system prompt, or when
  * content capture is off — the caller treats that as "nothing to evaluate."
  */
-declare function extractLastSystemPrompt(span: TraceSpan): string | undefined;
+export declare function extractLastSystemPrompt(span: TraceSpan): string | undefined;
 //#endregion
-export { extractLastSystemPrompt };
 //# sourceMappingURL=extract-last-system-prompt.d.mts.map

package/esm/evaluate/extract-last-system-prompt.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"extract-last-system-prompt.d.mts","names":[],"sources":["../../../../../../../../packages/ai-panoptic/src/evaluate/extract-last-system-prompt.ts"],"mappings":";;;;;AAcA;;;;AAAuD;;;;;;iBAAvC,uBAAA,CAAwB,IAAe,EAAT,SAAS"}
+{"version":3,"file":"extract-last-system-prompt.d.mts","names":[],"sources":["../../../../../../../../packages/ai-panoptic/src/evaluate/extract-last-system-prompt.ts"],"mappings":";;;;;;;;;;;;;;wBAcgB,wBAAwB,MAAM"}

package/esm/evaluate/find-span-by-id.d.mts

@@ -1,8 +1,6 @@
 import { TraceSpan } from "../contracts/trace.type.mjs";
-
 //#region ../../packages/ai-panoptic/src/evaluate/find-span-by-id.d.ts
 /** Depth-first search for the span with `spanId` inside a trace's span tree. */
-declare function findSpanById(root: TraceSpan, spanId: string): TraceSpan | undefined;
+export declare function findSpanById(root: TraceSpan, spanId: string): TraceSpan | undefined;
 //#endregion
-export { findSpanById };
 //# sourceMappingURL=find-span-by-id.d.mts.map

package/esm/evaluate/find-span-by-id.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"find-span-by-id.d.mts","names":[],"sources":["../../../../../../../../packages/ai-panoptic/src/evaluate/find-span-by-id.ts"],"mappings":";;;;iBAGgB,YAAA,CAAa,IAAA,EAAM,SAAA,EAAW,MAAA,WAAiB,SAAS"}
+{"version":3,"file":"find-span-by-id.d.mts","names":[],"sources":["../../../../../../../../packages/ai-panoptic/src/evaluate/find-span-by-id.ts"],"mappings":";;;wBAGgB,aAAa,MAAM,WAAW,iBAAiB"}

package/esm/evaluate/index.d.mts

@@ -1,4 +1,5 @@
 import { EvaluateConfig, EvaluateVerdict } from "./evaluate.type.mjs";
 import { evaluateSystemPrompt } from "./evaluate-system-prompt.mjs";
 import { extractLastSystemPrompt } from "./extract-last-system-prompt.mjs";
-import { findSpanById } from "./find-span-by-id.mjs";
+import { findSpanById } from "./find-span-by-id.mjs";
+export { type EvaluateConfig, type EvaluateVerdict, evaluateSystemPrompt, extractLastSystemPrompt, findSpanById };

package/esm/evaluate/index.mjs

@@ -2,4 +2,4 @@ import { evaluateSystemPrompt } from "./evaluate-system-prompt.mjs";
 import { extractLastSystemPrompt } from "./extract-last-system-prompt.mjs";
 import { findSpanById } from "./find-span-by-id.mjs";
 
-export {  };
+export { evaluateSystemPrompt, extractLastSystemPrompt, findSpanById };

package/esm/exporters/console/console-exporter.d.mts

@@ -1,6 +1,6 @@
 import { ExporterContract } from "../../contracts/exporter.contract.mjs";
+import "../../contracts/index.mjs";
 import { ConsoleExporterOptions } from "./console-exporter.type.mjs";
-
 //#region ../../packages/ai-panoptic/src/exporters/console/console-exporter.d.ts
 /**
  * Zero-dependency {@link ExporterContract} that prints traces to a
@@ -27,7 +27,6 @@ import { ConsoleExporterOptions } from "./console-exporter.type.mjs";
  *   exporters: [consoleExporter({ tree: true, io: true })],
  * });
  */
-declare function consoleExporter(options?: ConsoleExporterOptions): ExporterContract;
+export declare function consoleExporter(options?: ConsoleExporterOptions): ExporterContract;
 //#endregion
-export { consoleExporter };
 //# sourceMappingURL=console-exporter.d.mts.map

package/esm/exporters/console/console-exporter.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"console-exporter.d.mts","names":[],"sources":["../../../../../../../../../packages/ai-panoptic/src/exporters/console/console-exporter.ts"],"mappings":";;;;;;;AAiCA;;;;;;;;AAAuF;;;;;;;;;;;;;;iBAAvE,eAAA,CAAgB,OAAA,GAAS,sBAAA,GAA8B,gBAAgB"}
+{"version":3,"file":"console-exporter.d.mts","names":[],"sources":["../../../../../../../../../packages/ai-panoptic/src/exporters/console/console-exporter.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAiCgB,gBAAgB,UAAS,yBAA8B"}

package/esm/exporters/console/console-exporter.type.d.mts

@@ -5,14 +5,14 @@
  * monkey-patching the global. Only the two levels the exporter uses are
  * required.
  */
-type ConsoleLike = {
+export type ConsoleLike = {
   log(...args: unknown[]): void;
   error(...args: unknown[]): void;
 };
 /**
  * Options for {@link consoleExporter}.
  */
-type ConsoleExporterOptions = {
+export type ConsoleExporterOptions = {
   /**
    * Where to write. Defaults to the global `console`. Inject a custom
    * sink in tests or to redirect to a structured logger.
@@ -47,5 +47,4 @@ type ConsoleExporterOptions = {
   ioMaxChars?: number;
 };
 //#endregion
-export { ConsoleExporterOptions, ConsoleLike };
 //# sourceMappingURL=console-exporter.type.d.mts.map

package/esm/exporters/console/console-exporter.type.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"console-exporter.type.d.mts","names":[],"sources":["../../../../../../../../../packages/ai-panoptic/src/exporters/console/console-exporter.type.ts"],"mappings":";;AAMA;;;;;KAAY,WAAA;EACV,GAAA,IAAO,IAAA;EACP,KAAA,IAAS,IAAA;AAAA;AAAI;AAMf;;AANe,KAMH,sBAAA;EAKW;;;;EAArB,OAAA,GAAU,WAAW;EAoBrB;;;AAOU;;EArBV,IAAA;;;;;;EAMA,SAAA;;;;;;;;EAQA,EAAA;;;;;;;EAOA,UAAA;AAAA"}
+{"version":3,"file":"console-exporter.type.d.mts","names":[],"sources":["../../../../../../../../../packages/ai-panoptic/src/exporters/console/console-exporter.type.ts"],"mappings":";;;;;;;YAMY;EACV,OAAO;EACP,SAAS;;;;;YAMC;;;;;EAKV,UAAU;;;;;;EAMV;;;;;;EAMA;;;;;;;;EAQA;;;;;;;EAOA"}

package/esm/exporters/console/format-span-io.d.mts

@@ -1,4 +1,5 @@
 import { TraceSpan } from "../../contracts/trace.type.mjs";
+import "../../contracts/index.mjs";
 //#region ../../packages/ai-panoptic/src/exporters/console/format-span-io.d.ts
 /**
  * Render a span's captured content ({@link TraceSpan.input} /
@@ -21,7 +22,6 @@ import { TraceSpan } from "../../contracts/trace.type.mjs";
  * formatSpanIO(toolSpan, 1);
  * // ['    in:  {"query":"specialty coffee demand"}', '    out: {"results":[…]}']
  */
-declare function formatSpanIO(span: TraceSpan, depth?: number, maxChars?: number): string[];
+export declare function formatSpanIO(span: TraceSpan, depth?: number, maxChars?: number): string[];
 //#endregion
-export { formatSpanIO };
 //# sourceMappingURL=format-span-io.d.mts.map

package/esm/exporters/console/format-span-io.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"format-span-io.d.mts","names":[],"sources":["../../../../../../../../../packages/ai-panoptic/src/exporters/console/format-span-io.ts"],"mappings":";;;;;AA0BA;;;;;;;;;AAGiC;;;;;;;;;iBAHjB,YAAA,CACd,IAAA,EAAM,SAAS,EACf,KAAA,WACA,QAAA"}
+{"version":3,"file":"format-span-io.d.mts","names":[],"sources":["../../../../../../../../../packages/ai-panoptic/src/exporters/console/format-span-io.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;wBA0BgB,aACd,MAAM,WACN,gBACA"}

package/esm/exporters/console/format-span-line.d.mts

@@ -1,4 +1,5 @@
 import { TraceSpan } from "../../contracts/trace.type.mjs";
+import "../../contracts/index.mjs";
 //#region ../../packages/ai-panoptic/src/exporters/console/format-span-line.d.ts
 /**
  * Render a single {@link TraceSpan} as one scannable console line:
@@ -11,7 +12,6 @@ import { TraceSpan } from "../../contracts/trace.type.mjs";
  * formatSpanLine(span, 1);
  * // '  ok agent "router" — 1240ms, 470 tok, $0.0021'
  */
-declare function formatSpanLine(span: TraceSpan, depth?: number): string;
+export declare function formatSpanLine(span: TraceSpan, depth?: number): string;
 //#endregion
-export { formatSpanLine };
 //# sourceMappingURL=format-span-line.d.mts.map

package/esm/exporters/console/format-span-line.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"format-span-line.d.mts","names":[],"sources":["../../../../../../../../../packages/ai-panoptic/src/exporters/console/format-span-line.ts"],"mappings":";;;;;AAcA;;;;;;;;iBAAgB,cAAA,CAAe,IAAA,EAAM,SAAS,EAAE,KAAA"}
+{"version":3,"file":"format-span-line.d.mts","names":[],"sources":["../../../../../../../../../packages/ai-panoptic/src/exporters/console/format-span-line.ts"],"mappings":";;;;;;;;;;;;;;wBAcgB,eAAe,MAAM,WAAW"}

package/esm/exporters/console/index.d.mts

@@ -1,4 +1,5 @@
 import { ConsoleExporterOptions, ConsoleLike } from "./console-exporter.type.mjs";
 import { consoleExporter } from "./console-exporter.mjs";
 import { formatSpanLine } from "./format-span-line.mjs";
-import { formatSpanIO } from "./format-span-io.mjs";
+import { formatSpanIO } from "./format-span-io.mjs";
+export { type ConsoleExporterOptions, type ConsoleLike, consoleExporter, formatSpanIO, formatSpanLine };

package/esm/exporters/console/index.mjs

@@ -2,4 +2,4 @@ import { formatSpanIO } from "./format-span-io.mjs";
 import { formatSpanLine } from "./format-span-line.mjs";
 import { consoleExporter } from "./console-exporter.mjs";
 
-export {  };
+export { consoleExporter, formatSpanIO, formatSpanLine };

package/esm/exporters/file/file-exporter.d.mts

@@ -1,6 +1,6 @@
 import { ExporterContract } from "../../contracts/exporter.contract.mjs";
+import "../../contracts/index.mjs";
 import { FileExporterOptions } from "./file-exporter.type.mjs";
-
 //#region ../../packages/ai-panoptic/src/exporters/file/file-exporter.d.ts
 /**
  * Zero-dependency {@link ExporterContract} that appends completed traces
@@ -17,7 +17,6 @@ import { FileExporterOptions } from "./file-exporter.type.mjs";
  * // on shutdown:
  * await collector.shutdown(); // drains the buffer
  */
-declare function fileExporter(options: FileExporterOptions): ExporterContract;
+export declare function fileExporter(options: FileExporterOptions): ExporterContract;
 //#endregion
-export { fileExporter };
 //# sourceMappingURL=file-exporter.d.mts.map

package/esm/exporters/file/file-exporter.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"file-exporter.d.mts","names":[],"sources":["../../../../../../../../../packages/ai-panoptic/src/exporters/file/file-exporter.ts"],"mappings":";;;;;;;AAsBA;;;;;;;;AAA4E;;;;iBAA5D,YAAA,CAAa,OAAA,EAAS,mBAAA,GAAsB,gBAAgB"}
+{"version":3,"file":"file-exporter.d.mts","names":[],"sources":["../../../../../../../../../packages/ai-panoptic/src/exporters/file/file-exporter.ts"],"mappings":";;;;;;;;;;;;;;;;;;;wBAsBgB,aAAa,SAAS,sBAAsB"}

package/esm/exporters/file/file-exporter.type.d.mts

@@ -1,4 +1,5 @@
 import { Trace } from "../../contracts/trace.type.mjs";
+import "../../contracts/index.mjs";
 //#region ../../packages/ai-panoptic/src/exporters/file/file-exporter.type.d.ts
 /**
  * One JSON-Lines record the {@link fileExporter} appends per trace. A
@@ -6,15 +7,18 @@ import { Trace } from "../../contracts/trace.type.mjs";
  * the time the line was written, so a downstream reader can tell records
  * apart and order them without re-deriving anything from the payload.
  */
-type TraceRecord = {
-  /** Discriminator for the record format — always `"trace"` today. */type: "trace"; /** ISO-8601 timestamp the exporter wrote this record. */
-  exportedAt: string; /** The completed trace, verbatim. */
+export type TraceRecord = {
+  /** Discriminator for the record format — always `"trace"` today. */
+  type: "trace";
+  /** ISO-8601 timestamp the exporter wrote this record. */
+  exportedAt: string;
+  /** The completed trace, verbatim. */
   trace: Trace;
 };
 /**
  * Options for {@link fileExporter}.
  */
-type FileExporterOptions = {
+export type FileExporterOptions = {
   /**
    * Absolute or cwd-relative path of the JSON-Lines file traces are
    * appended to. The parent directory is created on first write if
@@ -35,5 +39,4 @@ type FileExporterOptions = {
   pretty?: boolean;
 };
 //#endregion
-export { FileExporterOptions, TraceRecord };
 //# sourceMappingURL=file-exporter.type.d.mts.map

package/esm/exporters/file/file-exporter.type.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"file-exporter.type.d.mts","names":[],"sources":["../../../../../../../../../packages/ai-panoptic/src/exporters/file/file-exporter.type.ts"],"mappings":";;;;;AAQA;;;KAAY,WAAA;EAEV,oEAAA,IAAA,WAIA;EAFA,UAAA,UAEY;EAAZ,KAAA,EAAO,KAAK;AAAA;;;;KAMF,mBAAA;EAYV;;;AAMM;;EAZN,IAAA;;;;;;EAMA,UAAA;;;;;;EAMA,MAAA;AAAA"}
+{"version":3,"file":"file-exporter.type.d.mts","names":[],"sources":["../../../../../../../../../packages/ai-panoptic/src/exporters/file/file-exporter.type.ts"],"mappings":";;;;;;;;;YAQY;;EAEV;;EAEA;;EAEA,OAAO;;;;;YAMG;;;;;;EAMV;;;;;;EAMA;;;;;;EAMA"}

package/esm/exporters/file/index.d.mts

@@ -1,2 +1,3 @@
 import { FileExporterOptions, TraceRecord } from "./file-exporter.type.mjs";
-import { fileExporter } from "./file-exporter.mjs";
+import { fileExporter } from "./file-exporter.mjs";
+export { type FileExporterOptions, type TraceRecord, fileExporter };

package/esm/exporters/index.d.mts

@@ -2,12 +2,18 @@ import { ConsoleExporterOptions, ConsoleLike } from "./console/console-exporter.
 import { consoleExporter } from "./console/console-exporter.mjs";
 import { formatSpanLine } from "./console/format-span-line.mjs";
 import { formatSpanIO } from "./console/format-span-io.mjs";
+import "./console/index.mjs";
 import { FileExporterOptions, TraceRecord } from "./file/file-exporter.type.mjs";
 import { fileExporter } from "./file/file-exporter.mjs";
+import "./file/index.mjs";
 import { LangfuseClientLike, LangfuseExporterOptions, LangfuseObservationBody, LangfuseObservationEndBody, LangfuseObservationLevel, LangfuseObservationLike, LangfuseTraceBody, LangfuseTraceLike, LangfuseUsageBody } from "./langfuse/langfuse-exporter.type.mjs";
 import { langfuseExporter } from "./langfuse/langfuse-exporter.mjs";
+import "./langfuse/index.mjs";
 import { OtelExporterOptions } from "./otel/otel-exporter.type.mjs";
 import { otelExporter } from "./otel/otel-exporter.mjs";
+import "./otel/index.mjs";
 import { AttributeValue, GEN_AI_ATTRIBUTES, WARLOCK_ATTRIBUTES, toGenAiAttributes } from "./utils/gen-ai-attributes.mjs";
 import { totalCostUsd } from "./utils/total-cost.mjs";
-import { walkSpans } from "./utils/walk-spans.mjs";
+import { walkSpans } from "./utils/walk-spans.mjs";
+import "./utils/index.mjs";
+export { type AttributeValue, type ConsoleExporterOptions, type ConsoleLike, type FileExporterOptions, GEN_AI_ATTRIBUTES, type LangfuseClientLike, type LangfuseExporterOptions, type LangfuseObservationBody, type LangfuseObservationEndBody, type LangfuseObservationLevel, type LangfuseObservationLike, type LangfuseTraceBody, type LangfuseTraceLike, type LangfuseUsageBody, type OtelExporterOptions, type TraceRecord, WARLOCK_ATTRIBUTES, consoleExporter, fileExporter, formatSpanIO, formatSpanLine, langfuseExporter, otelExporter, toGenAiAttributes, totalCostUsd, walkSpans };

package/esm/exporters/index.mjs

@@ -12,4 +12,4 @@ import "./langfuse/index.mjs";
 import { otelExporter } from "./otel/otel-exporter.mjs";
 import "./otel/index.mjs";
 
-export {  };
+export { GEN_AI_ATTRIBUTES, WARLOCK_ATTRIBUTES, consoleExporter, fileExporter, formatSpanIO, formatSpanLine, langfuseExporter, otelExporter, toGenAiAttributes, totalCostUsd, walkSpans };

package/esm/exporters/langfuse/index.d.mts

@@ -1,2 +1,3 @@
 import { LangfuseClientLike, LangfuseExporterOptions, LangfuseObservationBody, LangfuseObservationEndBody, LangfuseObservationLevel, LangfuseObservationLike, LangfuseTraceBody, LangfuseTraceLike, LangfuseUsageBody } from "./langfuse-exporter.type.mjs";
-import { langfuseExporter } from "./langfuse-exporter.mjs";
+import { langfuseExporter } from "./langfuse-exporter.mjs";
+export { type LangfuseClientLike, type LangfuseExporterOptions, type LangfuseObservationBody, type LangfuseObservationEndBody, type LangfuseObservationLevel, type LangfuseObservationLike, type LangfuseTraceBody, type LangfuseTraceLike, type LangfuseUsageBody, langfuseExporter };

package/esm/exporters/langfuse/index.mjs

@@ -1,3 +1,3 @@
 import { langfuseExporter } from "./langfuse-exporter.mjs";
 
-export {  };
+export { langfuseExporter };

package/esm/exporters/langfuse/langfuse-exporter.d.mts

@@ -1,6 +1,6 @@
 import { ExporterContract } from "../../contracts/exporter.contract.mjs";
+import "../../contracts/index.mjs";
 import { LangfuseExporterOptions } from "./langfuse-exporter.type.mjs";
-
 //#region ../../packages/ai-panoptic/src/exporters/langfuse/langfuse-exporter.d.ts
 /**
  * {@link ExporterContract} that maps Panoptic traces onto Langfuse
@@ -25,7 +25,6 @@ import { LangfuseExporterOptions } from "./langfuse-exporter.type.mjs";
  * // or reuse an existing client:
  * collector.use(langfuseExporter({ client: myLangfuse }));
  */
-declare function langfuseExporter(options: LangfuseExporterOptions): ExporterContract;
+export declare function langfuseExporter(options: LangfuseExporterOptions): ExporterContract;
 //#endregion
-export { langfuseExporter };
 //# sourceMappingURL=langfuse-exporter.d.mts.map

package/esm/exporters/langfuse/langfuse-exporter.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"langfuse-exporter.d.mts","names":[],"sources":["../../../../../../../../../packages/ai-panoptic/src/exporters/langfuse/langfuse-exporter.ts"],"mappings":";;;;;;;AAqFA;;;;;;;;AAAoF;;;;;;;;;;;;iBAApE,gBAAA,CAAiB,OAAA,EAAS,uBAAA,GAA0B,gBAAgB"}
+{"version":3,"file":"langfuse-exporter.d.mts","names":[],"sources":["../../../../../../../../../packages/ai-panoptic/src/exporters/langfuse/langfuse-exporter.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;wBAqFgB,iBAAiB,SAAS,0BAA0B"}

package/esm/exporters/langfuse/langfuse-exporter.mjs

@@ -175,7 +175,7 @@ function ownUsage(span) {
 * rolled-up subtree totals next to an own-usage `usage` block. Cost is
 * omitted for the same reason; Langfuse prices the own tokens itself.
 */
-const LANGFUSE_METADATA_OMIT = new Set([
+const LANGFUSE_METADATA_OMIT = /* @__PURE__ */ new Set([
 	GEN_AI_ATTRIBUTES.usageInputTokens,
 	GEN_AI_ATTRIBUTES.usageOutputTokens,
 	WARLOCK_ATTRIBUTES.totalTokens,

package/esm/exporters/langfuse/langfuse-exporter.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"langfuse-exporter.mjs","names":[],"sources":["../../../../../../../../../packages/ai-panoptic/src/exporters/langfuse/langfuse-exporter.ts"],"sourcesContent":["import type { ExporterContract, Trace, TraceSpan } from \"../../contracts\";\nimport type { AttributeValue } from \"../utils\";\nimport { GEN_AI_ATTRIBUTES, toGenAiAttributes, WARLOCK_ATTRIBUTES } from \"../utils\";\nimport type {\n  LangfuseClientLike,\n  LangfuseExporterOptions,\n  LangfuseObservationBody,\n  LangfuseObservationLevel,\n  LangfuseObservationLike,\n  LangfuseTraceBody,\n  LangfuseTraceLike,\n} from \"./langfuse-exporter.type\";\n\nconst EXPORTER_NAME = \"langfuse\";\n\n// ============================================================\n// Lazily-loaded langfuse SDK (OPTIONAL peer)\n// ============================================================\n\nlet LangfuseSdk: typeof import(\"langfuse\");\nlet isModuleExists: boolean | null = null;\nlet loadingPromise: Promise<void> | undefined;\n\nconst LANGFUSE_INSTALL_INSTRUCTIONS = `\nThe Panoptic Langfuse exporter requires the langfuse package.\nInstall it with:\n\n  npm install langfuse\n\nOr with your preferred package manager:\n\n  pnpm add langfuse\n  yarn add langfuse\n`.trim();\n\n/**\n * Settle the lazy import of `langfuse` once, concurrency-safe. Only\n * needed when the caller did not pass a ready `client`. A bare `catch`\n * flips the flag to `false`; the curated install string surfaces at use\n * time, never a raw module-resolution stack trace.\n */\nfunction loadLangfuse(): Promise<void> {\n  if (isModuleExists !== null) {\n    return Promise.resolve();\n  }\n\n  if (loadingPromise) {\n    return loadingPromise;\n  }\n\n  loadingPromise = (async () => {\n    try {\n      LangfuseSdk = await import(\"langfuse\");\n      isModuleExists = true;\n    } catch {\n      isModuleExists = false;\n    }\n  })();\n\n  return loadingPromise;\n}\n\n/**\n * {@link ExporterContract} that maps Panoptic traces onto Langfuse\n * traces and observations. Lazily imports `langfuse` so it stays an\n * OPTIONAL peer — importing this module never forces the SDK to be\n * installed, and a missing SDK surfaces as a curated \"install this\"\n * error when the exporter first needs to build a client.\n *\n * The root {@link TraceSpan} becomes a Langfuse trace AND its top\n * observation (so the root execution's own tokens are metered, not just\n * its children's); every node is an observation — a `generation` when it\n * metered its OWN tokens (LLM-backed agents, supervisors), otherwise a\n * plain `span` (tools, callbacks, and composite nodes whose tokens came\n * only from children). Timing, status, and version map 1:1; each\n * generation reports its own token usage (rolled-up minus children) so\n * the trace total isn't double-counted; non-usage GenAI attributes ride\n * along as metadata, and captured content (under `captureContent`)\n * surfaces as native `input` / `output`.\n *\n * @example\n * collector.use(langfuseExporter({ publicKey: \"pk-...\", secretKey: \"sk-...\" }));\n * // or reuse an existing client:\n * collector.use(langfuseExporter({ client: myLangfuse }));\n */\nexport function langfuseExporter(options: LangfuseExporterOptions): ExporterContract {\n  let client: LangfuseClientLike | undefined = options.client;\n\n  if (!client) {\n    loadLangfuse();\n  }\n\n  const resolveClient = async (): Promise<LangfuseClientLike> => {\n    if (client) {\n      return client;\n    }\n\n    await loadLangfuse();\n\n    if (!isModuleExists) {\n      throw new Error(LANGFUSE_INSTALL_INSTRUCTIONS);\n    }\n\n    client = new LangfuseSdk.Langfuse({\n      publicKey: options.publicKey,\n      secretKey: options.secretKey,\n      baseUrl: options.baseUrl,\n    }) as unknown as LangfuseClientLike;\n\n    return client;\n  };\n\n  return {\n    name: EXPORTER_NAME,\n    async export(trace: Trace): Promise<void> {\n      const activeClient = await resolveClient();\n      emitTrace(activeClient, trace);\n    },\n    async flush(): Promise<void> {\n      if (!client) {\n        return;\n      }\n\n      await client.flushAsync();\n    },\n    async shutdown(): Promise<void> {\n      if (!client) {\n        return;\n      }\n\n      await client.shutdownAsync();\n    },\n  };\n}\n\n/**\n * Create the Langfuse trace from the root span, then recurse the\n * children into nested observations.\n */\nfunction emitTrace(client: LangfuseClientLike, trace: Trace): void {\n  const root = trace.root;\n\n  const traceBody: LangfuseTraceBody = {\n    id: root.traceId,\n    name: root.name,\n    sessionId: trace.sessionId,\n    version: root.version,\n    timestamp: new Date(root.startedAt),\n    metadata: langfuseMetadata(root),\n  };\n\n  // Surface the root's captured content at the TRACE level too — not only on\n  // the root observation — so Langfuse's trace Preview shows the top-level\n  // input/output instead of \"this trace received no input/output\". Present\n  // only under content capture, and only for roots that carry I/O (an agent\n  // or tool; a composite root like a planner has none of its own).\n  if (root.input !== undefined) {\n    traceBody.input = root.input;\n  }\n\n  if (root.output !== undefined) {\n    traceBody.output = root.output;\n  }\n\n  const langfuseTrace = client.trace(traceBody);\n\n  // Emit the ROOT as an observation too — not just its children — so the\n  // root execution's OWN tokens are metered. Langfuse derives the trace\n  // total by summing observation usage; leaving the root (often the single\n  // top-level agent) as trace-only would drop its own spend. Children nest\n  // under the root observation, mirroring the execution tree, and own-usage\n  // metering telescopes the per-node sums back to the true trace total.\n  emitObservation(langfuseTrace, root);\n}\n\n/**\n * Map one {@link TraceSpan} onto a Langfuse observation under `parent`,\n * then recurse its children. Spans that metered their OWN tokens become\n * `generation`s; everything else (tools, callbacks, composite nodes)\n * becomes a plain `span`.\n */\nfunction emitObservation(\n  parent: LangfuseTraceLike | LangfuseObservationLike,\n  span: TraceSpan,\n): void {\n  const body: LangfuseObservationBody = {\n    id: span.spanId,\n    name: span.name,\n    startTime: new Date(span.startedAt),\n    endTime: new Date(span.endedAt),\n    level: toLevel(span),\n    statusMessage: span.error?.message,\n    version: span.version,\n    metadata: langfuseMetadata(span),\n  };\n\n  // Captured content (only present under `captureContent`) maps onto\n  // Langfuse's native observation input/output.\n  if (span.input !== undefined) {\n    body.input = span.input;\n  }\n\n  if (span.output !== undefined) {\n    body.output = span.output;\n  }\n\n  let observation: LangfuseObservationLike;\n\n  // Classify + meter on OWN tokens (this node's rolled-up usage minus its\n  // children's), not the subtree rollup. A composite node whose tokens\n  // came only from descendants has zero own-usage and becomes a plain\n  // span — so its children's tokens aren't counted twice in the trace\n  // total Langfuse sums across observations.\n  const own = ownUsage(span);\n\n  if (own.total > 0) {\n    body.usage = {\n      input: own.input,\n      output: own.output,\n      total: own.total,\n      unit: \"TOKENS\",\n    };\n    observation = parent.generation(body);\n  } else {\n    observation = parent.span(body);\n  }\n\n  for (const child of span.children) {\n    emitObservation(observation, child);\n  }\n\n  // Explicitly end the observation. The body already carries `endTime`,\n  // so this is idempotent — but the SDK only finalizes (and flushes) an\n  // observation on `end()`, so without it long-lived clients can leave\n  // observations open. Safe against the local `LangfuseObservationLike`\n  // shape, which declares `end(body?)`.\n  observation.end({ endTime: body.endTime });\n}\n\n/**\n * Own token usage for a span — its rolled-up {@link TraceSpan.usage}\n * minus the rolled-up usage of its direct children. `TraceSpan.usage` is\n * the subtree total (this node plus every descendant), so subtracting the\n * children leaves the tokens THIS node alone metered, clamped at zero\n * defensively.\n *\n * Langfuse sums observation usage into the trace total, so reporting\n * own-usage on each generation (rather than the subtree rollup) is what\n * keeps the trace total correct instead of multiply-counting nested\n * spans. A composite node with no own tokens (e.g. a workflow whose\n * tokens all came from agent children) yields `total: 0` and is emitted\n * as a plain span, not a generation.\n */\nfunction ownUsage(span: TraceSpan): { input: number; output: number; total: number } {\n  let childInput = 0;\n  let childOutput = 0;\n  let childTotal = 0;\n\n  for (const child of span.children) {\n    childInput += child.usage.input;\n    childOutput += child.usage.output;\n    childTotal += child.usage.total;\n  }\n\n  return {\n    input: Math.max(0, span.usage.input - childInput),\n    output: Math.max(0, span.usage.output - childOutput),\n    total: Math.max(0, span.usage.total - childTotal),\n  };\n}\n\n/**\n * Token-usage + cost keys that the per-observation `usage` block already\n * carries authoritatively (as OWN usage). Omitting them from `metadata`\n * avoids a confusing contradiction — metadata would otherwise show the\n * rolled-up subtree totals next to an own-usage `usage` block. Cost is\n * omitted for the same reason; Langfuse prices the own tokens itself.\n */\nconst LANGFUSE_METADATA_OMIT = new Set<string>([\n  GEN_AI_ATTRIBUTES.usageInputTokens,\n  GEN_AI_ATTRIBUTES.usageOutputTokens,\n  WARLOCK_ATTRIBUTES.totalTokens,\n  WARLOCK_ATTRIBUTES.cachedTokens,\n  WARLOCK_ATTRIBUTES.reasoningTokens,\n  WARLOCK_ATTRIBUTES.costUsd,\n]);\n\n/**\n * Observation metadata — the GenAI attribute set minus the usage/cost\n * keys that live authoritatively on the `usage` block (see\n * {@link LANGFUSE_METADATA_OMIT}). Keeps model identity, report type,\n * version, session id, and any collector-set attributes.\n */\nfunction langfuseMetadata(span: TraceSpan): Record<string, AttributeValue> {\n  const all = toGenAiAttributes(span);\n  const metadata: Record<string, AttributeValue> = {};\n\n  for (const [key, value] of Object.entries(all)) {\n    if (!LANGFUSE_METADATA_OMIT.has(key)) {\n      metadata[key] = value;\n    }\n  }\n\n  return metadata;\n}\n\n/**\n * Map the Panoptic span status onto a Langfuse observation level —\n * failed/cancelled/incomplete spans surface as `ERROR`, everything else `DEFAULT`.\n */\nfunction toLevel(span: TraceSpan): LangfuseObservationLevel {\n  if (span.status === \"failed\" || span.status === \"cancelled\" || span.status === \"incomplete\") {\n    return \"ERROR\";\n  }\n\n  return \"DEFAULT\";\n}\n"],"mappings":"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"}
+{"version":3,"file":"langfuse-exporter.mjs","names":[],"sources":["../../../../../../../../../packages/ai-panoptic/src/exporters/langfuse/langfuse-exporter.ts"],"sourcesContent":["import type { ExporterContract, Trace, TraceSpan } from \"../../contracts\";\nimport type { AttributeValue } from \"../utils\";\nimport { GEN_AI_ATTRIBUTES, toGenAiAttributes, WARLOCK_ATTRIBUTES } from \"../utils\";\nimport type {\n  LangfuseClientLike,\n  LangfuseExporterOptions,\n  LangfuseObservationBody,\n  LangfuseObservationLevel,\n  LangfuseObservationLike,\n  LangfuseTraceBody,\n  LangfuseTraceLike,\n} from \"./langfuse-exporter.type\";\n\nconst EXPORTER_NAME = \"langfuse\";\n\n// ============================================================\n// Lazily-loaded langfuse SDK (OPTIONAL peer)\n// ============================================================\n\nlet LangfuseSdk: typeof import(\"langfuse\");\nlet isModuleExists: boolean | null = null;\nlet loadingPromise: Promise<void> | undefined;\n\nconst LANGFUSE_INSTALL_INSTRUCTIONS = `\nThe Panoptic Langfuse exporter requires the langfuse package.\nInstall it with:\n\n  npm install langfuse\n\nOr with your preferred package manager:\n\n  pnpm add langfuse\n  yarn add langfuse\n`.trim();\n\n/**\n * Settle the lazy import of `langfuse` once, concurrency-safe. Only\n * needed when the caller did not pass a ready `client`. A bare `catch`\n * flips the flag to `false`; the curated install string surfaces at use\n * time, never a raw module-resolution stack trace.\n */\nfunction loadLangfuse(): Promise<void> {\n  if (isModuleExists !== null) {\n    return Promise.resolve();\n  }\n\n  if (loadingPromise) {\n    return loadingPromise;\n  }\n\n  loadingPromise = (async () => {\n    try {\n      LangfuseSdk = await import(\"langfuse\");\n      isModuleExists = true;\n    } catch {\n      isModuleExists = false;\n    }\n  })();\n\n  return loadingPromise;\n}\n\n/**\n * {@link ExporterContract} that maps Panoptic traces onto Langfuse\n * traces and observations. Lazily imports `langfuse` so it stays an\n * OPTIONAL peer — importing this module never forces the SDK to be\n * installed, and a missing SDK surfaces as a curated \"install this\"\n * error when the exporter first needs to build a client.\n *\n * The root {@link TraceSpan} becomes a Langfuse trace AND its top\n * observation (so the root execution's own tokens are metered, not just\n * its children's); every node is an observation — a `generation` when it\n * metered its OWN tokens (LLM-backed agents, supervisors), otherwise a\n * plain `span` (tools, callbacks, and composite nodes whose tokens came\n * only from children). Timing, status, and version map 1:1; each\n * generation reports its own token usage (rolled-up minus children) so\n * the trace total isn't double-counted; non-usage GenAI attributes ride\n * along as metadata, and captured content (under `captureContent`)\n * surfaces as native `input` / `output`.\n *\n * @example\n * collector.use(langfuseExporter({ publicKey: \"pk-...\", secretKey: \"sk-...\" }));\n * // or reuse an existing client:\n * collector.use(langfuseExporter({ client: myLangfuse }));\n */\nexport function langfuseExporter(options: LangfuseExporterOptions): ExporterContract {\n  let client: LangfuseClientLike | undefined = options.client;\n\n  if (!client) {\n    loadLangfuse();\n  }\n\n  const resolveClient = async (): Promise<LangfuseClientLike> => {\n    if (client) {\n      return client;\n    }\n\n    await loadLangfuse();\n\n    if (!isModuleExists) {\n      throw new Error(LANGFUSE_INSTALL_INSTRUCTIONS);\n    }\n\n    client = new LangfuseSdk.Langfuse({\n      publicKey: options.publicKey,\n      secretKey: options.secretKey,\n      baseUrl: options.baseUrl,\n    }) as unknown as LangfuseClientLike;\n\n    return client;\n  };\n\n  return {\n    name: EXPORTER_NAME,\n    async export(trace: Trace): Promise<void> {\n      const activeClient = await resolveClient();\n      emitTrace(activeClient, trace);\n    },\n    async flush(): Promise<void> {\n      if (!client) {\n        return;\n      }\n\n      await client.flushAsync();\n    },\n    async shutdown(): Promise<void> {\n      if (!client) {\n        return;\n      }\n\n      await client.shutdownAsync();\n    },\n  };\n}\n\n/**\n * Create the Langfuse trace from the root span, then recurse the\n * children into nested observations.\n */\nfunction emitTrace(client: LangfuseClientLike, trace: Trace): void {\n  const root = trace.root;\n\n  const traceBody: LangfuseTraceBody = {\n    id: root.traceId,\n    name: root.name,\n    sessionId: trace.sessionId,\n    version: root.version,\n    timestamp: new Date(root.startedAt),\n    metadata: langfuseMetadata(root),\n  };\n\n  // Surface the root's captured content at the TRACE level too — not only on\n  // the root observation — so Langfuse's trace Preview shows the top-level\n  // input/output instead of \"this trace received no input/output\". Present\n  // only under content capture, and only for roots that carry I/O (an agent\n  // or tool; a composite root like a planner has none of its own).\n  if (root.input !== undefined) {\n    traceBody.input = root.input;\n  }\n\n  if (root.output !== undefined) {\n    traceBody.output = root.output;\n  }\n\n  const langfuseTrace = client.trace(traceBody);\n\n  // Emit the ROOT as an observation too — not just its children — so the\n  // root execution's OWN tokens are metered. Langfuse derives the trace\n  // total by summing observation usage; leaving the root (often the single\n  // top-level agent) as trace-only would drop its own spend. Children nest\n  // under the root observation, mirroring the execution tree, and own-usage\n  // metering telescopes the per-node sums back to the true trace total.\n  emitObservation(langfuseTrace, root);\n}\n\n/**\n * Map one {@link TraceSpan} onto a Langfuse observation under `parent`,\n * then recurse its children. Spans that metered their OWN tokens become\n * `generation`s; everything else (tools, callbacks, composite nodes)\n * becomes a plain `span`.\n */\nfunction emitObservation(\n  parent: LangfuseTraceLike | LangfuseObservationLike,\n  span: TraceSpan,\n): void {\n  const body: LangfuseObservationBody = {\n    id: span.spanId,\n    name: span.name,\n    startTime: new Date(span.startedAt),\n    endTime: new Date(span.endedAt),\n    level: toLevel(span),\n    statusMessage: span.error?.message,\n    version: span.version,\n    metadata: langfuseMetadata(span),\n  };\n\n  // Captured content (only present under `captureContent`) maps onto\n  // Langfuse's native observation input/output.\n  if (span.input !== undefined) {\n    body.input = span.input;\n  }\n\n  if (span.output !== undefined) {\n    body.output = span.output;\n  }\n\n  let observation: LangfuseObservationLike;\n\n  // Classify + meter on OWN tokens (this node's rolled-up usage minus its\n  // children's), not the subtree rollup. A composite node whose tokens\n  // came only from descendants has zero own-usage and becomes a plain\n  // span — so its children's tokens aren't counted twice in the trace\n  // total Langfuse sums across observations.\n  const own = ownUsage(span);\n\n  if (own.total > 0) {\n    body.usage = {\n      input: own.input,\n      output: own.output,\n      total: own.total,\n      unit: \"TOKENS\",\n    };\n    observation = parent.generation(body);\n  } else {\n    observation = parent.span(body);\n  }\n\n  for (const child of span.children) {\n    emitObservation(observation, child);\n  }\n\n  // Explicitly end the observation. The body already carries `endTime`,\n  // so this is idempotent — but the SDK only finalizes (and flushes) an\n  // observation on `end()`, so without it long-lived clients can leave\n  // observations open. Safe against the local `LangfuseObservationLike`\n  // shape, which declares `end(body?)`.\n  observation.end({ endTime: body.endTime });\n}\n\n/**\n * Own token usage for a span — its rolled-up {@link TraceSpan.usage}\n * minus the rolled-up usage of its direct children. `TraceSpan.usage` is\n * the subtree total (this node plus every descendant), so subtracting the\n * children leaves the tokens THIS node alone metered, clamped at zero\n * defensively.\n *\n * Langfuse sums observation usage into the trace total, so reporting\n * own-usage on each generation (rather than the subtree rollup) is what\n * keeps the trace total correct instead of multiply-counting nested\n * spans. A composite node with no own tokens (e.g. a workflow whose\n * tokens all came from agent children) yields `total: 0` and is emitted\n * as a plain span, not a generation.\n */\nfunction ownUsage(span: TraceSpan): { input: number; output: number; total: number } {\n  let childInput = 0;\n  let childOutput = 0;\n  let childTotal = 0;\n\n  for (const child of span.children) {\n    childInput += child.usage.input;\n    childOutput += child.usage.output;\n    childTotal += child.usage.total;\n  }\n\n  return {\n    input: Math.max(0, span.usage.input - childInput),\n    output: Math.max(0, span.usage.output - childOutput),\n    total: Math.max(0, span.usage.total - childTotal),\n  };\n}\n\n/**\n * Token-usage + cost keys that the per-observation `usage` block already\n * carries authoritatively (as OWN usage). Omitting them from `metadata`\n * avoids a confusing contradiction — metadata would otherwise show the\n * rolled-up subtree totals next to an own-usage `usage` block. Cost is\n * omitted for the same reason; Langfuse prices the own tokens itself.\n */\nconst LANGFUSE_METADATA_OMIT = new Set<string>([\n  GEN_AI_ATTRIBUTES.usageInputTokens,\n  GEN_AI_ATTRIBUTES.usageOutputTokens,\n  WARLOCK_ATTRIBUTES.totalTokens,\n  WARLOCK_ATTRIBUTES.cachedTokens,\n  WARLOCK_ATTRIBUTES.reasoningTokens,\n  WARLOCK_ATTRIBUTES.costUsd,\n]);\n\n/**\n * Observation metadata — the GenAI attribute set minus the usage/cost\n * keys that live authoritatively on the `usage` block (see\n * {@link LANGFUSE_METADATA_OMIT}). Keeps model identity, report type,\n * version, session id, and any collector-set attributes.\n */\nfunction langfuseMetadata(span: TraceSpan): Record<string, AttributeValue> {\n  const all = toGenAiAttributes(span);\n  const metadata: Record<string, AttributeValue> = {};\n\n  for (const [key, value] of Object.entries(all)) {\n    if (!LANGFUSE_METADATA_OMIT.has(key)) {\n      metadata[key] = value;\n    }\n  }\n\n  return metadata;\n}\n\n/**\n * Map the Panoptic span status onto a Langfuse observation level —\n * failed/cancelled/incomplete spans surface as `ERROR`, everything else `DEFAULT`.\n */\nfunction toLevel(span: TraceSpan): LangfuseObservationLevel {\n  if (span.status === \"failed\" || span.status === \"cancelled\" || span.status === \"incomplete\") {\n    return \"ERROR\";\n  }\n\n  return \"DEFAULT\";\n}\n"],"mappings":"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"}

package/esm/exporters/langfuse/langfuse-exporter.type.d.mts

@@ -8,7 +8,7 @@
  * creates nested `span` / `generation` observations, and the client is
  * drained with `flushAsync` / `shutdownAsync`.
  */
-type LangfuseClientLike = {
+export type LangfuseClientLike = {
   trace(body: LangfuseTraceBody): LangfuseTraceLike;
   flushAsync(): Promise<unknown>;
   shutdownAsync(): Promise<unknown>;
@@ -17,7 +17,7 @@ type LangfuseClientLike = {
  * A Langfuse trace handle — creates nested observations and carries the
  * trace-level metadata Panoptic maps the root span onto.
  */
-type LangfuseTraceLike = {
+export type LangfuseTraceLike = {
   span(body: LangfuseObservationBody): LangfuseObservationLike;
   generation(body: LangfuseObservationBody): LangfuseObservationLike;
 };
@@ -25,24 +25,26 @@ type LangfuseTraceLike = {
  * A Langfuse observation handle (span or generation) — nests further
  * children and is closed with `end()`.
  */
-type LangfuseObservationLike = {
+export type LangfuseObservationLike = {
   span(body: LangfuseObservationBody): LangfuseObservationLike;
   generation(body: LangfuseObservationBody): LangfuseObservationLike;
   end(body?: LangfuseObservationEndBody): unknown;
 };
 /** Subset of the Langfuse trace-creation body Panoptic populates. */
-type LangfuseTraceBody = {
+export type LangfuseTraceBody = {
   id?: string;
   name?: string;
   sessionId?: string;
   version?: string;
   timestamp?: Date;
-  metadata?: Record<string, unknown>; /** Root input surfaced at trace level (set only under content capture). */
-  input?: unknown; /** Root output surfaced at trace level (set only under content capture). */
+  metadata?: Record<string, unknown>;
+  /** Root input surfaced at trace level (set only under content capture). */
+  input?: unknown;
+  /** Root output surfaced at trace level (set only under content capture). */
   output?: unknown;
 };
 /** Subset of the Langfuse observation-creation body Panoptic populates. */
-type LangfuseObservationBody = {
+export type LangfuseObservationBody = {
   id?: string;
   name?: string;
   startTime?: Date;
@@ -51,25 +53,27 @@ type LangfuseObservationBody = {
   statusMessage?: string;
   version?: string;
   usage?: LangfuseUsageBody;
-  metadata?: Record<string, unknown>; /** Captured input (prompt / tool args), set only under content capture. */
-  input?: unknown; /** Captured output (completion / tool result), set only under content capture. */
+  metadata?: Record<string, unknown>;
+  /** Captured input (prompt / tool args), set only under content capture. */
+  input?: unknown;
+  /** Captured output (completion / tool result), set only under content capture. */
   output?: unknown;
 };
 /** Body accepted by `observation.end()`. */
-type LangfuseObservationEndBody = {
+export type LangfuseObservationEndBody = {
   endTime?: Date;
   level?: LangfuseObservationLevel;
   statusMessage?: string;
 };
 /** Langfuse usage block (`input`/`output`/`total` token counts). */
-type LangfuseUsageBody = {
+export type LangfuseUsageBody = {
   input?: number;
   output?: number;
   total?: number;
   unit?: "TOKENS";
 };
 /** Langfuse observation severity levels. */
-type LangfuseObservationLevel = "DEFAULT" | "DEBUG" | "WARNING" | "ERROR";
+export type LangfuseObservationLevel = "DEFAULT" | "DEBUG" | "WARNING" | "ERROR";
 /**
  * Options for {@link langfuseExporter}.
  *
@@ -78,17 +82,19 @@ type LangfuseObservationLevel = "DEFAULT" | "DEBUG" | "WARNING" | "ERROR";
  * stays an optional peer that is only imported when this exporter is
  * actually used).
  */
-type LangfuseExporterOptions = {
+export type LangfuseExporterOptions = {
   /**
    * A pre-built Langfuse client (any object matching
    * {@link LangfuseClientLike}, including a real `Langfuse` instance).
    * When supplied, the exporter never imports the SDK itself.
    */
-  client?: LangfuseClientLike; /** Langfuse public key — used to construct a client when `client` is omitted. */
-  publicKey?: string; /** Langfuse secret key — used to construct a client when `client` is omitted. */
-  secretKey?: string; /** Langfuse host base URL. Optional; defaults to the SDK's own default. */
+  client?: LangfuseClientLike;
+  /** Langfuse public key — used to construct a client when `client` is omitted. */
+  publicKey?: string;
+  /** Langfuse secret key — used to construct a client when `client` is omitted. */
+  secretKey?: string;
+  /** Langfuse host base URL. Optional; defaults to the SDK's own default. */
   baseUrl?: string;
 };
 //#endregion
-export { LangfuseClientLike, LangfuseExporterOptions, LangfuseObservationBody, LangfuseObservationEndBody, LangfuseObservationLevel, LangfuseObservationLike, LangfuseTraceBody, LangfuseTraceLike, LangfuseUsageBody };
 //# sourceMappingURL=langfuse-exporter.type.d.mts.map

package/esm/exporters/langfuse/langfuse-exporter.type.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"langfuse-exporter.type.d.mts","names":[],"sources":["../../../../../../../../../packages/ai-panoptic/src/exporters/langfuse/langfuse-exporter.type.ts"],"mappings":";;AASA;;;;;;;;KAAY,kBAAA;EACV,KAAA,CAAM,IAAA,EAAM,iBAAA,GAAoB,iBAAA;EAChC,UAAA,IAAc,OAAA;EACd,aAAA,IAAiB,OAAA;AAAA;;;;;KAOP,iBAAA;EACV,IAAA,CAAK,IAAA,EAAM,uBAAA,GAA0B,uBAAA;EACrC,UAAA,CAAW,IAAA,EAAM,uBAAA,GAA0B,uBAAA;AAAA;;;;;KAOjC,uBAAA;EACV,IAAA,CAAK,IAAA,EAAM,uBAAA,GAA0B,uBAAA;EACrC,UAAA,CAAW,IAAA,EAAM,uBAAA,GAA0B,uBAAA;EAC3C,GAAA,CAAI,IAAA,GAAO,0BAAA;AAAA;;KAID,iBAAA;EACV,EAAA;EACA,IAAA;EACA,SAAA;EACA,OAAA;EACA,SAAA,GAAY,IAAA;EACZ,QAAA,GAAW,MAAM,mBAbP;EAeV,KAAA;EAEA,MAAA;AAAA;;KAIU,uBAAA;EACV,EAAA;EACA,IAAA;EACA,SAAA,GAAY,IAAA;EACZ,OAAA,GAAU,IAAA;EACV,KAAA,GAAQ,wBAAA;EACR,aAAA;EACA,OAAA;EACA,KAAA,GAAQ,iBAAA;EACR,QAAA,GAAW,MAAA,mBA5BA;EA8BX,KAAA,YA7BA;EA+BA,MAAA;AAAA;;KAIU,0BAAA;EACV,OAAA,GAAU,IAAA;EACV,KAAA,GAAQ,wBAAwB;EAChC,aAAA;AAAA;;KAIU,iBAAA;EACV,KAAA;EACA,MAAA;EACA,KAAA;EACA,IAAA;AAAA;;KAIU,wBAAA;;;AApCJ;AAIR;;;;;KA0CY,uBAAA;EAlCF;;;;;EAwCR,MAAA,GAAS,kBAAkB,EA7C3B;EA+CA,SAAA,WA9CA;EAgDA,SAAA,WA/CA;EAiDA,OAAA;AAAA"}
+{"version":3,"file":"langfuse-exporter.type.d.mts","names":[],"sources":["../../../../../../../../../packages/ai-panoptic/src/exporters/langfuse/langfuse-exporter.type.ts"],"mappings":";;;;;;;;;;YASY;EACV,MAAM,MAAM,oBAAoB;EAChC,cAAc;EACd,iBAAiB;;;;;;YAOP;EACV,KAAK,MAAM,0BAA0B;EACrC,WAAW,MAAM,0BAA0B;;;;;;YAOjC;EACV,KAAK,MAAM,0BAA0B;EACrC,WAAW,MAAM,0BAA0B;EAC3C,IAAI,OAAO;;;YAID;EACV;EACA;EACA;EACA;EACA,YAAY;EACZ,WAAW;;EAEX;;EAEA;;;YAIU;EACV;EACA;EACA,YAAY;EACZ,UAAU;EACV,QAAQ;EACR;EACA;EACA,QAAQ;EACR,WAAW;;EAEX;;EAEA;;;YAIU;EACV,UAAU;EACV,QAAQ;EACR;;;YAIU;EACV;EACA;EACA;EACA;;;YAIU;;;;;;;;;YAUA;;;;;;EAMV,SAAS;;EAET;;EAEA;;EAEA"}

package/esm/exporters/otel/index.d.mts

@@ -1,2 +1,3 @@
 import { OtelExporterOptions } from "./otel-exporter.type.mjs";
-import { otelExporter } from "./otel-exporter.mjs";
+import { otelExporter } from "./otel-exporter.mjs";
+export { type OtelExporterOptions, otelExporter };

package/esm/exporters/otel/index.mjs

@@ -1,3 +1,3 @@
 import { otelExporter } from "./otel-exporter.mjs";
 
-export {  };
+export { otelExporter };

package/esm/exporters/otel/otel-api.shim.type.d.mts

@@ -19,20 +19,20 @@
  * not the whole OTel API.
  */
 /** Subset of OTel `TimeInput` the exporter passes (epoch millis). */
-type OtelTimeInput = number;
+export type OtelTimeInput = number;
 /** Opaque OTel `Context` — the exporter only threads it through. */
-type OtelContext = object;
+export type OtelContext = object;
 /**
  * Exception shape accepted by `Span.recordException`. Mirrors the
  * `Exception` object form OTel accepts (name/message/stack).
  */
-type OtelException = {
+export type OtelException = {
   name?: string;
   message?: string;
   stack?: string;
 };
 /** Status object passed to `Span.setStatus`. */
-type OtelSpanStatus = {
+export type OtelSpanStatus = {
   code: number;
   message?: string;
 };
@@ -40,7 +40,7 @@ type OtelSpanStatus = {
  * Subset of OTel `Span` the exporter drives — set attributes/status,
  * record exceptions, and end with a timestamp.
  */
-type OtelSpan = {
+export type OtelSpan = {
   setAttributes(attributes: Record<string, unknown>): void;
   setStatus(status: OtelSpanStatus): void;
   recordException(exception: OtelException): void;
@@ -50,11 +50,10 @@ type OtelSpan = {
  * Subset of OTel `Tracer` the exporter calls. `startSpan` is invoked
  * with a name, a `{ startTime }` options object, and a parent context.
  */
-type OtelTracer = {
+export type OtelTracer = {
   startSpan(name: string, options: {
     startTime?: OtelTimeInput;
   }, context?: OtelContext): OtelSpan;
 };
 //#endregion
-export { OtelTracer };
 //# sourceMappingURL=otel-api.shim.type.d.mts.map

package/esm/exporters/otel/otel-api.shim.type.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"otel-api.shim.type.d.mts","names":[],"sources":["../../../../../../../../../packages/ai-panoptic/src/exporters/otel/otel-api.shim.type.ts"],"mappings":";;AAqBA;;;;AAAyB;AAGzB;;;;AAAuB;AAMvB;;;;;;;;AAGO;AAAA,KAZK,aAAA;;KAGA,WAAA;;AAeH;AAOT;;KAhBY,aAAA;EACV,IAAA;EACA,OAAA;EACA,KAAA;AAAA;;KAIU,cAAA;EACV,IAAA;EACA,OAAO;AAAA;;;;;KAOG,QAAA;EACV,aAAA,CAAc,UAAA,EAAY,MAAA;EAC1B,SAAA,CAAU,MAAA,EAAQ,cAAA;EAClB,eAAA,CAAgB,SAAA,EAAW,aAAA;EAC3B,GAAA,CAAI,OAAA,GAAU,aAAA;AAAA;AAAa;AAO7B;;;AAP6B,KAOjB,UAAA;EACV,SAAA,CAAU,IAAA,UAAc,OAAA;IAAW,SAAA,GAAY,aAAA;EAAA,GAAiB,OAAA,GAAU,WAAA,GAAc,QAAA;AAAA"}
+{"version":3,"file":"otel-api.shim.type.d.mts","names":[],"sources":["../../../../../../../../../packages/ai-panoptic/src/exporters/otel/otel-api.shim.type.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;YAqBY;;YAGA;;;;;YAMA;EACV;EACA;EACA;;;YAIU;EACV;EACA;;;;;;YAOU;EACV,cAAc,YAAY;EAC1B,UAAU,QAAQ;EAClB,gBAAgB,WAAW;EAC3B,IAAI,UAAU;;;;;;YAOJ;EACV,UAAU,cAAc;IAAW,YAAY;KAAiB,UAAU,cAAc"}

package/esm/exporters/otel/otel-exporter.d.mts

@@ -1,6 +1,6 @@
 import { ExporterContract } from "../../contracts/exporter.contract.mjs";
+import "../../contracts/index.mjs";
 import { OtelExporterOptions } from "./otel-exporter.type.mjs";
-
 //#region ../../packages/ai-panoptic/src/exporters/otel/otel-exporter.d.ts
 /**
  * {@link ExporterContract} that maps Panoptic traces onto OpenTelemetry
@@ -23,7 +23,6 @@ import { OtelExporterOptions } from "./otel-exporter.type.mjs";
  * // app already set up @opentelemetry/sdk-trace-base + a provider
  * collector.use(otelExporter({ tracerName: "my-app", system: "openai" }));
  */
-declare function otelExporter(options?: OtelExporterOptions): ExporterContract;
+export declare function otelExporter(options?: OtelExporterOptions): ExporterContract;
 //#endregion
-export { otelExporter };
 //# sourceMappingURL=otel-exporter.d.mts.map

package/esm/exporters/otel/otel-exporter.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"otel-exporter.d.mts","names":[],"sources":["../../../../../../../../../packages/ai-panoptic/src/exporters/otel/otel-exporter.ts"],"mappings":";;;;;;;AAuFA;;;;;;;;AAAiF;;;;;;;;;;iBAAjE,YAAA,CAAa,OAAA,GAAS,mBAAA,GAA2B,gBAAgB"}
+{"version":3,"file":"otel-exporter.d.mts","names":[],"sources":["../../../../../../../../../packages/ai-panoptic/src/exporters/otel/otel-exporter.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;wBAuFgB,aAAa,UAAS,sBAA2B"}

package/esm/exporters/otel/otel-exporter.type.d.mts

@@ -1,5 +1,4 @@
 import { OtelTracer } from "./otel-api.shim.type.mjs";
-
 //#region ../../packages/ai-panoptic/src/exporters/otel/otel-exporter.type.d.ts
 /**
  * Options for {@link otelExporter}.
@@ -10,7 +9,7 @@ import { OtelTracer } from "./otel-api.shim.type.mjs";
  * exporter fetch one from the globally registered provider via
  * `trace.getTracer(name)`.
  */
-type OtelExporterOptions = {
+export type OtelExporterOptions = {
   /**
    * A `Tracer` to emit spans on. When omitted, the exporter lazily calls
    * `trace.getTracer(tracerName, tracerVersion)` against the globally
@@ -39,5 +38,4 @@ type OtelExporterOptions = {
   system?: string;
 };
 //#endregion
-export { OtelExporterOptions };
 //# sourceMappingURL=otel-exporter.type.d.mts.map

package/esm/exporters/otel/otel-exporter.type.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"otel-exporter.type.d.mts","names":[],"sources":["../../../../../../../../../packages/ai-panoptic/src/exporters/otel/otel-exporter.type.ts"],"mappings":";;;;;AAWA;;;;;;;KAAY,mBAAA;EA0BV;;AAAM;;;;;;;EAhBN,MAAA,GAAS,UAAU;;;;;EAKnB,UAAA;;;;;EAKA,aAAA;;;;;;EAMA,MAAA;AAAA"}
+{"version":3,"file":"otel-exporter.type.d.mts","names":[],"sources":["../../../../../../../../../packages/ai-panoptic/src/exporters/otel/otel-exporter.type.ts"],"mappings":";;;;;;;;;;;YAWY;;;;;;;;;;EAUV,SAAS;;;;;EAKT;;;;;EAKA;;;;;;EAMA"}