@coalex-ai/sdk 0.4.5 → 0.5.1

package/dist/ext/retrieval.d.ts

@@ -0,0 +1,22 @@
+export interface Document {
+    content: string;
+    id?: string;
+    score?: number;
+    metadata?: Record<string, unknown>;
+}
+export declare function encodeDocuments(docs: Document[]): string;
+export interface RetrievalSpanOptions {
+    name?: string;
+    queryArg?: string;
+}
+export declare function retrievalSpan<A extends unknown[], R>(options: RetrievalSpanOptions, fn: (...args: A) => R | Promise<R>): (...args: A) => Promise<R>;
+export declare class RetrievalSpan {
+    private readonly spanName;
+    private span;
+    constructor(name?: string);
+    start(): void;
+    setQuery(query: string): void;
+    setDocuments(docs: Document[]): void;
+    end(): void;
+}
+//# sourceMappingURL=retrieval.d.ts.map

package/dist/ext/retrieval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieval.d.ts","sourceRoot":"","sources":["../../src/ext/retrieval.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAYD,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,MAAM,CAExD;AAWD,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,aAAa,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,CAAC,EAClD,OAAO,EAAE,oBAAoB,EAC7B,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACjC,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CA6B5B;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,IAAI,CAAqB;gBAErB,IAAI,SAAc;IAI9B,KAAK,IAAI,IAAI;IAMb,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI7B,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,IAAI;IAKpC,GAAG,IAAI,IAAI;CAIZ"}

package/dist/ext/retrieval.js

@@ -0,0 +1,79 @@
+import { SpanStatusCode } from "@opentelemetry/api";
+import { getTracer } from "./base.js";
+function toOpenInferenceDict(doc) {
+    const d = { "document.content": doc.content };
+    if (doc.id !== undefined)
+        d["document.id"] = doc.id;
+    if (doc.score !== undefined)
+        d["document.score"] = doc.score;
+    if (doc.metadata && Object.keys(doc.metadata).length > 0) {
+        d["document.metadata"] = JSON.stringify(doc.metadata);
+    }
+    return d;
+}
+export function encodeDocuments(docs) {
+    return JSON.stringify(docs.map(toOpenInferenceDict));
+}
+function documentSummary(docs) {
+    let summary = `Retrieved ${docs.length} document(s)`;
+    const ids = docs.filter((d) => d.id).map((d) => d.id);
+    if (ids.length > 0) {
+        summary += `: [${ids.join(", ")}]`;
+    }
+    return summary;
+}
+export function retrievalSpan(options, fn) {
+    const spanName = options.name ?? "retrieval";
+    return async (...args) => {
+        const tracer = getTracer();
+        return tracer.startActiveSpan(spanName, async (span) => {
+            try {
+                span.setAttribute("openinference.span.kind", "RETRIEVER");
+                const query = args.find((a) => typeof a === "string");
+                if (typeof query === "string") {
+                    span.setAttribute("input.value", query);
+                }
+                const result = await fn(...args);
+                if (Array.isArray(result) && result.length > 0 && result[0]?.content !== undefined) {
+                    const docs = result;
+                    span.setAttribute("retrieval.documents", encodeDocuments(docs));
+                    span.setAttribute("output.value", documentSummary(docs));
+                }
+                span.setStatus({ code: SpanStatusCode.OK });
+                return result;
+            }
+            catch (e) {
+                span.setStatus({ code: SpanStatusCode.ERROR, message: String(e) });
+                span.recordException(e instanceof Error ? e : new Error(String(e)));
+                throw e;
+            }
+            finally {
+                span.end();
+            }
+        });
+    };
+}
+export class RetrievalSpan {
+    spanName;
+    span = null;
+    constructor(name = "retrieval") {
+        this.spanName = name;
+    }
+    start() {
+        const tracer = getTracer();
+        this.span = tracer.startSpan(this.spanName);
+        this.span.setAttribute("openinference.span.kind", "RETRIEVER");
+    }
+    setQuery(query) {
+        this.span?.setAttribute("input.value", query);
+    }
+    setDocuments(docs) {
+        this.span?.setAttribute("retrieval.documents", encodeDocuments(docs));
+        this.span?.setAttribute("output.value", documentSummary(docs));
+    }
+    end() {
+        this.span?.setStatus({ code: SpanStatusCode.OK });
+        this.span?.end();
+    }
+}
+//# sourceMappingURL=retrieval.js.map

package/dist/ext/retrieval.js.map

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

package/dist/ext/tool.d.ts

@@ -0,0 +1,6 @@
+export interface ToolSpanOptions {
+    name: string;
+    description?: string;
+}
+export declare function toolSpan<A extends unknown[], R>(options: ToolSpanOptions, fn: (...args: A) => R | Promise<R>): (...args: A) => Promise<R>;
+//# sourceMappingURL=tool.d.ts.map

package/dist/ext/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/ext/tool.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,QAAQ,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,CAAC,EAC7C,OAAO,EAAE,eAAe,EACxB,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACjC,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAuB5B"}

package/dist/ext/tool.js

@@ -0,0 +1,28 @@
+import { getTracer } from "./base.js";
+export function toolSpan(options, fn) {
+    return async (...args) => {
+        const tracer = getTracer();
+        return tracer.startActiveSpan(options.name, async (span) => {
+            try {
+                span.setAttribute("openinference.span.kind", "TOOL");
+                span.setAttribute("tool.name", options.name);
+                if (options.description) {
+                    span.setAttribute("tool.description", options.description);
+                }
+                if (args.length > 0) {
+                    try {
+                        span.setAttribute("tool.parameters", JSON.stringify(args));
+                    }
+                    catch {
+                        // ignore serialization errors
+                    }
+                }
+                return await fn(...args);
+            }
+            finally {
+                span.end();
+            }
+        });
+    };
+}
+//# sourceMappingURL=tool.js.map

package/dist/ext/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../src/ext/tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAOtC,MAAM,UAAU,QAAQ,CACtB,OAAwB,EACxB,EAAkC;IAElC,OAAO,KAAK,EAAE,GAAG,IAAO,EAAc,EAAE;QACtC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,OAAO,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACzD,IAAI,CAAC;gBACH,IAAI,CAAC,YAAY,CAAC,yBAAyB,EAAE,MAAM,CAAC,CAAC;gBACrD,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;gBAC7C,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;oBACxB,IAAI,CAAC,YAAY,CAAC,kBAAkB,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;gBAC7D,CAAC;gBACD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACpB,IAAI,CAAC;wBACH,IAAI,CAAC,YAAY,CAAC,iBAAiB,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;oBAC7D,CAAC;oBAAC,MAAM,CAAC;wBACP,8BAA8B;oBAChC,CAAC;gBACH,CAAC;gBACD,OAAO,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;YAC3B,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC,GAAG,EAAE,CAAC;YACb,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}

package/dist/filtering-exporter.d.ts

@@ -0,0 +1,18 @@
+import type { ReadableSpan, SpanExporter } from "@opentelemetry/sdk-trace-base";
+interface ExportResult {
+    code: number;
+    error?: Error;
+}
+export declare class FilteringSpanExporter implements SpanExporter {
+    private readonly wrappedExporter;
+    private readonly enabled;
+    private filteredCount;
+    private exportedCount;
+    constructor(wrappedExporter: SpanExporter, enabled?: boolean);
+    private shouldExport;
+    export(spans: ReadableSpan[], resultCallback: (result: ExportResult) => void): void;
+    shutdown(): Promise<void>;
+    forceFlush(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=filtering-exporter.d.ts.map

package/dist/filtering-exporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filtering-exporter.d.ts","sourceRoot":"","sources":["../src/filtering-exporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAEhF,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAeD,qBAAa,qBAAsB,YAAW,YAAY;IACxD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAe;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,aAAa,CAAK;gBAEd,eAAe,EAAE,YAAY,EAAE,OAAO,UAAO;IAKzD,OAAO,CAAC,YAAY;IAmBpB,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,cAAc,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI;IAiBnF,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAIzB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B"}

package/dist/filtering-exporter.js

@@ -0,0 +1,59 @@
+const ExportResultCode = { SUCCESS: 0, FAILED: 1 };
+const OPENINFERENCE_SPAN_KINDS = new Set([
+    "LLM",
+    "EMBEDDING",
+    "TOOL",
+    "CHAIN",
+    "AGENT",
+    "RETRIEVER",
+    "RERANKER",
+]);
+const AI_ATTRIBUTE_PREFIXES = ["openinference.", "gen_ai.", "llm.", "coalex."];
+export class FilteringSpanExporter {
+    wrappedExporter;
+    enabled;
+    filteredCount = 0;
+    exportedCount = 0;
+    constructor(wrappedExporter, enabled = true) {
+        this.wrappedExporter = wrappedExporter;
+        this.enabled = enabled;
+    }
+    shouldExport(span) {
+        if (!this.enabled)
+            return true;
+        const attributes = span.attributes;
+        const spanKind = attributes["openinference.span.kind"];
+        if (typeof spanKind === "string" && OPENINFERENCE_SPAN_KINDS.has(spanKind)) {
+            return true;
+        }
+        for (const attrName of Object.keys(attributes)) {
+            for (const prefix of AI_ATTRIBUTE_PREFIXES) {
+                if (attrName.startsWith(prefix))
+                    return true;
+            }
+        }
+        return false;
+    }
+    export(spans, resultCallback) {
+        if (!this.enabled) {
+            this.wrappedExporter.export(spans, resultCallback);
+            return;
+        }
+        const filtered = spans.filter((s) => this.shouldExport(s));
+        this.filteredCount += spans.length - filtered.length;
+        this.exportedCount += filtered.length;
+        if (filtered.length > 0) {
+            this.wrappedExporter.export(filtered, resultCallback);
+        }
+        else {
+            resultCallback({ code: ExportResultCode.SUCCESS });
+        }
+    }
+    shutdown() {
+        return this.wrappedExporter.shutdown();
+    }
+    forceFlush() {
+        return this.wrappedExporter.forceFlush?.() ?? Promise.resolve();
+    }
+}
+//# sourceMappingURL=filtering-exporter.js.map

package/dist/filtering-exporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filtering-exporter.js","sourceRoot":"","sources":["../src/filtering-exporter.ts"],"names":[],"mappings":"AAMA,MAAM,gBAAgB,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAW,CAAC;AAE5D,MAAM,wBAAwB,GAAG,IAAI,GAAG,CAAC;IACvC,KAAK;IACL,WAAW;IACX,MAAM;IACN,OAAO;IACP,OAAO;IACP,WAAW;IACX,UAAU;CACX,CAAC,CAAC;AAEH,MAAM,qBAAqB,GAAG,CAAC,gBAAgB,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;AAE/E,MAAM,OAAO,qBAAqB;IACf,eAAe,CAAe;IAC9B,OAAO,CAAU;IAC1B,aAAa,GAAG,CAAC,CAAC;IAClB,aAAa,GAAG,CAAC,CAAC;IAE1B,YAAY,eAA6B,EAAE,OAAO,GAAG,IAAI;QACvD,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAEO,YAAY,CAAC,IAAkB;QACrC,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAE/B,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QAEnC,MAAM,QAAQ,GAAG,UAAU,CAAC,yBAAyB,CAAC,CAAC;QACvD,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,wBAAwB,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3E,OAAO,IAAI,CAAC;QACd,CAAC;QAED,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/C,KAAK,MAAM,MAAM,IAAI,qBAAqB,EAAE,CAAC;gBAC3C,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC;oBAAE,OAAO,IAAI,CAAC;YAC/C,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,CAAC,KAAqB,EAAE,cAA8C;QAC1E,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;YACnD,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3D,IAAI,CAAC,aAAa,IAAI,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;QACrD,IAAI,CAAC,aAAa,IAAI,QAAQ,CAAC,MAAM,CAAC;QAEtC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;QACxD,CAAC;aAAM,CAAC;YACN,cAAc,CAAC,EAAE,IAAI,EAAE,gBAAgB,CAAC,OAAO,EAAE,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,CAAC;IACzC,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,eAAe,CAAC,UAAU,EAAE,EAAE,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAClE,CAAC;CACF"}

package/dist/index.d.ts

@@ -1,9 +1,23 @@
-/**
- * Coalex SDK for observability and monitoring.
- *
- * @packageDocumentation
- */
-export { register, addRequestContext, coalexContext, coalexContextSync, RegisterOptions, CoalexContextOptions } from './otel/register';
-export { approve, ApprovalRequest, ApprovalResponse, ApprovalRequestData, ApprovalResponseData, ApproveOptions } from './approve';
-export { submitMetric, MetricRequest, MetricResponse, MetricRequestData, MetricResponseData, SubmitMetricOptions } from './metrics';
-export declare const VERSION = "0.4.1";
+import type { CoalexConfig } from "./config.js";
+export type { CoalexConfig } from "./config.js";
+export { coalexContext, coalexContextSync } from "./context.js";
+export type { CoalexContextOptions } from "./context.js";
+export { evaluate, KNOWN_METRICS } from "./evaluate.js";
+export type { EvaluateOptions, EvaluationDecision } from "./evaluate.js";
+export { resolve, VALID_DECISIONS } from "./resolve.js";
+export type { ResolveOptions, ResolutionResult, MetricResult } from "./resolve.js";
+export { autoInstrument, instrumentOpenAI, instrumentLangChain, instrumentAnthropic } from "./auto-instrument.js";
+export type { AutoInstrumentOptions, InstrumentationStatus } from "./auto-instrument.js";
+export declare function getConfig(): CoalexConfig;
+export declare function getApiKey(): string;
+export interface RegisterOptions {
+    endpoint?: string;
+    apiKey?: string;
+    serviceName?: string;
+    filterNonAiSpans?: boolean;
+    suppressExportErrors?: boolean;
+}
+export declare function register(options?: RegisterOptions): void;
+/** Reset SDK state — for testing only. */
+export declare function _resetForTesting(): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKhD,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAChE,YAAY,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACxD,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACxD,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAClH,YAAY,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAKzF,wBAAgB,SAAS,IAAI,YAAY,CAKxC;AAED,wBAAgB,SAAS,IAAI,MAAM,CAKlC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,wBAAgB,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI,CA0BxD;AAED,0CAA0C;AAC1C,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC"}

package/dist/index.js

@@ -1,26 +1,54 @@
-"use strict";
-/**
- * Coalex SDK for observability and monitoring.
- *
- * @packageDocumentation
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.VERSION = exports.MetricResponse = exports.MetricRequest = exports.submitMetric = exports.ApprovalResponse = exports.ApprovalRequest = exports.approve = exports.coalexContextSync = exports.coalexContext = exports.addRequestContext = exports.register = void 0;
-// OpenTelemetry registration and context
-var register_1 = require("./otel/register");
-Object.defineProperty(exports, "register", { enumerable: true, get: function () { return register_1.register; } });
-Object.defineProperty(exports, "addRequestContext", { enumerable: true, get: function () { return register_1.addRequestContext; } });
-Object.defineProperty(exports, "coalexContext", { enumerable: true, get: function () { return register_1.coalexContext; } });
-Object.defineProperty(exports, "coalexContextSync", { enumerable: true, get: function () { return register_1.coalexContextSync; } });
-// Approval functionality
-var approve_1 = require("./approve");
-Object.defineProperty(exports, "approve", { enumerable: true, get: function () { return approve_1.approve; } });
-Object.defineProperty(exports, "ApprovalRequest", { enumerable: true, get: function () { return approve_1.ApprovalRequest; } });
-Object.defineProperty(exports, "ApprovalResponse", { enumerable: true, get: function () { return approve_1.ApprovalResponse; } });
-// Metrics functionality
-var metrics_1 = require("./metrics");
-Object.defineProperty(exports, "submitMetric", { enumerable: true, get: function () { return metrics_1.submitMetric; } });
-Object.defineProperty(exports, "MetricRequest", { enumerable: true, get: function () { return metrics_1.MetricRequest; } });
-Object.defineProperty(exports, "MetricResponse", { enumerable: true, get: function () { return metrics_1.MetricResponse; } });
-// Version
-exports.VERSION = '0.4.1';
+import { Resource } from "@opentelemetry/resources";
+import { NodeTracerProvider } from "@opentelemetry/sdk-trace-node";
+import { BatchSpanProcessor } from "@opentelemetry/sdk-trace-base";
+import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-http";
+import { ATTR_SERVICE_NAME } from "@opentelemetry/semantic-conventions";
+import { SafeOTLPSpanExporter } from "./safe-exporter.js";
+import { FilteringSpanExporter } from "./filtering-exporter.js";
+import { CoalexAttributePropagator } from "./span-processor.js";
+export { coalexContext, coalexContextSync } from "./context.js";
+export { evaluate, KNOWN_METRICS } from "./evaluate.js";
+export { resolve, VALID_DECISIONS } from "./resolve.js";
+export { autoInstrument, instrumentOpenAI, instrumentLangChain, instrumentAnthropic } from "./auto-instrument.js";
+let _config = null;
+let _apiKey = null;
+export function getConfig() {
+    if (!_config) {
+        throw new Error("register() must be called before using the Coalex SDK");
+    }
+    return _config;
+}
+export function getApiKey() {
+    if (!_apiKey) {
+        throw new Error("register() must be called before using the Coalex SDK");
+    }
+    return _apiKey;
+}
+export function register(options) {
+    const endpoint = options?.endpoint ?? "https://collect.coalex.ai";
+    const apiKey = options?.apiKey ?? "dev";
+    const serviceName = options?.serviceName ?? "coalex-sdk-typescript";
+    const filterNonAiSpans = options?.filterNonAiSpans ?? false;
+    const suppressExportErrors = options?.suppressExportErrors ?? true;
+    _config = { endpoint, serviceName };
+    _apiKey = apiKey;
+    const resource = new Resource({ [ATTR_SERVICE_NAME]: serviceName });
+    const baseExporter = new OTLPTraceExporter({
+        url: `${endpoint}/v1/traces`,
+        headers: { Authorization: `Bearer ${apiKey}` },
+    });
+    const safeExporter = new SafeOTLPSpanExporter(baseExporter, suppressExportErrors);
+    const finalExporter = filterNonAiSpans
+        ? new FilteringSpanExporter(safeExporter)
+        : safeExporter;
+    const provider = new NodeTracerProvider({ resource });
+    provider.addSpanProcessor(new CoalexAttributePropagator());
+    provider.addSpanProcessor(new BatchSpanProcessor(finalExporter));
+    provider.register();
+}
+/** Reset SDK state — for testing only. */
+export function _resetForTesting() {
+    _config = null;
+    _apiKey = null;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAGxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAGhE,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEhE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAExD,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAExD,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAGlH,IAAI,OAAO,GAAwB,IAAI,CAAC;AACxC,IAAI,OAAO,GAAkB,IAAI,CAAC;AAElC,MAAM,UAAU,SAAS;IACvB,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAUD,MAAM,UAAU,QAAQ,CAAC,OAAyB;IAChD,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,2BAA2B,CAAC;IAClE,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,KAAK,CAAC;IACxC,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,uBAAuB,CAAC;IACpE,MAAM,gBAAgB,GAAG,OAAO,EAAE,gBAAgB,IAAI,KAAK,CAAC;IAC5D,MAAM,oBAAoB,GAAG,OAAO,EAAE,oBAAoB,IAAI,IAAI,CAAC;IAEnE,OAAO,GAAG,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;IACpC,OAAO,GAAG,MAAM,CAAC;IAEjB,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,EAAE,CAAC,iBAAiB,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC;IAEpE,MAAM,YAAY,GAAG,IAAI,iBAAiB,CAAC;QACzC,GAAG,EAAE,GAAG,QAAQ,YAAY;QAC5B,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,MAAM,EAAE,EAAE;KAC/C,CAAC,CAAC;IAEH,MAAM,YAAY,GAAG,IAAI,oBAAoB,CAAC,YAAY,EAAE,oBAAoB,CAAC,CAAC;IAClF,MAAM,aAAa,GAAG,gBAAgB;QACpC,CAAC,CAAC,IAAI,qBAAqB,CAAC,YAAY,CAAC;QACzC,CAAC,CAAC,YAAY,CAAC;IAEjB,MAAM,QAAQ,GAAG,IAAI,kBAAkB,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;IACtD,QAAQ,CAAC,gBAAgB,CAAC,IAAI,yBAAyB,EAAE,CAAC,CAAC;IAC3D,QAAQ,CAAC,gBAAgB,CAAC,IAAI,kBAAkB,CAAC,aAAa,CAAC,CAAC,CAAC;IACjE,QAAQ,CAAC,QAAQ,EAAE,CAAC;AACtB,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,gBAAgB;IAC9B,OAAO,GAAG,IAAI,CAAC;IACf,OAAO,GAAG,IAAI,CAAC;AACjB,CAAC"}

package/dist/resolve.d.ts

@@ -0,0 +1,21 @@
+export declare const VALID_DECISIONS: Set<"approved" | "rejected" | "corrected">;
+export interface MetricResult {
+    readonly field: string;
+    readonly metrics: Record<string, number>;
+}
+export interface ResolutionResult {
+    readonly escalationId: string;
+    readonly status: string;
+    readonly metrics: MetricResult[];
+    readonly resolvedAt: string;
+    readonly resolvedBy?: string;
+}
+export interface ResolveOptions {
+    escalationId: string;
+    decision: "approved" | "rejected" | "corrected";
+    corrections?: Record<string, unknown>;
+    reviewer?: string;
+    reason?: string;
+}
+export declare function resolve(options: ResolveOptions): Promise<ResolutionResult>;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,eAAe,4CAA0D,CAAC;AAEvF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,YAAY,EAAE,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,UAAU,GAAG,UAAU,GAAG,WAAW,CAAC;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAwDhF"}

package/dist/resolve.js

@@ -0,0 +1,42 @@
+import { getConfig, getApiKey } from "./index.js";
+export const VALID_DECISIONS = new Set(["approved", "rejected", "corrected"]);
+export async function resolve(options) {
+    const config = getConfig();
+    const apiKey = getApiKey();
+    if (!VALID_DECISIONS.has(options.decision)) {
+        throw new Error(`decision must be one of ${[...VALID_DECISIONS].join(", ")}, got '${options.decision}'`);
+    }
+    if (options.decision === "corrected" && !options.corrections) {
+        throw new Error("corrections required when decision is 'corrected'");
+    }
+    const payload = { decision: options.decision };
+    if (options.corrections !== undefined)
+        payload.corrections = options.corrections;
+    if (options.reviewer !== undefined)
+        payload.reviewer = options.reviewer;
+    if (options.reason !== undefined)
+        payload.reason = options.reason;
+    const resp = await fetch(`${config.endpoint}/api/v1/escalations/${options.escalationId}/resolve`, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${apiKey}`,
+        },
+        body: JSON.stringify(payload),
+    });
+    if (!resp.ok) {
+        throw new Error(`resolve() failed: ${resp.status} ${resp.statusText}`);
+    }
+    const data = await resp.json();
+    return {
+        escalationId: data.escalation_id,
+        status: data.status,
+        metrics: (data.metrics ?? []).map((m) => ({
+            field: m.field,
+            metrics: m.metrics,
+        })),
+        resolvedAt: data.resolved_at,
+        resolvedBy: data.resolved_by,
+    };
+}
+//# sourceMappingURL=resolve.js.map

package/dist/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,WAAW,CAAU,CAAC,CAAC;AAuBvF,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,OAAuB;IACnD,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAE3B,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CACb,2BAA2B,CAAC,GAAG,eAAe,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,OAAO,CAAC,QAAQ,GAAG,CACxF,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,KAAK,WAAW,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,OAAO,GAA4B,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;IACxE,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS;QAAE,OAAO,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IACjF,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS;QAAE,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IACxE,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAElE,MAAM,IAAI,GAAG,MAAM,KAAK,CACtB,GAAG,MAAM,CAAC,QAAQ,uBAAuB,OAAO,CAAC,YAAY,UAAU,EACvE;QACE,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,cAAc,EAAE,kBAAkB;YAClC,aAAa,EAAE,UAAU,MAAM,EAAE;SAClC;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;KAC9B,CACF,CAAC;IAEF,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;IACzE,CAAC;IAMD,MAAM,IAAI,GAMN,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;IACtB,OAAO;QACL,YAAY,EAAE,IAAI,CAAC,aAAa;QAChC,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,OAAO,EAAE,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACxC,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,OAAO,EAAE,CAAC,CAAC,OAAO;SACnB,CAAC,CAAC;QACH,UAAU,EAAE,IAAI,CAAC,WAAW;QAC5B,UAAU,EAAE,IAAI,CAAC,WAAW;KAC7B,CAAC;AACJ,CAAC"}

package/dist/safe-exporter.d.ts

@@ -0,0 +1,17 @@
+import type { ReadableSpan, SpanExporter } from "@opentelemetry/sdk-trace-base";
+interface ExportResult {
+    code: number;
+    error?: Error;
+}
+export declare class SafeOTLPSpanExporter implements SpanExporter {
+    private readonly wrappedExporter;
+    private readonly suppressErrors;
+    private errorCount;
+    private readonly maxLoggedErrors;
+    constructor(wrappedExporter: SpanExporter, suppressErrors?: boolean);
+    export(spans: ReadableSpan[], resultCallback: (result: ExportResult) => void): void;
+    shutdown(): Promise<void>;
+    forceFlush(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=safe-exporter.d.ts.map

package/dist/safe-exporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-exporter.d.ts","sourceRoot":"","sources":["../src/safe-exporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAEhF,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAGD,qBAAa,oBAAqB,YAAW,YAAY;IACvD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAe;IAC/C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAU;IACzC,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAK;gBAEzB,eAAe,EAAE,YAAY,EAAE,cAAc,UAAO;IAKhE,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,cAAc,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI;IAuCnF,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IASzB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ5B"}

package/dist/safe-exporter.js

@@ -0,0 +1,64 @@
+const ExportResultCode = { SUCCESS: 0, FAILED: 1 };
+export class SafeOTLPSpanExporter {
+    wrappedExporter;
+    suppressErrors;
+    errorCount = 0;
+    maxLoggedErrors = 3;
+    constructor(wrappedExporter, suppressErrors = true) {
+        this.wrappedExporter = wrappedExporter;
+        this.suppressErrors = suppressErrors;
+    }
+    export(spans, resultCallback) {
+        try {
+            this.wrappedExporter.export(spans, (result) => {
+                if (result.code === ExportResultCode.FAILED && this.suppressErrors) {
+                    this.errorCount++;
+                    if (this.errorCount <= this.maxLoggedErrors) {
+                        console.warn(`[coalex] Failed to export ${spans.length} spans (error #${this.errorCount}): ${result.error?.message ?? "unknown error"}`);
+                        if (this.errorCount === this.maxLoggedErrors) {
+                            console.warn(`[coalex] Suppressing further span export errors (total so far: ${this.errorCount}).`);
+                        }
+                    }
+                    resultCallback({ code: ExportResultCode.SUCCESS });
+                }
+                else {
+                    resultCallback(result);
+                }
+            });
+        }
+        catch (e) {
+            if (!this.suppressErrors)
+                throw e;
+            this.errorCount++;
+            if (this.errorCount <= this.maxLoggedErrors) {
+                const msg = e instanceof Error ? e.message : String(e);
+                console.warn(`[coalex] Failed to export ${spans.length} spans (error #${this.errorCount}): ${msg}`);
+                if (this.errorCount === this.maxLoggedErrors) {
+                    console.warn(`[coalex] Suppressing further span export errors (total so far: ${this.errorCount}).`);
+                }
+            }
+            resultCallback({ code: ExportResultCode.SUCCESS });
+        }
+    }
+    shutdown() {
+        try {
+            return this.wrappedExporter.shutdown();
+        }
+        catch (e) {
+            if (!this.suppressErrors)
+                throw e;
+            return Promise.resolve();
+        }
+    }
+    forceFlush() {
+        try {
+            return this.wrappedExporter.forceFlush?.() ?? Promise.resolve();
+        }
+        catch (e) {
+            if (!this.suppressErrors)
+                throw e;
+            return Promise.resolve();
+        }
+    }
+}
+//# sourceMappingURL=safe-exporter.js.map

package/dist/safe-exporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-exporter.js","sourceRoot":"","sources":["../src/safe-exporter.ts"],"names":[],"mappings":"AAMA,MAAM,gBAAgB,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAW,CAAC;AAE5D,MAAM,OAAO,oBAAoB;IACd,eAAe,CAAe;IAC9B,cAAc,CAAU;IACjC,UAAU,GAAG,CAAC,CAAC;IACN,eAAe,GAAG,CAAC,CAAC;IAErC,YAAY,eAA6B,EAAE,cAAc,GAAG,IAAI;QAC9D,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;IACvC,CAAC;IAED,MAAM,CAAC,KAAqB,EAAE,cAA8C;QAC1E,IAAI,CAAC;YACH,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,EAAE;gBAC5C,IAAI,MAAM,CAAC,IAAI,KAAK,gBAAgB,CAAC,MAAM,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;oBACnE,IAAI,CAAC,UAAU,EAAE,CAAC;oBAClB,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;wBAC5C,OAAO,CAAC,IAAI,CACV,6BAA6B,KAAK,CAAC,MAAM,kBAAkB,IAAI,CAAC,UAAU,MAAM,MAAM,CAAC,KAAK,EAAE,OAAO,IAAI,eAAe,EAAE,CAC3H,CAAC;wBACF,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI,CAAC,eAAe,EAAE,CAAC;4BAC7C,OAAO,CAAC,IAAI,CACV,kEAAkE,IAAI,CAAC,UAAU,IAAI,CACtF,CAAC;wBACJ,CAAC;oBACH,CAAC;oBACD,cAAc,CAAC,EAAE,IAAI,EAAE,gBAAgB,CAAC,OAAO,EAAE,CAAC,CAAC;gBACrD,CAAC;qBAAM,CAAC;oBACN,cAAc,CAAC,MAAM,CAAC,CAAC;gBACzB,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,CAAU,EAAE,CAAC;YACpB,IAAI,CAAC,IAAI,CAAC,cAAc;gBAAE,MAAM,CAAC,CAAC;YAElC,IAAI,CAAC,UAAU,EAAE,CAAC;YAClB,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;gBAC5C,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;gBACvD,OAAO,CAAC,IAAI,CACV,6BAA6B,KAAK,CAAC,MAAM,kBAAkB,IAAI,CAAC,UAAU,MAAM,GAAG,EAAE,CACtF,CAAC;gBACF,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI,CAAC,eAAe,EAAE,CAAC;oBAC7C,OAAO,CAAC,IAAI,CACV,kEAAkE,IAAI,CAAC,UAAU,IAAI,CACtF,CAAC;gBACJ,CAAC;YACH,CAAC;YACD,cAAc,CAAC,EAAE,IAAI,EAAE,gBAAgB,CAAC,OAAO,EAAE,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED,QAAQ;QACN,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,CAAC;QACzC,CAAC;QAAC,OAAO,CAAU,EAAE,CAAC;YACpB,IAAI,CAAC,IAAI,CAAC,cAAc;gBAAE,MAAM,CAAC,CAAC;YAClC,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,UAAU;QACR,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,eAAe,CAAC,UAAU,EAAE,EAAE,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QAClE,CAAC;QAAC,OAAO,CAAU,EAAE,CAAC;YACpB,IAAI,CAAC,IAAI,CAAC,cAAc;gBAAE,MAAM,CAAC,CAAC;YAClC,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3B,CAAC;IACH,CAAC;CACF"}

package/dist/span-processor.d.ts

@@ -0,0 +1,9 @@
+import type { Context } from "@opentelemetry/api";
+import type { ReadableSpan, Span, SpanProcessor } from "@opentelemetry/sdk-trace-base";
+export declare class CoalexAttributePropagator implements SpanProcessor {
+    onStart(span: Span, parentContext: Context): void;
+    onEnd(_span: ReadableSpan): void;
+    shutdown(): Promise<void>;
+    forceFlush(): Promise<void>;
+}
+//# sourceMappingURL=span-processor.d.ts.map

package/dist/span-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"span-processor.d.ts","sourceRoot":"","sources":["../src/span-processor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAQvF,qBAAa,yBAA0B,YAAW,aAAa;IAC7D,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,GAAG,IAAI;IAgBjD,KAAK,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAChC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAGzB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B"}

package/dist/span-processor.js

@@ -0,0 +1,31 @@
+import { trace } from "@opentelemetry/api";
+const ATTRIBUTES_TO_PROPAGATE = [
+    "coalex.agent_id",
+    "coalex.request_id",
+    "coalex.agent_version",
+];
+export class CoalexAttributePropagator {
+    onStart(span, parentContext) {
+        const parentSpan = trace.getSpan(parentContext);
+        if (!parentSpan)
+            return;
+        const parentReadable = parentSpan;
+        const parentAttrs = parentReadable.attributes;
+        if (!parentAttrs)
+            return;
+        for (const attrName of ATTRIBUTES_TO_PROPAGATE) {
+            const parentValue = parentAttrs[attrName];
+            if (parentValue !== undefined) {
+                span.setAttribute(attrName, parentValue);
+            }
+        }
+    }
+    onEnd(_span) { }
+    shutdown() {
+        return Promise.resolve();
+    }
+    forceFlush() {
+        return Promise.resolve();
+    }
+}
+//# sourceMappingURL=span-processor.js.map

package/dist/span-processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"span-processor.js","sourceRoot":"","sources":["../src/span-processor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAG3C,MAAM,uBAAuB,GAAG;IAC9B,iBAAiB;IACjB,mBAAmB;IACnB,sBAAsB;CACd,CAAC;AAEX,MAAM,OAAO,yBAAyB;IACpC,OAAO,CAAC,IAAU,EAAE,aAAsB;QACxC,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QAChD,IAAI,CAAC,UAAU;YAAE,OAAO;QAExB,MAAM,cAAc,GAAG,UAAqC,CAAC;QAC7D,MAAM,WAAW,GAAG,cAAc,CAAC,UAAU,CAAC;QAC9C,IAAI,CAAC,WAAW;YAAE,OAAO;QAEzB,KAAK,MAAM,QAAQ,IAAI,uBAAuB,EAAE,CAAC;YAC/C,MAAM,WAAW,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;YAC1C,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;gBAC9B,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAmB,IAAS,CAAC;IACnC,QAAQ;QACN,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IACD,UAAU;QACR,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;CACF"}