@tessar/opentelemetry 0.0.0-stage → 0.1.0

package/dist/plugin.js

@@ -0,0 +1,40 @@
+import { BatchSpanProcessor, SimpleSpanProcessor, } from "@opentelemetry/sdk-trace-base";
+import { createTracing } from "./trace.js";
+import { registerLifecycleHooks } from "./lifecycle.js";
+import { registerModelHooks } from "./models.js";
+import { registerToolHooks } from "./tools.js";
+/** One shared tracing lifecycle with independently mapped export destinations. */
+export class OpenTelemetryPlugin {
+    id = "opentelemetry";
+    #options;
+    constructor(options) {
+        if (!Array.isArray(options?.adapters) || !options.adapters.length)
+            throw Error("OpenTelemetry requires at least one trace adapter");
+        if (options.adapters.some((adapter) => !adapter || typeof adapter.createExporter !== "function"))
+            throw Error("A trace adapter must implement createExporter()");
+        this.#options = {
+            ...options,
+            adapters: [...options.adapters],
+            tags: options.tags?.slice(),
+        };
+    }
+    async setup(tessar) {
+        const processors = [];
+        const Processor = this.#options.realtime
+            ? SimpleSpanProcessor
+            : BatchSpanProcessor;
+        try {
+            for (const adapter of this.#options.adapters)
+                processors.push(new Processor(adapter.createExporter()));
+            const tracing = createTracing(this.#options, processors);
+            registerLifecycleHooks(tessar, tracing);
+            registerModelHooks(tessar, tracing);
+            registerToolHooks(tessar, tracing);
+        }
+        catch (error) {
+            await Promise.allSettled(processors.map((processor) => processor.shutdown()));
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AACA,OAAO,EACL,kBAAkB,EAClB,mBAAmB,GAEpB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C,kFAAkF;AAClF,MAAM,OAAO,mBAAmB;IACrB,EAAE,GAAG,eAAe,CAAC;IACrB,QAAQ,CAAuB;IAExC,YAAY,OAA6B;QACvC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM;YAC/D,MAAM,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACnE,IACE,OAAO,CAAC,QAAQ,CAAC,IAAI,CACnB,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,IAAI,OAAO,OAAO,CAAC,cAAc,KAAK,UAAU,CACtE;YAED,MAAM,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACjE,IAAI,CAAC,QAAQ,GAAG;YACd,GAAG,OAAO;YACV,QAAQ,EAAE,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC;YAC/B,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE;SAC5B,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAAqB;QAC/B,MAAM,UAAU,GAAoB,EAAE,CAAC;QACvC,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ;YACtC,CAAC,CAAC,mBAAmB;YACrB,CAAC,CAAC,kBAAkB,CAAC;QACvB,IAAI,CAAC;YACH,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ;gBAC1C,UAAU,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC;YAC3D,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;YACzD,sBAAsB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACxC,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACpC,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACrC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,CAAC,UAAU,CACtB,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC,CACpD,CAAC;YACF,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF"}

package/dist/tools.d.ts

@@ -0,0 +1,4 @@
+import { type PluginContext } from "@tessar/core";
+import { type TraceRuntime } from "./trace.js";
+/** Records tool arguments, results, errors and parent Turn relationships. */
+export declare function registerToolHooks(tessar: PluginContext, tracing: TraceRuntime): void;

package/dist/tools.js

@@ -0,0 +1,53 @@
+import { tool } from "@tessar/core";
+import { update } from "./trace.js";
+/** Records tool arguments, results, errors and parent Turn relationships. */
+export function registerToolHooks(tessar, tracing) {
+    const { current, parentTurn, start, end, failure } = tracing;
+    tessar.hook(tool.start, (event, context) => {
+        const state = current(event);
+        if (!state || state.tools.has(event.payload.toolExecutionId))
+            return;
+        const call = state.calls.get(event.payload.toolCallId);
+        const name = event.payload.name ?? call?.name ?? "tool";
+        const definition = context.registry.get("tool", name);
+        const span = start(name, "tool", event, {
+            ...state.identity,
+            toolExecutionId: event.payload.toolExecutionId,
+            toolCallId: event.payload.toolCallId,
+            toolDescription: definition?.description,
+            toolParameters: definition?.jsonSchema,
+        }, parentTurn(state, event, event.payload.turnId), { input: event.payload.arguments ?? call?.arguments }, event.payload.startedAt);
+        state.tools.set(event.payload.toolExecutionId, span);
+    });
+    tessar.hook(tool.error, (event) => {
+        const span = current(event)?.tools.get(event.payload.toolExecutionId);
+        if (span)
+            failure(span, "tool", event.payload.error);
+    });
+    tessar.hook(tool.end, (event, context) => {
+        const state = current(event);
+        if (!state)
+            return;
+        const call = state.calls.get(event.payload.toolCallId);
+        const definition = call && context.registry.get("tool", call.name);
+        const active = state.tools.get(event.payload.toolExecutionId);
+        const span = active ??
+            start(call?.name ?? "tool", "tool", event, {
+                ...state.identity,
+                toolExecutionId: event.payload.toolExecutionId,
+                toolCallId: event.payload.toolCallId,
+            }, parentTurn(state, event), { input: call?.arguments });
+        update(span, "tool", {
+            output: event.payload.result,
+            metadata: {
+                status: event.payload.status,
+                toolDescription: definition?.description,
+                toolParameters: definition?.jsonSchema,
+            },
+        });
+        end(span, event, event.payload.endedAt);
+        state.tools.delete(event.payload.toolExecutionId);
+        state.calls.delete(event.payload.toolCallId);
+    });
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/dist/trace.d.ts

@@ -0,0 +1,24 @@
+import { type Span } from "@opentelemetry/api";
+import { type SpanProcessor } from "@opentelemetry/sdk-trace-base";
+import type { EventContext, MessageData } from "@tessar/core";
+import type { OpenTelemetryOptions, ObservationType, ObservationAttributes, ExecutionTrace, ThreadTraceState } from "./types.js";
+export declare function update(span: Span, type: ObservationType, attributes: ObservationAttributes): void;
+export declare const time: (event: EventContext, recorded?: string | null) => Date | undefined;
+/** Owns the instance-local tracer, span hierarchy and active execution state. */
+export declare function createTracing(options: OpenTelemetryOptions, spanProcessors: SpanProcessor[]): {
+    executions: Map<string, ExecutionTrace>;
+    links: Map<string, ThreadTraceState>;
+    start: (name: string, type: ObservationType, event: EventContext, identity: Record<string, unknown>, parent?: Span, attributes?: ObservationAttributes, startedAt?: string | null) => Span;
+    end: (span: Span, event: EventContext, endedAt?: string | null) => void;
+    begin: (event: EventContext, checkpointId?: string, startedAt?: string | null) => ExecutionTrace | undefined;
+    current: (event: EventContext) => ExecutionTrace | undefined;
+    parentTurn: (state: ExecutionTrace, event: EventContext, id?: string | undefined, index?: number) => Span;
+    failure: (span: Span, type: ObservationType, error: {
+        message: string;
+    }) => void;
+    finish: (event: EventContext, status: string, error?: {
+        message: string;
+    } | null, output?: readonly MessageData[], endedAt?: string | null) => void;
+    shutdown: () => Promise<void>;
+};
+export type TraceRuntime = ReturnType<typeof createTracing>;

package/dist/trace.js

@@ -0,0 +1,211 @@
+import { createHash } from "node:crypto";
+import { ROOT_CONTEXT, diag, SpanStatusCode, trace, } from "@opentelemetry/api";
+import { BasicTracerProvider, RandomIdGenerator, } from "@opentelemetry/sdk-trace-base";
+import { resourceFromAttributes } from "@opentelemetry/resources";
+import { observationAttributes } from "./attributes.js";
+export function update(span, type, attributes) {
+    if (span.isRecording())
+        span.setAttributes(observationAttributes(type, attributes));
+}
+export const time = (event, recorded) => recorded || event.timestamp
+    ? new Date(recorded ?? event.timestamp)
+    : undefined;
+const hash = (seed) => createHash("sha256").update(seed).digest("hex");
+/** Owns the instance-local tracer, span hierarchy and active execution state. */
+export function createTracing(options, spanProcessors) {
+    const random = new RandomIdGenerator();
+    let nextTraceId;
+    const provider = new BasicTracerProvider({
+        spanProcessors,
+        resource: options.serviceName
+            ? resourceFromAttributes({ "service.name": options.serviceName })
+            : undefined,
+        idGenerator: {
+            generateSpanId: () => random.generateSpanId(),
+            generateTraceId: () => nextTraceId ?? random.generateTraceId(),
+        },
+    });
+    const tracer = provider.getTracer("@tessar/opentelemetry");
+    const executions = new Map();
+    const links = new Map();
+    const starts = new WeakMap();
+    const start = (name, type, event, identity, parent, attributes = {}, startedAt) => {
+        const observed = time(event) ?? new Date();
+        let startTime = time(event, startedAt) ?? observed;
+        const parentStart = parent && starts.get(parent);
+        // A resumed logical task can predate this segment. Its new observation
+        // starts at this notification, never before its fresh parent root.
+        if (parentStart !== undefined && startTime.getTime() < parentStart)
+            startTime = new Date(Math.max(parentStart, observed.getTime()));
+        const span = tracer.startSpan(name, {
+            startTime,
+            attributes: observationAttributes(type, {
+                ...attributes,
+                metadata: {
+                    ...identity,
+                    ...attributes.metadata,
+                    recordStartedAt: startedAt,
+                },
+            }),
+        }, parent ? trace.setSpan(ROOT_CONTEXT, parent) : ROOT_CONTEXT);
+        starts.set(span, startTime.getTime());
+        if (event.sessionId)
+            span.setAttribute("session.id", event.sessionId);
+        if (event.threadId)
+            span.setAttribute("gen_ai.conversation.id", event.threadId);
+        if (event.agentId)
+            span.setAttribute("gen_ai.agent.id", event.agentId);
+        if (type === "tool")
+            span.setAttribute("gen_ai.tool.name", name);
+        span.setAttribute("tessar.trace.name", options.traceName ??
+            (event.sessionId
+                ? `${event.agentId ?? "agent"} / ${event.threadId}`
+                : (event.agentId ?? "agent")));
+        if (options.tags?.length)
+            span.setAttribute("tessar.trace.tags", [...options.tags]);
+        return span;
+    };
+    const end = (span, event, endedAt) => {
+        const observed = time(event) ?? new Date();
+        const started = starts.get(span) ?? observed.getTime();
+        const recorded = time(event, endedAt) ?? observed;
+        if (endedAt)
+            span.setAttribute("tessar.metadata.recordEndedAt", JSON.stringify(endedAt));
+        span.end(new Date(Math.max(started, recorded.getTime() < started
+            ? observed.getTime()
+            : recorded.getTime())));
+    };
+    const begin = (event, checkpointId, startedAt) => {
+        if (!event.streamId)
+            return;
+        const existing = executions.get(event.streamId);
+        if (existing)
+            return existing;
+        const identity = Object.fromEntries(Object.entries({
+            controllerId: event.controllerId,
+            agentId: event.agentId,
+            sessionId: event.sessionId,
+            threadId: event.threadId,
+            streamId: event.streamId,
+            checkpointId,
+            scope: event.scope,
+        }).filter(([, value]) => value !== undefined));
+        const link = links.get(event.streamId);
+        // Each invocation or continuation segment owns a fresh, recording root.
+        nextTraceId = hash(JSON.stringify([
+            event.controllerId,
+            event.agentId,
+            event.threadId,
+            event.streamId,
+            checkpointId,
+        ])).slice(0, 32);
+        let root;
+        try {
+            root = start(event.agentId ?? "agent", "agent", event, identity, undefined, { output: [] }, startedAt);
+        }
+        finally {
+            nextTraceId = undefined;
+        }
+        const state = {
+            root,
+            link,
+            identity,
+            output: [],
+            turns: new Map(),
+            models: new Map(),
+            tools: new Map(),
+            calls: new Map(),
+            firstOutputs: new Set(),
+        };
+        executions.set(event.streamId, state);
+        return state;
+    };
+    const current = (event) => event.streamId ? executions.get(event.streamId) : undefined;
+    const parentTurn = (state, event, id = state.currentTurn, index) => {
+        if (!id)
+            return state.root;
+        let turn = state.turns.get(id);
+        if (!turn) {
+            let number = index === undefined ? undefined : index + 1;
+            if (state.link?.turnId === id)
+                number = state.link.turnCount;
+            const span = start(number === undefined ? "turn" : `turn ${number}`, "span", state.currentTurn === id && state.turnStartedAt
+                ? { ...event, timestamp: state.turnStartedAt }
+                : event, {
+                ...state.identity,
+                turnId: id,
+                ...(index === undefined ? {} : { index }),
+                turnNumber: number,
+            }, state.root, { output: [] }, state.turnStartedAt);
+            turn = { span, output: [] };
+            state.turns.set(id, turn);
+        }
+        return turn.span;
+    };
+    const failure = (span, type, error) => {
+        if (!span.isRecording())
+            return;
+        span.setStatus({ code: SpanStatusCode.ERROR, message: error.message });
+        span.recordException(error.message);
+        update(span, type, {
+            level: "ERROR",
+            statusMessage: error.message,
+            metadata: { error },
+        });
+    };
+    const finish = (event, status, error, output, endedAt) => {
+        const state = current(event);
+        if (!state)
+            return;
+        for (const [spans, type] of [
+            [state.models, "generation"],
+            [state.tools, "tool"],
+            [[...state.turns.values()].map((turn) => turn.span), "span"],
+        ]) {
+            for (const span of spans.values()) {
+                if (error)
+                    failure(span, type, error);
+                update(span, type, {
+                    level: error ? "ERROR" : "WARNING",
+                    metadata: {
+                        status: status === "completed" ? "interrupted" : status,
+                    },
+                });
+                end(span, event);
+            }
+        }
+        if (error)
+            failure(state.root, "agent", error);
+        update(state.root, "agent", {
+            // Stream outcomes include earlier suspended segments; this root owns
+            // only the messages published during its current continuation.
+            output: state.identity.checkpointId
+                ? state.output
+                : (output ?? state.output),
+            metadata: { status },
+            ...(status === "suspended" ||
+                status === "cancelled" ||
+                status === "interrupted"
+                ? { level: "WARNING" }
+                : {}),
+        });
+        end(state.root, event, endedAt);
+        executions.delete(event.streamId);
+        links.delete(event.streamId);
+    };
+    return {
+        executions,
+        links,
+        start,
+        end,
+        begin,
+        current,
+        parentTurn,
+        failure,
+        finish,
+        shutdown: () => provider.shutdown().catch((error) => {
+            diag.error("Tessar trace export shutdown failed", error);
+        }),
+    };
+}
+//# sourceMappingURL=trace.js.map

package/dist/trace.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,54 @@
+import type { Span } from "@opentelemetry/api";
+import type { SpanExporter } from "@opentelemetry/sdk-trace-base";
+import type { JsonObject, MessageData, ModelUsage } from "@tessar/core";
+export interface TraceAdapter {
+    createExporter(): SpanExporter;
+}
+export interface OpenTelemetryOptions {
+    adapters: readonly TraceAdapter[];
+    /** Export each completed span immediately instead of batching. Defaults to false. */
+    realtime?: boolean;
+    /** OTel service.name resource attribute. */
+    serviceName?: string;
+    /** Override the shared trace name; individual tool/model names are unchanged. */
+    traceName?: string;
+    /** Application-defined tags propagated to every observation. */
+    tags?: readonly string[];
+}
+export type ObservationType = "agent" | "span" | "generation" | "tool";
+export interface ObservationAttributes {
+    input?: unknown;
+    output?: unknown;
+    metadata?: Record<string, unknown>;
+    model?: string;
+    modelParameters?: Record<string, string | number>;
+    usage?: ModelUsage;
+    completionStartTime?: Date;
+    level?: "ERROR" | "WARNING";
+    statusMessage?: string;
+}
+interface TurnTrace {
+    span: Span;
+    output: MessageData[];
+}
+export type ThreadTraceState = {
+    turnCount: number;
+    turnId: string;
+};
+export interface ExecutionTrace {
+    root: Span;
+    link?: ThreadTraceState;
+    turns: Map<string, TurnTrace>;
+    output: MessageData[];
+    models: Map<string, Span>;
+    tools: Map<string, Span>;
+    calls: Map<string, {
+        name: string;
+        arguments: JsonObject;
+    }>;
+    firstOutputs: Set<string>;
+    currentTurn?: string;
+    turnStartedAt?: string;
+    identity: Record<string, unknown>;
+}
+export {};

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,52 @@
 {
   "name": "@tessar/opentelemetry",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "license": "Apache-2.0",
+  "description": "OpenTelemetry tracing for Tessar with OTLP, Langfuse and Laminar adapters.",
+  "keywords": [
+    "tessar",
+    "ai-agent",
+    "opentelemetry",
+    "otlp",
+    "tracing",
+    "llm",
+    "langfuse",
+    "laminar",
+    "typescript"
+  ],
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=24.22.1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tessar-ai/tessar.git",
+    "directory": "packages/opentelemetry"
+  },
+  "homepage": "https://github.com/tessar-ai/tessar#readme",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@opentelemetry/api": "1.9.0",
+    "@opentelemetry/core": "2.12.0",
+    "@opentelemetry/sdk-trace-base": "2.12.0",
+    "@opentelemetry/exporter-trace-otlp-http": "0.223.0",
+    "@opentelemetry/resources": "2.12.0",
+    "@tessar/core": "0.1.5"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json"
+  }
 }