@coalex-ai/sdk 2.2.1 → 2.3.0-beta.686

package/README.md

@@ -110,6 +110,27 @@ Convenience functions to instrument a single library.
 instrumentOpenAI();  // returns boolean
 ```
 
+### LangChain.js
+
+With `@arizeai/openinference-instrumentation-langchain` 4.x installed, `autoInstrument()` captures
+LangChain.js 0.3 and 1.x (`@langchain/core`) in a CommonJS app: `LLM`, `CHAIN`, `PROMPT` and `TOOL`
+spans. Call `register()` first, since the spans go to the globally registered provider and not to
+a `tracerProvider` option, and instrument before the app first loads LangChain. On its first call
+the result reads `langchain: "already_instrumented"` although the instrumentation is active.
+
+In an ESM app neither `autoInstrument()` nor `autoInstrumentAsync()` captures LangChain yet. Hand
+the instrumentor LangChain's callback manager instead, before your LangChain code runs:
+
+```typescript
+import { LangChainInstrumentation } from "@arizeai/openinference-instrumentation-langchain";
+
+register({ apiKey: process.env.COALEX_API_KEY, serviceName: "my-agent" });
+new LangChainInstrumentation().manuallyInstrument(await import("@langchain/core/callbacks/manager"));
+```
+
+Which lines are proven, and on which versions:
+[Supported Frameworks](https://docs.coalex.ai/reference/supported-frameworks/).
+
 ### `coalexContext(options, fn)` / `coalexContextSync(options, fn)`
 
 Wrap a function in a traced Coalex invocation span.
@@ -147,6 +168,23 @@ await coalexContext(
 );
 ```
 
+#### Several agents in one process
+
+A context opened inside another agent's context belongs to the inner agent: its spans carry
+`coalex.parent_agent_id` (the enclosing agent) and the enclosing `requestId` / `runId`, but not
+the enclosing agent's version or prompt. `agentNode` wraps a LangGraph node function so each node
+is its own agent, re-opened on every resume, and a LangGraph pause (`interrupt()`) ends the span
+OK rather than as an error. `currentAgentId()`, `currentParentAgentId()`, `currentRequestId()`,
+`currentRunId()` and `currentAgentVersion()` read the active context.
+
+```typescript
+graph.addNode("rfq", agentNode("rfq-worker", rfqWorker, { version: "1.4.0" }));
+
+await coalexContext({ agentId: "orchestrator", requestId, runId, version: "2.0.0" }, () =>
+  graph.compile({ checkpointer }).invoke(state, config),
+);
+```
+
 ### `evaluate(options)`
 
 Submit an AI output for evaluation. Returns the governance decision.

package/dist/context.d.ts

@@ -1,22 +1,53 @@
-/** Record the prompt version/type served by the most recent getPrompt() (COA-368). */
+/**
+ * Everything the active coalexContext() says about the work in progress. One store for the whole
+ * context, so the propagator, evaluate() and the getters read the same values, and a concurrent
+ * invocation of another agent cannot see them.
+ */
+interface ActiveContext {
+    agentId: string;
+    parentAgentId?: string;
+    requestId?: string;
+    runId?: string;
+    version?: string;
+    promptVersion?: number;
+    promptType?: string;
+}
+/** The active context, or undefined outside one. For the propagator; not exported publicly. */
+export declare function activeContext(): Readonly<ActiveContext> | undefined;
+/**
+ * Record the prompt version/type getPrompt() served: on the active context when there is one,
+ * otherwise as the process-wide startup prompt (COA-368).
+ */
 export declare function setLastPrompt(version: number, type: string): void;
-/** The prompt version/type from the most recent getPrompt(), or null. */
+/** The prompt of the active context, or the startup prompt outside one, or null. */
 export declare function getLastPrompt(): {
     version: number;
     type: string;
 } | null;
-/** Reset the prompt fallback. Used by coalexContext() to restore the prior value on exit. */
+/** Forget the prompt: the active context's, or the startup prompt outside one. */
 export declare function clearLastPrompt(): void;
 /**
- * Return the agentId of the active coalexContext(), or undefined outside one.
- * Lets evaluate() propagate the agentId for mid-run escalations that fire before
- * the trace ingests, so the server resolves the agent instead of forcing health=0
- * (COA-1076).
+ * Return the agentId of the active coalexContext(), or undefined outside one. evaluate() reads it
+ * so a mid-run escalation names its agent before the trace is ingested.
  */
 export declare function currentAgentId(): string | undefined;
+/** The requestId of the active coalexContext(), given or carried from an outer one. */
+export declare function currentRequestId(): string | undefined;
+/** The runId of the active coalexContext(), given or carried from an outer one. */
+export declare function currentRunId(): string | undefined;
+/** The agent version of the active coalexContext(), or undefined when it has none. */
+export declare function currentAgentVersion(): string | undefined;
+/** The agent whose context the active one opened inside, or undefined for a top-level agent. */
+export declare function currentParentAgentId(): string | undefined;
 export interface CoalexContextOptions {
     agentId: string;
+    /** The customer's correlation key for one unit of business work. Carried from an enclosing context when omitted. */
     requestId?: string;
+    /**
+     * One execution of an agent graph, across interrupts and resumes. Carried from an enclosing
+     * context when omitted. Never derive it from a framework's thread or session id.
+     */
+    runId?: string;
     /**
      * The build this invocation is running. Optional today, and omitting it logs a warning once
      * per agent per process (COA-2636): a trace with no version cannot be attributed to a build,
@@ -53,6 +84,40 @@ export interface CoalexContextOptions {
 export declare function missingVersionGuidance(agentId: string): string;
 /** Forget which agents have been warned about. For tests; the registry is process-global. */
 export declare function resetVersionWarnings(): void;
+/** The `coalex.*` attributes a context puts on its spans, in the propagator's order. */
+export declare function contextAttributes(ctx: Readonly<ActiveContext>): Record<string, string | number>;
+/**
+ * The LangGraph errors that carry a pause or a hand-off up through a node, not a failure.
+ * Recognised by name on the error and on every class of its prototype chain, so this SDK never
+ * imports LangGraph, a subclass (`NodeInterrupt`) is recognised, and so is a bundled copy whose
+ * class names were minified (LangGraph sets `name` on each).
+ */
+export declare const PAUSE_ERROR_NAMES: ReadonlySet<string>;
+export declare function isPause(e: unknown): boolean;
+/**
+ * Run `fn` inside a `coalex.invocation` span for `options.agentId`; every span started inside it
+ * carries the context's `coalex.*` attributes.
+ *
+ * Nested inside another agent's context it sets `coalex.parent_agent_id` to that agent, carries
+ * `requestId` and `runId`, and inherits neither version nor prompt; inside the same agent it
+ * inherits everything. A LangGraph pause (`GraphBubbleUp`, `GraphInterrupt`, `ParentCommand`)
+ * ends the span OK and is re-thrown; any other error ends it ERROR.
+ */
 export declare function coalexContext<T>(options: CoalexContextOptions, fn: () => Promise<T> | T): Promise<T>;
 export declare function coalexContextSync<T>(options: CoalexContextOptions, fn: () => T): T;
+/**
+ * Wrap a LangGraph node function so everything it does belongs to `agentId`.
+ *
+ * Wrap the **node function**, not the graph's `invoke`: LangGraph re-executes the node from the
+ * top on every resume (`new Command({ resume })`), so the context opens again for the resumed work
+ * and the node's checkpoint namespace is unchanged. The context carries the enclosing `requestId`
+ * and `runId`, names the enclosing agent as `coalex.parent_agent_id`, and a pause (`interrupt()`)
+ * leaves its span OK. Every argument (`state`, `config`) is passed through.
+ *
+ *     graph.addNode("w1_rfq", agentNode("rfq-worker", rfqWorker, { version: "1.4.0" }));
+ */
+export declare function agentNode<A extends unknown[], R>(agentId: string, fn: (...args: A) => Promise<R> | R, options?: {
+    version?: string;
+}): (...args: A) => Promise<R>;
+export {};
 //# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAgBA,sFAAsF;AACtF,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAEjE;AAED,yEAAyE;AACzE,wBAAgB,aAAa,IAAI;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAExE;AAED,6FAA6F;AAC7F,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,IAAI,MAAM,GAAG,SAAS,CAEnD;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQ9D;AAwBD,6FAA6F;AAC7F,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAkDD,wBAAsB,aAAa,CAAC,CAAC,EACnC,OAAO,EAAE,oBAAoB,EAC7B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GACvB,OAAO,CAAC,CAAC,CAAC,CAyBZ;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,OAAO,EAAE,oBAAoB,EAC7B,EAAE,EAAE,MAAM,CAAC,GACV,CAAC,CAyBH"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"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"}

package/dist/context.js

@@ -1,36 +1,73 @@
 import { AsyncLocalStorage } from "node:async_hooks";
 import { trace, SpanStatusCode } from "@opentelemetry/api";
 import { log } from "./logger.js";
-const agentIdStore = new AsyncLocalStorage();
+const contextStore = new AsyncLocalStorage();
+/** The active context, or undefined outside one. For the propagator; not exported publicly. */
+export function activeContext() {
+    return contextStore.getStore();
+}
 /**
- * The prompt version + type last fetched via getPrompt(), used as a fallback so spans can be
- * attributed to a prompt version even when getPrompt() ran at startup outside any span (COA-368).
- *
- * This is process-global (not async-context-scoped) so it survives a startup fetch into later
- * request spans — the common case. Under concurrent getPrompt() calls for *different* versions in
- * the same process the last write wins; the Python SDK's contextvar is the more precise analogue.
+ * The prompt version + type fetched via getPrompt() outside any coalexContext() (a startup fetch),
+ * so later invocations of that agent and spans outside any context are still attributed (COA-368).
+ * Inside a context, getPrompt() writes to that context instead, so concurrent invocations of
+ * different agents never see each other's prompt.
+ */
+let _startupPrompt = null;
+/**
+ * Record the prompt version/type getPrompt() served: on the active context when there is one,
+ * otherwise as the process-wide startup prompt (COA-368).
  */
-let _lastPrompt = null;
-/** Record the prompt version/type served by the most recent getPrompt() (COA-368). */
 export function setLastPrompt(version, type) {
-    _lastPrompt = { version, type };
+    const active = contextStore.getStore();
+    if (active) {
+        active.promptVersion = version;
+        active.promptType = type;
+        return;
+    }
+    _startupPrompt = { version, type };
 }
-/** The prompt version/type from the most recent getPrompt(), or null. */
+/** The prompt of the active context, or the startup prompt outside one, or null. */
 export function getLastPrompt() {
-    return _lastPrompt;
+    const active = contextStore.getStore();
+    if (active) {
+        return active.promptVersion === undefined
+            ? null
+            : { version: active.promptVersion, type: active.promptType ?? "system" };
+    }
+    return _startupPrompt;
 }
-/** Reset the prompt fallback. Used by coalexContext() to restore the prior value on exit. */
+/** Forget the prompt: the active context's, or the startup prompt outside one. */
 export function clearLastPrompt() {
-    _lastPrompt = null;
+    const active = contextStore.getStore();
+    if (active) {
+        active.promptVersion = undefined;
+        active.promptType = undefined;
+        return;
+    }
+    _startupPrompt = null;
 }
 /**
- * Return the agentId of the active coalexContext(), or undefined outside one.
- * Lets evaluate() propagate the agentId for mid-run escalations that fire before
- * the trace ingests, so the server resolves the agent instead of forcing health=0
- * (COA-1076).
+ * Return the agentId of the active coalexContext(), or undefined outside one. evaluate() reads it
+ * so a mid-run escalation names its agent before the trace is ingested.
  */
 export function currentAgentId() {
-    return agentIdStore.getStore();
+    return contextStore.getStore()?.agentId;
+}
+/** The requestId of the active coalexContext(), given or carried from an outer one. */
+export function currentRequestId() {
+    return contextStore.getStore()?.requestId;
+}
+/** The runId of the active coalexContext(), given or carried from an outer one. */
+export function currentRunId() {
+    return contextStore.getStore()?.runId;
+}
+/** The agent version of the active coalexContext(), or undefined when it has none. */
+export function currentAgentVersion() {
+    return contextStore.getStore()?.version;
+}
+/** The agent whose context the active one opened inside, or undefined for a top-level agent. */
+export function currentParentAgentId() {
+    return contextStore.getStore()?.parentAgentId;
 }
 /**
  * COA-2636, under COA-2634. An agent that does not say which version it is, is an agent whose
@@ -85,10 +122,14 @@ export function resetVersionWarnings() {
  * Through `log.warn`, never a bare `console.warn`: COA-2192 made every diagnostic in this SDK
  * routable into the host's own logging and silenceable with `register({ logger: null })`, and a
  * library that writes unconditionally to a production service's stderr is a defect on its own.
+ * A context nested in the same agent inherits that agent's version, so it is not warned about.
  */
 function warnMissingVersion(options) {
     if (options.version !== undefined)
         return;
+    const outer = contextStore.getStore();
+    if (outer?.agentId === options.agentId && outer.version !== undefined)
+        return;
     if (warnedMissingVersion.has(options.agentId))
         return;
     if (warnedMissingVersion.size >= MISSING_VERSION_WARNING_CAP)
@@ -96,87 +137,149 @@ function warnMissingVersion(options) {
     warnedMissingVersion.add(options.agentId);
     log.warn(missingVersionGuidance(options.agentId));
 }
-function buildInvocationAttributes(options) {
-    const attrs = { "coalex.agent_id": options.agentId };
-    if (options.requestId !== undefined) {
-        attrs["coalex.request_id"] = options.requestId;
-    }
-    if (options.version !== undefined) {
-        attrs["coalex.agent_version"] = options.version;
+/**
+ * The context an invocation opens, resolved against the one it opens inside.
+ *
+ * An inner context wins for every value it is given. Inside a *different* agent it names that
+ * agent as its parent, carries `requestId` and `runId`, and inherits neither the version nor the
+ * prompt: those belong to the outer agent. Inside the *same* agent it inherits everything and names
+ * no parent. A top-level context starts from the startup prompt, if getPrompt() fetched one.
+ */
+function resolveContext(options) {
+    const outer = contextStore.getStore();
+    const sameAgent = outer !== undefined && outer.agentId === options.agentId;
+    let inherited;
+    if (outer === undefined) {
+        inherited = { promptVersion: _startupPrompt?.version, promptType: _startupPrompt?.type };
     }
-    if (options.promptVersion !== undefined) {
-        attrs["coalex.prompt_version"] = options.promptVersion;
+    else if (sameAgent) {
+        inherited = outer;
     }
-    if (options.promptType !== undefined) {
-        attrs["coalex.prompt_type"] = options.promptType;
+    else {
+        inherited = { parentAgentId: outer.agentId };
     }
+    const promptGiven = options.promptVersion !== undefined;
+    return {
+        agentId: options.agentId,
+        parentAgentId: inherited.parentAgentId,
+        requestId: options.requestId ?? outer?.requestId,
+        runId: options.runId ?? outer?.runId,
+        version: options.version ?? inherited.version,
+        promptVersion: promptGiven ? options.promptVersion : inherited.promptVersion,
+        promptType: options.promptType ?? inherited.promptType ?? (promptGiven ? "system" : undefined),
+    };
+}
+/** The `coalex.*` attributes a context puts on its spans, in the propagator's order. */
+export function contextAttributes(ctx) {
+    const attrs = { "coalex.agent_id": ctx.agentId };
+    if (ctx.parentAgentId !== undefined)
+        attrs["coalex.parent_agent_id"] = ctx.parentAgentId;
+    if (ctx.requestId !== undefined)
+        attrs["coalex.request_id"] = ctx.requestId;
+    if (ctx.runId !== undefined)
+        attrs["coalex.run_id"] = ctx.runId;
+    if (ctx.version !== undefined)
+        attrs["coalex.agent_version"] = ctx.version;
+    if (ctx.promptVersion !== undefined)
+        attrs["coalex.prompt_version"] = ctx.promptVersion;
+    if (ctx.promptType !== undefined)
+        attrs["coalex.prompt_type"] = ctx.promptType;
     return attrs;
 }
 /**
- * When a prompt version is supplied, update the process-global fallback the propagator reads, so
- * spans that escape the invocation-span parent chain (e.g. auto-instrumentor root spans with their
- * own trace) are still attributed — the mirror of the Python contextvar. Returns a restore fn so a
- * request's version doesn't leak into a later invocation that passes none. Process-global: under
- * concurrent invocations with *different* versions the last write wins (same caveat as getPrompt()).
+ * The LangGraph errors that carry a pause or a hand-off up through a node, not a failure.
+ * Recognised by name on the error and on every class of its prototype chain, so this SDK never
+ * imports LangGraph, a subclass (`NodeInterrupt`) is recognised, and so is a bundled copy whose
+ * class names were minified (LangGraph sets `name` on each).
  */
-function applyPromptFallback(options) {
-    if (options.promptVersion === undefined) {
-        return () => { };
+export const PAUSE_ERROR_NAMES = new Set([
+    "GraphBubbleUp",
+    "GraphInterrupt",
+    "ParentCommand",
+]);
+export function isPause(e) {
+    if (typeof e !== "object" || e === null)
+        return false;
+    if (PAUSE_ERROR_NAMES.has(String(e.name)))
+        return true;
+    for (let proto = Object.getPrototypeOf(e); proto !== null; proto = Object.getPrototypeOf(proto)) {
+        const ctor = proto.constructor;
+        if (ctor && PAUSE_ERROR_NAMES.has(String(ctor.name)))
+            return true;
+    }
+    return false;
+}
+/** A pause ends the span OK with no exception event; anything else ends it ERROR. */
+function endOnError(span, e) {
+    if (isPause(e)) {
+        span.setStatus({ code: SpanStatusCode.OK });
+        return;
     }
-    const prev = getLastPrompt();
-    setLastPrompt(options.promptVersion, options.promptType ?? prev?.type ?? "system");
-    return () => (prev ? setLastPrompt(prev.version, prev.type) : clearLastPrompt());
+    span.setStatus({ code: SpanStatusCode.ERROR, message: String(e) });
+    span.recordException(e instanceof Error ? e : new Error(String(e)));
 }
+/**
+ * Run `fn` inside a `coalex.invocation` span for `options.agentId`; every span started inside it
+ * carries the context's `coalex.*` attributes.
+ *
+ * Nested inside another agent's context it sets `coalex.parent_agent_id` to that agent, carries
+ * `requestId` and `runId`, and inherits neither version nor prompt; inside the same agent it
+ * inherits everything. A LangGraph pause (`GraphBubbleUp`, `GraphInterrupt`, `ParentCommand`)
+ * ends the span OK and is re-thrown; any other error ends it ERROR.
+ */
 export async function coalexContext(options, fn) {
     const tracer = trace.getTracer("coalex");
     warnMissingVersion(options);
-    const attrs = buildInvocationAttributes(options);
-    const restorePrompt = applyPromptFallback(options);
-    try {
-        return await agentIdStore.run(options.agentId, () => tracer.startActiveSpan("coalex.invocation", { attributes: attrs }, async (span) => {
-            try {
-                const result = await fn();
-                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();
-            }
-        }));
-    }
-    finally {
-        restorePrompt();
-    }
+    const ctx = resolveContext(options);
+    return contextStore.run(ctx, () => tracer.startActiveSpan("coalex.invocation", { attributes: contextAttributes(ctx) }, async (span) => {
+        try {
+            const result = await fn();
+            span.setStatus({ code: SpanStatusCode.OK });
+            return result;
+        }
+        catch (e) {
+            endOnError(span, e);
+            throw e;
+        }
+        finally {
+            span.end();
+        }
+    }));
 }
 export function coalexContextSync(options, fn) {
     const tracer = trace.getTracer("coalex");
     warnMissingVersion(options);
-    const attrs = buildInvocationAttributes(options);
-    const restorePrompt = applyPromptFallback(options);
-    try {
-        return agentIdStore.run(options.agentId, () => tracer.startActiveSpan("coalex.invocation", { attributes: attrs }, (span) => {
-            try {
-                const result = fn();
-                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();
-            }
-        }));
-    }
-    finally {
-        restorePrompt();
-    }
+    const ctx = resolveContext(options);
+    return contextStore.run(ctx, () => tracer.startActiveSpan("coalex.invocation", { attributes: contextAttributes(ctx) }, (span) => {
+        try {
+            const result = fn();
+            span.setStatus({ code: SpanStatusCode.OK });
+            return result;
+        }
+        catch (e) {
+            endOnError(span, e);
+            throw e;
+        }
+        finally {
+            span.end();
+        }
+    }));
+}
+/**
+ * Wrap a LangGraph node function so everything it does belongs to `agentId`.
+ *
+ * Wrap the **node function**, not the graph's `invoke`: LangGraph re-executes the node from the
+ * top on every resume (`new Command({ resume })`), so the context opens again for the resumed work
+ * and the node's checkpoint namespace is unchanged. The context carries the enclosing `requestId`
+ * and `runId`, names the enclosing agent as `coalex.parent_agent_id`, and a pause (`interrupt()`)
+ * leaves its span OK. Every argument (`state`, `config`) is passed through.
+ *
+ *     graph.addNode("w1_rfq", agentNode("rfq-worker", rfqWorker, { version: "1.4.0" }));
+ */
+export function agentNode(agentId, fn, options = {}) {
+    const { version } = options;
+    // Warned when the node is built, where the caller can act on it, not on every execution.
+    warnMissingVersion({ agentId, version });
+    return (...args) => coalexContext({ agentId, version }, () => fn(...args));
 }
 //# sourceMappingURL=context.js.map

package/dist/context.js.map

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

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import type { CoalexConfig } from "./config.js";
 import type { AgentInventory } from "./inventory.js";
 import { type CoalexLogger } from "./logger.js";
 export type { CoalexConfig } from "./config.js";
-export { coalexContext, coalexContextSync, currentAgentId } from "./context.js";
+export { agentNode, coalexContext, coalexContextSync, currentAgentId, currentAgentVersion, currentParentAgentId, currentRequestId, currentRunId, } from "./context.js";
 export type { CoalexContextOptions } from "./context.js";
 export { evaluate, KNOWN_METRICS } from "./evaluate.js";
 export type { EvaluateOptions, EvaluationDecision } from "./evaluate.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKhD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAa,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3D,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAChF,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;AAIxD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACpE,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACnF,OAAO,EACL,cAAc,EACd,wBAAwB,EACxB,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,WAAW,EACX,oBAAoB,EACpB,gBAAgB,EAGhB,mBAAmB,EACnB,cAAc,GACf,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,eAAe,EACf,SAAS,EACT,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,aAAa,EACb,cAAc,EACd,UAAU,EACV,cAAc,EACd,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,YAAY,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACvI,YAAY,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AACzF,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKhD,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;IAC/B;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7B;;;;OAIG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AAED,wBAAgB,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI,CAuCxD;AAED,0CAA0C;AAC1C,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKhD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAa,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3D,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EACL,SAAS,EACT,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,YAAY,GACb,MAAM,cAAc,CAAC;AACtB,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;AAIxD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACpE,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACnF,OAAO,EACL,cAAc,EACd,wBAAwB,EACxB,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,WAAW,EACX,oBAAoB,EACpB,gBAAgB,EAGhB,mBAAmB,EACnB,cAAc,GACf,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,eAAe,EACf,SAAS,EACT,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,aAAa,EACb,cAAc,EACd,UAAU,EACV,cAAc,EACd,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,YAAY,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACvI,YAAY,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AACzF,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKhD,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;IAC/B;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7B;;;;OAIG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AAED,wBAAgB,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI,CAuCxD;AAED,0CAA0C;AAC1C,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC"}

package/dist/index.js

@@ -9,7 +9,7 @@ import { FilteringSpanExporter } from "./filtering-exporter.js";
 import { CoalexAttributePropagator } from "./span-processor.js";
 import { declareInventory } from "./inventory.js";
 import { setLogger } from "./logger.js";
-export { coalexContext, coalexContextSync, currentAgentId } from "./context.js";
+export { agentNode, coalexContext, coalexContextSync, currentAgentId, currentAgentVersion, currentParentAgentId, currentRequestId, currentRunId, } from "./context.js";
 export { evaluate, KNOWN_METRICS } from "./evaluate.js";
 export { resolve, VALID_DECISIONS } from "./resolve.js";
 // What ran while the platform was unreachable (COA-2394). Python has had this since COA-2197 and

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,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;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,EAAE,SAAS,EAAqB,MAAM,aAAa,CAAC;AAG3D,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEhF,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAExD,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACxD,iGAAiG;AACjG,iGAAiG;AACjG,2FAA2F;AAC3F,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGpE,OAAO,EACL,cAAc,EACd,wBAAwB,EACxB,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,WAAW,EACX,oBAAoB,EACpB,gBAAgB;AAChB,+FAA+F;AAC/F,iFAAiF;AACjF,mBAAmB,EACnB,cAAc,GACf,MAAM,uBAAuB,CAAC;AAc/B,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGlD,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAIvI,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;AAwBD,MAAM,UAAU,QAAQ,CAAC,OAAyB;IAChD,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,0BAA0B,CAAC;IACjE,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;IACnE,yFAAyF;IACzF,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAE3B,OAAO,GAAG,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;IACpC,OAAO,GAAG,MAAM,CAAC;IAEjB,MAAM,QAAQ,GAAG,sBAAsB,CAAC,EAAE,CAAC,iBAAiB,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC;IAE9E,MAAM,YAAY,GAAG,IAAI,iBAAiB,CAAC;QACzC,GAAG,EAAE,GAAG,QAAQ,YAAY;QAC5B,OAAO,EAAE,UAAU,CAAC,MAAM,CAAC;KAC5B,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,iGAAiG;IACjG,kGAAkG;IAClG,yEAAyE;IACzE,MAAM,QAAQ,GAAG,IAAI,kBAAkB,CAAC;QACtC,QAAQ;QACR,cAAc,EAAE,CAAC,IAAI,yBAAyB,EAAE,EAAE,IAAI,kBAAkB,CAAC,aAAa,CAAC,CAAC;KACzF,CAAC,CAAC;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC;IAEpB,IAAI,OAAO,EAAE,OAAO,EAAE,CAAC;QACrB,2FAA2F;QAC3F,2FAA2F;QAC3F,4DAA4D;QAC5D,KAAK,gBAAgB,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,CAAC;IAChG,CAAC;AACH,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,gBAAgB;IAC9B,OAAO,GAAG,IAAI,CAAC;IACf,OAAO,GAAG,IAAI,CAAC;AACjB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/span-processor.d.ts

@@ -1,5 +1,17 @@
 import type { Context } from "@opentelemetry/api";
 import type { ReadableSpan, Span, SpanProcessor } from "@opentelemetry/sdk-trace-base";
+export declare const ATTRIBUTES_TO_PROPAGATE: readonly ["coalex.agent_id", "coalex.parent_agent_id", "coalex.request_id", "coalex.run_id", "coalex.agent_version", "coalex.prompt_version", "coalex.prompt_type"];
+/**
+ * Puts the `coalex.*` attributes of the active coalexContext() on every span it starts.
+ *
+ * Each attribute comes from the **active Coalex context first**, and from the parent span only when
+ * no Coalex context is active. The parent span is not trusted over the context: a framework
+ * instrumentor (OpenInference LangChain) parents its spans on its own run tree, so a worker's LLM
+ * span can have the orchestrator's span as its parent. Inside a context, an attribute the context
+ * does not hold is left unset, so a worker never carries its orchestrator's version or prompt.
+ * Outside any context, a startup getPrompt() still attributes spans no parent attributes. A value
+ * the span already carries is never overwritten.
+ */
 export declare class CoalexAttributePropagator implements SpanProcessor {
     onStart(span: Span, parentContext: Context): void;
     onEnd(span: ReadableSpan): void;

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

@@ -1 +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;AAYvF,qBAAa,yBAA0B,YAAW,aAAa;IAC7D,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,GAAG,IAAI;IAgCjD,KAAK,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAG/B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAGzB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B"}
+{"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;AAIvF,eAAO,MAAM,uBAAuB,qKAQ1B,CAAC;AAEX;;;;;;;;;;GAUG;AACH,qBAAa,yBAA0B,YAAW,aAAa;IAC7D,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,GAAG,IAAI;IA+BjD,KAAK,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAG/B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAGzB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B"}

package/dist/span-processor.js

@@ -1,13 +1,26 @@
 import { trace } from "@opentelemetry/api";
 import { spanContextBridge } from "./ext/context-bridge.js";
-import { getLastPrompt } from "./context.js";
-const ATTRIBUTES_TO_PROPAGATE = [
+import { activeContext, contextAttributes, getLastPrompt } from "./context.js";
+export const ATTRIBUTES_TO_PROPAGATE = [
     "coalex.agent_id",
+    "coalex.parent_agent_id",
     "coalex.request_id",
+    "coalex.run_id",
     "coalex.agent_version",
     "coalex.prompt_version",
     "coalex.prompt_type",
 ];
+/**
+ * Puts the `coalex.*` attributes of the active coalexContext() on every span it starts.
+ *
+ * Each attribute comes from the **active Coalex context first**, and from the parent span only when
+ * no Coalex context is active. The parent span is not trusted over the context: a framework
+ * instrumentor (OpenInference LangChain) parents its spans on its own run tree, so a worker's LLM
+ * span can have the orchestrator's span as its parent. Inside a context, an attribute the context
+ * does not hold is left unset, so a worker never carries its orchestrator's version or prompt.
+ * Outside any context, a startup getPrompt() still attributes spans no parent attributes. A value
+ * the span already carries is never overwritten.
+ */
 export class CoalexAttributePropagator {
     onStart(span, parentContext) {
         // Track ALL spans in the context bridge for ext wrapper parenting.
@@ -15,25 +28,26 @@ export class CoalexAttributePropagator {
         // and sets openinference.span.kind only at onEnd time. So we track all
         // spans — the bridge returns the most recently active span in the trace.
         spanContextBridge.push(span, parentContext);
-        // Propagate coalex attributes from parent to child.
-        const parentSpan = trace.getSpan(parentContext);
-        const parentAttrs = parentSpan ? parentSpan.attributes : undefined;
-        for (const attrName of ATTRIBUTES_TO_PROPAGATE) {
-            const parentValue = parentAttrs?.[attrName];
-            if (parentValue !== undefined) {
-                span.setAttribute(attrName, parentValue);
-            }
+        const own = span.attributes ?? {};
+        const active = activeContext();
+        let values;
+        if (active) {
+            values = contextAttributes(active);
         }
-        // Fallback: attribute spans to the last prompt fetched via getPrompt() when no parent
-        // carries it (e.g. a root span after a startup getPrompt()) — mirrors the Python contextvar
-        // fallback (COA-368).
-        const prompt = getLastPrompt();
-        if (prompt) {
-            if (parentAttrs?.["coalex.prompt_version"] === undefined) {
-                span.setAttribute("coalex.prompt_version", prompt.version);
+        else {
+            const parentSpan = trace.getSpan(parentContext);
+            const parentAttrs = parentSpan ? parentSpan.attributes : undefined;
+            values = { ...parentAttrs };
+            const prompt = getLastPrompt();
+            if (prompt) {
+                values["coalex.prompt_version"] ??= prompt.version;
+                values["coalex.prompt_type"] ??= prompt.type;
             }
-            if (parentAttrs?.["coalex.prompt_type"] === undefined) {
-                span.setAttribute("coalex.prompt_type", prompt.type);
+        }
+        for (const attrName of ATTRIBUTES_TO_PROPAGATE) {
+            const value = values[attrName];
+            if (value !== undefined && own[attrName] === undefined) {
+                span.setAttribute(attrName, value);
             }
         }
     }

package/dist/span-processor.js.map

@@ -1 +1 @@
-{"version":3,"file":"span-processor.js","sourceRoot":"","sources":["../src/span-processor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,uBAAuB,GAAG;IAC9B,iBAAiB;IACjB,mBAAmB;IACnB,sBAAsB;IACtB,uBAAuB;IACvB,oBAAoB;CACZ,CAAC;AAEX,MAAM,OAAO,yBAAyB;IACpC,OAAO,CAAC,IAAU,EAAE,aAAsB;QACxC,mEAAmE;QACnE,0EAA0E;QAC1E,uEAAuE;QACvE,yEAAyE;QACzE,iBAAiB,CAAC,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;QAE5C,oDAAoD;QACpD,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QAChD,MAAM,WAAW,GAAG,UAAU,CAAC,CAAC,CAAE,UAAsC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;QAEhG,KAAK,MAAM,QAAQ,IAAI,uBAAuB,EAAE,CAAC;YAC/C,MAAM,WAAW,GAAG,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC;YAC5C,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;gBAC9B,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;QAED,sFAAsF;QACtF,4FAA4F;QAC5F,sBAAsB;QACtB,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC;QAC/B,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,WAAW,EAAE,CAAC,uBAAuB,CAAC,KAAK,SAAS,EAAE,CAAC;gBACzD,IAAI,CAAC,YAAY,CAAC,uBAAuB,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;YAC7D,CAAC;YACD,IAAI,WAAW,EAAE,CAAC,oBAAoB,CAAC,KAAK,SAAS,EAAE,CAAC;gBACtD,IAAI,CAAC,YAAY,CAAC,oBAAoB,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAkB;QACtB,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IAC5C,CAAC;IACD,QAAQ;QACN,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IACD,UAAU;QACR,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;CACF"}
+{"version":3,"file":"span-processor.js","sourceRoot":"","sources":["../src/span-processor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE/E,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,iBAAiB;IACjB,wBAAwB;IACxB,mBAAmB;IACnB,eAAe;IACf,sBAAsB;IACtB,uBAAuB;IACvB,oBAAoB;CACZ,CAAC;AAEX;;;;;;;;;;GAUG;AACH,MAAM,OAAO,yBAAyB;IACpC,OAAO,CAAC,IAAU,EAAE,aAAsB;QACxC,mEAAmE;QACnE,0EAA0E;QAC1E,uEAAuE;QACvE,yEAAyE;QACzE,iBAAiB,CAAC,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;QAE5C,MAAM,GAAG,GAAI,IAAgC,CAAC,UAAU,IAAI,EAAE,CAAC;QAC/D,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC;QAC/B,IAAI,MAA+B,CAAC;QACpC,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;QACrC,CAAC;aAAM,CAAC;YACN,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;YAChD,MAAM,WAAW,GAAG,UAAU,CAAC,CAAC,CAAE,UAAsC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;YAChG,MAAM,GAAG,EAAE,GAAG,WAAW,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC;YAC/B,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,CAAC,uBAAuB,CAAC,KAAK,MAAM,CAAC,OAAO,CAAC;gBACnD,MAAM,CAAC,oBAAoB,CAAC,KAAK,MAAM,CAAC,IAAI,CAAC;YAC/C,CAAC;QACH,CAAC;QAED,KAAK,MAAM,QAAQ,IAAI,uBAAuB,EAAE,CAAC;YAC/C,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC/B,IAAI,KAAK,KAAK,SAAS,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,SAAS,EAAE,CAAC;gBACvD,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,KAAwB,CAAC,CAAC;YACxD,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAkB;QACtB,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IAC5C,CAAC;IACD,QAAQ;QACN,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IACD,UAAU;QACR,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;CACF"}

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "2.2.1";
+export declare const VERSION = "2.3.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1,5 +1,5 @@
 // SDK version, sent in the X-SDK-Version header so the platform can see which
 // SDK releases customers run before removing a deprecated field (COA-261).
 // Keep in sync with package.json "version".
-export const VERSION = "2.2.1";
+export const VERSION = "2.3.0";
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coalex-ai/sdk",
-  "version": "2.2.1",
+  "version": "2.3.0-beta.686",
   "description": "Coalex TypeScript SDK for AI governance observability",
   "license": "Apache-2.0",
   "repository": {