@tessar/opentelemetry 0.0.0-stage → 0.1.0

package/dist/adapters/otlp.js

@@ -0,0 +1,50 @@
+import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-http";
+import { ExportResultCode } from "@opentelemetry/core";
+class MappedExporter {
+    exporter;
+    map;
+    constructor(exporter, map) {
+        this.exporter = exporter;
+        this.map = map;
+    }
+    export(spans, done) {
+        try {
+            this.exporter.export(spans.map(this.map), done);
+        }
+        catch (error) {
+            done({
+                code: ExportResultCode.FAILED,
+                error: error instanceof Error ? error : Error(String(error)),
+            });
+        }
+    }
+    shutdown() {
+        return this.exporter.shutdown();
+    }
+    forceFlush() {
+        return this.exporter.forceFlush?.() ?? Promise.resolve();
+    }
+}
+/** Standard OTLP/HTTP JSON export, for compatible receivers and collectors. */
+export class OTLPAdapter {
+    #options;
+    constructor(options = {}) {
+        if (options.endpoint &&
+            !["http:", "https:"].includes(new URL(options.endpoint).protocol))
+            throw Error("OTLP endpoint must use HTTP or HTTPS");
+        this.#options = {
+            ...options,
+            headers: options.headers ? { ...options.headers } : undefined,
+        };
+    }
+    mapSpan(span) {
+        return span;
+    }
+    createExporter() {
+        return new MappedExporter(new OTLPTraceExporter({
+            url: this.#options.endpoint,
+            headers: this.#options.headers,
+        }), (span) => this.mapSpan(span));
+    }
+}
+//# sourceMappingURL=otlp.js.map

package/dist/adapters/otlp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"otlp.js","sourceRoot":"","sources":["../../src/adapters/otlp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAqB,MAAM,qBAAqB,CAAC;AAU1E,MAAM,cAAc;IAEC,QAAQ;IACR,GAAG;IAFtB,YACmB,QAAsB,EACtB,GAAyC;wBADzC,QAAQ;mBACR,GAAG;IACnB,CAAC;IACJ,MAAM,CAAC,KAAqB,EAAE,IAAoC;QAChE,IAAI,CAAC;YACH,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;QAClD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC;gBACH,IAAI,EAAE,gBAAgB,CAAC,MAAM;gBAC7B,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;aAC7D,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,QAAQ;QACN,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;IAClC,CAAC;IACD,UAAU;QACR,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3D,CAAC;CACF;AAED,+EAA+E;AAC/E,MAAM,OAAO,WAAW;IACb,QAAQ,CAAc;IAC/B,YAAY,OAAO,GAAgB,EAAE;QACnC,IACE,OAAO,CAAC,QAAQ;YAChB,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC;YAEjE,MAAM,KAAK,CAAC,sCAAsC,CAAC,CAAC;QACtD,IAAI,CAAC,QAAQ,GAAG;YACd,GAAG,OAAO;YACV,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS;SAC9D,CAAC;IACJ,CAAC;IACS,OAAO,CAAC,IAAkB;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,cAAc;QACZ,OAAO,IAAI,cAAc,CACvB,IAAI,iBAAiB,CAAC;YACpB,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ;YAC3B,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO;SAC/B,CAAC,EACF,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAC7B,CAAC;IACJ,CAAC;CACF"}

package/dist/attributes.d.ts

@@ -0,0 +1,8 @@
+import type { Attributes } from "@opentelemetry/api";
+import type { ReadableSpan } from "@opentelemetry/sdk-trace-base";
+import type { ObservationAttributes, ObservationType } from "./types.js";
+/** Shared spans contain standard GenAI fields and lossless Tessar payloads. */
+export declare function observationAttributes(type: ObservationType, value: ObservationAttributes): Attributes;
+export declare function readJson<T>(span: ReadableSpan, key: string): T | undefined;
+/** Exporter-specific snapshots keep mappings isolated from the original span. */
+export declare function mappedSpan(span: ReadableSpan, attributes: Attributes, resource?: import("@opentelemetry/resources").Resource): ReadableSpan;

package/dist/attributes.js

@@ -0,0 +1,106 @@
+import { genAIMessages } from "./messages.js";
+/** Shared spans contain standard GenAI fields and lossless Tessar payloads. */
+export function observationAttributes(type, value) {
+    const result = { "tessar.observation.type": type };
+    for (const [key, data] of Object.entries({
+        input: value.input,
+        output: value.output,
+        usage: value.usage,
+        "model.parameters": value.modelParameters,
+    }))
+        if (data !== undefined)
+            result["tessar." + key] = JSON.stringify(data);
+    if (value.completionStartTime !== undefined)
+        result["tessar.completion_start_time"] =
+            value.completionStartTime.toISOString();
+    for (const [key, data] of Object.entries(value.metadata ?? {}))
+        if (data !== undefined)
+            result["tessar.metadata." + key] = JSON.stringify(data);
+    if (value.level !== undefined)
+        result["tessar.level"] = value.level;
+    if (value.statusMessage !== undefined)
+        result["tessar.status_message"] = value.statusMessage;
+    if (value.model !== undefined)
+        result["gen_ai.request.model"] = value.model;
+    if (typeof value.metadata?.providerId === "string")
+        result["gen_ai.provider.name"] = value.metadata.providerId;
+    const operation = {
+        agent: "invoke_agent",
+        generation: "chat",
+        tool: "execute_tool",
+        span: undefined,
+    }[type];
+    if (operation)
+        result["gen_ai.operation.name"] = operation;
+    if (type === "tool") {
+        if (typeof value.metadata?.toolDescription === "string")
+            result["gen_ai.tool.description"] = value.metadata.toolDescription;
+        if (typeof value.metadata?.toolCallId === "string")
+            result["gen_ai.tool.call.id"] = value.metadata.toolCallId;
+        if (value.input !== undefined)
+            result["gen_ai.tool.call.arguments"] = JSON.stringify(value.input);
+        const output = value.output;
+        if (output?.role === "tool") {
+            const part = genAIMessages([output])[0].parts[0];
+            if ("response" in part)
+                result["gen_ai.tool.call.result"] = JSON.stringify(part.response);
+        }
+    }
+    if (type === "generation") {
+        const request = value.input;
+        if (request?.tools)
+            result["gen_ai.tool.definitions"] = JSON.stringify(request.tools.map((tool) => ({
+                type: "function",
+                name: tool.name,
+                description: tool.description,
+                parameters: tool.inputSchema,
+            })));
+        const instructions = request?.instructions?.sections
+            .filter((section) => section.content.length > 0)
+            .map((section) => ({ type: "text", content: section.content }));
+        if (instructions?.length)
+            result["gen_ai.system_instructions"] = JSON.stringify(instructions);
+        if (request?.messages)
+            result["gen_ai.input.messages"] = JSON.stringify(genAIMessages(request.messages));
+        const output = value.output;
+        if (output?.content)
+            result["gen_ai.output.messages"] = JSON.stringify(genAIMessages([output]));
+    }
+    for (const [key, count] of Object.entries({
+        input_tokens: value.usage?.inputTokens,
+        output_tokens: value.usage?.outputTokens,
+        "cache_read.input_tokens": value.usage?.cacheReadInputTokens,
+        "cache_creation.input_tokens": value.usage?.cacheWriteInputTokens,
+        "reasoning.output_tokens": value.usage?.reasoningOutputTokens,
+    }))
+        if (count !== null && count !== undefined)
+            result["gen_ai.usage." + key] = count;
+    return result;
+}
+export function readJson(span, key) {
+    const value = span.attributes[key];
+    return typeof value === "string" ? JSON.parse(value) : undefined;
+}
+/** Exporter-specific snapshots keep mappings isolated from the original span. */
+export function mappedSpan(span, attributes, resource = span.resource) {
+    return {
+        name: span.name,
+        kind: span.kind,
+        spanContext: () => span.spanContext(),
+        parentSpanContext: span.parentSpanContext,
+        startTime: span.startTime,
+        endTime: span.endTime,
+        status: span.status,
+        attributes,
+        links: span.links,
+        events: span.events,
+        duration: span.duration,
+        ended: span.ended,
+        resource,
+        instrumentationScope: span.instrumentationScope,
+        droppedAttributesCount: span.droppedAttributesCount,
+        droppedEventsCount: span.droppedEventsCount,
+        droppedLinksCount: span.droppedLinksCount,
+    };
+}
+//# sourceMappingURL=attributes.js.map

package/dist/attributes.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { OpenTelemetryPlugin } from "./plugin.js";
+export type { OpenTelemetryOptions, TraceAdapter } from "./types.js";
+export { OTLPAdapter, type OTLPOptions } from "./adapters/otlp.js";
+export { LangfuseAdapter, type LangfuseOptions } from "./adapters/langfuse.js";
+export { LaminarAdapter, type LaminarOptions } from "./adapters/laminar.js";

package/dist/index.js

@@ -0,0 +1,5 @@
+export { OpenTelemetryPlugin } from "./plugin.js";
+export { OTLPAdapter } from "./adapters/otlp.js";
+export { LangfuseAdapter } from "./adapters/langfuse.js";
+export { LaminarAdapter } from "./adapters/laminar.js";
+//# 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,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,EAAE,WAAW,EAAoB,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAE,eAAe,EAAwB,MAAM,wBAAwB,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAuB,MAAM,uBAAuB,CAAC"}

package/dist/lifecycle.d.ts

@@ -0,0 +1,4 @@
+import { type PluginContext } from "@tessar/core";
+import { type TraceRuntime } from "./trace.js";
+/** Persists Thread Turn counters and observes each execution segment. */
+export declare function registerLifecycleHooks(tessar: PluginContext, tracing: TraceRuntime): void;

package/dist/lifecycle.js

@@ -0,0 +1,162 @@
+import { input, stream, turn, message, checkpoint as checkpointHooks, } from "@tessar/core";
+import { update } from "./trace.js";
+/** Persists Thread Turn counters and observes each execution segment. */
+export function registerLifecycleHooks(tessar, tracing) {
+    const { executions, links, begin, current, parentTurn, end, finish } = tracing;
+    const savedTrace = tessar.state.define({
+        namespace: "trace",
+        schemaVersion: 1,
+        initial: {
+            turnCount: 0,
+            turnId: "",
+        },
+        fork: "reset",
+    });
+    tessar.hook(input.prepare, (event, context) => {
+        if (!event.sessionId || !event.streamId)
+            return;
+        const saved = context.state.get(savedTrace);
+        links.set(event.streamId, {
+            turnCount: saved.turnCount,
+            turnId: saved.turnId,
+        });
+    });
+    tessar.hook(turn.start, async (event, context) => {
+        if (!event.sessionId || !event.payload.turnId)
+            return;
+        const link = links.get(event.streamId);
+        if (!link)
+            return;
+        const saved = context.state.get(savedTrace), fresh = saved.turnId !== event.payload.turnId;
+        const value = {
+            turnId: event.payload.turnId,
+            turnCount: saved.turnCount + (fresh ? 1 : 0),
+        };
+        context.state.update(savedTrace, value);
+        Object.assign(link, value);
+        await context.state.commit();
+    });
+    tessar.defer(async () => {
+        for (const streamId of [...executions.keys()])
+            finish({ streamId }, "interrupted");
+        links.clear();
+        await tracing.shutdown();
+    });
+    tessar.hook(stream.started, (event) => {
+        begin(event, undefined, event.payload.startedAt);
+    });
+    const restore = (event, checkpointId, checkpoint) => {
+        const existing = current(event);
+        if (existing)
+            return existing;
+        // Keep counters from old snapshots; root/Turn-created flags are obsolete.
+        const snapshot = checkpoint?.state.pluginStates.find((value) => value.pluginId === "opentelemetry" &&
+            value.namespace === "trace" &&
+            value.ownerType === "thread");
+        if (event.sessionId && event.streamId && snapshot) {
+            const saved = snapshot.data;
+            links.set(event.streamId, {
+                turnCount: saved.turnCount,
+                turnId: saved.turnId,
+            });
+        }
+        const state = begin(event, checkpointId);
+        if (!state)
+            return;
+        update(state.root, "agent", {
+            input: { checkpointId },
+            metadata: { inputSource: "resume" },
+        });
+        if (!checkpoint)
+            return state;
+        const execution = checkpoint.execution;
+        if (!execution?.turnId || execution.phase === "BeforeTurn")
+            return state;
+        state.currentTurn = execution.turnId;
+        const span = parentTurn(state, event, execution.turnId, execution.budgets.turns - 1);
+        update(span, "span", {
+            input: { messages: checkpoint.state.messages },
+            metadata: { inputSource: "checkpoint" },
+        });
+        for (const message of checkpoint.state.messages)
+            for (const part of message.content)
+                if (part.type === "tool-call")
+                    state.calls.set(part.toolCallId, {
+                        name: part.name,
+                        arguments: part.arguments,
+                    });
+        return state;
+    };
+    tessar.hook(checkpointHooks.committed, async (event, context) => {
+        // Recovery can publish saved tool results before stream.resumed. Open its
+        // segment first; normal input.prepare has already installed its counter.
+        if (!event.streamId || current(event) || links.has(event.streamId))
+            return;
+        const checkpoint = await context.thread?.getCheckpoint(event.payload.checkpointId);
+        if (checkpoint?.execution)
+            restore(event, checkpoint.id, checkpoint);
+    });
+    tessar.hook(stream.resumed, async (event, context) => {
+        const checkpoint = await context.thread?.getCheckpoint(event.payload.checkpointId);
+        const state = restore(event, event.payload.checkpointId, checkpoint);
+        if (state)
+            update(state.root, "agent", {
+                input: event.payload,
+                metadata: { inputSource: "resume" },
+            });
+    });
+    tessar.hook(input.received, (event) => {
+        const state = current(event);
+        if (!state)
+            return;
+        update(state.root, "agent", { input: event.payload.messages });
+    });
+    tessar.hook(turn.start, (event) => {
+        const state = current(event);
+        if (!state)
+            return;
+        state.currentTurn = event.payload.turnId;
+        state.turnStartedAt = event.payload.startedAt ?? event.timestamp;
+        // Thread numbering is updated at turn.start before a model is selected.
+        if (!state.link)
+            parentTurn(state, event, event.payload.turnId, event.payload.index);
+    });
+    tessar.hook(turn.end, (event) => {
+        const state = current(event), turn = state?.turns.get(event.payload.turnId);
+        if (!turn)
+            return;
+        update(turn.span, "span", {
+            metadata: { usage: event.payload.usage, status: "ended" },
+        });
+        end(turn.span, event, event.payload.endedAt);
+        state.turns.delete(event.payload.turnId);
+        if (state.currentTurn === event.payload.turnId)
+            state.currentTurn = undefined;
+    });
+    tessar.hook(message.committed, (event) => {
+        const state = current(event), value = event.payload.message;
+        if (!state || (value.role !== "assistant" && value.role !== "tool"))
+            return;
+        state.output.push(value);
+        const turn = state.currentTurn
+            ? state.turns.get(state.currentTurn)
+            : undefined;
+        if (turn) {
+            turn.output.push(value);
+            update(turn.span, "span", { output: turn.output });
+        }
+    });
+    tessar.hook(stream.suspended, (event) => {
+        finish(event, "suspended");
+    });
+    tessar.hook(stream.end, (event) => {
+        finish(event, event.payload.status, event.payload.error, event.payload.output, event.payload.endedAt);
+    });
+    tessar.hook(stream.error, (event) => {
+        if (event.payload.target === "consumer")
+            return;
+        begin(event);
+        finish(event, "failed", event.payload.error, undefined, event.payload.endedAt);
+    });
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/lifecycle.js.map

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

package/dist/messages.d.ts

@@ -0,0 +1,75 @@
+import type { MessageData, ModelRequest } from "@tessar/core";
+type TraceMessage = Pick<MessageData, "role" | "content" | "toolCallId">;
+/** Display projection only: the provider request and its history remain unchanged. */
+export declare function inputMessages(request: Pick<ModelRequest, "instructions" | "messages">): readonly TraceMessage[];
+/** GenAI message parts keep visible reasoning separate from the final answer. */
+export declare function genAIMessages(values: readonly TraceMessage[]): {
+    role: import("@tessar/core").MessageRole;
+    parts: {
+        type: string;
+        id?: string | undefined;
+        response: (import("@tessar/core").JsonValue | ({
+            readonly type: "reasoning";
+            readonly text: string;
+            readonly providerState?: import("@tessar/core").JsonValue;
+        } & {
+            readonly metadata?: import("@tessar/core").JsonObject;
+        }) | ({
+            readonly type: "tool-call";
+            readonly toolCallId: string;
+            readonly name: string;
+            readonly arguments: import("@tessar/core").JsonObject;
+        } & {
+            readonly metadata?: import("@tessar/core").JsonObject;
+        }) | ({
+            readonly type: "image" | "audio" | "file";
+            readonly mediaType: string;
+            readonly data: string;
+        } & {
+            readonly metadata?: import("@tessar/core").JsonObject;
+        }))[] | import("@tessar/core").JsonValue | ({
+            readonly type: "reasoning";
+            readonly text: string;
+            readonly providerState?: import("@tessar/core").JsonValue;
+        } & {
+            readonly metadata?: import("@tessar/core").JsonObject;
+        }) | ({
+            readonly type: "tool-call";
+            readonly toolCallId: string;
+            readonly name: string;
+            readonly arguments: import("@tessar/core").JsonObject;
+        } & {
+            readonly metadata?: import("@tessar/core").JsonObject;
+        }) | ({
+            readonly type: "image" | "audio" | "file";
+            readonly mediaType: string;
+            readonly data: string;
+        } & {
+            readonly metadata?: import("@tessar/core").JsonObject;
+        });
+    }[] | ({
+        type: "reasoning" | "text";
+        content: string;
+        id?: undefined;
+        name?: undefined;
+        arguments?: undefined;
+    } | {
+        content?: undefined;
+        type: string;
+        id: string;
+        name: string;
+        arguments: import("@tessar/core").JsonObject;
+    } | ({
+        readonly type: "image" | "audio" | "file";
+        readonly mediaType: string;
+        readonly data: string;
+    } & {
+        readonly metadata?: import("@tessar/core").JsonObject;
+    }) | ({
+        readonly type: "data";
+        readonly data: import("@tessar/core").JsonValue;
+    } & {
+        readonly metadata?: import("@tessar/core").JsonObject;
+    }))[];
+}[];
+export {};

package/dist/messages.js

@@ -0,0 +1,55 @@
+/** Display projection only: the provider request and its history remain unchanged. */
+export function inputMessages(request) {
+    const sections = request.instructions.sections;
+    if (!sections.some((section) => section.content.length > 0))
+        return request.messages;
+    return [
+        {
+            role: "system",
+            content: [
+                {
+                    type: "text",
+                    text: sections.map((section) => section.content).join("\n\n"),
+                },
+            ],
+        },
+        ...request.messages,
+    ];
+}
+/** GenAI message parts keep visible reasoning separate from the final answer. */
+export function genAIMessages(values) {
+    return values.map((message) => ({
+        role: message.role,
+        parts: message.role === "tool"
+            ? [
+                {
+                    type: "tool_call_response",
+                    ...(message.toolCallId ? { id: message.toolCallId } : {}),
+                    response: message.content.length === 1
+                        ? toolContent(message.content[0])
+                        : message.content.map(toolContent),
+                },
+            ]
+            : message.content.map((part) => {
+                if (part.type === "text" || part.type === "reasoning")
+                    return { type: part.type, content: part.text };
+                if (part.type === "tool-call")
+                    return {
+                        type: "tool_call",
+                        id: part.toolCallId,
+                        name: part.name,
+                        arguments: part.arguments,
+                    };
+                // Media/custom parts retain their declared type and data as generic parts.
+                return part;
+            }),
+    }));
+}
+function toolContent(part) {
+    return part.type === "text"
+        ? part.text
+        : part.type === "data"
+            ? part.data
+            : part;
+}
+//# sourceMappingURL=messages.js.map

package/dist/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"AAIA,sFAAsF;AACtF,MAAM,UAAU,aAAa,CAC3B,OAAwD;IAExD,MAAM,QAAQ,GAAG,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC;IAC/C,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;QACzD,OAAO,OAAO,CAAC,QAAQ,CAAC;IAC1B,OAAO;QACL;YACE,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;iBAC9D;aACF;SACF;QACD,GAAG,OAAO,CAAC,QAAQ;KACpB,CAAC;AACJ,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,aAAa,CAAC,MAA+B;IAC3D,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC9B,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,KAAK,EACH,OAAO,CAAC,IAAI,KAAK,MAAM;YACrB,CAAC,CAAC;gBACE;oBACE,IAAI,EAAE,oBAAoB;oBAC1B,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACzD,QAAQ,EACN,OAAO,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;wBAC1B,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAE,CAAC;wBAClC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;iBACvC;aACF;YACH,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;gBAC3B,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW;oBACnD,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;gBACjD,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW;oBAC3B,OAAO;wBACL,IAAI,EAAE,WAAW;wBACjB,EAAE,EAAE,IAAI,CAAC,UAAU;wBACnB,IAAI,EAAE,IAAI,CAAC,IAAI;wBACf,SAAS,EAAE,IAAI,CAAC,SAAS;qBAC1B,CAAC;gBACJ,2EAA2E;gBAC3E,OAAO,IAAI,CAAC;YACd,CAAC,CAAC;KACT,CAAC,CAAC,CAAC;AACN,CAAC;AAED,SAAS,WAAW,CAAC,IAAoC;IACvD,OAAO,IAAI,CAAC,IAAI,KAAK,MAAM;QACzB,CAAC,CAAC,IAAI,CAAC,IAAI;QACX,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM;YACpB,CAAC,CAAC,IAAI,CAAC,IAAI;YACX,CAAC,CAAC,IAAI,CAAC;AACb,CAAC"}

package/dist/models.d.ts

@@ -0,0 +1,4 @@
+import { type PluginContext } from "@tessar/core";
+import { type TraceRuntime } from "./trace.js";
+/** Records model requests, retries, usage and time to first output. */
+export declare function registerModelHooks(tessar: PluginContext, tracing: TraceRuntime): void;

package/dist/models.js

@@ -0,0 +1,103 @@
+import { model, text, reasoning, } from "@tessar/core";
+import { time, update } from "./trace.js";
+/** Records model requests, retries, usage and time to first output. */
+export function registerModelHooks(tessar, tracing) {
+    const { current, parentTurn, start, end, failure } = tracing;
+    const capturedInstructions = new WeakSet();
+    tessar.hook(model.start, (event) => {
+        const state = current(event);
+        if (!state || state.models.has(event.payload.attemptId))
+            return;
+        const { attemptId, request, purpose, parentToolExecutionId, turnId } = event.payload;
+        if (turnId && purpose !== "auxiliary")
+            state.currentTurn = turnId;
+        if (purpose !== "auxiliary" && request) {
+            // Keep the first effective primary instructions for root display without
+            // replacing the invocation input or letting later Turns overwrite it.
+            if (!capturedInstructions.has(state.root)) {
+                state.root.setAttribute("tessar.instructions", JSON.stringify(request.instructions));
+                capturedInstructions.add(state.root);
+            }
+            update(parentTurn(state, event, turnId), "span", {
+                input: request,
+                metadata: { inputSource: "normalized-context" },
+            });
+        }
+        const parent = parentToolExecutionId
+            ? state.tools.get(parentToolExecutionId)
+            : undefined;
+        const span = start(event.payload.model.modelId, "generation", event, {
+            ...state.identity,
+            attemptId,
+            purpose,
+            parentToolExecutionId,
+            turnId,
+            providerId: event.payload.model.providerId,
+            options: request?.options,
+        }, parent ??
+            (purpose === "auxiliary" && state.currentTurn !== turnId
+                ? state.root
+                : parentTurn(state, event, turnId)), {
+            model: event.payload.model.modelId,
+            input: request,
+            modelParameters: Object.fromEntries(Object.entries(request?.options ?? {}).filter(([, value]) => typeof value === "string" || typeof value === "number")),
+        }, event.payload.startedAt);
+        state.models.set(attemptId, span);
+    });
+    for (const name of [text.delta, reasoning.delta])
+        tessar.hook(name, (event) => {
+            if (!event.payload.delta)
+                return;
+            const state = current(event), span = state?.models.get(event.payload.attemptId);
+            if (!span || state.firstOutputs.has(event.payload.attemptId))
+                return;
+            state.firstOutputs.add(event.payload.attemptId);
+            update(span, "generation", {
+                completionStartTime: time(event) ?? new Date(),
+            });
+        });
+    const recordUsage = (span, usage) => update(span, "generation", {
+        usage,
+        metadata: { usage },
+    });
+    tessar.hook(model.usage, (event) => {
+        const span = current(event)?.models.get(event.payload.attemptId);
+        if (span)
+            recordUsage(span, event.payload.usage);
+    });
+    tessar.hook(model.end, (event) => {
+        const state = current(event), span = state?.models.get(event.payload.attemptId);
+        if (!span)
+            return;
+        const { response } = event.payload;
+        if (response.usage)
+            recordUsage(span, response.usage);
+        update(span, "generation", {
+            output: response.message,
+            metadata: {
+                finishReason: response.finishReason,
+                providerRequestId: response.providerRequestId,
+            },
+        });
+        if (event.payload.purpose !== "auxiliary")
+            for (const part of response.message.content)
+                if (part.type === "tool-call")
+                    state.calls.set(part.toolCallId, {
+                        name: part.name,
+                        arguments: part.arguments,
+                    });
+        end(span, event, event.payload.endedAt);
+        state.models.delete(event.payload.attemptId);
+        state.firstOutputs.delete(event.payload.attemptId);
+    });
+    tessar.hook(model.error, (event) => {
+        const state = current(event), span = state?.models.get(event.payload.attemptId);
+        if (!span)
+            return;
+        failure(span, "generation", event.payload.error);
+        end(span, event, event.payload.endedAt);
+        state.models.delete(event.payload.attemptId);
+        state.firstOutputs.delete(event.payload.attemptId);
+    });
+}
+//# sourceMappingURL=models.js.map

package/dist/models.js.map

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

package/dist/plugin.d.ts

@@ -0,0 +1,9 @@
+import type { Plugin, PluginContext } from "@tessar/core";
+import type { OpenTelemetryOptions } from "./types.js";
+/** One shared tracing lifecycle with independently mapped export destinations. */
+export declare class OpenTelemetryPlugin implements Plugin {
+    #private;
+    readonly id = "opentelemetry";
+    constructor(options: OpenTelemetryOptions);
+    setup(tessar: PluginContext): Promise<void>;
+}