@traceroot-ai/traceroot 0.1.6 → 0.1.8

package/dist/pi.js

@@ -0,0 +1,615 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TRACER_NAME = void 0;
+exports.resolveConfig = resolveConfig;
+exports.openRootSpan = openRootSpan;
+exports.stampRootOutput = stampRootOutput;
+exports.finalizeRootSpan = finalizeRootSpan;
+exports.openLlmSpan = openLlmSpan;
+exports.closeLlmSpan = closeLlmSpan;
+exports.describeToolCallSpan = describeToolCallSpan;
+exports.openToolSpan = openToolSpan;
+exports.closeToolSpan = closeToolSpan;
+exports.closeDanglingSpan = closeDanglingSpan;
+exports.wirePiCodingAgentInstrumentation = wirePiCodingAgentInstrumentation;
+exports.instrumentPiCodingAgent = instrumentPiCodingAgent;
+const node_path_1 = require("node:path");
+const api_1 = require("@opentelemetry/api");
+const constants_1 = require("./constants");
+const processor_1 = require("./processor");
+exports.TRACER_NAME = '@traceroot-ai/pi-coding-agent';
+function resolveConfig(config) {
+    const captureContent = config?.captureContent ?? true;
+    const captureToolIo = config?.captureToolIo ?? true;
+    return {
+        captureContent,
+        captureToolIo,
+    };
+}
+const OI_SPAN_KIND_VALUE = {
+    AGENT: 'AGENT',
+    LLM: 'LLM',
+    TOOL: 'TOOL',
+};
+// Attribute triad matching other traceroot-ts integrations: OpenInference span-kind, OTel gen_ai.*, traceroot.pi.* retry/force-close markers.
+const TR_ATTRIBUTES = {
+    RETRY_COUNT: 'traceroot.pi.retry_count',
+    FORCE_CLOSED: 'traceroot.pi.force_closed',
+    FORCE_CLOSED_REASON: 'traceroot.pi.force_closed_reason',
+};
+// Pi reports usage in the gen_ai.* family; LLM spans dual-write the OpenInference
+// llm.* keys (from constants.ts) alongside these — see openLlmSpan/closeLlmSpan.
+const GEN_AI_ATTRIBUTES = {
+    SYSTEM: 'gen_ai.system',
+    REQUEST_MODEL: 'gen_ai.request.model',
+    RESPONSE_MODEL: 'gen_ai.response.model',
+    USAGE_INPUT_TOKENS: 'gen_ai.usage.input_tokens',
+    USAGE_OUTPUT_TOKENS: 'gen_ai.usage.output_tokens',
+    CACHE_WRITE_INPUT_TOKENS: 'gen_ai.usage.cache_creation_input_tokens',
+    CACHE_READ_INPUT_TOKENS: 'gen_ai.usage.cache_read_input_tokens',
+    TOOL_NAME: 'gen_ai.tool.name',
+    TOOL_CALL_ID: 'gen_ai.tool.call.id',
+};
+function setAttr(span, key, value) {
+    if (value === undefined || value === null)
+        return;
+    span.setAttribute(key, value);
+}
+function endSpanSafe(span) {
+    if (!span)
+        return;
+    try {
+        span.end();
+    }
+    catch {
+        // Never let a misbehaving OTel exporter/processor crash the host app.
+    }
+}
+// Caps exported tool JSON so one call can't inflate a span's attribute payload without bound.
+const MAX_TOOL_IO_JSON_CHARS = 32 * 1024; // 32 KB of UTF-16 code units
+// Caps array/object breadth so a "wide" payload (tens of thousands of small entries,
+// e.g. a custom/MCP tool result) can't fully materialize in JSON.stringify before
+// capJsonWithMarker discards it — bounds transient serialization cost, not just the
+// final attribute size.
+const MAX_TOOL_IO_ENTRIES = 2048;
+// Appended whenever capJsonWithMarker cuts, so truncation is distinguishable from coincidence.
+const TRUNCATION_MARKER = '…[truncated]';
+function capJsonWithMarker(json) {
+    if (json.length <= MAX_TOOL_IO_JSON_CHARS)
+        return json;
+    return `${json.slice(0, MAX_TOOL_IO_JSON_CHARS)}${TRUNCATION_MARKER}`;
+}
+// Caps each oversized string field AND array/object breadth while walking the tree, so
+// neither one huge field nor tens of thousands of small ones fully materialize first.
+function capFieldReplacer(_key, value) {
+    if (typeof value === 'string' && value.length > MAX_TOOL_IO_JSON_CHARS) {
+        return value.slice(0, MAX_TOOL_IO_JSON_CHARS);
+    }
+    if (Array.isArray(value) && value.length > MAX_TOOL_IO_ENTRIES) {
+        return [...value.slice(0, MAX_TOOL_IO_ENTRIES), TRUNCATION_MARKER];
+    }
+    if (value !== null && typeof value === 'object' && !Array.isArray(value)) {
+        const keys = Object.keys(value);
+        if (keys.length > MAX_TOOL_IO_ENTRIES) {
+            const capped = {};
+            for (const key of keys.slice(0, MAX_TOOL_IO_ENTRIES)) {
+                capped[key] = value[key];
+            }
+            capped[TRUNCATION_MARKER] = TRUNCATION_MARKER;
+            return capped;
+        }
+    }
+    return value;
+}
+// JSON.stringify can return undefined for a top-level undefined value, despite its `string` type — short-circuit before capJsonWithMarker's .length.
+function stringifyToolIo(value) {
+    if (value === undefined)
+        return undefined;
+    return JSON.stringify(value, capFieldReplacer);
+}
+function assistantTextOf(message) {
+    if (!message)
+        return undefined;
+    if (message.role === 'user' && typeof message.content === 'string')
+        return message.content;
+    if (message.role !== 'assistant')
+        return undefined;
+    // Malformed/non-array content is treated as "no text", not thrown, to avoid skipping the caller's span close.
+    if (!Array.isArray(message.content))
+        return undefined;
+    const parts = message.content
+        .filter((c) => {
+        return typeof c === 'object' && c !== null && c.type === 'text';
+    })
+        .map((c) => c.text);
+    return parts.length > 0 ? parts.join('') : undefined;
+}
+function isToolCallPart(part) {
+    return (typeof part === 'object' && part !== null && part.type === 'toolCall');
+}
+// OpenAI-convention function-call `arguments` is a JSON *string*: keep a string
+// as-is, else serialize. A non-serializable value (circular/BigInt) collapses to
+// "" rather than throwing, so one bad arg can't drop the whole output.
+function toolCallArgumentsString(args) {
+    if (typeof args === 'string')
+        return args;
+    try {
+        return JSON.stringify(args) ?? '';
+    }
+    catch {
+        return '';
+    }
+}
+// Output value for an assistant turn. A text-only turn stays a plain string
+// (unchanged). A turn that ISSUED tool calls — which is exactly the turn that
+// owns the nested TOOL spans — serializes an OpenAI-style assistant message so
+// the tool calls the model produced aren't silently dropped from the LLM span
+// (assistantTextOf alone returns undefined for a tool-call-only turn). Mirrors
+// claude-agent-sdk.ts, which serializes the full assistant message content.
+function assistantOutputValue(message) {
+    const text = assistantTextOf(message);
+    if (!message || message.role !== 'assistant' || !Array.isArray(message.content)) {
+        return text;
+    }
+    const toolCalls = message.content.filter(isToolCallPart).map((part) => ({
+        id: part.id,
+        type: 'function',
+        function: { name: part.name, arguments: toolCallArgumentsString(part.arguments) },
+    }));
+    if (toolCalls.length === 0)
+        return text;
+    try {
+        return capJsonWithMarker(JSON.stringify({ role: 'assistant', content: text ?? null, tool_calls: toolCalls }));
+    }
+    catch {
+        // arguments are already strings, so this should not throw; never lose the close.
+        return text;
+    }
+}
+function openRootSpan(tracer, parentCtx, input) {
+    const span = tracer.startSpan('AgentSession.prompt', { kind: api_1.SpanKind.INTERNAL }, parentCtx);
+    setAttr(span, constants_1.OI_SPAN_KIND, OI_SPAN_KIND_VALUE.AGENT);
+    setAttr(span, constants_1.OI_TRACE_SESSION_ID, input.sessionId);
+    if (input.captureContent)
+        setAttr(span, constants_1.OI_INPUT_VALUE, input.text);
+    return span;
+}
+// Stamps output onto the root span without ending it; continuations share one root, so the last agent_end wins.
+function stampRootOutput(span, finalMessages, captureContent) {
+    if (!captureContent)
+        return;
+    let lastAssistant;
+    for (let i = finalMessages.length - 1; i >= 0; i -= 1) {
+        if (finalMessages[i].role === 'assistant') {
+            lastAssistant = finalMessages[i];
+            break;
+        }
+    }
+    setAttr(span, constants_1.OI_OUTPUT_VALUE, assistantOutputValue(lastAssistant));
+}
+// Ends the root span exactly once, when the wrapping prompt() call's own returned promise settles.
+function finalizeRootSpan(span, retryCount, status, error) {
+    // Called from a detached .then() chain nobody awaits, so guard against unhandledRejection here too.
+    try {
+        setAttr(span, TR_ATTRIBUTES.RETRY_COUNT, retryCount);
+        span.setStatus(status);
+        if (error !== undefined) {
+            span.recordException(error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    catch {
+        // best-effort, same as endSpanSafe
+    }
+    endSpanSafe(span);
+}
+function openLlmSpan(tracer, parentCtx, message) {
+    const span = tracer.startSpan(message.model || 'pi.llm', { kind: api_1.SpanKind.CLIENT }, parentCtx);
+    setAttr(span, constants_1.OI_SPAN_KIND, OI_SPAN_KIND_VALUE.LLM);
+    setAttr(span, GEN_AI_ATTRIBUTES.SYSTEM, message.provider);
+    setAttr(span, GEN_AI_ATTRIBUTES.REQUEST_MODEL, message.model);
+    // Dual-write the OpenInference llm.* family alongside gen_ai.* for downstream
+    // consumers. model_name starts at the request model; closeLlmSpan resolves it.
+    setAttr(span, constants_1.OI_LLM_MODEL_NAME, message.model);
+    return span;
+}
+function closeLlmSpan(span, message, captureContent) {
+    span.updateName(message.responseModel || message.model || 'pi.llm');
+    setAttr(span, GEN_AI_ATTRIBUTES.RESPONSE_MODEL, message.responseModel || message.model);
+    setAttr(span, GEN_AI_ATTRIBUTES.USAGE_INPUT_TOKENS, message.usage?.input);
+    setAttr(span, GEN_AI_ATTRIBUTES.USAGE_OUTPUT_TOKENS, message.usage?.output);
+    setAttr(span, GEN_AI_ATTRIBUTES.CACHE_READ_INPUT_TOKENS, message.usage?.cacheRead);
+    setAttr(span, GEN_AI_ATTRIBUTES.CACHE_WRITE_INPUT_TOKENS, message.usage?.cacheWrite);
+    // OpenInference llm.* dual-write of the same numbers (see openLlmSpan). Pi
+    // reports totalTokens directly, so llm.token_count.total uses it as-is rather
+    // than recomputing prompt+completion.
+    setAttr(span, constants_1.OI_LLM_MODEL_NAME, message.responseModel || message.model);
+    setAttr(span, constants_1.OI_LLM_TOKEN_COUNT_PROMPT, message.usage?.input);
+    setAttr(span, constants_1.OI_LLM_TOKEN_COUNT_COMPLETION, message.usage?.output);
+    setAttr(span, constants_1.OI_LLM_TOKEN_COUNT_TOTAL, message.usage?.totalTokens);
+    setAttr(span, constants_1.OI_LLM_TOKEN_COUNT_CACHE_READ, message.usage?.cacheRead);
+    setAttr(span, constants_1.OI_LLM_TOKEN_COUNT_CACHE_WRITE, message.usage?.cacheWrite);
+    if (captureContent) {
+        setAttr(span, constants_1.OI_OUTPUT_VALUE, assistantOutputValue(message));
+    }
+    if (message.stopReason === 'error' || message.stopReason === 'aborted') {
+        span.setStatus({
+            code: api_1.SpanStatusCode.ERROR,
+            message: message.errorMessage || message.stopReason,
+        });
+    }
+    endSpanSafe(span);
+}
+// Privacy-safe tool span naming: never a full file path, commands/basenames capped to MAX_NAME_SEGMENT_CHARS.
+const basename = node_path_1.win32.basename;
+const MAX_NAME_SEGMENT_CHARS = 60;
+const TOOL_PATH_ARGUMENT_KEYS = [
+    'path',
+    'file',
+    'filePath',
+    'file_path',
+    'filename',
+    'target',
+];
+function firstPathArgument(args) {
+    for (const key of TOOL_PATH_ARGUMENT_KEYS) {
+        const value = args[key];
+        if (typeof value === 'string' && value)
+            return value;
+    }
+    return undefined;
+}
+function truncateWithEllipsis(text, maxLen) {
+    if (text.length <= maxLen)
+        return text;
+    return `${text.slice(0, maxLen)}…`;
+}
+function describeToolCallSpan(toolName, args) {
+    if (args && typeof args === 'object') {
+        const a = args;
+        // Checked first, exclusively by command, so an incidental path/target argument (e.g. cwd) can't shadow it.
+        if (toolName === 'bash' && typeof a.command === 'string' && a.command) {
+            const cmd = a.command.replace(/\s+/g, ' ').trim();
+            if (cmd)
+                return `bash: ${truncateWithEllipsis(cmd, MAX_NAME_SEGMENT_CHARS)}`;
+        }
+        const pathLike = firstPathArgument(a);
+        if (pathLike) {
+            const base = basename(pathLike);
+            // Can still basename() to '' (e.g. "/") — fall through instead of "toolName: ".
+            if (base) {
+                return `${toolName}: ${truncateWithEllipsis(base, MAX_NAME_SEGMENT_CHARS)}`;
+            }
+        }
+    }
+    return toolName;
+}
+function openToolSpan(tracer, parentCtx, toolCallId, toolName, args, captureToolIo) {
+    const span = tracer.startSpan(
+    // captureToolIo gates arg-derived content in the NAME too, not just input/output:
+    // a bash command or file path is tool IO and must not leak into the span name when
+    // the caller opted out (e.g. `bash: curl -H "Authorization: Bearer ..."`).
+    captureToolIo ? describeToolCallSpan(toolName, args) : toolName, { kind: api_1.SpanKind.INTERNAL }, parentCtx);
+    setAttr(span, constants_1.OI_SPAN_KIND, OI_SPAN_KIND_VALUE.TOOL);
+    // Dual-write OpenInference tool.name alongside gen_ai.tool.name (matches
+    // claude-agent-sdk.ts) so dashboards keyed on the OI attribute surface pi tool spans.
+    setAttr(span, constants_1.TOOL_NAME, toolName);
+    setAttr(span, GEN_AI_ATTRIBUTES.TOOL_NAME, toolName);
+    setAttr(span, GEN_AI_ATTRIBUTES.TOOL_CALL_ID, toolCallId);
+    if (captureToolIo) {
+        try {
+            const serializedArgs = stringifyToolIo(args);
+            if (serializedArgs !== undefined) {
+                setAttr(span, constants_1.OI_INPUT_VALUE, capJsonWithMarker(serializedArgs));
+            }
+        }
+        catch {
+            // args may contain circular refs or BigInt — skip rather than crash.
+        }
+    }
+    return span;
+}
+function closeToolSpan(span, result, isError, captureToolIo) {
+    if (captureToolIo) {
+        try {
+            const serializedResult = stringifyToolIo(result);
+            if (serializedResult !== undefined) {
+                setAttr(span, constants_1.OI_OUTPUT_VALUE, capJsonWithMarker(serializedResult));
+            }
+        }
+        catch {
+            // result may contain circular refs or BigInt — skip rather than crash.
+        }
+    }
+    if (isError) {
+        span.setStatus({ code: api_1.SpanStatusCode.ERROR });
+    }
+    endSpanSafe(span);
+}
+// Used when a span is force-closed by a later event; only the setAttr call is guarded so a throw there can't skip endSpanSafe.
+function closeDanglingSpan(span) {
+    if (!span)
+        return;
+    try {
+        setAttr(span, TR_ATTRIBUTES.FORCE_CLOSED, true);
+    }
+    catch (err) {
+        // diag.warn, not console: proper OTel logging infrastructure, silent unless the host registers a DiagLogger, and it must never throw mid-flight.
+        api_1.diag.warn('[traceroot-pi] failed to mark a dangling span force_closed (still ending it):', err);
+    }
+    endSpanSafe(span);
+}
+// Symbol.for(), not a bare Symbol(): two independently-loaded copies of this package must see the same registry key to detect a second instrumentPiCodingAgent() call — do not change this without adding multiplexing support.
+const WRAPPED = Symbol.for('traceroot.pi.wrapped');
+// Force-closes spans left open by an abandoned run, root only when requested.
+function sweepDanglingSpans(state, options = {}) {
+    for (const [, span] of state.toolSpans) {
+        closeDanglingSpan(span);
+    }
+    state.toolSpans.clear();
+    closeDanglingSpan(state.llmSpan);
+    state.llmSpan = undefined;
+    state.llmCtx = undefined;
+    if (options.includeRoot) {
+        closeDanglingSpan(state.rootSpan);
+        state.rootSpan = undefined;
+        state.rootCtx = undefined;
+    }
+}
+// Guarantees subscribe() ran once — proto.prompt/steer/followUp can each independently be a session's first call.
+function ensureSubscribed(session, tracer, config, subscribedSessions, sessionSpanState) {
+    if (subscribedSessions.has(session))
+        return;
+    subscribedSessions.add(session);
+    attachSpanListener(session, tracer, config, sessionSpanState);
+}
+/**
+ * An `instrumentModules.piCodingAgent` value is the `{ module, config }` wrapper
+ * form (vs a raw pi module ref) when it carries a `module` property and is NOT
+ * itself a pi module namespace. The negative `AgentSession` check guards against a
+ * future pi module that also exports a `module` symbol: the real pi namespace
+ * exposes `AgentSession`, the wrapper does not, so the two stay distinguishable.
+ */
+function isPiCodingAgentWrapper(entry) {
+    return (typeof entry === 'object' &&
+        entry !== null &&
+        'module' in entry &&
+        entry.module != null &&
+        !('AgentSession' in entry));
+}
+/**
+ * Dispatcher entry point for pi, called once by wireInstrumentations() in
+ * instrumentation.ts. Kept here rather than inline in that shared file so the
+ * dispatcher stays symmetric with claude/openai (one import + one call). Unwraps
+ * the optional { module, config } form; pi carries its own captureContent/
+ * captureToolIo config, passed through unmerged (there is no apiKey/baseUrl to
+ * thread). A throw from instrumentPiCodingAgent() surfaces, same as claude's.
+ */
+function wirePiCodingAgentInstrumentation(entry) {
+    let mod = entry;
+    let explicitConfig;
+    if (isPiCodingAgentWrapper(entry)) {
+        mod = entry.module;
+        explicitConfig = entry.config;
+    }
+    instrumentPiCodingAgent(mod, explicitConfig);
+}
+function instrumentPiCodingAgent(sdk, config) {
+    const mod = sdk;
+    const resolved = resolveConfig(config);
+    // Stamped on AgentSession.prototype, never on `mod`: an ESM namespace object is permanently non-extensible, so defineProperty(mod, ...) would throw.
+    const proto = mod?.AgentSession?.prototype;
+    if (typeof proto?.prompt !== 'function' || typeof proto?.subscribe !== 'function') {
+        // Fail loudly: a pi SDK rename must not silently emit zero traces.
+        throw new Error('[traceroot-pi] AgentSession.prototype.prompt/subscribe not found — cannot install instrumentation.');
+    }
+    // Idempotent no-op on a second install for the same sdk; the first call's config stands.
+    if (proto[WRAPPED]) {
+        return sdk;
+    }
+    // resolve at use, never capture: TraceRoot.shutdown() calls trace.disable(),
+    // which swaps the OTel proxy provider for a fresh instance. A tracer captured
+    // once here would stay bound to the old, now-detached provider, so after a
+    // shutdown()/initialize() cycle every span it opens goes silently dark.
+    // Re-resolve the globally-registered provider on each span-open.
+    const tracer = {
+        startSpan: (name, options, ctx) => api_1.trace.getTracer(exports.TRACER_NAME, processor_1.SDK_VERSION).startSpan(name, options, ctx),
+    };
+    const subscribedSessions = new WeakSet();
+    // Out-of-band, since dispose() (below) has no closure over a session.
+    const sessionSpanState = new WeakMap();
+    const rollback = [];
+    try {
+        const originalPrompt = proto.prompt;
+        proto.prompt = function (text, options) {
+            ensureSubscribed(this, tracer, resolved, subscribedSessions, sessionSpanState);
+            // Queue-only steer: if already streaming with streamingBehavior set, delegate straight through before any root management, or we'd force-close the active run's still-open root.
+            const isQueueOnlySteer = this.isStreaming === true && !!options?.streamingBehavior;
+            if (isQueueOnlySteer) {
+                return originalPrompt.call(this, text, options);
+            }
+            // Non-undefined: ensureSubscribed() above created or found this entry.
+            const state = sessionSpanState.get(this);
+            // OVERLAP SAFETY: a new call raced a still-open prior root — force-close it rather than silently leaking it.
+            // This can also fire on an accidental double-submit (isStreaming flips only after several awaits inside
+            // prompt()), so stamp a distinct reason on the superseded root: its trace is truncated by design, and this
+            // keeps that debuggable from the exported data.
+            if (state.rootSpan) {
+                setAttr(state.rootSpan, TR_ATTRIBUTES.FORCE_CLOSED_REASON, 'superseded_by_new_prompt');
+                sweepDanglingSpans(state, { includeRoot: true });
+            }
+            // context.active() lets a host span nest this trace under it.
+            const parentCtx = api_1.context.active();
+            const rootSpan = openRootSpan(tracer, parentCtx, {
+                text: typeof text === 'string' ? text : undefined,
+                sessionId: this.sessionId,
+                captureContent: resolved.captureContent,
+            });
+            state.rootSpan = rootSpan;
+            state.rootCtx = api_1.trace.setSpan(parentCtx, rootSpan);
+            state.retryCount = 0;
+            // Guarded by identity so a mid-run dispose() or a later sweep, which may have already force-closed it, never double-ends. Derives the status message from the error, if any.
+            const finalize = (code, error) => {
+                if (state.rootSpan !== rootSpan)
+                    return;
+                state.rootSpan = undefined;
+                state.rootCtx = undefined;
+                // A rejection can leave the in-flight attempt's spans unclosed.
+                sweepDanglingSpans(state);
+                const message = error === undefined ? undefined : error instanceof Error ? error.message : String(error);
+                finalizeRootSpan(rootSpan, state.retryCount, { code, message }, error);
+            };
+            // A synchronous throw here never reached agent_start: finalize ERROR and rethrow.
+            let result;
+            try {
+                result = originalPrompt.call(this, text, options);
+            }
+            catch (err) {
+                finalize(api_1.SpanStatusCode.ERROR, err);
+                throw err;
+            }
+            // Separate .then() chain, not a return of result.then(...): that would swallow the rejection since onReject here doesn't rethrow.
+            result.then(() => finalize(api_1.SpanStatusCode.OK), (err) => finalize(api_1.SpanStatusCode.ERROR, err));
+            return result;
+        };
+        rollback.push(() => {
+            proto.prompt = originalPrompt;
+        });
+        // Standalone entry points, not prompt() wrappers — needed so a session's first call being one of these still triggers subscribe(). Both just subscribe then delegate, so they share one wrapper.
+        const patchSubscribeTrigger = (name) => {
+            const original = proto[name];
+            if (typeof original !== 'function')
+                return;
+            proto[name] = function (text, images) {
+                ensureSubscribed(this, tracer, resolved, subscribedSessions, sessionSpanState);
+                return original.call(this, text, images);
+            };
+            rollback.push(() => {
+                proto[name] = original;
+            });
+        };
+        patchSubscribeTrigger('steer');
+        patchSubscribeTrigger('followUp');
+        if (typeof proto.dispose === 'function') {
+            const originalDispose = proto.dispose;
+            proto.dispose = function () {
+                // The real dispose() only clears _eventListeners, so force-close any still-open spans first.
+                const state = sessionSpanState.get(this);
+                if (state) {
+                    try {
+                        sweepDanglingSpans(state, { includeRoot: true });
+                    }
+                    catch (err) {
+                        // Must never make dispose() throw — the host still needs teardown. diag.warn, not console (see closeDanglingSpan).
+                        api_1.diag.warn('[traceroot-pi] failed to force-close in-flight spans during dispose() (a span may leak):', err);
+                    }
+                    finally {
+                        // sweepDanglingSpans({ includeRoot: true }) above already nulled every span/ctx field; the state is dropped here regardless.
+                        sessionSpanState.delete(this);
+                        // Else a reused session would never re-subscribe (still "has" it).
+                        subscribedSessions.delete(this);
+                    }
+                }
+                return originalDispose.call(this);
+            };
+            rollback.push(() => {
+                proto.dispose = originalDispose;
+            });
+        }
+        // Only mark wrapped after every patch succeeded, else a re-entrant call could double-emit spans.
+        Object.defineProperty(proto, WRAPPED, { value: true, enumerable: false });
+    }
+    catch (err) {
+        for (let i = rollback.length - 1; i >= 0; i--) {
+            rollback[i]();
+        }
+        throw new Error('[traceroot-pi] failed to install instrumentation on AgentSession.prototype', {
+            cause: err,
+        });
+    }
+    return sdk;
+}
+function attachSpanListener(session, tracer, config, sessionSpanState) {
+    const state = {
+        rootSpan: undefined,
+        rootCtx: undefined,
+        llmSpan: undefined,
+        llmCtx: undefined,
+        toolSpans: new Map(),
+        retryCount: 0,
+    };
+    sessionSpanState.set(session, state);
+    session.subscribe((event) => {
+        try {
+            handleEvent(event, tracer, config, state);
+        }
+        catch (err) {
+            // Must never reach Pi's event dispatcher and destabilize its agent loop. diag.warn, not console (see closeDanglingSpan).
+            api_1.diag.warn('[traceroot-pi] instrumentation handler failed (a span may be missing or incomplete):', err);
+        }
+    });
+}
+function handleEvent(event, tracer, config, state) {
+    switch (event.type) {
+        case 'agent_start': {
+            // Sweep dangling spans from a crashed prior attempt; root is untouched (owned by prompt()).
+            sweepDanglingSpans(state);
+            // An undefined state.rootSpan means this run bypassed the wrapped prompt() call — do not synthesize one.
+            break;
+        }
+        case 'message_start': {
+            if (event.message.role !== 'assistant')
+                return;
+            // A second message_start with no intervening message_end means the previous LLM span was abandoned — force-close it first.
+            closeDanglingSpan(state.llmSpan);
+            // Falls back to ROOT_CONTEXT, never context.active(): the latter is the host's ambient OTel context, unrelated to this session, and would risk cross-trace contamination.
+            const parentCtx = state.rootCtx ?? api_1.ROOT_CONTEXT;
+            state.llmSpan = openLlmSpan(tracer, parentCtx, event.message);
+            state.llmCtx = api_1.trace.setSpan(parentCtx, state.llmSpan);
+            break;
+        }
+        case 'message_end': {
+            if (event.message.role !== 'assistant')
+                return;
+            if (state.llmSpan)
+                closeLlmSpan(state.llmSpan, event.message, config.captureContent);
+            state.llmSpan = undefined;
+            // llmCtx stays alive on purpose: this turn's tool_execution events fire after message_end but before turn_end, and still parent under the ended LLM span.
+            break;
+        }
+        case 'turn_end': {
+            // If a stream error cut the turn short before message_end closed llmSpan, sweep force-closes it (and tool spans); root is untouched.
+            sweepDanglingSpans(state);
+            break;
+        }
+        case 'tool_execution_start': {
+            // An already-open toolCallId would have its Map slot silently overwritten — force-close first.
+            const existing = state.toolSpans.get(event.toolCallId);
+            closeDanglingSpan(existing);
+            const parentCtx = state.llmCtx ?? state.rootCtx ?? api_1.ROOT_CONTEXT;
+            const span = openToolSpan(tracer, parentCtx, event.toolCallId, event.toolName, event.args, config.captureToolIo);
+            state.toolSpans.set(event.toolCallId, span);
+            break;
+        }
+        case 'tool_execution_end': {
+            const span = state.toolSpans.get(event.toolCallId);
+            if (span)
+                closeToolSpan(span, event.result, event.isError, config.captureToolIo);
+            state.toolSpans.delete(event.toolCallId);
+            break;
+        }
+        case 'agent_end': {
+            // Mirrors turn_end's sweep; root is not swept (closing it is proto.prompt's job) — this only stamps output onto whatever is open.
+            sweepDanglingSpans(state);
+            if (state.rootSpan) {
+                stampRootOutput(state.rootSpan, event.messages, config.captureContent);
+            }
+            if (event.willRetry) {
+                state.retryCount += 1;
+            }
+            break;
+        }
+        default:
+            break;
+    }
+}
+//# sourceMappingURL=pi.js.map

package/dist/pi.js.map

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

package/dist/spans.d.ts

@@ -0,0 +1,18 @@
+import { Span as OtelSpan } from '@opentelemetry/api';
+import { StartSpanOptions, SpanUpdate } from './types';
+export interface Span {
+    readonly spanId: string;
+    readonly traceId: string;
+    update(attrs: SpanUpdate): this;
+    end(): void;
+    startSpan(options: Omit<StartSpanOptions, 'parent'>): Span;
+    setError(err: unknown): this;
+}
+/** Wrap an existing OTel span (e.g. the active one) as a Span handle. */
+export declare function wrapSpan(otel: OtelSpan): Span;
+export declare function startSpan(options: StartSpanOptions): Span;
+/** Run fn with `span` as the active span so inner observe()/startSpan() nest under it. */
+export declare function usingSpan<T>(span: Span, fn: () => T): T;
+/** @internal test reset */
+export declare function _resetSpansState(): void;
+//# sourceMappingURL=spans.d.ts.map